开源软件构建与测试

Changes of Revision 8

_service:tar_scm:groff.spec Changed

@@ -1,8 +1,8 @@
 %global __requires_exclude %{?__requires_exclude:%__requires_exclude|}^perl\$^.*\\.pl\$
 %{!?with_x:%global with_x 1}
 Name: groff
-Version: 1.22.4
-Release: 12
+Version: 1.23.0
+Release: 1
 Summary: A typesetting system
 License: GPLv3+ and GFDL and BSD and MIT
 URL: http://www.gnu.org/software/groff/
@@ -11,7 +11,7 @@
 BuildRequires: gcc, gcc-c++ texinfo
 BuildRequires: git, netpbm-progs, perl-generators, psutils, ghostscript
 BuildRequires: libXaw-devel, libXmu-devel
-BuildRequires: jbig2dec-libs 
+BuildRequires: jbig2dec-libs m4
 Requires:      coreutils
 Requires:     %{name}-base = %{version}-%{release}
 
@@ -55,7 +55,7 @@
 BuildRequires: libXaw-devel, libXmu-devel
 Provides: groff-gxditview = %{version}-%{release}
 Obsoletes: groff-gxditview < 1.20.1
-Conflicts: groff < 1.22.4-8
+Conflicts: groff < 1.23.0-1
 
 %description x11
 The groff-x11 package contains the parts of the groff text processor
@@ -107,7 +107,7 @@
 rm -f %{buildroot}%{_infodir}/dir
 
 # fix privileges
-chmod 755 %{buildroot}%{_datadir}/groff/%{version}/groffer/version.sh
+#chmod 755 %{buildroot}%{_datadir}/groff/%{version}/groffer/version.sh
 chmod 755 %{buildroot}%{_datadir}/groff/%{version}/font/devlj4/generate/special.awk
 
 # remove CreationDate
@@ -133,6 +133,7 @@
 %files
 %defattr(-,root,root)
 %{_datadir}/%{name}/%{version}/font/devX*/
+%{_datadir}/%{name}/%{version}/font/FontMap-X11
 %{_datadir}/%{name}/%{version}/tmac/X.tmac
 %{_datadir}/%{name}/%{version}/tmac/Xps.tmac
 %{_datadir}/%{name}/%{version}/font/devcp1047/
@@ -140,14 +141,13 @@
 %{_datadir}/%{name}/%{version}/font/devlbp/
 %{_datadir}/%{name}/%{version}/font/devlj4/
 %{_datadir}/%{name}/%{version}/font/devpdf/
-%{_datadir}/%{name}/%{version}/groffer/
 %{_datadir}/%{name}/%{version}/oldfont/
 %{_datadir}/%{name}/%{version}/pic/
 %{_datadir}/%{name}/%{version}/tmac/62bit.tmac
-%{_datadir}/%{name}/%{version}/tmac/a4.tmac
 %{_datadir}/%{name}/%{version}/tmac/dvi.tmac
 %{_datadir}/%{name}/%{version}/tmac/e.tmac
 %{_datadir}/%{name}/%{version}/tmac/ec.tmac
+%{_datadir}/%{name}/%{version}/tmac/en.tmac
 %{_datadir}/%{name}/%{version}/tmac/hdmisc.tmac
 %{_datadir}/%{name}/%{version}/tmac/hdtbl.tmac
 %{_datadir}/%{name}/%{version}/tmac/lbp.tmac
@@ -196,17 +196,10 @@
 %{_bindir}/gperl
 %{_bindir}/gpinyin
 %{_bindir}/glilypond
-%{_bindir}/groffer
 %{_bindir}/grog
 %{_bindir}/gropdf
 %{_bindir}/mmroff
 %{_bindir}/pdfmom
-%{_bindir}/roff2dvi
-%{_bindir}/roff2html
-%{_bindir}/roff2pdf
-%{_bindir}/roff2ps
-%{_bindir}/roff2text
-%{_bindir}/roff2x
 
 %files base
 %license COPYING FDL LICENSES
@@ -222,7 +215,6 @@
 %{_datadir}/%{name}/%{version}/font/devutf8/
 %{_datadir}/%{name}/%{version}/font/devhtml/
 %{_datadir}/%{name}/%{version}/tmac/an-ext.tmac
-%{_datadir}/%{name}/%{version}/tmac/an-old.tmac
 %{_datadir}/%{name}/%{version}/tmac/an.tmac
 %{_datadir}/%{name}/%{version}/tmac/andoc.tmac
 %{_datadir}/%{name}/%{version}/tmac/composite.tmac
@@ -242,11 +234,13 @@
 %{_datadir}/%{name}/%{version}/tmac/hyphen.cs
 %{_datadir}/%{name}/%{version}/tmac/hyphen.den
 %{_datadir}/%{name}/%{version}/tmac/hyphen.det
+%{_datadir}/%{name}/%{version}/tmac/hyphen.en
 %{_datadir}/%{name}/%{version}/tmac/hyphen.fr
+%{_datadir}/%{name}/%{version}/tmac/hyphen.it
 %{_datadir}/%{name}/%{version}/tmac/hyphen.sv
-%{_datadir}/%{name}/%{version}/tmac/hyphen.us
 %{_datadir}/%{name}/%{version}/tmac/hyphenex.cs
-%{_datadir}/%{name}/%{version}/tmac/hyphenex.us
+%{_datadir}/%{name}/%{version}/tmac/hyphenex.en
+%{_datadir}/%{name}/%{version}/tmac/it.tmac
 %{_datadir}/%{name}/%{version}/tmac/ja.tmac
 %{_datadir}/%{name}/%{version}/tmac/latin1.tmac
 %{_datadir}/%{name}/%{version}/tmac/latin2.tmac
@@ -263,14 +257,16 @@
 %{_datadir}/%{name}/%{version}/tmac/psatk.tmac
 %{_datadir}/%{name}/%{version}/tmac/psold.tmac
 %{_datadir}/%{name}/%{version}/tmac/pspic.tmac
-%{_datadir}/%{name}/%{version}/tmac/safer.tmac
+%{_datadir}/%{name}/%{version}/tmac/ptx.tmac
+%{_datadir}/%{name}/%{version}/tmac/rfc1345.tmac
+%{_datadir}/%{name}/%{version}/tmac/sanitize.tmac
+%{_datadir}/%{name}/%{version}/tmac/sboxes.tmac
 %{_datadir}/%{name}/%{version}/tmac/sv.tmac
 %{_datadir}/%{name}/%{version}/tmac/trans.tmac
 %{_datadir}/%{name}/%{version}/tmac/troffrc
 %{_datadir}/%{name}/%{version}/tmac/troffrc-end
 %{_datadir}/%{name}/%{version}/tmac/tty-char.tmac
 %{_datadir}/%{name}/%{version}/tmac/tty.tmac
-%{_datadir}/%{name}/%{version}/tmac/unicode.tmac
 %{_datadir}/%{name}/%{version}/tmac/www.tmac
 %{_datadir}/%{name}/site-tmac/*
 %{_bindir}/eqn
@@ -302,8 +298,8 @@
 %{_datadir}/%{name}/%{version}/font/devX*/
 %{_datadir}/%{name}/%{version}/tmac/X.tmac
 %{_datadir}/%{name}/%{version}/tmac/Xps.tmac
-%{_datadir}/X11/app-defaults/GXditview
-%{_datadir}/X11/app-defaults/GXditview-color
+%{_prefix}/lib/X11/app-defaults/GXditview
+%{_prefix}/lib/X11/app-defaults/GXditview-color
 # programs
 %{_bindir}/gxditview
 %{_bindir}/xtotroff
@@ -320,6 +316,9 @@
 %{_infodir}/groff.info*
 
 %changelog
+* Tue Jul 18 2023 dillon chen <dillonchen@gmail.com> - 1.23.0-1
+- update to 1.23.0
+
 * Mon Mar 13 2023 zhoupengcheng <zhoupengcheng11@huawei.com> - 1.22.4-12
 - enable make check

_service:tar_scm:groff-1.22.4.tar.gz/arch/mingw/groffer.cmd Deleted

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/prefix-gnulib-mk Deleted

@@ -1,229 +0,0 @@
-eval '(exit $?0)' && eval 'exec perl -wS "$0" "$@"'
-  & eval 'exec perl -wS "$0" $argv:q'
-    if 0;
-
-use strict;
-use IO::File;
-use Getopt::Long;
-use File::Basename; # for dirname
-
-my $VERSION = '2012-01-21 17:13'; # UTC
-(my $ME = $0) =~ s|.*/||;
-
-my $prefix;
-my $lib_name;
-
-sub usage ($)
-{
-  my ($exit_code) = @_;
-  my $STREAM = ($exit_code == 0 ? *STDOUT : *STDERR);
-  if ($exit_code != 0)
-    {
-      print $STREAM "Try '$ME --help' for more information.\n";
-    }
-  else
-    {
-      print $STREAM <<EOF;
-Usage: $ME --lib-name=NAME FILE
-   or: $ME --help|--version
-Rewrite a gnulib-tool-generated FILE like lib/gnulib.mk to work with
-automake's subdir-objects.
-
-OPTIONS:
-
-This option must be specified:
-
-   --lib-name=NAME    library name, often "lib\$project"
-
-The following are optional:
-
-   --help             display this help and exit
-   --version          output version information and exit
-
-EOF
-    }
-  exit $exit_code;
-}
-
-# contents ($FILE_NAME)
-# ---------------------
-sub contents ($)
-{
-  my ($file) = @_;
-  local $/;                     # Turn on slurp-mode.
-  my $f = new IO::File "< $file" or die "$file";
-  my $contents = $f->getline or die "$file";
-  $f->close;
-  return $contents;
-}
-
-# prefix_word ($WORD)
-# -------------------
-# Do not prefix special words such as variable dereferences.  Also,
-# "Makefile" is really "Makefile", since precisely there is no
-# lib/Makefile.
-sub prefix_word ($)
-{
-  local ($_) = @_;
-  $_ = $prefix . $_
-    unless (/^-/ || m{^\$$\w+$} || $_ eq "Makefile" || $_ eq '\\'
-            || $_ eq '@ALLOCA@');
-  return $_;
-}
-
-
-# prefix_words ($TEXT)
-# --------------------
-sub prefix_words ($)
-{
-  local ($_) = @_;
-  s{(\S+)}{prefix_word($1)}gem;
-  return $_;
-}
-
-
-# prefix_assignment ($LHS-AND-ASSIGN-OP, $RHS)
-# --------------------------------------------
-sub prefix_assignment ($$)
-{
-  my ($lhs_and_assign_op, $rhs) = @_;
-  my $res;
-
-  # Some variables are initialized by gnulib.mk, and we don't want
-  # that.  Change '=' to '+='.
-  if ($lhs_and_assign_op =~ /^(GPERF|V_GPERF.*) =$/)
-    {
-      # Do not change the RHS, which specifies the GPERF program.
-    }
-  elsif ($lhs_and_assign_op =~
-      /^(SUBDIRS|EXTRA_DIST|BUILT_SOURCES|SUFFIXES|MOSTLYCLEANFILES
-         |CLEANFILES|DISTCLEANFILES|MAINTAINERCLEANFILES|AM_CFLAGS
-         |AM_CPPFLAGS|AM_GNU_GETTEXT)\ =/x)
-    {
-      $lhs_and_assign_op =~ s/=/+=/;
-    }
-  # We don't want to inherit gnulib's AUTOMAKE_OPTIONS, comment them.
-  elsif ($lhs_and_assign_op =~ /^AUTOMAKE_OPTIONS =/)
-    {
-      $lhs_and_assign_op =~ s/^/# /;
-    }
-  elsif ($lhs_and_assign_op =~ /^SUFFIXES /)
-    {
-      # Elide any SUFFIXES assignment or concatenation.
-      $lhs_and_assign_op =~ s/^/# /;
-    }
-  # The words are (probably) paths to files in lib/: prefix them.
-  else
-    {
-      $rhs = prefix_words($rhs)
-    }
-
-  # Variables which name depend on the location: libbison_a_SOURCES =>
-  # lib_libbison_a_SOURCES.
-  $lhs_and_assign_op =~ s/($lib_name)/lib_$1/g;
-
-  return $lhs_and_assign_op . $rhs;
-}
-
-# prefix $CONTENTS
-# ----------------
-# $CONTENTS is a Makefile content.  Post-process it so that each file-name
-# is prefixed with $prefix (e.g., "lib/").
-#
-# Relies heavily on the regularity of the file generated by gnulib-tool.
-sub prefix ($)
-{
-  # Work on $_.
-  local ($_) = @_;
-
-  # Prefix all the occurrence of files in rules.  If there is nothing
-  # after in the :, it's probably a phony target, or a suffix rule.
-  # Don't touch it.
-  s{^(-\w+/+\.-\w.+ *: *\S.*)$}
-   {prefix_words($1)}gem;
-
-  # Prefix files in variables.
-  s{^(\w.+\s*\+?=)(.*)$}
-   {prefix_assignment($1, $2)}gem;
-
-  # $(srcdir)/ is actually $(top_srcdir)/$prefix/.
-  # The trailing slash is required to avoid matching this rule:
-  #   test '$(srcdir)' = . || rm -f $(top_builddir)/GNUmakefile
-  s{\$$srcdir$/}{\$(top_srcdir)/$prefix}g;
-
-  # Sometimes, t-$@ is used instead of $@-t, which, of course, does
-  # not work when we have a $@ with a directory in it.
-  s{t-\$\@}{\$\@-t}g;
-
-  # Some AC_SUBST patterns remain and would better be Make macros.
-  s{\@(MKDIR_P)\@}{\$($1)}g;
-
-  # Adjust paths in mkdir.
-  s{(\$$MKDIR_P$)\s*(\w+)}{$1 $prefix$2}g;
-
-  return $_;
-}
-
-# process ($IN)
-# -------------
-sub process ($)
-{
-  my ($file) = @_;
-  my ($bak) = "$file.bak";
-  rename ($file, $bak) or die "$ME: rename $file $bak failed: $!\n";
-  my $contents = contents ($bak);
-  $contents = prefix ($contents);
-  my $out = new IO::File(">$file")
-    or die "$ME: $file: failed to open for writing: $!\n";
-  print $out $contents;
-}
-
-{
-  GetOptions
-    (
-     'lib-name=s' => \$lib_name,
-     help => sub { usage 0 },
-     version => sub { print "$ME version $VERSION\n"; exit },
-    ) or usage 1;
-
-  my $fail = 0;
-  defined $lib_name
-    or (warn "$ME: no library name; use --lib-name=NAME\n"), $fail = 1;
-
-  # There must be exactly one argument.
-  @ARGV == 0
-    and (warn "$ME: missing FILE argument\n"), $fail = 1;
-  1 < @ARGV
-    and (warn "$ME: too many arguments:\n", join ("\n", @ARGV), "\n"),
-      $fail = 1;
-  $fail
-    and usage 1;
-
-  my $file = $ARGV0;
-  $prefix = (dirname $file) . '/';
-  warn "prefix=$prefix\n";
-
-  process $file;
-}
-
-### Setup "GNU" style for perl-mode and cperl-mode.
-## Local Variables:
-## perl-indent-level: 2
-## perl-continued-statement-offset: 2
-## perl-continued-brace-offset: 0
-## perl-brace-offset: 0
-## perl-brace-imaginary-offset: 0
-## perl-label-offset: -2
-## cperl-indent-level: 2
-## cperl-brace-offset: 0
-## cperl-continued-brace-offset: 0
-## cperl-label-offset: -2
-## cperl-extra-newline-before-brace: t
-## cperl-merge-trailing-else: nil
-## cperl-continued-statement-offset: 2
-## eval: (add-hook 'before-save-hook 'time-stamp)
-## time-stamp-start: "my $VERSION = '"
-## time-stamp-format: "%:y-%02m-%02d %02H:%02M"
-## time-stamp-time-zone: "UTC0"
-## time-stamp-end: "'; # UTC"
-## End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/tests/gdiffmk_tests.sh Deleted

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/args.pl Deleted

@@ -1,504 +0,0 @@
-########################################################################
-# Legalese
-########################################################################
-
-my $License = q*
-groff_lilypond - integrate 'lilypond' into 'groff' files
-
-Source file position: '<groff-source>/contrib/glilypond/args.pl'
-Installed position: '<prefix>/lib/groff/glilypond'
-
-Copyright (C) 2013-2018 Free Software Foundation, Inc.
-  Written by Bernd Warken <groff-bernd.warken-72@web.de>
-
-Last update: 10 Sep 2015
-
-This file is part of 'GNU groff'.
-
-  '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 3 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/>.
-*;
-
-##### end legalese
-
-
-# use strict;
-# use warnings;
-# use diagnostics;
-
-use integer;
-
-our ( $Globals, $Args, $stderr, $v, $out );
-
-# ----------
-# subs for second run, for remaining long options after splitting and
-# transfer
-# ----------
-
-my %opts_with_arg =
-  (
-
-   '--eps_dir' => sub {
-     $Args->{'eps_dir'} = shift;
-   },
-
-   '--output' => sub {
-     $Args->{'output'} = shift;
-   },
-
-   '--prefix' => sub {
-     $Args->{'prefix'} = shift;
-   },
-
-   '--temp_dir' => sub {
-     $Args->{'temp_dir'} = shift;
-   },
-
-  );				# end of %opts_with_arg
-
-
-my %opts_noarg =
-  (
-
-   '--help' => sub {
-     &usage;
-     exit;
-   },
-
-   '--keep_all' => sub {
-     $Args->{'keep_all'} = TRUE;
-   },
-
-   '--license' => sub {
-     &license;
-     exit;
-   },
-
-   '--ly2eps' => sub {
-     $Args->{'eps_func'} = 'ly';
-   },
-
-   '--pdf2eps' => sub {
-     $Args->{'eps_func'} = 'pdf';
-   },
-
-   '--verbose' => sub {
-     $Args->{'verbose'} = TRUE;
-   },
-
-   '--version' => sub {
-     &version;
-     exit;
-   },
-
-  );				# end of %opts_noarg
-
-
-# used variables in both runs
-
-my @files = EMPTYARRAY;
-
-
-#----------
-# first run for command-line arguments
-#----------
-
-# global variables for first run
-
-my @splitted_args;
-my $double_minus = FALSE;
-my $arg = EMPTYSTRING;
-my $has_arg = FALSE;
-
-
-# Split short option collections and transfer these to suitable long
-# options from above.  Note that '-v' now means '--verbose' in version
-# 'v1.1', earlier versions had '--version' for '-v'.
-
-my %short_opts =
-  (
-   '?' => '--help',
-   'e' => '--eps_dir',
-   'h' => '--help',
-   'l' => '--license',
-   'k' => '--keep_all',
-   'o' => '--output',
-   'p' => '--prefix',
-   't' => '--temp_dir',
-   'v' => '--verbose',
-   'V' => '--verbose',
-  );
-
-
-# transfer long option abbreviations to the long options from above
-
-my @long_opts;
-
-$long_opts3 =
-  {				# option abbreviations of 3 characters
-   '--e' => '--eps_dir',
-   '--f' => '--prefix',		# --f for --file_prefix
-   '--h' => '--help',
-   '--k' => '--keep_all',	# and --keep_files
-   '--o' => '--output',
-   '--p' => '--prefix',		# and --file_prefix
-   '--t' => '--temp_dir',
-   '--u' => '--help',		# '--usage' is mapped to '--help'
-  };
-
-$long_opts4 =
-  {				# option abbreviations of 4 characters
-   '--li' => '--license',
-   '--ly' => '--ly2eps',
-   '--pd' => '--pdf2eps',
-   '--pr' => '--prefix',
-  };
-
-$long_opts6 =
-  {				# option abbreviations of 6 characters
-   '--verb' => '--verbose',
-   '--vers' => '--version',
-  };
-
-
-# subs for short splitting and replacing long abbreviations
-
-my $split_short = sub {
-
-  my @chars = split //, $1;	# omit leading dash
-
-     # if result is TRUE: run 'next SPLIT' afterwards
-
-   CHARS: while ( @chars ) {
-       my $c = shift @chars;
-
-       unless ( exists $short_opts{$c} ) {
-	 $stderr->print( "Unknown short option '-$c'." );
-	 next CHARS;
-       }
-
-       # short option exists
-
-       # map or transfer to special long option from above
-       my $transopt = $short_opts{$c};
-
-       if ( exists $opts_noarg{$transopt} ) {
-	 push @splitted_args, $transopt;
-	 $Args->{'verbose'}  = TRUE if ( $transopt eq '--verbose' );
-	 next CHARS;
-       }
-
-       if ( exists $opts_with_arg{$transopt} ) {
-	 push @splitted_args, $transopt;
-
-	 if ( @chars ) {
-	   # if @chars is not empty, option $transopt has argument
-	   # in this arg, the rest of characters in @chars
-	   push @splitted_args, join "", @chars;
-	   @chars = EMPTYARRAY;
-	   return TRUE;		# use 'next SPLIT' afterwards
-	 }
-
-	 # optarg is the next argument
-	 $has_arg = $transopt;
-	 return TRUE;		# use 'next SPLIT' afterwards
-       }			# end of if %opts_with_arg
-     }				# end of while CHARS
-     return FALSE;		# do not do anything
-};				# end of sub for short_opt_collection
-
-
-my $split_long = sub {
-  my $from_arg = shift;
-  $from_arg =~ /^(^=+)/;
-  my $opt_part = lc($1);
-  my $optarg = undef;
-  if ( $from_arg =~ /=(.*)$/ ) {
-    $optarg = $1;
-  }
-
- N: for my $n ( qw/6 4 3/ ) {
-    $opt_part =~ / # match $n characters
-		   ^
-		   (
-		     .{$n}
-		   )
-		 /x;
-    my $argn = $1;		# get the first $n characters
-
-    # no match, so luck for fewer number of chars
-    next N unless ( $argn );
-
-    next N unless ( exists $long_opts$n->{$argn} );
-    # not in $n hash, so go on to next loop for $n
-
-    # now $n-hash has arg
-
-    # map or transfer to special long opt from above
-    my $transopt = $long_opts$n->{$argn};
-
-    # test on option without arg
-    if ( exists $opts_noarg{$transopt} ) { # opt has no arg
-      $stderr->print( 'Option ' . $transopt . 'has no argument: ' .
-		      $from_arg . '.' ) if ( defined($optarg) );
-      push @splitted_args, $transopt;
-      $Args->{'verbose'} = TRUE if ( $transopt eq '--verbose' );
-      return TRUE;		# use 'next SPLIT' afterwards
-    }				# end of if %opts_noarg
-
-    # test on option with arg
-    if ( exists $opts_with_arg{$transopt} ) { # opt has arg
-      push @splitted_args, $transopt;
-
-      # test on optarg in arg
-      if ( defined($optarg) ) {
-	push @splitted_args, $1;
-	return TRUE; # use 'next SPLIT' afterwards
-      } # end of if optarg in arg
-
-      # has optarg in next arg
-      $has_arg = $transopt;
-      return TRUE; # use 'next SPLIT' afterwards
-    } # end of if %opts_with_arg
-
-    # not with and without option, so is not permitted
-    $stderr->print( "'" . $transopt .
-		    "' is unknown long option from '" . $from_arg . "'" );
-    return TRUE; # use 'next SPLIT' afterwards
-  } # end of for N
-  return FALSE; # do nothing
-}; # end of split_long()
-
-
-#----------
-# do split and transfer arguments
-#----------
-sub run_first {
-
- SPLIT: foreach (@ARGV) {
-    # Transform long and short options into some given long options.
-    # Split long opts with arg into 2 args (no '=').
-    # Transform short option collections into given long options.
-    chomp;
-
-    if ( $has_arg ) {
-      push @splitted_args, $_;
-      $has_arg = EMPTYSTRING;
-      next SPLIT;
-    }
-
-    if ( $double_minus ) {
-      push @files, $_;
-      next SPLIT;
-    }
-
-    if ( $_ eq '-' ) {		# file arg '-'
-      push @files, $_;
-      next SPLIT;
-    }
-
-    if ( $_ eq '--' ) {		# POSIX arg '--'
-      push @splitted_args, $_;
-      $double_minus = TRUE;
-      next SPLIT;
-    }
-
-    if ( / # short option or collection of short options
-	   ^
-	   -
-	   (
-	     ^-
-	     .*
-	   )
-	   $
-	 /x ) {
-      $split_short->($1);
-      next SPLIT;
-    }				# end of short option
-
-    if ( /^--/ ) {		# starts with 2 dashes, a long option
-      $split_long->($_);
-      next SPLIT;
-    }				# end of long option
-
-    # unknown option without leading dash is a file name
-    push @files, $_;
-    next SPLIT;
-  }				# end of foreach SPLIT
-
-				# all args are considered
-  $stderr->print( "Option '$has_arg' needs an argument." )
-    if ( $has_arg );
-
-
-  push @files, '-' unless ( @files );
-  @ARGV = @splitted_args;
-
-};		    # end of first run, splitting with map or transfer
-
-
-#----------
-# open or ignore verbose output
-#----------
-sub install_verbose {
-  if ( $Args->{'verbose'} ) { # '--verbose' was used
-    # make verbose output into $v
-    my $s = $v->get(); # get content of string so far as array ref, close
-
-    $v = new FH_STDERR(); # make verbose output into STDERR
-    if ( $s ) {
-      for ( @$s ) {
-	# print the file content into new verbose output
-	$v->print($_);
-      }
-    }
-    # verbose output is now active (into STDERR)
-    $v->print( "Option '-v' means '--verbose'." );
-    $v->print( "Version information is printed by option '--version'." );
-    $v->print( "#" x 72 );
-
-  } else { # '--verbose' was not used
-    # do not be verbose, make verbose invisible
-
-    $v->close(); # close and ignore the string content
-
-    $v = new FH_NULL();
-    # this is either into /dev/null or in an ignored string
-
-  } # end if-else about verbose
-  # '$v->print' works now in any case
-
-  $v->print( "Verbose output was chosen." );
-
-  my $s = $Globals->{'prog_is_installed'} ? '' : ' not';
-  $v->print( $Globals->{'prog'} . " is" . $s .
-	     " installed." );
-
-  $v->print( 'The command-line options are:' );
-
-  $s = "  options:";
-  $s .= " '" . $_ . "'" for ( @ARGV );
-  $v->print( $s );
-
-  $s = "  file names:";
-  $s .= " '" . $_ . "'\n" for ( @files );
-  $v->print( $s );
-} # end install_verbose()
-
-
-#----------
-# second run of command-line arguments
-#----------
-sub run_second {
-    # Second run of args with new @ARGV from the former splitting.
-    # Arguments are now splitted and transformed into special long options.
-
-    my $double_minus = FALSE;
-    my $has_arg = FALSE;
-
-  ARGS: for my $arg ( @ARGV ) {
-
-      # ignore '--', file names are handled later on
-      last ARGS if ( $arg eq '--' );
-
-      if ( $has_arg ) {
-	unless ( exists $opts_with_arg{$has_arg} ) {
-	  $stderr->print( "'\%opts_with_args' does not have key '" .
-			    $has_arg . "'." );
-	  next ARGS;
-	}
-
-	$opts_with_arg{$has_arg}->($arg);
-	$has_arg = FALSE;
-	next ARGS;
-      } # end of $has_arg
-
-      if ( exists $opts_with_arg{$arg} ) {
-	$has_arg = $arg;
-	next ARGS;
-      }
-
-      if ( exists $opts_noarg{$arg} ) {
-	$opts_noarg{$arg}->();
-	next ARGS;
-      }
-
-      # not a suitable option
-      $stderr->print( "Wrong option '" . $arg . "'." );
-      next ARGS;
-
-    } # end of for ARGS:
-
-
-    if ( $has_arg ) { # after last argument
-      die "Option '$has_arg' needs an argument.";
-    }
-
-  }; # end of second run
-
-
-sub handle_args {
-  # handling the output of args
-
-  if ( $Args->{'output'} ) { # '--output' was set in the arguments
-    my $out_path = &path2abs($Args->{'output'});
-    die "Output file name $Args->{'output'} cannot be used."
-      unless ( $out_path );
-
-    my ( $file, $dir );
-    ( $file, $dir ) = File::Basename::fileparse($out_path)
-      or die "Could not handle output file path '" . $out_path . "': " .
-	"directory name '" . $dir . "' and file name '" . $file . "'.";
-
-    die "Could not find output directory for '" . $Args->{'output'} . "'"
-      unless ( $dir );
-    die "Could not find output file: '" . $Args->{'output'} .
-      "'" unless ( $file );
-
-    if ( -d $dir ) {
-      die "Could not write to output directory '" . $dir . "'."
-	unless ( -w $dir );
-    } else {
-      $dir = &make_dir($dir);
-      die "Could not create output directory in: '" . $out_path . "'."
-	unless ( $dir );
-    }
-
-    # now $dir is a writable directory
-
-    if ( -e $out_path ) {
-      die "Could not write to output file '" . $out_path . "'."
-	unless ( -w $out_path );
-    }
-
-    $out = new FH_FILE( $out_path );
-    $v->print( "Output goes to file '" . $out_path . "'." );
-  } else { # '--output' was not set
-    $out = new FH_STDOUT();
-  }
-  # no $out is the right behavior for standard output
-
-#  $Args->{'prefix'} .= '_' . $Args->{'eps_func'} . '2eps';
-
-  @ARGV = @files;
-}
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/oop_fh.pl Deleted

@@ -1,309 +0,0 @@
-my $License = q*
-########################################################################
-# Legalese
-########################################################################
-
-Source file position: '<groff-source>/contrib/glilypond/oop_fh.pl'
-Installed position: '<prefix>/lib/groff/glilypond/oop_fh.pl'
-
-Copyright (C) 2013-2013 Free Software Foundation, Inc.
-  Written by Bernd Warken <groff-bernd.warken-72@web.de>
-
-This file is part of 'glilypond', which is part of 'GNU groff'.
-
-glilypond - integrate 'lilypond' into 'groff' files
-
-  '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 3 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/>.
-*;
-
-##### end legalese
-
-
-# use strict;
-# use warnings;
-# use diagnostics;
-
-use integer;
-
-########################################################################
-# OOP for writing file handles that are open by default, like STD*
-########################################################################
-
-# -------------------------- _FH_WRITE_OPENED --------------------------
-
-{	# FH_OPENED: base class for all opened file handles, like $TD*
-
-  package _FH_WRITE_OPENED;
-  use strict;
-
-  sub new {
-    my ( $pkg, $std ) = @_;
-    bless {
-	   'fh' => $std,
-	  }
-  }
-
-  sub open {
-  }
-
-  sub close {
-  }
-
-  sub print {
-    my $self = shift;
-    for ( @_ ) {
-      print { $self->{'fh'} } $_;
-    }
-  }
-
-}
-
-
-# ------------------------------ FH_STDOUT ----------------------------
-
-{			     # FH_STDOUT: print to noral output STDOUT
-
-  package FH_STDOUT;
-  use strict;
-  @FH_STDOUT::ISA = qw( _FH_WRITE_OPENED );
-
-  sub new {
-    &_FH_WRITE_OPENED::new( '_FH_WRITE_OPENED', *STDOUT );
-  }
-
-}				# end FH_STDOUT
-
-
-# ------------------------------ FH_STDERR -----------------------------
-
-{				# FH_STDERR: print to STDERR
-
-  package FH_STDERR;
-  use strict;
-  @FH_STDERR::ISA = qw( _FH_WRITE_OPENED );
-
-  sub new {
-    &_FH_WRITE_OPENED::new( 'FH_OPENED', *STDERR );
-  }
-
-}				# end FH_STDERR
-
-
-########################################################################
-# OOP for file handles that write into a file or string
-########################################################################
-
-# ------------------------------- FH_FILE ------------------------------
-
-{	       # FH_FILE: base class for writing into a file or string
-
-  package FH_FILE;
-  use strict;
-
-  sub new {
-    my ( $pkg, $file ) = @_;
-    bless {
-	   'fh' => undef,
-	   'file' => $file,
-	   'opened' => main::FALSE,
-	  }
-  }
-
-  sub DESTROY {
-    my $self = shift;
-    $self->close();
-  }
-
-  sub open {
-    my $self = shift;
-    my $file = $self->{'file'};
-    if ( $file && -e $file ) {
-      die "file $file is not writable" unless ( -w $file );
-      die "$file is a directory" if ( -d $file );
-    }
-    open $self->{'fh'}, ">", $self->{'file'}
-      or die "could not open file '$file' for writing: $!";
-    $self->{'opened'} = main::TRUE;
-  }
-
-  sub close {
-    my $self = shift;
-    close $self->{'fh'} if ( $self->{'opened'} );
-    $self->{'opened'} = main::FALSE;
-  }
-
-  sub print {
-    my $self = shift;
-    $self->open() unless ( $self->{'opened'} );
-    for ( @_ ) {
-      print { $self->{'fh'} } $_;
-    }
-  }
-
-}				# end FH_FILE
-
-
-# ------------------------------ FH_STRING -----------------------------
-
-{				# FH_STRING: write into a string
-
-  package FH_STRING;		# write to \string
-  use strict;
-  @FH_STRING::ISA = qw( FH_FILE );
-
-  sub new {
-    my $pkg = shift;		# string is a reference to scalar
-    bless
-      {
-       'fh' => undef,
-       'string' => '',
-       'opened' => main::FALSE,
-      }
-    }
-
-  sub open {
-    my $self = shift;
-    open $self->{'fh'}, ">", \ $self->{'string'}
-      or die "could not open string for writing: $!";
-    $self->{'opened'} = main::TRUE;
-  }
-
-  sub get { # get string, move to array ref, close, and return array ref
-    my $self = shift;
-    return '' unless ( $self->{'opened'} );
-    my $a = &string2array( $self->{'string'} );
-    $self->close();
-    return $a;
-  }
-
-}				# end FH_STRING
-
-
-# -------------------------------- FH_NULL -----------------------------
-
-{				# FH_NULL: write to null device
-
-  package FH_NULL;
-  use strict;
-  @FH_NULL::ISA = qw( FH_FILE FH_STRING );
-
-  use File::Spec;
-
-  my $devnull = File::Spec->devnull();
-  $devnull = '' unless ( -e $devnull && -w $devnull );
-
-  sub new {
-    my $pkg = shift;
-    if ( $devnull ) {
-      &FH_FILE::new( $pkg, $devnull );
-    } else {
-      &FH_STRING::new( $pkg );
-    }
-  } # end new()
-
-}				# end FH_NULL
-
-
-########################################################################
-# OOP for reading file handles
-########################################################################
-
-# ---------------------------- FH_READ_FILE ----------------------------
-
-{ # FH_READ_FILE: read a file
-
-  package FH_READ_FILE;
-  use strict;
-
-  sub new {
-    my ( $pkg, $file ) = @_;
-    die "File '$file' cannot be read." unless ( -f $file && -r $file );
-    bless {
-	   'fh' => undef,
-	   'file' => $file,
-	   'opened' => main::FALSE,
-	  }
-  }
-
-  sub DESTROY {
-    my $self = shift;
-    $self->close();
-  }
-
-  sub open {
-    my $self = shift;
-    my $file = $self->{'file'};
-    if ( $file && -e $file ) {
-      die "file $file is not writable" unless ( -r $file );
-      die "$file is a directory" if ( -d $file );
-    }
-    open $self->{'fh'}, "<", $self->{'file'}
-      or die "could not read file '$file': $!";
-    $self->{'opened'} = main::TRUE;
-  }
-
-  sub close {
-    my $self = shift;
-    close $self->{'fh'} if ( $self->{'opened'} );
-    $self->{'opened'} = main::FALSE;
-  }
-
-  sub read_line {
-    # Read 1 line of the file into a chomped string.
-    # Do not close the read handle at the end.
-    my $self = shift;
-    $self->open() unless ( $self->{'opened'} );
-
-    my $res;
-    if ( defined($res = CORE::readline($self->{'fh'}) ) ) {
-      chomp $res;
-      return $res;
-    } else {
-      $self->close();
-      return undef;
-    }
-  }
-
-  sub read_all {
-    # Read the complete file into an array reference.
-    # Close the read handle at the end.
-    # Return array reference.
-    my $self = shift;
-    $self->open() unless ( $self->{'opened'} );
-
-    my $res = ;
-    my $line;
-    while ( defined ( $line = CORE::readline $self->{'fh'} ) ) {
-      chomp $line;
-      push @$res, $line;
-    }
-    $self->close();
-    $self->{'opened'} = main::FALSE;
-    return $res;
-  }
-
-}
-
-# end of OOP definitions
-
-package main;
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/subs.pl Deleted

@@ -1,471 +0,0 @@
-my $License = q*
-########################################################################
-# Legalese
-########################################################################
-
-Subroutines for 'glilypond'.
-
-Source file position: '<groff-source>/contrib/glilypond/subs.pl'
-Installed position: '<prefix>/lib/groff/glilypond/subs.pl'
-
-Copyright (C) 2013-2018 Free Software Foundation, Inc.
-  Written by Bernd Warken <groff-bernd.warken-72@web.de>
-
-Last update: 10 Sep 2015
-
-This file is part of 'glilypond', which is part of 'GNU groff'.
-
-  '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 3 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/>.
-*;
-
-##### end legalese
-
-
-# use strict;
-# use warnings;
-# use diagnostics;
-
-use integer;
-use utf8;
-use feature 'state';
-
-my $P_PIC;
-# $P_PIC = '.PDFPIC';
-$P_PIC = '.PSPIC';
-
-########################################################################
-# subs for using several times
-########################################################################
-
-sub create_ly2eps {		       # '--ly2eps' default
-  our ( $out, $Read, $Temp );
-
-  my $prefix = $Read->{'file_numbered'};   # with dir change to temp dir
-
-  # '$ lilypond --ps -dbackend=eps -dgs-load-fonts \
-  #      output=file_without_extension file.ly'
-  # extensions are added automatically
-  my $opts = '--ps -dbackend=eps -dinclude-eps-fonts -dgs-load-fonts ' .
-    "--output=$prefix $prefix";
-  &run_lilypond("$opts");
-
-  Cwd::chdir $Temp->{'cwd'} or
-      die "Could not change to former directory '" .
-	$Temp->{'cwd'} . "': $!";
-
-  my $eps_dir = $Temp->{'eps_dir'};
-  my $dir = $Temp->{'temp_dir'};
-  opendir( my $dh, $dir ) or
-    die "could not open temporary directory '$dir': $!";
-
-  my $re = qr<
-	       ^
-	       $prefix
-	       -
-	       .*
-	       \.eps
-	       $
-	     >x;
-  my $file;
-  while ( readdir( $dh ) ) {
-    chomp;
-    $file = $_;
-    if ( /$re/ ) {
-      my $file_path = File::Spec->catfile($dir, $file);
-      if ( $eps_dir ) {
-	my $could_copy = FALSE;
-	File::Copy::copy($file_path, $eps_dir)
-	    and $could_copy = TRUE;
-	if ( $could_copy ) {
-	  unlink $file_path;
-	  $file_path = File::Spec->catfile($eps_dir, $_);
-	}
-      }
-      $out->print( $P_PIC . ' ' . $file_path );
-    }
-  }				# end while readdir
-  closedir( $dh );
-}				# end sub create_ly2eps()
-
-
-sub create_pdf2eps {		       # '--pdf2eps'
-  our ( $v, $stdout, $stderr, $out, $Read, $Temp );
-
-  my $prefix = $Read->{'file_numbered'};   # with dir change to temp dir
-
-  &run_lilypond("--pdf --output=$prefix $prefix");
-
-  my $file_pdf = $prefix . '.pdf';
-  my $file_ps = $prefix . '.ps';
-
-  # pdf2ps in temp dir
-  my $temp_file = &next_temp_file;
-  $v->print( "\n##### run of 'pdf2ps'" );
-  # '$ pdf2ps file.pdf file.ps'
-  my $output = `pdf2ps $file_pdf $file_ps 2> $temp_file`;
-  die 'Program pdf2ps does not work.' if ( $? );
-  &shell_handling($output, $temp_file);
-  $v->print( "##### end run of 'pdf2ps'\n" );
-
-  # ps2eps in temp dir
-  $temp_file = &next_temp_file;
-  $v->print( "\n##### run of 'ps2eps'" );
-  # '$ ps2eps file.ps'
-  $output = `ps2eps $file_ps 2> $temp_file`;
-  die 'Program ps2eps does not work.' if ( $? );
-  &shell_handling($output, $temp_file);
-  $v->print( "##### end run of 'ps2eps'\n" );
-
-  # change back to former dir
-  Cwd::chdir $Temp->{'cwd'} or
-      die "Could not change to former directory '" .
-	$Temp->{'cwd'} . "': $!";
-
-  # handling of .eps file
-  my $file_eps = $prefix . '.eps';
-  my $eps_path = File::Spec->catfile($Temp->{'temp_dir'}, $file_eps);
-  if ( $Temp->{'eps_dir'} ) {
-    my $has_copied = FALSE;
-    File::Copy::copy( $eps_path, $Temp->{'eps_dir'} )
-	and $has_copied = TRUE;
-    if ( $has_copied ) {
-      unlink $eps_path;
-      $eps_path = File::Spec->catfile( $Temp->{'eps_dir'}, $file_eps );
-    } else {
-      $stderr->print( "Could not use EPS-directory." );
-    } # end Temp->{'eps_dir'}
-  }
-  # print into groff output
-  $out->print( $P_PIC . ' ' . $eps_path );
-}				# end sub create_pdf2eps()
-
-
-sub is_subdir {			# arg1 is subdir of arg2 (is longer)
-  my ( $dir1, $dir2 ) = @_;
-  $dir1 = &path2abs( $dir1 );;
-  $dir2 = &path2abs( $dir2 );;
-  my @split1 = File::Spec->splitdir($dir1);
-  my @split2 = File::Spec->splitdir($dir2);
-  for ( @split2 ) {
-    next if ( $_ eq shift @split1 );
-    return FALSE;
-  }
-  return TRUE;
-}
-
-
-sub license {
-  our ( $Legalese, $stdout );
-  &version;
-  $stdout->print( $Legalese->{'license'} );
-} # end sub license()
-
-
-sub make_dir {			# make directory or check if it exists
-  our ( $v, $Args );
-
-  my $dir_arg = shift;
-  chomp $dir_arg;
-  $dir_arg =~ s/^\s*(.*)\s*$/$1/;
-
-  unless ( $dir_arg ) {
-    $v->print( "make_dir(): empty argument" );
-    return FALSE;
-  }
-
-  unless ( File::Spec->file_name_is_absolute($dir_arg) ) {
-    my $res = Cwd::realpath($dir_arg);
-    $res = File::Spec->canonpath($dir_arg) unless ( $res );
-    $dir_arg = $res if ( $res );
-  }
-
-  return $dir_arg if ( -d $dir_arg && -w $dir_arg );
-
-
-  # search thru the dir parts
-  my @dir_parts = File::Spec->splitdir($dir_arg);
-  my @dir_grow;
-  my $dir_grow;
-  my $can_create = FALSE;	# dir could be created if TRUE
-
- DIRPARTS: for ( @dir_parts ) {
-    push @dir_grow, $_;
-    next DIRPARTS unless ( $_ ); # empty string for root directory
-
-    # from array to path dir string
-    $dir_grow = File::Spec->catdir(@dir_grow);
-
-    next DIRPARTS if ( -d $dir_grow );
-
-    if ( -e $dir_grow ) {  # exists, but not a dir, so must be removed
-      die "Couldn't create dir '$dir_arg', it is blocked by '$dir_grow'."
-	unless ( -w $dir_grow );
-
-      # now it's writable, but not a dir, so it can be removed
-      unlink ( $dir_grow ) or
-	die "Couldn't remove '$dir_grow', " .
-	  "so I cannot create dir '$dir_arg': $!";
-    }
-
-    # $dir_grow does no longer exist, so the former dir must be writable
-    # in order to create the directory
-    pop @dir_grow;
-    $dir_grow = File::Spec->catdir(@dir_grow);
-
-    die "'$dir_grow' is not writable, " .
-      "so directory '$dir_arg' can't be createdd."
-	unless ( -w $dir_grow );
-
-    # former directory is writable, so '$dir_arg' can be created
-
-    File::Path::make_path( $dir_arg,
-			   {
-			    mask => oct('0700'),
-			    verbose => $Args->{'verbose'},
-			   }
-			 )	#  'mkdir -P'
-	or die "Could not create directory '$dir_arg': $!";
-
-    last DIRPARTS;
-  }
-
-  die "'$dir_arg' is not a writable directory"
-    unless ( -d $dir_arg && -w $dir_arg );
-
-  return $dir_arg;
-
-} # end sub make_dir()
-
-
-my $number = 0;
-sub next_temp_file {
-  our ( $Temp, $v, $Args );
-  ++$number;
-  my $temp_basename = $Args->{'prefix'} . '_temp_' . $number;
-  my $temp_file = File::Spec->catfile( $Temp->{'temp_dir'} ,
-				       $temp_basename );
-  $v->print( "next temporary file: '$temp_file'" );
-  return $temp_file;
-}				# end sub next_temp_file()
-
-
-sub path2abs {
-  our ( $Temp, $Args );
-
-  my $path = shift;
-  $path =~ s/
-	      ^
-	      \s*
-	      (
-		.*
-	      )
-	      \s*
-	      $
-	    /$1/x;
-
-  die "path2abs(): argument is empty." unless ( $path );
-
-  # Perl does not support shell '~' for home dir
-  if ( $path =~ /
-		  ^
-		  ~
-		/x ) {
-    if ( $path eq '~' ) {	# only own home
-      $path = File::HomeDir->my_home;
-    } elsif ( $path =~ m<
-			  ^
-			  ~ /
-			  (
-			    .*
-			  )
-			  $
-			>x ) {	# subdir of own home
-      $path = File::Spec->catdir( $Temp->{'cwd'}, $1 );
-    } elsif ( $path =~ m<
-			  ^
-			  ~
-			  (
-			    ^/+
-			  )
-			  $
-			>x ) {	# home of other user
-      $path = File::HomeDir->users_home($1);
-    } elsif ( $path =~ m<
-			  ^
-			  ~
-			  (
-			    ^/+
-			  )
-			  /+
-			  (
-			    .*
-			  )
-			  $
-			>x ) {	# subdir of other home
-      $path = File::Spec->
-	catdir( File::HomeDir->users_home($1), $2 );
-    }
-  }
-
-  $path = File::Spec->rel2abs($path);
-
-  # now $path is absolute
-  return $path;
-} # end sub path2abs()
-
-
-sub run_lilypond {
-  # arg is the options collection for 'lilypond' to run
-  # either from ly or pdf
-
-  our ( $Temp, $v );
-
-  my $opts = shift;
-  chomp $opts;
-
-  my $temp_file = &next_temp_file;
-  my $output = EMPTYSTRING;
-
-  # change to temp dir
-  Cwd::chdir $Temp->{'temp_dir'} or
-      die "Could not change to temporary directory '" .
-	$Temp->{'temp_dir'} . "': $!";
-
-  $v->print( "\n##### run of 'lilypond " . $opts . "'" );
-  $output = `lilypond $opts 2>$temp_file`;
-  die "Program lilypond does not work, see '$temp_file': $?"
-    if ( $? );
-  chomp $output;
-  &shell_handling($output, $temp_file);
-  $v->print( "##### end run of 'lilypond'\n" );
-
-  # stay in temp dir
-} # end sub run_lilypond()
-
-
-sub shell_handling {
-  # Handle ``-shell-command output in a string (arg1).
-  # stderr goes to temporary file $TempFile.
-
-  our ( $out, $v, $Args );
-
-  my $out_string = shift;
-  my $temp_file = shift;
-
-  my $a = &string2array($out_string); # array ref
-  for ( @$a ) {
-    $out->print( $_ );
-  }
-
-  $temp_file && -f $temp_file && -r $temp_file ||
-    die "shell_handling(): $temp_file is not a readable file.";
-  my $temp = new FH_READ_FILE($temp_file);
-  my $res = $temp->read_all();
-  for ( @$res ) {
-    chomp;
-    $v->print($_);
-  }
-
-  unlink $temp_file unless ( $Args->{'keep_all'} );
-} # end sub shell_handling()
-
-
-sub string2array {
-  my $s = shift;
-  my @a = ();
-  for ( split "\n", $s ) {
-    chomp;
-    push @a, $_;
-  }
-  return \@a;
-} # end string2array()
-
-
-sub usage {			# for '--help'
-  our ( $Globals, $Args );
-
-  my $p = $Globals->{'prog'};
-  my $usage = EMPTYSTRING;
-  $usage = '###### usage:' . "\n" if ( $Args->{'verbose'} );
-  $usage .= qq*Options for $p:
-Read a 'roff' file or standard input and transform 'lilypond' parts
-(everything between '.lilypond start' and '.lilypond end') into
-'EPS'-files that can be read by groff using '.PSPIC'.
-
-There is also a command '.lilypond include <file_name>' that can
-include a complete 'lilypond' file into the 'groff' document.
-
-
-# Breaking options:
-$p -?|-h|--help|--usage    # usage
-$p --version               # version information
-$p --license               # the license is GPL >= 3
-
-
-# Normal options:
-$p options -- filename ...
-
-There are 2 options for influencing the way how the 'EPS' files for the
-'roff' display are generated:
---ly2eps           'lilypond' generates 'EPS' files directly (default)
---pdf2eps          'lilypond' generates a 'PDF' file that is transformed
-
--k|--keep_all      do not delete any temporary files
--v|--verbose       print much information to STDERR
-
-Options with an argument:
--e|--eps_dir=...   use a directory for the EPS files
--o|--output=...    sent output in the groff language into file ...
--p|--prefix=...    start for the names of temporary files
--t|--temp_dir=...  provide the directory for temporary files.
-
-The directories set are created when they do not exist.
-*;
-
-  # old options:
-  # --keep_files       -k: do not delete any temporary files
-  # --file_prefix=...  -p: start for the names of temporary files
-
-  $main::stdout->print( $usage );
-} # end sub usage()
-
-
-sub version { # for '--version'
-  our ( $Globals, $Legalese, $stdout, $Args );
-  my $end;
-  if ( $Globals->{'groff_version'} ) {
-    $end = " version $Globals->{'groff_version'}";
-  } else {
-    $end = '.';
-  }
-
-  my $output = EMPTYSTRING;
-  $output = "###### version:\n" if ( $Args->{'verbose'} );
-  $output .= "'" . $Globals->{'prog'} . "' version '" .
-    $Legalese->{'version'} . "' is part of 'GNU groff'" . $end;
-
-  $stdout->print($output);
-} # end sub version()
-
-
-# end of subs
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gpinyin/subs.pl Deleted

@@ -1,576 +0,0 @@
-#! /usr/bin/env perl
-
-# gpinyin - European-like Chinese writing 'pinyin' into 'groff'
-
-# Source file position: <groff-source>/contrib/gpinyin/gpinyin.pl
-# Installed position: <prefix>/bin/gpinyin
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# This file is part of 'gpinyin', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 can find a copy of the GNU General Public License in the internet
-# at <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-########################################################################
-# All Pinyin syllables from wikipedia
-########################################################################
-
-my %syllables =
-  (
-   'a' => 1, 'ai' => 1, 'an' => 1, 'ang' => 1, 'ao' => 1,
-   'ba' => 1, 'bai' => 1, 'ban' => 1, 'bang' => 1, 'bao' => 1,
-   'bei' => 1, 'ben' => 1, 'beng' => 1,
-   'bi' => 1, 'bian' => 1, 'biao' => 1, 'bie' => 1, 'bin' => 1,
-   'bing' => 1, 'bo' => 1, 'bu' => 1,
-   'ca' => 1, 'cai' => 1, 'can' => 1, 'cang' => 1, 'cao' => 1,
-   'ce' => 1, 'cen' => 1, 'ceng' => 1,
-   'cha' => 1, 'chai' => 1, 'chan' => 1, 'chang' => 1, 'chao' => 1,
-   'che' => 1, 'chen' => 1, 'cheng' => 1, 'chi' => 1,
-   'chong' => 1, 'chou' => 1, 'chu' => 1,
-   'chua' => 1, 'chuai' => 1, 'chuan' => 1, 'chuang' => 1,
-   'chui' => 1, 'chun' => 1, 'chuo' => 1,
-   'ci' => 1, 'cong' => 1, 'cou' => 1,
-   'cu' => 1, 'cuan' => 1, 'cui' => 1, 'cun' => 1, 'cuo' => 1,
-   'da' => 1, 'dai' => 1, 'dan' => 1, 'dang' => 1, 'dao' => 1,
-   'de' => 1, 'dei' => 1, 'den' => 1, 'deng' => 1,
-   'di' => 1, 'dian' => 1, 'diao' => 1, 'die' => 1,
-   'ding' => 1, 'diu' => 1, 'dong' => 1, 'dou' => 1,
-   'du' => 1, 'duan' => 1, 'dui' => 1, 'dun' => 1, 'duo' => 1,
-   'e' => 1, 'ei' => 1, 'en' => 1,  'eng' => 1, 'er' => 1,
-   'fa' => 1, 'fan' => 1, 'fang' => 1,
-   'fei' => 1, 'fen' => 1, 'feng' => 1, 'fiao' => 1,
-   'fo' => 1, 'fou' => 1, 'fu' => 1,
-   'ga' => 1, 'gai' => 1, 'gan' => 1, 'gang' => 1, 'gao' => 1,
-   'ge' => 1, 'gei' => 1, 'gen' => 1, 'geng' => 1,
-   'gong' => 1, 'gou' => 1, 'gu' => 1,
-   'gua' => 1, 'guai' => 1, 'guan' => 1, 'guang' => 1, 'gui' => 1,
-   'gun' => 1, 'guo' => 1,
-   'ha' => 1, 'hai' => 1, 'han' => 1, 'hang' => 1, 'hao' => 1,
-   'he' => 1, 'hei' => 1, 'hen' => 1, 'heng' => 1,
-   'hong' => 1, 'hou' => 1,
-   'hu' => 1, 'hua' => 1, 'huai' => 1, 'huan' => 1, 'huang' => 1,
-   'hui' => 1, 'hun' => 1, 'huo' => 1,
-   'ji' => 1, 'jia' => 1, 'jian' => 1, 'jiang' => 1, 'jiao' => 1,
-   'jie' => 1, 'jin' => 1, 'jing' => 1, 'jiong' => 1, 'jiu' => 1,
-   'ju' => 1, 'juan' => 1, 'jue' => 1, 'jun' => 1,
-   'ka' => 1, 'kai' => 1, 'kan' => 1, 'kang' => 1, 'kao' => 1,
-   'ke' => 1, 'kei' => 1, 'ken' => 1, 'keng' => 1,
-   'kong' => 1, 'kou' => 1, 'ku' => 1, 'kua' => 1, 'kuai' => 1,
-   'kuan' => 1, 'kuang' => 1, 'kui' => 1, 'kun' => 1, 'kuo' => 1,
-   'la' => 1, 'lai' => 1, 'lan' => 1, 'lang' => 1, 'lao' => 1,
-   'le' => 1, 'lei' => 1, 'leng' => 1,
-   'li' => 1, 'lia' => 1, 'lian' => 1, 'liang' => 1, 'liao' => 1,
-   'lie' => 1, 'lin' => 1, 'ling' => 1, 'liu' => 1,
-   'lo' => 1, 'long' => 1, 'lou' => 1,
-   'lu' => 1, 'luan' => 1, 'lun' => 1, 'luo' => 1,
-   'lü' => 1, 'lüe' => 1,
-   'ma' => 1, 'mai' => 1, 'man' => 1, 'mang' => 1, 'mao' => 1,
-   'me' => 1, 'mei' => 1, 'men' => 1, 'meng' => 1,
-   'mi' => 1, 'mian' => 1, 'miao' => 1, 'mie' => 1,
-   'min' => 1, 'ming' => 1, 'miu' => 1,
-   'mo' => 1, 'mou' => 1, 'mu' => 1,
-   'na' => 1, 'nai' => 1, 'nan' => 1, 'nang' => 1, 'nao' => 1,
-   'ne' => 1, 'nei' => 1, 'nen' => 1, 'neng' => 1,
-   'ni' => 1, 'nian' => 1, 'niang' => 1, 'niao' => 1, 'nie' => 1,
-   'nin' => 1, 'ning' => 1, 'niu' => 1, 'nong' => 1, 'nou' => 1,
-   'nu' => 1, 'nuan' => 1, 'nun' => 1, 'nuo' => 1,
-   'nü' => 1, 'nüe' => 1,
-   'o' => 1, 'ong' => 1, 'ou' => 1,
-   'pa' => 1, 'pai' => 1, 'pan' => 1, 'pang' => 1, 'pao' => 1,
-   'pei' => 1, 'pen' => 1, 'peng' => 1,
-   'pi' => 1, 'pian' => 1, 'piao' => 1, 'pie' => 1, 'pin' => 1,
-   'ping' => 1, 'po' => 1, 'pou' => 1, 'pu' => 1,
-   'qi' => 1, 'qia' => 1, 'qian' => 1, 'qiang' => 1, 'qiao' => 1, 'qie' => 1,
-   'qin' => 1, 'qing' => 1, 'qiong' => 1, 'qiu' => 1,
-   'qu' => 1, 'quan' => 1, 'que' => 1, 'qun' => 1,
-   'ran' => 1, 'rang' => 1, 'rao' => 1, 're' => 1, 'ren' => 1,
-   'ri' => 1, 'rong' => 1, 'rou' => 1,
-   'ru' => 1, 'ruan' => 1, 'rui' => 1, 'run' => 1, 'ruo' => 1,
-   'sa' => 1, 'sai' => 1, 'san' => 1, 'sang' => 1, 'sao' => 1,
-   'se' => 1, 'sen' => 1, 'seng' => 1,
-   'sha' => 1, 'shai' => 1, 'shan' => 1, 'shang' => 1, 'shao' => 1,
-   'she' => 1, 'shei' => 1, 'shen' => 1, 'sheng' => 1, 'shi' => 1,
-   'shou' => 1, 'shu' => 1, 'shua' => 1, 'shuai' => 1, 'shuan' => 1,
-   'shuang' => 1, 'shui' => 1, 'shun' => 1, 'shuo' => 1,
-   'si' => 1, 'song' => 1, 'sou' => 1, 'su' => 1, 'suan' => 1, 'sui' => 1,
-   'sun' => 1, 'suo' => 1,
-   'ta' => 1, 'tai' => 1, 'tan' => 1, 'tang' => 1, 'tao' => 1,
-   'te' => 1, 'teng' => 1,
-   'ti' => 1, 'tian' => 1, 'tiao' => 1, 'tie' => 1, 'ting' => 1,
-   'tong' => 1, 'tou' => 1,
-   'tu' => 1, 'tuan' => 1, 'tui' => 1, 'tun' => 1, 'tuo' => 1,
-   'wa' => 1, 'wai' => 1, 'wan' => 1, 'wang' => 1,
-   'wei' => 1, 'wen' => 1, 'weng' => 1, 'wo' => 1, 'wu' => 1,
-   'xi' => 1, 'xia' => 1, 'xian' => 1, 'xiang' => 1, 'xiao' => 1,
-   'xie' => 1, 'xin' => 1, 'xing' => 1, 'xiong' => 1, 'xiu' => 1,
-   'xu' => 1, 'xuan' => 1, 'xue' => 1, 'xun' => 1,
-   'ya' => 1, 'yai' => 1, 'yan' => 1, 'yang' => 1, 'yao' => 1,
-   'ye' => 1, 'yi' => 1, 'yin' => 1, 'ying' => 1,
-   'yo' => 1, 'yong' => 1, 'you' => 1,
-   'yu' => 1, 'yuan' => 1, 'yue' => 1, 'yun' => 1,
-   'za' => 1, 'zai' => 1, 'zan' => 1, 'zang' => 1, 'zao' => 1,
-   'ze' => 1, 'zei' => 1, 'zen' => 1, 'zeng' => 1,
-   'zha' => 1, 'zhai' => 1, 'zhan' => 1, 'zhang' => 1, 'zhao' => 1,
-   'zhe' => 1, 'zhei' => 1, 'zhen' => 1, 'zheng' => 1, 'zhi' => 1,
-   'zhong' => 1, 'zhou' => 1, 'zhu' => 1, 'zhua' => 1, 'zhuai' => 1,
-   'zhuan' => 1, 'zhuang' => 1, 'zhui' => 1, 'zhun' => 1, 'zhuo' => 1,
-   'zi' => 1, 'zong' => 1, 'zou' => 1, 'zu' => 1, 'zuan' => 1,
-   'zui' => 1, 'zun' => 1, 'zuo' => 1,
-  );
-
-########################################################################
-# Unicode variables for utf8 tty (nroff)
-########################################################################
-
-my %tones1_Unicode =
-  (
-   'A' => q(\\u0100),
-   'E' => q(\\u0112),
-   'I' => q(\\u012A),
-   'O' => q(\\u014C),
-   'U' => q(\\u016A),
-   'Ü' => q(\\u016A),
-   'a' => q(\\u0101),
-   'e' => q(\\u0113),
-   'i' => q(\\u012B),
-   'o' => q(\\u014D),
-   'u' => q(\\u016B),
-   'ü' => q(\\u01D6),
-  );
-
-my %tones2_Unicode =
-  (
-   'A' => q(\\u00C1),
-   'E' => q(\\u00C9),
-   'I' => q(\\u00CD),
-   'O' => q(\\u00D3),
-   'U' => q(\\u00DA),
-   'Ü' => q(\\u01D7),
-   'a' => q(\\u00E1),
-   'e' => q(\\u00E9),
-   'i' => q(\\u00ED),
-   'o' => q(\\u00F3),
-   'u' => q(\\u00FA),
-   'ü' => q(\\u01D8),
-  );
-
-my %tones3_Unicode =
-  (
-   'A' => q(\\u01CD),
-   'E' => q(\\u011A),
-   'I' => q(\\u01CF),
-   'O' => q(\\u01D1),
-   'U' => q(\\u01D3),
-   'Ü' => q(\\u01D9),
-   'a' => q(\\u01CE),
-   'e' => q(\\u011B),
-   'i' => q(\\u01D0),
-   'o' => q(\\u01D2),
-   'u' => q(\\u01D4),
-   'ü' => q(\\u01DA),
-  );
-
-my %tones4_Unicode =
-  (
-   'A' => q(\\u00C0),
-   'E' => q(\\u00C8),
-   'I' => q(\\u00CC),
-   'O' => q(\\u00D2),
-   'U' => q(\\u00D9),
-   'Ü' => q(\\u01DB),
-   'a' => q(\\u00E0),
-   'e' => q(\\u00E8),
-   'i' => q(\\u00EC),
-   'o' => q(\\u00F2),
-   'u' => q(\\u00F9),
-   'ü' => q(\\u01DC),
-  );
-
-
-########################################################################
-# glyph variables for troff
-########################################################################
-
-#my $tone1_macron = '\\a-';
-#my $tone2_acute = '\\aa';
-#my $tone3_caron = '\\ah';
-#my $tone4_grave = '\\ga';
-my @accents = ( '', '\\a-', '\\aa', '\\ah', '\\ga', );
-
-my %tones2_glyphs =
-  (
-   'A' => q(\\'A),
-   'E' => q(\\'E),
-   'I' => q(\\'I),
-   'O' => q(\\'O),
-   'U' => q(\\'U),
-   'a' => q(\\'a),
-   'e' => q(\\'e),
-   'i' => q(\\'i),
-   'o' => q(\\'o),
-   'u' => q(\\'u),
-  );
-
-my %tones4_glyphs =
-  (
-   'A' => q(\\`A),
-   'E' => q(\\`E),
-   'I' => q(\\`I),
-   'O' => q(\\`O),
-   'U' => q(\\`U),
-   'a' => q(\\`a),
-   'e' => q(\\`e),
-   'i' => q(\\`i),
-   'o' => q(\\`o),
-   'u' => q(\\`u),
-  );
-
-
-
-########################################################################
-# subs
-########################################################################
-
-# Pinyin consists of syllables with a final number to be translated
-# into an accent.  Such numbered syllables are combined into words.
-# Such words can have a final punctuation.  A line is a collection of
-# such words.
-
-my @roffs = ( 'n',
-	      't',
-	    );
-
-########################################################################
-sub err {
-  my $s = shift;
-  print STDERR $s;
-  1;
-} # err()
-
-
-########################################################################
-sub handle_line {
-  my $starting_blanks = shift;
-  my $line = shift;
-
-#&err('handle_line start: ' . $line);
-
-  my %outline = ( 'n' => $starting_blanks, 't' => $starting_blanks, );
-
-  # transform to Ü only for inside of Perl
-  $line =~ s/\\
-	     \(:U
-	    /Ü/gx;
-  $line =~ s/\\
-	     \:U\
-	    /Ü/gx;
-
-# handle_line()
-
-  # transform to ü only for inside of Perl
-  $line =~ s/\\
-	     \(:u
-	    /ü/gx;
-  $line =~ s/\\
-	     \:u\
-	    /ü/gx;
-
-  $line =~ s/UeE/Ü/g;
-  $line =~ s/ueE/ü/g;
-
-  $line =~ s/\\\(aq/'/g;	# \(aq is an apostrophe
-  $line =~ s/\\\aq\/'/g;	# \aq is an apostrophe
-  $line =~ s/^'//;		# remove leading apostrophe
-  $line =~ s/'$//;		# remove final apostrophe
-  $line =~ s/''+/'/g;	# combine apostrophe groups
-  $line =~ s/(0-4)'/$1/;
-  $line =~ s/(^0-4)'/${1}0/;
-
-  my @words = split /\s+/, $line;
-
-
-# handle_line()
-  for my $word ( @words ) {
-#&err('handle_line word: ' . $word);
-
-    next unless ( $word );
-
-    # this is a word, maybe composed of several syllables
-    my $punctuation = $1 if ( $word =~ s/(,.?!:;*)$// );
-    # '$word' is now without punctuation
-
-    my %outword = &handle_word($word);
-    next unless ( %outword );
-
-    for my $roff ( @roffs ) {
-#&err('handle_line roff ' . $roff .  ': ' . $outword{$roff});
-
-      # combine words to line
-      next unless ( $outword{$roff} );
-
-      # non-initial space
-      $outline{$roff} .= ' ' if ( $outline{$roff} );
-
-      $outline{$roff} .= $outword{$roff};
-      $outline{$roff} .= $punctuation;
-    }
-  }
-#for my $roff ( @roffs ) {
-#&err('handle_line end ' . $roff .  ': ' . $outline{$roff});
-#}
-  return %outline;
-} # handle_line()
-
-
-########################################################################
-sub handle_word {
-  my $word = shift;
-#&err('handle_word start: ' . $word);
-
-  $word =~ s/5/0/g;		# transform 5 to 0
-  $word =~ s/(^0-4)$/${1}0/;	# add lacking final no-tone
-
-  # remove apostrophes with tone
-  $word =~ s/
-	      (0-4)
-	      '
-	    /$1/gx;
-  # replace apostrophes without tone by 0
-  $word =~ s/
-	      (^0-4)
-	      '
-	    /${1}0/gx;
-
-# handle_word()
-  # detect wrong tone numbers
-  if ( $word =~ s/5-9/0/g ) {
-    &err('word ' . $word . ': wrong tone number ' . $1);
-    return {};
-  }
-
-  $word =~ s/'//g;		# remove apostrophes
-
-  # remove starting apostrophe or number
-  $word =~ s/^('0-4)+//;
-
-  # add 0 for final no-tone
-  $word .= '0' if ( $word =~ /^0-4$/ );
-
-  if ( $word =~ /^0-9/ ) {	# word starts with number
-    print 'word: ' . $word . ' starts with tone number';
-    $word =~ s/^0-9+//;
-  }
-#&err('handle_word 0: ' . $word);
-
-# handle_word()
-
-  my %outword = ( 'n' => '', 't' => '', );
-
-  # split word into syllables
-  while ( $word =~ /^a-zA-ZüÜ'/ ) {
-    $word =~ s/^(a-zA-ZüÜ'+)(0-4)//;
-    my $syll = $1;
-    my $tone = $2;
-#err('handle_word split: ' . $syll . ' ' . $tone);
-    my %outsyll = &handle_syll( $syll, $tone );
-    next unless ( %outsyll );
-    for my $roff ( @roffs ) {
-      my $out = $outsyll{$roff};
-      $out = '\\aq' . $out if ( $out && $out =~ /^aeo/ );
-      $outword{$roff} .= $out;
-#&err('handle_word ' . $roff . ': ' . $outword{$roff});
-    }
-  }
-  return %outword;
-} # handle_word()
-
-
-########################################################################
-sub handle_syll {
-  my $syll = shift;
-  my $tone = shift;
-#&err( 'handle_syll start: ' . $syll . ' ' . $tone);
-
-  my $lower_case = lc($syll);
-  $lower_case =~ s/Ü/ü/g;
-  unless ( exists($syllables{$lower_case}) ) {
-    err('The syllable ' . $syll . ' is not a Chinese syllable.');
-    return {};
-  }
-
-  my %outsyll = ( 'n' => '', 't' => '', );
-
-  if ( $tone == 0 ) {	# no accent
-    # use u umlaut without accent
-    $syll =~ s/Ü/\\:U/g;
-    $syll =~ s/ü/\\:u/g;
-
-    for my $roff ( @roffs ) {
-      $outsyll{$roff} = $syll;
-#&err('handle_syll 0 outsyll ' . $roff . ': ' . $outsyll{$roff});
-    }
-    return %outsyll;
-  }	# end of tone 0
-
-# handle_syll()
-
-  # split syllable
-  $syll =~
-    /^
-     (a-zA-Z*)
-     (aeiouAEIOUüÜ+)
-     (a-zA-Z*)
-     $/x;
-  my $initial = $1;
-  my $vowels = $2;
-  my $final = $3;
-  unless ( $vowels ) {
-    &err( 'Syllable ' . $syll . ' does not have vowels' );
-    return {};
-  }
-
-  # split vowels
-  my $vowels_before = '';
-  my $vowel = '';
-  my $vowels_after = '';
-
-# handle_syll()
-
-  # find vowel for accent
-  if ( $vowels =~ /^aeiouAEIOU$/ ) {		# only 1 vowel
-#&err('handle_syll single vowel ' . $vowels);
-    $vowel = $vowels;
-  } elsif ( $vowels eq 'ü' ) {
-    $vowel = $vowels;
-  } elsif ( $vowels eq 'Ü' ) {
-    $vowel = $vowels;
-  } elsif ( $vowels =~ /^(^aeAE*)(aeAE)(.*)$/ ) {	# a, A, e or E
-    $vowels_before = $1;
-    $vowel = $2;
-    $vowels_after = $3;
-  } elsif ( $vowels =~ /^(^oO*)(oO)(.*)$/ ) {		# o or O
-    $vowels_before = $1;
-    $vowel = $2;
-    $vowels_after = $3;
-  } elsif ( $vowels =~ /^(\w)(\w)(.*)$/ ) {		# take 2nd vowel
-    $vowels_before = $1;
-    $vowel = $2;
-    $vowels_after = $3;
-  } else {
-    &err( 'Unknown vowels: ' . $vowels . ' in syllable: ' . $syll );
-    return {};
-  }
-
-#  unless ( $vowel =~ /^aeiouAEIOU$/ ) {
-#    print STDERR q(The argument ') . $vowel . q(' is not a vowel!);
-#    return {};
-#  }
-
-# handle_syll()
-
-  $outsyll{'n'} = &vowel_n($vowel, $tone);
-  $outsyll{'t'} = &vowel_t($vowel, $tone);
-
-  for my $roff ( @roffs ) {
-    $outsyll{$roff} = $initial .  $vowels_before .
-      $outsyll{$roff} . $vowels_after .  $final;
-#&err('handle_syll out ' . $roff . ': ' . $outsyll{$roff});
-  }
-
-  return %outsyll;
-} # handle_syll()
-
-
-########################################################################
-sub vowel_n {	# Unicode for nroff
-  my $vowel = shift;
-  my $tone = shift;
-#&err('vowel_n: ' . $vowel . ' ' . $tone);
-
-  return '' unless ( $vowel );
-
-  if ( $tone == 1 ) {		# macron
-    $vowel = $tones1_Unicode{$vowel};
-  } elsif ( $tone == 2 ) {	# acute
-    $vowel = $tones2_Unicode{$vowel};
-  } elsif ( $tone == 3 ) {	# caron
-    $vowel = $tones3_Unicode{$vowel};
-  } elsif ( $tone == 4 ) {	# grave
-    $vowel = $tones4_Unicode{$vowel};
-  }
-  return $vowel;
-} # vowel_nr()
-
-
-########################################################################
-sub vowel_t {	# named glyphs for troff
-  my $vowel = shift;
-  my $tone = shift;
-#&err( 'vowel_t: ' . $vowel . ' ' . $tone);
-
-  return '' unless ( $vowel );
-
-  # \o'\s-2\:u\s0\a-'
-  if ( $vowel =~ /üÜ/ ) {
-    my $smaller = 2;
-    $vowel = q(\\o'\\s-) . $smaller . q(\\:u\\s0) .
-      $accents$tone . q(');
-    return $vowel;
-  }
-
-  $vowel = q(\\.i) if ( $vowel eq 'i' );
-
-  if ( $tone == 1 ) {		# macron
-    $vowel = q(\\o') . $vowel . $accents$tone . q(');
-  } elsif ( $tone == 2 ) {	# acute
-    $vowel = $tones2_glyphs{$vowel};
-  } elsif ( $tone == 3 ) {	# caron
-    $vowel = q(\\o') . $vowel . $accents$tone . q(');
-  } elsif ( $tone == 4 ) {	# grave
-    $vowel = $tones4_glyphs{$vowel};
-  }
-  return $vowel;
-} # vowel_t()
-
-
-########################################################################
-sub finish_pinyin_mode {
-#&err( 'finish' );
-  my $n = shift;
-  my $t = shift;
-  push @$n, '\\}';
-  push @$t, '\\}';
-
-  for ( @$n ) {	# Unicode for nroff
-    print;
-  }
-
-  for ( @$t ) {	# glyphs for troff
-    print;
-  }
-
-  1;
-} # finish_pinyin_mode()
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groff_filenames Deleted

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groff_filenames/ChangeLog Deleted

@@ -1,108 +0,0 @@
-2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.5.man: Use section 5 within this man-page.
-
-2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.5.man: Rename `groff_filenames.1.man'.
-
-	* groff_filenames.am: Include section changing.
-
-2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.1.man: Rename `groff_filenames.man'.
-
-	* groff_filenames.am: Include renaming.
-
-2015-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.am: Add `Last update'.  Setup Emacs mode.
-
-2015-04-03  Werner LEMBERG  <wl@gnu.org>
-
-	* groff_filenames.man: Make it work in compatibility mode.
-
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man, Makefile.sub: Repair copying and Emacs
-	setup.
-
-2014-08-31  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Replace Heirloom links to more actual
-	places.  Create macro definitions for authors and copying.
-
-2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Add extension `.1b' for `heirloom'
-	man-pages.
-
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Make it compatible to doclifter.
-
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Transform to classical man-page style.
-
-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
-
-	* 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
-
-2013-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	Remove files *~
-
-2013-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Corrections.
-
-2013-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groff_filenames.man: Extension.
-
-2013-05-14  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* runoff.man: Major rewrite, due to good documentation of 1974,
-	especially for text lines.
-
-2013-05-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	New `groff' project: `RUNOFF', which is the predecessor of `roff'.
-
-	* ChangeLog: New file for the `contrib' source.
-
-	* Makefile.sub: New `make' file, so far only for 2 man-files.
-
-	* runoff.man: New file which documents the `RUNOFF' language from
-	the 1960s up to the 1980s.
-
-	* groff_filenames.man: New file about the file name extensions
-	since `RUNOFF'.
-
-########################################################################
-
-Copyright 2013-2018 Free Software Foundation, Inc.
-
-Copying and distribution of this file, with or without modification,
-are permitted in any medium without royalty provided the copyright
-notice and this notice are preserved.
-
-Local Variables:
-version-control: never
-mode: change-log
-coding: utf-8
-End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groff_filenames/groff_filenames.5.man Deleted

@@ -1,656 +0,0 @@
-.TH GROFF_FILENAMES @MAN5EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_filenames \- filename extensions for roff and groff
-.
-.\" ad l
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2013-2018 Free Software Foundation, Inc.
-.\"
-.\" This file is part of groff, a free software project.  You can
-.\" redistribute it and/or modify it under the terms of the GNU General
-.\" Public License version 2 (GPL2) as published by the Free Software
-.\" Foundation (FSF).
-.\"
-.\" The license text can be found in the internet at
-.\" <http://www.gnu.org/licenses>.
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-Since the evolution of
-.I roff
-in the 1970s, a whole bunch of filename extensions for
-.I roff
-files were used.
-.
-.
-.P
-The
-.I roff
-extensions refer to preprocessors or macro packages.
-.
-These extensions are fixed in all
-.IR Unix \-like
-operating systems.
-.
-.
-.P
-Later on,
-.B groff
-added some more extensions.
-.
-This
-.I man page
-is about these filename extensions.
-.
-.
-.\" ====================================================================
-.SH COMPRESSION OF ROFF FILES
-.\" ====================================================================
-.
-Each
-.I roff
-file can be optionally
-.IR compressed .
-.
-That means that the
-.I total filename
-ends with a
-.IR "compressor name" .
-.
-So the whole filename has the structure
-.IR <name> . <extension> . <compression> .
-.
-.
-.P
-Best-known are the
-.I compressor extensions
-.BR .Z ,
-.BR .gz ,
-and
-.BR .bzip2 .
-.
-Relatively new is
-.BR .xz .
-.
-.
-.P
-From now on, we will ignore the
-.I compressions
-and only comment the structure
-.IB <name> . <extension>\fR.\fP
-.
-.
-.\" ====================================================================
-.SH MAN PAGES
-.\" ====================================================================
-.
-The
-.I Unix manual pages
-are widely called
-.IR "man pages" .
-.
-The
-.I man page
-style is the best known part of the
-.I roff
-language.
-.
-.
-.P
-The extensions for
-.I man
-should be better documented.
-.
-So this is documented here.
-.
-.
-.P
-Files written in the
-.I man
-language use the following extension:
-.BI *. <section><group> \fR.\fP
-.
-.
-.\" ====================================================================
-.SS Man page Sections
-.\" ====================================================================
-.
-The traditional
-.I man page <section>
-is a digit from
-.B 1
-to
-.BR 8 .
-.
-.
-.TP
-.IB <name> .1
-.TQ
-.IB <name> .2
-.TQ
-.IB <name> .3
-.TQ
-.IB <name> .4
-.TQ
-.IB <name> .5
-.TQ
-.IB <name> .6
-.TQ
-.IB <name> .7
-.TQ
-.IB <name> .8
-Classic man page
-.IR sections .
-.
-.
-.P
-.\" NOTE: There was once a feeble attempt in this direction, but it
-.\" hasn't been true in any sense for a long time.
-.\"Linux added the section number
-.\".B 9
-.\"for kernel man pages.
-.\".
-.\".
-.\".TP
-.\".IB <name> .9
-.\".I Linux
-.\"kernel man pages
-.\".
-.\".
-.P
-In older commercial
-.I Unix
-systems, the 3 characters
-.BR l ,
-.BR n ,
-and
-.B o
-were also used as
-.I section
-names.
-.
-This is today
-.IR deprecated ,
-but there are still documents in this format.
-.
-.
-.TP
-.IB <name> .l
-.TQ
-.IB <name> .n
-.TQ
-.IB <name> .o
-.I Deprecated
-man page sections, which stood for \lqlocal\rq, \lqnew\rq, and
-\lqold\rq, respectively.
-.
-.
-.\" ====================================================================
-.SS Man page Group Extensions
-.\" ====================================================================
-.
-The
-.I <group>
-extension in
-.BI . <section><group>
-is optional, but it can be any string of word characters.
-.
-Usually programmers use a group name that is already used, e.g.\&
-.B x
-for
-X Window System
-documents or
-.B tcl
-to refer to the
-.I Tcl
-programming language.
-.
-.
-.P
-Examples:
-.
-.
-.TP
-.B groff.1
-is the man page for
-.B groff
-in
-.I section
-.B 1
-without a
-.I group
-.
-.
-.TP
-.B xargs.1posix.gz
-is the man page for the program
-.B xargs
-in
-.I section
-.B 1
-and
-.I group
-.BR posix ;
-moreover it is
-.I compressed
-with
-.B gz
-.RB ( gzip ).
-.
-.
-.TP
-.B config.5ssl
-.I "OpenSSL CONF"
-library configuration files from
-.I section
-.B 5
-with
-.I group
-.BR ssl .
-.
-.
-.TP
-.B dpkg\-reconfigure.8cdebconf
-man page for the program
-.B dpkg\-reconfigure
-in
-.I section
-.B 8
-and
-.I group
-.BR cdebconf .
-.
-.
-.\" ====================================================================
-.SS Source of man pages
-.\" ====================================================================
-.
-There are 2
-.I roff
-languages for writing man pages:
-.B man
-and
-.BR mdoc .
-.
-.
-.P
-The names of these 2 styles are taken as
-.I extensions
-for the source code files of man pages in the
-.I groff
-package.
-.
-.
-.TP
-.IB <name> .man
-.I traditional
-Unix-like man page format within groff source files.
-.
-.
-.TP
-.IB <name> . n
-A temporary man page file produced from a
-.IB name .man
-man page by a run of
-.B make
-within the
-.B groff
-source package.
-.
-.
-.TP
-.IB <name> .mdoc
-Man page format in BSD.
-.
-.
-.TP
-.IB <name> .1b
-Man page format in
-.IR "heirloom roff ".
-.
-.
-.TP
-.IB <name> .mandoc
-Files using this extension recognize both man page formats in
-.B groff
-and other processors.
-.
-.
-.\" ====================================================================
-.SH TRADITIONAL TROFF EXTENSIONS
-.\" ====================================================================
-.
-.\" ====================================================================
-.SS Files Using Macro Packages
-.\" ====================================================================
-.
-The
-.I "classical roff"
-languages were interpreted by the traditional
-.B "troff"
-and
-.B "nroff"
-programs.
-.
-.
-.P
-There were several
-.I roff
-languages, each represented by a
-.IR "macro-package" .
-.
-Each of these provided a suitable file name
-.IR extension :
-.
-.
-.TP
-.IB <name> .me
-.I roff
-file using the
-.B me
-.IR "macro package" .
-.
-.
-.TP
-.IB <name> .mm
-.I roff
-file using the
-.B mm
-.I macro package
-.
-.
-.TP
-.IB <name> .ms
-.I roff
-file using the
-.B ms
-.I macro package
-.
-.
-.P
-All of these classical
-.I roff
-languages and their extensions are still very active in
-.BR groff .
-.
-.
-.\" ====================================================================
-.SS Source Code for Macro Packages (TMAC Files)
-.\" ====================================================================
-.
-In traditional
-.I roff
-the source code for the macro packages was stored in
-.I TMAC
-files.
-.
-Their file names have the form:
-.
-.
-.TP
-.BI tmac. <package> \fR,\fP
-.I <package>
-is the name of the macro package without the leading
-.B m
-character, which is reintegrated by the option
-.BR -m .
-.
-.
-.P
-For example,
-.B tmac.an
-is the source for the
-.B man
-macro package.
-.
-.
-.P
-In the
-.B groff
-source, more suitable file names were integrated, see later on.
-.
-.
-.\" ====================================================================
-.SS Preprocessors
-.\" ====================================================================
-.
-Moreover, the following
-.I preprocessors
-were used as filename extension:
-.
-.
-.TP
-.IB <name> .chem
-for the integration of chemical formulas
-.
-.
-.TP
-.IB <name> .eqn
-for the mathematical use of equations
-.
-.
-.TP
-.IB <name> .pic
-graphical tool
-.
-.
-.TP
-.IB <name> .tbl
-for tables with
-.I tbl
-.
-.
-.TP
-.IB <name> .ref
-for files using the
-.B prefer
-.I preprocessor
-.
-.
-.\" ====================================================================
-.SS Classical Roff Files
-.\" ====================================================================
-.
-.TP
-.IB <name> .t
-.TQ
-.IB <name> .tr
-for files using the
-.I roff
-language of any kind
-.
-.
-.\" ====================================================================
-.SH NEW GROFF EXTENSIONS
-.\" ====================================================================
-.
-.I "GNU roff"
-.B groff
-is the actual
-.I roff
-standard, both for classical
-.I roff
-and new extensions.
-.
-So even the used new extensions in the source code should be regarded
-as actual standard.
-.
-The following extensions are used instead of classical
-.B .t
-or
-.BR .tr :
-.
-.
-.TP
-.IB <name> .groff
-.TQ
-.IB <name> .roff
-general ending for files using the
-.I groff language
-.
-.
-.\" ====================================================================
-.SS Source Code for Macro Packages (TMAC Files)
-.\" ====================================================================
-.
-As the classical form
-.BI tmac. <package_without_m> \fR,\fP
-of the
-.I TMAC
-file names is quite strange,
-.
-.I groff
-added the following structures:
-.
-.
-.TP
-.IB <package_without_m> .tmac
-.TQ
-.BI m <package> .tmac
-.TQ
-.BI groff_m <package> .tmac
-.
-.
-.\" ====================================================================
-.SS Files Using new Macro Packages
-.\" ====================================================================
-.
-.I Groff
-uses the following new macro packages:
-.
-.
-.TP
-.IB <name> .mmse
-file with swedish
-.B mm
-.I macros
-for
-.B groff
-.
-.
-.TP
-.IB <name> .mom
-files written in the
-.I "groff macro package"
-.B mom
-.
-.
-.TP
-.IB <name> .www
-files written in
-.BR HTML -like
-.I groff
-.IR macros .
-.
-.
-.\" ====================================================================
-.SS Preprocessors and Postprocessors
-.\" ====================================================================
-.
-.TP
-.IB <name> .hdtbl
-Heidelberger tables, an alternative to the preprocessor
-.IR tbl .
-.
-See
-.BR groff_hdtbl (@MAN7EXT@).
-.
-.
-.TP
-.IB <name> .grap
-files written for the graphical
-.B grap
-processor.
-.
-.
-.TP
-.IB <name> .grn
-for including
-.BR gremlin (@MAN1EXT@),
-pictures, see
-.BR grn (@MAN1EXT@).
-.
-.
-.TP
-.IB <name> .pdfroff
-transform this file with
-.B pdfroff
-of the
-.I groff
-system
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
-Bernd Warken
-.ME .
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.
-.TP
-History and future
-.BR roff (@MAN7EXT@),
-.BR man\-pages (@MAN7EXT@),
-.BR groff_diff (@MAN7EXT@),
-.BR groff (@MAN7EXT@)
-.
-.
-.TP
-.I Compression
-.BR uncompress (1posix),
-.BR gzip2 (@MAN1EXT@),
-.BR bzip2 (@MAN1EXT@),
-.BR xz (@MAN1EXT@)
-.
-.
-.P
-A man page of the naming form
-.IB name ( n )
-can be read in text mode by
-.RS
-.EX
-.BI man " n name"
-.EE
-.RE
-or in graphical mode (PDF) by
-.RS
-.EX
-.BI groffer " n name"
-.EE
-.RE
-.
-.
-.P
-.UR https://\:github.com/\:n\-t\-roff/\:heirloom\-doctools
-.I Gunnar Ritter's Heirloom roff project
-.UE .
-.
-You can get this package with the shell command:
-.RS
-.EX
-\(Do \fBgit clone https://github.com/n\-t\-roff/heirloom\-doctools\fP
-.EE
-.RE
-.
-.
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: set filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groff_filenames/groff_filenames.am Deleted

@@ -1,43 +0,0 @@
-# Automake rules for 'groff_filenames'
-
-# File position: <groff-source>/contrib/groff_filenames/groff_filenames.am
-
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
-
-# Last update: 22 Aug 2015
-
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-# Automake migration by Bertrand Garrigues
-
-# 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
-# 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
-# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-########################################################################
-
-man5_MANS += contrib/groff_filenames/groff_filenames.5
-EXTRA_DIST += \
-  contrib/groff_filenames/ChangeLog \
-  contrib/groff_filenames/groff_filenames.5.man
-
-
-########################################################################
-# Editor settings
-########################################################################
-#
-# Local Variables:
-# mode: makefile-automake
-# fill-column: 72
-# End:
-# vim: set filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer Deleted

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/ChangeLog Deleted

@@ -1,564 +0,0 @@
-2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
-
-	* version.sh: Bump groffer version to 2.3.0, reflecting Bernd's
-	  addition of the xhtml device/mode feature in 2015.  This
-	  change extended the interface of the groffer
-	  program--backwards-compatibly--e.g., by adding the '--xhtml'
-	  option.
-
-2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
-
-	* version.sh (_GROFF_VERSION_PRESET): Set to 1.22.4.
-
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
-
-	* groffer.am (groffer): Use $(AM_V_GEN) to silence file generation.
-
-2015-08-27  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* *.pl: Add device (mode) `xhtml'.
-
-	* groffer.1.man: Add documentation for device `xhtml'.
-
-2015-08-27  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.1.man: Correct the documentation for `--viewer'.
-
-2015-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.1.man: Rename `groffer.man'.
-
-	* roff2.1.man: Rename `roff2.man'.
-
-	* groffer.am: Include renamings.
-
-2015-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.am: Add `Last update'.  Setup Emacs mode.
-
-2015-04-04  Werner LEMBERG  <wl@gnu.org>
-
-	* roff2.man (EL): Fix typo.
-
-2015-04-04  Werner LEMBERG  <wl@gnu.org>
-
-	* roff2.man: Make it work in compatibility mode.
-
-2015-04-04  Werner LEMBERG  <wl@gnu.org>
-
-	* groffer.man: Make it work in compatibility mode.
-	(EL): Fix typo.
-
-2015-03-20  Werner LEMBERG  <wl@gnu.org>
-
-	* subs.pl (where_is_prog): Fix typo.
-
-2014-11-04  Werner LEMBERG  <wl@gnu.org>
-
-	* version.sh (_GROFF_VERSION_PRESET): Set to 1.22.3.
-
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: Version 2.2.5
-
-	* all groffer files: Copying and Emacs setup.
-
-2014-08-02  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: Version 2.2.4
-
-	* groffer.pl: Change default `tty' to `utf8'.
-
-2014-08-02  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	Version 2.2.3
-
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* subs.pl: Correct call for `grog'.
-
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.man, roff2.man: Make compatible with `doclifter'.
-
-2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* main_subs.pl: Add newer `groff' options `j' and `J'.
-
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.man, roff2.man: Transform to classical man-page style.
-
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: New version 2.2.2
-
-	* groffer.man: Rename `.Env_var' to `.Small_CB'.
-
-2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* roff2.man: Move `.TH', etc. to the beginning of the file.
-
-	* groffer.man: Improve definition of char `Ellipsis'.
-
-2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.tmac: Remove this file.
-
-	* Makefile.sub: Remove parts related to `groffer.tmac'.
-
-	* groffer.man: Instead of `.mso' for `groffer.tmac' copy former
-	`groffer.tmac' at the head of the man-page.
-
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* Makefile.sub: Let `groffer.tmac' be removed in uninstalling
-	`tmacdir'.
-
-	* groffer.man: Use `.mso' for `groffer.tmac'.  Remove definitions
-	for macros, etc.
-
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: New version 2.2.1.
-
-	* groffer.tmac: Collection of strings and macros for `groffer.man'
-	and other man-pages.
-
-	* Makefile.sub: Add `groffer.tmac'.
-
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: Upgrade to version 2.1.3.
-
-	* perl_test.pl: Remove this file.
-
-	* Makefile.sub: Remove HAS_PERL.
-
-	* groffer.pl: Add `require' for Perl version.
-
-2014-06-11  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* func.pl, subs.pl: Rename `func.pl' to `subs.pl'.
-
-	* groffer.pl, main_subs.pl: Move all subs in `groffer.pl' to
-	`main_subs.pl'.
-
-	* version.sh: Upgrade to version 2.1.2.
-
-2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.pl: Fix ligature error `fi', etc. in pdf-mode by
-	appending `-P-y -PU' to `grog' call.  pfd2-mode works, but still
-	has the ligature error.
-
-	* func.pl: Reorder.
-
-	* version.sh: Upgrade to version 2.1.1.
-
-2014-06-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
-
-	* Proposal to use `-P-y -PU' arguments for `groff' in `-Tpdf'.
-
-2014-05-31  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.pl, func.pl, groffer.man: Change all existing viewer
-	options into a single one `--viewer'.
-
-	* version.sh: Upgrade to version 2.1.0.
-
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
-
-	* Makefile.sub: Put straight error-prevention prefixes for `rm'.
-
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
-
-	* Makefile.sub (uninstall_sub): Typo.
-
-2014-03-27  Werner LEMBERG  <wl@gnu.org>
-
-	Fix `make install'.
-
-	* Makefile.sub (GROFFER_PERL, GROFFER_REST): Don't use $(srcdir).
-
-2014-03-11  Ingo Schwarze  <schwarze@openbsd.org>  (tiny change)
-
-	* Makefile.sub (clean): Don't remove checked-in file `groffer.man'.
-
-	This got broken in fabbbb0e335801bc20f5c25fb0c448e23673721d when
-	`groffer.man' was moved from the former `perl' subdir and the cp(1)
-	call was removed that used to copy it around.
-
-2014-02-26  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* Makefile.sub: fix
-
-2014-02-26  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.pl: Fix modes pdf and pdf2.
-
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.pl: fix source location, when run before `make'
-
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* groffer.man: replace .copyleft by .co
-
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* all former Perl files: Correct source file position.
-
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* all: Add links for license text.
-
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* version.sh: new version groffer 2.0.2
-	* perl/: Move all files to top directory and remove this
-	directory.
-	* Makefile.sub: Handle the deletion of perl/.
-	* groffer.pl: Rename traditional pdf mode with ps2pdf into pdf2.
-	Create a new mode pdf using groff -Tpdf.  New options: --pdf2,
-	--mode=pdf2.
-	* groffer.man: Document the renamed and new options.
-	* README, README_PERL: rewrite
-
-2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	New version groffer-2.0.1
-	- with Perl
-	- without Shell version
-
-	Remove
-	* shell/ChangeLog.0
-	* shell/README_SH
-	* shell/groffer.man
-	* shell/groffer.sh
-	* shell/groffer2.sh
-	* shell/roff2.sh
-	* shell/
-
-	* README: remove hints to the shell version
-	* Makefile.sub: remove hints to the shell version
-	* version.sh: change version number to `2.0.1'
-	* .cvsignore, .gitignore: rename `.cvsignore' to `.gitignore'
-
-2013-12-22  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* git@github.com:RUNOFF/groffer.git: remove this archive
-
-2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* contrib/groffer: There is now a free `git' package containing
-	all old `groffer' versions `v0.*' and `v1.*'.  The new versions
-	`groffer 2.*' will actually not be included.  This package can be
-	got at:
-
-	$ git clone git@github.com:RUNOFF/groffer.git
-
-2013-03-29  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* perl/groffer.pl: Change viewers for `PS'.
-
-2013-03-29  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	* perl/groffer.pl: Change viewers for `PS' and `PDF'.
-
-	* version.sh: New version is `1.1.3'.
-
-2012-08-09  Werner LEMBERG  <wl@gnu.org>
-
-	Synchronize man pages.
-
-	* perl/groffer.man, shell/groffer.man: Fix many minor issues.
-
-2012-08-07  Eric S. Raymond  <esr@thyrsus.com>
-
-	Yet more elimination of low-level troff hackery in the
-	documentation so it can be lifted to structural markup.
-
-	* perl/groffer.man: Use .IP rather than .TP in
-	.Topic; this make structural parsing work.  Also remove a
-	pointless and somewhat out-of-date .ig section.
-
-2011-10-17  Ingo Schwarze  <schwarze@openbsd.org>
-
-	Do not use INSTALL_DATA and INSTALL_SCRIPT during build phase.
-
-	* Makefile.sub (groffer): Replace INSTALL_DATA and
-	INSTALL_SCRIPT with `cp'.  Otherwise the build phase might
-	fail with `permission denied' if you use the `-o root' flag
-	of the `install' command.  The use of INSTALL_* is an abuse
-	anyway because it's not installing anything at that point;
-	it's just copying files around locally, within in the build
-	directories.
-
-2011-03-21  Jan Vcelak  <jvcelak@redhat.com>
-	    Bernd Warken <groff-bernd.warken-72@web.de>
-
-	Remove hardcoded path to 'libdir/groff/groffer' directory.
-
-	* Makefile.sub: use @groffer_dir@
-
-	* groffer.pl: use @groffer_dir@
-
-2011-01-27  James Budiono  <james.budiono@gmail.com>
-	    Bernd Warken <groff-bernd.warken-72@web.de>
-
-	Fix display of manpages.
-
-	Reported as
-	http://lists.gnu.org/archive/html/bug-groff/2011-01/msg00015.html.
-
-	* perl/groffer.pl (_get_first_prog): Fix return value.
-	(Viewer_X): Add `okular' viewer.
-	* perl/man.pl (manpath_set_from_path): Handle `@main::Path)'
-	correctly.
-
-	* version.sh: Updated.
-
-2009-01-03  Werner LEMBERG  <wl@gnu.org>
-
-	* version.sh: Prepare for groff release 1.20.
-
-2008-01-04  Werner LEMBERG  <wl@gnu.org>
-
-	* shell/groffer.man, perl/groffer.man: Insert `\:' in URLs where
-	appropriate.
-
-2007-02-15  Eric S. Raymond  <esr@snark.thyrsus.com>
-
-	* perl/groffer.man, perl/groffer.man: Fix non-portable `if'
-	expressions.
-
-2007-02-13  Eric S. Raymond  <esr@snark.thyrsus.com>
-
-	Use an-ext.tmac macros in groffer.man.
-
-	* perl/groffer.man, perl/groffer.man: Replace ShellCommand with
-	.EX/.EE pairs.
-	Don't use .TP for examples, as some viewers won't handle a display
-	macro as a tag line.  Use .SY/.OP/.YS rather than elaborate custom
-	macros.
-
-2007-02-02  Werner LEMBERG  <wl@gnu.org>
-
-	* roff2.man: Further refinements and normalizations.
-
-2007-02-02  Eric S. Raymond  <esr@snark.thyrsus.com>
-
-	* roff2.man: Converted to use .SY/.OP/.YS and for cross-viewer
-	portability.  Conversion checked using the protocol described in
-	tmac/TESTING-HINTS.
-
-2006-11-14  Werner LEMBERG  <wl@gnu.org>
-
-	* Makefile.sub (GROFFER_REST): Add roff2.man.
-	(groffer): Use $(INSTALL_DATA) for man pages.
-	Don't call `chmod' for $(ROFF2PROGS).
-	(roff2.man): Typographical fixes.
-
-2006-11-11  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.1.1
-
-	* perl/roff2.pl, shell/roff2.sh: Create a new working mode without
-	`groffer' for `roff2*'.
-
-	* perl/groffer.pl: Fix test of temporary directory.
-
-2006-11-09  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.1.0
-
-	* perl/groffer.pl, perl/func.pl, perl/groffer.man, \
-	shell/groffer2.sh, shell/groffer.man: Add `--debug-grog' to
-	display the `grog' output.
-
-	* perl/roff2.pl, shell/roff2.sh: New files for creating the roff2*
-	programs to transform roff code to different formats.
-
-	* roff2.man: New file to create man pages for the roff2*
-	programs.
-
-	* Makefile.sub: Add roff2* and some minor fixes.
-
-2006-11-04  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.0.3
-
-	* Makefile.sub:
-	- Delete removing of $(CLEANADD) in `groffer'.
-	- Add $(MAN1) to `groffer'.
-
-	* perl/groffer.pl, perl/func.pl, shell/groffer2.sh:
-	- Add `groff' option with argument `-K'.
-	- Redesign the changed `grog'.
-
-2006-10-23  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.0.2
-
-	* perl/groffer.pl:
-	- Move all variable declarations out of BEGIN.
-	- Move all `use' commands outside of BEGIN.  Fix the arising
-	errors.
-	- Correct new position of perl/perl_test.pl.
-
-	* perl/func.pl:
-	- version(): Fix the determination of the version of groff.
-	- usage(): Sort it among the functions in this file.
-
-	* perl/groffer.man, shell/groffer.man: Fix string variable
-	Ellipsis.
-
-	* shell/README_SH: Add information on Autobook.
-
-	* shell/groffer.sh:
-	- Extent simple shell tests by testing on support for functions.
-	Test standard shell on function support.  Add error reports on
-	shell tests.
-	- Set unset variables LANG LC_ALL LC_MESSAGES LC_CTYPES LANGUAGES
-	to `C', according to Autobook, ch. 22.
-	- Remove option `-e' from `sed'.
-
-	* shell/groffer2.sh:
-	- Add test on directory in man path find.
-	- Add Bourne compatibility for zsh shell.
-	- Replace `echo -n ""' by `:'.
-	- Remove -e option from sed.
-
-2006-10-23  Werner Lemberg
-
-	* perl_test.pl: Moved to...
-	* perl/perl_test.pl: Here.
-
-	* Makefile.sub: Rewritten.  Change PERL to HAVE_PERL and SHELL to
-	HAVE_SHELL.
-
-2006-10-14  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.0.1
-
-	* perl/groffer.pl: Change $perl_test_pl to $file_perl_test_pl.
-
-	* perl/groffer.pl, perl/func.pl: Remove `\n' in `die' calls.
-
-2006-10-12  Bernd Warken  <groff-bernd.warken-72@web.de>
-	________________________________________________________________
-	* release of groffer 1.0.0
-
-	Changements of the shell version since 0.9.31
-
-	* shell/groffer.sh: Use version.sh in the upper directory.
-
-2006-10-02  Bernd Warken  <groff-bernd.warken-72@web.de>
-
-	The groffer versions 1.* have two kinds of program, a shell
-	version and a Perl version.
-
-	The shell version is kept from the old shell only versions of
-	groffer 0.*.  Most of the former files in the main groffer
-	directory are now moved to the subdirectoy shell/.
-
-	The Perl version of groffer is a complete rewrite; most of its
-	files are found in the subdirectory perl/.
-
-	The Makefile.sub decides whether the shell or Perl version of
-	groffer is installed.  This is done by the program perl_test.pl.
-
-	In the following, all files in the groffer directory tree are
-	mentioned.
-
-	* ChangeLog: This file.  It contains information for `groffer'
-	versions >= 1.0.0 with shell and Perl kinds.  For older `groffer'
-	versions, see `shell/ChangeLog.0' which contains information for
-	the shell only versions of groffer 0.*.
-
-	* Makefile.sub: The old `Makefile.sub' was extended to support the
-	shell and the Perl version of `groffer' at the same time.  If the
-	test of `perl_test.pl' succeeds the `groffer' Perl version will be
-	installed, otherwise the shell version is used.
-
-	* perl_test.pl: This is used by `Makefile.sub' and installed with
-	the Perl version of `groffer'.  It is a test of the installed perl
-	version.  The installed Perl version should be greater or equal
-	than the version that is required by this file.
-
-	* version.sh: This is the old file kept from the shell version of
-	`groffer'.  It stores the `groffer' version, the date of the last
-	update, and the `groff' version.  It is used and installed for the
-	shell and Perl version of `groffer'.
-
-	* README: This is the old `README' file extended by information on
-	the shell and Perl kinds of `groffer'.
-
-	* perl/: Subdirectory for the Perl version of `groffer'.
-
-	* perl/groffer.pl: This is the `groffer' script of the Perl
-	version, a Perl source file that handles the complete groffer
-	functionality.
-
-	* perl/man.pl: This is the collection of functions that are
-	related to man pages, `apropos', and `whatis'.  It is loaded by
-	`perl/groffer.pl'.
-
-	* perl/func.pl: This is the collection of miscellaneous functions.
-	It is loaded by `perl/groffer.pl'.
-
-	* perl/split_env.sh: A shell script that is used by
-	`perl/groffer.pl' to split a large shell environment variable to a
-	Perl array.
-
-	* perl/groffer.man: This is the man page of the Perl version of
-	`groffer'.  It is derived from `groffer.man' of the shell version.
-	It will only be installed when the `Makefile.sub' chooses to
-	install the Perl version of 'groffer' instead of the shell
-	version.
-
-	* perl/README_PERL: This file contains information of the Perl
-	compatibility and details that are special to the Perl version.
-
-	* shell/: Subdirectory for the shell version of `groffer'.
-
-	* shell/ChangeLog.0: The former `ChangeLog' file of the groffer
-	versions 0.* was moved to this file.  It contains information of
-	the shell only version of groffer 0.*.
-
-	* shell/groffer.sh: This is the old `groffer.sh' file of the shell
-	version.
-
-	* shell/groffer2.sh: This is the old `groffer2.sh' file of the
-	shell version.
-
-	* shell/groffer.man: This is the old man page groffer.man of the
-	shell version.  The shell version keeps its own man page.  It will
-	only be installed when the `Makefile.sub' chooses to install the
-	shell version instead of the Perl version.
-
-	* shell/README_SH: This is the old `README_SH' file of the shell
-	version containing information of the shell compatibility.
-
-	The former part of the ChangeLog file is in `shell/ChangeLog.0'.
-
-2006-10-01  Bernd Warken  <groff-bernd.warken-72@web.de>
-________________________________________________________________
-License
-
-Copyright (C) 2006-2018 Free Software Foundation, Inc.
-Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-Copying and distribution of this file, with or without
-modification, are permitted provided the copyright notice and this
-notice are preserved.
-
-This file is part of `groffer', which is part of the `groff'
-project.
-
-####### Emacs settings
-
-Local Variables:
-mode: change-log
-End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/README Deleted

@@ -1,112 +0,0 @@
-README
-
-The 'groffer' program is the easiest way to read documents written in
-some 'roff' language, such as the 'man pages', the manual pages in
-many operating systems.  All 'roff' preprocessors, such as 'chem' or
-'glilypond', are detected and executed automatically.
-
-
-Input
-
-Input comes from either standard input or command-line parameters that
-represent names of exisiting roff files or standardized specifications
-for searching man pages.  All of these can be compressed in a format
-that is decompressible by 'gzip' or 'bzip2', including '.gz', 'bz2',
-and '.Z'.
-
-'groffer' has many built-in 'man' functionalities to find and read the
-manual pages on Unix and similar operating systems.  It accepts the
-information from an installed 'man' program, but tries to find a man
-path by itself.
-
-'groffer' bundles all filespec parameters into a single output file in
-the same way as 'groff'.  The disadvantage of this is that all file
-name arguments must use the same groff language.  To change this, the
-option parsing must be revised for large parts.  It seems that this
-would create incompatibilities, so the actual option strategy is kept.
-
-
-Output
-
-All input is first sent to 'grog' to determine the necessary 'groff'
-command and then to 'groff' together with all necessary preprocessors.
-So no special 'groff' arguments must be given.  But all 'groff'
-options can be specified when this seems to be appropriate.
-
-The following displaying modes for the output are available:
-- Display formatted input with
--- a PDF viewer,
--- a Postcript viewer,
--- a web browser,
--- the X 'roff' viewer 'gxditview',
--- a DVI viewer,
--- a pager in a text terminal (tty).
-- Generate 'groff' output on stdout without a viewer.
-- Generate the 'groff intermediate output' on standard output without
-  postprocessing.
-- Output the source code without any 'groff' processing.
-- There are some information outputs without 'groff' processing, such
-  as by option '-V' and the 'man' like 'whatis' and 'apropos'
-  outputs.
-
-By default, the program creates a PDF file; on non-X text terminals,
-the 'tty' text mode with a pager is tried by default.
-
-
-File access
-
-The Perl version of groffer now uses a umask of 077.  This is a very
-strict security issue.  It allows only access of the temporary files
-by the file owner.
-
-
-Compatibility
-
-'groffer' is compatible to the 'man' program.  It supports '.so'
-requests based on the man path and compressed files.  That's more than
-'groff' does.
-
-
-Reporting bugs
-
-For reporting bugs of 'groffer', groff's bug-tracking tool at
-http://savannah.gnu.org/bugs/?group=groff can be used.
-
-
-Mailing list
-
-For a general discussion, the mailing list <groff@gnu.org> is
-useful, but one has to subscribe to this list at
-http://lists.gnu.org/mailman/listinfo/groff.
-
-See the 'README' file in the top directory of the 'groff' source
-package for more details on this mailing list.
-
-
-####### License
-
-Copyright (C) 2003-2018 Free Software Foundation, Inc.
-Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-This file is part of 'groffer', 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 2 of the License, or
-(at your option) any later version.
-
-'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 this program.  If not, see
-<http://www.gnu.org/licenses/gpl-2.0.html>.
-
-
-####### Emacs settings
-
-Local Variables:
-mode: text
-End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/README_PERL Deleted

@@ -1,49 +0,0 @@
-README_PERL
-
-'groffer' is written in the programming language Perl.
-
-
-Compatibility
-
-It was written in Linux, but due to Free Software under GNU it is
-available for each operating system.
-
-For testing, 'groffer.pl' may be used directly without a Makefile.  By
-'make', this file will be transformed into the file 'groffer' that will
-be installed.
-
-
-Temporary files
-
-The 'file' and 'so' temporaries are numbered and the files with .so
-request are copied.  All .so requests are handled; this is an
-extension to 'man' that deals only with the first .so request.
-
-
-####### License
-
-Copyright (C) 2003-2018 Free Software Foundation, Inc.
-Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-This file is part of 'groffer', 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 2 of the License, or
-(at your option) any later version.
-
-'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 this program.  If not, see
-<http://www.gnu.org/licenses/gpl-2.0.html>.
-
-
-####### Emacs settings
-
-Local Variables:
-mode: text
-End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/groffer.1.man Deleted

@@ -1,3822 +0,0 @@
-.TH GROFFER @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groffer \- display groff files and man pages on X and tty
-.
-.
-.\"*********************************************************************
-.\"
-.\" This man page doesn't use extended groff syntax!
-.\" XXX: Yes, it does--"\~" is ubiquitous.  "\/" and "\," also occur.
-.\" Formatting it with and without groff's option '-C' should always
-.\" give the same result.
-.\"
-.\"*********************************************************************
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2001-2018 Free Software Foundation, Inc.
-.\"
-.\" This file is part of groffer, which is part of groff, a free
-.\" software project.
-.\"
-.\" You can redistribute it and/or modify it under the terms of the GNU
-.\" General Public License version 2 as published by the Free Software
-.\" Foundation.
-.\"
-.\" The license text is available in the internet at
-.\" <http://www.gnu.org/licenses/gpl-2.0.html>.
-.
-.
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
-.
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
-.
-.\" Bullet
-.ie t .ds BU \(bu
-.el .ds BU *
-.\" used in '.IP \*(BU 2m' (former .Topic)
-.
-.
-.\" ====================================================================
-.SH "SYNOPSIS"
-.\" ====================================================================
-.
-.SY groffer
-.RI  mode-option
-\*(EL
-.RI  groff-option
-\*(EL
-.RI  man-option
-\*(EL
-.RI  X-option
-\*(EL
-.OP \-\-
-.RI  filespec
-\*(EL
-.YS
-.
-.SY groffer
-.B \-h
-.SY groffer
-.B \-\-help
-.YS
-.
-.SY groffer
-.B \-v
-.SY groffer
-.B \-\-version
-.YS
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-The
-.B \%groffer
-program is the easiest way to use
-.BR \%groff (@MAN1EXT@).
-It can display arbitrary documents written in the
-.I \%groff
-language, see
-.BR \%groff (@MAN7EXT@),
-or other
-.I \%roff
-languages, see
-.BR \%roff (@MAN7EXT@),
-that are compatible to the original
-.I \%troff
-language.
-.
-It finds and runs all necessary
-.I groff
-preprocessors, such as
-.BR @g@chem .
-.
-.
-.P
-The
-.B \%groffer
-program also includes many of the features for finding and displaying
-the \%\f(CRUnix\fP manual pages
-.nh
-.RI ( man\~pages ),
-.hy
-such that it can be used as a replacement for a
-.BR \%man (1)
-program.
-.
-Moreover, compressed files that can be handled by
-.BR \%gzip (1)
-or
-.BR \%bzip2 (1)
-are decompressed on-the-fly.
-.
-.
-.P
-The normal usage is quite simple by supplying a file name or name of a
-.I \%man\~page
-without further options.
-.
-But the option handling has many possibilities for creating special
-behaviors.
-.
-This can be done either in configuration files, with the shell
-environment variable
-.IR \%GROFFER_OPT ,
-or on the command line.
-.
-.
-.P
-The output can be generated and viewed in several different ways
-available for
-.IR \%groff .
-.
-This includes the
-X Window System-based
-.I \%groff
-program
-.BR \%gxditview (@MAN1EXT@),
-each
-.IR \%PostScript ,
-.IR \%PDF ,
-or
-.I \%DVI
-display program, a web browser by generating
-.I \%HTML
-or
-.I \%XHTML
-in
-.IR \%www\~mode ,
-or several
-.I \%text\~modes
-in text terminals.
-.
-.
-.P
-Most of the options that must be named when running
-.B \%groff
-directly are determined automatically for
-.BR \%groffer ,
-due to the internal usage of the
-.BR \%grog (@MAN1EXT@)
-program.
-.
-But all parts can also be controlled manually by arguments.
-.
-.
-.P
-Several file names can be specified on the command-line arguments.
-.
-They are transformed into a single document in the normal way of
-.BR \%groff .
-.
-.
-.P
-Option handling is done in \f(CRGNU\fP style.
-.
-Options and file names can be mixed freely.
-.
-The option
-.RB \lq \-\- \rq
-closes the option handling, all following arguments are treated as
-file names.
-.
-Long options can be abbreviated in several ways.
-.
-.
-.\" ====================================================================
-.SH "OPTION OVERVIEW"
-.\" ====================================================================
-.
-.TP
-.I breaking options
-.RS
-.P
-.SY
-.OP \-h\~\fR|\fB\~\-\-help
-.OP \-v\~\fR|\fB\~\-\-version
-.YS
-.RE
-.
-.
-.TP
-.I \%groffer mode options
-.RS
-.P
-.SY
-.OP \-\-auto
-.OP \-\-default
-.OP \-\-default\-modes mode1,mode2,\*(EL
-.OP \-\-dvi
-.OP \-\-groff
-.OP \-\-html
-.OP \-\-latin1
-.OP \-\-mode display_mode
-.OP \-\-pdf
-.OP \-\-pdf2
-.OP \-\-ps
-.OP \-\-source
-.OP \-\-text
-.OP \-\-to\-stdout
-.OP \-\-tty
-.OP \-\-utf8
-.OP \-\-viewer prog
-.OP \-\-www
-.OP \-\-xhtml
-.OP \-\-x\~\fR|\fB\~\-\-X\fP
-.YS
-.RE
-.
-.
-.TP
-.I options related to \%groff
-.RS
-.P
-.SY
-.OP \-T\~\fR|\fB\~\-\-device device
-.OP \-Z\~\fR|\fB\~\-\-intermediate\-output\~\fR|\fB\~\-\-ditroff
-.YS
-.P
-All further
-.B \%groff
-short options are accepted.
-.RE
-.
-.
-.TP
-.I options for man\~pages
-.RS
-.P
-.SY
-.OP \-\-apropos
-.OP \-\-apropos\-data
-.OP \-\-apropos\-devel
-.OP \-\-apropos\-progs
-.OP \-\-man
-.OP \-\-no\-man
-.OP \-\-no\-special
-.OP \-\-whatis
-.YS
-.RE
-.
-.
-.TP
-.I long options taken over from GNU man
-.RS
-.P
-.SY
-.OP \-\-all
-.OP \-\-ascii
-.OP \-\-ditroff
-.OP \-\-extension suffix
-.OP \-\-locale language
-.OP \-\-local\-file
-.OP \-\-location\~\fR|\fB\~\-\-where
-.OP \-\-manpath dir1:dir2:\*(EL
-.OP \-\-no\-location
-.OP \-\-pager program
-.OP \-\-sections sec1:sec2:\*(EL
-.OP \-\-systems sys1,sys2,\*(EL
-.OP \-\-troff\-device device
-.YS
-.P
-Further long options of \f(CRGNU\fP
-.B man
-are accepted as well.
-.RE
-.
-.
-.TP
-.I options mapped to X Window System Toolkit Intrinsics options
-.RS
-.P
-.SY
-.OP \-\-bd\~\fR|\fB\~\-\-bordercolor pixels
-.OP \-\-bg\~\fR|\fB\~\-\-background color
-.OP \-\-bw\~\fR|\fB\~\-\-borderwidth pixels
-.OP \-\-display X-display
-.OP \-\-fg\~\fR|\fB\~\-\-foreground color
-.OP \-\-fn\~\fR|\fB\~\-\-ft\~\fR|\fB\~\-\-font font_name
-.OP \-\-geometry size_pos
-.OP \-\-resolution value
-.OP \-\-rv
-.OP \-\-title string
-.OP \-\-xrm X\-resource
-.YS
-.RE
-.
-.
-.TP
-.I options for development
-.RS
-.P
-.SY
-.OP \-\-debug
-.OP \-\-debug\-filenames
-.OP \-\-debug\-grog
-.OP \-\-debug\-keep
-.OP \-\-debug\-params
-.OP \-\-debug\-tmpdir
-.OP \-\-do\-nothing
-.OP \-\-print text
-.OP \-V
-.YS
-.RE
-.
-.
-.TP
-.I \%filespec arguments
-.RS
-.P
-The
-.I \%filespec
-parameters are all arguments that are neither an option nor an option
-argument.
-.
-They usually mean a file name or a
-.I man page
-searching scheme.
-.
-.
-.P
-In the following, the term
-.I section_extension
-is used.
-.
-It means a word that consists of a
-.I man section
-that is optionally followed by an
-.IR extension .
-.
-The name of a
-.I man section
-is a single character from
-.BR \%1\(en9on ,
-the
-.I extension
-is some word.
-.
-The
-.I extension
-is mostly lacking.
-.
-.
-.P
-No
-.I \%filespec
-parameters means standard input.
-.
-.
-.TP 10m
-.B \-
-stands for standard input (can occur several times).
-.
-.
-.TP
-.I filename
-the path name of an existing file.
-.
-.
-.TP
-.BI man: name ( section_extension )
-.TQ
-.BI man: name . section_extension
-.TQ
-.IB name ( section_extension )
-.TQ
-.IB name . section_extension
-.TQ
-.I "section_extension name"
-search the \%man\~page
-.I \%name
-in the section with optional extension
-.IR section_extension .
-.
-.
-.TP
-.BI man: name
-\%man\~page in the lowest
-.I \%man\~section
-that has
-.IR \%name .
-.
-.
-.TP
-.I name
-if
-.I \%name
-is not an existing file search for the man\~page
-.I \%name
-in the lowest man\~section.
-.
-.RE
-.
-.
-.\" ====================================================================
-.SH "OPTION DETAILS"
-.\" ====================================================================
-.
-The
-.B \%groffer
-program can usually be run with very few options.
-.
-But for special purposes, it supports many options.
-.
-These can be classified in 5 option classes.
-.
-.
-.P
-All short options of
-.B \%groffer
-are compatible with the short options of
-.BR \%groff (@MAN1EXT@).
-.
-All long options of
-.B \%groffer
-are compatible with the long options of
-.BR \%man (1).
-.
-.
-.P
-Arguments for long option names can be abbreviated in several ways.
-.
-First, the argument is checked whether it can be prolonged as is.
-.
-Furthermore, each minus sign
-.B \-
-is considered as a starting point for a new abbreviation.
-.
-This leads to a set of multiple abbreviations for a single argument.
-.
-For example,
-.B \-\-de\-n\-f
-can be used as an abbreviation for
-.BR \-\-debug\-not\-func ,
-but
-.B \-\-de\-n
-works as well.
-.
-If the abbreviation of the argument leads to several resulting options
-an error is raised.
-.
-.
-.P
-These abbreviations are only allowed in the environment variable
-.IR \%GROFFER_OPT ,
-but not in the configuration files.
-.
-In configuration, all long options must be exact.
-.
-.
-.\" ====================================================================
-.SS "groffer breaking Options"
-.\" ====================================================================
-.
-As soon as one of these options is found on the command line it is
-executed, printed to standard output, and the running
-.B \%groffer
-is terminated thereafter.
-.
-All other arguments are ignored.
-.
-.
-.TP
-.B \-h\~\fR|\fB\~\-\-help
-Print help information with a short explanation of options to
-standard output.
-.
-.
-.TP
-.B \-v\~\fR|\fB\~\-\-version
-Print version information to standard output.
-.
-.
-.\" ====================================================================
-.SS "groffer Mode Options"
-.\" ====================================================================
-.
-The display mode and the viewer programs are determined by these
-options.
-.
-If none of these mode and viewer options is specified
-.B \%groffer
-tries to find a suitable display mode automatically.
-.
-The default modes are
-.IR "mode pdf" ,
-.IR "mode ps" ,
-.IR "mode html" ,
-.IR "mode xhtml" ,
-.IR "mode x" ,
-and
-.I "mode dvi"
-in the X Window System with different viewers and
-.I mode tty
-with device
-.I utf8
-under
-.B less
-on a terminal; other modes are tested if the programs for the main
-default mode do not exist.
-.
-.
-.P
-In the X Window System, many programs create their own window when
-called.
-.
-.B \%groffer
-can run these viewers as an independent program in the background.
-.
-As this does not work in text mode on a terminal (tty) there must be a
-way to know which viewers are X Window System-based graphical
-programs.
-.
-The
-.B \%groffer
-script has a small amount of information on some viewer names.
-.
-If a viewer argument of the command\-line chooses an element that is
-recognized as an X Window System-based program in this list, it is
-treated as a viewer that can run in the background.
-.
-Unrecognized viewers are not run in the background.
-.
-.
-.P
-For each mode, you are free to choose whatever viewer you want.
-.
-That need not be some graphical viewer suitable for this mode.
-.
-There is a chance to view the output source; for example, the
-combination of the options
-.B \-\-mode=ps
-and
-.B \-\-viewer=less
-shows the content of the
-.I PostScript
-output, the source code, with the pager
-.BR less .
-.
-.
-.TP
-.B \-\-auto
-Equivalent to
-.BR \-\-mode=auto .
-.
-.
-.TP
-.B \-\-default
-Reset all configuration from previously processed command-line options
-to the default values.
-.
-This is useful to wipe out all former options of the configuration, in
-.IR \%GROFFER_OPT ,
-and restart option processing using only the rest of the command line.
-.
-.
-.TP
-.BI \-\-default\-modes \ mode1,mode2,\*(EL
-Set the sequence of modes for
-.I \%auto\~mode
-to the comma separated list given in the argument.
-.
-See
-.B \-\-mode
-for details on modes.
-Display in the default manner; actually, this means to try the modes
-.IR x ,
-.IR ps ,
-and
-.I \%tty
-in this sequence.
-.
-.
-.
-.TP
-.B \-\-dvi
-Equivalent to
-.BR \-\-mode=\%dvi .
-.
-Known
-.I \%DVI
-viewers for the X Window System include
-.BR \%xdvi (1)
-and
-.BR \%dvilx (1).
-.
-.
-.TP
-.B \-\-groff
-Equivalent to
-.BR \-\-mode=groff .
-.
-.
-.TP
-.B \-\-html
-Equivalent to
-.BR \-\-mode=html .
-.
-.
-.TP
-.BI \-\-mode \ value
-.
-Set the display mode.
-.
-The following mode values are recognized:
-.
-.RS
-.
-.TP
-.B auto
-Select the automatic determination of the display mode.
-.
-The sequence of modes that are tried can be set with the
-.B \-\-default\-modes
-option.
-.
-Useful for restoring the
-.I \%default\~mode
-when a different mode was specified before.
-.
-.
-.TP
-.B dvi
-Display formatted input in a
-.I \%DVI
-viewer program.
-.
-By default, the formatted input is displayed with the
-.BR \%xdvi (1)
-program.
-.
-.
-.TP
-.B groff
-After the file determination, switch
-.B \%groffer
-to process the input like
-.BR \%groff (@MAN1EXT@)
-would do.
-.
-This disables the
-.I \%groffer
-viewing features.
-.
-.
-.TP
-.B html
-Translate the input into HTML format and display the result in a web
-browser program.
-.
-By default, the existence of a sequence of standard web browsers is
-tested, starting with
-.BR \%konqueror (1)
-and
-.BR \%mozilla (1).
-The text HTML viewer is
-.BR \%lynx (1).
-.
-By default, the existence of a sequence of standard web browsers is
-tested, starting with
-.BR \%konqueror (1)
-and
-.BR \%mozilla (1).
-The text HTML viewer is
-.BR \%lynx (1).
-.
-.
-.TP
-.B pdf
-Transform
-.I roff input files
-into a
-.I PDF file
-by using the
-.B groff (@MAN1EXT@)
-device
-.BR -Tpdf .
-.
-This is the default
-.B PDF
-generator.
-.
-The generated
-.I PDF file
-is displayed with suitable viewer programs, such as
-.BR okular (1).
-.
-.
-.TP
-.B pdf2
-This is the traditional
-.IR "pdf mode" .
-.
-Sometimes this mode produces more correct output than the default
-.BR "PDF mode" .
-.
-By default, the input is formatted by
-.B \%groff
-using the PostScript device, then it is transformed into the PDF file
-format using
-.BR \%gs (1),
-or
-.BR ps2pdf (1).
-.
-If that's not possible, the
-.I PostScript mode (ps)
-is used instead.
-.
-Finally it is displayed using different viewer programs.
-.
-.
-.TP
-.B ps
-Display formatted input in a PostScript viewer program.
-.
-By default, the formatted input is displayed in one of many viewer
-programs.
-.
-.
-.TP
-.B text
-Format in a
-.I \%groff\~text\~mode
-and write the result to standard output without a pager or viewer
-program.
-.
-The text device,
-.I \%latin1
-by default, can be chosen with option
-.BR \-T .
-.
-.
-.TP
-.B tty
-Format in a
-.I \%groff\~text\~mode
-and write the result to standard output using a text pager program,
-even when in the X Window System.
-.
-.
-.TP
-.B www
-Equivalent to
-.BR \-\-mode=html .
-.
-.
-.TP
-.B x
-Display the formatted input in a native
-.I roff
-viewer.
-.
-By default, the formatted input is displayed with the
-.BR \%gxditview (@MAN1EXT@)
-program being distributed together with
-.BR \%groff .
-But the legacy X Window System application
-.BR \%xditview (1)
-can also be chosen with the option
-.BR \-\-viewer .
-The default resolution is
-.BR 75dpi ,
-but
-.B 100dpi
-are also possible.
-.
-The default
-.I groff
-device
-for the resolution of
-.B 75dpi
-is
-.BR X75\-12 ,
-for
-.B 100dpi
-it is
-.BR X100 .
-.
-The corresponding
-.I "groff intermediate output"
-for the actual device is generated and the result is displayed.
-.
-For a resolution of
-.BR 100dpi ,
-the default width of the geometry of the display program is chosen to
-.BR 850dpi .
-.
-.
-.TP
-.B X
-Equivalent to
-.BR \-\-mode=x .
-.
-.
-.TP
-.B xhtml
-Translate the input into
-.I XHTML
-format, which is an
-.I XML
-version of
-.IR HTML .
-.
-Then display the result in a web browser program, mostly the known
-.IR "HTML viewers" .
-.
-.
-.P
-The following modes do not use the
-.I \%groffer
-viewing features.
-.
-They are only interesting for advanced applications.
-.
-.
-.TP
-.B groff
-Generate device output with plain
-.I \%groff
-without using the special viewing features of
-.IR \%groffer .
-If no device was specified by option
-.B \-T
-the
-.I \%groff
-default
-.B \%ps
-is assumed.
-.
-.
-.TP
-.B source
-Output the roff source code of the input files without further
-processing.
-.
-.
-.RE
-.
-.
-.TP
-.B \-\-pdf
-Equivalent to
-.BR \-\-mode=pdf .
-.TQ
-.B \-\-pdf2
-Equivalent to
-.BR \-\-mode=pdf2 .
-.
-.
-.TP
-.B \-\-ps
-Equivalent to
-.BR \-\-mode=ps .
-.
-Common PostScript viewers include
-.BR \%okular (1),
-.BR \%evince (1),
-.BR \%gv (1),
-.BR \%ghostview (1),
-and
-.BR \%gs (1),
-.
-In each case, arguments can be provided additionally.
-.
-.
-.TP
-.B \-\-source
-Equivalent to
-.BR \-\-mode=source .
-.
-.
-.TP
-.B \-\-text
-Equivalent to
-.BR \-\-mode=text .
-.
-.
-.TP
-.B \-\-to\-stdout
-The file for the chosen mode is generated and its content is printed
-to standard output.
-.
-It will not be displayed in graphical mode.
-.
-.
-.TP
-.B \-\-tty
-Equivalent to
-.BR \-\-mode=tty .
-The standard pager is
-.BR less (1).
-This option is equivalent to
-.I man
-option
-.BR \-\-pager=\,\fIprog\fP .
-The option argument can be a file name or a program to be searched in
-.IR $PATH ;
-arguments can be provided additionally.
-.
-.
-.TP
-.BI \-\-viewer \ prog
-Choose a viewer program for actual device or mode.
-.
-This can be a file name or a program to be searched in
-.IR $PATH ;
-arguments can be provided additionally.
-.
-.
-.TP
-.B \-\-www
-Equivalent to
-.BR \-\-mode=html .
-.
-.
-.TP
-.B \-\-X\~\fR|\fB\~\-\-x
-Equivalent to
-.BR \-\-mode=x .
-Suitable viewer programs are
-.BR \%gxditview (@MAN1EXT@)
-which is the default and
-.BR \%xditview (1).
-.
-.
-.TP
-.B \-\-
-Signals the end of option processing; all remaining arguments are
-interpreted as
-.I \%filespec
-parameters.
-.
-.
-.P
-Besides these,
-.B \%groffer
-accepts all short options that are valid for the
-.BR \%groff (@MAN1EXT@)
-program.
-.
-All
-.RB \%non- groffer
-options are sent unmodified via
-.B \%grog
-to
-.BR \%groff .
-.
-So postprocessors, macro packages, compatibility with
-.I classical
-.IR \%troff ,
-and much more can be manually specified.
-.
-.
-.\" ====================================================================
-.SS "Options related to groff"
-.\" ====================================================================
-.
-All short options of
-.B \%groffer
-are compatible with the short options of
-.BR \%groff (@MAN1EXT@).
-.
-The following of
-.B \%groff
-options have either an additional special meaning within
-.B \%groffer
-or make sense for normal usage.
-.
-.
-.P
-Because of the special outputting behavior of the
-.B \%groff
-option
-.B \-Z
-.B \%groffer
-was designed to be switched into
-.IR \%groff\~mode ;
-the
-.I \%groffer
-viewing features are disabled there.
-.
-The other
-.B \%groff
-options do not switch the mode, but allow to customize the formatting
-process.
-.
-.
-.TP
-.B \-\-a
-This generates an ASCII approximation of output in the
-.IR \%text\~modes .
-.
-That could be important when the text pager has problems with control
-sequences in
-.IR "tty mode" .
-.
-.
-.TP
-.BI \-\-m \ file
-Add
-.I \%file
-as a
-.I \%groff
-macro file.
-.
-This is useful in case it cannot be recognized automatically.
-.
-.
-.TP
-.BI \-\-P \ opt_or_arg
-Send the argument
-.I \%opt_or_arg
-as an option or option argument to the actual
-.B \%groff
-postprocessor.
-.
-.
-.TP
-.B \-\-T \fIdevname\fR\~\fR|\fB\~\-\-device \fIdevname\fR
-.
-This option determines
-.BR \%groff 's
-output device.
-.
-The most important devices are the text output devices for referring
-to the different character sets, such as
-.BR \%ascii ,
-.BR \%utf8 ,
-.BR \%latin1 ,
-.BR \%utf8 ,
-and others.
-.
-Each of these arguments switches
-.B \%groffer
-into a
-.I \%text\~mode
-using this device, to
-.I \%mode\~tty
-if the actual mode is not a
-.IR \%text\~mode .
-.
-The following
-.I \%devname
-arguments are mapped to the corresponding
-.B \%groffer
-.B \-\-mode=\,\fIdevname\fR
-option:
-.BR \%dvi ,
-.BR \%html ,
-.BR \%xhtml ,
-and
-.BR \%ps .
-All
-.B \%X*
-arguments are mapped to
-.IR \%mode\~x .
-Each other
-.I \%devname
-argument switches to
-.I \%mode\~groff
-using this device.
-.
-.
-.TP
-.B \-\-X
-is equivalent to
-.BR "groff \-X" .
-It displays the
-.I groff intermediate output
-with
-.BR gxditview .
-As the quality is relatively bad this option is deprecated; use
-.B \-\-X
-instead because the
-.I \%x\~mode
-uses an
-.IR X *
-device for a better display.
-.
-.
-.TP
-.B \-Z\~\fR|\fB\~\-\-intermediate-output\~\fR|\fB\~\-\-ditroff
-Switch into
-.I \%groff\~mode
-and format the input with the
-.I \%groff intermediate output
-without postprocessing; see
-.BR \%groff_out (@MAN5EXT@).
-This is equivalent to option
-.B \-\-ditroff
-of
-.IR \%man ,
-which can be used as well.
-.
-.
-.P
-All other
-.B \%groff
-options are supported by
-.BR \%groffer ,
-but they are just transparently transferred to
-.B \%groff
-without any intervention.
-.
-The options that are not explicitly handled by
-.B \%groffer
-are transparently passed to
-.BR \%groff .
-.
-Therefore these transparent options are not documented here, but in
-.BR \%groff (@MAN1EXT@).
-Due to the automatism in
-.BR \%groffer ,
-none of these
-.B \%groff
-options should be needed, except for advanced usage.
-.
-.
-.\" ====================================================================
-.SS "Options for man\~pages"
-.\" ====================================================================
-.
-.TP
-.B \-\-apropos
-Start the
-.BR \%apropos (1)
-command or facility of
-.BR \%man (1)
-for searching the
-.I \%filespec
-arguments within all
-.I \%man\~page
-descriptions.
-.
-Each
-.I \%filespec
-argument is taken for search as it is;
-.I section
-specific parts are not handled, such that
-.B 7 groff
-searches for the two arguments
-.B 7
-and
-.BR groff ,
-with a large result; for the
-.I \%filespec
-.B groff.7
-nothing will be found.
-.
-The
-.I language
-locale is handled only when the called programs do support this; the
-GNU
-.B apropos
-and
-.B man \-k
-do not.
-.
-The display differs from the
-.B \%apropos
-program by the following concepts:
-.RS
-.IP \*(BU 2m
-Construct a
-.I \%groff
-frame similar to a
-.I \%man\~page
-to the output of
-.BR \%apropos ,
-.IP \*(BU 2m
-each
-.I \%filespec
-argument is searched on its own.
-.IP \*(BU 2m
-The restriction by
-.B \-\-sections
-is handled as well,
-.IP \*(BU 2m
-wildcard characters are allowed and handled without a further option.
-.RE
-.
-.
-.TP
-.B \-\-apropos\-data
-Show only the
-.B \%apropos
-descriptions for data documents, these are the
-.BR \%man (7)
-.IR sections\~4 ", " 5 ", and " 7 .
-.
-Direct
-.I section
-declarations are ignored, wildcards are accepted.
-.
-.
-.TP
-.B \-\-apropos\-devel
-Show only the
-.B \%apropos
-descriptions for development documents, these are the
-.BR man (7)
-.IR sections\~2 ", " 3 ", and " 9 .
-.
-Direct
-.I section
-declarations are ignored, wildcards are accepted.
-.
-.
-.TP
-.B \-\-apropos\-progs
-Show only the
-.B \%apropos
-descriptions for documents on programs, these are the
-.BR \%man (7)
-.IR sections\~1 ", " 6 ", and " 8 .
-.
-Direct
-.I section
-declarations are ignored, wildcards are accepted.
-.
-.
-.TP
-.B \-\-whatis
-For each
-.I \%filespec
-argument search all
-.I \%man\~pages
-and display their description \(em or say that it is not a
-.IR \%man\~page .
-This is written from anew, so it differs from
-.IR man 's
-.B whatis
-output by the following concepts
-.RS
-.IP \*(BU 2m
-each retrieved file name is added,
-.IP \*(BU 2m
-local files are handled as well,
-.IP \*(BU 2m
-the \fIlanguage\fP and \fIsystem\fP locale is supported,
-.IP \*(BU 2m
-the display is framed by a
-.I groff
-output format similar to a
-.IR \%man\~page ,
-.IP \*(BU 2m
-wildcard characters are allowed without a further option.
-.RE
-.
-.
-.P
-The following options were added to
-.B \%groffer
-for choosing whether the file name arguments are interpreted as names
-for local files or as a search pattern for
-.IR \%man\~pages .
-.
-The default is looking up for local files.
-.
-.
-.TP
-.B \-\-man
-Check the non-option command-line arguments
-.nh
-.RI ( filespecs )
-.hy
-first on being
-.IR \%man\~pages ,
-then whether they represent an existing file.
-.
-By default, a
-.I \%filespec
-is first tested whether it is an existing file.
-.
-.
-.TP
-.B \-\-no-man\~\fR|\fB\~\-\-local-file
-Do not check for
-.IR \%man\~pages .
-.
-.B \-\-local-file
-is the corresponding
-.B man
-option.
-.
-.
-.TP
-.B \-\-no-special
-Disable former calls of
-.BR \-\-all ,
-.BR \-\-apropos* ,
-and
-.BR \-\-whatis .
-.
-.
-.\" ====================================================================
-.SS "Long options taken over from GNU man"
-.\" ====================================================================
-.
-The long options of
-.B \%groffer
-were synchronized with the long options of \f(CRGNU\fP
-.BR man .
-.
-All long options of \f(CRGNU\fP
-.B man
-are recognized, but not all of these options are important to
-.BR \%groffer ,
-so most of them are just ignored.
-.
-These ignored
-.B man
-options are
-.BR \-\-catman ,
-.BR \-\-troff ,
-and
-.BR \-\-update .
-.
-.
-.P
-In the following, the
-.B man
-options that have a special meaning for
-.B \%groffer
-are documented.
-.
-.
-.P
-If your system has \f(CRGNU\fP
-.B man
-installed the full set of long and short options of the \f(CRGNU\fP
-.B man
-program can be passed via the environment variable
-.IR MANOPT ;
-see
-.BR \%man (1).
-.
-.
-.TP
-.B \-\-all
-In searching
-.IR \%man\~pages ,
-retrieve all suitable documents instead of only one.
-.
-.
-.TP
-.B \-7\~\fR|\fB\~\-\-ascii
-In
-.IR \%text\~modes ,
-display ASCII translation of special characters for critical environment.
-.
-This is equivalent to
-.BR "groff \%\-mtty_char" ;
-see
-.BR groff_tmac (@MAN5EXT@).
-.
-.
-.TP
-.B \-\-ditroff
-Produce
-.IR "groff intermediate output" .
-This is equivalent to
-.B \%groffer
-.BR \-Z .
-.
-.
-.TP
-.BI \-\-extension \ suffix
-Restrict
-.I \%man\~page
-search to file names that have
-.I \%suffix
-appended to their section element.
-.
-For example, in the file name
-.I \%/usr/share/man/man3/terminfo.3ncurses.gz
-the
-.I \%man\~page
-extension is
-.IR \%ncurses .
-.
-.
-.TP
-.BI \-\-locale \ language
-.
-Set the language for
-.IR \%man\~pages .
-.
-This has the same effect, but overwrites
-.IR $LANG .
-.
-.
-.TP
-.B \-\-location
-Print the location of the retrieved files to standard error.
-.
-.
-.TP
-.B \-\-no-location
-Do not display the location of retrieved files; this resets a former
-call to
-.BR \-\-location .
-.
-This was added by
-.BR \%groffer .
-.
-.
-.TP
-.BI \-\-manpath \ 'dir1:dir2:\*(EL'
-Use the specified search path for retrieving
-.I \%man\~pages
-instead of the program defaults.
-.
-If the argument is set to the empty string "" the search for
-.I \%man\~page
-is disabled.
-.
-.
-.TP
-.B \-\-pager
-Set the pager program in
-.IR \%tty\~mode ;
-default is
-.BR \%less .
-.
-This can be set with
-.BR \-\-viewer .
-.
-.
-.TP
-.BI \-\-sections \ sec1:sec2:\*(EL
-Restrict searching for
-.I \%man\~pages
-to the given
-.IR sections ,
-a colon-separated list.
-.
-.
-.TP
-.BI \-\-systems \ sys1,sys2,\*(EL
-Search for
-.I \%man\~pages
-for the given operating systems; the argument
-.I \%systems
-is a comma-separated list.
-.
-.
-.TP
-.B \-\-where
-Equivalent to
-.BR \-\-location .
-.
-.
-.\" ====================================================================
-.SS "X Window System Toolkit Intrinsics Options"
-.\" ====================================================================
-.
-The following long options were adapted from the corresponding
-X Window System Toolkit Intrinsics options.
-.
-.B \%groffer
-will pass them to the actual viewer program if it is an
-X Window System program.
-.
-Otherwise these options are ignored.
-.
-.
-.P
-Unfortunately these options use the old style of a single minus for
-long options.
-.
-For
-.B \%groffer
-that was changed to the standard with using a double minus for long
-options, for example,
-.B \%groffer
-uses the option
-.B \-\-font
-for the X Window System Toolkit Intrinsics option
-.BR \-font .
-.
-.
-.P
-See
-.BR X (7)
-and the manual
-.I "X Toolkit Intrinsics \(en C Language Interface"
-for more details on these options and their arguments.
-.
-.
-.TP
-.BI \-\-background \ color
-Set the background color of the viewer window.
-.
-.
-.TP
-.BI \-\-bd \ pixels
-This is equivalent to
-.BR \-\-bordercolor .
-.
-.
-.TP
-.BI \-\-bg \ color
-This is equivalent to
-.BR \-\-background .
-.
-.
-.TP
-.BI \-\-bw \ pixels
-This is equivalent to
-.BR \-\-borderwidth .
-.
-.
-.TP
-.BI \-\-bordercolor \ pixels
-Specifies the color of the border surrounding the viewer window.
-.
-.
-.TP
-.BI \-\-borderwidth \ pixels
-Specifies the width in pixels of the border surrounding the viewer
-window.
-.
-.
-.TP
-.BI \-\-display \ X-display
-Set the X Window System display on which the viewer program
-shall be started.
-.
-See section \(lqDisplay Names\(rq in
-.BR X (7)
-for the syntax of the argument.
-.
-.
-.TP
-.BI \-\-foreground \ color
-Set the foreground color of the viewer window.
-.
-.
-.TP
-.BI \-\-fg \ color
-This is equivalent to
-.BR \-\-foreground .
-.
-.
-.TP
-.BI \-\-fn \ font_name
-This is equivalent to
-.BR \-\-font .
-.
-.
-.TP
-.BI \-\-font \ font_name
-Set the font used by the viewer window.
-.
-The argument is an X Window System font name.
-.
-.
-.TP
-.BI \-\-ft \ font_name
-This is equivalent to
-.BR \-\-font .
-.
-.
-.TP
-.BI \-\-geometry \ size_pos
-Set the geometry of the display window, that means its size and its
-starting position.
-.
-See section \(lqGeometry Specifications\(rq in
-.BR X (7)
-for the syntax of the argument.
-.
-.
-.TP
-.BI \-\-resolution \ value
-Set X Window System resolution in dpi (dots per inch) in some
-viewer programs.
-.
-The only supported dpi values are
-.B 75
-and
-.BR 100 .
-.
-Actually, the default resolution for
-.B \%groffer
-is set to
-.BR 75dpi .
-The resolution also sets the default device in
-.IR "mode x" .
-.
-.
-.TP
-.B \-\-rv
-Reverse foreground and background color of the viewer window.
-.
-.
-.TP
-.BI \-\-title "\ 'some text'"
-Set the title for the viewer window.
-.
-.
-.TP
-.BI \-\-xrm \ 'resource'
-Set the X Window System server resource to the given value.
-.
-.
-.\" ====================================================================
-.SS "Options for Development"
-.\" ====================================================================
-.
-.TP
-.B \-\-debug
-Enable all debugging options
-.BR \-\-debug\-\,\fItype\fP .
-.
-The temporary files are kept and not deleted, the
-.B grog
-output is printed, the name of the temporary directory is printed, the
-displayed file names are printed, and the parameters are printed.
-.
-.
-.TP
-.B \-\-debug\-filenames
-Print the names of the files and
-.I \%man\~pages
-that are displayed by
-.BR \&groffer .
-.
-.
-.TP
-.B \-\-debug\-grog
-Print the output of all
-.B grog
-commands.
-.
-.
-.TP
-.B \-\-debug\-keep
-Enable two debugging informations.
-.
-Print the name of the temporary directory and keep the temporary
-files, do not delete them during the run of
-.BR \%groffer .
-.
-.
-.TP
-.B \-\-debug\-params
-Print the parameters, as obtained from the configuration files, from
-.IR \%GROFFER_OPT ,
-and the command-line arguments.
-.
-.
-.TP
-.B \-\-debug\-tmpdir
-Print the name of the temporary directory.
-.
-.
-.TP
-.B \-\-do-nothing
-This is like
-.BR \-\-version ,
-but without the output; no viewer is started.
-.
-This makes only sense in development.
-.
-.
-.TP
-.B \-\-print=\,\fItext\fR
-Just print the argument to standard error.
-.
-This is good for parameter check.
-.
-.
-.TP
-.B \-V
-This is an advanced option for debugging only.
-.
-Instead of displaying the formatted input, a lot of
-.I \%groffer
-specific information is printed to standard output:
-.
-.RS
-.IP \*(BU 2m
-the output file name in the temporary directory,
-.
-.IP \*(BU 2m
-the display mode of the actual
-.B \%groffer
-run,
-.
-.IP \*(BU 2m
-the display program for viewing the output with its arguments,
-.
-.IP \*(BU 2m
-the active parameters from the config files, the arguments in
-.IR \%GROFFER_OPT ,
-and the arguments of the command line,
-.
-.IP \*(BU 2m
-the pipeline that would be run by the
-.B \%groff
-program, but without executing it.
-.RE
-.
-.
-.P
-Other useful debugging options are the
-.B \%groff
-option
-.B \-Z
-and
-.BR \-\-mode=groff .
-.
-.
-.\" ====================================================================
-.SS "Filespec Arguments"
-.\" ====================================================================
-.
-A
-.I \%filespec
-parameter is an argument that is not an option or option argument.
-.
-In
-.BR \%groffer ,
-.I \%filespec
-parameters are a file name or a template for searching
-.IR \%man\~pages .
-.
-These input sources are collected and composed into a single output
-file such as
-.B \%groff
-does.
-.
-.
-.P
-The strange \%\f(CRPOSIX\fP behavior to regard all arguments behind
-the first non-option argument as
-.I \%filespec
-arguments is ignored.
-.
-The \f(CRGNU\fP behavior to recognize options even when mixed with
-.I \%filespec
-arguments is used throughout.
-.
-But, as usual, the double minus argument
-.B \-\-
-ends the option handling and interprets all following arguments as
-.I \%filespec
-arguments; so the \%\f(CRPOSIX\fP behavior can be easily adopted.
-.
-.
-.P
-The options
-.B \-\-apropos*
-have a special handling of
-.I filespec
-arguments.
-.
-Each argument is taken as a search scheme of its own.
-.
-Also a regexp (regular expression) can be used in the filespec.
-.
-For example,
-.B groffer \-\-apropos '^gro.f$'
-searches
-.B groff
-in the
-.I man\~page
-name, while
-.B groffer \-\-apropos groff
-searches
-.B groff
-somewhere in the name or description of the
-.IR man\~pages .
-.
-.
-.P
-All other parts of
-.IR groffer ,
-such as the normal display or the output with
-.B \-\-whatis
-have a different scheme for
-.IR filespecs .
-No regular expressions are used for the arguments.
-.
-The
-.I filespec
-arguments are handled by the following scheme.
-.
-.
-.P
-It is necessary to know that on each system the
-.I \%man\~pages
-are sorted according to their content into several sections.
-.
-The
-.I classical man sections
-have a single-character name, either a digit from
-.B 1
-to
-.B 9
-or one of the characters
-.B n
-or
-.BR o .
-.
-.
-.P
-This can optionally be followed by a string, the so-called
-.IR extension .
-The
-.I extension
-allows the storage of several
-.I man\~pages
-with the same name in the same
-.IR section .
-But the
-.I extension
-is only rarely used; usually it is omitted.
-.
-Then the
-.I extensions
-are searched automatically by alphabet.
-.
-.
-.P
-In the following, we use the name
-.I section_extension
-for a word that consists of a single character
-.I section
-name or a
-.I section
-character that is followed by an
-.IR extension .
-.
-Each
-.I \%filespec
-parameter can have one of the following forms in decreasing sequence.
-.
-.
-.IP \*(BU 2m
-No
-.I \%filespec
-parameters means that
-.B \%groffer
-waits for standard input.
-.
-The minus option
-.B \-
-always stands for standard input; it can occur several times.
-.
-If you want to look up a
-.I \%man\~page
-called
-.B \-
-use the argument
-.BR man:\- .
-.
-.
-.IP \*(BU 2m
-Next a
-.I \%filespec
-is tested whether it is the path name of an existing file.
-.
-Otherwise it is assumed to be a searching pattern for a
-.IR \%man\~page .
-.
-.
-.IP \*(BU 2m
-.BI \%man: name ( section_extension ) ,
-.BI \%man: name . section_extension,
-.IB \%name ( section_extension ) ,
-or
-.IB \%name . section_extension
-search the \%man\~page
-.I \%name
-in \%man\~section and possibly extension of
-.IR \%section_extension .
-.
-.
-.IP \*(BU 2m
-Now
-.BI \%man: name
-searches for a
-.I \%man\~page
-in the lowest
-.I \%man\~section
-that has a document called
-.IR \%name .
-.
-.
-.IP \*(BU 2m
-.I \%section_extension\~name
-is a pattern of 2 arguments that originates from a strange argument
-parsing of the
-.B man
-program.
-.
-Again, this searches the man page
-.I name
-with
-.IR \%section_extension ,
-a combination of a
-.I section
-character optionally followed by an
-.IR extension .
-.
-.
-.IP \*(BU 2m
-We are left with the argument
-.I \%name
-which is not an existing file.
-.
-So this searches for the
-.I \%man\~page
-called
-.I \%name
-in the lowest
-.I \%man\~section
-that has a document for this name.
-.
-.
-.P
-Several file name arguments can be supplied.
-.
-They are mixed by
-.B \%groff
-into a single document.
-.
-Note that the set of option arguments must fit to all of these file
-arguments.
-.
-So they should have at least the same style of the
-.I \%groff
-language.
-.
-.
-.\" ====================================================================
-.SH "OUTPUT MODES"
-.\" ====================================================================
-.
-By default, the
-.B \%groffer
-program collects all input into a single file, formats it with the
-.B \%groff
-program for a certain device, and then chooses a suitable viewer
-program.
-.
-The device and viewer process in
-.B \%groffer
-is called a
-.IR \%mode .
-.
-The mode and viewer of a running
-.B \%groffer
-program is selected automatically, but the user can also choose it
-with options.
-.
-.
-The modes are selected by option the arguments of
-.BR \-\-mode=\,\fIanymode .
-Additionally, each of this argument can be specified as an option of
-its own, such as
-.BR anymode .
-Most of these modes have a viewer program, which can be chosen by the
-option
-.BR \-\-viewer .
-.
-.
-.P
-Several different modes are offered: graphical modes for
-the X Window System,
-.IR \%text\~modes ,
-and some direct
-.I \%groff\~modes
-for debugging and development.
-.
-.
-.P
-By default,
-.B \%groffer
-first tries whether
-.I \%x\~mode
-is possible, then
-.IR \%ps\~mode ,
-and finally
-.IR \%tty\~mode .
-.
-This mode testing sequence for
-.I \%auto\~mode
-can be changed by specifying a comma separated list of modes with the
-option
-.B \-\-default\-modes.
-.
-.
-.P
-The searching for
-.I \%man\~pages
-and the decompression of the input are active in every mode.
-.
-.
-.\" ====================================================================
-.SS "Graphical Display Modes"
-.\" ====================================================================
-.
-The graphical display modes work mostly in the X Window System
-environment (or similar implementations within other windowing
-environments).
-.
-The environment variable
-.I \%DISPLAY
-and the option
-.B \-\-display
-are used for specifying the X Window System display to be used.
-.
-If this environment variable is empty,
-.B \%groffer
-assumes that the X Window System is not running and changes to a
-.IR \%text\~mode .
-.
-You can change this automatic behavior by the option
-.BR \-\-default\-modes .
-.
-.
-.P
-Known viewers for the graphical display modes and their standard
-X Window System viewer programs are
-.
-.IP \*(BU 2m
-in a PDF viewer
-.nh
-.RI ( \%pdf\~mode )
-.hy
-.
-.IP \*(BU 2m
-in a web browser
-.nh
-.RI ( html ,
-.RI ( xhtml ,
-or
-.IR \%www\~mode )
-.hy
-.RE
-.
-.IP \*(BU 2m
-in a PostScript viewer
-.nh
-.RI ( \%ps\~mode )
-.hy
-.
-.IP \*(BU 2m
-X Window System
-.I roff
-viewers such as
-.BR \%gxditview (@MAN1EXT@)
-or
-.BR \%xditview (1)
-(in
-.IR \%x\~mode )
-.
-.IP \*(BU 2m
-in a DVI viewer program
-.nh
-.RI ( \%dvi\~mode )
-.hy
-.
-.
-.P
-The
-.I \%pdf\~mode
-has a major advantage \(em it is the only graphical display mode that
-allows searching for text within the viewer; this can be a really
-important feature.
-.
-Unfortunately, it takes some time to transform the input into the PDF
-format, so it was not chosen as the major mode.
-.
-.
-.P
-These graphical viewers can be customized by options of the
-X Window System Toolkit Intrinsics.
-.
-But the
-.B \%groffer
-options use a leading double minus instead of the single minus used by
-the X Window System Toolkit Intrinsics.
-.
-.
-.\" ====================================================================
-.SS "Text modes"
-.\" ====================================================================
-.
-There are two modes for text output,
-.I \%mode\~text
-for plain output without a pager and
-.I \%mode\~tty
-for a text output on a text terminal using some pager program.
-.
-.
-.P
-If the variable
-.I \%DISPLAY
-is not set or empty,
-.B \%groffer
-assumes that it should use
-.IR \%tty\~\%mode .
-.
-.
-.P
-In the actual implementation, the
-.I groff
-output device
-.I \%latin1
-is chosen for
-.IR \%text\~modes .
-.
-This can be changed by specifying option
-.B \-T
-or
-.BR \%\-\-device .
-.
-.
-.P
-The pager to be used can be specified by one of the options
-.B \-\-pager
-and
-.BR \-\-viewer ,
-or by the environment variable
-.IR PAGER .
-If all of this is not used the
-.BR \%less (1)
-program with the option
-.B \-r
-for correctly displaying control sequences is used as the default
-pager.
-.
-.
-.\" ====================================================================
-.SS "Special Modes for Debugging and Development"
-.\" ====================================================================
-.
-These modes use the
-.I \%groffer
-file determination and decompression.
-.
-This is combined into a single input file that is fed directly into
-.B \%groff
-with different strategy without the
-.I \%groffer
-viewing facilities.
-.
-These modes are regarded as advanced, they are useful for debugging
-and development purposes.
-.
-.
-.P
-The
-.I \%source\~mode
-with option
-.B \-\-source
-just displays the decompressed input.
-.
-.
-.P
-Option
-.B \-\-to\-stdout
-does not display in a graphical mode.
-.
-It just generates the file for the chosen mode and then prints its
-content to standard output.
-.
-.
-.P
-The
-.I \%groff\~mode
-passes the input to
-.B \%groff
-using only some suitable options provided to
-.BR \%groffer .
-.
-This enables the user to save the generated output into a file or pipe
-it into another program.
-.
-.
-.P
-In
-.IR \%groff\~\%mode ,
-the option
-.B \-Z
-disables post-processing, thus producing the
-.nh
-.I groff intermediate
-.IR output .
-.hy
-.
-In this mode, the input is formatted, but not postprocessed; see
-.BR \%groff_out (@MAN5EXT@)
-for details.
-.
-.
-.P
-All
-.B \%groff
-short options are supported by
-.BR \%groffer .
-.
-.
-.\" ====================================================================
-.SH "MAN PAGE SEARCHING"
-.\" ====================================================================
-.
-The default behavior of
-.B \%groffer
-is to first test whether a file parameter represents a local file; if
-it is not an existing file name, it is assumed to represent the name
-of a
-.IR \%man\~page .
-The following options can be used to determine whether the arguments
-should be handled as file name or
-.I \%man\~page
-arguments.
-.
-.TP
-.B \-\-man
-forces to interpret all file parameters as
-.I \%filespecs
-for searching
-.IR \%man\~pages .
-.
-.TP
-.B \-\-no\-man
-.TQ
-.B \-\-local\-file
-disable the
-.I man
-searching; so only local files are displayed.
-.
-.
-.P
-If neither a local file nor a
-.I \%man\~page
-was retrieved for some file parameter a warning is issued on standard
-error, but processing is continued.
-.
-.
-.\" ====================================================================
-.SS "Search Algorithm"
-.\" ====================================================================
-.
-Let us now assume that a
-.I \%man\~page
-should be searched.
-.
-The
-.B \%groffer
-program provides a search facility for
-.IR \%man\~pages .
-.
-All long options, all environment variables, and most of the
-functionality of the \f(CRGNU\fP
-.BR \%man (1)
-program were implemented.
-.
-The search algorithm shall determine which file is displayed for a given
-.IR \%man\~page .
-The process can be modified by options and environment variables.
-.
-.
-.P
-The only
-.I man
-action that is omitted in
-.B \%groffer
-are the preformatted
-.IR \%man\~pages ,
-also called
-.IR cat\~pages .
-.
-With the excellent performance of the actual computers, the
-preformatted
-.I \%man\~pages
-aren't necessary any longer.
-.
-Additionally,
-.B \%groffer
-is a
-.I roff
-program; it wants to read
-.I roff
-source files and format them itself.
-.
-.
-.P
-The algorithm for retrieving the file for a
-.I \%man\~page
-needs first a set of directories.
-.
-This set starts with the so-called
-.I man\~path
-that is modified later on by adding names of
-.I operating system
-and
-.IR language .
-.
-This arising set is used for adding the section directories which
-contain the
-.I \%man\~page
-files.
-.
-.
-.P
-The
-.I man\~path
-is a list of directories that are separated by colon.
-.
-It is generated by the following methods.
-.
-.IP \*(BU 2m
-The environment variable
-.I \%MANPATH
-can be set.
-.
-.IP \*(BU 2m
-It can be read from the arguments of the environment variable
-.IR MANOPT .
-.
-.IP \*(BU 2m
-The
-.I man\~path
-can be manually specified by using the option
-.BR \-\-manpath .
-An empty argument disables the
-.I \%man\~page
-searching.
-.
-.IP \*(BU 2m
-When no
-.I man\~path
-was set the
-.BR \%manpath (1)
-program is tried to determine one.
-.
-.IP \*(BU 2m
-If this does not work a reasonable default path from
-.I $PATH
-is determined.
-.
-.
-.P
-We now have a starting set of directories.
-.
-The first way to change this set is by adding names of
-.I operating
-.IR systems .
-.
-This assumes that
-.I \%man\~pages
-for several
-.I operating systems
-are installed.
-.
-This is not always true.
-.
-The names of such
-.I operating systems
-can be provided by 3 methods.
-.
-.IP \*(BU 2m
-The environment variable
-.I \%SYSTEM
-has the lowest precedence.
-.
-.IP \*(BU 2m
-This can be overridden by an option in
-.IR MANOPT .
-.
-.IP \*(BU 2m
-This again is overridden by the command-line option
-.BR \-\-systems .
-.
-.
-.P
-Several names of
-.I operating systems
-can be given by appending their names, separated by a comma.
-.
-.
-.P
-The
-.I man\~path
-is changed by appending each
-.I system
-name as subdirectory at the end of each directory of the set.
-.
-No directory of the
-.I man\~path
-set is kept.
-.
-But if no
-.I system
-name is specified the
-.I man\~path
-is left unchanged.
-.
-.
-.P
-After this, the actual set of directories can be changed by
-.I language
-information.
-.
-This assumes that there exist
-.I man\~pages
-in different languages.
-.
-The wanted
-.I language
-can be chosen by several methods.
-.
-.IP \*(BU 2m
-Environment variable
-.IR LANG .
-.
-.IP \*(BU 2m
-This is overridden by
-.IR \%LC_MESSAGES .
-.
-.IP \*(BU 2m
-This is overridden by
-.IR LC_ALL .
-.
-.IP \*(BU 2m
-This can be overridden by providing an option in
-.IR MANOPT .
-.
-.IP \*(BU 2m
-All these environment variables are overridden by the command-line
-option
-.BR \-\-locale .
-.
-.
-.P
-The
-.I default language
-can be specified by specifying one of the pseudo-language parameters
-\f(CRC\fP or \f(CR\%POSIX\fP.
-.
-This is like deleting a formerly given
-.I language
-information.
-.
-The
-.I \%man\~pages
-in the
-.I default language
-are usually in English.
-.
-.
-.P
-Of course, the
-.I language
-name is determined by
-.BR man .
-In \f(CRGNU\fP
-.BR man ,
-it is specified in the \%\f(CRPOSIX\~1003.1\fP based format:
-.P
-.nh
-\fI<language>\/\fP\f(CB_\fP\,\fI<territory>\/\fP\f(CB.\fP\
-\fI<character-set>\/\fP\f(CB,\fP\,\fI<version>\/\fP,
-.hy
-.P
-but the two-letter code in
-.nh
-.I <language>
-.hy
-is sufficient for most purposes.
-.
-If for a complicated
-.I language
-formulation no
-.I \%man\~pages
-are found
-.B \%groffer
-searches the country part consisting of these first two characters as
-well.
-.
-.
-.P
-The actual directory set is copied thrice.
-.
-The
-.I language
-name is appended as subdirectory to each directory in the first copy
-of the actual directory set (this is only done when a language
-information is given).
-.
-Then the 2-letter abbreviation of the
-.I language
-name is appended as subdirectories to the second copy of the directory
-set (this is only done when the given language name has more than 2
-letters).
-.
-The third copy of the directory set is kept unchanged (if no
-.I language
-information is given this is the kept directory set).
-.
-These maximally 3 copies are appended to get the new directory set.
-.
-.
-.P
-We now have a complete set of directories to work with.
-.
-In each of these directories, the
-.I man
-files are separated in
-.IR sections .
-.
-The name of a
-.I section
-is represented by a single character, a digit between
-.I 1
-and
-.IR 9 ,
-or the character
-.I o
-or
-.IR n ,
-in this order.
-.
-.
-.P
-For each available
-.IR section ,
-a subdirectory
-.BI man <section>
-exists containing all
-.I man
-files for this
-.IR section ,
-where
-.I <section>
-is a single character as described before.
-.
-Each
-.I man
-file in a
-.I section
-directory has the form
-.IR \%\f(CBman\fP<section>\f(CB/\fP<name>\f(CB.\fP<section>\
-<extension>\f(CB.\fP<compression> ,
-where
-.I \%<extension>
-and
-.I \%<compression>
-are optional.
-.
-.I \%<name>
-is the name of the
-.I \%man\~page
-that is also specified as filespec argument on the command line.
-.
-.
-.P
-The
-.I extension
-is an addition to the section.
-.
-This postfix acts like a subsection.
-.
-An
-.I extension
-occurs only in the file name, not in name of the
-.I section
-subdirectory.
-.
-It can be specified on the command line.
-.
-.
-.P
-On the other hand, the
-.I compression
-is just an information on how the file is compressed.
-.
-This is not important for the user, such that it cannot be specified
-on the command line.
-.
-.
-.P
-There are 4 methods to specify a
-.I section
-on the command line:
-.
-.IP \*(BU 2m
-Environment variable
-.I \%MANSECT
-.
-.IP \*(BU 2m
-Command line option
-.B \-\-sections
-.
-.IP \*(BU 2m
-Appendix to the
-.I name
-argument in the form
-.I <name>.<section>
-.
-.IP \*(BU 2m
-Preargument before the
-.I name
-argument in the form
-.I <section> <name>
-.
-.
-.P
-It is also possible to specify several
-.I sections
-by appending the single characters separated by colons.
-.
-One can imagine that this means to restrict the
-.I \%man\~page
-search to only some
-.IR sections .
-.
-The multiple
-.I sections
-are only possible for
-.I \%MANSECT
-and
-.BR \-\-sections .
-.
-.
-.P
-If no
-.I section
-is specified all
-.I sections
-are searched one after the other in the given order, starting with
-.IR section\~1 ,
-until a suitable file is found.
-.
-.
-.P
-There are 4 methods to specify an
-.I extension
-on the command line.
-.
-But it is not necessary to provide the whole extension name, some
-abbreviation is good enough in most cases.
-.
-.IP \*(BU 2m
-Environment variable
-.I \%EXTENSION
-.
-.IP \*(BU 2m
-Command line option
-.B \-\-extension
-.
-.IP \*(BU 2m
-Appendix to the
-.I <name>.<section>
-argument in the form
-.I <name>.<section><extension>
-.
-.IP \*(BU 2m
-Preargument before the
-.I name
-argument in the form
-.I <section><extension> <name>
-.
-.
-.P
-For further details on
-.I \%man\~page
-searching, see
-.BR \%man (1).
-.
-.
-.\" ====================================================================
-.SS "Examples of man files"
-.\" ====================================================================
-.
-.TP
-.B /usr/share/man/man1/groff.1
-This is an uncompressed file for the
-.I \%man\~page
-\f(CRgroff\fP in
-.IR section\~1 .
-.
-It can be called by
-.EX
-\fIsh#\fR groffer\~groff
-.EE
-No
-.I section
-is specified here, so all
-.I sections
-should be searched, but as
-.I section\~1
-is searched first this file will be found first.
-.
-The file name is composed of the following components.
-.B /usr/share/man/
-must be part of the
-.IR \%man\~path ;
-the subdirectory
-.B man1/
-and the part
-.B .1
-stand for the
-.IR section ;
-.B groff
-is the name of the
-.IR \%man\~page .
-.
-.
-.TP
-.B /usr/local/share/man/man7/groff.7.gz
-The file name is composed of the following components.
-.B /usr/local/share/man
-must be part of the
-.IR \%man\~path ;
-the subdirectory
-.B man7/
-and the part
-.B .7
-stand for the
-.IR section ;
-.B groff
-is the name of the
-.IR \%man\~page ;
-the final part
-.B .gz
-stands for a compression with
-.BR gzip (1).
-As the
-.I section
-is not the first one it must be specified as well.
-.
-This can be done by one of the following commands.
-.EX
-\fIsh#\fR\~groffer\~groff.7
-\fIsh#\fR\~groffer\~7\~groff
-\fIsh#\fR\~groffer\~\-\-sections=7\~groff
-.EE
-.
-.TP
-.B /usr/local/man/man1/ctags.1emacs21.bz2
-Here
-.B /usr/local/man
-must be in
-.IR \%man\~path ;
-the subdirectory
-.B man1/
-and the file name part
-.B .1
-stand for
-.IR section\~1 ;
-the name of the
-.I \%man\~page
-is
-.BR ctags ;
-the section has an extension
-.BR emacs21 ;
-and the file is compressed as
-.B .bz2
-with
-.BR bzip2 (1).
-The file can be viewed with one of the following commands
-.EX
-\fIsh#\fR\~groffer\~ctags.1e
-\fIsh#\fR\~groffer\~1e\~ctags
-\fIsh#\fR\~groffer\~\-\-extension=e\~\-\-sections=1\~ctags
-.EE
-where \f(CRe\fP works as an abbreviation for the extension
-\f(CRemacs21\fP.
-.
-.
-.TP
-.B /usr/man/linux/de/man7/man.7.Z
-The directory
-.B /usr/man
-is now part of the
-.IR \%man\~path ;
-then there is a subdirectory for an
-.I operating system
-name
-.BR linux/ ;
-next comes a subdirectory
-.B de/
-for the German
-.IR language ;
-the
-.I section
-names
-.B man7
-and
-.B .7
-are known so far;
-.B man
-is the name of the
-.IR \%man\~page ;
-and
-.B .Z
-signifies the compression that can be handled by
-.BR gzip (1).
-We want now show how to provide several values for some options.
-.
-That is possible for
-.I sections
-and
-.I operating system
-names.
-.
-So we use as
-.I sections\~5
-and
-.I 7
-and as
-.I system
-names
-.I linux
-and
-.IR aix .
-The command is then
-.sp
-.EX
-\fIsh#\fR groffer\~\-\-locale=de\~\-\-sections=5:7\~\-\-systems=linux,aix\~man
-\fIsh#\fR LANG=de\~MANSECT=5:7\~SYSTEM=linux,aix\~groffer\~man
-.EE
-.
-.
-.\" ====================================================================
-.SH DECOMPRESSION
-.\" ====================================================================
-.
-The program has a decompression facility.
-.
-If standard input or a file that was retrieved from the command line
-parameters is compressed with a format that is supported by either
-.BR \%gzip (1)
-or
-.BR \%bzip2 (1)
-it is decompressed on-the-fly.
-.
-This includes the \f(CRGNU\fP
-.BR \%.gz ,
-.BR \%.bz2 ,
-and the traditional
-.B \%.Z
-compression.
-.
-The program displays the concatenation of all decompressed input in
-the sequence that was specified on the command line.
-.
-.
-.\" ====================================================================
-.SH "ENVIRONMENT"
-.\" ====================================================================
-.
-The
-.B \%groffer
-program supports many system variables, most of them by courtesy of
-other programs.
-.
-All environment variables of
-.BR \%groff (@MAN1EXT@)
-and \f(CRGNU\fP
-.BR \%man (1)
-and some standard system variables are honored.
-.
-.
-.\" ====================================================================
-.SS "Native groffer Variables"
-.\" ====================================================================
-.
-.TP
-.I \%GROFFER_OPT
-Store options for a run of
-.BR \%groffer .
-.
-The options specified in this variable are overridden by the options
-given on the command line.
-.
-The content of this variable is run through the shell builtin
-\lqeval\rq,
-so arguments containing whitespace or special shell characters should
-be quoted.
-.
-Do not forget to export this variable, otherwise it does not exist
-during the run of
-.BR groffer .
-.
-.
-.\" ====================================================================
-.SS "System Variables"
-.\" ====================================================================
-.
-The following variables have a special meaning for
-.BR \%groffer .
-.
-.
-.TP
-.I \%DISPLAY
-If set, this variable indicates that the X Window System is running.
-.
-Testing this variable decides on whether graphical or text output is
-generated.
-.
-This variable should not be changed by the user carelessly, but it can
-be used to start the graphical
-.B \%groffer
-on a remote X Window System terminal.
-.
-For example, depending on your system,
-.B \%groffer
-can be started on the second monitor by the command
-.sp
-.EX
-\fIsh#\fR DISPLAY=:0.1\~groffer\~what.ever &
-.EE
-.
-.
-.TP
-.I \%LC_ALL
-.TQ
-.I \%LC_MESSAGES
-.TQ
-.I LANG
-If one of these variables is set (in the above sequence), its content
-is interpreted as the locale, the language to be used, especially when
-retrieving
-.IR \%man\~pages .
-.
-A locale name is typically of the form
-.nh
-.IR language \c
-.B _\c
-.IR territory \c
-.B .\c
-.IR codeset \c
-.B @\c
-.IR modifier ,
-.hy
-where
-.I \%language
-is an ISO 639 language code,
-.I \%territory
-is an ISO 3166 country code, and
-.I \%codeset
-is a character set or encoding identifier like ISO-8859-1 or UTF-8;
-see
-.BR \%setlocale (3).
-.
-The locale values \f(CRC\fP and \%\f(CRPOSIX\fP
-stand for the default, i.e.\& the
-.I \%man\~page
-directories without a language prefix.
-.
-This is the same behavior as when all 3\~variables are unset.
-.
-.
-.TP
-.I \%PAGER
-This variable can be used to set the pager for the tty output.
-.
-For example, to disable the use of a pager completely set this
-variable to the
-.BR \%cat (1)
-program
-.sp
-.EX
-\fIsh#\fR PAGER=cat\~groffer\~anything
-.EE
-.sp
-.
-.TP
-.I PATH
-All programs within the
-.B \%groffer
-script are called without a fixed path.
-.
-Thus this environment variable determines the set of programs used
-within the run of
-.BR \%groffer .
-.
-.
-.\" ====================================================================
-.SS "Groff Variables"
-.\" ====================================================================
-.
-The
-.B \%groffer
-program internally calls
-.BR \%groff ,
-so all environment variables documented in
-.BR \%groff (@MAN1EXT@)
-are internally used within
-.B \%groffer
-as well.
-.
-The following variable has a direct meaning for the
-.B \%groffer
-program.
-.
-.TP
-.I \%GROFF_TMPDIR
-If the value of this variable is an existing, writable directory,
-.B \%groffer
-uses it for storing its temporary files, just as
-.B groff
-does.
-.
-See the
-.BR \%groff (@MAN1EXT@)
-man page for more details on the location of temporary files.
-.
-.
-.\" ====================================================================
-.SS "Man Variables"
-.\" ====================================================================
-.
-Parts of the functionality of the
-.B man
-program were implemented in
-.BR \%groffer ;
-support for all environment variables documented in
-.BR \%man (1)
-was added to
-.BR \%groffer ,
-but the meaning was slightly modified due to the different approach in
-.BR \%groffer ;
-but the user interface is the same.
-.
-The
-.B man
-environment variables can be overwritten by options provided with
-.IR MANOPT ,
-which in turn is overwritten by the command line.
-.
-.
-.TP
-.I \%EXTENSION
-Restrict the search for
-.I \%man\~pages
-to files having this extension.
-.
-This is overridden by option
-.BR \-\-extension ;
-see there for details.
-.
-.
-.TP
-.I MANOPT
-This variable contains options as a preset for
-.BR \%man (1).
-As not all of these are relevant for
-.B \%groffer
-only the essential parts of its value are extracted.
-.
-The options specified in this variable overwrite the values of the
-other environment variables that are specific to
-.IR man .
-.
-All options specified in this variable are overridden by the options
-given on the command line.
-.
-.
-.TP
-.I \%MANPATH
-If set, this variable contains the directories in which the
-.I \%man\~page
-trees are stored.
-.
-This is overridden by option
-.BR \%\-\-manpath .
-.
-.
-.TP
-.I \%MANSECT
-If this is a colon separated list of section names, the search for
-.I \%man\~pages
-is restricted to those manual sections in that order.
-.
-This is overridden by option
-.BR \-\-sections .
-.
-.
-.TP
-.I \%SYSTEM
-If this is set to a comma separated list of names these are interpreted
-as
-.I \%man\~page
-trees for different operating systems.
-.
-This variable can be overwritten by option
-.BR \-\-systems ;
-see there for details.
-.
-.
-.P
-The environment variable
-.I \%MANROFFSEQ
-is ignored by
-.B \%groffer
-because the necessary preprocessors are determined automatically.
-.
-.
-.\" ====================================================================
-.SH "CONFIGURATION FILES"
-.\" ====================================================================
-.
-The
-.B \%groffer
-program can be preconfigured by two configuration files.
-.
-.
-.TP
-.B \%/etc/groff/groffer.conf
-System-wide configuration file for
-.BR \%groffer .
-.
-.
-.TP
-.B \%$HOME/.groff/groffer.conf
-User-specific configuration file for
-.BR \%groffer ,
-where
-.I \%$HOME
-denotes the user's home directory.
-.
-This file is called after the system-wide configuration file to enable
-overriding by the user.
-.
-.
-.P
-Both files are handled for the configuration, but the configuration
-file in
-.B /etc
-comes first; it is overwritten by the configuration file in the home
-directory; both configuration files are overwritten by the environment
-variable
-.IR \%GROFFER_OPT ;
-everything is overwritten by the command line arguments.
-.
-.
-.P
-The configuration files contain options that should be called as
-default for every
-.B \%groffer
-run.
-.
-These options are written in lines such that each contains either a
-long option, a short option, or a short option cluster; each with or
-without an argument.
-.
-So each line with configuration information starts with a minus
-character
-.RB \lq \- \rq;
-a line with a long option starts with two minus characters
-.RB \lq \-\- \rq,
-a line with a short option or short option cluster starts with a
-single minus
-.RB \lq \- \rq.
-.
-.
-.P
-The option names in the configuration files may not be abbreviated,
-they must be exact.
-.
-.
-.P
-The argument for a long option can be separated from the option name
-either by an equal sign
-.RB \lq = \rq
-or by whitespace, i.e.\& one or several space or tab characters.
-.
-An argument for a short option or short option cluster can be directly
-appended to the option name or separated by whitespace.
-.
-The end of an argument is the end of the line.
-.
-It is not allowed to use a shell environment variable in an option
-name or argument.
-.
-.
-.P
-It is not necessary to use quotes in an option or argument, except for
-empty arguments.
-.
-An empty argument can be provided by appending a pair of quotes to the
-separating equal sign or whitespace; with a short option, the
-separator can be omitted as well.
-.
-For a long option with a separating equal sign
-.RB \lq = \rq,
-the pair of quotes can be omitted, thus ending the line with the
-separating equal sign.
-.
-All other quote characters are cancelled internally.
-.
-.
-.P
-In the configuration files, arbitrary whitespace is allowed at the
-beginning of each line, it is just ignored.
-.
-Each whitespace within a line is replaced by a single space character
-\lq \rq internally.
-.
-.
-.P
-All lines of the configuration lines that do not start
-with a minus character are ignored, such that comments starting with
-.RB \lq # \rq
-are possible.
-.
-So there are no shell commands in the configuration files.
-.
-.
-.P
-As an example, consider the following configuration file that can be
-used either in
-.B \%/etc/groff/groffer.conf
-or
-.B \%\s+2~\s0/.groff/groffer.conf .
-.
-.
-.P
-.ft CR
-.nh
-.nf
-# groffer configuration file
-#
-# groffer options that are used in each call of groffer
-\-\-foreground=DarkBlue
-\-\-resolution=100
-\-\-viewer=gxditview \-geometry 900x1200
-.fi
-.hy
-.ft
-.
-.
-.P
-The lines starting with
-.B #
-are just ignored, so they act as command lines.
-.
-This configuration sets four
-.B \%groffer
-options (the lines starting with
-.RB \lq \- \rq).
-This has the following effects:
-.
-.
-.IP \*(BU 2m
-Use a text color of
-.B \%DarkBlue
-in all viewers that support this, such as
-.BR \%gxditview .
-.
-.
-.IP \*(BU 2m
-Use a resolution of
-.B 100dpi
-in all viewers that support this, such as
-.BR \%gxditview .
-.
-By this, the default device in
-.I x mode
-is set to
-.BR X100 .
-.
-.
-.IP \*(BU 2m
-Force
-.BR \%gxditview (@MAN1EXT@)
-as the
-.I \%x-mode
-viewer using the geometry option for setting the width to
-.B 900px
-and the height to
-.BR 1200px .
-This geometry is suitable for a resolution of
-.BR 100dpi .
-.
-.
-.IP \*(BU 2m
-Use
-.BR \%xpdf (1)
-as the
-.I \%pdf-mode
-viewer with the argument
-.B \-Z
-.BR 150 .
-.
-.
-.\" ====================================================================
-.SH "EXAMPLES"
-.\" ====================================================================
-.
-The usage of
-.B \%groffer
-is very easy.
-.
-Usually, it is just called with a file name or
-.IR \%man\~page .
-.
-The following examples, however, show that
-.B \%groffer
-has much more fancy capabilities.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~/usr/local/share/doc/groff/meintro.ms.gz
-.EE
-.sp
-Decompress, format and display the compressed file
-.B meintro.ms.gz
-in the directory
-.BR /usr/local/share/doc/groff ,
-using the standard viewer
-.B \%gxditview
-as graphical viewer when in the X Window System, or the
-.BR \%less (1)
-pager program otherwise.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~groff
-.EE
-.sp
-If the file
-.B \%./groff
-exists use it as input.
-.
-Otherwise interpret the argument as a search for the
-.I \%man\~page
-named
-.B \%groff
-in the smallest possible
-.IR \%man\~section ,
-being section 1 in this case.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~man:groff
-.EE
-.sp
-search for the
-.I \%man\~page
-of
-.B \%groff
-even when the file
-.B ./groff
-exists.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~groff.7
-\fIsh#\fR\~groffer\~7\~groff
-.EE
-.sp
-search the
-.I \%man\~page
-of
-.B \%groff
-in
-.I \%man\~section
-.BR 7 .
-This section search works only for a digit or a single character from
-a small set.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~fb.modes
-.EE
-.sp
-If the file
-.B ./fb.modes
-does not exist interpret this as a search for the
-.I \%man\~page
-of
-.BR fb.modes .
-As the extension
-.I \%modes
-is not a single character in classical section style the argument is
-not split to a search for
-.BR fb .
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~groff\~\(cqtroff(1)\(cq\~man:roff
-.EE
-.sp
-The arguments that are not existing files are looked-up as the
-following
-.IR \%man\~pages :
-.B \%groff
-(automatic search, should be found in \fIman\fP\~section\~1),
-.B \%troff
-(in section\~1),
-and
-.B \%roff
-(in the section with the lowest number, being\~7 in this case).
-.
-The quotes around
-.nh
-.I \(cqtroff(1)\(cq
-.hy
-are necessary because the parentheses are special shell characters;
-escaping them with a backslash character
-.I \(rs(
-and
-.I \(rs)
-would be possible, too.
-.
-The formatted files are concatenated and displayed in one piece.
-.
-.sp
-.EX
-\fIsh#\fR\~LANG=de\~groffer\~\-\-man\~\-\-viewer=galeon\~ls
-.EE
-.sp
-Retrieve the German
-.I \%man\~page
-(language
-.IR de )
-for the
-.B ls
-program, decompress it, format it to
-.I \%html
-or
-.I \%xhtml
-format
-.nh
-.RI ( \%www\~mode )
-.hy
-and view the result in the web browser
-.BR \%galeon .
-The option
-.B \-\-man
-guarantees that the
-.I \%man\~page
-is retrieved, even when a local file
-.B \%ls
-exists in the actual directory.
-.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~\-\-source\~'man:roff(7)'
-.EE
-.sp
-Get the
-.I \%man\~page
-called
-.I \%roff
-in \fIman\fP\~section 7, decompress it, and print its unformatted
-content, its source code.
-.
-.
-.sp
-.EX
-\fIsh#\fR\~groffer\~\-\-de-p\~\-\-in\~\-\-ap
-.EE
-.sp
-This is a set of abbreviated arguments, it is determined as
-.br
-.sp
-.EX
-\fIsh#\fR\~groffer\~\-\-debug-params\~\-\-intermediate-output\~\-\-apropos
-.EE
-.sp
-.
-.sp
-.EX
-\fIsh#\fR\~cat\~file.gz\~|\~groffer\~-Z\~-mfoo
-.EE
-.sp
-.
-The file
-.B file.gz
-is sent to standard input, this is decompressed, and then this is
-transported to the
-.I \%groff intermediate output mode
-without post-processing
-.RB ( groff
-option
-.BR \-Z ),
-using macro package
-.I \%foo
-.RB ( groff
-option
-.BR \-m ).
-.
-.
-.sp
-.EX
-\fIsh#\fR\~echo\~'\(rsf(CBWOW!'\~|
-> groffer \-\-x \-\-bg red \-\-fg yellow \-\-geometry 200x100 \-
-.EE
-.sp
-.
-Display the word \f(CBWOW!\fP in a small window in constant-width
-bold font, using color yellow on red background.
-.
-.
-.\" ====================================================================
-.SH "COMPATIBILITY"
-.\" ====================================================================
-.
-The
-.B \%groffer
-program is written in Perl, the Perl version during writing was v5.8.8.
-.
-.
-.P
-.B \%groffer
-provides its own parser for command-line arguments that is compatible
-to both \%\f(CRPOSIX\fP
-.BR \%getopts (1)
-and \%\f(CRGNU\fP
-.BR \%getopt (1).
-It can handle option arguments and file names containing white space
-and a large set of special characters.
-.
-The following standard types of options are supported.
-.
-.
-.IP \*(BU 2m
-The option consisting of a single minus
-.B \-
-refers to standard input.
-.
-.
-.IP \*(BU 2m
-A single minus followed by characters refers to a single character
-option or a combination thereof; for example, the
-.B \%groffer
-short option combination
-.B \-Qmfoo
-is equivalent to
-.BR \-Q\~\-m\~foo .
-.
-.
-.IP \*(BU 2m
-Long options are options with names longer than one character; they
-are always preceded by a double minus.
-.
-An option argument can either go to the next command-line argument or
-be appended with an equal sign to the argument; for example,
-.B \-\-long=arg
-is equivalent to
-.BR \-\-long\~arg .
-.
-.
-.IP \*(BU 2m
-An argument of
-.B \-\-
-ends option parsing; all further command-line arguments are
-interpreted as
-.I \%filespec
-parameters, i.e.\& file names or constructs for searching
-.IR \%man\~pages ).
-.
-.
-.IP \*(BU 2m
-All command-line arguments that are neither options nor option
-arguments are interpreted as
-.I \%filespec
-parameters and stored until option parsing has finished.
-.
-For example, the command line
-.sp
-.EX
-\fIsh#\fR\~groffer file1 \-a \-o arg file2
-.EE
-.sp
-is equivalent to
-.sp
-.EX
-\fIsh#\fR\~groffer \-a \-o arg \-\- file1 file2
-.EE
-.sp
-.
-.P
-The free mixing of options and
-.I \%filespec
-parameters follows the GNU principle.
-.
-That does not fulfill the strange option behavior of \%\f(CRPOSIX\fP
-that ends option processing as soon as the first non-option argument
-has been reached.
-.
-The end of option processing can be forced by the option
-.RB \lq \-\- \rq
-anyway.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.B groffer
-was written by
-.MT groff\-bernd.warken\-72@\:web.de
-Bernd Warken
-.ME .
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.P
-.BR \%groff (@MAN1EXT@),
-.BR \%@g@troff (@MAN1EXT@)
-.RS
-Details on the options and environment variables available in
-.BR \%groff ;
-all of them can be used with
-.BR \%groffer .
-.RE
-.
-.
-.TP
-.BR \%grog (@MAN1EXT@)
-This program tries to guess the necessary
-.B \%groff
-command-line options from the input and the
-.B groffer
-options.
-.
-.
-.TP
-.BR \%groff (@MAN7EXT@)
-Documentation of the
-.I \%groff
-language.
-.
-.
-.TP
-.BR groff_char (@MAN7EXT@)
-Documentation on the
-.I \%groff
-characters, special characters, and glyphs..
-.
-.
-.TP
-.BR groff_tmac (@MAN5EXT@)
-Documentation on the
-.I \%groff
-macro files.
-.
-.
-.TP
-.BR groff_out (@MAN5EXT@)
-Documentation on the
-.I \%groff intermediate output
-before the run of a
-.IR postprocessor .
-.nh
-.RI ( ditroff
-output).
-.hy
-.
-This can be run by the
-.B groff
-or
-.B groffer
-option
-.BR -Z .
-.
-.
-.TP
-.BR \%man (1)
-The standard program to display
-.IR \%man\~pages .
-.
-The information there is only useful if it is the
-.I \%man\~page
-for GNU
-.BR man .
-Then it documents the options and environment variables that are
-supported by
-.BR \%groffer .
-.
-.
-.TP
-.BR \%gxditview (@MAN1EXT@)
-.TQ
-.BR \%xditview (1x)
-.RS
-Viewers for
-.BR \%groffer 's
-.IR \%x\~mode .
-.RE
-.
-.
-.TP
-.BR \%kpdf (1)
-.TQ
-.BR \%kghostview (1)
-.TQ
-.BR \%evince (1)
-.TQ
-.BR \%ggv (1)
-.TQ
-.BR \%gv (1)
-.TQ
-.BR \%ghostview (1)
-.TQ
-.BR \%gs (1)
-Viewers for
-.BR \%groffer 's
-.IR \%ps\~mode .
-.
-.
-.TP
-.BR \%kpdf (1)
-.TQ
-.BR \%acroread (1)
-.TQ
-.BR \%evince (1)
-.TQ
-.BR \%xpdf (1)
-.TQ
-.BR \%gpdf (1)
-.TQ
-.BR \%kghostview (1)
-.TQ
-.BR \%ggv (1)
-Viewers for
-.BR \%groffer 's
-.IR \%pdf\~mode .
-.
-.
-.P
-.BR \%kdvi (1),
-.BR \%xdvi (1),
-.BR \%dvilx (1)
-.RS
-Viewers for
-.BR \%groffer 's
-.IR \%dvi\~mode .
-.RE
-.
-.
-.TP
-.BR \%konqueror (1)
-.TQ
-.BR \%epiphany (1)
-.TQ
-.BR \%firefox (1)
-.TQ
-.BR \%mozilla (1)
-.TQ
-.BR \%netscape (1)
-.TQ
-.BR \%lynx (1)
-Web-browsers for
-.BR \%groffer 's
-.IR \%html ,
-.IR \%xhtml ,
-or
-.IR \%www\~mode .
-.
-.
-.TP
-.BR \%less (1)
-.TQ
-.BR more (1)
-Standard pager program for the
-.IR \%tty\~mode .
-.
-.
-.TP
-.BR \%gzip (1)
-.TQ
-.BR \%bzip2 (1)
-.TQ
-.BR \%xz (1)
-The decompression programs supported by
-.BR \%groffer .
-.
-.
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: set filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/groffer.am Deleted

@@ -1,120 +0,0 @@
-# Automake rules for 'groffer'
-
-# File position: <groff-source>/contrib/groffer/groffer.am
-
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
-# Written by Werner Lemberg <wl@gnu.org> and
-# Bernd Warken <groff-bernd.warken-72@web.de>.
-# Automake migration by Bertrand Garrigues
-
-# Last update: 22 Aug 2015
-
-# This file is part of 'groffer' 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-groffer_srcdir = $(top_srcdir)/contrib/groffer
-# generated programs
-ROFF2PROGS = \
-  roff2dvi \
-  roff2html \
-  roff2pdf \
-  roff2ps \
-  roff2text \
-  roff2x
-
-# Generated man templates
-ROFF2MAN = \
-  contrib/groffer/roff2dvi.1.man \
-  contrib/groffer/roff2html.1.man \
-  contrib/groffer/roff2pdf.1.man \
-  contrib/groffer/roff2ps.1.man \
-  contrib/groffer/roff2text.1.man \
-  contrib/groffer/roff2x.1.man
-
-GROFFER_PERL = \
-  contrib/groffer/main_subs.pl \
-  contrib/groffer/man.pl \
-  contrib/groffer/split_env.sh \
-  contrib/groffer/subs.pl
-
-GROFFER_REST = \
-  contrib/groffer/roff2.1.man \
-  contrib/groffer/version.sh \
-  contrib/groffer/groffer.1.man \
-  contrib/groffer/groffer.pl \
-  contrib/groffer/roff2.pl
-
-EXTRA_DIST += $(GROFFER_PERL) $(GROFFER_REST) \
-  contrib/groffer/ChangeLog  \
-  contrib/groffer/README \
-  contrib/groffer/README_PERL
-
-# groffer_dir is set by a m4 macro
-grofferdir = $(groffer_dir)
-bin_SCRIPTS += groffer $(ROFF2PROGS)
-groffer_DATA = $(GROFFER_PERL) contrib/groffer/version.sh
-man1_MANS += \
-  contrib/groffer/groffer.1 \
-  contrib/groffer/roff2dvi.1 \
-  contrib/groffer/roff2html.1 \
-  contrib/groffer/roff2pdf.1 \
-  contrib/groffer/roff2ps.1 \
-  contrib/groffer/roff2text.1 \
-  contrib/groffer/roff2x.1
-MOSTLYCLEANFILES += $(ROFF2MAN)
-
-$(ROFF2PROGS): $(groffer_srcdir)/roff2.pl
-	cp $(groffer_srcdir)/roff2.pl $@
-
-# we take roff2.man and replace the @ROFF2MODE@ by the type of file
-# (dvi, pdf, html etc ...)
-$(ROFF2MAN):  $(groffer_srcdir)/roff2.1.man
-	$(AM_V_GEN)$(MKDIR_P) contrib/groffer \
-	&& FILEMODE=`echo $@ | sed 's|contrib/groffer/roff2$a-za-z*$\.1\.man|\1|g'` \
-	&& sed -e 's/@ROFF2MODE@/'"$$FILEMODE"'/g' \
-	       $(groffer_srcdir)/roff2.1.man \
-	       > $@;
-
-groffer: $(GROFFER_PERL) $(GROFFER_REST) $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)sed -f "$(SH_DEPS_SED_SCRIPT)" \
-	   -e "s|@g@|$(g)|g" \
-	   -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
-	   -e "s|@libdir@|$(DESTDIR)$(libdir)|g" \
-	   -e "s|@groffer_dir@|$(DESTDIR)$(groffer_dir)|g" \
-	   -e "s|@VERSION@|$(VERSION)|g" \
-	   -e "$(SH_SCRIPT_SED_CMD)" \
-	   $(groffer_srcdir)/groffer.pl \
-	   >$@ \
-	&& chmod +x $@;
-
-uninstall_groffdirs: uninstall-groffer-hook
-uninstall-groffer-hook:
-	if test -d $(DESTDIR)$(grofferdir); then \
-	  rmdir $(DESTDIR)$(grofferdir); \
-	fi
-
-
-########################################################################
-# Editor settings
-########################################################################
-#
-# Local Variables:
-# mode: makefile-automake
-# fill-column: 72
-# End:
-# vim: set filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/groffer.pl Deleted

@@ -1,331 +0,0 @@
-#! /usr/bin/env perl
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/groffer.pl
-# Installed position: <prefix>/bin/groffer
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# Last update: 27 Aug 2015
-
-# This file is part of 'groffer', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-use strict;
-use warnings;
-#use diagnostics;
-
-# temporary dir and files
-use File::Temp qw/ tempfile tempdir /;
-
-# needed for temporary dir
-use File::Spec;
-
-# for 'copy' and 'move'
-use File::Copy;
-
-# for fileparse, dirname and basename
-use File::Basename;
-
-# current working directory
-use Cwd;
-
-# $Bin is the directory where this script is located
-use FindBin;
-
-
-########################################################################
-# system variables and exported variables
-########################################################################
-
-require 5.6.1;
-
-our $Dev_Null;
-our $Umask;
-our @Path;
-our $Start_Dir;
-
-our $tmpdir = '';
-our ($fh_cat, $tmp_cat);
-our ($fh_stdin, $tmp_stdin);
-
-our @Addopts_Groff;
-our %Debug;
-our %Opt;
-
-our $Has_Compression;
-our $Has_bzip;
-
-our $Output_File_Name;
-
-our $Apropos_Prog;
-our $Filespec_Arg;
-our $Filespec_Is_Man;
-our $Macro_Pkg;
-our $Manspec;
-our $No_Filespecs;
-our $Special_Filespec;
-our $Special_Setup;
-
-our %Man;
-
-BEGIN {
-  $Dev_Null = File::Spec->devnull();
-
-  $Umask = umask 077;
-
-  $Start_Dir = getcwd;
-
-  # flush after each print or write command
-  $| = 1;
-}
-
-
-########################################################################
-# read-only variables with double-@ construct
-########################################################################
-
-our $File_split_env_sh;
-our $File_version_sh;
-our $Groff_Version;
-
-my $before_make;		# script before run of 'make'
-{
-  my $at = '@';
-  $before_make = 1 if '@VERSION@' eq "${at}VERSION${at}";
-}
-
-my %at_at;
-my $groffer_libdir;
-
-if ($before_make) {
-  my $groffer_source_dir = $FindBin::Bin;
-  $at_at{'BINDIR'} = $groffer_source_dir;
-  $at_at{'G'} = '';
-  $at_at{'LIBDIR'} = '';
-  $groffer_libdir = $groffer_source_dir;
-  $File_version_sh = File::Spec->catfile($groffer_source_dir, 'version.sh');
-  $Groff_Version = '';
-} else {
-  $Groff_Version = '@VERSION@';
-  $at_at{'BINDIR'} = '@BINDIR@';
-  $at_at{'G'} = '@g@';
-  $at_at{'LIBDIR'} = '@libdir@';
-  $groffer_libdir = '@groffer_dir@';
-  $File_version_sh = File::Spec->catfile($groffer_libdir, 'version.sh');
-}
-
-die "$groffer_libdir is not an existing directory;"
-  unless -d $groffer_libdir;
-
-unshift(@INC, $groffer_libdir);
-
-$File_split_env_sh = File::Spec->catfile($groffer_libdir, 'split_env.sh');
-die "$File_split_env_sh does not exist;" unless -f "$File_split_env_sh";
-
-require 'subs.pl';
-require 'main_subs.pl';
-require 'man.pl';
-
-@Path = &path_uniq( File::Spec->path() );
-
-if ( &where_is_prog('gzip') ) {
-  $Has_Compression = 1;
-  $Has_bzip = 1 if &where_is_prog('bzip2');
-}
-
-
-########################################################################
-# modes, viewers, man sections, and defaults
-########################################################################
-
-# configuration files
-our @Conf_Files = (File::Spec->catfile(File::Spec->rootdir(),
-				      'etc', 'groff', 'groffer.conf'),
-		  File::Spec->catfile("$ENV{'HOME'}", '.groff',
-				      'groffer.conf')
-		 );
-
-our @Default_Modes = ('pdf', 'pdf2', 'html', 'xhtml', 'ps', 'x', 'dvi',
-		      'tty');
-our $Default_Resolution = 100;
-our $Default_tty_Device = 'utf8';
-
-our @Macro_Packages = ('-man', '-mdoc', '-me', '-mm', '-mom', '-ms');
-
-our %Viewer_tty = ('DVI' => ,
-		  'HTML' => 'lynx', 'w3m',
-		  'PDF' => ,
-		  'PS' => ,
-		  'TTY' => 'less -r -R', 'more', 'pager',
-		  'X' => ,
-		 );
-
-our %Viewer_X = ('DVI' => 'kdvi', 'xdvi', 'dvilx',
-		'HTML' => 'konqueror', 'epiphany'. 'mozilla-firefox',
-			   'firefox', 'mozilla', 'netscape', 'galeon',
-			   'opera', 'amaya','arena', 'mosaic',
-		'XHTML' => 'konqueror', 'epiphany'. 'mozilla-firefox',
-			   'firefox', 'mozilla', 'netscape', 'galeon',
-			   'opera', 'amaya','arena', 'mosaic',
-		'PDF' => 'okular', 'kpdf', 'acroread', 'evince',
-			  'xpdf -z 150', 'gpdf', 'xpdf', 'zathura'.
-			  'epdfview', 'qpdfview', 'apvlv', 'qpdfview',
-			  'kghostview --scale 1.45', 'gv', 'ggv',
-		'PS' => 'okular', 'evince', 'gv',
-			 'gs', 'gs_x11', 'ghostscript', 'ghostview',
-			 'kghostview --scale 1.45', 'ggv', 'kpdf',
-		'TTY' => 'xless',
-		'X' => 'gxditview', 'xditview',
-	      );
-
-%Man = ('ALL' => 0,
-	'AUTO_SEC' => '1', '2', '3', '4', '5', '6', '7', '8', '9',
-			  'n', 'o',
-	'ENABLE' => 1,
-	   'EXT' => '',
-	   'FORCE' => 0,
-	   'IS_SETUP' => 0,
-	   'MANSPEC' => {},
-	   'LANG' => '',
-	   'LANG2' => '',
-	   'PATH' => ,
-	   'SEC' => ,
-	   'SEC_CHARS' => '',
-	   'SYS' => ,
-	  );
-$Man{'AUTO_SEC_CHARS'} = join('', @{$Man{'AUTO_SEC'}});
-
-
-########################################################################
-# given options
-########################################################################
-
-our %Opts_Cmdline_Short;
-our %Opts_Cmdline_Long;
-our $Opts_Cmdline_Long_Str;
-our %Opts_Cmdline_Double;
-our %Opts_Groff_Short;
-
-&main_set_options();
-
-
-########################################################################
-# $MANOPT
-########################################################################
-
-# handle environment variable $MANOPT
-our @Manopt;
-
-&main_parse_MANOPT();
-
-
-########################################################################
-# configuration files, $GROFFER_OPT, and command line, main_config_params()
-########################################################################
-
-our @Options;
-our @Filespecs;
-our @Starting_Conf;
-our @Starting_ARGV = @ARGV;
-
-&main_config_params();
-
-if (0) {
-  print STDERR "<$_>\n" foreach @ARGV;
-}
-
-
-########################################################################
-# main_parse_params()
-########################################################################
-
-$Opt{'XRM'} = ;
-
-our $i = 0;
-our $n = $#Options;
-
-&main_parse_params();
-
-
-########################################################################
-# main_set_mode()
-########################################################################
-
-our $Viewer_Background;
-our $PDF_Did_Not_Work;
-our $PDF_Has_gs;
-our $PDF_Has_ps2pdf;
-our %Display = ('MODE' => '',
-	       'PROG' => '',
-	       'ARGS' => ''
-	      );
-
-&main_set_mode();
-
-
-########################################################################
-# groffer temporary directory, main_temp()
-########################################################################
-
-&main_temp();
-
-
-########################################################################
-# tmp functions and compression
-########################################################################
-
-########################################################################
-# main_do_fileargs() and related subs
-########################################################################
-
-our @REG_TITLE = ();
-
-&main_do_fileargs();
-
-
-
-########################################################################
-# main_set_resources()
-########################################################################
-
-&main_set_resources();
-
-
-########################################################################
-# set resources
-########################################################################
-
-our $groggy;
-our $modefile;
-our $addopts;
-
-&main_display();
-
-&clean_up();
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/main_subs.pl Deleted

@@ -1,2132 +0,0 @@
-#! /usr/bin/env perl
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/subs.pl
-# Installed position: <prefix>/lib/groff/groffer/subs.pl
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# Last update: 27 Aug 2015
-
-# This file is part of 'groffer', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-# This file contains the main functions formerly in 'groff.pl'
-
-use strict;
-use warnings;
-
-
-########################################################################
-# main_set_options()
-########################################################################
-
-sub main_set_options {
-  our %Opts_Cmdline_Short;
-  our %Opts_Cmdline_Long;
-  our $Opts_Cmdline_Long_Str;
-  our %Opts_Cmdline_Double;
-  our %Opts_Groff_Short;
-
-  # the following options are ignored in groffer.pl, but are kept from
-  # groffer.sh: --shell arg, --debug-shell
-
-  my @opts_ignored_short_na = ();
-  my @opts_ignored_short_arg = ();
-
-  my @opts_ignored_long_na = ('debug-shell');
-
-  my @opts_ignored_long_arg = ('shell');
-
-
-  ###### groffer native options
-
-  my @opts_groffer_short_na = ('h', 'Q', 'v', 'V', 'X', 'Z');
-  my @opts_groffer_short_arg = ('T');
-
-  my @opts_groffer_long_na = ('auto', 'apropos', 'apropos-data',
-  'apropos-devel', 'apropos-progs', 'debug', 'debug-all',
-  'debug-filenames', 'debug-func', 'debug-grog', 'debug-not-func',
-  'debug-keep', 'debug-lm', 'debug-params', 'debug-stacks',
-  'debug-tmpdir', 'debug-user', 'default', 'do-nothing', 'dvi',
-  'groff', 'help', 'intermediate-output', 'html', 'latin1', 'man',
-  'no-location', 'no-man', 'no-special', 'pdf', 'pdf2', 'ps', 'rv',
-  'source', 'text', 'to-stdout', 'text-device', 'tty', 'tty-device',
-  'utf8', 'version', 'whatis', 'where', 'www', 'x', 'X', 'xhtml');
-
-### main_set_options()
-  my @opts_groffer_long_arg =
-    ('default-modes', 'device', 'extension', 'fg', 'fn', 'font',
-     'foreground', 'mode', 'print', 'title', 'viewer',
-     # tty viewers are ignored
-     'dvi-viewer-tty', 'html-viewer-tty', 'pdf-viewer-tty',
-     'ps-viewer-tty', 'tty-viewer-tty', 'www-viewer-tty',
-     'X-viewer-tty', 'x-viewer-tty', 'xhtml-viewer-tty',,
-     # viewers for modes are ignored
-     'dvi-viewer', 'html-viewer', 'pdf-viewer', 'ps-viewer', 'tty-viewer',
-     'www-viewer', 'X-viewer', 'x-viewer', 'xhtml-viewer',
-    );
-
-  ##### groffer options inhereted from groff
-
-  my @opts_groff_short_na = ('a', 'b', 'c', 'C', 'e', 'E', 'g', 'G',
-  'i', 'j', 'J', 'k', 'l', 'N', 'p', 'R', 's', 'S', 't', 'U', 'z');
-
-  my @opts_groff_short_arg = ('d', 'f', 'F', 'I', 'K', 'L', 'm', 'M', 'n',
-  'o', 'P', 'r', 'w', 'W');
-
-  my @opts_groff_long_na = ();
-  my @opts_groff_long_arg = ();
-
-  ##### groffer options inhereted from the X Window toolkit
-
-  my @opts_x_short_na = ();
-  my @opts_x_short_arg = ();
-
-  my @opts_x_long_na = ('iconic', 'rv');
-
-  my @opts_x_long_arg = ('background', 'bd', 'bg', 'bordercolor',
-  'borderwidth', 'bw', 'display', 'fg', 'fn', 'font', 'foreground',
-  'ft', 'geometry', 'resolution', 'title', 'xrm');
-
-### main_set_options()
-  ###### groffer options inherited from man
-
-  my @opts_man_short_na = ();
-  my @opts_man_short_arg = ();
-
-  my @opts_man_long_na = ('all', 'ascii', 'catman', 'ditroff',
-  'local-file', 'location', 'troff', 'update');
-
-  my @opts_man_long_arg = ('locale', 'manpath', 'pager',
-  'preprocessor', 'prompt', 'sections', 'systems', 'troff-device');
-
-  ###### additional options for parsing evironment variable $MANOPT only
-
-  my @opts_manopt_short_na = ('7', 'a', 'c', 'd', 'D', 'f', 'h', 'k',
-  'l', 't', 'u', 'V', 'w', 'Z');
-
-  my @opts_manopt_short_arg = ('e', 'L', 'm', 'M', 'p', 'P', 'r', 'S',
-  'T');
-
-  my @opts_manopt_long_na = (@opts_man_long_na, 'apropos', 'debug',
-  'default', 'help', 'html', 'ignore-case', 'location-cat',
-  'match-case', 'troff', 'update', 'version', 'whatis', 'where',
-  'where-cat');
-
-  my @opts_manopt_long_arg = (@opts_man_long_na, 'config_file',
-  'encoding', 'extension', 'locale');
-
-### main_set_options()
-  ###### collections of command-line options
-
-  # There are two hashes that control the whole of the command-line
-  # options, one for short and one for long options.  Options without
-  # and with arguments are mixed by advicing a value of 0 for an option
-  # without argument and a value of 1 for an option with argument.
-  # The options are with leading minus.
-
-  foreach (@opts_groffer_short_na, @opts_groff_short_na,
-	   @opts_x_short_na, @opts_man_short_na, @opts_ignored_short_na) {
-    $Opts_Cmdline_Short{"-$_"} = 0 if $_;
-  }
-  foreach (@opts_groffer_short_arg, @opts_groff_short_arg,
-	   @opts_x_short_arg, @opts_man_short_arg, @opts_ignored_short_arg) {
-    $Opts_Cmdline_Short{"-$_"} = 1 if $_;
-  }
-
-  foreach (@opts_groffer_long_na, @opts_groff_long_na,
-	   @opts_x_long_na, @opts_man_long_na, @opts_ignored_long_na) {
-    $Opts_Cmdline_Long{"--$_"} = 0 if $_;
-  }
-  foreach (@opts_groffer_long_arg, @opts_groff_long_arg,
-	   @opts_x_long_arg, @opts_man_long_arg, @opts_ignored_long_arg) {
-    $Opts_Cmdline_Long{"--$_"} = 1 if $_;
-  }
-
-  # For determining abbreviations of an option take two spaces as join
-  # for better check.
-  # The options are without leading minus.
-  $Opts_Cmdline_Long_Str = join '  ', keys %Opts_Cmdline_Long;
-  if ($Opts_Cmdline_Long_Str) {
-    $Opts_Cmdline_Long_Str = " $Opts_Cmdline_Long_Str ";
-    $Opts_Cmdline_Long_Str =~ s/--//g;
-  }
-
-### main_set_options()
-  # options with equal meaning are mapped to a single option name
-  # all of these have leading minus characters
-  %Opts_Cmdline_Double = ('-h' => '--help',
-			  '-Q' => '--source',
-			  '-T' => '--device',
-			  '-v' => '--version',
-			  '-Z' => '--intermediate-output',
-			  '--bd' => '--bordercolor',
-			  '--bg' => '--background',
-			  '--bw' => '--borderwidth',
-			  '--debug-all' => '--debug',
-			  '--ditroff' => '--intermediate-output',
-			  '--fg' => '--foreground',
-			  '--fn' => '--font',
-			  '--ft' => '--font',
-			  '--latin1' => '--tty',
-			  '--troff-device' => '--device',
-			  '--tty-device' => '--text-device',
-			  '--viewer' => '--viewer',
-			  '--where' => '--location',
-			  '--www' => '--html',
-			  '--X' => '--x',
-			  '--xhtml' => '--html',
-			  # '--dvi-viewer' => '--viewer',
-			  '--dvi-viewer-tty' => '--viewer',
-			  '--html-viewer-tty' => '--viewer',
-			  '--xhtml-viewer-tty' => '--pager',
-			  '--pdf-viewer-tty' => '--viewer',
-			  '--ps-viewer-tty' => '--viewer',
-			  '--tty-viewer' => '--pager',
-			  '--tty-viewer-tty' => '--pager',
-			  '--www-viewer' => '--viewer',
-			  '--www-viewer-tty' => '--pager',
-			  '--X-viewer' => '--viewer', '--X-viewer-tty'
-			  => '--pager', '--x-viewer' => '--viewer',
-			  '--x-viewer-tty' => '--pager', );
-
-  # groff short options with leading minus
-  foreach (@opts_groff_short_na) {
-    $Opts_Groff_Short{"-$_"} = 0;
-  }
-  foreach (@opts_groff_short_arg) {
-    $Opts_Groff_Short{"-$_"} = 1;
-  }
-
-} # main_set_options()
-
-
-########################################################################
-# main_parse_MANOPT
-########################################################################
-
-sub main_parse_MANOPT {
-  our @Manopt;
-  our $File_split_env_sh;
-
-  if ( $ENV{'MANOPT'} ) {
-    @Manopt = `sh $File_split_env_sh MANOPT`;
-    chomp @Manopt;
-
-    my @manopt;
-    # %opts stores options that are used by groffer for $MANOPT
-    # All options not in %opts are ignored.
-    # Check options used with %Opts_Cmdline_Double.
-    # 0: option used ('' for ignore), 1: has argument or not
-    ### main_parse_MANOPT()
-    my %opts = ('-7' => '--ascii', 0,
-		'-L' => '--locale', 1,
-		'-M' => '--manpath', 1,
-		'-P' => '--pager', 1,
-		'-S' => '--sections', 1,
-		'-T' => '-T', 1,
-		'-w' => '--location', 0,
-		'-a' => '--all', 0,
-		'-c' => '', 1,
-		'-e' => '--extension', 1,
-		'-f' => '--whatis', 1,
-		'-m' => '--systems', 1,
-		'-p' => '', 1,
-		'-r' => '', 1,
-		'-manpath' => '--manpath', 1,
-		'-pager' => '--pager', 1,
-		'-prompt' => '', 1,
-		'-sections' => '--sections', 1,
-		'--all' => '--all', 0,
-		'--ascii' => '--ascii', 0,
-		'--catman' => '', 1,
-		'--device' => '-T', 1,
-		'--extension' => '--extension', 1,
-		'--locale' => '--locale', 1,
-		'--location' => '--location', 0,
-		'--manpath' => '--manpath', 1,
-		'--preprocessor' => '', 1,
-		'--systems' => '--systems', 1,
-		'--whatis' => '--whatis', 1,
-		'--where' => '--location', 0,
-	       );
-
-### main_parse_MANOPT()
-    my ($opt, $has_arg);
-    my $i = 0;
-    my $n = $#Manopt;
-    while ($i <= $n) {
-      my $o = $Manopt$i;
-      ++$i;
-      # ignore, when not in %opts
-      next unless (exists $opts{$o});
-      if (($o eq '-D') or ($o eq '--default')) {
-	@manopt = ();
-	next;
-      }
-      $opt = $opts{$o}0;
-      $has_arg = $opts{$o}1;
-      # ignore, when empty in %opts
-      unless ($opt) {
-	# ignore without argument
-	next unless ($has_arg);
-	# ignore the argument as well
-	++$i;
-	next;
-      }
-      if ($has_arg) {
-	last if ($i > $n);
-	push @manopt, $opt, $Manopt$i;
-	++$i;
-	next;
-      } else {
-	push @manopt, $opt;
-	next;
-      }
-    }
-    @Manopt = @manopt;
-  }
-}				# main_parse_MANOPT()
-
-
-########################################################################
-# configuration files, $GROFFER_OPT, and command line, main_config_params()
-########################################################################
-
-sub main_config_params {	# handle configuration files
-  our @Options;
-  our @Filespecs;
-  our @Starting_Conf;
-  our @Starting_ARGV = @ARGV;
-
-  our %Opts_Cmdline_Short;
-  our %Opts_Cmdline_Long;
-  our $Opts_Cmdline_Long_Str;
-  our %Opts_Cmdline_Double;
-  our %Opts_Groff_Short;
-
-  our $File_split_env_sh;
-  our @Manopt;
-  our @Conf_Files;
-
-  # options may not be abbreviated, but must be exact
-  my @conf_args;
-  foreach my $f ( @Conf_Files ) {
-    if (-s $f) {
-      my $fh;
-      open $fh, "<$f" || next;
-      my $nr = 0;
-    LINE: foreach my $line (<$fh>) {
-	++ $nr;
-	chomp $line;
-	# remove starting and ending whitespace
-	$line =~ s/^\s+|\s+$//g;
-	# replace whitespace by single space
-	$line =~ s/\s+/ /g;
-	# ignore all lines that do not start with minus
-	next unless $line =~ /^-/;
-	# three minus
-	if ($line =~ /^---/) {
-	  warn "Wrong option $line in configuration file $f.\n";
-	  next;
-	}
-	if ( $line =~ /^-- =/ ) {
-	  warn "No option name in '$line' in configuration " .
-	    "file $f.\n";
-	  next;
-	}
-	push @Starting_Conf, $line;
-	# -- or -
-	if ($line =~ /^--?$/) {
-	  warn "'$line' is not allowed in configuration files.\n";
-	  next; }
-### main_config_params()
-	if ($line =~ /^--/) {		# line is long option
-	  my ($name, $arg);
-	  if ($line =~ / =/) {	# has arg on line $line =~
-	    /^(--^ =+) = ?(.*)$/;
-	    ($name, $arg) = ($1, $2);
-	    $arg =~ s/\'\"//g;
-	  } else {			# does not have an argument on line
-	    $name = $line;
-	  } $name =~ s/\'\"//g;
-	  unless (exists $Opts_Cmdline_Long{$name}) {
-	    # option does not exist
-	    warn "Option '$name' does not exist.\n";
-	    next LINE;
-	  }
-	  # option exists
-	  if ( $Opts_Cmdline_Long{$name} ) { # option has arg
-	    if (defined $arg) {
-	      push @conf_args, $name, $arg;
-	      next LINE;
-	    } else { warn "Option '$name' needs an argument in " .
-		       "configuration file $f\n";
-		     next LINE;
-		   }
-	  } else { # option has no arg
-	    if (defined $arg) {
-	      warn "Option '$name' may not have an argument " .
-		"in configuration file $f\n";
-	      next LINE;
-	    } else {
-	      push @conf_args, $name; next LINE;
-	    }
-	  }
-### main_config_params()
-	} else {			# line is short option or cluster
-	  $line =~ s/^-//;
-	  while ($line) {
-	    $line =~ s/^(.)//;
-	    my $opt = "-$1";
-	    next if ($opt =~ /\'\"/);
-	    if ($opt =~ /- /) {
-	      warn "Option '$conf_args$#conf_args' does not " .
-		"have an argument.\n";
-	      next LINE;
-	    }
-	    if ( exists $Opts_Cmdline_Short{$opt} ) {
-	      # short opt exists
-	      push @conf_args, $opt;
-	      if ( $Opts_Cmdline_Short{$opt} ) { # with arg
-		my $arg = $line;
-		$arg =~ s/^ //;
-		$arg =~ s/\'\"//g;
-		push @conf_args, "$arg";
-		next LINE;
-	      } else { # no arg
-		next;
-	      }
-	    } else { # short option does not exist
-	      warn "Wrong short option '-$opt' from " .
-		"configuration.  Rest of line ignored.\n";
-	      next LINE;
-	    }
-	  }
-	}
-      }
-      close $fh;
-    }
-  }
-
-### main_config_params()
-  #handle environment variable $GROFFER_OPT
-  my @GROFFER_OPT;
-  if ( $ENV{'GROFFER_OPT'} ) {
-    @GROFFER_OPT = `sh $File_split_env_sh GROFFER_OPT`;
-    chomp @GROFFER_OPT;
-  }
-
-  # Handle command-line parameters together with $GROFFER_OPT.
-  # Options can be abbreviated, with each - as abbreviation place.
-  {
-    my @argv0 = (@GROFFER_OPT, @ARGV);
-    my @argv;
-    my $only_files = 0;
-    my $n = $#argv0;		# last element
-    my $n1 = scalar @GROFFER_OPT; # first element of @ARGV
-    my $i = 0;			# number of the element
-    my @s = ('the environment variable $GROFFER_OPT', 'the command line');
-    my $j = 0;			# index in @s, 0 before $n1, 1 then
-  ELT: while ($i <= $n) {
-      my $elt = $argv0$i;
-      $j = 1 if $i >= $n1;
-      ++$i;
-      # remove starting and ending whitespace
-      $elt =~ s/^\s+|\s+$//g;
-      # replace whitespace by single space
-      $elt =~ s/\s+/ /g;
-
-      if ($only_files) {
-	push @Filespecs, $elt;
-	next ELT;
-      }
-
-### main_config_params()
-      if ( $elt =~ /^-$/ ) { # -
-	push @Filespecs, $elt;
-	next ELT;
-      }
-      if ($elt =~ /^--$/) { # --
-	$only_files = 1;
-	next ELT;
-      }
-
-      if ($elt =~ /^-- =/) { # no option name
-	warn "No option name in '$elt' at $s$j.\n";
-	next ELT;
-      }
-      if ($elt =~ /^---/) { # wrong with three minus
-	warn "Wrong option '$elt' at $s$j.\n";
-	next ELT;
-      }
-
-      if ($elt =~ /^--^-/) { # long option
-	my ($name, $opt, $abbrev, $arg);
-	if ($elt =~ / =/) { # has arg on elt
-	  $elt =~ /^--(^ =+) = ?(.*)$/;
-	  ($name, $arg) = ($1, $2);
-	  $opt = "--$name";
-	  $abbrev = $name;
-	  $arg =~ s/\'\"//g;
-	} else {		# does not have an argument in the element
-	  $opt = $name = $elt;
-	  $name =~ s/^--//;
-	  $abbrev = $name;
-	}
-### main_config_params()
-	# remove quotes in name
-	$name =~ s/\'\"//g;
-	my $match = $name;
-	$match =~ s/-/^- *-/g;
-	if ( exists $Opts_Cmdline_Long{$opt} ) {
-	  # option exists exactly
-	} elsif	( $Opts_Cmdline_Long_Str =~ / (${match}^- *?) / ) {
-	  # option is an abbreviation without further -
-	  my $n0 = $1;
-	  if ( $Opts_Cmdline_Long_Str =~
-	       /\s(${match}^-\s*)\s.*\s(${match}^-\s*) / ) {
-	    warn "Option name '--$abbrev' is not unique: " .
-	      "--$1 --$2 \n";
-	    next ELT;
-	  }
-	  $name = $n0;
-	  $opt = "--$n0";
-	} elsif ( $Opts_Cmdline_Long_Str =~ /\s(${match}^\s*)\s/ ) {
-	  # option is an abbreviation with further -
-	  my $n0 = $1;
-	  if ( $Opts_Cmdline_Long_Str =~
-	       /\s(${match}^\s*)\s.*\s(${match}^\s*)\s/ ) {
-	    warn "Option name '--$abbrev' is not unique: " .
-	      "--$1 --$2 \n";
-	    next ELT;
-	  }
-	  $name = $n0;
-	  $opt = "--$n0";
-	} else {
-	  warn "Option '--$abbrev' does not exist.\n";
-	  next ELT;
-	}
-### main_config_params()
-	if ( $Opts_Cmdline_Long{$opt} ) { # option has arg
-	  if (defined $arg) {
-	    push @argv, "--$name", $arg;
-	    next ELT;
-	  } else { # $arg not defined, argument at next	element
-	    if (($i == $n1) || ($i > $n)) {
-	      warn "No argument left for option " .
-		"'$elt' at $s$j.\n";
-	      next ELT; }
-	    # add argument as next element
-	    push @argv, "--$name", $argv0$i;
-	    ++$i;
-	    next ELT;
-	  }		# if (defined $arg)
-	} else {	# option has no arg
-	  if (defined $arg) {
-	    warn "Option '$abbrev' may not have an argument " .
-	      "at $s$j.\n";
-	    next ELT;
-	  } else {
-	    push @argv, "--$name";
-	    next ELT;
-	  }
-	}		# if ($Opts_Cmdline_Long{$opt})
-### main_config_params()
-      } elsif ( $elt =~ /^-^-/ ) { # short option or cluster
-	my $cluster = $elt;
-	$cluster =~ s/^-//;
-	while ($cluster) {
-	  $cluster =~ s/^(.)//;
-	  my $opt = "-$1";
-	  if ( exists $Opts_Cmdline_Short{$opt} ) {	# opt exists
-	    if ( $Opts_Cmdline_Short{$opt} ) {		# with arg
-	      if ($cluster) {	# has argument in this element
-		$cluster =~ s/^\s//;
-		$cluster =~ s/\'\"//g;
-		# add argument as rest of this element
-		push @argv, $opt, $cluster;
-		next ELT;
-	      } else { # argument at next element
-		if (($i == $n1) || ($i > $n)) {
-		  warn "No argument left for option " .
-		    "'$opt' at $s$j.\n";
-		  next ELT; }
-### main_config_params()
-		# add argument as next element
-		push @argv, $opt, $argv0$i;
-		++$i;
-		next ELT;
-	      }
-	    } else { # no arg
-	      push @argv, $opt; next;
-	    }
-	  } else { # short option does not exist
-	    warn "Wrong short option '$opt' at $s$j.\n";
-	    next ELT;
-	  }		# if (exists $Opts_Cmdline_Short{$opt})
-	}		# while ($cluster)
-      } else {		# not an option, file name
-	push @Filespecs, $elt;
-	next;
-      }
-    }
-### main_config_params()
-    @Options = (@Manopt, @conf_args, @argv);
-    foreach my $i ( 0..$#Options ) {
-      if ( exists $Opts_Cmdline_Double{$Options$i} ) {
-	$Options$i = $Opts_Cmdline_Double{ $Options$i };
-      }
-    } @Filespecs = ('-') unless (@Filespecs);
-    @ARGV = (@Options, '--', @Filespecs);
-  }
-} # main_config_params()
-
-
-########################################################################
-# main_parse_params()
-########################################################################
-
-sub main_parse_params {
-  # options that are ignored in this part
-  # shell version of groffer: --debug*, --shell
-  # man options: --catman (only special in man),
-  #		 --preprocessor (force groff preproc., handled by grog),
-  #		 --prompt (prompt for less, ignored),
-  #		 --troff (-mandoc, handled by grog),
-  #		 --update (inode check, ignored)
-  our %Opt;
-  our %Man;
-  our %Debug;
-  our %Opts_Cmdline_Short;
-  our %Opts_Cmdline_Double;
-  our %Opts_Cmdline_Long;
-  our %Opts_Groff_Short;
-  our $i;
-  our $n;
-  our @Starting_ARGV;
-  our @Starting_Conf;
-  our @Default_Modes;
-  our @Addopts_Groff;
-  our @Options;
-
-  my %ignored_opts = (
-		      '--catman' => 0,
-		      '--debug-func' => 0,
-		      '--debug-not-func' => 0,
-		      '--debug-lm' => 0,
-		      '--debug-shell' => 0,
-		      '--debug-stacks' => 0,
-		      '--debug-user' => 0,
-		      '--preprocessor' => 1,
-		      '--prompt' => 1,
-		      '--shell' => 1,
-		      '--troff' => 0,
-		      '--update' => 0,
-		     );
-
-### main_parse_params()
-  my %long_opts =
-    (
-     '--debug' =>
-     sub { $Debug{$_} = 1 foreach (qw/FILENAMES GROG KEEP PARAMS TMPDIR/); },
-     '--debug-filenames' => sub { $Debug{'FILENAMES'} = 1; },
-     '--debug-grog' => sub { $Debug{'GROG'} = 1; },
-     '--debug-keep' => sub { $Debug{'KEEP'} = 1; $Debug{'PARAMS'} = 1; },
-     '--debug-params' => sub { $Debug{'PARAMS'} = 1; },
-     '--debug-tmpdir' => sub { $Debug{'TMPDIR'} = 1; },
-     '--help' => sub { &usage(); $Opt{'DO_NOTHING'} = 1; },
-     '--source' => sub { $Opt{'MODE'} = 'source'; },
-     '--device' =>
-     sub { $Opt{'DEVICE'} = &_get_arg();
-	   my %modes = (
-			'ascii' => 'tty',
-			'cp1047' => 'tty',
-			'dvi'=> 'dvi',
-			'html' => 'html',
-			'xhtml' => 'html',
-			'latin1' => 'tty',
-			'lbp' => 'groff',
-			'lj4' => 'groff',
-			'pdf' => 'pdf',
-			'pdf2' => 'pdf2',
-			'ps' => 'ps',
-			'utf8' => 'tty',
-		       );
-	    if ($Opt{'DEVICE'} =~ /^X.*/) {
-	      $Opt{'MODE'} = 'x';
-	    } elsif ( exists $modes{ $Opt{'DEVICE'} } ) {
-	      if ( $modes{ $Opt{'DEVICE'} } eq 'tty' ) {
-		$Opt{'MODE'} = 'tty'
-		  unless ($Opt{'MODE'} eq 'text');
-	      } else {
-		$Opt{'MODE'} = $modes{ $Opt{'DEVICE'} };
-	      }
-	    } else {
-	      # for all elements not in %modes
-	      $Opt{'MODE'} = 'groff';
-	    }
-	  },
-### main_parse_params()
-     '--version' => sub { &version(); $Opt{'DO_NOTHING'} = 1; },
-     '--intermediate-output' => sub { $Opt{'Z'} = 1; },
-     '--all' => sub { $Opt{'ALL'} = 1; },
-     '--apropos' =>		# run apropos
-     sub { $Opt{'APROPOS'} = 1;
-	   delete $Opt{'APROPOS_SECTIONS'};
-	   delete $Opt{'WHATIS'}; },
-     '--apropos-data' =>	# run apropos for data sections
-     sub { $Opt{'APROPOS'} = 1;
-	   $Opt{'APROPOS_SECTIONS'} = '457';
-	   delete $Opt{'WHATIS'}; },
-     '--apropos-devel' =>	# run apropos for devel sections
-     sub { $Opt{'APROPOS'} = 1;
-	   $Opt{'APROPOS_SECTIONS'} = '239';
-	   delete $Opt{'WHATIS'}; },
-     '--apropos-progs' =>	# run apropos for prog sections
-     sub { $Opt{'APROPOS'} = 1;
-	   $Opt{'APROPOS_SECTIONS'} = '168';
-	   delete $Opt{'WHATIS'}; },
-     '--ascii' =>
-     sub { push @Addopts_Groff, '-mtty-char';
-	   $Opt{'MODE'} = 'text' unless $Opt{'MODE'}; },
-     '--auto' =>		# the default automatic mode
-     sub { delete $Opt{'MODE'}; },
-     '--bordercolor' =>		# border color for viewers, arg
-     sub { $Opt{'BD'} = &_get_arg(); },
-     '--background' =>		# background color for viewers, arg
-     sub { $Opt{'BG'} = &_get_arg(); },
-### main_parse_params()
-     '--borderwidth' =>		# border width for viewers, arg
-     sub { $Opt{'BW'} = &_get_arg(); },
-     '--default' =>		# reset variables to default
-     sub { %Opt = (); },
-     '--default-modes' =>	# sequence of modes in auto mode; arg
-     sub { $Opt{'DEFAULT_MODES'} = &_get_arg(); },
-     '--display' =>		# set X display, arg
-     sub { $Opt{'DISPLAY'} = &_get_arg(); },
-     '--do-nothing' => sub { $Opt{'DO_NOTHING'} = 1; },
-     '--dvi' => sub { $Opt{'MODE'} = 'dvi'; },
-     '--extension' =>		# the extension for man pages, arg
-     sub { $Opt{'EXTENSION'} = &_get_arg(); },
-     '--foreground' =>		# foreground color for viewers, arg
-     sub { $Opt{'FG'} = &_get_arg(); },
-     '--font' =>		# set font for viewers, arg
-     sub { $Opt{'FN'} = &_get_arg(); },
-     '--geometry' =>		# window geometry for viewers, arg
-     sub { $Opt{'GEOMETRY'} = &_get_arg(); },
-     '--groff' => sub { $Opt{'MODE'} = 'groff'; },
-     '--html' => sub { $Opt{'MODE'} = 'html'; },
-     '--iconic' =>		# start viewers as icons
-     sub { $Opt{'ICONIC'} = 1; },
-     '--locale' =>		# set language for man pages, arg
-     # argument is xx_territory.codeset@modifier (ISO 639,...)
-     sub { $Opt{'LANG'} = &_get_arg(); },
-     '--local-file' =>		# force local files; same as '--no-man'
-     sub { delete $Man{'ENABLE'}; delete $Man{'FORCE'}; },
-     '--location' =>		# print file locations to stderr
-     sub { $Opt{'LOCATION'} = 1; },
-### main_parse_params()
-     '--man' =>			# force all file params to be man pages
-     sub { $Man{'ENABLE'} = 1; $Man{'FORCE'} = 1; },
-     '--manpath' =>		# specify search path for man pages, arg
-     # arg is colon-separated list of directories
-     sub { $Opt{'MANPATH'} = &_get_arg(); },
-     '--mode' =>		# display mode
-     sub { my $arg = &_get_arg();
-	   my %modes = ( '' => '',
-			 'auto' => '',
-			 'groff' => 'groff',
-			 'html' => 'html',
-			 'www' => 'html',
-			 'dvi' => 'dvi',
-			 'pdf' => 'pdf',
-			 'pdf2' => 'pdf2',
-			 'ps' => 'ps',
-			 'text' => 'text',
-			 'tty' => 'tty',
-			 'X' => 'x',
-			 'x' => 'x',
-			 'Q' => 'source',
-			 'source' => 'source',
-		       );
-	   if ( exists $modes{$arg} ) {
-	     if ( $modes{$arg} ) {
-	       $Opt{'MODE'} = $modes{$arg};
-	     } else {
-	       delete $Opt{'MODE'};
-	     }
-	   } else {
-	     warn "Unknown mode in '$arg' for --mode\n";
-	   }
-	 },
-### main_parse_params()
-     '--no-location' =>		# disable former call to '--location'
-     sub { delete $Opt{'LOCATION'}; },
-     '--no-man' =>		# disable search for man pages
-     sub { delete $Man{'ENABLE'}; delete $Man{'FORCE'}; },
-     '--no-special' =>		# disable some special former calls
-     sub { delete $Opt{'ALL'}; delete $Opt{'APROPOS'};
-	   delete $Opt{'WHATIS'}; },
-     '--pager' =>		# set paging program for tty mode, arg
-     sub { $Opt{'PAGER'} = &_get_arg(); },
-     '--pdf' => sub { $Opt{'MODE'} = 'pdf'; },
-     '--pdf2' => sub { $Opt{'MODE'} = 'pdf2'; },
-     '--print' =>		# print argument, for argument test
-     sub { my $arg = &_get_arg; print STDERR $arg . "\n"; },
-     '--ps' => sub { $Opt{'MODE'} = 'ps'; },
-     '--resolution' =>		# set resolution for X devices, arg
-     sub { my $arg = &_get_arg();
-	   my %res = ( '75' => 75,
-		       '75dpi' => 75,
-		       '100' => 100,
-		       '100dpi' => 100,
-		     );
-	   if (exists $res{$arg}) {
-	     $Opt{'RESOLUTION'} = $res{$arg};
-	   } else {
-	     warn "--resolution allows only 75, 75dpi, " .
-	       "100, 100dpi as argument.\n";
-	   }
-	 },
-### main_parse_params()
-     '--rv' => sub { $Opt{'RV'} = 1; },
-     '--sections' =>		# specify sections for man pages, arg
-     # arg is a ':'-separated (colon) list of section names
-     sub { my $arg = &_get_arg();
-	   my @arg = split /:/, $arg;
-	   my $s;
-	   foreach (@arg) {
-	     /^(.)/;
-	     my $c = $1;
-	     if ($Man{'AUTO_SEC_CHARS'} =~ /$c/) {
-	       $s .= $c;
-	     } else {
-	       warn "main_parse_params(): not a man section '$c';";
-	     }
-	   }
-	   $Opt{'SECTIONS'} = $s; },
-     '--systems' =>		# man pages for different OS's, arg
-     # argument is a comma-separated list
-     sub { $Opt{'SYSTEMS'} = &_get_arg(); },
-     '--text' =>		# text mode without pager
-     sub { $Opt{'MODE'} = 'text'; },
-     '--title' =>		# title for X viewers; arg
-     sub { my $arg = &_get_arg();
-	   if ($arg) {
-	     if ( $Opt{'TITLE'} ) {
-	       $Opt{'TITLE'} = "$Opt{'TITLE'} $arg";
-	     } else {
-	       $Opt{'TITLE'} = $arg;
-	     }
-	   }
-	 },
-     '--text-device' =>		# device for tty mode; arg
-     sub { $Opt{'TEXT_DEVICE'} = &_get_arg(); },
-     '--to-stdout' =>		# print mode file without display
-     sub { $Opt{'STDOUT'} = 1; },
-     '--tty' =>			# tty mode, text with pager
-     sub { $Opt{'MODE'} = 'tty'; },
-     '--viewer' =>		# viewer for actiual mode
-     sub { $Opt{'VIEWER'} = &_get_arg(); },
-     '--whatis' => sub { delete $Opt{'APROPOS'}; $Opt{'WHATIS'} = 1; },
-     '--x' => sub { $Opt{'MODE'} = 'x'; },
-### main_parse_params()
-     '--xrm' =>			# pass X resource string, arg
-     sub { my $arg = &_get_arg(); push @{$Opt{'XRM'}}, $arg if $arg; },
-    );
-
-#     '--dvi-viewer' =>		# viewer program for dvi mode; arg
-#     sub { $Opt{'VIEWER_DVI'} = &_get_arg(); },
-#     '--html-viewer' =>		# viewer program for html mode; arg
-#     sub { $Opt{'VIEWER_HTML'} = &_get_arg(); },
-#     '--pdf-viewer' =>		# viewer program for pdf and pdf2 mode; arg
-#     sub { $Opt{'VIEWER_PDF'} = &_get_arg(); },
-#     '--ps-viewer' =>		# viewer program for ps mode; arg
-#     sub { $Opt{'VIEWER_PS'} = &_get_arg(); },
-#     '--x-viewer' =>		# viewer program for x mode; arg
-#     sub { $Opt{'VIEWER_X'} = &_get_arg(); },
-
-  my %short_opts = (
-		    '-V' => sub { $Opt{'V'} = 1; },
-		    '-X' => sub { $Opt{'X'} = 1; },
-		   );
-
-  if (0) {
-    # check if all options are handled in parse parameters
-
-    # short options
-    my %these_opts = (%ignored_opts, %short_opts, %Opts_Groff_Short,
-		      %Opts_Cmdline_Double);
-    foreach my $key (keys %Opts_Cmdline_Short) {
-      warn "unused option: $key" unless exists $these_opts{$key};
-    }
-
-    # long options
-    %these_opts = (%ignored_opts, %long_opts, %Opts_Cmdline_Double);
-    foreach my $key (keys %Opts_Cmdline_Long) {
-      warn "unused option: $key" unless exists $these_opts{$key};
-    }
-  }				# if (0)
-
-### main_parse_params()
- OPTION: while ($i <= $n) {
-    my $opt = $Options$i;
-    ++$i;
-    if ($opt =~ /^-(^-)$/) {	# single minus for short option
-      if (exists $short_opts{$opt}) { # short option handled by hash
-	$short_opts{$opt}->();
-	next OPTION;
-      } else {			# $short_opts{$opt} does not exist
-	my $c = $1;		# the option character
-	next OPTION unless $c;
-	if ( exists $Opts_Groff_Short{ $opt } ) { # groff short option
-	  if ( $Opts_Groff_Short{ $opt } ) { # option has argument
-	    my $arg = $Options$i;
-	    ++$i;
-	    push @Addopts_Groff, $opt, $arg;
-	    next OPTION;
-	  } else {		# no argument for this option
-	    push @Addopts_Groff, $opt;
-	    next OPTION;
-	  }
-	} elsif ( exists $Opts_Cmdline_Short{ $opt } ) {
-	  # is a groffer short option
-	  warn "Groffer option $opt not handled " .
-	    "in parameter parsing";
-	} else {
-	  warn "$opt is not a groffer option.\n";
-	}
-      }				# if (exists $short_opts{$opt})
-    }				# if ($opt =~ /^-(^-)$/)
-    # now it is a long option
-
-    # handle ignored options
-    if ( exists $ignored_opts{ $opt } ) {
-      ++$i if ( $ignored_opts{ $opt } );
-      next OPTION;
-    }
-### main_parse_params()
-
-    # handle normal long options
-    if (exists $long_opts{$opt}) {
-      $long_opts{$opt}->();
-    } else {
-      warn "Unknown option $opt.\n";
-    }
-    next OPTION;
-  }				# while ($i <= $n)
-
-  if ($Debug{'PARAMS'}) {
-    print STDERR '$MANOPT: ' . $ENV{'MANOPT'} . "\n" if $ENV{'MANOPT'};
-    foreach (@Starting_Conf) {
-      print STDERR "configuration: " . $_ . "\n";
-    }
-    print STDERR '$GROFFER_OPT: ' . $ENV{'GROFFER_OPT'} . "\n"
-      if $ENV{'GROFFER_OPT'};
-    print STDERR "command line: @Starting_ARGV\n";
-    print STDERR "parameters: @ARGV\n";
-  }
-
-  if ( $Opt{'WHATIS'} ) {
-    die "main_parse_params(): cannot handle both 'whatis' and 'apropos';"
-      if $Opt{'APROPOS'};
-    $Man{'ALL'} = 1;
-    delete $Opt{'APROPOS_SECTIONS'};
-  }
-
-  if ( $Opt{'DO_NOTHING'} ) {
-    exit;
-  }
-
-  if ( $Opt{'DEFAULT_MODES'} ) {
-    @Default_Modes = split /,/, $Opt{'DEFAULT_MODES'};
-  }
-}				# main_parse_params()
-
-
-sub _get_arg {
-  our $i;
-  our $n;
-  our @Options;
-  if ($i > $n) {
-    die '_get_arg(): No argument left for last option;';
-  }
-  my $arg = $Options$i;
-  ++$i;
-  $arg;
-}				# _get_arg() of main_parse_params()
-
-
-########################################################################
-# main_set_mode()
-########################################################################
-
-sub main_set_mode {
-  our %Opt;
-
-  our @Default_Modes;
-  our @Addopts_Groff;
-
-  our $Viewer_Background;
-  our $PDF_Did_Not_Work;
-  our $PDF_Has_gs;
-  our $PDF_Has_ps2pdf;
-  our %Display = ('MODE' => '',
-		  'PROG' => '',
-		  'ARGS' => ''
-		 );
-
-  my @modes;
-
-  # set display
-  $ENV{'DISPLAY'} = $Opt{'DISPLAY'} if $Opt{'DISPLAY'};
-
-  push @Addopts_Groff, '-V' if $Opt{'V'};
-
-  if ( $Opt{'X'} ) {
-    $Display{'MODE'} = 'groff';
-    push @Addopts_Groff, '-X';
-  }
-
-  if ( $Opt{'Z'} ) {
-    $Display{'MODE'} = 'groff';
-    push @Addopts_Groff, '-Z';
-  }
-
-  $Display{'MODE'} = 'groff' if $Opt{'MODE'} and $Opt{'MODE'} eq 'groff';
-
-  return 1 if $Display{'MODE'} and $Display{'MODE'} eq 'groff';
-
-### main_set_mode()
-  if ($Opt{'MODE'}) {
-    if ($Opt{'MODE'} =~ /^(source|text|tty)$/) {
-      $Display{'MODE'} = $Opt{'MODE'};
-      return 1;
-    }
-    $Display{'MODE'} = $Opt{'MODE'} if $Opt{'MODE'} =~ /^x?html$/;
-    @modes = ($Opt{'MODE'});
-  } else {			# empty mode
-    if ($Opt{'DEVICE'}) {
-      if ($Opt{'DEVICE'} =~ /^X/) {
-	&is_X() || die "no X display found for device $Opt{'DEVICE'}";
-	$Display{'MODE'} = 'x';
-	return 1;
-      }
-      ;
-      if ($Opt{'DEVICE'} =~ /^(ascii|cp1047|latin1|utf8)$/) {
-	$Display{'MODE'} ne 'text' and $Display{'MODE'} = 'tty';
-	return 1;
-      }
-      ;
-      unless (&is_X) {
-	$Display{'MODE'} = 'tty';
-	return 1;
-      }
-    }				# check device
-    @modes = @Default_Modes;
-  }				# check mode
-
-### main_set_mode()
- LOOP: foreach my $m (@modes) {
-    $Viewer_Background = 0;
-    if ($m =~ /^(test|tty|X)$/) {
-      $Display{'MODE'} = $m;
-      return 1;
-    } elsif ($m eq 'pdf') {
-      &_get_prog_args($m) ? return 1: next LOOP;
-    } elsif ($m eq 'pdf2') {
-      next LOOP if $PDF_Did_Not_Work;
-      $PDF_Has_gs = &where_is_prog('gs') ? 1 : 0
-	unless (defined $PDF_Has_gs);
-      $PDF_Has_ps2pdf = &where_is_prog('ps2pdf') ? 1 : 0
-	unless (defined $PDF_Has_ps2pdf);
-      if ( (! $PDF_Has_gs) and (! $PDF_Has_ps2pdf) ) {
-	$PDF_Did_Not_Work = 1;
-	next LOOP;
-      }
-
-      if (&_get_prog_args($m)) {
-	return 1;
-      } else {
-	$PDF_Did_Not_Work = 1;
-	next LOOP;
-      }
-    } else {			# other modes
-      &_get_prog_args($m) ? return 1 : next LOOP;
-    }				# if $m
-  }				# loop: foreach
-  die 'set mode: no suitable display mode found under ' .
-    join(', ', @modes) . ';' unless $Display{'MODE'};
-  die 'set mode: no viewer available for mode ' . $Display{'MODE'} . ';'
-    unless $Display{'PROG'};
-  0;
-} # main_set_mode()
-
-
-########################################################################
-# functions to main_set_mode()
-########################################################################
-
-##########
-# _get_prog_args(<MODE>)
-#
-# Simplification for loop in set mode.
-#
-# Globals in/out: $Viewer_Background
-# globals in    : $Opt{VIEWER}, $VIEWER_X{<MODE>},
-#                 $Viewer_tty{<MODE>}
-#
-## globals in    : $Opt{VIEWER_<MODE>}, $VIEWER_X{<MODE>},
-##                 $Viewer_tty{<MODE>}
-##
-sub _get_prog_args {
-  our %Opt;
-  our %Display;
-  our %Viewer_X;
-  our %Viewer_tty;
-
-  our $Viewer_Background;
-  my $n = @_;
-  die "_get_prog_args(): one argument is needed; you used $n;"
-    unless $n == 1;
-
-  my $mode = lc($_0);
-  my $MODE = uc($mode);
-  $MODE = 'PDF' if ( $MODE =~ /^PDF2$/ );
-
-  my $xlist = $Viewer_X{$MODE};
-  my $ttylist = $Viewer_tty{$MODE};
-
-#  my $vm = "VIEWER_${MODE";
-  my $vm = "VIEWER";
-  my $opt = $Opt{$vm};
-
-  if ($opt) {
-    my %prog = &where_is_prog($opt);
-    my $prog_ref = \%prog;
-    unless (%prog) {
-      warn "_get_prog_args(): '$opt' is not an existing program;";
-      return 0;
-    }
-
-    # $prog from $opt is an existing program
-
-### _get_prog_args() of main_set_mode()
-    if (&is_X) {
-      if ( &_check_prog_on_list($prog_ref, $xlist) ) {
-	$Viewer_Background = 1;
-      } else {
-	$Viewer_Background = 0;
-	&_check_prog_on_list($prog_ref, $ttylist);
-      }
-    } else {			# is not X
-      $Viewer_Background = 0;
-      &_check_prog_on_list($prog_ref, $ttylist);
-    }				# if is X
-  } else {			# $opt is empty
-    $Viewer_Background = 0;
-    my $x;
-    if (&is_X) {
-      $x = &_get_first_prog($xlist);
-      $Viewer_Background = 1 if $x;
-    } else {			# is not X
-      $x = &_get_first_prog($ttylist);
-    }				# test on X
-    $Display{'MODE'} = $mode if $x;
-    return $x;
-  }
-  $Display{'MODE'} = $mode;
-  return 1;
-} # _get_prog_args() of main_set_mode()
-
-
-##########
-# _get_first_prog(<prog_list_ref>)
-#
-# Retrieve from the elements of the list in the argument the first
-# existing program in $PATH.
-#
-# Local function of main_set_mode().
-#
-# Return  : '0' if not a part of the list, '1' if found in the list.
-#
-sub _get_first_prog {
-  our %Display;
-  my $n = @_;
-  die "_get_first_prog(): one argument is needed; you used $n;"
-    unless $n == 1;
-
-  foreach my $i (@{$_0}) {
-    next unless $i;
-    my %prog = &where_is_prog($i);
-    if (%prog) {
-      $Display{'PROG'} = $prog{'fullname'};
-      $Display{'ARGS'} = $prog{'args'};
-      return 1;
-    }
-  }
-  return 0;
-} # _get_first_prog() of main_set_mode()
-
-
-##########
-# _check_prog_on_list (<prog-hash-ref> <prog_list_ref>)
-#
-# Check whether the content of <prog-hash-ref> is in the list
-# <prog_list_ref>.
-# The globals are set correspondingly.
-#
-# Local function for main_set_mode().
-#
-# Arguments: 2
-#
-# Return  : '0' if not a part of the list, '1' if found in the list.
-# Output  : none
-#
-# Globals in    : $Viewer_X{<MODE>}, $Viewer_tty{<MODE>}
-# Globals in/out: $Display{'PROG'}, $Display{'ARGS'}
-#
-sub _check_prog_on_list {
-  our %Display;
-  my $n = @_;
-  die "_get_first_prog(): 2 arguments are needed; you used $n;"
-    unless $n == 2;
-
-  my %prog = %{$_0};
-
-  $Display{'PROG'} = $prog{'fullname'};
-  $Display{'ARGS'} = $prog{'args'};
-
-  foreach my $i (@{$_1}) {
-    my %p = &where_is_prog($i);
-    next unless %p;
-    next unless $Display{'PROG'} eq $p{'fullname'};
-    if ($p{'args'}) {
-      if ($Display{'ARGS'}) {
-	$Display{'ARGS'} = $p{'args'};
-      } else {
-	$Display{'ARGS'} = "$p{'args'} $Display{'ARGS'}";
-      }
-    }				# if args
-    return 1;
-  }				# foreach $i
-  # prog was not in the list
-  return 0;
-} # _check_prog_on_list() of main_set_mode()
-
-
-########################################################################
-# groffer temporary directory, main_temp()
-########################################################################
-
-sub main_temp {
-  our %Debug;
-  our $tmpdir;
-  our $fh_cat;
-  our $fh_stdin;
-  our $tmp_cat;
-  our $tmp_stdin;
-  my $template = 'groffer_' . "$$" . '_XXXX';
-  foreach ($ENV{'GROFF_TMPDIR'}, $ENV{'TMPDIR'}, $ENV{'TMP'}, $ENV{'TEMP'},
-	   $ENV{'TEMPDIR'}, File::Spec->catfile($ENV{'HOME'}, 'tmp')) {
-    if ($_ && -d $_ && -w $_) {
-      if ($Debug{'KEEP'}) {
-	eval { $tmpdir = tempdir( $template, DIR => "$_" ); };
-      } else {
-	eval { $tmpdir = tempdir( $template,
-				  CLEANUP => 1, DIR => "$_" ); };
-      }
-      last if $tmpdir;
-    }
-  }
-  $tmpdir = tempdir( $template, CLEANUP => 1, DIR => File::Spec->tmpdir )
-    unless ($tmpdir);
-
-  # see Lerning Perl, page 205, or Programming Perl, page 413
-  # $SIG{'INT'} is for Ctrl-C interruption
-  $SIG{'INT'} = sub { &clean_up(); die "interrupted..."; };
-  $SIG{'QUIT'} = sub { &clean_up(); die "quit..."; };
-
-  if ($Debug{'TMPDIR'}) {
-    if ( $Debug{'KEEP'}) {
-      print STDERR "temporary directory is kept: " . $tmpdir . "\n";
-    } else {
-      print STDERR "temporary directory will be cleaned: " .
-	$tmpdir . "\n";
-    }
-  }
-
-  # further argument: SUFFIX => '.sh'
-  if ($Debug{'KEEP'}) {
-    ($fh_cat, $tmp_cat) = tempfile(',cat_XXXX', DIR => $tmpdir);
-    ($fh_stdin, $tmp_stdin) = tempfile(',stdin_XXXX', DIR => $tmpdir);
-  } else {
-    ($fh_cat, $tmp_cat) = tempfile(',cat_XXXX', UNLINK => 1,
-				   DIR => $tmpdir);
-    ($fh_stdin, $tmp_stdin) = tempfile(',stdin_XXXX', UNLINK => 1,
-				       DIR => $tmpdir);
-  }
-}				# main_temp()
-
-
-########################################################################
-# subs needed for main_do_fileargs()
-########################################################################
-
-##########
-# register_file(<filename>)
-#
-# Write a found file and register the title element.
-#
-# Arguments: 1: a file name
-# Output: none
-#
-sub register_file {
-  our $tmp_stdin;
-  my $n = @_;
-  die "register_file(): one argument is needed; you used $n;"
-    unless $n == 1;
-  die 'register_file(): file name is empty;' unless $_0;
-
-  if ($_0 eq '-') {
-    &to_tmp($tmp_stdin) && &register_title('stdin');
-  } else {
-    &to_tmp($_0) && &register_title($_0);
-  }
-  1;
-}				# register_file()
-
-
-##########
-# register_title(<filespec>)
-#
-# Create title element from <filespec> and append to $_REG_TITLE_LIST.
-# Basename is created.
-#
-# Globals in/out: @REG_TITLE
-#
-# Variable prefix: rt
-#
-sub register_title {
-  our @REG_TITLE;
-  our %Debug;
-  my $n = @_;
-  die "register_title(): one argument is needed; you used $n;"
-    unless $n == 1;
-  return 1 unless $_0;
-
-  return 1 if scalar @REG_TITLE > 3;
-
-  my $title = &get_filename($_0);
-  $title =~ s/\s/_/g;
-  $title =~ s/\.bz2$//g;
-  $title =~ s/\.gz$//g;
-  $title =~ s/\.Z$//g;
-
-  if ($Debug{'FILENAMES'}) {
-    if ($_0 eq 'stdin') {
-      print STDERR "register_title(): file title is stdin\n";
-    } else {
-      print STDERR "register_title(): file title is $title\n";
-    }
-  }				# if ($Debug{'FILENAMES'})
-
-  return 1 unless $title;
-  push @REG_TITLE, $title;
-  1;
-}				# register_title()
-
-
-##########
-# save_stdin()
-#
-# Store standard input to temporary file (with decompression).
-#
-sub save_stdin {
-  our $tmp_stdin;
-  our $fh_stdin;
-  our $tmpdir;
-
-  our %Debug;
-
-  my ($fh_input, $tmp_input);
-  $tmp_input = File::Spec->catfile($tmpdir, ',input');
-  open $fh_input, ">$tmp_input" or
-    die "save_stdin(): could not open $tmp_input";
-  foreach (<STDIN>) {
-    print $fh_input $_;
-  }
-  close $fh_input;
-  open $fh_stdin, ">$tmp_stdin" or
-    die "save_stdin(): could not open $tmp_stdin";
-  foreach ( &cat_z("$tmp_input") ) {
-    print $fh_stdin $_;
-  }
-  close $fh_stdin;
-  unlink $tmp_input unless $Debug{'KEEP'};
-}	# save_stdin()
-
-
-########################################################################
-# main_do_fileargs()
-########################################################################
-
-sub main_do_fileargs {
-  our %Man;
-  our %Opt;
-
-  our @Filespecs;
-
-  our $Filespec_Arg;
-  our $Filespec_Is_Man;
-  our $Special_Filespec;
-  our $No_Filespecs;
-  our $Macro_Pkg;
-  our $Manspec;
-
-  &special_setup();
-  if ($Opt{'APROPOS'}) {
-    if ($No_Filespecs) {
-      &apropos_filespec();
-      return 1;
-    }
-  } else {
-    foreach (@Filespecs) {
-      if (/^-$/) {
-	&save_stdin();
-	last;
-      }
-    }				# foreach (@Filespecs)
-  }				# if ($Opt{'APROPOS'})
-
-  my $section = '';
-  my $ext = '';
-  my $twoargs = 0;
-  my $filespec;
-  my $former_arg;
-
- FILESPEC: foreach (@Filespecs) {
-    $filespec = $_;
-    $Filespec_Arg = $_;
-    $Filespec_Is_Man = 0;
-    $Manspec = '';
-    $Special_Filespec = 0;
-
-    next FILESPEC unless $filespec;
-
-### main_do_fileargs()
-    if ($twoargs) {		# second run
-      $twoargs = 0;
-      # $section and $ext are kept from earlier run
-      my $h = { 'name' => $filespec, 'sec' => $section, 'ext' => $ext };
-      &man_setup();
-      if ( &is_man($h) ) {
-	$Filespec_Arg = "$former_arg $Filespec_Arg";
-	&special_filespec();
-	$Filespec_Is_Man = 1;
-	&man_get($h);
-	next FILESPEC;
-      } else {
-	warn "main_do_fileargs(): $former_arg is neither a file nor a " .
-	  "man page nor a section argument for $filespec;";
-      }
-    }
-    $twoargs = 0;
-
-    if ( $Opt{'APROPOS'} ) {
-      &apropos_filespec();
-      next FILESPEC;
-    }
-
-    if ($filespec eq '-') {
-      &register_file('-');
-      &special_filespec();
-      next FILESPEC;
-    } elsif ( &get_filename($filespec) ne $filespec ) { # path with dir
-      &special_filespec();
-      if (-f $filespec && -r $filespec) {
-	&register_file($filespec)
-      } else {
-	warn "main_do_fileargs: the argument $filespec is not a file;";
-      }
-      next FILESPEC;
-    } else {			# neither '-' nor has dir
-      # check whether filespec is an existing file
-      unless ( $Man{'FORCE'} ) {
-	if (-f $filespec && -r $filespec) {
-	  &special_filespec();
-	  &register_file($filespec);
-	  next FILESPEC;
-	}
-      }
-    }				# if ($filespec eq '-')
-
-### main_do_fileargs()
-    # now it must be a man page pattern
-
-    if ($Macro_Pkg and $Macro_Pkg ne '-man') {
-      warn "main_do_fileargs(): $filespec is not a file, " .
-	"man pages are ignored due to $Macro_Pkg;";
-      next FILESPEC;
-    }
-
-    # check for man page
-    &man_setup();
-    unless ( $Man{'ENABLE'} ) {
-      warn "main_do_fileargs(): the argument $filespec is not a file;";
-      next FILESPEC;
-    }
-    my $errmsg;
-    if ( $Man{'FORCE'} ) {
-      $errmsg = 'is not a man page';
-    } else {
-      $errmsg = 'is neither a file nor a man page';
-    }
-
-    $Filespec_Is_Man = 1;
-
-### main_do_fileargs()
-    # test filespec with 'man:...' or '...(...)' on man page
-
-    my @names = ($filespec);
-    if ($filespec =~ /^man:(.*)$/) {
-      push @names, $1;
-    }
-
-    foreach my $i (@names) {
-      next unless $i;
-      my $h = { 'name' => $i };
-      if ( &is_man($h) ) {
-	&special_filespec();
-	&man_get($h);
-	next FILESPEC;
-      }
-      if ( $i =~ /^(.*)$($Man{'AUTO_SEC_CHARS'})(.*)$$/ ) {
-	$h = { 'name' => $1, 'sec' => $2, 'ext' => $3 };
-	if ( &is_man($h) ) {
-	  &special_filespec();
-	  &man_get($h);
-	  next FILESPEC;
-	}
-      }				# if //
-      if ( $i =~ /^(.*)\.($Man{'AUTO_SEC_CHARS'})(.*)$/ ) {
-	$h = { 'name' => $1, 'sec' => $2, 'ext' => $3 };
-	if ( &is_man($h) ) {
-	  &special_filespec();
-	  &man_get($h);
-	  next FILESPEC;
-	}
-      }				# if //
-    }				# foreach (@names)
-
-### main_do_fileargs()
-    # check on "s name", where "s" is a section with or without an extension
-    if ($filespec =~ /^($Man{'AUTO_SEC_CHARS'})(.*)$/) {
-      unless ( $Man{'ENABLE'} ) {
-	warn "main_do_fileargs(): $filespec $errmsg;";
-	next FILESPEC;
-      }
-      $twoargs = 1;
-      $section = $1;
-      $ext = $2;
-      $former_arg = $filespec;
-      next FILESPEC;
-    } else {
-      warn "main_do_fileargs(): $filespec $errmsg;";
-      next FILESPEC;
-    }
-  }	# foreach (@Filespecs)
-
-  if ( $twoargs ) {
-    warn "main_do_fileargs(): no filespec arguments left for second run;";
-    return 0;
-  }
-  1;
-}	# main_do_fileargs()
-
-
-########################################################################
-# main_set_resources()
-########################################################################
-
-##########
-# main_set_resources ()
-#
-# Determine options for setting X resources with $_DISPLAY_PROG.
-#
-# Globals: $Display{PROG}, $Output_File_Name
-#
-sub main_set_resources {
-  our %Opt;
-  our %Display;
-  our %Debug;
-
-  our @REG_TITLE;
-
-  our $Default_Resolution;
-  our $tmp_stdin;
-  our $tmpdir;
-  our $Output_File_Name;
-
-  # $prog   viewer program
-  # $rl     resource list
-  unlink $tmp_stdin unless $Debug{'KEEP'};
-  $Output_File_Name = '';
-
-  my @title = @REG_TITLE;
-  @title = ($Opt{'TITLE'}) unless @title;
-  @title = () unless @title;
-
-  foreach my $n (@title) {
-    next unless $n;
-    $n =~ s/^,+// if $n =~ /^,/;
-    next unless $n;
-    $Output_File_Name = $Output_File_Name . ',' if $Output_File_Name;
-    $Output_File_Name = "$Output_File_Name$n";
-  }				# foreach (@title)
-
-  $Output_File_Name =~ s/^,+//;
-  $Output_File_Name = '-' unless $Output_File_Name;
-  $Output_File_Name = File::Spec->catfile($tmpdir, $Output_File_Name);
-
-### main_set_resources()
-  unless ($Display{'PROG'}) {	# for example, for groff mode
-    $Display{'ARGS'} = '';
-    return 1;
-  }
-
-  my %h = &where_is_prog($Display{'PROG'});
-  my $prog = $h{'file'};
-  if ($Display{'ARGS'}) {
-    $Display{'ARGS'} = "$h{'args'} $Display{'ARGS'}";
-  } else {
-    $Display{'ARGS'} = $h{'args'};
-  }
-
-  my @rl = ();
-
-  if ($Opt{'BD'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-bd', $Opt{'BD'};
-    }
-  }
-
-  if ($Opt{'BG'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-bg', $Opt{'BG'};
-    } elsif ($prog eq 'kghostview') {
-      push @rl, '--bg', $Opt{'BG'};
-    } elsif ($prog eq 'xpdf') {
-      push @rl, '-papercolor', $Opt{'BG'};
-    }
-  }
-
-### main_set_resources()
-  if ($Opt{'BW'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-bw', $Opt{'BW'};
-    }
-  }
-
-  if ($Opt{'FG'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-fg', $Opt{'FG'};
-    } elsif ($prog eq 'kghostview') {
-      push @rl, '--fg', $Opt{'FG'};
-    }
-  }
-
-  if ($Opt{'FN'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-fn', $Opt{'FN'};
-    } elsif ($prog eq 'kghostview') {
-      push @rl, '--fn', $Opt{'FN'};
-    }
-  }
-
-  if ($Opt{'GEOMETRY'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-geometry', $Opt{'GEOMETRY'};
-    } elsif ($prog eq 'kghostview') {
-      push @rl, '--geometry', $Opt{'GEOMETRY'};
-    }
-  }
-
-### main_set_resources()
-  if ($Opt{'RESOLUTION'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-resolution', $Opt{'RESOLUTION'};
-    } elsif ($prog eq 'xpdf') {
-      if ($Display{'PROG'} !~ / -z/) { # if xpdf does not have option -z
-	if ($Default_Resolution == 75) {
-	  push @rl, '-z', 104;
-	} elsif ($Default_Resolution == 100) { # 72dpi is '100'
-	  push @rl, '-z', 139;
-	}
-      }
-    }				# if $prog
-  } else {			# empty $Opt{RESOLUTION}
-    $Opt{'RESOLUTION'} = $Default_Resolution;
-    if ($prog =~ /^(gxditview|xditview)$/) {
-      push @rl, '-resolution', $Default_Resolution;
-    } elsif ($prog eq 'xpdf') {
-      if ($Display{'PROG'} !~ / -z/) { # if xpdf does not have option -z
-	if ($Default_Resolution == 75) {
-	  push @rl, '-z', 104;
-	} elsif ($Default_Resolution == 100) { # 72dpi is '100'
-	  push @rl, '-z', 139;
-	}
-      }
-    }				# if $prog
-  }				# if $Opt{RESOLUTION}
-
-  if ($Opt{'ICONIC'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-iconic';
-    }
-  }
-
-### main_set_resources()
-  if ($Opt{'RV'}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi)$/) {
-      push @rl, '-rv';
-    }
-  }
-
-  if (@{$Opt{'XRM'}}) {
-    if ($prog =~ /^(ghostview|gv|gxditview|xditview|xdvi|xpdf)$/) {
-      foreach (@{$Opt{'XRM'}}) {
-	push @rl, '-xrm', $_;
-      }
-    }
-  }
-
-  if (@title) {
-    if ($prog =~ /^(gxditview|xditview)$/) {
-      push @rl, '-title', $Output_File_Name;
-    }
-  }
-
-  my $args = join ' ', @rl;
-  if ($Display{'ARGS'}) {
-    $Display{'ARGS'} = "$args $Display{'ARGS'}";
-  } else {
-    $Display{'ARGS'} = $args;
-  }
-
-  1;
-}				# main_set_resources()
-
-
-########################################################################
-# set resources
-########################################################################
-
-##########
-# main_display ()
-#
-# Do the actual display of the whole thing.
-#
-# Globals:
-#   in: $Display{MODE}, $Opt{DEVICE}, @Addopts_Groff,
-#       $fh_cat, $tmp_cat, $Opt{PAGER}, $Output_File_Name
-#
-sub main_display {
-  our ( %Display, %Opt, %Debug, %Viewer_tty, %Viewer_X );
-
-  our @Addopts_Groff;
-
-  our ( $groggy, $modefile, $addopts, $fh_cat, $tmp_cat, $tmpdir );
-  our ( $Output_File_Name, $Default_tty_Device );
-
-  $addopts = join ' ', @Addopts_Groff;
-
-  if (-z $tmp_cat) {
-    warn "groffer: empty input\n";
-    &clean_up();
-    return 1;
-  }
-
-  $modefile = $Output_File_Name;
-
-  # go to the temporary directory to be able to access internal data files
-  chdir $tmpdir;
-
-### main_display()
- SWITCH: foreach ($Display{'MODE'}) {
-    /^groff$/ and do {
-      push @Addopts_Groff, "-T$Opt{'DEVICE'}" if $Opt{'DEVICE'};
-      $addopts = join ' ', @Addopts_Groff;
-      $groggy = `cat $tmp_cat | grog`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_opt_V();
-      unlink $modefile;
-      rename $tmp_cat, $modefile;
-      system("cat $modefile | $groggy $addopts");
-      &clean_up();
-      next SWITCH;
-    };				# /groff/
-
-    /^(text|tty)$/ and do {
-      my $device;
-      if (! $Opt{'DEVICE'}) {
-	$device = $Opt{'TEXT_DEVICE'};
-	$device = $Default_tty_Device unless $device;
-      } elsif ($Opt{'DEVICE'} =~ /^(ascii||cp1047|latin1|utf8)$/) {
-	$device = $Opt{'DEVICE'};
-      } else {
-	warn "main_display(): wrong device for $Display{'MODE'} mode: " .
-	  "$Opt{'DEVICE'}";
-      }
-      $groggy = `cat $tmp_cat | grog -T$device`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: " . $groggy . "\n" if $Debug{'GROG'};
-      if ($Display{'MODE'} eq 'text') {
-	&_do_opt_V();
-	system("cat $tmp_cat | $groggy $addopts");
-	&clean_up();
-	next SWITCH;
-      }
-
-### main_display()
-      # mode is not 'text', but 'tty'
-      my %pager;
-      my @p;
-      push @p, $Opt{'PAGER'} if $Opt{'PAGER'};
-      push @p, $ENV{'PAGER'} if $ENV{'PAGER'};
-      foreach (@p) {
-	%pager = &where_is_prog($_);
-	next unless %pager;
-	if ($pager{'file'} eq 'less') {
-	  if ($pager{'args'}) {
-	    $pager{'args'} = "-r -R $pager{'args'}";
-	  } else {
-	    $pager{'args'} = '-r -R';
-	  }
-	}
-	last if $pager{'file'};
-      }				# foreach @p
-      unless (%pager) {
-	foreach (@{$Viewer_tty{'TTY'}}, @{$Viewer_X{'TTY'}}, 'cat') {
-	  next unless $_;
-	  %pager = &where_is_prog($_);
-	  last if %pager;
-	}
-      }
-      die "main_display(): no pager program found for tty mode;"
-	unless %pager;
-      &_do_opt_V();
-      system("cat $tmp_cat | $groggy $addopts | " .
-	     "$pager{'fullname'} $pager{'args'}");
-      &clean_up();
-      next SWITCH;
-    };				# /text|tty/
-
-    /^source$/ and do {
-      open $fh_cat, "<$tmp_cat";
-      foreach (<$fh_cat>) {
-	print "$_";
-      }
-      &clean_up();
-      next SWITCH;
-    };
-
-### main_display()
-    /^dvi$/ and do {
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} ne 'dvi') {
-	warn "main_display(): " .
-	  "wrong device for $Display{'MODE'} mode: $Opt{'DEVICE'};"
-      }
-      $modefile .= '.dvi';
-      $groggy = `cat $tmp_cat | grog -Tdvi`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-    /^html$/ and do {
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} ne 'html') {
-	warn "main_display(): " .
-	  "wrong device for $Display{'MODE'} mode: $Opt{'DEVICE'};"
-      }
-      $modefile .= '.html';
-      $groggy = `cat $tmp_cat | grog -Thtml`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-    /^xhtml$/ and do {
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} ne 'xhtml') {
-	warn "main_display(): " .
-	  "wrong device for $Display{'MODE'} mode: $Opt{'DEVICE'};"
-      }
-      $modefile .= '.xhtml';
-      $groggy = `cat $tmp_cat | grog -Txhtml`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-
-    /^pdf$/ and do {
-      $modefile .= '.pdf';
-      $groggy = `cat $tmp_cat | grog -Tpdf --ligatures`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-
-    /^pdf2$/ and do {
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} ne 'ps') {
-	warn "main_display(): " .
-	  "wrong device for $Display{'MODE'} mode: $Opt{'DEVICE'};"
-      }
-      $modefile .= '.ps';
-      $groggy = `cat $tmp_cat | grog -Tps`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display(\&_make_pdf2);
-      next SWITCH;
-    };
-
-### main_display()
-    /^ps$/ and do {
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} ne 'ps') {
-	warn "main_display(): " .
-	  "wrong device for $Display{'MODE'} mode: $Opt{'DEVICE'};"
-      }
-      $modefile .= '.ps';
-      $groggy = `cat $tmp_cat | grog -Tps`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-    /^x$/ and do {
-      my $device;
-      if ($Opt{'DEVICE'} && $Opt{'DEVICE'} =~ /^X/) {
-	$device = $Opt{'DEVICE'};
-      } else {
-	if ($Opt{'RESOLUTION'} == 100) {
-	  if ( $Display{'PROG'} =~ /^(g|)xditview$/ ) {
-	    # add width of 800dpi for resolution of 100dpi to the args
-	    $Display{'ARGS'} .= ' -geometry 800';
-	    $Display{'ARGS'} =~ s/^ //;
-	  }
-	} else {		# RESOLUTIOM != 100
-	  $device = 'X75-12';
-	}			# if RESOLUTIOM
-      }				# if DEVICE
-      $groggy = `cat $tmp_cat | grog -T$device -Z`;
-      die "main_display(): grog error;" if $?;
-      chomp $groggy;
-      print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      &_do_display();
-      next SWITCH;
-    };
-
-### main_display()
-    /^X$/ and do {
-      if (! $Opt{'DEVICE'}) {
-	$groggy = `cat $tmp_cat | grog -X`;
-	die "main_display(): grog error;" if $?;
-	chomp $groggy;
-	print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      } elsif ($Opt{'DEVICE'} =~ /^(X.*|dvi|html|xhtml|lbp|lj4|ps)$/) {
-	# these devices work with
-	$groggy = `cat $tmp_cat | grog -T$Opt{'DEVICE'} -X`;
-	die "main_display(): grog error;" if $?;
-	chomp $groggy;
-	print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      } else {
-	warn "main_display(): wrong device for " .
-	  "$Display{'MODE'} mode: $Opt{'DEVICE'};";
-	$groggy = `cat $tmp_cat | grog -Z`;
-	die "main_display(): grog error;" if $?;
-	chomp $groggy;
-	print STDERR "grog output: $groggy\n" if $Debug{'GROG'};
-      }				# if DEVICE
-      &_do_display();
-      next SWITCH;
-    };
-
-    /^.*$/ and do {
-      die "main_display(): unknown mode '$Display{'MODE'}';";
-    };
-
-  }				# SWITCH
-  1;
-} # main_display()
-
-
-########################
-# _do_display (<prog>)
-#
-# Perform the generation of the output and view the result.  If an
-# argument is given interpret it as a function name that is called in
-# the midst (actually only for 'pdf').
-#
-sub _do_display {
-  our ( %Display, %Debug, %Opt );
-
-  our ( $modefile, $tmpdir, $tmp_cat, $addopts, $groggy );
-  our ( $Viewer_Background );
-
-  &_do_opt_V();
-  unless ($Display{'PROG'}) {
-    system("$groggy $addopts $tmp_cat");
-    &clean_up();
-    return 1;
-  }
-  unlink $modefile;
-  die "_do_display(): empty output;" if -z $tmp_cat;
-  system("cat $tmp_cat | $groggy $addopts >$modefile");
-  die "_do_display(): empty output;" if -z $modefile;
-  &print_times("before display");
-  if ($_0 && ref($_0) eq 'CODE') {
-    $_0->();
-  }
-  unlink $tmp_cat unless $Debug{'KEEP'};
-
-  if ( $Opt{'STDOUT'} ) {
-    my $fh;
-    open $fh, "<$modefile";
-    foreach (<$fh>) {
-      print;
-    }
-    close $fh;
-    return 1;
-  }
-
-  if ( $Viewer_Background ) {
-    if ($Debug{'KEEP'}) {
-      exec "$Display{'PROG'} $Display{'ARGS'} $modefile &";
-    } else {
-      exec "{ $Display{'PROG'} $Display{'ARGS'} $modefile; " .
-	"rm -rf $tmpdir; } &";
-    }
-  } else {
-    system("$Display{'PROG'} $Display{'ARGS'} $modefile");
-    &clean_up();
-  }
-} # _do_display() of main_display()
-
-
-#############
-# _do_opt_V ()
-#
-# Check on option '-V'; if set print the corresponding output and leave.
-#
-# Globals: @ARGV, $Display{MODE}, $Display{PROG},
-#          $Display{ARGS}, $groggy,  $modefile, $addopts
-#
-sub _do_opt_V {
-  our %Opt;
-  our %Display;
-  our @ARGV;
-
-  our ($groggy, $modefile, $addopts);
-
-  if ($Opt{'V'}) {
-    $Opt{'V'} = 0;
-    print "Parameters: @ARGV\n";
-    print "Display Mode: $Display{'MODE'}\n";
-    print "Output file: $modefile\n";
-    print "Display prog: $Display{'PROG'} $Display{'ARGS'}\n";
-    print "Output of grog: $groggy $addopts\n";
-    my $res = `$groggy $addopts\n`;
-    chomp $res;
-    print "groff -V: $res\n";
-    exit 0;
-  }
-  1;
-} # _do_opt_V() of main_display()
-
-
-##############
-# _make_pdf2 ()
-#
-# Transform to ps/pdf format; for pdf2 mode in _do_display().
-#
-# Globals: $md_modefile (from main_display())
-#
-sub _make_pdf2 {
-  our %Debug;
-  our %Opt;
-
-  our $PDF_Did_Not_Work;
-  our $PDF_Has_gs;
-  our $PDF_Has_ps2pdf;
-  our $Dev_Null;
-  our $modefile;
-
-  die "_make_pdf2(): pdf2 mode did not work;" if $PDF_Did_Not_Work;
-  my $psfile = $modefile;
-  die "_make_pdf2(): empty output;" if -z $modefile;
-  $modefile =~ s/\.ps$/.pdf/;
-  unlink $modefile;
-  my $done;
-  if ($PDF_Has_ps2pdf) {
-    system("ps2pdf $psfile $modefile 2>$Dev_Null");
-    $done = ! $?;
-  }
-  if (! $done && $PDF_Has_gs) {
-    system("gs -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite " .
-       "-sOutputFile=$modefile -c save pop -f $psfile 2>$Dev_Null");
-    $done = ! $?;
-  }
-  if (! $done) {
-    $PDF_Did_Not_Work = 1;
-    warn '_make_pdf2(): Could not transform into pdf format, ' .
-      'the Postscript mode (ps) is used instead;';
-    $Opt{'MODE'} = 'ps';
-    &main_set_mode();
-    &main_set_resources();
-    &main_display();
-    exit 0;
-  }
-  unlink $psfile unless $Debug{'KEEP'};
-  1;
-} # _make_pdf2() of main_display()
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/man.pl Deleted

@@ -1,736 +0,0 @@
-#! /usr/bin/env perl
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/man.pl
-# Installed position: <prefix>/lib/groff/groffer/man.pl
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# This file is part of 'groffer', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-use strict;
-use warnings;
-
-########################################################################
-# functions for apropos, man, whatis
-########################################################################
-
-##########
-# apropos_filespec()
-#
-# Compose temporary file for filspec.
-#
-# Globals:  in: $main::Opt{'APROPOS'}, $main::Special_Setup, $main::Filespec_Arg,
-#               $main::Apropos_Prog, $main::Opt{'APROPOS_SECTIONS'}, $main::Opt{'SECTIONS'}
-#          out: $main::Special_Filespec
-#
-sub apropos_filespec {
-  return 0 unless $main::Opt{'APROPOS'};
-  die 'apropos_filespec(): apropos_setup() must be run first;'
-    unless $main::Special_Setup;
-  die 'apropos_filespec(): no $main::Filespec_Arg is set;'
-    unless defined $main::Filespec_Arg;
-  $main::Special_Filespec = 1;
-
-  my $s;
-  if ($main::No_Filespecs) {
-    &to_tmp_line('.SH no filespec');
-    $s = `$main::Apropos_Prog`;
-    $s =~ s/^/\\\&/;
-    &to_tmp_line($s);
-    return 1;
-  }
-
-  $s = $main::Filespec_Arg;
-  $s =~ s/^\\-/\\-/g;
-  &to_tmp_line(".SH $s");
-
-  if ( $main::Opt{'APROPOS_SECTIONS'} ) {
-    $s = qr/^^$*\($main::Opt{'APROPOS_SECTIONS'}/;
-  } else {
-    if ( $main::Opt{'SECTIONS'} ) {
-      $s = $main::Opt{'SECTIONS'};
-      $s = qr/^^\(*\($s/;
-    } else {
-      $s = qr/^.*\(.+$.*$/;
-    }
-  }
-
-### apropos_filespec()
-  my $filespec = $main::Filespec_Arg;
-  $filespec =~ s#/#\\/#g;
-  $filespec =~ s#\.#\\./#g;
-  my @ap;
-  foreach ( `$main::Apropos_Prog $main::Filespec_Arg 2>$main::Dev_Null` ) {
-    chomp;
-    if (/^$filespec:\s/) {	# for error messages of this script
-      my $line = $_;
-      $line =~ s/^(.*)$/\\\&$1/s;
-      push @ap, $line;
-    }
-    if (/$s/) {
-      push @ap, $_;
-    }
-  }
-  my @res;
-  foreach (sort @ap) {
-    s/^
-      (^$+\(+$main::Man{'AUTO_SEC_CHARS'}^$*\)+)
-      (\s*-*)*\s*
-      (.*)
-      $/.br\n.TP 15\n.BR "$1"\n\\\&$3\n/sx;
-    push @res, $_;
-  }
-  &to_tmp_line(@res);
-  1;
-}				# apropos_filespec()
-
-
-##########
-# apropos_setup()
-#
-# Setup for the --apropos* options, just 2 global variables are set.
-#
-# Globals:  in: $main::Opt{'APROPOS'}
-#          out: $main::Special_Setup, $main::Apropos_Prog
-#
-sub apropos_setup {
-  return 0 unless $main::Opt{'APROPOS'};
-  if ( &where_is_prog('apropos') ) {
-    $main::Apropos_Prog = 'apropos';
-  } elsif ( &where_is_prog('man') ) {
-    if (! system("man --apropos man >$main::Dev_Null 2>$main::Dev_Null")) {
-      $main::Apropos_Prog = 'man --apropos';
-    } elsif (! system("man -k man >$main::Dev_Null 2>$main::Dev_Null")) {
-      $main::Apropos_Prog = 'man --k';
-    }
-  }				# test man
-  die 'apropos_setup(): no apropos program available;'
-    unless $main::Apropos_Prog;
-  &to_tmp_line('.TH GROFFER APROPOS');
-  $main::Special_Setup = 1;
-  $main::Opt{'TITLE'} = 'apropos' unless $main::Opt{'TITLE'};
-  1;
-}				# apropos_setup()
-
-
-##########
-# is_man(<man_sec_ext-hash-ref>)
-#
-# Test whether the argument hash exists as man page (from is_man()).
-#
-# Globals: in: $main::Man{AUTO_SEC_CHARS},$main::Man{SEC_CHARS},
-#              $main::Man{EXT}, $tmpdir
-#         out: $main::Manspec
-#
-# Arguments: 1, a hash reference with keys 'name', 'sec', 'ext', where
-#               'sec' is a string of one or several section characters
-#
-sub is_man {
-  my $n = @_;
-  die "is_man(): one argument is needed, you used $n;"
-    unless $n == 1;
-  die "is_man(): the argument is not a hash reference '$_0';"
-    if ref($_0) ne 'HASH';
-  die 'is_man(): temporary directory is not set;' unless $main::tmpdir;
-  die 'is_man(): man_setup() must be run first;' unless $main::Man{'IS_SETUP'};
-
-  my $name = $_0->{'name'};
-  unless ($name) {
-    $main::Manspec = '';
-    return 0;
-  }
-
-  my $sec;
-  $sec = $_0->{'sec'};
-  $sec = $main::Man{'SEC_CHARS'} unless $sec;
-  $sec = $main::Man{'AUTO_SEC_CHARS'} unless $sec;
-  $sec = '' unless defined $sec;
-  # take care, $sec may be several sections
-
-### is_man()
-  my $ext;
-  $ext = $_0->{'ext'};
-  $ext = $main::Man{'EXT'} unless $ext;
-  $ext = '' unless defined $ext;
-
-  $main::Manspec = "$name.$sec,$ext";
-  my @m;
-  if (exists $main::Man{'MANSPEC'}{$main::Manspec}) {
-    return 1;
-  } else {
-    foreach my $p ( @{$main::Man{'PATH'}} ) {
-      foreach my $s (split //, $sec) {
-	my $dir = File::Spec->catdir($p, "man$s");
-	next unless -d $dir;
-	my $file = File::Spec->catfile($dir, "$name.$s$ext");
-	push @m, glob("$file*");
-      }
-    }
-    $main::Man{'MANSPEC'}{$main::Manspec} = \@m;
-  }
-  return 0 unless (@m);
-  return 1;
-} # is_man()
-
-
-##########
-# man_get (<man_sec_ext-hash-ref>)
-#
-# Write a man page to the temporary file.
-#
-# Globals in: $main::Manspec, $main::Man{MANSPEC}, $main::Man{SEC_CHARS},
-#             $main::Man{EXT}, $main::Man{ALL}
-#
-# Arguments: 1, a hash reference with keys 'name', 'sec', 'ext', where
-#               'sec' is a string of one or several section characters
-#
-sub man_get {
-  my $n = @_;
-  die "man_get(): one argument is needed, you used $n;"
-    unless $n == 1;
-  die "man_get(): the argument is not a hash reference '$_0';"
-    if ref($_0) ne 'HASH';
-  die "man_get(): is_man() must be run first on the argument;"
-    unless $main::Manspec;
-  die "man_get(): wrong hash reference '$_0', no 'name' key;"
-    unless exists $_0->{'name'};
-
-  my ($name, $sec, $ext, $f, $path);
-  $name = $_0->{'name'};
-  die "man_get(): empty 'name' key in the argument;" unless $name;
-
-  $sec = $_0->{'sec'};
-  $sec = $main::Man{'SEC_CHARS'} if (! $sec) and $main::Man{'SEC_CHARS'};
-  $sec = '' unless defined $sec;
-  # take care $sec may be several sections
-
-### man_get()
-  $ext = $_0->{'ext'};
-  $ext = $main::Man{'EXT'} unless $ext;
-  $ext = '' unless defined $ext;
-
-  die 'man_get(): $main::Manspec does not suit the arguments;'
-    if ($main::Manspec ne "$name.$sec,$ext") and
-      (! exists $main::Man{'MANSPEC'}{$main::Manspec});
-
-  if ($main::Man{'ALL'}) {
-    my $ok;
-    my %list;
-    foreach ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-      next if exists $list{$_};
-      if (-f $_ and -r $_) {
-	$list{$_} = 1;
-	&to_tmp($_);
-	$ok = 1;
-      }
-    }
-    &register_title("man:$name") if $ok;
-    return 1;
-  }
-
-  # not $main::Man{'ALL'}
-
-  if ($_0->{'sec'}) {
-    my $path = File::Spec->catfile('', "man$sec", $name);
-    if ($ext) {
-      foreach $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	if ($f =~ m#$path\.$sec$ext($|\..*$)#) {
-	  if (-f $f && -r $f) {
-	    &register_file($f);
-	    return 1;
-	  }
-	}			# if $f =~
-      }				# foreach $f
-### man_get()
-      foreach $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	if ($f =~ m#$path\.$sec$ext.*$#) {
-	  if (-f $f && -r $f) {
-	    &register_file($f);
-	    return 1;
-	  }
-	}			# if $f =~
-      }				# foreach $f
-    } else {			# $ext is empty
-      foreach $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	if ($f =~ m#$path\.$sec($|\..*$)#) {
-	  if (-f $f && -r $f) {
-	    #	    &to_tmp($f) && &register_file($f);
-	    &register_file($f);
-	    return 1;
-	  }
-	}			# if $f =~
-      }				# foreach $f
-      foreach $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	if ($f =~ m#$path\.$sec.*$#) {
-	  if (-f $f && -r $f) {
-	    #	    &to_tmp($f) && &register_file($f);
-	    &register_file($f);
-	    return 1;
-	  }
-	}			# if $f =~
-      }				# foreach $f
-    }				# if $ext
-### man_get()
-  } else {			# sec is empty
-    my $m = $main::Man{'SEC_CHARS'};
-    $m = $main::Man{'AUTO_SEC_CHARS'} unless $m;
-    foreach my $s (split //, $m) {
-      my $path = File::Spec->catfile('', "man$s", $name);
-      unless ($ext) {
-	foreach my $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	  if ( $f =~ m#$path\.$s($|\..*$)# ) {
-	    if (-f $f && -r $f) {
-	      #	      &to_tmp($f) && &register_file($f);
-	      &register_file($f);
-	      return 1;
-	    }
-	  }			# if $f =~
-	}			# foreach $f
-      }				# unless $ext
-      foreach $f ( @{$main::Man{'MANSPEC'}{$main::Manspec}} ) {
-	if ($f =~ m#$path\.$s$ext.*$#) {
-	  if (-f $f && -r $f) {
-	    #	    &to_tmp($f) && &register_file($f);
-	    &register_file($f);
-	    return 1;
-	  }
-	}			# if $f =~
-      }				# foreach $f
-    }				# foreach $s
-  }				# if sec
-
-  1;
-} # man_get()
-
-
-##########
-# man_setup ()
-#
-# Setup the variables in %MAN needed for man page searching.
-#
-# Globals:
-#   in:     %OPT, $LANG, $LC_MESSAGES, $LC_ALL,
-#           $MANPATH, $MANSEC, $PAGER, $SYSTEM, $MANOPT.
-#   out:    $main::Man{PATH}, $main::Man{LANG}, $main::Man{LANG2}, $main::Man{SYS},
-#           $main::Man{SEC}, $main::Man{ALL}
-#   in/out: $main::Man{ENABLE}
-#
-# The precedence for the variables related to 'man' is that of GNU
-# 'man', i.e.
-#
-# $LANG; overridden by
-# $LC_MESSAGES; overridden by
-# $LC_ALL; this has the same precedence as
-# $MANPATH, $MANSEC, $PAGER, $SYSTEM; overridden by
-# $MANOPT; overridden by
-# the groffer command-line options.
-#
-# $MANROFFSEQ is ignored because grog determines the preprocessors.
-#
-sub man_setup {
-  return 1 if $main::Man{'IS_SETUP'};
-  $main::Man{'IS_SETUP'} = 1;
-  return 1 unless $main::Man{'ENABLE'};
-
-  # determine basic path for man pages
-  my $path;
-  if (defined $main::Opt{'MANPATH'}) {
-    $path = $main::Opt{'MANPATH'};
-  } elsif ($ENV{'MANPATH'}) {
-    $path = $ENV{'MANPATH'};
-  } elsif ( &where_is_prog('manpath') ) {
-    $path = `manpath 2>$main::Dev_Null`;
-  }
-  if ($path) {
-    chomp $path;
-    $main::Man{'PATH'} = split /:/, $path;
-  } else {
-    $main::Man{'PATH'} = ;
-    &manpath_set_from_path();
-  }
-  unless ( @{$main::Man{'PATH'}} ) {
-    $main::Man{'ENABLE'} = 0;
-    warn "man_setup(): man path is empty;";
-    return 1;
-  }
-
-### man_setup()
-  # make man path list consisting of unique existing directories
-  @{$main::Man{'PATH'}} = &path_uniq( @{$main::Man{'PATH'}} );
-
-  unless ($main::Man{'ALL'}) {
-    $main::Man{'ALL'} = $main::Opt{'ALL'} ? 1 : 0;
-  }
-
-  # handle man systems
-  my $sys = $ENV{'SYSTEM'};
-  $sys = $main::Opt{'SYSTEMS'} if $main::Opt{'SYSTEMS'};
-  if ($sys) {
-    chomp $sys;
-    $main::Man{'SYS'} = split /,/, $sys;
-  } else {
-    $main::Man{'SYS'} = ;
-    $sys = '';
-  }
-
-### man_setup()
-  # handle language
-  my $lang = '';
-  $lang = $main::Opt{'LANG'} if $main::Opt{'LANG'};
-  unless ($lang) {
-    foreach ('LC_ALL', 'LC_MESSAGES', 'LANG') {
-      if ($ENV{$_}) {
-	$lang = $ENV{$_};
-	last;
-      }
-    }
-  }
-  if ($lang) {
-    if ($lang eq 'C' or $lang eq 'POSIX') {
-      $main::Man{'LANG'} = '';
-      $main::Man{'LANG2'} = '';
-    } elsif ($lang =~ /^.$/) {
-      $main::Man{'LANG'} = $lang;
-      $main::Man{'LANG2'} = '';
-    } elsif ($lang =~ /^..$/) {
-      $main::Man{'LANG'} = $lang;
-      $main::Man{'LANG2'} = $lang;
-    } else {
-      $main::Man{'LANG'} = $lang;
-      $main::Man{'LANG2'} = $lang;
-      $main::Man{'LANG2'} =~ s/^(..).*$/$1/;
-    }
-  }				# if ($lang)
-  # from now on, use only $main::Man{LANG*},
-  # forget about $main::Opt{LANG}, $ENV{LC_*}.
-
-  &manpath_add_lang_sys();
-
-### man_setup()
-  # section
-  my $sec;
-  $sec = $main::Opt{'SECTIONS'} if $main::Opt{'SECTIONS'};
-  unless ($sec) {
-    $sec = $ENV{'MANSEC'} if $ENV{'MANSEC'};
-  }
-  $main::Man{'SEC'} = ;
-  $main::Man{'SEC_CHARS'} = '';
-  if ($sec) {
-    foreach (split /:/, $sec) {
-      push @{$main::Man{'SEC'}}, $_ if /^$main::Man{'AUTO_SEC_CHARS'}$/;
-    }
-    $main::Man{'SEC_CHARS'} = join '', @{$main::Man{'SEC'}} if @{$main::Man{'SEC'}};
-  }				# if ($sec)
-
-  # extension
-  my $ext = '';
-  $ext = $main::Opt{'EXTENSION'} if $main::Opt{'EXTENSION'};
-  unless ($ext) {
-    $ext = $ENV{'EXTENSION'} if $ENV{'EXTENSION'};
-  }
-  $main::Man{'EXT'} = $ext;
-
-  # creation of man temporary is omitted, because of globs in perl
-  1;
-} # man_setup()
-
-
-##########
-# manpath_add_lang_sys()
-#
-# Add language and operating system specific directories to man path.
-#
-# Globals:
-#   in:     $main::Man{SYS}: a list of names of operating systems.
-#           $main::Man{LANG} and $main::Man{LANG2}: each a single name
-#   in/out: @{$main::Man{PATH}}: list of directories which shall have the 'man?'
-#           subdirectories.
-#
-sub manpath_add_lang_sys {
-  return 1 unless $main::Man{'PATH'};
-  return 1 unless @{$main::Man{'PATH'}};
-
-  my @mp;
-
-  if ( @{$main::Man{'SYS'}} ) {
-    foreach ( @{$main::Man{'SYS'}} ) {
-      if ($_ eq 'man') {
-	@mp = (@mp, @{$main::Man{'PATH'}});
-      } elsif ($_) {
-	my $sys = $_;
-	foreach my $p (@{$main::Man{'PATH'}}) {
-	  my $dir = File::Spec->catdir($p, $sys);
-	  push @mp, $dir;
-	}
-      }				# if eq 'man'
-    }				# foreach SYS
-  } else {			# no SYS
-    @mp = @{$main::Man{'PATH'}};
-  }
-
-  if (@mp && $main::Man{'LANG'}) {
-    my @lang_path;
-    my $man_lang2 = '';
-    $man_lang2 = $main::Man{'LANG2'} if $main::Man{'LANG'} ne $main::Man{'LANG2'};
-    foreach my $i ($main::Man{'LANG'}, $man_lang2) {
-      next unless $i;
-      my $lang = $i;
-      foreach my $p (@mp) {
-	my $dir = File::Spec->catdir($p, $lang);
-	push @lang_path, $dir;
-      }				# foreach $p
-    }				# foreach $i
-    @mp = (@lang_path, @mp);
-  }				# if $mp
-
-  $main::Man{PATH} = &path_uniq(@mp);
-  1;
-} # manpath_add_lang_sys()
-
-
-##########
-# manpath_set_from_path()
-#
-# Determine basic search path for man pages from $PATH.
-#
-# Return:    '1' if a valid man path was retrieved.
-# Output:    none
-# Globals:
-#   in:  $PATH
-#   out: $_MAN_PATH
-#
-sub manpath_set_from_path {
-  my @path =
-    qw( /usr/local /usr /usr/X11R6 /usr/openwin /opt /opt/gnome /opt/kde );
-  # get a basic man path from $ENV{PATH}
-  my @path2 = @main::Path;
-  foreach (@path2) {
-    s#bin/*$##;
-    push @path, $_;
-  }
-  @path = &path_uniq(@path);
-  foreach my $d (@path) {
-    foreach my $e ( File::Spec->catdir( qw(share man) ),
-		 File::Spec->catdir( qw(share MAN) ),
-		 'man',  'MAN' ) {
-      my $dir = File::Spec->catdir($d, $e);
-      push @{$main::Man{'PATH'}}, $dir if -d $dir;
-    }
-  }
-  1;
-} # manpath_set_from_path()
-
-
-##########
-# special_filespec()
-#
-# Handle special modes like whatis and apropos.  Run their filespec
-# functions if suitable.
-#
-# Globals:  in: $main::Opt{'APROPOS'}, $main::Opt{'WHATIS'}, $main::Special_Setup
-#          out: $main::Special_Filespec (internal)
-#
-sub special_filespec {
-  return 0 unless $main::Opt{'APROPOS'} || $main::Opt{'WHATIS'};
-  die 'special_filespec(): setup for apropos or whatis must be run first;'
-    unless $main::Special_Setup;
-  if ( $main::Opt{'APROPOS'} ) {
-    die "special_setup(): both apropos and whatis option variables are set;"
-      if $main::Opt{'WHATIS'};
-    return &apropos_filespec() ? 1 : 0;
-  }
-  if ( $main::Opt{'WHATIS'} ) {
-    return &whatis_filespec() ? 1 : 0;
-  }
-  0;
-} # special_filespec
-
-
-##########
-# special_setup()
-#
-# Handle special modes like whatis and apropos.  Run their setup
-# functions if suitable.
-#
-sub special_setup {
-  if ( $main::Opt{'APROPOS'} ) {
-    die "special_setup(): both --apropos and --whatis option variables " .
-      "are set;" if $main::Opt{'WHATIS'};
-    return &apropos_setup() ? 1 : 0;
-  }
-  if ( $main::Opt{'WHATIS'} ) {
-    return &whatis_setup() ? 1 : 0;
-  }
-  0;
-} # special_setup()
-
-
-##########
-# whatis_filename(<filename>)
-#
-# Interpret <filename> as a man page and display its 'whatis'
-# information as a fragment written in the groff language.
-#
-# Globals:  in: $main::Opt{'WHATIS'}, $main::Special_Setup, $main::Special_Filespec,
-#               $main::Filespec_Arg
-#
-sub whatis_filename {
-  my $n = @_;
-  die "whatis_filename(): one argument is needed; you used $n;"
-    unless $n == 1;
-  die "whatis_filename(): whatis is not setup;" unless $main::Opt{'WHATIS'};
-  die "whatis_filename(): setup for whatis must be run first;"
-    unless $main::Special_Setup;
-  die "whatis_filename(): whatis_filespec() must be run first;"
-    unless $main::Special_Filespec;
-  die 'whatis_filename(): no $main::Filespec_Arg is set;'
-    unless defined $main::Filespec_Arg;
-
-  my $arg = $_0;
-  die "whatis_file_name(): $arg is not an existing file" unless -f $arg;
-  die "whatis_file_name(): could not read file $arg" unless -r $arg;
-  return 1 if -z $arg;
-  $arg = 'stdin' if $main::Filespec_Arg eq '-';
-
-  &to_tmp_line('.br', '\\fCR' . $arg . '\\f:', '.br');
-
-### whatis_filename()
-  # get the parts of the file name according to the naming of man pages
-  my ($dir, $name) = &split_path( $_0 );
-  my $section = $_0;
-  my $path = File::Spec->catfile('', 'man');
-  $section =~ s#^.*$path($main::Man{'AUTO_SEC_CHARS'}).*$#$1#;
-  $section = '' if $section eq $_0;
-  if ($section) {
-    if ($name =~ m#^.*\.$section.*$#) {
-      $name =~ s/^(.*)\.$section.*$/$1/;
-    } else {
-      $section = '';
-    }
-  }
-
-  # traditional man style; grep the line containing '.TH' macro, if any
-  my @catz = &cat_z($_0);
-  my $res;
-  my $test;
-  foreach (@catz) {
-    if (/^\.'\s*TH\s/) {		# search .TH, traditional man style
-      $test = 1;
-      last;
-    }
-  }				# foreach (@catz)
-### whatis_filename()
-  if ($test) {			# traditional man style
-    # get the first line after the first '.SH' macro before the next '.SH'
-    my $test1;
-    foreach (@catz) {
-      if ($test1) {
-	chomp;
-	next unless $_;
-	next if /^\.'?\s*$/;
-	last if /^\.'/;		# especially for .SH
-	if ($res) {
-	  $res = "$res $_";
-	} else {
-	  $res = $_;
-	}
-      } else {			# $test1 is empty
-	$test1 = 1 if (/^\.'\s*SH\s/);
-      }				# if ($test1)
-    }				# foreach (@catz)
-
-    if ($section) {
-      if ($res =~ m|^
-		    $name
-		    \s
-		    ^-*
-		    -
-		    \s*
-		    (.*)
-		    $|sx) {
-	$res = "$name ($section) \\em $1";
-      }
-    }				# if ($section)
-### whatis_filename()
-    &to_tmp_line($res, '.br', '', '.br');
-    return 1;
-  }				# if ($test)
-
-  # mdoc style (BSD doc); grep the line containing '.Nd' macro, if any
-  foreach (@catz) {
-    if (/^\.'\s*Nd\s/) {		# BSD doc style
-      $res =~ s/^(.*)$/$name ($section) \\em $1/;
-      &to_tmp_line($res);
-      return 1;
-    }
-  }
-
-  &to_tmp_line('is not a man page', '.br', '', '.br');
-  1;
-} # whatis_filename()
-
-
-##########
-# whatis_filespec()
-#
-# Print the filespec name as .SH to the temporary cat file.
-#
-# Globals: in: $main::Opt{'WHATIS'}, $main::Filespec_Arg
-#      in/out: $main::Special_Filespec
-#
-sub whatis_filespec {
-  return 0 unless ($main::Opt{'WHATIS'});
-  die 'whatis_filespec(): whatis_setup() must be run first.'
-    unless $main::Special_Setup;
-  die 'whatis_filespec(): no $main::Filespec_Arg is set;'
-    unless defined $main::Filespec_Arg;
-  $main::Special_Filespec = 1;
-  my $arg = $main::Filespec_Arg;
-  $arg =~ s/^\\-/\\-/g;
-  to_tmp_line(".SH $arg");
-} # whatis_filespec()
-
-
-##########
-# whatis_setup ()
-#
-# Print the whatis header to the temporary cat file; this is the setup
-# for whatis.
-#
-# Globals:  in: $main::Opt{'WHATIS'}
-#          out: $main::Special_Setup
-sub whatis_setup {
-  if ( $main::Opt{'WHATIS'} ) {
-    &to_tmp_line('.TH GROFFER WHATIS');
-    $main::Special_Setup = 1;
-    $main::Opt{'TITLE'} = 'whatis' unless $main::Opt{'TITLE'};
-    return 1;
-  }
-  0;
-} # whatis_setup ()
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/roff2.1.man Deleted

@@ -1,229 +0,0 @@
-.TH roff2@ROFF2MODE@ @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-roff2@ROFF2MODE@ \- transform roff code into @ROFF2MODE@ mode
-.
-.\" roff2@ROFF2MODE@.1 - man page for roff2@ROFF2MODE@ (section 1).
-.
-.\" Source file position: <groff_source_top>/contrib/groffer/roff2.man
-.\" Installed position:   $prefix/share/man/man1/roff2@ROFF2MODE@.1
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
-.\"
-.\" This file is part of groffer, which is part of GNU groff, a free
-.\" software project.
-.\"
-.\" You can redistribute it and/or modify it under the terms of the GNU
-.\" General Public License version 2 (GPL2) as published by the Free
-.\" Software Foundation.
-.\"
-.\" The license text is available in the internet at
-.\" <http://www.gnu.org/licenses/gpl-2.0.html>.
-.
-.
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
-.
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
-.
-.
-.\" ====================================================================
-.SH "SYNOPSIS"
-.\" ====================================================================
-.
-.SY roff2@ROFF2MODE@
-.RI  groffer-option
-\*(EL
-.OP \-\-
-.RI  filespec
-\*(EL
-.YS
-.
-.SY roff2@ROFF2MODE@
-.B \-h
-.SY roff2@ROFF2MODE@
-.B \-\-help
-.YS
-.
-.SY roff2@ROFF2MODE@
-.B \-v
-.SY roff2@ROFF2MODE@
-.B \-\-version
-.YS
-.
-.P
-The options
-.B \-v
-and
-.B \%\-\-version
-print the version information of the program to standard output and exit.
-.
-The options
-.B \-h
-and
-.B \-\-help
-print a usage information of the program to standard output and stop
-the program instantly.
-.
-.
-.P
-All other options are assumed to be
-.B \%groffer
-options.
-.
-They are internally passed to
-.BR \%groffer .
-They override the behavior of the program.
-.
-The options are optional, they can be omitted.
-.
-.
-.P
-The
-.I \%filespec
-arguments correspond to the
-.I \%filespec
-arguments of
-.BR \%groffer .
-So they are either the names of existing, readable files or
-.B \-
-for standard input, or the name of a man page or a
-.BR \%groffer (@MAN1EXT@)
-man page search pattern.
-.
-If no
-.I \%filespec
-is specified standard input is assumed automatically.
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.
-.B \%roff2@ROFF2MODE@
-transforms
-.I roff
-code into
-.ie '@ROFF2MODE@'x' \{\
-.  I X
-mode corresponding to the
-.  I groff
-devices
-.  BR X *;
-this mode is suitable for
-.  BR \%gxditview (@MAN1EXT@).
-.\}
-.el \{\
-.  I \%@ROFF2MODE@
-mode.
-.\}
-.
-Print the result to standard output.
-.
-.
-.P
-There are more of these programs for generating other formats of
-.I \%roff
-input.
-.
-.if !'@ROFF2MODE@'dvi' \{\
-.  TP
-.  BR \%roff2dvi (@MAN1EXT@)
-is for
-.  I dvi
-mode.
-.\}
-.
-.if !'@ROFF2MODE@'html' \{\
-.  TP
-.  BR \%roff2html (@MAN1EXT@)
-generates
-.  I HTML
-output.
-.\}
-.
-.if !'@ROFF2MODE@'pdf' \{\
-.  TP
-.  BR \%roff2pdf (@MAN1EXT@)
-outputs
-.  I pdf
-mode.
-.\}
-.
-.if !'@ROFF2MODE@'ps' \{\
-.  TP
-.  BR \%roff2ps (@MAN1EXT@)
-prints
-.  I \%PostScript
-format to standard output.
-.\}
-.
-.if !'@ROFF2MODE@'text' \{\
-.  TP
-.  BR \%roff2text (@MAN1EXT@)
-generates text output in the
-.  B groff
-device
-.  IR latin1 .
-.\}
-.
-.if !'@ROFF2MODE@'x' \{\
-.  TP
-.  BR \%roff2x (@MAN1EXT@)
-prints the output in the
-.  B groff
-device
-.  B X
-that is suitable for programs like
-.  BR \%gxditview (@MAN1EXT@)
-or
-.  BR \%xditview (1).
-.\}
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.B roff2@ROFF2MODE@
-was written by
-.MT groff\-bernd.warken\-72@\:web.de
-Bernd Warken
-.ME .
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.BR \%groff (@MAN1EXT@),
-.BR \%groffer (@MAN1EXT@),
-.if !'@ROFF2MODE@'dvi' \
-.  BR \%roff2dvi (@MAN1EXT@),
-.if !'@ROFF2MODE@'html' \
-.  BR \%roff2html (@MAN1EXT@),
-.if !'@ROFF2MODE@'pdf' \
-.  BR \%roff2pdf (@MAN1EXT@),
-.if !'@ROFF2MODE@'ps' \
-.  BR \%roff2ps (@MAN1EXT@),
-.if !'@ROFF2MODE@'text' \
-.  BR \%roff2text (@MAN1EXT@),
-.if !'@ROFF2MODE@'x' \
-.  BR \%roff2x (@MAN1EXT@),
-.BR \%gxditview (@MAN1EXT@).
-.
-.
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: set filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/roff2.pl Deleted

@@ -1,230 +0,0 @@
-#! /usr/bin/env perl
-
-# roff2* - transform roff files into other formats
-
-# Source file position: <groff-source>/contrib/groffer/roff2.pl
-# Installed position: <prefix>/bin/roff2*
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# This file is part of 'groffer', 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
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-require v5.6;
-
-use strict;
-use warnings;
-use File::Spec;
-
-# temporary dir and files
-use File::Temp qw/ tempfile /;
-
-my $Dev_Null = File::Spec->devnull();
-my $Mode;
-my $Name;
-{
-  my ($v, $d);
-  ($v, $d, $Name) = File::Spec->splitpath($0);
-  die "wrong program name: $Name;"
-    if $Name !~ /^roff2a-z/;
-}
-$Mode = $Name;
-$Mode =~ s/^roff2//;
-
-my $Groff_Version = `groff --version 2>$Dev_Null`;
-die "$Name error: groff does not work;" if $?;
-my $Groffer_Version = `groffer --version 2>$Dev_Null`;
-my $Has_Groffer = ! $?;
-
-if ($Has_Groffer) {
-  foreach (@ARGV) {
-    last if $_ eq '--';
-    next if $_ eq '-';
-    if ($_ eq '-v' || '--version' =~ m|^$_|) {
-      print $Name, ' in ', $Groffer_Version;
-      exit 0;
-    }
-    if ($_ eq '-h' || '--help' =~ m|^$_|) {
-      &usage_with_groffer();
-      exit 0;
-    }
-  }
-  system('groffer', '--to-stdout', "--$Mode", @ARGV);
-  exit $?;
-} else {
-  my @filespec;
-  my $double_minus;
-  foreach (@ARGV) {
-    if ($double_minus) {
-      push @filespec, $_;
-      next;
-    }
-    if ($_ eq '--') {
-      $double_minus = 1;
-      next;
-    }
-    if ($_ eq '-') {
-      push @filespec, '-';
-      next;
-    }
-    if ($_ eq '-v' || '--version' =~ m|^$_|) {
-      print $Name, ' in ', $Groff_Version;
-      exit 0;
-    }
-    if ($_ eq '-h' || '--help' =~ m|^$_|) {
-      &usage_without_groffer();
-      exit 0;
-    }
-    if ($_ =~ /^-/) {
-      &error_no_groffer();
-      &error_no_options();
-      next;
-    }
-    if (-f && -r) {
-      push @filespec, $_;
-    } else {
-      &error_no_groffer();
-      print STDERR "$_ is not an existing, readable file.\n";
-    }
-  }
-
-  @filespec = ('-') unless @filespec;
-  my $has_stdin;
-  foreach (@filespec) {
-    if ($_ eq '-') {
-      $has_stdin =1;
-      last;
-    }
-  }
-
-  if ($has_stdin) {
-    my $tempdir;
-    foreach ($ENV{'GROFF_TMPDIR'}, $ENV{'TMPDIR'}, $ENV{'TMP'},
-	     $ENV{'TEMP'}, $ENV{'TEMPDIR'},
-	     File::Spec->catfile($ENV{'HOME'}, 'tmp')) {
-      if ($_ && -d $_ && -w $_) {
-	$tempdir = $_;
-	last;
-      }
-    }
-    my $template = $Name . '_XXXX';
-    my ($fh, $stdin);
-    if ($tempdir) {
-      ($fh, $stdin) = tempfile($template, UNLINK => 1, DIR => $tempdir) ||
-	die "$Name: could not create temporary file;";
-    } else {
-      ($fh, $stdin) = tempfile($template, UNLINK => 1) ||
-	die "$Name: could not create temporary file;";
-    }
-    open $fh, ">$stdin";
-    print $fh $_ foreach <STDIN>;
-
-    foreach (@filespec) {
-      $_ = $stdin if $_ eq '-';
-    }
-  }				# if $has_stdin
-
-  my $grog;
-  my $groff_options = "-T$Mode";
-  $groff_options = '-TX75-12 -Z' if $Mode eq 'x';
-  $groff_options = '-Tlatin1' if $Mode eq 'text';
-  if ($Mode eq 'pdf') {
-    my $ps2pdf;
-    my @path = File::Spec->path();
-    foreach (@path) {
-      my $file = File::Spec->catfile($_, 'ps2pdf');
-      if (-f $file && -x $file) {
-	$ps2pdf = "$file -";
-	last;
-      }
-    }
-    unless ($ps2pdf) {
-      foreach (@path) {
-	my $file = File::Spec->catfile($_, 'gs');
-	if (-f $file && -x $file) {
-	  $ps2pdf = $file . ' -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite ' .
-	    '-sOutputFile=- -c save pop -f -';
-	  last;
-	}
-      }
-    }
-    $grog = `grog -Tps @filespec`;
-    chomp $grog;
-    system("$grog | $ps2pdf");
-    exit $?;
-  } else {
-    $grog = `grog $groff_options @filespec`;
-    chomp $grog;
-    system($grog);
-    exit $?;
-  }
-}
-
-my $error_no_groffer;
-sub error_no_groffer {
-  return 1 if $error_no_groffer;
-  $error_no_groffer = 1;
-  print STDERR "$Name: groffer is not available.\n";
-}
-
-my $error_no_options;
-sub error_no_options {
-  return 1 if $error_no_options;
-  $error_no_groffer = 1;
-  print STDERR "$Name: groffer options are not allowed.\n";
-}
-
-sub usage_with_groffer {
-  print <<EOF;
-usage: $Name option... -- filespec...
-
--h | --help     print usage information
--v | --version  print version information
-
-All other options are arbitrary options of 'groffer'; the options
-override the behavior of this program.
-
-filespec's are the same as in 'groffer': either the names of existing,
-readable files or '-' for standard input or a search pattern for man
-pages.  No 'filespec' assumes standard input automatically.
-EOF
-}
-
-sub usage_without_groffer {
-  print <<EOF;
-usage: $Name option... -- filespec...
-
--h | --help     print usage information
--v | --version  print version information
-
-No other options are allowed because 'groffer' is not available.
-
-The only 'filespec's allowed are the names of existing, readable files
-or '-' for standard input.  No 'filespec' assumes standard input
-automatically.
-EOF
-}
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/split_env.sh Deleted

@@ -1,47 +0,0 @@
-#! /bin/sh
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/split_env.sh
-# Installed position: <prefix>/lib/groff/groffer/split_env.sh
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# This file is part of 'groffer', 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
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-# This file is called from groffer.pl.  The environment variable
-# of the name in $1 will be split at output.  The corresponding variable
-# must be exported before the call of groffer.pl.
-
-if test $# = 0
-then
-    echo 'split_env.sh was called without an argument.' >&2;
-else
-    eval v='"$'"$1"'"';
-    if test _"$v"_ != __
-    then
-	eval set x $v;
-	shift;
-	for i in "$@";
-	  do
-	  echo $i;
-	done;
-    fi;
-fi;

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/subs.pl Deleted

@@ -1,795 +0,0 @@
-#! /usr/bin/env perl
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/subs.pl
-# Installed position: <prefix>/lib/groff/groffer/subs.pl
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# Last update: 27 Aug 2015
-
-# This file is part of 'groffer', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-use strict;
-use warnings;
-
-########################################################################
-# some functions
-########################################################################
-
-##########
-# cat_z(<file>)
-#
-# Decompress or cat the <file>.
-#
-# Return: the decompressed file as array
-#
-sub cat_z {
-  my $n = @_;
-  die "cat_z(): one argument is needed; you used $n;"
-    unless $n == 1;
-
-  my $file = $_0;
-  die "cat_z(): '$file' is not a readable file;" unless -f $file && -r $file;
-  return () if -z $file;
-
-  my @res;
-  if ($main::Has_Compression) {
-    if ($main::Has_bzip) {
-      # test whether bz2 compressed, shell return must be inverted
-      unless ( system("bzip2 -t $file 2>$main::Dev_Null") ) {
-	@res = `bzip2 -c -d $file 2>$main::Dev_Null`;
-	return @res;
-      }
-      # if not compressed with gz, gzip will act like 'cat'
-      @res = `gzip -c -d -f $file 2>$main::Dev_Null`;
-      return @res;
-    }
-  } else {
-    my $fh;
-    open $fh, "<$file" or die "cat_z(): could not open $file";
-    @res = <$fh>;
-    close $fh;
-    return @res;
-  }
-  ();
-} # cat_z()
-
-
-##########
-# clean_up()
-#
-# Remove the temporary directory and restore the system.
-#
-sub clean_up {
-  umask $main::Umask;
-  chdir $main::Start_Dir;
-  if ($main::Debug{'KEEP'} && -d $main::tmpdir) {
-    my $glob = File::Spec->catfile($main::tmpdir, '*');
-    unlink glob($glob);		# rm $tmpdir/*
-    rmdir $main::tmpdir;
-  }
-} # clean_up()
-
-
-##########
-# get_dirname(<path>)
-#
-# Split the path and return the directory name part
-#
-# Return: string of directory name
-#
-sub get_dirname {
-  my $n = @_;
-  die "get_filename(): one argument is needed; you used $n;" unless $n == 1;
-  return '' unless $_0;
-
-  my ($dirname, $filename) = &split_path($_0);
-  $dirname;
-}				# get_dirname()
-
-
-##########
-# get_filename(<path>)
-#
-# Split the path and return the file name part
-#
-# Return: string of file name
-#
-sub get_filename {
-  my $n = @_;
-  die "get_dirname(): one argument is needed; you used $n;" unless $n == 1;
-  return '' unless $_0;
-
-  my ($dirname, $filename) = &split_path($_0);
-  $filename;
-}				# get_filename()
-
-
-##########
-# is_X()
-#
-# Test whether X Windows is running.
-#
-sub is_X {
-  return 1 if $ENV{'DISPLAY'};
-  return 0;
-}				# is_X()
-
-
-##########
-# list_has(<list_ref>, <string>)
-#
-# Determine if <list_ref> has <string> as element.
-#
-sub list_has {
-  my $n = @_;
-  die "list_has(): 2 arguments are needed; you used $n;"
-    unless $n == 2;
-
-  my $list_ref = $_0;
-  my $string = $_1;
-  die "list_has(): first argument must be an array reference;"
-    unless ref($list_ref) eq 'ARRAY';
-
-  foreach ( @$list_ref ) {
-    return 1 if $_ eq $string;
-  }
-  0;
-}
-
-
-##########
-# path_uniq(<dir>...)
-#
-# make path having unique existing directories
-#
-sub path_uniq {
-  my @a;
-  my %h;
-  foreach (@_) {
-    next if exists $h{$_};
-    next unless -d $_;
-    push @a, $_;
-    $h{$_} = 1;
-  }
-  @a;
-}				# path_uniq()
-
-
-##########
-# print_hash(<hash_or_ref>)
-#
-# print the elements of a hash or hash reference
-#
-sub print_hash {
-  my $hr;
-  my $n = scalar @_;
-  if ($n == 0) {
-    print "empty hash\n;";
-    return 1;
-  } elsif ($n == 1) {
-    if (ref($_0) eq 'HASH') {
-      $hr = $_0;
-    } else {
-      warn 'print_hash(): the argument is not a hash or hash reference;';
-      return 0;
-    }
-  } else {
-    if ($n % 2) {
-      warn 'print_hash(): the arguments are not a hash;';
-      return 0;
-    } else {
-      my %h = @_;
-      $hr = \%h;
-    }
-  }
-
-### print_hash()
-  unless (%$hr) {
-    print "empty hash\n";
-    return 1;
-  }
-  print "hash (ignore the ^ characters):\n";
-  for my $k (sort keys %$hr) {
-    my $hk = $hr->{$k};
-    print "  $k => ";
-    if (defined $hk) {
-      print "^$hk^";
-    } else {
-      print "undef";
-    }
-    print "\n";
-  }
-
-  1;
-}				# print_hash()
-
-
-##########
-# print_times(<string>)
-#
-# print the time, result: user, system, child process user, child system
-#
-sub print_times {
-  my @t = times;
-  my $s = '';
-  $s = $_0 if $_0;
-#  print STDERR "$s: @t\n";
-}				# print_times()
-
-BEGIN { &print_times("start"); }
-END { &print_times("end"); }
-
-
-##########
-# split_path(<path>)
-#
-# Split the path into directory and file name parts
-#
-# Return: array with 2 elements consisting of directory and file name
-#
-sub split_path {
-  my $n = @_;
-  die "split_path(): one argument is needed; you used $n;" unless $n == 1;
-  my $arg = $_0;
-  return () unless $arg;
-
-  my $basename = basename($arg);
-  if ( $basename ne $arg ) { # path with dir
-    # fileparse() is from File::Basename
-    my($filename, $dirname, $suffix) = fileparse($arg);
-    return ($dirname, $basename);
-  }
-  return ('', $arg);
-}
-
-
-{
-  my $nr_file = 0;
-  my $nr_so = 0;
-
-  my $tmp_file_base;
-  my $tmp_so_base;
-
-  my $soelim_r = '';
-  $soelim_r = '-r'
-    if ! system("echo -n '' | soelim -r 2>$main::Dev_Null >$main::Dev_Null");
-
-  ##########
-  # to_tmp (<filename>)
-  #
-  # Print file (decompressed) to the temporary cat file with handling .SO
-  # for man pages.
-  #
-  sub to_tmp {
-    my $n = @_;
-    die "to_tmp(): one argument is needed; you used $n;"
-      unless $n == 1;
-
-    my $arg = $_0;
-    return 1 unless $arg;
-    die "to_tmp(): $arg is not an existing file;" unless -f $arg;
-    die "to_tmp(): could not read file $arg;" unless -r $arg;
-    return 1 if -z $arg;
-
-    $tmp_file_base = File::Spec->catfile($main::tmpdir, ',file')
-      unless $tmp_file_base;
-    $tmp_so_base = File::Spec->catfile($main::tmpdir, ',so')
-      unless $tmp_so_base;
-
-    open $main::fh_cat, ">>$main::tmp_cat" or
-      die "to_tmp(): could not open temporary cat file";
-
-    if ($main::Opt{'WHATIS'}) {
-      &whatis_filename($arg);
-      return 1;
-    }
-
-    ### to_tmp()
-    my $dir = &get_dirname($arg);
-
-    my ($fh_file, $tmp_file, $fh_tmp, $tmp_tmp);
-    ++$nr_file;
-    $tmp_file = $tmp_file_base . $nr_file;
-    $tmp_tmp = File::Spec->catfile($main::tmpdir, ',tmp');
-
-    print STDERR "file: $arg\n" if $main::Debug{'FILENAMES'};
-
-    if ($main::Filespec_Is_Man) {
-      my ($fh_so, $tmp_so);
-
-      open $fh_file, ">$tmp_file" or
-	die "to_tmp(): could not open $tmp_file;";
-      foreach ( &cat_z($arg) ) {
-	print $fh_file "$_";
-      }
-      close $fh_file;
-
-      open $fh_file, "<$tmp_file" or
-	die "to_tmp(): could not open $tmp_file;";
-      my @list;
-      foreach (<$fh_file>) {
-	if (/^\.'\s*so\s/) {
-	  chomp;
-	  s/^\.'\s*so\s*//;
-	  push @list, $_;
-	}
-      }
-      close $fh_file;
-
-      if ( @list && $main::Debug{'KEEP'} ) {
-	my $f = $tmp_file . '+man';
-	copy($tmp_file, $f);
-      }
-
-      ### to_tmp()
-    DO_MAN_SO:  foreach (@list) {
-	# start of _do_man_so() in shell version
-	my $so = $_;
-	my $soname = $so;
-	$soname =~ s/\\\s/ /g;
-
-	my $sofound;
-	my $path = File::Spec->rootdir();
-	if ($soname =~ m#^$path#) {	  # absolute path name
-	  next DO_MAN_SO if -f $soname;
-	  foreach ('.gz', '.Z', '.bz2') {
-	    my $name = $soname . $_;
-	    if (-f $name) {
-	      $sofound = $name;
-	      last;
-	    }
-	  }			# foreach
-	  next DO_MAN_SO unless $sofound;
-	} else {		# relative to man path
-	LOOP: foreach my $ext ('', '.gz', '.Z', '.bz2') {
-	    foreach my $p ( @{$main::Man{'PATH'}} ) {
-	      my $f = File::Spec->catfile($p, "$soname$ext");
-	      if (-f $f) {
-		$sofound = $f if -f $f;
-		last LOOP;
-	      }
-	    }			# foreach
-	  }			# LOOP:
-	  next DO_MAN_SO unless $sofound;
-	}			# if on path
-
-	print STDERR "file from .so: $so\n" if $main::Debug{'FILENAMES'};
-
-	### to_tmp()
-	++$nr_so;
-	$tmp_so = $tmp_so_base . $nr_so;
-	unlink $tmp_so if -e $tmp_so;
-	open $fh_so, ">$tmp_so" or
-	  die "to_tmp(): could not open $tmp_so;";
-	foreach ( &cat_z($sofound) ) {
-	  print $fh_so $_;
-	}
-	close $fh_so;
-
-	my $esc = $so;
-	$esc =~ s/\\/\\\\/g;
-	open $fh_file, "<$tmp_file" or
-	  die "to_tmp(): could not open $tmp_file;";
-	open $fh_tmp, ">$tmp_tmp" or
-	  die "to_tmp(): could not open $tmp_tmp;";
-	foreach (<$fh_file>) {
-	  s#^(\.')\s*so\s+($so|$esc|$soname)\s*\n$#${1}so $tmp_so\n#s;
-	  print $fh_tmp $_;
-	}
-	### to_tmp()
-	close $fh_tmp;
-	close $fh_file;
-	unlink $tmp_file if -e $tmp_file;
-	rename $tmp_tmp, $tmp_file;
-	# end of _do_man_so() in shell version
-      }				# foreach (@list)
-
-      if ( @list && $main::Debug{'KEEP'} ) {
-	my $f = $tmp_file . '+tmp';
-	copy($tmp_file, $f);
-      }
-
-      unlink $tmp_tmp if -e $tmp_tmp;
-      rename $tmp_file, $tmp_tmp;
-      system("soelim -I$dir $soelim_r $tmp_tmp >$tmp_file");
-      unlink $tmp_tmp if -e $tmp_tmp;
-
-    } else {			# $Filespec_Is_Man is empty
-      open $fh_tmp, ">$tmp_tmp" or
-	die "to_tmp(): could not open $tmp_tmp;";
-      foreach (cat_z $arg) {
-	print $fh_tmp $_;
-      }
-      close $fh_tmp;
-      if ($dir) {
-	system("soelim -I$dir $soelim_r $tmp_tmp >$tmp_file");
-      } else {
-	system("soelim $soelim_r $tmp_tmp >$tmp_file");
-      }
-      unlink $tmp_tmp;
-    }				# if ($Filespec_Is_Man)
-
-    ### to_tmp()
-    my $grog = `grog $tmp_file`;
-    die "to_tmp(): grog error on $tmp_file;" if $?;
-    chomp $grog;
-    print STDERR "grog output: $grog\n" if $main::Debug{'GROG'};
-    if ($grog =~ /^.*\s-m.*$/) {
-      $grog =~ s/\s+/ /g;
-      $grog =~ s/ -m / -m/g;
-      $grog =~ s/ -mm(^ ) / -m$1/g;
-      foreach my $g (split / /, $grog) {
-	if ($g =~ /^-m/) {
-	  my $ref = \@main::Macro_Packages;
-	  if ( &list_has($ref, $g) ) {
-	    if (! $main::Macro_Pkg) {
-	      $main::Macro_Pkg = $g;
-	    } elsif ($main::Macro_Pkg eq $g) {
-	      1;
-	    } elsif ($main::Macro_Pkg =~ /^-m/) {
-	      warn "to_tmp(): Ignore $arg because it needs $g " .
-		"instead of $main::Macro_Pkg";
-	      unlink $tmp_file unless $main::Debug{'KEEP'};
-	      return 0;
-	    } elsif ($main::Macro_Pkg ne $g) {
-	      die "to_tmp(): \$Macro_Pkg does not start with -m: " .
-		"$main::Macro_Pkg";
-	    }			# if (! $main::Macro_Pkg)
-	  }			# if (&list_has
-	}			# if (/^-m/)
-      }				# foreach my $g
-    }				# if $grog
-
-    open $fh_file, "<$tmp_file" or
-      die "to_tmp(): could not open $tmp_file for reading;";
-    open $main::fh_cat, ">>$main::tmp_cat" or
-      die "to_tmp(): could not open $main::tmp_cat for appending;";
-    foreach (<$fh_file>) {
-      print $main::fh_cat $_;
-    }
-    close $main::fh_cat;
-    close $fh_file;
-
-    unless ( $main::Debug{'KEEP'} ) {
-      unlink $tmp_file;
-      foreach ( glob("$tmp_so_base*") ) {
-	unlink $_;
-      }
-    }
-    1;
-  }				# to_tmp()
-}
-
-##########
-# to_tmp_line (<text>...)
-#
-# Print array of lines with <text> to the temporary cat file.  \n is added
-# if a line does not end with \n.
-#
-sub to_tmp_line {
-  my $n = @_;
-  return 1 if $n == 0;
-  open $main::fh_cat, ">>$main::tmp_cat" or
-    die "to_tmp_line(): could not open temporary cat file";
-  foreach (@_) {
-    my $line = $_;
-    chomp($line);
-    print $main::fh_cat "$line\n";
-  }
-  close $main::fh_cat;
-  1;
-} # to_tmp_line()
-
-
-##########
-# usage()
-#
-# Print usage information for --help.
-#
-sub usage {
-  print "\n";
-  &version();
-  print <<EOF;
-
-Usage: groffer option... filespec...
-
-Display roff files, standard input, and/or Unix manual pages with an X
-Window viewer or in several text modes.  All input is decompressed
-on-the-fly with all formats that gzip can handle.
-
-"filespec" is one of
-  "filename"	name of a readable file
-  "-"		for standard input
-  "man:name(n)"	man page "name" in section "n"
-  "man:name.n"	man page "name" in section "n"
-  "man:name"	man page "name" in first section found
-  "name(n)"	man page "name" in section "n"
-  "name.n"	man page "name" in section "n"
-  "n name"	man page "name" in section "n"
-  "name"	man page "name" in first section found
-where 'section' is a single character out of 1-9on, optionally followed
-by some more letters that are called the 'extension'.
-
--h --help         print this usage message.
--T --device=name  pass to groff using output device "name".
--v --version      print version information.
--V                display the groff execution pipe instead of formatting.
--X                display with "gxditview" using groff -X.
--Z --ditroff --intermediate-output
-                  generate groff intermediate output without
-                  post-processing and viewing, like groff -Z.
-All other short options are interpreted as "groff" formatting options.
-
-The most important groffer long options are
-
---apropos=name	start man's "apropos" program for "name".
---apropos-data=name
-		"apropos" for "name" in man's data sections 4, 5, 7.
---apropos-devel=name
-		"apropos" for "name" in development sections 2, 3, 9.
---apropos-progs=name
-		"apropos" for "name" in man's program sections 1, 6, 8.
---auto		choose mode automatically from the default mode list.
---default	reset all options to the default value.
---default-modes=mode1,mode2,...
-		set sequence of automatically tried modes.
---dvi		display in a viewer for TeX device independent format.
---groff		process like groff, disable viewing features.
---help		display this helping output.
---html		display in a web browser.
---man		check file parameters first whether they are man pages.
---mode=auto|dvi|groff|html|pdf|ps|source|text|tty|utf8|www|x|X|xhtml
-		choose display mode.
---no-man	disable man-page facility.
---no-special	disable --all, --apropos*, and --whatis
---pager=program preset the paging program for tty mode.
---pdf		display in a PDF viewer.
---ps		display in a Postscript viewer.
---source	output as roff source.
---text		output in a text device without a pager.
---to-stdout	output the content of the mode file without display.
---tty		display with a pager on text terminal even when in X.
---utf8		unicode text mode
---viewer	choose a viewer for the actual device mode
---whatis	display the file name and description of man pages
---www		same as --html.
---x --X		display with "gxditview" using an X* device.
---xhtml		display html in XML mode using a web browser.
-
-The usual X Windows toolkit options transformed into GNU long options:
---background=color, --bd=size, --bg=color, --bordercolor=color,
---borderwidth=size, --bw=size, --display=Xdisplay, --fg=color,
---fn=font, --font=font, --foreground=color, --geometry=geom, --iconic,
---resolution=dpi, --rv, --title=text, --xrm=resource
-
-Long options of GNU "man":
---all, --ascii, --ditroff, --extension=suffix, --locale=language,
---local-file=name, --location, --manpath=dir1:dir2:...,
---sections=s1:s2:..., --systems=s1,s2,..., --where, ...
-
-Development options that are not useful for normal usage:
---debug, --debug-filenames, --debug-grog, --debug-keep, --debug-params,
---debug-tmpdir, --do-nothing, --print=text
-
-EOF
-
-# The following mode-viewer options were replaced by a single --viewer
-# option.  The old options are only ignored:
-# --dvi-viewer=prog choose the viewer program for dvi mode.
-# --html-viewer=program
-#                  choose the web browser for html or xhtml mode.
-# --pdf-viewer=prog choose the viewer program for pdf mode.
-# --ps-viewer=prog  choose the viewer program for ps mode.
-# --tty-viewer=prog select a pager for tty mode; same as --pager.
-# --www-viewer=prog same as --html-viewer
-# --x-viewer=prog   choose viewer program for x mode (X mode).
-# --X-viewer=prog   same as "--xviewer".
-
-} # usage()
-
-
-##########
-# version()
-#
-# Get version information from version.sh and print a text with this.
-#
-sub version {
-  my $groff_version;
-  my $program_version = '';
-  my $last_update = '';
-  my $groff_version_preset = '';
-
-  die "$main::File_version_sh does not exist;"
-    unless -f "$main::File_version_sh";
-  my $fh;
-  open $fh, "<$main::File_version_sh";
-  foreach (<$fh>) {
-    chomp;
-    if (/^\s*_PROGRAM_VERSION\s*=\s*'"*(^'"*)'"*\s*;?\s*$/) {
-      $program_version = $1;
-      next;
-    }
-    if (/^\s*_GROFF_VERSION_PRESET\s*=\s*'"*(^'"*)'"*\s*;?\s*$/) {
-      # this setting of the groff version is only used before make is run,
-      # otherwise @VERSION@ will set it, see groffer.sh.
-      $groff_version_preset = $1;
-      next;
-    }
-  }
-  close $fh;
-
-  if ($main::Groff_Version) {
-    $groff_version = $main::Groff_Version;
-  } else {
-    $groff_version = $groff_version_preset;
-  }
-  print <<EOF;
-groffer $program_version is part of groff version $groff_version.
-GNU groff and groffer come with ABSOLUTELY NO WARRANTY.
-You may redistribute copies of groff and its subprograms
-under the terms of the GNU General Public License.
-EOF
-} # version()
-
-
-##########
-# where_is_prog(<program>)
-#
-# Test whether <program> without its arguments exists or is a program
-# in $PATH.
-#
-# Arguments : 1, <program> can have spaces and arguments.
-# Return    : a hash with 'dir', 'file', 'fullname', 'args' if
-#             argument exists or is a program in $PATH, empty hash else.
-#
-sub where_is_prog {
-  scalar @_ eq 1 or die "where_is_prog(): only one argument is allowed";
-  my $p1 = $_0;
-  return () unless $p1;
-
-  $p1 =~ s/\s+/ /g;
-  $p1 =~ s/(\\)+ / /g;
-  $p1 =~ s/^ | $//g;
-  return () unless $p1;
-
-  my $noarg = $p1;
-  $noarg =~ s/ -.*$//;
-  return () unless $noarg;
-
-  my $args;
-  if ($p1 =~ /^.* -.*$/) {
-    $args = $p1;
-    $args =~ s#^$noarg ##;
-  }
-  $args = '' unless defined $args;
-
-  my %result;
-
-  # test whether $noarg has directory, so it is not tested with $PATH
-  my ($dir, $name) = &split_path($noarg);
-  $result{'dir'} = $dir;
-
-### where_is_prog()
-  if (-f $noarg && -x $noarg) {
-    $result{'args'} = $args;
-    $result{'file'} = $name;
-    $result{'fullname'} = File::Spec->catfile($dir, $name);
-    return %result;
-  }
-
-  if ($dir) {			# $noarg has name with directory
-    # now $wip_noarg (with directory) is not an executable file
-
-    # test name with space
-    if ($name =~ / /) {
-      my @base = split(/ /, $name);
-      my $n = pop @base;
-      my @baseargs = ($n);
-      while (@base) {
-	my $base = join(' ', @base);
-	my $file = File::Spec->catpath($dir, $base);
-	if (-f $file && -x $file) {
-	  my $baseargs = join(' ', @baseargs);
-	  ### where_is_prog()
-	  if ($args) {
-	    $args = "$baseargs $args";
-	  } else {
-	    $args = $baseargs;
-	  }
-	  $result{'args'} = $args;
-	  $result{'file'} = $base;
-	  $result{'fullname'} = $file;
-	  return %result;
-	}			# file test $file
-	$n = pop @base;
-	unshift(@baseargs, $n);
-      }				# while (@base)
-    }				# end of test name with space
-    return ();
-  }				# test on $dir
-
-  # now $noarg doesn't have a directory part
-
-  $name = $noarg;
-
-  # check with $PATH
-
-  # test path with $win_noarg as a whole, evt. with spaces
-  foreach my $d (@main::Path) {
-    my $file = File::Spec->catfile($d, $name);
-    if (-f $file && -x $file) {
-      $result{'args'} = $args;
-      $result{'fullname'} = $file;
-      ($result{'dir'}, $result{'file'}) = &split_path($file);
-      return %result;
-    }				# file test $file
-  }				# foreach (@main::Path)
-
-### where_is_prog()
-  if ($name =~ / /) {
-    my @base = split(/ /, $name);
-    my $n = pop @base;
-    my @baseargs = ($n);
-    while (@base) {
-      my $base = join(' ', @base);
-      foreach my $d (@main::Path) {
-	my $file = File::Spec->catfile($d, $base);
-	if (-f $file && -x $file) {
-	  my $baseargs = join(' ', @baseargs);
-	  if ($args) {
-	    $args = "$baseargs $args";
-	  } else {
-	    $args = $baseargs;
-	  }
-	  $result{'args'} = $args;
-	  $result{'fullname'} = $file;
-	  ($result{'dir'}, $result{'file'}) = &split_path($file);
-	  return %result;
-	}			# file test $file
-      }				# foreach (@main::Path)
-      $n = pop @base;
-      unshift(@baseargs, $n);
-    }				# while (@base)
-  }				# test $name on space
-  return ();
-} # where_is_prog()
-
-
-##########
-# wait()
-#
-# stop for checking temp files, etc.
-#
-sub wait {
-  print "push Ctrl-D";
-  my @x = <STDIN>;
-  print "\n";
-}				# wait()
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/groffer/version.sh Deleted

@@ -1,34 +0,0 @@
-#! /bin/sh
-
-# groffer - display groff files
-
-# Source file position: <groff-source>/contrib/groffer/version.sh
-# Installed position: <prefix>/lib/groff/groffer/version.sh
-
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-
-# This file is part of 'groffer', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-########################################################################
-
-export _PROGRAM_VERSION;
-_PROGRAM_VERSION='2.3.0';
-
-# this setting of the groff version is only used before make is run,
-# otherwise @VERSION@ will set it, see groffer.sh.
-export _GROFF_VERSION_PRESET;
-_GROFF_VERSION_PRESET='1.22.4';

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/hdmisc.tmac-u Deleted

@@ -1,333 +0,0 @@
-.ig
-
-hdmisc.tmac
-
-This file is part of groff, the GNU roff type-setting system.
-
-Copyright (C) 2005-2018 Free Software Foundation, Inc.
-written by Joachim Walsdorff <Joachim.Walsdorff@urz.uni-heidelberg.de>.
-
-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
-(at your option) any later version.
-
-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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-..
-.
-.
-.\" %beginstrip%
-.
-.if d t*getarg \
-.  nx
-.
-.
-.\"	******************************************************************
-.\"	**	Some macros and default settings needed by hdtbl	**
-.\"	******************************************************************
-.
-.
-.\"	Utility macro:	.getarg <key> ...
-.\"
-.\"		Get macro argument.  This macro searches <key> in the
-.\"		remaining arguments and assigns its value to a string
-.\"		register named <key>.  The following syntax forms are
-.\"		recognized.
-.\"
-.\"			<key>=<val>	Assign <val> to string <key>.
-.\"					<val> must not contain spaces.
-.\"			<key>='<val>'	Assign <val> to string <key>.
-.\"					<val> can contain spaces.
-.\"			<key>=		Assign '=' to string <key>.
-.\"			<key>		Assign 'key' to string <key>.
-.\"
-.\"		After return, the string 'args' contains the remaining
-.\"		arguments.
-.\"
-.\"		Example: With the definition of string 'foo' as
-.\"
-.\"			.ds foo aaa=xxx bbb ccc='yyy zzz' ddd= eee
-.\"
-.\"		a call to 'getarg' with
-.\"
-.\"			.getarg ccc \*foo
-.\"
-.\"		sets string 'ccc' to value 'yyy zzz'.  The string 'args'
-.\"		now contains 'aaa=xxx bbb ddd= eee'.  An additional call
-.\"		like
-.\"
-.\"			.getarg ddd \*args
-.\"
-.\"		sets string 'ddd' to value '=', and 'args' contains
-.\"		'aaa=xxx bbb eee'.
-.de t*getarg
-.  ds \\$1
-.  ds args
-.
-.  if (\\n.$ < 2) \
-.    return
-.
-.  ds $1 \\$1\"
-.  shift
-.
-.  length * \\*$1
-.  while \\n.$ \{\
-.    ds * "\\$1\"
-.    ds ** "\\$1\"
-.    length ** \\***
-.    shift
-.    if (\\n* > \\n**) \{\
-.      as args " "\\***"\"			value too short, repeat
-.      continue
-.    \}
-.    substring * 0 (\\n* - 1)
-.    \" The surrounding \? escapes emulate string comparison.
-.    ie !"\?\\*$1\?"\?\\**\?" \{\
-.      as args " "\\***"\"			key not found, repeat
-.      continue
-.    \}
-.    el \{\
-.      ie "\?\\***\?"\?\\*$1\?" \
-.        ds \\*$1 \\*$1\"			return key as string
-.      el \{\
-.        ie "\?\\***\?"\?\\*$1=\?" \
-.          ds \\*$1 =\"			return '='
-.        el \{\
-.          substring ** (\\n* + 1) -1
-.          ds * \\***\"
-.          substring * 0 0
-.
-.          \" check whether value starts with quote
-.          if "\?\\**\?"\?'\?" \{\
-.            substring ** 1 -1
-.            ds * \\***\"
-.            substring * -1 -1
-.
-.            \" search final quote
-.            ie "\?\\**\?"\?'\?" \
-.              substring ** 0 -2
-.            el \{\
-.              as \\*$1 \\*** \"		not found, append argument
-.
-.              while 1 \{\
-.                ds ** \\$1\"			get next argument
-.                ds * \\$1\"
-.                shift
-.                substring * -1 -1
-.
-.                if "\?\\**\?"\?'\?" \{\
-.                  substring ** 0 -2
-.                  break		\"	break if no final quote
-.                \}
-.
-.                as \\*$1 \\*** \"		otherwise append and repeat
-.              \}
-.          \}\}
-.
-.          as \\*$1 \\***\"
-.        \}
-.
-.        as args " \\$@\"
-.    \}\}
-.
-.    return
-.  \}
-..
-.
-.
-.\"	Utility macro:	.index <string1> <string2>
-.\"
-.\"		Check whether <string2> is a substring of <string1> and
-.\"		return its position in number register 't*index', starting
-.\"		with 1.  If not found, return 0.  If <string2> is empty,
-.\"		set 't*index' to -999.
-.de t*index
-.  if "\\$2"" \{\
-.    nr t*index -999
-.    return
-.  \}
-.
-.  length ** \\$1&#x7;
-.  length $2 \\$2
-.  nr * 0-1 1
-.
-.  while (\\n+* < \\n**) \{\
-.    ds * \\$1&#x7;\"
-.    substring * \\n* (\\n* + \\n$2 - 1)
-.    \" The surrounding \? escapes emulate string comparison.
-.    if "\?\\**\?"\?\\$2\?" \
-.      break
-.  \}
-.
-.  ie (\\n* == \\n**) \
-.    nr t*index 0
-.  el \
-.    nr t*index (\\n* + 1)
-..
-.
-.
-.\"	******************************************************************
-.\"	********	non-accumulating space .t*SP v	**********
-.\"	**                                                              **
-.\"	**	nl vor erster Seite -1, oben auf Seite 0 resp. tH	**
-.\"	**	.k nach .sp oder .br 0,					**
-.\"	**		sonst Laenge der angefangenen Zeile		**
-.\"	**	Der Merker M# fuer vorangegangenes .t*SP wird in .HM am	**
-.\"	**	Seitenanfang zurueckgesetzt.				**
-.\"	**	ganz richtig ist .sp + .br = .br + .sp = .sp		**
-.\"	******************************************************************
-.de t*SP
-.  if (\\nnl < 0) \
-.    br			\"	start very first page
-.  nr * \\n.p		\"	save current page length
-.
-.  ie "\\$1"" \
-.    pl +1		\"	without arg increase page length by 1v
-.  el \
-.    pl +\\$1		\"	otherwise use \\$1
-.
-.  nr ** (\\n.p - \\n*)	\" ** now holds arg for .t*SP in base units
-.  pl \\n*u		\"	restore page length
-.
-.  \" we do nothing at start of new page or column
-.  if ((\\nnl - \\ntH) & (\\nnl - \\n<<) : \\n.k) \{\
-.    ie ((\\n.d - \\nM#) : \\n.k) \{\
-.      sp \\n**u	\"	execute .sp
-.      nr S# \\n**	\"	store ** in S#
-.    \}
-.    el \{\
-.      if (\\n** - \\nS#) \{\
-.        sp (\\n**u - \\nS#u)\"	emit difference to previous .t*SP
-.        nr S# \\n**	\"	store ** in S#
-.    \}\}
-.
-.    nr M# \\n.d	\"	store vertical position .d in M#
-.  \}
-..
-.
-.
-.\"	******************************************************************
-.\"	**		Perform all arguments once			**
-.\"	**			P1 is nestable				**
-.\"	******************************************************************
-.de t*P1
-.  \" 'while' command is about five times faster than recursion!
-.  while \\n.$ \{\
-.    nop \\$1
-.    shift
-.  \}
-..
-.
-.
-.\"	******************************************************************
-.\"	**	Hilfsmakro zum Einstellen von Schriftgroesse und	**
-.\"	**	Zeilenabstand, bezogen auf Anfangswerte \nt*s		**
-.\"	**	und \nt*v sowie fuer Hyphenation:			**
-.\"	**		.t*pv s v hy# hart;  macht .br			**
-.\"	**	Bei 4. Argument setzen der Register s und v und hy.	**
-.\"	**	Fuer angefangene Zeile die vorgefundenen Einstellungen	**
-.\"	**								**
-.\"	**   Auxiliary macro to set internal registers for font size	**
-.\"	**   and line spacing, relative to initial values \nt*s and	**
-.\"	**   \nt*v. Optionally sets hyphenation. A fourth argument	**
-.\"	**   initializes internal registers to global default values.	**
-.\"	******************************************************************
-.de t*pv
-.  br
-.
-.  if \\n.$ \
-.    ps (\\nt*su * \\$1z / 1z)
-.
-.  ie (\\n.$ - 1) \
-.    vs (\\nt*vu * \\$2p / 1p)
-.  el \{\
-.    vs (\\nt*vu * \\$1p / 1p)
-.    return
-.  \}
-.
-.  if !""\\$3" \
-.    hy \\$3
-.
-.  if !""\\$4" \{\
-.    nr t*v \\n.v
-.    nr t*s \\n.ps
-.    nr t*hy \\n.hy
-.  \}
-..
-.
-.
-.\"	******************************************************************
-.\"	**		Hilfsmakros pop/pops/popr (pop stackelement):	**
-.\"	**		pop or popr:	pop register			**
-.\"	**		pops:		pop string			**
-.\"	**		.pops|r reg|string stackname			**
-.\"	**		    reg|string: name of reg/string to get the	**
-.\"	**			 popped element				**
-.\"	**		    stack: name of stack			**
-.\"	******************************************************************
-.de *pop
-.  ie "\\$1"pops" \
-.    ds \\$2 \\$4\"		pop first stackelement
-.  el \
-.    nr \\$2 \\$4
-.
-.  ds $3 \\$3\"			remember stackname
-.  shift 4		\"	shift four args
-.
-.  ds \\*$3 "\\$@\"		fill stack with remaining elements
-..
-.
-.de pop
-.  *pop \\$0 \\$1 \\$2 \\*\\$2
-..
-.
-.als popr pop
-.als pops pop
-.
-.
-.\"	******************************************************************
-.\"	**		process diversion				**
-.\"	******************************************************************
-.de t*DI
-.  nr * \\n.u
-.  nf		\"	diversion is already formatted - output it unchanged
-.  \\$1		\"	output the diversion ...
-.  rm \\$1	\"	... and remove it
-.  if \\n* \
-.    fi		\"	reactivate formatting
-..
-.
-.\"	******************************************************************
-.\"	**		error checking at end				**
-.\"	******************************************************************
-.de t*EM
-.
-.  if !"\\*t*kept"" \{\
-.    tm1 "hdtbl: Not all tables have been printed.
-.    tm1 "       Add '.bp' at the end of your document.
-.  \}
-.  if !"\\*t*held"" \{\
-.    tm1 "hdtbl: There are held tables which haven't been printed.
-.    tm1 "       Add '.t*free' at the end of your document.
-.  \}
-.  if \\nt*# \
-.    tm hdtbl: Missing '.ETB' macro; last .TBL in \\*t*FN at line \\*t*LN.
-..
-.
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/hdtbl.tmac-u Deleted

@@ -1,1005 +0,0 @@
-.ig
-
-hdtbl.tmac
-
-This file is part of groff, the GNU roff type-setting system.
-
-Copyright (C) 2005-2018 Free Software Foundation, Inc.
-written by Joachim Walsdorff <Joachim.Walsdorff@urz.uni-heidelberg.de>.
-
-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
-(at your option) any later version.
-
-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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-..
-.
-.
-.\"	*****************************************************************
-.\"	*		hdtbl - Heidelberger table macros		*
-.\"	*			Vers. 0.91 December 2005		*
-.\"	*****************************************************************
-.
-.if d TBL \
-.  nx
-.
-.mso hdmisc.tmac
-.mso 62bit.tmac
-.
-.
-.\"	*****************************************************************
-.\"	*		default values for some arguments		*
-.\"	*****************************************************************
-.
-.ds t*hl s\"
-.ds t*vl s\"
-.ds t*tal l\"
-.ds t*hal b\"
-.ds t*val t\"
-.ds t*ff \\n.fam\"
-.ds t*fst \\n.f\"
-.ds t*fsz 1 1\"
-.ds t*fgc red4\"
-.ds t*bgc bisque\"
-.ds t*bc red4\"
-.nr t*cpd .5n
-.nr t*csp .5n
-.nr t*b .1n
-.nr t*cols 1
-.nr t*v \n.v
-.nr t*s \n.ps
-.nr t*hy \n.hy
-.nr t*l \n.ll
-.
-.
-.\"			defaults for table captions
-.nr t*cptn 0 1
-.ds t*cptn "".sp .4" \
-            ".t*pv 1.0 1.0" \
-            ".ad l" \
-            "\m\\*t*fgcTable \\n+t*cptn:\0\k*\c"\"
-.
-.
-.\" %beginstrip%
-.
-.\" for better error messages
-.ds nth-1 st\"
-.ds nth-2 nd\"
-.ds nth-3 rd\"
-.
-.\" initialization of various registers
-.nr t*# 0	\"	table nesting level
-.nr t*numb 0 1	\"	held table diversion #
-.
-.ds *#trc*
-.
-.
-.\"	*****************************************************************
-.\"	*	The four base macros and the two optional macros	*
-.\"	*****************************************************************
-.
-.ie n \
-.  ds g tty:\"
-.el \
-.  ds g ps: exec\"
-.
-.\"	TBL:	table start
-.\"		predecessor: 	text, TD or ETB
-.\"		successor:	CPTN or TR
-.de TBL
-.  ds t*m\\nt*# \\n.m\"
-.  ie \\nt*# \
-.    br
-.  el \{\
-.    ds * \\n.ev\"
-.    ev t*tbl
-.    evc \\**
-.    di t*tbl0
-.    sp .4				\" XXX: hard-coded value
-.    nr t*i \\n.i
-.    ll -\\n.iu
-.    in 0
-.  \}
-.  nr t*# +1
-.
-.  \" Save current location for error checking at end
-.  ds t*FN \\.F\"
-.  ds t*LN \\.c\"
-.
-.  t*getarg cols \\$@\"	from here string 'args' contains the rest of \\$@
-.  ie "\\*cols"" \
-.    nr t*cols\\nt*# \\nt*cols
-.  el \{\
-.    ie \B&#x7;\\*cols&#x7; \
-.      nr t*cols\\nt*# \\*cols
-.    el \
-.      tm \\n.F:\\n.c: Invalid number of columns value '\\*cols'.
-.  \}
-.
-.  t*getarg cpd \\*args                 \"	cell padding
-.  ie "\\*cpd"" \
-.    nr t*cpd\\nt*# \\nt*cpd
-.  el \{\
-.    ie \B&#x7;\\*cpd&#x7; \
-.      nr t*cpd\\nt*# \\*cpd
-.    el \
-.      tm \\n.F:\\n.c: Invalid cell padding value '\\*cpd'.
-.  \}
-.
-.  t*getarg csp \\*args                 \"	cell spacing
-.  ie "\\*csp"" \
-.    nr t*csp\\nt*# \\nt*csp
-.  el \{\
-.    ie \B&#x7;\\*csp&#x7; \
-.      nr t*csp\\nt*# \\*csp
-.    el \
-.      tm \\n.F:\\n.c: Invalid cell spacing value '\\*csp'.
-.  \}
-.
-.  t*getarg border \\*args              \"	border thickness
-.  ie "\\*border"=" \
-.    nr t*b\\nt*# 0-1
-.  el \{\
-.    ie "\\*border"" \
-.      nr t*b\\nt*# \\nt*b
-.    el \{\
-.      ie \B&#x7;\\*border&#x7; \
-.        nr t*b\\nt*# \\*border
-.      el \
-.        tm \\n.F:\\n.c: Invalid border thickness value '\\*border'.
-.  \}\}
-.
-.  t*getarg bc \\*args                  \"	border color
-.  ds t*bc\\nt*# \\*t*bc\"
-.  if !"\\*bc"" \{\
-.    ie m\\*bc \
-.      ds t*bc\\nt*# \\*bc\"
-.    el \{\
-.      ie "\\*bc"=" \
-.        ds t*bc\\nt*# =\"
-.      el \
-.        tm \\n.F:\\n.c: Invalid border color '\\*bc'.
-.  \}\}
-.  ie "\\*bc"=" \
-.    ds t*bc\\nt*#
-.  el \{\
-.    ie "\\*bc"" \
-.      ds t*bc\\nt*# \\*t*bc\"
-.    el \
-.      ds t*bc\\nt*# \\*bc\"
-.  \}
-.
-.  t*getarg width \\*args               \"	table/col widths
-.  if "\\*width"=" \
-.    ds width
-.
-.  nr b/2\\nt*# (\\nt*b\\nt*# / 2)\"	shortcut
-.  nr cscp\\nt*# (\\nt*csp\\nt*# + \\nt*cpd\\nt*#)\"  aux. register
-.
-.  t*getarg height \\*args              \"	table outline height
-.  ie "\\*height"" \
-.    nr t*height\\nt*# 0
-.  el \{\
-.    ie \B&#x7;\\*height&#x7; \
-.      nr t*height\\nt*# (\\*height \
-                            - ((2 * \\ncscp\\nt*#) \
-                                + (3 * \\nb/2\\nt*#)))
-.    el \
-.      tm \\n.F:\\n.c: Invalid height value '\\*height'.
-.  \}
-.
-.  t*cl \\*width                      \"	get cell widths and offsets
-.  t*args \\nt*#                      \"	look for common arguments
-.
-.  t*getarg tal \\*args                 \"	table horizontal alignment
-.  if "\\*tal"" \
-.    ds tal \\*t*tal\"
-.  ie "\\*tal"l" \
-.    nr in\\nt*# \\n.i
-.  el \{\
-.    ie "\\*tal"c" \
-.      nr in\\nt*# (\\n.l - \\nll\\nt*#/2 + \\n.i)
-.    el \{\
-.      ie "\\*tal"r" \
-.        nr in\\nt*# (\\n.l - \\nll\\nt*# + \\n.i)
-.      el \{\
-.        tmc \\n.F:\\n.c: Invalid horizontal table alignment '\\*tal':
-.        tm1 " must be 'l', 'c' or 'r'.
-.  \}\}\}
-.
-.  nr t*r#\\nt*# 0		        \"	initialize row index
-.  mk toptbl\\nt*#
-.
-.  t*P1 \\*args
-..
-.
-.
-.\"	CPTN:	optional table caption
-.\"		predecessor:	TBL
-.\"		successor:	TR
-.de CPTN
-.  ft 1
-.
-.  if "\\$0"CPTN" \
-.    if \\nt*r#\\nt*# \{\
-.      tmc \\n.F:\\n.c: Invalid placement of '.CPTN';
-.      tm1 " must be called immediately after '.TBL'.
-.      return
-.    \}
-.
-.  t*getarg val \\$@
-.  ds args\\nt*# "\\*args\"
-.
-.  t*index "\\*args" .TR
-.  ie \\nt*index \{\
-.    ds *a\\nt*# "\\*args\"
-.    substring args\\nt*# 0 \\nt*index
-.    substring *a\\nt*# \\nt*index-2 -1
-.  \}
-.  el \
-.    ds *a\\nt*#
-.
-.  ie "\\*val"b" \{\
-.    de t*cptn\\nt*#
-.      *CPTN \\*args\\nt*#
-.      rm t*cptn\\nt*#
-\\..
-.  \}
-.  el \{\
-.    ll (\\nll\\nt*#u + \\nin\\nt*#u)
-.    in \\nin\\nt*#u
-.    t*P1 \\*t*cptn
-'    in +\\n*u
-.    t*P1 \\*args\\nt*#
-.    t*pv 1 1
-.    in
-.    mk toptbl\\nt*#
-.  \}
-.
-.  t*P1 \\**a\\nt*#
-..
-.
-.als *CPTN CPTN
-.
-.
-.\"	TR:	table row
-.\"		predecessor:	TBL, CPTN, text, TD or ETB
-.\"		successor:	TD
-.de TR
-.  ft 1
-.  if !\\nt*# \{\
-.    tm \\n.F:\\n.c: Table row (.TR) without preceding table start (.TBL).
-.    return
-.  \}
-.
-.  \" finish previous data cell, if any
-.  if \\nt*r#\\nt*# \
-.    t*dntr 1 \\nc#\\*#t#r \\nt*cols\\nt*# \\**#trc*
-.
-.  nr t*r#\\nt*# +1			\"	row number in this table
-.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		table row identifier
-.					\"	(<level>*<row>)
-.  nr c#\\*#t#r 0 1			\"	clear cell counter
-.  nr dntr\\*#t#r 0 1			\"	clear accumulated row height
-.
-.  t*getarg height \\$@
-.  ie "\\*height"" \
-.    nr t*height\\*#t#r 0
-.  el \{\
-.    ie \B&#x7;\\*height&#x7; \
-.      nr t*height\\*#t#r \\*height
-.    el \
-.      tm \\n.F:\\n.c: Invalid table row height '\\*height'.
-.  \}
-.
-.  \"	If there is a TR with height 'height', the total height of the table
-.  \"	is too high by 3/2 b, independent of the number of TR with 'height'.
-.  t*args \\*#t#r \\nt*#            \"	look for common arguments
-.
-.  t*P1 \\*args
-..
-.
-.
-.\"	TH:	optional table header cell
-.\"		predecessor:	text, TD or TR
-.\"		successor:	text, TD, TR, TBL or ETB
-.\"								
-.\"		cell content bolded and horizontally and vertically centered,
-.\"		else like .TD
-.de TH
-.  ft 1
-.  t*getarg hal \\$@
-.  if "\\*hal"" \
-.    ds hal c\"
-.
-.  t*getarg val \\*args
-.  if "\\*val"" \
-.    ds val m\"
-.
-.  t*getarg fst \\*args
-.  if "\\*fst"" \
-.    ds fst B\"
-.
-.  TD hal=\\*hal val=\\*val fst=\\*fst \\*args
-..
-.
-.
-.\"	TD:	table data cell
-.\"		predecessor:	text, TD or TR
-.\"		successor:	text, TD, TR, TBL or ETB
-.de TD
-.  ft 1
-.  \" finish previous data cell -- note the use of \E
-.  t*dntr 0 \\nc#\\*#t#r-1 \Enc#\\*#t#r \\**#trc*
-.
-.  ds *#trc* \\*#t#r*\\nc#\\*#t#r\"	table cell identifier
-.					\"	(<level>*<row>*<column>)
-.
-.  t*getarg rowspan \\$@
-.  nr rowspan 1
-.  if !"\\*rowspan"" \{\
-.    ie \B&#x7;\\*rowspan&#x7; \{\
-.      nr rowspan (\\*rowspan >? 1)
-.      nr *rsp*\\**#trc* (\\nrowspan - 1)
-.    \}
-.    el \
-.      tm \\n.F:\\n.c: Invalid value of 'rowspan' keyword.
-.  \}
-.
-.  t*getarg colspan \\*args
-.  nr colspan 1
-.  if !"\\*colspan"" \{\
-.    ie \B&#x7;\\*colspan&#x7; \
-.      nr colspan (\\*colspan >? 1)
-.    el \
-.      tm \\n.F:\\n.c: Invalid value of 'colspan' keyword.
-.  \}
-.
-.  t*args \\*#trc \\*#t#r           \"  look for common arguments
-.
-.  nr in\\*#trc \\nin\\nt*#*\\nc#\\*#t#r
-.  nr *cl \\ncll\\nt*#*\\nc#\\*#t#r
-.  nr * 0 1
-.  nr *r \\nt*r#\\nt*#
-.
-.  if (\\nrowspan - 1) \
-.    while (\\n+* <= \\nrowspan) \{\
-.      nr rspan\\nt*#*\\n*r*\\nc#\\*#t#r \\ncolspan
-.      if (\\n* > 1) \
-.        nr cspan\\nt*#*\\n*r*\\nc#\\*#t#r \\ncolspan
-.      nr *r +1
-.    \}
-.
-.  nr * 1 1
-.  nr *c \\nc#\\*#t#r
-.
-.  if (\\ncolspan - 1) \{\
-.    nr vline\\**#trc* 0-1		\"	set 'no vl' flag
-.
-.    while (\\n+* <= \\ncolspan) \{\
-.      nr *c +1
-.      nr *cl +(2 * \\ncscp\\nt*# \
-                + \\nb/2\\nt*# \
-                + \\ncll\\nt*#*\\n*c)
-.      nr c#\\*#t#r +1
-.    \}
-.  \}
-.
-.  if (\\nc#\\nt*#*\\nt*r#\\nt*# > \\nt*cols\\nt*#) \{\
-.    ds * are\"
-.    ds ** columns\"
-.    if (\\nc#\\*#t#r == 1) \{\
-.      ds * is\"
-.      ds ** column\"
-.    \}
-.    tmc \\n.F:\\n.c: There \\** \\nc#\\*#t#r table \\*** (.TD)
-.
-.    ds * are\"
-.    if (\\nt*cols\\nt*# == 1) \
-.      ds * is\"
-.    tm1 " but only \\nt*cols\\nt*# \\** expected.
-.
-.    ds *
-.    length * \\n.F:\\n.c:
-.
-.    while \\n-* \
-.      ds * " \\**\"
-.
-.    tm1 "\\** Remaining .TDs and its contents are ignored.
-.
-.    di *t*dummy*                \"	bypass superfluous input
-.    return
-.  \}
-.
-.  di t*\\*#trc                \"	open cell diversion and set locals
-.  in 0
-.  nr cll\\*#trc \\n*cl
-.  ll \\n*clu
-.  nr *cl\\nt*# \\n.l
-.  gcolor \\*t*fgc\\*#trc
-.  ad \\*t*hal\\*#trc
-.  fam \\*t*ff\\*#trc
-.  ft \\*t*fst\\*#trc
-.  t*pv \\*t*fsz\\*#trc
-.
-.  t*P1 \\*args
-..
-.
-.
-.\"	ETB:	end of table
-.\"		predecessor:	text, TD or ETB
-.\"		successor:	text, TD, TR or TBL
-.de ETB
-.  ie \\nt*# \
-.    if !\\nt*r#\\nt*# \{\
-.      tmc \\n.F:\\n.c: Each table (.TBL)
-.      tm1 " should contain at least one table row (.TR)!
-.    \}
-.  el \{\
-.    tmc \\n.F:\\n.c: Table end (.ETB)
-.    tm1 " without corresponding table start (.TBL)!
-.  \}
-.
-.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		refresh table row identifier
-.  t*dntr 2 \\nc#\\*#t#r \\nt*cols\\nt*# \\**#trc*
-.
-.  t*divs                        \"	print this table
-.
-.  sp \\nb/2\\nt*#u
-.  t*cptn\\nt*#
-.  nr t*# -1
-.
-.  ll \\n*cl\\nt*#u          \"	restore ll outside this table
-.  in 0                          \"	reset indent
-.  gcolor \\*t*m\\nt*#       \"	reset previous fgc
-.
-.  t*getarg hold \\$@
-.  if !\\nt*# \{\
-.    sp .5
-.    di
-.    in \\nt*iu
-.    ie "\\*hold"" \{\
-.      ie (\\n.t - \\ndn) \
-.        t*DI t*tbl0
-.      el \{\
-.        rn t*tbl0 t*tbl\\n+t*numb
-.        ds t*kept \\*t*kept t*tbl\\nt*numb \\ndn\"
-.      \}
-.    \}
-.    el \{\
-.      rn t*tbl0 t*hold\\n+t*numb
-.      tm \\n.F:\\n.c: Table t*hold\\nt*numb held.
-.      ds t*held \\*t*held t*hold\\nt*numb \\ndn\"
-.    \}
-.
-.    ev				\"	restore previous environment
-.  \}
-.
-.  t*P1 \\*args
-..
-.
-.
-.\"	*****************************************************************
-.\"	*	Following the definition of five utility macros		*
-.\"	*	special to hdtbl.					*
-.\"	*	Other utility macros common to hdtbl and hdgroff	*
-.\"	*	are defined in the file hdmisc.tmac.			*
-.\"	*****************************************************************
-.
-.
-.\"	.t*free n
-.\"		print the next n held tables.
-.\"             Don't call it within a table!
-.\"		If the table is higher than the remaining space
-.\"		on the page, the table is printed on the next page.
-.de t*free
-.  if "\\$0"CPTN" \
-.    if \\nt*r#\\nt*# \{\
-.      tmc \\n.F:\\n.c: Invalid placement of '.t*free' within a table;
-.      tm1 " it must be called outside of any table.
-.      return
-.    \}
-.
-.  if "\\*t*held"" \{\
-.    tm \\n.F:\\n.c: No held tables.
-.    return
-.  \}
-.
-.  nr ** (\\$1 >? 1) 1
-.  while !""\\*t*held" \{\
-.    pops * t*held
-.    popr * t*held
-.
-.    ie (\\n.t - \\n*) \{\
-.      ev t*tbl
-.      t*DI \\**
-.      ev
-.    \}
-.    el \{\
-.      rn \\** t*tbl\\n+t*numb
-.      ds t*kept \\*t*kept t*tbl\\nt*numb \\n*\"
-.    \}
-.
-.    if !(\\n-** - 1) \
-.      return
-.  \}
-..
-.
-.
-.\"	The main utility macro for tables:
-.\"		If a table is closed by ETB, this macro is called.  It
-.\"		processes one complete table, i.e., all the table cell
-.\"		diversions, paints the cell backgrounds, draws
-.\"		horizontal and vertical table lines and the table border.
-.\"
-.\"		Nested tables are processed from inside to outside.
-.
-.de t*divs
-.  ll (\\nt*lu + 1c)			\"	avoid warning 'can't break line'
-.  nf
-.
-.  nr b/2 \\nb/2\\nt*#		\"	some abbreviations
-.  nr cscp \\ncscp\\nt*#
-.  nr cscpb (\\nb/2 + \\ncscp)
-.
-.  nr topdiv (\\n.d + \\nb/2 - \\ncscp)\"	top of cell diversion
-.  nr cscpb2 (\\nb/2 / 2 + \\ncscp)
-.
-.  nr #r 0 1
-.  \" outer loop for rows
-.  while (\\n+#r <= \\nt*r#\\nt*#) \{\
-.    \" TODO: insert code here for multipage tables
-.    nr * (\\n#r - 1)
-.    nr topdiv +(\\ndntr\\nt*#*\\n* + \\ncscp + \\ncscpb)
-.
-.    \" if table still smaller than specified table height, increase it
-.    if ((\\n#r == \\nt*r#\\nt*#) & \\nt*height\\nt*#) \
-.      nr dntr\\nt*#*\\n#r (\\ncscpb \
-                                + \\ntoptbl\\nt*# \
-                                + \\nt*height\\nt*# \
-                                - (\\ntopdiv >? \\ndntr\\nt*#*\\n#r))
-.
-.    nr #c 0 1
-.    \" inner loop for cells
-.    while (\\n+#c <= \\nt*cols\\nt*#) \{\
-.      ds #trc \\nt*#*\\n#r*\\n#c\"
-.      \" continue if the diversion is empty
-.      if !d t*\\*#trc \
-.        continue
-.
-.      sp |\\ntopdivu
-.      in (\\nin\\nt*#u + \\nin\\*#trcu)\"	cell offset
-.      nr $1 \\ndntr\\nt*#*\\n#r	\"	cell height
-.
-.      \" if we have spanned rows, calculate resulting row height
-.      \" and position of lower horizontal line
-.      if \\n*rsp*\\*#trc \{\
-.        nr * \\n#r 1
-.        nr rspan\\*#trc 0-1		\"	set 'no hl' flag
-.        nr corr (\\ndn\\*#trc - \\ndntr\\nt*#*\\n#r)
-.
-.        \" clear row span flags in following rows and update row height
-.        while \\n*rsp*\\*#trc \{\
-.          nr *rsp*\\*#trc -1
-.          nr rspan\\nt*#*\\n+**\\n#c 0
-.          nr ** (\\ndntr\\nt*#*\\n* + \\ncscp + \\ncscpb)
-.          nr corr -\\n**
-.          nr $1 +\\n**
-.        \}
-.
-.        if (\\n-* == \\nt*r#\\nt*#) \
-.          nr $1 ((\\nt*height\\nt*# \
-                   - \\n.d \
-                   + \\ntoptbl\\nt*# \
-                   + \\ncscpb) \
-                     >? \\n$1)
-.        nr dntr\\nt*#*\\n* +(\\ncorr >? 0)
-.      \}
-.
-.      \" paint cell background
-.      nr * (2 * \\nt*cpd\\nt*# + \\ncll\\*#trc)\"	background width
-.      nr $1 (\\n$1 >? \\ndn\\*#trc)\"	cell height
-.
-.      if !"\\*t*bgc\\*#trc"=" \{\
-.        nop \h'\\nt*csp\\nt*#u'\
-\M\\*t*bgc\\*#trc\
-\v'(-.67v - \\nt*cpd\\nt*#u)'\
-\D'P \\n*u 0 \
-     0 (2u * \\nt*cpd\\nt*#u + \\n$1u) \
-     -\\n*u 0'\
-\M
-.        sp -1
-.      \}
-.
-.      \" ***   horizontal and vertical single or double lines   ***
-.      \" double and single lines have the same thickness;
-.      \" the double lines' distance is the line thickness.
-.      \"
-.      \" 'border=x': horizontal/vertical lines x/2 thick, minimum .1n
-.      \" 'border=0': no border; horizontal/vertical lines .1n thick
-.      \" 'border=': neither border nor horizontal/vertical lines
-.
-.      nr *t (.1n >? \\nb/2)		\"	thickness of hl/vl; min. .1n
-.      in +\\ncscpu
-.
-.      \" check for vertical and horizontal lines
-.      if (1 + \\nt*b\\nt*#) \{\
-.        if !"\\*t*bc\\nt*#"=" \{\
-.          \" draw horizontal line between this cell and the one below
-.          if (\\nt*r#\\nt*# - \\n#r + \\nrspan\\*#trc) \{\
-.            if !"\\*t*hl\\*#trc"=" \{\
-.              sp \\n$1u
-.              nr * (\\ncscp + \\ncscpb + \\ncll\\*#trc)
-.              nop \X'\*g 1 setlinecap'\
-\h'(-\\ncscpb2u - \\n*tu)'\
-\v'(\\ncscpb2u - .67v)'\
-\m\\*t*bc\\nt*#\
-\D't \\n*tu'\c
-.
-.              ie "\\*t*hl\\*#trc"d" \
-.                nop \v'-\\n*tu'\
-\D'l \\n*u 0'\
-\v'(2u * \\n*tu)'\
-\D'l -\\n*u 0'\
-\D't 0'
-.              el \
-.                nop \D'l \\n*u 0'\
-\D't 0'
-.
-.              sp (-\\n$1u - 1v)
-.          \}\}
-.
-.          nr rspan\\*#trc 0
-.
-.          \" draw vertical line between this cell and the one to the right
-.          if (\\nt*cols\\nt*# - \\n#c + \\nvline\\*#trc) \{\
-.            if !"\\*t*vl\\*#trc"=" \{\
-.              nop \X'\*g 1 setlinecap'\
-\v'(-\\ncscpb2u - .67v)'\
-\m\\*t*bc\\nt*#\
-\h'(\\ncscpb2u - \\n*tu + \\ncll\\*#trcu)'\c
-.
-.              ie "\\*t*vl\\*#trc"d" \
-.                nop \h'-\\n*tu'\
-\D't \\n*tu'\
-\D'l 0 (2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
-\h'(2u * \\n*tu)'\
-\D'l 0 -(2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
-\D't 0'
-.              el \
-.                nop \D't \\n*tu'\
-\D'l 0 (2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
-\D't 0'
-.              sp -1
-.      \}\}\}\}
-.
-.      nr vline\\*#trc 0
-.
-.      \" vert. cell content alignment
-.      nr ** 0
-.
-.      ie "\\*t*val\\*#trc"m" \
-.        nr ** ((\\n$1 - \\ndn\\*#trc) / 2)\"	val=m
-.      el \
-.        if "\\*t*val\\*#trc"b" \
-.          nr ** (\\n$1 - \\ndn\\*#trc)\"	val=b
-.
-.      sp \\n**u			\"	vertical content position
-.
-.      \" finally output the diversion
-.      t*\\*#trc
-.      rm t*\\*#trc
-.    \}
-.  \}
-.
-.  \" draw the box border
-.  in \\nin\\nt*#u
-.  nr ** (\\ntopdiv + \\ndntr\\nt*#*\\n-#r)
-.
-.  if \\nt*b\\nt*# \{\
-.    sp |(\\ntoptbl\\nt*#u + \\nb/2u)
-.    nr $1 (\\ntoptbl\\nt*# - \\n** - \\ncscp)
-.    nr * (\\nll\\nt*# - \\nt*b\\nt*#)
-.
-.    if !"\\*t*bc\\nt*#"=" \
-.      nop \X'\*g 0 setlinejoin 2 setlinecap'\
-\v'-.67v'\
-\h'-\\nb/2u'\
-\m\\*t*bc\\nt*#\
-\D't \\nt*b\\nt*#u'\
-\D'l \\n*u 0'\
-\D'l 0 -\\n$1u'\
-\D'l -\\n*u 0'\
-\D'l 0 \\n$1u'\
-\D't 0'
-.  \}
-.
-.  sp |(\\n**u + \\ncscpbu)
-.  fi
-..
-.
-.
-.\"	Utility macro:	.t*cl width1 width2 ...
-.\"
-.\"		Calculate cell widths, table width, and cell offsets.
-.de t*cl
-.  nr t*cols\\nt*# (\\n.$ >? \\nt*cols\\nt*#)
-.  nr ll\\nt*# 0			\"	accumulated cell widths
-.  nr ** (\\n.l / \\nt*cols\\nt*#)\"	width for remaining cells
-.  nr * 0 1				\"	counter
-.
-.  \" while-loop: Parse user arguments to get each cell's width.
-.  while (\\nt*cols\\nt*# >= \\n+*) \{\
-.    nr $\\n* \\n**
-.    if !"\\$\\n*"" \{\
-.      \" check for '%' pseudo scaling indicator
-.      ds * \\$\\n*\"
-.      substring * -1 -1
-.      ie "\\**"%" \{\
-.        ds ** \\$\\n*\"
-.        substring ** 0 -2
-.        ie \B&#x7;\\***&#x7; \
-.          nr $\\n* (\\*** * \\n.l / 100)
-.        el \
-.          tm \\n.F:\\n.c: Invalid relative cell width '\\***%'.
-.      \}
-.      el \{\
-.        ie \B&#x7;\\$\\n*&#x7; \
-.          nr $\\n* \\$\\n*
-.        el \
-.          tm \\n.F:\\n.c: Invalid cell width '\\$\\n*'.
-.    \}\}
-.
-.    nr ll\\nt*# +\\n$\\n*
-.    nr ** \\n$\\n*
-.  \}
-.
-.  if (\\nll\\nt*# > \\n.l) \
-.    tm \\n.F:\\n.c: Table width larger than column width.
-.
-.  nr ** (0 >? \\nt*b\\nt*#)
-.  nr * 0 1
-.
-.  \" second while loop: Compute final cell widths.
-.  while (\\nt*cols\\nt*# >= \\n+*) \{\
-.    \" Remove border width, if any.
-.    if \\nt*b\\nt*# \{\
-.      \" cell_width := cell_width * (length - 1.5*border) / length
-.      nr #* (\\nll\\nt*# - (3 * \\nt*b\\nt*# / 2))
-.      nr *** (\\nll\\nt*# / 2)
-.      \" avoid multiplication overflow
-.      mult31by31 $\\n* #* ****
-.      add31to62 *** **** ****
-.      div62by31 **** ll\\nt*# $\\n*
-.    \}
-.
-.    \" Get cell widths without padding, spacing, and separator line.
-.    nr cll\\nt*#*\\n* (\\n$\\n* \
-                            - (2 * \\ncscp\\nt*#) \
-                            - \\nb/2\\nt*#)
-.
-.    \" Check whether value is non-positive.
-.    if !\\ncll\\nt*#*\\n* \{\
-.      nr #* (\\nll\\nt*# - (3 * \\nt*b\\nt*# / 2))
-.      nr *** (\\n#* / 2)
-.      nr *h (2 * \\ncscp\\nt*# + \\nb/2\\nt*#)
-.      mult31by31 *h ll\\nt*# ****
-.      add31to62 *** **** ****
-.      div62by31 **** #* *h
-.      ds * \\n*th\"
-.      nr *** (\\n* % 10)
-.      if d nth-\\n*** \
-.        ds * \\n*\\*nth-\\n***\"
-.      tmc \\n.F:\\n.c: The \\** width value (\\$\\n*) is too small.
-.      tm1 " It should be greater than \\n*h.
-.    \}
-.
-.    nr in\\nt*#*\\n* \\n**	\"	cell offset
-.    nr ** +\\n$\\n*
-.  \}
-..
-.
-.
-.\"	Utility macro:	.t*dntr <origin> <cell position> ? <cell ID>
-.\"
-.\"		Close TD diversion, make some calculations, and set
-.\"		some help strings and registers.  <origin> is 0, 1,
-.\"		or 2 if the call of .t*dntr occurs in .TD, .TR, or
-.\"		.ETB, respectively.
-.de t*dntr
-.  nr dn 0				\"	reset diversion height
-.  br					\"	finish cell data
-.
-.  if "\\n.z"*t*dummy*" \
-.    return
-.
-.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		refresh table row identifier
-.
-.  if \\nc#\\*#t#r \{\
-.    di					\"	close diversion
-.    nr dn\\$4 \\ndn			\"	save height of this cell
-.    if !\\nrspan\\*#trc \{\
-.      \" update row height if not in a row span
-.      nr dntr\\*#t#r (\\ndntr\\*#t#r >? \\ndn)
-.      if \\$2 \
-.        nr dntr\\*#t#r ((\\nt*height\\*#t#r \
-                            - (2 * \\ncscp\\nt*# + \\nb/2\\nt*#)) \
-                            >? \\ndntr\\*#t#r)
-.  \}\}
-.
-.  nr c#\\*#t#r +1
-.  nr * \\$2
-.
-.  \" update column span registers
-.  while (\\n+* <= \\$3) \{\
-.    if r cspan\\*#t#r*\\n* \
-.      nr c#\\*#t#r +\\ncspan\\*#t#r*\\n*
-.    nr cspan\\*#t#r*\\n* 0
-.  \}
-.
-.  ds #trc \\*#t#r*\\nc#\\*#t#r\"
-.
-.  \" only check for cell underflow if called by .TR or .ETB
-.  if (\\$1 & (\\nc#\\*#t#r <= \\nt*cols\\nt*#)) \{\
-.    ds * are\"
-.    ds ** columns\"
-.    if (\\n-c#\\*#t#r == 1) \{\
-.      ds * is\"
-.      ds ** column\"
-.    \}
-.    tmc \\n.F:\\n.c: There \\** only \\nc#\\*#t#r \\***
-.
-.    nr * \\nt*r#\\nt*#
-.    ds * \\n*th\"
-.    nr *** (\\n* % 10)
-.    if d nth-\\n*** \
-.      ds * \\n*\\*nth-\\n***\"
-.    tmc " in the \\** row
-.
-.    ds * are\"
-.    if (\\nt*cols\\nt*# == 1) \
-.      ds * is\"
-.    tm1 " but \\nt*cols\\nt*# \\** expected.
-.  \}
-..
-.
-.
-.\"	Utility-macro:	.t*args level_1 level_2
-.\"
-.\"		Get the arguments common to TBL, TR, and TD for the level
-.\"		in argument 1, using default values from the level in
-.\"		argument 2.  If argument 2 is missing, use the global
-.\"		default values.
-.\"
-.de t*args
-.  ds t*bgc\\$1 \\*t*bgc\\$2\"
-.  ds t*fgc\\$1 \\*t*fgc\\$2\"
-.  ds t*hl\\$1 \\*t*hl\\$2\"
-.  ds t*vl\\$1 \\*t*vl\\$2\"
-.  ds t*hal\\$1 \\*t*hal\\$2\"
-.  ds t*val\\$1 \\*t*val\\$2\"
-.  ds t*ff\\$1 \\*t*ff\\$2\"
-.  ds t*fst\\$1 \\*t*fst\\$2\"
-.  ds t*fsz\\$1 \\*t*fsz\\$2\"
-.
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg bgc \\*args         \"	background color
-.  if !"\\*bgc"" \{\
-.    ie m\\*bgc \
-.      ds t*bgc\\$1 \\*bgc\"
-.    el \{\
-.      ie "\\*bgc"=" \
-.        ds t*bgc\\$1 =\"
-.      el \
-.        tm \\n.F:\\n.c: Invalid background color '\\*bgc'.
-.  \}\}
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg fgc \\*args         \"	foreground color
-.  if !"\\*fgc"" \{\
-.    ie m\\*fgc \
-.      ds t*fgc\\$1 \\*fgc\"
-.    el \{\
-.      ie "\\*fgc"=" \
-.        ds t*fgc\\$1 =\"
-.      el \
-.        tm \\n.F:\\n.c: Invalid foreground color '\\*fgc'.
-.  \}\}
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg hl \\*args          \"	horizontal line between cells
-.  if !"\\*hl"" \
-.    ds t*hl\\$1 \\*hl\"
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg vl \\*args          \"	vertical line between cells
-.  if !"\\*vl"" \
-.    ds t*vl\\$1 \\*vl\"
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg hal \\*args         \"	horizontal table cell alignment
-.  if !"\\*hal"" \{\
-.    t*index bcrl \\*hal
-.    ie \\nt*index \
-.      ds t*hal\\$1 \\*hal\"
-.    el \{\
-.      tmc \\n.F:\\n.c: Invalid horizontal alignment '\\*hal':
-.      tm1 " must be 'b', 'c', 'l' or 'r'.
-.  \}\}
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg val \\*args         \"	vertical table cell alignment
-.  if !"\\*val"" \{\
-.    t*index tmb \\*val
-.    ie \\nt*index \
-.      ds t*val\\$1 \\*val\"
-.    el \{\
-.      tmc \\n.F:\\n.c: Invalid vertical alignment '\\*val':
-.      tm1 " must be 't', 'm' or 'b'.
-.  \}\}
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg ff \\*args          \"	font family
-.  if !"\\*ff"" \
-.    ds t*ff\\$1 \\*ff\"
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg fst \\*args         \"	font style
-.  if !"\\*fst"" \
-.    ds t*fst\\$1 \\*fst\"
-.  if "\\*args"" \
-.    return
-.
-.  t*getarg fsz \\*args         \"	font size and spacing factor
-.  if !"\\*fsz"" \
-.    ds t*fsz\\$1 \\*fsz\"
-..
-.
-.
-.\" Append to your page header macro ('pg@top' for MS)
-.\" to enable tables to span pages.
-.de t*hm
-.  ev t*tbl
-.  nr ** \\n.t
-.  while !""\\*t*kept" \{\
-.    pops * t*kept
-.    popr * t*kept
-.    if (\\n* - \\n**) \{\
-.      tm \\n.F:\\n.c: Table \\** higher than page -- ignored!
-.      break
-.    \}
-.
-.    if (\\n* - \\n.t) \{\
-.      ds t*kept \\n* \\*t*kept\"
-.      ds t*kept \\** \\*t*kept\"
-.      tmc \\n.F:\\n.c: Remaining table(s),
-.      tm1 " because not all fit onto this page.
-.      break
-.    \}
-.
-.    t*DI \\**
-.  \}
-.  ev
-..
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/doc/fixinfo.sh Deleted

@@ -1,49 +0,0 @@
-#! /bin/sh
-#
-# Fix a problem with HTML output produced by makeinfo
-#   (tested with versions 4.8 and 4.13).
-#
-# groff.texi uses (after macro expansion) something like
-#
-#   @deffn ...
-#   @XXindex ...
-#   @deffnx ...
-#
-# which has worked with earlier versions (using an undocumented feature
-# of the implementation of @deffn and @deffnx).  Version 4.8 has new
-# code for generating HTML, and the above construction produces wrong
-# HTML output: It starts a new <blockquote> without closing it properly.
-# The very problem is that, according to the documentation, the @deffnx
-# must immediately follow the @deffn line, making it impossible to add
-# entries into user-defined indices if supplied with macro wrappers around
-# @deffn and @deffnx.
-#
-# Note that this script is a quick hack and tightly bound to the current
-# groff.texi macro code.  Hopefully, a new texinfo version makes it
-# unnecessary.
-#
-# 09-2014: no more problem with texinfo 5.0 or higher
-#
-t=${TMPDIR-.}/gro$$.tmp
-
-cat $1 | sed '
-1 {
-  N
-  N
-}
-:b
-$b
-N
-/^<blockquote>\n *<p>.*\n\n   \&mdash;/ {
-  s/^<blockquote>\n *<p>$.*\n$\n   \&mdash;/\1\&mdash;/
-  n
-  N
-  N
-  bb
-}
-$b
-P
-D
-' > $t
-rm $1
-mv $t $1

_service:tar_scm:groff-1.22.4.tar.gz/doc/meintro.me Deleted

@@ -1,2257 +0,0 @@
-.\" Copyright (c) 1986 The Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-.\"
-.\"	@(#)intro.me	6.4 (Berkeley) 7/17/89
-.\"
-.\" Modified for groff by jjc@jclark.com.
-.\"UC 7
-.ll 6.5i
-.lt 6.5i
-.ds MO @VERSION@
-.nr si 3n
-.he 'USING GROFF AND \-ME''%'
-.\"eh 'USD:22-%''Writing Papers with NROFF using \-me'
-.\"oh 'Writing Papers with NROFF using \-me''USD:22-%'
-.ds U \s-1UNIX\s0
-.ds N \s-1NROFF\s0
-.ds T \s-1TROFF\s0
-.ds G \s-1GROFF\s0
-.+c
-.(l C
-.sz 14
-.b "Writing Papers with GROFF using \-me"
-.sz
-.sp 2
-.ul
-Eric P. Allman*
-.(f
-*Author's current address:
-Britton Lee, Inc.,
-1919 Addison Suite 105,
-Berkeley, California 94704.
-.)f
-.sp
-Project INGRES
-Electronics Research Laboratory
-University of California, Berkeley
-Berkeley, California  94720
-.sp 2
-.i "Modified for \*G by James Clark"
-.)l
-.sp 4
-.pp
-This document describes
-the text processing facilities
-available on the \*U\(dg
-.(f
-\(dg\*U is a trademark
-of AT&T Bell Laboratories
-.)f
-operating system
-via \*G and the
-\-me
-macro package.
-It is assumed
-that the reader
-already is generally familiar
-with the \*U operating system
-and a text editor
-such as
-.b ex .
-This is intended to be a casual introduction,
-and
-as such not all material is covered.
-In particular,
-many variations and additional features
-of the \-me macro package
-are not explained.
-For a complete discussion of this
-and other issues,
-see
-.ul
-The \-me Reference Manual
-and
-.ul
-The \*N/\*T Reference Manual.
-.pp
-\*G, a computer program
-that runs on the \*U operating system,
-reads an input file
-prepared by the user
-and outputs a formatted paper
-suitable for publication or framing.
-The input consists of
-.i text ,
-or words to be printed,
-and
-.i requests ,
-which give instructions
-to the \*G program
-telling how to format the printed copy.
-.pp
-Section 1
-describes the basics
-of text processing.
-Section 2
-describes the basic requests.
-Section 3
-introduces displays.
-Annotations,
-such as footnotes,
-are handled in
-section 4.
-The more complex requests
-which are not discussed in section 2
-are covered in section 5.
-Finally,
-section 6
-discusses things you will need
-to know
-if you want to typeset documents.
-If you are a novice,
-you probably won't want to read beyond section 4
-until you have tried some of the basic features out.
-.pp
-When you have your raw text ready,
-call the \*G formatter by typing
-as a request to the \*U shell:
-.(b
-groff \-me \-T\c
-.i "type files"
-.)b
-where
-.i type
-describes the type of
-output device you are using.
-A complete description of options
-to the \*G command can be found in
-.b groff (1).
-.pp
-The word
-.i argument
-is used in this manual
-to mean a word or number
-which appears on the same line
-as a request
-which modifies the meaning
-of that request.
-For example,
-the request
-.(b
-\&.sp
-.)b
-spaces one line,
-but
-.(b
-\&.sp 4
-.)b
-spaces four lines.
-The number
-.b 4
-is an
-.i argument
-to the
-.b .sp
-request
-which says to space four lines
-instead of one.
-Arguments are separated from the request
-and from each other
-by spaces.
-.sh 1 "Basics of Text Processing"
-.pp
-The primary function
-of \*G
-is to
-.i collect
-words from input lines,
-.i fill
-output lines with those words,
-.i justify
-the right hand margin by inserting extra spaces
-in the line,
-and output the result.
-For example,
-the input:
-.(b
-Now is the time
-for all good men
-to come to the aid
-of their party.
-Four score and seven
-years ago,...
-.)b
-will be read,
-packed onto output lines,
-and justified
-to produce:
-.(b F
-Now is the time
-for all good men
-to come to the aid
-of their party.
-Four score and seven
-years ago,...
-.)b
-Sometimes you may want to start a new output line
-even though the line you are on
-is not yet full;
-for example,
-at the end of a paragraph.
-To do this
-you can cause a
-.i break ,
-which
-starts a new output line.
-Some requests
-cause a break automatically,
-as do blank input lines
-and input lines beginning with a space.
-.pp
-Not all input lines
-are text to be formatted.
-Some of the input lines
-are
-.i requests
-which describe
-how to format the text.
-Requests always have a period
-or an apostrophe
-(\c
-.q "\|\(aa\|" )
-as the first character
-of the input line.
-.pp
-The text formatter
-also does more complex things,
-such as automatically numbering pages,
-skipping over page folds,
-putting footnotes in the correct place,
-and so forth.
-.pp
-I can offer you a few hints
-for preparing text
-for input to \*G.
-First,
-keep the input lines short.
-Short input lines are easier to edit,
-and \*G will pack words onto longer lines
-for you anyhow.
-In keeping with this,
-it is helpful
-to begin a new line
-after every period,
-comma,
-or phrase,
-since common corrections
-are to add or delete sentences
-or phrases.
-Second,
-do not put spaces at the end of lines,
-since this can sometimes confuse the \*N
-processor.
-Third,
-do not hyphenate words at the end of lines
-(except words that should have hyphens in them,
-such as
-.q mother-in-law );
-\*G is smart enough to hyphenate words
-for you as needed,
-but is not smart enough
-to take hyphens out
-and join a word back together.
-Also,
-words such as
-.q mother-in-law
-should not be broken
-over a line,
-since then you will get a space
-where not wanted,
-such as
-.tr @-
-.nh
-.q "mother@\ in@law" .
-.br
-.tr @@
-.hy 14
-.sh 1 "Basic Requests"
-.sh 2 "Paragraphs"
-.pp
-Paragraphs are begun
-by using the
-.b .pp
-request.
-For example,
-the input:
-.(b
-\&.pp
-Now is the time for all good men
-to come to the aid of their party.
-Four score and seven years ago,...
-.)b
-produces a blank line
-followed by an indented first line.
-The result is:
-.(b F
-.ti +\n(piu
-Now is the time for all good men
-to come to the aid of their party.
-Four score and seven years ago,...
-.)b
-.pp
-Notice that the sentences
-of the paragraphs
-.i "must not"
-begin with a space,
-since blank lines
-and lines beginning with spaces
-cause a break.
-For example,
-if I had typed:
-.(b
-\&.pp
-Now is the time for all good men
-      to come to the aid of their party.
-Four score and seven years ago,...
-.)b
-The output would be:
-.(b F
-.ti +\n(piu
-Now is the time for all good men
-      to come to the aid of their party.
-Four score and seven years ago,...
-.)b
-A new line begins after the word
-.q men
-because the second line began with a space character.
-.pp
-There are many
-fancier
-types of paragraphs,
-which will be described later.
-.sh 2 "Headers and Footers"
-.pp
-Arbitrary headers and footers
-can be put
-at the top and bottom
-of every page.
-Two requests
-of the form
-.b .he \ \c
-.i title
-and
-.b .fo \ \c
-.i title
-define the titles to put at the head and the foot
-of every page,
-respectively.
-The titles are called
-.i three-part
-titles,
-that is,
-there is a left-justified part,
-a centered part,
-and a right-justified part.
-To separate these three parts
-the first character of
-.i title
-(whatever it may be)
-is used as a delimiter.
-Any character may be used,
-but
-backslash
-and double quote marks
-should be avoided.
-The percent sign
-is replaced by the current page number
-whenever found in the title.
-For example,
-the input:
-.(b
-\&.he \(aa\(aa%\(aa\(aa
-\&.fo \(aaJane Jones\(aa\(aaMy Book\(aa
-.)b
-results in the page number
-centered at the top
-of each page,
-.q "Jane Jones"
-in the lower left corner,
-and
-.q "My Book"
-in the lower right corner.
-.sh 2 "Double Spacing"
-.pp
-.ls 2
-\*G will double space output text automatically if you
-use the request
-.b ".ls\ 2" ,
-as is done in this section.
-You can revert to single spaced mode
-by typing
-.b ".ls\ 1" .
-.ls 1
-.sh 2 "Page Layout"
-.pp
-A number of requests allow
-you to change the way the printed copy looks,
-sometimes called the
-.i layout
-of the output page.
-Most of these requests adjust the placing
-of
-.q "white space"
-(blank lines or spaces).
-In these explanations,
-characters in italics
-should be replaced with values you wish to use;
-bold characters
-represent characters which should actually be typed.
-.pp
-The
-.b .bp
-request
-starts a new page.
-.pp
-The request
-.b .sp \ \c
-.i N
-leaves
-.i N
-lines of blank space.
-.i N
-can be omitted
-(meaning skip a single line)
-or can be of the form
-.i N \^\c
-.b i
-(for
-.i N
-inches)
-or
-.i N \^\c
-.b c
-(for
-.i N
-centimeters).
-For example, the input:
-.(b
-\&.sp 1.5i
-My thoughts on the subject
-\&.sp
-.)b
-leaves one and a half inches of space,
-followed by the line
-.q "My thoughts on the subject" ,
-followed by a single blank line.
-.pp
-This request will not leave space at the top of a page.
-If you need the requested space to appear regardless of page position,
-use the
-.b .bl
-macro, which has the same syntax as
-.b .sp
-but always leaves the requested space, even at the top of a page.
-.pp
-The
-.b .in \ \c
-.i +N
-request
-changes the amount of white space
-on the left of the page
-(the
-.i indent ).
-The argument
-.i N
-can be of the form
-.b + \c
-.i N
-(meaning leave
-.i N
-spaces more than you are already leaving),
-.b \- \c
-.i N
-(meaning leave less than you do now),
-or just
-.i N
-(meaning leave exactly
-.i N
-spaces).
-.i N
-can be of the form
-.i N \^\c
-.b i
-or
-.i N \^\c
-.b c
-also.
-For example,
-the input:
-.(b
-initial text
-\&.in 5
-some text
-\&.in +1i
-more text
-\&.in \-2c
-final text
-.)b
-produces
-.q "some text"
-indented exactly five spaces
-from the left margin,
-.q "more text"
-indented five spaces
-plus one inch
-from the left margin
-(fifteen spaces
-on a pica typewriter),
-and
-.q "final text"
-indented five spaces
-plus one inch
-minus two centimeters
-from the margin.
-That is,
-the output is:
-.(b
-initial text
-.in +5
-some text
-.in +1i
-more text
-.in -2c
-final text
-.)b
-.pp
-The
-.b .ti \ \c
-.i +N
-(temporary indent)
-request is used like
-.b .in \ \c
-.i +N
-when the indent
-should apply to one line only,
-after which it should revert
-to the previous indent.
-For example,
-the input:
-.(b
-\&.in 1i
-\&.ti 0
-Ware, James R.  The Best of Confucius,
-Halcyon House, 1950.
-An excellent book containing translations of
-most of Confucius\(aa most delightful sayings.
-A definite must for anyone interested in the early foundations
-of Chinese philosophy.
-.)b
-produces:
-.in 1i+\n($iu
-.ti \n($iu
-Ware, James R.  The Best of Confucius,
-Halcyon House, 1950.
-An excellent book containing translations of
-most of Confucius' most delightful sayings.
-A definite must for anyone interested in the early foundations
-of Chinese philosophy.
-.pp
-Text lines can be centered
-by using the
-.b .ce
-request.
-The line after the
-.b .ce
-is centered
-(horizontally)
-on the page.
-To center more than one line,
-use
-.b .ce \ \c
-.i N
-(where
-.i N
-is the number of lines to center),
-followed by the
-.i N
-lines.
-If you want to center many lines
-but don't want to count them,
-type:
-.(b
-\&.ce 1000
-lines to center
-\&.ce 0
-.)b
-The
-.b ".ce\ 0"
-request tells \*G to center zero more lines,
-in other words,
-stop centering.
-.pp
-All of these requests
-cause a break;
-that is,
-they always start
-a new line.
-If you want to start a new line
-without performing any other action,
-use
-.b .br .
-.sh 1 "Displays"
-.pp
-Displays are sections of text
-to be set off
-from the body of the paper.
-Major quotes,
-tables,
-and figures
-are types of displays,
-as are all the examples
-used in this document.
-All displays
-except centered blocks
-are output
-single spaced.
-.sh 2 "Major Quotes"
-.pp
-Major quotes
-are quotes which are several lines long,
-and hence are set in from the rest
-of the text
-without quote marks
-around them.
-These can be generated
-using the commands
-.b .(q
-and
-.b .)q
-to surround the quote.
-For example,
-the input:
-.(b
-As Weizenbaum points out:
-\&.(q
-It is said that to explain is to explain away.
-This maxim is nowhere so well fulfilled
-as in the areas of computer programming,...
-\&.)q
-.)b
-generates as output:
-.lp
-As Weizenbaum points out:
-.(q
-It is said that to explain is to explain away.
-This maxim is nowhere so well fulfilled
-as in the areas of computer programming,...
-.)q
-.sh 2 "Lists"
-.pp
-A
-.i list
-is an indented,
-single spaced,
-unfilled display.
-Lists should be used
-when the material to be printed
-should not be filled and justified
-like normal text,
-such as columns of figures
-or the examples used in this paper.
-Lists are surrounded
-by the requests
-.b .(l
-and
-.b .)l .
-For example,
-type:
-.(b
-Alternatives to avoid deadlock are:
-\&.(l
-Lock in a specified order
-Detect deadlock and back out one process
-Lock all resources needed before proceeding
-\&.)l
-.)b
-will produce:
-.br
-Alternatives to avoid deadlock are:
-.(l
-Lock in a specified order
-Detect deadlock and back out one process
-Lock all resources needed before proceeding
-.)l
-.sh 2 "Keeps"
-.pp
-A
-.i keep
-is a display of lines
-which are kept on a single page
-if possible.
-An example of where you would use a keep
-might be a diagram.
-Keeps differ from lists
-in that lists may be broken
-over a page boundary
-whereas keeps will not.
-.pp
-Blocks are the basic kind of keep.
-They begin with the request
-.b .(b
-and end with the request
-.b .)b .
-If there is not room on the current page
-for everything in the block,
-a new page is begun.
-This has the unpleasant effect
-of leaving blank space
-at the bottom of the page.
-When this is not appropriate,
-you can use the alternative,
-called
-.i "floating keeps" .
-.pp
-.i "Floating keeps"
-move relative to the text.
-Hence,
-they are good for things
-which will be referred to
-by name,
-such as
-.q "See figure 3" .
-A floating keep will appear
-at the bottom of the current page
-if it will fit;
-otherwise,
-it will appear at the top
-of the next page.
-Floating keeps begin with the line
-.b .(z
-and end with the line
-.b .)z .
-For an example of a floating keep,
-see figure 1.
-.(z
-.in 1i
-.xl -1i
-.hl
-\&.(z
-\&.hl
-Text of keep to be floated.
-\&.sp
-\&.ce
-Figure 1.  Example of a Floating Keep.
-\&.hl
-\&.)z
-.sp
-.ce
-Figure 1.  Example of a Floating Keep.
-.hl
-.)z
-The
-.b .hl
-request is used
-to draw a horizontal line
-so that the figure
-stands out from the text.
-.sh 2 "Fancier Displays"
-.pp
-Keeps and lists are normally collected in
-.i nofill
-mode,
-so that they are good for tables and such.
-If you want a display
-in fill mode
-(for text),
-type
-.b ".(l\ F"
-(Throughout this section,
-comments applied to
-.b .(l
-also apply to
-.b .(b
-and
-.b .(z ).
-This kind of display
-will be indented from both margins.
-For example,
-the input:
-.(b
-\&.(l F
-And now boys and girls,
-a newer, bigger, better toy than ever before!
-Be the first on your block to have your own computer!
-Yes kids, you too can have one of these modern
-data processing devices.
-You too can produce beautifully formatted papers
-without even batting an eye!
-\&.)l
-.)b
-will be output as:
-.(b F
-And now boys and girls,
-a newer, bigger, better toy than ever before!
-Be the first on your block to have your own computer!
-Yes kids, you too can have one of these modern
-data processing devices.
-You too can produce beautifully formatted papers
-without even batting an eye!
-.)b
-.pp
-Lists and blocks are also normally indented
-(floating keeps are normally left justified).
-To get a left-justified list,
-type
-.b ".(l\ L" .
-To get a list centered
-line-for-line,
-type
-.b ".(l C" .
-For example,
-to get a filled,
-left justified list, enter:
-.(b
-\&.(l L F
-text of block
-\&.)l
-.)b
-The input:
-.(b
-\&.(l
-first line of unfilled display
-more lines
-\&.)l
-.)b
-produces the indented text:
-.(b
-first line of unfilled display
-more lines
-.)b
-Typing the character
-.b L
-after the
-.b .(l
-request produces the left justified result:
-.(b L
-first line of unfilled display
-more lines
-.)b
-Using
-.b C
-instead of
-.b L
-produces the line-at-a-time centered output:
-.(b C
-first line of unfilled display
-more lines
-.)b
-.pp
-Sometimes it may be
-that you want to center several lines
-as a group,
-rather than centering them
-one line at a time.
-To do this
-use centered blocks,
-which are surrounded by the requests
-.b .(c
-and
-.b .)c .
-All the lines are centered as a unit,
-such that the longest line is centered
-and the rest are
-lined up around that line.
-Notice that lines
-do not move
-relative to each other
-using centered blocks,
-whereas they do
-using the
-.b C
-argument to keeps.
-.pp
-Centered blocks are
-.i not
-keeps,
-and may be used
-in conjunction
-with keeps.
-For example,
-to center a group of lines
-as a unit
-and keep them
-on one page,
-use:
-.(b
-\&.(b L
-\&.(c
-first line of unfilled display
-more lines
-\&.)c
-\&.)b
-.)b
-to produce:
-.(b L
-.(c
-first line of unfilled display
-more lines
-.)c
-.)b
-If the block requests
-(\c
-.b .(b
-and
-.b .)b )
-had been omitted
-the result would have been the same,
-but with no guarantee
-that the lines of the centered block
-would have all been on one page.
-Note the use of the
-.b L
-argument to
-.b .(b ;
-this causes the centered block
-to center within the entire line
-rather than within the line
-minus the indent.
-Also,
-the center requests
-must
-be nested
-.i inside
-the keep requests.
-.sh 1 "Annotations"
-.pp
-There are a number of requests
-to save text
-for later printing.
-.i Footnotes
-are printed at the bottom of the current page.
-.i "Delayed text"
-is intended to be a variant form
-of footnote;
-the text is printed only 
-when explicitly called for,
-such as at the end of each chapter.
-.i Indexes
-are a type of delayed text
-having a tag
-(usually the page number)
-attached to each entry
-after a row of dots.
-Indexes are also saved
-until called for explicitly.
-.sh 2 "Footnotes"
-.pp
-Footnotes begin with the request
-.b .(f
-and end with the request
-.b .)f .
-The current footnote number is maintained
-automatically,
-and can be used by typing \e**,
-to produce a footnote number\**.
-.(f
-\**Like this.
-.)f
-The number is automatically incremented
-after every footnote.
-For example,
-the input:
-.(b
-\&.(q
-A man who is not upright
-and at the same time is presumptuous;
-one who is not diligent and at the same time is ignorant;
-one who is untruthful and at the same time is incompetent;
-such men I do not count among acquaintances.\e**
-\&.(f
-\e**James R. Ware,
-\&.ul
-The Best of Confucius,
-Halcyon House, 1950.
-Page 77.
-\&.)f
-\&.)q
-.)b
-generates the result:
-.(q
-A man who is not upright
-and at the same time is presumptuous;
-one who is not diligent and at the same time is ignorant;
-one who is untruthful and at the same time is incompetent;
-such men I do not count among acquaintances.\**
-.(f
-\**James R. Ware,
-.ul
-The Best of Confucius,
-Halcyon House, 1950.
-Page 77.
-.)f
-.)q
-It is important
-that the footnote
-appears
-.i inside
-the quote,
-so that you can be sure
-that the footnote
-will appear
-on the same page
-as the quote.
-.sh 2 "Delayed Text"
-.pp
-Delayed text
-is very similar to a footnote
-except that it is printed
-when called for explicitly.
-This allows a list of
-references to
-appear
-(for example)
-at the end of each chapter,
-as is the convention in some disciplines.
-Use
-.b \e*#
-on delayed text
-instead of
-.b \e**
-as on footnotes.
-.pp
-If you are using delayed text
-as your standard reference mechanism,
-you can still use footnotes,
-except that you may want to reference them
-with special characters*
-.(f
-*Such as an asterisk.
-.)f
-rather than numbers.
-.sh 2 "Indexes"
-.pp
-An
-.q index
-(actually more like a table of contents,
-since the entries are not sorted alphabetically)
-resembles delayed text,
-in that it is saved until called for.
-However,
-each entry has the page number
-(or some other tag)
-appended to the last line
-of the index entry
-after a row of dots.
-.pp
-Index entries begin with the request
-.b .(x
-and end with
-.b .)x .
-The
-.b .)x
-request may have a argument,
-which is the value to print
-as the
-.q "page number" .
-It defaults to the current page number.
-If the page number given is an underscore
-(\c
-.q _ )
-no page number
-or line of dots
-is printed at all.
-To get the line of dots
-without a page number,
-type
-.b ".)x """"" ,
-which specifies an explicitly null page number.
-.pp
-The
-.b .xp
-request prints the index.
-.pp
-For example,
-the input:
-.(b
-\&.(x
-Sealing wax
-\&.)x
-\&.(x
-Cabbages and kings
-\&.)x _
-\&.(x
-Why the sea is boiling hot
-\&.)x 2.5a
-\&.(x
-Whether pigs have wings
-\&.)x ""
-\&.(x
-This is a terribly long index entry, such as might be used
-for a list of illustrations, tables, or figures; I expect it to
-take at least two lines.
-\&.)x
-\&.xp
-.)b
-generates:
-.(x
-Sealing wax
-.)x
-.(x
-Cabbages and kings
-.)x _
-.(x
-Why the sea is boiling hot
-.)x 2.5a
-.(x
-Whether pigs have wings
-.)x ""
-.(x
-This is a terribly long index entry, such as might be used
-for a list of illustrations, tables, or figures; I expect it to
-take at least two lines.
-.)x
-.xp
-.pp
-The
-.b .(x
-request may have a single character
-argument,
-specifying the
-.q name
-of the index;
-the normal index is
-.b x .
-Thus,
-several
-.q indices
-may be maintained simultaneously
-(such as a list of tables, table of contents, etc.).
-.pp
-Notice that the index must be printed
-at the
-.i end
-of the paper,
-rather than at the beginning
-where it will probably appear
-(as a table of contents);
-the pages may have to be physically rearranged
-after printing.
-.sh 1 "Fancier Features"
-.pp
-A large number of fancier requests
-exist,
-notably requests to provide other sorts of paragraphs,
-numbered sections of the form
-.b 1.2.3
-(such as used in this document),
-and multicolumn output.
-.sh 2 "More Paragraphs"
-.pp
-Paragraphs generally start with
-a blank line
-and with the first line
-indented.
-It is possible to get
-left-justified block-style paragraphs
-by using
-.b .lp
-instead of
-.b .pp ,
-as demonstrated by the next paragraph.
-.lp
-Sometimes you want to use paragraphs
-that have the
-.i body
-indented,
-and the first line
-exdented
-(opposite of indented)
-with a label.
-This can be done with the
-.b .ip
-request.
-A word specified on the same line as
-.b .ip
-is printed in the margin,
-and the body is lined up
-at a prespecified position
-(normally five spaces).
-For example,
-the input:
-.(b
-\&.ip one
-This is the first paragraph.
-Notice how the first line
-of the resulting paragraph lines up
-with the other lines in the paragraph.
-\&.ip two
-And here we are at the second paragraph already.
-You may notice that the argument to \c
-.b .ip
-appears
-in the margin.
-\&.lp
-We can continue text...
-.)b
-produces as output:
-.ip one
-This is the first paragraph.
-Notice how the first line of the resulting paragraph lines up
-with the other lines in the paragraph.
-.ip two
-And here we are at the second paragraph already.
-You may notice that the argument to
-.b .ip
-appears
-in the margin.
-.lp
-We can continue text without starting a new indented
-paragraph
-by using the
-.b .lp
-request.
-.pp
-If you have spaces in the label of a
-.b .ip
-request,
-you must use an
-.q "unpaddable space"
-instead of a regular space.
-This is typed as a backslash character
-(\c
-.q \e )
-followed by a space.
-For example,
-to print the label
-.q "Part 1" ,
-enter:
-.(b
-\&.ip "Part\e 1"
-.)b
-.pp
-If a label of an indented paragraph
-(that is, the argument to
-.b .ip )
-is longer than the space allocated for the label,
-.b .ip
-will begin a new line after the label.
-For example,
-the input:
-.(b
-\&.ip longlabel
-This paragraph had a long label.
-The first character of text on the first line
-will not line up with the text on second and subsequent lines,
-although they will line up with each other.
-.)b
-will produce:
-.ip longlabel
-This paragraph had a long label.
-The first character of text on the first line
-will not line up with the text on second and subsequent lines,
-although they will line up with each other.
-.pp
-It is possible to change the size of the label
-by using a second argument
-which is the size of the label.
-For example,
-the above example could be done correctly
-by saying:
-.(b
-\&.ip longlabel 10
-.)b
-which will make the paragraph indent
-10 spaces for this paragraph only.
-If you have many paragraphs to indent
-all the same amount,
-use the
-.i "number register"
-.b ii .
-For example, to leave one inch of space
-for the label,
-type:
-.(b
-\&.nr ii 1i
-.)b
-somewhere before the first call to
-.b .ip .
-Refer to the reference manual
-for more information.
-.pp
-If
-.b .ip
-is used
-with no argument at all
-no hanging tag will be printed.
-For example,
-the input:
-.(b
-\&.ip a
-This is the first paragraph of the example.
-We have seen this sort of example before.
-\&.ip
-This paragraph is lined up with the previous paragraph,
-but it has no tag in the margin.
-.)b
-produces as output:
-.ip a
-This is the first paragraph of the example.
-We have seen this sort of example before.
-.ip
-This paragraph is lined up with the previous paragraph,
-but it has no tag in the margin.
-.pp
-A special case of
-.b .ip
-is
-.b .np ,
-which automatically
-numbers paragraphs sequentially from 1.
-The numbering is reset at the next
-.b .pp ,
-.b .lp ,
-or
-.b .sh
-(to be described in the next section)
-request.
-For example,
-the input:
-.(b
-\&.np
-This is the first point.
-\&.np
-This is the second point.
-Points are just regular paragraphs
-which are given sequence numbers automatically
-by the .np request.
-\&.pp
-This paragraph will reset numbering by .np.
-\&.np
-For example,
-we have reverted to numbering from one now.
-.)b
-generates:
-.np
-This is the first point.
-.np
-This is the second point.
-Points are just regular paragraphs
-which are given sequence numbers automatically
-by the .np request.
-.pp
-This paragraph will reset numbering by .np.
-.np
-For example,
-we have reverted to numbering from one now.
-.pp
-The
-.b .bu
-request gives lists of this sort that are identified with
-bullets rather than numbers.
-The paragraphs are also crunched together.
-For example,
-the input:
-.(b
-\&.bu
-\&One egg yolk
-\&.bu
-\&One tablespoon cream or top milk
-\&.bu
-\&Salt, cayenne, and lemon juice to taste
-\&.bu
-\&A generous two tablespoonfuls of butter
-.)b
-produces\**:
-.(f
-\**By the way,
-if you put the first three ingredients in a a heavy, deep pan
-and whisk the ingredients madly over a medium flame
-(never taking your hand off the handle of the pot)
-until the mixture reaches the consistency of custard
-(just a minute or two),
-then mix in the butter off-heat,
-you will have a wonderful Hollandaise sauce.
-.)f
-.bu
-One egg yolk
-.bu
-One tablespoon cream or top milk
-.bu
-Salt, cayenne, and lemon juice to taste
-.bu
-A generous two tablespoonfuls of butter
-.sh 2 "Section Headings"
-.pp
-Section numbers
-(such as the ones used in this document)
-can be automatically generated
-using the
-.b .sh
-request.
-You must tell
-.b .sh
-the
-.i depth
-of the section number
-and a section title.
-The depth
-specifies how many numbers
-are to appear
-(separated by decimal points)
-in the section number.
-For example,
-the section number
-.b 4.2.5
-has a depth of three.
-.pp
-Section numbers
-are incremented
-in a fairly intuitive fashion.
-If you add a number
-(increase the depth),
-the new number starts out
-at one.
-If you subtract section numbers
-(or keep the same number)
-the final number is incremented.
-For example,
-the input:
-.(b
-\&.sh 1 "The Preprocessor"
-\&.sh 2 "Basic Concepts"
-\&.sh 2 "Control Inputs"
-\&.sh 3
-\&.sh 3
-\&.sh 1 "Code Generation"
-\&.sh 3
-.)b
-produces as output the result:
-.(b
-.b
-1.  The Preprocessor
-1.1.  Basic Concepts
-1.2.  Control Inputs
-1.2.1.
-1.2.2.
-2.  Code Generation
-2.1.1.
-.)b
-.pp
-You can specify the section number to begin
-by placing the section number after the section title,
-using spaces instead of dots.
-For example,
-the request:
-.(b
-\&.sh 3 "Another section" 7 3 4
-.)b
-will begin the section numbered
-.b 7.3.4 ;
-all subsequent
-.b .sh
-requests will number relative to this number.
-.pp
-There are more complex features
-which will cause each section to be indented
-proportionally to the depth of the section.
-For example, if you enter:
-.(b
-\&.nr si \c
-.i N
-.)b
-each section will be indented by an amount
-.i N .
-.i N
-must have a scaling factor attached,
-that is, it must be of the form
-.i Nx ,
-where
-.i x
-is a character telling what units
-.i N
-is in.
-Common values for
-.i x
-are
-.b i
-for inches,
-.b c
-for centimeters,
-and
-.b n
-for
-.i ens
-(the width of a single character).
-For example,
-to indent each section
-one-half inch,
-type:
-.(b
-\&.nr si 0.5i
-.)b
-After this,
-sections will be indented by
-one-half inch
-per level of depth in the section number.
-For example,
-this document was produced
-using the request
-.(b
-\&.nr si 3n
-.)b
-at the beginning of the input file,
-giving three spaces of indent
-per section depth.
-.pp
-Section headers without automatically generated numbers
-can be done using:
-.(b
-\&.uh "Title"
-.)b
-which will do a section heading,
-but will put no number on the section.
-.sh 2 "Parts of the Basic Paper"
-.pp
-There are some requests
-which assist in setting up
-papers.
-The
-.b .tp
-request
-initializes for a title page.
-There are no headers or footers
-on a title page,
-and unlike other pages
-you can space down
-and leave blank space
-at the top.
-For example,
-a typical title page might appear as:
-.(b
-\&.tp
-\&.sp 2i
-\&.(l C
-THE GROWTH OF TOENAILS
-IN UPPER PRIMATES
-\&.sp
-by
-\&.sp
-Frank N. Furter
-\&.)l
-\&.bp
-.)b
-.pp
-The
-.b .+c \ \c
-.i T
-request can be used
-to start chapters.
-Each chapter is automatically numbered
-from one,
-and a heading is printed at the top of each chapter
-with the chapter number
-and the chapter name
-.i T .
-For example,
-to begin a chapter called
-.q Conclusions ,
-use the request:
-.(b
-\&.+c "CONCLUSIONS"
-.)b
-which will produce,
-on a new page,
-the lines
-.(b C
-CHAPTER 5
-CONCLUSIONS
-.)b
-with appropriate spacing for a thesis.
-Also, the header is moved to the foot of the page
-on the first page of a chapter.
-Although the
-.b .+c
-request was not designed to work only with the
-.b .th
-request,
-it is tuned for the format acceptable
-for a PhD thesis
-at Berkeley.
-.pp
-If the
-title parameter
-.i T
-is omitted from the
-.b .+c
-request,
-the result is a chapter with no heading.
-This can also be used at the beginning
-of a paper;
-for example,
-.b .+c
-was used to generate page one
-of this document.
-.pp
-Although
-papers traditionally have the abstract,
-table of contents,
-and so forth at the front of the paper,
-it is more convenient to format
-and print them last
-when using \*G.
-This is so that index entries
-can be collected and then printed
-for the table of contents
-(or whatever).
-At the end of the paper,
-issue the
-.b ".++ P"
-request,
-which begins the preliminary part
-of the paper.
-After issuing this request,
-the
-.b .+c
-request will begin a preliminary section
-of the paper.
-Most notably,
-this prints the page number
-restarted from one
-in lower case Roman numbers.
-.b .+c
-may be used repeatedly
-to begin different parts of the
-front material
-for example,
-the abstract,
-the table of contents,
-acknowledgments,
-list of illustrations,
-etc.
-The request
-.b ".++ B"
-may also be used
-to begin the bibliographic section
-at the end of the paper.
-For example,
-the paper might appear
-as outlined in figure 2.
-(In this figure,
-comments begin with the sequence
-.b \e" .)
-.(z
-.hl
-.if t .in 0.5i
-.if t .ta 2i
-.if n .ta 3i
-\&.th	\e" set for thesis mode
-\&.fo \(aa\(aaDRAFT\(aa\(aa	\e" define footer for each page
-\&.tp	\e" begin title page
-\&.(l C	\e" center a large block
-THE GROWTH OF TOENAILS
-IN UPPER PRIMATES
-\&.sp
-by
-\&.sp
-Frank Furter
-\&.)l	\e" end centered part
-\&.+c INTRODUCTION	\e" begin chapter named "INTRODUCTION"
-\&.(x t	\e" make an entry into index `t'
-Introduction
-\&.)x	\e" end of index entry
-text of chapter one
-\&.+c "NEXT CHAPTER"	\e" begin another chapter
-\&.(x t	\e" enter into index `t' again
-Next Chapter
-\&.)x
-text of chapter two
-\&.+c CONCLUSIONS
-\&.(x t
-Conclusions
-\&.)x
-text of chapter three
-\&.++ B	\e" begin bibliographic information
-\&.+c BIBLIOGRAPHY	\e" begin another `chapter'
-\&.(x t
-Bibliography
-\&.)x
-text of bibliography
-\&.++ P	\e" begin preliminary material
-\&.+c "TABLE OF CONTENTS"
-\&.xp t	\e" print index `t' collected above
-\&.+c PREFACE	\e" begin another preliminary section
-text of preface
-.sp 2
-.in 0
-.ce
-Figure 2.  Outline of a Sample Paper
-.hl
-.)z
-.sh 2 "Equations and Tables"
-.pp
-Two special \*U programs exist
-to format special types of material.
-.b Eqn
-sets equations.
-.b Tbl
-arranges to print
-extremely pretty tables
-in a variety of formats.
-This document will only describe
-the embellishments
-to the standard features;
-consult the reference manuals
-for those processors
-for a description of their use.
-.pp
-The
-.b eqn
-program is described fully
-in the document
-.ul
-Typesetting Mathematics \- User's Guide
-by Brian W. Kernighan
-and Lorinda L. Cherry.
-Equations are centered,
-and are kept on one page.
-They are introduced by the
-.b .EQ
-request and terminated by the
-.b .EN
-request.
-.pp
-The
-.b .EQ
-request may take an
-equation number as an
-optional argument,
-which is printed vertically centered
-on the right hand side
-of the equation.
-If the equation becomes too long
-it should be split
-between two lines.
-To do this, type:
-.(b
-\&.EQ (eq 34)
-text of equation 34
-\&.EN C
-\&.EQ
-continuation of equation 34
-\&.EN
-.)b
-The
-.b C
-on the
-.b .EN
-request
-specifies that the equation
-will be continued.
-.pp
-The
-.b tbl
-program produces tables.
-It is fully described
-(including numerous examples)
-in the document
-.ul
-Tbl \- A Program to Format Tables
-by M. E. Lesk.
-Tables begin with the
-.b .TS
-request
-and end with the
-.b .TE
-request.
-Tables are normally kept on a single page.
-If you have a table which is too big
-to fit on a single page,
-so that you know it will extend
-to several pages,
-begin the table with the request
-.b ".TS\ H"
-and put the request
-.b .TH
-after the part of the table
-which you want
-duplicated at the top of every page
-that the table is printed on.
-For example, a table definition
-for a long table might look like:
-.ds TA \|\h'.4n'\v'-.2n'\s-4\zT\s0\v'.2n'\h'-.4n'\(ci\|
-.if n .ds TA \ \o'-T'\ \"
-.(b
-\&.TS H
-c s s
-n n n.
-THE TABLE TITLE
-\&.TH
-text of the table
-\&.TE
-.)b
-.pp
-.sh 2 "Two Column Output"
-.pp
-You can get two column output
-automatically
-by using the request
-.b .2c .
-This causes everything after it
-to be output in two-column form.
-The request
-.b .bc
-will start a new column;
-it differs from
-.b .bp
-in that
-.b .bp
-may leave a totally blank column
-when it starts a new page.
-To revert to single column output,
-use
-.b .1c .
-.sh 2 "Defining Macros"
-.pp
-A
-.i macro
-is a collection of requests and text
-which may be used
-by stating a simple request.
-Macros begin with the line
-.b ".de" \ \c
-.i xx
-(where
-.i xx
-is the name of the macro to be defined)
-and end with the line consisting of two dots.
-After defining the macro,
-stating the line
-.b . \c
-.i xx
-is the same as stating all the other lines.
-For example,
-to define a macro
-that spaces 3 lines
-and then centers the next input line,
-enter:
-.(b
-\&.de SS
-\&.sp 3
-\&.ce
-\&..
-.)b
-and use it by typing:
-.(b
-\&.SS
-\&Title Line
-(beginning of text)
-.)b
-.pp
-Macro names may be one or two characters.
-In order to avoid conflicts
-with names in \-me,
-always use upper case letters as names.
-The only names to avoid are
-.b TS ,
-.b TH ,
-.b TE ,
-.b EQ ,
-and
-.b EN .
-.sh 2 "Annotations Inside Keeps"
-.pp
-Sometimes you may want to put
-a footnote
-or index entry inside a keep.
-For example,
-if you want to maintain a
-.q "list of figures"
-you will want to do something like:
-.(b
-\&.(z
-\&.(c
-text of figure
-\&.)c
-\&.ce
-Figure 5.
-\&.(x f
-Figure 5
-\&.)x
-\&.)z
-.)b
-which you may hope
-will give you a figure
-with a label
-and an entry in the index
-.b f
-(presumably a list of figures index).
-Unfortunately,
-the
-index entry
-is read and interpreted
-when the keep is read,
-not when it is printed,
-so the page number in the index is likely to be wrong.
-The solution is to use the magic string
-.b \e!
-at the beginning of all the lines dealing with the index.
-In other words,
-you should use:
-.(b
-\&.(z
-\&.(c
-Text of figure
-\&.)c
-\&.ce
-Figure 5.
-\e!.(x f
-\e!Figure 5
-\e!.)x
-\&.)z
-.)b
-which will defer the processing of the index
-until the figure is output.
-This will guarantee
-that the page number in the index
-is correct.
-The same comments apply
-to
-blocks
-(with
-.b .(b
-and
-.b .)b )
-as well.
-.sh 1 "\*T and the Photosetter"
-.pp
-With a little care,
-you can prepare
-documents that
-will print nicely
-on either a regular terminal
-or when phototypeset
-using the \*T formatting program.
-.sh 2 "Fonts"
-.pp
-A
-.i font
-is a style of type.
-There are three fonts
-that are available simultaneously,
-Times Roman,
-Times Italic,
-and Times Bold,
-plus the special math font.
-The normal font is Roman.
-.pp
-There are ways of switching between fonts.
-The requests
-.b .r ,
-.b .i ,
-.b .b ,
-and
-.b .bi
-switch to Roman,
-italic,
-bold,
-and bold-italic fonts respectively.
-You can set a single word
-in some font
-by typing (for example):
-.(b
-\&.i word
-.)b
-which will set
-.i word
-in italics
-but does not affect the surrounding text.
-.pp
-Notice that if you are setting more than one word
-in whatever font,
-you must surround that word with double quote marks
-(`\|"\|')
-so that it will appear to the \*G processor as a single word.
-The quote marks will not appear in the formatted text.
-If you do want a quote mark to appear,
-you should quote the entire string
-(even if a single word),
-and use
-.i two
-quote marks where you want one to appear.
-For example,
-if you want to produce the text:
-.(b
-.i """Master Control\|"""
-.)b
-in italics, you must type:
-.(b
-\&.i """Master Control\e|"""
-.)b
-The
-.b \e|
-produces a very narrow space
-so that the
-.q l
-does not overlap the quote sign in \*G,
-like this:
-.(b
-.i """Master Control"""
-.)b
-.pp
-There are also some
-.q pseudo-fonts
-available.
-The input:
-.(b
-\&.(b
-\&.u underlined
-\&.bx "words in a box"
-\&.)b
-.)b
-generates
-.(b
-.u underlined
-.bx "words in a box"
-.)b
-Notice that pseudo font requests
-set only the single parameter in the pseudo font;
-ordinary font requests will begin setting all text
-in the special font
-if you do not provide a parameter.
-No more than one word
-should appear
-with these three font requests
-in the middle of lines.
-This is because
-of the way \*G justifies text.
-For example,
-if you were to issue the requests:
-.(b
-\&.u "some bold italics"
-and
-\&.bx "words in a box"
-.)b
-in the middle of a line
-\*G would produce
-.u "some bold italics"
-and
-.bx "words in a box" ,\p
-which I think you will agree does not look good.
-.pp
-The second parameter
-of all font requests
-is set in the original font.
-For example,
-the font request:
-.(b
-\&.b bold face
-.)b
-generates
-.q bold
-in bold font,
-but sets
-.q face
-in the font of the surrounding text,
-resulting in:
-.(b
-.b bold face.
-.)b
-To set the two words
-.b bold
-and
-.b face
-both in
-.b "bold face" ,
-type:
-.(b
-\&.b "bold face"
-.)b
-.pp
-You can mix fonts in a word by using the
-special sequence
-.b \ec
-at the end of a line
-to indicate
-.q "continue text processing" ;
-this allows input lines
-to be joined together
-without a space between them.
-For example, the input:
-.(b
-\&.u under \ec
-\&.i italics
-.)b
-generates
-.u under \c
-.i italics ,
-but if we had typed:
-.(b
-\&.u under
-\&.i italics
-.)b
-the result would have been
-.u under
-.i italics
-as two words.
-.sh 2 "Point Sizes"
-.pp
-The phototypesetter
-supports different sizes of type,
-measured in points.
-The default point size
-is 10 points
-for most text,
-8 points for footnotes.
-To change the pointsize,
-type:
-.(b
-\&.sz \c
-.i +N
-.)b
-where
-.i N
-is the size wanted in points.
-The
-.i "vertical spacing"
-(distance between the bottom of most letters
-(the
-.i baseline )
-between adjacent lines)
-is set to be proportional
-to the type size.
-.pp
-These pointsize changes are
-.i temporary !!!
-For example,
-to reset the pointsize of basic text to twelve point, use:
-.(b
-\&.nr pp 12
-\&.nr sp 12
-\&.nr tp 12
-.)b
-to reset the default pointsize of
-paragraphs,
-section headers,
-and titles respectively.
-If you only want to set the names of sections in a larger pointsize,
-use:
-.(b
-\&.nr sp 11
-.)b
-alone \*- this sets section titles
-(e.g.,
-.b "Point Sizes"
-above)
-in a larger font than the default.
-.pp
-A single word or phrase can be set in a smaller pointsize
-than the surrounding text
-using the
-.b .sm
-request.
-This is especially convenient for words that are all capitals,
-due to the optical illusion that makes them look even larger
-than they actually are.
-For example:
-.(b
-\&.sm UNIX
-.)b
-prints as
-.sm UNIX
-rather than
-UNIX.
-.\" Dave Kemper notes that the following probably has not been true
-.\" since 1986; keeping (but commented) for historical interest.
-.\" .pp
-.\" Warning:
-.\" changing point sizes
-.\" on the phototypesetter
-.\" is a slow mechanical operation.
-.\" On laser printers it may require loading new fonts.
-.\" Size changes
-.\" should be considered carefully.
-.sh 2 "Quotes"
-.pp
-It is conventional when using
-the typesetter to
-use pairs of grave and acute accents
-to generate double quotes,
-rather than the
-double quote character
-(`\|"\|').
-This is because it looks better
-to use grave and acute accents;
-for example, compare
-"quote" to
-``quote''.
-.pp
-You may use the sequences
-.b \e*(lq
-and
-.b \e*(rq
-to stand for the left and right quote
-respectively.
-For example,
-use:
-.(b
-\e*(lqSome things aren\(aat true
-even if they did happen.\e*(rq
-.)b
-to generate the result:
-.(b
-.q "Some things aren't true even if they did happen."
-.)b
-As a shorthand,
-the special font request:
-.(b
-\&.q "quoted text"
-.)b
-will generate
-.q "quoted text" .
-Notice that you must surround
-the material to be quoted
-with double quote marks
-if it is more than one word.
-.sh 0
-.sp 1i
-.b Acknowledgments
-.pp
-I would like to thank
-Bob Epstein,
-Bill Joy,
-and Larry Rowe
-for having the courage
-to use the \-me macros
-to produce non-trivial papers
-during the development stages;
-Ricki Blau,
-Pamela Humphrey,
-and Jim Joyce
-for their help with the documentation phase;
-peter kessler
-for numerous complaints years after I was
-.q done
-with this project,
-most accompanied by fixes
-(hence forcing me to fix several small bugs);
-and the plethora of people who have contributed ideas
-and have given support for the project.
-.sp 1i
-This document applies to the version of the \-me macros
-included with \*G version \*(MO.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/doc/meintro_fr.me Deleted

@@ -1,2285 +0,0 @@
-.\" -*- coding: utf-8 -*- (for preconv; for Emacs, see end of file)
-.\"
-.\" Copyright (c) 1986 The Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley. The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-.\"
-.\" @(#)intro.me 6.4 (Berkeley) 7/17/89
-.\"
-.\" Modified for groff by jjc@jclark.com.
-.\"
-.\" Translated to French by Grégoire Babey <gibux@gmx.ch>
-.\"UC 7
-.ll 6.5i
-.lt 6.5i
-.ds MO @VERSION@
-.nr si 3n
-.he 'GROFF EN OPTION \-ME''%'
-.\"eh 'USD:22-%''Writing Papers with NROFF using \-me'
-.\"oh 'Writing Papers with NROFF using \-me''USD:22-%'
-.ds U \s-1UNIX\s0
-.ds N \s-1NROFF\s0
-.ds T \s-1TROFF\s0
-.ds G \s-1GROFF\s0
-.+c
-.(l C
-.sz 14
-.b "Rédiger des documents avec GROFF \-me"
-.sz
-.sp 2
-.ul
-Eric P. Allman
-.sp
-Projet INGRES
-Electronics Research Laboratory
-University of California, Berkeley
-Berkeley, California 94720
-.sp 2
-.i "Modifié pour \*G by James Clark"
-.sp 2
-.i "Adapté au français par Grégoire Babey"
-.)l
-.sp 2
-.pp
-Ce document décrit les outils de traitement de texte
-sur un système \*U\(lz
-.(f
-\(lz\*U est une marque déposée de AT&T Bell Laboratories
-.)f
-fournis par \*G
-et le
-paquet de macros
-\-me.
-Il présuppose que le lecteur 
-est déjà familiarisé avec les systèmes \*U
-et un éditeur de texte
-(tel que par exemple
-.b ex
-).
-Son intention est d'être une introduction
-simple et concrète, et par conséquent,
-il ne traitera pas toute la matière disponible.
-En particulier,
-de nombreuses variantes et fonctionnalités supplémentaires
-du paquet de macros \-me ne seront pas décrites.
-Pour une discussion plus complète de telle ou telle fonctionnalité, voyez
-.ul
-The \-me Reference Manual
-et
-.ul
-The \*N/\*T Reference Manual.
-.pp
-\*G, est un logiciel
-fonctionnant sur le système d'exploitation \*U.
-Il lit un fichier d'entrée
-préparé par l'utilisateur
-et sort un texte formaté,
-prêt à être publié ou mis en page.
-Le fichier d'entrée est formé de 
-.i texte ,
-les mots destinés à être imprimés,
-et de
-.i requêtes ,
-qui donnent des instructions au programme \*G
-et lui indiquent quelle forme donner à la copie imprimée.
-.br
-.sp
-Chapitre 1:	décrit les éléments de base du traitement de texte.
-
-Chapitre 2:	décrit les requêtes de base.
-
-Chapitre 3:	introduit les mises en évidence: citations, tableaux, figures.
-
-Chapitre 4:	annotations (notes en bas de page, texte différé, index).
-
-Chapitre 5:	requêtes plus complexes, n'ayant pu être traitées au chapitre 2.
-
-Chapitre 6:	les choses que vous devez savoir pour pouvoir rédiger des documents.
-.sp 2
-.br
-Si vous êtes novice, vous ne voudrez sans doute pas attendre d'avoir lu jusqu'au chapitre 4 pour tester par vous mêmes les fonctions de base du programme.
-Quand votre texte sera prêt à être traité,
-appelez le formateur \*G en tapant
-cette commande dans votre shell \*U (ou terminal):
-.(b
-groff \-me \-k \ foo > \ foo.ps
-.)b
-L'option -k tient compte des caractères accentués propres au français.
-.br
-Remplacez foo par le nom de votre fichier qui devra être en un mot.
-.br
-Le fichier devra être placé dans votre répertoire personnel, sinon remplacez foo par le chemin du fichier.
-.br
-À la place de .ps, vous pouvez mettre .pdf ou le format que vous désirez obtenir.
-.sp
-Vous trouverez un description plus complète des options pour la commande \*G en tapant
-.b "man groff"
-dans votre terminal ou console.
-.pp
-Le mot
-.i argument
-est utilisé dans ce manuel
-pour décrire un mot ou un nombre
-qui apparait sur la même ligne qu'une requête
-en modifiant le sens de cette requête.
-Par exemple,
-la requête
-.(b
-\&.sp
-.)b
-met un espace après une ligne,
-mais
-.(b
-\&.sp 4
-.)b
-met 4 espaces après une ligne.
-Le nombre
-.b 4
-est un
-.i argument
-de la requête
-.b .sp
-qui lui dit d'espacer de quatre lignes
-au lieu d'une.
-Les arguments sont séparés de la requête et des autres arguments
-par un espacement.
-.sh 1 "Éléments de base du traitement de texte"
-.pp
-La fonction primaire
-de \*G
-est de
-.i collecter
-des mots sur les lignes du fichier d'entrée, de
-.i remplir
-de ces mots les lignes du ficher de sortie, de
-.i justifier
-le texte sur la marge de droite
-en insérant des espaces supplémentaires entre les mots,
-et de rendre le fichier de sortie.
-Par exemple,
-l'entrée:
-.(b
-Maintenant il est temps
-pour tous les hommes bons
-de venir en aide
-à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-sera lu,
-rendu dans des lignes de sortie,
-et justifié,
-ce qui produira:
-.(b F
-Maintenant il est temps
-pour tous les hommes bons
-de venir en aide
-à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-Parfois, vous désirerez commencer une nouvelle ligne, même si la ligne actuelle n'est pas encore pleine;
-par exemple,
-à la fin d'un paragraphe.
-Pour y parvenir,
-vous pouvez provoquer une
-.i interruption:
-une ligne d'entrée vide, ou une nouvelle ligne commençant par un espacement 
-provoquent le début d'une nouvelle ligne.
-Certaines requêtes provoquent automatiquement une interruption.
-.pp
-Les lignes d'entrée ne sont pas toutes destinées à être formatées (voir plus bas).
-Certaines lignes sont des
-.i requêtes
-qui décrivent
-comment le texte doit être formaté.
-Les requêtes commencent toujours par un point ou une apostrophe
-(\c
-.q "\|\(aa\|" ).
-.pp
-Le formateur de texte effectue aussi des tâches plus complexes,
-comme la numérotation automatique des pages,
-le saut de page automatique,
-le placement des notes en bas de page au bon endroit,
-et ainsi de suite.
-.pp
-Je peux vous donner quelques conseils
-comment préparer votre texte d'entrée pour  \*G.
-Premièrement,
-écrivez des lignes d'entrée courtes.
-Des lignes d'entrée courtes seront plus faciles à modifier,
-et de toutes façons, \*G les saisira pour vous en lignes plus longues.
-En accord avec cette idée,
-il est pratique de commencer une
-nouvelle ligne après
-chaque virgule ou point,
-puisque habituellement les corrections consistent à
-modifier ou supprimer des propositions ou des phrases.
-Deuxièmement,
-n'ajoutez pas d'espacements à la fin des lignes,
-ceci pourrait en certains cas induire en erreur le processeur \*N.
-Troisièmement,
-ne séparez pas vous-même les mots en fin de ligne avec des traits d'union
-(excepté les mots qui en contiennent naturellement,
-comme
-.q belle-mère );
-\*G est assez futé pour séparer pour vous les mots qui doivent l'être,
-mais il ne l'est pas assez pour réunir les syllabes
-que vous auriez séparées vous-même.
-Ainsi,
-des mots tels que
-.q belle-mère
-ne devraient pas être écrit sur deux lignes,
-sinon vous obtiendrez un espacement là ou vous n'en vouliez pas,
-comme ici par exemple:
-.tr @-
-.nh
-.q "belle@\ mère" .
-.br
-.tr @@
-.hy 14
-.sh 1 "Requêtes de base"
-.sh 2 "Paragraphes"
-.pp
-On commence un nouveau paragraphe
-en utilisant la requête
-.b .pp .
-Par exemple,
-l'entrée:
-.(b
-\&.pp
-Maintenant il est temps pour tous les hommes bons
-de venir en aide à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-donne un ligne d'espacement, suivie d'une ligne indentée.
-Le résultat est:
-.(b F
-.ti +\n(piu
-Maintenant il est temps pour tous les hommes bons
-de venir en aide à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-.pp
-Notez que les phrases d'un paragraphes ne
-.i "devront pas"
-commencer par un espacement,
-puisque une ligne d'espacement ou un espace en début de ligne
-provoque une interruption.
-Par exemple,
-si je tapais:
-.(b
-\&.pp
-Maintenant il est temps pour tous les hommes bons
-      de venir en aide à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-La sortie serait:
-.(b F
-.ti +\n(piu
-Maintenant il est temps pour tous les hommes bons
-      de venir en aide à leur parti.
-Il y a quatre-vingt-sept ans...
-.)b
-Une nouvelle ligne commence après le mot
-.q bons
-parce que la deuxième ligne d'entrée a été commencée avec un espacement.
-.pp
-Il existe beaucoup de types de paragraphes plus élaborés,
-qui seront décrits plus tard.
-.sh 2 "En-têtes et pied de page "
-.pp
-On peut ajouter si on veut des en-têtes et des pieds de page.
-Deux requêtes
-ayant la forme de
-.b .he \ \c
-.i titre
-and
-.b .fo \ \c
-.i titre
-définissent les titres à mettre respectivement en haut et en pied de page.
-Ces titres sont appelés titres
-.i "en trois parties"
-:
-une première partie est justifiée sur la gauche, la deuxième est centrée, la troisième justifiée sur la droite. Les trois parties sont séparées par des apostrophes.
-Le signe %, si il est présent dans le titre, sera automatiquement remplacé par le numéro de page courant.
-Par exemple l'entrée:
-.(b
-\&.he \(aa\(aa%\(aa\(aa
-.)b
-donnera le numéro de page courant centré sur chaque page.
-.(b
-\&.he \(aa\(aa\(aa%\(aa
-.)b
-donnera le numéro de page jusifié à droite sur chaque page.
-.(b
-\&.he \(aaGroff -me\(aaTraduction\(aa%\(aa
-.)b
-donnera à gauche "Groff -me", au centre "Traduction" et à droite le numéro de page courant.
-.br
-Les éléments de l'en-tête peuvent débuter par n'importe quelle lettre, mais antislash et guillemets sont à éviter.
-La commande
-.b .fo
-fonctionne de manière analogue.
-.sh 2 "Double espacement"
-.pp
-.ls 2
-\*G insère un double espacement vertical dans le texe de sortie
-si vous utilisez la requête
-.b ".ls\ 2" ,
-comme cela a été fait ici.
-Vous pouvez retourner à l'espacement vertical simple en tapant
-.b ".ls\ 1" .
-.ls 1
-.sh 2 "Layout de la page"
-.pp
-Un certain nombre de requêtes vous permettent de modifier la présentation de la copie imprimée, ce qu'on appelle le
-.i layout
-de la page de sortie.
-La plupart de ces requêtes ajustent dans le texte des
-.q "espaces blancs"
-(espacement, espacement vertical).
-Dans les explications qui suivent, les caractères en italique
-doivent être remplacés par les valeurs que vous souhaitez;
-les caractères gras
-devront être tapés tels quels.
-.pp
-La requête
-.b .bp
-commence une nouvelle page.
-.pp
-La requête
-.b .sp \ \c
-.i N
-laisse
-.i N
-lignes d'espacement vertical.
-.i N
-peut être négligé
-(dans ce cas, il n'y aura qu'une ligne d'espacement),
-ou peut prendre la forme
-.i N \^\c
-.b i
-(pour
-.i N
-pouces)
-or
-.i N \^\c
-.b c
-(pour
-.i N
-centimètres).
-Par exemple, l'entrée:
-.(b
-\&.sp 3.5c
-Mes pensées sur le sujet
-\&.sp
-.)b
-laissera trois centimètres et demi d'espace sur la gauche,
-suivis de la ligne
-.q "Mes pensées sur le sujet" ,
-suivie elle-même d'un espacement vertical.
-.pp
-Cette requête ne laissera pas d'espacement vertical en haut d'une page.
-Si vous avez besoin que l'espacement apparaisse quelque soit la position sur la page,
-utilisez la macro
-.b .bl
-, qui a la même syntaxe que
-.b .sp
-mais qui ajoutera toujours l'espacement demandé, même en haut d'une page.
-.pp
-La requête
-.b .in \ \c
-.i +N
-change le nombre d'espacements sur la gauche de la page
-(l'
-.i indentation).
-L'argument
-.i N
-peut avoir la forme
-.b + \c
-.i N
-(ce qui veut dire
-.i N
-espacements de plus que ce qu'il y avait avant),
-.b \- \c
-.i N
-(ce qui veut dire
-.i N
-espacements de moins que ce qu'il y avait avant),
-ou juste
-.i N
-(ce qui veut dire exactement
-.i N
-espacements).
-.i N
-peut aussi avoir la forme
-.i N \^\c
-.b i
-ou
-.i N \^\c
-.b c .
-Par exemple,
-l'entrée:
-.(b
-texte initial
-\&.in 5
-plus de texte
-\&.in +1i
-encore plus de texte
-\&.in \-2c
-fin du texte
-.)b
-produit
-.q "texte initial"
-justifié à gauche
-.q "plus de texte"
-indenté à 5 espacements
-de la marge de gauche,
-.q "encore plus d texte"
-indenté à 5 espacements
-plus un pouce
-de la marge de gauche
-(15 espacements sur une machine à écrire à picas),
-et
-.q "fin du texte"
-à 5 espacements
-plus un pouce
-moins deux centimètres
-de la marge de gauche.
-C'est à dire la sortie suivante:
-.(b
-texte initial
-.in +5
-plus de texte
-.in +1i
-encore plus de texte
-.in -2c
-fin du texte
-.)b
-.pp
-La requête
-.b .ti \ \c
-.i +N
-(indentation temporaire)
-est utilisée de la même manière que
-.b .in \ \c
-.i +N
-quand l'indentation ne concerne qu'une seule ligne,
-après quoi on retourne à l'indentation initiale.
-Par exemple,
-l'entrée:
-.(b
-\&.in 1i
-\&.ti 0
-Ware, James R. The Best of Confucius,
-Halcyon House, 1950.
-Un livre excellent,
-qui présente en traduction (anglaise)
-les phrases les plus délicieuses de Confucius.
-Décidément un passage obligé
-pour tous ceux qui s'intéressent
-au fondements primitifs de la philosophie chinoise.
-.)b
-produira:
-.sp 2
-.in 1i+\n($iu
-.ti \n($iu
-Ware, James R. The Best of Confucius,
-Halcyon House, 1950.
-Un livre excellent, qui présente
-en traduction (anglaise) les phrases les plus délicieuses de Confucius.
-Décidément un passage obligé pour tous ceux qui s'intéressent au fondements primitifs de la philosophie chinoise.
-.pp
-Les lignes de texte peuvent être centrées en utilisant la requête
-.b .ce .
-La ligne qui suit
-.b .ce
-est centrée (horizontalement)
-sur la page.
-Pour centrer plus qu'une ligne,
-utilisez
-.b .ce \ \c
-.i N
-(où
-.i N
-est le nombre de lignes à centrer),
-suivi de
-.i N
-lignes.
-Si vous voulez centrer plusieurs lignes, mais vous vous refusez à les compter,
-tapez:
-.(b
-\&.ce 1000
-lignes à centrer
-\&.ce 0
-.)b
-Cette requête
-.b ".ce\ 0"
-dit à \*G de ne centrer plus que 0 lignes,
-c'est à dire,
-d'arrêter de centrer.
-.pp
-Toutes ces requêtes provoquent une interruption;
-c'est à dire qu'elles commencent toutes une nouvelle ligne.
-Si vous voulez commencer une nouvelle ligne sans rien faire d'autre,
-utilisez
-.b .br .
-.sh 1 "Mises en évidences"
-.pp
-Les mises en évidences sont des passages de textes sortis du corps de texte.
-Citations,
-tableaux
-et figures
-sont des types de mise en évidence,
-comme le sont tous les exemples
-exposés dans ce document.
-Toutes les mises en évidence,
-exceptés les blocs centrés,
-sont précédés et suivis en sortie d'un seul espacement vertical.
-.sh 2 "Citations longues"
-.pp
-Les citations longues
-sont des citations  qui s'étalent sur plusieurs lignes,
-elles sont donc sorties du corps de texte
-et ne sont pas entourées de guillemets.
-Cela peut être réalisé
-en utilisant les commandes
-.b .(q
-et
-.b .)q
-entourant la citation.
-Par exemple,
-l'entrée:
-.(b
-Comme l'indique  Weizenbaum:
-\&.(q
-On dit qu'expliquer, c'est expliquer en s'éloignant.
-Cette maxime ne s'accomplit nulle part aussi bien
-que dans le domaine de la programmation informatique,...
-\&.)q
-.)b
-génère comme sortie:
-.lp
-Comme l'indique  Weizenbaum:
-.(q
-On dit qu'expliquer, c'est expliquer en s'éloignant.
-Cette maxime ne s'accomplit nulle part aussi bien
-que dans le domaine de la programmation informatique,...
-.)q
-.sh 2 "Listes"
-.pp
-Une
-.i liste
-est une mise en évidence
-indentée,
-à espacements simples,
-non justifiée.
-On devrait utiliser une liste
-quand le matériel à imprimer
-ne doit pas être justifié comme un texte normal,
-tels les colonnes de figures
-ou les exemples utilisés dans ce document.
-Les listes sont encadrées par les requêtes
-.b .(l
-et
-.b .)l .
-Par exemple,
-tapez:
-.(b
-La famille des Équidés comprend:
-\&.(l
-les chevaux
-les ânes
-les hémiones
-les zèbres
-\&.)l
-.)b
-cela produira:
-.br
-La famille des Équidés comprend:
-.(l
-les chevaux
-les ânes
-les hémiones
-les zèbres
-.)l
-.sh 2 "Clos"
-.pp
-Un
-.i clos
-est un ensemble de lignes mises en évidences
-que l'on désire garder sur la même page
-si possible.
-Par exemple un diagramme.
-Les clos diffèrent des listes.
-Les listes peuvent être réparties sur plusieurs pages,
-tandis que les clos ne peuvent pas l'être.
-.pp
-Les blocs sont un genre primitif de clos.
-Ils débutent avec la requête
-.b .(b
-et se terminent avec la requête
-.b .)b .
-Si il n'y a pas de place sur la page courante
-pour y placer le bloc entier,
-il sera placé sur une nouvelle page.
-Cela a pour effet déplaisant de laisser
-un espace blanc en fin de page.
-Quand cela n'est pas approprié,
-vous pouvez user d'une alternative
-appelée
-.i "clos flottants" .
-.pp
-Les
-.i "clos flottants"
-se déplacent dans le texte.
-Donc,
-il sont appropriés pour les choses
-auxquelles on se réfère nommément, comme
-.q "voir Figure 3" .
-Un clos flottant apparaîtra
-au bas de la page courante
-si il y a la place;
-autrement,
-il apparaîtra
-sur la page suivante.
-Les clos flottants commencent par
-.b .(z
-et finissent par
-.b .)z .
-Comme exemple de clos flottant,
-voir figure 1.
-.(z
-.in 1i
-.xl -1i
-.hl
-\&.(z
-\&.hl
-Texte du clos flottant
-\&.sp
-\&.ce
-Figure 1. Exemple de clos flottant.
-\&.hl
-\&.)z
-.sp
-.ce
-Figure 1. Exemple de clos flottant.
-.hl
-.)z
-La requête
-.b .hl
-est utilisée
-pour dessiner une ligne horizontale
-de sorte que la figure
-soit séparée du texte.
-.sp 15
-.sh 2 "Mises en évidences plus élaborées"
-.pp
-Les clos et les listes sont normalement collectés en mode
-.i non-justifié .
-Ils sont donc propres à contenir des tableaux et autres.
-Si vous voulez obtenir une mise en évidence
-en mode justifié
-(pour du texte),
-tapez
-.b ".(l\ F"
-Tout au long de ce chapitre,
-les remarques s'appliquant à
-.b .(l
-s'appliquent aussi à
-.b .(b
-et
-.b .(z .
-Cette espèce de mise en évidence
-sera indentée des deux côtés.
-Par exemple,
-l'entrée:
-.(b
-\&.(l F
-Et maintenant les garçons et les filles,
-un jouet plus grand, plus beau que tout ce qui a existé auparavant!
-Soyez le premier, la première de votre quartier
-à posséder votre propre ordinateur!
-Oui les enfants, vous aussi vous pouvez posséder
-une de ces machines à gérer les informations.
-Vous aussi vous pouvez produire de beaux papiers formatés
-sans même remuer le petit doigt!
-\&.)l
-.)b
-donnera en sortie:
-.(b F
-Et maintenant les garçons et les filles,
-un jouet plus grand, plus beau que tout ce qui a existé auparavant!
-Soyez le premier, la première de votre quartier
-à posséder votre propre ordinateur!
-Oui les enfants, vous aussi vous pouvez posséder
-une de ces machines à gérer les informations.
-Vous aussi vous pouvez produire de beaux papiers formatés
-sans même remuer le petit doigt!
-.)b
-.pp
-Par exemple,
-pour obtenir une liste justifiée,
-alignée sur la gauche, entrez:
-.(b
-\&.(l L F
-Et maintenant les garçons et les filles,
-un jouet plus grand, plus beau que tout ce qui a existé auparavant!
-Soyez le premier, la première de votre quartier
-à posséder votre propre ordinateur!
-Oui les enfants, vous aussi vous pouvez posséder
-une de ces machines à gérer les informations.
-Vous aussi vous pouvez produire de beaux papiers formatés
-sans même remuer le petit doigt!
-\&.)l
-.)b
-Ce qui donnera:
-.(l L F
-Et maintenant les garçons et les filles,
-un jouet plus grand, plus beau que tout ce qui a existé avant!
-Soyez le premier, la première de votre quartier
-à posséder votre propre ordinateur!
-Oui les enfants, vous aussi vous pouvez posséder
-une de ces machines à gérer les informations.
-Vous aussi vous pouvez produire de beaux papiers formatés
-sans même remuer le petit doigt!
-.)l
-.pp
-Normalement, les listes et les blocs sont indentés
-(les clos flottant sont normalement alignés sur la gauche).
-Pour obtenir une liste
-alignée sur la gauche,
-tapez
-.b ".(l\ L" .
-Pour obtenir une ligne centrée
-ligne après ligne,
-tapez
-.b ".(l C" .
-L'entrée:
-.(b
-\&.(l
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-\&.)l
-.)b
-produit un texte indenté:
-.(b
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-.)b
-En tapant
-.b L
-après la requête
-.b .(l
-cela produira le même résultat, mais aligné à gauche:
-.(b L
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-.)b
-Si vous utilisez
-.b C
-à la place de
-.b L
-vous obtenez une liste centrée:
-.(b C
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-.)b
-.pp
-Parfois,
-vous voudrez centrer
-plusieurs lignes en groupe
-plutôt que de centrer ligne par ligne.
-Pour le faire,
-utilisez les blocs centrés
-qui sont produits par les requêtes
-.b .(c
-et
-.b .)c .
-Toutes les lignes sont centrées en tant que groupe.
-La ligne la plus longue est centrée par rapport aux marges
-et les lignes plus courtes sont alignées sur la plus longue.
-Notez que si vous utilisez un bloc centré,
-les lignes ne bougent pas les unes par rapport aux autres,
-tandis qu'elles le feront si vous utilisez l'argument
-.b C
-pour les clos.
-.pp
-Les blocs centrés ne sont
-.i pas
-des clos,
-et peuvent même être combinés
-avec eux comme nous allons le voir.
-Par exemple,
-pour centrer des lignes
-en groupe
-et les garder
-sur une même page,
-utilisez:
-.(b
-\&.(b L
-\&.(c
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-\&.)c
-\&.)b
-.)b
-ce qui produira:
-.(b L
-.(c
-première ligne d'une mise en évidence non-justifiée
-lignes suivantes
-.)c
-.)b
-Sans les requêtes
-(\c
-.b .(b
-et
-.b .)b )
-le résultat aurait été le même,
-mais sans garantie
-que les lignes du bloc centré
-aient été sur la même page.
-Notez l'usage de l'argument
-.b L
-après
-.b .(b .
-Il fait en sorte
-que le bloc se centre
-sur toute la longueur de la ligne
-plutôt que sur la longueur de ligne raccourcie de l'indentation. 
-Aussi,
-la requête demandant de centrer
-doit être placée
-.i à \ l'intérieur
-de la requête formant le clos.
-.sh 1 "Annotations"
-.pp
-Un certain nombre de requêtes
-servent à mettre du texte de côté
-pour l'imprimer plus tard, comme les 
-.i "notes en bas de page"
-qui sont imprimées au bas de la page courante.
-.br
-Le
-.i "texte différé"
-est en quelque sorte une variante de la
-note en bas de page;
-le texte n'est imprimé
-qu'au moment où on fait appel à lui,
-par exemple à la fin de chaque chapitre.
-.br
-Les
-.i Index
-sont un genre de texte différé
-ayant un numéro de rappel
-(habituellement le numéro de la page)
-attaché à chaque entrée
-après une rangée de points.
-Les Index sont aussi mis de côté
-jusqu'à ce qu'on fasse explicitement appel à eux.
-.sh 2 "Notes en bas de page"
-.pp
-Une note en bas de page commence avec la requête
-.b .(f
-et se termine avec la requête
-.b .)f .
-La note en bas de page courante
-est maintenue automatiquement,
-et peut être utilisée en tapant \e**,
-ce qui produira un numéro de note\**.
-.(f
-\**Comme celui-ci.
-.)f
-Le numéro est automatiquement incrémenté
-après chaque note en bas de page.
-Par exemple,
-l'entrée:
-.(b
-\&.(q
-Un homme qui n'est pas honnête
-et qui, en même temps, est présomptueux;
-un homme qui n'est pas attentif
-et qui, en même temps, est ignorant;
-un homme qui est rempli de mensonge
-et qui, en même temps, est incompétent;
-un tel homme ne fait pas partie de mes relations.\e**
-\&.(f
-\e**Traduit de :James R. Ware,
-\&.ul
-The Best of Confucius,
-Halcyon House, 1950.
-Page 77.
-\&.)f
-\&.)q
-.)b
-génère le résultat suivant:
-.(q
-Un homme qui n'est pas honnête
-et qui, en même temps, est présomptueux;
-un homme qui n'est pas attentif
-et qui, en même temps, est ignorant;
-un homme qui est rempli de mensonge
-et qui, en même temps, est incompétent;
-un tel homme ne fait pas partie de mes relations.\**
-.(f
-\**Traduit de: James R. Ware,
-.ul
-The Best of Confucius,
-Halcyon House, 1950.
-Page 77.
-.)f
-.)q
-Il est important que la note en bas de page
-apparaisse
-.i "à l'intérieur"
-de la citation,
-ainsi vous serez sûr
-qu'elle
-apparaîtra
-sur la même page
-que la citation.
-.sh 2 "Texte différé"
-.pp
-Le texte différé
-ressemble beaucoup à la note en bas de page
-sauf qu'il est imprimé seulement
-si on fait explicitement appel à lui.
-Cela permet de faire apparaître par exemple
-une liste de références
-à la fin de chaque chapitre,
-ce qui est une convention dans certaines disciplines.
-Utilisez
-.b \e*#
-pour le texte différé
-en lieu et place du
-.b \e**
-des notes en bas de page.
-.pp
-Si vous faites du texte différé
-votre moyen habituel de noter les références,
-vous pourrez toujours utiliser en parallèle
-les notes en bas de page,
-mais, comme référence,
-vous utiliserez alors des signes spéciaux*
-.(f
-*comme un astérisque (!)
-.)f
-plutôt que des numéros.
-.br
-Pour faire apparaître une note en bas de page munie d'un signe spécial comme celle que vous admirez ci- dessus, entrez:
-.br
-\&...vous utiliserez alors des signes spéciaux*.
-.br
-Suivi de:
-.(b
-\&.(f
-.br
-*comme un astérisque (!).
-.br
-\&.)f
-.)b
-.sh 2 "Index"
-.pp
-Un
-.q index
-(ou plutôt table des matières
-puisque les éléments ne sont pas classés
-par ordre alphabétique)
-ressemble au texte différé,
-par le fait qu'il est gardé en réserve
-jusqu'à ce qu'on fasse appel à lui.
-Cependant,
-chaque élément de l'index
-a un numéro de page
-(ou un autre signe distinctif)
-à la fin de  la dernière ligne le décrivant,
-à la suite d'une rangée de points (voir ci-dessous).
-.pp
-Les entrées pour l'index
-commencent avec
-.b .(x
-et finissent avec
-.b .)x .
-Dans chaque chapitre
-dont vous voulez qu'il apparaisse dans l'index,
-introduisez une telle requête
-en répétant l'énoncé du titre**.
-.(f
-**Voir aussi le plan de thèse exposé au chapitre 5.3.
-.)f
-La requête
-.b .)x
-peut avoir un argument,
-quand on veut formuler soi-même
-une valeur prenant la place du
-.q "numéro de page" .
-Sans argument, c'est le numéro de page où se trouve la requête qui sera utilisé automatiquement.
-Si le numéro de page donné est un trait de soulignage
-(\c
-.q _ )
-aucun numéro de page
-ou ligne de points ne sera imprimé.
-Pour obtenir une ligne de points
-sans numéro de page,
-tapez
-.b ".)x """"" ,
-ce qui signifie qu'il n'y a pas de numéro de page.
-.pp
-La requête
-.b .xp
-imprime l'index.
-.pp
-Par exemple,
-l'entrée:
-.(b
-\&.(x
-Cire à cacheter
-\&.)x
-\&.(x
-Des choux et des rois
-\&.)x _
-\&.(x
-Pourquoi la mer bout
-\&.)x 2.5a
-\&.(x
-Si les cochons avaient des ailes
-\&.)x ""
-\&.(x
-Ceci est une entrée d'index terriblement longue,
-comme on pourrait en avoir besoin pour
-une liste d'illustrations, de tableaux, ou de figures;
-je m'attends à ce qu'elle fasse au moins deux lignes.
-\&.)x
-\&.xp
-.)b
-génère:
-.(x
-Cire à cacheter
-.)x
-.(x
-Des choux et des rois
-.)x _
-.(x
-Pourquoi la mer bout
-.)x 2.5a
-.(x
-Si les cochons avaient des ailes
-.)x ""
-.(x
-Ceci est une entrée d'index terriblement longue,
-comme on pourrait en avoir besoin pour
-une liste d'illustrations, de tableaux, ou de figures; je m'attends à ce qu'elle fasse au moins deux lignes.
-.)x
-.xp
-.pp
-La requête
-.b .(x
-peut avoir comme argument
-un caractère unique,
-qui spécifie le
-.q nom
-de l'index;
-l'index normal répond à la requête
-.b x .
-Donc,
-on peut maintenir plusieurs
-.q indices
-simultanément**
-.(f
-**Voir aussi le plan de thèse exposé au chapitre 5.3
-.)f
-(un pour la liste des tableaux, un pour la table des matières, etc.).
-.pp
-Notez que l'index doit
-être imprimé à la
-.i fin
-du document,
-plutôt qu'au début
-où il apparaîtra sans doute
-(en temps que table des matières);
-les pages devront peut-être être réarrangées physiquement après impression.
-.sh 1 "Fonctionnalités plus complexes"
-.pp
-Il existe un grand nombre d'autres possibilités,
-notamment des requêtes
-qui fournissent d'autres types de paragraphes,
-des chapitres numérotés en forme
-.b 1.2.3
-(comme ils le sont dans le présent document),
-et l'impression sur plusieurs colonnes.
-.sh 2 "Autres types de paragraphes"
-.pp
-Généralement, les paragraphes
-commencent par un espacement vertical et
-la première ligne est indentée.
-On peut obtenir des paragraphes justifiés
-et alignés à gauche
-en utilisant
-.b .lp
-au lieu de
-.b .pp ,
-comme démontré au paragraphe suivant.
-.lp
-Parfois, vous voudrez utiliser des paragraphes dont le
-.i corps
-est indenté
-et la première ligne
-non-indentée
-et munie d'un label.
-Cela peut être réalisé grâce à la requête
-.b .ip .
-Un mot spécifié sur la même ligne que
-.b .ip
-est imprimé dans la marge,
-et le corps du paragraphe est aligné
-sur une position prédéfinie
-(normalement cinq espacements).
-Par exemple,
-l'entrée:
-.(b
-\&.ip un
-Ceci est le premier paragraphe.
-Notez comment le reste de la première
-ligne s'aligne
-sur les autres lignes du paragraphe.
-\&.ip deux
-Et ici nous sommes déjà au second paragraphe.
-Vous noterez que l'argument de  \c
-.b .ip
-apparaît dans la marge.
-\&.lp
-Nous pouvons poursuivre ce texte...
-.)b
-produit comme sortie:
-.ip un
-Ceci est le premier paragraphe.
-Notez comment le reste de la première
-ligne s'aligne
-sur les autres lignes du paragraphe.
-.ip deux
-Et ici nous sommes déjà au second paragraphe.
-Vous noterez que l'argument de
-.b .ip
-apparaît dans la marge
-.lp
-Nous pouvons poursuivre ce texte sans
-commencer un nouveau paragraphe indenté
-en utilisant la requête
-.b .lp .
-.pp
-Si vous avez des espacements
-dans le label de la requête
-.b .ip ,
-vous devrez utiliser un
-.q "espacement inremplissable"
-au lieu d'un espacement normal.
-On crée celui-ci à l'aide d'un caractère antislash
-(\c
-.q \e )
-suivi d'un espacement.
-Par exemple,
-pour imprimer le label
-.q "Partie 1" ,
-entrer:
-.(b
-\&.ip "Partie\e 1"
-.)b
-.pp
-Si le label prévu pour un paragraphe indenté
-(c'est à dire l'argument de 
-.b .ip )
-est plus long que l'espace prévu pour le label (cinq espacements),
-.b .ip
-commencera une nouvelle ligne après le label.
-Par exemple,
-l'entrée:
-.(b
-\&.ip label\ long
-Ce paragraphe a un label long.
-Le premier caractère du texte de la première ligne
-ne s'alignera pas sur le texte de la seconde ligne et suivantes,
-bien que celles-ci soient alignées entre elles.
-.)b
-produira:
-.ip label\ long
-Ce paragraphe a un label long.
-Le premier caractère du texte de la première ligne
-ne s'alignera pas sur le texte de la seconde ligne et suivantes,
-bien que celles-ci soient alignées entre elles.
-.pp
-Il est possible de changer la taille du label
-en utilisant un second argument
-qui définit la taille du label.
-Par exemple,
-on pourra écrire l'exemple ci-dessus correctement
-en disant:
-.(b
-\&.ip label\ long 10
-.)b
-qui rendra l'indentation du paragraphe longue de
-10 espacements pour ce paragraphe seulement.
-Si vous avez plusieurs paragraphes à indenter
-de la même longueur,
-utilisez un
-.i "registre de nombres"
-.b ii .
-Par exemple, pour laisser un pouce d'espace
-avant le label,
-tapez:
-.(b
-\&.nr ii 1i
-.)b
-quelque part avant le premier appel de
-.b .ip .
-Pour plus d'informations, voyez le
-.i "Manuel de Référence" .
-.pp
-Si
-.b .ip
-est utilisé
-sans aucun argument
-aucun label ne sera imprimé.
-Par exemple,
-l'entrée:
-.(b
-\&.ip a
-Ceci est le premier paragraphe de l'exemple.
-Nous avons déjà vu ce genre d'exemples auparavant.
-\&.ip
-Ce paragraphe est aligné sur le précédent,
-mais il n'a pas de label dans la marge.
-.)b
-produit la sortie:
-.ip a
-Ceci est le premier paragraphe de l'exemple.
-Nous avons déjà vu ce genre d'exemples auparavant.
-.ip
-Ce paragraphe est aligné sur le précédent,
-mais il n'a pas de label dans la marge.
-.pp
-Un cas spécial de
-.b .ip
-est
-.b .np ,
-qui numérote automatiquement
-les paragraphes de manière séquentielle à partir de 1.
-La numérotation repart de 1 à la prochaine requête
-.b .pp ,
-.b .lp ,
-or
-.b .sh
-(cette dernière est décrite au chapitre suivant).
-Par exemple,
-l'entrée:
-.(b
-\&.np
-Ceci est le premier point.
-\&.np
-Ceci est le second point.
-Les "points" sont juste des paragraphes normaux
-auxquels on donne automatiquement un numéro
-à l'aide de la requête .np.
-\&.pp
-Ce paragraphe remet la numérotation par .np à 1.
-\&.np
-Là par exemple,
-nous avons recommencé la numérotation à 1.
-.)b
-génère:
-.np
-Ceci est le premier point.
-.np
-Ceci est le second point.
-Les "points" sont juste des paragraphes normaux
-auxquels on donne automatiquement un numéro
-à l'aide de la requête .np.
-.pp
-Ce paragraphe remet la numérotation à 1 à cause de .pp.
-.np
-Là par exemple,
-nous avons recommencé la numérotation à 1.
-.pp
-La requête
-.b .bu
-donne des listes de ce type,
-qui sont identifiées par des puces
-plutôt que par des numéros.
-Les paragraphes sont aussi regroupés verticalement.
-Par exemple,
-l'entrée:
-.(b
-\&.bu
-\&Un jaune d'oeuf
-\&.bu
-\&Une c.-à-s. de crème
-\&.bu
-\&Sel, poivre de Cayenne et jus de citron pour assaisonner
-\&.bu
-\&Deux bonnes c.-à-s. de beurre
-.)b
-produit\**:
-.(f
-\**Par ailleurs,
-si vous mettez ces trois ingrédients
-dans une cocotte assez haute,
-et que vous remuez le tout comme un cinglé à feu moyen
-(ne lâchez jamais l'anse de la cocotte) jusqu'à ce que le mélange ait la consistance d'une béchamel (ce qui prend juste une à deux minutes), si ensuite, vous retirez la cocotte du feu et vous incorporez le beurre, vous obtiendrez une délicieuse sauce hollandaise.
-.)f
-.bu
-Un jaune d'oeuf
-.bu
-Une c.-à-s. de crème
-.bu
-Sel, poivre de Cayenne et jus de citron pour assaisonner
-.bu
-Deux bonnes c.-à-s. de beurre
-.sh 2 "Titres de chapitres"
-.pp
-Les titres de chapitre
-(comme ceux utilisés dans ce document)
-peuvent être générés automatiquement
-pa la requête
-.b .sh .
-Vous devez indiquer à la requête
-.b .sh
-la
-.i profondeur
-du numéro de chapitre
-et le titre du chapitre.
-La profondeur indique
-combien de nombres doivent apparaître
-(séparés par des points décimaux)
-dans le numéro de chapitre.
-Par exemple,
-le numéro de chapitre
-.b 4.2.5
-a une profondeur de trois.
-.pp
-Les numéros de chapitres
-sont incrémentés
-de façon assez intuitive.
-Si vous ajoutez un numéro
-(ce faisant, vous augmentez la profondeur),
-le nouveau numéro commencera à 1.
-Si vous enlevez un numéro de chapitre
-(vous réduisez la profondeur)
-ou que vous gardez
-le même nombre de chapitre
-(vous gardez la même profondeur),
-le numéro final sera incrémenté.
-Par exemple,
-l'entrée:
-.(b
-\&.sh 1 "Le Préprocesseur"
-\&.sh 2 "Concepts de base"
-\&.sh 2 "Entrées de contrôle"
-\&.sh 3
-\&.sh 3
-\&.sh 1 "Produire du code"
-\&.sh 3
-.)b
-donnera comme résultat:
-.(b
-.b
-1. Le Préprocesseur
-1.1. Concepts de base
-1.2. Entrées de contrôle
-1.2.1.
-1.2.2.
-2. Produire du code
-2.1.1.
-.)b
-.pp
-Vous pouvez spécifier le numéro de chapitre dès le départ
-en plaçant le numéro de chapitre après le titre de chapitre,
-en utilisant des espacements à la place des points.
-Par exemple,
-la requête:
-.(b
-\&.sh 3 "un autre chapitre" 7 3 4
-.)b
-commencera par le chapitre ayant le numéro
-.b 7.3.4 ;
-toutes les requêtes
-.b .sh
-suivantes seront numérotées relativement à ce chapitre.
-.pp
-Il y a des fonctionnalités encore plus complexes
-qui vont indenter le titre de chaque chapitre,
-sous-chapitre, ou sous-sous-chapitre
-relativement à sa profondeur.
-Par exemple, si vous entrez:
-.(b
-\&.nr si \c
-.i N
-.)b
-chaque titre et sous-titre sera indenté d'une quantité
-.i N .
-.i N
-a un facteur d'échelle attaché,
-c'est à dire qu'il doit avoir la forme
-.i Nx ,
-où
-.i x
-indique de quelle unité est
-.i N .
-Les valeurs courantes pour
-.i x
-.b i
-pour les pouces (inches),
-.b c
-pour les centimètres,
-et
-.b n
-pour les
-.i ens
-(= une largeur de caractère).
-Par exemple,
-pour indenter chaque sous-chapitre
-d'un demi-pouce,
-tapez:
-.(b
-\&.nr si 0.5i
-.)b
-après cette requête,
-les titre de chapitres seront indentés
-d'un demi-pouce
-par niveau de profondeur.
-Par exemple,
-le présent document a écrit
-en ayant recours à la requête
-.(b
-\&.nr si 3n
-.)b
-au début du fichier d'entrée,
-ce qui donne  trois espacements d'indentation
-par niveau de profondeur du chapitre.
-.pp
-Des numéros de chapitre
-sans indentation automatique
-peuvent être créés
-grâce à la requête:
-.(b
-\&.uh "Titre"
-.)b
-qui fera un titre de chapitre,
-sans numérotation.
-.sh 2 "Les parties du document"
-.pp
-Certaines requêtes sont là pour
-aider à mettre en forme le document.
-La requête
-.b .tp
-initialise une page de titre.
-Sur une page de titre,
-il n'y a ni en-tête ni pied de page, et,
-contrairement à ce qui se passe sur les autres pages,
-vous pouvez laisser des grands espaces blancs
-en haut de la page.
-Par exemple,
-une page de titre typique aura cette apparence:
-.(b
-\&.tp
-\&.sp 7c
-\&.(l C
-LA CROISSANCE DES ONGLES D'ORTEILS
-CHEZ LES PRIMATES SUPÉRIEURS
-\&.sp
-par
-\&.sp
-Frank N. Furter
-\&.)l
-\&.bp
-.)b
-.pp
-La requête
-.b .+c \ \c
-.i T
-peut être utilisée pour
-commencer un nouveau chapitre.
-Chaque nouveau chapitre sera numéroté automatiquement
-à partir de 1,
-et le titre sera imprimé au début de chaque chapitre
-avec le numéro de chapitre
-et le nom du chapitre
-.i T .
-Par exemple,
-pour commencer un chapitre s'intitulant
-.q Conclusions,
-utilisez la requête:
-.(b
-\&.+c "CONCLUSIONS"
-.)b
-qui produira sur une nouvelle page,
-les lignes
-.(b C
-CHAPITRE 5
-CONCLUSIONS
-.)b
-avec des espacements appropriés pour une thèse.
-L'en-tête aussi est déplacé en bas de page
-sur la première page d'un chapitre\** .
-.(f
-\**Voir la première page de ce document
-.)f
-.pp
-Si on omet le paramètre de titre
-.i T
-après la requête
-.b .+c
-,
-Le chapitre résultant sera un chapitre sans titre.
-cela peut être utilisé au commencement d'un document;
-par exemple,
-.b .+c
-a été utilisé pour créer la page 1
-du présent document.
-.pp
-Même si traditionnellement
-les documents ont le résumé,
-la table des matières,
-etc... au début du document,
-si vous utilisez
-\*G,
-il sera plus pratique
-de les rédiger en dernier.
-Il faut vous dire que les entrées d'index
-peuvent être collectées en amont
-et être imprimées
-dans la table des matières
-(ou d'autres index).
-À la fin du document,
-utilisez la requête
-.b ".++ P" ,
-qui commence la partie préliminaire du document.
-Après cette requête,
-la requête
-.b .+c
-commencera une section préliminaire
-pour votre document.
-Remarquez que,
-cela imprime le numéro de la page
-en repartant de 1
-en chiffres romains minuscules.
-.b .+c
-peut être utilisé plusieurs fois d'affilée
-pour ébaucher les différentes parties du document.
-Par exemple,
-le résumé,
-la table des matières,
-les remerciements,
-la liste des illustrations,
-etc.
-La requête
-.b ".++ B"
-peut aussi être employée
-pour commencer le chapitre de bibliographie
-à la fin du document.
-.pp
-Une ébauche peut être organisée
-comme le montre la figure 2 ci-dessous.
-(Dans cette figure,
-les commentaires débutent par la requête
-.b \e" .)
-.(z
-.hl
-.if t .in 0.5i
-.if t .ta 2i
-.if n .ta 3i
-\&.fo \(aa\(aaÉBAUCHE\(aa\(aa	\e" définir un pied de page pour chaque page.
-\&.tp				\e" commencer la page de titre
-\&.(l C				\e" liste centrée
-LA CROISSANCE
-DES ONGLES D'ORTEILS
-CHEZ LES PRIMATES SUPÉRIEURS
-\&.sp
-par
-\&.sp
-Frank Furter
-\&.)l				\e" fin de la liste centrée
-\&.+c INTRODUCTION		\e" début du chapitre intitulé "INTRODUCTION"
-\&.(x t				\e" faire une entrée pour l'index `t'
-Introduction
-\&.)x 				\e" fin de l'entrée d'index
-texte du chapitre 1		\e" =Introduction
-\&.+c "CHAPITRE SUIVANT"	\e" commencer un nouveau chapitre
-\&.(x t				\e" faire un entrée pour 'index `t'
-Chapitre suivant
-\&.)x
-texte du chapitre 2		\e" =chapitre suivant
-\&.+c CONCLUSIONS
-\&.(x t
-Conclusions
-\&.)x
-texte du chapitre 3		\e" =Conclusions
-\&.++ B				\e" commencer la bibliographie
-\&.+c BIBLIOGRAPHIE		\e" commencer un nouveau `chapitre'
-\&.(x t
-Bibliographie
-\&.)x
-texte de la bibliographie
-\&.++ P				\e" commencer la partie préliminaire du document
-\&.+c "TABLE DES MATIÈRES"
-\&.xp t				\e" imprimer l'index `t' collecté en amont
-\&.+c PREFACE			\e" commencer un nouveau chapitre dans la partie préliminaire.
-texte de la préface
-.sp 2
-.in 0
-.ce
-Figure 2. Ébauche d'un exemple de document.
-.hl
-.)z
-.sh 2 "Équations et Tableaux"
-.pp
-Il existe deux programmes \*U spécialement conçus
-pour formater les types de matières spéciaux.
-.b Eqn
-imprime les équations.
-.b Tbl
-permet d'imprimer
-de très jolis tableaux
-dans toute une variété de formats.
-Le présent document décrira seulement comment
-rendre plus jolie
-leur fonctionnalités standard.
-Pour savoir
-comment ces deux programmes fonctionnent
-consultez les manuels de référence de ces processeurs\**.
-.(f
-\**N.d.tr. 
-.b "man eqn"
-et
-.b "man tbl"
-.)f
-.pp
-Le logiciel
-.b eqn
-est décrit complètement
-dans le document
-.ul
-Typesetting Mathematics \- User's Guide
-par Brian W. Kernighan
-and Lorinda L. Cherry\**.
-.(f
-\**Disponible sur la toile
-.)f
-Les équations sont centrées
-et restent sur une page.
-On les introduit dans le texte par la requête
-.b .EQ
-et on les termine par la requête
-.b .E .
-.pp
-La requête
-.b .EQ
-peut avoir un numéro d'équation comme
-argument optionnel.
-Ce numéro sera imprimé centré
-à droite de l'équation.
-Si l'équation devient trop longue,
-on devra l'imprimer sur deux lignes.
-Pour faire ceci, tapez:
-.(b
-\&.EQ (eq 34)
-texte de l'équation 34
-\&.EN C
-\&.EQ
-continuation de l'équation 34
-\&.EN
-.)b
-Le
-.b C
-après la requête
-.b .EN
-spécifie que l'équation
-sera continuée.
-.pp
-Le programme
-.b tbl
-produit des tableaux.
-Il est décrit complètement
-(avec des exemples numériques)
-dans le document
-.ul
-Tbl \- A Program to Format Tables
-par M. E. Lesk\**.
-.(f
-\**Également disponible sur la toile
-.)f
-Les tableaux commencent par la requête
-.b .TS
-et se terminent par la requête
-.b .TE .
-Normalement, les tableaux restent sur la même page.
-Si vous avez un tableau trop grand
-pour tenir sur une seule page,
-et dont vous savez
-qu'il lui en faudra plusieurs,
-commencez le tableau avec la requête
-.b ".TS\ H"
-et mettez la requête
-.b .TH
-après la ligne du tableau
-que vous voulez
-imprimer au début de chaque page
-contenant le tableau.
-Par exemple, la définition
-d'un long tableau
-pourrait être:
-.ds TA \|\h'.4n'\v'-.2n'\s-4\zT\s0\v'.2n'\h'-.4n'\(ci\|
-.if n .ds TA \ \o'-T'\ \"
-.(b
-\&.TS H
-c s s
-n n n.
-TITRE DU TABLEAU
-\&.TH
-texte du tableau
-\&.TE
-.)b
-.pp
-.sh 2 "Sortie sur deux colonnes"
-.pp
-Vous pouvez rédiger votre texte sur deux colonnes 
-automatiquement
-grâce à la requête
-.b .2c .
-Cela rendra tout contenu
-suivant cette requête
-sur deux colonnes.
-La requête
-.b .bc
-commencera une nouvelle colonne;
-elle diffère de
-.b .bp
-en ce que
-.b .bp
-peut laisser une colonne totalement
-vide quand il commence une nouvelle page.
-Pour revenir à l'impression sur une colonne,
-utilisez
-.b .1c .
-.sh 2 "Définir un macro"
-.pp
-Un
-.i macro
-est un ensemble formé de requêtes et de texte
-qui peut être résumé
-en une seule requête.
-Les macros commencent par la ligne
-.b ".de" \ \c
-.i xx
-(où
-.i xx
-est le nom du macro que l'on va définir)
-et elle finit par une ligne consistant en 2 points.
-Après avoir défini le macro,
-écrire la ligne
-.b . \c
-.i xx
-revient à écrire toutes les autres lignes.
-Par exemple,
-pour définir un macro
-qui espace de trois lignes
-et centre les lignes qui suivent,
-entrez:
-.(b
-\&.de SS
-\&.sp 3
-\&.ce
-\&..
-.)b
-et utilisez en rédigeant:
-.(b
-\&.SS
-\&Ligne de titre
-(début du texte)
-.)b
-.pp
-Les noms des macros peuvent être formés d'un ou deux caractères.
-Pour éviter les conflits avec des noms de requêtes
-dans \-me,
-utilisez toujours des majuscules.
-Les seuls noms à éviter sont
-.b TS ,
-.b TH ,
-.b TE ,
-.b EQ ,
-and
-.b EN .
-.sh 2 "Annotations à l'intérieur d'un clos"
-.pp
-Parfois, vous voudrez insérer
-une note en bas de page
-ou une entrée d'index
-à l'intérieur d'un clos.
-Par exemple,
-si vous vouliez maintenir une
-.q "liste des figures"
-vous pourriez vouloir faire quelque chose comme:
-.(b
-\&.(z
-\&.(c
-texte de la figure
-\&.)c
-\&.ce
-Figure 5.
-\&.(x f
-Figure 5
-\&.)x
-\&.)z
-.)b
-et vous pourriez espérer
-que ça donne une figure
-avec un label
-et une entrée d'index
-.b f
-(probablement une liste des figures).
-Par malheur,
-l'entrée d'index
-est lue et interprétée
-lorsque le clos est lu,
-et non pas lorsqu'il est imprimé,
-et donc le numéro de page dans l'index sera probablement erroné.
-La solution est d'utiliser la chaîne magique
-.b \e!
-au début de chaque ligne se rapportant à l'index.
-Autrement dit,
-vous utiliserez:
-.(b
-\&.(z
-\&.(c
-Texte de la figure
-\&.)c
-\&.ce
-Figure 5.
-\e!.(x f
-\e!Figure 5
-\e!.)x
-\&.)z
-.)b
-qui différera l'indexation 
-jusqu'à ce que la figure soit en sortie.
-Cela garantira
-que le numéro de la page dans l'index soit correct.
-Le même commentaire s'applique aussi
-aux blocs (avec
-.b .(b
-et
-.b .)b )
-.
-.sh 1 "\*T et le photocompositeur"
-.pp
-Avec un peu de soin,
-vous pouvez préparer
-des documents
-qui seront joliment imprimés
-sur un terminal normal,
-ou, si vous avez besoin d'un photocompositeur,
-en utilisant le programme de formatage \*T .
-.sh 2 "Polices"
-.pp
-Une
-.i police
-est un style de caractères.
-Trois polices sont
-disponibles simultanément,
-Times Roman,
-Times italique,
-et Times en gras,
-plus la police spéciale pour les maths.
-La police normale est Roman.
-.pp
-On peut à tout instant
-changer de police.
-Les requêtes
-.b .r ,
-.b .i ,
-.b .b ,
-et
-.b .bi
-changent respectivement sur Roman,
-italique,
-gras,
-et italique gras.
-Vous pouvez mettre un seul mot
-dans une certaine police
-en tapant (par exemple):
-.(b
-\&.i mot
-.)b
-ce qui mettra ce
-.i mot
-en italique,
-mais n'affectera pas le texte environnant.
-.pp
-Notez que si vous voulez mettre plus d'un mot à la fois
-dans une police de votre choix,
-vous devez entourer ces mots de guillemets
-(`\|"\|')
-ainsi, pour le processeur \*G, ils apparaîtront comme un seul mot.
-Les guillemets n'apparaîtront pas dans le texte.
-Si vous voulez que des guillemets apparaissent dans le texte,
-vous devrez mettre toute la chaîne de caractères entre guillemets
-(même si il s'agit d'un seul mot),
-et utiliser
-.i deux
-paires de guillemets,
-quand vous voulez qu'une paire apparaisse.
-Par exemple,
-si vous voulez produire le texte:
-.(b
-.i """poisson d'avril\|"""
-.)b
-en italique, vous devez taper:
-.(b
-\&.i """poisson d'avril\e|"""
-.)b
-Le
-.b \e|
-produit un petit espacement
-de sorte que
-.q l
-d'
-.i avril
-ne soit pas trop proche des guillemets dans \*G,
-comme cela l'est ici:
-.(b
-.i """poisson d'avril"""
-.)b
-.pp
-Quelques
-.q pseudo-polices
-sont disponibles.
-L'entrée:
-.(b
-\&.(b
-\&.u souligné
-\&.bx "mots dans un cadre"
-\&.)b
-.)b
-génère
-.(b
-.u souligné
-.bx "mots dans un cadre"
-.)b
-Notez que les requêtes de pseudo-police
-ne mettent qu'un seul paramètre dans la pseudo-police;
-les requêtes de police ordinaire (.r, .i, .b, et .bi)
-vont commencer à mettre
-tout le texte qui suit
-dans la police spéciale
-si vous ne fournissez pas de paramètre précis\**.
-.(f
-\**N.d.tr. Pour cela, commencer une nouvelle ligne directement après la requête.
-La police spéciale sera maintenue jusqu'à la fin du paragraphe.
-.)f
-Si vous utilisez ces requêtes de pseudo-polices (.u, .bx)
-au milieu des lignes,
-elles ne devraient porter vraiment que sur un seul mot.
-Ceci à cause de la manière
-de laquelle \*G justifie le texte.
-Par exemple,
-si vous voulez utiliser les requêtes:
-.(b
-\&.u "italiques gras"
-et
-\&.bx "mots dans un cadre"
-.)b
-au milieu d'une ligne,
-\*G produirait
-.u "italiques gras"
-et
-.bx "mots dans un cadre" ,\p
-ce qui, vous l'admettrez sans peine, n'est pas très joli.
-.pp
-Le second paramètre
-de toutes les requêtes de police
-est dans la police d'origine.
-Par exemple,
-la requête de police:
-.(b
-\&.b hardi petit
-.)b
-génère
-.q hardi
-en  caractères gras,
-mais mettra
-.q petit
-dans la police du texte environnant,
-ce qui donne:
-.(b
-.b hardi petit.
-.)b
-Pour avoir les deux mots
-.b hardi
-et
-.b petit
-en gras
-.b "hardi petit" ,
-tapez:
-.(b
-\&.b "hardi petit"
-.)b
-.pp
-Vous pouvez panacher les polices à l'intérieur d'un seul mot en utilisant
-une séquence spéciale
-.b \ec
-en fin de ligne
-pour indiquer
-.q "continuer à traiter le texte" ;
-cela permet aux lignes d'entrée
-d'être mises bout à bout
-sans être interrompues par un espacement.
-Par exemple, l'entrée:
-.(b
-\&.u sou \ec
-\&.i ligné
-.)b
-génère
-.u sou \c
-.i ligné ,
-mais si nous avions tapé:
-.(b
-\&.u sou
-\&.i ligné
-.)b
-le résultat aurait été
-.u sou
-.i ligné
-en deux mots.
-.sh 2 "Tailles de caractères"
-.pp
-Le photocompositeur
-supporte différentes tailles de caractères,
-mesurées en points.
-La taille de caractères par défaut
-est 10 points
-pour le corps de texte,
-8 points pour les notes en bas de page.
-Pour changer la taille des caractères,
-tapez:
-.(b
-\&.sz \c
-.i N
-.)b
-où
-.i N
-est la taille souhaitée exprimée en points.
-Vous pouvez aussi
-.q "ajouter de la taille"
-avec la requête
-.(b
-\&.sz \c
-.i +N
-.)b
-ou en
-.q enlever
-en utilisant le signe - à la place de + .
-.br
-L'
-.i "espacement vertical"\**
-.(f
-\**Distance entre le bas de la plupart des lettre
-(la
-.i "ligne de base")
-de deux lignes adjacentes.
-.)f
-sera proportionnel à
-la taille des caractères.
-.pp
-Avec 
-.b \&.sz 
-, ces changements de tailles de caractères sont
-.i temporaires !!!
-Pour revenir à la taille par défaut, tapez simplement
-.(b
-\& .sz
-.)b
-Si vous voulez influencer systématiquement la taille des éléments de votre texte, utilisez les commandes
-.b \&.nr:
-.(b
-\&.nr pp 12
-.)b
-met tout corps de texte se trouvant après cette commande à 12 pts.
-.(b
-\&.nr sp 12
-.)b
-met tous les titres de chapitre suivant cette commande à 12 pts.
-.(b
-\&.nr tp 12
-.)b
-met tous les en-têtes et pieds de page suivant cette commande à 12 pts.
-Vous la placerez avantageusement directement après la commande .he (ou .fo).
-.pp
-On peut donner à un seul mot ou phrase
-une taille plus petite
-que celle du texte environnant
-en utilisant la requête
-.b .sm .
-Cela convient spécialement aux mots écrits en capitales,
-à cause d'une illusion d'optique qui les fait paraître
-plus grandes qu'elles ne le sont vraiment.
-Par exemple:
-.(b
-\&.sm UNIX
-.)b
-s'imprime
-.sm UNIX , 
-ce qui est plus joli que UNIX.
-.\" Dave Kemper notes that the following probably has not been true
-.\" since 1986; keeping (but commented) for historical interest.
-.\" .pp
-.\" Avertissement:
-.\" changer les tailles de caractères
-.\" sur le photocompositeur
-.\" est une opération mécanique lente.
-.\" Sur les imprimantes laser, il faudra peut-être recharger de
-.\" nouvelles polices.
-.\" Dès lors les changements de tailles de caractères devraient être
-.\" utilisés avec prudence.
-.sh 2 "Guillemets"
-.pp
-En typographie,
-pour créer des guillemets,
-il est habituel
-d'utiliser deux accents graves et deux accents aigus,
-plutôt  que les guillemets
-(`\|"\|').
-C'est parce que
-deux accents graves et deux accents aigus
-donnent un meilleur résultat optique.
-Par exemple, comparez
-"guillemets" à
-``guillemets''.
-.pp
-Vous pourrez aussi utiliser la séquence
-.b \e*(lq
-et
-.b \e*(rq
-pour mettre les guillemets respectivement à gauche et à droite
-du mot ou de l'expression concernés.
-Par exemple,
-utilisez:
-.(b
-\e*(lqCertaines choses ne sont pas vraies,
-même si elles ont eu lieu.\e*(rq
-.)b
-génère le résultat:
-.(b
-.q "Certaines choses ne sont pas vraies, même si elles ont eu lieu"
-.)b
-Plus rapide, la requête:
-.(b
-\&.q "texte entre guillemets"
-.)b
-générera
-.q "texte entre guillemets" .
-Notez que vous devez entourer
-le texte concerné de guillemets
-s'il est formé de plusieurs mots.
-.sh 0
-.sp 1i
-.b Remerciements
-.pp
-J'aimerais remercier
-Bob Epstein,
-Bill Joy,
-et Larry Rowe
-pour avoir eu le courage
-d'utiliser les macros \-me
-pour écrire des documents inhabituels
-durant la phase de développement;
-Ricki Blau,
-Pamela Humphrey,
-et Jim Joyce
-pour leur aide durant la phase de documentation;
-Peter Kessler
-pour ses nombreux griefs,
-des années après que j'aie considéré le projet comme
-.q achevé ,
-le plus souvent accompagnés de propositions de solutions
-(qui m'ont donc forcé à réparer plusieurs petits bogues);
-et la foule de gens qui ont contribué à ce projet
-par leurs idées ou leur soutien.
-.sp 1i
-Ce document a été
-.sm GROFF é
-le 27 octobre 2001 et s'applique à la version des macros  \-me
-inclus dans la version 1.17.2 de \*G.
-.sp 1i
-La traduction française a été
-.sm GROFF ée
-le 20 octobre 2013, toutes les commandes ont été testées sur la version 1.21 de \*G.
-.(b
-.uh "Annexe: petit lexique des noms de requêtes"
-Par ordre d'apparition dans le texte  
-.sp 
-.TS
-tab(|); 
-l l l .
-\&.sp|space|espacement
-\&.pp|paragraph|nouveau paragraphe
-\&.he|header|en-tête
-\&.fo|footer|pied de page
-\&.ls|line spacing|espacement vertical (entre les lignes)
-\&.in|indent|indentation
-\&.ce|center|centrer
-\&.br|break|interruption (commence une nouvelle ligne)
-\&.(q|quote|citation (début)
-\&.)q|quote|citation (fin)
-\&.(l|list|liste (début)
-\&.)l|list|liste (fin)
-\&.(b|bloc|bloc (début)
-\&.)b|bloc|bloc (fin)
-\&.(z|floating keep|clos flottant (début)
-\&.)z|floating keep|clos flottant (fin)
-\&.hl|horizontal line|ligne horizontale
-\&.(c|centered block|bloc centré (début)
-\&.)c|centered block|bloc centré (fin)
-\&.(f|footnote|note en bas de page (début)
-\&.)f|footnote|note en bas de page (fin)
-\&.(x|index|faire apparaître dans l'index (début)
-\&.)x|index|faire apparaître dans l'index (fin)
-\&.xp|print index|imprimer l'index
-\&.lp|lined up paragraph|paragraphe aligné (à 1e ligne non-indentée)
-\&.ip|indented paragraph|paragraphe indenté, sauf en sa première ligne
-\&.np|numbered paragraph|paragraphe numéroté
-\&.sh|set header|faire un titre
-\&.uh|unnumbered header|titre non-numéroté
-\&.tp|title page|page de titre
-\&.+c|add chapter|ajouter un chapitre
-\&.EQ|equation|équation (début)
-\&.EN|equation|équation (fin)
-\&.TS|table start|tableau (début)
-\&.TE|table end|tableau (fin)
-\&.2c|2 column|écrire sur 2 colonnes
-\&.1c|1 columns|écrire sur 1 colonne
-\&.de xx|define macro|définir un macro
-\&.r|roman|roman
-\&.i|italic|italique
-\&.b|bold|gras
-\&.bi|bold italic|italique gras
-\&.u|underlined|souligné
-\&.bx|box|encadré
-\&.sz|size|taille de police
-\&.sm|small|plus petit que le texte environnant
-\&.q|quoted|entre guillemets
-.TE
-.)b
-.\" Local Variables:
-.\" mode: nroff
-.\" coding: utf-8
-.\" End:
-.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/doc/meref.me Deleted

@@ -1,2241 +0,0 @@
-.\" Copyright (c) 1986 The Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-.\"
-.\"	@(#)ref.me	6.4 (Berkeley) 7/17/89
-.\"
-.\" Modified by jjc@jclark.com for groff.
-.\"UC 7
-.ll 6.5i
-.lt 6.5i
-.\"pn 0
-.ds MO @VERSION@
-.de TL			\" *** title line
-.lp
-.di XX
-..
-.ie \n(.g \{\
-.de DE
-\?\h'|\\n(DIu'\c\?
-..
-.\}
-.el \{\
-.de DE
-\\\\h'|\\\\n(DIu'\\\\c
-..
-.\}
-.am DE
-.br
-.di
-.in +\\n(DIu
-.ti 0
-.cu 1000
-.XX
-.rm XX
-.cu 0
-..
-.ds G \s-1GROFF\s0
-.ds N \s-1NROFF\s0
-.ds T \s-1TROFF\s0
-.nr DI 1.5i
-.he '\-ME REFERENCE MANUAL''%'
-.de NR
-.b "\en\\$1" "\\$2"
-..
-.de ST
-.b "\e*\\$1" "\\$2"
-..
-.\"sc
-.\"eh 'USD:23-%''\-me Reference Manual'
-.\"oh '\-me Reference Manual''USD:23-%'
-.+c
-.ce 20
-.sz 14
-.b "\-ME REFERENCE MANUAL"
-.sz
-.sp
-.i "\*G Version \*(MO\(dg"
-.(f
-\(dgBased on Berkeley Release 2.31.
-.)f
-.sp 2
-.ul
-Eric P. Allman*
-.(f
-*Author's current address:
-Britton Lee, Inc.,
-1919 Addison Suite 105,
-Berkeley, California 94704.
-.)f
-.sp
-Project INGRES
-Electronics Research Laboratory
-University of California, Berkeley
-Berkeley, California  94720
-.sp 2
-.i "Modified for \*G by James Clark"
-.ce 0
-.sp 4
-.pp
-This document describes
-in extremely terse form
-the features
-of the
-.b \-me
-macro package
-for \*G.
-Some familiarity is assumed
-with
-\*G.
-Specifically,
-the reader should understand
-breaks,
-fonts,
-pointsizes,
-the use and definition of number registers
-and strings,
-how to define macros,
-and scaling factors for ens, points,
-.b v 's
-(vertical line spaces),
-etc.
-.pp
-For a more casual introduction
-to text processing
-using \*G,
-refer to the document
-.ul
-Writing Papers with \*G using \-me.
-.pp
-There are a number of macro parameters
-that may be adjusted.
-Fonts may be set to a font number only.
-Font 0 is no font change;
-the font of the surrounding text
-is used instead.
-Notice that font 0 is a
-.q pseudo-font ;
-that is,
-it is simulated by the macros.
-This means that although it is valid to set a font register
-to zero,
-it is not valid to use the escape character form,
-such as:
-.(b
-\ef0
-.)b
-.pp
-All distances
-are in basic units,
-so it is nearly always necessary
-to use a scaling factor.
-For example,
-the request
-to set the paragraph indent
-to eight one-en spaces is:
-.(b
-\&.nr pi 8n
-.)b
-and not
-.(b
-\&.nr pi 8
-.)b
-which would set the paragraph indent to eight basic units,
-or about 0.02 inch.
-Default parameter values are given in brackets
-in the remainder of this document.
-.pp
-Registers and strings
-of the form
-.b $ \c
-.i x
-may be used in expressions
-but should not be changed.
-Macros of the form
-.b $ \c
-.i x
-perform some function
-(as described)
-and may be redefined
-to change this function.
-This may be a sensitive operation;
-look at the body of the original macro
-before changing it.
-.pp
-All names in \-me
-follow a rigid naming convention.
-The user may define number registers,
-strings,
-and macros,
-provided that s/he
-uses single character upper case names
-or double character names
-consisting of letters and digits,
-with at least one upper case letter.
-In no case should special characters
-be used in user-defined names.
-Locally defined macros
-should all be of the form
-.b .* \c
-.i X ,
-where
-.i X
-is any letter
-(upper or lower case)
-or digit.
-.pp
-This documentation applies to \*G version
-\*(MO
-of the \-me macros.
-.sh 1 "Paragraphing"
-.pp
-These macros are used
-to begin paragraphs.
-The standard paragraph macro
-is
-.b .pp ;
-the others are all variants
-to be used for special purposes.
-.pp
-After the first call to one of the paragraphing macros
-defined in this section
-or the
-.b .sh
-macro
-(defined in the next section),
-the effects of changing parameters
-which will have a global effect
-on the format of the page
-(notably page length and header and footer margins)
-are not well defined
-and should be avoided.
-.TL
-.b .lp
-.DE
-Begin left-justified paragraph.
-Centering and underlining
-are turned off if they were on,
-the font is set to
-.NR (pf
-1
-the type size
-is set to
-.NR (pp
-10p,
-and a
-.NR (ps
-space is inserted
-before the paragraph
-0.35v
-The indent is reset
-to
-.NR ($i
-0
-plus
-.NR (po
-0
-unless the paragraph
-is inside a display.
-(see
-.b .ba ).
-At least
-the first two lines
-of the paragraph
-are kept together
-on a page.
-.TL
-.b .pp
-.DE
-Like
-.b .lp ,
-except that it puts
-.NR (pi
-5n
-units of indent.
-This is the standard paragraph macro.
-.TL
-.b .ip
-.i T
-.i I
-.DE
-Indented paragraph
-with hanging tag.
-The body of the following paragraph
-is indented
-.i I
-spaces
-(or
-.NR (ii
-5n
-spaces
-if
-.i I
-is not specified)
-more than a non-indented paragraph
-(such as with
-.b .pp )
-is.
-The title
-.i T
-is exdented (opposite of indented).
-The result is a paragraph
-with an even left edge
-and
-.i T
-printed in the margin.
-Any spaces in
-.i T
-must be unpaddable.
-If
-.i T
-will not fit in the space provided,
-.b .ip
-will start a new line.
-.TL
-.b .np
-.DE
-A variant of .ip which numbers paragraphs.
-Numbering is reset
-after a
-.b .lp ,
-.b .pp ,
-or
-.b .sh .
-The current paragraph number
-is in
-.NR ($p .
-.TL
-.b .bu
-.DE
-Like
-.b .np
-except that paragraphs are marked with bullets (\(bu).
-Leading space is eliminated to create compact lists.
-.sh 1 "Section Headings"
-.pp
-Numbered sections
-are similar to paragraphs
-except that a
-section number
-is automatically
-generated for each one.
-The section numbers are of the form
-.b 1.2.3 .
-The
-.i depth
-of the section
-is the count of numbers
-(separated by decimal points)
-in the section number.
-.pp
-Unnumbered section headings are similar,
-except that no number is attached
-to the heading.
-.TL
-.b .sh
-.i +N
-.i T
-.i "a b c d e f"
-.DE
-Begin numbered section
-of depth
-.i N .
-If
-.i N
-is missing
-the current depth
-(maintained in
-the number register
-.NR ($0 )
-is used.
-The values of
-the individual parts of the section number
-are maintained in
-.NR ($1
-through
-.NR ($6 .
-There is a
-.NR (ss
-1v
-space before the section.
-.i T
-is printed
-as a section title
-in font
-.NR (sf
-8
-and size
-.NR (sp
-10p.
-The
-.q name
-of the section may be accessed via
-.ST ($n .
-If
-.NR (si
-is non-zero,
-the base indent
-is set to
-.NR (si
-times the section depth,
-and the section title
-is exdented.
-(See
-.b .ba .)
-Also,
-an additional indent of
-.NR (so
-0
-is added to the section title
-(but not to the body of the section).
-The font is then set
-to the paragraph font,
-so that more information may occur
-on the line
-with the section number
-and title.
-.b .sh
-insures that there is enough room
-to print the section head
-plus the beginning of a paragraph
-(about 3 lines total).
-If
-.i a
-through
-.i f
-are specified,
-the section number is set to that number
-rather than incremented automatically.
-If any of
-.i a
-through
-.i f
-are a hyphen
-that number is not reset.
-If
-.i T
-is a single underscore
-(\c
-.q _ )
-then the section depth and numbering is reset,
-but the base indent is not reset
-and nothing is printed out.
-This is useful to automatically
-coordinate section numbers with
-chapter numbers.
-.TL
-.b .sx
-.i +N
-.DE
-Go to section depth
-.i N
-\c
-.b \-1 ,
-but do not print the number
-and title,
-and do not increment the section number
-at level
-.i N .
-This has the effect
-of starting a new paragraph
-at level
-.i N .
-.TL
-.b .uh
-.i T
-.DE
-Unnumbered section heading.
-The title
-.i T
-is printed
-with the same rules for spacing,
-font, etc.,
-as for
-.b .sh .
-.TL
-.b .$p
-.i T
-.i B
-.i N
-.DE
-Print section heading.
-May be redefined
-to get fancier headings.
-.i T
-is the title passed on the
-.b .sh
-or
-.b .uh
-line;
-.i B
-is the section number for this section,
-and
-.i N
-is the depth of this section.
-These parameters are not always present;
-in particular,
-.b .sh
-passes all three,
-.b .uh
-passes only the first,
-and
-.b .sx
-passes three,
-but the first two
-are null strings.
-Care should be taken if this macro
-is redefined;
-it is quite complex and subtle.
-.TL
-.b .$0
-.i T
-.i B
-.i N
-.DE
-This macro is called automatically
-after every call to
-.b .$p .
-It is normally undefined,
-but may be used
-to automatically put
-every section title
-into the table of contents
-or for some similar function.
-.i T
-is the section title
-for the section title which was just printed,
-.i B
-is the section number,
-and
-.i N
-is the section depth.
-.TL
-.b .$1
-\-
-.b .$6
-.DE
-Traps called just before printing that depth section.
-May be defined to
-(for example)
-give variable spacing
-before sections.
-These macros are called from
-.b .$p ,
-so if you redefine that macro
-you may lose this feature.
-.sh 1 "Headers and Footers"
-.ds TP \fI\(aal\|\(aam\^\(aar\^\(aa\fP
-.pp
-Headers and footers
-are put at the top and bottom
-of every page
-automatically.
-They are set in font
-.NR (tf
-3
-and size
-.NR (tp
-10p.
-Each of the definitions
-apply as of the
-.i next
-page.
-Three-part titles
-must be quoted
-if there are two blanks adjacent
-anywhere in the title
-or more than eight blanks total.
-.pp
-The spacing
-of headers and footers
-are controlled by three number registers.
-.NR (hm
-4v
-is the distance from the top of the page
-to the top of the header,
-.NR (fm
-3v
-is the distance from the bottom of the page
-to the bottom of the footer,
-.NR (tm
-7v
-is the distance from the top of the page
-to the top of the text,
-and
-.NR (bm
-6v
-is the distance from the bottom of the page
-to the bottom of the text
-(nominal).
-The macros
-.b .m1 ,
-.b .m2 ,
-.b .m3 ,
-and
-.b .m4
-are also supplied for compatibility
-with
-\s-1ROFF\s0 documents.
-.TL
-.b .he
-\*(TP
-.DE
-Define three-part header,
-to be printed on the top
-of every page.
-.TL
-.b .fo
-\*(TP
-.DE
-Define footer,
-to be printed at the bottom
-of every page.
-.TL
-.b .eh
-\*(TP
-.DE
-Define header,
-to be printed at the top of every
-even-numbered page.
-.TL
-.b .oh
-\*(TP
-.DE
-Define header,
-to be printed at the top of every
-odd-numbered page.
-.TL
-.b .ef
-\*(TP
-.DE
-Define footer,
-to be printed at the bottom
-of every even-numbered page.
-.TL
-.b .of
-\*(TP
-.DE
-Define footer,
-to be printed at the bottom
-of every odd-numbered page.
-.TL
-.b .hx
-.DE
-Suppress headers and footers
-on the next page.
-.TL
-.b .m1
-.i +N
-.DE
-Set the space between the top of the page
-and the header
-4v.
-.TL
-.b .m2
-.i +N
-.DE
-Set the space between the header
-and the first line of text
-2v.
-.TL
-.b .m3
-.i +N
-.DE
-Set the space
-between the bottom of the text
-and the footer
-2v.
-.TL
-.b .m4
-.i +N
-.DE
-Set the space
-between the footer
-and the bottom of the page
-4v.
-.TL
-.b .ep
-.DE
-End this page,
-but do not begin the next page.
-Useful for forcing out footnotes,
-but other than
-that hardly every used.
-Must be followed by a
-.b .bp
-or the end of input.
-.TL
-.b .$h
-.DE
-Called at every page
-to print the header.
-May be redefined
-to provide fancy
-(e.g.,
-multi-line)
-headers,
-but doing so
-loses the function of the
-.b .he ,
-.b .fo ,
-.b .eh ,
-.b .oh ,
-.b .ef ,
-and
-.b .of
-requests,
-as well as the chapter-style title feature
-of
-.b .+c .
-.TL
-.b .$f
-.DE
-Print footer;
-same comments apply
-as in
-.b .$h .
-.TL
-.b .$H
-.DE
-A normally undefined macro
-which is called
-at the top of each page
-(after putting out
-the header,
-initial saved floating keeps,
-etc.),
-or of each column when in two-column mode;
-in other words,
-this macro is called immediately before
-printing text
-on a page or in a column.
-It can be used for column headings
-and the like.
-.sh 1 "Displays"
-.pp
-All displays except centered blocks
-and block quotes
-are preceded and followed
-by an extra
-.NR (bs
-same as
-.NR (ps 
-space.
-Quote spacing is stored in a separate register;
-centered blocks have no default initial or trailing space.
-The vertical spacing of all displays except quotes
-and centered blocks
-is stored in register
-.NR ($V
-instead of
-.NR ($v .
-.TL
-.b .(l
-.i m
-.i f
-.DE
-Begin list.
-Lists are single spaced,
-unfilled text.
-If
-.i f
-is
-.b F ,
-the list will be filled.
-If
-.i m
-\c
-.b I 
-is
-.b I
-the list is indented by
-.NR (bi
-4m;
-if
-.b M
-the list is indented to the left margin;
-if
-.b L
-the list is left justified with respect to the text
-(different from
-.b M
-only if the base indent
-(stored in
-.NR ($i
-and set with
-.b .ba )
-is not zero);
-and if
-.b C
-the list is centered on a line-by-line basis.
-The list is set in font
-.NR (df
-0.
-Must be matched by a
-.b .)l .
-This macro is almost like
-.b .(b
-except that no attempt is made
-to keep the display on one page.
-.TL
-.b .)l
-.DE
-End list.
-.TL
-.b .(q
-.DE
-Begin major quote.
-These are single spaced,
-filled,
-moved in from the text
-on both sides
-by
-.NR (qi
-4n,
-preceded and followed
-by
-.NR (qs
-same as
-.NR (bs 
-space,
-and are set in point size
-.NR (qp
-one point smaller than surrounding text.
-.TL
-.b .)q
-.DE
-End major quote.
-.TL
-.b .(b
-.i m
-.i f
-.DE
-Begin block.
-Blocks are a form of
-.i keep ,
-where the text of a keep
-is kept together on one page
-if possible
-(keeps are useful
-for tables and figures
-which should not be broken
-over a page).
-If the block will not fit
-on the current page
-a new page is begun,
-.i unless
-that would leave more than
-.NR (bt
-0
-white space
-at the bottom of the text.
-If
-.NR (bt
-is zero, the threshold feature
-is turned off.
-Blocks are not filled
-unless
-.i f
-is
-.b F ,
-when they are filled.
-The block will be left-justified
-if
-.i m
-is
-.b L ,
-indented by
-.NR (bi
-4m
-if
-.i m
-is
-.b I
-or absent,
-centered
-(line-for-line)
-if
-.i m
-is
-.b C ,
-and left justified to the margin
-(not to the base indent)
-if
-.i m
-is
-.b M .
-The block is set in font
-.NR (df
-0.
-.TL
-.b .)b
-.DE
-End block.
-.TL
-.b .(z
-.i m
-.i f
-.DE
-Begin floating keep.
-Like
-.b .(b
-except that the keep is
-.i floated
-to the bottom of the page
-or the top of the next page.
-Therefore,
-its position relative to the text changes.
-The floating keep is preceded and followed
-by
-.NR (zs
-1v
-space.
-Also,
-it defaults to mode
-.b M .
-.TL
-.b .)z
-.DE
-End floating keep.
-.TL
-.b .(c
-.DE
-Begin centered block.
-The next keep
-is centered as a block,
-rather than on a line-by-line basis
-as with
-.b ".(b C" .
-This call may be nested
-inside keeps.
-.TL
-.b .)c
-.DE
-End centered block.
-.sh 1 Annotations
-.TL
-.b .(d
-.DE
-Begin delayed text.
-Everything in the next keep
-is saved for output
-later with
-.b .pd ,
-in a manner
-similar to footnotes.
-.TL
-.b .)d
-.i n
-.DE
-End delayed text.
-The delayed text number register
-.NR ($d
-and the associated string
-.ST #
-are incremented if
-.ST #
-has been referenced.
-.TL
-.b .pd
-.DE
-Print delayed text.
-Everything diverted via
-.b .(d
-is printed and truncated.
-This might be used
-at the end of each chapter.
-.TL
-.b .(f
-.DE
-Begin footnote.
-The text of the footnote
-is floated to the bottom
-of the page
-and set in font
-.NR (ff
-1
-and size
-.NR (fp
-8p.
-Each entry
-is preceded by
-.NR (fs
-0.2v
-space,
-is indented
-.NR (fi
-3n
-on the first line,
-and is indented
-.NR (fu
-0
-from the right margin.
-Footnotes line up underneath
-two column output.
-If the text of the footnote
-will not all fit on one page
-it will be carried over
-to the next page.
-.TL
-.b .)f
-.i n
-.DE
-End footnote.
-The number register
-.NR ($f
-and the associated string
-.ST *
-are incremented
-if they have been referenced.
-.TL
-.b .$s
-.DE
-The macro to output the footnote separator.
-This macro may be redefined
-to give other size lines or other types
-of separators.
-Currently
-it draws a 1.5i line.
-.TL
-.b .(x
-.i x
-.DE
-Begin index entry.
-Index entries are saved in the index
-.i x
-\c
-.b x 
-until called up with
-.b .xp.
-Each entry is preceded
-by a
-.NR (xs
-0.2v
-space.
-Each entry is
-.q undented
-by
-.NR (xu
-0.5i;
-this register tells how far the page number
-extends into the right margin.
-.TL
-.b .)x
-.i P
-.i A
-.DE
-End index entry.
-The index entry
-is finished with a row of dots
-with
-.i A
-null
-right justified on the last line
-(such as for an author's name),
-followed by P
-\c
-.NR % .
-If
-.i A
-is specified,
-.i P
-must be specified;
-.NR %
-can be used to print the current page number.
-If
-.i P
-is an underscore,
-no page number
-and no row of dots
-are printed.
-.TL
-.b .xp
-.i x
-.DE
-Print index
-.i x
-\c
-.b x .
-The index is formatted in the font, size, and so forth
-in effect at the time it is printed,
-rather than at the time it is collected.
-.sh 1 "Columned Output"
-.TL
-.b .2c
-.i +S
-.i N
-.DE
-Enter two-column mode.
-The column separation is set to
-.i +S
-4n, 0.5i in ACM mode
-(saved in
-.NR ($s ).
-The column width,
-calculated to fill the single column line length
-with both columns,
-is stored in
-.NR ($l .
-The current column
-is in
-.NR ($c .
-You can test register
-.NR ($m
-1
-to see if you are in single column
-or double column mode.
-Actually,
-the request enters
-.i N
-2
-column output.
-.TL
-.b .1c
-.DE
-Revert to single-column mode.
-.TL
-.b .bc
-.DE
-Begin column.
-This is like
-.b .bp
-except that it begins a new column
-on a new page
-only if necessary,
-rather than forcing a whole new page
-if there is another column left
-on the current page.
-.sh 1 "Fonts and Sizes"
-.TL
-.b .sz
-.i +P
-.DE
-The pointsize is set to
-.i P
-10p,
-and the line spacing is set proportionally.
-The line spacing as a percentage of the pointsize expressed in units
-is stored in
-.NR ($v .
-The percentage used internally
-by displays and annotations
-is stored in
-.NR ($V
-(although this is not used by
-.b .sz ).
-This size is
-.i not
-sticky beyond many macros:
-in particular,
-.NR (pp
-(paragraph pointsize)
-modifies the pointsize every time a new paragraph is begun
-using the
-.b \&.pp ,
-.b \&.lp ,
-.b \&.ip ,
-.b \&.np ,
-or
-.b \&.bu
-macros.
-Also,
-.NR (fp
-(footnote pointsize),
-.NR (qp
-(quote pointsize),
-.NR (sp
-(section header pointsize),
-and
-.NR (tp
-(title pointsize)
-may modify the pointsize.
-.TL
-.b .r
-.i W
-.i X
-.DE
-Set
-.i W
-in roman font,
-appending
-.i X
-in the previous font.
-To append different font requests,
-use
-.i X
-=
-.b \ec .
-If no parameters,
-change to roman font.
-.TL
-.b .i
-.i W
-.i X
-.DE
-Set
-.i W
-in italics,
-appending
-.i X
-in the previous font.
-If no parameters,
-change to italic font.
-.TL
-.b .b
-.i W
-.i X
-.DE
-Set
-.i W
-in bold font
-and append
-.i X
-in the previous font.
-If no parameters,
-switch to bold font.
-.TL
-.b .u
-.i W
-.i X
-.DE
-Underline
-.i W
-and append
-.i X .
-This is a true underlining,
-as opposed to the
-.b .ul
-request,
-which changes to
-.q "underline font"
-(usually italics in \*G).
-It won't work right
-if
-.i W
-is spread or broken (including hyphenated).
-In other words,
-it is safe in nofill mode only.
-.TL
-.b .q
-.i W
-.i X
-.DE
-Quote
-.i W
-and append
-.i X .
-In \*G
-this surrounds
-.i W
-with
-.b \*(lq ,
-and
-.b \*(rq .
-.TL
-.b .bi
-.i W
-.i X
-.DE
-Set
-.i W
-in bold italics
-and append
-.i X .
-.TL
-.b .bx
-.i W
-.i X
-.DE
-Sets
-.i W
-in a box,
-with
-.i X
-appended.
-It won't work right
-if
-.i W
-is spread or broken (including hyphenated).
-In other words,
-it is safe in nofill mode only.
-.TL
-.b .sm
-.i W
-.i X
-.DE
-Sets
-.i W
-in a smaller pointsize,
-with
-.i X
-appended.
-.sh 1 "Roff Support"
-.TL
-.b .ix
-.i +N
-.DE
-Indent,
-no break.
-Equivalent to
-.b \(aain
-.i N .
-.TL
-.b .bl
-.i N
-.DE
-Leave
-.i N
-contiguous white space,
-on the next page if not enough room
-on this page.
-Equivalent to putting a
-.b .sp
-.i N
-inside a block.
-.TL
-.b .pa
-.i +N
-.DE
-Equivalent to
-.b .bp .
-.TL
-.b .ro
-.DE
-Set page number
-in roman numerals.
-Equivalent to
-.b ".af % i" .
-.TL
-.b .ar
-.DE
-Set page number in Arabic.
-Equivalent to
-.b ".af % 1" .
-.TL
-.b .n1
-.DE
-Number lines in margin from one
-on each page.
-.TL
-.b .n2
-.i N
-.i c
-.DE
-Number lines from
-.i N ,
-stop if
-.i N
-missing; resume where stopped with (unsigned) value
-.i N
-or increment
-.i N
-if
-.i N
-is \(+-\c
-.i N .
-If
-.i c
-is c, maintain compatibility with original
-.b .n2
-by narrowing line width to accommodate numbers.
-.TL
-.b .sk
-.DE
-Leave the next output page blank,
-except for headers and footers.
-This is used to leave space
-for a full-page diagram
-which is produced externally
-and pasted in later.
-To get a partial-page paste-in display,
-say
-.b .sv \ \c
-.i N ,
-where
-.i N
-is the amount of space
-to leave;
-this space will be output immediately
-if there is room,
-and will otherwise be output
-at the top of the next page.
-However, be warned:
-if
-.i N
-is greater than the amount of available space
-on an empty page,
-no space will ever be output.
-.sh 1 "Preprocessor Support"
-.TL
-.b .EQ
-.i m
-.i T
-.DE
-Begin equation.
-The equation is centered
-if
-.i m
-is
-.b C
-or omitted,
-indented
-.NR (bi
-4m
-if
-.i m
-is
-.b I ,
-and left justified if
-.i m
-is
-.b L .
-.i T
-is a title printed on the right margin
-next to the equation.
-See
-.i "Typesetting Mathematics \- User's Guide"
-by Brian W. Kernighan
-and Lorinda L. Cherry.
-.TL
-.b .EN
-.i c
-.DE
-End equation.
-If
-.i c
-is
-.b C
-the equation must be continued
-by immediately following
-with another
-.b .EQ ,
-the text of which
-can be centered
-along with this one.
-Otherwise,
-the equation is printed,
-always on one page,
-with
-.NR (es
-0.5v
-space
-above and below it.
-.TL
-.b .TS
-.i h
-.DE
-Table start.
-Tables are single spaced
-and kept on one page
-if possible.
-If you have a large table
-which will not fit on one page,
-use
-.i h
-=
-.b H
-and follow the header part
-(to be printed on every page of the table)
-with a
-.b .TH .
-See
-.i "Tbl \- A Program to Format Tables"
-by M. E. Lesk.
-.TL
-.b .TH
-.DE
-With
-.b ".TS H" ,
-ends the header portion of the table.
-.TL
-.b .TE
-.DE
-Table end.
-Note that this table
-does not float,
-in fact,
-it is not even guaranteed to stay on one page
-if you use requests such as
-.b .sp
-intermixed with the text
-of the table.
-If you want it to float
-(or if you use requests
-inside the table),
-surround the entire table
-(including the
-.b .TS
-and
-.b .TE
-requests)
-with the requests
-.b .(z
-and
-.b .)z .
-.TL
-.b .PS
-.i h
-.i w
-.DE
-Begin
-.i pic
-picture.
-.i H
-is the height and
-.i w
-is the width,
-both in basic units.
-.TL
-.b .PE
-.DE
-End picture.
-.TL
-.b .IS
-.DE
-Begin
-.i ideal
-picture.
-.TL
-.b .IE
-.DE
-End
-.i ideal
-picture.
-.TL
-.b .IF
-.DE
-End
-.i ideal
-picture (alternate form).
-.TL
-.b .GS
-.i x
-.DE
-Begin
-.i gremlin
-picture.
-.i X
-can be either
-.b C ,
-.b L ,
-or
-.b R
-to center, left, or right justify the
-whole picture.
-Default is centering the image.
-.TL
-.b .GE
-.DE
-End
-.i gremlin
-picture.
-.TL
-.b .GF
-.DE
-End
-.i gremlin
-picture (alternate form).
-.sh 1 "Miscellaneous"
-.TL
-.b .re
-.DE
-Reset tabs every 0.5i.
-.TL
-.b .ba
-.i +N
-.DE
-Set the base indent
-to
-.i +N
-0
-(saved in
-.NR ($i ).
-All paragraphs,
-sections,
-and displays
-come out indented by this amount.
-Titles and footnotes
-are unaffected.
-The
-.b .sh
-request performs a
-.b .ba
-request
-if
-.NR (si
-0 is not zero,
-and sets the base indent to
-.NR (si \c
-.b * \c
-.NR ($0 .
-.TL
-.b .xl
-.i +N
-.DE
-Set the line length to
-.i N
-6.0i.
-This differs
-from
-.b .ll
-because it only affects the current environment.
-.TL
-.b .ll
-.i +N
-.DE
-Set line length in all environments
-to
-.i N
-6.0i.
-This should not be used
-after output has begun,
-and particularly not in two-column output.
-The current line length is stored in
-.NR ($l .
-.TL
-.b .hl
-.DE
-Draws a horizontal line
-the length of the page.
-This is useful
-inside floating keeps
-to differentiate
-between the text
-and the figure.
-.sh 1 "Standard Papers"
-.TL
-.b .tp
-.DE
-Begin title page.
-Spacing at the top of the page
-can occur,
-and headers and footers are suppressed.
-Also,
-the page number
-is not incremented
-for this page.
-.TL
-.b .++
-.i m
-.i H
-.DE
-This request defines the section of the paper
-which we are entering.
-The section type is defined by
-.i m .
-.b C
-means that we are entering the chapter portion
-of the paper,
-.b A
-means that we are entering the appendix portion
-of the paper,
-.b P
-means that the material following
-should be the preliminary portion
-(abstract, table of contents, etc.)
-portion of the paper,
-.b AB
-means that we are entering the abstract
-(numbered independently from 1
-in Arabic numerals),
-and
-.b B
-means that we are entering the bibliographic
-portion at the end of the paper.
-Also, the variants
-.b RC
-and
-.b RA
-are allowed,
-which specify renumbering of pages
-from one at the beginning of each
-chapter or appendix,
-respectively.
-The section type is available in register
-.NR (_M
-1; value 1 is equivalent to type
-.b C
-or
-.b RC ,
-value 2 represents type
-.b A
-or
-.b RA ,
-and values 3 to 5 are type
-.b P ,
-.b B ,
-and
-.b AB ,
-respectively.
-The
-.i H
-parameter defines the new header.
-If there are any spaces in it,
-the entire header must be quoted.
-If you want the header to have the chapter number
-in it,
-Use the string
-.b "\e\e\e\en(ch" .
-For example, to number appendixes
-.b A.1
-etc.,
-type
-.b ".++ RA \(aa\(aa\(aa\e\e\e\en(ch.%\(aa" .
-Each section
-(chapter, appendix, etc.)
-should be preceded by the
-.b .+c
-request.
-It should be mentioned
-that it is easier when using
-\*T to put the front material
-at the end of the paper,
-so that the table of contents
-can be collected and put out;
-this material can then be physically
-moved to the beginning of the paper.
-.TL
-.b .+c
-.i T
-.DE
-Begin chapter with title
-.i T .
-The chapter number
-is maintained in
-.NR (ch .
-This register is incremented
-every time
-.b .+c
-is called with a parameter.
-The title and chapter number
-are printed by
-.b .$c .
-The header is moved to the footer
-on the first page
-of each chapter.
-If
-.i T
-is omitted,
-.b .$c
-is not called;
-this is useful for doing your own
-.q "title page"
-at the beginning of papers
-without a title page proper.
-.b .$c
-calls
-.b .$C
-as a hook so that chapter titles can be inserted
-into a table of contents automatically.
-The footnote numbering is reset to one.
-.TL
-.b .$c
-.i T
-.DE
-Print chapter number
-(from
-.NR (ch )
-and
-.i T .
-This macro can be redefined to your liking.
-It is defined by default
-to be acceptable
-for a PhD thesis
-at Berkeley.
-This macro calls
-.b $C ,
-which can be defined to make index entries,
-or whatever.
-.TL
-.b .$C
-.i K
-.i N
-.i T
-.DE
-This macro is called by
-.b .$c .
-It is normally undefined,
-but can be used to automatically insert
-index entries,
-or whatever.
-.i K
-is a keyword,
-either
-.q Chapter
-or
-.q Appendix
-(depending on the
-.b .++
-mode);
-.i N
-is the chapter or appendix number,
-and
-.i T
-is the chapter or appendix title.
-.sh 1 "Predefined Strings"
-.TL
-.ST *
-.DE
-Footnote number, actually
-.ST  \c
-.NR ($f \c
-.ST  .
-The number in this string is incremented
-after each call to
-.b .)f .
-.TL
-.ST #
-.DE
-Delayed text number.
-Actually
-\c
-.NR ($d .
-.TL
-.ST {
-.DE
-Superscript.
-This string gives upward movement
-and a change to a smaller point size.
-Extra space is left above the line
-to allow room for the superscript.
-.TL
-.ST }
-.DE
-Unsuperscript.
-Inverse to
-.ST { .
-For example,
-to produce a superscript
-you might type
-.b x \c
-.ST { \c
-.b 2 \c
-.ST } ,
-which will produce
-.b x\*{2\*} .
-.TL
-.ST <
-.DE
-Subscript.
-Extra space is left below the line
-to allow for the subscript.
-.TL
-.ST >
-.DE
-Inverse to
-.ST < .
-.TL
-.ST (dw
-.DE
-The day of the week,
-as a word.
-.TL
-.ST (mo
-.DE
-The month,
-as a word.
-.TL
-.ST (td
-.DE
-Today's date,
-directly printable.
-The date is of the form February 15, 2003.
-Other forms of the date can be used
-by using
-.NR (dy
-(the day of the month;
-for example, 15),
-.ST (mo
-(as noted above)
-or
-.NR (mo
-(the same,
-but as an ordinal number;
-for example, February is 2),
-.NR (y4
-(the current year),
-and
-.NR (y2
-(the last two digits of the current year).
-.TL
-.ST (lq
-.DE
-Left quote marks.
-.TL
-.ST (rq
-.DE
-Right quote.
-.TL
-.ST \-
-.DE
-.ie \w'\(34'>0 \(34
-.el 3/4
-em dash.
-.sh 1 "Special Characters and Marks"
-.pp
-There are a number of special characters
-and diacritical marks
-(such as accents)
-available through \-me.
-.ta 15 +5 +6
-.nf
-Name	Usage	Example
-Acute accent	\e*\(aa	a\e*\(aa	a\*'
-Grave accent	\e*\(ga	e\e*\(ga	e\*`
-Umlaut	\e*:	u\e*:	u\*:
-Tilde	\e*~	n\e*~	n\*~
-Caret	\e*^	e\e*^	e\*^
-Cedilla	\e*,	c\e*,	c\*,
-Czech	\e*v	e\e*v	e\*v
-Circle	\e*o	A\e*o	A\*o
-There exists	\e*(qe		\*(qe
-For all	\e*(qa		\*(qa
-.fi
-.sp 1i
-.b Acknowledgments
-.pp
-I would like to thank
-Bob Epstein,
-Bill Joy,
-and Larry Rowe
-for having the courage
-to use the \-me macros
-to produce non-trivial papers
-during the development stages;
-Ricki Blau,
-Pamela Humphrey,
-and Jim Joyce
-for their help with the documentation phase;
-peter kessler
-for numerous complaints,
-most accompanied by fixes;
-and the plethora of people who have contributed ideas
-and have given support for the project.
-.bp
-.b Summary
-.pp
-This alphabetical list summarizes all macros, strings, and number registers
-available in the \-me macros.
-Selected
-.i troff
-commands, registers, and functions are included as well;
-those listed can generally be used with impunity.
-.pp
-The columns are the name of the
-command, macro, register, or string;
-the type of the object,
-and the description.
-Types are
-.b M
-for macro or builtin command
-(invoked with
-.b \&.
-or
-.b \&\'
-in the first input column),
-.b S
-for a string
-(invoked with
-.b \e*
-or
-.b \e*( ),
-.b R
-for a number register
-(invoked with
-.b \en
-or
-.b \en( ),
-and
-.b F
-for a
-.i troff
-builtin function
-(invoked by preceding it with a single backslash).
-.pp
-Lines marked with \(sc are
-.i troff
-internal codes.
-Lines marked with \(dg or \(dd
-may be defined by the user to get special functions;
-\(dd indicates that these are defined by default
-and changing them may have unexpected side effects.
-Lines marked with \(de
-are specific to
-.i ditroff
-(device-independent
-.i troff ).
-.de $H
-.ev 1
-.ta \w'\e(space)\(sc\ 'u +\w'TYPE  'u
-NAME	TYPE	DESCRIPTION
-.ev
-..
-.(l
-.$H
-\e(space)	F\(sc	unpaddable space
-\e"	F\(sc	comment (to end of line)
-\e*#	S	optional delayed text tag string
-\e$\fI\&N\fP	F\(sc	interpolate argument \fI\&N\fP
-\en($0	R	section depth
-\&.$0	M\(dg	invoked after section title printed
-\en($1	R	first section number
-\&.$1	M\(dg	invoked before printing depth 1 section
-\en($2	R	second section number
-\&.$2	M\(dg	invoked before printing depth 2 section
-\en($3	R	third section number
-\&.$3	M\(dg	invoked before printing depth 3 section
-\en($4	R	fourth section number
-\&.$4	M\(dg	invoked before printing depth 4 section
-\en($5	R	fifth section number
-\&.$5	M\(dg	invoked before printing depth 5 section
-\en($6	R	sixth section number
-\&.$6	M\(dg	invoked before printing depth 6 section
-\&.$C	M\(dg	called at beginning of chapter
-\&.$H	M\(dg	text header
-\en($V	R\(dd	relative vertical spacing in displays
-\en($c	R	current column number
-\&.$c	M\(dd	print chapter title
-\en($d	R	delayed text number
-\en($f	R	footnote number
-\&.$f	M\(dd	print footer
-\&.$h	M\(dd	print header
-\en($i	R	paragraph base indent
-\en($l	R	column width
-\en($m	R	number of columns in effect
-\e*($n	S	section name
-\en($p	R	numbered paragraph number
-\&.$p	M\(dd	print section heading (internal macro)
-\en($s	R	column indent
-\&.$s	M\(dd	footnote separator (from text)
-\en($v	R\(dd	relative vertical spacing in text
-\en%	R\(sc	current page number
-\e&	F\(sc	zero width character, useful for hiding controls
-\e(\fI\&xx\fP	F\(sc	interpolate special character \fI\&xx\fP
-\&.(b	M	begin block
-\&.(c	M	begin centered block
-\&.(d	M	begin delayed text
-\&.(f	M	begin footnote
-\&.(l	M	begin list
-\&.(q	M	begin quote
-\&.(x	M	begin index entry
-\&.(z	M	begin floating keep
-\&.)b	M	end block
-\&.)c	M	end centered block
-\&.)d	M	end delayed text
-\&.)f	M	end footnote
-\&.)l	M	end list
-\&.)q	M	end quote
-\&.)x	M	end index entry
-\&.)z	M	end floating keep
-\e*\fI\&x\fP	F\(sc	interpolate string \fI\&x\fP
-\e*(\fI\&xx\fP	F\(sc	interpolate string \fI\&xx\fP
-\e**	S	optional footnote tag string
-\&.++	M	set paper section type
-\&.+c	M	begin chapter
-\e*,	S	cedilla
-\e\-	F\(sc	minus sign
-\e*\-	S	3/4 em dash
-\e0	F\(sc	unpaddable digit-width space
-\&.1c	M	revert to single column output
-\&.2c	M	begin two column output
-\e*:	S	umlaut
-\e*<	S	begin subscript
-\e*>	S	end subscript
-\&.EN	M	end equation
-\&.EQ	M	begin equation
-\eL\'\fI\&d\fP\'	F\(sc	vertical line drawing function for distance \fI\&d\fP
-\&.GE	M\(de	end \fIgremlin\fP picture
-\&.GF	M\(de	end \fIgremlin\fP picture (with flyback)
-\&.GS	M\(de	start \fIgremlin\fP picture
-\&.IE	M\(de	end \fIideal\fP picture
-\&.IF	M\(de	end \fIideal\fP picture (with flyback)
-\&.IS	M\(de	start \fIideal\fP picture
-\&.PE	M\(de	end \fIpic\fP picture
-\&.PF	M\(de	end \fIpic\fP picture (with flyback)
-\&.PS	M\(de	start \fIpic\fP picture
-\&.TE	M	end table
-\&.TH	M	end header of table
-\&.TS	M	begin table
-\e*{	S	begin superscript
-\en(\&.$	R\(sc	number of arguments to macro
-\en(\&.i	R\(sc	current indent
-\en(\&.l	R\(sc	current line length
-\en(\&.s	R\(sc	current point size
-\e*(\&\'	S	acute accent
-\e*(\&\`	S	grave accent
-\e(\'	F\(sc	acute accent
-\e(\`	F\(sc	grave accent
-\e*}	S	end superscript
-\e^	F\(sc	1/12 em narrow space
-\e*^	S	caret
-\&.ad	M\(sc	set text adjustment
-\&.af	M\(sc	assign format to register
-\&.am	M\(sc	append to macro
-\&.ar	M	set page numbers in Arabic
-\&.as	M\(sc	append to string
-\&.b	M	bold font
-\&.ba	M	set base indent
-\&.bc	M	begin new column
-\&.bi	M	bold italic
-\en(bi	R	display (block) indent
-\&.bl	M	blank lines (even at top of page, in contrast to .sp)
-\en(bm	R	bottom title margin
-\&.bp	M\(sc	begin page
-\&.br	M\(sc	break (start new line)
-\en(bs	R	display (block) pre/post spacing
-\en(bt	R	block keep threshold
-\&.bx	M	boxed
-\ec	F\(sc	continue input
-\&.ce	M\(sc	center lines
-\en(ch	R	current chapter number
-\&.de	M\(sc	define macro
-\en(df	R	display font
-\&.ds	M\(sc	define string
-\en(dw	R\(sc	current day of week
-\e*(dw	S	current day of week
-\en(dy	R\(sc	day of month
-\ee	F\(sc	printable version of \e
-\&.ef	M	set footer (even numbered pages only)
-\&.eh	M	set header (even numbered pages only)
-\&.el	M\(sc	else part of conditional
-\&.ep	M	end page
-\en(es	R	equation pre/post space
-\ef\fI\&f\fP	F\(sc	inline font change to font \fI\&f\fP
-\ef(\fI\&ff\fP	F\(sc	inline font change to font \fI\&ff\fP
-\&.fc	M\(sc	set field characters
-\en(ff	R	footnote font
-\&.fi	M\(sc	fill output lines
-\en(fi	R	footnote indent (first line only)
-\en(fm	R	footer margin
-\&.fo	M	set footer
-\en(fp	R	footnote pointsize
-\en(fs	R	footnote prespace
-\en(fu	R	footnote undent (from right margin)
-\eh\'\fI\&d\fP\'	F\(sc	local horizontal motion for distance \fI\&d\fP
-\&.hc	M\(sc	set hyphenation character
-\&.he	M	set header
-\&.hl	M	draw horizontal line
-\en(hm	R	header margin
-\&.hx	M	suppress headers and footers on next page
-\&.hy	M\(sc	set hyphenation mode
-\&.i	M	italic font
-\&.ie	M\(sc	conditional with else
-\&.if	M\(sc	conditional
-\en(ii	R	indented paragraph indent
-\&.in	M\(sc	indent (transient, use .ba for pervasive)
-\&.ip	M	begin indented paragraph
-\&.ix	M	indent, no break
-\el\'\fI\&d\fP\'	F\(sc	horizontal line drawing function for distance \fI\&d\fP
-\&.lc	M\(sc	set leader repetition character
-\&.ll	M	set line length
-\&.lp	M	begin left justified paragraph
-\e*(lq	S	left quote marks
-\&.ls	M\(sc	set multi-line spacing
-\&.m1	M	set space from top of page to header
-\&.m2	M	set space from header to text
-\&.m3	M	set space from text to footer
-\&.m4	M	set space from footer to bottom of page
-\&.mc	M\(sc	insert margin character
-\&.mk	M\(sc	mark vertical position
-\en(mo	R\(sc	month of year
-\e*(mo	S	current month
-\en\fI\&x\fP	F\(sc	interpolate number register \fI\&x\fP
-\en(\fI\&xx\fP	F\(sc	interpolate number register \fI\&xx\fP
-\&.n1	M	number lines in margin
-\&.n2	M	number lines in margin
-\&.na	M\(sc	turn off text adjustment
-\&.ne	M\(sc	need vertical space
-\&.nf	M\(sc	don't fill output lines
-\&.nh	M\(sc	turn off hyphenation
-\&.np	M	begin numbered paragraph
-\&.nr	M\(sc	set number register
-\&.ns	M\(sc	no space mode
-\e*o	S	circle (e.g., for Norse A\*o)
-\&.of	M	set footer (odd numbered pages only)
-\&.oh	M	set header (odd numbered pages only)
-\&.pa	M	begin page
-\&.pd	M	print delayed text
-\en(pf	R	paragraph font
-\en(pi	R	paragraph indent
-\&.pl	M\(sc	set page length
-\&.pn	M\(sc	set next page number
-\&.po	M\(sc	page offset
-\en(po	R	simulated page offset
-\&.pp	M	begin paragraph
-\en(pp	R	paragraph pointsize
-\en(ps	R	paragraph prespace
-\&.q	M	quoted
-\e*(qa	S	for all
-\e*(qe	S	there exists
-\en(qi	R	quote indent (also shortens line)
-\en(qp	R	quote pointsize
-\en(qs	R	quote pre/post space
-\&.r	M	roman font
-\&.rb	M	real bold font
-\&.re	M	reset tabs
-\&.rm	M\(sc	remove macro or string
-\&.rn	M\(sc	rename macro or string
-\&.ro	M	set page numbers in roman
-\e*(rq	S	right quote marks
-\&.rr	M\(sc	remove register
-\&.rs	M\(sc	restore spacing
-\&.rt	M\(sc	return to vertical position
-\es\fI\&S\fP	F\(sc	inline size change to size \fI\&S\fP
-\en(sf	R	section title font
-\&.sh	M	begin numbered section
-\en(si	R	relative base indent per section depth
-\&.sk	M	skip next page
-\&.sm	M	set argument in a smaller pointsize
-\&.so	M\(sc	source input file
-\en(so	R	additional section title offset
-\&.sp	M\(sc	vertical space (except at top of page, in contrast to .bl)
-\en(sp	R	section title pointsize
-\en(ss	R	section prespace
-\&.sx	M	change section depth
-\&.sz	M	set pointsize and vertical spacing
-\&.ta	M\(sc	set tab stops
-\&.tc	M\(sc	set tab repetition character
-\e*(td	S	today's date
-\en(tf	R	title font
-\&.ti	M\(sc	temporary indent (next line only)
-\&.tl	M\(sc	three part title
-\en(tm	R	top title margin
-\&.tp	M	begin title page
-\en(tp	R	title pointsize
-\&.tr	M\(sc	translate
-\&.u	M	underlined
-\&.uh	M	unnumbered section
-\&.ul	M\(sc	underline next line
-\ev\'\fI\&d\fP\'	F\(sc	local vertical motion for distance \fI\&d\fP
-\e*v	S	inverted `v' for czeck ``e\*v''
-\ew\'\fI\&S\fP\'	F\(sc	return width of string \fI\&S\fP
-\&.xl	M	set line length (local)
-\&.xp	M	print index
-\en(xs	R	index entry prespace
-\en(xu	R	index undent (from right margin)
-\en(y2	R	year (last two digits only)
-\en(y4	R	year (all digits)
-\en(yr	R\(sc	year minus 1900
-\en(zs	R	floating keep pre/post space
-\e{	F\(sc	begin conditional group
-\e|	F\(sc	1/6 em narrow space
-\e}	F\(sc	end conditional group
-\e*~	S	tilde
-\en(_M	R	section type (as set with .++ macro)
-.)l
-.rm $H
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/generate/symbolsl.afm Deleted

@@ -1,210 +0,0 @@
-StartFontMetrics 2.0
-Comment Copyright (c) 1985, 1987, 1989, 1990, 1997 Adobe Systems Incorporated. All rights reserved.
-Comment Creation Date: Thu May  1 15:12:25 1997
-Comment UniqueID 43064
-Comment VMusage 30820 39997
-EncodingScheme FontSpecific
-FontName Symbol-Slanted
-Weight Medium
-Version 001.008
-ItalicAngle -15.5
-UnderlinePosition -100
-FamilyName Symbol
-IsFixedPitch false
-Notice Copyright (c) 1985, 1987, 1989, 1990, 1997 Adobe Systems Incorporated. All rights reserved.
-FullName Symbol Slanted
-UnderlineThickness 50
-FontBBox -241 -261 1250 899
-StartCharMetrics 190
-C 32 ; WX 223 ; N space ; B 223 0 223 0 ;
-C 33 ; WX 296 ; N exclam ; B 123 -15 383 598 ;
-C 34 ; WX 635 ; N universal ; B 223 0 802 627 ;
-C 35 ; WX 445 ; N numbersign ; B 71 -14 557 599 ;
-C 36 ; WX 489 ; N existential ; B 22 0 621 629 ;
-C 37 ; WX 741 ; N percent ; B 147 -32 766 583 ;
-C 38 ; WX 692 ; N ampersand ; B 68 -16 745 589 ;
-C 39 ; WX 391 ; N suchthat ; B 44 -15 450 445 ;
-C 40 ; WX 296 ; N parenleft ; B 89 -170 449 599 ;
-C 41 ; WX 296 ; N parenright ; B -22 -170 339 599 ;
-C 42 ; WX 445 ; N asteriskmath ; B 126 119 500 490 ;
-C 43 ; WX 489 ; N plus ; B 76 0 562 474 ;
-C 44 ; WX 223 ; N comma ; B 9 -136 183 93 ;
-C 45 ; WX 489 ; N minus ; B 74 207 556 256 ;
-C 46 ; WX 223 ; N period ; B 70 -15 174 85 ;
-C 47 ; WX 247 ; N slash ; B -5 -16 405 575 ;
-C 48 ; WX 445 ; N zero ; B 89 -12 542 610 ;
-C 49 ; WX 445 ; N one ; B 107 0 451 599 ;
-C 50 ; WX 445 ; N two ; B 22 0 524 610 ;
-C 51 ; WX 445 ; N three ; B 49 -12 511 610 ;
-C 52 ; WX 445 ; N four ; B 57 0 530 610 ;
-C 53 ; WX 445 ; N five ; B 40 -12 586 614 ;
-C 54 ; WX 445 ; N six ; B 89 -12 586 610 ;
-C 55 ; WX 445 ; N seven ; B 151 -14 585 599 ;
-C 56 ; WX 445 ; N eight ; B 84 -12 534 610 ;
-C 57 ; WX 445 ; N nine ; B 48 -16 536 610 ;
-C 58 ; WX 247 ; N colon ; B 81 -15 286 409 ;
-C 59 ; WX 247 ; N semicolon ; B 33 -136 296 409 ;
-C 60 ; WX 489 ; N less ; B 87 0 610 465 ;
-C 61 ; WX 489 ; N equal ; B 49 125 586 347 ;
-C 62 ; WX 489 ; N greater ; B 23 0 546 465 ;
-C 63 ; WX 395 ; N question ; B 164 -15 517 611 ;
-C 64 ; WX 489 ; N congruent ; B 10 0 597 423 ;
-C 65 ; WX 643 ; N Alpha ; B 4 0 614 599 ;
-C 66 ; WX 594 ; N Beta ; B 26 0 648 599 ;
-C 67 ; WX 643 ; N Chi ; B -8 0 798 599 ;
-C 68 ; WX 545 ; N Delta ; B 5 0 541 612 ;
-C 69 ; WX 544 ; N Epsilon ; B 28 0 688 599 ;
-C 70 ; WX 679 ; N Phi ; B 106 0 762 599 ;
-C 71 ; WX 537 ; N Gamma ; B 31 0 714 599 ;
-C 72 ; WX 643 ; N Eta ; B 35 0 835 599 ;
-C 73 ; WX 296 ; N Iota ; B 28 0 468 599 ;
-C 74 ; WX 562 ; N theta1 ; B 108 -16 645 614 ;
-C 75 ; WX 643 ; N Kappa ; B 31 0 778 599 ;
-C 76 ; WX 611 ; N Lambda ; B 5 0 610 612 ;
-C 77 ; WX 791 ; N Mu ; B 28 0 974 599 ;
-C 78 ; WX 643 ; N Nu ; B 26 -7 827 599 ;
-C 79 ; WX 643 ; N Omicron ; B 112 -15 747 610 ;
-C 80 ; WX 684 ; N Pi ; B 22 0 847 599 ;
-C 81 ; WX 659 ; N Theta ; B 112 -15 747 610 ;
-C 82 ; WX 495 ; N Rho ; B 25 0 645 599 ;
-C 83 ; WX 527 ; N Sigma ; B 4 0 663 599 ;
-C 84 ; WX 544 ; N Tau ; B 158 0 722 599 ;
-C 85 ; WX 614 ; N Upsilon ; B 175 0 804 599 ;
-C 86 ; WX 391 ; N sigma1 ; B 78 -208 492 445 ;
-C 87 ; WX 684 ; N Omega ; B 30 0 760 612 ;
-C 88 ; WX 574 ; N Xi ; B 36 0 700 599 ;
-C 89 ; WX 708 ; N Psi ; B 188 0 885 609 ;
-C 90 ; WX 544 ; N Zeta ; B 39 0 725 599 ;
-C 91 ; WX 296 ; N bracketleft ; B 34 -138 453 600 ;
-C 92 ; WX 768 ; N therefore ; B 161 0 644 433 ;
-C 93 ; WX 296 ; N bracketright ; B -14 -138 406 600 ;
-C 94 ; WX 586 ; N perpendicular ; B 13 0 596 600 ;
-C 95 ; WX 445 ; N underscore ; B -36 -111 426 -67 ;
-C 96 ; WX 445 ; N radicalex ; B 672 784 1224 816 ;
-C 97 ; WX 562 ; N alpha ; B 84 -16 657 445 ;
-C 98 ; WX 489 ; N beta ; B -8 -198 578 659 ;
-C 99 ; WX 489 ; N chi ; B -48 -206 573 445 ;
-C 100 ; WX 440 ; N delta ; B 82 -17 571 658 ;
-C 101 ; WX 391 ; N epsilon ; B 49 -17 468 447 ;
-C 102 ; WX 464 ; N phi ; B 78 -199 520 599 ;
-C 103 ; WX 366 ; N gamma ; B 92 -200 568 444 ;
-C 104 ; WX 537 ; N eta ; B 100 -180 555 457 ;
-C 105 ; WX 293 ; N iota ; B 97 -15 296 448 ;
-C 106 ; WX 537 ; N phi1 ; B 92 -199 604 444 ;
-C 107 ; WX 489 ; N kappa ; B 106 0 621 446 ;
-C 108 ; WX 489 ; N lambda ; B 21 -15 530 658 ;
-C 109 ; WX 513 ; N mu ; B -18 -198 533 445 ;
-C 110 ; WX 464 ; N nu ; B 119 -14 548 451 ;
-C 111 ; WX 489 ; N omicron ; B 86 -17 525 444 ;
-C 112 ; WX 489 ; N pi ; B 58 -17 600 433 ;
-C 113 ; WX 464 ; N theta ; B 103 -15 554 614 ;
-C 114 ; WX 489 ; N rho ; B -19 -205 521 444 ;
-C 115 ; WX 537 ; N sigma ; B 87 -19 662 445 ;
-C 116 ; WX 391 ; N tau ; B 95 -17 511 445 ;
-C 117 ; WX 513 ; N upsilon ; B 105 -16 558 451 ;
-C 118 ; WX 635 ; N omega1 ; B 78 -16 758 519 ;
-C 119 ; WX 611 ; N omega ; B 85 -15 687 445 ;
-C 120 ; WX 439 ; N xi ; B 70 -200 515 681 ;
-C 121 ; WX 611 ; N psi ; B 141 -203 759 445 ;
-C 122 ; WX 440 ; N zeta ; B 100 -200 580 673 ;
-C 123 ; WX 427 ; N braceleft ; B 116 -163 540 599 ;
-C 124 ; WX 178 ; N bar ; B -23 -261 316 629 ;
-C 125 ; WX 427 ; N braceright ; B 20 -163 444 599 ;
-C 126 ; WX 489 ; N similar ; B 78 181 549 273 ;
-C 160 ; WX 668 ; N Euro ; B 85 -11 797 610 ;
-C 161 ; WX 552 ; N Upsilon1 ; B 134 0 710 610 ;
-C 162 ; WX 220 ; N minute ; B 156 408 393 654 ;
-C 163 ; WX 489 ; N lessequal ; B 26 0 645 569 ;
-C 164 ; WX 149 ; N fraction ; B -164 -11 490 603 ;
-C 165 ; WX 635 ; N infinity ; B 91 111 692 360 ;
-C 166 ; WX 445 ; N florin ; B -36 -172 614 611 ;
-C 167 ; WX 670 ; N club ; B 119 -23 645 474 ;
-C 168 ; WX 670 ; N diamond ; B 198 -32 605 490 ;
-C 169 ; WX 670 ; N heart ; B 205 -29 679 473 ;
-C 170 ; WX 670 ; N spade ; B 132 -32 604 488 ;
-C 171 ; WX 927 ; N arrowboth ; B 90 -13 980 455 ;
-C 172 ; WX 878 ; N arrowleft ; B 97 -13 915 455 ;
-C 173 ; WX 537 ; N arrowup ; B 223 0 691 810 ;
-C 174 ; WX 878 ; N arrowright ; B 105 -13 922 455 ;
-C 175 ; WX 537 ; N arrowdown ; B 104 -20 572 790 ;
-C 176 ; WX 356 ; N degree ; B 186 343 466 610 ;
-C 177 ; WX 489 ; N plusminus ; B 9 0 593 574 ;
-C 178 ; WX 366 ; N second ; B 150 408 560 656 ;
-C 179 ; WX 489 ; N greaterequal ; B 26 0 582 569 ;
-C 180 ; WX 489 ; N multiply ; B 28 7 609 466 ;
-C 181 ; WX 635 ; N proportional ; B 90 110 667 360 ;
-C 182 ; WX 440 ; N partialdiff ; B 62 -18 542 664 ;
-C 183 ; WX 409 ; N bullet ; B 118 101 454 421 ;
-C 184 ; WX 489 ; N divide ; B 74 63 558 406 ;
-C 185 ; WX 489 ; N notequal ; B 51 -22 587 489 ;
-C 186 ; WX 489 ; N equivalence ; B 35 73 602 394 ;
-C 187 ; WX 489 ; N approxequal ; B 57 120 572 351 ;
-C 188 ; WX 890 ; N ellipsis ; B 107 -15 804 85 ;
-C 189 ; WX 537 ; N arrowvertex ; B 216 -107 579 899 ;
-C 190 ; WX 890 ; N arrowhorizex ; B 8 196 1011 246 ;
-C 191 ; WX 586 ; N carriagereturn ; B 40 -14 710 560 ;
-C 192 ; WX 732 ; N aleph ; B 159 -16 740 586 ;
-C 193 ; WX 611 ; N Ifraktur ; B 26 -47 684 659 ;
-C 194 ; WX 708 ; N Rfraktur ; B 71 -13 833 653 ;
-C 195 ; WX 878 ; N weierstrass ; B 112 -188 878 510 ;
-C 196 ; WX 684 ; N circlemultiply ; B 115 -15 758 599 ;
-C 197 ; WX 684 ; N circleplus ; B 115 -13 759 601 ;
-C 198 ; WX 732 ; N emptyset ; B 38 -21 884 640 ;
-C 199 ; WX 684 ; N intersection ; B 36 0 714 453 ;
-C 200 ; WX 684 ; N union ; B 110 -15 788 438 ;
-C 201 ; WX 635 ; N propersuperset ; B 18 0 675 418 ;
-C 202 ; WX 635 ; N reflexsuperset ; B -17 -111 674 418 ;
-C 203 ; WX 635 ; N notsubset ; B 87 -62 744 481 ;
-C 204 ; WX 635 ; N propersubset ; B 87 0 744 418 ;
-C 205 ; WX 635 ; N reflexsubset ; B 16 -111 744 418 ;
-C 206 ; WX 635 ; N element ; B 93 0 579 417 ;
-C 207 ; WX 635 ; N notelement ; B 75 -52 579 494 ;
-C 208 ; WX 684 ; N angle ; B 23 0 833 599 ;
-C 209 ; WX 635 ; N gradient ; B 231 -17 805 639 ;
-C 210 ; WX 703 ; N registerserif ; B 121 -15 764 599 ;
-C 211 ; WX 703 ; N copyrightserif ; B 122 -13 766 601 ;
-C 212 ; WX 792 ; N trademarkserif ; B 169 261 947 599 ;
-C 213 ; WX 732 ; N product ; B -6 -90 920 668 ;
-C 214 ; WX 489 ; N radical ; B 134 -34 711 816 ;
-C 215 ; WX 223 ; N dotmath ; B 132 187 224 276 ;
-C 216 ; WX 635 ; N logicalnot ; B 78 0 685 256 ;
-C 217 ; WX 537 ; N logicaland ; B 20 0 519 404 ;
-C 218 ; WX 537 ; N logicalor ; B 151 0 639 425 ;
-C 219 ; WX 927 ; N arrowdblboth ; B 92 -18 978 454 ;
-C 220 ; WX 878 ; N arrowdblleft ; B 96 -13 942 457 ;
-C 221 ; WX 537 ; N arrowdblup ; B 152 2 688 811 ;
-C 222 ; WX 878 ; N arrowdblright ; B 71 -18 917 452 ;
-C 223 ; WX 537 ; N arrowdbldown ; B 103 -17 639 792 ;
-C 224 ; WX 440 ; N lozenge ; B 121 0 519 663 ;
-C 225 ; WX 293 ; N angleleft ; B 98 -176 472 664 ;
-C 226 ; WX 703 ; N registersans ; B 120 -18 763 596 ;
-C 227 ; WX 703 ; N copyrightsans ; B 120 -13 764 601 ;
-C 228 ; WX 700 ; N trademarksans ; B 179 261 832 599 ;
-C 229 ; WX 635 ; N summation ; B -15 -96 756 669 ;
-C 230 ; WX 342 ; N parenlefttp ; B -60 -261 642 824 ;
-C 231 ; WX 342 ; N parenleftex ; B -2 -76 353 823 ;
-C 232 ; WX 342 ; N parenleftbt ; B 103 -261 353 824 ;
-C 233 ; WX 342 ; N bracketlefttp ; B -22 -71 567 824 ;
-C 234 ; WX 342 ; N bracketleftex ; B -22 -70 325 823 ;
-C 235 ; WX 342 ; N bracketleftbt ; B -22 -71 325 824 ;
-C 236 ; WX 440 ; N bracelefttp ; B 162 -76 653 823 ;
-C 237 ; WX 440 ; N braceleftmid ; B 132 -76 512 832 ;
-C 238 ; WX 440 ; N braceleftbt ; B 197 -67 512 832 ;
-C 239 ; WX 440 ; N braceex ; B 162 -76 512 832 ;
-C 241 ; WX 293 ; N angleright ; B -29 -176 345 664 ;
-C 242 ; WX 244 ; N integral ; B -13 -95 499 815 ;
-C 243 ; WX 611 ; N integraltp ; B 250 -78 838 819 ;
-C 244 ; WX 611 ; N integralex ; B 250 -78 607 868 ;
-C 245 ; WX 611 ; N integralbt ; B 3 -77 592 820 ;
-C 246 ; WX 342 ; N parenrighttp ; B 259 -261 509 824 ;
-C 247 ; WX 342 ; N parenrightex ; B 316 -76 671 823 ;
-C 248 ; WX 342 ; N parenrightbt ; B -30 -261 672 824 ;
-C 249 ; WX 342 ; N bracketrighttp ; B 239 -71 587 824 ;
-C 250 ; WX 342 ; N bracketrightex ; B 240 -70 587 823 ;
-C 251 ; WX 342 ; N bracketrightbt ; B -3 -71 587 824 ;
-C 252 ; WX 440 ; N bracerighttp ; B 162 -76 477 823 ;
-C 253 ; WX 440 ; N bracerightmid ; B 162 -76 543 832 ;
-C 254 ; WX 440 ; N bracerightbt ; B 22 -67 512 832 ;
-C -1 ; WX 703 ; N apple ; B 136 -2 784 719 ;
-EndCharMetrics
-EndFontMetrics

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/symbolmap Deleted

@@ -1,450 +0,0 @@
-#
-# This is a list of all predefined groff symbols.
-#
-#
-# Predefined groff symbols for textual fonts.
-#
-a14 rh
-a a
-A A
-aacute 'a
-Aacute 'A
-acircumflex ^a
-Acircumflex ^A
-acute aa
-adieresis :a
-Adieresis :A
-ae ae
-AE AE
-agrave `a
-Agrave `A
-aleph Ah
-alpha *a
-Alpha *A
-ampersand &
-angle /_
-angleleft la
-angleright ra
-approxequal ~~
-approxequal ~=
-aring oa
-Aring oA
-arrowboth <>
-arrowdblboth hA
-arrowdbldown dA
-arrowdblleft lA
-arrowdblright rA
-arrowdblup uA
-arrowdown da
-arrowhorizex an
-arrowleft <-
-arrowright ->
-arrowupdn va
-arrowup ua
-arrowvertex arrowvertex
-asciicircum ha
-asciitilde ti
-asterisk *
-asteriskmath **
-at @
-at at
-atilde ~a
-Atilde ~A
-backslash \
-backslash rs
-bar |
-bar ba
-b b
-B B
-beta *b
-Beta *B
-braceex barex
-braceex braceex
-braceex braceleftex
-braceex bracerightex
-braceex bv
-braceleft {
-braceleftbt braceleftbt
-braceleftbt lb
-braceleft lC
-braceleftmid braceleftmid
-braceleftmid lk
-bracelefttp bracelefttp
-bracelefttp lt
-braceright }
-bracerightbt bracerightbt
-bracerightbt rb
-bracerightmid bracerightmid
-bracerightmid rk
-braceright rC
-bracerighttp bracerighttp
-bracerighttp rt
-bracketleft 
-bracketleftbt bracketleftbt
-bracketleftbt lf
-bracketleftex bracketleftex
-bracketleft lB
-bracketlefttp bracketlefttp
-bracketlefttp lc
-bracketright 
-bracketrightbt bracketrightbt
-bracketrightbt rf
-bracketrightex bracketrightex
-bracketright rB
-bracketrighttp bracketrighttp
-bracketrighttp rc
-breve ab
-brokenbar bb
-bullet bu
-cacute 'c
-Cacute 'C
-caron ah
-carriagereturn CR
-c c
-C C
-ccedilla ,c
-Ccedilla ,C
-cedilla ac
-cent ct
-checkmark OK
-chi *x
-Chi *X
-circle ci
-circlemultiply c*
-circleplus c+
-circumflex ^
-circumflex a^
-club CL
-colon :
-comma ,
-congruent =~
-copyright co
-currency Cs
-daggerdbl dd
-dagger dg
-d d
-D D
-degree de
-delta *d
-Delta *D
-diamond DI
-dieresis ad
-divide tdi
-dollar $
-dollar Do
-dotaccent a.
-dotlessi .i
-dotlessj .j
-dotmath md
-eacute 'e
-Eacute 'E
-ecircumflex ^e
-Ecircumflex ^E
-edieresis :e
-Edieresis :E
-e e
-E E
-egrave `e
-Egrave `E
-eight 8
-element mo
-emdash em
-emptyset es
-endash en
-epsilon *e
-Epsilon *E
-equal =
-equivalence ==
-eta *y
-Eta *Y
-Eth -D
-eth Sd
-Euro Eu
-exclam !
-exclamdown r!
-existential te
-f f
-F F
-ff ff
-ffi Fi
-ffl Fl
-fi fi
-five 5
-fiveeighths 58
-fl fl
-florin Fn
-four 4
-fraction f/
-gamma *g
-Gamma *G
-germandbls ss
-g g
-G G
-gradient gr
-grave ga
-greater >
-greaterequal >=
-guillemotleft Fo
-guillemotright Fc
-guilsinglleft fo
-guilsinglright fc
-heart HE
-h h
-H H
-hungarumlaut a"
-hyphen -
-hyphen hy
-iacute 'i
-Iacute 'I
-icircumflex ^i
-Icircumflex ^I
-idieresis :i
-Idieresis :I
-Ifraktur Im
-igrave `i
-Igrave `I
-i i
-I I
-ij ij
-IJ IJ
-infinity if
-# the next line overrides the (old) PUA value of the AGL
-integralex u23AE
-integral integral
-integral is
-intersection ca
-iota *i
-Iota *I
-j j
-J J
-kappa *k
-Kappa *K
-k k
-K K
-lambda *l
-Lambda *L
-less <
-lessequal <=
-l l
-L L
-logicaland AN
-logicalnot tno
-logicalor OR
-lozenge lz
-lslash /l
-Lslash /L
-macron a-
-minus \-
-minute fm
-m m
-M M
-mu1 mc
-multiply tmu
-mu *m
-Mu *M
-# if there is "mu1" glyph in the font - comment out the following line
-mu mc
-nine 9
-n n
-N N
-notelement nm
-notequal !=
-notsubset nb
-ntilde ~n
-Ntilde ~N
-numbersign #
-numbersign sh
-nu *n
-Nu *N
-oacute 'o
-Oacute 'O
-ocircumflex ^o
-Ocircumflex ^O
-odieresis :o
-Odieresis :O
-oe oe
-OE OE
-ogonek ho
-ograve `o
-Ograve `O
-omega1 +p
-omega *w
-Omega *W
-omicron *o
-Omicron *O
-one 1
-oneeighth 18
-onehalf 12
-onequarter 14
-onesuperior S1
-o o
-O O
-ordfeminine Of
-ordmasculine Om
-oslash /o
-Oslash /O
-otilde ~o
-Otilde ~O
-overline rn
-paragraph ps
-parenleft (
-parenleftbt parenleftbt
-parenleftex parenleftex
-parenlefttp parenlefttp
-parenright )
-parenrightbt parenrightbt
-parenrightex parenrightex
-parenrighttp parenrighttp
-partialdiff pd
-percent %
-period .
-periodcentered pc
-perpendicular pp
-perthousand %0
-phi1 +f
-phi *f
-Phi *F
-pi *p
-Pi *P
-plus +
-plusminus t+-
-p p
-P P
-product product
-propersubset sb
-propersuperset sp
-proportional pt
-psi *q
-Psi *Q
-q q
-Q Q
-question ?
-questiondown r?
-quotedbl "
-quotedblbase Bq
-quotedbl dq
-quotedblleft lq
-quotedblright rq
-quoteleft `
-quoteleft oq
-quoteright '
-quoteright cq
-quotesinglbase bq
-quotesingle aq
-radicalex radicalex
-radical sqrt
-radical sr
-reflexsubset ib
-reflexsuperset ip
-registered rg
-Rfraktur Re
-rho *r
-Rho *R
-ring ao
-r r
-R R
-scaron vs
-Scaron vS
-second sd
-section sc
-semicolon ;
-seven 7
-seveneighths 78
-SF110000 br
-sigma1 ts
-sigma *s
-Sigma *S
-similar ap
-six 6
-slash /
-slash sl
-spade SP
-s s
-S S
-sterling Po
-suchthat st
-summation sum
-tau *t
-Tau *T
-therefore 3d
-therefore tf
-theta1 +h
-theta *h
-Theta *H
-thorn Tp
-Thorn TP
-three 3
-threeeighths 38
-threequarters 34
-threesuperior S3
-tilde ~
-tilde a~
-trademark tm
-t t
-T T
-two 2
-twosuperior S2
-uacute 'u
-Uacute 'U
-ucircumflex ^u
-Ucircumflex ^U
-udieresis :u
-Udieresis :U
-ugrave `u
-Ugrave `U
-underscore _
-uni03F5 +e
-uni210F -h
-uni210F hbar
-uni21D5 vA
-uni2210 coproduct
-uni2213 -+
-uni2243 |=
-uni2262 ne
-uni226A >>
-uni226B <<
-uni2285 nc
-uni25A1 sq
-uni261C lh
-union cu
-universal fa
-upsilon *u
-Upsilon *U
-u u
-U U
-v v
-V V
-weierstrass wp
-w w
-W W
-xi *c
-Xi *C
-x x
-X X
-yacute 'y
-Yacute 'Y
-ydieresis :y
-Ydieresis :Y
-yen Ye
-y y
-Y Y
-zcaron vz
-Zcaron vZ
-zero 0
-zeta *z
-Zeta *Z
-z z
-Z Z
-#
-# Additional predefined groff symbols for special fonts.
-#
-arrowdown arrowvertbt
-arrowup arrowverttp
-divide di
-equal eq
-logicalnot no
-minus mi
-multiply mu
-plusminus +-
-plus pl
-Upsilon1 *U

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/asm-underscore.m4 Deleted

@@ -1,72 +0,0 @@
-# asm-underscore.m4 serial 4
-dnl Copyright (C) 2010-2018 Free Software Foundation, Inc.
-dnl This file is free software; the Free Software Foundation
-dnl gives unlimited permission to copy and/or distribute it,
-dnl with or without modifications, as long as this notice is preserved.
-
-dnl From Bruno Haible. Based on as-underscore.m4 in GNU clisp.
-
-# gl_ASM_SYMBOL_PREFIX
-# Tests for the prefix of C symbols at the assembly language level and the
-# linker level. This prefix is either an underscore or empty. Defines the
-# C macro USER_LABEL_PREFIX to this prefix, and sets ASM_SYMBOL_PREFIX to
-# a stringified variant of this prefix.
-
-AC_DEFUN(gl_ASM_SYMBOL_PREFIX,
-
-  AC_REQUIRE(AC_PROG_EGREP)
-  dnl We don't use GCC's __USER_LABEL_PREFIX__ here, because
-  dnl 1. It works only for GCC.
-  dnl 2. It is incorrectly defined on some platforms, in some GCC versions.
-  AC_REQUIRE(gl_C_ASM)
-  AC_CACHE_CHECK(
-    whether C symbols are prefixed with underscore at the linker level,
-    gl_cv_prog_as_underscore,
-    cat > conftest.c <<EOF
-#ifdef __cplusplus
-extern "C" int foo (void);
-#endif
-int foo(void) { return 0; }
-EOF
-     # Look for the assembly language name in the .s file.
-     AC_TRY_COMMAND(${CC-cc} $CFLAGS $CPPFLAGS $gl_c_asm_opt conftest.c) >/dev/null 2>&1
-     if LC_ALL=C $EGREP '(^|^a-zA-Z0-9_)_foo(^a-zA-Z0-9_|$)' conftest.$gl_asmext >/dev/null; then
-       gl_cv_prog_as_underscore=yes
-     else
-       gl_cv_prog_as_underscore=no
-     fi
-     rm -f conftest*
-    )
-  if test $gl_cv_prog_as_underscore = yes; then
-    USER_LABEL_PREFIX=_
-  else
-    USER_LABEL_PREFIX=
-  fi
-  AC_DEFINE_UNQUOTED(USER_LABEL_PREFIX, $USER_LABEL_PREFIX,
-    Define to the prefix of C symbols at the assembler and linker level,
-     either an underscore or empty.)
-  ASM_SYMBOL_PREFIX='"'${USER_LABEL_PREFIX}'"'
-  AC_SUBST(ASM_SYMBOL_PREFIX)
-)
-
-# gl_C_ASM
-# Determines how to produce an assembly language file from C source code.
-# Sets the variables:
-#   gl_asmext - the extension of assembly language output,
-#   gl_c_asm_opt - the C compiler option that produces assembly language output.
-
-AC_DEFUN(gl_C_ASM,
-
-  AC_EGREP_CPP(MicrosoftCompiler,
-    
-#ifdef _MSC_VER
-MicrosoftCompiler
-#endif
-    ,
-    gl_asmext='asm'
-     gl_c_asm_opt='-c -Fa'
-    ,
-    gl_asmext='s'
-     gl_c_asm_opt='-S'
-    )
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/host-cpu-c-abi.m4 Deleted

@@ -1,456 +0,0 @@
-# host-cpu-c-abi.m4 serial 10
-dnl Copyright (C) 2002-2018 Free Software Foundation, Inc.
-dnl This file is free software; the Free Software Foundation
-dnl gives unlimited permission to copy and/or distribute it,
-dnl with or without modifications, as long as this notice is preserved.
-
-dnl From Bruno Haible and Sam Steingold.
-
-dnl Sets the HOST_CPU variable to the canonical name of the CPU.
-dnl Sets the HOST_CPU_C_ABI variable to the canonical name of the CPU with its
-dnl C language ABI (application binary interface).
-dnl Also defines __${HOST_CPU}__ and __${HOST_CPU_C_ABI}__ as C macros in
-dnl config.h.
-dnl
-dnl This canonical name can be used to select a particular assembly language
-dnl source file that will interoperate with C code on the given host.
-dnl
-dnl For example:
-dnl * 'i386' and 'sparc' are different canonical names, because code for i386
-dnl   will not run on SPARC CPUs and vice versa. They have different
-dnl   instruction sets.
-dnl * 'sparc' and 'sparc64' are different canonical names, because code for
-dnl   'sparc' and code for 'sparc64' cannot be linked together: 'sparc' code
-dnl   contains 32-bit instructions, whereas 'sparc64' code contains 64-bit
-dnl   instructions. A process on a SPARC CPU can be in 32-bit mode or in 64-bit
-dnl   mode, but not both.
-dnl * 'mips' and 'mipsn32' are different canonical names, because they use
-dnl   different argument passing and return conventions for C functions, and
-dnl   although the instruction set of 'mips' is a large subset of the
-dnl   instruction set of 'mipsn32'.
-dnl * 'mipsn32' and 'mips64' are different canonical names, because they use
-dnl   different sizes for the C types like 'int' and 'void *', and although
-dnl   the instruction sets of 'mipsn32' and 'mips64' are the same.
-dnl * The same canonical name is used for different endiannesses. You can
-dnl   determine the endianness through preprocessor symbols:
-dnl   - 'arm': test __ARMEL__.
-dnl   - 'mips', 'mipsn32', 'mips64': test _MIPSEB vs. _MIPSEL.
-dnl   - 'powerpc64': test _BIG_ENDIAN vs. _LITTLE_ENDIAN.
-dnl * The same name 'i386' is used for CPUs of type i386, i486, i586
-dnl   (Pentium), AMD K7, Pentium II, Pentium IV, etc., because
-dnl   - Instructions that do not exist on all of these CPUs (cmpxchg,
-dnl     MMX, SSE, SSE2, 3DNow! etc.) are not frequently used. If your
-dnl     assembly language source files use such instructions, you will
-dnl     need to make the distinction.
-dnl   - Speed of execution of the common instruction set is reasonable across
-dnl     the entire family of CPUs. If you have assembly language source files
-dnl     that are optimized for particular CPU types (like GNU gmp has), you
-dnl     will need to make the distinction.
-dnl   See <https://en.wikipedia.org/wiki/X86_instruction_listings>.
-AC_DEFUN(gl_HOST_CPU_C_ABI,
-
-  AC_REQUIRE(AC_CANONICAL_HOST)
-  AC_REQUIRE(gl_C_ASM)
-  AC_CACHE_CHECK(host CPU and C ABI, gl_cv_host_cpu_c_abi,
-    case "$host_cpu" in
-
-changequote(,)dnl
-       i456786 )
-changequote(,)dnl
-         gl_cv_host_cpu_c_abi=i386
-         ;;
-
-       x86_64 )
-         # On x86_64 systems, the C compiler may be generating code in one of
-         # these ABIs:
-         # - 64-bit instruction set, 64-bit pointers, 64-bit 'long': x86_64.
-         # - 64-bit instruction set, 64-bit pointers, 32-bit 'long': x86_64
-         #   with native Windows (mingw, MSVC).
-         # - 64-bit instruction set, 32-bit pointers, 32-bit 'long': x86_64-x32.
-         # - 32-bit instruction set, 32-bit pointers, 32-bit 'long': i386.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if (defined __x86_64__ || defined __amd64__ \
-                     || defined _M_X64 || defined _M_AMD64)
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           AC_COMPILE_IFELSE(
-              AC_LANG_SOURCE(
-                 #if defined __ILP32__ || defined _ILP32
-                    int ok;
-                   #else
-                    error fail
-                   #endif
-                 ),
-              gl_cv_host_cpu_c_abi=x86_64-x32,
-              gl_cv_host_cpu_c_abi=x86_64),
-           gl_cv_host_cpu_c_abi=i386)
-         ;;
-
-changequote(,)dnl
-       alphaev4-8 | alphaev56 | alphapca567 | alphaev678 )
-changequote(,)dnl
-         gl_cv_host_cpu_c_abi=alpha
-         ;;
-
-       arm* | aarch64 )
-         # Assume arm with EABI.
-         # On arm64 systems, the C compiler may be generating code in one of
-         # these ABIs:
-         # - aarch64 instruction set, 64-bit pointers, 64-bit 'long': arm64.
-         # - aarch64 instruction set, 32-bit pointers, 32-bit 'long': arm64-ilp32.
-         # - 32-bit instruction set, 32-bit pointers, 32-bit 'long': arm or armhf.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #ifdef __aarch64__
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           AC_COMPILE_IFELSE(
-              AC_LANG_SOURCE(
-                #if defined __ILP32__ || defined _ILP32
-                   int ok;
-                  #else
-                   error fail
-                  #endif
-                ),
-              gl_cv_host_cpu_c_abi=arm64-ilp32,
-              gl_cv_host_cpu_c_abi=arm64),
-           # Don't distinguish little-endian and big-endian arm, since they
-            # don't require different machine code for simple operations and
-            # since the user can distinguish them through the preprocessor
-            # defines __ARMEL__ vs. __ARMEB__.
-            # But distinguish arm which passes floating-point arguments and
-            # return values in integer registers (r0, r1, ...) - this is
-            # gcc -mfloat-abi=soft or gcc -mfloat-abi=softfp - from arm which
-            # passes them in float registers (s0, s1, ...) and double registers
-            # (d0, d1, ...) - this is gcc -mfloat-abi=hard. GCC 4.6 or newer
-            # sets the preprocessor defines __ARM_PCS (for the first case) and
-            # __ARM_PCS_VFP (for the second case), but older GCC does not.
-            echo 'double ddd; void func (double dd) { ddd = dd; }' > conftest.c
-            # Look for a reference to the register d0 in the .s file.
-            AC_TRY_COMMAND(${CC-cc} $CFLAGS $CPPFLAGS $gl_c_asm_opt conftest.c) >/dev/null 2>&1
-            if LC_ALL=C grep 'd0,' conftest.$gl_asmext >/dev/null; then
-              gl_cv_host_cpu_c_abi=armhf
-            else
-              gl_cv_host_cpu_c_abi=arm
-            fi
-            rm -f conftest*
-           )
-         ;;
-
-       hppa1.0 | hppa1.1 | hppa2.0* | hppa64 )
-         # On hppa, the C compiler may be generating 32-bit code or 64-bit
-         # code. In the latter case, it defines _LP64 and __LP64__.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #ifdef __LP64__
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           gl_cv_host_cpu_c_abi=hppa64,
-           gl_cv_host_cpu_c_abi=hppa)
-         ;;
-
-       ia64* )
-         # On ia64 on HP-UX, the C compiler may be generating 64-bit code or
-         # 32-bit code. In the latter case, it defines _ILP32.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #ifdef _ILP32
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           gl_cv_host_cpu_c_abi=ia64-ilp32,
-           gl_cv_host_cpu_c_abi=ia64)
-         ;;
-
-       mips* )
-         # We should also check for (_MIPS_SZPTR == 64), but gcc keeps this
-         # at 32.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined _MIPS_SZLONG && (_MIPS_SZLONG == 64)
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           gl_cv_host_cpu_c_abi=mips64,
-           # In the n32 ABI, _ABIN32 is defined, _ABIO32 is not defined (but
-            # may later get defined by <sgidefs.h>), and _MIPS_SIM == _ABIN32.
-            # In the 32 ABI, _ABIO32 is defined, _ABIN32 is not defined (but
-            # may later get defined by <sgidefs.h>), and _MIPS_SIM == _ABIO32.
-            AC_COMPILE_IFELSE(
-              AC_LANG_SOURCE(
-                 #if (_MIPS_SIM == _ABIN32)
-                    int ok;
-                   #else
-                    error fail
-                   #endif
-                 ),
-              gl_cv_host_cpu_c_abi=mipsn32,
-              gl_cv_host_cpu_c_abi=mips))
-         ;;
-
-       powerpc* )
-         # Different ABIs are in use on AIX vs. Mac OS X vs. Linux,*BSD.
-         # No need to distinguish them here; the caller may distinguish
-         # them based on the OS.
-         # On powerpc64 systems, the C compiler may still be generating
-         # 32-bit code. And on powerpc-ibm-aix systems, the C compiler may
-         # be generating 64-bit code.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined __powerpc64__ || defined _ARCH_PPC64
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           # On powerpc64, there are two ABIs on Linux: The AIX compatible
-            # one and the ELFv2 one. The latter defines _CALL_ELF=2.
-            AC_COMPILE_IFELSE(
-              AC_LANG_SOURCE(
-                 #if defined _CALL_ELF && _CALL_ELF == 2
-                    int ok;
-                   #else
-                    error fail
-                   #endif
-                 ),
-              gl_cv_host_cpu_c_abi=powerpc64-elfv2,
-              gl_cv_host_cpu_c_abi=powerpc64)
-           ,
-           gl_cv_host_cpu_c_abi=powerpc)
-         ;;
-
-       rs6000 )
-         gl_cv_host_cpu_c_abi=powerpc
-         ;;
-
-       riscv32 | riscv64 )
-         # There are 2 architectures (with variants): rv32* and rv64*.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if __riscv_xlen == 64
-                  int ok;
-                #else
-                  error fail
-                #endif
-              ),
-           cpu=riscv64,
-           cpu=riscv32)
-         # There are 6 ABIs: ilp32, ilp32f, ilp32d, lp64, lp64f, lp64d.
-         # Size of 'long' and 'void *':
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined __LP64__
-                  int ok;
-                #else
-                  error fail
-                #endif
-              ),
-           main_abi=lp64,
-           main_abi=ilp32)
-         # Float ABIs:
-         # __riscv_float_abi_double:
-         #   'float' and 'double' are passed in floating-point registers.
-         # __riscv_float_abi_single:
-         #   'float' are passed in floating-point registers.
-         # __riscv_float_abi_soft:
-         #   No values are passed in floating-point registers.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined __riscv_float_abi_double
-                  int ok;
-                #else
-                  error fail
-                #endif
-              ),
-           float_abi=d,
-           AC_COMPILE_IFELSE(
-              AC_LANG_SOURCE(
-                 #if defined __riscv_float_abi_single
-                     int ok;
-                   #else
-                     error fail
-                   #endif
-                 ),
-              float_abi=f,
-              float_abi='')
-           )
-         gl_cv_host_cpu_c_abi="${cpu}-${main_abi}${float_abi}"
-         ;;
-
-       s390* )
-         # On s390x, the C compiler may be generating 64-bit (= s390x) code
-         # or 31-bit (= s390) code.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined __LP64__ || defined __s390x__
-                  int ok;
-                #else
-                  error fail
-                #endif
-              ),
-           gl_cv_host_cpu_c_abi=s390x,
-           gl_cv_host_cpu_c_abi=s390)
-         ;;
-
-       sparc | sparc64 )
-         # UltraSPARCs running Linux have `uname -m` = "sparc64", but the
-         # C compiler still generates 32-bit code.
-         AC_COMPILE_IFELSE(
-           AC_LANG_SOURCE(
-              #if defined __sparcv9 || defined __arch64__
-                 int ok;
-                #else
-                 error fail
-                #endif
-              ),
-           gl_cv_host_cpu_c_abi=sparc64,
-           gl_cv_host_cpu_c_abi=sparc)
-         ;;
-
-       *)
-         gl_cv_host_cpu_c_abi="$host_cpu"
-         ;;
-     esac
-    )
-
-  dnl In most cases, $HOST_CPU and $HOST_CPU_C_ABI are the same.
-  HOST_CPU=`echo "$gl_cv_host_cpu_c_abi" | sed -e 's/-.*//'`
-  HOST_CPU_C_ABI="$gl_cv_host_cpu_c_abi"
-  AC_SUBST(HOST_CPU)
-  AC_SUBST(HOST_CPU_C_ABI)
-
-  # This was
-  #   AC_DEFINE_UNQUOTED(__${HOST_CPU}__)
-  #   AC_DEFINE_UNQUOTED(__${HOST_CPU_C_ABI}__)
-  # earlier, but KAI C++ 3.2d doesn't like this.
-  sed -e 's/-/_/g' >> confdefs.h <<EOF
-#ifndef __${HOST_CPU}__
-#define __${HOST_CPU}__ 1
-#endif
-#ifndef __${HOST_CPU_C_ABI}__
-#define __${HOST_CPU_C_ABI}__ 1
-#endif
-EOF
-  AH_TOP(/* CPU and C ABI indicator */
-#ifndef __i386__
-#undef __i386__
-#endif
-#ifndef __x86_64_x32__
-#undef __x86_64_x32__
-#endif
-#ifndef __x86_64__
-#undef __x86_64__
-#endif
-#ifndef __alpha__
-#undef __alpha__
-#endif
-#ifndef __arm__
-#undef __arm__
-#endif
-#ifndef __armhf__
-#undef __armhf__
-#endif
-#ifndef __arm64_ilp32__
-#undef __arm64_ilp32__
-#endif
-#ifndef __arm64__
-#undef __arm64__
-#endif
-#ifndef __hppa__
-#undef __hppa__
-#endif
-#ifndef __hppa64__
-#undef __hppa64__
-#endif
-#ifndef __ia64_ilp32__
-#undef __ia64_ilp32__
-#endif
-#ifndef __ia64__
-#undef __ia64__
-#endif
-#ifndef __m68k__
-#undef __m68k__
-#endif
-#ifndef __mips__
-#undef __mips__
-#endif
-#ifndef __mipsn32__
-#undef __mipsn32__
-#endif
-#ifndef __mips64__
-#undef __mips64__
-#endif
-#ifndef __powerpc__
-#undef __powerpc__
-#endif
-#ifndef __powerpc64__
-#undef __powerpc64__
-#endif
-#ifndef __powerpc64_elfv2__
-#undef __powerpc64_elfv2__
-#endif
-#ifndef __riscv32__
-#undef __riscv32__
-#endif
-#ifndef __riscv64__
-#undef __riscv64__
-#endif
-#ifndef __riscv32_ilp32__
-#undef __riscv32_ilp32__
-#endif
-#ifndef __riscv32_ilp32f__
-#undef __riscv32_ilp32f__
-#endif
-#ifndef __riscv32_ilp32d__
-#undef __riscv32_ilp32d__
-#endif
-#ifndef __riscv64_ilp32__
-#undef __riscv64_ilp32__
-#endif
-#ifndef __riscv64_ilp32f__
-#undef __riscv64_ilp32f__
-#endif
-#ifndef __riscv64_ilp32d__
-#undef __riscv64_ilp32d__
-#endif
-#ifndef __riscv64_lp64__
-#undef __riscv64_lp64__
-#endif
-#ifndef __riscv64_lp64f__
-#undef __riscv64_lp64f__
-#endif
-#ifndef __riscv64_lp64d__
-#undef __riscv64_lp64d__
-#endif
-#ifndef __s390__
-#undef __s390__
-#endif
-#ifndef __s390x__
-#undef __s390x__
-#endif
-#ifndef __sh__
-#undef __sh__
-#endif
-#ifndef __sparc__
-#undef __sparc__
-#endif
-#ifndef __sparc64__
-#undef __sparc64__
-#endif
-)
-
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/longlong.m4 Deleted

@@ -1,113 +0,0 @@
-# longlong.m4 serial 17
-dnl Copyright (C) 1999-2007, 2009-2018 Free Software Foundation, Inc.
-dnl This file is free software; the Free Software Foundation
-dnl gives unlimited permission to copy and/or distribute it,
-dnl with or without modifications, as long as this notice is preserved.
-
-dnl From Paul Eggert.
-
-# Define HAVE_LONG_LONG_INT if 'long long int' works.
-# This fixes a bug in Autoconf 2.61, and can be faster
-# than what's in Autoconf 2.62 through 2.68.
-
-# Note: If the type 'long long int' exists but is only 32 bits large
-# (as on some very old compilers), HAVE_LONG_LONG_INT will not be
-# defined. In this case you can treat 'long long int' like 'long int'.
-
-AC_DEFUN(AC_TYPE_LONG_LONG_INT,
-
-  AC_REQUIRE(AC_TYPE_UNSIGNED_LONG_LONG_INT)
-  AC_CACHE_CHECK(for long long int, ac_cv_type_long_long_int,
-     ac_cv_type_long_long_int=yes
-      if test "x${ac_cv_prog_cc_c99-no}" = xno; then
-        ac_cv_type_long_long_int=$ac_cv_type_unsigned_long_long_int
-        if test $ac_cv_type_long_long_int = yes; then
-          dnl Catch a bug in Tandem NonStop Kernel (OSS) cc -O circa 2004.
-          dnl If cross compiling, assume the bug is not important, since
-          dnl nobody cross compiles for this platform as far as we know.
-          AC_RUN_IFELSE(
-            AC_LANG_PROGRAM(
-               @%:@include <limits.h>
-                 @%:@ifndef LLONG_MAX
-                 @%:@ define HALF \
-                          (1LL << (sizeof (long long int) * CHAR_BIT - 2))
-                 @%:@ define LLONG_MAX (HALF - 1 + HALF)
-                 @%:@endif,
-               long long int n = 1;
-                 int i;
-                 for (i = 0; ; i++)
-                   {
-                     long long int m = n << i;
-                     if (m >> i != n)
-                       return 1;
-                     if (LLONG_MAX / 2 < m)
-                       break;
-                   }
-                 return 0;),
-            ,
-            ac_cv_type_long_long_int=no,
-            :)
-        fi
-      fi)
-  if test $ac_cv_type_long_long_int = yes; then
-    AC_DEFINE(HAVE_LONG_LONG_INT, 1,
-      Define to 1 if the system has the type 'long long int'.)
-  fi
-)
-
-# Define HAVE_UNSIGNED_LONG_LONG_INT if 'unsigned long long int' works.
-# This fixes a bug in Autoconf 2.61, and can be faster
-# than what's in Autoconf 2.62 through 2.68.
-
-# Note: If the type 'unsigned long long int' exists but is only 32 bits
-# large (as on some very old compilers), AC_TYPE_UNSIGNED_LONG_LONG_INT
-# will not be defined. In this case you can treat 'unsigned long long int'
-# like 'unsigned long int'.
-
-AC_DEFUN(AC_TYPE_UNSIGNED_LONG_LONG_INT,
-
-  AC_CACHE_CHECK(for unsigned long long int,
-    ac_cv_type_unsigned_long_long_int,
-    ac_cv_type_unsigned_long_long_int=yes
-     if test "x${ac_cv_prog_cc_c99-no}" = xno; then
-       AC_LINK_IFELSE(
-         _AC_TYPE_LONG_LONG_SNIPPET,
-         ,
-         ac_cv_type_unsigned_long_long_int=no)
-     fi)
-  if test $ac_cv_type_unsigned_long_long_int = yes; then
-    AC_DEFINE(HAVE_UNSIGNED_LONG_LONG_INT, 1,
-      Define to 1 if the system has the type 'unsigned long long int'.)
-  fi
-)
-
-# Expands to a C program that can be used to test for simultaneous support
-# of 'long long' and 'unsigned long long'. We don't want to say that
-# 'long long' is available if 'unsigned long long' is not, or vice versa,
-# because too many programs rely on the symmetry between signed and unsigned
-# integer types (excluding 'bool').
-AC_DEFUN(_AC_TYPE_LONG_LONG_SNIPPET,
-
-  AC_LANG_PROGRAM(
-    /* For now, do not test the preprocessor; as of 2007 there are too many
-         implementations with broken preprocessors.  Perhaps this can
-         be revisited in 2012.  In the meantime, code should not expect
-         #if to work with literals wider than 32 bits.  */
-      /* Test literals.  */
-      long long int ll = 9223372036854775807ll;
-      long long int nll = -9223372036854775807LL;
-      unsigned long long int ull = 18446744073709551615ULL;
-      /* Test constant expressions.   */
-      typedef int a((-9223372036854775807LL < 0 && 0 < 9223372036854775807ll)
-                     ? 1 : -1);
-      typedef int b(18446744073709551615ULL <= (unsigned long long int) -1
-                     ? 1 : -1);
-      int i = 63;,
-    /* Test availability of runtime routines for shift and division.  */
-      long long int llmax = 9223372036854775807ll;
-      unsigned long long int ullmax = 18446744073709551615ull;
-      return ((ll << 63) | (ll >> 63) | (ll < i) | (ll > i)
-              | (llmax / ll) | (llmax % ll)
-              | (ull << 63) | (ull >> 63) | (ull << i) | (ull >> i)
-              | (ullmax / ull) | (ullmax % ull));)
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/non-recursive-gnulib-prefix-hack.m4 Deleted

@@ -1,32 +0,0 @@
-dnl Copyright (C) 2012-2018 Free Software Foundation, Inc.
-dnl This file is free software; the Free Software Foundation
-dnl gives unlimited permission to copy and/or distribute it,
-dnl with or without modifications, as long as this notice is preserved.
-
-dnl gl_NON_RECURSIVE_GNULIB_PREFIX_HACK LIB_DIR
-dnl Adjust configure-set $gl_LIBOBJS and each AC_SUBST'd *_H variable
-dnl with a value ending in ".h" to reflect that these files are located
-dnl in the directory specified by LIB_DIR.
-AC_DEFUN(gl_NON_RECURSIVE_GNULIB_PREFIX_HACK,
-
-  # Tell AC_LIBSOURCES where to find source files like alloca.c.
-  AC_CONFIG_LIBOBJ_DIR($1)
-
-  # This hack originated in bison.  It is required when using non-recursive
-  # automake rules to build from gnulib-provided lib/ sources.  Hence, LIB_DIR
-  # is usually simply "lib".  Those rules use the list of names like "fchdir.o"
-  # and "strstr.o" in gl_LIBOBJS.  With non-recursive make, we must prefix each
-  # such file name with the "lib/" prefix.  See also build-aux/prefix-gnulib-mk.
-  gl_LIBOBJS=`echo "$gl_LIBOBJS" | sed -e 's, , $1/,g'`
-
-  # Listing the names of the variables to prefix is error-prone.
-  # Rather, adjust each AC_SUBST'd variable whose name ends in '_H'
-  # and whose value ends in '.h'.
-  for ac_var in $ac_subst_vars
-  do
-    eval "ac_val=\$$ac_var"
-    case $ac_var:$ac_val in
-      *_H:*.h) eval "$ac_var=$1/\$$ac_var";;
-    esac
-  done
-)

_service:tar_scm:groff-1.22.4.tar.gz/man/ditroff.7.man Deleted

@@ -1,173 +0,0 @@
-.TH DITROFF @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-ditroff \- classical device-independent roff
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2001-2018 Free Software Foundation, Inc.
-.\"
-.\" This file is part of groff, the GNU roff type-setting system.
-.\"
-.\" Permission is granted to copy, distribute and/or modify this
-.\" document under the terms of the GNU Free Documentation License,
-.\" Version 1.3 or any later version published by the Free Software
-.\" Foundation; with no Invariant Sections, with no Front-Cover Texts,
-.\" and with no Back-Cover Texts.
-.\"
-.\" A copy of the Free Documentation License is included as a file
-.\" called FDL in the main directory of the groff source package.
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-The name
-.I ditroff
-refers to a historical development stage of the
-.IR roff (@MAN7EXT@)
-text processing system.
-.
-In
-.I roff
-systems extant today, the name
-.I troff
-is a synonym for
-.IR ditroff .
-.
-.
-.P
-Early versions of
-.I roff
-by Joe Ossanna generated two programs from the same sources,
-using conditional compilation to distinguish them.
-.
-.I nroff
-produced text-oriented TTY output, while
-.I troff
-generated graphical output for exactly one output device, the
-Wang Graphic Systems CAT phototypesetter.
-.
-.
-.P
-In 1979, Brian Kernighan rewrote
-.I troff
-to support more devices by creating an intermediate output format for
-.I troff
-that could be fed into postprocessor programs which actually do the
-printout on the device.
-.
-Kernighan's version marks what is known as \(lqclassical troff\(rq
-today.
-.
-In order to distinguish it from Ossanna's original version, it was
-called
-.I ditroff
-.RI ( d "evice " i "ndependent " t roff)
-on some systems, though this naming isn't mentioned in the classical
-documentation.
-.
-.
-.P
-Today, all existing
-.I roff
-systems are based on Kernighan's multi-device
-.IR troff .
-.
-The distinction between
-.I troff
-and
-.I ditroff
-is no longer necessary; each modern
-.I troff
-provides the complete functionality of
-.IR ditroff .
-.
-.
-.P
-The easiest way to use
-.I ditroff
-is via the GNU
-.I roff
-system,
-.IR groff .
-.
-The
-.IR groff (@MAN1EXT@)
-program is a wrapper around
-.I (di)troff
-that automatically handles device postprocessing.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.
-This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
-Bernd Warken
-.ME .
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.TP
-CSTR\~#54
-refers to the 1992 revision of the
-.I Nroff/Troff User's Manual
-by J.\& F.\& Ossanna and Brian Kernighan.
-.
-.
-.TP
-CSTR\~#97
-refers to
-.IR "A Typesetter-independent TROFF" ,
-by Brian Kernighan and is the original documentation of the first
-multi-device
-.I troff
-.RI ( ditroff ).
-.
-.
-.TP
-.IR roff (@MAN7EXT@)
-provides a history and conceptual overview of
-.I roff
-systems.
-.
-.
-.TP
-.IR @g@troff (@MAN1EXT@)
-describes the GNU implementation of
-.IR (di)troff .
-.
-.
-.TP
-.IR groff (@MAN1EXT@)
-documents the GNU
-.I roff
-program and includes pointers to further documentation about
-.IR groff .
-.
-.
-.TP
-.IR groff_out (@MAN5EXT@)
-describes the
-.I groff
-version of the intermediate output language, the basis for
-multi-device output.
-.
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolj4/lj4_font.5.man Deleted

@@ -1,263 +0,0 @@
-.TH LJ4_FONT @MAN5EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-lj4_font \- groff fonts for use with devlj4
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 2004-2018 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.
-.\"
-.\" 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.
-.\"
-.\" 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.
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-Nominally,
-all Hewlett-Packard LaserJet\~\%4-series and newer printers have the
-same internal fonts:
-45 scalable fonts and one bitmapped Lineprinter font.
-.
-The scalable fonts are available in sizes between 0.25 points and 999.75
-points,
-in 0.25-point increments;
-the Lineprinter font is available only in 8.5-point size.
-.
-.
-.LP
-The LaserJet font files included with
-.B groff
-assume that all printers since the LaserJet\~4 are identical.
-.
-There are some differences between fonts in the earlier and more recent
-printers,
-however.
-.
-The LaserJet\~4 printer used Agfa Intellifont technology for 35 of the
-internal scalable fonts;
-the remaining 10 scalable fonts were TrueType.
-.
-Beginning with the LaserJet\~\%4000-series printers introduced in 1997,
-all scalable internal fonts have been TrueType.
-.
-The number of printable glyphs differs slightly between Intellifont and
-TrueType fonts
-(generally,
-the TrueType fonts include more glyphs),
-and
-there are some minor differences in glyph metrics.
-.
-Differences among printer models are described in the
-.I "PCL\~5 Comparison Guide"
-and the
-.I "PCL\~5 Comparison Guide Addendum"
-(for printers introduced since approximately 2001).
-.
-.
-.LP
-LaserJet printers reference a glyph by a combination of a 256-glyph
-symbol set and an index within that symbol set.
-.
-Many glyphs appear in more than one symbol set;
-all combinations of symbol set and index that reference the same glyph
-are equivalent.
-.
-For each glyph,
-.BR hpftodit (@MAN1EXT@)
-searches a list of symbol sets,
-and selects the first set that contains the glyph.
-.
-The printing code generated by
-.B hpftodit
-is an integer that encodes a numerical value for the symbol set in the
-high byte(s),
-and the index in the low byte.
-.
-See
-.BR groff_font (@MAN5EXT@)
-for a complete description of the font file format;
-symbol sets are described in greater detail in the
-.IR "PCL\~5 Printer Language Technical Reference Manual" .
-.
-.
-.LP
-Two of the scalable fonts,
-Symbol and Wingdings,
-are bound to 256-glyph symbol sets;
-the remaining scalable fonts,
-as well as the Lineprinter font,
-support numerous symbol sets,
-sufficient to enable printing of more than 600 glyphs.
-.
-.
-.LP
-The metrics generated by
-.B hpftodit
-assume that the DESC file contains values of 1200 for
-.I res
-and 6350 for
-.IR unitwidth ,
-or any combination
-(e.g.,
-2400 and 3175)
-for which
-.IR res \~\tmu\~ unitwidth \~=\~7\|620\|000.
-.
-Although HP PCL\~5 LaserJet printers support an internal resolution of
-7200 units per inch,
-they use a 16-bit signed integer for cursor positioning;
-if
-.B devlj4
-is to support U.S.\& ledger paper (11\~in\~\mu\~17\~in;
-in = inch),
-the maximum usable resolution is 32\|767\~\di\~17,
-or 1927 units per inch,
-which rounds down to 1200 units per inch.
-.
-If the largest required paper size is less
-(e.g.,
-8.5\~in\~\mu\~11\~in,
-or A5),
-a greater
-.I res
-(and lesser
-.IR unitwidth )
-can be specified.
-.
-.
-.\" ====================================================================
-.SH LIMITATIONS
-.\" ====================================================================
-.
-Font metrics for Intellifont fonts were provided by Tagged Font Metric
-(TFM) files originally developed by Agfa/Compugraphic.
-.
-The TFM files provided for these fonts supported 600+ glyphs and
-contained extensive lists of kerning pairs.
-.
-.
-.LP
-To accommodate developers who had become accustomed to TFM files,
-HP also provided TFM files for the 10 TrueType fonts included in the
-LaserJet\~4.
-.
-The TFM files for TrueType fonts generally included less information
-than the Intellifont TFMs,
-supporting fewer glyphs,
-and in most cases,
-providing no kerning information.
-.
-By the time the LaserJet\~4000 printer was introduced,
-most developers had migrated to other means of obtaining font metrics,
-and support for new TFM files was very limited.
-.
-The TFM files provided for the TrueType fonts in the LaserJet\~4000
-support only the Latin 2 (ISO 8859-2) symbol set,
-and include no kerning information;
-consequently,
-they are of little value for any but the most rudimentary documents.
-.
-.
-.LP
-Because the Intellifont TFM files contain considerably more information,
-they generally are preferable to the TrueType TFM files even for use
-with the TrueType fonts in the newer printers.
-.
-The metrics for the TrueType fonts are very close,
-though not identical,
-to those for the earlier Intellifont fonts of the same names.
-.
-Although most output using the Intellifont metrics with the newer
-printers is quite acceptable,
-a few glyphs may fail to print as expected.
-.
-The differences in glyph metrics may be particularly noticeable with
-composite parentheses,
-brackets,
-and braces used by
-.BR eqn (@MAN1EXT@) .
-.
-A script,
-located in
-.IR @FONTDIR@/\:devlj4/\:generate ,
-can be used to adjust the metrics for these glyphs in the special font
-\lqS\rq for use with printers that have all TrueType fonts.
-.
-.
-.LP
-At the time HP last supported TFM files,
-only version 1.0 of the Unicode standard was available.
-.
-Consequently,
-many glyphs lacking assigned code points were assigned by HP to the
-Private Use Area (PUA).
-.
-Later versions of the Unicode standard included code points outside the
-PUA for many of these glyphs.
-.
-The HP-supplied TrueType TFM files use the PUA assignments;
-TFM files generated from more recent TrueType font files require the
-later Unicode values to access the same glyphs.
-.
-Consequently,
-two different mapping files may be required:
-one for the HP-supplied TFM files,
-and one for more recent TFM files.
-.
-.
-.\" ====================================================================
-.SH FILES
-.\" ====================================================================
-.
-.TP
-.I @FONTDIR@/\:devlj4/\:DESC
-device description file
-.
-.
-.TP
-.IR @FONTDIR@/\:devlj4/\: F
-font description file for font
-.I F
-.
-.
-.TP
-.I @FONTDIR@/\:devlj4/\:generate
-corrects Intellifont-based height metrics for several glyphs in the
-special font for TrueType CG Times (LaserJet\~4000 and later).
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.BR groff (@MAN1EXT@),
-.BR hpftodit (@MAN1EXT@),
-.BR grolj4 (@MAN1EXT@),
-.BR groff_font (@MAN5EXT@)
-.
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/assert.h Deleted

@@ -1,38 +0,0 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
-     Written by James Clark (jjc@jclark.com)
-
-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 the Free
-Software Foundation, either version 3 of the License, or
-(at your option) any later version.
-
-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 this program.  If not, see <http://www.gnu.org/licenses/>. */
-
-#ifndef ASSERT_H
-#define ASSERT_H
-
-void assertion_failed(int, const char *);
-
-inline void do_assert(int expr, int line, const char *file)
-{
-  if (!expr)
-    assertion_failed(line, file);
-}
-#endif /* ASSERT_H */
-
-#undef assert
-
-#ifdef NDEBUG
-#define assert(ignore) /* as nothing */
-#else
-#define assert(expr) do_assert(expr, __LINE__, __FILE__)
-#endif

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/grog Deleted

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/grog/grog.1.man Deleted

@@ -1,471 +0,0 @@
-.TH GROG @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grog \- guess options for a following groff command
-.
-.\" grog.man -> grog.1 - man page for grog (section 1)
-.\" Source file position:  <groff_source_top>/src/roff/grog/grog.man
-.\" Installed position:    <prefix>/share/man/man1/grog.1
-.
-.\" TODO: This page needs a thorough edit by a native English speaker.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
-.\"
-.\" This file is part of grog, which is part of groff, a free software
-.\" project.  You can redistribute it and/or modify it under the terms
-.\" of the GNU General Public License version 2 (GPL2) as published by
-.\" the Free Software Foundation.
-.\"
-.\" 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.
-.\"
-.\" The text for GPL2 is available in the internet at
-.\" <http://www.gnu.org/licenses/gpl2.0.txt>.
-.
-.
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
-.
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
-.
-.\" ====================================================================
-.SH SYNOPSIS
-.\" ====================================================================
-.
-.SY grog
-.OP \-C
-.OP \-T device
-.OP \-\-run
-.OP \-\-warnings
-.OP \-\-ligatures
-.RI  groff-option
-\*(EL
-.OP \-\-
-.RI  filespec
-\*(EL
-.YS
-.
-.SY grog
-.B \-h
-.SY grog
-.B \-\-help
-.YS
-.
-.SY grog
-.B \-v
-.SY grog
-.B \-\-version
-.YS
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-.B grog
-reads the input (file names or standard input) and guesses which of
-the
-.BR groff (@MAN1EXT@)
-options are needed to perform the input with the
-.B groff
-program.
-.
-A suitable device is now always written as
-.BI \-T device
-including the groff default as
-.BR "\-T ps" .
-.
-.
-.P
-The corresponding
-.B groff
-command is usually displayed in standard output.
-.
-With the option
-.BR \-\-run ,
-the generated line is output into standard error and the generated
-.B groff
-command is run on the
-.IR "standard output" .
-.
-.BR groffer (@MAN1EXT@)
-relies on a perfectly running
-.BR groff (@MAN1EXT@).
-.
-.
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-The option
-.B \-v
-or
-.B \-\-version
-prints information on the version number.
-.
-Also
-.B \-h
-or
-.B \-\-help
-prints usage information.
-.
-Both of these options automatically end the
-.B grog
-program.
-.
-Other options are thenignored, and no
-.B groff
-command line is generated.
-.
-.
-The following 3 options are the only
-.B grog
-options,
-.
-.TP
-.B \-C
-this option means enabling the
-.I groff
-compatibility mode, which is also transfered to the generated
-.B groff
-command line.
-.
-.TP
-.B \-\-ligatures
-this option forces to include the arguments
-.B \-P\-y \-PU
-within the generated
-.B groff
-command line.
-.
-.TP
-.B \-\-run
-with this option, the command line is output at standard error and
-then run on the computer.
-.
-.TP
-.B \-\-warnings
-with this option, some more warnings are output to standard error.
-.
-.
-.P
-All other specified short options (words starting with one minus
-character
-.BR \- )
-are interpreted as
-.B groff
-options or option clusters with or without argument.
-.
-No space is allowed between options and their argument.
-.
-Except from the
-.BI \-m arg
-options, all options will be passed on, i.e.\& they are included
-unchanged in the command for the output without effecting the work of
-.BR grog .
-.
-.
-.P
-A
-.I filespec
-argument can either be the name of an existing file or a single minus
-.B \-
-to mean standard input.
-.
-If no
-.I filespec
-is specified standard input is read automatically.
-.
-.
-.\" ====================================================================
-.SH DETAILS
-.\" ====================================================================
-.
-.B grog
-reads all
-.I filespec
-parameters as a whole.
-.
-It tries to guess which of the following
-.B groff
-options are required for running the input under
-.BR groff :
-.BR \-e ,
-.BR \-g ,
-.BR \-G ,
-.BR \-j ,
-.\" gideal is not implemented yet.
-.\" .BR \-J ,
-.BR \-p ,
-.BR \-R ,
-.BR \-s ,
-.B \-t
-(preprocessors); and
-.BR \-man ,
-.BR \-mdoc ,
-.BR \-mdoc\-old ,
-.BR \-me ,
-.BR \-mm ,
-.BR \-mom ,
-and
-.B \-ms
-(macro packages).
-.
-.
-.P
-The guessed
-.B groff
-command including those options and the found
-.I filespec
-parameters is put on the standard output.
-.
-.
-.P
-It is possible to specify arbitrary
-.B groff
-options on the command line.
-.
-These are passed on the output without change, except for the
-.BI \-m arg
-options.
-.
-.
-.P
-The
-.B groff
-program has trouble when the wrong
-.BI \-m arg
-option or several of these options are specified.
-.
-In these cases,
-.B grog
-will print an error message and exit with an error code.
-.
-It is better to specify no
-.BI \-m arg
-option.
-.
-Because such an option is only accepted and passed when
-.B grog
-does not find any of these options or the same option is found.
-.
-.
-.P
-If several different
-.BI \-m arg
-options are found by
-.B grog
-an error message is produced and the program is terminated with an
-error code.
-.
-But the output is written with the wrong options nevertheless.
-.
-.
-.P
-Remember that it is not necessary to determine a macro package.
-.
-A
-.I roff
-file can also be written in the
-.I groff
-language without any macro package.
-.
-.B grog
-will produce an output without an
-.BI \-m arg
-option.
-.
-.
-.P
-As
-.B groff
-also works with pure text files without any
-.I roff
-requests,
-.B grog
-cannot be used to identify a file to be a
-.I roff
-file.
-.
-.
-.P
-The
-.BR groffer  (@MAN1EXT@)
-program heavily depends on a working
-.BR grog .
-.
-.
-.\" ====================================================================
-.SH EXAMPLES
-.\" ====================================================================
-.
-Calling
-.RS
-.EX
-grog meintro.me
-.EE
-.RE
-results in
-.RS
-.EX
-groff \-me meintro.me
-.EE
-.RE
-.
-So
-.B grog
-recognized that the file
-.B meintro.me
-is written with the
-.B \-me
-macro package.
-.RE
-.
-.
-On the other hand,
-.RS
-.EX
-grog pic.ms
-.EE
-.RE
-.
-outputs
-.
-.RS
-.EX
-groff \-p \-t \-e \-ms pic.ms
-.EE
-.RE
-.
-Besides determining the macro package
-.BR \-ms ,
-.B grog
-recognized that the file
-.B pic.ms
-additionally needs
-.BR \-pte ,
-the combination of
-.B \-p
-for
-.IR pic ,
-.B \-t
-for
-.IR tbl ,
-and
-.B \-e
-for
-.IR eqn .
-.RE
-.
-.
-If both of the former example files are combined by the command
-.
-.RS
-.EX
-grog meintro.me pic.ms
-.EE
-.RE
-.
-an error message is sent to standard error because
-.B groff
-cannot work with two different macro packages:
-.
-.RS
-.ft CR
-grog: error: there are several macro packages: \-me \-ms
-.ft
-.RE
-.
-Additionally the corresponding output with the wrong options is printed
-to standard output:
-.
-.RS
-.EX
-groff \-pte \-me \-ms meintro.me pic.ms
-.EE
-.RE
-.
-But the program is terminated with an error code.
-.
-.
-The call of
-.
-.RS
-.EX
-grog \-ksS \-Tdvi grnexmpl.g
-.EE
-.RE
-.
-contains several
-.B groff
-options that are just passed on the output without any interface to
-.BR grog .
-These are the option cluster
-.B \-ksS
-consisting of
-.BR \-k ,
-.BR \-s ,
-and
-.BR \-S ;
-and the option
-.B \-T
-with argument
-.BR dvi .
-The output is
-.
-.RS
-.EX
-groff \-k \-s \-S \-Tdvi grnexmpl.g
-.EE
-.RE
-.
-so no additional option was added by
-.BR grog .
-As no option
-.BI \-m arg
-was found by
-.B grog
-this file does not use a macro package.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.B grog
-was originally written by James Clark.
-.
-The current Perl implementation was written by
-.MT groff\-bernd.warken\-72@\:web.de
-Bernd Warken
-.ME
-with contributions from Ralph Corderoy,
-and is maintained by
-.MT wl@\:gnu.org
-Werner Lemberg
-.ME .
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.BR groff (@MAN1EXT@),
-.BR groffer (@MAN1EXT@)
-.
-.
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" End:
-.\" vim: set filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/grog/grog.am Deleted

@@ -1,62 +0,0 @@
-# grog.am for 'grog'
-#
-# File position: <groff-source>/src/roff/grog/grog.am
-#
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
-#
-# This file is part of 'grog' 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
-# (at your option) any later version.
-#
-# '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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-grog_srcdir = $(top_srcdir)/src/roff/grog
-bin_SCRIPTS += grog
-GROG = src/roff/grog/subs.pl
-
-# grog_dir is defined by a m4 macro
-grogdir = $(grog_dir)
-dist_grog_DATA = $(GROG)
-man1_MANS += src/roff/grog/grog.1
-EXTRA_DIST += \
-  src/roff/grog/grog.1.man \
-  src/roff/grog/grog.pl
-
-# Perl version works for all parts of 'groff'.
-
-grog: $(grog_srcdir)/grog.pl $(GROG) $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)$(RM) $@ \
-	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
-	       -e "1s|^$#! $.*perl|\\1$(PERL)|" \
-	       -e "s|@g@|$(g)|g" \
-	       -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
-	       -e "s|@libdir@|$(DESTDIR)$(libdir)|g" \
-	       -e "s|@EGREP@|$(EGREP)|g" \
-	       -e "s|@VERSION@|$(VERSION)|" \
-	       -e "s|@grog_dir@|$(grog_dir)|" \
-	       -e "$(SH_SCRIPT_SED_CMD)" \
-	       $(grog_srcdir)/grog.pl \
-	       >$@ \
-	&& chmod +x $@
-
-
-########################################################################
-# Editor settings
-########################################################################
-#
-# Local Variables:
-# mode: makefile-automake
-# fill-column: 72
-# End:
-# vim: set filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/grog/grog.pl Deleted

@@ -1,102 +0,0 @@
-#! /usr/bin/env perl
-# grog - guess options for groff command
-# Inspired by doctype script in Kernighan & Pike, Unix Programming
-# Environment, pp 306-8.
-
-# Source file position: <groff-source>/src/roff/grog/grog.pl
-# Installed position: <prefix>/bin/grog
-
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
-# Written by James Clark.
-# Rewritten with Perl by Bernd Warken <groff-bernd.warken-72@web.de>.
-# The macros for identifying the devices were taken from Ralph
-# Corderoy's 'grog.sh' of 2006.
-
-# Last update: 19 Jul 2015
-
-# This file is part of 'grog', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-require v5.6;
-
-use warnings;
-use strict;
-
-# $Bin is the directory where this script is located
-use FindBin;
-
-my $before_make;	# script before run of 'make'
-{
-  my $at = '@';
-  $before_make = 1 if '@VERSION@' eq "${at}VERSION${at}";
-}
-
-
-our %at_at;
-my $grog_dir;
-
-if ($before_make) { # before installation
-  my $grog_source_dir = $FindBin::Bin;
-  $at_at{'BINDIR'} = $grog_source_dir;
-# $grog_dir = $grog_source_dir;
-  $grog_dir = '.';
-  my $top = $grog_source_dir . '/../../../';
-  open FILE, '<', $top . 'VERSION' ||
-    die 'Could not open top file VERSION.';
-  my $version = <FILE>;
-  chomp $version;
-  close FILE;
-  open FILE, '<', $top . 'REVISION' ||
-    die 'Could not open top file REVISION.';
-  my $revision = <FILE>;
-  chomp $revision;
-  $at_at{'GROFF_VERSION'} = $version . '.' . $revision;
-} else { # after installation}
-  $at_at{'GROFF_VERSION'} = '@VERSION@';
-  $at_at{'BINDIR'} = '@BINDIR@';
-  $grog_dir = '@grog_dir@';
-} # before make
-
-die "$grog_dir is not an existing directory;" unless -d $grog_dir;
-
-
-#############
-# import subs
-
-unshift(@INC, $grog_dir);
-require 'subs.pl';
-
-
-##########
-# run subs
-
-&handle_args();
-&handle_file_ext(); # see $tmac_ext for gotten value
-&handle_whole_files();
-&make_groff_device();
-&make_groff_preproc();
-&make_groff_tmac_man_ms() || &make_groff_tmac_others();
-&make_groff_line_rest();
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/grog/subs.pl Deleted

@@ -1,1266 +0,0 @@
-#! /usr/bin/env perl
-# grog - guess options for groff command
-# Inspired by doctype script in Kernighan & Pike, Unix Programming
-# Environment, pp 306-8.
-
-# Source file position: <groff-source>/src/roff/grog/subs.pl
-# Installed position: <prefix>/lib/grog/subs.pl
-
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
-# This file was split from grog.pl and put under GPL2 by
-#               Bernd Warken <groff-bernd.warken-72@web.de>.
-# The macros for identifying the devices were taken from Ralph
-# Corderoy's 'grog.sh' of 2006.
-
-# Last update: 10 Sep 2015
-
-# This file is part of 'grog', 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 can get the license text for the GNU General Public License
-# version 2 in the internet at
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-require v5.6;
-
-use warnings;
-use strict;
-
-use File::Spec;
-
-# printing of hashes: my %hash = ...; print Dumper(\%hash);
-use Data::Dumper;
-
-# for running shell based programs within Perl; use `` instead of
-# use IPC::System::Simple qw(capture capturex run runx system systemx);
-
-$\ = "\n";
-
-# my $Sp = "\\s\\n";
-# my $Sp = qr(\s\n);
-# my $Sp = '' if $arg eq '-C';
-my $Sp = '';
-
-# from 'src/roff/groff/groff.cpp' near 'getopt_long'
-my $groff_opts =
-  'abcCd:D:eEf:F:gGhiI:jJkK:lL:m:M:n:No:pP:r:RsStT:UvVw:W:XzZ';
-
-my @Command = ();		# stores the final output
-my @Mparams = ();		# stores the options '-m*'
-my @devices = ();		# stores -T
-
-my $do_run = 0;			# run generated 'groff' command
-my $pdf_with_ligatures = 0;	# '-P-y -PU' for 'pdf' device
-my $with_warnings = 0;
-
-my $Prog = $0;
-{
-  my ($v, $d, $f) = File::Spec->splitpath($Prog);
-  $Prog = $f;
-}
-
-
-my %macros;
-my %Groff =
-  (
-   # preprocessors
-   'chem' => 0,
-   'eqn' => 0,
-   'gperl' => 0,
-   'grap' => 0,
-   'grn' => 0,
-   'gideal' => 0,
-   'gpinyin' => 0,
-   'lilypond' => 0,
-
-   'pic' => 0,
-   'PS' => 0,		# opening for pic
-   'PF' => 0,		# alternative opening for pic
-   'PE' => 0,		# closing for pic
-
-   'refer' => 0,
-   'refer_open' => 0,
-   'refer_close' => 0,
-   'soelim' => 0,
-   'tbl' => 0,
-
-   # tmacs
-#   'man' => 0,
-#   'mandoc' => 0,
-#   'mdoc' => 0,
-#   'mdoc_old' => 0,
-#   'me' => 0,
-#   'mm' => 0,
-#   'mom' => 0,
-#   'ms' => 0,
-
-   # requests
-   'AB' => 0,		# ms
-   'AE' => 0,		# ms
-   'AI' => 0,		# ms
-   'AU' => 0,		# ms
-   'NH' => 0,		# ms
-   'TH_later' => 0,	# TH not 1st command is ms
-   'TL' => 0,		# ms
-   'UL' => 0,		# ms
-   'XP' => 0,		# ms
-
-   'IP' => 0,		# man and ms
-   'LP' => 0,		# man and ms
-   'P' => 0,		# man and ms
-   'PP' => 0,		# man and ms
-   'SH' => 0,		# man and ms
-
-   'OP' => 0,		# man
-   'SS' => 0,		# man
-   'SY' => 0,		# man
-   'TH_first' => 0,	# TH as 1st command is man
-   'TP' => 0,		# man
-   'UR' => 0,		# man
-   'YS' => 0,		# man
-
-   # for mdoc and mdoc-old
-   # .Oo and .Oc for modern mdoc, only .Oo for mdoc-old
-   'Oo' => 0,		# mdoc and mdoc-old
-   'Oc' => 0,		# mdoc
-   'Dd' => 0,		# mdoc
-  ); # end of %Groff
-
-
-# for first line check
-my %preprocs_tmacs =
-  (
-   'chem' => 0,
-   'eqn' => 0,
-   'gideal' => 0,
-   'gpinyin' => 0,
-   'grap' => 0,
-   'grn' => 0,
-   'pic' => 0,
-   'refer' => 0,
-   'soelim' => 0,
-   'tbl' => 0,
-
-   'geqn' => 0,
-   'gpic' => 0,
-   'neqn' => 0,
-
-   'man' => 0,
-   'mandoc' => 0,
-   'mdoc' => 0,
-   'mdoc-old' => 0,
-   'me' => 0,
-   'mm' => 0,
-   'mom' => 0,
-   'ms' => 0,
-  );
-
-my @filespec;
-
-my $tmac_ext = '';
-
-
-########################################################################
-# err()
-########################################################################
-
-sub err {
-  my $text = shift;
-  print STDERR $text;
-}
-
-
-########################################################################
-# handle_args()
-########################################################################
-
-sub handle_args {
-  my $double_minus = 0;
-  my $was_minus = 0;
-  my $was_T = 0;
-  my $optarg = 0;
-  # globals: @filespec, @Command, @devices, @Mparams
-
-  foreach my $arg (@ARGV) {
-
-    if ( $optarg ) {
-      push @Command, $arg;
-      $optarg = 0;
-      next;
-    }
-
-    if ( $double_minus ) {
-      if (-f $arg && -r $arg) {
-	push @filespec, $arg;
-      } else {
-	print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	  "grog: $arg is not a readable file.";
-      }
-      next;
-    }
-
-    if ( $was_T ) {
-      push @devices, $arg;
-      $was_T = 0;
-      next;
-    }
-####### handle_args()
-
-    unless ( $arg =~ /^-/ ) { # file name, no opt, no optarg
-      unless (-f $arg && -r $arg) {
-	print 'unknown file name: ' . $arg;
-      }
-      push @filespec, $arg;
-      next;
-    }
-
-    # now $arg starts with '-'
-
-    if ($arg eq '-') {
-      unless ($was_minus) {
-	push @filespec, $arg;
-	$was_minus = 1;
-      }
-      next;
-    }
-
-    if ($arg eq '--') {
-      $double_minus = 1;
-      push(@filespec, $arg);
-      next;
-    }
-
-    &version() if $arg =~ /^--?v/;	# --version, with exit
-    &help() if $arg  =~ /--?h/;		# --help, with exit
-
-    if ( $arg =~ /^--r/ ) {		#  --run, no exit
-      $do_run = 1;
-      next;
-    }
-
-    if ( $arg =~ /^--wa/ ) {		#  --warnings, no exit
-      $with_warnings = 1;
-      next;
-    }
-####### handle_args()
-
-    if ( $arg =~ /^--(wi|l)/ ) { # --ligatures, no exit
-      # the old --with_ligatures is only kept for compatibility
-      $pdf_with_ligatures = 1;
-      next;
-    }
-
-    if ($arg =~ /^-m/) {
-      push @Mparams, $arg;
-      next;
-    }
-
-    if ($arg =~ /^-T$/) {
-      $was_T = 1;
-      next;
-    }
-
-    if ($arg =~ s/^-T(\w+)$/$1/) {
-      push @devices, $1;
-      next;
-    }
-
-    if ($arg =~ /^-(\w)(\w*)$/) {	# maybe a groff option
-      my $opt_char = $1;
-      my $opt_char_with_arg = $opt_char . ':';
-      my $others = $2;
-      if ( $groff_opts =~ /$opt_char_with_arg/ ) {	# groff optarg
-	if ( $others ) {	# optarg is here
-	  push @Command, '-' . $opt_char;
-	  push @Command, '-' . $others;
-	  next;
-	}
-	# next arg is optarg
-	$optarg = 1;
-	next;
-####### handle_args()
-      } elsif ( $groff_opts =~ /$opt_char/ ) {	# groff no optarg
-	push @Command, '-' . $opt_char;
-	if ( $others ) {	# $others is now an opt collection
-	  $arg = '-' . $others;
-	  redo;
-	}
-	# arg finished
-	next;
-      } else {		# not a groff opt
-	print STDERR __FILE__ . ' '  . __LINE__ . ': ' .
-	  'unknown argument ' . $arg;
-	push(@Command, $arg);
-	next;
-      }
-    }
-  }
-  @filespec = ('-') unless (@filespec);
-} # handle_args()
-
-
-
-########################################################################
-# handle_file_ext()
-########################################################################
-
-sub handle_file_ext {
-  # get tmac from file name extension
-  # output number of found single tmac
-
-  # globals: @filespec, $tmac_ext;
-
-  foreach my $file ( @filespec ) {
-    # test for each file name in the arguments
-    unless ( open(FILE, $file eq "-" ? $file : "< $file") ) {
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	"$Prog: can't open \'$file\': $!";
-      next;
-    }
-
-    next unless ( $file =~ /\./ ); # file name has no dot '.'
-
-##### handle_file_ext()
-    # get extension
-    my $ext = $file;
-    $ext =~ s/^
-	      .*
-	      \.
-	      (^.*)
-	      $
-	     /$1/x;
-    next unless ( $ext );
-
-##### handle_file_ext()
-    # these extensions are correct, but not based on a tmac
-    next if ( $ext =~ /^(
-			 chem|
-			 eqn|
-			 g|
-			 grap|
-			 grn|
-			 groff|
-			 hdtbl|
-			 pdfroff|
-			 pic|
-			 pinyin|
-			 ref|
-			 roff|
-			 t|
-			 tbl|
-			 tr|
-			 www
-		       )$/x );
-
-##### handle_file_ext()
-    # extensions for man tmac
-    if ( $ext =~ /^(
-		      1-9lno|
-		      man|
-		      n|
-		      1b
-		    )$/x ) {
-      # 'man|n' from 'groff' source
-      # '1b' from 'heirloom'
-      # '1-9lno' from man-pages
-      if ( $tmac_ext && $tmac_ext ne 'man' ) {
-	# found tmac is not 'man'
-	print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	  '2 different file name extensions found ' .
-	    $tmac_ext . ' and ' . $ext;
-	$tmac_ext = '';
-	next;
-      }
-
-##### handle_file_ext()
-      $tmac_ext = 'man';
-      next;
-    }
-
-    if ( $ext =~ /^(
-		    mandoc|
-		    mdoc|
-		    me|
-		    mm|
-		    mmse|
-		    mom|
-		    ms|
-		    $)/x ) {
-      if ( $tmac_ext && $tmac_ext ne $ext ) {
-	# found tmac is not identical to former found tmac
-##### handle_file_ext()
-	print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	  '2 different file name extensions found ' .
-	    $tmac_ext . ' and ' . $ext;
-	$tmac_ext = '';
-	next;
-      }
-
-      $tmac_ext = $ext;
-      next;
-    }
-
-    print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-      'Unknown file name extension '. $file . '.';
-    next;
-  } # end foreach file
-
-  1;
-} # handle_file_ext()
-
-
-########################################################################
-# handle_whole_files()
-########################################################################
-
-sub handle_whole_files {
-  # globals: @filespec
-
-  foreach my $file ( @filespec ) {
-    unless ( open(FILE, $file eq "-" ? $file : "< $file") ) {
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	"$Prog: can't open \'$file\': $!";
-      next;
-    }
-    my $line = <FILE>; # get single line
-
-    unless ( defined($line) ) {
-      # empty file, go to next filearg
-      close (FILE);
-      next;
-    }
-
-    if ( $line ) {
-      chomp $line;
-      unless ( &do_first_line( $line, $file ) ) {
-	# not an option line
-	&do_line( $line, $file );
-      }
-    } else { # empty line
-      next;
-    }
-
-    while (<FILE>) { # get lines by and by
-      chomp;
-      &do_line( $_, $file );
-    }
-    close(FILE);
-  } # end foreach
-} # handle_whole_files()
-
-
-########################################################################
-# do_first_line()
-########################################################################
-
-# As documented for the 'man' program, the first line can be
-# used as a groff option line.  This is done by:
-# - start the line with '\" (apostrophe, backslash, double quote)
-# - add a space character
-# - a word using the following characters can be appended: 'egGjJpRst'.
-#     Each of these characters means an option for the generated
-#     'groff' command line, e.g. '-t'.
-
-sub do_first_line {
-  my ( $line, $file ) = @_;
-
-  # globals: %preprocs_tmacs
-
-  # For a leading groff options line use only egGjJpRst
-  if  ( $line =~ /^.'\\"\segGjJpRst+&/ ) {
-    # this is a groff options leading line
-    if ( $line =~ /^\./ ) {
-      # line is a groff options line with . instead of '
-      print "First line in $file must start with an apostrophe \ " .
-	"instead of a period . for groff options line!";
-    }
-
-    if ( $line =~ /j/ ) {
-      $Groff{'chem'}++;
-    }
-    if ( $line =~ /e/ ) {
-      $Groff{'eqn'}++;
-    }
-    if ( $line =~ /g/ ) {
-      $Groff{'grn'}++;
-    }
-    if ( $line =~ /G/ ) {
-      $Groff{'grap'}++;
-    }
-    if ( $line =~ /i/ ) {
-      $Groff{'gideal'}++;
-    }
-    if ( $line =~ /p/ ) {
-      $Groff{'pic'}++;
-    }
-    if ( $line =~ /R/ ) {
-      $Groff{'refer'}++;
-    }
-    if ( $line =~ /s/ ) {
-      $Groff{'soelim'}++;
-    }
-####### do_first_line()
-    if ( $line =~ /t/ ) {
-      $Groff{'tbl'}++;
-    }
-    return 1;	# a leading groff options line, 1 means yes, 0 means no
-  }
-
-  # not a leading short groff options line
-
-  return 0 if ( $line !~ /^.'\\"\s*(.*)$/ );	# ignore non-comments
-
-  return 0 unless ( $1 );	# for empty comment
-
-  # all following array members are either preprocs or 1 tmac
-  my @words = split '\s+', $1;
-
-  my @in = ();
-  my $word;
-  for $word ( @words ) {
-    if ( $word eq 'ideal' ) {
-      $word = 'gideal';
-    } elsif ( $word eq 'gpic' ) {
-      $word = 'pic';
-    } elsif ( $word =~ /^(gn|)eqn$/ ) {
-      $word = 'eqn';
-    }
-    if ( exists $preprocs_tmacs{$word} ) {
-      push @in, $word;
-    } else {
-      # not word for preproc or tmac
-      return 0;
-    }
-  }
-
-  for $word ( @in ) {
-    $Groff{$word}++;
-  }
-} # do_first_line()
-
-
-########################################################################
-# do_line()
-########################################################################
-
-my $before_first_command = 1; # for check of .TH
-
-sub do_line {
-  my ( $line, $file ) = @_;
-
-  return if ( $line =~ /^.'\s*\\"/ );	# comment
-
-  return unless ( $line =~ /^.'/ );	# ignore text lines
-
-  $line =~ s/^'.\s*/./;	# let only a dot as leading character,
-				# remove spaces after the leading dot
-  $line =~ s/\s+$//;		# remove final spaces
-
-  return if ( $line =~ /^\.$/ );	# ignore .
-  return if ( $line =~ /^\.\.$/ );	# ignore ..
-
-  if ( $before_first_command ) { # so far without 1st command
-    if ( $line =~ /^\.TH/ ) {
-      # check if .TH is 1st command for man
-      $Groff{'TH_first'} = 1 if ( $line =~ /^\.\s*TH/ );
-    }
-    if ( $line =~ /^\./ ) {
-      $before_first_command = 0;
-    }
-  }
-
-  # split command
-  $line =~ /^(\.\w+)\s*(.*)$/;
-  my $command = $1;
-  $command = '' unless ( defined $command );
-  my $args = $2;
-  $args = '' unless ( defined $args );
-
-
-  ######################################################################
-  # soelim
-  if ( $line =~ /^\.(do)?\s*(so|mso|PS\s*<|SO_START).*$/ ) {
-    # '.so', '.mso', '.PS<...', '.SO_START'
-    $Groff{'soelim'}++;
-    return;
-  }
-  if ( $line =~ /^\.(do)?\s*(so|mso|PS\s*<|SO_START).*$/ ) {
-    # '.do so', '.do mso', '.do PS<...', '.do SO_START'
-    $Groff{'soelim'}++;
-    return;
-  }
-####### do_line()
-
-  ######################################################################
-  # macros
-
-  if ( $line =~ /^\.de1?\W?/ ) {
-    # this line is a macro definition, add it to %macros
-    my $macro = $line;
-    $macro =~ s/^\.de1?\s+(\w+)\W*/.$1/;
-    return if ( exists $macros{$macro} );
-    $macros{$macro} = 1;
-    return;
-  }
-
-
-  # if line command is a defined macro, just ignore this line
-  return if ( exists $macros{$command} );
-
-
-  ######################################################################
-  # preprocessors
-
-  if ( $command =~ /^(\.cstart)|(begin\s+chem)$/ ) {
-    $Groff{'chem'}++;		# for chem
-    return;
-  }
-  if ( $command =~ /^\.EQ$/ ) {
-    $Groff{'eqn'}++;		# for eqn
-    return;
-  }
-  if ( $command =~ /^\.G1$/ ) {
-    $Groff{'grap'}++;		# for grap
-    return;
-  }
-  if ( $command =~ /^\.Perl/ ) {
-    $Groff{'gperl'}++;		# for gperl
-    return;
-  }
-  if ( $command =~ /^\.pinyin/ ) {
-    $Groff{'gpinyin'}++;		# for gperl
-    return;
-  }
-  if ( $command =~ /^\.GS$/ ) {
-    $Groff{'grn'}++;		# for grn
-    return;
-  }
-  if ( $command =~ /^\.IS$/ ) {
-    $Groff{'gideal'}++;		# preproc gideal for ideal
-    return;
-  }
-  if ( $command =~ /^\.lilypond$/ ) {
-    $Groff{'lilypond'}++;	# for glilypond
-    return;
-  }
-
-####### do_line()
-
-  # pic can be opened by .PS or .PF and closed by .PE
-  if ( $command =~ /^\.PS$/ ) {
-    $Groff{'pic'}++;		# normal opening for pic
-    return;
-  }
-  if ( $command =~ /^\.PF$/ ) {
-    $Groff{'PF'}++;		# alternate opening for pic
-    return;
-  }
-  if ( $command =~ /^\.PE$/ ) {
-    $Groff{'PE'}++;		# closing for pic
-    return;
-  }
-
-  if ( $command =~ /^\.R1$/ ) {
-    $Groff{'refer'}++;		# for refer
-    return;
-  }
-  if ( $command =~ /^\.\$/ ) {
-    $Groff{'refer_open'}++;	# for refer open
-    return;
-  }
-  if ( $command =~ /^\.\$/ ) {
-    $Groff{'refer_close'}++;	# for refer close
-    return;
-  }
-  if ( $command =~ /^\.TS$/ ) {
-    $Groff{'tbl'}++;		# for tbl
-    return;
-  }
-  if ( $command =~ /^\.TH$/ ) {
-    unless ( $Groff{'TH_first'} ) {
-      $Groff{'TH_later'}++;		# for tbl
-    }
-    return;
-  }
-
-
-  ######################################################################
-  # macro package (tmac)
-  ######################################################################
-
-  ##########
-  # modern mdoc
-
-  if ( $command =~ /^\.(Dd)$/ ) {
-    $Groff{'Dd'}++;		# for modern mdoc
-    return;
-  }
-
-####### do_line()
-  # In the old version of -mdoc 'Oo' is a toggle, in the new it's
-  # closed by 'Oc'.
-  if ( $command =~ /^\.Oc$/ ) {
-    $Groff{'Oc'}++;		# only for modern mdoc
-    return;
-  }
-
-
-  ##########
-  # old and modern mdoc
-
-  if ( $command =~ /^\.Oo$/ ) {
-    $Groff{'Oo'}++;		# for mdoc and mdoc-old
-    return;
-  }
-
-
-  ##########
-  # old mdoc
-  if ( $command =~ /^\.(Tp|Dp|De|Cx|Cl)$/ ) {
-    $Groff{'mdoc_old'}++;	# true for old mdoc
-    return;
-  }
-
-
-  ##########
-  # for ms
-
-####### do_line()
-  if ( $command =~ /^\.AB$/ ) {
-    $Groff{'AB'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.AE$/ ) {
-    $Groff{'AE'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.AI$/ ) {
-    $Groff{'AI'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.AU$/ ) {
-    $Groff{'AU'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.NH$/ ) {
-    $Groff{'NH'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.TL$/ ) {
-    $Groff{'TL'}++;		# for ms
-    return;
-  }
-  if ( $command =~ /^\.XP$/ ) {
-    $Groff{'XP'}++;		# for ms
-    return;
-  }
-
-
-  ##########
-  # for man and ms
-
-  if ( $command =~ /^\.IP$/ ) {
-    $Groff{'IP'}++;		# for man and ms
-    return;
-  }
-  if ( $command =~ /^\.LP$/ ) {
-    $Groff{'LP'}++;		# for man and ms
-    return;
-  }
-####### do_line()
-  if ( $command =~ /^\.P$/ ) {
-    $Groff{'P'}++;		# for man and ms
-    return;
-  }
-  if ( $command =~ /^\.PP$/ ) {
-    $Groff{'PP'}++;		# for man and ms
-    return;
-  }
-  if ( $command =~ /^\.SH$/ ) {
-    $Groff{'SH'}++;		# for man and ms
-    return;
-  }
-  if ( $command =~ /^\.UL$/ ) {
-    $Groff{'UL'}++;		# for man and ms
-    return;
-  }
-
-
-  ##########
-  # for man only
-
-  if ( $command =~ /^\.OP$/ ) {	# for man
-    $Groff{'OP'}++;
-    return;
-  }
-  if ( $command =~ /^\.SS$/ ) {	# for man
-    $Groff{'SS'}++;
-    return;
-  }
-  if ( $command =~ /^\.SY$/ ) {	# for man
-    $Groff{'SY'}++;
-    return;
-  }
-  if ( $command =~ /^\.TP$/ ) {	# for man
-    $Groff{'TP'}++;
-    return;
-  }
-  if ( $command =~ /^\.UR$/ ) {
-    $Groff{'UR'}++;		# for man
-    return;
-  }
-  if ( $command =~ /^\.YS$/ ) {	# for man
-   $Groff{'YS'}++;
-    return;
-  }
-####### do_line()
-
-
-  ##########
-  # me
-
-  if ( $command =~ /^\.(
-		      ilnpp|
-		      sh
-		    )$/x ) {
-    $Groff{'me'}++;		# for me
-    return;
-  }
-
-
-  #############
-  # mm and mmse
-
-  if ( $command =~ /^\.(
-		      H|
-		      MULB|
-		      LO|
-		      LT|
-		      NCOL|
-		      P\$|
-		      PH|
-		      SA
-		    )$/x ) {
-    $Groff{'mm'}++;		# for mm and mmse
-    if ( $command =~ /^\.LO$/ ) {
-      if ( $args =~ /^(DNAMN|MDAT|BIL|KOMP|DBET|BET|SIDOR)/ ) {
-	$Groff{'mmse'}++;	# for mmse
-      }
-    } elsif ( $command =~ /^\.LT$/ ) {
-      if ( $args =~ /^(SVV|SVH)/ ) {
-	$Groff{'mmse'}++;	# for mmse
-      }
-    }
-    return;
-  }
-####### do_line()
-
-  ##########
-  # mom
-
-  if ( $line =~ /^\.(
-		   ALD|
-		   DOCTYPE|
-		   FAMILY|
-		   FT|
-		   FAM|
-		   LL|
-		   LS|
-		   NEWPAGE|
-		   PAGE|
-		   PAPER|
-		   PRINTSTYLE|
-		   PT_SIZE|
-		   T_MARGIN
-		 )$/x ) {
-    $Groff{'mom'}++;		# for mom
-    return;
-  }
-
-} # do_line()
-
-
-########################################################################
-# sub make_groff_device
-########################################################################
-
-my @m = ();
-my @preprograms = ();
-my $correct_tmac = '';
-
-sub make_groff_device {
-  # globals: @devices
-
-  # default device is 'ps' when without '-T'
-  my $device;
-  push @devices, 'ps' unless ( @devices );
-
-###### make_groff_device()
-  for my $d ( @devices ) {
-    if ( $d =~ /^(		# suitable devices
-		  dvi|
-		  html|
-		  xhtml|
-		  lbp|
-		  lj4|
-		  ps|
-		  pdf|
-		  ascii|
-		  cp1047|
-		  latin1|
-		  utf8
-		)$/x ) {
-###### make_groff_device()
-      $device = $d;
-    } else {
-      next;
-    }
-
-
-    if ( $device ) {
-      push @Command, '-T';
-      push @Command, $device;
-    }
-  }
-
-###### make_groff_device()
-  if ( $device eq 'pdf' ) {
-    if ( $pdf_with_ligatures ) {	# with --ligature argument
-      push( @Command, '-P-y' );
-      push( @Command, '-PU' );
-    } else {	# no --ligature argument
-      if ( $with_warnings ) {
-	print STDERR <<EOF;
-If you have trouble with ligatures like 'fi' in the 'groff' output, you
-can proceed as one of
-- add 'grog' option '--with_ligatures' or
-- use the 'grog' option combination '-P-y -PU' or
-- try to remove the font named similar to 'fonts-texgyre' from your system.
-EOF
-      }	# end of warning
-    }	# end of ligature
-  }	# end of pdf device
-} # make_groff_device()
-
-
-########################################################################
-# make_groff_preproc()
-########################################################################
-
-sub make_groff_preproc {
-  # globals: %Groff, @preprograms, @Command
-
-  # preprocessors without 'groff' option
-  if ( $Groff{'lilypond'} ) {
-    push @preprograms, 'glilypond';
-  }
-  if ( $Groff{'gperl'} ) {
-    push @preprograms, 'gperl';
-  }
-  if ( $Groff{'gpinyin'} ) {
-    push @preprograms, 'gpinyin';
-  }
-
-  # preprocessors with 'groff' option
-  if ( ( $Groff{'PS'} ||  $Groff{'PF'} ) &&  $Groff{'PE'} ) {
-    $Groff{'pic'} = 1;
-  }
-  if ( $Groff{'gideal'} ) {
-    $Groff{'pic'} = 1;
-  }
-
-###### make_groff_preproc()
-  $Groff{'refer'} ||= $Groff{'refer_open'} && $Groff{'refer_close'};
-
-  if ( $Groff{'chem'} || $Groff{'eqn'} ||  $Groff{'gideal'} ||
-       $Groff{'grap'} || $Groff{'grn'} || $Groff{'pic'} ||
-       $Groff{'refer'} || $Groff{'tbl'} ) {
-    push(@Command, '-s') if $Groff{'soelim'};
-
-    push(@Command, '-R') if $Groff{'refer'};
-
-    push(@Command, '-t') if $Groff{'tbl'};	# tbl before eqn
-    push(@Command, '-e') if $Groff{'eqn'};
-
-    push(@Command, '-j') if $Groff{'chem'};	# chem produces pic code
-    push(@Command, '-J') if $Groff{'gideal'};	# gideal produces pic
-    push(@Command, '-G') if $Groff{'grap'};
-    push(@Command, '-g') if $Groff{'grn'};	# gremlin files for -me
-    push(@Command, '-p') if $Groff{'pic'};
-
-  }
-} # make_groff_preproc()
-
-
-########################################################################
-# make_groff_tmac_man_ms()
-########################################################################
-
-sub make_groff_tmac_man_ms {
-  # globals: @filespec, $tmac_ext, %Groff
-
-  # 'man' requests, not from 'ms'
-  if ( $Groff{'SS'} || $Groff{'SY'} || $Groff{'OP'} ||
-       $Groff{'TH_first'} || $Groff{'TP'} || $Groff{'UR'} ) {
-    $Groff{'man'} = 1;
-    push(@m, '-man');
-
-    $tmac_ext = 'man' unless ( $tmac_ext );
-    &err('man requests found, but file name extension ' .
-	 'was: ' . $tmac_ext) unless ( $tmac_ext eq 'man' );
-    $tmac_ext = 'man';
-    return 1;	# true
-  }
-
-###### make_groff_tmac_man_ms()
-  # 'ms' requests, not from 'man'
-  if (
-      $Groff{'1C'} || $Groff{'2C'} ||
-      $Groff{'AB'} || $Groff{'AE'} || $Groff{'AI'} || $Groff{'AU'} ||
-      $Groff{'BX'} || $Groff{'CD'} || $Groff{'DA'} || $Groff{'DE'} ||
-      $Groff{'DS'} || $Groff{'ID'} || $Groff{'LD'} || $Groff{'NH'} ||
-      $Groff{'TH_later'} ||
-      $Groff{'TL'} || $Groff{'UL'} || $Groff{'XP'}
-     ) {
-    $Groff{'ms'} = 1;
-    push(@m, '-ms');
-
-    $tmac_ext = 'ms' unless ( $tmac_ext );
-    &err('ms requests found, but file name extension ' .
-	 'was: ' . $tmac_ext) unless ( $tmac_ext eq 'ms' );
-    $tmac_ext = 'ms';
-    return 1;	# true
-  }
-
-###### make_groff_tmac_man_ms()
-
-  # both 'man' and 'ms' requests
-  if ( $Groff{'P'} || $Groff{'IP'}  ||
-       $Groff{'LP'} || $Groff{'PP'} || $Groff{'SH'} ) {
-    if ( $tmac_ext eq 'man' ) {
-      $Groff{'man'} = 1;
-      push(@m, '-man');
-      return 1;	# true
-    } elsif ( $tmac_ext eq 'ms' ) {
-      $Groff{'ms'} = 1;
-      push(@m, '-ms');
-      return 1;	# true
-    }
-    return 0;
-  }
-} # make_groff_tmac_man_ms()
-
-
-
-########################################################################
-# make_groff_tmac_others()
-########################################################################
-
-sub make_groff_tmac_others {
-  # globals: @filespec, $tmac_ext, %Groff
-
-  # mdoc
-  if ( ( $Groff{'Oo'} && $Groff{'Oc'} ) || $Groff{'Dd'} ) {
-    $Groff{'Oc'} = 0;
-    $Groff{'Oo'} = 0;
-    push(@m, '-mdoc');
-    return 1;	# true
-  }
-  if ( $Groff{'mdoc_old'} || $Groff{'Oo'} ) {
-    push(@m, '-mdoc_old');
-    return 1;	# true
-  }
-
-  # me
-  if ( $Groff{'me'} ) {
-    push(@m, '-me');
-    return 1;	# true
-  }
-
-##### make_groff_tmac_others()
-  # mm and mmse
-  if ( $Groff{'mm'} ) {
-    push(@m, '-mm');
-    return 1;	# true
-  }
-  if ( $Groff{'mmse'} ) {	# Swedish mm
-    push(@m, '-mmse');
-    return 1;	# true
-  }
-
-  # mom
-  if ( $Groff{'mom'} ) {
-    push(@m, '-mom');
-    return 1;	# true
-  }
-} # make_groff_tmac_others()
-
-
-########################################################################
-# make_groff_line_rest()
-########################################################################
-
-sub make_groff_line_rest {
-  my $file_args_included;	# file args now only at 1st preproc
-  unshift @Command, 'groff';
-  if ( @preprograms ) {
-    my @progs;
-    $progs0 = shift @preprograms;
-    push(@progs, @filespec);
-    for ( @preprograms ) {
-      push @progs, '|';
-      push @progs, $_;
-    }
-    push @progs, '|';
-    unshift @Command, @progs;
-    $file_args_included = 1;
-  } else {
-    $file_args_included = 0;
-  }
-
-###### make_groff_line_rest()
-  foreach (@Command) {
-    next unless /\s/;
-    # when one argument has several words, use accents
-    $_ = "'" . $_ . "'";
-  }
-
-
-###### make_groff_line_rest()
-  ##########
-  # -m arguments
-  my $nr_m_guessed = scalar @m;
-  if ( $nr_m_guessed > 1 ) {
-    print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-      'argument for -m found: ' . @m;
-  }
-
-
-  my $nr_m_args = scalar @Mparams;	# m-arguments for grog
-  my $last_m_arg = '';	# last provided -m option
-  if ( $nr_m_args > 1 ) {
-    # take the last given -m argument of grog call,
-    # ignore other -m arguments and the found ones
-    $last_m_arg = $Mparams-1;	# take the last -m argument
-    print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-      $Prog . ": more than 1 '-m' argument: @Mparams";
-    print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-      'We take the last one: ' . $last_m_arg;
-  } elsif ( $nr_m_args == 1 ) {
-    $last_m_arg = $Mparams0;
-  }
-
-###### make_groff_line_rest()
-  my $final_m = '';
-  if ( $last_m_arg ) {
-    my $is_equal = 0;
-    for ( @m ) {
-      if ( $_ eq $last_m_arg ) {
-	$is_equal = 1;
-	last;
-      }
-      next;
-    }	# end for @m
-    if ( $is_equal ) {
-      $final_m = $last_m_arg;
-    } else {
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	'Provided -m argument ' . $last_m_arg .
-	  ' differs from guessed -m args: ' . @m;
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	'The argument is taken.';
-      $final_m = $last_m_arg;
-    }
-###### make_groff_line_rest()
-  } else {	# no -m arg provided
-    if ( $nr_m_guessed > 1 ) {
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' .
-	'More than 1 -m arguments were guessed: ' . @m;
-      print STDERR __FILE__ . ' ' .  __LINE__ . ': ' . 'Guessing stopped.';
-      exit 1;
-    } elsif ( $nr_m_guessed == 1 ) {
-      $final_m = $m0;
-    } else {
-      # no -m provided or guessed
-    }
-  }
-  push @Command, $final_m if ( $final_m );
-
-  push(@Command, @filespec) unless ( $file_args_included );
-
-  #########
-  # execute the 'groff' command here with option '--run'
-  if ( $do_run ) { # with --run
-    print STDERR __FILE__ . ' ' .  __LINE__ . ': ' . "@Command";
-    my $cmd = join ' ', @Command;
-    system($cmd);
-  } else {
-    print "@Command";
-  }
-
-  exit 0;
-} # make_groff_line_rest()
-
-
-########################################################################
-# sub help
-########################################################################
-
-sub help {
-  print <<EOF;
-usage: grog option... -- filespec...
-
-"filespec" is either the name of an existing, readable file or "-" for
-standard input.  If no 'filespec' is specified, standard input is
-assumed automatically.  All arguments after a '--' are regarded as file
-names, even if they start with a '-' character.
-
-'option' is either a 'groff' option or one of these:
-
--h|--help	print this uasge message and exit
--v|--version	print version information and exit
-
--C		compatibility mode
---ligatures	include options '-P-y -PU' for internal font, which
-		preserves the ligatures like 'fi'
---run		run the checked-out groff command
---warnings	display more warnings to standard error
-
-All other options should be 'groff' 1-character options.  These are then
-appended to the generated 'groff' command line.  The '-m' options will
-be checked by 'grog'.
-
-EOF
-  exit 0;
-} # help()
-
-
-########################################################################
-# sub version
-########################################################################
-
-sub version {
-  our %at_at;
-  print "Perl version of GNU $Prog " .
-    "in groff version " . $at_at{'GROFF_VERSION'};
-  exit 0;
-} # version()
-
-
-1;
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: CPerl
-# End:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/a4.tmac Deleted

_service:tar_scm:groff-1.22.4.tar.gz/tmac/an-old.tmac Deleted

@@ -1,708 +0,0 @@
-.\" an-old.tmac
-.\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
-.\"      Written by James Clark (jjc@jclark.com)
-.\"
-.\" 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
-.\" the Free Software Foundation, either version 3 of the License, or
-.\" (at your option) any later version.
-.\"
-.\" 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 this program.  If not, see
-.\" <http://www.gnu.org/licenses/>.
-.\"
-.\"  -rcR=1 => Create a single, very long page instead of multiple
-.\"            pages.  Useful for online display.  Default in nroff
-.\"            mode.  Deactivate with -rcR=0.
-.\"  -rC1 => Number pages continuously, rather than start each at 1.
-.\"  -rD1 => Double-sided printing, ie different odd and even page
-.\"          footers.
-.\"  -rPnnn => Number first page nnn.
-.\"  -rSxx => Use size 'xx'pt (either 10, 11, or 12) for document rather
-.\"           than the default size of 10pt.
-.\"  -rXnnn => Number pages after nnn as nnna, nnnb, nnnc, ...
-.\"
-.\" The file man.local is loaded at the end.  Put local additions there.
-.\" If you need to add things to TH, use '.am1 TH'.
-.\"
-.
-.if !\n(.g .ab These man macros work only with groff.
-.
-.do if d RI .nx
-.
-.do mso devtag.tmac
-.
-.nr _C \n(.C
-.cp 0
-.
-.if (\n.x\n.y < 118) \
-.  ab You need GNU troff 1.18 or higher to run this version of man!
-.
-.\" Define a string for use in diagnostic messages.
-.ds an-old an-old.tmac
-.
-.if !r D .nr D 0
-.if !r C .nr C 0
-.if !r S .nr S 10
-.\" We must use consecutive page numbers when using PostScript to
-.\" generate HTML images, and we must not reset the page number at the
-.\" beginning (the 'ps4html' register is automatically added to the
-.\" command line by the pre-HTML preprocessor).
-.if !r ps4html \
-.  if r P .pn 0\nP
-.if !r cR \{\
-.  ie n .nr cR 1
-.  el   .nr cR 0
-.\}
-.
-.nr need_eo_h 0
-.nr need_col2 0
-.
-.\" set up the line length...
-.\" giving precedence to any prior assignment to the \nLL register.
-.if !r LL \{\
-.
-.  \" but if that isn't predefined...
-.  \" then try to respect any prior '.ll' request.
-.  nr LL \n.l
-.
-.  \" For troff, this is sufficient to give us a default line length of
-.  \" 6.5i, but for nroff, we prefer a default of 78n to nroff's default
-.  \" 65n.  This has the unfortunate side effect that we will override a
-.  \" user's '.ll 65n' request, with our preferred 78n default; we can't
-.  \" possibly know that the 65n came from a '.ll' request, and MUST
-.  \" assume that it was set by nroff, as its built-in default!  If the
-.  \" user wants to force this setting, then he MUST use the '-rLL=65n'
-.  \" option, or an equivalent '.nr LL 65n' request.
-.  if n \
-.    if (\nLL = 65n) \
-.      nr LL 78n
-.\}
-.
-.if !r LT \
-.  nr LT \nLL
-.
-.nr FT (-.5i)
-.
-.\" Default heading font
-.ds HF B\"
-.
-.nr an-first 1
-.
-.nr an-html 0
-.if '\*.T'html' .nr an-html 1
-.if \nan-html .nr C 1
-.if r ps4html .nr C 1
-.
-.\" We redefine .ne to avoid page breaks if cR is set; instead, the page
-.\" length is increased to the necessary amount (this is needed for
-.\" tables).
-.\"
-.\" Similarly, we redefine .bp if cR is set, adjusting the page length
-.\" to the current position so that no empty lines are inserted.
-.if \ncR \{\
-.  de1 ne
-.    ie \\n.$ \
-.      nr an-ne (v;\\$*)
-.    el \
-.      nr an-ne 1v
-.    if (\\nan-ne >= \\n.t) \
-.      pl +(\\nan-neu - \\n.tu + 1v)
-.  .
-.
-.  rn bp an-bp
-.  de1 bp
-.    br
-.    pl \\nnlu
-.    an-bp \\$*
-.  .
-.\}
-.
-.de set-an-margin
-.  nr an-level 1
-.  nr an-margin \\nIN
-.  nr an-saved-margin1 \\nIN
-.  nr an-prevailing-indent \\nIN
-.  nr an-saved-prevailing-indent1 \\nIN
-..
-.
-.ds an-extra1
-.ds an-extra2
-.ds an-extra3
-.
-.\" .TH title section extra1 extra2 extra3
-.de1 TH
-.  if \\nan-html \{\
-.    DEVTAG-TL
-.    nop \\$1
-.    DEVTAG-EO-TL
-.  \}
-.
-.  de an-init \" This approach gets multiple man pages right.
-.    ds an-title "\\$1\"
-.    ds an-section "\\$2\"
-.    ds an-extra1 "\\$3\"
-.    ie (\\n.$ > 3)    .ds an-extra2 "\\$4\"
-.    el                  .ds an-extra2 \"Sun Release 4.0
-.
-.    ie (\\n.$ > 4)    .ds an-extra3 "\\$5\"
-.    el \{ .ie '\\$2'1'  .ds an-extra3 General Commands Manual
-.    el \{ .ie '\\$2'2'  .ds an-extra3 System Calls Manual
-.    el \{ .ie '\\$2'3'  .ds an-extra3 Library Functions Manual
-.    el \{ .ie '\\$2'3p' .ds an-extra3 Perl Programmers Reference Guide
-.    el \{ .ie '\\$2'4'  .ds an-extra3 Kernel Interfaces Manual
-.    el \{ .ie '\\$2'5'  .ds an-extra3 File Formats Manual
-.    el \{ .ie '\\$2'6'  .ds an-extra3 Games Manual
-.    el \{ .ie '\\$2'7'  .ds an-extra3 Miscellaneous Information Manual
-.    el \{ .ie '\\$2'8'  .ds an-extra3 System Manager's Manual
-.    el \{ .ie '\\$2'9'  .ds an-extra3 Kernel Developer's Manual
-.    el                  .ds an-extra3
-.    \}\}\}\}\}\}\}\}\}\}
-.    ds an-init
-\\..
-.
-.  DT
-.
-.  nr PS    10z \" default point size
-.  nr PS-SS 10z
-.  nr PS-SH 10.95z
-.  nr VS    12p
-.
-.  \" use sizes similar to LaTeX
-.  if t \{\
-.    ie (\\nS == 11) \{\
-.      nr PS    10.95z
-.      nr PS-SS 10.95z
-.      nr PS-SH 12z
-.      nr VS    13.6p
-.    \}
-.    el \{\
-.      if (\\nS == 12) \{\
-.        nr PS    12z
-.        nr PS-SS 12z
-.        nr PS-SH 14.4z
-.        nr VS    14.5p
-.      \}
-.    \}
-.  \}
-.
-.  ps \\nPSu
-.  vs \\nVSu
-.  ll \\nLLu
-.
-.\" We must select an integer indentation value for nroff;
-.\" see comment in an-do-tag.
-.  if !r IN \{\
-.    ie t .nr IN 7.2n
-.    el   .nr IN 7n
-.  \}
-.  PD
-.  if !r SN \
-.    nr SN 3n \" indentation of sub-sub-headings relative to sub-heads
-.  set-an-margin
-.  nr an-tag-sep 1n
-.
-.  nr an-no-space-flag 0
-.  nr an-break-flag 0
-.  nr an-div? 0
-.
-.  ie \\ncR \
-.    an-header
-.  el \{\
-.    wh 0 an-header
-.    wh -1i an-footer
-.    wh \\nFTu an-p-footer
-.
-.    if \\nnl \{\
-.      ie \\nC .bp (\\n% + 1)
-.      el        .bp 1
-.    \}
-.  \}
-..
-.
-.\" BSD compatibility macros: .AT and .UC
-.
-.de1 AT
-.  ds an-extra2 "7th Edition\"
-.  if "\\$1"3" .ds an-extra2 "7th Edition\"
-.  if "\\$1"4" .ds an-extra2 "System III\"
-.  if "\\$1"5" \{\
-.    ie "\\$2"" .ds an-extra2 "System V\"
-.    el .ds an-extra2 "System V Release \\$2\"
-.  \}
-..
-.
-.de1 UC
-.  ds an-extra2 "3rd Berkeley Distribution\"
-.  if "\\$1"3" .ds an-extra2 "3rd Berkeley Distribution\"
-.  if "\\$1"4" .ds an-extra2 "4th Berkeley Distribution\"
-.  if "\\$1"5" .ds an-extra2 "4.2 Berkeley Distribution\"
-.  if "\\$1"6" .ds an-extra2 "4.3 Berkeley Distribution\"
-.  if "\\$1"7" .ds an-extra2 "4.4 Berkeley Distribution\"
-..
-.
-.de1 DT
-.  ta T .5i \" This sets tabs every .5 inches
-..
-.
-.de1 PD
-.  ie \\n.$ .nr PD (v;\\$1)
-.  el         .nr PD (.4v >? \n.V)
-..
-.
-.\" Redefine these to customize the header & footer
-.
-.de1 PT
-.  tl '\\*an-title(\\*an-section)'\\*an-extra3'\\*an-title(\\*an-section)'
-..
-.
-.de1 BT
-.  if r ps4html \
-.    return
-.  ie \\nD \{\
-.    if o .tl '\\*an-extra2'\\*an-extra1'\\*an-page-string'
-.    if e .tl '\\*an-page-string'\\*an-extra1'\\*an-extra2'
-.  \}
-.  el \
-.    tl '\\*an-extra2'\\*an-extra1'\\*an-page-string'
-..
-.
-.de1 an-header
-.  an-init
-.  if \\ncR \{\
-.    ie \\nan-first \
-.      nr an-first 0
-.    el \
-.      sp .5i
-.  \}
-.  ev an-1
-.  ps \\nPSu
-.  vs \\nVSu
-.  lt \\nLTu
-.  ie \\nan-html \
-.    tl ''''
-.  el \{\
-.    if !\\ncR \
-.      sp .5i
-.    PT
-.    ie !\\ncR \
-.      sp |1i
-.    el \
-.      sp .5i
-.  \}
-.  ev
-.  ns
-..
-.
-.de1 an-footer
-'  bp
-..
-.
-.af an-page-letter a
-.
-.de1 an-p-footer
-.  ev an-1
-.  ps \\nPSu
-.  vs \\nVSu
-.  lt \\nLTu
-.  ie \\nan-html \{\
-.    ds an-page-string
-.    ds an-extra1
-.    ds an-extra2
-.  \}
-.  el \{\
-.    ie r X \{\
-.      if (\\n% > \\nX) \{\
-.        nr an-page-letter (\\n% - \\nX)
-.        ds an-page-string \\nX\\nan-page-letter\"
-.      \}
-.    \}
-.    el \{\
-.      ie \\ncR \
-.        ds an-page-string "\\*an-title(\\*an-section)\"
-.      el \
-.        ds an-page-string \\n%\"
-.    \}
-.  \}
-.  BT
-.  ev
-..
-.
-.de1 an-end
-.  nr % 1
-.  pl +4v
-.  fl
-.  sp 3
-.  an-p-footer
-.  pl \\nnlu
-..
-.
-.if \ncR .em an-end
-.
-.de1 SH
-.  sp \\nPDu
-.  set-an-margin
-.  fi
-.  in \\nan-marginu
-.  ti 0
-.  nr need_eo_h 1
-.  DEVTAG-NH \\nan-level
-.  itc 1 an-trap
-.  nr an-no-space-flag 1
-.  nr an-break-flag 1
-.  ps \\nPS-SHu
-.  ft \\*HF
-.  ne (2v + 1u)
-.  if \\n.$ \&\\$*
-..
-.
-.de1 SS
-.  sp \\nPDu
-.  set-an-margin
-.  fi
-.  in \\nINu
-.  ti \\nSNu
-.  itc 1 an-trap
-.  nr an-no-space-flag 1
-.  nr an-break-flag 1
-.  ps \\nPS-SSu
-.  ft \\*HF
-.  ne (2v + 1u)
-.  if \\n.$ \&\\$*
-..
-.
-.de1 B
-.  itc 1 an-trap
-.  ft B
-.  if \\n.$ \&\\$*
-..
-.
-.de1 I
-.  itc 1 an-trap
-.  ft I
-.  if \\n.$ \,\\$*\/
-..
-.
-.de1 SM
-.  itc 1 an-trap
-.  ps -1
-.  if \\n.$ \&\\$*
-..
-.
-.de1 SB
-.  itc 1 an-trap
-.  ps -1
-.  ft B
-.  if \\n.$ \&\\$*
-..
-.
-.de1 TP
-.  sp \\nPDu
-.  if \\n.$ .nr an-prevailing-indent (n;\\$1)
-.  itc 1 an-trap
-.  in 0
-.  if !\\nan-div? \{\
-.    ll -\\nan-marginu
-.    di an-div
-.  \}
-.  nr an-div? 1
-..
-.
-.de1 an-trap
-.  if \\nneed_eo_h>0 .DEVTAG-EO-H
-.  nr need_eo_h 0
-.  if \\nneed_col2>0 .DEVTAG-COL 2
-.  nr need_col2 0
-.  ft R
-.  ps \\nPSu
-.  vs \\nVSu
-.  if \\nan-break-flag \{\
-.    br
-.    nr an-break-flag 0
-.  \}
-.  if \\nan-no-space-flag \{\
-.    ns
-.    nr an-no-space-flag 0
-.  \}
-.  if \\nan-div? .an-do-tag
-..
-.
-.de an-do-tag
-.  br
-.  di
-.  nr an-div? 0
-.  ll
-.  \" We must emit the diversion in a separate environment to assure
-.  \" that a possible margin character is printed correctly.
-.  ev an-2
-.  evc 0
-.  mc
-.  nf
-.  in \\nan-marginu
-.  ie (\\ndl + \\nan-tag-sep > \\nan-prevailing-indent) \{\
-.    ne (2v + 1u)
-.    an-div
-.    ev
-.    in (\\nan-marginu + \\nan-prevailing-indentu)
-.  \}
-.  el \{\
-.    \" In nroff mode, the indentation value should be an integer
-.    \" multiple of the character cell, to avoid different results
-.    \" compared to the .ie part above.
-.    ne (1v + 1u)
-.    DEVTAG-COL 1
-.    an-div
-.    sp -1
-.    ev
-.    in (\\nan-marginu + \\nan-prevailing-indentu)
-.    DEVTAG-COL-NEXT 2
-.  \}
-..
-.
-.de1 LP
-.  sp \\nPDu
-.  ps \\nPSu
-.  vs \\nVSu
-.  ft R
-.  in \\nan-marginu
-.  nr an-prevailing-indent \\nIN
-.  ns
-..
-.
-.als PP LP
-.als P LP
-.
-.de1 IP
-.  ie !\\n.$ \{\
-.    ps \\nPSu
-.    vs \\nVSu
-.    ft R
-.    sp \\nPDu
-.    ne (1v + 1u)
-.    in (\\nan-marginu + \\nan-prevailing-indentu)
-.    ns
-.  \}
-.  el \{\
-.    ie (\\n.$ - 1) .TP "\\$2"
-.    el               .TP
-\&\\$1
-.  \}
-..
-.
-.de1 HP
-.  ps \\nPSu
-.  vs \\nVSu
-.  ft R
-.  sp \\nPDu
-.  ne (1v + 1u)
-.  if \\n.$ .nr an-prevailing-indent (n;\\$1)
-.  in (\\nan-marginu + \\nan-prevailing-indentu)
-.  ti \\nan-marginu
-.  DEVTAG-COL 1
-.  nr need_col2 1
-.  ns
-..
-.
-.ds an-empty \" this is referenced to avoid looping on, e.g., .RB ( \\ )
-.
-.de1 RI
-.  if \\n.$ \{\
-.    ds an-result \&\fR\\$1\"
-.    shift
-.    while (\\n.$ >= 2) \{\
-.      as an-result \,\fI\\$1\fR\/\\$2\\*an-empty\"
-.      shift 2
-.    \}
-.    if \\n.$ .as an-result \,\fI\\$1\"
-\\*an-result
-.    ft R
-.  \}
-..
-.
-.de1 IR
-.  if \\n.$ \{\
-.    ds an-result \&\fI\,\\$1\fR\"
-.    shift
-.    while (\\n.$ >= 2) \{\
-.      as an-result \/\\$1\fI\,\\$2\fR\"
-.      shift 2
-.    \}
-.    if \\n.$ .as an-result \/\\$1\"
-\\*an-result
-.    ft R
-.  \}
-..
-.
-.de1 IB
-.  if \\n.$ \{\
-.    ds an-result \&\fI\,\\$1\"
-.    shift
-.    while (\\n.$ >= 2) \{\
-.      as an-result \/\fB\\$1\fI\,\\$2\\*an-empty\"
-.      shift 2
-.    \}
-.    if \\n.$ .as an-result \/\fB\\$1\"
-\\*an-result
-.    ft R
-.  \}
-..
-.
-.de1 BI
-.  if \\n.$ \{\
-.    ds an-result \&\fB\\$1\"
-.    shift
-.    while (\\n.$ >= 2) \{\
-.      as an-result \,\fI\\$1\fB\/\\$2\\*an-empty\"
-.      shift 2
-.    \}
-.    if \\n.$ .as an-result \,\fI\\$1\"
-\\*an-result
-.    ft R
-.  \}
-..
-.
-.de1 RB
-.  ds an-result \&\"
-.  while (\\n.$ >= 2) \{\
-.    as an-result \fR\\$1\fB\\$2\\*an-empty\"
-.    shift 2
-.  \}
-.  if \\n.$ .as an-result \fR\\$1\"
-\\*an-result
-.  ft R
-..
-.
-.de1 BR
-.  ds an-result \&\"
-.  while (\\n.$ >= 2) \{\
-.    as an-result \fB\\$1\fR\\$2\\*an-empty\"
-.    shift 2
-.  \}
-.  if \\n.$ .as an-result \fB\\$1\"
-\\*an-result
-.  ft R
-..
-.
-.de1 RS
-.  nr an-saved-margin\\nan-level \\nan-margin
-.  nr an-saved-prevailing-indent\\nan-level \\nan-prevailing-indent
-.  ie \\n.$ .nr an-margin +(n;\\$1)
-.  el         .nr an-margin +\\nan-prevailing-indent
-.  in \\nan-marginu
-.  nr an-prevailing-indent \\nIN
-.  nr an-level +1
-..
-.
-.de1 RE
-.  ie \\n.$ .nr an-level ((;\\$1) <? \\nan-level)
-.  el         .nr an-level -1
-.  nr an-level (1 >? \\nan-level)
-.  nr an-margin \\nan-saved-margin\\nan-level
-.  nr an-prevailing-indent \\nan-saved-prevailing-indent\\nan-level
-.  in \\nan-marginu
-..
-.
-.\" table support
-.
-.de1 TS
-.  sp \\nPDu
-.  if \\nan-html \{\
-.    nr an-TS-ll \\n.l
-.    ll 1000n
-.  \}
-.  HTML-IMAGE
-..
-.
-.de1 T&
-..
-.
-.de1 TE
-.  HTML-IMAGE-END
-.  if \\nan-html \
-.    ll \\nan-TS-llu
-..
-.
-.\" dummy equation delimiters
-.de1 EQ
-.  if \\nan-html \{\
-.    nr an-EQ-ll \\n.l
-.    ll 1000n
-.  \}
-.  HTML-IMAGE
-..
-.de1 EN
-.  HTML-IMAGE-END
-.  if \\nan-html \
-.    ll \\nan-EQ-llu
-..
-.
-.de1 R
-\c
-.  ie \\n.$ \{\
-.    tmc \\*an-old: \\n.F: line \\n.c: 'R' is a string
-.    tm1 " (producing the registered sign), not a macro.
-.    nop \\$*
-.  \}
-.  el \{\
-.    ie c\rg \
-.      nop \rg\c
-.    el \
-.      nop (Reg.)\c
-.  \}
-..
-.
-.\" These strings must work in compatibility mode also.
-.
-.ds S \s'\\n(PSu'\"
-.ie c\tm .ds Tm \(tm\"
-.el        .ds Tm (TM)\"
-.ds lq \(lq\"
-.ds rq \(rq\"
-.
-.if !\nan-html \{\
-.  if !rHY \{\
-.    ie \ncR \
-.      nr HY 4
-.    el \
-.      nr HY 6
-.  \}
-.  hy \nHY
-.\}
-.
-.\" For UTF-8, map some characters conservatively for the sake
-.\" of easy cut and paste.
-.
-.if '\*.T'utf8' \{\
-.  rchar \- - ' `
-.
-.  char \- \N'45'
-.  char  - \N'45'
-.  char  ' \N'39'
-.  char  ` \N'96'
-.\}
-.
-.\" Load man macro extensions.
-.mso an-ext.tmac
-.
-.\" Load local modifications.
-.mso man.local
-.
-.cp \n_C
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc-common-u Deleted

@@ -1,1384 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\"   The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc-common	8.1 (Berkeley) 06/08/93
-.\"
-.\"     %beginstrip%
-.
-.
-.\" Macro Identifiers.  For each user macro a corresponding register
-.\" with the same name must exist.  Its value must not be zero.
-.
-.nr %A 1
-.nr %B 1
-.nr %C 1
-.nr %D 1
-.nr %I 1
-.nr %J 1
-.nr %N 1
-.nr %O 1
-.nr %P 1
-.nr %Q 1
-.nr %R 1
-.nr %T 1
-.nr %U 1
-.nr %V 1
-.nr Ac 3
-.nr Ad 12n
-.nr An 12n
-.nr Ao 12n
-.nr Ap 2
-.nr Aq 12n
-.nr Ar 12n
-.nr At 1
-.nr Bc 3
-.nr Bf 8n\" ?
-.nr Bk 8n\" ?
-.nr Bl 1
-.nr Bo 12n
-.nr Bq 12n
-.nr Brc 3
-.nr Bro 12n
-.nr Brq 12n
-.nr Bsx 1
-.nr Bt 8n\" ?
-.nr Bx 1
-.nr Cd 12n
-.nr Cm 10n
-.nr D1 8n\" ?
-.nr Dc 3
-.nr Dl 8n\" ?
-.nr Dt 8n\" ?
-.nr Do 12n
-.nr Dq 12n
-.nr Ds 6n\" many manpages still use this as a -width value
-.nr Dv 12n
-.nr Dx 1
-.nr Ec 3
-.nr Ef 8n\" ?
-.nr Ek 8n\" ?
-.nr El 1
-.nr Em 10n
-.nr En 12n
-.nr Eo 12n
-.nr Eq 12n
-.nr Er 17n
-.nr Es 12n
-.nr Ev 15n
-.nr Ex 1
-.nr Fa 12n
-.nr Fc 3
-.nr Fd 12n\" ?
-.nr Fl 10n
-.nr Fn 16n
-.nr Fo 16n
-.nr Fr 12n\" ?
-.nr Ft 8n\" ?
-.nr Fx 1
-.nr Ic 10n
-.nr In 12n
-.nr It 8n\" ?
-.nr Lb 11n
-.nr Li 16n
-.nr Lk 6n\" ?
-.nr Lp 8n\" ?
-.nr Me 6n
-.nr Ms 6n
-.nr Mt 6n\" ?
-.nr Nd 8n\" ?
-.nr Nm 10n
-.nr No 12n
-.nr Ns 2
-.nr Nx 1
-.nr Oc 3
-.nr Oo 10n
-.nr Op 14n
-.nr Os 6n\" ?
-.nr Ox 1
-.nr Pa 32n
-.nr Pc 3
-.nr Pf 12n
-.nr Po 12n
-.nr Pp 8n\" ?
-.nr Pq 12n
-.nr Qc 3
-.nr Ql 16n
-.nr Qo 12n
-.nr Qq 12n
-.nr Rv 1
-.nr Sc 3
-.nr Sh 8n
-.nr Sm 8n\" ?
-.nr So 12n
-.nr Sq 12n
-.nr Ss 8n
-.nr St 8n\" ?
-.nr Sx 16n
-.nr Sy 6n
-.nr Ta 2
-.nr Tn 10n
-.nr Ud 8n\" ?
-.nr Ux 1
-.nr Va 12n
-.nr Vt 8n\" ?
-.nr Xc 3
-.nr Xo 1
-.nr Xr 10n
-.
-.
-.\" macros which must be processed after the closing delimiter of 'Op'
-.\" and friends
-.ds doc-after-Ao
-.ds doc-after-Bo
-.ds doc-after-Bro
-.ds doc-after-Do
-.ds doc-after-Eo
-.ds doc-after-Fo
-.ds doc-after-Ns
-.ds doc-after-Oo
-.ds doc-after-Po
-.ds doc-after-Qo
-.ds doc-after-So
-.ds doc-after-Xo
-.
-.
-.nr doc-display-indent 6n
-.
-.
-.\" space strings
-.
-.ds doc-soft-space " \"
-.ds doc-hard-space \~
-.ds doc-tab \t
-.
-.
-.eo
-.
-.
-.\" punctuation values (suffix=3, prefix=4)
-.
-.nr doc-punct. 3
-.nr doc-punct, 3
-.nr doc-punct: 3
-.nr doc-punct; 3
-.nr doc-punct( 4
-.nr doc-punct) 3
-.nr doc-punct 4
-.nr doc-punct 3
-.nr doc-punct? 3
-.nr doc-punct! 3
-.
-.
-.\" header assembly macros
-.
-.\" NS doc-document-title global string
-.\" NS   the title of the manual page
-.
-.ds doc-document-title UNTITLED
-.
-.
-.\" NS doc-volume global string
-.\" NS   the volume where the manual page belongs to
-.
-.ds doc-volume LOCAL
-.
-.
-.\" NS doc-section global string
-.\" NS   the manual section
-.
-.ds doc-section Null
-.
-.
-.\" NS Dt user macro (not parsed, not callable)
-.\" NS   document title
-.\" NS
-.\" NS modifies:
-.\" NS   doc-document-title
-.\" NS   doc-section
-.\" NS   doc-volume
-.\" NS   doc-command-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-volume-as-XXX
-.\" NS   doc-volume-ds-XXX
-.\" NS
-.\" NS width register 'Dt' set above
-.
-.\" an alternative, more detailed scheme for naming the manual sections
-.\"
-.ds doc-volume-operating-system BSD
-.nr doc-volume-operating-system-ateol 0
-.ds doc-volume-ds-1 General Commands Manual
-.ds doc-volume-ds-2 System Calls Manual
-.ds doc-volume-ds-3 Library Functions Manual
-.ds doc-volume-ds-4 Kernel Interfaces Manual
-.ds doc-volume-ds-5 File Formats Manual
-.ds doc-volume-ds-6 Games Manual
-.ds doc-volume-ds-7 Miscellaneous Information Manual
-.ds doc-volume-ds-8 System Manager's Manual
-.ds doc-volume-ds-9 Kernel Developer's Manual
-.
-.ds doc-volume-ds-USD   User's Supplementary Documents
-.ds doc-volume-ds-PS1   Programmer's Supplementary Documents
-.ds doc-volume-ds-AMD   Ancestral Manual Documents
-.ds doc-volume-ds-SMM   System Manager's Manual
-.ds doc-volume-ds-URM   User's Reference Manual
-.ds doc-volume-ds-PRM   Programmer's Manual
-.ds doc-volume-ds-KM    Kernel Manual
-.ds doc-volume-ds-IND   Manual Master Index
-.ds doc-volume-ds-LOCAL Local Manual
-.ds doc-volume-ds-CON   Contributed Software Manual
-.
-.als doc-volume-ds-MMI doc-volume-ds-IND
-.als doc-volume-ds-LOC doc-volume-ds-LOCAL
-.
-.ds doc-volume-as-alpha        alpha
-.als doc-volume-as-Alpha doc-volume-as-alpha
-.ds doc-volume-as-acorn26      acorn26
-.ds doc-volume-as-acorn32      acorn32
-.ds doc-volume-as-algor        algor
-.ds doc-volume-as-amd64        amd64
-.ds doc-volume-as-amiga        amiga
-.ds doc-volume-as-amigappc     amigappc
-.ds doc-volume-as-arc          arc
-.ds doc-volume-as-arm          arm
-.ds doc-volume-as-arm26        arm26
-.ds doc-volume-as-arm32        arm32
-.ds doc-volume-as-armish       armish
-.ds doc-volume-as-atari        atari
-.ds doc-volume-as-aviion       aviion
-.ds doc-volume-as-beagle       beagle
-.ds doc-volume-as-bebox        bebox
-.ds doc-volume-as-cats         cats
-.ds doc-volume-as-cesfic       cesfic
-.ds doc-volume-as-cobalt       cobalt
-.ds doc-volume-as-dreamcast    dreamcast
-.ds doc-volume-as-emips        emips
-.ds doc-volume-as-evbarm       evbarm
-.ds doc-volume-as-evbmips      evbmips
-.ds doc-volume-as-evbppc       evbppc
-.ds doc-volume-as-evbsh3       evbsh3
-.ds doc-volume-as-ews4800mips  ews4800mips
-.ds doc-volume-as-hp300        hp300
-.ds doc-volume-as-hp700        hp700
-.ds doc-volume-as-hpcarm       hpcarm
-.ds doc-volume-as-hpcmips      hpcmips
-.ds doc-volume-as-hpcsh        hpcsh
-.ds doc-volume-as-hppa         hppa
-.ds doc-volume-as-hppa64       hppa64
-.ds doc-volume-as-i386         i386
-.ds doc-volume-as-ia64         ia64
-.ds doc-volume-as-ibmnws       ibmnws
-.ds doc-volume-as-iyonix       iyonix
-.ds doc-volume-as-landisk      landisk
-.ds doc-volume-as-loongson     loongson
-.ds doc-volume-as-luna68k      luna68k
-.ds doc-volume-as-luna88k      luna88k
-.ds doc-volume-as-m68k         m68k
-.ds doc-volume-as-mac68k       mac68k
-.ds doc-volume-as-macppc       macppc
-.ds doc-volume-as-mips         mips
-.ds doc-volume-as-mips64       mips64
-.ds doc-volume-as-mipsco       mipsco
-.ds doc-volume-as-mmeye        mmeye
-.ds doc-volume-as-mvme68k      mvme68k
-.ds doc-volume-as-mvme88k      mvme88k
-.ds doc-volume-as-mvmeppc      mvmeppc
-.ds doc-volume-as-netwinder    netwinder
-.ds doc-volume-as-news68k      news68k
-.ds doc-volume-as-newsmips     newsmips
-.ds doc-volume-as-next68k      next68k
-.ds doc-volume-as-ofppc        ofppc
-.ds doc-volume-as-palm         palm
-.ds doc-volume-as-pc532        pc532
-.ds doc-volume-as-playstation2 playstation2
-.ds doc-volume-as-pmax         pmax
-.ds doc-volume-as-pmppc        pmppc
-.ds doc-volume-as-powerpc      powerpc
-.ds doc-volume-as-prep         prep
-.ds doc-volume-as-rs6000       rs6000
-.ds doc-volume-as-sandpoint    sandpoint
-.ds doc-volume-as-sbmips       sbmips
-.ds doc-volume-as-sgi          sgi
-.ds doc-volume-as-sgimips      sgimips
-.ds doc-volume-as-sh3          sh3
-.ds doc-volume-as-shark        shark
-.ds doc-volume-as-socppc       socppc
-.ds doc-volume-as-solbourne    solbourne
-.ds doc-volume-as-sparc        sparc
-.ds doc-volume-as-sparc64      sparc64
-.ds doc-volume-as-sun2         sun2
-.ds doc-volume-as-sun3         sun3
-.ds doc-volume-as-tahoe        tahoe
-.ds doc-volume-as-vax          vax
-.ds doc-volume-as-x68k         x68k
-.ds doc-volume-as-x86_64       x86_64
-.ds doc-volume-as-xen          xen
-.ds doc-volume-as-zaurus       zaurus
-.
-.de Dt
-.  \" reset default arguments
-.  ds doc-document-title UNTITLED
-.  ds doc-volume LOCAL
-.  ds doc-section Null
-.  ds doc-command-name
-.
-.  if !"\$1"" \
-.    ds doc-document-title "\$1
-.
-.  if !"\$2"" \{\
-.    ds doc-section \$2
-.    ie \B&#x7;\$2&#x7; \{\
-.      if ((\$2 >= 1) & (\$2 <= 9)) \{\
-.        ie \ndoc-volume-operating-system-ateol \{\
-.          ds doc-volume "\*doc-volume-ds-\$2 \*doc-volume-operating-system
-.          if \A&#x7;\$3&#x7; \{\
-.            if d doc-volume-as-\$3 \
-.              as doc-volume "/\*doc-volume-as-\$3
-.        \}\}
-.        el \{\
-.          ds doc-volume "\*doc-volume-operating-system
-.          if \A&#x7;\$3&#x7; \{\
-.            if d doc-volume-as-\$3 \
-.              as doc-volume "/\*doc-volume-as-\$3
-.          \}
-.          as doc-volume " \*doc-volume-ds-\$2
-.    \}\}\}
-.    el \{\
-.      ie "\$2"unass" \
-.        ds doc-volume DRAFT
-.      el \{ .ie "\$2"draft" \
-.        ds doc-volume DRAFT
-.      el .if "\$2"paper" \
-.        ds doc-volume UNTITLED
-.      \}\}
-.      if \A&#x7;\$3&#x7; \{\
-.        if d doc-volume-ds-\$3 \
-.          ds doc-volume "\*doc-volume-ds-\$3
-.  \}\}\}
-.
-.  if !"\$3"" \
-.    if "\*doc-volume"LOCAL" \
-.      ds doc-volume \$3
-.
-.  if !\ncR \
-.    if \nnl \{\
-.      doc-setup-header
-.      bp
-.    \}
-..
-.
-.
-.\" NS doc-default-operating-system global string
-.\" NS   the exact (default) version of the operating system
-.\" NS
-.\" NS override this in 'mdoc.local', if necessary
-.
-.ds doc-default-operating-system BSD
-.
-.
-.\" NS doc-operating-system global string
-.\" NS   the exact version of the operating system
-.
-.ds doc-operating-system
-.
-.
-.\" NS Os user macro (not parsed, not callable)
-.\" NS   operating system
-.\" NS
-.\" NS modifies:
-.\" NS   doc-operating-system
-.\" NS   doc-command-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-operating-system-XXX-XXX
-.\" NS
-.\" NS width register 'Os' set above
-.
-.ds doc-operating-system-ATT-7   7th\~Edition
-.als doc-operating-system-ATT-7th doc-operating-system-ATT-7
-.ds doc-operating-system-ATT-3   System\~III
-.als doc-operating-system-ATT-III doc-operating-system-ATT-3
-.ds doc-operating-system-ATT-V   System\~V
-.ds doc-operating-system-ATT-V.2 System\~V Release\~2
-.ds doc-operating-system-ATT-V.3 System\~V Release\~3
-.ds doc-operating-system-ATT-V.4 System\~V Release\~4
-.
-.ds doc-operating-system-BSD-3    3rd\~Berkeley Distribution
-.ds doc-operating-system-BSD-4    4th\~Berkeley Distribution
-.ds doc-operating-system-BSD-4.1  4.1\~Berkeley Distribution
-.ds doc-operating-system-BSD-4.2  4.2\~Berkeley Distribution
-.ds doc-operating-system-BSD-4.3  4.3\~Berkeley Distribution
-.ds doc-operating-system-BSD-4.3T 4.3-Tahoe Berkeley Distribution
-.ds doc-operating-system-BSD-4.3R 4.3-Reno Berkeley Distribution
-.als doc-operating-system-BSD-4.3t doc-operating-system-BSD-4.3T
-.als doc-operating-system-BSD-4.3r doc-operating-system-BSD-4.3R
-.ds doc-operating-system-BSD-4.4  4.4BSD
-.
-.ds doc-operating-system-NetBSD-0.8   0.8
-.ds doc-operating-system-NetBSD-0.8a  0.8A
-.ds doc-operating-system-NetBSD-0.9   0.9
-.ds doc-operating-system-NetBSD-0.9a  0.9A
-.ds doc-operating-system-NetBSD-1.0   1.0
-.ds doc-operating-system-NetBSD-1.0a  1.0A
-.ds doc-operating-system-NetBSD-1.1   1.1
-.ds doc-operating-system-NetBSD-1.2   1.2
-.ds doc-operating-system-NetBSD-1.2a  1.2A
-.ds doc-operating-system-NetBSD-1.2b  1.2B
-.ds doc-operating-system-NetBSD-1.2c  1.2C
-.ds doc-operating-system-NetBSD-1.2d  1.2D
-.ds doc-operating-system-NetBSD-1.2e  1.2E
-.ds doc-operating-system-NetBSD-1.3   1.3
-.ds doc-operating-system-NetBSD-1.3a  1.3A
-.ds doc-operating-system-NetBSD-1.4   1.4
-.ds doc-operating-system-NetBSD-1.4.1 1.4.1
-.ds doc-operating-system-NetBSD-1.4.2 1.4.2
-.ds doc-operating-system-NetBSD-1.4.3 1.4.3
-.ds doc-operating-system-NetBSD-1.5   1.5
-.ds doc-operating-system-NetBSD-1.5.1 1.5.1
-.ds doc-operating-system-NetBSD-1.5.2 1.5.2
-.ds doc-operating-system-NetBSD-1.5.3 1.5.3
-.ds doc-operating-system-NetBSD-1.6   1.6
-.ds doc-operating-system-NetBSD-1.6.1 1.6.1
-.ds doc-operating-system-NetBSD-1.6.2 1.6.2
-.ds doc-operating-system-NetBSD-1.6.3 1.6.3
-.ds doc-operating-system-NetBSD-2.0   2.0
-.ds doc-operating-system-NetBSD-2.0.1 2.0.1
-.ds doc-operating-system-NetBSD-2.0.2 2.0.2
-.ds doc-operating-system-NetBSD-2.0.3 2.0.3
-.ds doc-operating-system-NetBSD-2.1   2.1
-.ds doc-operating-system-NetBSD-3.0   3.0
-.ds doc-operating-system-NetBSD-3.0.1 3.0.1
-.ds doc-operating-system-NetBSD-3.0.2 3.0.2
-.ds doc-operating-system-NetBSD-3.0.3 3.0.3
-.ds doc-operating-system-NetBSD-3.1   3.1
-.ds doc-operating-system-NetBSD-3.1.1 3.1.1
-.ds doc-operating-system-NetBSD-4.0   4.0
-.ds doc-operating-system-NetBSD-4.0.1 4.0.1
-.ds doc-operating-system-NetBSD-5.0   5.0
-.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.1.4 5.1.4
-.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-5.2.2 5.2.2
-.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.0.4 6.0.4
-.ds doc-operating-system-NetBSD-6.0.5 6.0.5
-.ds doc-operating-system-NetBSD-6.1   6.1
-.ds doc-operating-system-NetBSD-6.1.1 6.1.1
-.ds doc-operating-system-NetBSD-6.1.2 6.1.2
-.ds doc-operating-system-NetBSD-6.1.3 6.1.3
-.ds doc-operating-system-NetBSD-6.1.4 6.1.4
-.
-.ds doc-operating-system-OpenBSD-2.0  2.0
-.ds doc-operating-system-OpenBSD-2.1  2.1
-.ds doc-operating-system-OpenBSD-2.2  2.2
-.ds doc-operating-system-OpenBSD-2.3  2.3
-.ds doc-operating-system-OpenBSD-2.4  2.4
-.ds doc-operating-system-OpenBSD-2.5  2.5
-.ds doc-operating-system-OpenBSD-2.6  2.6
-.ds doc-operating-system-OpenBSD-2.7  2.7
-.ds doc-operating-system-OpenBSD-2.8  2.8
-.ds doc-operating-system-OpenBSD-2.9  2.9
-.ds doc-operating-system-OpenBSD-3.0  3.0
-.ds doc-operating-system-OpenBSD-3.1  3.1
-.ds doc-operating-system-OpenBSD-3.2  3.2
-.ds doc-operating-system-OpenBSD-3.3  3.3
-.ds doc-operating-system-OpenBSD-3.4  3.4
-.ds doc-operating-system-OpenBSD-3.5  3.5
-.ds doc-operating-system-OpenBSD-3.6  3.6
-.ds doc-operating-system-OpenBSD-3.7  3.7
-.ds doc-operating-system-OpenBSD-3.8  3.8
-.ds doc-operating-system-OpenBSD-3.9  3.9
-.ds doc-operating-system-OpenBSD-4.0  4.0
-.ds doc-operating-system-OpenBSD-4.1  4.1
-.ds doc-operating-system-OpenBSD-4.2  4.2
-.ds doc-operating-system-OpenBSD-4.3  4.3
-.ds doc-operating-system-OpenBSD-4.4  4.4
-.ds doc-operating-system-OpenBSD-4.5  4.5
-.ds doc-operating-system-OpenBSD-4.6  4.6
-.ds doc-operating-system-OpenBSD-4.7  4.7
-.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-OpenBSD-5.5  5.5
-.ds doc-operating-system-OpenBSD-5.6  5.6
-.
-.ds doc-operating-system-FreeBSD-1.0     1.0
-.ds doc-operating-system-FreeBSD-1.1     1.1
-.ds doc-operating-system-FreeBSD-1.1.5   1.1.5
-.ds doc-operating-system-FreeBSD-1.1.5.1 1.1.5.1
-.ds doc-operating-system-FreeBSD-2.0     2.0
-.ds doc-operating-system-FreeBSD-2.0.5   2.0.5
-.ds doc-operating-system-FreeBSD-2.1     2.1
-.ds doc-operating-system-FreeBSD-2.1.5   2.1.5
-.ds doc-operating-system-FreeBSD-2.1.6   2.1.6
-.ds doc-operating-system-FreeBSD-2.1.7   2.1.7
-.ds doc-operating-system-FreeBSD-2.2     2.2
-.ds doc-operating-system-FreeBSD-2.2.1   2.2.1
-.ds doc-operating-system-FreeBSD-2.2.2   2.2.2
-.ds doc-operating-system-FreeBSD-2.2.5   2.2.5
-.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
-.ds doc-operating-system-FreeBSD-3.3     3.3
-.ds doc-operating-system-FreeBSD-3.4     3.4
-.ds doc-operating-system-FreeBSD-3.5     3.5
-.ds doc-operating-system-FreeBSD-4.0     4.0
-.ds doc-operating-system-FreeBSD-4.1     4.1
-.ds doc-operating-system-FreeBSD-4.1.1   4.1.1
-.ds doc-operating-system-FreeBSD-4.2     4.2
-.ds doc-operating-system-FreeBSD-4.3     4.3
-.ds doc-operating-system-FreeBSD-4.4     4.4
-.ds doc-operating-system-FreeBSD-4.5     4.5
-.ds doc-operating-system-FreeBSD-4.6     4.6
-.ds doc-operating-system-FreeBSD-4.6.2   4.6.2
-.ds doc-operating-system-FreeBSD-4.7     4.7
-.ds doc-operating-system-FreeBSD-4.8     4.8
-.ds doc-operating-system-FreeBSD-4.9     4.9
-.ds doc-operating-system-FreeBSD-4.10    4.10
-.ds doc-operating-system-FreeBSD-4.11    4.11
-.ds doc-operating-system-FreeBSD-5.0     5.0
-.ds doc-operating-system-FreeBSD-5.1     5.1
-.ds doc-operating-system-FreeBSD-5.2     5.2
-.ds doc-operating-system-FreeBSD-5.2.1   5.2.1
-.ds doc-operating-system-FreeBSD-5.3     5.3
-.ds doc-operating-system-FreeBSD-5.4     5.4
-.ds doc-operating-system-FreeBSD-5.5     5.5
-.ds doc-operating-system-FreeBSD-6.0     6.0
-.ds doc-operating-system-FreeBSD-6.1     6.1
-.ds doc-operating-system-FreeBSD-6.2     6.2
-.ds doc-operating-system-FreeBSD-6.3     6.3
-.ds doc-operating-system-FreeBSD-6.4     6.4
-.ds doc-operating-system-FreeBSD-7.0     7.0
-.ds doc-operating-system-FreeBSD-7.1     7.1
-.ds doc-operating-system-FreeBSD-7.2     7.2
-.ds doc-operating-system-FreeBSD-7.3     7.3
-.ds doc-operating-system-FreeBSD-7.4     7.4
-.ds doc-operating-system-FreeBSD-8.0     8.0
-.ds doc-operating-system-FreeBSD-8.1     8.1
-.ds doc-operating-system-FreeBSD-8.2     8.2
-.ds doc-operating-system-FreeBSD-8.3     8.3
-.ds doc-operating-system-FreeBSD-8.4     8.4
-.ds doc-operating-system-FreeBSD-9.0     9.0
-.ds doc-operating-system-FreeBSD-9.1     9.1
-.ds doc-operating-system-FreeBSD-9.2     9.2
-.ds doc-operating-system-FreeBSD-9.3     9.3
-.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
-.ds doc-operating-system-Darwin-8.2.0  8.2.0
-.ds doc-operating-system-Darwin-8.3.0  8.3.0
-.ds doc-operating-system-Darwin-8.4.0  8.4.0
-.ds doc-operating-system-Darwin-8.5.0  8.5.0
-.ds doc-operating-system-Darwin-8.6.0  8.6.0
-.ds doc-operating-system-Darwin-8.7.0  8.7.0
-.ds doc-operating-system-Darwin-8.8.0  8.8.0
-.ds doc-operating-system-Darwin-8.9.0  8.9.0
-.ds doc-operating-system-Darwin-8.10.0 8.10.0
-.ds doc-operating-system-Darwin-8.11.0 8.11.0
-.ds doc-operating-system-Darwin-9.0.0  9.0.0
-.ds doc-operating-system-Darwin-9.1.0  9.1.0
-.ds doc-operating-system-Darwin-9.2.0  9.2.0
-.ds doc-operating-system-Darwin-9.3.0  9.3.0
-.ds doc-operating-system-Darwin-9.4.0  9.4.0
-.ds doc-operating-system-Darwin-9.5.0  9.5.0
-.ds doc-operating-system-Darwin-9.6.0  9.6.0
-.ds doc-operating-system-Darwin-9.7.0  9.7.0
-.ds doc-operating-system-Darwin-9.8.0  9.8.0
-.ds doc-operating-system-Darwin-10.0.0 10.0.0
-.ds doc-operating-system-Darwin-10.1.0 10.1.0
-.ds doc-operating-system-Darwin-10.2.0 10.2.0
-.ds doc-operating-system-Darwin-10.3.0 10.3.0
-.ds doc-operating-system-Darwin-10.4.0 10.4.0
-.ds doc-operating-system-Darwin-10.5.0 10.5.0
-.ds doc-operating-system-Darwin-10.6.0 10.6.0
-.ds doc-operating-system-Darwin-10.7.0 10.7.0
-.ds doc-operating-system-Darwin-10.8.0 10.8.0
-.ds doc-operating-system-Darwin-11.0.0 11.0.0
-.ds doc-operating-system-Darwin-11.1.0 11.1.0
-.ds doc-operating-system-Darwin-11.2.0 11.2.0
-.ds doc-operating-system-Darwin-11.3.0 11.3.0
-.ds doc-operating-system-Darwin-11.4.0 11.4.0
-.ds doc-operating-system-Darwin-11.5.0 11.5.0
-.ds doc-operating-system-Darwin-12.0.0 12.0.0
-.ds doc-operating-system-Darwin-12.1.0 12.1.0
-.ds doc-operating-system-Darwin-12.2.0 12.2.0
-.ds doc-operating-system-Darwin-13.0.0 13.0.0
-.ds doc-operating-system-Darwin-13.1.0 13.1.0
-.ds doc-operating-system-Darwin-13.2.0 13.2.0
-.ds doc-operating-system-Darwin-13.3.0 13.3.0
-.ds doc-operating-system-Darwin-13.4.0 13.4.0
-.ds doc-operating-system-Darwin-14.0.0 14.0.0
-.
-.ds doc-operating-system-DragonFly-1.0    1.0
-.ds doc-operating-system-DragonFly-1.1    1.1
-.ds doc-operating-system-DragonFly-1.2    1.2
-.ds doc-operating-system-DragonFly-1.3    1.3
-.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
-.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-2.12   2.12
-.ds doc-operating-system-DragonFly-2.13   2.13
-.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
-.ds doc-operating-system-DragonFly-3.8    3.8
-.
-.de Os
-.  ds doc-command-name
-.
-.  ie "\$1"" \
-.    ds doc-operating-system "\*doc-default-operating-system
-.  el \{ .ie "\$1"ATT" \{\
-.    ds doc-operating-system AT&T
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-ATT-\$2 \
-.        as doc-operating-system " \*doc-operating-system-ATT-\$2
-.      el \
-.        as doc-operating-system " UNIX
-.  \}\}
-.  el \{ .ie "\$1"BSD" \{\
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-BSD-\$2 \
-.        ds doc-operating-system "\*doc-operating-system-BSD-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown BSD version '\$2' (#\n.c)
-.  \}\}
-.  el \{ .ie "\$1"FreeBSD" \{\
-.    ds doc-operating-system FreeBSD
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-FreeBSD-\$2 \
-.        as doc-operating-system \~\*doc-operating-system-FreeBSD-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown FreeBSD version '\$2' (#\n.c)
-.  \}\}
-.  el \{ .ie "\$1"DragonFly" \{\
-.    ds doc-operating-system DragonFly
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-DragonFly-\$2 \
-.        as doc-operating-system \~\*doc-operating-system-DragonFly-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown DragonFly version '\$2' (#\n.c)
-.  \}\}
-.  el \{ .ie "\$1"NetBSD" \{\
-.    ds doc-operating-system NetBSD
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-NetBSD-\$2 \
-.        as doc-operating-system \~\*doc-operating-system-NetBSD-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown NetBSD version '\$2' (#\n.c)
-.  \}\}
-.  el \{ .ie "\$1"OpenBSD" \{\
-.    ds doc-operating-system OpenBSD
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-OpenBSD-\$2 \
-.        as doc-operating-system \~\*doc-operating-system-OpenBSD-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown OpenBSD version '\$2' (#\n.c)
-.  \}\}
-.  el \{ .ie "\$1"Darwin" \{\
-.    ds doc-operating-system Darwin
-.    if \A&#x7;\$2&#x7; \{\
-.      ie d doc-operating-system-Darwin-\$2 \
-.        as doc-operating-system \~\*doc-operating-system-Darwin-\$2
-.      el \
-.        tm mdoc warning: .Os: Unknown Darwin version '\$2' (#\n.c)
-.  \}\}
-.  el \{\
-.    ds doc-operating-system \$1
-.    if !"\$2"" \
-.      as doc-operating-system " \$2
-.  \}\}\}\}\}\}\}\}
-..
-.
-.
-.\" NS doc-date-string global string
-.\" NS   the manual page date as set by 'Dd'
-.
-.ds doc-date-string
-.
-.
-.\" NS Dd user macro (not parsed, not callable)
-.\" NS   set document date
-.\" NS
-.\" NS modifies:
-.\" NS   doc-date-string
-.\" NS   doc-command-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-date-XXX
-.\" NS
-.\" NS width register 'Dd' set above
-.
-.ds doc-date-1  January
-.ds doc-date-2  February
-.ds doc-date-3  March
-.ds doc-date-4  April
-.ds doc-date-5  May
-.ds doc-date-6  June
-.ds doc-date-7  July
-.ds doc-date-8  August
-.ds doc-date-9  September
-.ds doc-date-10 October
-.ds doc-date-11 November
-.ds doc-date-12 December
-.
-.de Dd
-.  ds doc-command-name
-.
-.  ie \n.$ \{\
-.    ie "\$1"$Mdocdate:" \
-.      ds doc-date-string \$2\~\$3, \$4
-.    el \{ .ie (\n.$ == 3) \
-.      ds doc-date-string \$1\~\$2 \$3
-.    el \{\
-.      ds doc-date-string "\*doc-date-\nmo
-.      as doc-date-string \~\ndy, \nyear
-.    \}\}
-.  \}
-.  el \
-.    ds doc-date-string Epoch
-..
-.
-.
-.\" NS doc-hyphen-flags global register
-.\" NS   the parameter for the '.hy' request
-.\" NS
-.\" NS override this in 'mdoc.local', if necessary.
-.
-.nr doc-hyphen-flags 4
-.
-.
-.\" NS doc-header macro
-.\" NS   print page header
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dh
-.\" NS   doc-reg-dh1
-.
-.de doc-header
-.  ev doc-env-dh
-.  doc-setup-page-layout
-.  if !\ncR \
-.    sp \ndoc-header-spaceu
-.  nr doc-reg-dh \w'\*doc-caption-font\*doc-header-string\f'
-.  nr doc-reg-dh1 \w'\*doc-caption-font2\*doc-volume\f'
-.  if (\ndoc-reg-dh + \ndoc-reg-dh1 + \ndoc-reg-dh >= \n.lt) \{\
-.    while (\ndoc-reg-dh + \ndoc-reg-dh1 + \ndoc-reg-dh >= \n.lt) \{\
-.      substring doc-header-string 0 -2
-.      nr doc-reg-dh \w'\*doc-caption-font\*doc-header-string\|.\|.\|.\f'
-.    \}
-.    as doc-header-string "\|.\|.\|.
-.  \}
-.  tl &#x7;\*doc-caption-font\*doc-header-string\f&#x7;\*doc-caption-font2\*doc-volume\f&#x7;\*doc-caption-font\*doc-header-string\f&#x7;
-.  ie !\ncR \
-.    sp \ndoc-header-spaceu
-.  el \
-.    sp 1v
-.  ev
-.  ns
-..
-.
-.
-.\" NS doc-footer macro
-.\" NS   print page footer
-.
-.de doc-footer
-.  ie \ncR \
-.    br
-.  el \{\
-.    ev doc-caption-enviroment
-.    doc-setup-page-layout
-.    sp \ndoc-footer-spaceu
-.    ie \nD \{\
-.      ie o \
-.        tl &#x7;%&#x7;\*doc-caption-font2\*doc-date-string\f&#x7;\*doc-caption-font\*doc-operating-system\f&#x7;
-.      el \
-.        tl &#x7;\*doc-caption-font\*doc-operating-system\f&#x7;\*doc-caption-font2\*doc-date-string\f&#x7;%&#x7;
-.    \}
-.    el \
-.      tl &#x7;\*doc-caption-font\*doc-operating-system\f&#x7;\*doc-caption-font2\*doc-date-string\f&#x7;%&#x7;
-.    bp
-.    ev
-.  \}
-..
-.
-.
-.\" NS doc-check-depth macro
-.\" NS   check paired macros
-.
-.de doc-check-depth
-.  if \ndoc-list-depth \{\
-.    tm mdoc warning: A .Bl directive has no matching .El (#\n.c)
-.    nr doc-list-depth 0
-.  \}
-.  if \ndoc-display-depth \{\
-.    tm mdoc warning: A .Bd directive has no matching .Ed (#\n.c)
-.    nr doc-display-depth 0
-.  \}
-.  if \ndoc-fontmode-depth \{\
-.    tm mdoc warning: A .Bf directive has no matching .Ef (#\n.c)
-.    nr doc-fontmode-depth 0
-.  \}
-..
-.
-.
-.\" NS doc-end-macro macro
-.\" NS   finish output
-.
-.de doc-end-macro
-.  \" We may still have a partial line in the environment.  If this is
-.  \" the case, and we happen to be on the last line of the page, the
-.  \" '.fl' request will cause the page to be ejected and troff will
-.  \" immediately exit.  If we are in nroff mode, this would be
-.  \" unfortunate, since we would never get a chance to output the
-.  \" footer.  So we fudge the page length to make sure that the last
-.  \" page is never ejected until we want it to be.
-.
-.  if \ncR \
-.    pl +3v
-.  fl
-.
-.  doc-check-depth
-.
-.  if \ncR \{\
-.    sp
-.    tl &#x7;\*doc-caption-font\*doc-operating-system\f&#x7;\*doc-caption-font2\*doc-date-string\f&#x7;\*doc-caption-font\*doc-operating-system\f&#x7;
-.    \" suppress empty lines after the footer
-.    pl \nnlu
-.  \}
-..
-.
-.
-.\" NS doc-paragraph macro
-.\" NS   insert a paragraph
-.
-.de doc-paragraph
-.  sp \ndoc-paragraph-spaceu
-.  if !\ncR \
-.    ne 2
-.  ns
-..
-.
-.
-.\" NS Pp user macro (not parsed, not callable)
-.\" NS   new paragraph
-.\" NS
-.\" NS width register 'Pp' set above
-.
-.als Pp doc-paragraph
-.
-.
-.\" NS Lp user macro (not parsed, not callable)
-.\" NS   same as .Pp
-.\" NS
-.\" NS width register 'Lp' set above
-.
-.als Lp doc-paragraph
-.
-.
-.de LP
-.  tm Not a \-mdoc command: .LP (#\n.c)
-..
-.
-.
-.de PP
-.  tm Not a \-mdoc command: .PP (#\n.c)
-..
-.
-.
-.de pp
-.  tm Not a \-mdoc command: .pp (#\n.c)
-..
-.
-.
-.de SH
-.  tm Not a \-mdoc command: .SH (#\n.c)
-..
-.
-.
-.\" NS Nd user macro (not parsed, not callable)
-.\" NS   print name description
-.\" NS
-.\" NS width register 'Nd' set above
-.
-.de Nd
-.  nop \em \$*
-..
-.
-.
-.\" NS doc-in-synopsis-section global register (bool)
-.\" NS   whether we are in the 'synopsis' section
-.
-.nr doc-in-synopsis-section 0
-.
-.
-.\" NS doc-in-library-section global register (bool)
-.\" NS   whether we are in the 'library' section
-.
-.nr doc-in-library-section 0
-.
-.
-.\" NS doc-in-see-also-section global register (bool)
-.\" NS   whether we are in the 'see also' section
-.
-.nr doc-in-see-also-section 0
-.
-.
-.\" NS doc-in-files-section global register (bool)
-.\" NS   whether we are in the 'files' section
-.
-.nr doc-in-files-section 0
-.
-.
-.\" NS doc-in-authors-section global register (bool)
-.\" NS   whether we are in the 'authors' section
-.
-.nr doc-in-authors-section 0
-.
-.
-.\" NS doc-first-parameter macro
-.\" NS   return first parameter
-.\" NS
-.\" NS local variables:
-.\" NS   doc-str-dfp
-.
-.de doc-first-parameter
-.  ds doc-str-dfp "\$1
-..
-.
-.
-.\" NS Sh user macro (not callable)
-.\" NS   section headers
-.\" NS
-.\" NS modifies:
-.\" NS   doc-func-args-processed
-.\" NS   doc-func-count
-.\" NS   doc-in-authors-section
-.\" NS   doc-in-files-section
-.\" NS   doc-in-library-section
-.\" NS   doc-in-see-also-section
-.\" NS   doc-in-synopsis-section
-.\" NS   doc-indent-synopsis
-.\" NS   doc-indent-synopsis-active
-.\" NS   doc-is-func
-.\" NS   doc-num-func-args
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Sh
-.\" NS   doc-reg-Sh1
-.\" NS   doc-section-XXX
-.\" NS
-.\" NS width register 'Sh' set in doc-common
-.
-.ds doc-section-name        NAME
-.ds doc-section-synopsis    SYNOPSIS
-.ds doc-section-library     LIBRARY
-.ds doc-section-description DESCRIPTION
-.ds doc-section-see-also    SEE
-.ds doc-section-files       FILES
-.ds doc-section-authors     AUTHORS
-.
-.de Sh
-.  ie \ndoc-arg-limit \{\
-.    \" we only allow 'Sh' within 'Sh'; it will change the font back to
-.    \" 'doc-Sh-font'
-.    ie "\*doc-macro-name"Sh" \{\
-.      nr doc-arg-ptr +1
-.      ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.        nr doc-curr-font \n.f
-.        nr doc-curr-size \n.ps
-.        nop \*doc-Sh-font\c
-.        doc-print-recursive
-.      \}
-.      el \{\
-.        tm Usage: .Sh section_name ... (#\n.c)
-.        doc-reset-args
-.    \}\}
-.    el \{\
-.      tm Usage: .Sh not callable by other macros (#\n.c)
-.      doc-reset-args
-.  \}\}
-.  el \{\
-.    if !\n.$ \{\
-.      tm Usage: .Sh section_name ... (#\n.c)
-.      return
-.    \}
-.
-.    ds doc-macro-name Sh
-.    doc-parse-args \$@
-.
-.    if t \
-.      ad
-.
-.    \" this resolves e.g. '.Sh "SEE ALSO"'
-.    doc-first-parameter \$*
-.
-.    ie "\*doc-str-dfp"\*doc-section-name" \{\
-.      doc-setup-header
-.      in 0
-.    \}
-.    el \{\
-.      nr doc-in-synopsis-section 0
-.      nr doc-in-library-section 0
-.      nr doc-in-see-also-section 0
-.      nr doc-in-files-section 0
-.      nr doc-in-authors-section 0
-.
-.      ie        "\*doc-str-dfp"\*doc-section-synopsis" \{\
-.        if t \
-.          na
-.        nr doc-in-synopsis-section 1
-.        nr doc-indent-synopsis 0
-.        nr doc-indent-synopsis-active 0
-.      \}
-.      el \{ .ie "\*doc-str-dfp"\*doc-section-library" \{\
-.        nr doc-in-library-section 1
-.      \}
-.      el \{ .ie "\*doc-str-dfp"\*doc-section-description" \{\
-.        nr doc-is-func 0
-.        nr doc-func-count 0
-.        nr doc-func-args-processed 0
-.        nr doc-num-func-args 0
-.      \}
-.      el \{ .ie "\*doc-str-dfp"\*doc-section-see-also" \{\
-.        if t \
-.          na
-.        nr doc-in-see-also-section 1
-.      \}
-.      el \{ .ie "\*doc-str-dfp"\*doc-section-files" \
-.        nr doc-in-files-section 1
-.      el .if    "\*doc-str-dfp"\*doc-section-authors" \
-.        nr doc-in-authors-section 1
-.      \}\}\}\}
-.
-.      in 0
-.      nr doc-have-author 0
-.    \}
-.
-.    doc-setup-page-layout
-.    sp
-.    ns
-.    ta T .5i
-.    if !\ncR \
-.      ne 3
-.    fi
-.
-.    if t \{\
-.      nr doc-reg-Sh \n.ss
-.      nr doc-reg-Sh1 \n.sss
-.      ss (\n.ss * 5 / 3) (\n.sss * 5 / 3)
-.    \}
-.
-.    nr doc-arg-ptr +1
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    nop \*doc-Sh-font\c
-.    doc-print-recursive
-.
-.    if t \
-.      ss \ndoc-reg-Sh \ndoc-reg-Sh1
-.
-.    in +\ndoc-subheader-indentu
-.    ns
-.
-.    doc-check-depth
-.  \}
-..
-.
-.
-.\" NS Ss user macro (not callable)
-.\" NS   subsection
-.\" NS
-.\" NS local variable:
-.\" NS   doc-reg-Ss
-.\" NS   doc-reg-Ss1
-.\" NS
-.\" NS width register 'Ss' set above
-.
-.de Ss
-.  ie \ndoc-arg-limit \{\
-.    \" we only allow 'Ss' within 'Ss'; it will change the font back to
-.    \" 'doc-Sh-font'
-.    ie "\*doc-macro-name"Ss" \{\
-.      nr doc-arg-ptr +1
-.      ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.        nr doc-curr-font \n.f
-.        nr doc-curr-size \n.ps
-.        nop \*doc-Sh-font\c
-.        doc-print-recursive
-.      \}
-.      el \{\
-.        tm Usage: .Ss subsection_name ... (#\n.c)
-.        doc-reset-args
-.    \}\}
-.    el \{\
-.      tm Usage: .Ss not callable by other macros (#\n.c)
-.      doc-reset-args
-.  \}\}
-.  el \{\
-.    if !\n.$ \{\
-.      tm Usage: .Ss subsection_name ... (#\n.c)
-.      return
-.    \}
-.
-.    ds doc-macro-name Ss
-.    doc-parse-args \$@
-.
-.    sp
-.    if !\ncR \
-.      ne 3
-.    ti -.25i
-.
-.    nr doc-reg-Ss \n.ss
-.    nr doc-reg-Ss1 \n.sss
-.    ss (\n.ss * 5 / 4) (\n.sss * 5 / 4)
-.
-.    nr doc-arg-ptr +1
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    nop \*doc-Sh-font\c
-.    doc-print-recursive
-.
-.    ss \ndoc-reg-Ss \ndoc-reg-Ss1
-.
-.    ta T .5i
-.    if !\ncR \
-.      ne 2
-.    br
-.    ns
-.
-.    doc-check-depth
-.  \}
-..
-.
-.
-.\" NS Rd macro (not parsed, not callable)
-.\" NS   print global register dump to stderr
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Rd
-.
-.de Rd
-.  tm MDOC GLOBAL REGISTER DUMP
-.  tm doc-macro-name == '\*doc-macro-name'
-.  tm doc-arg-limit == \ndoc-arg-limit
-.  tm doc-num-args == \ndoc-num-args
-.  tm doc-arg-ptr == \ndoc-arg-ptr
-.
-.  nr doc-reg-Rd 1
-.  while (\ndoc-reg-Rd <= \ndoc-arg-limit) \{\
-.    tm doc-arg\ndoc-reg-Rd == '\*doc-arg\ndoc-reg-Rd'
-.    tm doc-type\ndoc-reg-Rd == \ndoc-type\ndoc-reg-Rd
-.    tm doc-space\ndoc-reg-Rd == '\*doc-space\ndoc-reg-Rd'
-.    nr doc-reg-Rd +1
-.  \}
-.
-.  tm doc-curr-font == \ndoc-curr-font
-.  tm doc-curr-size == \ndoc-curr-size
-.  tm doc-indent-synopsis == \ndoc-indent-synopsis
-.  tm doc-indent-synopsis-active == \ndoc-indent-synopsis-active
-.  tm doc-have-decl == \ndoc-have-decl
-.  tm doc-have-var == \ndoc-have-var
-.  tm doc-command-name == '\*doc-command-name'
-.  tm doc-quote-left == '\*doc-quote-left'
-.  tm doc-quote-right == '\*doc-quote-right'
-.  tm doc-nesting-level == \ndoc-nesting-level
-.  tm doc-in-list == \ndoc-in-list
-.  tm doc-space == '\*doc-space'
-.  tm doc-saved-space == '\*doc-saved-space'
-.  tm doc-space-mode == \ndoc-space-mode
-.  tm doc-have-space == \ndoc-have-space
-.  tm doc-have-slot == \ndoc-have-slot
-.  tm doc-keep-type == \ndoc-keep-type
-.  tm doc-display-depth == \ndoc-display-depth
-.  tm doc-is-compact == \ndoc-is-compact
-.
-.  nr doc-reg-Rd 0
-.  while (\ndoc-reg-Rd <= \ndoc-display-depth) \{\
-.    tm doc-display-type-stack\ndoc-reg-Rd == '\*doc-display-type-stack\ndoc-reg-Rd'
-.    tm doc-display-indent-stack\ndoc-reg-Rd == \ndoc-display-indent-stack\ndoc-reg-Rd
-.    tm doc-display-ad-stack\ndoc-reg-Rd == \ndoc-display-ad-stack\ndoc-reg-Rd
-.    tm doc-display-fi-stack\ndoc-reg-Rd == \ndoc-display-fi-stack\ndoc-reg-Rd
-.    tm doc-display-ft-stack\ndoc-reg-Rd == \ndoc-display-ft-stack\ndoc-reg-Rd
-.    tm doc-display-ps-stack\ndoc-reg-Rd == \ndoc-display-ps-stack\ndoc-reg-Rd
-.    nr doc-reg-Rd +1
-.  \}
-.
-.  tm doc-fontmode-depth == \ndoc-fontmode-depth
-.
-.  nr doc-reg-Rd 1
-.  while (\ndoc-reg-Rd <= \ndoc-fontmode-depth) \{\
-.    tm doc-fontmode-font-stack\ndoc-reg-Rd == '\ndoc-fontmode-font-stack\ndoc-reg-Rd'
-.    tm doc-fontmode-size-stack\ndoc-reg-Rd == '\ndoc-fontmode-size-stack\ndoc-reg-Rd'
-.    nr doc-reg-Rd +1
-.  \}
-.
-.  tm doc-list-depth == \ndoc-list-depth
-.
-.  nr doc-reg-Rd 1
-.  while (\ndoc-reg-Rd <= \ndoc-list-depth) \{\
-.    tm doc-list-type-stack\ndoc-reg-Rd == '\*doc-list-type-stack\ndoc-reg-Rd'
-.    tm doc-list-have-indent-stack\ndoc-reg-Rd == \ndoc-list-have-indent-stack\ndoc-reg-Rd
-.    tm doc-list-indent-stack\ndoc-reg-Rd == \ndoc-list-indent-stack\ndoc-reg-Rd
-.    tm doc-compact-list-stack\ndoc-reg-Rd == \ndoc-compact-list-stack\ndoc-reg-Rd
-.    tm doc-tag-prefix-stack\ndoc-reg-Rd == '\*doc-tag-prefix-stack\ndoc-reg-Rd'
-.    tm doc-tag-width-stack\ndoc-reg-Rd == '\*doc-tag-width-stack\ndoc-reg-Rd'
-.    tm doc-list-offset-stack\ndoc-reg-Rd == \ndoc-list-offset-stack\ndoc-reg-Rd
-.    tm doc-enum-list-count-stack\ndoc-reg-Rd == \ndoc-enum-list-count-stack\ndoc-reg-Rd
-.    nr doc-reg-Rd +1
-.  \}
-.
-.  tm doc-saved-Pa-font == '\*doc-saved-Pa-font'
-.  tm doc-curr-type == \ndoc-curr-type
-.  tm doc-curr-arg == '\*doc-curr-arg'
-.  tm doc-diag-list-input-line-count == \ndoc-diag-list-input-line-count
-.  tm doc-num-columns == \ndoc-num-columns
-.  tm doc-column-indent-width == \ndoc-column-indent-width
-.  tm doc-is-func == \ndoc-is-func
-.  tm doc-have-old-func == \ndoc-have-old-func
-.  tm doc-func-arg-count == \ndoc-func-arg-count
-.  tm doc-func-arg == '\*doc-func-arg'
-.  tm doc-num-func-args == \ndoc-num-func-args
-.  tm doc-func-args-processed == \ndoc-func-args-processed
-.  tm doc-have-func == \ndoc-have-func
-.  tm doc-is-reference == \ndoc-is-reference
-.  tm doc-reference-count == \ndoc-reference-count
-.  tm doc-author-count == \ndoc-author-count
-.
-.  nr doc-reg-Rd 0
-.  while (\ndoc-reg-Rd <= \ndoc-author-count) \{\
-.    tm doc-author-name\ndoc-reg-Rd == '\*doc-author-name\ndoc-reg-Rd'
-.    nr doc-reg-Rd +1
-.  \}
-.
-.  tm doc-book-count == \ndoc-book-count
-.  tm doc-book-name == '\*doc-book-name'
-.  tm doc-date-count == \ndoc-date-count
-.  tm doc-date == '\*doc-date'
-.  tm doc-publisher-count == \ndoc-publisher-count
-.  tm doc-publisher-name == '\*doc-publisher-name'
-.  tm doc-journal-count == \ndoc-journal-count
-.  tm doc-journal-name == '\*doc-journal-name'
-.  tm doc-issue-count == \ndoc-issue-count
-.  tm doc-issue-name == '\*doc-issue-name'
-.  tm doc-optional-count == \ndoc-optional-count
-.  tm doc-optional-string == '\*doc-optional-string'
-.  tm doc-page-number-count == \ndoc-page-number-count
-.  tm doc-page-number-string == '\*doc-page-number-string'
-.  tm doc-corporate-count == \ndoc-corporate-count
-.  tm doc-corporate-name == '\*doc-corporate-name'
-.  tm doc-report-count == \ndoc-report-count
-.  tm doc-report-name == '\*doc-report-name'
-.  tm doc-reference-title-count == \ndoc-reference-title-count
-.  tm doc-reference-title-name == '\*doc-reference-title-name'
-.  tm doc-reference-title-name-for-book == '\*doc-reference-title-name-for-book'
-.  tm doc-url-count == \ndoc-url-count
-.  tm doc-url-name == '\*doc-url-name'
-.  tm doc-volume-count == \ndoc-volume-count
-.  tm doc-volume-name == '\*doc-volume-name'
-.  tm doc-have-author == \ndoc-have-author
-.
-.  tm doc-document-title == '\*doc-document-title'
-.  tm doc-volume == '\*doc-volume'
-.  tm doc-section == '\*doc-section'
-.  tm doc-operating-system == '\*doc-operating-system'
-.  tm doc-date-string == '\*doc-date-string'
-.  tm doc-header-space == \ndoc-header-space
-.  tm doc-footer-space == \ndoc-footer-space
-.  tm doc-display-vertical == \ndoc-display-vertical
-.  tm doc-header-string == '\*doc-header-string'
-.  tm doc-in-synopsis-section == \ndoc-in-synopsis-section
-.  tm doc-in-library-section == \ndoc-in-library-section
-.  tm doc-in-see-also-section == \ndoc-in-see-also-section
-.  tm doc-in-files-section == \ndoc-in-files-section
-.  tm doc-in-authors-section == \ndoc-in-authors-section
-.
-.  tm END OF GLOBAL REGISTER DUMP
-..
-.
-.
-.ec
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc-ditroff-u Deleted

@@ -1,343 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\"   The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc-ditroff	8.1 (Berkeley) 06/08/93
-.\"
-.\"     %beginstrip%
-.
-.
-.eo
-.
-.\" use -rD=1 for double-sided printing
-.
-.if !r D .nr D 0
-.
-.\" use -rcR=1 to force the creation of a single, very long page
-.
-.if !r cR .nr cR 0
-.
-.\" use -rS={11,12} to change the font size from 10pt to 11pt or 12pt.
-.
-.if !r S .nr S 10
-.
-.
-.ec
-.
-.
-.ie        (\nS == 11) \{\
-.  ps 10.95z
-.  vs 13.6p
-.\}
-.el \{ .ie (\nS == 12) \{\
-.  ps 12z
-.  vs 14.5p
-.\}
-.el \{\
-.  ps 10z
-.  vs 12p
-.\}\}
-.
-.
-.\" the 'doc-xx-font' strings must not be empty!
-.
-.ds doc-caption-font \fR\s\n.psu
-.ds doc-caption-font2 \fR\s\n.psu
-.ds doc-Ad-font \fI\s\n.psu
-.ds doc-Ar-font \fCO\s\n.psu
-.ds doc-Cm-font \fCB\s\n.psu
-.ds doc-Em-font \fI\s\n.psu
-.ds doc-Er-font \fC\s\n.psu
-.ds doc-Ev-font \fC\s\n.psu
-.ds doc-Fa-font \fCO\s\n.psu
-.ds doc-Fd-font \fCB\s\n.psu
-.ds doc-Fl-font \fCB\s\n.psu
-.ds doc-Fn-font \fCB\s\n.psu
-.ds doc-Ft-font \fCO\s\n.psu
-.ds doc-Ic-font \fCB\s\n.psu
-.ds doc-Li-font \fC
-.ds doc-Me-font \fB\s\n.psu
-.ds doc-Nm-font \fCB\s\n.psu
-.ds doc-No-font \fR\s\n.psu
-.ds doc-Pa-font \fC\s\n.psu
-.ds doc-Sh-font \fB\s\n.psu
-.ds doc-Sy-font \fB\s\n.psu
-.ds doc-Sx-font \fB\s\n.psu
-.ds doc-Tn-font-shape \fR
-\# XXX: adapt to discrete LaTeX font sizes
-.ds doc-Tn-font-size \s(\n.psu - 1z)
-.ds doc-Va-font \fI\s\n.psu
-.ds doc-Xr-font \fC\s\n.psu
-.
-.ds doc-left-parenthesis \fR\|(\|\f\s\n.psu
-.ds doc-right-parenthesis \fR\|)\|\f\s\n.psu
-.ds lp \fR(\f\s\n.psu
-.ds rp \fR)\f\s\n.psu
-.ds doc-left-bracket \fR\^\^\f\s\n.psu
-.ds doc-right-bracket \fR\^\f\s\n.psu
-.
-.tr *\**
-.
-.\" miscellaneous
-.nr doc-subheader-indent (\w&#x7;\fC,&#x7;u * 5u)
-.nr doc-paragraph-space .5v
-.
-.nr doc-digit-width \w'\0'u
-.nr doc-fixed-width \w&#x7;\fC0&#x7;
-.
-.eo
-.
-.
-.\" NS doc-header-space global register
-.\" NS   the space between header and body
-.
-.nr doc-header-space .5i
-.
-.
-.\" NS doc-footer-space global register
-.\" NS   the space between body and footer
-.
-.nr doc-footer-space .5i
-.
-.
-.\" NS doc-display-vertical global register
-.\" NS   vertical space between list elements etc.
-.
-.nr doc-display-vertical 0
-.
-.
-.\" NS doc-setup-page-layout macro
-.\" NS   set up page layout
-.\" NS
-.\" NS modifies:
-.\" NS   doc-display-vertical
-.
-.de doc-setup-page-layout
-.  ie r LL \
-.    ll \nLLu
-.  el \
-.    ll 6.5i
-.
-.  ie r LT \
-.    lt \nLTu
-.  el \
-.    lt 6.5i
-.
-.  po 1i
-.
-.  nr doc-display-vertical .5v
-..
-.
-.
-.ds doc-left-singlequote \oq
-.ds doc-right-singlequote \cq
-.
-.\" the following strings are 'official'
-.ds <= \<=
-.ds >= \>=
-.ds Lq \lq
-.ds Rq \rq
-.ds ua \ua
-.ds aa \aa
-.ds ga \ga
-.ds q \dq
-.ds Pi \*p
-.ds Ne \!=
-.ds Le \<=
-.ds Ge \>=
-.ds Lt <
-.ds Gt >
-.ds Pm \+-
-.ds If \if
-.ds Na \fINaN\f
-.ds Ba \fR|\f
-.ds Am &
-.
-.
-.\" NS doc-header-string global string
-.\" NS   the final string used for the manual page header
-.
-.ds doc-header-string
-.
-.
-.\" NS doc-setup-header macro
-.\" NS   install and initialize header and footer support
-.\" NS
-.\" NS modifies:
-.\" NS   doc-header-string
-.
-.de doc-setup-header
-.  ds doc-header-string "\*doc-document-title
-.  if !"\*doc-section"Null" \
-.    as doc-header-string \|(\*doc-section)
-.
-.  wh 0 doc-header
-.  wh -1.25i doc-footer
-.
-.  br
-.
-.  e@ doc-end-macro
-..
-.
-.
-.\" NS doc-get-width macro
-.\" NS   computes the width of a string as a multiple of
-.\" NS   'doc-fixed-width': '.doc-get-width string'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-width
-.
-.de doc-get-width
-.  nr doc-width \w&#x7;\fC\$1&#x7;
-.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
-.    ie (\ndoc-width % \ndoc-fixed-width) \
-.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
-.    el \
-.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
-.  \}
-.  el \{\
-.    ie \ndoc-width \
-.      nr doc-width 1
-.    el \
-.      nr doc-width 0
-.  \}
-..
-.
-.
-.\" NS doc-get-arg-width macro
-.\" NS   computes the width of an argument as a multiple of
-.\" NS   'doc-fixed-width': '.doc-get-arg-width arg-index'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-width
-.
-.de doc-get-arg-width
-.  nr doc-width \w&#x7;\fC\*doc-arg\$1&#x7;
-.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
-.    ie (\ndoc-width % \ndoc-fixed-width) \
-.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
-.    el \
-.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
-.  \}
-.  el \{\
-.    ie \ndoc-width \
-.      nr doc-width 1
-.    el \
-.      nr doc-width 0
-.  \}
-..
-.
-.
-.\" NS Ql user macro
-.\" NS   quoted literal define
-.\" NS
-.\" NS modifies:
-.\" NS   doc-argXXX
-.\" NS   doc-arg-limit
-.\" NS   doc-arg-ptr
-.\" NS   doc-macro-name
-.\" NS   doc-spaceXXX
-.\" NS   doc-typeXXX
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Ql
-.\" NS   doc-reg-Ql1
-.\" NS   doc-reg-Ql2
-.\" NS
-.\" NS width register 'Ql' set in doc-common
-.
-.de Ql
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Ql
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Ql argument ... (#\n.c)
-.  \}
-.
-.  nr doc-reg-Ql (\ndoc-arg-ptr + 1)
-.  doc-get-arg-width \ndoc-reg-Ql
-.
-.  \" don't use quotes if we have more than two succeeding string
-.  \" arguments
-.  nr doc-reg-Ql +1
-.  if (\ndoc-arg-limit >= \ndoc-reg-Ql) \
-.    if (\ndoc-type\ndoc-reg-Ql == 2) \
-.      nr doc-width 3
-.
-.  \" make a difference in quotation style for strings longer
-.  \" than two characters
-.  ie (\ndoc-width > 2) \
-.    Li
-.  el \{\
-.    ie \ndoc-arg-ptr \{\
-.      \" we replace 'Ql' with 'Li'
-.      ds doc-arg\ndoc-arg-ptr Li
-.      nr doc-arg-ptr -1
-.    \}
-.    el \{\
-.      \" if .Ql has been called directly, we must shift all elements in
-.      \" the argument vector to the right so that we can insert 'Li'
-.      nr doc-reg-Ql \ndoc-arg-limit
-.      nr doc-reg-Ql1 (\ndoc-arg-limit + 1)
-.      while \ndoc-reg-Ql \{\
-.        rn doc-arg\ndoc-reg-Ql doc-arg\ndoc-reg-Ql1
-.        rnn doc-type\ndoc-reg-Ql doc-type\ndoc-reg-Ql1
-.        rn doc-space\ndoc-reg-Ql doc-space\ndoc-reg-Ql1
-.        nr doc-reg-Ql -1
-.        nr doc-reg-Ql1 -1
-.      \}
-.      ds doc-arg1 Li
-.      nr doc-type1 1
-.      ds doc-space1
-.      nr doc-arg-limit +1
-.    \}
-.
-.    ds doc-quote-left "\*doc-left-singlequote
-.    ds doc-quote-right "\*doc-right-singlequote
-.    doc-enclose-string
-.  \}
-..
-.
-.
-.ec
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc-nroff-u Deleted

@@ -1,283 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\"   The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc-nroff	8.1 (Berkeley) 06/08/93
-.\"
-.\"     %beginstrip%
-.
-.
-.eo
-.
-.\" use -rD=1 for double-sided printing
-.
-.if !r D .nr D 0
-.
-.\" use -rcR=0 for multiple pages instead of a single, very long page
-.
-.if !r cR .nr cR 1
-.
-.\" the following switch is ignored in nroff mode
-.
-.nr S 10
-.
-.\" the 'doc-xx-font' strings must not be empty!
-.
-.ds doc-caption-font \fR
-.ds doc-caption-font2 \fR
-.ds doc-Ad-font \fI
-.ds doc-Ar-font \fI
-.ds doc-Cm-font \fB
-.ds doc-Em-font \fI
-.ds doc-Er-font \fR
-.ds doc-Ev-font \fR
-.ds doc-Fa-font \fI
-.ds doc-Fd-font \fB
-.ds doc-Fl-font \fB
-.ds doc-Fn-font \fB
-.ds doc-Ft-font \fI
-.ds doc-Ic-font \fB
-.ds doc-Li-font \fR
-.ds doc-Me-font \fB
-.ds doc-Nm-font \fB
-.ds doc-No-font \fR
-.ds doc-Pa-font \fI
-.ds doc-Sh-font \fB
-.ds doc-Sy-font \fB
-.ds doc-Sx-font \fI
-.ds doc-Tn-font-shape \fR
-.ds doc-Tn-font-size
-.ds doc-Va-font \fI
-.ds doc-Xr-font \fR
-.
-.ds doc-left-parenthesis \fR(\f
-.ds doc-right-parenthesis \fR)\f
-.ds lp \fR(\f
-.ds rp \fR)\f
-.ds doc-left-bracket \fR\f
-.ds doc-right-bracket \fR\f
-.
-.\" miscellaneous
-.nr doc-subheader-indent .5i
-.nr doc-paragraph-space 1v
-.
-.ec
-.nr doc-digit-width \w'\0\0'u
-.nr doc-fixed-width \w'0'
-.eo
-.
-.
-.\" NS doc-header-space global register
-.\" NS   the space between header and body
-.
-.nr doc-header-space 0.5i
-.
-.
-.\" NS doc-footer-space global register
-.\" NS   the space between body and footer
-.
-.nr doc-footer-space 0.5i
-.
-.
-.\" NS doc-display-vertical global register
-.\" NS   vertical space between list elements etc.
-.
-.nr doc-display-vertical 0
-.
-.
-.\" NS doc-setup-page-layout macro
-.\" NS   set up page layout
-.\" NS
-.\" NS modifies:
-.\" NS   doc-display-vertical
-.
-.de doc-setup-page-layout
-.  ie r LL \
-.    ll \nLLu
-.  el \
-.    ll 78n
-.
-.  ie r LT \
-.    lt \nLTu
-.  el \
-.    lt 78n
-.
-.  po 0i
-.
-.  nr doc-display-vertical 1v
-.  ad l
-.  na
-..
-.
-.
-.ec
-.
-.ds doc-left-singlequote \oq
-.ds doc-right-singlequote \cq
-.
-.\" the following strings are 'official'
-.ds <= \<=
-.ds >= \>=
-.ds aa \aa
-.ds ga \ga
-.ds q \dq
-.ds Lq \lq
-.ds Rq \rq
-.ds Ne \!=
-.ds Le \<=
-.ds Ge \>=
-.ds Lt <
-.ds Gt >
-.ds Pm \+-
-.ds Na \fINaN\f
-.ds Ba \fR|\f
-.ds Am &
-.
-.\" Unicode TTYs have all glyph forms; for other TTY character sets we
-.\" need character representations which are different from GNU troff's
-.\" standard forms.
-.ie '\*.T'utf8' \{\
-.  ds ua \ua
-.  ds Pi \*p
-.  ds If \if
-.\}
-.el \{\
-.  ds ua ^
-.  ds Pi pi
-.  ds If infinity
-.\}
-.
-.eo
-.
-.
-.\" NS doc-header-string global string
-.\" NS   the final string used for the manual page header
-.
-.ds doc-header-string
-.
-.
-.\" NS doc-setup-header macro
-.\" NS   install and initialize header and footer support
-.\" NS
-.\" NS modifies:
-.\" NS   doc-header-string
-.
-.de doc-setup-header
-.  ds doc-header-string "\*doc-document-title
-.  if !"\*doc-section"Null" \
-.    as doc-header-string (\*doc-section)
-.
-.  ie \ncR \
-.    doc-header
-.  el \{\
-.    wh 0 doc-header
-.    wh -1.167i doc-footer
-.  \}
-.
-.  e@ doc-end-macro
-..
-.
-.
-.\" NS doc-get-width macro
-.\" NS   computes the width of a string as a multiple of
-.\" NS   'doc-fixed-width': '.doc-get-width string'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-width
-.
-.de doc-get-width
-.  nr doc-width \w&#x7;\$1&#x7;
-.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
-.    ie (\ndoc-width % \ndoc-fixed-width) \
-.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
-.    el \
-.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
-.  \}
-.  el \
-.    nr doc-width 0
-..
-.
-.
-.\" NS doc-get-arg-width macro
-.\" NS   computes the width of an argument as a multiple of
-.\" NS   'doc-fixed-width': '.doc-get-arg-width arg-index'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-width
-.
-.de doc-get-arg-width
-.  nr doc-width \w&#x7;\*doc-arg\$1&#x7;
-.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
-.    ie (\ndoc-width % \ndoc-fixed-width) \
-.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
-.    el \
-.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
-.  \}
-.  el \
-.    nr doc-width 0
-..
-.
-.
-.\" NS Ql user macro
-.\" NS   quoted literal define
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Ql' set in doc-common
-.
-.de Ql
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \
-.      ds doc-macro-name Ql
-.    el \
-.      tm Usage: .Ql argument ... (#\n.c)
-.  \}
-.
-.  ds doc-quote-left "\*doc-left-singlequote
-.  ds doc-quote-right "\*doc-right-singlequote
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.ec
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc-old.tmac-u Deleted

@@ -1,1866 +0,0 @@
-.\" Copyright (c) 1990 The Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc-old.tmac	5.2 (Berkeley) 3/13/91
-.\"     Slightly modified by jjc@jclark.com to work with groff as well.
-.\"
-.\" Assume nroff on crt's only if cR==1
-.if n .nr cR 1
-.\"	STRING CONSTANTS
-.\" 	DITROFF
-.if t \{\
-.\"	Address Style
-.ds aD \fI
-.\"	Argument Reference Style
-.ds aR \f(CO
-.\"	Interactive Command Modifier (flag)
-.ds cM \f(CB
-.\"	Emphasis (in the English sense - usually italics)
-.ds eM \fI
-.\"	Errno Style
-.ds eR \fC
-.\"	Environment Variable Style
-.ds eV \fC
-.\"	Command Line Flag Style
-.ds fL \f(CB
-.\"	Header String Style
-.ds Hs \fR
-.\"	Interactive Command Style
-.ds iC \f(CB
-.\"	Literal Style
-.ds lI \fC
-.\"	Left Parenthesis Style
-.ds lP \fR\|(\|\fP
-.\"	Right Parenthesis Style
-.ds rP \fR\|)\|\fP
-.\"	Options Open Bracket Style
-.ds lB \fR\^\^\fP
-.\"	Options Open Bracket Style
-.ds rB \fR\^\fP
-.\"	Name (subject of manpage) Style
-.ds nM \f(CB
-.\"	Pathname Style
-.ds pA \fC
-.\"	Accepted punctuation string for -mdoc syntax
-.ds Pu \fR.,:;(\^)\^\fR
-.\"	Section Header Style
-.ds Sp \s12\fB
-.\" .ds sT \s-2\fR
-.\"	Symbolic Emphasis (boldface)
-.ds sY \f(CB
-.\"	Generic Variable Style
-.ds vA \fI
-.\"	Volume Title Style
-.ds Vs \fR
-.\"	Cross Reference STyle (man page only)
-.ds xR \fC
-.\"	Math *
-.tr *\(**
-.\}
-.\"	NROFF
-.if n \{\
-.\"	Address Style
-.ds aD \fI
-.\"	Argument Reference Style
-.ds aR \fI
-.\"	Interactive Command Modifier (flag)
-.ds cM \fB
-.\"	Emphasis (in the English sense - usually italics)
-.ds eM \fI
-.\"	Errno Style
-.ds eR \fR
-.\"	Environment Variable Style
-.ds eV \fR
-.\"	Command Line Flag Style
-.ds fL \fB
-.\"	Header String Style
-.ds Hs \fR
-.\"	Interactive Command Style
-.ds iC \fB
-.\"	Literal Style
-.ds lI \fR
-.\"	Left Parenthesis Style
-.ds lP \fR\|(\fP
-.\"	Right Parenthesis Style
-.ds rP \fR\|)\fP
-.\"	Options Open Bracket Style
-.ds lB \fR\|\|\fP
-.\"	Options Open Bracket Style
-.ds rB \fR\|\fP
-.\"	Name (subject of manpage) Style
-.ds nM \fB
-.\"	Pathname Style
-.ds pA \fI
-.\"	Accepted punctuation string for -mdoc syntax
-.ds Pu .,;:()
-.\"	Section Header Style
-.ds Sp \s12\fB
-.\"	.ds sT \s-2\fR
-.\" .ds sT \s-2\fR
-.\"	Symbol, Mode or Mask Style
-.ds sY \fB
-.\"	Generic Variable Style
-.ds vA \fI
-.\"	Volume Title Style
-.ds Vs \fR
-.\"	Cross Reference Style (man page only)
-.ds xR \fR
-.\}
-.\"	INDENTS - Subheaders(sI), Text(Ti) between Section Headers and Subsects
-.if t \{\
-.	nr sI \w'\fC,'u*5
-.	nr Ti \n(sIu
-.\}
-.if n \{\
-.	nr sI .5i
-.	nr Ti .5i
-.\}
-.\"	Flags for macros names which are used only for .Ds
-.nr dI 6n
-.nr dC 1
-.nr dL 1
-.nr dR 1
-.\"	INDENT WIDTHS (for Lists)
-.\"	Width Needed for Address Tag (indented amount)
-.nr Ad 12n
-.\"	Angle Quote Width
-.nr Aq 12n
-.\"	Width Needed for Argument
-.nr Ar 12n
-.\"	Width Needed for Column offset
-.nr Cl 15n
-.\"	Width neeeded for Interactive Command Modifier
-.nr Cm 10n
-.\"	Width Needed for Complex Expressions
-.nr Cx 20n
-.\"	Indent Width Needed for Display (right and left margins)
-.nr Ds 6n
-.\"	Double Quote Width
-.nr Dq 12n
-.\"	tI is dependent on Ds and used by .Dp
-.nr tI \n(Dsu
-.\"	Width Needed for Display
-.nr Em 10n
-.\"	Width Needed for Errno Types
-.nr Er 15n
-.\"	Width Needed for Environment Variables
-.nr Ev 15n
-.\"	Width Needed for Example Indent
-.nr Ex 10n
-.\"	Width Needed for Flag
-.nr Fl 10n
-.\"	Width Needed for Function
-.nr Fn 16n
-.\"	Width neeeded for Interactive Command Name
-.nr Ic 10n
-.\"	Width Needed for Constant
-.nr Li 16n
-.\"	Width Needed for Math Symbol ? not sure if needed
-.nr Ms 6n
-.\"	Width Needed for Name
-.nr Nm 10n
-.\"	Width Needed for Option Begin
-.nr Ob 14n
-.\"	Width Needed for Option End
-.nr Oe 14n
-.\"	Width Needed for Option (one line)
-.nr Op 14n
-.\"	Width Needed for Pathname
-.nr Pa 32n
-.\"	Parenthesis Quote Width
-.nr Pq 12n
-.\"	Single Quote Width
-.nr Sq 12n
-.\"	Width Needed for Symbols, Modes or Masks
-.nr Sy 6n
-.\"	Width needed for default or unknown text width
-.nr Tx 22n
-.\"	Width Needed for Generic Variable
-.nr Va 12n
-.\"	Width Needed for Cross Reference, should the cross ref be annotated.
-.nr Xr 10n
-.\" PARAGRAPH SPACE
-.if t \{\
-.	nr Pp .5v
-.\}
-.if n \{\
-.	nr Pp 1v
-.\}
-.\"	PAGE LAYOUT
-.\" .Li Tagged Paragraph Style - zero if break on oversized tag
-.\" one if add em space and continue filling line.
-.nr tP 0
-.\" Page Layout Macro
-.de pL
-.\"	DITROFF
-.ie t \{\
-.\" Header Margin
-.	nr Hm .5i
-.\" Footer Margin
-.	nr Fm .5i
-.\" Line length
-.	nr ll 5.5i
-.\" Line length
-.	ll 5.5i
-.\" Title length
-.	nr lt 5.5i
-.\" Title length
-.	lt 5.5i
-.\" Page offset
-.	nr po 1.56i
-.\" Page offset
-.	po 1.56i
-.\" Vertical space distance (from Section headers/Lists/Subsections)
-.	nr vV .5v
-.\" em space
-.	ds tP \|\|\|\|\|\|
-.\}
-.el \{\
-.\" Line length
-.	nr ll 78n
-.	ll 78n
-.\" Title length
-.	nr lt 78n
-.\" Title length
-.	lt 78n
-.\" Page offset
-.	nr po 0i
-.\" Page offset
-.	po 0i
-.\" Vertical space distance (from Section headers/Lists/Subsections)
-.	nr vV 1v
-.\" em space
-.	ds tP \0\0
-.\" Test for crt
-.	ie \\n(cR .nr Hm 0
-.	el .nr Hm .5i
-.\" Footer Margin
-.	nr Fm .5i
-.\}
-..
-.\" Adjustment mode
-.if n \{\
-.ad l
-.na
-..
-.\}
-.\" PREDEFINED STRINGS
-.if t \{\
-.	ds <= \(<=
-.	ds >= \(>=
-.	ds Lq \&``
-.	ds Rq \&''
-.	ds ua \(ua
-.	ds aa \(aa
-.	ds ga \(ga
-.	ds sR \(aa
-.	ds sL \(ga
-.\}
-.if n \{\
-.	ds <= \&<\&=
-.	ds >= \&>\&=
-.       ds Rq ''
-.       ds Lq ``
-.	ds ua ^
-.	ds aa '
-.	ds ga `
-.	ds sL `
-.	ds sR '
-.\}
-.\" Note: The distances from the bottom or top of the page are set
-.\" in headers (macro .hK): to -1.25 for troff, and -1.167 for nroff
-.\" bottoms, and top is 0.
-.\"
-.\"	.Dt Document/manpage_title section/chapter volume
-.\"		The \{ and \} is necessary as roff doesn't nest if-elses
-.\"		properly, especially with .ds.
-.\"	TODO: separate Dt into Dt, Ch and Vt for supp docs.
-.de Dt
-.ds dT UNTITLED
-.ds vT Local
-.ds cH Null
-.\" 	Volume and Section Number or Chapter Number
-.if !"\\$1"" .ds dT \\$1
-.if !"\\$2"" \{\
-.	ds cH \\$2
-.	if "\\$3"" \{\
-.		\" Volume Title if none given
-.		if \\$2>=1 .if \\$2<=8 \{\
-.			ds vT UNIX Reference Manual
-.			if \\$2>1 .if \\$2<6 .ds vT UNIX Programmer's Manual
-.			if "\\$2"8" .ds vT UNIX System Manager's Manual
-.		\}
-.		if "\\$2"unass"  .ds vT DRAFT
-.		if "\\$2"draft"  .ds vT DRAFT
-.		if "\\$2"paper"  .ds vT Null
-.	\}
-.\}
-.if !"\\$3"" \{\
-.	\" Volume Title if given
-.	if "\\$3"USD"   .ds vT UNIX User's Supplementary Documents
-.	if "\\$3"PS1"   .ds vT UNIX Programmers's Supplementary Documents
-.	if "\\$3"AMD"   .ds vT UNIX Ancestral Manual Documents
-.	if "\\$3"SMM"   .ds vT UNIX System Manager's Manual
-.	if "\\$3"URM"   .ds vT UNIX Reference Manual
-.	if "\\$3"PRM"   .ds vT UNIX Programmers's Manual
-.	if "\\$3"IND"   .ds vT UNIX Manual Master Index
-.	if "\\$3"CON"   .ds vT UNIX Contributed Software Manual
-.	if "\\$3"IMP"	.ds vT UNIX Implementation Notes
-.	if "\\$3"HOW"	.ds vT UNIX How Pocket Manual
-.	if "\\$3"LOCAL" .ds vT UNIX Local Manual
-.	if "\\*(vT"Local" .ds vT \\$3
-.\}
-..
-.\"
-.\"	.Os Operating System/Standard and Release or Version Number
-.\"
-.de Os
-.ds oS Null
-.if "\\$1"" \{\
-.	ds oS \fIBSD Experimental\fP
-.\" .	ds oS (\fIBag o' Bits\fP)
-.\}
-.if "\\$2"" \{\
-.	ds o1 Non-Null
-.\}
-.if "\\$1"ATT"   \{\
-.	ds oS AT&T
-.	if "\\$2""    .as oS \0UNIX
-.	if "\\$2"7th" .as oS \07th Edition
-.	if "\\$2"7"   .as oS \07th Edition
-.	if "\\$2"III" .as oS \0System III
-.	if "\\$2"3"   .as oS \0System III
-.	if "\\$2"V"   .as oS \0System V
-.	if "\\$2"V.2" .as oS \0System V Release 2
-.	if "\\$2"V.3" .as oS \0System V Release 3
-.	if "\\$2"V.4" .as oS \0System V Release 4
-.\}
-.if "\\$1"BSD" \{\
-.	if "\\$2"3"    .ds oS 3rd Berkeley Distribution
-.	if "\\$2"4"    .ds oS 4th Berkeley Distribution
-.	if "\\$2"4.1"  .ds oS 4.1 Berkeley Distribution
-.	if "\\$2"4.2"  .ds oS 4.2 Berkeley Distribution
-.	if "\\$2"4.3"  .ds oS 4.3 Berkeley Distribution
-.	if "\\$2"4.3+" .ds oS 4.3+tahoe Berkeley Distribution
-.\}
-.if "\\*(oS"Null" .ds oS \\$1
-.if "\\*(o1"Non-Null" .as oS \0\\$2
-.rm o1
-..
-.\"
-.\" Standards
-.\"
-.\" .de St
-.\" .ds sT Null
-.\" .if "\\$1"POSIX" \{\
-.\" .	ds sT IEEE Standard POSIX
-.\" .	if \\$2 .as sT \0\\$2
-.\" .\}
-.\" .if "\\$1"ANSI" \{\
-.\" .	ds sT ANSI Standard
-.\" .	if \\$2 .as sT \0\\$2
-.\" .\}
-.\" .if "\\$1"ISO" \{\
-.\" .	ds sT ISO Standard
-.\" .	if \\$2 .as sT \0\\$2
-.\" .\}
-.\" .if "\\*(sT"Null" .ds sR \\$3
-.\" ..
-.\"
-.\" .de Gp
-.\" .ie !"\\$1"" .ds gP \&\\$1 \\$2 \\$3 \\$4 \\$5
-.\" .el .ds gP Null
-.\" ..
-.\"
-.\"
-.de Dd
-.nr aa 0
-.ie \\n(.$>0 \{\
-.	ie \\n(.$<4 \{\
-.		ds dD \\$1 \\$2 \\$3
-.	\}
-.	el .tm Usage: .Dd Month Day, Year (e.g July 4, 1977).
-.\}
-.el \{\
-.	ds dD Epoch
-.\}
-..
-.\"
-.\"	House Keeping Macro - Make sense of dT, cH, vT, sT, gP and dS
-.\"	TODO: Try to get else's for efficiency
-.\"	TODO: GET RID OF .wh -1.167i (its in v7)
-.\"
-.\"
-.de hK
-.nr % 1
-.ds hT \\*(dT
-.if !"\\*(cH"Null" \{\
-.	ie !"\\*(gP"Null" .as hT \|(\|\\*(cH\\*(gP\|)
-.	el .as hT \\|(\\|\\*(cH\\|)
-.\}
-.if "\\*(cH"Null" .if !"\\*(gP"Null" .as hT \&\|(\|\\*(gP\|)
-.if t \{\
-.	wh 0 hM
-.	wh -1.25i fM
-.\}
-.if n \{\
-.	ie \\n(cR \{\
-.		hM
-.		wh -0v fM
-.	\}
-.	el \{\
-.		wh 0 hM
-.		wh -1.167i fM
-.	\}
-.\}
-.if n \{\
-.	if \\n(nl==0:\\n(nl==-1 'bp
-.\}
-.if t 'bp
-.em lM
-..
-.\"	Header Macro
-.\"
-.de hM
-.ev 1
-.pL
-.if !\\n(cR 'sp \\n(Hmu
-.tl @\\*(Hs\\*(hT\fP@\\*(Vs\\*(vT\fP@\\*(Hs\\*(hT\fP@
-'sp \\n(Hmu
-.ev
-..
-.\"
-.de fM
-.ev 1
-.pL
-.if !\\n(cR \{\
-'	sp \\n(Fmu
-.	tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
-'	bp
-.\}
-.if \\n(cR \{\
-.\" .	tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
-.\" '	bp
-.\}
-.ev
-..
-.de lM
-.fl
-.if \\n(cR \{\
-.       fM
-.       pl \\n(nlu
-.\}
-..
-.de Pp
-.sp \\n(Ppu
-.ne 2
-.ns
-..
-.de Lp
-.Pp
-..
-.de LP
-.tm Not a \-mdoc command: .LP
-..
-.de PP
-.tm Not a \-mdoc command: .PP
-..
-.de pp
-.tm Not a \-mdoc command: .pp
-..
-.de Co
-.tm Not a \-mdoc command: .Co
-..
-.nr z. 1
-.nr z, 1
-.nr z: 1
-.nr z; 1
-.nr z) 1
-.nr z( 1
-.nr z 1
-.nr z 1
-.\" This is disgusting, troff not parse if stmt properly
-.nr z1 0
-.nr z2 0
-.nr z3 0
-.nr z4 0
-.nr z5 0
-.nr z6 0
-.nr z7 0
-.nr z8 0
-.nr z9 0
-.nr z0 0
-.nr z# 0
-.\"
-.de Ad
-.ie \\n(.$==0 \{\
-.       tm Usage: .Ad address ... \\*(Pu
-.\}
-.el \{\
-.       ds sV \\*(aD
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.\" Command Line Argument Macro
-.\"
-.de Ar
-.ie \\n(.$==0 \{\
-.       ie !"\\*(iM"" .as f1 \&\|\\*(aRfile\ ...\fP\|
-.       el \&\|\\*(aRfile\ ...\fP\|
-.\}
-.el \{\
-.       ds sV \\*(aR
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Em
-.ie \\n(.$==0 \{\
-.       tm Usage: .Em text ... \\*(Pu
-.\}
-.el \{\
-.       ds sV \\*(eM
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Er
-.ie \\n(.$==0 \{\
-.       tm Usage: .Er ERRNOTYPE ... \\*(Pu
-.       \}
-.el \{\
-.       ds sV \\*(eR
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Ev
-.ie \\n(.$==0 \{\
-.	tm Usage: .Ev ENVIRONMENT_VARIABLE(s) ... \\*(Pu
-.	\}
-.el \{\
-.	ds sV \\*(eV
-.	nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	ft \\n(cF
-.\}
-..
-.\"
-.\" Flag Name Macro
-.\"
-.de Fl
-.ie \\n(.$==0 \{\
-.       ie !"\\*(iM"" .as f1 \&\\*(fL\-\fP
-.       el \&\\*(fL\-\fP
-.\}
-.el \{\
-.       nr rZ 0
-.       sW \\$1
-.       if (\\n(sW==1&\\n(.$==1) .rZ \\$1
-.       ds sV \\*(fL
-.       nr cF \\n(.f
-.       ie \\n(rZ \{\
-.               ie "\\*(iM"" .ds f1 \&\\*(sV\-\f\\n(cF\\$1
-.               el \&\\*(sV\-\f\\n(cF\\$1
-.       \}
-.	el \{\
-.	       ie "\\*(iM"" .ds f1 \&\\*(sV
-.	       el .as f1 \&\\*(sV
-.	       fB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	       ft \\n(cF
-.	\}
-.\}
-..
-.\"	Interactive Commands Macro
-.\"
-.de Ic
-.ie \\n(.$==0 \{\
-.	tm Usage: .Ic Interactive Commands(s) ... \\*(Pu
-.\}
-.el \{\
-.       ds sV \\*(iC
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.\" Interactive Command Modifiers (flags)
-.\"
-.de Cm
-.ie \\n(.$==0 \{\
-.	tm Usage: .Cm Interactive Command Modifier(s) ... \\*(Pu
-.\}
-.el \{\
-.       ds sV \\*(cM
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Li
-.ie \\n(.$==0 \{\
-.       tm Usage: .Li literal ... \\*(Pu
-.       \}
-.el \{\
-.       ds sV \\*(lI
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\" If in nroff or any other case where the default font
-.\" is constant width, and literal means zilch, single quote instead.
-.ie n \{\
-.de Ql
-.	ie \\n(.$==0 \{\
-.	       tm Usage: .Ql literal ... \\*(Pu
-.       \}
-.	el \{\
-.		Sq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-..
-.\}
-.el \{\
-.de Ql
-.	ie \\n(.$==0 \{\
-.	       tm Usage: .Ql literal ... \\*(Pu
-.       \}
-.	el \{\
-.		Li \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-..
-.\}
-.\"
-.de Nm
-.ie \\n(.$==0 \{\
-.	if "\\*(n1"" .tm Usage: .Nm Name(s) ... \\*(Pu
-.	ie !"\\*(iM"" .as f1 \&\\*(nM\\*(n1\\$1\fP
-.	el \&\\*(nM\\*(n1\\$1\fP
-.\}
-.el \{\
-.	ds sV \\*(nM
-.	nr cF \\n(.f
-.	if \\n(nS \{\
-.		rs
-.		in -\\n(iSu
-.		ie \\n(nS>1 .br
-.		el \{\
-.			sW \\$1
-.			nr iS ((\\n(sW+1)*\\n(fW)u
-.		\}
-.		in +\\n(iSu
-.		ti -\\n(iSu
-.		nr nS \\n(nS+1
-.	\}
-.	if "\\*(n1"" .ds n1 \\$1
-.	ie "\\*(iM"" .ds f1 \&\\*(sV
-.	el .as f1 \&\\*(sV
-.	nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	ft \\n(cF
-.\}
-..
-.\"
-.de Pa
-.ie \\n(.$==0 \{\
-\&\\*(pA~\fP
-.\}
-.el \{\
-.       ds sV \\*(pA
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Sy
-.ie \\n(.$==0 \{\
-.       tm Usage: .Sy Symbolic Text ... \\*(Pu
-.       \}
-.el \{\
-.       ds sV \\*(sY
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Ms
-.ie \\n(.$==0 \{\
-.       tm Usage: .Ms Math Symbol ... \\*(Pu
-.       \}
-.el \{\
-.       ds sV \\*(sY
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de Va
-.ie \\n(.$==0 \{\
-.       tm Usage: .Va variable_name(s) ... \\*(Pu
-.\}
-.el \{\
-.       ds sV \\*(vA
-.       nr cF \\n(.f
-.       ie "\\*(iM"" .ds f1 \&\\*(sV
-.       el .as f1 \&\\*(sV
-.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ft \\n(cF
-.\}
-..
-.\"
-.de nB
-.hy 0
-.if \\n(.$==0 .tm Usage error: called with empty arguments (empty quotes)?
-.ie \\n(.$>1 \{\
-.	rZ \\$1
-.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1\fP
-.	el .as f1 \&\\$1
-.	rZ \\$2
-.	if !\\n(rZ \{\
-.		ie !"\\*(iM""\{\
-.\"			I surrender
-.			if "\\*(iM"Tp" .as f1 \&\ \&
-.			if "\\*(iM"Dp" .as f1 \&\ \&
-.			if "\\*(iM"Op" .as f1 \&\ \&
-.			if "\\*(iM"Cx" .as f1 \&\ \&
-.			if "\\*(iM"Dq" .as f1 \& \&
-.			if "\\*(iM"Sq" .as f1 \& \&
-.			if "\\*(iM"Pq" .as f1 \& \&
-.			if "\\*(iM"Aq" .as f1 \& \&
-.		\}
-.		el .as f1 \& \&
-.	\}
-.	nB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.\}
-.el \{\
-.	rZ \\$1
-.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1
-.	el .as f1 \&\\$1\f\\n(cF
-.	if "\\*(iM"" \{\&\\*(f1
-.		ds f1
-.	\}
-.	hy
-.\}
-..
-.de fB
-.hy 0
-.if \\n(.$==0 .tm Usage error: called with empty arguments (empty quotes)?
-.ie \\n(.$>1 \{\
-.	rZ \\$1
-.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1\fP
-.	el \{\
-.		ie "\\$1"-" .as f1 \&\-\-
-.		el .as f1 \&\-\\$1
-.	\}
-.	rZ \\$2
-.	if !\\n(rZ \{\
-.		ie !"\\*(iM""\{\
-.\"			I surrender
-.			if "\\*(iM"Tp" .as f1 \&\ \&
-.			if "\\*(iM"Dp" .as f1 \&\ \&
-.			if "\\*(iM"Op" .as f1 \&\ \&
-.			if "\\*(iM"Cx" .as f1 \&\ \&
-.			if "\\*(iM"Dq" .as f1 \& \&
-.			if "\\*(iM"Sq" .as f1 \& \&
-.			if "\\*(iM"Pq" .as f1 \& \&
-.			if "\\*(iM"Aq" .as f1 \& \&
-.		\}
-.		el .as f1 \& \&
-.	\}
-.	fB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.\}
-.el \{\
-.	rZ \\$1
-.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1
-.	el \{\
-.		ie "\\$1"-" .as f1 \&\-\-\f\\n(cF
-.		el .as f1 \&\-\\$1\f\\n(cF
-.	\}
-.	if "\\*(iM"" \{\&\\*(f1
-.		ds f1
-.	\}
-.	hy
-.\}
-..
-.\"
-.\" Single quoted Items
-.\" eF, sB g0-9 and f2
-.de Sq
-.nr eF 0
-.ie \\n(.$==0 \{\
-.       ie "\\*(iM"" \&\\*(sL\&\\*sR
-.       el .as f1 \&\\*(sL\&\\*(sR
-.\}
-.el \{\
-.       ie "\\*(iM"" \{\
-.		ds f1 \&\\*(sL
-.		ds iM Sq
-.	\}
-.       el .as f1 \&\\*(sL
-.       sB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	ie \\n(eF>0 .\\*(g1 \\*(g2 \\*(g3 \\*(g4 \\*(g5 \\*(g6 \\*(g7 \\*(g8
-.	el .as f1 \\*(g0
-.	as f1 \\*(sR
-.	if !"\\*(f2"" .as f1 \\*(f2
-.	if "\\*(iM"Sq" \{\
-\&\\*(f1
-.		ds f1
-.		ds iM
-.	\}
-.	ds f2
-.	rm  g0 g1 g2 g3 g4 g5 g6 g7 g8 g9
-.	nr eF 0
-.\}
-..
-.\"
-.\" Double quoted Items
-.de Dq
-.nr Ef 0
-.ie \\n(.$==0 \{\
-.       ie "\\*(iM"" \&\\*(Lq\&\\*(Rq
-.       el .as f1 \&\\*(Lq\&\\*(Rq
-.\}
-.el \{\
-.       ie "\\*(iM"" \{\
-.               ds f1 \&\\*(Lq
-.               ds iM Dq
-.       \}
-.       el .as f1 \&\\*(Lq
-.       Sb \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ie \\n(Ef>0 .\\*(k1 \\*(k2 \\*(k3 \\*(k4 \\*(k5 \\*(k6 \\*(k7 \\*(k8
-.       el .as f1 \\*(k0
-.       as f1 \\*(Rq
-.       if !"\\*(f4"" .as f1 \\*(f4
-.       if "\\*(iM"Dq" \{\
-\&\\*(f1
-.               ds f1
-.               ds iM
-.       \}
-.       ds f4
-.       rm  k0 k1 k2 k3 k4 k5 k6 k7 k8 k9
-.       nr Ef 0
-.\}
-..
-.\"
-.\" Parenthesis quoted Items
-.de Pq
-.nr pQ 0
-.ie \\n(.$==0 \{\
-.       ie "\\*(iM"" \&(\&)
-.       el .as f1 \&(\&)
-.\}
-.el \{\
-.       ie "\\*(iM"" \{\
-.               ds f1 \&(
-.               ds iM Pq
-.       \}
-.       el .as f1 \&(
-.       pB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       ie \\n(pQ>0 .\\*(y1 \\*(y2 \\*(y3 \\*(y4 \\*(y5 \\*(y6 \\*(y7 \\*(y8
-.       el .as f1 \\*(y0
-.       as f1 \&)
-.       if !"\\*(f3"" .as f1 \\*(f3
-.       if "\\*(iM"Pq" \{\
-\&\\*(f1
-.               ds f1
-.               ds iM
-.       \}
-.       ds f3
-.       rm  y0 y1 y2 y3 y4 y5 y6 y7 y8 y9
-.       nr pQ 0
-.\}
-..
-.\" eF, sB g0-9 and f2
-.de sB
-.hy 0
-.ie \\n(.$==0 .tm Sick Logic: macro sB
-.el \{\
-.	ie \\n(eF>=1 .nr eF \\n(eF+1
-.	el \{\
-.		mN \\$1
-.		if \\n(mN .nr eF \\n(eF+1
-.	\}
-.       rZ \\$1
-.       ie \\n(rZ .as f2 \\$1
-.       el \{\
-.		ie \\n(eF<1 .as g\\n(eF \\$1
-.		el .as g\\n(eF \\$1
-.	\}
-.       if \\n(.$>1 \{\
-.		rZ \\$2
-.	        if \\n(rZ==0 \{\
-.			if \\n(eF<1 \{\
-.				as g\\n(eF \& \&
-.			\}
-.		\}
-.		sB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-.\}
-..
-.de Sb
-.hy 0
-.ie \\n(.$==0 .tm Sick Logic: macro Sb
-.el \{\
-.       ie \\n(Ef>=1 .nr Ef \\n(Ef+1
-.	el \{\
-.		mN \\$1
-.	        if \\n(mN .nr Ef \\n(Ef+1
-.	\}
-.       rZ \\$1
-.       ie \\n(rZ .as f4 \\$1
-.       el \{\
-.               ie \\n(Ef<1 .as k\\n(Ef \\$1
-.               el .as k\\n(Ef \\$1
-.       \}
-.       if \\n(.$>1 \{\
-.               rZ \\$2
-.               if \\n(rZ==0 \{\
-.                       if \\n(Ef<1 \{\
-.                               as k\\n(Ef \& \&
-.                       \}
-.               \}
-.               Sb \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       \}
-.\}
-..
-.de pB
-.hy 0
-.ie \\n(.$==0 .tm Sick Logic: macro pB
-.el \{\
-.       ie \\n(pQ>=1 .nr pQ \\n(pQ+1
-.       el \{\
-.               mN \\$1
-.               if \\n(mN .nr pQ \\n(pQ+1
-.       \}
-.       rZ \\$1
-.       ie \\n(rZ .as f3 \\$1
-.       el \{\
-.               ie \\n(pQ<1 .as y\\n(pQ \\$1
-.               el .as y\\n(pQ \\$1
-.       \}
-.       if \\n(.$>1 \{\
-.               rZ \\$2
-.               if \\n(rZ==0 \{\
-.                       if \\n(pQ<1 \{\
-.                               as y\\n(pQ \& \&
-.                       \}
-.               \}
-.               pB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       \}
-.\}
-..
-.de aQ
-.hy 0
-.ie \\n(.$==0 .tm Bad Syntax: .Aq
-.el \{\
-.       ie \\n(aQ>=1 .nr aQ \\n(aQ+1
-.       el \{\
-.               mN \\$1
-.               if \\n(mN .nr aQ \\n(aQ+1
-.       \}
-.       rZ \\$1
-.       ie \\n(rZ .as aZ \\$1
-.       el \{\
-.               ie \\n(aQ<1 .as a\\n(aQ \\$1
-.               el .as a\\n(aQ \\$1
-.       \}
-.       if \\n(.$>1 \{\
-.               rZ \\$2
-.               if \\n(rZ==0 \{\
-.                       if \\n(aQ<1 \{\
-.                               as a\\n(aQ \& \&
-.                       \}
-.               \}
-.               aQ \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.       \}
-.\}
-..
-.\" Angle Bracket Quoted Items
-.de Aq
-.nr aQ 0
-.ie \\n(.$==0 \{\
-.       ie "\\*(iM"" \&<\&>
-.       el .as f1 \&<\&>
-.\}
-.el \{\
-.       ie "\\*(iM"" \{\
-.               ds f1 \&<
-.               ds iM Aq
-.       \}
-.       el .as f1 \&<
-.       aQ \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-.       ie \\n(aQ>0 .\\*(a1 \\*(a2 \\*(a3 \\*(a4 \\*(a5 \\*(a6 \\*(a7 \\*(a8
-.       el .as f1 \\*(a0
-.       as f1 \&>
-.       if !"\\*(aZ"" .as f1 \\*(aZ
-.       if "\\*(iM"Aq" \{\
-\&\\*(f1
-.               ds f1
-.               ds iM
-.       \}
-.       ds aZ
-.       rm  a0 a1 a2 a3 a4 a5 a6 a7 a8
-.       nr aQ 0
-.\}
-..
-.\" macro Name test, return macro register value if true
-.if \n(.g .ig
-.de mN
-.nr mN 0
-.sW \\$1
-.if \\n(sW==2 \{\
-.	if \\n(\\$1 .nr mN \\n(\\$1
-.\}
-..
-.if !\n(.g .ig
-.de mN
-.nr mN 0
-.if \A'\\$1' \{\
-.	sW \\$1
-.	if \\n(sW==2 \{\
-.		if \\n(\\$1 .nr mN \\n(\\$1
-.	\}
-.\}
-..
-.\" Punctuation test (using z registers), return 1 if true
-.if \n(.g .ig
-.de rZ
-.nr rZ 0
-.sW \\$1
-.if \\n(sW==1 \{\
-.	if \\n(z\\$1==1 \{\
-.		nr rZ 1
-.	\}
-.\}
-..
-.if !\n(.g .ig
-.de rZ
-.nr rZ 0
-.if \A'\\$1' \{\
-.	sW \\$1
-.	if \\n(sW==1 \{\
-.		if \\n(z\\$1==1 \{\
-.			nr rZ 1
-.		\}
-.	\}
-.\}
-..
-.\"
-.\" sW returns number of characters in a string
-.if t \{\
-.nr fW \w'\fC,'
-.de sW
-.nr sW \w'\fC\\$1'
-.\}
-.if n \{\
-.nr fW \w'0'
-.de sW
-.nr sW \w'\\$1'
-.\}
-.ie \\n(sW>=\\n(fW \{\
-.	ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
-.	el .nr sW \\n(sW/\\n(fW
-.\}
-.el .nr sW 0
-..
-.\"	Option Expression -
-.\"	TODO - add line overflow check (right!)
-.nr eP 0
-.ds e1
-.nr oE 0
-.nr hP 0
-.ds hP
-.nr Ep 0
-.de Op
-.hy 0
-.if "\\*(iM"" \{\
-.	ds iM Op
-.       ds f1 \&
-.\}
-.as f1 \&\\*(lB
-.\" .tm Op:  \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.dO \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.ie !"\\$1"Cx" .oE
-.el .nr oE \\n(oE+1
-..
-.\"
-.\" just for mike, with every bite of garlic in mind (oops, i mean burp).
-.\" dO: go dOwn an argument vector and test each argument to see if
-.\" a macro name or punctuation. stash in respective place along
-.\" with its arguments.
-.nr oO 0
-.nr oP 0
-.nr aO 0
-.de dO
-.mN \\$1
-.ie \\n(mN \{\
-.       if \\n(oP  \{\
-.               if \\n(hP \{\
-.                       nr oZ 1
-.                       oZ
-.                       Oz
-.               \}
-.               if \\n(e1==1 \{\
-.\\*(e1 \\*(e2 \\*(e3 \\*(e4 \\*(e5 \\*(e6 \\*(e7 \\*(e8 \\*(e9
-.               \}
-.               uO
-.		if !(\\n(oO:\\n(aO) .as f1 \& \&
-.	\}
-.       ie "\\$1"Op" \{\
-.               as f1 \&\\*(lB
-.               nr aO \\n(aO+1
-.       \}
-.	el \{\
-.               nr eP \\n(eP+1
-.               ds e\\n(eP \\$1
-.               nr e\\n(eP 1
-.       \}
-.\}
-.el \{\
-.\" .tm dO: $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(ePEE
-.	rZ \\$1
-.	ie \\n(rZ \{\
-.\" .tm dO:rZ: $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(eP
-.		nr hP \\n(hP+1
-.		ds h\\n(hP \\$1
-.	\}
-.	el \{\
-.\" .tm dO:word $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(ePEE
-.		if \\n(eP==0:\\n(e\\n(eP==1 .nr eP \\n(eP+1
-.		if \\n(eZ .as e\\n(eP \& \&
-.		as e\\n(eP " \&\\$1
-.\" .		ds e\\n(eP \&\\$1
-.		nr eZ \\n(eZ+1
-.	\}
-.\}
-.nr oP 1
-.ie \\n(.$>1 \{\
-.	dO \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.\}
-.el \{\
-.     ie \\n(e1 \{\
-.\\*(e1 \\*(e2 \\*(e3 \\*(e4 \\*(e5 \\*(e6 \\*(e7 \\*(e8 \\*(e9
-.	\}
-.     el \{\
-.	as f1 \\*(e1
-.	\}
-.\}
-..
-.\" handle old style arguments such as the arg -Idir
-.\" in adb, .Oo is a toggle.
-.de Oo
-.ie \\n(oO .nr oO 0
-.el .nr oO 1
-..
-.\" stash punctuation
-.de oZ
-.if \\n(hP>=\\n(oZ \{\
-.	nr eP \\n(eP+1
-.	ds e\\n(eP \\*(h\\n(oZ
-.	nr oZ \\n(oZ+1
-.	oZ
-.\}
-..
-.\" clean up punctuation vector
-.de Oz
-.if \\n(hP>0 \{\
-.	rm h\\n(hP
-.	nr hP \\n(hP-1
-.	Oz
-.\}
-..
-.\" uO: go back up created vector cleaning it up along the way
-.de uO
-.if \\n(eP>0 \{\
-.	rm e\\n(eP
-.	rr e\\n(eP
-.	nr eP \\n(eP-1
-.	nr oP 0
-.	nr eZ 0
-.	uO
-.\}
-..
-.\" option end
-.de oE
-.uO
-.ie \\n(hP \{\
-.       as f1 \\*(rB\\*(h1\\*(h2\\*(h3
-.	Oz
-.	nr oZ 0
-.\}
-.el \{\
-.	as f1 \\*(rB
-.\}
-.ie "\\*(iM"Op" \{\
-.	if \\n(aO .aO
-.if t \{\
-.	if (\\n(.lu-\\n(.ku-\\n(.ou-(2*\\n(fWu))<\w'\fC\\*(f1'u .br
-.\}
-.if n \{\
-.	nr aa \w'\\*(f1'u
-.\" .	nr qq \\n(.lu-\\n(.ku-\\n(.ou
-.\" \&aa == \\n(aa, f1==\\*(f1, qq==\\n(qq
-.	if (\\n(.lu-\\n(.ku-\\n(.ou-\\n(aau)<=(8*\\n(fWu) .br
-.\}
-\&\\*(f1
-.	ds iM
-.	ds f1
-.	hy
-.\}
-.el .nr oE \\n(oE-1
-..
-.de aO
-.as f1 \\*(rB
-.nr aO \\n(aO-1
-.if \\n(aO >0 .aO
-..
-.\"
-.de Xr
-.if \\n(.$<=1 \{\
-.	ie \\n(.$==1 \{\
-.		if !"\\*(iM"" .as f1 \&\\*(xR\\$1\fP
-.		if "\\*(iM"" \&\\*(xR\\$1\fP
-.	\}
-.	el .tm Xr Usage: .Xr manpage_name section# \\*(Pu
-.\}
-.if \\n(.$==2 \{\
-.	rZ \\$2
-.	ie "\\*(iM"" \{\
-.		ie \\n(rZ \&\\*(xR\\$1\fP\\$2
-.		el \&\\*(xR\\$1\fP(\\$2)
-.	\}
-.	el \{\
-.		ie \\n(rZ .as f1 \&\\*(xR\\$1\fP\\$2
-.		el .as f1 \&\\*(xR\\$1\fP(\\$2)
-.	\}
-.\}
-.if \\n(.$>=3 \{\
-.	rZ \\$2
-.	ie \\n(rZ \{\
-.		ie !"\\*(iM"" .as f1 \&\\*(xR\\$1\fP\\$2\\$3\\$4\\$5\\$6\\$7\\$8
-.		el \&\\*(xR\\$1\fP\\$2\\$3\\$4\\$5\\$6\\$7\\$8
-.	\}
-.	el \{\
-.		rZ \\$3
-.		ie \\n(rZ \{\
-.			if !"\\*(iM"" \{\
-.			     as f1 \&\\*(xR\\$1\fP(\\$2)\\$3\\$4\\$5\\$6\\$7\\$8
-.			\}
-.			if "\\*(iM"" \{\
-\&\\*(xR\\$1\fP(\\$2)\\$3\\$4\\$5\\$6\\$7\\$8
-.			\}
-.		\}
-.		el \{\
-.			tm rZ = \\n(rZ  the arg is \\$3
-.			tm Xr-XX Usage: .Xr manpage_name section# \\*(Pu
-.		\}
-.	\}
-.\}
-..
-.\"
-.\"
-.de Ex
-.tm Ex defunct, Use .Dl: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-..
-.\" Display (one) Line of text.
-.de Dl
-.ie "\\*(iM"" \{\
-'	ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
-.	in \\n(.iu+\\n(Dsu
-.	mN \\$1
-.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	el \{\
-.		nr cF \\n(.f
-.\"	 Literal font is none specified
-\&\\*(lI\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.		ft \\n(cF
-.	\}
-.	in \\n(.iu-\\n(Dsu
-.\}
-.el \{\
-.	mN \\$1
-.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-.	el \{\
-.		nr cF \\n(.f
-.		ds f1 \&\\*(lI\\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-.		as f1 \&\f\\n(cF
-.	\}
-.\}
-..
-.\"
-.\"
-.\" user set Tagged Paragraph Width (used in both Dp and Tp)
-.de Tw
-.ie \\n(.$==0 \{\
-.	nr aa 0
-.\}
-.el \{\
-.	mN \\$1
-.	ie \\n(sW>2 \{\
-.		nr tW (\\n(sW+3)*\\n(fWu)
-.	\}
-.	el \{\
-.		ie \\n(mN .nr tW \\n(mN
-.		el .nr tW \\$1
-.	\}
-.	nr tF 1
-.\}
-..
-.\"
-.de Dw
-.Tw \\$1
-..
-.\"
-.de Di
-.ie \\n(.$==0 \{\
-.	nr tI \\n(Dsu
-.\}
-.el \{\
-.	sW \\$1
-.	if \\n(sW>=2 \{\
-.		nr tI \\$1u
-.	\}
-.	if \\n(sW<2 \{\
-.		if "\\$1"L" \{\
-.			nr tI 0
-.		\}
-.	\}
-.\}
-..
-.\" tagged paragraph
-.\" initialize baby stack variables
-.nr np 0
-.nr p1 0
-.ds s\n(np
-.\"
-.de Tp
-.ie "\\$1"" .pE p s np
-.el \{\
-.	ds iM Tp
-.	mN \\$1
-.	ie \\n(tF \{\
-.		ds tC Tw
-.		nr tC 1
-.		nr tF 0
-.	\}
-.	el \{\
-.		if !"Tw"\\*(s\\n(np" \{\
-.			ie \\n(mN \{\
-.				ds tC \\$1
-.				nr tW \\n(mN
-.			\}
-.			el \{\
-.				ds tC Tx
-.				nr tW \\n(Tx
-.			\}
-.			if !"\\*(tC"\\*(s\\n(np" .nr tC 1
-.		\}
-.	\}
-.	sp \\n(vVu
-.	if !\\n(cR .ne 2
-.	if \\n(tC \{\
-.		nr np \\n(np+1
-.		nr p\\n(np \\n(tW
-.		ds s\\n(np \\*(tC
-.		nr tC 0
-.		ds tC
-.		in \\n(.iu+\\n(p\\n(npu
-.	\}
-.	ie \\n(mN \{\
-.		ds f1
-.		\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.		if !"\\$1"Cx" .pT st p np
-.	\}
-.	el \{\
-.		br
-.		ev 1
-.		fi
-.		di Td
-\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.		br
-.		di
-.		ev
-.		na
-.		ds tD \\*(Td\\
-.		pT di p np
-.	\}
-.\}
-..
-.\"
-.\"
-.\" Complex Expression Macro
-.\"
-.\"	 TODO: add length across line boundary check (like Li)
-.de Cx
-.hy 0
-.ie \\n(.$==0 \{\
-.	if "\\*(iM"Cx" \{\
-.		ds iM
-.		if \\n(oE .oE
-\&\\*(f1
-.		ds f1
-.	\}
-.	if "\\*(iM"Tp" .pT st p np
-.	if "\\*(iM"Dp" .pT st q mp
-.\}
-.el \{\
-.	if "\\*(iM"" \{\
-.		ds iM Cx
-.		ds f1 \&
-.	\}
-.	mN \\$1
-.\" Here are the args: '\\$1'  '\\$2'  '\\$3'  '\\$4'
-.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	el \{\
-.		as f1 \&\\$1
-.		if \\n(.$>1 .Cx \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-.\}
-..
-.\" Prefix string in default font to content specified string
-.de Pf
-.Cx \\$1
-.\\$2 \\$3 \\$4 \\$5
-.Cx
-..
-.\" Suffix string in default font to content specified string
-.de Sf
-.Cx \\$1 \\$2
-.Cx \\$3
-.Cx
-..
-.\" Simple Option Begin
-.de Ob
-.hy 0
-.ie "\\*(iM"" \{\
-.	ev 2
-.	fi
-.	di oB
-.\}
-.el \{\
-.tm shouldn't be here
-.	as f1 \&
-.	mN \\$1
-.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	el \{\
-.		as f1 \&\\$1
-.		if \\n(.$>1 .Oc \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-.\}
-..
-.de Oc
-.as f1 \&\\$1
-.if \\n(.$>1 .Oc \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-..
-.de Oe
-.hy 0
-.ie "\\*(iM"" \{\
-.	br
-.	di
-.	ev
-.	ds bO \\*(oB\\
-\&\\*(bO\&
-.\}
-.el \{\
-.	as f1 \&
-.\}
-..
-.\" White space for Cx
-.de Ws
-.Cx \&\ \&
-..
-.\" tagged paragraph
-.\" initialize baby stack variables
-.nr mp 0
-.nr q1 0
-.ds r\n(np
-.\"
-.\" Complex Dp tag
-.de Dc
-.Dp Cx \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-..
-.\" Complex Tp tag
-.de Tc
-.Tp Cx \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-..
-.\" Tag with a flag and an argument with a space
-.de Ta
-.if "\\$2"" \{\
-.	Tp Fl \\$1
-.\}
-.el \{\
-.	Tp Fl \\$1
-.	Cx \&\ \&
-.	Ar \\$2 \\$3
-.	Cx
-.\}
-..
-.de Da
-.Dp Cx Fl \\$1
-.Ws
-.Ar \\$2 \\$3
-.Cx
-..
-.de To
-.Tp Cx Fl \\$1
-.Ar \\$2 \\$3
-.Cx
-..
-.de Do
-.Dp Cx Fl \\$1
-.Ar \\$2 \\$3
-.Cx
-..
-.\" Blended tag toggle
-.de Bt
-.ie \\n(tP==0 .nr tP 1
-.el .nr tP 0
-..
-.\" Bullet paragraph
-.de Bu
-.Tp Sy \&\(bu
-..
-.\" Display tagged paragraph
-.de Dp
-.ie "\\$1"" \{\
-.	pE q r mp
-.	sp \\n(vVu
-.\}
-.el \{\
-.       ds iM Dp
-.       mN \\$1
-.       ie \\n(tF \{\
-.               ds tC Tw
-.               nr tC 1
-.               nr tF 0
-.       \}
-.       el \{\
-.               if !"Tw"\\*(r\\n(mp" \{\
-.                       ie \\n(mN \{\
-.                               ds tC \\$1
-.                               nr tW \\n(mN
-.                       \}
-.                       el \{\
-.                               ds tC Tx
-.                               nr tW \\n(Tx
-.                       \}
-.                       if !"\\*(tC"\\*(r\\n(mp" .nr tC 1
-.               \}
-.       \}
-.       if !\\n(cR .ne 2
-.       if \\n(tC \{\
-.               nr mp \\n(mp+1
-.               nr q\\n(mp \\n(tW
-.               ds r\\n(mp \\*(tC
-.               nr tC 0
-.               ds tC
-.		ie \\n(tIu==\\n(Dsu .nr i\\n(mp \\n(Dsu
-.		el \{\
-.			nr i\\n(mp \\n(tIu
-.			nr tI \\n(Dsu
-.		\}
-.              	in \\n(.iu+\\n(i\\n(mpu
-.		sp \\n(vVu
-.		in \\n(.iu+\\n(\\q\\n(mpu
-.       \}
-.       ie \\n(mN \{\
-.               \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.               if !"\\$1"Cx" .pT st q mp
-.       \}
-.       el \{\
-.               br
-.               ev 1
-.               fi
-.               di Td
-\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.               br
-.               di
-.               ev
-.               na
-.               ds tD \\*(Td\\
-.               pT di q mp
-.       \}
-.\}
-..
-.\"
-.\" .pE number_stack string_stack counter
-.de pE
-.ie "\\$3"mp" \{\
-.	in \\n(.iu-(\\n(\\$1\\n(\\$3u)-(\\n(i\\n(mpu)
-.	rr i\\n(mp
-.\}
-.el .in \\n(.iu-\\n(\\$1\\n(\\$3u
-.\" .in \\n(.iu-\\n(\\$1\\n(\\$3u
-.if \\n(\\$3<=0 .tm Extraneous call .Tp or .Dp
-.rr \\$1\\n(\\$3
-.rm \\$2\\n(\\$3
-.nr \\$3 \\n(\\$3-1
-.ds iM
-..
-.\"
-.\" .pT st or di number_stack counter
-.de pT
-.ie "\\$1"st" \{\
-.	nr bb \\n(\\$2\\n(\\$3u
-.	ti -\\n(bbu
-.	ie (\\n(\\$2\\n(\\$3u-2n)<=\w'\\*(f1'u \{\&\\*(f1\\*(tP
-.		if \\n(tP==0 .br
-.	\}
-.	el \\*(f1\h'|\\n(\\$2\\n(\\$3u'\c
-.\}
-.el \{\
-.       ti -\\n(\\$2\\n(\\$3u
-.	ie (\\n(\\$2\\n(\\$3u-2n)<=\\n(dlu \{\&\\*(tD\\*(tP
-.	       if !\\n(tP .br
-.	\}
-.	el \\*(tD\h'|\\n(\\$2\\n(\\$3u'\c
-.	if t 'ad
-.\}
-.	ds iM
-.	ds f1
-'fi
-..
-.\"
-.\" The new SH
-.\"
-.de Sh
-.\" set Sh state off, check for list state before calling indent (.In)
-.nr nS 0
-.nr sE 0
-.ie "\\$1"NAME" \{\
-.\"	name state on, housekeep (headers & footers)
-.	hK
-'	in 0
-.\}
-.el \{\
-.	if "\\$1"SYNOPSIS" .nr nS 1
-.	in 0
-.\}
-.pL
-'sp
-.ns
-.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
-.if !\\n(cR .ne 3
-'fi
-\&\fB\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
-\&\fP\&
-.in \\n(.iu+\\n(Tiu
-.if "\\$1"SEE" .nr sE 1
-.ns
-..
-.\"
-.\" Nd minus sign for an en dash used in .Sh Name
-.de Nd
-\&\-\& \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-..
-.de Ss
-.sp
-.ti -.25i
-\&\fB\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
-\&\fP\&
-.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
-.if !\\n(cR .ne 2
-.br
-..
-.\"	.if "\\$1"Ss" .in \\n(.iu+\\n(sIu
-.\"..
-.\"
-.\"
-.\" Column Macro
-.\"
-.hy 0
-.de Cw
-.ie \\n(.$==0 \{\
-.	br
-.	in \\n(.iu-\\n(eWu
-.	ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
-.\}
-.el \{\
-.	Pp
-.	if \\n(.$==1 \{\
-.		ta \w'\\$1    'u
-.		nr eW \w'\\$1    'u
-'		in \\n(.iu+\\n(eWu
-.	\}
-.	if \\n(.$==2 \{\
-.		ta \w'\\$1    'u +\w'\\$2    'u
-.		nr eW \w'\\$1    'u+\w'\\$2    'u
-'		in \\n(.iu+\\n(eWu
-.	\}
-.	if \\n(.$==3 \{\
-.		ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u
-.		nr eW \w'\\$1    'u+\w'\\$2    'u+\w'\\$3    'u
-'		in \\n(.iu+\\n(eWu
-.	\}
-.	if \\n(.$==4 \{\
-.	ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u
-.	nr eW \w'\\$1    'u+\w'\\$2    'u+\w'\\$3    'u +\w'\\$4    'u
-'	in \\n(.iu+\\n(eWu
-.	\}
-.	if \\n(.$==5 \{\
-.ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u +\w'\\$5    'u
-.nr eW \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u +\w'\\$5    'u
-'	in \\n(.iu+\\n(eWu
-.	\}
-.\}
-..
-.de Cl
-.ti -\\n(eWu
-.mN \\$1
-.ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.el \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-..
-.nr dQ 0
-.de Ds
-.ie !"\\$1"" \{\
-.	mN d\\$1
-.	if \\n(mN \{\
-.		nr dQ \\n(dQ+1
-.		d\\$1
-.	\}
-.\}
-.el .br
-.nf
-..
-.de Df
-.ie !"\\$1"" \{\
-.       mN d\\$1
-.       if \\n(mN \{\
-.               nr dQ \\n(dQ+1
-.               d\\$1
-.       \}
-.\}
-.el .br
-..
-.de Dn
-\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.nf
-..
-.de dI
-.nr d\\n(dQ \\n(dIu
-.in \\n(.iu+\\n(dIu
-..
-.de dC
-.nr d\\n(dQ (\\n(.l-\\n(.i)/4u
-.in \\n(.iu+\\n(d\\n(dQu
-..
-.de dR
-.nr d\\n(dQ (\\n(.l/3)u
-.in \\n(.iu+\\n(d\\n(dQu
-..
-.de dL
-.nr aa 0
-..
-.de De
-.br
-.if \\n(d\\n(dQ \{\
-.	in \\n(.iu-\\n(d\\n(dQu
-.	rr d\\n(dQ
-.	nr dQ \\n(dQ-1
-.\}
-.fi
-..
-.\"
-.de Fn
-.ie \\n(.$==0 \{\
-.	tm Usage: .Fn function_name function_arg(s) ... \\*(Pu
-.\}
-.el \{\
-.	nr cF \\n(.f
-.	ie \\n(.$==1 .ds f1 \&\\*(nM\\$1\fP\\*(lP\fP\\*(rP\fP
-.	el \{\
-.		ds f1 \\*(nM\\$1\fP\\*(lP
-.		nr aa 0
-.		rC \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
-.	\}
-.	if "\\*(iM"" \{\\&\\*(f1
-.		ds f1
-.	\}
-.\}
-..
-.\"
-.de rC
-.rZ \\$1
-.ie \\n(rZ \{\
-.	as f1 \f\\n(cF\\*(rP\f\\n(cF\\$1\\$2\\$3\\$4\\$5\\$6\\$7
-.\}
-.el \{\
-.	ie \\n(aa .as f1 \fP, \\*(aR\\$1
-.	el .as f1 \\*(aR\\$1
-.	nr aa 1
-.	ie \\n(.$>1 .rC \\$2 \\$3 \\$4 \\$5 \\$6 \\$7
-.	el .as f1 \fP\\*(rP\fP
-.\}
-..
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=nroff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc-syms-u Deleted

@@ -1,891 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\"   The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc-syms	8.1 (Berkeley) 06/08/93
-.\"
-.\"     %beginstrip%
-.
-.
-.eo
-.
-.\" NS Ux user macro
-.\" NS   print UNIX
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Ux
-.\" NS
-.\" NS width register 'Ux' defined in doc-common
-.
-.de Ux
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Ux \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Ux
-.      doc-parse-args \$@
-.    \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr \*doc-Tn-font-sizeUNIX\*doc-str-Ux
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Bx user macro
-.\" NS   print BSD (fix smaller nroff version)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Bx
-.\" NS   doc-str-Bx1
-.\" NS   doc-str-Bx-XXX
-.\" NS
-.\" NS width register 'Bx' defined in doc-common
-.
-.ds doc-str-Bx-Reno  \-Reno
-.ds doc-str-Bx-reno  \-Reno
-.ds doc-str-Bx-Tahoe \-Tahoe
-.ds doc-str-Bx-tahoe \-Tahoe
-.ds doc-str-Bx-Lite  \-Lite
-.ds doc-str-Bx-lite  \-Lite
-.ds doc-str-Bx-Lite2 \-Lite2
-.ds doc-str-Bx-lite2 \-Lite2
-.
-.de Bx
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Bx \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Bx1 \*doc-Tn-font-sizeBSD\*doc-str-Bx
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Bx
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie        "\*doc-arg\ndoc-arg-ptr"-alpha" \
-.        as doc-str-Bx1 " (currently in alpha test)
-.      el \{ .ie "\*doc-arg\ndoc-arg-ptr"-beta" \
-.        as doc-str-Bx1 " (currently in beta test)
-.      el \{ .ie "\*doc-arg\ndoc-arg-ptr"-devel" \
-.        as doc-str-Bx1 " (currently under development)
-.      el \{\
-.        ds doc-str-Bx1 \&\*doc-arg\ndoc-arg-ptr\^\*doc-Tn-font-size
-.        as doc-str-Bx1 BSD\*doc-str-Bx
-.
-.        if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.          nr doc-arg-ptr +1
-.          ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.            ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.              ie d doc-str-Bx-\*doc-arg\ndoc-arg-ptr \
-.                as doc-str-Bx1 "\*doc-str-Bx-\*doc-arg\ndoc-arg-ptr
-.              el \
-.                nr doc-arg-ptr -1
-.            \}
-.            el \
-.              nr doc-arg-ptr -1
-.          \}
-.          el \
-.            nr doc-arg-ptr -1
-.    \}\}\}\}\}
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Bx1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Ud user macro (not parsed, not callable)
-.\" NS   print "currently under development" (HISTORY section)
-.\" NS
-.\" NS width register 'Ud' defined in doc-common
-.
-.de Ud
-.  nop \&currently under development.
-..
-.
-.
-.\" NS At user macro
-.\" NS   print AT&T UNIX
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-At
-.\" NS   doc-str-At1
-.\" NS   doc-str-At-XXX
-.\" NS
-.\" NS width register 'At' defined in doc-common
-.
-.ds doc-str-At-32v \&Version\~32V
-.as doc-str-At-32v " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v1  \&Version\~1
-.as doc-str-At-v1  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v2  \&Version\~2
-.as doc-str-At-v2  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v3  \&Version\~3
-.as doc-str-At-v3  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v4  \&Version\~4
-.as doc-str-At-v4  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v5  \&Version\~5
-.as doc-str-At-v5  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v6  \&Version\~6
-.as doc-str-At-v6  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-v7  \&Version\~7
-.as doc-str-At-v7  " \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.ds doc-str-At-III \*doc-Tn-font-sizeAT&T\*doc-str-At System\~III
-.as doc-str-At-III " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.ds doc-str-At-V   \*doc-Tn-font-sizeAT&T\*doc-str-At System\~V
-.as doc-str-At-V   " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.ds doc-str-At-V.1 \*doc-Tn-font-sizeAT&T\*doc-str-At System\~V Release\~1
-.as doc-str-At-V.1 " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.ds doc-str-At-V.2 \*doc-Tn-font-sizeAT&T\*doc-str-At System\~V Release\~2
-.as doc-str-At-V.2 " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.ds doc-str-At-V.3 \*doc-Tn-font-sizeAT&T\*doc-str-At System\~V Release\~3
-.as doc-str-At-V.3 " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.ds doc-str-At-V.4 \*doc-Tn-font-sizeAT&T\*doc-str-At System\~V Release\~4
-.as doc-str-At-V.4 " \*doc-Tn-font-sizeUNIX\*doc-str-At
-.
-.de At
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-At \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-At1 \*doc-Tn-font-sizeAT&T UNIX\*doc-str-At
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name At
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie \A&#x7;\*doc-arg\ndoc-arg-ptr&#x7; \{\
-.        ie d doc-str-At-\*doc-arg\ndoc-arg-ptr \
-.          ds doc-str-At1 "\*doc-str-At-\*doc-arg\ndoc-arg-ptr
-.        el \{\
-.          tmc mdoc warning: .At: Unknown AT&T UNIX version
-.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
-.          nr doc-arg-ptr -1
-.      \}\}
-.      el \
-.        nr doc-arg-ptr -1
-.    \}
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-At1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Dx user macro
-.\" NS   print DragonFly
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Dx
-.\" NS   doc-str-Dx1
-.\" NS
-.\" NS width register 'Dx' defined in doc-common
-.
-.\" we use the doc-operating-system-DragonFly-* strings defined in
-.\" doc-common
-.
-.de Dx
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Dx \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Dx1 \*doc-Tn-font-size\%DragonFly\*doc-str-Dx
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Dx
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie \A&#x7;\*doc-arg\ndoc-arg-ptr&#x7; \{\
-.        ie d doc-operating-system-DragonFly-\*doc-arg\ndoc-arg-ptr \
-.          as doc-str-Dx1 \~\*doc-operating-system-DragonFly-\*doc-arg\ndoc-arg-ptr
-.        el \{\
-.          tmc mdoc warning: .Dx: Unknown DragonFly version
-.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
-.          as doc-str-Dx1 \~\*doc-arg\ndoc-arg-ptr
-.      \}\}
-.      el \
-.        as doc-str-Dx1 \~\*doc-arg\ndoc-arg-ptr
-.    \}
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Dx1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Fx user macro
-.\" NS   print FreeBSD
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Fx
-.\" NS   doc-str-Fx1
-.\" NS
-.\" NS width register 'Fx' defined in doc-common
-.
-.\" we use the doc-operating-system-FreeBSD-* strings defined in
-.\" doc-common
-.
-.de Fx
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Fx \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Fx1 \*doc-Tn-font-size\%FreeBSD\*doc-str-Fx
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Fx
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie \A&#x7;\*doc-arg\ndoc-arg-ptr&#x7; \{\
-.        ie d doc-operating-system-FreeBSD-\*doc-arg\ndoc-arg-ptr \
-.          as doc-str-Fx1 \~\*doc-operating-system-FreeBSD-\*doc-arg\ndoc-arg-ptr
-.        el \{\
-.          tmc mdoc warning: .Fx: Unknown FreeBSD version
-.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
-.          as doc-str-Fx1 \~\*doc-arg\ndoc-arg-ptr
-.      \}\}
-.      el \
-.        as doc-str-Fx1 \~\*doc-arg\ndoc-arg-ptr
-.    \}
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Fx1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Nx user macro
-.\" NS   print NetBSD
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Nx
-.\" NS   doc-str-Nx1
-.\" NS
-.\" NS width register 'Nx' defined in doc-common
-.
-.\" we use the doc-operating-system-NetBSD-* strings defined in
-.\" doc-common
-.
-.de Nx
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Nx \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Nx1 \*doc-Tn-font-size\%N\s\ndoc-curr-sizeuet
-.  as doc-str-Nx1 \*doc-Tn-font-sizeBSD\*doc-str-Nx
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Nx
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie \A&#x7;\*doc-arg\ndoc-arg-ptr&#x7; \{\
-.        ie d doc-operating-system-NetBSD-\*doc-arg\ndoc-arg-ptr \
-.          as doc-str-Nx1 \~\*doc-operating-system-NetBSD-\*doc-arg\ndoc-arg-ptr
-.        el \{\
-.          tmc mdoc warning: .Nx: Unknown NetBSD version
-.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
-.          as doc-str-Nx1 \~\*doc-arg\ndoc-arg-ptr
-.      \}\}
-.      el \
-.        as doc-str-Nx1 \~\*doc-arg\ndoc-arg-ptr
-.    \}
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Nx1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Ox user macro
-.\" NS   print OpenBSD
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Ox
-.\" NS   doc-str-Ox1
-.\" NS
-.\" NS width register 'Ox' defined in doc-common
-.
-.de Ox
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Ox \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Ox1 \*doc-Tn-font-size\%OpenBSD\*doc-str-Ox
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Ox
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \
-.      as doc-str-Ox1 \~\*doc-arg\ndoc-arg-ptr
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Ox1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" NS Bsx user macro
-.\" NS   print BSD/OS
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Bsx
-.\" NS   doc-str-Bsx1
-.\" NS
-.\" NS width register 'Bsx' defined in doc-common
-.
-.de Bsx
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ds doc-str-Bsx \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.  \" default value if no argument
-.  ds doc-str-Bsx1 \*doc-Tn-font-sizeBSD/OS\*doc-str-Bsx
-.
-.  if !\ndoc-arg-limit \
-.    if \n.$ \{\
-.      ds doc-macro-name Bsx
-.      doc-parse-args \$@
-.    \}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \
-.      as doc-str-Bsx1 \~\*doc-arg\ndoc-arg-ptr
-.    el \
-.      nr doc-arg-ptr -1
-.  \}
-.
-.  \" replace current argument with result
-.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Bsx1
-.  nr doc-type\ndoc-arg-ptr 2
-.  ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.  \" recompute space vector for remaining arguments
-.  nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.  nr doc-arg-limit \ndoc-arg-ptr
-.  if \ndoc-num-args \
-.    doc-parse-space-vector
-.
-.  doc-print-recursive
-..
-.
-.
-.\" The Bt macro should go away now
-.
-.\" NS Bt user macro (not parsed, not callable)
-.\" NS   print "is currently in beta test." (HISTORY section)
-.\" NS
-.\" NS width register 'Bt' defined in doc-common
-.
-.de Bt
-.  nop \&is currently in beta test.
-..
-.
-.
-.\" NS Px user macro
-.\" NS   print POSIX
-.
-.ds Px \*doc-Tn-font-size\%POSIX
-.
-.
-.\" NS Ai user macro
-.\" NS   print ANSI
-.
-.ds Ai \*doc-Tn-font-size\%ANSI
-.
-.
-.\" NS St user macro
-.\" NS   standards (posix, ansi - formal standard names)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-reg-St
-.\" NS   doc-str-St
-.\" NS   doc-str-St1
-.\" NS   doc-str-St-XXX
-.\" NS
-.\" NS width register 'St' defined in doc-common
-.
-.\" ANSI/ISO C
-.ds doc-str-St--ansiC-89       \*Ai \*doc-str-StX\^3.159-1989
-.as doc-str-St--ansiC-89       " (\*Lq\)\*Ai\~C89\*doc-str-St\*Rq)
-.als doc-str-St--ansiC doc-str-St--ansiC-89
-.ds doc-str-St--isoC           \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899:1990
-.as doc-str-St--isoC           " (\*Lq\*doc-Tn-font-sizeISO\~C\^90\*doc-str-St\*Rq)
-.als doc-str-St--isoC-90 doc-str-St--isoC
-.ds doc-str-St--isoC-2011      \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899:2011
-.as doc-str-St--isoC-2011      " (\*Lq\*doc-Tn-font-sizeISO\~C\^11\*doc-str-St\*Rq)
-.ds doc-str-St--isoC-99        \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899:1999
-.as doc-str-St--isoC-99        " (\*Lq\*doc-Tn-font-sizeISO\~C\^99\*doc-str-St\*Rq)
-.ds doc-str-St--isoC-amd1       \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899/AMD1:1995
-.as doc-str-St--isoC-amd1       " (\*Lq\*doc-Tn-font-sizeISO\~C\^90\*doc-str-St, Amendment 1\*Rq)
-.ds doc-str-St--isoC-tcor1      \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899/TCOR1:1994
-.as doc-str-St--isoC-tcor1      " (\*Lq\*doc-Tn-font-sizeISO\~C\^90\*doc-str-St, Technical Corrigendum 1\*Rq)
-.ds doc-str-St--isoC-tcor2      \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9899/TCOR2:1995
-.as doc-str-St--isoC-tcor2      " (\*Lq\*doc-Tn-font-sizeISO\~C\^90\*doc-str-St, Technical Corrigendum 2\*Rq)
-.
-.\" POSIX Part 1: System API
-.ds doc-str-St--p1003.1        \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1
-.as doc-str-St--p1003.1        " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1b       \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1b
-.as doc-str-St--p1003.1b       " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-88     \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1-1988
-.as doc-str-St--p1003.1-88     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-90     \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9945-1:1990
-.as doc-str-St--p1003.1-90     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.als doc-str-St--iso9945-1-90 doc-str-St--p1003.1-90
-.ds doc-str-St--p1003.1b-93    \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1b-1993
-.as doc-str-St--p1003.1b-93    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1c-95    \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1c-1995
-.as doc-str-St--p1003.1c-95    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1i-95    \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1i-1995
-.as doc-str-St--p1003.1i-95    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-96     \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9945-1:1996
-.as doc-str-St--p1003.1-96     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.als doc-str-St--iso9945-1-96 doc-str-St--p1003.1-96
-.ds doc-str-St--p1003.1g-2000  \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1g-2000
-.as doc-str-St--p1003.1g-2000  " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-2001   \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1-2001
-.as doc-str-St--p1003.1-2001   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-2004   \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1-2004
-.as doc-str-St--p1003.1-2004   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.ds doc-str-St--p1003.1-2008   \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.1-2008
-.as doc-str-St--p1003.1-2008   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
-.
-.\" POSIX Part 2: Shell and Utilities
-.ds doc-str-St--p1003.2        \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.2
-.as doc-str-St--p1003.2        " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
-.ds doc-str-St--p1003.2-92     \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.2-1992
-.as doc-str-St--p1003.2-92     " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
-.ds doc-str-St--p1003.2a-92    \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1003.2a-1992
-.as doc-str-St--p1003.2a-92    " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
-.ds doc-str-St--iso9945-2-93   \*doc-Tn-font-sizeISO/IEC\*doc-str-St 9945-2:1993
-.as doc-str-St--iso9945-2-93   " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
-.
-.\" X/Open
-.ds doc-str-St--susv2          Version\~2 of the Single \*doc-Tn-font-sizeUNIX\*doc-str-St Specification
-.as doc-str-St--susv2          " (\*Lq\*doc-Tn-font-sizeSUSv2\*doc-str-St\*Rq)
-.ds doc-str-St--susv3          Version\~3 of the Single \*doc-Tn-font-sizeUNIX\*doc-str-St Specification
-.as doc-str-St--susv3          " (\*Lq\*doc-Tn-font-sizeSUSv3\*doc-str-St\*Rq)
-.ds doc-str-St--svid4          System\~V Interface Definition, Fourth Edition
-.as doc-str-St--svid4          " (\*Lq\*doc-Tn-font-sizeSVID\*doc-str-St\^4\*Rq)
-.ds doc-str-St--xbd5           \*doc-Tn-font-sizeX/Open\*doc-str-St Base Definitions Issue\~5
-.as doc-str-St--xbd5           " (\*Lq\*doc-Tn-font-sizeXBD\*doc-str-St\^5\*Rq)
-.ds doc-str-St--xcu5           \*doc-Tn-font-sizeX/Open\*doc-str-St Commands and Utilities Issue\~5
-.as doc-str-St--xcu5           " (\*Lq\*doc-Tn-font-sizeXCU\*doc-str-St\^5\*Rq)
-.ds doc-str-St--xcurses4.2     \*doc-Tn-font-sizeX/Open\*doc-str-St Curses Issue\~4, Version\~2
-.as doc-str-St--xcurses4.2     " (\*Lq\*doc-Tn-font-sizeXCURSES\*doc-str-St\^4.2\*Rq)
-.ds doc-str-St--xns5           \*doc-Tn-font-sizeX/Open\*doc-str-St Networking Services Issue\~5
-.as doc-str-St--xns5           " (\*Lq\*doc-Tn-font-sizeXNS\*doc-str-St\^5\*Rq)
-.ds doc-str-St--xns5.2         \*doc-Tn-font-sizeX/Open\*doc-str-St Networking Services Issue\~5.2
-.as doc-str-St--xns5.2         " (\*Lq\*doc-Tn-font-sizeXNS\*doc-str-St\^5.2\*Rq)
-.ds doc-str-St--xpg3           \*doc-Tn-font-sizeX/Open\*doc-str-St Portability Guide Issue\~3
-.as doc-str-St--xpg3           " (\*Lq\*doc-Tn-font-sizeXPG\*doc-str-St\^3\*Rq)
-.ds doc-str-St--xpg4           \*doc-Tn-font-sizeX/Open\*doc-str-St Portability Guide Issue\~4
-.as doc-str-St--xpg4           " (\*Lq\*doc-Tn-font-sizeXPG\*doc-str-St\^4\*Rq)
-.ds doc-str-St--xpg4.2         \*doc-Tn-font-sizeX/Open\*doc-str-St Portability Guide Issue\~4, Version\~2
-.as doc-str-St--xpg4.2         " (\*Lq\*doc-Tn-font-sizeXPG\*doc-str-St\^4.2\*Rq)
-.ds doc-str-St--xsh5           \*doc-Tn-font-sizeX/Open\*doc-str-St System Interfaces and Headers Issue\~5
-.as doc-str-St--xsh5           " (\*Lq\*doc-Tn-font-sizeXSH\*doc-str-St\^5\*Rq)
-.
-.\" Miscellaneous
-.ds doc-str-St--ieee754        \*doc-Tn-font-size\%IEEE\*doc-str-St Std 754-1985
-.ds doc-str-St--ieee1275-94     \*doc-Tn-font-size\%IEEE\*doc-str-St Std 1275-1994
-.as doc-str-St--ieee1275-94     " (\*Lq\*doc-Tn-font-sizeOpen Firmware\*doc-str-St\*Rq)
-.ds doc-str-St--iso8601        \*doc-Tn-font-sizeISO\*doc-str-St 8601
-.ds doc-str-St--iso8802-3      \*doc-Tn-font-sizeISO/IEC\*doc-str-St 8802-3:1989
-.
-.de St
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name St
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      doc-St-usage
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    ds doc-str-St \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.    ds doc-str-St1
-.    ie \A&#x7;\*doc-arg\ndoc-arg-ptr&#x7; \{\
-.      ie d doc-str-St-\*doc-arg\ndoc-arg-ptr \
-.        ds doc-str-St1 "\*doc-str-St-\*doc-arg\ndoc-arg-ptr
-.      el \{\
-.        tmc "mdoc warning: .St: Unknown standard abbreviation
-.        tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
-.        tm1 "              Please refer to the groff_mdoc(7) manpage for a
-.        tm1 "              list of available standard abbreviations.
-.    \}\}
-.    el \
-.      doc-St-usage
-.
-.    \" replacing argument with result
-.    ds doc-arg\ndoc-arg-ptr "\*doc-str-St1
-.
-.    doc-print-recursive
-.  \}
-.  el \{\
-.    doc-St-usage
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS doc-St-usage macro
-.
-.de doc-St-usage
-.  tm1 "Usage: .St standard (#\n.c)
-.  tm1 "       Please refer to the groff_mdoc(7) manpage for a list of
-.  tm1 "       available standard abbreviations.
-..
-.
-.
-.\" NS Lb user macro
-.\" NS   formal library names for LIBRARY sections
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-reg-Lb
-.\" NS   doc-str-Lb
-.\" NS   doc-str-Lb1
-.\" NS   doc-str-Lb-XXX
-.\" NS
-.\" NS width register 'Lb' defined in doc-common
-.
-.ds doc-str-Lb-libarchive  Reading and Writing Streaming Archives Library (libarchive, \-larchive)
-.ds doc-str-Lb-libarm      ARM Architecture Library (libarm, \-larm)
-.ds doc-str-Lb-libarm32    ARM32 Architecture Library (libarm32, \-larm32)
-.ds doc-str-Lb-libbluetooth Bluetooth Library (libbluetooth, \-lbluetooth)
-.ds doc-str-Lb-libbsm      Basic Security Module Library (libbsm, \-lbsm)
-.ds doc-str-Lb-libc        Standard C\~Library (libc, \-lc)
-.ds doc-str-Lb-libc_r      Reentrant C\~Library (libc_r, \-lc_r)
-.ds doc-str-Lb-libcalendar Calendar Arithmetic Library (libcalendar, \-lcalendar)
-.ds doc-str-Lb-libcam      Common Access Method User Library (libcam, \-lcam)
-.ds doc-str-Lb-libcdk      Curses Development Kit Library (libcdk, \-lcdk)
-.ds doc-str-Lb-libcipher   FreeSec Crypt Library (libcipher, \-lcipher)
-.ds doc-str-Lb-libcompat   Compatibility Library (libcompat, \-lcompat)
-.ds doc-str-Lb-libcrypt    Crypt Library (libcrypt, \-lcrypt)
-.ds doc-str-Lb-libcurses   Curses Library (libcurses, \-lcurses)
-.ds doc-str-Lb-libdevinfo  Device and Resource Information Utility Library (libdevinfo, \-ldevinfo)
-.ds doc-str-Lb-libdevstat  Device Statistics Library (libdevstat, \-ldevstat)
-.ds doc-str-Lb-libdisk     Interface to Slice and Partition Labels Library (libdisk, \-ldisk)
-.ds doc-str-Lb-libdwarf    DWARF Access Library (libdwarf, \-ldwarf)
-.ds doc-str-Lb-libedit     Command Line Editor Library (libedit, \-ledit)
-.ds doc-str-Lb-libelf      ELF Access Library (libelf, \-lelf)
-.ds doc-str-Lb-libevent    Event Notification Library (libevent, \-levent)
-.ds doc-str-Lb-libfetch    File Transfer Library for URLs (libfetch, \-lfetch)
-.ds doc-str-Lb-libform     Curses Form Library (libform, \-lform)
-.ds doc-str-Lb-libgeom     Userland API Library for kernel GEOM subsystem (libgeom, \-lgeom)
-.ds doc-str-Lb-libgpib     General-Purpose Instrument Bus (GPIB) library (libgpib, \-lgpib)
-.ds doc-str-Lb-libi386     i386 Architecture Library (libi386, \-li386)
-.ds doc-str-Lb-libintl     Internationalized Message Handling Library (libintl, \-lintl)
-.ds doc-str-Lb-libipsec    IPsec Policy Control Library (libipsec, \-lipsec)
-.ds doc-str-Lb-libipx      IPX Address Conversion Support Library (libipx, \-lipx)
-.ds doc-str-Lb-libiscsi    iSCSI protocol library (libiscsi, \-liscsi)
-.ds doc-str-Lb-libjail     Jail Library (libjail, \-ljail)
-.ds doc-str-Lb-libkiconv   Kernel side iconv library (libkiconv, \-lkiconv)
-.ds doc-str-Lb-libkse      N:M Threading Library (libkse, \-lkse)
-.ds doc-str-Lb-libkvm      Kernel Data Access Library (libkvm, \-lkvm)
-.ds doc-str-Lb-libm        Math Library (libm, \-lm)
-.ds doc-str-Lb-libm68k     m68k Architecture Library (libm68k, \-lm68k)
-.ds doc-str-Lb-libmagic    Magic Number Recognition Library (libmagic, \-lmagic)
-.ds doc-str-Lb-libmd       Message Digest (MD4, MD5, etc.) Support Library (libmd, \-lmd)
-.ds doc-str-Lb-libmemstat  Kernel Memory Allocator Statistics Library (libmemstat, \-lmemstat)
-.ds doc-str-Lb-libmenu     Curses Menu Library (libmenu, \-lmenu)
-.ds doc-str-Lb-libnetgraph Netgraph User Library (libnetgraph, \-lnetgraph)
-.ds doc-str-Lb-libnetpgp   Netpgp signing, verification, encryption and decryption (libnetpgp, \-lnetpgp)
-.ds doc-str-Lb-libossaudio OSS Audio Emulation Library (libossaudio, \-lossaudio)
-.ds doc-str-Lb-libpam      Pluggable Authentication Module Library (libpam, \-lpam)
-.ds doc-str-Lb-libpcap     Packet Capture Library (libpcap, \-lpcap)
-.ds doc-str-Lb-libpci      PCI Bus Access Library (libpci, \-lpci)
-.ds doc-str-Lb-libpmc      Performance Counters Library (libpmc, \-lpmc)
-.ds doc-str-Lb-libposix    \*Px \*doc-str-LbCompatibility Library (libposix, \-lposix)
-.ds doc-str-Lb-libprop     Property Container Object Library (libprop, \-lprop)
-.ds doc-str-Lb-libpthread  \*Px \*doc-str-LbThreads Library (libpthread, \-lpthread)
-.ds doc-str-Lb-libpuffs    puffs Convenience Library (libpuffs, \-lpuffs)
-.ds doc-str-Lb-librefuse   File System in Userspace Convenience Library (librefuse, \-lrefuse)
-.ds doc-str-Lb-libresolv   DNS Resolver Library (libresolv, \-lresolv)
-.ds doc-str-Lb-librpcsec_gss RPC GSS-API Authentication Library (librpcsec_gss, \-lrpcsec_gss)
-.ds doc-str-Lb-librpcsvc   RPC Service Library (librpcsvc, \-lrpcsvc)
-.ds doc-str-Lb-librt       \*Px \*doc-str-LbReal-time Library (librt, \-lrt)
-.ds doc-str-Lb-libsdp      Bluetooth Service Discovery Protocol User Library (libsdp, \-lsdp)
-.ds doc-str-Lb-libssp      Buffer Overflow Protection Library (libssp, \-lssp)
-.ds doc-str-Lb-libSystem   System Library (libSystem, \-lSystem)
-.ds doc-str-Lb-libtermcap  Termcap Access Library (libtermcap, \-ltermcap)
-.ds doc-str-Lb-libterminfo Terminal Information Library (libterminfo, \-lterminfo)
-.ds doc-str-Lb-libthr      1:1 Threading Library (libthr, \-lthr)
-.ds doc-str-Lb-libufs      UFS File System Access Library (libufs, \-lufs)
-.ds doc-str-Lb-libugidfw   File System Firewall Interface Library (libugidfw, \-lugidfw)
-.ds doc-str-Lb-libulog     User Login Record Library (libulog, \-lulog)
-.ds doc-str-Lb-libusbhid   USB Human Interface Devices Library (libusbhid, \-lusbhid)
-.ds doc-str-Lb-libutil     System Utilities Library (libutil, \-lutil)
-.ds doc-str-Lb-libvgl      Video Graphics Library (libvgl, \-lvgl)
-.ds doc-str-Lb-libx86_64   x86_64 Architecture Library (libx86_64, \-lx86_64)
-.ds doc-str-Lb-libz        Compression Library (libz, \-lz)
-.
-.de Lb
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Lb
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Lb library_name ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    ds doc-str-Lb \f\ndoc-curr-font\s\ndoc-curr-sizeu
-.
-.    ie d doc-str-Lb-\*doc-arg\ndoc-arg-ptr \
-.      ds doc-str-Lb1 "\*doc-str-Lb-\*doc-arg\ndoc-arg-ptr
-.    el \{\
-.      tmc "mdoc warning: .Lb: no description for library
-.      tm1 " '\*doc-arg\ndoc-arg-ptr' available (#\n.c)
-.      ds doc-str-Lb1 library \*Lq\*doc-arg\ndoc-arg-ptr\*Rq
-.    \}
-.
-.    \" replacing argument with result
-.    ds doc-arg\ndoc-arg-ptr "\*doc-str-Lb1
-.
-.    if \ndoc-in-library-section \
-.      br
-.    doc-print-recursive
-.    if \ndoc-in-library-section \
-.      br
-.  \}
-.  el \{\
-.    tm Usage: .Lb library_name ... (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.ec
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/doc.tmac-u Deleted

@@ -1,6582 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\"   The Regents of the University of California.  All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\" 3. Deleted.  See
-.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
-.\" 4. Neither the name of the University nor the names of its
-.\"    contributors may be used to endorse or promote products derived
-.\"    from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
-.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
-.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
-.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\"     @(#)doc	8.1 (Berkeley) 06/08/93
-.\"
-.\" Modified by jjc@jclark.com as follows: the doc-* files are assumed
-.\" to be installed as mdoc/doc-* rather than tmac.doc-* (the filename
-.\" 'tmac.doc-common' would be too long); when using groff, the doc-*
-.\" files are loaded using the 'mso' request.
-.\"
-.\" Modified by
-.\"
-.\"   Werner LEMBERG <wl@gnu.org>      and
-.\"   Ruslan Ermilov <ru@freebsd.org>
-.\"
-.\" to make it more readable: using long names and many groff features,
-.\" updating and extending documentation, etc.
-.\"
-.\" %beginstrip%
-.
-.
-.if !\n(.g \
-.  ab This version of mdoc can be run with GNU troff only!
-.
-.
-.do if d Dd .nx
-.
-.
-.cp 0
-.
-.
-.if (\n.x\n.y < 118) \
-.  ab You need GNU troff version 1.18 or higher to run this version of mdoc!
-.
-.
-.\" Load start-up files
-.ie t \
-.  mso mdoc/doc-ditroff
-.el \
-.  mso mdoc/doc-nroff
-.
-.mso mdoc/doc-common
-.mso mdoc/doc-syms
-.
-.
-.eo
-.
-.
-.\" NS doc-macro-name global string
-.\" NS   name of calling request (set in each user-requestable macro)
-.
-.ds doc-macro-name
-.als doc-arg0 doc-macro-name
-.
-.
-.\" NS doc-arg-limit global register
-.\" NS   total number of arguments
-.
-.nr doc-arg-limit 0
-.
-.
-.\" NS doc-num-args global register
-.\" NS   number of arguments to handle (must be set to \n.$ prior to
-.\" NS   'doc-parse-arg-vector' request)
-.
-.nr doc-num-args 0
-.
-.
-.\" NS doc-arg-ptr global register
-.\" NS   argument pointer
-.
-.nr doc-arg-ptr 0
-.
-.
-.\" NS doc-argXXX global string
-.\" NS   argument vector
-.\" NS
-.\" NS limit:
-.\" NS   doc-arg-limit
-.
-.ds doc-arg1
-.
-.
-.\" NS doc-typeXXX global register
-.\" NS   argument type vector (macro=1, string=2, punctuation suffix=3,
-.\" NS   punctuation prefix=4)
-.\" NS
-.\" NS limit:
-.\" NS   doc-arg-limit
-.
-.nr doc-type1 0
-.
-.
-.\" NS doc-spaceXXX global string
-.\" NS   space vector
-.\" NS
-.\" NS limit:
-.\" NS   doc-arg-limit
-.
-.ds doc-space1
-.
-.
-.\" NS doc-parse-args macro
-.\" NS   parse arguments (recursively) ('.doc-parse-args arg ...')
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-spaceXXX
-.\" NS   doc-typeXXX
-.\" NS   doc-arg-ptr
-.\" NS   doc-have-space
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dpa
-.\" NS   doc-reg-dpa1
-.\" NS   doc-str-dpa
-.
-.de doc-parse-args
-.  if !\ndoc-arg-limit \
-.    doc-set-spacing-1
-.
-.  nr doc-have-space 0
-.
-.  if !\n.$ \
-.    return
-.
-.  nr doc-arg-limit +1
-.
-.  \" handle '|' and '...' specially
-.  ie        "\$1"|" \
-.    ds doc-arg\ndoc-arg-limit \fR|\f
-.  el \{ .ie "\$1"..." \
-.    ds doc-arg\ndoc-arg-limit \|.\|.\|.
-.  el \
-.    ds doc-arg\ndoc-arg-limit "\$1
-.  \}
-.
-.  \" get argument type and set spacing
-.  doc-get-arg-type* \ndoc-arg-limit
-.  nr doc-type\ndoc-arg-limit \ndoc-arg-type
-.  doc-set-spacing-\ndoc-arg-type
-.
-.  \" check whether we have processed the last parameter
-.  ie (\n.$ == 1) \
-.    nr doc-arg-ptr 0
-.  el \{\
-.    shift
-.    doc-parse-args \$@
-.  \}
-.
-.  nh
-..
-.
-.
-.\" NS doc-parse-arg-vector macro
-.\" NS   parse argument vector (recursive)
-.\" NS
-.\" NS   cf. comments in doc-parse-args
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-num-args
-.\" NS   doc-spaceXXX
-.\" NS   doc-typeXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dpav
-.\" NS   doc-reg-dpav1
-.\" NS   doc-str-dpav
-.
-.de doc-parse-arg-vector
-.  if !\ndoc-arg-limit \
-.    doc-set-spacing-1
-.
-.  nr doc-arg-limit +1
-.
-.  ie        "\*doc-arg\ndoc-arg-limit"|" \
-.    ds doc-arg\ndoc-arg-limit \fR|\f
-.  el \{ .if "\*doc-arg\ndoc-arg-limit"..." \
-.    ds doc-arg\ndoc-arg-limit \|.\|.\|.
-.  \}
-.
-.  doc-get-arg-type* \ndoc-arg-limit
-.  nr doc-type\ndoc-arg-limit \ndoc-arg-type
-.  doc-set-spacing-\ndoc-arg-type
-.
-.  ie (\ndoc-num-args == 1) \{\
-.    nr doc-arg-ptr 0
-.    nr doc-num-args 0
-.  \}
-.  el \{\
-.    nr doc-num-args -1
-.    doc-parse-arg-vector
-.  \}
-.
-.  nh
-..
-.
-.
-.\" NS doc-parse-space-vector macro
-.\" NS   parse space vector (recursive)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-num-args
-.\" NS   doc-spaceXXX
-.
-.de doc-parse-space-vector
-.  nr doc-arg-limit +1
-.
-.  doc-set-spacing-\ndoc-type\ndoc-arg-limit
-.
-.  ie (\ndoc-num-args == 1) \
-.    nr doc-num-args 0
-.  el \{\
-.    nr doc-num-args -1
-.    doc-parse-space-vector
-.  \}
-..
-.
-.
-.\" NS doc-remaining-args macro
-.\" NS   output remaining arguments as-is, separated by spaces (until
-.\" NS   'doc-num-args' is exhausted)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-num-args
-.
-.de doc-remaining-args
-.  nr doc-arg-ptr +1
-.  nop \)\*doc-arg\ndoc-arg-ptr\c
-.
-.  ie (\ndoc-num-args == 1) \{\
-.    nr doc-arg-ptr 0
-.    nr doc-num-args 0
-.  \}
-.  el \{\
-.    nop \)\*doc-space\c
-.    nr doc-num-args -1
-.    doc-remaining-args
-.  \}
-..
-.
-.
-.\" NS doc-append-arg macro
-.\" NS   append one argument to argument vector:
-.\" NS   '.doc-append-arg arg type'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-argXXX
-.\" NS   doc-typeXXX
-.
-.de doc-append-arg
-.  nr doc-arg-limit +1
-.  ds doc-arg\ndoc-arg-limit "\$1
-.  nr doc-type\ndoc-arg-limit \$2
-.  doc-set-spacing-\$2
-..
-.
-.
-.\" NS doc-print-and-reset macro
-.\" NS   finish input line and clean up argument vectors
-.
-.de doc-print-and-reset
-.  if \ndoc-space-mode \
-.    nop \)
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-reset-args macro
-.\" NS   reset argument counters
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-arg-ptr
-.\" NS   doc-have-slot
-.
-.de doc-reset-args
-.  nr doc-arg-limit 0
-.  nr doc-arg-ptr 0
-.  nr doc-have-slot 0
-.
-.  hy \ndoc-hyphen-flags
-..
-.
-.
-.ec
-.
-.\" NS doc-curr-font global register
-.\" NS   saved current font
-.
-.nr doc-curr-font \n.f
-.
-.
-.\" NS doc-curr-size global register
-.\" NS   saved current font size
-.
-.nr doc-curr-size \n.ps
-.
-.eo
-.
-.
-.\" NS Fl user macro
-.\" NS   handle flags (appends '-' and prints flags): '.Fl arg ...'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Fl (for communication with doc-flag-recursion)
-.\" NS
-.\" NS width register 'Fl' set in doc-common
-.
-.de Fl
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  nop \*doc-Fl-font\c
-.
-.  if !\ndoc-arg-limit \{\
-.    ds doc-macro-name Fl
-.    doc-parse-args \$@
-.
-.    \" no arguments
-.    if !\n.$ \
-.      nop \|\-\|\f\s0
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    \" last argument
-.    nop \|\-\f\s0\c
-.    doc-print-and-reset
-.  \}
-.  el \{\
-.    ie (\ndoc-type\ndoc-arg-ptr == 1) \{\
-.      nop \|\-\f\s0\c
-.      \*doc-arg\ndoc-arg-ptr
-.    \}
-.    el \{\
-.      if (\ndoc-type\ndoc-arg-ptr == 3) \
-.        nop \|\-\|\c
-.
-.      nr doc-reg-Fl 1
-.      doc-flag-recursion
-.  \}\}
-..
-.
-.
-.\" NS doc-flag-recursion macro
-.\" NS   'Fl' flag recursion routine (special handling)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dfr
-.\" NS   doc-reg-dfr1
-.\" NS   doc-str-dfr
-.
-.de doc-flag-recursion
-.  nr doc-reg-dfr1 \ndoc-type\ndoc-arg-ptr
-.  ds doc-str-dfr "\*doc-arg\ndoc-arg-ptr
-.
-.  ie (\ndoc-reg-dfr1 == 1) \{\
-.    nop \f\s0\c
-.    \*doc-str-dfr
-.  \}
-.  el \{\
-.    nr doc-reg-dfr \ndoc-arg-ptr
-.
-.    ie (\ndoc-reg-dfr1 == 2) \{\
-.      \" handle vertical bar -- doc-reg-Fl is set for the first call of
-.      \" doc-flag-recursion only; we need this to make '.Fl | ...' work
-.      \" correctly
-.      ie "\*doc-str-dfr"\*Ba" \{\
-.        if \ndoc-reg-Fl \
-.          nop \|\-\*doc-space\c
-.        nop \)\*Ba\c
-.      \}
-.      el \{\
-.        ie "\*doc-str-dfr"\fR|\f" \{\
-.          if \ndoc-reg-Fl \
-.            nop \|\-\*doc-space\c
-.          nop \fR|\f\c
-.        \}
-.        el \{\
-.          \" two consecutive hyphen characters?
-.          ie "\*doc-str-dfr"-" \
-.            nop \|\-\^\-\|\c
-.          el \
-.            nop \|\%\-\*doc-str-dfr\&\c
-.    \}\}\}
-.    el \{\
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.      nop \)\*doc-str-dfr\f\s0\c
-.    \}
-.
-.    ie (\ndoc-arg-limit == \ndoc-arg-ptr) \{\
-.      \" last argument
-.      if (\ndoc-reg-dfr1 == 4) \
-.        nop \|\-\c
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.      doc-print-and-reset
-.    \}
-.    el \{\
-.      nr doc-arg-ptr +1
-.      ie (\ndoc-type\ndoc-arg-ptr == 3) \{\
-.        ie (\ndoc-type\ndoc-reg-dfr == 4) \
-.          nop \|\-\c
-.        el \
-.          nop \)\*doc-space\ndoc-reg-dfr\c
-.      \}
-.      el \
-.        nop \)\*doc-space\ndoc-reg-dfr\c
-.
-.      shift
-.      nr doc-reg-Fl 0
-.      doc-flag-recursion \$@
-.  \}\}
-..
-.
-.
-.\" NS doc-print-recursive macro
-.\" NS   general name recursion routine (print remaining arguments)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dpr
-.\" NS   doc-reg-dpr1
-.\" NS   doc-str-dpr
-.
-.de doc-print-recursive
-.  nr doc-reg-dpr1 \ndoc-type\ndoc-arg-ptr
-.  ds doc-str-dpr "\*doc-arg\ndoc-arg-ptr
-.
-.  ie (\ndoc-reg-dpr1 == 1) \{\
-.    nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.    \*doc-str-dpr
-.  \}
-.  el \{\
-.    nr doc-reg-dpr \ndoc-arg-ptr
-.
-.    \" the '\%' prevents hyphenation on a dash ('-')
-.    ie (\ndoc-reg-dpr1 == 2) \
-.      nop \%\*doc-str-dpr\&\c
-.    el \{\
-.      \" punctuation character
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.      nop \)\*doc-str-dpr\f\s0\c
-.    \}
-.
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.      \" last argument
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.      doc-print-and-reset
-.    \}
-.    el \{\
-.      nop \)\*doc-space\ndoc-reg-dpr\c
-.      doc-print-recursive
-.  \}\}
-..
-.
-.
-.\" NS doc-print-prefixes macro
-.\" NS   print leading prefixes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.
-.de doc-print-prefixes
-.  while (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    if !(\ndoc-type\ndoc-arg-ptr == 4) \
-.      break
-.    nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.    nop \)\*doc-arg\ndoc-arg-ptr\f\s0\c
-.    nr doc-arg-ptr +1
-.  \}
-..
-.
-.
-.\" NS doc-generic-macro macro
-.\" NS   this is the skeleton for most simple macros
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.
-.de doc-generic-macro
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name \$0
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .\$0 \*doc-\$0-usage ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    if (\ndoc-type\ndoc-arg-ptr == 1) \{\
-.      tmc mdoc warning: Using a macro as first argument
-.      tm1 " cancels effect of .\$0 (#\n.c)
-.
-.      \" the right action here would be to reset the argument counters
-.      \" and bail out -- unfortunately, a small number of manual pages
-.      \" (less than 2% for FreeBSD which has been used for testing)
-.      \" relied on the old behaviour (silently ignore this error),
-.      \" so it is commented out
-.
-.\"    doc-reset-args
-.    \}
-.\"  el \{\
-.      nr doc-curr-font \n.f
-.      nr doc-curr-size \n.ps
-.      nop \*doc-\$0-font\c
-.      doc-print-recursive
-.\"  \}
-.  \}
-.  el \{\
-.    tm Usage: .\$0 \*doc-\$0-usage ... (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Ar user macro
-.\" NS   command-line 'argument' macro: '.Ar args ...'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variable:
-.\" NS   doc-str-Ar-default
-.\" NS
-.\" NS width register 'Ar' set in doc-common
-.
-.ds doc-str-Ar-default "file\ .\|.\|.
-.
-.de Ar
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  nop \*doc-Ar-font\c
-.
-.  if !\ndoc-arg-limit \{\
-.    ds doc-macro-name Ar
-.    doc-parse-args \$@
-.
-.    \" no argument
-.    if !\n.$ \
-.      nop \)\*doc-str-Ar-default\&\f\s0
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  ie (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    nop \)\*doc-str-Ar-default\&\f\s0\c
-.    doc-print-and-reset
-.  \}
-.  el \{\
-.    if !(\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      \" replace previous argument (Ar) with default value
-.      nr doc-arg-ptr -1
-.      ds doc-arg\ndoc-arg-ptr "\*doc-str-Ar-default
-.      nr doc-type\ndoc-arg-ptr 2
-.      ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.      \" recompute space vector for remaining arguments
-.      nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.      nr doc-arg-limit \ndoc-arg-ptr
-.      doc-parse-space-vector
-.    \}
-.    doc-print-recursive
-.  \}
-..
-.
-.
-.\" NS Ad user macro
-.\" NS   Addresses
-.\" NS
-.\" NS width register 'Ad' set in doc-common
-.
-.als Ad doc-generic-macro
-.ds doc-Ad-usage address
-.
-.
-.\" NS doc-indent-synopsis global register
-.\" NS   indentation in synopsis
-.
-.nr doc-indent-synopsis 0
-.
-.
-.\" NS doc-indent-synopsis-active global register (bool)
-.\" NS   indentation in synopsis active
-.
-.nr doc-indent-synopsis-active 0
-.
-.
-.\" NS Cd user macro
-.\" NS   config declaration (for section 4 SYNOPSIS)
-.\" NS
-.\" NS   this function causes a break; it uses the 'Nm' font
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-indent-synopsis
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Cd' set in doc-common
-.
-.de Cd
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Cd
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Cd configuration_file_declaration ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.
-.    ie \ndoc-in-synopsis-section \{\
-.      ie "\*doc-macro-name"Cd" \{\
-.        br
-.        if !\ndoc-indent-synopsis \
-.          nr doc-indent-synopsis \ndoc-display-indentu
-.        if !\ndoc-indent-synopsis-active \
-.          in +\ndoc-indent-synopsisu
-.        ti -\ndoc-indent-synopsisu
-.        nop \*doc-Nm-font\c
-.        doc-print-recursive
-.        if !\ndoc-indent-synopsis-active \
-.          in -\ndoc-indent-synopsisu
-.      \}
-.      el \{\
-.        nop \*doc-Nm-font\c
-.        doc-print-recursive
-.    \}\}
-.    el \{\
-.      nop \*doc-Nm-font\c
-.      doc-print-recursive
-.  \}\}
-.  el \{\
-.    tm Usage: .Cd configuration_file_declaration ... (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Cm user macro
-.\" NS   interactive command modifier (flag)
-.\" NS
-.\" NS width register 'Cm' set in doc-common
-.
-.als Cm doc-generic-macro
-.ds doc-Cm-usage interactive_command_modifier
-.
-.
-.\" NS Dv user macro
-.\" NS   defined variable
-.\" NS
-.\" NS   this function uses the 'Er' font
-.\" NS
-.\" NS width register 'Dv' set in doc-common
-.
-.als Dv doc-generic-macro
-.ds doc-Dv-usage defined_variable
-.als doc-Dv-font doc-Er-font
-.
-.
-.\" NS Em user macro
-.\" NS   emphasis
-.\" NS
-.\" NS width register 'Em' set in doc-common
-.
-.als Em doc-generic-macro
-.ds doc-Em-usage text
-.
-.
-.\" NS Er user macro
-.\" NS   errno type
-.\" NS
-.\" NS width register 'Er' set in doc-common
-.
-.als Er doc-generic-macro
-.ds doc-Er-usage text
-.
-.
-.\" NS Ev user macro
-.\" NS   environment variable
-.\" NS
-.\" NS width register 'Ev' set in doc-common
-.
-.als Ev doc-generic-macro
-.ds doc-Ev-usage text
-.
-.
-.\" NS doc-have-decl global register (bool)
-.\" NS   subroutine test (in synopsis only)
-.
-.nr doc-have-decl 0
-.
-.
-.\" NS doc-have-var global register (bool)
-.\" NS   whether last type is a variable type
-.
-.nr doc-have-var 0
-.
-.
-.\" NS doc-do-func-decl macro
-.\" NS   do something special while in SYNOPSIS
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-have-decl
-.\" NS   doc-have-var
-.
-.de doc-do-func-decl
-.  if \ndoc-in-synopsis-section \{\
-.    \" if a variable type was the last thing given, want vertical space
-.    if \ndoc-have-var \{\
-.      doc-paragraph
-.      nr doc-have-var 0
-.    \}
-.    \" if a subroutine was the last thing given, want vertical space
-.    if \ndoc-have-func \{\
-.      ie \ndoc-have-decl \
-.        br
-.      el \
-.        doc-paragraph
-.    \}
-.    nr doc-have-decl 1
-.  \}
-.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-..
-.
-.
-.\" NS Fd user macro
-.\" NS   function declaration -- not callable
-.\" NS
-.\" NS   this function causes a break
-.\" NS
-.\" NS width register 'Fd' set in doc-common
-.
-.de Fd
-.  ie ((\n.$ >= 1) & (\ndoc-arg-limit == 0)) \{\
-.    doc-do-func-decl
-.    nop \*doc-Fd-font\$*
-.    br
-.    ft \ndoc-curr-font
-.    ps \ndoc-curr-sizeu
-.  \}
-.  el \{\
-.    tm Usage: .Fd function_declaration -- Fd is not callable (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS In user macro
-.\" NS   #include statement in SYNOPSIS
-.\" NS   <header.h> if not in SYNOPSIS
-.\" NS
-.\" NS   this function causes a break; it uses the 'Fd' font
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-indent-synopsis
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'In' set in doc-common
-.
-.de In
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name In
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .In include_file ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  ie ((\ndoc-arg-limit >= \ndoc-arg-ptr) & (\ndoc-type\ndoc-arg-ptr == 2)) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.
-.    ie \ndoc-in-synopsis-section \{\
-.      ie "\*doc-macro-name"In" \{\
-.        doc-do-func-decl
-.        nop \*doc-Fd-font#include <\*doc-arg\ndoc-arg-ptr>
-.        ft \ndoc-curr-font
-.        ps \ndoc-curr-sizeu
-.        br
-.        nr doc-arg-ptr +1
-.        ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.          doc-print-recursive
-.        el \
-.          doc-reset-args
-.      \}
-.      el \{\
-.        ds doc-arg\ndoc-arg-ptr "<\*doc-Pa-font\*doc-arg\ndoc-arg-ptr
-.        as doc-arg\ndoc-arg-ptr \f\ndoc-curr-font\s\ndoc-curr-sizeu>
-.        doc-print-recursive
-.    \}\}
-.    el \{\
-.      ds doc-arg\ndoc-arg-ptr "<\*doc-Pa-font\*doc-arg\ndoc-arg-ptr
-.      as doc-arg\ndoc-arg-ptr \f\ndoc-curr-font\s\ndoc-curr-sizeu>
-.      doc-print-recursive
-.  \}\}
-.  el \{\
-.    tm Usage: .In include_file ... (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Fr user macro
-.\" NS   function return value
-.\" NS
-.\" NS   this function uses the 'Ar' font
-.\" NS
-.\" NS width register 'Fr' set in doc-common
-.
-.als Fr doc-generic-macro
-.ds doc-Fr-usage function_return_value
-.als doc-Fr-font doc-Ar-font
-.
-.
-.\" NS Ic user macro
-.\" NS   interactive command
-.\" NS
-.\" NS width register 'Ic' set in doc-common
-.
-.als Ic doc-generic-macro
-.ds doc-Ic-usage interactive_command
-.
-.
-.\" NS Li user macro
-.\" NS   literals
-.\" NS
-.\" NS width register 'Li' set in doc-common
-.
-.als Li doc-generic-macro
-.ds doc-Li-usage argument
-.
-.
-.\" NS Ms user macro
-.\" NS   math symbol
-.\" NS
-.\" NS   this function uses the 'Sy' font
-.\" NS
-.\" NS width register 'Ms' set in doc-common
-.
-.als Ms doc-generic-macro
-.ds doc-Ms-usage math_symbol
-.als doc-Ms-font doc-Sy-font
-.
-.
-.\" NS doc-command-name global string
-.\" NS   save first invocation of .Nm
-.
-.ds doc-command-name
-.
-.
-.\" NS Nm user macro
-.\" NS   name of command or page topic
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-command-name
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-indent-synopsis
-.\" NS   doc-indent-synopsis-active
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Nm' set in doc-common
-.
-.de Nm
-.  if !\ndoc-arg-limit \{\
-.    ds doc-macro-name Nm
-.    ie \n.$ \
-.      doc-parse-args \$@
-.    el \{\
-.      ie "\*doc-command-name"" \
-.        tm Usage: .Nm name ... (#\n.c)
-.      el \
-.        doc-parse-args \*doc-command-name
-.  \}\}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  ie (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    \" last argument
-.    ie "\*doc-command-name"" \{\
-.      tm Usage: .Nm name ... (#\n.c)
-.      doc-reset-args
-.    \}
-.    el \{\
-.      nop \*doc-Nm-font\*doc-command-name\f\s0\c
-.      doc-print-and-reset
-.  \}\}
-.  el \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.
-.    ie !(\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      ie "\*doc-command-name"" \
-.        tm Usage: .Nm name ... (#\n.c)
-.      el \{\
-.        \" replace previous argument (Nm) with default value
-.        nr doc-arg-ptr -1
-.        ds doc-arg\ndoc-arg-ptr "\*doc-Nm-font\*doc-command-name\f\s0
-.        nr doc-type\ndoc-arg-ptr 2
-.        ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.        \" recompute space vector for remaining arguments
-.        nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.        nr doc-arg-limit \ndoc-arg-ptr
-.        doc-parse-space-vector
-.    \}\}
-.    el \{\
-.      \" handle '.Nm ...' in SYNOPSIS
-.      if \ndoc-in-synopsis-section \{\
-.        if "\*doc-macro-name"Nm" \{\
-.          br
-.          if !\ndoc-indent-synopsis \{\
-.            doc-get-width "\*doc-arg\ndoc-arg-ptr"
-.            nr doc-indent-synopsis ((\ndoc-widthu + 1u) * \ndoc-fixed-widthu)
-.          \}
-.          if !\ndoc-indent-synopsis-active \{\
-.            in +\ndoc-indent-synopsisu
-.            nr doc-indent-synopsis-active 1
-.          \}
-.          ti -\ndoc-indent-synopsisu
-.      \}\}
-.      if "\*doc-command-name"" \
-.        ds doc-command-name "\*doc-arg\ndoc-arg-ptr
-.
-.      nop \*doc-Nm-font\c
-.    \}
-.    doc-print-recursive
-.  \}
-..
-.
-.
-.\" NS Pa user macro
-.\" NS   pathname: '.Pa arg ...'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Pa' set in doc-common
-.
-.de Pa
-.  if !\ndoc-arg-limit \{\
-.    ds doc-macro-name Pa
-.    doc-parse-args \$@
-.
-.    \" default value
-.    if !\n.$ \
-.      nop \*doc-Pa-font~\f\s0
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    nop \*doc-Pa-font\c
-.    if !(\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      \" replace previous argument (Pa) with default value
-.      nr doc-arg-ptr -1
-.      ds doc-arg\ndoc-arg-ptr ~
-.      nr doc-type\ndoc-arg-ptr 2
-.      ds doc-space\ndoc-arg-ptr "\*doc-space
-.
-.      \" recompute space vector for remaining arguments
-.      nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.      nr doc-arg-limit \ndoc-arg-ptr
-.      doc-parse-space-vector
-.    \}
-.    doc-print-recursive
-.  \}
-.  el \{\
-.    nop \*doc-Pa-font~\f\s0\c
-.    doc-print-and-reset
-.  \}
-..
-.
-.
-.\" NS Sy user macro
-.\" NS   symbolics
-.\" NS
-.\" NS width register 'Sy' set in doc-common
-.
-.als Sy doc-generic-macro
-.ds doc-Sy-usage symbolic_text
-.
-.
-.\" NS Me user macro
-.\" NS   menu entries
-.\" NS
-.\" NS width register 'Me' set in doc-common
-.
-.als Me doc-generic-macro
-.ds doc-Me-usage menu_entry
-.
-.
-.\" NS Tn user macro
-.\" NS   trade name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Tn' set in doc-common
-.
-.de Tn
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Tn
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Tn trade_name ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    nop \)\*doc-Tn-font-size\c
-.    ie !\ndoc-is-reference \{\
-.      nop \)\*doc-Tn-font-shape\c
-.      doc-print-recursive
-.    \}
-.    el \
-.      doc-do-references
-.  \}
-.  el \{\
-.    tm Usage: .Tn trade_name ... (#\n.c)
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Va user macro
-.\" NS   variable name
-.\" NS
-.\" NS width register 'Va' set in doc-common
-.
-.als Va doc-generic-macro
-.ds doc-Va-usage variable_name
-.
-.
-.\" NS No user macro
-.\" NS   normal text macro (default text style if mess up)
-.\" NS
-.\" NS width register 'No' set in doc-common
-.
-.als No doc-generic-macro
-.ds doc-No-usage normal_text
-.
-.
-.\" NS doc-quote-left global string
-.\" NS   left quotation character for 'doc-enclose-string' and
-.\" NS   'doc-enclose-open'
-.
-.ds doc-quote-left
-.
-.
-.\" NS doc-quote-right global string
-.\" NS   right quotation character for 'doc-enclose-string' and
-.\" NS   'doc-enclose-close'
-.
-.ds doc-quote-right
-.
-.
-.\" NS Op user macro
-.\" NS   option expression (i.e., enclose string in square brackets)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Op' set in doc-common
-.
-.de Op
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Op
-.
-.  ds doc-quote-left "\*doc-left-bracket
-.  ds doc-quote-right "\*doc-right-bracket
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Aq user macro
-.\" NS   enclose string in angle brackets
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Aq' set in doc-common
-.
-.de Aq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Aq
-.
-.  ie "\*doc-macro-name"An" \{\
-.    ds doc-quote-left <
-.    ds doc-quote-right >
-.  \}
-.  el \{\
-.    ds doc-quote-left \la
-.    ds doc-quote-right \ra
-.  \}
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Bq user macro
-.\" NS   enclose string in square brackets
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Bq' set in doc-common
-.
-.de Bq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Bq
-.
-.  ds doc-quote-left "\*doc-left-bracket
-.  ds doc-quote-right "\*doc-right-bracket
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Brq user macro
-.\" NS   enclose string in braces
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Brq' set in doc-common
-.
-.de Brq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Brq
-.
-.  ds doc-quote-left {
-.  ds doc-quote-right }
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Dq user macro
-.\" NS   enclose string in double quotes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Dq' set in doc-common
-.
-.de Dq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Dq
-.
-.  ds doc-quote-left "\*Lq
-.  ds doc-quote-right "\*Rq
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Eq user macro
-.\" NS   enclose string in user-defined quotes (args 1 and 2)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Eq' set in doc-common
-.
-.de Eq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Eq
-.
-.  ds doc-quote-left "\$1
-.  ds doc-quote-right "\$2
-.
-.  shift 2
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Pq user macro
-.\" NS   enclose string in parentheses
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Pq' set in doc-common
-.
-.de Pq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Pq
-.
-.  ds doc-quote-left "\*doc-left-parenthesis
-.  ds doc-quote-right "\*doc-right-parenthesis
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Ql user macro
-.\" NS   quoted literal
-.\"
-.\"   is in file doc-dit|nroff
-.
-.
-.\" NS Qq user macro
-.\" NS   enclose string in straight double quotes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Qq' set in doc-common
-.
-.de Qq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Qq
-.
-.  ds doc-quote-left "\*q
-.  ds doc-quote-right "\*q
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Sq user macro
-.\" NS   enclose string in single quotes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Sq' set in doc-common
-.
-.de Sq
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Sq
-.
-.  ds doc-quote-left "\*doc-left-singlequote
-.  ds doc-quote-right "\*doc-right-singlequote
-.
-.  doc-enclose-string \$@
-..
-.
-.
-.\" NS Es user macro
-.\" NS   set up arguments (i.e., the left and right quotation character
-.\" NS   as first and second argument) for .En call
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.
-.de Es
-.  if !\ndoc-arg-limit \{\
-.    ie (\n.$ > 2) \{\
-.      ds doc-macro-name Es
-.      doc-parse-args \$@
-.    \}
-.    el \{\
-.      ds doc-quote-left "\$1
-.      ds doc-quote-right "\$2
-.  \}\}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  ds doc-quote-left "\*doc-arg\ndoc-arg-ptr
-.  nr doc-arg-ptr +1
-.  ds doc-quote-right "\*doc-arg\ndoc-arg-ptr
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.    doc-do-\ndoc-type\ndoc-arg-ptr
-.  el \
-.    doc-print-and-reset
-..
-.
-.
-.\" NS doc-have-slot global register (bool)
-.\" NS   set if 'doc-enclose-string' has created a slot for closing
-.\" NS   delimiter
-.
-.nr doc-have-slot 0
-.
-.
-.\" NS doc-enclose-string macro
-.\" NS   enclose string with given args (e.g.  and )
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-have-slot
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-des
-.\" NS   doc-reg-des1
-.\" NS   doc-reg-des2
-.\" NS
-.\" NS requires:
-.\" NS   doc-quote-left
-.\" NS   doc-quote-right
-.
-.de doc-enclose-string
-.  if \ndoc-in-synopsis-section \
-.    doc-set-hard-space
-.
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \
-.      doc-parse-args \$@
-.    el \{\
-.      nop \)\*doc-quote-left\*doc-quote-right
-.  \}\}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  \" the final '\)' prevents hyphenation in case next character is '\%'
-.  nop \)\*doc-quote-left\)\c
-.  ie (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    \" last argument
-.    nop \)\*doc-quote-right\)\c
-.    doc-print-and-reset
-.  \}
-.  el \{\
-.    \" test whether last arguments are of type closing punctuation
-.    \" resp. suffix
-.    ie (\ndoc-type\ndoc-arg-limit == 3) \{\
-.      nr doc-reg-des (\ndoc-arg-limit - 1)
-.      while (\ndoc-type\ndoc-reg-des == 3) \
-.        nr doc-reg-des -1
-.
-.      \" prepend closing delimiter
-.      nr doc-reg-des +1
-.      ds doc-arg\ndoc-reg-des "\*doc-quote-right\)\*doc-arg\ndoc-reg-des
-.    \}
-.    el \{\
-.      \" test whether last arguments are macros which continue the line
-.      \" logically
-.      nr doc-reg-des \ndoc-arg-limit
-.      while (\ndoc-reg-des >= \ndoc-arg-ptr) \{\
-.        if !\A&#x7;\*doc-arg\ndoc-reg-des&#x7; \
-.          break
-.        if !d doc-after-\*doc-arg\ndoc-reg-des \
-.          break
-.        nr doc-reg-des -1
-.      \}
-.
-.      \" if there are no trailing macros to be skipped, append argument
-.      ie (\ndoc-reg-des == \ndoc-arg-limit) \
-.        doc-append-arg "\)\*doc-quote-right\)" 3
-.      el \{\
-.        \" if a previous call to 'doc-enclose-string' has already
-.        \" created a slot, prepend argument
-.        ie \ndoc-have-slot \
-.          ds doc-arg\ndoc-reg-des "\*doc-quote-right\)\*doc-arg\ndoc-reg-des
-.        el \{\
-.          \" we have to shift all arguments to the right
-.          nr doc-reg-des +1
-.          nr doc-reg-des1 \ndoc-arg-limit
-.          nr doc-reg-des2 (\ndoc-arg-limit + 1)
-.          while (\ndoc-reg-des1 >= \ndoc-reg-des) \{\
-.            rn doc-arg\ndoc-reg-des1 doc-arg\ndoc-reg-des2
-.            rnn doc-type\ndoc-reg-des1 doc-type\ndoc-reg-des2
-.            rn doc-space\ndoc-reg-des1 doc-space\ndoc-reg-des2
-.            nr doc-reg-des1 -1
-.            nr doc-reg-des2 -1
-.          \}
-.          nr doc-arg-limit +1
-.
-.          \" finally, insert closing delimiter into the freed slot and
-.          \" recompute spacing vector
-.          ds doc-arg\ndoc-reg-des "\)\*doc-quote-right\)
-.          nr doc-type\ndoc-reg-des 3
-.          nr doc-num-args (\ndoc-arg-limit - \ndoc-reg-des + 1)
-.          nr doc-arg-limit (\ndoc-reg-des - 1)
-.          doc-parse-space-vector
-.          nr doc-have-slot 1
-.    \}\}\}
-.
-.    doc-do-\ndoc-type\ndoc-arg-ptr
-.  \}
-.
-.  if \ndoc-in-synopsis-section \
-.    doc-set-soft-space
-..
-.
-.
-.\" NS En user macro
-.\" NS   enclose arguments with quotation characters set up with '.Es'
-.
-.als En doc-enclose-string
-.
-.
-.\" NS Ao user macro
-.\" NS   angle open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Ao' set in doc-common
-.
-.de Ao
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Ao
-.
-.  ie "\*doc-macro-name"An" \
-.    ds doc-quote-left <
-.  el \
-.    ds doc-quote-left \la
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Ac user macro
-.\" NS   angle close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Ac' set in doc-common
-.
-.de Ac
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Ac
-.
-.  ie "\*doc-macro-name"An" \
-.    ds doc-quote-right >
-.  el \
-.    ds doc-quote-right \ra
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Bo user macro
-.\" NS   bracket open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Bo' set in doc-common
-.
-.de Bo
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Bo
-.
-.  ds doc-quote-left "\*doc-left-bracket
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Bc user macro
-.\" NS   bracket close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Bc' set in doc-common
-.
-.de Bc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Bc
-.
-.  ds doc-quote-right "\*doc-right-bracket
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Bro user macro
-.\" NS   brace open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Bro' set in doc-common
-.
-.de Bro
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Bo
-.
-.  ds doc-quote-left {
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Brc user macro
-.\" NS   brace close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Brc' set in doc-common
-.
-.de Brc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Bc
-.
-.  ds doc-quote-right }
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Do user macro
-.\" NS   double quote open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Do' set in doc-common
-.
-.de Do
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Do
-.
-.  ds doc-quote-left "\*Lq
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Dc user macro
-.\" NS   double quote close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Dc' set in doc-common
-.
-.de Dc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Dc
-.
-.  ds doc-quote-right "\*Rq
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Eo user macro
-.\" NS   enclose open (using first argument as beginning of enclosure)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Eo' set in doc-common
-.
-.de Eo
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Eo
-.
-.  ds doc-quote-left "\$1
-.
-.  shift
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Ec user macro
-.\" NS   enclose close (using first argument as end of enclosure)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Ec' set in doc-common
-.
-.de Ec
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Ec
-.
-.  ds doc-quote-right "\$1
-.
-.  shift
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Oo user macro
-.\" NS   option open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Oo' set in doc-common
-.
-.de Oo
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Oo
-.
-.  ds doc-quote-left 
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Oc user macro
-.\" NS   option close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Oc' set in doc-common
-.
-.de Oc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Oc
-.
-.  ds doc-quote-right 
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Po user macro
-.\" NS   parenthesis open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Po' set in doc-common
-.
-.de Po
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Po
-.
-.  ds doc-quote-left "\*doc-left-parenthesis
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Pc user macro
-.\" NS   parenthesis close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Pc' set in doc-common
-.
-.de Pc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Pc
-.
-.  ds doc-quote-right "\*doc-right-parenthesis
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Qo user macro
-.\" NS   straight double quote open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Qo' set in doc-common
-.
-.de Qo
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Qo
-.
-.  ds doc-quote-left "\*q
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Qc user macro
-.\" NS   straight double quote close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Qc' set in doc-common
-.
-.de Qc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Qc
-.
-.  ds doc-quote-right "\*q
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS So user macro
-.\" NS   single quote open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'So' set in doc-common
-.
-.de So
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name So
-.
-.  ds doc-quote-left "\*doc-left-singlequote
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Sc user macro
-.\" NS   single quote close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Sc' set in doc-common
-.
-.de Sc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Sc
-.
-.  ds doc-quote-right "\*doc-right-singlequote
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS Xo user macro
-.\" NS   extend open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Xo' set in doc-common
-.
-.de Xo
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Xo
-.
-.  ds doc-quote-left
-.
-.  doc-enclose-open \$@
-..
-.
-.
-.\" NS Xc user macro
-.\" NS   extend close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS   doc-quote-right
-.\" NS
-.\" NS width register 'Xc' set in doc-common
-.
-.de Xc
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Xc
-.
-.  ds doc-quote-right
-.
-.  doc-enclose-close \$@
-..
-.
-.
-.\" NS doc-nesting-level global register
-.\" NS   used by 'doc-enclose-open' and 'doc-enclose-close'
-.
-.nr doc-nesting-level 0
-.
-.
-.\" NS doc-in-list global register (bool)
-.\" NS   whether we are in (logical) .It
-.
-.nr doc-in-list 0
-.
-.
-.\" NS doc-enclose-open macro
-.\" NS   enclose string open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-nesting-level
-.
-.de doc-enclose-open
-.  if !\ndoc-arg-limit \
-.    doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  nr doc-arg-ptr -1
-.
-.  nop \)\*doc-quote-left\)\c
-.
-.  \" start enclosure box
-.  box doc-enclosure-box\ndoc-nesting-level
-.  ev doc-enclosure-env\ndoc-nesting-level
-.  evc 0
-.  in 0
-.  nf
-.  \" we insert something to make .chop always work
-.  nop \&\c
-.
-.  \" increase nesting level *after* parsing of arguments
-.  nr doc-nesting-level +1
-.
-.  if \ndoc-arg-limit \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.      doc-print-recursive
-.    el \
-.      doc-reset-args
-.  \}
-..
-.
-.
-.\" NS doc-enclose-close macro
-.\" NS   enclose string close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-nesting-level
-.
-.de doc-enclose-close
-.  nr doc-nesting-level -1
-.
-.  \" finish enclosure box
-.  br
-.  ev
-.  box
-.  chop doc-enclosure-box\ndoc-nesting-level
-.  unformat doc-enclosure-box\ndoc-nesting-level
-.
-.  nh
-.  nop \*doc-enclosure-box\ndoc-nesting-level\c
-.  nop \)\*doc-quote-right\)\c
-.
-.  if !\ndoc-arg-limit \{\
-.    doc-parse-args \$@
-.
-.    if !\n.$ \
-.      doc-print-and-reset
-.  \}
-.
-.  if \ndoc-arg-limit \{\
-.    ie (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.      nop \)\*doc-space\ndoc-arg-ptr\c
-.      nr doc-arg-ptr +1
-.      doc-print-recursive
-.    \}
-.    el \
-.      doc-print-and-reset
-.  \}
-.
-.  \" shall we finish .It macro?
-.  if !"\*doc-macro-name"It" \
-.    if \ndoc-in-list \
-.      if !\ndoc-nesting-level \
-.        doc-\*doc-list-type-stack\ndoc-list-depth
-..
-.
-.
-.\" NS Pf user macro
-.\" NS   prefix: '.Pf prefix arg ...'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-macro-name
-.\" NS   doc-quote-left
-.\" NS
-.\" NS width register 'Pf' set in doc-common
-.
-.de Pf
-.  if !\ndoc-arg-limit \
-.    ds doc-macro-name Pf
-.
-.  ie \ndoc-arg-limit \{\
-.    ie ((\ndoc-arg-limit - \ndoc-arg-ptr) > 1) \{\
-.      nr doc-arg-ptr +1
-.      nop \)\*doc-arg\ndoc-arg-ptr\c
-.    \}
-.    el \
-.      tm mdoc warning: .Pf: trailing prefix (#\n.c)
-.  \}
-.  el \{\
-.    nop \)\$1\)\c
-.    shift
-.    ie \n.$ \
-.      doc-parse-args \$@
-.    el \{\
-.      tm mdoc warning: .Pf: missing arguments (#\n.c)
-.      nop \)
-.  \}\}
-.
-.  if \ndoc-arg-limit \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit < \ndoc-arg-ptr) \
-.      doc-print-and-reset
-.    el \
-.      doc-do-\ndoc-type\ndoc-arg-ptr
-.  \}
-..
-.
-.
-.\" NS Ns user macro
-.\" NS   remove space (space removal done by 'doc-parse-args')
-.\" NS
-.\" NS modifies:
-.\" NS   doc-argXXX
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Ns' set in doc-common
-.
-.de Ns
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Ns
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Ns must be called with arguments (#\n.c)
-.  \}
-.
-.  if \ndoc-arg-limit \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.      doc-print-recursive
-.    el \
-.      doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Ap user macro
-.\" NS   append an apostrophe
-.\" NS
-.\" NS width register 'Ap' set in doc-common
-.
-.de Ap
-.  ie !\ndoc-arg-limit \
-.    tm Usage: 'Ap' cannot be first macro on a line (no '.Ap') (#\n.c)
-.  el \{\
-.    nop \)'\)\c
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.      doc-print-recursive
-.    el \
-.      doc-reset-args
-.  \}
-..
-.
-.
-.\" NS doc-space global string
-.\" NS   current inter-argument space
-.
-.ds doc-space "\*doc-soft-space
-.
-.
-.\" NS doc-soft-space constant string
-.\" NS   soft (stretchable) space (defined in doc-common)
-.
-.
-.\" NS doc-hard-space constant string
-.\" NS   hard (unpaddable) space (defined in doc-common)
-.
-.
-.\" NS doc-set-hard-space macro
-.\" NS   set current space string to hard (unpaddable) space.
-.\" NS
-.\" NS modifies:
-.\" NS   doc-saved-space
-.\" NS   doc-space
-.
-.de doc-set-hard-space
-.  ie "\*doc-space"" \
-.    ds doc-saved-space "\*doc-hard-space
-.  el \
-.    ds doc-space "\*doc-hard-space
-..
-.
-.
-.\" NS doc-set-soft-space macro
-.\" NS   set current space string to soft space
-.\" NS
-.\" NS modifies:
-.\" NS   doc-saved-space
-.\" NS   doc-space
-.
-.de doc-set-soft-space
-.  ie "\*doc-space"" \
-.    ds doc-saved-space "\*doc-soft-space
-.  el \
-.    ds doc-space "\*doc-soft-space
-..
-.
-.
-.\" NS doc-space-mode global register (bool)
-.\" NS   default is one (space mode on)
-.
-.nr doc-space-mode 1
-.
-.
-.\" NS doc-saved-space global string
-.\" NS   saved value of 'doc-space'
-.
-.ds doc-saved-space "\*doc-space
-.
-.
-.\" NS doc-have-space global register (bool)
-.\" NS   set if last command was horizontal space
-.
-.nr doc-have-space 0
-.
-.
-.\" NS Sm user macro
-.\" NS   space mode ('.Sm'/'.Sm on'/'.Sm off')
-.\" NS
-.\" NS   without argument, toggle space mode
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-limit
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-macro-name
-.\" NS   doc-num-args
-.\" NS   doc-saved-space
-.\" NS   doc-space
-.\" NS   doc-space-mode
-.\" NS   doc-spaceXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Sm
-.\" NS
-.\" NS width register 'Sm' set in doc-common
-.
-.de Sm
-.  ie \ndoc-have-space \
-.    nr doc-reg-Sm 0
-.  el \
-.    nr doc-reg-Sm 1
-.
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Sm
-.      doc-parse-args \$@
-.    \}
-.    el \{\
-.      ie \ndoc-space-mode \{\
-.        ds doc-saved-space "\*doc-space
-.        ds doc-space
-.        nr doc-space-mode 0
-.      \}
-.      el \{\
-.        ds doc-space "\*doc-saved-space
-.        nr doc-space-mode 1
-.
-.        \" finish line only if it is interrupted and 'doc-have-space'
-.        \" isn't set
-.        if \ndoc-reg-Sm \
-.          if \n.int \
-.            nop \)
-.      \}
-.  \}\}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.
-.  \" avoid a warning message in case 'Sm' is the last parameter
-.  if !d doc-arg\ndoc-arg-ptr \
-.    ds doc-arg\ndoc-arg-ptr
-.
-.  ie "\*doc-arg\ndoc-arg-ptr"on" \{\
-.    ds doc-space "\*doc-saved-space
-.    nr doc-space-mode 1
-.  \}
-.  el \{\
-.    ie "\*doc-arg\ndoc-arg-ptr"off" \{\
-.      ds doc-saved-space "\*doc-space
-.      ds doc-space
-.      nr doc-space-mode 0
-.    \}
-.    el \{\
-.      \" no argument for Sm
-.      nr doc-arg-ptr -1
-.      ie \ndoc-space-mode \{\
-.        ds doc-saved-space "\*doc-space
-.        ds doc-space
-.        nr doc-space-mode 0
-.      \}
-.      el \{\
-.        ds doc-space "\*doc-saved-space
-.        nr doc-space-mode 1
-.      \}
-.  \}\}
-.
-.  ie \ndoc-space-mode \{\
-.    \" recompute space vector for remaining arguments
-.    nr doc-num-args (\ndoc-arg-limit - \ndoc-arg-ptr)
-.    nr doc-arg-limit \ndoc-arg-ptr
-.    if \ndoc-num-args \
-.      doc-parse-space-vector
-.
-.    \" finish line only if it is interrupted and 'doc-have-space'
-.    \" isn't set
-.    if \ndoc-reg-Sm \
-.      if \n.int \
-.        nop \)
-.  \}
-.  el \{\
-.    \" reset remaining space vector elements
-.    nr doc-reg-Sm (\ndoc-arg-ptr + 1)
-.    while (\ndoc-reg-Sm <= \ndoc-arg-limit) \{\
-.      ds doc-space\ndoc-reg-Sm
-.      nr doc-reg-Sm +1
-.      \" the body of a 'while' request must end with the fitting '\}'!
-.    \}
-.  \}
-.
-.  \" do we have parameters to print?
-.  ie (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.    \" skip 'Sm' argument
-.    nr doc-arg-ptr +1
-.    doc-print-recursive
-.  \}
-.  el \
-.    doc-reset-args
-..
-.
-.
-.\" NS doc-arg-type immediate register
-.\" NS   argument type (macro=1, string=2, punctuation suffix=3,
-.\" NS   punctuation prefix=4)
-.
-.nr doc-arg-type 0
-.
-.
-.\" NS doc-get-arg-type macro
-.\" NS   get argument type
-.\" NS
-.\" NS   this macro expects the width of the argument in 'doc-width'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-type
-.
-.de doc-get-arg-type
-.  nr doc-arg-type 2
-.
-.  if ((\ndoc-width < 4) & \A&#x7;\$1&#x7;) \{\
-.    ie (\ndoc-width == 1) \{\
-.      if r doc-punct\$1 \
-.        nr doc-arg-type \ndoc-punct\$1
-.    \}
-.    el \
-.      if r \$1 \
-.        if d \$1 \
-.          nr doc-arg-type 1
-.  \}
-..
-.
-.
-.\" NS doc-get-arg-type* macro
-.\" NS   similar to as 'doc-get-arg-type' but uses doc-argXXX strings
-.\" NS
-.\" NS   this macro sets the 'doc-width' register using the 'length'
-.\" NS   request to get the number of characters in a string literally
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-type
-.\" NS   doc-width
-.
-.de doc-get-arg-type*
-.  nr doc-arg-type 2
-.  length doc-width "\*doc-arg\$1
-.
-.  if ((\ndoc-width < 4) & \A&#x7;\*doc-arg\$1&#x7;) \{\
-.    ie (\ndoc-width == 1) \{\
-.      if r doc-punct\*doc-arg\$1 \
-.        nr doc-arg-type \ndoc-punct\*doc-arg\$1
-.    \}
-.    el \
-.      if r \*doc-arg\$1 \
-.        if d \*doc-arg\$1 \
-.          nr doc-arg-type 1
-.  \}
-..
-.
-.
-.\" NS doc-set-spacing-1 macro
-.\" NS   set spacing for macros
-.\" NS
-.\" NS modifies:
-.\" NS   doc-spaceXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dssfm
-.\" NS   doc-reg-dssfm1
-.
-.de doc-set-spacing-1
-.  nr doc-reg-dssfm1 \n\*doc-arg\ndoc-arg-limit
-.
-.  \" closing macros like .Ac, Bc., etc. have value 3 (remove space
-.  \" before argument)
-.  ie (\ndoc-reg-dssfm1 == 3) \{\
-.    if \ndoc-arg-limit \{\
-.      nr doc-reg-dssfm (\ndoc-arg-limit - 1)
-.      ds doc-space\ndoc-reg-dssfm
-.    \}
-.    ds doc-space\ndoc-arg-limit "\*doc-space
-.  \}
-.  el \{\
-.    \" macros like .Ap and .Ns have value 2 (remove space before and
-.    \" after argument)
-.    ie (\ndoc-reg-dssfm1 == 2) \{\
-.      if \ndoc-arg-limit \{\
-.        nr doc-reg-dssfm (\ndoc-arg-limit - 1)
-.        ds doc-space\ndoc-reg-dssfm
-.      \}
-.      ds doc-space\ndoc-arg-limit
-.    \}
-.    el \
-.      ds doc-space\ndoc-arg-limit
-.  \}
-..
-.
-.
-.\" NS doc-set-spacing-2 macro
-.\" NS   set spacing for strings
-.\" NS
-.\" NS modifies:
-.\" NS   doc-spaceXXX
-.
-.de doc-set-spacing-2
-.  ds doc-space\ndoc-arg-limit "\*doc-space
-..
-.
-.
-.\" NS doc-set-spacing-3 macro
-.\" NS   set spacing for punctuation suffixes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-spaceXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dssfps
-.
-.de doc-set-spacing-3
-.  if \ndoc-arg-limit \{\
-.    nr doc-reg-dssfps (\ndoc-arg-limit - 1)
-.    ds doc-space\ndoc-reg-dssfps
-.  \}
-.
-.  ds doc-space\ndoc-arg-limit "\*doc-space
-..
-.
-.
-.\" NS doc-set-spacing-4 macro
-.\" NS   set spacing for punctuation prefixes
-.\" NS
-.\" NS modifies:
-.\" NS   doc-spaceXXX
-.
-.de doc-set-spacing-4
-.  ds doc-space\ndoc-arg-limit
-..
-.
-.
-.\" type switches (on current argument doc-arg-ptr)
-.
-.
-.\" NS doc-do-1 macro
-.\" NS   call request if macro
-.
-.de doc-do-1
-.  \*doc-arg\ndoc-arg-ptr
-..
-.
-.
-.\" NS doc-do-2 macro
-.\" NS   call .doc-print-recursive if string
-.
-.als doc-do-2 doc-print-recursive
-.
-.
-.\" NS doc-do-3 macro
-.\" NS   call .doc-print-recursive if punctuation suffix
-.
-.als doc-do-3 doc-print-recursive
-.
-.
-.\" NS doc-do-4 macro
-.\" NS   call .doc-print-recursive if punctuation prefix
-.
-.als doc-do-4 doc-print-recursive
-.
-.
-.\" NS doc-fontmode-depth global register
-.\" NS   font mode level
-.
-.nr doc-fontmode-depth 0
-.
-.
-.\" NS doc-fontmode-font-stackXXX global register
-.\" NS   stack of saved current font values from 'Bf' macro
-.\" NS
-.\" NS limit:
-.\" NS   doc-fontmode-depth
-.
-.nr doc-fontmode-font-stack0 0
-.
-.
-.\" NS doc-fontmode-size-stackXXX global register
-.\" NS   stack of saved current size values from 'Bf' macro
-.\" NS
-.\" NS limit:
-.\" NS   doc-fontmode-depth
-.
-.nr doc-fontmode-size-stack0 0
-.
-.
-.\" NS Bf user macro
-.\" NS   begin font mode (will be begin-mode/end-mode in groff & TeX)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-fontmode-depth
-.\" NS   doc-fontmode-font-stackXXX
-.\" NS   doc-fontmode-size-stackXXX
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Bf' set in doc-common
-.
-.de Bf
-.  ds doc-macro-name Bf
-.
-.  ie \n.$ \{\
-.    nr doc-fontmode-depth +1
-.
-.    \" save current font and size
-.    nr doc-fontmode-font-stack\ndoc-fontmode-depth \n.f
-.    nr doc-fontmode-size-stack\ndoc-fontmode-depth \n.ps
-.
-.    ie        "\$1"Em" \
-.      nop \*doc-Em-font\c
-.    el \{ .ie "\$1"Li" \
-.      nop \*doc-Li-font\c
-.    el \{ .ie "\$1"Sy" \
-.      nop \*doc-Sy-font\c
-.    el \{ .ie "\$1"-emphasis" \
-.      nop \*doc-Em-font\c
-.    el \{ .ie "\$1"-literal" \
-.      nop \*doc-Li-font\c
-.    el \{ .ie "\$1"-symbolic" \
-.      nop \*doc-Sy-font\c
-.    el \{\
-.      tmc mdoc warning: Unknown keyword '\$1' in .Bf macro
-.      tm1 " (#\n.c)
-.  \}\}\}\}\}\}\}
-.  el \
-.    tm Usage: .Bf Em | -emphasis | Li | -literal | Sy | -symbolic (#\n.c)
-..
-.
-.
-.\" NS Ef user macro
-.\" NS   end font mode
-.\" NS
-.\" NS modifies:
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Ef' set in doc-common
-.
-.de Ef
-.  ds doc-macro-name Ef
-.
-.  ie \ndoc-fontmode-depth \{\
-.    \" restore saved font and size
-.    nop \)\f\ndoc-fontmode-font-stack\ndoc-fontmode-depth\c
-.    nop \)\s\ndoc-fontmode-size-stack\ndoc-fontmode-depthu\c
-.
-.    nr doc-fontmode-font-stack\ndoc-fontmode-depth 0
-.    nr doc-curr-font \n.f
-.    nr doc-fontmode-size-stack\ndoc-fontmode-depth 0
-.    nr doc-curr-size \n.ps
-.    nr doc-fontmode-depth -1
-.  \}
-.  el \
-.    tm mdoc warning: Extraneous .Ef (#\n.c)
-..
-.
-.
-.\" NS doc-keep-type global register
-.\" NS   current keep type; 1 is '-words', 2 is '-lines', 3 is unknown
-.
-.nr doc-keep-type 0
-.
-.
-.\" NS Bk user macro
-.\" NS   begin keep
-.\" NS
-.\" NS modifies:
-.\" NS   doc-keep-type
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Bk' set in doc-common
-.
-.de Bk
-.  ds doc-macro-name Bk
-.
-.  if \ndoc-keep-type \
-.    tm .Bk: nesting keeps not implemented yet. (#\n.c)
-.
-.  ie        "\$1"-lines" \{\
-.    nr doc-keep-type 2
-.    tm .Bk -lines: Not implemented yet. (#\n.c)
-.  \}
-.  el \{ .ie "\$1"-words" \{\
-.    nr doc-keep-type 1
-.    doc-set-hard-space
-.  \}
-.  el \{ .ie "\$1"" \{\
-.    \" default
-.    nr doc-keep-type 1
-.    doc-set-hard-space
-.  \}
-.  el \{\
-.    tm mdoc warning: Unknown keyword '\$1' in .Bk macro (#\n.c)
-.    nr doc-keep-type 3
-.  \}\}\}
-.
-\#.  nr doc-nesting-level +1
-..
-.
-.
-.\" NS Ek user macro
-.\" NS   end keep
-.\" NS
-.\" NS modifies:
-.\" NS   doc-keep-type
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Ek' set in doc-common
-.
-.de Ek
-.  ds doc-macro-name Ek
-.
-\#.  nr doc-nesting-level -1
-.
-.  ie \n.$ \
-.    tm Usage: .Ek (does not take arguments) (#\n.c)
-.  el \{\
-.    if !\ndoc-keep-type \
-.      tm mdoc warning: .Ek found without .Bk before (#\n.c)
-.
-.    ie        (\ndoc-keep-type == 1) \
-.      doc-set-soft-space
-.    el \{ .if (\ndoc-keep-type == 2) \
-.      tm .Bk -lines: Not implemented yet. (#\n.c)
-.  \}\}
-.
-.  nr doc-keep-type 0
-.
-\#.  if !"\*doc-out-string"" \
-\#.    doc-print-out-string
-..
-.
-.
-.\" NS doc-display-depth global register
-.\" NS   display level
-.
-.nr doc-display-depth 0
-.
-.
-.\" NS doc-is-compact global register (bool)
-.\" NS   set if the 'compact' keyword is given
-.
-.nr doc-is-compact 0
-.
-.
-.\" NS doc-display-type-stackXXX global string
-.\" NS   the display type stack
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.ds doc-display-type-stack0
-.
-.
-.\" NS doc-display-indent-stackXXX global register
-.\" NS   stack of display indentation values
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.nr doc-display-indent-stack0 0
-.
-.
-.\" NS doc-display-ad-stackXXX global register
-.\" NS   stack of saved adjustment modes
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.nr doc-display-ad-stack0 0
-.
-.
-.\" NS doc-display-fi-stackXXX global register
-.\" NS   stack of saved fill modes
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.nr doc-display-fi-stack0 0
-.
-.
-.\" NS doc-display-ft-stackXXX global register
-.\" NS   stack of saved fonts
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.nr doc-display-ft-stack0 0
-.
-.
-.\" NS doc-display-ps-stackXXX global register
-.\" NS   stack of saved font sizes
-.\" NS
-.\" NS limit:
-.\" NS   doc-display-depth
-.
-.nr doc-display-ps-stack0 0
-.
-.
-.\" NS Bd user macro
-.\" NS   begin display
-.\" NS
-.\" NS width register 'Bd' set in doc-common
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-display-depth
-.\" NS   doc-display-ad-stackXXX
-.\" NS   doc-display-fi-stackXXX
-.\" NS   doc-display-ft-stackXXX
-.\" NS   doc-display-ps-stackXXX
-.\" NS   doc-display-file
-.\" NS   doc-display-indent-stackXXX
-.\" NS   doc-display-type-stackXXX
-.\" NS   doc-is-compact
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Bd
-.
-.de Bd
-.  ds doc-macro-name Bd
-.
-.  if !\n.$ \{\
-.    tm1 "Usage: .Bd {-literal | -filled | -ragged | -centered | -unfilled}
-.    tm1 "           -offset string -compact -file name (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-is-compact 0
-.  ds doc-display-file
-.  nr doc-reg-Bd 1
-.  nr doc-display-depth +1
-.
-.  \" save current adjustment and fill modes
-.  nr doc-display-ad-stack\ndoc-display-depth \n.j
-.  nr doc-display-fi-stack\ndoc-display-depth \n.u
-.
-.  ie        "\$1"-literal" \{\
-.    ds doc-display-type-stack\ndoc-display-depth literal
-.    nr doc-display-ft-stack\ndoc-display-depth \n.f
-.    nr doc-display-ps-stack\ndoc-display-depth \n.ps
-.
-.    ie t \
-.      ta T 9n
-.    el \
-.      ta T 8n
-.    nf
-.  \}
-.  el \{ .ie "\$1"-filled" \{\
-.    ds doc-display-type-stack\ndoc-display-depth filled
-.    ad b
-.    fi
-.  \}
-.  el \{ .ie "\$1"-ragged" \{\
-.    ds doc-display-type-stack\ndoc-display-depth ragged
-.    na
-.    fi
-.  \}
-.  el \{ .ie "\$1"-centered" \{\
-.    ds doc-display-type-stack\ndoc-display-depth centered
-.    ad c
-.    fi
-.  \}
-.  el \{ .ie "\$1"-unfilled" \{\
-.    ds doc-display-type-stack\ndoc-display-depth unfilled
-.    nf
-.  \}
-.  el \{\
-.    tm1 "mdoc warning: Unknown keyword '\$1' (or missing display type)
-.    tm1 "              in .Bd macro (#\n.c)
-.    nr doc-reg-Bd 0
-.  \}\}\}\}\}
-.
-.  \" have we seen an argument?
-.  if \ndoc-reg-Bd \{\
-.    shift
-.    \" check other arguments
-.    if \n.$ \
-.      doc-do-Bd-args \$@
-.  \}
-.
-.  \" avoid warning about non-existent register
-.  if !r doc-display-indent-stack\ndoc-display-depth \
-.    nr doc-display-indent-stack\ndoc-display-depth 0
-.
-.  if \ndoc-display-indent-stack\ndoc-display-depth \
-.    in +\ndoc-display-indent-stack\ndoc-display-depthu
-.
-.  if !\ndoc-is-compact \
-.    sp \ndoc-display-verticalu
-.
-.  if "\*doc-display-type-stack\ndoc-display-depth"literal" \
-.    if t \
-.      nop \*doc-Li-font\c
-.
-.  if !\ncR \
-.    ne 2v
-.
-.  if !"\*doc-display-file"" \
-.    so \*doc-display-file
-.
-.  nr doc-is-compact 0
-.  ds doc-display-file
-..
-.
-.
-.\" NS doc-do-Bd-args macro
-.\" NS   resolve remaining .Bd arguments
-.\" NS
-.\" NS modifies:
-.\" NS   doc-display-file
-.\" NS   doc-display-indent-stackXXX
-.\" NS   doc-is-compact
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-ddBa
-.\" NS   doc-reg-ddBa1
-.\" NS   doc-reg-ddBa2
-.\" NS   doc-reg-ddBa3
-.\" NS   doc-reg-ddBa4
-.\" NS   doc-str-ddBa
-.
-.de doc-do-Bd-args
-.  nr doc-reg-ddBa 1
-.
-.  ie        "\$1"-offset" \{\
-.    nr doc-reg-ddBa 2
-.
-.    ie        "\$2"left" \
-.      nr doc-display-indent-stack\ndoc-display-depth 0
-.    el \{ .ie "\$2"right" \
-.      nr doc-display-indent-stack\ndoc-display-depth (\n.lu / 3u)
-.    el \{ .ie "\$2"center" \
-.      nr doc-display-indent-stack\ndoc-display-depth ((\n.lu - \n.iu) / 4u)
-.    el \{ .ie "\$2"indent" \
-.      nr doc-display-indent-stack\ndoc-display-depth \ndoc-display-indentu
-.    el \{ .ie "\$2"indent-two" \
-.      nr doc-display-indent-stack\ndoc-display-depth (\ndoc-display-indentu + \ndoc-display-indentu)
-.    el \
-.      nr doc-reg-ddBa 1
-.    \}\}\}\}
-.
-.    \" not a known keyword
-.    if (\ndoc-reg-ddBa == 1) \{\
-.      nr doc-reg-ddBa 2
-.
-.      nr doc-reg-ddBa1 0
-.      if \B&#x7;(\$2)&#x7; \{\
-.        \" disable warnings related to scaling indicators (32)
-.        nr doc-reg-ddBa2 \n.warn
-.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
-.
-.        \" values without a scaling indicator are taken as strings;
-.        \" we test whether the parameter string with and without the
-.        \" last character yields identical numerical results (ignoring
-.        \" the scaling indicator)
-.        ds doc-str-ddBa "\$2
-.        substring doc-str-ddBa 0 -2
-.        if \B&#x7;(\*doc-str-ddBa)&#x7; \{\
-.          nr doc-reg-ddBa3 (;(\$2))
-.          nr doc-reg-ddBa4 (\*doc-str-ddBa)
-.          if (\ndoc-reg-ddBa3 == \ndoc-reg-ddBa4) \
-.            nr doc-reg-ddBa1 1
-.        \}
-.
-.        \" enable all warnings again
-.        warn \ndoc-reg-ddBa2
-.      \}
-.
-.      ie \ndoc-reg-ddBa1 \
-.        nr doc-display-indent-stack\ndoc-display-depth \$2
-.      el \{\
-.        doc-get-width "\$2"
-.        ie (\ndoc-width <= 3) \{\
-.          \" if the offset parameter is a macro, use the macro's
-.          \" width as specified in doc-common
-.          doc-get-arg-type "\$2"
-.          ie (\ndoc-arg-type == 1) \
-.            nr doc-display-indent-stack\ndoc-display-depth \n\$2
-.          el \
-.            nr doc-display-indent-stack\ndoc-display-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.        \}
-.        el \
-.          nr doc-display-indent-stack\ndoc-display-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.    \}\}
-.  \}
-.  el \{ .ie "\$1"-compact" \
-.    nr doc-is-compact 1
-.  el \{ .ie "\$1"-file" \{\
-.    ie !"\$2"" \{\
-.      ds doc-display-file "\$2
-.      nr doc-reg-ddBa 2
-.    \}
-.    el \
-.      tm mdoc warning: .Bd '-file' keyword requires argument (#\n.c)
-.  \}
-.  el \
-.      tm mdoc warning: Unknown keyword '\$1' in .Bd macro (#\n.c)
-.  \}\}
-.
-.  if (\ndoc-reg-ddBa < \n.$) \{\
-.    shift \ndoc-reg-ddBa
-.    doc-do-Bd-args \$@
-.  \}
-..
-.
-.
-.\" NS Ed user macro
-.\" NS   end display
-.\" NS
-.\" NS modifies:
-.\" NS   doc-display-depth
-.\" NS   doc-display-indent-stackXXX
-.\" NS   doc-display-type-stackXXX
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Ed' set in doc-common
-.
-.de Ed
-.  ds doc-macro-name Ed
-.
-.  br
-.
-.  if !\ndoc-display-depth \{\
-.    tm mdoc warning: Extraneous .Ed (#\n.c)
-.    nr doc-display-depth 1
-.  \}
-.
-.  if "\*doc-display-type-stack\ndoc-display-depth"literal" \{\
-.    ft \ndoc-display-ft-stack\ndoc-display-depth
-.    ps \ndoc-display-ps-stack\ndoc-display-depthu
-.  \}
-.
-.  in -\ndoc-display-indent-stack\ndoc-display-depthu
-.
-.  \" restore saved adjustment and fill modes
-.  ie \ndoc-display-fi-stack\ndoc-display-depth \
-.    fi
-.  el \
-.    nf
-.  ad \ndoc-display-ad-stack\ndoc-display-depth
-.
-.  nr doc-display-indent-stack\ndoc-display-depth 0
-.  ds doc-display-type-stack\ndoc-display-depth
-.  nr doc-display-depth -1
-..
-.
-.
-.\" NS doc-list-type-stackXXX global string
-.\" NS   stack of list types
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.ds doc-list-type-stack1
-.
-.
-.\" NS doc-list-indent-stackXXX global register
-.\" NS   stack of list indentation values
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.nr doc-list-indent-stack1 0
-.
-.
-.\" NS doc-list-have-indent-stackXXX global register (bool)
-.\" NS   an indentation value is active
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.nr doc-list-have-indent-stack1 0
-.
-.
-.\" NS Bl user macro
-.\" NS   begin list
-.\" NS
-.\" NS width register 'Bl' set in doc-common
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-list-depth
-.\" NS   doc-list-have-indent-stackXXX
-.\" NS   doc-list-indent-stackXXX
-.\" NS   doc-list-type-stackXXX
-.\" NS   doc-macro-name
-.\" NS   doc-num-args
-.\" NS   doc-num-columns
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Bl
-.
-.de Bl
-.  if !\n.$ \{\
-.    doc-Bl-usage
-.    return
-.  \}
-.
-.  ds doc-macro-name Bl
-.  nr doc-list-depth +1
-.  nr doc-arg-ptr 1
-.
-.  ie        "\$1"-hang" \{\
-.    ds doc-list-type-stack\ndoc-list-depth hang-list
-.    nr doc-list-indent-stack\ndoc-list-depth 6n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-tag" \{\
-.    ds doc-list-type-stack\ndoc-list-depth tag-list
-.    nr doc-list-indent-stack\ndoc-list-depth 6n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-item" \{\
-.    ds doc-list-type-stack\ndoc-list-depth item-list
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-enum" \{\
-.    ds doc-list-type-stack\ndoc-list-depth enum-list
-.    nr doc-list-indent-stack\ndoc-list-depth 3n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-bullet" \{\
-.    ds doc-list-type-stack\ndoc-list-depth bullet-list
-.    nr doc-list-indent-stack\ndoc-list-depth 2n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-dash" \{\
-.    ds doc-list-type-stack\ndoc-list-depth dash-list
-.    nr doc-list-indent-stack\ndoc-list-depth 2n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-hyphen" \{\
-.    ds doc-list-type-stack\ndoc-list-depth dash-list
-.    nr doc-list-indent-stack\ndoc-list-depth 2n
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-inset" \{\
-.    ds doc-list-type-stack\ndoc-list-depth inset-list
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-diag" \{\
-.    ds doc-list-type-stack\ndoc-list-depth diag-list
-.  \}
-.  el \{ .ie "\$1"-ohang" \{\
-.    ds doc-list-type-stack\ndoc-list-depth ohang-list
-.    nr doc-list-have-indent-stack\ndoc-list-depth 1
-.  \}
-.  el \{ .ie "\$1"-column" \{\
-.    ds doc-list-type-stack\ndoc-list-depth column-list
-.    linetabs 1
-.  \}
-.  el \{\
-.    tm1 "mdoc warning: Unknown list type '\$1' (or missing list type)
-.    tm1 "              in .Bl macro
-.    tm
-.    nr doc-arg-ptr 0
-.  \}\}\}\}\}\}\}\}\}\}\}
-.
-.  \" we have seen a list type
-.  if !\ndoc-arg-ptr \{\
-.    doc-Bl-usage
-.    doc-reset-args
-.    nr doc-list-depth -1
-.    return
-.  \}
-.
-.  shift
-.
-.  \" fill argument vector
-.  nr doc-reg-Bl 1
-.  while (\ndoc-reg-Bl <= \n.$) \{\
-.    ds doc-arg\ndoc-reg-Bl "\$\ndoc-reg-Bl
-.    \" dummy type and space so that doc-save-global-vars() doesn't warn
-.    nr doc-type\ndoc-reg-Bl 0
-.    ds doc-space\ndoc-reg-Bl
-.    nr doc-reg-Bl +1
-.  \}
-.
-.  doc-increment-list-stack
-.
-.  if \n.$ \{\
-.    nr doc-arg-limit \n.$
-.    nr doc-arg-ptr 0
-.    doc-do-Bl-args
-.
-.    in +\ndoc-list-offset-stack\ndoc-list-depthu
-.
-.    \" initialize column list
-.    if "\*doc-list-type-stack\ndoc-list-depth"column-list" \{\
-.      doc-set-column-tab \ndoc-num-columns
-'      in -\ndoc-column-indent-widthu
-.      if !\ndoc-compact-list-stack\ndoc-list-depth \
-.        sp \ndoc-display-verticalu
-.
-.      nf
-.      nr doc-num-columns 0
-.  \}\}
-.
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-Bl-usage macro
-.
-.de doc-Bl-usage
-.  tm1 "Usage: .Bl {-hang | -ohang | -tag | -diag | -inset}
-.  tm1 "             -width <string>
-.  tm1 "             -offset <string> -compact
-.  tm1 "       .Bl -column -offset <string> <string1> <string2> ...
-.  tm1 "       .Bl {-item | -enum -nested | -bullet | -hyphen | -dash}
-.  tm1 "             -offset <string> -compact (#\n.c)
-..
-.
-.
-.\" NS doc-do-Bl-args macro
-.\" NS   resolve remaining .Bl arguments
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-compact-list-stackXXX
-.\" NS   doc-list-indent-stackXXX
-.\" NS   doc-list-offset-stackXXX
-.\" NS   doc-num-columns
-.\" NS   doc-tag-prefix-stackXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-box-dBla
-.\" NS   doc-env-dBla
-.\" NS   doc-reg-dBla
-.\" NS   doc-reg-dBla1
-.\" NS   doc-reg-dBla2
-.\" NS   doc-reg-dBla3
-.\" NS   doc-reg-dBla4
-.\" NS   doc-str-dBla
-.\" NS   doc-str-dBla1
-.
-.de doc-do-Bl-args
-.  nr doc-arg-ptr +1
-.
-.  if (\ndoc-arg-limit < \ndoc-arg-ptr) \
-.    return
-.
-.  \" avoid a warning message in case e.g. '-offset' has no parameter
-.  nr doc-reg-dBla (\ndoc-arg-ptr + 1)
-.  if (\ndoc-arg-limit < \ndoc-reg-dBla) \
-.    ds doc-arg\ndoc-reg-dBla
-.
-.  nr doc-reg-dBla 1
-.
-.  ie        "\*doc-arg\ndoc-arg-ptr"-compact" \
-.    nr doc-compact-list-stack\ndoc-list-depth 1
-.
-.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-nested" \{\
-.    ie (\ndoc-list-depth > 1) \{\
-.      nr doc-reg-dBla1 (\ndoc-list-depth - 1)
-.      ds doc-tag-prefix-stack\ndoc-list-depth "\*doc-tag-prefix-stack\ndoc-reg-dBla1
-.      as doc-tag-prefix-stack\ndoc-list-depth \ndoc-enum-list-count-stack\ndoc-reg-dBla1.
-.      length doc-reg-dBla1 "\*doc-tag-prefix-stack\ndoc-list-depth
-.      nr doc-list-indent-stack\ndoc-list-depth +\ndoc-reg-dBla1n
-.    \}
-.    el \
-.      tm mdoc warning: '-nested' allowed with nested .Bl macros only (#\n.c)
-.  \}
-.
-.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-width" \{\
-.    nr doc-arg-ptr +1
-.    ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.    substring doc-str-dBla 0 0
-.    ie &#x7;.&#x7;\*doc-str-dBla&#x7; \{\
-.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.      substring doc-str-dBla 1
-.      doc-first-parameter \*doc-str-dBla
-.      doc-get-width "\*doc-str-dfp
-.      doc-get-arg-type "\*doc-str-dfp
-.      ie (\ndoc-arg-type == 1) \
-.        nr doc-reg-dBla1 1
-.      el \
-.        nr doc-reg-dBla1 0
-.    \}
-.    el \
-.      nr doc-reg-dBla1 0
-.    ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.
-.    ie \ndoc-reg-dBla1 \{\
-.      \" execute string in a box to get the width of the diversion
-.      ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
-.      doc-save-global-vars
-.      doc-reset-args
-.      box doc-box-dBla
-.      ev doc-env-dBla
-.      evc 0
-.      in 0
-.      nf
-.      nop \*doc-str-dBla
-.      br
-.      ev
-.      box
-.      doc-restore-global-vars
-.      doc-get-width \h'\ndlu'
-.      nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.    \}
-.    el \{\
-.      \" test whether argument is a valid numeric expression
-.      nr doc-reg-dBla1 0
-.      if \B&#x7;(\*doc-str-dBla)&#x7; \{\
-.        \" disable warnings related to scaling indicators (32)
-.        nr doc-reg-dBla2 \n.warn
-.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
-.
-.        \" values without a scaling indicator are taken as strings;
-.        \" we test whether the parameter string with and without the
-.        \" last character yields identical numerical results (ignoring
-.        \" the scaling indicator)
-.        ds doc-str-dBla1 "\*doc-str-dBla
-.        substring doc-str-dBla1 0 -2
-.        if \B&#x7;(\*doc-str-dBla1)&#x7; \{\
-.          nr doc-reg-dBla3 (;(\*doc-str-dBla))
-.          nr doc-reg-dBla4 (\*doc-str-dBla1)
-.          if (\ndoc-reg-dBla3 == \ndoc-reg-dBla4) \
-.            nr doc-reg-dBla1 1
-.        \}
-.
-.        \" enable all warnings again
-.        warn \ndoc-reg-dBla2
-.      \}
-.
-.      ie \ndoc-reg-dBla1 \
-.        nr doc-list-indent-stack\ndoc-list-depth (\*doc-str-dBla)
-.      el \{\
-.        doc-get-arg-width \ndoc-arg-ptr
-.        ie (\ndoc-width == 2) \{\
-.          \" if the width parameter is a macro, use the macro's
-.          \" width as specified in doc-common
-.          doc-get-arg-type \*doc-str-dBla
-.          ie (\ndoc-arg-type == 1) \
-.            nr doc-list-indent-stack\ndoc-list-depth \n\*doc-str-dBla
-.          el \
-.            nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.        \}
-.        el \
-.          nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.  \}\}\}
-.
-.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-offset" \{\
-.    nr doc-arg-ptr +1
-.
-.    ie "\*doc-arg\ndoc-arg-ptr"indent" \
-.      nr doc-list-offset-stack\ndoc-list-depth \ndoc-display-indentu
-.    el \{\
-.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.      nr doc-reg-dBla1 0
-.      if \B&#x7;(\*doc-str-dBla)&#x7; \{\
-.        nr doc-reg-dBla2 \n.warn
-.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
-.
-.        ds doc-str-dBla1 "\*doc-str-dBla
-.        substring doc-str-dBla1 0 -2
-.        if \B&#x7;(\*doc-str-dBla1)&#x7; \{\
-.          nr doc-reg-dBla3 (;(\*doc-str-dBla))
-.          nr doc-reg-dBla4 (\*doc-str-dBla1)
-.          if (\ndoc-reg-dBla3 == \ndoc-reg-dBla4) \
-.            nr doc-reg-dBla1 1
-.        \}
-.
-.        warn \ndoc-reg-dBla2
-.      \}
-.
-.      ie \ndoc-reg-dBla1 \
-.        nr doc-list-offset-stack\ndoc-list-depth \*doc-str-dBla
-.      el \{\
-.        doc-get-arg-width \ndoc-arg-ptr
-.        ie (\ndoc-width <= 3) \{\
-.          \" if the offset parameter is a macro, use the macro's
-.          \" width as specified in doc-common
-.          doc-get-arg-type \*doc-str-dBla
-.          ie (\ndoc-arg-type == 1) \
-.            nr doc-list-offset-stack\ndoc-list-depth \n\*doc-str-dBla
-.          el \
-.            nr doc-list-offset-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.        \}
-.        el \
-.          nr doc-list-offset-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
-.  \}\}\}
-.  el \
-.    nr doc-reg-dBla 0
-.  \}\}\}
-.
-.  \" not a known keyword, so it specifies the width of the next column
-.  \" (if it is a column list)
-.  if !\ndoc-reg-dBla \{\
-.    ie "\*doc-list-type-stack\ndoc-list-depth"column-list" \{\
-.      nr doc-num-columns +1
-.      ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
-.      substring doc-str-dBla 0 0
-.      ie &#x7;.&#x7;\*doc-str-dBla&#x7; \{\
-.        ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.        substring doc-str-dBla 1
-.        doc-first-parameter \*doc-str-dBla
-.        doc-get-width "\*doc-str-dfp
-.        doc-get-arg-type "\*doc-str-dfp
-.        ie (\ndoc-arg-type == 1) \
-.          nr doc-reg-dBla1 1
-.        el \
-.          nr doc-reg-dBla1 0
-.      \}
-.      el \
-.        nr doc-reg-dBla1 0
-.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
-.
-.      ie \ndoc-reg-dBla1 \{\
-.        \" execute string in a box to get the width of the diversion
-.        ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
-.        doc-save-global-vars
-.        doc-reset-args
-.        box doc-box-dBla
-.        ev doc-env-dBla
-.        evc 0
-.        in 0
-.        nf
-.        nop \*doc-str-dBla
-.        br
-.        ev
-.        box
-.        doc-restore-global-vars
-.        ds doc-arg\ndoc-num-columns "\h'\ndlu'
-.      \}
-.      el \
-.        ds doc-arg\ndoc-num-columns "\*doc-arg\ndoc-arg-ptr
-.    \}
-.    el \{\
-.      tmc mdoc warning: Unknown keyword '\*doc-arg\ndoc-arg-ptr'
-.      tm1 " in .Bl macro (#\n.c)
-.  \}\}
-.
-.  if (\ndoc-arg-limit > \ndoc-arg-ptr) \
-.    doc-do-Bl-args
-..
-.
-.
-.\" NS doc-save-global-vars macro
-.\" NS   save all global variables
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dsgv
-.
-.de doc-save-global-vars
-.  ds doc-macro-name-saved "\*doc-macro-name
-.  nr doc-arg-limit-saved \ndoc-arg-limit
-.  nr doc-num-args-saved \ndoc-num-args
-.  nr doc-arg-ptr-saved \ndoc-arg-ptr
-.
-.  nr doc-reg-dsgv 1
-.  while (\ndoc-reg-dsgv <= \ndoc-arg-limit) \{\
-.    ds doc-arg\ndoc-reg-dsgv-saved "\*doc-arg\ndoc-reg-dsgv
-.    nr doc-type\ndoc-reg-dsgv-saved \ndoc-type\ndoc-reg-dsgv
-.    ds doc-space\ndoc-reg-dsgv-saved "\*doc-space\ndoc-reg-dsgv
-.    nr doc-reg-dsgv +1
-.  \}
-.
-.  nr doc-curr-font-saved \ndoc-curr-font
-.  nr doc-curr-size-saved \ndoc-curr-size
-.  nr doc-in-synopsis-section-saved \ndoc-in-synopsis-section
-.  nr doc-in-library-section-saved \ndoc-in-library-section
-.  nr doc-indent-synopsis-saved \ndoc-indent-synopsis
-.  nr doc-indent-synopsis-active-saved \ndoc-indent-synopsis-active
-.  nr doc-have-decl-saved \ndoc-have-decl
-.  nr doc-have-var-saved \ndoc-have-var
-.  ds doc-command-name-saved "\*doc-command-name
-.  ds doc-quote-left-saved "\*doc-quote-left
-.  ds doc-quote-right-saved "\*doc-quote-right
-.  nr doc-nesting-level-saved \ndoc-nesting-level
-.  nr doc-in-list-saved \ndoc-in-list
-.  ds doc-space-saved "\*doc-space
-.  ds doc-saved-space-saved "\*doc-saved-space
-.  nr doc-space-mode-saved \ndoc-space-mode
-.  nr doc-have-space-saved \ndoc-have-space
-.  nr doc-have-slot-saved \ndoc-have-slot
-.  nr doc-keep-type-saved \ndoc-keep-type
-.  nr doc-display-depth-saved \ndoc-display-depth
-.  nr doc-is-compact-saved \ndoc-is-compact
-.
-.  nr doc-reg-dsgv 0
-.  while (\ndoc-reg-dsgv <= \ndoc-display-depth) \{\
-.    ds doc-display-type-stack\ndoc-reg-dsgv-saved "\*doc-display-type-stack\ndoc-reg-dsgv
-.    nr doc-display-indent-stack\ndoc-reg-dsgv-saved \ndoc-display-indent-stack\ndoc-reg-dsgv
-.    nr doc-display-ad-stack\ndoc-reg-dsgv-saved \ndoc-display-ad-stack\ndoc-reg-dsgv
-.    nr doc-display-fi-stack\ndoc-reg-dsgv-saved \ndoc-display-fi-stack\ndoc-reg-dsgv
-.    nr doc-display-ft-stack\ndoc-reg-dsgv-saved \ndoc-display-ft-stack\ndoc-reg-dsgv
-.    nr doc-display-ps-stack\ndoc-reg-dsgv-saved \ndoc-display-ps-stack\ndoc-reg-dsgv
-.    nr doc-reg-dsgv +1
-.  \}
-.
-.  nr doc-fontmode-depth-saved \ndoc-fontmode-depth
-.
-.  nr doc-reg-dsgv 1
-.  while (\ndoc-reg-dsgv <= \ndoc-fontmode-depth) \{\
-.    nr doc-fontmode-font-stack\ndoc-reg-dsgv-saved \ndoc-fontmode-font-stack\ndoc-reg-dsgv
-.    nr doc-fontmode-size-stack\ndoc-reg-dsgv-saved \ndoc-fontmode-size-stack\ndoc-reg-dsgv
-.    nr doc-reg-dsgv +1
-.  \}
-.
-.  nr doc-list-depth-saved \ndoc-list-depth
-.
-.  nr doc-reg-dsgv 1
-.  while (\ndoc-reg-dsgv <= \ndoc-list-depth) \{\
-.    ds doc-list-type-stack\ndoc-reg-dsgv-saved "\*doc-list-type-stack\ndoc-reg-dsgv
-.    nr doc-list-have-indent-stack\ndoc-reg-dsgv-saved \ndoc-list-have-indent-stack\ndoc-reg-dsgv
-.    nr doc-list-indent-stack\ndoc-reg-dsgv-saved \ndoc-list-indent-stack\ndoc-reg-dsgv
-.    nr doc-compact-list-stack\ndoc-reg-dsgv-saved \ndoc-compact-list-stack\ndoc-reg-dsgv
-.    ds doc-tag-prefix-stack\ndoc-reg-dsgv-saved "\*doc-tag-prefix-stack\ndoc-reg-dsgv
-.    nr doc-list-offset-stack\ndoc-reg-dsgv-saved \ndoc-list-offset-stack\ndoc-reg-dsgv
-.    nr doc-enum-list-count-stack\ndoc-reg-dsgv-saved \ndoc-enum-list-count-stack\ndoc-reg-dsgv
-.    nr doc-reg-dsgv +1
-.  \}
-.
-.  ds doc-saved-Pa-font-saved "\*doc-saved-Pa-font
-.  nr doc-curr-type-saved \ndoc-curr-type
-.  ds doc-curr-arg-saved "\*doc-curr-arg
-.  nr doc-diag-list-input-line-count-saved \ndoc-diag-list-input-line-count
-.  nr doc-num-columns-saved \ndoc-num-columns
-.  nr doc-column-indent-width-saved \ndoc-column-indent-width
-.  nr doc-is-func-saved \ndoc-is-func
-.  nr doc-have-old-func-saved \ndoc-have-old-func
-.  nr doc-func-arg-count-saved \ndoc-func-arg-count
-.  ds doc-func-arg-saved "\*doc-func-arg
-.  nr doc-num-func-args-saved \ndoc-num-func-args
-.  nr doc-func-args-processed-saved \ndoc-func-args-processed
-.  nr doc-have-func-saved \ndoc-have-func
-.  nr doc-is-reference-saved \ndoc-is-reference
-.  nr doc-reference-count-saved \ndoc-reference-count
-.  nr doc-author-count-saved \ndoc-author-count
-.
-.  nr doc-reg-dsgv 0
-.  while (\ndoc-reg-dsgv <= \ndoc-author-count) \{\
-.    ds doc-author-name\ndoc-reg-dsgv-saved "\*doc-author-name\ndoc-reg-dsgv
-.    nr doc-reg-dsgv +1
-.  \}
-.
-.  nr doc-book-count-saved \ndoc-book-count
-.  ds doc-book-name-saved "\*doc-book-name
-.  nr doc-city-count-saved \ndoc-city-count
-.  ds doc-city-name-saved "\*doc-city-name
-.  nr doc-date-count-saved \ndoc-date-count
-.  ds doc-date-saved "\*doc-date
-.  nr doc-publisher-count-saved \ndoc-publisher-count
-.  ds doc-publisher-name-saved "\*doc-publisher-name
-.  nr doc-journal-count-saved \ndoc-journal-count
-.  ds doc-journal-name-saved "\*doc-journal-name
-.  nr doc-issue-count-saved \ndoc-issue-count
-.  ds doc-issue-name-saved "\*doc-issue-name
-.  nr doc-optional-count-saved \ndoc-optional-count
-.  ds doc-optional-string-saved "\*doc-optional-string
-.  nr doc-page-number-count-saved \ndoc-page-number-count
-.  ds doc-page-number-string-saved "\*doc-page-number-string
-.  nr doc-corporate-count-saved \ndoc-corporate-count
-.  ds doc-corporate-name-saved "\*doc-corporate-name
-.  nr doc-report-count-saved \ndoc-report-count
-.  ds doc-report-name-saved "\*doc-report-name
-.  nr doc-reference-title-count-saved \ndoc-reference-title-count
-.  ds doc-reference-title-name-saved "\*doc-reference-title-name
-.  ds doc-reference-title-name-for-book-saved "\*doc-reference-title-name-for-book
-.  nr doc-url-count-saved \ndoc-url-count
-.  ds doc-url-name-saved "\*doc-url-name
-.  nr doc-volume-count-saved \ndoc-volume-count
-.  ds doc-volume-name-saved "\*doc-volume-name
-.  nr doc-have-author-saved \ndoc-have-author
-.
-.  ds doc-document-title-saved "\*doc-document-title
-.  ds doc-volume-saved "\*doc-volume
-.  ds doc-section-saved "\*doc-section
-.  ds doc-operating-system-saved "\*doc-operating-system
-.  ds doc-date-string-saved "\*doc-date-string
-.  nr doc-header-space-saved \ndoc-header-space
-.  nr doc-footer-space-saved \ndoc-footer-space
-.  nr doc-display-vertical-saved \ndoc-display-vertical
-.  ds doc-header-string-saved "\*doc-header-string
-.  nr doc-in-see-also-section-saved \ndoc-in-see-also-section
-.  nr doc-in-files-section-saved \ndoc-in-files-section
-.  nr doc-in-authors-section-saved \ndoc-in-authors-section
-..
-.
-.
-.\" NS doc-restore-global-vars macro
-.\" NS   restore all global variables
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-drgv
-.
-.de doc-restore-global-vars
-.  ds doc-macro-name "\*doc-macro-name-saved
-.  nr doc-arg-limit \ndoc-arg-limit-saved
-.  nr doc-num-args \ndoc-num-args-saved
-.  nr doc-arg-ptr \ndoc-arg-ptr-saved
-.
-.  nr doc-reg-drgv 1
-.  while (\ndoc-reg-drgv <= \ndoc-arg-limit) \{\
-.    ds doc-arg\ndoc-reg-drgv "\*doc-arg\ndoc-reg-drgv-saved
-.    nr doc-type\ndoc-reg-drgv \ndoc-type\ndoc-reg-drgv-saved
-.    ds doc-space\ndoc-reg-drgv "\*doc-space\ndoc-reg-drgv-saved
-.    nr doc-reg-drgv +1
-.  \}
-.
-.  nr doc-curr-font \ndoc-curr-font-saved
-.  nr doc-curr-size \ndoc-curr-size-saved
-.  nr doc-in-synopsis-section \ndoc-in-synopsis-section-saved
-.  nr doc-in-library-section \ndoc-in-library-section-saved
-.  nr doc-indent-synopsis \ndoc-indent-synopsis-saved
-.  nr doc-indent-synopsis-active \ndoc-indent-synopsis-active-saved
-.  nr doc-have-decl \ndoc-have-decl-saved
-.  nr doc-have-var \ndoc-have-var-saved
-.  ds doc-command-name "\*doc-command-name-saved
-.  ds doc-quote-left "\*doc-quote-left-saved
-.  ds doc-quote-right "\*doc-quote-right-saved
-.  nr doc-nesting-level \ndoc-nesting-level-saved
-.  nr doc-in-list \ndoc-in-list-saved
-.  ds doc-space "\*doc-space-saved
-.  ds doc-saved-space "\*doc-saved-space-saved
-.  nr doc-space-mode \ndoc-space-mode-saved
-.  nr doc-have-space \ndoc-have-space-saved
-.  nr doc-have-slot \ndoc-have-slot-saved
-.  nr doc-keep-type \ndoc-keep-type-saved
-.  nr doc-display-depth \ndoc-display-depth-saved
-.  nr doc-is-compact \ndoc-is-compact-saved
-.
-.  nr doc-reg-drgv 0
-.  while (\ndoc-reg-drgv <= \ndoc-display-depth) \{\
-.    ds doc-display-type-stack\ndoc-reg-drgv "\*doc-display-type-stack\ndoc-reg-drgv-saved
-.    nr doc-display-indent-stack\ndoc-reg-drgv \ndoc-display-indent-stack\ndoc-reg-drgv-saved
-.    nr doc-display-ad-stack\ndoc-reg-drgv \ndoc-display-ad-stack\ndoc-reg-drgv-saved
-.    nr doc-display-fi-stack\ndoc-reg-drgv \ndoc-display-fi-stack\ndoc-reg-drgv-saved
-.    nr doc-display-ft-stack\ndoc-reg-drgv \ndoc-display-ft-stack\ndoc-reg-drgv-saved
-.    nr doc-display-ps-stack\ndoc-reg-drgv \ndoc-display-ps-stack\ndoc-reg-drgv-saved
-.    nr doc-reg-drgv +1
-.  \}
-.
-.  nr doc-fontmode-depth \ndoc-fontmode-depth-saved
-.
-.  nr doc-reg-drgv 1
-.  while (\ndoc-reg-drgv <= \ndoc-fontmode-depth) \{\
-.    nr doc-fontmode-font-stack\ndoc-reg-drgv \ndoc-fontmode-font-stack\ndoc-reg-drgv-saved
-.    nr doc-fontmode-size-stack\ndoc-reg-drgv \ndoc-fontmode-size-stack\ndoc-reg-drgv-saved
-.    nr doc-reg-drgv +1
-.  \}
-.
-.  nr doc-list-depth \ndoc-list-depth-saved
-.
-.  nr doc-reg-drgv 1
-.  while (\ndoc-reg-drgv <= \ndoc-list-depth) \{\
-.    ds doc-list-type-stack\ndoc-reg-drgv "\*doc-list-type-stack\ndoc-reg-drgv-saved
-.    nr doc-list-have-indent-stack\ndoc-reg-drgv \ndoc-list-have-indent-stack\ndoc-reg-drgv-saved
-.    nr doc-list-indent-stack\ndoc-reg-drgv \ndoc-list-indent-stack\ndoc-reg-drgv-saved
-.    nr doc-compact-list-stack\ndoc-reg-drgv \ndoc-compact-list-stack\ndoc-reg-drgv-saved
-.    ds doc-tag-prefix-stack\ndoc-reg-drgv "\*doc-tag-prefix-stack\ndoc-reg-drgv-saved
-.    nr doc-list-offset-stack\ndoc-reg-drgv \ndoc-list-offset-stack\ndoc-reg-drgv-saved
-.    nr doc-enum-list-count-stack\ndoc-reg-drgv \ndoc-enum-list-count-stack\ndoc-reg-drgv-saved
-.    nr doc-reg-drgv +1
-.  \}
-.
-.  ds doc-saved-Pa-font "\*doc-saved-Pa-font-saved
-.  nr doc-curr-type \ndoc-curr-type-saved
-.  ds doc-curr-arg "\*doc-curr-arg-saved
-.  nr doc-diag-list-input-line-count \ndoc-diag-list-input-line-count-saved
-.  nr doc-num-columns \ndoc-num-columns-saved
-.  nr doc-column-indent-width \ndoc-column-indent-width-saved
-.  nr doc-is-func \ndoc-is-func-saved
-.  nr doc-have-old-func \ndoc-have-old-func-saved
-.  nr doc-func-arg-count \ndoc-func-arg-count-saved
-.  ds doc-func-arg "\*doc-func-arg-saved
-.  nr doc-num-func-args \ndoc-num-func-args-saved
-.  nr doc-func-args-processed \ndoc-func-args-processed-saved
-.  nr doc-have-func \ndoc-have-func-saved
-.  nr doc-is-reference \ndoc-is-reference-saved
-.  nr doc-reference-count \ndoc-reference-count-saved
-.  nr doc-author-count \ndoc-author-count-saved
-.
-.  nr doc-reg-drgv 0
-.  while (\ndoc-reg-drgv <= \ndoc-author-count) \{\
-.    ds doc-author-name\ndoc-reg-drgv "\*doc-author-name\ndoc-reg-drgv-saved
-.    nr doc-reg-drgv +1
-.  \}
-.
-.  nr doc-book-count \ndoc-book-count-saved
-.  ds doc-book-name "\*doc-book-name-saved
-.  nr doc-city-count \ndoc-city-count-saved
-.  ds doc-city-name "\*doc-city-name-saved
-.  nr doc-date-count \ndoc-date-count-saved
-.  ds doc-date "\*doc-date-saved
-.  nr doc-publisher-count \ndoc-publisher-count-saved
-.  ds doc-publisher-name "\*doc-publisher-name-saved
-.  nr doc-journal-count \ndoc-journal-count-saved
-.  ds doc-journal-name "\*doc-journal-name-saved
-.  nr doc-issue-count \ndoc-issue-count-saved
-.  ds doc-issue-name "\*doc-issue-name-saved
-.  nr doc-optional-count \ndoc-optional-count-saved
-.  ds doc-optional-string "\*doc-optional-string-saved
-.  nr doc-page-number-count \ndoc-page-number-count-saved
-.  ds doc-page-number-string "\*doc-page-number-string-saved
-.  nr doc-corporate-count \ndoc-corporate-count-saved
-.  ds doc-corporate-name "\*doc-corporate-name-saved
-.  nr doc-report-count \ndoc-report-count-saved
-.  ds doc-report-name "\*doc-report-name-saved
-.  nr doc-reference-title-count \ndoc-reference-title-count-saved
-.  ds doc-reference-title-name "\*doc-reference-title-name-saved
-.  ds doc-reference-title-name-for-book "\*doc-reference-title-name-for-book-saved
-.  nr doc-url-count \ndoc-url-count-saved
-.  ds doc-url-name "\*doc-url-name-saved
-.  nr doc-volume-count \ndoc-volume-count-saved
-.  ds doc-volume-name "\*doc-volume-name-saved
-.  nr doc-have-author \ndoc-have-author-saved
-.
-.  ds doc-document-title "\*doc-document-title-saved
-.  ds doc-volume "\*doc-volume-saved
-.  ds doc-section "\*doc-section-saved
-.  ds doc-operating-system "\*doc-operating-system-saved
-.  ds doc-date-string "\*doc-date-string-saved
-.  nr doc-header-space \ndoc-header-space-saved
-.  nr doc-footer-space \ndoc-footer-space-saved
-.  nr doc-display-vertical \ndoc-display-vertical-saved
-.  ds doc-header-string "\*doc-header-string-saved
-.  nr doc-in-see-also-section \ndoc-in-see-also-section-saved
-.  nr doc-in-files-section \ndoc-in-files-section-saved
-.  nr doc-in-authors-section \ndoc-in-authors-section-saved
-..
-.
-.
-.\" NS El user macro
-.\" NS   end list
-.\" NS
-.\" NS modifies:
-.\" NS   doc-list-depth
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-str-El
-.\" NS
-.\" NS width register 'El' set in doc-common
-.
-.de El
-.  if \n.$ \{\
-.    tm Usage: .El (does not take arguments) (#\n.c)
-.    return
-.  \}
-.
-.  ds doc-macro-name El
-.  ds doc-str-El \*doc-list-type-stack\ndoc-list-depth
-.
-.  ie        "\*doc-str-El"diag-list" \
-.    doc-end-list 0
-.  el \{ .ie "\*doc-str-El"column-list" \
-.    doc-end-column-list
-.  el \{ .ie "\*doc-str-El"item-list" \
-.    doc-end-list 0
-.  el \{ .ie "\*doc-str-El"ohang-list" \
-.    doc-end-list 0
-.  el \{ .ie "\*doc-str-El"inset-list" \
-.    doc-end-list 0
-.  el \
-.    doc-end-list 1
-.  \}\}\}\}
-.
-.  br
-..
-.
-.
-.\" NS doc-saved-Pa-font global string
-.\" NS   saved doc-Pa-font string for section FILES (no underline if
-.\" NS   nroff)
-.
-.ds doc-saved-Pa-font
-.
-.
-.\" NS doc-curr-type global register
-.\" NS   current argument type
-.
-.nr doc-curr-type 0
-.
-.
-.\" NS doc-curr-arg global string
-.\" NS   current argument
-.
-.ds doc-curr-arg
-.
-.
-.\" NS doc-item-boxXXX global box
-.\" NS   item boxes associated list depth
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.
-.\" NS It user macro
-.\" NS   list item
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-curr-arg
-.\" NS   doc-curr-type
-.\" NS   doc-in-list
-.\" NS   doc-macro-name
-.\" NS   doc-num-args
-.\" NS   doc-saved-Pa-font
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-It
-.\" NS   doc-str-It
-.\" NS   doc-XXX-list-type
-.\" NS
-.\" NS width register 'It' set in doc-common
-.
-.nr doc-bullet-list-type 1
-.nr doc-column-list-type 0
-.nr doc-dash-list-type 1
-.nr doc-diag-list-type 0
-.nr doc-enum-list-type 1
-.nr doc-hang-list-type 2
-.nr doc-inset-list-type 2
-.nr doc-item-list-type 1
-.nr doc-ohang-list-type 2
-.nr doc-tag-list-type 2
-.
-.de It
-.  ds doc-str-It \*doc-list-type-stack\ndoc-list-depth
-.
-.  if "\*doc-str-It"" \
-.    tm mdoc error: .It without preceding .Bl (#\n.c)
-.
-.  if \ndoc-nesting-level \{\
-.    tmc "mdoc error: .It found in enclosing (e.g. .Ac ... .It ... .Ao)
-.    tm1 " (#\n.c)
-.  \}
-.
-.  br
-.  if !\ncR \
-.    ne 3v
-.
-.  if \n.$ \{\
-.    ds doc-macro-name It
-.
-.    \" fill argument vector
-.    nr doc-reg-It 1
-.    while (\ndoc-reg-It <= \n.$) \{\
-.      ds doc-arg\ndoc-reg-It "\$\ndoc-reg-It
-.      nr doc-reg-It +1
-.    \}
-.
-.    nr doc-num-args \n.$
-.    nr doc-arg-ptr 0
-.  \}
-.
-.  nr doc-reg-It \ndoc-\*doc-str-It-type
-.
-.  if \ndoc-reg-It \{\
-.    \" start item box
-.    box doc-item-box\ndoc-list-depth
-.    ev doc-item-env\ndoc-list-depth
-.    evc 0
-.    in 0
-.    nf
-.  \}
-.
-.  ie (\ndoc-reg-It == 1) \{\
-.    if \n.$ \{\
-.      tm1 "mdoc warning: .It macros in lists of type '\*doc-str-It'
-.      tm1 "              don't take arguments (#\n.c)
-.  \}\}
-.  el \{\
-.    ie \n.$ \{\
-.      if (\ndoc-reg-It == 2) \{\
-.        \" handle list types with arguments
-.        doc-parse-arg-vector
-.
-.        nr doc-in-list 1
-.        nr doc-arg-ptr 1
-.        nr doc-curr-type \ndoc-type1
-.        ds doc-curr-arg "\*doc-arg1
-.
-.        if \ndoc-in-files-section \{\
-.          ds doc-saved-Pa-font "\*doc-Pa-font
-.          if n \
-.            ds doc-Pa-font "\*doc-No-font
-.        \}
-.
-.        ie (\ndoc-type1 == 1) \
-.          \*doc-arg1
-.        el \{\
-.          nr doc-arg-ptr 1
-.          doc-print-recursive
-.    \}\}\}
-.    el \{\
-.      tm1 "mdoc warning: .It macros in lists of type '\*doc-str-It'
-.      tm1 "              require arguments (#\n.c)
-.    \}
-.  \}
-.
-.  \" the previous call of '.doc-print-recursive' can contain calls to
-.  \" opening macros like '.Ao'; we then defer the call of
-.  \" 'doc-xxx-list'
-.  if !\ndoc-nesting-level \
-.    doc-\*doc-str-It
-..
-.
-.
-.\" NS doc-inset-list macro
-.\" NS   .It item of list-type inset
-.\" NS
-.\" NS modifies:
-.\" NS   doc-in-list
-.
-.de doc-inset-list
-.  \" finish item box
-.  br
-.  ev
-.  box
-.  unformat doc-item-box\ndoc-list-depth
-.
-.  doc-set-vertical-and-indent 0
-.  br
-.
-.  nh
-.  doc-item-box\ndoc-list-depth
-.
-.  if \ndoc-in-files-section \
-.    if n \
-.      ds doc-Pa-font "\*doc-saved-Pa-font
-.
-.  nr doc-in-list 0
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-hang-list macro
-.\" NS   .It item of list-type hanging tag (as opposed to tagged)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-have-space
-.\" NS   doc-in-list
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dhl
-.\" NS   doc-reg-dhl1
-.
-.de doc-hang-list
-.  \" finish item box
-.  br
-.  ev
-.  box
-.  unformat doc-item-box\ndoc-list-depth
-.
-.  doc-set-vertical-and-indent 1
-.  nr doc-reg-dhl (\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
-.  ti -\ndoc-reg-dhlu
-.
-.  nh
-.  ie (\ndlu > \ndoc-list-indent-stack\ndoc-list-depthu) \
-.    doc-item-box\ndoc-list-depth
-.  el \{\
-.    chop doc-item-box\ndoc-list-depth
-.    nr doc-reg-dhl1 \n.ku
-.    nop \*doc-item-box\ndoc-list-depth\c
-.    nop \h'|(\ndoc-reg-dhl1u - \n.ku + \ndoc-reg-dhlu)'\c
-.    nr doc-have-space 1
-.  \}
-.
-.  if \ndoc-in-files-section \
-.    if n \
-.      ds doc-Pa-font "\*doc-saved-Pa-font
-.
-.  nr doc-in-list 0
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-ohang-list macro
-.\" NS   .It item of list-type overhanging tag
-.\" NS
-.\" NS modifies:
-.\" NS   doc-in-list
-.
-.de doc-ohang-list
-.  \" finish item box
-.  br
-.  ev
-.  box
-.  unformat doc-item-box\ndoc-list-depth
-.
-.  doc-set-vertical-and-indent 0
-.  nh
-.  doc-item-box\ndoc-list-depth
-.  br
-.
-.  if \ndoc-in-files-section \
-.    if n \
-.      ds doc-Pa-font "\*doc-saved-Pa-font
-.
-.  nr doc-in-list 0
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-item-list macro
-.\" NS   .It item of list-type empty tag
-.
-.de doc-item-list
-.  \" finish (dummy) item box
-.  br
-.  ev
-.  box
-.
-.  doc-set-vertical-and-indent 0
-.  br
-.
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-enum-list-count-stackXXX global register
-.\" NS   stack of current enum count values
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.nr doc-enum-list-count-stack1 0
-.
-.
-.\" NS doc-enum-list macro
-.\" NS   enumerated list
-.\" NS
-.\" NS modifies:
-.\" NS   doc-enum-list-count-stackXXX
-.\" NS   doc-in-list
-.
-.de doc-enum-list
-.  nr doc-in-list 1
-.  nr doc-enum-list-count-stack\ndoc-list-depth +1
-\# XXX
-\#.ll \ndoc-list-indent-stack\ndoc-list-depthu
-\#.rj
-.  nop \*doc-tag-prefix-stack\ndoc-list-depth\c
-.  nop \ndoc-enum-list-count-stack\ndoc-list-depth.\&
-.  doc-do-list
-..
-.
-.
-.\" NS doc-bullet-list macro
-.\" NS   bullet paragraph list
-.\" NS
-.\" NS modifies:
-.\" NS   doc-in-list
-.
-.de doc-bullet-list
-.  nr doc-in-list 1
-.  nop \)\*doc-Sy-font\bu\f
-.  doc-do-list
-..
-.
-.
-.\" NS doc-dash-list macro
-.\" NS   hyphen paragraph list (sub bullet list)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-in-list
-.
-.de doc-dash-list
-.  nr doc-in-list 1
-.  nop \)\*doc-Sy-font\-\f
-.  doc-do-list
-..
-.
-.
-.\" NS doc-do-list macro
-.\" NS   .It item of list-type enum/bullet/hyphen
-.
-.als doc-do-list doc-hang-list
-.
-.
-.\" NS doc-diag-list-input-line-count global register
-.\" NS   saved line number to be checked in next diag-list item
-.
-.nr doc-diag-list-input-line-count 0
-.
-.
-.\" NS doc-diag-list macro
-.\" NS   .It item of list-type diagnostic-message
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-diag-list-input-line-count
-.
-.de doc-diag-list
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  ie ((\n.c - \ndoc-diag-list-input-line-count) > 1) \{\
-.    ie !\ndoc-compact-list-stack\ndoc-list-depth \
-.      doc-paragraph
-.    el \
-.      br
-.  \}
-.  el \
-.    br
-.  nr doc-diag-list-input-line-count \n.c
-.
-.  nh
-.  nop \*doc-Sy-font\c
-.  if \ndoc-num-args \
-.    doc-remaining-args
-.  nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\*doc-hard-space\c
-.
-.  doc-print-and-reset
-..
-.
-.
-.\" NS doc-tag-list macro
-.\" NS   .It item of list-type 'tag'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-have-space
-.\" NS   doc-in-list
-.\" NS
-.\" NS local variables:
-.\" NS   doc-box-dtl
-.\" NS   doc-reg-dtl
-.\" NS   doc-reg-dtl1
-.
-.de doc-tag-list
-.  \" finish item box
-.  br
-.  ev
-.  box
-.  unformat doc-item-box\ndoc-list-depth
-.
-.  \" we use a box without '.nf' to compute the tag width (via 'dl' register)
-.  box doc-box-dtl
-.  ev doc-env-dtl
-.  evc 0
-.  fi
-.  ad 0
-.  in 0
-.  doc-item-box\ndoc-list-depth
-.  br
-.  ev
-.  box
-.
-.  doc-set-vertical-and-indent 1
-.  nr doc-reg-dtl (\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
-.  ti -\ndoc-reg-dtlu
-.
-.  nh
-.  doc-item-box\ndoc-list-depth
-.  ie (\ndlu > \ndoc-list-indent-stack\ndoc-list-depthu) \
-.    br
-.  el \{\
-.    \" format the tag separately to prevent stretching of spaces
-.    vpt 0
-.    br
-.    sp -1
-.    vpt 1
-.    nop \&\c
-.    nr doc-have-space 1
-.  \}
-.
-.  if \ndoc-in-files-section \
-.    if n \
-.      ds doc-Pa-font "\*doc-saved-Pa-font
-.
-.  nr doc-in-list 0
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-set-vertical-and-indent macro
-.\" NS   set up vertical spacing (if not compact) and indentation (with
-.\" NS   offset if argument is non-zero)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-list-have-indent-stackXXX
-.
-.de doc-set-vertical-and-indent
-.  if !\ndoc-compact-list-stack\ndoc-list-depth \
-.    sp \ndoc-display-verticalu
-.
-.  if \ndoc-list-have-indent-stack\ndoc-list-depth \{\
-.    nr doc-list-have-indent-stack\ndoc-list-depth 0
-.    if \$1 \
-.      in +(\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
-.  \}
-.
-.  if !\ncR \
-.    ne 2v
-..
-.
-.
-.\" NS doc-list-depth global register
-.\" NS   list type stack counter
-.
-.nr doc-list-depth 0
-.
-.
-.\" NS doc-num-columns global register
-.\" NS   number of columns
-.
-.nr doc-num-columns 0
-.
-.
-.\" NS doc-compact-list-stackXXX global register (bool)
-.\" NS   stack of flags to indicate whether a particular list is compact
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.nr doc-compact-list-stack1 0
-.
-.
-.\" NS doc-tag-prefix-stackXXX global string
-.\" NS   stack of tag prefixes (currently used for -nested -enum lists)
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.ds doc-tag-prefix-stack1
-.
-.
-.\" NS doc-list-offset-stackXXX global register
-.\" NS   stack of list offsets
-.\" NS
-.\" NS limit:
-.\" NS   doc-list-depth
-.
-.nr doc-list-offset-stack1 0
-.
-.
-.\" NS doc-end-list macro
-.\" NS   list end function; resets indentation (and offset if argument
-.\" NS   is non-zero)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-list-depth
-.\" NS   doc-list-offset-stackXXX
-.
-.de doc-end-list
-.  if \$1 \
-'    in -(\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
-.
-'  in -\ndoc-list-offset-stack\ndoc-list-depthu
-.
-.  if (\ndoc-list-depth <= 0) \
-.    tm mdoc warning: extraneous .El call (#\n.c)
-.
-.  doc-decrement-list-stack
-.  nr doc-list-depth -1
-..
-.
-.
-.\" NS doc-increment-list-stack macro
-.\" NS   set up next block for list
-.\" NS
-.\" NS modifies:
-.\" NS   doc-compact-list-stackXXX
-.\" NS   doc-list-have-indent-stackXXX
-.\" NS   doc-list-indent-stackXXX
-.\" NS   doc-list-offset-stackXXX
-.\" NS   doc-list-type-stackXXX
-.\" NS   doc-tag-prefix-stackXXX
-.\" NS   doc-enum-list-count-stackXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dils
-.
-.de doc-increment-list-stack
-.  nr doc-reg-dils (\ndoc-list-depth + 1)
-.  nr doc-list-have-indent-stack\ndoc-reg-dils 0
-.  nr doc-list-indent-stack\ndoc-reg-dils 0
-.  nr doc-list-offset-stack\ndoc-reg-dils 0
-.  ds doc-tag-prefix-stack\ndoc-reg-dils
-.  ds doc-list-type-stack\ndoc-reg-dils
-.  nr doc-compact-list-stack\ndoc-reg-dils 0
-.  nr doc-enum-list-count-stack\ndoc-reg-dils 0
-..
-.
-.
-.\" NS doc-decrement-list-stack macro
-.\" NS   decrement stack
-.\" NS
-.\" NS modifies:
-.\" NS   doc-compact-list-stackXXX
-.\" NS   doc-list-have-indent-stackXXX
-.\" NS   doc-list-indent-stackXXX
-.\" NS   doc-list-offset-stackXXX
-.\" NS   doc-list-type-stackXXX
-.\" NS   doc-tag-prefix-stackXXX
-.\" NS   doc-enum-list-count-stackXXX
-.
-.de doc-decrement-list-stack
-.  ds doc-list-type-stack\ndoc-list-depth
-.  nr doc-list-have-indent-stack\ndoc-list-depth 0
-.  nr doc-list-indent-stack\ndoc-list-depth 0
-.  nr doc-list-offset-stack\ndoc-list-depth 0
-.  ds doc-tag-prefix-stack\ndoc-list-depth
-.  nr doc-compact-list-stack\ndoc-list-depth 0
-.  nr doc-enum-list-count-stack\ndoc-list-depth 0
-..
-.
-.
-.\" NS Xr user macro
-.\" NS   cross reference (for man pages only)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-Xr
-.\" NS
-.\" NS width register 'Xr' set in doc-common
-.
-.de Xr
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Xr
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      doc-Xr-usage
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    \" first argument must be a string
-.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      nr doc-curr-font \n.f
-.      nr doc-curr-size \n.ps
-.      ds doc-arg\ndoc-arg-ptr \*doc-Xr-font\*doc-arg\ndoc-arg-ptr\f\s0
-.
-.      if (\ndoc-arg-limit > \ndoc-arg-ptr) \{\
-.        nr doc-reg-Xr (\ndoc-arg-ptr + 1)
-.        \" modify second argument if it is a string and
-.        \" remove space in between
-.        if (\ndoc-type\ndoc-reg-Xr == 2) \{\
-.          ds doc-arg\ndoc-reg-Xr \*lp\*doc-arg\ndoc-reg-Xr\*rp
-.          ds doc-space\ndoc-arg-ptr
-.        \}
-.      \}
-.      doc-print-recursive
-.    \}
-.    el \
-.      doc-Xr-usage
-.  \}
-.  el \
-.    doc-Xr-usage
-..
-.
-.
-.\" NS doc-Xr-usage macro
-.
-.de doc-Xr-usage
-.  tm Usage: .Xr manpage_name section# ... (#\n.c)
-.  doc-reset-args
-..
-.
-.
-.\" NS Sx user macro
-.\" NS   cross section reference
-.\" NS
-.\" NS width register 'Sx' set in doc-common
-.
-.als Sx doc-generic-macro
-.ds doc-Sx-usage section_header
-.
-.
-.\" NS doc-end-column-list macro
-.\" NS   column-list end-list
-.\" NS
-.\" NS modifies:
-.\" NS   doc-list-depth
-.
-.de doc-end-column-list
-.  linetabs 0
-'  in -(\ndoc-list-offset-stack\ndoc-list-depthu + \ndoc-list-indent-stack\ndoc-list-depthu)
-.  ta T .5i
-.  fi
-.  doc-decrement-list-stack
-.  nr doc-list-depth -1
-..
-.
-.
-.\" NS doc-column-indent-width global register
-.\" NS   holds the indent width for a column list
-.
-.nr doc-column-indent-width 0
-.
-.
-.\" NS doc-set-column-tab macro
-.\" NS   establish tabs for list-type column: '.doc-set-column-tab num_cols'
-.\" NS
-.\" NS modifies:
-.\" NS   doc-column-indent-width
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dsct
-.\" NS   doc-str-dsct
-.\" NS   doc-str-dsct1
-.
-.de doc-set-column-tab
-.  ds doc-str-dsct
-.  nr doc-reg-dsct 1
-.  nr doc-column-indent-width 0
-.
-.  ie (\$1 < 5) \
-.    ds doc-str-dsct1 "    \"
-.  el \{\
-.    ie (\$1 == 5) \
-.      ds doc-str-dsct1 "   \"
-.    el \{\
-.      \" XXX: this is packed abnormally close -- intercolumn width
-.      \"      should be configurable
-.      ds doc-str-dsct1 " \"
-.  \}\}
-.
-.  while (\ndoc-reg-dsct <= \$1) \{\
-.    as doc-str-dsct " +\w&#x7;\*doc-arg\ndoc-reg-dsct\*doc-str-dsct1&#x7;u
-.    nr doc-column-indent-width +\w&#x7;\*doc-arg\ndoc-reg-dsct\*doc-str-dsct1&#x7;u
-.    nr doc-reg-dsct +1
-.  \}
-.
-.  ta \*doc-str-dsct
-'  in +\ndoc-column-indent-widthu
-..
-.
-.
-.\" NS doc-column-list macro
-.\" NS   column items
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-list-indent-stackXXX
-.\" NS   doc-spaceXXX
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dcl
-.
-.de doc-column-list
-.  if \ndoc-num-args \
-.    doc-parse-arg-vector
-.  nr doc-arg-ptr +1
-.
-.  if (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    tm Usage: .It column_string Ta column_string ...  (#\n.c)
-.    return
-.  \}
-.
-.  if "\*doc-arg\ndoc-arg-ptr"Ta" \{\
-.    nr doc-reg-dcl (\ndoc-arg-ptr - 1)
-.    ds doc-space\ndoc-reg-dcl
-.  \}
-.
-.  if !\ndoc-list-indent-stack\ndoc-list-depth \
-.    nr doc-list-indent-stack\ndoc-list-depth \ndoc-column-indent-widthu
-.  if !\n.u \{\
-.    fi
-.    in +\ndoc-column-indent-widthu
-.  \}
-.  ti -\ndoc-column-indent-widthu
-.
-.  doc-do-\ndoc-type\ndoc-arg-ptr
-..
-.
-.
-.\" NS Ta user macro
-.\" NS   append tab (\t)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS
-.\" NS width register 'Ta' set in doc-common
-.
-.de Ta
-.  ie \ndoc-arg-limit \{\
-.    nr doc-arg-ptr +1
-.    nop \*doc-tab\c
-.    ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \
-.      doc-do-\ndoc-type\ndoc-arg-ptr
-.    el \
-.      doc-reset-args
-.  \}
-.  el \{\
-.    tm1 "Usage: Ta must follow column entry: e.g.
-.    tm1 "         .It column_string Ta column_string ... (#\n.c)
-.  \}
-..
-.
-.
-.\" NS Dl user macro
-.\" NS   display (one line) literal
-.\" NS
-.\" NS   this function uses the 'Li' font
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Dl' set in doc-common
-.
-.de Dl
-.  ta T .5i
-.  in +\ndoc-display-indentu
-.
-.  ie \ndoc-arg-limit \{\
-.    tm Usage: .Dl not callable by other macros (#\n.c)
-.    doc-reset-args
-.  \}
-.  el \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Dl
-.      doc-parse-args \$@
-.      nr doc-arg-ptr 1
-.      nr doc-curr-font \n.f
-.      nr doc-curr-size \n.ps
-.      nop \*doc-Li-font\c
-.      doc-print-recursive
-.    \}
-.    el \
-.      tm Usage: .Dl argument ... (#\n.c)
-.  \}
-.
-.  in -\ndoc-display-indentu
-..
-.
-.
-.\" NS D1 user macro
-.\" NS   display (one line)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'D1' set in doc-common
-.
-.de D1
-.  ta T .5i
-.  in +\ndoc-display-indentu
-.
-.  ie \ndoc-arg-limit \{\
-.    tm Usage: .D1 not callable by other macros (#\n.c)
-.    doc-reset-args
-.  \}
-.  el \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name D1
-.      doc-parse-args \$@
-.      nr doc-arg-ptr 1
-.      doc-print-recursive
-.    \}
-.    el \
-.      tm Usage: .D1 argument ... (#\n.c)
-.  \}
-.
-.  in -\ndoc-display-indentu
-..
-.
-.
-.\" NS Vt user macro
-.\" NS   variable type (for forcing old style variable declarations);
-.\" NS   this is not done in the same manner as .Ot for fortrash --
-.\" NS   clean up later
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-have-decl
-.\" NS   doc-have-var
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Vt' set in doc-common
-.
-.de Vt
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Vt
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Vt variable_type ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  if (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    tm Usage: .Vt variable_type ... (#\n.c)
-.    doc-reset-args
-.    return
-.  \}
-.
-.  if \ndoc-in-synopsis-section \{\
-.    \" if a function declaration was the last thing given,
-.    \" want vertical space
-.    if \ndoc-have-decl \{\
-.      doc-paragraph
-.      nr doc-have-decl 0
-.    \}
-.
-.    \" if a subroutine was the last thing given, want vertical space
-.    if \ndoc-have-func \{\
-.      ie \ndoc-have-var \
-.        br
-.      el \
-.        doc-paragraph
-.    \}
-.
-.    nr doc-have-var 1
-.  \}
-.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  nop \*doc-Ft-font\c
-.  doc-print-recursive
-.
-.  if \ndoc-in-synopsis-section \{\
-.    ie \ndoc-have-old-func \
-.      nop \*doc-soft-space\c
-.    el \
-.      br
-.  \}
-..
-.
-.
-.\" NS doc-is-func global register (bool)
-.\" NS   set if subroutine (in synopsis only) (fortran only)
-.
-.nr doc-is-func 0
-.
-.
-.\" NS Ft user macro
-.\" NS   function type
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-have-decl
-.\" NS   doc-have-var
-.\" NS   doc-is-func
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Ft' set in doc-common
-.
-.de Ft
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Ft
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Ft function_type ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  nr doc-arg-ptr +1
-.  if (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    tm Usage: .Ft function_type ... (#\n.c)
-.    doc-reset-args
-.    return
-.  \}
-.
-.  if \ndoc-in-synopsis-section \{\
-.    if (\ndoc-have-func : \ndoc-have-decl) \{\
-.      doc-paragraph
-.      nr doc-have-decl 0
-.      nr doc-have-var 0
-.    \}
-.
-.    if \ndoc-have-var \{\
-.      doc-paragraph
-.      nr doc-have-var 0
-.    \}
-.
-.    nr doc-is-func 1
-.  \}
-.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  nop \*doc-Ft-font\c
-.  doc-print-recursive
-..
-.
-.
-.\" NS doc-have-old-func global register (bool)
-.\" NS   set if 'Ot' has been called
-.
-.nr doc-have-old-func 0
-.
-.
-.\" NS Ot user macro
-.\" NS   old function type (fortran -- no newline)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-have-decl
-.\" NS   doc-have-old-func
-.\" NS   doc-have-var
-.\" NS   doc-is-func
-.\" NS
-.\" NS width register 'Ot' set in doc-common
-.
-.de Ot
-.  nr doc-have-old-func 1
-.
-.  if \ndoc-in-synopsis-section \{\
-.    if (\ndoc-have-func : \ndoc-have-decl) \{\
-.      doc-paragraph
-.      nr doc-have-decl 0
-.      nr doc-have-var 0
-.    \}
-.
-.    if \ndoc-have-var \{\
-.      doc-paragraph
-.      nr doc-have-var 0
-.    \}
-.
-.    nr doc-is-func 1
-.  \}
-.
-.  if \n.$ \
-.    nop \*doc-Ft-font\$*\c
-.  nop \ \f\c
-..
-.
-.
-.\" NS Fa user macro
-.\" NS   function arguments
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Fa' set in doc-common
-.
-.de Fa
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Fa
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Fa function_arguments ... (#\n.c)
-.  \}
-.
-.  ie \ndoc-func-arg-count \
-.    doc-do-func
-.  el \{\
-.    nr doc-arg-ptr +1
-.    if (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.      nr doc-curr-font \n.f
-.      nr doc-curr-size \n.ps
-.      nop \*doc-Fa-font\c
-.      doc-print-recursive
-.
-.      if \ndoc-in-synopsis-section \
-.        if \ndoc-have-func \
-.          br
-.  \}\}
-..
-.
-.
-.\" NS doc-func-arg-count global register
-.\" NS   how many function arguments have been processed so far
-.
-.nr doc-func-arg-count 0
-.
-.
-.\" NS doc-func-arg global string
-.\" NS   work buffer for function name strings
-.
-.ds doc-func-arg
-.
-.
-.\" NS doc-num-func-args global register
-.\" NS   number of function arguments
-.
-.nr doc-num-func-args 0
-.
-.
-.\" NS doc-func-args-processed global register
-.\" NS   function arguments processed so far
-.
-.nr doc-func-args-processed 0
-.
-.
-.\" NS doc-do-func macro
-.\" NS   internal .Fa for .Fc
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-func-arg
-.\" NS   doc-func-arg-count
-.\" NS   doc-func-args-processed
-.\" NS   doc-num-func-args
-.
-.de doc-do-func
-.  if (\ndoc-arg-limit <= \ndoc-arg-ptr) \{\
-.    doc-reset-args
-.    return
-.  \}
-.
-.  nr doc-arg-ptr +1
-.
-.  ds doc-func-arg
-.  nr doc-num-func-args 0
-.  nr doc-func-args-processed 0
-.
-.  doc-build-func-string \*doc-arg\ndoc-arg-ptr
-.  if (\ndoc-num-func-args > 1) \
-.    ds doc-arg\ndoc-arg-ptr "\*doc-func-arg
-.
-.  if (\ndoc-func-arg-count > 1) \{\
-.    nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\|\c
-.    if !"\*doc-arg\ndoc-arg-ptr"/*" \
-.      if !"\*doc-arg\ndoc-arg-ptr"*/" \
-.        nop ,\)\c
-.    nop \)\*doc-space\ndoc-arg-ptr\*doc-Fa-font\c
-.    nop \)\*doc-arg\ndoc-arg-ptr\f\s0\c
-.  \}
-.
-.  if (\ndoc-func-arg-count == 1) \{\
-.    nop \)\*doc-Fa-font\*doc-arg\ndoc-arg-ptr\c
-.    nop \f\s0\c
-.  \}
-.  nr doc-func-arg-count +1
-.  doc-do-func
-..
-.
-.
-.\" NS doc-have-func global register (bool)
-.\" NS   whether we have more than one function in synopsis
-.
-.nr doc-have-func 0
-.
-.
-.\" NS Fn user macro
-.\" NS   functions
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-have-decl
-.\" NS   doc-have-func
-.\" NS   doc-have-var
-.\" NS   doc-indent-synopsis
-.\" NS   doc-is-func
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Fn' set in doc-common
-.
-.de Fn
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Fn
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Fn function_name function_arg ... (#\n.c)
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  if \ndoc-in-synopsis-section \{\
-.    \" if there is/has been more than one subroutine declaration
-.    ie \ndoc-is-func \{\
-.      br
-.      nr doc-have-var 0
-.      nr doc-have-decl 0
-.      nr doc-is-func 0
-.    \}
-.    el \{\
-.      if \ndoc-have-func \{\
-.        doc-paragraph
-.        nr doc-have-var 0
-.        nr doc-have-decl 0
-.    \}\}
-.
-.    if \ndoc-have-decl \{\
-.      doc-paragraph
-.      nr doc-have-var 0
-.    \}
-.
-.    if \ndoc-have-var \{\
-.      doc-paragraph
-.      nr doc-have-decl 0
-.    \}
-.
-.    nr doc-have-func 1
-.    nr doc-is-func 0
-.
-.    br
-.    if !\ndoc-indent-synopsis \
-.      nr doc-indent-synopsis (4u * \ndoc-fixed-widthu)
-.    if !\ndoc-indent-synopsis-active \
-.      in +\ndoc-indent-synopsisu
-.    ti -\ndoc-indent-synopsisu
-.  \}
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  if (\ndoc-arg-limit < \ndoc-arg-ptr) \{\
-.    tm Usage: .Fn function_name function_arg ... (#\n.c)
-.    doc-reset-args
-.    return
-.  \}
-.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  nop \*doc-Fn-font\*doc-arg\ndoc-arg-ptr\c
-.  nop \f\s0\*lp\)\c
-.
-.  nr doc-arg-ptr +1
-.  if (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    if (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      nop \*doc-Fa-font\c
-.      doc-do-func-args
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.  \}\}
-.
-.  nop \)\*rp\)\c
-.  if \ndoc-in-synopsis-section \
-.    nop \);\)\c
-.
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    \" output the space (if needed)
-.    nr doc-arg-ptr -1
-.    nop \)\*doc-space\ndoc-arg-ptr\c
-.    nr doc-arg-ptr +1
-.
-.    doc-print-recursive
-.  \}
-.  el \
-.    doc-print-and-reset
-.
-.  if \ndoc-in-synopsis-section \
-.    if !\ndoc-indent-synopsis-active \
-.      in -\ndoc-indent-synopsisu
-..
-.
-.
-.\" NS doc-do-func-args macro
-.\" NS   handle function arguments
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-argXXX
-.\" NS   doc-func-arg
-.\" NS   doc-func-args-processed
-.\" NS   doc-num-func-args
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-ddfa
-.
-.de doc-do-func-args
-.  if \ndoc-in-synopsis-section \{\
-.    ds doc-func-arg
-.    nr doc-num-func-args 0
-.    nr doc-func-args-processed 0
-.
-.    doc-build-func-string \*doc-arg\ndoc-arg-ptr
-.    if (\ndoc-num-func-args > 1) \
-.      ds doc-arg\ndoc-arg-ptr "\*doc-func-arg
-.  \}
-.
-.  nop \)\*doc-arg\ndoc-arg-ptr\c
-.  nr doc-arg-ptr +1
-.
-.  if (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    if (\ndoc-type\ndoc-arg-ptr == 2) \{\
-.      nr doc-reg-ddfa (\ndoc-arg-ptr - 1)
-.      nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\|\c
-.      if !"\*doc-arg\ndoc-arg-ptr"/*" \
-.        if !"\*doc-arg\ndoc-arg-ptr"*/" \
-.          nop ,\)\c
-.      nop \)\*doc-space\ndoc-reg-ddfa\f\s0\|\c
-.      doc-do-func-args
-.  \}\}
-..
-.
-.
-.\" NS doc-saved-nesting-level global register
-.
-.nr doc-saved-nesting-level 0
-.
-.
-.\" NS doc-in-func-enclosure global register (bool)
-.
-.nr doc-in-func-enclosure 0
-.
-.
-.\" NS Fo user macro
-.\" NS   function open
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-func-arg-count
-.\" NS   doc-have-decl
-.\" NS   doc-have-func
-.\" NS   doc-have-var
-.\" NS   doc-in-func-enclosure
-.\" NS   doc-indent-synopsis
-.\" NS   doc-is-func
-.\" NS   doc-macro-name
-.\" NS   doc-saved-nesting-level
-.\" NS
-.\" NS width register 'Fo' set in doc-common
-.
-.de Fo
-.  if (\ndoc-in-func-enclosure) \{\
-.    tm mdoc error: .Fo/.Fc can't be nested (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-saved-nesting-level \ndoc-nesting-level
-.  nr doc-in-func-enclosure 1
-.
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ds doc-macro-name Fo
-.      doc-parse-args \$@
-.    \}
-.    el \
-.      tm Usage: .Fo function_name (#\n.c)
-.  \}
-.
-.  if \ndoc-in-synopsis-section \{\
-.    \" if there is/has been more than one subroutine declaration
-.    ie \ndoc-is-func \{\
-.      br
-.      nr doc-have-var 0
-.      nr doc-have-decl 0
-.      nr doc-is-func 0
-.    \}
-.    el \{\
-.      if \ndoc-have-func \{\
-.        doc-paragraph
-.        nr doc-have-var 0
-.        nr doc-have-decl 0
-.    \}\}
-.
-.    if \ndoc-have-decl \{\
-.      doc-paragraph
-.      nr doc-have-var 0
-.    \}
-.
-.    if \ndoc-have-var \{\
-.      doc-paragraph
-.      nr doc-have-decl 0
-.    \}
-.
-.    nr doc-have-func 1
-.    nr doc-is-func 0
-.
-.    br
-.    if !\ndoc-indent-synopsis \
-.      nr doc-indent-synopsis (4u * \ndoc-fixed-widthu)
-.  \}
-.
-.  \" start function box
-.  box doc-func-box
-.  ev doc-func-env
-.  evc 0
-.  in 0
-.  nf
-.
-.  nr doc-arg-ptr +1
-.  doc-print-prefixes
-.  if (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-func-arg-count 1
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.
-.    nop \*doc-Fn-font\*doc-arg\ndoc-arg-ptr\c
-.    nop \f\s0\*lp\)\c
-.    doc-reset-args
-.  \}
-..
-.
-.
-.\" NS Fc user macro
-.\" NS   function close
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-func-arg-count
-.\" NS   doc-in-func-enclosure
-.\" NS   doc-saved-nesting-level
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'Fc' set in doc-common
-.
-.de Fc
-.  if !\ndoc-in-func-enclosure \{\
-.    tm mdoc warning: Extraneous .Fc (#\n.c)
-.    return
-.  \}
-.
-.  if \n.$ \{\
-.    ds doc-macro-name Fc
-.    \" the first (dummy) argument is used to get the correct spacing
-.    doc-parse-args \) \$@
-.  \}
-.
-.  if !(\ndoc-saved-nesting-level == \ndoc-nesting-level) \
-.    tm mdoc warning: Unbalanced enclosure commands within .Fo/.Fc
-.
-.  nr doc-func-arg-count 0
-.  nr doc-in-func-enclosure 0
-.
-.  ie \ndoc-in-synopsis-section \
-.    nop \|\*rp;\)
-.  el \
-.    nop \|\*rp\)
-.
-.  \" finish function box
-.  br
-.  ev
-.  box
-.  chop doc-func-box
-.  unformat doc-func-box
-.
-.  if \ndoc-in-synopsis-section \{\
-.    if !\ndoc-indent-synopsis-active \
-.      in +\ndoc-indent-synopsisu
-.    ti -\ndoc-indent-synopsisu
-.  \}
-.
-.  nh
-.  nop \*doc-func-box\c
-.
-.  nr doc-arg-ptr +1
-.  ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    doc-print-recursive
-.  \}
-.  el \
-.    doc-print-and-reset
-.
-.  if \ndoc-in-synopsis-section \
-.    if !\ndoc-indent-synopsis-active \
-.      in -\ndoc-indent-synopsisu
-..
-.
-.
-.\" NS doc-build-func-string macro
-.\" NS   collect function arguments and set hard spaces in between
-.\" NS
-.\" NS modifies:
-.\" NS   doc-func-arg
-.\" NS   doc-func-args-processed
-.\" NS   doc-num-func-args
-.
-.de doc-build-func-string
-.  if !\ndoc-num-func-args \{\
-.    nr doc-num-func-args \n.$
-.    nr doc-func-args-processed 0
-.    ds doc-func-arg
-.  \}
-.
-.  nr doc-func-args-processed +1
-.  as doc-func-arg "\$1
-.
-.  if (\ndoc-func-args-processed < \ndoc-num-func-args) \{\
-.    as doc-func-arg "\*doc-hard-space
-.
-.    shift
-.    doc-build-func-string \$@
-.  \}
-..
-.
-.
-.\" Very crude references: Stash all reference info into boxes, print
-.\" out reference on .Re macro and clean up.  Ordering very limited, no
-.\" fancy citations, but can do articles, journals, and books -- need to
-.\" add several missing options (like city etc).  Should be able to grab
-.\" a refer entry, massage it a wee bit (prefix a '.' to the %A-Z) and
-.\" not worry (ha!).
-.
-.
-.\" NS doc-is-reference global register (bool)
-.\" NS   set if in reference
-.
-.nr doc-is-reference 0
-.
-.
-.\" NS doc-reference-count global register
-.\" NS   reference element counter
-.
-.nr doc-reference-count 0
-.
-.
-.\" NS Rs user macro
-.\" NS   reference start
-.\" NS
-.\" NS modifies:
-.\" NS   doc-is-reference
-.\" NS   doc-reference-count
-.\" NS
-.\" NS width register 'Rs' set in doc-common
-.
-.de Rs
-.  ie \n.$ \
-.    tm Usage: .Rs (does not take arguments) (#\n.c)
-.  el \{\
-.    nr doc-is-reference 1
-.    doc-reset-reference
-.    if \ndoc-in-see-also-section \
-.      doc-paragraph
-.    nr doc-reference-count 0
-.  \}
-..
-.
-.
-.\" NS Re user macro
-.\" NS   reference end
-.\" NS
-.\" NS modifies:
-.\" NS   doc-is-reference
-.\" NS
-.\" NS width register 'Re' set in doc-common
-.
-.de Re
-.  ie \n.$ \
-.    tm Usage: .Re (does not take arguments) (#\n.c)
-.  el \{\
-.    if !\ndoc-is-reference \{\
-.      tm mdoc warning: Extraneous .Re (#\n.c)
-.      return
-.    \}
-.    doc-print-reference
-.    doc-reset-reference
-.    nr doc-is-reference 0
-.  \}
-..
-.
-.
-.\" NS doc-reset-reference macro
-.\" NS   reference cleanup
-.\" NS
-.\" NS modifies:
-.\" NS   doc-author-count
-.\" NS   doc-author-nameXXX
-.\" NS   doc-book-count
-.\" NS   doc-book-name
-.\" NS   doc-city-count
-.\" NS   doc-city-name
-.\" NS   doc-corporate-count
-.\" NS   doc-corporate-name
-.\" NS   doc-date
-.\" NS   doc-date-count
-.\" NS   doc-issue-count
-.\" NS   doc-issue-name
-.\" NS   doc-journal-count
-.\" NS   doc-journal-name
-.\" NS   doc-optional-count
-.\" NS   doc-optional-string
-.\" NS   doc-page-number-count
-.\" NS   doc-page-number-string
-.\" NS   doc-publisher-count
-.\" NS   doc-publisher-name
-.\" NS   doc-reference-count
-.\" NS   doc-reference-title-count
-.\" NS   doc-reference-title-name
-.\" NS   doc-reference-title-name-for-book
-.\" NS   doc-report-count
-.\" NS   doc-report-name
-.\" NS   doc-url-count
-.\" NS   doc-url-name
-.\" NS   doc-volume-count
-.\" NS   doc-volume-name
-.
-.de doc-reset-reference
-.  while (\ndoc-author-count) \{\
-.    ds doc-author-name\ndoc-author-count
-.    nr doc-author-count -1
-.  \}
-.  nr doc-journal-count 0
-.  nr doc-issue-count 0
-.  nr doc-optional-count 0
-.  nr doc-corporate-count 0
-.  nr doc-report-count 0
-.  nr doc-reference-title-count 0
-.  nr doc-url-count 0
-.  nr doc-volume-count 0
-.  nr doc-city-count 0
-.  nr doc-date-count 0
-.  nr doc-page-number-count 0
-.  nr doc-book-count 0
-.  nr doc-publisher-count 0
-.  nr doc-reference-count 0
-.
-.  ds doc-journal-name
-.  ds doc-issue-name
-.  ds doc-optional-string
-.  ds doc-corporate-name
-.  ds doc-report-name
-.  ds doc-reference-title-name
-.  ds doc-reference-title-name-for-book
-.  ds doc-url-name
-.  ds doc-volume-name
-.  ds doc-city-name
-.  ds doc-date
-.  ds doc-page-number-string
-.  ds doc-book-name
-.  ds doc-publisher-name
-..
-.
-.
-.\" NS doc-finish-reference macro
-.\" NS   auxiliary macro for doc-print-reference
-.\" NS
-.\" NS modifies:
-.\" NS   doc-reference-count
-.
-.de doc-finish-reference
-.  nr doc-reference-count -\$1
-.  ie \ndoc-reference-count \
-.    nop \),
-.  el \
-.    nop \).
-..
-.
-.
-.\" NS doc-print-reference macro
-.\" NS   reference print
-.\" NS
-.\" NS modifies:
-.\" NS   doc-reference-count
-.
-.de doc-print-reference
-.
-.  nh
-.
-.  if \ndoc-author-count \{\
-.    doc-print-reference-authors
-.    nr doc-reference-count -\ndoc-author-count
-.  \}
-.
-.  if \ndoc-reference-title-count \{\
-.    unformat doc-reference-title-name
-.    chop doc-reference-title-name
-.    unformat doc-reference-title-name-for-book
-.    chop doc-reference-title-name-for-book
-.    ie ((\ndoc-journal-count == 1) : (\ndoc-book-count == 1)) \{\
-.      nop \)\*Lq\)\*doc-reference-title-name-for-book\)\*Rq\c
-.      doc-finish-reference \ndoc-reference-title-count
-.    \}
-.    el \{\
-.      nop \*doc-reference-title-name\c
-.      doc-finish-reference \ndoc-reference-title-count
-.  \}\}
-.
-.  if \ndoc-book-count \{\
-.    unformat doc-book-name
-.    chop doc-book-name
-.    nop \*doc-book-name\c
-.    doc-finish-reference \ndoc-book-count
-.  \}
-.
-.  if \ndoc-publisher-count \{\
-.    unformat doc-publisher-name
-.    chop doc-publisher-name
-.    nop \*doc-publisher-name\c
-.    doc-finish-reference \ndoc-publisher-count
-.  \}
-.
-.  if \ndoc-journal-count \{\
-.    unformat doc-journal-name
-.    chop doc-journal-name
-.    nop \*doc-journal-name\c
-.    doc-finish-reference \ndoc-journal-count
-.  \}
-.
-.  if \ndoc-report-count \{\
-.    unformat doc-report-name
-.    chop doc-report-name
-.    nop \*doc-report-name\c
-.    doc-finish-reference \ndoc-report-count
-.  \}
-.
-.  if \ndoc-issue-count \{\
-.    unformat doc-issue-name
-.    chop doc-issue-name
-.    nop \*doc-issue-name\c
-.    doc-finish-reference \ndoc-issue-count
-.  \}
-.
-.  if \ndoc-volume-count \{\
-.    unformat doc-volume-name
-.    chop doc-volume-name
-.    nop \*doc-volume-name\c
-.    doc-finish-reference \ndoc-volume-count
-.  \}
-.
-.  if \ndoc-url-count \{\
-.    unformat doc-url-name
-.    chop doc-url-name
-.    nop \*doc-url-name\c
-.    doc-finish-reference \ndoc-url-count
-.  \}
-.
-.  if \ndoc-page-number-count \{\
-.    unformat doc-page-number-string
-.    chop doc-page-number-string
-.    nop \*doc-page-number-string\c
-.    doc-finish-reference \ndoc-page-number-count
-.  \}
-.
-.  if \ndoc-corporate-count \{\
-.    unformat doc-corporate-name
-.    chop doc-corporate-name
-.    nop \*doc-corporate-name\c
-.    doc-finish-reference \ndoc-corporate-count
-.  \}
-.
-.  if \ndoc-city-count \{\
-.    unformat doc-city-name
-.    chop doc-city-name
-.    nop \*doc-city-name\c
-.    doc-finish-reference \ndoc-city-count
-.  \}
-.
-.  if \ndoc-date-count \{\
-.    unformat doc-date
-.    chop doc-date
-.    nop \*doc-date\c
-.    doc-finish-reference \ndoc-date-count
-.  \}
-.
-.  if \ndoc-optional-count \{\
-.    unformat doc-optional-string
-.    chop doc-optional-string
-.    nop \*doc-optional-string\c
-.    doc-finish-reference \ndoc-optional-count
-.  \}
-.
-.  if \ndoc-reference-count \
-.    tm mdoc warning: unresolved reference problem
-.
-.  hy \ndoc-hyphen-flags
-..
-.
-.
-.\" NS doc-print-reference-authors macro
-.\" NS   print out reference authors
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-dpra
-.\" NS   doc-str-dpra
-.
-.ds doc-str-dpra "and
-.
-.de doc-print-reference-authors
-.  nr doc-reg-dpra 1
-.
-.  while (\ndoc-reg-dpra < \ndoc-author-count) \{\
-.    unformat doc-author-name\ndoc-reg-dpra
-.    chop doc-author-name\ndoc-reg-dpra
-.    ie (\ndoc-author-count > 2) \
-.      nop \)\*doc-author-name\ndoc-reg-dpra,
-.    el \
-.      nop \)\*doc-author-name\ndoc-reg-dpra
-.    nr doc-reg-dpra +1
-.  \}
-.
-.  unformat doc-author-name\ndoc-reg-dpra
-.  chop doc-author-name\ndoc-reg-dpra
-.  if (\ndoc-author-count > 1) \
-.    nop \)\*doc-str-dpra
-.  nop \)\*doc-author-name\ndoc-reg-dpra,
-..
-.
-.
-.\" NS doc-author-count global register
-.\" NS   counter of author references
-.
-.nr doc-author-count 0
-.
-.
-.\" NS doc-author-nameXXX global box
-.\" NS   array of author names
-.\" NS
-.\" NS limit:
-.\" NS   doc-author-count
-.
-.ds doc-author-name0
-.
-.
-.\" NS %A user macro
-.\" NS   reference author(s)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-author-count
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%A
-.\" NS
-.\" NS width register '%A' set in doc-common
-.
-.de %A
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%A author_name ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-author-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %A
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" save to reference box
-.  box doc-author-name\ndoc-author-count
-.  ev doc-env-%A
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-book-count global register
-.\" NS   counter of book references
-.
-.nr doc-book-count 0
-.
-.
-.\" NS doc-book-name global box
-.\" NS   string of collected book references
-.
-.ds doc-book-name
-.
-.
-.\" NS %B user macro
-.\" NS   reference book name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-book-count
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%B
-.\" NS
-.\" NS width register '%B' set in doc-common
-.
-.de %B
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%B book_name ... (#\n.c)
-.    return
-.  \}
-.
-.  if \ndoc-is-reference \{\
-.    nr doc-book-count +1
-.    nr doc-reference-count +1
-.  \}
-.
-.  ds doc-macro-name %B
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  ie \ndoc-is-reference \{\
-.    \" append to reference box
-.    boxa doc-book-name
-.    ev doc-env-%B
-.    evc 0
-.    in 0
-.    nf
-.    nop \*doc-Em-font\c
-.    doc-do-references
-.  \}
-.  el \{\
-.    nop \*doc-Em-font\c
-.    doc-print-recursive
-.  \}
-..
-.
-.
-.\" NS doc-city-count global register
-.\" NS   counter of city references
-.
-.nr doc-city-count 0
-.
-.
-.\" NS doc-city-name global box
-.\" NS   string of collected city references
-.
-.ds doc-city-name
-.
-.
-.\" NS %C user macro
-.\" NS   reference city
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-city-count
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%C
-.\" NS
-.\" NS width register '%C' set in doc-common
-.
-.de %C
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%C city_name ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-city-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %C
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-city-name
-.  ev doc-env-%C
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-date-count global register
-.\" NS   counter of date references
-.
-.nr doc-date-count 0
-.
-.
-.\" NS doc-date global box
-.\" NS   string of collected date references
-.
-.ds doc-date
-.
-.
-.\" NS %D user macro
-.\" NS   reference date
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-date-count
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%D
-.\" NS
-.\" NS width register '%D' set in doc-common
-.
-.de %D
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%D date ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-date-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %D
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-date
-.  ev doc-env-%D
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-publisher-count global register
-.\" NS   counter of publisher references
-.
-.nr doc-publisher-count 0
-.
-.
-.\" NS doc-publisher-name global box
-.\" NS   string of collected publisher references
-.
-.ds doc-publisher-name
-.
-.
-.\" NS %I user macro
-.\" NS   reference issuer/publisher name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-publisher-count
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%I
-.\" NS
-.\" NS width register '%I' set in doc-common
-.
-.de %I
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%I issuer/publisher_name ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-publisher-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %I
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-publisher-name
-.  ev doc-env-%I
-.  evc 0
-.  in 0
-.  nf
-.  nop \*doc-Em-font\c
-.  doc-do-references
-..
-.
-.
-.\" NS doc-journal-count global register
-.\" NS   counter of journal references
-.
-.nr doc-journal-count 0
-.
-.
-.\" NS doc-journal-name global box
-.\" NS   string of collected journal references
-.
-.ds doc-journal-name
-.
-.
-.\" NS %J user macro
-.\" NS   reference Journal Name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-journal-count
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%J
-.\" NS
-.\" NS width register '%J' set in doc-common
-.
-.de %J
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%J journal_name ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-journal-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %J
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-journal-name
-.  ev doc-env-%J
-.  evc 0
-.  in 0
-.  nf
-.  nop \*doc-Em-font\c
-.  doc-do-references
-..
-.
-.
-.\" NS doc-issue-count global register
-.\" NS   counter of issue number references
-.
-.nr doc-issue-count 0
-.
-.
-.\" NS doc-issue-name global box
-.\" NS   string of collected issue number references
-.
-.ds doc-issue-name
-.
-.
-.\" NS %N user macro
-.\" NS   reference issue number
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-issue-count
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%N
-.\" NS
-.\" NS width register '%N' set in doc-common
-.
-.de %N
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%N issue_number ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-issue-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %N
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-issue-name
-.  ev doc-env-%N
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-optional-count global register
-.\" NS   counter of optional information references
-.
-.nr doc-optional-count 0
-.
-.
-.\" NS doc-optional-string global box
-.\" NS   string of collected optional information references
-.
-.ds doc-optional-string
-.
-.
-.\" NS %O user macro
-.\" NS   reference optional information
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-optional-count
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%O
-.\" NS
-.\" NS width register '%O' set in doc-common
-.
-.de %O
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%O optional_information ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-optional-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %O
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-optional-string
-.  ev doc-env-%O
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-page-number-count global register
-.\" NS   counter of page number references
-.
-.nr doc-page-number-count 0
-.
-.
-.\" NS doc-page-number-string global box
-.\" NS   string of collected page number references
-.
-.ds doc-page-number-string
-.
-.
-.\" NS %P user macro
-.\" NS   reference page numbers
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-page-number-count
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%P
-.\" NS
-.\" NS width register '%P' set in doc-common
-.
-.de %P
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%P page_number ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-page-number-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %P
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-page-number-string
-.  ev doc-env-%P
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-corporate-count global register
-.\" NS   counter of corporate references
-.
-.nr doc-corporate-count 0
-.
-.
-.\" NS doc-corporate-name global box
-.\" NS   string of collected corporate references
-.
-.ds doc-corporate-name
-.
-.
-.\" NS %Q user macro
-.\" NS   corporate or foreign author
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-corporate-count
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%Q
-.\" NS
-.\" NS width register '%Q' set in doc-common
-.
-.de %Q
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%Q corporate_or_foreign_author ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-corporate-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %Q
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-corporate-name
-.  ev doc-env-%Q
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-report-count global register
-.\" NS   counter of report references
-.
-.nr doc-report-count 0
-.
-.
-.\" NS doc-report-name global box
-.\" NS   string of collected report references
-.
-.ds doc-report-name
-.
-.
-.\" NS %R user macro
-.\" NS   reference report name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS   doc-report-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%R
-.\" NS
-.\" NS width register '%R' set in doc-common
-.
-.de %R
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%R reference_report ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-report-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %R
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-report-name
-.  ev doc-env-%R
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-reference-title-count global register
-.\" NS   counter of reference title references
-.
-.nr doc-reference-title-count 0
-.
-.
-.\" NS doc-reference-title-name global box
-.\" NS   string of collected reference title references
-.
-.ds doc-reference-title-name
-.
-.
-.\" NS doc-reference-title-name-for-book global box
-.\" NS   string of collected reference title references
-.\" NS   (saved with another font; this is a shortcoming of groff)
-.
-.ds doc-reference-title-name-for-book
-.
-.
-.\" NS %T user macro
-.\" NS   reference title
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-title-count
-.\" NS   doc-report-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%T
-.\" NS
-.\" NS width register '%T' set in doc-common
-.
-.de %T
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%T reference_title ... (#\n.c)
-.    return
-.  \}
-.
-.  if \ndoc-is-reference \{\
-.    nr doc-reference-title-count +1
-.    nr doc-reference-count +1
-.  \}
-.
-.  ds doc-macro-name %T
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  ie \ndoc-is-reference \{\
-.    \" append to reference box
-.    boxa doc-reference-title-name-for-book
-.    ev doc-env-%T
-.    evc 0
-.    in 0
-.    nf
-.    nop \*doc-No-font\c
-.    doc-do-references
-.
-.    \" do it a second time with another font
-.    ds doc-macro-name %T
-.    doc-parse-args \$@
-.
-.    nr doc-arg-ptr +1
-.    nr doc-curr-font \n.f
-.    nr doc-curr-size \n.ps
-.    boxa doc-reference-title-name
-.    ev doc-env-%T
-.    evc 0
-.    in 0
-.    nf
-.    nop \*doc-Em-font\c
-.    doc-do-references
-.  \}
-.  el \{\
-.    nop \*doc-Em-font\c
-.    doc-print-recursive
-.  \}
-..
-.
-.
-.\" NS doc-url-count global register
-.\" NS   counter of hypertext references
-.
-.nr doc-url-count 0
-.
-.
-.\" NS doc-url-name global box
-.\" NS   string of collected hypertext references
-.
-.ds doc-url-name
-.
-.
-.\" NS doc-volume-count global register
-.\" NS   counter of reference title references
-.
-.nr doc-volume-count 0
-.
-.
-.\" NS doc-volume-name global box
-.\" NS   string of collected volume references
-.
-.ds doc-volume-name
-.
-.
-.\" NS %U user macro
-.\" NS   hypertext reference
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS   doc-url-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%U
-.\" NS
-.\" NS width register '%U' set in doc-common
-.
-.de %U
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%U URL ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-url-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %U
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-url-name
-.  ev doc-env-%U
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS %V user macro
-.\" NS   reference volume
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS   doc-reference-count
-.\" NS   doc-volume-count
-.\" NS
-.\" NS local variables:
-.\" NS   doc-env-%V
-.\" NS
-.\" NS width register '%V' set in doc-common
-.
-.de %V
-.  if (\ndoc-arg-limit : (\n.$ == 0)) \{\
-.    tm Usage: .%V volume ... (#\n.c)
-.    return
-.  \}
-.
-.  nr doc-volume-count +1
-.  nr doc-reference-count +1
-.
-.  ds doc-macro-name %V
-.  doc-parse-args \$@
-.
-.  nr doc-arg-ptr +1
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.
-.  \" append to reference box
-.  boxa doc-volume-name
-.  ev doc-env-%V
-.  evc 0
-.  in 0
-.  nf
-.  doc-do-references
-..
-.
-.
-.\" NS doc-do-references macro
-.\" NS   reference recursion routine
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS
-.\" NS local variables:
-.\" NS   doc-reg-ddr
-.\" NS   doc-reg-ddr1
-.
-.de doc-do-references
-.  if !\ndoc-is-reference \
-.    tm mdoc error: .\*doc-macro-name found outside of .Rs ... .Re (#\n.c)
-.
-.  nr doc-reg-ddr1 \ndoc-type\ndoc-arg-ptr
-.
-.  ie (\ndoc-reg-ddr1 == 1) \{\
-.    \" .nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.    doc-append-arg \c 3
-.    \*doc-arg\ndoc-arg-ptr
-.  \}
-.  el \{\
-.    nop \)\*doc-arg\ndoc-arg-ptr\c
-.
-.    ie (\ndoc-arg-limit == \ndoc-arg-ptr) \{\
-.      \" finish reference box
-.      br
-.      ev
-.      boxa
-.
-.      doc-reset-args
-.    \}
-.    el \{\
-.      nr doc-reg-ddr \ndoc-arg-ptr
-.      nr doc-arg-ptr +1
-.      nop \)\*doc-space\ndoc-reg-ddr\c
-.      doc-do-references
-.  \}\}
-..
-.
-.
-.\" NS Hf user macro
-.\" NS   source include header files.
-.\" NS
-.\" NS modifies:
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS
-.\" NS width register 'Hf' set in doc-common
-.
-.de Hf
-.  ie ((\n.$ == 1) & (\ndoc-arg-limit == 0)) \{\
-.    doc-paragraph
-.    nop File:
-.    Pa \$1
-.
-.    Bd -literal
-.    so \$1
-.    Ed
-.
-.    doc-paragraph
-.  \}
-.  el \
-.    Usage: .Hf file (#\n.c)
-..
-.
-.
-.\" NS doc-have-author global register (bool)
-.\" NS   set in 'An'
-.
-.nr doc-have-author 0
-.
-.
-.\" NS An user macro
-.\" NS   author name
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-have-author
-.\" NS   doc-macro-name
-.\" NS
-.\" NS width register 'An' set in doc-common
-.
-.de An
-.  if !\ndoc-arg-limit \{\
-.    ie \n.$ \{\
-.      ie        "\$1"-nosplit" \
-.        nr doc-in-authors-section 0
-.      el \{ .ie "\$1"-split" \
-.        nr doc-in-authors-section 1
-.      el \{\
-.        ds doc-macro-name An
-.        doc-parse-args \$@
-.    \}\}\}
-.    el \{\
-.      tm1 "Usage: .An {-nosplit | -split}
-.      tm1 "       .An author_name ... (#\n.c)
-.  \}\}
-.
-.  if \ndoc-in-authors-section \{\
-.    ie \ndoc-have-author \
-.      br
-.    el \
-.      nr doc-have-author 1
-.  \}
-.
-.  if \ndoc-arg-limit \{\
-.    nr doc-arg-ptr +1
-.    ie (\ndoc-arg-limit >= \ndoc-arg-ptr) \{\
-.      nr doc-curr-font \n.f
-.      nr doc-curr-size \n.ps
-.      doc-print-recursive
-.    \}
-.    el \{\
-.      tm Usage: .An author_name ... (#\n.c)
-.      doc-reset-args
-.  \}\}
-..
-.
-.
-.\" NS Rv user macro
-.\" NS   return values
-.\" NS
-.\" NS width register 'Rv' set in doc-common
-.\" NS
-.\" NS local variables:
-.\" NS   doc-str-Rv-std-prefix
-.\" NS   doc-str-Rv-std-suffix
-.\" NS   doc-str-Rv-stds-prefix
-.\" NS   doc-str-Rv-stds-and
-.\" NS   doc-str-Rv-stds-suffix
-.\" NS   doc-str-Rv-std0
-.
-.ds doc-str-Rv-std-prefix "The
-.ds doc-str-Rv-std-suffix "function returns the value\~0 if successful;
-.as doc-str-Rv-std-suffix " otherwise the value\~\-1 is returned and
-.as doc-str-Rv-std-suffix " the global variable \*doc-Va-fonterrno\f
-.as doc-str-Rv-std-suffix " is set to indicate the error.
-.
-.ds doc-str-Rv-stds-prefix "The
-.ds doc-str-Rv-stds-and    "and
-.ds doc-str-Rv-stds-suffix "functions return the value\~0 if successful;
-.as doc-str-Rv-stds-suffix " otherwise the value\~\-1 is returned and
-.as doc-str-Rv-stds-suffix " the global variable \*doc-Va-fonterrno\f
-.as doc-str-Rv-stds-suffix " is set to indicate the error.
-.
-.ds doc-str-Rv-std0 "Upon successful completion, the value\~0 is returned;
-.as doc-str-Rv-std0 " otherwise the value\~\-1 is returned and
-.as doc-str-Rv-std0 " the global variable \*doc-Va-fonterrno\f
-.as doc-str-Rv-std0 " is set to indicate the error.
-.
-.de Rv
-.
-.\" XXX: what does this function without '-std'?
-.
-.  if \ndoc-arg-limit \{\
-.    tm Usage: .Rv not callable by other macros (#\n.c)
-.    doc-reset-args
-.    return
-.  \}
-.
-.  if !\n.$ \{\
-.    tm Usage: .Rv -std <function> ... (#\n.c)
-.    return
-.  \}
-.
-.  if "\$1"-std" \{\
-.    nr doc-reg-Rv \*doc-section
-.    if ((\ndoc-reg-Rv < 2) : (\ndoc-reg-Rv > 3)) \
-.      tm Usage: .Rv -std in sections 2 and 3 only (#\n.c)
-.    br
-.    shift
-.    ie (\n.$ > 1) \{\
-.      nop \)\*doc-str-Rv-stds-prefix
-.      nr doc-reg-Rv 1
-.      while (\ndoc-reg-Rv < \n.$) \{\
-.        ie (\n.$ > 2) \
-.          Fn \$\ndoc-reg-Rv ,
-.        el \
-.          Fn \$\ndoc-reg-Rv
-.        nr doc-reg-Rv +1
-.      \}
-.      nop \)\*doc-str-Rv-stds-and
-.      Fn \$\n.$
-.      nop \)\*doc-str-Rv-stds-suffix
-.    \}
-.    el \{ .ie (\n.$ == 1) \{\
-.      nop \)\*doc-str-Rv-std-prefix
-.      Fn \$1
-.      nop \)\*doc-str-Rv-std-suffix
-.    \}
-.    el \{\
-.      nop \)\*doc-str-Rv-std0
-.  \}\}\}
-..
-.
-.
-.\" NS Ex user macro
-.\" NS   exit status
-.\" NS
-.\" NS width register 'Ex' set in doc-common
-.\" NS
-.\" NS local variables:
-.\" NS   doc-str-Ex-std-prefix
-.\" NS   doc-str-Ex-std-suffix
-.
-.ds doc-str-Ex-std-prefix "The
-.ds doc-str-Ex-std-suffix "utility exits\~0 on success,
-.as doc-str-Ex-std-suffix " and\~>0 if an error occurs.
-.
-.ds doc-str-Ex-stds-prefix "The
-.als doc-str-Ex-stds-and doc-str-Rv-stds-and
-.ds doc-str-Ex-stds-suffix "utilities exit\~0 on success,
-.as doc-str-Ex-stds-suffix " and\~>0 if an error occurs.
-.
-.de Ex
-.
-.\" XXX: what does this function without '-std'?
-.
-.  if \ndoc-arg-limit \{\
-.    tm Usage: .Ex not callable by other macros (#\n.c)
-.    doc-reset-args
-.    return
-.  \}
-.
-.  if !\n.$ \{\
-.    tm Usage: .Ex -std <utility> ... (#\n.c)
-.    return
-.  \}
-.
-.  if "\$1"-std" \{\
-.    nr doc-reg-Ex \*doc-section
-.    if !((\ndoc-reg-Ex == 1) : (\ndoc-reg-Ex == 6) : (\ndoc-reg-Ex == 8)) \
-.      tm Usage: .Ex -std in sections 1, 6 and 8 only (#\n.c)
-.    br
-.    shift
-.    ie (\n.$ > 1) \{\
-.      nop \)\*doc-str-Ex-stds-prefix
-.      nr doc-reg-Ex 1
-.      while (\ndoc-reg-Ex < \n.$) \{\
-.        ie (\n.$ > 2) \
-.          Nm \$\ndoc-reg-Ex ,
-.        el \
-.          Nm \$\ndoc-reg-Ex
-.        nr doc-reg-Ex +1
-.      \}
-.      nop \)\*doc-str-Ex-stds-and
-.      Nm \$\n.$
-.      nop \)\*doc-str-Ex-stds-suffix
-.    \}
-.    el \{\
-.      nop \)\*doc-str-Ex-std-prefix
-.      Nm \$1
-.      nop \)\*doc-str-Ex-std-suffix
-.  \}\}
-..
-.
-.
-.\" NS Mt user macro
-.\" NS   mailto (for conversion to HTML)
-.
-.de Mt
-.  \" XXX: error handling missing
-.  Pa \$@
-..
-.
-.
-.\" NS Lk user macro
-.\" NS   link (for conversion to HTML)
-.\" NS
-.\" NS modifies:
-.\" NS   doc-arg-ptr
-.\" NS   doc-curr-font
-.\" NS   doc-curr-size
-.\" NS   doc-macro-name
-.\" NS
-.\" NS local variables:
-.\" NS   doc-lasttext-Lk
-.\" NS   doc-target-Lk
-.
-.de Lk
-.  if !\ndoc-arg-limit \{\
-.    ds doc-macro-name Lk
-.    doc-parse-args \$@
-.  \}
-.
-.  if !\ndoc-arg-limit \
-.    return
-.
-.  \" The first argument is the target URI.
-.  nr doc-arg-ptr +1
-.  ds doc-target-Lk "\*doc-arg\ndoc-arg-ptr
-.  nr doc-arg-ptr +1
-.
-.  \" Search backwards for the first closing punctuation.
-.  nr doc-lasttext-Lk \ndoc-arg-limit
-.  while (\ndoc-lasttext-Lk >= \ndoc-arg-ptr) \{\
-.    if !(\ndoc-type\ndoc-lasttext-Lk == 3) \
-.      break
-.    nr doc-lasttext-Lk -1
-.  \}
-.
-.  \" Print the link text, if any.
-.  nr doc-curr-font \n.f
-.  nr doc-curr-size \n.ps
-.  if (\ndoc-arg-ptr <= \ndoc-lasttext-Lk) \{\
-.    nop \*doc-Em-font\c
-.    while (\ndoc-arg-ptr < \ndoc-lasttext-Lk) \{\
-.      nop \*doc-arg\ndoc-arg-ptr
-.      nr doc-arg-ptr +1
-.    \}
-.    nop \*doc-arg\ndoc-arg-ptr\f\ndoc-curr-font\s\ndoc-curr-sizeu:
-.    nr doc-arg-ptr +1
-.  \}
-.
-.  \" Print the link target.
-.  nop \*doc-Sy-font\*doc-target-Lk\c
-.  nop \f\ndoc-curr-font\s\ndoc-curr-sizeu\c
-.
-.  \" Print the delimiters, if any.
-.  while (\ndoc-arg-ptr <= \ndoc-arg-limit) \{\
-.    nop \*doc-arg\ndoc-arg-ptr\c
-.    nr doc-arg-ptr +1
-.  \}
-.  nop \&
-.  doc-reset-args
-..
-.
-.
-.\" NS doc-defunct-macro macro
-.\" NS   this is the skeleton for defunct macros
-.\" NS
-.
-.de doc-defunct-macro
-.  tmc mdoc error: .\$0 defunct
-.  if d doc-\$0-usage \
-.    tmc , \*doc-\$0-usage
-.  tm1 " (#\n.c)
-..
-.
-.
-.\" obsolete macros
-.
-.als Db doc-defunct-macro
-.
-.als Ds doc-defunct-macro
-.
-.als Or doc-defunct-macro
-.ds doc-Or-usage use '|'
-.
-.als Sf doc-defunct-macro
-.ds doc-Sf-usage use .Pf or .Ns
-.
-.
-.rn em e@
-.
-.de em
-.  tm1 "mdoc error: end-macro (.em) respecification is not allowed. (#\n.c)
-.  tm1 "            Should this have been '.Em ...'?
-.  ab
-..
-.
-.
-.\" NS doc-empty-line macro
-.\" NS   emit warning and print empty line
-.
-.de doc-empty-line
-.  if !\ndoc-display-depth \
-.    tm mdoc warning: Empty input line #\n.c
-.  sp
-..
-.
-.blm doc-empty-line
-.
-.
-.ec
-.
-.
-.\" For UTF-8, map some characters conservatively for the sake of easy
-.\" cut and paste.
-.
-.if '\*.T'utf8' \{\
-.  rchar \- - ' `
-.
-.  char \- \N'45'
-.  char  - \N'45'
-.  char  ' \N'39'
-.  char  ` \N'96'
-.\}
-.
-.
-.\" load local modifications
-.mso mdoc.local
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/e.tmac-u Deleted

@@ -1,2079 +0,0 @@
-.\"	@(#)e.tmac	2.31 (Berkeley) 5/21/88
-.\"	Modified by James Clark for use with groff.
-.\"
-.\" Copyright (c) 1988 Regents of the University of California.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that this notice is preserved and that due credit is given
-.\" to the University of California at Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.  This
-.\" software is provided "as is" without express or implied warranty.
-.\"
-.\"	%beginstrip%
-.\"
-.\"**************************************************************
-.\"*								*
-.\"*	****  - M E   N R O F F / T R O F F   M A C R O S  ****	*
-.\"*								*
-.\"*	Produced for your edification and enjoyment by:		*
-.\"*		Eric Allman					*
-.\"*		Electronics Research Laboratory			*
-.\"*		U.C. Berkeley.					*
-.\"*	current address:					*
-.\"*		Britton-Lee, Inc.				*
-.\"*		1919 Addison Street Suite 105			*
-.\"*		Berkeley, California  94704			*
-.\"*								*
-.\"*	VERSION 2.31	First Release: 11 Sept 1978		*
-.\"*								*
-.\"*	Documentation is available.				*
-.\"*								*
-.\"**************************************************************
-.\"
-.\"	Code on .de commands:
-.\"		***	a user interface macro.
-.\"		&&&	a user interface macro which is redefined
-.\"			when used to be the real thing.
-.\"		$$$	a macro which may be redefined by the user
-.\"			to provide variant functions.
-.\"		---	an internal macro.
-.\"
-.
-.do nr need_eo_h 0
-.do nr need_eo_tl 0
-.do nr need_tl 1
-.
-.do mso devtag.tmac
-.
-.if !\n(.g .ig
-.de @R		\" --- initialize number register to 0, if undefined
-.if !r\\$1 .nr \\$1 0
-..
-.
-.\" --- check whether grohtml needs end of title/heading
-.de @html_check_need_title
-.do if (\\nneed_eo_tl == 1) \
-\{\
-.	do nr need_eo_tl 0
-.	do DEVTAG-EO-TL
-.\}
-.do if (\\nneed_tl == 1) \
-\{\
-.	do DEVTAG-TL
-.	do nr need_tl 0
-.	do nr need_eo_tl 1
-.\}
-.do if \\nneed_eo_h>0 .do DEVTAG-EO-H
-.do nr need_eo_h 0
-..
-.
-.de @check_need_title
-..
-.
-.ie '\*(.T'html' \
-.	do als check_need_title @html_check_need_title
-.el \
-.	do als check_need_title @check_need_title
-.
-.@R pf
-.if \n(pf .nx
-.
-.if !\n(.g .ig
-.de @S		\" --- initialize string/macro to empty, if undefined
-.if !d\\$1 .ds \\$1 \" empty
-..
-.
-.@R @\"			\" debugging level
-.
-.
-.\"		*** INTERNAL GP MACROS ***
-.
-.
-.de @C			\" --- change ev's, taking info with us
-.nr _S \\n(.s
-.nr _V \\n(.v
-.nr _F \\n(.f
-.nr _J \\n(.j
-.do ds _A \\n.fam
-.nr _I \\n(.i
-.ev \\$1
-.ps \\n(_S
-.vs \\n(_Vu
-.ft \\n(_F
-.ad \\n(_J
-.do @fam \\*(_A
-'in \\n(_Iu
-.xl \\n($lu
-.lt \\n($lu
-.rr _S
-.rr _V
-.rr _F
-.rr _I
-.rr _J
-.ls 1
-'ce 0
-..
-.
-.de @D		\" --- determine display type (Indent, Left, Center)
-.ds |p "\\$3
-.nr _d 0
-.if "\\$2"C" \
-.	nr _d 1
-.if "\\$2"L" \
-.	nr _d 2
-.if "\\$2"I" \
-.	nr _d 3
-.if "\\$2"M" \
-.	nr _d 4
-.if !\\n(_d \
-\{\
-.	nr _d \\$1
-.	ds |p "\\$2
-.\}
-.
-..
-.
-.rn nm @#		\" --- rename to original command
-.de nm			\" --- turn on number mode preserving font info
-.ie \\n(.$ \
-\{\
-.	nr _S \\n(.s
-.	nr _F \\n(.f
-.	ps \\n_#p
-.	ft \\n_#f
-.	@# \\$1 \\$2 \\$3 \\$4
-.	ft \\n(_F
-.	ps \\n(_S
-.	rr _F
-.	rr _S
-.\}
-.el .@#
-..
-.
-.de @z			\" --- end macro
-.if \n@>1 .tm >> @z, .z=\\n(.z ?a=\\n(?a
-.if !"\\n(.z"" \
-\{\
-.	tm Line \\n(c. -- Unclosed block, footnote, or other diversion (\\n(.z)
-.	di
-.	ex
-.\}
-.if \\n(?a \
-.	bp			\" force out final table
-.ds bp
-.ds @b\"			\" don't start another page
-.br
-.if \n@>1 .tm << @z
-..
-.
-.
-.\"		*** STANDARD HEADERS AND FOOTERS ***
-.
-.
-.ie \n(.g .ds $* \\\\$*
-.el .ds $* \\\\$1 \\\\$2 \\\\$3 \\\\$4 \\\\$5 \\\\$6 \\\\$7 \\\\$8 \\\\$9
-.
-.de he			\" *** define header
-.ie !\\n(.$ \
-\{\
-.	rm |4
-.	rm |5
-.\}
-.el \
-\{\
-.	ds |4 "\*($*
-.	ds |5 "\*($*
-.\}
-..
-.
-.de eh			\" *** define even header
-.ie !\\n(.$ \
-.	rm |4
-.el \
-.	ds |4 "\*($*
-..
-.
-.de oh			\" *** define odd header
-.ie !\\n(.$ \
-.	rm |5
-.el \
-.	ds |5 "\*($*
-..
-.
-.de fo			\" *** define footer
-.ie !\\n(.$ \
-\{\
-.	rm |6
-.	rm |7
-.\}
-.el \
-\{\
-.	ds |6 "\*($*
-.	ds |7 "\*($*
-.\}
-..
-.
-.de ef			\" *** define even footer
-.ie !\\n(.$ \
-.	rm |6
-.el \
-.	ds |6 "\*($*
-..
-.
-.de of			\" *** define odd footer
-.ie !\\n(.$ \
-.	rm |7
-.el \
-.	ds |7 "\*($*
-..
-.
-.de ep			\" *** end page (must be followed by a .bp)
-.if \\n(nl>0 \
-\{\
-.	wh 0
-.	rs
-.	@b
-.\}
-..
-.
-.
-.\"		*** INTERNAL HEADER AND FOOTER MACROS ***
-.
-.
-.de @h			\" --- header
-.if \n@>1 .tm >> @h %=\\n% ?a=\\n(?a ?b=\\n(?b ?w=\\n(?w
-.if (\\n(.i+\\n(.o)>=\\n(.l \
-.	tm Line \\n(c. -- Offset + indent exceeds line length
-.\" initialize a pile of junk
-.nr ?h \\n(?H			\" transfer "next page" to "this page"
-.nr ?H 0
-.nr ?c \\n(?C
-.nr ?C 0
-.rn |4 |0
-.rn |5 |1
-.rn |6 |2
-.rn |7 |3
-.nr _w 0			\" reset max footnote width
-.nr ?W 0			\" no wide floats this page (yet)
-.nr ?I 1
-.\" begin actual header stuff
-.ev 2
-.rs
-.if \\n(hm>0 \
-.	if !'\*(.T'html' \
-.		sp |\\n(hmu	\" move to header position
-.@t $h\"			\" output header title
-.if \\n(tm<=0 \
-.	nr tm \n(.Vu
-.if !'\*(.T'html' \
-.	sp |\\n(tmu		\" move to top of text
-.ev
-.mk _k				\" for columned output
-.if \\n(?n=1 .nm 1		\" restore line numbering if n1 mode
-.nr $c 1			\" set first column
-.if \n@>4 .tm -- @h >> .ns nl=\\n(nl %=\\n% _k=\\n(_k tm=\\n(tm
-.ie \\n(?s \
-\{\
-.	nr ?s 0
-.	rs
-'	@b
-.\}
-.el \
-.	@n\"			\" begin the column
-.if \n@>2 .tm << @h
-..
-.
-.de @n			\" --- new column or page
-.if \n@>3 .tm >> @n nl=\\n(nl %=\\n% ?f=\\n(?f ?o=\\n(?o
-.if \\n(bm<=0 \
-.	nr bm \\n(.Vu
-.if (\\n(_w<=\\n($l)&(\\n(?W=0) \
-\{\
-.	\" Compute fudge factor (must be < 1P).
-.	nr _b (\\n(ppp*\\n($vu)/200u
-.	if \\n(_bu>((\\n(bmu-\\n(fmu-((\\n(tpp*\\n($vu)/100u))/2u) \
-.		nr _b (\\n(ppp*\\n($vu)/100u-\n(.Vu
-.	nr _b +\\n(bmu
-.\}
-.nr _B \\n(_bu
-.ch @f
-.wh -\\n(_bu @f
-.nr _b +(\\n(ppp*\\n($vu)/100u \" add 1 paragraph v in case sweep past
-.if \n@>2 .tm @n .p=\\n(.p bm=\\n(bm _b=\\n(_b _B=\\n(_B
-.nr ?f 0			\" reset footnote flag
-.if \\n(?o \
-\{\
-.	(f _\"		\" reprocess footnotes which run off page
-.	nf
-.	|o
-.	fi
-.	)f
-.	rm |o
-.\}
-.nr ?o 0
-.if \\n(?T \
-\{\
-.	nr _i \\n(.i
-.	if \\n(?n \
-.		nm \\n(ln
-.	in 0
-.	|h\"			\" output the table header
-.	in \\n(_iu
-.	if \\n(?n \
-.		nm
-.	rr _i
-.	mk #T			\" for tbl commands
-.	ns
-.\}
-.if (\\n(?a)&((\\n($c<2):(\\n(?w=0)) \
-\{\
-.	nr ?a 0			\" output floating keep
-.	@k |t
-.	if \\n(?w \
-.		mk _k		\" don't overstrike wide keeps
-.	nr ?w 0
-.\}
-.os
-.$H\"				\" special column header macro
-.ns
-..
-.
-.de @f			\" --- footer
-.if \n@>1 .tm >> @f %=\\n% nl=\\n(nl ?a=\\n(?a ?b=\\n(?b ?f=\\n(?f
-.if \n@>2 .nr VL \\n(.pu-\\n(nlu
-.if \n@>2 .tm @f bm=\\n(bm _B=\\n(_B _b=\\n(_b .p-nl=\\n(VL
-.ec
-.if \\n(?T \
-\{\
-.	nr T. 1		\" for tbl commands (to output bottom line)
-.	T# 1\"		\" output the sides and bottom lines
-.	br
-.\}
-.ev 2
-.ce 0
-.if \\n(?b \
-\{\
-.	nr ?b 0
-.	@k |b\"			\" output bottom of page tables
-.\}
-.if \\n(?f \
-.	@o\"			\" output footnote if present
-.ie \\n($c<\\n($m \
-.	@c\"			\" handle new column
-.el \
-.	@e\"			\" new page
-.ev
-.if \n@>2 .tm << @f
-..
-.
-.de @o			\" --- output footnote
-.nf
-.ls 1
-.in 0
-.if \n@>2 .tm @o last printed text = \\n(nl placing @r trap at -\\n(_B
-.wh -\\n(_Bu @r
-.if \\n(?n \
-.	nm \\n(ln
-.|f
-.if \\n(?n \
-.	nm
-.fi
-.if \n@>2 .tm @o triggered @r (?o) = \\n(?o
-.if \\n(?o \
-\{\
-.	di			\" just in case triggered @r
-.	if \\n(dn=0 \
-\{\
-.		rm |o
-.		nr ?o 0
-.	\}
-.	nr dn \\n(_D
-.	rr _D
-.\}
-.rm |f
-.ch @r
-..
-.
-.de @c			\" --- new column
-.if \n@>2 .tm	>> @c %=\\n%
-.rs
-.sp |\\n(_ku
-.@O +\\n($lu+\\n($su
-.nr $c +1
-.@n
-..
-.
-.de @e			\" --- end page
-.if \n@>2 .tm	>> @e
-.@O \\n(_ou
-.rs
-.\" Move to footer position.
-.sp |\\n(.pu-\\n(fmu-((\\n(tpp*\\n($vu)/100u)
-.@t $f\"			\" output footer title
-.nr ?h 0
-.bp
-..
-.
-.de @t			\" --- output header or footer title
-.if !\\n(?h \
-\{\
-.	sz \\n(tp\"		\" set header/footer type fonts, etc.
-.	@F \\n(tf
-.	lt \\n(_Lu		\" make title span entire page
-.	if \\n(?n \
-.		nm \\n(ln
-.	nf
-.	\\$1
-.	br
-.	if \\n(?n \
-.		nm
-.\}
-..
-.
-.de $h			\" $$$ print header
-.ds |z
-.if !\\n(?c \
-\{\
-.	if e .ds |z "\\*(|0
-.	if o .ds |z "\\*(|1
-.\}
-.if !\(ts\\*(|z\(ts\(ts \
-'	tl \\*(|z
-.rm |z
-..
-.
-.de $f			\" $$$ print footer
-.ds |z
-.if \\n(?c \
-\{\
-.	if e .ds |z "\\*(|0
-.	if o .ds |z "\\*(|1
-.\}
-.if \(ts\\*(|z\(ts\(ts \
-\{\
-.	if e .ds |z "\\*(|2
-.	if o .ds |z "\\*(|3
-.\}
-.if !\(ts\\*(|z\(ts\(ts \
-'	tl \\*(|z
-.rm |z
-..
-.
-.de @r			\" --- reprocess overflow footnotes
-.if \n@>3 .tm		>> @r .z=\\n(.z ?f=\\n(?f ?a=\\n(?a ?b=\\n(?b _b=\\n(_b
-.di |o				\" save overflow footnote
-.nr ?o 1
-.nr _D \\n(dn
-.ns
-..
-.
-.
-.\"		*** COMMANDS WITH VARIANT DEFINITIONS ***
-.
-.
-.if !'\*(.T'html' .rn bp @b	\" --- begin page
-.
-.de bp			\" *** begin new page (overrides columns)
-.nr $c \\n($m			\" force new page, not new column
-.ie \\n(nl>0 \
-.	@b \\$1
-.el \
-\{\
-.	if \\n(.$>0 \
-.		pn \\$1
-.	if \\n(?I \
-.		@h\"		\" 'spring' the header trap
-.\}
-.br
-.wh 0 @h			\" reset header
-..
-.
-.rn ll xl		\" *** special line length (local)
-.de ll			\" *** line length (global to environments)
-.xl \\$1
-.lt \\$1
-.nr $l \\n(.l
-.if (\\n($m<=1):(\\n($l>\\n(_L) \
-.	nr _L \\n(.l
-..
-.
-.rn po @O		\" --- local page offset
-.
-.de po			\" *** page offset
-.@O \\$1
-.nr _o \\n(.o
-..
-.
-.\" Redefine the fam request to set the family in
-.\" environment 2 as well as the current environment.
-.if !\n(.g .ig
-.do rn fam @fam		\" --- set family in current environment
-.do de fam		\" *** set font family in ev 2 and current ev
-.do @fam \\$1
-.ev 2
-.do @fam \\$1
-.ev
-..
-.
-.
-.\"		*** MISCELLANEOUS ROFF COMMANDS ***
-.
-.
-.de hx			\" *** suppress headers and footers next page
-.nr ?H 1
-..
-.
-.de ix			\" *** indent, no break
-'in \\$1
-..
-.
-.de bl			\" *** contiguous blank lines
-.br
-.@s \\$1
-.sp \\$1
-..
-.
-.de @s			\" --- diversion-surviving space test
-.ne \\$1
-.rs
-.if !'\\n(.z'' \!.@s \\$1
-..
-.
-.de n1			\" *** line numbering 1
-.ll -\w'0000'u
-.nr ?n 1
-.nr _#p \\n(.s
-.nr _#f \\n(.f
-.nm 1
-..
-.
-.de n2			\" *** line numbering 2
-.ie \\n(.$ \
-\{\
-.	ie !`\\$2`c` \
-.		po -\w'0000'u
-.	el \
-.		ll -\w'0000'u
-.	ie \\B`\\$1` \
-\{\
-.		ds |i \\$1
-.		ds |j \\$1
-.		\" Pick off leading char and rest to check.
-.		do substring |i 0 0  \"
-.		do substring |j 1    \" for +N / -N
-.		ie `\\*(|i`+` \
-.			nr ln (\\n_ln)+\\*(|j
-.		el \
-.			ie `\\*(|i`-` \
-.				nr ln (\\n_ln)-\\*(|j
-.			el \
-.				nr ln \\$1  \" unsigned N
-.		nr _#p \\n(.s
-.		nr _#f \\n(.f
-.		nm \\n(ln
-.		nr ?n 2
-.		rm |i |j
-.\}
-.	el \
-.		tm Line \\n(.c -- Bad .n2 value
-.\}
-.el \
-\{\
-.	nm
-.	nr _ln \\n(ln
-.	po +\w'0000'u
-.	ll \\n($lu
-.	nr ?n 0
-.	nr ln 0
-.\}
-..
-.
-.de pa			\" *** new page
-.bp \\$1
-..
-.
-.de ro			\" *** roman page numbers
-.af % i
-..
-.
-.de ar			\" *** arabic page numbers
-.af % 1
-..
-.
-.de m1			\" *** position one space
-.nr _0 \\n(hmu
-.nr hm \\$1v
-.nr tm +\\n(hmu-\\n(_0u
-.rr _0
-..
-.
-.de m2			\" *** position two space
-.nr tm \\n(hmu+\\n(tpp+\\$1v
-..
-.
-.de m3			\" *** position three space
-.nr bm \\n(fmu+\\n(tpp+\\$1v
-..
-.
-.de m4			\" *** position four space
-.nr _0 \\n(fmu
-.nr fm \\$1v
-.nr bm +\\n(fmu-\\n(_0u
-..
-.
-.de sk			\" *** leave a blank page (next page)
-.if \\n(.$>0 \
-.	tm Line \\n(c. -- I cannot skip multiple pages
-.nr ?s 1
-..
-.
-.
-.\"		*** MISCELLANEOUS USER SUPPORT COMMANDS ***
-.
-.
-.if !\n(.g .ig
-.de re		\" *** reset tabs (TROFF defines 15 stops default)
-.ta T 0.5i
-..
-.
-.if \n(.g .ig
-.de re
-.ta 0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i
-..
-.
-.de ba			\" *** set base indent
-.ie \\n(.$ \
-.	nr $i \\$1n
-.el \
-.	nr $i \\n(siu*\\n($0u
-..
-.
-.de hl			\" *** draw horizontal line
-.br
-.if '\*(.T'html' \
-\{\
-.	HR
-.	do return
-.\}
-.ie \n(.g .do nr _I \\n.in
-.el .nr _I \\n(.i
-\l'\\n(.lu-\\n(_Iu'
-.sp
-..
-.
-.
-.\"		*** PARAGRAPHING ***
-.
-.
-.de pp			\" *** paragraph
-.lp \\n(piu
-..
-.
-.de lp			\" *** left aligned paragraph
-.@p
-.if \\n(.$ \
-.	ti +\\$1
-.nr $p 0 1
-..
-.
-.de ip			\" *** indented paragraph w/ optional tag
-.if (\\n(ii>0)&(\\n(ii<1n) \
-.	nr ii \\n(iin
-.nr _0 \\n(ii
-.if \\n(.$>1 \
-.	nr _0 \\$2n
-.@p \\n(_0u
-.nr _I \\n(.iu
-.in 0
-.nm
-.di |i
-\&\\$1
-.br
-.di
-.if \\n(?n \
-.	nm \\n(ln
-.in \\n(_Iu
-.ds |j \\*(|i\\
-.ie \\w"\\*(|j" \
-\{\
-.	ti -\\n(_0u
-.	ie \\w"\\*(|j">=\\n(_0 \
-\{\
-.		do DEVTAG-COL 1
-\\*(|j
-.		do DEVTAG-COL-NEXT 2
-.		br
-.	\}
-.	el \
-\{\
-.		do DEVTAG-COL 1
-\\*(|j\h'|\\n(_0u'\c
-.		do DEVTAG-COL 2
-.       \}
-.\}
-.el .do DEVTAG-COL 2
-.rr _0
-.rm |i |j
-..
-.
-.de np			\" *** numbered paragraph
-.\" use string comparison in case user has changed format of $p
-.if '\\n($p'-1' \
-.	nr $p 0			\" reset number after .bu
-.nr $p +1			\" increment paragraph number
-.@p \w'\0(000)\0'u
-.ti -\w'\0(000)\0'u
-\0(\\n($p)\h'|\w'\0(000)\0'u'\c
-..
-.
-.de bu			\" *** bulleted paragraph
-.br
-.\" use string comparison in case user has changed format of $p
-.if '\\n($p'-1' \
-.	ns			\" don't space between .bu paragraphs
-.nr $p 0-1			\" mark "bulleted paragraph" mode
-.@p \w'\0\(bu\0'u
-.ti -\w'\0\(bu\0'u
-\0\(bu\0\c
-..
-.
-.de @p			\" --- initialize for paragraph
-.do check_need_title
-.if "\\n(.z"|e" .tm Line \\n(c. -- Unmatched continued equation
-.in \\n($iu+\\n(pou
-.if \\n(.$ \
-.	in +\\$1n
-.ce 0
-.fi
-.@F \\n(pf
-.sz \\n(pp
-.sp \\n(psu
-.ne \\n(.Lv+\\n(.Vu
-.ns
-..
-.
-.
-.\"		*** SECTION HEADINGS ***
-.
-.
-.de sh			\" *** section heading
-.fi
-.do check_need_title
-.if (\\n(si>0)&(\\n(si<1n) \
-.	nr si \\n(sin
-.if '\*(.T'html' .nr si 0
-.ce 0
-.if '\*(.T'html' \
-\{\
-.	do DEVTAG-SH \\$1
-.	do nr need_eo_h 1
-.\}
-.@d "\\$1" +1 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
-.if !"\\$2"_" \
-\{\
-.	ds |n \&\\$2
-.	$p "\\*(|n" "\\*($n" \\n($0
-.	$0 "\\*(|n" "\\*($n" \\n($0
-.	rm |n
-.\}
-.nr $p 0 1			\" reset .np count
-..
-.
-.de @d			\" --- change section depth
-.if !""\\$1" \
-.	nr $0 \\$1
-.if \\n($0&(\\n(.$>1) \
-.	nr $\\n($0 \\$2
-.ds $n \&\"
-.ie \\n($0>=1 \
-\{\
-.	if '\\n($1'0' \
-.		nr $1 1
-.	if (\\n(.$>=3) .if !"\\$3"-" \
-.		nr $1 \\$3
-.	as $n \\n($1
-.\}
-.el \
-.	nr $1 0
-.ie \\n($0>=2 \
-\{\
-.	if '\\n($2'0' \
-.		nr $2 1
-.	if (\\n(.$>=4) .if !"\\$4"-" \
-.		nr $2 \\$4
-.	as $n .\\n($2
-.\}
-.el \
-.	nr $2 0
-.ie \\n($0>=3 \
-\{\
-.	if '\\n($3'0' \
-.		nr $3 1
-.	if (\\n(.$>=5) .if !"\\$5"-" \
-.		nr $3 \\$5
-.	as $n .\\n($3
-.\}
-.el \
-.	nr $3 0
-.ie \\n($0>=4 \
-\{\
-.	if '\\n($4'0' \
-.		nr $4 1
-.	if (\\n(.$>=6) .if !"\\$6"-" \
-.		nr $4 \\$6
-.	as $n .\\n($4
-.\}
-.el \
-.	nr $4 0
-.ie \\n($0>=5 \
-\{\
-.	if '\\n($5'0' \
-.		nr $5 1
-.	if (\\n(.$>=7) .if !"\\$7"-" \
-.		nr $5 \\$7
-.	as $n .\\n($5
-.\}
-.el \
-.	nr $5 0
-.ie \\n($0>=6 \
-\{\
-.	if '\\n($6'0' \
-.		nr $6 1
-.	if (\\n(.$>=8) .if !"\\$8"-" \
-.		nr $6 \\$8
-.	as $n .\\n($6
-.\}
-.el \
-.	nr $6 0
-..
-.
-.de sx			\" *** heading up, no increment (2.1.1 -> 2.1)
-.ce 0
-.ul 0
-.nr _0 \\n($0-1
-.if \\n(.$ .nr _0 +1
-.if \\n(.$ .nr _0 \\$1
-.@d \\n(_0
-.rr _0
-.$p "" "" \\n($0
-.nr $p 0 1			\" reset .np count
-..
-.
-.de uh			\" *** unnumbered section heading
-.$p "\\$1"
-.$0 "\\$1"
-..
-.
-.de $p			\" $$$ print section heading
-.if (\\n(si>0)&(\\n(.$>2) \
-.	nr $i \\$3*\\n(si
-.in \\n($iu
-.ie !"\\$1\\$2"" \
-\{\
-.	sp \\n(ssu 		\" one of them is non-null
-.	ne \\n(.Lv+\\n(.Vu+\\n(psu+((\\n(spp*\\n($vu*\\n(.Lu)/100u)
-.	\" exdent if \\$3 > 0
-.	ie 0\\$3 \
-.		ti -(\\n(siu-\\n(sou)
-.	el \
-.		ti +\\n(sou
-.	@F \\n(sf
-.	sz \\n(sp
-.	if 0\\$3 \
-.		$\\$3
-.	if \w"\\$2">0 \\$2.
-.	if \w"\\$1">0 \\$1\f1\ \ \&
-.\}
-.el \
-.	sp \\n(psu
-.@F \\n(pf
-.sz \\n(pp
-..
-.
-.
-.\"		*** COLUMNED OUTPUT ***
-.
-.
-.de 2c			\" *** double columned output
-.br
-.if \\n($m>1 \
-.	1c\"			\" revert to 1c if already 2c
-.nr $c 1
-.nr $m 2
-.if \\n(.$>1 \
-.	nr $m \\$2
-.if \\n(.$>0 \
-.	nr $s \\$1n		\" param 1: column separation
-.nr $l (\\n(.l-((\\n($m-1)*\\n($s))/\\n($m
-.xl \\n($lu
-.mk _k
-.ns
-..
-.
-.de 1c			\" *** single columned output
-.br
-.nr $c 1
-.nr $m 1
-.ll \\n(_Lu			\" return to normal output
-.sp |\\n(.hu
-.@O \\n(_ou
-..
-.
-.de bc			\" *** begin column
-.sp 24i
-..
-.
-.
-.\"		*** FLOATING TABLES AND NONFLOATING BLOCKS ***
-.
-.
-.de (z			\" *** begin floating keep
-.if \n@>4 .tm >> (z, .z=\n(.z
-.@D 4 \\$1 \\$2
-.@(
-..
-.
-.de )z			\" *** end floating keep
-.if \n@>4 .tm >> )z, .z=\n(.z
-.sp \\n(zsu
-.@)
-.if \n@>4 .tm -- )z << @), .z=\n(.z
-.rr _0
-.if !\\n(?b \
-.	nr dn +(\\n(ppp*\\n($vu)/200u+\\n(zsu
-.nr dl -\n(.H		\" fudge factor necessary to make it work
-.ie ((\\n(dn+\n(.V)>=\\n(.t):(\\n(?a):((\\n(dl>\\n($l)&(\\n($c>1)) \
-\{\
-.	nr ?a 1
-.	if (\\n(dl>\\n($l)&(\\n($m>1) \
-.		nr ?w 1		\" mark wider than one column (top)
-.	ds |x |t
-.\}
-.el \
-\{\
-.	nr ?b 1
-.	if (\\n(dl>\\n($l)&(\\n($m>1) \
-.		nr ?W 1		\" mark wider than one column (bottom)
-.	nr _b +\\n(dnu
-.	\" avoid moving @f back past the current position
-.	if \\n(.p-\\n(nl-\n(.V<\\n(_b \
-.		nr _b \\n(.p-\\n(nl-\n(.V
-.	ch @f -\\n(_bu
-.	ds |x |b
-.\}
-.da \\*(|x			\" copy to save macro
-.nf
-.ls 1
-.nr ?k 1
-.if \n@>4 .tm -- )z >> \\*(|x
-\!.if \\\\n(nl>(\\\\n(tm+2v) .ne \\n(dnu-\\n(zsu
-.|k\"				\" and the body
-.ec
-.if \n@>4 .tm -- )z << \\*(|x, .z=\\n(.z
-.nr ?k 0
-.rm |k\"			\" remove the temp macro
-.da
-.in 0
-.ls 1
-.xl \\n($lu
-.ev
-.if \n@>4 .tm << )z, .z=\\n(.z
-..
-.
-.de @k			\" --- output floating keep
-.if \n@>4 .tm >> @k, $1=\\$1, .z=\\n(.z
-.ev 1
-.nf
-.ls 1
-.in 0
-.if !`\\$2`ns` .sp \\n(zsu	\" no pre-spacing if (b .. )b
-.if \\n(?n \
-.	nm \\n(ln
-.\\$1
-.if \\n(?n \
-.	nm
-.ec
-.br
-.rm \\$1
-.ev
-..
-.
-.de (t			\" XXX temp ref to (z
-.(z \\$1 \\$2
-..
-.
-.de )t			\" XXX temp ref to )t
-.)z \\$1 \\$2
-..
-.
-.de (b			\" *** begin block
-.br
-.@D 3 \\$1 \\$2
-.sp \\n(bsu
-.@(
-.if '\*(.T'html' .sp \\n(bsu
-..
-.
-.de )b			\" *** end block
-.br
-.@)
-.if (\\n(bt=0):(\\n(.t<\\n(bt) \
-.	ne \\n(dnu		\" make it all on one page
-.@k |k ns
-.ev                             \" return from display environment
-.sp \\n(bsu+\\n(.Lv-1v
-..
-.
-.de @(			\" --- begin keep
-.if !"\\n(.z"" .tm Line \\n(c. -- Invalid nested keep \\n(.z
-.@M
-.di |k
-\!'rs
-..
-.
-.de @M			\" --- set modes for display
-.nr ?k 1
-.@C 1
-.@F \\n(df
-.if \\n($R .@V
-.vs \\n(.sp*\\n($Vu/100u
-.nf
-.if "\\*(|p"F" \
-.	fi			\" set fill mode if "F" parameter
-.if \\n(_d=4 \
-.	in 0
-.if \\n(_d=3 \
-\{\
-.	in +\\n(biu
-.	xl -\\n(biu
-.\}
-.if \\n(_d=1 \
-.	ce 10000
-..
-.
-.de @)			\" --- end keep
-.br
-.if !"\\n(.z"|k" .tm Line \\n(c. -- Close of a keep which has never been opened
-.nr ?k 0
-.di
-.in 0
-.ce 0
-..
-.
-.de (c			\" *** begin block centered text
-.br
-.if "\\n(.z"|c" .tm Line \\n(c. -- Nested .(c requests
-.if \\n(?n .nm
-.if ``\\n(.z` \
-\{\
-.	@C 1		\" Ensure env. set up for centering in open text
-.	ev
-.\}
-.di |c
-..
-.
-.de )c			\" *** end block centered text
-.if !"\\n(.z"|c" .tm Line \\n(c. -- Unmatched .)c
-.br				\" force out final line
-.di
-.if \n@>4 .tm >> .)c .l=\\n(.l .i=\\n(.i $i=\\n($i dl=\\n(dl
-.ev 1
-.ls 1
-.in (\\n(.lu-\\n(.iu-\\n(dlu)/2u
-.if \n@>4 .tm -- .)c << .in .l=\\n(.l .i=\\n(.i dl=\\n(dl
-.if \\n(?n \
-.	nm \\n(ln
-.nf
-.|c
-.ec
-.in
-.ls
-.if \\n(?n \
-.	nm
-.ev
-.rm |c
-.if \\n(?n \
-.	nm \\n(ln
-..
-.
-.
-.\"		*** BLOCK QUOTES (OR WHATEVER) AND LISTS ***
-.
-.
-.de (q			\" *** begin block quote
-.br
-.@C 1
-.fi
-.sp \\n(qsu
-.in +\\n(qiu
-.xl -\\n(qiu
-.sz \\n(qp
-.if \\n(?n \
-.	nm \\n(ln
-..
-.
-.de )q			\" *** end block quote
-.br
-.if \\n(?n \
-.	nm
-.ev
-.sp \\n(qsu+\\n(.Lv-1v
-.nr ?k 0
-..
-.
-.de (l			\" *** begin list
-.br
-.sp \\n(bsu
-.@D 3 \\$1 \\$2
-.@M
-.if \\n(?n \
-.	nm \\n(ln
-.if '\*(.T'html' .sp \\n(bsu
-..
-.
-.de )l			\" *** end list
-.br
-.ev
-.if \\n(?n \
-.	nm \\n(ln
-.sp \\n(bsu+\\n(.Lv-1v
-.nr ?k 0
-..
-.
-.
-.\"		*** PREPROCESSOR SUPPORT ***
-.
-.
-.\"
-.\"	EQN
-.\"
-.de EQ			\" *** equation start
-.do if \\nneed_eo_h>0 .do DEVTAG-EO-H
-.do nr need_eo_h 0
-.ec
-.if "\*(.T"html" \
-\{\
-.	do nr e-EQ-ll \\n(.l
-.	ll 1000n
-.\}
-.do HTML-IMAGE
-.if !\\n(?e \
-\{\
-.	if "\\n(.z"|e" .tm Line \\n(c. -- Nested .EQ request
-.	@D 1 "\\$1" "\\$2"
-.	@C 2
-.	di |e
-.\}
-.ls 1
-.in 0
-.nf
-..
-.
-.de EN			\" *** equation end
-.br
-.do HTML-IMAGE-END
-.if "\*(.T"html" \
-.	do ll \\ne-EQ-llu
-.ie "\\$1"C" \
-\{\
-.	nr ?e 1
-.	sp \\n(esu
-.\}
-.el \
-\{\
-.	nr ?e 0
-.	di
-.	if \\n(dn \
-.		@q\"		\" actual equation output
-.	rm |e
-.	ev
-.\}
-..
-.
-.de @q			\" --- equation output
-.nr _Q \\n(dnu
-.ev
-.sp \\n(esu			\" output rest of preceding text
-.if !"\\n(.z"" \!.ne \\n(_Qu
-.ne \\n(_Qu+\n(.Vu		\" keep it on one page
-.@C 2\"				\" .ev 2 may be jumbled from header
-.if \\n(_d=1 \
-.	in (\\n(.lu+\\n($iu-\\n(dlu)/2u
-.if \\n(_d=2 \
-.	in \\n($iu
-.if \\n(_d=3 \
-.	in \\n(biu+\\n($iu
-.if \\n(_d=4 \
-.	in 0
-.mk _q
-.if \n@>1 .tm --@e: _Q=\\n(_Q _q=\\n(_q nl=\\n(nl |p=\\*(|p
-.if !"\\*(|p"" \
-\{\
-.	rs
-.	sp (\\n(_Qu-\\n(.vu)/2u
-.	tl """\\*(|p"
-.	rt \\n(_qu
-.\}
-.if \\n(?n \
-.	nm \\n(ln
-.|e
-.if \\n(?n \
-.	nm
-.sp |\\n(_qu+\\n(_Qu
-.sp \\n(esu+\\n(.Lv-1v
-.rr _q
-.rr _Q
-..
-.
-.\"
-.\"	TBL
-.\"
-.de TS			\" *** table start
-.sp \\n(bsu
-.if "\*(.T"html" \
-\{\
-.	do nr e-TS-ll \\n(.l
-.	ll 1000n
-.\}
-.do HTML-IMAGE
-.@C 1
-.fi				\" drop into fill mode for text boxes
-.if "\\$1"H" \
-\{\
-.	di |h			\" save header part
-.	nr ?T 1
-.\}
-.ls 1
-.ch @f -(\\n(_bu+1v)		\" set pseudo-trap for bottom line
-.if \\n(.p-\\n(_b-1v<=\\n(nl \
-.	ch @f \\n(nlu+\n(.Vu
-..
-.
-.de TH			\" *** end header part of table
-.nr T. 0
-.T# 0
-.if \\n(?n \!.nm
-.di
-.nr _T \\n(?T
-.nr ?T 0
-.ne \\n(dnu+1v
-.nr ?T \\n(_T
-.nr _i \\n(.i
-.if \\n(?n .nm \\n(ln
-.in 0
-.|h\"				\" put in the initial header
-.in \\n(_iu
-.rr _i
-.mk #T
-..
-.
-.de TE			\" *** table end
-.nr ?T 0
-.ch @f -\\n(_bu			\" reset pseudo-trap
-.if \\n(.p-\\n(_b<=\\n(nl \
-.	ch @f \\n(nlu+\n(.Vu
-.ev
-.do HTML-IMAGE-END
-.if "\*(.T"html" \
-.	do ll \\ne-TS-llu
-.sp \\n(bsu+\\n(.Lv-1v
-.re
-..
-.
-.de T&
-..
-.
-.\"
-.\"	REFER
-.\"
-.mso refer-me.tmac
-.
-.\"
-.\"	IDEAL
-.\"
-.de IS			\" *** start ideal picture
-.nr g7 \\n(.u
-.ls 1
-..
-.
-.de IF
-.if \\n(g7 .fi
-.ls
-..
-.
-.de IE			\" *** end ideal picture
-.if \\n(g7 .fi
-.ls
-..
-.
-.\"
-.\"	PIC
-.\"
-.de PS	\" *** start picture: $1=height, $2=width in units or inches
-.sp 0.3
-.do HTML-IMAGE
-.nr g7 \\$2
-.in (u;\\n(.l-\\n(g7>?0/2)
-.ne \\$1u
-.nr g7 \\n(.u
-.ls 1
-.if \\n(?n \
-\{\
-.	de PS_nm_check && \" define macro to emit .nm at top diversion
-.	if \n@>4 .tm -- PS: \\\\$1 \\\\$2 .z=\\\\n(.z PS_nm_cnt=\\\\nPS_nm_cnt
-.	\" Multiple .PS/.PE in a keep.
-.	if `\\\\$2`init` \
-.		do nr PS_nm_cnt \\\\nPS_nm_cnt+1
-.	ie `\\\\n(.z`` \
-\{\
-.		if `\\\\$1`suspend` \
-.			nm
-.		if `\\\\$1`resume` \
-\{\
-.			nm \\\\n(ln
-.			do nr PS_nm_cnt \\\\nPS_nm_cnt-1
-.			do if !\\\\nPS_nm_cnt \
-\{\
-.				do rm PS_nm_check
-.				do rr PS_nm_cnt
-.\}
-.\}
-.\}
-.el \!.PS_nm_check \\\\$1
-.&&
-.	mk _q		\" emit a single numbered line for PS picture
-.	rs
-\&\ 
-.	br
-.	rt \\n(_qu
-.	PS_nm_check suspend init
-.\}
-..
-.
-.de PE			\" *** end picture
-.if \\n(?n .PS_nm_check resume
-.ls
-.in
-.if \\n(g7 .fi
-.do HTML-IMAGE-END
-.sp .6
-..
-.
-.\"
-.\"	GREMLIN
-.\"
-.de GS			\" *** start gremlin picture
-.ie '\*(.T'html' \
-\{\
-.	ie "\\$1"L" .do HTML-IMAGE-LEFT
-.	el .ie "\\$1"R" .do HTML-IMAGE-RIGHT
-.	el .do HTML-IMAGE
-.\}
-.el \
-\{\
-.	nr g7 (\\n(.lu-\\n(g1u)/2u
-.	if "\\$1"L" .nr g7 \\n(.iu
-.	if "\\$1"R" .nr g7 \\n(.lu-\\n(g1u
-.	in \\n(g7u
-.	nr g7 \\n(.u
-.	ls 1
-.	nf
-.	ne \\n(g2u
-.\}
-..
-.
-.de GE			\" *** end gremlin picture
-.ie '\*(.T'html' .do HTML-IMAGE-END
-.el \
-\{\
-.	GF
-.	sp .6
-.\}
-..
-.
-.de GF			\" *** finish gremlin picture; stay at top
-.ls
-.in
-.if \\n(g7 .fi
-..
-.
-.
-.\"		*** FONT AIDS ***
-.
-.
-.de sz			\" *** set point size and vertical spacing
-.ps \\$1
-.if \\n($r .@v
-.vs \\n(.sp*\\n($vu/100u	\" default vs at pointsize + 20%
-..
-.
-.de @v			\" --- possibly set $v from $r
-.if (1i>=240u)&(1p<=\\n($r)&(\\n($r<=4p) .nr $v \\n($r00/1p
-..
-.
-.de @V			\" --- possibly set $V from $R
-.if (1i>=240u)&(1p<=\\n($R)&(\\n($R<=4p) .nr $V \\n($R00/1p
-..
-.
-.de @E		\" --- store in _F argument to \f for restoring font
-.ie \\n(.f<10 \
-.	ds _F \\n(.f
-.el \
-\{\
-.	ie \\n(.f<100&\n(.g \
-.		ds _F (\\n(.f
-.	el \
-.		ds _F P
-.\}
-..
-.
-.de r			\" *** enter roman font
-.do check_need_title
-.@E
-.ft 1
-.if \\n(.$ \&\\$1\f\\*(_F\\$2
-.do check_need_title
-..
-.
-.de i			\" *** enter italic
-.do check_need_title
-.@E
-.ft 2
-.if \\n(.$ \&\\$1\f\\*(_F\\$2
-.do check_need_title
-..
-.
-.de b			\" *** enter boldface
-.do check_need_title
-.@E
-.ft 3
-.if \\n(.$ \&\\$1\f\\*(_F\\$2
-.do check_need_title
-..
-.
-.de rb			\" *** enter real boldface
-.do check_need_title
-.@E
-.ft 3
-.if \\n(.$ \&\\$1\f\\*(_F\\$2
-.do check_need_title
-..
-.
-.de bi			\" *** enter bold italic
-.do check_need_title
-.@E
-.ft 4
-.if \\n(.$ \&\\$1\f\\*(_F\\$2
-.do check_need_title
-..
-.
-.de u			\" *** enter underlined word
-\&\\$1\l'|0\(ul'\\$2
-..
-.
-.\" a better version of u
-.if !\n(.g .ig
-.de u
-\Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'\\$2
-..
-.
-.de q			\" *** enter quoted word
-\&\\*(lq\\$1\\*(rq\\$2
-..
-.
-.de bx			\" *** enter boxed word
-.ie '\*(.T'html' \\$1\\$2
-.el \k~\(br\|\\$1\|\(br\l'|\\n~u\(rn'\l'|\\n~u\(ul'\^\\$2
-..
-.
-.de sm			\" *** print in smaller font
-\s-1\\$1\\s+1\\$2
-..
-.
-.de @F			\" --- change font (0 -> no change)
-.nr ~ \\$1
-.if \\n~>0 \
-.	ft \\n~
-.rr ~
-..
-.
-.
-.\"		*** FOOTNOTING ***
-.
-.
-.de (f			\" *** begin footnote
-.ec
-.if "\\n(.z"|f" .tm Line \\n(c. -- Invalid footnote nesting
-.ie "\\n(.z"" \
-\{\
-.	nr _D \\n(dn
-.	nr _0 1v+\\n(nlu
-.	ev 2
-.	nm
-.	da |f
-.	in 0
-.	xl \\n($lu-\\n(fuu
-.	@F \\n(ff
-.	sz \\n(fp
-.	vs \\n(.sp*\\n($Vu/100u
-.	if !\\n(?f \
-\{\
-.		nr _b +1v	\" allow space for $s
-.		$s
-.	\}
-.	br
-.	if \\n(.p-\\n(_b-\\n(_0-\\n(.h-1v-\\n(fs<0 \
-\{\
-.		da\"		\" won't fit on page at all
-.		bc
-.		if !\\n(?f \
-.			rm |f
-.		da |f
-.\" Next 5 lines could be dropped if headers had their own environment.
-.		in 0		\" reset everything from .bc
-.		xl \\n($lu-\\n(fuu
-.		@F \\n(ff
-.		sz \\n(fp
-.		vs \\n(.sp*\\n($Vu/100u
-.		if !\\n(?f \
-.			$s
-.		br
-.	\}
-.	rr _0
-.	sp \\n(fsu
-.	nr ?f 1
-.	fi
-.	if !"\\$1"_" \
-.		ti \\n(fiu
-.	if \n@>2 .tm	<< (f $f=\\n($f
-.\}
-.el \
-\{\
-.	ev 2
-.	nm
-.	in 0
-.	xl \\n($lu-\\n(fuu
-.	@F \\n(ff
-.	sz \\n(fp
-.	vs \\n(.sp*\\n($Vu/100u
-.	fi
-\!.(f \\$1
-\!.@N
-.\}
-..
-.
-.de @N		\" --- set no fill mode in the top-level diversion
-.ie "\\n(.z"" .nf
-.el \!.@N
-..
-.
-.de )f			\" *** end footnote
-.ie "\\n(.z"|f" \
-\{\
-.	if \\n* \
-.		nr $f +1
-.	ds * \\*{\\n($f\\*}\k*
-.	nr * 0
-.	in 0
-.	da
-.	ev
-.	if \\n(_w<\\n(dl \
-.		nr _w \\n(dl	\" compute maximum fn width
-.	nr _b +\\n(dn
-.	ch @f -\\n(_bu
-.	if \\n(.p-\\n(_b<=\\n(nl \
-.		ch @f \\n(nlu+\n(.Vu
-.	nr dn \\n(_D
-.	rr _D
-.\}
-.el \
-\{\
-.	br
-\!.)f
-.	ev
-.\}
-..
-.
-.@R ff
-.if \n(ff<=0 \
-.	nr ff 1			\" footnote font: Times Roman
-.@R fp
-.if \n(fp<=0 \
-.	nr fp 8			\" footnote pointsize
-.
-.de $s			\" $$$ footnote separator
-\l'2i'
-..
-.
-.
-.\"		*** DELAYED TEXT ***
-.
-.
-.de (d			\" *** begin delayed text
-.am |d )d
-.sp \\n(bsu
-..
-.
-.de )d			\" *** end delayed text
-.if \\n# \
-.	nr $d +1
-.ds # \\n($d\k#
-.rr #
-..
-.
-.de pd			\" *** print delayed text
-.|d
-.rm |d
-.nr $d 1 1
-.ds # 1\k#
-..
-.
-.
-.\"		*** INDEXES (TABLE OF CONTENTS) ***
-.
-.
-.nr _x 0 1
-.do nr _xn 0
-.af _x a
-.
-.de (x			\" *** begin index entry
-.if \n@>4 .tm >> (x, .z=\\n(.z
-.ds |X x
-.if \\n(.$>0 \
-.	ds |X \\$1
-.ie "\\n(.z"" \
-.	nr _z 0
-.el \
-.	nr _z 1
-.@\\n(_z
-..
-.
-.de @0			\" --- finish (x if no current diversion
-.am %\\*(|X )x
-.sp \\n(xsu
-.ti -\\n(piu
-..
-.
-.de @1			\" --- finish (x if current diversion
-.if "\\n(_x"z" .nr _x 0
-.de =\\n+(_x )x
-..
-.
-.de )x			\" *** end index entry
-.if \n@>4 .tm >> )x, .z=\\n(.z
-.ie "\\n(.z"" \
-\{\
-.	ds |x \\n%
-.	if \\n(.$>0 \
-.		ds |x \\$1
-.	if "\\*(|x"_" \
-.		ig ..
-.	am %\\*(|X ..
-.	if \w"\\$2">(\\n(.l-\\n(.i-\\n(.k) \
-.		ti +\\n(xuu
-\\\\a\\\\t\\$2\\*(|x
-...
-.	rm |x
-.	rm |X
-.\}
-.el \
-\{\
-\!.(x \\*(|X
-\!\\\\*(=\\n(_x\\\\
-\!.)x \\$1 \\$2
-\!.rm =\\n(_x
-.\}
-..
-.
-.de xp			\" *** print the index
-.br
-.@C 2
-.ls 1
-.vs \\n(.sp*\\n($Vu/100u
-.fi
-.in +\\n(piu
-.ds |X x
-.if \\n(.$>0 \
-.	ds |X \\$1
-.xl -(\\n(xuu+\w'...'u)
-.di |x
-.%\\*(|X
-.br
-.di
-.rm %\\*(|X
-.xl \\n($lu
-.rm |X
-.ev
-.nf
-.in 0
-.ta \\n(.lu-\\n(xuuR \\n(.luR
-.|x
-.fi
-.in
-.rm |x
-..
-.
-.
-.\"		*** HTML VERSIONS OF .x(, .x), AND .xp ***
-.
-.
-.de (x-html    \" --- create TAG and divert text
-.nr _x +1
-.do nr _xn +1
-.do TAG "_x\\n_x
-.br
-.do di |x\\n_xn
-.br
-..
-.
-.de )x-html    \" --- end diversion
-.br
-.di
-..
-.
-.de xp-html    \" --- create list of links
-.do nr _xx 1
-.br
-.do ev xp-html-ev
-.sp
-.do ULS
-.do while \\n_xx<=\\n_xn \
-\{\
-.	br
-.	do unformat |x\\n_xx
-.	do di xp-html-div
-.	br
-.	ll 100i
-.	fi
-.	do |x\\n_xx
-.	br
-.	di
-.	do asciify xp-html-div
-.	do rm xp-html-as
-.	do as xp-html-as #
-.	do as xp-html-as _x\\n_xx
-.	ll
-.	LI
-.	do URL \\*xp-html-as "\\*xp-html-div
-.	do rm xp-html-as
-.	do nr _xx +1
-.\}
-.do ULE
-.sp
-.ev
-..
-.
-.if '\*(.T'html' \
-\{\
-.	rm (x
-.	do als (x (x-html
-.	rm )x
-.	do als )x )x-html
-.	rm xp
-.	do als xp xp-html
-.\}
-.
-.
-.\"		*** CHAPTERS AND TITLES ***
-.
-.
-.de +c				\" *** begin chapter
-.ep\"				\" force out footnotes
-.if \\n(?o:\\n(?a \
-\{\
-.	bp			\" force out a table or more footnote
-.	rs
-.	ep
-.\}
-.nr ?C 1
-.nr $f 1 1
-.ds * \\*{1\\*}\k*
-.if \\n(?R \
-.	pn 1
-.bp
-.in \\n($iu			\" reset the indent
-.rs
-.ie \\n(.$ \
-.	$c "\\$1"
-.el \
-.	sp 3
-..
-.
-.de ++			\" *** declare chapter type
-.nr _0 0
-.if "\\$1"C" \
-.	nr _0 1			\" chapter
-.if "\\$1"RC" \
-.	nr _0 11		\" renumbered chapter
-.if "\\$1"A" \
-.	nr _0 2			\" appendix
-.if "\\$1"RA" \
-.	nr _0 12		\" renumbered appendix
-.if "\\$1"P" \
-.	nr _0 3			\" preliminary material
-.if "\\$1"B" \
-.	nr _0 4			\" bibliographic material
-.if "\\$1"AB" \
-.	nr _0 5			\" abstract
-.if \\n(_0=0 \
-.	tm Line \\n(c. -- Bad mode to .++
-.nr ?R 0
-.if \\n(_0>10 \
-\{\
-.	nr ?R 1
-.	nr _0 -10
-.\}
-.nr ch 0 1
-.if (\\n(_0=3):(\\n(_0=5) \
-.	pn 1			\" must do before .ep
-.if !\\n(_0=\\n(_M .if \\n(_M=3 \
-.	pn 1			\" must do before .ep
-.ep\"			\" end page for correct page number types
-.if \\n(_0=1 \
-\{\
-.	af ch 1
-.	af % 1
-.\}
-.if \\n(_0=2 \
-\{\
-.	af ch A
-.	af % 1
-.\}
-.if \\n(_0=3 \
-.	af % i
-.if \\n(_0=4 \
-.	af % 1
-.if \\n(_0=5 \
-.	af % 1
-.if \\n(.$>1 \
-.	he \\$2
-.nr _M \\n(_0
-.rr _0
-..
-.
-.de $c			\" $$$ print chapter title
-.sz 12
-.ft 3
-.ce 1000
-.if \\n(_M<3 \
-.	nr ch +1
-.ie \\n(_M=1 CHAPTER\ \ \\n(ch
-.el .if \\n(_M=2 APPENDIX\ \ \\n(ch
-.if \w"\\$1" .sp 3-\\n(.L
-.if \w"\\$1" \\$1
-.if (\\n(_M<3):(\w"\\$1") \
-.	sp 4-\\n(.L
-.ce 0
-.ft
-.sz
-.ie \\n(_M=1 \
-.	$C Chapter \\n(ch "\\$1"
-.el .if \\n(_M=2 \
-.	$C Appendix \\n(ch "\\$1"
-..
-.
-.de tp			\" *** title page
-.hx
-.bp
-.br
-.rs
-.pn \\n%
-..
-.
-.\"		*** DATES ***
-.if \n(mo=1 .ds mo January
-.if \n(mo=2 .ds mo February
-.if \n(mo=3 .ds mo March
-.if \n(mo=4 .ds mo April
-.if \n(mo=5 .ds mo May
-.if \n(mo=6 .ds mo June
-.if \n(mo=7 .ds mo July
-.if \n(mo=8 .ds mo August
-.if \n(mo=9 .ds mo September
-.if \n(mo=10 .ds mo October
-.if \n(mo=11 .ds mo November
-.if \n(mo=12 .ds mo December
-.if \n(dw=1 .ds dw Sunday
-.if \n(dw=2 .ds dw Monday
-.if \n(dw=3 .ds dw Tuesday
-.if \n(dw=4 .ds dw Wednesday
-.if \n(dw=5 .ds dw Thursday
-.if \n(dw=6 .ds dw Friday
-.if \n(dw=7 .ds dw Saturday
-.nr y2 \n(yr%100
-.af y2 00
-.nr y4 \n(yr+1900
-.ds td \*(mo \n(dy, \n(y4
-.
-.
-.\"		*** PARAMETRIC INITIALIZATIONS ***
-.
-.
-.rr x
-.nr $v \n(.v00+\n(.sp-1/\n(.sp	\" vs as % of ps for .sz request
-.nr $V \n($v			\" same for displays & footnotes
-.nr hm 4v			\" header margin
-.nr tm 7v			\" top margin
-.nr bm 6v			\" bottom margin
-.nr fm 3v			\" footer margin
-.nr tf 3			\" title font: (real) Times Bold
-.nr tp 10			\" title point size
-.hy 6
-.nr bi 4m			\" indent for blocks
-.nr pi 5n			\" indent for paragraphs
-.nr pf 1			\" normal text font
-.nr pp 10			\" normal text point size
-.nr qi 4n			\" indent for quotes
-.nr qp -1			\" down one point
-.nr ii 5n			\" indent for .ip's and .np's
-.nr $m 1			\" max number of columns
-.nr $s 4n			\" column separation
-.nr sf 3			\" section font -- Times Bold
-.nr sp 10			\" section title pointsize
-.nr ss 12p			\" section prespacing
-.nr si 0			\" section indent
-.
-.
-.\"		*** OTHER INITIALIZATION ***
-.
-.
-.\" GNU pic sets this register to 1 to indicate that \x should not be
-.\" used.
-.@R 0x
-.ds { \v'-0.4m'\x'\\n(0x=0*-0.2m'\s-3
-.ds } \s+3\v'0.4m'
-.\" for compatibility with traditional -me
-.\" (the first will work only in compatibility mode)
-.ds  \*{
-.ds  \*}
-.ds < \v'0.4m'\x'\\n(0x=0*0.2m'\s-3
-.ds > \s+3\v'-0.4m'
-.ds - \(em
-.\" Avoid warnings from groff -ww.
-.@S |0
-.@S |1
-.@S |2
-.@S |3
-.@S $H
-.@S $0
-.@S $1
-.@S $2
-.@S $3
-.@S $4
-.@S $5
-.@S $6
-.@S $7
-.@S $8
-.@S $9
-.@S ..
-.
-.@R po\"		\" simulated page offset
-.@R $0\"		\" section depth
-.@R $i\"		\" paragraph base indent
-.@R $p\"		\" numbered paragraph number
-.@R $r\"		\" ratio of vs to ps (may override $v)
-.@R $R\"		\" same for displays (may override $V)
-.@R df\"		\" display font: same as surrounding text
-.@R so\"		\" additional section title offset
-.@R fu\"		\" footnote undent
-.@R bt\"		\" block keep threshold
-.@R *\"			\" has \** been referenced?
-.@R ?a\"		\" pending floating keep at page top?
-.@R ?b\"		\" pending floating keep at page bottom?
-.@R ?C\"		\" at chapter header?
-.@R ?e\"		\" in equation?
-.@R ?H\"		\" suppress headers and footers next page?
-.@R ?I\"		\" has the header trap been sprung?
-.@R ?n\"		\" n1 mode?
-.@R ?o\"		\" footnote overflow?
-.@R ?R\"		\" renumbered chapter?
-.@R ?s\"		\" skip next page?
-.@R ?T\"		\" inside .TS H?
-.@R ?W\"		\" wide floating keep at page bottom?
-.@R ?w\"		\" wide floating keep at page top?
-.
-.nr fi 0.3i
-.nr _o \n(.o
-.nr $b 3			\" bold
-.nr ps 0.35v
-.if \n(ps<\n(.V .nr ps \n(.V
-.nr bs \n(ps			\" block pre/post spacing
-.nr qs \n(ps			\" quote pre/post spacing
-.nr zs 1v			\" float-block pre/postspacing
-.nr xs 0.2v			\" index prespacing
-.nr xu 0.5i			\" index undent
-.nr fs 0.2v			\" footnote prespacing
-.nr es 0.5v			\" equation pre/postspacing
-.if \n(es<\n(.V .nr es \n(.V
-.wh 0 @h			\" set header
-.nr $l \n(.lu			\" line length
-.nr _L \n(.lu			\" line length of page
-.nr $c 1			\" current column number
-.nr $f 1 1			\" footnote number
-.ds * \*{1\*}\k*\"		\" footnote "name"
-.nr $d 1 1			\" delayed text number
-.ds # 1\k#\"			\" delayed text "name"
-.nr _M 1			\" chapter mode is chapter
-.ds lq \(lq\"			\" left quote
-.ds rq \(rq\"			\" right quote
-.em @z
-.
-.
-.\"		*** FOREIGN LETTERS AND SPECIAL CHARACTERS ***
-.
-.
-.ds #h ((1u-(\\\\n(.fu%2u))*0.13m)
-.ds #v 0.6m
-.
-.\"			\" accents
-.ds ' \h'0'\k_\h'-(\\n(.wu*8/10-\*(#h)'\(aa\h'|\\n_u'
-.ds ` \h'0'\k_\h'-(\\n(.wu*7/10-\*(#h)'\(ga\h'|\\n_u'
-.
-.\"			\" umlaut
-.ds : \h'0'\k_\h'-(\\n(.wu*8/10-\*(#h+0.1m)'\v'-\*(#v'\z.\h'0.2m'.\h'|\\n_u'\v'\*(#v'
-.
-.\"			\" circumflex and tilde
-.ds ^ \h'0'\k_\h'-(\\n(.wu-\*(#h-0.05m)'^\h'|\\n_u'
-.ds ~ \h'0'\k_\h'-(\\n(.wu-\*(#h-0.05m)'~\h'|\\n_u'
-.
-.\"			\" cedilla and czech
-.ds , \h'0'\k_\h'-(\\n(.wu)',\h'|\\n_u'
-.ds v \h'0'\k_\h'-(\\n(.wu*9/10-\*(#h)'\v'-\*(#v'\s-4v\s0\v'\*(#v'\h'|\\n_u'
-.
-.\"			\" Norwegian A or angstrom
-.ds o \h'0'\k_\h'-(\\n(.wu+\w'\(de'u-\*(#h)/2u'\v'-0.4n'\z\(de\v'0.4n'\h'|\\n_u'
-.
-.\"			\" there exists, for all
-.ds qe \s-2\v'0.45m'\z\(em\v'-0.625m'\z\(em\v'-0.625m'\(em\v'0.8m'\s0\h'-0.1m'\v'-0.05m'\(br\v'0.05m'\h'0.1m'
-.ds qa \z\e\h'0.35m'\z\(sl\h'-0.33m'\v'-0.3m'\s-4\(em\s0\v'0.3m'\h'0.15m'
-.rm #h #v
-.ll 6.0i
-.lt 6.0i
-.
-.de @U
-.tm The \\$1 macro has been removed from this version of the -me macros.
-..
-.
-.de lo
-.@U lo
-..
-.
-.de th
-.@U th
-..
-.
-.de ac
-.@U ac
-..
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=nroff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_man.7.man Deleted

@@ -1,2613 +0,0 @@
-'\" t
-.TH GROFF_MAN @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_man \- GNU roff macro package for formatting man pages
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_man_C \n.C
-.cp 0
-.
-.
-.\" ====================================================================
-.\" Legal Terms
-.\" ====================================================================
-.\"
-.\" Copyright (C) 1999-2018 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.
-.\"
-.\" 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.
-.\"
-.\" 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.
-.
-.
-.\" ====================================================================
-.SH SYNOPSIS
-.\" ====================================================================
-.
-.SY "groff \-man"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
-.SY "groff \-m man"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
-.YS
-.
-.
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-The
-.I man
-macro package for
-.I groff
-is used to produce manual pages
-.\" We use an unbreakable space \~ here to keep the phrase intact for
-.\" its introduction; in subsequent discussion, that is not important.
-(\(lqman\~pages\(rq)
-like the one you are reading.
-.
-GNU
-.IR roff 's
-implementation was written by James Clark.
-.
-.
-.PP
-This document presents the macros thematically to aid learners;
-for those needing only a quick reference,
-the following table lists them alphabetically,
-with cross-references to appropriate subsections below.
-.
-.
-.PP
-.TS
-l l l.
-Macro	Meaning	Subsection
-.T&
-lB l l.
-_
-\&.B	Bold	Font style macros
-\&.BI	Bold, italic alternating	Font style macros
-\&.BR	Bold, roman alternating	Font style macros
-\&.EE	Example end	Document structure macros
-\&.EX	Example begin	Document structure macros
-\&.I	Italic	Font style macros
-\&.IB	Italic, bold alternating	Font style macros
-\&.IP	Indented paragraph	Paragraph macros
-\&.IR	Italic, roman alternating	Font style macros
-\&.LP	(Left) paragraph	Paragraph macros
-\&.ME	Mail-to end	Hyperlink and email macros
-\&.MT	Mail-to start	Hyperlink and email macros
-\&.OP	(Command-line) option	Command synopsis macros
-\&.P	Paragraph	Paragraph macros
-\&.PP	Paragraph	Paragraph macros
-\&.RB	Roman, bold alternating	Font style macros
-\&.RE	Relative-indent end	Document structure macros
-\&.RI	Roman, italic alternating	Font style macros
-\&.RS	Relative-indent start	Document structure macros
-\&.SB	Small bold	Font style macros
-\&.SH	Section heading	Document structure macros
-\&.SM	Small	Font style macros
-\&.SS	Subection heading	Document structure macros
-\&.SY	Synopsis start	Command synopsis macros
-\&.TH	Title heading	Document structure macros
-\&.TP	Tagged paragraph	Paragraph macros
-\&.TQ	Tagged paragraph continuation	Paragraph macros
-\&.UE	URL end	Hyperlink and email macros
-\&.UR	URL start	Hyperlink and email macros
-\&.YS	Synopsis end	Command synopsis macros
-.TE
-.
-.
-.PP
-Macros whose use we discourage
-.RB ( .AT ,
-.BR .BT ,
-.BR .DT ,
-.BR .HP ,
-.BR .PD ,
-.BR .PT ,
-and
-.BR .UC )
-are described in subsection \(lqDeprecated features\(rq, below.
-.
-.
-.\" ====================================================================
-.SS "Macro reference preliminaries"
-.\" ====================================================================
-.
-Each macro is described in a tagged paragraph.
-.
-Closely related macros,
-such as
-.B .EX
-and
-.BR .EE ,
-are grouped together.
-.
-.
-.PP
-Optional macro arguments are indicated by surrounding them with square
-brackets.
-.
-If a macro accepts multiple arguments,
-arguments containing whitespace must be double-quoted ("one two"),
-to be interpreted correctly.
-.
-Most macro arguments are strings that will be output as text;
-exceptions are noted.
-.
-.
-.PP
-Bear in mind that
-.I groff
-is fundamentally a programming system for typesetting.
-.
-Consequently,
-the verb \(lqto set\(rq is frequently used below in the sense \(lqto
-typeset\(rq.
-.
-.
-.\" ====================================================================
-.SS "Document structure macros"
-.\" ====================================================================
-.
-The highest level of organization of a man page is determined by this
-group of macros.
-.
-.B .TH
-(title heading) identifies the document as a man page and defines
-information enabling its indexing by
-.IR mandb (8)
-or a similar tool.
-.
-.
-Sections
-.RB ( .SH ),
-one of which is mandatory and many of which are standardized,
-facilitate quick location of relevant material by the reader and aid
-the man page writer to discuss all essential aspects of the topic.
-.
-Subsections
-.RB ( .SS )
-are optional and permit sections that grow long to develop in a
-controlled way.
-.
-Many technical discussions require examples;
-lengthy ones,
-especially those reflecting multiple lines of input to or output from
-the system,
-are usefully bracketed by
-.B .EX
-and
-.BR .EE .
-.
-When none of the foregoing meets a structural demand,
-a section of the discussion can be manually indented within
-.B .RS
-and
-.B .RE
-macros.
-.
-.
-.TP
-.BI .TH " title section"\c
-.RI " " footer-middle \c
-.RI " " footer-outside \c
-.RI " " header-middle 
-Define the title of the man page as
-.I title
-and the section as
-.IR section .
-.
-See
-.IR man (1)
-for details on the section numbers and suffixes applicable to your
-system.
-.
-.I title
-and
-.I section
-are positioned together at the left and right in the header line
-(with
-.I section
-in parentheses immediately appended to
-.IR title ).
-.
-.I footer-middle
-is centered in the footer line.
-.
-.I footer-outside
-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 header-middle
-is centered in the header line.
-.
-If
-.I section
-is a simple integer between 1 and\~9 (inclusive),
-or is exactly \(lq3p\(rq,
-there is no need to specify
-.IR header-middle ;
-the macro package will supply text for it.
-.
-.
-.IP
-For HTML output, headers and footers are completely suppressed.
-.
-.
-.IP
-Additionally, this macro starts a new page; the page number is reset
-to\~1
-(unless the
-.B \-rC1
-option is given on the command line).
-.
-This feature is intended only for formatting multiple man pages.
-.
-.
-.IP
-A man page should contain exactly one
-.B .TH
-call at or near the beginning of the file,
-prior to any other macro calls.
-.
-.
-.IP
-By convention,
-.I footer-middle
-is the most recent modification date of the man page source document,
-and
-.I footer-outside
-is the name and version or release of the project providing it.
-.
-.
-.TP
-.BR .SH " "\c
-.IR heading-text 
-Set
-.I heading-text
-as a section heading flush left.
-.
-The text following
-.B .SH
-up to the end of the line,
-or the text on the next input line if
-.B .SH
-is given no arguments,
-is set in bold
-(or the font specified by the string register
-.BR HF )
-slightly larger than the base font size.
-.
-Additionally,
-the left margin and indentation affecting subsequent text are reset to
-their default values.
-.
-Text on input lines after
-.I heading-text
-is set as a normal paragraph
-.RB ( .PP ).
-.
-.
-.IP
-The content of
-.I heading-text
-and ordering of sections has been standardized by common practice,
-as has much of the layout of material within sections.
-.
-For example,
-a section called \(lqName\(rq or \(lqNAME\(rq must exist,
-must be the first section after the
-.B .TH
-call,
-and must contain only a line of the form
-.RS \" Invisibly move left margin to current .IP indent.
-.RS \" Now indent further, visibly.
-.IR page-topic \c
-.BR , " \&.\|.\|.\&"
-.B \e\-\ \c
-.I summary-description
-.RE \" Move left margin back to .IP indentation.
-for a man page to be properly indexed.
-.
-See
-.IR man (7)
-for the conventions prevailing on your system.
-.RE \" Move left margin back to standard position.
-.
-.
-.TP
-.BR .SS " "\c
-.IR subheading-text 
-Set
-.I subheading-text
-as a subsection heading indented (by default) partway between a section
-heading and a normally-indented paragraph
-.RB ( .PP ).
-.
-The text following
-.B .SS
-up to the end of the line,
-or the text on the next input line if
-.B .SS
-is given no arguments,
-is set in bold
-(or the font specified by the string register
-.BR HF )
-at the base font size.
-.
-Additionally,
-the left margin and indentation affecting subsequent text are reset to
-their default values.
-.
-Text on input lines after
-.I subheading-text
-is set as a normal paragraph
-.RB ( .PP ).
-.
-.
-.TP
-.B .EX
-.TQ
-.B .EE
-Begin and end example.
-.
-After
-.BR .EX ,
-filling and hyphenation are disabled and a constant-width (monospaced)
-font is selected.
-.
-Calling
-.B .EE
-enables filling and restores the previous hyphenation setting and font.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.IP
-Example regions are useful for formatting code,
-shell sessions,
-and text file contents.
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.IP
-These macros are defined on many (but not all) legacy Unix systems
-running classic
-.IR troff .
-.
-To be certain your page will be portable to those systems, copy
-their definitions from the
-.I \%an\-ext.tmac
-file of a
-.I groff
-installation.
-.
-.
-.TP
-.BR .RS " "\c
-.IR indent 
-Move the left margin to the right by the value
-.IR indent ,
-if specified,
-and by a default amount otherwise;
-see subsection \(lqHorizontal and vertical spacing\(rq below.
-.
-Calls to
-.B .RS
-can be nested;
-each call increments by\~1 the indentation level used by
-.BR .RE .
-.
-The indentation level prior to any
-.B .RS
-calls is\~1.
-.
-.
-.TP
-.BR .RE " "\c
-.IR level 
-Move the left margin back to that corresponding to indentation level
-.IR level .
-.
-If no argument is given, move the left margin one level back.
-.
-.
-.\" ====================================================================
-.SS "Paragraph macros"
-.\" ====================================================================
-.
-A typical paragraph
-.RB ( .PP )
-is set at the current left margin,
-which by default is indented from the left margin of the output device.
-.
-In man pages and other technical literature,
-definition lists are frequently encountered;
-these can be set as \(lqtagged paragraphs\(rq
-.RB ( .TP
-and
-.BR .TQ ),
-which have one or more leading tags followed by a paragraph that has an
-additional left indent.
-.
-The indented paragraph
-.RB ( .IP )
-macro is useful to continue the indented content of a narrative started
-with
-.BR .TP ,
-or to present an itemized or ordered list.
-.
-.
-.TP
-.B .LP
-.TQ
-.B .PP
-.TQ
-.B .P
-Begin a new paragraph;
-these macros are synonymous.
-.
-They break the output line at the current position,
-followed by a vertical space downward by a default amount
-(which can be changed by the deprecated
-.B .PD
-macro).
-.
-The font size and style are reset to defaults;
-see subsection \(lqFont style macros\(rq below.
-.
-Finally, the left margin and indentation are reset to default values.
-.
-.
-.TP
-.BR .TP " "\c
-.IR indent 
-Set a tagged, indented paragraph.
-.
-The input line following this macro,
-known as the
-.IR tag ,
-is printed at the current left margin.
-.
-Subsequent text is indented by
-.IR indent ,
-if specified,
-and by a default amount otherwise;
-see subsection \(lqHorizontal and vertical spacing\(rq below.
-.
-.
-.IP
-If the tag is not as wide as the indentation,
-the paragraph starts on the same line as the tag,
-at the applicable indentation,
-and continues on the following lines.
-.
-Otherwise,
-the descriptive part of the paragraph begins on the line following the
-tag,
-entirely indented.
-.
-The line containing the tag can include a macro call,
-for instance to set the tag in bold with
-.BR .B .
-.
-.
-.IP
-.B .TP
-was used to write the first paragraph of this description of
-.BR .TP ,
-and
-.B .IP
-the subsequent ones.
-.
-.
-.TP
-.B .TQ
-Set an additional tag for a paragraph tagged with
-.BR .TP .
-.
-The pending output line is broken.
-.
-The tag on the input line following this macro and subsequent lines are
-handled as with
-.BR .TP .
-.
-.
-.IP
-This macro is not defined on legacy Unix systems running classic
-.IR troff .
-.
-To be certain your page will be portable to those systems,
-copy its definition from the
-.I \%an\-ext.tmac
-file of a
-.I groff
-installation.
-.
-.
-.IP
-The descriptions of
-.BR .LP ,
-.BR .PP ,
-and
-.B .P
-above were written using
-.B .TP
-and
-.BR .TQ .
-.
-.
-.TP
-.BR .IP " "\c
-.IR tag " "\c
-.RI  indent 
-Set an indented paragraph with an optional tag.
-.
-The
-.I tag
-and
-.I indent
-arguments,
-if present,
-are handled as with
-.BR .TP ,
-with the exception that the
-.I tag
-argument to
-.B .IP
-cannot include a macro call.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.IP
-Two convenient use cases for
-.B .IP
-are
-.
-.
-.RS \" Invisibly move left margin to current .IP indent.
-.RS \" Now indent further, visibly.
-.IP (1) 4n
-to start a new paragraph with the same indentation as the previous
-.B .IP
-or
-.B .TP
-paragraph,
-if no
-.I indent
-argument is given;
-and
-.
-.
-.IP (2)
-to set a paragraph with a short
-.I tag
-that is not semantically important,
-such as a bullet (\(bu)\(emobtained with the \(oq\e(bu\(cq character
-escape\(emor list enumerator,
-as seen in this very paragraph.
-.RE \" Move left margin back to .IP indentation.
-.RE \" Move left margin back to standard position.
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.\" ====================================================================
-.SS "Command synopsis macros"
-.\" ====================================================================
-.
-Command synopses are a staple of section\~1 and\~8 man pages.
-.
-These macros aid you to construct one that has the classical Unix
-appearance.
-.
-Furthermore,
-some tools are able to interpret these macros semantically and treat
-them appropriately for localization and/or presentation.
-.
-A command synopsis is wrapped in
-.BR .SY / .YS
-calls,
-with command-line options of some formats indicated by
-.BR .OP .
-.
-.
-.PP
-These macros are not defined on legacy Unix systems running classic
-.IR troff .
-.
-To be certain your page will be portable to those systems, copy
-their definitions from the
-.I \%an\-ext.tmac
-file of a
-.I groff
-installation.
-.
-.
-.TP
-.BI .SY " command"
-Begin synopsis.
-.
-Hyphenation is turned off.
-.
-The
-.I command
-argument is set in bold.
-.
-The output line is filled as normal,
-but if a break is required,
-subsequent output lines are indented by the width of
-.I command
-plus a space.
-.
-.
-.TP
-.BI .OP " option-name"\/\c
-.RI " " option-argument 
-Indicate an optional command parameter called
-.IR option-name ,
-which is set in bold.
-.
-If the option takes an argument, specify
-.I option-argument
-using a noun, abbreviation, or hyphenated noun phrase.
-.
-If present,
-.I option-argument
-is preceded by a space and set in italics.
-.
-Square brackets (in roman) surround both arguments.
-.
-.
-.TP
-.B .YS
-End synopsis.
-.
-Restore indentation and hyphenation to previous values.
-.
-.
-.PP
-Multiple
-.B .SY/.YS
-blocks can be specified,
-for instance to distinguish differing modes of operation of a complex
-command like
-.IR tar (1);
-each will be separated by a paragraph space.
-.
-.
-.PP
-.B .SY
-can also be repeated multiple times before a closing
-.BR .YS ,
-which is useful to indicate synonymous ways of invoking a particular
-mode of operation.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.PP
-For example,
-.
-.
-.IP
-.\" from src/roff/groff/groff.1.man
-.EX
-\&.SY groff
-\&.OP \e\-abcegiklpstzCEGNRSUVXZ
-\&.OP \e\-d cs
-\&.OP \e\-f fam
-\&.OP \e\-F dir
-\&.OP \e\-I dir
-\&.OP \e\-K arg
-\&.OP \e\-L arg
-\&.OP \e\-m name
-\&.OP \e\-M dir
-\&.OP \e\-n num
-\&.OP \e\-o list
-\&.OP \e\-P arg
-\&.OP \e\-r cn
-\&.OP \e\-T dev
-\&.OP \e\-w name
-\&.OP \e\-W name
-\&.RI  file
-\e&.\e|.\e|.\e&
-\&.YS
-\&.
-\&.SY groff
-\&.B \e\-h
-\&.SY groff
-\&.B \e\-\e\-help
-\&.YS
-.
-.
-.IP
-
-.EE
-.
-.
-.PP
-produces the following output.
-.
-.
-.RS
-.PP
-.SY groff
-.OP \-abcegiklpstzCEGNRSUVXZ
-.OP \-d cs
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-K arg
-.OP \-L arg
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-P arg
-.OP \-r cn
-.OP \-T dev
-.OP \-w name
-.OP \-W name
-.RI  file
-\&.\|.\|.\&
-.YS
-.
-.SY groff
-.B \-h
-.SY groff
-.B \-\-help
-.YS
-.RE
-.
-.
-.PP
-Several features of the above example are of note.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.\" TODO: Some of the normative discussion below can go there, too.
-.
-.
-.IP \(bu
-The empty request (.),
-which does nothing,
-is used for vertical spacing in the input file for readability by the
-document maintainer.
-.
-Do not put empty lines in a
-.I roff
-source document.
-.
-.
-.IP \(bu
-The command and option names are presented in
-.B bold
-to cue the user that they should be input literally.
-.
-.
-.IP \(bu
-Option dashes are specified with the \(oq\e\-\(cq escape sequence;
-this is an important practice to make them clearly visible and to
-facilitate cut-and-paste from the rendered man page to a shell prompt or
-text file.
-.
-.
-.IP \(bu
-Option arguments and command operands are presented in
-.I italics
-(underlined on some output devices, such as terminals and emulators),
-to cue the user that they must be replaced with appropriate text.
-.
-.
-.IP \(bu
-Symbols that are neither to be typed literally nor simply replaced
-appear in the roman style;
-brackets surround optional arguments,
-and an ellipsis indicates that the previous syntactical element may be
-repeated arbitrarily.
-.
-.
-.IP
-Some man pages use a brace-and-pipe notation such as
-.RB \(lq{ \-\-diff | \-\-compare }\(rq
-to indicate that one and only one of the \(oq|\(cq-separated items
-within the braces must be input.
-.
-If this braced construct is furthermore surrounded by square brackets,
-it means that at most one of the items is accepted.
-.
-.
-.IP
-Authors of man pages should note the use of the zero-width space
-escape sequence \(oq\e&\(cq on both sides of the ellipsis;
-this is a good practice to avoid surprises in the event the ellipsis
-gets refilled in your text editor.
-.
-See \(lqPortability\(rq, below.
-.
-The morbidly curious may consult
-.IR groff (7)
-regarding the narrow-space escape sequence \(oq\e|\(cq.
-.
-.
-.\" ====================================================================
-.SS "Hyperlink and email macros"
-.\" ====================================================================
-.
-Email addresses are bracketed with
-.BR .MT / .ME
-and URL hyperlinks with
-.BR .UR / .UE .
-.
-.
-.PP
-These macros are not defined on legacy Unix systems running classic
-.IR troff .
-.
-To be certain your page will be portable to those systems, copy
-their definitions from the
-.I \%an\-ext.tmac
-file of a
-.I groff
-installation.
-.
-.
-.TP
-.BI .MT " address"
-.TQ
-.BR .ME " "\c
-.IR punctuation 
-Identify
-.I address
-as an RFC 6068
-.I addr-spec
-for a \(lqmailto:\(rq URI with the text between the two macro
-calls as the link text.
-.
-A
-.I punctuation
-argument to
-.B .ME
-is placed at the end of the link text without intervening space.
-.
-Note that
-.I address
-may not be visible in the output text,
-particularly if the man page is being viewed as HTML.
-.
-On a device that is not a browser,
-.I address
-is set in angle brackets after the link text and before
-.IR punctuation .
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.IP
-When rendered by
-.I groff
-to a TTY or PostScript output device,
-.RS
-.IP
-.EX
-Contact
-\&.MT fred.foonly@\e:fubar.net
-Fred Foonly
-\&.ME
-for more information.
-.EE
-.RE
-.
-.
-.IP
-displays as: \(lqContact Fred Foonly
-\(lafred.foonly@\:fubar.net\(ra for more information.\(rq.
-.
-.
-.IP
-The use of \(oq\e:\(cq to insert hyphenless discretionary breaks is a
-.I groff
-extension and can be omitted.
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .UR " URL"
-.TQ
-.BR .UE " "\c
-.IR punctuation 
-Identify
-.I URL
-as an RFC 3986 URI hyperlink with the text between the two macro calls
-as the link text.
-.
-A
-.I punctuation
-argument to
-.B .UE
-is placed at the end of the link text without intervening space.
-.
-Note that
-.I URL
-may not be visible in the output text,
-particularly if the man page is being viewed as HTML.
-.
-On a device that is not a browser,
-.I URL
-is set in angle brackets after the link text and before
-.IR punctuation .
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.IP
-When rendered by
-.I groff
-to a TTY or PostScript output device,
-.RS
-.IP
-.EX
-The GNU Project of the Free Software Foundation hosts the
-\&.UR https://\e:www.gnu.org/\e:software/\e:groff/
-Groff home page
-\&.UE .
-.EE
-.RE
-.
-.
-.IP
-displays as: \(lqThe GNU Project of the Free Software Foundation hosts
-the Groff home page
-\(lahttps://\:www.gnu.org/\:software/\:groff/\(ra.\(rq.
-.
-.
-.IP
-The use of \(oq\e:\(cq to insert hyphenless discretionary breaks is a
-.I groff
-extension and can be omitted.
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.\" ====================================================================
-.SS "Font style macros"
-.\" ====================================================================
-.
-The
-.I man
-macro package is limited in its font styling options,
-offering only
-.BR bold \~( .B ),
-.I italic\c
-.RB \~( .I ),
-and roman (the default).
-.
-Italic text is usually set underscored instead on terminals and other
-classical
-.IR nroff -style
-output devices.
-.
-The
-.B .SM
-and
-.B .SB
-macros set text in roman or bold, respectively, at a smaller point size;
-these differ visually from regular-sized roman or bold text only on
-.IR troff -style
-output devices.
-.
-The foregoing macros cause word breaks before and after their arguments,
-but it is often necessary to set text in different styles without
-intervening whitespace.
-.
-The macros
-.BR .BI ,
-.BR .BR ,
-.BR .IB ,
-.BR .IR ,
-.BR .RB ,
-and
-.BR .RI ,
-where \(oqB\(cq, \(oqI\(cq, and \(oqR\(cq indicate bold, italic, and
-roman, respectively,
-set their odd- and even-numbered arguments in alternating styles,
-with no whitespace separating them.
-.
-.
-.PP
-Because font styles are presentational rather than semantic,
-conflicting traditions have arisen regarding which font styles should be
-used to mark file or path names,
-environment variables,
-in-line literals,
-and even man page cross-references.
-.
-.
-.PP
-The default font size and family (for
-.I troff
-output devices)
-is 10-point Times.
-.
-The default style is roman.
-.
-.
-.TP
-.BR .B \~\c
-.IR text 
-Set
-.I text
-in bold.
-.
-If the macro is given no arguments,
-the text of the next input line is set in bold.
-.
-.
-.\" BEGIN USAGE (TODO: move to tutorial/style guide when we have it)
-.IP
-Use bold
-for literal portions of syntax synopses,
-for command-line options in running text,
-and for literals that are major topics of the subject under discussion;
-for example,
-this page uses bold for macro and register names.
-.
-In
-.BR .EX / .EE
-examples of interactive I/O (such as a shell session),
-set only the user-typed input in bold.
-.
-.
-.
-.\" END USAGE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BR .I \~\c
-.IR text 
-Set
-.I text
-in italics.
-.
-If the macro is given no arguments,
-the text of the next input line is set in italics.
-.
-.
-.\" BEGIN USAGE (TODO: move to tutorial/style guide when we have it)
-.IP
-Use italics
-for file and path names,
-for environment variables,
-for enumeration or preprocessor constants in C,
-for variable (user-determined) portions of syntax synopses,
-for the first occurrence only of a technical concept being introduced,
-for names of works of software
-(including commands and functions,
-.\" The following is an interesting exception that seems to have arisen
-.\" organically and nearly universally.
-but excluding names of operating systems or their kernels),
-and anywhere a parameter requiring replacement by the user is
-encountered.
-.
-An exception involves variable text in a context that is already marked
-up in italics,
-such as file or path names with variable components;
-in such cases,
-follow the convention of mathematical typography:
-set the file or path name in italics as usual
-(see
-.B .IR
-below),
-but use roman for the variable part,
-and italics again in running roman text when referring to the variable
-material.
-.
-.
-.\" END USAGE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BR .SM \~\c
-.IR text 
-Set
-.I text
-one point size smaller than the default size.
-.
-If the macro is given no arguments,
-the text of the next input line is set smaller.
-.
-.
-.IP
-.IR Note :
-.IR nroff -style
-output devices,
-such as terminals,
-will render
-.I text
-at the normal font size instead.
-.
-Do not rely upon
-.B .SM
-to communicate semantic information distinct from using roman style at
-the normal size;
-it will be hidden from readers using such devices.
-.
-.
-.TP
-.BR .SB \~\c
-.IR text 
-Set
-.I text
-in bold,
-one point size smaller than the default size.
-.
-If the macro is given no arguments,
-the text of the next input line is set smaller and in bold.
-.
-.
-.IP
-.IR Note :
-.IR nroff -style
-output devices,
-such as terminals,
-will render
-.I text
-in bold at the normal font size instead.
-.
-Do not rely upon
-.B .SB
-to communicate semantic information distinct from using bold style at
-the normal size;
-it will be hidden from readers using such devices.
-.
-.
-.\" BEGIN USAGE (TODO: move to tutorial/style guide when we have it)
-.PP
-Note what is
-.I not
-prescribed for setting in bold or italics above:
-elements of \(lqsynopsis language\(rq such as ellipses and brackets
-around options;
-proper names and adjectives;
-titles of anything other than works of literature or software;
-identifiers for standards documents or technical reports such as
-CSTR\~#54,
-RFC\~1918,
-Unicode\~11.0,
-or
-POSIX.1-2017;
-acronyms;
-and occurrences after the first of a technical term or piece of jargon.
-.
-Again,
-the names of operating systems and their kernels are,
-by practically universal convention,
-set in roman.
-.
-.
-.PP
-Be frugal with the use of italics for emphasis,
-and particularly with the use of bold.
-.
-Brief runs of literal text,
-such as references to individual characters or short strings,
-including section and subsection headings of man pages,
-are suitable objects for quotation;
-see the
-\(oq\e(lq\(cq,
-\(oq\e(rq\(cq,
-\(oq\e(oq\(cq,
-and
-\(oq\e(cq\(cq
-escapes in subsection \(lqPortability\(rq below.
-.
-.
-.\" END USAGE (TODO: move to tutorial/style guide when we have it)
-.PP
-Unlike the above font style macros,
-the font alternation macros below accept only arguments on the same
-line as the macro call.
-.
-If whitespace is required within one of the arguments,
-first consider whether the same result could be achieved with as much
-clarity by using the single-style macros on separate input lines.
-.
-When it cannot,
-double-quote an argument with one or more embedded space characters.
-.
-Setting all three different styles within one whitespace-delimited word
-presents challenges;
-it is possible with the \(oq\ec\(cq and/or \(oq\ef\(cq escapes,
-but see subsection \(lqPortability\(rq below for caveats.
-.
-.
-.TP
-.BI .BI " bold-text italic-text"\c
-\~\&.\|.\|.\&
-Set each argument in bold and italics, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from src/roff/troff/troff.1.man
-.EX
-\&.BI \e\-r name = n
-.EE
-.RE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .BR " bold-text roman-text"\c
-\~\&.\|.\|.\&
-Set each argument in bold and roman, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from tmac/groff_ms.7.man
-.EX
-Any such change becomes effective with the first use of
-\&.BR .NH ,
-\&.I after
-the new alias is defined.
-.EE
-.RE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .IB " italic-text bold-text"\c
-\~\&.\|.\|.\&
-Set each argument in italics and bold, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from man/groff_tmac.5.man
-.EX
-All macro package files must be named
-\&.IB name .tmac
-to fully use the
-\&.I tmac
-mechanism.
-.EE
-.RE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .IR " italic-text roman-text"\c
-\~\&.\|.\|.\&
-Set each argument in italics and roman, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from man/groff_out.5.man
-.EX
-This is the first command of the
-\&.IR prologue .
-.EE
-.RE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .RB " roman-text bold-text"\c
-\~\&.\|.\|.\&
-Set each argument in roman and bold, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from src/preproc/eqn/eqn.1.man
-.EX
-Also, the statement
-\&.RB \e(oq "delim on" \e(cq
-is not handled specially.
-.RE
-.EE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.TP
-.BI .RI " roman-text italic-text"\c
-\~\&.\|.\|.\&
-Set each argument in roman and italics, alternately.
-.
-.
-.\" BEGIN EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.RS
-.IP
-.\" from contrib/mm/groff_mm.7.man
-.EX
-\&.RI  file
-\e&.\e|.\e|.\e&
-.EE
-.RE
-.
-.
-.\" END EXAMPLE (TODO: move to tutorial/style guide when we have it)
-.\" ====================================================================
-.SS "Horizontal and vertical spacing"
-.\" ====================================================================
-.
-The
-.I indent
-argument accepted by
-.BR .RS ,
-.BR .IP ,
-.BR .TP ,
-and the deprecated
-.B .HP
-is a number plus an optional scaling indicator.
-.
-If no scaling indicator is given,
-the
-.I man
-package assumes \(oqn\(cq;
-that is,
-the width of a letter \(lqn\(rq in the font current when the macro is
-called.
-.
-See section \(lqNumerical Expressions\(rq in
-.IR groff (7)
-for further details.
-.
-An indent specified in a call to
-.BR .IP ,
-.BR .TP ,
-or the deprecated
-.B .HP
-persists until
-(1) another of these macros is called with an explicit indent
-argument,
-or (2)
-.BR .SH ,
-.BR .SS ,
-or
-.B .PP
-or its synonyms is called;
-these clear the indent entirely.
-.
-.
-.PP
-Indents set by
-.B .RS
-move the left margin and persist until
-.BR .RS ,
-.BR .RE ,
-.BR .SH ,
-or
-.B .SS
-is called.
-.
-.
-The default indentation,
-exhibited by ordinary
-.B .PP
-paragraphs not within an
-.BR .RS / .RE
-relative indent,
-is 7.2n in
-.I troff
-mode and 7n in
-.I nroff
-mode.
-.
-The HTML output device is an exception;
-it ignores indentation completely.
-.
-This same indentation is used again (additively) for the defaults of
-.BR .IP ,
-.BR .TP ,
-.BR .RS ,
-and the deprecated
-.BR .HP .
-.
-Section headings
-.RB ( .SH )
-are set flush with the left margin of the output device,
-and subsection headings
-.RB ( .SS )
-are indented 3n.
-.
-.
-.PP
-Resist the temptation to mock up tabular or multi-column output with
-ASCII tab characters or the indentation arguments to
-.BR .IP ,
-.BR .TP ,
-.BR .RS ,
-or the deprecated
-.BR .HP ;
-the result may not render comprehensibly on an output device you fail to
-check,
-or which is developed in the future.
-.
-The table preprocessor
-.IR @g@tbl (@MAN1EXT@)
-can likely meet your needs.
-.
-.
-.PP
-The following macros cause a line break with the
-insertion of vertical space:
-.BR .SH ,
-.BR .SS ,
-.BR .TP ,
-.BR .TQ ,
-.B .PP
-(and its synonyms),
-.BR .IP ,
-and the deprecated
-.BR .HP .
-.
-The default inter-section and inter-paragraph spacing is 1\~line in
-.I nroff
-mode,
-and 0.4v in
-.I troff
-mode.
-.
-(The deprecated macro
-.B .PD
-can change this vertical spacing,
-but its use is discouraged.)
-.
-The macros
-.BR .RS ,
-.BR .RE ,
-.BR .EX ,
-and
-.B .EE
-also cause a break but no insertion of vertical space.
-.
-.
-.\" ====================================================================
-.SS "Number registers"
-.\" ====================================================================
-.
-Number registers are described in section \(lqOptions\(rq below.
-.
-.
-.\" ====================================================================
-.SS "String registers"
-.\" ====================================================================
-.
-The following strings are defined.
-.
-.
-.TP
-.B \e*R
-expands to the character escape for the \(lqregistered sign\(rq glyph,
-\(oq\e(rg\(cq,
-if available,
-and \(lq(Reg.)\(rq otherwise.
-.
-.
-.
-.TP
-.B \e*S
-expands to an escape setting the font size to the document default.
-.
-.
-.TP
-.B \e*(HF
-expands to the font identifier used to print headings and subheadings.
-.
-The default is \(oqB\(cq.
-.
-.
-.TP
-.B \e*(lq
-.TQ
-.B \e*(rq
-expand to the character escapes for left and right double-quotation
-marks,
-\(oq\e(lq\(cq and \(oq\e(rq\(cq, respectively.
-.
-.
-.TP
-.B \e*(Tm
-expands to the character escape for the \(lqtrade mark sign\(rq glyph,
-\(oq\e(tm\(cq,
-if available,
-and \(lq(TM)\(rq otherwise.
-.
-.
-.\" ====================================================================
-.SS "Interaction with preprocessors"
-.\" ====================================================================
-.
-When a preprocessor like
-.I @g@tbl
-or
-.I @g@eqn
-is needed,
-a hint can be given to the man page formatter by making the first line
-of a man page look like this:
-.
-.
-.PP
-.RS
-.BI "\(aq\e\(dq " word
-.RE
-.
-.
-.PP
-Note that the line starts with an apostrophe (\(aq),
-not a dot,
-and that a single space character follows the double quote.
-The
-.I word
-consists of one letter for each needed preprocessor:
-\(oqe\(cq for
-.IR @g@eqn ,
-\(oqr\(cq for
-.IR @g@refer ,
-and
-\(oqt\(cq for
-.IR @g@tbl .
-.
-Modern implementations of the
-.I man
-program interpret this first line and automatically call the right
-preprocessor(s).
-.
-.
-.PP
-The usual
-.I tbl
-and
-.I eqn
-macros for table and equation inclusion,
-.BR .TS ,
-.BR .T& ,
-.BR .TE ,
-.BR .EQ ,
-and
-.BR .EN ,
-may be used freely.
-.
-Note that
-.I nroff
-output devices are extremely limited in presentation of mathematical
-equations.
-.
-.
-.\" TODO BEGIN: move subsection to tutorial/style guide when we have it
-.\" ====================================================================
-.SS Portability
-.\" ====================================================================
-.
-The two major syntactical categories of
-.I roff
-languages are requests and escapes.
-.
-Since the
-.I man
-macros are implemented in terms of
-.I groff
-requests and escapes,
-one can,
-in principle,
-supplement the functionality of
-.I man
-with these lower-level elements where necessary.
-.
-.
-.PP
-Note,
-however,
-that using raw
-.I groff
-requests is likely to make your page render poorly on the class of
-viewers that transform it to HTML.
-.
-Some requests make implicit assumptions about things like character
-and page sizes that may not hold in an HTML environment;
-also,
-many of these viewers don't interpret the full
-.I groff
-vocabulary,
-a problem that can lead to portions of your text being silently dropped.
-.
-.
-.PP
-For portability to modern viewers,
-it is best to write your page entirely with the macros described in this
-page
-(except for the ones identified as deprecated,
-which should be avoided).
-.
-The macros we have described as extensions
-.RB ( .EX / .EE ,
-.BR .SY / .OP / .YS ,
-.BR .UR / .UE ,
-and
-.BR .MT / .ME )
-should be used with caution, as they may not yet be built in to
-some viewer that is important to your audience.
-.
-If in doubt, copy the implementation into your page\(emafter the
-.B .TH
-call and the \(lqName\(rq section,
-to accommodate timid
-.I mandb
-implementations.
-.
-.
-.PP
-Similar caveats apply to escapes.
-.
-Some escape sequences are however required for correct typesetting
-even in man pages and usually do not cause portability problems:
-.
-.
-.TP
-.B \e\(dq
-Comment.
-.
-Everything after the double-quote to the end of the input line is
-ignored.
-.
-Whole-line comments are frequently placed immediately after the empty
-request \(oq.\(cq.
-.
-.
-.TP
-.BI \e newline
-Join the next input line to the current one.
-.
-Except for the update of the input line counter (used for diagnostic
-messages and related purposes),
-a series of lines ending in backslash-newline is transparent to
-.IR groff .
-.
-Use this escape to break excessively input long lines for document
-maintenance.
-.
-.
-.TP
-.B \e\(ti
-Adjustable, non-breaking space character.
-.
-Use this escape to prevent a break inside a short phrase or between a
-numerical quantity and its corresponding unit(s).
-.
-.
-.RS
-.IP
-.EX
-Before starting the motor, set the output speed to\e\(ti1.
-There are 1,024\e\(tibytes in 1\e\(tikiB.
-CSTR\e\(ti#8 documents the B language.
-.EE
-.RE
-.
-.
-.TP
-.B \e&
-Zero-width space.
-.
-Append to an input line to prevent an end-of-sentence punctuation
-sequence from being recognized as such, or insert at the beginning of an
-input line to prevent a dot or apostrophe from being interpreted as the
-beginning of a
-.I roff
-request.
-.
-.
-.TP
-.B \e(aq
-ASCII apostrophe.
-.
-Use for syntax elements of programming languages because some
-output devices might replace unescaped apostrophes with right single
-quotation marks.
-.
-.
-.TP
-.B \e(oq
-Opening single quotation mark.
-.
-.TQ
-.B \e(cq
-Closing single quotation mark.
-.
-.
-.IP
-Use these for paired directional single quotes, \(oqlike this\(cq.
-.
-.
-.TP
-.B \e(dq
-ASCII double-quote.
-.
-Sometimes needed after macro calls to prevent the interpretation of the
-ASCII quotation mark character \(oq\(dq\(cq as the beginning or end
-of a macro argument.
-.
-.
-.TP
-.B \e(lq
-Left double quotation mark.
-.
-.TQ
-.B \e(rq
-Right double quotation mark.
-.
-.
-.IP
-Use these for paired directional double quotes, \(lqlike this\(rq.
-.
-.
-.TP
-.B \e(em
-Em-dash.
-.
-Use for an interruption in a sentence\(emsuch as this one.
-.
-.
-.TP
-.B \e(en
-En-dash.
-.
-Use to separate the two ends of a range,
-in particular between numbers,
-for example: the digits 1\(en9.
-.
-.
-.TP
-.B \e(ga
-ASCII grave accent.
-.
-Use for syntax elements of programming languages,
-for example shell command substitutions,
-because some output devices might replace unescaped grave accents with
-left single quotation marks.
-.
-.
-.TP
-.B \e(ha
-ASCII circumflex accent.
-.
-Use for syntax elements of programming languages because some output
-devices might replace unescaped circumflex accents with non-ASCII glyphs
-like the Unicode U+02C6 modifier letter circumflex.
-.
-.
-.TP
-.B \e(ti
-ASCII tilde.
-.
-Use for syntax elements of programming languages because some output
-devices might replace unescaped tildes with non-ASCII glyphs like the
-Unicode U+02DC small tilde.
-.
-.
-.TP
-.B \e\-
-Minus sign.
-.
-Also use this to display syntax elements that require the ASCII
-hyphen-minus character,
-for example command-line options and C language operators.
-.
-The unescaped \(oq\-\(cq input character is not appropriate for
-these cases because it may render as a hyphen on some output devices.
-.
-.
-.TP
-.B \ec
-.
-If this escape sequence occurs at the end of an input line, no white
-space is inserted between the last glyph on it and the first glyph
-resulting from the next input line.
-.
-This is occasionally useful when three different fonts are needed
-in a single word.
-.
-.
-.RS
-.IP
-.\" contrib/pdfmark/pdfroff.1.man
-.EX
-Normally, the final output file should be named
-\&.IB file .pdf\ec
-\e&.
-.EE
-.RE
-.
-.
-.IP
-Note that when using this trick with the
-.B .BI
-or
-.B .RI
-macros, you will need to manually add an italic correction escape
-\(oq\e/\(cq before the \(oq\ec\(cq due to way macros expand their
-arguments.
-.
-.
-.RS
-.IP
-.\" from contrib/mom/groff_mom.7.man
-.EX
-Files processed with
-\&.B groff \e\-mom
-(or
-\&.BI "\e\-m " mom\e/\ec
-) produce PostScript output by default.
-.EE
-.RE
-.
-.
-.IP
-Alternatively,
-and perhaps with better portability,
-the \(oq\ef\(cq font escape sequence can be used;
-see below.
-.
-Using \(oq\ec\(cq to include the output from more than one input line
-into the next-line argument of a
-.B .TP
-macro will render incorrectly with
-.I groff
-1.22.3,
-.I mandoc
-1.14.1,
-older versions of these programs,
-and perhaps with some other formatters.
-.
-.
-.TP
-.B \ee
-Widely used in man pages to represent a backslash output glyph.
-.
-It works reliably as long as the
-.B .ec
-request is not used,
-which should never happen in man pages,
-and it is slightly more portable than the more exact \(oq\e(rs\(cq
-(\(lqreverse solidus\(rq) escape sequence.
-.
-.
-.TP
-.BR \efB ,\  \efI ,\  \efR ,\  \efP
-Switch to bold, italic, roman, or back to the previous font,
-respectively.
-.
-Either these or \(oq\ec\(cq is needed when three different fonts are
-required in a single whitespace-delimited word.
-.
-.
-.RS
-.IP
-.\" second example from contrib/pdfmark/pdfroff.1.man
-.EX
-\&.RB  \e\-\e\-reference\e\-dictionary=\efI\e,name\e/\efP 
-.IP
-\&.RB  \e\-\e\-reference\e\-dictionary=\ec
-\&.IR name 
-.EE
-.RE
-.
-.
-.IP
-Font escapes may be more portable than \(oq\ec\(cq.
-.
-As shown above,
-it is up to you to account for italic corrections with \(oq\e/\(cq and
-\(oq\e,\(cq, which are themselves
-.I groff
-extensions,
-if desired and if supported by your implementation.
-.
-.
-.IP
-Note that
-\(oq\efP\(cq reliably returns to the style in use immediately preceding
-the previous \(oq\ef\(cq escape only if no
-sectioning,
-paragraph,
-or font face macro calls have intervened.
-.
-.
-.IP
-As long as only two fonts are needed in any single whitespace-delimited
-word,
-font alternation macros like
-.B .BI
-usually result in more readable source code than \(oq\ef\(cq escapes do.
-.
-.
-.PP
-For maximum portability, escape sequences and special characters
-not listed above are better avoided in man pages.
-.
-.
-.\" TODO END: move subsection to tutorial/style guide when we have it
-.\" ====================================================================
-.SS "Deprecated features"
-.\" ====================================================================
-.
-Use of the following is discouraged.
-.
-.
-.TP
-.BR .AT " "\c
-.IR system " " release 
-Alter the footer for use with AT&T man pages,
-overriding any definition of the
-.I footer-outside
-argument to
-.BR .TH .
-.
-This macro exists only for compatibility; don't use it.
-.
-.
-.IP
-The first argument
-.I system
-can be:
-.
-.
-.RS \" Invisibly move left margin to current .IP indent.
-.RS \" Now indent further, visibly.
-.TP
-3
-7th edition
-.I (default)
-.
-.
-.TP
-4
-System III
-.
-.
-.TP
-5
-System V
-.RE \" Move left margin back to .IP indentation.
-.RE \" Move left margin back to standard position.
-.
-.
-.IP
-The optional second argument
-.I release
-specifies the release number,
-such as in \(lqSystem V Release 3\(rq.
-.
-.
-.TP
-.B .BT
-Set the page footer.
-.
-Redefine this macro to get control of the footer.
-.
-.
-.TP
-.B .DT
-Set tabs every 0.5\~inches.
-.
-Since this macro is always called during a
-.B .TH
-macro, it makes sense to call it only if the tab positions have been
-changed.
-.
-.
-.IP
-Use of this presentation-level macro is deprecated.
-.
-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
-to express are likely to be lost.
-.
-If you feel tempted to use it, you should probably be composing a
-table using
-.IR @g@tbl (@MAN1EXT@)
-markup instead.
-.
-.
-.TP
-.BR .HP " "\c
-.IR indent 
-Set up a paragraph with a hanging left indentation.
-.
-The
-.I indent
-argument,
-if present,
-is handled as with
-.BR .TP .
-.
-.
-.IP
-Use of this presentation-level macro is deprecated.
-.
-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.
-.
-Thus, any information or distinction you tried to express with the
-indentation may be lost.
-.
-.
-.TP
-.BR .PD " "\c
-.IR vertical-space 
-Define the vertical space between paragraphs or (sub)sections.
-.
-The optional argument
-.I vertical-space
-specifies the amount of space;
-the default scaling is \(oqv\(cq).
-.
-Without an argument,
-the spacing is reset to its default value;
-see \(lqHorizontal and vertical spacing\(rq above.
-.
-.
-.IP
-Use of this presentation-level macro is deprecated.
-.
-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
-to express are likely to be lost.
-.
-.
-.TP
-.B .PT
-Set the page header.
-.
-Redefine this macro to get control of the header.
-.
-.
-.TP
-.BR .UC " "\c
-.IR version 
-Alter the footer for use with BSD man pages,
-overriding any definition of the
-.I footer-outside
-argument to
-.BR .TH .
-.
-This macro exists only for compatibility; don't use it.
-.
-.
-.IP
-The argument
-.I version
-can be:
-.
-.
-.RS \" Invisibly move left margin to current .IP indent.
-.RS \" Now indent further, visibly.
-.TP
-3
-3rd Berkeley Distribution
-.I (default)
-.
-.
-.TP
-4
-4th Berkeley Distribution
-.
-.
-.TP
-5
-4.2 Berkeley Distribution
-.
-.
-.TP
-6
-4.3 Berkeley Distribution
-.
-.
-.TP
-7
-4.4 Berkeley Distribution
-.RE \" Move left margin back to .IP indentation.
-.RE \" Move left margin back to standard position.
-.
-.
-.\" ====================================================================
-.SS "History"
-.\" ====================================================================
-.
-According to its own
-.IR man (7)
-page,
-Version 7 Unix (1979) supported all of the macros described in this page
-not listed as GNU extensions,
-except
-.BR .P ,
-.BR .SB ,
-.BR .SS ,
-and the deprecated
-.BR .AT ,
-.BR .BT ,
-.BR .PT ,
-and
-.BR .UC .
-.
-The only string registers defined were
-.B R
-and
-.BR S ;
-no number registers were documented.
-.
-.
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-The following
-.I groff
-options set number registers recognized and used by the
-.I man
-macro package.
-.
-.
-.TP
-.B \-rcR=1
-Continuous rendering.
-.
-Create a single,
-very long page instead of multiple pages.
-.
-This is the default in
-.I nroff
-mode.
-.
-Use
-.B \-rcR=0
-to disable it.
-.
-.
-.TP
-.B \-rC1
-Number pages continuously.
-.
-If more than one man page is given on the command line, number the
-pages continuously, rather than starting each at\~1.
-.
-.
-.TP
-.B \-rD1
-Enable double-sided printing.
-.
-Footers for even and odd pages are formatted differently;
-see the description of
-.B .TH
-in \(lqDocument structure macros\(rq,
-above.
-.
-.
-.TP
-.BI \-rFT= footer-distance
-Set distance of the footer,
-relative to the bottom of the page if negative or relative to the top if
-positive,
-to
-.IR footer-distance .
-.
-The default is \-0.5i.
-.
-.
-.TP
-.BI \-rHY= flags
-Set hyphenation flags.
-.
-Permissible values of
-.I flags
-are documented in section \(lqHyphenation\(rq of
-.IR groff (7).
-.
-The default is\~4 if continuous rendering is enabled
-.RB ( \-rcR=1
-above),
-and\~6 otherwise.
-.
-.
-.TP
-.BI \-rIN= indent
-Set the body text indentation (for normal paragraphs) to
-.IR indent .
-.
-See \(lqHorizontal and vertical spacing\(rq above for the default
-indentation value.
-.
-For
-.IR nroff ,
-.I indent
-should always be an integer multiple of unit \(oqn\(cq to get consistent
-indentation.
-.
-.
-.TP
-.BI \-rLL= line-length
-Set line length.
-.
-If this option is not given, the line length is set to respect any
-value set by a prior \(lq.ll\(rq request (which
-.I must
-be in effect when the
-.B .TH
-macro is invoked),
-if this differs from the built-in default for the formatter;
-otherwise it defaults to 78n in
-.I nroff
-mode and 6.5i in
-.I troff
-mode.
-.
-.
-.IP
-Note that the use of a \(lq.ll\(rq request to initialize the line
-length is supported for backward compatibility with some versions of
-the
-.I man
-program;
-direct initialization of the
-.B LL
-register should
-.I always
-be preferred to the use of such a request.
-.
-In particular, note that a \(lq.ll\~65n\(rq request does
-.I not
-preserve the normal
-.I nroff
-default line length
-(the
-.I man
-default initialization to 78n prevails),
-whereas the
-.B \-rLL=65n
-option,
-or an equivalent \(lq.nr\~LL\~65n\(rq request preceding the use of the
-.B .TH
-macro,
-.I does
-set a line length of 65n.
-.
-.
-.TP
-.BI \-rLT= title-length
-Set title length.
-.
-If this option is not given, the title length defaults to the line
-length.
-.
-.
-.TP
-.BI \-rP n
-Start enumeration of pages at
-.I n
-rather than\~1.
-.
-.
-.TP
-.BI \-rS point-size
-Use
-.I point-size
-as the base document font size.
-.
-Acceptable values are 10, 11, or 12.
-.
-See subsection \(lqFont style macros\(rq above for the default.
-.
-.
-.TP
-.BI \-rSN= subsection-indent
-Set subsection indentation to
-.IR subsection-indent .
-.
-See \(lqHorizontal and vertical spacing\(rq above for the default
-indentation value.
-.
-.
-.TP
-.BI \-rX p
-After
-.RI page " p" ,
-number pages as
-.IR p a,
-.IR p b,
-.IR p c,
-and so forth.
-.
-For example, the option
-.B \-rX2
-produces the following page
-numbers: 1, 2, 2a, 2b, 2c, and so on.
-.
-.
-.\" ====================================================================
-.SH FILES
-.\" ====================================================================
-.
-.TP
-.I @MACRODIR@/\:man.tmac
-.TQ
-.I @MACRODIR@/\:an.tmac
-These are wrapper files to call
-.IR andoc.tmac .
-.
-.
-.TP
-.I @MACRODIR@/\:andoc.tmac
-This brief
-.I groff
-program detects whether the
-.I man
-or
-.I mdoc
-macro package is being used by a document and loads the correct macro
-definitions,
-taking advantage of the fact that pages using them must call
-.B .TH
-or
-.BR .Dd ,
-respectively,
-as their first macro.
-.
-Because the wrappers above load this file,
-a
-.I man
-program or user typing,
-for example,
-\(lqgroff \-man page.1\(rq,
-need not know which package the file
-.I page.1
-uses.
-.
-Multiple man pages, in either format, can be handled.
-.
-.
-.TP
-.I @MACRODIR@/\:an\-old.tmac
-Most
-.I man
-macros are contained in this file.
-.
-It also loads the GNU extensions from
-.I an\-ext.tmac
-(see below).
-.
-.
-.TP
-.I @MACRODIR@/\:an\-ext.tmac
-The extension macro definitions for
-.BR .SY ,
-.BR .OP ,
-.BR .YS ,
-.BR .TQ ,
-.BR .EX / .EE ,
-.BR .UR / .UE ,
-and
-.BR .MT / .ME
-are contained in this file,
-which is written in classic
-.I troff
-and permissively licensed\(emnot copylefted.
-.
-Man page authors concerned about portability to legacy Unix systems are
-encouraged to copy these definitions into their pages,
-and maintainers of
-.I troff
-implementations or work-alike systems that format man pages are
-encouraged to re-use them.
-.
-.
-.IP
-Note that the definitions for these macros are read after the call of
-.BR .TH ,
-so they will replace any macros of the same names preceding it in your
-file.
-.
-If you use your own implementations of these macros,
-they must be defined after calling
-.B .TH
-to have any effect.
-.
-.
-.TP
-.I @LOCALMACRODIR@/\:man.local
-Local changes and customizations should be put into this file.
-.
-.
-.\" ====================================================================
-.SH NOTES
-.\" ====================================================================
-.
-Some tips on troubleshooting your man pages follow.
-.
-.
-.TP
-.RB \(bu " .RS" " doesn't indent relative to my indented paragraph"
-The
-.B .RS
-macro sets the indentation relative to the amount of a
-.I normal
-paragraph
-.RB ( .PP
-and its synonyms).
-.
-The same default indentation amount is used for
-.BR .RS ,
-.BR .IP ,
-.BR .TP ,
-and the deprecated
-.BR .HP .
-.
-If you need to start an indent relative to an indented paragraph,
-call
-.B .RS
-repeatedly until an acceptable indentation is achieved,
-or give
-.B .RS
-an indentation argument that is at least as much as the paragraph's
-indentation amount relative to an adjacent
-.B .PP
-paragraph.
-.
-See \(lqHorizontal and vertical spacing\(rq above for the values.
-.
-.
-.TP
-.RB \(bu " .RE" " doesn't reset the indent to the expected level"
-.TQ
-\(bu warning: scale indicator invalid in this context
-.TQ
-\(bu warning: number register \(aqan\-saved\-margin\c
-.IR n "\(aq not defined"
-.TQ
-\(bu warning: number register 'an\-saved\-prevailing\-indent\c
-.IR n "\(aq not defined"
-The
-.B .RS
-macro takes an indentation
-.I amount
-as an argument;
-the
-.B .RE
-macro's argument is a specific indentation
-.IR level .
-.B .RE\~1
-goes to the level before any
-.B .RS
-macros were called,
-.B .RE\~2
-goes to the level of the first
-.B .RS
-call you made,
-and so forth.
-.
-If you desire symmetry in your macro calls,
-simply issue one
-.B .RE
-without an argument
-for each
-.B .RS
-that precedes it.
-.
-.
-.IP
-After calls to the
-.B .SH
-and
-.B .SS
-sectioning macros,
-all relative indents are cleared and calls to
-.B .RE
-have no effect.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.
-The GNU version of the
-.I man
-macro package was written by James Clark and contributors.
-.
-The extension macros were written by
-.MT wl@\:gnu.org
-Werner Lemberg
-.ME
-and
-.MT esr@\:thyrsus.com
-Eric S.\& Raymond
-.ME .
-.
-.
-.PP
-This document was originally written for the Debian GNU/Linux system by
-.MT sgk@\:debian.org
-Susan G.\& Kleinmann
-.ME .
-.
-It was corrected and updated by Werner Lemberg and G.\& Branden
-Robinson.
-.
-The extension macros were documented by Eric S.\& Raymond;
-he also originated the portability section,
-to which Ingo Schwarze contributed most of the material on escape
-sequences.
-.
-.
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.
-.IR "Groff: The GNU Implementation of troff" ,
-by Trent A.\& Fisher and Werner Lemberg,
-is the main
-.I groff
-documentation.
-.
-You can browse it interactively with \(lqinfo groff\(rq.
-.
-.
-.PP
-.IR @g@tbl (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
-and
-.IR @g@refer (@MAN1EXT@)
-are preprocessors used with man pages.
-.
-.
-.PP
-.IR man (1)
-describes the man page formatter on your system.
-.
-.
-.PP
-.IR groff_mdoc (@MAN7EXT@)
-describes the
-.I groff
-version of the BSD-originated alternative macro package for man pages.
-.
-.
-.PP
-.IR groff (@MAN7EXT@),
-.IR groff_char (@MAN7EXT@),
-.IR man (7)
-.
-.
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_man_C
-.
-.
-.\" ====================================================================
-.\" ### Emacs settings:
-.\" Local Variables:
-.\" mode: nroff
-.\" fill-column: 72
-.\" End:
-.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.us Deleted

@@ -1,4478 +0,0 @@
-% The Plain TeX hyphenation tables NOT TO BE CHANGED IN ANY WAY!
-% Unlimited copying and redistribution of this file are permitted as
-% long as this file is not modified.  Modifications are permitted, but
-% only if the resulting file is not named hyphen.tex.
-\patterns{ % just type <return> if you're not using INITEX
-.ach4
-.ad4der
-.af1t
-.al3t
-.am5at
-.an5c
-.ang4
-.ani5m
-.ant4
-.an3te
-.anti5s
-.ar5s
-.ar4tie
-.ar4ty
-.as3c
-.as1p
-.as1s
-.aster5
-.atom5
-.au1d
-.av4i
-.awn4
-.ba4g
-.ba5na
-.bas4e
-.ber4
-.be5ra
-.be3sm
-.be5sto
-.bri2
-.but4ti
-.cam4pe
-.can5c
-.capa5b
-.car5ol
-.ca4t
-.ce4la
-.ch4
-.chill5i
-.ci2
-.cit5r
-.co3e
-.co4r
-.cor5ner
-.de4moi
-.de3o
-.de3ra
-.de3ri
-.des4c
-.dictio5
-.do4t
-.du4c
-.dumb5
-.earth5
-.eas3i
-.eb4
-.eer4
-.eg2
-.el5d
-.el3em
-.enam3
-.en3g
-.en3s
-.eq5ui5t
-.er4ri
-.es3
-.eu3
-.eye5
-.fes3
-.for5mer
-.ga2
-.ge2
-.gen3t4
-.ge5og
-.gi5a
-.gi4b
-.go4r
-.hand5i
-.han5k
-.he2
-.hero5i
-.hes3
-.het3
-.hi3b
-.hi3er
-.hon5ey
-.hon3o
-.hov5
-.id4l
-.idol3
-.im3m
-.im5pin
-.in1
-.in3ci
-.ine2
-.in2k
-.in3s
-.ir5r
-.is4i
-.ju3r
-.la4cy
-.la4m
-.lat5er
-.lath5
-.le2
-.leg5e
-.len4
-.lep5
-.lev1
-.li4g
-.lig5a
-.li2n
-.li3o
-.li4t
-.mag5a5
-.mal5o
-.man5a
-.mar5ti
-.me2
-.mer3c
-.me5ter
-.mis1
-.mist5i
-.mon3e
-.mo3ro
-.mu5ta
-.muta5b
-.ni4c
-.od2
-.odd5
-.of5te
-.or5ato
-.or3c
-.or1d
-.or3t
-.os3
-.os4tl
-.oth3
-.out3
-.ped5al
-.pe5te
-.pe5tit
-.pi4e
-.pio5n
-.pi2t
-.pre3m
-.ra4c
-.ran4t
-.ratio5na
-.ree2
-.re5mit
-.res2
-.re5stat
-.ri4g
-.rit5u
-.ro4q
-.ros5t
-.row5d
-.ru4d
-.sci3e
-.self5
-.sell5
-.se2n
-.se5rie
-.sh2
-.si2
-.sing4
-.st4
-.sta5bl
-.sy2
-.ta4
-.te4
-.ten5an
-.th2
-.ti2
-.til4
-.tim5o5
-.ting4
-.tin5k
-.ton4a
-.to4p
-.top5i
-.tou5s
-.trib5ut
-.un1a
-.un3ce
-.under5
-.un1e
-.un5k
-.un5o
-.un3u
-.up3
-.ure3
-.us5a
-.ven4de
-.ve5ra
-.wil5i
-.ye4
-4ab.
-a5bal
-a5ban
-abe2
-ab5erd
-abi5a
-ab5it5ab
-ab5lat
-ab5o5liz
-4abr
-ab5rog
-ab3ul
-a4car
-ac5ard
-ac5aro
-a5ceou
-ac1er
-a5chet
-4a2ci
-a3cie
-ac1in
-a3cio
-ac5rob
-act5if
-ac3ul
-ac4um
-a2d
-ad4din
-ad5er.
-2adi
-a3dia
-ad3ica
-adi4er
-a3dio
-a3dit
-a5diu
-ad4le
-ad3ow
-ad5ran
-ad4su
-4adu
-a3duc
-ad5um
-ae4r
-aeri4e
-a2f
-aff4
-a4gab
-aga4n
-ag5ell
-age4o
-4ageu
-ag1i
-4ag4l
-ag1n
-a2go
-3agog
-ag3oni
-a5guer
-ag5ul
-a4gy
-a3ha
-a3he
-ah4l
-a3ho
-ai2
-a5ia
-a3ic.
-ai5ly
-a4i4n
-ain5in
-ain5o
-ait5en
-a1j
-ak1en
-al5ab
-al3ad
-a4lar
-4aldi
-2ale
-al3end
-a4lenti
-a5le5o
-al1i
-al4ia.
-ali4e
-al5lev
-4allic
-4alm
-a5log.
-a4ly.
-4alys
-5a5lyst
-5alyt
-3alyz
-4ama
-am5ab
-am3ag
-ama5ra
-am5asc
-a4matis
-a4m5ato
-am5era
-am3ic
-am5if
-am5ily
-am1in
-ami4no
-a2mo
-a5mon
-amor5i
-amp5en
-a2n
-an3age
-3analy
-a3nar
-an3arc
-anar4i
-a3nati
-4and
-ande4s
-an3dis
-an1dl
-an4dow
-a5nee
-a3nen
-an5est.
-a3neu
-2ang
-ang5ie
-an1gl
-a4n1ic
-a3nies
-an3i3f
-an4ime
-a5nimi
-a5nine
-an3io
-a3nip
-an3ish
-an3it
-a3niu
-an4kli
-5anniz
-ano4
-an5ot
-anoth5
-an2sa
-an4sco
-an4sn
-an2sp
-ans3po
-an4st
-an4sur
-antal4
-an4tie
-4anto
-an2tr
-an4tw
-an3ua
-an3ul
-a5nur
-4ao
-apar4
-ap5at
-ap5ero
-a3pher
-4aphi
-a4pilla
-ap5illar
-ap3in
-ap3ita
-a3pitu
-a2pl
-apoc5
-ap5ola
-apor5i
-apos3t
-aps5es
-a3pu
-aque5
-2a2r
-ar3act
-a5rade
-ar5adis
-ar3al
-a5ramete
-aran4g
-ara3p
-ar4at
-a5ratio
-ar5ativ
-a5rau
-ar5av4
-araw4
-arbal4
-ar4chan
-ar5dine
-ar4dr
-ar5eas
-a3ree
-ar3ent
-a5ress
-ar4fi
-ar4fl
-ar1i
-ar5ial
-ar3ian
-a3riet
-ar4im
-ar5inat
-ar3io
-ar2iz
-ar2mi
-ar5o5d
-a5roni
-a3roo
-ar2p
-ar3q
-arre4
-ar4sa
-ar2sh
-4as.
-as4ab
-as3ant
-ashi4
-a5sia.
-a3sib
-a3sic
-5a5si4t
-ask3i
-as4l
-a4soc
-as5ph
-as4sh
-as3ten
-as1tr
-asur5a
-a2ta
-at3abl
-at5ac
-at3alo
-at5ap
-ate5c
-at5ech
-at3ego
-at3en.
-at3era
-ater5n
-a5terna
-at3est
-at5ev
-4ath
-ath5em
-a5then
-at4ho
-ath5om
-4ati.
-a5tia
-at5i5b
-at1ic
-at3if
-ation5ar
-at3itu
-a4tog
-a2tom
-at5omiz
-a4top
-a4tos
-a1tr
-at5rop
-at4sk
-at4tag
-at5te
-at4th
-a2tu
-at5ua
-at5ue
-at3ul
-at3ura
-a2ty
-au4b
-augh3
-au3gu
-au4l2
-aun5d
-au3r
-au5sib
-aut5en
-au1th
-a2va
-av3ag
-a5van
-ave4no
-av3era
-av5ern
-av5ery
-av1i
-avi4er
-av3ig
-av5oc
-a1vor
-3away
-aw3i
-aw4ly
-aws4
-ax4ic
-ax4id
-ay5al
-aye4
-ays4
-azi4er
-azz5i
-5ba.
-bad5ger
-ba4ge
-bal1a
-ban5dag
-ban4e
-ban3i
-barbi5
-bari4a
-bas4si
-1bat
-ba4z
-2b1b
-b2be
-b3ber
-bbi4na
-4b1d
-4be.
-beak4
-beat3
-4be2d
-be3da
-be3de
-be3di
-be3gi
-be5gu
-1bel
-be1li
-be3lo
-4be5m
-be5nig
-be5nu
-4bes4
-be3sp
-be5str
-3bet
-bet5iz
-be5tr
-be3tw
-be3w
-be5yo
-2bf
-4b3h
-bi2b
-bi4d
-3bie
-bi5en
-bi4er
-2b3if
-1bil
-bi3liz
-bina5r4
-bin4d
-bi5net
-bi3ogr
-bi5ou
-bi2t
-3bi3tio
-bi3tr
-3bit5ua
-b5itz
-b1j
-bk4
-b2l2
-blath5
-b4le.
-blen4
-5blesp
-b3lis
-b4lo
-blun4t
-4b1m
-4b3n
-bne5g
-3bod
-bod3i
-bo4e
-bol3ic
-bom4bi
-bon4a
-bon5at
-3boo
-5bor.
-4b1ora
-bor5d
-5bore
-5bori
-5bos4
-b5ota
-both5
-bo4to
-bound3
-4bp
-4brit
-broth3
-2b5s2
-bsor4
-2bt
-bt4l
-b4to
-b3tr
-buf4fer
-bu4ga
-bu3li
-bumi4
-bu4n
-bunt4i
-bu3re
-bus5ie
-buss4e
-5bust
-4buta
-3butio
-b5uto
-b1v
-4b5w
-5by.
-bys4
-1ca
-cab3in
-ca1bl
-cach4
-ca5den
-4cag4
-2c5ah
-ca3lat
-cal4la
-call5in
-4calo
-can5d
-can4e
-can4ic
-can5is
-can3iz
-can4ty
-cany4
-ca5per
-car5om
-cast5er
-cas5tig
-4casy
-ca4th
-4cativ
-cav5al
-c3c
-ccha5
-cci4a
-ccompa5
-ccon4
-ccou3t
-2ce.
-4ced.
-4ceden
-3cei
-5cel.
-3cell
-1cen
-3cenc
-2cen4e
-4ceni
-3cent
-3cep
-ce5ram
-4cesa
-3cessi
-ces5si5b
-ces5t
-cet4
-c5e4ta
-cew4
-2ch
-4ch.
-4ch3ab
-5chanic
-ch5a5nis
-che2
-cheap3
-4ched
-che5lo
-3chemi
-ch5ene
-ch3er.
-ch3ers
-4ch1in
-5chine.
-ch5iness
-5chini
-5chio
-3chit
-chi2z
-3cho2
-ch4ti
-1ci
-3cia
-ci2a5b
-cia5r
-ci5c
-4cier
-5cific.
-4cii
-ci4la
-3cili
-2cim
-2cin
-c4ina
-3cinat
-cin3em
-c1ing
-c5ing.
-5cino
-cion4
-4cipe
-ci3ph
-4cipic
-4cista
-4cisti
-2c1it
-cit3iz
-5ciz
-ck1
-ck3i
-1c4l4
-4clar
-c5laratio
-5clare
-cle4m
-4clic
-clim4
-cly4
-c5n
-1co
-co5ag
-coe2
-2cog
-co4gr
-coi4
-co3inc
-col5i
-5colo
-col3or
-com5er
-con4a
-c4one
-con3g
-con5t
-co3pa
-cop3ic
-co4pl
-4corb
-coro3n
-cos4e
-cov1
-cove4
-cow5a
-coz5e
-co5zi
-c1q
-cras5t
-5crat.
-5cratic
-cre3at
-5cred
-4c3reta
-cre4v
-cri2
-cri5f
-c4rin
-cris4
-5criti
-cro4pl
-crop5o
-cros4e
-cru4d
-4c3s2
-2c1t
-cta4b
-ct5ang
-c5tant
-c2te
-c3ter
-c4ticu
-ctim3i
-ctu4r
-c4tw
-cud5
-c4uf
-c4ui
-cu5ity
-5culi
-cul4tis
-3cultu
-cu2ma
-c3ume
-cu4mi
-3cun
-cu3pi
-cu5py
-cur5a4b
-cu5ria
-1cus
-cuss4i
-3c4ut
-cu4tie
-4c5utiv
-4cutr
-1cy
-cze4
-1d2a
-5da.
-2d3a4b
-dach4
-4daf
-2dag
-da2m2
-dan3g
-dard5
-dark5
-4dary
-3dat
-4dativ
-4dato
-5dav4
-dav5e
-5day
-d1b
-d5c
-d1d4
-2de.
-deaf5
-deb5it
-de4bon
-decan4
-de4cil
-de5com
-2d1ed
-4dee.
-de5if
-deli4e
-del5i5q
-de5lo
-d4em
-5dem.
-3demic
-dem5ic.
-de5mil
-de4mons
-demor5
-1den
-de4nar
-de3no
-denti5f
-de3nu
-de1p
-de3pa
-depi4
-de2pu
-d3eq
-d4erh
-5derm
-dern5iz
-der5s
-des2
-d2es.
-de1sc
-de2s5o
-des3ti
-de3str
-de4su
-de1t
-de2to
-de1v
-dev3il
-4dey
-4d1f
-d4ga
-d3ge4t
-dg1i
-d2gy
-d1h2
-5di.
-1d4i3a
-dia5b
-di4cam
-d4ice
-3dict
-3did
-5di3en
-d1if
-di3ge
-di4lato
-d1in
-1dina
-3dine.
-5dini
-di5niz
-1dio
-dio5g
-di4pl
-dir2
-di1re
-dirt5i
-dis1
-5disi
-d4is3t
-d2iti
-1di1v
-d1j
-d5k2
-4d5la
-3dle.
-3dled
-3dles.
-4dless
-2d3lo
-4d5lu
-2dly
-d1m
-4d1n4
-1do
-3do.
-do5de
-5doe
-2d5of
-d4og
-do4la
-doli4
-do5lor
-dom5iz
-do3nat
-doni4
-doo3d
-dop4p
-d4or
-3dos
-4d5out
-do4v
-3dox
-d1p
-1dr
-drag5on
-4drai
-dre4
-drea5r
-5dren
-dri4b
-dril4
-dro4p
-4drow
-5drupli
-4dry
-2d1s2
-ds4p
-d4sw
-d4sy
-d2th
-1du
-d1u1a
-du2c
-d1uca
-duc5er
-4duct.
-4ducts
-du5el
-du4g
-d3ule
-dum4be
-du4n
-4dup
-du4pe
-d1v
-d1w
-d2y
-5dyn
-dy4se
-dys5p
-e1a4b
-e3act
-ead1
-ead5ie
-ea4ge
-ea5ger
-ea4l
-eal5er
-eal3ou
-eam3er
-e5and
-ear3a
-ear4c
-ear5es
-ear4ic
-ear4il
-ear5k
-ear2t
-eart3e
-ea5sp
-e3ass
-east3
-ea2t
-eat5en
-eath3i
-e5atif
-e4a3tu
-ea2v
-eav3en
-eav5i
-eav5o
-2e1b
-e4bel.
-e4bels
-e4ben
-e4bit
-e3br
-e4cad
-ecan5c
-ecca5
-e1ce
-ec5essa
-ec2i
-e4cib
-ec5ificat
-ec5ifie
-ec5ify
-ec3im
-eci4t
-e5cite
-e4clam
-e4clus
-e2col
-e4comm
-e4compe
-e4conc
-e2cor
-ec3ora
-eco5ro
-e1cr
-e4crem
-ec4tan
-ec4te
-e1cu
-e4cul
-ec3ula
-2e2da
-4ed3d
-e4d1er
-ede4s
-4edi
-e3dia
-ed3ib
-ed3ica
-ed3im
-ed1it
-edi5z
-4edo
-e4dol
-edon2
-e4dri
-e4dul
-ed5ulo
-ee2c
-eed3i
-ee2f
-eel3i
-ee4ly
-ee2m
-ee4na
-ee4p1
-ee2s4
-eest4
-ee4ty
-e5ex
-e1f
-e4f3ere
-1eff
-e4fic
-5efici
-efil4
-e3fine
-ef5i5nite
-3efit
-efor5es
-e4fuse.
-4egal
-eger4
-eg5ib
-eg4ic
-eg5ing
-e5git5
-eg5n
-e4go.
-e4gos
-eg1ul
-e5gur
-5egy
-e1h4
-eher4
-ei2
-e5ic
-ei5d
-eig2
-ei5gl
-e3imb
-e3inf
-e1ing
-e5inst
-eir4d
-eit3e
-ei3th
-e5ity
-e1j
-e4jud
-ej5udi
-eki4n
-ek4la
-e1la
-e4la.
-e4lac
-elan4d
-el5ativ
-e4law
-elaxa4
-e3lea
-el5ebra
-5elec
-e4led
-el3ega
-e5len
-e4l1er
-e1les
-el2f
-el2i
-e3libe
-e4l5ic.
-el3ica
-e3lier
-el5igib
-e5lim
-e4l3ing
-e3lio
-e2lis
-el5ish
-e3liv3
-4ella
-el4lab
-ello4
-e5loc
-el5og
-el3op.
-el2sh
-el4ta
-e5lud
-el5ug
-e4mac
-e4mag
-e5man
-em5ana
-em5b
-e1me
-e2mel
-e4met
-em3ica
-emi4e
-em5igra
-em1in2
-em5ine
-em3i3ni
-e4mis
-em5ish
-e5miss
-em3iz
-5emniz
-emo4g
-emoni5o
-em3pi
-e4mul
-em5ula
-emu3n
-e3my
-en5amo
-e4nant
-ench4er
-en3dic
-e5nea
-e5nee
-en3em
-en5ero
-en5esi
-en5est
-en3etr
-e3new
-en5ics
-e5nie
-e5nil
-e3nio
-en3ish
-en3it
-e5niu
-5eniz
-4enn
-4eno
-eno4g
-e4nos
-en3ov
-en4sw
-ent5age
-4enthes
-en3ua
-en5uf
-e3ny.
-4en3z
-e5of
-eo2g
-e4oi4
-e3ol
-eop3ar
-e1or
-eo3re
-eo5rol
-eos4
-e4ot
-eo4to
-e5out
-e5ow
-e2pa
-e3pai
-ep5anc
-e5pel
-e3pent
-ep5etitio
-ephe4
-e4pli
-e1po
-e4prec
-ep5reca
-e4pred
-ep3reh
-e3pro
-e4prob
-ep4sh
-ep5ti5b
-e4put
-ep5uta
-e1q
-equi3l
-e4q3ui3s
-er1a
-era4b
-4erand
-er3ar
-4erati.
-2erb
-er4bl
-er3ch
-er4che
-2ere.
-e3real
-ere5co
-ere3in
-er5el.
-er3emo
-er5ena
-er5ence
-4erene
-er3ent
-ere4q
-er5ess
-er3est
-eret4
-er1h
-er1i
-e1ria4
-5erick
-e3rien
-eri4er
-er3ine
-e1rio
-4erit
-er4iu
-eri4v
-e4riva
-er3m4
-er4nis
-4ernit
-5erniz
-er3no
-2ero
-er5ob
-e5roc
-ero4r
-er1ou
-er1s
-er3set
-ert3er
-4ertl
-er3tw
-4eru
-eru4t
-5erwau
-e1s4a
-e4sage.
-e4sages
-es2c
-e2sca
-es5can
-e3scr
-es5cu
-e1s2e
-e2sec
-es5ecr
-es5enc
-e4sert.
-e4serts
-e4serva
-4esh
-e3sha
-esh5en
-e1si
-e2sic
-e2sid
-es5iden
-es5igna
-e2s5im
-es4i4n
-esis4te
-esi4u
-e5skin
-es4mi
-e2sol
-es3olu
-e2son
-es5ona
-e1sp
-es3per
-es5pira
-es4pre
-2ess
-es4si4b
-estan4
-es3tig
-es5tim
-4es2to
-e3ston
-2estr
-e5stro
-estruc5
-e2sur
-es5urr
-es4w
-eta4b
-eten4d
-e3teo
-ethod3
-et1ic
-e5tide
-etin4
-eti4no
-e5tir
-e5titio
-et5itiv
-4etn
-et5ona
-e3tra
-e3tre
-et3ric
-et5rif
-et3rog
-et5ros
-et3ua
-et5ym
-et5z
-4eu
-e5un
-e3up
-eu3ro
-eus4
-eute4
-euti5l
-eu5tr
-eva2p5
-e2vas
-ev5ast
-e5vea
-ev3ell
-evel3o
-e5veng
-even4i
-ev1er
-e5verb
-e1vi
-ev3id
-evi4l
-e4vin
-evi4v
-e5voc
-e5vu
-e1wa
-e4wag
-e5wee
-e3wh
-ewil5
-ew3ing
-e3wit
-1exp
-5eyc
-5eye.
-eys4
-1fa
-fa3bl
-fab3r
-fa4ce
-4fag
-fain4
-fall5e
-4fa4ma
-fam5is
-5far
-far5th
-fa3ta
-fa3the
-4fato
-fault5
-4f5b
-4fd
-4fe.
-feas4
-feath3
-fe4b
-4feca
-5fect
-2fed
-fe3li
-fe4mo
-fen2d
-fend5e
-fer1
-5ferr
-fev4
-4f1f
-f4fes
-f4fie
-f5fin.
-f2f5is
-f4fly
-f2fy
-4fh
-1fi
-fi3a
-2f3ic.
-4f3ical
-f3ican
-4ficate
-f3icen
-fi3cer
-fic4i
-5ficia
-5ficie
-4fics
-fi3cu
-fi5del
-fight5
-fil5i
-fill5in
-4fily
-2fin
-5fina
-fin2d5
-fi2ne
-f1in3g
-fin4n
-fis4ti
-f4l2
-f5less
-flin4
-flo3re
-f2ly5
-4fm
-4fn
-1fo
-5fon
-fon4de
-fon4t
-fo2r
-fo5rat
-for5ay
-fore5t
-for4i
-fort5a
-fos5
-4f5p
-fra4t
-f5rea
-fres5c
-fri2
-fril4
-frol5
-2f3s
-2ft
-f4to
-f2ty
-3fu
-fu5el
-4fug
-fu4min
-fu5ne
-fu3ri
-fusi4
-fus4s
-4futa
-1fy
-1ga
-gaf4
-5gal.
-3gali
-ga3lo
-2gam
-ga5met
-g5amo
-gan5is
-ga3niz
-gani5za
-4gano
-gar5n4
-gass4
-gath3
-4gativ
-4gaz
-g3b
-gd4
-2ge.
-2ged
-geez4
-gel4in
-ge5lis
-ge5liz
-4gely
-1gen
-ge4nat
-ge5niz
-4geno
-4geny
-1geo
-ge3om
-g4ery
-5gesi
-geth5
-4geto
-ge4ty
-ge4v
-4g1g2
-g2ge
-g3ger
-gglu5
-ggo4
-gh3in
-gh5out
-gh4to
-5gi.
-1gi4a
-gia5r
-g1ic
-5gicia
-g4ico
-gien5
-5gies.
-gil4
-g3imen
-3g4in.
-gin5ge
-5g4ins
-5gio
-3gir
-gir4l
-g3isl
-gi4u
-5giv
-3giz
-gl2
-gla4
-glad5i
-5glas
-1gle
-gli4b
-g3lig
-3glo
-glo3r
-g1m
-g4my
-gn4a
-g4na.
-gnet4t
-g1ni
-g2nin
-g4nio
-g1no
-g4non
-1go
-3go.
-gob5
-5goe
-3g4o4g
-go3is
-gon2
-4g3o3na
-gondo5
-go3ni
-5goo
-go5riz
-gor5ou
-5gos.
-gov1
-g3p
-1gr
-4grada
-g4rai
-gran2
-5graph.
-g5rapher
-5graphic
-4graphy
-4gray
-gre4n
-4gress.
-4grit
-g4ro
-gruf4
-gs2
-g5ste
-gth3
-gu4a
-3guard
-2gue
-5gui5t
-3gun
-3gus
-4gu4t
-g3w
-1gy
-2g5y3n
-gy5ra
-h3ab4l
-hach4
-hae4m
-hae4t
-h5agu
-ha3la
-hala3m
-ha4m
-han4ci
-han4cy
-5hand.
-han4g
-hang5er
-hang5o
-h5a5niz
-han4k
-han4te
-hap3l
-hap5t
-ha3ran
-ha5ras
-har2d
-hard3e
-har4le
-harp5en
-har5ter
-has5s
-haun4
-5haz
-haz3a
-h1b
-1head
-3hear
-he4can
-h5ecat
-h4ed
-he5do5
-he3l4i
-hel4lis
-hel4ly
-h5elo
-hem4p
-he2n
-hena4
-hen5at
-heo5r
-hep5
-h4era
-hera3p
-her4ba
-here5a
-h3ern
-h5erou
-h3ery
-h1es
-he2s5p
-he4t
-het4ed
-heu4
-h1f
-h1h
-hi5an
-hi4co
-high5
-h4il2
-himer4
-h4ina
-hion4e
-hi4p
-hir4l
-hi3ro
-hir4p
-hir4r
-his3el
-his4s
-hith5er
-hi2v
-4hk
-4h1l4
-hlan4
-h2lo
-hlo3ri
-4h1m
-hmet4
-2h1n
-h5odiz
-h5ods
-ho4g
-hoge4
-hol5ar
-3hol4e
-ho4ma
-home3
-hon4a
-ho5ny
-3hood
-hoon4
-hor5at
-ho5ris
-hort3e
-ho5ru
-hos4e
-ho5sen
-hos1p
-1hous
-house3
-hov5el
-4h5p
-4hr4
-hree5
-hro5niz
-hro3po
-4h1s2
-h4sh
-h4tar
-ht1en
-ht5es
-h4ty
-hu4g
-hu4min
-hun5ke
-hun4t
-hus3t4
-hu4t
-h1w
-h4wart
-hy3pe
-hy3ph
-hy2s
-2i1a
-i2al
-iam4
-iam5ete
-i2an
-4ianc
-ian3i
-4ian4t
-ia5pe
-iass4
-i4ativ
-ia4tric
-i4atu
-ibe4
-ib3era
-ib5ert
-ib5ia
-ib3in
-ib5it.
-ib5ite
-i1bl
-ib3li
-i5bo
-i1br
-i2b5ri
-i5bun
-4icam
-5icap
-4icar
-i4car.
-i4cara
-icas5
-i4cay
-iccu4
-4iceo
-4ich
-2ici
-i5cid
-ic5ina
-i2cip
-ic3ipa
-i4cly
-i2c5oc
-4i1cr
-5icra
-i4cry
-ic4te
-ictu2
-ic4t3ua
-ic3ula
-ic4um
-ic5uo
-i3cur
-2id
-i4dai
-id5anc
-id5d
-ide3al
-ide4s
-i2di
-id5ian
-idi4ar
-i5die
-id3io
-idi5ou
-id1it
-id5iu
-i3dle
-i4dom
-id3ow
-i4dr
-i2du
-id5uo
-2ie4
-ied4e
-5ie5ga
-ield3
-ien5a4
-ien4e
-i5enn
-i3enti
-i1er.
-i3esc
-i1est
-i3et
-4if.
-if5ero
-iff5en
-if4fr
-4ific.
-i3fie
-i3fl
-4ift
-2ig
-iga5b
-ig3era
-ight3i
-4igi
-i3gib
-ig3il
-ig3in
-ig3it
-i4g4l
-i2go
-ig3or
-ig5ot
-i5gre
-igu5i
-ig1ur
-i3h
-4i5i4
-i3j
-4ik
-i1la
-il3a4b
-i4lade
-i2l5am
-ila5ra
-i3leg
-il1er
-ilev4
-il5f
-il1i
-il3ia
-il2ib
-il3io
-il4ist
-2ilit
-il2iz
-ill5ab
-4iln
-il3oq
-il4ty
-il5ur
-il3v
-i4mag
-im3age
-ima5ry
-imenta5r
-4imet
-im1i
-im5ida
-imi5le
-i5mini
-4imit
-im4ni
-i3mon
-i2mu
-im3ula
-2in.
-i4n3au
-4inav
-incel4
-in3cer
-4ind
-in5dling
-2ine
-i3nee
-iner4ar
-i5ness
-4inga
-4inge
-in5gen
-4ingi
-in5gling
-4ingo
-4ingu
-2ini
-i5ni.
-i4nia
-in3io
-in1is
-i5nite.
-5initio
-in3ity
-4ink
-4inl
-2inn
-2i1no
-i4no4c
-ino4s
-i4not
-2ins
-in3se
-insur5a
-2int.
-2in4th
-in1u
-i5nus
-4iny
-2io
-4io.
-ioge4
-io2gr
-i1ol
-io4m
-ion3at
-ion4ery
-ion3i
-io5ph
-ior3i
-i4os
-io5th
-i5oti
-io4to
-i4our
-2ip
-ipe4
-iphras4
-ip3i
-ip4ic
-ip4re4
-ip3ul
-i3qua
-iq5uef
-iq3uid
-iq3ui3t
-4ir
-i1ra
-ira4b
-i4rac
-ird5e
-ire4de
-i4ref
-i4rel4
-i4res
-ir5gi
-ir1i
-iri5de
-ir4is
-iri3tu
-5i5r2iz
-ir4min
-iro4g
-5iron.
-ir5ul
-2is.
-is5ag
-is3ar
-isas5
-2is1c
-is3ch
-4ise
-is3er
-3isf
-is5han
-is3hon
-ish5op
-is3ib
-isi4d
-i5sis
-is5itiv
-4is4k
-islan4
-4isms
-i2so
-iso5mer
-is1p
-is2pi
-is4py
-4is1s
-is4sal
-issen4
-is4ses
-is4ta.
-is1te
-is1ti
-ist4ly
-4istral
-i2su
-is5us
-4ita.
-ita4bi
-i4tag
-4ita5m
-i3tan
-i3tat
-2ite
-it3era
-i5teri
-it4es
-2ith
-i1ti
-4itia
-4i2tic
-it3ica
-5i5tick
-it3ig
-it5ill
-i2tim
-2itio
-4itis
-i4tism
-i2t5o5m
-4iton
-i4tram
-it5ry
-4itt
-it3uat
-i5tud
-it3ul
-4itz.
-i1u
-2iv
-iv3ell
-iv3en.
-i4v3er.
-i4vers.
-iv5il.
-iv5io
-iv1it
-i5vore
-iv3o3ro
-i4v3ot
-4i5w
-ix4o
-4iy
-4izar
-izi4
-5izont
-5ja
-jac4q
-ja4p
-1je
-jer5s
-4jestie
-4jesty
-jew3
-jo4p
-5judg
-3ka.
-k3ab
-k5ag
-kais4
-kal4
-k1b
-k2ed
-1kee
-ke4g
-ke5li
-k3en4d
-k1er
-kes4
-k3est.
-ke4ty
-k3f
-kh4
-k1i
-5ki.
-5k2ic
-k4ill
-kilo5
-k4im
-k4in.
-kin4de
-k5iness
-kin4g
-ki4p
-kis4
-k5ish
-kk4
-k1l
-4kley
-4kly
-k1m
-k5nes
-1k2no
-ko5r
-kosh4
-k3ou
-kro5n
-4k1s2
-k4sc
-ks4l
-k4sy
-k5t
-k1w
-lab3ic
-l4abo
-laci4
-l4ade
-la3dy
-lag4n
-lam3o
-3land
-lan4dl
-lan5et
-lan4te
-lar4g
-lar3i
-las4e
-la5tan
-4lateli
-4lativ
-4lav
-la4v4a
-2l1b
-lbin4
-4l1c2
-lce4
-l3ci
-2ld
-l2de
-ld4ere
-ld4eri
-ldi4
-ld5is
-l3dr
-l4dri
-le2a
-le4bi
-left5
-5leg.
-5legg
-le4mat
-lem5atic
-4len.
-3lenc
-5lene.
-1lent
-le3ph
-le4pr
-lera5b
-ler4e
-3lerg
-3l4eri
-l4ero
-les2
-le5sco
-5lesq
-3less
-5less.
-l3eva
-lev4er.
-lev4era
-lev4ers
-3ley
-4leye
-2lf
-l5fr
-4l1g4
-l5ga
-lgar3
-l4ges
-lgo3
-2l3h
-li4ag
-li2am
-liar5iz
-li4as
-li4ato
-li5bi
-5licio
-li4cor
-4lics
-4lict.
-l4icu
-l3icy
-l3ida
-lid5er
-3lidi
-lif3er
-l4iff
-li4fl
-5ligate
-3ligh
-li4gra
-3lik
-4l4i4l
-lim4bl
-lim3i
-li4mo
-l4im4p
-l4ina
-1l4ine
-lin3ea
-lin3i
-link5er
-li5og
-4l4iq
-lis4p
-l1it
-l2it.
-5litica
-l5i5tics
-liv3er
-l1iz
-4lj
-lka3
-l3kal
-lka4t
-l1l
-l4law
-l2le
-l5lea
-l3lec
-l3leg
-l3lel
-l3le4n
-l3le4t
-ll2i
-l2lin4
-l5lina
-ll4o
-lloqui5
-ll5out
-l5low
-2lm
-l5met
-lm3ing
-l4mod
-lmon4
-2l1n2
-3lo.
-lob5al
-lo4ci
-4lof
-3logic
-l5ogo
-3logu
-lom3er
-5long
-lon4i
-l3o3niz
-lood5
-5lope.
-lop3i
-l3opm
-lora4
-lo4rato
-lo5rie
-lor5ou
-5los.
-los5et
-5losophiz
-5losophy
-los4t
-lo4ta
-loun5d
-2lout
-4lov
-2lp
-lpa5b
-l3pha
-l5phi
-lp5ing
-l3pit
-l4pl
-l5pr
-4l1r
-2l1s2
-l4sc
-l2se
-l4sie
-4lt
-lt5ag
-ltane5
-l1te
-lten4
-ltera4
-lth3i
-l5ties.
-ltis4
-l1tr
-ltu2
-ltur3a
-lu5a
-lu3br
-luch4
-lu3ci
-lu3en
-luf4
-lu5id
-lu4ma
-5lumi
-l5umn.
-5lumnia
-lu3o
-luo3r
-4lup
-luss4
-lus3te
-1lut
-l5ven
-l5vet4
-2l1w
-1ly
-4lya
-4lyb
-ly5me
-ly3no
-2lys4
-l5yse
-1ma
-2mab
-ma2ca
-ma5chine
-ma4cl
-mag5in
-5magn
-2mah
-maid5
-4mald
-ma3lig
-ma5lin
-mal4li
-mal4ty
-5mania
-man5is
-man3iz
-4map
-ma5rine.
-ma5riz
-mar4ly
-mar3v
-ma5sce
-mas4e
-mas1t
-5mate
-math3
-ma3tis
-4matiza
-4m1b
-mba4t5
-m5bil
-m4b3ing
-mbi4v
-4m5c
-4me.
-2med
-4med.
-5media
-me3die
-m5e5dy
-me2g
-mel5on
-mel4t
-me2m
-mem1o3
-1men
-men4a
-men5ac
-men4de
-4mene
-men4i
-mens4
-mensu5
-3ment
-men4te
-me5on
-m5ersa
-2mes
-3mesti
-me4ta
-met3al
-me1te
-me5thi
-m4etr
-5metric
-me5trie
-me3try
-me4v
-4m1f
-2mh
-5mi.
-mi3a
-mid4a
-mid4g
-mig4
-3milia
-m5i5lie
-m4ill
-min4a
-3mind
-m5inee
-m4ingl
-min5gli
-m5ingly
-min4t
-m4inu
-miot4
-m2is
-mis4er.
-mis5l
-mis4ti
-m5istry
-4mith
-m2iz
-4mk
-4m1l
-m1m
-mma5ry
-4m1n
-mn4a
-m4nin
-mn4o
-1mo
-4mocr
-5mocratiz
-mo2d1
-mo4go
-mois2
-moi5se
-4mok
-mo5lest
-mo3me
-mon5et
-mon5ge
-moni3a
-mon4ism
-mon4ist
-mo3niz
-monol4
-mo3ny.
-mo2r
-4mora.
-mos2
-mo5sey
-mo3sp
-moth3
-m5ouf
-3mous
-mo2v
-4m1p
-mpara5
-mpa5rab
-mpar5i
-m3pet
-mphas4
-m2pi
-mpi4a
-mp5ies
-m4p1in
-m5pir
-mp5is
-mpo3ri
-mpos5ite
-m4pous
-mpov5
-mp4tr
-m2py
-4m3r
-4m1s2
-m4sh
-m5si
-4mt
-1mu
-mula5r4
-5mult
-multi3
-3mum
-mun2
-4mup
-mu4u
-4mw
-1na
-2n1a2b
-n4abu
-4nac.
-na4ca
-n5act
-nag5er.
-nak4
-na4li
-na5lia
-4nalt
-na5mit
-n2an
-nanci4
-nan4it
-nank4
-nar3c
-4nare
-nar3i
-nar4l
-n5arm
-n4as
-nas4c
-nas5ti
-n2at
-na3tal
-nato5miz
-n2au
-nau3se
-3naut
-nav4e
-4n1b4
-ncar5
-n4ces.
-n3cha
-n5cheo
-n5chil
-n3chis
-nc1in
-nc4it
-ncour5a
-n1cr
-n1cu
-n4dai
-n5dan
-n1de
-nd5est.
-ndi4b
-n5d2if
-n1dit
-n3diz
-n5duc
-ndu4r
-nd2we
-2ne.
-n3ear
-ne2b
-neb3u
-ne2c
-5neck
-2ned
-ne4gat
-neg5ativ
-5nege
-ne4la
-nel5iz
-ne5mi
-ne4mo
-1nen
-4nene
-3neo
-ne4po
-ne2q
-n1er
-nera5b
-n4erar
-n2ere
-n4er5i
-ner4r
-1nes
-2nes.
-4nesp
-2nest
-4nesw
-3netic
-ne4v
-n5eve
-ne4w
-n3f
-n4gab
-n3gel
-nge4n4e
-n5gere
-n3geri
-ng5ha
-n3gib
-ng1in
-n5git
-n4gla
-ngov4
-ng5sh
-n1gu
-n4gum
-n2gy
-4n1h4
-nha4
-nhab3
-nhe4
-3n4ia
-ni3an
-ni4ap
-ni3ba
-ni4bl
-ni4d
-ni5di
-ni4er
-ni2fi
-ni5ficat
-n5igr
-nik4
-n1im
-ni3miz
-n1in
-5nine.
-nin4g
-ni4o
-5nis.
-nis4ta
-n2it
-n4ith
-3nitio
-n3itor
-ni3tr
-n1j
-4nk2
-n5kero
-n3ket
-nk3in
-n1kl
-4n1l
-n5m
-nme4
-nmet4
-4n1n2
-nne4
-nni3al
-nni4v
-nob4l
-no3ble
-n5ocl
-4n3o2d
-3noe
-4nog
-noge4
-nois5i
-no5l4i
-5nologis
-3nomic
-n5o5miz
-no4mo
-no3my
-no4n
-non4ag
-non5i
-n5oniz
-4nop
-5nop5o5li
-nor5ab
-no4rary
-4nosc
-nos4e
-nos5t
-no5ta
-1nou
-3noun
-nov3el3
-nowl3
-n1p4
-npi4
-npre4c
-n1q
-n1r
-nru4
-2n1s2
-ns5ab
-nsati4
-ns4c
-n2se
-n4s3es
-nsid1
-nsig4
-n2sl
-ns3m
-n4soc
-ns4pe
-n5spi
-nsta5bl
-n1t
-nta4b
-nter3s
-nt2i
-n5tib
-nti4er
-nti2f
-n3tine
-n4t3ing
-nti4p
-ntrol5li
-nt4s
-ntu3me
-nu1a
-nu4d
-nu5en
-nuf4fe
-n3uin
-3nu3it
-n4um
-nu1me
-n5umi
-3nu4n
-n3uo
-nu3tr
-n1v2
-n1w4
-nym4
-nyp4
-4nz
-n3za
-4oa
-oad3
-o5a5les
-oard3
-oas4e
-oast5e
-oat5i
-ob3a3b
-o5bar
-obe4l
-o1bi
-o2bin
-ob5ing
-o3br
-ob3ul
-o1ce
-och4
-o3chet
-ocif3
-o4cil
-o4clam
-o4cod
-oc3rac
-oc5ratiz
-ocre3
-5ocrit
-octor5a
-oc3ula
-o5cure
-od5ded
-od3ic
-odi3o
-o2do4
-odor3
-od5uct.
-od5ucts
-o4el
-o5eng
-o3er
-oe4ta
-o3ev
-o2fi
-of5ite
-ofit4t
-o2g5a5r
-og5ativ
-o4gato
-o1ge
-o5gene
-o5geo
-o4ger
-o3gie
-1o1gis
-og3it
-o4gl
-o5g2ly
-3ogniz
-o4gro
-ogu5i
-1ogy
-2ogyn
-o1h2
-ohab5
-oi2
-oic3es
-oi3der
-oiff4
-oig4
-oi5let
-o3ing
-oint5er
-o5ism
-oi5son
-oist5en
-oi3ter
-o5j
-2ok
-o3ken
-ok5ie
-o1la
-o4lan
-olass4
-ol2d
-old1e
-ol3er
-o3lesc
-o3let
-ol4fi
-ol2i
-o3lia
-o3lice
-ol5id.
-o3li4f
-o5lil
-ol3ing
-o5lio
-o5lis.
-ol3ish
-o5lite
-o5litio
-o5liv
-olli4e
-ol5ogiz
-olo4r
-ol5pl
-ol2t
-ol3ub
-ol3ume
-ol3un
-o5lus
-ol2v
-o2ly
-om5ah
-oma5l
-om5atiz
-om2be
-om4bl
-o2me
-om3ena
-om5erse
-o4met
-om5etry
-o3mia
-om3ic.
-om3ica
-o5mid
-om1in
-o5mini
-5ommend
-omo4ge
-o4mon
-om3pi
-ompro5
-o2n
-on1a
-on4ac
-o3nan
-on1c
-3oncil
-2ond
-on5do
-o3nen
-on5est
-on4gu
-on1ic
-o3nio
-on1is
-o5niu
-on3key
-on4odi
-on3omy
-on3s
-onspi4
-onspir5a
-onsu4
-onten4
-on3t4i
-ontif5
-on5um
-onva5
-oo2
-ood5e
-ood5i
-oo4k
-oop3i
-o3ord
-oost5
-o2pa
-ope5d
-op1er
-3opera
-4operag
-2oph
-o5phan
-o5pher
-op3ing
-o3pit
-o5pon
-o4posi
-o1pr
-op1u
-opy5
-o1q
-o1ra
-o5ra.
-o4r3ag
-or5aliz
-or5ange
-ore5a
-o5real
-or3ei
-ore5sh
-or5est.
-orew4
-or4gu
-4o5ria
-or3ica
-o5ril
-or1in
-o1rio
-or3ity
-o3riu
-or2mi
-orn2e
-o5rof
-or3oug
-or5pe
-3orrh
-or4se
-ors5en
-orst4
-or3thi
-or3thy
-or4ty
-o5rum
-o1ry
-os3al
-os2c
-os4ce
-o3scop
-4oscopi
-o5scr
-os4i4e
-os5itiv
-os3ito
-os3ity
-osi4u
-os4l
-o2so
-os4pa
-os4po
-os2ta
-o5stati
-os5til
-os5tit
-o4tan
-otele4g
-ot3er.
-ot5ers
-o4tes
-4oth
-oth5esi
-oth3i4
-ot3ic.
-ot5ica
-o3tice
-o3tif
-o3tis
-oto5s
-ou2
-ou3bl
-ouch5i
-ou5et
-ou4l
-ounc5er
-oun2d
-ou5v
-ov4en
-over4ne
-over3s
-ov4ert
-o3vis
-oviti4
-o5v4ol
-ow3der
-ow3el
-ow5est
-ow1i
-own5i
-o4wo
-oy1a
-1pa
-pa4ca
-pa4ce
-pac4t
-p4ad
-5pagan
-p3agat
-p4ai
-pain4
-p4al
-pan4a
-pan3el
-pan4ty
-pa3ny
-pa1p
-pa4pu
-para5bl
-par5age
-par5di
-3pare
-par5el
-p4a4ri
-par4is
-pa2te
-pa5ter
-5pathic
-pa5thy
-pa4tric
-pav4
-3pay
-4p1b
-pd4
-4pe.
-3pe4a
-pear4l
-pe2c
-2p2ed
-3pede
-3pedi
-pedia4
-ped4ic
-p4ee
-pee4d
-pek4
-pe4la
-peli4e
-pe4nan
-p4enc
-pen4th
-pe5on
-p4era.
-pera5bl
-p4erag
-p4eri
-peri5st
-per4mal
-perme5
-p4ern
-per3o
-per3ti
-pe5ru
-per1v
-pe2t
-pe5ten
-pe5tiz
-4pf
-4pg
-4ph.
-phar5i
-phe3no
-ph4er
-ph4es.
-ph1ic
-5phie
-ph5ing
-5phisti
-3phiz
-ph2l
-3phob
-3phone
-5phoni
-pho4r
-4phs
-ph3t
-5phu
-1phy
-pi3a
-pian4
-pi4cie
-pi4cy
-p4id
-p5ida
-pi3de
-5pidi
-3piec
-pi3en
-pi4grap
-pi3lo
-pi2n
-p4in.
-pind4
-p4ino
-3pi1o
-pion4
-p3ith
-pi5tha
-pi2tu
-2p3k2
-1p2l2
-3plan
-plas5t
-pli3a
-pli5er
-4plig
-pli4n
-ploi4
-plu4m
-plum4b
-4p1m
-2p3n
-po4c
-5pod.
-po5em
-po3et5
-5po4g
-poin2
-5point
-poly5t
-po4ni
-po4p
-1p4or
-po4ry
-1pos
-pos1s
-p4ot
-po4ta
-5poun
-4p1p
-ppa5ra
-p2pe
-p4ped
-p5pel
-p3pen
-p3per
-p3pet
-ppo5site
-pr2
-pray4e
-5preci
-pre5co
-pre3em
-pref5ac
-pre4la
-pre3r
-p3rese
-3press
-pre5ten
-pre3v
-5pri4e
-prin4t3
-pri4s
-pris3o
-p3roca
-prof5it
-pro3l
-pros3e
-pro1t
-2p1s2
-p2se
-ps4h
-p4sib
-2p1t
-pt5a4b
-p2te
-p2th
-pti3m
-ptu4r
-p4tw
-pub3
-pue4
-puf4
-pul3c
-pu4m
-pu2n
-pur4r
-5pus
-pu2t
-5pute
-put3er
-pu3tr
-put4ted
-put4tin
-p3w
-qu2
-qua5v
-2que.
-3quer
-3quet
-2rab
-ra3bi
-rach4e
-r5acl
-raf5fi
-raf4t
-r2ai
-ra4lo
-ram3et
-r2ami
-rane5o
-ran4ge
-r4ani
-ra5no
-rap3er
-3raphy
-rar5c
-rare4
-rar5ef
-4raril
-r2as
-ration4
-rau4t
-ra5vai
-rav3el
-ra5zie
-r1b
-r4bab
-r4bag
-rbi2
-rbi4f
-r2bin
-r5bine
-rb5ing.
-rb4o
-r1c
-r2ce
-rcen4
-r3cha
-rch4er
-r4ci4b
-rc4it
-rcum3
-r4dal
-rd2i
-rdi4a
-rdi4er
-rdin4
-rd3ing
-2re.
-re1al
-re3an
-re5arr
-5reav
-re4aw
-r5ebrat
-rec5oll
-rec5ompe
-re4cre
-2r2ed
-re1de
-re3dis
-red5it
-re4fac
-re2fe
-re5fer.
-re3fi
-re4fy
-reg3is
-re5it
-re1li
-re5lu
-r4en4ta
-ren4te
-re1o
-re5pin
-re4posi
-re1pu
-r1er4
-r4eri
-rero4
-re5ru
-r4es.
-re4spi
-ress5ib
-res2t
-re5stal
-re3str
-re4ter
-re4ti4z
-re3tri
-reu2
-re5uti
-rev2
-re4val
-rev3el
-r5ev5er.
-re5vers
-re5vert
-re5vil
-rev5olu
-re4wh
-r1f
-rfu4
-r4fy
-rg2
-rg3er
-r3get
-r3gic
-rgi4n
-rg3ing
-r5gis
-r5git
-r1gl
-rgo4n
-r3gu
-rh4
-4rh.
-4rhal
-ri3a
-ria4b
-ri4ag
-r4ib
-rib3a
-ric5as
-r4ice
-4rici
-5ricid
-ri4cie
-r4ico
-rid5er
-ri3enc
-ri3ent
-ri1er
-ri5et
-rig5an
-5rigi
-ril3iz
-5riman
-rim5i
-3rimo
-rim4pe
-r2ina
-5rina.
-rin4d
-rin4e
-rin4g
-ri1o
-5riph
-riph5e
-ri2pl
-rip5lic
-r4iq
-r2is
-r4is.
-ris4c
-r3ish
-ris4p
-ri3ta3b
-r5ited.
-rit5er.
-rit5ers
-rit3ic
-ri2tu
-rit5ur
-riv5el
-riv3et
-riv3i
-r3j
-r3ket
-rk4le
-rk4lin
-r1l
-rle4
-r2led
-r4lig
-r4lis
-rl5ish
-r3lo4
-r1m
-rma5c
-r2me
-r3men
-rm5ers
-rm3ing
-r4ming.
-r4mio
-r3mit
-r4my
-r4nar
-r3nel
-r4ner
-r5net
-r3ney
-r5nic
-r1nis4
-r3nit
-r3niv
-rno4
-r4nou
-r3nu
-rob3l
-r2oc
-ro3cr
-ro4e
-ro1fe
-ro5fil
-rok2
-ro5ker
-5role.
-rom5ete
-rom4i
-rom4p
-ron4al
-ron4e
-ro5n4is
-ron4ta
-1room
-5root
-ro3pel
-rop3ic
-ror3i
-ro5ro
-ros5per
-ros4s
-ro4the
-ro4ty
-ro4va
-rov5el
-rox5
-r1p
-r4pea
-r5pent
-rp5er.
-r3pet
-rp4h4
-rp3ing
-r3po
-r1r4
-rre4c
-rre4f
-r4reo
-rre4st
-rri4o
-rri4v
-rron4
-rros4
-rrys4
-4rs2
-r1sa
-rsa5ti
-rs4c
-r2se
-r3sec
-rse4cr
-rs5er.
-rs3es
-rse5v2
-r1sh
-r5sha
-r1si
-r4si4b
-rson3
-r1sp
-r5sw
-rtach4
-r4tag
-r3teb
-rten4d
-rte5o
-r1ti
-rt5ib
-rti4d
-r4tier
-r3tig
-rtil3i
-rtil4l
-r4tily
-r4tist
-r4tiv
-r3tri
-rtroph4
-rt4sh
-ru3a
-ru3e4l
-ru3en
-ru4gl
-ru3in
-rum3pl
-ru2n
-runk5
-run4ty
-r5usc
-ruti5n
-rv4e
-rvel4i
-r3ven
-rv5er.
-r5vest
-r3vey
-r3vic
-rvi4v
-r3vo
-r1w
-ry4c
-5rynge
-ry3t
-sa2
-2s1ab
-5sack
-sac3ri
-s3act
-5sai
-salar4
-sal4m
-sa5lo
-sal4t
-3sanc
-san4de
-s1ap
-sa5ta
-5sa3tio
-sat3u
-sau4
-sa5vor
-5saw
-4s5b
-scan4t5
-sca4p
-scav5
-s4ced
-4scei
-s4ces
-sch2
-s4cho
-3s4cie
-5scin4d
-scle5
-s4cli
-scof4
-4scopy
-scour5a
-s1cu
-4s5d
-4se.
-se4a
-seas4
-sea5w
-se2c3o
-3sect
-4s4ed
-se4d4e
-s5edl
-se2g
-seg3r
-5sei
-se1le
-5self
-5selv
-4seme
-se4mol
-sen5at
-4senc
-sen4d
-s5ened
-sen5g
-s5enin
-4sentd
-4sentl
-sep3a3
-4s1er.
-s4erl
-ser4o
-4servo
-s1e4s
-se5sh
-ses5t
-5se5um
-5sev
-sev3en
-sew4i
-5sex
-4s3f
-2s3g
-s2h
-2sh.
-sh1er
-5shev
-sh1in
-sh3io
-3ship
-shiv5
-sho4
-sh5old
-shon3
-shor4
-short5
-4shw
-si1b
-s5icc
-3side.
-5sides
-5sidi
-si5diz
-4signa
-sil4e
-4sily
-2s1in
-s2ina
-5sine.
-s3ing
-1sio
-5sion
-sion5a
-si2r
-sir5a
-1sis
-3sitio
-5siu
-1siv
-5siz
-sk2
-4ske
-s3ket
-sk5ine
-sk5ing
-s1l2
-s3lat
-s2le
-slith5
-2s1m
-s3ma
-small3
-sman3
-smel4
-s5men
-5smith
-smol5d4
-s1n4
-1so
-so4ce
-soft3
-so4lab
-sol3d2
-so3lic
-5solv
-3som
-3s4on.
-sona4
-son4g
-s4op
-5sophic
-s5ophiz
-s5ophy
-sor5c
-sor5d
-4sov
-so5vi
-2spa
-5spai
-spa4n
-spen4d
-2s5peo
-2sper
-s2phe
-3spher
-spho5
-spil4
-sp5ing
-4spio
-s4ply
-s4pon
-spor4
-4spot
-squal4l
-s1r
-2ss
-s1sa
-ssas3
-s2s5c
-s3sel
-s5seng
-s4ses.
-s5set
-s1si
-s4sie
-ssi4er
-ss5ily
-s4sl
-ss4li
-s4sn
-sspend4
-ss2t
-ssur5a
-ss5w
-2st.
-s2tag
-s2tal
-stam4i
-5stand
-s4ta4p
-5stat.
-s4ted
-stern5i
-s5tero
-ste2w
-stew5a
-s3the
-st2i
-s4ti.
-s5tia
-s1tic
-5stick
-s4tie
-s3tif
-st3ing
-5stir
-s1tle
-5stock
-stom3a
-5stone
-s4top
-3store
-st4r
-s4trad
-5stratu
-s4tray
-s4trid
-4stry
-4st3w
-s2ty
-1su
-su1al
-su4b3
-su2g3
-su5is
-suit3
-s4ul
-su2m
-sum3i
-su2n
-su2r
-4sv
-sw2
-4swo
-s4y
-4syc
-3syl
-syn5o
-sy5rin
-1ta
-3ta.
-2tab
-ta5bles
-5taboliz
-4taci
-ta5do
-4taf4
-tai5lo
-ta2l
-ta5la
-tal5en
-tal3i
-4talk
-tal4lis
-ta5log
-ta5mo
-tan4de
-tanta3
-ta5per
-ta5pl
-tar4a
-4tarc
-4tare
-ta3riz
-tas4e
-ta5sy
-4tatic
-ta4tur
-taun4
-tav4
-2taw
-tax4is
-2t1b
-4tc
-t4ch
-tch5et
-4t1d
-4te.
-tead4i
-4teat
-tece4
-5tect
-2t1ed
-te5di
-1tee
-teg4
-te5ger
-te5gi
-3tel.
-teli4
-5tels
-te2ma2
-tem3at
-3tenan
-3tenc
-3tend
-4tenes
-1tent
-ten4tag
-1teo
-te4p
-te5pe
-ter3c
-5ter3d
-1teri
-ter5ies
-ter3is
-teri5za
-5ternit
-ter5v
-4tes.
-4tess
-t3ess.
-teth5e
-3teu
-3tex
-4tey
-2t1f
-4t1g
-2th.
-than4
-th2e
-4thea
-th3eas
-the5at
-the3is
-3thet
-th5ic.
-th5ica
-4thil
-5think
-4thl
-th5ode
-5thodic
-4thoo
-thor5it
-tho5riz
-2ths
-1tia
-ti4ab
-ti4ato
-2ti2b
-4tick
-t4ico
-t4ic1u
-5tidi
-3tien
-tif2
-ti5fy
-2tig
-5tigu
-till5in
-1tim
-4timp
-tim5ul
-2t1in
-t2ina
-3tine.
-3tini
-1tio
-ti5oc
-tion5ee
-5tiq
-ti3sa
-3tise
-tis4m
-ti5so
-tis4p
-5tistica
-ti3tl
-ti4u
-1tiv
-tiv4a
-1tiz
-ti3za
-ti3zen
-2tl
-t5la
-tlan4
-3tle.
-3tled
-3tles.
-t5let.
-t5lo
-4t1m
-tme4
-2t1n2
-1to
-to3b
-to5crat
-4todo
-2tof
-to2gr
-to5ic
-to2ma
-tom4b
-to3my
-ton4ali
-to3nat
-4tono
-4tony
-to2ra
-to3rie
-tor5iz
-tos2
-5tour
-4tout
-to3war
-4t1p
-1tra
-tra3b
-tra5ch
-traci4
-trac4it
-trac4te
-tras4
-tra5ven
-trav5es5
-tre5f
-tre4m
-trem5i
-5tria
-tri5ces
-5tricia
-4trics
-2trim
-tri4v
-tro5mi
-tron5i
-4trony
-tro5phe
-tro3sp
-tro3v
-tru5i
-trus4
-4t1s2
-t4sc
-tsh4
-t4sw
-4t3t2
-t4tes
-t5to
-ttu4
-1tu
-tu1a
-tu3ar
-tu4bi
-tud2
-4tue
-4tuf4
-5tu3i
-3tum
-tu4nis
-2t3up.
-3ture
-5turi
-tur3is
-tur5o
-tu5ry
-3tus
-4tv
-tw4
-4t1wa
-twis4
-4two
-1ty
-4tya
-2tyl
-type3
-ty5ph
-4tz
-tz4e
-4uab
-uac4
-ua5na
-uan4i
-uar5ant
-uar2d
-uar3i
-uar3t
-u1at
-uav4
-ub4e
-u4bel
-u3ber
-u4bero
-u1b4i
-u4b5ing
-u3ble.
-u3ca
-uci4b
-uc4it
-ucle3
-u3cr
-u3cu
-u4cy
-ud5d
-ud3er
-ud5est
-udev4
-u1dic
-ud3ied
-ud3ies
-ud5is
-u5dit
-u4don
-ud4si
-u4du
-u4ene
-uens4
-uen4te
-uer4il
-3ufa
-u3fl
-ugh3en
-ug5in
-2ui2
-uil5iz
-ui4n
-u1ing
-uir4m
-uita4
-uiv3
-uiv4er.
-u5j
-4uk
-u1la
-ula5b
-u5lati
-ulch4
-5ulche
-ul3der
-ul4e
-u1len
-ul4gi
-ul2i
-u5lia
-ul3ing
-ul5ish
-ul4lar
-ul4li4b
-ul4lis
-4ul3m
-u1l4o
-4uls
-uls5es
-ul1ti
-ultra3
-4ultu
-u3lu
-ul5ul
-ul5v
-um5ab
-um4bi
-um4bly
-u1mi
-u4m3ing
-umor5o
-um2p
-unat4
-u2ne
-un4er
-u1ni
-un4im
-u2nin
-un5ish
-uni3v
-un3s4
-un4sw
-unt3ab
-un4ter.
-un4tes
-unu4
-un5y
-un5z
-u4ors
-u5os
-u1ou
-u1pe
-uper5s
-u5pia
-up3ing
-u3pl
-up3p
-upport5
-upt5ib
-uptu4
-u1ra
-4ura.
-u4rag
-u4ras
-ur4be
-urc4
-ur1d
-ure5at
-ur4fer
-ur4fr
-u3rif
-uri4fic
-ur1in
-u3rio
-u1rit
-ur3iz
-ur2l
-url5ing.
-ur4no
-uros4
-ur4pe
-ur4pi
-urs5er
-ur5tes
-ur3the
-urti4
-ur4tie
-u3ru
-2us
-u5sad
-u5san
-us4ap
-usc2
-us3ci
-use5a
-u5sia
-u3sic
-us4lin
-us1p
-us5sl
-us5tere
-us1tr
-u2su
-usur4
-uta4b
-u3tat
-4ute.
-4utel
-4uten
-uten4i
-4u1t2i
-uti5liz
-u3tine
-ut3ing
-ution5a
-u4tis
-5u5tiz
-u4t1l
-ut5of
-uto5g
-uto5matic
-u5ton
-u4tou
-uts4
-u3u
-uu4m
-u1v2
-uxu3
-uz4e
-1va
-5va.
-2v1a4b
-vac5il
-vac3u
-vag4
-va4ge
-va5lie
-val5o
-val1u
-va5mo
-va5niz
-va5pi
-var5ied
-3vat
-4ve.
-4ved
-veg3
-v3el.
-vel3li
-ve4lo
-v4ely
-ven3om
-v5enue
-v4erd
-5vere.
-v4erel
-v3eren
-ver5enc
-v4eres
-ver3ie
-vermi4n
-3verse
-ver3th
-v4e2s
-4ves.
-ves4te
-ve4te
-vet3er
-ve4ty
-vi5ali
-5vian
-5vide.
-5vided
-4v3iden
-5vides
-5vidi
-v3if
-vi5gn
-vik4
-2vil
-5vilit
-v3i3liz
-v1in
-4vi4na
-v2inc
-vin5d
-4ving
-vio3l
-v3io4r
-vi1ou
-vi4p
-vi5ro
-vis3it
-vi3so
-vi3su
-4viti
-vit3r
-4vity
-3viv
-5vo.
-voi4
-3vok
-vo4la
-v5ole
-5volt
-3volv
-vom5i
-vor5ab
-vori4
-vo4ry
-vo4ta
-4votee
-4vv4
-v4y
-w5abl
-2wac
-wa5ger
-wag5o
-wait5
-w5al.
-wam4
-war4t
-was4t
-wa1te
-wa5ver
-w1b
-wea5rie
-weath3
-wed4n
-weet3
-wee5v
-wel4l
-w1er
-west3
-w3ev
-whi4
-wi2
-wil2
-will5in
-win4de
-win4g
-wir4
-3wise
-with3
-wiz5
-w4k
-wl4es
-wl3in
-w4no
-1wo2
-wom1
-wo5ven
-w5p
-wra4
-wri4
-writa4
-w3sh
-ws4l
-ws4pe
-w5s4t
-4wt
-wy4
-x1a
-xac5e
-x4ago
-xam3
-x4ap
-xas5
-x3c2
-x1e
-xe4cuto
-x2ed
-xer4i
-xe5ro
-x1h
-xhi2
-xhil5
-xhu4
-x3i
-xi5a
-xi5c
-xi5di
-x4ime
-xi5miz
-x3o
-x4ob
-x3p
-xpan4d
-xpecto5
-xpe3d
-x1t2
-x3ti
-x1u
-xu3a
-xx4
-y5ac
-3yar4
-y5at
-y1b
-y1c
-y2ce
-yc5er
-y3ch
-ych4e
-ycom4
-ycot4
-y1d
-y5ee
-y1er
-y4erf
-yes4
-ye4t
-y5gi
-4y3h
-y1i
-y3la
-ylla5bl
-y3lo
-y5lu
-ymbol5
-yme4
-ympa3
-yn3chr
-yn5d
-yn5g
-yn5ic
-5ynx
-y1o4
-yo5d
-y4o5g
-yom4
-yo5net
-y4ons
-y4os
-y4ped
-yper5
-yp3i
-y3po
-y4poc
-yp2ta
-y5pu
-yra5m
-yr5ia
-y3ro
-yr4r
-ys4c
-y3s2e
-ys3ica
-ys3io
-3ysis
-y4so
-yss4
-ys1t
-ys3ta
-ysur4
-y3thin
-yt3ic
-y1w
-za1
-z5a2b
-zar2
-4zb
-2ze
-ze4n
-ze4p
-z1er
-ze3ro
-zet4
-2z1i
-z4il
-z4is
-5zl
-4zm
-1zo
-zo4m
-zo5ol
-zte4
-4z1z2
-z4zy
-}
-\hyphenation{ % Do NOT make any alterations to this list! --- DEK
-as-so-ciate
-as-so-ciates
-dec-li-na-tion
-oblig-a-tory
-phil-an-thropic
-present
-presents
-project
-projects
-reci-procity
-re-cog-ni-zance
-ref-or-ma-tion
-ret-ri-bu-tion
-ta-ble
-}
-% ======================================================================
-% Editor settings
-% ======================================================================
-%
-% Local Variables:
-% mode: tex
-% fill-column: 72
-% End:
-% vim: set filetype=tex textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphenex.us Deleted

@@ -1,1454 +0,0 @@
-% Hyphenation exceptions for US English,
-% based on hyphenation exception log articles in TUGboat.
-%
-% Copyright 2008 TeX Users Group.
-% You may freely use, modify and/or distribute this file.
-%
-% This is an automatically generated file.  Do not edit!
-%
-% Please contact the TUGboat editorial staff <tugboat@tug.org>
-% for corrections and omissions.
-
-\hyphenation{
-  acad-e-my
-  acad-e-mies
-  ac-cu-sa-tive
-  acro-nym
-  acro-nyms
-  acryl-amide
-  acryl-amides
-  acryl-alde-hyde
-  acu-punc-ture
-  acu-punc-tur-ist
-  add-a-ble
-  add-i-ble
-  adren-a-line
-  aero-space
-  af-ter-thought
-  af-ter-thoughts
-  agron-o-mist
-  agron-o-mists
-  al-ge-bra-i-cal-ly
-  am-phet-a-mine
-  am-phet-a-mines
-  anach-ro-nism
-  anach-ro-nis-tic
-  an-a-lyse
-  an-a-lysed
-  analy-ses
-  analy-sis
-  an-eu-rysm
-  an-eu-rysms
-  an-eu-rys-mal
-  an-iso-trop-ic
-  an-iso-trop-i-cal-ly
-  an-isot-ro-pism
-  an-isot-ropy
-  an-ni-ver-sary
-  an-ni-ver-saries
-  anom-a-ly
-  anom-a-lies
-  anti-deriv-a-tive
-  anti-deriv-a-tives
-  anti-holo-mor-phic
-  an-tin-o-my
-  an-tin-o-mies
-  anti-nu-clear
-  anti-nu-cle-on
-  anti-rev-o-lu-tion-ary
-  a-peri-odic
-  apoth-e-o-ses
-  apoth-e-o-sis
-  ap-pen-di-ces
-  ap-pen-dix
-  ap-pen-dixes
-  ar-chi-me-dean
-  ar-chi-pel-ago
-  ar-chi-pel-a-gos
-  ar-chive
-  ar-chives
-  ar-chiv-ing
-  ar-chiv-ist
-  ar-chiv-ists
-  ar-che-typ-al
-  ar-che-type
-  ar-che-types
-  ar-che-typ-i-cal
-  arc-tan-gent
-  arc-tan-gents
-  a-spher-ic
-  a-spher-i-cal
-  as-sign-a-ble
-  as-sign-or
-  as-sign-ors
-  as-sist-ant
-  as-sist-ance
-  as-sist-ant-ship
-  as-sist-ant-ships
-  as-trol-o-ger
-  as-trol-o-gers
-  as-tron-o-mer
-  as-tron-o-mers
-  asymp-to-matic
-  as-ymp-tot-ic
-  asyn-chro-nous
-  ath-er-o-scle-ro-sis
-  at-mos-phere
-  at-mos-pheres
-  at-tri-bute
-  at-trib-uted
-  at-trib-ut-able
-  au-to-ma-tion
-  au-tom-a-ton
-  au-tom-a-ta
-  auto-num-ber-ing
-  au-ton-o-mous
-  auto-re-gres-sion
-  auto-re-gres-sive
-  auto-round-ing
-  av-oir-du-pois
-  back-scratcher
-  back-scratch-ing
-  band-lead-er
-  band-lead-ers
-  bank-rupt
-  bank-rupts
-  bank-rupt-cy
-  bank-rupt-cies
-  bar-onies
-  base-line-skip
-  ba-thym-e-try
-  bathy-scaphe
-  bean-ies
-  be-drag-gle
-  be-drag-gled
-  bed-rid-den
-  bed-rock
-  be-dwarf
-  be-dwarfs
-  be-hav-iour
-  be-hav-iours
-  bevies
-  bib-lio-graph-i-cal
-  bib-li-og-ra-phy-style
-  bib-units
-  bi-dif-fer-en-tial
-  big-gest
-  big-shot
-  big-shots
-  bill-able
-  bio-math-e-mat-ics
-  bio-med-i-cal
-  bio-med-i-cine
-  bio-rhythms
-  bio-weap-ons
-  bio-weap-on-ry
-  bit-map
-  bit-maps
-  bland-er
-  bland-est
-  blind-er
-  blind-est
-  blondes
-  blue-print
-  blue-prints
-  bo-lom-e-ter
-  bo-lom-e-ters
-  book-sell-er
-  book-sell-ers
-  bool-ean
-  bool-eans
-  bor-no-log-i-cal
-  bot-u-lism
-  brusquer
-  buf-fer
-  buf-fers
-  bun-gee
-  bun-gees
-  busier
-  busi-est
-  bussing
-  butted
-  buzz-word
-  buzz-words
-  cache-abil-ity
-  cache-able
-  ca-coph-o-ny
-  ca-coph-o-nies
-  call-er
-  call-ers
-  cam-era-men
-  cart-wheel
-  cart-wheels
-  ca-tarrh
-  ca-tarrhs
-  ca-tas-tro-phe
-  ca-tas-tro-phes
-  cat-a-stroph-ic
-  cat-a-stroph-i-cally
-  ca-tas-tro-phism
-  cat-e-noid
-  cat-e-noids
-  cau-li-flow-er
-  chan-cery
-  chap-ar-ral
-  char-treuse
-  chemo-kine
-  chemo-kines
-  chemo-ther-apy
-  chemo-ther-a-pies
-  chloro-meth-ane
-  chloro-meth-anes
-  cho-les-teric
-  cig-a-rette
-  cig-a-rettes
-  cinque-foil
-  co-asso-cia-tive
-  coch-leas
-  coch-lear
-  co-designer
-  co-designers
-  co-gnac
-  co-gnacs
-  co-ker-nel
-  co-ker-nels
-  col-lin-ea-tion
-  col-umns
-  com-par-and
-  com-par-ands
-  com-pen-dium
-  com-po-nent-wise
-  comp-trol-ler
-  comp-trol-lers
-  com-put-able
-  com-put-abil-ity
-  con-form-able
-  con-form-ist
-  con-form-ists
-  con-form-ity
-  con-ge-ries
-  con-gress
-  con-gresses
-  con-struc-ted
-  con-struc-ti-ble
-  con-struc-ti-bil-ity
-  con-trib-ute
-  con-trib-utes
-  con-trib-uted
-  copy-right-able
-  co-re-la-tion
-  co-re-la-tions
-  co-re-li-gion-ist
-  co-re-li-gion-ists
-  co-re-op-sis
-  co-re-spon-dent
-  co-re-spon-dents
-  co-se-cant
-  co-semi-sim-ple
-  co-tan-gent
-  cour-ses
-  co-work-er
-  co-work-ers
-  crank-case
-  crank-shaft
-  croc-o-dile
-  croc-o-diles
-  cross-hatch
-  cross-hatched
-  cross-hatch-ing
-  cross-over
-  cryp-to-gram
-  cryp-to-grams
-  cuff-link
-  cuff-links
-  cu-nei-form
-  cus-tom-iz-a-ble
-  cus-tom-ize
-  cus-tom-izes
-  cus-tom-ized
-  cy-ber-virus
-  cy-ber-viruses
-  cy-ber-wea-pon
-  cy-ber-wea-pons
-  cy-to-kine
-  cy-to-kines
-  dachs-hund
-  dam-sel-fly
-  dam-sel-flies
-  dactyl-o-gram
-  dactyl-o-graph
-  data-base
-  data-bases
-  data-path
-  data-paths
-  date-stamp
-  date-stamps
-  de-allo-cate
-  de-allo-cates
-  de-allo-cated
-  de-allo-ca-tion
-  de-allo-ca-tions
-  de-clar-able
-  de-fin-i-tive
-  de-lec-ta-ble
-  demi-semi-qua-ver
-  demi-semi-qua-vers
-  de-moc-ra-tism
-  demos
-  der-i-va-tion
-  der-i-va-tions
-  der-i-va-tion-al
-  de-riv-a-tive
-  de-riv-a-tives
-  dia-lec-tic
-  dia-lec-tics
-  dia-lec-ti-cian
-  dia-lec-ti-cians
-  di-chloro-meth-ane
-  dif-fract
-  dif-fracts
-  dif-frac-tion
-  dif-frac-tions
-  direr
-  dire-ness
-  dis-par-and
-  dis-par-ands
-  dis-traught-ly
-  dis-trib-ut-able
-  dis-trib-ute
-  dis-trib-utes
-  dis-trib-uted
-  dis-trib-u-tive
-  dou-ble-space
-  dou-ble-spaced
-  dou-ble-spac-ing
-  dou-ble-talk
-  doll-ish
-  drift-age
-  driv-ers
-  drom-e-dary
-  drom-e-daries
-  drop-let
-  drop-lets
-  du-op-o-list
-  du-op-o-lists
-  du-op-o-ly
-  du-op-o-lies
-  dys-lexia
-  dys-lec-tic
-  dys-topia
-  east-end-ers
-  eco-sys-tem
-  eco-sys-tems
-  eco-nom-ics
-  econ-o-mies
-  econ-o-mist
-  econ-o-mists
-  ei-gen-class
-  ei-gen-classes
-  ei-gen-val-ue
-  ei-gen-val-ues
-  electro-mechan-i-cal
-  electro-mechano-acoustic
-  elec-tro-pho-re-sis
-  elec-tro-pho-ret-ic
-  elit-ist
-  elit-ists
-  en-dos-copy
-  en-dos-copies
-  en-tre-pre-neur
-  en-tre-pre-neurs
-  en-tre-pre-neur-ial
-  ep-i-neph-rine
-  eps-to-pdf
-  equi-vari-ant
-  equi-vari-ance
-  er-go-nom-ic
-  er-go-nom-ics
-  er-go-nom-i-cally
-  es-sence
-  es-sences
-  eth-ane
-  eth-yl-am-ine
-  eth-yl-ate
-  eth-yl-ated
-  eth-yl-ene
-  ethy-nyl
-  ethy-nyl-a-tion
-  eu-sta-chian
-  ever-si-ble
-  evert
-  everts
-  evert-ed
-  evert-ing
-  ex-plan-a-tory
-  ex-quis-ite
-  ex-tra-or-di-nary
-  face-lifts
-  face-lift-ing
-  fall-ing
-  fermi-ons
-  figu-rine
-  figu-rines
-  fi-nite-ly
-  fla-gel-lum
-  fla-gel-la
-  flam-ma-bles
-  fledg-ling
-  flow-chart
-  flow-charts
-  fluoro-car-bon
-  fluor-os-copies
-  fluor-os-copy
-  for-mi-da-ble
-  for-mi-da-bly
-  for-syth-ia
-  forth-right
-  free-loader
-  free-loaders
-  friend-lier
-  friend-li-est
-  fri-vol-ity
-  fri-vol-i-ties
-  friv-o-lous
-  front-end
-  front-ends
-  ga-lac-tic
-  gal-axy
-  gal-ax-ies
-  gaz-et-teer
-  gaz-et-teers
-  gas-om-e-ter
-  ge-o-des-ic
-  ge-o-det-ic
-  ge-om-eter
-  ge-om-eters
-  geo-met-ric
-  geo-met-rics
-  ge-o-strophic
-  geo-ther-mal
-  ge-ot-ro-pism
-  giga-nodes
-  gno-mon
-  gno-mons
-  gran-di-ose
-  grand-uncle
-  grand-uncles
-  griev-ance
-  griev-ances
-  griev-ous
-  griev-ous-ly
-  group-like
-  hair-style
-  hair-styles
-  hair-styl-ist
-  hair-styl-ists
-  half-life
-  half-lives
-  half-space
-  half-spaces
-  half-tone
-  half-tones
-  half-way
-  har-bin-ger
-  har-bin-gers
-  har-le-quin
-  har-le-quins
-  hatch-eries
-  hei-nous
-  he-lio-pause
-  he-lio-trope
-  hemi-demi-semi-qua-ver
-  hemi-demi-semi-qua-vers
-  he-mo-glo-bin
-  he-mo-phil-ia
-  he-mo-phil-iac
-  he-mo-phil-iacs
-  hemo-rhe-ol-ogy
-  he-pat-ic
-  he-pat-ica
-  her-maph-ro-dite
-  her-maph-ro-dit-ic
-  he-roes
-  hexa-dec-i-mal
-  hip-po-po-ta-mus
-  holo-deck
-  holo-decks
-  ho-lo-no-my
-  ho-meo-mor-phic
-  ho-meo-mor-phism
-  ho-meo-stat-ic
-  ho-meo-stat-ics
-  ho-meo-sta-sis
-  ho-mo-thetic
-  horse-rad-ish
-  hot-bed
-  hot-beds
-  hounds-teeth
-  hounds-tooth
-  hy-dro-ther-mal
-  hy-per-elas-tic-ity
-  hy-phen-a-tion
-  hy-phen-a-tions
-  hy-po-elas-tic-ity
-  hy-po-thal-a-mus
-  ico-nog-ra-pher
-  ico-nog-ra-phers
-  icon-o-graph-ic
-  ico-nog-ra-phy
-  ideals
-  ideo-graphs
-  idio-syn-crasy
-  idio-syn-cra-sies
-  idio-syn-cratic
-  idio-syn-crat-i-cal-ly
-  ig-nit-er
-  ig-nit-ers
-  ig-ni-tor
-  ignore-spaces
-  il-li-quid
-  il-li-quid-ity
-  im-mu-ni-za-tion
-  im-mu-no-mod-u-la-to-ry
-  im-ped-ance
-  im-ped-ances
-  in-du-bi-ta-ble
-  in-fin-ite-ly
-  in-fin-i-tes-i-mal
-  in-fra-struc-ture
-  in-fra-struc-tures
-  input-enc
-  in-stall-er
-  in-stall-ers
-  in-teg-rity
-  in-ter-dis-ci-pli-nary
-  in-ter-ga-lac-tic
-  in-ter-view-ee
-  in-ter-view-ees
-  in-utile
-  in-util-i-ty
-  ir-ra-tio-nal
-  ir-re-duc-ible
-  ir-re-duc-ibly
-  ir-rev-o-ca-ble
-  iso-geo-met-ric
-  iso-geo-met-rics
-  iso-ther-mal
-  isot-ropy
-  iso-trop-ic
-  itin-er-ary
-  itin-er-ar-ies
-  je-re-mi-ads
-  key-note
-  key-notes
-  key-stroke
-  key-strokes
-  kilo-nodes
-  kiln-ing
-  lac-i-est
-  lam-en-ta-ble
-  land-scap-er
-  land-scap-ers
-  lar-ce-n
-  lar-ce-ny
-  lar-ce-nies
-  lar-ce-nist
-  leaf-hop-per
-  leaf-hop-pers
-  leaf-let
-  leaf-lets
-  let-ter-spaces
-  let-ter-spaced
-  let-ter-spac-ing
-  leu-ko-cyte
-  leu-ko-cytes
-  leu-ko-triene
-  leu-ko-trienes
-  life-span
-  life-spans
-  life-style
-  life-styles
-  lift-off
-  light-weight
-  lim-ou-sines
-  line-backer
-  line-spacing
-  li-on-ess
-  li-quid-ity
-  lith-o-graphed
-  lith-o-graphs
-  lo-bot-omy
-  lo-bot-om-ize
-  loges
-  long-est
-  look-ahead
-  lo-quac-ity
-  love-struck
-  macro-eco-nomic
-  macro-eco-nomics
-  macro-econ-omy
-  make-in-dex
-  mal-a-prop-ism
-  mal-a-prop-isms
-  man-slaugh-ter
-  man-u-script
-  man-u-scripts
-  mar-gin-al
-  math-e-ma-ti-cian
-  math-e-ma-ti-cians
-  mattes
-  med-ic-aid
-  medi-ocre
-  medi-oc-ri-ties
-  mega-fau-na
-  mega-fau-nal
-  mega-lith
-  mega-liths
-  mega-nodes
-  meta-bol-ic
-  me-tab-o-lism
-  me-tab-o-lisms
-  me-tab-o-lite
-  me-tab-o-lites
-  meta-form
-  meta-forms
-  meta-lan-guage
-  meta-lan-guages
-  meta-phor
-  meta-phors
-  meta-phor-i-cal
-  meta-phor-i-cal-ly
-  meta-sta-bil-ity
-  meta-stable
-  meta-table
-  meta-tables
-  metem-psy-cho-sis
-  meth-am-phet-a-mine
-  meth-ane
-  meth-od
-  meth-yl-am-mo-nium
-  meth-yl-ate
-  meth-yl-ated
-  meth-yl-a-tion
-  meth-yl-ene
-  me-trop-o-lis
-  me-trop-o-lises
-  met-ro-pol-i-tan
-  met-ro-pol-i-tans
-  micro-eco-nomic
-  micro-eco-nomics
-  micro-econ-omy
-  micro-en-ter-prise
-  micro-en-ter-prises
-  mi-cro-fiche
-  mi-cro-fiches
-  micro-organ-ism
-  micro-organ-isms
-  mi-cro-struc-ture
-  mid-after-noon
-  mill-age
-  mil-li-liter
-  mimeo-graphed
-  mimeo-graphs
-  mim-ic-ries
-  mine-sweeper
-  mine-sweepers
-  min-is
-  mini-sym-po-sium
-  mini-sym-po-sia
-  mi-nut-er
-  mi-nut-est
-  mis-chie-vous-ly
-  mi-sers
-  mi-sog-a-my
-  mne-mon-ic
-  mne-mon-ics
-  mod-el-ling
-  mo-lec-u-lar
-  mol-e-cule
-  mol-e-cules
-  mon-archs
-  money-len-der
-  money-len-ders
-  mono-chrome
-  mono-en-er-getic
-  mon-oid
-  mon-oph-thong
-  mon-oph-thongs
-  mono-pole
-  mono-poles
-  mo-nop-oly
-  mono-space
-  mono-spaced
-  mono-spacing
-  mono-spline
-  mono-splines
-  mono-strofic
-  mo-not-o-nies
-  mo-not-o-nous
-  mo-ron-ism
-  mos-qui-to
-  mos-qui-tos
-  mos-qui-toes
-  mud-room
-  mud-rooms
-  mul-ti-fac-eted
-  mul-ti-plic-able
-  mul-ti-plic-ably
-  multi-user
-  name-space
-  name-spaces
-  neo-fields
-  neo-nazi
-  neo-nazis
-  neph-ews
-  neph-rite
-  neph-ritic
-  new-est
-  news-let-ter
-  news-let-ters
-  nil-po-tent
-  nitro-meth-ane
-  node-list
-  node-lists
-  no-name
-  non-ar-ith-met-ic
-  non-emer-gency
-  non-equi-vari-ance
-  none-the-less
-  non-euclid-ean
-  non-iso-mor-phic
-  non-pseudo-com-pact
-  non-smooth
-  non-uni-form
-  non-uni-form-ly
-  non-zero
-  nor-ep-i-neph-rine
-  not-with-stand-ing
-  nu-cleo-tide
-  nu-cleo-tides
-  nut-crack-er
-  nut-crack-ers
-  oer-steds
-  off-line
-  off-load
-  off-loads
-  off-loaded
-  oli-gop-o-list
-  oli-gop-o-lists
-  oli-gop-oly
-  oli-gop-ol-ies
-  om-ni-pres-ent
-  om-ni-pres-ence
-  ono-mat-o-poe-ia
-  ono-mat-o-po-et-ic
-  op-er-and
-  op-er-ands
-  orang-utan
-  orang-utans
-  or-tho-don-tist
-  or-tho-don-tists
-  or-tho-ker-a-tol-ogy
-  ortho-nitro-toluene
-  over-view
-  over-views
-  ox-id-ic
-  pad-ding
-  page-rank
-  pain-less-ly
-  pal-ette
-  pal-ettes
-  pa-rab-ola
-  par-a-bol-ic
-  pa-rab-o-loid
-  par-a-digm
-  par-a-digms
-  para-chute
-  para-chutes
-  para-di-methyl-benzene
-  para-fluoro-toluene
-  para-graph-er
-  para-le-gal
-  par-al-lel-ism
-  para-mag-net-ism
-  para-medic
-  para-methyl-anisole
-  pa-ram-e-tri-za-tion
-  pa-ram-e-trize
-  para-mil-i-tary
-  para-mount
-  path-o-gen-ic
-  peev-ish
-  peev-ish-ness
-  pen-al-ty
-  pen-al-ties
-  pen-ta-gon
-  pen-ta-gons
-  pe-tro-le-um
-  phe-nol-phthalein
-  phe-nom-e-non
-  phenyl-ala-nine
-  phi-lat-e-list
-  phi-lat-e-lists
-  pho-neme
-  pho-nemes
-  pho-ne-mic
-  phos-phor-ic
-  pho-to-graphs
-  pho-to-off-set
-  phtha-lam-ic
-  phthal-ate
-  phthi-sis
-  pic-a-dor
-  pic-a-dors
-  pipe-line
-  pipe-lines
-  pipe-lin-ing
-  pi-ra-nhas
-  placa-ble
-  plant-hop-per
-  plant-hop-pers
-  pla-teau
-  pla-teaus
-  pleas-ance
-  plug-in
-  plug-ins
-  pol-ter-geist
-  poly-an-dr
-  poly-an-dry
-  poly-an-drous
-  poly-dac-tyl
-  poly-dac-tyl-lic
-  poly-ene
-  poly-eth-yl-ene
-  po-lyg-a-mist
-  po-lyg-a-mists
-  polyg-on-i-za-tion
-  po-lyg-y-n
-  po-lyg-y-ny
-  po-lyg-y-nous
-  pol-yp
-  pol-yps
-  po-lyph-o-n
-  po-lyph-o-ny
-  po-lyph-o-nous
-  poly-phon-ic
-  poly-styrene
-  pome-gran-ate
-  poro-elas-tic
-  por-ous
-  por-ta-ble
-  post-am-ble
-  post-am-bles
-  post-hu-mous
-  post-script
-  post-scripts
-  pos-tur-al
-  pre-am-ble
-  pre-am-bles
-  pre-dict-able
-  pre-fers
-  pre-loaded
-  pre-par-ing
-  pre-print
-  pre-prints
-  pre-proces-sor
-  pre-proces-sors
-  pres-ent-ly
-  pre-split-ting
-  pre-wrap
-  pre-wrapped
-  priest-esses
-  pret-ty-prin-ter
-  pret-ty-prin-ting
-  pro-ce-dur-al
-  process
-  pro-cur-ance
-  prog-e-nies
-  prog-e-ny
-  pro-gram-mable
-  pro-kary-ote
-  pro-kary-otes
-  pro-kary-ot-ic
-  prom-i-nent
-  pro-mis-cu-ous
-  prom-is-sory
-  prom-ise
-  prom-ises
-  pro-pel-ler
-  pro-pel-lers
-  pro-pel-ling
-  pro-hib-i-tive
-  pro-hib-i-tive-ly
-  pro-sciut-to
-  pros-ta-glan-din
-  pros-ta-glan-dins
-  pro-style
-  pro-styles
-  pro-test-er
-  pro-test-ers
-  pro-tes-tor
-  pro-tes-tors
-  pro-to-lan-guage
-  pro-to-typ-al
-  prov-ince
-  prov-inces
-  pro-vin-cial
-  pro-virus
-  pro-viruses
-  prow-ess
-  pseu-do-dif-fer-en-tial
-  pseu-do-fi-nite
-  pseu-do-fi-nite-ly
-  pseu-do-forces
-  pseu-dog-ra-pher
-  pseu-do-group
-  pseu-do-groups
-  pseu-do-nym
-  pseu-do-nyms
-  pseu-do-word
-  pseu-do-words
-  psy-che-del-ic
-  psychs
-  pu-bes-cence
-  pur-ges
-  quad-ding
-  qua-drat-ic
-  qua-drat-ics
-  quad-ra-ture
-  quad-ri-lat-er-al
-  quad-ri-lat-er-als
-  quad-ri-pleg-ic
-  quad-ru-ped
-  quad-ru-peds
-  quad-ru-pole
-  quad-ru-poles
-  quaint-er
-  quaint-est
-  qua-si-equiv-a-lence
-  qua-si-equiv-a-lences
-  qua-si-equiv-a-lent
-  qua-si-hy-po-nor-mal
-  qua-si-rad-i-cal
-  qua-si-resid-ual
-  qua-si-smooth
-  qua-si-sta-tion-ary
-  qua-si-topos
-  qua-si-tri-an-gu-lar
-  qua-si-triv-ial
-  quin-tes-sence
-  quin-tes-sences
-  quin-tes-sen-tial
-  rab-bit-ry
-  ra-di-og-ra-phy
-  raff-ish
-  raff-ish-ly
-  ram-shackle
-  rav-en-ous
-  re-allo-cate
-  re-allo-cates
-  re-allo-cated
-  re-arrange
-  re-arranges
-  re-arranged
-  re-arrange-ment
-  re-arrange-ments
-  rec-i-proc-i-ties
-  rec-i-proc-i-ty
-  rec-tan-gle
-  rec-tan-gles
-  rec-tan-gu-lar
-  re-di-rect
-  re-di-rect-ion
-  re-duc-ible
-  re-echo
-  re-edu-cate
-  ref-u-gee
-  ref-u-gees
-  re-imple-ment
-  re-imple-ments
-  re-imple-mented
-  re-imple-men-ta-tion
-  ren-ais-sance
-  re-phrase
-  re-phrases
-  re-phrased
-  re-po-si-tion
-  re-po-si-tions
-  re-print
-  re-prints
-  re-print-ed
-  re-stor-able
-  retro-fit
-  retro-fit-ted
-  re-us-able
-  re-use
-  re-wire
-  re-wrap
-  re-wrapped
-  re-write
-  rhi-noc-er-os
-  right-eous
-  right-eous-ness
-  ring-leader
-  ring-leaders
-  ro-bot
-  ro-bots
-  ro-botic
-  ro-bot-ics
-  roof-top
-  roof-tops
-  round-table
-  round-tables
-  sales-clerk
-  sales-clerks
-  sales-woman
-  sales-women
-  sa-lient
-  sal-mo-nel-la
-  sal-ta-tion
-  sar-sa-par-il-la
-  sat-el-lite
-  sat-el-lites
-  sauer-kraut
-  scat-o-log-i-cal
-  scene-shift-er
-  scene-shift-ing
-  sched-ul-ing
-  schiz-o-phrenic
-  schnau-zer
-  school-child
-  school-child-ren
-  school-teacher
-  school-teach-ers
-  scru-ti-ny
-  scyth-ing
-  sell-er
-  sell-ers
-  sec-re-tar-iat
-  sec-re-tar-iats
-  sem-a-phore
-  sem-a-phores
-  se-mes-ter
-  semi-def-i-nite
-  semi-di-rect
-  semi-ho-mo-thet-ic
-  semi-ring
-  semi-rings
-  semi-sim-ple
-  semi-skilled
-  sem-itic
-  ser-geant
-  ser-geants
-  sero-epi-de-mi-o-log-i-cal
-  ser-vo-me-chan-i-cal
-  ser-vo-mech-a-nism
-  ser-vo-mech-a-nisms
-  ses-qui-pe-da-lian
-  set-up
-  set-ups
-  se-vere-ly
-  shap-able
-  shape-able
-  shoe-string
-  shoe-strings
-  shop-lift-er
-  shop-lift-ing
-  show-hy-phens
-  side-step
-  side-steps
-  side-swipe
-  sign-age
-  single-space
-  single-spaced
-  single-spacing
-  sky-scraper
-  sky-scrapers
-  sln-uni-code
-  smoke-stack
-  smoke-stacks
-  snor-kel-ing
-  so-le-noid
-  so-le-noids
-  solute
-  solutes
-  sov-er-eign
-  sov-er-eigns
-  spa-ces
-  spe-cious
-  spell-er
-  spell-ers
-  spell-ing
-  spe-lunk-er
-  spend-thrift
-  spher-oid
-  spher-oids
-  spher-oid-al
-  sphin-ges
-  spic-i-ly
-  spin-or
-  spin-ors
-  spokes-man
-  spokes-per-son
-  spokes-per-sons
-  spokes-woman
-  spokes-women
-  sports-cast
-  sports-cast-er
-  spor-tive-ly
-  sports-wear
-  sports-writer
-  sports-writers
-  spright-lier
-  squea-mish
-  stand-alone
-  star-tling
-  star-tling-ly
-  sta-tis-tics
-  stealth-ily
-  steeple-chase
-  stereo-graph-ic
-  sto-chas-tic
-  strange-ness
-  strap-hanger
-  strat-a-gem
-  strat-a-gems
-  stretch-i-er
-  strip-tease
-  strong-est
-  strong-hold
-  stu-pid-er
-  stu-pid-est
-  sub-dif-fer-en-tial
-  sub-ex-pres-sion
-  sub-ex-pres-sions
-  sub-node
-  sub-nodes
-  sub-scrib-er
-  sub-scrib-ers
-  sub-tables
-  sum-ma-ble
-  super-deri-va-tion
-  super-deri-va-tions
-  super-ego
-  super-egos
-  su-prem-a-cist
-  su-prem-a-cists
-  sur-gery
-  sur-ge-ries
-  sur-ges
-  sur-veil-lance
-  swim-ming-ly
-  symp-to-matic
-  syn-chro-mesh
-  syn-chro-nous
-  syn-chro-tron
-  taff-rail
-  take-over
-  take-overs
-  talk-a-tive
-  ta-pes-try
-  ta-pes-tries
-  tar-pau-lin
-  tar-pau-lins
-  te-leg-ra-pher
-  te-leg-ra-phers
-  tele-ki-net-ic
-  tele-ki-net-ics
-  tele-ro-bot-ics
-  tell-er
-  tell-ers
-  tem-po-rar-ily
-  ten-ure
-  test-bed
-  tera-nodes
-  tetra-butyl-ammo-nium
-  text-height
-  text-length
-  text-width
-  thal-a-mus
-  ther-mo-elas-tic
-  time-stamp
-  time-stamps
-  tool-kit
-  tool-kits
-  topo-graph-i-cal
-  topo-iso-mer-ase
-  topo-iso-mer-ases
-  toques
-  trai-tor-ous
-  trans-ceiver
-  trans-ceivers
-  trans-par-en-cy
-  trans-par-en-cies
-  trans-gress
-  trans-ver-sal
-  trans-ver-sals
-  trans-ves-tite
-  trans-ves-tites
-  tra-vers-a-ble
-  tra-ver-sal
-  tra-ver-sals
-  tri-ethyl-amine
-  treach-eries
-  tribes-man
-  trip-let
-  trip-lets
-  tri-plex
-  tri-plex-es
-  trou-ba-dour
-  tur-key
-  tur-keys
-  turn-around
-  turn-arounds
-  typ-al
-  un-at-tached
-  un-err-ing-ly
-  un-friend-ly
-  un-friend-li-er
-  un-in-stan-ti-at-ed
-  vaguer
-  vaude-ville
-  vic-ars
-  vil-lain-ess
-  vis-ual
-  vis-ual-ly
-  vi-vip-a-rous
-  voice-print
-  vspace
-  wad-ding
-  wall-flower
-  wall-flow-ers
-  warm-er
-  warm-est
-  waste-water
-  wave-guide
-  wave-guides
-  wave-let
-  wave-lets
-  weap-ons
-  weap-on-ry
-  web-like
-  web-log
-  web-logs
-  week-night
-  week-nights
-  weight-lift-er
-  weight-lift-ing
-  wheel-chair
-  wheel-chairs
-  which-ever
-  white-sided
-  white-space
-  white-spaces
-  wide-spread
-  wing-span
-  wing-spans
-  wing-spread
-  witch-craft
-  word-spac-ing
-  work-around
-  work-arounds
-  work-horse
-  work-horses
-  wrap-around
-  wrap-arounds
-  wretch-ed
-  wretch-ed-ly
-  yes-ter-year
-  Alex-an-der
-  Alex-an-drine
-  al-ge-brai-sche
-  Al-gon-quian
-  Al-gon-quin
-  Al-le-ghe-ny
-  Apol-lo-dorus
-  Ar-kan-sas
-  ATP-ase
-  ATP-ases
-  Auf-lage
-  Aus-tral-asian
-  auto-ma-ti-sier-ter
-  Beb-chuk
-  Be-die-nung
-  Bembo
-  bi-blio-gra-phi-sche
-  Bos-ton
-  Brown-ian
-  Bruns-wick
-  Bu-da-pest
-  Burck-hardt
-  Cara-theo-dory
-  Car-ib-bean
-  Charles-ton
-  Char-lottes-ville
-  Ches-ter
-  Chiang
-  Chich-es-ter
-  Cohen
-  Co-lum-bia
-  Czecho-slo-va-kia
-  Del-a-ware
-  Dijk-stra
-  Dor-ches-ter
-  Dorf-leit-ner
-  Drechs-ler
-  Duane
-  dy-na-mi-sche
-  Eijk-hout
-  Engle
-  Engel
-  Eng-lish
-  Euler-ian
-  Evan-ston
-  Feb-ru-ary
-  Fest-schrift
-  Flor-i-da
-  Flor-i-d-ian
-  For-schungs-in-sti-tut
-  Free-BSD
-  funk-tsional
-  Gauss-ian
-  Ge-sell-schaft
-  Ghost-script
-  Ghost-View
-  Gott-fried
-  Gott-lieb
-  Grass-mann-ian
-  Greifs-wald
-  Grothen-dieck
-  Grund-leh-ren
-  Ha-da-mard
-  Hai-fa
-  Hamil-ton-ian
-  Hel-sinki
-  Her-mit-ian
-  Hibbs
-  Hoef-ler
-  Hoek-water
-  Hok-kai-do
-  Huber
-  Image-Magick
-  Jac-kow-ski
-  Jan-u-ary
-  Ja-pa-nese
-  Java-Script
-  Jung-ian
-  Kad-om-tsev
-  Kan-sas
-  Karls-ruhe
-  Keynes-ian
-  Kor-te-weg
-  Krishna
-  Krish-na-ism
-  Krish-nan
-  Kron-ecker
-  Lan-cas-ter
-  Le-gendre
-  Leices-ter
-  Lip-schitz
-  Lip-schitz-ian
-  Loj-ban
-  Lou-i-si-ana
-  Lucas
-  MacBeth
-  Mac-OS
-  Ma-gel-lan
-  Ma-la-ya-lam
-  Man-ches-ter
-  Mar-kov-ian
-  Markt-ober-dorf
-  Mass-a-chu-setts
-  Max-well
-  Meth-od-ist
-  Meth-od-ism
-  Mi-cro-soft
-  Min-kow-ski
-  Min-ne-ap-o-lis
-  Min-ne-sota
-  Mont-real
-  Mos-cow
-  Nach-rich-ten
-  Nash-ville
-  Net-BSD
-  Net-scape
-  Nietz-sche
-  Nij-me-gen
-  Noe-ther-ian
-  Noord-wijker-hout
-  Noto-wi-digdo
-  No-vem-ber
-  Obst-feld
-  Open-BSD
-  Open-Office
-  Oreo-pou-los
-  Pala-tino
-  Pa-ler-mo
-  Pe-trov-ski
-  Pfaff-ian
-  Phil-a-del-phia
-  phi-lo-so-phi-sche
-  Poin-care
-  Po-ten-tial-glei-chung
-  Po-to-mac
-  Pres-by-terian
-  Pres-by-terians
-  Pyong-yang
-  Py-thag-o-ras
-  Py-thag-o-re-an
-  Ra-dha-krish-nan
-  raths-kel-ler
-  Ravi-kumar
-  Reich-lin
-  Rie-mann-ian
-  Ryd-berg
-  Schim-mel-pfen-nig
-  schot-ti-sche
-  Schro-din-ger
-  Schwa-ba-cher
-  Schwarz-schild
-  Schweid-nitz
-  Schwert
-  Sep-tem-ber
-  Shore-ditch
-  Skoup
-  Stokes-sche
-  Stutt-gart
-  Sus-que-han-na
-  Tau-ber-ian
-  tech-ni-sche
-  Ten-nes-see
-  Thiruv-ananda-puram
-  Tol-ches-ter
-  To-ma-szew-ski
-  Toyo-ta
-  ty-po-graphique
-  Ukrain-ian
-  ver-all-ge-mei-nerte
-  Ver-ei-ni-gung
-  Ver-tei-lun-gen
-  Vid-ias-sov
-  Vieth
-  viiith
-  viith
-  Wahr-schein-lich-keits-theo-rie
-  Wein-stein
-  Werk-zeuge
-  Wer-ner
-  Wer-ther-ian
-  Will-iam
-  Will-iams
-  Win-ches-ter
-  Wirt-schaft
-  wis-sen-schaft-lich
-  Wolff-ian
-  xviiith
-  xviith
-  xxiiird
-  xxiind
-  Ying-yong Shu-xue Ji-suan
-  Zea-land
-  Zeit-schrift
-}
-
-% EOF

_service:tar_scm:groff-1.22.4.tar.gz/tmac/safer.tmac Deleted

_service:tar_scm:groff-1.22.4.tar.gz/tmac/strip.sed Deleted

_service:tar_scm:groff-1.22.4.tar.gz/tmac/unicode.tmac Deleted

_service:tar_scm:groff-1.22.4.tar.gz/.tarball-version -> _service:tar_scm:groff-1.23.0.tar.gz/.tarball-version Changed

_service:tar_scm:groff-1.22.4.tar.gz/.version -> _service:tar_scm:groff-1.23.0.tar.gz/.version Changed

_service:tar_scm:groff-1.22.4.tar.gz/BUG-REPORT -> _service:tar_scm:groff-1.23.0.tar.gz/BUG-REPORT Changed

@@ -1,79 +1,72 @@
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
-#
-# 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
-# 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
-# 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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-
-			   Groff Bug Report
-
-Please read the PROBLEMS file before submitting a bug report.
+    Copyright (C) 1999-2020, 2022 Free Software Foundation, Inc.
+
+    Copying and distribution of this file, with or without
+    modification, are permitted in any medium without royalty provided
+    the copyright notice and this notice are preserved.
+
+			   groff Bug Report
+
+Please read the 'PROBLEMS' file before submitting a bug report.
 
 Please fill in all fields, even if you think they are not relevant.
 
-Please delete the text in brackets before submitting it.
+Please delete the text in square brackets before submitting it.
 
-Please report separate bugs separately.
+Please report distinguishable problems separately.
 
-Place the completed form in a new bug report at
-http://savannah.gnu.org/bugs/?group=groff.
+Place this completed form in a new bug report at
+<http://savannah.gnu.org/bugs/?group=groff>.  Click on the "Bugs" link,
+then select "Submit new" from the menu.
 
++verbatim+
 GROFF VERSION:
-The version of groff you are using.  For example, '1.22.4'
-
-MACHINE:
-The machine you are using.  For example, 'Sun SPARCstation 2'
+Put the output of the failing command when run with the '--version'
+option here.  For example, "groff --version" or "indxbib --version".
 
-OS:
-The operating system you are using.  For example, 'SunOS 4.1.1'
+PLATFORM:
+Put the output of the "uname -a" command here.  On non-POSIX systems,
+some alternative should be available; on Windows systems, use "ver".
 
-COMPILER:
-The compiler you used to compile groff.  For example, 'g++ 1.40.3'
+CONFIGURATION REPORT:
+If you compiled groff yourself, include the portion of the 'configure'
+script's output between rows of dashes.  If you didn't compile groff
+yourself, supply the packaging information from your distributor: in
+DEB- and RPM-based GNU/Linux distributions, gather it with the commands
+"dpkg -s groff" or "rpm -qi groff", respectively.
 
 INPUT FILES:
 Include all the files necessary to reproduce the problem that are not
-part of the standard groff distribution.  This includes font
-description files, DESC files and macro files (with the exception of
-the -ms and -mm macros: we have them).  Attach them to the bug report.
+part of the standard groff distribution.  This includes device and font
+description files and any macro files your document uses that groff does
+not supply.  Attach them to the bug report.
 
 It's easier for us if you can provide an example that doesn't depend on
 any macro package, but obviously if you're reporting a problem with a
-macro package that won't be possible.  Also a short example is more
+macro package that won't be possible.  Further, a short example is more
 convenient than a long one, but don't worry if you can't find a short
-example.  Don't say something like "any file that X": Always include a
-definite example.
+example.  A claim like "any file that X" is not helpful: always include
+a concrete example.
 
 COMMAND LINE:
 The command line that we should run in order to observe the bug.  For
-example, 'gtroff -Tps bug.tr'.  If the command line uses -ms or -mm,
-say whether these refer to the groff versions or the Unix versions of
-the macros.
+example, "groff -Tps bug.tr".
 
 DESCRIPTION OF INCORRECT BEHAVIOUR:
-What goes wrong when that command line is run?  For example, 'gtroff
-gets a segmentation fault', or 'The output looks bad because the bar
-over the x is too long and is too far over to the left.'  If you get an
-error message, include it here without modification: Don't edit it to
+What goes wrong when that command line is run?  For example, "groff
+gets a segmentation fault.", or "The output looks bad because the bar
+over the x is too long and is too far over to the left."  If you get an
+error message, include it here without modification: don't edit it to
 make it more readable.
 
 SUGGESTED FIX optional:
-If you can suggest a fix for the problem, include a context diff here.
-But don't delay submitting a bug report in the hope of finding a fix.
-Guesses about the cause of the bug are not usually helpful.
+If you can suggest a fix for the problem, you might include a unified
+diff here.  But don't delay submitting a bug report in the hope of
+finding a fix.  A guess about a bug's cause is not usually helpful.
+-verbatim-
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set filetype= textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog Changed

@@ -1,5318 +1,18665 @@
-2018-12-18 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2023-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix 'dvi' and 'pdf' texinfo doc generation.
+	ms: Offer advice to users of PDF who want a table of contents
+	at the front of the document.
 
-	GNU make has a built-in variable 'TEXI2DVI' but it is not the case
-	of all 'make' implementations, which causes 'make doc' to fail
-	with an unclear message although 'texi2dvi' is available.  Also,
-	'texi2dvi' is invoked inconditionnally.
+	* doc/groff.texi (ms Document Structure): Move mention of
+	pdfjam(1) from here...
+	(ms TOC): ...to here, and identify alternatives, including
+	gropdf(1)'s `pdfswitchtopage` macro.
 
-	* m4/groff.m4 (GROFF_TEXI2DVI): new macro to detect properly the
-	presence of 'texi2dvi'.
+	* doc/ms.ms (General structure of an ms document):
+	(Creating a table of contents): Similar.
 
-	* configure.ac: use 'GROFF_TEXI2DVI' and define automake conditional
-	'HAVE_TEXI2DVI'.
+	Fixes <https://savannah.gnu.org/bugs/?64278>.  Thanks to Michał
+	Kruszewski for the report.
 
-	* doc/doc.am:
-	- Define TEXI2DVI to 'texi2dvi'.
-	- Print an error message if 'texi2dvi' is not available.
+2023-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	docs: Migrate terminology to "scaling unit".
 
-	Install texinfo doc on 'make install-pdf' and 'make install-html'
+	...from "scaling indicator".
 
-	* doc/doc.am:
-	- Use automake 'install-pdf-local' and 'install-html-local' rules
-	to install groff.pdf and groff.html
-	- New rules 'uninstall_pdf' and 'uninstall_html'.
-	- Use $(RM) instead of 'rm'.
-	- Don't try to build doc if 'BUILD_INFODOC' is not set.
-	* INSTALL.REPO: document texinfo build and installation.
+	Fixes <https://savannah.gnu.org/bugs/?60957>.  Thanks to Ingo
+	Schwarze for the discussion.
 
-2018-12-10 Ingo Schwarze <schwarze@openbsd.org>
+2023-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.am: Remove the unused variables PREFIXMAN5 and PREFIXMAN7.
+	docs: Revise discussion of fonts.
 
-	They caused installation failures on Solaris 9.
+	* doc/groff.texi:
+	- Rename node/section "Fonts and Symbols" to "Using Fonts".  Add
+	  giant new introduction, properly establishing terminology.
+	- Rename node/section "Changing Fonts" to "Selecting Fonts".
+	  Shift location of `.fn` and `.sty` register documentation.
+	  Rewrite presentation of `ft` and `\f`.  Discuss typeface
+	  selection by mounting position and font (or style) name
+	  together; since arguments to these formatter instructions are
+	  always interpreted as mounting positions first, it doesn't
+	  make much sense to me to present them separately, and the new
+	  introduction provides the necessary background.  Tighten
+	  example.  Document that current and previous font selections
+	  are environment properties.
+	- Add several concept index entries.
+	- Do more migration from "symbol" and "glyph" names to "special
+	  character" names.
 
-2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* man/groff.7 (Using fonts): Introduce new section, synced with
+	the renamed node from our Texinfo manual above.
 
-	Remove gnulib's hypot module.
+	Fixes <https://savannah.gnu.org/bugs/?62973>.
 
-	The removal of 'GROFF_NEED_DECLARATION(hypot)' in 'configure.ac'
-	was correct as the test was buggy, but there is no need to use
-	gnulib's hypot module as previously we did not need to provide a
-	replacement function.
+2023-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* bootstrap.conf: do it.
+	docs: Revise "Page Layout" material.
 
-2018-12-08  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* doc/groff.texi:
+	- Recast generally.
+	- Describe behavior of `pl` in more detail.
+	- Migrate terminology from "scaling indicator" to "scaling
+	  unit".
+	- Stop discussing page margins in the context of the `pl`
+	  request.
+	- Move concept index entries regarding margins from here to
+	  "Traps".
+	- Move discussion of `pn` request to precede `tl` request.
+	- Add concept index entries.
+	- Recast description of `tl` request.  Migrate terminology from
+	  "justification" to "alignment".
+	- Recast description of `lt` request.  Describe behavior in more
+	  detail.
+	- Recast description of `pc` request.
+	- Add example of `lt` and `tl` usage.  Add forward reference to
+	  "Traps", mentioning page header and footer traps.
+
+	Fixes <https://savannah.gnu.org/bugs/?55124>.  Thanks to Dave
+	Kemper for the report.
 
-	Problem running gropdf on big endian (Sparc)
+2023-05-22  Dave Kemper <saint.snit@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: Prior to perl v5.9 the 'L<'
-	template for 'unpack' was unavailable. Solaris 10 uses v5.8.4
-	so safer to use the template 'V' rather than 'L<'.
+	docs: Correct minor punctuation, grammar, and spelling issues.
 
-2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Also remove a couple instances of unnecessarily telling the
+	reader to note something.
 
-	Use gnulib's 'hypot' module.
+	* doc/groff.texi:
+	* man/groff.7.man:
+	* man/groff_char.7.man:
+	* man/groff_diff.7.man:
+	* man/roff.7.man:
+	* src/roff/nroff/nroff.1.man: Do it.
 
-	In 'configure.ac', the macro call
-	'GROFF_NEED_DECLARATION(hypot)' checks whether the function
-	'hypot' is correctly declared in 'math.h', but the test is buggy
-	and may yields false results.
+	Fixes <https://savannah.gnu.org/bugs/?64230>.  I threw in a few
+	more fixes.  --GBR
 
-	* bootsrap.conf: add 'hypot' module.
+2023-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* configure.ac: Remove GROFF_NEED_DECLARATION(hypot).
+	docs: Attempt to further clarify end-of-sentence detection.
 
-	* src/libs/libgroff/hypot.cpp: remove declaration of hypot.
+	* doc/groff.texi (Sentences):
+	* man/roff.7 (Concepts): Do it.
 
-2018-12-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	Fixes <https://savannah.gnu.org/bugs/?64091>.  Thanks to Ingo
+	Schwarze and Dave Kemper for the report.
 
-	Problem running gropdf on big endian (Sparc)
+2023-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: When loading a binary (.pfb)
-	font for embedding always use little endian to unpack chunk
-	headers.
+	docs: Minimally document `tag`, `taga` requests.
 
-2018-12-05  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* doc/groff.texi (Postprocessor Access):
+	* man/groff.7 (Request short reference): Do it.
 
-	Skip mom tests if needed config is missing.
+	Fixes <https://savannah.gnu.org/bugs/?62695>.
 
-	* contrib/mom/examples/test-mom.sh.in: exit 77 if URW fonts are
-	not available.
+2023-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/mom/mom.am: distribute inconditionnally test-mom.in.
+	docs: Fix typos.
 
-	* m4/groff.m4 (GROFF_URW_FONTS): check if 'awk' and 'gs' are
-	available, and replace non-portable 'grep' command by awk script.
+	* doc/groff.texi (ms basic information):
+	* doc/ms.ms (Basic information): Do it.
 
-2018-12-01  Colin Watson  <cjwatson@debian.org>
+	Fixes <https://savannah.gnu.org/bugs/?64032>.  Thanks to an
+	anonymous reporter.
 
-	Fix error handling in tests of mom examples
+2023-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/mom/examples/test-mom.sh.in (check_number_pages): Correct
-	error message.
-	(check_has_images): Correct shell syntax error.
+	* doc/groff.texi (Operators in Conditionals):
+	* man/groff.7.in (Conditional expressions): Clarify how the
+	output comparison operator is recognized.
 
-2018-11-26  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Fixes <https://savannah.gnu.org/bugs/?63812>.  Thanks to John
+	Gardner for the report.
 
-	Document .sp behaviour in -me doc -- French translation
+2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/meintro_fr.me: translation of commit
-	7a83f7f5003e24f020306f09f4d497e04e82cb14.
+	Use a better type for symbol hashes.
 
-	Fixes bug https://savannah.gnu.org/bugs/?54958.
+	* bootstrap.conf: Add "stdint" module to ensure that the
+	`uintptr_t` type is available.
+	* src/include/symbol.h: Include <stdint.h> for `uintptr_t`.
+	(class symbol):
+	(symbol::hash): Change return type from `unsigned long`, which
+	causes build failures on 64-bit MinGW, to `uintptr_t`.
+	(symbol::hash): Use a C++ type cast, not a C-style one.
 
-2018-11-24  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Thanks to Bruno Haible for reporting the build failure in the
+	64-bit MinGW environment, and for suggesting a remedy.
 
-	Fix tarball generation: script 'makevarescape.sed' was missing.
+2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.am (EXTRA_DIST): add it.
+	groff: Revise a test to be more revealing.
 
-2018-11-24  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* src/roff/groff/tests/initialization_is_quiet.sh: Stop using
+	"set -e".  Instead use `fail` variable and `wail` function (and
+	lowercase names for our internal variables) like many of our
+	other tests.  If the "unset" shell built-in fails, skip the
+	test (prompted by /usr/xpg4/bin/sh on Solaris).  Attempt every
+	groff locale, with and without compatibility mode initially
+	enabled, instead of stopping at the first failure.  Report
+	standard error and standard output content separately.  Use
+	groff's `-a` flag to prepare the standard output, for
+	readability.
+	* PROBLEMS: Document that this test might be skipped rather than
+	failing on Solaris.  (What actually happens depends on which
+	shell you run it with, and we advise a variety of approaches.)
 
-	Add automatic tests on mom examples
+	Thanks to Bruno Haible for feedback regarding mysterious
+	failures of this test on GNU/Hurd and NetBSD systems.
 
-	* m4/groff.m4 (GROFF_PDFTOOLS): check presence of some pdf tools.
-	* configure.ac: use 'GROFF_PDFTOOLS', add new AM conditional.
-	* contrib/mom/examples/test-mom.sh.in: new file that use 'pdfinfo'
-	and 'pdfimages' to make some basic checks on mom examples.
+2023-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-11-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* bootstrap.conf (gnulib_modules): Add "stdbool-c99" per
+	recommendation from Bruno Haible.
 
-	tmac/sv.tmac: Set Swedish hyphenation flags to 32.
+	Fixes build problem on Solaris using Sun compiler.
 
-	This permits hyphenation after the first character but continues
-	prohibiting it before the last character of a word, in
-	congruence with the TeX-based hyphenation patterns we use.
+2023-03-06  Bruno Haible <bruno@clisp.org>
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?55066>.
+	* Makefile.am (AR): Remove hardcoded value. Let Automake use the
+	value from config.status.
 
-2018-11-19  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	{Fixes build problem on 64-bit AIX.  Problem appears to date
+	back to commit 5fec19d453, 2014-08-15. --GBR}
 
-	Fix build on environment where /etc/papersize contains comments
+2023-03-06  Bruno Haible <bruno@clisp.org>
 
-	Issue introduced on commit efea81c75f831ddc6717c2ef25556e0f49d1f679.
+	* arch/misc/misc.am (shdeps.sed): Rename target from this...
+	($(SH_DEPS_SED_SCRIPT)): ...to this, to work better with make(1)
+	on FreeBSD, NetBSD, and AIX.
 
-	* m4/groff.m4 (GROFF_PAGE): remove comments and get the 1st string
-	of '/etc/papersize'.
+2023-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+	build: Discard now-unneeded Autoconf macro and variables.
 
-	* m4/groff.m4 (GROFF_PAGE): Try /etc/papersize first.
+	* configure.ac: Stop calling `GROFF_POPPLER`.  Stop populating
+	the Automake conditional `HAVE_PDFTOOLS`.  Eliminate chatter
+	about their availability in the configuration report.
+	* m4/groff.m4 (GROFF_POPPLER): Delete.
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?53271>.
+2023-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Adapt wording of notice
+	to presence and identity of Ghostscript interpreter command.
+	Clarify that it is gropdf(1) specifically that traverses the
+	Ghostscript search path reported by its "-h" option.
 
-	* bootstrap.conf: Bump Autoconf dependency to 2.68.  We need it
-	to support our bug-reporting URL, which contains a "?".
-	Strictly, Autoconf 2.65 is fine, but 2.66 and 2.67 broke this.
-	Even 2.69 is over 6 years old now.
+	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
+	Deri James for the ongoing discussion.
 
-	See <https://savannah.gnu.org/support/?107450>.
+2023-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+	devpdf: Revise tests.
 
-	* m4/groff.m4 (GROFF_PAGE): Quote shell variables that are under
-	external control and may contain embedded whitespace.  A test
-	shows that our configure script is now robust in this way, but
-	our Automake files are not, starting with
-	src/utils/afmtodit/afmtodit.am.
+	* font/devpdf/tests/check-default-foundry.sh.in: Test only the
+	base 14 fonts of the PDF standard unconditionally.  Test the
+	remainder from the set of 35 commonly distributed only if a
+	Ghostscript interpreter was detected at configuration time,
+	because the latter fonts _must_ be embedded in PDF documents.
+	If they're not present, skip the test rather than failing it.
+	* font/devpdf/tests/check-urw-foundry.sh.in: Skip test if no URW
+	fonts detected at configuration time, rather than failing it.
+	* m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE)
+	(GROFF_URW_FONTS_NOTICE): Drop warnings of expected test
+	failures.  The tests no longer fail in the anticipated
+	circumstances.
 
-2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* makevarescape.sed:
-	  - Escape plain spaces and double-quotes (ASCII 32 and 34) so
-	    that bad things don't happen if they are embedded in a Make
-	    variable expanded in a man page @THUS@ _and_ given as an
-	    argument to a macro that distinguishes its parameters, such
-	    as .IR.
-	  - Add discretionary breaks after groups of slashes not
-	    preceded by a space; e.g., transform "/usr/bin/groff" into
-	    "/usr/\:bin/\:groff".  Will also work on URLs
-	    {"https://\:example.com/\:page.html"} in case we need that.
+	devpdf: Generate tests from template files, so we can populate
+	the test scripts with information determined at configuration.
+	The default foundry test depends on $GHOSTSCRIPT, and the URW
+	foundry test on $urwfontsdir.
 
-2018-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* font/devpdf/tests/check-default-foundry.sh:
+	* font/devpdf/tests/check-urw-foundry.sh: Rename these...
+	* font/devpdf/tests/check-default-foundry.sh.in:
+	* font/devpdf/tests/check-urw-foundry.sh.in: ...to these.
 
-	Undocument Werner and Ted as groff maintainers.
+	* font/devpdf/devpdf.am (font_devpdf_default_test)
+	(font_devpdf_urw_test): New variables store names of generated
+	test scripts.
+	(font/devpdf/tests/check-default-foundry.sh):
+	(font/devpdf/tests/check-urw-foundry.sh): New targets produce
+	test scripts from corresponding .in files.
 
-	* README:
-	* doc/pic.ms:
-	* src/roff/grog/grog.pl:
-	* src/roff/nroff/nroff.sh: Werner (and Ted) retired from the
-	role some time ago and Bertrand Garrigues has stepped up; see
-	https://lists.gnu.org/archive/html/groff/2017-09/msg00048.html.
-	I'll let him document his maintainer status as and where he
-	prefers.
-
-2018-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
-
-	Stop spelling "Unix" as "UNIX".
-
-	Per AT&T Bell Labs veterans Doug McIlroy and Meg McRoberts,
-	spelling "Unix" in full caps was a contrivance insisted upon by
-	AT&T lawyers, and not a practice used in the Unix manuals
-	themselves or the Bell Labs Technical Journal.  See
-	  https://lists.gnu.org/archive/html/groff/2015-01/msg00026.html
-	and
-	  https://lists.gnu.org/archive/html/groff/2015-01/msg00029.html
-	for support.
+2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	devpdf: Trivially refactor.  Rename sed-substitutum Lat.
+	from "@GROFF_GHOSTSCRIPT_INTERPRETERS@" to "@GHOSTSCRIPT@" for
+	clarity and brevity; this is a scalar value containing the
+	Autoconf-determined name of the Ghostscript interpreter.  It is
+	not the same as the replacement that occurs in contrib/pdfmark.
+
+	* font/devpdf/devpdf.am:
+	* font/devpdf/util/BuildFoundries.pl: Do it.
+
+2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Stop scraping output of Ghostscript executable with
+	"-h" option to attempt to find URW fonts.  Fonts that ship with
+	Ghostscript are regarded as the "default" foundry, not the URW
+	foundry (though they often ultimately originate with URW fonts).
+	They are often missing Adobe Font Metric (AFM) files, so it is
+	impossible for groff to generate font description files for them
+	at build time.
+
+	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Drop `AC_REQUIRE` on
+	`GROFF_AWK_PATH`.  Drop awk-based scraping of Ghostscript "-h"
+	output.  Annotate need for sync between this list of
+	characteristic font file names and the one in BuildFoundries.
+
+	Thanks to Deri James for the ongoing discussions.
+
+2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac: Drop now-redundant explicit
+	`GROFF_URW_FONTS_CHECK`.  `GROFF_GROPDF_DEPENDENCIES_CHECK`
+	`AC_REQUIRE`s it as of commit ec001d2a23, 18 February.
+
+2023-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): When looking for a
+	characteristic URW font by its file name, also check for
+	"URWGothic-Book" with no file extension.  Avoids false negatives
+	in URW Type 1 font detection when using Ghostscript 9.53.3.
+	Thanks to Deri James for suggesting the test procedure that
+	uncovered this flaw.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am (uninstall_groffdirs): Remove "html.mono" and
+	"html.node" directories corresponding to HTML version of our
+	Texinfo manual.
+	* doc/doc.am (uninstall-html): Uninstall HTML version of our
+	Texinfo manual more reliably.
+
+	Fixes a regression introduced by me in commit c2698aade, 6 April
+	{my claim "we're only deleting files with this command, not
+	directories" was not correct}.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	doc: Handle output formats of our Texinfo manual more
+	consistently.
+
+	* doc/doc.am (install-doc): Add dependency on (Automake
+	standard) target 'install-dvi'.
+	(maintainer-clean-local): Remove our Texinfo manual in plain
+	text format.
+	(install-data-local): Add dependency on new target
+	'install-txt'.
+	(install-txt): Install our Texinfo manual in plain text format.
+	(uninstall-local): Add dependency on new target 'uninstall-txt'.
+	(uninstall-txt): Uninstall our Texinfo manual in plain text
+	format.
+
+	Thanks to T. Kurt Bond for noticing the discrepancy.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (install-pdf-local, install-html-local): Enable
+	rules to work in out-of-tree builds.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (uninstall-hook): Drop dependency on
+	"uninstall_mom"; this is not the appropriate place to declare
+	it, and "uninstall_groffdirs" already depends on it in mom's
+	Automake file.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Have more tests report output.
+
+	* src/roff/groff/tests/ab_works.sh:
+	* src/roff/groff/tests/handle_special_input_code_points.sh:
+	* src/roff/groff/tests/initialization_is_quiet.sh:
+	* src/roff/groff/tests/msoquiet_works.sh:
+	* src/roff/groff/tests/soquiet_works.sh:
+	* tmac/tests/an-ext_MR-works.sh:
+	* tmac/tests/an_MR-works.sh: Do it.
+
+2023-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Prevent failures when $GROFF_ENCODING is set.
+
+	* src/roff/groff/tests/ab_works.sh:
+	* src/roff/groff/tests/handle_special_input_code_points.sh:
+	* src/roff/groff/tests/initialization_is_quiet.sh:
+	* src/roff/groff/tests/msoquiet_works.sh:
+	* src/roff/groff/tests/soquiet_works.sh:
+	* tmac/tests/an-ext_MR-works.sh:
+	* tmac/tests/an_MR-works.sh:
+	* tmac/tests/an_font-remapping-does-not-affect-titles.sh: Unset
+	$GROFF_ENCODING before running test because preconv(1) confounds
+	these tests.
 
-	There are instances I did _not_ change; they may require further
-	review.
-		ChangeLog.*
-		NEWS
-			One reference relevant to mdoc; see below.
-		doc/meintro{,_fr}.me
-			These documents also give the small caps
-			treatment to groff, troff, and nroff, suggesting
-			a separate changeset.
-		src/preproc/pic/pic.ypp
-			Contains a comment referring to "Compaq Tru64
-			UNIX"; not worth the candle IMO.
-		tmac/s.tmac:
-			{ms macro package} Leaving UX macro definition
-			alone until/unless it can be established that
-			this doesn't change the rendering of historical
-			documents in an objectionable way.
-		tmac/doc-syms-u:
-		tmac/doc-old.tmac-u:
-		tmac/doc-common-u:
-		tmac/groff_mdoc.7.man:
-			{mdoc macro package} Similar; mdoc defines many
-			strings that spit out "UNIX" (albeit not with a
-			font size change).
+	Thanks to Alexis for reporting this problem.
 
-	* MORE.STUFF:
+2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Rename test.
+
+	* tmac/tests/s_no-excess-space-around-displays.tmac: Rename...
+	* tmac/tests/s_no-excess-space-around-displays.sh: ...to this.
+	* tmac/tmac.am (tmac_TESTS): Update.
+
+2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gropdf: Revise tests to run unconditionally, rather than
+	configuring them away at build time, which can cause a
+	distribution archive to be incorrectly structured.  Update
+	configuration notices when optional dependencies are absent.
+
+	* font/devpdf/devpdf.am (font_devpdf_TESTS): Remove `USE_GROPDF`
+	and `HAVE_URW_FONTS` conditionals.
+	* m4/groff.m4 (GROFF_GROPDF_PROGRAM_NOTICE):
+	(GROFF_URW_FONTS_NOTICE): Warn reader that a gropdf test failure
+	is to be expected.
+
+	Fixes <https://savannah.gnu.org/bugs/?63824> (2/2).
+
+2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Revise tests to check for requisite programs at test
+	time and skip if not found, rather than configuring them away at
+	build time, which can cause a distribution archive to be
+	incorrectly structured.
+
+	* m4/groff.m4: Annotate requisite program list since we're
+	violating the DRY principle.
+	* src/roff/groff/groff.am (groff_TESTS): Populate
+	unconditionally.
+
+	* src/roff/groff/tests/html_works_with_grn_and_eqn.sh:
+	* src/roff/groff/tests/smoke-test_html_device.sh: Check for
+	requisite programs and skip test if any are not found.
+
+	Fixes <https://savannah.gnu.org/bugs/?63824> (1/2).
+
+2023-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Define page-local `MR` fallback.
+
+	man pages: Provide page-local fallback definition of new `MR`
+	macro.  I didn't think I was going to have to do this, but the
+	premier site on the web for viewing Linux man pages, Michael
+	Kerrisk's man7.org, has been pulling snapshots of the pages
+	themselves without upgrading the underlying macros, and so man
+	page cross references set with `MR` are getting lost in its
+	presentations.  (I acknowledge: Ingo Schwarze warned me
+	something like this could happen.)  This definition is intended
+	as a stopgap measure only.  I want to revert this after groff
+	1.23 is released and has spread to some reasonable degree.
+
+	* contrib/chem/chem.1.man:
+	* contrib/eqn2graph/eqn2graph.1.man:
+	* contrib/gdiffmk/gdiffmk.1.man:
+	* contrib/glilypond/glilypond.1.man:
+	* contrib/gperl/gperl.1.man:
+	* contrib/gpinyin/gpinyin.1.man:
+	* contrib/grap2graph/grap2graph.1.man:
+	* contrib/hdtbl/groff_hdtbl.7.man:
+	* contrib/mm/groff_mm.7.man:
+	* contrib/mm/groff_mmse.7.man:
+	* contrib/mm/mmroff.1.man:
+	* contrib/mom/groff_mom.7.man:
+	* contrib/pdfmark/pdfroff.1.man:
+	* contrib/pic2graph/pic2graph.1.man:
+	* contrib/rfc1345/groff_rfc1345.7.man:
+	* man/groff.7.man:
+	* man/groff_char.7.man:
+	* man/groff_diff.7.man:
+	* man/groff_font.5.man:
+	* man/groff_out.5.man:
+	* man/groff_tmac.5.man:
+	* man/roff.7.man:
+	* src/devices/grodvi/grodvi.1.man:
+	* src/devices/grohtml/grohtml.1.man:
+	* src/devices/grolbp/grolbp.1.man:
+	* src/devices/grolj4/grolj4.1.man:
+	* src/devices/gropdf/gropdf.1.man:
+	* src/devices/gropdf/pdfmom.1.man:
+	* src/devices/grops/grops.1.man:
+	* src/devices/grotty/grotty.1.man:
+	* src/devices/xditview/gxditview.1.man:
+	* src/preproc/eqn/eqn.1.man:
+	* src/preproc/eqn/neqn.1.man:
+	* src/preproc/grn/grn.1.man:
+	* src/preproc/pic/pic.1.man:
+	* src/preproc/preconv/preconv.1.man:
+	* src/preproc/refer/refer.1.man:
+	* src/preproc/soelim/soelim.1.man:
+	* src/preproc/tbl/tbl.1.man:
+	* src/roff/groff/groff.1.man:
+	* src/roff/nroff/nroff.1.man:
+	* src/roff/troff/troff.1.man:
+	* src/utils/addftinfo/addftinfo.1.man:
+	* src/utils/afmtodit/afmtodit.1.man:
+	* src/utils/grog/grog.1.man:
+	* src/utils/hpftodit/hpftodit.1.man:
+	* src/utils/indxbib/indxbib.1.man:
+	* src/utils/lkbib/lkbib.1.man:
+	* src/utils/lookbib/lookbib.1.man:
+	* src/utils/pfbtops/pfbtops.1.man:
+	* src/utils/tfmtodit/tfmtodit.1.man:
+	* src/utils/xtotroff/xtotroff.1.man:
+	* tmac/groff_man.7.man.in:
+	* tmac/groff_me.7.man:
+	* tmac/groff_ms.7.man:
+	* tmac/groff_trace.7.man:
+	* tmac/groff_www.7.man: Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?63825>.  Thanks greatly to
+	Alexis for identifying an issue with mandoc(1)'s handling of an
+	earlier iteration of this fallback, and to John Gardner for
+	identifying a method of detecting mandoc as the renderer at
+	formatting time.
+
+2023-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Improve
+	portability of script by using shell constructs instead of the
+	nonstandard GNU coreutils 'seq' utility.  Resolves test failure
+	on Solaris 10.
+	* HACKING: Document this problem.
+
+2023-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_MAKE_DEFINES_RM): Test the make(1) in the
+	environment variable $MAKE if defined, not a literal "make".
+	Required on (some) Solaris 10 configurations where traditional
+	make(1) is not installed but GNU make is installed as "gmake".
+
+2023-02-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/latin2_works.sh: Fix missing backslash in printf.
+	Solaris printf(1) was sensitive to this error; macOS and GNU
+	printf were not.  Fixes a test failure on Solaris 11.
+
+2023-02-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/regression_savannah_58153.sh: Improve
+	portability.  Avoid the unpredictability of implementations when
+	putting backslashes inside a groff-piped printf shell command
+	inside a here document inside a command substitution by changing
+	the groff escape character to something meaningless to the shell
+	and to printf ('@').  Fixes a test failure on Solaris 11.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/Foundry.in: Recognize URW foundry replacements for
+	Helvetica Bold-Oblique and Helvetica Oblique under the file
+	names "NimbusSans-BoldItalic.t1" and "NimbusSans-Italic.t1",
+	respectively.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (uninstall-pdf): Clean more fastidiously; try to
+	remove the configured `pdfdocdir` in the event it is empty, but
+	do not fail if it isn't.  (It can be a directory shared with
+	other groff components; we don't know in what order the
+	uninstall targets will serialize, but the last one run should
+	succeed.)
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Detangle "pdfroff" and "gropdf" configuration (2/2).
+
+	* m4/groff.m4: Give pdfroff its own Autoconf macros to handle
+	dependency checking, build objectives, and user notice.
+	(GROFF_PDFROFF_DEPENDENCIES_CHECK): New macro requires
+	`GROFF_AWK_PATH` and `GROFF_GHOSTSCRIPT_PATH`, determines
+	whether pdfroff can be used at build time, and (if not)
+	constructs part of message to be shown to user explaining why.
+	(GROFF_PDFROFF_PROGRAM_NOTICE): New macro requires
+	`GROFF_PDFROFF_DEPENDENCIES_CHECK` and emits message if needed.
+	(GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): Drop mention of impact
+	on pdfroff since its dedicated notice covers this now.
+	* configure.ac: Call the new macros at appropriate times.
+	Produce a new Automake macro, `USE_PDFROFF`, to replace
+	inapposite use of `USE_GROPDF` in pdfmark.am.
+	* contrib/pdfmark/pdfmark.am: Use `USE_PDFROFF` instead of
+	`USE_GROPDF`.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Detangle "pdfroff" and "gropdf" configuration (1/2).
+
+	* m4/groff.m4 (GROFF_GROPDF_DEPENDENCIES_CHECK): Add
+	`AC_REQUIRE`ment on `GROFF_URW_FONTS_CHECK`.  Per discussion
+	with Deri James, if _either_ Ghostscript or the URW fonts are
+	avilable, gropdf will be fully functional, consequent to commit
+	d5515, 22 June.  Drop dependency on awk; it is used only at
+	configuration time (in an Autoconf macro) and since Savannah
+	#62775 was resolved (19 September), it has not been strictly
+	necessary.  (It is useful for searching more locations for URW
+	fonts, but several others are searched even if it is absent.)
+	Stop populating notice text here, instead moving it...
+	(GROFF_GROPDF_PROGRAM_NOTICE): ...here, since it no longer needs
+	to be dynamically constructed.
+
+	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
+	Deri James for the continued discussion.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Rename `GROFF_CHECK_GROPDF_PROGRAMS` macro to
+	`GROFF_GROPDF_DEPENDENCIES_CHECK` to generalize for greater
+	accuracy in forthcoming change.
+
+	* configure.ac:
+	* m4/groff.m4: Do it.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gropdf: Don't run automated tests if 'gropdf' will be
+	operating with reduced function.  If neither Ghostscript nor the
+	URW fonts are available at configuration time, there is no point
+	testing for successful build-time population of the font
+	descriptions for the default and URW foundries.
+
+	* font/devpdf/devpdf.am (font_devpdf_TESTS) USE_GROPDF: Run
+	"check-default-foundry" only if gropdf is fully functional.
+	(font_devpdf_TESTS) USE_GROPDF && HAVE_URW_FONTS: Run
+	"check-urw-foundry" only if the URW fonts were found.
+
+	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
+	Deri James for the continued discussion.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gropdf: Rename tests to more accurately characterize their
+	purpose.
+
+	* font/devpdf/tests/basic-fonts-present.sh:
+	* font/devpdf/tests/urw-fonts-present.sh: Rename these...
+	* font/devpdf/tests/check-default-foundry.sh:
+	* font/devpdf/tests/check-urw-foundry.sh: ...to these.
+	* font/devpdf/devpdf.am (font_devpdf_TESTS): Reflect rename.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gropdf: Revise tests to be foundry-focussed.
+
+	* font/devpdf/tests/basic-fonts-present.sh: Stop trying to match
+	font descriptions in the "devps" directory with ones in
+	"devpdf"; instead, test whether "BuildFoundries" did its job.
+	Test for font descriptions corresponding to the full 35
+	PostScript Level 2 font repertoire, plus groff's "EURO".
+	* font/devpdf/tests/urw-fonts-present.sh: Drop stale comment and
+	rename variable for better parallelism with the other test
+	above.
+
+	Continues <https://savannah.gnu.org/bugs/?63808>.  Thanks to
+	Deri James for the continued discussion.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Tweak fix to Savannah #63768.
+
+	* tmac/an.tmac (MR): Ensure `an*url` always has a value,
+	defaulting to "format 1" (man:page(section)).  Resequence the
+	macOS URL formats to sort the contemporary one before the
+	others.
+	* tmac/man.local: Reflect resequencing of integer assignments to
+	formats.  Clarify historicity of annotations.
+
+	Continues <https://savannah.gnu.org/bugs/?63768>.  Thanks to
+	John Gardner for further discussion.
+
+2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Port a test to Solaris 11 sed.
+
+	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Put
+	newlines after opening braces in sed scripts.  macOS and GNU sed
+	tolerate their absence, but this sed does not.
+	* HACKING: Document this problem.
+
+2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.am (groff_TESTS) !USE_GROHTML: Don't
+	test the 'grohtml' driver if we know it won't work.
+
+2023-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/\
+	device_control_escapes_express_basic_latin.sh: Use printf(1),
+	which is often a shell built-in command, more consistently.
+	Double backslashes intended as literals in the format string,
+	and single-quote format strings using them.  Fixes test failure
+	seen on Solaris 11 with GNU Bash 4.4 and ksh 93u+ (2012-08-01).
+
+2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an_use-input-traps-correctly.sh: Explicitly test
+	`SM` and `SB` with 'ps' output device.  If one set
+	GROFF_TYPESETTER=utf8 in the test environment, these test cases
+	would fail.  Thanks to John Gardner for the report.
+
+2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac: Add Automake conditional, `HAVE_GHOSTSCRIPT`, so
+	that we can populate the list of PDF device font tests
+	dynamically.  Call new macro
+	`GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE`.  Call
+	`GROFF_GHOSTSCRIPT_VERSION_NOTICE` after it, but before
+	`GROFF_URW_FONTS_NOTICE`.
+	* m4/groff.m4 (GROFF_AWK_NOTICE): New macro produces warning if
+	no awk could be found.  This reduces gropdf functionality, but
+	so do missing URW fonts, so we report this problem separately.
+	Report the names under which we sought it, since there's a
+	configure script option for that.
+	(GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE): New macro explains
+	consequences of missing optional dependency on Ghostscript
+	program: reduced grohtml functionality, nonfunctional pdfroff.
+	Report the names under which we sought it, since there's a
+	configure script option for that.
+	(GROFF_CHECK_GROPDF_PROGRAMS): Better characterize gropdf's
+	reduced function, pointing out the ways in which it would be
+	more useful if the dependencies were met.  Also simplify the
+	computational grammar.
+	(GROFF_URW_FONTS_NOTICE): Identify 'U' as the foundry name
+	gropdf uses for the URW fonts.  Confirm continuing availability
+	of most recent URW fonts release; bump date.
+	* font/devpdf/devpdf.am: Test availability of "basic" (PDF base
+	14) fonts (plus groff's "EURO") if either Ghostscript or URW
+	fonts are available.  Test availability of URW fonts (35) only
+	if Ghostscript _and_ the URW fonts were found at configuration
+	time.
+
+	Fixes <https://savannah.gnu.org/bugs/?63808>.  Thanks to Deri
+	James for the report and extremely helpful pseudocode.
+
+2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK,
+	GROFF_URW_FONTS_NOTICE): Add macro dependency on
+	`GROFF_GHOSTSCRIPT_PATH`, which should have been there already.
+	(GROFF_GROHTML_PROGRAM_NOTICE): Add macro dependency on
+	`GROFF_CHECK_GROHTML_PROGRAMS`, which should have been there
+	already.
+
+	(GROFF_CHECK_GROHTML_PROGRAMS, GROFF_PNMTOOLS_CAN_BE_QUIET):
+	Move `AC_REQUIRE` expansions to precede shell variable
+	assignments (after checking that the required macros don't
+	clobber the assignments we're making).
+
+2023-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/tests/basic-fonts-present.sh: Revise test again,
+	per feedback from Deri James.  Even without Ghostscript or URW
+	fonts available, gropdf can generate valid PDF documents; it
+	simply can't embed fonts in general (without further
+	arrangements made on the host system), which means it is
+	restricted to the PDF base 14 fonts.  That's enough for many
+	purposes, including generating our compiled man pages document
+	{with minor degradations to the typeface lists in gropdf(1) and
+	grops(1)}.  Drop the 'gs' command check, which also didn't check
+	for the name of the Ghostscript interpreter determined by the
+	"configure" script.  Replace dynamically generated font list
+	with a static one (the base 14 fonts plus groff's EURO).
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/tests/basic-fonts-present.sh: Revise test.
+	Improve explanation of why we're looking for the gs(1) command
+	in a font availability test.  Prefix diagnostic output with name
+	of test script.  Perform a search for the 'ps' device font
+	descriptions that will work in more build scenarios (i.e., don't
+	assume an out-of-tree build taking place in an immediate
+	subdirectory of the source).  Distinguish failure to find the
+	font descriptions from a failure to locate the 'gs' command,
+	skipping the test in both scenarios.  Reduce noise in output.
+	* m4/groff.m4 (GROFF_CHECK_GROPDF_PROGRAMS): Revise warning
+	issued when awk and Ghostscript are unavailable; gropdf will not
+	be completely inoperative.  Characterize its reduced function.
+
+	Thanks to Deri James in <https://lists.gnu.org/archive/html/\
+	groff-commit/2023-02/msg00089.html> for prompting me to take a
+	another look at this.
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/latin2_works.sh:
+	* tmac/tests/latin5_works.sh:
+	* tmac/tests/latin9_works.sh: Port to work around macOS's
+	apparently POSIX non-conforming 'od' command.  Use single-byte
+	octal output format instead of "character", and update test
+	expectations accordingly.  Apparently gratuitously, macOS also
+	puts more spaces after the octal address field when using this
+	output format.
+	* HACKING: Document, and elaborate upon, this problem.
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Port a test to work with macOS sed.
+
+	* tmac/tests/doc_heading-font-remapping-works.sh: Put semicolons
+	between commands and closing braces in sed script.  Put each of
+	multiple closing braces on a separate input line, because macOS
+	doesn't accept them otherwise.  Resolves test failure observed
+	on macOS.
+	* HACKING: Document the closing brace sequence problem.
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Port a test to work with macOS sed.
+
+	* tmac/tests/an_TS-adds-no-vertical-space.sh: Put semicolons
+	between commands and closing braces in sed script.  Separate
+	command stream into multiple '-e' expressions, breaking them
+	after branch and label commands.  Resolves test failure observed
+	on macOS.
+	* HACKING: Document the above problems.
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/\
+	some_escapes_accept_newline_delimiters.sh: Weaken regexes in two
+	test cases to accommodate excessive output from macOS's 'od'
+	command.  Resolves test failure seen on macOS.
+	* HACKING: Add section "Writing Tests" and document the above
+	since this is the second time I've cracked my shin on this.
+
+2023-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/tests/basic-fonts-present.sh: Skip test if 'gs'
+	command not available.  The test is to ensure that gropdf will
+	produce sound documents using the base fonts from PostScript,
+	but since gropdf requires Ghostscript to do this (as noted in
+	our "./configure" messages), it makes no sense to validate font
+	availability if the program is absent.  Resolves test failure
+	seen on macOS with minimal dependencies installed.
+
+2023-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Manipulating Filling and Adjustment): Say more
+	about the consequences of a break.
+
+	Fixes <https://savannah.gnu.org/bugs/?63777>.  Thanks to Dave
+	Kemper for the report.
+
+2023-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	docs: Re-re-christen 'ESCAPE_AMPERSAND' ('\&').  Now call it a
+	{non-transparent} "dummy character".  Also rechristen
+	'ESCAPE_RIGHT_PARENTHESIS', ('\)') as the "transparent dummy
+	character"; it has no impact on sentence-ending detection.
+
+	* doc/groff.texi:
+	* doc/meref.me.in:
+	* man/groff.7.man:
+	* man/groff_diff.7.man:
+	* man/roff.7.man:
+	* src/preproc/refer/refer.1.man:
+	* tmac/groff_man.7.man.in: Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?62816>.  Thanks to Dave
+	Kemper for the report and to the groff mailing list for the
+	vigorous discussion.  I don't expect my solution to please
+	everyone.
+
+2023-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Add internal register `an*MR-URL-format` to
+	select from a few known formats of man page hyperlink.  There
+	are three known on macOS, and one used everywhere else.
+	* tmac/man.local: Document this feature so macOS users can enjoy
+	the OSC 8 hyperlink feature if their terminal application
+	supports it.
+
+	I hope that this feature will be a temporary measure while macOS
+	implements support for the man page URL format used everywhere
+	else in the world.
+
+	Fixes <https://savannah.gnu.org/bugs/?63768>.  Thanks to John
+	Gardner for the report, research, consultation, and testing.
+
+2023-02-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	BuildFoundries: Fails if neither ghostcript nor URW fonts
+	are installed.
+
+	* font/devpdf/util/BuildFoundries.pl: When the change to hold
+	paths in an array, rather than a delimited string (see commit
+	4ae4aeb6555f4f16c28fcb03eb1f56577826054c), the FindGSpath
+	subroutine should return a pointer to an empty array when the
+	call to ghostscript fails, rather than return an empty string,
+	as was done previously.
+
+	See <https://lists.gnu.org/archive/html/groff/2023-02/\
+	msg00042.html>; thanks to Bruno Haible for the report.
+
+2023-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Switch to using system's assert.h header file.  It is futile to
+	attempt to preserve compatibility with ISO C90 systems by
+	providing a bespoke predicate-reporting assert() (a C99 feature)
+	when gnulib, which we require, itself demands C99.  This ensures
+	that `static_assert` remains defined so that gnulib can use it.
+	Thanks to Bruno Haible for the consultation.
+	<https://lists.gnu.org/archive/html/groff/2023-02/msg00034.html>
+
+	* src/include/assert.h: Delete.
+
+	* src/devices/grodvi/dvi.cpp:
+	* src/devices/grolbp/lbp.cpp:
+	* src/devices/grolj4/lj4.cpp:
+	* src/include/itable.h:
+	* src/include/stringclass.h:
+	* src/libs/libbib/linear.cpp:
+	* src/libs/libbib/search.cpp:
+	* src/libs/libdriver/printer.cpp:
+	* src/libs/libgroff/assert.cpp:
+	* src/libs/libgroff/color.cpp:
+	* src/libs/libgroff/errarg.cpp:
+	* src/libs/libgroff/font.cpp:
+	* src/libs/libgroff/nametoindex.cpp:
+	* src/libs/libgroff/prime.cpp:
+	* src/libs/libgroff/relocate.cpp:
+	* src/libs/libgroff/searchpath.cpp:
+	* src/preproc/eqn/box.cpp:
+	* src/preproc/eqn/delim.cpp:
+	* src/preproc/eqn/pile.cpp:
+	* src/preproc/eqn/script.cpp:
+	* src/preproc/html/pre-html.cpp:
+	* src/preproc/pic/pic.h:
+	* src/preproc/preconv/preconv.cpp:
+	* src/preproc/soelim/soelim.cpp:
+	* src/roff/groff/groff.cpp:
+	* src/roff/troff/troff.h:
+	* src/utils/hpftodit/hpftodit.cpp:
+	* src/utils/indxbib/indxbib.cpp:
+	* src/utils/lkbib/lkbib.cpp:
+	* src/utils/lookbib/lookbib.cpp:
+	* src/utils/tfmtodit/tfmtodit.cpp: Respell "assert.h" inclusion
+	with angle brackets instead of quotation marks.
+
+	Fixes <https://savannah.gnu.org/bugs/?63078>.
+
+2023-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (token::next): Use correct kind of
+	null object in comparison.  Fixes latent bug that would be
+	exposed if we were to migrate from zero literals to `nullptr`.
+
+2023-02-09  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf Parse multiple entries in 'papersize' as specified in
+	the groff_font man page. Reported by Ben Wong and fix based on
+	his patch, thanks.
+
+	* src/devices/gropdf/gropdf.pl: Parse papersize string for
+	possible multiple (space separated) entries. First valid entry
+	wins.
+
+	Fixes https://savannah.gnu.org/bugs/?63757
+
+2023-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Correct numerous typos and solecisms throughout the source tree.
+
+	* ChangeLog:
+	* ChangeLog.115:
+	* ChangeLog.116:
+	* ChangeLog.117:
+	* ChangeLog.118:
+	* ChangeLog.119:
+	* ChangeLog.121:
+	* ChangeLog.122:
+	* Makefile.am:
 	* NEWS:
-	* README.MinGW:
-	* contrib/groffer/README:
+	* PROBLEMS:
+	* README:
+	* contrib/chem/chem.am:
+	* contrib/chem/chem.pl:
+	* contrib/glilypond/README.txt:
+	* contrib/glilypond/glilypond.pl:
+	* contrib/hdtbl/groff_hdtbl.7.man:
+	* contrib/mm/ChangeLog:
+	* contrib/mm/m.tmac:
 	* contrib/pdfmark/pdfmark.ms:
-	* contrib/pdfmark/pdfroff.1.man:
+	* doc/automake.mom:
 	* doc/groff.texi:
+	* doc/me-revisions:
 	* doc/webpage.ms:
-	* m4/groff.m4:
+	* m4/lib-link.m4:
+	* man/groff.7.man:
 	* man/groff_diff.7.man:
-	* man/groff_tmac.5.man:
 	* man/roff.7.man:
+	* src/devices/grohtml/post-html.cpp:
+	* src/devices/grolbp/lbp.h:
+	* src/devices/gropdf/TODO:
+	* src/devices/gropdf/gropdf.1.man:
+	* src/devices/gropdf/gropdf.pl:
+	* src/devices/xditview/ChangeLog:
+	* src/devices/xditview/xditview.c:
+	* src/libs/libdriver/input.cpp:
+	* src/libs/libgroff/glyphuni.cpp:
+	* src/preproc/eqn/eqn.1.man:
+	* src/preproc/grn/gprint.h:
+	* src/preproc/grn/main.cpp:
 	* src/preproc/html/pre-html.cpp:
-	* src/roff/troff/troff.1.man: Change "UNIX" to "Unix",
-	discarding markup as necessary.
+	* src/preproc/preconv/preconv.cpp:
+	* src/preproc/tbl/table.cpp:
+	* src/roff/groff/pipeline.c:
+	* src/roff/groff/tests/substring_works.sh:
+	* src/roff/groff/tests/
+	use_point_size_escape_with_single_digit_arg.sh:
+	* src/roff/troff/div.cpp:
+	* src/roff/troff/input.cpp:
+	* src/roff/troff/troff.1.man:
+	* src/utils/grog/grog.pl:
+	* src/utils/indxbib/indxbib.cpp:
+	* src/utils/tfmtodit/tfmtodit.1.man:
+	* tmac/doc-old.tmac:
+	* tmac/doc.tmac:
+	* tmac/groff_man.7.man.in:
+	* tmac/hyphen.fr: Do it.
 
-2018-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+	Fixes <https://savannah.gnu.org/bugs/?63589>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	man pages: Escape interpolated Make variables.
+2023-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* makevarescape.sed: Transform - to \-, ~ to \(ti, and so forth,
-	{with an extra layer of backslashes--see below} so that Makefile
-	variables containing ASCII characters that do not represent
-	themselves literally in *roff (see groff_char(7)) are correctly
-	interpolated into man page text.
+	tbl: Drop XFAIL test.  It was written with an unclear
+	understanding of how DWB (AT&T) and Heirloom Doctools troff
+	behaved.  The individual checks might come back, modified.
 
-	* Makefile.am (.man): Transform Makefile variables with the
-	above script when interpolating them into man page text.
+	* src/preproc/tbl/tests/table-lacks-spurious-top-border.sh:
+	Delete.
 
-	Note that while the script, combined with this target, will
-	transform ` to \(ga, including grave accents in Makefile
-	variables is likely to fail when the shell lexes the argument to
-	echo within the old-style command substitution ``.  Testing
-	shows that grave accents should work1 if POSIX-style command
-	substitution $() is done instead.  However, $() is less
-	portable.  (Triple-escaping grave accents \\\` inside the
-	interpolated Makefile variable will work, but is not attempted
-	at present.)
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Drop it.
+	(tbl_XFAIL_TESTS, XFAIL_TESTS): Drop now empty assignment and
+	unnecessary update, respectively.
 
-	Note also that the amount of backslash-escaping in the sed
-	script is excessive (and incorrect) for normal purposes, but
-	required here because a command substitution is being nested
-	inside yet another invocation of sed.
+2023-02-04  Bertrand Garrigues <bertrand.garrigues@laposte.net>
 
-	{1} For this target; no assurances about the good behavior of
-	unusual characters in Makefile variables in other aspects of the
-	groff build are offered.
+	Update gnulib submodule
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?55004>.
+	gnulib now points on sha1 4e9fcc7b84fcac07a3e5a3cd5f66d1ff320dc8e8
 
-2018-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/utils/lookbib/lookbib.cpp: Doesn't make much sense to mark
-	Version_string as a C extern if you're just going to hide it in
-	a throwaway scope again.  Remove braces, exposing it.
+	tbl: Fix bugs using boxes or vertical rules at table edges on
+	nroff devices, particularly when combined with region or column
+	expansion.
 
-	"lookbib -v" now reports a version number, instead of "(null)".
+	* src/preproc/tbl/table.h (class table): Add `GAP_EXPAND`
+	enumeration constant.  James Clark seems to have designed GNU
+	tbl carefully to avoid distinguishing region expansion from
+	column expansion in a categorical way, but I needed a way for
+	formatting-time logic to know which was in use.  (Column
+	expansion, the "x" modifier, expands columns--i.e., text.
+	Region expansion expands or compresses the _gaps_ between
+	columns.)
+	* src/preproc/tbl/main.cpp (process_options): Set `GAP_EXPAND`
+	flag in table if "expand" region option seen.
+	* src/preproc/tbl/table.cpp: Add new macro `LEFTOVER_FACTOR_REG`
+	to name a new roff register for the remainder of gap-expansion
+	space when the amount of space available for expansion is
+	divided by the number of gaps.
+	(table::compute_overall_width): If _not_ expanding a table in
+	either respect and in nroff mode, reduce line length by 1n for
+	each of any left and right border (because the vertical lines
+	eat character cells).  This prevents bordered or boxed tables
+	from being overset even when they use neither expansion feature.
+	(table::compute_separation_factor): If gap-expanding a table,
+	store any remainder from the division used to compute the
+	separation factor into the new `LEFTOVER_FACTOR_REG`.
+	(table::compute_column_positions): Insert that remainder into
+	the gap before the last (rightmost) column of the table.  This
+	_could_ be done more elegantly by spreading each en in a
+	symmetric way across a subset of the gaps.  (It is necessarily a
+	subset by the pigeonhole principle.)  But it didn't seem worth
+	the effort for a feature (region expansion) that few users
+	employ.  (Usually what you want is the "x" column modifier.)
+	Alternatively, "forget it, Jake--it's a terminal emulator".
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?54972>.
+	* src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
+	tests.
 
-2018-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+	Fixes <https://savannah.gnu.org/bugs/?63640> and
+	<https://savannah.gnu.org/bugs/?63749>.
 
-	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
-	If:
-	  a program name is known;
-	but
-	  no file is being processed or the line number is negative,
-	then there was no space between the program name (with colon),
-	and the succeeding diagnostic message.
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Example: lookbib:fatal error: no databases
+	* src/preproc/tbl/table.cpp (table::compute_column_positions):
+	Stop multiplying the gaps at the left and right edges of a table
+	{which occur when it is boxed or has a leading and/or trailing
+	vertical line} by the column separation factor.  Only interior
+	column gaps should be spread.  This change prevents tables using
+	the "expand" region option from being overset (exceeding the
+	line length), but might not (yet) fully expand to that length on
+	low-resolution devices due to integer roundoff.
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?54971>.
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* src/preproc/tbl/table.cpp (table::compute_total_separation)
+	(table::compute_separation_factor, table::compute_widths): Add
+	comments to generated roff output to assist the mystified user.
 
-	Make strip.sed operate only if given permission.
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/strip.sed: Do nothing whatsoever to any input file that
-	lacks a line matching "%beginstrip%".  This implements a
-	contract between the macro file writer and the stripper script
-	{roff input is not parseable with crude weaponry like regular
-	expressions}.  In practice, most of the changes performed by the
-	script were already in a block enforcing this.  My changes:
-	- Stop unconditionally inserting a roff comment noting the
-	  reader of stripping at line 2.  Instead, replace the line
-	  matching "%beginstrip%" with this comment if and only if it
-	  is present.
-	- Stop deleting lines containing only the empty request if
-	  they occur before "%beginstrip%".
-	- Tweak the wording of the roff comment.
-	- Remove comment within the sed script; see
-	  https://lists.gnu.org/archive/html/groff/2017-11/msg00057.html
-	  and the sed section of "Limitations of Usual Tools" in the
-	  GNU Autoconf Manual.
+	tbl: Refactor.
 
-	Invalidates <https://savannah.gnu.org/bugs/index.php?53784>.
+	* src/preproc/tbl/table.cpp:
+	* src/preproc/tbl/table.h: Rename `compute_expand_width` to
+	`compute_overall_width`, since this member function is used on
+	_all_ tables, not just those undergoing column or gap expansion.
+	For instance, in a post-groff 1.22.4 development, it throws a
+	diagnostic if an unexpanded table overruns the line length.
+	* src/preproc/tbl/table.cpp (table::compute_widths): Update call
+	site of `compute_overall_width`.
+	* src/preproc/tbl/table.cpp: Split the roff register behind the
+	`EXPAND_REG` C++ preprocessor macro into two, adding
+	`AVAILABLE_WIDTH_REG`.  Annotate the distinction.
+	(compute_overall_width): Annotate.  Move and conditionalize
+	logic so as not to produce as much unnecessary roff output.
 
-2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-old.tmac: When emitting diagnostics, report the name
-	of the macro file complaining, and the name and line number of
-	the input file at the time of trouble.  Thanks to Bjarni Ingi
-	Gislason for part of the patch.
+	* src/preproc/tbl/main.cpp (main): Avoid reading from invalid
+	memory upon failure to open an input file.
 
-	Fixes <https://savannah.gnu.org/bugs/?54175> and continues the
-	long process of fixing <https://savannah.gnu.org/bugs/?52463>.
+	Fixes <https://savannah.gnu.org/bugs/?63751>.
 
-2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/meintro_fr.me: Add encoding hint to top of file so preconv
-	works correctly even if the build environment's encoding is not
-	UTF-8.  Adapted from Bjarni Ingi Gislason's patch.  Also add
-	long-form Emacs coding declaration at end of file.  Vim's
-	auto-detection seems to be fine, so did not update its modeline.
+	* src/preproc/eqn/lex.cpp (get_delimited_text): Avoid reading
+	from invalid memory when throwing diagnostic.  Duplicate
+	`filename` string, then free it on all paths out of function.
 
-	Fixes <https://savannah.gnu.org/bugs/index.php?54530>.
+	Fixes <https://savannah.gnu.org/bugs/?63214>.
 
-2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/groff_man.7.man: Reorganize and largely rewrite to more
-	precisely document the macro package's behavior and to be more
-	helpful and accessible to man page writers who may never read
-	any other groff documentation.
+	tbl: Add more tests.
 
-2018-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* src/preproc/tbl/tests/boxes-and-vertical-rules.sh:
+	* src/preproc/tbl/tests/expand-region-option-works.sh:
+	* src/preproc/tbl/tests/x-column-modifier-works.sh: Do it.
 
-	Clarify meaning of \p escape.  Also make more explicit that line
-	adjustment for the .brp request and \p escape depends on the
-	current adjustment mode.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
+	(tbl_XFAIL_TESTS): Add; future changes will resolve these.
 
-	* doc/groff.texi: Clarify that \p has effect at the next word
-	boundary.  Thanks to Dave <barx> for pointing out the issue and
-	providing elucidating language.
+2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff.7.man: Similar, but terser.
+	* src/preproc/tbl/table.cpp (table::compute_column_positions):
+	If a table has "left separation" (it is boxed, or has a vertical
+	rule on the left-hand side), increase the first column's start
+	register value by 1n, for symmetry with the right-hand size.
 
-	Fixes https://savannah.gnu.org/bugs/index.php?54894.
+	* src/preproc/tbl/tests/check-horizontal-line-length.sh:
+	* src/preproc/tbl/tests/check-line-intersections.sh:
+	* src/preproc/tbl/tests/check-vertical-line-length.sh: Update
+	output expectations.
 
-2018-10-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* src/preproc/tbl/tbl.am (tbl_XFAIL_TESTS): Remove now-passing
+	test.
 
-	Savannah bug # 54812
+	See <https://savannah.gnu.org/bugs/?61597> for background.
 
-	* font/devpdf/util/BuildFoundries.pl: If a font is not found
-	report list of paths searched.
+2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix https://savannah.gnu.org/bugs/?54812
+	* src/preproc/tbl/table.cpp (table::compute_total_separation):
+	Trivially refactor; rename loop indices so it's obvious which
+	dimension of a matrix they're referring to.
 
-2018-10-10  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update 'gnulib' submodule.
+	* src/preproc/tbl/table.cpp (table::determine_row_type)
+	(table::compute_widths, table::do_row): Boolify some local ints.
 
-	* gnulib: now points on dce8759f0f0236a860a3e68b63c5e99cc6f168f9
-	from 'gnulib' repository.  This fixes build error with glibc 2.28
-	(see https://bugzilla.redhat.com/show_bug.cgi?id=1595702).
+2023-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-10-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	tbl: Refactor handling of vertical lines in format.  Validate
+	input more strictly.  Add diagnostics when vertical lines are
+	redundant with box borders.
 
-	Savannah bug # 54779
+	* src/preproc/tbl/main.cpp (process_format): Shift diagnostic
+	about excess vertical lines in a sequence at the beginning of a
+	row description to later, after the first proper column
+	descriptor has been interpreted.  Normalize a sequence of more
+	than two consecutive vertical lines to 2 when they occur at the
+	beginning of a row description.  Unconditionally update
+	`list->vline` and reset `vline_count` once we start looking for
+	modifiers, since we know we've finished any sequence of vertical
+	lines, and at the end of a row definition.  Rename and retype
+	loop variable int `success` to Boolean
+	`is_valid_modifier_sequence`.  Drop now-invalid assertion.
+	* src/preproc/tbl/table.cpp (table::add_vlines): Throw new
+	diagnostics when vertical lines are redundant with box borders.
+	Add assertion to ensure we got a valid vertical line value (0,
+	1, or 2) from `process_format`.  Throw these only once per table
+	format, not for every row.
 
-	* font/devpdf/Foundry.in: Recent ghostscript changed name
-	used for embedding groff font HNBI
+2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix https://savannah.gnu.org/bugs/?54779
+	* src/preproc/tbl/main.cpp (process_table): Trivially refactor.
+	Rename `form` to `fmt` to imply "format", not "form".
 
-2018-08-27  Ingo Schwarze  <schwarze@openbsd.org>
+2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/groff_www.7.man: Do not use .URL, .MTO, .FTP.
+	* src/preproc/tbl/main.cpp (process_format): Throw error
+	diagnostic if more than 2 vertical lines are specified at the
+	beginning of a row definition.
 
-2018-08-21  Ingo Schwarze  <schwarze@openbsd.org>
+	Fixes <https://savannah.gnu.org/bugs/?63731>.
 
-	Improve terminal rendering for a few special characters:
+2023-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/tty.tmac: add \.j (dotless j)
-	* tmac/tty-char.tmac: for \a., fall back to "."
-	* tmac/tty-char.tmac: add playing card suits
+	* src/preproc/tbl/main.cpp (process_format): Recast diagnostic
+	message to refer to character by its Unicode name and generalize
+	to accurately cover additional circumstance of excess '|'
+	symbols at end of row definition.
 
-2018-08-16  Ingo Schwarze  <schwarze@openbsd.org>
+2023-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/preconv/preconv.1.man: add -D to the SYNOPSIS
+	* doc/ms.ms: Remove redundant initializations.
 
-2018-08-09  Ingo Schwarze  <schwarze@openbsd.org>
+2023-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.am: correctly calculate MAJOR_VERSION etc.
+	* doc/ms.ms: Define appropriate hyphen-minus mapping on 'cp1047'
+	output device.
 
-2018-06-19  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2023-01-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fixes to gropdf
+	* tmac/s.tmac (TE): Enable no-space mode after outputting the
+	display distance vertically, replacing any inter-paragraph
+	distance that might follow.
 
-	* src/devices/gropdf/gropdf.pl: Make default line width 0.4pt
-	to match grops. Use 'S' operator (stroke) rather than 's' (close
-	and stroke) when Dl command received. Improve switching between
-	text and graphic modes.
+2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-07-01 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	grohtml: Fix misleading diagnostic message.
 
-	me paragraph with umlaut incorrectly rendered
+	* src/preproc/html/pre-html.cpp (main): The suggestion should be
+	to re-run the formatter (groff, troff), not "pre-grohtml", with
+	a different output driver since the document may be malformed.
 
-	* tmac/e.tmac-u: workaround done by Werner LEMBERG <wl@gnu.org>.
+2023-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix https://savannah.gnu.org/bugs/?42191
+	* src/preproc/tbl/main.cpp (process_format): Fix code hygiene
+	nit: nullify `list` pointer after freeing its target.
 
-2018-06-19  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2023-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Add gropdf new features to NEWS file.
+	tbl: Really fix Savannah #63449.
 
-	* NEWS: new features.
+	* src/preproc/tbl/main.cpp (process_format): "Or" on the
+	`HAS_TOP_VLINE` flag if the format specification begins with a
+	"|"; the beginning is a separate state in the FSM used to parse
+	the description.  I missed it in commit 0e93ab4102, 1 December.
 
-2018-05-29  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?63449>.
 
-	dvi Fix glyph map for `cmitt10'.
+2023-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Problem reported by Pali Rohár <pali.rohar@gmail.com>.
+	* src/preproc/tbl/tests/\
+	do-not-overdraw-page-top-in-nroff-mode.sh: Correct erroneous
+	check of test output, and add two more test cases.
 
-	  http://lists.gnu.org/archive/html/groff/2018-05/msg00088.html
+2023-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devdvi/texitt.map: New file.  This is identical to
-	`textt.map' except the dollar glyph, which gets replaced by the
-	pound glyph.
+	* tmac/an-ext.tmac: Move the saving of the hyphenation mode from
+	the "top level" to...
+	(mY): ...this new macro.
+	(SY, mQ, MR): Call `mY` before disabling hyphenation.
 
-	* font/devdvi/generate/Makefile (CWI): Use `texitt.map'.
+	Problem introduced by me in commit 096c2f0567, 16 February.
+	"an-ext.tmac" gets sourced by "an.tmac" before any
+	command-line setting of the `HY` register is handled, so (for
+	groff) the stored hyphenation mode was the default for the
+	language, not reflecting user disablement.  The synopsis macros,
+	which do not have an alternate implementation in "an.tmac" for
+	leverage of groff features, were causing hyphenation to be
+	resurrected (after `YS`) even if the user had disabled it.
+	Saving the hyphenation mode anew upon entry to these macros is
+	arguably inefficient, but it is more correct since a man page
+	could conceivably manipulate the automatic hyphenation mode
+	{even if that's not recommended outside of tbl(1) text blocks}.
 
-	* font/devdvi/CWI: Regenerated.
+2023-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+	man: Add regression test for hyphenation getting wrongly
+	restored by `YS`, `ME`, `UE`, and `MR` macros.
 
-	Improve diagnostics on bad hyphenation requests.
+	* tmac/tests/an_HY-register-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* src/roff/troff/env.cpp: Add new HYPHEN_* symbols to anonymous
-	enum.
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/env.cpp (hyphenate_request):
-	  - Warn about hyphenation request values that are completely
-	    out of range.
-	  - Report bad hyphenation request value in diagnostic messages.
+	* tmac/mdoc/doc-common (Sh, Ss): Narrow scope of font remappings
+	lexically and restrict remapping to the heading font family (if
+	any) to avoid undesired remapping of fonts in page headers if,
+	say, a (sub)section heading begins just prior to a page
+	break--which is ugly anyway and should be avoided, but the
+	package has no keep macros and solving that problem in an
+	automatic way promises to be complex.
 
-2018-04-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	grap2graph: Parallelize changes with pic2graph.
+	* tmac/an.tmac (MT, UR): Throw style warning if macro called
+	without (exactly one) argument.
 
-	* contrib/grap2graph/grap2graph.sh:
-	  - Refactor temp directory handling.
-	  - Handle embedded whitespace in temp dir.
-	  - Adapt to old convert(1) programs.
+2022-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/grap2graph/grap2graph.1.man: Make editorial/style
-	changes and minor corrections.
+	* doc/doc.am (doc/groff-man-pages.pdf): Set (sub)section
+	headings in Helvetica bold in compiled man pages, as a test and
+	demonstration of the `HF` feature's application to both man(7)
+	and mdoc(7) documents.
 
-2018-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	eqn2graph: Remove -unsafe option.
+	mdoc: Support `HF` string.
 
-	* contrib/eqn2graph/eqn2graph.sh: Unrecognize "-unsafe" option
-	and eliminate $groff_opts variable.  As far as I can tell, this
-	option had no effect because (1) pic is not run on the input
-	stream (no -p argument to groff); (2) eqn doesn't support
-	"shelling out" as pic does; and (3) there is no way to embed
-	*roff requests inside a sequence of eqn commands.  If I'm wrong,
-	let me know.
+	* tmac/doc.tmac (initialization): Add logic supporting `HF`
+	string just as our man(7) implementation does.  If the font name
+	ends with `B` (as the default does), set
+	`doc-remap-I-style-in-headings` register and extract font
+	family, which can be empty (as is the default).
+	* tmac/mdoc/doc-common (Sh, Ss): If
+	`doc-remap-I-style-in-headings` register set, perform (and
+	unwind) font remapping of italic to bold-italic face.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Define `doc-Sh-font` in terms of `HF`.
 
-	* contrib/eqn2graph/eqn2graph.1.man: Undocument "-unsafe"
-	option.
+	* tmac/tests/doc_heading-font-remapping-works.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2018-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* tmac/groff_mdoc.7.man (Options): Document it.
+	* NEWS: Update item.
 
-	eqn2graph: Parallelize changes with pic2graph.
+	Fixes last part of <https://savannah.gnu.org/bugs/?63046>.
 
-	* contrib/eqn2graph/eqn2graph.sh:
-	  - Refactor temp directory handling.
-	  - Handle embedded whitespace in temp dir.
-	  - Adapt to old convert(1) programs.
+2022-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/eqn2graph/eqn2graph.1.man: Make editorial/style
-	changes and minor corrections.
+	tmac: Revise "fallback" character definitions in several
+	respects for Unicode characters from General Punctuation block.
 
-2018-04-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* tmac/fallbacks.tmac: Comment out fallbacks for U+200B, U+2010,
+	U+2011, and U+20189CD, due to ineffectuality or apparent groff
+	bugs.  Redefine U+2012 fallback to include hair space (\^)
+	around synthetic figure dash.  Redefine U+2016 to use `\ba`
+	special characters instead of ordinary `|` characters to dodge
+	possible character translations by user.
 
-	pic2graph: Refactor temp directory handling.
+	Fixes part of <https://savannah.gnu.org/bugs/?63354>.  Thanks to
+	Dave Kemper for the (multifarious) discussion.
 
-	* contrib/pic2graph/pic2graph.sh: Issue a diagnostic and give up
-	if the user's desired temporary directory does not exist.  Also
-	document the Bashism $RANDOM and work around its absence.
+2022-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-04-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* doc/groff.texi (Invoking groff, Built-in Registers):
+	* man/groff.7.man (Writable predefined registers):
+	* src/roff/groff/groff.1.man (Environment):
+	* src/roff/troff/troff.1.man (Environment): Replace erroneous
+	reference to ctime(3) with localtime(3).
 
-	pic2graph: Handle embedded whitespace in temp dir.
+	Fixes <https://savannah.gnu.org/bugs/?63509>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	* contrib/pic2graph/pic2graph.sh: Quote shell variables having
-	to do with the temporary directory's location; without
-	quotation, temporary directory names with embedded whitespace
-	are wrongly handled.
+2022-12-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+	tests: Fix potential problem(s) in trap handler.
 
-	* doc/groff.texi: Bump end of copyright range to 2018.  Werner
-	added substantial text this year about hyphenation.
+	* src/roff/groff/tests/smoke-test_html_device.sh: Move call of
+	`cleanup` function from end of script to after the tests that
+	generate temporary files have been run, and before script
+	possibly exits with status 77 to skip some checks.  Within trap
+	handler, mask trapped signals while running handler.
+	(cleanup): Reset trap dispositions to default after removing
+	files; once the temporary files are gone, we no longer need a
+	trap handler.  One might already be running however, and this
+	ensures that its "suicide" ("kill -s INT $$") will succeed.
 
-2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-12-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Set version to 1.22.4 in the few places that hard-code it.
+	mdoc: Support `FT` register.
 
-	* arch/mingw/grap2graph.cmd:
-	* contrib/groffer/version.sh:
-	* doc/groff.texi:
-	* doc/webpage.ms: Bump from 1.22.3 to 1.22.4.
+	* tmac/doc.tmac (initialization): Add logic supporting `FT`
+	register just as our man(7) implementation does.
+	* tmac/mdoc/doc-common (doc-set-up-titles): Plant footer trap in
+	validated user-requested location.
+	* tmac/groff_mdoc.7.man (Options): Document it.
+	* NEWS: Update item.
 
-2018-04-24  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	Fixes part of <https://savannah.gnu.org/bugs/?63046>.
 
-	Restrict scaling factors to 3dp and better handle CR/LF in import.
+2022-12-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: Restrict scaling factors to 3dp
-	rounded. If pdf imported with pdfpic uses CR/LF line termination
-	ibclude XObject Image, length of stream out by 1.
+	* tmac/an.tmac: Fix code style nit: use `as` requests to
+	avoid overlong input lines.
 
-2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	man pages: Shorten version footer.
+	* tmac/doc.tmac: Inform user we're ignoring their "-rD1" setting
+	if also formatting HTML; parallels groff man(7) behavior.
 
-	* **/*.man: Replace "Groff Version" with "groff" in the fourth
-	argument to .TH in all man pages.  This suffices to keep that
-	part of the footer from overrunning the date, even in dirty
-	trees on 80-column terminals.
+2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fixes https://savannah.gnu.org/bugs/index.php?53721.
+	* tmac/doc.tmac: Trivially refactor.  Relocate handling of `D`
+	command-line register to prepare for greater synchronization
+	with groff man(7).
 
-2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	pic2graph(1): Make editorial/style changes and minor
-	corrections.
+	* src/preproc/tbl/table.cpp: Trivially refactor.  Rename
+	{portion of} internal register to include an interword hyphen
+	for readability.
 
-2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	pic2graph: Adapt to old convert(1) programs.
+	ms: Change default line length to 6.5 inches.
 
-	* contrib/pic2graph/pic2graph.sh: Grep convert's -help output
-	for the string "-trim".  If it is not found, the old method for
-	image trimming documented in pic2graph's man page, "-crop 0x0",
-	is used.  I am motivated by the fact that the warning about this
-	in our man page is very old (10 years or more), and I wanted to
-	get rid of it.
+	* tmac/s.tmac (par@load-init): Do it.
 
-	pic2graph emits a warning when performing this fallback, in the
-	event the ImageMagick and/or GraphicsMagick teams surprise the
-	world again.
+	* doc/groff.texi (ms Document Control Settings):
+	* doc/ms.ms (Document control settings):
+	* tmac/groff_ms.7.man (Document control settings): Document it.
 
-	* contrib/pic2graph/pic2graph.1.man: Remove BUGS section, the
-	entire contents of which was dedicated to convert's change in
-	behavior.
+	* tmac/tests/s_honor-MINGW-when-two-columns.sh:
+	* tmac/tests/s_mark-column-start-correctly.sh: Update test
+	expectations.
 
-2018-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* NEWS: Add item.
 
-	groff_man(7): Expand command synopsis section.
+2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This section now explains in detail how to write (and read) a
-	command synopsis.
+	* tmac/an.tmac (TH): Relocate `an-break-body-text` trap to be
+	one half-inch above footer (instead of twice the footer
+	distance).  I reason that anyone who customizes `FT` is doing so
+	to overprint some kind of material at the bottoms of pages, or
+	simply to make the margin larger.  (One then wonders why we
+	don't have an `HD` register for the top.)  Also remove register
+	when done with it.
+	* tmac/groff_man.7.man.in (Options) <FT>: Document this.
 
-2018-04-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Make PDFPIC behave the same whether -Tps or -Tpdf used.
+	* tmac/an.tmac (TH): Trivially refactor.  Rename
+	`an-footer-location` to `an*footer-location` and set page traps
+	in order descending the page.
 
-	Previously the -Tpdf version did not cause a break nor position
-	to the line beneath the imported picture, whilst the -Tps
-	version did.
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/pdfpic.tmac: Corrected behavior.
+	mdoc: Support `X` register.
 
-	* NEWS: Explain the change of behaviour and how to reinstate
-	the previous behaviour using register PDFPIC_NOSPACE or the
-	environment variable GROFF_PDFPIC_NOSPACE.
+	* tmac/doc.tmac (initialization): Add logic supporting `X`
+	register just as our man(7) implementation does.
+	* tmac/groff_mdoc.7.man (Options): Document it.
+	* NEWS: Update item.
 
-2018-03-27  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Fixes part of <https://savannah.gnu.org/bugs/?63046>.
 
-	Define a short version for data installation dir name.
+2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This is the full version stripped of any characters after the
-	third digit.  Used for installation of font, macro and various
-	data (by default in /usr/local/share/groff).  The various programs
-	and scripts still use the full version from gnulib script
-	'git-version-gen' .
+	mdoc: Add unit test for `X` register.
 
-	* configure.ac (SHORT_VERSION): short version definition.
+	* tmac/tests/doc_X-register-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* Makefile.am: use 'SHORT_VERSION' for 'docdir' and 'datasubdir'
-	definitions.
+2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-03-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* tmac/doc.tmac (Nm): Fix `if` -> `ie` typo/thinko.
 
-	Remove doc/automake_migration_tests.txt
+	Fixes <https://savannah.gnu.org/bugs/?63527>.  Thanks to John
+	Gardner for the report.
 
-	Automake migration was completed long time ago and this file is no
-	longer needed.
+2022-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-03-11  Colin Watson  <cjwatson@debian.org>
+	* tmac/tests/doc_Nm-works.sh: Add more checks.
 
-	Switch to Gnulib implementation of snprintf
+2022-12-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This is more actively maintained, straightforward to integrate now
-	that we have Gnulib integration, and simplifies groff's overall
-	licensing.
+	* src/roff/groff/tests/smoke-test_html_device.sh: Add checks for
+	inlining of images when tbl(1) or eqn(1) used.
 
-	* bootstrap.conf (gnulib_modules): Add `snprintf' and `vsnprintf'.
-	* configure.ac: Remove local checks for `snprintf' and `vsnprintf'.
-	* Makefile.am: Remove various comments related to local checks for
-	`snprintf' and `vsnprintf'.
-	* src/include/lib.h: Remove declarations of `snprintf' and
-	`vsnprintf'.
-	* src/libs/libgroff/libgroff.am (EXTRA_DIST): Remove
-	`src/libs/snprintf/snprintf.c'.
-	* src/libs/snprintf/snprintf.c: Remove.
+2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* LICENSES: Remove section about `src/libs/snprintf/snprintf.c'.
-	* MANIFEST: Remove entry for `src/libs/libxutil'.
+	* tmac/andoc.tmac (reload-man): Unplant `doc-break-body-text`
+	trap, added in commit 892703b17e, 6 September.  Its survival
+	into man(7) pages didn't seem to cause any problems but I have
+	no confidence that will remain true forever.
 
-2018-03-09  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	PDF must not open in presentation mode.
+	* tmac/an.tmac (initialization): Fix problem with `FT` register
+	validation.  Small but valid values were being rejected due to
+	inappropriate use of scaling operator.  Also throw user a bone
+	by expressing what size '1v' is for the output device, in basic
+	units.
 
-	* src/devices/gropdf/gropdf.pl: When GROPDF_NOSLIDE=1
-	passed do not set pdf to presentation mode.
+2022-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-03-09  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	man, mdoc: Fix Savannah #63500.  Support use of `P` (initial
+	page number) register when batch rendering, regardless of
+	switching macro packages between man(7) and mdoc(7) or setting
+	of `C` (continuous numbering) register.  (`P` without `C` means
+	"start numbering each rendered document at \nP".)
 
-	Allow a "." to signify a missing parameter in .pdftransition
+	* tmac/an.tmac (an-end): Call `an*break-page-with-new-number`
+	instead of invoking `bp`.
+	(an*break-page-with-new-number): If `P` is set and `C` is not,
+	use value of `P` as the next page number.
+	(TH): If `C` register is set, remove `P` register after ending a
+	previous document.
+	(initialization): If `P` is set, assign the page number using
+	the `pn` request if the transition to the first formatted page
+	has not yet occurred; otherwise update page number register `%`
+	directly.  Also ignore it with diagnostic if `ps4html` register
+	{for grohtml's internal use} is set.  Add explanatory comment.
 
-	* src/devices/gropdf/gropdf.1.man: Explain the .pdftransition
-	macro (and underlying '\X' command) accepts a "." to specify
-	a parameter retains its current value.
+	* tmac/mdoc/doc-common (Dd): If `C` register is set, remove `P`
+	register after ending a previous document.
+	(doc-end-macro): Call `doc-break-page-with-new-number` instead
+	of invoking `bp`.
+	(doc-break-page-with-new-number): If `P` is set and `C` is not,
+	use value of `P` as the next page number.
+	* tmac/doc.tmac (initialization): If `P` is set, assign the page
+	number using the `pn` request if the transition to the first
+	formatted page has not yet occurred; otherwise update page
+	number register `%` directly.  Also ignore it with diagnostic if
+	`ps4html` register (for grohtml's internal use) is set.  Add
+	explanatory comment.
 
-2018-03-09  Colin Watson  <cjwatson@debian.org>
+	Fixes <https://savannah.gnu.org/bugs/?63500>.
 
-	man pages: fix incorrect cross-referenced section
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/roff.7.man (FILE NAME EXTENSIONS): Correct reference to
-	groff_filenames(5).
+	mdoc: Support `P` register.
 
-2018-03-09  Colin Watson  <cjwatson@debian.org>
+	* tmac/doc.tmac (initialization): Add logic supporting `P`
+	register just as our man(7) implementation does.
+	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+	nroff): Document it.
+	* NEWS: Update item.
 
-	mdate.sh: rewrite in Perl
+	Fixes part of <https://savannah.gnu.org/bugs/?63046>.
 
-	groff already requires perl to build.  This version is much shorter
-	and easier to understand than the shell/awk version: we don't have
-	to worry about convincing ls to produce output that we can parse,
-	and we don't have to play games with the way that the same field may
-	contain either the year or the time depending on how old the file
-	is.
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	While I'm at it, this version also adds `SOURCE_DATE_EPOCH' support
-	for reproducible builds: when `SOURCE_DATE_EPOCH' is set, files are
-	considered to have been last modified at that time.
+	tests: Add unit tests for man/mdoc `P` register.
 
-	* mdate.sh: Rewrite in Perl, moving to ...
-	* mdate.pl: ... this new file.
-	* Makefile.am (EXTRA_DIST, .man): Update references.
+	* tmac/tests/an_P-register-works.sh:
+	* tmac/tests/andoc_P-register-works.sh:
+	* tmac/tests/doc_P-register-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
 
-2018-03-09  Colin Watson  <cjwatson@debian.org>
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Remove #! lines from non-executable files
+	man, mdoc: Refactor.  Rename a Boolean register to more
+	clearly communicate its purpose.  This also reverses its sense.
 
-	These are always invoked by the build system (either in-tree or via
-	the installed Makefiles) using the necessary program, so the #!
-	lines were unnecessary.  They were harmless except that they caused
-	Debian's `lintian` tool to complain about installed non-executable
-	scripts.
+	* tmac/an.tmac (TH): Rename `an-is-first-page-of-document` to
+	`an*need-titles-reset`.  Drop redundant store.  Reverse sense of
+	test.
+	(initialization): Initialize it to zero.
 
-	* font/devlj4/generate/special.awk: Remove #! line.
-	* font/devps/generate/symbol.sed: Likewise.
+	* tmac/mdoc/doc-common (Dd): Rename
+	`doc-is-first-page-of-document` to `doc-need-titles-reset`.
+	Drop redundant store.  Reverse sense of test.
+	(initialization): Initialize it to zero.
 
-2018-03-09  Colin Watson  <cjwatson@debian.org>
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	doc: stop generating W3C validation icons
+	tests: Add future regression test for header/footer
+	mishandling that wasn't already covered (not a live bug; was
+	exposed by attempted refactoring).
 
-	Debian's `lintian' tool says:
+	* tmac/tests/andoc_check-an-to-doc-transition.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	  These badges may be displayed to tell readers that care has been
-	  taken to make a page compliant with W3C standards.  Unfortunately,
-	  downloading the image from www.w3.org might expose the reader's IP
-	  address to potential tracking.
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	I think the risk is a small one, but I also don't think the badges
-	are especially valuable, so it doesn't seem like much to ask to just
-	drop them at least for groff's own documentation.
+	man, mdoc: Trivially refactor.
 
-	* doc/doc.am (.ms.html, doc/pic.html): Remove `-P-V' option.
+	* tmac/an.tmac (an-start-new-document): Rename this...
+	(an*break-page-with-new-number): ...to reflect its reduced
+	responsibility.
 
-2018-03-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/mdoc/doc-common (doc-start-new-document): Rename this...
+	(doc-break-page-with-new-number): ...to reflect its reduced
+	responsibility.
 
-	Place pdf in presentation mode if new commands used.
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf: The new commands which
-	control page transitions should result in the pdf being
-	opened in presentation mode.
+	man, mdoc: Refactor to separate page number management from
+	header trap management.
 
-2018-03-02  Werner LEMBERG  <wl@gnu.org>
+	* tmac/an.tmac (an-start-new-document): Stop removing
+	`an-header` trap.
+	(TH): Clear the trap here even if not continuously rendering,
+	and call `an-start-new-document`.
 
-	Hyphenation exceptions in pattern files now obey `.hy' (#53196).
+	* tmac/mdoc/doc-common (doc-start-new-document): Stop removing
+	`doc-header` trap.
+	(Dd): Clear the trap here even if not continuously rendering,
+	and call `doc-start-new-document`.
 
-	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file): Mark
-	`\hyphenation' entries with a trailing space.
-	(hyphen_trie::insert_hyphenation): Updated.
-	(hyphenate): Make `\hyphenation' entries obey `.hy' restrictions.
+2022-12-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texi (.hy): Updated.
+	* tmac/mdoc/doc-common: Refactor for better parallelism with our
+	man(7) implementation and to prepare for a synchronized change
+	to both.
+	(Dd): Move open-coded (inlined) operations from here...
+	(doc-start-new-document): ...to this new macro.
+	(doc-end-macro): Drop unnecessary register assignment.  `Dd`
+	takes care of it if there is a subsequent mdoc(7) document.
 
-2018-03-01  Werner LEMBERG  <wl@gnu.org>
+2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Adjust `.hy' values.
+	tbl: Fix off-by-one error in generated diagnostic message.
 
-	In most cases hyphenation constraints were too strict.  The now
-	selected values reflect the parameters used for the generation of
-	the (TeX) hyphenation patterns.
+	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
+	`PREVIOUS_PAGE_REG`.
+	(table::init_output): Compute value for register named using
+	`PREVIOUS_PAGE_REG`, use it in diagnostic, and then remove it.
+	Also fix verb tense in message.
 
-	* tmac/an-old.tmac, tmac/cs.tmac, tmac/de.tmac, tmac/doc-common-u,
-	tmac/e.tmac-u, tmac/fr.tmac, tmac/s.tmac, tmac/sv.tmac: Fix `.hy',
-	`\nHY', and `\ndoc-hyphen-flags' values.
+2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texi, tmac/groff_man.7.man, tmac/groff_ms.7.man, NEWS:
-	Updated.
+	tbl: Expose the fact of a table's boxedness via a troff
+	register so that macro packages can make more intelligent
+	decisions about space requirements (since box borders occupy
+	significant space on nroff devices).
 
-2018-03-01  Werner LEMBERG  <wl@gnu.org>
+	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
+	`IS_BOXED_REG`.
+	(table::do_top): Initialize "boxedness" register.
 
-	Fix some problems related to hyphenation.
+2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Introduce values 16 (allow hyphenation before last character) and 32
-	(allow hyphenation after first character) to the `hy' request
-	(#48904).
+	* tmac/s.tmac (TH): Clarify computation and diagnostic message.
 
-	Really fix problem reported in issue #48904.
+2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix #53243, which is a regression introduced in 2016-09-09.
+	tbl: Fix Savannah #61878.
 
-	* src/roff/troff/env.cpp (HYPHEN_LAST_CHAR, HYPHEN_FIRST_CHAR): New
-	enumeration values.
-	(hyphenate_request): Check for contradicting values.
-	(environment::hyphenate_line): Fix minimum word length considered
-	for hyphenation.
-	(environment::print_env): Updated.
-	(hyphenate): Fix and extend logic.  The original patch to handle
-	#48904 was bad.
+	* src/preproc/tbl/table.cpp: Define new preprocessor macro,
+	`STARTING_PAGE_REG`.
+	(table::define_bottom_macro): Have the formatter issue a warning
+	if an unkept, boxed table ends on a different page than it
+	began.
+	(table::do_top): Save current page number when table begins.
 
-	* doc/groff.texi, man/groff_diff.7.man, NEWS: Updated.
+	Fixes <https://savannah.gnu.org/bugs/?61878>.
 
-2018-03-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Add page transitions to pdfs created with gropdf.
+	tbl: Regression-test Savannah #61878.
 
-	* src/devices/gropdf.pl: Handle new '\X' commands to support page
-	transitions in presentation mode pdfs. These commands are a subset
-	of the commands used in present.tmac allowing slideshows to be
-	directly produced from -Tpdf without using postscript -> gpresent.pl
-	-> ghostscript.
+	* src/preproc/tbl/tests/\
+	warn-on-long-boxed-unkept-table.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
 
-	* tmac/pdf.tmac: New macros '.pdfpause' and '.pdftransition' to
-	support page transitions.
+2022-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf.1.man: Document the '\X' commands supported.
+	* src/preproc/tbl/table.cpp: Write comments to generated output;
+	these correspond to functions in this file and to major
+	operations of table construction.
+	(init_output, compute_widths, define_bottom_macro, do_row)
+	(do_top, do_bottom): Do it.
 
-2018-03-01  Werner LEMBERG  <wl@gnu.org>
+2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use $(AM_V_GEN) and $(AM_V_P) to silence even more file generation.
+	troff: Trivially refactor.  Rename class `constant_int_reg` to
+	`readonly_register`.  Say "readonly" instead of "const" to
+	try to avoid confusion with C++ constness.  Drop "int" because
+	integer-valued registers are the norm, not the exception.
 
-	* font/devpdf/devpdf.am (BuildFoundries, DESC, Foundry,
-	build_font_files): Do it.
+	* src/roff/troff/column.cpp (init_column_requests):
+	* src/roff/troff/div.cpp (init_div_requests):
+	* src/roff/troff/input.cpp (top level, init_input_requests):
+	* src/roff/troff/node.cpp (init_node_requests):
+	* src/roff/troff/reg.h: Do it.
 
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
+2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use $(GROFF_V) to silence documentation creation.
+	troff: Trivially refactor.  Rename class `constant_reg` to
+	`readonly_text_register`.  Say "readonly" instead of "const" to
+	try to avoid confusion with C++ constness.  Say "text" because
+	this class is _mostly_ used for interpolation of string-valued
+	registers like the version registers `.x`, `.y` and `.Y`.
+	Nevertheless there are some abuses (apparently because the
+	constructors for register classes don't accept integer
+	parameters for initialization--why?).
 
-	* Makefile.am (GROFF_V): Define.
+	* src/roff/troff/input.cpp (top level)
+	(readonly_text_register::readonly_text_register)
+	(readonly_text_register::get_string)
+	(main, init_registers, init_requests): Do it.
 
-	* doc/doc.am (.me.txt, .me.ps, .ms.html, .ms.txt, .ms.ps, pic.html,
-	webpage.html): Use $(GROFF_V).
+2022-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
+	troff: Trivially refactor.  Rename `number_reg_dictionary` to
+	`register_dictionary`.  It's shorter _and_ non-abbreviated _and_
+	matches our documentation.
 
-	Use $(AM_V_GEN) to silence file generation.
+	* src/roff/troff/column.cpp (init_column_requests):
+	* src/roff/troff/div.cpp (page_number, init_div_requests):
+	* src/roff/troff/env.cpp (print_env, init_env_requests)
+	(init_hyphen_requests):
+	* src/roff/troff/input.cpp (length_request)
+	(interpolate_number_format, do_register, do_if_request, main)
+	(init_registers, init_input_requests):
+	* src/roff/troff/node.cpp (get_register, init_node_requests):
+	* src/roff/troff/reg.cpp (top level, define_number_reg)
+	(inline_define_reg, alter_format, remove_reg, alias_reg)
+	(rename_reg, print_number_regs):
+	* src/roff/troff/reg.h: Do it.
 
-	* Makefile.am (.man), contrib/eqn2graph/eqn2graph.am (eqn2graph),
-	contrib/grap2graph/grap2graph.am (grap2graph), contrib/pic2graph.am
-	(pic2graph), src/devices/gropdf/gropdf.am (gropdf, pdfmom),
-	src/preproc/eqn/eqn.am (neqn), src/roff/grog/grog.am (grog),
-	src/roff/nroff/nroff.am (nroff), src/utils/afmtodit/afmtodit.am
-	(afmtodit), font/devascii/devascii.am (DEVASCIIFONTSFILES, DESC),
-	font/devcp1047/devcp1047.am (DEVCP1047FONTSFILES, DESC),
-	font/devhtml/devhtml.am (DEVHTMLFONTSFILES, DESC),
-	font/devlatin1/devlatin1.am (DEVLATIN1FONTSFILES, DESC),
-	font/devutf8/devutf8.am (DEVUTF8FONTSFILES, DESC),
-	font/devps/devps.am (DESC, prologue, zapfdr.pfa, symbolsl.pfa),
-	font/devdvi/devdvi.am (DESC), font/devlbp/devlbp.am (DESC),
-	font/devlj4/devlj4.am (DESC): Do it.
+2022-12-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
+	man: Add regression test.
 
-	* configure.ac: Activate silent Makefile rules.
+	* tmac/tests/an_link-trailing-text-hugs-previous.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Minor compilation warnings.
+	* tmac/fallbacks.tmac: Really use troff-mode fallbacks only on
+	typesetting devices; because this macro file is loaded so early,
+	we cannot rely on ".if t".  Thanks to Dave Kemper for the
+	discussion in Savannah #63354.
 
-	* src/devices/xditview/draw.c: Don't declare `MaxFontPosition'.
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/input.cpp (psbb_locator::context_args): Avoid
-	shadowing of `buf'.
+	* tmac/an-ext.tmac: Use more mnemonic register names, thanks to
+	the recent freeing up of some name space.
+	- mJ -> mH: saved automatic hyphenation mode
+	- mX -> mE: formatting in EX/EE context (Boolean)
 
-2018-02-28  Werner LEMBERG  <wl@gnu.org>
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/env.cpp: s/HYPHEN_/HYPHEN_NOT/ for clarification.
+	* tmac/pdf.tmac: Drop deletion of unused string `PDFHREF.TEXT`.
 
-2018-02-26  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update installation doc.
+	* tmac/an.tmac (an-end, AT, UC, DT, PD, SH, IP, BI, BR, IB, IR)
+	(RB, RI, OP, an*end-hyperlink, MR): Refactor; "nop"ify macros
+	that produce formatted output or call other macros using string
+	interpolations--except where we can't: see Savannah #63470.
 
-	* INSTALL.REPO: mention that 'pkg-config' is a dependency.
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.extra: add dependency 'makeinfo' and optional
-	dependencies 'pkg-config' and 'uchardet'.
+	* tmac/an.tmac (R): Drop macro definition, which implements a
+	hack for people who try to use "R" as a font style macro.  This
+	doesn't seem to happen much in actual practice (though perhaps
+	the diagnostic this hack produces is responsible for suppression
+	of the mistake).  Retaining it interferes with the
+	"nop"-ification of this macro file.
+	* NEWS: Add item.
 
-	* TESTS: move to doc/automake_migration_tests.txt
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.gen: remove, this file is redundant with the 'INSTALL'
-	file from gnulib.
+	* tmac/an-ext.tmac: Use truly traditional hyphenation mode on
+	non-groff-compatible formatters.
 
-2018-02-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-12-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update 'gnulib' submodule.
+	man: Update test coverage and expectations.
 
-	* gnulib: now points on cf56f8f618c48cfadd2499ced58574633d12f129
-	from 'gnulib' repository.
+	* tmac/tests/an_ME-punct-hyphenates.sh: Test both "an.tmac" and
+	"an-ext.tmac" implementations of `ME`.
+	* tmac/tests/an_UE-punct-hyphenates.sh: Test both "an.tmac" and
+	"an-ext.tmac" implementations of `UE`.
+	* tmac/tests/an_UE-breaks-before-long-URIs.sh: Update test
+	expectations.  I appear to have inadvertently fixed some
+	inelegant rendering.
 
-2018-02-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use gnulib script 'git-version-gen' to define groff's version
+	tests: Rename to reflect code reorganization.
 
-	* bootstrap.conf: add 'git-version-gen' script.
+	* tmac/tests/an-ext_ME-punct-hyphenates.sh:
+	* tmac/tests/an-ext_MT-body-hyphenates.sh:
+	* tmac/tests/an-ext_UE-breaks-before-long-URIs.sh:
+	* tmac/tests/an-ext_UE-punct-hyphenates.sh:
+	* tmac/tests/an-ext_UR-body-hyphenates.sh: Rename these...
+	* tmac/tests/an_ME-punct-hyphenates.sh:
+	* tmac/tests/an_MT-body-hyphenates.sh:
+	* tmac/tests/an_UE-breaks-before-long-URIs.sh:
+	* tmac/tests/an_UE-punct-hyphenates.sh:
+	* tmac/tests/an_UR-body-hyphenates.sh: ...to these.
 
-	* configure.ac: suppress 'GROFF_VERSION_STRING' and replace it by
-	the script.  If the current commit corresponds to a tag, then the
-	version is simply the tag name.  Otherwise the version has the
-	format: <tag>-<nb_commits_from_latest_tag>-<commit sha1>.  The
-	version is now stored in '.version'.
+	* tmac/tmac.am (tmac_TESTS): Reflect renames.
 
-	* REVISION: removed.
+2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* VERSION: removed.
+	* tmac/an-ext.tmac: Remove groff-feature-dependent code for
+	hyperlink management, greatly reducing the size of the file,
+	which we permissively license and encourage people to copy
+	around.  Drop register definitions corresponding to
+	groff-specific output device names.  Drop definition and use of
+	`mL` and `mR` strings for angle brackets; no observable change
+	on non-groff formatters.  Recognize `mG` register to enable
+	testing of these macros even if the formatter is groff.
+	(mV): Radically simplify.  This internal "back-end" for `MT` and
+	`UR` now just stores its argument in a string, `m1`.
+	(mQ): Radically simplify.  This internal "back-end" for `ME` and
+	`UE` now just disables automatic hyphenation, formats the saved
+	`m1` string between angle brackets, suffixes it with the
+	optional argument, and restores automatic hyphenation.
+	(UR, MT): Call `mV` with one argument, not nine.
+	(UE, ME): Call `mQ` with one argument, not nine.
 
-	* Makefile.am: define 'MAJOR_VERSION', 'MINOR_VERSION' and
- 	'REVISION'.
+	* tmac/tests/an-ext_MR-works.sh: Add test of this file's
+	simplified `MR` implementation.
+	* tmac/tests/an-ext_MT-works.sh:
+	* tmac/tests/an-ext_UR-works.sh: Move tests of groff-specific
+	hyperlink output from here...
+	* tmac/tests/an_MT-works.sh:
+	* tmac/tests/an_UR-works.sh: ...to these new files.
+	* tmac/tests/an_MR-works.sh:
+	* tmac/tests/an_MT-works.sh:
+	* tmac/tests/an_UR-works.sh: Add tests for valid HTML formatting
+	of hyperlinks, which experience shows is a bit fragile in the
+	face of diversion manipulation and output line continuation.
 
-	* src/libs/libgroff/libgroff.am: use 'MAJOR_VERSION',
-	'MINOR_VERSION' and 'REVISION', add dependency on '.version'.
+	* tmac/tmac.am (tmac_TESTS): Run new tests.
 
-	* src/roff/troff/troff.am: ditto.
+2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/mom/om.tmac-u (short_revision): new string that extracts
-	the first digit of the revision, to be used when checking groff
-	version.
+	* tmac/an-ext.tmac: Support `mG` register: clear it to force the
+	loading of this file's macros even if they have an
+	implementation in tmac/an.tmac and the formatter claims groff
+	compatibility.  This is to ease these macros' testing under
+	groff and keep the implementations here simple.
+	* tmac/an.tmac: Initialize `mG` register to 1 if not set on
+	command line.
 
-2018-01-18  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	On reflection using an array for Filter is not optimal.
+	* tmac/an-ext.tmac: Initialize `mX` register.
 
-	* src/devices/gropdf.pl: revert single line from commit
-	18fd1fd0bf05eb9a5ba0d2be1a655a044662a8bf.
+2022-12-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2018-01-17  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/an-ext.tmac: Define `mC` string (constant-width typeface
+	used by `EX`/`EE` macros) as `R` in nroff mode.  Thanks to
+	Russ Allbery for prompting me to think more about the
+	limitations of Solaris troff.  Implementations do varying
+	things with the "previous" font restored by `\fP` or an
+	unargumented `.ft` if a requested font is not found.
 
-	All values should be 3 decimals
+2022-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf.pl: for values approaching zero values
-	in the for 0.nnnnnnE-nn could be written, not valid syntax for
-	PDF. Make all values rounded to 3 decimals, becomes 0.000.
+	tbl: Fix Savannah #63449.
 
-	Also changed stream Filter dictionary entry to an array.
+	* src/preproc/tbl/table.h (class table): Add new enumeration
+	constants for use with `flags` member variable: `HAS_TOP_VLINE`
+	and `HAS_TOP_HLINE`, which track properties of the table.
+	Unlike others, these have no correspondence to table region
+	options.
+	* src/preproc/tbl/main.cpp (process_format): Add new local
+	Boolean to track whether we're interpreting a format for the
+	first row.  Use this to "or" on the `HAS_TOP_VLINE` or
+	`HAS_TOP_HLINE` flags if "|" or _- are encountered in the
+	first row's format, as appropriate.
+	(process_data): "Or" on `HAS_TOP_HLINE` if a single or double
+	horizontal line is used as the first row's data.
+	* src/preproc/tbl/table.cpp (do_top): On nroff mode devices, add
+	one vee of space above the table if we're going to be drawing an
+	unintersected vertical rule above the table's top.
 
-2018-01-14  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Fixes <https://savannah.gnu.org/bugs/?63449>.
 
-	Fix tarball generation ('make distcheck'  failed)
+2022-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/xditview/xditview.am: add .h created by commit
-	382ab4af269a1dea422c8f9bb5c67a065d026deb to EXTRA_DIST
+	tbl: Regression-test Savannah #63449.
 
-	* contrib/mm/mm.am: restore distribution of files removed by
-	commit 445bf58765b759546e238a235651eb0bf5b34325.
+	* src/preproc/tbl/tests/\
+	do-not-overdraw-page-top-in-nroff-mode.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
 
-2018-01-13  Ingo Schwarze <schwarze@openbsd.org>
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Makefile.am: Re-add -F and -M flags needed to build out of src.
+	* src/preproc/tbl/main.cpp (struct input_entry_format)
+	(input_entry_format::input_entry_format)
+	free_input_entry_format_list, process_format): Trivially
+	refactor.  Rename `pre_vline` to `vline_count`.
 
-2018-01-13  Ingo Schwarze <schwarze@openbsd.org>
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	mdoc: rewrite the implementation of the .Lk macro
+	* src/preproc/tbl/table.cpp
+	(vertical_rule::contribute_to_bottom_macro, table::print)
+	(table::init_output, table::divide_span)
+	(table::compute_expand_width, table::define_bottom_macro)
+	(table::do_bottom): Produce roff output that is more readable,
+	for maintainability.  Indent control lines inside macro
+	definitions.  Standardize form of `if`, `ie`, and `el` requests.
+	Some output will not be indented because it is produced within
+	narrowly-scoped C++ functions (set_troff_location,
+	table::print_single_hline, table::print_double_hline,
+	table::do_row), I haven't verified that each one is called from
+	a consistent troff indentation level, and I'm not sure it's a
+	win to parameterize those functions in the indentation level.
 
-	* tmac/doc.tmac-u (Lk): Rewrite.
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The old implementation was written before the big mdoc
-	rewrite for groff-1.17.  In contrast to most other macros,
-	it was never updated to use the new techniques.
-	This new implementation makes .Lk callable, makes trailing
-	punctuation work in the normal way, and makes the style of
-	the implementation consistent with other macros.
+	tbl: Fix Savannah #61909.
 
-	It also removes the feature of automatically switching
-	between in-line and displayed rendering depending on the
-	length of the link because that was inconsistent across
-	output modes and counter-intuitive, resulting in ugly
-	output for many existing real-world manual pages.
-	It now always renders in-line.  Use .D1 Lk where desired.
+	* src/preproc/tbl/table.cpp (SAVED_INTER_WORD_SPACE_SIZE)
+	(SAVED_INTER_SENTENCE_SPACE_SIZE): Add new preprocessor macros.
+	(block_entry::do_divert): Restore saved inter-word and
+	inter-sentence space when formatting a text entry.
+	(table::init_output): When a table region begions, save the
+	values of inter-word and inter-sentence space.  Add request to
+	the reset macro to restore saved inter-word and inter-sentence
+	space when leaving table region.
+	(table::do_top): Set inter-sentence space to be equal to
+	inter-word space.  This way spaces are "literal" in ordinary
+	table extries (but not text blocks).
 
-	Merging http://savannah.gnu.org/bugs/?52849
-	OK wl@gnu, jmc@openbsd, bentley@openbsd
+	Fixes <https://savannah.gnu.org/bugs/?61909>.
 
-2017-12-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	man pages: Comment compatibility-mode switching.
+	tbl: Regression-test Savannah #61909.
 
-	The '.do' and '.cp' requests (both groffisms) are some of the
-	more obscure features of groff's own man page corpus.
-	Consequently, they get cargo-culted around, within and outside
-	groff.  Thanks to Werner Lemberg for the discussion, which
-	revealed (to me) that groff ships with compatibility mode on by
-	default on Solaris 10 and 11.
+	* src/preproc/tbl/tests/\
+	save-and-restore-inter-sentence-space.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
 
-	Fix bug https://savannah.gnu.org/bugs/?52444.
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+	tbl: Suppress line numbering when formatting tables, and
+	restore it afterward.
 
-	* src/roff/troff/input.cpp:
-	Make writers to stderr identify themselves.
+	* src/preproc/tbl/table.cpp: Revert much of commit b69062693's
+	{2011-07-20} changes to this file.  They were too complex for me
+	to understand, and permitted Savannah #60140 to persist (or
+	caused it).
+	(ROW_START_LINE_REG, ROW_SAVE_LINE_REG, ROW_MAX_LINE_REG)
+	(REPEATED_NM_SET_MACRO, REPEATED_NM_SUS_MACRO): Drop
+	preprocessor macros.
+	(SAVED_NUMBERING_LINENO, SAVED_NUMBERING_SUPPRESSION_COUNT): Add
+	new preprocessor macros.
+	(table::init_output, table::print_single_hline)
+	(table::print_double_hline, table::define_bottom_macro)
+	(table::do_row, table::do_top, table::do_bottom): Drop old
+	logic.
 
-	* font/devpdf/util/BuildFoundries.pl:
-	Same; also refactor all diagnostics into Notice(), Warn(), and
-	Die() functions, which delegate their common message-printing to
-	Msg().
+	(table::init_output): When the table begins, save the current
+	line number register `ln` and the count of remaining lines to be
+	suppressed (the new `.nn` register).  Then suppress numbering
+	for the next 2 billion+ lines of output, with a groveling
+	apology to the elegance police.
+	(table::do_bottom): Restore saved value of `.nn`.  If numbering
+	was active (even if suppressed), restore it with `nm` request.
+	If it wasn't, disable it, in case it was turned on inside the
+	table region.
 
-	Fix part of bug https://savannah.gnu.org/bugs/?52463.
+	Fixes <https://savannah.gnu.org/bugs/?60140>.  Thanks to Hans
+	Bezemer for noting the practical significance of this bug.
 
-2017-11-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	man pages: Fix compatibility-mode problems.
+	tbl: Regression-test Savannah #60140.
 
-	* contrib/gperl/gperl.1.man: Use idiomatic .BI macro instead of
-	  leading an input line with a font escape followed by a dot,
-	  the interpretation of which differs based on compatibility
-	  mode.
+	* src/preproc/tbl/tests/save-and-restore-line-numbering.sh: Do
+	it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
 
-	* src/preproc/soelim/soelim.1.man: Make .mso request only after
-	  compatibility mode is turned off.
+2022-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+	troff: Implement new `.nn` register to report the remaining
+	count of lines to have their numbering suppressed.
 
-	* Makefile.am: Protect arguments to "tr" from globbing.
+	* src/roff/troff/env.h (class environment): Declare new member
+	function `get_no_number_count()`.
+	* src/roff/troff/env.cpp (get_no_number_count): Define new
+	member function, returning value of member variable
+	`no_number_count`.
+	(init_env_requests): Define new ".nn" register and attach it to
+	`get_no_number_count()`.
 
-	Prevents errors from tr during man page generation and possible
-	incorrect program prefixing in those pages if, for example, some
-	doofus has directories called "A", "B", ...  hanging around in
-	the build tree.
+	* doc/groff.texi (Miscellaneous): Document it.  Include example
+	of use to determine whether current output line will be
+	numbered.  Also clarify meaning of register; `.nn` is not
+	decremented except when output line numbering is enabled.
+	* man/groff.7.man (Read-only registers): Document it.
 
-2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* src/roff/groff/tests/dot-nn_register_works.sh: Test it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
 
-	* tmac/groff_mdoc.7.man: Use unstripped symbol names.
+	* NEWS: Add item.
 
-	Fix bug https://savannah.gnu.org/bugs/?52442.
+	See <https://lists.gnu.org/archive/html/groff/2022-11/\
+	msg00153.html>.
 
-2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/include/.gitignore: Ignore config.hin~ files.
+	* tmac/fallbacks.tmac: Comment out four of the fallback
+	character definitions for (preconv'd) Unicode character input
+	added to address Savannah #58930 (corresponding to \dg, \dd,
+	\%0, and \rn; they are failing for not yet understood
+	reasons involving "macros" attached to groff character info
+	structs, and the semantics of what it means for a character to
+	"exist" per the 'c' conditional operator.  Fixes regression when
+	using "tty-char.tmac" (which nroff loads by default).  Problem
+	introduced by me in commit 132182bd71, 23 October.  The hope is
+	to resolve this issue post-groff 1.23.0.  Thanks to Dave Kemper
+	for the report and discussion in Savannah #63332.
 
-2017-11-18  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	test-groff.in: Enable backtraces and all warnings by default.
+	* tmac/an-ext.tmac (SY, YS, mV): Remove `mA`, `mI`, and `mT`
+	registers when done with them.
 
-	Fix bug https://savannah.gnu.org/bugs/?51482.
+2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* src/roff/troff/node.h (character_exists):
+	* src/roff/troff/node.cpp (character_exists): Boolify.
 
-	* tmac/**: Migrate macro package diagnostics away from `quotes'.
+2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+	doc: Add make(1) dependency.
 
-	* src/libs/libgroff/new.cpp: Quieten compiler warning.
+	* doc/doc.am (doc/groff-man-pages.pdf): Add dependency on our
+	FreeEuro font since we embed it.
 
-	Define sized version of overloaded delete operator.  Duplicate
-	code from unsized delete operator because simply calling through
-	to it provokes another warning, -Wdelete-incomplete.
+2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix rest of https://savannah.gnu.org/bugs/?52335.
+	build: Refactor generation of "freeeuro.pfa" to make more
+	economical use of existing infrastructure, per a suggestion from
+	Deri James.  This also puts the file where gropdf's "download"
+	file can find it when running it in a separate build directory.
+	We use it to generate "groff-man-pages.pdf".
 
-2017-11-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* font/devps/freeeuro.pfa: Rename this...
+	* font/devps/freeeuro.ps: ...to this.  We can now use the suffix
+	rule that also applies to "symbolsl.ps" and "zapfdr.ps".
 
-	Better handle glyphs in font positions > 255
+	* font/devps/devps.am (DEVPSFONTFILES): Move "freeeuro.pfa" from
+	here...
+	(DEVPSFONTFILES_GENERATED): ...to here.
+	(EXTRA_DIST): Ship the "new" "freeeuro.ps" file.
 
-	* src/devices/gropdf/gropdf.pl: Improve handling
-	when glyphs above 255 are used.
+2022-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* font/devps/psstrip.sed: Stop stripping comment lines in
+	general instead of preserving only ones that use the form in the
+	Document Structuring Conventions.  This way we won't strip
+	copyright notices, like Werner Lemberg's in the FreeEuro font.
+	Thanks to Deri James for pointing this out.
 
-	gropdf should load ALL 'download' files
+2022-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: only the first 'download' file
-	found was loaded, it should load all found.
+	tmac/an-ext.tmac: Refactor to reduce code size.
 
-2017-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* tmac/an-ext.tmac: Refactor to reduce code size.  `UE` and `ME`
+	have nearly identical implementations so...
 
-	* src/libs/libxutil/DviChar.c: Initialize "buckets" field of
-	structs.
+	(mQ): Define new macro to perform the requisite actions, and...
 
-	Resolves missing-field-initializers warnings.
+	(UE, ME): Make these into wrappers calling mQ.
 
-2017-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/strip.sed: Stop rewriting symbol names.  A substitution
-	originally intended to strip the "doc-" prefix off of mdoc macro
-	and string names unintentionally caught some mom stuff.
-	Harmlessly in this instance, but with potentially surprising
-	future effects.  Remove (only) this substitution per discussion
-	in
-	https://lists.gnu.org/archive/html/groff/2017-11/msg00055.html
-	et sequentia.
+	man: Add unit tests for `MT/ME` and `UR/UE`.
 
-2017-11-11  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/tests/an-ext_MT-works.sh:
+	* tmac/tests/an-ext_UR-works.sh: Do it.
 
-	* src/devices/grolbp/lbp.cpp (lbp_printer::setfillmode): Address
-	  misleading indentation warning.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
 
-	* src/roff/troff/mtsm.cpp (mtsm::push_state, mtsm::pop_state):
-	  Same.  Only flush standard error if we just wrote to it,
-	  instead of unconditionally.
+2022-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51483.
+	* src/devices/gropdf/gropdf.pl: Throw warning if paper format is
+	unrecognized.
 
-2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/utils/xtotroff/xtotroff.c: Mark private function static.
+	* src/devices/gropdf/gropdf.pl (Msg): Align more closely with
+	diagnostic message format prescribed by GNU Coding Standards:
+	emit space (only) prior to message severity.
 
-2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libxutil/xmalloc.c: Quieten gcc warning.  Mollify
-	-Wmissing-prototypes for xmalloc() in single-function file.
+	* doc/meref.me.in: Drop unnecessary initialization parameters
+	from document.  The line and title length do not need to be set
+	in troff mode; the document lays out fine for a variety of paper
+	formats if these are not forced to 6.5 inches.  Also drop
+	redundant initialization of `pp` register.
 
-2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	gxditview: Migrate extern declarations to headers.
+	mdoc: Fix Savannah #63377.
 
-	Also mark some private functions as static.
+	* tmac/doc.tmac (Nm): Properly leverage new
+	`doc-in-name-section` variable.  Set page topic `doc-topic-name`
+	to the first encountered argumentful `Nm` call in the "Name"
+	section while handling other "Name" section concerns, instead of
+	later after deciding we're not in the "Synopsis" section.
+	Problem caused by me when fixing antediluvian mdoc bug in commit
+	0d85615c62, 5 November.
 
-2017-11-11  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	Fixes <https://savannah.gnu.org/bugs/?63377>.  Thanks to John
+	Gardner for the report.
 
-	src: Declare function protypes where necessary.
+2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51513.
+	mdoc: Add tests for `Nm` macro.
 
-2017-11-10  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/tests/doc_Nm-works.sh: Do it.  Test regression reported
+	in Savannah #63377.  Also ensure that we handle the case where
+	multiple `Nm` items are declared in the "Name" section (as might
+	happen in library man pages).
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	mom: Abort early with diagnostic in compatibility mode.
+2022-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?52333.
+	* tmac/papersize.tmac: Improve integration with mm(7) macro
+	package.  If a paper format has been selected, set `W` register
+	to new line length (if not already set on command line).
+	Similarly, set `O` register to 1 inch for the symmetric
+	horizontal margins otherwise assumed by this macro file.  This
+	means that "groff -mm" and "groff -dpaper=letter -mm" are _not_
+	synonymous (when groff is configured to use U.S. letter as the
+	default paper format), because groff mm(7) uses a page offset of
+	0.963 inches on typesetters for compatibility with DWB mm.
+	* NEWS: Add item.
 
-2017-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+	See discussion in <https://lists.gnu.org/archive/html/\
+	groff/2022-11/msg00081.html> and (some) follow-ups.
 
-	* contrib/**: Migrate diagnostics away from `quotes'.
+2022-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-2017-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* src/devices/gropdf/gropdf.pl: If the argument to the paper
+	format option '-p' matches a recognized format but includes a
+	trailing 'L' or 'l' ("legalL" or "a4l", for example), rotate the
+	document's MediaBox.
 
-	* src/**: Migrate diagnostics away from `these quotes'.
+2022-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	Fix bug https://savannah.gnu.org/bugs/?52374.
+	* src/devices/gropdf/gropdf.pl: Fix incorrect hotspot placement
+	if page is in landscape orientation.
+	(FixRect): Perform coordinate transform if page is rotated.
+	(Rotate): New function performs relevant trigonometry.
 
-2017-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+	Fixes <https://savannah.gnu.org/bugs/?63380>.  Thanks to Blake
+	McBride for the report.
 
-	* tmac/strip.sed: Remove nilpotent capture from address.
+2022-11-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-05  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* tmac/e.tmac: Integrate better with papersize.tmac by no longer
+	forcing line (and title) length to 6 inches for typesetters on
+	initialization.  Gather default line length from output device
+	description, possibly modified later (by other macro file or
+	input).  No change to terminal ("nroff mode") output.
+	* NEWS: Add item.
 
-	`preconv': fix usage of lib `uchardet'.
+2022-11-16  Peter Schaffter <peter@schaffter.ca>
 
-	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Fix
-	usage of uchardet 0.0.1, which may fail but return an empty string
-	instead of a null pointer, and fix some incorrect error
-	managements that might cause memory leaks.
+	* tmac/papersize.tmac: If a paper format has been selected,
+	smuggle right margin setting to mom(7) if not overridden by the
+	user.  See discussion in <https://lists.gnu.org/archive/html/\
+	groff/2022-11/msg00081.html> and (some) follow-ups.
 
-2017-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/devpdf.am: Silence warning from grep during clean.
+	* doc/doc.am (doc/groff-man-pages.pdf)
+	(doc/groff-man-pages.utf8.txt): Add dependencies on new
+	`TMAC_PACKAGE_MAN` and `TMAC_PACKAGE_MDOC` convenience macros.
 
-2017-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.am: Drop unnecessary -F and -M flags from pdfmom
-	call.
+	* tmac/tmac.am (TMAC_PACKAGE_MAN, TMAC_PACKAGE_MDOC): Define
+	convenience macros for in-tree documents to depend on.
 
-2017-11-02  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	man/groff_diff.7.man: Correct the explanation of the request
-	".itc"--it was backwards.
+	* tmac/an.tmac: Trivially refactor.  Rename `an-section` to
+	`an*section`.
 
-	Fix bug https://savannah.gnu.org/bugs/?51502.
+2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-11-02  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* src/devices/grolbp/lbp.cpp (usage): Tweak usage message.  The
+	output driver should be perfectly capable of handling output
+	from non-GNU (but device-independent) troffs.
 
-	test-groff.in: Recognize additional contrib tmacs.
+2022-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51598.
+	* src/devices/grops/ps.cpp (usage): Employ more informative
+	metasyntactic variable names in usage message.  Also summarize
+	program's function and direct reader to man page if help
+	explicitly requested (inferred from identity of output stream).
 
-2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.am: Force build to generate test-groff script.
+	* tmac/an.tmac: Trivially refactor for congruence with
+	documentary terminology.  Rename strings and macros.
+	- an-title                 -> an*topic
+	- an-abbreviate-page-title -> an*abbreviate-page-topic
+	- an-title-abbv            -> an*topic-abbv
+	- an-title-string          -> an*topic-string
+	- an-title-length          -> an*topic-length
+	- an-title-length-prev     -> an*topic-length-prev
+	- an-title-new-length      -> an*topic-new-length
+	- an-page-title-style      -> an*topic-style
+	(TH): Recast diagnostic message to refer to "section", not
+	"volume" title.
 
-2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/devpdf.am: Silence warning from grep during build.
+	* tmac/an-ext.tmac: Refactor to reduce code size.  `UR` and `MT`
+	have identical implementations so...
+	(mV): Define new macro to perform the requisite actions, and...
+	(UR, MT): Make these into wrappers calling mV.
 
-2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/doc.am: Fix build of pic.html from clean tree.
+	* tmac/an-ext.tmac (UR, MT): Fix problem with incorrect line
+	lengths and occasional "can't adjust" warnings when using
+	hyperlinks.  Reduce the line length within the diversion by the
+	amount of indentation used in the context.  Without this, lines
+	were getting set too short.  (You might think they'd be too
+	long, but when creating a new environment, the _formatter's_
+	default line length is used; that's 65n on terminal devices.)
 
-2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4: Kill whitespace in macro diagnostic.
+	man: Add test to ensure that link text (when the hyperlink
+	itself is not formatted because the device supports
+	hyperlinking) uses the correct line length and is adjusted.
 
-2017-11-01  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/tests/an_adjust-link-text-correctly.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
 
-	src/roff/grog/subs.pl: Fix typo in usage message.
+2022-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51540.
+	* font/devpdf/devpdf.am: Refactor.
+	(MOSTLYCLEANFILES): Populate macro incrementally, adjacent to
+	the targets that build the files to be cleaned.  This will
+	enable cleaner refactoring in the future.
+	(DEFAULT_BASE35_FONTS): Add new macro storing the targets of the
+	PostScript Level 2 standard base 35 font descriptions.
+	(devpdffont_DATA): Populate using `DEFAULT_BASE35_FONTS`.
+	(URW_BASE35_FONTS): Add new macro, empty if !HAVE_URW_FONTS;
+	and HAVE_URW_FONTS otherwise naming the `U` foundry font
+	description counterparts of the `DEFAULT_BASE35_FONTS`.
+	(devpdffont_DATA): Append `URW_BASE35_FONTS`.
+	($(DEFAULT_BASE35_FONTS) $(URW_BASE35_FONTS)): Assert dependency
+	on "font/devpdf/download".  This isn't literally true, but
+	BuildFoundries generates all of these together, so if the
+	"font/devpdf/download" target rule runs successfully, the font
+	description files named in these macro expansions will be
+	generated too.
 
-2017-10-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	m.tmac: Fix some formatting and textual issues.
-	* Protect full stops in strings \*Letns!{1,2,10,11}.
-	* Remove extraneous whitespace from string \*Pg_type!1.
+	* src/utils/afmtodit/afmtodit.pl: Add new command-line option to
+	specify the generated font description's "spacewidth" parameter;
+	in commit bf7f6862c3, 2021-09-24, I made libgroff complain if
+	this directive is missing (since any font, even a "special" one,
+	can be selected as current and the formatter's behavior when
+	encountering an input space should be well-defined under that
+	circumstance).  Adding this option enables a well-formed font
+	description to be produced.
+	* src/utils/afmtodit/afmtodit.pl (usage):
+	* src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
+	Document it.
+	* NEWS: Add item.
 
-	Fix bug https://savannah.gnu.org/bugs/?51610.
+2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* src/utils/afmtodit/afmtodit.pl: Use our own fatal exit
+	function instead of Perl's "die".
+	(croak): New subroutine emits argument as part of diagnostic
+	message and exits with status 1.
+	(usage): Exit with status 2, not 1, on usage errors.
 
-	refer-mm.tmac: Protect full stop in abbreviation of "ed.".
+	* NEWS: Document new exit behavior.
 
-	Fix bug https://savannah.gnu.org/bugs/?51611.
+2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+	* font/devpdf/devpdf.am (font/devpdf/download): Improve
+	comprehensibility of comments in generated "download" file.
+	Stop bracketing path element separator with spaces.
 
-	* src/preproc/html/pre-html.cpp: Fix grammar in usage message.
-	When used attributively, e.g. as an adjectival phrase,
-	"command-line" should be hyphenated.
+2022-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Stop
+	capitalizing beginning of diagnostic message (per GNU Coding
+	Standards).  Drop ellipsis from end since no further diagnostics
+	relevant to that message are expected.  Trim trailing slashes
+	from font path elements.
 
-	pdfpic: Suppress warning if in compatibility mode.
+2022-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51945.
+	* font/devps/devps.am: Refactor.  Turn two identical target
+	rules into a (BSD-make-style, old-fashioned) pattern rule.
 
-2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	www.tmac: Rename font 'C' to 'CR'; define 'CR'.
+	* configure.ac: Rechristen self "GNU roff".
 
-	The font name 'C' ('CW') is not a part of groff's fonts.
+2022-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51417.
-	Also see https://savannah.gnu.org/bugs/?51426.
+	* src/preproc/pic/pic.ypp: Slightly refactor.  Rename parameter
+	`form` (format) to `fmt` to make its nature as an abbreviation
+	clear.
+	(format_number, do_sprintf): Reorder null pointer equality
+	comparisons to avoid inadvertent lvalue assignment.
+	(do_sprintf): Declare lists of valid format conversion
+	specifiers and modifiers explicitly instead of as happenstance
+	literals.  Recast diagnostic messages to refer to "invalid", not
+	"bad" input; refer to input keyword correctly as "sprintf" (not
+	"snprintf"); and report the identity of the invalid conversion
+	specifier we reject.
 
-2017-10-04  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix build on MacOS X
+	* tmac/doc.tmac (Fl, doc-flag-recursion, doc-print-recursive)
+	(doc-print-prefixes, Ar, Nm, Pa, Xr, doc-do-func, Fn)
+	(doc-do-func-args, Fo): Remove now-relic resets of type size to
+	previous value.  Since commit 5125754cdf, 23 February, no mdoc
+	macro ever changes the type size.
 
-	See https://savannah.gnu.org/bugs/?49651
+2022-11-08  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-2017-09-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	gropdf: Cater for invalid entries in download file.
 
-	Build from git: Make `configure' fail if `yacc' is not found.
+	* src/devices/gropdf/gropdf.pl: Test if path in the "download"
+	file points to a readable file.  Also change order so that the
+	first valid entry is used as the font to embed.  This replaces
+	previous order where last found entry is used.
 
-	* m4/groff.m4 (GROFF_PROG_YACC): look for (in this order) `byacc',
-	`bison -y', `yacc'.  Set `YACC' to `missing' is nothing is found
-	and generate an error.  Don't generate an error if build is not
-	done from git as tarball already distribute files generated by
-	`yacc'.
+	Fixes <https://savannah.gnu.org/bugs/?62950>.
 
-2017-09-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update `gnulib' submodule with latest version.
+	mdoc: Set page topic in roman in "Name" section.
 
-	* gnulib: now points on 07a187be7f66d3ced66587405f18205971c762e9
-	from `gnulib' repository.
+	* tmac/doc.tmac (Nm): If in the "Name" section of the page, set
+	argument(s) with the `No` (normal formatting) macro instead of
+	handling them...normally.  Since `Nm`'s usual behavior is to set
+	the next argument in boldface, in this circumstance it is set in
+	roman.  Aligns page rendering with man(7) and fixes a bug
+	documented in the 4.3BSD-Reno mdoc.samples(7) page (1990-06-22),
+	upon which the groff_mdoc(7) page is based.
+	* tmac/groff_mdoc.7.man (Bugs): De-document bug.
 
-2017-09-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Fixes part of <https://savannah.gnu.org/bugs/?62926>.
 
-	Fix .gitignore files for in-source build.
+2022-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51415.
+	* tmac/mdoc/doc-common: Add internal register
+	`doc-in-name-section` to keep track of whether a macro is called
+	within the "Name" section of the document, to prepare a means of
+	fixing a long-standing bug with `Nm`.
+	(Sh): Canonicalize capitalization of section heading sooner.
+	Set or clear `doc-in-name-section` based on result.
+	(Rd): Add new register to dump.
+	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+	Handle new register.
 
-2017-09-01  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix build on MacOS X
+	mdoc: Use font CR, not CB, for `Cm` ("command modifier") and
+	`Fl` ("flag") macros on typesetters.
 
-	* Makefile.am: define `SED' command with LANG and LC_ALL set to C.
-	* contrib/mm/mm.am: use it.
-	* doc/doc.am: Ditto.
+	* tmac/mdoc/doc-ditroff (doc-Cm-font, doc-Fl-Font): Switch to
+	Courier roman from Courier bold.  This congrues better with
+	other `Li` literals, which were not in boldface.
 
-	Fix bug https://savannah.gnu.org/bugs/?49649
+2022-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-30  Colin Watson <cjwatson@debian.org>
+	* tmac/mdoc/doc-nroff (doc-Li-Font): Switch from roman to bold.
+	On typesetters, the use of Courier (roman) plainly distinguishes
+	unquoted literals from their context.  On terminals there was no
+	such visible distinction.  Fortunately, in groff_mdoc(7) itself,
+	this does not result in a blinding blitz of boldface because the
+	`Ql` (quoted literal) macro is so often used, and it maintains
+	the roman style.  This change further aligns groff mdoc(7) with
+	groff man(7) style conventions.  (Also see how we handle
+	literals for typesetters and terminals in the "ms.ms" document.)
 
-	`BuildFoundries' should not be installed.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/devpdf.am: remove installation of generated script
-	`BuildFoundries'.
+	mdoc: Make `Sx` macro perform quotation, not italicization.
+	It's thorougly inconsistent with English composition practices
+	to refer to (sub)section headings within a document as if they
+	were major works.
 
-2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/doc.tmac (Sx): Implement.
+	* tmac/mdoc/doc-ditroff (doc-Sx-font):
+	* tmac/mdoc/doc-nroff (doc-Sx-font): Delete.
+	* tmac/groff_mdoc.7.man (Section Cross References): Rename...
+	((Sub)section cross references): ...to this.  Recognize
+	existence of `Ss` macro, curiously overlooked before.
+	* NEWS: Add item.
 
-	pic2graph.1.man: Fix wrong macro for e-mail addresses.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51110.
+	mdoc: Drop now-unused `doc-pageref` string.  It was nowhere
+	interpolated outside of state management macros.
 
-2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+	* tmac/mdoc/doc-common: Do it.
 
-	groff_diff(7): Remove a repeated word.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51077.
+	* tmac/mdoc/doc-common (doc-header, doc-footer): Revise for
+	clarity and to use correct typefaces for titles.
+	(doc-header): Add new strings to ease title construction.
+	`doc-xref` stores the fully formatted page topic and section
+	number, e.g., "troff(1)"; `doc-abbv` stores the its potentially
+	abbreviated form when it is too long to fit.
+	(doc-footer): Use `doc-xref` as above.  Stop setting the `Os`
+	and `Dd` parameters in the ("semantic"?) font used for the
+	page's section number (probably unnoticed all these years
+	because the font used to render that was (Times) roman).
 
-2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	groff_tmac(5): Fix double dot before request.
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common: Rename strings for clarity.
+	- doc-document-title -> doc-page-topic
+	- doc-document-title-saved -> doc-page-topic-saved
+	* tmac/mdoc/doc-common: Use new name.
 
-	Fix bug https://savannah.gnu.org/bugs/?51070.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	* tmac/mdoc/doc-ditroff (doc-page-topic-font):
+	* tmac/mdoc/doc-nroff (doc-page-topic-font): Set man page topic
+	names in italics.
 
-	groff.texi: remove repeated words.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug https://savannah.gnu.org/bugs/?51046.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Rename strings for clarity.
+	- doc-caption-font -> doc-page-topic-font
+	- doc-caption-font2 -> doc-page-section-font
+	* tmac/mdoc/doc-common (doc-header, doc-footer): Use new names.
 
-2017-08-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	groff_man(7) manual page: Fix explanation of the ".itc" request.
+	* tmac/doc.tmac: Delete suppression of `Pa` font selection in a
+	"Files" section.  This special handling was not documented.
 
-	See bug at https://savannah.gnu.org/bugs/?51043.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-28  Ingo Schwarze  <schwarze@usta.de>
+	* tmac/mdoc/doc-ditroff (doc-Pa-font): Set file specifications
+	in italics on typesetters.  (Terminals already use italics.)
 
-	groff_man(7) manual page: recommendations for escape sequences.
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See bug at https://savannah.gnu.org/bugs/?51021.
+	* tmac/mdoc/doc-ditroff (doc-Xr-font):
+	* tmac/mdoc/doc-nroff (doc-Xr-font): Set man page topic cross
+	references in italics.
 
-2017-08-28  Ingo Schwarze  <schwarze@usta.de>
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	groff_char(7) manual: fix table "7-bit Character Codes"
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Rename `doc-Tn-font-shape` to
+	`doc-Tn-font` for better parallelism with other font selection
+	strings for mdoc macros, since the `Tn` macro no longer
+	manipulates the type size.
+	* tmac/doc.tmac (Tn): Use new name.
 
-	See bug at https://savannah.gnu.org/bugs/?51020.
+2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-28  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* doc/groff.texi (Debugging): Fix misleading claim.  The
+	arguments to the `tm`, `tmc`, and `tm1` requests are not read in
+	copy mode.  For example, you don't need to double backslashes to
+	get them to interpolate registers or strings.
 
-	Fix troff.1 misleading definition of -w all.
+2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See bug at https://savannah.gnu.org/bugs/?47784.  Suggested by Kaz
-	Kylheku <kaz@kylheku.com>.
+	* tmac/an.tmac (an-end):
+	* tmac/mdoc/doc-common (doc-end-macro): Ensure that document
+	footer appears in continuous rendering mode even when a final
+	pending output line in the document is 1v from the page bottom.
+	Replace `fl` call with `br`, which IMO has clearer semantics.
+	Extend page length by 1v before doing so if the current vertical
+	position is within 1v of the page bottom.
 
-2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	Thanks to Alex Colomar for the report.
 
-	`preconv --version' crashes.
+2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See bug at: https://savannah.gnu.org/bugs/?51587.
+	man, mdoc: Regression-test special case of continuous
+	rendering when the last pending output line in the document is
+	1v from the (notional) page bottom.
 
-	* src/preproc/preconv/preconv.cpp: Add a missing comma in the
-	argument list of "printf".
+	* tmac/tests/an_output-footer-when-continuously-rendering.sh:
+	* tmac/tests/doc_output-footer-when-continuously-rendering.sh:
+	Do it.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
 
-2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+2022-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix bug: `.itc' request breaks subsequent `.it' requests.
+	* tmac/an.tmac (TE): Update diagnostic to mention another
+	failure mode: a man page that is simply a `so` request requires
+	soelim(1) to be run if the sourced page uses tbl(1).
 
-	See bug at: https://savannah.gnu.org/bugs/?51376.  Using `.itc'
-	lets all later uses of `.it' behave like `.itc', that is,
-	interrupted text line ending with \c is not counted as a separate
-	line.
+2022-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* env.cpp: Restore input_trap state to normal when '.it' is
-	called.
+	* src/devices/xditview/xditview.am
+	($(GXDITVIEW_GROFF_VERSION_H)): Run `$(MKDIR_P)` and `printf` as
+	separate rule commands in order to use them with `$(AM_V_at)`
+	and `$(AM_V_GEN)`, respectively.  Prevents noise from build.
 
-2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+	Fixes <https://savannah.gnu.org/bugs/?63302>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	Fix a part of a virtual (pseudo) structure in "tty.tmac".
+2022-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/tty.tmac: Fix warning:  ".../git/groff/tmac/tty.tmac:19:
-	warning: unbalanced .el request"
+	eqn: Fix Savannah #63299.
 
-2017-08-25  Ingo Schwarze  <schwarze@usta.de>
+	* src/preproc/eqn/main.cpp: Revise input file line number
+	handling.
+	(read_line): Stop dealing with `current_lineno` here; it's now
+	up to its caller (`do_file()`) to manipulate the line number.
+	(do_file): When reading new file, initialize `current_lineno` to
+	1 instead of 0.  Reset it to zero when encountering EOF (so that
+	diagnostics will not include a line number at all).  When
+	performing nested call to `read_line()` to gather '.EN' from
+	input, increment the line number.  Write correct line number in
+	output groff `lf` requests; in groff, its first argument assigns
+	the number of the _next_ input line.  Increment line number at
+	end of outer `read_line()` loop.
 
-	`tty-char.tmac': focus on meaning rather than graphical shape
+	Fixes <https://savannah.gnu.org/bugs/?63299>.  Thanks to Alex
+	Colomar for the report.
 
-	* tmac/tty-char.tmac: add ASCII renderings for six missing
-	mathematical symbols
+2022-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-22  Ingo Schwarze  <schwarze@usta.de>
+	eqn: Regression-test Savannah #63299.
 
-	`tty-char.tmac': focus on meaning rather than graphical shape
+	* src/preproc/eqn/tests/\
+	diagnostics-report-correct-line-numbers.sh: Do it.
+	* src/preproc/eqn/eqn.am (eqn_TESTS, TESTS, EXTRA_DIST): Run
+	test.
 
-	* tmac/tty-char.tmac: Switch the policy from trying to imitate the
-	characters' graphical shapes, which resulted in unintelligible
-	renderings in many cases, to transliterations conveying the
-	characters' meanings.  One benefit is making these characters
-	usable for portable manual pages.
+2022-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* src/utils/grog/grog.pl (fail, warn, construct_command)
+	(version): Restore trailing newlines to `print`ed output.  They
+	went missing when I removed the assignment of the output record
+	separator in commit 6f2e367836, 24 October.  Thanks to Dave
+	Kemper for catching this.
 
-	'gropdf' does not correctly load new ghostscript fonts
+2022-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See bug at: https://savannah.gnu.org/bugs/?50989. Since ghostscript
-	9.21 the fonts supplied have changed from .pfb to .pfa type (with a
-	raw binary section). These failed to be properly loaded.
+	* src/preproc/preconv/preconv.cpp: Trivially refactor.  Rename
+	`default_encoding` to `fallback_encoding` for clarity.  Update
+	comments and debugging diagnostic messages accordingly.
 
-	* src/devices/gropdf/gropdf: Changes to handle raw binary section in
-	a .pfa type font.
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-08-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	grolj4: Absorb lj4_font(5) man page into grolj4(1).
 
-	`pdfmom' man page incorrectly displayed.
+	* src/devices/grolj4/lj4_font.5.man: Delete, moving content...
+	* src/devices/grolj4/grolj4.1.man (Fonts): ...hither.
 
-	* src/devices/gropdf/pdfmom.1.man: Remove `' character mistakenly
-	added at the beginning of the file.
+	* doc/doc.am (GROFF_MAN_PAGES1):
+	* src/devices/grolj4/grolj4.am (man5_MANS, EXTRA_DIST): Stop
+	formatting and shipping removed page.
 
-2017-08-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	* src/roff/groff/groff.1.man:
+	* src/utils/hpftodit/hpftodit.1.man: Drop references to page.
 
-	Incorrect font name for CBI in Foundry.in.
+	Fixes <https://savannah.gnu.org/bugs/?61819>.
 
-2017-08-15  Ingo Schwarze  <schwarze@usta.de>
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix build if `configure' check for `fprintf-posix' fails.
+	mdoc: Support `SN` register to configure subsection heading
+	indentation.
 
-	See bug at: https://savannah.gnu.org/bugs/?51554.  If tests for
-	posix compliance of fprintf from `gnulib_m4/fprintf-posix.m4'
-	fail, a replacement function of `fprintf' is used.  Consequently,
-	all executables that use this function must link against the
-	gnulib (`libgnu.a').  The bug was introduced by commit
-	fa41eeba06987a12bc0434f8b51896d4618a3997.
+	* tmac/doc.tmac: Recognize `SN` register if set on command line
+	and use groff man(7)-compatible default if it is not.
+	* tmac/mdoc/doc-common (Ss): Use this register instead of a
+	literal.
+	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+	nroff): Document it.
+	* NEWS: Update item.
 
-	* src/devices/xditview/xditview.am
-	* src/preproc/eqn/eqn.am
-	* src/preproc/pic/pic.am
-	* src/preproc/preconv/preconv.am
-	* src/preproc/refer/refer.am
-	* src/preproc/soelim/soelim.am
-	* src/preproc/tbl/tbl.am
-	* src/utils/addftinfo/addftinfo.am
-	* src/utils/hpftodit/hpftodit.am
-	* src/utils/indxbib/indxbib.am
-	* src/utils/lkbib/lkbib.am
-	* src/utils/lookbib/lookbib.am
-	* src/utils/pfbtops/pfbtops.am
-	* src/utils/tfmtodit/tfmtodit.am
-	* src/utils/xtotroff/xtotroff.am: link against libgnu.a
-
-	* INSTALL.REPO: recommend the autoconf and automake versions used
-	during automake migration rather than the minimum versions.
-
-2017-08-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
-
-	See bug at: https://savannah.gnu.org/bugs/?51568
-
-	* src/devices/gropdf/gropdf: Further 'fix' to handle those octal
-	characters. See comment #5 - thank you Bjarni.
-
-2017-07-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
-
-	See bug at: https://savannah.gnu.org/bugs/?51568
-	
-	* src/devices/gropdf/gropdf: previous 'fix' was too narrow, all
-	'\' characters should be escaped. Also there was an unwanted 
-	interaction with code in routine 'do_t'. Sometimes, do_C, when 
-	the named glyph is mapped to a chr < 32, this is encoded as octal
-	\nnn, so in this case the '\' must not be escaped.
-	
-2017-07-25  Deri James  <deri@chuzzlewit.myzen.co.uk>
-
-	If input text contained string which could be interpreted as
-	escaped octal (\ddd) a pdf viewer would interpret as an octal
-	character.  See bug at: https://savannah.gnu.org/bugs/?51568
-	
-	* src/devices/gropdf/gropdf: protect text which resembles \ddd
-	by escaping with extra '\'.
-	
-2017-07-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>
-
-	Use uchardet library in `preconv' to detect input file encoding
-
-	* m4/groff.m4 (GROFF_UCHARDET): new macro that use pkg-config to
-	check if uchardet library is available and define new option
-	`--with-uchardet':
-	- If `yes' is passed and uchardet is not found, configure fails.
-	- If `no' is passed we don't use uchardet and don't display any
-	warning.
-	- If `auto' (or any other option) is passed of if --with-uchardet
-	is not passed, we use uchardet if available, otherwise the build
-	goes on but a warning is displayed at the end of the configuration
-	phase.
+	Fixes part of <https://savannah.gnu.org/bugs/?62926>.
 
-	* configure.ac: use pkg-config and `GROFF_UCHARDET' to detect the
-	presence of uchardet library.
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/preconv/preconv.am: link against uchardet library if
-	available.
+	mdoc: Support `IN` register to configure paragraph
+	indentation.
 
-	* src/preproc/preconv/preconv.cpp (detect_file_encoding): new
-	function that uses uchardet library to detect input file encoding.
-	(do_file): `detect_file_encoding'.
+	* tmac/doc.tmac: Recognize `IN` register if set on command line
+	and use groff man(7)-compatible defaults if it is not.
+	* tmac/mdoc/doc-common (Sh): Use this register instead of
+	`doc-paragraph-indentation`.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Stop setting pargraph indentation
+	defaults here.
+	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+	nroff): Document it.
+	* NEWS: Update item.
 
-	* src/preproc/preconv/preconv.1.man: update `preconv'
-	documentation.
+	* tmac/tests/doc_Mt-works.sh:
+	* tmac/tests/doc_indents-correctly.sh: Update test expectations.
 
-	See https://savannah.gnu.org/bugs/?51330
+	Fixes part of <https://savannah.gnu.org/bugs/?62926>.
 
-2017-07-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Add gnulib module fprintf-posix
+	* tmac/mdoc/doc-common (Sh): Fix code style nit.  Set paragraph
+	indentation absolutely rather than incrementally.  mdoc(7)
+	doesn't have relative inset macros like man(7)'s `RS`/`RE`, so
+	the relative measurement could mislead the reader.  (The
+	section heading itself uses an indentation of 0.)
 
-	* bootstrap.conf: do it.
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Fix compilation in some files that needed inclusion of
-	`config.h'.
+	mdoc: Fix Debian #1022179.
 
-	See https://savannah.gnu.org/bugs/?51330
+	* tmac/mdoc/doc-common (Ss): Indent entire subsection heading by
+	3 ens, even if it breaks across output lines.  (Change and
+	restore indentation explicitly instead of using a temporary
+	indent to achieve this.  Also indent absolutely by 3n instead of
+	retreating by one quarter inch.)
 
-2017-05-09  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+	Fixes <https://bugs.debian.org/1022179>.  Thanks to наб for the
+	report.
 
-	Package `ghostscript' 9.21 renamed some fonts installed in
-	`/usr/share/ghostscript/9.21/Resource/Font', e.g. URWGothicL-Demi
-	renamed to URWGothic-Demi, and droped the installation of URW
-	fonts in `/usr/share/fonts/type1/gsfonts/', breaking font
-	generation in `font/devpdf/util/BuildFoundries.pl'.
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4 (GROFF_URW_FONTS_PATH): New option
-	`--with-urw-fonts-dir' to pass a custom path to URW fonts.
-	(GROFF_URW_FONTS): search the presence of URW fonts by checking if
-	file `a010013l.pfb' exists in the paths given by `gs -h', in the
-	default paths used in `Foundry.in' and in the path given with
-	option `--with-urw-fonts-dir'.
-	(GROFF_URW_FONTS_CHECK): print a warning at the end of the
-	configuration phase if no URW fonts were found.
+	* tmac/tests/doc_indents-correctly.sh: Add regression test for
+	Debian #1022179.
 
-	* configure.ac: call new macros `GROFF_URW_FONTS_PATH',
-	`GROFF_URW_FONTS' and `GROFF_URW_FONTS_CHECK'.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* font/devpdf/Foundry.in: add new basic fonts names and pass
-	custom URW fonts path `urwfontsdir'.
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/devpdf.am: subsitute `urwfontsdir' in `Foundry'
-	generation.
+	mdoc: Fix misleading register name.
 
-	Fixes https://savannah.gnu.org/bugs/?50786
+	* tmac/mdoc/doc-common (Sh):
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Rename `doc-subheader-indent` to
+	`doc-paragraph-indentation`, because the latter is what it's
+	used for.
 
-2017-05-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-10-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fixes for gropdf
-	
-	* src/devices/gropdf/gropdf.pl: Escape '(' and ')' if
-	used in a bookmark, and ignore relative move 'h' if 
-	followed by absolute move 'H' in groff intermediate output.
-	
-2017-04-29  Ingo Schwarze  <schwarze@usta.de>
+	* m4/groff.m4 (GROFF_POPPLER): Improve shell code portability.
+	Per the GNU Autoconf manual, "The -a, -o, '(', and ')' operands
+	are not present in all implementations, and have been marked
+	obsolete by Posix 2008.  ...portable uses of test should never
+	have more than four arguments, and scripts should use shell
+	constructs like '&&' and '||' instead."
 
-	groff_char(7): improve description of ASCII characters
+2022-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_char.7.man: improve description of ASCII
-	characters that do not render as themselves
+	* src/preproc/preconv/preconv.cpp: Alter usage message handling.
+	(usage): Summarize purpose of program and steer reader to man
+	page (only) if help was explicitly requested, and exit
+	successfully from here...
+	(main): ...instead of calling scope.
 
-	See https://savannah.gnu.org/bugs/?50898
+2022-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-28  Osamu Sayama
+	* src/preproc/preconv/preconv.cpp (usage): Use more
+	communicative metasyntactic variable names.
+	* src/preproc/preconv/preconv.1.man (Synopsis, Options): Align
+	with updated usage message.
 
-	lkbib with empty file dumps core
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libbib/index.cpp: Test if argument to malloc(3)
-	is zero.
+	* src/preproc/html/pre-html.cpp: Alter usage message handling.
+	(usage): Summarize purpose of program and steer reader to man
+	page (only) if help was explicitly requested, and exit
+	successfully from here...
+	(main): ...instead of calling scope.
 
-	See https://savannah.gnu.org/bugs/?48433
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-28  David Gilman
+	* src/devices/grolbp/lbp.cpp: Alter usage message handling.
+	(usage): Summarize purpose of program and steer reader to man
+	page (only) if help was explicitly requested, and exit
+	successfully from here...
+	(main): ...instead of calling scope.
 
-	Typo in groff.texi
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texi: Dp instead of DP used
+	* src/devices/grolbp/lbp.cpp (main): Handle `getopt_long()`
+	return value more idiomatically.
 
-	https://savannah.gnu.org/bugs/index.php?42251
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-28  Rich Burridge
+	* src/devices/grolbp/lbp.cpp: Fix code style nits.
+	(main): Use standard C library symbols `EXIT_SUCCESS` and
+	`EXIT_FAILURE` instead of integer literals as arguments to
+	`exit()`.  Add assertion.
 
-	"grops -c a" dumps core
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grops/ps.cpp: conversion specifier %s changed
-	to %1 (errprint() uses special syntax different from
-	printf(3))
+	* src/devices/grotty/tty.cpp: Alter usage message handling.
+	(usage): Summarize purpose of program and steer reader to man
+	page (only) if help was explicitly requested, and exit
+	successfully from here...
+	(main): ...instead of calling scope.
 
-	https://savannah.gnu.org/bugs/?42190
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-28  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* src/devices/grotty/tty.cpp: Fix code style nits.
+	(main): Use standard C library symbols `EXIT_SUCCESS` and
+	`EXIT_FAILURE` instead of integer literals as arguments to
+	`exit()`.  Replace `assert(0)` call with communicative
+	predicate.
 
-	Macro "itc" is needed to make escape "\c" useful
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-old.tmac: .it changed to .itc
+	* src/roff/groff/groff.cpp: Alter usage message handling.
+	(synopsis, help): Coalesce these two functions...
+	(usage): ...into this one.  Summarize purpose of program and
+	steer reader to man page only if help was explicitly requested,
+	rather than blitzing user with text upon a usage error.  Also
+	drop option summary from usage message, as it duplicates
+	groff(1).
 
-	https://savannah.gnu.org/bugs/?42907
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-28  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* src/utils/grog/grog.pl: Alter usage message handling.
+	(help): Rename this subroutine...
+	(usage): ...to this.  Summarize purpose of program and steer
+	reader to man page only if help was explicitly requested, rather
+	than blitzing user with text upon a usage error.  Also drop
+	option summary from usage message, as it duplicates grog(1).
 
-	First italic correction (\,) is absent in macros IR and IB
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-old.tmac: Italic correction added
+	* src/utils/grog/grog.pl: Drop relic code and comments.
 
-	https://savannah.gnu.org/bugs/?42906
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-04-13  Ingo Schwarze  <schwarze@usta.de>
+	grog: Migrate expansion of Perl interpreter in shebang.
+	Use the same technique as afmtodit, mmroff, gropdf, and pdfmom.
 
-	* tmac/doc.tmac-u: Make .Lk with more than two arguments
-	mdoc(7) conform
+	* src/utils/grog/grog.am (grog): Replace "@PERL@" instead of
+	'^$#! $.*perl'.
+	* src/utils/grog/grog.pl: Use "@PERL@" in shebang.
 
-	Use the second and following arguments as the link text.
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Do not mark up the following colon with \fI.
+	afmtodit: Give program a usage message.
 
-	Handle any number of trailing delimiters.
+	* src/utils/afmtodit/afmtodit.pl: Add new scalar `want_help` of
+	Boolean sense.  Recognize new long option `--help`, attached to
+	`$want_help`.  Stop stripping off directory name components from
+	program name when emitting diagnostics.  No other groff program
+	does this (well, gropdf did until recently), and it might save
+	users some confusion if they're working with multiple copies of
+	afmtodit.
+	(usage): New subroutine reports usage message.  If help was
+	explicitly requested, summarize purpose of program and steer
+	reader to man page.
 
-	Problem reported by Anthony Bentley <bentley@openbsd.org>,
-	fixed by Ingo Schwarze <schwarze@usta.de>.
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	https://savannah.gnu.org/bugs/?50789
+	afmtodit: Migrate expansion of Perl interpreter in shebang.
+	Use the same technique as mmroff, gropdf, and pdfmom.
 
-2017-04-12  Werner LEMBERG  <wl@gnu.org>
+	* src/utils/afmtodit/afmtodit.am (afmtodit): Replace "@PERL@"
+	instead of "/usr/bin/perl".
+	* src/utils/afmtodit/afmtodit.pl: Use "@PERL@" in shebang.
 
-	Update German hyphenation patterns.
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/de.tmac: Add more hcode values.
-	No longer use `hyphenex.det'.
-	* tmac/hyphen.den, tmac/hyphen.det: Updated to `dehyph-exptl-0.41'.
-	* tmac/hyphenex.det: Removed, no longer needed.
-	* tmac/tmac.am (TMACNORMALFILES): Updated.
+	gropdf Give program a usage message.
 
-2017-04-10  Ingo Schwarze  <schwarze@usta.de>
+	* src/devices/gropdf/gropdf.pl: Add new scalar `want_help` of
+	Boolean sense.  Recognize new long option `--help`, attached to
+	`$want_help`.
+	(usage): New subroutine reports usage message.  If help was
+	explicitly requested, summarize purpose of program and steer
+	reader to man page.
 
-	* tmac/doc.tmac-u: Punctuation handling of .Lk fixed
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The implementation of the groff_mdoc(7) .Lk (hyperlink) macro
-	contains code to make sure that the second argument is not
-	punctuation before treating it as a link text, but the test
-	can never lead to the result "punctuation" because the
-	initialization of the global variable doc-width was missing
-	before the call to doc-get-arg-type.  Consequently, even "."
-	was not recognized as punctuation.
+	* src/devices/xditview/xditview.c (Syntax): "#if 0" out
+	reference to `-noPolyText` option, whose effect is likewise
+	bracketed in another file.
 
-	Problem reported by Anthony Bentley <bentley@openbsd.org>,
-	fixed by Ingo Schwarze <schwarze@usta.de>.
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	https://savannah.gnu.org/bugs/?50771
+	* src/roff/troff/input.cpp (enable_warning, disable_warning):
+	Recast diagnostic messages for clarity.
 
-2017-04-07  Werner LEMBERG  <wl@gnu.org>
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/hyphenex.us: Updated to current release from TeXLive.
+	pfbtops: Fix code style and diagnostic nits.
 
-2017-02-23  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	* src/utils/pfbtops/pfbtops.c (error): Exit with `EXIT_FAILURE`
+	status (from standard C library) instead of status 2.
+	(main): Exit with `EXIT_SUCCESS` status when writing version or
+	help information.  Exit with status 2 when dying due to usage
+	error.  Use `fprintf()` and `strerror()` to construct error
+	message when dying due to inability to open input file instead
+	of using `perror()`, which anonymizes its caller and thus should
+	never be used in serious work.  Avoid it like `gets()`.
+	* NEWS: Add item for exit status changes.
 
-	* bootstrap: update with latest version from gnulib.
-	* gnulib: update the git submodule with latest version (commit
-	4084b3a1094372b960ce4a97634e08f4538c8bdd from gnulib).
+	Continues the long process of fixing Savannah #52463.
 
-2017-02-18  Colin Watson  <cjwatson@debian.org>
+2022-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/main.cpp: Define EQ and EN if they are not already
-	defined, to appease "groff -wmac".
-	* src/preproc/pic/main.cpp: Likewise for PS and PE.
+	man pages: Don't document macro package compatibility wrapper
+	directory if it's not used.
 
-	Fixes: http://bugs.debian.org/495713
+	* Makefile.am (.man): Use sed to replace
+	'@COMPATIBILITY_WRAPPERS@' in man page text with value of
+	`compatibility_wrappers` shell variable.  Document its purpose.
+	* src/preproc/eqn/eqn.1.man (Description):
+	* src/preproc/grn/grn.1.man (Options):
+	* src/roff/groff/groff.1.man (Installation directories):
+	* src/roff/troff/troff.1.man (Environment): Mention
+	`@SYSTEMMACRODIR@` only if `@COMPATIBILITY_WRAPPERS@` expands to
+	something other than "no" (it could be "yes" or "manual").
 
-2017-02-16  Ingo Schwarze  <schwarze@usta.de>
+	Thanks to Alexander Kanavin and Jeremy Puhlman for the report.
 
-	mdoc %T: use typographic quotes
+2022-10-21  Robert Yang <liezhi.yang@windriver.com>
 
-	* tmac/doc.tmac-u: Changed \*q to \*Lq and \*Rq
+	* font/devpdf/util/BuildFoundries.pl:
+	* src/devices/gropdf/gropdf.pl:
+	* src/devices/gropdf/pdfmom.pl: Replace use of '-w' in shebang
+	line with "use warnings;".
+
+2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/fallbacks.tmac: Define fallback characters for many code
+	points from the Unicode General Punctuation Block.  This is to
+	ease migration from other documentation formats; in many cases
+	there are more idiomatic *roff ways of getting results that
+	typeset better and are amenable to fine tuning.  For instance,
+	Unicode defines spaces and dashes of various discrete widths;
+	when typesetting with *roff, you can have a space or dash (among
+	other things) of any length achievable by the output device.
+	* tmac/ps.tmac: Migrate non-breaking hyphen fallback character
+	definition from here to the foregoing.
+
+	Fixes <https://savannah.gnu.org/?58930>.  Thanks to Dave Kemper
+	for the report and discussion.
+
+2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac:
+	* tmac/s.tmac: Escape newlines when opening conditional blocks.
+
+	Fixes <https://savannah.gnu.org/?63197>.  Thanks to Bjarni Ingi
+	Gislason for the report and Dave Kemper for the quick fix.
+
+2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grodvi/dvi.cpp (usage):
+	* src/devices/grohtml/post-html.cpp (usage):
+	* src/devices/grolbp/lbp.cpp (usage):
+	* src/devices/grolj4/lj4.cpp (usage):
+	* src/devices/grops/ps.cpp (usage):
+	* src/devices/grotty/tty.cpp (usage):
+	* src/devices/xditview/xditview.cpp (usage):
+	* src/preproc/eqn/main.cpp (usage):
+	* src/preproc/grn/main.cpp (usage):
+	* src/preproc/html/pre-html.cpp (usage):
+	* src/preproc/pic/main.cpp (usage):
+	* src/preproc/preconv/preconv.cpp (usage):
+	* src/preproc/refer/refer.cpp (usage):
+	* src/preproc/soelim/soelim.cpp (usage):
+	* src/preproc/tbl/main.cpp (usage):
+	* src/roff/groff/groff.cpp (synopsis, help):
+	* src/roff/nroff/nroff.sh:
+	* src/roff/troff/input.cpp (usage):
+	* src/utils/addftinfo/addftinfo.cpp (usage):
+	* src/utils/hpftodit/hpftodit.cpp (usage):
+	* src/utils/indxbib/indxbib.cpp (usage):
+	* src/utils/lkbib/lkbib.cpp (usage):
+	* src/utils/lookbib/lookbib.cpp (usage):
+	* src/utils/pfbtops/pfbtops.c (usage):
+	* src/utils/tfmtodit/tfmtodit.cpp (usage):
+	* src/utils/xtotroff/xtotroff.c (usage): Update usage message.
+	Present different modes of operation on separate output lines.
+	Sort options in English lexicographic order.  Document help
+	option(s) as last mode of operation.
+
+2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl: Revise handling of argument 0.
+	Rename scalar `progname` to `prog` for brevity (and preparation
+	for writing a usage message).  Also stop stripping off directory
+	name components from it.  No other groff program does this, and
+	it might save users some confusion if they're working with
+	multiple copies of gropdf.
+
+2022-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Migrate terminology from "paper size" to "paper format" or
+	"paper dimensions" as appropriate in documentation and
+	diagnostic messages.  "Format" implies an orientation (which can
+	be overridden in many cases) whereas size does not.  When only
+	the magnitudes of measurements are at issue (mainly for internal
+	purposes), use the term "dimensions".
 
-	Citing Anthony J. Bentley:
+	* NEWS:
+	* PROBLEMS:
+	* doc/groff.texi:
+	* m4/groff.m4 (GROFF_PAGE):
+	* man/groff_font.5.man:
+	* man/groff_tmac.5.man:
+	* src/devices/grodvi/dvi.cpp (main):
+	* src/devices/grolbp/grolbp.1.man:
+	* src/devices/grolbp/lbp.cpp (main):
+	* src/devices/grolj4/grolj4.1.man:
+	* src/devices/grolj4/lj4.cpp (lj4_printer::lj4_printer, main):
+	* src/devices/grolj4/lj4_font.5.man:
+	* src/devices/gropdf/gropdf.1.man:
+	* src/devices/grops/grops.1.man:
+	* src/devices/grops/ps.cpp (main):
+	* src/roff/groff/groff.1.man:
+	* tmac/papersize.tmac: Do it.
 
-	The below patch causes -mdoc to generate typographic quotes
-	around a %T (reference title) instead of straight quotes.
+2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	I also submitted similar diffs to mandoc and heirloom troff
-	(which haven't been committed yet).  It would be nice for
-	the major implementations not to differ here, and the change
-	is trivial. 
+	* tmac/mdoc/doc-ditroff (doc-left-parenthesis)
+	(doc-right-parenthesis, doc-left-bracket, doc-right-bracket):
+	Drop thin and hair space escape sequences from these string
+	definitions.  (Also, doc-right-bracket was inconsistent with
+	doc-left-bracket, the former inserting horizontal motion only
+	before the bracket character.)  Eliminates excess space when
+	using Pq, Po, Pc and Bq, Bo, Bc macros and formatting for
+	typesetters, and aligns output with behavior of `Pq` and `Bq` as
+	documented in groff_mdoc(7).
 
-	It's worth noting that groff's refer(1) already uses typographic
-	quotes around %T with my -ms documents.
+	Fixes <https://bugs.debian.org/1021795>.  Thanks to наб for the
+	report.
 
-	https://savannah.gnu.org/bugs/?43553
-	http://comments.gmane.org/gmane.comp.tools.mdocml.devel/723 
-	https://github.com/n-t-roff/heirloom-doctools/pull/6
+2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2017-02-16  Ingo Schwarze  <schwarze@usta.de>
+	* tmac/mdoc/doc-ditroff: Use groff-canonical typeface names in
+	font selection escape sequences.  Migrate 'C' to 'CR' and 'CO'
+	to 'CI'.  (Admittedly, "Courier oblique" is more pedantically
+	correct than "Courier italic".  But the iron ball of Unix troff
+	history and its style trio later quartet of "R", "I", "B"
+	{then "BI"} will not be ignored.)
 
-	mdoc \*Lq, \*Rq: map to \lq, \rq for all terminal
-	devices
+2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc-nroff-u: .ds Lq \lq, .ds Rq \rq
+	* tmac/mdoc/doc-ditroff: Drop nilpotent type size escape
+	sequences from string definitions.
 
-	If you use \lq and \rq directly in your document, the
-	quotes already render nicely for all terminal devices:
-	as U+201C and U+201D for devutf8 and as ASCII 0x22 (") for
-	devascii and devlatin1.
-	So it is not quite clear why doc-nroff should avoid
-	\lq and \rq when resolving \Lq and \Rq for devascii
-	and devlatin1. Quite to the contrary, many people seem to
-	consider "``" and "''" ugly renderings because they look
-	unbalanced.
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See
+	Document a CSTR #54 erratum regarding \n(st and \n(sb.
 
-	https://savannah.gnu.org/bugs/?43554
+	* doc/groff.texi (Page Motions):
+	* man/groff.7.man (Writable registers):
+	* man/groff_diff.7.man (New registers): Do it.
 
-2017-02-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* PROBLEMS: Further clarify.  Note DWB and Heirloom behavior.
 
-	Use the traditional (portable) method of using a backslash
-	after '\{'
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/mm/m.tmac, tmac/e.tmac-u,
-	  tmac/s.tmac: Add '\' after "\{"
+	* src/preproc/eqn/main.cpp (read_line): Fix switched test
+	consequents when updating `current_lineno`.
 
-	See
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	https://savannah.gnu.org/bugs/?49917
+	* src/utils/xtotroff/xtotroff.c (main): Annotate "xtotroff" as a
+	GNU program in version information.
 
-2017-02-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use explicit \s±n after a variable string instead of \s0
+	* src/devices/xditview/xditview.am
+	($(GXDITVIEW_GROFF_VERSION_H): Perform correct substitution to
+	get groff version string into `Version_string` C symbol.
+	Continues commit c73decb58f, 9 October.
 
-	* tmac/e.tmac-u: Change \s0 to \s+3
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See
+	* src/utils/afmtodit/afmtodit.1.man (Files): Fix ordering error.
 
-	https://savannah.gnu.org/bugs/?49915
+	Fixes <https://savannah.gnu.org/bugs/?63228>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2016-12-29  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Remove duplicate '-e' from gropdf manual.
-	
-	* src/devices/gropdf/gropdf.1.man: Remove first '-e'.
-	
-2016-11-25  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* src/preproc/eqn/lex.cpp (get_delimited_text): Clear line
+	number when hitting EOF.
+	* src/preproc/eqn/main.cpp: Revise end-of-file handling.  Clear
+	line number upon reaching EOF so that we don't report a nonsense
+	value one greater than the number of lines in the input file.
+	(read_line): Boolify.  Make static (local linkage only), since
+	it has no external callers.  Introduce new Boolean variable
+	`is_end_of_file`.  Clear `current_lineno` if EOF, and increment
+	it otherwise.
+	(do_file, main): Clarify diagnostic messages.
 
-	Remove incorrect info from gropdf manual.
-	
-	* src/devices/gropdf/gropdf.1.man: Remove references
-	to postscript.
-	
-2016-11-22  George HELFFRICH  <ghfbsd@gmail.com>
+2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	me: Fix alignment of `(c' macro (#43306).
+	eqn: Improve diagnostics involving unprintable characters.
 
-	* tmac/e.tmac-u ((c): Properly initialize environment.
+	* src/preproc/eqn/main.cpp (input_char_description): New
+	function constructs a human-readable string describing
+	characters.
+	(read_line, inline_equation, main): Call new function and adjust
+	diagnostic message wording to accommodate the phrase it returns.
 
-2016-11-20  George HELFFRICH  <ghfbsd@gmail.com>
+	Fixes <https://savannah.gnu.org/bugs/?63218>.
 
-	me Fix vertical spacing of `(b' macro (#42217).
+2022-10-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/e.tmac-u (@k): Apply pre-spacing conditionally.
-	()b): Updated.
+	eqn: Improve diagnostics.
 
-2016-11-19  George HELFFRICH  <ghfbsd@gmail.com>
+	* src/preproc/eqn/lex.cpp (file_input::~file_input):
+	* src/preproc/eqn/main.cpp (main): Die if `fclose()` fails and
+	report underlying system error.
+	(inline_equation): Identify inline equation context.
 
-	me Fix remaining bugs with line numbering (#49650).
+2022-10-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/e.tmac-u (nm): Redefine.
-	(.n1, .n2): Update so all environments affected.
-	(.ip): Fix double numbering.
-	(.)c, .)l): Restore numbering after diversion included.
+	* tmac/e.tmac (2c, 1c): Throw diagnostic if changing columnation
+	with a footnote pending.  This isn't necessarily an error per
+	se, but in many cases it will flag an undesirable page layout
+	due to the limited flexibility of me(7)'s footnote support at
+	present.  See <https://savannah.gnu.org/bugs/?63176>.
 
-2016-11-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-10-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	gropdf remaps characters to position 13 (#48986).
-	
-	* src/devices/gropdf/gropdf: Do not remap anything to chr(13).
+	* src/preproc/eqn/main.cpp: Fix code style nits.
+	(usage): Align output with man page.  Document separate
+	invocation modes separately.
+	(main): Use standard C library symbols `EXIT_SUCCESS` and
+	`EXIT_FAILURE` with `exit()` calls instead of integer literals.
+	Replace `assert(0)` call with communicative predicate.  Check
+	return value of `fclose()`, and exit with fatal error if it
+	fails.  Distinguish `ferror()` status and `fflush(stdout)`
+	failures when cleaning up before exit.
 
-2016-11-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-10-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	pdfmom was not including $preconv in the initial groff run.
-	
-	* src/devices/gropdf/pdfmom.pl: Include $preconv in first 
-	groff run which resolves forward pdf references.
+	* src/roff/troff/input.cpp (read_color_draw_node): Clarify
+	diagnostic.
 
-2016-10-05  Ingo Schwarze  <schwarze@usta.de>
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc.tmac-u: Simplify behaviour of .Bl -tag
-	* tmac/groff_mdoc.7.man: Update documentation to the new
-	behaviour of .Bl -tag
+	* tmac/dvi.tmac: Always render \aq as a neutral apostrophe.
+	Thanks to the TC fonts, we can do this even when the default CM
+	text fonts are in use.
 
-	If an mdoc(7) .Bl -tag macro lacks the -width argument, the
-	body indentation is calculated separately for each child .It
-	macro.  Neither the Heirloom nor the mandoc(1) implementation
-	of the mdoc(7) language show such behaviour; both use a
-	constant default width for the whole list in that case.
+	Fixes <https://savannah.gnu.org/bugs/?63200>.
 
-	Apart from doubts whether lists with variable indentation are
-	typographically sound in the first place, support for variable
-	widths in groff is so restricted that it's practically
-	useless.  For each .It, the width will be the default width of
-	whatever happens to be the leading macro after the .It, or of
-	.No if .It is not followed by a macro.
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	See
+	* tmac/ec.tmac: Remove apparently unnecessary remappings of
+	styles (and reassertion of style slots in the font mounting
+	position list, albeit in an unusual order (RBI instead of RIB)).
+	This code frustrated the rendering of man pages with post-1.22.4
+	groff for the 'dvi' output device when using EC fonts.  Instead
+	remap the T and H family typefaces in all four styles
+	explicitly.  (The CW and CWI faces were already handled.)  Also
+	add remappings of groff+PostScriptish font names "CB" and "CBI"
+	to CW EC faces of normal weight, corresponding to dvi.tmac; see
+	commits 529e2ca0c4, 2002-03-23 and c9741da6c0, 2021-05-06.
 
-	https://savannah.gnu.org/bugs/index.php?49272
+	Fixes <https://savannah.gnu.org/bugs/?63194>.
 
-	and
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	http://lists.gnu.org/archive/html/groff/2016-10/msg00006.html
+	* tmac/tests/an_works-with-ec.sh: Add regression test for
+	Savannah #63194.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2016-09-09  Werner LEMBERG  <wl@gnu.org>
+	* tmac/tests/ec_works.sh: Add unit test to validate use of EC
+	fonts when "-mec" option given.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* tmac/sv.tmac: Fix `.hy' settings (#48904).
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The Swedish patterns allow hyphenation after the first character and
-	before the last two characters, not vice versa.
+	* tmac/latin2.tmac:
+	* tmac/latin5.tmac:
+	* tmac/latin9.tmac: Perform the character remapping shenanigans
+	of the fix for Savannah #63112 only if the output device is
+	"latin1" (a terminal using an 8-bit character encoding).  Only
+	then can we be sure that Latin-1 glyphs will be unavailable when
+	other encodings are used and that `\N` escape sequences will
+	identify correct glyph indices in a font (because there is no
+	font per se accessible to groff--simply a terminal implementing
+	a character encoding).
 
-2016-09-09  Werner LEMBERG  <wl@gnu.org>
+2022-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	troff: Fix hyphenation (#48904).
+	* src/devices/gropdf/gropdf.pl (GetType1): Clarify diagnostic.
+	When failing to open a font file for embedding in a PDF, mention
+	this context.
 
-	This commit fixes two bugs present from the very beginning: troff
-	(a) didn't allow to hyphenate words shorter than 4 characters
-	(ignoring `.hy' settings), and (b) never tried to hyphenate after
-	the first character due to wrong handling of the `.hy' settings.
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/env.cpp (environment::hyphenate_line): Use
-	hyphenation flags to determine the minimum word length considered
-	for hyphenation.
-	(hyphenate): Fix handling of `HYPHEN_FIRST_CHARS'.
+	* src/utils/afmtodit/afmtodit.tables: Update against Unicode 15.
+	No substantive changes.
 
-2016-07-29  Colin Watson  <cjwatson@debian.org>
+	Fixes <https://savannah.gnu.org/bugs/?63188>.
 
-	Implement `SOURCE_DATE_EPOCH' for reproducible builds.
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/include/curtime.h: New file.
-	* src/libs/libgroff/curtime.cpp: New file.
-	* src/libs/libgroff/libgroff.am (libgroff_a_SOURCES): Add
-	src/libs/libgroff/curtime.cpp.
+	* configure.ac: If URW fonts were located, add the directory
+	where they were found to the configuration report.
 
-	* src/roff/troff/input.cpp (init_registers): Use `current_time'
-	instead of `time(0)'.
-	* src/devices/grohtml/post-html.cpp
-	(html_printer::do_file_components): Likewise.
-	(html_printer::~html_printer): Likewise.
-	* src/devices/grops/ps.cpp (ps_printer::~ps_printer): Likewise.
-	* src/devices/gropdf/gropdf.pl: Use `$ENV{SOURCE_DATE_EPOCH}` if
-	available in preference to `time`.
+	Attempts to fix <https://savannah.gnu.org/bugs/?62860> (2/2).
 
-	* doc/groff.texi (Environment): Document `SOURCE_DATE_EPOCH'.
-	* src/devices/grohtml/grohtml.1.man (ENVIRONMENT): Likewise.
-	* src/devices/gropdf/gropdf.1.man (ENVIRONMENT): Likewise.
-	* src/devices/grops/grops.1.man (ENVIRONMENT): Likewise.
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2016-04-19  Carsten Kunze  <carsten.kunze@arcor.de>
+	* m4/groff.m4: Try to make gropdf's search for URW font files
+	more deterministic.  To disambiguate cases where multiple--not
+	necessarily identical--copies may be found on the system, search
+	_only_ in the directory given to the `--with-urw-fonts-dir`
+	configure option, if present.  This populates the "Foundry" file
+	generated by the build, causing gropdf to search there first.
+	(GROFF_URW_FONTS_PATH): Stop `AC_SUBST`ing `urwfontsdir` here.
+	(GROFF_URW_FONTS_CHECK): `AC_REQUIRE` `GROFF_URW_FONTS_PATH` to
+	be run first.  If `urwfontsdir` is not null, search only there
+	for URW fonts.  Assign `urwfontsdir` the value of the directory
+	in which the fonts are found.  Assign it an empty value if none
+	are found.  Either way, `AC_SUBST` the variable.
 
-	eqn: Fix problem with explicite spacing before unary operator
+	Attempts to fix <https://savannah.gnu.org/bugs/?62860> (1/2).
 
-	* src/preproc/eqn/list.cpp (list_box::compute_metrics): Change
-	item spacing type from BINARY to ORDINARY also when previous
-	type is SUPPRESS_TYPE.
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	As reported in
+	* src/devices/gropdf/gropdf.pl (LoadFont): Clarify diagnostic.
+	gropdf opens "fonts" in two distinct ways.  On the one hand, it
+	opens groff font description files for essentially all
+	nontrivial output.  On the other, it may open actual Type 1 font
+	files for embedding in a PDF.  Make failure of the former case
+	less confusable with the latter.
 
-	http://lists.gnu.org/archive/html/groff/2016-04/msg00024.html
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	by Douglas McIlroy <doug@cs.dartmouth.edu>
+	ms: Document new XN/XH and related macros.
 
-	an implicite space is added between an unary operator and it's
-	operand when an explicite space is put before the unary
-	operator.  Unary operators are initially set up as binary.
-	Depending on the preceding element their type can be changed
-	to unary.  This did not happen when an explicite space ('~' or
-	'^') had been before that operator.
+	* doc/groff.texi (Creating a table of contents):
+	* doc/ms.ms (Creating a table of contents):
+	* tmac/groff_ms.7.man (Creating a table of contents): Do it.
 
-2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+	Fixes <https://savannah.gnu.org/bugs/?63110>.
 
-	Fix many malloc/new vs. free/delete/delete mismatches (#47164)
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grops/ps.cpp (ps_font::~ps_font,
-	ps_printer::define_encoding): Use `free'.
-	* src/devices/grops/psrm.cpp (resource::~resource,
-	resource_manager::output_prolog, resource_manager::supply_resource,
-	resource_manager::read_download_file): Ditto.
+	gxditview: Support `-version`, `--version` option.  As a C
+	program, gxditview had no access to the (C++) libgroff
+	`Version_string` symbol, so construct a header file to store
+	this datum at build time.  If groff gets other user-facing C
+	programs, we should consider generating this header in
+	src/include instead.
 
-	* src/include/ptable.h (PTABLE::~PTABLE, PTABLE::define): Ditto.
+	* src/devices/xditview/xditview.am: Generate "groff_version.h"
+	file.
+	(GXDITVIEW_GROFF_VERSION_H): Define new macro.
+	($(GXDITVIEW_GROFF_VERSION_H)): Define target to generate file.
+	(XDITVIEW_GENHDRS): Add $(GXDITVIEW_GROFF_VERSION_H).
+
+	* src/devices/xditview/xditview.c: Include new header file.
+	(Syntax): Report newly supported options.
+	(main): Recognize and handle new options.
+
+	* src/devices/xditview/gxditview.1.man (Synopsis): Document
+	them.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gxditview: Update usage message production and contents.
+
+	* src/devices/xditview/xditview.c: Use C99 Boolean type.
+	(Syntax): Accept additional Boolean argument indicating whether
+	the usage message is to be issued due to an error.  Write
+	message to stderr if so, and stdout otherwise.  Stop presuming
+	length of output line; guessing where to wrap is unreliable due
+	to variable terminal width and length of argv0.  Write one
+	line per invocation mode of the program.  Stop duplicatively
+	documenting standard X Toolkit options.  Exit with standard C
+	library `EXIT_FAILURE` status if there was an error, and
+	`EXIT_SUCCESS` otherwise.
+	(main): Refactor to prepare for `--version` support.
+
+	* src/devices/xditview/gxditview.1.man (Synopsis): Sync list of
+	options with usage message.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Recognize "--version" as
+	synonym for "-v".  To achieve this, use Getopt::Long instead of
+	Getopt::Std.
+	* src/utils/afmtodit/afmtodit.1.man (Synopsis, Options):
+	Document it.
 
-	* src/libs/libgroff/searchpath.cpp
-	(search_path::open_file_cautious): Ditto.
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libgroff/string.cpp: Include `stdlib.h'.
-	(string::extract): Use `malloc'.
+	* src/devices/gropdf/pdfmom.pl: Recognize "--version" as synonym
+	for "-v".
+	* src/devices/gropdf/pdfmom.1.man (Synopsis, Description):
+	Document it.
 
-	* src/preproc/eqn/box.cpp (quoted_text_box::~quoted_text_box): Use
-	`free'.
+2022-10-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/lex.cpp (definition::~definition,
-	macro_input::~macro_input, top_input::~top_input, do_definition):
-	Ditto.
+	* src/utils/grog/grog.pl (version): Identify as a GNU program.
 
-	* src/preproc/eqn/main.cpp (main): Ditto.
+2022-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/other.cpp: Include `stdlib.h'.
-	(size_box::~size_box, font_box::~font_box): Use `free'.
+	* src/devices/grolj4/grolj4.1.man (Typefaces): Add new
+	subsection.
 
-	* src/preproc/eqn/text.cpp: Include `stdlib.h'.
-	(box::set_spacing_type, special_char_box::~special_char_box,
-	split_text): Use `free'.
+	Fixes <https://savannah.gnu.org/bugs/?60929>.  Thanks to T. Kurt
+	Bond for the report.
 
-	* src/preproc/grn/main.cpp (conv): Use `free'.
+2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/html/pre-html.cpp (get_resolution): Ditto.
+	* doc/meref.me.in (Columnated Output): Document persistence of
+	`$s` register value across columnation mode changes.
 
-	* src/preproc/pic/lex.cpp (macro_input::~macro_input,
-	argument_macro_input::~argument_macro_input, for_input::~for_input):
-	Ditto.
+	Fixes <https://savannah.gnu.org/bugs/?62717>.  Thanks to Dave
+	Kemper for the report.
 
-	* src/preproc/pic/main.cpp (do_picture): Ditto.
+2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/pic/object.cpp: Include `stdlib.h'.
-	(text_piece::~text_piece, string_list::~string_list): Use `free'.
+	* doc/meref.me.in: Annotate empty default arguments more
+	consistently.
 
-	* src/preproc/pic/pic.ypp (placeless_element, element, text, label,
-	expr_not_lower_than): Ditto.
+	Fixes <https://savannah.gnu.org/bugs/?62801>.  Thanks to Dave
+	Kemper for the report.
 
-	* src/preproc/pic/troff.cpp (troff_output::reset_color): Ditto.
+2022-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/preconv/preconv.cpp (check_coding_tag): Ditto.
+	* doc/meref.me.in: Fix documentation error.
+	(Summary) <\_>: Describe as "underrule", not "underscore".
+	These are distinct: the latter is a glyph; the former is drawn
+	by typesetters and rendered with SGR attributes on terminals.
 
-	* src/preproc/soelim/soelim.cpp (do_file): Ditto.
+2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/tbl/table.cpp (text_entry::~text_entry): Ditto.
+	* NEWS: Advise users of changes to "name" directive handling in
+	font description files.
 
-	* src/roff/groff/groff.cpp (possible_command::~possible_command,
-	possible_command::set_name): Ditto.
+	Fixes <https://savannah.gnu.org/bugs/?61423>.  Thanks to Dave
+	Kemper for the report.
 
-	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file): Ditto.
+2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/node.cpp (suppress_node::tprint): Ditto.
+	* src/roff/troff/number.cpp: Refactor and fix code style nits.
+	Boolify and rename static (local) functions.
+	- parse_expr   -> is_valid_expression
+	- start_number -> is_valid_expression_start
+	- parse_term   -> is_valid_term
+	Rename preprocessor macro `SCALE_INDICATOR_CHARS` to
+	`SCALING_UNITS`.
+	(is_valid_expression, is_valid_term): Rename parameters and
+	demote them from `int` to `bool`.
+	- scaling_indicator -> scaling_unit (no demotion)
+	- parenthesised     -> is_parenthesized
+	- rigid             -> is_mandatory
+	(is_valid_expression_start, is_valid_expression, is_valid_term):
+	Return Boolean rather than integer literals.
+	(get_vunits, get_hunits, get_number_rigidly, get_number)
+	(get_integer): Update call sites of renamed functions.  Replace
+	Boolean-valued integer literals used as Booleans with Boolean
+	literals and annotate their purposes.  (See <https://\
+	stackoverflow.com/questions/38076786/\
+	why-doesnt-c-support-named-parameters>.)
+	(get_vunits, get_hunits, get_number, get_integer): Replace `0`
+	in assertions with a communicative predicate.  In all of these
+	it's an unhandled `switch()` case.
 
-2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use `malloc' in `strsave'; use `free' for returned pointers (#47164).
+	* src/roff/troff/input.cpp (do_expr_test, do_zero_width): Use
+	better terminology in diagnostic messages.
 
-	* src/libs/libgroff/font.cpp (text_file::~text_file): Use `free'.
+2022-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libgroff/searchpath.cpp (search_path::open_file): Use
-	`free'.
+	troff: Fix Savannah #63151.
 
-	* src/libs/libgroff/strsave.cpp: Include `stdlib.h'.
-	(strsave): Use `malloc'.
+	* src/roff/troff/input.cpp (read_draw_node): Throw "delim"
+	warning diagnostic when a drawing escape sequence ends the line
+	without a closing delimiter.
 
-2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+	Fixes <https://savannah.gnu.org/bugs/?63151>.
 
-	Simplify memory allocation (#47162).
+2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Many invalid memory accesses were caught by UBSAN (e.g., invalid
-	memory access in `small_temp_iterator::operator new') while
-	bootstrapping hardened1-linux-amd64 Debian port in the `free_list'
-	handling because it doesn't properly handle the padding between
-	array elements.
+	* tmac/fallbacks.tmac: Define fallbacks for characters in ISO
+	Latin-{2,5,9} but not in Latin-1.
 
-	Some places were already #if 0-d out anyway.
+	Fixes <https://bugs.debian.org/782903>.  Thanks to Rafal Pietrak
+	for the report.
 
-	* src/roff/troff/input.cpp (small_temp_iterator): Remove class.
-	(make_temp_iterator): Use `temp_iterator' only.
+2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grotty/tty.cpp (tty_glyph): Remove `free_list', `new',
-	and `delete'.
+	troff: Fix Savannah #63149.
 
-	* src/include/color.h, src/include/color.cpp (color): Ditto.
+	* src/roff/troff/reg.cpp (alter_format): Throw comprehensible
+	diagnostic when input delete character encountered in register
+	format.
 
-	* src/roff/troff/env.cpp (tab): Ditto.
+	Fixes <https://savannah.gnu.org/bugs/?63149>.
 
-	* src/roff/troff/node.cpp (glyph_node): Ditto.
+2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2016-02-15  Bálint Réczey  <balint@balintreczey.hu>
+	troff: Describe an input delete character comprehensibly.
 
-	pre-grohtml Fix out-of-bounds array access (#47161).
+	* src/roff/troff/input.cpp (token::description): The delete
+	character (ISO 127 decimal, EBCDIC 7) is a valid `TOKEN_CHAR`
+	but is not printable.  Don't attempt to output it literally in
+	diagnostics; describe it in a phrase instead.
 
-	* src/preproc/html/pre-html.cpp (char_buffer::write_upto_newline):
-	Implement it.
+2022-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2016-02-15  Bálint Réczey  <balint@balintreczey.hu>
+	troff: Apply consistent terminology.
 
-	Don't use `memcpy' with NULL input or output argument (#47160).
+	* src/roff/troff/input.cpp: Rename functions to better align
+	with our documentation, and decouple their names from an
+	assumption of diagnostic severity.  Also give them imperative
+	names since they are called for their side effects, not their
+	return values.
+	- empty_name_warning -> diagnose_missing_identifier
+	- non_empty_name_warning -> diagnose_invalid_identifier
+	(diagnose_missing_identifier): Refer to absent operand as
+	"identifier", not "name", in diagnostic messages since the
+	latter (strictly) refers to the request/macro/string/diversion
+	name space, and this function is also used to gather register
+	identifiers.
 
-	* src/libs/libgroff/string.cpp (string::string, string::operator=):
-	Implement it.
+2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Fix Savannah #63112 (3/3).
+
+	* tmac/latin2.tmac: Replace characters that ISO Latin-1 has but
+	Latin-2 doesn't.  Map characters that ISO Latin-2 has and
+	Latin-1 doesn't to their numeric code points.
+
+2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Regression-test Savannah #63112 (3/3).
+
+	* tmac/tests/latin2_works: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Fix Savannah #63112 (2/3).
+
+	* tmac/latin5.tmac: Replace characters that ISO Latin-1 has but
+	Latin-5 doesn't.  Map characters that ISO Latin-5 has and
+	Latin-1 doesn't to their numeric code points.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Regression-test Savannah #63112 (2/3).
+
+	* tmac/tests/latin5_works: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Fix Savannah #63112 (1/3).
+
+	* tmac/latin9.tmac: Replace characters that ISO Latin-1 has but
+	Latin-9 doesn't.  Map characters that ISO Latin-9 has and
+	Latin-1 doesn't to their numeric code points.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Regression-test Savannah #63112 (1/3).
+
+	* tmac/tests/latin9_works: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp: Refactor to parallelize logic in
+	similar routines; namely, those handling escape sequences that
+	accept newlines as argument delimiters.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp: Fix inconsistencies in handling of
+	escape sequences that accept newlines as delimiters.  Some threw
+	spurious warnings as in Savannah #63011; others failed to treat
+	a newline-terminated escape sequence also as the ending of an
+	input line.
+	(do_name_test, do_zero_width): Suppress spurious warning.
+	(do_zero_width, do_width, do_special): Synthesize newline to
+	terminate input line.
+
+2022-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/\
+	some_escapes_accept_newline_delimiters.sh: Add test cases for
+	`\A` and test formatted output of escape sequences, not just the
+	absence of diagnostics from permitted use of newlines as
+	argument delimiters.
+
+2022-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libdriver/input.cpp (do_file): Make use of
+	positioning commands before the first page is started fatal
+	errors; they suggest ill-formed input.  The 'p' command
+	clobbers the vertical position anyway.  (See
+	https://bugs.debian.org/421437 for discussion.)
+
+2022-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/pdf.tmac: Add inclusion guard; if a `pdfmark` macro is
+	already defined, skip inclusion of this file.  Unfortunately
+	there are multiple name collisions with pdfmark.tmac.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp:
+	* src/roff/troff/request.h: Trivially refactor.  Boolify
+	`interpolate_macro` and `request::invoke`.  Also rename
+	parameter `no_next` to `do_not_want_next_token`, exposing
+	potentially confusing interface design.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (spring_trap, interpolate_string)
+	(interpolate_string_with_args): Improve error diagnostics: when
+	a sprung trap or an interpolation fails because it's being
+	attempted on a request, say so explicitly and _name_ it.  If the
+	argument to the trap-planting request or to a string
+	interpolation escape sequence is itself an interpolation, this
+	name might not be obvious.  Consider:
+	  .wh \npos \*mac
+	  .em \*mac
+	  .itc 1 \*mac
+	  \*\*mac
+	Supplying this information requires no additional overhead.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (interpolate_string): Trivially
+	refactor.  Rename function parameter from `s` to `nm` to more
+	obviously align with `interpolate_string_with_args()`.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_zero_width, token::description)
+	(interpolate_string, interpolate_string_with_args)
+	(token::get_char): Revise diagnostic messages to stop presuming
+	the identity of the escape character.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (set_escape_char): Recast error
+	message to describe attempted operation and tell the user what
+	we're doing about being instructed to use an invalid escape
+	character.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Be more helpful to
+	ambiguous type size escape sequence users; offer advice in
+	terms of the current escape character.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.cpp (main): Fix SEGV when exiting
+	gxditview.  The `postdriver` pointer always referred to
+	allocated memory except when the `-X` option was given; it was
+	then assigned the address of a #defined string literal.  It was
+	thus statically allocated and an error to attempt to `free()`
+	it.  Duplicate the string on the heap instead so that we can
+	clean up uniformly regardless of postprocessor.  Problem caused
+	by me when introducing `xexit()` in commit 6769e56aab, 20 June.
+
+2022-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (@o, n2, sk (f, ++): Consistently call `@err`
+	macro with `do`.
+
+2022-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Initialize new register `_f`, the value of `$m`
+	{column count} of the previous pending footnote, to zero,
+	meaning there is no previous pending footnote.
+	(@o): Emit diagnostic when flushing footnotes into a different
+	column layout than the pending footnote last added.  Set `_f` to
+	zero.
+	((f): Emit diagnostic when enqueueing footnote using a different
+	column layout than the previous pending footnote used.  Set `_f`
+	to `$m`.
+
+	Fixes <https://savannah.gnu.org/bugs/?58736>.  Thanks to Dave
+	Kemper for the report and discussion.
+
+2022-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Explicitly initialize and annotate internal
+	register `?f`.
+
+2022-09-08  Nikita Ivanov <nikita.vyach.ivanov@gmail.com>
+
+	* tmac/ps.tmac: Fallback definitions for glyphs that usually
+	come from special fonts should use `schar` instead of `fchar`.
+	{Define fallback special characters using `schar` instead of
+	`fchar` for glyphs that we do not expect to find in text fonts;
+	that is, they don't have bold, italic, and bold-italic stylistic
+	variants.  This means all special character definitions in the
+	file except for rules, ligatures, and digraphs.  Problem dates
+	back to a series of commits from March 2002 to February 2003,
+	straddling the introduction of the `schar` request in November
+	2002. --GBR}
+
+	Fixes <https://savannah.gnu.org/bugs/?62955>.
+
+2022-09-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Slightly simplify new `XN` macro feature to align it more
+	closely with Berkeley TOC macro behavior; don't prepend the
+	table of contents entry with the section number (`\*SN`).  If
+	desired, a document can define `XN-REPLACEMENT`.  This does not
+	regress "pdfmark.ms" because it uses an alternative, older
+	implementation of these features from "spdf.tmac".
+
+	* tmac/s.tmac (XH-UPDATE-TOC): Update comments.
+	(XN-REPLACEMENT): Do it.
+
+2022-09-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/pdf.tmac (pdf*href-I): Call `pdf:error` macro by its
+	correct name.  Both this macro file and
+	contrib/pdfmark/pdfmark.tmac seem to want to use the 'pdf'
+	prefix for their macro names, with much confusing overlap.
+	Problem dates back to commit 87046b2948, 2011-07-26.
+
+2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): If Ghostscript or awk are
+	unavailable, skip only the prepopulation of the URW font search
+	path instead of the entire check.  This way we still locate the
+	URW fonts if they are in one of several standard locations.
+
+	Fixes <https://savannah.gnu.org/bugs/?62775>.
+
+2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Trivially refactor.
+
+	* src/roff/troff/input.cpp (do_name_test): Boolify and rename
+	local variables to..."impredicate" their names.
+	  - bad_char -> got_bad_char
+	  - some_char -> got_some_char
+
+2022-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grodvi, ...: Trivially refactor.
+
+	Tidy up #includes of the "assert.h" header, which we locally
+	provide to ensure a C99-conformant implementation.  Drop
+	inclusion of header from files that don't directly need it, add
+	it where they do, and spell the inclusion consistently with
+	double quotes to cue the reader of its local status.
+
+	* src/devices/grodvi/dvi.cpp:
+	* src/devices/grolj4/lj4.cpp:
+	* src/libs/libdriver/printer.cpp:
+	* src/preproc/eqn/box.cpp:
+	* src/preproc/eqn/delim.cpp:
+	* src/preproc/eqn/pile.cpp:
+	* src/preproc/eqn/script.cpp: Add inclusion.
+
+	* src/include/driver.h:
+	* src/libs/libgroff/fontfile.cpp:
+	* src/preproc/eqn/eqn.h:
+	* src/preproc/html/pushback.cpp:
+	* src/preproc/refer/refer.h:
+	* src/preproc/tbl/table.h:
+	* src/utils/addftinfo/addftinfo.cpp: Drop inclusion.
+
+	* src/include/itable.h:
+	* src/include/stringclass.h:
+	* src/libs/libbib/linear.cpp:
+	* src/libs/libbib/search.cpp:
+	* src/libs/libgroff/color.cpp:
+	* src/libs/libgroff/font.cpp:
+	* src/libs/libgroff/nametoindex.cpp:
+	* src/libs/libgroff/prime.cpp:
+	* src/libs/libgroff/searchpath.cpp:
+	* src/preproc/html/pre-html.cpp:
+	* src/preproc/preconv/preconv.cpp:
+	* src/preproc/soelim/soelim.cpp:
+	* src/utils/indxbib/indxbib.cpp:
+	* src/utils/lkbib/lkbib.cpp:
+	* src/utils/lookbib/lookbib.cpp: Respell inclusion.
+
+	Fixes <https://savannah.gnu.org/bugs/?63079>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff, ...: Trivially refactor.
 
-	* src/roff/troff/input.cpp (temp_iterator::temp_iterator): Implement
+	Boolify and rename internal library function from
+	`invalid_input_char` to `is_invalid_input_char`.
+
+	* src/include/lib.h: Do it.
+
+	* src/libs/libgroff/font.cpp (text_file::next_line):
+	* src/preproc/eqn/lex.cpp (file_input::read_line):
+	* src/preproc/eqn/main.cpp (read_line, main):
+	* src/preproc/pic/lex.cpp (file_input::read_line,
+	simple_file_input::get, simple_file_input::peek):
+	* src/preproc/pic/main.cpp (top_input::get, top_input::peek)
+	(do_file):
+	* src/preproc/refer/command.cpp (input_stack::push_file):
+	* src/preproc/refer/refer.cpp (do_file, do_bib):
+	* src/roff/troff/env.cpp (environment::make_tag):
+	* src/roff/troff/input.cpp (file_iterator::fill)
+	(file_iterator::peek, get_char_for_escape_parameter)
+	(transparent_translate, read_request, asciify)
+	(input_char_description, read_string, transparent_file,
+	set_string): Update call sites.
+
+2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Tweak diagnostic messages.
+
+	* src/roff/troff/input.cpp (token::description)
+	(input_char_description): Consistently use articles in
+	descriptive noun phrases.
+
+2022-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Tweak diagnostic messages.
+
+	* src/roff/troff/input.cpp (non_empty_name_warning): Say
+	"identifier", not "name", in diagnostic message; it can be
+	thrown for attempted assignments to invalid register
+	identifiers, and some of our documentation refers to identifiers
+	in the name space shared by requests, macros, strings, and
+	diversions as "names".
+
+	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file):
+	* src/roff/troff/input.cpp (get_char_for_escape_parameter)
+	(token::usable_as_delimiter, non_empty_name_warning)
+	(pipe_source, psbb_locator::psbb_locator, open_request)
+	(opena_request, define_class, pipe_output, system_request):
+	Consistently say "_is_ not allowed".  The zero copula poses too
+	great a risk of incomprehension IMO.
+
+2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Add internal string `doc-Lk-font` to manage the typeface
+	in which to render URIs.
+
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Add it.  Use roman instead of (Courier)
+	bold.  This is more consistent with man(7)'s `UR` and less with
+	mandoc(1).
+
+	* tmac/doc.tmac (Lk): Use it instead of `doc-Sy-font`.
+
+2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Fix Savannah #59738.
+
+	* tmac/doc.tmac (Lk): Process further macro arguments more like
+	other macros do, calling `doc-print-recursive`.  This permits
+	recognition of end-of-sentence punctuation in the argument list.
+
+	Fixes <https://savannah.gnu.org/bugs/?59738>.
+
+2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Regression-test Savannah #59738.
+
+	* tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh: Do
 	it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2016-02-04  Carsten Kunze  <carsten.kunze@arcor.de>
+2022-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/s.tmac: Bugfix of previous commit simplified (and
-	introduced redundancy removed) by use of .par*start for .QS and
-	.QE.  This is consistent since any other paragraph macro is
-	using .par*start.
+	mdoc: Fix code style nit.  Rename `doc-arg-limit` to
+	`doc-arg-count`.  This register doesn't track any sort of limit
+	on the number of arguments you can give to an mdoc(7) macro, or
+	anything like that.  It is simply a count of the number of
+	arguments visible to the currently operating macro.
 
-2016-02-02  Carsten Kunze  <carsten.kunze@arcor.de>
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff:
+	* tmac/mdoc/doc-syms: Do it.
 
-	* tmac/s.tmac: Macros .QS and .QE changed to insert vertical
-	inter-paragraph space.  A paragraph bracketed with .QS/.QE
-	should appear identical to a .QP paragraph followed by .LP.
+2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/groff_ms.7.man, doc/groff.texi: Documentation of macros
-	.QS and .QE added and .QP information improved (effect of
-	registers QI and PD).
+	docs: Fix errors in documentation regarding which escape
+	sequences accept newlines as argument delimiters, and other
+	inaccuracies.
 
-	See also discussion at groff@gnu.org, thread starting at
+	* doc/groff.texi (Escape Sequences): Cover general cases before
+	exceptional ones.  Leaders can be used as argument delimiters.
+	Call out letters and numerals as (usually) usable as well.
+	Correct an almost completely inaccurate list of escape sequences
+	that accept a newline as an argument delimiter: \A, \b, \o, \w,
+	\X, and \Z do; \B does not.  Correct example of use of newline
+	as delimiter with \o escape sequence.  Stop referring to the
+	decimal point as an "operator".  Drop "newline" from a list of
+	prohibited delimiters by several escape sequences since it has
+	already been discussed.
 
-	http://lists.gnu.org/archive/html/groff/2016-01/msg00033.html
+	* man/groff.7.man (Escape sequences): Replace weaksauce cross
+	reference to our Texinfo manual with a proper discussion of
+	acceptable delimiters in escape sequences, synced with the
+	foregoing change.  Stop using quotation marks around escape
+	sequences, except for "\ " which obviously needs it.
 
-	Issue reported by Douglas McIlroy <doug@cs.dartmouth.edu>
+	Fixes <https://savannah.gnu.org/bugs/?63002>.  Thanks to Dave
+	Kemper for the report.
 
-2015-12-26  Carsten Kunze  <carsten.kunze@arcor.de>
+2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/mm/m.tmac: Disable macro misc@tag in case output
-	  type is not HTML.
+	troff: Don't throw a spurious warning when using newline as
+	delimiter with the few escape sequences that permit this.
 
-	This macro did cause unwanted space in case a MM macros .H
-	had been followed immediately by .DS.
+	* src/roff/troff/input.cpp (do_overstrike, do_bracket, do_width)
+	(do_special): Do it.
 
-	(See also discussion at groff@gnu.org, thread starting at
-	http://lists.gnu.org/archive/html/groff/2015-12/msg00033.html)
+	Fixes <https://savannah.gnu.org/bugs/?63011>.  Thanks to Bjarni
+	Ingi Gislason for the report and Dave Kemper for the discussion.
 
-	Bug reported by Damian McGuckin <damianm@esi.com.au>.
+2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-12-14  Werner LEMBERG  <wl@gnu.org>
+	troff: Add regression test for Savannah #63011.
 
-	* src/preproc/eqn/text.cpp (entity_table): s/lamda/lambda/.
+	* src/roff/groff/tests/\
+	some_escapes_accept_newline_delimiters.sh: Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run it.
 
-	Bug reported by Brian McGuinness <mcguinne@fdu.edu>.
+2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-10-27  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* src/roff/troff/input.cpp (do_special): Fix code style nit;
+	align function definition with declaration (internal linkage).
 
-	gropdf was choking on -I flag passed by groff, now uses
-	these directories to search for included pdfs.
-	
-	* src/devices/gropdf/gropdf.pl: Handle -I flag, avoid
-	  unitialised values.
-	
-	* src/roff/groff/groff.1.man: Include 'X pdf: pdfpic'
-	
-	* src/devices/gropdf/gropdf.1.man: Document -I flag
-	
-2015-09-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: fix comments
+	* src/devices/grops/ps.cpp (ps_printer::special)
+	(resource_manager::process_file): Fix code style nit.  Mark
+	static structs initialized within functions and never modified
+	thereafter as `const`.  This attempts to work around an apparent
+	false positive from AddressSanitizer.  If it doesn't pacify
+	ASAN, please explain to me how constant structure members
+	initialized to string literals and pointers to functions within
+	the translation unit can ever be null.  If that is infeasible,
+	please report a bug to your compiler vendor.
 
-2015-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes (addresses, at any rate) https://savannah.gnu.org/bugs/\
+	?61643>.  Thanks to Bjarni Ingi Gislason for the report.
 
-	* tmac/troffrc: Add .mso for file `pdfpic.tmac'.
+2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-08-28  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	mdoc: Refactor: relocate most rendering option handling to
+	"doc.tmac" from "doc-ditroff" and "doc-nroff", cutting down on a
+	lot of duplication.  The `S` register retains separate handling.
 
-	* Makefile.am:
-	- Use only the naming `.section.man' for all man.pages.
-	- Replace `.man.n' by `.man' only, such that no `.n' is
-	generated.
-	- For example, the source `groff.7.man' is transformed into
-	`groff.7' in the same directory and then is by installing just
-	copied into one of the suitable installed man directory.
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Do it.
 
-2015-08-27  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/pfdpic.tmac: Add tmac file for macro `PDFPIC'.
+	* tmac/mdoc/doc-ditroff (doc-setup-page-layout):  In troff mode,
+	if the user does not define the `LL` register, use the device's
+	default line length, not 6.5 inches.  If the user does not
+	define the `LT` register, make the default line length for
+	titles the same as the regular line length, not 6.5 inches
+	independently of it.  This is consistent with man(7)'s handling
+	of `LL` and `LT`.
 
-	* tmac/tmac.am: Add new `pdfpic.tmac' file.
+2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_tmac.5.man: Add definition for the new tmac.
+	mdoc: Support `AD` string to set default adjustment mode.
 
-2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/mdoc/doc-common (Sh): Set adjustment mode to
+	user-specified default, not troff's default (and not only in
+	troff mode).
 
-	* all man-pages *.man: Rename man-pages such that the man section
-	number before the final `.man'.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Process `AD` string setting from command
+	line as man(7) does.
 
-	* all *.am: Include renaming.
+	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+	nroff): Document it.
 
-	* Makefile.am: Reset `.man.n' by `.157.man.n' with SUFFIXES
-	`.157.man .n'.
+	* NEWS: Add and update items.
 
-2015-08-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes part of <https://savannah.gnu.org/bugs/?63046>.
 
-	* Makefile.am: Fix definition of man157_MANS.
+2022-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-08-13  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/doc.tmac (doc-tag-list): Fix code style nit: don't give
+	`ad` request a numeric argument.  Say `l` instead of `0`.
 
-	* all *.am: Correct Emacs mode `End:' instead of `End.'.
+2022-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-08-09  Werner LEMBERG  <wl@gnu.org>
+	mdoc: Align inter-paragraph spacing with man(7).
 
-	Revert previous commit, since it doesn't work correctly yet.
+	* tmac/mdoc/doc-common: Use `doc-paragraph-space` when spacing
+	prior to section and subsection headings instead of spacing by
+	the 1v default.
+	* tmac/mdoc/doc-ditroff: Align inter-paragraph distance amount
+	in troff mode with man(7), reducing to 0.4v from 0.5v.
 
-2015-08-07  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-09-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Add section name to all man-page names.
+	* tmac/mdoc/doc-nroff: Map monospaced fonts (CR, CB, CI, CBI) to
+	standard styles as man(7) has done for 15 years.  This silences
+	warnings from the formatter when a man page attempts to use
+	fonts from the Courier family in tbl(1) tables, which is about
+	the only place a reasonable man page attempts such a thing.
 
-	* Makefile.am: In `install-prefix-man' and `uninstall-prefix-man'
-	change `sed' commands.  Correct saving in man157_MANS.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* all *.man in source tree: Rename `manpage.man' to
-	`manpage.157.man'.
+	mdoc: Stop prefixing center header with name of operating
+	system.  This was hard-coded to "BSD" and stuck on all mdoc(7)
+	pages using a default manual section number, regardless of host
+	operating system.  Bad idea.  Further, the argument to the `Os`
+	call, if any, or a default, is always disclosed in the left
+	footer.
 
-	* all makefile.am in source tree: Add new man-page file name.
+	* tmac/mdoc/doc-common: Do it.
+	(Dt): Initialize `doc-volume` as empty and annotate it;
+	calling the macro with a numeric second argument overrides the
+	fallback default of "LOCAL".  A slash is no longer needed to
+	separate a recognized architecture string from the OS name, so
+	drop it.
 
-2015-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/tests/doc_smoke-test.sh: Update test expectations.
 
-	* Makefile.am, arch/mingw/mingw.am, arch/misc/misc.am,
-	* contrib/eqn2graph/eqn2graph.am, contrib/grap2graph/grap2graph,
-	* contrib/pic2graph/pic2graph.am, doc/doc.am,
-	* font/devX100/devX100.am, font/devX100-12/devX100-12.am,
-	* font/devX75/devX75.am, font/devX75-12/devX75-12.am,
-	* font/devascii/devascii.am, font/devcp1047/devcp1047.am,
-	* font/devdvi/devdvi.am, font/devhtml/devhtml.am,
-	* font/devlatin1/devlatin1.am, font/devlbp/devlbp.am,
-	* font/devlj4/devlj4.am, font/devpdf/devpdf.am,
-	* font/devps/devps.am, font/devutf8/devutf8.am,
-	* font/scripts/scripts.am, man/man.am,
-	* src/devices/grodvi/grodvi.am, src/devices/grohtml/grohtml.am,
-	* src/devices/grolbp/grolbp.am, src/devices/grolj4/grolj4.am,
-	* src/devices/gropdf/gropdf.am, src/devices/grops/grops.am,
-	* src/devices/grotty/grotty.am,
-	* src/include/include.am, src/libs/libbib/libbib.am,
-	* src/libs/libdriver/libdriver.am, src/libs/libgroff/libgroff.am,
-	* src/libs/libxutil/libxutil.am, src/preproc/grn/grn.am,
-	* src/preproc/html/html.am, src/preproc/pic/pic.am,
-	* src/preproc/preconv/preconv.am, src/preproc/tbl/tbl.am
-	* src/preproc/refer/refer.am, src/preproc/soelim/soelim.am,
-	* src/roff/groff/groff.am, src/roff/grog/grog.am,
-	* src/roff/nroff/nroff.am, src/roff/troff/troff.am,
-	* src/utils/addftinfo/addftinfo.am,
-	* src/utils/afmtodit/afmtodit.am, src/utils/hpftodit/hpftodit.am,
-	* src/utils/indxbib/indxbib.am, src/utils/lkbib/lkbib.am,
-	* src/utils/lookbib/lookbib.am, src/utils/pfbtops/pfbtops.am,
-	* src/utils/tfmtodit/tfmtodit.am, src/utils/xtotroff/xtotroff.am,
-	* tmac/tmac.am:
-	Add `Last update'.  Setup Emacs mode.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-07-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+	mdoc: Drop dead code.  The register
+	`doc-volume-operating-system-ateol`, introduced in groff 1.18
+	{July 2002}, was being tested but never set to a nonzero value.
+	In fact, it seems never to have been.
 
-	* src/roff/grog/subs.pl: Add -T for all `grog' output, also using
-	-Tps when no option -T is given in the arguments.
+	* tmac/mdoc/doc-common: Get rid of it...
+	(Dt): ...and the dependent block.
 
-	* src/roff/grog/grog.man: Add information about -T output.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-07-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+	mdoc: Make `Ux` render "Unix" in mixed case.
 
-	* man/groff.man: Add last update.  Add link on Wikipedia on groff.
-	Add link of groff tutorial by Laha.
+	* tmac/mdoc/doc-syms (Ux): Do it.  Also remove local string
+	after we're done with it.
 
-2015-07-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Continues work begun prior to groff 1.22.4 release.
 
-	* src/roff/grog/*.pl: Add last update.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Remove call to Perl INC::System::Simple,
-	use backticks instead.
-	Define &err().
-	Reorder some extensions.
-	Distinguish between .TH at first command for man and later on for
-	ms.
+	mdoc: Align spacing around headers with man(7).
 
-2015-07-01 Peter Bray <pdb_ml@yahoo.com.au>
+	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+	* tmac/mdoc/doc-common (Rd):
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
+	`doc-header-space`.
 
-	Fix Savannah bug #44784.
+	* tmac/mdoc/doc-common (doc-header): When starting new document
+	and not continuously rendering, space by one half-inch instead
+	of by the now-defunct `doc-header-space` amount (which,
+	strictly, should not have applied to this measurement).  If
+	continuously rendering, extend page length by 1v to accommodate
+	header line.  After formatting header, if not continuously
+	rendering, space to 1 inch below first text baseline.
 
-	Compatibility Mode rendering of groff manual pages
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4 (GROFF_WITH_COMPATIBILITY_WRAPPERS): New macro to
-	implement 'configure' option
-	'--with-compatibility-wrappers=<value>'.  With this option the
-	user can control how groff compatibility wrappers for
-	vendor-provided non-GNU macro sets are installed.
+	mdoc: Support `C` register for consecutive page numbering.
 
-	* configure.ac: Use new macro GROFF_WITH_COMPATIBILITY_WRAPPERS.
+	* tmac/mdoc/doc-common (Dd): Reset page number to 1 upon new
+	document only if not consecutively numbering.
 
-	* Makefile.am: Define tmac_*_prefix if 'compatibility_wrappers' is
-	set to 'yes'.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Process `C` register setting from command
+	line as man(7) does.
 
-	* tmac/tmac.am: Use 'compatibility_wrappers' to control the
-	installation:
+	* tmac/groff_mdoc.7.man (Formatting with groff, troff, and
+	nroff): Document it.
 
-	- If set to `no', the groff-provided macro set are installed in
-	<prefix>/share/groff/<version>/tmac/ with the original macro set
-	name.
+	Fixes part of <https://savannah.gnu.org/bugs/?63046>.
 
-	- If set to `yes', the groff-provided macro set are installed in
-	<prefix>/share/groff/<version>/tmac/ with a prefix of
-	$(tmac_prefix) (which is usually `g') and the generated
-	compatibility wrappers are installed in
-	<prefix>/lib/groff/site-tmac, with the original macro set name.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	- If set to `manual', the groff-provided macro set are installed
-	in <prefix>/share/groff/<version>/tmac/ with the original macro
-	set name and the generated compatibility wrappers are installed in
-	<prefix>/lib/groff/site-tmac, with a name of
-	<macro><wrapper_suffix> (which is usually `-os').
+	mdoc: Align trap management more closely with man(7).
 
-2015-06-17  Werner LEMBERG  <wl@gnu.org>
+	* tmac/mdoc/doc-common: Call new macro (see below)
+	`doc-set-up-continuous-rendering` when initializing, if that
+	mode is configured.
+	(doc-ne): New macro replaces `ne` request
+	in continuous rendering mode.  It extends the page length by the
+	amount in the argument or by 1v if none given.
+	(doc-bp): New macro replaces `bp` request in continuous
+	rendering mode, setting the page length to the vertical drawing
+	position.
+	(doc-set-up-continuous-rendering): New macro renames requests to
+	emplace the foregoing.
+	(Dd): Interpret this macro call strictly as starting a new
+	mdoc(7) document.  (andoc.tmac already makes this assumption,
+	and has for over 20 years.  groff_mdoc(7) and mandoc_mdoc(7)
+	also prescribe the sequence `Dd`, `Dt`, `Os`.)  We require this
+	invariant even more rigidly now because it's the only way we can
+	be sure that we can process multiple documents while rendering
+	headers and footers with information corresponding to the
+	appropriate document.  (man(7)'s `TH` has an advantage here in
+	that calling it is "atomic": from its arguments alone you can
+	obtain everything you need to know to format the header and
+	footer.  In mdoc(7), permuting the initialization macro order
+	reliably produces chaos.)  Break the page (if necessary)
+	_before_ processing any arguments (instead of after), to flush
+	the previous page's footer.  Stop calling `doc-set-up-titles`
+	here; we don't have enough information to do that yet.  Also
+	stop writing the PDF bookmark here, because `doc-document-title`
+	and `doc-section` will not reflect the new page content yet.
+	(Os): Once the `doc-operating-system` string content has been
+	determined, call `doc-set-up-titles`, write the PDF bookmark for
+	the page, and call `doc-header`, causing the page header to be
+	formatted.  These changes further imply a stronger requirement
+	on initialization macro ordering being canonical.
 
-	* tmac/tty.tmac: Fix mapping of \bu character for -Tutf8.
+	Fixes <https://savannah.gnu.org/bugs/?62774> (7/7).
 
-	Problem reported by carsten.kunze@arcor.de.
+2022-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-06-15  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	mdoc: Trivially refactor.  Relocate string and macro
+	definition within file.  mdoc(7) mandates that the document
+	setup macros `Dd`, `Dt`, and `Os` be called in that order;
+	arrange their definitions accordingly, for maintainability.
 
-	pdfmom should use $RT_SEP as path separator.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.am: Use @RT_SEP@ as path separator.
+	mdoc: Refactor.  Rename strings and macro for clarity.  These
+	things don't only affect headers.
+	- doc-header-string ->       doc-pageref
+	- doc-header-string-saved -> doc-pageref-saved
+	- doc-setup-header ->        doc-set-up-titles
 
-	* src/devices/gropdf/pdfmom.pl: As above but also fix typo in regex
-	for grep.
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common: Do it.
 
-2015-05-08  Eli Zaretskii  <eliz@gnu.org>
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	groff Make relocation really work.
+	mdoc: Refactor.  There is no difference in
+	`doc-header-string` and `doc-setup-header` between the files
+	"doc-ditroff" and "doc-nroff", so define them only once, in
+	"doc-common".
 
-	See
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Do it.
 
-	  https://lists.gnu.org/archive/html/groff/2015-05/msg00000.html
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.cpp: Include `relocate.h'.
-	(main): Use `relocatep'.
+	mdoc: Align footer management more closely with man(7).
 
-2015-05-03  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	* tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+	* tmac/mdoc/doc-common (Rd):
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Stop defining, saving, and restoring
+	`doc-footer-space`.
 
-	Fix Savannah bug #44768 (Solaris 10 compatibility issues).
+	* tmac/mdoc/doc-common (doc-break-body-text): New macro, called
+	only when not continuously rendering, schedules a page break.
+	(doc-footer): Stop vertically spacing by `doc-footer-space`,
+	instead relying upon a trap to move us here.
 
-	* m4/groff.m4 (GROFF_DIFF_D): new macro to check if `diff' has
-	option -D, and search for `gdiff' if not (new variable DIFF_PROG
-	will contain the `diff' program to be used).
+	* tmac/mdoc/doc-ditroff (doc-setup-header):
+	* tmac/mdoc/doc-nroff (doc-setup-header): Set traps at the end
+	of the page where man(7) does by default; break the body text at
+	1 inch from the page bottom, and write the footer at ½ inch.
 
-	* m4/groff.m4 (GROFF_HAVE_TEST_EF_OPTION): new macro to check if
-	`test' supports the option -ef (created new variable
-	HAVE_TEST_EF_OPTION).
+	* tmac/mdoc/doc-nroff (doc-setup-header): Add 1/6 em "thin
+	space" between man page name and parenthesized section, for
+	precise parity with doc-ditroff implementation.  (`\|` does not
+	take up any character cells on nroff devices.)
 
-	* m4/groff.m4 (GROFF_BASH): new macro to search for `bash' (new
-	variable BASH_PROG will contain the full path to `bash' or
-	`/bin/sh' if `bash' was not found).
+	Fixes <https://savannah.gnu.org/bugs/?62774> (6/7).
 
-	* configure.ac: use the 3 new macros defined in m4/groff.m4.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/gdiffmk/gdiffmk.am: set HAVE_TEST_EF_OPTION, BASH_PROG,
-	DIFF_PROG in the generated script `gdiffmk'.
+	* tmac/mdoc/doc-common (Dt, Dd): Emit diagnostic warnings if
+	macros called with no arguments.
 
-	* contrib/gdiffmk/gdiffmk.sh:
-	- Fix incorrect space after '!' in sed script regex.
-	- `test -ef' is not portable: If `bash' is not available and the
-	shell does not support `test -ef', the option to pass a third
-	argument as the output file is disabled.
-	- Report an error if `diff' does not support -D option.
-	- GNU diff and Solaris diff support -D, but #ifndef / #endif are
-	treated differently (GNU adds a '!' in the #endif): modify the
-	regexs in the sed script accordingly.
+	Fixes <https://savannah.gnu.org/bugs/?62774> (5/7).
 
-2015-05-01  Werner LEMBERG  <wl@gnu.org>
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/tmac.am (TMACNORMALFILES): Add `zh.tmac'.
+	mdoc: Fix code style nit: stop using Control+G as an escape
+	sequence argument delimiter.  This is not necessary in groff and
+	hasn't been for at least thirty years.  See the node/section
+	"Implementation Differences" of our Texinfo manual.  Our mdoc
+	implementation does not operate in compatibility mode, so using
+	control characters like this obfuscates input to no advantage.
 
-2015-04-30  Darcy SHEN  <sadhen1992@gmail.com>
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff:
+	* tmac/mdoc/doc-syms: Do it.
 
-	Fix Savannah bug #44941.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/zh.tmac: New file to support basic Chinese (both simplified
-	and traditional).
+	* tmac/mdoc/doc-common (doc-footer): Pull more footer concerns
+	into this macro.  Don't bail out if continuously rendering;
+	instead, format the appropriate footer text if we are.  For now,
+	break the page only if we are not continuously rendering.
+	(doc-end-macro): Call `doc-footer` instead of formatting footer
+	here.
 
-2015-04-22  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	Fixes <https://savannah.gnu.org/bugs/?62774> (4/7).
 
-	Fix Savannah bug #44891.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: If module Compress::Zlib is not
-	available fall back to producing uncompressed PDF and output a
-	warning.
+	* tmac/mdoc/doc-common (doc-end-macro): When continuously
+	rendering, set the page reference (e.g., "ls(1)") in the right
+	footer instead of repeating the left footer.  Thanks to Ingo
+	Schwarze for the discussion.
 
-2015-04-22  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* tmac/tests/doc_smoke-test.sh: Update expectations of footer
+	regression test.
 
-	Fix Savannah bug #44894.
+	Fixes part of <https://savannah.gnu.org/bugs/?62926>.
 
-	* tmac/strip.sed: Add a `generated file' warning.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-04-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/mdoc/doc-common (doc-end-macro): Reset strings to reduce
+	info leaks from one man page to the next.
 
-	Fix Savannah bug #44890.
-	Patch by Peter Bray.
+	Fixes <https://savannah.gnu.org/bugs/?62774> (3/7).
 
-	* font/devpdf/devpdf.am: Don't use 'find -maxdepth'.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-03-07  Ingo Schwarze  <schwarze@openbsd.org>
+	* tmac/mdoc/doc-common (Dt): Stop reinitializing `doc-volume`
+	and `doc-section`.  This is the job of package initialization
+	{and, soon, the end-of-input macro}.
 
-	mdoc Fix Savannah bug #44733.
+	Fixes <https://savannah.gnu.org/bugs/?62774> (2/7).
 
-	Prevent mdoc(7) Bl with trailing -width or -offset from picking up
-	old args.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc.tmac-u (doc-do-Bl-args): When checking whether there is
-	another argument to a Bl macro, do not inspect the argument list
-	because it is never cleaned and may contain arguments from previous
-	macro invocations.  Instead, inspect the argument count which is
-	always up to date.
+	* tmac/mdoc/doc-common: Populate default date string
+	`doc-date-string` with "UNDATED".
+	(Dd, Dt, Os): Make more orthogonal: stop touching
+	`doc-topic-name`.  It is "doc.tmac"'s job to initialize it and
+	the `Nm` macro's job to update it.
+	(Dd): Do nothing if given no arguments.  (You can still blank
+	out the document date with an explicitly empty argument:
+	  .Dd ""
+	.)
 
-2015-04-10  Daiki Ueno  <ueno@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?62774> (1/7).
 
-	Fix link error on NetBSD 6.
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Reported by carsten.kunze@arcor.de in:
-	<https://lists.gnu.org/archive/html/groff/2015-04/msg00000.html>.
-	The problem can also be reproduced if gl_cv_func_wcwidth_works=no
-	is passed to configure.
+	* tmac/mdoc/doc-common: Change `doc-default-operating-system`
+	string from "BSD" to "GNU", per discussion with Ingo Schwarze.
+	See <https://lists.gnu.org/archive/html/groff/2022-07/\
+	msg00280.html>.
 
-	* src/preproc/grn/grn.am (grn_LDADD): Change the link order of
-	libgroff.a and lib/libgnu.a according to dependency.
-	* src/roff/troff/troff.am (troff_LDADD): Likewise.
+	* tmac/tests/doc_smoke-test.sh: Update expectations of footer
+	regression test.
 
-2015-04-08  Werner LEMBERG  <wl@gnu.org>
+2022-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix Savannah bug #44767.
-	Patch by Peter Bray.
+	* tmac/mdoc/doc-common (Dt): Delete lingering and useless
+	definition of `doc-command-name` string.  Thanks to Steffen
+	Nurpmeso for the report.  See commit e9e92ee008, 27 August.
 
-	* src/roff/grog/grog.am (grog): Correctly substitute `grog_dir'.
+2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-04-03  Werner LEMBERG  <wl@gnu.org>
+	* src/preproc/pic/pic.ypp (not_lower_than): Emit deprecation
+	warning for use of 'rand()' with a (non-empty) argument.  The
+	man page has declared it thus for over 30 years, at least since
+	groff 1.02 (June 1991).
 
-	Fix Savannah bug #44708 (2/2).
+2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Make man pages work in compatibility mode.
-	Also fix some minor typos.
+	* src/preproc/pic/pic.ypp (object_spec): Emit deprecation
+	diagnostic for "plot" command.  The man page has declared it
+	thus for over 30 years, at least since groff 1.02 (June 1991).
 
-	* contrib/pic2graph/pic2graph.man, man/ditroff.man, man/groff.man,
-	man/groff_diff.man, man/groff_out.man, man/groff_tmac.man,
-	man/roff.man, src/devices/grodvi/grodvi.man,
-	src/devices/grohtml/grohtml.man, src/devices/grolbp/grolbp.man,
-	src/devices/grolj4/grolj4.man, src/devices/grolj4/lj4_font.man,
-	src/devices/gropdf/gropdf.man, src/devices/gropdf/pdfmom.man,
-	src/devices/grops/grops.man, src/devices/grotty/grotty.man,
-	src/devices/xditview/xditview.man, src/preproc/eqn/eqn.man,
-	src/preproc/eqn/neqn.man, src/preproc/grn/grn.man,
-	src/preproc/pic/pic.man, src/preproc/preconv/preconv.man,
-	src/preproc/refer/refer.man, src/preproc/soelim/soelim.man,
-	src/preproc/tbl/tbl.man, src/roff/groff/groff.man,
-	src/roff/grog/grog.man, src/roff/nroff/nroff.man,
-	src/roff/troff/troff.man, src/utils/addftinto/addftinfo.man,
-	src/utils/afmtodit/afmtodit.man, src/utils/hpftodit/hpftodit.man,
-	src/utils/indxbib/indxbib.man, src/utils/lkbib/lkbib.man,
-	src/utils/lookbib/lookbib.man, src/utils/pfbtops/pfbtops.man,
-	src/utils/tfmtodit/tfmtodit.man, src/utils/xtotroff/xtotroff.man,
-	tmac/groff_man.man, tmac/groff_trace.man: Do it.
+2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-04-03  Werner LEMBERG  <wl@gnu.org>
+	* src/preproc/pic/pic.ypp (placeless_element): Explicitly say
+	that an unsafe command is being ignored in diagnostic.
 
-	Fix Savannah bug #44708 (1/2).
+2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/andoc.tmac (reload_doc, reload_man): Don't use `de1',
-	otherwise we can't manipulate the compatibility flag within the
-	macro.
+	* src/preproc/eqn/main.cpp (main): Drop man page reference from
+	deprecation diagnostics.  The man page might be installed with a
+	prefix determined at configuration time, and that's too much
+	trouble to mess with for construction of a message.  Trust the
+	user of these ancient options to try reading the man page with
+	the same name as the command.
 
-	* tmac/doc-common-u (Dt): Remove invalid leading whitespace.
+2022-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-03-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	docs: Revise discussion of measurements.
 
-	* src/devices/gropdf/gropdf.pl: Was not handling the final glyph
-	correctly in the "standard" fonts which are not embedded. They
-	actually have 257 glyphs (0-256) not 256 as I'd assumed, so the
-	remappiing code needs to be applied for them as well as the
-	embedded downloadable fonts.
+	* doc/groff.texi: Drop Texinfo @codequote* command brackets
+	around revised sections; relevant nodes have been reviewed for
+	correct glyph usage.  Move concept index entries for obsolescent
+	term "machine units" to same location as "basic units".
+	Bump document date.
+	(Measurements): Rewrite presentation.  We have already
+	introduced page geometry concepts, including the concept of
+	basic units.
+	(Motion Quanta): New subsection node; introduce this concept
+	much sooner, right after measurement units.  Relocate
+	documentation of `.H` and `.V` registers from a miscellaneous
+	read-only register list here.  Introduce example of rounding to
+	horizontal motion quantum.
+	(Default Units): Revise discussion.  Stop abusing @result
+	notation in example.
+	(Built-In Registers): Relocate `.H` and `.V` as above.
 
-2015-03-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* man/groff.7.man: Sync with Texinfo content updates.
 
-	* src/devices/gropdf/gropdf.pl: Fix problem remappiing
-	ellipsis (affects all glyphs > 255).
+	Fixes <https://savannah.gnu.org/bugs/?61432>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2015-03-07  Werner LEMBERG  <wl@gnu.org>
+2022-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/tmac.am (TMACSPECIALFILES): Removed.  No longer used.
+	Drop groff_filenames(5) document.  It says nothing accurate that
+	is not covered elsewhere.
 
-2015-03-07  Ingo Schwarze  <schwarze@openbsd.org>
+	* contrib/groff_filenames: Delete.
+	* doc/doc.am (GROFF_MAN_PAGES): Drop.
+	* src/roff/groff/groff.1.man: Drop cross reference to it.
+	* NEWS: Add item.
 
-	* tmac/doc-common-u (Dd): Avoid warning `unbalanced .el request'.
+	Fixes <https://savannah.gnu.org/bugs/?61818>.
 
-2015-02-12  Werner LEMBERG  <wl@gnu.org>
+2022-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Minor fixes due to renaming `groff.texinfo' to `groff.texi'.
+	* src/preproc/tbl/tbl.1.man (Table data): Generalize discussion
+	of roff control line use in tables.
+	(Examples): Illustrate how to embed a comment in a table.
 
-	* doc/doc.am (SUFFIXES): Update.
-	* m4/groff.m4 (GROFF_MAKEINFO): Update.
+2022-08-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2015-01-30  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	* NEWS: man(7)'s `TS` no longer adds vertical space.  See commit
+	7ec36dc9b9, 30 July.
 
-	Automake migration and Gnulib integration.
+2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Gnulib:
-	- Added gnulib as a git submodule.
-	- Integrated bootstrap scripts from gnulib.
-	- Gnulib m4 directory is now in `gnulib_m4', while Gnulib's .c
-	files are located in `lib'.  `gnulib_m4' and `lib' are generated
-	and distributed.
+	* src/preproc/eqn/main.cpp (main): Issue deprecation warning
+	upon use of '-p' or '-s' options.  The eqn(1) man page has
+	documented these as deprecated since at least groff 1.02 (June
+	1991).  Don't count on them sticking around another 30 years.
 
-	Automake:
-	- Removed Makefiles from the old build system.
-	- Converted Makefile.in into Makefile.am.
-	- Converted Makefile.sub files in all directories to a .am file.
-	- Removed configure, src/include/config.hin (now generated).
-	- Removed various helper scripts (config.guess, config.rpath...),
-	now installed by bootstrap in `build-aux'.
-	- Moved aclocal.m4 to acinclude.m4 (aclocal.m4 is now generated).
-	- Makefile in non-recursive style.
-	- Updated INSTALL.REPO (INSTALL is now a symlink to
-	gnulib/doc/INSTALL, original INSTALL file moved to INSTALL.extra)
-	- Added (empty) THANKS, AUTHORS files.
-	- Added a document on the usage of automake in groff in
-	doc/automake.pdf.
+2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Additional features:
-	- Out-of-source build is supported.
-	- Parallel build is possible (make -j).
-	- Automatic targets from Automake: `make dist', `make distcheck'.
-	- 'make check' is available for automatic testing, gdiffmk's test
-	was plugged to this target.
-	- Auto-detect if make has builtin variable `RM'.
+	* src/preproc/eqn/main.cpp (main): Clarify error diagnostics
+	regarding invalid option arguments.  Identify the option being
+	handled at the time and characterize the argument as "invalid",
+	not "bad".
 
-2015-01-14  Ingo Schwarze  <schwarze@openbsd.org>
+2022-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix Savannah bug #43905.
+	eqn: Drop support for undocumented '-D' option.  It has been
+	undocumented, and issued a warning of its obsolescence upon use,
+	for 30 years, since groff 1.06 (September 1992).  That's plenty
+	long enough for a deprecation cycle.
 
-	* src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
-	* src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Remove
-	double entries for `rk', `lk', `lt', `rt', `rb', and `lb'.
+	* src/preproc/eqn/main.cpp (main): Do it.
+	* NEWS: Add item.
 
-2014-12-16  Werner LEMBERG  <wl@gnu.org>
+2022-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update Unicode-to-Unicode mapping to version 7.0.0.
+	man: (EX, EE): Always break line, even if call invalid.
 
-	* src/libs/libgroff/make-uniuni: Update emitted copyright.
+	* tmac/an.tmac (EX, EE):
+	* tmac/an-ext.tmac (EX, EE): Do it.  Ingo Schwarze pointed out
+	that page authors will expect breaking semantics from these
+	macros even if using them in an ill-formed way.  In a
+	well-formed document, the breaks are redundant but harmless (the
+	later `nf` and `fi` requests, respectively, also cause breaks).
 
-	* src/libs/libgroff/uniuni.cpp: Regenerated.
+2022-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-11-29  Werner LEMBERG  <wl@gnu.org>
+	mdoc: Trivially refactor.
 
-	Fix previous commit.
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common: Rename string `doc-command-name` to
+	`doc-topic-name`; the former is misleading for man pages not in
+	sections 1, 6, or 8.
 
-	We forgot to test whether the patch works if compiling from
-	scratch...
+2022-08-25  Bjarni Ingi Gislason <bjarniig@vortex.is>
 
-	Problem reported by Bertrand Garrigues
-	<bertrand.garrigues@laposte.net>.
+	* man/groff_char.7.man: Fix bad example syntax.
 
-	* src/include/lib.h (interpret_lf_args, normalize_for_lf): Move
-	declarations to...
-	* src/include/lf.h: This new file.
+	Fixes <https://savannah.gnu.org/bugs/?62959>.
 
-	* src/libs/libgroff/lf.cpp, src/preproc/pic/pic.h,
-	src/preproc/preconv/preconv.cpp, src/preproc/refer/refer.h,
-	src/preproc/soelim/soelim.cpp, src/preproc/tbl/table.h: Include
-	`lf.h'.
-	Make `lib.h' the first included header file.
+2022-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/eqn.h: Don't include `stringclass.h'.
-	* src/preproc/eqn/main.cpp: Include `stringclass.h' and `lf.h'.
+	mdoc: Trivially refactor.
 
-	* src/roff/groff/groff.cpp: Make `lib.h' the first included header
-	file.
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Stop using "Null" as an empty string
+	indicator when comparing a string interpolation to an empty
+	parameter will serve just as well; it is also more idiomatic.
+	The string in question, `doc-section`, is never formatted if it
+	is empty anyway; the very tests at issue, which populate
+	`doc-header-string`, ensure this.
 
-2014-11-10  Eli Zaretskii  <eliz@gnu.org>
+2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Improve native Windows port.
+	* src/roff/troff/env.cpp (environment::set_family): Throw error
+	if user requests a font family that (when combined with the
+	current style) can't be resolved to a real font name.  Fixes a
+	regression introduced by me in commit d8cb8cf9d8, 2021-09-15,
+	arising from a revision of font selection logic in node.cpp to
+	enable a bunch of _other_ font error diagnostics.
 
-	This patch fixes two issues.
+	Fixes <https://savannah.gnu.org/bugs/?62941>.  Thanks to Dave
+	Kemper for the report and two useful end points for a bisection.
 
-	  . Handle backslashes in `.lf' arguments for MSDOS and Windows.
-	  . Fix file name quoting for the groff pipeline.
+2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/soelim/soelim.cpp (do_file):
-	* src/preproc/refer/refer.cpp (do_file):
-	* src/preproc/preconv/preconv.cpp (do_file):
-	* src/preproc/pic/main.cpp (do_file):
-	* src/preproc/eqn/main.cpp (do_file): Call `normalize_for_lf' to
-	convert backslashes in the file name being processed to forward
-	slashes.
+	* src/roff/troff/env.cpp (environment::set_family): Add some
+	paranoia.  Add `assert()`s on the previous font mounting
+	position still being valid and the font family dictionary lookup
+	not returning a null pointer.  Add an early return for the
+	latter case (which should be impossible).
 
-	* src/include/lib.h (normalize_for_lf): Add prototype.
+2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/eqn.h:
+	* src/roff/troff/node.cpp (font_family::make_definite):
+	Refactor.  Rename parameter from inscrutable `i` to
+	`mounting_position`.  Add `assert()` to enforce invariant: we're
+	passed a mounting position that is nonnegative.  Use `pos` as
+	short alias of parameter once we're into the function body.
+	Relocate conditional branches to front-load early returns as
+	well as those requiring little code to handle.  This reduces the
+	average indentation level of the function, a readability win.
+
+2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Restore robustness to `EE` misuse.
+
+	* tmac/an.tmac: Add `an*is-in-example` register to track state
+	of within-exampleness.  Not doing so can cause a spurious use of
+	`EE` to wrongly set the inter-paragraph distance to zero.
+	(TH): Initialize register.
+	(EX): Test register; if set, ignore macro call and, if
+	`CHECKSTYLE` warnings are on, throw diagnostic.  Set register.
+	(EE): Test register; if clear, ignore macro call and, if
+	`CHECKSTYLE` warnings are on, throw diagnostic.  Clear register.
+
+	* tmac/an-ext.tmac (EX, EE): Similar, using `mX` register.
+	Because AT&T troff had no `return` request, invert the sense of
+	the tests and put the entire macro bodies inside conditionals.
+
+	This regressed post-1.22.4.  Thanks to Ingo Schwarze for the
+	report and a proposed patch.
+
+2022-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac: Refactor.  Rename `mX` to `mZ` so we can use
+	`mX` for an "in-example" state register in a future commit.
+	Rename `mE` to `mF` to store the current font's mounting
+	position.  Bizarrely, `mF` was not already used for this
+	purpose.
+
+2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	Trivially refactor.  Use separate string constant for invariant
+	material.  (This will make it easier to, for example, store the
+	diagnostic level strings in an array that can be indexed by
+	their corresponding `enum` type.)
+
+2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (fatal_with_file_and_line)
+	(error_with_file_and_line, debug_with_file_and_line): Align more
+	closely with GNU Coding Standards regarding diagnostics: don't
+	suffix the colon after the program name with a space when
+	location information follows.
+
+2022-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/grohtml.1.man: Fix erroneous claim.
+	Images are not generated when "baseline rules" or "box rules"
+	are encountered in the input.  These are troff special
+	characters; the former is converted to an underscore and the
+	latter to U+2502, "box drawings light vertical".  This remains
+	true even if a series of them is drawn with the `\l` escape
+	sequence.  (I also checked vertical line drawing with `\L`.
+	grohtml's handling of that provoked a rather wet eructation from
+	my lower esophageal sphincter--the output is assuredly not
+	correct.  But it's still not an image.)
+
+2022-08-22  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Bug #62934 - after glyph remapped mark it as used
+
+	When many glyphs are remapped from code points above 255
+	such as writing documents in cyrillic with the U-TR fonts,
+	gropdf starts reusing code points in the range 128-255.
+	If subsequently one of those code points is actually required,
+	such as \(em (code 138), and it has been replaced by a
+	cyrillic, then it needs to be mapped to another free code.
+
+	To determine if a particular code point is free each glyph
+	has a USED flag. The bug was caused because after remapping
+	\(em to the next free glyph the USED flag was not set. So the
+	next new cyrillic character to be entered was given the same
+	code point as had been allocated to \(em.
+
+	* src/devices/gropdf/gropdf.pl: Set the USED flag on remapped
+	glyphs.
+
+	Fixes <https://savannah.gnu.org/bugs/?62934>.
+
+	Thanks to Nikita Ivanov for spotting the problem and testing
+	the fix.
+
+2022-08-20  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Bug #62923 - problem using aliased glyphs
+
+	With a large font if 2 characters above the 255 code
+	point limit are aliased, the aliased glyph has incorrect meta
+	data.
+
+	* src/devices/gropdf/gropdf.pl: Instead of duplicating a pointer
+	to the font metadata, duplicate the data itself. Then, if the
+	glyph is remapped to a code point under 256, the metadata is
+	preserved.
+
+	Fixes <https://savannah.gnu.org/bugs/?62923>.  Thanks to Nikita
+	Ivanov for the report.
+
+2022-08-18  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf: Improve parsing of troff font files.
+
+	* src/devices/gropdf/gropdf.pl: Allow the glyph code number
+	to be octal or hex as well as a decimal number. If entity_name
+	is missing use name instead.
+
+2022-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Support pic(1) "flyback" feature.
+
+	* tmac/s.tmac (PF): Add macro; it does what `PE` formerly did,
+	minus vertical spacing.
+	(PE): Call `PF` and vertically space as before.
+
+	* doc/groff.texi (ms Insertions):
+	* doc/ms.ms (Tables, figures, equations, and references):
+	* tmac/groff_ms.7.man (Tables, figures, equations, and
+	references): Document it.
+
+	* NEWS: Add item.
+
+	Fixes <https://savannah.gnu.org/bugs/?60558>.
+
+2022-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (@PS): Validate better; check for 2 arguments
+	exactly.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic: Recognize `.PY` as synonym of `.PF`.
+
+	* src/preproc/pic/main.cpp:
+	* src/preproc/pic/pic.h: Add new Boolean variable,
+	`want_alternate_flyback` to record `.PY` usage.
+
+	* src/preproc/pic/main.cpp (top_input::get, top_input::peek):
+	Recognize it.  Update diagnostic messages to mention it.
+	(main): Define `PY` troff macro as empty if not defined.
+
+	* src/preproc/pic/troff.cpp (troff_output::finish_picture):
+	Don't advance the vertical position if `want_alternate_flyback`.
+	Write out the `PY` macro call if it was on the input.
+
+	* src/preproc/pic/pic.1.man: Document it.
+
+	* tmac/pic.tmac (PY): Define the same as `PF`.
+
+	* NEWS: Add item.
+
+	Fixes <https://savannah.gnu.org/bugs/?62901>.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic: Refactor `flyback_flag`.
+
+	* src/preproc/pic/main.cpp:
 	* src/preproc/pic/pic.h:
-	* src/preproc/refer/refer.h:
-	* src/preproc/tbl/table.h: Include stringclass.h before lib.h.
+	* src/preproc/pic/troff.cpp: Rename to `want_flyback`.
 
-	* src/libs/libgroff/lf.cpp (normalize_for_lf): New function.
+	* src/preproc/pic/main.cpp:
+	* src/preproc/pic/pic.h: Demote type from `int` to `bool`.
 
-	* src/roff/groff/groff.cpp: Include stringclass.h before lib.h.
-	(append_arg_to_string) _WIN32 && !__CYGWIN__: Use only "..." for
-	quoting in native Windows builds.
+	* src/preproc/pic/main.cpp (top_input::get, top_input::peek):
+	Use parentheses to clarify operation precedence.
 
-2014-11-18  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	My commit '3fe78135c9fe666dadffde2a822b0535d8db6feb' introduced
-	problem in subroutine `TextWid'.  Octal char `\nnn' returns width of
-	4 char string rather than width of single character.
+	* src/preproc/eqn/eqn.1.man: Expand to include lists of
+	recognized primitives and predefined macros.
 
-	* src/devices/gropdf/gropdf.pl: Change `TextWid' to recognise octal
-	escaped characters (\nnn).
+2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-11-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* NEWS: Add item for new groff mm `V` register support.
 
-	See bug #43555.
+2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: Correct Date Format.
+	* src/preproc/eqn/lex.cpp (do_delim): Recognize "delim on" even
+	in compatibility mode, enabling tbl to toggle eqn delimiter
+	recognition when it is run in compatibility mode as well.
+	* src/preproc/eqn/eqn.1.man (Controlling delimiters): Update.
+	* NEWS: Add item.
 
-2014-11-04  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?62852>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	* src/libs/gnulib/*: Regenerate autotool files.
+2022-08-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-11-04  Werner LEMBERG  <wl@gnu.org>
+	* tmac/an.tmac (TH): Fix spurious complaint from `CHECKSTYLE`
+	feature when a custom manual section title is declared for a
+	standard section number.  Thanks to Quentin Monnet for the
+	report.
 
-Version 1.22.3 released
-=======================
+2022-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* NEWS, README, doc/webpage.ms: Updated.
+	* tmac/pdfpic.tmac: Finish incomplete string renames.  Continues
+	0fd6ab6b4c, 21 January.
+		pdfpic*file-name -> pdfpic*file-name-base
+		pspic-args -> pdfpic*pspic-args
 
-	* doc/texinfo.tex: Updated from `texinfo' repository.
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-29  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	* tmac/an.tmac (TS): Stop inserting space before tables.  Unlike
+	ms(7), man(7) has no concept of "displays" and thus none of
+	"display distance".  It is up to the page author to use
+	paragraphing macros around tables if vertical space is desired.
+	And not up to us to impose it.
 
-	* Makefile.in (OTHERDIRS): Mention `afmtodit' first.
+	Fixes <https://savannah.gnu.org/bugs/?62841>.
 
-	Otherwise, some fonts in `devpdf' (`U-*') are not built.
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-26  Eli Zaretskii  <eliz@gnu.org>
-	    Werner LEMBERG  <wl@gnu.org>
+	man: Regression-test Savannah #62841.
 
-	Add Windows `.cmd' wrapper files.
+	* tmac/tests/an_TS-adds-no-vertical-space.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* arch/mingw/*: New files, provided by Eli.
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (make_winscripts, make_install_winscripts,
-	make_uninstall_winscripts): New target variables.
-	(MDEFINES): Add them.
-	(OTHERDIRS): Add `arch/mingw'.
+	* src/preproc/tbl/table.cpp (table::do_bottom): Avoid
+	overprinting a double-boxed table's bottom border on nroff
+	devices.
 
-	* m4/groff.m4 (GROFF_CMD_FILES): New macro
-	* configure.ac: Call it.
-	* configure: Regenerated.
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-23  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	tbl: Expand regression test for Savannah #49390.  Check for
+	overlap of double box borders, too.
 
-	Fix `install' and `uninstall' issues.
+	* src/preproc/tbl/tests/\
+	do-not-overlap-bottom-border-in-nroff.sh: Do it.
 
-	* contrib/chem/Makefile.sub (install_data): Fix build with option
-	--with-doc=no passed to configure (target `install_examples'
-	should not be executed).
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/chem/Makefile.sub (uninstall_sub):  `uninstall' failed
-	if directories to be removed were not present.
+	tbl: Fix Savannah #49390.
 
-	* contrib/gpinyin/Makefile.sub (uninstall_sub): Ditto.
+	* src/preproc/tbl/table.cpp (table::do_bottom): Avoid
+	overprinting a boxed table's bottom border on nroff devices.
 
-	* contrib/hdtbl/Makefile.sub (GENFILES): generated files should
-	depend on the creation of the `examples' directory.
+	Fixes <https://savannah.gnu.org/bugs/?49390>.  Thanks to Osamu
+	Sayama for the report.
 
-2014-10-23  Daiki Ueno  <ueno@gnu.org>
+2022-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/iconv.m4: Really avoid false detection of non-working iconv.
+	tbl: Regression-test Savannah #49390.
 
-2014-10-21  Daiki Ueno  <ueno@gnu.org>
+	* src/preproc/tbl/tests/\
+	do-not-overlap-bottom-border-in-nroff.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
 
-	iconv: avoid false detection of non-working iconv
+2022-07-28  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	The INBUF/OUTBUF arguments of iconv can be either 'const char **'
-	or 'char **'.  If CC is g++, the difference causes a compile error
-	and thus leads to a false detection of non-working iconv.
-	Reported by Eli Zaretskii and Werner LEMBERG in:
-	<https://lists.gnu.org/archive/html/bug-gnulib/2014-10/msg00023.html>.
+	gropdf: Improve slant application to lowercase Greek letters.
+	<https://lists.gnu.org/archive/html/groff/2022-07/msg00210.html>
 
-	* m4/iconv.m4 (AM_ICONV_LINK): Try all possible argument types of
-	iconv.  Bump serial number.
+	* tmac/pdf.tmac: Slant only if the glyph is sourced from a
+	special font, not a regular (text) font containing Greek glyphs.
 
-2014-10-20  Werner LEMBERG  <wl@gnu.org>
+2022-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/gnulib/lib/wctype.in.h: Include `config.h'.
+	* tmac/s.tmac: Add italic correction support to `I` and `BI`
+	macros.  Call `par*define-font-macro` with newly recognized
+	third argument indicating that italic corrections should be
+	applied.
+	(par*define-font-macro): Apply the corrections if directed.
 
-	Problem reported by Eli Zaretskii <eliz@gnu.org>.
+2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This is a temporary hack to make groff compile with MinGW.  After
-	the switch to an automake infrastructure, together with proper use
-	of `gnulib', we can safely replace the patched file with a standard
-	version.
+	* src/roff/troff/input.cpp (input_char_description): Clear
+	static buffer on every entry to the function so that calling it
+	twice in succession where the second call populates the buffer
+	with less data than the first doesn't leave garbage characters
+	in a diagnostic message.  Problem appears to date back to 1991
+	or earlier.
 
-2014-10-19  Doug McIlroy  <doug@cs.dartmouth.edu>
+	Fixes <https://savannah.gnu.org/bugs/?62813>.
 
-	Fix Savannah bug #42151.
+2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/lex.cpp (file_input::read_line): Handle CR/LF.
-	* src/preproc/pic/pic.cpp (file_input::read_line): Ditto.
+	* src/roff/troff/input.cpp (token::usable_as_delimiter):
+	(do_non_interpreted, interpolate_arg): Recast diagnostic
+	messages for clarity.
 
-2014-10-18  Werner LEMBERG  <wl@gnu.org>
+2022-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	mdoc Add Darwin version string for OS X 10.10.
+	* tmac/e.tmac: Initialize section number registers. Fixes
+	warnings when starting section numbering at a depth greater than
+	1.
 
-	* tmac/doc-common (doc-operating-system-Darwin-14.0.0): New string.
+	Fixes <https://savannah.gnu.org/bugs/?62812>.
 
-	* tmac/groff_mdoc.man: Updated.
+2022-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-15  Werner LEMBERG  <wl@gnu.org>
+	* m4/groff.m4 (GROFF_PAGE): Use 'grep -q' instead of redirecting
+	standard output to null device.  The '-q' option was
+	standardized in POSIX Issue 5 (1997) or earlier.  Also drop the
+	redirection of the standard error stream; we have already
+	checked the file named in "$descfile" for existence and
+	readability.  grep should thus not emit diagnostic messages.
 
-	* doc/webpage.ms: Remove obsolete references to tarballs and diffs.
+2022-07-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Reported by Dave Kemper <saint.snit@gmail.com>.
+	* m4/groff.m4 (GROFF_PAGE): Macro used awk(1) without
+	`AC_REQUIRE`-ing a relevant macro or checking for its existence.
+	Fortunately, sed is powerful enough for our needs.  Remove
+	dependency on awk.  Cope with "search" directive in resolv.conf
+	having multiple arguments.  Match "domain" directive in same
+	file instead of "dom", which I cannot find attested (this logic
+	dates to 1991).  Rename `dom` shell variable to `domains` for
+	clarity, since its multiplicity could be greater than 1.
 
-2014-10-15  Colin Watson  <cjwatson@debian.org>
+2022-07-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Always distribute the parts of groff that require X11.
+	* m4/groff.m4 (GROFF_PAGE): Refactor: drop AC_DEFINE of
+	`PAGEA4`.  This symbol appears to be a relic; it is nowhere
+	tested or dereferenced.
 
-	* Makefile.in (ALLLIBDIRS): Clone from `LIBDIRS', but include
-	src/devices/libxutil unconditionally.
-	(ALLPROGDIRS): Clone from `PROGDIRS', but include
-	src/devices/xditview and src/utils/xtotroff unconditionally.
-	(DISTDIRS): Use `ALLLIBDIRS' and `ALLPROGDIRS' rather than `LIBDIRS'
-	and `PROGDIRS'.
+2022-07-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-14  Keith Marshall  <keith.d.marshall@ntlworld.com>
+	* tmac/tty-char.tmac: Drop definition of \sd special
+	character.  This was superseded by commit 78e666246c, 8 May,
+	which defined a fallback for the character in tty.tmac instead.
+	Thanks to Dave Kemper for the catch.
 
-	Minor update to NEWS for pdfroff.
+2022-07-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* NEWS (pdfroff): Note use of PHASE register, and not pdf:href.map,
-	to choose when to emit toc_relocation control record.
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+	Skip test if "pdfinfo" command not available.
 
-2014-10-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+2022-07-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	For pdfroff, deduce "--no-toc-relocation" from input stream.
+	build: Add sanity checks for font description file generation
+	for PDF output device, prompted by discussion with Ingo
+	Schwarze.  See <https://lists.gnu.org/archive/html/groff/\
+	2022-06/msg00094.html>.
 
-	* NEWS: Add notification; document the effect of changes, as recorded
-	in contrib/pdfmark/ChangeLog.
+	* font/devpdf/tests/basic-fonts-present.sh:
+	* font/devpdf/tests/urw-fonts-present.sh: Add files.
 
-2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+	* font/devpdf/devpdf.am (font_devpdf_TESTS): Add the former test
+	unconditionally, and the latter only if `HAVE_URW_FONTS`.
 
-	mdoc Support `Mdocdate' CVS keyword substitution.
-	This fixes Savannah bug #42968.
+2022-07-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This feature is used for OpenBSD manuals.
+	* font/devpdf/devpdf.am: Refactor to simplify.  Now that
+	symbol.map lives in the "devpdf/generate" directory along with
+	the other map files, it doesn't need a dedicated Makefile target
+	to produce it.
+	(DEVPDFFONTMAP_1, DEVPDFFONTMAP_2): Coalesce and rename to...
+	(devpdffontmapdata): ...this.
+	(font/devpdf/map/symbol.map:): Drop target.
+	(devpdffontmap_DATA, font/devpdf/download): Update dependencies.
 
-	* tmac/doc-common (Dd): Handle `$Mdocdate:' argument.
+2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/groff_mdoc.man: Document it.
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Recast
+	diagnostic message so that the user understands the consequence
+	of failure to locate a Type 1 font file (that isn't one of the
+	base 14 PostScript level 1 fonts): the font will be unavailable
+	for the "pdf" output device.
 
-2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	mdoc Add `.At III' and `.St -iso8601'.
-	This fixes Savannah bug #42971.
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Separate
+	lists of Type 1 font names with spaces as well as commas, for
+	better diagnostic message readability.  Also begin message in
+	lowercase (per GNU Coding Standards).
 
-	* tmac/doc-syms: Add corresponding version strings.
+2022-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/groff_mdoc.man: Synchronize.
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Verify that
+	`$foundrypath->$j` is defined before operating on it.
 
-2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	mdoc Update operating system release numbers.
-	This fixes Savannah bug #42969.
+	afmtodit: Clarify diagnostic message.
 
-	* tmac/doc-common: Update NetBSD, OpenBSD, FreeBSD, and DragonFly
-	version strings.
+	* src/utils/afmtodit/afmtodit.pl: When we have excess Adobe
+	Glyph List mappings for a groff special character identifier
+	{making the reverse mapping from groff special character to font
+	glyph name ambiguous}, report that we're ignoring the excess.
+	Use "print STDERR" instead of Perl "warn" built-in since we want
+	diagnostic messages to start with the name of the program
+	emitting them.
 
-	* tmac/groff_mdoc.man: Synchronize.
+2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	build: Name and place PS->groff glyph name maps consistently.
 
-	* doc/Makefile.in: Use `LC_ALL' in addition to `LANG'.
-	Suggested by Steffen.
+	* font/devps/symbolmap: Rename from this...
+	* font/devps/generate/symbol.map: ...to this.
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* font/devpdf/devpdf.am (font/devpdf/map/symbolmap): Rename
+	target...
+	(font/devpdf/map/symbol.map): ...to this.
+	(font/devpdf/map/symbol.map): Copy "devps" version of file from
+	its new location in the "generate" subdirectory.
 
-	* doc/groff.texinfo: Make PDF version compilable with makeinfo 5.x.
+	* font/devpdf/Foundry.in: Reflect rename.
 
-	makeinfo 5.x handles macro expansion better, which changes the way
-	how an \LE macro (for a less-than sign) has to be defined.  However,
-	since we can't be sure that the latest version of `texinfo.tex' gets
-	used with makeinfo 5.x only, we would have to support both 4.x and
-	5.x.  No idea whether this is possible at all...  For this reason,
-	we now simply use @value directly instead of wrapping it into a
-	macro, avoiding any issues.
+	* font/devps/generate/Makefile (symbolmap): Rename target...
+	($(srcdir)/symbol.map): ...to this.
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* font/devps/devps.am (DEVPSGENFILES, EXTRA_DIST):
+	* font/devps/generate/Makefile (S, EURO $(SPECIALFONTS), clean):
+	* src/utils/afmtodit/afmtodit.1.man: Reflect rename and
+	relocation.
 
-	doc Protect against picky `sed' programs.
-	Problem reported by Axel Kielhorn <tex@axelkielhorn.de>.
+	* font/devps/generate/dingbats.rmap: Rename from this...
+	* font/devps/generate/dingbats-reversed.map: ...to this.
 
-	* doc/Makefile.in (GROFF_BIN_PATH, GROFF): Add `LANG=' to avoid
-	interpretation of non-ASCII characters by sed.
+	* font/devps/devps.am (DEVPSGENFILES):
+	* font/devps/generate/Makefile (ZDR):
+	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.
 
-2014-10-12  Michail Vidiassov  <master@iaas.msu.ru>
+	* font/devps/generate/lgreekmap: Rename from this...
+	* font/devps/generate/slanted-symbol.map: ...to this.
 
-	* tmac/doc-common: Add new Darwin versions.
+	* font/devps/devps.am (DEVPSGENFILES):
+	* font/devps/generate/Makefile (SS):
+	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* font/devps/generate/textmap: Rename from this...
+	* font/devps/generate/text.map: ...to this.
 
-	* doc/groff.texinfo: s/which/that/ where apropriate.
+	* font/devpdf/Foundry.in:
+	* font/devpdf/devpdf.am (DEVPDFFONTMAP_1):
+	* font/devps/devps.am (DEVPSGENFILES):
+	* font/devps/generate/Makefile (TEXTMAP):
+	* src/devices/gropdf/gropdf.1.man:
+	* src/devices/grops/grops.1.man:
+	* src/utils/afmtodit/afmtodit.1.man: Reflect rename.
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+2022-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texinfo: Various minor fixes.
+	* doc/doc.am (doc/ms.ps): Add dependency on "eqn", and call
+	groff with "-e" option.
+	* src/utils/grog/tests/smoke-test.sh: Update expected "grog"
+	output for the ms.ms document.
 
-	Most of those glitches have been found by comparing the info output
-	from makeinfo 4.13 and the current SVN development version (of
-	makeinfo).
+2022-07-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* doc/doc.am (doc/ms.ps): Add dependency on "tbl".
 
-	* doc/groff.texinfo: Improve indexing.
+2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Change @DefXXXItem and @DefXXXListEnd macros to not insert an index
-	entry.  New macro variants with a trailing `x' (like `@DefreqItemx')
-	can override this.
+	* src/roff/troff/node.cpp (suppress_node::tprint): Add source
+	file line number after its name when emitting "grohtml-info", to
+	aid debugging.
 
-	Update macro calls where necessary.
+2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/troff/node.cpp (get_register, get_string): Reorder
+	null pointer inequality comparisons; they don't need to be in a
+	funny order because it's pretty hard to mistype `!=` as an
+	assignment operator.  Annotate them as null pointers to ease any
+	future migration to ISO C++11.  Use primitive type constructor
+	instead of C-style cast operator; this seems more idiomatic.
 
-	doc Improve call to generation of `groff.pdf'.
-	Problem reported by Axel Kielhorn <tex@axelkielhorn.de>.
+2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Since `groff.texinfo' contains latin-1 characters, some sed
-	implementations (like the one used on Mac OS 10.8) fail if called
-	with the wrong locale.  Basically, this is a `texi2dvi' bug, but we
-	can set `LANG' by ourselves to improve the situation.
+	* src/preproc/html/pre-html.cpp (generateImages): Flush the
+	standard error stream after writing to it in a loop.
 
-	* doc/Makefile.in (.texinfo.dvi, .texinfo.pdf): Set `LANG'
-	environment variable to empty string.
+2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-12  Werner LEMBERG  <wl@gnu.org>
+	* tmac/s.tmac (RP): Recognize new optional arguments
+	`no-renumber` and `no-repeat-info`, the latter as a synonym for
+	the existing `no`.  The former suppresses the page number
+	manipulation that normally occurs.  Drop now-unnecessary `pn 0`
+	request.
+	(top level, cov*first-page-init, RP, cov*print): Rename
+	`cov*rp-format` to `cov*use-rp-format` for clarity.
+	(cov*break-page): New macro breaks the cover page at the end,
+	resetting next page number to 1 only if desired by user.
+	(cov*print, cov*rp-print): Call `cov*break-page` instead of
+	invoking `bp`.
 
-	doc Correctly handle `MAKEINFO' environment variable.
-	Bug introduced in commit from 2014-03-29.
+	* doc/groff.texi (Document Description Macros) <RP>:
+	* doc/ms.ms (Document description macros) <RP>:
+	* tmac/groff_ms.7.man (Document description macros) <RP>:
+	Document them.
 
-	* m4/groff.m4 (GROFF_MAKEINFO): Don't set MAKEINFO to empty string
-	before actually testing it.
+	* NEWS: Add item.
 
-	* configure: Regenerated.
+2022-07-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-11  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+	* tmac/s.tmac: Rename register `cov*rp-no` to
+	`cov*rp-no-repeat-info`.
 
-	Fix an issue on `make dist'.
+2022-07-08  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	In order to make the tarball, `make dist' copies src/libs/gnulib
-	directories into the `tmp' directory without the `.deps'
-	directories, causing the failure of `make distclean' in
-	tmp/src/libs/gnulib.  Forcing a call to `config.status' recreates
-	the `.deps' directories.
+	* font/devpdf/util/BuildFoundries.pl (LocateFile): Some systems
+	store .afm files in a parallel directory to the Type 1 files,
+	restore original path after checking for parallel directory.
 
-	* Makefile.in (dist): For gnulib, call `config.status' before `make
-	distclean'.
+2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* font/devpdf/devpdf.am (font/devpdf/download): Call
+	"BuildFoundries" with new `--strict` option so that the build
+	fails if the AFM files for the URW fonts can't be found.
 
-	* src/roff/grog/*.pl: Remove call from `IPC', use normal system
-	`instead'.
+2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-11  Guillem Jover  <guillem@hadrons.org>
+	* font/devpdf/util/BuildFoundries.pl: Add Boolean-valued scalar
+	`beStrict` (defaults false) and new command-line option
+	`--strict` to make it true.
+	(LoadFoundry): Check return value of subroutine `LocateAF`.
+	Emit diagnostic if it is null, as a warning if not "strict", and
+	fatal if so.
 
-	Add support for various BSD versions.
+2022-07-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc-common: Add new FreeBSD and DragonFly versions.
+	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Add
+	dependency on "afmtodit" since "BuildFoundries" calls this
+	program when generating groff font description files from URW
+	fonts.
 
-2014-10-11  Keith Marshall  <keith.d.marshall@ntlworld.com>
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Refactor .psbb request handling code.
+	ms: Fix Savannah #62690.
 
-	* src/roff/troff/input.cpp (do_ps_file): Reimplement it, using...
-	(psbb_locator): ...this new locally declared and implemented class;
-	its constructor replaces all `do_ps_file()' capability, delegating
-	to other class methods, as appropriate.
-	(assign_registers): Encapsulate it, as a `psbb_locator' method.
-	(ps_get_line): Likewise, also renaming it to become...
-	(get_line): ...this class method; its internally defined `lastc'
-	static variable also becomes a non-static class member variable.
-	(PSBB_RANGE_IS_BAD, PSBB_RANGE_IS_SET, PSBB_RANGE_AT_END): New
-	manifest constants; define them.  They are now used by...
-	(parse_bounding_box): ...this function, now also encapsulated as
-	a `psbb_locator' class method, to convey parsing status.
-	(bounding_box): Struct obsoleted by `psbb_locator'; delete it.
-	(ps_bbox_request): Delegate to `psbb_locator'.
+	* tmac/s.tmac (P1, SC, UC, P2): Drop undocumented support for
+	document-private macros used by Kernighan & Cherry's
+	"Typesetting Mathematics -- User's Guide (Second Edition)".
 
-2014-10-11  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?62690>.
 
-	Various clean-ups.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* NEWS: More updates.
+	ms: Fix Savannah #62688.
 
-	* REVISION: Set to 3.
+	* tmac/s.tmac (DE): Set no-space mode when ending displays.
+	(@EN): Set no-space mode after outputting the display distance
+	so that it doesn't combine with inter-paragraph space.
 
-	* doc/groff.texinfo: Update version and year.
+	Fixes <https://savannah.gnu.org/bugs/?62688>.
 
-	* configure: Regenerated.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+	ms: Regression-test Savannah #62688.
 
-2014-10-11  Werner LEMBERG  <wl@gnu.org>
+	* tmac/tests/s_no-excess-space-around-displays.tmac: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	Update generic GNU files to recent versions.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.gen, config.guess, config.rpath, config.sub,
-	contrib/groff_filenames/Makefile.sub, doc/fdl.texi, doc/texinfo.tex,
-	doc/txi-en.tex, install-sh, m4/ax_prog_perl_version.m4,
-	m4/codeset.m4, m4/fcntl-o.m4, m4/glibc21.m4, m4/iconv.m4,
-	m4/lib-ld.m4, m4/lib-link.m4, m4/lib-prefix.m4, m4/localcharset.m4,
-	src/include/localcharset.h, src/libs/gnulib/Makefile.in,
-	src/libs/gnulib/aclocal.m4, src/libs/gnulib/build-aux/compile,
-	src/libs/gnulib/build-aux/config.guess,
-	src/libs/gnulib/build-aux/config.sub,
-	src/libs/gnulib/build-aux/depcomp,
-	src/libs/gnulib/build-aux/install-sh,
-	src/libs/gnulib/build-aux/snippet/arg-nonnull.h,
-	src/libs/gnulib/build-aux/snippet/c++defs.h,
-	src/libs/gnulib/build-aux/snippet/warn-on-use.h,
-	src/libs/gnulib/configure, src/libs/gnulib/lib/Makefile.in,
-	src/libs/gnulib/lib/config.charset, src/libs/gnulib/lib/intprops.h,
-	src/libs/gnulib/lib/localcharset.c,
-	src/libs/gnulib/lib/localcharset.h, src/libs/gnulib/lib/ref-add.sin,
-	src/libs/gnulib/lib/ref-del.sin, src/libs/gnulib/lib/stdbool.in.h,
-	src/libs/gnulib/lib/stddef.in.h, src/libs/gnulib/lib/streq.h,
-	src/libs/gnulib/lib/unitypes.in.h,
-	src/libs/gnulib/lib/uniwidth.in.h,
-	src/libs/gnulib/lib/uniwidth/cjk.h,
-	src/libs/gnulib/lib/uniwidth/width.c, src/libs/gnulib/lib/verify.h,
-	src/libs/gnulib/lib/wchar.in.h, src/libs/gnulib/lib/wctype-h.c,
-	src/libs/gnulib/lib/wctype.in.h, src/libs/gnulib/lib/wcwidth.c,
-	src/libs/gnulib/m4/00gnulib.m4, src/libs/gnulib/m4/Makefile.in,
-	src/libs/gnulib/m4/codeset.m4, src/libs/gnulib/m4/configmake.m4,
-	src/libs/gnulib/m4/extensions.m4, src/libs/gnulib/m4/fcntl-o.m4,
-	src/libs/gnulib/m4/glibc21.m4, src/libs/gnulib/m4/gnulib-tool.m4,
-	src/libs/gnulib/m4/inttypes-pri.m4,
-	src/libs/gnulib/m4/localcharset.m4, src/libs/gnulib/m4/longlong.m4,
-	src/libs/gnulib/m4/onceonly.m4, src/libs/gnulib/m4/wchar_t.m4,
-	src/libs/gnulib/m4/wint_t.m4, src/libs/libgroff/config.charset,
-	src/libs/libgroff/localcharset.c, src/libs/libgroff/ref-add.sin,
-	src/libs/libgroff/ref-del.sin, src/preproc/refer/refer.man: Do it.
+	ms: Fix Savannah #62687.
 
-2014-10-11  Werner LEMBERG  <wl@gnu.org>
+	* tmac/s.tmac (@MC): Honor `MINGW` register even when setting
+	only two columns, as clearly implied by our documentation.
 
-	* NEWS, MANIFEST: Updated.
+	Fixes <https://savannah.gnu.org/bugs/?62687>.
 
-2014-10-11  Werner LEMBERG  <wl@gnu.org>
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (OTHERDIRS, NOMAKEDIRS): Remove `ideal' references.
+	ms: Regression-test Savannah #62687.
 
-2014-10-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/tests/s_honor-MINGW-when-two-columns.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* contrib/gideal: Temporarily remove this directory, because the
-	documentation and the preprocessor are not yet finished for
-	groff-1.2.23.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-10-10  Werner LEMBERG  <wl@gnu.org>
+	ms: Fix Savannah #62686.
 
-	* Makefile.in (dist): Clean up `src/libs/gnulib'.
+	* tmac/s.tmac (@MC): Set no-space mode before doing a paragraph
+	reset, not after: we don't want vertical space at the top of the
+	first column when entering multi-column mode, because then it
+	doesn't align with the tops of subsequent columns.
 
-2014-10-10  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?62686>.
 
-	* doc/webpage.ms: Updates.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The README and NEWS sections are not yet synchronized, though.
+	ms: Regression-test Savannah #62686.
 
-2014-10-09  Ingo Schwarze  <schwarze@openbsd.org>
+	* tmac/tests/s_mark-column-start-correctly.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* Makefile.in: Let `clean' and `distclean' descend into gnulib.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This fixes Savannah bug #42970.
+	* tmac/s.tmac (IX): Drop.
+	* NEWS: Add item.
 
-2014-10-02  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Set default X11 resources dir to `$prefix/lib/X11/app-defaults'.
+	* tmac/s.tmac: Add "sorry" implementations for documented but
+	unsupported Unix Version 7 ms macros.  This way it's easier to
+	tell when a historical document needs one and this case is
+	distinguishable from a document-private macro warned about with
+	"groff -w mac".
 
-	Previously, X11 resources for gxditview were installed in
-	`/usr/X11/lib/X11/app-defaults', no matter which prefix was set.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Now, gxditview resources are installed in
-	`appresdir=$prefix/lib/X11/app-defaults'.  If `appresdir' is not a
-	standard X11 resource directory, the environment variable
-	`XFILESEARCHPATH' should be set to this path.
+	* tmac/s.tmac (UX): Drop undocumented support for this macro.
+	This implementation isn't consistent with historical ones, which
+	identified the trademark holder.  But doing that is a problem,
+	so just stop trying to cope.  Also, spelling Unix in full caps
+	was an imposition by the AT&T legal department on the CSRC.
 
-	The behaviour of `--with-appresdir' is unchanged: This option can
-	still be used to set `appresdir', and its value will not be modified
-	by the prefix.
+	"The name Unix is a trademark, originally owned by Bell Labs and
+	subsequently traded off like a baseball card among a number of
+	companies." -- Ben Klemens
 
-	* m4/groff.m4 (GROFF_APPRESDIR_DEFAULT): Implement new behaviour.
-	Fix detection app-defaults location on the system.
-	(GROFF_APPRESDIR_CHECK): Updated.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* configure.ac: Improve output of configuration.
-	* configure: Regenerated.
+	ms: Replace incomplete documentation of unimplemented macros.
 
-	* NEWS: Mention it.
+	* doc/groff.texi (Missing ms Macros):
+	* doc/ms.ms (AT&T ms macros not appearing in groff ms): Drop,
+	replacing with...
 
-2014-09-27  Werner LEMBERG  <wl@gnu.org>
+	* doc/groff.texi (Unix Version 7 ms Macros Not Implemented by
+	groff ms):
+	* doc/ms.ms (Unix Version 7 ms macros not implemented by groff
+	ms):
+	* tmac/groff_ms.7.man (Unix Version 7 macros not implemented by
+	groff ms): ...these.
 
-	Set `transparent' flag for `\cq.
-	Problem reported by Dave Kemper <saint.snit@gmail.com>.
+2022-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/input.cpp (init_charset_table): Do it.
+	* src/roff/troff/input.cpp (do_translate): Throw an error
+	diagnostic when the user attempts to translate space characters.
+	{By contrast, translating _to_ unbreakable, unadjustable
+	spaces is an old troff hack often seen as ".tr ~ ", and largely
+	superseded by groff's "\~" escape sequence, now widely supported
+	by other troffs.}
 
-	* doc/groff.texinfo (Sentences, Using Symbols), man/groff_diff.man:
-	Document it.
+	Fixes <https://savannah.gnu.org/bugs/?60803>.  Thanks to T. Kurt
+	Bond and Oliver Corff for the report.
+
+2022-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/pipeline.c: Refactor.  Drop function rename via
+	preprocessor macro usage.  Declare and define `c_error` by its
+	correct name.
+	(run_pipeline): Update call sites.  Stop flushing standard error
+	stream after calling libgroff's `error` function (which
+	`c_error` wraps); libgroff already guarantees this operation.
+
+2022-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (abort_request): Flush the standard
+	error stream before exiting, to improve chances of user seeing
+	any message as arguments to the `ab` request.
+
+2022-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/html/pre-html.cpp
+	(char_buffer::run_output_filter): Die if platform supports
+	neither `fork()` nor `spawn()` for child process creation.
+
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/html/pre-html.cpp (cleanup): Add function to tidy
+	memory before exiting.
+	(main): Register aforementioned function with `atexit()`.  Die
+	if registration fails.
 
-2014-09-25  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/*.pl: Program more reasonable subs (functions).
-	Repair details in many places.
+	* src/preproc/html/pre-html.cpp (do_file): Die if `fclose()`
+	fails; such a situation suggests a pretty hosed environment.
 
-2014-09-24  Keith Marshall  <keith.d.marshall@ntlworld.com>
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Refactor psbb line input function; avoid a buffer overrun.
+	* src/preproc/html/pre-html.cpp (checkImageDir): If `mkdir()`
+	fails, use `strerror()` to report the underlying problem.
 
-	* src/roff/troff/input.cpp (ps_get_line): Declare it as `static'.
-	Refactor, to avoid the overhead of character look-ahead and push-back
-	on CR stream input.  Add new `dscopt' parameter, in place of internal
-	`err' variable; update all call references, passing value of...
-	(DSC_LINE_MAX_ENFORCE): ...this new manifest constant; define it.
-	(DSC_LINE_MAX_IGNORED): Likewise; currently unused, but intended for
-	future use as an alternative to `DSC_LINE_MAX_ENFORCE'.
-	(DSC_LINE_MAX_CHECKED): New manifest constant; used internally only.
-	(PS_LINE_MAX): Manifest constant, renamed for notional consistency...
-	(DSC_LINE_MAX): ...to this; defined value remains as 255.
-	(do_ps_file): Increase stack allocation for `buf' char array; former
-	allocation of PS_LINE_MAX (now DSC_LINE_MAX) bytes exposed a potential
-	buffer overrun, after reading DSC_LINE_MAX bytes; two additional bytes
-	are required, to accommodate a terminating LF and NUL.  Add `dscopt'
-	parameter, with value `DSC_LINE_MAX_ENFORCE', in each of three calls
-	to `ps_get_line()'.
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/preproc/html/pre-html.cpp: Refactor.  Drop unnecessary
+	prototype for static function.  Use idiomatic C++98 null pointer
+	constant.  Annotate it as null pointer to ease any future
+	migration to ISO C++11.  Boolify.  Use C++98 bool data type
+	instead of preprocessor macros `TRUE` and `FALSE`.  Demote some
+	global Boolean variables from `int` to `bool` and rename some to
+	be more clear: `show_progress` -> `want_progress_report`;
+	`debugging`; `eqn_flag` -> `need_eqn`.
+	(make_message): Rename this...
+	(make_string): ...to this.  Align more closely with contemporary
+	version of example from Linux man-pages printf(3) page.  Use
+	`vsnprintf()` to determine size of memory buffer needed prior to
+	allocation instead of iteratively growing it until it is large
+	enough.  Always die if `vsnprintf()` fails: this function now
+	always returns a valid pointer if it returns at all.
+	(makeFileName, setupAntiAlias, imageList::createPage,
+	imageList::createImage): Update call sites to use
+	`make_string()`.
+	(char_buffer::can_see): Demote return type from `int` to `bool`.
+	(char_buffer::skip_spaces): Drop unused member function.
+	(char_buffer::read_file, makeTempFiles): Demote return type from
+	`int` to `void`.  Stop returning after calling functions that
+	don't return.
+	(char_buffer::read_file): Call `sys_fatal()` if `fread()`
+	returns an error, similarly to other calls into the standard C
+	library that this file makes.  Improve check for error from
+	`fread()` by not regarding a return value of zero when the
+	end-of-file indicator is set as an error condition.
+	(makeFileName, checkImageDir, char_buffer::run_output_filter,
+	scanArguments): Call `fatal()` instead of `error()` and then
+	`exit(1)`.
+	(makeFileName, scanArguments): Dismiss Shlemiel the Painter:
+	save return value of `strlen()` and call `strcpy()` multiple
+	times instead of mixing `strcpy()` and `strcat()`; the latter
+	approach rescans the string unnecessarily.
+	(char_buffer::run_output_filter): Stop passing unnecessary null
+	pointer argument to diagnostic message functions.  Stop calling
+	`fflush()` after libgroff diagnostic function, which always
+	{ultimately} flushes the standard error stream itself.
+	(makeTempFiles, do_file, main): Boolify.
+	(makeTempFiles, do_file): Reorder null pointer equality
+	comparisons to avoid inadvertent lvalue assignment.
+	(scanArguments, main): Use `EXIT_SUCCESS` and `EXIT_FAILURE`
+	constants from C library instead of integer literals for exit
+	status.
+	(do_file): Demote return type from `int` to `bool`.  Return
+	Boolean literals.  Drop conditional with empty consequent.
+	(main): Declare local variables closer to the points of use.
+	Stop trying to be a register allocator: stop reusing loop index
+	variable `i` as integer storage for another (albeit related)
+	purpose; introduce `operand_index` instead.  Clarify logic by
+	splitting combined initialization and comparison operations, and
+	by testing function return value directly instead of storing it
+	in a pointless temporary.  Use `EXIT_SUCCESS` and `EXIT_FAILURE`
+	constants from C library instead of integer literals for exit
+	status.
 
-	* src/roff/groff/Makefile.sub: Remove too much deleting while
-	running `make'.
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp (run_commands): Trivially refactor.
+	Rename variable for clarity; add comment.
 
-	* `Makefile.sub' in the whole groff source tree: Add $(RM) and
-	change all `rm -f'.  Add directory test before `rmdir'.
+2022-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/preproc/html/pre-html.cpp
+	(char_buffer::run_output_filter): Return wait status of child
+	process.
+	(char_buffer::run_output_filter, main): Rename local variable
+	`status` to `wstatus` to recognize distinction between exit
+	status (a 7-bit quantity) and wait status (a wider type).
+	(main): Issue fatal diagnostic if child process exited with
+	nonzero status.  Since the child's output to the standard error
+	stream is lost, advise re-running with different output driver
+	to see them.  This unhappy shortcoming is filed as Savannah
+	#62673.  Explicitly return zero otherwise.
 
-	* Man-pages (*.man) in the whole groff source tree: Improve
-	documents by adding \co, \cq, \aq instead of ` or ' and use
-	also \co as long as it makes sense.  Remove \en in the years
-	date in order to allow the automatic license year increasing.
+	Fixes <https://savannah.gnu.org/bugs/?60782>.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* <groff-source-top>/*: Improve the license information and Emacs
-	setup.
+	* src/roff/groff/tests/ab_works.sh: Add regression test for
+	Savannah #60782.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/*: Improve the license information and Emacs setup.
+	troff: Trivially refactor.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/troff/input.cpp (token::next): Rename statement label
+	to use documentary terminology.
+	* src/roff/troff/node.cpp (make_composite_node)
+	(make_glyph_node): Make functions static since nothing outside
+	this translation unit calls them.
+	* src/roff/troff/node.cpp (make_glyph_node): Refactor optional
+	argument and its usage.  Put it down, flip it, and reverse it.
+	That is, demote its type from `int` to `bool`, invert its sense,
+	and rename it since it affects warning, not error, diagnostics.
+	(character_exists): Update only call site of `make_glyph_node()`
+	that uses non-default argument value.
 
-	* src/utils/xtotroff/*: Improve the license information and Emacs
-	setup.
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	troff: Adjust diagnostic message text to clarify and better
+	match terminology used in documentation.
 
-	* src/utils/tfmtodit/*: Improve the license information and Emacs
-	setup.
+	* src/roff/troff/input.cpp (set_escape_char, do_overstrike)
+	(do_bracket, do_name_test, do_width, do_special):
+	* src/roff/troff/node.cpp (suppress_node::tprint): Migrate from
+	"escape" to "escape sequence".
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/troff/node.cpp (make_composite_node)
+	(make_glyph_node): Clarify what went wrong.
 
-	* src/utils/pfbtops/*: Improve the license information and Emacs
-	setup.
+	* src/roff/troff/input.cpp (token::get_char)
+	(check_missing_character): Migrate from "normal character" to
+	"ordinary character" (see groff_char(7)).
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/utils/lookbib/*: Improve the license information and Emacs
-	setup.
+	troff: Rename a function for clarity.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/troff/input.cpp (add_to_node_list): Rename this...
+	(add_to_zero_width_node_list): ...to this.
+	(do_zero_width): Update call site.
+	* src/roff/troff/token.h: Update declaration.
 
-	* src/utils/lkbib/*: Improve the license information and Emacs
-	setup.
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp (handle_unknown_desc_command):
+	Refactor to skip unnecessary string comparisons.  We explicitly
+	return in the final case instead of falling off the end of this
+	void function for consistency if additional cases are added.
 
-	* src/utils/indxbib/*: Improve the license information and Emacs
-	setup.
+2022-06-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp (handle_unknown_desc_command):
+	Partially revert commit 64dc40d23a, 19 June.  I forgot to save
+	and restore the previous values of the globals
+	`current_filename` and `current_lineno`, and, noticing that this
+	function has 3 return paths, decided that it's cheaper just to
+	go back to `error_with_file_and_line()`.
 
-	* src/utils/hpftodit/*: Improve the license information and Emacs
-	setup.
+2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	gropdf: Add more search paths to the Foundry file.
 
-	* src/utils/afmtodit/*: Improve the license information and Emacs
-	setup.
+	* font/devpdf/Foundry.in: Use the directory specified with the
+	config flag --with-urw-fonts-dir to populate the default foundry
+	as well as the U foundry. Important to populate the download
+	file with font files to embed the fonts not part of the base
+	pdf fonts or if user wants all fonts embedded.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/utils/addftinfo/*: Improve the license information and Emacs
-	setup.
+	* tmac/an-ext.tmac (UR, MT): Fix problem with hyphenation
+	occurring before the end of the line when the line length was
+	not the device default (common for man pages at the terminal)
+	and hyperlinks were enabled.  The issue is that the new
+	environment we created inherits the default environment's line
+	length (its state at troff initialization, prior to macro
+	package loading and configuration).  This latent issue was
+	exposed by post-groff 1.22.4 changes to enable the hyphenation
+	of link text and add the hyperlink feature.  Fix it by copying
+	the line length at the time the macro is called, which is
+	necessarily after man(7) sets up the line length, to the new
+	environment.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/*: Improve the license information and Emacs
-	setup.
+	* src/devices/grops/psrm.cpp (resource_manager::output_prolog):
+	(resource_manager::supply_resource):
+	(resource_manager::read_download_file): Update diagnostic
+	message language and report underlying problem encountered by
+	system when failing to open files.  This will probably be the
+	text for ENOENT in most cases, but should help avoid frustration
+	in those where it isn't.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/nroff/*: Improve the license information and Emacs
-	setup.
+	* src/devices/grops/psrm.cpp
+	(resource_manager::read_download_file): Align diagnostic message
+	wording with gropdf in the same circumstance.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/*: Improve the license information and Emacs
-	setup.
+	troff: Throw warning in font category when a font selection
+	escape sequence is used after the output line continuation
+	escape sequence on an input line, because it is ignored.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/troff/env.cpp (environment::set_font): Do it.
 
-	* src/roff/groff/*: Improve the license information and Emacs
-	setup.
+	* doc/groff.texi (Warnings):
+	* src/roff/troff/troff.1.man (Warnings): Document it.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/tbl/*: Improve the license information and Emacs
-	setup.
+	* src/roff/troff/env.cpp (font_change): Boolify.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/soelim/*: Improve the license information and Emacs
-	setup.
+	* src/devices/gropdf/gropdf.pl (LoadFont): Revise error message
+	when a font can't be found for embedding.  User failure to add
+	an entry for locating the font file seems a more likely scenario
+	than outright corruption of the file.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/refer/*: Improve the license information and Emacs
-	setup.
+	* src/roff/troff/env.cpp (font_change): Warn upon selection of a
+	nonexistent font name.
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?62656>.
 
-	* src/preproc/preconv/*: Improve the license information and Emacs
-	setup.
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	troff: Revise `environment::set_font` to return Boolean value
+	indicating success of font selection operation.
 
-	* src/preproc/pic/*: Improve the license information and Emacs
-	setup.
+	* src/roff/troff/env.cpp (environment::set_font):
+	* src/roff/troff/env.h (environment::set_font): Do it.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	This prepares the way for a fix for Savannah #62656.
 
-	* src/preproc/html/*: Improve the license information and Emacs
-	setup.
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp: Use single exit path, freeing
+	memory allocated for strings.
+	(xexit): Add `exit()` wrapper; free allocated memory.
+	(main): Use it in all three exit paths.
 
-	* src/preproc/grn/*: Improve the license information and Emacs
-	setup.
+2022-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp: Refactor to be more meticulous with
+	memory.  Add globals `saved_path`, `groff_bin_path`, and
+	`groff_font` to store pointers into the process environment
+	returned by `putenv()`; once used, they need to remain valid for
+	the lifetime of the program.
+	(xstrdup): Add `strdup()` wrapper: dies if `strdup()` fails.
+	(main): Split nested `strsave()` and `xputenv()` (until recently
+	`putenv()`) calls.  Free duplicate strings prior to exit.
 
-	* src/preproc/eqn/*: Improve the license information and Emacs
-	setup.
+2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp (main): Rename temporary variable to
+	avoid shadowing one in enclosing scope, which can lead to
+	cut-and-paste errors (ask me how I know).
 
-	* src/libs/libxutil/*: Improve the license information and Emacs
-	setup.
+2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp: Slightly refactor to indirect
+	`putenv` calls through an error-checking wrapper.
+	(xputenv): Add new function to die if `putenv()` fails.
+	(main): Update call sites to use it.
 
-	* src/libs/libgroff/*: Improve the license information and Emacs
-	setup.
+2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	groff: Add information to diagnostic messages.
 
-	* src/libs/libdriver/*: Improve the license information and Emacs
-	setup.
+	* src/roff/groff/groff.cpp (main): Report underlying system
+	error if `putenv()` fails.
+	(handle_unknown_desc_command): Set globals `current_filename`
+	and `current_lineno` from `filename` and `lineno` arguments
+	passed to us to we can use the simpler interface of `error()`
+	rather than `error_with_file_and_line()`.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libbib/*: Improve the license information and Emacs
-	setup.
+	libgroff: Update return type of `font::load_desc` function to
+	enable more informative diagnostics from callers.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/include/font.h (font::load_desc): Change return type from
+	`bool` to `const char` pointer.
+	* src/libs/libgroff/font.cpp (font::load_desc): Return null
+	pointer literal on failed `open()` or validation failures.
+	Return filespec on success.
 
-	* src/libs/gnulib/*: Improve the license information and Emacs
-	setup.  The former run of that was not yet complete.
+	* src/libs/libdriver/input.cpp (do_file):
+	* src/preproc/grn/main.cpp (getres):
+	* src/roff/groff/groff.cpp (main):
+	* src/roff/troff/input.cpp (main): Compare `font::load_desc()`
+	return value to null pointer literal instead of treating it as a
+	Boolean.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp (main): Report full filespec of
+	troublesome "DESC" file when complaining of missing "postpro"
+	directive.
 
-	* src/libs/gnulib/*: Improve the license information and Emacs
-	setup.
+2022-06-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/groff/groff.cpp: Add new Boolean global,
+	`need_postdriver`, and initialize it true.
+	(main): Make `need_postdriver` false if the `-X` or `-Z` options
+	are given.  Test it later.  This prevents groff from exiting
+	with a fatal error if an output driver is not available, but
+	also not required.  Also reorder null pointer equality
+	comparison to avoid inadvertent lvalue assignment.
 
-	* src/include/*: Improve the license information and Emacs setup.
+	Fixes <https://savannah.gnu.org/bugs/?62640>.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grotty/*: Improve the license information and Emacs
-	setup.
+	* src/roff/groff/groff.cpp (help): Revise usage message for
+	expressiveness and clarity.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	* src/devices/grops/*: Improve the license information and Emacs
-	setup.
+	gropdf: Correct display of pathnames used.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* font/devpdf/util/BuildFoundries.pl: Convert array to
+	string of pathnames.
 
-	* src/devices/gropdf/*: Improve the license information and Emacs
-	setup.
+2022-06-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	gropdf: Fix to gropdf.
 
-	* src/devices/grolj4/*: Improve the license information and Emacs
-	setup.
+	* src/devices/gropdf/gropdf.pl: If pdfbookmark was called
+	within 5p of top of page (e.g. straight after a .bp when
+	\nnl was zero) the click destination would be off by a
+	page.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-19  Ingo Schwarze <schwarze@openbsd.org>
 
-	* src/devices/grolbp/*: Improve the license information and Emacs
-	setup.
+	* font/devpdf/devpdf.am: Always build PDF font description
+	files.
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Build font/devpdf/download and the various TR, TB, CR etc.
+	files in the same directory even when they are not required
+	by the build because USE_GROPDF is unset, usually because
+	ghostscript is either unavailable or deliberately disabled
+	by the person running the build.  These files need to be
+	built and installed anyway, and can be used on the target
+	system when the required infrastructure is available at run
+	time.
 
-	* src/devices/grohtml/*: Improve the license information and Emacs
-	setup.
+2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	docs: Revise introduction of vertical spacing concept to avoid
+	render inference that the formatter will compute a vertical
+	spacing appropriate to the type size automagically--it will not.
 
-	* src/devices/grodvi/*: Improve the license information and Emacs
-	setup.
+	Fixes <https://savannah.gnu.org/bugs/?62617>.  Thanks to Dave
+	Kemper for the report.
 
-2014-09-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/*.man: Improve the license information (definiton of .co and
-	.au).
+	docs: Revise discussion of end-of-sentence detection.
 
-2014-09-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/groff.texi (Filling):
+	* man/roff.7.man (Concepts): Do it.  "Spaces" is a now a term
+	with a much more restricted usage.  Emphasize the input context,
+	now explicitly identified as plain text files with Unix line
+	endings.
 
-	* m4/*.m4: Improve the license information without changing the
-	related information.
+	Fixes (one hopes) <https://savannah.gnu.org/bugs/?62593>.
+	Thanks to Ingo Schwarze for the report and Dave Kemper for the
+	discussion.
 
-2014-09-06  Werner LEMBERG  <wl@gnu.org>
+2022-06-10  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	Fix build issues.
+	gropdf: Changes to BuildFoundries.
 
-	* m4/groff.m4: Fix typo.
-	s/refer_dir/referdir/ for consistency.
+	* font/devpdf/util/BuildFoundries.pl: Collect search paths into
+	an array rather than a colon delimited string, this allows
+	the @PATH_SEPARATOR@ character (':' or ';') to be used to
+	delimit paths yielded by the command 'gs -h' but still use ':'
+	to delimit paths in the Foundry file. This means the same
+	Foundry file can be used on all systems.
 
-	* configure: Regenerated.
+	* font/devpdf/Foundry.in: Add more likely paths to find the URW
+	fonts.
 
-	* Makefile.in: s/refer_dir/referdir/ for consistency.
+2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/refer/Makefile.sub (install_data, uninstall_sub):
-	Don't handle binaries or manpages; this is handled elsewhere
-	already.  Right now, only install and uninstall the `refer' data
-	directory.
+	build: Weaken dependency on TeX, instead using it (to generate
+	the DVI and PDF forms of our Texinfo manual) only if it is
+	available.
 
-2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_USE_TEX_CHECK): Check for presence of 'tex'
+	executable in path.  Set shell variable `groff_use_tex` to "yes"
+	if present, and "no" otherwise.  This check runs only if the
+	'makeinfo' and 'texi2dvi' version checks have already passed.
 
-	* configure: When I change the `configure' file manually, the
-	refer data dir is created.  But when running aclocal/autoreconf,
-	the dir is again not created.
+	* configure.ac: Run the new check.  Set Automake conditional
+	`USE_TEX` only if shell variable `groff_use_tex` is "yes".
+	Report whether "groff.dvi" and "groff.pdf" are (re-)buildable.
 
-2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/doc.am: Parameterize names of groff.{dvi,pdf} targets as
+	Make macros `GROFF_DVI` and `GROFF_PDF`.  Define them only if
+	`USE_TEX`.  Do _not_ update `EXTRA_DIST` macro; leave the
+	literal file names there because we require that distribution
+	archives contain these files.
+	(.texi.dvi, .texi.pdf): Update suffix rules to check `USE_TEX`
+	and fail, complaining of missing 'tex' program, if these targets
+	are attempted without it being true.  Only manually specifying
+	the file names as targets to 'make' or attempting to generate a
+	distribution archive without TeX present should cause these
+	errors.
 
-	* m4/groff.m4, configure.ac, Makefile.in,
-	src/preproc/refer/Makefile.sub: Add information to create a refer
-	data directory by installing.  That dir is not yet generated
-	anyway.
+	* INSTALL.REPO: Update dependency information.
 
-2014-09-05  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?62592>.  Thanks to Deri
+	James for the report.
 
-	Regenerate configure files with correct parameters.
+2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* configure.ac: Comment out m4 macros still missing.
+	* doc/doc.am (.texi.dvi, .texi.pdf, $(DOC_GNU_EPS)): Quote names
+	of programs when aborting because they're missing.
 
-	* aclocal.m4, config.hin, configure: Regenerated.
+2022-06-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PROG_MAKEINFO, GROFF_PROG_TEXI2DVI):
+	Largely revert commit d5013ededc, 21 May: run checks for
+	'makeinfo' and 'texi2dvi' programs regardless of presence of
+	".tarball-version" file.  Their presence is a necessary (but not
+	sufficient) condition for refresh of formatted forms of our
+	Texinfo manual if the source is modified.
 
-	* some files in doc: Change the copying years to package form.
-	But many files have strange or no copying information.
+	Begins addressing <https://savannah.gnu.org/bugs/?62592>.
 
-2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/pic2graph/Makefile.sub: Change the copying years to
-	package form.
+	build: Rename some groff Autoconf macros to better match
+	Autoconf's own naming conventions.
 
-2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_MAKEINFO): Rename to...
+	(GROFF_PROG_MAKEINFO): ...this.
+	(GROFF_TEXI2DVI): Rename to...
+	(GROFF_PROG_TEXI2DVI): ...this.
 
-	* FDL: Replace the changed actual file by the original `fdl.txt'
-	from <http://www.gnu.org/licenses/>.
+	* configure.ac:
+	* m4/groff.m4 (GROFF_TEXI2DVI): Update call sites.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/grap2graph/Makefile.sub: Remove `Last updates' from all
-	files.  Add and repair copyright.  Write Emacs setup.
+	* tmac/an.tmac (SH, SS, B, I, SM, SB): Set input trap with `it`
+	instead of `itc` for better Unix Version 7 man(7) compatibility.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?51468>.  Also see
+	discussion at
+	https://lists.gnu.org/archive/html/groff/2022-06/msg00020.html
+	et sequentia (amid a vigorous bikeshedding of `\&`'s name).
 
-	* src/preproc/refer/refer.man: Include more distances for better
-	reading of the source file.  Add `%' for documentation of
-	bibliographic database lines.
+2022-06-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	man: Regression-test use of input traps.
 
-	* tree contrib/eqn2graph: Remove `Last updates' from all files.
-	Add and repair copyright.  Write Emacs setup.
+	* tmac/tests/an_use-input-traps-correctly.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tree `arch': Remove `Last updates' from all files.  Add
-	and repair copyright.  Write Emacs seetup.
+	* src/devices/gropdf/gropdf.pl (LoadDesc): Validate device
+	description file for essential directives and acceptable values
+	as grops(1) does.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* <groff top source directory>: Remove `Last updates' from all
-	files.  Only `timestamp' values are left.
+	troff, grohtml, grops, grotty: Update wording of diagnostic
+	messages to refer to "motion quantum" rather than "resolution"
+	where appropriate.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/devices/grohtml/post-html.cpp
+	(html_printer::html_printer):
+	* src/devices/grops/ps.cpp (ps_printer::ps_printer):
+	* src/devices/grotty/tty.cpp (tty_printer::set_char)
+	(tty_printer::add_char, tty_printer::end_page):
+	* src/roff/troff/env.cpp (line_length, title_length): Do it.
+
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl: Do more "DESC" file validation.
+	(LoadDesc): Bomb out gracefully if any of "unitwidth", "res", or
+	"sizescale" missing from "DESC" file.  This prevents Perl
+	warnings about use of uninitialized values, and undoubtedly
+	mangled output.
+
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl: Revise diagnostic message
+	handling.
+	(top level): Add new scalar `progname` to house executable name.
+	(Msg): Output messages in format recommended by GNU Coding
+	Standards manual.  Identify who's talking (Savannah #52463).
+	Rename `lev` scalar to `fatal` since it is used only as a
+	Boolean for immediately exiting with failure status.  Report
+	diagnostic severity as part of message.
+	(Warn, Die): Add new subroutines through which all diagnostics
+	are now emitted.
+	(top level): Migrate a use of Perl `die` builtin to our `Die`.
+	(top level, ToPoints, LoadDownload, LoadDesc, do_x, GetPoints,
+	LoadSWF, LoadPDF, LoadStream, BuildStream, ParsePDFHash,
+	LoadFont, GetType1, GetChunk, RemapChr, do_N): Migrate `Msg(0,
+	...)` calls to `Warn` and `Msg(1, ...)` to `Die`.  Begin
+	messages in lowercase (GNU Coding Standards).  Recast a few
+	messages for clarity.
+
+	Continues the long process of fixing Savannah #52463.
+
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl (Load_Config): Drop unused
+	subroutine and its commented-out call site, which came in that
+	way in July 2011.
+
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl (LoadFont): Warn if a font to be
+	embedded in PDF output cannot be located in the "download" file.
+
+	Fixes <https://savannah.gnu.org/bugs/?62572>.  Thanks to Deri
+	James.
+
+2022-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/a4.tmac: Drop file from distribution.  It has been
+	superseded by papersize.tmac for nearly 20 years.
+	* tmac/tmac.am (TMACNORMALFILES): Delete reference.
+	* NEWS: Add item.
+
+	Fixes <https://savannah.gnu.org/bugs/?62569>.
+
+2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Parameterize X11-related man pages, so they don't get
+	spuriously generated (and not cleaned) when building with X11
+	support disabled.
+
+	* Makefile.am (.man): Fix logic nit: drop unnecessary removal of
+	target before clobbering it with sed.
+	* src/devices/xditview/xditview.am (GXDITVIEW_MAN1): Add new
+	macro, expanding to nothing if `WITHOUT_X11` and to the target
+	name otherwise.
+	(man1_MANS): Append `GXDITVIEW_MAN1` expansion, not a literal.
+	* src/devices/xditview/xditview.am (XTOTROFF_MAN1): Add new
+	macro, expanding to nothing if `WITHOUT_X11` and to the target
+	name otherwise.
+	(man1_MANS): Append `XTOTROFF_MAN1` expansion, not a literal.
+	* doc/doc.am (GROFF_MAN_PAGES1): Append foregoing expansions
+	instead of literals.
+
+2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac: Add `AM_CONDITIONAL`: `HAVE_URW_FONTS`, so our
+	Automake files can more easily cope with their absence.
+	* font/devpdf/Foundry.in: Add easily matched phrases to
+	comments, to clearly delimit the URW foundry portion of the file
+	so it can be omitted if those fonts are absent.
+	* font/devpdf/devpdf.am (font/devpdf/Foundry): Generate file
+	differently depending on `HAVE_URW_FONTS`; keep the existing
+	procedure if true, and delete the URW section from the generated
+	file otherwise, avoiding diagnostic messages from afmtodit(1)
+	and our BuildFoundries script.
+
+	Fixes <https://savannah.gnu.org/bugs/?62570>.
+
+2022-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries):
+	Generate script using the `PATH_SEPARATOR` Automake macro.
+	* font/devpdf/util/BuildFoundries.pl: Add `pathsep` scalar to
+	house the build-time path separator.
+	(LocateFile): Use it.
+	(LoadFoundry, CheckFoundry): Stop using spaces as part of the
+	path separation delimiter.  It is not idiomatic.
+
+2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac: Explicitly identify poppler tools in report.
+
+2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/util/BuildFoundries.pl: Trivially refactor.  Drop
+	unused hash `foundry`.  Drop scalar `warn` that was set and
+	updated but never tested.
+
+2022-06-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/util/BuildFoundries.pl: Alter script to write to
+	the standard output stream instead of (re)writing a file named
+	"download" in the current working directory.  This recovers from
+	a problem I introduced in commit 6e62be835d, 2 May, as an
+	unforeseen side effect of improving build parallelism so that
+	the "download" file wouldn't be read until it was fully
+	populated.  As a side benefit, this approach is more Unixy, and
+	less dependent on $PWD.
+	(top level): Stop calling `WriteDownload` with an argument.
+	(LoadFoundry): Close only the file handle of interest when done,
+	not all of them (including `STDOUT`, which we now need).
+	(CheckFoundry): Same--just for cleanliness, since at present
+	running the script in 'check' mode doesn't write to any streams.
+	(WriteDownload): Stop taking an argument and manipulating file
+	handles.  Write download file to standard output.
+	(LoadDownload, WriteDownload): Drop `top` scalar, used as a
+	mutex to serialize read and write access to "download" file; it
+	is no longer needed since the "download" file is now only read.
+
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Rename shell variables and Autoconf/Automake macros of
+	Boolean sense to have names more like logical predicates and
+	avoid doofy "DONT" nomenclature.
+
+	* m4/groff.m4 (GROFF_MAKE_RM): Rename shell variable
+	`groff_is_rm_defined` to `groff_make_defines_rm` (purely for
+	clarity; it already had a good name).
+	(GROFF_MAKE_RM): Rename this...
+	(GROFF_MAKE_DEFINES_RM): to this, to make parallelism obvious,
+	and enabling...
+	* configure.ac: ...rename of `MAKE_DONT_HAVE_RM` to
+	`MAKE_DEFINES_RM` with sense of test reversed.  Also interpolate
+	`GROFF_MAKE_DEFINES_RM` instead of `GROFF_MAKE_RM`.  This in
+	turn enables...
+	* Makefile.am: ...revision of conditional from
+	`MAKE_DONT_HAVE_RM` to "!`MAKE_DEFINES_RM`".
+
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_URW_FONTS_PATH)
+	(GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_APPDEFDIR_OPTION)
+	(GROFF_UCHARDET): Recast help strings to more closely parallel
+	structure and style of Autoconf's own help strings.
+	(GROFF_WITH_COMPATIBILITY_WRAPPERS): Recast to tighten wording.
+
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac:
+	* m4/groff.m4 (GROFF_APPDEFDIR_OPTION, GROFF_APPDEFDIR_DEFAULT)
+	(GROFF_APPDEFDIR_CHECK): Rename m4 macros and shell variable
+	from "*appres*" to "*appdef*.  Update interpolation sites.
+
+	* configure.ac:
+	* m4/groff.m4 (GROFF_APPDEFDIR_CHECK): Further rename this...
+	(GROFF_APPDEFDIR_NOTICE): ...to this, for consistency with other
+	post-report output macros.
 
-	* <groff top source directory>: Repair copyright years from
-	starting year to actual year for almost all files.
+	* Makefile.am:
+	* PROBLEMS:
+	* doc/automake.mom:
+	* src/devices/xditview/xditview.am: Update interpolation sites
+	of `appresdir`.
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* Makefile.am:
+	* src/devices/xditview/gxditview.1.man:
+	* src/roff/groff/groff.1.man: Update interpolation sites of
+	`APPRESDIR`.
 
-	* autom4te.cache: Remove that tree after running
-	`autoconf' or `autoreconf'.
+	* NEWS: Add item.
 
-	* .gitignore: Add all files within `autom4te.cache' to get rid of
-	them automatically.  Not sure so far, if this works.
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_X11, GROFF_UCHARDET): Drop redundant
+	messages (which are easily overlooked amid the torrent of
+	"checking" output anyway).  Discovery failures of X11 and the
+	uchardet library are already parts of the configuration report
+	at or near the end of output.
 
-	* BUG-REPORT, FDL, INSTALL*, MANIFEST, MORE.STUFF, NEWS, PROBLEMS,
-	PROJECTS, README*: Remove Emacs settings for coding style.  Change
-	copyright years from 1989-2014 and 1993-2014 into 2014 only.
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PNMTOPS_NOSETPAGE): Partially revert change
+	from 21 May and document why in a comment.
 
-	* configure.ac, Makefile.in: Try to use /usr/local/share directory
-	for `refer'.  Does not work so far.
+2022-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/troffrc: Skip loading of "papersize.tmac" if not in troff
+	mode.
 
-	* All Makefile*: Add Emacs settings and lacking licenses.
+	Fixes <https://savannah.gnu.org/bugs/?62238>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* BUG-REPORT, FDL, INSTALL*, MANIFEST, MORE.STUFF, NEWS, PROBLEMS,
-	PROJECTS, README*: Add Emacs settings.
+	* configure.ac: Report use of "g" prefix for commands and macro
+	package compatibility wrappers.
+	* m4/groff.m4 (GROFF_G): Fix code style nits.  Update
+	indentation to match recent practice.
 
-2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* PROJECTS: Add TODO for `refer'.
+	* configure.ac: Fix code style nits and tweak report.  Stop
+	superfluously using braces for shell parameter expansions that
+	don't require them.  The shell is not make(1).  Say
+	"installation _directory_ prefix" since another kind of prefix
+	can be used by groff (the "g" in front of command and macro
+	package names shared with AT&T troff).
 
-2014-08-31  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-31  Dave Kemper <saint.snit@gmail.com>
 
-	* man/roff.man (roff.7): Replace Heirloom links to more actual
-	places.  Create macro definitions for authors (.au) and copying
-	(.co).
+	* doc/groff.texi: Fix content and style nits.
+	  - Remove redundancy ("fixed-width... character that can't be
+	    adjusted").
+	  - Fix incorrect word ("environment value" -> "environment
+	    variable").
+	  - Add or change the placement of a couple tie{}s to comport
+	    with style-guide recommendation.
+	  - Grammarify.
+	  - Clarify and tighten wording.
 
-2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?62551>.
 
-	* man/groff_font.man (groff_font.7): Restructure
-	file format, but keep content.
+2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/roff/troff/node.cpp (font_position): If mounting a font
+	fails and a third argument was given (to the `fp` request),
+	report its value in the diagnostic message.  This could reveal a
+	prohibited attempt at directory traversal.  See commit
+	a891161bc9, 7 November.
 
-	* src/utils/addftinfo/addftinfo.man (addftinfo.1): Restructure
-	file format, but keep content.
+2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/libs/libgroff/fontfile.cpp (font::open_file): Refactor.
+	Move more logic, including memory allocation, inside conditional
+	that accepts only file names without '/' characters, skipping
+	unnecessary work in the alternative.  Annotate use of zero
+	literals as null pointers to ease any future migration to ISO
+	C++11.  Add 'const' qualifier to variable that doesn't require
+	modification (and which is used in the LHS of an equality
+	comparison, so that clumsy operator misuse will provoke a
+	compiler warning).
 
-	* man/roff.man (roff.7): Repair documentation of heirloom.
+	Fixes <https://savannah.gnu.org/bugs/?62532>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2014-08-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add `gpinyin'.
+	* configure.ac: In configuration report, say that we're
+	reporting compiler options along with the compiler executable.
+	Fix leftover test(1) comparison with garbage, overlooked in
+	commit faa22d89d2, 20 May.
 
-	* src/roff/grog/grog.man: Restructure `SEE ALSO'.
+2022-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/doc.am (doc/meintro_fr.ps): Build with '-t' option.
 
-	* contrib/gpinyin: Make it runnable, version 1.0.0.
+	Fixes <https://savannah.gnu.org/bugs/?62542>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2014-08-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* groff.7 (man/groff.man): Add further preprocessor regions.
-	Repair documentation for Unicode.
+	* src/roff/groff/groff.1.man (Options) <-l>: Handle case where
+	no default print spooler is configured, and report formatter
+	behavior correctly if it isn't.
 
-2014-08-08  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?62535>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	* configure.ac, configure, Makefile.in, m4/groff.m4: Install paths
-	for implementing contrib/gpinyin's sub.pl.
+2022-05-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* Makefile.am (.man): Process '@PSPRINT@' substitutions with
+	"makevarescape.sed".
 
-	* man/groff_char.man: Add description for displaying `uxxxx' as
-	`\uxxxx'.
+2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO, GROFF_TEXI2DVI):
+	Fix logic error in detection of build scenario: the presence of
+	a ".git" directory is not an indicator that we're not building
+	from a distribution archive, because we might be building from a
+	snapshot archive (which also lacks it).  Instead, perform checks
+	required only by builds from Git checkouts and snapshot archives
+	if the ".tarball-version" file is not present.
 
-	* man/groff.man (groff.7): Replace \rs to \e as far as useful.
+2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* Makefile.am (EXTRA_DIST): Ship "HACKING" file.
 
-	* man/groff.man (groff.7): Add documentation for the Unicode
-	escapes \u.... and \u......
+2022-05-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* bootstrap.conf: Add "pkg-config" to `buildreq`.  Not having it
+	causes pretty horrible macro expansion problems and diagnostics
+	when 'autoreconf' is run; they're still pretty bad even if you
+	use `AC_REQUIRE` and `m4_pattern_forbid`.  So just demand it.
 
-	* src/roff/groff/groff.man: Improve documentation for `utf8'.
+2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-08-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* font/devps/S:
+	* font/devps/symbolmap: Drop excess mapping of `*U` special
+	character.  groff maps it to the Adobe Glyph List name
+	'Upsilon1'.  (The AGL 'Upsilon' is a homoglyph of the Latin
+	capital 'Y'.)
+	* PROBLEMS: De-document build-time warning, now resolved.
 
-	* contrib/gpinyin: New preprocessor for having the European-style
-	writing	`pinyin' for the Chinese language.
+2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
+	14.0.  No substantive changes.
 
-	* groff.7 (man/groff.man): Add some useful special characters.
+2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-21  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/utils/afmtodit/make-afmtodit-tables: Refactor.  Drop
+	unused variable `prog`.  Use value of `CPP` from environment (if
+	defined) and use parameter expansion to apply a default if null
+	or not set.  Use for loop to eliminate duplicative if statement.
+	Test input files for readability, not just existence.  Use more
+	portable test(1) and shell syntax.  Swap usage error and fatal
+	error exit statuses; using "1" for failure and "2" for usage
+	errors is more common in shell scripts I've seen.  Update usage
+	message to put non-literal parameter in full caps, and clarify
+	its name.  Update comment blocks written to generated files to
+	further clarify data provenance.
 
-	* tbl.1 (src/preproc/tbl/tbl.man): Add simple examples.
+2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PRINT): Refactor.  Stop performing checks
+	for spooler options if none is available.  Stop redundantly
+	reporting command name used for spooling PostScript files.  If
+	an option is required for spooling DVI files, report it alone
+	instead of repeating the command name as well.
 
-	* groff.7 (man/groff.man): Add section about underlining.
+2022-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-07  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fix insensitivity of groff(1) man page to configured spooler.
 
-	* man/groff.man (groff.7): Add some basic special characters
-	`\(xy'.
+	* Makefile.am (.man): Replace `@PSPRINT@` in man page sources
+	with name of configured print spooler command.
+	* src/roff/groff/groff.1.man (Options) <-l>: Use configured
+	print spooler command instead of literal 'lpr'.
 
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* grog, groffer: Minor repairing.
+	* m4/groff.m4 (GROFF_UCHARDET_CHECK): Fix grammar nit in failure
+	message when user demands uchardet support but the library
+	cannot be located.
 
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Repair ligatures handling.
+	* m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Fix logic error in
+	computation of verb to be used in notice message.
 
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Correct handling of standard input.
+	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_URW_FONTS_CHECK)
+	(GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_UCHARDET_NOTICE):
+	Improve shell code portability.  Per the GNU Autoconf manual,
+	"The -a, -o, '(', and ')' operands are not present in all
+	implementations, and have been marked obsolete by Posix 2008.
+	...portable uses of test should never have more than four
+	arguments, and scripts should use shell constructs like '&&' and
+	'||' instead."
 
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.man: Minor correction.
+	* src/roff/groff/groff.1.man (Installation directories): Don't
+	output a tagged paragraph for the X11 application defaults
+	directory if the build symbol '@APPRESDIR@' is not defined (that
+	is, we didn't build with X11 support).
 
-2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/*: Minor corrections.
+	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Fix code style
+	nits.  Use lowercase for shell variables we define.  Don't quote
+	literal operands to test(1) that don't contain syntactically
+	shell-significant characters.  Update indentation to match
+	recent practice.
 
-2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.cpp: In `usage()' and `help()' order
-	alphabetically.
+	* m4/groff.m4 (GROFF_URW_FONTS_NOTICE): Don't emit the notice if
+	Ghostscript isn't available, since it was a prerequisite for
+	the `GROFF_URW_FONTS_CHECK` macro in the first place.
 
-2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* grog.pl, subs.pl: Heavily improve argument handling and `groff'
-	command line creation.
+	build: Add print spooler determination to configuration
+	report.
 
-2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PRINT): Add shell variable
+	`groff_have_spooler` to house the name of the print spooler
+	{"lp" or "lpr"} or the word "no".
+	* configure.ac: Report determined spooler, or its absence.
 
-	* grog.man: Make file runnable for `doclifter'.
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
+	seekability check of the standard input stream if there is no
+	controlling terminal.
 
-	* grog.man: Replace all .de by copying.  Restrict all .char names
-	to lenght 2 only.
+	Fixes <https://savannah.gnu.org/bugs/?62506>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* grog.man: Minor optimization.
+	* m4/groff.m4 (GROFF_CHECK_GROHTML_PROGRAMS): Migrate from
+	`AC_FOREACH` to `m4_foreach` to avoid obsolescence warning from
+	GNU Autoconf 2.70 or later.
 
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?61059>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	* grog.man: Transform in classical man-page style.
+2022-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* man/groff.7.man: Rename "pilot" list macros for man(7) from
+	`BL`/`EL` to `LS`/`LE`, per suggestion from Alejandro Colomar.
 
-	* grog.pl, subs.pl: Add option `--warnings'.  Rename
-	`--with_ligatures' to `--ligatures', but keep `--with_ligatures'
-	for compatibility.
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_MAKEINFO, GROFF_TEXI2DVI): Check for
+	makeinfo(1) and texi2dvi(1) programs only if building from Git,
+	not a distribution archive.
 
-	* Makefile.in: Remove directories `groffer/perl' and
-	`groffer.shell', which don't exist any more.
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/doc.am (doc/meintro_fr.ps): Call groff with `-K utf8`
+	instead of `-k`, in case the "configure" script didn't find
+	uchardet (and preconv(1) thus can't auto-detect an encoding).
 
-	* PROJECTS: Mention the start of the `ideal' project.
+	Fixes <https://savannah.gnu.org/bugs/?59463>.
 
-2014-06-21  Ingo Schwarze  <schwarze@openbsd.org>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in: Unbreak make install:
-	Add missing gideal dirs to the dist tarball.
+	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Skip
+	a check if /dev/stdin is not a character special device.
 
-2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.man: Correct the collection of the
-	installation directories.
+	* m4/groff.m4 (GROFF_PDFTOOLS): Rename this...
+	(GROFF_POPPLER): ...to this.
+	* configure.ac: Update call site.
 
-2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/groff.man: Add the installation file and
-	directory positions of the whole package with @...@.
+	* m4/groff.m4 (GROFF_UCHARDET_CHECK): Rename this...
+	(GROFF_UCHARDET_NOTICE): ...to this.
+	* configure.ac: Update call site.
 
-2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_UCHARDET_NOTICE): Tighten wording of
+	message reported to user.
 
-	* man/groff.man, src/roff/groff/groff.man: Add file position
-	before and after installation and the latest update.
+	Fixes <https://savannah.gnu.org/bugs/?59481>.  Thanks to Dave
+	Kemper for the report.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/grog.pl: Corrections about `require' and `our'
-	definitions.
+	* m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET)
+	(GROFF_PNMTOPS_NOSETPAGE): Skip check if prerequisite not met.
 
-	* src/roff/grog/subs.pl: In the `groff' output command line, split
-	the single character options collections into different
-	1-character options, each with a leading minus `-'..
-2014-06-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Repair call of `push'.
+	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Rename this...
+	(GROFF_URW_FONTS_NOTICE): ...to this.
+	(GROFF_URW_FONTS): ...and this...
+	(GROFF_URW_FONTS_CHECK): ...to this.
+	(GROFF_URW_FONTS_NOTICE): Give lengthy notice message a one-line
+	summary.
+	* configure.ac: Update call sites.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Minor correction at `do_first_line'.
+	* m4/groff.m4 (GROFF_URW_FONTS): Refactor.  If our prerequisites
+	are not met (availability of 'awk' and 'gs'), don't even run the
+	check logic or print a "checking" message.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Adjust for first lines with non-preproc
-	and not-tmac names to be ignored.
+	Handle missing programs required to construct files needed at
+	runtime by gropdf more gracefully.  Rename and refactor
+	configuration-time logic to be more understandable.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* configure.ac:
+	* m4/groff.m4: Rename `GROFF_PDFDOC_PROGRAMS` macro to
+	`GROFF_CHECK_GROPDF_PROGRAMS`.  Rename shell variable
+	`make_pdfdoc` to `use_gropdf`.  Set it explicitly to "no" or
+	"yes" instead of null or not null.
 
-	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add new first line
-	of roff files with the names of the needed preprocessors and the
-	actual tmac, see 2014-06-17 Ulrich Lauther.  Replace the
-	word `ideal' by `gideal', when the preprocessor is meant.
+	* configure.ac:
+	* m4/groff.m4:
+	* doc/doc.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* configure.ac: Call `GROFF_GROPDF_PROGRAM_NOTICE`.
 
-	* src/roff/grog/Makefile.sub: Add $(RM).
+	* doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_PDF`
+	macro and `$(PROCESSEDDOCFILES_PDF)` dependency declaration in
+	Automake `if USE_GROPDF` conditional.  This prevents attempts
+	to build PDF documents using groff that are doomed to fail.
+
+	* m4/groff.m4: Refactor gropdf runtime-dependency program check.
+	Split into two macros: one (`GROFF_CHECK_GROPDF_PROGRAMS`)
+	performs the check, the other (`GROFF_GROPDF_PROGRAM_NOTICE`)
+	issues a notice at the end of the configuration process if at
+	least one program was not found.  Rename `docnote` shell
+	variable to `gropdf_notice`.  Tighten wording of notice.  Drop
+	unused `make_install_pdfdoc` and `make_uninstall_pdfdoc` shell
+	variables.
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Handle missing programs required at runtime by grohtml more
+	gracefully.  Rename and refactor configuration-time logic to be
+	more understandable.
+
+	* configure.ac:
+	* m4/groff.m4: Rename `GROFF_HTML_PROGRAMS` macro to
+	`GROFF_CHECK_GROHTML_PROGRAMS`.  Rename shell variable
+	`make_htmldoc` to `use_grohtml`.  Set it explicitly to "no" or
+	"yes" instead of null or not null.
 
-	* src/roff/grog/grog.pl: Remove call to perl_test.pl.  `require
-	5.6;' is enough as Perl test.
+	* configure.ac:
+	* m4/groff.m4:
+	* doc/doc.am: Rename `BUILD_HTML` to `USE_GROHTML`.
 
-	* src/roff/grog/perl_test.pl: Remove this file.
+	* configure.ac: Call `GROFF_GROHTML_PROGRAM_NOTICE`.
 
-2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/doc.am: Bracket definition of `PROCESSEDDOCFILES_HTML`
+	macro and `$(PROCESSEDDOCFILES_HTML)` dependency declaration
+	in Automake `if USE_GROHTML` conditional.  This prevents an
+	attempt to build an HTML version of the "pic.ms" document that
+	is doomed to fail (noisily).
 
-	* ChangeLog: Add Emacs-mode and a separator for the license.
+	* m4/groff.m4: Refactor grohtml runtime-dependency program
+	check.  Split into two macros: one
+	{`GROFF_CHECK_GROHTML_PROGRAMS`} performs the check, the other
+	{`GROFF_GROHTML_PROGRAM_NOTICE`} issues a notice at the end of
+	the configuration process if at least one program was not found.
+	Rename `html_docnote` shell variable to `grohtml_notice`.
+	Tighten wording of notice.  Drop unused `make_install_htmldoc`
+	and `make_uninstall_htmldoc` shell variables.
 
-2014-06-17  Ulrich Lauther  <ulrich.lauther@t-online.de>
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* grog: Invent new first comment line of roff files with long
-	names of needed preprocessors and the tmac.
+	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add newline at
+	end of buggy Ghostscript notification, so that the multiple
+	possible lengthy notices after the configuration report have
+	blank lines separating them.
 
-2014-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: Correct handling of option `-J' for
-	ideal.
+	Check for m4 program at configuration time.
 
-2014-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PROG_M4): Define new macro to perform the
+	check and error out if the program is missing.
+	* configure.ac: Call the new macro.
+	* tmac/tmac.am (tmac/groff_man.7.man)
+	(tmac/groff_man_style.7.man): Use the new implicitly AC_SUBST-ed
+	variable `M4` to run the program.
 
-	* src/roff/groff/groff.cpp, src/roff/groff/pipeline.h,
-	* src/roff/grog/subs.pl: Add `groff' option `-J' for `gideal'.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_PROG_YACC): Update wording of error
+	message: we search for "yacc", so report it as missing if it is
+	not found (along with "byacc" and "bison").
 
-	* src/roff/grog/subs.pl: Remove too early listing of 3 `groff'
-	preprocessors options: gideal, glilypond, gperl.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* configure.ac: Fix shell style nits.  Get rid of string
+	{non-}nullity tests and comparisons involving concatenation with
+	garbage (usually "x").  See 13 November entry regarding m4.  Use
+	idiomatic shell "brace style" for control structures.
 
-	* contrib/gideal: New project for installing `ideal' for `groff'.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in: Add `gideal' for `OTHERDIRS'.
+	Trivially refactor libgroff allocator configuration.
 
-2014-06-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Update description of
+	configuration flag to clarify that it's implemented in a
+	library.  Rename shell variable to prefix it with "groff_",
+	putting it in an ad hoc name space as with other variables.  If
+	feature disabled, set variable to literal "no".
+	* configure.ac: Use renamed variable and interpolate it directly
+	into configuration report, simplifying shell logic.
 
-	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Repair argument
-	handling for output `groff' line.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* configure.ac: Revise configuration report for intelligibility.
+	Add report of C++ compiler and flags used: we compile much more
+	C++ than C code so this seems appropriate.  Report Perl
+	interpreter version so that we can collect build reports and
+	turn the ratchet past Perl 5.6.1 at some point.  Fix X11
+	"resources" misnomer (application defaults are what is meant).
+	Rephrase generally.
 
-	* src/roff/grog/grog.pl, src/roff/grog/grog.man: Correct and add
-	the documentation for filespec options.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* Makefile.am (EXTRA_DIST): Ship "ChangeLog.122" in distribution
+	archive.  Overlooked in commit c11995df16, 19 February 2021.
 
-	* src/roff/grog/subs.pl: Activate handling of `--run', such that
-	now the generated `groff' command line can run.
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+	Fix portability problem: POSIX says that "od -c" (and "od -t c")
+	are supposed to emit printing characters as defined by the
+	underlying locale, but GNU coreutils od doesn't do this and
+	macOS od does.  Set `LC_ALL` to "C" when running it to force
+	3-digit octal reporting of characters with their eighth bit set.
 
-	* src/roff/grog/subs.pl: Repair handling of filespec arguments.
+	Fixes <https://savannah.gnu.org/bugs/?62357>.  Thanks to John
+	Gardner for the report.  Also see <https://pubs.opengroup.org/\
+	onlinepubs/9699919799/utilities/od.html>.
 
-2014-06-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add testing
-	methods of Ralph Corderoy's `grog.sh' of 2006.  Add primary usage
-	of file name extensions.
+	* INSTALL.extra (In Case of Trouble): Add advice on using the
+	test suite, particularly if it fails.
 
-2014-06-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?62478> (one hopes).
 
-	* src/roff/grog/grog.pl: Totally rewrite the `grog' version,
-	starting at the last stable version.  Write many parts as `sub'
-	functions.
+2022-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/subs.pl: New file by splitting the src file
-	`grog.pl', such that all functions get into the new file
-	`subs.pl'.
+	* doc/groff.texi (Input Line Traps):  Expand discussion.  The
+	`it` and `itc` requests count neither input lines (strictly) nor
+	text lines.  Instead, they count input lines that _directly
+	produce formatted output_ (and, in the case of `itc`, are not
+	"interrupted" or continued with the `\c` escape sequence).  This
+	is useful--empty requests and requests that don't put nodes on
+	the output don't break things--but does demand some explanation.
+	Clarify and provide example.
+	* man/groff.7.man (Escape sequence short reference) <it>: Sync.
 
-	* src/roff/grog/Makefile.sub: Add file `subs.pl', which goes into
-	the `grog' libdir.
+2022-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-03  James Cloos  <cloos@jhcloos.com>
+	* src/roff/troff/env.cpp (environment::choose_breakpoint): Tweak
+	diagnostic message ("can't" -> "cannot").
+	* doc/groff.texi (Breaking): Update example.
 
-	* src/roff/grog/grog.pl: The errors with `ligatures' come also
-	from `TeX GYRE' fonts.  Print this information, when `grog' should
-	work with the `pdf' device.
+2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/groff.texi (Copy Mode):
+	* man/groff.7.man (Copy mode): Fix omission; `\?` is interpreted
+	in copy mode.
 
-	* src/roff/grog/grog.pl: The `grog' version of yesterday has many
-	bugs.  So reinstall an old version of `grog'.
+2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/s.tmac (PT): Unclutter name space; remove
+	`pg*saved-page-number-format` string when we're done with it.
 
-	* src/roff/grog/Makefile.sub: Remove changing of first line
-	`#! ...'.
+2022-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+	tbl: Add unit tests, including one XFAIL for bad behavior.
 
-	* src/roff/grog/grog.pl: Remove `$Sp' mostly.  Reorder script.
-	Check and repair requests.  Add final character `$' to many
-	checked requests.
+	* src/preproc/tbl/tests/check-horizontal-line-length.sh:
+	* src/preproc/tbl/tests/check-line-intersections.sh:
+	* src/preproc/tbl/tests/check-vertical-line-length.sh:
+	* src/preproc/tbl/tests/table-lacks-spurious-top-border.sh: Do
+	it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run tests.
+	(tbl_XFAIL_TESTS, XFAIL_TESTS): Expect one test failure.
 
-2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/roff.man: Move .TH at the beginning.
+	* src/devices/grotty/tty.cpp (tty_printer::add_char): Modify
+	diagnostic message: what gets written "above the first line"
+	might not be a character (glyph) per se, but a line (rule) from
+	a drawing command, and in fact the occurrence of these from
+	boxed tables is the most common cause of this message I've seen.
+
+2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grotty: Do more input validation.
+
+	* src/devices/grotty/tty.cpp (tty_printer::draw): Throw warning
+	if an unsupported geometric primitive is encountered.
+	(tty_printer::line): Throw warning if a line is diagonal.  Die
+	if length of a horizontal or vertical line is not a multiple of
+	the appropriate motion quantum of the device (troff should never
+	emit such nonsense, and currently doesn't appear to).
+
+2022-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/tbl.1.man (Miscellaneous): Document GNU tbl's
+	use of `#T` and `T.` registers.
+
+2022-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_color_draw_node): Tweak
+	diagnostic message to better distinguish drawing commands and
+	device control commands.
+
+2022-05-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Mitigate double-free problem exposed by malformed
+	input.
+
+	* src/roff/troff/mtsm.h (struct statem): Place member variable
+	`issue_no` behind `DEBUGGING` preprocessor symbol, omitting it
+	from production and ordinary development builds.
+	* src/roff/troff/mtsm.cpp (no_of_statems): Place global variable
+	behind `DEBUGGING` preprocessor symbol, omitting it from
+	production and ordinary development builds.
+	(statem::statem): Make constructor trivial if `DEBUGGING` not
+	defined in preprocessor; it manipulates only `issue_no` and
+	`no_of_statems`, which are synchronized.
+	(statem::statem {copy}): Gate assignment of `issue_no` member
+	variable from copy constructor behind `DEBUGGING` preprocessor
+	symbol.
+	(statem::flush, mtsm::inherit): Gate debugging output, already
+	runtime-gated on `debug_state` symbol, of `issue_no` member
+	variable, so that we don't reference it when it is not declared.
+
+	See <https://savannah.gnu.org/bugs/?62040>.
+
+2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	refer: Rename a test artifact; it's a bibliographic database
+	file, not a refer(1) command file.
+
+	* src/preproc/refer/tests/artifacts/62124.ref: Rename this...
+	* src/preproc/refer/tests/artifacts/62124.bib: ...to this.
+	* src/preproc/refer/refer.am (EXTRA_DIST):
+	* src/preproc/refer/tests/report-correct-line-numbers.sh: Use
+	new name.
+
+2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/command.cpp (process_commands): Begin
+	migration to use existing global variables for location reports
+	in diagnostic messages.  Save current file name and line number
+	before calling `command_loop()` and restore them afterward.
+	Also decrement line counter before entering that loop because it
+	would be too far advanced by one due to the final newline on a
+	parsed input line.
+
+2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.cpp (main): Report system error on
+	`fflush()` failure.  POSIX Issue 5 a.k.a. SUSv2 (1997) specifies
+	several possible `errno` values this C standard library function
+	can set; see
+	<https://pubs.opengroup.org/onlinepubs/007908799/xsh/fflush.html>.
+
+2022-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	refer: Refactor: drop unused version of function (taking only
+	a `const char *` parameter).
+
+	* src/preproc/refer/command.cpp (process_commands): Drop
+	definition.
+	* src/preproc/refer/command.h (process_commands): Drop
+	declaration.
+
+2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.cpp (do_file): Fix another off-by-one
+	line number reporting bug exposed by fix for Savannah #62391.
+
+2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/tests/report-correct-line-numbers.sh: Add
+	more regression tests.
+
+2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	refer: Trivially refactor: boolify.
+
+	* src/preproc/refer/command.cpp (input_stack::push_file): Demote
+	and rename local variable from `int` to `bool`.
+	(bol): Renamed from this...
+	(is_at_beginning_of_line): ...to this.
+
+2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	refer: Trivially refactor.
+
+	* src/preproc/refer/command.cpp (input_stack::push_file):
+	* src/preproc/refer/refer.cpp (do_file): Drop unnecessary
+	construction of integer from integer (return type of `getc()`)
+	in argument to error diagnostic functions; parallelizes with
+	other diagnostic function calls.
+
+2022-05-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/command.cpp: Refactor to simplify.
+	(get_location): Demote return type from `int` to `void`.  The
+	function only ever returned a `1` literal.
+	(input_stack::error): Update call site to stop uselessly testing
+	return value of `get_location()`.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
+	logic error.  When checking both source and build trees for
+	files to copy, break after successfully copying the files, not
+	after the first iteration of the loop unconditionally.  This
+	caused the Info documents not to be installed from out-of-tree
+	builds, and potentially would prevent them and doc/gnu.eps from
+	being included in the distribution archive if for some reason
+	they didn't build and that build failure were not treated as an
+	error.  Problems introduced by me in commits e78bd20d54, 27
+	March, and d79c3f3a4a, 11 November.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_APPRESDIR_OPTION): Update comments and
+	human-readable output to (1) stop claiming that existing
+	gxditview application defaults in the installation directory
+	will be backed up; this is no longer true as of commit
+	c66cb7725f, 3 April; and (2) refer to these files as
+	"application defaults", not "resources".  (X11 application
+	defaults are client-side and mandatory for Xt-based programs;
+	X resources are stored server-side and need not be configured to
+	determine an X client's geometry and rendering.)
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devX100-12/devX100-12.am (devX100_12_fontdir):
+	* font/devX100/devX100.am (devX100_fontdir):
+	* font/devX75-12/devX75-12.am (devX75_12_fontdir):
+	* font/devX75/devX75.am (devX75_fontdir): Define macros without
+	an extra "font/" layer in the directory hierarchy.
+
+	Fixes problem introduced by me in commit 3c82cbbfe5, 27
+	February.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries): Spell
+	dependency on `$(SH_DEPS_SED_SCRIPT)` using that macro expansion
+	instead of a literal file name.  See doc/automake.mom.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/eqn/eqn.am (MAINTAINERCLEANFILES):
+	* src/preproc/pic/pic.am (MAINTAINERCLEANFILES):
+	* src/preproc/refer/refer.am (MAINTAINERCLEANFILES): Preserve
+	byacc/bison output artifacts unless "maintainer-clean"ing.  Per
+	the GNU Automake manual, "The intermediate files generated by
+	yacc (or lex) will be included in any distribution that is made.
+	That way the user doesn’t need to have yacc or lex."
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Stop manually handling "test-groff".  Per the
+	GNU Automake manual, "If configure built it, then distclean
+	should delete it."  This is taken care of automatically if we
+	don't interfere.
+	(BUILT_SOURCES, MOSTLYCLEANFILES): Drop "test-groff".
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/eqn/eqn.am (neqn): Produce temporary file first
+	and set its permissions before moving it into place.  If
+	anything in the future ever has a dependency on it, this avoids
+	a race where the file exists, satisfying a dependency, but
+	execution is attempted before its `x` permission bit is set.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Ensure that we install *.me source files, but don't
+	include them in the distribution archive.
+
+	* doc/doc.am (dist_otherdoc_DATA): Move `$(GENERATEDDOCFILES)`
+	from here...
+	(nodist_otherdoc_DATA): ...to here.
+	(.PRECIOUS): Add `$(GENERATEDDOCFILES)` so that make(1) doesn't
+	automatically remove "intermediate" objects in the .me.in -> .me
+	-> .ps chain.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Handle "gnu.eps" file better.
+
+	* doc/doc.am (GENERATEDDOCFILES): Remove `$(DOC_GNU_EPS)`.
+	(EXTRA_DIST): Ship `$(DOC_GNU_EPS)` in distribution archive.
+	($(DOC_GNU_EPS)): Simplify rule commands; stop trying to copy
+	the file around since it will either be (1) in the distribution
+	archive from which a build is performed; or (2) missing because
+	a build is being done from Git, in which case we expect the PNM
+	tools to be available.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (clean_otherdoc): Drop target: it doesn't seem to
+	accomplish anything.
+	(clean_infodoc): Drop target, moving its rules into...
+	(maintainer-clean-local): ...this.  Drop deps, both gone now.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (distclean-local): Drop target: stop cleaning
+	generated forms of our Texinfo manual with the "distclean"
+	target.  They ship with the distribution archive and should
+	remain in the tree even if the user needs to re-./configure.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Fix problems exposed by high build parallelism.
+
+	* font/devpdf/devpdf.am (font/devpdf/util/BuildFoundries)
+	(font/devpdf/DESC, font/devpdf/Foundry): Drop
+	unnecessary removal of target prior to creating it.
+	(font/devpdf/Foundry): Add creation of destination build
+	directory as other targets do.
+	(font/devpdf/download): Create dedicated target instead of
+	lumping its generation under the stamp file.  Add missing
+	dependencies on `$(DEVPDFFONTMAP_1)`, `$(DEVPDFFONTMAP_2)`,
+	`font/devpdf/Foundry` and `font/devpdf/enc/text.enc`.  Remove
+	now-unnecessarily complicated "forgery" of "GEN" line in quiet
+	builds.  Tweak format of comment written to "download" file to
+	make field identities clearer.  Construct output (with multiple
+	shell commands) in temporary file so it is not read prematurely
+	by the "BuildFoundries" script.  Move target into place as the
+	last step.
+	(font/devpdf/stamp): Relocate target to follow its dependencies.
+	Add dependency on "font/devpdf/download".
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Tweak diagnostic messages in BuildFoundries script.
+
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry)
+	(WriteDownload, CheckFoundry): Recast for specificity and
+	consistent style.
+	(Die): Stop reporting line number with fatal errors; none of the
+	call sites are parsing input.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	refer: Fix off-by-one error in line number for some
+	diagnostics.
+
+	* src/preproc/refer/command.cpp (input_item::get_location):
+	Decrement reported line number by one after looping over input
+	so that we report the line number as it was before the last
+	newline character seen.  This off-by-one error was partially
+	masked by...
+	* src/preproc/refer/refer.cpp (do_file): ...initialization of
+	`current_lineno` to zero.  However, for syntax problems (as
+	opposed to the semantic problems of refer(1) command
+	processing), this could result in complaints about the line
+	number before they occurred, even on "line zero".  Initialize
+	the variable to 1.
+
+	Fixes <https://savannah.gnu.org/bugs/?62391>.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/tests/report-correct-line-numbers.sh: Add
+	regression test for Savannah #62391.
+
+2022-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/tfmtodit/tfmtodit.cpp (usage): Tweak usage message.
+	Condense `-v` and `--version` into a single output line with
+	brace and pipe notation, which we do not use in our man pages,
+	but consistently do in our usage messages.  Use lowercase for
+	option arguments since they are separated from option flag
+	letters by space.  Call `fprintf()` once instead of 3 times.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.cpp (main): Tweak wording of
+	diagnostic messages to refer to options consistently and to
+	characterize input as "invalid" rather than "bad".
+	(usage): Document --version option.  Use more informative
+	metasyntactic variable names.  Organize usage message
+	consistently with our others, and stop wrapping the output
+	lines: we know neither the width of the terminal nor the length
+	of the `program_name` string we're interpolating.  See commit
+	b4de44f0, 19 July 2021.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (string_iterator::backtrace): Fix
+	spurious output when `mac.filename` is empty.  Provoked by:
+	  $ printf '\\(' | troff -b
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.cpp: Trivially refactor.  Demote
+	global variable `recognize_R1_R2` from integer to Boolean.
+	(main, do_bib): Give expressions to `assert()` meaningful
+	content.
+	(is_list): Demote return type from `int` to `bool`.
+	(do_file): Demote and rename integer local variables
+	`start_of_line` to Boolean `at_start_of_line`.
+	(is_list, do_file): Reorder equality comparisons to avoid
+	inadvertent lvalue assignment.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Reduce and rationalize in-tree document dependencies.
+	This eliminates spurious rebuilds of numerous documents
+	{including the 380+-page groff-man-pages collections}.  It also
+	fixes missing dependencies when using the build's groff to
+	generate PostScript documents.
+
+	* .gitignore: Drop old name of devpdf stamp file.
+	* doc/.gitignore: Drop now-unused "example.stamp" file.
+	* doc/doc.am (PROCESSEDDOCFILES_HTML, PROCESSEDDOCFILES_PDF)
+	(PROCESSEDDOCFILES_TXT): Add new macros grouping targets by the
+	format/output driver used to produce them, to better organize
+	dependencies for their generation.
+	(PROCESSEDDOCFILES): Redefine as simply the expansions of the
+	foregeoing.
+	(PROCESSEDFILES_DEPS_HTML, PROCESSEDFILES_DEPS_HTML,
+	PROCESSEDFILES_DEPS_PDF, PROCESSEDFILES_DEPS_TXT): Add new
+	macros defining prerequisites for production of the
+	corresponding output document formats.
+	($(PROCESSEDDOCFILES_HTML), $(PROCESSEDDOCFILES_PDF),
+	$(PROCESSEDDOCFILES_PS), $(PROCESSEDDOCFILES_TXT)): Declare the
+	dependencies using expansions of the foregoing macros.
+	(MOSTLYCLEANFILES): Drop "doc/automake.pdf", now part of
+	`PROCESSEDDOCFILES_PDF`.
+	(doc/automake.pdf): Drop dependencies already supplied by
+	`PROCESSEDFILES_DEPS_PDF`.
+	(HTMLDOCFILES): Drop macro.  "doc/pic.html" is now in the
+	expansion of `PROCESSEDDOCFILES_HTML`.
+	(htmlpic_DATA): Redefine as expansion of
+	`PROCESSEDDOCFILES_HTML` instead of `HTMLDOCFILES`.
+	(PROCESSEDEXAMPLEFILES_HTML) BUILD_HTML: Define as
+	"doc/webpage.html", otherwise as empty.
+	(PROCESSEDEXAMPLEFILES_PS): Contain "doc/webpage.ps" and
+	"doc/grnexampl.ps".
+	(PROCESSEDEXAMPLEFILES): Redefine as expansions of
+	`PROCESSEDEXAMPLEFILES_HTML` and `PROCESSEDEXAMPLEFILES_PS`.
+	($(PROCESSEDEXAMPLEFILES_HTML), $(PROCESSEDEXAMPLEFILES_PS)):
+	Declare dependencies using `PROCESSEDFILES_DEPS_HTML` and
+	`PROCESSEDFILES_DEPS_PS`, respectively.
+	(HTMLEXAMPLEFILES): Drop macro.  "doc/webpage.html" is now in
+	the expansion of `PROCESSEDDOCFILES_HTML`.
+	(nodist_htmlexamples_DATA): Drop macro, no longer needed.
+	($(PROCESSEDDOCFILES_PS)): Relocated and redefined above.
+	($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES)): Drop overbroad
+	dependency declarations in favor of the above.
+	(MOSTLYCLEANFILES, doc/examples.stamp): Drop generation and
+	removal of unnecessary stamp file.
+	(doc/pic.html, doc/webpage.html): Add explicit dependency on
+	required preprocessors.  Drop redundant and spurious
+	dependencies.
+	* font/devhtml/devhtml.am (MOSTLYCLEANFILES)
+	(font/devhtml/stamp): Generate and remove stamp file to enable
+	reliable target dependencies for build-time generation of HTML
+	documents by groff.
+	* font/devpdf/devpdf.am (MOSTLYCLEANFILES, font/devpdf/stamp):
+	Rename stamp file from "font/devpdf/build_font_files".
+	(font/devpdf/stamp): Drop unnecessary dependency on "afmtodit".
+	* font/devps/devps.am (MOSTLYCLEANFILES, font/devps/stamp):
+	Generate and remove stamp file to enable reliable target
+	dependencies for build-time generation of PostScript documents
+	by groff.
+	* font/devutf8/devutf8.am (MOSTLYCLEANFILES)
+	(font/devutf8/stamp): Generate and remove stamp file to enable
+	reliable target dependencies for build-time generation of
+	UTF-8-encoded text documents by groff.
+
+	Fixes <https://savannah.gnu.org/bugs/?62084>; thanks to
+	Sergei Trofimovich for the report.  Also fixes
+	<https://savannah.gnu.org/bugs/?62297>; thanks to Bjarni Ingi
+	Gislason for the report.
+
+2022-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Fix code style nits in Automake files.
+
+	* doc/doc.am: Put spaces around (Auto)make variable assignments,
+	for consistency with the rest of this .am file, and our others.
+	* font/devpdf/devpdf.am (font/devpdf/build_font_files): Use
+	shell '>' operator instead of touch(1).
+	* font/devhtml/devhtml.am (font/devhtml/DESC):
+	* font/devps/devps.am (font/devps/DESC): Construct target in
+	temporary file, since doing so is a multi-step process, moving
+	it to the target name when it is complete and usable by
+	dependencies.
+
+2022-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.cpp (main): When complaining of
+	unrecognized option, report the entire option string (after
+	the leading dash), not just its first character.
+
+2022-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/error.cpp: Trivially refactor.  Explicitly
+	compare pointer lvalues to null pointers instead of punningly
+	treating them as Booleans.  Annotate use of zero literals as
+	null pointers to ease any future migration to ISO C++11.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (an*abbreviate-inner-footer): Clean up better
+	before early returns.  Remove temporary registers.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/fallbacks.tmac: Add fallbacks for U+02C6 MODIFIER LETTER
+	CIRCUMFLEX ACCENT and U+02DC SMALL TILDE to Basic Latin
+	characters.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Fix portability problem.  Don't pass echo(1) arguments
+	containing backslashes because implementations handle them
+	differently.  Use printf(1) instead.  Thanks to Bertrand
+	Garrigues for reporting the problem and confirming the fix on
+	his build host.
+
+	* tmac/tests/e_chapter-titles-work.sh:
+	* tmac/tests/e_ld-works.sh:
+	* tmac/tests/localization-works.sh: Do it.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl (ppsz): Recognize "com10" (U.S.
+	commercial envelope) paper format.
+
+	Addresses the original issue reported in
+	<https://bugs.debian.org/1009248>.  We have however broadened
+	its scope; see <https://savannah.gnu.org/bugs/?62344>.
+
+2022-04-27  Dave Kemper <saint.snit@gmail.com>
+
+	* src/devices/gropdf/gropdf.pl (ppsz): Recognize ISO B-series
+	paper formats using strings of the form "b0-b6", not "isob0-b6",
+	for consistency with libgroff and papersize.tmac.
+
+	Fixes <http://savannah.gnu.org/bugs/?62346>.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor to simplify.  Ingo's removal of the
+	"--with-doc" "configure" option, among other changes, clears the
+	way to remove many phony targets and simplify dependencies
+	involving generation of the 5 formats of our Texinfo manual.
+	(build_infodoc, doc, doc_all, doc_txt, dvi, doc_dvi, pdf,
+	doc_pdf, html, doc_html): Drop phony targets.
+	(all): Depend directly on doc/groff.{info,txt,html,dvi,pdf}.
+	* NEWS: Add item since "make doc" is no longer necessary and
+	will do nothing.
+
+2022-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Handle `\R` sequences in text blocks robustly.
+
+	* src/preproc/tbl/table.cpp (table::add_entry): Fix SEGV when
+	repeating glyph table entry syntax (`\Rx`) used in a text block.
+	Lift extraction of entry string to be done unconditionally,
+	rather than in 5 different special cases.  This frees us up to
+	rewrite the entry if necessary, changing '\R' to '\&' inside a
+	text block.  Recast diagnostic to describe the problem
+	clearly--"bad repeated character" suggests that something is
+	wrong with the "argument" to `\R`, when really the problem is
+	the _context_.
+
+	Fixes <http://savannah.gnu.org/bugs/?62366>.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Regression-test Savannah #62366.
+
+	* src/preproc/tbl/tests/\
+	do-not-segv-when-backslash-R-in-text-block.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/string.cpp (string::extract): Check return
+	value of `malloc()` for nullity, and only poke into the buffer
+	returned if it is valid.  Discovered while troubleshooting
+	Savannah #62366.
+
+2022-04-23  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	gnulib: replace non-recursive-gnulib-prefix-hack with
+	automake-subdir option
+
+	'non-recursive-gnulib-prefix-hack' is deprecated by gnulib's
+	commit f8eed11b15e9141d061900e4068ea1f3ba9b63f6 and replaced by
+	'--automake-subdir'.
+
+	* bootstrap.conf:
+	(gnulib_modules): Remove option
+	'non-recursive-gnulib-prefix-hack'.
+	(gnulib_tool_option_extras): Add option '--automake-subdir'.
+	(bootstrap_post_import_hook): Remove the invocation of
+	'build-aux/prefix-gnulib-mk'.
+
+	* doc/automake.mom: update documentation accordingly.
+
+	Fixes <http://savannah.gnu.org/bugs/?61708> and
+	<https://savannah.gnu.org/bugs/?62205> , issues reported and fix
+	suggested by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>.  Fix
+	also suggested by Werner LEMBERG <wl@gnu.org> (see
+	<https://repo.or.cz/ttfautohint.git/commit/a938fc63cb55ef48393a924d7083b13c1352d294>).
+
+2022-04-23  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update gnulib submodule
+
+	* gnulib now points on c8b8f3bbcde37a53cd226f4c9cebd0dde6aca37f
+
+	* bootstrap: merge the latest version from gnulib/build-aux
+	{groff's bootstrap has a patch for OS X}.
+
+	* bootstrap.conf: update copyright date.
+
+2022-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (XH-UPDATE-TOC): Modify Keith Marshall's new XN/XH
+	feature to indent TOC entries by section heading depth.  The
+	increment is 2 ens per depth level.
+
+2022-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (XA): Drop apparently useless `ll` request.  It
+	doesn't do anything according to my tests.
+
+2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/label.ypp: Drop redundant declaration of
+	`yyparse`.  Both byacc 20140715 and GNU Bison 3.3.2 supply the
+	the function prototype themselves.  Addresses
+	"-Wredundant-decls" warning from GCC.
+
+	Fixes <https://savannah.gnu.org/bugs/?43569>.
+
+2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/grn/hdb.cpp (DBGetType): Lower fatal diagnostics
+	to errors when encounting invalid element type characters.
+	Return a value interpreted by our caller as an error indication
+	instead.  Helps compilers determine that we're not implicitly
+	falling through our cases.  Addresses "-Wimplicit-fallthrough"
+	warnings from GCC.
+
+	Fixes https://savannah.gnu.org/bugs/?54702>.
+
+2022-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/grn/hdb.cpp (DBRead): Add more validity checking.
+	Verify that the number of conversions returned by fscanf() is as
+	expected instead of throwing this information away--abort
+	processing ("giving up" like pic(1) does) if it does not.
+	Consistently report this abandonment in diagnostic messages.
+	Similarly validate pointer returned by fgets().  Soften handling
+	of invalid text condition from fatal error, introduced in
+	commit eb4f0675e, 16 August, to a normal one with abandonment of
+	Gremlin file.  Addresses "-Wunused-result" warnings from GCC.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/grn/main.cpp (conv): Throw an error diagnostic
+	when failing to open a Gremlin picture file.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix extraneous space in output after `ME` or `UE` when
+	mandoc wrapper is used.
+
+	* tmac/an-ext.tmac (UE, ME): Double backslashes in macro
+	definitions when interpolating `.$` register (just like we tell
+	everyone else to do).  This one was interesting to track down.
+	When using just `-man`, the problem never manifested; only with
+	`-mandoc`.  The difference is that with the former, the `.$`
+	register is initialized to zero; with the latter, because `TH`
+	is aliased to another macro (then unaliased), `.$` has the
+	argument count to the `TH` macro, not to the macros actually
+	being called.  This caused the wrong branch of a conditional to
+	be taken and put an extra space node on the output.
+
+	Fixes <https://savannah.gnu.org/bugs/?62044>.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/cp1047.tmac:
+	* tmac/latin1.tmac:
+	* tmac/latin2.tmac:
+	* tmac/latin5.tmac:
+	* tmac/latin9.tmac: Stop remapping input soft hyphen characters
+	with `tr` requests in character encoding macro files.  The
+	formatter does this for us now.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Translate 8-bit NBSP and SHY on input.
+
+	* src/roff/troff/input.h: Define constant integers for "input"
+	no-break spaces and soft hyphens for EBCDIC and non-EBCDIC
+	(presumably ASCII/ISO 8859/Unicode) systems.
+
+	* src/roff/troff/input.cpp (token::next): Translate the input
+	character codes for NBSP to \~ and SHY to \%.
+
+	Fixes <https://savannah.gnu.org/bugs/?58962>.  Thanks to Dave
+	Kemper for the report, code review, and his suggestion to push
+	more work to compile time.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff: Regression-test Savannah #58962.
+
+	* src/roff/groff/handle_special_input_code_points.diff: Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2022-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_if_request): Clarify diagnostic;
+	at the point it is thrown, we know not merely that we're in a
+	conditional expression, but processing an output comparison
+	operator.
 
-2014-05-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff.man: In special characters, add the mentioning of the
-	`groff' writing `\xy'.
+	* doc/groff.texi:
+	* doc/ms.ms:
+	* man/groff.7.man: Characterize "roff language" in the singular,
+	not the plural, emphasizing the similarity of extant specimens.
+
+	* doc/groff.texi (Conventions Used in This Manual): Add
+	paragraph discussing denotations of "groff" and "roff".
+
+	Fixes <https://savannah.gnu.org/bugs/?62233>.  Thanks to John
+	Gardner and Dave Kemper for the discussion.
+
+2022-04-12  Ingo Schwarze <schwarze@openbsd.org>
+
+	Delete the harmful, ill-designed, buggy, and essentially
+	unmaintained and untested --with-doc option of the configure
+	script.
+
+	* configure.ac: Delete five AM_CONDITIONAL variables, one
+	autoconf(1) macro call, and some related diagnostic output.
+	* doc/doc.am: Delete two BUILD_EXAMPLES and one BUILD_OTHERDOC
+	conditional and use BUILD_HTML instead of BUILD_HTMLEXAMPLES.
+	* m4/groff.m4: Delete the GROFF_DOC_CHECK macro and simplify the
+	macros GROFF_HTML_PROGRAMS, GROFF_INSTALL_INFO, GROFF_MAKEINFO,
+	and GROFF_PDFDOC_PROGRAMS.  This also deletes more than thirty
+	configuration variables.
+	* Makefile.am: Delete comments about 16 variables that are no
+	longer set.
+	* NEWS: Add details regarding the rationale.
+
+2022-04-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/preconv/preconv.cpp (unicode_entity): Convert
+	input U+00A0 to \~ as troff would, not to \u00A0.
+
+	Fixes <https://savannah.gnu.org/bugs/?62300>.
+
+2022-04-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf fails to deal with 255th glyph in font.
+
+	* src/devices/gropdf/gropdf.pl: a pdf font can only contain 255
+	glyphs. The array which holds the glyph names also holds the
+	start position (zero) as first element, it is legal for it to
+	contain 256 elements, so truncate to 256 (not 255).
+
+	Fixes <https://savannah.gnu.org/bugs/?62294>.
+
+2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	localization: Define hyphenation mode registers for Japanese
+	and Chinese.  They are set to zero but must be defined so that
+	macro packages can rely on their existence without causing 'reg'
+	warnings.
+
+	* tmac/ja.tmac:
+	* tmac/zh.tmac: Do it.
+
+2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Add test for multi-lingual man(7) scenario.
+
+	* tmac/tests/localization-works.sh: Test two more cases.  Ensure
+	that the 'trap bit' (hyphenation value 2, which has nothing to
+	do with any language) is preserved when switching locales back
+	from a CJK language, since those languages' modes
+	unconditionally clear it.  We test Japanese and Chinese; we have
+	no localization macro file for Korean at this time.
+
+2022-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Slightly refactor `an*abbreviate-inner-footer`.
+
+	* tmac/an.tmac (an*abbreviate-inner-footer): Discard
+	unnecessary string.
+
+2022-04-09  Ingo Schwarze <schwarze@openbsd.org>
+
+	Fix the configuration of texi2dvi.
+
+	* m4/groff.m4: Set groff_have_texi2dvi if texi2dvi(1) is
+	available and usable, even if the availability was specified by
+	the user by manually providing the configure variable
+	PROG_TEXI2DVI, and not only if it was autodetected.
+	Also, set the PROG_TEXI2DVI Makefile variable to the name of
+	the texi2dvi program specified by the user or autodetected,
+	and not to the string "found", such that this Makefile variable
+	can be used for invoking the program.
+	* doc/doc.am: Call the texi2dvi program specified by the user
+	or autodetected rather than hardcoding "texi2dvi".  This lets
+	the groff build succeed on systems where the first texi2dvi
+	in the $PATH is an old version unfit for groff's purposes.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Abbreviate long `TH` arguments more carefully.
+
+	* tmac/an.tmac: Do it.
+	(an*scan-string-for-backslash): Add new helper macro.
+	(an*abbreviate-inner-footer): Rewrite.  Use the foregoing and a
+	different technique to compute available space and shorten the
+	string.
+
+	Fixes <https://savannah.gnu.org/bugs/?62257>.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Add regression test for Savannah #62257.
+
+	* tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh:
+	Do it.
+	* tmac/tmac.am (tmac_TESTS): Run it.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Trivially refactor.  Rename strings `an-ifoot`
+	to `an*ifoot` and `an-outer-footer-text` to `an*ofoot`.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Refactor.  Abbreviate page title and inner
+	footer only once per document instead of once per page.
+	Exception: the legacy macros `AT` and `UC` change the inner
+	footer, so re-abbreviate it if they are called.
+	(TH, AT, UC): Call abbreviation macros from here...
+	(an-header, an-footer): ...instead of here.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Refactor: initialize header/footer environment
+	only once.  Also rename it to `an*env-header-and-footer`.
+	(TH): Do it here...
+	(an-header, an-footer): ...instead of here.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Trivially refactor.
+	(an*prepare-page-title): Rename this...
+	(an*abbreviate-page-title): ...to this.
+	(an-prepare-inner-footer): And this...
+	(an*abbreviate-inner-footer): ...to this.
+	(an-header, an-footer): Update call sites.
+
+2022-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/eqn/other.cpp (hmotion_box::output): Fix typo in
+	generated MathML diagnostic message.
+
+2022-04-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (EXTRA_DIST): Add "groff.dvi" and "groff.pdf" to
+	ensure that the GNU-released groff distribution archive contains
+	our Texinfo manual in these formats.  (This doesn't increase the
+	build-dependency requirements unless you want to "make dist", in
+	which case it _should_.)
+
+2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Add nroff mode fallback for `UL` macro.
+
+	* tmac/s.tmac (UL): On nroff devices, bracket the first argument
+	with \(ul (underline rule) special character escape sequences.
+	{In plain language, '.UL "like this"' renders "_like this_".}
+	See corresponding 12 February change to "tmac/e.tmac".
+
+2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Drop unnecessary `-I` options to groff.
+	(DOC_GROFF): There is no need to look at the top of the build
+	directory for any file inclusions.
+	(doc/webpage.html): There is no need to look in `doc_builddir`
+	for file inclusions, since that is the current working directory
+	when "webpage.ms" is processed.
+
+2022-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Trivially refactor.  Use `RM` macro idiomatically.
+	Automake ensures that it is defined to call an `rm` command with
+	the `-f` option, and this in turn ignores failures to delete
+	nonexistent files, so...
+	(uninstall_doc_examples, uninstall-pdf): Stop adding superfluous
+	`-f` flag.
+	(clean_infodoc uninstall-pdf, uninstall-html): Stop prefixing
+	command with `-` to ignore error exit status.
+	(uninstall-html): Drop superfluous `-r` flag; we're only
+	deleting files with this command, not directories.
+
+2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Trivially refactor shell style in rule commands.
+	The placement of `&&` was inconsistent.  Always begin a
+	continued rule line with it, and don't give it its own
+	indentation level.  In general, operators adjacent to line
+	continuations should _follow_ the continuations because they are
+	easier for humans to spot at the (possibly indented) beginning
+	of a physical line.
+
+2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Rename `TFLAG` macro, which means "tmac flag", to
+	`MFLAG`, because it expands to `-M` options to groff, not the
+	`-T` option, which can be bewildering.
+	* doc/doc.am (DOC_GROFF): Update expansion site.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Rename `DOC_GROFF_ONLY` to `DOC_GROFF`.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor.  Drop ghastly hack used to get file
+	names into troff diagnostics when reading from standard input.
+	We've refactored so that it no longer does, making the hack
+	unnecessary.  For the same reason, no users of the `DOC_GROFF`
+	macro remain, so delete it.  Add comments to explain what
+	`DOC_SED` and `DOC_GROFF_ONLY` are for.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor.
+	(doc/pic.html, doc/webpage.html): Drop indirection of source
+	document through `DOC_SED` macro.  It was not necessary since
+	neither of these documents are parameterized in configuration
+	options (that is, they don't contain @VERSION@ or @g@).
+
+2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Trivially refactor.
+	(doc/webpage.html): Tidy up dependency list.  Create directory
+	using the same macro interpolation we use to change into it.
+
+2022-04-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor and fix error in builds in remote
+	out-of-source-tree builds exposed by pending commit and `make
+	distcheck`.  The images generated for the pic.html and
+	webpage.html files were being built in the wrong directory, and
+	subsequently not found by an install rule.
+	(imagedir): Add comment explaining purpose of macro.  It should
+	_not_ be used with any file specifications relative to the
+	source or build trees--it is for installation directories only.
+	(htmldocimagedir, exampleimagedir): Drop macros.
+
+	(doc/pic.html, doc/webpage.html): Replace interpolations of
+	`imagedir` with literal "img", since these files are being
+	generated within the build tree: the directory name is known.
+
+	(mostlyclean_doc, install_doc_htmldoc, install_doc_examples):
+	Replace interpolations of `htmldocimagedir` relative to
+	`doc_builddir` with "img" literals.
+
+	(install_doc_htmldoc, uninstall_doc_htmldoc): Interpolate
+	concatenation of `htmldocdir` and `imagedir` instead of
+	`htmldocimagedir` (relative to `DESTDIR`).
+	(install_doc_examples, uninstall_doc_examples): Interpolate
+	concatenation of `exampledir` and `imagedir` instead of
+	`exampleimagedir` (relative to `DESTDIR`).
+
+2022-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor.  Relocate "doc/grnexampl.ps" target to
+	group it with other me(7) documents.  Put addition of
+	"doc/examples.stamp" to `MOSTLYCLEANFILES` adjacent to its
+	target rule.  Relocate same rule so that it precedes the target
+	depending on it (make(1) might not benefit from this, but human
+	readers can).
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor.
+	(DOC_GROFF_ONLY): Drop preprocessor options from groff command.
+	This macro is now, simply, a way to run the in-tree groff: no
+	assumptions about preprocessors, macro packages, or output
+	device are made.
+	(doc/pic.html, doc/webpage.html): Add only necessary
+	preprocessor options after expansion of `DOC_GROFF_ONLY`.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor.  Add explicit dependencies of compiled
+	man page documents on preprocessors needed to generate them.  In
+	their target rules, explicitly use groff's preprocessor options,
+	freeing us up to simplify the `DOC_GROFF_ONLY` macro.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Rationalize dependencies.  Drop dependency of
+	`PROCESSEDEXAMPLEFILES` and `PROCESSEDDOCFILES` on expansion of
+	`hdtbltmac_DATA`, because nothing in this directory uses the
+	hdtbl package.  Move dep of same expansions on "gnu.eps" to
+	"doc/webpage.html", which actually uses it.  Put the numerous
+	dependencies of "doc/pic.html" and "doc/webpage.html" in a
+	parallel ordering so that they are easier for humans to
+	evaluate.  These targets' dependencies on `bin_PROGRAMS` and
+	`prefixexecbin_PROGRAMS` are overkill and should be reviewed at
+	a later date.
+
+2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Refactor use of target and suffix rules.
+	(doc/meintro.me, doc/meintro_fr.me, doc/meref.me): Add target
+	rules, with lengthy, exasperated comment about lack of feature
+	parity in various make(1) implementations.
+	(doc/meintro_fr.ps): Add target rule, as this seems to be the
+	only way to keep GNU Make from ignoring a '_fr.me._fr.ps' suffix
+	rule in favor of '.me.ps', which doesn't call preconv (and
+	doesn't need to--and moreover we don't want to build English
+	me(7) documents with the `-mfr` option).  Depend on `preconv`.
+	(doc/webpage.ps): Convert from suffix rule to target rule.
+	(doc/ms.ps, doc/pic.ps, doc/webpage.ps): Add target rules and
+	dependencies.
+	(.ms.ps): Add commented-out suffix rule (since nothing uses it,
+	but might in the future).
+	(doc/meintro_fr.ps, .me.ps, doc/pic.ps, doc/webpage.ps): Migrate
+	expansions of `DOC_GROFF` to `DOC_GROFF_ONLY` to prepare for a
+	forthcoming simplification.
+
+2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Clean generated doc files better.  doc/me*.me were
+	getting left behind in the build tree.
+	(MOSTLYCLEANFILES): Add `GENERATEDDOCFILES`.  This includes
+	`DOC_GNU_EPS`, so...
+	(clean_maintdoc): Drop phony target that manually removes it.
+	(maintainer-clean-local): Drop dependency on foregoing.
+
+2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/xditview/xditview.am (install_xditview)
+	!WITHOUT_X11: Stop backing up existing "GXditview" and
+	"GXditview-color" application defaults files.  There is no
+	symmetric restoration of them in the uninstall target, and it
+	seems like unjustifiable complexity to add such.  These are
+	groff-specific file names, installed (by default) to /usr,
+	not /etc, so they are not going to be "configuration files" in
+	Debian-based systems, for example (and likely not elsewhere).
+	There are other ways to supersede application defaults for
+	programs using the X Toolkit Intrinsics.
+
+2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Stop treating "gnu.eps" as an "example" file; it
+	is also used by pdfmark's cover.ms, which is ordinary
+	documentation.  We therefore must not omit it when building.
+	(install-data-hook): Add dependency on new phony target,
+	"install_doc_gnu_eps".
+	(install_doc_examples): Move installation of "gnu.eps" from
+	here...
+	(install_doc_gnu_eps): ...to here.  Also refactor the loop we
+	use to locate the file to follow a more idiomatic pattern.
+
+2022-04-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (dist-info-bits, install_infodoc, dist-gnueps): Fix
+	code style nit: use consistent "brace style" in conditionals and
+	loops.
+
+2022-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (mostlyclean_doc): When cleaning, try harder to
+	remove the image directory created by the "pic.html" and
+	"webpage.html" targets.
+
+2022-04-02  Ingo Schwarze <schwarze@openbsd.org>
+
+	* doc/doc.am: Stop installing doc/meintro.me.in,
+	doc/meintro_fr.me.in, and doc/meref.me.in.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/webpage.ms: Die horribly if `PSPIC` call fails.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/pspic.tmac (pspic*error-hook): Define (as empty).
+	* man/groff_tmac.5.man (Auxiliary packages) <pspic>: Document.
+	* NEWS: Add item.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (doc/webpage.ps): Relocate target rule.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Remove output file
+	even when skipping test.  Quote `fail` variable when checking it
+	with `test -z`.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_tmac.7.man (Auxiliary packages): Tweak sboxes
+	documentation to imply ms dependency.
+
+	Fixes <https://savannah.gnu.org/bugs/?62062>.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (an*bookmark): Trivially refactor.  Now that
+	we're no longer doing arithmetic on our first argument, simplify
+	our definition.  Made possible by commit 3baf0e2f3, 23 February.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Demote
+	an error diagnostic to a debugging message.  libuchardet has no
+	man page, and inspecting the source of the
+	`uchardet_handle_data` function we find that it effectively
+	returns a Boolean value (if the result of a
+	`reinterpret_cast`(!) is not `NS_OK`).  This is useless
+	information for a user-facing tool.  We're designed to muddle on
+	regardless (see preconv(1)).
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
+	(draw_dvi_printer::fill_next):
+	* src/devices/grops/ps.cpp (output::put_color):
+	* src/libs/libgroff/color.cpp (color::print_color): Construct
+	doubles instead of casting to them.
+
+2022-03-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	doc: Refactor handling of "gnu.eps" file.
+
+	* doc/doc.am: Put "gnu.eps" in a Make macro, `DOC_GNU_EPS`.
+	($(PROCESSEDEXAMPLEFILES) $(PROCESSEDDOCFILES),
+	doc/webpage.html, install_doc_examples): Migrate dependency to
+	`DOC_GNU_EPS`.
+	(doc/webpage.ps): Add (missing) dependency on `DOC_GNU_EPS`.
+	(DOC_GROFF_ONLY): Drop `-I` flag; it's not necessary given the
+	following.
+	(.ms.ps): Drop `-mwww` argument from suffix rule.  A truly
+	generic ms document won't need it.
+	(doc/webpage.ps): Add target rule.  Include `-mwww` argument.
+	(doc/webpage.ps, doc/webpage.html): Pass `-I` option to
+	`DOC_GROFF` and `DOC_GROFF_ONLY` (respectively) to enable
+	location of "gnu.eps" file.  Search the build and source trees'
+	"doc" directories because the file can be generated as part of
+	the build or can come with the distribution archive.
+	(EXTRA_DIST): Drop redundant inclusion of "doc/gnu.xpm".
+	(clean_maintdoc): Add phony target to dispose of `DOC_GNU_EPS`.
+	(maintainer-clean-local): Depend on "clean_maintdoc".
+
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: Update tests to look
+	for "gnu.eps" in "doc" directory of build tree.  Give generated
+	files distinguishable names so their tests can run concurrently.
+
+2022-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Add new macro `PROCESSEDDOCFILES_PS` to isolate
+	names of targets in PostScript format.  Expand this macro in
+	definition of `PROCESSEDDOCFILES` and use it to move PostScript
+	font description file dependencies of the latter and
+	`PROCESSEDEXAMPLEFILES` to the former.  (At present, the
+	dependency might seem superfluous, since those files are in the
+	source distribution, but it's conceivable that in the near
+	future, they will be produced at build time from Adobe font
+	metric files; see font/devps/generate/Makefile).  The "pic.html"
+	and "webpage.html" targets already had such a dependency because
+	of the way grohtml (pre-grohtml) works.
+
+2022-03-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* INSTALL.extra: Add a section on uninstalling.
+
+2022-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Create target rule for "doc/grnexampl.ps" instead
+	of relying on a suffix rule.  Explicitly depend on grn and eqn
+	executables.  Produce output using their groff flags, "-ge".
+
+2022-03-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/pdfpic.tmac (PDFPIC): Fix breakage when no temporary
+	directory environment variables are defined: actually use string
+	interpolation syntax in comparand to output comparison
+	operator.  Problem introduced by me in commits adc1999af and
+	24900cf6d, 15 February.
+
+2022-03-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devX100-12/devX100-12.am:
+	* font/devX100/devX100.am:
+	* font/devX75-12/devX75-12.am:
+	* font/devX75/devX75.am: Fix in-tree build; expand `fontdir`
+	instead of `abs_top_builddir` Make macro when defining Automake
+	variable for generated artifacts.  Problem introduced by me in
+	commit 3c82cbbfe, 27 February.  Thanks to Robert Goulding for
+	the report.
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* doc/doc.am: delete redundant "SUFFIXES +=" line
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* doc/doc.am: fix non-portable syntax in the meintro_fr.ps
+	target: This rule requires DOC_GROFF and hence $<, so turn it
+	into a suffix rule.
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* doc/doc.am: fix non-portable syntax in the doc/me*.me targets:
+	POSIX does not define the meaning of $< in non-suffix rules, so
+	use the portable $? instead.  This is adequate here because each
+	of these three rules has exactly one prerequisite.
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* doc/doc.am: fix non-portable syntax in the groff-man-pages.*
+	targets by using DOC_GROFF_ONLY rather than DOC_GROFF in order
+	to not use $< outside a suffix rule; DOC_GROFF functionality is
+	not needed here in the first place.
+
+2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac:
+	* tmac/doc.tmac: Stop remapping input hyphens on `utf8` device.
+
+2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/doc.tmac: Stop remapping ` and ' on `utf8` output device.
+	Aligns mdoc(7) with commit 697e6db7f, 19 October 2020 (for
+	man(7)).
+
+2022-03-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Fix bug introduced in commit
+	0d451902c, 10 March.  Don't store a newline in the version
+	string.  Put `\n` in its interpolation context as necessary.
+
+2022-03-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Install ptx.tmac.
+
+	* tmac/tmac.am (TMACNORMALFILES): Add it.
+	* NEWS: Report availability.
+
+	Fixes <https://savannah.gnu.org/bugs/?62201>.  Thanks to Ralph
+	Corderoy for the report.
+
+2022-03-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Drop ditroff(7) document.  It says nothing that is not covered
+	elsewhere.
+
+	* man/ditroff.7.man: Delete.
+	* doc/doc.am (GROFF_MAN_PAGES):
+	* man/man.am (man7_MANS, EXTRA_DIST): Stop processing, shipping.
+	* src/roff/groff/groff.1.man: Drop cross reference to it.
+	* NEWS: Add item.
+
+	Fixes <https://savannah.gnu.org/bugs/?61817>.
+
+2022-03-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	preconv: Trivially refactor.
+
+	* src/preproc/preconv/preconv.cpp: Use diagnostic message
+	functions from libgroff where possible.  Explain in a comment
+	why we don't use `debug()`.  Boolify and rename some variables,
+	and use Boolean literals to assign to them.
+	  debug_flag         -> is_debugging
+	  invalid_warning    -> emit_invalid_utf8_warning
+	  incomplete_warning -> emit_incomplete_utf8_warning
+	Rename `expected_bytes` to `expected_byte_count`.  Except for
+	the debugging flag, these are all members of `struct
+	conversion`.
+	(get_tag_lines): Migrate to `warning()`.
+	(detect_file_encoding): Migrate to `error()` and `fatal()`, as
+	appropriate.
+	(utf8::invalid, utf8::incomplete, get_tag_lines): Don't break a
+	line in the middle of a diagnostic; doing so frustrates grepping
+	and necessarily makes an assumption about the terminal width.
+
+2022-03-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Trivially refactor.
+
+	* src/roff/troff/input.cpp: Rename global variable
+	`have_string_arg` to `have_multiple_params` and demote it from
+	an integer to a Boolean.  Assign Boolean literals to it.
+	(read_long_escape_parameters, get_copy, token::next): Do it.
+
+2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Fix Savannah #62191.
+
+	* src/preproc/tbl/main.cpp (table_input::get): Increment input
+	line counter when encountering an escaped newline; this fixes
+	inaccurate diagnostics from the formatter at any point in a
+	document after a line-continued row of table data.  Also drop a
+	"perhaps" comment.  I tested the surmise (setting the FSM state
+	to "START"), and it results in bad formatting.
+
+	Fixes <https://savannah.gnu.org/bugs/?62191>.  Problem appears
+	to date back to groff 1.02 (June 1991) at the latest.
+
+2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Regression-test Savannah #62191.
+
+	* src/preproc/tbl/tests/count-continued-input-lines.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2022-03-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Environments): Clarify environment handling.
+	* man/groff.7.man (Environments): Add new section.
+
+	Fixes <https://savannah.gnu.org/bugs/?62036>.  Thanks to Dave
+	Kemper for the report and a suggested patch.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (initialization): Define `@b` as empty if
+	formatting for HTML, because no page breaks occur in that
+	format.
+
+	Fixes <https://savannah.gnu.org/bugs/?62039>.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grodvi/dvi.cpp (usage): Align usage message with
+	man page; disclose `-l` option.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grodvi/dvi.cpp (main):
+	* src/devices/grops/ps.cpp (main): Update diagnostic:
+	characterize bad `-w` argument as "invalid", not "bad", and
+	explicitly report it as ignored.
+
+	* src/devices/grodvi/dvi.cpp (main): Report invalid parameter
+	in `-w` diagnostic.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grodvi/dvi.cpp (dvi_printer::set_color)
+	(draw_dvi_printer::fill_next):
+	* src/devices/grops/ps.cpp (output::put_color):
+	* src/libs/libgroff/color.cpp (color::print_color): Explicitly
+	cast `enum` divisors to `double`; quietens
+	`-Wdeprecated-enum-float-conversion` warnings.
+
+	Fixes <https://savannah.gnu.org/bugs/?61964>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Recover more quickly from missing `EE` calls.
+	(initialization): Define new strings, `an*body-family` and
+	`an*example-family` to house the font families used in these
+	rendering contexts.
+	(TH, SH, SS): Restore the font family to `an*body-family`.
+	(TH): Set font style to roman as well.
+	(EX): Change to `an*example-family` instead of literal "C".
+
+	Fixes <https://savannah.gnu.org/bugs/?62187>.
+
+2022-03-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Test register for existence before using it to
+	set hyphenation mode.  A site troffrc or other local
+	customization might remove the register (which is guaranteed to
+	be set under the stock configuration) and, perversely, Heirloom
+	Doctools troff interprets a `do` request, instead of ignoring it
+	as a historical troff implementation would, so if they borrow
+	our me(7) changes, the register would be unset, interpolate
+	zero, and hyphenation would wind up disabled.
+
+	Fixes <https://savannah.gnu.org/bugs/?62181>.  Thanks to Dave
+	Kemper for the report.
+
+2022-03-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Rename test to apply naming scheme.
+
+	* tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Rename this...
+	* tmac/tests/pdfpic_falls-back-to-PSPIC.sh: ...to this.
+	* tmac/tmac.am (tmac_TESTS): Use new name.
+
+2022-03-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grops/ps.cpp (usage): Align usage message with man
+	page synopsis.
+
+2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Input Line Traps): Fix error; input traps do
+	_not_ ignore control lines.  Error appears to have crept in with
+	the first version of our Texinfo manual, shipped with groff 1.14
+	{December 1999}.
+
+2022-03-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devps/devps.am: Rename targets.
+	(fonts):
+	(devps_fonts): Rename these...
+	(maintainer-font-descriptions):
+	(devps_font-descriptions): ...to these.  Add comments explaining
+	what they're for and why they aren't used in a build.
+
+	* font/devps/generate/Makefile: Add `outdir` variable to store
+	destination directory of font description files, and update all
+	targets that write artifacts to use this directory.  This makes
+	the targets "phony", which I don't regard as a problem since the
+	generated artifacts are kept under source control, and this
+	isn't really a user-facing script (even though it gets
+	installed).  I think there is a good chance that this will
+	become a shell script, because to avoid regressions we need to
+	generate the font descriptions using both the 229-glyph and
+	314-glyph versions of the Adobe fonts' AFM files (so that we get
+	wider glyph coverage _and_ more kerning pair data) and we need
+	to add kerning information for the ellipsis (Savannah #58897).
+	(symbolsl.afm): Revise generation process to be sensitive to
+	failure.
+
+2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devps/symbolsl.afm: New file.
+	* font/devps/devps.am (EXTRA_DIST): We have long shipped
+	"symbol.afm" with the distribution archive--I don't see why we
+	don't ship "symbolsl.afm" and "zapfdr.afm" as well (metrics for
+	`SS`, the slanted symbol font, and ZDR, reversed Zapf Dingbats).
+	Like the Type 1 font descriptions themselves, this file is
+	updated only in "maintainer mode", not as part of the build.
+	Moreover, these fonts are not part of the PostScript level 2
+	base 35 fonts so their AFM files are unlikely to be readily
+	available elsewhere.
+
+2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Trivially refactor.  Store the
+	program's version string in scalar `afmtodit_version` and use
+	that in the usage message and comment embedded in the output.
+
+2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Fix code style nits.  Migrate
+	to the shebang line style we use in more recently modified Perl
+	scripts.  Replace `-w` with `use warnings;`.  Shorten an output
+	comment since the groff version string can grow long (see commit
+	1264531310, 14 January 2018).
+
+2022-03-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Stop writing full file name to
+	the generated font description file as the "name" (i.e., don't
+	include directory components).
+
+	Fixes <https://savannah.gnu.org/bugs/?62150>.  Thanks to Dave
+	Kemper for the discussion and code review.
+
+2022-03-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.1.man:
+	* src/utils/afmtodit/afmtodit.pl: Update and align man page
+	synopsis, option descriptions, and command usage output.
+
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/X.tmac: Redirect `fchar` requests for \lq and \rq to
+	\dq since the X11 Type 1-based text fonts encode ISO 8859-1
+	{Latin-1} and don't have typopgrapher's quotes.  Drop `fchar`
+	request for \aq, which _is_ represented, per recent changes.
+
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* /font/devX100-12/CB:
+	* /font/devX100-12/CBI:
+	* /font/devX100-12/CI:
+	* /font/devX100-12/CR:
+	* /font/devX100-12/HB:
+	* /font/devX100-12/HBI:
+	* /font/devX100-12/HI:
+	* /font/devX100-12/HR:
+	* /font/devX100-12/NB:
+	* /font/devX100-12/NBI:
+	* /font/devX100-12/NI:
+	* /font/devX100-12/NR:
+	* /font/devX100-12/TB:
+	* /font/devX100-12/TBI:
+	* /font/devX100-12/TI:
+	* /font/devX100-12/TR:
+	* /font/devX100/CB:
+	* /font/devX100/CBI:
+	* /font/devX100/CI:
+	* /font/devX100/CR:
+	* /font/devX100/HB:
+	* /font/devX100/HBI:
+	* /font/devX100/HI:
+	* /font/devX100/HR:
+	* /font/devX100/NB:
+	* /font/devX100/NBI:
+	* /font/devX100/NI:
+	* /font/devX100/NR:
+	* /font/devX100/TB:
+	* /font/devX100/TBI:
+	* /font/devX100/TI:
+	* /font/devX100/TR:
+	* /font/devX75-12/CB:
+	* /font/devX75-12/CBI:
+	* /font/devX75-12/CI:
+	* /font/devX75-12/CR:
+	* /font/devX75-12/HB:
+	* /font/devX75-12/HBI:
+	* /font/devX75-12/HI:
+	* /font/devX75-12/HR:
+	* /font/devX75-12/NB:
+	* /font/devX75-12/NBI:
+	* /font/devX75-12/NI:
+	* /font/devX75-12/NR:
+	* /font/devX75-12/TB:
+	* /font/devX75-12/TBI:
+	* /font/devX75-12/TI:
+	* /font/devX75-12/TR:
+	* /font/devX75/CB:
+	* /font/devX75/CBI:
+	* /font/devX75/CI:
+	* /font/devX75/CR:
+	* /font/devX75/HB:
+	* /font/devX75/HBI:
+	* /font/devX75/HI:
+	* /font/devX75/HR:
+	* /font/devX75/NB:
+	* /font/devX75/NBI:
+	* /font/devX75/NI:
+	* /font/devX75/NR:
+	* /font/devX75/TB:
+	* /font/devX75/TBI:
+	* /font/devX75/TI:
+	* /font/devX75/TR: Regenerate font descriptions with xtotroff,
+	using updated ISO-8859_1 map.  \aq and \oq are now aliases
+	of "'" and \ga is an alias of "`".  This change probably
+	should have been made when the X11 fonts were corrected in
+	XFree86 4.0 (March 2000).  See
+	<https://www.cl.cam.ac.uk/~mgk25/ucs/quotes.html>.
+
+	Fixes <https://bugs.debian.org/243238>.
+
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libxutil/DviChar.c (ISO_8859_1_map): Fix incorrect
+	assignment of Latin-1 grave accent to \oq special character;
+	reassign it to the neutral apostrophe.  Map \aq to neutral
+	apostrophe.  Map \ga to '`'.
 
-2014-05-27  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_char.man: Finish notes in all tables.
+	* src/utils/xtotroff/xtotroff.1.man (Options) <-d>: Document new
+	option.
+	* src/utils/xtotroff/xtotroff.c (usage): Align with man page.
 
-2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_char.man: Add notes in some tables, more will come.
+	* doc/groff.texi (Manipulating Filling and Adjustment):
+	Explicitly identify the page offset as an output line property
+	that is not determined until a break occurs.
 
-2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+	(Line Layout) <po>: Correct error; the page offset for terminal
+	devices is set by "tty.tmac", not "troffrc".  (The manual has
+	been wrong for a long time; we've had it in tty.tmac since James
+	Clark put it there in 1992.)  Recast and tighten wording.  Drop
+	the word "horizontal"; there is no vertical page offset (as
+	such) in *roff.  Replace hand-waving about unexpected results
+	with a description of the formatter's behavior.  Document
+	request behavior without an argument before getting into the
+	weeds (and CSTR #54 errata).  Migrate terminology from "scaling
+	indicator" to "scaling unit".
 
-	* src/roff/grog/grog.pl: Add further first line characters for
-	single character `groff' options.
+	Fixes <https://savannah.gnu.org/bugs/?58035>.
 
-	* src/roff/grog/grog.man: make generated options more readable.
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* doc/groff.texi (Expressions): Expand '|' operator explanation.
+	Split discussion of its application into horizontal and vertical
+	contexts.  Add example of vertical usage.
 
-	* src/roff/grog/grog.pl: Add detection of `.\" eprt' as first
-	line to `grog'.  Change usage of `$Sp' to reasonable efforts in
-	`groff'.
+	Fixes <https://savannah.gnu.org/bugs/?60820>.
 
-	* src/roff/grog/grog.man, man/groff_char.man: Add website for
-	license text, not only the postal address.
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* src/roff/troff/input.cpp: Trivially refactor.  Drop `#define`
+	that was working around a GCC 2.95-era libstdc++ problem.
+	Shorten long line.
+	(get_char_for_escape_parameter): Demote parameter from `int` to
+	`bool` and use Boolean literal for default argument.  Annotate a
+	null pointer constant.
 
-	* */Makefile.*: Path quoting fixes, whitespace, formatting.
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Remove many quotes (and introduce a few as additional guards)
-	since groff's build system is generally not set up to properly
-	handle paths that need quoting.
+	troff: Rename some internal functions.
 
-2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* src/roff/troff/input.cpp: Do it.
+	(read_escape_name):
+	(read_long_escape_name):
+	(read_two_char_escape_name):
+	(get_char_for_escape_name):
+	(read_increment_and_escape_name): Rename these...
+	(read_escape_parameter):
+	(read_long_escape_parameters):
+	(get_char_for_escape_parameter):
+	(read_two_char_escape_parameter):
+	(read_increment_and_escape_parameter): ...to these.
+	(read_two_char_escape_parameter, read_long_escape_parameters,
+	read_escape_parameter, read_increment_and_escape_parameter,
+	get_copy, token::next): Update call sites.
 
-	* Makefile.comm (extraclean): Don't delete `old'.
+2022-03-07  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The rule calling `rm -f' was originally thought to remove private,
-	temporary files.  However, we now have a subdirectory called `old'
-	in `fonts/devps' that may not be removed, and trying so now causes
-	an error because we no longer ignore the returned error code of
-	`rm'.
+	* src/roff/troff/input.cpp (get_char_for_escape_name): Recast
+	diagnostic messages to more accurately refer to escape
+	"sequence" rather than "name".  "Name" is a confusing term here,
+	given that it also applies to a group of objects sharing a name
+	space (natch): requests, macros, strings, and diversions.
+	Further, the "escape name" cited by these diagnostics is not the
+	escape function selector; that is, the character after the
+	escape character which determines how the escape sequence is to
+	be interpreted.  These diagnostics are only thrown after that
+	function is known, however, when parsing of an escape sequence
+	parameter is attempted.
+	(input_char_description): Drop leading articles ("a") from
+	input character descriptions, to economize in diagnostic
+	messages this function helps produce.
+	(non_empty_name_warning): Use zero copula for economy.
 
-2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* src/roff/troff/input.cpp (empty_name_warning, read_size)
+	(token::get_char, check_missing_character):
+	* src/roff/troff/number.cpp (start_number, parse_term): Recast
+	messages to more consistently use the form "expected X, got Y"
+	where feasible.
 
-	* Makefile.in (OTHERDIRS): Fix directory order.
+	* src/roff/troff/number.cpp (start_number): Say "numeric
+	expression missing" instead of "missing number"; we don't
+	require a terminal symbol in the expression grammar here.  Also
+	use `tok.description()` where we can, and remove assumption that
+	the escape character is the default.
 
-	This has been accidentally broken in commit 51476bee from
-	2014-02-25.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* tmac/an.tmac (AT, UC, HP): Add deprecation warnings.  For the
+	last, only do so if we're not inside a synopsis (SY/YS), since
+	our definition of `SY` calls `HP` internally.  (This does seem
+	hypocritical.  Perhaps if we knew the correct CSS incantation
+	to speak in grohtml, we could un-deprecate `HP`.)
 
-	* src/devices/gropdf/pdfmom.pl: Fix perl(1) warning.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-30  Werner LEMBERG  <wl@gnu.org>
+	* tmac/tmac.an (M4CHECK): Rename stamp file to make its purpose
+	clearer.
 
-	* configure: Regenerated.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+	man: Tweak customization management.
 
-	* */Makefile.*: Put straight error-prevention prefixes for `rm'.
+	* tmac/an.tmac: Load "man.local" with `msoquiet` request, so
+	people can get rid of the file if they don't need it.
+	(PT, BT): Define these macros only if not already defined.  This
+	is slightly less paranoid but far more ergonomic, given
+	interactions with the andoc wrapper.  Now user-defined page
+	header traps (PT) defined in man.local can take effect on the
+	first page rendered.
 
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* tmac/groff_man.7.man.in (Hooks): Document how to remove page
+	headers and/or footers entirely.
 
-	`uninstall' target: Avoid spurious and misleading error messages.
+	Fixes <https://savannah.gnu.org/bugs/?61954>.
 
-	* Makefile.comm (uninstall_dev): Improve.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/Makefile.sub (install_data): Remove superfluous `rm'.
-	(uninstall_sub): Improve.
+	refer,mm: Add and use `ref*reset` macro to clean up between
+	bibilography entries.
 
-	* src/roff/groff/Makefile.sub (uninstall_sub): Fix.
+	* tmac/refer.tmac (-): Move string clean up logic from here...
+	(ref*reset): ...to this new macro.  Now we can also use it...
 
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+	* contrib/mm/refer-mm.tmac (ref*-first-pass): ...here.
 
-	Fixes for `uninstall' target.
+	Problem appears to date back to refer-mm.tmac's introduction in
+	January 2011.  Thanks to Bjarni Ingi Gislason for the root-cause
+	analysis and proposed fix, to which I applied the DRY principle
+	and added a reset of `ref*string` as well.
 
-	* Makefile.in (uninstall_dirs): Use `DESTDIR'.
+	Fixes <https://savannah.gnu.org/bugs/?60657>.
 
-	* src/libs/libgroff/Makefile.sub (uninstall_charset_data): Typo.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/Makefile.sub (uninstall_sub): Typo.
+	mm: Regression-test Savannah #60657.
 
-	* src/roff/grog/Makefile.sub (uninstall_sub): Minor.
+	* contrib/mm/tests/remove-stale-bib-entry-data.sh: Do it.
+	* contrib/mm/tests/artifacts/60657.ref: Add new file.
+	* contrib/mm/mm.am (mm_TESTS): Run test.
+	(EXTRA_DIST): Ship test artifact in distribution archive.
 
-2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+	Thanks to Bjarni Ingi Gislason for the straightforward
+	bug reproducer.
 
-	* src/roff/grog/Makefile.sub (install_data): Typo.
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-29  Steffen Nurpmeso  <sdaoden@yandex.com>
+	refer: Report correct line number in bibliography file
+	diagnostics.
 
-	Add fine-tuning of doc generation to `configure'.
+	* src/preproc/refer/refer.cpp (do_bib): Set line number to 1
+	upon successfully opening a bibliography file.
 
-	* m4/groff.m4 (GROFF_DOC_CHECK): New macro, handling option
-	`--with-doc' and its new arguments.  It sets
-	`docadd_{html,info,other,pdf,examples}' and exports
-	`make{_,_install_,_uninstall_}{otherdoc,examples}'.
-	(GROFF_MAKEINFO): Extended to export
-	`make{_,_install_,_uninstall_}infodoc'.
-	(GROFF_HTML_PROGRAMS): Extended to export
-	`make{_,_install_,_uninstall_}{htmldoc,htmlexamples}'.
-	(GROFF_PDFDOC_PROGRAMS): Extended to export
-	`make{_,_install_,_uninstall_}{pdfdoc,pdfexamples}'.
-	(GROFF_INSTALL_INFO): Guard test with `docadd_info'.
+	Problem appears to date back to groff 1.02 (June 1991) at the
+	latest.
 
-	* configure.ac: Use GROFF_DOC_CHECK.
-	* Makefile.in: Updated.
+	Fixes <https://savannah.gnu.org/bugs/?62142>.
 
-	* doc/Makefile.sub: Handle examples separately, controlled by
-	$(make{_,_install_,_uninstall_}examples).
+2022-03-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	refer: Regression-test Savannah #62124.
 
-	* tmac/www.tmac (TAG): Define register `PN'.
+	* src/preproc/refer/tests/report-correct-line-numbers.sh: Do it.
+	* src/preproc/refer/tests/artifacts/62124.ref: Add new file.
+	* src/preproc/refer/refer.am (refer_TESTS): Run test.
+	(EXTRA_DIST): Ship test artifact in distribution archive.
 
-2014-03-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+2022-03-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-ext.tmac (EX, EE): Preserve font family.
+	* src/roff/troff/div.cpp
+	(top_level_diversion::transparent_output):
+	* src/roff/troff/input.cpp (transparent_translate): Suppress two
+	troublesome (i.e., more or less spurious) error diagnostics
+	about transparent output/throughput unless the environment
+	variable `GROFF_ENABLE_TRANSPARENCY_WARNINGS` is present.  This
+	is a bit of a bodge until we get diversion sanitization worked
+	out.  See Savannah #61407.
 
-2014-03-17  Werner LEMBERG  <wl@gnu.org>
+2022-03-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/box.cpp (set_script_size): Fix minimum test.
+	preconv: Stop assuming that the default input stream, or an
+	explicit '-' operand, is the only unseekable stream.  Check
+	instead.
 
-	Problem reported by Ted Harding <ted.harding@wlandres.net> in a
-	thread starting with
+	* src/preproc/preconv/preconv.cpp (do_file): Add new Boolean
+	`is_seekable`.  Test the input stream with `fseek()` per a
+	suggestion from Ingo Schwarze.  Report unseekability in debug
+	output and skip coding tag and uchardet tests altogether
+	{precisely paralleling our description in the preconv(1) man
+	page}.  Also update debugging output to say "<standard input>"
+	instead of "-".
 
-	http://lists.gnu.org/archive/html/groff/2014-03/msg00181.html
+	Fixes <https://savannah.gnu.org/bugs/?62131>.
 
-2014-03-16  Werner LEMBERG  <wl@gnu.org>
+2022-03-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix previous commit.
+	preconv: Regression-test Savannah #62131.
 
-	Problem reported (with a patch) by Ingo Schwarze
-	<schwarze@openbsd.org>.
+	* src/preproc/preconv/tests/do-not-seek-the-unseekable.sh: Do
+	it.
+	* src/preproc/preconv/preconv.am (preconv_TESTS): Run test.
 
-	* doc/Makefile.sub (groff_bin_dirs): Add `preconv'.
+2022-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/Makefile.in (groff_bin_dirs): Add `preconv'.
-	(.me.txt): Call preconv.  Use UTF8 as output encoding.
-	(.me.ps): Call preconv.
+	* src/preproc/tbl/main.cpp (process_format): Update diagnostic
+	to recognize that a font mounting position is also an acceptable
+	argument to the 'f' column modifier.
 
-2014-03-14  Werner LEMBERG  <wl@gnu.org>
+2022-02-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	me Add translation of `meintro.me' to French.
+	Refactor X11 font description generation.  Integrate it with our
+	"new" (post-2014) Automake-based build system.
 
-	Contributed by Grégoire Babey <gibux@gmx.ch>.
+	* src/utils/xtotroff/Makefile.in: Delete relic of old build
+	system.  Also, it had a bug: it generated X11 output device
+	'DESC' files with a "unitwidth 10" directive even for the "-12"
+	devices, which is not correct (the in-tree DESC files we've been
+	shipping for years were nevertheless correct, apparently fixed
+	by hand by James Clark in groff 1.07 March 1993).
 
-	* doc/meintro_fr.me: New file.
-	* LICENSES, doc/Makefile.sub: Updated.
+	* src/utils/xtotroff/xtotroff.am: Define `xtotroff` variable for
+	use by X11 font description generation targets below.
 
-2014-03-13  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+	* font/devX100-12/devX100-12.am:
+	* font/devX100/devX100.am:
+	* font/devX75-12/devX75-12.am:
+	* font/devX75/devX75.am: Add new (phony) targets, variously
+	named "devX{100,100_12,75,75_12}", to generate the corresponding
+	output device's DESC file and run xtotroff(1) to generate its
+	font description files.  Be sure to set the correct "unitwidth"
+	for the "-12" devices.  Add new dependency-only rule
+	"maintainer-font-descriptions" depending on these new targets
+	for convenience (and future expansion to devps and devlj4).
 
-	man: Correctly reset margins.
+	* FOR-RELEASE: Document existence of
+	"maintainer-font-descriptions" Make target and when to run it.
 
-	See
+	Running this target with the aforementioned bug fix, overwriting
+	the in-tree DESC and font description files using data gathered
+	from a running X server, results in no changes whatsoever.  Say
+	what you will about X11 core font technology--it's stable.
 
-	http://lists.gnu.org/archive/html/groff/2013-11/msg00026.html
+2022-02-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	for more.
+	Rename and ship "FontMap-X11".  xtotroff(1) is not very useful
+	without a font name mapping file to read.  To date it has been
+	available only in the source distribution.  Remedy that.  The
+	file is placed directly in the groff font directory alongside
+	the device directories because it applies to four different
+	devices, and four copies of this data are not required.
 
-	* tmac/an-old.tmac (set-an-margin): Whenever (re)setting
-	`\nan-level' to 1 (which happens when encountering `.TH', `.SH',
-	and `.SS') make sure to also (re)set `\nan-saved-margin1' and
-	`\nan-saved-prevailing-indent1' to a sane value such that an
-	immediate `.RE' cannot wreak havoc.
-	(TH, SH, SS): Updated.
+	* src/devices/xditview/FontMap: Rename to...
+	* src/devices/xditview/FontMap-X11: ...this.
 
-2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+	* LICENSES:
+	* src/devices/xditview/xditview.am (EXTRA_DIST): Reflect rename.
 
-	* Makefile.in: Do not forget to install gropdf manuals.
+	* src/devices/xditview/xditview.am (install_xditview
+	  !WITHOUT_X11, uninstall_xtdiview): (Un-)install it.
 
-	This got broken in 290eaaac6cfc33856cd683838accc72ccf3e5a84:
-	src/devices/gropdf was split out of OTHERDIRS into SHPROGDIRS, and
-	consequently, Makefile.man was no longer used there.  Note that
-	Makefile.dev is *not* needed, even though it's below /devices/.
+	* src/utils/xtotroff/xtotroff.1.man (Files): Add section
+	documenting the presence and purpose of this file.
 
-2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+2022-02-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/Makefile.sub: POSIX conformance.
+	xtotroff: Add `-d` option to produce font description files in
+	specified directory.
 
-	- POSIX says that the meaning of the make(1) `$<' macro shall be
-	   unspecified except in inference rules.  Consequently, use `$?'
-	   for portability.
+	* src/utils/xtotroff/xtotroff.c: Do it.  Add global `destdir`
+	pointer.
+	(xtotroff_exit): Add new function to clean up storage allocated
+	by `strdup()` (below) for destination directory.
+	(MapFont): Introduce new variable `file_name`, into which we
+	assemble a destination file name from `destdir` (if not null)
+	and the troff font name.  Handle memory allocation failure (by
+	carefully dying).  Free allocated storage on success and failure
+	paths out of the function.
+	(usage): Document new `-d` option.
+	(main): Instruct `getopt_long` to expect a `-d` flag with an
+	argument.  Use `strdup()` to make a copy of any such option
+	argument.  Call `xtotroff_exit()` instead of `exit()`.
 
-	   That's safe because the rules have only one prerequisite and
-	   are not `.PHONY', so `$?' will always expand to one item.
+	* src/utils/xtotroff/xtotroff.1.man: Document new `-d` option.
 
-	- While here, clean up two instances of superfluous use of cat(1).
+2022-02-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+	xtotroff: Trivially refactor.
 
-	* Makefile.in (dist): Improve.
+	* src/utils/xtotroff/xtotroff.c: Boolify.  Include `stdbool.h`
+	and `errno.h` headers.
+	(charExists, CanonicalizeFontName, FontNamesAmbiguous, MapFont):
+	Boolify.  Demote return type from `int` to `bool` and return
+	Boolean instead of integer literals.
+	(FontNamesAmbiguous, main): Reorder equality comparisons with
+	simple left-hand sides to avoid inadvertent lvalue assignments.
+	(FontNamesAmbiguous, MapFont): Refer to font name as "invalid",
+	not "bad", in diagnostic messages.
+	(MapFont, main): Use `strerror()` instead of `perror()` so that
+	diagnostics include the program name and an indication of
+	problem severity.
+	(MapFont): Compare `FILE` stream pointer to `NULL` instead of
+	treating it as a Boolean.
+	(main): Use `EXIT_SUCCESS` and `EXIT_FAILURE` constants from C
+	library instead of integer literals for exit status.
 
-	- Bugfix: Do not error out if one of the DISTDIRS
-	   contains a subdirectory.
-	- Make debugging easier by splitting the huge "cd tmp; ...; ..."
-	   command sequence into several independent shell commands,
-	   such that one can see which command actually fails.
+2022-02-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-03-06  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	pic: Fix "unused result" compiler warning.
 
-	Missing RE escape in grep.
+	* src/preproc/pic/pic.ypp (placeless_element) <SH>: Check return
+	value of `system()` to quieten `-Wunused-result` warning; if it
+	is less than zero, report it to the standard error stream.
 
-	* src/devices/gropdf/pdfmom.pl: Escape '\' dot in grep RE.
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-02-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/safer.tmac: Drop file from distribution.  It contained
+	only comments.
+	* tmac/tmac.am (TMACNORMALFILES): Delete reference.
+	* NEWS: Add item.  Suggest two workarounds for its absence.
 
-	* src/roff/grog/grog.pl: Add detection of `gperl' to `grog'.
+	Fixes <https://savannah.gnu.org/bugs/?61831>.
 
-2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/gperl: New preprocessor for Perl parts in groff files.
+	* tmac/doc.tmac (initialization): Drop definition of
+	`doc-curr-size` register.  It is no longer needed since nothing
+	internal to the package now changes the type size.
 
-2014-02-15  Ingo Schwarze  <schwarze@openbsd.org>
+	* tmac/doc.tmac (Fl, doc-print-recursive, doc-print-prefixes)
+	(doc-generic-macro, Ar, Cd, doc-do-func-decl, Fd, In, Nm, Pa)
+	(Tn, doc-enclose-string, Ef, Bd, doc-save-global-vars)
+	(doc-restore-global-vars, doc-diag-list, Xr, Dl, Vt, Ft, Fa)
+	(doc-do-func, Fn, doc-do-func-args, Fo, Fc, %A, %B, %C, %D, %I)
+	(%J, %N, %O, %P, %Q, %R, %T, %U, %V, doc-do-reference, Hf, An)
+	Lk):
+	* tmac/mdoc/doc-common (Sh, Ss, Rd):
+	* tmac/mdoc/doc-syms (Ux, Bx, At, Dx, Fx, Nx, Ox, Bsx, St, Lb):
+	Drop interpolations of the string and comments documenting that
+	each macro has a side effect on the type size.
 
-	* tmac/groff_mdoc.man: Improve the manual page template.
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	 - Add the EXIT STATUS section.  It is widely used in at least
-	   NetBSD, FreeBSD, OpenBSD, and DragonFly manuals.
-	 - Recommend the DIAGNOSTICS section for section 4 manuals.  Such
-	   usage is very widespread, in particular for kernel printf
-	   messages emitted by device drivers.
-	 - Do not recommend the DIAGNOSTICS section for command return
-	   values to the shell any longer.  While such usage historically
-	   existed, it does not seem common nowadays, and in any case, using
-	   the now well-established EXIT STATUS section seems preferable to
-	   me.
-	 - Mention the possibility to use ERRORS for section 4 manuals.
-	   While most section 4 manuals have a DIAGNOSTICS section, only
-	   some will need an ERRORS section, but these cases aren't exactly
-	   rare, either.  Quite some device driver manuals explain how to
-	   use the device using system calls like ioctl(2), open(2), read(2)
-	   or write(2), in which case the ERRORS section is the natural
-	   place to explain which errno values the driver may set during
-	   such system calls.
-	 - Mentioning signal handling as a content of the ERRORS section
-	   seems redundant, it is already covered by talking about the
-	   errno.  The case of errno == EINTR should be handled just like
-	   all other errno cases.  For an example showing that there is no
-	   need to single out error handling in any way, please look at a
-	   typical read(2) manual page.
-	 - Mention the CAVEATS section.  It first appeared in the 4.2BSD
-	   execve(2) manual in 1983, was already used by several manuals by
-	   the time of 4.4BSD-Lite2 in 1995, and is in whidespread use
-	   today, not just in BSD base system manuals, but for example in
-	   Perl manuals as well.
+	* tmac/doc.tmac (Tn):
+	* tmac/mdoc/doc-syms (Ux, Bx): Stop interpolating string
+	`doc-Tn-font-size` to set macro arguments at a smaller type
+	size.  This leaves the string without a purpose, so...
 
-2014-02-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Drop definitions of `doc-Tn-font-size`.
 
-	* src/roff/grog/grog.pl: Add detection of glilypond-parts in groff
-	files.  For example `grog example.groff' from the glilypond source
-	gets `glilypond example.groff | groff'.
+	* tmac/mdoc/doc-syms: Drop interpolations of that string from
+	numerous other string definitions.
 
-2014-02-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?60616>.
 
-	* src/roff/grog/grog.pl: With the former bugfix of 2014-02-12,
-	it's now possible to run `grog meref.me' etc., which wasn't
-	possible before.  That addition of the macro handling was
-	necessary for the automatic for `groffer'.
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-02-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Revert addition of man(7) `BD` register.  This feature, which I
+	introduced in commit ea3b27102f (31 January) doesn't work
+	because pdf.tmac normalizes the bookmark depth.  Embedding a man
+	page in a larger PDF document with appropriately nested
+	bookmarks is a project that will have to await another day (or
+	perhaps already has tools to implement it).
 
-	* src/roff/grog/grog.pl: Add handling of macro definition and fix
-	problems with @VERSION@.
+	* tmac/an.tmac: Do it.
+	* tmac/groff_man.7.man.in: De-document it.
 
-2014-02-12  Rich Burridge  <rich.burridge@oracle.com>
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	grn Prevent crash if more than 50 command line arguments.
+	* tmac/pdf.tmac: Add string containing the name of the macro
+	package for use in diagnostic messages.
+	(pdf:warn, pdf:error): Use it.
 
-	* src/preproc/grn/main.cpp (INIT_FILE_SIZE, FILE_SIZE_INCR): New
-	macros.
-	(add_file): New function.
-	(main): Use it to add file arguments.
+	Continues the long process of fixing Savannah #52463.
 
-2014-01-29  Ulrich Spörlein  <uqs@FreeBSD.org>
+2022-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc-common: Add even more DragonFlyBSD releases.
+	man,mdoc,me: Revise hyphenation localization.
 
-2014-01-28  Ulrich Spörlein  <uqs@FreeBSD.org>
+	* tmac/an.tmac (an*reset-hyphenation-mode): New macro sets the
+	hyphenation mode appropriate to the locale depending on the
+	values of `cR` (continuous rendering mode) and `HY` (hyphenation
+	enablement); the latter is now interpreted as a Boolean.  Define
+	new register `an*hyphenation-mode` reflecting these conditions.
+	(TH): Call the foregoing instead of invoking `hy` request.
+	(MR): Restore hyphenation mode to `an*hyphenation-mode`.
+	(initialization): Simplify; if not defined, set `HY` to 1.
 
-	* tmac/doc-common: Add some new *BSD version strings.
+	* tmac/e.tmac (ld): Set the hyphenation mode here instead of in
+	initialization (which already calls this macro).  Set the mode
+	to 6 for the benefit of anyone borrowing our me(7) changes, but
+	then immediately change to the mode determined by the
+	localization file.
 
-2014-01-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/mdoc/doc-common (doc-hyphen-flags): Set a hyphenation
+	mode appropriate to the locale, depending on the values of `cR`
+	and `HY`.
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff: Simplify initialization; if not defined,
+	set `HY` to 1.
 
-	* man/roff.man: Add information of new archives for RUNOFF and
-	roff_classical.
+	* tmac/cs.tmac:
+	* tmac/de.tmac:
+	* tmac/en.tmac:
+	* tmac/fr.tmac:
+	* tmac/it.tmac:
+	* tmac/sv.tmac: Before switching locales, set a flag if
+	troublesome value 2 of the hyphenation mode is set so that we
+	can preserve it.  Shift man(7) and me(7) logic to follow setup
+	of the new hyphenation mode; for the former, call the new
+	`an*reset-hyphenation-mode`.
 
-	* Makefile.in: Replace `contrib/RUNOFF' by
-	`contrib/groff_filenames'.
+	* tmac/groff_man.7.man.in:
+	* tmac/groff_mdoc.7.man: Document updated meaning of `HY`
+	register.
 
-2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
-	    Werner LEMBERG  <wl@gnu.org>
+	* NEWS: Add item noting change of man(7) `HY`'s meaning.  Update
+	existing item regarding mdoc(7)'s support for it (groff 1.22.4
+	mdoc(7) didn't recognize the register at all).
 
-	* groff/tmac/groff_man.man: Minor typos, formatting, reordering.
+	Fixes <https://savannah.gnu.org/bugs/?61734> (for real this
+	time?).
 
-2014-01-05  Werner LEMBERG  <wl@gnu.org>
+2022-02-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Revert recent changes to `an-ext.tmac' and `groff_man.man'.
+	man: Regression-test Savannah #61734.
 
-	* groff/tmac/an-ext.tmac (.FONT): Remove.  This doesn't belong into
-	this file.
+	* tmac/tests/an_reset-hyphenation-correctly.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* groff/tmac/groff_man.man: Reset to state previous to 2014-01-04.
-	Useful changes will be re-committed in smaller, logical chunks.
+2022-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-01-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* man/groff_char.7.man (History): Add new section.
+	(See also): Add cross reference to 1976 edition of CSTR #54.
 
-	* groff/tmac/an-ext.tmac: in .FONT change variable name `result'
-	to `an_ext_FONT_result'.
+2022-02-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-01-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/groff_man.7.man.in (Document structure macros) <EX, EE>
+	style: Add material cautioning writers against asoociating
+	the disablement of filling with some sort of "literal mode".
+	Document still-operational status of inter-sentence space
+	supplementation.
+	(Notes) style: Describe an alternative (and macro
+	call-symmetrical) means of using `RS` and `RE` with `TP`.
 
-	* groff/tmac/an-ext.tmac: add new request .FONT for using
-	different font names on a single line.
+2022-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* groff/tmac/groff_man.man: put under GPL2, reordered and enhanced.
+	* doc/doc.am: Add phony targets "man-all" and "man-clean" to
+	{re-}generate and delete all man pages, respectively.
 
-2014-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	Arguably fixes <https://savannah.gnu.org/bugs/?61167>.
 
-	* src/devices/gropdf/gropdf.pl: gropdf use to fail when handling
-	output from preconv, now works.
+2022-02-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/pdfmom.pl: can now be used as a pipeline, and
-	improvements made to its switch handling and use with preconv.
+	* Makefile.am (.man): Prefix hyphenation control escape
+	sequences to more configuration-time interpolations to prevent
+	their hyphenation: @DEVICE@, @g@, @INDEX_SUFFIX@, @PAGE@,
+	@TMAC_{AN,M,S}_PREFIX@, @TMAC_MDIR@.
 
-	* tmac/pdf.tmac: changes to support preconv.
+2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2014-01-02  Colin Watson  <cjwatson@debian.org>
+	man: Refactor `EX` and `EE` macros.
 
-	* 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.
+	* tmac/an-ext.tmac: Add new `mC` string to store the font name
+	to be used for example regions.  In AT&T device-independent
+	troff, "CW" was a common name, so use that.  It is however a
+	terrible fit for groff's font family and style-combination
+	functionality, and is inflexible in the face of font selection
+	requests and escape sequences within the example region.  (One
+	either needs to know the names of the fonts available on the
+	output device, or suffer the indignity of mixed constant-width
+	and proportional typefaces.)  Relatedly, drop groff-specific
+	font remapping requests.
+	(EX, EE): Ignore definition if GNU troff is the formatter.  Drop
+	font family manipulation.  Drop specialized logic for groff's
+	DVI output device.
 
-2013-12-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/an.tmac (initialization): Resurrect font remapping
+	requests here.
+	(EX, EE): Add new definitions, saving and restoring more state
+	and remapping DVI output device fonts to reflect the absence of
+	CWB and CWBI faces.
 
-	* groff/src/roff/groff/groff.cpp: add groff option `-G' to the
-	documentation in `synopsis()'.
+2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-12-06  Mike Frysinger  <vapier@gentoo.org>
+	* tmac/an-ext.tmac: Slightly refactor.  Stop using groff's `HY`
+	register to restore the hyphenation mode, since I plan to change
+	its semantics to a Boolean value (see Savannah #61734).
+	Introduce new register `mJ` to store "1" (if not groff) and the
+	current hyphenation mode otherwise.  Explain why in a comment.
+	(YS, UE, ME, MR): Restore hyphenation mode using `mJ` instead of
+	`HY`.
 
-	Fix parallel build with gropdf and mom examples.
+2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The `contrib/mom/examples/' directory uses the helper script from
-	`src/devices/gropdf/'.  Currently though, parallel builds might fail
-	like so:
+	* tmac/an-ext.tmac: Trivially refactor.  Use a better idiom
+	{seen in James Clark's changes to BSD me(7)} for conditionally
+	defining a (simple) macro.
 
-	  ...
-	  make2: Entering directory `.../groff-1.22.2/contrib/mom'
-	  <groff command> examples/letter.mom >examples/letter.pdf
-	  <groff command> examples/mom-pdf.mom >examples/mom-pdf.pdf
-	  /bin/sh: .../groff-1.22.2/src/devices/gropdf/pdfmom: No such file or directory
-	  make2: *** examples/letter.pdf Error 127
-	  /bin/sh: .../groff-1.22.2/src/devices/gropdf/pdfmom: No such file or directory
-	  make2: *** examples/mom-pdf.pdf Error 127
-	  make2: Leaving directory `.../groff-1.22.2/contrib/mom'
-	  make1: *** contrib/mom Error 2
-	  ...
-	  make2: Entering directory `.../groff-1.22.2/src/devices/gropdf'
-	  sed -f .../groff-1.22.2/arch/misc/shdeps.sed \
-	      -e "s|@VERSION@|1.22.2|" \
-	      -e "s|@PERLPATH@|/usr/bin/perl|" ./pdfmom.pl >pdfmom
+2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	The top level makefile tries to account for this in general with
-	OTHERDIRS, but looks like `src/devices/gropdf/' was added to this
-	variable (which holds `contrib/mom/' too) because gropdf installs a
-	shell script, and the other prog vars require it to be a dir of
-	things to compile.
+	* src/devices/grotty/tty.cpp (tty_printer::special): Warn upon
+	encountering unrecognized device control commands using the
+	'tty:' tag.
 
-	  URL: http://crbug.com/324116
-	  URL: https://bugs.gentoo.org/487276
+2022-02-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (SHPROGDIRS): Declare.
-	(PROGDIRS): Add $(SHPROGDIRS).
-	(OTHERDIRS): Delete src/devices/gropdf.
-	($(SHPROGDIRS):): Add to existing rule.
-	($(OTHERDIRS):): Depend on $(SHPROGDIRS).
+	grotty: Remove 'sgr' device control command.
 
-2013-12-08  Eric S. Raymond  <esr@thyrsus.com>
+	* src/devices/grotty/tty.cpp (tty_printer::special): Do it.
+	* src/devices/grotty/grotty.1.man (Device control commands):
+	{De-}document it.
+	* NEWS: Add item.
 
-	Repository fully converted to git.
+	Fixes <https://savannah.gnu.org/bugs/?61561>.
 
-2013-11-21  Werner LEMBERG  <wl@gnu.org>
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* config.guess, config.sub: Updated from `config' repository.
+	* tmac/pdfpic.tmac: Add support for Cygwin/MinGW temporary
+	directory conventions.
 
-2013-11-06  Werner LEMBERG  <wl@gnu.org>
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/libgroff/tmpname.cpp (gen_tempname): Use O_BINARY.
+	* tmac/pdfpic.tmac: Search for temporary directories as groff(1)
+	does, instead of going straight to /tmp.
+	(pdfpic@get-temporary-directory): New function checks each of
+	its arguments for validity as a temporary directory; if one is
+	found, its name is left in `pdfpic*temporary-directory`.
+	(pdfpic@cleanup): Remove strings `pdfpic*temporary-directory`
+	and `pdfpic*temporary-file`.
+	(PDFPIC): Call `pdfpic@get-temporary-directory`, using the
+	contents of the environment variables $GROFF_TMPDIR and $TMPDIR,
+	and then /tmp, in that order.  Store the temporary file name in
+	string `pdfpic*temporary-file`.  Use this string in subsequent
+	`sy` and `so` requests.
 
-	Problem reported by Charlie Van Dien <charlie@vandien.com>; see
+	Fixes <https://savannah.gnu.org/bugs/?62055> for Unix systems.
 
-	  http://lists.gnu.org/archive/html/groff/2013-10/msg00006.html
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-11-06  Werner LEMBERG  <wl@gnu.org>
+	tests: Add test for PDFPIC fallback to PSPIC.
 
-	* Makefile.comm (.man.n): Use C locale.
+	* tmac/tests/pdfpic_falls_back_to_PSPIC.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	Problem reported by Petr Man <petr@madnetwork.org>; fix suggested by
-	Ralph Corderoy <ralph@inputplus.co.uk>.
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-07-24  Ingo Schwarze  <schwarze@openbsd.org>
+	tests: Tweak PDFPIC test input.
 
-	mdoc Implement `.%C'.
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+	Eliminate unnecessary blank lines from input.  Also call gs(1)
+	with '-q' in addition to '-o'.  (Why does the latter not imply
+	the former?!)  Thanks to Deri James for the advice.
 
-	* tmac/doc.tmac, tmac/doc-common: Do it.
-	* tmac/groff_mdoc.man: Updated.
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-07-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/pdfpic.tmac: Slightly refactor.
+	(pdfpic@cleanup, PDFPIC): Rename `pdfpic*file-name` to
+	`pdfpic*file-name-base` since it is not used as a complete file
+	name (but rather a basis for an ".eps" extension).
+	(PDFPIC): When testing PDF file extension, include the "."; a
+	file name like "mxyzptlkpdf" is too dubious to accept.  Also
+	explicitly compare `systat` register as equal or not equal to
+	zero, since its truth value is inverted from the expectations of
+	*roff expressions.
 
-	Fix overprinting issue with Acrobat reader.
+2022-02-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Problem reported by Heinz-Jürgen Oertel <hj.oertel@t-online.de>.
+	* tmac/pdfpic.tmac (PDFPIC): Refactor PDFPIC_NOSPACE handling.
+	Stop shelling out to create, and then sourcing, a temporary file
+	just to obtain the value of an environment variable.  groff
+	already has the `\V` escape sequence for that purpose (it's even
+	safe!).  Check that the value of $GROFF_PDFPIC_NOSPACE is a
+	valid numeric expression before assigning it to a register.
+	Trivially, use '=' instead of '==' as an equality operator.
+	*roff languages do not use '=' as an assignment operator, and I
+	believe the '==' synonym to be a sop to C programmers.
 
-	* src/devices/gropdf/gropdf.pl (do_t, FindChar): Use ascii octal
-	notation (i.e., \015) when outputting characters with value < 32.
-	This fixes a bug which affected acroread when control-M (cr) was
-	embedded in a text string.
+2022-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-07-16  Werner LEMBERG  <wl@gnu.org>
+	man: Stop attempting to adjust pargraph tag lines.
 
-	* tmac/fallbacks.tmac: Make it work in compatibility mode.
+	* tmac/an.tmac (TP): Disable adjustment inside the diversion.
+	(an-write-paragraph-tag): Restore adjustment outside of it.
 
-	Problem reported by Y T <doarhop@hotmail.com>.
+	Fixes <https://savannah.gnu.org/bugs/?62051>.
 
-2013-07-16  Werner LEMBERG  <wl@gnu.org>
+2022-02-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/Makefile.sub (install_data, uninstall_sub): Typos.
+	* tmac/e.tmac (@z): Conceal bare tab after request name (exposed
+	by no longer stripping the macro file).  See commit ad0575f20, 9
+	December.
 
-2013-07-16  Werner LEMBERG  <wl@gnu.org>
+2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (GREP, MDEFINES): Define and use plain grep.
+	grops,troff: Migrate to term "scaling unit" in diagnostics.
 
-	Necessary for Bernd's code to extract groff options.
+	* src/devices/grops/ps.cpp (ps_printer::do_import):
+	* src/roff/troff/input.cpp (warnscale_request):
+	* src/roff/troff/number.cpp (parse_term): Do it.
 
-2013-07-16  Ingo Schwarze  <schwarze@openbsd.org>
+2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-old.tmac (TP): Do not clobber line length after double
-	call to `.TP'.
+	me: Add nroff mode fallback for `u` macro.
 
-2013-07-02  Colin Watson  <cjwatson@debian.org>
+	* tmac/e.tmac (u): On nroff devices, bracket the first argument
+	with \(ul (underline rule) special character escape sequences.
+	{In plain language, '.u "like this"' renders "_like this_".}
 
-	* doc/groff.texinfo: Fix syntax error in documentation of `\z'.
+	I regard this as a cosmetic and semantic improvement; since the
+	quarter-em vertical motions used in troff mode were ignored in
+	nroff mode, the effect was not underlining but a sort of
+	strike-through, visible only at spaces in the argument.  The use
+	of this macro was thus invisible in nroff output if no spaces
+	were present in the argument.  This is probably the best we can
+	do without a fatter interface to terminal device capabilities.
 
-2013-07-02  Colin Watson  <cjwatson@debian.org>
+2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grolbp/lbp.cpp (main): Don't write trailer if no
-	printer was created.
+	me: Simulate boxed text support on nroff devices with ISO 6429
+	color escape sequences.
 
-2013-06-19  Eric S. Raymond  <esr@thyrsus.com>
+	* tmac/e.tmac (bx): Do it.  Add further fallback for non-groff
+	formatters in nroff mode, bracketing the boxed argument with '|'
+	glyphs.
+	* doc/meref.me.in: Document it.
 
-	* src/utils/lkbib/lbib.man: Move running text out of synopsis.
+	Fixes <https://savannah.gnu.org/bugs/?62038>.
 
-2013-05-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-02-12  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/Makefile.sub: Replace `cpp' by `groff.cpp'.
+	me: Rename registers `$v` -> `tv`, `$V` -> `dv`.
 
-2013-05-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/e.tmac: Do it.  Also include much commentary (including
+	some from James Clark in 1992) attempting to illuminate the
+	confusing history (and naming) of `$rRvV`.
 
-	* Makefile.in: Add new `contrib' directory `RUNOFF'.
+	* doc/meref.me.in: Document it.  Introduce new terms
+	"text vertical spacing" and "display vertical spacing" earlier
+	and use them to condense and clarify discussions of their use.
 
-2013-05-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* NEWS: Add item.
 
-	* src/roff/groff/Makefile.sub: Remove all `.PHONY:' lines.
+	Fixes <https://savannah.gnu.org/bugs/?61710>.
 
-2013-04-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/Makefile.sub: Replace `egrep' by `$(GREP)'.
-	commands.  Don't use $(CCSRCS) any more.
+	* doc/groff.texi (Deferring Output): Add new node introducing
+	and motivating environments, diversions, and traps.
 
-2013-04-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in, m4/groff.m4: Add `@libprogramdir@' and
-	`$libprogramdir' (usually `/usr/local/lib/groff').  Change
-	`$libdir/groff' into $libprogramdir for several `groff' programs.
-	Run `autoreconf -I m4'.
+	tmac: Add more compatibility mode guards.
 
-	* src/roff/groff/MAkefile.sub: Add $(DESTDIR) and $(srcdir) in
-	order to support installation outside of source code.
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/glilypond/Makefile.sub, contrib/glilypond/glilypond.pl:
-	Correct the install directories.
+	* tmac/pdf.tmac: Add compatibility mode guards so that we can
+	run even if troff is given the -C option.  Resurrect your
+	vintage 1975 Sixth Edition Unix manuals from '.deth' and format
+	them in PDF today!
 
-2013-04-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?61995>.
 
-	* src/roff/groff/Makefile.sub: Replace some variables by shell
-	commands.  Improve the output for the `make' runs.
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-04-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/andoc.tmac: Prefix diagnostic with package file name
+	literally.
 
-	* src/roff/groff/Makefile.sub: Make this Makefile compatible.
+2022-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-04-28  Bernd Warken  <groff-bernd.warken-72@web.de>
-2013-04-28  Werner LEMBERG  <wl@gnu.org>
+	man: Trivially refactor.
 
-	* src/roff/groff/Makefile.sub: Use `make' variables to get
-	`groff' options from `getopt' in `groff.cpp'.  Create 2 files
-	`groff_opts_no_arg.txt' and `groff_opts_with_arg.txt'.
+	* tmac/an.tmac (an*localize): Rename to...
+	(an*localize-strings): ...this.
+	(TH): Update call site.
 
-2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/read_groff_options.pl: Remove this file.  It's
-	no longer needed.
+	docs: Present several fundamental concepts.
 
-	* src/roff/groff/Makefile.sub: Get the `groff' options from the
-	use of `getopt...' in `groff.cpp' using `$(EGREP)' and `sed'.
-	Store this information in a new file `groff_options.txt', which
-	is copied to `groff libdir' during the installation.
+	* doc/groff.texi (Page Geometry):
+	* man/roff.7.man (Concepts): Add new node/section.
+	  - page geometry
+	  - basic units
+	  - device resolution
+	  - drawing position
+	  - text baseline
+	  - page offset
+	  - vertical spacing
+	  - page break
 
-2013-04-26  Werner LEMBERG  <wl@gnu.org>
+	Fixes the remainder of <https://savannah.gnu.org/bugs/?58035>.
 
-	Various minor fixes.
+2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.gen: Take the newest version from the `gnulib'
-	repository.
+	me: Add page length insufficiency check.
 
-	* configure: Regenerated.
+	* tmac/e.tmac (@h): Port Keith Marshall's page length checker
+	from ms(7).
 
-2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Fixes <https://savannah.gnu.org/bugs/?61034> and
+	<https://savannah.gnu.org/bugs/?61428>.
 
-	* INSTALL.gen: Restore an older version from `2006' in
-	`groff-1.21'.
+2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* FOR-RELEASE: New file which describes how to prepare `groff'
-	for a new release.
+	me: Add test for insufficient page length error.
 
-2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/tests/e_rejects-too-short-page-lengths.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* src/roff/groff/read_groff_options.pl: Reads `groff' options
-	from `groff.cpp' and writes them into the file `groff_options.info'.
+2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/groff/Makefile.sub: Have the generated file
-	`groff_options.info' be installed into the `groff libdir'.
+	me: Slightly refactor.
 
-2013-04-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/e.tmac (@h): Use groff default scaling operator in
+	conditional expression.  Add `do` requests so that the logic for
+	checking the line length works in compatibility mode.  Also move
+	misplaced parenthesis in conditional expression.
 
-	* INSTALL.gen: Replace this file by the daily `git' version of
-	`automake' `INSTALL' file.
+2022-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.autotools: Remove file.
+	ms: Refactor insufficient page length check.
 
-	* INSTALL.CVS: New file, moved from `INSTALL.autotools'.
+	* tmac/s.tmac (pg@top): Drop extraneous closing parenthesis from
+	numeric expression.  Change operator from '>' to '>='; a page
+	length right at the boundary causes a spurious extra page break
+	when a paragraphing macro is used to initialize the document.
+	Condense diagnostic emission using the @error macro instead of
+	duplicating it.  Change indentation to fit the style of the rest
+	of the file (use hard tabs).  If aborting, truncate the page
+	length to the current vertical position so that we don't
+	uselessly output further vertical space.
 
-	* m4/ax_prog_perl_version.m4: New file, taken from package
-	`autoconf-archive-2013.04.06'.
+2022-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4: Remove unnecessary blank line.
+	ms: Add test for insufficient page length error.
 
-	* Makefile.in: Add `$(PERLVERSION)'.
+	* tmac/tests/s_rejects-too-short-page-lengths.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* aclocal.m4: Run `autoreconf -I m4' (this includes
-	`aclocal -I m4').  This creates a suitable `aclocal.m4'.  Remove
-	generated subdirectory `autom4te.cache'.
+2022-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/Makefile.sub: Correct `sed' command.  Use `tabs'
-	that are needed by `GNU make'.
+	me: Vertically space delayed text like other annotations.
 
-2013-04-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/e.tmac ((d): Set vertical spacing using percentage in
+	`$V` register.
+	()d): Restore vertical spacing using percentage in `$v`
+	register.
 
-	* Makefile.sub: Add `m4/ax_compare_version.m4'.
+	Fixes <https://savannah.gnu.org/bugs/?61973>.
 
-	* aclocal.m4: Run the latest `aclocal -I m4' which generates a
-	suitable content in that file.
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.autotools: Information of the usage of `GNU autotools'
-	with `groff'.
+	build: Expand '@PAGE@' when generating man pages.
 
-	* INSTALL.gen: Move `autotool' parts to file `INSTALL.autotools'.
+	* Makefile.am (.man): Substitute the './configure'd paper format
+	for @PAGE@.
+	* src/roff/groff/groff.1.man: Use it.
 
-2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4: Replace tabs by spaces.  Use a double line between
-	AC_DEFUNs.
+	man: Trivially refactor an-ext.tmac.
 
-2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/an-ext.tmac (EX, EE): Do a better job of keeping the
+	name space promise made in comments at the top of the file.
+	Rename `sP` register to `mP`.  Problem introduced by me in
+	commit 69895ec20, 15 January 2020.  Also rename `la` and `ra`
+	strings to `mL` and `mR`, respectively.  These (undocumented)
+	string names date back to commit 259929625, 15 January 2007.
 
-	In the whole `groff' system, rename autoconf variable `$PERLPATH'
-	to `$PERL', which has the same content.  But `$PERL' suits to
-	`AX_PROG_PERL_VERSION' in m4 macro `GROFF_PERL' in `m4/groff.m4'.
+	* tmac/groff_man.7.man.in (Files) <an-ext.tmac>: Document the
+	aforementioned promise.
 
-	* src/utils/afmtodit/Makefile.sub,
-	* src/devices/gropdf/gropdf.pl,
-	* src/devices/gropdf/Makefile.sub,
-	* src/devices/gropdf/pdfmom.pl,
-	* arch/djgpp/config.site,
-	* font/devpdf/Makefile.sub,
-	* contrib/mm/Makefile.sub,
-	* m4/groff.m4,
-	* Makefile.in: Replace `$PERLPATH' by `$PERL'.
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/ax_compare_version.m4: New file, copied from daily version of
-	`GNU autoconf-archive'.
+	man: Refactor PDF bookmark support.
 
-	`autoconf' was not yet run, a newer version is needed.
+	* tmac/an.tmac (an*bookmark): New internal macro calls
+	`pdfbookmark` (only if the output device is 'pdf').
+	(initialization): Migrate macro appendments to appropriate
+	definitions.  Two cases...
+	(SH, SS): ...were straightforward.
+	(initialization): Another (for the man page title) was poorly
+	placed when appended to the `TH` macro, skipping over the page
+	header.  Move it instead...
+	(PT): ...here.  But to keep this bookmark from being generated
+	on every page of a document, we need a new variable
+	`an*was-TH-bookmark-emitted` which is tested here and assigned
+	once one bookmark corresponding to a `TH` call has been written.
+	(TH): Initialize `an*was-TH-bookmark-emitted` to zero.
+	(SS): Write the bookmark _before_ the subsection heading text.
+	(initialization): Drop short-lived `BM` register.  It seems
+	harmless to unconditionally include bookmarks in PDF output.  A
+	PDF tool can strip them out if they're not desired, and viewers
+	seem capable of minimizing or reducing the navigation pane (if
+	they even offer one in the first place).
 
-2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* tmac/an.tmac (initialization): Rename new `BN` register to
+	`BD`...
+	* tmac/groff_man.7.man.in (Options) <BD>: ...and document it.
+	Also document `PT`'s new bookmarking responsibility.
 
-	* README, INSTALL, INSTALL.gen, MANIFEST: Add documentation in the
-	top directory about some parts of `autotools' and `glilypond'.
+	Fixes <https://savannah.gnu.org/bugs/?58949> and
+	<https://savannah.gnu.org/bugs/?58950>.
 
-2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* configure.ac: Add information of the macro `GROFF_PERL'.
+	grohtml,groff,nroff,troff: Tweak usage message.
 
-	* Makefile.in: Add definitions of the macro variables and their
-	`@...@' counterparts.
+	* src/devices/grohtml/post-html.cpp (usage):
+	* src/roff/groff/groff.cpp (synopsis):
+	* src/roff/nroff/nroff.sh:
+	* src/roff/troff/input.cpp (usage): Partly revert commit
+	06ae7b0b8, 16 January.  Move an ellipsis back inside a bracketed
+	operand (that is, an optional one).  On reflection, I think this
+	notation makes it clearer that the command can be meaningfully
+	run without operands.
 
-	Run `autoreconf -I m4'.
+2022-01-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
-2013-04-15  Werner LEMBERG  <wl@gnu.org>
-2013-04-15  Ralph Carderoy  <ralph@inputplus.co.uk>
+	* tmac/papersize.tmac: Slightly refactor.  Use new `stringdown`
+	request instead of a combination of `tr`, `di`, `asciify`, and
+	`chop`.
 
-	Add Perl test to configuration.  During the run of `configure' the
-	program is broken with error when there is no `Perl' or the `perl'
-	program is too old.
+2022-01-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* m4/groff.m4: Add macro `GROFF_PERL' that tests the availability
-	of the `perl' program and tests wether this has a version of at
-	most `v5.6.1'.  Define variables $PERL and $PERLPATH for the full
-	name of the `perl' program and $PERLVERSION as the lest version.
+	man: Slightly refactor.
 
-2013-04-13  Keith Marshall  <keithmarshall@users.sourceforge.net>
+	* tmac/an.tmac (an-prepare-page-title): Rename to...
+	(an*prepare-page-title): ...this.  Also simplify numeric
+	expression.  Add comment regarding necessity of correct
+	environment.
 
-	Avoid consideration of autotool cache for CVS inclusion.
+	(an-header): Update call site of `an*prepare-page-title`.
 
-	* .cvsignore (autom4te.cache): Add reference.
+	(TH): Move planting of `an-header` trap from out of the midst of
+	footer trap management.  Add comments.
 
-2013-04-13  Bernd Warken  <groff-bernd.warken-72@web.de>
+	(an-header): Move `pl` and `sp` requests from here...
+	(PT): ...to here.  While it's conceptually nice to have these
+	macros consist solely of `tl` requests, it doesn't yield enough
+	power to those who want to redefine them.  Add comment.
 
-	* `autotools': During the run of `autoconf' and `autoreconf' a
-	subdirectory `autom4te.cache' was created.  I first added this to
-	groff CVS and removed it again after an email-discussion.
+	(an-footer, BT): ...simile.
 
-2013-04-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-01-27  Dave Kemper <saint.snit@gmail.com>
 
-	* `grog': Remove the shell version of `grog'.  Now there is only
-	Perl version.
+	man pages: Add more references to pic(1)'s .PF.
 
-	* src/roff/grog/perl.sh: Remove this file.
+	* contrib/chem/chem.1.man:
+	* contrib/pic2graph/pic2graph.1.man:
+	* src/utils/grog/grog.1.man: Do it.
 
-	* src/roff/grog/Makefile.sub: This file handles the removement of
-	the shell version.
+	Fixes <https://savannah.gnu.org/bugs/?61949>.
 
-	* src/roff/grog/perl_test.pl: New file for testing the available
-	Perl version in the system to be installed into.  This file will
-	be installed into the grog lib-directory.
+2022-01-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-04-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Implement PDF bookmark support for man pages.  Limitation: A
+	{sub}section can only be bookmarked if it is specified in the
+	arguments to the `SH` or `SS` requests, not on the next line in
+	an input trap.  Thanks to Deri James for providing the
+	fundamentals (blame me for any weird bits).
 
-	* `grog': In the following, the file `grog.pl' will be split.  For
-	the coming files, a lib-directory is needed for storage.
+	* tmac/an.tmac (an-prepare-page-title): Define a new string,
+	`an*page-ref-string`, which is the man page's own reference
+	{such as "groff(1)"} without any abbreviation, ellipsis, or font
+	selection or italic correction escape sequences.
+	(SS): Define a new string, `an*subsection-heading`, storing the
+	macro arguments (if any).  These could contain font selection
+	escape sequences, for instance, a fact that becomes important
+	later.
+	(initialization):
+	- Recognize `BM` register to enable PDF bookmarks (only on the
+	  'pdf' output device); defaults on.  Recognize `BN` register to
+	  set a base level/depth for the bookmarks; this is to ease
+	  embedding of man pages in other PDF documents that already use
+	  bookmarks.  The default is 0.  The registers are not yet
+	  documented.
+	- If the output device is 'pdf' and bookmarks are enabled, set
+	  `PDFOUTLINE.FOLDLEVEL` and `PDFHREF.VIEW.LEADING` registers
+	  {recognized by 'pdf.tmac'}.  Append to `TH`, `SH`, `SS` to get
+	  the `an*page-ref-string`, `an-section-heading`, and
+	  `an*subsection-heading` bookmarks in the document at the
+	  applicable levels.
 
-	* m4/groff.m4, configure.ac: Add libdir information for `grog'.
+	* tmac/mdoc/doc-common: Add straw-man implementation--it doesn't
+	support the `BM` and `BN` configuration parameters yet.  (This
+	is enough to get bookmarks for the groff_mdoc(7) page to
+	correctly appear in the new 'groff-man-pages.pdf' document.)
+	(Dt, Sh, Ss): If the output device is 'pdf', place bookmarks in
+	the document at levels 1, 2, and 3.
 
-	* Makefile.in: Add @grog_dir@.
+	Fixes <https://savannah.gnu.org/bugs/?58950>.
 
-	Run `autoconf'.
+2022-01-26  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	`grog' has now a lib-directory at `$prefix/lib/groff/grog'.
+	gropdf: Allow multiline text in .pdfinfo
 
-2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/devices/gropdf/gropdf.pl: Use either '\\\\\\\\n' or
+	'\u000a' as line separators in the string.
 
-	* contrib/groffer/: There is a free `git' package containing all
-	old `groffer' versions `v0.*' and `v1.*'.  The new versions
-	`groffer 2.*' will actually not be included.  This package can be
-	got at:
+2022-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	$ git clone git@github.com:RUNOFF/groffer.git
+	* tmac/trans.tmac: Further follow up commit c64fd60dff.  If the
+	`andoc` wrapper is being used, perform man(7) localization (not
+	just when `an` is loaded).
 
-2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+2022-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* contrib/glilypond/: There is a free `git' package containing all
-	old versions of the former name `groff_lilypond v0.*'.  They work
-	with `lilypond' parts in `roff' files, but were not installed.
-	This package can be got at:
+	man pages: Fix options used to generate compilations.
 
-	$ git clone git@github.com:RUNOFF/groff_lilypond.git
+	* doc/doc.am (doc/groff-man-pages.pdf): Drop `-rU0` option (it's
+	unnecessary since we don't yet have PDF hyperlink support in
+	this document).  Add `-rC1` option to enable continuous page
+	numbering.
+	(doc/groff-man-pages.utf8.txt): Drop `-rC1 -rU1`.  Continuous
+	page numbering is superfluous since page numbers are not shown
+	in continuous rendering mode.  Stop turning on OSC 8 defaults;
+	we don't know if the document will be viewed with a supporting
+	pager+terminal combination, and further we don't yet have a
+	mechanism for making `MR` man page cross references internal to
+	the document when they indicate groff man pages.
 
-	The new versions `glilypond v1.*' are not included there.
+2022-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+	man pages: Ship compilations in UTF-8 text and PDF.
 
-	* man/roff.man: For roff(7), add information about the free git
-	package RUNOFF.git with documentation about historical RUNOFF and
-	the available files written in the classical RUNOFF language..
+	Localization support and the resolution of Savannah #61266 have
+	made it practical to batch-render all of groff's man pages as a
+	single giant document.  Provide PDF and UTF-8 text (with ECMA-48
+	escape sequences, but not the italic attribute or OSC 8
+	sequences).
 
-2013-03-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+	Reasons for this addition include: {1} it is now possible,
+	whereas I don't believe it was in any previous groff release;
+	{2} many people still don't realize how much more pleasant
+	reading typeset man pages can be (while a subjective assessment,
+	I'm not alone1); {3} providing these forms permits full-text
+	searching of groff's entire man page corpus via the PDF viewer
+	or a pager like "less -R", the latter without sacrificing the
+	style variations of the text that aid the reader to comprehend
+	the material; {4} sentimentally, it honors the 50th anniversary
+	of the first Unix manual (dated 3 November 1971)
+	<https://www.bell-labs.com/usr/dmr/www/1stEdman.html>.
 
-	Rename `groff_lilypond' to `glilypond'.  So remove the former
-	source directory `<groff_src_dir>/contrib/lilypond' and newly
-	install `<groff_src_dir>/contrib/glilypond', which now has many
-	files.  The new version starts at `v1.0'.
+	* doc/doc.am (PROCESSEDDOCFILES): Add
+	'doc/groff-man-pages.{pdf,utf8.txt}'.
+	(GROFF_MAN_PAGES{1,2,3}): Add new macro storing names of all man
+	pages generated in the build tree.  Motivate the reason for 3
+	variables in a comment (it's due to groff locale switching).
+	(GROFF_MAN_PAGES_ALL): Add convenience macro for use in
+	dependency lists required by...
+	('doc/groff-man-pages.{pdf,utf8.txt}'): ...these targets.
+	Generate pages with the lint dial turned all the way up.
 
-	* m4/groff.m4, configure.ac: Add libdir information for
-	`glilypond'.
+	Fixes <https://savannah.gnu.org/bugs/?61900>.
 
-	* Makefile.in: Add `<groff_src_dir>/contrib/glilypond'.
+	1 "The manual was intended to be typeset; some detail is
+	sacrificed on terminals." (man(1), _Unix Time-Sharing System
+	Programmer's Manual_, Eighth Edition, Volume 1, February 1985)
 
-	Run `autoconf'.
+2022-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	`glilypond' can now be installed to the system.
+	man: Commit c64fd60dff was not quite cooked.  The localized
+	strings (in English) for the manual section titles need to be
+	set at every document load (i.e., when `TH` is called), but only
+	if the groff locale is "english".  When switching locales, these
+	strings were getting "stuck" in their non-English translations
+	even when returning to an English page.
 
-2013-03-17  Ingo Schwarze  <schwarze@openbsd.org>
+	* tmac/an.tmac (an*localize): New macro initializes strings.
+	(TH): Call `an*localize` if the locale is "english".
+	(initialization): Drop initialization of section title strings.
 
-	* font/devpdf/Makefile.sub: Build system fixes.
+	Continues fixing <https://savannah.gnu.org/bugs/?61734>.
 
-	(GROFF_FONT_FILES): Avoid installing Makefile.sub.orig when it's
-	around.
-	(install): Create $(DESTDIR)$(fontsubdir)/util when missing.
+2022-01-24  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-2013-03-05  Werner LEMBERG  <wl@gnu.org>
+	gropdf: Fix Savannah #61908
 
-	* doc/groff.texinfo: Improve documentation of `\s'.
+	* src/devices/gropdf/gropdf.pl: Adjust text position when
+	given landscape media (i.e -P-l).
 
-	Reported by Jim Avera <james_avera@yahoo.com>.
+	Fixes <https://savannah.gnu.org/bugs/?61908>.
 
-2013-02-16  Werner LEMBERG  <wl@gnu.org>
+	Thanks to KUBO Koichi for finding the problem and supplying a
+	patch.
 
-	* doc/groff.texinfo: Improve documentation of `.substring'.
+2022-01-24  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	Reported by Jim Avera <james_avera@yahoo.com>.
+	* src/devices/gropdf/gropdf.pl: A fix to importing pdf
+	versions > 1.4.
 
-2013-02-13  Werner LEMBERG  <wl@gnu.org>
+2022-01-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texinfo: Fix if-else example.
+	grotty: Skip part of test if locale doesn't support UTF-8.
 
-	Reported by Jim Avera <james_avera@yahoo.com>.
+	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+	Skip test of 'utf8' output device if locale lacks UTF-8 support.
+	But if the 'ascii' or 'latin1' test cases have already failed,
+	report that instead.
 
-2013-02-10  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?61891>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-	grops Make binary `%%BeginData' work; support `fontset' resource.
+2022-01-23 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
 
-	* src/devices/grops/psrm.cpp (resource_table): Add `fontset'.
+	man pages: Fix typos.
 
-	(resource_manager::read_resource_arg): Do a case insensitive
-	comparison.  The PostScript Reference Manual gives the following
-	example for a CFF resource (example 5.7):
+	Fixes <https://savannah.gnu.org/bugs/?61430>.
 
-	%!PS-Adobe-3.0 Resource-FontSet
-	%%DocumentNeedResources: ProcSet (FontSetInit)
-	%%Title: (FontSet/CFFRoman27)
-	%%Version: 1.000
-	%%EndComments
-	%%IncludeResource: ProcSet (FontSetInit)
-	%%BeginResource: FontSet (CFFRoman27)
-	/FontSetInit /ProcSet findresource begin
-	%%BeginData: 622532 Binary Bytes
-	/CFFRoman27 622503 StartData
-	... 622,503 bytes of binary data ...
-	%%EndData
-	%%EndResource
-	%%EOF
+2022-01-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Note the `ProcSet' and `FontSet' keywords.  While the old DSC
-	(Document Structure Convention) documentation doesn't cover
-	`FontSet' at all (the DSC documentation predates the invention of
-	CFF), it describes only `procset' (all letters downcase), and it
-	also says that the DSC parser works in a case sensitive manner.
+	tmac: Fix style nits in test.
 
-	In other words, `ProcSet' is not valid according to the DSC
-	documentation, only `procset' is.  So much about today's validity
-	of DSC...  This patch adapts grops's code to the PostScript
-	reality.
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh:
+	- Emit complaints about test environment to standard error.
+	- Replace lingering literal file name with variable expansion.
+	- Skip test if gs(1) fails, instead of reporting failure.
+	- Begin continued lines with operators, for visibility.
 
-	(resource_manager::do_begin_data): Fix typo (present since the
-	beginning) which prevented correct handling of binary data.
+2022-01-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grops/ps.h (resource_type): Add RESOURCE_FONTSET.
+	grohtml: Fix misspelled member variable.
 
-2013-02-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/devices/grohtml/post-html.cpp (class html_printer):
+	Rename `supress_sub_sup` to `suppress_sub_sup`.
 
-	* contrib/lilypond: New files for adding lilypond parts into groff
-	files.
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pdfpic: Fix Savannah #58206.
+
+	* tmac/pdfpic.tmac (PDFPIC): Scrub null bytes out of pdfinfo(1)
+	output.  Thanks to an anonymous contributor for the patch (the
+	commentary about it is mine, if someone wants an argument).
+
+	Fixes <https://savannah.gnu.org/bugs/?58206>.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pdfpic: Regression-test Savannah #58206.
+
+	* tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh: Do
+	it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pdfpic: Refactor.
+
+	Now that the package does not abort upon the first whiff of any
+	trouble, avoid littering groff's name spaces.  Take this
+	opportunity to rename registers and strings to have obvious
+	meaning to even the casual reader.
+
+	* tmac/pdfpic.tmac: Do it.
+	(pdfpic@cleanup): New macro removes temporary strings and
+	registers.
+	(PDFPIC): Call the cleanup macro upon entry; this way, if we
+	errored out from a previous call, we avoid confusion.  (We don't
+	clean up upon an error return because the leftover objects might
+	be useful for troubleshooting.)  Rename registers and strings,
+	to get them under name space discipline and also to better
+	suggest their purpose.
+	- convert-pdf     -> pdfpic*do-conversion
+	- pdf-offset-mode -> pdfpic*offset-mode
+	- pspic-args      -> pdfpic*pspic-args
+	- pdf-offset      -> pdfpic*indentation
+	- is-pdf          -> pdfpic*file-extension
+	- img-file        -> pdfpic*file-name
+	- pdf-wid         -> pdfpic*width
+	- pdf-ht          -> pdfpic*height
+	- pdf-deswid      -> pdfpic*desired-width
+	- pdf-desht       -> pdfpic*desired-height
+	Call cleanup macro before returning upon successful operation.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pdfpic: Improve robustness.
+
+	* tmac/pdfpic.tmac (@abort): Rename to `pdfpic@error`.  This is
+	an auxiliary package, and something else could very well step on
+	the former name (or worse, we break it if we're loaded later).
+	(pdfpic@error): Stop aborting; simply report an error.  It's up
+	to the user how serious `PDFPIC` macro problems are.  As noted
+	in a comment, the user can easily `am pdfpic@error` to tack an
+	`ab` request onto the end of its definition.  Always report
+	input file name and line number.  Replace "PDFPIC" prefix with
+	the name of the macro file complaining, to make it easier for
+	groff non-experts to find.
+	(PDFPIC): Return upon errors.  Recast diagnostic messages.  Stop
+	implying that we perform any sort of probing test of file type
+	{there's no telling what pdfinfo(1) will say}.  Apply new
+	'stringdown' request so that we accept '.pdf' file name
+	extension in any lettercase.  Test file argument for existence
+	before proceeding (acknowledge TOCTTOU exposure).  Skip file if
+	pipeline returned a non-zero exit status or the registers into
+	which we extract the height and width are undefined (indicating
+	failure of a temporary file to be created or read).  Reject
+	files with non-positive image width or height reported by
+	pdfinfo.  Validate `width` and `height` arguments, if given,
+	rejecting non-positive values.
+
+	Fixes <https://savannah.gnu.org/bugs/?61892>.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Make `Pa` macro interpolate basic Latin tilde on all
+	output devices.
+
+	* tmac/doc.tmac (Pa): Do it.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Fix incorrect line numbers in diagnostics.  Line numbers
+	for multiple format-time diagnostics emitted by tbl(1)-generated
+	groff input were off by +5 lines.
+
+	* src/preproc/tbl/table.cpp: Fix it.
+	(NOP_NAME): Add new preprocessor symbol to construct name of
+	"nop" macro to be used as end macro for `ig` requests inside
+	macro definitions.
+	(table::init_output, table::compute_expand_list,
+	table::compute_separation_factor):
+	- Move `entry_list->set_location()` calls to more auspicious
+	  locations.
+	- Replace "around line X" language in diagnostic messages with a
+	  more idiomatic, and less embarrassing, simple report of an
+	  integer.
+	(table::init_output):
+	- Add `entry_list->set_location()` call right before emitting
+	  diagnostic about a table row not fitting on a page.
+	- Turn off eqn(1) delimiters when emitting diagnostic about a
+	  boxed table not fitting on a page (necessitating `.TS H`
+	  support), using new NOP_NAME-based end macro to achieve this
+	  inside a macro definition.
+	(table::compute_expand_list): Suppress issue of too-wide table
+	diagnostic when the `EXPAND` table flag is set (corresponding to
+	the `expand` region option), because other code already emits
+	diagnostics in this case.
+
+	Fixes <https://savannah.gnu.org/bugs/?60598>.  Problem appears
+	to date back to commit 3bc4a53a45, 2013-01-07.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Add unit test for format-time diagnostics.
+
+	Ensure that the various format-time diagnostics that a
+	tbl-preprocessed document can generate (1) occur when they are
+	supposed to and (2) are appropriately suppressed by the
+	"nowarn" and/or "nokeep" region options.  One of them is an
+	error and cannot be suppressed by the former, but _can_ be by
+	"nokeep", which is arguably a bug (Savannah #61878).
+
+	* src/preproc/tbl/tests/format-time-diagnostics-work.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.
+
+2022-01-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Trivially refactor.
+
+	* src/preproc/tbl/table.cpp (table::compute_expand_width):
+	Declare and initialize variables closer to use.  Also, the width
+	computed is compared to the line length and indentation, so use
+	these well-established *roff terms in the diagnostic message.
+
+2022-01-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Fix Savannah #61854.
+
+	* src/preproc/tbl/table.cpp (compute_expand_width): To properly
+	warn if a table is too wide to fit between the indentation and
+	the right margin, we need to compute its column widths including
+	those eligible for expansion via the 'x' column modifier; we
+	cannot use the same expression that we do to determine the
+	amount of space we have to distribute among the expanded
+	columns.  Iterate through columns again (the function was
+	already doing so twice), once to potentially produce the
+	warning, and then as before to distribute any available width.
+	In other words, warnings were only being emitted for too-wide
+	tables where one or more columns used the 'x' modifier.
+
+	Fixes <https://savannah.gnu.org/bugs/?61854>.
+
+2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Don't add leaders that don't lead anywhere.
+
+	* tmac/s.tmac (toc*end-entry): If no page number string
+	`toc*num` is defined, don't interpolate its emptiness prefixed
+	with a leader (and tab).  This makes "no" as the first argument
+	to `XS` and `XA` work as documented, suppressing not only the
+	page number but the leader after the entry.
+
+	Fixes <https://savannah.gnu.org/bugs/?61853>.
+
+2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Add regression test for Savannah #61853.
+
+	* tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh: Do
+	it.
+	* tmac/tmac.am (tmac_TESTS): Run it.
+
+2022-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Fix bad unit test.
+
+	* tmac/tests/e_chapter-titles-work.sh: Fix missing shell test at
+	end of script, which caused it to exit successfully regardless
+	of any test failures.  Irritating.  This is among the fruits of
+	the "never, ever use 'set -e'" tree.  (This religion has a thick
+	bible: <https://mywiki.wooledge.org/BashFAQ/105>.)  Fortunately,
+	all the tests pass legitimately.
+
+2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	font: For 'ascii' and 'latin1' devices, consistently define
+	glyphs for ordinary characters before their special character
+	aliases.  This parallels existing usage for the 'cp1047' device,
+	and, I think, makes the file contents slightly more accessible.
+
+	* font/devascii/R.proto:
+	* font/devlatin1/R.proto: Do it.
+
+2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Update diagnostic messages.
+
+	* src/devices/grohtml/post-html.cpp (assert_state::add)
+	(assert_state::compare, replace_negate_str)
+	(assert_state::check_value_error, make_val): Make format of
+	internal assertion system messages shorter and more mutually
+	parallel.
+	(html_printer::set_char, html_printer::set_numbered_char)
+	(html_printer::set_char_and_width): Parallelize diagnostic
+	messages with libdriver; see yesterday's commit.
+	(main): Put information in argument to `assert()`; see commit
+	11b43053, 24 November.
+
+2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	nroff: Emit usage message on usage errors.
+
+	* src/roff/nroff/nroff.sh: Store the usage message in a shell
+	variable instead of a here document, and sling it to the
+	standard output or standard error streams, as appropriate.
+
+2022-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml,groff,nroff,troff: Tweak usage message.
+
+	* src/devices/grohtml/post-html.cpp (usage):
+	* src/roff/groff/groff.cpp (synopsis):
+	* src/roff/nroff/nroff.sh:
+	* src/roff/troff/input.cpp (usage): Stop putting an ellipsis
+	inside a bracket expression (for file arguments); that suggests
+	misleading complexity.
+
+	* src/devices/grohtml/post-html.cpp (usage): Also don't set
+	metasyntactic variable names in screaming capitals when they are
+	separated from option letters by space and thus can't be
+	confused with them.
+
+2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libdriver: Update diagnostic messages.
+
+	* src/libs/libdriver/printer.cpp (printer::find_font): Describe
+	the problem encountered instead of saying lamely "sorry, I can't
+	continue".
+	(printer::set_char_and_width, printer::set_numbered_char):
+	Characterize input as "invalid", not "bad"; see commit bb7512b5,
+	17 September.  When referring to font mounting position, say so.
+	(printer::set_char_and_width): Describe required input character
+	as "ordinary", not "ascii".  Apart from the incorrect casing,
+	doing so better aligns with our terminology in groff_char(7),
+	groff_out(5), our Texinfo manual, and other diagnostic messages;
+	moreover, the use of "ascii" is potentially confusing to those
+	whose environments use another encoding, like UTF-8 or IBM code
+	page 1047.
+
+	Fixes <https://savannah.gnu.org/bugs/?61829>.
+
+2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grotty: Check basic Latin ("ASCII") glyph mappings.
+
+	* src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh:
+	Do it.
+	* src/devices/grotty/grotty.am (grotty_TESTS): Run test.
+
+2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	font,tmac: Simplify Unicode character mapping process.
+
+	* tmac/unicode.tmac: Drop.  It was originally added in 2005 to
+	suppress horizontal spacing of glyphs in the range U+0483..9.
+	Its purpose has wandered over the years; most recently to map
+	the Basic Latin ("ASCII") hyphen-minus, apostrophe, and grave
+	accent to special characters (and thus ultimately to the General
+	Punctuation block).  But this is unnecessary since the font
+	descriptions for devices with the `unicode` property can provide
+	this information, and anyone who wants to alter the mappings can
+	change either font description files, output device macro files,
+	or troffrc; or add `char` requests to their macro packages or
+	documents (in decreasing magnitude of ambition).
+
+	* tmac/html.tmac:
+	* tmac/tty.tmac: Stop sourcing unicode.tmac.
+
+	* tmac/tmac.am (TMACNORMALFILES): Stop shipping it.
+
+	* font/devutf8/NOTES: Drop remarks about mapping of \a~,
+	\a^, and Basic Latin circumflex accent and tilde.  Not only do
+	I disagree with the reasoning (whether these glyphs are "too
+	small" depends on the font used by the terminal emulator, over
+	which we have no control), but this mapping happens in a
+	completely different part of the source tree,
+	src/libs/libgroff/glyphuni.cpp.
+
+	* font/devhtml/R.proto:
+	* font/devutf8/R.proto: Add mappings for the five Basic Latin
+	characters that map surprisingly (see groff_char(7)) and are not
+	syntactically significant to troff.  Three of these are ported
+	from unicode.tmac.
+	(html): Don't migrate the hyphen-minus--yet.
+
+2022-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tty-char.tmac: Drop redundant logic.  We don't need to
+	source the `cp1047` or `latin1` files here; `troffrc` will
+	already have loaded `tty` for us, which loads whichever applies.
+
+2022-01-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Separate concerns better; stop re-generating plain
+	text and HTML documents when the 'doc' target is updated; these
+	are already handled by the 'build_infodoc' target.
+	(build_infodoc): Use existing phony targets for plain text and
+	HTML output files instead of repeating filename literals.
+	(doc_all): Remove those same two phony targets from this one's
+	dependencies.
+
+2022-01-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp: Rename `eoi_macro_name` to
+	`end_of_input_macro_name`.  It's long, yes, but better parallels
+	`blank_line_macro_name` and `leading_spaces_macro_name`.  It is
+	not used in lengthy expressions and furthermore clarifies the
+	meaning of the nearby function name `eoi_macro` in one use.
+
+2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/preconv/preconv.1.man (Limitations): Add
+	subsection.
+
+	Fixes <https://savannah.gnu.org/bugs/?55035>.
+
+2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	docs: Be more careful with control characters when they are
+	word-initial in filled text lines.  The idea is to prevent
+	baffling surprises if a sentence is recast in a text editor, and
+	a word beginning with a dot or neutral apostrophe is reflowed
+	onto the beginning of the next input line--suddenly it is parsed
+	as a control character.  Based on a patch by Bjarni Ingi
+	Gislason.
+
+	* contrib/hdtbl/groff_hdtbl.7.man:
+	* doc/automake.mom:
+	* doc/meintro.me.in:
+	* doc/meintro_fr.me.in:
+	* doc/pic.ms:
+	* doc/webpage.ms:
+	* src/devices/gropdf/gropdf.1.man: Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?51312>.
+
+2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Font Description File Format):
+	* man/groff_font.5.man (Font description file format): Document
+	restriction of kerning adjustment to glyph pairs from within a
+	single font (since that is the scope of the font description).
+
+	Fixes <https://savannah.gnu.org/bugs/?44715>.
+
+2022-01-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* contrib/groff_filenames/groff_filenames.5.man: Remove
+	superfluous paragraphing macro.
+
+	Fixes <https://savannah.gnu.org/bugs/?55084>.  Thanks to Bjarni
+	Ingi Gislason for the report and a suggested patch.
+
+2022-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Operators in Conditionals): Update explanation
+	of output-comparison conditional operator.
+
+	Fixes <https://savannah.gnu.org/bugs/?60836>.
+
+2022-01-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Use pnmtops(1)'s -quiet option if possible, to quieten
+	build.
+
+	* m4/groff.m4 (GROFF_PNMTOOLS_CAN_BE_QUIET): Add new macro to
+	test pnmtops for support for (undocumented) '-quiet' option.
+
+	* configure.ac: Perform the check.
+
+	* doc/doc.am: Alter check of shell variable `pnmtops_nosetpage`
+	{processed by AC_SUBST} to correctly match even if pnmtops
+	accepts the '-quiet' option.
+
+2022-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Manage hyphenation mode more carefully in localization
+	packages.
 
-2013-02-07  Werner LEMBERG  <wl@gnu.org>
+	* tmac/{cs,de,it,sv}.tmac: Localize the man(7) package's HY
+	register.
 
-Version 1.22.2 released
-=======================
+	* tmac/{cs,de,fr,it,sv}.tmac: When localizing the ms(7) package,
+	use mode "2" instead of "3": the 'hy' request complains of
+	contradictory hyphenation modes if "3" is used (the semantics of
+	the hyphenation mode are complex and non-orthogonal; see
+	groff(7) or our Texinfo manual).
 
-	* NEWS, REVISION, doc/groff.texinfo, doc/webpage.ms: Updated.
+	* tmac/{cs,de,en,fr,it,sv}.tmac: If the one language-independent
+	hyphenation bit (don't hyphenate just prior to a page location
+	trap) is set, preserve it; this way a system's troffrc or a
+	macro package can set it and it will not get turned off by the
+	localization package, which for best results should be loaded
+	after any full-service package (and any auxiliary package
+	requiring localized strings, though none are yet distributed
+	with groff).
 
-	* configure: Regenerated.
+2022-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/texinfo.tex: Updated from `texinfo' repository.
+	tmac: Add unit test for localization macro files.  Right now
+	this just covers the hyphenation mode.
 
-	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+	* tmac/tests/localization-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2013-02-07  Werner LEMBERG  <wl@gnu.org>
+2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/libs/gnulib/*: Update `gnulib' files.
+	indxbib: Document --version in usage message.
 
-2013-02-02  Gilles Espinasse  <g.esp@free.fr>
+	* src/utils/indxbib/indxbib.cpp (usage): Document --version
+	option.  Use more informative metasyntactic variable names.
+	Organize usage message consistently with our others, and stop
+	wrapping the output lines: we know neither the width of the
+	terminal nor the length of the `program_name` string we're
+	interpolating.  See commit b4de44f0, 19 July 2021.
 
-	grohtml Don't ignore return value of `dup'.
+2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/html/pushback.cpp (pushBackBuffer::pushBackBuffer,
-	pushBackBuffer::~pushBackBuffer): Abort if `dup' fails.
+	libbib: Refactor index header checking.
 
-2013-01-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/libs/libbib/index.cpp: Move more header validity checks...
+	(index_search_item::load): ...from here...
 
-	* tmac/groff_man.man: Fix wrong connection for tbl(1).
+	(index_search_item::check_header): ...to here.  Test all size
+	values in header for negative values (never valid) before
+	proceeding.  (These data could be changed to unsigned integer
+	types in the file format, but that would require bumping the
+	file version.  That in turn would make indexes generated with
+	groff 1.23 unusable on systems running older groffs and, perhaps
+	worse, would make groff 1.23 reject index files produced by
+	older groffs.  On the other hand, the regeneration of index
+	files should be, for those who use them, a common activity, and
+	as long as the original database files are kept intact, it seems
+	likely that most people, given modern machines, won't even
+	notice a slowdown in document generation when refer(1) and
+	friends fail to open the indices and fall back to full-text
+	searches of the originals.  So we could still consider revising
+	the file format before the groff 1.23 release.)
 
-2013-01-29  Werner LEMBERG  <wl@gnu.org>
+	* src/libs/libbib/index.cpp (index_search_item::load):
+	Explicitly perform widening conversion from signed `off_t` value
+	{from a stat(2) buffer} to an unsigned integer; quietens
+	compiler warning about comparison between integers differing in
+	signedness.
 
-	* doc/groff.texinfo: Fix documentation of .LP macro in ms.
-	Problem reported by Omari Norman <omari@smileystation.com>.
+2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-01-29  Werner LEMBERG  <wl@gnu.org>
+	* configure.ac (AC_CHECK_HEADERS): Expect stdbool.h, since we
+	now use it in src/include/lib.h.
 
-	* doc/Makefile.sub (uninstall_sub): Handle `gnu.eps'.
+2022-01-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-01-29  Werner LEMBERG  <wl@gnu.org>
+	libbib, libgroff, indxbib: Slightly refactor.
 
-	Building clean-ups.
+	Also, it's silly to test even numbers > 2 for primality.  Stop.
 
-	* Makefile.in: Use $(top_srcdir) where appropriate.
-	* Makefile.sub (M4MACROS): Add `fcntl-o.m4' and `localcharset.m4'.
+	* src/include/lib.h: Include `stdbool.h` since this header file
+	is used for both C and C++ code.
 
-	* font/devpdf/Makefile.sub (UTILFILES): Removed, unused.
-	(MOSTLYCLEANADD): Add `BuildFoundries'.
-	* src/devices/gropdf/Makefile.sub (MOSTLYCLEANADD): Add `pdfmom'.
+	* src/include/lib.h (is_prime):
+	* src/libs/libgroff/prime.cpp (is_prime): Boolify.  Return
+	Boolean instead of integer literals and demote return type to
+	`bool`.  Include `assert.h` and add assertion to reject
+	mathematically offensive input.
 
-2013-01-24  Bernd Warken  <groff-bernd.warken-72@web.de>
+	* src/libs/libbib/index.cpp
+	(index_search_item::read_common_words_file): Test only odd
+	numbers for primality.
+	* src/utils/indxbib/indxbib.cpp (main): Same.  Since the number
+	comes from user input, make it (a potential hash table size) odd
+	first.
 
-	* Add a shell command to 'MANIFEST' that displays all man source
-	files and their section.
+2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2013-01-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+	man: Internationalize and localize.
 
-	* Add email address in all files having the name.
+	* tmac/an.tmac (TH): Indirect predefined manual section titles
+	through new strings `an*section1-9` so that they can be
+	localized.
+	(initialization): Give these strings English defaults.
+	(TH): Move `ss` request from here...
 
-2013-01-14  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/en.tmac: ...to here.  It's not the man(7) package's
+	business what the inter-word and inter-sentence spacing values
+	are.  Also, having the correctdisputed inter-sentence spacing
+	value for English in its localization file restores it for the
+	benefit of multi-lingual documents (mainly roff applications
+	other than man(7)).
 
-	* src/devices/gropdf/gropdf.pl (do_x, do_p, do_s, Set_LWidth): The
-	grops driver defaults to round linecaps and linejoins, gropdf
-	incorrectly used butt caps and miter joins.
+	* tmac/{cs,de,fr,it,sv}.tmac: Supply translations for the manual
+	section titles; these were done by a monoglot American employing
+	Google Translate, so those scandalized or running into howlingly
+	wrong locutions are warmly invited to submit corrections.
 
-	(Since the MOM package expects to use butt caps and miter joins
-	(emitting the necessary postscript code to change the caps and
-	joins), gropdf now parses the same postscript commands.)
+	* tmac/trans.tmac: Load localized strings.
 
-	* src/devices/gropdf/gropdf.man: Document the handling of linecaps
-	and linejoins.
+	Fixes <https://savannah.gnu.org/bugs/?61734>.
 
-	* tmac/pdf.tmac (pdfbookmark): Fix bug where the current
-	PDFOUTLINE.FOLDLEVEL may not be honoured if warnings of the type
+2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	macro warning: adjusted level n bookmark; should be <= n
+	* src/utils/grog/grog.pl: Handle auxiliary macro package
+	arguments correctly.
+	(process_arguments): Don't append the argument to the '-m'
+	option to the command line; requested macro packages have
+	dedicated logic.
+	(construct_command): When iterating through requested package
+	list, assume each element is an auxiliary package unless it
+	matches an element in the list of main packages.  If the
+	assumption holds, append the package name to a new list,
+	`auxiliary_package_argument` (prefixed with '-m').  Push this
+	list onto the command line after any main package.
 
-	Added copyright and mention debt owed to Keith Marshall for
-	original `pdfmark.tmac', upon which `pdf.tmac' is largely based.
+	Also rename `$selected_main_package` to `$main_package` for
+	brevity, and drop unused global lists `m` and
+	`supplemental_package`.
 
-	* font/devpdf/Foundry.in, font/devpdf/util/BuildFoundries.pl
-	(LocateFile): The font for EURO had the wrong entry in the
-	`download' file (it pointed to The font in the build directory,
-	which is wrong).  It has always been permissable to include a path
-	along with the font name in the Foundry file, but until now the
-	font had to exist to be valid.  It is now permitted to start the
-	path with an asterisk which tells BuildFoundry to use the
-	path/filename in the download file without checking if the font
-	exists.  This allows the font to be found in `../devps' even
-	though it is not there during the build (if source and build are
-	different), but will be there after the install.
+	Fixes <https://savannah.gnu.org/bugs/?61758>.
 
-2013-01-13  Werner LEMBERG  <wl@gnu.org>
+2022-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	eqn Fix display of matrices in nroff output.
+	* src/utils/grog/tests/smoke-test.sh: Add test cases for user
+	specification of auxiliary macro packages.
 
-	Problem reported by Andy Spencer <andy753421@gmail.com>.
+2022-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/pile.cpp (pile_box::compute_metrics,
-	matrix_box::compute_metrics): Fix rounding.
+	me: Drop unnecessary code.  Apart from being superfluous, it
+	prevented a user-defined value of the `sx` register from being
+	applied to the first footnote marker interpolated, a subtlety
+	that escaped my notice because the first footnotes in our
+	"meref" and "meintro" documents are not numeric, but symbolic,
+	and their markers occurred on lines with vertical space above
+	and below.  (The bug was further masked by an otherwise
+	redundant redefinition of the `*` string inside the `)f` macro.)
 
-2013-01-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/e.tmac ()f, +c): Stop redefining footnote marker string
+	`*` after updating the automatic footnote number; its
+	interpolation is already backslash-protected.
+	()d, pd): Stop redefining delayed text marker string `#` for an
+	analogous reason.
+	(initialization): Drop unneeded `_*` and `_#` strings.
 
-	* tmac/europs.tmac: Protect against missing fonts.
+	Thanks to Robert Goulding for his feedback and patience.  See
+	<https://savannah.gnu.org/bugs/?61025>.
 
-2013-01-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2022-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/e_footnote-marks-work.sh: Enhance test.  Confirm
+	that the automatic footnote number is reset to 1 by starting a
+	new chapter with the `+c` macro.
+
+2022-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Revise `n1` and `n2` interface and behavior.
+
+	There were several bugs in the previous implementation.
+
+	* tmac/e.tmac (po): Issue diagnostic if an attempt is made to
+	set the page offset to a negative value.
+
+	(n1): Accept new optional "C" argument to behave more (but not
+	exactly) like roff(1), as the formerly-recognized "c" argument
+	to `n2` did.  If present, the line length is reduced by the same
+	amount (in new interface register `no`) as the line number field
+	to preserve the overall line length.  Save the previous line
+	length in internal register `_l` and set a flag, stored in `?N`,
+	indicating this reduction.  Otherwise, the macro expects to be
+	able to reduce the page offset to accommodate the line number.
+	If it cannot (for example, with the zero page offset default
+	used by nroff output devices), see above re: the `po` macro.
+
+	(n2): Cache the last line number that may have been output,
+	instead of the current one, so that we can operate on it
+	consistently with user expectations.  Do this earlier, and
+	rename this macro-local variable from `_ln` to `_n` so that we
+	don't need groff's `do` request to operate on it.  Drop
+	recognition of "c" as an optional second argument.  If turning
+	off line numbering: if the line length was shortened (`?N`)
+	restore the saved value and delete `_l` register; otherwise,
+	reverse the change to the page offset.  Delete `_n` register.
+
+	(initialization): Assign `\w'0000'u` to `no` register; this was
+	previously hard-coded in `n1` and `n2`.  Initialize `?N` with 0.
+
+	* doc/meref.me.in (roff Support): Update to reflect interface
+	changes and describe behavior more accurately.
+
+	* doc/meref.me.in (Summary):
+	* tmac/groff_me.7.in (Registers): Document new `no` register and
+	mark it as a groff extension.
+
+	* NEWS: Add item documenting interface changes.
+
+	Fixes <https://savannah.gnu.org/bugs/?61646>.  See the comments
+	in the report for a lengthy enumeration of rendering problems
+	exhibited by the previous implementation.
+
+2022-01-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Add unit test for line numbering feature.
+
+	* tmac/tests/e_line-numbering-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/post-html.cpp (style::style): Add
+	initializer to argumentless constructor to avoid later read from
+	uninitialized memory in `html_printer::do_font`.
+
+	Fixes <https://savannah.gnu.org/bugs/?61748>.
+
+2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff: Add regression test for Savannah #61748.
+
+	* src/roff/groff/tests/html_works_with_grn_and_eqn.sh: Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run it.
+
+2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/post-html.cpp
+	(html_printer::do_file_components): Emit fatal diagnostic if
+	we're unable to `freopen()` standard output.  Quietens
+	`-Wunused-result` warning from GCC 8.3.
+
+2021-12-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/html.h (INT_HEXDIGITS): Add new constant
+	to store the maximum possible quantity of digits in the
+	hexadecimal representation of an `int`.
+
+	* src/devices/grohtml/html-text.cpp (html_text::issue_tag):
+	* src/devices/grohtml/post-html.cpp (html_printer::do_body):
+	Guard against format string overflow by large integers in RGB
+	color channel specifications; in a *printf format string, the
+	precision (like the field width) is a _minimum_.  Quietens
+	`-Wformat-overflow` warnings from GCC 8.3.
+
+2021-12-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/html/pre-html.cpp (get_image_generator): Clarify
+	complex conditional expression.  Quietens `-Wparentheses`
+	warning from GCC 8.3.
+
+2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Rename new `$x` register to `sx`.  Since we expect the
+	user to set this register directly, it should not be named with
+	a leading '$' per the "me Reference Manual".
+
+	* tmac/e.tmac (initialization, {, }): Do it.
+
+	* tmac/groff_me.7.man:
+	* doc/meref.me.in:
+	* NEWS: Update documentation.
+
+	* doc/meintro.me.in:
+	* doc/meintro_fr.me.in:
+	* doc/meref.me.in: Sync with new register name.
+
+	See <https://savannah.gnu.org/bugs/?61025>.  Thanks to Dave
+	Kemper for the discussion in
+	<https://savannah.gnu.org/bugs/?61710>.
+
+2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Slightly refactor.
+
+	* src/roff/troff/div.cpp:
+	* src/roff/troff/div.h:
+	* src/roff/troff/input.cpp: Rename variables to reduce confusion
+	between "end macros" and "end-of-input macros".  Call the latter
+	"eoi" macros for brevity.
+
+2021-12-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Fix code style nits.
+	  - Use new terminology in diagnostic.  See commit 66ac1a8db9,
+	    11 December.
+	  - Drop unused '&&&' annotation for macro definitions.  This
+	    was a BSD me(7) implementation detail wherein parts of the
+	    package were broken out into module files, loaded if/when
+	    their macros were called.  groff me(7) is monolithic, except
+	    for devtag and refer(1) support.
+	  - Remove '&&' end macro when we're done using it.
+
+2021-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: (Re-)localize strings.
+
+	* tmac/{cs,de,fr,it,sv}.tmac: Update package localizations to
+	use new resources.  As a happy side effect (and with the new
+	appendix string), the `+c` macro is now localized for Czech,
+	German, and Swedish.
+
+	* doc/meintro_fr.me.in (Les Parties du Document): Update example
+	to reflect mixed-case default string used in chapter headings.
+
+	* tmac/tests/e_ld-works.sh: Add tests for localization.
+
+2021-12-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Internationalize strings.
+
+	* tmac/e.tmac (initialization): Introduce internal
+	`_mo1`..`_mo12`, `_dw1`..`_dw7`, and `_td_format` strings (with
+	English defaults).  Define them outside of the new `ld` macro so
+	that they can be overridden by localization packages.
+	(ld) <dw, mo, td>: Populate via the above new strings.
+	* tmac/trans.tmac: Stop defining `mo` and `dw`.  Instead, make
+	them aliases of the new strings above.   Handle `wa` and `wc`
+	similarly.
+
+2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Add `ld` macro to re-init date/l10n stuff.
+
+	* tmac/e.tmac (ld): New macro updates `y2` and `y4` registers
+	and `wa`, `wc`, `mo`, `dw`, and `td` strings.
+
+	* doc/meref.me.in (Miscellaneous, Predefined Strings):
+	* tmac/groff_me.7.man (Macros): Document it.
+
+	* tmac/tests/e_ld-works.sh: Add unit test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?61670>.
+
+2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/e_chapter-titles-work.sh: Add unit test for chapter
+	heading feature.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-12-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Ease localization and customization by exposing
+	strings for "Chapter" and "Appendix" instead of hard-coding
+	these words into the `$c` macro.
+	(initialization): Define new `wa` and `wc` strings.  Separate
+	these and existing localization strings from `y2` and `y4`
+	initialization since the latter don't involve natural languages.
+	($c): Interpolate these strings in chapter and appendix headings
+	and in calls to `$C` hook macro.  Set "Chapter" and "Appendix"
+	in mixed case instead of full capitals, and set one
+	adjustable nonbreaking word space `\~` between them and the
+	chapter number instead of two unadjustable nonbreaking spaces.
+	{These changes do slightly alter the default output of the
+	package when the `+c` macro is used.}
+
+	* doc/meref.me.in (Predefined Strings):
+	* tmac/groff_me.7.man (Strings): Document new strings.
+
+	* doc/meintro.me.in (Parts of the Basic Paper): Update example
+	to reflect mixed-case default string.
+
+	Fixes <https://savannah.gnu.org/bugs/?61661>.
+
+2021-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (@p): Deactivate right alignment (the effect of
+	groff's `rj` request) when starting a new paragraph.
+	* doc/meref.me.in (Paragraphing) <lp>: Document this.
+
+2021-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac ()c): Add bounds check to avoid attempting to set
+	a negative indentation, provoking a troff warning.  Problem
+	exposed by formatting "meintro_fr.me" document with default
+	nroff mode line length.
+
+2021-12-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Slightly refactor (boolify).
+
+	* src/roff/troff/div.cpp:
+	* src/roff/troff/div.h:
+	* src/roff/troff/env.cpp:
+	* src/roff/troff/input.cpp: Rename variables and demote from
+	  `int` to `bool`.  Initialize and assign them using Boolean
+	  literals.  The new names try harder to express a logical
+	  predicate, and start with verbs to resist interpretation as
+	  noun phrases.
+	  - exit_started -> is_exit_underway
+	  - done_end_macro -> is_end_macro_finished
+	  - seen_last_page_ejector (demoted but not renamed)
+	  - began_page_in_end_macro (demoted but not renamed)
+
+2021-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Explain presence of undocumented `$r` and `$R`
+	registers.
+
+	Fixes <https://savannah.gnu.org/bugs/?61683>.
+
+2021-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (bc): To get to the next column, space by the page
+	length `.p`, not by the distance to the next trap (or 24 inches,
+	as hard-coded in me(7) traditionally).  It is up to any sprung
+	traps to issue further space requests or otherwise ensure a
+	transition to the next column.
+
+	See <https://savannah.gnu.org/bugs/?55081> for discussion.
+
+2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac ({): Fix missing scaling unit in arithmetic
+	expression: broke footnotes in troff mode.  Problem introduced
+	by me in commit 6eafd208, 16 December.  Thanks to Robert
+	Goulding for the (informal) report.
+
+2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (doc/{pic,webpage}.html): Quieten build.  Stop
+	passing `-p` (progress) option to postprocessor, which produces
+	TeX-like bracketed page numbers when images occur.
+
+2021-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (.ms.html): Drop unused suffix rule.
+
+2021-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am (tmac_XFAIL_TESTS): Mark test
+	"e_footnotes-work-with-columns.sh" as expected to fail (as it
+	does now, consequent to a reverted commit).
+
+2021-12-16  Dave Kemper <saint.snit@gmail.com>
+
+	* man/groff_tmac.5.man: Fix minor errors.
+
+	Fixes <https://savannah.gnu.org/bugs/?61633>.
+
+2021-12-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Parameterize line height adjustment when super/subscripting.
+
+	* tmac/e.tmac (initialization): Assign 0.2m to register `$x`.2m.
+	({, <}: Apply adjustment, multiplied by -1 for superscripts.
+
+	* doc/meref.me.in:
+	* tmac/groff_me.7.man: Document it.
+
+	* NEWS: Add item.
+
+	* doc/meintro.me.in:
+	* doc/meintro_fr.me.in:
+	* doc/meref.me.in: Forego extra line height for more attractive
+	typesetting.
+
+	Fixes <https://savannah.gnu.org/bugs/?61025>.  Thanks to Robert
+	Goulding for the suggestion.
+
+2021-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac ($c): Draw the footnote separator no wider than
+	the column width.
+
+	Fixes <https://savannah.gnu.org/bugs/?61675>.
+
+2021-12-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (2c): Accept an empty first argument, permitting
+	the number of columns to be specified but preserving the default
+	column separation.
+
+	Fixes <https://savannah.gnu.org/bugs/?61671>.
+
+2021-12-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (initialization): Initialize `$C` hook, preventing
+	`mac` warnings from troff(1) if chapter title feature is used.
+
+2021-12-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac (i, bi): Add italic corrections.
+
+2021-12-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Fix groff warnings and correctness issue.
+	(n2): Prefix `ie` request with `do` because it uses the groff
+	`\B` escape sequence.  Use braces to group multiple requests
+	after an `el` request: `ie` and `el` count as two requests, not
+	one.  Add comment regarding the unfortunate choice of brace
+	style given *roff's syntactical constraints.
+	(n2, (c): Conceal bare tab in request argument list (exposed by
+	no longer stripping the macro file).
+
+2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Revise diagnostic messages to follow GNU Coding Standards,
+	identifying what is emitting them.
+
+	* tmac/e.tmac (_e): New string holds "e.tmac".
+	(@err): New macro constructs and issues diagnostics.  Add file
+	name to messages when available.  Suppress line number when
+	unavailable.
+	(check_page_length, @z, @h, n2, sk, @p, @(, @), (c, )c, EQ, (f,
+	++, @U): Call `@err` instead of invoking `tm` request.  Revise
+	wording of messages in an attempt at clarity.
+
+	Continues the long process of fixing Savannah #52463.
+
+2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Slightly refactor footnote numbering.
+	()f): Tighten code style and end string definition with comment.
+	(+c, initialization): Drop unused auto-incrementation of
+	footnote number register `$f`.  Add new string `_*` to use when
+	{re-}initializing `*` outside of a footnote diversion, and
+	interpolate the footnote number register instead of a literal.
+
+2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/e_footnote-marks-work.sh: Add unit test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-12-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Fix automatic numbering of delayed text.
+	(initialization): Add `_#` string for use in multiple
+	assignments of `#` string.
+	(initialization, pd): Remove unused auto-incrementation from
+	`$d` delayed text number register.
+	()d): Increment `$d` register unconditionally, no longer
+	conditionally on whether the delayed text marker string `#` has
+	been interpolated.
+	()d, pd): Update `#` string using new `_#` string.  Stop
+	initializing the string with `\k` mark-setting escape sequence.
+
+	* doc/meref.me (Annotations) <)d>: Document now-unconditional
+	incrementation of `$d` register.
+
+	Fixes <https://savannah.gnu.org/bugs/?61632>.
+
+2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/e_delayed-text-marks-work.sh: Add test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Rename internal register out of user name space.
+	(@f): Rename `VL` to `__`; remove it immediately after using it.
+
+2021-12-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/meref.me: Fix documentation error; the `$s` macro draws a
+	horizontal line of 2 inches' length, not 1.5 inches.
+
+	Fixes <https://savannah.gnu.org/bugs/?58682>.  Thanks to Dave
+	Kemper for the report.
+
+2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Generate me(7) manual sources as part of the build.  We had been
+	shipping 'me' sources with the string '@VERSION@' in them and
+	only sed-replacing that to produce generated PostScript, but
+	this replacement was not occurring for users who processed the
+	documents themselves.
+
+	* doc/meintro.me:
+	* doc/meintro_fr.me:
+	* doc/meref.me: Rename these to...
+	* doc/meintro.me.in:
+	* doc/meintro_fr.me.in:
+	* doc/meref.me.in: ...these.
+
+	* doc/doc.am (DOCFILES): Add the new *.in files.  Move the *.me
+	files from here...
+	(GENERATEDDOCFILES): ...to this new variable.
+	(dist_otherdoc_DATA, EXTRA_DIST): Add `$(GENERATEDDOCFILES)`.
+	(doc/me{intro{,_fr},ref}.me): Add new target rules.
+
+	* src/utils/grog/tests/smoke-test.sh: Update test to look for
+	the above source tree documents under their new names.
+
+2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (.me.txt, .ms.txt): Drop unused suffix rules.
+
+2021-12-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (DOC_SED): Add substitution of command prefix
+	{"@g@"} so we can make accurate reference to groff commands with
+	Unix counterparts in our documentation.
+
+2021-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac: Add nroff mode string definitions for 4.4BSD
+	compatibility.
+	  - Define '{' and '}' (superscripting) strings as '' and ''.
+	  - Define '<' and '>' (subscripting) strings as '\(la and
+	    '\(ra' if available on the device, otherwise '<' and '>'.
+
+	* tmac/tests/e_footnote-marks-work.sh: Update expected output.
+
+	* doc/meref.me: Document it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61619>.
+
+2021-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (doc/meintro_fr.ps): Add target rule (overriding
+	suffix rule) to generate this file using `-mfr` (load the French
+	localization macro file).
+
+2021-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Drop redundant `do_divert()` declaration.
+
+	* src/roff/troff/env.h: Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61433>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-11-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Remove `DEBUGGING` preprocessor cruft.
+
+	* src/roff/troff/input.cpp:
+	* src/roff/troff/mtsm.cpp: Stop defining `DEBUGGING`
+	preprocessor macro (as empty).
+
+	* src/roff/troff/input.cpp: Give `DEBUG_OPTION` an empty string
+	value if the former is undefined, so the `getopt_long()` call
+	will compile.
+
+	Fixes <https://savannah.gnu.org/bugs/?61436>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-11-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Slightly refactor table format column modifier `p` and
+	`v` validation.
+
+	* src/preproc/tbl/main.cpp (process_format): Make code terser by
+	introducing references to `list->point_size` and
+	`list->vertical_spacing`.  Doing this requires a new scope
+	{because a switch case isn't one} so add it, without updating
+	indentation for this commit.  When complaining of out-of-range
+	type size or vertical spacing, report the limit.
+
+2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Improve diagnostic messages.
+
+	Revise diagnostic messages generally to use terminology
+	consistent with the recent rewrite of tbl(1), identify a
+	contextual token when possible, and communicate more helpfully.
+
+	* src/preproc/tbl/main.cpp (process_options): Tell the user
+	which region option is missing a closing parenthesis or cannot
+	accept an empty argument.  Refer to region options as such, not
+	simply "options" (so they can't be confused with command-line
+	options).  Say that input is "invalid" instead of "bad".
+	(process_format): Say "table format specification" instead of
+	just "format".  Say "column classifier" instead of "format".
+	When a column modifier is missing an argument or a closing
+	parenthesis, identify it and refer to it as a "column modifier"
+	instead of omitting context.  Inform user that arguments to `p`
+	and `v` column modifiers must be "(optionally signed) integer"s,
+	not "numbers", lower these diagnostics' levels from error to
+	warning, and indicate that the modifier is ignored.  Clarify
+	diagnostic when extra characters trail `.` at the end of a table
+	format line.
+	(process_data): Say "table entry" instead of "data entry" when
+	discarding an excess one.
+	(process_table): Say we're giving up on "this table region", not
+	this "table", particularly since any table continuations (.T&)
+	are ignored.
+
+2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Fix call to `getopt_long()`.
+
+	* src/preproc/tbl/main.cpp (main): Stop telling `getopt_long()`
+	to look for a `T` option.  Continues b4bbf32e, 16 October 2020.
+
+2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Tweak usage message.
+
+	* src/preproc/tbl/main.cpp (usage): Document `--version`.  Give
+	version retrieval mode separate synopsis.  Use more normative
+	synopsis syntax.
+
+2021-11-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Fix code style nits.
+
+	* src/preproc/tbl/main.cpp (process_input_file)
+	(entry_format::debug_print, process_data, main): Replace
+	`assert(0)` calls with communicative predicates.
+	(struct input_entry_format, input_entry_format::debug_print,
+	process_format): Boolify.  Demote and rename `int`s
+	`last_column` and `equal` to `bool`s named `is_last_column` and
+	`is_equal_width`.  Assign them Boolean literals.
+	(process_format): Boolify.  Demote `have_expand`, `got_format`,
+	and `got_period` from `int` to `bool`.  Use Boolean literals in
+	assignments thereto.
+	(process_options): Swap order of null pointer comparison when a
+	typo or thinko could lead to lvalue assignment.
+	(process_data): Boolify.  Demote `give_up` from `int` to `bool`.
+	Demote and rename `int` `row_comment` to `bool`
+	`seen_row_comment`.  Use Boolean literals in assignments
+	thereto.
+	(main): Use standard C library symbols `EXIT_SUCCESS` and
+	`EXIT_FAILURE` with `exit()` calls instead of `0` and `1`.
+
+2021-11-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Fix Savannah #61520.
+
+	* src/utils/grog/grog.pl: Move hash `preprocessor_for_macro` to
+	global scope since it is now mutable across `do_line` subroutine
+	calls.
+	(do_line): Adjust regex matching an end macro to work better.
+	Check names of macros being defined by the document; if they
+	start with '' or '', stop attempting to detect refer(1) usage,
+	by deleting its key from the `preprocessor_for_macro` hash.
+
+	Fixes <https://savannah.gnu.org/bugs/?61520>.
+
+2021-11-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Add regression test for Savannah #61520.
+
+	* src/utils/grog/tests/avoid-refer-fakeout.sh: Do it.
+	* src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-11-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Page Motions):
+	* man/groff.7.man (Escape short reference): Fix error: the `\r`,
+	`\u`, and `\d` escape sequences move in ems, not vees, despite
+	being vertical motions.  Add discussion and example.  Thanks to
+	Bjarni Ingi Gislason for pointing out the problem in groff(7)
+	and Tadziu Hoffman for his lucid explanation.
+
+	Fixes <https://savannah.gnu.org/bugs/?61437>.  Thanks to Bjarni
+	Ingi Gislason for the report and a suggested patch.
+
+2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/include/error.h: Drop `extern` storage class from
+	diagnostic function prototypes.  Drop parameter names from
+	prototypes, in keeping with the Stroustrup-style C++ used in
+	most of groff.
+
+2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/font.cpp (font::load): Update diagnostic
+	messages to say "kerning pair" instead of "kern pair".
+
+2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Update diagnostic
+	messages to use more normative language: say "type size" instead
+	of "point-size", and "escape sequence" instead of "escape".
+	* src/roff/groff/tests/\
+	use_point_size_escape_with_single_digit_arg.sh: Update expected
+	diagnostic wording in text.
+
+2021-11-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Boolify.  Update
+	prototype.  Demote return type from `int` to `bool`.  Use
+	Boolean literals for return values.  Similarly demote local
+	variable, rename it from `bad_digit` to
+	`contains_invalid_digit`, and use Boolean literals with it.
+
+2021-11-16  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl: Fixes to importing pdf versions
+	> 1.4.
+
+2021-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: If "nowarn", suppress table row warning.
+
+	* src/preproc/tbl/table.cpp (table::init_output): Bracket the
+	generated groff code that emits a warning if a table row
+	overruns a page location trap (usually, is too long to
+	vertically fit on the page) in a test for whether the "nowarn"
+	region option was given, so that this warning is suppressed as
+	well when that option is used.
+	* src/preproc/tbl/tbl.1.man (Region options): Document new
+	"nowarn" behavior.
+
+	{"nokeep" also suppresses this warning, for a different reason;
+	no diversion is created to hold the table row, so its vertical
+	size does not exist to be compared to the distance to the next
+	page trap.}
+
+	Fixes <https://savannah.gnu.org/bugs/?61477>.
+
+2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::do_vspan): Fix code style
+	nits.  Swap order of null pointer and zero equality comparisons
+	when a typo or thinko could lead to lvalue assignment.  Break a
+	series of 6 and-ed assertion predicates into separate `assert()`
+	calls--sure to be less maddening for anyone who has to debug
+	such a contingency.  Clarify comment since C++98 didn't yet have
+	`nullptr`.
+
+2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	m4: Clean up shell variable quoting and bracing.
+
+	* m4/groff.m4 (GROFF_PROG_YACC, GROFF_MAKEINFO)
+	(GROFF_BROKEN_SPOOLER_FLAGS, GROFF_TARGET_PATH_SEPARATOR): Stop
+	bracing shell variable expansions that don't require it; the
+	shell is not make(1).
+	(GROFF_PROG_YACC, GROFF_MAKEINFO): Double-quote shell variable
+	expansions that might produce whitespace.
+	(GROFF_MAKEINFO): Drop unnecessary leading zeroes from version
+	number component construction.  Drop unnecessary escaping of
+	plus sign in expr(1) input.
+
+2021-11-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	m4: Clean up test(1) usage.
+
+	Get rid of string (non-)nullity tests and comparisons involving
+	concatenation with garbage (usually "x").  Even the GNU Autoconf
+	manual's shell portability material doesn't recommend this.  It
+	must be either a bodge cooked up by shell programmers who
+	couldn't remember to quote variable expansions, or a workaround
+	for shells of such poor quality that they defied the odds and
+	decayed out of usage or got fixed.
+
+	Instead, use double quotes (only where necessary).  Test for
+	non-empty strings with "test -n" and empty strings with "test
+	-z".  Stop quoting literal comparands that obviously have no
+	shell metacharacters in them.
+
+	* m4/groff.m4 (GROFF_PRINT, GROFF_PROG_YACC, GROFF_PERL)
+	(GROFF_DOC_CHECK, GROFF_MAKEINFO, GROFF_TEXI2DVI)
+	(GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS, GROFF_PAGE)
+	(GROFF_TMAC, GROFF_WITH_COMPATIBILITY_WRAPPERS, GROFF_X11)
+	(GROFF_APPRESDIR_DEFAULT, GROFF_APPRESDIR_CHECK)
+	(GROFF_HAVE_TEST_EF_OPTION, GROFF_BASH, GROFF_UCHARDET)
+	(GROFF_UCHARDET_CHECK, GROFF_PDFTOOLS)
+	(GROFF_USE_GROFF_ALLOCATOR): Do it.
+
+2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_TEXI2DVI): Add dependency on
+	`GROFF_MAKEINFO` macro.  Rewrite to also test `MAKEINFO`
+	variable, which is empty if the `makeinfo` command is not
+	installed or too old.  Consequently ignore `texi2dvi` if is too
+	old without having to do a version check (since it and
+	`makeinfo` are distributed together, both being part of GNU
+	Texinfo).
+
+	* doc/doc.am (.texi.dvi, .texi.pdf): Update error message to
+	indicate that `texi2dvi` is _either_ missing or too old.
+
+2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_MAKEINFO): Stop throwing a warning if the
+	installed `makeinfo` is old but the distributed Info manual is
+	up to date.  This is not a configure-time problem; the user will
+	be notified when they run 'make' if they modify doc/groff.texi,
+	or if they run 'make doc' (which has required a TeX installation
+	for years).  Empty the `MAKEINFO` variable immediately if a
+	too-old version is detected.  Drop needless `AC_SUBST`itution of
+	the detected `makeinfo` version.
+
+2021-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_HTML_PROGRAMS): Clarify message; it is only
+	groff-generated HTML that is disabled by the absence of the
+	programs checked for.  (`makeinfo` can still generate our
+	Texinfo manual in HTML format.)
+
+2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	build: Drop `BUILD_INFODOC` symbol.  Ship manual in GNU Info,
+	text, and HTML forms in distribution archive.
+
+	* Makefile.am (MAINTAINERCLEANFILES): Initialize.
+	(MOSTLYCLEANADD): Drop unused variable.
+	* configure.ac: Drop `AM_CONDITIONAL(BUILD_INFODOC...`.
+	* doc/doc.am (EXTRA_DIST): Rearrange shipment of our Texinfo
+	manual source files to precede all of the generated forms, for
+	clarity.  Drop all `BUILD_INFODOC` conditionals.  Make
+	`build_infodoc` phony target depend on plain text, GNU Info, and
+	HTML forms of Texinfo manual unconditionally.  Also drop unused
+	variables `groffinfodir`, `groffpdfdir`, and `texi2dvi_missing`.
+	(EXTRA_DIST, MAINTAINERCLEANFILES): Add Info form of manual.
+	Drop glob pattern attempting to match the segments that
+	`makeinfo` breaks it into.  It isn't necessary for
+	MAINTAINERCLEANFILES.
+	(EXTRA_DIST, MAINTAINERCLEANFILES): Add text form of manual.
+	(EXTRA_DIST, MAINTAINERCLEANFILES): Add HTML form of manual.
+	(dist-hook): Depend on new (phony) target `dist-info-bits`.
+	(dist-info-bits): Look for the info document in the build
+	directory, then the source directory.  (It could be in either
+	place depending on whether the build from a Git working tree is
+	being done in or out of a separate build directory.)  When
+	found, copy the segments to the assembly area for the
+	distribution archive.
+	(install_infodoc): Refactor.  Remove any groff info files from
+	the destination info directory using a shell glob directly
+	instead of a partly redundant ls(1) command substitution.
+	Similarly, use a shell glob to cp(1) the info files (including
+	any matched segments) to the destination info directory before
+	running `install-info`.  (In this process I learned that
+	`install-info` doesn't "install" anything; instead, it
+	{de-}registers info files with their top-level catalog.)
+
+2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (.texi.txt, .texi.html): Reorder pattern rules to
+	make it clearer which formats require only `makeinfo` and which
+	require `texi2dvi`.  The latter imposes more build dependencies,
+	including a full TeX installation.
+
+2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mom: Build more quietly.
+
+	* contrib/mom/mom.am (penguin.{ps,.pdf}): Make targets quiet by
+	default; they are simple file copies.
+
+2021-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Revise a test's setup.
+
+	* src/roff/groff/tests/fp_should_not_traverse_directories.sh:
+	Revise search for device/font description directory to work in
+	within-source-tree builds and (for now) with the approach used
+	by Automake's "distcheck" target.
+
+2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Accept `\&` as an empty table entry.
+
+	* src/preproc/tbl/table.cpp (table::add_entry): Suppress
+	diagnostic about non-empty table entries classified as `_` or
+	`=` if the entry consists of exactly `\&`.
+
+	* src/preproc/tbl/tbl.1.man (Table data): Document this idiom.
+
+2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Update diagnostic messages.
+
+	* src/preproc/tbl/main.cpp (process_options, process_format):
+	* src/preproc/tbl/table.cpp (table::add_entry): Align diagnostic
+	text with terminology now used in tbl(1) man page.
+	  - "global option" -> "region option"
+	  - "specifier" -> "column modifier"
+	  - "format" -> "column classifier"
+
+2021-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Fix missing colon in diagnostic messages.
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	Restore missing colon to diagnostic text.  Problem introduced by
+	me in commit 9a038161, 8 November.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff,grops: Slightly refactor.
+
+	* src/devices/grops/ps.cpp: Explicitly preprocessor-include
+	"lib.h" since we use the `PI` symbol it defines.
+
+	* src/include/lib.h: Add inclusion guard.  Wrap only `extern "C"
+	and its braces in preprocessor conditionals, so that prototypes
+	are present in the header even for C language code that
+	#includes this header.  Add `static` storage class to `PI`
+	symbol to avoid redefinition errors from the linker.
+
+	* src/libs/libgroff/iftoa.c (if_to_a):
+	* src/libs/libgroff/itoa.c (i_to_a, ui_to_a): Add `const` type
+	qualifier to function definitions for agreement with prototypes
+	in "lib.h".  Drop local copies of prototypes.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Centralize definitions of {U,}INT_DIGITS.
+
+	* src/libs/libgroff/iftoa.c:
+	* src/libs/libgroff/itoa.c: Move definitions of `INT_DIGITS` and
+	`UINT_DIGITS` from here...
+	* src/include/lib.h: ...to here.
+
+	* src/libs/libgroff/iftoa.c:
+	* src/libs/libgroff/itoa.c: Preprocessor-include "lib.h".  This
+	revealed missing guards around `extern "C"` declarations, so...
+
+	* src/include/lib.h: Add them where necessary.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (OP): Fix code style nits.  Don't quote macro
+	arguments unnecessarily.  Use consistent backslashing.  Use
+	groff font escape sequence syntax.  Use adjustable non-breaking
+	space escape sequence instead of a non-adjustable one.
+	Parenthesize numeric expression for better readability.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Make allocator replacement optional.  Switch it
+	off by default, relying on C++ runtime new/delete support.
+
+	* configure.ac: Call new `GROFF_USE_GROFF_ALLOCATOR` m4 macro.
+	Use `AM_CONDITIONAL` to set Automake variable
+	`USE_GROFF_ALLOCATOR` if appropriate.  Report whether the
+	allocator is used in configure script output summary.
+	* m4/groff.m4 (GROFF_USE_GROFF_ALLOCATOR): Define new macro to
+	collect user preference.  The default is off.
+	* src/libs/libgroff/libgroff.am (libgroff_a_SOURCES): Build and
+	link new.cpp only if we are to `USE_GROFF_ALLOCATOR`.
+
+	* NEWS: Add item.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_TMAC): Report a human-readable message if
+	no system tmac prefix is found, instead of leaving the ellipsis
+	hanging.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_TMAC): Use separate shell variable for
+	`AC_MSG_RESULT()` content since the human-readable string we
+	populate it with in the empty case is not appropriate for later
+	`AC_SUBST()`-itution.  Problem introduced by me in commit
+	19670348, 31 October.
+
+2021-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am (MOSTLYCLEANFILES): Remove `$(TMACMDOCFILES)`.
+	This variable, formerly named `TMACMDOCSTRIPFILES`, should not
+	be used in a clean target because its contents are (no longer)
+	generated files.  Problem introduced by me in commit 24602f42, 4
+	July (only noticeable in within-source-tree builds).
+
+2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff,pic: Check `strdup()` return value.
+
+	* src/libs/libgroff/font.cpp (struct text_file): Add `fatal()`
+	member function.
+	(text_file::fatal): Implement it.
+
+	* src/libs/libgroff/font.cpp (font::load_desc):
+	* src/preproc/pic/troff.cpp (troff_output::set_location): Die if
+	`strdup()` returned a null pointer.
+
+2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	Revise to eliminate `fprintf()` calls, which might perform
+	dynamic memory allocation, rendering this function unsafe to
+	call after memory allocation failures.  Since this function is
+	near the top of our diagnostic output call stack, that would be
+	unfortunate.  `errprint()` does not use dynamic allocation, nor
+	do the `i_to_a()` and `ui_to_a()` functions it calls to format
+	integers.
+
+2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* configure.ac: Add `strdup` to AC_CHECK_FUNCS since we are
+	using it and the whole point of libgroff's `strsave()` was to
+	get along without it.  But `strdup` has been standardized in
+	POSIX for 20 years (SUSv3, POSIX:2001) and is on its way into
+	ISO standard C (N2353) and C++ (P2391R0) as well.
+
+2021-11-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/strsave.cpp (strsave): Call `strcpy()` only
+	if `malloc()` did not return a null pointer.  Problem noted by
+	Ingo Schwarze.
+
+2021-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/fontfile.cpp (font::open_file): Don't open
+	user-specified font file names with slashes in them; i.e., don't
+	traverse directories outside the configured font path.  Also
+	refuse to open the file if the `sprintf()` used to construct its
+	file name doesn't write the expected quantity of bytes to the
+	destination buffer.
+
+	Fixes <https://savannah.gnu.org/bugs/?61424>.  Thanks to Ingo
+	Schwarze for feedback.
+
+2021-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Regression-test Savannah #61424.
+
+	* src/roff/groff/tests/fp_should_not_traverse_directories.sh: Do
+	it.
+	* src/roff/groff/tests/artifacts/HONEYPOT: Add test artifact.
+	* src/roff/groff/tests/artifacts/devascii/README: ...and this;
+	we need a directory to make the test work but empty ones tend to
+	look unintentional.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+	(EXTRA_DIST): Ship artifacts.
+
+2021-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Fix diagnostic error wording.
+
+	* src/libs/libgroff/font.cpp (font::load): Fix diagnostic
+	message; this is issued when an unrecognized directive is
+	encountered, so it necessarily occurs _before_ any `charset` or
+	`kernpairs` directive.  Give the user a hint accordingly.
+
+2021-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix paragraph tag regressions.
+
+	* tmac/an-ext.mac (UR, MR): Only create an environment and
+	diversion if we're not already in one of the latter.  If we are
+	{in groff man, this occurs only when collecting a `TP` paragraph
+	tag}, then typeset the URI as part of the indented paragraph.
+	(UE, ME): Pop the diversion and environment stacks only if we
+	pushed them in the first place.  Eliminate spurious space in
+	post-URI arguments by only typesetting excess macro parameters
+	if there were any.
+
+2021-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Regression-test Savannah #61425.
+
+	* tmac/tests/an-ext_link-macros-work-in-paragraph-tags.sh: Do
+	it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (DS): Drop a redundant unconditional break; every
+	display macro we call in the event of a valid call already
+	breaks the line, and it's polite to not break if we're given an
+	invalid argument.  Emit a diagnostic error if the argument we're
+	given is invalid, and immediately end the diversion we just
+	opened.
+
+2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (environment::set_font): Clarify
+	diagnostic warning.
+
+2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::add_entry): If we see a '\^'
+	entry on the first row of a table, it's invalid, but we need to
+	create an empty entry in its place.  Otherwise, someone can put
+	another '\^' right below the one on the first row, creating a
+	reference to a nonexistent table entry and provoking a SEGV.
+	Issue an error diagnostic (distinct from the one in
+	`do_vspan()`), create the entry, and skip `do_vspan()` (given a
+	'^' in a first-row definition, it issues an error diagnostic and
+	returns early, which suffices).  Problem appears to date back to
+	groff 1.02 (June 1991) at the latest.
+
+	Fixes <https://savannah.gnu.org/bugs/?61417>.
+
+2021-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Regression-test Savannah #61417.
+
+	* src/preproc/tbl/tests/\
+	do-not-segv-on-invalid-vertical-span-entry.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix Savannah #61408.
+
+	* tmac/an.tmac (an-prepare-inner-footer): Don't try to get a
+	substring of an empty string; the man page author might not have
+	specified a third argument to `TH` (or supplied an empty one).
+
+	Fixes <https://savannah.gnu.org/bugs/?61408>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Add regression test for Savannah #61408.
+
+	* tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.
+
+2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Tweak computation in URI breaking.
+
+	* tmac/an-ext.tmac (UE, ME): Stop adding the page offset `.o`
+	when performing the available horizontal space computation for
+	the typeset URI string.  This made no difference on nroff
+	devices (grotty; even with `.po 15n`), but it caused the
+	breaking decision to be too conservative on troff devices
+	{grops}, forcing some URIs that would fit on the current line to
+	the next one.
+
+	* tmac/tests/an-ext_UE-breaks-before-long-URIs.sh: Add test of
+	URI with no link text, which also has break points after every
+	character, so that we detect even slight alterations.
+
+2021-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Do more device and font description file validation,
+	resolve an assertion failure arising from a negative declared
+	device resolution, and correct a documentation error.
+
+	* src/libs/libgroff/font.cpp (font::load): Include more
+	information about invalid input in diagnostic messages.
+	  - When a kern pair's amount is missing or invalid, report the
+	    name of the kern pair.
+	  - When someone tries to declare the first entry in the charset
+	    section as an alias, report the glyph name.
+	  - Identify the token for the unnamed character if an attempt
+	    is made to alias it.
+	  - When an out-of-range character type is applied to a glyph,
+	    name the glyph.
+	(font::load_desc): Same.
+	  - Drop redundant zero initialization of `res`.
+	  - Check all directives that take basic units for positive
+	    values, adding `res`, `unitwidth`, `paperwidth`, and
+	    `paperlength`.  Update this diagnostic to demand positive,
+	    not nonnegative, values.
+	  - When the font count is long in a `fonts` directive, report
+	    how many font names were declared (and thus expected).  (If
+	    the count is short, the next line is read for a font name,
+	    like 'tcommand' in our devutf8/DESC.)
+	  - When interpreting a `papersize` directive, throw an error
+	    and return false if `res` has not yet been encountered,
+	    since it is used in subsequent computations.
+	  - When a paper format cannot be determined, report the
+	    original declared value from the DESC file.  Use `strdup()`
+	    to save it since it gets clobbered by the resolving process.
+	    `free()` the saved string when we're done, regardless of
+	    error condition.
+
+	* doc/groff.texi (Device and Font Files):
+	* man/groff_font.5.man (DESC file format): Document additional
+	exception to order-indifference of directives: (at least one)
+	`res` must precede `papersize`.
+
+	Fixes <https://savannah.gnu.org/bugs/?61414>.
+
+2021-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/post-html.cpp
+	(html_printer::do_file_components): Add assertion.
+
+2021-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grops/ps.cpp (usage): Document -p and --version
+	options.
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-nroff (doc-setup-page-layout): Set the title
+	length to the device line length (register `.l`) if register
+	`LT` is not defined.  This keeps the title length from being set
+	to 78n when the line length is not, preventing the output from
+	looking silly.
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/main.cpp (main): Emit groff code to define
+	macro `T&` as empty if it is not already defined.  (All of our
+	full-service macro packages except mdoc(7) already do this, so
+	there's no change in semantics; mom(7) even defines it as an
+	empty _string_.)
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/string_case_xform_requests.sh: Migrate
+	test to POSIX shell, dropping use of process substitution (a
+	Bashism).  Also rewrite to stop using a here document within a
+	command substitution, mainly for paranoia.
+
+	* src/roff/groff/tests/string_case_xform_requests.sh:
+	* src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Update
+	shebang lines to use /bin/sh as the interpreter.
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grops/ps.cpp (encode_subfont): Update assertion to
+	check for `sub` parameter being a null pointer rather than
+	`sub->glyphs`; the latter is a member array of a `subencoding`
+	struct so it can't be a null pointer.  (`glyphs` is an array of
+	pointers to `const char`; the _elements_ of the array can and
+	are initialized to be null pointers, but the address of the
+	array itself will never be in a C/C++ implementation.)  Detected
+	by Clang 13's "-Wtautological-pointer-compare".
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/new.cpp (delete): Declare `throw()` (no
+	exceptions thrown); quiets "-Wimplicit-exception-spec-mismatch"
+	from Clang 13.
+
+2021-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4: Fix messaging nits.
+	(GROFF_MAKEINFO): Set `missing` to "missing 'makeinfo'" for
+	consistency with other assignments to `missing`.
+	(GROFF_TMAC): Utter an intelligible result in the configure
+	check when no system macro files requiring groff wrapping are
+	located.
+
+2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Handle special character escape sequences that map to
+	basic Latin glyphs in device control escape sequences
+	consistently among output devices.
+
+	* src/roff/troff/input.cpp (encode_char): Rearrange
+	conditionals.  This is the logic that puts the "whatever" within
+	a \X'whatever' escape sequence into GNU troff's intermediate
+	output.  Handle adjustable and nonadjustable space escape
+	sequences ("\~" and \ ") first.  Then, if the token is a special
+	character escape sequence, retrieve its "contents" (glyph name).
+	Move the basic Latin mapping for the seven glyph names '-',
+	'aq', 'dq', 'ga', 'ha', 'rs', and 'ti' here, before checking
+	whether the device description issued the
+	'use_charnames_in_special' directive.  This way, the 'html' and
+	'xhtml' output devices can straightforwardly embed these basic
+	Latin characters in device control escapes (notably, "html:",
+	for which the present convention is to follow the this tag
+	immediately with a literal HTML URI, complete with `<a href>`
+	element syntax).  If the special character is none of these and
+	we should 'use_charnames_in_special', proceed as groff 1.22.4
+	and earlier did.  This is a behavior change, as was my addition
+	of this translation mechanism in the first place, so...
+
+	* doc/groff.texi (Postprocessor Access): Document it.
+
+	* src/roff/groff/tests/\
+	device_control_escapes_express_basic_latin.sh: Test it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?61401>.
+
+2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Map \ti correctly in device control escape sequences.
+
+	* src/roff/troff/input.cpp (encode_char): Fix copy-and-paste
+	error.  \ti should put '~', not '^', into a device control
+	command.
+
+	Fixes <https://savannah.gnu.org/bugs/?61403>; problem introduced
+	by me in commit 9d61b3d1, 1 October.
+
+2021-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Handle degenerate input quietly.
+
+	* tmac/an.tmac (TH): Define new register `an-TH-was-called`.
+	(an-end): Return immediately if that register is not defined;
+	to format the default page footer we must have the information
+	declared in a valid `TH` call.  (`TH` also initializes the type
+	size and baseline spacing registers we use to prepare the page
+	footer environment.)  If the register _is_ defined, remove it
+	just prior to the end of this macro definition, in preparation
+	for next page to be rendered.
+
+	* tmac/tests/an_handle-degenerate-input-quietly.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/61402>, a regression from
+	groff 1.22.4 (problem introduced by me in the course of many
+	changes to trap management and header/footer handling to work
+	nicely in batch rendering with -mandoc and mdoc(7) documents).
+
+2021-10-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Warn if `TE` table macro called but `TW` register (set by
+	tbl(1)) undefined.  Arrange it so that we warn only once per
+	man(7) document, not per table region.
+
+	* tmac/an.tmac (TH): Remove `TW` register when processing new
+	document and clear `an-was-tbl-failure-reported` register.
+	(TE): Check `TW` and `an-was-tbl-failure-reported` registers; if
+	the former is undefined and the latter false, emit the message
+	and set `an-was-tbl-failure-reported`.
+
+	Addresses part of <https://savannah.gnu.org/bugs/?61379>.
+	Thanks to Bjarni Ingi Gislason for the suggestion.
+
+2021-10-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Improve portability.
+
+	* src/devices/grotty/tests/osc8_works.sh: Fix typo in test.
+	Multiple regex quantifiers after an atom were not flagged with a
+	diagnostic by GNU grep 3.3, but were by BSD grep 2.5.1-FreeBSD.
+
+	* src/roff/groff/tests/smoke-test_html_device.sh: Stop trying to
+	set $LC_CTYPE to "C.UTF-8"; some systems don't support this
+	expediency.  Skip the test if the tester hasn't configured the
+	environment adequately.
+
+	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Fix
+	portability problems exposed by FreeBSD sed (which version is
+	unclear).  {1} Use POSIX BREs, dropping use of '+' quantifier.
+	{2} Add semicolons to terminate commands before braces on the
+	same line.  Simplify surrounding test structure.
+	* tmac/tests/e_footnotes-work-with-columns.sh: Fix same two sed
+	problems.
+	* tmac/tests/andoc_flush-between-packages.sh:
+	* tmac/tests/doc_accept-mixed-case-section-headings.sh:
+	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Fix same
+	sed semicolon problem.
+
+	* src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh: Rewrite
+	test to stop using a here document (containing an unpaired
+	single quote) inside a command substitution, which is broken in
+	GNU Bash 3.2 and some other versions.  Instead construct the
+	input with printf(1).  Also gets rid of a Bashism (process
+	substitution) that Ingo pointed out years ago.
+	* src/utils/grog/tests/recognize-perl-pod.sh: Same problem,
+	different solution.  The Perl POD output is far too large to
+	construct programmatically, so move it into an external file...
+	* src/utils/grog/tests/foo.man: ...here.
+	* src/utils/grog/grog.am (EXTRA_DIST): Ship new test artifact.
+
+2021-10-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Make sed-based insertion of `lf` requests more
+	portable: a dance is required to embed a literal newline inside
+	a sed expression inside a shell command executed as part of a
+	Make target rule.  We assume that neither the POSIX shell $''
+	operator nor a working printf(1) is available.
+	(DOC_GROFF): Define a shell variable containing a literal
+	newline, evading make(1) and echo(1)'s valiant attempts to
+	consume it.
+	(doc/pic.html, doc/webpage.html): Repeat trick, slightly
+	modified since the dependency needs to be manually identified.
+
+	Solution adapted from the GNU Autoconf manual, "Newlines in Make
+	Rules".
+
+	Fixes <https://savannah.gnu.org/bugs/?61265>.  Thanks to John
+	Gardner for the report.
+
+2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (TH): Stop populating `an-extra3` (the default
+	center header) if the section argument is "3p".  "3p" does not
+	always mean a Perl-related man page; Debian- and Arch
+	Linux-based systems12 (at least) have long used a "3perl"
+	suffix, while OpenBSD appears to still use "3p" for Perl3,
+	which is also used by the POSIX man page distribution4.
+	Fortunately, Perl and POSIX are reliable at providing a fifth
+	argument to `TH` anyway, so our fallback is as unnecessary as it
+	is non-impartial.
+	* tmac/groff_man.7.man.in (Document structure macros) <TH>:
+	De-document the above behavior.
+
+	1 https://manpages.debian.org/bullseye/perl-doc/\
+	Pod::Man.3perl.en.html
+	2 https://man.archlinux.org/man/Pod::Man.3perl
+	3 https://man.openbsd.org/man3p/Pod::Man.3p
+	4 https://man7.org/linux/man-pages/man3/system.3p.html
+
+2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Abbreviate the inside footer if necessary.
+
+	* tmac/an.tmac (an-prepare-inner-footer): Prevent the inside
+	footer from overrunning the center footer.
+	(BT): Use new string `an-ifoot` instead of `an-extra2` in page
+	footers.
+
+	Fixes <https://savannah.gnu.org/bugs/?61386>.
+
+2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #61386.
+
+	* tmac/tests/an_inner-footer-abbreviation-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_char.7.man (Description, Special character escape
+	forms): Document the `\C` escape sequence.  Fix error: \a is
+	_not_ "translated to \a, the uninterpreted leader escape
+	sequence," but requests a glyph _named_ '\a' internally--it
+	appears thus in diagnostic messages and, importantly, in the
+	font description files defining special character glyph names.
+
+2021-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac: Refactor to reduce repetition.
+	(an-break-paragraph): New macro handles paragraph-breaking tasks
+	previously duplicated.
+	(SH, SS, P, TP, IP, HP): Call it rather than issuing its
+	constituent requests.
+
+2021-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (TP): Reset type size, vertical spacing, and font
+	to defaults before setting the new paragraph.
+
+	Fixes <https://savannah.gnu.org/bugs/?61380>.
+
+2021-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Auto-increment): Fix error; the `\R` escape
+	sequence does _not_ support an auto-incrementation amount.
+	* man/groff_out.5.man (Command reference/Simple commands): Fix
+	erroneous claim: 'N' is not a GNU roff extension; it appears on
+	page 27 of CSTR#54 (1992).
+
+2021-10-24  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	ms: Provide global default XH and XN implementations.
+
+	cf. <https://savannah.gnu.org/bugs/?58946#comment13>
+
+	* tmac/s.tmac (XH-INIT, XN-INIT, XH-UPDATE-TOC)
+	(XH, XN, XH-REPLACEMENT, XN-REPLACEMENT): Implement them, and...
+	* tmac/groff_ms.7.man: ...document them.
+
+2021-10-24  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	ms: Fix misleading NH macro indentation.
+
+	* tmac/s.tmac (@NH) .T is html: .if statement should exhibit
+	same indentation as preceding .DEVTAG-NH statement, but is
+	overindented; fix it.
+
+2021-10-23  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	ms: Defend against uncontrolled page trap recursion.
+
+	* tmac/s.tmac (pg@top) HM+FM+.V>.p: Diagnose insufficient page
+	length, and abort; cf. <https://savannah.gnu.org/bugs/?61294>
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff: Fix code style nits.
+
+	* src/roff/groff/groff.cpp (main, help): Use standard C library
+	preprocessor symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead
+	of 0 and 1 literals, respectively.  See commit fa4c27e9, 7
+	September.
+	(main): Replace `assert(0)` with a communicative predicate.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grotty/tty.cpp (tty_printer::special_link):
+	Eliminate casts by retyping `uri` and `pair` to pointers to
+	`const char`s.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am: Build more quietly.
+	(tmac/stamp-wrap): Prefix all rule commands with `$(AM_V_at)`;
+	since this target is a stamp file instead of a useful artifact
+	to be distributed, make its creation completely silent by
+	default.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/troff.am: Build more robustly.
+	(src/roff/troff/majorminor.cpp): Drop progress-reporting `echo`
+	in favor of prefixing final rule command with `$(AM_V_GEN)`.
+	Prefix earlier rule commands with `$(AM_V_at)`.  Use `printf`
+	instead of `echo` to build the file, and create a temporary file
+	at first so that we don't race with the compiler on parallelized
+	builds.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/eqn/eqn.am (neqn): Simplify: drop removal of
+	target prior to overwriting it; any system we can build groff on
+	should have a shell that implements the clobbering semantics of
+	the POSIX shell '>' operator.  (If this isn't true, we have
+	_many_ other target rules in our build to which we must add
+	prefatory `$(RM)`s, or I miss my guess.)
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/libgroff.am: Build more quietly and
+	robustly.
+	(src/libs/libgroff/version.cpp): Drop progress-reporting `echo`
+	in favor of prefixing final rule command with `$(AM_V_GEN)`.
+	Prefix earlier rule commands with `$(AM_V_at)`.  Use `printf`
+	instead of `echo` to build the file, and create a temporary file
+	at first so that we don't race with the compiler on parallelized
+	builds.  Drop nilpotent sed transformation; this looks like a
+	relic of past times when we'd drop a trailing ".0" from the
+	version number stored in the C symbol `Version_string`.
+	(charset.alias, ref-del.sed, ref-add.sed): Prefix rule command
+	with `$(AM_V_GEN)`.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/xditview/xditview.am: Build more quietly.
+	(src/devices/xditview/GXditview-ad.h): Drop progress-reporting
+	`echo` in favor of prefixing rule command with `$(AM_V_GEN)`.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/devpdf.am: Build more quietly.
+	(font/devpdf/enc/text.enc, font/devpdf/map/symbolmap,
+	$(DEVPDFFONTMAP_1)): Prefix all rule commands with
+	`$(AM_V_at)`; since these are all `mkdir`s and `cp`s, I reason
+	that little can go wrong with them that won't be disclosed by
+	these tools' own diagnostic messages, so they are insignificant
+	from a perspective of build progress.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Build more quietly.
+	(doc/examples.stamp): Prefix all rule commands with
+	`$(AM_V_at)`; since this target is a stamp file instead of
+	a useful artifact to be distributed, make its creation
+	completely silent by default.
+	(doc/groff.info, .texi.txt): Prefix directory creation with
+	`$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`.
+	(.texi.dvi, .texi.pdf): Prefix directory creation with
+	`$(AM_V_at)` and `makeinfo` command with `$(AM_V_GEN)`.  Send
+	diagnostic message to standard error if `texi2dvi` is
+	unavailable.
+	(.texi.html): Prefix directory creation with
+	`$(AM_V_at)`.  Two HTML versions are produced, in split and
+	unsplit versions; prefix one `makeinfo` command with
+	`$(AM_V_GEN)` and the other with `$(AM_V_at)` so that only one
+	message is produced.
+	(gnu.eps): Drop useless/noisy `echo` command.  Prefix copy
+	operation with `$(AM_V_at)`.  Send diagnostic messages to
+	standard error if there are problems with the Netpbm tools.
+
+	(MOSTLYCLEANFILES): The `mostlyclean` target was leaving a file,
+	`groff.info-3`, behind in the build tree.  At some point our
+	Texinfo manual grew beyond earlier expectations.  Use a glob
+	`0-9` instead (giving a hostage to fortune that `makeinfo`
+	will never split our manual into more than nine chunks).
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* arch/misc/misc.am:
+	(arch_shdeps_sh): Pull file name into a new variable.
+	(EXTRA_DIST, shdeps.sed): Use it.
+	(shdeps.sed): Build more quietly; prefix with `$(AM_GEN_V)`.
+
+2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	nroff: Support groff's -R flag to run refer(1).
+
+	There's no reason not to support calling `refer` with nroff-mode
+	documents; typographically, it's less demanding than tbl(1).
+	GNU troff(1) supports an incompatible `-R` flag to suppress the
+	reading of troffrc{,-end} files, but this is likely not the `-R`
+	that users will want--it is most useful for troubleshooting
+	troff, and nroff already unconditionally loads a macro file
+	{tty-char.tmac}.
+
+	* src/roff/nroff/nroff.sh: Do it.
+
+	* src/roff/nroff/nroff.1.man:
+	* NEWS: Document it.
+
+2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am (tmac/groff_man.7.man)
+	(tmac/groff_man_style.7.man): Be quieter by default; use
+	$(AM_V_GEN) more consistently with the rest of the build.
+
+2021-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_error): Format diagnostic
+	messages in closer alignment with GNU Coding Standards: don't
+	introduce a space between the program name and the input file
+	name.
+
+	* src/roff/groff/tests/string_case_xform_errors.sh: Update
+	expected output.
+
+2021-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (distribute_space): Revert an
+	`assert()` I added in commit b93eacd8d7 (5 September); we can
+	indeed reach this code with a negative amount of desired space,
+	and in fact the "show hyphenation points" trick
+	<https://froude.eu/groff/examples/hyphenation-points.html>
+	relies upon it.  Add explanatory comment.
+
+	Fixes <https://savannah.gnu.org/bugs/?61348>.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* test-groff.in: Add support for sboxes.tmac.
+
+2021-10-11  Paul Eggert <eggert@cs.ucla.edu>
+
+	Include <config.h> before any standard headers.
+
+	Gnulib requires that files that might use Gnulib features (which
+	pretty much means every C or C++ source file) must include
+	<config.h> first.  Arrange for that.  This will be needed once
+	Groff updates to the latest Gnulib; see Bjarni Ingi Gislason's
+	problem report in:
+	<https://lists.gnu.org/r/bug-gnulib/2021-10/msg00008.html>
+
+	The only exception I can see is src/utils/addftinfo/guess.cpp,
+	which does not include any standard include file either directly
+	or indirectly, and so need not include <config.h>.
+
+	* src/devices/xditview/Dvi.c:
+	* src/devices/xditview/font.c:
+	* src/devices/xditview/lex.c:
+	* src/devices/xditview/page.c:
+	* src/devices/xditview/parse.c:
+	* src/libs/libbib/map.c:
+	* src/libs/libgroff/change_lf.cpp:
+	* src/libs/libgroff/cmap.cpp:
+	* src/libs/libgroff/cset.cpp:
+	* src/libs/libgroff/fmod.c:
+	* src/libs/libgroff/getcwd.c:
+	* src/libs/libgroff/lf.cpp:
+	* src/libs/libgroff/ptable.cpp:
+	* src/libs/libgroff/quotearg.c:
+	* src/libs/libxutil/DviChar.c:
+	* src/libs/libxutil/XFontName.c:
+	* src/libs/libxutil/xmalloc.c:
+	* src/utils/indxbib/signal.c: Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61315>. --GBR
+
+2021-10-10  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Handle pdfs > v1.4 loaded by \X'pdf: pdfpic'.
+
+	* src/devices/gropdf/gropdf.pl: Improve loading of pdfs above
+	version 1.4, i.e. handle compressed nodes in /ObjStm. Also
+	improve code in \X'pdf: import'.
+
+2021-10-10  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add new background boxes to gropdf.
+
+	* src/devices/gropdf/gropdf.pl: New \X'pdf: background' command.
+	* tmac/pdf.tmac: Covenience command .pdfbackground added.
+	* contrib/sboxes/: Files which demonstrate use of background
+	boxes using -ms macros.
+
+2021-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Fix portability problems in 2 tests.
+
+	* src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
+	* tmac/tests/s_PN-works.sh: Migrate from `echo` to `printf` for
+	test inputs containing backslashes to be interpreted literally.
+
+	Fixes part of <https://savannah.gnu.org/bugs/?61302>.  Thanks to
+	Deri James for identifying the problem.
+
+2021-10-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grotty: Slightly refactor.
+
+	* src/devices/grotty/tty.cpp: Boolify.  Demote numerous
+	variables (and one return type) from `int` to `bool`, use
+	Boolean instead of integer literals with them, and give the
+	variables names resembling logical predicates.
+	 - horizontal_tab_flag -> want_horizontal_tabs
+	 - form_feed_flag -> want_form_feeds
+	 - bold_flag_option -> want_emboldening_by_overstriking
+	 - bold_flag -> do_bold
+	 - underline_flag_option -> want_italics_by_underlining
+	 - underline_flag -> do_underline
+	 - overstrike_flag -> want_glyph_composition_by_overstriking
+	 - draw_flag -> allow_drawing_commands
+	 - italic_flag_option -> want_sgr_italics
+	 - italic_flag -> do_sgr_italics
+	 - reverse_flag_option -> want_reverse_video_for_italics
+	 - reverse_flag -> do_reverse_video
+	 - old_drawing_scheme -> use_overstriking_drawing_scheme
+	(class tty_printer:printer): Similarly.
+	 - is_underline -> is_underlining
+	 - is_bold -> is_boldfacing
+	 - cu_flag -> is_continuously_underlining
+	(tty_printer::tty_color): Demote return type as above.  Invert
+	its sense; rename `unknown_color` to `is_known_color`.
+	(tty_printer::color_to_idx): Invert sense of test at
+	`tty_color()` call site.
+
+2021-10-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Finish documenting new `TC-MARGIN` register and
+	`TC-LEADER` special character.
+
+	Fixes <https://savannah.gnu.org/bugs/?61157>.
+
+2021-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grotty: Slightly refactor.
+
+	* src/devices/grotty/tty.cpp (tty_printer::special_link): Use
+	consistent loop styles and drop unnecessary arithmetic.
+
+2021-10-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix oversight and improve `MR` test.
+
+	* tmac/an-ext.tmac (initialization): Enable `mY` register to
+	indicate use of grotty(1) (and therefore OSC 8 support) if the
+	"ascii", "cp1047", or "latin1" output devices are used, not just
+	"utf8".
+
+	* tmac/tests/an_MR-works.sh: Drop copy-and-paste cruft from a
+	different test.  Update expected output and check for the
+	presence of "link" device control subcommands, not just correct
+	font selections.
+
+2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Add `MR` macro for man page cross references.
+
+	* tmac/an.tmac (an-prepare-page-title): After a possibly
+	abbreviated man page title is determined, redefine `an-pageref`
+	to set the title portion in the font stored in the `MF` string
+	and bracket it with italic corrections if that font is thought
+	to be oblique.
+	(MR): Add macro to format the text of a man page cross
+	reference, and hyperlink it on HTML and terminal output devices
+	if permitted by the `U` register.
+	(initialization): Define `MF` string as `I` if not already set.
+	Define `an-lic` and `an-ic` strings as either empty or as
+	containing italic corrections.
+
+	* tmac/an-ext.tmac (MR): If the formatter is not GNU troff,
+	define macro to format the text of a man page cross reference.
+
+	* tmac/groff_man.7.man.in: Document it.
+	(Description): Add macro to summary table.
+	(Description/Hyperlink macros): Document new feature.  Note
+	origin in Plan 9 troff.  style Add examples of use.
+	(Description/Font style macros): Drop man page cross references
+	from list of items whose typeface conventions are disputed,
+	since we have a semantic macro now and a configurable means of
+	resolving the problem.
+	(History): Add `MR` item.
+	(Options) <MF>: Document new string.
+	(Files) <an-ext.tmac>: Revise discussion to accommodate `MR`.
+	(Authors): Add myself an author of extension macros.
+
+	* tmac/tests/an_MR-works.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	* NEWS: Add item.
+
+2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (SH, SS): Invoke `ne` request _before_ performing
+	font remapping: any page-breaking decision will be taken before
+	the remapping happens, and so won't be in effect across a page
+	boundary, undesirably impacting header and footer text.
+
+	Fixes <https://savannah.gnu.org/bugs/?61279>.
+
+2021-10-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #61279.
+
+	* tmac/tests/an_font-remapping-does-not-affect-titles.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-10-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (an-abbreviate-title): Rename to...
+	(an-prepare-page-title): ...this.
+
+2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	docs: Correct erroneous claim: the ".NH S" extension to ms(7)
+	comes from 4.2BSD, not GNU.
+
+2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/ms.ms (Creating a table of contents): Sync with recent
+	additions to groff_ms(7), expand, and heavily revise.
+
+2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	andoc,man,mdoc: Fix Savannah #61266.  Resolve problems in
+	batch rendering of man pages to PDF arising from entanglement
+	of end-of-input traps, page location traps, continuous rendering
+	mode, and andoc's reloading of the (m)an and (m)doc packages.
+
+	* tmac/andoc.tmac (reload-doc, reload-man): Remove end-of-input
+	traps alongside others.
+
+	* tmac/an.tmac (an-end): Only perform flush and "manual" page
+	footer placement if in continuous rendering mode, since this
+	macro is not only called by a trap placed only in continuous
+	rendering mode, but also by andoc when changing macro packages.
+	Unconditionally remove the `an-header` trap since the next
+	document might be using a different macro package.
+
+	* tmac/mdoc/doc-common: In initialization, set flag indicating
+	that manual header placement will be required.
+	(Dt): Call `doc-setup-header` (which sets up several types of
+	trap) unconditionally, and break the page if the vertical
+	drawing position is anywhere but at the top.
+	(Os): If the package has just been initialized, call
+	`doc-header` to force the page header to be written.
+	(doc-end-macro): Remove `doc-header` trap since the next
+	document might be using a different macro package.  Break the
+	page.  Set flag indicating that manual header placement will be
+	required for the next document.
+
+	* tmac/mdoc/doc-ditroff (doc-setup-header): Only set page
+	location traps for the header and footer if not continuously
+	rendering.
+	* tmac/mdoc/doc-nroff (doc-setup-header): Stop calling
+	`doc-header` here if continuously rendering.  Emit an
+	unconditional break.  Except for the location of the footer
+	trap, the `doc-setup-header` implementations are now identical.
+
+	Refactoring is needed: some macros and registers have misleading
+	names, there is some code duplication in mdoc, and some of the
+	trap management problems are solved in slightly different ways
+	in man(7) and mdoc(7), perhaps unnecessarily.  We also need some
+	test scripts to protect us from regressions.  But this fixes the
+	rendering problems.
+
+	Fixes <https://savannah.gnu.org/bugs/?61266>.
+
+2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Correct manpage typo/inconsistency.
+
+	* tmac/groff_ms.7.man (TC_LEADER, TC_MARGIN): Correct; should
+	be...
+	(TC\-LEADER, TC\-MARGIN): ...respectively, for consistency
+	with...
+	* tmac/s.tmac (TC-LEADER, TC-MARGIN): ...these.
+
+2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (encode_char): Update diagnostic
+	messages to not presume the identity of the escape character;
+	continues 9be3f8e3 (4 June).
+
+2021-10-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grotty/tty.cpp (tty_printer:special_link): Tighten
+	code slightly by taking advantage of preprocessor string literal
+	concatenation.
+
+2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix `U` enablement override so it actually works the way
+	I had in mind.
+	- The package proper enables it by default, but
+	- the sample site configuration file switches it off, on the
+	  assumption that distributors and users will know better than
+	  we do when they get a capable pager in place, and
+	- a register setting at the command line (or otherwise prior to
+	  the loading of the macro package) is dispositive.
+
+	* tmac/an-ext.tmac: Rename URI output device capability register
+	from `U` to `mU`.
+	(UR, UE, MT, ME): Test both `U` and `mU` before handling
+	hyperlinks specially.
+	* tmac/an.tmac: If `man.local` did not initialize `U`, switch it
+	on.  The hope is that we can drop the stuff in `man.local`
+	completely at some point.
+	* tman/man.local: Only initialize `U` if it is not already
+	defined.
+
+2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Use OSC 8 hyperlinks.
+
+	* tmac/an-ext.tmac: Add registers `mY` (output driver is
+	"grotty") and `U` (generate hyperlinks).  `U` is intended to
+	apply to hyperlinking support in general, not just grotty's OSC
+	8 feature.  If the output driver is either grohtml or grotty,
+	make `U` true (`man.local` is read subsequently and can override
+	it).
+	(UR, MT): Conditionalize diversion production on hyperlink
+	support, not grohtml use per se.
+	(UE, ME): Generate device control commands for `tty` device to
+	emit hyperlinks.
+
+	* tmac/groff_man.7.man.in (Options): Document -rU.
+	(Files) style: Add example of `U` register enablement.
+
+	* tmac/man.local: Disable `U` register by default, except on the
+	`html` device.
+
+	* NEWS: Add item.
+
+2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grotty: Add OSC 8 hyperlink support.
+
+	* src/devices/grotty/tty.cpp: Do it.  Define `OSC` (Operating
+	System Command) and `ST` (String Terminator) preprocessor
+	symbols for these ECMA-48 (ISO 6429) character sequences.
+	(tty_printer::simple_add_char): Add stripped-down alternative to
+	`add_char()` member function for cases where we want to use many
+	defaults because we're writing a terminal escape sequence, not
+	rendering a glyph.  (A function like `add_char()` that takes 8
+	arguments of varying types is a code smell--phew!)
+	(tty_printer::special): Call `special_link()` member function if
+	the device control command is `link`.
+	(tty_printer::special_link): Add new member function to generate
+	OSC 8 hyperlinks.
+
+	* src/devices/grotty/grotty.1.man: Document it.  Observe in
+	multiple places that disablement of SGR escape sequences
+	disables OSC 8 too.
+
+	* src/devices/grotty/tests/osc8_works.sh: Test it.
+	* src/devices/grotty/grotty.am (TESTS, grotty_TESTS): Run test.
+	(EXTRA_DIST): Ship test.
+
+	* NEWS: Add item.
+
+	Fixes <https://savannah.gnu.org/bugs/?60666>.  Thanks to Steffen
+	Nurpmeso for supplying a proof-of-concept.  (I went with my own
+	implementation, though, so blame me if it breaks.)
+
+2021-10-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Convert special character glyphs corresponding to
+	Unicode Basic Latin ("ASCII") code points to those code points
+	when they occur in device escapes.  (They should be correct for
+	IBM code page 1047 as well, but this is untested.)  This is
+	necessary for encoding URLs in device control commands.  Special
+	character identifiers are presumed to be the defaults documented
+	in groff_char(7); this is a design gap that we should consider
+	addressing.  (We don't have a way to ask "is this the special
+	character corresponding to Unicode basic Latin code point X?")
+
+	* src/roff/troff/input.cpp (encode_char): Do it.
+
+2021-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man, mdoc: Draw line after each page more consistently in
+	continuous rendering mode.
+
+	* tmac/an.tmac (an-bp): Move responsibility for line-drawing
+	after each document from here...
+	(an-end): ...to here.  Refactor; drop
+	`an-do-draw-line-after-document` register in favor of testing
+	`\n.F` for nullity; if it is not null, then another document
+	is due to be processed (in fact, `.F` already contains its file
+	name), and we need to draw a separating line.  If it is null, we
+	have reached the end of input and none is necessary.
+
+	* tmac/mdoc/doc-ditroff.tmac (doc-setup-page-layout):
+	* tmac/mdoc/doc-nroff.tmac (doc-setup-page-layout): Save
+	configured line length in new register `doc-line-length`.
+	* tmac/mdoc/doc-common.tmac (doc-end-macro): Port the above
+	man(7) feature to mdoc(7); draw a line of this length after each
+	document if continuously rendering.
+
+2021-10-01  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	ms: Update footnote handling documentation.
+
+	* tmac/groff_ms.7.man: Make some linguistic style adjustments.
+	(FP): Document it; see <https://savannah.gnu.org/bugs/?61022>.
+	(FS-MARK): Likewise, document this recently added feature.
+
+2021-10-01  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	ms: Support user-defined TOC leader style.
+
+	* tmac/s.tmac (toc*leader-char): Rename it as...
+	(TC-LEADER): ...this; within PX, leave it unchanged, if
+	predefined.
+	(TC-MARGIN): New numeric register; if predefined, leave it
+	unchanged, otherwise define as \w'000'; use it instead of
+	hard-wired definition, within PX; see
+	<https://savannah.gnu.org/bugs/?61157>.
+
+	* tmac/groff_ms.7.man (TC-LEADER, TC-MARGIN): Document them.
+
+2021-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic: Update input file name correctly.
+
+	* src/preproc/pic/troff.cpp (troff_output::set_location): Copy
+	the inbound file name argument with `strdup()` and store pointer
+	to this copy in `last_filename` instead of aliasing argument.
+	(troff_output::~troff_output): `free()` the memory allocated by
+	`strdup()` in destructor.
+
+	Fixes <https://savannah.gnu.org/bugs/?61206>.  Pointer
+	assignment instead of a string copy was being performed, which
+	means that after its initial assignment, `last_filename` always
+	shared its value ultimately with the `current_filename` pointer
+	{a libgroff symbol}, so `strcmp()` was always being performed on
+	identical pointers.  Problem appears to date back 30+ years, to
+	the dawn of our repo history.
+
+2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devlj4/S: Make font name consistent with file name.
+
+2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/font.cpp (font::load): Throw error if a font
+	description file is missing a `spacewidth` directive, since it
+	is now re-documented as mandatory.  Atypically, we don't return
+	false in this scenario; instead we proceed with the existing
+	logic to compute a space width for the font based on typical
+	practices for Western alphabetic fonts (see, e.g.,
+	<https://type.today/en/journal/spaces>.
+
+	* font/devdvi/EX:
+	* font/devdvi/MI:
+	* font/devdvi/S:
+	* font/devdvi/SA:
+	* font/devps/EURO: Add `spacewidth` directive to font
+	description files we ship that were missing it.  We use the same
+	values that libgroff would have computed, so there should be no
+	visible difference.
+
+2021-09-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Mark `$(TEST_SUITE_LOG)` as `.PRECIOUS`.  This
+	prevents the test suite log from being deleted if there are any
+	failures.
+
+	Fixes <https://savannah.gnu.org/bugs/?61213>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl (do_line): Move first-macro-call test
+	for `TH` to a more appropriate location.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Refactor to make it easier to generalize a per-package
+	scoring mechanism.
+
+	* src/utils/grog/grog.pl: Convert `inferred_main_package` from
+	scalar to list.  Add scalar `selected_main_package` to store a
+	"winner" from the list of main packages inferred.
+	(push_main_package): Add subroutine to populate
+	`inferred_main_package`.
+	(do_line, infer_man_or_ms_package): Update to use
+	`push_main_package`.
+	(construct_command): Rewrite to select a main package from the
+	list `inferred_main_package`, taking user-supplied arguments
+	into account as an overriding factor.  Drop now-unused `msupp`
+	list.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.cpp (main): If the `-I` option is given,
+	run the grn preprocessor and pass it an `-M` option with `-I`'s
+	argument.
+
+	* NEWS:
+	* src/roff/groff/groff.1.man (Options): Document it.  Also
+	document that `-I` options are passed to the output driver.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl (do_line): Don't strip groff-style
+	comments \# if AT&T compatibility mode is enabled.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Perform more font description file validation.  Our
+	documentation said that the `name` directive was mandatory but
+	we didn't actually enforce this.  Also be more specific in our
+	complaints of ill-formedness.
+
+	* src/libs/libgroff/font.cpp (font::load): Add local Boolean
+	variable `saw_name_directive`.  Rename `had_charset` to
+	`saw_charset_directive` for symmetry.  Emit distinct diagnostics
+	for `spacewidth` and `slant` directives having a missing,
+	non-numeric, or out-of-range argument.  Emit diagnostic if the
+	file lacks a `name` directive.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Slightly refactor.
+
+	* src/libs/libgroff/font.cpp (struct text_file): Rename member
+	variable `size` to `linebufsize` for clarity (it's certainly not
+	the size of the text file).
+	(text_file::text_file): Initialize `linebufsize` in constructor.
+	(text_file::next_line): Allocate new `buf` using `linebufsize`
+	instead of magic number (which was also stored to `size`, making
+	it only semi-magic, I guess).  Rename local variable `i` to
+	`length` since it is in fact the length (in `char`s) of the
+	string stored in `buf`.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Revisit fix for Savannah #61173.
+
+	* src/libs/libgroff/font.cpp (text_file::text_file): Restore
+	setting of `lineno` member variable to `0` in constructor
+	initializer list, but...
+	(text_file::next_line): ...unconditionally increment it every
+	time through this member function's outer loop.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Align diagnostic message format with libgroff.
+
+	* src/roff/troff/input.cpp (fatal_with_file_and_line): Report
+	the program name if one is defined.
+	(fatal_with_file_and_line, error_with_file_and_line,
+	debug_with_file_and_line): Report the line number of the input
+	file only if it is positive, so that other values can be used
+	for "whole file" complaints.  See commit cd0457b6, 17 September.
+
+2021-09-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop redundant diagnostic.
+
+	* src/libs/libgroff/font.cpp (font::load): Drop redundant
+	diagnostic; a missing `charset` directive is already checked for
+	later, circa line 998.
+
+2021-09-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Fix code style nits.
+
+	* src/libs/libgroff/font.cpp (font::font): Use initializer list
+	as much as possible in constructor.
+	(font::unit_scale, font::get_width, font::get_height,
+	font::get_depth, font::get_italic_correction,
+	font::get_left_italic_correction,
+	font::get_subscript_correction, font::get_character_type,
+	font::get_code, font::get_special_device_encoding): These member
+	functions rely on the font being either indexed or associated
+	with an output device that uses the `unicode` directive in its
+	`DESC` file.  The compiler doesn't know this, so annotate the
+	`abort()` calls that conclude them.  Add an `assert()` before
+	each one to more usefully describe the violated invariant in the
+	event this unreachable code is somehow reached.
+	(font::get_width): Annotate special meaning of zero zoom factor.
+
+2021-09-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/include/font.h (UNDEFINED_GLYPH): Use idiomatic C++98 null
+	pointer constant.
+
+2021-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Fix compiler warning and dead store.
+
+	* src/devices/grohtml/post-html.cpp (html_printer::special):
+	Update call of `font::load_font()` to stop passing obsolete
+	parameter (deleted by me in 2dff87d3, 17 September).  The value
+	stored to the parameter by that function was never read anyway,
+	so also get rid of the variable that contained it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61187>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Slightly refactor.
+
+	* src/include/font.h (font::scan_papersize): Demote return type
+	from `int` to `bool`.
+	* src/libs/libgroff/font.cpp (font::scan_papersize): As above.
+	Use Boolean instead of integer literals.  Also rename `FILE`
+	stream pointer from `f` to `fp` and perform an explicit
+	comparison against the idiomatic C++98 null pointer constant.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff, troff: Slightly refactor device and font description
+	file loading.  Remove dead code.
+
+	* src/include/font.h (font::load_font): Drop second parameter.
+	It was never used for its intended purpose.
+	(load): Drop first parameter; likewise.
+	* src/libs/libgroff/font.cpp (font::load, load): As above.
+
+	* src/libs/libgroff/font.cpp (struct text_file): Rename
+	`skip_comments` to `recognize_comments`.  Demote that and
+	`silent` from `int` to `bool`.
+	(text_file::text_file): Use Boolean rather than integer literals
+	in constructor.
+	(text_file::next_line, font::load): Apply above renaming.
+
+	* src/libs/libgroff/font.cpp (font::load): Rename parameter from
+	`head_only` to `load_header_only` to be more communicative.
+	Drop test of font description file name being `DESC`; this code
+	was not being reached.  Stop throwing errors from this function
+	on failure to open the file; the caller will handle this when it
+	sees our false return value.  Rename local variable `command` to
+	`directive` for alignment with our documentation.  Replace "I
+	dont think this should happen" test and comment with `assert()`.
+	(struct table): Rename member from `command` to
+	`numeric_directive` to indicate its specificity, tracking only a
+	subset of valid `DESC` file directives.
+
+	* src/libs/libgroff/font.cpp (font::load, font::load_desc):
+	Remove redundant assignments to the member variable formerly
+	known as `skip_comments`.
+
+	* src/libs/libgroff/font.cpp (font::load_desc): Rename local
+	variable `directive_found` to `numeric_directive_found` to
+	clarify logic.
+
+	* src/roff/troff/node.cpp (mount_font_no_translate): Simplify
+	call of `font::load_font`.  The `not_found` in-out parameter
+	which was so agonizingly passed up through layers of library
+	calls was never actually read.  Drop code that has been `#if
+	0`-ed out since 1993.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/font.cpp (font::load_desc): Clear line
+	number before emitting whole-file validity diagnostics.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/font.cpp (font::load_desc): Emit correct
+	line numbers when complaining of invalid `sizescale`, `hor`, or
+	`vert` values in device description files.
+
+	Fixes <https://savannah.gnu.org/bugs/?61174>.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Increase validation of device and font description
+	files.
+
+	* src/libs/libgroff/font.cpp (font::load): Validate the syntax
+	and value of the `name` directive.
+	(font::load_desc): Issue distinct diagnostics for a `fonts`
+	directive that is missing arguments and for a first argument
+	that can't be interpreted as a valid number.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Make error reporting more flexible.
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	Interpret a nonpositive line number specially: treat the
+	diagnostic as applying to the entire file, and omit the line
+	number.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Add information to diagnostics.
+
+	* src/libs/libgroff/font.cpp (font::load): Drop unused argument
+	from `error()` call.
+	(font::load_desc): In another, add name of numeric directive
+	that is given an unparsable number.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Tweak code style.
+
+	* src/libs/libgroff/font.cpp (trim_args, font::load)
+	(font::load_desc): Compare pointer explicitly to null pointer
+	literal `0` instead of using logical complementation.
+	(font::load, font::load_desc): Swap order of null pointer
+	equality comparisons when a typo or thinko could lead to lvalue
+	assignment.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Use idiomatic C++98 null pointer constant.
+
+	* src/libs/libgroff/font.cpp (text_file::error)
+	(glyph_to_unicode, font::get_special_device_encoding)
+	(font::load):
+	* src/libs/libgroff/fontfile.cpp (font::image_generator):
+	* src/libs/libgroff/nametoindex.cpp (class charinfo)
+	(character_indexer::named_char_glyph)
+	(character_indexer::numbered_char_glyph):
+	* src/libs/libgroff/string.cpp (string::clear):
+	* src/libs/libgroff/tmpfile.cpp (temp_init::temp_init):
+	* src/libs/libgroff/tmpname.cpp (gen_tempname): Use `0` literal
+	instead of `NULL` to represent a null pointer; this was
+	idiomatic in C++98 and is mostly the practice elsewhere in
+	groff.  Also swap order of null pointer equality comparisons
+	when a typo or thinko could lead to lvalue assignment.
+
+	* src/roff/troff/input.cpp (input_stack::diversion_state)
+	(input_stack::get_diversion_state, charinfo::contains)
+	(glyph_to_name): Similar.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Slightly refactor.
+
+	* src/libs/libgroff/font.cpp (font::load): Use same loop style
+	as `font::load_desc()`.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Fix off-by-one error in font and device description
+	file reader diagnostics.
+
+	* src/libs/libgroff/font.cpp (text_file::text_file): All text
+	files begin with line 1, not line 0.
+
+	Fixes <https://savannah.gnu.org/bugs/?61173>.
+
+2021-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Boolify more interfaces.
+
+	* src/include/font.h (font::unit_scale):
+	* src/libs/libgroff/font.cpp (font::unit_scale): Demote return
+	type from `int` to `bool`.  Use Boolean literals instead of
+	integers.
+
+	* src/libs/libgroff/font.cpp (struct text_file): Rename `next`
+	member function to `next_line`.  Demote its return type from
+	`int` to `bool`.  Use Boolean literals instead of integers.
+
+2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Boolify local variables.
+
+	* src/libs/libgroff/font.cpp (font::load, font::load_desc):
+	Demote local variables used as Booleans from `int` to `bool` and
+	update literals used with them from integer to Boolean.
+
+2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grn, groff, troff: Communicate better when device DESC file
+	can't be loaded.
+
+	* src/libs/libgroff/font.cpp (font::load_desc): Stop writing
+	diagnostic to standard error.
+	* src/preproc/grn/main.cpp (getres):
+	* src/roff/troff/troff.cpp (main): Replace "sorry, I can't
+	continue" fatal diagnostic with a more informative message.
+	Instead say which device's DESC file the program was trying to
+	open, which might reveal a user's logic error or typo.
+	* src/roff/groff/groff.cpp (main): Replace "invalid device" text
+	of fatal diagnostic similarly.  I think it is more helpful to
+	indicate the operation that failed rather than saying the device
+	was invalid, particularly since there are other ways for a
+	device description to be invalid even if a DESC file is found
+	and loaded.
+
+2021-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Throw warning diagnostic if device DESC file attempts
+	to load unavailable fonts.
+
+	* src/roff/troff/input.cpp (main): Take advantage of new Boolean
+	return values of `mount_style()` and `mount_font()` to produce
+	warning diagnostics if mounting a style or font as directed by
+	the DESC file fails.  Explain in a comment why, at present, this
+	style mount warning will never actually trip.
+
+2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Lift font mounting diagnostic messages to be closer to
+	their user-controlled contexts to provide more information.  In
+	many cases no diagnostic was being thrown at all when an
+	unavailable font was requested by name, which is the method most
+	users prefer, and which meant that failures resulting from typos
+	in font names for many requests (`uf`, `fschar`, `rfschar`,
+	`special`, `fspecial`, `fzoom`, `bd`, `tkf`, `cs`) were going
+	unreported.  Further, promote these font warnings to errors
+	because the request will utterly fail to do what was requested
+	with no reasonable fallback.  Possibly, they were formerly
+	warnings because at the low level they were being emitted, they
+	could also have originated from unavailable fonts encountered in
+	device description files, and while that's bad news, it results
+	in no formatting problems if it doesn't affect fonts that an
+	input document actually uses.
+
+	* src/roff/troff/node.cpp (struct font_lookup_info): New struct
+	keeps the font name or position requested, and the position of
+	successful font lookup.
+	(font_lookup_info::font_lookup_info): Add constructor.
+	(font_lookup_error): New function builds error message using a
+	`font_lookup_info` struct and a message argument.
+	(get_fontno): Rename to...
+	(has_font): ...this.  Add argument to take a pointer to a
+	`font_lookup_info` struct.  Return a `bool` indicating whether
+	the lookup succeeded.  Place former `int` return value into the
+	struct instead.  Populate the other struct members with the
+	requested font name or position, as appropriate.
+	(mount_font_no_translate): Stop throwing warning diagnostic here
+	if a font cannot be loaded.  Instead, throw them...
+	(font_position): ...here, and...
+	(underline_font, define_font_special_character,
+	remove_font_special_character, read_special_fonts,
+	font_special_request, font_zoom_request, bold_font, track_kern,
+	constant_space): ...here, using `font_lookup_info` structs and
+	`has_font()`.
+	(remove_font_special_character): Stop returning early if font
+	lookup fails; it's gratuitously inconsistent with other similar
+	functions (save one, which has a reason to be different).
+	(define_font_special_character): Return early if font lookup
+	fails and say why in a comment (we can't `skip_line()`).
+
+	Fixes <https://savannah.gnu.org/bugs/?59522>.
+
+2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* libgroff, troff: Further boolify.
+
+	* src/include/font.h (load_font, font): Demote parameters from
+	{pointer to} `int` to `bool` and update default literal from
+	integer to Boolean (except for the pointer).  Update comment.
+	* src/libs/libgroff/font.cpp (load_font, load): Similarly.
+
+	* src/roff/troff/node.h (mount_font):
+	* src/roff/troff/node.cpp (mount_font): Demote return type from
+	`int` to `bool`.
+
+	* src/roff/troff/node.h (mount_style):
+	* src/roff/troff/node.cpp (mount_style): Promote return type
+	from `void` to `bool`.
+
+	* src/roff/troff/node.cpp (mount_font_no_translate): Demote
+	return type and `check_only` parameter from `int` to `bool` and
+	use Boolean rather than integer literals with them.
+	(check_font): Update call site of `mount_font_no_translate` to
+	use Boolean literal.
+	(font_position): Indicate that "error" is ignored by casting
+	return value of `mount_font` to void instead of using a comment.
+	(style): Cast return value of `mount_style` to `void`.
+
+2021-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Add `.DELETE_ON_ERROR` special target; both GNU
+	and FreeBSD make(1)s support it so maybe it will be portable
+	enough.  This avoids, among other problems, a target appearing
+	falsely up-to-date (often as an empty file) when the troff
+	process generating it experiences an assertion failure.
+
+2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Since June 1991 if not earlier, groff (technically, the refer,
+	lookbib, and lkbib programs) has trusted the header contents of
+	binary bibliographic index files (canonically generated with
+	indxbib(1)) regarding the sizes of the data structures that
+	follow in the file, a notorious class of security problem.  In
+	July 2013, the Mayhem Team at Carnegie Mellon University
+	reported to the Debian Bug Tracking System a problem with
+	groff's refer(1) implementation dumping core when reading an
+	index file prepared by a fuzzer.
+
+	* src/libs/libbib/index.cpp (index_search_item::check_header):
+	Add new member function to validate the header of an indexed
+	bibliography file, returning a string describing in detail the
+	first validity problem encountered.
+	(index_search_item::load): Perform the foregoing check before
+	using any of the size values taken from the header; they are
+	relied upon for pointer arithmetic.  If in verification mode
+	{using the undocumented `-V` flag to refer(1), lkbib(1), or
+	lookbib(1)}, report the details of the problem encountered.
+	Regardless of that mode, if there is a validity problem, report
+	corruption of the index file and abandon it, forcing fallback to
+	the text version of the corresponding bibliography file.
+
+	Fixes <https://bugs.debian.org/716109>.
+
+2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libbib/index.cpp
+	(index_search_item::get_invalidity_reason): Don't complain about
+	a last list element being nonnegative if the list size was zero
+	in the first place, as can happen with an empty index.  More
+	seriously from a language standpoint, avoid reading through a
+	negative array index (this can escape a compiler's attention
+	because we're reading from the midst of a heap-allocated or
+	`mmap()`ed region, but it's still a code smell).
+
+	Fixes <https://savannah.gnu.org/bugs/?61144>.
+
+2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libbib/index.cpp (index_search_item::load)
+	(index_search_item::get_invalidity_reason)
+	(index_search_item::add_out_of_date_file): Clarify diagnostic
+	messages.  Make it more obvious when we're complaining of a
+	problem in an indexed bibliographic database file (rather than a
+	plain text one).  Dial down the amount of Unix jargon a little.
+
+2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libbib: Partially boolify.
+
+	* src/include/search.h:
+	* src/libs/libbib/index.cpp:
+	* src/preproc/refer/refer.cpp:
+	* src/utils/lkbib/lkbib.cpp:
+	* src/utils/lookbib/lookbib.cpp: Demote `verify_flag` from an
+	`int` to a `bool`, rename it to `do_verify`, use Boolean
+	instead of integer literals with it, and update call sites.
+
+	* src/libs/libbib/index.cpp: Rename `do_verify()` member
+	function to `get_invalidity_reason()` (it returns a string).
+	Demote `load()` from `int` to `bool`; do the same for `verify()`
+	and rename it to `is_valid()` as well.  Use Boolean instead of
+	integer literals with them.
+	(index_search_item::is_valid, make_index_search_item): Update
+	call sites of renamed member functions.
+
+2021-09-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libbib/map.c (mapread): Compare return value of
+	`mmap()` to `MAP_FAILED` instead of `(char *)-1`.  `MAP_FAILED`
+	is documented in POSIX Issue 5 a.k.a. SUSv2
+	<https://pubs.opengroup.org/onlinepubs/007908799/xsh/mmap.html>
+	{1997} and should be portable enough by now.
+
+2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Clamp negative tab stop positions to zero instead of
+	throwing an assertion failure.
+
+	* src/roff/troff/env.cpp (tab_stops::distance_to_next_tab):
+	Replace `assert` with clamping logic, ensuring that `lastpos`
+	can never be negative.  While negative tab stop positions don't
+	make much sense (they result in zero horizontal motion), user
+	input like `.ta T -5` should never provoke an assertion failure.
+
+	(set_tabs): Throw range warning in additional scenario, viz., if
+	a repeating tab offset is negative.
+
+	Fixes <https://bugs.debian.org/990406>.  Thanks to наб for the
+	report.
+
+2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Boolify `set_tabs` function.
+
+	* src/roff/troff/env.cpp (set_tabs): Demote local variables from
+	`int` to `bool` and give them predicate-like names.
+	  - `first` -> `is_first_stop`
+	  - `repeated` -> `is_repeating_stop`
+	Use Boolean instead of integer literals in assignments to them.
+
+2021-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Deprecate `OP` macro.
+
+	* tmac/an-ext.tmac (OP): Move implementation from here...
+	* tmac/an.tmac (OP): ...to here.  Throw deprecation warning.
+	Throw style warning if wrong number of arguments given.
+
+	* tmac/groff_man.7.man.in (Description): Drop from introductory
+	macro summary.
+	(Description/Command synopsis macros): Move discussion from
+	here...
+	(Description/Deprecated features): ...to here.  Explain why it's
+	deprecated.
+
+2021-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Make `ab` request quiet if given no arguments.  The
+	`tm`, `tm1`, and `tmc` requests provide ample flexibility for
+	constructing diagnostic messages prior to an error exit, and
+	it's convenient to make `ab` itself quiet instead of saying
+	"User Abort." as Unix Version 7 troff did.  Further, there is no
+	standardization across troffs regarding what `ab` should emit if
+	arguments are absent.
+
+	* src/roff/troff/input.cpp (abort_request): Do it.
+
+	* src/roff/groff/tests/ab_works.sh:
+	* src/roff/groff/groff.am (groff_TESTS): Test it.
+
+	* doc/groff.texi (Debugging, Implementation Differences):
+	* man/groff.7.man (Requests/Request short reference):
+	* man/groff_diff.7.man (Implementation differences): Document
+	it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61070>.  Thanks to Dave
+	Kemper for the discussion.
+
+2021-09-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Update exit status literals.
+
+	* src/roff/troff/div.cpp (top_level_diversion::begin_page):
+	* src/roff/troff/input.cpp (exit_troff, abort_request, do_error)
+	(fatal_with_file_and_line): Use standard C library preprocessor
+	symbols `EXIT_SUCCESS` and `EXIT_FAILURE` instead of 0 and 1
+	literals, respectively.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Drop unused member function.
+
+	* src/roff/troff/token.h (class token): Drop unused `title`
+	member function.  Its implementation was apparently removed in
+	the prehistory of our Git repository: see James Clark's
+	ChangeLog entry of 1990-09-06.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Remove workaround for Cfront 1.2 bug.
+
+	* src/roff/troff/input.cpp (do_define_macro): Move `dot_symbol`
+	from to file to function local scope as originally intended.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Rename parameter.
+
+	* src/roff/troff/input.cpp (token::usable_as_delimiter): Rename
+	parameter from `err` to `report_error` to be more communicative.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Boolify members of `token` class.
+
+	* src/roff/troff/token.h (class token): Demote return type of
+	several member functions from `int` to `bool` and rename them.
+	  - `backspace` -> `is_backspace`
+	  - `delimiter` -> `usable_as_delimiter`
+	  - `dummy` -> `is_dummy`
+	  - `eof` -> `is_eof`
+	  - `horizontal_space` -> `is_horizontal_space`
+	  - `hyphen_indicator` -> `is_hyphen_indicator`
+	  - `leader` -> `is_leader`
+	  - `left_brace` -> `is_left_brace`
+	  - `newline` -> `is_newline`
+	  - `page_ejector` -> `is_page_ejector`
+	  - `right_brace` -> `is_right_brace`
+	  - `space` -> `is_space`
+	  - `special` -> `is_special`
+	  - `stretchable_space` -> `is_stretchable_space`
+	  - `tab` -> `is_tab`
+	  - `transparent_dummy` -> `is_transparent_dummy`
+	  - `transparent` -> `is_transparent`
+	  - `unstretchable_space` -> `is_unstretchable_space`
+	  - `white_space` -> `is_white_space`
+	  - `zero_width_break` -> `is_zero_width_break`
+	(class token): Drop 1991 comment anticipating that member
+	function `nspaces` could return "2" for a "double space"; this
+	was apparently never implemented.
+	(class token): Drop parameter names from declarations; the
+	prevailing style (familiar from Stroustrup) is not to use them.
+	(token::is_special): Simplify implementation.
+
+	* src/roff/troff/input.cpp (has_arg)
+	(token::usable_as_delimiter): Update definitions of above member
+	functions not defined in token.h.
+
+	* src/roff/troff/div.cpp (begin_page, space_request, need_space)
+	(output_saved_vertical_space, flush_output):
+	* src/roff/troff/env.cpp (fill, no_fill, center)
+	(right_justify, indent, temporary_indent, margin_character)
+	(number_lines, do_break_request, hyphen_word):
+	* src/roff/troff/input.cpp (next_file, do_overstrike)
+	(do_bracket, do_name_test, do_expr_test, do_zero_width)
+	(token::skip, has_arg, skip_line, empty_name_warning)
+	(non_empty_name_warning, do_get_long_name, process_input_stack)
+	(flush_pending_lines, decode_args, read_request)
+	(do_define_string, do_define_character, remove_character)
+	(do_define_macro, length_request, get_delim_number)
+	(get_line_arg, read_size, get_delim_name, do_register, do_width)
+	(read_title_parts, encode_char, do_special, device_request)
+	(output_request, skip_alternative, begin_alternative)
+	(nop_request, do_if_request, do_source, pipe_source)
+	(ps_bbox_request, tag, taga, do_terminal, do_translate)
+	(hyphenation_code, hyphenation_patterns_file_code, define_class)
+	(get_optional_char, check_missing_character, abort_request)
+	(copy_file, transparent_file, do_macro_source)
+	(charinfo_to_node_list, read_draw_node, read_color_draw_node):
+	* src/roff/troff/node.cpp (get_fontno)
+	(remove_font_special_character, bold_font):
+	* src/roff/troff/number.cpp (start_number, parse_term):
+	* src/roff/troff/reg.cpp (define_number_reg, alter_format):
+	Update call sites to use new names.
+
+	* src/roff/troff/input.cpp (token::usable_as_delimiter)
+	(read_draw_node): Return Boolean, not integer, literals.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Clamp line and title lengths to device horizontal
+	resolution.
+
+	* src/roff/troff/env.cpp (line_length, title_length): Do it.
+
+	Fixes <https://savannah.gnu.org/bugs/?61116>.
+
+2021-09-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (do_hyphenation_patterns_file):
+	Refactor slightly.  Demote `append` from `int` to `bool`.
+	(hyphenation_patterns_file, hyphenation_patterns_file_append):
+	Update call sites to use Boolean, not integer, literals.
+
+2021-09-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/hvunits.h:
+	* src/roff/groff/number.cpp: Mark `H0`, `V0` objects as `const`.
+
+2021-09-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (do_underline_special): Refactor
+	slightly.
+	  - Rename `underline_spaces` -> `do_underline_spaces`.
+	  - Demote it from an `int` to a `bool`.
+	  - Use ternary operator and explicit character literals when
+	    writing device control command instead of doing arithmetic
+	    on a character literal.
+	  - Update call sites to use Boolean literals.
+	  - Relocate function to avoid forward reference.
+	  - Mark function as static to eliminate external linkage.
+	    Remove now-unnecessary prototype.
+
+2021-09-04  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Add "ms" footnote marker placement hook.
+
+	* tmac/s.tmac (FS-MARK): New macro; define as no-op, by default.
+	(@FS): Invoke FS-MARK as first action, allowing caller to "hook" it.
+
+2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (distribute_space): Refactor slightly.
+	  - Rename `force_reverse` to `force_reverse_node_list`.
+	  - Rename `reverse` to `do_reverse`.
+	  - Demote both of the above from `int` to `bool`.
+	  - Use Boolean literals with them.
+	  - Add assertions to enforce positive values of `nspaces` and
+	    `desired_space`.
+	  - Remove now-redundant test for `nspaces` being positive.
+	  - Add explanatory comments.
+	(environment::wrap_up_field): Update call sites of
+	`distribute_space` when non-default value of
+	`force_reverse_node_list` is supplied.
+
+2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Don't adjust nonadjustable lines.  This means that the
+	direction from which an output line in adjustment mode "b" (or
+	its "n" synonym) is filled with supplemental space is not
+	changed if that output line does not require adjustment.  This
+	will result in whitespace changes to documents using that
+	adjustment mode, and these changes will be plainly visible on
+	low-resolution output devices like terminals.
+
+	To illustrate, in the following "A" means an output line
+	requiring adjustment; "F" a line that is "full" and does not;
+	and "L" and "R" indicate distribution of adjustment spaces from
+	the left and right, respectively.
+
+	groff 1.22.4    groff 1.23.0
+	------------    ------------
+	A    L          A    L
+	A    R          A    R
+	F    L          F    R
+	A    R          A    L
+
+	* src/roff/troff/env.cpp (distribute_space): Return early if
+	either the amount of desired space to be distributed or the
+	count of space nodes in the output line to distribute it among
+	is zero.
 
-	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Improve
+	* tmac/tests/an_TH-repairs-ad-damage.sh: Update test to expect
+	space to be distributed differently.
+
+	Fixes <https://savannah.gnu.org/bugs/?61089> and
+	<https://savannah.gnu.org/bugs/?60673>.
+
+2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Skip core-dump-checking test if a core file already exists.
+
+	* src/roff/groff/tests/regression_savannah_59202.sh: Skip test
+	if a core dump is already present.
+
+2021-09-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #60189.
+
+	* src/roff/groff/tests/break_zero-length_output_line_sanely.sh:
+	Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-08-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Tweak diagnostic message.
+
+	* src/roff/troff/env.cpp (environment::environment): Use
+	terminology more rigorously in diagnostic.
+
+2021-08-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Fix code style nit.
+
+	* src/libs/libgroff/errarg.cpp (errprint): Replace `assert(0)`
+	with a meaningful predicate.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Demote `need_space` to Boolean.
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	Demote local integer `need_space` and its assignments to `bool`.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Boolify `font::load()` and `font::load_desc()`
+	return values.
+
+	* src/include/font.h (font::load, font::load_desc):
+	* src/libs/libgroff/font.cpp (font::load, font::load_desc): Do
+	it.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (TRADITIONAL_CPP): Update `AC_MSG_CHECKING`
+	argument to refer to "pre-ISO C90 syntax" instead of a
+	"traditional" preprocessor.  Call `AC_MSG_ERROR` (aborting
+	configuration) if the check (for pre-C90 transformation)
+	succeeds.  We thus withdraw support for such superannuated
+	{"Reiser"} C preprocessors.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Un-indirect token concatenation through macro.
+
+	* src/include/itable.h:
+	* src/include/ptable.h: Do it.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop support for `TRADITIONAL_CPP`.  This means a C
+	preprocessor that does not support the ANSI C89/ISO C90
+	token concatenation operator "##".
+
+	* src/include/itable.h:
+	* src/include/ptable.h: Do it.
+
+	* Makefile.am: Undocument preprocessor symbol.
+
+2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop `a_delete` preprocessor wrapper for the
+	`delete` operator.  It has been rendered unnecessary by the
+	removal of support for ancient C++ compilers.
+
+	* src/include/lib.h (a_delete): Drop symbol definition.
+
+	* src/devices/grohtml/output.cpp (word::~word):
+	* src/devices/grohtml/post-html.cpp (char_block::char_block)
+	(assert_state::~assert_state, assert_state::add)
+	(assert_state::close, replace_negate_str):
+	* src/devices/grops/ps.cpp (ps_font::ps_font)
+	(subencoding::subencoding, ps_printer::define_encoding)
+	(ps_printer::encode_fonts):
+	* src/devices/grops/psrm.cpp (resource_manager::document_setup)
+	(resource_manager::supply_resource):
+	* src/devices/grotty/tty.cpp (tty_printer::tty_color)
+	(tty_printer::tty_printer, tty_printer::color_to_idx)
+	(tty_printer::add_char):
+	* src/include/itable.h (ITABLE(T)::~ITABLE(T))
+	(ITABLE(T)::define):
+	* src/include/ptable.h (PTABLE(T)::~PTABLE(T))
+	(PTABLE(T)::define):
+	* src/libs/libbib/index.cpp
+	(index_search_item::~index_search_item, make_index_search_item,
+	index_search_item_iterator::index_search_item_iterator,
+	index_search_item::get_tag, index_search_item::munge_filename,
+	index_search_item::search):
+	* src/libs/libbib/linear.cpp (bmpattern::~bmpattern)
+	(file_buffer::file_buffer, file_buffer::load)
+	(linear_searcher::linear_searcher)
+	(linear_searcher::~linear_searcher):
+	* src/libs/libbib/search.cpp
+	(search_list_iterator::search_list_iterator)
+	(search_item::search_item):
+	* src/libs/libdriver/input.cpp (IntArray::~IntArray)
+	(IntArray::append, StringBuf::~StringBuf, StringBuf::append)
+	(get_integer_arg, parse_x_command, do_file):
+	* src/libs/libdriver/printer.cpp (printer::printer)
+	(printer::load_font, text_file::~text_file, text_file::next)
+	(font::~font, font_widths_cache::~font_widths_cache)
+	(font:alloc_ch_index, font::extend_ch, font::compact)
+	(font::load_desc):
+	* src/libs/libgroff/fontfile.cpp (font::open_file):
+	* src/libs/libgroff/relocate.cpp (searchpath, searchpathext)
+	(set_current_prefix):
+	* src/libs/libgroff/searchpath.cpp (search_path::search_path)
+	(search_path::command_line_dir, search_path::open_file)
+	(search_path::open_file_cautious):
+	* src/libs/libgroff/string.cpp (sfree, srealloc)
+	(string::remove_spaces):
+	* src/libs/libgroff/symbol.cpp (symbol::symbol, concat):
+	* src/libs/libgroff/tmpfile.cpp (temp_init::temp_init)
+	(xtmpfile_list_init::~xtmpfile_list_init, xtmpfile):
+	* src/preproc/eqn/box.cpp (set_gfont, set_grfont, set_gbfont)
+	(box_list::append, box_list::~box_list):
+	* src/preproc/eqn/delim.cpp (make_delim_box)
+	(delim_box::~delim_box):
+	* src/preproc/eqn/eqn.ypp (number):
+	* src/preproc/eqn/lex.ypp (file_input::~file_input)
+	(argument_macro_input::~argument_macro_input):
+	* src/preproc/eqn/pile.ypp (matrix_box::~matrix_box)
+	(matrix_box::append):
+	* src/preproc/eqn/special.cpp (special_box::~special_box):
+	* src/preproc/eqn/text.ypp (set_char_type):
+	* src/preproc/html/pre-html.cpp (get_line, scanArguments):
+	* src/preproc/pic/object.cpp (output::~output)
+	(output::set_args, text_item::~text_item)
+	(object_spec::~object_spec, command_object::~command_object)
+	(line_object::~line_object):
+	* src/preproc/pic/pic.ypp (placeless_element, reset_variables)
+	(print_args, text_expr, object_spec, text, sprintf_args, path):
+	* src/preproc/refer/command.cpp (input_item::~input_item)
+	(input_item::peek_char):
+	* src/preproc/refer/label.ypp (lookup_label):
+	* src/preproc/refer/refer.cpp (store_citation, store_reference):
+	* src/preproc/tbl/main.cpp (format::add_rows, format::~format):
+	* src/preproc/tbl/table.cpp (block_entry::~block_entry)
+	(table::~table, table::allocate):
+	* src/roff/groff/groff.cpp (possible_command::~possible_command)
+	(possible_command::clear_name):
+	* src/roff/troff/column.cpp
+	((justification_spec::~justification_spec)
+	(justification_spec::append):
+	* src/roff/troff/dictionary.cpp (dictionary::lookup):
+	* src/roff/troff/env.cpp (override_sizes, tab_stops::to_string)
+	(hyphen_word, hyphen_trie::insert_hyphenation):
+	* src/roff/troff/input.cpp (read_long_escape_name, token::next)
+	(do_get_long_name, temp_iterator::~temp_iterator)
+	(get_delim_name, pipe_source, read_string, pipe_output)
+	(system_request, open_mac_file, do_macro_source)
+	(do_register_assignment, do_string_assignment, read_draw_node)
+	(copy_mode_error):
+	* src/roff/troff/node.cpp (troff_output_file::set_font)
+	(troff_output_file::~troff_output_file, draw_node::is_tag)
+	(grow_font_table, font_family::~font_family)
+	(font_family::make_definite):
+	* src/utils/hpftodit/hpftodit.cpp (name_list::~name_list)
+	(read_map):
+	* src/utils/indxbib/indxbib.cpp (main, get_cwd):
+	* src/utils/tfmtodit/tfmtodit.cpp (tfm::~tfm, tfm::load): Port
+	uses of `a_delete` to `delete`.
+
+2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop `ad_delete` preprocessor wrapper for the
+	`delete` operator.  It has been rendered unnecessary by the
+	removal of support for ancient C++ compilers.
+
+	* src/include/lib.h (ad_delete): Drop symbol definition.
+
+	* src/preproc/pic/object.cpp (graphic_object::print_text):
+	* src/preproc/refer/ref.cpp (reference::reference)
+	(reference::merge, reference::insert_field)
+	(reference::delete_field):
+	* src/preproc/tbl/main.cpp (format::add_rows): Port uses of
+	`ad_delete` to `delete`.
+
+2021-08-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_ARRAY_DELETE): Update `AC_MSG_CHECKING`
+	argument to refer to "ISO C++98" instead of "ANSI".  Call
+	`AC_MSG_ERROR` (aborting configuration) if the check fails.
+
+2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop support for `ARRAY_DELETE_NEEDS_SIZE`.
+
+	* src/include/lib.h ARRAY_DELETE_NEEDS_SIZE: Drop preprocessor
+	conditional branch.  This abandons support for certain pre-ISO
+	C++98 compilers.  (According to a now-removed comment, unsized
+	array deletion was documented in "ARM", meaning _The C++
+	Annotated Reference Manual_, published in 1989.)
+
+	* Makefile.am: Undocument preprocessor symbol.
+
+2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop redefinition of `INT_MIN`.
+
+	* src/include/lib.h: Drop redefinition of `INT_MIN`.  It was
+	motivated by a bug in the AT&T C++ compiler (cfront), version
+	2.0, released in June 1989.  Implementations have had 30 years
+	to get this right; assume that they have.
+
+	* PROBLEMS: Drop corresponding item.
+
+2021-08-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Drop long-dead `COOKIE_BUG` logic.
+
+	* src/libs/libgroff/new.cpp (operator new, operator delete):
+	Drop preprocessor conditional branches on the `COOKIE_BUG`
+	symbol.  This was de-documented, and an autoconf check for its
+	necessity removed, way back in groff 1.10 (November 1995).  It
+	was relevant only to GCC from versions 2.0 to 2.2.2 (all 1992).
+
+2021-08-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff: Refactor `font::scan_papersize()`.
+
+	* src/libs/libgroff/font.cpp (font::scan_papersize): Ensure
+	successful return value of `fgets()` before attempting to parse
+	string for paper format.  Convert `test_file` to Boolean and
+	rename to `attempt_file_open`.  Quiets GCC `-Wunused-result`
 	warning.
 
-2013-01-07  Werner LEMBERG  <wl@gnu.org>
+2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tests: Apply naming convention.
+
+	* tmac/tests/e_footnotes_work_with_columns.sh: Rename from...
+	* tmac/tests/e_footnotes-work-with-columns.sh: ...to this.
+	* tmac/tmac.am (tmac_TESTS): Update.
+
+2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an.tmac (IP): Make code more accessible by using a
+	Boolean operator rather than an arithmetic one (assembly
+	language programmers are comfortable with the interchangeability
+	of subtraction and comparison, but not everyone is).
+
+2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff(7): Document more escapes.
+
+	* man/groff.7.man (Escape short reference): Document
+	`\charNNN`, `\uNNNN`, `\uNNNN_NNNN...` escape sequences.
+	Revise descriptions of `\O0` and `\O1` escape sequences.
+	Document `\O2`, `\O3`, `\O4`, and `\O5` escape sequences.
+
+2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff(7): Fix bug in `\?` escape rendering.
+
+	* man/groff.7.man (ESC?): Fix bug in page-private macro: the
+	question mark that ends this uniquely-syntaxed escape sequence
+	was not shown with the mandatory escape character before it.
+	Problem dates back at least to commit 41b0e794, 19 February
+	2007, but possiby to f790bc7a9, 6 January 2002.
+
+2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	docs: Elaborate macro definition discussion.
 
-	tbl Allow characters #, `, and ' as eqn delimiters.
+	Fixes <https://savannah.gnu.org/bugs/?57944>.  Thanks to Dave
+	Kemper for the report.
 
-	While problems ` and ' have been unintentionally introduced rather
-	recently, the limitation regarding # was there from the beginning.
+2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	At the same time, fix a small bug causing `.lf' requests not
-	starting a line.
+	tests: Make robust against $GROFF_TYPESETTER settings.
 
-	* src/preproc/tbl/table.cpp (table::init_output)
-	(table::compute_expand_width, table::compute_separation_factor)
-	(table::define_bottom_macro, table::do_bottom): Temporarily switch
-	off eqn delimiters, wrapping the code into a `.ig' block.  This
-	uses the new functionality just added to eqn.
+	* src/roff/groff/tests/\
+	use_point_size_escape_with_single_digit_arg.sh:
+	* src/roff/nroff/tests/verbose_option_works.sh:
+	* tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Export
+	an empty $GROFF_TYPESETTER to the environment.
 
-	* src/preproc/eqn/eqn.man, src/preproc/tbl/tbl.man: Updated.
+	Fixes <https://savannah.gnu.org/bugs/?60140>.  Thanks to Bjarni
+	Ingi Gislason for the report.
 
-2013-01-06  Werner LEMBERG  <wl@gnu.org>
+2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	eqn Add `delim on'.
+	libgroff: Treat an empty $GROFF_TYPESETTER as unset.
 
-	* src/preproc/eqn/lex.cpp (start_delim_saved, end_delim_saved):
-	New global variables.
-	(do_delim): Handle `delim on' to restore previous start and end
-	delimiters.
+	* src/libs/libgroff/device.cpp (device_init::device_init): Test
+	both returned pointer from `getenv()` and, if that's not null,
+	the first character of the string for nullity before assigning
+	it to `device`.
 
-	* src/preproc/eqn/eqn.man, NEWS: Document it.
+	Fixes <https://savannah.gnu.org/bugs/?61068>.
 
-2013-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2021-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	gropdf Various minor fixes.
+	libgroff: Rename font class member variable.
 
-	* src/devices/gropdf/gropdf (do_x) <'X'> <'pdfpic'>: Using
+	* src/include/font.h (font class): Rename `unscaled_charwidths`
+	member variable to `use_unscaled_charwidths`: since it is a
+	Boolean, make it read more like a logical predicate.
 
-	\X'pdf: pdfpic'
+	* src/libs/libgroff/font.cpp (font::get_width, font::load_desc):
+	* src/libs/libgroff/fontfile.cpp (font class): Update
+	initialization and assignments.
 
-	with a zero width now works correctly.
+2021-08-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	(LoadPDF): Scale width in proportion to given height.
+	* src/roff/troff/input.cpp (get_copy): Demote integer arguments
+	to Booleans and use Boolean literals for default values.  Rename
+	`defining` to `is_defining`.
+	(get_char_for_escape_name, do_define_macro): Update call sites
+	that use non-default arguments to use Boolean literals and
+	comments to document what's being requested.
 
-	(do_s): In some circumstances a font size change is emitted before
-	current font is established.  Fix handles this situation.
+2021-08-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-12-30  Werner LEMBERG  <wl@gnu.org>
+	* doc/doc.am (DOC_GROFF_ONLY): Stop running groff in unsafe
+	mode; no documents (in _this_ directory) appear to require it.
 
-Version 1.22.1 released
-=======================
+2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Due to CVE-2012-3386, ftp.gnu.org rejected uploading of version
-	1.22 -- in other words, 1.22 has never been released.
+	grn: Fix code style issues.
 
-	* NEWS, REVISION, doc/groff.texinfo, doc/webpage.ms: Updated.
+	* src/preproc/grn/hgraph.cpp:
+	* src/preproc/grn/hpoint.cpp:
+	* src/preproc/grn/main.cpp:
+	* src/preproc/grn/hdb.cpp: Drop use of `register` storage class.
 
-	* Makefile.in (NOMAKEDIRS): Updated.
+	Fixes <https://savannah.gnu.org/bugs/?57733>.  Thanks to Bjarni
+	Ingi Gislason for the report and a suggested patch.
 
-2012-12-30  Werner LEMBERG  <wl@gnu.org>
+	* src/preproc/grn/hgraph.cpp (len, HGPrintElt, picurve):
+	* src/preproc/grn/hdb.cpp (DBRead): Wrap long lines.
 
-	* src/libs/gnulib/*: Update `gnulib' files.
+	* src/preproc/grn/hgraph.cpp: Rename function from
+	`Paramaterize` to `Parameterize`.
+	(HGCurve): Update call site.
 
-	Because we currently don't support `gnulib-tool' directly but add
-	everything to the CVS repository, and many internal details of the
-	gnulib setup has changed, it is necessary to do redo the import.
+	* src/preproc/grn/main.cpp (add_file): Drop redundant cast in
+	`realloc()` call.
+	(conv, interpret): Use standard English in diagnostic messages.
 
-	. Temporarily rename `src/libs/gnulib' to `src/libs/gnulib.old'.
+2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	. Call
+	* src/preproc/grn/hdb.cpp: Perform more input validation.
+	Improve diagnostics by taking advantage of libgroff
+	infrastructure and tracking the line number of the input file.
+	Add global `lineno`.
+	(DBRead): Increment `lineno` after reading newlines from input.
+	Call `error_with_file_and_line()` instead of `error()`.  If
+	input reports a negative length for the text (string) to follow
+	in the file, exit with a fatal diagnostic.  Check for EOF while
+	reading text string.
+	(DBGetType): Convert `fprintf()` call for warning diagnostic to
+	`warning_with_file_and_line()`.
+	(DBRead, DBGetType): Add contextual information to diagnostic
+	messages.
 
-	    gnulib-tool --create-testdir \
-	                --dir=src/libs/gnulib \
-	                wcwidth
+	Fixes <https://savannah.gnu.org/bugs/?61043>.  Thanks to
+	Savannah user eqkws for the report.
 
-	. Manually move directories `src/libs/gnulib/gl{lib,m4}' to
-	`src/libs/gnulib/{lib,m4}', and do `s/gllib/lib/' and `s/glm4/m4/'
-	in all files to `convert' the gnulib testbed to a standard gnulib
-	configuration as maintained by gnulib-tool.  Additionally, remove
-	the directory `src/libs/gnulib/gltests' and the references to
-	`gltests' in all files.
+2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	(All of this could be done with a script, but I hope that this is
-	eventually replaced with migrating groff as a whole to gnulib and
-	its setup).
+	* src/preproc/grn/main.cpp (usage): Update usage message.
 
-	. Call
+2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	    gnulib-tool --add-import \
-	                --dir=src/libs/gnulib \
-	                wcwidth
+	grn: Add and use `malloc()` wrapper.
 
-	to update everything.
+	* /src/preproc/grn/main.cpp (grnmalloc): New function takes
+	argument of `size_t` type and constant string argument to
+	describe what is being allocated.  Return non-null pointer from
+	`malloc()`, otherwise call `fatal()`, describing what was being
+	allocated and the problem reported by the system.
 
-	. Merge the changed, new, and deleted files into `gnulib.old',
-	delete `gnulib', rename `gnulib.old' to `gnulib', then commit.
+	* src/preproc/grn/hdb.cpp (DBCreateElt):
+	* src/preproc/grn/hpoint.cpp (PTMakePoint):
+	* /src/preproc/grn/main.cpp (main, interpret): Migrate
+	`malloc()` callers to `grnmalloc()`.
 
-2012-12-28  Werner LEMBERG  <wl@gnu.org>
+2021-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	doc More documentation generation rules.
+	* src/preproc/grn/hdb.cpp (DBRead): Check return value of
+	`sscanf()` and call `fatal()` if no conversions succeeded.  The
+	blithe discard of a useful return value is bad enough, but this
+	one took place inside a do-while such that it could loop
+	forever trying fruitlessly to parse two doubles out of strings
+	that didn't contain them (the loop never checked the EOF status
+	of the file stream from which it was reading, and relied on
+	`fgets()` to keep advancing the stream pointer).  Discovered
+	while root-causing Savannah #61043.
 
-	* doc/Makefile.in (.texinfo.txt): New rule.
-	(.texinfo.html): Use `LANG='.
-	(split-html): New target.
+2021-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-12-28  Werner LEMBERG  <wl@gnu.org>
+	Resolve compiler warnings relating to format string security and
+	ISO C++98 conformance.
 
-	* doc/fixinfo.sh: Make it work with makinfo 4.13 also.
+	* src/preproc/eqn/delim.cpp (define_extensible_string):
+	* src/preproc/pic/pic.ypp (do_sprintf): Use #pragma to silence
+	GCC "format-nonliteral" warning and explain why our usage is
+	safe in a comment.
 
-2012-12-28  Werner LEMBERG  <wl@gnu.org>
+	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Use
+	`l` modifier to `%u` `fprintf()` conversion instead of `z`, and
+	cast return values of `size_t` to unsigned long; "ISO C++98
+	does not support the ‘z’ gnu_printf length modifier" (it doesn't
+	support `ll` either).  N.B. this is debugging output only.
 
-	Split ChangeLog.
+	* src/roff/groff/groff.cpp (synopsis):
+	* src/roff/troff/input.cpp (usage): Repeat variadic argument for
+	`%s` conversion in `fprintf()` call because "ISO C++98 does not
+	support %n$ operand number formats".
 
-	* ChangeLog: Split off older entries into...
-	* ChangeLog.121: this new file.
+	* src/roff/troff/env.cpp: Initialize adjustment and hyphenation
+	mode enums without commas at the end of the enumeration lists.
 
-2012-12-28  Werner LEMBERG  <wl@gnu.org>
+2021-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-Version 1.22 released
-=====================
+	man: Clean up the interface between `an-footer` and `BT`, and
+	HTML header and footer suppression generally.  Move
+	responsibility for checking the `ps4html` register from the
+	latter to the former.  This is not something a `BT` redefiner
+	{see groff_man(7)} should have to worry about.
 
-	* NEWS, VERSION, doc/groff.texinfo, doc/webpage.ms: Updated.
+	* tmac/an.tmac (BT): Drop test of `ps4html` register and early
+	return.
+	(an-header, an-footer): Return immediately if
+	`an-suppress-header-and-footer` is true.  Remove conditional on
+	`an-is-output-html`.
+	(initialization): Define `an-suppress-header-and-footer`
+	register; true if `an-is-output-html` is true, or if `ps4html`
+	is defined.
 
-	* config.guess, config.sub: Updated from `config' repository.
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* INSTALL.gen: Updated from `gnulib' repository (file `INSTALL').
+	* src/preproc/html/pre-html.cpp (get_resolution): Unbrace a
+	single-statement `while` loop per prevailing coding style.  Add
+	comments noting how we aren't parsing DESC files _precisely_ as
+	our documentation specifies.
 
-	* aclocal.m4, configure: Regenerated.
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/texinfo.tex: Updated from `texinfo' repository.
+	Convert font class `int` members to `bool` where appropriate.
 
-	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+	* src/include/font.h (font class): Demote integers to Booleans
+	and use Boolean literals where possible.  Rename some member
+	variables to look like logical predicates.
+	  - contains()
+	  - is_special()
+	  - has_ligature()
+	  - tcommand -> has_tcommand
+	  - unscaled_charwidths
+	  - pass_filenames
+	  - use_charnames_in_special
+	  - is_unicode
+	  - special (private)
+	* src/libs/libgroff/font.cpp (font::font): Construct object
+	using Boolean literal.
+	(font::contains):
+	(font::is_special):
+	(font::has_ligature): Convert return type to `bool`.
+	(font::load):
+	(font::load_desc): Assign to member variables using Boolean
+	literals.
+	* src/libs/libgroff/fontfile.cpp: Initialize appropriate globals
+	using `bool` type and Boolean literals.
+	* src/roff/troff/troff.h:
+	* src/roff/troff/input.cpp (main):
+	* src/roff/troff/node.cpp (troff_output_file::put_char_width):
+	Rename `tcommand_flag` to `device_has_tcommand` to suggest a
+	logical predicate, and to emphasize the formatter's concern with
+	what the output device can accept in the intermediate output
+	language.
+	* src/roff/troff/input.cpp: Initialize `device_has_tcommand`
+	global using `bool` type and Boolean literal.
 
-2012-12-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_font.man: Typographical improvements and typos.
+	me: Clarify breadth of application of `ll` macro.
 
-2012-12-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* doc/meref.me: Document application of .ll macro only to the 3
+	environments that me(7) uses, not any the user might create.
+	* tmac/e.tmac (@C, xl, ll): Update comments.
 
-	* man/ditroff.man: Typographical improvements and typos.
+	Fixes <https://savannah.gnu.org/bugs/?55060>.
 
-2012-12-18  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_diff.man: Typographical improvements and typos.
+	Add regression test for Savannah #58736.
 
-2012-12-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	* tmac/tests/e_footnotes_work_with_columns.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* man/groff.man: Typographical improvements (and one typo).
-	* man/groff_char.man: Typographical improvements.
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-10-17  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/e.tmac (bc): Fix problem with multiple columns on long
+	pages.  Space to the next page location trap, not 24 inches.
+	Thanks to Dave Kemper and Bjarni Ingi Gislason for help tracking
+	this bug down.
 
-	* src/devices/gropdf/gropdf.pl (do_D): The command \D't N' moves
-	horizontal position by 'N'.  gropdf now obeys this rule.
-	(do_t): Fixed kerning issue where width of non-kerned text could
-	be wrongly calculated using previous kern factor.
+	Fixes <https://savannah.gnu.org/bugs/?55081>.
 
-2012-09-21  Werner LEMBERG  <wl@gnu.org>
+2021-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texinfo: Improve documentation of `.ad'.
+	Add regression test for Savannah #55081.
 
-2012-09-20  Werner LEMBERG  <wl@gnu.org>
+	* tmac/tests/e_columns-work-on-long-pages.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* doc/Makefile.sub (uninstall_sub): Fix removal of info files.
+2021-08-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-09-20  Werner LEMBERG  <wl@gnu.org>
+	* man/groff.7.man (Localization): Add section.
 
-	Simplify environment handling.
+2021-08-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Suggested by Ivan Shmakov <oneingray@gmail.com>.
+	* tmac/cs.tmac:
+	* tmac/de.tmac:
+	* tmac/fr.tmac:
+	* tmac/it.tmac:
+	* tmac/sv.tmac: Update ms package localization to use an
+	appropriate hyphenation mode for the `HY` register (the
+	mode for the pattern files, plus 2 as is traditional in ms).
 
-	* doc/Makefile.in, doc/Makefile.sub (GROFF): Don't use export.
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-09-20  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* tmac/e.tmac (1c): Place comment escape sequence immediately
+	after macro argument.  (When redefining a request, one needs to
+	remember that request arguments are not parsed exactly as macro
+	arguments are.)  Quiets "-w tab" warning.
 
-	gropdf Various minor fixes.
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/Foundry.in: Add font path to debian `gsfonts'
+	me: Fix misleading documentation claim; gremlin(1) pictures
+	cannot be included directly; they must be preprocessed with
+	grn(1).
+
+	* doc/meref.me:
+	* tmac/groff_me.7.man: Replace "gremlin" with "grn".
+
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_me.7.man: Document `n1` and `n2` macros.
+
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	me: Fix PS/n1 combination diagnostic spew and apparent logic
+	error.
+
+	* tmac/e.tmac (@h): Place comment escape sequence immediately
+	after macro argument.  (When redefining a request, one needs to
+	remember that request arguments are not parsed exactly as macro
+	arguments are.)
+	(n2): Prefix with `do` requests using long register names.
+	(n2): Add macro-local register `|l` to store length of first
+	argument.  Don't attempt to extract a substring beyond the
+	bounds of its source, which produces a warning diagnostic.
+	(&&): Define no-op macro for use as end macro in nested macro
+	definition.
+	(PS): Fix unbalanced-else diagnostic by changing `if` to `ie`.
+	(PS): Initialize `PS_nm_cnt` register to 0 instead of relying on
+	implicit definition.
+	(PS): Prefix with `do` definition of long macro name.
+	(PS): Indent call of end macro.
+	(PS): Add comment after escaped space.
+	(PS, PF): Prefix with `do` call of long macro name.
+
+	Fixes <https://savannah.gnu.org/bugs/?61019>.
+
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl (do_line): Recognize `n1` and `n2` as
+	characteristic me(7) macros.
+
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_me.7.man: Document GF, IE, IF, IS, and PF macros.
+
+2021-08-08  Dave Kemper <saint.snit@gmail.com>
+
+	* tmac/e.tmac: Rename `PE` to `PF` but remove vertical spacing.
+	(PE): New `PE` calls `PF` and then spaces as old `PE` did.
+
+	Fixes <https://savannah.gnu.org/bugs/?60479>.
+
+2021-08-06  Dave Kemper <saint.snit@gmail.com>
+
+	* doc/meref.me: Improve documentation of image-inclusion macros.
+
+	Fixes <https://savannah.gnu.org/bugs/?60478>.
+
+2021-08-06  Dave Kemper <saint.snit@gmail.com>
+
+	GNU pic recognizes two possible endings of a pic block: .PE or
+	.PF.  This fact was documented in doc/pic.ms but not in the pic
+	man page.  The minimal pic implementation provided by pic.tmac
+	also did not include a .PF definition.
+
+	* src/preproc/pic/main.cpp (main): Add dummy definition of `PF`
+	macro.
+	* tmac/pic.tmac (PF): Add macro that performs indentation only.
+	(PE): Call PF for indentation.
+
+	* doc/pic.ms (Interface to gtroff/How Scaling is Handled):
+	* src/preproc/pic/pic.1.man (Description, Options): Mention `PF`
+	in addition to `PS` and `PE`.
+
+	Fixes <https://savannah.gnu.org/bugs/?60504>.
+
+2021-08-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/refer-ms.tmac:
+	* tmac/s.tmac (fn@init, @PP): Rename strings
+	`fn@sup-{start,end}` to `fn@mark-{start,end}`.  This makes it
+	more clear that the strings are brackets for the footnote
+	marker, and not so much to do with the note text.  Further, in
+	nroff mode, they aren't superscripts at all, but bracket glyphs.
+
+2021-08-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.1.man (Examples): Add section.
+
+	Addresses part of <https://savannah.gnu.org/bugs/?57667>.
+
+2021-08-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/refer-ms.tmac: Use `fn@sup-{start,end}` instead of
+	`par@sup-{start,end}` when setting refer(1) citation labels.
+	This improves the appearance of the default labels on nroff
+	devices.  Continues commit caeede07, 1 May.
+
+2021-08-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tman/an-ext.tmac (EX, EE): Stop manipulating hyphenation.
+	It's redundant since disabling fill mode already prevents
+	automatic breaking, and therefore automatic hyphenation.
+	* tmac/groff_man.7.man.in (Description/Document structure
+	macros) <EX, EE>: Update documentation.
+
+2021-08-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl: Update authorship credits.  I appear
+	to have removed or refactored all of the "device" (recte: macro
+	package) inference logic adapted from Ralph Corderoy's grog.sh;
+	see commit 3617f42048f54cc3f0adc282ee3b9e481c75ebd5, 13 June
+	2014.
+
+2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl: Refactor through relocation and
+	renaming.  Move several global objects into subroutines.
+	  - `@request` -> `&do_line`
+	  - `@macro_ms`, `@macro_man`, `@macro_man_or_ms` ->
+	    `&infer_man_or_ms_package`
+	  - `@main_package` -> `&construct_command`
+	Rename some objects for clarity.
+	  - `%Groff` -> `%score`
+	  - `@filespec` -> `$input_file`
+	Delete unused object.
+	  - `@standard_macro`
+	Add comments.
+
+2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl (do_line): When matching macro/request
+	names, accept any non-whitespace character (Perl: \S) instead of
+	just a word-constituent character (Perl: \w), since roff
+	identifiers can contain unusual characters (refer(1) and
+	groff_me(7) illustrate some real-world cases).
+
+2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl: Refactor macro package inference.
+	  - Stop manually populating `Groff` hash.  (It's itching for a
+	    rename.)
+	  - Stop calling now-dead subroutine `infer_macro_packages`.
+	(do_line): Always store the names of all macros called to the
+	`Groff` hash, incrementing it.  Now it's a proper scoreboard.
+	Populate `inferred_main_package` from here upon encountering
+	characteristic (i.e., uniquely named) macros of each package.
+	Bug fix: drop "SP" from list of characteristic mom(7) macros;
+	it's shared with mm(7).
+	(infer_man_or_ms_package): Update comment.  Return 0 (false) if
+	document appears to be "raw", using no full-service macro
 	package.
+	(infer_macro_packages): Delete; do_line() does this work.
 
-	* font/devpdf/util/BuildFoundries.pl: Handle missing fonts in a
-	more sane way, do NOT abort the complete make run!
+2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf: Accept papersize names (i.e. A4) as
-	either upper or lower case.  The -p (papersize) option should be
-	length,width (currently reversed - width,length)
+	* src/utils/grog/grog.pl: Refactor preprocessor inference.
+	  - Add new list, `inferred_preprocessor`.
+	  - Drop preprocessor-related keys from `Groff` hash.
+	  - Drop scalar `inside_tbl_table`.
+	(do_line): Set up hash `preprocessor_for_macro`.  Detect
+	preprocessor macros the way the preprocessors do, explained in a
+	comment.  Respect AT&T compatibility mode when doing so.  Build
+	list of inferred preprocessors.  This replaces the extensive and
+	gaseous series of `if` statements that manipulated the `Groff`
+	hash.
+	(infer_preprocessors): Completely replace.  Set up a hash
+	`option_for_preprocessor` mapping preprocessor names to groff
+	options (where applicable).  Append to `command` and
+	`preprocessor` lists as appropriate.  Sort the preprocessor
+	options so they don't move around in the argument list depending
+	on the order of their macros' appearance in the input.
+
+	* src/utils/grog/tests/smoke-test.sh: Update test cases to
+	expect preprocessor options to show up in sorted order.
+
+2021-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl: Drop dead code.  Delete global
+	hash `preprocs_tmacs`, unused since commit b0de53c9, 30 June.
+
+2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Fix code nit.
+
+	* src/preproc/html/pre-html.cpp (get_image_generator):
+	Type-qualify `keyword_len` as `const` to encourage the compiler
+	to compute this value (the length of a string literal) at build
+	time.
+
+2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Slightly refactor.
+
+	* src/roff/troff/node.cpp: Add static `image_filename_len` to
+	store length of cached image file name, so we don't wastefully
+	recompute its length every time one is re-used.
+	(suppress_node::tprint): Compute image file name length only
+	when saving a new image file name.  Use saved length in later
+	expressions.
+	(min): Drop unused inline function.
+
+2021-07-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Fix regression (breaking important pdfmark/pdfroff
+	features) caused by my commit
+	e876d4bfd193abb9a7d1fb6e76519349bded482a, 27 July.  An empty
+	image file name is in fact semantically valid when writing a
+	bounding box; pdfmark uses such boxes to frame hyperlinks.
+	Avoid null pointer dereference by initializing `image_filename`
+	to an empty string literal.  Thanks to Tadziu Hoffman and Keith
+	Marshall for their patient explanations.
+
+2021-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Refactor some internal functions.
+
+	* src/roff/troff/node.cpp: Rename two functions that have only
+	one caller.
+	  - get_reg_int -> get_register
+	  - get_reg_str -> get_string
+	We now have:
+	(get_register, get_string): Use `assert()` aggressively because
+	these are deeply internal and validation is imperative.  Get rid
+	of diagnostic messages (one of which perpetuated the dubious
+	"number register" nomenclature) accordingly.
+	(fetch_register): Also rename `prev_value`, misleadingly
+	specific and seemingly copy-and-pasted out of a context where an
+	auto-increment or -decrement might have been applied.  It's just
+	the `value`.
+	(suppress_node::tprint): Update call site.
+
+2021-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Refactor `get_value` member functions.  Given their
+	names and popular "getter/setter" paradigms from many OO
+	languages, the return type is misleading.  Change it from `int`
+	to `bool` since it returns only a success/failure status and
+	modifies an argument (passed by reference) to deliver the
+	requested data.
+
+	* src/roff/troff/reg.h (reg, variable_reg):
+	* src/roff/troff/div.cpp (page_offset_reg, page_length_reg)
+	(vertical_position_reg, high_water_mark_reg)
+	(distance_to_next_trap_reg, page_number_reg, no_space_mode_reg):
+	* src/roff/troff/env.cpp (int_env_reg, vunits_env_reg)
+	(hunits_env_reg, horizontal_place_reg):
+	* src/roff/troff/input.cpp (writable_lineno_reg):
+	* src/roff/troff/reg.cpp (reg, number_reg, variable_reg): Update
+	class and member function definitions to reflect the new type.
+	Update member function definitions to return appropriate Boolean
+	literals instead of 0 and 1.
+
+2021-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Fix Savannah #60981.  Refactor device description
+	file handling and make it more robust.  Make pre-grohtml's
+	-F option work as documented and honor device description file
+	semantics documented in groff_font(5).
+
+	* src/preproc/html/pre-html.cpp: Store partial filespecs of HTML
+	and PostScript device files in constant strings.
+	(get_resolution): Initialize `res` to zero.  Only `free()` the
+	pointer `pathp` if `open_file()` succeeded (populating it).
+	Stop checking for valid `sscanf()` conversions of an integer to
+	store in `res`, and don't return early.  Instead process the
+	whole DESC file; per our Texinfo manual and groff_font(5),
+	"Later entries in the file ... override previous values."
+	(get_image_generator): Add new function, paralleling
+	`get_resolution()`, replacing open-coded logic in `main()`.
+	Only the body of the `while` loop significantly differs.
+	Instead of using `sscanf`, process the input character by
+	character matching the keyword and {1,} spaces or tabs
+	after it.  Whatever follows in `linebuf` must be the program
+	name.
+	(imageList::createPage): Add `assert()` to cause failure if an
+	empty image generator program gets this far, because it creates
+	repeated messes if it does.  (Something isn't checking exit
+	statuses.)
+	(main): Condense `image_gen` collection to a function call, a
+	null pointer check, and a fatal diagnostic.  Add a sanity check
+	and a fatal diagnostic if the PostScript resolution is garbage.
+	{It's initialized to -1 and `get_resolution()` will return 0 if
+	it doesn't find one.}
+
+	Fixes <https://savannah.gnu.org/bugs/?60981>.
+
+2021-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Delete or rename `debug` symbols to avoid clash with
+	new `debug` function in libgroff.
+
+	* src/preproc/html/pre-html.cpp: Update a comment to refer to
+	"debugging" mode.  Rename static global from `debug` to
+	`debugging`.
+	(html_system, imageList::createPage, imageList::createImage,
+	print_args, char_buffer::do_html, char_buffer::do_image,
+	scanArguments): Update uses of static global.
+
+	* src/preproc/html/pushback.cpp:
+	* src/preproc/html/pushback.h: Delete unused `debug` member
+	variable.
+
+2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh: Fix straggling use of `$1`, which
+	might not have a clear meaning in some shells after being
+	shifted (what if we just shifted the last argument?).  Also
+	`continue` after processing a (groff) option argument, as we
+	should make no attempt to parse it.
+
+2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_suppress): Recast diagnostic
+	messages for clarity, to communicate in terms of what the
+	escape sequence _is_, and to quote literals expected as input.
+	* src/roff/troff/node.cpp (suppress_node::tprint): Recast
+	diagnostic to prevent misinterpretation of image "description"
+	as being HTML IMG tag alt text or something like that.
+	Unfortunately, the new language speaks in terms of internal
+	implementation details ("grohtml-info"), but at least that way
+	it's easier for a user to decide if they care about it.
+
+2021-07-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Avoid using sprintf() with user-controlled format
+	string.
+
+	* src/preproc/html/pre-html.cpp (makeFileName): Add comment
+	noting need for implementation synchrony between this function,
+	which generates \O5 escape sequences, and troff's
+	suppress_node::tprint member function, which interprets them.
+	* src/roff/troff/node.cpp: Rename 2 static globals for clarity.
+	  - `last_image_filename` -> `image_filename`
+	  - `last_image_id` -> `subimage_counter`
+	(suppress_node::tprint): Set up the buffer for image file name
+	to be written using a constant rather than an embedded literal.
+	Unconditionally initialize the buffer with a string terminator,
+	so there is no chance of a read from uninitialized storage.
+	Drop unused code involving `tem`.  Drop stale comments.  Clarify
+	comment: an `image_filename` doesn't _always_ contain a format
+	string, only sometimes.  Replace use of `sprintf` with manual
+	construction of a new image filename string.  There are two
+	cases, one where a format string {presently "%d"} is present,
+	and one where it is not.  If it is present, locate it
+	{`percent`}.  This means a limited/bounded image ("subimage") is
+	being processed; increment the subimage counter.  Write a new
+	image file name preserving the parts before and after "%d" (the
+	"prefix" and "suffix", and replacing only the middle, using
+	`sprintf` with the subimage counter and the (string literal)
+	format.  Be mindful of string bounds and memory allocation,
+	issuing diagnostics or aborting as necessary.  If the image file
+	name does _not_ contain a format string, but needs only to be
+	copied, do that (`strcpy`), again instead of using `sprintf`.
+
+	Fixes <https://savannah.gnu.org/bugs/?60977>.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Fix Savannah #60971.
+
+	* src/preproc/html/pre-html.cpp (makeFileName): Consistently put
+	a dash at the end of `macroset_template` whether the image file
+	name stem is user-supplied or the default.  Stop adding the dash
+	before the image number in `image_template` instead.  This makes
+	the image file name format reliable whether the image needs to
+	be subdivided (eqn) or not (tbl).
+
+	Fixes <https://savannah.gnu.org/bugs/?60971>.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Reduce noise to standard error stream.
+
+	* src/preproc/html/pre-html.cpp (imageList::createImage): Fix
+	apparent oversight: `EXE_EXT` was not being applied to the
+	second of three commands being run in a pipeline (did Windows
+	users notice?).  Also issue (undocumented!) `-quiet` option to
+	`pnmtopng` to shut up its commentary about counting colors.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Stop discarding standard error output.
+
+	* src/preproc/html/pre-html.cpp (html_system): Stop sending the
+	standard error stream to /dev/null; this just makes debugging
+	harder, and doesn't produce much more output for well-formed
+	input documents.  Rename `save_stdout` to `saved_stdout`.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Fix misspelled variable.
+
+	* src/preproc/html/pre-html.cpp: Rename `IMAGE_BOARDER_PIXELS`
+	to `IMAGE_BORDER_PIXELS`.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	libgroff, troff: Add debug diagnostic level.
+
+	* src/include/error.h: Declare functions
+	`debug_with_file_and_line` and `debug`.
+	* src/libs/libgroff/error.cpp: Add `DEBUG` to enum `error_type`.
+	(do_error_with_file_and_line): Add case for `DEBUG` in switch.
+	(debug, debug_with_file_and_line): Add new functions.
+
+	Do the same for troff since it has a private implementation of
+	the diagnostic functions (thanks to `output_warning()`).
+
+	* src/roff/troff/input.cpp: Add `DEBUG` to enum `error_type`.
+	(do_error_with_file_and_line): Add case for `DEBUG` in switch.
+	(debug, debug_with_file_and_line): Add new functions.
+
+2021-07-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/hpftodit/hpftodit.cpp (hp_msl_to_ucode_name)
+	(unicode_to_ucode_name): Hush "format nonliteral" compiler
+	warnings by using a preprocessor-defined string literal as an
+	sprintf() format string instead of a C++ variable that just
+	compared identically to the same thing.
+
+2021-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/hpftodit/hpftodit.cpp (show_symset): Prevent
+	sprintf() from overunning a static buffer.  Thanks to Bjarni
+	Ingi Gislason for the report.  Resize buffer to be large enough
+	to accommodate a 64-bit unsigned int type formatted as decimal.
+	Also add assert() before the sprintf() to abort if the int type
+	is even larger than that.  Use "%u" conversion instead of "%d"
+	since the quantity is unsigned.
+	(hp_msl_to_ucode_name): Similar, but for a signed int.
+	(unicode_to_ucode_name): Similar, but for a signed int formatted
+	as (unsigned) hexadecimal.
+
+	Fixes <https://savannah.gnu.org/bugs/?60964>.
+
+2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh: Refactor, mostly by relocation.  Move
+	locale character set inference logic so that we only run it if
+	we have to (`-T` option was invalid or not given and
+	`GROFF_TYPESETTER` was not set in the environment or invalid).
+	Initialize `T` variable as empty.
+
+2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh: Use Version 7 Unix sh-compatible form
+	of parameter expansion; per the GNU Autoconf manual1, "old
+	BSD shells, including the Ultrix sh, don't accept the colon for
+	any shell substitution, and complain and die."  This is also the
+	form of such substitutions used elsewhere in the script, so they
+	should be mutually consistent.
+
+	1 https://www.gnu.org/software/autoconf/manual/autoconf-2.60/\
+	html_node/Shell-Substitutions.html
+
+2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh: Slightly refactor.  Rename formerly
+	unused loop index variable from `i` to `arg` to leverage it in a
+	later diagnostic message without a separate definition.  Inside
+	the loop, expand `arg` instead of positional parameter 1, the
+	meaning of which is less obvious after the parameter list is
+	shifted by the new `is_option_argument_pending` logic (commit
+	2b955c57, 20 July).
+
+2021-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.1.man (Options) <-S>: Fix error: `-S`
+	sets safer mode (redundantly) but is not passed to pic and troff
+	as was claimed.
+
+2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/number.cpp (parse_term): Tweak diagnostic
+	messages.  When a left operand to a binary operator is empty,
+	report the operator in question (helpful for string
+	interpolations in complex expressions).  When handling input
+	scaling indicators, drop word "this" from "this context", since
+	the parser's context might not be clear from a file name and
+	line number.  Say "scaling indicator" instead of "scale
+	indicator".
+	(parse_expr, parse_term): Rename function parameter from
+	`scale_indicator` to `scaling_indicator`.
+
+2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (define_color): Tweak warning
+	diagnostics for clarity.  Only one value is expected when
+	defining a color in the `gray` color space.  Quote recognized
+	color space names when complaining of an unknown one.
+
+2021-07-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	nroff: Pass a supplied `-c` option to groff.  While at present
+	this does little more than `-P-c` already achieves, that might
+	not be true forever.  Further, there is a distinction between
+	ignoring color-related requests in groff input documents and
+	ignoring color-related commands in device-independent output.
+	This distinction would make it unwise to adapt `-c` to any other
+	purpose in nroff in the future.
+
+	* NEWS: Update item from commit dd725dce, 10 February 2020.
+	* src/roff/nroff/nroff.sh: Pass `-c` option to groff in addition
+	to synthesizing a `-P-c` option (for grotty) when it is seen.
+	* src/roff/nroff/nroff.1.man (Options): Document `-c` as an
+	option recognized by troff(1).
+
+2021-07-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	nroff: Support space between option flags and their arguments.
+
+	* src/roff/nroff/nroff.sh: Add new `is_option_argument_pending`
+	flag to add an additional state to the option parser.  Set it if
+	an argument-requiring option is encountered with no abutting
+	argument.  If it is set when a new argument is encountered,
+	absorb the argument into the groff option list and clear the
+	flag.  Modernize script in a couple of other ways.
+	  - Exit with status 2 upon usage errors so that this condition
+	    is easily distinguished from a groff abort (which exits with
+	    status 1).
+	  - Test shell variables for non-nullity with test(1) -n
+	    operator instead of a string comparison.
+	* src/roff/nroff/tests/verbose_option_works.sh: Test correct
+	construction of groff command using this input form.
+	* src/roff/nroff/nroff.1.man (Options): Add spaces between
+	option flags and option arguments.  Sync metasyntactic variable
+	names with groff(1) while we're at it.
+	(Description): Drop sentence warning of whitespace prohibition.
+	(Exit status): Add new section.
+
+	Fixes <https://savannah.gnu.org/bugs/?60943>.
+
+2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (main): Emit error diagnostic if `-d`
+	or `-r` option is given a malformed argument.  This prevents a
+	string or register with an empty name from being created.
+
+	Fixes <https://savannah.gnu.org/bugs/?60935>.
+
+2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh:
+	* src/roff/troff/input.cpp (usage): Use "dev" as metasyntactic
+	variable name for -T option argument to achieve consistency with
+	our other documentation.
+
+2021-07-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff: Comment out vestiges of gideal support.  It would be
+	lovely to have, but no free (and GPL-compatible) implementation
+	has showed up after decades of waiting.  Production of the
+	original was a Ph.D. thesis.  Excited by de Moivre's theorem?
+	Take a stab at it.
+
+	* src/roff/groff/groff.cpp (main): Comment out effect of `-J`
+	option.  It remains recognized, but silently ignored (instead of
+	attempting to execute a nonexistent preprocessor).
+	(synopsis): Add comment reminding us to document the option if
+	we ever get the support.
+	(help): Comment out documentation of option.
+
+2021-07-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gntroff: Make usage messages more accurate.
+
+	* src/roff/groff/groff.cpp (synopsis): Drop `-h` and `-v` from
+	normal operation synopsis.  Sort options in en_US lexicographic
+	order.  Tighten presentation of alternate usage forms.
+	(help): Document longer forms of `-d` and `-r`.
+	* src/roff/nroff/nroff.sh: Report `$prog` instead of "nroff"
+	literal.  Refer to `-P` option argument as "arg" instead of
+	"opt", for consistency with groff usage message.  Use opposite
+	case from option letter for option argument.
+	* src/roff/troff/input.cpp (usage): Put brackets around options.
+	Sort options in en_US lexicographic order.  Drop `-v` from
+	normal operation synopsis.  Use opposite case from option letter
+	for option argument.  Put operand name in capitals.  Set valid
+	usage forms on one physical line each (see 89648fb4, 5 June).
+	Add synopsis line for alternate usage forms.
+
+2021-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Refactor environment initialization, switching, and
+	copying.
+
+	* src/roff/troff/env.cpp: Rename struct `env_list` to
+	`env_list_node` since it describes a node of a singly-linked
+	list.  Remove constant `NENVIRONMENTS` and array `env_table`.
+	Add static symbol `default_environment_name` to replace string
+	literal.
+	(init_environments): Stop initializing `curenv` through
+	`env_table`.  Use `default_environment_name` for that
+	initialization and add the default environment to
+	`env_dictionary`.
+	(environment_switch): Simplify.  Shorten "dummy environment"
+	diagnostic message.  Stop creating an integer-named
+	environment inside the `env_table` array, only falling through
+	to use the `env_dictionary` if the named environment is not a
+	valid integer or if the array is full.  Instead use
+	`env_dictionary` always.  Drop no longer needed `pop`
+	quasi-Boolean integer with extra state to suppress environment
+	stack underflow errors.  Instead report the error if underflow
+	occurs, regardless of any other circumstance.
+	(environment_copy): Simplify.  Stop searching the `env_table`
+	array for an environment to copy from, only falling through to
+	use the `env_dictionary` if the named environment is not a valid
+	integer or if the array is full.  Instead search
+	`env_dictionary` always.  Emit "no environment specified to copy
+	from" diagnostic only if the `evc` request is given no argument.
+	If the source environment to copy from is given but not found,
+	emit a new diagnostic naming the nonexistent environment.  Fix
+	bug: stop returning early if no copying could be done; instead
+	fall through to the end of the function, which calls
+	`skip_line()` and prevents anything on the remainder of the
+	{invalid} control line from being interpreted.  Problem dates
+	back to commit da3b7137, 6 March 2000 (groff 1.16).
+
+	Fixes <https://savannah.gnu.org/bugs/?60913>.
+
+2021-07-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/evc_produces_no_output_if_invalid.sh:
+	  Regression-test Savannah #60913.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-07-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Update English hyphenation patterns.
+
+	* NEWS: Add item.
+	* tmac/hyphen.en: Update file using `hyph-en-us.tex` patterns
+	file from the TeX hyph-utf8 project.
+	* tmac/hyphenex.en: Remove explicit hyphenations for words that
+	no longer require them when using the new patterns.  Add one
+	item scraped from an erratum comment in hyphen.en
+	{"dem-o-crat"}.
+
+	The new patterns likely _will_ change the automatic hyphenation
+	break points of your English documents.  Here is a sample of
+	affected words found within groff's own documentary corpus.
+
+	OLD			NEW
+	===			===
+	ar‐range‐ment		arrange‐ment
+	col‐umns		columns
+	con‐struc‐ted		con‐structed
+	cus‐tom‐ized		cus‐tomized
+	def‐i‐ni‐tions		de‐f‐i‐n‐i‐tions
+	der‐i‐va‐tions		de‐riva‐tions
+	hy‐phen‐a‐tion		hy‐phen‐ation
+	ma‐te‐rial		ma‐te‐r‐ial
+	Mi‐cro‐soft		Mi‐crosoft
+	pipe‐lines		pipelines
+	post‐pro‐ces‐sors	post‐proces‐sors
+	pro‐cessed		processed
+	pro‐cesses		processes
+	spa‐ces			spaces
+	Wer‐ner			Werner
+
+2021-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Add unit test for `substring` request.
+
+	* src/roff/groff/tests/substring_works.sh: Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-07-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Remove compatibility mode save registers after using
+	them.
+
+	* tmac/an.tmac:
+	* tmac/andoc.tmac:
+	* tmac/cp1047.tmac:
+	* tmac/devtag.tmac:
+	* tmac/ec.tmac:
+	* tmac/fallbacks.tmac:
+	* tmac/latin1.tmac:
+	* tmac/latin2.tmac:
+	* tmac/latin5.tmac:
+	* tmac/latin9.tmac:
+	* tmac/papersize.tmac:
+	* tmac/pdfpic.tmac:
+	* tmac/psold.tmac:
+	* tmac/pspic.tmac:
+	* tmac/trace.tmac:
+	* tmac/unicode.tmac: Do it.
+
+	* doc/groff.texi (Implementation Differences):
+	* man/groff_diff.7.man (Implementation Differences): Illustrate
+	doing so in relevant examples.
+
+2021-07-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/troffrc: Load the English localization file `en.tmac` by
+	default, instead of dealing with hyphenation language and
+	patterns directly in this file.  (This also replaces a
+	localization-determination mechanism that was never part of a
+	groff release.)
+
+	* src/roff/groff/tests/initialization_is_quiet.sh:
+	* src/roff/groff/tests/localization_works.sh: Rewrite to use
+	explicit macro file loading localization mechanism.
+
+2021-07-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Move core man(7) implementation to an.tmac.
+
+	* tmac/an.tmac: Delete andoc-sourcing wrapper.
+
+	* tmac/an-old.tmac: Rename...
+	* tmac/an.tmac: ...to this.
+
+	* tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
+	* tmac/tests/an-old_CS-register-off.sh:
+	* tmac/tests/an-old_CS-register-on.sh:
+	* tmac/tests/an-old_CS-register-unspecified.sh:
+	* tmac/tests/an-old_CT-register-off.sh:
+	* tmac/tests/an-old_CT-register-on.sh:
+	* tmac/tests/an-old_CT-register-unspecified.sh:
+	* tmac/tests/an-old_FT-bad-value-should-not-trash-titles.sh:
+	* tmac/tests/an-old_LL-init-sanely.sh:
+	* tmac/tests/an-old_TH-repairs-ad-damage.sh:
+	* tmac/tests/an-old_TH-repairs-hy-damage.sh:
+	* tmac/tests/an-old_TS-do-not-keep-tables-when-cR-set.sh:
+	* tmac/tests/an-old_X-register-works.sh:
+	* tmac/tests/an-old_avoid-two-font-denial-of-service.sh:
+	* tmac/tests/an-old_no-break-after-short-paragraph-tags.sh:
+	* tmac/tests/an-old_page-footers-present.sh:
+	* tmac/tests/an-old_page-header-has-current-data.sh:
+	* tmac/tests/an-old_title-abbreviation-works.sh: Rename...
+
+	* tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh:
+	* tmac/tests/an_CS-register-off.sh:
+	* tmac/tests/an_CS-register-on.sh:
+	* tmac/tests/an_CS-register-unspecified.sh:
+	* tmac/tests/an_CT-register-off.sh:
+	* tmac/tests/an_CT-register-on.sh:
+	* tmac/tests/an_CT-register-unspecified.sh:
+	* tmac/tests/an_FT-bad-value-should-not-trash-titles.sh:
+	* tmac/tests/an_LL-init-sanely.sh:
+	* tmac/tests/an_TH-repairs-ad-damage.sh:
+	* tmac/tests/an_TH-repairs-hy-damage.sh:
+	* tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh:
+	* tmac/tests/an_X-register-works.sh:
+	* tmac/tests/an_avoid-two-font-denial-of-service.sh:
+	* tmac/tests/an_no-break-after-short-paragraph-tags.sh:
+	* tmac/tests/an_page-footers-present.sh:
+	* tmac/tests/an_page-header-has-current-data.sh:
+	* tmac/tests/an_title-abbreviation-works.sh: ...to these.
+
+	* tmac/tmac.am (TMACNORMALFILES): Remove an-old.tmac.
+	(tmac_TESTS): Reflect renames of test files above.
+	(tmac/stamp-wrap): Macro-source `an.tmac` in the man wrapper.
+
+	* tmac/andoc.tmac: Refer to (and macro-source) an.tmac.
+	* tmac/man.tmac: Macro-source `an.tmac`, not `andoc.tmac`.
+	* tmac/tests/andoc_flush-between-packages.sh: Call groff with
+	`-mandoc` option instead of `-man`.  Henceforth, if you want the
+	andoc wrapper, you have to ask for it.
+
+	* tmac/an.tmac: Drop "-old" nomenclature.
+
+	* PROBLEMS:
+	* doc/groff.texi (man):
+	* tmac/man.local: Update documentation appropriately.
+
+	* NEWS: Add item.
+
+	* man/groff_tmac.5.man (Macro packages/man pages):
+	* src/roff/groff/groff.1.man (Usage/Macro packages): Update
+	discussion of an, doc, and andoc.
+	* tmac/groff_man.7.man.in (Files): Update descriptions of
+	an.tmac, andoc.tmac, man.tmac, and mandoc.tmac.
+
+	Fixes <https://savannah.gnu.org/bugs/?60789>.
+
+2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	troff: Slightly refactor.  Make the source code slightly more
+	accessible by using a `bool` type for a function's default
+	parameter used as a Boolean, and comment it at call sites where
+	the default is overridden.
+
+	* src/roff/troff/token.h (get_name, get_long_name): Change type
+	of parameter from `int` to `bool` and default from 0 to `false`.
+	* src/roff/troff/input.cpp (do_get_long_name)
+	(empty_name_warning, get_name, get_long_name): Change type of
+	parameter from `int` to `bool` in declarations and definitions.
+	* src/roff/troff/column.cpp (column_justify):
+	* src/roff/troff/div.cpp (diversion_trap):
+	* src/roff/troff/env.cpp (environment_switch, environment_copy)
+	(do_input_trap, set_hyphenation_language)
+	(do_hyphenation_patterns_file):
+	* src/roff/troff/input.cpp (define_color, composite_request)
+	(do_define_string, do_define_macro, rename_macro, alias_macro)
+	(chop_macro, do_string_case_transform, substring_request)
+	(length_request, asciify_macro, unformat_macro, do_register)
+	(device_macro_request, do_if_request, do_source)
+	(ps_bbox_request, do_open, close_request, do_write_request)
+	(write_macro_request, define_class, copy_file, vjustify)
+	(transparent_file, do_macro_source):
+	* src/roff/troff/node.cpp (font_translate, font_position, style)
+	(get_fontno):
+	* src/roff/troff/reg.cpp (define_number_reg, inline_define_reg)
+	(alter_format, alias_reg, rename_reg): Update call sites.  Add
+	(comment indicating meaning of parameter.
+
+	Do similarly for token::delimiter() member function.
+
+	* src/roff/troff/token.h (token::delimiter): Change type of
+	parameter from `int` to `bool`, name from `warn` to `err` (to
+	match definition and behavior in input.cpp) and default from 0
+	to `false`.
+	* src/roff/troff/input.cpp (token::delimiter): Change type of
+	parameter from `int` to `bool` in definition.
+	* src/roff/troff/input.cpp (do_expr_test, get_delim_number)
+	(get_line_arg, read_size, do_register, read_draw_node):
+	* src/roff/troff/reg.cpp (inline_define_reg): Update call sites.
+	Add comment indicating meaning of parameter.
+
+2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-footer): Remove string
+	`an-outer-footer-text` after we're done with it.
+
+2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Remove the stripper script and its vestiges.
+
+	* contrib/hdtbl/hdmisc.tmac:
+	* contrib/hdtbl/hdtbl.tmac:
+	* contrib/mom/om.tmac:
+	* tmac/doc.tmac:
+	* tmac/e.tmac:
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff:
+	* tmac/mdoc/doc-syms: Remove `%beginstrip` comment.
+
+	* tmac/strip.sed: Delete.
+
+	* tmac/tmac.am (EXTRA_DIST): Stop shipping `strip.sed`.
+
+	Fixes <https://savannah.gnu.org/bugs/?55091>.
+
+2021-07-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Skip the stripper, part 3/3 (mdoc).
+
+	* tmac/doc-old.tmac-u:
+	* tmac/doc.tmac-u:
+	* tmac/mdoc/doc-common-u:
+	* tmac/mdoc/doc-ditroff-u:
+	* tmac/mdoc/doc-nroff-u:
+	* tmac/mdoc/doc-syms-u: Rename these...
+
+	* tmac/doc-old.tmac:
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff:
+	* tmac/mdoc/doc-syms: ...to these.
+
+	* tmac/tmac.am (TMACNORMALFILES): Add `doc-old.tmac` and
+	`doc.tmac`.
+	(TMACUNSTRIPFILES, TMACSTRIPFILES): Delete variables.
+	(dist_tmac_DATA): Drop `$(TMACUNSTRIPFILES)`.
+	(nodist_tmac_DATA): Drop `$(TMACSTRIPFILES)`.
+	(TMACMDOCSTRIPFILES): Rename...
+	(TMACMDOCFILES): ...to this.
+	(nodist_mdoc_DATA, MOSTLYCLEANFILES): Reflect above rename.
+	(nodist_mdoc_DATA): Rename...
+	(dist_mdoc_DATA): ...to this.
+	(TMACMDOCUNSTRIPFILES): Delete variable.
+	(EXTRA_DIST): Drop `$(TMACMDOCUNSTRIPFILES)`.
+	($(TMACSTRIPFILES), $(TMACMDOCSTRIPFILES)): Drop targets.
+
+	The portions above are based on a patch by Ingo Schwarze.
+
+	* tmac/doc.tmac:
+	* tmac/mdoc/doc-common:
+	* tmac/mdoc/doc-ditroff:
+	* tmac/mdoc/doc-nroff:
+	* tmac/mdoc/doc-syms: Bracket macro definitions tightly with
+	`eo` and `ec` requests since they were written under this
+	assumption.  The files in general were also drafted under the
+	assumption that they'd be stripped, so `eo` was in effect for
+	broad swaths of the file including portions outside of any macro
+	definition where comments were used.  But comments are expressed
+	using the escape character!  So we got warnings about an
+	undefined '\"' macro, and that was just the beginning of a
+	wrecking ball of trouble that smashed through the
+	implementation.  Some--but not all--string definitions (and
+	appendments) needed to be bracketed with `eo` and `ec` as well,
+	to delay interpolation of embedded string names that are not
+	defined until macros interpolate them later.  I did what
+	appeared necessary to pass our tests and keep -Tutf8 and -Tps
+	renderings of tmac/groff_mdoc.7 from changing from their
+	strip-influenced output.  Subtle bugs might linger, but some
+	won't be the fault of the unstripping process.  (For instance,
+	try provoking a usage message on the `Hf` macro.)
+
+2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Remove compatibility save register.
+
+	* **/*.man*: Remove page-local compatibility save register after
+	using it.
+
+2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Simplify `mso` requests.
+
+	* tmac/X.tmac:
+	* tmac/Xps.tmac:
+	* tmac/dvi.tmac:
+	* tmac/html.tmac:
+	* tmac/lbp.tmac:
+	* tmac/lj4.tmac:
+	* tmac/ps.tmac:
+	* tmac/tty-char.tmac:
+	* tmac/tty.tmac:
+	* tmac/www.tmac.in: Move `mso` requests to be inside regions
+	where compatibility mode is turned off.  I believe they were
+	placed where they were because things didn't work when the
+	compatibility mode register being saved was .C, rather than the
+	.cp register introduced in commit 6a37bb5f, 17 April 2020.  Now
+	the logic is less mysterious.  Also, remove the register used to
+	save compatibility mode after we're done with it, to reduce name
+	space clutter.
+
+2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/it.tmac: Drop sourcing of `latin1.tmac` and set up of
+	hyphenation codes; since the `hyphen.it` file is pure ASCII, we
+	don't need to expect Latin-1-encoded code points in it.
+
+2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Make localization files work in compatibility mode.
+
+	* tmac/cs.tmac:
+	* tmac/de.tmac:
+	* tmac/en.tmac:
+	* tmac/fr.tmac:
+	* tmac/it.tmac:
+	* tmac/ja.tmac:
+	* tmac/sv.tmac:
+	* tmac/zh.tmac: Save and restore compatibility mode.
+
+	* tmac/den.tmac: Invoke requests with `do`.
+
+	Fixes <https://savannah.gnu.org/bugs/?60874>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2021-07-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #60874.
 
-	* src/devices/gropdf/pdfmom.pl: Support use of GROFF_BIN_PATH.
+	* src/roff/groff/tests/initialization_is_quiet.sh: Test it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
 
-2012-09-11  Ralph Corderoy  <ralph@inputplus.co.uk>
-	    Werner LEMBERG <wl@gnu.org>
+2021-07-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/tbl/tbl.man: Better document `d' column specifier.
+	Integrate Italian localization.
 
-2012-08-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+	* NEWS: Add item.  Update an existing list of localization macro
+	files.
+	* doc/groff.texi (Manipulating Hyphenation):  Update table of
+	hyphenation pattern left and right minimums and list of
+	available localization files to include Italian.
+	* man/groff_tmac.5.man: Update list of available localization
+	files to include Italian.
+	* src/roff/groff/tests/localization_works.sh: Test it.
+	* tmac/tmac.am (TMACNORMALFILES): Add `it.tmac` and `hyphen.it`.
+
+	Fixes <https://savannah.gnu.org/bugs/?60828>.
+
+2021-07-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Flesh out Italian localization.
+
+	* tmac/hyphen.it: Add hyphenation patterns from TeX hyph-utf8
+	project.
+	* tmac/it.tmac:
+	  - Revise copyright date to just this year (it had been copied
+	    from fr.tmac).
+	  - Use grave accents instead of acute ones to indicate stress
+	    on word-final vowels.  Per the University of Wikipedia and a
+	    sampling of apparently well-typeset Italian language
+	    documents online, this appears to be correct.  Yell at me if
+	    I'm wrong.
+	  - Source latin1.tmac instead of latin9.tmac; Italian doesn't
+	    require any letter code points from Latin-9, unlike the
+	    French file upon which this one was based, and Latin-1 is
+	    less of a pain to work with.
+	  - Set the hyphenation mode to 1 instead of 4 for congruence
+	    with the requirements of the hyphenation patterns.
+	  - Set up hyphenation codes.  This (and sourcing latin1.tmac)
+	    might not be necessary as the hyphenation pattern file, of a
+	    more recent vintage than the others we're using, is pure
+	    ASCII.  However I don't understand these issues perfectly so
+	    I am making the conservative choice.  Again per the
+	    University of Wikipedia, Italian requires only acute and
+	    grave accents, in contrast to the rich French diacritical
+	    bouillabaisse.
+	  - Set the hyphenation language and load the pattern file.
+	  - Add comments in parallel with other localization files and
+	    to supply text editors with hints.
+
+2021-07-02  Edmond Orignac <edmond.orignac@wanadoo.fr>
+
+	* tmac/it.tmac: Add Italian localization.
+
+2021-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Skip the stripper, part 1/3 ("me").
+
+	* tmac/e.tmac-u: Rename to...
+	* tmac/e.tmac: ...this.
+
+	* tmac/tmac.am (TMACNORMALFILES): Add tmac/e.tmac.
+	(TMACUNSTRIPFILES): Remove tmac/e.tmac-u.
+	(TMACSTRIPFILES): Remove tmac/e.tmac.
+
+	Fixes one third of <https://savannah.gnu.org/bugs/?55091>.
+
+2021-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl: Simplify parsing.  Dave Kemper pointed
+	out that preprocessors like pic(1) use pretty unsophisticated
+	*roff parsing to determine where to perform their textual
+	replacements.  My enhancements to support input line
+	continuation and cope with brace escapes were thus
+	overengineered.  Remove them.
+	  - Drop scalars `is_continued_line` and `logical_line`.
+	  (do_line): Stop performing logical line concatenation and
+	  detecting input line continuation.  Perform operations on
+	  `line` instead of `logical_line`.  Stop removing brace
+	  escapes.
+	* src/utils/grog/grog.1.man (Limitations): Update discussion.
+
+	Fixes <https://savannah.gnu.org/bugs/?60862>.  Thanks, Dave!
+
+2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/reg.cpp (lookup_number_reg, alias_reg): In
+	diagnostic messages, say simply "register" instead of "number
+	register" (there is no other kind).
+
+2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Refactor input parsing.
+
+	* src/utils/grog/grog.pl:
+	  - Add scalar `use_compatibility_mode` (see below).
+	  - Add list `request` to store the names of all requests
+	    recognized by groff so that they aren't confused with macro
+	    names.
+	  - Add scalars `have_seen_first_macro_call` (replaces
+	    `before_first_command`, but at global scope),
+	    `is_continued_line` and `logical_line`.  The latter two
+	    enable us to handle *roff input line continuation correctly.
+	  (process_arguments): Set `use_compatibility_mode` if `-C`
+	  option specified.
+	  (process_input): Refactor to greatly simplify, to not attempt
+	  to read the first line of an input file as a special case, and
+	  to avoid sending `do_line` an undefined argument (when EOF is
+	  reached).
+	  (do_first_line): Delete.
+	  (do_line): Rewrite the early stages of input parsing.
+	  - Concatenate continued input lines, setting
+	    `is_continued_line` and returning early as each one is seen,
+	    storing the accumulating input in `logical_line`.
+	  - Check the input line for the form of comment deposited by
+	    Perl's Pod::Man, which uses a highly accented dialect of
+	    man(7); if it's present, inflate `man_score` to compensate
+	    for the page-private `IX` macro it defines but which
+	    duplicates the name and function of a 4.2BSD-era ms(7)
+	    extension that would otherwise deceive our scoring
+	    mechanism, because Pod::Man produces `IX` calls to
+	    metastatic excess.  (An alternative to this kludge is
+	    documented in comments: if a "standard" macro is redefined,
+	    we could delete it from the relevant lists and hashes.)
+	  - Strip *roff comments from input.
+	  - Normalize control lines; convert the no-break control
+	    character to the regular one and remove unnecessary
+	    white space.
+	  - Remove brace escapes.
+	  - Recognize two-character macro calls when not followed by
+	    white space in compatibility mode.
+	  - Drop logic that erroneously attempted to infer soelim(1) use
+	    from macro calls and request invocations.  The grog(1) and
+	    soelim(1) man pages now both explain why such an effort was
+	    misguided.
+	  - Recognize macro definitions created by .am and .am1 requests
+	    {not just .de and .de1}.
+	  - Ignore all other *roff requests.
+	  - What remains must be a ("standard") macro call, so set
+	    `have_seen_first_macro_call`.
+
+	* src/utils/grog/grog.1.man (Limitations): Document a further
+	restriction: don't change the escape character, either.
+
+	* src/utils/grog/tests/smoke-test.sh: Comment out pic-detection
+	test on soelim(1).  The pic macro calls are guarded by roff
+	control structures and only worked previously by accident
+	because grog did not recognize *roff input line continuation,
+	now it does and the illusion is dispelled.  (A reliable way to
+	fool grog before and after my refactoring is now documented in
+	its man page.)
+
+	Fixes <https://savannah.gnu.org/bugs/?59622>.
+
+2021-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #59622.
+
+	* src/utils/grog/tests/recognize-perl-pod.sh: Test it.
+	* src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.1.man (Limitations): Document further
+	restrictions (no changing of control characters, control
+	structures not interpreted).
+
+2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Refactor command-line argument handling.
+
+	* src/utils/grog/grog.pl:
+	  - Drop scalars `groff_opts`, `device`, and `with_warnings`.
+	  - Move scalar `pdf_with_ligatures`...
+	  (process_arguments): ...here.  Recognize all groff options
+	  that take an optionally whitespace-separated option argument
+	  and apply the existing "delayed option" handling to them.
+	  Push any groff option except `-m` as-is onto the constructed
+	  groff command's argument list (`-m` handling is unchanged).
+	  Match long option names exactly, not sloppily.  Stop
+	  recognizing `--warnings` option.  Emit error diagnostic if
+	  unrecognized long option encountered.
+	  (infer_device): Delete subroutine and its top-level call site.
+	  (help): Undocument `--warnings`.
+
+	* src/utils/grog/grog.1.man:
+	  (Synopsis): Use font style macros instead of .OP.  Undocument
+	  `--warnings`.
+	  (Options): Note that the groff arguments produced by the grog
+	  `--ligatures` option are supported only by the `pdf` device.
+	  Undocument `--warnings`.  Undocument groff-incompatible
+	  restriction on whitespace before option arguments; grog is
+	  compatible now.  Simplify discussion in light of simplified
+	  grog logic.
+	  (Details): Undocument scenario where grog infers multiple
+	  main/major/full-service macro packages; this no longer
+	  happens.
+	  (Examples): Update to no longer illustrate inclusion of `-T
+	  ps` option; this no longer happens by default.
+
+	* NEWS: Document removal of grog's `--warnings` option.
+
+	Fixes <https://savannah.gnu.org/bugs/?57873>; groff options are
+	no longer "mangled".
+
+2021-06-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #57873.
+
+	* src/utils/grog/tests/preserve-groff-options.sh: Test it.
+	* src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Refactor device (`-T` option) handling.
+
+	* src/utils/grog/grog.pl: Redeclare `device` as a scalar instead
+	of a list.
+	(process_arguments): Generalize handling of `-T` and `-m`
+	options to permit optional whitespace.  Rename scalar `was_T` to
+	`delayed_option`.
+	(infer_device): Stop unconditionally adding a `-T ps` argument
+	to the generated groff command.  Remove logic that validates any
+	given `-T` option argument; instead, let groff fail if a bad one
+	is supplied (its own diagnostics in this scenario were improved
+	in commit 5a721a30, 27 May).  This makes grog agnostic about any
+	differently configured default device in groff itself, and about
+	the GROFF_TYPESETTER environment variable.
+
+	Fixes <https://savannah.gnu.org/bugs/?55301> by getting out of
+	the way.
+
+	* src/utils/grog/tests/PF-does-not-start-pic-region.sh:
+	* src/utils/grog/tests/smoke-test.sh: Update expected output.
+
+2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.am (grog): Drop sed replacement of unused
+	configuration variables @g@, @BINDIR@, @libdir@, and @EGREP@.
+	* src/utils/grog/grog.pl (process_arguments, construct_command):
+	Tweak warning diagnostics to use a style where an empty argument
+	will be easy to spot.
+	(do_first_line): Stop emitting pseudo-diagnostic (to standard
+	output!) if we see a "groff options line" it's not of
+	incorrect form.  The preprocessor encoding hint convention of
+	concern here is particular to man pages, disregarded by at least
+	one major implementation thereof (man-db man), and not used by
+	other types of roff documents; at this point, we don't yet know
+	if the document we're processing is a man page.
+	(construct_command): Correct comment and related logic error.
+	Clear the inferred main macro package if _any_ `-m` argument
+	matching any main macro package is given.  Warn only if what is
+	specified doesn't match the inference.
+
+2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Heavily refactor.
+
+	* src/utils/grog/grog.pl:
+	  - Drop import of unused module `Data::Dumper`.
+	  - Drop unused scalars `Sp` and `correct_tmac`.
+	  - Simplify determination of version number.  Drop hash `at_at`
+	    which only stored one key, `GROFF_VERSION`.  Initialize
+	    scalar `groff_version` to "DEVELOPMENT".  Rename scalar
+	    `before_make` to `in_source_tree` and initialize to zero.
+	    Update `groff_version` with Automake-determined version
+	    variable if it is defined (i.e., grog is not running outside
+	    of, or in an unbuilt, groff source or binary distribution).
+	  - Drop unused `Mparams` list.  Replace it with new list
+	    `requested_package`, which stores the arguments to any grog
+	    `-m` options specified by the user.
+	  - Rename many objects so that I, and others, can better
+	    comprehend their purpose, and for consistent letter casing.
+	    . @Command -> @command
+	    . @devices -> @device
+	    . $Prog -> $program_name
+	    . %macros -> %user_macro
+	    . $have_any_valid_args -> $have_any_valid_arguments
+	    . &handle_args -> &process_arguments
+	    . &handle_whole_files -> &process_input
+	    . @preprograms -> @preprocessor
+	    . &make_groff_device -> &infer_device
+	    . &make_groff_preproc -> &infer_preprocessors
+	    . &make_groff_tmac_others -> &infer_macro_packages
+	    . &make_groff_tmac_man_ms -> &infer_man_or_ms_package
+	    . &make_groff_line_rest -> &construct_command
+	  - Drop many unused keys in `Groff` hash.
+	  - Add new lists, `macro_ms`, `macro_man`, and
+	    `macro_man_or_ms` to support new scoring technique to
+	    disambiguate input documents between these two packages.
+	  - Append the foregoing 3 lists to new list `standard_macro`,
+	    and add these as keys to the `Groff` hash.
+	  - Add new list `main_package` to keep track of full-service
+	    package names.
+	  - Add new scalars `man_score`, `ms_score`, and
+	    `inside_tbl_table` to aid disambiguation of .TH macro calls
+	    and the many macro names shared between man(7) and ms(7).
+	  (process_arguments): Strip '-m' off of argument before storing
+	  the remainder in `@requested_package`.
+	  (do_line): Detect .TH macro call even if white space occurs
+	  between the control character and the macro name.
+	  (do_line): Inflate `$man_score` by 100 if .TH is the first
+	  macro call seen in a document.
+	  (do_line): Fix bug; clear `$before_first_command` in correct
+	  scope--after any macro call, not just if we saw a .TH as the
+	  first macro call.
+	  (do_line): Set `$inside_tbl_table` when we see a .TS call.
+	  (do_line): Clear `$inside_tbl_table` when we see a .TE call.
+	  Also increment `$Groff{'tbl')' again, increasing the "score"
+	  of tbl(1) usage evidence.
+	  (do_line): Drop a lot of code that manually increments %Groff
+	  keys corresponding to man and ms macros.  This is now done
+	  differently and elsewhere.
+	  (do_line): Drop "P" from list of characteristic mm(7) macros.
+	  (do_line): Simplify matching of mom(7) macros (match $command,
+	  not $line).  Extend list of characteristic mom(7) macros.
+	  (do_line): Increment $Groff{$key} if $key is in
+	  @standard_macro.
+	  (infer_man_or_ms_package): Rewrite.  Compute a score for each
+	  package by counting occurrences of their characteristic
+	  macros.  If both have a score of zero, assume that the input
+	  is a raw roff document.  If the scores are equal
+	  {doc/webpage.ms, startlingly, comes within 1 point of a tied
+	  score}, infer ms(7) if 'TH' was never called, and if it was,
+	  issue a diagnostic advising user to supply a disambiguating
+	  `-m` option.  Otherwise, the scores are unequal: infer the
+	  package of the winner.  Set scalar `inferred_main_package`
+	  instead of pushing `-m` options onto `@m`.
+	  (infer_macro_packages): Set scalar `inferred_main_package`
+	  instead of pushing `-m` options onto `@m`.  Explicitly return
+	  0 if we fall off the end of the function.
+	  (construct_command): Rewrite handling of -m options.  Add new
+	  list `msupp` to store supplementary (non-main) macro package
+	  arguments.  If a full-service package was explicitly
+	  requested, it had better not clash with what we inferred.  If
+	  it does, explicitly unset `inferred_main_package` so that the
+	  -m arguments are placed in the same order that the user gave
+	  them; caveat dictator.  If `--run` option was given, just
+	  print the command; don't preface it with __FILE__ and __LINE__
+	  noise.
+	  - Remove comments documenting shared variables used by
+	    subroutines.  These are far from useless but too tedious to
+	    keep up to date while the code is in flux.
+	  - Note several places for further code review or refactoring
+	    with "XXX" comments.
+	  - Add Vim modeline.
+
+	grog now passes all its tests and correctly infers arguments for
+	all in-tree groff documents (except for a known, and already
+	documented in grog(1), false positive detection of soelim in
+	soelim(1)).  This refactor also obviates or resolves several
+	outstanding Savannah tickets.
+
+	Fixes <https://savannah.gnu.org/bugs/?44707> by obviating it;
+	grog no longer cares about file name extensions on man pages (or
+	any other input).
+
+	Fixes <https://savannah.gnu.org/bugs/?55302>; same.  The quality
+	of diagnostic messages has been improved as well.
+
+	Fixes <https://savannah.gnu.org/bugs/?59753>; same.
+
+	Fixes <https://savannah.gnu.org/bugs/?59664>.  The attached
+	patch was a less aggressive refactor of &do_line and %Groff.
+	Its author made the following claim for it: "With this patch,
+	all 'man', 'me', 'mom, and 'ms' files in the repository are
+	correctly identified.  The only example of a 'mm'-file is
+	"letter.mm", which is not recognized correctly."  As noted
+	above, the present refactor achieves correct recognition of all
+	of the files, including letter.mm.
+
+2021-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/tests/smoke-test.sh: Perform whole-line
+	matches.  Apply DRY principle to expected output.  In
+	anticipation of pending changes to grog.pl, uncomment and add
+	tests for several in-tree documents.
+		doc/meref.me
+		contrib/mom/examples/copyright-chapter.mom
+		contrib/mom/examples/copyright-default.mom
+		contrib/mom/examples/letter.mom
+		contrib/mom/examples/mom-pdf.mom
+		contrib/mom/examples/mon_premier_doc.mom
+		contrib/mom/examples/sample_docs.mom
+		contrib/mom/examples/slide-demo.mom
+		contrib/mom/examples/typesetting.mom
+		doc/webpage.ms
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Refactor.  Discard filename extension-based inference.
+
+	* src/utils/grog/grog.pl (do_line): Stop saving the control
+	character in the matched scalar `command` (the request or macro
+	name).  We don't need it, and it simplifies much later matching.
+	(handle_file_ext): Delete.
+	(top level): Drop call site.
+
+	* src/utils/grog/grog.pl: Rename `tmac_ext` scalar to
+	`inferred_main_package`.
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.pl (handle_args): Complain less noisily
+	and more comprehensibly when given unrecognized groff options.
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Handle "--" argument as documented.
+
+	* src/utils/grog/grog.pl (handle_args): Rename scalar
+	`double_minus` to `no_more_options` so it actually communicates
+	something.  Drop openability check of operand encountered after
+	"--"; since it's on the operand list, it will be checked later
+	{in `handle_whole_files`}.  Stop pushing "--" itself onto the
+	`filespec` list.
+
+	Fixes <https://savannah.gnu.org/bugs/?60834>.
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Revise operand handling, diagnostics, and exit status.
+
+	* src/utils/grog/grog.pl: Track more state so that we can
+	process the argument list more intelligently and exit with a
+	meaningful status.  Add `had_inference_problem`,
+	`had_processing_problem`, and `have_any_valid_args` Boolean
+	scalars.
+	(fail): Add diagnostic subroutine for serious problems; sets
+	`had_processing_problem`.
+	(handle_args, handle_file_ext): Stop complaining here about
+	unopenable file operands.
+	(handle_whole_files): Complain only here, with `fail` if a file
+	operand cannot be opened.
+	(make_groff_line_rest): Don't exit immediately if there is a
+	macro package inference clash, because there might be more
+	operands to process.  Instead, set `had_inference_problem`.
+	Stop exiting from this subroutine.
+	(top level): Only call the inference subroutines if we had a
+	valid operand to work with (including an implicit read from
+	stdin).  Exit with a status corresponding to the Booleans
+	declared above.
+
+	* src/utils/grog/grog.1.man (Exit status): Add section; describe
+	semantics of exit status values.
+
+	Fixes <https://savannah.gnu.org/bugs/?60833>.
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Revise diagnostic messages.
+
+	* src/utils/grog/grog.1.man (err): Rename from this...
+	(warn): ...to this.  Prefix diagnostic with command name and
+	diagnostic severity level.  The subroutine didn't change the
+	exit status and was not used to report serious trouble, so
+	"warning" seems appropriate.
+	(make_groff_tmac_man_ms): Update call sites.  Modify diagnostic
+	wording to stop calling macros "requests".
+
+2021-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/grog.1.man (Limitations): Add subsection
+	covering the problem grog has with soelim inference.  Undocument
+	groff's -s option as one that can be inferred, because at
+	present it cannot be.
+
+	Prompted by Savannah #60421.
+
+2021-06-26  Dave Kemper <saint.snit@gmail.com>
+
+	grog: Fix erroneous detection of pic(1) usage.
+
+	Fixes <https://savannah.gnu.org/bugs/?60772>.
+
+2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/grog/tests/PF-does-not-start-pic-region.sh:
+	  Regression-test Savannah #60772.
+	* src/utils/grog/grog.am (grog_TESTS): Run test.
+
+2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grog: Add smoke test.
+
+	* src/utils/grog/tests/smoke-test.sh: Add test.
+	* src/utils/grog/grog.am (grog_TESTS): Run it.
+	(TESTS): Add `grog_TESTS`.
+	(EXTRA_DIST): Ship test.
 
-	Add `pdfmom' to handle mom documents with gropdf.
+2021-06-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (OTHERDIRS): Move contrib/mom to be run after
-	devices/gropdf.
+	grog: Relocate in source tree.
 
-	* src/devices/gropdf/gropdf.pl: Various fixes:
+	* src/roff/grog: Move from here...
+	* src/utils/grog: ...to here.
 
-	. Correct image scaling issue.
-	. Handle relative horizontal movement 'h' followed by absolute
-	vertical movement 'V'.
-	. Correct handling of track kerning.
+	* MANIFEST:
+	* Makefile.am:
+	* src/utils/grog/grog.am: Reflect move.
 
-	* src/devices/gropdf/pdfmom.pl: New wrapper for mom (pdfmom)
-	using gropdf or grops driver.
-	* src/devices/gropdf/pdfmom.man: New man page.
-	* src/devices/gropdf/Makefile.sub: Updated to handle new files.
+	Fixes <https://savannah.gnu.org/bugs/?60788>.
 
-2012-08-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (OTHERDIRS): Move contrib/mom to be run after
-	devices/gropdf.
+	* doc/groff.texi (Assigning Formats): Revise discussion.
+	Clarify that a format never causes truncation of an interpolated
+	magnitude.  Note that non-Arabic number formats cannot be used
+	as operands to arithmetic expressions.  Add example of how to
+	work around this.
 
-	* src/devices/gropdf/gropdf.pl: Various fixes:
+2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	. Correct image scaling issue.
-	. Handle relative horizontal movement 'h' followed by absolute
-	    vertical movement 'V'.
-	. Correct handling of track kerning.
+	troff: Clarify diagnostics.
 
-	* src/devices/gropdf/pdfmom.pl: New wrapper for mom (pdfmom)
-	using gropdf or grops driver.
-	* src/devices/gropdf/pdfmom.man: New man page.
-	* src/devices/gropdf/Makefile.sub: Updated to handle new files.
+	* src/roff/troff/reg.cpp (reg::set_increment): Update diagnostic
+	to unabbreviate "auto".
+	(reg::alter_format): Update diagnostic to say "assign" instead
+	of "alter", since the documentation consistently uses the former
+	term.
 
-2012-08-31  Julien Moutinho  <julm+groff@autogeree.net>
+2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/www.tmac (www-push-li): Fix indentation.
+	troff: Slightly refactor.  Make the source code slightly more
+	accessible by using a `bool` type for a member function's
+	default parameter used as a Boolean, and comment it at call
+	sites where the default is overridden.
 
-	See
+	* src/roff/troff/token.h (token::get_char): Change type of
+	parameter from `int` to `bool` and default from 0 to `false`.
+	* src/roff/troff/input.cpp (token::get_char): Update definition.
+	* src/roff/troff/env.cpp (hyphen_word):
+	* src/roff/troff/node.cpp (remove_font_special_character):
+	* src/roff/troff/input.cpp (do_overstrike, do_bracket, next)
+	(do_define_character, remove_character, get_line_arg)
+	(encode_char, do_if_request, do_translate, char_flags)
+	(hyphenation_code, define_class): Update call sites.  Add
+	comment indicating meaning of parameter.
+
+2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): When outputting HTML, write the
+	possibly case-transformed (but not yet abbreviated) page title
+	as the `title` element instead of the unaltered first argument
+	to `TH`.
+
+2021-06-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-abbreviate-title): Define with `de`, not
+	`de1`, since it is not intended for call by traps or users.
+
+2021-06-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Tab Stops): Fix erroneous claim; tab stops are
+	not set "every half inch across the page".  This is only true in
+	"line tabs mode", which is not enabled by default.  The default
+	behavior, to keep compatibility with AT&T troff, measures tab
+	stops relative to the current position on the input line.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-nroff-u: Set the usekeeps register used by tbl
+	to the logical complement of the cR (continuous rendering)
+	register.  This prevents blank lines from creeping into tables
+	in that mode.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
+	We say in a comment, "Macros ... that are called by traps of any
+	kind must be defined with `de1` because they might be called
+	from a context where compatibility mode is enabled."  So do it.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-header): Lightly refactor; tighten.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-write-paragraph-tag): Lightly refactor
+	for clarity and to reduce code duplicated in both branches of an
+	`ie`/`el` structure.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Rename `an-HF-remap-I-style` register to
+	`an-remap-I-style-in-headings` for greater clarity.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-common-u (doc-header, doc-end-macro): Partially
+	revert bf4b3dde (from 20 May); per Ingo Schwarze, continuous
+	rendering in mdoc(7) documents has always used only one vee
+	between headers, footers, and man page body text.
+
+2021-06-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/en.tmac: Stop using `do` request; it's unnecessary since
+	the file is already loaded with compatibility mode off.
+
+2021-06-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Fix doc omission; .ID can take an argument.
+
+	* doc/groff.texi (ms Document Control Settings) <DI>:
+	Characterize register setting as a _default_.
+	(ms Displays and Keeps): Add optional variable "indent" argument
+	to syntax summary of ".DS I" and ".ID".  Note that the given
+	indentation is used if present, and \nDI otherwise.
+	* doc/ms.ms (Displays and keeps): Add optional variable "indent"
+	argument to syntax summary of ".ID".  Switch fonts more
+	carefully and apply italic corrections.
+	* tmac/groff_ms.7.man (Displays and keeps): Sync with doc/ms.ms.
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Properly situate devtag flag-related register
+	names in the package name space.  Rename `need_eo_h` to
+	`s@devtag-needs-end-of-heading'.  Rename `need_eo_tl` to
+	`s@devtag-needs-end-of-title`.
+	((initialization), par@reset, @SH, par@finish, @NH): Do it.
+	(par@reset): Test their values more idiomatically.
+
+	Fixes last third of <https://savannah.gnu.org/bugs/?42515>.
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac-u (@h): Migrate SCCS revision 2.37 to be idiomatic
+	for groff (and not throw warnings of type 'mac').
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Improve diagnostics during documentation
+	generation; none should occur normally, but when they do, seeing
+	troff complain about "<standard input>" is disheartening.
+	(DOC_GROFF_ONLY): Add -b option so we get backtraces (also kill
+	off trailing whitespace).
+	(DOC_GROFF):
+	(doc/pic.html):
+	(doc/webpage.html): Add sed expression to inject `lf` request
+	into the stream to identify the file being processed.
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/me-revisions: Supplement history with subsequent BSD work
+	from versions 2.29 (1988-04-22) to 8.1 (1993-06-05).
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/me-revisions: Add 'me' macro package revision log, scraped
+	from <https://svnweb.freebsd.org/csrg/share/me/revisions>.
+	* doc/doc.am (DOCFILES): Ship it.
+
+2021-06-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac-u: Rename registers for clarity.  Unlike other
+	macro packages supplied by groff, "me" mostly remains within the
+	AT&T 2-character name space, accessing extended names
+	selectively through `do` and `de1` requests.  The package
+	therefore has no characteristic name prefix.
+	  need_eo_h  -> devtag-needs-end-of-heading
+	  need_eo_tl -> devtag-needs-end-of-title
+	  need_tl    -> devtag-needs-title
+	(@html_check_need_title, sh, EQ): The foregoing registers are
+	effectively Booleans, so perform Boolean-style tests on their
+	interpolations.
+
+	Fixes a second third of <https://savannah.gnu.org/bugs/?42515>.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/e.tmac-u: Work in compatibility mode.  It seems this was
+	the intention (reasonable, since "me" originates in pre-groff
+	BSD Unix), but there were several problems.
+	(@R): Prefix register existence test with `do`.
+	(@html_check_need_title): Define with `do` since the macro name
+	is long, and also with `de1` so that we can freely use groff
+	extensions within.  Drop many `do` requests from macro
+	definition.
+	(@check_need_title): Define with `do`, as above.  Add comment
+	explaining why `de1` is not needed for this macro definition.
+	(@S): Prefix macro/string existence test with `do`.  Remove
+	spurious space so that the argument string name is truly defined
+	as empty.
+	(nm, n1, n2): Prefix handling of long register names `_#p` and
+	`_#f` with `do` request.
+	(top level): Prefix `mso` request with `do`.
+	((x-html): Define with `do` and `de1` instead of `de`.  Drop
+	now-unnecessary `do` requests from macro body.
+	()x-html): Define with `do` and `de1` instead of `de` for
+	symmetry.
+	(xp-html): Define with `do` and `de1` instead of `de`.  Drop
+	now-unnecessary `do` requests from macro body.
+
+	Fixes <https://savannah.gnu.org/bugs/?60785>.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/devtag.tmac: Work in compatibility mode; define macros
+	with the `de1` instead of the `de` request.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/refer-me.tmac:
+	* tmac/refer.tmac: Add include guards.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/refer-me.tmac: Handle being loaded in compatibility mode.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Properly situate devtag flag-related
+	register names in the package name space.  Rename `need_eo_h` to
+	`an-devtag-needs-end-of-heading'.  Rename `need_col2` to
+	`an-devtag-needs-second-column`.
+	(an-input-trap, SH, SS, HP, (initialization)): Do it.
+	(an-input-trap): Test their values more idiomatically.
+
+	Fixes one third of <https://savannah.gnu.org/bugs/?42515>.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_if_request): Improve diagnostic
+	message; say "conditional operator", not just "conditional".
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-end, an-header): In continuous rendering
+	mode, use same spacing amount after header and before footer as
+	mdoc in its own continuous rendering mode.  Thanks to Ingo
+	Schwarze for the suggestion.
+
+	Fixes <https://savannah.gnu.org/bugs/?60653>.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (P): Define this as the "canonical"
+	paragraphing macro.
+	(LP, PP): Make these aliases of P.
+
+2021-06-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (spring_trap): Tighten lexical
+	discipline; describe macro as "trap-called" rather than
+	"trap-invoked".
+
+2021-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Don't spuriously break a page after a paragraph tag when
+	the tag is short enough to fit within the paragraph's
+	indentation.
+
+	* tmac/an-old.tmac (an-write-paragraph-tag): Reserve ("need") 2
+	vees plus 1 basic unit of vertical space regardless of the width
+	of the tag.  In the short tag case, we reverse space by one vee
+	after outputting the diversion in which the tag is stored, but
+	it will always contain a break, and by the time we reverse, we
+	might have already hit a page location trap
+	{an-break-body-text}, and by then it's too late to back up.
+
+	* tmac/tests/an-old_no-break-after-short-paragraph-tags.sh: Test
+	it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?60624>.
+
+2021-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Rename environments to be more descriptive.
+	  an-env -> an-env-header-or-footer
+	  an-2   -> an-env-paragraph-tag
+	(an-header, an-footer, an-write-paragraph-tag): Do it.
+
+2021-06-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Add diagnostic error if .EQ used within .TS/.TE.
+	Introduce register `tbl@within-table` to track whether we're
+	inside a table.
+	(@EQ): Check register and issue error if it is true.
+	(@TS): Set register.
+	(@TE): Clear register.
+
+	Prompted by Savannah #55754.
+
+2021-06-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Permit document to start with .PS.
+	(cov*ab-init): Alias PS to @PS.
+	(PS): Call LP, then re-execute (aliased) self as TS does.
+	(TS): Update comment to parallel the one in PS.
+
+2021-06-11  Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
+
+	Indent an IP paragraph based on the type size of the paragraph
+	text, not a preceding heading.  We have to delay evaluating IP's
+	argument until the font size has been reset, which I've
+	attempted to do by simply passing the argument unevaluated down
+	the call hierarchy, instead of saving it in a number register
+	right away, as appears customary in this ms implementation.
+
+	However, par@reset is called from a great number of places, and
+	these usually set the indent registers beforehand.  I've left
+	this as it is, so now two ways of setting the indents exist: via
+	register and optionally via argument.
+
+	* tmac/s.tmac (par@reset): Move font-size setting stuff before
+	indent-setting stuff; set registers from optional arguments with
+	default "n" scaling indicator before setting indents.
+	(par*start, par@finish): Don't set registers, but instead pass
+	arguments to par@reset.
+	(@IP): Pass argument unevaluated to par*start.
+
+	Fixes <https://savannah.gnu.org/bugs/?59604>.
 
-	http://lists.gnu.org/archive/html/bug-groff/2012-08/msg00009.html
+2021-06-11  Tadziu Hoffmann <hoffmann@usm.uni-muenchen.de>
 
-	for the full report.
+	* tmac/s.tmac (@QP, @XP): Be more scrupulous about using "u"
+	scaling indicator.
 
-2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+2021-06-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	TBLization, as discussed on the list.  There's a rewrite of
-	this file in planning, but this gets the content clean for now.
+	Add regression test for Savannah #59604.
 
-	* tmac/groff_mdoc.man: In this file.
+	* tmac/tests/s_IP-indents-using-paragraph-type-size.sh: Add it.
+	* tmac/tmac.am (tmac_TEST): Run it.
 
-2012-08-09  Werner LEMBERG  <wl@gnu.org>
+2021-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Provide proper Unicode mapping from and to dotless j.
+	Refactor grog even more aggressively.  Make the tedious search
+	for subs.pl unnecessary by inlining it into grog.pl directly.
+	This makes the script stand alone and much more convenient to
+	work with, and doesn't contribute to bloat, in my
+	opinion--subs.pl was 10 times the size of grog.pl, and most of
+	the code in the latter was dedicated to trying to locate
+	subs.pl.
 
-	* src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
-	src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Add it.
+	* Makefile.am: Delete references to $(grog_dir).
+	* configure.ac: Delete call of `GROFF_GROGDIR_DEFAULT` macro.
+	* m4/groff.m4: Delete definition of same.
+	* src/roff/grog/grog.am (GROG, dist_grog_DATA, grogdir): Drop
+	variables.
+	(grog): Remove target's dependency on `$(GROG)`.  Remove sed
+	expression replacing `@grog_dir@` with `$(grog_dir)` in grog.pl.
+	* src/roff/grog/grog.pl: Inline most of subs.pl (except for
+	author/license comment banner).  Delete sub-hunting logic.
+	* src/roff/grog/subs.pl: Delete.
 
-2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+2021-06-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Added Unicode code point for dotless j.
+	* doc/pic.ms (Basic PIC Concepts, Decorating Objects/Filled
+	Objects, PIC Reference/Semi-Formal Grammar): Fix error: the
+	keyword "solid" sets a line style, not a fill for a closed
+	figure.  Thanks to Dave Kemper and Wim Stockman for reporting
+	and researching this issue.
 
-	* man/groff_char.man: In this file.
+	Fixes <https://savannah.gnu.org/bugs/?60470>.
 
-2012-08-08  Werner LEMBERG  <wl@gnu.org>
+2021-06-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_char.man: Clean-ups.
+	* NEWS:
+	* doc/webpage.ms:
+	* man/groff.7.man (Registers/Read-only registers) <.U>:
+	* man/groff_diff.7.man (Language/New number registers) <.U>: Fix
+	error; the sense of this Boolean variable was backwardly
+	documented {perhaps due to an implementation detail from 2004
+	that was reversed in commit 7a0e2f15, 26 February 2008}.
+
+2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.cpp: Revise usage message.
+	(synopsis): Set primary synopsis on a single output line, for
+	convenience of parsing and also because we have no control over
+	the width of the program name in character cells; it comes from
+	argv0 and is under user control.  There is thus no point in
+	trying to get pretty formatting.  Also include separate synopsis
+	lines for short and long help options.  Use opposite case from
+	option flags for option arguments.
+	(help): Collate option flags in English lexicographic order.
+	Include space after flag letters for options that take
+	arguments.  Consistently use capitals for option arguments
+	because they are space-separated here.  Illustrate longer forms
+	of -d and -r options.  Update language (some, like "tmac.name",
+	was very old).  Add reference to groff(1) man page at end.
+	(usage): Drop appendnment of notice regarding -h option; this is
+	now covered in `synopsis()` unconditionally.
+
+2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Eliminate "groff_opts_no_arg.txt" and "groff_opts_with_arg.txt"
+	files from distribution.  They are not needed by any live code
+	in the tree; possibly only groffer ever used them.
+
+	* src/roff/groff/groff.am (GROFF_OPTS_OUTPUT, groffoptsdir)
+	(groffopts_DATA): Delete variables.
+	(MOSTLYCLEANFILES): Stop adding to target.
+	(groff_opts.tmp, groff_opts_no_arg.txt,
+	groff_opts_with_arg.txt): Delete targets.
+
+2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/grog/subs.pl (version): Report version information in
+	a format consistent with our other programs.
+
+2021-06-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/grog/grog.pl: Refactor initialization so that the
+	program can be run from a build tree--and tested.  Drop much
+	cruft from before Bertrand Garrigues's 2018 work to adopt
+	`git-version-gen`.
+
+2021-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_title-abbreviation-works.sh: Log more
+	accurate messages in test failures.
+
+2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-abbreviate-title): Add new internal macro
+	to reduce the length of a man page title (i.e., the "ls" in
+	"ls(1)", if it is too wide to fit in the page header (and would
+	overwrite the center header material, usually the title of the
+	manual section).  Since the beginning and end of the title might
+	be important for disambiguation, truncation at either end would
+	be unwise; replace the middle of the title with an ellipsis.
+	Define new an-pageref and an-title-abbv strings for use by other
+	macros and user-defined PT and BT traps.
+	(PT, an-footer): Use new an-pageref string for economy.
+	(an-header): Call an-abbreviate-title after setting the title
+	length.
+
+	* tmac/tests/an-old_title-abbreviation-works.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?43532>.
+
+2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Copy mode): Add new section.
+
+2021-06-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (else_request, while_request)
+	(pipe_source, open_request, opena_request, pipe_output)
+	(system_request): Update diagnostic messages to not presume the
+	identities of the control or escape characters.
+
+2021-06-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Conventions Used in This Manual): Add node.
+
+2021-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.1.man: Expand to aid beginners.
+	(initialization): Define `TeX` string.
+	(Usage): Rewrite.
+	(Usage/Getting started): Add "Hello, world!" example using
+	multiple output devices (formats).
+	(Usage/Using groff as a REPL): Add example of likely interest to
+	programmers.  Or so I hope.  It illustrates the Turing
+	fundamentals; we read, store, test, and branch.
+
+2021-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/papersize.tmac: Improve diagnostic message; when
+	complaining about unrecognized input, report back the input we
+	actually received, not what it looks like after we transform it.
+	Also add name of macro package to diagnostic so the user knows
+	who is speaking, continuing the long process of fixing Savannah
+	#52463.
+
+2021-05-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_ms.7.man (Usage/Paragraphs) <QP>: Fix error: .QP
+	paragraphs are indented by \nQI, not \nPI.
+
+2021-05-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libdriver/input.cpp (do_file): Make fatal diagnostic
+	from output driver when the device description file "DESC" can't
+	be found more informative by including the name of the device
+	for which the input was prepared.  Also makes malformed input of
+	intermediate format more obvious.
+
+2021-05-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/tbl.1.man (Miscellaneous): Add paragraph
+	cautioning users against making tbl(1) tables conditional
+	document content.
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Add style warnings for documents with input lines that
+	are blank or have leading spaces, since they can cause
+	surprising rendering; enabled if the CHECKSTYLE register is
+	greater than 2.
+
+	* tmac/an-old.tmac (an-blank-line-trap, an-leading-space-trap):
+	Issue style warning if enabled (and only if fill mode enabled in
+	leading space trap); in any event, recreate the default *roff
+	behavior.
+	(TH): Install traps.
+
+	* doc/andoc.tmac (reload-doc): Remove man(7) traps before
+	loading doc.tmac.
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/andoc.tmac (reload-doc): Fix spurious blank line.
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Operators in Conditionals):
+	* man/groff.7.man (Control structures/Conditional expressions):
+	Fix omission; the conditional operators "F", "m", and "S" also
+	accept optional spaces and/or tabs between themselves and their
+	arguments.
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Requests/Request short reference) <.ta>:
+	Describe the request as tersely as possible without omitting its
+	essential syntax and semantics.  (The AT&T troff "+" relative
+	prefix for normally absolute positions ".ta 1i +1i +1i" and
+	alignment-specifying suffixes "L", "R", and "C" had both been
+	omitted.)
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Registers/Writable registers): Fix error:
+	\nnl interpolates the current vertical position, not the
+	vertical position of the "last printed text baseline"; the
+	latter is \n.h.
+
+2021-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Manipulating Filling and Adjustment): Update
+	inter-sentence space example to be more illustrative.  Thanks to
+	Dave Kemper and Doug McIlroy for the discussion.
+
+	Fixes <https://savannah.gnu.org/bugs/?60404>.
+
+2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-common-u: Add comment warning source divers that
+	\ndoc-header-space is re-used for a purpose for which it is
+	not documented.
+	* tmac/mdoc/doc-nroff-u: Initialize doc-{header,footer}-space
+	registers, which define the vertical spacing between body text
+	and the relevant titles (not between the titles and the page
+	margins) to 1v instead of 0.5i.  This is what mdoc(7) has always
+	done in practice, per Ingo Schwarze.
+
+2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/grohtml/post-html.cpp (assert_state::add): Avoid
+	potential deallocation of statically-allocated strings.  Use
+	strsave() to duplicate them so that they can be safely handed to
+	a_delete().  Also update diagnostic message to report name of
+	complaining program (continuing the long process of fixing
+	Savannah #52463).
+
+	Fixes <https://savannah.gnu.org/bugs/?55693>.  Thanks to
+	Petru-Florin Mihancea for the report.
+
+2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/troffrc-end: Fix transposition error (in commit a248aa33
+	on 15 January) that broke most table image generation in HTML
+	output.
+
+	Fixes <https://savannah.gnu.org/bugs/?60656>.
+
+2021-05-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac (UE, ME): Replace calls to HTML-NS macro for
+	emissions of HTML 'A' tags with direct usage of \X device
+	control escapes.  Replace .nop requests with text lines since
+	this file is supposed to be maximally portable to other *roffs.
+
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/html/pre-html.cpp (main): Call `scanArguments()`
+	earlier, before trying to load a font description, so that -v,
+	--version, and --help work.
+
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grohtml: Add -C and -G options to postprocessor, to suppress
+	output of CreationDate and Creator HTML comments, respectively.
+	These can inject unwanted noise into build artifacts.
+
+	* src/devices/grohtml/post-html.cpp: Add static globals
+	`do_write_creator_comment` and `do_write_date_comment`.
+	(html_printer::{do_file_components,~html_printer}): Write
+	comments per corresponding global variables.
+	(main): Add to `getopt_long()` call parameter and set as needed.
+	(usage): Document them.
+
+	* src/preproc/html/pre-html.cpp (scanArguments): Add to
+	`getopt_long()` parameter, but ignore.
+
+	* src/devices/grohtml/grohtml.1.man (Synopsis, Options):
+	Document them.
+
+	* src/roff/groff/tests/output_driver_C_and_G_options_work.sh:
+	Test them.
+	* tmac/tmac.am (groff_TESTS): Run test.
+
+	Fixes 1/3rd of <https://savannah.gnu.org/bugs/?60655>.
+
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+	* src/preproc/html/pre-html.cpp (usage):
+	* src/devices/grohtml/post-html.cpp (usage): Fix inaccuracies in
+	supported option summary.
 
-	Elimination of nasty presentation-level macro tangles makes
-	structural translation to XML possible.
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_char.man: Clean up the mess, use real TBL tables.
+	* src/preproc/html/pre-html.cpp (scanArguments):
+	* src/devices/grohtml/post-html.cpp (main): Use libgroff's
+	warning() instead of printf() to emit diagnostic about
+	unrecognized parameter to `-x` option.  This sends the
+	diagnostic to the standard error stream and continues the long
+	process of fixing Savannah #52463.
 
-2012-07-23  Eric S. Raymond  <esr@thyrsus.com>
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	More elimination of low-level troff hackery in the documentation
-	so it can be lifted to structural markup.
+	* tmac/groff_www.7.man: Stop using the "www" macro package.  The
+	macros it exposes are not part of the quasi-standardized man(7)
+	language, and thus should not be used in man(7) documents.  See
+	groff_man_style(7) for portability advice.  Besides, the
+	extension macros in the permissively-licensed an-ext.tmac are
+	sufficient to support URL and email hyperlinks, and our SH and
+	SS macro implementations already support anchor placement
+	without requiring explicit effort from page authors.
+	(initialization): Stop sourcing www.tmac.  Stop calling .LK and
+	.HR; the page-internal navigation links were being placed after
+	the apropos line instead of at the beginning of the page,
+	contradicting the comment that was there (possibly a bug).
+	(Requests) <URL, LK>: Stop calling .TAG.
+	<LK>: Drop paragraph advising reader to format page for groff's
+	HTML output device to observe the navigation links at that point
+	in the test.
 
-	* tmac/groff_me.man: Use TBL rather than wacky diversions and .ti
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Comments): Fix error in description of parser
+	operation; '.\"' is an effective whole-line comment not because
+	it is a call of an undefined macro named '\"' (no 'mac' warning
+	is emitted when that warning type is enabled), but because the
+	comment escape is recognized normally and what remains is
+	handled as the empty request.  Clarify that the optional
+	argument to the .ig request is the name of a macro (which will
+	be called normally _and_ end the ignored region; this is
+	analogous to ".de foo bar").
+
+2021-05-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac (UR, UE, MT, ME): Rename environment and
+	diversion for clarity; they apply to the link text, not the URL
+	{or email address}.  The latter might not visibly appear,
+	depending on the output driver.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Remove extraneous right-brace escape.
+
+	Fixes <https://savannah.gnu.org/bugs/?60651>.  Thanks to Bjarni
+	Ingi Gislason for catching it.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Copy Mode): Fix omissions from list of escape
+	sequences interpreted even in copy mode.  Add \g, \V, "\.",
+	'\"', \#, \a, \e and \E (with caveat), and \t.  Parallels
+	groff(7) now.  Add cross reference to "Character Translations"
+	node.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Escape Sequences): Fix omission; the escape
+	character in an unrecognized escape sequence is not merely
+	ignored; the sequence produces a warning diagnostic, albeit of a
+	type that is disabled by default.
+	(Escape Sequences/Escape short reference): Fix omissions; \# and
+	\V are interpreted even in copy mode.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-header): Fix missing brace escape.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Slightly refactor footer spacing management when
+	continuously rendering.
+
+	* tmac/an-old.tmac (an-end): Increase the page length _after_
+	flushing a pending output line.  Do so only by the amount of
+	spacing we actually perform next.  Make the scaling indicator on
+	the .sp request explicit.  The amount seemed magical because it
+	was accounting for the one line to be consumed by output of the
+	footer title line.  Instead, move that further increase of the
+	page length from here...
+	(an-footer): ...to here (~250 lines away), before calling BT.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-common-u (doc-end-macro): When continuously
+	rendering and after flushing the last line of the body text of a
+	page, vertically space by 3 vees instead of 1, for consistency
+	with our man(7) implementation.  Also increase page length by
+	same amount _after_ flushing a pending output line, for symmetry
+	with other spacing requests (and to prevent nasty surprises
+	analogous to those in Savannah #60611).
+	(doc-header): Put 3 vees of space after the header in continuous
+	rendering mode, not 1 (and increase page length accordingly).
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Add warnings for macros deprecated in groff_man(7),
+	emitted if the CHECKSTYLE register is greater than 1.
+
+	* tmac/an-old.tmac (an-deprecation-warn): New macro emits
+	diagnostic.
+	(DT, PD): Call the foregoing, re-using arguments.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Refactor to move bodies of DT and PD into
+	private macros.
+	(an-reset-tab-stops, an-reset-paragraph-spacing): New names for
+	the former DT and PT.
+	(TH): Call these new macro names.
+	(DT, PD): Wrap the corresponding private macros.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-bp): In continuous rendering mode, draw
+	a horizontal line between a page footer of one man page document
+	and the header of the next, but only if multiple documents are
+	being rendered.
+	(initialization): Use variable to ensure we don't draw this line
+	after finishing the only document we render.
+
+	Fixes other half of <https://savannah.gnu.org/bugs/?60611>.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix stochastic vertical space loss problems in continuous
+	rendering mode by being more scrupulous about extending the page
+	length.  As noted in Savannah #60611, sometimes the vertical
+	space between a header line and the first section heading
+	{"Name"} would be reduced or removed altogether, in a way that
+	was highly sensitive to circumstances.  As far as I can tell,
+	the problem is that this vertical space disappeared only when we
+	were in double-secret probation no-space mode; this is the
+	special non-spacing mode {not apparent with inspection of
+	\n.ns} that happens when the stealth internal page location
+	trap is sprung.  This trap does not appear in .ptr output but
+	can be disabled with ".vpt 0", which is an alternative fix for
+	this problem {because continuous rendering mode does not use
+	vertical position traps at all}.  Another fix might have been to
+	simply call the moral equivalent of ".pl MAXINT" as soon as
+	continuous rendering mode was decided upon.
+
+	* tmac/an-old.tmac (an-header): In continuous rendering mode,
+	extend the page length by one line before calling PT to output
+	the page header, and afterwards, extend the page length by 3
+	vees and space by that amount (instead of half an inch).
+
+	Fixes half of <https://savannah.gnu.org/bugs/?60611>.
+
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-header, an-footer): Drop no-op .tl
 	requests.
 
-2012-07-24  Werner LEMBERG  <wl@gnu.org>
+2021-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-footer): Improve symmetry with an-header.
+	If rendering to HTML, don't bother setting the
+	an-outer-footer-text, an-extra1, and an-extra2 strings to empty
+	values; instead don't call BT, just as we don't call PT in
+	an-header.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-end): Drop needless .nr % assignment.
+	Call our (wrapped) bp instead of the .pl request directly.
+	(an-bp): Drop needless .br and (aliased) real .bp request.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-footer): Refactor complex conditional.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_X-register-works.sh: Add test for footer
+	creeping into page content.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (initialization): Ignore P and X rendering
+	parameter registers if specified with continuous rendering
+	enabled (the default in the nroff mode used for terminals), and
+	emit diagnostic.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_X-register-works.sh: Rewrite.  Increase test
+	coverage and stop assuming that -rcR=1 and -rX=anything is a
+	supported combination.  (Continuous rendering is supposed to
+	suppress the printing of page numbers anyway.)
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (initialization): Refactor handling of P and
+	X rendering parameter register validation in preparation for
+	disabling them in continuous rendering mode, where they don't
+	make any sense.
+
+2021-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_TH-repairs-ad-damage.sh: Tweak test
+	internals to make troubleshooting easier.
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Relocate some initialization logic to
+	be adjacent to (most of) the rest of it.
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Remove useless .if.  Its condition is
+	always true now in the wake of the fix for Savannah #60609.
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Rename many package macros, strings, and
+	registers (and the lone named environment) to be more expressive
+	of their function.  "an-footer" is now the proper complement of
+	"an-header" (setting up an environment and calling a
+	user-redefinable trap macro).
+	  an-first         -> an-is-first-page-of-document
+	  an-html          -> an-is-output-html
+	  an-footer        -> an-break-body-text
+	  an-p-footer      -> an-footer
+	  an-set-margin    -> an-reset-margin-and-inset-level
+	  an-level         -> an-inset-level
+	  an-tag-sep       -> an-tag-separation
+	  an-no-space-flag -> an-need-no-space-mode
+	  an-break-flag    -> an-need-break
+	  an-div?          -> an-is-in-diversion
+	  an-page-string   -> an-outer-footer-text
+	  an-trap          -> an-input-trap
+	  an-do-tag        -> an-write-paragraph-tag
+	  an-1             -> an-env
+
+	* tmac/andoc.tmac (reload-doc): ...as above for the exposed
+	parts of the interface.
+	  an-footer        -> an-break-body-text
+	  an-p-footer      -> an-footer
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Rearrange alternating font macros to be in
+	alphabetical order (and the order documented in groff_man(7).
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Refactor alternating font macros.  These
+	macros are hard enough to understand without adding gratuitous
+	structural differences to the reader's burden.  Make their
+	implementations rigidly parallel.  Update comments.
+	(RI, IR, IB, BI, RB, BR): Always define the `an-result` string
+	as empty except for a dummy character '\&' for the sake of
+	compatibility mode.
+	(RI, IR, IB, BI): Defer interpolation of the first argument to
+	the while loop if there are at least two (like the existing RB,
+	BR).  This way the style name arguments to the font selection
+	escape sequences in the appendment to `an-result` match the
+	order of the letters in the macro name (useful to make sense of
+	diffs).
+	(RI, IR, IB, BI, RB, BR): Always remove the `an-result` string
+	after interpolating it.
+	(RB, BR): Only do work if there are any arguments.
+
+2021-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Apply italic corrections more consistently.
+
+	* tmac/an-old.tmac (BI, IB, IR, RI): Apply italic corrections
+	more consistently.  Add lengthy comment rationalizing approach.
+	(RI, BI): An italic correction is now applied after the last
+	argument if it is of even parity (i.e., the 2nd, 4th, 6th, ...).
+
+	* tmac/groff_man.7.man.in (Description/Font style macros): Note
+	that italic corrections are applied.
+
+	Fixes <https://savannah.gnu.org/bugs/?53541>.
+
+	Thanks to Bjarni Ingi Gislason for the report and a suggested
+	patch.
+
+2021-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Ignore FT register when appropriate.
+
+	* tmac/an-old.tmac (initialization): Validate user-specified
+	value of \nFT.  Continuous rendering ignores FT (page location
+	traps are not used for footers in that mode).  Measuring a
+	footer distance from the page top isn't done.  A footer distance
+	of over half the page length is unlikely.  A footer distance of
+	less than one line height is too.  Issue diagnostics in all of
+	these cases.
+
+	* tmac/tests/tmac/tests/\
+	an-old_FT-bad-value-should-not-trash-titles.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?60612>.
+
+2021-05-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Plant the an-footer trap (where we
+	schedule a break in the page text prior to spacing down to the
+	footer) at twice the value of \nFT, not a hard-coded -1i.
+	This way, the user can't make the an-p-footer trap (planted at
+	\nFT) spring before the an-footer trap that should precede it.
+
+	* tmac/groff_man.7.man.in (Options) <-rFT>: Document this.
+
+2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_GHOSTSCRIPT_VERSION_CHECK): Add new
+	autoconf macro to check Ghostscript version.  Versions 9.00 <= x
+	< 9.54 suffer from a rendering glitch that affects the AT&T
+	troff (and groff) special character \(lh; see
+	<https://bugs.ghostscript.com/show_bug.cgi?id=703187>.  Store
+	the result of the check.
+	(GROFF_GHOSTSCRIPT_VERSION_NOTICE): Add new macro to report the
+	problem detected by GROFF_GHOSTSCRIPT_VERSION_CHECK to the user.
+
+	* configure.ac: Call the macros in appropriate places.
+
+	Fixes <https://savannah.gnu.org/bugs/?59531>.
+
+2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/andoc.tmac (reload-man): Remove removal of RI macro, made
+	unnecessary by commit 551f138 (15 May).
+
+2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_HTML_PROGRAMS, GROFF_PDFDOC_PROGRAMS):
+	Tweak autoconf warning messages when Ghostscript (gs) command
+	missing to be more mutually congruent.
+	(GROFF_URW_FONTS_CHECK): Tweak to note that gs is only run to
+	locate the URW fonts if gs is available.
+
+2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_AT-and-UC-footer-saved-and-restored.sh:
+	Tweak to be more helpful when troubleshooting exasperating
+	header/footer problems as in Savannah #60609.
+
+2021-05-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Fix missing page footers when continuously rendering
+	multiple documents.  Resolving this uncovered entangled header
+	and footer management bugs with batch processing even when _not_
+	continuously rendering.
+
+	* tmac/an-old.tmac (an-start-new-document): New macro clears
+	header trap so it doesn't get called with stale information.
+	{The TH macro already replants a header trap with every man
+	page if not continuously rendering.}  This macro also absorbs
+	the break-page and page number incrementation logic from TH.
+	(TH): Adapt semantics of "an-first" register to mean not "first
+	page rendered" (apparently) but "first page of new document".
+	If we are _not_ on the first page of a new document and the TH
+	macro is called, we must be batch processing: force the previous
+	man page to end (call an-end if continuously rendering, or
+	an-start-new-document if not).  After all the header and footer
+	strings have been configured for the man page, call an-header if
+	we're on the first page of the document, not (just) if we're
+	continuously rendering.  Zero an-first register at end of macro
+	here unconditionally instead of conditionally in .an-header.
+	(an-header): Drop conditional on continuous rendering.
+
+	When I batch-render our 62 man pages to the terminal, I do note
+	one cosmetic regression: the lj4_font(5) page, when continuously
+	rendered in batch processing, has no space between its header
+	line and first section heading ("Name").  Another cosmetic issue
+	in this scenario is that the footers for every rendered page but
+	the last, which had (wrongly) been absent entirely, are set with
+	no space after them and the header of the next.
+
+	* tmac/tests/an-old_page-footers-present.sh:
+	* tmac/tests/an-old_page-header-has-current-data.sh: Add man
+	page header/footer regression tests.
+	* tmac/tmac.am (tmac_TESTS): Run the tests.
+
+	Fixes <https://savannah.gnu.org/bugs/?60609>.
+
+2021-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (initialization): Key the reprocessing guard
+	{like a C language #include guard} on the existence of the TH
+	macro instead of RI.  The latter seemed kind of random and TH
+	is even more guaranteed to exist; it is the macro name most
+	characteristic of the man(7) language and the andoc.tmac
+	superstructure relies on it.  (TH may have been avoided because
+	of its use with tbl(1); however, neither man(7) nor mdoc(7)
+	support tbl's TH feature, and GNU tbl does not supply its own
+	empty fallback definition as it does for TS and TE.  If we ever
+	want TH-like functionality in future man pages, I suggest we
+	pick a new, non-colliding name for it.)
+	(initialization): Relocate load of devtag package; we don't
+	need it before entering compatibility mode.  Move assignment of
+	format of an-page-letter register from a "loose declaration"
+	amid macro definitions to within existence test of X register.
+	Stop initializing an-extra123 strings outside of any macro;
+	they need to be reinitialized at every TH call when batch
+	rendering.
+	(TH): Call DT in a less surprising place.
+	(TH): Initialize all header/footer-related strings before
+	calling header macros, even those not needed for the default
+	header configuration.
+	(TH): Add style warnings for underspecified arguments.
+	(an-ne): Rename register from "an-need", which is pretty
+	confusing in context, to "an-amount", since (1) a (vertical)
+	amount is what it is, and (2) it's only used within this macro.
+	Also due to factor (2), remove the register after using it.
+
+2021-05-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_URW_FONTS): Update configure script check
+	for URW fonts to recognize recent releases of the URW Base 35
+	fonts from Artifex Software.  Look for the AR (Arial roman
+	equivalent) font under all of the names recognized by
+	fonts/devpdf/Foundry.in.
+	* m4/groff.m4 (GROFF_URW_FONTS_CHECK): Update wording of notice
+	when URW fonts are not found.  Replace dead URL with working
+	one.  Try to hedge against the future, but the Web is an
+	ephemeral place, as are the file names Artifex gives to its
+	fonts.  Thanks to T. Kurt Bond and Thomas Dupond for reporting
+	and investigating the problem.
+
+	Fixes <https://savannah.gnu.org/bugs/?60604>.
+
+2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (ms Document Control Settings) <DI>:
+	* doc/ms.ms (Document control settings, Displays and keeps)
+	<DI>:
+	* tmac/groff_ms.7.man (Document control settings, Displays and
+	keeps) <DI>: Document this register; it had been mentioned only
+	in passing.
+
+2021-05-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (ms Document Control Settings) <DD>:
+	* doc/ms.ms (Document control settings) <DD>:
+	* tmac/groff_ms.7.man (Document control settings) <DD>: Fix
+	error; changes to \nDD take effect at the next display
+	boundary (including the end of the active one), not the next
+	"paragraph" (paragraph macros cannot be called inside a display
+	anyway).
+
+2021-05-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/andoc.tmac (reload-man): Delete no-op line that attempts
+	to restore compatibility mode.  Individual pages have to do
+	this, and ".do cp \n(.C" is not effective for the reason
+	discussed in the 2020-04-16 ChangeLog entry.
+
+2021-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (@RT): Delete definition; make it an alias for
+	par@finish.  Until commit 021ba0e7 (1 May), they had identical
+	definitions.  I find it difficult to imagine what use it would
+	be to have an undocumented reset macro that resets everything
+	_except_ the deeply internal \n.ev:ai.
+
+2021-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: Handle HF strings with an embedded font family when
+	applying italic-to-bold-italic remapping; the feature now works
+	on troff devices as well.
+
+	* tmac/an-old.tmac (initialization): Do more validity checking.
+	Store heading family in new string \*an-heading-family.  Clean
+	up after self.
+	(SH, SS): Include the heading family in the remapping target.
+
+	* tmac/groff_man.7.man.in (Description/Document structure
+	macros) <.SH, .SS>: Document it.
+
+2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_char.7.man (Glyph tables/Mathematical symbols): Fix
+	errors in special character descriptions; \sqrt is a "special"
+	glyph (that is, it uses mathematical metrics on typesetter
+	devices), and \radicalex) is not (and is thus a "text" glyph).
+	See Werner Lemberg's ChangeLog entry of 2003-01-05.  Problem
+	dates to 07a6233ad, 27 May 2014.
+
+	The overloaded use of the word "special" really pinches here.
+
+2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tty.tmac: Replace fallback glyphs for radical extension
+	and square root extension; use \rn instead, which works fine.
+
+	Now the only glyph in the page that doesn't render on a UTF-8
+	terminal (if one's font has adequate coverage) is the Bell
+	System logo.
+
+2021-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tty.char: Add fallback characters for \fm and \sd.
+
+2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man: If \*HF is a bold style, substitute bold italics for
+	italics in section and subsection headings, keeping the font
+	weight consistent.
+
+	* tmac/an-old.tmac (initialization): Set a flag for this based
+	on the interpolation of \*HF matching "B" as its last
+	character.
+	(SH, SS): Apply and reverse font remapping based on this flag.
+
+2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac (EX): Work around Savannah #59522 by changing
+	fonts differently on DVI output, avoiding a font warning.
+
+2021-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac: If in nroff mode, remap font CBI to BI.
+	* tmac/dvi.tmac: Remap font CBI to CWI.  (Computer Modern
+	Constant Width has no bold styles.)
+
+2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (NL, SM, LG): Issue warning diagnostic if macro
+	called with arguments.
+	(par*define-font-macro): Construct font macro with diagnostic to
+	warn if called with excess arguments.
+	(UL, BX): Issue warning diagnostic if macro called with excess
+	arguments.
+
+	Fixes <https://savannah.gnu.org/bugs/?60522>.
+
+2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi: Delete redefinition of \putwordAppendix
+	Texinfo macro.  This restores the word "Appendix" to the names
+	of all appendices and fixes two bad internal links to Appendix
+	E, the Register Index, in the DVI and PDF output formats.  Per
+	consultation with Texinfo maintainer Gavin Smith, it's difficult
+	to get the behavior we want, so give up trying for now.
+
+2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (@MC): Actually diagnose and recover when user
+	tries to .MC inside a diversion.
+
+2021-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Differences from AT&T ms):
+	* doc/ms.ms (Differences from AT&T ms):
+	* tmac/groff_ms.7.man (Differences from AT&T ms): Document our
+	different default (empty) for the center footer in nroff mode;
+	this behavior appears to date back to June 1991 or earlier,
+	drawing few complaints.
+
+	Fixes <https://savannah.gnu.org/bugs/?59826>.
+
+2021-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/*: Rename files to use consistent scheme; one
+	underscore to separate the package name from the test objective,
+	dashes to otherwise separate words.
+	* tmac/tmac.am (tmac_TESTS): Use new names.
+
+2021-05-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Restore support for AT&T ms PN register.
+
+	* tmac/s.tmac (pg): Make register PN an alias of %.
+
+	* doc/groff.texi (Differences from AT&T ms):
+	* doc/ms.ms (Differences from AT&T ms):
+	* tmac/groff_ms.7.man (Differences from troff ms): We don't need
+	PN, and it was removed in commit 08291b40 (25 October 2020), but
+	since it is documented in Lesk 1978 we're stuck with it.  Advise
+	users to stick with %.  Also warn them of the hoop they must
+	jump through if they redefine the page trap macro PT, which Lesk
+	1978 also encourages.
+
+	* tmac/tests/s_PN-works.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?59823>.
+
+2021-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Restore default IP paragraph indentation after an SH call.
+
+	* tmac/s.tmac (par@finish): Set "ai" register for the current
+	environment to the paragraph indent (PI) setting for the current
+	environment.
+
+	* doc/groff.texi (Highlighting in ms) <IP>:
+	* doc/ms.ms (Highlighting) <IP>:
+	* tmac/groff_ms.7.man (Usage/Highlighting) <IP>: Update
+	documentation.
+
+	* tmac/tests/s_SH_resets_IP_indentation_amount: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?60222>.
+
+2021-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (DS): Issue diagnostic and attempt recovery if
+	document attempts to start a display within another display.
+
+	Fixes <https://savannah.gnu.org/bugs/?55136>.
+
+2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Implement alternative rendering for automatic
+	footnote numbers in nroff mode, inspired by Heirloom Doctools
+	ms; since superscripting is not universally available on
+	terminals, surround number with square brackets instead.
+	(fn@init): New macro finishes initializing footnote module,
+	setting up aliases to par@sup-{start,end} strings in troff mode
+	and otherwise defining fn@sup-{start,end} as brackets.  Define *
+	string here, using new strings.
+	(par): Call fn@init after par@sup-{start,end} are defined, and
+	prior to other footnote integration material.
+	(par*fp!0): Migrate from par@sup-{start,end} to
+	fn@sup-{start,end}.
+
+	* doc/groff.texi (ms Document Control Settings) <FF>:
+	* doc/ms.ms (Footnotes) <FF>:
+	* tmac/groff_ms.7.man (Usage/Footnotes) <FF>: Document it.
+
+	Fixes <https://savannah.gnu.org/bugs/?60228>.
+
+2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* test-groff.in: Stop passing the built groff executable -b and
+	-ww options by default.  This reverses a change from 2017.  Dave
+	Kemper has convincingly argued that there's no way to override
+	-b and turn backtraces on warnings/errors back off, and that the
+	built groff should behave as much like a "normal" one as
+	possible.  The latter factor is of added importance now that we
+	are using test-groff for generation of documents.
+
+	* src/roff/groff/tests/regression_savannah_58153.sh: Adapt.
+
+2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (BX): Add alternative implementation for terminal
+	{nroff} devices.  Store width of boxed text, adding .4m only on
+	troff devices (to make room for the vertical box lines).  Break
+	long input line in troff implementation.  If not in troff mode,
+	use ISO 6429 color escapes to render boxed text in black on
+	white.  Use the \Z escape to match breaking semantics of macro
+	in troff mode.
+
+	* doc/groff.texi (Highlighting in ms) <BX>:
+	* doc/ms.ms (Highlighting) <BX>:
+	* tmac/groff_ms.7.man (Usage/Highlighting) <BX>: Document it.
+
+	Fixes <https://savannah.gnu.org/bugs/?60477>.
+
+2021-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Make $(PROCESSEDDOCFILES) depend on all the same
+	targets as $(PROCESSEDEXAMPLEFILES); this way the me, ms, and
+	pic.ms manuals are all regenerated upon changes to their
+	underlying macro packages.
+
+2021-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* INSTALL.extra: Update.
+	(Evaluation): New section updates material on "test-groff"
+	script.  Also tell people how to preview our Texinfo manual (in
+	info, text, DVI, PDF, and HTML formats).
+	(In Case of Trouble): New section updates bug reporting URL.
+
+	Fixes <https://savannah.gnu.org/bugs/?57863>.
+
+2021-04-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Make the FAM string work more sensibly; it now
+	applies to headers, footers, and footnotes only if set
+	before the first call of a sectioning, paragraphing, or
+	{non-date} document description macro.
+	(PT, BT): Set the font family to that saved for titles.
+	(fn*do-FS): Set the font family to that saved for footnotes.
+	(par@init): Copy the document font family to independent strings
+	for titles and footnotes.
+	(par@reset): If in a footnote environment, set the font family
+	to that saved for footnotes; otherwise use \*FAM.
+
+	* tmac/groff_ms.7.man (Differences from troff ms/Text settings):
+	Describe placement-dependent effect of FAM string setting.
+
+	* doc/groff.texi (Highlighting in ms):
+	* doc/ms.ms (Highlighting): As above, and suggest different
+	occasions in which ".ds FAM C" and "CW" are convenient.
+
+	Fixes <https://savannah.gnu.org/bugs/?60422>.
+
+2021-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (source, source_quietly)
+	(macro_source, macro_source_quietly): Use idiomatic Boolean
+	literals.
+
+2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi: Drop workarounds for Texinfo pre-5.0 versions;
+	our local macros produced many warnings during generation of our
+	Texinfo manual.
+	(Langlemacro):
+	(Ranglemacro):
+	(Lparenmacro):
+	(Rparenmacro):
+	(Lbrackmacro):
+	(Rbrackmacro): Delete.  Replace call sites with literals.
+	(Lbracemacro):
+	(Rbracemacro): Delete.  Replace call sites with @lbracechar{}
+	and @rbracechar{}.
+	(angles): Reimplement in terms of @guilsinglleft{} and
+	@guilsinglright{}.  Flesh out comment.
+
+	Fixes remainder of <https://savannah.gnu.org/bugs/?59524>.
+
+2021-04-17  Dave Kemper <saint.snit@gmail.com>
+
+	* doc/meintro.me:
+	* doc/meref.me: Correct and make consistent usage of the term
+	"point size".
+
+	Fixes <https://savannah.gnu.org/bugs/?60403>.
+
+2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (SS): Add devtags support.  Set a subsection
+	title as a second-level heading and add it to a table of
+	contents, if any.  Prompted by a query from Hans Unzner to the
+	groff mailing list.  Thanks, Hans!
+
+2021-04-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (SH): Fix apparent thinko.  Pass the devtags
+	macro a literal "1" argument.  Passing it \nan-level wasn't
+	correct (it stores the relative inset level, not a sectioning
+	level), and was useless anyway: SH has already called
+	.an-set-margin by this point, which resets \nan-level to 1.
+	man(7) does not support nesting of SH macros.  Also call
+	.DEVTAG-NH by its alias .DEVTAG-SH since section headings are
+	not numbered in man(7).
+
+2021-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac: Adjust editor file encoding hints.
+
+	* tmac/cs.tmac: Tell Vim the file is "iso-8859-2" (ISO Latin-2).
+	* tmac/en.tmac: Stop telling Emacs the file is "latin-1"; it's
+	ASCII.
+	* tmac/fr.tmac: Tell Vim file is "iso-8859-15" (ISO Latin-9).
+
+	Vim users may need to use ":e ++enc=iso-8859-2", for instance,
+	to see correct glyphs.
+
+2021-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	The first-order determinant of hyphenation points is language,
+	not territory.  Use ISO 639 2-letter language codes for
+	hyphenation and exception patterns instead of ISO 3166 2-letter
+	territory codes.
+
+	* tmac/*.us: Rename *.us files to *.en.
+	* tmac/troffrc: Change hyphenation language "us" to "en".
+	* tmac/en.tmac: Add English localization file.  Set hyphenation
+	mode to 4.
+	* tmac/troffrc: Derive groff locale from system.
+
+	* doc/groff.texi (Manipulating Hyphenation):
+	* man/groff.7.man (Hyphenation):
+	* man/groff_diff.7.man (Implementation differences): Refer to
+	"U.S. English" hyphenation patterns as simply "English"; they
+	will be mostly correct for Commonwealth English as well, and no
+	alternative English hyphenation patterns for other territories
+	are available.
+
+	* doc/groff.texi (Manipulating Hyphenation):
+	* man/groff_diff.7.man (New requests): Note that default
+	hyphenation mode depends on the language used on the system.
+	Add concept index entry for localization.  Add file index
+	entries for the locale macro files (cs.tmac, etc.).  Update to
+	reflect rename of English hyphenation patterns and .hla
+	identifier from "us" to "en".
+
+	* src/roff/groff/tests/localization_works.sh: Add 10 test cases.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	* tmac/LOCALIZATION: Rewrite.
+
+	Fixes <https://savannah.gnu.org/bugs/?59814>.
+
+2021-04-12  Dave Kemper <saint.snit@gmail.com>
+
+	* doc/meref.me: Correct various small issues.
+
+	Fixes <https://savannah.gnu.org/bugs/?60379>.
+
+2021-04-12  Dave Kemper <saint.snit@gmail.com>
+
+	* man/groff.7.man (Registers/Writable registers) <year, yr>:
+	Drop discussion of Y2K issues.
+
+	Fixes <https://savannah.gnu.org/bugs/?60372>.
+
+2021-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Setting Registers) <rnn>: Fix error: the
+	request is not ignored if the second argument (the new name)
+	does not exist.  Problem dates back to 52a6d12a (11 May 2000).
+
+2021-04-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Implement new .soquiet and .msoquiet requests.
+
+	Needed for two planned developments: {1} the i18n patch in
+	Savannah #59814 can use this to quietly attempt to open a
+	localization file.  groff only supports a few locales, so people
+	with LANG=es_ES, for instance, would ordinarily see warning
+	diagnostics on every groff startup; and {2} system- or
+	site-configurable support of per-user {.,}troffrc or man.local
+	files, gracefully failing if they don't exist.
+
+	* src/roff/troff/input.cpp:
+	(do_source): Add new function, taking boolean "quietly"
+	parameter and absorbing function of source(), with added
+	conditional.
+	(source): Convert into a wrapper to call do_source() unquietly.
+	(source_quietly): Wrap do_source(), quietly.
+	(do_macro_source, macro_source, macro_source_quietly): Analogous
+	to the foregoing.
+	(init_requests): Hook "msoquiet" to macro_source_quietly() and
+	"soquiet" to "source_quietly().
+
+	* doc/groff.texi (I/O):
+	* man/groff.7.man (Requests/Request short reference):
+	* man/groff_diff.7.man (Language/New requests): Document them.
+
+	* src/roff/groff/tests/msoquiet_works.sh:
+	* src/roff/groff/tests/soquiet_works.sh: Test them.
+
+	* src/roff/groff/groff.am (groff_TESTS): Add tests.
+
+	Fixes <https://savannah.gnu.org/bugs/?59973>.
+
+2021-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (ms Document Control Settings) <FF>: Update
+	description to cover application of footnote format to footnote
+	markers in general, not just numbers.  Clarify different
+	behavior of format 1 with respect to automatic numbers and other
+	markers.
+	(ms Footnotes) <*>: Describe string operation in more detail.
+	<FS>: Describe more precisely how the optional argument is
+	handled.
 
-	Fix appearance of groff.texinfo's HTML output.
+	* doc/ms.ms (Footnotes): Synchronize with doc/groff.texi.  Add
+	example using document's own text as a model.
 
-	Cartouches within an `example' environment don't work.
+	* tmac/groff_ms.7.man (Usage/Footnotes): Resync relevant
+	portions with doc/ms.ms.
 
-	* doc/groff.texinfo (CartoucheExample, endCartoucheExample): New
-	macros.  Use them where appropriate.
+	Fixes <https://savannah.gnu.org/bugs/?60227>.
 
-2012-07-17  Ingo Schwarze  <schwarze@usta.de>
+2021-04-06  Dave Kemper <saint.snit@gmail.com>
 
-	mdoc Make `Fl' correctly restore fonts.
+	* src/roff/nroff/nroff.sh: Recognize -k and -K options and pass
+	them through to troff.  Document them in usage message.
+	* src/roff/nroff/nroff.1.man: Document new -k and -K options.
 
-	* tmac/doc.tmac (doc-flag-recursion): Do it.
+	Fixes <https://savannah.gnu.org/bugs/?60349>.
 
-2012-07-07  Eric S. Raymond  <esr@thyrsus.com>
+2021-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/eqn.man, src/preproc/grn/grnn.man,
-	src/devices/grodvi/grodvi.man, src/devices/grolj4/grolj4.man,
-	src/devices/grops/grops.man, src/utils/lkbib/lkbib.man,
-	src/utils/indxbib/indxbib.man, src/utils/tfmtodit/tfmtodit.man,
-	src/utils/xtotroff/xtotroff.man:
-	Remove running text in the synopses of various manual pages,
-	as it badly screws up attempts to mechanically parse them.
+	* doc/groff.texi (Manipulating Hyphenation):
+	Recast introductory paragraph to better distinguish the
+	automatic breaking of words and placement of hyphens at
+	user-specified hyphenation points (done with the \% escape) and
+	automatic determination of hyphenation points within words (what
+	the pattern files and most of the hyphenation mode parameters
+	are for).  Clarify that what our manual calls "automatic
+	hyphenation" pertains only to the latter.
+	<hw> Correct over-general claim; hyphenation exceptions defined
+	with the .hw request _do_ honor .hy value 2 (don't break a word
+	at the bottom of a page), but none of the others.
+	<\%> Recast description of escape to emphasize independence of
+	its two uses (e.g., "\%pseudo\%unununium" is hyphenated only
+	after "pseudo-", if at all).
+	<\:> Clarify that escape is an input word boundary.
+	<shc> Clarify that the soft hyphen glyph is applied to manual as
+	well as automatically-determined hyphenation points.
+	<hy> Recharacterize as setting the _automatic_ hyphenation mode.
+	Note that restrictions apart from value 2 are not applied to
+	words with manually-assigned hyphenation points.
+	<nh> Note that request affects only automatic hyphenation.
 
-	* contrib/mom/groff_mom.man: Use .URL rather than .UR/.UE, as this
-	is now preferred for manual pages.
+	* man/groff.7.man (Requests/Request short reference) <.hy,.nh>:
+	Clarify that requests deal with _automatic_ hyphenation.
+	(Registers/Read-only registers) <.hy>:
+	Clarify that register applies to _automatic_ hyphenation.
+	(Hyphenation): Add new introductory paragraph summarizing manual
+	hyphenation support and features, including notice that breaking
+	at explicit hyphens is performed in fill mode, i.e., even if
+	_automatic_ hyphenation is disabled.
 
-2012-07-03  Werner LEMBERG  <wl@gnu.org>
+	Thanks to Peter Schaffter for the report.
 
-	Fix Unicode mapping of Greek stroked and curly phi.
+	Fixes <https://savannah.gnu.org/bugs/?60332>.
 
-	Problem reported by Alkis Georgopoulos <alkisg@gmail.com>;
-	see
+2021-03-27  Deri James  <deri@chuzzlewit.myzen.co.uk>
 
-	https://bugs.launchpad.net/ubuntu/+source/groff/+bug/1008115
+	Changes to the ghostscript fontnames (9.53.3).
 
-	* src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Flip
-	values of U+03C6 and U+03D5.
+	* font/devpdf/Foundry.in: HI and HBI switch to using
+	Italic rather than Oblique.
 
-2012-06-13  Deri James  <deri@chuzzlewit.demon.co.uk>
+2021-03-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.pl: When using variable page
-	sizes (with \X'papersize ...') ensure final page is correct
-	size.
+	* doc/groff.texi (Manipulating Filling and Adjustment):
+	* man/groff_diff.7.man (Language/Extended requests): Fix
+	incorrect claim that additional inter-sentence space is applied
+	only in fill mode.  Drop word "parameter" from description of
+	unit used in .ss request arguments; it is a needlessly specific
+	reference to the font file format.  Tighten wording.
 
-2012-05-24  Werner LEMBERG  <wl@gnu.org>
+	* man/groff.7.man (Control Characters): Fix incorrect claim that
+	end-of-sentence detection is attempted only in fill mode.  Note
+	that .ss request also affects inter-word spacing.
 
-	* src/roff/grog/grog.pl (process): Fix .so handling.
+	* man/groff_diff.7.man (Language/Extended requests):
+	  - Drop example.
+	  - Move discussion of AT&T vs. GNU troff difference in .ss
+	    handling from here...
+	  (Implementation Differences): ...to here.
 
-	This does the same as the previous commit.
+	Thanks to Dave Kemper for his continued scrutiny!
 
-2012-05-24  Denis M. Wilson  <dmw@oxytropis.plus.com>
+2021-03-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/grog/grog.sh: Fix .so handling.
+	* doc/groff.texi (ms Cover Page Macros):
+	* doc/ms.ms (Cover page macros):
+	* tmac/groff_ms.7.man (Usage/Cover page macros): Revise and
+	rename (sub)sections to "Document description macros".
+
+2021-03-15  Dave Kemper <saint.snit@gmail.com>
+
+	* Makefile.am: Fix typos.  Thanks to Bjarni Ingi Gislason for
+	the report.
+
+	Fixes <https://savannah.gnu.org/bugs/?59457>.
+
+2021-03-14  Dave Kemper <saint.snit@gmail.com>
+
+	* man/groff_tmac.5.man: Correct erroneous reference to PSPIC
+	where PDFPIC was intended.  Fix numerous smaller style and
+	content problems.
+
+	Fixes <https://savannah.gnu.org/bugs/?60229>.
+
+2021-03-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Optional man extensions) <CW, EX, PN, Pn>:
+	(Highlighting in ms) <CW>:
+	(Additional ms macros) <CW>: Use "monospaced" to refer to font
+	selected, retaining "constant-width" term only where it explains
+	the macro mnemonic.  Thanks to Dave Kemper for pointing out the
+	issue.  Also fix error: .CW in the ms package seems to have
+	originated with Research Unix, not Berkeley.
+
+	* doc/ms.ms (Highlighting) <CW>: Sync with our Texinfo manual.
+	* tmac/groff_ms.7.man: Sync with ms.ms, omitting FAM advice.
+
+	Fixes <https://savannah.gnu.org/bugs/?60037>.
+
+2021-03-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Identifiers, Strings, Writing Macros)
+	(Diversions): Improve cross-linkage of documentation regarding
+	shared name space of macros, strings, diversions, and boxes.
+
+	Fixes <https://savannah.gnu.org/bugs/?58995>.
+
+2021-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Improve diagnostic messages.
+	(@diag): New macro wraps .tm request, always prefixing it with
+	the name of the macro package, as well as file and line
+	indicators only if these are set to non-empty or non-zero
+	values, respectively.
+	(@error, @warning): Call @diag instead of .tm directly.
+	(@fatal): Retire; it had only one call site and it would have
+	greatly complicated @diag to support calling .ab instead of .tm.
+	An ugly alternative would have been to call .ab with a redundant
+	message after calling @diag.
+	(@divert): New macro wraps .di request, remembering the name of
+	the current file (\n.F) when a diversion is started.
+	(@error-recover): Call .ab instead of (deleted) @fatal.
+	(pg@super-eject): Tell user what the last file name seen was
+	when recovering from an unfinished diversion when processing
+	ends.
+
+	Fixes <https://savannah.gnu.org/bugs/?55099>.
+
+2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix bug where having line numbering off but the output line
+	number register \nln set to a positive value would cause
+	tbl(1) table rows to spontaneously become numbered.  Use new
+	\n.nm register to determine whether line numbering is enabled.
+
+	* src/preproc/tbl/table.cpp (table::init_output, table::do_row)
+	(table::do_bottom): Predicate all conditions on \nln
+	additionally on \n.nm.
+
+	Thanks to Olle Lögdahl for the report.  Problem appears to date
+	back to commit b69062693d3360efce9d4d63fac337be21e07db7, 20 July
+	2011.
+
+	Fixes <https://savannah.gnu.org/bugs/?59812>.
+
+2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #59812.
+
+	* src/preproc/tbl/tests/cooperate-with-nm-request.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.
+
+2021-02-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Implement new read-only register ".nm".  It reports the
+	enablement status of output line numbering (caused by the .nm
+	request) irrespective of the temporary suspension of numbering
+	with the .nn request.  Needed because there was no way to
+	introspect its state, tbl(1) needs to do so, and the writable
+	line number register \nln is not a reliable proxy for it.
+
+	* src/roff/troff/env.h: Add get_numbering_nodes(), returning
+	`int`, to public interface of `environment` class.
+	* src/roff/troff/env.cpp: Implement get_numbering_nodes().
+
+	* src/roff/groff/tests/dot-nm_register_works.sh: Test it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	* doc/groff.texi (Miscellaneous):
+	* man/groff_diff.7.man (Language/New number registers):
+	* man/groff.7.man (Registers/Read-only registers): Document it.
+
+	* NEWS: Add item.
+
+2021-02-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Emit warning diagnostic when using a multi-page
+	table with a repeating header (".TS H").
+	(KS): Rename diversion from "kp*div" to "kp@div" since the name
+	is now referenced outside the keep module.
+	(KF): ...similarly for kp@fdiv.
+	(generally): Update diversion dereference sites and derived
+	names.
+	(@TS): When handling "H" argument, check identity of current
+	diversion and emit appropriately worded warning.
+
+2021-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* FOR-RELEASE: Add more procedures and information related to
+	incrementing groff's version number.
+
+2021-02-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/searchpath.cpp (search_path::open_file)
+	(search_path::open_file_cautious): Save errno before calling
+	free() and restore it afterwards.  A future version of POSIX
+	will require that free() not change errno if it succeeds1;
+	some C library implementations, including recent versions of
+	glibc2, lack this property.  free() is called in these
+	libgroff functions to clean up after an unsuccessful fopen() of
+	a heap-allocated file name string, and because the errno from
+	fopen() may be passed to strerror() in a diagnostic message, it
+	needs to be accurate.  I checked the rest of groff's codebase
+	and found no other instances of free() being used to clean up
+	after fopen() failure.
+
+	1 https://www.austingroupbugs.net/view.php?id=385
+	2 https://sourceware.org/bugzilla/attachment.cgi?id=13073
+
+2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Address build failure on macOS.
+
+	Follow the advice of the gnulib manual ("Changing your source
+	for use with gnulib") more scrupulously; include config.h in
+	more files.
+
+	* src/libs/libgroff/curtime.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/device.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/fatal.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/string.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/strsave.cpp HAVE_CONFIG_H:
+	* src/preproc/eqn/other.cpp HAVE_CONFIG_H:
+	* src/preproc/eqn/text.cpp HAVE_CONFIG_H:
+	* src/preproc/pic/object.cpp HAVE_CONFIG_H: Do it.
+
+	* src/libs/libgroff/assert.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/errarg.cpp HAVE_CONFIG_H:
+	* src/libs/libgroff/error.cpp HAVE_CONFIG_H: #include
+	config.h using angle brackets instead of quotation marks.
+
+	Fixes <https://savannah.gnu.org/bugs/?60035>.
+
+2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #60025.
+
+	* tmac/tests/doc_Mt-works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2021-02-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	ms: Demote definition of \yogh special character escape from
+	unconditional availability to be defined only if the output
+	device defines it or if .AM macro is called to enable support
+	for Berkeley-style accent marks.
 
 	See
+	  https://lists.gnu.org/archive/html/groff/2021-01/msg00000.html
+	and follow-ups for discussion.
 
-	http://lists.gnu.org/archive/html/bug-groff/2012-05/msg00000.html
+	* tmac/s.tmac (initialization): Move definition of \yogh (only
+	if the output device doesn't already define it) from here...
+	(AM): ...to here.
 
-	for the report and the bug fix.
+2021-02-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-05-24  Ivan Shmakov  <oneingray@gmail.com>
+	* doc/ms.ms: Use \ps special character instead of local
+	character definition using numeric code point escape, which is
+	less portable.
 
-	Add some generic fallback characters.
+	Fixes <https://savannah.gnu.org/bugs/?59528>.  Thanks to Bjarni
+	Ingi Gislason for the report and a suggested patch.
 
-	* tmac/fallbacks.tmac: New file.
-	* tmac/troffrc: Include it.
-	* tmac/Makefile.sub (NORMALFILES): Include it.
+2021-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-05-20  Deri James  <deri@chuzzlewit.demon.co.uk>
+	* tmac/s.tmac (initialization): Call par*define-font-macro with
+	arguments "CW" and "R" in nroff mode to silence font warnings
+	from documents using .CW macro in nroff mode.
 
-	* doc/groff.texinfo: Add extra info about `.asciify'.
-	Document new gropdf options -u and -s.
+2021-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/gropdf/gropdf.man: Remove references to Type 42
-	fonts, they do not work in PDFs.
+	* src/preproc/tbl/table.cpp (table::init_output): Save value of
+	hyphenation maximum consecutive line count register (\n.hlm)
+	more carefully to keep it from being incorrectly parsed as a
+	decrement, because negative values of \n.hlm are valid (in
+	fact, "-1" is the default).  In documents with a large number of
+	tables, this can lead to a Persian chessboard problem and an
+	integer overflow (at the groff language level, caught and
+	handled by src/roff/troff/number.cpp:parse_term()).
 
-	Document new option -s which adds `statistics' line to end of PDF
-	file showing number of pages in document.  This has always been
-	the default behaviour (to add this line), all other software seems
-	to ignore it as intended, but `gs' sometimes complains, so the
-	default is now to omit the statistics.
+	It is wise to wrap a non-literal second argument to the .nr
+	request in parentheses if assignment is desired and its value
+	can be negative.  See section 5.6.1 ("Setting Registers") of the
+	groff Texinfo manual.
 
-	Document new option -ucmapfilename to allow a user ToUnicode
-	CMap instead of gropdf's default.  If no `cmapfilename' given then
-	do not include any ToUnicode CMap.
+	Fixes <https://savannah.gnu.org/bugs/?59993>.
 
-	* src/devices/gropdf/gropdf.pl <top>: Allow `bundled' flags on
-	command line (i.e. -de = -d -e).
+2021-02-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Use $RT_SEP as multi path separator, not hard coded `:'.  Update
-	all users.
+	* test-groff.in: Add support for rfc1345.tmac.
 
-	New flags -u and -s.  Once a custom papersize has been set as
-	\X'papersize x,y' make it sticky so all following pages use custom
-	size.  When importing pdf with \X'pdf: pdfpic ...' do not compress
-	objects which are already compressed! This caused problems with
-	PDFs created with ImageMagick, now fixed.
+2021-02-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	(IsText, PutLine, do_t): The troff `u' command can contain a
-	kerning adjustment number, this was not being handled, now fixed.
+	Integrate rfc1345.tmac into build system.
 
-	(do_c): The troff `c' command was not being handled correctly, now
-	fixed.
-	(FindChar, RemapChr, do_N): Handle fonts with more than 255 glyphs.
-	($ucmap): Define CMap ToUnicode to convert ligatures
-	(fl,fi,ff,ffl,ffi) back to individual characters, useful for
-	cut'n'paste and text searching.
-	(LoadFont): Handle it.
-	(ToPoints, GetPoints): Handle `z' unit.
-	(do_x, FixPDFColour, PutHotSpot): Allow Annotation colour to be
-	groff colour, i.e. 0-65535 *3, or #rrggbb, or #rrrrbbbbgggg.
-	(do_p):The papersize width/length in switch -p were reversed,
-	corrected.
+	* contrib/rfc1345/rfc1345.am: Do it.
+	* Makefile.am: Include contrib/rfc1345/rfc1345.am.
 
-	* src/devices/gropdf/Makefile.sub (gropdf): Use $RT_SEP.
-	Use $fontpath rather than $fontdir (this ensures site-font is
-	included in searches).
+2021-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/pdf.tmac (PDFBOOKMARK.VIEW, PDFHREF.VIEW, PDFPAGE.Y): Fix
-	strings.
-	(pdfbookmark): Correct handling of bookmark levels.
-	Convert \em to hyphen in bookmarks
+	* src/roff/troff/input.cpp (open_mac_file): Report problem when
+	attempting to open macro files (-m arguments) and the error is
+	something other than ENOENT.
+	(process_macro_file): Update diagnostic to be more precise; the
+	file couldn't be _opened_, not necessarily _found_, and clarify
+	that the string being reported back to the user is the argument
+	to the -m option, not a file name.
+	(macro_source): Update diagnostic to report that the file
+	couldn't be _opened_, not necessarily _found_, and include the
+	nature of the problem.
+
+2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tbl: Save and restore hyphenation parameters.
+
+	* src/preproc/tbl/table.cpp (table::init_output): When starting
+	a table, save the hyphenation parameters (\n.hy, \n.hla,
+	\n.hlm, \n.hym, \n.hys).  Restore them in the table reset
+	macro (confusingly called "3init"), which is called before
+	performing each diversion and before exiting a table.
 
-	Rather use -N than -T for "named" bookmarks (-T already used for
-	"tag" in pdfmark.tmac)
+	This enables people to, e.g., turn off hyphenation in a table
+	text block with .nh, just as they can turn off adjustment with
+	.na, without having to manually reset it.  The next text block,
+	and the material after the table, will not be affected.
 
-	(.pdfclean): New macro which attempts to asciify bookmark text.
-	(.pdfpagename): New wrapper macro for \X'pdf: pagename'.
-	(.pdfswitchtopage): New wrapper macro for \X'pdf: switchtopage'.
+	Fixes <https://savannah.gnu.org/bugs/?59971>.
 
-2012-03-10  Werner LEMBERG  <wl@gnu.org>
+2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix compiler warnings.
+	Add regression test for Savannah #59971.
 
-	* src/preproc/html/pre-html.cpp (alterDeviceTo): Avoid ambiguous
-	if-else clause.
+	* src/preproc/tbl/tests/\
+	save-and-restore-hyphenation-parameters.sh: Do it.
+	* src/preproc/tbl/tbl.am (tbl_TEST): Run test.
 
-	* src/preproc/grn/main.cpp (sccsid): Comment out.
+2021-01-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/roff/troff/number.cpp (parse_expr) <case '*'>: Add cast.
+	* tmac/tmac.am ($(TMACSTRIPFILES)):
+	($(TMACMDOCSTRIPFILES)): Remove unidiomatic for loop which
+	frustrated parallel make operation.
 
-	* src/devices/xditview/Makefile.sub (EXTRA_CFLAGS): Add `-Dlint'
-	so that unused static ID arrays don't cause a warning.
+	Thanks to an anonymous contributor for the report and patch.
 
-	(Some) problems reported by Bjarni Ingi Gislason
-	<bjarniig@rhi.hi.is>.
+	Fixes <https://savannah.gnu.org/bugs/?59958>.
 
-2012-03-05  Werner LEMBERG  <wl@gnu.org>
+2021-01-29  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/an-ext.tmac (SY): Handle argument with spaces correctly.
+	* doc/ms.ms (Document control settings): Document old FAM string
+	and new FR string.
 
-	Problem reported by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>.
+2021-01-29  T. Kurt Bond <tkurtbond@gmail.com>
 
-2012-03-01  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+	ms: Add new string FR to hold an expression for computing the
+	footnote length relative to the line length, consistently for
+	single- and multi-column modes, which \nFL has never done.
 
-	an-old Fix warnings.
+	* tmac/s.tmac: Initialize FR string to "11/12".
+	(@MC): Compute footnote column width using \*FR instead of a
+	hard-coded "11/12" expression.
+	(par@init): Compute default \nFL using \*FR instead of a
+	hard-coded "11/12" expression.
 
-	* tmac/an-old.tmac (an-init): Insert missing braces.
+	* doc/groff.texi (Macro Packages/ms/Document control settings):
+	* tmac/groff_ms.7.man (Usage/Document control registers):
+	Document it.
 
-2012-02-26  Werner LEMBERG  <wl@gnu.org>
+	Fixes <https://savannah.gnu.org/bugs/?59605>.
 
-	Update configuration files from `gnulib' and `config' repositories.
+2021-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	This also fixes a problem with `iconv' on Solaris 10, as reported
-	in
+	* src/roff/troff/env.cpp: Add ADJUST_MAX enumeration constant to
+	record maximum valid numerical adjustment mode.
+	(adjust): Verify numeric argument against ADJUST_MAX instead of
+	a numeric literal.  Ignore excessively large values instead of
+	setting adjustment mode to "right".  Update warning diagnostic.
+
+2021-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for .ad and .na requests.
+
+	* src/roff/groff/tests/adjustment_works.sh: Do it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2021-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Manipulating Filling and Adjustment):
+	* man/groff.7 (Requests/Request short reference): Clarify
+	behavior of ".na" and ".ad l".
+
+	Thanks to Bjarni Ingi Gislason for pointing out the potential
+	for confusion and for his careful review of the new text.
+
+	Fixes <https://savannah.gnu.org/bugs/?59795>.
+
+2021-01-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/grog/grog.pl: Report program name in fatal error
+	diagnostics.  Also drop sentence-ending punctuation since Perl
+	supplies additional information.
+
+	Continues the long process of fixing Savannah #52463.
+
+2021-01-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (RE): Style-warn if macro arguments are out
+	of range or redundant.
+
+	Fixes <https://savannah.gnu.org/bugs/?55320>.
+
+2021-01-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Improve style of troffrc{,-end} files.  Follow established
+	idioms and make them consistent with each other.
+
+	* tmac/troffrc:
+	* tmac/troffrc-end:
+	  - Identify files in header comments as part of GNU troff.
+
+	* tmac/troffrc:
+	  - Clarify purpose of .do request.
+	  - Identify .X (set by groff -X) as a register, not a string.
+	  - Remove temporary registers one per line to make
+	    synchronization with foregoing logic easier.  Fixes name
+	    space management nits: an undefined string troffrc!Xps was
+	    being removed, and troffrc!{ascii,latin1,utf8,cp1047} were
+	    not being removed despite being defined.
+
+	* tmac/troffrc-end:
+	  - Clarify that file is read after -m file arguments (not "all
+	    macro sets", which can be loaded with .mso after this file
+	    is processed).
+	  - Advise usage of .do for groff extensions.
+	  - Line-break one-off conditionals as troffrc does.
+	  - Add empty string comment to empty string definitions.
+
+2021-01-14  Dave Kemper <saint.snit@gmail.com>
+
+	Commit 87edb525, from 2003, added character U+2026 (HORIZONTAL
+	ELLIPSIS) to most base groff fonts, but there has been no
+	kerning information for this character.  To produce consistent
+	typography, it should be kerned the same way as the period,
+	which is in 818 kern pairs across all the devps fonts.
+
+	Apply the following shell command to the groff description files
+	of the PostScript fonts.
+
+	  for file in font/devps/*A-Z
+	    do sed -Ei\~ 's/(.*)(^| )\. (.*)/&\n\1\2u2026 \3/' $file
+	  done
+
+	* font/devps/AB:
+	* font/devps/ABI:
+	* font/devps/AI:
+	* font/devps/AR:
+	* font/devps/BMB:
+	* font/devps/BMBI:
+	* font/devps/BMI:
+	* font/devps/BMR:
+	* font/devps/HB:
+	* font/devps/HBI:
+	* font/devps/HI:
+	* font/devps/HNB:
+	* font/devps/HNBI:
+	* font/devps/HNI:
+	* font/devps/HNR:
+	* font/devps/HR:
+	* font/devps/NB:
+	* font/devps/NBI:
+	* font/devps/NI:
+	* font/devps/NR:
+	* font/devps/PB:
+	* font/devps/PBI:
+	* font/devps/PI:
+	* font/devps/PR:
+	* font/devps/TB:
+	* font/devps/TBI:
+	* font/devps/TI:
+	* font/devps/TR:
+	* font/devps/ZCMI: Apply above script.
+
+	Fixes <https://savannah.gnu.org/bugs/?58897>.  However, this
+	will need to be done again if afmtodit is used to regenerate the
+	above files, or afmtodit will need to be modified to add this
+	kerning information itself.
+
+2021-01-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/relocate.cpp (set_current_prefix) _WIN32:
+	Move declaration of `pathextstr` to lie within preprocessor
+	conditional, since it is dereferenced only there.
+
+2021-01-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add support for strsignal().
+
+	POSIX.1-2008 added strsignal() to the C library and recommended
+	its use over sys_siglist, but groff's pipeline management
+	hadn't been updated in that respect since that time.
+
+	* configure.ac: Check for strsignal().
+	* src/roff/groff/pipeline.c (xstrsignal): Return strsignal() if
+	it is defined.
+
+	Thanks to an anonymous contributor for the report and the patch.
+
+	Fixes <https://savannah.gnu.org/bugs/?59835>.
+
+2021-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/relocate.cpp (relocatep): Add assertion to
+	identify logic error if `curr_prefix` is unexpectedly a null
+	pointer.
+	(set_current_prefix) _WIN32: Allocate memory from heap for
+	`curr_prefix` only on Windows; on other systems, this file's
+	searchpath() is used to populate `curr_prefix`, and that
+	function (except on Windows) performs its own allocation.  Fixes
+	memory leak noted by Ingo Schwarze.
+	(set_current_prefix) !_WIN32: Move logic attempting to set
+	`curr_prefix` by calling searchpathext() from here...
+	WIN32: ...to here.  The PATHEXT environment variable has
+	semantics only under Windows, not POSIX systems, so the
+	placement of this code seemed erroneous.
+
+	See <https://savannah.gnu.org/bugs/?55475>.
+
+2021-01-06  Colin Watson <cjwatson@debian.org>
+
+	* contrib/glilypond/glilypond.pl:
+	* contrib/gperl/gperl.pl:
+	* contrib/gpinyin/gpinyin.pl:
+	* tmac/hyphenex.pl: Avoid Perl's unsafe "<>" operator.
+
+	The "<>" operator is implemented using the two-argument form of
+	"open", which interprets magic such as pipe characters, allowing
+	execution of arbitrary commands which is unlikely to be
+	expected.  Perl >= 5.22 has a "<<>>" operator which avoids this,
+	but also forbids the use of "-" to mean the standard input,
+	which is a facility that the affected groff programs document.
+
+	ARGV::readonly would probably also fix this, but I fundamentally
+	dislike the approach of escaping data in preparation for a
+	language facility to unescape it, especially when the required
+	escaping is as non-obvious as it is here.  (For the same reason,
+	I prefer to use subprocess invocation facilities that allow
+	passing the argument list as a list rather than as a string to
+	be interpreted by the shell.)  So I've abandoned this dubious
+	convenience and changed the affected programs to iterate over
+	command-line arguments manually using the three-argument form of
+	open.
+
+	glilypond doesn't need the initial unshift since that's already
+	handled in contrib/glilypond/args.pl.
+
+	Fixes <https://savannah.gnu.org/bugs/?55557>.
+
+2021-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Set footnote line length in multi-column
+	environments to 11/12ths of the text line length for consistency
+	with earlier change to FL register default.
+
+	Thanks to T. Kurt Bond for bringing this issue to my attention.
+
+2021-01-04  John Gardner <gardnerjohng@gmail.com>
+
+	* tmac/strip.sed: Escape '.' wildcard when matching lines using
+	.as and .ds requests.
+
+	Fixes <https://savannah.gnu.org/bugs/?59498>.
+
+2021-01-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Document use of SOURCE_DATE_EPOCH and TZ.
+
+	The semantics of SOURCE_DATE_EPOCH to groff were not established
+	with respect to time zone selection, prompting divergent
+	interpretations; Debian and distributions derived from it have
+	for several years patched groff to implicitly use UTC as the
+	time zone when interpreting the current time (or
+	SOURCE_DATE_EPOCH) as a local time.  While a convenient and
+	defensible choice for reproducible build efforts1, it runs
+	against the grain of user expectations.  Systems programmers
+	like monotonically increasing clocks; the broader user base
+	usually prefers a clock that follows an applicable civil
+	calendar.  To the latter audience, a difference between
+	  $ date "+%Y-%M-%d %H:%m:%S"
+	and
+	  $ groff <<EOF
+	  .af year 0000
+	  .af mo 00
+	  .af dy 00
+	  .af hours 00
+	  .af minutes 00
+	  .af seconds 00
+	  .tm \nyear-\nmo-\ndy \nhours:\nminutes:\nseconds
+	  EOF
+	is difficult to explain.
+
+	* doc/groff.texi (Environment):
+	* src/devices/grohtml/grohtml.1.man (Environment):
+	* src/devices/gropdf/gropdf.1.man (Environment):
+	* src/devices/grops/grops.1.man (Environment):
+	* src/roff/groff/groff.1.man (Environment):
+	* src/roff/troff/troff.1.man (Environment): Expand description
+	of use of SOURCE_DATE_EPOCH to note that it converts the time
+	{as seconds since the Epoch} to local time, which motivates
+	documentation of the TZ environment variable.  Explain what the
+	time stamps are used for: troff merely stores the human-readable
+	time components in registers; the grohtml, gropdf, and grops
+	output drivers write the information to the output in comments.
+
+	Fixes <https://savannah.gnu.org/bugs/?57218>.
+
+	1 https://reproducible-builds.org/docs/source-date-epoch/
+
+2020-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am (.texi.dvi): Call texi2dvi with FORCE_SOURCE_DATE=1
+	in the environment, avoiding an embedded timestamp in the
+	generated groff.dvi file, which frustrated reproducible builds.
+	Thanks to Werner Lemberg for the suggestion.
+
+	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: Fix
+	test to no longer use Bash process substitution, resulting in
+	nondeterministic file descriptor numbers appearing in test logs,
+	frustrating reproducible builds.
+
+	* contrib/pdfmark/pdfmark.am (PDFROFF): Call pdfroff without
+	`--keep-temporary-files` option.  Temporary directories are
+	created with mktemp(1) and files with an embedded process
+	identifier, which frustrates reproducible builds.
+
+	See <https://savannah.gnu.org/bugs/?57218>.
+
+2020-12-21  Dorai Sitaram <ds26gte@yahoo.com>
+
+	* tmac/s.tmac (@IP): Handle inter-sentence space correctly in
+	paragraph tags by copying \n.sss from the enclosing
+	environment to that used to format the paragraph tag.
 
-	http://lists.gnu.org/archive/html/bug-groff/2012-02/msg00007.html
+	Fixes <https://savannah.gnu.org/bugs/?59742>.
 
-	* configure.ac: Call `gl_LOCALCHARSET.
-	Call `AM_ICONV' as C++.
+2020-12-21  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* config.guess, config.rpath, config.sub, install-sh, mkinstalldir:
-	Updated.
+	Add regression test for Savannah #59742.
 
-	* m4/codeset.m4, m4/glib21.m4, m4/iconv.m4, m4/lib-ld.m4,
-	m4/lib-link.m4, m4/lib-prefix.m4: Updated.
-	* m4/fcntl-o.m4, m4/localcharset.m4: New files.
+	* tmac/tests/s_IP_respects_inter-sentence_space_in_tags.sh: Do
+	it.
+	* tmac/tmac.am (tmac_TESTS): Run it.
 
-	* Makefile.in: Updated.
+2020-12-21  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
 
-	* src/include/localcharset.h, src/libs/libgroff/config.charset,
-	src/libs/libgroff/localcharset.c: Updated.
+	* src/utils/addftinfo/addftinfo.cpp (usage): Use size_t for loop
+	index when iterating over a count of size_t items.  Quiets
+	signedness mismatch compiler warning.
 
-	* aclocal.m4, configure, src/include/config.hin: Regenerated.
+	Fixes <https://savannah.gnu.org/bugs/?59583>.
 
-2012-02-20  Werner LEMBERG  <wl@gnu.org>
+2020-12-20  Colin Watson <cjwatson@debian.org>
 
-	Update `gnulib' files.
+	* src/devices/gropdf/gropdf.pl:
+	* src/utils/afmtodit/afmtodit.pl: Sort Perl hash keys.  Hash
+	iteration order may differ between runs, which makes builds
+	harder to reproduce.  Sort hash keys in gropdf and afmtodit
+	output to avoid this.
 
-	The invocation was
+2020-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	gnulib-tool --add-import \
-	              --dir=src/libs/gnulib \
-	              wcwidth
+	* doc/ms.ms (Basic Information): Tweak unit definitions.  groff
+	defines a typesetter's point as precisely 1/72 inches.  Also use
+	the correct symbol for inch units--strictly, it's the same as
+	that for "seconds" as in subdivisions of the degree, and not a
+	typographical quote of any sort.
 
-	Additionally, src/libs/gnulib/configure.ac was adjusted from a
-	`test' run as described in the change from 2010-12-13.
+	Fixes <https://savannah.gnu.org/bugs/?59463>.
 
-	* src/libs/gnulib/*: Updated.
+2020-12-20  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-02-15  Deri James  <deri@chuzzlewit.demon.co.uk>
+	ms: Set footnote line length to AT&T default.
 
-	gropdf Fixes and omissions.
+	groff ms has since its initial implementation used a default
+	footnote line length of 5/6ths of the text line length; this may
+	correspond to an early AT&T ms default (perhaps documented in
+	the 1974 version of the M. E. Lesk paper, "Typing Documents on
+	the UNIX System"1).  However, as early as V6 Unix (1975), AT&T
+	ms actually used a footnote line length of 11/12ths of the text
+	line length instead2.
 
-	* src/devices/gropdf/gropdf.pl (<top>, do_u): Add facility to
-	handle track kerning (.tkf).
+	Heirloom Doctools and neatroff ms also use this default.
 
-	(do_x, do_p, do_t): If pages are reordered using `pagename' and
-	`switchtopage' keep track of outline bookmarks.
-	(do_x): Handle multiple files on gropdf command line, stitch
-	multiple groff_out files together.  In the main read loop any argc
-	values not consumed by options are taken as input files and
-	processed in order.  What prevented it working properly before is
-	the way an `x i' (initialize) record has been handled.  It now
-	processes the initialization code only in the first file.
+	* tmac/s.tmac: Set default footnote line length to 11/12ths of
+	the text line length.
 
-	(PutHotSpot): Allow user to control size of hotspot bounding box
-	on clickable links by setting PDFHREF.LEADING
+	* doc/groff.texi (ms Document Control Settings):
+	* doc/ms.ms (Document control registers): Document new default.
 
-	* tmac/pdf.tmac (PDFHREF.LEADING): Adjust value.
-	(pdf*href): Pass value of PDFHREF.LEADING to gropdf.
+	1 https://www.troff.org/using-ms.pdf
+	2 https://minnie.tuhs.org/cgi-bin/utree.pl?file=V6/usr/lib/tmac.s
 
-2012-02-10  Deri James  <deri@chuzzlewit.demon.co.uk>
+2020-12-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	gropdf Fix compatibility issues with pdfmark.
+	Lower new unplanted trap error to 'mac' warning.
 
-	* tmac/pdf.tmac (PDFHREF.VIEW.LEADING): Fix value.
-	(pdf:href.opt-X): Add check for -X option for .pdfhref.
+	* src/roff/troff/div.cpp (top_level_diversion::change_trap):
+	Change error upon invalid attempt to move an unplanted trap into
+	a warning of type 'mac'.
 
-2012-02-08  Werner LEMBERG  <wl@gnu.org>
+	* doc/groff.texi (Warnings):
+	* src/roff/troff/troff.1.man (Warnings): Recast description of
+	'mac' warning type to include the above scenario.
 
-	* src/preproc/pic/main.cpp (do_file): Check for invalid characters.
+	Thanks to Bjarni Ingi Gislason for reporting the diagnostic
+	arising in real life, and to Peter Schaffter for the discussion
+	and recommendation.  Some bike sheds get painted quickly!
 
-	Problem reported by Doug McIlroy <doug@cs.dartmouth.edu>.
+	Fixes <https://savannah.gnu.org/bugs/?59573>.
 
-2012-01-25  Ingo Schwarze  <schwarze@usta.de>
+2020-12-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	mdoc * tmac/doc-syms: Fix meaning of XBD acronym.
+	* tmac/groff_mdoc.7.man: Tweak mandatory macro explanations.
 
-2012-01-25  Tadziu Hoffmann  <hoffmann@usm.uni-muenchen.de>
+	Update descriptions and template of .Dd, .Dt, .Os usage to
+	reflect recent changes and recommended conventions.
 
-	* tmac/e.tmac (bl): Make it work inside blocks.
+	Thanks to Ingo Schwarze, Colin Watson, and Alan D. Salewski for
+	the discussion, and Florent Rougon and Robert Bihlmeyer (many
+	years ago) for the original report.
 
-	See threads starting with
+	Fixes <https://bugs.debian.org/284002>.
 
-	http://lists.gnu.org/archive/html/groff/2011-12/msg00055.html
-	http://lists.gnu.org/archive/html/groff/2012-01/msg00000.html
+2020-12-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-01-10  Bruno Haible  <bruno@clisp.org>
+	* src/utils/xtotroff/xtotroff.c (MapFont): Avoid writing past
+	the end of a static buffer.  Problem found and patch supplied by
+	Bjarni Ingi Gislason.  I tweaked it to comment it differently
+	{in case the buffer ever needs to grow, but the prospects of
+	future X11 server-side font rendering development seem dim} and
+	use snprintf() instead of retaining the existing sprintf().
 
-	Fix handling of MAKEFLAGS variable.
+	Fixes <https://savannah.gnu.org/bugs/?55257>.
 
-	* Makefile.in (MAKE_K_FLAGS): Improved definition,
-	as explained and discussed in
+2020-12-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	http://lists.gnu.org/archive/html/groff/2012-01/msg00039.html
+	* src/utils/xtotroff/xtotroff.c (CanonicalizeFontName)
+	(FontNamesAmbiguous, MapFont, main): Format diagnostic messages
+	more consistently with GNU Coding Standards.  Prefix with name
+	of complaining command.  Put argument literals in quotation
+	marks.  Put each message on one line only.
 
-2012-01-03  Ingo Schwarze  <schwarze@usta.de>
+2020-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Improve parallel builds.
+	* doc/groff.texi (Parameters): Fix error in example.  Arguments
+	to .als were in the wrong order (.als is not ln(1)).  Also mark
+	output to the standard error stream using the @error Texinfo
+	command instead of @result.
 
-	Some hdtbl and mom examples want PostScript formatting which
-	requires the `DESC' file to be ready; however, the top-level
-	`Makefile.in' doesn't currently enforce the proper order of
-	building of `font/dev' before `contrib/hdtbl', `contrib/mom', and
-	so on.
+	Thanks to Dorai Sitaram for finding this error.
 
-	Given that `font/dev' and the contrib examples are in different
-	child processes of the recursive make system, it doesn't seem
-	possible to solve this using clean Makefile dependencies.  We now
-	enforce the order by splitting the shell command invoking
-	recursive make in the top level `Makefile.in'.
+	Fixes <https://savannah.gnu.org/bugs/?59566>.
 
-	* Makefile.in (ALLDIRS): Remove `OTHERDIRS'.
-	(dodirs): Updated.
-	(`$(TARGETS)'): Handle `OTHERDIRS' separately.
+2020-11-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2012-01-03  Kristaps Dzonsons  <kristaps@bsd.lv>
+	* doc/groff.texi (Debugging): Update with a more helpful
+	introduction, summarizing available procedures.  Mention
+	backtracing since it is much more useful now (post-groff
+	1.22.4.)
 
-	mdoc Add `-isoC-2011'.
+	* man/groff.7 (Debugging): Add new section summarizing
+	material added to our Texinfo manual.
 
-	* tmac/doc-syms (doc-str-St--isoC-2011): Add it.
-	* tmac/groff_mdoc.man: Document it.
+	* man/groff_diff.7.man (Debugging): Add new section describing
+	groff extensions.
 
-2011-12-26  Deri James  <deri@chuzzlewit.demon.co.uk>
+2020-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/Makefile.sub: Only build fonts on first `make'.
+	* doc/groff.texi (Traps): Update.  Organize subsubsections "Page
+	Location Traps" and "Diversion Traps" under new subsection node
+	"Vertical Position Traps" to make the conceptual organization
+	more clear.  Define and discuss trap visibility earlier.
+	Document unit used for page location trap reporting.  Introduce
+	analogy of .wh and .ch requests as queue operations.  Document
+	what happens when the same macro is planted as a trap in
+	multiple locations; supply example.  Supply example of .itc
+	usage.  Consistently refer to an end-of-input macro as such, to
+	contrast it with the "end macro" that can be used with, e.g.,
+	.de and .ig requests.
 
-2011-12-08  Werner LEMBERG  <wl@gnu.org>
+	* man/groff.7 (Traps): Add new section summarizing
+	language feature.
 
-	* doc/groff.texinfo (.tl): Improve documentation.
-	Wording suggested by Keith Marshall
-	<keithmarshall@users.sourceforge.net>.
+2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-12-01  Werner LEMBERG  <wl@gnu.org>
+	* tmac/mdoc/doc-common-u (doc-footer): When performing
+	double-sided page layout, set page number on outside of _recto_
+	{odd-numbered} pages, as is conventional and for consistency
+	with man(7).
 
-	me Fix behaviour of centered block.
-	Problem and possible fix reported in thread starting at
+	* tmac/groff_mdoc.7.man
+	(Formatting with groff, troff, and nroff): Document what
+	double-sided layout (not "printing") means.  Also correct
+	description of continuous rendering, which implied that page
+	headers and footers were not written at all, and used an
+	incorrect groff driver name.
 
-	http://lists.gnu.org/archive/html/groff/2011-11/msg00002.html
+	Fixes <https://bugs.debian.org/919890>.  Also see:
+	https://lists.gnu.org/archive/html/groff/2019-01/msg00021.html
+	Thanks to Ralph Corderoy for the discussion.
 
-	* tmac/e.tmac (`(c'): Always start with a new line.
+	* tmac/tests/doc-D_places_page_numbers_correctly.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-2011-12-01  Ingo Schwarze  <schwarze@usta.de>
+2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	man Print volume headers like mdoc.
+	* tmac/mdoc/doc-common-u (doc-header): Fix infinite loop when
+	attempting to trim header string (like "FTP(1)") to fit when the
+	available title length won't allow even extreme shortening.
+	Measure the string before and after calling .substring on it,
+	and break out of loop if it didn't get shorter.
 
-	* tmac/an-old.tmac (an-init): Add default volume name if fifth
-	argument to `.TH' is missing.
+	Problem dates back to at least
+	ed63b0ae76a611b581601a1afc192f6a7367be6f (7 July 2002), possibly
+	as far as the Great Mdoc Rewrite of
+	058f72af832fc68488d33cd09ec819e5c560fa09 (23 March 2001).
 
-2011-11-22  Werner LEMBERG  <wl@gnu.org>
+	One can never check loop invariants too many times...
 
-	* tmac/groff_man.man: Minor documentation improvements.
-	Suggested by Jeff Conrad <jeff_conrad@msn.com>.
+	Fixes <https://bugs.debian.org/411227>.
 
-2011-11-14  Werner LEMBERG  <wl@gnu.org>
+	* tmac/tests/\
+	doc-do_not_loop_infinitely_when_shortening_headers.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
 
-	* doc/groff.texinfo: Improve doc for calling undefined identifiers.
+2020-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-11-14  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/nroff/nroff.sh: Recognize -b and -z options and pass
+	them through to troff.  Document them in usage message.
+	* src/roff/nroff/nroff.1.man: Document new -b and -z options.
 
-	* src/preproc/tbl/tbl.man: Improve documentation of `_' and
-	friends.
+2020-11-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-10-31  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/troff/div.cpp (top_level_diversion::change_trap):
+	Emit error diagnostic if an attempt is made to move an unplanted
+	macro.  This could have been a warning, as it's pretty harmless
+	{though possibly a big surprise to anyone who was wondering why
+	their .ch was a no-op}, but there's no good warning category for
+	this kind of problem and I am not about to start a bike shed
+	discussion about it right now.
 
-	Fix compiler warnings.
+2020-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/eqn/main.cpp (do_file), src/roff/troff/env.cpp
-	(environment::print_env), src/roff/troff/mtsm.cpp
-	(statem::display_state): Add syntactical sugar.
+	* doc/groff.texi: Update.  Add introductory material.  Rewrite
+	the first section of the "gtroff Reference" chapter of our
+	Texinfo manual.  It is written as an introduction for readers
+	who want to go straight to "raw" troff without knowing much or
+	anything about existing macro packages.  Thanks to Dave Kemper
+	and John Gardner for feedback and support.
 
-	* src/utils/tfmtodit/tfmtodit.cpp (char_info_word): Use `unsigned
-	char' for all members.
+	Clarify whitespace usage.  "Whitespace" is defined in this
+	manual as "spaces, tabs, and newlines".  Say only "spaces and
+	tabs" when newlines should not be included.
 
-	* src/devices/grohtml/html-text.cpp (html_text::remove_def):
-	Remove unused variable `q'.
+	Rename "Font Files" to "Device and Font Files".
 
-	* src/devices/grohtml/post-html.cpp
-	(html_printer::lookahead_for_tables): Remove unused variable `left'
-	and `seen_text'.
+	Rename "Manipulating Filling and Adjusting" to "Manipulating
+	Filling and Adjustment".
+
+	Update discussion of "copy mode".  Rename from "copy-in mode",
+	which I don't think eludicdated anything; is there a "copy-out
+	mode"?  Rename nodes accordingly.  Attempt to explain more
+	clearly.  Recast to shift emphasis to what _isn't_ merely copied
+	in copy mode, since that is what seems to cause confusion among
+	the inexperienced.
+
+	Update "Conditionals and Loops".  Add introductory paragraph.
+	Add nodes/subsections "if-then" and "Conditional Blocks".  Add
+	subsection "Conditional Blocks" to explain the behavior of the
+	\{ and \} escapes much more precisely.  I don't think this
+	syntactical area is well understood.  Supply examples.
+
+2020-11-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add style checks to man(7) macro package.
+
+	Not otherwise documented yet; experimental--subject to change.
+
+	* tmac/an-old.tmac: Initialize CHECKSTYLE to false if not
+	already set.
+	(an-style-warn): New macro emits diagnostic of type "style" when
+	called if CHECKSTYLE register is true.
+	(TH): Call an-style-warn if fewer than two or more than five
+	arguments are seen.
+	(RI, IR, IB, BI, RB, BR): Call an-style-warn if fewer than two
+	arguments are seen.
+
+2020-11-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update copyright.
+
+	* update-copyright.sh: use gnulib's 'update-copyright' script.
+	Pass this script in directories 'arch', 'contrib', 'font',
+	'man', 'tmac', 'src' and on a list of extra files.
+
+	* FOR-RELEASE: mention this point.
+
+2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/preconv/preconv.1.man (Description): Fix error:
+	groff's -K option, not -k, specifies a character econding (and
+	overrides GROFF_ENCODING in the environment).  Also explain how
+	valid encoding strings are determined.
+
+	Thanks to Bjarni Ingi Gislason for the report.
+
+	Fixes <https://savannah.gnu.org/bugs/?59445>.
+
+2020-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::compute_separation_factor):
+	Add word "table" to diagnostic message to better cue the user
+	that it is produced by roff that has been injected into the
+	document by the tbl(1) preprocessor.  The other 3 such possible
+	diagnostic messages already do this.  Thanks to Bjarni Ingi
+	Gislason for bringing the inconsistency to light.
+
+	Fixes <https://savannah.gnu.org/bugs/?59443>.
+
+2020-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_mdoc.7.man (Predefined strings): Ensure the table
+	fits even on ASCII and Latin-1 terminals.  Thanks to Bjarni Ingi
+	Gislason for the report.
+
+	Fixes <https://savannah.gnu.org/bugs/?59424>.
+
+2020-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_mdoc.7.man (General text domain/Enclosure and
+	Quoting Macros): Fix errors in macro descriptions.
+	<.Dq>: Encloses its arguments in directional double quotes where
+	available.
+	<.Eq>: Misrendered example; say "XstringY" rather than
+	"XXstring".
+	<.Sq>: Encloses its arguments in directional single quotes where
+	available.
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add support for CS and CT registers to mdoc(7), just like in
+	man(7), from a year ago.
+
+	* tmac/doc.tmac-u (doc-print-recursive): Call .stringup on each
+	argument if register doc-do-capitalize is true.
+	* tmac/mdoc/doc-common-u (Dt): Call .stringup on
+	doc-document-title if \nCT is true.
+	(Sh): Set doc-do-capitalize to value of \nCS.  Set
+	doc-do-capitalize false before returning.
+	* tmac/mdoc/doc-ditroff-u:
+	* tmac/mdoc/doc-nroff-u: Set CS and CT registers to 0 (false)
+	if the user has not defined them.
+
+	* tmac/groff_mdoc.7.man \
+	(Formatting with groff, troff, and nroff): Document it.
+
+	* tmac/tests/doc-CS_works.sh:
+	* tmac/tests/doc-CT_works.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (do_overstrike, do_bracket)
+	(do_name_test, do_expr_test, do_zero_width, do_width)
+	(do_special, do_if_request, read_color_draw_node): Improve
+	diagnostic messages for missing closing delimiters by describing
+	the incomplete structure and the problem token.
+	(read_rgb, read_cmy, read_cmyk, read_gray): Improve English
+	syntax of diagnostic message when color definition missing.
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-ditroff-u:
+	* tmac/mdoc/doc-nroff-u: Recognize but ignore the groff_man(7)
+	string HF and registers FT, IN, P, SN, and X (by initializing
+	them empty or zero if they are not set).  This reserves them so
+	that they don't become used for divergent purposes.  man(1)
+	programs set these and other parameters already handled (like
+	LL) to configure page rendering, and it would break the
+	macro-package agnosticism afforded by andoc.tmac to expose
+	different externally-programmable registers and strings.
+	* tmac/groff_mdoc.7.man \
+	(Formatting with groff, troff, and nroff): Document this.
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Implement \*< and \*> strings for subscripting.
+	groff ms has had (extension) strings for superscripting since
+	1991 at the latest, and the asymmetry possessed me of a madness.
+	Both pairs of string names follow similar usage in Eric Allman's
+	"me" macros.
+
+	* NEWS:
+	* doc/groff.texi:
+	* tmac/groff_ms.7.man: Document it.
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_mdoc.7.man (Predefined strings): Fix error: the
+	\*Lq and \*Rq strings degrade to neutral double quotes (")
+	on "nroff" devices (-Tascii and -Tlatin1), not "``" and "''".
+
+2020-10-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac (ds*end!0): Improve diagnostic to mention .RD.
+
+2020-10-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/s.tmac: Revise diagnostic messages.  Define a common
+	prefix string, starting all such messages with "s.tmac".
+	Continues the long process of fixing Savannah #52463.  Drop the
+	word "macro" from diagnostic since this will now be clear from
+	the prefix.  Prefix every macro name in a diagnostic message
+	with a leading dot; this was already done in four cases.
+	(cov*first-page-init): Use temporary string to avoid multi-line
+	diagnostic message.
+	(@NH): Use temporary string to prevent overlength line.
+
+	A further benefit of this revision is that index information
+	produced by ms's .IX macro (which writes to the standard error
+	stream) will now be trivially easy to extract even for documents
+	that cause diagnostic messages.  One can simply filter them with
+		grep -v '^s\.tmac:'
+	or similar.
+
+2020-10-28  Ingo Schwarze <schwarze@openbsd.org>
+
+	* man/roff.7.man, tmac/groff_man.7.man.in: Correct man(7)
+	history.
+
+2020-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix ms .R macro to work as documented, by handling its arguments
+	instead of ignoring them.
+
+	* tmac/s.tmac (R): Delete.  During set up, call
+	par*define-font-macro for R font just as we do for B, I, and BI.
+
+	Problem dates back at least to groff 1.02, June 1991.
+
+	* tmac/tests/s_R-handles-its-arguments.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?59348>.
+
+2020-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix ms .TC macro by allowing it to actually use lowercase Roman
+	numerals for the page(s) of the table of contents when a custom
+	title (header or footer) is defined containing '%'.
+
+	As a side effect, eliminate the PN register, which was
+	apparently misused because it was undocumented and had a name
+	just long enough to be both suggestive and ambiguous.  Another
+	pin goes into my Ken Thompson voodoo doll.
+
+	* tmac/s.tmac (IX): Write out page number of index term(s) using
+	the % register (instead of PN), obtaining whatever format is
+	assigned to the register at that time.
+	(CH): Similarly, output %, not PN, in the center of the default
+	heading.
+	(PT): Save the format of %, set it to decimal, copy its value to
+	a new register, pg*page-number-in-decimal, then restore %'s
+	previous format.  Compare the new register, not %, to 1 to
+	determine whether special page one behavior should be used.
+	(pg*end-page): Assign pg*next-format to %, not PN.
+	(XA): Define toc*num with the interpolation of %, not PN.
+
+	* tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Problem appears to be very old; as I read it, Larry Kollar was
+	complaining of it in his ms.ms document over 20 years ago.
+
+	Fixes <https://savannah.gnu.org/bugs/?59345>.
+
+2020-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7 (Requests/Request short reference) <.af>: Fix
+	error; "l" is not a valid register format.  Explain what the
+	request does, and the default format, as tersely as possible.
+
+2020-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Use only `malloc()` and `free()` to manage memory of paths
+	opened by the parser instead of mixing in C++ new/delete
+	management under some runtime-dependent circumstances.
+
+	* src/libs/libgroff/relocate.cpp (relocatep): Use `malloc()`,
+	not new.
+	* src/roff/troff/input.cpp (process_macro_file)
+	(process_startup_file, macro_source): Use `free()`, not
+	`{a_,}delete()`.
+
+	Thanks to an anonymous contributor for the report and patch.
+
+	Fixes <https://savannah.gnu.org/bugs/?56694>.
+
+2020-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_char.7.man (Description/Special character escape
+	forms): Clarify discussion of Unicode Normalization Form D and
+	its applicability to code points acceptable in Unicode numeric
+	special character escapes.  Also document that these escapes
+	must use uppercase hexadecimal digits.
+
+	Attempts once again to slay the unkillable beast that is
+	<https://savannah.gnu.org/bugs/?57618>.
+
+2020-10-21  Ingo Schwarze <schwarze@openbsd.org>
+
+	On systems without NAME_MAX, use FILENAME_MAX as a last resort.
+
+	Problem reported by Eli Zaretskii <eliz at gnu dot org>
+	on MS Windows in https://savannah.gnu.org/bugs/?55449
+
+2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (environment::possibly_break_line):
+	Emit break warning and return if the output width is not
+	positive.  The code assumes that it will be and loops infinitely
+	if it isn't.  I _think_ this is because we're not able to get
+	width data for (some?) CJK glyphs.  Based on a patch by Osamu
+	Sayama.
+
+	* src/roff/groff/tests/\
+	do_not_loop_infinitely_when_breaking_cjk.sh: Test it.
+	* src/roff/groff/groff.am: Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?44018>.
+
+2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::init_output): Save the value
+	of \n.tabs when starting a table.  In the reset macro, restore
+	the saved value.
+
+	Based on a patch by Bjarni Ingi Gislason (tweaked to use a more
+	normative preprocessor symbol; "REG"s aren't "NAME"s).
+
+	* src/preproc/tbl/tests/save-and-restore-tab-stops.sh: Test it.
+	* src/preproc/tbl/tbl.am (tbl_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?42978>.
+
+2020-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/nroff/nroff.sh: Recognize -E option and pass it
+	through to troff.  Document it in usage message.
+	* src/roff/nroff/nroff.1.man: Document new -E option.
+
+	Based on a patch by Ingo Schwarze.
+
+	Fixes <https://savannah.gnu.org/bugs/?44289>.
+
+2020-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Stop remapping ` and '.  Our own pages now
+	appear to be clear of wrong-quote problems, so let's make them
+	visible if they recur.  Those who don't want to fix bad man
+	pages (distributors, site admins) can restore the mappings in
+	their man.local files.
+
+2020-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-10-23  Ingo Schwarze  <schwarze@openbsd.org>
+	* tmac/an-old.tmac (an-warn): New; emits warning diagnostic.
+	(R): Use new macro instead of .tm* requests directly.
 
-	mdoc Synchronize string tables with the mandoc(1) utility.
+2020-10-18  Ingo Schwarze <schwarze@openbsd.org>
 
-	* tmac/doc-common: Add many architecture names used in NetBSD and
-	OpenBSD (and "arm" from FreeBSD) and remove the duplicate OS
-	version entry for Darwin-10.6.0.
+	#include "config.h" before <stdio.h>
 
-	* tmac/doc-syms: Add many library names used in NetBSD and FreeBSD.
+	Required with e.g. gcc 4.2.1 because gnulib/lib/stdio.in.h
+	uses the "restrict" keyword since this gnulib commit:
+	commit 182afcba2635cbff91240656c7fb3742dd23ab6f
+	Author: Bruno Haible <bruno@clisp.org>
+	Date: Sat Feb 22 20:57:30 2020 +0100
 
-	* tmac/groff_mdoc.man: Document all supported architecture names)
-	(OS versions, and library names.
+	Otherwise, the build may die from the declaration of
+	various printf-like functions with messages like:
+	./lib/stdio.h:851: error: expected ',' or '...' before 'fp'
 
-2011-09-11  Joseph Koshy  <jkoshy@users.sourceforge.net>
+	* src/libs/libgroff/assert.cpp, src/libs/libgroff/errarg.cpp,
+	src/libs/libgroff/error.cpp, src/preproc/eqn/eqn.ypp:
+	#include "config.h".
 
-	mdoc Add some library strings.
+2020-10-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
 
-	* tmac/doc-syms: Add `libdwarf' and `libelf'.
-	* tmac/groff_mdoc.man: Document them.
+	hpftodit: incorrect 'delete' after new
 
-2011-08-14  Deri James  <deri@chuzzlewit.demon.co.uk>
+	* src/utils/hpftodit/hpftodit.cpp (output_font_name): use
+	'delete'.
 
-	gropdf More minor fixes.
+	Fixes bug #55331. Found by David Binderman, fixed by Ingo
+	Schwarze.
 
-	* font/devpdf/Makefile.sub (MOSTLYCLEANADD): Don't attempt to
-	install 'util/BuildFoundries', only used in 'make'.
+2020-10-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
 
-	* src/devices/gropdf/gropdf.pl (<top>, GetType1): Make STDOUT and
-	any font files read to be accessed in binary rather than text mode.
-	Prevents errors when running on systems set up for UTF-8.
+	preconv: don't use libuchardet if input is stdin
 
-2011-08-10  Deri James  <deri@chuzzlewit.demon.co.uk>
+	* src/preproc/preconv/preconv.cpp (do_file): don't call
+	detect_file_encoding if input file is "-"
 
-	gropdf Minor updates and fixes.
+	This fixes the failure on MS-Windows described #55334, however
+	this does not fix the encoding detection with uchardet if the
+	input is stdin (the user would have to pass with -D the correct
+	encoding as explained in the man page).
 
-	* src/devices/gropdf/gropdf.pl: Change command line option `-fy'
-	to `-y' for consistency.
+2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Better support for Windows platform.
-	(do_x): Handle keywords `pagename' and `switchtopage'.
+	* src/preproc/eqn/lex.cpp (troff_defs): Set the "..." token on
+	the baseline, not vertically centered, aligning the actual
+	behavior with what our eqn(1) man page has claimed since 2007.
 
-	* doc/groff.texinfo, src/devices/gropdf/gropdf.man: Updated.
+	Fixes <https://savannah.gnu.org/bugs/?59285>.
 
-	* font/devpdf/Foundry: Renamed to...
-	* font/devpdf/Foundry.in: This.
-	Add default alias font names.
+2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* font/devpdf/util/BuildFoundries.pl: This is now an installation
-	helper script and gets not longer installed.
-	Support alternative font file names (separated with `!').
+	* src/devices/grops/grops.1.man
+	(Usage/TrueType and other font formats): Remove dead URL to
+	ttftot42 utility.  Update URL to fontforge tool.  Replace much
+	of the discussion with an example, motivated by Jordan Torbiak's
+	"groff-install-font" script on GitHub Gist, of how to add the
+	Roboto Slab Regular font to a user-local groff font directory
+	{and how to test it, too}.
 
-	* font/devpdf/Makefile.sub: Fixes to work with a separate build
-	directory.
-	Font files are now build at `make' time; this makes `test-groff'
-	work with -Tpdf.
+	Fixes <https://savannah.gnu.org/bugs/?58077>.
 
-	* font/devpdf/util/Makefile.sub: Removed.
+2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in (DEVDIRS, OTHERDIRS, EXTRADIRS): Handle devpdf
-	specially.
+	* src/utils/afmtodit/afmtodit.pl: Report program name in warning
+	diagnostics.
 
-2011-07-29  Daiki Ueno  <ueno@unixuser.org>
+	Continues the long process of fixing Savannah #52463.
 
-	Fix cross building.  Problem reported by Christophe Jarry
-	<christophe.jarry@ouvaton.org>.
+2020-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in ($GNULIBDIRS): Pass original config arguments to
-	src/libs/gnulib/configure.
+	* tmac/an-old.tmac: Add fallback for lq, rq strings.
 
-2011-06-25  Deri James  <deri@chuzzlewit.demon.co.uk>
+	Define \*(lq and \*(rq as '"' if the output device has no \(lq
+	or \(rq special character escapes defined (respectively).
 
-	Add new output device `gropdf'.
+	This is a bit belt-and-suspenders for groff since our output
+	devices all guarantee availability of these glyphs, but if this
+	macro file gets used with other implementations (and if they
+	support the 'c' conditional), it should prevent the strings from
+	producing empty output.
 
-	* font/devpdf/*: New device files for gropdf.
-	* src/devices/gropdf/*: New device.
+	Man page writers should simply use \(lq and \(rq unless they are
+	aiming for pathological levels of portability (e.g., composing
+	man pages today for consumption on simulators of 1980s Unix
+	systems).
 
-	* Makefile.comm (install_dev, uninstall_dev): Handle more
-	subdirectories.
-	* Makefile.in (DEVDIRS, OTHERDIRS, EXTRADIRS): Add directories
-	related to gropdf.
-	* MANIFEST: Updated.
-	* test-groff.in (GROFF_BIN_PATH): Updated.
+2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/Makefile.sub (NORMALFILES): Updated.
-	* tmac/pdf.tmac: New file.
-	* tmac/troffrc: Updated.
+	* tmac/an-old.tmac: Define an-end with .de1.  We need to define
+	an-end with de1 (execute macro with compatibility mode off)
+	because, as of 37b4180a27a6eeaea429e40ec278abefcda7f3a7 (11
+	October), it can now be called from a trap executing in a
+	context whence compatibility mode might be on (namely,
+	"reload-doc" in andoc.tmac).
 
-	* doc/groff.texinfo: Document it.
-	* doc/Makefile.in, doc/Makefile.sub (groff_bin_dirs): Udpated.
-	* doc/pic.ms: Updated.
+2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* man/groff_out.man, src/devices/grops/grops.man,
-	src/preproc/pic/pic.man, src/roff/groff/groff.man,
-	src/utils/afmtodit/afmtodit.man, src/utils/pfbtops/pfbtops.man:
-	Updated.
+	* src/preproc/eqn/main.cpp (main):
+	* src/preproc/pic/main.cpp (main):
+	* src/preproc/tbl/main.cpp (main):
+	* tmac/eqnrc:
+	* tmac/troffrc: Perform checks of register and macro definitions
+	with a .do request, since we might be in compatibility mode.
 
-	* contrib/pdfmark/pdfmark.ms: Updated.
+2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-07-20  George HELFFRICH  <ghfbsd@gmail.com>
+	* src/roff/troff/input.cpp (do_if_request): Emit warning of type
+	"syntax" if a groff conditional expression extension is used
+	when compatibility mode is active.
 
-	Improve line numbering support in tbl and with me macros.
+	* doc/groff.texi:
+	* src/roff/troff/troff.1.man: Update description of "syntax"
+	warning type to be more general.  It was inaccurate, referring
+	only to "dubious syntax in numeric expressions", which was not
+	the case.  Instead it was being used only for poor construction
+	of character classes with the .class request.
+
+2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/main.cpp (main): Stop ignoring -T.  GNU tbl
+	was undocumentedly ignoring the -T option; apparently IRIX tbl
+	implemented it, something on the system called tbl with that
+	option (I'm guessing IRIX's man(1)) and its users spammed James
+	Clark with bug reports.  We can probably weather the volume of
+	such spurious reports from IRIX users today.
+
+2020-10-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/main.cpp (main): Clarify fatal diagnostic in
+	generated document by informing the user that the program is
+	aborting, and also that it is groff extensions that are required
+	rather than GNU troff per se (since Heirloom Doctools troff
+	claims groff extension support via the .g register).
+
+2020-10-14  Ingo Schwarze <schwarze@openbsd.org>
+
+	In groff(1), fix the combination of -v with -k, -j, and -J.
+
+	* src/roff/groff/groff.cpp: Pass the -v option through to the
+	preconv, chem, and ideal preprocessors, just like for all
+	other preprocessors, to print the version of the preprocessor
+	and to avoid garbage output.
+
+	Bugfix patch from Eli Zaretskii <eliz at gnu dot org>
+	submitted in: https://savannah.gnu.org/bugs/?55297
+
+2020-10-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update 'gnulib' submodule.
+
+	* gnulib: now points on d60a35e94c4f5b8f09f15828242418f5073d46e7
+	from 'gnulib' repository.
+
+	* configure.ac: minimum autoconf version is now 2.64 due to
+	gnulib upgrade.
+
+	* FOR-RELEASE: add the gnulib update to the checklist.
 
-	* tmac/e.tmac (n1, n2, TH, PS): Implement it.
-	(@h, @n, @o, @t, @k, )b, (c, (q, )q, (l, )l, (f, @q, PE): Updated.
-	* doc/meref.me: Document changes.
+2020-10-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/preproc/tbl/table.cpp (ROW_START_LINE_REG)
-	(ROW_SAVE_LINE_REG, ROW_MAX_LINE_REG, REPEATED_NM_SET_MACRO)
-	(REPEATED_NM_SUS_MACRO): New macros.
+	* tmac/andoc.tmac: When switching between macro packages in
+	andoc and using continuous-rendering mode, flush any partially
+	collected output line and write page footer.
+	(reload-doc): Call an-end if it is defined.
+	(reload-man): Call doc-end-macro if it is defined.
+	* tmac/tests/andoc-flush-between-packages.sh: Add regression
+	test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?59106>.
+
+2020-10-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/andoc.tmac: Remove traps set by mdoc package by the names
+	they actually use.
+	* tmac/tests/andoc-clear-doc-traps.sh: Add regression test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?59246>.
+
+2020-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::init_output): In the release
+	macro written to the output, reword the warning diagnostic that
+	is emitted when a table row is to be output without enough room
+	before the next page location trap.  The former wording said
+	that a "text block" would not fit on the page, and that is
+	normally how table rows grow longer than one line in the first
+	place.  However, there are other ways the conditional can be
+	satisfied, as witnessed in Savannah #57665, so simply say what
+	is known; that the table _row_ overruns the space to the next
+	trap (we say the row won't "fit on the page").
+
+	Fixes <https://savannah.gnu.org/bugs/?59233>.
+
+2020-10-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp
+	(double_line_entry::double_line_entry):
+	(double_line_entry::simple_print): Remove garbage lines
+	inadvertently added in previous commit.
+
+2020-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Stop tbl from injecting spurious blank lines (and emitting
+	spurious warnings about tables and "text blocks" not "fitting on
+	a page") into long tables in man pages when continuous rendering
+	is used (the default for nroff output devices).
+
+	* src/preproc/tbl/table.cpp (USE_KEEPS_REG): New preprocessor
+	symbol stores name of groff register for dynamic determination
+	of keep usage.
+	(table::init_output): If the NOKEEP flag is not set, then in
+	generated groff output, see if the usekeeps register is defined;
+	if not, define it and enable usage of keeps.
+	(table::do_row): In groff output, check usekeeps register before
+	calling keep and release macros.
+	(table::do_bottom): In groff output, check usekeeps register
+	before calling release macro.
+
+	* tmac/an-old.tmac (TS): Set the usekeeps register used by tbl
+	to the logical complement of the man(7) cR (continuous
+	rendering) register.
+
+	* tmac/tests/an-old_TS_do_not_keep_tables_when_cR_set.sh: Add
+	regression test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+	Problem appears to date back to the introduction of continuous
+	rendering in groff 1.17 (3 May 2001).
+
+	Fixes <https://savannah.gnu.org/bugs/?57665>.
+
+2020-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (simple_entry::position_vertically):
+	(block_entry::position_vertically):
+	(table::determine_row_type):
+	(printfs): Update assertions to indicate what actually went
+	wrong.
+
+2020-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/node.cpp: Make diagnostics slightly more
+	informative in unusual error cases.
+	(real_output_file::~real_output_file): If ferror() reports error
+	status on a stream say that, instead of "error writing".  If it
+	does not, but fflush() fails on the stream, describe the flush
+	as failing, and use strerror() since fflush() sets errno.  If
+	pclose() fails, say that we were unable to close a pipe instead
+	of repeating the name of the C library function to the user, who
+	might not be a C programmer.  Report strerror() in this case and
+	for a failing fclose().
+	(real_output_file::flush): Repeat updated fflush() logic from
+	previous function.
+
+2020-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (register setup): Make interaction of \nC
+	register and HTML output more clear in code and comments.
+
+2020-09-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/regression_savannah_59202.sh: Reduce test
+	case.
+
+2020-09-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix SEGV arising from recursing destructor.
+
+	* src/roff/troff/node.h (output_file): Add class member
+	`is_dying` to track whether destructor has already been entered;
+	initialize false.
+	* src/roff/troff/node.cpp (real_output_file::~real_output_file):
+	Set `is_dying` true when destructor entered.
+	* src/roff/troff/div.cpp (cleanup_and_exit): Only delete
+	`the_output` object if it is not already being destroyed.
+	* src/roff/groff/tests/regression_savannah_59202.sh: Add test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	Thanks to "hackerb9" for reporting the problem.  Problem appears
+	to date back to groff 1.02 (June 1991) or earlier.
+
+	Fixes <https://savannah.gnu.org/bugs/?59202>.
+
+2020-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (register setup): Condition decisions on
+	\nan-html rather than a string comparison using \*.T; that
+	is what the register is there for.
+
+2020-09-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/andoc.tmac: Save alias to .ne request.
+	(reload-doc): Restore .ne request, which an-old.tmac meddles
+	with if continuous rendering is used.  (The meddling ultimately
+	dates back to 777e2d262862621966c18d685a000cc88f432bc6, 26
+	January 2002, which simply redefined .ne as empty on nroff
+	devices.)
+
+2020-09-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Ship tests in distribution archive.
+
+	* src/preproc/preconv/preconv.am (EXTRA_DIST):
+	* src/roff/groff/groff.am (EXTRA_DIST):
+	* src/roff/nroff/nroff.am (EXTRA_DIST):
+	* tmac/tmac.am (EXTRA_DIST): Add
+	$({preconv,groff,nroff,tmac}_TESTS), as appropriate.
+
+	* src/roff/nroff/nroff.am (MOSTLYCLEANFILES): Stop adding
+	$(nroff_TESTS), which can only have unhappy consequences.
+
+2020-09-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am: Fix problem with recently-relocated mdoc macro
+	files not ending up in the right place in the distribution
+	archive.
+	(dist_tmac_DATA): Also include $(TMACUNSTRIPFILES).
+	(TMACMDOCSTRIPFILES): Rename from $(TMACMDOCFILES).  Update
+	interpolation sites.
+	(TMACMDOCUNSTRIPFILES): New variable holds mdoc macro files in
+	the tmac/mdoc subdirectory.  Stop adding these files to
+	$(TMACUNSTRIPFILES) since those reside in tmac/ directly.
+	(EXTRA_DIST): Add $(TMACMDOCUNSTRIPFILES).
+	($(TMACSTRIPFILES)): Depend only on $(TMACUNSTRIPFILES).
+	($(TMACMDOCSTRIPFILES)): Add new rule, much like the foregoing.
+	Depend on $(TMACMDOCUNSTRIPFILES) and copy files into tmac/mdoc.
+	(dist-hook, tmac-dist-hook): Remove; they no longer do any
+	distinct work.
+
+	Fixes <https://savannah.gnu.org/bugs/?59186>.
+
+2020-09-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/tbl/table.cpp (table::init_output):
+	(table::compute_expand_width):
+	(table::compute_separation_factor): Use consistent format for
+	diagnostic messages.
+	  - Do not spread a single diagnostic across multiple lines.
+	  - Report messages in GNU Coding Standards format, that is:
+	  - Report the name of the file the problem is in...
+	  - ...then the line number...
+	  - ...then the diagnostic severity level...
+	  - ...then the specific problem.
+
+2020-09-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Emit warnings when configuration registers
+	are ignored when producing output for HTML.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (an-p-footer): Define \*an-page-string if
+	(1) the output device is not HTML; (2) \nX has been defined;
+	and (3) the page number has not yet reached the threshold
+	defined by \nX.
+
+	Fixes <https://savannah.gnu.org/bugs/?59179>.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #59179.
+
+	* tmac/tests/an-old_X_register_works.sh: Do it.
+	* tmac/tmac.am (tmac_TESTS): Run it.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac:
+	* tmac/doc.tmac-u: Emit more informative fatal diagnostic when
+	installed version of groff is too old.  Report the version found
+	and explicitly note consequent abort.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am: Regenerate stripped macro files upon changes to
+	any of their unstripped counterparts.  This is crude, but they
+	weren't being regenerated at _all_.  Defeating a central
+	function of Make is bad.
+	(TMACUNSTRIPFILES): New variable.  Populate with -u files.
+	($(TMACMDOCFILES) $(TMACSTRIPFILES)): Depend on
+	$(TMACUNSTRIPFILES).
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac:
+	* tmac/andoc.tmac:
+	* tmac/doc.tmac-u:
+	* tmac/s.tmac: Clarify fatal diagnostics by informing the user
+	that the program is aborting.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/www.tmac.in: Revise diagnostic message handling.
+	(www:fatal): New macro handles fatal macro usage errors.
+	(www:lenstr): Use www:fatal instead of writing to standard error
+	with .tm (rather than www:error) and then calling .ab without
+	arguments, which produces an unsightly "User Abort." message.
+	(www:lenstr):
+	(www:splitstr):
+	(www:url_breaks):
+	(www:url_breaks_split):
+	(LINKSTYLE): Report expected number of arguments in diagnostics.
+	(www:fontstyle): Shorten diagnostic message.
+
+2020-09-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/div.cpp
+	(top_level_diversion::clear_diversion_trap): Fix copy and paste
+	error in diagnostic, which wrongly reported that a top-level
+	diversion trap couldn't be "set" when "clear"ed was meant.
+
+2020-09-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/grn/main.cpp (conv):
+	* src/roff/troff/node.cpp (suppress_node::tprint): Remove
+	embedded newlines from diagnostic messages.
+
+2020-09-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Move setup of remaining rendering option
+	parameters (registers C, D, P, and X) to end of file.
+
+2020-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Move setup of rendering parameter
+	registers IN and SN from here to the end of the file.  Update
+	comments.
+
+2020-09-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Drop \*an-empty string.  This string is
+	documented as preventing "looping" (presumably infinitely) if
+	someone calls a two-font macro with an inconvenient parameter;
+	the example shown is ".RB ( \\ )".  This string was being
+	interpolated at the end of each argument pair to the two-font
+	macros BI, BR, IB, RB, and RI.  This code dates back to groff
+	1.10 (dc5351364982f78f8c630f1e856d692d4a82666f, 26 November
+	1995).  Did you notice a two-font macro missing?  It was: IR.
+	Using it with the proscribed input fails to cause a problem; the
+	others similarly operate just fine when the empty string
+	interpolation is removed.  Presumably at some point in the past
+	25 years, this workaround became unnecessary.
+	(BI, BR, IB, RB, RI): Remove interpolations of string.
+
+	* tmac/tests/an-old_avoid_two-font_denial_of_service.sh: Add
+	regression test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Refactor continuous rendering handling.
+	Relocate set up of \ncR to end of file in parallel with other
+	rendering parameter management.  Instead of conditionally
+	defining the an-ne and an-bp macros, define them
+	unconditionally.  Also define them with .de instead of .de1,
+	since they will only be called within the contexts of macros
+	that are already running with compatibility mode off (i.e., the
+	public interface macros).  Relocate definition of an-end to sit
+	alongside these other continuous-rendering-mode specific macros
+	and avoid a forward reference and scattering of \ncR
+	conditionals around the file.
+	(an-set-up-continuous-rendering): Define new macro to move
+	macros (and end macro) into place.  Call it at the end of the
+	file only if cR eventually winds up being true.
+
+2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Improve name space management.  Rename .ne
+	request to .an-ne instead of outright clobbering it (and in
+	parallel with .an-bp).  Rename 'an-ne' register to 'an-need' to
+	prevent confusion with renamed request.
+
+2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Drop .ll hack for LL register.
+
+	Drop the .ll hack for setting the line length on nroff devices.
+
+	Once upon a time, the only way to get man pages to render on a
+	terminal at any width other than the nroff default of 65n was to
+	put an .ll request into the page--a mortal sin against
+	portability--or your man(1) program could sneak such a request
+	into nroff's input stream.
+
+	Also, long ago, John Eaton of UT Austin wrote a man(1) program.
+	In a few years this implementation branched into two lines of
+	development, which I'll call man-db man (Wilford/Polacco/Watson)
+	and another, Brouwer/Lucifredi man, which as of this writing saw
+	its last release in 2011 (1.6g).
+
+	The man and mdoc macros of groff 1.18 (July 2002) introduced an
+	LL register to configure the line length, respecting an -rLL
+	command-line option.  The source change was made by Werner
+	Lemberg on 3 May 2002 and Colin Watson updated man-db man(1)--on
+	the same day!--to synthesize the option when calling groff.
+
+	Later, in August 2005, Keith Marshall, a user of version 1.5m of
+	Brouwer/Lucifredi man(1), which did not set the LL register,
+	suggested that the existing .ll setting (technically, the value
+	of \n.l, the only way the result of an .ll request could be
+	introspected) be honored in the absence of the LL register.
+	However, it is impossible to distinguish a user-supplied ".ll
+	65n" request from nroff's default setting, which was in that
+	case overridden to the modern default of 78n.
+
+	And so, in what is now git commit
+	f9d5df4aebd3d834b4084ffefa52a115e00dce38 (1 September 2005), it
+	was done.
+
+	This led to (1) surprising behavior for users accustomed to old
+	methods and desirous of the nroff default and (2) lengthy
+	apologia in groff source code comments and the groff_man(7) man
+	page.
+
+	Ironically, Brouwer/Lucifredi man(1) had already added support
+	for the LL register by the time of its 1.6 release two months
+	earlier (20 June 2005).  (Curiously, it did so similarly to the
+	old .ll hack, by injecting an '.nr LL' request into groff's
+	input stream, rather than using the -r command-line option.)
+	Moreover, Marshall and the groff list were already aware of
+	this, but the change was accepted anyway because version 1.6
+	was "too new"!  (Distributions are slow sometimes, true...)
+
+	Let us survey the field in 2020.  man-db man(1) has supported
+	the LL register for eighteen years, and Brouwer/Lucifredi man(1)
+	for fifteen.  Heirloom Doctools's man macros set the line length
+	to 78n on nroff devices unconditionally.  mandoc(1) similarly
+	also always formats for 78 columns on terminals.  groff's
+	mdoc(7) macros grew support for LL in parallel with man(7) in
+	2002 and never added the \n.l introspection at all.
+
+	There no longer seems to be any reason to preserve this hack.
+
+	* tmac/an-old.tmac (initialization): Drop complex setup of LL
+	register.
+	(TH): Relocate line length reset; no behavior change.
+	(after .mso man.local): Initialize LL only if the user hasn't;
+	use device default in troff mode, and 78n in nroff mode.
+
+	* tmac/groff_man.7.man.in (Options) <-rLL>: Stop documenting .ll
+	hack.
+
+	Fixes <https://savannah.gnu.org/bugs/?58992>.
+
+2020-09-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_LL_init_sanely.sh: Add test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2020-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/devices/xditview/GXditview.ad: Widen the default geometry
+	to accommodate the width of a page rendered using the X100-12
+	device.  Display devices these days have much greater horizontal
+	resolution than they did 20 years ago.
+
+2020-09-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Use correct point size default for
+	X{75,100}-12 devices.
+
+2020-09-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/mdoc/doc-common-u (doc-prepare-section-heading): New
+	macro defines new string doc-sec-head to enable recognition of
+	mixed-case section headings in mdoc man pages.  For example,
+	"Name" and "Description" are now recognized in addition to
+	"NAME" and "DESCRIPTION".
+	(doc-section-{name,synopsis,library,description,see-also,files,
+	authors}): Redefine strings to be mixed-case.  Add trailing
+	comment guard per recommended best practice.
+	(Sh): Call doc-prepare-section-heading instead of
+	doc-first-parameter, and compare predefined section strings to
+	doc-sec-head instead of doc-str-dfp.
+
+	* tmac/tests/doc-accept-mixed-case-section-headings.sh: Test it.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+	* tmac/tests/doc-smoke-test.sh: Use mixed-case section headings.
+
+2020-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* makevarescape.sed: Use \ form of special character escapes.
+
+	The only man page we have that doesn't turn compatibility mode
+	off (neqn) also doesn't use any sed-substituted patterns where
+	characters replaced by a \ special character escape form are
+	likely to be used.
+
+	The @g@ command prefix is the main avenue for intrusion of such
+	escapes, but I think it improbable that many people are going to
+	include apostrophes, double quotes, carets, grave accents, or
+	tildes in the command prefix; some or all of these will pick
+	fights with the shell and require quoting that we don't
+	represent in man page text anyway.
+
+	On top of that, neqn is largely a stub page.
+
+	If it's a problem, a better fix than reverting this is to make
+	neqn switch out of compatibility mode like our other man pages.
+
+2020-09-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* FOR-RELEASE: Start a release checklist.  We probably should
+	have done the afmtodit.tables update for 1.22.4.  There were no
+	AGL changes and the Unicode decomposition changes were limited
+	to additions for Balinese (11), CJK compatibility ideographs
+	(5), and 13 code points outside the Basic Multilingual Plane.
+
+2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.tables: Regenerate using Unicode
+	13.0.0.
+
+2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	make-afmtodit-tables: Automate AGL reassignments.
+
+	Automate the procedure done manually in
+	b72b91e85e80a69304e6569db535bcca0e0ecab5 (9 April 2007), so that
+	it doesn't regress when we regenerate afmtodit.tables.
+
+	* src/utils/afmtodit/make-afmtodit-tables: Do it.
+	* src/utils/afmtodit/afmtodit.tables: Regenerate it.
+
+2020-09-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/groff.1.man (Options) <-E>:
+	* src/roff/troff/troff.1.man (Options) <-E>: Document that -E
+	implies -Ww.
+
+	Fixes <https://savannah.gnu.org/bugs/?59030>.
+
+2020-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_char.7.man: Revise glyph descriptions.
+
+	Fixes <https://savannah.gnu.org/bugs/?59031>.
+
+2020-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tty.tmac: Define fallback glyphs for Bell System logo
+	{non-breaking adjustable space} and radical extension and square
+	root extension (both dummy characters '\&') to suppress warnings
+	from groff_char(7).  As none of these are encoded in Unicode it
+	seems unlikely they will become supported soon.
+
+2020-08-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/troff.1.man (Options) <-I>: The current working
+	directory is searched _last_, not first, unless the order is
+	altered with "-I .".
+
+	* src/roff/groff/groff.1.man (Options) <-I>: Rearrange
+	description.
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Update mdoc package to honor HY register as man does now, per
+	suggestion from Colin Watson.  Recognize but ignore AD string
+	for man package compatibility (essentially "reserving" it),
+	though mdoc intentionally does not permit configuration of
+	adjustment.
+
+	* tmac/mdoc/doc-ditroff-u:
+	* tmac/mdoc/doc-nroff-u: Do it.
+
+	* tmac/mdoc/doc-common-u: Initialize \ndoc-hyphen-flags from
+	\nHY.
+
+	* tmac/groff_mdoc.7.man \
+	(FORMATTING WITH GROFF, TROFF, AND NROFF): Document it.
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Reset inter-word and inter-sentence
+	spacing to default with each new page rendered.
+
+	{To observe the problem prior to this change,
+	  $ groff -mandoc groff_mmse.7 $any_other_man_page
+	groff_mmse(7) loads sv.tmac, which changes the sentence
+	spacing.}
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* PROBLEMS: Undocument the problem with test-groff and mdoc.
+	It's resolved.
+
+	Fixes <https://savannah.gnu.org/bugs/?51073>.
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am (NORMALFILES, MDOCFILES): Drop unused variables.
+	($(TMACMDOCFILES) $(TMACSTRIPFILES)): Scrub trailing whitespace.
+	Wrap long line.
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mdoc: Relocate within build tree.
+
+	The (modern) mdoc macro package has not been usable within the
+	build tree, unlike the others.  This makes it more troublesome
+	to test changes, and frustrates deploying our test
+	infrastructure against it.  Re-arrange the build tree to
+	resemble an installation tree closely enough for the macro
+	package to load.
+
+	* tmac/doc-common-u:
+	* tmac/doc-ditroff-u:
+	* tmac/doc-nroff-u:
+	* tmac/doc-syms-u: Rename to...
+	* tmac/mdoc/doc-common-u:
+	* tmac/mdoc/doc-ditroff-u:
+	* tmac/mdoc/doc-nroff-u:
+	* tmac/mdoc/doc-syms-u: ...these.
+
+	* tmac/tmac.am (TMACMDOCFILES): Look for files in tmac/mdoc.
+	($(TMACMDOCFILES)): Create tmac/mdoc in build tree.
+
+	Fixes <https://savannah.gnu.org/bugs/?51003>.
+
+2020-08-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for usable in-tree mdoc.
+
+	* tmac/tests/doc-smoke-test.sh: Add test.
+	* tmac/tmac.am (tmac_TESTS): Run test.
+
+2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_TH_repairs_ad_damage.sh:
+	* tmac/tests/an-old_TH_repairs_hy_damage.sh: Add tests.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
+
+2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Set hyphenation mode to user preference
+	with each new page rendered, in case a hostile page meddled with
+	'.hy' or '.nh'.
+	(after .mso man.local): Relocate setting of default hyphenation
+	mode here (instead of just before .mso man.local).  Eliminate
+	conditional on \nan-html; this doesn't matter because
+	grohtml(1) doesn't support hyphenation anyway.  If it does learn
+	to hyphenate, we should treat it the same as other output
+	devices in any case.  Add comment explaining why we fall back to
+	different defaults depending on \ncR.
+
+2020-08-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (TH): Set adjustment to user preference with
+	each new page rendered, in case a hostile page meddled with
+	'.ad' or '.na'.
+	(after .mso man.local): Set the default adjustment mode only if
+	a -d option or man.local did not.  Also do the same for the HF
+	string; relocate its definition here and make it similarly
+	conditional.  Also update comment on setting of CS and CT
+	registers and style their conditionals consistently with the
+	rest of the package.
+
+	* tmac/groff_man.7.man.in (Strings) <\*(AD>: Document it.
+	(Strings) <\*(HF>: Parallelize language with new \*(AD.
+	(Options) Expand introductory sentence to discuss -d and -r
+	options.
+	(Options) <-dAD>: Document default and likely values.  Nobody
+	right-justifies or centers man page text; send the curious to
+	groff(7) for '.ad' request documentation.
+	(Options) <-dHF>: Document default and steer people to groff(7)
+	for '.ft' request documentation.
+
+2020-08-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac (set-an-margin): Rename...
+	(an-set-margin): ...to this.  It was the only package-internal
+	register, macro, string, or diversion that wasn't named using
+	the "an-*" schema.
+	(TH, SH, SS): Update call sites.
+
+2020-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac (.ME, .UE): Restore hyphenation after
+	"punctuation" arguments have been output.  The next token will
+	always be a space node, the end of the document, or similar.
+
+	* tmac/tmac.am (tmac_XFAIL_TESTS): Mark the punctuation
+	hyphenation tests as expected to fail, because they now do.
+
+2020-08-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/ps.tmac: Define ordinary hyphen-minus as fallback
+	character for U+2011 (non-breaking hyphen).  Prompted by
+	discussion with Dave Kemper in Savannah #58390.
+
+2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix hyphenation bug.  The UR/UE and MT/ME macros were much too
+	aggressive about turning hyphenation off.  Disable it only when
+	writing the actual URL or email address.
+
+	* tmac/an-ext.tmac (.MT, .UR): Stop disabling hyphenation here.
+	(.ME, .UE): Disable hyphenation right before output of
+	URL/address; restore it right before output of supplementary
+	arguments ("punctuation").
+
+	* tmac/tests/an-ext_ME_punct_hyphenates.sh:
+	* tmac/tests/an-ext_MT_body_hyphenates.sh:
+	* tmac/tests/an-ext_UE_punct_hyphenates.sh:
+	* tmac/tests/an-ext_UR_body_hyphenates.sh: Test behavior.
+
+	* tmac/tmac.am (tmac_TESTS): Run tests.
+
+2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Adapt to the fact that \: reënables hyphenation.  Rename
+	"hyphenless discretionary break" to "non-printing break point"
+	in documentation.
+
+	* doc/groff.texi (Manipulating Hyphenation): Rename "hyphenless
+	break" to "non-printing break point".  Clarify that it is the
+	soft hyphen glyph, not necessarily a hyphen, that is ordinarily
+	written to the output on hyphenation breaks.  Note that the
+	remainder of a word after \: is subject to hyphenation as
+	normal.  Note (new) '\:\%' idiom for getting what people will
+	want at least some of the time.  Update example to use it.
+	* makevarescape.sed: Insert \% after we insert \: to rewrite
+	slashes in filenames, to protect later portions of the filename
+	from hyphenation.
+	* man/groff.7.man (Escape Sequences/Escape short reference):
+	Rename "hyphenless break" to "non-printing break point".
+	* man/groff_diff.7.man (Language/Escape sequences): Resync with
+	our Texinfo manual.
+	* tmac/groff_man.7.man.in (Description/Hyperlink and email
+	macros): Rename "hyphenless break" to "non-printing break
+	point".
+
+2020-08-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	documentation: Re-christen 'ESCAPE_AMPERSAND'.
+
+	s/zero- width space character/non-printing input break/
+
+	* doc/groff.texi (Requests): Rename.  Update conceptual index
+	entries; retain old name (with an appended "sic") to aid
+	readers accustomed to it.
+	(Ligatures and kerning): Update conceptual index entries.
+	Supply context ("effect on kerning").
+	(Drawing requests): Update conceptual index entries.  Supply
+	context ("effect on '\l'").
+	* man/groff.7.man (Description): Rename in macro-advice-writing
+	shorthand.
+	(Escape Sequences/Escape short reference): Rename.
+	* tmac/groff_man.7.man.in (Description/Command synopsis macros
+	style: Rename.
+	(Description/Portability) style: Rename.
+	* tmac/groff_mdoc.7.man (TROFF IDIOSYNCRASIES/Macro Usage):
+	Rename.
+	(TROFF IDIOSYNCRASIES/Other Possible Pitfalls): Rename.
+
+2020-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man.in (Description/{Document structure
+	macros <.TH>, Horizontal and vertical spacing}): Fix erroneous
+	use of "flush left".  The current uses were introduced by me,
+	but the page has borne incorrect uses of it as far back as 1999
+	{in the description of .TP}.  Simply say "with no indentation"
+	instead.
+
+2020-08-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man.in (Description/Number registers): Inform
+	reader that registers can be set in man.local file and
+	cross-reference it.
+	(Files/*/man.local): style Supply example of man.local
+	customizations, prompted by recent discussions on groff,
+	linux-man, and man-db mailing lists.
+
+2020-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tmac.am: Use a stamp file for m4 keyword check.
+	(M4CHECK): Add stamp file variable.
+	($(M4CHECK)): Create stamp file if check succeeds.
+
+2020-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Split groff_man(7) into two pages; one a (relatively) terse
+	reference and the other a tutorial and style guide.  Both are
+	generated from the same source, which is processed by m4 into
+	two man page sources.
+
+	* tmac/groff_man.7.man: Rename...
+	* tmac/groff_man.7.man.in: ...to this.
+
+	* tmac/groff_man.7.man.in: Add m4 directives and define macros.
+	Protect m4 keywords in English from unintended expansion (this
+	affected the word "include").  Add new .TH and apropos lines for
+	style guide.  Convert marker comments into m4 macros for content
+	control.  Uncomment material intended only for basic reference
+	page.
+
+	* tmac/tmac.am (man7_MANS): Add groff_man_style.7.
+	(EXTRADIST) Add groff_man.7.man.in.
+	(MOSTLYCLEANFILES): Add m4-generated man page sources
+	tmac/groff_man{,_style}.7.man.
+	Add targets to generate those same two pages from the renamed
+	file.  Add target to grep the page for unprotected English m4
+	keywords and halt the build if they are found.  Make generation
+	of those pages depend on this new target.
+
+2020-08-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man: Add material on hooks and encoding.
+	(Description, ./Deprecated features): Stop identifying .PT and
+	.BT as "deprecated"; they shouldn't ever be called in man pages,
+	but that has never been their intention.
+	(Description): Identify character encoding and line-ending
+	requirements (tutorial/style-guide material).
+	(Description/Hooks): Add new subsection to house descriptions of
+	.PT and .BT.  Add mnemonic expansions for both.
+
+2020-07-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Control Characters): Incorrect claims were
+	made.  Double quotes can indeed be used to enclose arguments to
+	string interpolations.  The statement about a leading " in a
+	string definition (or appendment with .as) was stated too
+	generally.  The leading quote is not necessary to include
+	leading tab characters, which can be input as-is, even in
+	compatibility mode.
+
+2020-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Requests/Request short reference/.ft): Fix
+	some outright damage in the description of the request; the
+	escape sequences that are synonymous with a nullary .ft had been
+	wrongly removed.
+
+2020-07-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/meintro.me:
+	* doc/meref.me:
+	* tmac/e.tmac-u: Remove postal address for Eric Allman.  It's
+	probably decades out of date.  Adjust footnote symbols.  Thanks
+	to Dave Kemper for the bug report and the patch.  Fixes
+	<https://savannah.gnu.org/bugs/?58726>.
+
+2020-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Migrate macro packages from font CW to CR.  The font name "CW"
+	{"constant-width"} is a legacy item we can dispose of (except
+	for the DVI device, which also has CWI for "constant-width
+	italic"), and much of the groff codebase already did starting
+	with commit 0de1d6d79cdb959ffa7dac3af77c2a36ef31873f {October
+	2017}.  Courier is available in the usual four styles {roman,
+	bold, italic, bold+italic}.
+
+	* tmac/an-ext.tmac (.EX): Set font to R, not CW.  The existing
+	.ft request was somewhat redundant with the '.do fam C'
+	immediately before, which set the font family to Courier.
+	* tmac/s.tmac (.UC): Use font CR, not CW.
+
+2020-07-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tty.tmac: Stop suppressing nonexistent font warning.
+	Prompted by a 2017 suggestion and patch from Bjarni Ingi
+	Gislason.  Documents and macro packages that want to change the
+	font family should do so in awareness that this is meaningless
+	on terminal (nroff) devices (and -Thtml as well).
+
+	Fixes <https://savannah.gnu.org/bugs/?51364>.
+
+2020-07-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man (.PP, .LP, .P): Fix error: these macros
+	do not reset the left margin.
+
+2020-07-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Strings): Document behavior of .ds request
+	when only one argument is supplied.  (The string is defined as
+	empty.)  Thanks to Dave Kemper for the report and the patch.
+
+	Fixes <https://savannah.gnu.org/bugs/?58746>.
+
+2020-07-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Using Symbols): Fix error in .rfschar
+	description, which should refer to "font f" rather than "glyph
+	f".  Thanks to Dave Kemper for the report and the patch.
+
+	Fixes <https://savannah.gnu.org/bugs/?58767>.
+
+2020-07-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man (.EE, .YS): Fix error: refer to "initial
+	hyphenation setting" instead of "previous hyphenation mode".
+	Incidentally, this fact points out why putting ".hy 0" or ".nh"
+	in your man page is futile.
+
+2020-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Requests/Request short reference): Fix error
+	in description of .hc; it changes the hyphenation character
+	rather than supplying an additional one.
+
+2020-06-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Groff Options): Remove editorial comment about
+	'-a' option being "useless".  It isn't.  Update example for
+	contemporary systems (like Debian) and to reflect the fact that
+	the GNU troff(1) man page needs to be preprocessed with tbl(1).
+	(Invoking grotty): Recast discussion of -c option, importing
+	much language from grotty(1) page rewrite from a year ago.  Add
+	program index entries for col, more, and ul.  Fix transposition
+	error in ISO document number.
+
+	* src/devices/grotty/grotty.1.man (Description/Legacy output
+	format): Make slight wording changes prompted by content of
+	parallel section in our Texinfo manual.
+
+	* src/roff/groff/groff.1.man (Options/-a): Parallelize with
+	first sentence of corresponding material in our Texinfo
+	manual.
+
+	* src/roff/troff/troff.1.man (Options/-a): Parallelize with
+	our Texinfo manual.
+
+	Fixes the rest of
+	<https://savannah.gnu.org/bugs/?55278>.
+
+2020-06-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff_diff.7.man (Language/Long names): Fix error: groff
+	adds three new requests with short names, not two.  List them in
+	an adjacent comment.
+
+2020-06-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-ext.tmac (.ME, .UE): Fix portability issue.  While
+	widely supported, the \$* escape is not documented in CSTR #54.
+	If groff is not the typesetter, append macro arguments using
+	\$1, \$2, ..., \$9 instead.
+
+2020-05-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* man/groff.7.man (Numerical Expressions): Fix error: negative
+	expressions evaluate false, not true as was implied.
+	Parallelize descriptions with our Texinfo manual and
+	groff_diff(7) (in abbreviated form).
+
+2020-05-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Manipulating Filling and Adjusting): Fix error
+	in code sample: missing 'n' in number register interpolation.
+
+2020-05-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/preconv/tests/smoke-test.sh: Make BOM detection
+	override less hinky (i.e., use more normative input).  Add tests
+	for all five detected BOMs.
+
+2020-05-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/env.cpp (space_size): Prevent assertion
+	failure.  If an argument to the .ss request is negative, throw a
+	range warning and ignore it.
+	* src/roff/groff/tests/regression_savannah_58337.sh: Add test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	Fixes https://savannah.gnu.org/bugs/?58337.
+
+2020-05-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Update documentation of .ss request.
+
+	* doc/groff.texi (Manipulating Filling and Adjusting): Rewrite
+	documentation of .ss request and \n.ss and \n.sss escapes.
+	Note that negative values are not permitted in either argument
+	to .ss.  Use new terminology, "minimal inter-word spacing" and
+	"additional inter-sentence spacing" for clarity.  Clarify that
+	additional inter-sentence spacing is only used when the output
+	line is not full when the end of a sentence occurs.  Add index
+	nodes to help readers find discussion of details of spacing
+	between words and sentences.  Move discussion of differences
+	from AT&T troff to section "Implementation Differences".  Update
+	example to more closely resemble a real-world case, use second
+	argument to .ss request, and eliminate hackish use of .nop
+	request.
+
+	* man/groff_diff.7.man (New number registers): Recast in
+	parallel with the foregoing.
+
+	* man/groff.7.man (Read-only registers): Use new terminology and
+	describe \n.ss and \n.sss in meaningful terms, not by
+	reference to arguments to the .ss request (which wasn't even
+	accurate, because these registers have default values).
+
+	Fixes https://savannah.gnu.org/bugs/?54101.
+
+2020-05-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Undocument plans to support end-of-file GNU Emacs coding tags.
+
+	* src/preproc/preconv/preconv.cpp (check_coding_tag):  Update
+	comments.
+	(detect_file_encoding): Alter debugging output so it's easier to
+	grep and verify Emacs coding tag detection.
+
+	* src/preproc/preconv/preconv.1.man (Bugs): Delete; its sole
+	concern was the absence of this feature.
+	(Usage): Document detection algorithm in more detail.  Note
+	which detection methods don't work on unseekable input (pipes).
+	Offer recommendations for those struggling with encoding
+	detection.
+	(Usage/Coding Tags): Stop manipulating line adjustment.  Use
+	hyphen-minus (\- escape) characters in coding tag names, since
+	they are literals that one might copy and paste.  Stop
+	referencing XEmacs, whose development appears moribund.
+	(See Also): Add cross-references to iconv(3) and locale(7) man
+	pages.
+
+	* src/preproc/preconv/tests/smoke-test.sh: Test each of the
+	steps in the detection algorithm.
+	* src/preproc/preconv/preconv.am: Run test.
+	(preconv_TESTS): Add new variable.
+	(TESTS): Append $(preconv_TESTS).
+
+2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/afmtodit/afmtodit.pl: Format usage message with
+	full capitals for parameters, and break out -v option in a
+	separate "synopsis".
+
+2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/util/BuildFoundries.pl: Stop throwing away
+	diagnostics from afmtodit.  This results in only one extra line
+	of build output:
+
+		both Upsilon1 and Upsilon map to *U at .../afmtodit line
+		6413.
+
+2020-05-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Correct documentation of .pm request.
+
+	* man/groff.7.man (Requests/Request short reference): The .pm
+	request's classical behavior was described instead of groff's,
+	and omitted mention of strings and diversions; correct it.
+
+	* man/groff_diff.7.man (Implementation Differences): Document
+	this difference between AT&T troff and groff.
+
+	* doc/groff.texi (Debugging): Relocate description of .pm
+	behavioral difference...
+	(Implementation Differences): ...hither.
+
+2020-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/addftinfo/addftinfo.cpp (usage):
+	* src/utils/tfmtodit/tfmtodit.cpp (usage): Add "usage:" prefix
+	to messages documenting auxiliary modes of invoking the program.
+	The output doesn't look right without one, and it feels
+	dishonest to not document the relevant options (-v, --version)
+	disjunctively.  I'm trying to strike a balance between the
+	ultra-terse BSD approach and the ultra-garrulous GNU one (see,
+	e.g., ls(1)).  Likely both camps will be unhappy.  :-/
+
+2020-04-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/tfmtodit/tfmtodit.cpp (read_map): Report invalid
+	character code from map file in diagnostic.
+	(main): Report invalid skew character position in diagnostic.
+	Explicitly report insufficient arguments in addition to usage
+	message.  Lift invariant computed expressions out of loops (more
+	to shorten long lines than because I think the compiler won't
+	figure it out).  Give content to "impossible assertion".
+	(tfm::load): Capitalize TFM initialism in diagnostics.
+	(usage): Use full capitals for parameters as is conventional.
+	Document disjunction of -v/--version flag from other
+	invocations.
+
+2020-04-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/addftinfo/addftinfo.cpp (usage): Add overloaded
+	version that accepts a constant string argument, which emits the
+	argument as a diagnostic and then calls usage().
+	(main): Add diagnostics to usage message where the problem is
+	clear.  Add comment explaining why it sometimes isn't.
+	(usage): Refactor main usage message (which prints the summary)
+	to report the actual names of the accepted option arguments
+	instead of just "-param", which is not literally accepted.
+
+	Sort param_table alphabetically for use by the usage message.
+
+2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Delete groffer.
+
+	Per discussion on the groff development mailing list, there is
+	no desire to retain the maintenance of this portion of the groff
+	distribution.
 
-	(table::init_output): Define REPEATED_NM_SET_MACRO and
-	REPEATED_NM_SUS_MACRO.
-	(table::print_single_hline, table::print_double_hline,
-	table::define_bottom_macro, table::do_row, table::do_top,
-	table::do_bottom): Updated.
+	See
+	<https://lists.gnu.org/archive/html/groff/2020-04/msg00051.html>
+	et seq.
+
+	* contrib/groffer: Recursively delete.
 
-	* doc/webpage.ms: Updated.
+	* Makefile.am:
+	* arch/mingw/mingw.am: Stop building groffer.
 
-2011-07-12  Ted Harding  <ted.harding@wlandres.net>
-	    Werner LEMBERG <wl@gnu.org>
+	* m4/groff.m4 (GROFF_GROFFERDIR_DEFAULT):
+	(GROFF_GROFFERDIR_OPTION): Delete; remove "--with-grofferdir"
+	configuration option.
+	* configure.ac: Stop calling these macros.
 
-	* src/preproc/tbl/tbl.man: Mention trick to get abutting rules.
+	* MANIFEST:
+	* NEWS:
+	* PROJECTS:
+	* TODO:
+	* contrib/chem/chem.1.man:
+	* contrib/chem/examples/122/README.txt:
+	* contrib/chem/examples/README.txt:
+	* contrib/glilypond/glilypond.1.man:
+	* contrib/gperl/gperl.1.man:
+	* contrib/gpinyin/gpinyin.1.man:
+	* contrib/groff_filenames/groff_filenames.5.man:
+	* man/groff_font.5.man:
+	* man/roff.7.man:
+	* src/roff/groff/groff.1.man:
+	* src/roff/grog/grog.1.man:
+	* src/utils/addftinfo/addftinfo.1.man:
+	* tmac/groff_trace.7.man: Delete references to groffer.
+
+2020-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/include/curtime.h: #include <time.h> if we're returning
+	a time_t from current_time().
+
+	* src/libs/libgroff/curtime.cpp (current_time): Quote
+	$SOURCE_DATE_EPOCH variable content in diagnostics produced due
+	to bad input since it's under user control and could have all
+	kinds of bogosity in it (like whitespace).
+
+2020-04-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* **/*.{man,tmac}: Save compatibility mode robustly.
+
+	Use new \n.cp register to save compatibility mode.
+
+	Use register names based on the filename (at the source
+	maintenance level) to avoid clobbering other files' saved
+	compatibility modes.
+
+	* tmac/html.tmac: Eliminate test of saved-compatibility
+	register by moving its body inside the block where compatibility
+	mode is off.  This is the only part of this changeset that was
+	not automated.
+
+	Fixes <https://savannah.gnu.org/bugs/?58162>.
+
+2020-04-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Implement new read-only .cp register.
+
+	Within a .do request, \n.cp holds the saved value of
+	compatibility mode.
+
+	The register \n.cp is specialized and may require a statement
+	of rationale.  When writing macro packages or documents that use
+	groff features and which may be mixed with other packages or
+	documents that do not—common scenarios include serial processing
+	of man pages or use of the .so or .mso requests—you may desire
+	correct operation regardless of compatibility mode in the
+	surrounding context.  It may occur to you to save the existing
+	value of \n(.C into a register, say, _C, at the beginning of
+	your file, turn compatibility mode off with “.cp 0”, then
+	restore it from that register at the end with “.cp \n(_C”.  At
+	the same time, a modular design of a document or macro package
+	may lead you to multiple layers of inclusion.  You cannot use
+	the same register name everywhere or you risk “clobbering” the
+	value from a preceding or enclosing context.  The two‐character
+	register namespace of AT&T troff is confining and mnemonically
+	challenging; you may wish to use groff's more capacious
+	namespace.  However, attempting “.nr _my_saved_C \n(.C” will not
+	work in compatibility mode; the register name is too long.
+	“This is exactly what .do is for,” you think, “.do nr
+	_my_saved_C \n(.C”.  The foregoing will always save zero to your
+	register, because .do turns compatibility mode off while it
+	interprets its argument list.  What you need is:
+		.do nr _my_saved_C \n.cp
+		.cp 0
+	at the beginning of your file, followed by
+		.cp \n_my_saved_C
+	at the end.  As in the C language, we all have to share one big
+	namespace, so choose a register name that is unlikely to collide
+	with other uses.
+
+	* src/roff/troff/input.cpp (do_request, init_input_requests):
+	Implement it.
+
+	* doc/groff.texi:
+	* man/groff.7.man:
+	* man/groff_diff.7.man: Document it.
 
-2011-07-03  Ben Laurie  <benl@FreeBSD.org>
+	* src/roff/groff/tests/dot-cp_register_works.sh: Test it.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
 
-	Fix clang warnings.
+	Enables a fix for
+	<https://savannah.gnu.org/bugs/?58162>.
 
-	* src/libs/libdriver/input.cpp (odd): Use parentheses.
+	Thanks to John Gardner and Ingo Schwarze for the discussion.
 
-	* src/roff/troff/mtsm.cpp (state_set::is_in): Fix parentheses;
-	previous code always tested for bit 0.
+2020-04-15  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-07-03  Guillem Jover  <guillem@debian.org>
+	* doc/groff.texi (Implementation Differences):
+	* man/groff_diff.7.man (New requests): Rewrite description of
+	.do request, and replace example with a more illustrative one.
 
-	mdoc: Update more OS versions strings.
+	* man/groff.7.man (Request short reference): Rewrite description
+	of .do request briefly.
 
-	* tmac/doc-common: Add versions strings for NetBSD, OpenBSD,
-	FreeBSD, and DragonFly.
+2020-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-04-08  Michail Vidiassov  <master@iaas.msu.ru>
+	* doc/groff.texi (Implementation Differences): Remove incorrect
+	claim.  The .C register cannot be manipulated manually.
 
-	mdoc: Update various strings related to Mac OS X and FreeBSD.
+2020-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc-common: Add strings for FreeBSD 8.2 and Darwin 9.7-11.0.
-	* tmac/doc-syms: Add strings -lbsm and -lSystem.
+	* src/roff/groff/tests/smoke-test_html_device.sh: Simplify
+	charmap test.
 
-2011-03-29  Christian Weisgerber  <naddy@mips.inka.de>
+2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix compilation issues with gcc 2.95.
+	It's too easy for the nroff version to get desynced from the
+	groff version when we're running test cases, leading to spurious
+	results.  Make it easier to see a discrepancy.
 
-	* src/roff/troff/input.cpp (my_input_iterator): Define as an alias
-	for `input_iterator' which is predefined by an old libstdc++.
+	* src/roff/nroff/nroff.sh: Call groff with -v or --version when
+	we are called that way.  Let test cases tell us to use
+	test-groff as groff with an environment variable.
 
-2011-03-29  Ingo Schwarze  <schwarze@usta.de>
+	* src/roff/nroff/tests/verbose_option_works.sh.in: Rename to...
+	* src/roff/nroff/tests/verbose_option_works.sh: ...this.  Check
+	the nroff version being tested against the groff version being
+	wrapped.  This exposes a bug; the system groff rather than the
+	build tree groff was being invoked.  Refactor.  Stop messing
+	with @GROFF_BIN_PATH_SETUP@ (enabling the rename); instead, let
+	test-groff handle that for us.  Locate it and export the
+	variable GROFF_TEST_GROFF so nroff can find it.  Because we
+	manipulate $PATH to run the tests, the $PATH of an installed
+	groff system will _always_ differ from that used by a build
+	tree; ignore it in the test cases.  Dispose of bashisms and set
+	shebang to /bin/sh.
 
-	Add another POSIX standard.
+	* src/roff/nroff/nroff.am: Stop generating the above test
+	script.  It can now be run as it ships.
 
-	* tmac/doc-syms: Add POSIX 1003.1b.
+2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-03-29  Christian Weisgerber  <naddy@mips.inka.de>
+	Make our assert() C99-conformant.
 
-	Fix build with non-GNU make.
+	groff has its own implementation of the standard C library's
+	assert() macro.  It hasn't been updated since C89.  C99 requires
+	that the diagnostic emitted by assert() contain the failing
+	expression and name of the function in scope.
 
-	* Makefile.in ($TARGETS): We must not pass `$MDEFINES' recursively
-	down to the sub-makes started in src/libs/gnulib, because that
-	directory has its own values for `$top_srcdir' etc., and
-	overriding those from the command line will cause the build to
-	fail.  Currently, `$MAKEOVERRIDES' will prevent the recursive
-	passing of those overrides with GNU make, but not with other
-	make(1) implementations.  It looks like all targets that require
-	`$MDEFINES' set them explicitly anyway, so we shouldn't need to
-	set `$MDEFINES' on the top level.
+	* src/include/assert.h: Add additional pointer to const char
+	arguments to do_assert() and assertion_failed() for function
+	name and stringified expression.
+	(assertion_failed): Update prototype.
+	(do_assert): Accept 'func' and 'msg' parameters and pass them to
+	assertion_failed().
+	(assert): Update macro to collect '__func__' and stringify the
+	expr parameter (as 'msg') and pass them do do_assert().
+	* src/libs/libgroff/assert.cpp (assertion_failed): Rewrite
+	diagnostic to more closely match GNU Coding Style format and
+	also report function and failing expression.
 
-2011-03-21  Jan Vcelak  <jvcelak@redhat.com>
-	    Bernd Warken <groff-bernd.warken-72@web.de>
+	Example output:
+		troff: ../src/roff/troff/input.cpp:2644: do_request():
+		assertion failed: '0 == "But first, here's a rotten old
+		BBC programme."'
 
-	groffer Remove hardcoded path to 'libdir/groff/groffer'
-	directory.
+	We have no excuse to assert(0) ever again.  Express the
+	invariant that has been violated.
 
-	* configure.ac: add GROFFERDIR variables.
+2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* Makefile.in: add and handle variable groffer_dir
+	* src/roff/groff/tests/smoke-test_html_device.sh: Set
+	LC_CTYPE=C.UTF-8 so that byte sequences in the pipelines are
+	handled correctly.  Skip the test if the environment doesn't
+	support UTF-8.  Thanks to Bjarni Ingi Gislason for the trouble
+	report.
 
-	* m4/groff.m4: set up the --with-grofferdir command line option.
+	Fixes <https://savannah.gnu.org/bugs/?58164>.
 
-2011-03-18  Werner LEMBERG  <wl@gnu.org>
+2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	troff Improve error message.
+	* tmac/html.tmac: Use .do so we correctly load unicode.tmac in
+	compatibility mode.
 
-	* src/roff/troff/input.cc (token::delimiter): Improve error
-	message.  Suggested by Doug McIlroy <doug@cs.dartmouth.edu>.
+	Fixes the following problem (wrapped, filenames abbreviated):
 
-2011-03-04  Werner LEMBERG  <wl@gnu.org>
+	$ echo | ./build/test-groff -C -Thtml >/dev/null
+	troff: backtrace: file '.../groff/build/../tmac/html.tmac':546
+	troff: backtrace: file '.../groff/build/../tmac/troffrc':30
+	troff: .../groff/build/../tmac/html.tmac:546: warning: macro
+		'ms' not defined
 
-	mdoc Within .An, .Aq, .Ao, and .Ac now use `<' and `>'.
-	Problem reported by Ulrich Spörlein <uqs@spoerlein.net>
+2020-04-13  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* tmac/doc.tmac (Aq, Ao, Ac): Implement it to follow RFC 822 and
-	RFC 2822.
+	* src/roff/groff/tests/smoke-test_html_device.sh: Add test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
 
-2011-02-14  Werner LEMBERG  <wl@gnu.org>
+2020-04-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/groff/tests/regression_savannah_58153.sh:
+	* src/roff/groff/tests/\
+	use_point_size_escape_with_single_digit_arg.sh: Use "set -e" to
+	ensure that multi-test script files don't hide problems.  There
+	are arguments against "set -e" (and you can ask Greg Wooledge
+	for all of them), but I'm so used to it from years of writing
+	Debian package maintainer scripts that I feel comfortable with
+	it.  It is less verbose than several alternatives (especially
+	having one test script per case).
+
+	* src/roff/groff/tests/string_case_xform_unicode_escape.sh:
+	Update with respect to new failure output (in a comment only,
+	since this is an XFAIL test).
+
+	* tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh:
+	Drop unnecessary "|| exit 1" from end of script.  Incidentally,
+	this script illustrates an alternative to "set -e".
+
+2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Rework documentation of .spreadwarn.
+
+	* doc/groff.texi (Debugging):
+	* man/groff.7.man (Request short reference):
+	* man/groff_diff.7.man (New requests): Recast description of
+	.spreadwarn request, some based on suggestions from Dave Kemper.
+	Make more prominent the fact that spreading only applies to
+	adjustment mode 'b'.  Document warning type used.
+
+	Fixes half of Savannah #58035.
+
+2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Require Texinfo 5.0 (February 2013) at a minimum.
+
+	* m4/groff.m4 (GROFF_MAKEINFO): Check for version 5.0 (increased
+	from 4.8).  Update diagnostics and comments.
+
+	* INSTALL.extra:
+	* README:
+	* doc/groff.texi:
+	* doc/webpage.ms: Document updated requirement.
+
+	* doc/fixinfo.sh: Delete; it is no longer necessary to work
+	around Texinfo 4.x bugs.
+
+	* doc/doc.am (EXTRA_DIST): Stop shipping fixinfo.sh.
+	(.texi.html): Remove makeinfo < 5.0 version check and consequent
+	execution of fixinfo.sh.  Update comment.
+
+2020-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Enable backtracing across process/file boundaries when errors or
+	non-ignored warnings are encountered.
+
+	Experimentation reveals that .so, .mso, and .pso requests acted
+	as barriers to backtracing except when explicitly requested with
+	the .backtrace request.  Judging by the git history, this
+	behavior dates back to June 1991 or earlier.  The intention,
+	according to a source comment, was only to suppress the
+	backtrace output for the line corresponding to the outermost
+	level of the input stack (commonly, a file argument to groff).
+	Unfortunately, that wasn't its only effect.
+
+	This change does result in one additional line of output for
+	each error or (non-ignored) warning when -b is given.  However,
+	I regard this as unobjectionable because {1} a backtrace was in
+	fact explicitly requested; and {2} it seems a poor tradeoff to
+	suppress most of the backtrace in some complicated and
+	frustrating cases for the sake of one fewer line of backtrace
+	output in a trivial one.
+
+	Now, backtracing behaves the same no matter what triggers it.
+
+	Fixes Savannah #58153.
+
+	* src/roff/troff/input.cpp (file_iterator::backtrace): Call
+	get_location() for its side effect of rewriting a filename of
+	"-" to "<standard input>", for consistency with other diagnostic
+	messages.  (In this class, this member function always returns
+	1, so ignore the return value.  This fact is an essential part
+	of what led to the bug; the conditional
+		p && !p->get_location(0, &f, &n)
+	which appeared in the for loop of input_stack::backtrace() prior
+	to this change would always evaluate to false when a node of the
+	file_iterator class was encountered.)
+	(input_stack::backtrace): Replace member function body with that
+	of input_stack::backtrace_all().
+	(input_stack::backtrace_all): Delete.
+	(backtrace_request): Update the only call site of the above.
+
+	* src/roff/groff/tests/regression_savannah_58153.sh: Add test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+	* src/roff/groff/tests/string_case_xform_errors.sh: Update
+	regression test to not be confounded by additional line of
+	backtrace output.  Remove bashism along the way.
+
+	* doc/groff.texi:
+	* man/groff.7.man:
+	* man/groff_diff.7.man: Update documentation.
 
-	* doc/groff.texinfo: Add another example for .em request
-	Based on a patch from Anton Shepelev <anton.txt@gmail.com>.
+2020-04-10  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-01-31  Werner LEMBERG  <wl@gnu.org>
+	Reorganize backtrace output.
+
+	* src/roff/troff/input.cpp (string_iterator::backtrace):
+	Prefix the output with the program name if it is known.  In a
+	deviation from the GNU Coding Standards, put the string
+	"backtrace:" immediately next instead of the file and line
+	number; this is because, particularly in cases where the
+	backtrace is most interesting or needed, it will produce
+	multiple lines of output and the common prefix aids visual
+	understanding.
+	(file_iterator::backtrace): As above; also, change prefix for
+	popened nodes in the iterator from "process" to "pipe".  This
+	seemed preferable to omitting the information entirely or using
+	an inscrutable sigil like 'f' or 'p'.  The advantage is that the
+	output is better aligned--better ergonomics for those who have
+	to cope with a lot of it.  Furthermore, output the filename only
+	once.
+
+	Example of old and new output:
+
+	/tmp/inner:2: backtrace: file '/tmp/inner'
+	echo .so /tmp/inner:1: backtrace: process 'echo .so /tmp/inner'
+	/tmp/outer:1: backtrace: file '/tmp/outer'
+
+	troff: backtrace: file '/tmp/inner':2
+	troff: backtrace: pipe 'echo .so /tmp/inner':1
+	troff: backtrace: file '/tmp/outer':1
+
+2020-04-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Add units to diagnostic.
+	This function works only with device-specific basic units
+	internally; users likely think in terms of point size, so add
+	the basic unit suffix "u" to offer a hint about what's going on.
+
+	Example:
+	$ groff -ww >/dev/null
+	\s10A\s-12B
+	troff: <standard input>:1: warning: point-size escape results in
+	non-positive size -2000u; set to 1u
+
+	On a PostScript device with 1000 basic units to the point, the
+	difference is important and would be confusing without the unit
+	indication.
+
+2020-04-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Correct and clarify point size documentation.
+
+	Our Texinfo manual has long documented the request '.ps 0' as
+	restoring the previous point size (just as '\s0' or '.ps' with
+	no argument does), but this is incorrect; since groff 1.02 or
+	earlier (June 1991), the request has not actually worked this
+	way.  Instead, '.ps 0' sets the point size to 1 basic unit
+	{though output drivers may clamp this to a higher value}.  This
+	behavior is consistent with AT&T troff, Hierloom Doctools troff
+	and, per Ingo Schwarze, Plan 9 troff.  (It is, however, not
+	consistent with neatroff.)
+
+	* doc/groff.texi (Changing Type Sizes): Stop claiming that '.ps
+	0' works like '\s0'.  Note that the resulting (computed) point
+	size, not the argument, is clamped.  Note that it is
+	non-positive, not negative, point sizes that are clamped to 1u.
+	Add (forward) cross-reference to section where \n.ps is
+	defined since it is mentioned here.  Move explanation of special
+	handling of zero argument to \s escape description.
+
+	* man/groff.7.man (Request short reference): Explain .ps N
+	independently of \s.  Note clamping behavior.
+
+2020-04-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Correctly brace 'else'
+	block.
+
+	* src/roff/groff/tests/\
+	use_point_size_escape_with_single_digit_arg.sh:
+	Check that we get a diagnostic when relying on ambiguous form.
+
+2020-04-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp (read_size): Move special-case
+	interpretation of the '\sN' form of point-size escapes when 'N'
+	is 1, 2, or 3 to compatibility mode (groff -C) only, and throw
+	error diagnostic with suggestion for remedy if encountered.
+
+	Traditionally, '\s36A' is interpreted as "set point size to 36,
+	then emit 'A'".  However, only values in the range 10-39 are
+	handled specially; '\s40A' is interpreted as a four-point "0A".
+	This is unlike anything else in *roff grammar; see \*, \$, \f,
+	\F, \g, \k, \m, \M, \n, \V, \Y, and \z.
+
+	To anticipate objections: Why not throw only a warning?  Because
+	there isn't a warning category for supported but ambiguous
+	syntax (this behavior of AT&T troff dates back to the mid-1970s
+	but was not documented in the Troff User's Manual until 1992).
+	Why not throw the error outside of compatibility mode too?
+	Because outside of compatibility mode we (now) have an
+	unambiguous parse.
+
+	Background: The Graphic Systems C/A/T phototypesetter (the
+	original device target for AT&T troff) only supported a few
+	discrete point sizes in the range 6..36, so Ossanna
+	special-cased the parser to do what the user must have meant.
+	Kernighan warned of this in the 1992 revision of CSTR #54
+	{§2.3}, and more recently, McIlroy referred to it as a "living
+	fossil".
+
+	See:
+	  https://lists.gnu.org/archive/html/groff/2020-03/msg00054.html
+	  https://lists.gnu.org/archive/html/groff/2020-04/msg00002.html
+	  https://lists.gnu.org/archive/html/groff/2020-04/msg00015.html
+	and follow-ups for discussion.
+
+	* NEWS: Advise users of behavior change and offer guidance.
+
+	* doc/groff.texi:
+	* man/groff.7.man: Document the restriction of special handling
+	of point-size arguments to '\s' to compatibility mode.
+
+	* src/roff/groff/tests/\
+	use_point_size_escape_with_single_digit_arg.sh: Add regression
+	test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2020-04-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Improve point-size escape diagnostics.
+
+	* src/roff/troff/input.cpp (read_size): Disclose context
+	{point-size escape interpretation} in diagnostic messages.  When
+	a "bad digit" is encountered, describe it if possible.  When a
+	relative adjustment results in a negative point size, report the
+	computed value.  Also rename a variable for slightly more
+	clarity ("bad" does not refer to all bad parses, just some cases
+	of bad digits), and update an insufficiently generalized comment
+	{"\s(00" is also an acceptable expression for point-size zero}.
+
+	Based on suggestions by Ingo Schwarze and Bjarni Ingi Gislason.
+
+2020-04-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Align diagnostic message format.
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	* src/roff/troff/input.cpp (do_error):
+	Display the diagnostic level when it is "error", instead of
+	leaving it implicit.
+
+	* src/roff/troff/input.cpp (error_with_file_and_line): Include
+	the program name in the diagnostic message if it is known.
+
+	* src/roff/groff/tests/string_case_xform_errors.sh: Update
+	diagnostic message expectation.
+
+2020-02-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi (Page Motions):
+	* man/groff.7.man (Single-character escapes): Document
+	non-breaking spaces as such.
+
+	Report and patch by Dave Kemper <saint.snit@gmail.com>.
+	Fixes <https://savannah.gnu.org/bugs/?55954>.
+
+2020-02-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	nroff: Implement -P and -V options.
+
+	* src/roff/nroff/nroff.sh: Recognize -P option (with argument)
+	and pass it through to groff.  Recognize -V option; if given,
+	display constructed groff command instead of executing it.
+	Update usage message to document new options.  Tidy up shell
+	style and indentation.  Add comments.
+	* src/roff/nroff/nroff.1.man: Document new -P and -V options.
+	* src/roff/nroff/tests/verbose_option_works.sh.in: Test -V
+	option.
+	* src/roff/nroff/nroff.am: Generate test and run it.
+
+2020-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Stop ms macro package from manipulating warnings.
+
+	* tmac/s.tmac: Remove code block that attempted to enable all
+	warnings "only if none are given on the command line".  It did
+	this by simply comparing the value of the warn register
+	{\n.warn} against the default value; but of course, a user
+	could specify -w options that exactly matched the default and
+	the test would not be able to tell, causing puzzling and
+	undesired behavior.  Furthermore, the hard-coded default was out
+	of date and did not correspond to recent releases of groff.  If
+	you want all warnings on, use the ".warn" request with no
+	arguments in your ms document or pass "-w w" to groff (see
+	troff(1) or our Texinfo manual for more on warnings).
+
+	Thanks to Bjarni Ingi Gislason for bringing this issue to our
+	attention.
+
+	Resolves <https://savannah.gnu.org/bugs/?57583>.
+
+2020-01-21  George HELFFRICH  <ghfbsd@gmail.com>
+
+	me: Fix regression of '.nm' (#57638).
+
+	* tmac/e.tmac-u (nm): Use saved point size and font position
+	for line numbering only if those registers exist.
+
+	Fixes <https://savannah.gnu.org/bugs/?57638>.
+
+2020-01-18  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Accept any number of arguments for .Dd in the groff_mdoc(7)
+	macros.
 
-	More fixes for Savannah bug #32301.
+	* tmac/doc-common-u: The .Dd macro behaved in a weird way:
+	Without arguments, it printed the string "Epoch".
+	With one, two, four, or more arguments, it ignored all arguments
+	and used the current date instead.
+	Only for exactly three arguments, it printed the arguments.
+	None of this made sense.  Giving the date as "Epoch" is
+	absurd, and printing the current date is just misleading:
+	why should a document be considered up-to-date when the author
+	did not even bother to state the date of the last change?
+	Admittedly, the behaviour for 0 and 4 or more arguments
+	already appeared 4.3BSD-Reno, and the behaviour for 2 or 3
+	arguments in 4.4BSD.  But it was already wrong even in those
+	days: several manual pages in 4.4BSD gave .Dd a single, quoted
+	argument, e.g. .Dd "June 9, 1993": cap_mkdb(1), id(1), sed(1),
+	err(3), getcap(3), sysctl(3), amd(8), disklabel(8), and others.
+	Consequently, simply print all the arguments, no matter how
+	many there are.
 
-	* src/devices/grops/Makefile.sub (XLIBS),
-	src/devices/grodvi/Makefile.sub, src/devices/grolj4/Makefile.sub,
-	src/devices/grohtml/Makefile.sub, src/devices/grolbp/Makefile.sub:
-	Add $(LIBGNU).
+	This bug was found by Jonathan Gray <jsg@openbsd.org>
+	while he looked at 4.xBSD manual pages.
 
-2011-01-31  Werner LEMBERG  <wl@gnu.org>
+2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Fix Savannah bug #32301.
+	* doc/groff.texi: Document initial empty set membership of
+	characters with cflags values of 128, 256, or 512 in parallel
+	with preceding paragraphs regarding smaller powers of two.
 
-	* src/roff/groff/Makefile.sub (XLIBS),
-	src/preproc/grn/Makefile.sub, src/preproc/html/Makefile.sub: Add
-	$(LIBGNU).
+	Report and patch by Dave Kemper <saint.snit@gmail.com>.
+	Fixes <https://savannah.gnu.org/bugs/?57549>.
 
-2011-01-29  Krzysztof Żelechowski  <giecrilj@stegny.2a.pl>
+2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* doc/groff.texinfo: Complete documentation on output devices.
+	* src/roff/groff/tests/*.sh: Rename some tests so their
+	filenames are more self-descriptive.
+	* src/roff/groff/groff.am (groff_TESTS): Update.
 
-2011-01-28  Werner LEMBERG  <wl@gnu.org>
+2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Handle `refer*.tmac'.
+	* src/roff/groff/tests/transparent_end-of-sentence_chars.sh: Add
+	test for end-of-sentence recognition.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
 
-	* tmac/Makefile.sub (NORMALFILES): Add `refer*.tmac'.
-	* tmac/refer-mm.tmac: Moved to contrib/mm.
+2020-01-18  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-01-28  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/troff/input.cpp: Mark \dd character (double dagger)
+	as transparent for purposes of end-of-sentence recognition.
 
-	Improve `refer' support of -me.
+	* doc/groff.texi (Sentences):
+	* man/groff_diff.7.man (New requests/.cflags): Document this.
 
-	* tmac/refer.tmac, tmac/refer-me.tmac, tmac/refer-ms.tmac,
-	tmac/refer-mm.tmac: New files.  The code in refer.tmac is
-	based on the old code from `s.tmac'.
+	Report and patch by Dave Kemper <saint.snit@gmail.com>.
+	Fixes <https://savannah.gnu.org/bugs/?57546>.
 
-	* tmac/s.tmac: Remove direct refer support and include
-	`refer-ms.tmac' instead.
-	* tmac/e.tmac: Remove direct refer support and include
-	`refer-me.tmac' instead.
+2020-01-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* NEWS: Updated.
+	* src/preproc/refer/refer.1.man (See Also):
+	* src/utils/indxbib/indxbib.1.man (See Also):
+	* src/utils/lkbib/lkbib.1.man (See Also):
+	* src/utils/lookbib/lookbib.1.man (See Also): Add bibliographic
+	reference to the original Bell Labs "refer" paper by Mike Lesk.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+2020-01-17  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	groff.texinfo: Updates.
+	* tmac/tests/an-old_AT_and_UC_footer_saved_and_restored.sh: Add
+	regression test for Ingo's change below.
 
-	* doc/groff.texinfo: Document groff's `-j' option.
-	Add dummy section for `chem' preprocessor.
+2020-01-16  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Repair .AT and .UC in the groff_man(7) macros.
+
+	* tmac/an-old.tmac: Setting user-defined strings in a macro that
+	will later be called indirectly from page location traps is
+	excessively complicated.  Besides, the implementation doesn't
+	work: when the trap is finally sprung, the defaults from the
+	an-init macro clobber what the author specified with .AT or .UC.
+	Instead, all that is needed is setting the strings for the
+	header before triggering the page break, such that they appear
+	right away, while setting the strings for the footer after the
+	page break, such that they don't appear on the previous page.
+
+	This bug was found by Jonathan Gray <jsg@openbsd.org> while he
+	looked at 4.xBSD manual pages.
+
+2020-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man (Document structure macros/.SH): Fix
+	errors in footer description.
+
+2020-01-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/tests/an-old_CS_register_on.sh: Tweak flags; all the
+	other tests in this group pass "-Tascii -P-cbou" instead of
+	"-Tutf8".  (This is so that output is easy to grep from a shell
+	script.)  Bring this test into line.  Does not regress anything.
+
+2019-12-30  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Certain pdfmark destination names caused gropdf to fail.
+
+	* src/devices/gropdf/gropdf.pl: Look for pdfmark types, (i.e.
+	DEST, OUT, ANN), only preceding 'pdfmark' at end of line, not
+	anywhere else.
+
+2019-12-30  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Correct output of sprintf("%%") in pic(1).
+
+	* src/preproc/pic/pic.ypp: Print "%" rather than "%%".
+
+	Bug reported by Doug McIlroy <doug at cs dot dartmouth dot edu>.
+	Patch using feedback from Larry McVoy <lm at mcvoy dot com>.
+
+2019-12-29  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Update man page of gropdf to document \X calls.
+
+	* src/devices/gropdf/gropdf.1.man: The calls 'pagename' and
+	  'switchtopage' (used by mom to relocate TOC) are documented,
+	  together with their convenience commands '.pdfpagename' and
+	  '.pdfswitchtopage'.
+
+2019-12-29  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Improve documentation of pic(1) regarding printf.
+
+	* src/preproc/pic/pic.1.man:
+	  Document which conversion specifications are supported.
+	* doc/pic.ms:
+	  Correct the list of supported conversion specifications.
+
+2019-12-21  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Update NetBSD, OpenBSD, FreeBSD, Darwin, and DragonFly version
+	strings.
+
+	* tmac/doc-common-u: Update.
+	* tmac/groff_mdoc.7.man: Synchronize.
+
+	Based on a patch from Guillem Jover <guillem@debian.org>
+	via Colin Watson <cjwatson@debian.org>, tweaked by me.
+	Fixes: https://bugs.debian.org/867123
+
+2019-09-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Use a vertical spacing of 1v between paragraphs in man page
+	examples.  This looks better (on typesetter devices like
+	PostScript and PDF) with the Courier font family also used in
+	examples.  Typewriter devices (like the terminal) already used
+	an inter-paragraph spacing of 1v.
+
+	* tmac/an-ext.tmac (EX): Save the value of the PD number
+	register (inter-paragraph distance), and set it to 1v.
+	(EE): Restore previous value of the PD register.
+
+2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Changes to allow configure to check for URW fonts
+
+	* font/devpdf/util/BuildFoundries.pl: Call the program with
+	--dirURW with path provided to ./configure, and --check to do
+	a dry-run just checking if the fonts are available. (bug #56748)
+
+2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add new ghostscript font names (bug #56748)
+
+	* font/devpdf/Foundry.in: Add changed font names
+
+2019-09-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Prevent gropdf executing arbitrary commands
+
+	* src/devices/gropdf/gropdf.pl: See bug #55557
+
+2019-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: Move test for definitions of CS and CT
+	registers to after man.local is sourced; this way we can both
+	respect any setting of those registers in that file (which is
+	intended for customization by the site administrator) and ensure
+	that the registers are defined when dereferenced later.
+
+2019-09-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* **/*.man: Put section headings in title case.
+
+2019-09-13  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp: Lift invariant out of loop.
+
+2019-09-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/refer/refer.1.man: Add mention of man and mm
+	packages as supporting the "refer" preprocessor (GNU mm grew
+	this support back in groff 1.22.1).
+
+2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Mark expected-to-fail test as XFAIL.
+
+	Automake supports XFAIL and XPASS, so actually use the
+	infrastructure as intended.
+
+	* Makefile.am: Declare XFAIL_TESTS variable.
+	* src/roff/groff/groff.am (groff_XFAIL_TESTS): Add
+	string_case_xform_unicode_escape.sh.
+	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: Set
+	the expected output to what it would be if string case
+	transforms worked on groff Unicode escapes.
+
+2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Retire '@G@' build system macro.
+
+	It existed only for forcibly-capitalized man page titles; it was
+	the uppercase-transformed counterpart of @g@.
+
+	* Makefile.am: Delete sed transformation of @G@.
+	* src/preproc/tbl/tbl.1.man: Replace '@G@EQN' in section heading
+	with '@g@eqn'.
+
+2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* **/*.man: Downcase man page titles, except for glilypond and
+	roff2*, which did not require it.
+
+	Here's a sed script for the aid of those who have a corpus of
+	man pages to migrate.
+
+		# Downcase man page titles.
+		#
+		# Use the first line to skip any .TH lines that require
+		# special handling, perhaps because the name of the
+		# command gets externally macro-expanded.  In groff, the
+		# "roff2.1.man" page is an example.
+		#
+		# This script operates _only_ on .TH lines.
+		#
+		# usage: sed -i -f this_script.sed your_man_page.1 ...
+		/@ROFF2MODE@/b
+		/^\.\s*TH/{
+		h
+		s/^\.\s*TH \+$^ \+$ .*/\1/
+		y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/
+		G
+		s/$^ \+$\n$^\.\s*TH \+$^ \+$ .*$/\2\1\3/
+		}
+
+2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	The an (man) macro package supports new CS and CT number
+	registers to control rendering of man page section headings and
+	titles, respectively, in full capitals.  These default off (with
+	no visible effect on pages which already fully capitalize these
+	strings in man page sources).  The rationale is to encourage man
+	page authors to preserve case distinction information in (or
+	restore it to) their titles and section headings, while giving
+	users (including system administrators, distributors,
+	integrators, and maintainers of man(1) implementations) a way to
+	view the rendered page elements in full capitals if desired.
+
+	* tmac/an-old.tmac (TH/an-init): If number register CT is
+	defined and nonzero, call .stringup on \*an-title.
+	(SH): Store macro argument list to \*an-section-heading.  If
+	number register CS is defined and nonzero, call .stringup on it.
+	* tmac/groff_man.7.man (OPTIONS): Document the CS and CT number
+	registers.
+	* tmac/tests/an-old_CS_register_off.sh:
+	* tmac/tests/an-old_CS_register_on.sh:
+	* tmac/tests/an-old_CS_register_unspecified.sh:
+	* tmac/tests/an-old_CT_register_off.sh:
+	* tmac/tests/an-old_CT_register_on.sh:
+	* tmac/tests/an-old_CT_register_unspecified.sh: Add tests.
+	* tmac/tmac.am (tmac_TESTS): Run tests.
+
+2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test to check behavior of case transformation
+	request on a string containing a Unicode character escape.
+	Right now, this is not supported, so it is an XFAIL test in the
+	parlance of DejaGNU/POSIX 1003.3.
+
+	* src/roff/groff/tests/string_case_xform_unicode_escape.sh: New
+	test.
+	* src/roff/groff/groff.am (groff_TESTS): Run test.
+
+2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Implement .stringdown and .stringup requests.
+
+	* src/roff/troff/input.cpp: Add .stringdown and .stringup
+	requests.
+	* doc/groff.texi: Document them, including example.
+	* man/groff_diff.7.man: Same.
+	* man/groff.7.man: Document them briefly.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+2019-09-09  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Update `grog'.
+	Regression-test string case transform feature.
 
-	* src/roff/grog/{groff.sh,groff.pl}: `groff' now calls `pic'
-	automatically if `grap' or `chem' is used.
-	`chem' has been folded into `groff'.
-	* src/roff/grog/grog.man: Updated.
+	* src/roff/groff/tests/string_case_xform_errors.sh: New test.
+	* src/roff/groff/tests/string_case_xform_requests.sh: New test.
+	* src/roff/groff/groff.am (groff_TESTS): Run tests.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+2019-06-30  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Make `groff -G' imply `-p'.
+	* src/devices/grotty/grotty.1.man (Options/-i): Note support of
+	recent versions of xterm for italic (oblique) styles.
 
-	* src/roff/groff/groff.cpp (main): Implement it.
-	* src/roff/groff/groff.man: Updated.
+	Fixes part of <https://savannah.gnu.org/bugs/?55278>.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+2019-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	Integrate `chem' into `groff' (new option -j).
+	devlatin1: Map \(oq to ' on output.
 
-	* src/roff/groff/groff.cpp (CHEM_INDEX): New constant.
-	(main) 'j': Add `chem'.
-	(synopsis, help): Updated.
-	* src/roff/troff/pipeline.h (MAX_COMMANDS): Increase to 14.
+	* font/devlatin1/R.proto: Render the output glyph \oq
+	{opening quote} as 0x27 (apostrophe) instead of 0x60 (grave
+	accent).  A grave accent is just flat wrong for the Latin-1
+	character set, a.k.a. ISO 8859-1.  The defining document ECMA-94
+	{June 1986} is freely available for perusal.  The ECMA-94 Latin
+	character sets do not define any glyphs for directional
+	{"typographer's"} quotation marks, but the apostrophe is
+	depicted as a neutral (vertical) glyph, whereas the grave accent
+	0x60 and acute accent 0xB4 are mirror-symmetric diacritical
+	marks.
 
-	* src/roff/groff/groff.man: Document new command line option.
-	* NEWS: Updated.
+	Note that this change has no effect on _input_ conventions for
+	roff source documents.  You can still get directional single
+	quotes on UTF-8, PostScript, PDF, and other output devices
+	supporting them by typing sequences like `this' in the input
+	{character remapping with ".char" requests and similar
+	notwithstanding}.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+	Patch and idea from Ingo Schwarze, who originally proposed it
+	for ASCII as well, and included Latin-1 for parallelism.
+	The groff developers could reach no consensus about the wisdom
+	of such a change for ASCII (which was designed to support
+	ambiguity for some code points, requiring the development of
+	supplementary interpretation conventions between parties).
+	ECMA-94/ISO-8859 is more strongly prescriptive.
 
-	* doc/groff.texinfo: `chem' is now part of groff.
+	See https://savannah.gnu.org/bugs/?55616 and the groff mailing
+	list archives for 31 January to 23 February 2019 at
+	https://lists.gnu.org/archive/html/groff for lengthy discussion.
 
-2011-01-22  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/groff/tests/on-latin1-device-oq-is-0x27.sh: Check for
+	correct output glyph.
 
-	* doc/groff.texinfo: Improve description of `.de'.
+	* src/roff/groff/groff.am: Add test.
 
-	Based on suggestions by Ted Harding and Deri James.
+2019-06-28  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-2011-01-20  Colin Watson  <cjwatson@debian.org>
+	* tmac/unicode.tmac: Save and restore compatibility mode since
+	the script uses a GNU extension (.char).
 
-	Fix handling of wide characters in no-SGR mode.
+2019-06-27  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	* src/devices/grotty/tty.cpp (tty_printer::make_underline): Only
-	emit a single backspace in no-SGR mode.  less (at least)
-	backspaces over a character at a time.
-	(tty_printer::make_bold): Likewise.
+	libdriver: Fix SEGV (Savannah #56555).
 
-2011-01-19  Werner LEMBERG  <wl@gnu.org>
+	* src/libs/libdriver/printer.cpp: Check result of
+	set_char_and_width() for error condition before relying on it.
 
-	* src/preproc/pic/pic.man: Add pic manual to `SEE ALSO' section.
+	* src/roff/groff/tests/regression-56555.sh: Provoke segfault
+	with five bytes of input using transparent line indicator.
 
-2011-01-14  Werner LEMBERG  <wl@gnu.org>
+	* src/roff/groff/groff.am: Add test.
 
-	Split ChangeLog.
+	Fixes <https://savannah.gnu.org/bugs/?55278>.
 
-	* ChangeLog: Split off older entries into...
-	* ChangeLog.119, ChangeLog.120: these new files.
+2019-01-12  Ingo Schwarze  <schwarze@openbsd.org>
 
-2011-01-15  Colin Watson  <cjwatson@debian.org>
+	Correctly handle groff_mdoc(7) .Lk arguments starting with a
+	dot.
 
-	* Makefile.comm (INCLUDES): Fix typo.
+	* tmac/doc.tmac-u: Each argument to the .Lk macro is printed
+	on its own roff input line.  If it happens to start with a dot
+	or apostroph, it was misinterpreted as a request or macro.
+	Force it to be treated as text by adding "\&" in front of it.
 
-2011-01-05  Werner LEMBERG  <wl@gnu.org>
+2018-12-31  Ingo Schwarze  <schwarze@openbsd.org>
 
-	* doc/webpage.ms: Fix rendering of title image.
+	* man/groff_diff.7.man: remove two stray .RE macros
 
 
 ________________________________________________________________________
 
 ##### License
 
-Copyright 2011-2018 Free Software Foundation, Inc.
+Copyright 2018-2021 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: change-log
 version-control: never
 End:
-vim:set autoindent:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.115 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.115 Changed

@@ -889,7 +889,7 @@
 	popen/pclose on POPEN_MISSING.
 	* troff/node.h: Conditionalize pipe_command on POPEN_MISSING.
 	* troff/input.cc (pipe_command): Give an error if POPEN_MISSING.
-	(pipe_source): Similarily.
+	(pipe_source): Similarly.
 
 	* acgroff.m4 (GROFF_PROG_CCC): Update message about libg++.
 
@@ -1643,7 +1643,7 @@
 Mon Oct 26 11:33:47 1992  James Clark  (jjc at jclark)
 
 	* tmac/tmac.e ((f): Set up the environment even when there's a
-	current diversion.  Transperently throughput a call to @N.
+	current diversion.  Transparently throughput a call to @N.
 	(@N): New macro.
 
 Thu Oct 22 05:05:59 1992  James Clark  (jjc at jclark)
@@ -1746,7 +1746,7 @@
 	(hyphen_trie::do_delete): New function.
 	(trie::~trie): New function.
 	(hyphen_trie::~hyphen_trie): New function.
-	(trie::clear): No need to chcek that tp is not 0.
+	(trie::clear): No need to check that tp is not 0.
 	(current_language, language_dictionary): New variables.
 	(hyphen_word): Give an error if no current language.  Use
 	exceptions dictionary in current language.
@@ -1809,7 +1809,7 @@
 	font::paperlength. Don't compute columns_per_page from
 	font::paperwidth.
 	(tty_printer::add_char): Don't check horizontal position against
-	columns_per_page. Grow glyphs vector if neccessary.
+	columns_per_page. Grow glyphs vector if necessary.
 	(tty_printer::end_page): Add argument giving page_length in units.
 	Discard lines past end of page.
 
@@ -1941,7 +1941,7 @@
 	(O_RDONLY): Define if necessary.
 	(make_index_search_item, index_search_item_iterator::get_tag,
 	index_search_item::check_files): Use O_RDONLY.
-	* libbib/seach.cc: Include <fcntl.h>, <sys/types.h>, <sys/stat.h>.
+	* libbib/search.cc: Include <fcntl.h>, <sys/types.h>, <sys/stat.h>.
 	(O_RDONLY): Define if necessary.
 	(search_list::add_file): Use O_RDONLY.
 	* indxbib/indxbib.cc: Include <fcntl.h>, <sys/types.h>,
@@ -2475,7 +2475,7 @@
 Wed Jul  1 10:17:25 1992  James Clark  (jjc at jclark)
 
 	* dvi/tmac.dvi: Change the definitions of \(ul and _ so that they
-	produce a real _ charater when the current font is CW and _
+	produce a real _ character when the current font is CW and _
 	otherwise.
 
 	* lib/errarg.c (errarg::errarg(const char *)): Invert conditional
@@ -3055,7 +3055,7 @@
 	environment::get_half_narrow_space_width): Make inline.
 	(environment::get_space_width): Make inline.  Just call
 	env_space_width.
-	* troff/env.c: Delete definitions for funtions made inline.
+	* troff/env.c: Delete definitions for functions made inline.
 	(environment::space_newline, environment::space): Use
 	env_sentence_space_width(). Don't scale by space_size.
 	* troff/node.h: Move declarations of env*space_width() functions
@@ -3231,7 +3231,7 @@
 
 	* pic/lex.c (input_stack::bol): Move definition out of class body.
 
-	* pic/main.c: On MSDOS munge argv0.
+	* pic/main.c: On MS-DOS munge argv0.
 
 	* lib/ptable.h: Define name2 as _Paste2 for Borland C++.
 
@@ -3591,7 +3591,7 @@
 	* macros/tmac.e: Define \*(lq and \*(rq to be \(lq and \(rq.
 
 	* pic/object.c (position_rectangle): When checking radius
-	cope with possiblity that width or height is negative.
+	cope with possibility that width or height is negative.
 	(box_object::box_object): Have separate xrad and yrad with
 	signs matching signs of dim components.
 	(box_object::{north,south}_{east,west}): Use xrad and yrad.
@@ -3730,7 +3730,7 @@
 	TOKEN_CHAR_HEIGHT, TOKEN_CHAR_SLANT, TOKEN_FONT_POSITION, and
 	TOKEN_SIZE.
 
-	* man/Makefile: Add definiton of BROKEN_SPOOLER_FLAGS.
+	* man/Makefile: Add definition of BROKEN_SPOOLER_FLAGS.
 	(.man.n):  sed out @BROKEN_SPOOLER_FLAGS@.
 
 Sun Apr 14 12:57:00 1991  James Clark  (jjc at jclark)
@@ -3971,8 +3971,9 @@
 	* macros/tmac.e: Remove check that groff is being used.
 
 	* macros/tmac.e (@C): Change families only if using groff; turn
-	compatibility mode off while changing familes. Save compatibility
-	mode before changing families and restore it afterwards.
+	compatibility mode off while changing families. Save
+	compatibility mode before changing families and restore it
+	afterwards.
 
 	* macros/tmac.e (@h): Remove test for offset + line length.
 
@@ -4503,7 +4504,7 @@
 	* macros/tmac.s: New file.
 	* man/groff_ms.man: New file.
 	* Makefile: Add definition of TMAC_S. Pass TMAC_S in SUBFLAGS.
-	* Makefile.bd: Similarily.
+	* Makefile.bd: Similarly.
 	* man/Makefile: Add groff_ms.n to MAN7PAGES. Replace @TMAC_S@. Add
 	definition of TMAC_S.
 	* macros/Makefile: Add definition of TMAC_S. Install tmac.s.
@@ -4587,7 +4588,7 @@
 
 	* troff/node.c (lookup_family): Supply second argument to lookup.
 
-	* troff/dictionary.c (dictionary::lookup): After an unsuccesful
+	* troff/dictionary.c (dictionary::lookup): After an unsuccessful
 	search, return immediately if v is 0.
 
 	* pic/troff.c: Define EQN_NO_EXTRA_SPACE_REG.
@@ -4836,7 +4837,7 @@
 Tue Oct  9 08:34:02 1990  James Clark  (jjc at jclark)
 
 	* eqn/lex.c: In defaults_table, make definition of `dot' call
-	`dot_def'.  Don't explicitly make it roman.  Similarily for other
+	`dot_def'.  Don't explicitly make it roman.  Similarly for other
 	accents.
 
 	* pic/lex.c (for_input::for_input): Add by_is_multiplicative
@@ -5190,7 +5191,7 @@
 
 	* troff/node.c (class glyph_node): Make operator new and operator
 	delete public.
-	(class ligature_node): Similarily.
+	(class ligature_node): Similarly.
 
 	* troff/input.c (operator==(const macro &, const macro &)): New
 	function.
@@ -5246,7 +5247,7 @@
 
 	* troff/input.c (read_long_escape_name): The test for whether to
 	expand buffer was off by 1.
-	(read_string): Similarily.
+	(read_string): Similarly.
 
 Fri Sep  7 11:45:50 1990  James Clark  (jjc at jclark)
 
@@ -5345,7 +5346,7 @@
 	* groff.c: New file.
 	* Makefile: Build groff from groff.c.  Make it possible to use
 	either groff.sh or groff.c as groff.
-	* Makefile.bd: Similarily.
+	* Makefile.bd: Similarly.
 
 Mon Sep  3 09:39:49 1990  James Clark  (jjc at jclark)
 
@@ -5357,14 +5358,14 @@
 	* all Makefiles: Simplify and rearrange.
 
 	* Makefile: Handle fmod like malloc.
-	* lib/Makefile: Similarily.
+	* lib/Makefile: Similarly.
 	* lib/fmod.c: Remove #ifdef NEED_FMOD.
 
 	* Makefile: Rename OPTIMISE to OPTIMIZE.
 
 	* groff.sh: Remove assignment to PATH.
 	* Makefile: Remove SHPATH variable.
-	* Makefile.bd: Similarily.
+	* Makefile.bd: Similarly.
 
 	* groff.sh: Add -V option to print the pipeline instead of
 	executing it.
@@ -5380,7 +5381,7 @@
 
 	* tbl/table.c (table::do_hspan): Delete assertion that e != 0.
 	Also change misleading comment.
-	(table::do_vspan): Change similarily misleading comment.
+	(table::do_vspan): Change similarly misleading comment.
 	* tbl/main.c (process_data): A format row with an explicit `s'
 	uses up a data line, even if all the other columns are `_' or `='.
 
@@ -5656,7 +5657,7 @@
 
 	* eqn/other.c (overline_box::output): Use \Z. If draw_flag use \D
 	rather than \l.
-	(underline_box::output): Similarily.
+	(underline_box::output): Similarly.
 	(accent_box::output): Use \Z.
 
 	* xditview/tmac.X: Add definitions of ~ and ^ (so that they are a
@@ -5693,7 +5694,7 @@
 
 	* troff/env.c (tab_character): Don't change the tab character if
 	we get an invalid argument.
-	(hyphen_char): Similarily.
+	(hyphen_char): Similarly.
 
 	* troff/reg.c (alter_format): Check that nm is not null.
 
@@ -5805,7 +5806,7 @@
 	* troff/env.c (environment_switch): Pop if we get an invalid
 	symbol or numeric expression.
 
-	* troff/input.c (do_define_macro):  If EOF is encoutered while
+	* troff/input.c (do_define_macro):  If EOF is encountered while
 	defining the macro, do tok.next() before returning.
 
 	* troff/token.h (has_arg): Move definition from here, to ...
@@ -5839,7 +5840,7 @@
 	* eqn/main.c (main): Add -C option.
 	(do_file): Don't recognize EQ, EN or lf if followed by character
 	other than space or newline unless -C option given.
-	* eqn/lex.c (file_input::read_line): Similarily.
+	* eqn/lex.c (file_input::read_line): Similarly.
 	* eqn/eqn.h: Declare compatible_flag.
 
 	* etc/soelim.c (main): Add -C option.
@@ -5850,7 +5851,7 @@
 	(top_input::get), (top_input::peek):  If -C option not given,
 	do not recognize .PS/.PE/.PF/.lf if followed by a character
 	other than space or newline.
-	* pic/lex.c (file_input::read_line): Similarily.
+	* pic/lex.c (file_input::read_line): Similarly.
 	* pic/pic.h: Add declaration of compatible_flag.
 
 Thu Aug  2 11:11:27 1990  James Clark  (jjc at yquem)
@@ -6148,6 +6149,8 @@
 notice and this notice are preserved.
 
 Local Variables:
+fill-column: 72
+mode: change-log
 version-control: never
-coding: latin-1
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.116 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.116 Changed

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.117 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.117 Changed

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.118 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.118 Changed

@@ -1623,7 +1623,7 @@
 2002-03-23  Phil Lobbes  <phil@perkpartners.com>
 
 	* Makefile.comm (.y.o): New rule for make on Solaris 2.5.1 -- the
-	internal .y.o rule took precendence over the .y.cc rule, compiling
+	internal .y.o rule took precedence over the .y.cc rule, compiling
 	the yacc files with gcc instead of g++.
 
 2002-03-23  Werner LEMBERG  <wl@gnu.org>
@@ -3308,7 +3308,7 @@
 	(html_text): New member functions `do_color' and `done_color'.
 	Use `void *' for second parameter of `push_para' member function.
 	New `push_para' member function with a single parameter.
-	Use `char *' for parameter of `issue_table_begin' member funtion.
+	Use `char *' for parameter of `issue_table_begin' member function.
 	New `issue_color_begin' member function.
 	* src/devices/grohtml/html-text.cc (html_text::end_tag): Handle
 	COLOR_TAG.
@@ -3795,6 +3795,9 @@
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
 coding: latin-1
+fill-column: 72
+mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.119 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.119 Changed

@@ -132,7 +132,7 @@
 
 2005-06-20  Denis M. Wilson  <dmw@oxytropis.plus.com>
 
-	* font/devps/prologue.ps (EP): Dont' use `bind'.  Reason: Using
+	* font/devps/prologue.ps (EP): Don't use `bind'.  Reason: Using
 	`bind' to define a procedure which contains `showpage' means that an
 	invocation of `showpage' may execute wrongly (the exact effect
 	depending on the interpreter).  Not usually a problem except under
@@ -695,7 +695,7 @@
 	(html_text::flush_text): Don't set `start_space'.
 	(html_text::push_para): Don't set `p->really_issued'.
 	(html_text::do_emittext): Updated.
-	(html_text::do_para): Add paremeter to handle space.
+	(html_text::do_para): Add parameter to handle space.
 	Update all callers.
 	(html_text::retrieve_para_space): New function.
 
@@ -837,7 +837,7 @@
 2004-12-17  Werner LEMBERG  <wl@gnu.org>
 
 	* tmac/devtag.tmac: Protect against loading twice.
-	Protect agains compatibility mode.
+	Protect against compatibility mode.
 	* tmac/www.tmac: Protect against loading twice.
 	Load `devtag.tmac' before switching off compatibility mode.
 	* tmac/an-old.tmac, tmac/s.tmac: Load `devtag.tmac'.
@@ -3077,7 +3077,7 @@
 	* src/preproc/refer/ref.cpp (reference::compute_sort_key): Always
 	insert SORT_SEP.  With certain combinations of sort specifications,
 	refer sorted entries in the wrong order.  In particular, entries
-	with a missing field should be be sorted before all entries that
+	with a missing field should be sorted before all entries that
 	have that field, before refer looks to the next field.
 
 2003-08-23  Werner LEMBERG  <wl@gnu.org>
@@ -3957,7 +3957,7 @@
 	* NEWS, MANIFEST, tmac/groff_man.man, man/groff_tmac.man,
 	doc/groff.texinfo: Updated.
 
-	* src/libs/libgroff/paper.cc (add_iso_paper): Fix very embarassing
+	* src/libs/libgroff/paper.cc (add_iso_paper): Fix very embarrassing
 	bug which caused all odd iso papers to have wrong dimensions.
 
 	* src/devices/grops/ps.cc (user_paper_width): New global variable.
@@ -4846,10 +4846,10 @@
 	* font/devps/generate/Makefile (freeeuro.afm freeeuro.pfa): Fix
 	typo.
 	* font/devps/generate/sfdtopfa.pe: Generate PFA in current
-	direcory.
+	directory.
 
 	* tmac/europs.tmac: Updated to new glyph indices.
-	Use Euro.symbol for font familiy `A'.
+	Use Euro.symbol for font family `A'.
 
 	* doc/groff.texinfo: Minor improvements.
 
@@ -5232,6 +5232,9 @@
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
 coding: latin-1
+fill-column: 72
+mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.120 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.120 Changed

_service:tar_scm:groff-1.22.4.tar.gz/ChangeLog.121 -> _service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.121 Changed

_service:tar_scm:groff-1.23.0.tar.gz/ChangeLog.122 Added

@@ -0,0 +1,5331 @@
+Version 1.22.4 released
+=======================
+
+2018-12-18 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix 'dvi' and 'pdf' texinfo doc generation.
+
+	GNU make has a built-in variable 'TEXI2DVI' but it is not the case
+	of all 'make' implementations, which causes 'make doc' to fail
+	with an unclear message although 'texi2dvi' is available.  Also,
+	'texi2dvi' is invoked inconditionnally.
+
+	* m4/groff.m4 (GROFF_TEXI2DVI): new macro to detect properly the
+	presence of 'texi2dvi'.
+
+	* configure.ac: use 'GROFF_TEXI2DVI' and define automake conditional
+	'HAVE_TEXI2DVI'.
+
+	* doc/doc.am:
+	- Define TEXI2DVI to 'texi2dvi'.
+	- Print an error message if 'texi2dvi' is not available.
+
+2018-12-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi: Drop documentation of "man" macro package from
+	  our Texinfo manual.  The mdoc, me, mm, and mom packages all
+	  maintain their documentation externally to this manual as
+	  well.  Exception: portions not about man proper--which are not
+	  duplicated from groff_man(7)--on use of man.local (including
+	  examples of Ultrix-compatible macros) are retained.
+
+2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Install texinfo doc on 'make install-pdf' and 'make install-html'
+
+	* doc/doc.am:
+	- Use automake 'install-pdf-local' and 'install-html-local' rules
+	to install groff.pdf and groff.html
+	- New rules 'uninstall_pdf' and 'uninstall_html'.
+	- Use $(RM) instead of 'rm'.
+	- Don't try to build doc if 'BUILD_INFODOC' is not set.
+	* INSTALL.REPO: document texinfo build and installation.
+
+2018-12-10 Ingo Schwarze <schwarze@openbsd.org>
+
+	* Makefile.am: Remove the unused variables PREFIXMAN5 and PREFIXMAN7.
+
+	They caused installation failures on Solaris 9.
+
+2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Remove gnulib's hypot module.
+
+	The removal of 'GROFF_NEED_DECLARATION(hypot)' in 'configure.ac'
+	was correct as the test was buggy, but there is no need to use
+	gnulib's hypot module as previously we did not need to provide a
+	replacement function.
+
+	* bootstrap.conf: do it.
+
+2018-12-08  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Problem running gropdf on big endian (Sparc)
+
+	* src/devices/gropdf/gropdf.pl: Prior to perl v5.9 the 'L<'
+	template for 'unpack' was unavailable. Solaris 10 uses v5.8.4
+	so safer to use the template 'V' rather than 'L<'.
+
+2018-12-08 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Use gnulib's 'hypot' module.
+
+	In 'configure.ac', the macro call
+	'GROFF_NEED_DECLARATION(hypot)' checks whether the function
+	'hypot' is correctly declared in 'math.h', but the test is buggy
+	and may yields false results.
+
+	* bootstrap.conf: add 'hypot' module.
+
+	* configure.ac: Remove GROFF_NEED_DECLARATION(hypot).
+
+	* src/libs/libgroff/hypot.cpp: remove declaration of hypot.
+
+2018-12-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Problem running gropdf on big endian (Sparc)
+
+	* src/devices/gropdf/gropdf.pl: When loading a binary (.pfb)
+	font for embedding always use little endian to unpack chunk
+	headers.
+
+2018-12-05  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Skip mom tests if needed config is missing.
+
+	* contrib/mom/examples/test-mom.sh.in: exit 77 if URW fonts are
+	not available.
+
+	* contrib/mom/mom.am: distribute inconditionnally test-mom.in.
+
+	* m4/groff.m4 (GROFF_URW_FONTS): check if 'awk' and 'gs' are
+	available, and replace non-portable 'grep' command by awk script.
+
+2018-12-01  Colin Watson  <cjwatson@debian.org>
+
+	Fix error handling in tests of mom examples
+
+	* contrib/mom/examples/test-mom.sh.in (check_number_pages): Correct
+	error message.
+	(check_has_images): Correct shell syntax error.
+
+2018-11-26  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Document .sp behaviour in -me doc -- French translation
+
+	* doc/meintro_fr.me: translation of commit
+	7a83f7f5003e24f020306f09f4d497e04e82cb14.
+
+	Fixes bug https://savannah.gnu.org/bugs/?54958.
+
+2018-11-24  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix tarball generation: script 'makevarescape.sed' was missing.
+
+	* Makefile.am (EXTRA_DIST): add it.
+
+2018-11-24  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Add automatic tests on mom examples
+
+	* m4/groff.m4 (GROFF_PDFTOOLS): check presence of some pdf tools.
+	* configure.ac: use 'GROFF_PDFTOOLS', add new AM conditional.
+	* contrib/mom/examples/test-mom.sh.in: new file that use 'pdfinfo'
+	and 'pdfimages' to make some basic checks on mom examples.
+
+2018-11-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	tmac/sv.tmac: Set Swedish hyphenation flags to 32.
+
+	This permits hyphenation after the first character but continues
+	prohibiting it before the last character of a word, in
+	congruence with the TeX-based hyphenation patterns we use.
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?55066>.
+
+2018-11-19  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix build on environment where /etc/papersize contains comments
+
+	Issue introduced on commit efea81c75f831ddc6717c2ef25556e0f49d1f679.
+
+	* m4/groff.m4 (GROFF_PAGE): remove comments and get the 1st string
+	of '/etc/papersize'.
+
+2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_PAGE): Try /etc/papersize first.
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?53271>.
+
+2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* bootstrap.conf: Bump Autoconf dependency to 2.68.  We need it
+	to support our bug-reporting URL, which contains a "?".
+	Strictly, Autoconf 2.65 is fine, but 2.66 and 2.67 broke this.
+	Even 2.69 is over 6 years old now.
+
+	See <https://savannah.gnu.org/support/?107450>.
+
+2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4 (GROFF_PAGE): Quote shell variables that are under
+	external control and may contain embedded whitespace.  A test
+	shows that our configure script is now robust in this way, but
+	our Automake files are not, starting with
+	src/utils/afmtodit/afmtodit.am.
+
+2018-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* makevarescape.sed:
+	  - Escape plain spaces and double-quotes (ASCII 32 and 34) so
+	    that bad things don't happen if they are embedded in a Make
+	    variable expanded in a man page @THUS@ _and_ given as an
+	    argument to a macro that distinguishes its parameters, such
+	    as .IR.
+	  - Add discretionary breaks after groups of slashes not
+	    preceded by a space; e.g., transform "/usr/bin/groff" into
+	    "/usr/\:bin/\:groff".  Will also work on URLs
+	    {"https://\:example.com/\:page.html"} in case we need that.
+
+2018-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Undocument Werner and Ted as groff maintainers.
+
+	* README:
+	* doc/pic.ms:
+	* src/roff/grog/grog.pl:
+	* src/roff/nroff/nroff.sh: Werner (and Ted) retired from the
+	role some time ago and Bertrand Garrigues has stepped up; see
+	https://lists.gnu.org/archive/html/groff/2017-09/msg00048.html.
+	I'll let him document his maintainer status as and where he
+	prefers.
+
+2018-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Stop spelling "Unix" as "UNIX".
+
+	Per AT&T Bell Labs veterans Doug McIlroy and Meg McRoberts,
+	spelling "Unix" in full caps was a contrivance insisted upon by
+	AT&T lawyers, and not a practice used in the Unix manuals
+	themselves or the Bell Labs Technical Journal.  See
+	  https://lists.gnu.org/archive/html/groff/2015-01/msg00026.html
+	and
+	  https://lists.gnu.org/archive/html/groff/2015-01/msg00029.html
+	for support.
+
+	There are instances I did _not_ change; they may require further
+	review.
+		ChangeLog.*
+		NEWS
+			One reference relevant to mdoc; see below.
+		doc/meintro{,_fr}.me
+			These documents also give the small caps
+			treatment to groff, troff, and nroff, suggesting
+			a separate changeset.
+		src/preproc/pic/pic.ypp
+			Contains a comment referring to "Compaq Tru64
+			UNIX"; not worth the candle IMO.
+		tmac/s.tmac:
+			{ms macro package} Leaving UX macro definition
+			alone until/unless it can be established that
+			this doesn't change the rendering of historical
+			documents in an objectionable way.
+		tmac/doc-syms-u:
+		tmac/doc-old.tmac-u:
+		tmac/doc-common-u:
+		tmac/groff_mdoc.7.man:
+			{mdoc macro package} Similar; mdoc defines many
+			strings that spit out "UNIX" (albeit not with a
+			font size change).
+
+	* MORE.STUFF:
+	* NEWS:
+	* README.MinGW:
+	* contrib/groffer/README:
+	* contrib/pdfmark/pdfmark.ms:
+	* contrib/pdfmark/pdfroff.1.man:
+	* doc/groff.texi:
+	* doc/webpage.ms:
+	* m4/groff.m4:
+	* man/groff_diff.7.man:
+	* man/groff_tmac.5.man:
+	* man/roff.7.man:
+	* src/preproc/html/pre-html.cpp:
+	* src/roff/troff/troff.1.man: Change "UNIX" to "Unix",
+	discarding markup as necessary.
+
+2018-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Escape interpolated Make variables.
+
+	* makevarescape.sed: Transform - to \-, ~ to \(ti, and so forth,
+	{with an extra layer of backslashes--see below} so that Makefile
+	variables containing ASCII characters that do not represent
+	themselves literally in *roff (see groff_char(7)) are correctly
+	interpolated into man page text.
+
+	* Makefile.am (.man): Transform Makefile variables with the
+	above script when interpolating them into man page text.
+
+	Note that while the script, combined with this target, will
+	transform ` to \(ga, including grave accents in Makefile
+	variables is likely to fail when the shell lexes the argument to
+	echo within the old-style command substitution ``.  Testing
+	shows that grave accents should work1 if POSIX-style command
+	substitution $() is done instead.  However, $() is less
+	portable.  (Triple-escaping grave accents \\\` inside the
+	interpolated Makefile variable will work, but is not attempted
+	at present.)
+
+	Note also that the amount of backslash-escaping in the sed
+	script is excessive (and incorrect) for normal purposes, but
+	required here because a command substitution is being nested
+	inside yet another invocation of sed.
+
+	{1} For this target; no assurances about the good behavior of
+	unusual characters in Makefile variables in other aspects of the
+	groff build are offered.
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?55004>.
+
+2018-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/lookbib/lookbib.cpp: Doesn't make much sense to mark
+	Version_string as a C extern if you're just going to hide it in
+	a throwaway scope again.  Remove braces, exposing it.
+
+	"lookbib -v" now reports a version number, instead of "(null)".
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?54972>.
+
+2018-11-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/error.cpp (do_error_with_file_and_line):
+	If:
+	  a program name is known;
+	but
+	  no file is being processed or the line number is negative,
+	then there was no space between the program name (with colon),
+	and the succeeding diagnostic message.
+
+	Example: lookbib:fatal error: no databases
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?54971>.
+
+2018-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Make strip.sed operate only if given permission.
+
+	* tmac/strip.sed: Do nothing whatsoever to any input file that
+	lacks a line matching "%beginstrip%".  This implements a
+	contract between the macro file writer and the stripper script
+	{roff input is not parseable with crude weaponry like regular
+	expressions}.  In practice, most of the changes performed by the
+	script were already in a block enforcing this.  My changes:
+	- Stop unconditionally inserting a roff comment noting the
+	  reader of stripping at line 2.  Instead, replace the line
+	  matching "%beginstrip%" with this comment if and only if it
+	  is present.
+	- Stop deleting lines containing only the empty request if
+	  they occur before "%beginstrip%".
+	- Tweak the wording of the roff comment.
+	- Remove comment within the sed script; see
+	  https://lists.gnu.org/archive/html/groff/2017-11/msg00057.html
+	  and the sed section of "Limitations of Usual Tools" in the
+	  GNU Autoconf Manual.
+
+	Invalidates <https://savannah.gnu.org/bugs/index.php?53784>.
+
+2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/an-old.tmac: When emitting diagnostics, report the name
+	of the macro file complaining, and the name and line number of
+	the input file at the time of trouble.  Thanks to Bjarni Ingi
+	Gislason for part of the patch.
+
+	Fixes <https://savannah.gnu.org/bugs/?54175> and continues the
+	long process of fixing <https://savannah.gnu.org/bugs/?52463>.
+
+2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/meintro_fr.me: Add encoding hint to top of file so preconv
+	works correctly even if the build environment's encoding is not
+	UTF-8.  Adapted from Bjarni Ingi Gislason's patch.  Also add
+	long-form Emacs coding declaration at end of file.  Vim's
+	auto-detection seems to be fine, so did not update its modeline.
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?54530>.
+
+2018-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_man.7.man: Reorganize and largely rewrite to more
+	precisely document the macro package's behavior and to be more
+	helpful and accessible to man page writers who may never read
+	any other groff documentation.
+
+2018-10-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Clarify meaning of \p escape.  Also make more explicit that line
+	adjustment for the .brp request and \p escape depends on the
+	current adjustment mode.
+
+	* doc/groff.texi: Clarify that \p has effect at the next word
+	boundary.  Thanks to Dave <barx> for pointing out the issue and
+	providing elucidating language.
+
+	* man/groff.7.man: Similar, but terser.
+
+	Fixes https://savannah.gnu.org/bugs/index.php?54894.
+
+2018-10-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Savannah bug # 54812
+
+	* font/devpdf/util/BuildFoundries.pl: If a font is not found
+	report list of paths searched.
+
+	Fix https://savannah.gnu.org/bugs/?54812
+
+2018-10-10  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update 'gnulib' submodule.
+
+	* gnulib: now points on dce8759f0f0236a860a3e68b63c5e99cc6f168f9
+	from 'gnulib' repository.  This fixes build error with glibc 2.28
+	(see https://bugzilla.redhat.com/show_bug.cgi?id=1595702).
+
+2018-10-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Savannah bug # 54779
+
+	* font/devpdf/Foundry.in: Recent ghostscript changed name
+	used for embedding groff font HNBI
+
+	Fix https://savannah.gnu.org/bugs/?54779
+
+2018-08-27  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* tmac/groff_www.7.man: Do not use .URL, .MTO, .FTP.
+
+2018-08-21  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Improve terminal rendering for a few special characters:
+
+	* tmac/tty.tmac: add \.j (dotless j)
+	* tmac/tty-char.tmac: for \a., fall back to "."
+	* tmac/tty-char.tmac: add playing card suits
+
+2018-08-16  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* src/preproc/preconv/preconv.1.man: add -D to the SYNOPSIS
+
+2018-08-09  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* Makefile.am: correctly calculate MAJOR_VERSION etc.
+
+2018-06-19  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Fixes to gropdf
+
+	* src/devices/gropdf/gropdf.pl: Make default line width 0.4pt
+	to match grops. Use 'S' operator (stroke) rather than 's' (close
+	and stroke) when Dl command received. Improve switching between
+	text and graphic modes.
+
+2018-07-01 Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	me paragraph with umlaut incorrectly rendered
+
+	* tmac/e.tmac-u: workaround done by Werner LEMBERG <wl@gnu.org>.
+
+	Fix https://savannah.gnu.org/bugs/?42191
+
+2018-06-19  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add gropdf new features to NEWS file.
+
+	* NEWS: new features.
+
+2018-05-29  Werner LEMBERG  <wl@gnu.org>
+
+	dvi Fix glyph map for `cmitt10'.
+
+	Problem reported by Pali Rohár <pali.rohar@gmail.com>.
+
+	  http://lists.gnu.org/archive/html/groff/2018-05/msg00088.html
+
+	* font/devdvi/texitt.map: New file.  This is identical to
+	`textt.map' except the dollar glyph, which gets replaced by the
+	pound glyph.
+
+	* font/devdvi/generate/Makefile (CWI): Use `texitt.map'.
+
+	* font/devdvi/CWI: Regenerated.
+
+2018-05-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Improve diagnostics on bad hyphenation requests.
+
+	* src/roff/troff/env.cpp: Add new HYPHEN_* symbols to anonymous
+	enum.
+
+	* src/roff/troff/env.cpp (hyphenate_request):
+	  - Warn about hyphenation request values that are completely
+	    out of range.
+	  - Report bad hyphenation request value in diagnostic messages.
+
+2018-04-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	grap2graph: Parallelize changes with pic2graph.
+
+	* contrib/grap2graph/grap2graph.sh:
+	  - Refactor temp directory handling.
+	  - Handle embedded whitespace in temp dir.
+	  - Adapt to old convert(1) programs.
+
+	* contrib/grap2graph/grap2graph.1.man: Make editorial/style
+	changes and minor corrections.
+
+2018-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	eqn2graph: Remove -unsafe option.
+
+	* contrib/eqn2graph/eqn2graph.sh: Unrecognize "-unsafe" option
+	and eliminate $groff_opts variable.  As far as I can tell, this
+	option had no effect because (1) pic is not run on the input
+	stream (no -p argument to groff); (2) eqn doesn't support
+	"shelling out" as pic does; and (3) there is no way to embed
+	*roff requests inside a sequence of eqn commands.  If I'm wrong,
+	let me know.
+
+	* contrib/eqn2graph/eqn2graph.1.man: Undocument "-unsafe"
+	option.
+
+2018-04-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	eqn2graph: Parallelize changes with pic2graph.
+
+	* contrib/eqn2graph/eqn2graph.sh:
+	  - Refactor temp directory handling.
+	  - Handle embedded whitespace in temp dir.
+	  - Adapt to old convert(1) programs.
+
+	* contrib/eqn2graph/eqn2graph.1.man: Make editorial/style
+	changes and minor corrections.
+
+2018-04-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic2graph: Refactor temp directory handling.
+
+	* contrib/pic2graph/pic2graph.sh: Issue a diagnostic and give up
+	if the user's desired temporary directory does not exist.  Also
+	document the Bashism $RANDOM and work around its absence.
+
+2018-04-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic2graph: Handle embedded whitespace in temp dir.
+
+	* contrib/pic2graph/pic2graph.sh: Quote shell variables having
+	to do with the temporary directory's location; without
+	quotation, temporary directory names with embedded whitespace
+	are wrongly handled.
+
+2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/groff.texi: Bump end of copyright range to 2018.  Werner
+	added substantial text this year about hyphenation.
+
+2018-04-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Set version to 1.22.4 in the few places that hard-code it.
+
+	* arch/mingw/grap2graph.cmd:
+	* contrib/groffer/version.sh:
+	* doc/groff.texi:
+	* doc/webpage.ms: Bump from 1.22.3 to 1.22.4.
+
+2018-04-24  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Restrict scaling factors to 3dp and better handle CR/LF in import.
+
+	* src/devices/gropdf/gropdf.pl: Restrict scaling factors to 3dp
+	rounded. If pdf imported with pdfpic uses CR/LF line termination
+	ibclude XObject Image, length of stream out by 1.
+
+2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Shorten version footer.
+
+	* **/*.man: Replace "Groff Version" with "groff" in the fourth
+	argument to .TH in all man pages.  This suffices to keep that
+	part of the footer from overrunning the date, even in dirty
+	trees on 80-column terminals.
+
+	Fixes https://savannah.gnu.org/bugs/index.php?53721.
+
+2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic2graph(1): Make editorial/style changes and minor
+	corrections.
+
+2018-04-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	pic2graph: Adapt to old convert(1) programs.
+
+	* contrib/pic2graph/pic2graph.sh: Grep convert's -help output
+	for the string "-trim".  If it is not found, the old method for
+	image trimming documented in pic2graph's man page, "-crop 0x0",
+	is used.  I am motivated by the fact that the warning about this
+	in our man page is very old (10 years or more), and I wanted to
+	get rid of it.
+
+	pic2graph emits a warning when performing this fallback, in the
+	event the ImageMagick and/or GraphicsMagick teams surprise the
+	world again.
+
+	* contrib/pic2graph/pic2graph.1.man: Remove BUGS section, the
+	entire contents of which was dedicated to convert's change in
+	behavior.
+
+2018-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	groff_man(7): Expand command synopsis section.
+
+	This section now explains in detail how to write (and read) a
+	command synopsis.
+
+2018-04-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Make PDFPIC behave the same whether -Tps or -Tpdf used.
+
+	Previously the -Tpdf version did not cause a break nor position
+	to the line beneath the imported picture, whilst the -Tps
+	version did.
+
+	* tmac/pdfpic.tmac: Corrected behavior.
+
+	* NEWS: Explain the change of behaviour and how to reinstate
+	the previous behaviour using register PDFPIC_NOSPACE or the
+	environment variable GROFF_PDFPIC_NOSPACE.
+
+2018-03-27  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Define a short version for data installation dir name.
+
+	This is the full version stripped of any characters after the
+	third digit.  Used for installation of font, macro and various
+	data (by default in /usr/local/share/groff).  The various programs
+	and scripts still use the full version from gnulib script
+	'git-version-gen' .
+
+	* configure.ac (SHORT_VERSION): short version definition.
+
+	* Makefile.am: use 'SHORT_VERSION' for 'docdir' and 'datasubdir'
+	definitions.
+
+2018-03-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Remove doc/automake_migration_tests.txt
+
+	Automake migration was completed long time ago and this file is no
+	longer needed.
+
+2018-03-11  Colin Watson  <cjwatson@debian.org>
+
+	Switch to Gnulib implementation of snprintf
+
+	This is more actively maintained, straightforward to integrate now
+	that we have Gnulib integration, and simplifies groff's overall
+	licensing.
+
+	* bootstrap.conf (gnulib_modules): Add `snprintf' and `vsnprintf'.
+	* configure.ac: Remove local checks for `snprintf' and `vsnprintf'.
+	* Makefile.am: Remove various comments related to local checks for
+	`snprintf' and `vsnprintf'.
+	* src/include/lib.h: Remove declarations of `snprintf' and
+	`vsnprintf'.
+	* src/libs/libgroff/libgroff.am (EXTRA_DIST): Remove
+	`src/libs/snprintf/snprintf.c'.
+	* src/libs/snprintf/snprintf.c: Remove.
+
+	* LICENSES: Remove section about `src/libs/snprintf/snprintf.c'.
+	* MANIFEST: Remove entry for `src/libs/libxutil'.
+
+2018-03-09  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	PDF must not open in presentation mode.
+
+	* src/devices/gropdf/gropdf.pl: When GROPDF_NOSLIDE=1
+	passed do not set pdf to presentation mode.
+
+2018-03-09  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Allow a "." to signify a missing parameter in .pdftransition
+
+	* src/devices/gropdf/gropdf.1.man: Explain the .pdftransition
+	macro (and underlying '\X' command) accepts a "." to specify
+	a parameter retains its current value.
+
+2018-03-09  Colin Watson  <cjwatson@debian.org>
+
+	man pages: fix incorrect cross-referenced section
+
+	* man/roff.7.man (FILE NAME EXTENSIONS): Correct reference to
+	groff_filenames(5).
+
+2018-03-09  Colin Watson  <cjwatson@debian.org>
+
+	mdate.sh: rewrite in Perl
+
+	groff already requires perl to build.  This version is much shorter
+	and easier to understand than the shell/awk version: we don't have
+	to worry about convincing ls to produce output that we can parse,
+	and we don't have to play games with the way that the same field may
+	contain either the year or the time depending on how old the file
+	is.
+
+	While I'm at it, this version also adds `SOURCE_DATE_EPOCH' support
+	for reproducible builds: when `SOURCE_DATE_EPOCH' is set, files are
+	considered to have been last modified at that time.
+
+	* mdate.sh: Rewrite in Perl, moving to ...
+	* mdate.pl: ... this new file.
+	* Makefile.am (EXTRA_DIST, .man): Update references.
+
+2018-03-09  Colin Watson  <cjwatson@debian.org>
+
+	Remove #! lines from non-executable files
+
+	These are always invoked by the build system (either in-tree or via
+	the installed Makefiles) using the necessary program, so the #!
+	lines were unnecessary.  They were harmless except that they caused
+	Debian's `lintian` tool to complain about installed non-executable
+	scripts.
+
+	* font/devlj4/generate/special.awk: Remove #! line.
+	* font/devps/generate/symbol.sed: Likewise.
+
+2018-03-09  Colin Watson  <cjwatson@debian.org>
+
+	doc: stop generating W3C validation icons
+
+	Debian's `lintian' tool says:
+
+	  These badges may be displayed to tell readers that care has been
+	  taken to make a page compliant with W3C standards.  Unfortunately,
+	  downloading the image from www.w3.org might expose the reader's IP
+	  address to potential tracking.
+
+	I think the risk is a small one, but I also don't think the badges
+	are especially valuable, so it doesn't seem like much to ask to just
+	drop them at least for groff's own documentation.
+
+	* doc/doc.am (.ms.html, doc/pic.html): Remove `-P-V' option.
+
+2018-03-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Place pdf in presentation mode if new commands used.
+
+	* src/devices/gropdf/gropdf: The new commands which
+	control page transitions should result in the pdf being
+	opened in presentation mode.
+
+2018-03-02  Werner LEMBERG  <wl@gnu.org>
+
+	Hyphenation exceptions in pattern files now obey `.hy' (#53196).
+
+	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file): Mark
+	`\hyphenation' entries with a trailing space.
+	(hyphen_trie::insert_hyphenation): Updated.
+	(hyphenate): Make `\hyphenation' entries obey `.hy' restrictions.
+
+	* doc/groff.texi (.hy): Updated.
+
+2018-03-01  Werner LEMBERG  <wl@gnu.org>
+
+	Adjust `.hy' values.
+
+	In most cases hyphenation constraints were too strict.  The now
+	selected values reflect the parameters used for the generation of
+	the (TeX) hyphenation patterns.
+
+	* tmac/an-old.tmac, tmac/cs.tmac, tmac/de.tmac, tmac/doc-common-u,
+	tmac/e.tmac-u, tmac/fr.tmac, tmac/s.tmac, tmac/sv.tmac: Fix `.hy',
+	`\nHY', and `\ndoc-hyphen-flags' values.
+
+	* doc/groff.texi, tmac/groff_man.7.man, tmac/groff_ms.7.man, NEWS:
+	Updated.
+
+2018-03-01  Werner LEMBERG  <wl@gnu.org>
+
+	Fix some problems related to hyphenation.
+
+	Introduce values 16 (allow hyphenation before last character) and 32
+	(allow hyphenation after first character) to the `hy' request
+	(#48904).
+
+	Really fix problem reported in issue #48904.
+
+	Fix #53243, which is a regression introduced in 2016-09-09.
+
+	* src/roff/troff/env.cpp (HYPHEN_LAST_CHAR, HYPHEN_FIRST_CHAR): New
+	enumeration values.
+	(hyphenate_request): Check for contradicting values.
+	(environment::hyphenate_line): Fix minimum word length considered
+	for hyphenation.
+	(environment::print_env): Updated.
+	(hyphenate): Fix and extend logic.  The original patch to handle
+	#48904 was bad.
+
+	* doc/groff.texi, man/groff_diff.7.man, NEWS: Updated.
+
+2018-03-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add page transitions to pdfs created with gropdf.
+
+	* src/devices/gropdf.pl: Handle new '\X' commands to support page
+	transitions in presentation mode pdfs. These commands are a subset
+	of the commands used in present.tmac allowing slideshows to be
+	directly produced from -Tpdf without using postscript -> gpresent.pl
+	-> ghostscript.
+
+	* tmac/pdf.tmac: New macros '.pdfpause' and '.pdftransition' to
+	support page transitions.
+
+	* src/devices/gropdf.1.man: Document the '\X' commands supported.
+
+2018-03-01  Werner LEMBERG  <wl@gnu.org>
+
+	Use $(AM_V_GEN) and $(AM_V_P) to silence even more file generation.
+
+	* font/devpdf/devpdf.am (BuildFoundries, DESC, Foundry,
+	build_font_files): Do it.
+
+2018-02-28  Werner LEMBERG  <wl@gnu.org>
+
+	Use $(GROFF_V) to silence documentation creation.
+
+	* Makefile.am (GROFF_V): Define.
+
+	* doc/doc.am (.me.txt, .me.ps, .ms.html, .ms.txt, .ms.ps, pic.html,
+	webpage.html): Use $(GROFF_V).
+
+2018-02-28  Werner LEMBERG  <wl@gnu.org>
+
+	Use $(AM_V_GEN) to silence file generation.
+
+	* Makefile.am (.man), contrib/eqn2graph/eqn2graph.am (eqn2graph),
+	contrib/grap2graph/grap2graph.am (grap2graph), contrib/pic2graph.am
+	(pic2graph), src/devices/gropdf/gropdf.am (gropdf, pdfmom),
+	src/preproc/eqn/eqn.am (neqn), src/roff/grog/grog.am (grog),
+	src/roff/nroff/nroff.am (nroff), src/utils/afmtodit/afmtodit.am
+	(afmtodit), font/devascii/devascii.am (DEVASCIIFONTSFILES, DESC),
+	font/devcp1047/devcp1047.am (DEVCP1047FONTSFILES, DESC),
+	font/devhtml/devhtml.am (DEVHTMLFONTSFILES, DESC),
+	font/devlatin1/devlatin1.am (DEVLATIN1FONTSFILES, DESC),
+	font/devutf8/devutf8.am (DEVUTF8FONTSFILES, DESC),
+	font/devps/devps.am (DESC, prologue, zapfdr.pfa, symbolsl.pfa),
+	font/devdvi/devdvi.am (DESC), font/devlbp/devlbp.am (DESC),
+	font/devlj4/devlj4.am (DESC): Do it.
+
+2018-02-28  Werner LEMBERG  <wl@gnu.org>
+
+	* configure.ac: Activate silent Makefile rules.
+
+2018-02-28  Werner LEMBERG  <wl@gnu.org>
+
+	Minor compilation warnings.
+
+	* src/devices/xditview/draw.c: Don't declare `MaxFontPosition'.
+
+	* src/roff/troff/input.cpp (psbb_locator::context_args): Avoid
+	shadowing of `buf'.
+
+2018-02-28  Werner LEMBERG  <wl@gnu.org>
+
+	* src/roff/troff/env.cpp: s/HYPHEN_/HYPHEN_NOT/ for clarification.
+
+2018-02-26  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update installation doc.
+
+	* INSTALL.REPO: mention that 'pkg-config' is a dependency.
+
+	* INSTALL.extra: add dependency 'makeinfo' and optional
+	dependencies 'pkg-config' and 'uchardet'.
+
+	* TESTS: move to doc/automake_migration_tests.txt
+
+	* INSTALL.gen: remove, this file is redundant with the 'INSTALL'
+	file from gnulib.
+
+2018-02-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update 'gnulib' submodule.
+
+	* gnulib: now points on cf56f8f618c48cfadd2499ced58574633d12f129
+	from 'gnulib' repository.
+
+2018-02-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Use gnulib script 'git-version-gen' to define groff's version
+
+	* bootstrap.conf: add 'git-version-gen' script.
+
+	* configure.ac: suppress 'GROFF_VERSION_STRING' and replace it by
+	the script.  If the current commit corresponds to a tag, then the
+	version is simply the tag name.  Otherwise the version has the
+	format: <tag>-<nb_commits_from_latest_tag>-<commit sha1>.  The
+	version is now stored in '.version'.
+
+	* REVISION: removed.
+
+	* VERSION: removed.
+
+	* Makefile.am: define 'MAJOR_VERSION', 'MINOR_VERSION' and
+ 	'REVISION'.
+
+	* src/libs/libgroff/libgroff.am: use 'MAJOR_VERSION',
+	'MINOR_VERSION' and 'REVISION', add dependency on '.version'.
+
+	* src/roff/troff/troff.am: ditto.
+
+	* contrib/mom/om.tmac-u (short_revision): new string that extracts
+	the first digit of the revision, to be used when checking groff
+	version.
+
+2018-01-18  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	On reflection using an array for Filter is not optimal.
+
+	* src/devices/gropdf.pl: revert single line from commit
+	18fd1fd0bf05eb9a5ba0d2be1a655a044662a8bf.
+
+2018-01-17  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	All values should be 3 decimals
+
+	* src/devices/gropdf.pl: for values approaching zero values
+	in the for 0.nnnnnnE-nn could be written, not valid syntax for
+	PDF. Make all values rounded to 3 decimals, becomes 0.000.
+
+	Also changed stream Filter dictionary entry to an array.
+
+2018-01-14  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix tarball generation ('make distcheck'  failed)
+
+	* src/devices/xditview/xditview.am: add .h created by commit
+	382ab4af269a1dea422c8f9bb5c67a065d026deb to EXTRA_DIST
+
+	* contrib/mm/mm.am: restore distribution of files removed by
+	commit 445bf58765b759546e238a235651eb0bf5b34325.
+
+2018-01-13  Ingo Schwarze <schwarze@openbsd.org>
+
+	Makefile.am: Re-add -F and -M flags needed to build out of src.
+
+2018-01-13  Ingo Schwarze <schwarze@openbsd.org>
+
+	mdoc: rewrite the implementation of the .Lk macro
+
+	* tmac/doc.tmac-u (Lk): Rewrite.
+
+	The old implementation was written before the big mdoc
+	rewrite for groff-1.17.  In contrast to most other macros,
+	it was never updated to use the new techniques.
+	This new implementation makes .Lk callable, makes trailing
+	punctuation work in the normal way, and makes the style of
+	the implementation consistent with other macros.
+
+	It also removes the feature of automatically switching
+	between in-line and displayed rendering depending on the
+	length of the link because that was inconsistent across
+	output modes and counter-intuitive, resulting in ugly
+	output for many existing real-world manual pages.
+	It now always renders in-line.  Use .D1 Lk where desired.
+
+	Merging http://savannah.gnu.org/bugs/?52849
+	OK wl@gnu, jmc@openbsd, bentley@openbsd
+
+2017-12-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Comment compatibility-mode switching.
+
+	The '.do' and '.cp' requests (both groffisms) are some of the
+	more obscure features of groff's own man page corpus.
+	Consequently, they get cargo-culted around, within and outside
+	groff.  Thanks to Werner Lemberg for the discussion, which
+	revealed (to me) that groff ships with compatibility mode on by
+	default on Solaris 10 and 11.
+
+	Fix bug https://savannah.gnu.org/bugs/?52444.
+
+2017-11-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/roff/troff/input.cpp:
+	Make writers to stderr identify themselves.
+
+	* font/devpdf/util/BuildFoundries.pl:
+	Same; also refactor all diagnostics into Notice(), Warn(), and
+	Die() functions, which delegate their common message-printing to
+	Msg().
+
+	Fix part of bug https://savannah.gnu.org/bugs/?52463.
+
+2017-11-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	man pages: Fix compatibility-mode problems.
+
+	* contrib/gperl/gperl.1.man: Use idiomatic .BI macro instead of
+	  leading an input line with a font escape followed by a dot,
+	  the interpretation of which differs based on compatibility
+	  mode.
+
+	* src/preproc/soelim/soelim.1.man: Make .mso request only after
+	  compatibility mode is turned off.
+
+2017-11-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Protect arguments to "tr" from globbing.
+
+	Prevents errors from tr during man page generation and possible
+	incorrect program prefixing in those pages if, for example, some
+	doofus has directories called "A", "B", ...  hanging around in
+	the build tree.
+
+2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/groff_mdoc.7.man: Use unstripped symbol names.
+
+	Fix bug https://savannah.gnu.org/bugs/?52442.
+
+2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/include/.gitignore: Ignore config.hin~ files.
+
+2017-11-18  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	test-groff.in: Enable backtraces and all warnings by default.
+
+	Fix bug https://savannah.gnu.org/bugs/?51482.
+
+2017-11-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/**: Migrate macro package diagnostics away from `quotes'.
+
+2017-11-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libgroff/new.cpp: Quieten compiler warning.
+
+	Define sized version of overloaded delete operator.  Duplicate
+	code from unsized delete operator because simply calling through
+	to it provokes another warning, -Wdelete-incomplete.
+
+	Fix rest of https://savannah.gnu.org/bugs/?52335.
+
+2017-11-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Better handle glyphs in font positions > 255
+
+	* src/devices/gropdf/gropdf.pl: Improve handling
+	when glyphs above 255 are used.
+
+2017-11-12  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf should load ALL 'download' files
+
+	* src/devices/gropdf/gropdf.pl: only the first 'download' file
+	found was loaded, it should load all found.
+
+2017-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libxutil/DviChar.c: Initialize "buckets" field of
+	structs.
+
+	Resolves missing-field-initializers warnings.
+
+2017-11-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/strip.sed: Stop rewriting symbol names.  A substitution
+	originally intended to strip the "doc-" prefix off of mdoc macro
+	and string names unintentionally caught some mom stuff.
+	Harmlessly in this instance, but with potentially surprising
+	future effects.  Remove (only) this substitution per discussion
+	in
+	https://lists.gnu.org/archive/html/groff/2017-11/msg00055.html
+	et sequentia.
+
+2017-11-11  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	* src/devices/grolbp/lbp.cpp (lbp_printer::setfillmode): Address
+	  misleading indentation warning.
+
+	* src/roff/troff/mtsm.cpp (mtsm::push_state, mtsm::pop_state):
+	  Same.  Only flush standard error if we just wrote to it,
+	  instead of unconditionally.
+
+	Fix bug https://savannah.gnu.org/bugs/?51483.
+
+2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/utils/xtotroff/xtotroff.c: Mark private function static.
+
+2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/libs/libxutil/xmalloc.c: Quieten gcc warning.  Mollify
+	-Wmissing-prototypes for xmalloc() in single-function file.
+
+2017-11-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	gxditview: Migrate extern declarations to headers.
+
+	Also mark some private functions as static.
+
+2017-11-11  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	src: Declare function protypes where necessary.
+
+	Fix bug https://savannah.gnu.org/bugs/?51513.
+
+2017-11-10  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	mom: Abort early with diagnostic in compatibility mode.
+
+	Fix bug https://savannah.gnu.org/bugs/?52333.
+
+2017-11-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* contrib/**: Migrate diagnostics away from `quotes'.
+
+2017-11-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/**: Migrate diagnostics away from `these quotes'.
+
+	Fix bug https://savannah.gnu.org/bugs/?52374.
+
+2017-11-07  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tmac/strip.sed: Remove nilpotent capture from address.
+
+2017-11-05  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	`preconv': fix usage of lib `uchardet'.
+
+	* src/preproc/preconv/preconv.cpp (detect_file_encoding): Fix
+	usage of uchardet 0.0.1, which may fail but return an empty string
+	instead of a null pointer, and fix some incorrect error
+	managements that might cause memory leaks.
+
+2017-11-05  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/devpdf.am: Silence warning from grep during clean.
+
+2017-11-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Drop unnecessary -F and -M flags from pdfmom
+	call.
+
+2017-11-02  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	man/groff_diff.7.man: Correct the explanation of the request
+	".itc"--it was backwards.
+
+	Fix bug https://savannah.gnu.org/bugs/?51502.
+
+2017-11-02  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	test-groff.in: Recognize additional contrib tmacs.
+
+	Fix bug https://savannah.gnu.org/bugs/?51598.
+
+2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.am: Force build to generate test-groff script.
+
+2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* font/devpdf/devpdf.am: Silence warning from grep during build.
+
+2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* doc/doc.am: Fix build of pic.html from clean tree.
+
+2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m4/groff.m4: Kill whitespace in macro diagnostic.
+
+2017-11-01  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	src/roff/grog/subs.pl: Fix typo in usage message.
+
+	Fix bug https://savannah.gnu.org/bugs/?51540.
+
+2017-10-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	m.tmac: Fix some formatting and textual issues.
+	* Protect full stops in strings \*Letns!{1,2,10,11}.
+	* Remove extraneous whitespace from string \*Pg_type!1.
+
+	Fix bug https://savannah.gnu.org/bugs/?51610.
+
+2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	refer-mm.tmac: Protect full stop in abbreviation of "ed.".
+
+	Fix bug https://savannah.gnu.org/bugs/?51611.
+
+2017-10-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* src/preproc/html/pre-html.cpp: Fix grammar in usage message.
+	When used attributively, e.g. as an adjectival phrase,
+	"command-line" should be hyphenated.
+
+2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	pdfpic: Suppress warning if in compatibility mode.
+
+	Fix bug https://savannah.gnu.org/bugs/?51945.
+
+2017-10-22  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	www.tmac: Rename font 'C' to 'CR'; define 'CR'.
+
+	The font name 'C' ('CW') is not a part of groff's fonts.
+
+	Fix bug https://savannah.gnu.org/bugs/?51417.
+	Also see https://savannah.gnu.org/bugs/?51426.
+
+2017-10-04  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix build on MacOS X
+
+	See https://savannah.gnu.org/bugs/?49651
+
+2017-09-11  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Build from git: Make `configure' fail if `yacc' is not found.
+
+	* m4/groff.m4 (GROFF_PROG_YACC): look for (in this order) `byacc',
+	`bison -y', `yacc'.  Set `YACC' to `missing' is nothing is found
+	and generate an error.  Don't generate an error if build is not
+	done from git as tarball already distribute files generated by
+	`yacc'.
+
+2017-09-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Update `gnulib' submodule with latest version.
+
+	* gnulib: now points on 07a187be7f66d3ced66587405f18205971c762e9
+	from `gnulib' repository.
+
+2017-09-02  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix .gitignore files for in-source build.
+
+	Fix bug https://savannah.gnu.org/bugs/?51415.
+
+2017-09-01  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix build on MacOS X
+
+	* Makefile.am: define `SED' command with LANG and LC_ALL set to C.
+	* contrib/mm/mm.am: use it.
+	* doc/doc.am: Ditto.
+
+	Fix bug https://savannah.gnu.org/bugs/?49649
+
+2017-08-30  Colin Watson <cjwatson@debian.org>
+
+	`BuildFoundries' should not be installed.
+
+	* font/devpdf/devpdf.am: remove installation of generated script
+	`BuildFoundries'.
+
+2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	pic2graph.1.man: Fix wrong macro for e-mail addresses.
+
+	Fix bug https://savannah.gnu.org/bugs/?51110.
+
+2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	groff_diff(7): Remove a repeated word.
+
+	Fix bug https://savannah.gnu.org/bugs/?51077.
+
+2017-08-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	groff_tmac(5): Fix double dot before request.
+
+	Fix bug https://savannah.gnu.org/bugs/?51070.
+
+2017-08-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	groff.texi: remove repeated words.
+
+	Fix bug https://savannah.gnu.org/bugs/?51046.
+
+2017-08-28  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	groff_man(7) manual page: Fix explanation of the ".itc" request.
+
+	See bug at https://savannah.gnu.org/bugs/?51043.
+
+2017-08-28  Ingo Schwarze  <schwarze@usta.de>
+
+	groff_man(7) manual page: recommendations for escape sequences.
+
+	See bug at https://savannah.gnu.org/bugs/?51021.
+
+2017-08-28  Ingo Schwarze  <schwarze@usta.de>
+
+	groff_char(7) manual: fix table "7-bit Character Codes"
+
+	See bug at https://savannah.gnu.org/bugs/?51020.
+
+2017-08-28  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Fix troff.1 misleading definition of -w all.
+
+	See bug at https://savannah.gnu.org/bugs/?47784.  Suggested by Kaz
+	Kylheku <kaz@kylheku.com>.
+
+2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	`preconv --version' crashes.
+
+	See bug at: https://savannah.gnu.org/bugs/?51587.
+
+	* src/preproc/preconv/preconv.cpp: Add a missing comma in the
+	argument list of "printf".
+
+2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	Fix bug: `.itc' request breaks subsequent `.it' requests.
+
+	See bug at: https://savannah.gnu.org/bugs/?51376.  Using `.itc'
+	lets all later uses of `.it' behave like `.itc', that is,
+	interrupted text line ending with \c is not counted as a separate
+	line.
+
+	* env.cpp: Restore input_trap state to normal when '.it' is
+	called.
+
+2017-08-25  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	Fix a part of a virtual (pseudo) structure in "tty.tmac".
+
+	* tmac/tty.tmac: Fix warning:  ".../git/groff/tmac/tty.tmac:19:
+	warning: unbalanced .el request"
+
+2017-08-25  Ingo Schwarze  <schwarze@usta.de>
+
+	`tty-char.tmac': focus on meaning rather than graphical shape
+
+	* tmac/tty-char.tmac: add ASCII renderings for six missing
+	mathematical symbols
+
+2017-08-22  Ingo Schwarze  <schwarze@usta.de>
+
+	`tty-char.tmac': focus on meaning rather than graphical shape
+
+	* tmac/tty-char.tmac: Switch the policy from trying to imitate the
+	characters' graphical shapes, which resulted in unintelligible
+	renderings in many cases, to transliterations conveying the
+	characters' meanings.  One benefit is making these characters
+	usable for portable manual pages.
+
+2017-08-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	'gropdf' does not correctly load new ghostscript fonts
+
+	See bug at: https://savannah.gnu.org/bugs/?50989. Since ghostscript
+	9.21 the fonts supplied have changed from .pfb to .pfa type (with a
+	raw binary section). These failed to be properly loaded.
+
+	* src/devices/gropdf/gropdf: Changes to handle raw binary section in
+	a .pfa type font.
+
+2017-08-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	`pdfmom' man page incorrectly displayed.
+
+	* src/devices/gropdf/pdfmom.1.man: Remove `' character mistakenly
+	added at the beginning of the file.
+
+2017-08-18  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Incorrect font name for CBI in Foundry.in.
+
+2017-08-15  Ingo Schwarze  <schwarze@usta.de>
+
+	Fix build if `configure' check for `fprintf-posix' fails.
+
+	See bug at: https://savannah.gnu.org/bugs/?51554.  If tests for
+	posix compliance of fprintf from `gnulib_m4/fprintf-posix.m4'
+	fail, a replacement function of `fprintf' is used.  Consequently,
+	all executables that use this function must link against the
+	gnulib (`libgnu.a').  The bug was introduced by commit
+	fa41eeba06987a12bc0434f8b51896d4618a3997.
+
+	* src/devices/xditview/xditview.am
+	* src/preproc/eqn/eqn.am
+	* src/preproc/pic/pic.am
+	* src/preproc/preconv/preconv.am
+	* src/preproc/refer/refer.am
+	* src/preproc/soelim/soelim.am
+	* src/preproc/tbl/tbl.am
+	* src/utils/addftinfo/addftinfo.am
+	* src/utils/hpftodit/hpftodit.am
+	* src/utils/indxbib/indxbib.am
+	* src/utils/lkbib/lkbib.am
+	* src/utils/lookbib/lookbib.am
+	* src/utils/pfbtops/pfbtops.am
+	* src/utils/tfmtodit/tfmtodit.am
+	* src/utils/xtotroff/xtotroff.am: link against libgnu.a
+
+	* INSTALL.REPO: recommend the autoconf and automake versions used
+	during automake migration rather than the minimum versions.
+
+2017-08-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	See bug at: https://savannah.gnu.org/bugs/?51568
+
+	* src/devices/gropdf/gropdf: Further 'fix' to handle those octal
+	characters. See comment #5 - thank you Bjarni.
+
+2017-07-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	See bug at: https://savannah.gnu.org/bugs/?51568
+	
+	* src/devices/gropdf/gropdf: previous 'fix' was too narrow, all
+	'\' characters should be escaped. Also there was an unwanted 
+	interaction with code in routine 'do_t'. Sometimes, do_C, when 
+	the named glyph is mapped to a chr < 32, this is encoded as octal
+	\nnn, so in this case the '\' must not be escaped.
+	
+2017-07-25  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	If input text contained string which could be interpreted as
+	escaped octal (\ddd) a pdf viewer would interpret as an octal
+	character.  See bug at: https://savannah.gnu.org/bugs/?51568
+	
+	* src/devices/gropdf/gropdf: protect text which resembles \ddd
+	by escaping with extra '\'.
+	
+2017-07-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Use uchardet library in `preconv' to detect input file encoding
+
+	* m4/groff.m4 (GROFF_UCHARDET): new macro that use pkg-config to
+	check if uchardet library is available and define new option
+	`--with-uchardet':
+	- If `yes' is passed and uchardet is not found, configure fails.
+	- If `no' is passed we don't use uchardet and don't display any
+	warning.
+	- If `auto' (or any other option) is passed of if --with-uchardet
+	is not passed, we use uchardet if available, otherwise the build
+	goes on but a warning is displayed at the end of the configuration
+	phase.
+
+	* configure.ac: use pkg-config and `GROFF_UCHARDET' to detect the
+	presence of uchardet library.
+
+	* src/preproc/preconv/preconv.am: link against uchardet library if
+	available.
+
+	* src/preproc/preconv/preconv.cpp (detect_file_encoding): new
+	function that uses uchardet library to detect input file encoding.
+	(do_file): `detect_file_encoding'.
+
+	* src/preproc/preconv/preconv.1.man: update `preconv'
+	documentation.
+
+	See https://savannah.gnu.org/bugs/?51330
+
+2017-07-12  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Add gnulib module fprintf-posix
+
+	* bootstrap.conf: do it.
+
+	* Fix compilation in some files that needed inclusion of
+	`config.h'.
+
+	See https://savannah.gnu.org/bugs/?51330
+
+2017-05-09  Bertrand Garrigues <bertrand.garrigues@laposte.net>
+
+	Package `ghostscript' 9.21 renamed some fonts installed in
+	`/usr/share/ghostscript/9.21/Resource/Font', e.g. URWGothicL-Demi
+	renamed to URWGothic-Demi, and dropped the installation of URW
+	fonts in `/usr/share/fonts/type1/gsfonts/', breaking font
+	generation in `font/devpdf/util/BuildFoundries.pl'.
+
+	* m4/groff.m4 (GROFF_URW_FONTS_PATH): New option
+	`--with-urw-fonts-dir' to pass a custom path to URW fonts.
+	(GROFF_URW_FONTS): search the presence of URW fonts by checking if
+	file `a010013l.pfb' exists in the paths given by `gs -h', in the
+	default paths used in `Foundry.in' and in the path given with
+	option `--with-urw-fonts-dir'.
+	(GROFF_URW_FONTS_CHECK): print a warning at the end of the
+	configuration phase if no URW fonts were found.
+
+	* configure.ac: call new macros `GROFF_URW_FONTS_PATH',
+	`GROFF_URW_FONTS' and `GROFF_URW_FONTS_CHECK'.
+
+	* font/devpdf/Foundry.in: add new basic fonts names and pass
+	custom URW fonts path `urwfontsdir'.
+
+	* font/devpdf/devpdf.am: substitute `urwfontsdir' in `Foundry'
+	generation.
+
+	Fixes https://savannah.gnu.org/bugs/?50786
+
+2017-05-04  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Fixes for gropdf
+	
+	* src/devices/gropdf/gropdf.pl: Escape '(' and ')' if
+	used in a bookmark, and ignore relative move 'h' if 
+	followed by absolute move 'H' in groff intermediate output.
+	
+2017-04-29  Ingo Schwarze  <schwarze@usta.de>
+
+	groff_char(7): improve description of ASCII characters
+
+	* man/groff_char.7.man: improve description of ASCII
+	characters that do not render as themselves
+
+	See https://savannah.gnu.org/bugs/?50898
+
+2017-04-28  Osamu Sayama
+
+	lkbib with empty file dumps core
+
+	* src/libs/libbib/index.cpp: Test if argument to malloc(3)
+	is zero.
+
+	See https://savannah.gnu.org/bugs/?48433
+
+2017-04-28  David Gilman
+
+	Typo in groff.texi
+
+	* doc/groff.texi: Dp instead of DP used
+
+	https://savannah.gnu.org/bugs/index.php?42251
+
+2017-04-28  Rich Burridge
+
+	"grops -c a" dumps core
+
+	* src/devices/grops/ps.cpp: conversion specifier %s changed
+	to %1 (errprint() uses special syntax different from
+	printf(3))
+
+	https://savannah.gnu.org/bugs/?42190
+
+2017-04-28  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	Macro "itc" is needed to make escape "\c" useful
+
+	* tmac/an-old.tmac: .it changed to .itc
+
+	https://savannah.gnu.org/bugs/?42907
+
+2017-04-28  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	First italic correction (\,) is absent in macros IR and IB
+
+	* tmac/an-old.tmac: Italic correction added
+
+	https://savannah.gnu.org/bugs/?42906
+
+2017-04-13  Ingo Schwarze  <schwarze@usta.de>
+
+	* tmac/doc.tmac-u: Make .Lk with more than two arguments
+	mdoc(7) conform
+
+	Use the second and following arguments as the link text.
+
+	Do not mark up the following colon with \fI.
+
+	Handle any number of trailing delimiters.
+
+	Problem reported by Anthony Bentley <bentley@openbsd.org>,
+	fixed by Ingo Schwarze <schwarze@usta.de>.
+
+	https://savannah.gnu.org/bugs/?50789
+
+2017-04-12  Werner LEMBERG  <wl@gnu.org>
+
+	Update German hyphenation patterns.
+
+	* tmac/de.tmac: Add more hcode values.
+	No longer use `hyphenex.det'.
+	* tmac/hyphen.den, tmac/hyphen.det: Updated to `dehyph-exptl-0.41'.
+	* tmac/hyphenex.det: Removed, no longer needed.
+	* tmac/tmac.am (TMACNORMALFILES): Updated.
+
+2017-04-10  Ingo Schwarze  <schwarze@usta.de>
+
+	* tmac/doc.tmac-u: Punctuation handling of .Lk fixed
+
+	The implementation of the groff_mdoc(7) .Lk (hyperlink) macro
+	contains code to make sure that the second argument is not
+	punctuation before treating it as a link text, but the test
+	can never lead to the result "punctuation" because the
+	initialization of the global variable doc-width was missing
+	before the call to doc-get-arg-type.  Consequently, even "."
+	was not recognized as punctuation.
+
+	Problem reported by Anthony Bentley <bentley@openbsd.org>,
+	fixed by Ingo Schwarze <schwarze@usta.de>.
+
+	https://savannah.gnu.org/bugs/?50771
+
+2017-04-07  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/hyphenex.us: Updated to current release from TeXLive.
+
+2017-02-23  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	* bootstrap: update with latest version from gnulib.
+	* gnulib: update the git submodule with latest version (commit
+	4084b3a1094372b960ce4a97634e08f4538c8bdd from gnulib).
+
+2017-02-18  Colin Watson  <cjwatson@debian.org>
+
+	* src/preproc/eqn/main.cpp: Define EQ and EN if they are not already
+	defined, to appease "groff -wmac".
+	* src/preproc/pic/main.cpp: Likewise for PS and PE.
+
+	Fixes: http://bugs.debian.org/495713
+
+2017-02-16  Ingo Schwarze  <schwarze@usta.de>
+
+	mdoc %T: use typographic quotes
+
+	* tmac/doc.tmac-u: Changed \*q to \*Lq and \*Rq
+
+	Citing Anthony J. Bentley:
+
+	The below patch causes -mdoc to generate typographic quotes
+	around a %T (reference title) instead of straight quotes.
+
+	I also submitted similar diffs to mandoc and heirloom troff
+	(which haven't been committed yet).  It would be nice for
+	the major implementations not to differ here, and the change
+	is trivial. 
+
+	It's worth noting that groff's refer(1) already uses typographic
+	quotes around %T with my -ms documents.
+
+	https://savannah.gnu.org/bugs/?43553
+	http://comments.gmane.org/gmane.comp.tools.mdocml.devel/723 
+	https://github.com/n-t-roff/heirloom-doctools/pull/6
+
+2017-02-16  Ingo Schwarze  <schwarze@usta.de>
+
+	mdoc \*Lq, \*Rq: map to \lq, \rq for all terminal
+	devices
+
+	* tmac/doc-nroff-u: .ds Lq \lq, .ds Rq \rq
+
+	If you use \lq and \rq directly in your document, the
+	quotes already render nicely for all terminal devices:
+	as U+201C and U+201D for devutf8 and as ASCII 0x22 (") for
+	devascii and devlatin1.
+	So it is not quite clear why doc-nroff should avoid
+	\lq and \rq when resolving \Lq and \Rq for devascii
+	and devlatin1. Quite to the contrary, many people seem to
+	consider "``" and "''" ugly renderings because they look
+	unbalanced.
+
+	See
+
+	https://savannah.gnu.org/bugs/?43554
+
+2017-02-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	Use the traditional (portable) method of using a backslash
+	after '\{'
+
+	* contrib/mm/m.tmac, tmac/e.tmac-u,
+	  tmac/s.tmac: Add '\' after "\{"
+
+	See
+
+	https://savannah.gnu.org/bugs/?49917
+
+2017-02-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	Use explicit \s±n after a variable string instead of \s0
+
+	* tmac/e.tmac-u: Change \s0 to \s+3
+
+	See
+
+	https://savannah.gnu.org/bugs/?49915
+
+2016-12-29  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Remove duplicate '-e' from gropdf manual.
+	
+	* src/devices/gropdf/gropdf.1.man: Remove first '-e'.
+	
+2016-11-25  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Remove incorrect info from gropdf manual.
+	
+	* src/devices/gropdf/gropdf.1.man: Remove references
+	to postscript.
+	
+2016-11-22  George HELFFRICH  <ghfbsd@gmail.com>
+
+	me: Fix alignment of `(c' macro (#43306).
+
+	* tmac/e.tmac-u ((c): Properly initialize environment.
+
+2016-11-20  George HELFFRICH  <ghfbsd@gmail.com>
+
+	me Fix vertical spacing of `(b' macro (#42217).
+
+	* tmac/e.tmac-u (@k): Apply pre-spacing conditionally.
+	()b): Updated.
+
+2016-11-19  George HELFFRICH  <ghfbsd@gmail.com>
+
+	me Fix remaining bugs with line numbering (#49650).
+
+	* tmac/e.tmac-u (nm): Redefine.
+	(.n1, .n2): Update so all environments affected.
+	(.ip): Fix double numbering.
+	(.)c, .)l): Restore numbering after diversion included.
+
+2016-11-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf remaps characters to position 13 (#48986).
+	
+	* src/devices/gropdf/gropdf: Do not remap anything to chr(13).
+
+2016-11-01  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	pdfmom was not including $preconv in the initial groff run.
+	
+	* src/devices/gropdf/pdfmom.pl: Include $preconv in first 
+	groff run which resolves forward pdf references.
+
+2016-10-05  Ingo Schwarze  <schwarze@usta.de>
+
+	* tmac/doc.tmac-u: Simplify behaviour of .Bl -tag
+	* tmac/groff_mdoc.7.man: Update documentation to the new
+	behaviour of .Bl -tag
+
+	If an mdoc(7) .Bl -tag macro lacks the -width argument, the
+	body indentation is calculated separately for each child .It
+	macro.  Neither the Heirloom nor the mandoc(1) implementation
+	of the mdoc(7) language show such behaviour; both use a
+	constant default width for the whole list in that case.
+
+	Apart from doubts whether lists with variable indentation are
+	typographically sound in the first place, support for variable
+	widths in groff is so restricted that it's practically
+	useless.  For each .It, the width will be the default width of
+	whatever happens to be the leading macro after the .It, or of
+	.No if .It is not followed by a macro.
+
+	See
+
+	https://savannah.gnu.org/bugs/index.php?49272
+
+	and
+
+	http://lists.gnu.org/archive/html/groff/2016-10/msg00006.html
+
+
+2016-09-09  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/sv.tmac: Fix `.hy' settings (#48904).
+
+	The Swedish patterns allow hyphenation after the first character and
+	before the last two characters, not vice versa.
+
+2016-09-09  Werner LEMBERG  <wl@gnu.org>
+
+	troff: Fix hyphenation (#48904).
+
+	This commit fixes two bugs present from the very beginning: troff
+	(a) didn't allow to hyphenate words shorter than 4 characters
+	(ignoring `.hy' settings), and (b) never tried to hyphenate after
+	the first character due to wrong handling of the `.hy' settings.
+
+	* src/roff/troff/env.cpp (environment::hyphenate_line): Use
+	hyphenation flags to determine the minimum word length considered
+	for hyphenation.
+	(hyphenate): Fix handling of `HYPHEN_FIRST_CHARS'.
+
+2016-07-29  Colin Watson  <cjwatson@debian.org>
+
+	Implement `SOURCE_DATE_EPOCH' for reproducible builds.
+
+	* src/include/curtime.h: New file.
+	* src/libs/libgroff/curtime.cpp: New file.
+	* src/libs/libgroff/libgroff.am (libgroff_a_SOURCES): Add
+	src/libs/libgroff/curtime.cpp.
+
+	* src/roff/troff/input.cpp (init_registers): Use `current_time'
+	instead of `time(0)'.
+	* src/devices/grohtml/post-html.cpp
+	(html_printer::do_file_components): Likewise.
+	(html_printer::~html_printer): Likewise.
+	* src/devices/grops/ps.cpp (ps_printer::~ps_printer): Likewise.
+	* src/devices/gropdf/gropdf.pl: Use `$ENV{SOURCE_DATE_EPOCH}` if
+	available in preference to `time`.
+
+	* doc/groff.texi (Environment): Document `SOURCE_DATE_EPOCH'.
+	* src/devices/grohtml/grohtml.1.man (ENVIRONMENT): Likewise.
+	* src/devices/gropdf/gropdf.1.man (ENVIRONMENT): Likewise.
+	* src/devices/grops/grops.1.man (ENVIRONMENT): Likewise.
+
+2016-04-19  Carsten Kunze  <carsten.kunze@arcor.de>
+
+	eqn: Fix problem with explicit spacing before unary operator
+
+	* src/preproc/eqn/list.cpp (list_box::compute_metrics): Change
+	item spacing type from BINARY to ORDINARY also when previous
+	type is SUPPRESS_TYPE.
+
+	As reported in
+
+	http://lists.gnu.org/archive/html/groff/2016-04/msg00024.html
+
+	by Douglas McIlroy <doug@cs.dartmouth.edu>
+
+	an implicit space is added between an unary operator and its
+	operand when an explicit space is put before the unary
+	operator.  Unary operators are initially set up as binary.
+	Depending on the preceding element their type can be changed
+	to unary.  This did not happen when an explicit space ('~' or
+	'^') had been before that operator.
+
+2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+
+	Fix many malloc/new vs. free/delete/delete mismatches (#47164)
+
+	* src/devices/grops/ps.cpp (ps_font::~ps_font,
+	ps_printer::define_encoding): Use `free'.
+	* src/devices/grops/psrm.cpp (resource::~resource,
+	resource_manager::output_prolog, resource_manager::supply_resource,
+	resource_manager::read_download_file): Ditto.
+
+	* src/include/ptable.h (PTABLE::~PTABLE, PTABLE::define): Ditto.
+
+	* src/libs/libgroff/searchpath.cpp
+	(search_path::open_file_cautious): Ditto.
+
+	* src/libs/libgroff/string.cpp: Include `stdlib.h'.
+	(string::extract): Use `malloc'.
+
+	* src/preproc/eqn/box.cpp (quoted_text_box::~quoted_text_box): Use
+	`free'.
+
+	* src/preproc/eqn/lex.cpp (definition::~definition,
+	macro_input::~macro_input, top_input::~top_input, do_definition):
+	Ditto.
+
+	* src/preproc/eqn/main.cpp (main): Ditto.
+
+	* src/preproc/eqn/other.cpp: Include `stdlib.h'.
+	(size_box::~size_box, font_box::~font_box): Use `free'.
+
+	* src/preproc/eqn/text.cpp: Include `stdlib.h'.
+	(box::set_spacing_type, special_char_box::~special_char_box,
+	split_text): Use `free'.
+
+	* src/preproc/grn/main.cpp (conv): Use `free'.
+
+	* src/preproc/html/pre-html.cpp (get_resolution): Ditto.
+
+	* src/preproc/pic/lex.cpp (macro_input::~macro_input,
+	argument_macro_input::~argument_macro_input, for_input::~for_input):
+	Ditto.
+
+	* src/preproc/pic/main.cpp (do_picture): Ditto.
+
+	* src/preproc/pic/object.cpp: Include `stdlib.h'.
+	(text_piece::~text_piece, string_list::~string_list): Use `free'.
+
+	* src/preproc/pic/pic.ypp (placeless_element, element, text, label,
+	expr_not_lower_than): Ditto.
+
+	* src/preproc/pic/troff.cpp (troff_output::reset_color): Ditto.
+
+	* src/preproc/preconv/preconv.cpp (check_coding_tag): Ditto.
+
+	* src/preproc/soelim/soelim.cpp (do_file): Ditto.
+
+	* src/preproc/tbl/table.cpp (text_entry::~text_entry): Ditto.
+
+	* src/roff/groff/groff.cpp (possible_command::~possible_command,
+	possible_command::set_name): Ditto.
+
+	* src/roff/troff/env.cpp (hyphen_trie::read_patterns_file): Ditto.
+
+	* src/roff/troff/node.cpp (suppress_node::tprint): Ditto.
+
+2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+
+	Use `malloc' in `strsave'; use `free' for returned pointers (#47164).
+
+	* src/libs/libgroff/font.cpp (text_file::~text_file): Use `free'.
+
+	* src/libs/libgroff/searchpath.cpp (search_path::open_file): Use
+	`free'.
+
+	* src/libs/libgroff/strsave.cpp: Include `stdlib.h'.
+	(strsave): Use `malloc'.
+
+2016-02-16  Bálint Réczey  <balint@balintreczey.hu>
+
+	Simplify memory allocation (#47162).
+
+	Many invalid memory accesses were caught by UBSAN (e.g., invalid
+	memory access in `small_temp_iterator::operator new') while
+	bootstrapping hardened1-linux-amd64 Debian port in the `free_list'
+	handling because it doesn't properly handle the padding between
+	array elements.
+
+	Some places were already #if 0-d out anyway.
+
+	* src/roff/troff/input.cpp (small_temp_iterator): Remove class.
+	(make_temp_iterator): Use `temp_iterator' only.
+
+	* src/devices/grotty/tty.cpp (tty_glyph): Remove `free_list', `new',
+	and `delete'.
+
+	* src/include/color.h, src/include/color.cpp (color): Ditto.
+
+	* src/roff/troff/env.cpp (tab): Ditto.
+
+	* src/roff/troff/node.cpp (glyph_node): Ditto.
+
+2016-02-15  Bálint Réczey  <balint@balintreczey.hu>
+
+	pre-grohtml Fix out-of-bounds array access (#47161).
+
+	* src/preproc/html/pre-html.cpp (char_buffer::write_upto_newline):
+	Implement it.
+
+2016-02-15  Bálint Réczey  <balint@balintreczey.hu>
+
+	Don't use `memcpy' with NULL input or output argument (#47160).
+
+	* src/libs/libgroff/string.cpp (string::string, string::operator=):
+	Implement it.
+
+	* src/roff/troff/input.cpp (temp_iterator::temp_iterator): Implement
+	it.
+
+2016-02-04  Carsten Kunze  <carsten.kunze@arcor.de>
+
+	* tmac/s.tmac: Bugfix of previous commit simplified (and
+	introduced redundancy removed) by use of .par*start for .QS and
+	.QE.  This is consistent since any other paragraph macro is
+	using .par*start.
+
+2016-02-02  Carsten Kunze  <carsten.kunze@arcor.de>
+
+	* tmac/s.tmac: Macros .QS and .QE changed to insert vertical
+	inter-paragraph space.  A paragraph bracketed with .QS/.QE
+	should appear identical to a .QP paragraph followed by .LP.
+
+	* tmac/groff_ms.7.man, doc/groff.texi: Documentation of macros
+	.QS and .QE added and .QP information improved (effect of
+	registers QI and PD).
+
+	See also discussion at groff@gnu.org, thread starting at
+
+	http://lists.gnu.org/archive/html/groff/2016-01/msg00033.html
+
+	Issue reported by Douglas McIlroy <doug@cs.dartmouth.edu>
+
+2015-12-26  Carsten Kunze  <carsten.kunze@arcor.de>
+
+	* contrib/mm/m.tmac: Disable macro misc@tag in case output
+	  type is not HTML.
+
+	This macro did cause unwanted space in case a MM macros .H
+	had been followed immediately by .DS.
+
+	(See also discussion at groff@gnu.org, thread starting at
+	http://lists.gnu.org/archive/html/groff/2015-12/msg00033.html)
+
+	Bug reported by Damian McGuckin <damianm@esi.com.au>.
+
+2015-12-14  Werner LEMBERG  <wl@gnu.org>
+
+	* src/preproc/eqn/text.cpp (entity_table): s/lamda/lambda/.
+
+	Bug reported by Brian McGuinness <mcguinne@fdu.edu>.
+
+2015-10-27  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf was choking on -I flag passed by groff, now uses
+	these directories to search for included pdfs.
+	
+	* src/devices/gropdf/gropdf.pl: Handle -I flag, avoid
+	  unitialised values.
+	
+	* src/roff/groff/groff.1.man: Include 'X pdf: pdfpic'
+	
+	* src/devices/gropdf/gropdf.1.man: Document -I flag
+	
+2015-09-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: fix comments
+
+2015-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tmac/troffrc: Add .mso for file `pdfpic.tmac'.
+
+2015-08-28  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	* Makefile.am:
+	- Use only the naming `.section.man' for all man.pages.
+	- Replace `.man.n' by `.man' only, such that no `.n' is
+	generated.
+	- For example, the source `groff.7.man' is transformed into
+	`groff.7' in the same directory and then is by installing just
+	copied into one of the suitable installed man directory.
+
+2015-08-27  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tmac/pfdpic.tmac: Add tmac file for macro `PDFPIC'.
+
+	* tmac/tmac.am: Add new `pdfpic.tmac' file.
+
+	* man/groff_tmac.5.man: Add definition for the new tmac.
+
+2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* all man-pages *.man: Rename man-pages such that the man section
+	number before the final `.man'.
+
+	* all *.am: Include renaming.
+
+	* Makefile.am: Reset `.man.n' by `.157.man.n' with SUFFIXES
+	`.157.man .n'.
+
+2015-08-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.am: Fix definition of man157_MANS.
+
+2015-08-13  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* all *.am: Correct Emacs mode `End:' instead of `End.'.
+
+2015-08-09  Werner LEMBERG  <wl@gnu.org>
+
+	Revert previous commit, since it doesn't work correctly yet.
+
+2015-08-07  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	Add section name to all man-page names.
+
+	* Makefile.am: In `install-prefix-man' and `uninstall-prefix-man'
+	change `sed' commands.  Correct saving in man157_MANS.
+
+	* all *.man in source tree: Rename `manpage.man' to
+	`manpage.157.man'.
+
+	* all makefile.am in source tree: Add new man-page file name.
+
+2015-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.am, arch/mingw/mingw.am, arch/misc/misc.am,
+	* contrib/eqn2graph/eqn2graph.am, contrib/grap2graph/grap2graph,
+	* contrib/pic2graph/pic2graph.am, doc/doc.am,
+	* font/devX100/devX100.am, font/devX100-12/devX100-12.am,
+	* font/devX75/devX75.am, font/devX75-12/devX75-12.am,
+	* font/devascii/devascii.am, font/devcp1047/devcp1047.am,
+	* font/devdvi/devdvi.am, font/devhtml/devhtml.am,
+	* font/devlatin1/devlatin1.am, font/devlbp/devlbp.am,
+	* font/devlj4/devlj4.am, font/devpdf/devpdf.am,
+	* font/devps/devps.am, font/devutf8/devutf8.am,
+	* font/scripts/scripts.am, man/man.am,
+	* src/devices/grodvi/grodvi.am, src/devices/grohtml/grohtml.am,
+	* src/devices/grolbp/grolbp.am, src/devices/grolj4/grolj4.am,
+	* src/devices/gropdf/gropdf.am, src/devices/grops/grops.am,
+	* src/devices/grotty/grotty.am,
+	* src/include/include.am, src/libs/libbib/libbib.am,
+	* src/libs/libdriver/libdriver.am, src/libs/libgroff/libgroff.am,
+	* src/libs/libxutil/libxutil.am, src/preproc/grn/grn.am,
+	* src/preproc/html/html.am, src/preproc/pic/pic.am,
+	* src/preproc/preconv/preconv.am, src/preproc/tbl/tbl.am
+	* src/preproc/refer/refer.am, src/preproc/soelim/soelim.am,
+	* src/roff/groff/groff.am, src/roff/grog/grog.am,
+	* src/roff/nroff/nroff.am, src/roff/troff/troff.am,
+	* src/utils/addftinfo/addftinfo.am,
+	* src/utils/afmtodit/afmtodit.am, src/utils/hpftodit/hpftodit.am,
+	* src/utils/indxbib/indxbib.am, src/utils/lkbib/lkbib.am,
+	* src/utils/lookbib/lookbib.am, src/utils/pfbtops/pfbtops.am,
+	* src/utils/tfmtodit/tfmtodit.am, src/utils/xtotroff/xtotroff.am,
+	* tmac/tmac.am:
+	Add `Last update'.  Setup Emacs mode.
+
+2015-07-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Add -T for all `grog' output, also using
+	-Tps when no option -T is given in the arguments.
+
+	* src/roff/grog/grog.man: Add information about -T output.
+
+2015-07-23  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man: Add last update.  Add link on Wikipedia on groff.
+	Add link of groff tutorial by Laha.
+
+2015-07-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/*.pl: Add last update.
+
+	* src/roff/grog/subs.pl: Remove call to Perl INC::System::Simple,
+	use backticks instead.
+	Define &err().
+	Reorder some extensions.
+	Distinguish between .TH at first command for man and later on for
+	ms.
+
+2015-07-01 Peter Bray <pdb_ml@yahoo.com.au>
+
+	Fix Savannah bug #44784.
+
+	Compatibility Mode rendering of groff manual pages
+
+	* m4/groff.m4 (GROFF_WITH_COMPATIBILITY_WRAPPERS): New macro to
+	implement 'configure' option
+	'--with-compatibility-wrappers=<value>'.  With this option the
+	user can control how groff compatibility wrappers for
+	vendor-provided non-GNU macro sets are installed.
+
+	* configure.ac: Use new macro GROFF_WITH_COMPATIBILITY_WRAPPERS.
+
+	* Makefile.am: Define tmac_*_prefix if 'compatibility_wrappers' is
+	set to 'yes'.
+
+	* tmac/tmac.am: Use 'compatibility_wrappers' to control the
+	installation:
+
+	- If set to `no', the groff-provided macro set are installed in
+	<prefix>/share/groff/<version>/tmac/ with the original macro set
+	name.
+
+	- If set to `yes', the groff-provided macro set are installed in
+	<prefix>/share/groff/<version>/tmac/ with a prefix of
+	$(tmac_prefix) (which is usually `g') and the generated
+	compatibility wrappers are installed in
+	<prefix>/lib/groff/site-tmac, with the original macro set name.
+
+	- If set to `manual', the groff-provided macro set are installed
+	in <prefix>/share/groff/<version>/tmac/ with the original macro
+	set name and the generated compatibility wrappers are installed in
+	<prefix>/lib/groff/site-tmac, with a name of
+	<macro><wrapper_suffix> (which is usually `-os').
+
+2015-06-17  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/tty.tmac: Fix mapping of \bu character for -Tutf8.
+
+	Problem reported by carsten.kunze@arcor.de.
+
+2015-06-15  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	pdfmom should use $RT_SEP as path separator.
+
+	* src/devices/gropdf/gropdf.am: Use @RT_SEP@ as path separator.
+
+	* src/devices/gropdf/pdfmom.pl: As above but also fix typo in regex
+	for grep.
+
+2015-05-08  Eli Zaretskii  <eliz@gnu.org>
+
+	groff Make relocation really work.
+
+	See
+
+	  https://lists.gnu.org/archive/html/groff/2015-05/msg00000.html
+
+	* src/roff/groff/groff.cpp: Include `relocate.h'.
+	(main): Use `relocatep'.
+
+2015-05-03  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	Fix Savannah bug #44768 (Solaris 10 compatibility issues).
+
+	* m4/groff.m4 (GROFF_DIFF_D): new macro to check if `diff' has
+	option -D, and search for `gdiff' if not (new variable DIFF_PROG
+	will contain the `diff' program to be used).
+
+	* m4/groff.m4 (GROFF_HAVE_TEST_EF_OPTION): new macro to check if
+	`test' supports the option -ef (created new variable
+	HAVE_TEST_EF_OPTION).
+
+	* m4/groff.m4 (GROFF_BASH): new macro to search for `bash' (new
+	variable BASH_PROG will contain the full path to `bash' or
+	`/bin/sh' if `bash' was not found).
+
+	* configure.ac: use the 3 new macros defined in m4/groff.m4.
+
+	* contrib/gdiffmk/gdiffmk.am: set HAVE_TEST_EF_OPTION, BASH_PROG,
+	DIFF_PROG in the generated script `gdiffmk'.
+
+	* contrib/gdiffmk/gdiffmk.sh:
+	- Fix incorrect space after '!' in sed script regex.
+	- `test -ef' is not portable: If `bash' is not available and the
+	shell does not support `test -ef', the option to pass a third
+	argument as the output file is disabled.
+	- Report an error if `diff' does not support -D option.
+	- GNU diff and Solaris diff support -D, but #ifndef / #endif are
+	treated differently (GNU adds a '!' in the #endif): modify the
+	regexs in the sed script accordingly.
+
+2015-05-01  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/tmac.am (TMACNORMALFILES): Add `zh.tmac'.
+
+2015-04-30  Darcy SHEN  <sadhen1992@gmail.com>
+
+	Fix Savannah bug #44941.
+
+	* tmac/zh.tmac: New file to support basic Chinese (both simplified
+	and traditional).
+
+2015-04-22  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Fix Savannah bug #44891.
+
+	* src/devices/gropdf/gropdf.pl: If module Compress::Zlib is not
+	available fall back to producing uncompressed PDF and output a
+	warning.
+
+2015-04-22  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	Fix Savannah bug #44894.
+
+	* tmac/strip.sed: Add a `generated file' warning.
+
+2015-04-21  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Fix Savannah bug #44890.
+	Patch by Peter Bray.
+
+	* font/devpdf/devpdf.am: Don't use 'find -maxdepth'.
+
+2015-03-07  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Fix Savannah bug #44733.
+
+	Prevent mdoc(7) Bl with trailing -width or -offset from picking up
+	old args.
+
+	* tmac/doc.tmac-u (doc-do-Bl-args): When checking whether there is
+	another argument to a Bl macro, do not inspect the argument list
+	because it is never cleaned and may contain arguments from previous
+	macro invocations.  Instead, inspect the argument count which is
+	always up to date.
+
+2015-04-10  Daiki Ueno  <ueno@gnu.org>
+
+	Fix link error on NetBSD 6.
+
+	Reported by carsten.kunze@arcor.de in:
+	<https://lists.gnu.org/archive/html/groff/2015-04/msg00000.html>.
+	The problem can also be reproduced if gl_cv_func_wcwidth_works=no
+	is passed to configure.
+
+	* src/preproc/grn/grn.am (grn_LDADD): Change the link order of
+	libgroff.a and lib/libgnu.a according to dependency.
+	* src/roff/troff/troff.am (troff_LDADD): Likewise.
+
+2015-04-08  Werner LEMBERG  <wl@gnu.org>
+
+	Fix Savannah bug #44767.
+	Patch by Peter Bray.
+
+	* src/roff/grog/grog.am (grog): Correctly substitute `grog_dir'.
+
+2015-04-03  Werner LEMBERG  <wl@gnu.org>
+
+	Fix Savannah bug #44708 (2/2).
+
+	Make man pages work in compatibility mode.
+	Also fix some minor typos.
+
+	* contrib/pic2graph/pic2graph.man, man/ditroff.man, man/groff.man,
+	man/groff_diff.man, man/groff_out.man, man/groff_tmac.man,
+	man/roff.man, src/devices/grodvi/grodvi.man,
+	src/devices/grohtml/grohtml.man, src/devices/grolbp/grolbp.man,
+	src/devices/grolj4/grolj4.man, src/devices/grolj4/lj4_font.man,
+	src/devices/gropdf/gropdf.man, src/devices/gropdf/pdfmom.man,
+	src/devices/grops/grops.man, src/devices/grotty/grotty.man,
+	src/devices/xditview/xditview.man, src/preproc/eqn/eqn.man,
+	src/preproc/eqn/neqn.man, src/preproc/grn/grn.man,
+	src/preproc/pic/pic.man, src/preproc/preconv/preconv.man,
+	src/preproc/refer/refer.man, src/preproc/soelim/soelim.man,
+	src/preproc/tbl/tbl.man, src/roff/groff/groff.man,
+	src/roff/grog/grog.man, src/roff/nroff/nroff.man,
+	src/roff/troff/troff.man, src/utils/addftinto/addftinfo.man,
+	src/utils/afmtodit/afmtodit.man, src/utils/hpftodit/hpftodit.man,
+	src/utils/indxbib/indxbib.man, src/utils/lkbib/lkbib.man,
+	src/utils/lookbib/lookbib.man, src/utils/pfbtops/pfbtops.man,
+	src/utils/tfmtodit/tfmtodit.man, src/utils/xtotroff/xtotroff.man,
+	tmac/groff_man.man, tmac/groff_trace.man: Do it.
+
+2015-04-03  Werner LEMBERG  <wl@gnu.org>
+
+	Fix Savannah bug #44708 (1/2).
+
+	* tmac/andoc.tmac (reload_doc, reload_man): Don't use `de1',
+	otherwise we can't manipulate the compatibility flag within the
+	macro.
+
+	* tmac/doc-common-u (Dt): Remove invalid leading whitespace.
+
+2015-03-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl: Was not handling the final glyph
+	correctly in the "standard" fonts which are not embedded. They
+	actually have 257 glyphs (0-256) not 256 as I'd assumed, so the
+	remappiing code needs to be applied for them as well as the
+	embedded downloadable fonts.
+
+2015-03-11  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl: Fix problem remappiing
+	ellipsis (affects all glyphs > 255).
+
+2015-03-07  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/tmac.am (TMACSPECIALFILES): Removed.  No longer used.
+
+2015-03-07  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* tmac/doc-common-u (Dd): Avoid warning `unbalanced .el request'.
+
+2015-02-12  Werner LEMBERG  <wl@gnu.org>
+
+	Minor fixes due to renaming `groff.texinfo' to `groff.texi'.
+
+	* doc/doc.am (SUFFIXES): Update.
+	* m4/groff.m4 (GROFF_MAKEINFO): Update.
+
+2015-01-30  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	Automake migration and Gnulib integration.
+
+	Gnulib:
+	- Added gnulib as a git submodule.
+	- Integrated bootstrap scripts from gnulib.
+	- Gnulib m4 directory is now in `gnulib_m4', while Gnulib's .c
+	files are located in `lib'.  `gnulib_m4' and `lib' are generated
+	and distributed.
+
+	Automake:
+	- Removed Makefiles from the old build system.
+	- Converted Makefile.in into Makefile.am.
+	- Converted Makefile.sub files in all directories to a .am file.
+	- Removed configure, src/include/config.hin (now generated).
+	- Removed various helper scripts (config.guess, config.rpath...),
+	now installed by bootstrap in `build-aux'.
+	- Moved aclocal.m4 to acinclude.m4 (aclocal.m4 is now generated).
+	- Makefile in non-recursive style.
+	- Updated INSTALL.REPO (INSTALL is now a symlink to
+	gnulib/doc/INSTALL, original INSTALL file moved to INSTALL.extra)
+	- Added (empty) THANKS, AUTHORS files.
+	- Added a document on the usage of automake in groff in
+	doc/automake.pdf.
+
+	Additional features:
+	- Out-of-source build is supported.
+	- Parallel build is possible (make -j).
+	- Automatic targets from Automake: `make dist', `make distcheck'.
+	- 'make check' is available for automatic testing, gdiffmk's test
+	was plugged to this target.
+	- Auto-detect if make has builtin variable `RM'.
+
+2015-01-14  Ingo Schwarze  <schwarze@openbsd.org>
+
+	Fix Savannah bug #43905.
+
+	* src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
+	* src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Remove
+	double entries for `rk', `lk', `lt', `rt', `rb', and `lb'.
+
+2014-12-16  Werner LEMBERG  <wl@gnu.org>
+
+	Update Unicode-to-Unicode mapping to version 7.0.0.
+
+	* src/libs/libgroff/make-uniuni: Update emitted copyright.
+
+	* src/libs/libgroff/uniuni.cpp: Regenerated.
+
+2014-11-29  Werner LEMBERG  <wl@gnu.org>
+
+	Fix previous commit.
+
+	We forgot to test whether the patch works if compiling from
+	scratch...
+
+	Problem reported by Bertrand Garrigues
+	<bertrand.garrigues@laposte.net>.
+
+	* src/include/lib.h (interpret_lf_args, normalize_for_lf): Move
+	declarations to...
+	* src/include/lf.h: This new file.
+
+	* src/libs/libgroff/lf.cpp, src/preproc/pic/pic.h,
+	src/preproc/preconv/preconv.cpp, src/preproc/refer/refer.h,
+	src/preproc/soelim/soelim.cpp, src/preproc/tbl/table.h: Include
+	`lf.h'.
+	Make `lib.h' the first included header file.
+
+	* src/preproc/eqn/eqn.h: Don't include `stringclass.h'.
+	* src/preproc/eqn/main.cpp: Include `stringclass.h' and `lf.h'.
+
+	* src/roff/groff/groff.cpp: Make `lib.h' the first included header
+	file.
+
+2014-11-10  Eli Zaretskii  <eliz@gnu.org>
+
+	Improve native Windows port.
+
+	This patch fixes two issues.
+
+	  . Handle backslashes in `.lf' arguments for MS-DOS and Windows.
+	  . Fix file name quoting for the groff pipeline.
+
+	* src/preproc/soelim/soelim.cpp (do_file):
+	* src/preproc/refer/refer.cpp (do_file):
+	* src/preproc/preconv/preconv.cpp (do_file):
+	* src/preproc/pic/main.cpp (do_file):
+	* src/preproc/eqn/main.cpp (do_file): Call `normalize_for_lf' to
+	convert backslashes in the file name being processed to forward
+	slashes.
+
+	* src/include/lib.h (normalize_for_lf): Add prototype.
+
+	* src/preproc/eqn/eqn.h:
+	* src/preproc/pic/pic.h:
+	* src/preproc/refer/refer.h:
+	* src/preproc/tbl/table.h: Include stringclass.h before lib.h.
+
+	* src/libs/libgroff/lf.cpp (normalize_for_lf): New function.
+
+	* src/roff/groff/groff.cpp: Include stringclass.h before lib.h.
+	(append_arg_to_string) _WIN32 && !__CYGWIN__: Use only "..." for
+	quoting in native Windows builds.
+
+2014-11-18  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	My commit '3fe78135c9fe666dadffde2a822b0535d8db6feb' introduced
+	problem in subroutine `TextWid'.  Octal char `\nnn' returns width of
+	4 char string rather than width of single character.
+
+	* src/devices/gropdf/gropdf.pl: Change `TextWid' to recognise octal
+	escaped characters (\nnn).
+
+2014-11-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	See bug #43555.
+
+	* src/devices/gropdf/gropdf.pl: Correct Date Format.
+
+2014-11-04  Werner LEMBERG  <wl@gnu.org>
+
+	* src/libs/gnulib/*: Regenerate autotool files.
+
+2014-11-04  Werner LEMBERG  <wl@gnu.org>
+
+Version 1.22.3 released
+=======================
+
+	* NEWS, README, doc/webpage.ms: Updated.
+
+	* doc/texinfo.tex: Updated from `texinfo' repository.
+
+2014-10-29  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	* Makefile.in (OTHERDIRS): Mention `afmtodit' first.
+
+	Otherwise, some fonts in `devpdf' (`U-*') are not built.
+
+2014-10-26  Eli Zaretskii  <eliz@gnu.org>
+	    Werner LEMBERG  <wl@gnu.org>
+
+	Add Windows `.cmd' wrapper files.
+
+	* arch/mingw/*: New files, provided by Eli.
+
+	* Makefile.in (make_winscripts, make_install_winscripts,
+	make_uninstall_winscripts): New target variables.
+	(MDEFINES): Add them.
+	(OTHERDIRS): Add `arch/mingw'.
+
+	* m4/groff.m4 (GROFF_CMD_FILES): New macro
+	* configure.ac: Call it.
+	* configure: Regenerated.
+
+2014-10-23  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	Fix `install' and `uninstall' issues.
+
+	* contrib/chem/Makefile.sub (install_data): Fix build with option
+	--with-doc=no passed to configure (target `install_examples'
+	should not be executed).
+
+	* contrib/chem/Makefile.sub (uninstall_sub):  `uninstall' failed
+	if directories to be removed were not present.
+
+	* contrib/gpinyin/Makefile.sub (uninstall_sub): Ditto.
+
+	* contrib/hdtbl/Makefile.sub (GENFILES): generated files should
+	depend on the creation of the `examples' directory.
+
+2014-10-23  Daiki Ueno  <ueno@gnu.org>
+
+	* m4/iconv.m4: Really avoid false detection of non-working iconv.
+
+2014-10-21  Daiki Ueno  <ueno@gnu.org>
+
+	iconv: avoid false detection of non-working iconv
+
+	The INBUF/OUTBUF arguments of iconv can be either 'const char **'
+	or 'char **'.  If CC is g++, the difference causes a compile error
+	and thus leads to a false detection of non-working iconv.
+	Reported by Eli Zaretskii and Werner LEMBERG in:
+	<https://lists.gnu.org/archive/html/bug-gnulib/2014-10/msg00023.html>.
+
+	* m4/iconv.m4 (AM_ICONV_LINK): Try all possible argument types of
+	iconv.  Bump serial number.
+
+2014-10-20  Werner LEMBERG  <wl@gnu.org>
+
+	* src/libs/gnulib/lib/wctype.in.h: Include `config.h'.
+
+	Problem reported by Eli Zaretskii <eliz@gnu.org>.
+
+	This is a temporary hack to make groff compile with MinGW.  After
+	the switch to an automake infrastructure, together with proper use
+	of `gnulib', we can safely replace the patched file with a standard
+	version.
+
+2014-10-19  Doug McIlroy  <doug@cs.dartmouth.edu>
+
+	Fix Savannah bug #42151.
+
+	* src/preproc/eqn/lex.cpp (file_input::read_line): Handle CR/LF.
+	* src/preproc/pic/pic.cpp (file_input::read_line): Ditto.
+
+2014-10-18  Werner LEMBERG  <wl@gnu.org>
+
+	mdoc Add Darwin version string for OS X 10.10.
+
+	* tmac/doc-common (doc-operating-system-Darwin-14.0.0): New string.
+
+	* tmac/groff_mdoc.man: Updated.
+
+2014-10-15  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/webpage.ms: Remove obsolete references to tarballs and diffs.
+
+	Reported by Dave Kemper <saint.snit@gmail.com>.
+
+2014-10-15  Colin Watson  <cjwatson@debian.org>
+
+	Always distribute the parts of groff that require X11.
+
+	* Makefile.in (ALLLIBDIRS): Clone from `LIBDIRS', but include
+	src/devices/libxutil unconditionally.
+	(ALLPROGDIRS): Clone from `PROGDIRS', but include
+	src/devices/xditview and src/utils/xtotroff unconditionally.
+	(DISTDIRS): Use `ALLLIBDIRS' and `ALLPROGDIRS' rather than `LIBDIRS'
+	and `PROGDIRS'.
+
+2014-10-14  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Minor update to NEWS for pdfroff.
+
+	* NEWS (pdfroff): Note use of PHASE register, and not pdf:href.map,
+	to choose when to emit toc_relocation control record.
+
+2014-10-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	For pdfroff, deduce "--no-toc-relocation" from input stream.
+
+	* NEWS: Add notification; document the effect of changes, as recorded
+	in contrib/pdfmark/ChangeLog.
+
+2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Support `Mdocdate' CVS keyword substitution.
+	This fixes Savannah bug #42968.
+
+	This feature is used for OpenBSD manuals.
+
+	* tmac/doc-common (Dd): Handle `$Mdocdate:' argument.
+
+	* tmac/groff_mdoc.man: Document it.
+
+2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Add `.At III' and `.St -iso8601'.
+	This fixes Savannah bug #42971.
+
+	* tmac/doc-syms: Add corresponding version strings.
+
+	* tmac/groff_mdoc.man: Synchronize.
+
+2014-10-12  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Update operating system release numbers.
+	This fixes Savannah bug #42969.
+
+	* tmac/doc-common: Update NetBSD, OpenBSD, FreeBSD, and DragonFly
+	version strings.
+
+	* tmac/groff_mdoc.man: Synchronize.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/Makefile.in: Use `LC_ALL' in addition to `LANG'.
+	Suggested by Steffen.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Make PDF version compilable with makeinfo 5.x.
+
+	makeinfo 5.x handles macro expansion better, which changes the way
+	how an \LE macro (for a less-than sign) has to be defined.  However,
+	since we can't be sure that the latest version of `texinfo.tex' gets
+	used with makeinfo 5.x only, we would have to support both 4.x and
+	5.x.  No idea whether this is possible at all...  For this reason,
+	we now simply use @value directly instead of wrapping it into a
+	macro, avoiding any issues.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	doc Protect against picky `sed' programs.
+	Problem reported by Axel Kielhorn <tex@axelkielhorn.de>.
+
+	* doc/Makefile.in (GROFF_BIN_PATH, GROFF): Add `LANG=' to avoid
+	interpretation of non-ASCII characters by sed.
+
+2014-10-12  Michail Vidiassov  <master@iaas.msu.ru>
+
+	* tmac/doc-common: Add new Darwin versions.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: s/which/that/ where appropriate.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Various minor fixes.
+
+	Most of those glitches have been found by comparing the info output
+	from makeinfo 4.13 and the current SVN development version (of
+	makeinfo).
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve indexing.
+
+	Change @DefXXXItem and @DefXXXListEnd macros to not insert an index
+	entry.  New macro variants with a trailing `x' (like `@DefreqItemx')
+	can override this.
+
+	Update macro calls where necessary.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	doc Improve call to generation of `groff.pdf'.
+	Problem reported by Axel Kielhorn <tex@axelkielhorn.de>.
+
+	Since `groff.texinfo' contains latin-1 characters, some sed
+	implementations (like the one used on Mac OS 10.8) fail if called
+	with the wrong locale.  Basically, this is a `texi2dvi' bug, but we
+	can set `LANG' by ourselves to improve the situation.
+
+	* doc/Makefile.in (.texinfo.dvi, .texinfo.pdf): Set `LANG'
+	environment variable to empty string.
+
+2014-10-12  Werner LEMBERG  <wl@gnu.org>
+
+	doc Correctly handle `MAKEINFO' environment variable.
+	Bug introduced in commit from 2014-03-29.
+
+	* m4/groff.m4 (GROFF_MAKEINFO): Don't set MAKEINFO to empty string
+	before actually testing it.
+
+	* configure: Regenerated.
+
+2014-10-11  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	Fix an issue on `make dist'.
+
+	In order to make the tarball, `make dist' copies src/libs/gnulib
+	directories into the `tmp' directory without the `.deps'
+	directories, causing the failure of `make distclean' in
+	tmp/src/libs/gnulib.  Forcing a call to `config.status' recreates
+	the `.deps' directories.
+
+	* Makefile.in (dist): For gnulib, call `config.status' before `make
+	distclean'.
+
+2014-10-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/*.pl: Remove call from `IPC', use normal system
+	`instead'.
+
+2014-10-11  Guillem Jover  <guillem@hadrons.org>
+
+	Add support for various BSD versions.
+
+	* tmac/doc-common: Add new FreeBSD and DragonFly versions.
+
+2014-10-11  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Refactor .psbb request handling code.
+
+	* src/roff/troff/input.cpp (do_ps_file): Reimplement it, using...
+	(psbb_locator): ...this new locally declared and implemented class;
+	its constructor replaces all `do_ps_file()' capability, delegating
+	to other class methods, as appropriate.
+	(assign_registers): Encapsulate it, as a `psbb_locator' method.
+	(ps_get_line): Likewise, also renaming it to become...
+	(get_line): ...this class method; its internally defined `lastc'
+	static variable also becomes a non-static class member variable.
+	(PSBB_RANGE_IS_BAD, PSBB_RANGE_IS_SET, PSBB_RANGE_AT_END): New
+	manifest constants; define them.  They are now used by...
+	(parse_bounding_box): ...this function, now also encapsulated as
+	a `psbb_locator' class method, to convey parsing status.
+	(bounding_box): Struct obsoleted by `psbb_locator'; delete it.
+	(ps_bbox_request): Delegate to `psbb_locator'.
+
+2014-10-11  Werner LEMBERG  <wl@gnu.org>
+
+	Various clean-ups.
+
+	* NEWS: More updates.
+
+	* REVISION: Set to 3.
+
+	* doc/groff.texinfo: Update version and year.
+
+	* configure: Regenerated.
+
+	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+
+2014-10-11  Werner LEMBERG  <wl@gnu.org>
+
+	Update generic GNU files to recent versions.
+
+	* INSTALL.gen, config.guess, config.rpath, config.sub,
+	contrib/groff_filenames/Makefile.sub, doc/fdl.texi, doc/texinfo.tex,
+	doc/txi-en.tex, install-sh, m4/ax_prog_perl_version.m4,
+	m4/codeset.m4, m4/fcntl-o.m4, m4/glibc21.m4, m4/iconv.m4,
+	m4/lib-ld.m4, m4/lib-link.m4, m4/lib-prefix.m4, m4/localcharset.m4,
+	src/include/localcharset.h, src/libs/gnulib/Makefile.in,
+	src/libs/gnulib/aclocal.m4, src/libs/gnulib/build-aux/compile,
+	src/libs/gnulib/build-aux/config.guess,
+	src/libs/gnulib/build-aux/config.sub,
+	src/libs/gnulib/build-aux/depcomp,
+	src/libs/gnulib/build-aux/install-sh,
+	src/libs/gnulib/build-aux/snippet/arg-nonnull.h,
+	src/libs/gnulib/build-aux/snippet/c++defs.h,
+	src/libs/gnulib/build-aux/snippet/warn-on-use.h,
+	src/libs/gnulib/configure, src/libs/gnulib/lib/Makefile.in,
+	src/libs/gnulib/lib/config.charset, src/libs/gnulib/lib/intprops.h,
+	src/libs/gnulib/lib/localcharset.c,
+	src/libs/gnulib/lib/localcharset.h, src/libs/gnulib/lib/ref-add.sin,
+	src/libs/gnulib/lib/ref-del.sin, src/libs/gnulib/lib/stdbool.in.h,
+	src/libs/gnulib/lib/stddef.in.h, src/libs/gnulib/lib/streq.h,
+	src/libs/gnulib/lib/unitypes.in.h,
+	src/libs/gnulib/lib/uniwidth.in.h,
+	src/libs/gnulib/lib/uniwidth/cjk.h,
+	src/libs/gnulib/lib/uniwidth/width.c, src/libs/gnulib/lib/verify.h,
+	src/libs/gnulib/lib/wchar.in.h, src/libs/gnulib/lib/wctype-h.c,
+	src/libs/gnulib/lib/wctype.in.h, src/libs/gnulib/lib/wcwidth.c,
+	src/libs/gnulib/m4/00gnulib.m4, src/libs/gnulib/m4/Makefile.in,
+	src/libs/gnulib/m4/codeset.m4, src/libs/gnulib/m4/configmake.m4,
+	src/libs/gnulib/m4/extensions.m4, src/libs/gnulib/m4/fcntl-o.m4,
+	src/libs/gnulib/m4/glibc21.m4, src/libs/gnulib/m4/gnulib-tool.m4,
+	src/libs/gnulib/m4/inttypes-pri.m4,
+	src/libs/gnulib/m4/localcharset.m4, src/libs/gnulib/m4/longlong.m4,
+	src/libs/gnulib/m4/onceonly.m4, src/libs/gnulib/m4/wchar_t.m4,
+	src/libs/gnulib/m4/wint_t.m4, src/libs/libgroff/config.charset,
+	src/libs/libgroff/localcharset.c, src/libs/libgroff/ref-add.sin,
+	src/libs/libgroff/ref-del.sin, src/preproc/refer/refer.man: Do it.
+
+2014-10-11  Werner LEMBERG  <wl@gnu.org>
+
+	* NEWS, MANIFEST: Updated.
+
+2014-10-11  Werner LEMBERG  <wl@gnu.org>
+
+	* Makefile.in (OTHERDIRS, NOMAKEDIRS): Remove `ideal' references.
+
+2014-10-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/gideal: Temporarily remove this directory, because the
+	documentation and the preprocessor are not yet finished for
+	groff-1.2.23.
+
+2014-10-10  Werner LEMBERG  <wl@gnu.org>
+
+	* Makefile.in (dist): Clean up `src/libs/gnulib'.
+
+2014-10-10  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/webpage.ms: Updates.
+
+	The README and NEWS sections are not yet synchronized, though.
+
+2014-10-09  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* Makefile.in: Let `clean' and `distclean' descend into gnulib.
+
+	This fixes Savannah bug #42970.
+
+2014-10-02  Bertrand Garrigues  <bertrand.garrigues@laposte.net>
+
+	Set default X11 resources dir to `$prefix/lib/X11/app-defaults'.
+
+	Previously, X11 resources for gxditview were installed in
+	`/usr/X11/lib/X11/app-defaults', no matter which prefix was set.
+
+	Now, gxditview resources are installed in
+	`appresdir=$prefix/lib/X11/app-defaults'.  If `appresdir' is not a
+	standard X11 resource directory, the environment variable
+	`XFILESEARCHPATH' should be set to this path.
+
+	The behaviour of `--with-appresdir' is unchanged: This option can
+	still be used to set `appresdir', and its value will not be modified
+	by the prefix.
+
+	* m4/groff.m4 (GROFF_APPRESDIR_DEFAULT): Implement new behaviour.
+	Fix detection app-defaults location on the system.
+	(GROFF_APPRESDIR_CHECK): Updated.
+
+	* configure.ac: Improve output of configuration.
+	* configure: Regenerated.
+
+	* NEWS: Mention it.
+
+2014-09-27  Werner LEMBERG  <wl@gnu.org>
+
+	Set `transparent' flag for `\cq.
+	Problem reported by Dave Kemper <saint.snit@gmail.com>.
+
+	* src/roff/troff/input.cpp (init_charset_table): Do it.
+
+	* doc/groff.texinfo (Sentences, Using Symbols), man/groff_diff.man:
+	Document it.
+
+2014-09-25  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/*.pl: Program more reasonable subs (functions).
+	Repair details in many places.
+
+2014-09-24  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Refactor psbb line input function; avoid a buffer overrun.
+
+	* src/roff/troff/input.cpp (ps_get_line): Declare it as `static'.
+	Refactor, to avoid the overhead of character look-ahead and push-back
+	on CR stream input.  Add new `dscopt' parameter, in place of internal
+	`err' variable; update all call references, passing value of...
+	(DSC_LINE_MAX_ENFORCE): ...this new manifest constant; define it.
+	(DSC_LINE_MAX_IGNORED): Likewise; currently unused, but intended for
+	future use as an alternative to `DSC_LINE_MAX_ENFORCE'.
+	(DSC_LINE_MAX_CHECKED): New manifest constant; used internally only.
+	(PS_LINE_MAX): Manifest constant, renamed for notional consistency...
+	(DSC_LINE_MAX): ...to this; defined value remains as 255.
+	(do_ps_file): Increase stack allocation for `buf' char array; former
+	allocation of PS_LINE_MAX (now DSC_LINE_MAX) bytes exposed a potential
+	buffer overrun, after reading DSC_LINE_MAX bytes; two additional bytes
+	are required, to accommodate a terminating LF and NUL.  Add `dscopt'
+	parameter, with value `DSC_LINE_MAX_ENFORCE', in each of three calls
+	to `ps_get_line()'.
+
+2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Remove too much deleting while
+	running `make'.
+
+2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* `Makefile.sub' in the whole groff source tree: Add $(RM) and
+	change all `rm -f'.  Add directory test before `rmdir'.
+
+2014-09-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Man-pages (*.man) in the whole groff source tree: Improve
+	documents by adding \co, \cq, \aq instead of ` or ' and use
+	also \co as long as it makes sense.  Remove \en in the years
+	date in order to allow the automatic license year increasing.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* <groff-source-top>/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tmac/*: Improve the license information and Emacs setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/xtotroff/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/tfmtodit/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/pfbtops/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/lookbib/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/lkbib/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/indxbib/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/hpftodit/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/afmtodit/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/addftinfo/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/troff/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/nroff/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/tbl/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/soelim/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/refer/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/preconv/*: Improve the license information and Emacs
+	setup.
+
+2014-09-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/pic/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/html/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/grn/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/eqn/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/libxutil/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/libgroff/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/libdriver/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/libbib/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/gnulib/*: Improve the license information and Emacs
+	setup.  The former run of that was not yet complete.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/libs/gnulib/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/include/*: Improve the license information and Emacs setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grotty/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grops/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/gropdf/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grolj4/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grolbp/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grohtml/*: Improve the license information and Emacs
+	setup.
+
+2014-09-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/devices/grodvi/*: Improve the license information and Emacs
+	setup.
+
+2014-09-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/*.man: Improve the license information (definition of .co
+	and .au).
+
+2014-09-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* m4/*.m4: Improve the license information without changing the
+	related information.
+
+2014-09-06  Werner LEMBERG  <wl@gnu.org>
+
+	Fix build issues.
+
+	* m4/groff.m4: Fix typo.
+	s/refer_dir/referdir/ for consistency.
+
+	* configure: Regenerated.
+
+	* Makefile.in: s/refer_dir/referdir/ for consistency.
+
+	* src/preproc/refer/Makefile.sub (install_data, uninstall_sub):
+	Don't handle binaries or manpages; this is handled elsewhere
+	already.  Right now, only install and uninstall the `refer' data
+	directory.
+
+2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* configure: When I change the `configure' file manually, the
+	refer data dir is created.  But when running aclocal/autoreconf,
+	the dir is again not created.
+
+2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* m4/groff.m4, configure.ac, Makefile.in,
+	src/preproc/refer/Makefile.sub: Add information to create a refer
+	data directory by installing.  That dir is not yet generated
+	anyway.
+
+2014-09-05  Werner LEMBERG  <wl@gnu.org>
+
+	Regenerate configure files with correct parameters.
+
+	* configure.ac: Comment out m4 macros still missing.
+
+	* aclocal.m4, config.hin, configure: Regenerated.
+
+2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* some files in doc: Change the copying years to package form.
+	But many files have strange or no copying information.
+
+2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/pic2graph/Makefile.sub: Change the copying years to
+	package form.
+
+2014-09-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* FDL: Replace the changed actual file by the original `fdl.txt'
+	from <http://www.gnu.org/licenses/>.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/grap2graph/Makefile.sub: Remove `Last updates' from all
+	files.  Add and repair copyright.  Write Emacs setup.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/preproc/refer/refer.man: Include more distances for better
+	reading of the source file.  Add `%' for documentation of
+	bibliographic database lines.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tree contrib/eqn2graph: Remove `Last updates' from all files.
+	Add and repair copyright.  Write Emacs setup.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tree `arch': Remove `Last updates' from all files.  Add
+	and repair copyright.  Write Emacs seetup.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* <groff top source directory>: Remove `Last updates' from all
+	files.  Only `timestamp' values are left.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* <groff top source directory>: Repair copyright years from
+	starting year to actual year for almost all files.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* autom4te.cache: Remove that tree after running
+	`autoconf' or `autoreconf'.
+
+	* .gitignore: Add all files within `autom4te.cache' to get rid of
+	them automatically.  Not sure so far, if this works.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* BUG-REPORT, FDL, INSTALL*, MANIFEST, MORE.STUFF, NEWS, PROBLEMS,
+	PROJECTS, README*: Remove Emacs settings for coding style.  Change
+	copyright years from 1989-2014 and 1993-2014 into 2014 only.
+
+2014-09-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* configure.ac, Makefile.in: Try to use /usr/local/share directory
+	for `refer'.  Does not work so far.
+
+2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* All Makefile*: Add Emacs settings and lacking licenses.
+
+2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* BUG-REPORT, FDL, INSTALL*, MANIFEST, MORE.STUFF, NEWS, PROBLEMS,
+	PROJECTS, README*: Add Emacs settings.
+
+2014-09-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* PROJECTS: Add TODO for `refer'.
+
+2014-08-31  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/roff.man (roff.7): Replace Heirloom links to more actual
+	places.  Create macro definitions for authors (.au) and copying
+	(.co).
+
+2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff_font.man (groff_font.7): Restructure
+	file format, but keep content.
+
+2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/utils/addftinfo/addftinfo.man (addftinfo.1): Restructure
+	file format, but keep content.
+
+2014-08-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/roff.man (roff.7): Repair documentation of heirloom.
+
+2014-08-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add `gpinyin'.
+
+	* src/roff/grog/grog.man: Restructure `SEE ALSO'.
+
+2014-08-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/gpinyin: Make it runnable, version 1.0.0.
+
+2014-08-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* groff.7 (man/groff.man): Add further preprocessor regions.
+	Repair documentation for Unicode.
+
+2014-08-08  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* configure.ac, configure, Makefile.in, m4/groff.m4: Install paths
+	for implementing contrib/gpinyin's sub.pl.
+
+2014-08-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff_char.man: Add description for displaying `uxxxx' as
+	`\uxxxx'.
+
+2014-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man (groff.7): Replace \rs to \e as far as useful.
+
+2014-08-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man (groff.7): Add documentation for the Unicode
+	escapes \u.... and \u......
+
+2014-08-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.man: Improve documentation for `utf8'.
+
+2014-08-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/gpinyin: New preprocessor for having the European-style
+	writing	`pinyin' for the Chinese language.
+
+2014-07-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* groff.7 (man/groff.man): Add some useful special characters.
+
+2014-07-21  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tbl.1 (src/preproc/tbl/tbl.man): Add simple examples.
+
+2014-07-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* groff.7 (man/groff.man): Add section about underlining.
+
+2014-07-07  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man (groff.7): Add some basic special characters
+	`\(xy'.
+
+2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog, groffer: Minor repairing.
+
+2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Repair ligatures handling.
+
+2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Correct handling of standard input.
+
+2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.man: Minor correction.
+
+2014-07-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/*: Minor corrections.
+
+2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.cpp: In `usage()' and `help()' order
+	alphabetically.
+
+2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.pl, subs.pl: Heavily improve argument handling and `groff'
+	command line creation.
+
+2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.man: Make file runnable for `doclifter'.
+
+2014-07-05  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.man: Replace all .de by copying.  Restrict all .char names
+	to length 2 only.
+
+2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.man: Minor optimization.
+
+2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.man: Transform in classical man-page style.
+
+2014-07-04  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* grog.pl, subs.pl: Add option `--warnings'.  Rename
+	`--with_ligatures' to `--ligatures', but keep `--with_ligatures'
+	for compatibility.
+
+2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.in: Remove directories `groffer/perl' and
+	`groffer.shell', which don't exist any more.
+
+2014-07-03  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* PROJECTS: Mention the start of the `ideal' project.
+
+2014-06-21  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* Makefile.in: Unbreak make install:
+	Add missing gideal dirs to the dist tarball.
+
+2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.man: Correct the collection of the
+	installation directories.
+
+2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.man: Add the installation file and
+	directory positions of the whole package with @...@.
+
+2014-06-19  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man, src/roff/groff/groff.man: Add file position
+	before and after installation and the latest update.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Corrections about `require' and `our'
+	definitions.
+
+	* src/roff/grog/subs.pl: In the `groff' output command line, split
+	the single character options collections into different
+	1-character options, each with a leading minus `-'..
+2014-06-20  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Repair call of `push'.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Minor correction at `do_first_line'.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Adjust for first lines with non-preproc
+	and not-tmac names to be ignored.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add new first line
+	of roff files with the names of the needed preprocessors and the
+	actual tmac, see 2014-06-17 Ulrich Lauther.  Replace the
+	word `ideal' by `gideal', when the preprocessor is meant.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/Makefile.sub: Add $(RM).
+
+	* src/roff/grog/grog.pl: Remove call to perl_test.pl.  `require
+	5.6;' is enough as Perl test.
+
+	* src/roff/grog/perl_test.pl: Remove this file.
+
+2014-06-18  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* ChangeLog: Add Emacs-mode and a separator for the license.
+
+2014-06-17  Ulrich Lauther  <ulrich.lauther@t-online.de>
+
+	* grog: Invent new first comment line of roff files with long
+	names of needed preprocessors and the tmac.
+
+2014-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Correct handling of option `-J' for
+	ideal.
+
+2014-06-17  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/groff.cpp, src/roff/groff/pipeline.h,
+	* src/roff/grog/subs.pl: Add `groff' option `-J' for `gideal'.
+
+2014-06-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Remove too early listing of 3 `groff'
+	preprocessors options: gideal, glilypond, gperl.
+
+2014-06-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/gideal: New project for installing `ideal' for `groff'.
+
+	* Makefile.in: Add `gideal' for `OTHERDIRS'.
+
+2014-06-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Repair argument
+	handling for output `groff' line.
+
+2014-06-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl, src/roff/grog/grog.man: Correct and add
+	the documentation for filespec options.
+
+2014-06-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Activate handling of `--run', such that
+	now the generated `groff' command line can run.
+
+2014-06-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/subs.pl: Repair handling of filespec arguments.
+
+2014-06-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl, src/roff/grog/subs.pl: Add testing
+	methods of Ralph Corderoy's `grog.sh' of 2006.  Add primary usage
+	of file name extensions.
+
+2014-06-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Totally rewrite the `grog' version,
+	starting at the last stable version.  Write many parts as `sub'
+	functions.
+
+	* src/roff/grog/subs.pl: New file by splitting the src file
+	`grog.pl', such that all functions get into the new file
+	`subs.pl'.
+
+	* src/roff/grog/Makefile.sub: Add file `subs.pl', which goes into
+	the `grog' libdir.
+
+2014-06-03  James Cloos  <cloos@jhcloos.com>
+
+	* src/roff/grog/grog.pl: The errors with `ligatures' come also
+	from `TeX GYRE' fonts.  Print this information, when `grog' should
+	work with the `pdf' device.
+
+2014-06-02  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: The `grog' version of yesterday has many
+	bugs.  So reinstall an old version of `grog'.
+
+2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/Makefile.sub: Remove changing of first line
+	`#! ...'.
+
+2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Remove `$Sp' mostly.  Reorder script.
+	Check and repair requests.  Add final character `$' to many
+	checked requests.
+
+2014-06-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/roff.man: Move .TH at the beginning.
+
+2014-05-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff.man: In special characters, add the mentioning of the
+	`groff' writing `\xy'.
+
+2014-05-27  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff_char.man: Finish notes in all tables.
+
+2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/groff_char.man: Add notes in some tables, more will come.
+
+2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Add further first line characters for
+	single character `groff' options.
+
+	* src/roff/grog/grog.man: make generated options more readable.
+
+2014-05-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Add detection of `.\" eprt' as first
+	line to `grog'.  Change usage of `$Sp' to reasonable efforts in
+	`groff'.
+
+	* src/roff/grog/grog.man, man/groff_char.man: Add website for
+	license text, not only the postal address.
+
+2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* */Makefile.*: Path quoting fixes, whitespace, formatting.
+
+	Remove many quotes (and introduce a few as additional guards)
+	since groff's build system is generally not set up to properly
+	handle paths that need quoting.
+
+2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* Makefile.comm (extraclean): Don't delete `old'.
+
+	The rule calling `rm -f' was originally thought to remove private,
+	temporary files.  However, we now have a subdirectory called `old'
+	in `fonts/devps' that may not be removed, and trying so now causes
+	an error because we no longer ignore the returned error code of
+	`rm'.
+
+2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* Makefile.in (OTHERDIRS): Fix directory order.
+
+	This has been accidentally broken in commit 51476bee from
+	2014-02-25.
+
+2014-04-03  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* src/devices/gropdf/pdfmom.pl: Fix perl(1) warning.
+
+2014-03-30  Werner LEMBERG  <wl@gnu.org>
+
+	* configure: Regenerated.
+
+2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* */Makefile.*: Put straight error-prevention prefixes for `rm'.
+
+2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	`uninstall' target: Avoid spurious and misleading error messages.
+
+	* Makefile.comm (uninstall_dev): Improve.
+
+	* font/devpdf/Makefile.sub (install_data): Remove superfluous `rm'.
+	(uninstall_sub): Improve.
+
+	* src/roff/groff/Makefile.sub (uninstall_sub): Fix.
+
+2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	Fixes for `uninstall' target.
+
+	* Makefile.in (uninstall_dirs): Use `DESTDIR'.
+
+	* src/libs/libgroff/Makefile.sub (uninstall_charset_data): Typo.
+
+	* src/roff/groff/Makefile.sub (uninstall_sub): Typo.
+
+	* src/roff/grog/Makefile.sub (uninstall_sub): Minor.
+
+2014-03-30  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	* src/roff/grog/Makefile.sub (install_data): Typo.
+
+2014-03-29  Steffen Nurpmeso  <sdaoden@yandex.com>
+
+	Add fine-tuning of doc generation to `configure'.
+
+	* m4/groff.m4 (GROFF_DOC_CHECK): New macro, handling option
+	`--with-doc' and its new arguments.  It sets
+	`docadd_{html,info,other,pdf,examples}' and exports
+	`make{_,_install_,_uninstall_}{otherdoc,examples}'.
+	(GROFF_MAKEINFO): Extended to export
+	`make{_,_install_,_uninstall_}infodoc'.
+	(GROFF_HTML_PROGRAMS): Extended to export
+	`make{_,_install_,_uninstall_}{htmldoc,htmlexamples}'.
+	(GROFF_PDFDOC_PROGRAMS): Extended to export
+	`make{_,_install_,_uninstall_}{pdfdoc,pdfexamples}'.
+	(GROFF_INSTALL_INFO): Guard test with `docadd_info'.
+
+	* configure.ac: Use GROFF_DOC_CHECK.
+	* Makefile.in: Updated.
+
+	* doc/Makefile.sub: Handle examples separately, controlled by
+	$(make{_,_install_,_uninstall_}examples).
+
+2014-03-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* tmac/www.tmac (TAG): Define register `PN'.
+
+2014-03-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* tmac/an-ext.tmac (EX, EE): Preserve font family.
+
+2014-03-17  Werner LEMBERG  <wl@gnu.org>
+
+	* src/preproc/eqn/box.cpp (set_script_size): Fix minimum test.
+
+	Problem reported by Ted Harding <ted.harding@wlandres.net> in a
+	thread starting with
+
+	http://lists.gnu.org/archive/html/groff/2014-03/msg00181.html
+
+2014-03-16  Werner LEMBERG  <wl@gnu.org>
+
+	Fix previous commit.
+
+	Problem reported (with a patch) by Ingo Schwarze
+	<schwarze@openbsd.org>.
+
+	* doc/Makefile.sub (groff_bin_dirs): Add `preconv'.
+
+	* doc/Makefile.in (groff_bin_dirs): Add `preconv'.
+	(.me.txt): Call preconv.  Use UTF8 as output encoding.
+	(.me.ps): Call preconv.
+
+2014-03-14  Werner LEMBERG  <wl@gnu.org>
+
+	me Add translation of `meintro.me' to French.
+
+	Contributed by Grégoire Babey <gibux@gmx.ch>.
+
+	* doc/meintro_fr.me: New file.
+	* LICENSES, doc/Makefile.sub: Updated.
+
+2014-03-13  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+
+	man: Correctly reset margins.
+
+	See
+
+	http://lists.gnu.org/archive/html/groff/2013-11/msg00026.html
+
+	for more.
+
+	* tmac/an-old.tmac (set-an-margin): Whenever (re)setting
+	`\nan-level' to 1 (which happens when encountering `.TH', `.SH',
+	and `.SS') make sure to also (re)set `\nan-saved-margin1' and
+	`\nan-saved-prevailing-indent1' to a sane value such that an
+	immediate `.RE' cannot wreak havoc.
+	(TH, SH, SS): Updated.
+
+2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+
+	* Makefile.in: Do not forget to install gropdf manuals.
+
+	This got broken in 290eaaac6cfc33856cd683838accc72ccf3e5a84:
+	src/devices/gropdf was split out of OTHERDIRS into SHPROGDIRS, and
+	consequently, Makefile.man was no longer used there.  Note that
+	Makefile.dev is *not* needed, even though it's below /devices/.
+
+2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+
+	* src/roff/groff/Makefile.sub: POSIX conformance.
+
+	- POSIX says that the meaning of the make(1) `$<' macro shall be
+	   unspecified except in inference rules.  Consequently, use `$?'
+	   for portability.
+
+	   That's safe because the rules have only one prerequisite and
+	   are not `.PHONY', so `$?' will always expand to one item.
+
+	- While here, clean up two instances of superfluous use of cat(1).
+
+2014-03-11  Ingo Schwarze  <schwarze@openbsd.org> (tiny change)
+
+	* Makefile.in (dist): Improve.
+
+	- Bugfix: Do not error out if one of the DISTDIRS
+	   contains a subdirectory.
+	- Make debugging easier by splitting the huge "cd tmp; ...; ..."
+	   command sequence into several independent shell commands,
+	   such that one can see which command actually fails.
+
+2014-03-06  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Missing RE escape in grep.
+
+	* src/devices/gropdf/pdfmom.pl: Escape '\' dot in grep RE.
+
+2014-02-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Add detection of `gperl' to `grog'.
+
+2014-02-25  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/gperl: New preprocessor for Perl parts in groff files.
+
+2014-02-15  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* tmac/groff_mdoc.man: Improve the manual page template.
+
+	 - Add the EXIT STATUS section.  It is widely used in at least
+	   NetBSD, FreeBSD, OpenBSD, and DragonFly manuals.
+	 - Recommend the DIAGNOSTICS section for section 4 manuals.  Such
+	   usage is very widespread, in particular for kernel printf
+	   messages emitted by device drivers.
+	 - Do not recommend the DIAGNOSTICS section for command return
+	   values to the shell any longer.  While such usage historically
+	   existed, it does not seem common nowadays, and in any case, using
+	   the now well-established EXIT STATUS section seems preferable to
+	   me.
+	 - Mention the possibility to use ERRORS for section 4 manuals.
+	   While most section 4 manuals have a DIAGNOSTICS section, only
+	   some will need an ERRORS section, but these cases aren't exactly
+	   rare, either.  Quite some device driver manuals explain how to
+	   use the device using system calls like ioctl(2), open(2), read(2)
+	   or write(2), in which case the ERRORS section is the natural
+	   place to explain which errno values the driver may set during
+	   such system calls.
+	 - Mentioning signal handling as a content of the ERRORS section
+	   seems redundant, it is already covered by talking about the
+	   errno.  The case of errno == EINTR should be handled just like
+	   all other errno cases.  For an example showing that there is no
+	   need to single out error handling in any way, please look at a
+	   typical read(2) manual page.
+	 - Mention the CAVEATS section.  It first appeared in the 4.2BSD
+	   execve(2) manual in 1983, was already used by several manuals by
+	   the time of 4.4BSD-Lite2 in 1995, and is in whidespread use
+	   today, not just in BSD base system manuals, but for example in
+	   Perl manuals as well.
+
+2014-02-14  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Add detection of glilypond-parts in groff
+	files.  For example `grog example.groff' from the glilypond source
+	gets `glilypond example.groff | groff'.
+
+2014-02-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: With the former bugfix of 2014-02-12,
+	it's now possible to run `grog meref.me' etc., which wasn't
+	possible before.  That addition of the macro handling was
+	necessary for the automatic for `groffer'.
+
+2014-02-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/grog/grog.pl: Add handling of macro definition and fix
+	problems with @VERSION@.
+
+2014-02-12  Rich Burridge  <rich.burridge@oracle.com>
+
+	grn Prevent crash if more than 50 command line arguments.
+
+	* src/preproc/grn/main.cpp (INIT_FILE_SIZE, FILE_SIZE_INCR): New
+	macros.
+	(add_file): New function.
+	(main): Use it to add file arguments.
+
+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.
+
+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>
+
+	* 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'.
+
+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.
+
+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.
+
+	* 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
+	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
+	documentation in `synopsis()'.
+
+2013-12-06  Mike Frysinger  <vapier@gentoo.org>
+
+	Fix parallel build with gropdf and mom examples.
+
+	The `contrib/mom/examples/' directory uses the helper script from
+	`src/devices/gropdf/'.  Currently though, parallel builds might fail
+	like so:
+
+	  ...
+	  make2: Entering directory `.../groff-1.22.2/contrib/mom'
+	  <groff command> examples/letter.mom >examples/letter.pdf
+	  <groff command> examples/mom-pdf.mom >examples/mom-pdf.pdf
+	  /bin/sh: .../groff-1.22.2/src/devices/gropdf/pdfmom: No such file or directory
+	  make2: *** examples/letter.pdf Error 127
+	  /bin/sh: .../groff-1.22.2/src/devices/gropdf/pdfmom: No such file or directory
+	  make2: *** examples/mom-pdf.pdf Error 127
+	  make2: Leaving directory `.../groff-1.22.2/contrib/mom'
+	  make1: *** contrib/mom Error 2
+	  ...
+	  make2: Entering directory `.../groff-1.22.2/src/devices/gropdf'
+	  sed -f .../groff-1.22.2/arch/misc/shdeps.sed \
+	      -e "s|@VERSION@|1.22.2|" \
+	      -e "s|@PERLPATH@|/usr/bin/perl|" ./pdfmom.pl >pdfmom
+
+	The top level makefile tries to account for this in general with
+	OTHERDIRS, but looks like `src/devices/gropdf/' was added to this
+	variable (which holds `contrib/mom/' too) because gropdf installs a
+	shell script, and the other prog vars require it to be a dir of
+	things to compile.
+
+	  URL: http://crbug.com/324116
+	  URL: https://bugs.gentoo.org/487276
+
+	* Makefile.in (SHPROGDIRS): Declare.
+	(PROGDIRS): Add $(SHPROGDIRS).
+	(OTHERDIRS): Delete src/devices/gropdf.
+	($(SHPROGDIRS):): Add to existing rule.
+	($(OTHERDIRS):): Depend on $(SHPROGDIRS).
+
+2013-12-08  Eric S. Raymond  <esr@thyrsus.com>
+
+	Repository fully converted to git.
+
+2013-11-21  Werner LEMBERG  <wl@gnu.org>
+
+	* config.guess, config.sub: Updated from `config' repository.
+
+2013-11-06  Werner LEMBERG  <wl@gnu.org>
+
+	* src/libs/libgroff/tmpname.cpp (gen_tempname): Use O_BINARY.
+
+	Problem reported by Charlie Van Dien <charlie@vandien.com>; see
+
+	  http://lists.gnu.org/archive/html/groff/2013-10/msg00006.html
+
+2013-11-06  Werner LEMBERG  <wl@gnu.org>
+
+	* Makefile.comm (.man.n): Use C locale.
+
+	Problem reported by Petr Man <petr@madnetwork.org>; fix suggested by
+	Ralph Corderoy <ralph@inputplus.co.uk>.
+
+2013-07-24  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Implement `.%C'.
+
+	* tmac/doc.tmac, tmac/doc-common: Do it.
+	* tmac/groff_mdoc.man: Updated.
+
+2013-07-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Fix overprinting issue with Acrobat reader.
+
+	Problem reported by Heinz-Jürgen Oertel <hj.oertel@t-online.de>.
+
+	* src/devices/gropdf/gropdf.pl (do_t, FindChar): Use ascii octal
+	notation (i.e., \015) when outputting characters with value < 32.
+	This fixes a bug which affected acroread when control-M (cr) was
+	embedded in a text string.
+
+2013-07-16  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/fallbacks.tmac: Make it work in compatibility mode.
+
+	Problem reported by Y T <doarhop@hotmail.com>.
+
+2013-07-16  Werner LEMBERG  <wl@gnu.org>
+
+	* src/roff/grog/Makefile.sub (install_data, uninstall_sub): Typos.
+
+2013-07-16  Werner LEMBERG  <wl@gnu.org>
+
+	* Makefile.in (GREP, MDEFINES): Define and use plain grep.
+
+	Necessary for Bernd's code to extract groff options.
+
+2013-07-16  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* tmac/an-old.tmac (TP): Do not clobber line length after double
+	call to `.TP'.
+
+2013-07-02  Colin Watson  <cjwatson@debian.org>
+
+	* doc/groff.texinfo: Fix syntax error in documentation of `\z'.
+
+2013-07-02  Colin Watson  <cjwatson@debian.org>
+
+	* src/devices/grolbp/lbp.cpp (main): Don't write trailer if no
+	printer was created.
+
+2013-06-19  Eric S. Raymond  <esr@thyrsus.com>
+
+	* src/utils/lkbib/lbib.man: Move running text out of synopsis.
+
+2013-05-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Replace `cpp' by `groff.cpp'.
+
+2013-05-06  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.in: Add new `contrib' directory `RUNOFF'.
+
+2013-05-01  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Remove all `.PHONY:' lines.
+
+2013-04-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Replace `egrep' by `$(GREP)'.
+	commands.  Don't use $(CCSRCS) any more.
+
+2013-04-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.in, m4/groff.m4: Add `@libprogramdir@' and
+	`$libprogramdir' (usually `/usr/local/lib/groff').  Change
+	`$libdir/groff' into $libprogramdir for several `groff' programs.
+	Run `autoreconf -I m4'.
+
+	* src/roff/groff/MAkefile.sub: Add $(DESTDIR) and $(srcdir) in
+	order to support installation outside of source code.
+
+	* contrib/glilypond/Makefile.sub, contrib/glilypond/glilypond.pl:
+	Correct the install directories.
+
+2013-04-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Replace some variables by shell
+	commands.  Improve the output for the `make' runs.
+
+2013-04-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/Makefile.sub: Make this Makefile compatible.
+
+2013-04-28  Bernd Warken  <groff-bernd.warken-72@web.de>
+2013-04-28  Werner LEMBERG  <wl@gnu.org>
+
+	* src/roff/groff/Makefile.sub: Use `make' variables to get
+	`groff' options from `getopt' in `groff.cpp'.  Create 2 files
+	`groff_opts_no_arg.txt' and `groff_opts_with_arg.txt'.
+
+2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/read_groff_options.pl: Remove this file.  It's
+	no longer needed.
+
+	* src/roff/groff/Makefile.sub: Get the `groff' options from the
+	use of `getopt...' in `groff.cpp' using `$(EGREP)' and `sed'.
+	Store this information in a new file `groff_options.txt', which
+	is copied to `groff libdir' during the installation.
+
+2013-04-26  Werner LEMBERG  <wl@gnu.org>
+
+	Various minor fixes.
+
+	* INSTALL.gen: Take the newest version from the `gnulib'
+	repository.
+
+	* configure: Regenerated.
+
+2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* INSTALL.gen: Restore an older version from `2006' in
+	`groff-1.21'.
+
+	* FOR-RELEASE: New file which describes how to prepare `groff'
+	for a new release.
+
+2013-04-26  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* src/roff/groff/read_groff_options.pl: Reads `groff' options
+	from `groff.cpp' and writes them into the file `groff_options.info'.
+
+	* src/roff/groff/Makefile.sub: Have the generated file
+	`groff_options.info' be installed into the `groff libdir'.
+
+2013-04-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* INSTALL.gen: Replace this file by the daily `git' version of
+	`automake' `INSTALL' file.
+
+	* INSTALL.autotools: Remove file.
+
+	* INSTALL.CVS: New file, moved from `INSTALL.autotools'.
+
+	* m4/ax_prog_perl_version.m4: New file, taken from package
+	`autoconf-archive-2013.04.06'.
+
+	* m4/groff.m4: Remove unnecessary blank line.
+
+	* Makefile.in: Add `$(PERLVERSION)'.
+
+	* aclocal.m4: Run `autoreconf -I m4' (this includes
+	`aclocal -I m4').  This creates a suitable `aclocal.m4'.  Remove
+	generated subdirectory `autom4te.cache'.
+
+	* src/roff/grog/Makefile.sub: Correct `sed' command.  Use `tabs'
+	that are needed by `GNU make'.
+
+2013-04-16  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Makefile.sub: Add `m4/ax_compare_version.m4'.
+
+	* aclocal.m4: Run the latest `aclocal -I m4' which generates a
+	suitable content in that file.
+
+	* INSTALL.autotools: Information of the usage of `GNU autotools'
+	with `groff'.
+
+	* INSTALL.gen: Move `autotool' parts to file `INSTALL.autotools'.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* m4/groff.m4: Replace tabs by spaces.  Use a double line between
+	AC_DEFUNs.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	In the whole `groff' system, rename autoconf variable `$PERLPATH'
+	to `$PERL', which has the same content.  But `$PERL' suits to
+	`AX_PROG_PERL_VERSION' in m4 macro `GROFF_PERL' in `m4/groff.m4'.
+
+	* src/utils/afmtodit/Makefile.sub,
+	* src/devices/gropdf/gropdf.pl,
+	* src/devices/gropdf/Makefile.sub,
+	* src/devices/gropdf/pdfmom.pl,
+	* arch/djgpp/config.site,
+	* font/devpdf/Makefile.sub,
+	* contrib/mm/Makefile.sub,
+	* m4/groff.m4,
+	* Makefile.in: Replace `$PERLPATH' by `$PERL'.
+
+	* m4/ax_compare_version.m4: New file, copied from daily version of
+	`GNU autoconf-archive'.
+
+	`autoconf' was not yet run, a newer version is needed.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* README, INSTALL, INSTALL.gen, MANIFEST: Add documentation in the
+	top directory about some parts of `autotools' and `glilypond'.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* configure.ac: Add information of the macro `GROFF_PERL'.
+
+	* Makefile.in: Add definitions of the macro variables and their
+	`@...@' counterparts.
+
+	Run `autoreconf -I m4'.
+
+2013-04-15  Bernd Warken  <groff-bernd.warken-72@web.de>
+2013-04-15  Werner LEMBERG  <wl@gnu.org>
+2013-04-15  Ralph Corderoy  <ralph@inputplus.co.uk>
+
+	Add Perl test to configuration.  During the run of `configure' the
+	program is broken with error when there is no `Perl' or the `perl'
+	program is too old.
+
+	* m4/groff.m4: Add macro `GROFF_PERL' that tests the availability
+	of the `perl' program and tests whether this has a version of at
+	most `v5.6.1'.  Define variables $PERL and $PERLPATH for the full
+	name of the `perl' program and $PERLVERSION as the lest version.
+
+2013-04-13  Keith Marshall  <keithmarshall@users.sourceforge.net>
+
+	Avoid consideration of autotool cache for CVS inclusion.
+
+	* .cvsignore (autom4te.cache): Add reference.
+
+2013-04-13  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* `autotools': During the run of `autoconf' and `autoreconf' a
+	subdirectory `autom4te.cache' was created.  I first added this to
+	groff CVS and removed it again after an email-discussion.
+
+2013-04-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* `grog': Remove the shell version of `grog'.  Now there is only
+	Perl version.
+
+	* src/roff/grog/perl.sh: Remove this file.
+
+	* src/roff/grog/Makefile.sub: This file handles the removement of
+	the shell version.
+
+	* src/roff/grog/perl_test.pl: New file for testing the available
+	Perl version in the system to be installed into.  This file will
+	be installed into the grog lib-directory.
+
+2013-04-12  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* `grog': In the following, the file `grog.pl' will be split.  For
+	the coming files, a lib-directory is needed for storage.
+
+	* m4/groff.m4, configure.ac: Add libdir information for `grog'.
+
+	* Makefile.in: Add @grog_dir@.
+
+	Run `autoconf'.
+
+	`grog' has now a lib-directory at `$prefix/lib/groff/grog'.
+
+2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/groffer/: There is a free `git' package containing all
+	old `groffer' versions `v0.*' and `v1.*'.  The new versions
+	`groffer 2.*' will actually not be included.  This package can be
+	got at:
+
+	$ git clone git@github.com:RUNOFF/groffer.git
+
+2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/glilypond/: There is a free `git' package containing all
+	old versions of the former name `groff_lilypond v0.*'.  They work
+	with `lilypond' parts in `roff' files, but were not installed.
+	This package can be got at:
+
+	$ git clone git@github.com:RUNOFF/groff_lilypond.git
+
+	The new versions `glilypond v1.*' are not included there.
+
+2013-04-11  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* man/roff.man: For roff(7), add information about the free git
+	package RUNOFF.git with documentation about historical RUNOFF and
+	the available files written in the classical RUNOFF language..
+
+2013-03-29  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	Rename `groff_lilypond' to `glilypond'.  So remove the former
+	source directory `<groff_src_dir>/contrib/lilypond' and newly
+	install `<groff_src_dir>/contrib/glilypond', which now has many
+	files.  The new version starts at `v1.0'.
+
+	* m4/groff.m4, configure.ac: Add libdir information for
+	`glilypond'.
+
+	* Makefile.in: Add `<groff_src_dir>/contrib/glilypond'.
+
+	Run `autoconf'.
+
+	`glilypond' can now be installed to the system.
+
+2013-03-17  Ingo Schwarze  <schwarze@openbsd.org>
+
+	* font/devpdf/Makefile.sub: Build system fixes.
+
+	(GROFF_FONT_FILES): Avoid installing Makefile.sub.orig when it's
+	around.
+	(install): Create $(DESTDIR)$(fontsubdir)/util when missing.
+
+2013-03-05  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve documentation of `\s'.
+
+	Reported by Jim Avera <james_avera@yahoo.com>.
+
+2013-02-16  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve documentation of `.substring'.
+
+	Reported by Jim Avera <james_avera@yahoo.com>.
+
+2013-02-13  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Fix if-else example.
+
+	Reported by Jim Avera <james_avera@yahoo.com>.
+
+2013-02-10  Werner LEMBERG  <wl@gnu.org>
+
+	grops Make binary `%%BeginData' work; support `fontset' resource.
+
+	* src/devices/grops/psrm.cpp (resource_table): Add `fontset'.
+
+	(resource_manager::read_resource_arg): Do a case insensitive
+	comparison.  The PostScript Reference Manual gives the following
+	example for a CFF resource (example 5.7):
+
+	%!PS-Adobe-3.0 Resource-FontSet
+	%%DocumentNeedResources: ProcSet (FontSetInit)
+	%%Title: (FontSet/CFFRoman27)
+	%%Version: 1.000
+	%%EndComments
+	%%IncludeResource: ProcSet (FontSetInit)
+	%%BeginResource: FontSet (CFFRoman27)
+	/FontSetInit /ProcSet findresource begin
+	%%BeginData: 622532 Binary Bytes
+	/CFFRoman27 622503 StartData
+	... 622,503 bytes of binary data ...
+	%%EndData
+	%%EndResource
+	%%EOF
+
+	Note the `ProcSet' and `FontSet' keywords.  While the old DSC
+	(Document Structure Convention) documentation doesn't cover
+	`FontSet' at all (the DSC documentation predates the invention of
+	CFF), it describes only `procset' (all letters downcase), and it
+	also says that the DSC parser works in a case sensitive manner.
+
+	In other words, `ProcSet' is not valid according to the DSC
+	documentation, only `procset' is.  So much about today's validity
+	of DSC...  This patch adapts grops's code to the PostScript
+	reality.
+
+	(resource_manager::do_begin_data): Fix typo (present since the
+	beginning) which prevented correct handling of binary data.
+
+	* src/devices/grops/ps.h (resource_type): Add RESOURCE_FONTSET.
+
+2013-02-10  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* contrib/lilypond: New files for adding lilypond parts into groff
+	files.
+
+2013-02-07  Werner LEMBERG  <wl@gnu.org>
+
+Version 1.22.2 released
+=======================
+
+	* NEWS, REVISION, doc/groff.texinfo, doc/webpage.ms: Updated.
+
+	* configure: Regenerated.
+
+	* doc/texinfo.tex: Updated from `texinfo' repository.
+
+	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+
+2013-02-07  Werner LEMBERG  <wl@gnu.org>
+
+	* src/libs/gnulib/*: Update `gnulib' files.
+
+2013-02-02  Gilles Espinasse  <g.esp@free.fr>
+
+	grohtml Don't ignore return value of `dup'.
+
+	* src/preproc/html/pushback.cpp (pushBackBuffer::pushBackBuffer,
+	pushBackBuffer::~pushBackBuffer): Abort if `dup' fails.
+
+2013-01-30  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* tmac/groff_man.man: Fix wrong connection for tbl(1).
+
+2013-01-29  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Fix documentation of .LP macro in ms.
+	Problem reported by Omari Norman <omari@smileystation.com>.
+
+2013-01-29  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/Makefile.sub (uninstall_sub): Handle `gnu.eps'.
+
+2013-01-29  Werner LEMBERG  <wl@gnu.org>
+
+	Building clean-ups.
+
+	* Makefile.in: Use $(top_srcdir) where appropriate.
+	* Makefile.sub (M4MACROS): Add `fcntl-o.m4' and `localcharset.m4'.
+
+	* font/devpdf/Makefile.sub (UTILFILES): Removed, unused.
+	(MOSTLYCLEANADD): Add `BuildFoundries'.
+	* src/devices/gropdf/Makefile.sub (MOSTLYCLEANADD): Add `pdfmom'.
+
+2013-01-24  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Add a shell command to 'MANIFEST' that displays all man source
+	files and their section.
+
+2013-01-22  Bernd Warken  <groff-bernd.warken-72@web.de>
+
+	* Add email address in all files having the name.
+
+2013-01-14  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl (do_x, do_p, do_s, Set_LWidth): The
+	grops driver defaults to round linecaps and linejoins, gropdf
+	incorrectly used butt caps and miter joins.
+
+	(Since the MOM package expects to use butt caps and miter joins
+	(emitting the necessary postscript code to change the caps and
+	joins), gropdf now parses the same postscript commands.)
+
+	* src/devices/gropdf/gropdf.man: Document the handling of linecaps
+	and linejoins.
+
+	* tmac/pdf.tmac (pdfbookmark): Fix bug where the current
+	PDFOUTLINE.FOLDLEVEL may not be honoured if warnings of the type
+
+	macro warning: adjusted level n bookmark; should be <= n
+
+	Added copyright and mention debt owed to Keith Marshall for
+	original `pdfmark.tmac', upon which `pdf.tmac' is largely based.
+
+	* font/devpdf/Foundry.in, font/devpdf/util/BuildFoundries.pl
+	(LocateFile): The font for EURO had the wrong entry in the
+	`download' file (it pointed to The font in the build directory,
+	which is wrong).  It has always been permissible to include a
+	path along with the font name in the Foundry file, but until now
+	the font had to exist to be valid.  It is now permitted to start
+	the path with an asterisk which tells BuildFoundry to use the
+	path/filename in the download file without checking if the font
+	exists.  This allows the font to be found in `../devps' even
+	though it is not there during the build (if source and build are
+	different), but will be there after the install.
+
+2013-01-13  Werner LEMBERG  <wl@gnu.org>
+
+	eqn Fix display of matrices in nroff output.
+
+	Problem reported by Andy Spencer <andy753421@gmail.com>.
+
+	* src/preproc/eqn/pile.cpp (pile_box::compute_metrics,
+	matrix_box::compute_metrics): Fix rounding.
+
+2013-01-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* tmac/europs.tmac: Protect against missing fonts.
+
+2013-01-07  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* font/devpdf/util/BuildFoundries.pl (LoadFoundry): Improve
+	warning.
+
+2013-01-07  Werner LEMBERG  <wl@gnu.org>
+
+	tbl Allow characters #, `, and ' as eqn delimiters.
+
+	While problems ` and ' have been unintentionally introduced rather
+	recently, the limitation regarding # was there from the beginning.
+
+	At the same time, fix a small bug causing `.lf' requests not
+	starting a line.
+
+	* src/preproc/tbl/table.cpp (table::init_output)
+	(table::compute_expand_width, table::compute_separation_factor)
+	(table::define_bottom_macro, table::do_bottom): Temporarily switch
+	off eqn delimiters, wrapping the code into a `.ig' block.  This
+	uses the new functionality just added to eqn.
+
+	* src/preproc/eqn/eqn.man, src/preproc/tbl/tbl.man: Updated.
+
+2013-01-06  Werner LEMBERG  <wl@gnu.org>
+
+	eqn Add `delim on'.
+
+	* src/preproc/eqn/lex.cpp (start_delim_saved, end_delim_saved):
+	New global variables.
+	(do_delim): Handle `delim on' to restore previous start and end
+	delimiters.
+
+	* src/preproc/eqn/eqn.man, NEWS: Document it.
+
+2013-01-02  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf Various minor fixes.
+
+	* src/devices/gropdf/gropdf (do_x) <'X'> <'pdfpic'>: Using
+
+	\X'pdf: pdfpic'
+
+	with a zero width now works correctly.
+
+	(LoadPDF): Scale width in proportion to given height.
+
+	(do_s): In some circumstances a font size change is emitted before
+	current font is established.  Fix handles this situation.
+
+2012-12-30  Werner LEMBERG  <wl@gnu.org>
+
+Version 1.22.1 released
+=======================
+
+	Due to CVE-2012-3386, ftp.gnu.org rejected uploading of version
+	1.22 -- in other words, 1.22 has never been released.
+
+	* NEWS, REVISION, doc/groff.texinfo, doc/webpage.ms: Updated.
+
+	* Makefile.in (NOMAKEDIRS): Updated.
+
+2012-12-30  Werner LEMBERG  <wl@gnu.org>
+
+	* src/libs/gnulib/*: Update `gnulib' files.
+
+	Because we currently don't support `gnulib-tool' directly but add
+	everything to the CVS repository, and many internal details of the
+	gnulib setup has changed, it is necessary to do redo the import.
+
+	. Temporarily rename `src/libs/gnulib' to `src/libs/gnulib.old'.
+
+	. Call
+
+	    gnulib-tool --create-testdir \
+	                --dir=src/libs/gnulib \
+	                wcwidth
+
+	. Manually move directories `src/libs/gnulib/gl{lib,m4}' to
+	`src/libs/gnulib/{lib,m4}', and do `s/gllib/lib/' and `s/glm4/m4/'
+	in all files to `convert' the gnulib testbed to a standard gnulib
+	configuration as maintained by gnulib-tool.  Additionally, remove
+	the directory `src/libs/gnulib/gltests' and the references to
+	`gltests' in all files.
+
+	(All of this could be done with a script, but I hope that this is
+	eventually replaced with migrating groff as a whole to gnulib and
+	its setup).
+
+	. Call
+
+	    gnulib-tool --add-import \
+	                --dir=src/libs/gnulib \
+	                wcwidth
+
+	to update everything.
+
+	. Merge the changed, new, and deleted files into `gnulib.old',
+	delete `gnulib', rename `gnulib.old' to `gnulib', then commit.
+
+2012-12-28  Werner LEMBERG  <wl@gnu.org>
+
+	doc More documentation generation rules.
+
+	* doc/Makefile.in (.texinfo.txt): New rule.
+	(.texinfo.html): Use `LANG='.
+	(split-html): New target.
+
+2012-12-28  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/fixinfo.sh: Make it work with makinfo 4.13 also.
+
+2012-12-28  Werner LEMBERG  <wl@gnu.org>
+
+	Split ChangeLog.
+
+	* ChangeLog: Split off older entries into...
+	* ChangeLog.121: this new file.
+
+2012-12-28  Werner LEMBERG  <wl@gnu.org>
+
+Version 1.22 released
+=====================
+
+	* NEWS, VERSION, doc/groff.texinfo, doc/webpage.ms: Updated.
+
+	* config.guess, config.sub: Updated from `config' repository.
+
+	* INSTALL.gen: Updated from `gnulib' repository (file `INSTALL').
+
+	* aclocal.m4, configure: Regenerated.
+
+	* doc/texinfo.tex: Updated from `texinfo' repository.
+
+	* src/roff/groff/groff.cpp (main) <'v'>: Update copyright year.
+
+2012-12-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* man/groff_font.man: Typographical improvements and typos.
+
+2012-12-27  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* man/ditroff.man: Typographical improvements and typos.
+
+2012-12-18  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* man/groff_diff.man: Typographical improvements and typos.
+
+2012-12-16  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	* man/groff.man: Typographical improvements (and one typo).
+	* man/groff_char.man: Typographical improvements.
+
+2012-10-17  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* src/devices/gropdf/gropdf.pl (do_D): The command \D't N' moves
+	horizontal position by 'N'.  gropdf now obeys this rule.
+	(do_t): Fixed kerning issue where width of non-kerned text could
+	be wrongly calculated using previous kern factor.
+
+2012-09-21  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve documentation of `.ad'.
+
+2012-09-20  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/Makefile.sub (uninstall_sub): Fix removal of info files.
+
+2012-09-20  Werner LEMBERG  <wl@gnu.org>
+
+	Simplify environment handling.
+
+	Suggested by Ivan Shmakov <oneingray@gmail.com>.
+
+	* doc/Makefile.in, doc/Makefile.sub (GROFF): Don't use export.
+
+2012-09-20  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	gropdf Various minor fixes.
+
+	* font/devpdf/Foundry.in: Add font path to debian `gsfonts'
+	package.
+
+	* font/devpdf/util/BuildFoundries.pl: Handle missing fonts in a
+	more sane way, do NOT abort the complete make run!
+
+	* src/devices/gropdf/gropdf: Accept papersize names (i.e. A4) as
+	either upper or lower case.  The -p (papersize) option should be
+	length,width (currently reversed - width,length)
+
+	* src/devices/gropdf/pdfmom.pl: Support use of GROFF_BIN_PATH.
+
+2012-09-11  Ralph Corderoy  <ralph@inputplus.co.uk>
+	    Werner LEMBERG <wl@gnu.org>
+
+	* src/preproc/tbl/tbl.man: Better document `d' column specifier.
+
+2012-08-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	Add `pdfmom' to handle mom documents with gropdf.
+
+	* Makefile.in (OTHERDIRS): Move contrib/mom to be run after
+	devices/gropdf.
+
+	* src/devices/gropdf/gropdf.pl: Various fixes:
+
+	. Correct image scaling issue.
+	. Handle relative horizontal movement 'h' followed by absolute
+	vertical movement 'V'.
+	. Correct handling of track kerning.
+
+	* src/devices/gropdf/pdfmom.pl: New wrapper for mom (pdfmom)
+	using gropdf or grops driver.
+	* src/devices/gropdf/pdfmom.man: New man page.
+	* src/devices/gropdf/Makefile.sub: Updated to handle new files.
+
+2012-08-31  Deri James  <deri@chuzzlewit.myzen.co.uk>
+
+	* Makefile.in (OTHERDIRS): Move contrib/mom to be run after
+	devices/gropdf.
+
+	* src/devices/gropdf/gropdf.pl: Various fixes:
+
+	. Correct image scaling issue.
+	. Handle relative horizontal movement 'h' followed by absolute
+	    vertical movement 'V'.
+	. Correct handling of track kerning.
+
+	* src/devices/gropdf/pdfmom.pl: New wrapper for mom (pdfmom)
+	using gropdf or grops driver.
+	* src/devices/gropdf/pdfmom.man: New man page.
+	* src/devices/gropdf/Makefile.sub: Updated to handle new files.
+
+2012-08-31  Julien Moutinho  <julm+groff@autogeree.net>
+
+	* tmac/www.tmac (www-push-li): Fix indentation.
+
+	See
+
+	http://lists.gnu.org/archive/html/bug-groff/2012-08/msg00009.html
+
+	for the full report.
+
+2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+
+	TBLization, as discussed on the list.  There's a rewrite of
+	this file in planning, but this gets the content clean for now.
+
+	* tmac/groff_mdoc.man: In this file.
+
+2012-08-09  Werner LEMBERG  <wl@gnu.org>
+
+	Provide proper Unicode mapping from and to dotless j.
+
+	* src/libs/libgroff/glyphuni.cpp (glyph_to_unicode_list),
+	src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Add it.
+
+2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+
+	Added Unicode code point for dotless j.
+
+	* man/groff_char.man: In this file.
+
+2012-08-08  Werner LEMBERG  <wl@gnu.org>
+
+	* man/groff_char.man: Clean-ups.
+
+2012-08-08  Eric S. Raymond  <esr@thyrsus.com>
+
+	Elimination of nasty presentation-level macro tangles makes
+	structural translation to XML possible.
+
+	* man/groff_char.man: Clean up the mess, use real TBL tables.
+
+2012-07-23  Eric S. Raymond  <esr@thyrsus.com>
+
+	More elimination of low-level troff hackery in the documentation
+	so it can be lifted to structural markup.
+
+	* tmac/groff_me.man: Use TBL rather than wacky diversions and .ti
+	requests.
+
+2012-07-24  Werner LEMBERG  <wl@gnu.org>
+
+	Fix appearance of groff.texinfo's HTML output.
+
+	Cartouches within an `example' environment don't work.
+
+	* doc/groff.texinfo (CartoucheExample, endCartoucheExample): New
+	macros.  Use them where appropriate.
+
+2012-07-17  Ingo Schwarze  <schwarze@usta.de>
+
+	mdoc Make `Fl' correctly restore fonts.
+
+	* tmac/doc.tmac (doc-flag-recursion): Do it.
+
+2012-07-07  Eric S. Raymond  <esr@thyrsus.com>
+
+	* src/preproc/eqn/eqn.man, src/preproc/grn/grnn.man,
+	src/devices/grodvi/grodvi.man, src/devices/grolj4/grolj4.man,
+	src/devices/grops/grops.man, src/utils/lkbib/lkbib.man,
+	src/utils/indxbib/indxbib.man, src/utils/tfmtodit/tfmtodit.man,
+	src/utils/xtotroff/xtotroff.man:
+	Remove running text in the synopses of various manual pages,
+	as it badly screws up attempts to mechanically parse them.
+
+	* contrib/mom/groff_mom.man: Use .URL rather than .UR/.UE, as this
+	is now preferred for manual pages.
+
+2012-07-03  Werner LEMBERG  <wl@gnu.org>
+
+	Fix Unicode mapping of Greek stroked and curly phi.
+
+	Problem reported by Alkis Georgopoulos <alkisg@gmail.com>;
+	see
+
+	https://bugs.launchpad.net/ubuntu/+source/groff/+bug/1008115
+
+	* src/libs/libgroff/uniglyph.cpp (unicode_to_glyph_list): Flip
+	values of U+03C6 and U+03D5.
+
+2012-06-13  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	* src/devices/gropdf/gropdf.pl: When using variable page
+	sizes (with \X'papersize ...') ensure final page is correct
+	size.
+
+2012-05-24  Werner LEMBERG  <wl@gnu.org>
+
+	* src/roff/grog/grog.pl (process): Fix .so handling.
+
+	This does the same as the previous commit.
+
+2012-05-24  Denis M. Wilson  <dmw@oxytropis.plus.com>
+
+	* src/roff/grog/grog.sh: Fix .so handling.
+
+	See
+
+	http://lists.gnu.org/archive/html/bug-groff/2012-05/msg00000.html
+
+	for the report and the bug fix.
+
+2012-05-24  Ivan Shmakov  <oneingray@gmail.com>
+
+	Add some generic fallback characters.
+
+	* tmac/fallbacks.tmac: New file.
+	* tmac/troffrc: Include it.
+	* tmac/Makefile.sub (NORMALFILES): Include it.
+
+2012-05-20  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	* doc/groff.texinfo: Add extra info about `.asciify'.
+	Document new gropdf options -u and -s.
+
+	* src/devices/gropdf/gropdf.man: Remove references to Type 42
+	fonts, they do not work in PDFs.
+
+	Document new option -s which adds `statistics' line to end of PDF
+	file showing number of pages in document.  This has always been
+	the default behaviour (to add this line), all other software seems
+	to ignore it as intended, but `gs' sometimes complains, so the
+	default is now to omit the statistics.
+
+	Document new option -ucmapfilename to allow a user ToUnicode
+	CMap instead of gropdf's default.  If no `cmapfilename' given then
+	do not include any ToUnicode CMap.
+
+	* src/devices/gropdf/gropdf.pl <top>: Allow `bundled' flags on
+	command line (i.e. -de = -d -e).
+
+	Use $RT_SEP as multi path separator, not hard coded `:'.  Update
+	all users.
+
+	New flags -u and -s.  Once a custom papersize has been set as
+	\X'papersize x,y' make it sticky so all following pages use custom
+	size.  When importing pdf with \X'pdf: pdfpic ...' do not compress
+	objects which are already compressed! This caused problems with
+	PDFs created with ImageMagick, now fixed.
+
+	(IsText, PutLine, do_t): The troff `u' command can contain a
+	kerning adjustment number, this was not being handled, now fixed.
+
+	(do_c): The troff `c' command was not being handled correctly, now
+	fixed.
+	(FindChar, RemapChr, do_N): Handle fonts with more than 255 glyphs.
+	($ucmap): Define CMap ToUnicode to convert ligatures
+	(fl,fi,ff,ffl,ffi) back to individual characters, useful for
+	cut'n'paste and text searching.
+	(LoadFont): Handle it.
+	(ToPoints, GetPoints): Handle `z' unit.
+	(do_x, FixPDFColour, PutHotSpot): Allow Annotation colour to be
+	groff colour, i.e. 0-65535 *3, or #rrggbb, or #rrrrbbbbgggg.
+	(do_p):The papersize width/length in switch -p were reversed,
+	corrected.
+
+	* src/devices/gropdf/Makefile.sub (gropdf): Use $RT_SEP.
+	Use $fontpath rather than $fontdir (this ensures site-font is
+	included in searches).
+
+	* tmac/pdf.tmac (PDFBOOKMARK.VIEW, PDFHREF.VIEW, PDFPAGE.Y): Fix
+	strings.
+	(pdfbookmark): Correct handling of bookmark levels.
+	Convert \em to hyphen in bookmarks
+
+	Rather use -N than -T for "named" bookmarks (-T already used for
+	"tag" in pdfmark.tmac)
+
+	(.pdfclean): New macro which attempts to asciify bookmark text.
+	(.pdfpagename): New wrapper macro for \X'pdf: pagename'.
+	(.pdfswitchtopage): New wrapper macro for \X'pdf: switchtopage'.
+
+2012-03-10  Werner LEMBERG  <wl@gnu.org>
+
+	Fix compiler warnings.
+
+	* src/preproc/html/pre-html.cpp (alterDeviceTo): Avoid ambiguous
+	if-else clause.
+
+	* src/preproc/grn/main.cpp (sccsid): Comment out.
+
+	* src/roff/troff/number.cpp (parse_expr) <case '*'>: Add cast.
+
+	* src/devices/xditview/Makefile.sub (EXTRA_CFLAGS): Add `-Dlint'
+	so that unused static ID arrays don't cause a warning.
+
+	(Some) problems reported by Bjarni Ingi Gislason
+	<bjarniig@rhi.hi.is>.
+
+2012-03-05  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/an-ext.tmac (SY): Handle argument with spaces correctly.
+
+	Problem reported by Bjarni Ingi Gislason <bjarniig@rhi.hi.is>.
+
+2012-03-01  Bjarni Ingi Gislason  <bjarniig@rhi.hi.is>
+
+	an-old Fix warnings.
+
+	* tmac/an-old.tmac (an-init): Insert missing braces.
+
+2012-02-26  Werner LEMBERG  <wl@gnu.org>
+
+	Update configuration files from `gnulib' and `config' repositories.
+
+	This also fixes a problem with `iconv' on Solaris 10, as reported
+	in
+
+	http://lists.gnu.org/archive/html/bug-groff/2012-02/msg00007.html
+
+	* configure.ac: Call `gl_LOCALCHARSET.
+	Call `AM_ICONV' as C++.
+
+	* config.guess, config.rpath, config.sub, install-sh, mkinstalldir:
+	Updated.
+
+	* m4/codeset.m4, m4/glib21.m4, m4/iconv.m4, m4/lib-ld.m4,
+	m4/lib-link.m4, m4/lib-prefix.m4: Updated.
+	* m4/fcntl-o.m4, m4/localcharset.m4: New files.
+
+	* Makefile.in: Updated.
+
+	* src/include/localcharset.h, src/libs/libgroff/config.charset,
+	src/libs/libgroff/localcharset.c: Updated.
+
+	* aclocal.m4, configure, src/include/config.hin: Regenerated.
+
+2012-02-20  Werner LEMBERG  <wl@gnu.org>
+
+	Update `gnulib' files.
+
+	The invocation was
+
+	gnulib-tool --add-import \
+	              --dir=src/libs/gnulib \
+	              wcwidth
+
+	Additionally, src/libs/gnulib/configure.ac was adjusted from a
+	`test' run as described in the change from 2010-12-13.
+
+	* src/libs/gnulib/*: Updated.
+
+2012-02-15  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	gropdf Fixes and omissions.
+
+	* src/devices/gropdf/gropdf.pl (<top>, do_u): Add facility to
+	handle track kerning (.tkf).
+
+	(do_x, do_p, do_t): If pages are reordered using `pagename' and
+	`switchtopage' keep track of outline bookmarks.
+	(do_x): Handle multiple files on gropdf command line, stitch
+	multiple groff_out files together.  In the main read loop any argc
+	values not consumed by options are taken as input files and
+	processed in order.  What prevented it working properly before is
+	the way an `x i' (initialize) record has been handled.  It now
+	processes the initialization code only in the first file.
+
+	(PutHotSpot): Allow user to control size of hotspot bounding box
+	on clickable links by setting PDFHREF.LEADING
+
+	* tmac/pdf.tmac (PDFHREF.LEADING): Adjust value.
+	(pdf*href): Pass value of PDFHREF.LEADING to gropdf.
+
+2012-02-10  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	gropdf Fix compatibility issues with pdfmark.
+
+	* tmac/pdf.tmac (PDFHREF.VIEW.LEADING): Fix value.
+	(pdf:href.opt-X): Add check for -X option for .pdfhref.
+
+2012-02-08  Werner LEMBERG  <wl@gnu.org>
+
+	* src/preproc/pic/main.cpp (do_file): Check for invalid characters.
+
+	Problem reported by Doug McIlroy <doug@cs.dartmouth.edu>.
+
+2012-01-25  Ingo Schwarze  <schwarze@usta.de>
+
+	mdoc * tmac/doc-syms: Fix meaning of XBD acronym.
+
+2012-01-25  Tadziu Hoffmann  <hoffmann@usm.uni-muenchen.de>
+
+	* tmac/e.tmac (bl): Make it work inside blocks.
+
+	See threads starting with
+
+	http://lists.gnu.org/archive/html/groff/2011-12/msg00055.html
+	http://lists.gnu.org/archive/html/groff/2012-01/msg00000.html
+
+2012-01-10  Bruno Haible  <bruno@clisp.org>
+
+	Fix handling of MAKEFLAGS variable.
+
+	* Makefile.in (MAKE_K_FLAGS): Improved definition,
+	as explained and discussed in
+
+	http://lists.gnu.org/archive/html/groff/2012-01/msg00039.html
+
+2012-01-03  Ingo Schwarze  <schwarze@usta.de>
+
+	Improve parallel builds.
+
+	Some hdtbl and mom examples want PostScript formatting which
+	requires the `DESC' file to be ready; however, the top-level
+	`Makefile.in' doesn't currently enforce the proper order of
+	building of `font/dev' before `contrib/hdtbl', `contrib/mom', and
+	so on.
+
+	Given that `font/dev' and the contrib examples are in different
+	child processes of the recursive make system, it doesn't seem
+	possible to solve this using clean Makefile dependencies.  We now
+	enforce the order by splitting the shell command invoking
+	recursive make in the top level `Makefile.in'.
+
+	* Makefile.in (ALLDIRS): Remove `OTHERDIRS'.
+	(dodirs): Updated.
+	(`$(TARGETS)'): Handle `OTHERDIRS' separately.
+
+2012-01-03  Kristaps Dzonsons  <kristaps@bsd.lv>
+
+	mdoc Add `-isoC-2011'.
+
+	* tmac/doc-syms (doc-str-St--isoC-2011): Add it.
+	* tmac/groff_mdoc.man: Document it.
+
+2011-12-26  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	* font/devpdf/Makefile.sub: Only build fonts on first `make'.
+
+2011-12-08  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo (.tl): Improve documentation.
+	Wording suggested by Keith Marshall
+	<keithmarshall@users.sourceforge.net>.
+
+2011-12-01  Werner LEMBERG  <wl@gnu.org>
+
+	me Fix behaviour of centered block.
+	Problem and possible fix reported in thread starting at
+
+	http://lists.gnu.org/archive/html/groff/2011-11/msg00002.html
+
+	* tmac/e.tmac (`(c'): Always start with a new line.
+
+2011-12-01  Ingo Schwarze  <schwarze@usta.de>
+
+	man Print volume headers like mdoc.
+
+	* tmac/an-old.tmac (an-init): Add default volume name if fifth
+	argument to `.TH' is missing.
+
+2011-11-22  Werner LEMBERG  <wl@gnu.org>
+
+	* tmac/groff_man.man: Minor documentation improvements.
+	Suggested by Jeff Conrad <jeff_conrad@msn.com>.
+
+2011-11-14  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve doc for calling undefined identifiers.
+
+2011-11-14  Werner LEMBERG  <wl@gnu.org>
+
+	* src/preproc/tbl/tbl.man: Improve documentation of `_' and
+	friends.
+
+2011-10-31  Werner LEMBERG  <wl@gnu.org>
+
+	Fix compiler warnings.
+
+	* src/preproc/eqn/main.cpp (do_file), src/roff/troff/env.cpp
+	(environment::print_env), src/roff/troff/mtsm.cpp
+	(statem::display_state): Add syntactical sugar.
+
+	* src/utils/tfmtodit/tfmtodit.cpp (char_info_word): Use `unsigned
+	char' for all members.
+
+	* src/devices/grohtml/html-text.cpp (html_text::remove_def):
+	Remove unused variable `q'.
+
+	* src/devices/grohtml/post-html.cpp
+	(html_printer::lookahead_for_tables): Remove unused variable `left'
+	and `seen_text'.
+
+2011-10-23  Ingo Schwarze  <schwarze@openbsd.org>
+
+	mdoc Synchronize string tables with the mandoc(1) utility.
+
+	* tmac/doc-common: Add many architecture names used in NetBSD and
+	OpenBSD (and "arm" from FreeBSD) and remove the duplicate OS
+	version entry for Darwin-10.6.0.
+
+	* tmac/doc-syms: Add many library names used in NetBSD and FreeBSD.
+
+	* tmac/groff_mdoc.man: Document all supported architecture names)
+	(OS versions, and library names.
+
+2011-09-11  Joseph Koshy  <jkoshy@users.sourceforge.net>
+
+	mdoc Add some library strings.
+
+	* tmac/doc-syms: Add `libdwarf' and `libelf'.
+	* tmac/groff_mdoc.man: Document them.
+
+2011-08-14  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	gropdf More minor fixes.
+
+	* font/devpdf/Makefile.sub (MOSTLYCLEANADD): Don't attempt to
+	install 'util/BuildFoundries', only used in 'make'.
+
+	* src/devices/gropdf/gropdf.pl (<top>, GetType1): Make STDOUT and
+	any font files read to be accessed in binary rather than text mode.
+	Prevents errors when running on systems set up for UTF-8.
+
+2011-08-10  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	gropdf Minor updates and fixes.
+
+	* src/devices/gropdf/gropdf.pl: Change command line option `-fy'
+	to `-y' for consistency.
+
+	Better support for Windows platform.
+	(do_x): Handle keywords `pagename' and `switchtopage'.
+
+	* doc/groff.texinfo, src/devices/gropdf/gropdf.man: Updated.
+
+	* font/devpdf/Foundry: Renamed to...
+	* font/devpdf/Foundry.in: This.
+	Add default alias font names.
+
+	* font/devpdf/util/BuildFoundries.pl: This is now an installation
+	helper script and gets not longer installed.
+	Support alternative font file names (separated with `!').
+
+	* font/devpdf/Makefile.sub: Fixes to work with a separate build
+	directory.
+	Font files are now build at `make' time; this makes `test-groff'
+	work with -Tpdf.
+
+	* font/devpdf/util/Makefile.sub: Removed.
+
+	* Makefile.in (DEVDIRS, OTHERDIRS, EXTRADIRS): Handle devpdf
+	specially.
+
+2011-07-29  Daiki Ueno  <ueno@unixuser.org>
+
+	Fix cross building.  Problem reported by Christophe Jarry
+	<christophe.jarry@ouvaton.org>.
+
+	* Makefile.in ($GNULIBDIRS): Pass original config arguments to
+	src/libs/gnulib/configure.
+
+2011-06-25  Deri James  <deri@chuzzlewit.demon.co.uk>
+
+	Add new output device `gropdf'.
+
+	* font/devpdf/*: New device files for gropdf.
+	* src/devices/gropdf/*: New device.
+
+	* Makefile.comm (install_dev, uninstall_dev): Handle more
+	subdirectories.
+	* Makefile.in (DEVDIRS, OTHERDIRS, EXTRADIRS): Add directories
+	related to gropdf.
+	* MANIFEST: Updated.
+	* test-groff.in (GROFF_BIN_PATH): Updated.
+
+	* tmac/Makefile.sub (NORMALFILES): Updated.
+	* tmac/pdf.tmac: New file.
+	* tmac/troffrc: Updated.
+
+	* doc/groff.texinfo: Document it.
+	* doc/Makefile.in, doc/Makefile.sub (groff_bin_dirs): Updated.
+	* doc/pic.ms: Updated.
+
+	* man/groff_out.man, src/devices/grops/grops.man,
+	src/preproc/pic/pic.man, src/roff/groff/groff.man,
+	src/utils/afmtodit/afmtodit.man, src/utils/pfbtops/pfbtops.man:
+	Updated.
+
+	* contrib/pdfmark/pdfmark.ms: Updated.
+
+2011-07-20  George HELFFRICH  <ghfbsd@gmail.com>
+
+	Improve line numbering support in tbl and with me macros.
+
+	* tmac/e.tmac (n1, n2, TH, PS): Implement it.
+	(@h, @n, @o, @t, @k, )b, (c, (q, )q, (l, )l, (f, @q, PE): Updated.
+	* doc/meref.me: Document changes.
+
+	* src/preproc/tbl/table.cpp (ROW_START_LINE_REG)
+	(ROW_SAVE_LINE_REG, ROW_MAX_LINE_REG, REPEATED_NM_SET_MACRO)
+	(REPEATED_NM_SUS_MACRO): New macros.
+
+	(table::init_output): Define REPEATED_NM_SET_MACRO and
+	REPEATED_NM_SUS_MACRO.
+	(table::print_single_hline, table::print_double_hline,
+	table::define_bottom_macro, table::do_row, table::do_top,
+	table::do_bottom): Updated.
+
+	* doc/webpage.ms: Updated.
+
+2011-07-12  Ted Harding  <ted.harding@wlandres.net>
+	    Werner LEMBERG <wl@gnu.org>
+
+	* src/preproc/tbl/tbl.man: Mention trick to get abutting rules.
+
+2011-07-03  Ben Laurie  <benl@FreeBSD.org>
+
+	Fix clang warnings.
+
+	* src/libs/libdriver/input.cpp (odd): Use parentheses.
+
+	* src/roff/troff/mtsm.cpp (state_set::is_in): Fix parentheses;
+	previous code always tested for bit 0.
+
+2011-07-03  Guillem Jover  <guillem@debian.org>
+
+	mdoc: Update more OS versions strings.
+
+	* tmac/doc-common: Add versions strings for NetBSD, OpenBSD,
+	FreeBSD, and DragonFly.
+
+2011-04-08  Michail Vidiassov  <master@iaas.msu.ru>
+
+	mdoc: Update various strings related to Mac OS X and FreeBSD.
+
+	* tmac/doc-common: Add strings for FreeBSD 8.2 and Darwin 9.7-11.0.
+	* tmac/doc-syms: Add strings -lbsm and -lSystem.
+
+2011-03-29  Christian Weisgerber  <naddy@mips.inka.de>
+
+	Fix compilation issues with gcc 2.95.
+
+	* src/roff/troff/input.cpp (my_input_iterator): Define as an alias
+	for `input_iterator' which is predefined by an old libstdc++.
+
+2011-03-29  Ingo Schwarze  <schwarze@usta.de>
+
+	Add another POSIX standard.
+
+	* tmac/doc-syms: Add POSIX 1003.1b.
+
+2011-03-29  Christian Weisgerber  <naddy@mips.inka.de>
+
+	Fix build with non-GNU make.
+
+	* Makefile.in ($TARGETS): We must not pass `$MDEFINES' recursively
+	down to the sub-makes started in src/libs/gnulib, because that
+	directory has its own values for `$top_srcdir' etc., and
+	overriding those from the command line will cause the build to
+	fail.  Currently, `$MAKEOVERRIDES' will prevent the recursive
+	passing of those overrides with GNU make, but not with other
+	make(1) implementations.  It looks like all targets that require
+	`$MDEFINES' set them explicitly anyway, so we shouldn't need to
+	set `$MDEFINES' on the top level.
+
+2011-03-21  Jan Vcelak  <jvcelak@redhat.com>
+	    Bernd Warken <groff-bernd.warken-72@web.de>
+
+	groffer Remove hardcoded path to 'libdir/groff/groffer'
+	directory.
+
+	* configure.ac: add GROFFERDIR variables.
+
+	* Makefile.in: add and handle variable groffer_dir
+
+	* m4/groff.m4: set up the --with-grofferdir command line option.
+
+2011-03-18  Werner LEMBERG  <wl@gnu.org>
+
+	troff Improve error message.
+
+	* src/roff/troff/input.cc (token::delimiter): Improve error
+	message.  Suggested by Doug McIlroy <doug@cs.dartmouth.edu>.
+
+2011-03-04  Werner LEMBERG  <wl@gnu.org>
+
+	mdoc Within .An, .Aq, .Ao, and .Ac now use `<' and `>'.
+	Problem reported by Ulrich Spörlein <uqs@spoerlein.net>
+
+	* tmac/doc.tmac (Aq, Ao, Ac): Implement it to follow RFC 822 and
+	RFC 2822.
+
+2011-02-14  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Add another example for .em request
+	Based on a patch from Anton Shepelev <anton.txt@gmail.com>.
+
+2011-01-31  Werner LEMBERG  <wl@gnu.org>
+
+	More fixes for Savannah bug #32301.
+
+	* src/devices/grops/Makefile.sub (XLIBS),
+	src/devices/grodvi/Makefile.sub, src/devices/grolj4/Makefile.sub,
+	src/devices/grohtml/Makefile.sub, src/devices/grolbp/Makefile.sub:
+	Add $(LIBGNU).
+
+2011-01-31  Werner LEMBERG  <wl@gnu.org>
+
+	Fix Savannah bug #32301.
+
+	* src/roff/groff/Makefile.sub (XLIBS),
+	src/preproc/grn/Makefile.sub, src/preproc/html/Makefile.sub: Add
+	$(LIBGNU).
+
+2011-01-29  Krzysztof Żelechowski  <giecrilj@stegny.2a.pl>
+
+	* doc/groff.texinfo: Complete documentation on output devices.
+
+2011-01-28  Werner LEMBERG  <wl@gnu.org>
+
+	Handle `refer*.tmac'.
+
+	* tmac/Makefile.sub (NORMALFILES): Add `refer*.tmac'.
+	* tmac/refer-mm.tmac: Moved to contrib/mm.
+
+2011-01-28  Werner LEMBERG  <wl@gnu.org>
+
+	Improve `refer' support of -me.
+
+	* tmac/refer.tmac, tmac/refer-me.tmac, tmac/refer-ms.tmac,
+	tmac/refer-mm.tmac: New files.  The code in refer.tmac is
+	based on the old code from `s.tmac'.
+
+	* tmac/s.tmac: Remove direct refer support and include
+	`refer-ms.tmac' instead.
+	* tmac/e.tmac: Remove direct refer support and include
+	`refer-me.tmac' instead.
+
+	* NEWS: Updated.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	groff.texinfo: Updates.
+
+	* doc/groff.texinfo: Document groff's `-j' option.
+	Add dummy section for `chem' preprocessor.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	Update `grog'.
+
+	* src/roff/grog/{groff.sh,groff.pl}: `groff' now calls `pic'
+	automatically if `grap' or `chem' is used.
+	`chem' has been folded into `groff'.
+	* src/roff/grog/grog.man: Updated.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	Make `groff -G' imply `-p'.
+
+	* src/roff/groff/groff.cpp (main): Implement it.
+	* src/roff/groff/groff.man: Updated.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	Integrate `chem' into `groff' (new option -j).
+
+	* src/roff/groff/groff.cpp (CHEM_INDEX): New constant.
+	(main) 'j': Add `chem'.
+	(synopsis, help): Updated.
+	* src/roff/troff/pipeline.h (MAX_COMMANDS): Increase to 14.
+
+	* src/roff/groff/groff.man: Document new command line option.
+	* NEWS: Updated.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: `chem' is now part of groff.
+
+2011-01-22  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/groff.texinfo: Improve description of `.de'.
+
+	Based on suggestions by Ted Harding and Deri James.
+
+2011-01-20  Colin Watson  <cjwatson@debian.org>
+
+	Fix handling of wide characters in no-SGR mode.
+
+	* src/devices/grotty/tty.cpp (tty_printer::make_underline): Only
+	emit a single backspace in no-SGR mode.  less (at least)
+	backspaces over a character at a time.
+	(tty_printer::make_bold): Likewise.
+
+2011-01-19  Werner LEMBERG  <wl@gnu.org>
+
+	* src/preproc/pic/pic.man: Add pic manual to `SEE ALSO' section.
+
+2011-01-14  Werner LEMBERG  <wl@gnu.org>
+
+	Split ChangeLog.
+
+	* ChangeLog: Split off older entries into...
+	* ChangeLog.119, ChangeLog.120: these new files.
+
+2011-01-15  Colin Watson  <cjwatson@debian.org>
+
+	* Makefile.comm (INCLUDES): Fix typo.
+
+2011-01-05  Werner LEMBERG  <wl@gnu.org>
+
+	* doc/webpage.ms: Fix rendering of title image.
+
+
+________________________________________________________________________
+
+##### License
+
+Copyright 2011-2018 Free Software Foundation, Inc.
+
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.
+
+
+##### Editor settings
+Local Variables:
+fill-column: 72
+mode: change-log
+version-control: never
+End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/FOR-RELEASE -> _service:tar_scm:groff-1.23.0.tar.gz/FOR-RELEASE Changed

@@ -1,13 +1,58 @@
-    Copyright 2013-2018 Free Software Foundation, Inc.
+    Copyright 2013-2022 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-This file describes how to prepare `groff' for a new release.
+This file describes how to prepare 'groff' for a new release.
 
 
 ########################################################################
 
-The file `INSTALL.gen' shall *never* be changed manually!  It is a
-generic file provided from GNU (normally called `INSTALL').
+* Update font description files that we generate from external data and
+  provide with our source distribution.
+
+    Directory  Format                  Tool
+    ---------  ------                  ----
+    devX*      X11 core/server font    xtotroff
+
+  The make(1) target "maintainer-font-descriptions" produces these font
+  descriptions.
+
+* Retrieve current versions of UnicodeData.txt1 and the Adobe Glyph
+  List (AGL)2, and use them with
+  src/utils/afmtodit/make-afmtodit-tables to update
+  src/utils/afmtodit/afmtodit.tables.
+
+  1 E.g., <https://www.unicode.org/Public/15.0.0/ucd/UnicodeData.txt>.
+      Check for the latest _released_ version of Unicode at the time.
+      Data for the forthcoming release may be available.
+  2 <https://github.com/adobe-type-tools/agl-aglfn/blob/master/\
+      glyphlist.txt>
+
+     (<https://raw.githubusercontent.com/adobe-type-tools/agl-aglfn/\
+     master/glyphlist.txt> may be more convenient.)
+
+* Update the 'gnulib' sub-module to the latest version and the
+  corresponding required commit hash identifier in 'INSTALL.REPO'.
+
+* Update the release version number where it is hard-coded.
+  + NEWS
+  + BUG-REPORT
+  + arch/mingw/grap2graph.cmd
+  + doc/groff.texi (multiple occurrences)
+  + doc/webpage.ms
+
+* If the major or minor version number is being incremented, split off
+  a historical ChangeLog file and add it to `EXTRA_DIST` in Makefile.am.
+
+* Update in 'src/roff/groff/groff.cpp' the 'printf' that displays the
+  copyright.
+
+* Update the copyright year with 'update-copyright.sh'.
+
+* Increment the version number by tagging the release, beta, or release
+  candidate.  groff requires an explicit three-part version,
+  major.minor.revision, due to the .Y register.
+
+    $ git tag 1.23.0.rc1

_service:tar_scm:groff-1.23.0.tar.gz/HACKING Added

@@ -0,0 +1,178 @@
+    Copyright 2022-2023 Free Software Foundation, Inc.
+
+    Copying and distribution of this file, with or without
+    modification, are permitted in any medium without royalty provided
+    the copyright notice and this notice are preserved.
+
+This file contains advice on developing and contributing to groff.  It
+assumes that developers will install the 'git' revision control
+system and build groff using the instructions in 'INSTALL.repo'.
+Familiarize yourself with the structure of the source tree by studying
+its 'MANIFEST' file at the top level.
+
+Implementation languages
+------------------------
+
+Beyond what is said under "Dependencies" in 'INSTALL.extra',
+contributors should note that due to the age of the code base, much of
+the C++ dialect employed by groff components, while standard, is older
+than C++98--closer to Annotated Reference Manual C++ (Ellis, Stroustrup;
+Addison-Wesley, 1990).  groff implements its own string class and the
+Standard Template Library is little used.  A modest effort is underway
+to update the code to more idiomatic C++98.  Where a C++11 feature
+promises to be advantageous, it may be annotated in a code comment.
+
+
+Automake
+--------
+
+A document explaining the basics of GNU Automake and its usage in groff
+is available in 'doc/automake.mom'; peruse a PDF rendering in
+'doc/automake.pdf' in your build tree.
+
+
+Testing
+-------
+
+Running the test suite with 'make check' after building any substantive
+change to groff logic is encouraged.  You should certainly do so, and
+confirm that the tests pass, before submitting patches to the groff
+mailing list <groff@gnu.org> or Savannah issue tracker.
+
+If you find a defect in a test script, that can be reported via Savannah
+like any other bug.
+
+
+Documenting changes
+-------------------
+
+The groff project has a long history and a large, varied audience.
+Changes may need to be documented in up to three places depending on
+their impact.
+
+1.  Changes should of course be documented in the Git commit message.
+    If a change alters only comments or formatting of source code, or
+    makes editorial changes to documentation, and does not resolve a
+    Savannah ticket, you can stop at that.
+
+2.  The 'ChangeLog' file follows the format and practices documented in
+    the GNU Coding Standards.
+      https://www.gnu.org/prep/standards/html_node/Change-Logs.html
+
+    The sub-projects in the 'contrib' directory each have their own
+    dedicated ChangeLog files.  The file specifications documented there
+    are relative to the sub-project, not the root of the groff source
+    tree.  When converted to a commit message, add 'contrib/$SUBPROJECT'
+    to the entries.
+
+    Apart from 'contrib', groff uses a single (current) 'ChangeLog' file
+    for the rest of its source tree.
+
+    It is convenient to write the ChangeLog entry or entries first, then
+    construct a commit message from it (or them).
+
+3.  The 'NEWS' file documents changes to groff that a user, not just a
+    developer, would notice, not including the resolution of defects.
+
+    As a hypothetical example, correcting a rendering error in tbl(1)
+    such that any table with more than 20 rows no longer had the text
+    "FOOBAR" spuriously added to some entries would not be a 'NEWS'
+    item, because the appearance of such text in the first place is a
+    surprising deviation from tbl's ideal and historical behavior.  In
+    contrast, adding a command-line option to tbl, or changing the
+    meaning of its "expand" region option such that it no longer
+    horizontally compresses tables as well, _would_ be 'NEWS'-worthy.
+
+
+Writing Tests
+-------------
+
+Here are some portability notes on writing automated tests.
+
+* Write to the POSIX standard for the shell and utilities where
+  possible.  Issue 4 from 1994 is old enough that no contemporary system
+  has a good reason for not conforming.  A copy of the standard is
+  available at the Open Group's web site.
+    https://pubs.opengroup.org/onlinepubs/009656399/toc.pdf
+
+* The GNU coreutils "seq" command is handy but not standardized by
+  POSIX.  Replace it with a while loop.
+
+    # emulate "seq 53"
+    n=1; while  $n -le 53 ; do echo $n; n=$(( n + 1 )); done; unset n
+
+* The "od" command on macOS can put extra space characters (i.e., spaces
+  that don't correspond to the input) at the ends of lines when using
+  the "od -t c" format; GNU od does not.
+
+  So a regex like this that works with GNU od:
+    grep -Eqx '0000000 +A +\\b +B +\\b +C       D +\\n'
+  might need to be weakened to the following on macOS.
+    grep -Eqx '0000000 +A +\\b +B +\\b +C       D +\\n *'
+
+* The "od" command on macOS does not respect the environment variable
+  assignment "LC_ALL=C" when processing byte values 127<x<256 decimal
+  and using the "character" output format (option "-t c").  An
+  alternative output must be used, like bytewise octal (option "-t o1").
+  (macOS od may be non-conforming here, despite the claim of its man
+  page.  POSIX Issue 4 od's description says "The type specifier
+  character c specifies that bytes will be interpreted as characters
+  specified by the current setting of the LC_CTYPE locale category. ...
+  Other non-printable characters will be written as one three-digit
+  octal number for each byte in the character." (p. 538)  The language
+  in Issue 7 (2018) appears unchanged.
+    https://pubs.opengroup.org/onlinepubs/9699919799/utilities/od.html )
+
+* macOS sed requires semicolons after commands even if they are followed
+  immediately by a closing brace.
+
+  Rewrite
+    sed -n '/Foo\./{n;s/^$/FAILURE/;p}'
+  as follows.
+    sed -n '/Foo\./{n;s/^$/FAILURE/;p;}'
+
+  But see below regarding the opening braces.
+
+* POSIX doesn't say that sed has to accept semicolons as command
+  separators after label (':') and branch ('t') commands, or after brace
+  commands, so macOS sed doesn't.  GNU sed does.
+
+  So rewrite tidy, compact sed scripts like this:
+    sed -n '/Foo\./{n;s/^$/FAILURE/;tA;s/.*/SUCCESS/;:A;p}'
+  as this more cumbersome alternative.
+    sed -n \
+      -e '/Foo\./{n;s/^$/FAILURE/;tA;' \
+      -e 's/.*/SUCCESS/;:A;' \
+      -e 'p;}')
+
+  But see below regarding the opening braces.
+
+  Similarly, a brace sequence like that in this partial sed script:
+    /f1/p}}}}}}
+  must be rewritten as follows (or with '-e' expressions).
+    /f1/p;}
+    }
+    }
+    }
+    }
+    }
+
+* macOS and GNU sed don't require newlines (or '-e' expression endings)
+  after _opening_ braces, but Solaris 11 sed does.
+
+  So the sed script
+    /i/{N;/Table of Contents/{N;/Foo. . *1/p;};}
+  must be rewritten as follows (or with '-e' expressions).
+    /i/{
+    N;/Table of Contents/{
+    N;/Foo. . *1/p;
+    };
+    }
+
+
+##### Editor settings
+Local Variables:
+fill-column: 72
+mode: text
+End:
+vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/INSTALL -> _service:tar_scm:groff-1.23.0.tar.gz/INSTALL Changed

@@ -1,7 +1,7 @@
 Installation Instructions
 *************************
 
-   Copyright (C) 1994-1996, 1999-2002, 2004-2016 Free Software
+   Copyright © 1994–1996, 1999–2002, 2004–2017, 2020–2023 Free Software
 Foundation, Inc.
 
    Copying and distribution of this file, with or without modification,
@@ -12,94 +12,94 @@
 Basic Installation
 ==================
 
-   Briefly, the shell command './configure && make && make install'
+   Briefly, the shell command ‘./configure && make && make install’
 should configure, build, and install this package.  The following
-more-detailed instructions are generic; see the 'README' file for
+more-detailed instructions are generic; see the ‘README’ file for
 instructions specific to this package.  Some packages provide this
-'INSTALL' file but do not implement all of the features documented
+‘INSTALL’ file but do not implement all of the features documented
 below.  The lack of an optional feature in a given package is not
 necessarily a bug.  More recommendations for GNU packages can be found
 in *note Makefile Conventions: (standards)Makefile Conventions.
 
-   The 'configure' shell script attempts to guess correct values for
+   The ‘configure’ shell script attempts to guess correct values for
 various system-dependent variables used during compilation.  It uses
-those values to create a 'Makefile' in each directory of the package.
-It may also create one or more '.h' files containing system-dependent
-definitions.  Finally, it creates a shell script 'config.status' that
+those values to create a ‘Makefile’ in each directory of the package.
+It may also create one or more ‘.h’ files containing system-dependent
+definitions.  Finally, it creates a shell script ‘config.status’ that
 you can run in the future to recreate the current configuration, and a
-file 'config.log' containing compiler output (useful mainly for
-debugging 'configure').
+file ‘config.log’ containing compiler output (useful mainly for
+debugging ‘configure’).
 
-   It can also use an optional file (typically called 'config.cache' and
-enabled with '--cache-file=config.cache' or simply '-C') that saves the
+   It can also use an optional file (typically called ‘config.cache’ and
+enabled with ‘--cache-file=config.cache’ or simply ‘-C’) that saves the
 results of its tests to speed up reconfiguring.  Caching is disabled by
 default to prevent problems with accidental use of stale cache files.
 
    If you need to do unusual things to compile the package, please try
-to figure out how 'configure' could check whether to do them, and mail
-diffs or instructions to the address given in the 'README' so they can
+to figure out how ‘configure’ could check whether to do them, and mail
+diffs or instructions to the address given in the ‘README’ so they can
 be considered for the next release.  If you are using the cache, and at
-some point 'config.cache' contains results you don't want to keep, you
+some point ‘config.cache’ contains results you don’t want to keep, you
 may remove or edit it.
 
-   The file 'configure.ac' (or 'configure.in') is used to create
-'configure' by a program called 'autoconf'.  You need 'configure.ac' if
-you want to change it or regenerate 'configure' using a newer version of
-'autoconf'.
+   The file ‘configure.ac’ (or ‘configure.in’) is used to create
+‘configure’ by a program called ‘autoconf’.  You need ‘configure.ac’ if
+you want to change it or regenerate ‘configure’ using a newer version of
+‘autoconf’.
 
    The simplest way to compile this package is:
 
-  1. 'cd' to the directory containing the package's source code and type
-     './configure' to configure the package for your system.
+  1. ‘cd’ to the directory containing the package’s source code and type
+     ‘./configure’ to configure the package for your system.
 
-     Running 'configure' might take a while.  While running, it prints
+     Running ‘configure’ might take a while.  While running, it prints
      some messages telling which features it is checking for.
 
-  2. Type 'make' to compile the package.
+  2. Type ‘make’ to compile the package.
 
-  3. Optionally, type 'make check' to run any self-tests that come with
+  3. Optionally, type ‘make check’ to run any self-tests that come with
      the package, generally using the just-built uninstalled binaries.
 
-  4. Type 'make install' to install the programs and any data files and
+  4. Type ‘make install’ to install the programs and any data files and
      documentation.  When installing into a prefix owned by root, it is
      recommended that the package be configured and built as a regular
-     user, and only the 'make install' phase executed with root
+     user, and only the ‘make install’ phase executed with root
      privileges.
 
-  5. Optionally, type 'make installcheck' to repeat any self-tests, but
+  5. Optionally, type ‘make installcheck’ to repeat any self-tests, but
      this time using the binaries in their final installed location.
      This target does not install anything.  Running this target as a
-     regular user, particularly if the prior 'make install' required
+     regular user, particularly if the prior ‘make install’ required
      root privileges, verifies that the installation completed
      correctly.
 
   6. You can remove the program binaries and object files from the
-     source code directory by typing 'make clean'.  To also remove the
-     files that 'configure' created (so you can compile the package for
-     a different kind of computer), type 'make distclean'.  There is
-     also a 'make maintainer-clean' target, but that is intended mainly
-     for the package's developers.  If you use it, you may have to get
+     source code directory by typing ‘make clean’.  To also remove the
+     files that ‘configure’ created (so you can compile the package for
+     a different kind of computer), type ‘make distclean’.  There is
+     also a ‘make maintainer-clean’ target, but that is intended mainly
+     for the package’s developers.  If you use it, you may have to get
      all sorts of other programs in order to regenerate files that came
      with the distribution.
 
-  7. Often, you can also type 'make uninstall' to remove the installed
+  7. Often, you can also type ‘make uninstall’ to remove the installed
      files again.  In practice, not all packages have tested that
      uninstallation works correctly, even though it is required by the
      GNU Coding Standards.
 
-  8. Some packages, particularly those that use Automake, provide 'make
-     distcheck', which can by used by developers to test that all other
-     targets like 'make install' and 'make uninstall' work correctly.
+  8. Some packages, particularly those that use Automake, provide ‘make
+     distcheck’, which can by used by developers to test that all other
+     targets like ‘make install’ and ‘make uninstall’ work correctly.
      This target is generally not run by end users.
 
 Compilers and Options
 =====================
 
    Some systems require unusual options for compilation or linking that
-the 'configure' script does not know about.  Run './configure --help'
+the ‘configure’ script does not know about.  Run ‘./configure --help’
 for details on some of the pertinent environment variables.
 
-   You can give 'configure' initial values for configuration parameters
+   You can give ‘configure’ initial values for configuration parameters
 by setting variables in the command line or in the environment.  Here is
 an example:
 
@@ -112,21 +112,21 @@
 
    You can compile the package for more than one kind of computer at the
 same time, by placing the object files for each architecture in their
-own directory.  To do this, you can use GNU 'make'.  'cd' to the
+own directory.  To do this, you can use GNU ‘make’.  ‘cd’ to the
 directory where you want the object files and executables to go and run
-the 'configure' script.  'configure' automatically checks for the source
-code in the directory that 'configure' is in and in '..'.  This is known
-as a "VPATH" build.
+the ‘configure’ script.  ‘configure’ automatically checks for the source
+code in the directory that ‘configure’ is in and in ‘..’.  This is known
+as a “VPATH” build.
 
-   With a non-GNU 'make', it is safer to compile the package for one
+   With a non-GNU ‘make’, it is safer to compile the package for one
 architecture at a time in the source code directory.  After you have
-installed the package for one architecture, use 'make distclean' before
+installed the package for one architecture, use ‘make distclean’ before
 reconfiguring for another architecture.
 
    On MacOS X 10.5 and later systems, you can create libraries and
-executables that work on multiple system types--known as "fat" or
-"universal" binaries--by specifying multiple '-arch' options to the
-compiler but only a single '-arch' option to the preprocessor.  Like
+executables that work on multiple system types—known as “fat” or
+“universal” binaries—by specifying multiple ‘-arch’ options to the
+compiler but only a single ‘-arch’ option to the preprocessor.  Like
 this:
 
      ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
@@ -135,43 +135,43 @@
 
    This is not guaranteed to produce working output in all cases, you
 may have to build one architecture at a time and combine the results
-using the 'lipo' tool if you have problems.
+using the ‘lipo’ tool if you have problems.
 
 Installation Names
 ==================
 
-   By default, 'make install' installs the package's commands under
-'/usr/local/bin', include files under '/usr/local/include', etc.  You
-can specify an installation prefix other than '/usr/local' by giving
-'configure' the option '--prefix=PREFIX', where PREFIX must be an
+   By default, ‘make install’ installs the package’s commands under
+‘/usr/local/bin’, include files under ‘/usr/local/include’, etc.  You
+can specify an installation prefix other than ‘/usr/local’ by giving
+‘configure’ the option ‘--prefix=PREFIX’, where PREFIX must be an
 absolute file name.
 
    You can specify separate installation prefixes for
 architecture-specific files and architecture-independent files.  If you
-pass the option '--exec-prefix=PREFIX' to 'configure', the package uses
+pass the option ‘--exec-prefix=PREFIX’ to ‘configure’, the package uses
 PREFIX as the prefix for installing programs and libraries.
 Documentation and other data files still use the regular prefix.
 
    In addition, if you use an unusual directory layout you can give
-options like '--bindir=DIR' to specify different values for particular
-kinds of files.  Run 'configure --help' for a list of the directories
+options like ‘--bindir=DIR’ to specify different values for particular
+kinds of files.  Run ‘configure --help’ for a list of the directories
 you can set and what kinds of files go in them.  In general, the default
-for these options is expressed in terms of '${prefix}', so that
-specifying just '--prefix' will affect all of the other directory
+for these options is expressed in terms of ‘${prefix}’, so that
+specifying just ‘--prefix’ will affect all of the other directory
 specifications that were not explicitly provided.
 
    The most portable way to affect installation locations is to pass the
-correct locations to 'configure'; however, many packages provide one or
+correct locations to ‘configure’; however, many packages provide one or
 both of the following shortcuts of passing variable assignments to the
-'make install' command line to change installation locations without
+‘make install’ command line to change installation locations without
 having to reconfigure or recompile.
 
    The first method involves providing an override variable for each
-affected directory.  For example, 'make install
-prefix=/alternate/directory' will choose an alternate location for all
+affected directory.  For example, ‘make install
+prefix=/alternate/directory’ will choose an alternate location for all
 directory configuration variables that were expressed in terms of
-'${prefix}'.  Any directories that were specified during 'configure',
-but not in terms of '${prefix}', must each be overridden at install time
+‘${prefix}’.  Any directories that were specified during ‘configure’,
+but not in terms of ‘${prefix}’, must each be overridden at install time
 for the entire installation to be relocated.  The approach of makefile
 variable overrides for each directory variable is required by the GNU
 Coding Standards, and ideally causes no recompilation.  However, some
@@ -179,40 +179,40 @@
 that end up requiring recompilation when using this method, particularly
 noticeable in packages that use GNU Libtool.
 
-   The second method involves providing the 'DESTDIR' variable.  For
-example, 'make install DESTDIR=/alternate/directory' will prepend
-'/alternate/directory' before all installation names.  The approach of
-'DESTDIR' overrides is not required by the GNU Coding Standards, and
+   The second method involves providing the ‘DESTDIR’ variable.  For
+example, ‘make install DESTDIR=/alternate/directory’ will prepend
+‘/alternate/directory’ before all installation names.  The approach of
+‘DESTDIR’ overrides is not required by the GNU Coding Standards, and
 does not work on platforms that have drive letters.  On the other hand,
 it does better at avoiding recompilation issues, and works well even
-when some directory options were not specified in terms of '${prefix}'
-at 'configure' time.
+when some directory options were not specified in terms of ‘${prefix}’
+at ‘configure’ time.
 
 Optional Features
 =================
 
    If the package supports it, you can cause programs to be installed
-with an extra prefix or suffix on their names by giving 'configure' the
-option '--program-prefix=PREFIX' or '--program-suffix=SUFFIX'.
-
-   Some packages pay attention to '--enable-FEATURE' options to
-'configure', where FEATURE indicates an optional part of the package.
-They may also pay attention to '--with-PACKAGE' options, where PACKAGE
-is something like 'gnu-as' or 'x' (for the X Window System).  The
-'README' should mention any '--enable-' and '--with-' options that the
+with an extra prefix or suffix on their names by giving ‘configure’ the
+option ‘--program-prefix=PREFIX’ or ‘--program-suffix=SUFFIX’.
+
+   Some packages pay attention to ‘--enable-FEATURE’ options to
+‘configure’, where FEATURE indicates an optional part of the package.
+They may also pay attention to ‘--with-PACKAGE’ options, where PACKAGE
+is something like ‘gnu-as’ or ‘x’ (for the X Window System).  The
+‘README’ should mention any ‘--enable-’ and ‘--with-’ options that the
 package recognizes.
 
-   For packages that use the X Window System, 'configure' can usually
-find the X include and library files automatically, but if it doesn't,
-you can use the 'configure' options '--x-includes=DIR' and
-'--x-libraries=DIR' to specify their locations.
+   For packages that use the X Window System, ‘configure’ can usually
+find the X include and library files automatically, but if it doesn’t,
+you can use the ‘configure’ options ‘--x-includes=DIR’ and
+‘--x-libraries=DIR’ to specify their locations.
 
    Some packages offer the ability to configure how verbose the
-execution of 'make' will be.  For these packages, running './configure
---enable-silent-rules' sets the default to minimal output, which can be
-overridden with 'make V=1'; while running './configure
---disable-silent-rules' sets the default to verbose, which can be
-overridden with 'make V=0'.
+execution of ‘make’ will be.  For these packages, running ‘./configure
+--enable-silent-rules’ sets the default to minimal output, which can be
+overridden with ‘make V=1’; while running ‘./configure
+--disable-silent-rules’ sets the default to verbose, which can be
+overridden with ‘make V=0’.
 
 Particular systems
 ==================
@@ -223,43 +223,43 @@
 
      ./configure CC="cc -Ae -D_XOPEN_SOURCE=500"
 
-and if that doesn't work, install pre-built binaries of GCC for HP-UX.
+and if that doesn’t work, install pre-built binaries of GCC for HP-UX.
 
-   HP-UX 'make' updates targets which have the same time stamps as their
+   HP-UX ‘make’ updates targets which have the same timestamps as their
 prerequisites, which makes it generally unusable when shipped generated
-files such as 'configure' are involved.  Use GNU 'make' instead.
+files such as ‘configure’ are involved.  Use GNU ‘make’ instead.
 
    On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot
-parse its '<wchar.h>' header file.  The option '-nodtk' can be used as a
+parse its ‘<wchar.h>’ header file.  The option ‘-nodtk’ can be used as a
 workaround.  If GNU CC is not installed, it is therefore recommended to
 try
 
      ./configure CC="cc"
 
-and if that doesn't work, try
+and if that doesn’t work, try
 
      ./configure CC="cc -nodtk"
 
-   On Solaris, don't put '/usr/ucb' early in your 'PATH'.  This
+   On Solaris, don’t put ‘/usr/ucb’ early in your ‘PATH’.  This
 directory contains several dysfunctional programs; working variants of
-these programs are available in '/usr/bin'.  So, if you need '/usr/ucb'
-in your 'PATH', put it _after_ '/usr/bin'.
+these programs are available in ‘/usr/bin’.  So, if you need ‘/usr/ucb’
+in your ‘PATH’, put it _after_ ‘/usr/bin’.
 
-   On Haiku, software installed for all users goes in '/boot/common',
-not '/usr/local'.  It is recommended to use the following options:
+   On Haiku, software installed for all users goes in ‘/boot/common’,
+not ‘/usr/local’.  It is recommended to use the following options:
 
      ./configure --prefix=/boot/common
 
 Specifying the System Type
 ==========================
 
-   There may be some features 'configure' cannot figure out
+   There may be some features ‘configure’ cannot figure out
 automatically, but needs to determine by the type of machine the package
 will run on.  Usually, assuming the package is built to be run on the
-_same_ architectures, 'configure' can figure that out, but if it prints
+_same_ architectures, ‘configure’ can figure that out, but if it prints
 a message saying it cannot guess the machine type, give it the
-'--build=TYPE' option.  TYPE can either be a short name for the system
-type, such as 'sun4', or a canonical name which has the form:
+‘--build=TYPE’ option.  TYPE can either be a short name for the system
+type, such as ‘sun4’, or a canonical name which has the form:
 
      CPU-COMPANY-SYSTEM
 
@@ -268,101 +268,101 @@
      OS
      KERNEL-OS
 
-   See the file 'config.sub' for the possible values of each field.  If
-'config.sub' isn't included in this package, then this package doesn't
+   See the file ‘config.sub’ for the possible values of each field.  If
+‘config.sub’ isn’t included in this package, then this package doesn’t
 need to know the machine type.
 
    If you are _building_ compiler tools for cross-compiling, you should
-use the option '--target=TYPE' to select the type of system they will
+use the option ‘--target=TYPE’ to select the type of system they will
 produce code for.
 
    If you want to _use_ a cross compiler, that generates code for a
 platform different from the build platform, you should specify the
-"host" platform (i.e., that on which the generated programs will
-eventually be run) with '--host=TYPE'.
+“host” platform (i.e., that on which the generated programs will
+eventually be run) with ‘--host=TYPE’.
 
 Sharing Defaults
 ================
 
-   If you want to set default values for 'configure' scripts to share,
-you can create a site shell script called 'config.site' that gives
-default values for variables like 'CC', 'cache_file', and 'prefix'.
-'configure' looks for 'PREFIX/share/config.site' if it exists, then
-'PREFIX/etc/config.site' if it exists.  Or, you can set the
-'CONFIG_SITE' environment variable to the location of the site script.
-A warning: not all 'configure' scripts look for a site script.
+   If you want to set default values for ‘configure’ scripts to share,
+you can create a site shell script called ‘config.site’ that gives
+default values for variables like ‘CC’, ‘cache_file’, and ‘prefix’.
+‘configure’ looks for ‘PREFIX/share/config.site’ if it exists, then
+‘PREFIX/etc/config.site’ if it exists.  Or, you can set the
+‘CONFIG_SITE’ environment variable to the location of the site script.
+A warning: not all ‘configure’ scripts look for a site script.
 
 Defining Variables
 ==================
 
    Variables not defined in a site shell script can be set in the
-environment passed to 'configure'.  However, some packages may run
+environment passed to ‘configure’.  However, some packages may run
 configure again during the build, and the customized values of these
 variables may be lost.  In order to avoid this problem, you should set
-them in the 'configure' command line, using 'VAR=value'.  For example:
+them in the ‘configure’ command line, using ‘VAR=value’.  For example:
 
      ./configure CC=/usr/local2/bin/gcc
 
-causes the specified 'gcc' to be used as the C compiler (unless it is
+causes the specified ‘gcc’ to be used as the C compiler (unless it is
 overridden in the site shell script).
 
-Unfortunately, this technique does not work for 'CONFIG_SHELL' due to an
+Unfortunately, this technique does not work for ‘CONFIG_SHELL’ due to an
 Autoconf limitation.  Until the limitation is lifted, you can use this
 workaround:
 
      CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash
 
-'configure' Invocation
+‘configure’ Invocation
 ======================
 
-   'configure' recognizes the following options to control how it
+   ‘configure’ recognizes the following options to control how it
 operates.
 
-'--help'
-'-h'
-     Print a summary of all of the options to 'configure', and exit.
+‘--help’
+‘-h’
+     Print a summary of all of the options to ‘configure’, and exit.
 
-'--help=short'
-'--help=recursive'
-     Print a summary of the options unique to this package's
-     'configure', and exit.  The 'short' variant lists options used only
-     in the top level, while the 'recursive' variant lists options also
+‘--help=short’
+‘--help=recursive’
+     Print a summary of the options unique to this package’s
+     ‘configure’, and exit.  The ‘short’ variant lists options used only
+     in the top level, while the ‘recursive’ variant lists options also
      present in any nested packages.
 
-'--version'
-'-V'
-     Print the version of Autoconf used to generate the 'configure'
+‘--version’
+‘-V’
+     Print the version of Autoconf used to generate the ‘configure’
      script, and exit.
 
-'--cache-file=FILE'
+‘--cache-file=FILE’
      Enable the cache: use and save the results of the tests in FILE,
-     traditionally 'config.cache'.  FILE defaults to '/dev/null' to
+     traditionally ‘config.cache’.  FILE defaults to ‘/dev/null’ to
      disable caching.
 
-'--config-cache'
-'-C'
-     Alias for '--cache-file=config.cache'.
+‘--config-cache’
+‘-C’
+     Alias for ‘--cache-file=config.cache’.
 
-'--quiet'
-'--silent'
-'-q'
+‘--quiet’
+‘--silent’
+‘-q’
      Do not print messages saying which checks are being made.  To
-     suppress all normal output, redirect it to '/dev/null' (any error
+     suppress all normal output, redirect it to ‘/dev/null’ (any error
      messages will still be shown).
 
-'--srcdir=DIR'
-     Look for the package's source code in directory DIR.  Usually
-     'configure' can determine that directory automatically.
+‘--srcdir=DIR’
+     Look for the package’s source code in directory DIR.  Usually
+     ‘configure’ can determine that directory automatically.
 
-'--prefix=DIR'
+‘--prefix=DIR’
      Use DIR as the installation prefix.  *note Installation Names:: for
      more details, including other options available for fine-tuning the
      installation locations.
 
-'--no-create'
-'-n'
+‘--no-create’
+‘-n’
      Run the configure checks, but stop before creating any output
      files.
 
-'configure' also accepts some other, not widely useful, options.  Run
-'configure --help' for more details.
+‘configure’ also accepts some other, not widely useful, options.  Run
+‘configure --help’ for more details.

_service:tar_scm:groff-1.22.4.tar.gz/INSTALL.REPO -> _service:tar_scm:groff-1.23.0.tar.gz/INSTALL.REPO Changed

@@ -1,141 +1,136 @@
-    Copyright 2013-2018 Free Software Foundation, Inc.
+    Copyright 2013-2022 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without
     modification, are permitted in any medium without royalty provided
     the copyright notice and this notice are preserved.
 
-This file contains information that supplements the generic
-installation instructions in file `INSTALL'.  It is meant for
-people building directly from the development repository, rather than
-a release or snapshot tarball.
+This information supplements the generic installation instructions in
+the file 'INSTALL'.  It is meant for people building from the
+development repository, rather than a distribution archive.
+Distribution archives include a 'configure' script, among other files;
+the repository does not.  If you want to start building the 'groff'
+system using an existing 'configure' script, you don't need the
+information in this file.
 
-If you want to start compiling the `groff' system with an existing
-script `configure' you won't need the information in this file. You
-need them only if you want to build groff from the git repository.
+Dependencies
+------------
 
-1. Initial build
-----------------
+The dependencies documented in the 'INSTALL.extra' file are required, as
+are several others.
 
-You will need autoconf version and 2.65 or higher and automake version
-1.12.2 or higher. These minimal versions are set in the bootstrap.conf
-file.
+* You will need Autoconf version 2.68 or higher and Automake version
+  1.12.2 or higher.  These requirements are asserted in the
+  'bootstrap.conf' file.
 
-On operating systems supporting concurrent installation of multiple
-versions of the autotools, set the following environment variables:
+  On operating systems supporting concurrent installation of multiple
+  versions of the GNU Autotools, set environment variables as in the
+  following example, adjusting the version numbers as required.
 
-  export AUTOMAKE_VERSION=1.14
-  export AUTOCONF_VERSION=2.69
+    $ export AUTOMAKE_VERSION=1.14
+    $ export AUTOCONF_VERSION=2.69
 
-You will also need to have `pkg-config' installed on your system.
+* You will need a 'yacc' program.  We recommend Berkeley yacc ('byacc')
+  or GNU Bison ('bison').
 
-First invoke the bootstrap script:
+* groff's Texinfo manual is generated in several formats: GNU Info,
+  HTML, plain text, TeX DVI, and PDF.  The former three require
+  'makeinfo' from GNU Texinfo 5.0 or later.  The latter two additionally
+  require a TeX installation, such as TeX Live.  If TeX is not
+  installed, the DVI and PDF formats of the manual cannot be generated.
+  This will cause a build failure only if the Texinfo source file
+  "groff.texi" is updated and the make(1) "dist" or relevant file
+  targets are manually specified.
+
+* You will need the 'xpmtoppm', 'pnmdepth', and 'pnmtops' programs from
+  the Netpbm distribution.
+
+
+Bootstrapping from a Git checkout
+---------------------------------
+
+Invoke the bootstrap script.
 
     $ ./bootstrap
 
-This will:
-  
-  - clone the gnulib repository as a git submodule in 'gnulib', add
-    the needed gnulib sources files in 'lib', add the needed gnulib m4
-    macros in 'gnulib_m4'
 
-  - Invoke autoreconf that will call all the `GNU autotools'
-    (`aclocal', `autoconf', `automake') in the right order for
-    creating the following files:
+What bootstrapping does
+-----------------------
+
+The foregoing procedure will do two things:
+
+  - clone the gnulib repository as a Git submodule in 'gnulib', add the
+    needed gnulib source files in 'lib' as well as required gnulib m4
+    macros in 'gnulib_m4'; and
+
+  - invoke 'autoreconf', which will call the GNU Autotools ('aclocal',
+    'autoconf', 'automake') in the right order to create the following
+    files.
 
     -- INSTALL (a symlink to gnulib's INSTALL file)
     -- Makefile.in
     -- aclocal.m4
     -- autom4te.cache/
-    -- build-aux/ (that contains all the helper scripts) 
+    -- build-aux/ (which contains all the helper scripts)
     -- configure
     -- src/include/config.hin
 
-Note that aclocal.m4 is generated and the groff m4 macros are included
-via the acinclude.m4 file.
-  
-At this point you can invoke the `configure' script (that generates
-the `config.status' script; it is the `config.status' script generates
-the Makefile) and call 'make' to build the groff project. You can do
-it in the source tree:
+'aclocal.m4' is a generated file; groff's m4 macros are included via the
+'acinclude.m4' file.
+
+
+Building
+--------
+
+You can now invoke the 'configure' script.  It produces the
+'config.status' script, which generates the Makefile.  Then call 'make'
+to build the groff project.  You can do these from the source tree.
 
     $ ./configure
-    $ make
+    $ make # run with -j option if desired
 
-You can also build groff in an out of source build tree, which is cleaner:
+You can alternatively build groff outside of its source tree, which is
+cleaner, leaving fewer files to confuse 'git status' if you aim to
+undertake development.
 
     $ mkdir build
     $ cd build
     $ ../configure
-    $ make
-
-Note that parallel build is also supported and make can be invoked
-with the -j option, which will greatly speed up the build.
-
-When the build is finished you can install the whole groff
-installation with:
-
-    $ make install
-
-Notes:
-
-If you use an old `autoreconf' version < 2.69, there might be an error
-warning like:
-
-  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
-    warning: underquoted definition of AC_GTKGLEXTMM_SUPPORTS_MULTIHEAD
-  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
-    run info '(automake)Extending aclocal'
-  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
-    or see http://www.gnu.org/software/automake/manual/automake.html#Extending-aclocal
-
-Just ignore this.  It doesn't occur in the actual versions of
-`autoreconf'.
-
-Troff errors of the types
-
-  can't transparently output node at top level
-    and
-  can't translate character code n to special character 'c' in transparent throughput
+    $ make # run with -j option if desired
 
-may safely be ignored.
+A separate build tree need not be a subdirectory of the source.
 
-A few sanity checks can be done with the command:
 
-    $ make check
+Evaluation
+----------
 
-This will perform some tests on the generated examples.  However,
-these checks are for the moment quite limited.
+Several dozen sanity checks can be performed within the build tree.
 
-The groff texinfo manual can be generated in pdf and html formats
-with:
+    $ make check # run with -j option if desired
 
-    $ make doc
 
-and installed with:
+Installation
+------------
 
-    $ make install-doc
+When the build is finished you can install the groff build artifacts.
 
+    $ make install install-doc # run with 'sudo' if necessary
 
-2. Modification of autotools files
-----------------------------------
 
-Previously, when groff used `autoconf' only and not `automake', you
-had to invoke manually the autotools, depending on what you
-modified. For example, to change the file `aclocal.m4', you had to run
-the shell command 'aclocal -I m4', to recreate the files `configure'
-and `Makefile', you had to use the command 'autoreconf -I m4'.
+Uninstalling
+------------
 
-Now, as groff uses `automake', you don't need to run `autoreconf'. If
-you make some changes in Makefile.am or configure.ac, all the files
-that need to be updated will be regenerated when you execute `make'.
+See "Uninstalling" in the 'INSTALL.extra' file.
 
 
+Rebuilding
+----------
 
-3. Quick start on the usage of `automake' in groff
---------------------------------------------------
+Start over from "Building" above.
 
-A little document explaining the basics of automake and its usage in
-groff is available in doc/automake.mom. It is currently not
-automatically generated, to build it:
 
-pdfmom automake.mom > automake.pdf
+##### Editor settings
+Local Variables:
+fill-column: 72
+mode: text
+End:
+# vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/INSTALL.extra -> _service:tar_scm:groff-1.23.0.tar.gz/INSTALL.extra Changed

@@ -1,73 +1,100 @@
-    Copyright 1997-2018 Free Software Foundation, Inc.
+    Copyright 1997-2022 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
 This file contains information that supplements the generic
-installation instructions in file `INSTALL'.
+installation instructions in file 'INSTALL'.
 
 
-Normal Installation
-===================
+Building and Installing from within the Source Tree
+===================================================
+
+A simple method of building and installing groff is as follows.
 
-The simplest way to compile groff is:
+  1. 'cd' to the directory containing groff's source code and type
+     './configure' to configure groff for your system.  If you are
+     using 'csh' on an old version of AT&T Unix System V, you might need
+     to type 'sh ./configure' instead to prevent 'csh' from trying to
+     execute 'configure' itself.
 
-  1. `cd' to the directory containing groff's source code and type
-     `./configure' to configure groff for your system.  If you are
-     using `csh' on an old version of System V, you might need to type
-     `sh ./configure' instead to prevent `csh' from trying to execute
-     `configure' itself.
+     While 'configure' runs, it reports properties of the host system
+     that determine how the build is to be performed.
 
-     Running `configure' takes awhile.  While running, it prints some
-     messages telling which features it is checking for.
+  2. Type 'make' to compile groff.  You may wish to add the '-j' option
+     to accelerate the build on multicore systems.
 
-  2. Type `make' to compile groff.
+  3. Optionally, check the build for sound operation as described under
+     "Evaluation" below.
 
-  3. Type `sudo make install' to install the groff programs and any
-     data files and documentation.  `make install' is the only step for
-     which you need `root' access; this is done by `sudo'.
+  4. Type 'sudo make install install-doc' to install groff's programs,
+     data files, and documentation.  This is the only step for which you
+     need 'root' access; 'sudo' obtains this access.
 
-  4. You can remove the groff binaries and object files from the
-     source code directory by typing `make clean'.  To also remove the
-     files that `configure' created (so you can compile groff for
-     a different kind of computer), type `make distclean'.
+  5. You can remove the groff executables and other generated files from
+     the source code directory by typing 'make clean'.  To also remove
+     the files that 'configure' created (so you can compile groff for a
+     different kind of computer or with different options to
+     'configure'), type 'make distclean'.
 
 
-External Installation
-=====================
+Building and Installing from outside the Source Tree
+====================================================
 
-It is also possible to perform the whole installation process outside
-of the source code directory.  In this case a whole external build
+It is also possible to perform the build and installation procedure
+outside the source code directory.  In this case an external build
 directory structure is created without changing any parts of the source
-code tree.  This is useful if the source code is read-only or if
+tree.  This practice is useful if the source code is read-only or if
 several different installations, such as for multiple architectures,
 should be constructed.
 
-As an example we assume that the source code of the `groff' code is in
-`/usr/local/src/groff', and that the build process should be done
-within the directory `/home/my/groff.compile'.
+As an example, we will imagine that groff's source code is in
+'/usr/local/src/groff' and that the build should happen within the
+directory '/home/my/groff-build'.  These directory names can be anything
+valid on the operating system.
+
+  0. Create '/home/my/groff-build' and 'cd' to that directory.
+
+  1. Type '/usr/local/src/groff/configure' to configure groff for your
+     system.  If you are using 'csh' on an old version of AT&T System V
+     Unix, you might need to type 'sh /usr/local/src/groff/configure'
+     instead.
+
+  2. Type 'make' to compile groff.  You may wish to add the '-j' option
+     to accelerate the build on multicore systems.
 
-  0. Create `/home/my/groff.compile' and change to that directory.
+  3. Optionally, check the build for sound operation as described under
+     "Evaluation" below.
 
-  1. Call `/usr/local/src/groff/configure' in that directory to
-     configure groff for your system.  If you are using `csh' on an old
-     version of System V, you might need to type `sh
-     /usr/local/src/groff/configure' instead.
+  4. Type 'sudo make install install-doc' to install groff's programs,
+     data files, and documentation.  This is the only step for which you
+     need 'root' access; 'sudo' obtains this access.
 
-  2. Type `make' to compile groff in that directory.
+  5. You can remove the groff executables and other generated files from
+     the source code directory by typing 'make clean'.  To also remove
+     the files that 'configure' created (so you can compile groff for a
+     different kind of computer or with different options to
+     'configure'), type 'make distclean'.
 
-  3. Type `sudo make install' to install the groff programs and any
-     data files and documentation.
 
-  4. You can remove the groff binaries and object files from the
-     build directory by typing `make clean'.  To also remove the
-     files that `configure' created (so you can compile the package for
-     a different kind of computer), type `make distclean'.
+Unprivileged Installation
+=========================
 
+The use of 'sudo' is necessary only if one or more destination
+directories used by the 'make install' command are in locations that
+require administrative access for writing.  You can 'configure' groff
+with options like '--prefix' that select an alternative directory that
+is writable by the user conducting the build.  Type './configure --help'
+from the groff source tree for documentation of relevant options.
+Running groff commands from such a directory may require you to set the
+'GROFF_BIN_PATH', 'GROFF_FONT_PATH', and 'GROFF_TMAC_PATH' environment
+variables.  See the groff(1) man page.  See "Evaluation" below for
+instructions on viewing this man page without having groff installed.
 
-Special Platforms
-=================
+
+Non-POSIX Platforms
+===================
 
 For instructions how to build groff with DJGPP tools for MS-DOS and
 MS-Windows, see the file arch/djgpp/README.
@@ -79,72 +106,168 @@
 Dependencies
 ============
 
-groff is written in C++, so you need a C++ compiler.  The C++ source
-files use a suffix of `.cpp', so your C++ compiler must be able to
-handle this.  If you don't already have a C++ compiler, we suggest gcc
-2.7.1 or later (gcc version 2 includes GNU C++ as well as GNU C).  From
-gcc 2.5, it is no longer necessary to install libg++: the C++ header
-files needed by groff are created by the gcc installation process.  To
-override configure's choice of C++ compiler, you can set the CXX
-environment variable.
+groff is predominantly written in ISO C++98, so you need a C++ compiler
+capable of handling this standardized version of the language.  The C++
+source files use a suffix of '.cpp'; your C++ compiler must be able to
+handle this.  A C/C++ preprocessor that conforms to ISO C90 is also
+required.  If you don't already have a C++ compiler, we suggest GCC 9.4
+or later.  To override the 'configure' script's choice of C++ compiler,
+you can set the CXX environment variable to the name of its executable.
+
+A few components of groff are written in ISO C99.  Features later made
+optional by ISO C11 (the 'complex' primitive data type and
+variable-length arrays) are not used.
+
+Several programs distributed with GNU roff are written in the Perl
+language.  Version 5.6.1 (1 April 2001) or later is required.
+
+The 'uchardet' library is an optional dependency of the 'preconv'
+program: if this library is found by 'configure', it will be
+automatically used by 'preconv'.  Discovery of the 'uchardet' library
+requires the 'pkg-config' program to be installed on your system, as
+well as the library's C header files--on a package-based host system,
+this can mean installing uchardet's '-dev' or '-devel' package.
+
+URW fonts
+---------
+
+The 'configure' script searches for PostScript Type 1 fonts originating
+with the URW foundry; these are metrically compatible replacements for
+the Adobe PostScript Level 2 base 35 fonts required by that standard.
+These URW fonts are packaged with Ghostscript and in various derivative
+versions.  The Adobe fonts are not free software, but the replacements,
+often named "Nimbus Roman", "Nimbus Sans", and "Nimbus Mono", and so
+forth, are.  The PostScript and early PDF standards assumed that these
+base fonts would be supplied by the rendering device (a printer or PDF
+viewer).  Nowadays the PDF standard expects all fonts to be embedded in
+the document; if groff's gropdf(1) output driver knows where to find
+these fonts, you can use its "-e" option for this purpose.
+
+The build process populates "Foundry" and "download" files that tell
+gropdf where to find their groff font descriptions and the font files
+themselves, respectively.  If you have multiple versions of the URW
+fonts available on your system, or the 'configure' script cannot locate
+them on its own, use its "--with-urw-fonts-dir" option to tell the
+script where to find them.  If you never use groff to generate
+PostScript or PDF documents, you can ignore any output from the
+'configure' script about URW fonts.
 
-If you have a library that provides a faster malloc than your system's
-usual malloc, it is good idea to include it in LIBS.  For example,
-using the malloc that comes with GNU Emacs version 20 can give a
-worthwhile (and sometimes spectacular) performance improvement.
 
-Many programs within the `groff' system are written in the Perl
-language.  So you need a `perl' program with the least version of
-`v5.6.1'.
+Miscellaneous
+=============
 
-In order to build the documentation you would need `makeinfo' from the
-'texinfo' package, in fact `configure' will fail if this program is
-not found unless you pass the option `with-doc=no'.
+If you want A4 or U.S. letter paper format and the 'configure' script
+produces an incorrect guess, say
 
-The `uchardet' library is an optional dependency of the `preconv'
-program: if this library is found by `configure' it will be
-automatically used by `preconv'.  In order to discover the presence of
-the `uchardet' library you would also need to have the `pkg-config'
-program installed on your system.
+  PAGE=xxx ./configure
 
+where 'xxx' should be either 'A4' or 'letter'.  This affects only the
+media size used by some groff output drivers, like grops (which can
+still be overridden on the command line).  For compatibility with AT&T
+troff, GNU troff's default page length is always 11 inches.  The page
+length can be changed with the 'pl' request or with the "papersize"
+macro package; see section "Paper format" in groff(1).
 
-Miscellaneous
+
+Evaluation
+==========
+
+Once groff is built, you can check it for correct operation without
+having to install it.  groff comes with a test suite; use 'make check'
+to run it.
+
+You can also try it out from the directory you used to build it.  A
+script called 'test-groff' is supplied for this purpose.  It sets up
+environment variables to allow groff to run without being installed.
+For example, from the directory where you built groff, the command
+
+  ./test-groff -t -man -Tascii src/roff/groff/groff.1 | less -R
+
+displays the groff(1) man page with the 'less' pager.  (You might prefer
+either the '-Tlatin1' or '-Tutf8' option to '-Tascii' depending on the
+character set you're using.)
+
+
+Documentation
 =============
 
-If you want A4 or letter paper format and the configure script produces
-an incorrect guess, say
+The groff Texinfo manual can be viewed in several formats.  Versions
+corresponding to the source document 'doc/groff.texi' are supplied with
+the source distribution archive.  You can browse it in GNU info format.
 
-  PAGE=xxx ./configure
+  info doc/groff.info
+
+It can be viewed as text encoded in ISO Latin-1 as well.
+
+  iconv -f latin1 -t utf8 doc/groff.txt | less # for UTF-8 users
+  less doc/groff.txt # for Latin-1 users
+
+Renderings in HTML, TeX DVI, and PDF are also available.
+
+  lynx doc/groff.html
+  xdvi doc/groff.dvi
+  evince doc/groff.pdf
+
+A compilation of groff's man pages is available in text (with ISO 6429
+escape sequences) and PDF.
+
+  less -R doc/groff-man-pages.utf8.txt
+  evince doc/groff-man-pages.pdf
 
-where `xxx' should be either `A4' or `letter'.  Note that this only
-affects the paper selection of some device drivers like grops (which
-can be still overridden on the command line).  For compatibility with
-ditroff, the default page length in gtroff is always 11 inches.  The
-page length can be changed with the `pl' request.
 
-When you have built groff but not installed yet, you can use the
-test-groff script to try groff out on one of the man pages.  (Use the
-.n files not the .man files.)  The test-groff script sets up environment
-variables to allow groff to run without being installed.  For example,
-you could do
+In Case of Trouble
+==================
 
-  ./test-groff -man -Tascii src/roff/groff/groff.n | less
+If a test fails, gather its log file from the build directory.  For
+instance, the test "tmac/tests/localization-works.sh" (in the source
+directory) will have a log file called
+"tmac/tests/localization-works.sh.log" in the build directory.
 
-to display the groff(1) man page with the `less' pager.
+To re-run a test, change to the top of the build directory (if
+necessary) and run the test by name from the shell prompt.
 
-To get a DVI, PDF, or HTML version of the groff texinfo manual, say
-`make groff.dvi', `make groff.pdf', or `make groff.html', respectively,
-in the `doc' subdirectory (after configuring the groff package).  Note
-that you need texinfo version 4.8 as a prerequisite.
+For example, to rerun the test mentioned above from a "build" directory
+I created as a subdirectory in the source tree, I would do this.
 
-If you have problems, read the PROBLEMS file.  If this doesn't help
-and you need support, please contact the `groff' mailing list.  If you
-think that you have found a bug, please submit a report in our bug
-tracker at
+  (cd build && ../tmac/tests/localization-works.sh)
 
-  https://savannah.gnu.org/projects/groff
+I can view the test log as follows.
+
+  cat build/tmac/tests/localization-works.sh.log
+
+Many known issues are documented in the 'PROBLEMS' file; some apply to
+historical systems.  You can also browse groff bug reports via the GNU
+Savannah issue tracker to see if your issue has already been reported.
+
+  https://savannah.gnu.org/bugs/?group=groff
+
+If that doesn't help and you need support, please contact the groff
+mailing list at groff@gnu.org.  If you think that you have found a bug,
+please submit a ticket using the 'BUG-REPORT' file as a template.
+
+  https://savannah.gnu.org/bugs/?group=groff&func=additem
+
+
+Uninstalling
+============
 
-##### Emacs settings
+If you are dissatisfied with groff, or to prepare for a new installation
+from source, you can uninstall it to ensure that no stale files persist
+on the system.  Run the command 'sudo make uninstall'.  (If you
+successfully used 'make install', simply run 'make uninstall'.)  At a
+minimum, some directories not particular to groff, like 'bin' and
+(depending on configuration) an X11 'app-defaults' directory will
+remain, as will one plain file called 'dir', created by GNU Texinfo's
+'install-info' command.  (As of this writing, 'install-info' offers no
+provision for removing an effectively empty 'dir' file, and groff does
+not attempt to parse this file to determine whether it can be safely
+removed.)  All other groff artifacts will be deleted from the
+installation hierarchy.
+
+
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/LICENSES -> _service:tar_scm:groff-1.23.0.tar.gz/LICENSES Changed

@@ -1,4 +1,4 @@
-    Copyright 2003-2018 Free Software Foundation, Inc.
+    Copyright 2003-2022 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -7,158 +7,213 @@
 LICENSES
 --------
 
-The groff program is a free software project.  It is licensed under the GNU
-General Public License (GNU GPL), version 3 or later.
-
-The file COPYING in the top directory of the groff source package contains a
-copy of the GPL that was downloaded from the GNU web site
-http://www.gnu.org/copyleft/gpl.txt at 3 jan 2009.
-
-All files part of groff are licensed under this version of the GPL (or
-licenses which are compatible with the GPL). You are free to choose
-version 3 or any subsequent version of the GPL.
-
-The GPL names an address where you can get the actual version by normal
-post.  Further information is found in the internet at
-http://www.gnu.org/copyleft.
-
-The groff program is a GNU package, and the copyright of all files of the
-groff source package which are under the GPL has been assigned to the Free
-Sofware Foundation (FSF).  Information on GNU and FSF is found at
-http://www.fsf.org/.
-
+groff is a free software project.  It is licensed under the GNU General
+Public License (GPL), version 3 or later.
+
+The file COPYING in the top directory of the groff source distribution
+contains a copy of the GPL that was downloaded from the GNU web site
+<http://www.gnu.org/copyleft/gpl.txt> on 3 January 2009.
+
+All files in the groff source distribution are distributed under the
+terms of this version of the GPL.  You are free to choose version 3 or
+any subsequent version of the GPL.  Some are distributed under
+alternative terms as well.
+
+The text of the GPL contains a postal address from which you can obtain
+the current version of the license.  Further information is available on
+the Web at <http://www.gnu.org/copyleft>.
+
+groff is an effort of the GNU Project of the Free Software Foundation
+(FSF); with the exceptions noted below, the copyrights of all files
+comprising it have been assigned to the FSF.  Information on GNU and the
+FSF may be found at <http://www.fsf.org/>.
+
+Files in the contrib/ subdirectory of the source distribution are not
+strictly part of groff.  That is, they are distributed with it and are
+Free Software <https://www.gnu.org/philosophy/free-sw.en.html>, but they
+are not considered essential parts of the distribution.  Further, they
+may bear licenses other than the GPL or the FSF does not administer
+their copyrights.  To determine their copyright status and licensing,
+see the "COPYRIGHT" file in the appropriate subdirectory of contrib/.
+
+Some files are part of groff but bear licenses in addition to the GPL,
+or have been placed into the public domain.  This is because they
+originated elsewhere; often, the groff project has modified them,
+sometimes extensively.  These multi-licensed groff components are as
+follows.  Their file names are not always identical to those in their
+original distributions, but we have kept them similar.
+
+grn preprocessor
+================
+
+grn, written by Barry Roitblat <barry@rentonww.com> and David
+Slattengren <slatteng@Xinet.COM>, was part of the Berkeley
+device-independent troff distribution.  The files contain no AT&T code
+and are in the public domain.  Historically, the original package could
+be found at <http://ftp.cs.wisc.edu/pub/misc/grn.tar.Z>.
+
+	src/preproc/grn/gprint.h
+	src/preproc/grn/hdb.cpp
+	src/preproc/grn/hgraph.cpp
+	src/preproc/grn/hpoint.cpp
+	src/preproc/grn/main.cpp
+
+gxditview output driver
+=======================
+
+gxditview is based on the X Window System (Version 11)'s "xditview"
+program, and is licensed under the same terms as the rest of X11R5.
+
+	src/devices/xditview/DESC.in
+	src/devices/xditview/Dvi.c
+	src/devices/xditview/Dvi.h
+	src/devices/xditview/DviP.h
+	src/devices/xditview/FontMap-X11
+	src/devices/xditview/GXditview.ad
+	src/devices/xditview/Menu.h
+	src/devices/xditview/ad2c
+	src/devices/xditview/device.c
+	src/devices/xditview/device.h
+	src/devices/xditview/draw.c
+	src/devices/xditview/font.c
+	src/devices/xditview/gray1.bm
+	src/devices/xditview/gray2.bm
+	src/devices/xditview/gray3.bm
+	src/devices/xditview/gray4.bm
+	src/devices/xditview/gray5.bm
+	src/devices/xditview/gray6.bm
+	src/devices/xditview/gray7.bm
+	src/devices/xditview/gray8.bm
+	src/devices/xditview/gxditview.man
+	src/devices/xditview/lex.c
+	src/devices/xditview/page.c
+	src/devices/xditview/parse.c
+	src/devices/xditview/xdit.bm
+	src/devices/xditview/xdit_mask.bm
+	src/devices/xditview/xditview.c
+
+	src/include/DviChar.h
+	src/include/XFontName.h
+
+	src/libs/libxutil/DviChar.c
+	src/libs/libxutil/XFontName.c
+
+mdoc macro package
+==================
+
+mdoc uses the BSD "three-clause" license; that is, it is subject to the
+advertising clause rescission.
+
+	tmac/doc.tmac
+	tmac/doc-old.tmac
+	tmac/mdoc/doc-common
+	tmac/mdoc/doc-ditroff
+	tmac/mdoc/doc-nroff
+	tmac/mdoc/doc-syms
+	tmac/groff_mdoc.7.man
+
+me macro package
+================
+
+"me" uses the BSD "three-clause" license; that is, it is subject to the
+advertising clause rescission.
+
+	tmac/e.tmac
+	tmac/groff_me.man
+	doc/meintro.me
+	doc/meintro_fr.me
+	doc/meref.me
+
+Hyphenation patterns
+====================
+
+groff's hyphenation pattern files are adapted from those used by various
+TeX-related projects.
+
+* "tmac/hyphen.cs" is renamed from "czhyphen.tex", and obtained from
+  <http://dante.ctan.org/CTAN/macros/cstex/base/csplain.tar.gz>.
+
+  It is under the GNU General Public License, version 2 or later.
+
+* "tmac/hyphen.den" and "tmac/hyphen.det" are renamed from
+  "dehyphn-x-2017-03-31.pat" and "dehypht-x-2017-03-31.pat",
+  respectively, in the "dehyph-exptl-0.41" package.
+
+  Copyright (c) 2013-2017
+  Stephan Hennig, Werner Lemberg, Guenter Milde, Sander van Geloven,
+  Georg Pfeiffer, Gisbert W. Selke, Tobias Wendorf
+
+  Licensed under the MIT license. Full license text available from
+
+    http://opensource.org/licenses/mit-license.php
+
+* "tmac/hyphen.en" is renamed from "hyph-en-us.tex" in the "hyph-utf8"
+  CTAN package.
+
+  Copyright (C) 1990, 2004, 2005 Gerard D.C. Kuiken
+
+  Copying and distribution of this file, with or without modification,
+  are permitted in any medium without royalty provided the copyright
+  notice and this notice are preserved.
+
+* "tmac/hyphen.fr" is renamed from "frhyph.tex", obtained from
+  <http://dante.ctan.org/CTAN/language/hyphenation/frhyph.tex>.
+
+  It identifies no copyright holder but bears a license statement.
+
+  This file is available for free and can used and redistributed
+  asis for free. Modified versions should have another name.
+
+* "tmac/hyphen.it" is renamed from "hyph-it.tex" in the "hyph-utf8" CTAN
+  package.
+
+  Copyright (C) 2008-2011 Claudio Beccari
+
+  This file is available under any of the following licences:
+
+  name: LPPL
+  version: 1.3
+  or_later: true
+  url: http://www.latex-project.org/lppl.txt
+  status: maintained
+  maintainer: Claudio Beccari, e-mail claudio dot beccari at gmail dot
+  com
+
+  name: MIT
+  url: https://opensource.org/licenses/MIT
+  text: >
+      Permission is hereby granted, free of charge, to any person
+      obtaining a copy of this software and associated documentation
+      files (the "Software"), to deal in the Software without
+      restriction, including without limitation the rights to use,
+      copy, modify, merge, publish, distribute, sublicense, and/or sell
+      copies of the Software, and to permit persons to whom the
+      Software is furnished to do so, subject to the following
+      conditions:
 
-Here a list of files which are distributed with groff but which aren't
-part of it (this is, they either have a non-GPL license, or the copyright
-hasn't been assigned to the FSF).
+      The above copyright notice and this permission notice shall be
+      included in all copies or substantial portions of the Software.
 
+      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+      EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+      OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+      NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+      HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+      WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+      FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+      OTHER DEALINGS IN THE SOFTWARE.
 
-  Source Files
-  ------------
+* "tmac/hyphen.sv" is renamed from "svhyph.tex", obtained from
+  <http://dante.ctan.org/CTAN/language/hyphenation/svhyph.tex>.
 
-  . The `grn' preprocessor, written by Barry Roitblat <barry@rentonww.com>
-    and David Slattengren <slatteng@Xinet.COM>.  These files have been part
-    of the original Berkeley ditroff distribution, without AT&T code, and
-    are in the public domain.
+  Copyright 1994 by Jan Michael Rynning. All rights reserved.
 
-    The original package can be found at
-    http://ftp.cs.wisc.edu/pub/misc/grn.tar.Z    .
+  This program may be distributed and/or modified under the conditions
+  of the LaTeX Project Public License, either version 1.2 of this
+  license or (at your option) any later version.  The latest version of
+  this license is in http://www.latex-project.org/lppl.txt and version
+  1.2 or later is part of all distributions of LaTeX version 1999/12/01
+  or later.
 
-      src/preproc/grn/gprint.h
-      src/preproc/grn/hdb.cpp
-      src/preproc/grn/hgraph.cpp
-      src/preproc/grn/hpoint.cpp
-      src/preproc/grn/main.cpp
-
-  . The `gxditview' output device.  It is based on X11's `xditview' program
-    and thus has the X license.
-
-      src/devices/xditview/DESC.in
-      src/devices/xditview/Dvi.c
-      src/devices/xditview/Dvi.h
-      src/devices/xditview/DviP.h
-      src/devices/xditview/FontMap
-      src/devices/xditview/GXditview.ad
-      src/devices/xditview/Menu.h
-      src/devices/xditview/ad2c
-      src/devices/xditview/device.c
-      src/devices/xditview/device.h
-      src/devices/xditview/draw.c
-      src/devices/xditview/font.c
-      src/devices/xditview/gray1.bm
-      src/devices/xditview/gray2.bm
-      src/devices/xditview/gray3.bm
-      src/devices/xditview/gray4.bm
-      src/devices/xditview/gray5.bm
-      src/devices/xditview/gray6.bm
-      src/devices/xditview/gray7.bm
-      src/devices/xditview/gray8.bm
-      src/devices/xditview/gxditview.man
-      src/devices/xditview/lex.c
-      src/devices/xditview/page.c
-      src/devices/xditview/parse.c
-      src/devices/xditview/xdit.bm
-      src/devices/xditview/xdit_mask.bm
-      src/devices/xditview/xditview.c
-
-      src/include/DviChar.h
-      src/include/XFontName.h
-
-      src/libs/libxutil/DviChar.c
-      src/libs/libxutil/XFontName.c
-
-
-  Macro Packages
-  --------------
-
-  . The -mdoc macro set, using the BSD license.
-
-      tmac/doc.tmac
-      tmac/doc-old.tmac
-      tmac/doc-common
-      tmac/doc-ditroff
-      tmac/doc-nroff
-      tmac/doc-syms
-      tmac/groff_mdoc.man
-
-  . The -me macro set, using the BSD license.
-
-      tmac/e.tmac
-      tmac/groff_me.man
-      doc/meintro.me
-      doc/meintro_fr.me
-      doc/meref.me
-
-
-  Hyphenation Patterns
-  --------------------
-
-  . The file `tmac/hyphen.us' is identical to the file `hyphen.tex', part of
-    the TeX system written by Donald E. Knuth; the master file can be found
-    at
-
-      ftp://labrea.stanford.edu/pub/tex/dist/lib/hyphen.tex    .
-
-    It has been renamed for consistency, i.e., to make patterns available
-    under the filenames `hyphen.<language>', e.g. `hyphen.de' or
-    `hyphen.uk'.
-
-    See the file itself for a copyright notice.
-
-  . The file `tmac/hyphen.fr' contains the same patterns as the file
-    `frhyph.tex' (for TeX), which can be found at
-
-      http://dante.ctan.org/CTAN/language/hyphenation/frhyph.tex    .
-
-    The patterns have been converted to a format groff can understand.
-
-    See the file itself for a copyright notice.
-
-  . The file `tmac/hyphen.sv' is identical to the file `svhyph.tex', which
-    can be found at
-
-      http://dante.ctan.org/CTAN/language/hyphenation/svhyph.tex    .
-
-    See the file itself for a copyright notice.
-
-  . The files `tmac/hyphen.det' and `tmac/hyphen.den' contain the same
-    patterns as the files `dehypht-x-2017-03-31.pat' and
-    `dehyphn-x-2017-03-31.pat' (for TeX), respectively, which can be found
-    at
-
-      http://ctan.org/tex-archive/language/hyphenation/dehyph-exptl
-
-    The patterns have been converted to latin-1.
-
-    See the files themselves for a copyright notice.
-
-  . The file `tmac/hyphen.cs' contains the same patterns as the file
-    `czhyphen.tex' (for TeX), which can be found in the archive
-
-      http://dante.ctan.org/CTAN/macros/cstex/base/csplain.tar.gz    .
-
-    The patterns have been converted to a format groff can understand.
-
-    See the file itself for a copyright notice.
-
-EOF
+Any omissions from the above list are unintentional; please contact the
+groff development mailing list at groff@gnu.org to point them out.

_service:tar_scm:groff-1.22.4.tar.gz/MANIFEST -> _service:tar_scm:groff-1.23.0.tar.gz/MANIFEST Changed

@@ -1,182 +1,191 @@
-    Copyright 2001-2018 Free Software Foundation, Inc.
+    Copyright 2001-2022 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-This file gives an overview of the directories and the main files of
-the groff source distribution.
+This file summarizes the structure of the groff source distribution.
 
 
-1) The top directory.
+1) Top-level directory contents
 
-  BUG-REPORT    A template for bug-reports.
-  ChangeLog     Log of the changes in the different groff versions.
+  BUG-REPORT    A template for bug reports.
+  ChangeLog     Log of changes since last groff minor version release.
+  ChangeLog.*   Logs of changes in past groff versions.
   COPYING       The GNU General Public License (GPL).
-  FDL           The Free Documentation License (FDL).
-  INSTALL       Information on compiling and installing groff.
-  INSTALL.gen   Generic information on configuration and compiling.
-  LICENSES      Licensing information.
+  FDL           The GNU Free Documentation License (FDL).
+  FOR-RELEASE   Release procedures for groff maintainer(s) to follow.
+  HACKING       Advice for contributors to groff.
+  INSTALL       Generic information on configuration and compiling.
+  INSTALL.extra How to install groff from a distribution archive.
+  INSTALL.REPO  How to install groff from a Git repository checkout.
+  LICENSES      Copyright and licensing information.
   MANIFEST      The file you are reading.
   MORE.STUFF    Useful stuff in other packages.
-  NEWS          Recent user-visible changes in groff.
-  PROBLEMS      Tips to handle known critical situations.
+  NEWS          Log of feature changes in groff.
+  PROBLEMS      Tips to handle known situations of concern.
   PROJECTS      Long-term additions to groff.
-  README        Availability and contact information for groff.
+  README        Introduction to and contact information for groff.
   README.MinGW  Build information for MinGW.
   TODO          Things planned for future groff versions.
 
-  All other files in the top directory are related to the configuration,
-  compilation, and install processes.  
+  All other files in the top-level directory are related to
+  configuration, compilation, and installation procedures.
 
 
-2) The directory structure
+2) Directory structure
 
-./arch          Data that is special for different architectures.
-  djgpp         Data special for the 32-bit DOS compiler djgpp.
-  misc          Data needed for various platforms.
+./arch          Resources to facilitate building on non-POSIX systems.
+  djgpp         Resources for the 32-bit MS-DOS compiler djgpp.
+  mingw         Resources for the MinGW environment.
+  misc          Resources for various other platforms.
 
-./contrib       Part of groff, but maintained by other people.
-  chem          A preprocessor (for pic) to produce chemical structure
-                diagrams.
-  eqn2graph     Convert equations created with EQN into different
-                graphical formats.
+./contrib       Resources provided with groff, but maintained by others.
+  chem          Embed chemical structure diagrams in groff documents.
+  eqn2graph     Convert eqn(1) equations into graphical images.
   gdiffmk       An improved implementation of the diffmk command to mark
                 differences between groff/nroff/troff files.
-  glilypond     A preprocessor that handles `lilypond' parts in a `roff'
-                file.
-  gperl         A preprocessor that handles `perl' parts in a `roff'
-                file.
-  gpinyin       A preprocessor providing simpler Pinyin input.
-  grap2graph    Convert grap diagraps into different graphical formats.
-  groffer       A wrapper to conveniently view roff files.
+  glilypond     Embed LilyPond sheet music in groff documents.
+  gperl         Populate groff registers and strings using perl(1).
+  gpinyin       Use Hanyu Pinyin input to compose groff documents.
+  grap2graph    Convert grap(1) diagrams into graphical images.
   hdtbl         A sophisticated table macro package.
-  mm            The groff mm macro package.
-  mom           The groff mom macro package.
-  pdfmark       A package to add PDF marks to groff documents, together
-                with a shell script (pdfroff) for easy creation of PDF
-                documents.
-  pic2graph     Convert PIC diagrams into different graphical formats.
-
-./doc           Manuals and tutorials to groff aspects.
-
-./font          Device information and fonts.
-  devX100       100dpi device for X Window System.
-  devX100-12    100dpi device with narrower font (for 12pt base font).
-  devX75        75dpi device for X Window System.
-  devX75-12     75dpi device with narrower font (for 12pt base font).
-  devascii      Text device for ASCII output.
-  devcp1047     EBCDIC device.
+  mm            The groff memorandum macro package.
+  mom           Peter Schaffter's "mom", a friendly groff macro package.
+  pdfmark       Add PDF marks to groff documents; includes "pdfroff",
+                which eases creation of PDF documents.
+  pic2graph     Convert pic(1) diagrams into graphical images.
+  rfc1345       Use RFC 1345 mnemonics as groff special characters.
+  sboxes        Use bordered, shaded background boxes with ms and PDF.
+
+./doc           Manuals for various components of groff.
+
+./font          Device and font description files.
+  devX100       100dpi X11 device (10 point base type size).
+  devX100-12    100dpi X11 device (12 point base type size).
+  devX75        75dpi X11 device (10 point base type size).
+  devX75-12     75dpi X11 device (12 point base type size).
+  devascii      Terminal device with ASCII (ISO 646) encoding.
+  devcp1047     Terminal device with EBCDIC (code page 1047) encoding.
   devdvi        TeX DVI device.
   devhtml       HTML device.
-  devlatin1     Text device for latin-1 (ISO 8859-1) output.
-  devlbp        Device for Canon CAPSL laser printers.
-  devlj4        Device for HP Laserjet 4, PCL 5, and compatible printers.
+  devlatin1     Terminal device with ISO Latin-1 (8859-1) encoding.
+  devlbp        Canon CaPSL laser printers.
+  devlj4        HP LaserJet 4/PCL 5 and compatible printers.
   devps         PostScript device.
   devpdf        PDF device.
-  devutf8       Text device for Unicode output.
-  util          Utility programs.
+  devutf8       Terminal device with UTF-8 encoding.
+  scripts       Scripts used in generation of device/font descriptions.
+  util          Tools to aid groff developers with new device support.
 
-./m4            M4 macro files used creating the configure script.
+./m4            M4 macro files used to create the "configure" script.
 
-./man           Some groff manual pages of more general character.
+./man           groff manual pages of general applicability.
 
-./src           Everything written in programming languages.
+./src           groff programs and libraries.
 
-./src/devices   The postprocessors.
-  grodvi        TeX DVI output.
-  grohtml       HTML output.
-  grolbp        Canon printers.
-  grolj4        HP Laserjet 4, PCL 5, and compatible printers.
-  grops         PostScript output.
-  gropdf        PDF output.
-  grotty        Text output.
-  xditview      A groff (pre)viewer for the X Window system.
+./src/devices   Output drivers for devices and file formats.
+  grodvi        TeX DVI.
+  grohtml       HTML.
+  grolbp        Canon CaPSL laser printers.
+  grolj4        HP LaserJet 4/PCL 5 and compatible printers.
+  grops         PostScript.
+  gropdf        PDF.
+  grotty        Terminal output.
+  xditview      A troff output (pre)viewer for the X Window System.
 
-./src/include   The *.h C/C++ include files.
+./src/include   C/C++ header files.
 
-./src/libs      C++ code common to several parts of the groff sources.
-  gnulib        Auxiliary functions copied from the `gnulib' repository.
-  libbib        Library of bibliographic functions.
-  libdriver     Parser for intermediate output and postprocessor code.
-  libgroff      Library for general support functions used everywhere.
-  libxutil      Utility functions for xditview and xtotroff.
+./src/libs      C++ code shared among several groff components.
+  libbib        Manage bibliographic database.
+  libdriver     Parse troff output; also output utility functions.
+  libgroff      General support functions used everywhere.
+  libxutil      Utility functions for gxditview and xtotroff.
 
 ./src/preproc   Preprocessors.
-  eqn           Mathematical formulae.
-  grn           Gremlin pictures.
-  html          The preprocessor part of grohtml.
-  pic           Diagram drawer.
-  preconv       Input encoding conversion.
-  refer         Bibliographic references.
-  soelim        File inclusion using tmac path.
-  tbl           Tables.
-
-./src/roff      Front-end programs.
-  groff         Wrapper around troff.  This is the main user program.
-  grog          Guess groff command line options.
-  nroff         Emulate classical nroff text formatter.
-  troff         Main roff formatter program.
-
-./src/utils     Utility programs around groff.
-  addftinfo     Add information to old troff font files for use with groff.
+  eqn           Typeset mathematical formulae.
+  grn           Draw Gremlin pictures.
+  html          Prepare tbl and eqn input for grohtml.
+  pic           Draw diagrams.
+  preconv       Convert document input encoding for input to troff.
+  refer         Generate bibliographic references.
+  soelim        Expose 'so' (sourced) documents to preprocessing.
+  tbl           Lay out tables.
+
+./src/roff      Programs that run the formatter.
+  groff         troff wrapper.  This is the main user program.
+  nroff         groff wrapper convenient for terminal users.
+  troff         Formatter.
+
+./src/utils     Utility programs relevant to groff.
+  addftinfo     Supplement AT&T troff font descriptions with metrics
+                groff requires.
   afmtodit      Create font description files for the PostScript device.
-  hpftodit      Create font description files for the LJ4 device.
+  grog          Guess groff command-line options required by a document.
+  hpftodit      Create font description files for the 'lj4' device.
   indxbib       Make inverted index for bibliographic databases.
   lkbib         Search bibliographic databases.
   lookbib       Interactively search bibliographic databases.
-  pfbtops       Translate a PostScript font in PFB format to PFA.
+  pfbtops       Translate a PostScript Type 1 font in PFB format to PFA.
   tfmtodit      Create font description files for TeX DVI device.
-  xtotroff      Create font description files for xditview.
+  xtotroff      Create font description files for gxditview.
 
 ./tmac          Macro files.
+  mdoc          Modules for the mdoc package.
+
+Various directories contain a "tests" subdirectory.  These are automated
+tests performed when groff's Makefile is run with the "check" target.
 
 
 3) Documentation
 
-The groff documentation is scattered upon several places.
+groff documentation is spread throughout the tree; where possible, it is
+close to the source code it describes.
 
-- The main directory contains documents related to the groff source.
-  The README file contains the information needed to get the groff
-  package, report bugs, and contact the developers.
+- The top-level directory contains text files presenting groff as a
+  software project, with its focus on organization of the code,
+  development procedures, and project administration.
 
-- The man-page of each program (section 1) is kept in the source
-  directory of the program.
+  If you don't know where to begin, start with "README"; it contains the
+  information you will require to obtain the groff distribution archive,
+  report bugs, and contact the developers.
 
-- The man-pages for the other sections are found in `src/man'.
+- A man page for each program (for section 1 of the manual) is
+  maintained in the source directory of the program itself.
 
-- Documentation in other formats are located in the `doc' directory,
-  including the groff info file, tutorials, and manuals.
+- Extensive man pages documenting GNU roff's input language, special
+  character repertoire, differences from AT&T troff, device and font
+  description file formats, macro files, and historical and conceptual
+  background are maintained in the "man" directory.
 
-Man-pages have source files ending in `.man'.  Running `make' processes
-the files and uses `.n' as the new file extension.  In both cases it is
-difficult to quickly decide into which section the man-page shall go. 
-Here is a shell command (to be called from the top directory of the
-groff source tree) that finds all man-pages and writes the section
-number after each file name:
+- Documentation in other formats is located in the "doc" directory,
+  including groff's Texinfo manual, and tutorial and/or reference
+  manuals written using groff macro packages.
 
-  find -type f \
-  | grep '.man$' \
-  | sort \
-  | xargs grep -e '^.TH ' \
-  | sed -e 's/^$.\+$: *\.TH.*@MAN$.*$EXT@.*$/\1 \2/'
+- Documentation for contributed components is kept in the relevant
+  subdirectory of "contrib".
 
 
-4) The roff parser
+4) groff language parser
 
-The parsing of the roff language is done by troff.  The input is converted
-to tokens in `src/roff/troff/input.cpp' and transformed into `nodes' by
-`src/roff/troff/env.cpp' and `src/roff/troff/node.cpp'.  From these, the
-intermediate output is generated (also in `node.cpp').
+The "troff" program in "src/roff/troff" parses the groff input language.
+There, "input.cpp" implements the main loop and tokenizes input.  Input
+tokens are transformed into nodes (a GNU troff internal data structure)
+by "env.cpp" and "node.cpp".  Routines in the latter file generate the
+page description language from lists of nodes.
 
 
-5) Postprocessing
+5) page description language parser
 
-The parser for the intermediate output and the postprocessing is in
-`src/libs/libdriver/input.cpp'.  This is used by all postprocessors.
+The parser for the page description language produced by troff is
+implemented in "src/libs/libdriver/input.cpp".  This is used by all
+groff output drivers written in C++.  ("gropdf", written in Perl,
+performs its own parsing.)
 
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set expandtab textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/MORE.STUFF -> _service:tar_scm:groff-1.23.0.tar.gz/MORE.STUFF Changed

@@ -1,174 +1,104 @@
-    Copyright 2000-2018 Free Software Foundation, Inc.
+    Copyright 2000-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-More stuff for groff
-====================
+Ports of groff to non-POSIX environments
+========================================
 
-Windows 32
-----------
+Microsoft Windows
+-----------------
 
-Here are two ports using the gcc compiler and other GNU tools:
+Cygwin makes a groff package available.
 
-. Cygwin:
+  https://cygwin.com/
 
-    http://sources.redhat.com/cygwin/
+Look for a convenient mirror site at the followung URL.
 
-  Look for a convenient mirror site in
+  https://cygwin.com/mirrors.html
 
-    http://sources.redhat.com/cygwin/mirrors.html
+Cygwin maintains a port status page.
 
-  At any of those mirrors, groff can be found in the directory
-  latest/groff.
+  https://cygwin.com/packages/summary/groff.html
 
-. Kees Zeelenberg <c.zeelenberg@hccnet.nl>:
+Cygwin, like most GNU/Linux distributions, separates groff build
+artifacts into multiple components, largely for dependency management.
+You may find the source package page of interest.
 
-    http://gnuwin32.sourceforge.net/packages/groffl.htm
+  https://cygwin.com/packages/summary/groff-src.html
 
-  This port includes recent versions of grap and deroff.
+The port is maintained in a Git repository.
 
-
-dos
----
-
-Binaries for Eli Zaretskii's port using the djgpp compiler are available
-from
-
-  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/gro*b.zip
-
-and its mirrors; for installation details please read `arch/djgpp/README'.
-This port also runs on Windows 32 systems, except Windows 2000.
+  https://cygwin.com/git-cygwin-packages/?p=git/cygwin-packages/groff.git
 
 
 grap
 ----
 
-An implementation of Kernighan & Bentley's grap language for typesetting
-graphs.  Written by Ted Faber <faber@lunabase.org>.  The actual version
-can be found at
+Ted Faber has written an implementation of Kernighan & Bentley's grap
+language for typesetting graphs.
 
   http://www.lunabase.org/~faber/Vault/software/grap/
 
-A djgpp port which runs on dos and most Windows 32 systems (Windows 95,
-Windows 98, Windows NT) done by Kees Zeelenberg <c.zeelenberg@hccnet.nl>
-is available from
-
-  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
-
-It is intended to be used with the djgpp port of groff.
-
-A Windows 32 port is included in the groff package available from
-
-    http://gnuwin32.sourceforge.net/
-
-
-plot2dev
---------
-
-This utility program can convert plot graphics to either pic or gremlin
-files.  It has been written by Richard Murphey <richard-murphey@rice.edu>
-and Daniel Senderowicz <daniel@synchrods.com> (who has added the gremlin
-driver).  The actual version can be found as
-
-  ftp://ftp.ffii.org/pub/groff/plot2dev-x.x.tar.gz
-
 
 troffcvt
 --------
 
-From the web page:
+Per its web page,
 
-  troffcvt is a translator that turns troff input into a form that can be
-  more easily processed.  The troffcvt distribution comes with
-  postprocessors that turn troffcvt into various destination formats such
-  as HTML (Hypertext Markup Language), RTF (Rich Text Format) or plain
-  text.
+  troffcvt is a translator that turns troff input into a form that can
+  be more easily processed.  The troffcvt distribution comes with
+  postprocessors that turn troffcvt into various destination formats
+  such as HTML (Hypertext Markup Language), RTF (Rich Text Format) or
+  plain text.
 
-Note that you need a lot of additional packages to compile troffcvt;
-everything is available from
-
-  http://www.primate.wisc.edu/software/troffcvt/
+  http://www.snake.net/software/troffcvt/
 
 
 unroff
 ------
 
-From the README file:
-
-  Unroff is a Scheme-based, programmable, extensible troff translator with
-  a back-end for the Hypertext Markup Language.  Unroff is free software
-  and is distributed both as source and as precompiled binaries.
+Per its README file,
 
-    http://www.informatik.uni-bremen.de/~net/unroff/unroff.html
+  Unroff is a Scheme-based, programmable, extensible troff translator
+  with a back-end for the Hypertext Markup Language.  Unroff is free
+  software and is distributed both as source and as precompiled
+  binaries.
 
-You need als Elk, the Scheme based Extension Language Kit, which is
-available from
+    https://www-rn.informatik.uni-bremen.de/software/unroff/
 
-  http://www.informatik.uni-bremen.de/~net/elk
 
+Haart deroff
+------------
 
-deroff
-------
-
-Deroff removes roff constructs from documents for the purpose of indexing,
-spell checking etc.
+Per its ReadMe.txt file,
 
-Michael Haardt's <michael@moria.de> implementation is a little smarter
-than traditional implementations, because it knows about certain -man and
--mm macros.  It is able to generate a word list for spell checking tools
-or omit headers for sentence analysis tools.  It can further generate
-cpp-style #line lines.
+  Deroff removes roff constructs from documents for the purpose of
+  indexing, spell checking etc. My own implementation is a little
+  smarter than traditional implementations, because it knows about
+  certain -man and -mm macros. It is able to generate a word list for
+  spell checking tools or omit headers for sentence analysis tools.
 
-  http://www.moria.de/~michael/deroff/
-
-Version 1.6 compiled with DJGPP (for MS-DOS and all Windows 32 systems,
-i.e. Windows 95, Windows 98, Windows NT) is available from
-
-  ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2apps/
-
-and its mirrors.
-
-A Windows 32 port of version 1.8 is available from
-
-  http://gnuwin32.sourceforge.net/
-
-David Frey <dfrey@debian.org> has also written a deroff implementation
-for Debian; it is available from
-
-  ftp://ftp.debian.org/debian/pool/main/d/deroff/
-
-
-texi2html
----------
-
-This package contains beta support for a backend to convert files from
-texinfo format to a troff input file (using the -me macros):
-
-  texi2html --init roff.init ...
-
-URL:
-
-  http://savannah.nongnu.org/download/texi2html/
+    https://caio.ueberalles.net/deroff/
 
 
 doclifter
 ---------
 
-doclifter lifts troff macro markup to XML-Docbook.  It doesn't do raw troff
-at all well (raw troff has insufficient structural information) but it 
-handles manual pages, ms, mm, and me markup, producing clean lifts
-to valid XML more than 96% of the time.  pic markup is translated to SVG,
-eqn markup to Presentation MathML.
+Per its web page,
 
-doclifter with the -w option behaves as a portability checker and validator,
-warning about constructs that aren't portable across *roff implementations
-and viewers.
+  doclifter lifts documents in nroff markups to XML-DocBook.
 
-It is available from
+  Lifting documents from presentation level to semantic level is hard,
+  and a really good job requires human polishing. This tool aims to do
+  everything that can be mechanized, and to preserve any troff-level
+  information that might have structural implications in XML comments.
+  This tool does the hard parts. TBL tables are translated into DocBook
+  table markup, PIC into SVG, and EQN into MathML (relying on pic2svg
+  and GNU eqn for the last two).
 
-  http://catb.org/~esr/doclifter
+    http://catb.org/~esr/doclifter
 
 
 pic2plot
@@ -180,7 +110,7 @@
   http://www.gnu.org/software/plotutils/
 
 
-miscellaneous
+Miscellaneous
 -------------
 
 . Ralph Corderoy's excellent page on troff:
@@ -198,7 +128,8 @@
   o creating business cards
   o using groff to make large format posters for presentations
 
-. Robert Marks's collection of useful macros and scripts is available from
+. Robert Marks's collection of useful macros and scripts is available
+  from
 
     http://www.agsm.edu.au/~bobm/odds+ends/scripts.html
 
@@ -207,56 +138,52 @@
   o `polish': Is a sed (= the Unix stream editor) script that does many
     things to ASCII text.  Amongst other things, it breaks lines at new
     sentences, reduces upper-case acronyms by one point size, adds
-    diacriticals, changes simple quotes into smart quotes, and makes a few
-    simple grammar checks.  The best way to see what it does is to run it
-    as a sed script file (or files) on a text file and then compare the
-    output file with the original.
+    diacriticals, changes simple quotes into smart quotes, and makes a
+    few simple grammar checks.  The best way to see what it does is to
+    run it as a sed script file (or files) on a text file and then
+    compare the output file with the original.
 
   o `DropCaps' is a troff script which replaces the initial letters of
-    paragraphs immediately after H1 and H2 headings with drop-capitals of
-    specified point size, and automatically flows the text around the new
-    drop cap.
+    paragraphs immediately after H1 and H2 headings with drop-capitals
+    of specified point size, and automatically flows the text around the
+    new drop cap.
 
   o `AJM Header' is a set of troff macros used in production of the
-    Australian Journal of Management.  They use the Memorandum Macros (mm)
-    of AT&T, and so should be invoked with the Unix troff -mm flag; they
-    should also work with the GNU troff -mm flag.
-
-. Various contributed stuff like additional font files, macro packages, and
-  documentation can be found at
+    Australian Journal of Management.  They use the Memorandum Macros
+    (mm) of AT&T, and so should be invoked with the Unix troff -mm flag;
+    they should also work with the GNU troff -mm flag.
 
-    http://groff.ffii.org/groff/contrib/
-
-. Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a tbl
-  postprocessor to manipulate table cells (like adding gray shades).  The
-  latest version can be found at
+. Thomas Baruchel <baruchel@libertysurf.fr> has developed Meta-tbl, a
+  tbl postprocessor to manipulate table cells (like adding gray shades).
+  The latest version can be found at
 
     http://perso.libertysurf.fr/baruchel/
 
-. gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the README
-  file:
+. gpresent, written by Bob Diertens <bobd@science.uva.nl>.  From the
+  README file:
+
+    gpresent is a package for making presentation with groff and
+    acroread.  It consist of a set of macros to be used with groff and a
+    post-processor for manipulating the PostScript output of groff.
+    Without the use of the PAUSE macro, it can also be used for making
+    slides.
 
-    gpresent is a package for making presentation with groff and acroread.
-    It consist of a set of macros to be used with groff and a post-processor
-    for manipulating the PostScript output of groff.  Without the use of the
-    PAUSE macro, it can also be used for making slides.
-    
   It is available from
 
     www.science.uva.nl/~bobd/useful/gpresent/
 
 
-documentation
+Documentation
 -------------
 
-Many documents related to the original versions of troff, ditroff, pic,
-and others can be accessed from the following web pages:
+Documentation of the AT&T implementations of the troff, tbl, pic, eqn,
+and refer programs can be found at the following site.
 
-  http://www.cs.bell-labs.com/cm/cs/cstr.html
-  http://www.cs.bell-labs.com/cm/cs/papers.html
-  http://troff.org
+  https://www.troff.org/papers.html
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/Makefile.am -> _service:tar_scm:groff-1.23.0.tar.gz/Makefile.am Changed

@@ -1,9 +1,7 @@
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+# Copyright (C) 1989-2023 Free Software Foundation, Inc.
 # Original Makefile.in written by James Clark (jjc@jclark.com)
 # Migrated to Automake by Bertrand Garrigues
 #
-# Last update: 2017-11-02
-#
 # This file is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it under
@@ -11,8 +9,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -182,7 +180,7 @@
 # `localfontdir' says where local fonts will be installed (as dev*/*).
 localfontdir=$(dataprogramdir)/site-font
 
-# `legacyfontdir' is for compatibility with non-GNU troff.
+# `legacyfontdir' is for compatibility with AT&T/DWB troff.
 legacyfontdir=/usr/lib/font
 
 # `fontpath' says where to look for dev*/*.
@@ -197,13 +195,11 @@
 # `localtmacdir' says where local files will be installed.
 localtmacdir=$(dataprogramdir)/site-tmac
 
-# appresdir
-# `appresdir' says where to install the application resource file for
+# appdefdir
+# `appdefdir' says where to install the application defaults file for
 # gxditview.
 
-# groffer_dir
 # glilypond_dir
-# grog_dir
 # gpinyin_dir
 
 # `tmacpath' says where to look for macro files.
@@ -280,7 +276,7 @@
   fi`
 
 # Extension to be used for refer index files.  Index files are not
-# sharable between different architectures, so you might want to use
+# shareable between different architectures, so you might want to use
 # different suffixes for different architectures.  Choose an extension
 # that doesn't conflict with refer or any other indexing program.
 indexext=.i
@@ -312,47 +308,18 @@
 man7ext=7
 man7dir=$(manroot)/man$(man7ext)
 
-# doc_dist_target_ok
-# `dist' target is disallowed in some `configure' combinations.
-
-# The configure script checks whether the user wants the info documentation.
-# For the repo version this mechanism also suppresses building via `makeinfo'.
-# make_infodoc
-# make_install_infodoc
-# make_uninstall_infodoc
-
 # The configure script checks whether all necessary utility programs for
-# grohtml are available -- only then we can build the HTML documentation.
+# grohtml are available -- only then can we build the HTML documentation.
 # make_htmldoc
 # make_install_htmldoc
 # make_uninstall_htmldoc
 
-# make_htmlexamples
-# make_install_htmlexamples
-# make_uninstall_htmlexamples
-
 # The configure script also checks whether all necessary utility programs
-# for pdfroff are available -- only then we can build PDF documentation.
+# for pdfroff are available -- only then can we build PDF documentation.
 # make_pdfdoc
 # make_install_pdfdoc
 # make_uninstall_pdfdoc
 
-# make_pdfexamples
-# make_install_pdfexamples
-# make_uninstall_pdfexamples
-
-# `other' documentation, e.g., `meref.me' and `pic.ms', as well as their
-# generated counterparts..
-# make_otherdoc
-# make_install_otherdoc
-# make_uninstall_otherdoc
-
-# `examples' -- a generic switch, but the generated examples are furtherly
-# subdivided to catch HTML and PDF production availability.
-# make_examples
-# make_install_examples
-# make_uninstall_examples
-
 # Windows `.cmd' files
 # make_winscripts
 # make_install_winscripts
@@ -445,10 +412,6 @@
 # uintmax_t=<value>		define to `unsigned long' or `unsigned long
 #				long' if <inttypes.h> does not exist
 #
-# TRADITIONAL_CPP		if your C++ compiler uses a traditional
-#				(Reiser) preprocessor
-# ARRAY_DELETE_NEEDS_SIZE	if your C++ doesn't understand `delete '
-#
 # PAGE=A4			if the printer's page size is A4
 # GHOSTSCRIPT=gs		the name (and directory if required) of the
 #				ghostscript program
@@ -486,6 +449,7 @@
 # LIBS
 # LIBM
 # LIBICONV
+# AR
 # RANLIB
 # INSTALL
 # INSTALL_PROGRAM
@@ -494,7 +458,6 @@
 # INSTALL_INFO
 # LN_S
 
-AR=ar
 ETAGS=etags
 ETAGSFLAGS=
 # Flag that tells etags to assume C++.
@@ -537,14 +500,15 @@
 GROFF_V_ = $(GROFF_V_@AM_DEFAULT_V@)
 GROFF_V_0 = @echo "  GROFF   " $@;
 
-# The following Automake variables will be overloaded by the various
-# .am files
+# The following Automake variables will be supplemented by the various
+# .am files.
 bin_PROGRAMS =
 nobase_bin_PROGRAMS =
 bin_SCRIPTS =
 dist_bin_SCRIPTS =
+# stuff that should be in distribution archives but not in source repo
+MAINTAINERCLEANFILES =
 MOSTLYCLEANFILES =
-MOSTLYCLEANADD =
 noinst_LIBRARIES =
 BUILT_SOURCES =
 CLEANFILES =
@@ -565,6 +529,7 @@
 check_SCRIPTS =
 check_PROGRAMS =
 TESTS =
+XFAIL_TESTS =
 AM_TESTS_ENVIRONMENT = \
   abs_top_srcdir=$(abs_top_srcdir) \
   abs_top_builddir=$(abs_top_builddir) \
@@ -578,7 +543,7 @@
 # This is done by the m4 macro GROFF_G that checks for the presence of
 # GNU Troff built-in \n.g macro. If a Unix Troff binary was
 # detected, the following programs and scripts names will have a 'g'
-# prefix: chem, tbl, eqn, neqn, pic, soleimm grn, refer, lookbib,
+# prefix: chem, tbl, eqn, neqn, pic, soelim, grn, refer, lookbib,
 # troff, nroff. Also, PROG_PREFIX will be set to 'g' in the generated
 # header defs.h so that these programs could be called correctly.
 #
@@ -589,9 +554,9 @@
 prefixexecbin_PROGRAMS =
 prefixexecbin_SCRIPTS =
 if USEPROGRAMPREFIX
-# We use datadir because the uninstall rule for the PROGRAMS attempt
+# We use datadir because the uninstall rule for the PROGRAMS attempts
 # to cd into prefixexecbindir, and thus if prefixexecbindir is removed
-# two consecutive uninstall would fail
+# two consecutive uninstalls would fail
 prefixexecbindir = $(datadir)
 else
 prefixexecbindir = $(bindir)
@@ -602,13 +567,13 @@
 GROFFBIN = $(abs_top_builddir)/groff
 GROFF_BIN_PATH = $(abs_top_builddir)
 PDFMOMBIN = $(abs_top_builddir)/pdfmom
-# The second directories are needed for the case "cd build; ../configure".
+# Search for macro files and device/font description directories in
+# source _and_ build trees; some of each are generated.
 FFLAG=-F$(abs_top_builddir)/font -F$(abs_top_srcdir)/font
-TFLAG=-M$(abs_top_builddir)/tmac -M$(abs_top_srcdir)/tmac
+MFLAG=-M$(abs_top_builddir)/tmac -M$(abs_top_srcdir)/tmac
 
-# make builtin variable RM
-if MAKE_DONT_HAVE_RM
-RM = rm -f
+if !MAKE_DEFINES_RM
+RM=rm -f
 endif
 
 # 'VERSION' is generated by gnulib script git-version-gen, using the
@@ -654,13 +619,13 @@
 include $(top_srcdir)/contrib/gperl/gperl.am
 include $(top_srcdir)/contrib/gpinyin/gpinyin.am
 include $(top_srcdir)/contrib/grap2graph/grap2graph.am
-include $(top_srcdir)/contrib/groff_filenames/groff_filenames.am
-include $(top_srcdir)/contrib/groffer/groffer.am
 include $(top_srcdir)/contrib/hdtbl/hdtbl.am
 include $(top_srcdir)/contrib/mm/mm.am
 include $(top_srcdir)/contrib/mom/mom.am
 include $(top_srcdir)/contrib/pdfmark/pdfmark.am
 include $(top_srcdir)/contrib/pic2graph/pic2graph.am
+include $(top_srcdir)/contrib/rfc1345/rfc1345.am
+include $(top_srcdir)/contrib/sboxes/sboxes.am
 include $(top_srcdir)/doc/doc.am
 include $(top_srcdir)/font/devX100/devX100.am
 include $(top_srcdir)/font/devX100-12/devX100-12.am
@@ -700,11 +665,11 @@
 include $(top_srcdir)/src/preproc/soelim/soelim.am
 include $(top_srcdir)/src/preproc/tbl/tbl.am
 include $(top_srcdir)/src/roff/groff/groff.am
-include $(top_srcdir)/src/roff/grog/grog.am
 include $(top_srcdir)/src/roff/nroff/nroff.am
 include $(top_srcdir)/src/roff/troff/troff.am
 include $(top_srcdir)/src/utils/addftinfo/addftinfo.am
 include $(top_srcdir)/src/utils/afmtodit/afmtodit.am
+include $(top_srcdir)/src/utils/grog/grog.am
 include $(top_srcdir)/src/utils/hpftodit/hpftodit.am
 include $(top_srcdir)/src/utils/indxbib/indxbib.am
 include $(top_srcdir)/src/utils/lkbib/lkbib.am
@@ -718,13 +683,13 @@
 # make all or make check before all other targets. However, if another
 # target is built from a clean build tree, (for example make groff)
 # the files in BUILT_SOURCES will not be built first. That is why
-# additional dependencies where added in the .am files that lists
-# objects that use defs (for exmaple in groff.am:
+# additional dependencies were added in the .am files that list
+# objects that use defs (for example in groff.am:
 # src/roff/groff/groff.$(OBJEXT): defs.h)
 BUILT_SOURCES += defs.h
 
-# Force generation of test-groff even though we don't ship it.
-BUILT_SOURCES += test-groff
+.DELETE_ON_ERROR:
+.PRECIOUS: $(TEST_SUITE_LOG)
 
 # if there is a name prefix we install the man pages by hand
 all: generate_man_files
@@ -797,9 +762,6 @@
 	  fi; \
 	  rmdir $(DESTDIR)$(dataprogramdir); \
 	fi
-	if test -d $(DESTDIR)$(grog_dir); then \
-	  rmdir $(DESTDIR)$(grog_dir); \
-	fi
 	if test -d $(DESTDIR)$(libprogramdir); then \
 	  if test -d $(DESTDIR)$(systemtmacdir); then \
 	    rm -f $(DESTDIR)$(systemtmacdir)/*; \
@@ -812,6 +774,12 @@
 	    rmdir $(DESTDIR)$(exampledir); \
 	  fi; \
 	  if test -d $(DESTDIR)$(htmldocdir); then \
+	    if test -d $(DESTDIR)$(htmldocdir)/groff.html.mono; then \
+	      rmdir $(DESTDIR)$(htmldocdir)/groff.html.mono; \
+	    fi; \
+	    if test -d $(DESTDIR)$(htmldocdir)/groff.html.node; then \
+	      rmdir $(DESTDIR)$(htmldocdir)/groff.html.node; \
+	    fi; \
 	    rmdir $(DESTDIR)$(htmldocdir); \
 	  fi; \
 	  rmdir $(DESTDIR)$(docdir); \
@@ -838,9 +806,11 @@
   ChangeLog.119 \
   ChangeLog.120 \
   ChangeLog.121 \
+  ChangeLog.122 \
   FDL \
   FOR-RELEASE \
   gendef.sh \
+  HACKING \
   INSTALL.REPO \
   INSTALL.extra \
   LICENSES \
@@ -856,8 +826,7 @@
 
 MOSTLYCLEANFILES += $(prefixexecbin_SCRIPTS) $(bin_SCRIPTS) \
   $(man1_MANS) $(man5_MANS) $(man7_MANS) \
-  $(PREFIXMAN1) \
-  test-groff
+  $(PREFIXMAN1)
 
 # Suffix rule to build .1, .5 and .7 files from .1.man, .5.man and
 # .7.man files.  The brackets around the @ are used to prevent the
@@ -883,30 +852,33 @@
 # because a command substitution is being nested inside yet another
 # invocation of sed.
 #
-# * For this target; no assurances about the good behavior of unusual
+# * For this target, no assurances about the good behavior of unusual
 #   characters in Makefile variables in other aspects of the groff build
 #   are offered.
+#
+# COMPATIBILITY_WRAPPERS is intended only for use in conditional
+# expressions in man pages (to see if the legacy macro package wrappers
+# feature is enabled) and not for expansion as formatted text.
 makevarescape=$(top_srcdir)/makevarescape.sed
 
 SUFFIXES += .man
 .man:
-	$(AM_V_GEN)rm -f $@ \
-	&& $(MKDIR_P) `dirname $@` \
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& LC_ALL=C \
-	 sed -e "s|@APPRESDIR@|`echo $(appresdir) | sed -f $(makevarescape)`|g" \
+	 sed -e "s|@APPDEFDIR@|`echo $(appdefdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@BINDIR@|`echo $(bindir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@COMMON_WORDS_FILE@|`echo $(common_words_file) | sed -f $(makevarescape)`|g" \
+	     -e "s|@COMPATIBILITY_WRAPPERS@|$(compatibility_wrappers)|g" \
 	     -e "s|@DATASUBDIR@|`echo $(datasubdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@DEFAULT_INDEX@|`echo $(indexdir)/$(indexname) | sed -f $(makevarescape)`|g" \
 	     -e "s|@DEFAULT_INDEX_NAME@|`echo $(indexname) | sed -f $(makevarescape)`|g" \
-	     -e "s|@DEVICE@|$(DEVICE)|g" \
+	     -e "s|@DEVICE@|\\\\%$(DEVICE)|g" \
 	     -e "s|@DOCDIR@|`echo $(docdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@EXAMPLEDIR@|`echo $(exampledir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@FONTDIR@|`echo $(fontdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@g@|$(g)|g" \
-	     -e "s!@G@!`echo $(g) | tr 'a-z' 'A-Z'`!g" \
+	     -e "s|@g@|\\\\%$(g)|g" \
 	     -e "s|@HTMLDOCDIR@|`echo $(htmldocdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@INDEX_SUFFIX@|$(indexext)|g" \
+	     -e "s|@INDEX_SUFFIX@|\\\\%$(indexext)|g" \
 	     -e "s|@LEGACYFONTDIR@|`echo $(legacyfontdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@LOCALFONTDIR@|`echo $(localfontdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@LOCALMACRODIR@|`echo $(localtmacdir) | sed -f $(makevarescape)`|g" \
@@ -916,17 +888,19 @@
 	     -e "s|@MAN7EXT@|$(man7ext)|g" \
 	     -e "s|@MDATE@|`$(PERL) $(top_srcdir)/mdate.pl $<`|g" \
 	     -e "s|@OLDFONTDIR@|`echo $(oldfontdir) | sed -f $(makevarescape)`|g" \
+	     -e "s|@PAGE@|\\\\%$(PAGE)|g" \
 	     -e "s|@PDFDOCDIR@|`echo $(pdfdocdir) | sed -f $(makevarescape)`|g" \
+	     -e "s|@PSPRINT@|`echo $(PSPRINT) | sed -f $(makevarescape)`|g" \
 	     -e "s|@SYSTEMMACRODIR@|`echo $(systemtmacdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@TMAC_AN_PREFIX@|$(tmac_an_prefix)|g" \
-	     -e "s|@TMAC_M_PREFIX@|$(tmac_m_prefix)|g" \
-	     -e "s|@TMAC_MDIR@|$(tmacdir)/mm|g" \
-	     -e "s|@TMAC_S_PREFIX@|$(tmac_s_prefix)|g" \
+	     -e "s|@TMAC_AN_PREFIX@|\\\\%$(tmac_an_prefix)|g" \
+	     -e "s|@TMAC_M_PREFIX@|\\\\%$(tmac_m_prefix)|g" \
+	     -e "s|@TMAC_MDIR@|`echo $(tmacdir) | sed -f $(makevarescape)`/mm|g" \
+	     -e "s|@TMAC_S_PREFIX@|\\\\%$(tmac_s_prefix)|g" \
 	     -e "s|@VERSION@|$(VERSION)|g" \
 	     $< \
 	     >$@
 
-# Version files - see script 'build-aux/git-gen-version'
+# Version files - see script 'build-aux/git-version-gen'
 EXTRA_DIST += $(top_srcdir)/.version
 BUILT_SOURCES += $(top_srcdir)/.version
 $(top_srcdir)/.version:
@@ -934,8 +908,8 @@
 dist-hook:
 	echo $(VERSION) > $(distdir)/.tarball-version
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/Makefile.in -> _service:tar_scm:groff-1.23.0.tar.gz/Makefile.in Changed

@@ -1,7 +1,7 @@
-# Makefile.in generated by automake 1.16.1 from Makefile.am.
+# Makefile.in generated by automake 1.16.5 from Makefile.am.
 # @configure_input@
 
-# Copyright (C) 1994-2018 Free Software Foundation, Inc.
+# Copyright (C) 1994-2021 Free Software Foundation, Inc.
 
 # This Makefile.in is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -14,12 +14,10 @@
 
 @SET_MAKE@
 
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+# Copyright (C) 1989-2023 Free Software Foundation, Inc.
 # Original Makefile.in written by James Clark (jjc@jclark.com)
 # Migrated to Automake by Bertrand Garrigues
 #
-# Last update: 2017-11-02
-#
 # This file is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it under
@@ -27,8 +25,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -59,11 +57,11 @@
 # or
 #    CPU_TYPE-MANUFACTURER-KERNEL-OPERATING_SYSTEM
 
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2023 Free Software Foundation, Inc.
 #
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This file is distributed in the hope that it will be useful,
@@ -89,27 +87,46 @@
 #  --tests-base=tests \
 #  --aux-dir=build-aux \
 #  --makefile-name=gnulib.mk \
+#  --automake-subdir \
 #  --no-conditional-dependencies \
 #  --no-libtool \
 #  --macro-prefix=gl \
 #  fprintf-posix \
 #  git-version-gen \
 #  havelib \
-#  non-recursive-gnulib-prefix-hack \
 #  snprintf \
+#  stdbool-c99 \
+#  stdint \
 #  vsnprintf \
 #  wcwidth
 
-# Automake rules for 'chem'
+# Copyright (C) 2004-2023 Free Software Foundation, Inc.
+# Original Makefile.sub written by Keith Marshall
+#   <keith.d.marshall@ntlworld.com>.
+# Adapted to Automake by Bertrand Garrigues
+#   <bertrand.garrigues@laposte.net>.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# File position: <groff-source>/contrib/chem/chem.am
+# Automake rules for 'chem'
 
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# Copyright (C) 2006-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Moved to automake by Bertrand Garrigues
 #
-# Last update: 22 Aug 2015
-#
 # This file is part of 'chem' which is part of 'groff'.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -126,9 +143,7 @@
 
 ########################################################################
 
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2002-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -150,14 +165,10 @@
 
 # Automake rules for 'gdiffmk' (integration into the groff source tree)
 #
-# File position: <groff-source>/contrib/gdiffmk/gdiffmk.am
-#
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
+# Copyright (C) 2004-2020 Free Software Foundation, Inc.
 # Written by Mike Bianchi <MBianchi@Foveal.com <mailto:MBianchi@Foveal.com>>
 # Automake migration by Bertrand Garrigues
 #
-# Last update: 20 Aug 2015
-#
 # This file is part of the gdiffmk utility, which is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it
@@ -175,15 +186,11 @@
 
 # Automake rules for 'glilypond'
 
-# File position: <groff-source>/contrib/lilypond/glilypond.am
-
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
+# Copyright (C) 2013-2020 Free Software Foundation, Inc.
 # Written by Werner Lemberg <wl@gnu.org> and
 # Bernd Warken <groff-bernd.warken-72@web.de>.
 # Automake migration by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'glilypond' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -201,14 +208,10 @@
 
 # Automake rules for 'gperl' (preprocessor for added Perl parts)
 
-# File position: <groff-source>/contrib/gperl/gperl.am
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Automake migration by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'gperl' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -229,14 +232,10 @@
 
 # Automake rules for 'gpinyin' (preprocessor for added Perl parts)
 
-# File position: <groff-source>/contrib/gpinyin/gpinyin.am
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Moved to automake by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'gpinyin' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -255,9 +254,7 @@
 
 ########################################################################
 
-# Copyright (C) 2003-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2003-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -277,86 +274,27 @@
 # grap2graph.am
 #
 
-# Automake rules for 'groff_filenames'
-
-# File position: <groff-source>/contrib/groff_filenames/groff_filenames.am
-
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
-
-# Last update: 22 Aug 2015
-
-# Written by Bernd Warken <groff-bernd.warken-72@web.de>.
-# Automake migration by Bertrand Garrigues
-
-# 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
-# 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
-# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-########################################################################
-
-# Automake rules for 'groffer'
-
-# File position: <groff-source>/contrib/groffer/groffer.am
-
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
-# Written by Werner Lemberg <wl@gnu.org> and
-# Bernd Warken <groff-bernd.warken-72@web.de>.
-# Automake migration by Bertrand Garrigues
-
-# Last update: 22 Aug 2015
-
-# This file is part of 'groffer' 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 2 of the License, or
-# (at your option) any later version.
-
-# '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 this program.  If not, see
-# <http://www.gnu.org/licenses/gpl-2.0.html>.
-
-########################################################################
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-#      Written by Werner Lemberg (wl@gnu.org)
+# Copyright (C) 2006-2020 Free Software Foundation, Inc.
+#      Written by Werner Lemberg <wl@gnu.org>
 #      Automake migration by Bertrand Garrigues
-#
+#        <bertrand.garrigues@laposte.net>
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright 1991-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright 1991-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -376,32 +314,30 @@
 # mm.am
 #
 
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
-#      Written by Werner Lemberg (wl@gnu.org)
+# Copyright (C) 2002-2020 Free Software Foundation, Inc.
+#      Written by Werner Lemberg <wl@gnu.org>
 #      Automake migration by Bertrand Garrigues
-#
+#        <bertrand.garrigues@laposte.net>
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2005-2018 Free Software Foundation, Inc.
+# Copyright (C) 2005-2021 Free Software Foundation, Inc.
 #      Written by Keith Marshall (keith.d.marshall@ntlworld.com)
 #      Automake migration by Bertrand Garrigues
 #
-# Last update: 22 Aug 2015
-#
 # This file is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it under
@@ -417,9 +353,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2001-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -439,11 +373,25 @@
 # pic2graph.am
 #
 
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
-#      Original Makefile.sub written by Werner Lemberg <wl@gnu.org>
-#      Automake migration by 
-#      Bertrand Garrigues <bertrand.garrigues@laposte.net>
+# Copyright 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#      Written by Bertrand Garrigues <bertrand.garrigues@laposte.net>
 #
 # This file is part of groff.
 #
@@ -452,17 +400,35 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2022 Free Software Foundation, Inc.
+# Original Makefile.sub written by Werner Lemberg <wl@gnu.org>.
+# Adapted to Automake by Bertrand Garrigues
+#   (bertrand.garrigues@laposte.net).
 #
-# Last update: 13 Aug 2015
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -479,9 +445,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -498,9 +462,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -517,9 +479,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -536,9 +496,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -555,9 +513,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -574,9 +530,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -593,9 +547,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -612,9 +564,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -631,9 +581,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -650,9 +598,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -669,12 +615,10 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
-#      Original Makefile.sub written
-#      by Deri James <deri@chuzzlewit.demon.co.uk>
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
+#      Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #      Automake migration by Bertrand Garrigues
-#
-# Last update: 2017-11-02
+#        <bertrand.garrigues@laposte.net>
 #
 # This file is part of groff.
 #
@@ -691,9 +635,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -710,9 +652,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -729,9 +669,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2015-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2015-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -748,9 +686,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -769,11 +705,7 @@
 
 # Automake rules for 'include'
 #
-# File position: <groff-source>/src/include/include.am
-#
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -793,11 +725,7 @@
 
 # Automake rules for 'libbib'
 #
-# File position: <groff-source>/src/libs/libbib/libbib.am
-#
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -817,11 +745,7 @@
 
 # Automake rules for 'libdriver'
 #
-# File position: <groff-source>/src/libs/libdriver/libdriver.am
-#
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -839,19 +763,17 @@
 #
 ########################################################################
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -860,11 +782,7 @@
 
 # Automake rules for 'libxutil'
 #
-# File position: <groff-source>/src/libs/libxutil/libxutil.am
-#
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -882,9 +800,7 @@
 #
 ########################################################################
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -901,9 +817,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -920,9 +834,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -939,9 +851,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -958,12 +868,10 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
-#  Original Makefile.sub written by Deri James <deri@chuzzlewit.demon.co.uk>.
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
+#  Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #  Automake migration by Bertrand Garrigues
 #
-# Last update: 22 Aug 2015
-#
 # This file is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it under
@@ -979,9 +887,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -998,9 +904,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2021 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1017,47 +921,41 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1066,17 +964,15 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1093,9 +989,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1112,9 +1006,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1123,17 +1015,15 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1142,17 +1032,15 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1169,9 +1057,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1180,56 +1066,31 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
+# Copyright (C) 1993-2020 Free Software Foundation, Inc.
 #
-#   Original Makefile.sub rewritten by 
+#   Original Makefile.sub rewritten by
 #   Bernd Warken <groff-bernd.warken-72@web.de>
 #   and Werner LEMBERG <wl@gnu.org>
 #
-#   Automake migration by 
+#   Automake migration by
 #   Bertrand Garrigues <bertrand.garrigues@laposte.net>
 #
-# Latest update: 22 Aug 2015
-#
-# '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
-# (at your option) any later version.
-#
-# '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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
-########################################################################
-
-# grog.am for 'grog'
-#
-# File position: <groff-source>/src/roff/grog/grog.am
-#
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
-#
-# This file is part of 'grog' which is part of 'groff'.
+# This file is part of groff.
 #
-# 'groff' is free software; you can redistribute it and/or modify it
+# 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
 # (at your option) any later version.
 #
-# 'groff' is distributed in the hope that it will be useful, but
+# 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.
@@ -1237,38 +1098,34 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -1277,11 +1134,7 @@
 
 # Automake rules for 'src utils addftinfo'
 #
-# File position: <groff-source>/src/utils/addftinfo/addftinfo.am
-#
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -1301,11 +1154,7 @@
 
 # Automake rules for 'src utils afmtodit'
 #
-# File position: <groff-source>/src/utils/afmtodit/afmtdodit.am
-#
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2013-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1324,13 +1173,26 @@
 #
 ########################################################################
 
-# Automake rules for 'src utils hpftodit'
+# Copyright (C) 1993-2021 Free Software Foundation, Inc.
 #
-# File position: <groff-source>/src/utils/hpftodit/hpftodit.am
+# This file is part of groff.
 #
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# 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 (at your
+# option) any later version.
 #
-# Latest update: 22 Aug 2015
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+# Automake rules for 'src utils hpftodit'
+#
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
@@ -1348,9 +1210,7 @@
 #
 ########################################################################
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1367,9 +1227,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1386,9 +1244,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1405,9 +1261,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1424,9 +1278,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1443,9 +1295,7 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -1462,6 +1312,26 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
+# Copyright (C) 1989-2020 Free Software Foundation, Inc.
+#      Written by James Clark <jjc@jclark.com>
+#      Automake migration by Bertrand Garrigues
+#        <bertrand.garrigues@laposte.net>
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
 
 
 
@@ -1550,37 +1420,38 @@
 prefixexecbin_PROGRAMS = eqn$(EXEEXT) grn$(EXEEXT) pic$(EXEEXT) \
 	refer$(EXEEXT) soelim$(EXEEXT) tbl$(EXEEXT) troff$(EXEEXT) \
 	indxbib$(EXEEXT) lookbib$(EXEEXT)
-@LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE@am__append_1 = lib/uniwidth/width.c
-@BUILD_WINSCRIPTS_TRUE@am__append_2 = $(WINSCRIPTS)
-@BUILD_WINSCRIPTS_FALSE@am__append_3 = $(WINSCRIPTS)
-@BUILD_EXAMPLES_FALSE@am__append_4 = $(HDTBLEXAMPLEFILES) 
-@BUILD_EXAMPLES_TRUE@am__append_5 = $(hdtbl_TESTS)
-@BUILD_EXAMPLES_TRUE@am__append_6 = $(hdtbl_TESTS)
-@BUILD_EXAMPLES_FALSE@am__append_7 = $(MOMEXAMPLEFILES)
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@am__append_8 = $(mom_TESTS)
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@am__append_9 = $(mom_TESTS)
-@BUILD_PDFDOC_TRUE@am__append_10 = $(PDFDOCFILES)
-@BUILD_PDFDOC_FALSE@am__append_11 = $(PDFDOCFILES)
-@BUILD_OTHERDOC_TRUE@am__append_12 = $(PROCESSEDDOCFILES)
-@BUILD_OTHERDOC_FALSE@am__append_13 = $(DOCFILES)
-@BUILD_PDFDOC_TRUE@am__append_14 = doc/automake.pdf
-@BUILD_EXAMPLES_TRUE@am__append_15 = $(PROCESSEDEXAMPLEFILES)
-@BUILD_EXAMPLES_FALSE@am__append_16 = $(EXAMPLEFILES)
-@BUILD_INFODOC_TRUE@am__append_17 = doc/groff.info doc/groff.info-2 doc/groff.info-2
-@WITHOUT_X11_FALSE@am__append_18 = libxutil.a
-@WITHOUT_X11_TRUE@am__append_19 = $(GXDITVIEWSOURCES)
-@WITHOUT_X11_FALSE@am__append_20 = gxditview
-@WITHOUT_X11_FALSE@am__append_21 = $(XDITVIEW_GENHDRS)
-@WITHOUT_X11_FALSE@am__append_22 = src/devices/xditview/gxditview.1
-@WITHOUT_X11_FALSE@am__append_23 = xtotroff
-@WITHOUT_X11_FALSE@am__append_24 = src/utils/xtotroff/xtotroff.1
-@USEPROGRAMPREFIX_FALSE@am__append_25 = $(PREFIXMAN1)
+@GL_COND_OBJ_FLOAT_TRUE@am__append_1 = lib/float.c
+@GL_COND_OBJ_ITOLD_TRUE@am__append_2 = lib/itold.c
+@GL_COND_OBJ_FREE_TRUE@am__append_3 = lib/free.c
+@GL_COND_OBJ_FSETERR_TRUE@am__append_4 = lib/fseterr.c
+@GL_COND_OBJ_MEMCHR_TRUE@am__append_5 = lib/memchr.c
+@GL_COND_OBJ_SIGNBIT3_TRUE@am__append_6 = lib/signbitf.c lib/signbitd.c lib/signbitl.c
+@GL_COND_OBJ_STDIO_READ_TRUE@am__append_7 = lib/stdio-read.c
+@GL_COND_OBJ_STDIO_WRITE_TRUE@am__append_8 = lib/stdio-write.c
+@LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE@am__append_9 = lib/uniwidth/width.c
+@GL_COND_OBJ_WCWIDTH_TRUE@am__append_10 = lib/wcwidth.c
+@BUILD_WINSCRIPTS_TRUE@am__append_11 = $(WINSCRIPTS)
+@BUILD_WINSCRIPTS_FALSE@am__append_12 = $(WINSCRIPTS)
+@HAVE_URW_FONTS_TRUE@@USE_GROPDF_TRUE@am__append_13 = contrib/mom/examples/typesetting.pdf
+@USE_PDFROFF_TRUE@am__append_14 = $(PDFDOCFILES)
+@USE_PDFROFF_FALSE@am__append_15 = $(PDFDOCFILES)
+@USE_GROFF_ALLOCATOR_TRUE@am__append_16 = \
+@USE_GROFF_ALLOCATOR_TRUE@  src/libs/libgroff/new.cpp
+
+@WITHOUT_X11_FALSE@am__append_17 = libxutil.a
+@WITHOUT_X11_TRUE@am__append_18 = $(GXDITVIEWSOURCES)
+@WITHOUT_X11_FALSE@am__append_19 = gxditview
+@WITHOUT_X11_FALSE@am__append_20 = $(XDITVIEW_GENHDRS)
+@WITHOUT_X11_FALSE@am__append_21 = $(GXDITVIEW_MAN1)
+@WITHOUT_X11_FALSE@am__append_22 = xtotroff
+@WITHOUT_X11_FALSE@am__append_23 = $(XTOTROFF_MAN1)
+@USEPROGRAMPREFIX_FALSE@am__append_24 = $(PREFIXMAN1)
 subdir = .
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/gnulib_m4/00gnulib.m4 \
 	$(top_srcdir)/gnulib_m4/absolute-header.m4 \
 	$(top_srcdir)/gnulib_m4/alloca.m4 \
-	$(top_srcdir)/gnulib_m4/asm-underscore.m4 \
+	$(top_srcdir)/gnulib_m4/assert_h.m4 \
 	$(top_srcdir)/gnulib_m4/errno_h.m4 \
 	$(top_srcdir)/gnulib_m4/exponentd.m4 \
 	$(top_srcdir)/gnulib_m4/exponentf.m4 \
@@ -1590,14 +1461,15 @@
 	$(top_srcdir)/gnulib_m4/float_h.m4 \
 	$(top_srcdir)/gnulib_m4/fpieee.m4 \
 	$(top_srcdir)/gnulib_m4/fprintf-posix.m4 \
+	$(top_srcdir)/gnulib_m4/free.m4 \
 	$(top_srcdir)/gnulib_m4/frexp.m4 \
 	$(top_srcdir)/gnulib_m4/frexpl.m4 \
 	$(top_srcdir)/gnulib_m4/fseterr.m4 \
 	$(top_srcdir)/gnulib_m4/gnulib-common.m4 \
 	$(top_srcdir)/gnulib_m4/gnulib-comp.m4 \
-	$(top_srcdir)/gnulib_m4/host-cpu-c-abi.m4 \
 	$(top_srcdir)/gnulib_m4/include_next.m4 \
 	$(top_srcdir)/gnulib_m4/intmax_t.m4 \
+	$(top_srcdir)/gnulib_m4/inttypes.m4 \
 	$(top_srcdir)/gnulib_m4/inttypes_h.m4 \
 	$(top_srcdir)/gnulib_m4/isnand.m4 \
 	$(top_srcdir)/gnulib_m4/isnanf.m4 \
@@ -1605,13 +1477,11 @@
 	$(top_srcdir)/gnulib_m4/ldexpl.m4 \
 	$(top_srcdir)/gnulib_m4/libunistring-base.m4 \
 	$(top_srcdir)/gnulib_m4/limits-h.m4 \
-	$(top_srcdir)/gnulib_m4/longlong.m4 \
 	$(top_srcdir)/gnulib_m4/math_h.m4 \
 	$(top_srcdir)/gnulib_m4/memchr.m4 \
 	$(top_srcdir)/gnulib_m4/mmap-anon.m4 \
 	$(top_srcdir)/gnulib_m4/multiarch.m4 \
 	$(top_srcdir)/gnulib_m4/nocrash.m4 \
-	$(top_srcdir)/gnulib_m4/non-recursive-gnulib-prefix-hack.m4 \
 	$(top_srcdir)/gnulib_m4/off_t.m4 \
 	$(top_srcdir)/gnulib_m4/printf-frexp.m4 \
 	$(top_srcdir)/gnulib_m4/printf-frexpl.m4 \
@@ -1620,12 +1490,15 @@
 	$(top_srcdir)/gnulib_m4/size_max.m4 \
 	$(top_srcdir)/gnulib_m4/snprintf.m4 \
 	$(top_srcdir)/gnulib_m4/ssize_t.m4 \
+	$(top_srcdir)/gnulib_m4/stdbool.m4 \
 	$(top_srcdir)/gnulib_m4/stddef_h.m4 \
 	$(top_srcdir)/gnulib_m4/stdint.m4 \
 	$(top_srcdir)/gnulib_m4/stdint_h.m4 \
 	$(top_srcdir)/gnulib_m4/stdio_h.m4 \
+	$(top_srcdir)/gnulib_m4/stdlib_h.m4 \
 	$(top_srcdir)/gnulib_m4/string_h.m4 \
 	$(top_srcdir)/gnulib_m4/sys_types_h.m4 \
+	$(top_srcdir)/gnulib_m4/unistd_h.m4 \
 	$(top_srcdir)/gnulib_m4/vasnprintf.m4 \
 	$(top_srcdir)/gnulib_m4/vsnprintf.m4 \
 	$(top_srcdir)/gnulib_m4/warn-on-use.m4 \
@@ -1634,7 +1507,8 @@
 	$(top_srcdir)/gnulib_m4/wctype_h.m4 \
 	$(top_srcdir)/gnulib_m4/wcwidth.m4 \
 	$(top_srcdir)/gnulib_m4/wint_t.m4 \
-	$(top_srcdir)/gnulib_m4/xsize.m4 $(top_srcdir)/acinclude.m4 \
+	$(top_srcdir)/gnulib_m4/xsize.m4 \
+	$(top_srcdir)/gnulib_m4/zzgnulib.m4 $(top_srcdir)/acinclude.m4 \
 	$(top_srcdir)/m4/ax_compare_version.m4 \
 	$(top_srcdir)/m4/ax_prog_perl_version.m4 \
 	$(top_srcdir)/m4/codeset.m4 $(top_srcdir)/m4/fcntl-o.m4 \
@@ -1646,16 +1520,16 @@
 	$(ACLOCAL_M4)
 DIST_COMMON = $(srcdir)/Makefile.am $(top_srcdir)/configure \
 	$(am__configure_deps) $(dist_bin_SCRIPTS) \
-	$(am__dist_chemexample_DATA_DIST) $(dist_chempic_DATA) \
+	$(dist_chemexample_DATA) $(dist_chempic_DATA) \
 	$(dist_devlj4font_DATA) $(dist_devlj4fontgen_DATA) \
 	$(dist_devpsfont_DATA) $(dist_devpsgen_DATA) \
-	$(am__dist_docexamples_DATA_DIST) $(dist_glilypond_DATA) \
-	$(dist_gpinyin_DATA) $(dist_grog_DATA) \
-	$(am__dist_hdtblexample_DATA_DIST) $(dist_localtmac_DATA) \
-	$(dist_mm_DATA) $(dist_mmexample_DATA) \
-	$(am__dist_momexample_DATA_DIST) $(dist_momtmac_DATA) \
-	$(dist_olddevpsfont_DATA) $(am__dist_otherdoc_DATA_DIST) \
-	$(dist_pdfmarktmac_DATA) $(dist_tmac_DATA) $(dist_tmacmm_DATA) \
+	$(dist_docexamples_DATA) $(dist_hdtblexample_DATA) \
+	$(dist_hdtbltmac_DATA) $(dist_localtmac_DATA) \
+	$(dist_mdoc_DATA) $(dist_mm_DATA) $(dist_mmexample_DATA) \
+	$(dist_momexample_DATA) $(dist_momtmac_DATA) \
+	$(dist_olddevpsfont_DATA) $(dist_otherdoc_DATA) \
+	$(dist_pdfmarktmac_DATA) $(dist_rfc1345tmac_DATA) \
+	$(dist_sboxestmac_DATA) $(dist_tmac_DATA) $(dist_tmacmm_DATA) \
 	$(am__DIST_COMMON)
 am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \
  configure.lineno config.status.lineno
@@ -1669,34 +1543,35 @@
 	"$(DESTDIR)$(prefixexecbindir)" "$(DESTDIR)$(bindir)" \
 	"$(DESTDIR)$(bindir)" "$(DESTDIR)$(prefixexecbindir)" \
 	"$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" \
-	"$(DESTDIR)$(man7dir)" "$(DESTDIR)$(devX10012fontdir)" \
-	"$(DESTDIR)$(devX100fontdir)" "$(DESTDIR)$(devX7512fontdir)" \
-	"$(DESTDIR)$(devX75fontdir)" "$(DESTDIR)$(devasciifontdir)" \
-	"$(DESTDIR)$(devcp1047fontdir)" "$(DESTDIR)$(devdvifontdir)" \
-	"$(DESTDIR)$(devdvigendir)" "$(DESTDIR)$(devhtmlfontdir)" \
-	"$(DESTDIR)$(devlatin1fontdir)" "$(DESTDIR)$(devlbpfontdir)" \
-	"$(DESTDIR)$(devpdffontdir)" "$(DESTDIR)$(devpdffontencdir)" \
+	"$(DESTDIR)$(man7dir)" "$(DESTDIR)$(devX100_12_fontdir)" \
+	"$(DESTDIR)$(devX100_fontdir)" \
+	"$(DESTDIR)$(devX75_12_fontdir)" "$(DESTDIR)$(devX75_fontdir)" \
+	"$(DESTDIR)$(devasciifontdir)" "$(DESTDIR)$(devcp1047fontdir)" \
+	"$(DESTDIR)$(devdvifontdir)" "$(DESTDIR)$(devdvigendir)" \
+	"$(DESTDIR)$(devhtmlfontdir)" "$(DESTDIR)$(devlatin1fontdir)" \
+	"$(DESTDIR)$(devlbpfontdir)" "$(DESTDIR)$(devpdffontdir)" \
+	"$(DESTDIR)$(devpdffontencdir)" \
 	"$(DESTDIR)$(devpdffontmapdir)" "$(DESTDIR)$(devutf8fontdir)" \
 	"$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chempicdir)" \
 	"$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devlj4fontgendir)" \
 	"$(DESTDIR)$(devpsfontdir)" "$(DESTDIR)$(devpsgendir)" \
-	"$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(glilyponddir)" \
-	"$(DESTDIR)$(gpinyindir)" "$(DESTDIR)$(grogdir)" \
-	"$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(localtmacdir)" \
-	"$(DESTDIR)$(mmdir)" "$(DESTDIR)$(mmexampledir)" \
-	"$(DESTDIR)$(momexampledir)" "$(DESTDIR)$(momtmacdir)" \
-	"$(DESTDIR)$(olddevpsfontdir)" "$(DESTDIR)$(otherdocdir)" \
-	"$(DESTDIR)$(pdfmarktmacdir)" "$(DESTDIR)$(tmacdir)" \
-	"$(DESTDIR)$(tmacmmdir)" "$(DESTDIR)$(grofferdir)" \
-	"$(DESTDIR)$(groffoptsdir)" "$(DESTDIR)$(hdtbltmacdir)" \
+	"$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(hdtblexampledir)" \
+	"$(DESTDIR)$(hdtbltmacdir)" "$(DESTDIR)$(localtmacdir)" \
+	"$(DESTDIR)$(mdocdir)" "$(DESTDIR)$(mmdir)" \
+	"$(DESTDIR)$(mmexampledir)" "$(DESTDIR)$(momexampledir)" \
+	"$(DESTDIR)$(momtmacdir)" "$(DESTDIR)$(olddevpsfontdir)" \
+	"$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarktmacdir)" \
+	"$(DESTDIR)$(rfc1345tmacdir)" "$(DESTDIR)$(sboxestmacdir)" \
+	"$(DESTDIR)$(tmacdir)" "$(DESTDIR)$(tmacmmdir)" \
 	"$(DESTDIR)$(htmlpicdir)" "$(DESTDIR)$(momhtmldir)" \
 	"$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chemexample122dir)" \
 	"$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devpsfontdir)" \
 	"$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(docpdfdocdir)" \
-	"$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(htmlexamplesdir)" \
-	"$(DESTDIR)$(mdocdir)" "$(DESTDIR)$(momprocessedexampledir)" \
+	"$(DESTDIR)$(hdtblexampledir)" \
+	"$(DESTDIR)$(momprocessedexampledir)" \
 	"$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarkpdfdocdir)" \
-	"$(DESTDIR)$(tmacdir)"
+	"$(DESTDIR)$(sboxesotherdocdir)" \
+	"$(DESTDIR)$(sboxespdfdocdir)" "$(DESTDIR)$(tmacdir)"
 PROGRAMS = $(bin_PROGRAMS) $(nobase_bin_PROGRAMS) \
 	$(prefixexecbin_PROGRAMS)
 LIBRARIES = $(noinst_LIBRARIES)
@@ -1706,15 +1581,39 @@
 am__v_AR_1 = 
 lib_libgnu_a_AR = $(AR) $(ARFLAGS)
 am__DEPENDENCIES_1 =
-am__lib_libgnu_a_SOURCES_DIST = lib/localcharset.c lib/math.c \
-	lib/printf-frexp.c lib/printf-frexpl.c lib/size_max.h \
-	lib/uniwidth/width.c lib/wctype-h.c lib/xsize.h lib/xsize.c
+am__lib_libgnu_a_SOURCES_DIST = lib/float.c lib/itold.c lib/free.c \
+	lib/fseterr.c lib/localcharset.c lib/math.c lib/memchr.c \
+	lib/printf-frexp.c lib/printf-frexpl.c lib/signbitf.c \
+	lib/signbitd.c lib/signbitl.c lib/size_max.h lib/stdio-read.c \
+	lib/stdio-write.c lib/unistd.c lib/uniwidth/width.c \
+	lib/wctype-h.c lib/wcwidth.c lib/xsize.h lib/xsize.c
 am__dirstamp = $(am__leading_dot)dirstamp
-@LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE@am__objects_1 = lib/uniwidth/width.$(OBJEXT)
-am_lib_libgnu_a_OBJECTS = lib/localcharset.$(OBJEXT) \
-	lib/math.$(OBJEXT) lib/printf-frexp.$(OBJEXT) \
-	lib/printf-frexpl.$(OBJEXT) $(am__objects_1) \
-	lib/wctype-h.$(OBJEXT) lib/xsize.$(OBJEXT)
+@GL_COND_OBJ_FLOAT_TRUE@am__objects_1 = lib/libgnu_a-float.$(OBJEXT)
+@GL_COND_OBJ_ITOLD_TRUE@am__objects_2 = lib/libgnu_a-itold.$(OBJEXT)
+@GL_COND_OBJ_FREE_TRUE@am__objects_3 = lib/libgnu_a-free.$(OBJEXT)
+@GL_COND_OBJ_FSETERR_TRUE@am__objects_4 =  \
+@GL_COND_OBJ_FSETERR_TRUE@	lib/libgnu_a-fseterr.$(OBJEXT)
+@GL_COND_OBJ_MEMCHR_TRUE@am__objects_5 =  \
+@GL_COND_OBJ_MEMCHR_TRUE@	lib/libgnu_a-memchr.$(OBJEXT)
+@GL_COND_OBJ_SIGNBIT3_TRUE@am__objects_6 =  \
+@GL_COND_OBJ_SIGNBIT3_TRUE@	lib/libgnu_a-signbitf.$(OBJEXT) \
+@GL_COND_OBJ_SIGNBIT3_TRUE@	lib/libgnu_a-signbitd.$(OBJEXT) \
+@GL_COND_OBJ_SIGNBIT3_TRUE@	lib/libgnu_a-signbitl.$(OBJEXT)
+@GL_COND_OBJ_STDIO_READ_TRUE@am__objects_7 = lib/libgnu_a-stdio-read.$(OBJEXT)
+@GL_COND_OBJ_STDIO_WRITE_TRUE@am__objects_8 = lib/libgnu_a-stdio-write.$(OBJEXT)
+@LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE@am__objects_9 = lib/uniwidth/libgnu_a-width.$(OBJEXT)
+@GL_COND_OBJ_WCWIDTH_TRUE@am__objects_10 =  \
+@GL_COND_OBJ_WCWIDTH_TRUE@	lib/libgnu_a-wcwidth.$(OBJEXT)
+am_lib_libgnu_a_OBJECTS = $(am__objects_1) $(am__objects_2) \
+	$(am__objects_3) $(am__objects_4) \
+	lib/libgnu_a-localcharset.$(OBJEXT) \
+	lib/libgnu_a-math.$(OBJEXT) $(am__objects_5) \
+	lib/libgnu_a-printf-frexp.$(OBJEXT) \
+	lib/libgnu_a-printf-frexpl.$(OBJEXT) $(am__objects_6) \
+	$(am__objects_7) $(am__objects_8) \
+	lib/libgnu_a-unistd.$(OBJEXT) $(am__objects_9) \
+	lib/libgnu_a-wctype-h.$(OBJEXT) $(am__objects_10) \
+	lib/libgnu_a-xsize.$(OBJEXT)
 lib_libgnu_a_OBJECTS = $(am_lib_libgnu_a_OBJECTS)
 libbib_a_AR = $(AR) $(ARFLAGS)
 libbib_a_LIBADD =
@@ -1730,6 +1629,33 @@
 libdriver_a_OBJECTS = $(am_libdriver_a_OBJECTS)
 libgroff_a_AR = $(AR) $(ARFLAGS)
 libgroff_a_LIBADD =
+am__libgroff_a_SOURCES_DIST = src/libs/libgroff/assert.cpp \
+	src/libs/libgroff/change_lf.cpp src/libs/libgroff/cmap.cpp \
+	src/libs/libgroff/color.cpp src/libs/libgroff/cset.cpp \
+	src/libs/libgroff/curtime.cpp src/libs/libgroff/device.cpp \
+	src/libs/libgroff/errarg.cpp src/libs/libgroff/error.cpp \
+	src/libs/libgroff/fatal.cpp src/libs/libgroff/filename.cpp \
+	src/libs/libgroff/font.cpp src/libs/libgroff/fontfile.cpp \
+	src/libs/libgroff/geometry.cpp src/libs/libgroff/getopt.c \
+	src/libs/libgroff/getopt1.c src/libs/libgroff/glyphuni.cpp \
+	src/libs/libgroff/htmlhint.cpp src/libs/libgroff/hypot.cpp \
+	src/libs/libgroff/iftoa.c src/libs/libgroff/invalid.cpp \
+	src/libs/libgroff/itoa.c src/libs/libgroff/lf.cpp \
+	src/libs/libgroff/lineno.cpp src/libs/libgroff/localcharset.c \
+	src/libs/libgroff/macropath.cpp src/libs/libgroff/matherr.c \
+	src/libs/libgroff/maxfilename.cpp \
+	src/libs/libgroff/maxpathname.cpp src/libs/libgroff/mksdir.cpp \
+	src/libs/libgroff/nametoindex.cpp src/libs/libgroff/paper.cpp \
+	src/libs/libgroff/prime.cpp src/libs/libgroff/progname.c \
+	src/libs/libgroff/ptable.cpp src/libs/libgroff/quotearg.c \
+	src/libs/libgroff/relocate.cpp \
+	src/libs/libgroff/searchpath.cpp src/libs/libgroff/spawnvp.c \
+	src/libs/libgroff/string.cpp src/libs/libgroff/strsave.cpp \
+	src/libs/libgroff/symbol.cpp src/libs/libgroff/tmpfile.cpp \
+	src/libs/libgroff/tmpname.cpp src/libs/libgroff/unicode.cpp \
+	src/libs/libgroff/uniglyph.cpp src/libs/libgroff/uniuni.cpp \
+	src/libs/libgroff/relocatable.h src/libs/libgroff/new.cpp
+@USE_GROFF_ALLOCATOR_TRUE@am__objects_11 = src/libs/libgroff/libgroff_a-new.$(OBJEXT)
 am_libgroff_a_OBJECTS = src/libs/libgroff/libgroff_a-assert.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-change_lf.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-cmap.$(OBJEXT) \
@@ -1761,7 +1687,6 @@
 	src/libs/libgroff/libgroff_a-maxpathname.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-mksdir.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-nametoindex.$(OBJEXT) \
-	src/libs/libgroff/libgroff_a-new.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-paper.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-prime.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-progname.$(OBJEXT) \
@@ -1777,7 +1702,8 @@
 	src/libs/libgroff/libgroff_a-tmpname.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-unicode.$(OBJEXT) \
 	src/libs/libgroff/libgroff_a-uniglyph.$(OBJEXT) \
-	src/libs/libgroff/libgroff_a-uniuni.$(OBJEXT)
+	src/libs/libgroff/libgroff_a-uniuni.$(OBJEXT) \
+	$(am__objects_11)
 nodist_libgroff_a_OBJECTS =  \
 	src/libs/libgroff/libgroff_a-version.$(OBJEXT)
 libgroff_a_OBJECTS = $(am_libgroff_a_OBJECTS) \
@@ -1851,7 +1777,7 @@
 	src/devices/xditview/parse.h src/devices/xditview/xditview.c \
 	src/devices/xditview/device.h src/devices/xditview/DviP.h \
 	src/devices/xditview/Menu.h src/devices/xditview/Dvi.h
-am__objects_2 = src/devices/xditview/gxditview-device.$(OBJEXT) \
+am__objects_12 = src/devices/xditview/gxditview-device.$(OBJEXT) \
 	src/devices/xditview/gxditview-draw.$(OBJEXT) \
 	src/devices/xditview/gxditview-Dvi.$(OBJEXT) \
 	src/devices/xditview/gxditview-font.$(OBJEXT) \
@@ -1859,9 +1785,10 @@
 	src/devices/xditview/gxditview-page.$(OBJEXT) \
 	src/devices/xditview/gxditview-parse.$(OBJEXT) \
 	src/devices/xditview/gxditview-xditview.$(OBJEXT)
-@WITHOUT_X11_FALSE@am_gxditview_OBJECTS = $(am__objects_2)
-am__objects_3 =
-@WITHOUT_X11_FALSE@nodist_gxditview_OBJECTS = $(am__objects_3)
+@WITHOUT_X11_FALSE@am_gxditview_OBJECTS = $(am__objects_12)
+am__objects_13 =
+@WITHOUT_X11_FALSE@am__objects_14 = $(am__objects_13)
+@WITHOUT_X11_FALSE@nodist_gxditview_OBJECTS = $(am__objects_14)
 gxditview_OBJECTS = $(am_gxditview_OBJECTS) \
 	$(nodist_gxditview_OBJECTS)
 @WITHOUT_X11_FALSE@gxditview_DEPENDENCIES = $(am__DEPENDENCIES_1) \
@@ -1989,21 +1916,37 @@
 DEFAULT_INCLUDES = -I.@am__isrc@ -I$(top_builddir)/src/include
 depcomp = $(SHELL) $(top_srcdir)/build-aux/depcomp
 am__maybe_remake_depfiles = depfiles
-am__depfiles_remade = lib/$(DEPDIR)/asnprintf.Po \
-	lib/$(DEPDIR)/float.Po lib/$(DEPDIR)/fprintf.Po \
-	lib/$(DEPDIR)/frexp.Po lib/$(DEPDIR)/frexpl.Po \
-	lib/$(DEPDIR)/fseterr.Po lib/$(DEPDIR)/isnan.Po \
-	lib/$(DEPDIR)/isnand.Po lib/$(DEPDIR)/isnanf.Po \
-	lib/$(DEPDIR)/isnanl.Po lib/$(DEPDIR)/itold.Po \
-	lib/$(DEPDIR)/localcharset.Po lib/$(DEPDIR)/math.Po \
-	lib/$(DEPDIR)/memchr.Po lib/$(DEPDIR)/printf-args.Po \
-	lib/$(DEPDIR)/printf-frexp.Po lib/$(DEPDIR)/printf-frexpl.Po \
-	lib/$(DEPDIR)/printf-parse.Po lib/$(DEPDIR)/signbitd.Po \
-	lib/$(DEPDIR)/signbitf.Po lib/$(DEPDIR)/signbitl.Po \
-	lib/$(DEPDIR)/snprintf.Po lib/$(DEPDIR)/vasnprintf.Po \
-	lib/$(DEPDIR)/vsnprintf.Po lib/$(DEPDIR)/wctype-h.Po \
-	lib/$(DEPDIR)/wcwidth.Po lib/$(DEPDIR)/xsize.Po \
-	lib/uniwidth/$(DEPDIR)/width.Po \
+am__depfiles_remade = lib/$(DEPDIR)/libgnu_a-asnprintf.Po \
+	lib/$(DEPDIR)/libgnu_a-float.Po \
+	lib/$(DEPDIR)/libgnu_a-fprintf.Po \
+	lib/$(DEPDIR)/libgnu_a-free.Po lib/$(DEPDIR)/libgnu_a-frexp.Po \
+	lib/$(DEPDIR)/libgnu_a-frexpl.Po \
+	lib/$(DEPDIR)/libgnu_a-fseterr.Po \
+	lib/$(DEPDIR)/libgnu_a-isnan.Po \
+	lib/$(DEPDIR)/libgnu_a-isnand.Po \
+	lib/$(DEPDIR)/libgnu_a-isnanf.Po \
+	lib/$(DEPDIR)/libgnu_a-isnanl.Po \
+	lib/$(DEPDIR)/libgnu_a-itold.Po \
+	lib/$(DEPDIR)/libgnu_a-localcharset.Po \
+	lib/$(DEPDIR)/libgnu_a-math.Po \
+	lib/$(DEPDIR)/libgnu_a-memchr.Po \
+	lib/$(DEPDIR)/libgnu_a-printf-args.Po \
+	lib/$(DEPDIR)/libgnu_a-printf-frexp.Po \
+	lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po \
+	lib/$(DEPDIR)/libgnu_a-printf-parse.Po \
+	lib/$(DEPDIR)/libgnu_a-signbitd.Po \
+	lib/$(DEPDIR)/libgnu_a-signbitf.Po \
+	lib/$(DEPDIR)/libgnu_a-signbitl.Po \
+	lib/$(DEPDIR)/libgnu_a-snprintf.Po \
+	lib/$(DEPDIR)/libgnu_a-stdio-read.Po \
+	lib/$(DEPDIR)/libgnu_a-stdio-write.Po \
+	lib/$(DEPDIR)/libgnu_a-unistd.Po \
+	lib/$(DEPDIR)/libgnu_a-vasnprintf.Po \
+	lib/$(DEPDIR)/libgnu_a-vsnprintf.Po \
+	lib/$(DEPDIR)/libgnu_a-wctype-h.Po \
+	lib/$(DEPDIR)/libgnu_a-wcwidth.Po \
+	lib/$(DEPDIR)/libgnu_a-xsize.Po \
+	lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po \
 	src/devices/grodvi/$(DEPDIR)/dvi.Po \
 	src/devices/grohtml/$(DEPDIR)/html-table.Po \
 	src/devices/grohtml/$(DEPDIR)/html-text.Po \
@@ -2195,7 +2138,7 @@
 	$(nodist_troff_SOURCES) $(xtotroff_SOURCES)
 DIST_SOURCES = $(am__lib_libgnu_a_SOURCES_DIST) \
 	$(EXTRA_lib_libgnu_a_SOURCES) $(libbib_a_SOURCES) \
-	$(libdriver_a_SOURCES) $(libgroff_a_SOURCES) \
+	$(libdriver_a_SOURCES) $(am__libgroff_a_SOURCES_DIST) \
 	$(am__libxutil_a_SOURCES_DIST) $(addftinfo_SOURCES) \
 	$(eqn_SOURCES) $(grn_SOURCES) $(grodvi_SOURCES) \
 	$(groff_SOURCES) $(grolbp_SOURCES) $(grolj4_SOURCES) \
@@ -2213,62 +2156,29 @@
   esac
 NROFF = nroff
 MANS = $(man1_MANS) $(man5_MANS) $(man7_MANS)
-am__dist_chemexample_DATA_DIST = contrib/chem/examples/atp.chem \
-	contrib/chem/examples/cholesterin.chem \
-	contrib/chem/examples/ethamivan.chem \
-	contrib/chem/examples/lsd.chem \
-	contrib/chem/examples/morphine.chem \
-	contrib/chem/examples/penicillin.chem \
-	contrib/chem/examples/reserpine.chem
-am__dist_docexamples_DATA_DIST = doc/webpage.ms doc/groff.css \
-	doc/grnexmpl.g doc/grnexmpl.me
-am__dist_hdtblexample_DATA_DIST = contrib/hdtbl/examples/common.roff \
-	contrib/hdtbl/examples/chess_board.roff \
-	contrib/hdtbl/examples/color_boxes.roff \
-	contrib/hdtbl/examples/color_nested_tables.roff \
-	contrib/hdtbl/examples/color_table_cells.roff \
-	contrib/hdtbl/examples/color_transitions.roff \
-	contrib/hdtbl/examples/col_rowspan_colors.roff \
-	contrib/hdtbl/examples/mixed_pickles.roff \
-	contrib/hdtbl/examples/rainbow.roff \
-	contrib/hdtbl/examples/short_reference.roff
-am__dist_momexample_DATA_DIST = contrib/mom/examples/letter.mom \
-	contrib/mom/examples/mom-pdf.mom \
-	contrib/mom/examples/mon_premier_doc.mom \
-	contrib/mom/examples/sample_docs.mom \
-	contrib/mom/examples/typesetting.mom \
-	contrib/mom/examples/README.txt \
-	contrib/mom/examples/README-fr.txt \
-	contrib/mom/examples/elvis_syntax \
-	contrib/mom/examples/elvis_syntax.new \
-	contrib/mom/examples/penguin.ps \
-	contrib/mom/examples/penguin.pdf contrib/mom/examples/mom.vim \
-	contrib/mom/examples/slide-demo.mom
-am__dist_otherdoc_DATA_DIST = doc/meref.me doc/meintro.me \
-	doc/meintro_fr.me doc/pic.ms
-DATA = $(devX10012font_DATA) $(devX100font_DATA) $(devX7512font_DATA) \
-	$(devX75font_DATA) $(devasciifont_DATA) $(devcp1047font_DATA) \
-	$(devdvifont_DATA) $(devdvigen_DATA) $(devhtmlfont_DATA) \
-	$(devlatin1font_DATA) $(devlbpfont_DATA) $(devpdffont_DATA) \
-	$(devpdffontenc_DATA) $(devpdffontmap_DATA) \
-	$(devutf8font_DATA) $(dist_chemexample_DATA) \
-	$(dist_chempic_DATA) $(dist_devlj4font_DATA) \
-	$(dist_devlj4fontgen_DATA) $(dist_devpsfont_DATA) \
-	$(dist_devpsgen_DATA) $(dist_docexamples_DATA) \
-	$(dist_glilypond_DATA) $(dist_gpinyin_DATA) $(dist_grog_DATA) \
-	$(dist_hdtblexample_DATA) $(dist_localtmac_DATA) \
-	$(dist_mm_DATA) $(dist_mmexample_DATA) $(dist_momexample_DATA) \
-	$(dist_momtmac_DATA) $(dist_olddevpsfont_DATA) \
-	$(dist_otherdoc_DATA) $(dist_pdfmarktmac_DATA) \
-	$(dist_tmac_DATA) $(dist_tmacmm_DATA) $(groffer_DATA) \
-	$(groffopts_DATA) $(hdtbltmac_DATA) $(htmlpic_DATA) \
-	$(momhtml_DATA) $(nodist_chemexample_DATA) \
+DATA = $(devX100_12_font_DATA) $(devX100_font_DATA) \
+	$(devX75_12_font_DATA) $(devX75_font_DATA) \
+	$(devasciifont_DATA) $(devcp1047font_DATA) $(devdvifont_DATA) \
+	$(devdvigen_DATA) $(devhtmlfont_DATA) $(devlatin1font_DATA) \
+	$(devlbpfont_DATA) $(devpdffont_DATA) $(devpdffontenc_DATA) \
+	$(devpdffontmap_DATA) $(devutf8font_DATA) \
+	$(dist_chemexample_DATA) $(dist_chempic_DATA) \
+	$(dist_devlj4font_DATA) $(dist_devlj4fontgen_DATA) \
+	$(dist_devpsfont_DATA) $(dist_devpsgen_DATA) \
+	$(dist_docexamples_DATA) $(dist_hdtblexample_DATA) \
+	$(dist_hdtbltmac_DATA) $(dist_localtmac_DATA) \
+	$(dist_mdoc_DATA) $(dist_mm_DATA) $(dist_mmexample_DATA) \
+	$(dist_momexample_DATA) $(dist_momtmac_DATA) \
+	$(dist_olddevpsfont_DATA) $(dist_otherdoc_DATA) \
+	$(dist_pdfmarktmac_DATA) $(dist_rfc1345tmac_DATA) \
+	$(dist_sboxestmac_DATA) $(dist_tmac_DATA) $(dist_tmacmm_DATA) \
+	$(htmlpic_DATA) $(momhtml_DATA) $(nodist_chemexample_DATA) \
 	$(nodist_chemexample122_DATA) $(nodist_devlj4font_DATA) \
 	$(nodist_devpsfont_DATA) $(nodist_docexamples_DATA) \
 	$(nodist_docpdfdoc_DATA) $(nodist_hdtblexample_DATA) \
-	$(nodist_htmlexamples_DATA) $(nodist_mdoc_DATA) \
 	$(nodist_momprocessedexample_DATA) $(nodist_otherdoc_DATA) \
-	$(nodist_pdfmarkpdfdoc_DATA) $(nodist_tmac_DATA)
+	$(nodist_pdfmarkpdfdoc_DATA) $(nodist_sboxesotherdoc_DATA) \
+	$(nodist_sboxespdfdoc_DATA) $(nodist_tmac_DATA)
 HEADERS = $(nodist_noinst_HEADERS)
 am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
 # Read a list of newline-separated strings from the standard input,
@@ -2287,8 +2197,6 @@
   unique=`for i in $$list; do \
     if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
   done | $(am__uniquify_input)`
-CTAGS = ctags
-CSCOPE = cscope
 AM_RECURSIVE_TARGETS = cscope check recheck
 am__tty_colors_dummy = \
   mgn= red= grn= lgn= blu= brg= std=; \
@@ -2445,6 +2353,7 @@
   bases='$(TEST_LOGS)'; \
   bases=`for i in $$bases; do echo $$i; done | sed 's/\.log$$//'`; \
   bases=`echo $$bases`
+AM_TESTSUITE_SUMMARY_HEADER = ' for $(PACKAGE_STRING)'
 RECHECK_LOGS = $(TEST_LOGS)
 TEST_SUITE_LOG = test-suite.log
 TEST_EXTENSIONS = @EXEEXT@ .test
@@ -2485,13 +2394,13 @@
 	$(top_srcdir)/contrib/gperl/gperl.am \
 	$(top_srcdir)/contrib/gpinyin/gpinyin.am \
 	$(top_srcdir)/contrib/grap2graph/grap2graph.am \
-	$(top_srcdir)/contrib/groff_filenames/groff_filenames.am \
-	$(top_srcdir)/contrib/groffer/groffer.am \
 	$(top_srcdir)/contrib/hdtbl/hdtbl.am \
 	$(top_srcdir)/contrib/mm/mm.am \
 	$(top_srcdir)/contrib/mom/mom.am \
 	$(top_srcdir)/contrib/pdfmark/pdfmark.am \
 	$(top_srcdir)/contrib/pic2graph/pic2graph.am \
+	$(top_srcdir)/contrib/rfc1345/rfc1345.am \
+	$(top_srcdir)/contrib/sboxes/sboxes.am \
 	$(top_srcdir)/doc/doc.am \
 	$(top_srcdir)/font/devX100-12/devX100-12.am \
 	$(top_srcdir)/font/devX100/devX100.am \
@@ -2532,11 +2441,11 @@
 	$(top_srcdir)/src/preproc/soelim/soelim.am \
 	$(top_srcdir)/src/preproc/tbl/tbl.am \
 	$(top_srcdir)/src/roff/groff/groff.am \
-	$(top_srcdir)/src/roff/grog/grog.am \
 	$(top_srcdir)/src/roff/nroff/nroff.am \
 	$(top_srcdir)/src/roff/troff/troff.am \
 	$(top_srcdir)/src/utils/addftinfo/addftinfo.am \
 	$(top_srcdir)/src/utils/afmtodit/afmtodit.am \
+	$(top_srcdir)/src/utils/grog/grog.am \
 	$(top_srcdir)/src/utils/hpftodit/hpftodit.am \
 	$(top_srcdir)/src/utils/indxbib/indxbib.am \
 	$(top_srcdir)/src/utils/lkbib/lkbib.am \
@@ -2565,6 +2474,8 @@
 DIST_ARCHIVES = $(distdir).tar.gz
 GZIP_ENV = --best
 DIST_TARGETS = dist-gzip
+# Exists only to be overridden by the user if desired.
+AM_DISTCHECK_DVI_TARGET = dvi
 distuninstallcheck_listfiles = find . -type f -print
 am__distuninstallcheck_listfiles = $(distuninstallcheck_listfiles) \
   | sed 's|^\./|$(prefix)/|' | grep -v '$(infodir)/dir$$'
@@ -2577,38 +2488,9 @@
 AMTAR = @AMTAR@
 AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
 APPLE_UNIVERSAL_BUILD = @APPLE_UNIVERSAL_BUILD@
-# CC
-# CFLAGS
-# CPPFLAGS
-# LDFLAGS
-
-# X_CFLAGS
-# X_LIBS
-# X_EXTRA_LIBS
-# X_PRE_LIBS
-
-# YACC
-
-# GREP
-# EGREP
-
-# MAKEINFO
-
-# EXEEXT
-# OBJEXT
-# LIBEXT
-# LIBS
-# LIBM
-# LIBICONV
-# RANLIB
-# INSTALL
-# INSTALL_PROGRAM
-# INSTALL_SCRIPT
-# INSTALL_DATA
-# INSTALL_INFO
-# LN_S
-AR = ar
+AR = @AR@
 ARFLAGS = @ARFLAGS@
+ASSERT_H = @ASSERT_H@
 AUTOCONF = @AUTOCONF@
 AUTOHEADER = @AUTOHEADER@
 AUTOMAKE = @AUTOMAKE@
@@ -2625,6 +2507,8 @@
 CFLAGS = @CFLAGS@
 CPP = @CPP@
 CPPFLAGS = @CPPFLAGS@
+CSCOPE = @CSCOPE@
+CTAGS = @CTAGS@
 CXX = @CXX@
 CXXCPP = @CXXCPP@
 CXXDEPMODE = @CXXDEPMODE@
@@ -2645,259 +2529,459 @@
 EOVERFLOW_HIDDEN = @EOVERFLOW_HIDDEN@
 EOVERFLOW_VALUE = @EOVERFLOW_VALUE@
 ERRNO_H = @ERRNO_H@
+# CC
+# CFLAGS
+# CPPFLAGS
+# LDFLAGS
+
+# X_CFLAGS
+# X_LIBS
+# X_EXTRA_LIBS
+# X_PRE_LIBS
+
+# YACC
+
+# GREP
+# EGREP
+
+# MAKEINFO
+
+# EXEEXT
+# OBJEXT
+# LIBEXT
+# LIBS
+# LIBM
+# LIBICONV
+# AR
+# RANLIB
+# INSTALL
+# INSTALL_PROGRAM
+# INSTALL_SCRIPT
+# INSTALL_DATA
+# INSTALL_INFO
+# LN_S
+ETAGS = etags
 EXEEXT = @EXEEXT@
 FLOAT_H = @FLOAT_H@
 GDIFF = @GDIFF@
 GHOSTSCRIPT = @GHOSTSCRIPT@
 GLIBC21 = @GLIBC21@
-GNULIB_ACOSF = @GNULIB_ACOSF@
-GNULIB_ACOSL = @GNULIB_ACOSL@
-GNULIB_ASINF = @GNULIB_ASINF@
-GNULIB_ASINL = @GNULIB_ASINL@
-GNULIB_ATAN2F = @GNULIB_ATAN2F@
-GNULIB_ATANF = @GNULIB_ATANF@
-GNULIB_ATANL = @GNULIB_ATANL@
-GNULIB_BTOWC = @GNULIB_BTOWC@
-GNULIB_CBRT = @GNULIB_CBRT@
-GNULIB_CBRTF = @GNULIB_CBRTF@
-GNULIB_CBRTL = @GNULIB_CBRTL@
-GNULIB_CEIL = @GNULIB_CEIL@
-GNULIB_CEILF = @GNULIB_CEILF@
-GNULIB_CEILL = @GNULIB_CEILL@
-GNULIB_COPYSIGN = @GNULIB_COPYSIGN@
-GNULIB_COPYSIGNF = @GNULIB_COPYSIGNF@
-GNULIB_COPYSIGNL = @GNULIB_COPYSIGNL@
-GNULIB_COSF = @GNULIB_COSF@
-GNULIB_COSHF = @GNULIB_COSHF@
-GNULIB_COSL = @GNULIB_COSL@
-GNULIB_DPRINTF = @GNULIB_DPRINTF@
-GNULIB_EXP2 = @GNULIB_EXP2@
-GNULIB_EXP2F = @GNULIB_EXP2F@
-GNULIB_EXP2L = @GNULIB_EXP2L@
-GNULIB_EXPF = @GNULIB_EXPF@
-GNULIB_EXPL = @GNULIB_EXPL@
-GNULIB_EXPLICIT_BZERO = @GNULIB_EXPLICIT_BZERO@
-GNULIB_EXPM1 = @GNULIB_EXPM1@
-GNULIB_EXPM1F = @GNULIB_EXPM1F@
-GNULIB_EXPM1L = @GNULIB_EXPM1L@
-GNULIB_FABSF = @GNULIB_FABSF@
-GNULIB_FABSL = @GNULIB_FABSL@
-GNULIB_FCLOSE = @GNULIB_FCLOSE@
-GNULIB_FDOPEN = @GNULIB_FDOPEN@
-GNULIB_FFLUSH = @GNULIB_FFLUSH@
-GNULIB_FFSL = @GNULIB_FFSL@
-GNULIB_FFSLL = @GNULIB_FFSLL@
-GNULIB_FGETC = @GNULIB_FGETC@
-GNULIB_FGETS = @GNULIB_FGETS@
-GNULIB_FLOOR = @GNULIB_FLOOR@
-GNULIB_FLOORF = @GNULIB_FLOORF@
-GNULIB_FLOORL = @GNULIB_FLOORL@
-GNULIB_FMA = @GNULIB_FMA@
-GNULIB_FMAF = @GNULIB_FMAF@
-GNULIB_FMAL = @GNULIB_FMAL@
-GNULIB_FMOD = @GNULIB_FMOD@
-GNULIB_FMODF = @GNULIB_FMODF@
-GNULIB_FMODL = @GNULIB_FMODL@
-GNULIB_FOPEN = @GNULIB_FOPEN@
-GNULIB_FPRINTF = @GNULIB_FPRINTF@
-GNULIB_FPRINTF_POSIX = @GNULIB_FPRINTF_POSIX@
-GNULIB_FPURGE = @GNULIB_FPURGE@
-GNULIB_FPUTC = @GNULIB_FPUTC@
-GNULIB_FPUTS = @GNULIB_FPUTS@
-GNULIB_FREAD = @GNULIB_FREAD@
-GNULIB_FREOPEN = @GNULIB_FREOPEN@
-GNULIB_FREXP = @GNULIB_FREXP@
-GNULIB_FREXPF = @GNULIB_FREXPF@
-GNULIB_FREXPL = @GNULIB_FREXPL@
-GNULIB_FSCANF = @GNULIB_FSCANF@
-GNULIB_FSEEK = @GNULIB_FSEEK@
-GNULIB_FSEEKO = @GNULIB_FSEEKO@
-GNULIB_FTELL = @GNULIB_FTELL@
-GNULIB_FTELLO = @GNULIB_FTELLO@
-GNULIB_FWRITE = @GNULIB_FWRITE@
-GNULIB_GETC = @GNULIB_GETC@
-GNULIB_GETCHAR = @GNULIB_GETCHAR@
-GNULIB_GETDELIM = @GNULIB_GETDELIM@
-GNULIB_GETLINE = @GNULIB_GETLINE@
-GNULIB_HYPOT = @GNULIB_HYPOT@
-GNULIB_HYPOTF = @GNULIB_HYPOTF@
-GNULIB_HYPOTL = @GNULIB_HYPOTL@
-GNULIB_ILOGB = @GNULIB_ILOGB@
-GNULIB_ILOGBF = @GNULIB_ILOGBF@
-GNULIB_ILOGBL = @GNULIB_ILOGBL@
-GNULIB_ISFINITE = @GNULIB_ISFINITE@
-GNULIB_ISINF = @GNULIB_ISINF@
-GNULIB_ISNAN = @GNULIB_ISNAN@
-GNULIB_ISNAND = @GNULIB_ISNAND@
-GNULIB_ISNANF = @GNULIB_ISNANF@
-GNULIB_ISNANL = @GNULIB_ISNANL@
-GNULIB_ISWBLANK = @GNULIB_ISWBLANK@
-GNULIB_ISWCTYPE = @GNULIB_ISWCTYPE@
-GNULIB_LDEXPF = @GNULIB_LDEXPF@
-GNULIB_LDEXPL = @GNULIB_LDEXPL@
-GNULIB_LOG = @GNULIB_LOG@
-GNULIB_LOG10 = @GNULIB_LOG10@
-GNULIB_LOG10F = @GNULIB_LOG10F@
-GNULIB_LOG10L = @GNULIB_LOG10L@
-GNULIB_LOG1P = @GNULIB_LOG1P@
-GNULIB_LOG1PF = @GNULIB_LOG1PF@
-GNULIB_LOG1PL = @GNULIB_LOG1PL@
-GNULIB_LOG2 = @GNULIB_LOG2@
-GNULIB_LOG2F = @GNULIB_LOG2F@
-GNULIB_LOG2L = @GNULIB_LOG2L@
-GNULIB_LOGB = @GNULIB_LOGB@
-GNULIB_LOGBF = @GNULIB_LOGBF@
-GNULIB_LOGBL = @GNULIB_LOGBL@
-GNULIB_LOGF = @GNULIB_LOGF@
-GNULIB_LOGL = @GNULIB_LOGL@
-GNULIB_MBRLEN = @GNULIB_MBRLEN@
-GNULIB_MBRTOWC = @GNULIB_MBRTOWC@
-GNULIB_MBSCASECMP = @GNULIB_MBSCASECMP@
-GNULIB_MBSCASESTR = @GNULIB_MBSCASESTR@
-GNULIB_MBSCHR = @GNULIB_MBSCHR@
-GNULIB_MBSCSPN = @GNULIB_MBSCSPN@
-GNULIB_MBSINIT = @GNULIB_MBSINIT@
-GNULIB_MBSLEN = @GNULIB_MBSLEN@
-GNULIB_MBSNCASECMP = @GNULIB_MBSNCASECMP@
-GNULIB_MBSNLEN = @GNULIB_MBSNLEN@
-GNULIB_MBSNRTOWCS = @GNULIB_MBSNRTOWCS@
-GNULIB_MBSPBRK = @GNULIB_MBSPBRK@
-GNULIB_MBSPCASECMP = @GNULIB_MBSPCASECMP@
-GNULIB_MBSRCHR = @GNULIB_MBSRCHR@
-GNULIB_MBSRTOWCS = @GNULIB_MBSRTOWCS@
-GNULIB_MBSSEP = @GNULIB_MBSSEP@
-GNULIB_MBSSPN = @GNULIB_MBSSPN@
-GNULIB_MBSSTR = @GNULIB_MBSSTR@
-GNULIB_MBSTOK_R = @GNULIB_MBSTOK_R@
-GNULIB_MEMCHR = @GNULIB_MEMCHR@
-GNULIB_MEMMEM = @GNULIB_MEMMEM@
-GNULIB_MEMPCPY = @GNULIB_MEMPCPY@
-GNULIB_MEMRCHR = @GNULIB_MEMRCHR@
-GNULIB_MODF = @GNULIB_MODF@
-GNULIB_MODFF = @GNULIB_MODFF@
-GNULIB_MODFL = @GNULIB_MODFL@
-GNULIB_OBSTACK_PRINTF = @GNULIB_OBSTACK_PRINTF@
-GNULIB_OBSTACK_PRINTF_POSIX = @GNULIB_OBSTACK_PRINTF_POSIX@
-GNULIB_OVERRIDES_WINT_T = @GNULIB_OVERRIDES_WINT_T@
-GNULIB_PCLOSE = @GNULIB_PCLOSE@
-GNULIB_PERROR = @GNULIB_PERROR@
-GNULIB_POPEN = @GNULIB_POPEN@
-GNULIB_POWF = @GNULIB_POWF@
-GNULIB_PRINTF = @GNULIB_PRINTF@
-GNULIB_PRINTF_POSIX = @GNULIB_PRINTF_POSIX@
-GNULIB_PUTC = @GNULIB_PUTC@
-GNULIB_PUTCHAR = @GNULIB_PUTCHAR@
-GNULIB_PUTS = @GNULIB_PUTS@
-GNULIB_RAWMEMCHR = @GNULIB_RAWMEMCHR@
-GNULIB_REMAINDER = @GNULIB_REMAINDER@
-GNULIB_REMAINDERF = @GNULIB_REMAINDERF@
-GNULIB_REMAINDERL = @GNULIB_REMAINDERL@
-GNULIB_REMOVE = @GNULIB_REMOVE@
-GNULIB_RENAME = @GNULIB_RENAME@
-GNULIB_RENAMEAT = @GNULIB_RENAMEAT@
-GNULIB_RINT = @GNULIB_RINT@
-GNULIB_RINTF = @GNULIB_RINTF@
-GNULIB_RINTL = @GNULIB_RINTL@
-GNULIB_ROUND = @GNULIB_ROUND@
-GNULIB_ROUNDF = @GNULIB_ROUNDF@
-GNULIB_ROUNDL = @GNULIB_ROUNDL@
-GNULIB_SCANF = @GNULIB_SCANF@
-GNULIB_SIGNBIT = @GNULIB_SIGNBIT@
-GNULIB_SINF = @GNULIB_SINF@
-GNULIB_SINHF = @GNULIB_SINHF@
-GNULIB_SINL = @GNULIB_SINL@
-GNULIB_SNPRINTF = @GNULIB_SNPRINTF@
-GNULIB_SPRINTF_POSIX = @GNULIB_SPRINTF_POSIX@
-GNULIB_SQRTF = @GNULIB_SQRTF@
-GNULIB_SQRTL = @GNULIB_SQRTL@
-GNULIB_STDIO_H_NONBLOCKING = @GNULIB_STDIO_H_NONBLOCKING@
-GNULIB_STDIO_H_SIGPIPE = @GNULIB_STDIO_H_SIGPIPE@
-GNULIB_STPCPY = @GNULIB_STPCPY@
-GNULIB_STPNCPY = @GNULIB_STPNCPY@
-GNULIB_STRCASESTR = @GNULIB_STRCASESTR@
-GNULIB_STRCHRNUL = @GNULIB_STRCHRNUL@
-GNULIB_STRDUP = @GNULIB_STRDUP@
-GNULIB_STRERROR = @GNULIB_STRERROR@
-GNULIB_STRERROR_R = @GNULIB_STRERROR_R@
-GNULIB_STRNCAT = @GNULIB_STRNCAT@
-GNULIB_STRNDUP = @GNULIB_STRNDUP@
-GNULIB_STRNLEN = @GNULIB_STRNLEN@
-GNULIB_STRPBRK = @GNULIB_STRPBRK@
-GNULIB_STRSEP = @GNULIB_STRSEP@
-GNULIB_STRSIGNAL = @GNULIB_STRSIGNAL@
-GNULIB_STRSTR = @GNULIB_STRSTR@
-GNULIB_STRTOK_R = @GNULIB_STRTOK_R@
-GNULIB_STRVERSCMP = @GNULIB_STRVERSCMP@
-GNULIB_TANF = @GNULIB_TANF@
-GNULIB_TANHF = @GNULIB_TANHF@
-GNULIB_TANL = @GNULIB_TANL@
-GNULIB_TMPFILE = @GNULIB_TMPFILE@
-GNULIB_TOWCTRANS = @GNULIB_TOWCTRANS@
-GNULIB_TRUNC = @GNULIB_TRUNC@
-GNULIB_TRUNCF = @GNULIB_TRUNCF@
-GNULIB_TRUNCL = @GNULIB_TRUNCL@
-GNULIB_VASPRINTF = @GNULIB_VASPRINTF@
-GNULIB_VDPRINTF = @GNULIB_VDPRINTF@
-GNULIB_VFPRINTF = @GNULIB_VFPRINTF@
-GNULIB_VFPRINTF_POSIX = @GNULIB_VFPRINTF_POSIX@
-GNULIB_VFSCANF = @GNULIB_VFSCANF@
-GNULIB_VPRINTF = @GNULIB_VPRINTF@
-GNULIB_VPRINTF_POSIX = @GNULIB_VPRINTF_POSIX@
-GNULIB_VSCANF = @GNULIB_VSCANF@
-GNULIB_VSNPRINTF = @GNULIB_VSNPRINTF@
-GNULIB_VSPRINTF_POSIX = @GNULIB_VSPRINTF_POSIX@
-GNULIB_WCPCPY = @GNULIB_WCPCPY@
-GNULIB_WCPNCPY = @GNULIB_WCPNCPY@
-GNULIB_WCRTOMB = @GNULIB_WCRTOMB@
-GNULIB_WCSCASECMP = @GNULIB_WCSCASECMP@
-GNULIB_WCSCAT = @GNULIB_WCSCAT@
-GNULIB_WCSCHR = @GNULIB_WCSCHR@
-GNULIB_WCSCMP = @GNULIB_WCSCMP@
-GNULIB_WCSCOLL = @GNULIB_WCSCOLL@
-GNULIB_WCSCPY = @GNULIB_WCSCPY@
-GNULIB_WCSCSPN = @GNULIB_WCSCSPN@
-GNULIB_WCSDUP = @GNULIB_WCSDUP@
-GNULIB_WCSFTIME = @GNULIB_WCSFTIME@
-GNULIB_WCSLEN = @GNULIB_WCSLEN@
-GNULIB_WCSNCASECMP = @GNULIB_WCSNCASECMP@
-GNULIB_WCSNCAT = @GNULIB_WCSNCAT@
-GNULIB_WCSNCMP = @GNULIB_WCSNCMP@
-GNULIB_WCSNCPY = @GNULIB_WCSNCPY@
-GNULIB_WCSNLEN = @GNULIB_WCSNLEN@
-GNULIB_WCSNRTOMBS = @GNULIB_WCSNRTOMBS@
-GNULIB_WCSPBRK = @GNULIB_WCSPBRK@
-GNULIB_WCSRCHR = @GNULIB_WCSRCHR@
-GNULIB_WCSRTOMBS = @GNULIB_WCSRTOMBS@
-GNULIB_WCSSPN = @GNULIB_WCSSPN@
-GNULIB_WCSSTR = @GNULIB_WCSSTR@
-GNULIB_WCSTOK = @GNULIB_WCSTOK@
-GNULIB_WCSWIDTH = @GNULIB_WCSWIDTH@
-GNULIB_WCSXFRM = @GNULIB_WCSXFRM@
-GNULIB_WCTOB = @GNULIB_WCTOB@
-GNULIB_WCTRANS = @GNULIB_WCTRANS@
-GNULIB_WCTYPE = @GNULIB_WCTYPE@
-GNULIB_WCWIDTH = @GNULIB_WCWIDTH@
-GNULIB_WMEMCHR = @GNULIB_WMEMCHR@
-GNULIB_WMEMCMP = @GNULIB_WMEMCMP@
-GNULIB_WMEMCPY = @GNULIB_WMEMCPY@
-GNULIB_WMEMMOVE = @GNULIB_WMEMMOVE@
-GNULIB_WMEMSET = @GNULIB_WMEMSET@
+GL_CFLAG_ALLOW_WARNINGS = @GL_CFLAG_ALLOW_WARNINGS@
+GL_CFLAG_GNULIB_WARNINGS = @GL_CFLAG_GNULIB_WARNINGS@
+GL_GNULIB_ACCESS = @GL_GNULIB_ACCESS@
+GL_GNULIB_ACOSF = @GL_GNULIB_ACOSF@
+GL_GNULIB_ACOSL = @GL_GNULIB_ACOSL@
+GL_GNULIB_ALIGNED_ALLOC = @GL_GNULIB_ALIGNED_ALLOC@
+GL_GNULIB_ASINF = @GL_GNULIB_ASINF@
+GL_GNULIB_ASINL = @GL_GNULIB_ASINL@
+GL_GNULIB_ATAN2F = @GL_GNULIB_ATAN2F@
+GL_GNULIB_ATANF = @GL_GNULIB_ATANF@
+GL_GNULIB_ATANL = @GL_GNULIB_ATANL@
+GL_GNULIB_ATOLL = @GL_GNULIB_ATOLL@
+GL_GNULIB_BTOWC = @GL_GNULIB_BTOWC@
+GL_GNULIB_CALLOC_GNU = @GL_GNULIB_CALLOC_GNU@
+GL_GNULIB_CALLOC_POSIX = @GL_GNULIB_CALLOC_POSIX@
+GL_GNULIB_CANONICALIZE_FILE_NAME = @GL_GNULIB_CANONICALIZE_FILE_NAME@
+GL_GNULIB_CBRT = @GL_GNULIB_CBRT@
+GL_GNULIB_CBRTF = @GL_GNULIB_CBRTF@
+GL_GNULIB_CBRTL = @GL_GNULIB_CBRTL@
+GL_GNULIB_CEIL = @GL_GNULIB_CEIL@
+GL_GNULIB_CEILF = @GL_GNULIB_CEILF@
+GL_GNULIB_CEILL = @GL_GNULIB_CEILL@
+GL_GNULIB_CHDIR = @GL_GNULIB_CHDIR@
+GL_GNULIB_CHOWN = @GL_GNULIB_CHOWN@
+GL_GNULIB_CLOSE = @GL_GNULIB_CLOSE@
+GL_GNULIB_COPYSIGN = @GL_GNULIB_COPYSIGN@
+GL_GNULIB_COPYSIGNF = @GL_GNULIB_COPYSIGNF@
+GL_GNULIB_COPYSIGNL = @GL_GNULIB_COPYSIGNL@
+GL_GNULIB_COPY_FILE_RANGE = @GL_GNULIB_COPY_FILE_RANGE@
+GL_GNULIB_COSF = @GL_GNULIB_COSF@
+GL_GNULIB_COSHF = @GL_GNULIB_COSHF@
+GL_GNULIB_COSL = @GL_GNULIB_COSL@
+GL_GNULIB_DPRINTF = @GL_GNULIB_DPRINTF@
+GL_GNULIB_DUP = @GL_GNULIB_DUP@
+GL_GNULIB_DUP2 = @GL_GNULIB_DUP2@
+GL_GNULIB_DUP3 = @GL_GNULIB_DUP3@
+GL_GNULIB_ENVIRON = @GL_GNULIB_ENVIRON@
+GL_GNULIB_EUIDACCESS = @GL_GNULIB_EUIDACCESS@
+GL_GNULIB_EXECL = @GL_GNULIB_EXECL@
+GL_GNULIB_EXECLE = @GL_GNULIB_EXECLE@
+GL_GNULIB_EXECLP = @GL_GNULIB_EXECLP@
+GL_GNULIB_EXECV = @GL_GNULIB_EXECV@
+GL_GNULIB_EXECVE = @GL_GNULIB_EXECVE@
+GL_GNULIB_EXECVP = @GL_GNULIB_EXECVP@
+GL_GNULIB_EXECVPE = @GL_GNULIB_EXECVPE@
+GL_GNULIB_EXP2 = @GL_GNULIB_EXP2@
+GL_GNULIB_EXP2F = @GL_GNULIB_EXP2F@
+GL_GNULIB_EXP2L = @GL_GNULIB_EXP2L@
+GL_GNULIB_EXPF = @GL_GNULIB_EXPF@
+GL_GNULIB_EXPL = @GL_GNULIB_EXPL@
+GL_GNULIB_EXPLICIT_BZERO = @GL_GNULIB_EXPLICIT_BZERO@
+GL_GNULIB_EXPM1 = @GL_GNULIB_EXPM1@
+GL_GNULIB_EXPM1F = @GL_GNULIB_EXPM1F@
+GL_GNULIB_EXPM1L = @GL_GNULIB_EXPM1L@
+GL_GNULIB_FABSF = @GL_GNULIB_FABSF@
+GL_GNULIB_FABSL = @GL_GNULIB_FABSL@
+GL_GNULIB_FACCESSAT = @GL_GNULIB_FACCESSAT@
+GL_GNULIB_FCHDIR = @GL_GNULIB_FCHDIR@
+GL_GNULIB_FCHOWNAT = @GL_GNULIB_FCHOWNAT@
+GL_GNULIB_FCLOSE = @GL_GNULIB_FCLOSE@
+GL_GNULIB_FDATASYNC = @GL_GNULIB_FDATASYNC@
+GL_GNULIB_FDOPEN = @GL_GNULIB_FDOPEN@
+GL_GNULIB_FFLUSH = @GL_GNULIB_FFLUSH@
+GL_GNULIB_FFSL = @GL_GNULIB_FFSL@
+GL_GNULIB_FFSLL = @GL_GNULIB_FFSLL@
+GL_GNULIB_FGETC = @GL_GNULIB_FGETC@
+GL_GNULIB_FGETS = @GL_GNULIB_FGETS@
+GL_GNULIB_FLOOR = @GL_GNULIB_FLOOR@
+GL_GNULIB_FLOORF = @GL_GNULIB_FLOORF@
+GL_GNULIB_FLOORL = @GL_GNULIB_FLOORL@
+GL_GNULIB_FMA = @GL_GNULIB_FMA@
+GL_GNULIB_FMAF = @GL_GNULIB_FMAF@
+GL_GNULIB_FMAL = @GL_GNULIB_FMAL@
+GL_GNULIB_FMOD = @GL_GNULIB_FMOD@
+GL_GNULIB_FMODF = @GL_GNULIB_FMODF@
+GL_GNULIB_FMODL = @GL_GNULIB_FMODL@
+GL_GNULIB_FOPEN = @GL_GNULIB_FOPEN@
+GL_GNULIB_FOPEN_GNU = @GL_GNULIB_FOPEN_GNU@
+GL_GNULIB_FPRINTF = @GL_GNULIB_FPRINTF@
+GL_GNULIB_FPRINTF_POSIX = @GL_GNULIB_FPRINTF_POSIX@
+GL_GNULIB_FPURGE = @GL_GNULIB_FPURGE@
+GL_GNULIB_FPUTC = @GL_GNULIB_FPUTC@
+GL_GNULIB_FPUTS = @GL_GNULIB_FPUTS@
+GL_GNULIB_FREAD = @GL_GNULIB_FREAD@
+GL_GNULIB_FREE_POSIX = @GL_GNULIB_FREE_POSIX@
+GL_GNULIB_FREOPEN = @GL_GNULIB_FREOPEN@
+GL_GNULIB_FREXP = @GL_GNULIB_FREXP@
+GL_GNULIB_FREXPF = @GL_GNULIB_FREXPF@
+GL_GNULIB_FREXPL = @GL_GNULIB_FREXPL@
+GL_GNULIB_FSCANF = @GL_GNULIB_FSCANF@
+GL_GNULIB_FSEEK = @GL_GNULIB_FSEEK@
+GL_GNULIB_FSEEKO = @GL_GNULIB_FSEEKO@
+GL_GNULIB_FSYNC = @GL_GNULIB_FSYNC@
+GL_GNULIB_FTELL = @GL_GNULIB_FTELL@
+GL_GNULIB_FTELLO = @GL_GNULIB_FTELLO@
+GL_GNULIB_FTRUNCATE = @GL_GNULIB_FTRUNCATE@
+GL_GNULIB_FWRITE = @GL_GNULIB_FWRITE@
+GL_GNULIB_GETC = @GL_GNULIB_GETC@
+GL_GNULIB_GETCHAR = @GL_GNULIB_GETCHAR@
+GL_GNULIB_GETCWD = @GL_GNULIB_GETCWD@
+GL_GNULIB_GETDELIM = @GL_GNULIB_GETDELIM@
+GL_GNULIB_GETDOMAINNAME = @GL_GNULIB_GETDOMAINNAME@
+GL_GNULIB_GETDTABLESIZE = @GL_GNULIB_GETDTABLESIZE@
+GL_GNULIB_GETENTROPY = @GL_GNULIB_GETENTROPY@
+GL_GNULIB_GETGROUPS = @GL_GNULIB_GETGROUPS@
+GL_GNULIB_GETHOSTNAME = @GL_GNULIB_GETHOSTNAME@
+GL_GNULIB_GETLINE = @GL_GNULIB_GETLINE@
+GL_GNULIB_GETLOADAVG = @GL_GNULIB_GETLOADAVG@
+GL_GNULIB_GETLOGIN = @GL_GNULIB_GETLOGIN@
+GL_GNULIB_GETLOGIN_R = @GL_GNULIB_GETLOGIN_R@
+GL_GNULIB_GETOPT_POSIX = @GL_GNULIB_GETOPT_POSIX@
+GL_GNULIB_GETPAGESIZE = @GL_GNULIB_GETPAGESIZE@
+GL_GNULIB_GETPASS = @GL_GNULIB_GETPASS@
+GL_GNULIB_GETPASS_GNU = @GL_GNULIB_GETPASS_GNU@
+GL_GNULIB_GETPROGNAME = @GL_GNULIB_GETPROGNAME@
+GL_GNULIB_GETSUBOPT = @GL_GNULIB_GETSUBOPT@
+GL_GNULIB_GETUSERSHELL = @GL_GNULIB_GETUSERSHELL@
+GL_GNULIB_GRANTPT = @GL_GNULIB_GRANTPT@
+GL_GNULIB_GROUP_MEMBER = @GL_GNULIB_GROUP_MEMBER@
+GL_GNULIB_HYPOT = @GL_GNULIB_HYPOT@
+GL_GNULIB_HYPOTF = @GL_GNULIB_HYPOTF@
+GL_GNULIB_HYPOTL = @GL_GNULIB_HYPOTL@
+GL_GNULIB_ILOGB = @GL_GNULIB_ILOGB@
+GL_GNULIB_ILOGBF = @GL_GNULIB_ILOGBF@
+GL_GNULIB_ILOGBL = @GL_GNULIB_ILOGBL@
+GL_GNULIB_IMAXABS = @GL_GNULIB_IMAXABS@
+GL_GNULIB_IMAXDIV = @GL_GNULIB_IMAXDIV@
+GL_GNULIB_ISATTY = @GL_GNULIB_ISATTY@
+GL_GNULIB_ISFINITE = @GL_GNULIB_ISFINITE@
+GL_GNULIB_ISINF = @GL_GNULIB_ISINF@
+GL_GNULIB_ISNAN = @GL_GNULIB_ISNAN@
+GL_GNULIB_ISNAND = @GL_GNULIB_ISNAND@
+GL_GNULIB_ISNANF = @GL_GNULIB_ISNANF@
+GL_GNULIB_ISNANL = @GL_GNULIB_ISNANL@
+GL_GNULIB_ISWBLANK = @GL_GNULIB_ISWBLANK@
+GL_GNULIB_ISWCTYPE = @GL_GNULIB_ISWCTYPE@
+GL_GNULIB_ISWDIGIT = @GL_GNULIB_ISWDIGIT@
+GL_GNULIB_ISWXDIGIT = @GL_GNULIB_ISWXDIGIT@
+GL_GNULIB_LCHOWN = @GL_GNULIB_LCHOWN@
+GL_GNULIB_LDEXPF = @GL_GNULIB_LDEXPF@
+GL_GNULIB_LDEXPL = @GL_GNULIB_LDEXPL@
+GL_GNULIB_LINK = @GL_GNULIB_LINK@
+GL_GNULIB_LINKAT = @GL_GNULIB_LINKAT@
+GL_GNULIB_LOG = @GL_GNULIB_LOG@
+GL_GNULIB_LOG10 = @GL_GNULIB_LOG10@
+GL_GNULIB_LOG10F = @GL_GNULIB_LOG10F@
+GL_GNULIB_LOG10L = @GL_GNULIB_LOG10L@
+GL_GNULIB_LOG1P = @GL_GNULIB_LOG1P@
+GL_GNULIB_LOG1PF = @GL_GNULIB_LOG1PF@
+GL_GNULIB_LOG1PL = @GL_GNULIB_LOG1PL@
+GL_GNULIB_LOG2 = @GL_GNULIB_LOG2@
+GL_GNULIB_LOG2F = @GL_GNULIB_LOG2F@
+GL_GNULIB_LOG2L = @GL_GNULIB_LOG2L@
+GL_GNULIB_LOGB = @GL_GNULIB_LOGB@
+GL_GNULIB_LOGBF = @GL_GNULIB_LOGBF@
+GL_GNULIB_LOGBL = @GL_GNULIB_LOGBL@
+GL_GNULIB_LOGF = @GL_GNULIB_LOGF@
+GL_GNULIB_LOGL = @GL_GNULIB_LOGL@
+GL_GNULIB_LSEEK = @GL_GNULIB_LSEEK@
+GL_GNULIB_MALLOC_GNU = @GL_GNULIB_MALLOC_GNU@
+GL_GNULIB_MALLOC_POSIX = @GL_GNULIB_MALLOC_POSIX@
+GL_GNULIB_MBRLEN = @GL_GNULIB_MBRLEN@
+GL_GNULIB_MBRTOWC = @GL_GNULIB_MBRTOWC@
+GL_GNULIB_MBSCASECMP = @GL_GNULIB_MBSCASECMP@
+GL_GNULIB_MBSCASESTR = @GL_GNULIB_MBSCASESTR@
+GL_GNULIB_MBSCHR = @GL_GNULIB_MBSCHR@
+GL_GNULIB_MBSCSPN = @GL_GNULIB_MBSCSPN@
+GL_GNULIB_MBSINIT = @GL_GNULIB_MBSINIT@
+GL_GNULIB_MBSLEN = @GL_GNULIB_MBSLEN@
+GL_GNULIB_MBSNCASECMP = @GL_GNULIB_MBSNCASECMP@
+GL_GNULIB_MBSNLEN = @GL_GNULIB_MBSNLEN@
+GL_GNULIB_MBSNRTOWCS = @GL_GNULIB_MBSNRTOWCS@
+GL_GNULIB_MBSPBRK = @GL_GNULIB_MBSPBRK@
+GL_GNULIB_MBSPCASECMP = @GL_GNULIB_MBSPCASECMP@
+GL_GNULIB_MBSRCHR = @GL_GNULIB_MBSRCHR@
+GL_GNULIB_MBSRTOWCS = @GL_GNULIB_MBSRTOWCS@
+GL_GNULIB_MBSSEP = @GL_GNULIB_MBSSEP@
+GL_GNULIB_MBSSPN = @GL_GNULIB_MBSSPN@
+GL_GNULIB_MBSSTR = @GL_GNULIB_MBSSTR@
+GL_GNULIB_MBSTOK_R = @GL_GNULIB_MBSTOK_R@
+GL_GNULIB_MBTOWC = @GL_GNULIB_MBTOWC@
+GL_GNULIB_MDA_ACCESS = @GL_GNULIB_MDA_ACCESS@
+GL_GNULIB_MDA_CHDIR = @GL_GNULIB_MDA_CHDIR@
+GL_GNULIB_MDA_CLOSE = @GL_GNULIB_MDA_CLOSE@
+GL_GNULIB_MDA_DUP = @GL_GNULIB_MDA_DUP@
+GL_GNULIB_MDA_DUP2 = @GL_GNULIB_MDA_DUP2@
+GL_GNULIB_MDA_ECVT = @GL_GNULIB_MDA_ECVT@
+GL_GNULIB_MDA_EXECL = @GL_GNULIB_MDA_EXECL@
+GL_GNULIB_MDA_EXECLE = @GL_GNULIB_MDA_EXECLE@
+GL_GNULIB_MDA_EXECLP = @GL_GNULIB_MDA_EXECLP@
+GL_GNULIB_MDA_EXECV = @GL_GNULIB_MDA_EXECV@
+GL_GNULIB_MDA_EXECVE = @GL_GNULIB_MDA_EXECVE@
+GL_GNULIB_MDA_EXECVP = @GL_GNULIB_MDA_EXECVP@
+GL_GNULIB_MDA_EXECVPE = @GL_GNULIB_MDA_EXECVPE@
+GL_GNULIB_MDA_FCLOSEALL = @GL_GNULIB_MDA_FCLOSEALL@
+GL_GNULIB_MDA_FCVT = @GL_GNULIB_MDA_FCVT@
+GL_GNULIB_MDA_FDOPEN = @GL_GNULIB_MDA_FDOPEN@
+GL_GNULIB_MDA_FILENO = @GL_GNULIB_MDA_FILENO@
+GL_GNULIB_MDA_GCVT = @GL_GNULIB_MDA_GCVT@
+GL_GNULIB_MDA_GETCWD = @GL_GNULIB_MDA_GETCWD@
+GL_GNULIB_MDA_GETPID = @GL_GNULIB_MDA_GETPID@
+GL_GNULIB_MDA_GETW = @GL_GNULIB_MDA_GETW@
+GL_GNULIB_MDA_ISATTY = @GL_GNULIB_MDA_ISATTY@
+GL_GNULIB_MDA_J0 = @GL_GNULIB_MDA_J0@
+GL_GNULIB_MDA_J1 = @GL_GNULIB_MDA_J1@
+GL_GNULIB_MDA_JN = @GL_GNULIB_MDA_JN@
+GL_GNULIB_MDA_LSEEK = @GL_GNULIB_MDA_LSEEK@
+GL_GNULIB_MDA_MEMCCPY = @GL_GNULIB_MDA_MEMCCPY@
+GL_GNULIB_MDA_MKTEMP = @GL_GNULIB_MDA_MKTEMP@
+GL_GNULIB_MDA_PUTENV = @GL_GNULIB_MDA_PUTENV@
+GL_GNULIB_MDA_PUTW = @GL_GNULIB_MDA_PUTW@
+GL_GNULIB_MDA_READ = @GL_GNULIB_MDA_READ@
+GL_GNULIB_MDA_RMDIR = @GL_GNULIB_MDA_RMDIR@
+GL_GNULIB_MDA_STRDUP = @GL_GNULIB_MDA_STRDUP@
+GL_GNULIB_MDA_SWAB = @GL_GNULIB_MDA_SWAB@
+GL_GNULIB_MDA_TEMPNAM = @GL_GNULIB_MDA_TEMPNAM@
+GL_GNULIB_MDA_UNLINK = @GL_GNULIB_MDA_UNLINK@
+GL_GNULIB_MDA_WCSDUP = @GL_GNULIB_MDA_WCSDUP@
+GL_GNULIB_MDA_WRITE = @GL_GNULIB_MDA_WRITE@
+GL_GNULIB_MDA_Y0 = @GL_GNULIB_MDA_Y0@
+GL_GNULIB_MDA_Y1 = @GL_GNULIB_MDA_Y1@
+GL_GNULIB_MDA_YN = @GL_GNULIB_MDA_YN@
+GL_GNULIB_MEMCHR = @GL_GNULIB_MEMCHR@
+GL_GNULIB_MEMMEM = @GL_GNULIB_MEMMEM@
+GL_GNULIB_MEMPCPY = @GL_GNULIB_MEMPCPY@
+GL_GNULIB_MEMRCHR = @GL_GNULIB_MEMRCHR@
+GL_GNULIB_MEMSET_EXPLICIT = @GL_GNULIB_MEMSET_EXPLICIT@
+GL_GNULIB_MKDTEMP = @GL_GNULIB_MKDTEMP@
+GL_GNULIB_MKOSTEMP = @GL_GNULIB_MKOSTEMP@
+GL_GNULIB_MKOSTEMPS = @GL_GNULIB_MKOSTEMPS@
+GL_GNULIB_MKSTEMP = @GL_GNULIB_MKSTEMP@
+GL_GNULIB_MKSTEMPS = @GL_GNULIB_MKSTEMPS@
+GL_GNULIB_MODF = @GL_GNULIB_MODF@
+GL_GNULIB_MODFF = @GL_GNULIB_MODFF@
+GL_GNULIB_MODFL = @GL_GNULIB_MODFL@
+GL_GNULIB_OBSTACK_PRINTF = @GL_GNULIB_OBSTACK_PRINTF@
+GL_GNULIB_OBSTACK_PRINTF_POSIX = @GL_GNULIB_OBSTACK_PRINTF_POSIX@
+GL_GNULIB_PCLOSE = @GL_GNULIB_PCLOSE@
+GL_GNULIB_PERROR = @GL_GNULIB_PERROR@
+GL_GNULIB_PIPE = @GL_GNULIB_PIPE@
+GL_GNULIB_PIPE2 = @GL_GNULIB_PIPE2@
+GL_GNULIB_POPEN = @GL_GNULIB_POPEN@
+GL_GNULIB_POSIX_MEMALIGN = @GL_GNULIB_POSIX_MEMALIGN@
+GL_GNULIB_POSIX_OPENPT = @GL_GNULIB_POSIX_OPENPT@
+GL_GNULIB_POWF = @GL_GNULIB_POWF@
+GL_GNULIB_PREAD = @GL_GNULIB_PREAD@
+GL_GNULIB_PRINTF = @GL_GNULIB_PRINTF@
+GL_GNULIB_PRINTF_POSIX = @GL_GNULIB_PRINTF_POSIX@
+GL_GNULIB_PTSNAME = @GL_GNULIB_PTSNAME@
+GL_GNULIB_PTSNAME_R = @GL_GNULIB_PTSNAME_R@
+GL_GNULIB_PUTC = @GL_GNULIB_PUTC@
+GL_GNULIB_PUTCHAR = @GL_GNULIB_PUTCHAR@
+GL_GNULIB_PUTENV = @GL_GNULIB_PUTENV@
+GL_GNULIB_PUTS = @GL_GNULIB_PUTS@
+GL_GNULIB_PWRITE = @GL_GNULIB_PWRITE@
+GL_GNULIB_QSORT_R = @GL_GNULIB_QSORT_R@
+GL_GNULIB_RANDOM = @GL_GNULIB_RANDOM@
+GL_GNULIB_RANDOM_R = @GL_GNULIB_RANDOM_R@
+GL_GNULIB_RAWMEMCHR = @GL_GNULIB_RAWMEMCHR@
+GL_GNULIB_READ = @GL_GNULIB_READ@
+GL_GNULIB_READLINK = @GL_GNULIB_READLINK@
+GL_GNULIB_READLINKAT = @GL_GNULIB_READLINKAT@
+GL_GNULIB_REALLOCARRAY = @GL_GNULIB_REALLOCARRAY@
+GL_GNULIB_REALLOC_GNU = @GL_GNULIB_REALLOC_GNU@
+GL_GNULIB_REALLOC_POSIX = @GL_GNULIB_REALLOC_POSIX@
+GL_GNULIB_REALPATH = @GL_GNULIB_REALPATH@
+GL_GNULIB_REMAINDER = @GL_GNULIB_REMAINDER@
+GL_GNULIB_REMAINDERF = @GL_GNULIB_REMAINDERF@
+GL_GNULIB_REMAINDERL = @GL_GNULIB_REMAINDERL@
+GL_GNULIB_REMOVE = @GL_GNULIB_REMOVE@
+GL_GNULIB_RENAME = @GL_GNULIB_RENAME@
+GL_GNULIB_RENAMEAT = @GL_GNULIB_RENAMEAT@
+GL_GNULIB_RINT = @GL_GNULIB_RINT@
+GL_GNULIB_RINTF = @GL_GNULIB_RINTF@
+GL_GNULIB_RINTL = @GL_GNULIB_RINTL@
+GL_GNULIB_RMDIR = @GL_GNULIB_RMDIR@
+GL_GNULIB_ROUND = @GL_GNULIB_ROUND@
+GL_GNULIB_ROUNDF = @GL_GNULIB_ROUNDF@
+GL_GNULIB_ROUNDL = @GL_GNULIB_ROUNDL@
+GL_GNULIB_RPMATCH = @GL_GNULIB_RPMATCH@
+GL_GNULIB_SCANF = @GL_GNULIB_SCANF@
+GL_GNULIB_SECURE_GETENV = @GL_GNULIB_SECURE_GETENV@
+GL_GNULIB_SETENV = @GL_GNULIB_SETENV@
+GL_GNULIB_SETHOSTNAME = @GL_GNULIB_SETHOSTNAME@
+GL_GNULIB_SIGABBREV_NP = @GL_GNULIB_SIGABBREV_NP@
+GL_GNULIB_SIGDESCR_NP = @GL_GNULIB_SIGDESCR_NP@
+GL_GNULIB_SIGNBIT = @GL_GNULIB_SIGNBIT@
+GL_GNULIB_SINF = @GL_GNULIB_SINF@
+GL_GNULIB_SINHF = @GL_GNULIB_SINHF@
+GL_GNULIB_SINL = @GL_GNULIB_SINL@
+GL_GNULIB_SLEEP = @GL_GNULIB_SLEEP@
+GL_GNULIB_SNPRINTF = @GL_GNULIB_SNPRINTF@
+GL_GNULIB_SPRINTF_POSIX = @GL_GNULIB_SPRINTF_POSIX@
+GL_GNULIB_SQRTF = @GL_GNULIB_SQRTF@
+GL_GNULIB_SQRTL = @GL_GNULIB_SQRTL@
+GL_GNULIB_STDIO_H_NONBLOCKING = @GL_GNULIB_STDIO_H_NONBLOCKING@
+GL_GNULIB_STDIO_H_SIGPIPE = @GL_GNULIB_STDIO_H_SIGPIPE@
+GL_GNULIB_STPCPY = @GL_GNULIB_STPCPY@
+GL_GNULIB_STPNCPY = @GL_GNULIB_STPNCPY@
+GL_GNULIB_STRCASESTR = @GL_GNULIB_STRCASESTR@
+GL_GNULIB_STRCHRNUL = @GL_GNULIB_STRCHRNUL@
+GL_GNULIB_STRDUP = @GL_GNULIB_STRDUP@
+GL_GNULIB_STRERROR = @GL_GNULIB_STRERROR@
+GL_GNULIB_STRERRORNAME_NP = @GL_GNULIB_STRERRORNAME_NP@
+GL_GNULIB_STRERROR_R = @GL_GNULIB_STRERROR_R@
+GL_GNULIB_STRNCAT = @GL_GNULIB_STRNCAT@
+GL_GNULIB_STRNDUP = @GL_GNULIB_STRNDUP@
+GL_GNULIB_STRNLEN = @GL_GNULIB_STRNLEN@
+GL_GNULIB_STRPBRK = @GL_GNULIB_STRPBRK@
+GL_GNULIB_STRSEP = @GL_GNULIB_STRSEP@
+GL_GNULIB_STRSIGNAL = @GL_GNULIB_STRSIGNAL@
+GL_GNULIB_STRSTR = @GL_GNULIB_STRSTR@
+GL_GNULIB_STRTOD = @GL_GNULIB_STRTOD@
+GL_GNULIB_STRTOIMAX = @GL_GNULIB_STRTOIMAX@
+GL_GNULIB_STRTOK_R = @GL_GNULIB_STRTOK_R@
+GL_GNULIB_STRTOL = @GL_GNULIB_STRTOL@
+GL_GNULIB_STRTOLD = @GL_GNULIB_STRTOLD@
+GL_GNULIB_STRTOLL = @GL_GNULIB_STRTOLL@
+GL_GNULIB_STRTOUL = @GL_GNULIB_STRTOUL@
+GL_GNULIB_STRTOULL = @GL_GNULIB_STRTOULL@
+GL_GNULIB_STRTOUMAX = @GL_GNULIB_STRTOUMAX@
+GL_GNULIB_STRVERSCMP = @GL_GNULIB_STRVERSCMP@
+GL_GNULIB_SYMLINK = @GL_GNULIB_SYMLINK@
+GL_GNULIB_SYMLINKAT = @GL_GNULIB_SYMLINKAT@
+GL_GNULIB_SYSTEM_POSIX = @GL_GNULIB_SYSTEM_POSIX@
+GL_GNULIB_TANF = @GL_GNULIB_TANF@
+GL_GNULIB_TANHF = @GL_GNULIB_TANHF@
+GL_GNULIB_TANL = @GL_GNULIB_TANL@
+GL_GNULIB_TMPFILE = @GL_GNULIB_TMPFILE@
+GL_GNULIB_TOWCTRANS = @GL_GNULIB_TOWCTRANS@
+GL_GNULIB_TRUNC = @GL_GNULIB_TRUNC@
+GL_GNULIB_TRUNCATE = @GL_GNULIB_TRUNCATE@
+GL_GNULIB_TRUNCF = @GL_GNULIB_TRUNCF@
+GL_GNULIB_TRUNCL = @GL_GNULIB_TRUNCL@
+GL_GNULIB_TTYNAME_R = @GL_GNULIB_TTYNAME_R@
+GL_GNULIB_UNISTD_H_GETOPT = @GL_GNULIB_UNISTD_H_GETOPT@
+GL_GNULIB_UNISTD_H_NONBLOCKING = @GL_GNULIB_UNISTD_H_NONBLOCKING@
+GL_GNULIB_UNISTD_H_SIGPIPE = @GL_GNULIB_UNISTD_H_SIGPIPE@
+GL_GNULIB_UNLINK = @GL_GNULIB_UNLINK@
+GL_GNULIB_UNLINKAT = @GL_GNULIB_UNLINKAT@
+GL_GNULIB_UNLOCKPT = @GL_GNULIB_UNLOCKPT@
+GL_GNULIB_UNSETENV = @GL_GNULIB_UNSETENV@
+GL_GNULIB_USLEEP = @GL_GNULIB_USLEEP@
+GL_GNULIB_VASPRINTF = @GL_GNULIB_VASPRINTF@
+GL_GNULIB_VDPRINTF = @GL_GNULIB_VDPRINTF@
+GL_GNULIB_VFPRINTF = @GL_GNULIB_VFPRINTF@
+GL_GNULIB_VFPRINTF_POSIX = @GL_GNULIB_VFPRINTF_POSIX@
+GL_GNULIB_VFSCANF = @GL_GNULIB_VFSCANF@
+GL_GNULIB_VPRINTF = @GL_GNULIB_VPRINTF@
+GL_GNULIB_VPRINTF_POSIX = @GL_GNULIB_VPRINTF_POSIX@
+GL_GNULIB_VSCANF = @GL_GNULIB_VSCANF@
+GL_GNULIB_VSNPRINTF = @GL_GNULIB_VSNPRINTF@
+GL_GNULIB_VSPRINTF_POSIX = @GL_GNULIB_VSPRINTF_POSIX@
+GL_GNULIB_WCPCPY = @GL_GNULIB_WCPCPY@
+GL_GNULIB_WCPNCPY = @GL_GNULIB_WCPNCPY@
+GL_GNULIB_WCRTOMB = @GL_GNULIB_WCRTOMB@
+GL_GNULIB_WCSCASECMP = @GL_GNULIB_WCSCASECMP@
+GL_GNULIB_WCSCAT = @GL_GNULIB_WCSCAT@
+GL_GNULIB_WCSCHR = @GL_GNULIB_WCSCHR@
+GL_GNULIB_WCSCMP = @GL_GNULIB_WCSCMP@
+GL_GNULIB_WCSCOLL = @GL_GNULIB_WCSCOLL@
+GL_GNULIB_WCSCPY = @GL_GNULIB_WCSCPY@
+GL_GNULIB_WCSCSPN = @GL_GNULIB_WCSCSPN@
+GL_GNULIB_WCSDUP = @GL_GNULIB_WCSDUP@
+GL_GNULIB_WCSFTIME = @GL_GNULIB_WCSFTIME@
+GL_GNULIB_WCSLEN = @GL_GNULIB_WCSLEN@
+GL_GNULIB_WCSNCASECMP = @GL_GNULIB_WCSNCASECMP@
+GL_GNULIB_WCSNCAT = @GL_GNULIB_WCSNCAT@
+GL_GNULIB_WCSNCMP = @GL_GNULIB_WCSNCMP@
+GL_GNULIB_WCSNCPY = @GL_GNULIB_WCSNCPY@
+GL_GNULIB_WCSNLEN = @GL_GNULIB_WCSNLEN@
+GL_GNULIB_WCSNRTOMBS = @GL_GNULIB_WCSNRTOMBS@
+GL_GNULIB_WCSPBRK = @GL_GNULIB_WCSPBRK@
+GL_GNULIB_WCSRCHR = @GL_GNULIB_WCSRCHR@
+GL_GNULIB_WCSRTOMBS = @GL_GNULIB_WCSRTOMBS@
+GL_GNULIB_WCSSPN = @GL_GNULIB_WCSSPN@
+GL_GNULIB_WCSSTR = @GL_GNULIB_WCSSTR@
+GL_GNULIB_WCSTOK = @GL_GNULIB_WCSTOK@
+GL_GNULIB_WCSWIDTH = @GL_GNULIB_WCSWIDTH@
+GL_GNULIB_WCSXFRM = @GL_GNULIB_WCSXFRM@
+GL_GNULIB_WCTOB = @GL_GNULIB_WCTOB@
+GL_GNULIB_WCTOMB = @GL_GNULIB_WCTOMB@
+GL_GNULIB_WCTRANS = @GL_GNULIB_WCTRANS@
+GL_GNULIB_WCTYPE = @GL_GNULIB_WCTYPE@
+GL_GNULIB_WCWIDTH = @GL_GNULIB_WCWIDTH@
+GL_GNULIB_WMEMCHR = @GL_GNULIB_WMEMCHR@
+GL_GNULIB_WMEMCMP = @GL_GNULIB_WMEMCMP@
+GL_GNULIB_WMEMCPY = @GL_GNULIB_WMEMCPY@
+GL_GNULIB_WMEMMOVE = @GL_GNULIB_WMEMMOVE@
+GL_GNULIB_WMEMPCPY = @GL_GNULIB_WMEMPCPY@
+GL_GNULIB_WMEMSET = @GL_GNULIB_WMEMSET@
+GL_GNULIB_WRITE = @GL_GNULIB_WRITE@
+GL_GNULIB__EXIT = @GL_GNULIB__EXIT@
+GNULIBHEADERS_OVERRIDE_WINT_T = @GNULIBHEADERS_OVERRIDE_WINT_T@
 GREP = @GREP@
 GROFF_PATH_SEPARATOR = @GROFF_PATH_SEPARATOR@
 HAVE_ACOSF = @HAVE_ACOSF@
 HAVE_ACOSL = @HAVE_ACOSL@
+HAVE_ALIGNED_ALLOC = @HAVE_ALIGNED_ALLOC@
+HAVE_ALLOCA_H = @HAVE_ALLOCA_H@
 HAVE_ASINF = @HAVE_ASINF@
 HAVE_ASINL = @HAVE_ASINL@
 HAVE_ATAN2F = @HAVE_ATAN2F@
 HAVE_ATANF = @HAVE_ATANF@
 HAVE_ATANL = @HAVE_ATANL@
+HAVE_ATOLL = @HAVE_ATOLL@
 HAVE_BTOWC = @HAVE_BTOWC@
 HAVE_C99_STDINT_H = @HAVE_C99_STDINT_H@
+HAVE_CANONICALIZE_FILE_NAME = @HAVE_CANONICALIZE_FILE_NAME@
 HAVE_CBRT = @HAVE_CBRT@
 HAVE_CBRTF = @HAVE_CBRTF@
 HAVE_CBRTL = @HAVE_CBRTL@
+HAVE_CHOWN = @HAVE_CHOWN@
 HAVE_COPYSIGN = @HAVE_COPYSIGN@
 HAVE_COPYSIGNL = @HAVE_COPYSIGNL@
+HAVE_COPY_FILE_RANGE = @HAVE_COPY_FILE_RANGE@
 HAVE_COSF = @HAVE_COSF@
 HAVE_COSHF = @HAVE_COSHF@
 HAVE_COSL = @HAVE_COSL@
@@ -2911,19 +2995,37 @@
 HAVE_DECL_CEILL = @HAVE_DECL_CEILL@
 HAVE_DECL_COPYSIGNF = @HAVE_DECL_COPYSIGNF@
 HAVE_DECL_COSL = @HAVE_DECL_COSL@
+HAVE_DECL_ECVT = @HAVE_DECL_ECVT@
+HAVE_DECL_ENVIRON = @HAVE_DECL_ENVIRON@
+HAVE_DECL_EXECVPE = @HAVE_DECL_EXECVPE@
 HAVE_DECL_EXP2 = @HAVE_DECL_EXP2@
 HAVE_DECL_EXP2F = @HAVE_DECL_EXP2F@
 HAVE_DECL_EXP2L = @HAVE_DECL_EXP2L@
 HAVE_DECL_EXPL = @HAVE_DECL_EXPL@
 HAVE_DECL_EXPM1L = @HAVE_DECL_EXPM1L@
+HAVE_DECL_FCHDIR = @HAVE_DECL_FCHDIR@
+HAVE_DECL_FCLOSEALL = @HAVE_DECL_FCLOSEALL@
+HAVE_DECL_FCVT = @HAVE_DECL_FCVT@
+HAVE_DECL_FDATASYNC = @HAVE_DECL_FDATASYNC@
 HAVE_DECL_FLOORF = @HAVE_DECL_FLOORF@
 HAVE_DECL_FLOORL = @HAVE_DECL_FLOORL@
 HAVE_DECL_FPURGE = @HAVE_DECL_FPURGE@
 HAVE_DECL_FREXPL = @HAVE_DECL_FREXPL@
 HAVE_DECL_FSEEKO = @HAVE_DECL_FSEEKO@
 HAVE_DECL_FTELLO = @HAVE_DECL_FTELLO@
+HAVE_DECL_GCVT = @HAVE_DECL_GCVT@
 HAVE_DECL_GETDELIM = @HAVE_DECL_GETDELIM@
+HAVE_DECL_GETDOMAINNAME = @HAVE_DECL_GETDOMAINNAME@
 HAVE_DECL_GETLINE = @HAVE_DECL_GETLINE@
+HAVE_DECL_GETLOADAVG = @HAVE_DECL_GETLOADAVG@
+HAVE_DECL_GETLOGIN = @HAVE_DECL_GETLOGIN@
+HAVE_DECL_GETLOGIN_R = @HAVE_DECL_GETLOGIN_R@
+HAVE_DECL_GETPAGESIZE = @HAVE_DECL_GETPAGESIZE@
+HAVE_DECL_GETUSERSHELL = @HAVE_DECL_GETUSERSHELL@
+HAVE_DECL_GETW = @HAVE_DECL_GETW@
+HAVE_DECL_IMAXABS = @HAVE_DECL_IMAXABS@
+HAVE_DECL_IMAXDIV = @HAVE_DECL_IMAXDIV@
+HAVE_DECL_INITSTATE = @HAVE_DECL_INITSTATE@
 HAVE_DECL_LDEXPL = @HAVE_DECL_LDEXPL@
 HAVE_DECL_LOG10L = @HAVE_DECL_LOG10L@
 HAVE_DECL_LOG2 = @HAVE_DECL_LOG2@
@@ -2934,12 +3036,16 @@
 HAVE_DECL_MEMMEM = @HAVE_DECL_MEMMEM@
 HAVE_DECL_MEMRCHR = @HAVE_DECL_MEMRCHR@
 HAVE_DECL_OBSTACK_PRINTF = @HAVE_DECL_OBSTACK_PRINTF@
+HAVE_DECL_PUTW = @HAVE_DECL_PUTW@
 HAVE_DECL_REMAINDER = @HAVE_DECL_REMAINDER@
 HAVE_DECL_REMAINDERL = @HAVE_DECL_REMAINDERL@
 HAVE_DECL_RINTF = @HAVE_DECL_RINTF@
 HAVE_DECL_ROUND = @HAVE_DECL_ROUND@
 HAVE_DECL_ROUNDF = @HAVE_DECL_ROUNDF@
 HAVE_DECL_ROUNDL = @HAVE_DECL_ROUNDL@
+HAVE_DECL_SETENV = @HAVE_DECL_SETENV@
+HAVE_DECL_SETHOSTNAME = @HAVE_DECL_SETHOSTNAME@
+HAVE_DECL_SETSTATE = @HAVE_DECL_SETSTATE@
 HAVE_DECL_SINL = @HAVE_DECL_SINL@
 HAVE_DECL_SNPRINTF = @HAVE_DECL_SNPRINTF@
 HAVE_DECL_SQRTL = @HAVE_DECL_SQRTL@
@@ -2948,15 +3054,24 @@
 HAVE_DECL_STRNDUP = @HAVE_DECL_STRNDUP@
 HAVE_DECL_STRNLEN = @HAVE_DECL_STRNLEN@
 HAVE_DECL_STRSIGNAL = @HAVE_DECL_STRSIGNAL@
+HAVE_DECL_STRTOIMAX = @HAVE_DECL_STRTOIMAX@
 HAVE_DECL_STRTOK_R = @HAVE_DECL_STRTOK_R@
+HAVE_DECL_STRTOUMAX = @HAVE_DECL_STRTOUMAX@
 HAVE_DECL_TANL = @HAVE_DECL_TANL@
 HAVE_DECL_TRUNC = @HAVE_DECL_TRUNC@
+HAVE_DECL_TRUNCATE = @HAVE_DECL_TRUNCATE@
 HAVE_DECL_TRUNCF = @HAVE_DECL_TRUNCF@
 HAVE_DECL_TRUNCL = @HAVE_DECL_TRUNCL@
+HAVE_DECL_TTYNAME_R = @HAVE_DECL_TTYNAME_R@
+HAVE_DECL_UNSETENV = @HAVE_DECL_UNSETENV@
 HAVE_DECL_VSNPRINTF = @HAVE_DECL_VSNPRINTF@
+HAVE_DECL_WCSDUP = @HAVE_DECL_WCSDUP@
 HAVE_DECL_WCTOB = @HAVE_DECL_WCTOB@
 HAVE_DECL_WCWIDTH = @HAVE_DECL_WCWIDTH@
 HAVE_DPRINTF = @HAVE_DPRINTF@
+HAVE_DUP3 = @HAVE_DUP3@
+HAVE_EUIDACCESS = @HAVE_EUIDACCESS@
+HAVE_EXECVPE = @HAVE_EXECVPE@
 HAVE_EXPF = @HAVE_EXPF@
 HAVE_EXPL = @HAVE_EXPL@
 HAVE_EXPLICIT_BZERO = @HAVE_EXPLICIT_BZERO@
@@ -2964,6 +3079,10 @@
 HAVE_EXPM1F = @HAVE_EXPM1F@
 HAVE_FABSF = @HAVE_FABSF@
 HAVE_FABSL = @HAVE_FABSL@
+HAVE_FACCESSAT = @HAVE_FACCESSAT@
+HAVE_FCHDIR = @HAVE_FCHDIR@
+HAVE_FCHOWNAT = @HAVE_FCHOWNAT@
+HAVE_FDATASYNC = @HAVE_FDATASYNC@
 HAVE_FEATURES_H = @HAVE_FEATURES_H@
 HAVE_FFSL = @HAVE_FFSL@
 HAVE_FFSLL = @HAVE_FFSLL@
@@ -2974,19 +3093,39 @@
 HAVE_FMODL = @HAVE_FMODL@
 HAVE_FREXPF = @HAVE_FREXPF@
 HAVE_FSEEKO = @HAVE_FSEEKO@
+HAVE_FSYNC = @HAVE_FSYNC@
 HAVE_FTELLO = @HAVE_FTELLO@
+HAVE_FTRUNCATE = @HAVE_FTRUNCATE@
+HAVE_GETDTABLESIZE = @HAVE_GETDTABLESIZE@
+HAVE_GETENTROPY = @HAVE_GETENTROPY@
+HAVE_GETGROUPS = @HAVE_GETGROUPS@
+HAVE_GETHOSTNAME = @HAVE_GETHOSTNAME@
+HAVE_GETLOGIN = @HAVE_GETLOGIN@
+HAVE_GETPAGESIZE = @HAVE_GETPAGESIZE@
+HAVE_GETPASS = @HAVE_GETPASS@
+HAVE_GETPROGNAME = @HAVE_GETPROGNAME@
+HAVE_GETSUBOPT = @HAVE_GETSUBOPT@
+HAVE_GRANTPT = @HAVE_GRANTPT@
+HAVE_GROUP_MEMBER = @HAVE_GROUP_MEMBER@
 HAVE_HYPOTF = @HAVE_HYPOTF@
 HAVE_HYPOTL = @HAVE_HYPOTL@
 HAVE_ILOGB = @HAVE_ILOGB@
 HAVE_ILOGBF = @HAVE_ILOGBF@
 HAVE_ILOGBL = @HAVE_ILOGBL@
+HAVE_IMAXABS = @HAVE_IMAXABS@
+HAVE_IMAXDIV = @HAVE_IMAXDIV@
+HAVE_IMAXDIV_T = @HAVE_IMAXDIV_T@
+HAVE_INITSTATE = @HAVE_INITSTATE@
 HAVE_INTTYPES_H = @HAVE_INTTYPES_H@
 HAVE_ISNAND = @HAVE_ISNAND@
 HAVE_ISNANF = @HAVE_ISNANF@
 HAVE_ISNANL = @HAVE_ISNANL@
 HAVE_ISWBLANK = @HAVE_ISWBLANK@
 HAVE_ISWCNTRL = @HAVE_ISWCNTRL@
+HAVE_LCHOWN = @HAVE_LCHOWN@
 HAVE_LDEXPF = @HAVE_LDEXPF@
+HAVE_LINK = @HAVE_LINK@
+HAVE_LINKAT = @HAVE_LINKAT@
 HAVE_LOG10F = @HAVE_LOG10F@
 HAVE_LOG10L = @HAVE_LOG10L@
 HAVE_LOG1P = @HAVE_LOG1P@
@@ -2996,7 +3135,6 @@
 HAVE_LOGBL = @HAVE_LOGBL@
 HAVE_LOGF = @HAVE_LOGF@
 HAVE_LOGL = @HAVE_LOGL@
-HAVE_LONG_LONG_INT = @HAVE_LONG_LONG_INT@
 HAVE_MAX_ALIGN_T = @HAVE_MAX_ALIGN_T@
 HAVE_MBRLEN = @HAVE_MBRLEN@
 HAVE_MBRTOWC = @HAVE_MBRTOWC@
@@ -3004,26 +3142,57 @@
 HAVE_MBSLEN = @HAVE_MBSLEN@
 HAVE_MBSNRTOWCS = @HAVE_MBSNRTOWCS@
 HAVE_MBSRTOWCS = @HAVE_MBSRTOWCS@
-HAVE_MEMCHR = @HAVE_MEMCHR@
+HAVE_MBTOWC = @HAVE_MBTOWC@
 HAVE_MEMPCPY = @HAVE_MEMPCPY@
+HAVE_MEMSET_EXPLICIT = @HAVE_MEMSET_EXPLICIT@
+HAVE_MKDTEMP = @HAVE_MKDTEMP@
+HAVE_MKOSTEMP = @HAVE_MKOSTEMP@
+HAVE_MKOSTEMPS = @HAVE_MKOSTEMPS@
+HAVE_MKSTEMP = @HAVE_MKSTEMP@
+HAVE_MKSTEMPS = @HAVE_MKSTEMPS@
 HAVE_MODFF = @HAVE_MODFF@
 HAVE_MODFL = @HAVE_MODFL@
+HAVE_OS_H = @HAVE_OS_H@
 HAVE_PCLOSE = @HAVE_PCLOSE@
+HAVE_PIPE = @HAVE_PIPE@
+HAVE_PIPE2 = @HAVE_PIPE2@
 HAVE_POPEN = @HAVE_POPEN@
+HAVE_POSIX_MEMALIGN = @HAVE_POSIX_MEMALIGN@
+HAVE_POSIX_OPENPT = @HAVE_POSIX_OPENPT@
 HAVE_POWF = @HAVE_POWF@
+HAVE_PREAD = @HAVE_PREAD@
+HAVE_PTSNAME = @HAVE_PTSNAME@
+HAVE_PTSNAME_R = @HAVE_PTSNAME_R@
+HAVE_PWRITE = @HAVE_PWRITE@
+HAVE_QSORT_R = @HAVE_QSORT_R@
+HAVE_RANDOM = @HAVE_RANDOM@
+HAVE_RANDOM_H = @HAVE_RANDOM_H@
+HAVE_RANDOM_R = @HAVE_RANDOM_R@
 HAVE_RAWMEMCHR = @HAVE_RAWMEMCHR@
+HAVE_READLINK = @HAVE_READLINK@
+HAVE_READLINKAT = @HAVE_READLINKAT@
+HAVE_REALLOCARRAY = @HAVE_REALLOCARRAY@
+HAVE_REALPATH = @HAVE_REALPATH@
 HAVE_REMAINDER = @HAVE_REMAINDER@
 HAVE_REMAINDERF = @HAVE_REMAINDERF@
 HAVE_RENAMEAT = @HAVE_RENAMEAT@
 HAVE_RINT = @HAVE_RINT@
 HAVE_RINTL = @HAVE_RINTL@
+HAVE_RPMATCH = @HAVE_RPMATCH@
 HAVE_SAME_LONG_DOUBLE_AS_DOUBLE = @HAVE_SAME_LONG_DOUBLE_AS_DOUBLE@
+HAVE_SECURE_GETENV = @HAVE_SECURE_GETENV@
+HAVE_SETENV = @HAVE_SETENV@
+HAVE_SETHOSTNAME = @HAVE_SETHOSTNAME@
+HAVE_SETSTATE = @HAVE_SETSTATE@
+HAVE_SIGABBREV_NP = @HAVE_SIGABBREV_NP@
+HAVE_SIGDESCR_NP = @HAVE_SIGDESCR_NP@
 HAVE_SIGNED_SIG_ATOMIC_T = @HAVE_SIGNED_SIG_ATOMIC_T@
 HAVE_SIGNED_WCHAR_T = @HAVE_SIGNED_WCHAR_T@
 HAVE_SIGNED_WINT_T = @HAVE_SIGNED_WINT_T@
 HAVE_SINF = @HAVE_SINF@
 HAVE_SINHF = @HAVE_SINHF@
 HAVE_SINL = @HAVE_SINL@
+HAVE_SLEEP = @HAVE_SLEEP@
 HAVE_SQRTF = @HAVE_SQRTF@
 HAVE_SQRTL = @HAVE_SQRTL@
 HAVE_STDINT_H = @HAVE_STDINT_H@
@@ -3031,17 +3200,32 @@
 HAVE_STPNCPY = @HAVE_STPNCPY@
 HAVE_STRCASESTR = @HAVE_STRCASESTR@
 HAVE_STRCHRNUL = @HAVE_STRCHRNUL@
+HAVE_STRERRORNAME_NP = @HAVE_STRERRORNAME_NP@
 HAVE_STRPBRK = @HAVE_STRPBRK@
 HAVE_STRSEP = @HAVE_STRSEP@
+HAVE_STRTOD = @HAVE_STRTOD@
+HAVE_STRTOL = @HAVE_STRTOL@
+HAVE_STRTOLD = @HAVE_STRTOLD@
+HAVE_STRTOLL = @HAVE_STRTOLL@
+HAVE_STRTOUL = @HAVE_STRTOUL@
+HAVE_STRTOULL = @HAVE_STRTOULL@
+HAVE_STRUCT_RANDOM_DATA = @HAVE_STRUCT_RANDOM_DATA@
 HAVE_STRVERSCMP = @HAVE_STRVERSCMP@
+HAVE_SYMLINK = @HAVE_SYMLINK@
+HAVE_SYMLINKAT = @HAVE_SYMLINKAT@
 HAVE_SYS_BITYPES_H = @HAVE_SYS_BITYPES_H@
 HAVE_SYS_INTTYPES_H = @HAVE_SYS_INTTYPES_H@
+HAVE_SYS_LOADAVG_H = @HAVE_SYS_LOADAVG_H@
+HAVE_SYS_PARAM_H = @HAVE_SYS_PARAM_H@
 HAVE_SYS_TYPES_H = @HAVE_SYS_TYPES_H@
 HAVE_TANF = @HAVE_TANF@
 HAVE_TANHF = @HAVE_TANHF@
 HAVE_TANL = @HAVE_TANL@
 HAVE_TEST_EF_OPTION = @HAVE_TEST_EF_OPTION@
-HAVE_UNSIGNED_LONG_LONG_INT = @HAVE_UNSIGNED_LONG_LONG_INT@
+HAVE_UNISTD_H = @HAVE_UNISTD_H@
+HAVE_UNLINKAT = @HAVE_UNLINKAT@
+HAVE_UNLOCKPT = @HAVE_UNLOCKPT@
+HAVE_USLEEP = @HAVE_USLEEP@
 HAVE_VASPRINTF = @HAVE_VASPRINTF@
 HAVE_VDPRINTF = @HAVE_VDPRINTF@
 HAVE_WCHAR_H = @HAVE_WCHAR_H@
@@ -3081,9 +3265,10 @@
 HAVE_WMEMCMP = @HAVE_WMEMCMP@
 HAVE_WMEMCPY = @HAVE_WMEMCPY@
 HAVE_WMEMMOVE = @HAVE_WMEMMOVE@
+HAVE_WMEMPCPY = @HAVE_WMEMPCPY@
 HAVE_WMEMSET = @HAVE_WMEMSET@
-HOST_CPU = @HOST_CPU@
-HOST_CPU_C_ABI = @HOST_CPU_C_ABI@
+HAVE__BOOL = @HAVE__BOOL@
+HAVE__EXIT = @HAVE__EXIT@
 INCLUDE_NEXT = @INCLUDE_NEXT@
 INCLUDE_NEXT_AS_FIRST_DIRECTIVE = @INCLUDE_NEXT_AS_FIRST_DIRECTIVE@
 INSTALL = @INSTALL@
@@ -3092,6 +3277,8 @@
 INSTALL_PROGRAM = @INSTALL_PROGRAM@
 INSTALL_SCRIPT = @INSTALL_SCRIPT@
 INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+INT32_MAX_LT_INTMAX_MAX = @INT32_MAX_LT_INTMAX_MAX@
+INT64_MAX_EQ_LONG_MAX = @INT64_MAX_EQ_LONG_MAX@
 LDFLAGS = @LDFLAGS@
 LIBC = @LIBC@
 LIBEXT = @LIBEXT@
@@ -3111,28 +3298,37 @@
 LPR = @LPR@
 LTLIBICONV = @LTLIBICONV@
 LTLIBOBJS = @LTLIBOBJS@
+M4 = @M4@
 MAKEINFO = @MAKEINFO@
 MKDIR_P = @MKDIR_P@
+NEXT_ASSERT_H = @NEXT_ASSERT_H@
+NEXT_AS_FIRST_DIRECTIVE_ASSERT_H = @NEXT_AS_FIRST_DIRECTIVE_ASSERT_H@
 NEXT_AS_FIRST_DIRECTIVE_ERRNO_H = @NEXT_AS_FIRST_DIRECTIVE_ERRNO_H@
 NEXT_AS_FIRST_DIRECTIVE_FLOAT_H = @NEXT_AS_FIRST_DIRECTIVE_FLOAT_H@
+NEXT_AS_FIRST_DIRECTIVE_INTTYPES_H = @NEXT_AS_FIRST_DIRECTIVE_INTTYPES_H@
 NEXT_AS_FIRST_DIRECTIVE_LIMITS_H = @NEXT_AS_FIRST_DIRECTIVE_LIMITS_H@
 NEXT_AS_FIRST_DIRECTIVE_MATH_H = @NEXT_AS_FIRST_DIRECTIVE_MATH_H@
 NEXT_AS_FIRST_DIRECTIVE_STDDEF_H = @NEXT_AS_FIRST_DIRECTIVE_STDDEF_H@
 NEXT_AS_FIRST_DIRECTIVE_STDINT_H = @NEXT_AS_FIRST_DIRECTIVE_STDINT_H@
 NEXT_AS_FIRST_DIRECTIVE_STDIO_H = @NEXT_AS_FIRST_DIRECTIVE_STDIO_H@
+NEXT_AS_FIRST_DIRECTIVE_STDLIB_H = @NEXT_AS_FIRST_DIRECTIVE_STDLIB_H@
 NEXT_AS_FIRST_DIRECTIVE_STRING_H = @NEXT_AS_FIRST_DIRECTIVE_STRING_H@
 NEXT_AS_FIRST_DIRECTIVE_SYS_TYPES_H = @NEXT_AS_FIRST_DIRECTIVE_SYS_TYPES_H@
+NEXT_AS_FIRST_DIRECTIVE_UNISTD_H = @NEXT_AS_FIRST_DIRECTIVE_UNISTD_H@
 NEXT_AS_FIRST_DIRECTIVE_WCHAR_H = @NEXT_AS_FIRST_DIRECTIVE_WCHAR_H@
 NEXT_AS_FIRST_DIRECTIVE_WCTYPE_H = @NEXT_AS_FIRST_DIRECTIVE_WCTYPE_H@
 NEXT_ERRNO_H = @NEXT_ERRNO_H@
 NEXT_FLOAT_H = @NEXT_FLOAT_H@
+NEXT_INTTYPES_H = @NEXT_INTTYPES_H@
 NEXT_LIMITS_H = @NEXT_LIMITS_H@
 NEXT_MATH_H = @NEXT_MATH_H@
 NEXT_STDDEF_H = @NEXT_STDDEF_H@
 NEXT_STDINT_H = @NEXT_STDINT_H@
 NEXT_STDIO_H = @NEXT_STDIO_H@
+NEXT_STDLIB_H = @NEXT_STDLIB_H@
 NEXT_STRING_H = @NEXT_STRING_H@
 NEXT_SYS_TYPES_H = @NEXT_SYS_TYPES_H@
+NEXT_UNISTD_H = @NEXT_UNISTD_H@
 NEXT_WCHAR_H = @NEXT_WCHAR_H@
 NEXT_WCTYPE_H = @NEXT_WCTYPE_H@
 OBJEXT = @OBJEXT@
@@ -3146,9 +3342,6 @@
 PACKAGE_VERSION = @PACKAGE_VERSION@
 PAGE = @PAGE@
 PATH_SEPARATOR = @PATH_SEPARATOR@
-PDFFONTS = @PDFFONTS@
-PDFIMAGES = @PDFIMAGES@
-PDFINFO = @PDFINFO@
 PERL = @PERL@
 PERL_VERSION = @PERL_VERSION@
 PKG_CONFIG = @PKG_CONFIG@
@@ -3156,32 +3349,58 @@
 PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
 PRAGMA_COLUMNS = @PRAGMA_COLUMNS@
 PRAGMA_SYSTEM_HEADER = @PRAGMA_SYSTEM_HEADER@
+PRIPTR_PREFIX = @PRIPTR_PREFIX@
+PROG_TEX = @PROG_TEX@
 PROG_TEXI2DVI = @PROG_TEXI2DVI@
 PSPRINT = @PSPRINT@
 PTRDIFF_T_SUFFIX = @PTRDIFF_T_SUFFIX@
 RANLIB = @RANLIB@
+REPLACE_ACCESS = @REPLACE_ACCESS@
 REPLACE_ACOSF = @REPLACE_ACOSF@
+REPLACE_ALIGNED_ALLOC = @REPLACE_ALIGNED_ALLOC@
 REPLACE_ASINF = @REPLACE_ASINF@
 REPLACE_ATAN2F = @REPLACE_ATAN2F@
 REPLACE_ATANF = @REPLACE_ATANF@
 REPLACE_BTOWC = @REPLACE_BTOWC@
+REPLACE_CALLOC_FOR_CALLOC_GNU = @REPLACE_CALLOC_FOR_CALLOC_GNU@
+REPLACE_CALLOC_FOR_CALLOC_POSIX = @REPLACE_CALLOC_FOR_CALLOC_POSIX@
+REPLACE_CANONICALIZE_FILE_NAME = @REPLACE_CANONICALIZE_FILE_NAME@
 REPLACE_CBRTF = @REPLACE_CBRTF@
 REPLACE_CBRTL = @REPLACE_CBRTL@
 REPLACE_CEIL = @REPLACE_CEIL@
 REPLACE_CEILF = @REPLACE_CEILF@
 REPLACE_CEILL = @REPLACE_CEILL@
+REPLACE_CHOWN = @REPLACE_CHOWN@
+REPLACE_CLOSE = @REPLACE_CLOSE@
+REPLACE_COPY_FILE_RANGE = @REPLACE_COPY_FILE_RANGE@
 REPLACE_COSF = @REPLACE_COSF@
 REPLACE_COSHF = @REPLACE_COSHF@
 REPLACE_DPRINTF = @REPLACE_DPRINTF@
+REPLACE_DUP = @REPLACE_DUP@
+REPLACE_DUP2 = @REPLACE_DUP2@
+REPLACE_DUP3 = @REPLACE_DUP3@
+REPLACE_EXECL = @REPLACE_EXECL@
+REPLACE_EXECLE = @REPLACE_EXECLE@
+REPLACE_EXECLP = @REPLACE_EXECLP@
+REPLACE_EXECV = @REPLACE_EXECV@
+REPLACE_EXECVE = @REPLACE_EXECVE@
+REPLACE_EXECVP = @REPLACE_EXECVP@
+REPLACE_EXECVPE = @REPLACE_EXECVPE@
 REPLACE_EXP2 = @REPLACE_EXP2@
 REPLACE_EXP2L = @REPLACE_EXP2L@
 REPLACE_EXPF = @REPLACE_EXPF@
+REPLACE_EXPL = @REPLACE_EXPL@
 REPLACE_EXPM1 = @REPLACE_EXPM1@
 REPLACE_EXPM1F = @REPLACE_EXPM1F@
+REPLACE_EXPM1L = @REPLACE_EXPM1L@
 REPLACE_FABSL = @REPLACE_FABSL@
+REPLACE_FACCESSAT = @REPLACE_FACCESSAT@
+REPLACE_FCHOWNAT = @REPLACE_FCHOWNAT@
 REPLACE_FCLOSE = @REPLACE_FCLOSE@
+REPLACE_FDATASYNC = @REPLACE_FDATASYNC@
 REPLACE_FDOPEN = @REPLACE_FDOPEN@
 REPLACE_FFLUSH = @REPLACE_FFLUSH@
+REPLACE_FFSLL = @REPLACE_FFSLL@
 REPLACE_FLOOR = @REPLACE_FLOOR@
 REPLACE_FLOORF = @REPLACE_FLOORF@
 REPLACE_FLOORL = @REPLACE_FLOORL@
@@ -3192,8 +3411,10 @@
 REPLACE_FMODF = @REPLACE_FMODF@
 REPLACE_FMODL = @REPLACE_FMODL@
 REPLACE_FOPEN = @REPLACE_FOPEN@
+REPLACE_FOPEN_FOR_FOPEN_GNU = @REPLACE_FOPEN_FOR_FOPEN_GNU@
 REPLACE_FPRINTF = @REPLACE_FPRINTF@
 REPLACE_FPURGE = @REPLACE_FPURGE@
+REPLACE_FREE = @REPLACE_FREE@
 REPLACE_FREOPEN = @REPLACE_FREOPEN@
 REPLACE_FREXP = @REPLACE_FREXP@
 REPLACE_FREXPF = @REPLACE_FREXPF@
@@ -3202,8 +3423,21 @@
 REPLACE_FSEEKO = @REPLACE_FSEEKO@
 REPLACE_FTELL = @REPLACE_FTELL@
 REPLACE_FTELLO = @REPLACE_FTELLO@
+REPLACE_FTRUNCATE = @REPLACE_FTRUNCATE@
+REPLACE_GETCWD = @REPLACE_GETCWD@
 REPLACE_GETDELIM = @REPLACE_GETDELIM@
+REPLACE_GETDOMAINNAME = @REPLACE_GETDOMAINNAME@
+REPLACE_GETDTABLESIZE = @REPLACE_GETDTABLESIZE@
+REPLACE_GETENTROPY = @REPLACE_GETENTROPY@
+REPLACE_GETGROUPS = @REPLACE_GETGROUPS@
 REPLACE_GETLINE = @REPLACE_GETLINE@
+REPLACE_GETLOADAVG = @REPLACE_GETLOADAVG@
+REPLACE_GETLOGIN_R = @REPLACE_GETLOGIN_R@
+REPLACE_GETPAGESIZE = @REPLACE_GETPAGESIZE@
+REPLACE_GETPASS = @REPLACE_GETPASS@
+REPLACE_GETPASS_FOR_GETPASS_GNU = @REPLACE_GETPASS_FOR_GETPASS_GNU@
+REPLACE_GETPROGNAME = @REPLACE_GETPROGNAME@
+REPLACE_GETSUBOPT = @REPLACE_GETSUBOPT@
 REPLACE_HUGE_VAL = @REPLACE_HUGE_VAL@
 REPLACE_HYPOT = @REPLACE_HYPOT@
 REPLACE_HYPOTF = @REPLACE_HYPOTF@
@@ -3211,13 +3445,22 @@
 REPLACE_ILOGB = @REPLACE_ILOGB@
 REPLACE_ILOGBF = @REPLACE_ILOGBF@
 REPLACE_ILOGBL = @REPLACE_ILOGBL@
+REPLACE_IMAXABS = @REPLACE_IMAXABS@
+REPLACE_IMAXDIV = @REPLACE_IMAXDIV@
+REPLACE_INITSTATE = @REPLACE_INITSTATE@
+REPLACE_ISATTY = @REPLACE_ISATTY@
 REPLACE_ISFINITE = @REPLACE_ISFINITE@
 REPLACE_ISINF = @REPLACE_ISINF@
 REPLACE_ISNAN = @REPLACE_ISNAN@
 REPLACE_ISWBLANK = @REPLACE_ISWBLANK@
 REPLACE_ISWCNTRL = @REPLACE_ISWCNTRL@
+REPLACE_ISWDIGIT = @REPLACE_ISWDIGIT@
+REPLACE_ISWXDIGIT = @REPLACE_ISWXDIGIT@
 REPLACE_ITOLD = @REPLACE_ITOLD@
+REPLACE_LCHOWN = @REPLACE_LCHOWN@
 REPLACE_LDEXPL = @REPLACE_LDEXPL@
+REPLACE_LINK = @REPLACE_LINK@
+REPLACE_LINKAT = @REPLACE_LINKAT@
 REPLACE_LOG = @REPLACE_LOG@
 REPLACE_LOG10 = @REPLACE_LOG10@
 REPLACE_LOG10F = @REPLACE_LOG10F@
@@ -3233,14 +3476,22 @@
 REPLACE_LOGBL = @REPLACE_LOGBL@
 REPLACE_LOGF = @REPLACE_LOGF@
 REPLACE_LOGL = @REPLACE_LOGL@
+REPLACE_LSEEK = @REPLACE_LSEEK@
+REPLACE_MALLOC_FOR_MALLOC_GNU = @REPLACE_MALLOC_FOR_MALLOC_GNU@
+REPLACE_MALLOC_FOR_MALLOC_POSIX = @REPLACE_MALLOC_FOR_MALLOC_POSIX@
 REPLACE_MBRLEN = @REPLACE_MBRLEN@
 REPLACE_MBRTOWC = @REPLACE_MBRTOWC@
 REPLACE_MBSINIT = @REPLACE_MBSINIT@
 REPLACE_MBSNRTOWCS = @REPLACE_MBSNRTOWCS@
 REPLACE_MBSRTOWCS = @REPLACE_MBSRTOWCS@
 REPLACE_MBSTATE_T = @REPLACE_MBSTATE_T@
+REPLACE_MBTOWC = @REPLACE_MBTOWC@
 REPLACE_MEMCHR = @REPLACE_MEMCHR@
 REPLACE_MEMMEM = @REPLACE_MEMMEM@
+REPLACE_MEMPCPY = @REPLACE_MEMPCPY@
+REPLACE_MKOSTEMP = @REPLACE_MKOSTEMP@
+REPLACE_MKOSTEMPS = @REPLACE_MKOSTEMPS@
+REPLACE_MKSTEMP = @REPLACE_MKSTEMP@
 REPLACE_MODF = @REPLACE_MODF@
 REPLACE_MODFF = @REPLACE_MODFF@
 REPLACE_MODFL = @REPLACE_MODFL@
@@ -3248,46 +3499,88 @@
 REPLACE_NULL = @REPLACE_NULL@
 REPLACE_OBSTACK_PRINTF = @REPLACE_OBSTACK_PRINTF@
 REPLACE_PERROR = @REPLACE_PERROR@
+REPLACE_PIPE2 = @REPLACE_PIPE2@
 REPLACE_POPEN = @REPLACE_POPEN@
+REPLACE_POSIX_MEMALIGN = @REPLACE_POSIX_MEMALIGN@
+REPLACE_POSIX_OPENPT = @REPLACE_POSIX_OPENPT@
+REPLACE_PREAD = @REPLACE_PREAD@
 REPLACE_PRINTF = @REPLACE_PRINTF@
+REPLACE_PTSNAME = @REPLACE_PTSNAME@
+REPLACE_PTSNAME_R = @REPLACE_PTSNAME_R@
+REPLACE_PUTENV = @REPLACE_PUTENV@
+REPLACE_PWRITE = @REPLACE_PWRITE@
+REPLACE_QSORT_R = @REPLACE_QSORT_R@
+REPLACE_RANDOM = @REPLACE_RANDOM@
+REPLACE_RANDOM_R = @REPLACE_RANDOM_R@
+REPLACE_READ = @REPLACE_READ@
+REPLACE_READLINK = @REPLACE_READLINK@
+REPLACE_READLINKAT = @REPLACE_READLINKAT@
+REPLACE_REALLOCARRAY = @REPLACE_REALLOCARRAY@
+REPLACE_REALLOC_FOR_REALLOC_GNU = @REPLACE_REALLOC_FOR_REALLOC_GNU@
+REPLACE_REALLOC_FOR_REALLOC_POSIX = @REPLACE_REALLOC_FOR_REALLOC_POSIX@
+REPLACE_REALPATH = @REPLACE_REALPATH@
 REPLACE_REMAINDER = @REPLACE_REMAINDER@
 REPLACE_REMAINDERF = @REPLACE_REMAINDERF@
 REPLACE_REMAINDERL = @REPLACE_REMAINDERL@
 REPLACE_REMOVE = @REPLACE_REMOVE@
 REPLACE_RENAME = @REPLACE_RENAME@
 REPLACE_RENAMEAT = @REPLACE_RENAMEAT@
+REPLACE_RINTL = @REPLACE_RINTL@
+REPLACE_RMDIR = @REPLACE_RMDIR@
 REPLACE_ROUND = @REPLACE_ROUND@
 REPLACE_ROUNDF = @REPLACE_ROUNDF@
 REPLACE_ROUNDL = @REPLACE_ROUNDL@
+REPLACE_SETENV = @REPLACE_SETENV@
+REPLACE_SETHOSTNAME = @REPLACE_SETHOSTNAME@
+REPLACE_SETSTATE = @REPLACE_SETSTATE@
 REPLACE_SIGNBIT = @REPLACE_SIGNBIT@
-REPLACE_SIGNBIT_USING_GCC = @REPLACE_SIGNBIT_USING_GCC@
+REPLACE_SIGNBIT_USING_BUILTINS = @REPLACE_SIGNBIT_USING_BUILTINS@
 REPLACE_SINF = @REPLACE_SINF@
 REPLACE_SINHF = @REPLACE_SINHF@
+REPLACE_SLEEP = @REPLACE_SLEEP@
 REPLACE_SNPRINTF = @REPLACE_SNPRINTF@
 REPLACE_SPRINTF = @REPLACE_SPRINTF@
 REPLACE_SQRTF = @REPLACE_SQRTF@
 REPLACE_SQRTL = @REPLACE_SQRTL@
 REPLACE_STDIO_READ_FUNCS = @REPLACE_STDIO_READ_FUNCS@
 REPLACE_STDIO_WRITE_FUNCS = @REPLACE_STDIO_WRITE_FUNCS@
+REPLACE_STPCPY = @REPLACE_STPCPY@
 REPLACE_STPNCPY = @REPLACE_STPNCPY@
 REPLACE_STRCASESTR = @REPLACE_STRCASESTR@
 REPLACE_STRCHRNUL = @REPLACE_STRCHRNUL@
 REPLACE_STRDUP = @REPLACE_STRDUP@
 REPLACE_STRERROR = @REPLACE_STRERROR@
+REPLACE_STRERRORNAME_NP = @REPLACE_STRERRORNAME_NP@
 REPLACE_STRERROR_R = @REPLACE_STRERROR_R@
 REPLACE_STRNCAT = @REPLACE_STRNCAT@
 REPLACE_STRNDUP = @REPLACE_STRNDUP@
 REPLACE_STRNLEN = @REPLACE_STRNLEN@
 REPLACE_STRSIGNAL = @REPLACE_STRSIGNAL@
 REPLACE_STRSTR = @REPLACE_STRSTR@
+REPLACE_STRTOD = @REPLACE_STRTOD@
+REPLACE_STRTOIMAX = @REPLACE_STRTOIMAX@
 REPLACE_STRTOK_R = @REPLACE_STRTOK_R@
+REPLACE_STRTOL = @REPLACE_STRTOL@
+REPLACE_STRTOLD = @REPLACE_STRTOLD@
+REPLACE_STRTOLL = @REPLACE_STRTOLL@
+REPLACE_STRTOUL = @REPLACE_STRTOUL@
+REPLACE_STRTOULL = @REPLACE_STRTOULL@
+REPLACE_STRTOUMAX = @REPLACE_STRTOUMAX@
+REPLACE_SYMLINK = @REPLACE_SYMLINK@
+REPLACE_SYMLINKAT = @REPLACE_SYMLINKAT@
 REPLACE_TANF = @REPLACE_TANF@
 REPLACE_TANHF = @REPLACE_TANHF@
 REPLACE_TMPFILE = @REPLACE_TMPFILE@
 REPLACE_TOWLOWER = @REPLACE_TOWLOWER@
 REPLACE_TRUNC = @REPLACE_TRUNC@
+REPLACE_TRUNCATE = @REPLACE_TRUNCATE@
 REPLACE_TRUNCF = @REPLACE_TRUNCF@
 REPLACE_TRUNCL = @REPLACE_TRUNCL@
+REPLACE_TTYNAME_R = @REPLACE_TTYNAME_R@
+REPLACE_UNLINK = @REPLACE_UNLINK@
+REPLACE_UNLINKAT = @REPLACE_UNLINKAT@
+REPLACE_UNSETENV = @REPLACE_UNSETENV@
+REPLACE_USLEEP = @REPLACE_USLEEP@
 REPLACE_VASPRINTF = @REPLACE_VASPRINTF@
 REPLACE_VDPRINTF = @REPLACE_VDPRINTF@
 REPLACE_VFPRINTF = @REPLACE_VFPRINTF@
@@ -3298,9 +3591,14 @@
 REPLACE_WCSFTIME = @REPLACE_WCSFTIME@
 REPLACE_WCSNRTOMBS = @REPLACE_WCSNRTOMBS@
 REPLACE_WCSRTOMBS = @REPLACE_WCSRTOMBS@
+REPLACE_WCSTOK = @REPLACE_WCSTOK@
 REPLACE_WCSWIDTH = @REPLACE_WCSWIDTH@
 REPLACE_WCTOB = @REPLACE_WCTOB@
+REPLACE_WCTOMB = @REPLACE_WCTOMB@
 REPLACE_WCWIDTH = @REPLACE_WCWIDTH@
+REPLACE_WMEMPCPY = @REPLACE_WMEMPCPY@
+REPLACE_WRITE = @REPLACE_WRITE@
+REPLACE__EXIT = @REPLACE__EXIT@
 
 # On some platforms we need to set LANG and LC_ALL to C for sed
 SED = \
@@ -3314,6 +3612,7 @@
 SH_SCRIPT_SED_CMD = @SH_SCRIPT_SED_CMD@
 SIG_ATOMIC_T_SUFFIX = @SIG_ATOMIC_T_SUFFIX@
 SIZE_T_SUFFIX = @SIZE_T_SUFFIX@
+STDBOOL_H = @STDBOOL_H@
 STDDEF_H = @STDDEF_H@
 STDINT_H = @STDINT_H@
 STRIP = @STRIP@
@@ -3332,7 +3631,12 @@
 TTYDEVDIRS = @TTYDEVDIRS@ font/devutf8
 UCHARDET_CFLAGS = @UCHARDET_CFLAGS@
 UCHARDET_LIBS = @UCHARDET_LIBS@
+UINT32_MAX_LT_UINTMAX_MAX = @UINT32_MAX_LT_UINTMAX_MAX@
+UINT64_MAX_EQ_ULONG_MAX = @UINT64_MAX_EQ_ULONG_MAX@
 UNDEFINE_STRTOK_R = @UNDEFINE_STRTOK_R@
+UNISTD_H_HAVE_SYS_RANDOM_H = @UNISTD_H_HAVE_SYS_RANDOM_H@
+UNISTD_H_HAVE_WINSOCK2_H = @UNISTD_H_HAVE_WINSOCK2_H@
+UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS = @UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS@
 VERSION = @VERSION@
 WCHAR_T_SUFFIX = @WCHAR_T_SUFFIX@
 WINDOWS_64_BIT_OFF_T = @WINDOWS_64_BIT_OFF_T@
@@ -3361,7 +3665,7 @@
 am__quote = @am__quote@
 am__tar = @am__tar@
 am__untar = @am__untar@
-appresdir = @appresdir@
+appdefdir = @appdefdir@
 bindir = @bindir@
 build = @build@
 build_alias = @build_alias@
@@ -3372,7 +3676,6 @@
 compatibility_wrappers = @compatibility_wrappers@
 datadir = @datadir@
 datarootdir = @datarootdir@
-doc_dist_target_ok = @doc_dist_target_ok@
 
 # infodir
 # `infodir' says where to install info files.
@@ -3384,16 +3687,16 @@
 dvidir = @dvidir@
 exec_prefix = @exec_prefix@
 g = @g@
+gl_LIBOBJDEPS = @gl_LIBOBJDEPS@
 gl_LIBOBJS = @gl_LIBOBJS@
 gl_LTLIBOBJS = @gl_LTLIBOBJS@
 glilypond_dir = @glilypond_dir@
+gltests_LIBOBJDEPS = @gltests_LIBOBJDEPS@
 gltests_LIBOBJS = @gltests_LIBOBJS@
 gltests_LTLIBOBJS = @gltests_LTLIBOBJS@
 gltests_WITNESS = @gltests_WITNESS@
 gpinyin_dir = @gpinyin_dir@
 groff_have_urw_fonts = @groff_have_urw_fonts@
-groffer_dir = @groffer_dir@
-grog_dir = @grog_dir@
 host = @host@
 host_alias = @host_alias@
 host_cpu = @host_cpu@
@@ -3408,37 +3711,15 @@
 libprogramdir = @libprogramdir@
 localedir = @localedir@
 localstatedir = @localstatedir@
-make_examples = @make_examples@
 make_htmldoc = @make_htmldoc@
-make_htmlexamples = @make_htmlexamples@
-make_infodoc = @make_infodoc@
-make_install_examples = @make_install_examples@
-make_install_htmldoc = @make_install_htmldoc@
-make_install_htmlexamples = @make_install_htmlexamples@
-make_install_infodoc = @make_install_infodoc@
-make_install_otherdoc = @make_install_otherdoc@
-make_install_pdfdoc = @make_install_pdfdoc@
-make_install_pdfexamples = @make_install_pdfexamples@
-make_install_shipped_htmldoc = @make_install_shipped_htmldoc@
-make_otherdoc = @make_otherdoc@
-make_pdfdoc = @make_pdfdoc@
-make_pdfexamples = @make_pdfexamples@
-make_uninstall_examples = @make_uninstall_examples@
-make_uninstall_htmldoc = @make_uninstall_htmldoc@
-make_uninstall_htmlexamples = @make_uninstall_htmlexamples@
-make_uninstall_infodoc = @make_uninstall_infodoc@
-make_uninstall_otherdoc = @make_uninstall_otherdoc@
-make_uninstall_pdfdoc = @make_uninstall_pdfdoc@
-make_uninstall_pdfexamples = @make_uninstall_pdfexamples@
-make_uninstall_shipped_htmldoc = @make_uninstall_shipped_htmldoc@
 make_winscripts = @make_winscripts@
-makeinfo_version_numeric = @makeinfo_version_numeric@
 mandir = @mandir@
 mkdir_p = @mkdir_p@
 oldincludedir = @oldincludedir@
 pdfdir = @pdfdir@
 pnmcrop = @pnmcrop@
 pnmcut = @pnmcut@
+pnmtools_quiet = @pnmtools_quiet@
 pnmtopng = @pnmtopng@
 pnmtops = @pnmtops@
 pnmtops_nosetpage = @pnmtops_nosetpage@
@@ -3447,6 +3728,7 @@
 psdir = @psdir@
 psselect = @psselect@
 referdir = @referdir@
+runstatedir = @runstatedir@
 sbindir = @sbindir@
 sharedstatedir = @sharedstatedir@
 srcdir = @srcdir@
@@ -3458,6 +3740,8 @@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 urwfontsdir = @urwfontsdir@
+use_gropdf = @use_gropdf@
+use_pdfroff = @use_pdfroff@
 
 # `RT_SEP' is the operating system's native PATH SEPARATOR CHAR, which
 # is to be used in runtime PATHs compiled into groff executables.
@@ -3575,7 +3859,7 @@
 # `localfontdir' says where local fonts will be installed (as dev*/*).
 localfontdir = $(dataprogramdir)/site-font
 
-# `legacyfontdir' is for compatibility with non-GNU troff.
+# `legacyfontdir' is for compatibility with AT&T/DWB troff.
 legacyfontdir = /usr/lib/font
 
 # `fontpath' says where to look for dev*/*.
@@ -3590,13 +3874,11 @@
 # `localtmacdir' says where local files will be installed.
 localtmacdir = $(dataprogramdir)/site-tmac
 
-# appresdir
-# `appresdir' says where to install the application resource file for
+# appdefdir
+# `appdefdir' says where to install the application defaults file for
 # gxditview.
 
-# groffer_dir
 # glilypond_dir
-# grog_dir
 # gpinyin_dir
 
 # `tmacpath' says where to look for macro files.
@@ -3675,7 +3957,7 @@
 
 
 # Extension to be used for refer index files.  Index files are not
-# sharable between different architectures, so you might want to use
+# shareable between different architectures, so you might want to use
 # different suffixes for different architectures.  Choose an extension
 # that doesn't conflict with refer or any other indexing program.
 indexext = .i
@@ -3707,47 +3989,18 @@
 man7ext = 7
 man7dir = $(manroot)/man$(man7ext)
 
-# doc_dist_target_ok
-# `dist' target is disallowed in some `configure' combinations.
-
-# The configure script checks whether the user wants the info documentation.
-# For the repo version this mechanism also suppresses building via `makeinfo'.
-# make_infodoc
-# make_install_infodoc
-# make_uninstall_infodoc
-
 # The configure script checks whether all necessary utility programs for
-# grohtml are available -- only then we can build the HTML documentation.
+# grohtml are available -- only then can we build the HTML documentation.
 # make_htmldoc
 # make_install_htmldoc
 # make_uninstall_htmldoc
 
-# make_htmlexamples
-# make_install_htmlexamples
-# make_uninstall_htmlexamples
-
 # The configure script also checks whether all necessary utility programs
-# for pdfroff are available -- only then we can build PDF documentation.
+# for pdfroff are available -- only then can we build PDF documentation.
 # make_pdfdoc
 # make_install_pdfdoc
 # make_uninstall_pdfdoc
 
-# make_pdfexamples
-# make_install_pdfexamples
-# make_uninstall_pdfexamples
-
-# `other' documentation, e.g., `meref.me' and `pic.ms', as well as their
-# generated counterparts..
-# make_otherdoc
-# make_install_otherdoc
-# make_uninstall_otherdoc
-
-# `examples' -- a generic switch, but the generated examples are furtherly
-# subdivided to catch HTML and PDF production availability.
-# make_examples
-# make_install_examples
-# make_uninstall_examples
-
 # Windows `.cmd' files
 # make_winscripts
 # make_install_winscripts
@@ -3840,10 +4093,6 @@
 # uintmax_t=<value>		define to `unsigned long' or `unsigned long
 #				long' if <inttypes.h> does not exist
 #
-# TRADITIONAL_CPP		if your C++ compiler uses a traditional
-#				(Reiser) preprocessor
-# ARRAY_DELETE_NEEDS_SIZE	if your C++ doesn't understand `delete '
-#
 # PAGE=A4			if the printer's page size is A4
 # GHOSTSCRIPT=gs		the name (and directory if required) of the
 #				ghostscript program
@@ -3858,7 +4107,6 @@
 
 # `CCC' is the compiler for C++ (.cpp) files.
 CCC = @CXX@
-ETAGS = etags
 ETAGSFLAGS = 
 # Flag that tells etags to assume C++.
 ETAGSCCFLAG = -C
@@ -3893,41 +4141,67 @@
 GROFF_V = $(GROFF_V_@AM_V@)
 GROFF_V_ = $(GROFF_V_@AM_DEFAULT_V@)
 GROFF_V_0 = @echo "  GROFF   " $@;
-bin_SCRIPTS = $(am__append_2) eqn2graph gdiffmk glilypond gperl \
-	gpinyin grap2graph groffer $(ROFF2PROGS) mmroff pdfroff \
-	pic2graph gropdf pdfmom grog afmtodit
+bin_SCRIPTS = $(am__append_11) eqn2graph gdiffmk glilypond gperl \
+	gpinyin grap2graph mmroff pdfroff pic2graph gropdf pdfmom \
+	afmtodit grog
 dist_bin_SCRIPTS = 
+# stuff that should be in distribution archives but not in source repo
+MAINTAINERCLEANFILES = doc/groff.info doc/groff.txt doc/groff.html \
+	doc/groff.html.node src/preproc/eqn/eqn.hpp \
+	src/preproc/eqn/eqn.cpp src/preproc/eqn/eqn.output \
+	src/preproc/pic/pic.cpp src/preproc/pic/pic.hpp \
+	src/preproc/pic/pic.output src/preproc/refer/label.cpp \
+	src/preproc/refer/label.hpp src/preproc/refer/label.output
+
+# HTML documents to be produced by troff should depend on this stamp
+# file to ensure that (post-)grohtml's device and font description files
+# are available.
+
+# PDFs to be produced by troff should depend on this stamp file to
+# ensure that gropdf's device and font description files are available.
+
+# PostScript documents to be produced by troff should depend on this
+# stamp file to ensure that grops's device and font description files
+# are available.
+
+# (UTF-8-encoded) text documents to be produced by troff should depend
+# on this stamp file to ensure that grotty's device and font description
+# files are available.
 MOSTLYCLEANFILES = lib/core lib/*.stackdump lib/alloca.h \
-	lib/alloca.h-t lib/errno.h lib/errno.h-t lib/float.h \
-	lib/float.h-t lib/limits.h lib/limits.h-t lib/math.h \
-	lib/math.h-t lib/stddef.h lib/stddef.h-t lib/stdint.h \
-	lib/stdint.h-t lib/stdio.h lib/stdio.h-t lib/string.h \
-	lib/string.h-t lib/sys/types.h lib/sys/types.h-t \
-	lib/unitypes.h lib/unitypes.h-t lib/uniwidth.h \
+	lib/alloca.h-t lib/assert.h lib/assert.h-t lib/errno.h \
+	lib/errno.h-t lib/float.h lib/float.h-t lib/inttypes.h \
+	lib/inttypes.h-t lib/limits.h lib/limits.h-t lib/math.h \
+	lib/math.h-t lib/stdbool.h lib/stdbool.h-t lib/stddef.h \
+	lib/stddef.h-t lib/stdint.h lib/stdint.h-t lib/stdio.h \
+	lib/stdio.h-t lib/stdlib.h lib/stdlib.h-t lib/string.h \
+	lib/string.h-t lib/sys/types.h lib/sys/types.h-t lib/unistd.h \
+	lib/unistd.h-t lib/unitypes.h lib/unitypes.h-t lib/uniwidth.h \
 	lib/uniwidth.h-t lib/wchar.h lib/wchar.h-t lib/wctype.h \
 	lib/wctype.h-t shdeps.sed $(CHEM_GENEXAMPLES) \
-	$(nodist_chemexample122_DATA) contrib/chem/README $(ROFF2MAN) \
-	$(HDTBLGENFILES) $(HDTBLPROCESSEDEXAMPLEFILES) \
-	$(HDTBLSTRIPFILES) $(am__append_6) $(am__append_9) \
-	$(MOMPROCESSEDEXAMPLEFILES) penguin.ps penguin.pdf \
-	$(am__append_10) $(am__append_12) $(am__append_14) \
-	$(am__append_15) doc/examples.stamp $(am__append_17) gnu.eps \
-	$(DEVASCIIFONTSFILES) font/devascii/DESC \
-	$(DEVCP1047FONTSFILES) font/devcp1047/DESC font/devdvi/DESC \
-	$(DEVHTMLFONTSFILES) font/devhtml/DESC $(DEVLATIN1FONTSFILES) \
-	font/devlatin1/DESC font/devlbp/DESC font/devlj4/DESC \
-	font/devpdf/download font/devpdf/DESC font/devpdf/Foundry \
-	font/devpdf/build_font_files font/devpdf/util/BuildFoundries \
-	$(DEVPSFONTFILES_GENERATED) $(DEVUTF8FONTSFILES) \
-	font/devutf8/DESC groff_opts.tmp $(GROFF_OPTS_OUTPUT) \
-	$(TMACMDOCFILES) tmac/www.tmac $(TMACSTRIPFILES) \
-	tmac/stamp-wrap tmac/*-wrap $(prefixexecbin_SCRIPTS) \
-	$(bin_SCRIPTS) $(man1_MANS) $(man5_MANS) $(man7_MANS) \
-	$(PREFIXMAN1) test-groff
-MOSTLYCLEANADD = 
+	$(nodist_chemexample122_DATA) contrib/chem/README \
+	$(HDTBLGENFILES) $(HDTBLPROCESSEDEXAMPLEFILES) $(hdtbl_TESTS) \
+	$(mom_TESTS) $(MOMPROCESSEDEXAMPLEFILES) penguin.ps \
+	penguin.pdf $(am__append_14) msboxes.ms \
+	$(nodist_sboxesotherdoc_DATA) $(nodist_sboxespdfdoc_DATA) \
+	$(GENERATEDDOCFILES) $(PROCESSEDDOCFILES) \
+	$(PROCESSEDEXAMPLEFILES) $(DEVASCIIFONTSFILES) \
+	font/devascii/DESC $(DEVCP1047FONTSFILES) font/devcp1047/DESC \
+	font/devdvi/DESC $(DEVHTMLFONTSFILES) font/devhtml/DESC \
+	font/devhtml/stamp $(DEVLATIN1FONTSFILES) font/devlatin1/DESC \
+	font/devlbp/DESC font/devlj4/DESC font/devpdf/download \
+	font/devpdf/DESC font/devpdf/Foundry \
+	font/devpdf/util/BuildFoundries \
+	font/devpdf/util/BuildFoundries font/devpdf/DESC \
+	font/devpdf/download font/devpdf/stamp $(font_devpdf_TESTS) \
+	$(DEVPSFONTFILES_GENERATED) font/devps/stamp \
+	$(DEVUTF8FONTSFILES) font/devutf8/DESC font/devutf8/stamp \
+	tmac/groff_man.7.man tmac/groff_man_style.7.man tmac/www.tmac \
+	tmac/*-stamp tmac/stamp-wrap tmac/*-wrap \
+	$(prefixexecbin_SCRIPTS) $(bin_SCRIPTS) $(man1_MANS) \
+	$(man5_MANS) $(man7_MANS) $(PREFIXMAN1)
 # No GNU Make output.
 noinst_LIBRARIES = lib/libgnu.a libbib.a libdriver.a libgroff.a \
-	$(am__append_18)
+	$(am__append_17)
 
 # Case of out-of-source build: we must create the 'man' directory.
 
@@ -3941,90 +4215,71 @@
 # make all or make check before all other targets. However, if another
 # target is built from a clean build tree, (for example make groff)
 # the files in BUILT_SOURCES will not be built first. That is why
-# additional dependencies where added in the .am files that lists
-# objects that use defs (for exmaple in groff.am:
+# additional dependencies were added in the .am files that list
+# objects that use defs (for example in groff.am:
 # src/roff/groff/groff.$(OBJEXT): defs.h)
-
-# Force generation of test-groff even though we don't ship it.
-BUILT_SOURCES = $(ALLOCA_H) $(ERRNO_H) $(FLOAT_H) $(LIMITS_H) \
-	lib/math.h $(STDDEF_H) $(STDINT_H) lib/stdio.h lib/string.h \
-	lib/sys/types.h $(LIBUNISTRING_UNITYPES_H) \
+BUILT_SOURCES = $(ALLOCA_H) $(ASSERT_H) $(ERRNO_H) $(FLOAT_H) \
+	lib/inttypes.h $(LIMITS_H) lib/math.h $(STDBOOL_H) $(STDDEF_H) \
+	$(STDINT_H) lib/stdio.h lib/stdlib.h lib/string.h \
+	lib/sys/types.h lib/unistd.h $(LIBUNISTRING_UNITYPES_H) \
 	$(LIBUNISTRING_UNIWIDTH_H) lib/wchar.h lib/wctype.h man defs.h \
-	test-groff $(top_srcdir)/.version
+	$(top_srcdir)/.version
 CLEANFILES = defs.h src/libs/libgroff/version.cpp charset.alias \
-	ref-add.sed ref-del.sed $(am__append_21) \
-	src/preproc/eqn/eqn.hpp src/preproc/eqn/eqn.cpp \
-	src/preproc/eqn/eqn.output src/preproc/pic/pic.cpp \
-	src/preproc/pic/pic.hpp src/preproc/pic/pic.output \
-	src/preproc/refer/label.cpp src/preproc/refer/label.hpp \
-	src/preproc/refer/label.output src/roff/troff/majorminor.cpp
+	ref-add.sed ref-del.sed $(am__append_20) \
+	src/roff/troff/majorminor.cpp
 # gnulib asks to include this file
 
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
-# Original Makefile.sub written by Keith Marshall
-#   (keith.d.marshall@ntlworld.com).
-# Adapted to Automake by Bertrand Garrigues (bertrand.garrigues@laposte.net).
-#
-# Last update: 13 Aug 2015
-#
-# 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
-
 # pdf doc, written in mom and therefore using contrib/mom/mom.am
 # definitions
 
-# File used by contrib/hdtbl and contrib/pdfmark. It is distributed in
-# doc.eps. We try in priority to use the file in 'doc'.
+# Distribute the manual in source form as well.
+
+# Generate HTML, both split into several files, and as a single file.
+# 'html' and its installation counterpart 'install-html' are standard
+# Automake targets.
+
+# An image of a gnu in enscapsulated PostScript is generated during the
+# build process if necessary.  Our configure script assumes pnmdepth is
+# available if xpmtoppm is (see macro "GROFF_PROG_XPMTOPPM").
 
 # TODO: these .c files could be removed (use gnulib instead).
 
+# required test artifacts
+
 # Other files that should be present in the distribution tarball.
 
-# Version files - see script 'build-aux/git-gen-version'
-EXTRA_DIST = gnulib_m4/gnulib-cache.m4 lib/alloca.in.h lib/errno.in.h \
-	lib/float.c lib/float.in.h lib/itold.c lib/fprintf.c \
-	lib/fpucw.h lib/frexp.c lib/frexp.c lib/frexpl.c lib/fseterr.c \
+# Version files - see script 'build-aux/git-version-gen'
+EXTRA_DIST = gnulib_m4/gnulib-cache.m4 lib/alloca.in.h lib/assert.in.h \
+	lib/verify.h lib/attribute.h lib/errno.in.h lib/float.in.h \
+	lib/fprintf.c lib/fpucw.h lib/frexp.c lib/frexp.c lib/frexpl.c \
 	lib/fseterr.h lib/stdio-impl.h \
 	$(top_srcdir)/build-aux/git-version-gen \
-	$(top_srcdir)/build-aux/config.rpath lib/float+.h lib/isnan.c \
-	lib/isnand-nolibm.h lib/isnand.c lib/float+.h lib/isnan.c \
-	lib/isnanf-nolibm.h lib/isnanf.c lib/float+.h lib/isnan.c \
-	lib/isnanl-nolibm.h lib/isnanl.c lib/limits.in.h \
-	lib/localcharset.h lib/math.in.h lib/memchr.c \
-	lib/memchr.valgrind $(top_srcdir)/build-aux/prefix-gnulib-mk \
-	lib/printf-frexp.h lib/printf-frexp.c lib/printf-frexpl.h \
-	lib/float+.h lib/signbitd.c lib/signbitf.c lib/signbitl.c \
+	$(top_srcdir)/build-aux/config.rpath lib/inttypes.in.h \
+	lib/float+.h lib/isnan.c lib/isnand-nolibm.h lib/isnand.c \
+	lib/float+.h lib/isnan.c lib/isnanf-nolibm.h lib/isnanf.c \
+	lib/float+.h lib/isnan.c lib/isnanl-nolibm.h lib/isnanl.c \
+	lib/limits.in.h lib/localcharset.h lib/math.in.h \
+	lib/memchr.valgrind lib/printf-frexp.h lib/printf-frexp.c \
+	lib/printf-frexpl.h lib/float+.h lib/_Noreturn.h \
 	lib/arg-nonnull.h lib/c++defs.h lib/warn-on-use.h \
-	lib/snprintf.c lib/stddef.in.h lib/stdint.in.h lib/stdio.in.h \
-	lib/streq.h lib/string.in.h lib/sys_types.in.h \
+	lib/snprintf.c lib/stdbool.in.h lib/stddef.in.h \
+	lib/stdint.in.h lib/stdio.in.h lib/stdlib.in.h lib/streq.h \
+	lib/string.in.h lib/sys_types.in.h lib/unistd.in.h \
 	lib/unitypes.in.h lib/localcharset.h lib/uniwidth.in.h \
-	lib/uniwidth/cjk.h lib/asnprintf.c lib/float+.h \
+	lib/unictype/bitmap.h lib/uniwidth/cjk.h lib/uniwidth/width0.h \
+	lib/uniwidth/width2.h lib/asnprintf.c lib/float+.h \
 	lib/printf-args.c lib/printf-args.h lib/printf-parse.c \
 	lib/printf-parse.h lib/vasnprintf.c lib/vasnprintf.h \
-	lib/verify.h lib/vsnprintf.c lib/wchar.in.h lib/wctype.in.h \
-	lib/wcwidth.c $(am__append_3) arch/misc/shdeps.sh \
-	contrib/chem/ChangeLog contrib/chem/chem.1.man \
-	contrib/chem/chem.pic contrib/chem/chem.pl \
-	contrib/chem/README.txt contrib/chem/examples/README.txt \
+	lib/vsnprintf.c lib/wchar.in.h lib/wctype.in.h \
+	$(am__append_12) $(arch_shdeps_sh) contrib/chem/ChangeLog \
+	contrib/chem/chem.1.man contrib/chem/chem.pic \
+	contrib/chem/chem.pl contrib/chem/README.txt \
+	contrib/chem/examples/README.txt \
 	contrib/chem/examples/122/README.txt \
 	contrib/eqn2graph/eqn2graph.1.man \
 	contrib/eqn2graph/eqn2graph.sh contrib/gdiffmk/gdiffmk.1.man \
 	contrib/gdiffmk/ChangeLog contrib/gdiffmk/README \
-	contrib/gdiffmk/gdiffmk.sh \
-	contrib/gdiffmk/tests/gdiffmk_tests.sh \
-	contrib/gdiffmk/tests/runtests.sh \
+	contrib/gdiffmk/gdiffmk.sh contrib/gdiffmk/tests/runtests.sh \
 	contrib/gdiffmk/tests/baseline \
 	contrib/gdiffmk/tests/baseline.6 \
 	contrib/gdiffmk/tests/baseline.6a \
@@ -4043,33 +4298,31 @@
 	contrib/gpinyin/gpinyin.1.man contrib/gpinyin/gpinyin.pl \
 	$(grap2graph_srcdir)/grap2graph.sh \
 	$(grap2graph_srcdir)/grap2graph.1.man \
-	contrib/groff_filenames/ChangeLog \
-	contrib/groff_filenames/groff_filenames.5.man $(GROFFER_PERL) \
-	$(GROFFER_REST) contrib/groffer/ChangeLog \
-	contrib/groffer/README contrib/groffer/README_PERL \
 	contrib/hdtbl/examples/fonts_n.in \
-	contrib/hdtbl/examples/fonts_x.in \
-	contrib/hdtbl/examples/test-hdtbl.sh.in $(am__append_4) \
+	contrib/hdtbl/examples/fonts_x.in $(hdtbl_test_template) \
 	contrib/hdtbl/ChangeLog contrib/hdtbl/TODO \
-	contrib/hdtbl/groff_hdtbl.7.man contrib/hdtbl/hdtbl.tmac-u \
-	contrib/hdtbl/hdmisc.tmac-u contrib/mm/ChangeLog \
+	contrib/hdtbl/groff_hdtbl.7.man contrib/mm/ChangeLog \
 	contrib/mm/examples contrib/mm/Makefile.sim contrib/mm/mm \
 	contrib/mm/NOTES contrib/mm/README contrib/mm/groff_mm.7.man \
 	contrib/mm/groff_mmse.7.man contrib/mm/mmroff.1.man \
-	contrib/mm/mmroff.pl $(am__append_7) \
-	contrib/mom/examples/test-mom.sh.in $(MOMHTMLDOCFILES) \
-	$(MOMEXAMPLEFILES) contrib/mom/BUGS contrib/mom/ChangeLog \
-	contrib/mom/NEWS contrib/mom/TODO contrib/mom/copyright \
-	contrib/mom/groff_mom.7.man $(am__append_11) \
-	contrib/pdfmark/cover.ms contrib/pdfmark/pdfmark.ms \
-	contrib/pdfmark/ChangeLog contrib/pdfmark/README \
-	contrib/pdfmark/PROBLEMS contrib/pdfmark/TODO \
-	contrib/pdfmark/pdfroff.1.man contrib/pdfmark/pdfroff.sh \
-	contrib/pic2graph/pic2graph.sh \
-	contrib/pic2graph/pic2graph.1.man $(am__append_13) \
-	doc/automake.mom $(am__append_16) doc/gnu.xpm doc/fixinfo.sh \
-	doc/txi-en.tex doc/groff.texi doc/fdl.texi doc/gnu.xpm \
-	$(DEVX100FONTS) $(DEVX10012FONTS) $(DEVX75FONTS) \
+	contrib/mm/mmroff.pl $(mm_TESTS) \
+	contrib/mm/tests/artifacts/60657.ref $(mom_test_template) \
+	$(MOMHTMLDOCFILES) $(MOMEXAMPLEFILES) contrib/mom/BUGS \
+	contrib/mom/ChangeLog contrib/mom/NEWS contrib/mom/TODO \
+	contrib/mom/copyright contrib/mom/groff_mom.7.man \
+	$(am__append_15) contrib/pdfmark/cover.ms \
+	contrib/pdfmark/pdfmark.ms contrib/pdfmark/ChangeLog \
+	contrib/pdfmark/README contrib/pdfmark/PROBLEMS \
+	contrib/pdfmark/TODO contrib/pdfmark/pdfroff.1.man \
+	contrib/pdfmark/pdfroff.sh contrib/pic2graph/pic2graph.sh \
+	contrib/pic2graph/pic2graph.1.man $(rfc1345_TESTS) \
+	contrib/rfc1345/groff_rfc1345.7.man contrib/rfc1345/COPYRIGHT \
+	contrib/sboxes/ChangeLog contrib/sboxes/msboxes.ms.in \
+	contrib/sboxes/notquine.sed $(DOCFILES_NOINST) \
+	doc/automake.mom doc/txi-en.tex doc/groff.texi doc/fdl.texi \
+	doc/groff.info doc/groff.txt doc/groff.html \
+	doc/groff.html.node doc/groff.dvi doc/groff.pdf $(DOC_GNU_EPS) \
+	doc/gnu.xpm $(DEVX100FONTS) $(DEVX10012FONTS) $(DEVX75FONTS) \
 	$(DEVX7512FONTS) font/devascii/R.proto \
 	font/devascii/DESC.proto font/devcp1047/R.proto \
 	font/devcp1047/DESC.proto $(DEVDVIFONTFILES) $(DEVDVIGENFILES) \
@@ -4078,38 +4331,38 @@
 	font/devlatin1/R.proto font/devlatin1/DESC.proto \
 	$(DEVLBPFONTFILES) font/devlbp/DESC.in font/devlj4/DESC.in \
 	font/devpdf/DESC.in font/devpdf/Foundry.in \
-	font/devpdf/util/BuildFoundries.pl font/devps/symbolmap \
-	font/devps/DESC.in font/devps/prologue.ps \
-	font/devps/psstrip.sed font/devps/symbol.afm \
-	font/devps/symbolsl.ps font/devps/zapfdr.afm \
-	font/devps/zapfdr.ps font/devps/generate/freeeuro.sfd \
+	font/devpdf/util/BuildFoundries.pl $(font_devpdf_default_test) \
+	$(font_devpdf_urw_test) font/devps/DESC.in \
+	font/devps/prologue.ps font/devps/psstrip.sed \
+	font/devps/freeeuro.ps font/devps/symbol.afm \
+	font/devps/symbolsl.afm font/devps/symbolsl.ps \
+	font/devps/zapfdr.afm font/devps/zapfdr.ps \
+	font/devps/generate/freeeuro.sfd \
 	font/devps/generate/make-zapfdr \
 	font/devps/generate/symbolsl.awk \
 	font/devps/generate/sfdtopfa.pe font/devps/generate/zapfdr.sed \
 	font/devutf8/R.proto font/devutf8/DESC.proto \
 	font/devutf8/NOTES font/devutf8/R.in $(GENFONTSSH) \
 	$(GENDESCSH) man/groff_font.5.man man/groff_out.5.man \
-	man/groff_tmac.5.man man/ditroff.7.man man/groff_char.7.man \
-	man/groff_diff.7.man man/groff.7.man man/roff.7.man \
-	src/libs/libgroff/mkstemp.cpp src/libs/libgroff/fmod.c \
-	src/libs/libgroff/getcwd.c src/libs/libgroff/putenv.c \
-	src/libs/libgroff/strcasecmp.c src/libs/libgroff/strerror.c \
-	src/libs/libgroff/strncasecmp.c src/libs/libgroff/strtol.c \
-	src/libs/libgroff/config.charset src/libs/libgroff/ref-add.sin \
-	src/libs/libgroff/ref-del.sin src/libs/libgroff/make-uniuni \
-	src/devices/grodvi/grodvi.1.man \
+	man/groff_tmac.5.man man/groff_char.7.man man/groff_diff.7.man \
+	man/groff.7.man man/roff.7.man src/libs/libgroff/mkstemp.cpp \
+	src/libs/libgroff/fmod.c src/libs/libgroff/getcwd.c \
+	src/libs/libgroff/putenv.c src/libs/libgroff/strcasecmp.c \
+	src/libs/libgroff/strerror.c src/libs/libgroff/strncasecmp.c \
+	src/libs/libgroff/strtol.c src/libs/libgroff/config.charset \
+	src/libs/libgroff/ref-add.sin src/libs/libgroff/ref-del.sin \
+	src/libs/libgroff/make-uniuni src/devices/grodvi/grodvi.1.man \
 	src/devices/grohtml/grohtml.1.man \
 	src/devices/grolbp/grolbp.1.man \
-	src/devices/grolj4/grolj4.1.man \
-	src/devices/grolj4/lj4_font.5.man src/devices/gropdf/TODO \
+	src/devices/grolj4/grolj4.1.man src/devices/gropdf/TODO \
 	src/devices/gropdf/gropdf.pl src/devices/gropdf/pdfmom.pl \
 	src/devices/gropdf/gropdf.1.man \
 	src/devices/gropdf/pdfmom.1.man src/devices/grops/grops.1.man \
 	src/devices/grops/psfig.diff src/devices/grops/TODO \
 	src/devices/grotty/grotty.1.man src/devices/grotty/TODO \
-	$(am__append_19) src/devices/xditview/ad2c \
+	$(grotty_TESTS) $(am__append_18) src/devices/xditview/ad2c \
 	src/devices/xditview/ChangeLog src/devices/xditview/DESC.in \
-	src/devices/xditview/FontMap \
+	src/devices/xditview/FontMap-X11 \
 	src/devices/xditview/GXditview-color.ad \
 	src/devices/xditview/GXditview.ad src/devices/xditview/README \
 	src/devices/xditview/TODO src/devices/xditview/gray1.bm \
@@ -4119,36 +4372,44 @@
 	src/devices/xditview/gray8.bm src/devices/xditview/xdit.bm \
 	src/devices/xditview/xdit_mask.bm \
 	src/devices/xditview/gxditview.1.man src/preproc/eqn/TODO \
-	src/preproc/eqn/neqn.sh src/preproc/eqn/eqn.1.man \
-	src/preproc/eqn/neqn.1.man src/preproc/grn/README \
-	src/preproc/grn/grn.1.man src/preproc/pic/pic.1.man \
-	src/preproc/pic/TODO src/preproc/preconv/preconv.1.man \
-	src/preproc/refer/TODO src/preproc/refer/refer.1.man \
+	src/preproc/eqn/eqn.1.man src/preproc/eqn/neqn.1.man \
+	src/preproc/eqn/neqn.sh $(eqn_TESTS) src/preproc/grn/README \
+	src/preproc/grn/grn.1.man src/preproc/pic/TODO \
+	src/preproc/pic/pic.1.man src/preproc/preconv/preconv.1.man \
+	$(preconv_TESTS) src/preproc/refer/TODO \
+	src/preproc/refer/refer.1.man $(refer_TESTS) \
+	src/preproc/refer/tests/artifacts/62124.bib \
 	src/preproc/soelim/TODO src/preproc/soelim/soelim.1.man \
-	src/preproc/tbl/tbl.1.man src/roff/groff/groff.1.man \
-	src/roff/grog/grog.1.man src/roff/grog/grog.pl \
+	src/preproc/tbl/tbl.1.man $(tbl_TESTS) \
+	src/roff/groff/groff.1.man $(groff_TESTS) \
+	src/roff/groff/tests/artifacts/HONEYPOT \
+	src/roff/groff/tests/artifacts/devascii/README \
 	src/roff/nroff/nroff.1.man src/roff/nroff/nroff.sh \
-	src/roff/troff/column.cpp src/roff/troff/troff.1.man \
-	src/roff/troff/TODO src/utils/addftinfo/addftinfo.1.man \
+	$(nroff_TESTS) src/roff/troff/column.cpp \
+	src/roff/troff/troff.1.man src/roff/troff/TODO \
+	src/utils/addftinfo/addftinfo.1.man \
 	src/utils/afmtodit/afmtodit.1.man \
 	src/utils/afmtodit/afmtodit.pl \
 	src/utils/afmtodit/afmtodit.tables \
 	src/utils/afmtodit/make-afmtodit-tables \
+	src/utils/grog/grog.1.man src/utils/grog/grog.pl \
+	src/utils/grog/tests/foo.man $(grog_TESTS) \
 	src/utils/hpftodit/hpftodit.1.man \
 	src/utils/indxbib/indxbib.1.man src/utils/indxbib/eign \
 	src/utils/lkbib/lkbib.1.man src/utils/lookbib/lookbib.1.man \
 	src/utils/pfbtops/pfbtops.1.man \
 	src/utils/tfmtodit/tfmtodit.1.man \
 	src/utils/xtotroff/xtotroff.1.man tmac/fixmacros.sed \
-	tmac/groff_ms.7.man tmac/groff_man.7.man tmac/groff_me.7.man \
-	tmac/groff_mdoc.7.man tmac/groff_trace.7.man \
-	tmac/groff_www.7.man tmac/hyphenex.pl tmac/LOCALIZATION \
-	tmac/man.ultrix tmac/psfig.tmac tmac/ptx.tmac tmac/strip.sed \
-	tmac/TESTING-HINTS tmac/TODO tmac/www.tmac.in BUG-REPORT \
-	ChangeLog.115 ChangeLog.116 ChangeLog.117 ChangeLog.118 \
-	ChangeLog.119 ChangeLog.120 ChangeLog.121 FDL FOR-RELEASE \
-	gendef.sh INSTALL.REPO INSTALL.extra LICENSES MANIFEST \
-	mdate.pl MORE.STUFF PROBLEMS PROJECTS README.MinGW arch/djgpp \
+	tmac/groff_ms.7.man tmac/groff_man.7.man.in \
+	tmac/groff_me.7.man tmac/groff_mdoc.7.man \
+	tmac/groff_trace.7.man tmac/groff_www.7.man tmac/hyphenex.pl \
+	tmac/LOCALIZATION tmac/man.ultrix tmac/psfig.tmac \
+	tmac/ptx.tmac tmac/TESTING-HINTS tmac/TODO tmac/www.tmac.in \
+	$(tmac_TESTS) BUG-REPORT ChangeLog.115 ChangeLog.116 \
+	ChangeLog.117 ChangeLog.118 ChangeLog.119 ChangeLog.120 \
+	ChangeLog.121 ChangeLog.122 FDL FOR-RELEASE gendef.sh HACKING \
+	INSTALL.REPO INSTALL.extra LICENSES MANIFEST mdate.pl \
+	MORE.STUFF PROBLEMS PROJECTS README.MinGW arch/djgpp \
 	font/util/make-Rproto makevarescape.sed $(top_srcdir)/.version
 FONTFILES = 
 PREFIXMAN1 = src/preproc/eqn/eqn.1 src/preproc/eqn/neqn.1 \
@@ -4160,28 +4421,24 @@
 man1_MANS = contrib/chem/chem.1 contrib/eqn2graph/eqn2graph.1 \
 	contrib/gdiffmk/gdiffmk.1 contrib/glilypond/glilypond.1 \
 	contrib/gperl/gperl.1 contrib/gpinyin/gpinyin.1 \
-	contrib/grap2graph/grap2graph.1 contrib/groffer/groffer.1 \
-	contrib/groffer/roff2dvi.1 contrib/groffer/roff2html.1 \
-	contrib/groffer/roff2pdf.1 contrib/groffer/roff2ps.1 \
-	contrib/groffer/roff2text.1 contrib/groffer/roff2x.1 \
-	contrib/mm/mmroff.1 contrib/pdfmark/pdfroff.1 \
-	contrib/pic2graph/pic2graph.1 src/devices/grodvi/grodvi.1 \
-	src/devices/grohtml/grohtml.1 src/devices/grolbp/grolbp.1 \
-	src/devices/grolj4/grolj4.1 src/devices/gropdf/gropdf.1 \
-	src/devices/gropdf/pdfmom.1 src/devices/grops/grops.1 \
-	src/devices/grotty/grotty.1 $(am__append_22) \
-	src/preproc/preconv/preconv.1 src/roff/groff/groff.1 \
-	src/roff/grog/grog.1 src/utils/addftinfo/addftinfo.1 \
-	src/utils/afmtodit/afmtodit.1 src/utils/hpftodit/hpftodit.1 \
-	src/utils/lkbib/lkbib.1 src/utils/pfbtops/pfbtops.1 \
-	src/utils/tfmtodit/tfmtodit.1 $(am__append_24) \
-	$(am__append_25)
-man5_MANS = contrib/groff_filenames/groff_filenames.5 man/groff_font.5 \
-	man/groff_out.5 man/groff_tmac.5 src/devices/grolj4/lj4_font.5
+	contrib/grap2graph/grap2graph.1 contrib/mm/mmroff.1 \
+	contrib/pdfmark/pdfroff.1 contrib/pic2graph/pic2graph.1 \
+	src/devices/grodvi/grodvi.1 src/devices/grohtml/grohtml.1 \
+	src/devices/grolbp/grolbp.1 src/devices/grolj4/grolj4.1 \
+	src/devices/gropdf/gropdf.1 src/devices/gropdf/pdfmom.1 \
+	src/devices/grops/grops.1 src/devices/grotty/grotty.1 \
+	$(am__append_21) src/preproc/preconv/preconv.1 \
+	src/roff/groff/groff.1 src/utils/addftinfo/addftinfo.1 \
+	src/utils/afmtodit/afmtodit.1 src/utils/grog/grog.1 \
+	src/utils/hpftodit/hpftodit.1 src/utils/lkbib/lkbib.1 \
+	src/utils/pfbtops/pfbtops.1 src/utils/tfmtodit/tfmtodit.1 \
+	$(am__append_23) $(am__append_24)
+man5_MANS = man/groff_font.5 man/groff_out.5 man/groff_tmac.5
 man7_MANS = contrib/hdtbl/groff_hdtbl.7 contrib/mm/groff_mm.7 \
-	contrib/mm/groff_mmse.7 contrib/mom/groff_mom.7 man/ditroff.7 \
-	man/groff_char.7 man/groff_diff.7 man/groff.7 man/roff.7 \
-	tmac/groff_ms.7 tmac/groff_man.7 tmac/groff_me.7 \
+	contrib/mm/groff_mmse.7 contrib/mom/groff_mom.7 \
+	contrib/rfc1345/groff_rfc1345.7 man/groff_char.7 \
+	man/groff_diff.7 man/groff.7 man/roff.7 tmac/groff_ms.7 \
+	tmac/groff_man.7 tmac/groff_man_style.7 tmac/groff_me.7 \
 	tmac/groff_mdoc.7 tmac/groff_trace.7 tmac/groff_www.7
 
 # for lex/yacc
@@ -4189,14 +4446,17 @@
 
 # Rule to generate ps and roff files
 
-# Rule to generated .pdf files from .mom files
-SUFFIXES = .roff .in .ps .mom .pdf .me .ms .ps .html .txt .texi .dvi \
-	.pdf .xhtml .man
+# rule to generate .pdf files from .mom files
+SUFFIXES = .roff .in .ps .mom .pdf .me.in .me .man
 
 # tests launched by make check
 check_SCRIPTS = 
-TESTS = contrib/gdiffmk/tests/gdiffmk_tests.sh $(am__append_5) \
-	$(am__append_8)
+TESTS = contrib/gdiffmk/tests/runtests.sh $(hdtbl_TESTS) $(mm_TESTS) \
+	$(mom_TESTS) $(rfc1345_TESTS) $(font_devpdf_TESTS) \
+	$(grotty_TESTS) $(eqn_TESTS) $(preconv_TESTS) $(refer_TESTS) \
+	$(tbl_TESTS) $(groff_TESTS) $(nroff_TESTS) $(grog_TESTS) \
+	$(tmac_TESTS)
+XFAIL_TESTS = $(groff_XFAIL_TESTS) $(tmac_XFAIL_TESTS)
 AM_TESTS_ENVIRONMENT = \
   abs_top_srcdir=$(abs_top_srcdir) \
   abs_top_builddir=$(abs_top_builddir) \
@@ -4211,7 +4471,7 @@
 # This is done by the m4 macro GROFF_G that checks for the presence of
 # GNU Troff built-in \n.g macro. If a Unix Troff binary was
 # detected, the following programs and scripts names will have a 'g'
-# prefix: chem, tbl, eqn, neqn, pic, soleimm grn, refer, lookbib,
+# prefix: chem, tbl, eqn, neqn, pic, soelim, grn, refer, lookbib,
 # troff, nroff. Also, PROG_PREFIX will be set to 'g' in the generated
 # header defs.h so that these programs could be called correctly.
 #
@@ -4221,9 +4481,9 @@
 NAMEPREFIX = $(g)
 prefixexecbin_SCRIPTS = chem neqn nroff
 @USEPROGRAMPREFIX_FALSE@prefixexecbindir = $(bindir)
-# We use datadir because the uninstall rule for the PROGRAMS attempt
+# We use datadir because the uninstall rule for the PROGRAMS attempts
 # to cd into prefixexecbindir, and thus if prefixexecbindir is removed
-# two consecutive uninstall would fail
+# two consecutive uninstalls would fail
 @USEPROGRAMPREFIX_TRUE@prefixexecbindir = $(datadir)
 
 # Path to binaries and flags used by contribs and doc to generated doc.
@@ -4231,12 +4491,11 @@
 GROFFBIN = $(abs_top_builddir)/groff
 GROFF_BIN_PATH = $(abs_top_builddir)
 PDFMOMBIN = $(abs_top_builddir)/pdfmom
-# The second directories are needed for the case "cd build; ../configure".
+# Search for macro files and device/font description directories in
+# source _and_ build trees; some of each are generated.
 FFLAG = -F$(abs_top_builddir)/font -F$(abs_top_srcdir)/font
-TFLAG = -M$(abs_top_builddir)/tmac -M$(abs_top_srcdir)/tmac
-
-# make builtin variable RM
-@MAKE_DONT_HAVE_RM_TRUE@RM = rm -f
+MFLAG = -M$(abs_top_builddir)/tmac -M$(abs_top_srcdir)/tmac
+@MAKE_DEFINES_RM_FALSE@RM = rm -f
 
 # 'VERSION' is generated by gnulib script git-version-gen, using the
 # command 'git describe':
@@ -4263,23 +4522,46 @@
 MAJOR_VERSION = `echo $(VERSION) | cut -d . -f 1`
 MINOR_VERSION = `echo $(VERSION) | cut -d . -f 2`
 REVISION = `echo $(VERSION) | cut -d . -f 3`
-lib_libgnu_a_SOURCES = lib/localcharset.c lib/math.c \
-	lib/printf-frexp.c lib/printf-frexpl.c lib/size_max.h \
-	$(am__append_1) lib/wctype-h.c lib/xsize.h lib/xsize.c
+lib_libgnu_a_SOURCES = $(am__append_1) $(am__append_2) $(am__append_3) \
+	$(am__append_4) lib/localcharset.c lib/math.c $(am__append_5) \
+	lib/printf-frexp.c lib/printf-frexpl.c $(am__append_6) \
+	lib/size_max.h $(am__append_7) $(am__append_8) lib/unistd.c \
+	$(am__append_9) lib/wctype-h.c $(am__append_10) lib/xsize.h \
+	lib/xsize.c
+lib_libgnu_a_CFLAGS = $(AM_CFLAGS) $(GL_CFLAG_GNULIB_WARNINGS)
 lib_libgnu_a_LIBADD = $(gl_LIBOBJS)
 lib_libgnu_a_DEPENDENCIES = $(gl_LIBOBJS)
-EXTRA_lib_libgnu_a_SOURCES = lib/float.c lib/itold.c lib/fprintf.c \
-	lib/frexp.c lib/frexp.c lib/frexpl.c lib/fseterr.c lib/isnan.c \
-	lib/isnand.c lib/isnan.c lib/isnanf.c lib/isnan.c lib/isnanl.c \
-	lib/memchr.c lib/printf-frexp.c lib/signbitd.c lib/signbitf.c \
-	lib/signbitl.c lib/snprintf.c lib/asnprintf.c \
-	lib/printf-args.c lib/printf-parse.c lib/vasnprintf.c \
-	lib/vsnprintf.c lib/wcwidth.c
+EXTRA_lib_libgnu_a_SOURCES = lib/fprintf.c lib/frexp.c lib/frexp.c \
+	lib/frexpl.c lib/isnan.c lib/isnand.c lib/isnan.c lib/isnanf.c \
+	lib/isnan.c lib/isnanl.c lib/printf-frexp.c lib/snprintf.c \
+	lib/asnprintf.c lib/printf-args.c lib/printf-parse.c \
+	lib/vasnprintf.c lib/vsnprintf.c
 
 # Use this preprocessor expression to decide whether #include_next works.
 # Do not rely on a 'configure'-time test for this, since the expression
 # might appear in an installed header, which is used by some other compiler.
-HAVE_INCLUDE_NEXT = lib/(__GNUC__ lib/|| lib/60000000 lib/<= lib/__DECC_VER)
+HAVE_INCLUDE_NEXT = (__GNUC__ || __clang__ || 60000000 <= __DECC_VER)
+
+# In 'sed', replace the pattern space with a "DO NOT EDIT" comment.
+SED_HEADER_NOEDIT = s,.*,/* DO NOT EDIT! GENERATED AUTOMATICALLY! */,
+
+# '$(SED_HEADER_STDOUT) -e "..."' runs 'sed' but first outputs "DO NOT EDIT".
+SED_HEADER_STDOUT = sed -e 1h -e '1$(SED_HEADER_NOEDIT)' -e 1G
+
+# '$(SED_HEADER_TO_AT_t) FILE' copies FILE to $@-t, prepending a leading
+# "DO_NOT_EDIT".  Although this could be done more simply via:
+#	SED_HEADER_TO_AT_t = $(SED_HEADER_STDOUT) > $@-t
+# the -n and 'w' avoid a fork+exec, at least when GNU Make is used.
+SED_HEADER_TO_AT_t = $(SED_HEADER_STDOUT) -n -e 'w $@-t'
+
+# Use $(gl_V_at) instead of $(AM_V_GEN) or $(AM_V_at) on a line that
+# is its recipe's first line if and only if  lines are absent.
+gl_V_at = $(AM_V_at)
+
+# Because this Makefile snippet defines a variable used by other
+# gnulib Makefile snippets, it must be present in all makefiles that
+# need it. This is ensured by the applicability 'all' defined above.
+_NORETURN_H = $(top_srcdir)/lib/_Noreturn.h
 
 # Because this Makefile snippet defines a variable used by other
 # gnulib Makefile snippets, it must be present in all makefiles that
@@ -4296,9 +4578,7 @@
 # need it. This is ensured by the applicability 'all' defined above.
 WARN_ON_USE_H = $(top_srcdir)/lib/warn-on-use.h
 
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -4323,7 +4603,6 @@
   arch/mingw/gperl.cmd \
   arch/mingw/gpinyin.cmd \
   arch/mingw/grap2graph.cmd \
-  arch/mingw/groffer.cmd \
   arch/mingw/grog.cmd \
   arch/mingw/gropdf.cmd \
   arch/mingw/mmroff.cmd \
@@ -4336,6 +4615,7 @@
   arch/mingw/roff2text.cmd \
   arch/mingw/roff2x.cmd
 
+arch_shdeps_sh = arch/misc/shdeps.sh
 chem_srcdir = $(top_srcdir)/contrib/chem
 
 # Files installed in $(datasubdir)/pic
@@ -4353,14 +4633,14 @@
 
 
 # Files installed in $(exampledir)/chem
-@BUILD_EXAMPLES_TRUE@chemexampledir = $(exampledir)/chem
-@BUILD_EXAMPLES_TRUE@nodist_chemexample_DATA = $(CHEM_GENEXAMPLES)
-@BUILD_EXAMPLES_TRUE@dist_chemexample_DATA = $(CHEM_EXAMPLES)
+chemexampledir = $(exampledir)/chem
+nodist_chemexample_DATA = $(CHEM_GENEXAMPLES)
+dist_chemexample_DATA = $(CHEM_EXAMPLES)
 
 # Files installed in $(exampledir)/chem/122. All the .chem files in 122 are 
 # lazily installed by the local install target
-@BUILD_EXAMPLES_TRUE@chemexample122dir = $(chemexampledir)/122
-@BUILD_EXAMPLES_TRUE@nodist_chemexample122_DATA = contrib/chem/examples/122/README
+chemexample122dir = $(chemexampledir)/122
+nodist_chemexample122_DATA = contrib/chem/examples/122/README
 eqn2graph_srcdir = $(top_srcdir)/contrib/eqn2graph
 
 ########################################################################
@@ -4372,73 +4652,24 @@
 # files going to lib directory '$(glilypond_dir)'
 # TODO glilypond_dir is subsitued by configure.ac, check if this could be removed
 glilyponddir = $(glilypond_dir)
-dist_glilypond_DATA = \
-  contrib/glilypond/subs.pl \
-  contrib/glilypond/oop_fh.pl \
-  contrib/glilypond/args.pl
-
 gpinyin_srcdir = $(top_srcdir)/contrib/gpinyin
 gpinyindir = $(gpinyin_dir)
-dist_gpinyin_DATA = contrib/gpinyin/subs.pl
 grap2graph_srcdir = $(top_srcdir)/contrib/grap2graph
-groffer_srcdir = $(top_srcdir)/contrib/groffer
-# generated programs
-ROFF2PROGS = \
-  roff2dvi \
-  roff2html \
-  roff2pdf \
-  roff2ps \
-  roff2text \
-  roff2x
-
-
-# Generated man templates
-ROFF2MAN = \
-  contrib/groffer/roff2dvi.1.man \
-  contrib/groffer/roff2html.1.man \
-  contrib/groffer/roff2pdf.1.man \
-  contrib/groffer/roff2ps.1.man \
-  contrib/groffer/roff2text.1.man \
-  contrib/groffer/roff2x.1.man
-
-GROFFER_PERL = \
-  contrib/groffer/main_subs.pl \
-  contrib/groffer/man.pl \
-  contrib/groffer/split_env.sh \
-  contrib/groffer/subs.pl
-
-GROFFER_REST = \
-  contrib/groffer/roff2.1.man \
-  contrib/groffer/version.sh \
-  contrib/groffer/groffer.1.man \
-  contrib/groffer/groffer.pl \
-  contrib/groffer/roff2.pl
-
-
-# groffer_dir is set by a m4 macro
-grofferdir = $(groffer_dir)
-groffer_DATA = $(GROFFER_PERL) contrib/groffer/version.sh
 hdtbl_srcdir = $(top_srcdir)/contrib/hdtbl
-hdtbl_builddir = $(top_builddir)/contrib/hdtbl
 
 # Groff command used to generate .ps files
-HDTBL_TFLAG = -M$(hdtbl_srcdir) -M$(hdtbl_builddir)
-HDTBL_PFLAG = -t -p -e -U
 HDTBLGROFF = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  $(GROFFBIN) $(FFLAG) $(TFLAG) $(HDTBL_TFLAG) $(HDTBL_PFLAG)
+  $(GROFFBIN) $(FFLAG) $(MFLAG) -M$(hdtbl_srcdir) -t -p -e -U
 
-
-# Files installed in $(tmacdir).
-# These files are generated with 'strip.sed' from their unstripped source file
-# equivalent (e.g. hdtbl.tmac is generated from hdtbl.tmac-u)
-HDTBLSTRIPFILES = \
+HDTBLTMACFILES = \
   contrib/hdtbl/hdtbl.tmac \
   contrib/hdtbl/hdmisc.tmac
 
 hdtbltmacdir = $(tmacdir)
-hdtbltmac_DATA = $(HDTBLSTRIPFILES)
+dist_hdtbltmac_DATA = $(HDTBLTMACFILES)
+hdtbl_test_template = contrib/hdtbl/examples/test-hdtbl.sh.in
 
 # Files installed in $(exampledir)/hdtbl.  HDTBLEXAMPLEFILES are
 # located in the source tree, while HDTBLPROCESSEDEXAMPLEFILES are
@@ -4475,13 +4706,13 @@
   contrib/hdtbl/examples/short_reference.ps
 
 hdtblexampledir = $(exampledir)/hdtbl
-@BUILD_EXAMPLES_TRUE@dist_hdtblexample_DATA = $(HDTBLEXAMPLEFILES)
-@BUILD_EXAMPLES_TRUE@nodist_hdtblexample_DATA = \
-@BUILD_EXAMPLES_TRUE@  $(HDTBLGENFILES) \
-@BUILD_EXAMPLES_TRUE@  $(HDTBLPROCESSEDEXAMPLEFILES) \
-@BUILD_EXAMPLES_TRUE@  gnu.eps
+dist_hdtblexample_DATA = $(HDTBLEXAMPLEFILES)
+nodist_hdtblexample_DATA = \
+  $(HDTBLGENFILES) \
+  $(HDTBLPROCESSEDEXAMPLEFILES) \
+  $(DOC_GNU_EPS)
 
-@BUILD_EXAMPLES_TRUE@hdtbl_TESTS = contrib/hdtbl/examples/test-hdtbl.sh
+hdtbl_TESTS = contrib/hdtbl/examples/test-hdtbl.sh
 mm_srcdir = $(top_srcdir)/contrib/mm
 mm_builddir = $(top_builddir)/contrib/mm
 
@@ -4504,22 +4735,28 @@
 
 mmexampledir = $(exampledir)/mm
 dist_mmexample_DATA = $(MMEXAMPLEFILES)
-
-# Local configuration files with default values.
-MMLOCALE = \
-  locale \
-  se_locale
+mm_TESTS = \
+  contrib/mm/tests/LT_SP_AU_without_AT_works.sh \
+  contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh \
+  contrib/mm/tests/MT-1-reports-all-TM-numbers.sh \
+  contrib/mm/tests/MT_5_includes_AT_in_SG.sh \
+  contrib/mm/tests/P-indentation-works.sh \
+  contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh \
+  contrib/mm/tests/mse_has-sufficient-footnote-space.sh \
+  contrib/mm/tests/place-equation-labels-correctly-in-displays.sh \
+  contrib/mm/tests/remove-stale-bib-entry-data.sh \
+  contrib/mm/tests/short-pages-do-not-overflow-stack.sh
 
 mom_srcdir = $(top_srcdir)/contrib/mom
 
-# pdfmom command used to generated .pdf
-MOM_TFLAG = -M$(mom_srcdir)
-MOM_KFLAG = -k -p -e -t
+# pdfmom command used to generate .pdf
+#
+# Use '-K utf8', not '-k', in case 'configure' didn't find uchardet.
 MOMPDFMOM = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
   PDFMOM_BIN_PATH="$(top_builddir)" \
-  $(PDFMOMBIN) $(FFLAG) $(TFLAG) $(MOM_TFLAG) $(MOM_KFLAG)
+  $(PDFMOMBIN) $(FFLAG) $(MFLAG) -M$(mom_srcdir) -K utf8 -p -e -t
 
 
 # Files installed in $(tmacdir).
@@ -4532,33 +4769,33 @@
 dist_momtmac_DATA = $(MOMNORMALFILES)
 
 # Files installed in htmldocdir/mom
-@INSTALL_SHIPPED_HTML_TRUE@MOMHTMLDOCFILES = \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/stylesheet.css \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/appendices.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/color.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/cover.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/definitions.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/docelement.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/docprocessing.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/goodies.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/graphical.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/headfootpage.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/images.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/inlines.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/intro.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/letters.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/macrolist.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/rectoverso.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/refer.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/reserved.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/tables-of-contents.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/toc.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/typesetting.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/using.html \
-@INSTALL_SHIPPED_HTML_TRUE@  contrib/mom/momdoc/version-2.html
+MOMHTMLDOCFILES = \
+  contrib/mom/momdoc/stylesheet.css \
+  contrib/mom/momdoc/appendices.html \
+  contrib/mom/momdoc/color.html \
+  contrib/mom/momdoc/cover.html \
+  contrib/mom/momdoc/definitions.html \
+  contrib/mom/momdoc/docelement.html \
+  contrib/mom/momdoc/docprocessing.html \
+  contrib/mom/momdoc/goodies.html \
+  contrib/mom/momdoc/graphical.html \
+  contrib/mom/momdoc/headfootpage.html \
+  contrib/mom/momdoc/images.html \
+  contrib/mom/momdoc/inlines.html \
+  contrib/mom/momdoc/intro.html \
+  contrib/mom/momdoc/letters.html \
+  contrib/mom/momdoc/macrolist.html \
+  contrib/mom/momdoc/rectoverso.html \
+  contrib/mom/momdoc/refer.html \
+  contrib/mom/momdoc/reserved.html \
+  contrib/mom/momdoc/tables-of-contents.html \
+  contrib/mom/momdoc/toc.html \
+  contrib/mom/momdoc/typesetting.html \
+  contrib/mom/momdoc/using.html \
+  contrib/mom/momdoc/version-2.html
 
-@INSTALL_SHIPPED_HTML_TRUE@momhtmldir = $(htmldocdir)/mom
-@INSTALL_SHIPPED_HTML_TRUE@momhtml_DATA = $(MOMHTMLDOCFILES)
+momhtmldir = $(htmldocdir)/mom
+momhtml_DATA = $(MOMHTMLDOCFILES)
 
 # Files installed in $(examplesdir)/mom.  MOMEXAMPLEFILES are located
 # in the source tree, while MOMPROCESSEDEXAMPLEFILES are generated in
@@ -4576,23 +4813,27 @@
   contrib/mom/examples/penguin.ps \
   contrib/mom/examples/penguin.pdf \
   contrib/mom/examples/mom.vim \
-  contrib/mom/examples/slide-demo.mom
-
-@BUILD_EXAMPLES_TRUE@momexampledir = $(exampledir)/mom
-@BUILD_EXAMPLES_TRUE@dist_momexample_DATA = $(MOMEXAMPLEFILES)
-@BUILD_PDFEXAMPLES_TRUE@MOMPROCESSEDEXAMPLEFILES = \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/letter.pdf \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/mom-pdf.pdf \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/mon_premier_doc.pdf \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/sample_docs.pdf \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/typesetting.pdf \
-@BUILD_PDFEXAMPLES_TRUE@  contrib/mom/examples/slide-demo.pdf
-
-@BUILD_PDFEXAMPLES_TRUE@momprocessedexampledir = $(exampledir)/mom
-@BUILD_PDFEXAMPLES_TRUE@nodist_momprocessedexample_DATA = $(MOMPROCESSEDEXAMPLEFILES)
+  contrib/mom/examples/slide-demo.mom \
+  contrib/mom/examples/copyright-default.mom \
+  contrib/mom/examples/copyright-chapter.mom
+
+momexampledir = $(exampledir)/mom
+dist_momexample_DATA = $(MOMEXAMPLEFILES)
+@USE_GROPDF_TRUE@MOMPROCESSEDEXAMPLEFILES =  \
+@USE_GROPDF_TRUE@	contrib/mom/examples/letter.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/mom-pdf.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/mon_premier_doc.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/sample_docs.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/slide-demo.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/copyright-default.pdf \
+@USE_GROPDF_TRUE@	contrib/mom/examples/copyright-chapter.pdf \
+@USE_GROPDF_TRUE@	$(am__append_13)
+@USE_GROPDF_TRUE@momprocessedexampledir = $(exampledir)/mom
+@USE_GROPDF_TRUE@nodist_momprocessedexample_DATA = $(MOMPROCESSEDEXAMPLEFILES)
+mom_test_template = contrib/mom/examples/test-mom.sh.in
 
 # Small test suite on mom examples
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@mom_TESTS = contrib/mom/examples/tests-mom.sh
+mom_TESTS = contrib/mom/examples/tests-mom.sh
 
 # For this list of files we add a symlink from $(exampledir)/mom to $(pdfdocdir)
 PDFDOCFILE = mom-pdf.pdf
@@ -4602,6 +4843,7 @@
 # Files installed in $(tmacdir)
 TMACFILES = \
   contrib/pdfmark/pdfmark.tmac \
+  contrib/pdfmark/sanitize.tmac \
   contrib/pdfmark/spdf.tmac
 
 pdfmarktmacdir = $(tmacdir)
@@ -4611,60 +4853,123 @@
 PDFDOCFILES = \
   contrib/pdfmark/pdfmark.pdf
 
-@BUILD_PDFDOC_TRUE@pdfmarkpdfdocdir = $(pdfdocdir)
-@BUILD_PDFDOC_TRUE@nodist_pdfmarkpdfdoc_DATA = $(PDFDOCFILES)
-PDFMARK_PFLAG = -dpaper=$(PAGE) -P-p$(PAGE)
-PDFMARK_TFLAG = -M$(pdfmark_srcdir)
+@USE_PDFROFF_TRUE@pdfmarkpdfdocdir = $(pdfdocdir)
+@USE_PDFROFF_TRUE@nodist_pdfmarkpdfdoc_DATA = $(PDFDOCFILES)
 PDFROFF = \
   GROFF_TMPDIR=. \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_DIR="$(GROFF_BIN_DIR)" \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  ./pdfroff --keep-temporary-files \
-  $(FFLAG) $(TFLAG) $(PDFMARK_TFLAG) $(PDFMARK_PFLAG)
+  ./pdfroff \
+  $(FFLAG) $(MFLAG) -dpaper=$(PAGE) -P-p$(PAGE) -M$(pdfmark_srcdir)
 
 pic2graph_srcdir = $(top_srcdir)/contrib/pic2graph
+rfc1345_srcdir = $(top_srcdir)/contrib/rfc1345
+rfc1345_builddir = $(top_builddir)/contrib/rfc1345
+
+# files installed in $(tmacdir)
+rfc1345tmacdir = $(tmacdir)
+dist_rfc1345tmac_DATA = contrib/rfc1345/rfc1345.tmac
+rfc1345_TESTS = \
+  contrib/rfc1345/tests/rfc1345-smoke-test.sh
+
+sboxes_srcdir = $(top_srcdir)/contrib/sboxes
+sboxes_builddir = $(top_builddir)/contrib/sboxes
+sboxesnotquine = $(sboxes_srcdir)/notquine.sed
+sboxestmacdir = $(tmacdir)
+dist_sboxestmac_DATA = contrib/sboxes/sboxes.tmac
+SBOXES_EXAMPLEFILES = $(sboxes_srcdir)/msboxes.ms.in
+sboxesotherdocdir = $(docdir)
+nodist_sboxesotherdoc_DATA = $(sboxes_builddir)/msboxes.ms
+@USE_GROPDF_TRUE@sboxespdfdocdir = $(pdfdocdir)
+@USE_GROPDF_TRUE@nodist_sboxespdfdoc_DATA = $(sboxes_builddir)/msboxes.pdf
 doc_srcdir = $(abs_top_srcdir)/doc
 doc_builddir = $(abs_top_builddir)/doc
-DOC_SED = $(SED) -e "s;@VERSION@;$(VERSION);"
-DOC_GROFF_ONLY = \
+
+# Some document sources are parameterized in configuration options like
+# the groff version number and the command prefix.  Use this in target
+# rules to prepare formattable versions of them from .in files.
+DOC_SED = $(SED) \
+  -e "s;@VERSION@;$(VERSION);" \
+  -e "s;@g@;$(g);g;"
+
+
+# Use this in target rules to run the build tree's groff.
+#
+# It includes flags to locate its tmac and device/font description
+# directories and to produce verbose diagnostics in the event of syntax
+# or formatting problems.
+DOC_GROFF = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  $(GROFFBIN) -I$(abs_top_builddir) -M $(doc_srcdir) \
-	$(TFLAG) $(FFLAG) -Upet -ww 
+  $(GROFFBIN) -M $(doc_srcdir) $(MFLAG) $(FFLAG) -ww -b
 
-DOC_GROFF = $(DOC_SED) $< | $(DOC_GROFF_ONLY)
+
+# This image file is used by several documents in the groff source tree.
+DOC_GNU_EPS = doc/gnu.eps
 
 # Other doc, installed in $(docdir)
 # Files located in the source tree
-@BUILD_OTHERDOC_TRUE@DOCFILES = \
-@BUILD_OTHERDOC_TRUE@  doc/meref.me \
-@BUILD_OTHERDOC_TRUE@  doc/meintro.me \
-@BUILD_OTHERDOC_TRUE@  doc/meintro_fr.me \
-@BUILD_OTHERDOC_TRUE@  doc/pic.ms
+DOCFILES_INST = \
+  doc/me-revisions \
+  doc/ms.ms \
+  doc/pic.ms
+
+DOCFILES_NOINST = \
+  doc/meintro.me.in \
+  doc/meintro_fr.me.in \
+  doc/meref.me.in
+
+# Files that undergo a transformation prior to groff processing
+GENERATEDDOCFILES = \
+  doc/meintro.me \
+  doc/meintro_fr.me \
+  doc/meref.me
 
 # Files generated in the build tree
-@BUILD_OTHERDOC_TRUE@PROCESSEDDOCFILES = \
-@BUILD_OTHERDOC_TRUE@  doc/meref.ps \
-@BUILD_OTHERDOC_TRUE@  doc/meintro.ps \
-@BUILD_OTHERDOC_TRUE@  doc/meintro_fr.ps \
-@BUILD_OTHERDOC_TRUE@  doc/pic.ps
-
-@BUILD_OTHERDOC_TRUE@otherdocdir = $(docdir)
-@BUILD_OTHERDOC_TRUE@dist_otherdoc_DATA = $(DOCFILES)
-@BUILD_OTHERDOC_TRUE@nodist_otherdoc_DATA = $(PROCESSEDDOCFILES)
-@BUILD_PDFDOC_TRUE@docpdfdocdir = $(pdfdocdir)
-@BUILD_PDFDOC_TRUE@nodist_docpdfdoc_DATA = doc/automake.pdf
+@USE_GROHTML_TRUE@PROCESSEDDOCFILES_HTML = \
+@USE_GROHTML_TRUE@  doc/pic.html
+
+@USE_GROPDF_TRUE@PROCESSEDDOCFILES_PDF = \
+@USE_GROPDF_TRUE@  doc/automake.pdf \
+@USE_GROPDF_TRUE@  doc/groff-man-pages.pdf
+
+PROCESSEDDOCFILES_PS = \
+  doc/meref.ps \
+  doc/meintro.ps \
+  doc/meintro_fr.ps \
+  doc/ms.ps \
+  doc/pic.ps
+
+PROCESSEDDOCFILES_TXT = \
+  doc/groff-man-pages.utf8.txt
+
+PROCESSEDDOCFILES = \
+  $(PROCESSEDDOCFILES_HTML) \
+  $(PROCESSEDDOCFILES_PS) \
+  $(PROCESSEDDOCFILES_PDF) \
+  $(PROCESSEDDOCFILES_TXT)
+
+
+# Declare minimal dependencies for documents by output driver.
+PROCESSEDFILES_DEPS_HTML = pre-grohtml groff troff post-grohtml \
+  font/devhtml/stamp font/devps/stamp
+
+PROCESSEDFILES_DEPS_PS = groff troff grops font/devps/stamp
+PROCESSEDFILES_DEPS_PDF = groff troff gropdf font/devpdf/stamp
+PROCESSEDFILES_DEPS_TXT = groff troff grotty font/devutf8/stamp
+otherdocdir = $(docdir)
+dist_otherdoc_DATA = $(DOCFILES_INST)
+nodist_otherdoc_DATA = $(PROCESSEDDOCFILES) $(GENERATEDDOCFILES)
+@USE_GROPDF_TRUE@docpdfdocdir = $(pdfdocdir)
+@USE_GROPDF_TRUE@nodist_docpdfdoc_DATA = doc/automake.pdf
 
 # GNU PIC html documentation, installed in $(htmldocdir)
 # Other pic*.html files are installed by the local rule
-@BUILD_HTML_TRUE@HTMLDOCFILES = \
-@BUILD_HTML_TRUE@  doc/pic.html
-
-@BUILD_HTML_TRUE@htmlpicdir = $(htmldocdir)
-@BUILD_HTML_TRUE@htmlpic_DATA = $(HTMLDOCFILES)
-@BUILD_HTML_TRUE@HTMLDOCFILESALL = pic*.html
-@BUILD_HTML_TRUE@HTMLDOCIMAGEFILES = pic*
+@USE_GROHTML_TRUE@htmlpicdir = $(htmldocdir)
+@USE_GROHTML_TRUE@htmlpic_DATA = $(PROCESSEDDOCFILES_HTML)
+@USE_GROHTML_TRUE@HTMLDOCFILESALL = pic*.html
+@USE_GROHTML_TRUE@HTMLDOCIMAGEFILES = pic*
 
 # Examples files, installed in $(exampledir)
 
@@ -4675,33 +4980,129 @@
   doc/grnexmpl.g \
   doc/grnexmpl.me
 
+@USE_GROHTML_FALSE@PROCESSEDEXAMPLEFILES_HTML = 
 
 # Generated in the build tree
-@BUILD_EXAMPLES_TRUE@PROCESSEDEXAMPLEFILES = \
-@BUILD_EXAMPLES_TRUE@  doc/webpage.ps \
-@BUILD_EXAMPLES_TRUE@  doc/grnexmpl.ps
-
-@BUILD_EXAMPLES_TRUE@docexamplesdir = $(exampledir)
-@BUILD_EXAMPLES_TRUE@dist_docexamples_DATA = $(EXAMPLEFILES)
-@BUILD_EXAMPLES_TRUE@nodist_docexamples_DATA = $(PROCESSEDEXAMPLEFILES)
-
-# webpage.html is generated, webpage*.html files are installed by the local rule.
-@BUILD_HTMLEXAMPLES_TRUE@HTMLEXAMPLEFILES = doc/webpage.html
-@BUILD_HTMLEXAMPLES_TRUE@HTMLEXAMPLEFILESALL = webpage*.html
-@BUILD_HTMLEXAMPLES_TRUE@HTMLEXAMPLEIMAGEFILES = webpage*
-@BUILD_HTMLEXAMPLES_TRUE@htmlexamplesdir = $(exampledir)
-@BUILD_HTMLEXAMPLES_TRUE@nodist_htmlexamples_DATA = $(HTMLEXAMPLEFILES)
+@USE_GROHTML_TRUE@PROCESSEDEXAMPLEFILES_HTML = doc/webpage.html
+PROCESSEDEXAMPLEFILES_PS = \
+  doc/webpage.ps \
+  doc/grnexmpl.ps
+
+PROCESSEDEXAMPLEFILES = \
+  $(PROCESSEDEXAMPLEFILES_HTML) \
+  $(PROCESSEDEXAMPLEFILES_PS)
+
+docexamplesdir = $(exampledir)
+dist_docexamples_DATA = $(EXAMPLEFILES)
+nodist_docexamples_DATA = $(PROCESSEDEXAMPLEFILES)
+
+# webpage.html is generated; webpage*.html files are installed by the
+# local rule.
+@USE_GROHTML_TRUE@HTMLEXAMPLEFILESALL = webpage*.html
+@USE_GROHTML_TRUE@HTMLEXAMPLEIMAGEFILES = webpage*
+@USE_GROHTML_TRUE@htmlexamplesdir = $(exampledir)
+
+# Locate image subdirectory for HTML documents relative to an
+# installation directory such as `htmldocdir` or `exampledir`.  Do _not_
+# use for locating files within the source or build trees.
 imagedir = img
-htmldocimagedir = $(htmldocdir)/img
-exampleimagedir = $(exampledir)/img
-@BUILD_INFODOC_TRUE@groffinfodir = $(infodir)
-@BUILD_INFODOC_TRUE@groffpdfdir = $(infodir)
-
-# GNU Make has a built-in variable TEXI2DVI but it is not the case of
-# all 'make' implementation.  As it default to 'texi2dvi' we simply
-# redefine it here.
-TEXI2DVI = texi2dvi
-texi2dvi_missing = no
+
+# Introduce variables to house the groff man pages.  We break the list
+# of page sources into multiple chunks because we have to load Swedish
+# localization before formatting groff_mmse.7 and then reload English
+# localization afterward.  This also serves as a test of groff locale
+# switching; being lazy and shunting groff_mmse.7 off to the end of the
+# document would not achieve this goal (and not loading Swedish
+# localization at all to format it would be gauche).
+GROFF_MAN_PAGES1 = \
+  src/utils/addftinfo/addftinfo.1 \
+  src/utils/afmtodit/afmtodit.1 \
+  contrib/chem/chem.1 \
+  src/preproc/eqn/eqn.1 \
+  contrib/eqn2graph/eqn2graph.1 \
+  contrib/gdiffmk/gdiffmk.1 \
+  contrib/glilypond/glilypond.1 \
+  contrib/gperl/gperl.1 \
+  contrib/gpinyin/gpinyin.1 \
+  contrib/grap2graph/grap2graph.1 \
+  src/preproc/grn/grn.1 \
+  src/devices/grodvi/grodvi.1 \
+  src/roff/groff/groff.1 \
+  src/utils/grog/grog.1 \
+  src/devices/grohtml/grohtml.1 \
+  src/devices/grolbp/grolbp.1 \
+  src/devices/grolj4/grolj4.1 \
+  src/devices/gropdf/gropdf.1 \
+  src/devices/grops/grops.1 \
+  src/devices/grotty/grotty.1 \
+  $(GXDITVIEW_MAN1) \
+  src/utils/hpftodit/hpftodit.1 \
+  src/utils/indxbib/indxbib.1 \
+  src/utils/lkbib/lkbib.1 \
+  src/utils/lookbib/lookbib.1 \
+  contrib/mm/mmroff.1 \
+  src/preproc/eqn/neqn.1 \
+  src/roff/nroff/nroff.1 \
+  src/devices/gropdf/pdfmom.1 \
+  contrib/pdfmark/pdfroff.1 \
+  src/utils/pfbtops/pfbtops.1 \
+  src/preproc/pic/pic.1 \
+  contrib/pic2graph/pic2graph.1 \
+  src/preproc/preconv/preconv.1 \
+  src/preproc/refer/refer.1 \
+  src/preproc/soelim/soelim.1 \
+  src/preproc/tbl/tbl.1 \
+  src/utils/tfmtodit/tfmtodit.1 \
+  src/roff/troff/troff.1 \
+  $(XTOTROFF_MAN1) \
+  man/groff_font.5 \
+  man/groff_out.5 \
+  man/groff_tmac.5 \
+  man/groff.7 \
+  man/groff_char.7 \
+  man/groff_diff.7 \
+  contrib/hdtbl/groff_hdtbl.7 \
+  tmac/groff_man.7 \
+  tmac/groff_man_style.7 \
+  tmac/groff_mdoc.7 \
+  tmac/groff_me.7 \
+  contrib/mm/groff_mm.7
+
+GROFF_MAN_PAGES2 = \
+  contrib/mm/groff_mmse.7
+
+GROFF_MAN_PAGES3 = \
+  contrib/mom/groff_mom.7 \
+  tmac/groff_ms.7 \
+  contrib/rfc1345/groff_rfc1345.7 \
+  tmac/groff_trace.7 \
+  tmac/groff_www.7 \
+  man/roff.7
+
+GROFF_MAN_PAGES_ALL = $(GROFF_MAN_PAGES1) $(GROFF_MAN_PAGES2) \
+  $(GROFF_MAN_PAGES3)
+
+
+# groff Texinfo manual
+#
+# We produce all possible formats by by default and ship them in the
+# distribution archive ('make dist') so that people don't need to have
+# 'makeinfo' or TeX available.
+#
+# The GNU info, plain text, and HTML formats require only 'makeinfo'.
+#
+# DVI and PDF require a working TeX installation.  We can't use
+# Automake's facilities for PDF production because its 'dist' target
+# attempts to generate 'groff.pdf' by invoking 'texi2dvi' without the
+# '-E' option (use 'makeinfo' to expand macros), which is needed to
+# build this file.  'texi2dvi' honors the 'MAKEINFO' environment
+# variable.
+#
+# Were the foregoing not true, we would simply say this:
+#info_TEXINFOS = doc/groff.texi
+#doc_groff_TEXINFOS = doc/fdl.texi
+@USE_TEX_TRUE@GROFF_DVI = doc/groff.dvi
+@USE_TEX_TRUE@GROFF_PDF = doc/groff.pdf
 DEVX100FONTS = \
   font/devX100/DESC \
   font/devX100/TR \
@@ -4722,8 +5123,9 @@
   font/devX100/NBI \
   font/devX100/S
 
-@WITHOUT_X11_FALSE@devX100fontdir = $(fontdir)/devX100
-@WITHOUT_X11_FALSE@devX100font_DATA = $(DEVX100FONTS)
+@WITHOUT_X11_FALSE@devX100_fontdir = $(fontdir)/devX100
+@WITHOUT_X11_FALSE@devX100_font_DATA = $(DEVX100FONTS)
+devX100_fontsrcdir = $(top_srcdir)/font/devX100
 DEVX10012FONTS = \
   font/devX100-12/DESC \
   font/devX100-12/TR \
@@ -4744,8 +5146,9 @@
   font/devX100-12/NBI \
   font/devX100-12/S
 
-@WITHOUT_X11_FALSE@devX10012fontdir = $(fontdir)/devX100-12
-@WITHOUT_X11_FALSE@devX10012font_DATA = $(DEVX10012FONTS)
+@WITHOUT_X11_FALSE@devX100_12_fontdir = $(fontdir)/devX100-12
+@WITHOUT_X11_FALSE@devX100_12_font_DATA = $(DEVX10012FONTS)
+devX100_12_fontsrcdir = $(top_srcdir)/font/devX100-12
 DEVX75FONTS = \
   font/devX75/DESC \
   font/devX75/TR \
@@ -4766,8 +5169,9 @@
   font/devX75/NBI \
   font/devX75/S
 
-@WITHOUT_X11_FALSE@devX75fontdir = $(fontdir)/devX75
-@WITHOUT_X11_FALSE@devX75font_DATA = $(DEVX75FONTS)
+@WITHOUT_X11_FALSE@devX75_fontdir = $(fontdir)/devX75
+@WITHOUT_X11_FALSE@devX75_font_DATA = $(DEVX75FONTS)
+devX75_fontsrcdir = $(top_srcdir)/font/devX75
 DEVX7512FONTS = \
   font/devX75-12/DESC \
   font/devX75-12/TR \
@@ -4788,8 +5192,9 @@
   font/devX75-12/NBI \
   font/devX75-12/S
 
-@WITHOUT_X11_FALSE@devX7512fontdir = $(fontdir)/devX75-12
-@WITHOUT_X11_FALSE@devX7512font_DATA = $(DEVX7512FONTS)
+@WITHOUT_X11_FALSE@devX75_12_fontdir = $(fontdir)/devX75-12
+@WITHOUT_X11_FALSE@devX75_12_font_DATA = $(DEVX7512FONTS)
+devX75_12_fontsrcdir = $(top_srcdir)/font/devX75-12
 devascii_srcdir = $(top_srcdir)/font/devascii
 DEVASCIIFONTS = R I B BI
 DEVASCIIFONTSFILES = \
@@ -4999,13 +5404,21 @@
 devpdffontencdir = $(devpdffontdir)/enc
 devpdffontenc_DATA = font/devpdf/enc/text.enc
 devpdffontmapdir = $(devpdffontdir)/map
-DEVPDFFONTMAP_1 = \
+devpdffontmapdata = \
   font/devpdf/map/dingbats.map \
+  font/devpdf/map/symbol.map \
   font/devpdf/map/symbolchars \
-  font/devpdf/map/textmap
+  font/devpdf/map/text.map
+
+devpdffontmap_DATA = $(devpdffontmapdata)
+font_devpdf_default_test = \
+  $(devpdf_srcdir)/tests/check-default-foundry.sh.in
+
+font_devpdf_urw_test = $(devpdf_srcdir)/tests/check-urw-foundry.sh.in
+font_devpdf_TESTS = \
+  font/devpdf/tests/check-default-foundry.sh \
+  font/devpdf/tests/check-urw-foundry.sh
 
-DEVPDFFONTMAP_2 = font/devpdf/map/symbolmap
-devpdffontmap_DATA = $(DEVPDFFONTMAP_1) $(DEVPDFFONTMAP_2)
 devps_srcdir = $(top_srcdir)/font/devps
 devps_builddir = $(top_builddir)/font/devps
 DEVPSFONTFILES = \
@@ -5047,19 +5460,21 @@
   font/devps/TI \
   font/devps/TR \
   font/devps/EURO \
-  font/devps/freeeuro.pfa \
   font/devps/freeeuro.afm \
+  font/devps/symbolsl.afm \
   font/devps/text.enc \
+  font/devps/zapfdr.afm \
   font/devps/download
 
 DEVPSFONTFILES_GENERATED = \
   font/devps/DESC \
   font/devps/prologue \
+  font/devps/freeeuro.pfa \
   font/devps/zapfdr.pfa \
   font/devps/symbolsl.pfa
 
 devpsfontdir = $(fontdir)/devps
-dist_devpsfont_DATA = $(DEVPSFONTFILES) 
+dist_devpsfont_DATA = $(DEVPSFONTFILES)
 nodist_devpsfont_DATA = $(DEVPSFONTFILES_GENERATED)
 
 # these files will be installed in oldfontdir
@@ -5102,11 +5517,11 @@
 DEVPSGENFILES = \
   font/devps/generate/Makefile \
   font/devps/generate/dingbats.map \
-  font/devps/generate/dingbats.rmap \
-  font/devps/generate/lgreekmap \
+  font/devps/generate/dingbats-reversed.map \
+  font/devps/generate/slanted-symbol.map \
+  font/devps/generate/symbol.map \
   font/devps/generate/symbolchars \
-  font/devps/generate/symbolsl.afm \
-  font/devps/generate/textmap
+  font/devps/generate/text.map
 
 DEVPSGENSCRIPTS = \
   font/devps/generate/afmname \
@@ -5149,57 +5564,32 @@
 
 
 # Build from OBJS
-libgroff_a_SOURCES = \
-  src/libs/libgroff/assert.cpp \
-  src/libs/libgroff/change_lf.cpp \
-  src/libs/libgroff/cmap.cpp \
-  src/libs/libgroff/color.cpp \
-  src/libs/libgroff/cset.cpp\
-  src/libs/libgroff/curtime.cpp \
-  src/libs/libgroff/device.cpp \
-  src/libs/libgroff/errarg.cpp \
-  src/libs/libgroff/error.cpp \
-  src/libs/libgroff/fatal.cpp \
-  src/libs/libgroff/filename.cpp \
-  src/libs/libgroff/font.cpp \
-  src/libs/libgroff/fontfile.cpp \
-  src/libs/libgroff/geometry.cpp \
-  src/libs/libgroff/getopt.c \
-  src/libs/libgroff/getopt1.c \
-  src/libs/libgroff/glyphuni.cpp \
-  src/libs/libgroff/htmlhint.cpp \
-  src/libs/libgroff/hypot.cpp \
-  src/libs/libgroff/iftoa.c \
-  src/libs/libgroff/invalid.cpp \
-  src/libs/libgroff/itoa.c \
-  src/libs/libgroff/lf.cpp \
-  src/libs/libgroff/lineno.cpp \
-  src/libs/libgroff/localcharset.c \
-  src/libs/libgroff/macropath.cpp \
-  src/libs/libgroff/matherr.c \
-  src/libs/libgroff/maxfilename.cpp \
-  src/libs/libgroff/maxpathname.cpp \
-  src/libs/libgroff/mksdir.cpp \
-  src/libs/libgroff/nametoindex.cpp \
-  src/libs/libgroff/new.cpp \
-  src/libs/libgroff/paper.cpp \
-  src/libs/libgroff/prime.cpp \
-  src/libs/libgroff/progname.c \
-  src/libs/libgroff/ptable.cpp \
-  src/libs/libgroff/quotearg.c \
-  src/libs/libgroff/relocate.cpp \
-  src/libs/libgroff/searchpath.cpp \
-  src/libs/libgroff/spawnvp.c \
-  src/libs/libgroff/string.cpp \
-  src/libs/libgroff/strsave.cpp \
-  src/libs/libgroff/symbol.cpp \
-  src/libs/libgroff/tmpfile.cpp \
-  src/libs/libgroff/tmpname.cpp \
-  src/libs/libgroff/unicode.cpp \
-  src/libs/libgroff/uniglyph.cpp \
-  src/libs/libgroff/uniuni.cpp \
-  src/libs/libgroff/relocatable.h
-
+libgroff_a_SOURCES = src/libs/libgroff/assert.cpp \
+	src/libs/libgroff/change_lf.cpp src/libs/libgroff/cmap.cpp \
+	src/libs/libgroff/color.cpp src/libs/libgroff/cset.cpp \
+	src/libs/libgroff/curtime.cpp src/libs/libgroff/device.cpp \
+	src/libs/libgroff/errarg.cpp src/libs/libgroff/error.cpp \
+	src/libs/libgroff/fatal.cpp src/libs/libgroff/filename.cpp \
+	src/libs/libgroff/font.cpp src/libs/libgroff/fontfile.cpp \
+	src/libs/libgroff/geometry.cpp src/libs/libgroff/getopt.c \
+	src/libs/libgroff/getopt1.c src/libs/libgroff/glyphuni.cpp \
+	src/libs/libgroff/htmlhint.cpp src/libs/libgroff/hypot.cpp \
+	src/libs/libgroff/iftoa.c src/libs/libgroff/invalid.cpp \
+	src/libs/libgroff/itoa.c src/libs/libgroff/lf.cpp \
+	src/libs/libgroff/lineno.cpp src/libs/libgroff/localcharset.c \
+	src/libs/libgroff/macropath.cpp src/libs/libgroff/matherr.c \
+	src/libs/libgroff/maxfilename.cpp \
+	src/libs/libgroff/maxpathname.cpp src/libs/libgroff/mksdir.cpp \
+	src/libs/libgroff/nametoindex.cpp src/libs/libgroff/paper.cpp \
+	src/libs/libgroff/prime.cpp src/libs/libgroff/progname.c \
+	src/libs/libgroff/ptable.cpp src/libs/libgroff/quotearg.c \
+	src/libs/libgroff/relocate.cpp \
+	src/libs/libgroff/searchpath.cpp src/libs/libgroff/spawnvp.c \
+	src/libs/libgroff/string.cpp src/libs/libgroff/strsave.cpp \
+	src/libs/libgroff/symbol.cpp src/libs/libgroff/tmpfile.cpp \
+	src/libs/libgroff/tmpname.cpp src/libs/libgroff/unicode.cpp \
+	src/libs/libgroff/uniglyph.cpp src/libs/libgroff/uniuni.cpp \
+	src/libs/libgroff/relocatable.h $(am__append_16)
 nodist_libgroff_a_SOURCES = src/libs/libgroff/version.cpp
 
 # Data for localcharset.c.  Taken from libiconv/libcharset.
@@ -5263,6 +5653,10 @@
   libgroff.a \
   lib/libgnu.a
 
+grotty_TESTS = \
+  src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh \
+  src/devices/grotty/tests/osc8_works.sh
+
 GXDITVIEWSOURCES = \
   src/devices/xditview/device.c \
   src/devices/xditview/draw.c \
@@ -5282,6 +5676,9 @@
   src/devices/xditview/Menu.h \
   src/devices/xditview/Dvi.h
 
+GXDITVIEW_GROFF_VERSION_H = src/devices/xditview/groff_version.h
+@WITHOUT_X11_FALSE@GXDITVIEW_MAN1 = src/devices/xditview/gxditview.1
+@WITHOUT_X11_TRUE@GXDITVIEW_MAN1 = 
 @WITHOUT_X11_FALSE@xditview_srcdir = $(top_srcdir)/src/devices/xditview
 @WITHOUT_X11_FALSE@gxditview_CPPFLAGS = $(AM_CPPFLAGS) $(X_CFLAGS) -Dlint \
 @WITHOUT_X11_FALSE@  -I$(top_builddir)/src/devices/xditview
@@ -5289,7 +5686,10 @@
 @WITHOUT_X11_FALSE@gxditview_LDADD = $(X_LIBS) $(X_PRE_LIBS) -lXaw -lXmu -lXt -lX11 \
 @WITHOUT_X11_FALSE@  $(X_EXTRA_LIBS) $(LIBM) libxutil.a lib/libgnu.a
 
-@WITHOUT_X11_FALSE@XDITVIEW_GENHDRS = src/devices/xditview/GXditview-ad.h
+@WITHOUT_X11_FALSE@XDITVIEW_GENHDRS = \
+@WITHOUT_X11_FALSE@ src/devices/xditview/GXditview-ad.h \
+@WITHOUT_X11_FALSE@ $(GXDITVIEW_GROFF_VERSION_H)
+
 @WITHOUT_X11_FALSE@gxditview_SOURCES = $(GXDITVIEWSOURCES)
 @WITHOUT_X11_FALSE@nodist_gxditview_SOURCES = $(XDITVIEW_GENHDRS)
 eqn_CPPFLAGS = \
@@ -5318,6 +5718,9 @@
   src/preproc/eqn/pbox.h \
   src/preproc/eqn/eqn.h
 
+eqn_TESTS = \
+  src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh
+
 grn_SOURCES = \
   src/preproc/grn/hdb.cpp \
   src/preproc/grn/hpoint.cpp \
@@ -5333,6 +5736,10 @@
   src/preproc/html/pre-html.h \
   src/preproc/html/pushback.h
 
+pic_CPPFLAGS = $(AM_CPPFLAGS) \
+  -I $(top_srcdir)/src/preproc/pic \
+  -I $(top_builddir)/src/preproc/pic
+
 pic_LDADD = libgroff.a $(LIBM) lib/libgnu.a
 pic_SOURCES = \
   src/preproc/pic/pic.ypp \
@@ -5349,13 +5756,15 @@
   src/preproc/pic/output.h \
   src/preproc/pic/object.h
 
-pic_CPPFLAGS = $(AM_CPPFLAGS) \
-  -I $(top_srcdir)/src/preproc/pic \
-  -I $(top_builddir)/src/preproc/pic
+preconv_LDADD = libgroff.a $(LIBM) $(LIBICONV) $(UCHARDET_LIBS) \
+  lib/libgnu.a
 
-preconv_LDADD = libgroff.a $(LIBM) $(LIBICONV) $(UCHARDET_LIBS) lib/libgnu.a
 preconv_SOURCES = src/preproc/preconv/preconv.cpp
 preconv_CPPFLAGS = $(AM_CPPFLAGS) $(UCHARDET_CFLAGS)
+preconv_TESTS = \
+  src/preproc/preconv/tests/do-not-seek-the-unseekable.sh \
+  src/preproc/preconv/tests/smoke-test.sh
+
 refer_CPPFLAGS = $(AM_CPPFLAGS) -I $(top_srcdir)/src/preproc/refer
 refer_LDADD = libbib.a libgroff.a $(LIBM) lib/libgnu.a
 refer_SOURCES = \
@@ -5369,6 +5778,9 @@
   src/preproc/refer/token.h \
   src/preproc/refer/command.h
 
+refer_TESTS = \
+  src/preproc/refer/tests/report-correct-line-numbers.sh
+
 soelim_LDADD = libgroff.a $(LIBM) lib/libgnu.a
 soelim_SOURCES = src/preproc/soelim/soelim.cpp
 tbl_LDADD = libgroff.a $(LIBM) lib/libgnu.a
@@ -5377,6 +5789,26 @@
   src/preproc/tbl/table.cpp \
   src/preproc/tbl/table.h
 
+tbl_TESTS = \
+  src/preproc/tbl/tests/boxes-and-vertical-rules.sh \
+  src/preproc/tbl/tests/check-horizontal-line-length.sh \
+  src/preproc/tbl/tests/check-line-intersections.sh \
+  src/preproc/tbl/tests/check-vertical-line-length.sh \
+  src/preproc/tbl/tests/cooperate-with-nm-request.sh \
+  src/preproc/tbl/tests/count-continued-input-lines.sh \
+  src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh \
+  src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh \
+  src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh \
+  src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh \
+  src/preproc/tbl/tests/expand-region-option-works.sh \
+  src/preproc/tbl/tests/format-time-diagnostics-work.sh \
+  src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh \
+  src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh \
+  src/preproc/tbl/tests/save-and-restore-line-numbering.sh \
+  src/preproc/tbl/tests/save-and-restore-tab-stops.sh \
+  src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh \
+  src/preproc/tbl/tests/x-column-modifier-works.sh
+
 groff_LDADD = \
   libgroff.a \
   lib/libgnu.a \
@@ -5387,19 +5819,46 @@
   src/roff/groff/pipeline.c \
   src/roff/groff/pipeline.h
 
-GROFF_OPTS_OUTPUT = \
-  groff_opts_no_arg.txt \
-  groff_opts_with_arg.txt
-
-groffoptsdir = $(libprogramdir)
-groffopts_DATA = $(GROFF_OPTS_OUTPUT)
-grog_srcdir = $(top_srcdir)/src/roff/grog
-GROG = src/roff/grog/subs.pl
-
-# grog_dir is defined by a m4 macro
-grogdir = $(grog_dir)
-dist_grog_DATA = $(GROG)
+groff_TESTS = \
+  src/roff/groff/tests/ab_works.sh \
+  src/roff/groff/tests/adjustment_works.sh \
+  src/roff/groff/tests/break_zero-length_output_line_sanely.sh \
+  src/roff/groff/tests/device_control_escapes_express_basic_latin.sh \
+  src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh \
+  src/roff/groff/tests/dot-cp_register_works.sh \
+  src/roff/groff/tests/dot-nm_register_works.sh \
+  src/roff/groff/tests/dot-nn_register_works.sh \
+  src/roff/groff/tests/evc_produces_no_output_if_invalid.sh \
+  src/roff/groff/tests/fp_should_not_traverse_directories.sh \
+  src/roff/groff/tests/handle_special_input_code_points.sh \
+  src/roff/groff/tests/html_works_with_grn_and_eqn.sh \
+  src/roff/groff/tests/initialization_is_quiet.sh \
+  src/roff/groff/tests/localization_works.sh \
+  src/roff/groff/tests/msoquiet_works.sh \
+  src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh \
+  src/roff/groff/tests/output_driver_C_and_G_options_work.sh \
+  src/roff/groff/tests/recognize_end_of_sentence.sh \
+  src/roff/groff/tests/regression_savannah_56555.sh \
+  src/roff/groff/tests/regression_savannah_58153.sh \
+  src/roff/groff/tests/regression_savannah_58162.sh \
+  src/roff/groff/tests/regression_savannah_58337.sh \
+  src/roff/groff/tests/regression_savannah_59202.sh \
+  src/roff/groff/tests/smoke-test_html_device.sh \
+  src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh \
+  src/roff/groff/tests/soquiet_works.sh \
+  src/roff/groff/tests/string_case_xform_errors.sh \
+  src/roff/groff/tests/string_case_xform_requests.sh \
+  src/roff/groff/tests/string_case_xform_unicode_escape.sh \
+  src/roff/groff/tests/substring_works.sh \
+  src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh
+
+groff_XFAIL_TESTS = \
+  src/roff/groff/tests/string_case_xform_unicode_escape.sh
+
 nroff_srcdir = $(top_srcdir)/src/roff/nroff
+nroff_TESTS = \
+  src/roff/nroff/tests/verbose_option_works.sh
+
 troff_LDADD = libgroff.a lib/libgnu.a $(LIBM)
 troff_SOURCES = \
   src/roff/troff/dictionary.cpp \
@@ -5431,6 +5890,14 @@
   src/utils/addftinfo/guess.h
 
 afmtodit_srcdir = $(top_srcdir)/src/utils/afmtodit
+grog_srcdir = $(top_srcdir)/src/utils/grog
+grog_TESTS = \
+  src/utils/grog/tests/PF-does-not-start-pic-region.sh \
+  src/utils/grog/tests/avoid-refer-fakeout.sh \
+  src/utils/grog/tests/preserve-groff-options.sh \
+  src/utils/grog/tests/recognize-perl-pod.sh \
+  src/utils/grog/tests/smoke-test.sh
+
 hpftodit_LDADD = libgroff.a $(LIBM) lib/libgnu.a
 hpftodit_SOURCES = \
   src/utils/hpftodit/hpftodit.cpp \
@@ -5453,6 +5920,8 @@
 nodist_EXTRA_pfbtops_SOURCES = src/utils/pfbtops/dummy.cpp
 tfmtodit_SOURCES = src/utils/tfmtodit/tfmtodit.cpp
 tfmtodit_LDADD = libgroff.a $(LIBM) lib/libgnu.a
+@WITHOUT_X11_FALSE@XTOTROFF_MAN1 = src/utils/xtotroff/xtotroff.1
+@WITHOUT_X11_TRUE@XTOTROFF_MAN1 = 
 @WITHOUT_X11_FALSE@xtotroff_SOURCES = src/utils/xtotroff/xtotroff.c
 @WITHOUT_X11_FALSE@XLIBS = $(LIBXUTIL) $(LIBGROFF)
 @WITHOUT_X11_FALSE@xtotroff_LDADD = libxutil.a libgroff.a $(X_LIBS) $(X_PRE_LIBS) \
@@ -5460,49 +5929,33 @@
 
 @WITHOUT_X11_FALSE@xtotroff_CPPFLAGS = $(AM_CPPFLAGS) $(X_CFLAGS)
 
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
-#      Written by James Clark (jjc@jclark.com)
-#      Automake migration by Bertrand Garrigues
-#
-# Latest update: 22 Aug 2015
-#
-# 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 the Free
-# Software Foundation, either version 3 of the License, or (at your
-# option) any later version.
-#
-# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+# Define variable needed only for the targets that regenerate
+# descriptions of X11 core fonts (used in "maintainer mode").
+xtotroff = $(top_builddir)/xtotroff
 tmac_srcdir = $(top_srcdir)/tmac
 tmac_builddir = $(top_builddir)/tmac
 TMACNORMALFILES = \
   tmac/man.tmac \
   tmac/mandoc.tmac \
   tmac/andoc.tmac \
-  tmac/an-old.tmac \
   tmac/an-ext.tmac \
   tmac/ms.tmac \
+  tmac/e.tmac \
   tmac/me.tmac \
+  tmac/doc-old.tmac \
+  tmac/doc.tmac \
   tmac/mdoc.tmac \
   tmac/pic.tmac \
-  tmac/a4.tmac \
   tmac/papersize.tmac \
   tmac/62bit.tmac \
   tmac/ec.tmac \
-  tmac/safer.tmac \
   tmac/trace.tmac \
   tmac/ps.tmac \
   tmac/psold.tmac \
   tmac/pdfpic.tmac \
   tmac/pspic.tmac \
   tmac/psatk.tmac \
+  tmac/ptx.tmac \
   tmac/pdf.tmac \
   tmac/dvi.tmac \
   tmac/tty.tmac \
@@ -5512,7 +5965,6 @@
   tmac/latin5.tmac \
   tmac/latin9.tmac \
   tmac/cp1047.tmac \
-  tmac/unicode.tmac \
   tmac/X.tmac \
   tmac/Xps.tmac \
   tmac/lj4.tmac \
@@ -5530,10 +5982,13 @@
   tmac/troffrc \
   tmac/troffrc-end \
   tmac/trans.tmac \
-  tmac/hyphen.us \
-  tmac/hyphenex.us \
+  tmac/en.tmac \
+  tmac/hyphen.en \
+  tmac/hyphenex.en \
   tmac/fr.tmac \
   tmac/hyphen.fr \
+  tmac/it.tmac \
+  tmac/hyphen.it \
   tmac/sv.tmac \
   tmac/hyphen.sv \
   tmac/de.tmac \
@@ -5546,27 +6001,135 @@
   tmac/ja.tmac \
   tmac/zh.tmac
 
-NORMALFILES = `echo $(TMACNORMALFILES) | sed -e "s|tmac/||g"`
 
-# TMACSTRIPFILES are built from their unstripped version (-u)
-TMACSTRIPFILES = tmac/e.tmac tmac/doc.tmac tmac/doc-old.tmac
+# files installed in tmacdir
+#
+# "s" and "an" are not "NORMAL" because they may use compatibility
+# wrappers; see install_tmac_wrap_hook.
+dist_tmac_DATA = \
+  $(TMACNORMALFILES) \
+  tmac/an.tmac \
+  tmac/s.tmac
 
-# Files installed in tmacdir
-dist_tmac_DATA = $(TMACNORMALFILES) tmac/an.tmac tmac/s.tmac
-nodist_tmac_DATA = $(TMACSTRIPFILES) tmac/www.tmac
+nodist_tmac_DATA = tmac/www.tmac
 TMACMDOCFILES = \
-  tmac/doc-common \
-  tmac/doc-ditroff \
-  tmac/doc-nroff \
-  tmac/doc-syms
+  tmac/mdoc/doc-common \
+  tmac/mdoc/doc-ditroff \
+  tmac/mdoc/doc-nroff \
+  tmac/mdoc/doc-syms
 
-MDOCFILES = `echo $(TMACMDOCFILES) | sed -e "s|tmac/||g"`
 mdocdir = $(tmacdir)/mdoc
 # Files installed in mdocdir
-nodist_mdoc_DATA = $(TMACMDOCFILES)
+dist_mdoc_DATA = $(TMACMDOCFILES)
 
 # Installed in localtmacdir
 dist_localtmac_DATA = tmac/man.local tmac/mdoc.local
+tmac_TESTS = \
+  tmac/tests/an-ext_MR-works.sh \
+  tmac/tests/an-ext_MT-works.sh \
+  tmac/tests/an-ext_UR-works.sh \
+  tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh \
+  tmac/tests/an_CS-register-off.sh \
+  tmac/tests/an_CS-register-on.sh \
+  tmac/tests/an_CS-register-unspecified.sh \
+  tmac/tests/an_CT-register-off.sh \
+  tmac/tests/an_CT-register-on.sh \
+  tmac/tests/an_CT-register-unspecified.sh \
+  tmac/tests/an_FT-bad-value-should-not-trash-titles.sh \
+  tmac/tests/an_HY-register-works.sh \
+  tmac/tests/an_LL-init-sanely.sh \
+  tmac/tests/an_ME-punct-hyphenates.sh \
+  tmac/tests/an_MR-works.sh \
+  tmac/tests/an_MT-body-hyphenates.sh \
+  tmac/tests/an_MT-works.sh \
+  tmac/tests/an_P-register-works.sh \
+  tmac/tests/an_TH-repairs-ad-damage.sh \
+  tmac/tests/an_TH-repairs-hy-damage.sh \
+  tmac/tests/an_TS-adds-no-vertical-space.sh \
+  tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh \
+  tmac/tests/an_UE-breaks-before-long-URIs.sh \
+  tmac/tests/an_UE-punct-hyphenates.sh \
+  tmac/tests/an_UR-body-hyphenates.sh \
+  tmac/tests/an_UR-works.sh \
+  tmac/tests/an_X-register-works.sh \
+  tmac/tests/an_adjust-link-text-correctly.sh \
+  tmac/tests/an_avoid-two-font-denial-of-service.sh \
+  tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh \
+  tmac/tests/an_font-remapping-does-not-affect-titles.sh \
+  tmac/tests/an_handle-degenerate-input-quietly.sh \
+  tmac/tests/an_inner-footer-abbreviation-works.sh \
+  tmac/tests/an_link-macros-work-in-paragraph-tags.sh \
+  tmac/tests/an_link-trailing-text-hugs-previous.sh \
+  tmac/tests/an_no-break-after-short-paragraph-tags.sh \
+  tmac/tests/an_output-footer-when-continuously-rendering.sh \
+  tmac/tests/an_page-footers-present.sh \
+  tmac/tests/an_page-header-has-current-data.sh \
+  tmac/tests/an_reset-hyphenation-correctly.sh \
+  tmac/tests/an_title-abbreviation-works.sh \
+  tmac/tests/an_use-input-traps-correctly.sh \
+  tmac/tests/an_works-with-ec.sh \
+  tmac/tests/andoc_P-register-works.sh \
+  tmac/tests/andoc_check-an-to-doc-transition.sh \
+  tmac/tests/andoc_clear-doc-traps.sh \
+  tmac/tests/andoc_flush-between-packages.sh \
+  tmac/tests/doc_CS-works.sh \
+  tmac/tests/doc_CT-works.sh \
+  tmac/tests/doc_D-places-page-numbers-correctly.sh \
+  tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh \
+  tmac/tests/doc_Mt-works.sh \
+  tmac/tests/doc_Nm-works.sh \
+  tmac/tests/doc_P-register-works.sh \
+  tmac/tests/doc_X-register-works.sh \
+  tmac/tests/doc_accept-mixed-case-section-headings.sh \
+  tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh \
+  tmac/tests/doc_heading-font-remapping-works.sh \
+  tmac/tests/doc_indents-correctly.sh \
+  tmac/tests/doc_output-footer-when-continuously-rendering.sh \
+  tmac/tests/doc_smoke-test.sh \
+  tmac/tests/e_chapter-titles-work.sh \
+  tmac/tests/e_columns-work-on-long-pages.sh \
+  tmac/tests/e_delayed-text-marks-work.sh \
+  tmac/tests/e_footnote-marks-work.sh \
+  tmac/tests/e_footnotes-work-with-columns.sh \
+  tmac/tests/e_ld-works.sh \
+  tmac/tests/e_line-numbering-works.sh \
+  tmac/tests/e_rejects-too-short-page-lengths.sh \
+  tmac/tests/ec_works.sh \
+  tmac/tests/latin2_works.sh \
+  tmac/tests/latin5_works.sh \
+  tmac/tests/latin9_works.sh \
+  tmac/tests/localization-works.sh \
+  tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh \
+  tmac/tests/pdfpic_falls-back-to-PSPIC.sh \
+  tmac/tests/s_IP-indents-using-paragraph-type-size.sh \
+  tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh \
+  tmac/tests/s_PN-works.sh \
+  tmac/tests/s_R-handles-its-arguments.sh \
+  tmac/tests/s_SH-resets-IP-indentation-amount.sh \
+  tmac/tests/s_TC-works-with-percent-in-custom-titles.sh \
+  tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh \
+  tmac/tests/s_honor-MINGW-when-two-columns.sh \
+  tmac/tests/s_mark-column-start-correctly.sh \
+  tmac/tests/s_no-excess-space-around-displays.sh \
+  tmac/tests/s_rejects-too-short-page-lengths.sh
+
+tmac_XFAIL_TESTS = \
+  tmac/tests/an-ext_ME-punct-hyphenates.sh \
+  tmac/tests/an-ext_UE-punct-hyphenates.sh \
+  tmac/tests/an-ext_UE-breaks-before-long-URIs.sh \
+  tmac/tests/e_footnotes-work-with-columns.sh
+
+
+# Check input file for bare m4 keywords.
+M4WORDS = define|divert|include|index|shift|undefine|undivert
+M4CHECK = tmac/groff_man-passed-check-for-m4-keywords-stamp
+
+# Define convenience macros for in-tree documents to depend on.  Don't
+# use these above.
+TMAC_PACKAGE_MAN = tmac/an.tmac tmac/an-ext.tmac
+TMAC_PACKAGE_MDOC = tmac/doc.tmac tmac/mdoc/doc-common \
+  tmac/mdoc/doc-ditroff tmac/mdoc/doc-nroff tmac/mdoc/doc-syms
+
 
 # Suffix rule to build .1, .5 and .7 files from .1.man, .5.man and
 # .7.man files.  The brackets around the @ are used to prevent the
@@ -5592,18 +6155,22 @@
 # because a command substitution is being nested inside yet another
 # invocation of sed.
 #
-# * For this target; no assurances about the good behavior of unusual
+# * For this target, no assurances about the good behavior of unusual
 #   characters in Makefile variables in other aspects of the groff build
 #   are offered.
+#
+# COMPATIBILITY_WRAPPERS is intended only for use in conditional
+# expressions in man pages (to see if the legacy macro package wrappers
+# feature is enabled) and not for expansion as formatted text.
 makevarescape = $(top_srcdir)/makevarescape.sed
 all: $(BUILT_SOURCES)
 	$(MAKE) $(AM_MAKEFLAGS) all-am
 
 .SUFFIXES:
-.SUFFIXES: .roff .in .ps .mom .pdf .me .ms .ps .html .txt .texi .dvi .pdf .xhtml .man .c .cpp .log .o .obj .test .test$(EXEEXT) .trs .ypp
+.SUFFIXES: .roff .in .ps .mom .pdf .me.in .me .man .c .cpp .dvi .html .log .o .obj .pfa .test .test$(EXEEXT) .texi .trs .txt .ypp
 am--refresh: Makefile
 	@:
-$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am $(top_srcdir)/lib/gnulib.mk $(top_srcdir)/arch/mingw/mingw.am $(top_srcdir)/arch/misc/misc.am $(top_srcdir)/contrib/chem/chem.am $(top_srcdir)/contrib/eqn2graph/eqn2graph.am $(top_srcdir)/contrib/gdiffmk/gdiffmk.am $(top_srcdir)/contrib/glilypond/glilypond.am $(top_srcdir)/contrib/gperl/gperl.am $(top_srcdir)/contrib/gpinyin/gpinyin.am $(top_srcdir)/contrib/grap2graph/grap2graph.am $(top_srcdir)/contrib/groff_filenames/groff_filenames.am $(top_srcdir)/contrib/groffer/groffer.am $(top_srcdir)/contrib/hdtbl/hdtbl.am $(top_srcdir)/contrib/mm/mm.am $(top_srcdir)/contrib/mom/mom.am $(top_srcdir)/contrib/pdfmark/pdfmark.am $(top_srcdir)/contrib/pic2graph/pic2graph.am $(top_srcdir)/doc/doc.am $(top_srcdir)/font/devX100/devX100.am $(top_srcdir)/font/devX100-12/devX100-12.am $(top_srcdir)/font/devX75/devX75.am $(top_srcdir)/font/devX75-12/devX75-12.am $(top_srcdir)/font/devascii/devascii.am $(top_srcdir)/font/devcp1047/devcp1047.am $(top_srcdir)/font/devdvi/devdvi.am $(top_srcdir)/font/devhtml/devhtml.am $(top_srcdir)/font/devlatin1/devlatin1.am $(top_srcdir)/font/devlbp/devlbp.am $(top_srcdir)/font/devlj4/devlj4.am $(top_srcdir)/font/devpdf/devpdf.am $(top_srcdir)/font/devps/devps.am $(top_srcdir)/font/devutf8/devutf8.am $(top_srcdir)/font/scripts/scripts.am $(top_srcdir)/man/man.am $(top_srcdir)/src/include/include.am $(top_srcdir)/src/libs/libbib/libbib.am $(top_srcdir)/src/libs/libdriver/libdriver.am $(top_srcdir)/src/libs/libgroff/libgroff.am $(top_srcdir)/src/libs/libxutil/libxutil.am $(top_srcdir)/src/devices/grodvi/grodvi.am $(top_srcdir)/src/devices/grohtml/grohtml.am $(top_srcdir)/src/devices/grolbp/grolbp.am $(top_srcdir)/src/devices/grolj4/grolj4.am $(top_srcdir)/src/devices/gropdf/gropdf.am $(top_srcdir)/src/devices/grops/grops.am $(top_srcdir)/src/devices/grotty/grotty.am $(top_srcdir)/src/devices/xditview/xditview.am $(top_srcdir)/src/preproc/eqn/eqn.am $(top_srcdir)/src/preproc/grn/grn.am $(top_srcdir)/src/preproc/html/html.am $(top_srcdir)/src/preproc/pic/pic.am $(top_srcdir)/src/preproc/preconv/preconv.am $(top_srcdir)/src/preproc/refer/refer.am $(top_srcdir)/src/preproc/soelim/soelim.am $(top_srcdir)/src/preproc/tbl/tbl.am $(top_srcdir)/src/roff/groff/groff.am $(top_srcdir)/src/roff/grog/grog.am $(top_srcdir)/src/roff/nroff/nroff.am $(top_srcdir)/src/roff/troff/troff.am $(top_srcdir)/src/utils/addftinfo/addftinfo.am $(top_srcdir)/src/utils/afmtodit/afmtodit.am $(top_srcdir)/src/utils/hpftodit/hpftodit.am $(top_srcdir)/src/utils/indxbib/indxbib.am $(top_srcdir)/src/utils/lkbib/lkbib.am $(top_srcdir)/src/utils/lookbib/lookbib.am $(top_srcdir)/src/utils/pfbtops/pfbtops.am $(top_srcdir)/src/utils/tfmtodit/tfmtodit.am $(top_srcdir)/src/utils/xtotroff/xtotroff.am $(top_srcdir)/tmac/tmac.am $(am__configure_deps)
+$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am $(top_srcdir)/lib/gnulib.mk $(top_srcdir)/arch/mingw/mingw.am $(top_srcdir)/arch/misc/misc.am $(top_srcdir)/contrib/chem/chem.am $(top_srcdir)/contrib/eqn2graph/eqn2graph.am $(top_srcdir)/contrib/gdiffmk/gdiffmk.am $(top_srcdir)/contrib/glilypond/glilypond.am $(top_srcdir)/contrib/gperl/gperl.am $(top_srcdir)/contrib/gpinyin/gpinyin.am $(top_srcdir)/contrib/grap2graph/grap2graph.am $(top_srcdir)/contrib/hdtbl/hdtbl.am $(top_srcdir)/contrib/mm/mm.am $(top_srcdir)/contrib/mom/mom.am $(top_srcdir)/contrib/pdfmark/pdfmark.am $(top_srcdir)/contrib/pic2graph/pic2graph.am $(top_srcdir)/contrib/rfc1345/rfc1345.am $(top_srcdir)/contrib/sboxes/sboxes.am $(top_srcdir)/doc/doc.am $(top_srcdir)/font/devX100/devX100.am $(top_srcdir)/font/devX100-12/devX100-12.am $(top_srcdir)/font/devX75/devX75.am $(top_srcdir)/font/devX75-12/devX75-12.am $(top_srcdir)/font/devascii/devascii.am $(top_srcdir)/font/devcp1047/devcp1047.am $(top_srcdir)/font/devdvi/devdvi.am $(top_srcdir)/font/devhtml/devhtml.am $(top_srcdir)/font/devlatin1/devlatin1.am $(top_srcdir)/font/devlbp/devlbp.am $(top_srcdir)/font/devlj4/devlj4.am $(top_srcdir)/font/devpdf/devpdf.am $(top_srcdir)/font/devps/devps.am $(top_srcdir)/font/devutf8/devutf8.am $(top_srcdir)/font/scripts/scripts.am $(top_srcdir)/man/man.am $(top_srcdir)/src/include/include.am $(top_srcdir)/src/libs/libbib/libbib.am $(top_srcdir)/src/libs/libdriver/libdriver.am $(top_srcdir)/src/libs/libgroff/libgroff.am $(top_srcdir)/src/libs/libxutil/libxutil.am $(top_srcdir)/src/devices/grodvi/grodvi.am $(top_srcdir)/src/devices/grohtml/grohtml.am $(top_srcdir)/src/devices/grolbp/grolbp.am $(top_srcdir)/src/devices/grolj4/grolj4.am $(top_srcdir)/src/devices/gropdf/gropdf.am $(top_srcdir)/src/devices/grops/grops.am $(top_srcdir)/src/devices/grotty/grotty.am $(top_srcdir)/src/devices/xditview/xditview.am $(top_srcdir)/src/preproc/eqn/eqn.am $(top_srcdir)/src/preproc/grn/grn.am $(top_srcdir)/src/preproc/html/html.am $(top_srcdir)/src/preproc/pic/pic.am $(top_srcdir)/src/preproc/preconv/preconv.am $(top_srcdir)/src/preproc/refer/refer.am $(top_srcdir)/src/preproc/soelim/soelim.am $(top_srcdir)/src/preproc/tbl/tbl.am $(top_srcdir)/src/roff/groff/groff.am $(top_srcdir)/src/roff/nroff/nroff.am $(top_srcdir)/src/roff/troff/troff.am $(top_srcdir)/src/utils/addftinfo/addftinfo.am $(top_srcdir)/src/utils/afmtodit/afmtodit.am $(top_srcdir)/src/utils/grog/grog.am $(top_srcdir)/src/utils/hpftodit/hpftodit.am $(top_srcdir)/src/utils/indxbib/indxbib.am $(top_srcdir)/src/utils/lkbib/lkbib.am $(top_srcdir)/src/utils/lookbib/lookbib.am $(top_srcdir)/src/utils/pfbtops/pfbtops.am $(top_srcdir)/src/utils/tfmtodit/tfmtodit.am $(top_srcdir)/src/utils/xtotroff/xtotroff.am $(top_srcdir)/tmac/tmac.am $(am__configure_deps)
 	@for dep in $?; do \
 	  case '$(am__configure_deps)' in \
 	    *$$dep*) \
@@ -5625,7 +6192,7 @@
 	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__maybe_remake_depfiles)'; \
 	    cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__maybe_remake_depfiles);; \
 	esac;
-$(top_srcdir)/lib/gnulib.mk $(top_srcdir)/arch/mingw/mingw.am $(top_srcdir)/arch/misc/misc.am $(top_srcdir)/contrib/chem/chem.am $(top_srcdir)/contrib/eqn2graph/eqn2graph.am $(top_srcdir)/contrib/gdiffmk/gdiffmk.am $(top_srcdir)/contrib/glilypond/glilypond.am $(top_srcdir)/contrib/gperl/gperl.am $(top_srcdir)/contrib/gpinyin/gpinyin.am $(top_srcdir)/contrib/grap2graph/grap2graph.am $(top_srcdir)/contrib/groff_filenames/groff_filenames.am $(top_srcdir)/contrib/groffer/groffer.am $(top_srcdir)/contrib/hdtbl/hdtbl.am $(top_srcdir)/contrib/mm/mm.am $(top_srcdir)/contrib/mom/mom.am $(top_srcdir)/contrib/pdfmark/pdfmark.am $(top_srcdir)/contrib/pic2graph/pic2graph.am $(top_srcdir)/doc/doc.am $(top_srcdir)/font/devX100/devX100.am $(top_srcdir)/font/devX100-12/devX100-12.am $(top_srcdir)/font/devX75/devX75.am $(top_srcdir)/font/devX75-12/devX75-12.am $(top_srcdir)/font/devascii/devascii.am $(top_srcdir)/font/devcp1047/devcp1047.am $(top_srcdir)/font/devdvi/devdvi.am $(top_srcdir)/font/devhtml/devhtml.am $(top_srcdir)/font/devlatin1/devlatin1.am $(top_srcdir)/font/devlbp/devlbp.am $(top_srcdir)/font/devlj4/devlj4.am $(top_srcdir)/font/devpdf/devpdf.am $(top_srcdir)/font/devps/devps.am $(top_srcdir)/font/devutf8/devutf8.am $(top_srcdir)/font/scripts/scripts.am $(top_srcdir)/man/man.am $(top_srcdir)/src/include/include.am $(top_srcdir)/src/libs/libbib/libbib.am $(top_srcdir)/src/libs/libdriver/libdriver.am $(top_srcdir)/src/libs/libgroff/libgroff.am $(top_srcdir)/src/libs/libxutil/libxutil.am $(top_srcdir)/src/devices/grodvi/grodvi.am $(top_srcdir)/src/devices/grohtml/grohtml.am $(top_srcdir)/src/devices/grolbp/grolbp.am $(top_srcdir)/src/devices/grolj4/grolj4.am $(top_srcdir)/src/devices/gropdf/gropdf.am $(top_srcdir)/src/devices/grops/grops.am $(top_srcdir)/src/devices/grotty/grotty.am $(top_srcdir)/src/devices/xditview/xditview.am $(top_srcdir)/src/preproc/eqn/eqn.am $(top_srcdir)/src/preproc/grn/grn.am $(top_srcdir)/src/preproc/html/html.am $(top_srcdir)/src/preproc/pic/pic.am $(top_srcdir)/src/preproc/preconv/preconv.am $(top_srcdir)/src/preproc/refer/refer.am $(top_srcdir)/src/preproc/soelim/soelim.am $(top_srcdir)/src/preproc/tbl/tbl.am $(top_srcdir)/src/roff/groff/groff.am $(top_srcdir)/src/roff/grog/grog.am $(top_srcdir)/src/roff/nroff/nroff.am $(top_srcdir)/src/roff/troff/troff.am $(top_srcdir)/src/utils/addftinfo/addftinfo.am $(top_srcdir)/src/utils/afmtodit/afmtodit.am $(top_srcdir)/src/utils/hpftodit/hpftodit.am $(top_srcdir)/src/utils/indxbib/indxbib.am $(top_srcdir)/src/utils/lkbib/lkbib.am $(top_srcdir)/src/utils/lookbib/lookbib.am $(top_srcdir)/src/utils/pfbtops/pfbtops.am $(top_srcdir)/src/utils/tfmtodit/tfmtodit.am $(top_srcdir)/src/utils/xtotroff/xtotroff.am $(top_srcdir)/tmac/tmac.am $(am__empty):
+$(top_srcdir)/lib/gnulib.mk $(top_srcdir)/arch/mingw/mingw.am $(top_srcdir)/arch/misc/misc.am $(top_srcdir)/contrib/chem/chem.am $(top_srcdir)/contrib/eqn2graph/eqn2graph.am $(top_srcdir)/contrib/gdiffmk/gdiffmk.am $(top_srcdir)/contrib/glilypond/glilypond.am $(top_srcdir)/contrib/gperl/gperl.am $(top_srcdir)/contrib/gpinyin/gpinyin.am $(top_srcdir)/contrib/grap2graph/grap2graph.am $(top_srcdir)/contrib/hdtbl/hdtbl.am $(top_srcdir)/contrib/mm/mm.am $(top_srcdir)/contrib/mom/mom.am $(top_srcdir)/contrib/pdfmark/pdfmark.am $(top_srcdir)/contrib/pic2graph/pic2graph.am $(top_srcdir)/contrib/rfc1345/rfc1345.am $(top_srcdir)/contrib/sboxes/sboxes.am $(top_srcdir)/doc/doc.am $(top_srcdir)/font/devX100/devX100.am $(top_srcdir)/font/devX100-12/devX100-12.am $(top_srcdir)/font/devX75/devX75.am $(top_srcdir)/font/devX75-12/devX75-12.am $(top_srcdir)/font/devascii/devascii.am $(top_srcdir)/font/devcp1047/devcp1047.am $(top_srcdir)/font/devdvi/devdvi.am $(top_srcdir)/font/devhtml/devhtml.am $(top_srcdir)/font/devlatin1/devlatin1.am $(top_srcdir)/font/devlbp/devlbp.am $(top_srcdir)/font/devlj4/devlj4.am $(top_srcdir)/font/devpdf/devpdf.am $(top_srcdir)/font/devps/devps.am $(top_srcdir)/font/devutf8/devutf8.am $(top_srcdir)/font/scripts/scripts.am $(top_srcdir)/man/man.am $(top_srcdir)/src/include/include.am $(top_srcdir)/src/libs/libbib/libbib.am $(top_srcdir)/src/libs/libdriver/libdriver.am $(top_srcdir)/src/libs/libgroff/libgroff.am $(top_srcdir)/src/libs/libxutil/libxutil.am $(top_srcdir)/src/devices/grodvi/grodvi.am $(top_srcdir)/src/devices/grohtml/grohtml.am $(top_srcdir)/src/devices/grolbp/grolbp.am $(top_srcdir)/src/devices/grolj4/grolj4.am $(top_srcdir)/src/devices/gropdf/gropdf.am $(top_srcdir)/src/devices/grops/grops.am $(top_srcdir)/src/devices/grotty/grotty.am $(top_srcdir)/src/devices/xditview/xditview.am $(top_srcdir)/src/preproc/eqn/eqn.am $(top_srcdir)/src/preproc/grn/grn.am $(top_srcdir)/src/preproc/html/html.am $(top_srcdir)/src/preproc/pic/pic.am $(top_srcdir)/src/preproc/preconv/preconv.am $(top_srcdir)/src/preproc/refer/refer.am $(top_srcdir)/src/preproc/soelim/soelim.am $(top_srcdir)/src/preproc/tbl/tbl.am $(top_srcdir)/src/roff/groff/groff.am $(top_srcdir)/src/roff/nroff/nroff.am $(top_srcdir)/src/roff/troff/troff.am $(top_srcdir)/src/utils/addftinfo/addftinfo.am $(top_srcdir)/src/utils/afmtodit/afmtodit.am $(top_srcdir)/src/utils/grog/grog.am $(top_srcdir)/src/utils/hpftodit/hpftodit.am $(top_srcdir)/src/utils/indxbib/indxbib.am $(top_srcdir)/src/utils/lkbib/lkbib.am $(top_srcdir)/src/utils/lookbib/lookbib.am $(top_srcdir)/src/utils/pfbtops/pfbtops.am $(top_srcdir)/src/utils/tfmtodit/tfmtodit.am $(top_srcdir)/src/utils/xtotroff/xtotroff.am $(top_srcdir)/tmac/tmac.am $(am__empty):
 
 $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
 	$(SHELL) ./config.status --recheck
@@ -5796,12 +6363,35 @@
 lib/$(DEPDIR)/$(am__dirstamp):
 	@$(MKDIR_P) lib/$(DEPDIR)
 	@: > lib/$(DEPDIR)/$(am__dirstamp)
-lib/localcharset.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-float.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-itold.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-free.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-fseterr.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-localcharset.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-math.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-memchr.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-printf-frexp.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/math.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/printf-frexp.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-printf-frexpl.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/printf-frexpl.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-signbitf.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-signbitd.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-signbitl.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-stdio-read.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-stdio-write.$(OBJEXT): lib/$(am__dirstamp) \
+	lib/$(DEPDIR)/$(am__dirstamp)
+lib/libgnu_a-unistd.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
 lib/uniwidth/$(am__dirstamp):
 	@$(MKDIR_P) lib/uniwidth
@@ -5809,48 +6399,39 @@
 lib/uniwidth/$(DEPDIR)/$(am__dirstamp):
 	@$(MKDIR_P) lib/uniwidth/$(DEPDIR)
 	@: > lib/uniwidth/$(DEPDIR)/$(am__dirstamp)
-lib/uniwidth/width.$(OBJEXT): lib/uniwidth/$(am__dirstamp) \
+lib/uniwidth/libgnu_a-width.$(OBJEXT): lib/uniwidth/$(am__dirstamp) \
 	lib/uniwidth/$(DEPDIR)/$(am__dirstamp)
-lib/wctype-h.$(OBJEXT): lib/$(am__dirstamp) \
-	lib/$(DEPDIR)/$(am__dirstamp)
-lib/xsize.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/float.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/itold.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/fprintf.$(OBJEXT): lib/$(am__dirstamp) \
-	lib/$(DEPDIR)/$(am__dirstamp)
-lib/frexp.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/frexpl.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-wctype-h.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/fseterr.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-wcwidth.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/isnan.$(OBJEXT): lib/$(am__dirstamp) lib/$(DEPDIR)/$(am__dirstamp)
-lib/isnand.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-xsize.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/isnanf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-fprintf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/isnanl.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-frexp.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/memchr.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-frexpl.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/signbitd.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-isnan.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/signbitf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-isnand.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/signbitl.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-isnanf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/snprintf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-isnanl.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/asnprintf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-snprintf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/printf-args.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-asnprintf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/printf-parse.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-printf-args.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/vasnprintf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-printf-parse.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/vsnprintf.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-vasnprintf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
-lib/wcwidth.$(OBJEXT): lib/$(am__dirstamp) \
+lib/libgnu_a-vsnprintf.$(OBJEXT): lib/$(am__dirstamp) \
 	lib/$(DEPDIR)/$(am__dirstamp)
 
 lib/libgnu.a: $(lib_libgnu_a_OBJECTS) $(lib_libgnu_a_DEPENDENCIES) $(EXTRA_lib_libgnu_a_DEPENDENCIES) lib/$(am__dirstamp)
@@ -5994,9 +6575,6 @@
 src/libs/libgroff/libgroff_a-nametoindex.$(OBJEXT):  \
 	src/libs/libgroff/$(am__dirstamp) \
 	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
-src/libs/libgroff/libgroff_a-new.$(OBJEXT):  \
-	src/libs/libgroff/$(am__dirstamp) \
-	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
 src/libs/libgroff/libgroff_a-paper.$(OBJEXT):  \
 	src/libs/libgroff/$(am__dirstamp) \
 	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
@@ -6045,6 +6623,9 @@
 src/libs/libgroff/libgroff_a-uniuni.$(OBJEXT):  \
 	src/libs/libgroff/$(am__dirstamp) \
 	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
+src/libs/libgroff/libgroff_a-new.$(OBJEXT):  \
+	src/libs/libgroff/$(am__dirstamp) \
+	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
 src/libs/libgroff/libgroff_a-version.$(OBJEXT):  \
 	src/libs/libgroff/$(am__dirstamp) \
 	src/libs/libgroff/$(DEPDIR)/$(am__dirstamp)
@@ -6660,34 +7241,38 @@
 distclean-compile:
 	-rm -f *.tab.c
 
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/asnprintf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/float.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/fprintf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/frexp.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/frexpl.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/fseterr.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/isnan.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/isnand.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/isnanf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/isnanl.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/itold.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/localcharset.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/math.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/memchr.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/printf-args.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/printf-frexp.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/printf-frexpl.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/printf-parse.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/signbitd.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/signbitf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/signbitl.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/snprintf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/vasnprintf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/vsnprintf.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/wctype-h.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/wcwidth.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/xsize.Po@am__quote@ # am--include-marker
-@AMDEP_TRUE@@am__include@ @am__quote@lib/uniwidth/$(DEPDIR)/width.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-asnprintf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-float.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-fprintf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-free.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-frexp.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-frexpl.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-fseterr.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-isnan.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-isnand.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-isnanf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-isnanl.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-itold.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-localcharset.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-math.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-memchr.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-printf-args.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-printf-frexp.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-printf-parse.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-signbitd.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-signbitf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-signbitl.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-snprintf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-stdio-read.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-stdio-write.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-unistd.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-vasnprintf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-vsnprintf.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-wctype-h.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-wcwidth.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/$(DEPDIR)/libgnu_a-xsize.Po@am__quote@ # am--include-marker
+@AMDEP_TRUE@@am__include@ @am__quote@lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po@am__quote@ # am--include-marker
 @AMDEP_TRUE@@am__include@ @am__quote@src/devices/grodvi/$(DEPDIR)/dvi.Po@am__quote@ # am--include-marker
 @AMDEP_TRUE@@am__include@ @am__quote@src/devices/grohtml/$(DEPDIR)/html-table.Po@am__quote@ # am--include-marker
 @AMDEP_TRUE@@am__include@ @am__quote@src/devices/grohtml/$(DEPDIR)/html-text.Po@am__quote@ # am--include-marker
@@ -6848,6 +7433,454 @@
 @AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
 @am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(COMPILE) -c -o $@ `$(CYGPATH_W) '$<'`
 
+lib/libgnu_a-float.o: lib/float.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-float.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-float.Tpo -c -o lib/libgnu_a-float.o `test -f 'lib/float.c' || echo '$(srcdir)/'`lib/float.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-float.Tpo lib/$(DEPDIR)/libgnu_a-float.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/float.c' object='lib/libgnu_a-float.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-float.o `test -f 'lib/float.c' || echo '$(srcdir)/'`lib/float.c
+
+lib/libgnu_a-float.obj: lib/float.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-float.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-float.Tpo -c -o lib/libgnu_a-float.obj `if test -f 'lib/float.c'; then $(CYGPATH_W) 'lib/float.c'; else $(CYGPATH_W) '$(srcdir)/lib/float.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-float.Tpo lib/$(DEPDIR)/libgnu_a-float.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/float.c' object='lib/libgnu_a-float.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-float.obj `if test -f 'lib/float.c'; then $(CYGPATH_W) 'lib/float.c'; else $(CYGPATH_W) '$(srcdir)/lib/float.c'; fi`
+
+lib/libgnu_a-itold.o: lib/itold.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-itold.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-itold.Tpo -c -o lib/libgnu_a-itold.o `test -f 'lib/itold.c' || echo '$(srcdir)/'`lib/itold.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-itold.Tpo lib/$(DEPDIR)/libgnu_a-itold.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/itold.c' object='lib/libgnu_a-itold.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-itold.o `test -f 'lib/itold.c' || echo '$(srcdir)/'`lib/itold.c
+
+lib/libgnu_a-itold.obj: lib/itold.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-itold.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-itold.Tpo -c -o lib/libgnu_a-itold.obj `if test -f 'lib/itold.c'; then $(CYGPATH_W) 'lib/itold.c'; else $(CYGPATH_W) '$(srcdir)/lib/itold.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-itold.Tpo lib/$(DEPDIR)/libgnu_a-itold.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/itold.c' object='lib/libgnu_a-itold.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-itold.obj `if test -f 'lib/itold.c'; then $(CYGPATH_W) 'lib/itold.c'; else $(CYGPATH_W) '$(srcdir)/lib/itold.c'; fi`
+
+lib/libgnu_a-free.o: lib/free.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-free.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-free.Tpo -c -o lib/libgnu_a-free.o `test -f 'lib/free.c' || echo '$(srcdir)/'`lib/free.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-free.Tpo lib/$(DEPDIR)/libgnu_a-free.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/free.c' object='lib/libgnu_a-free.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-free.o `test -f 'lib/free.c' || echo '$(srcdir)/'`lib/free.c
+
+lib/libgnu_a-free.obj: lib/free.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-free.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-free.Tpo -c -o lib/libgnu_a-free.obj `if test -f 'lib/free.c'; then $(CYGPATH_W) 'lib/free.c'; else $(CYGPATH_W) '$(srcdir)/lib/free.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-free.Tpo lib/$(DEPDIR)/libgnu_a-free.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/free.c' object='lib/libgnu_a-free.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-free.obj `if test -f 'lib/free.c'; then $(CYGPATH_W) 'lib/free.c'; else $(CYGPATH_W) '$(srcdir)/lib/free.c'; fi`
+
+lib/libgnu_a-fseterr.o: lib/fseterr.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-fseterr.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-fseterr.Tpo -c -o lib/libgnu_a-fseterr.o `test -f 'lib/fseterr.c' || echo '$(srcdir)/'`lib/fseterr.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-fseterr.Tpo lib/$(DEPDIR)/libgnu_a-fseterr.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/fseterr.c' object='lib/libgnu_a-fseterr.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-fseterr.o `test -f 'lib/fseterr.c' || echo '$(srcdir)/'`lib/fseterr.c
+
+lib/libgnu_a-fseterr.obj: lib/fseterr.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-fseterr.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-fseterr.Tpo -c -o lib/libgnu_a-fseterr.obj `if test -f 'lib/fseterr.c'; then $(CYGPATH_W) 'lib/fseterr.c'; else $(CYGPATH_W) '$(srcdir)/lib/fseterr.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-fseterr.Tpo lib/$(DEPDIR)/libgnu_a-fseterr.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/fseterr.c' object='lib/libgnu_a-fseterr.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-fseterr.obj `if test -f 'lib/fseterr.c'; then $(CYGPATH_W) 'lib/fseterr.c'; else $(CYGPATH_W) '$(srcdir)/lib/fseterr.c'; fi`
+
+lib/libgnu_a-localcharset.o: lib/localcharset.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-localcharset.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-localcharset.Tpo -c -o lib/libgnu_a-localcharset.o `test -f 'lib/localcharset.c' || echo '$(srcdir)/'`lib/localcharset.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-localcharset.Tpo lib/$(DEPDIR)/libgnu_a-localcharset.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/localcharset.c' object='lib/libgnu_a-localcharset.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-localcharset.o `test -f 'lib/localcharset.c' || echo '$(srcdir)/'`lib/localcharset.c
+
+lib/libgnu_a-localcharset.obj: lib/localcharset.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-localcharset.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-localcharset.Tpo -c -o lib/libgnu_a-localcharset.obj `if test -f 'lib/localcharset.c'; then $(CYGPATH_W) 'lib/localcharset.c'; else $(CYGPATH_W) '$(srcdir)/lib/localcharset.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-localcharset.Tpo lib/$(DEPDIR)/libgnu_a-localcharset.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/localcharset.c' object='lib/libgnu_a-localcharset.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-localcharset.obj `if test -f 'lib/localcharset.c'; then $(CYGPATH_W) 'lib/localcharset.c'; else $(CYGPATH_W) '$(srcdir)/lib/localcharset.c'; fi`
+
+lib/libgnu_a-math.o: lib/math.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-math.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-math.Tpo -c -o lib/libgnu_a-math.o `test -f 'lib/math.c' || echo '$(srcdir)/'`lib/math.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-math.Tpo lib/$(DEPDIR)/libgnu_a-math.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/math.c' object='lib/libgnu_a-math.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-math.o `test -f 'lib/math.c' || echo '$(srcdir)/'`lib/math.c
+
+lib/libgnu_a-math.obj: lib/math.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-math.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-math.Tpo -c -o lib/libgnu_a-math.obj `if test -f 'lib/math.c'; then $(CYGPATH_W) 'lib/math.c'; else $(CYGPATH_W) '$(srcdir)/lib/math.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-math.Tpo lib/$(DEPDIR)/libgnu_a-math.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/math.c' object='lib/libgnu_a-math.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-math.obj `if test -f 'lib/math.c'; then $(CYGPATH_W) 'lib/math.c'; else $(CYGPATH_W) '$(srcdir)/lib/math.c'; fi`
+
+lib/libgnu_a-memchr.o: lib/memchr.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-memchr.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-memchr.Tpo -c -o lib/libgnu_a-memchr.o `test -f 'lib/memchr.c' || echo '$(srcdir)/'`lib/memchr.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-memchr.Tpo lib/$(DEPDIR)/libgnu_a-memchr.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/memchr.c' object='lib/libgnu_a-memchr.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-memchr.o `test -f 'lib/memchr.c' || echo '$(srcdir)/'`lib/memchr.c
+
+lib/libgnu_a-memchr.obj: lib/memchr.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-memchr.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-memchr.Tpo -c -o lib/libgnu_a-memchr.obj `if test -f 'lib/memchr.c'; then $(CYGPATH_W) 'lib/memchr.c'; else $(CYGPATH_W) '$(srcdir)/lib/memchr.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-memchr.Tpo lib/$(DEPDIR)/libgnu_a-memchr.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/memchr.c' object='lib/libgnu_a-memchr.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-memchr.obj `if test -f 'lib/memchr.c'; then $(CYGPATH_W) 'lib/memchr.c'; else $(CYGPATH_W) '$(srcdir)/lib/memchr.c'; fi`
+
+lib/libgnu_a-printf-frexp.o: lib/printf-frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-frexp.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-frexp.Tpo -c -o lib/libgnu_a-printf-frexp.o `test -f 'lib/printf-frexp.c' || echo '$(srcdir)/'`lib/printf-frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-frexp.Tpo lib/$(DEPDIR)/libgnu_a-printf-frexp.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-frexp.c' object='lib/libgnu_a-printf-frexp.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-frexp.o `test -f 'lib/printf-frexp.c' || echo '$(srcdir)/'`lib/printf-frexp.c
+
+lib/libgnu_a-printf-frexp.obj: lib/printf-frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-frexp.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-frexp.Tpo -c -o lib/libgnu_a-printf-frexp.obj `if test -f 'lib/printf-frexp.c'; then $(CYGPATH_W) 'lib/printf-frexp.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-frexp.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-frexp.Tpo lib/$(DEPDIR)/libgnu_a-printf-frexp.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-frexp.c' object='lib/libgnu_a-printf-frexp.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-frexp.obj `if test -f 'lib/printf-frexp.c'; then $(CYGPATH_W) 'lib/printf-frexp.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-frexp.c'; fi`
+
+lib/libgnu_a-printf-frexpl.o: lib/printf-frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-frexpl.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-frexpl.Tpo -c -o lib/libgnu_a-printf-frexpl.o `test -f 'lib/printf-frexpl.c' || echo '$(srcdir)/'`lib/printf-frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-frexpl.Tpo lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-frexpl.c' object='lib/libgnu_a-printf-frexpl.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-frexpl.o `test -f 'lib/printf-frexpl.c' || echo '$(srcdir)/'`lib/printf-frexpl.c
+
+lib/libgnu_a-printf-frexpl.obj: lib/printf-frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-frexpl.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-frexpl.Tpo -c -o lib/libgnu_a-printf-frexpl.obj `if test -f 'lib/printf-frexpl.c'; then $(CYGPATH_W) 'lib/printf-frexpl.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-frexpl.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-frexpl.Tpo lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-frexpl.c' object='lib/libgnu_a-printf-frexpl.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-frexpl.obj `if test -f 'lib/printf-frexpl.c'; then $(CYGPATH_W) 'lib/printf-frexpl.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-frexpl.c'; fi`
+
+lib/libgnu_a-signbitf.o: lib/signbitf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitf.Tpo -c -o lib/libgnu_a-signbitf.o `test -f 'lib/signbitf.c' || echo '$(srcdir)/'`lib/signbitf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitf.Tpo lib/$(DEPDIR)/libgnu_a-signbitf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitf.c' object='lib/libgnu_a-signbitf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitf.o `test -f 'lib/signbitf.c' || echo '$(srcdir)/'`lib/signbitf.c
+
+lib/libgnu_a-signbitf.obj: lib/signbitf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitf.Tpo -c -o lib/libgnu_a-signbitf.obj `if test -f 'lib/signbitf.c'; then $(CYGPATH_W) 'lib/signbitf.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitf.Tpo lib/$(DEPDIR)/libgnu_a-signbitf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitf.c' object='lib/libgnu_a-signbitf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitf.obj `if test -f 'lib/signbitf.c'; then $(CYGPATH_W) 'lib/signbitf.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitf.c'; fi`
+
+lib/libgnu_a-signbitd.o: lib/signbitd.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitd.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitd.Tpo -c -o lib/libgnu_a-signbitd.o `test -f 'lib/signbitd.c' || echo '$(srcdir)/'`lib/signbitd.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitd.Tpo lib/$(DEPDIR)/libgnu_a-signbitd.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitd.c' object='lib/libgnu_a-signbitd.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitd.o `test -f 'lib/signbitd.c' || echo '$(srcdir)/'`lib/signbitd.c
+
+lib/libgnu_a-signbitd.obj: lib/signbitd.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitd.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitd.Tpo -c -o lib/libgnu_a-signbitd.obj `if test -f 'lib/signbitd.c'; then $(CYGPATH_W) 'lib/signbitd.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitd.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitd.Tpo lib/$(DEPDIR)/libgnu_a-signbitd.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitd.c' object='lib/libgnu_a-signbitd.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitd.obj `if test -f 'lib/signbitd.c'; then $(CYGPATH_W) 'lib/signbitd.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitd.c'; fi`
+
+lib/libgnu_a-signbitl.o: lib/signbitl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitl.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitl.Tpo -c -o lib/libgnu_a-signbitl.o `test -f 'lib/signbitl.c' || echo '$(srcdir)/'`lib/signbitl.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitl.Tpo lib/$(DEPDIR)/libgnu_a-signbitl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitl.c' object='lib/libgnu_a-signbitl.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitl.o `test -f 'lib/signbitl.c' || echo '$(srcdir)/'`lib/signbitl.c
+
+lib/libgnu_a-signbitl.obj: lib/signbitl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-signbitl.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-signbitl.Tpo -c -o lib/libgnu_a-signbitl.obj `if test -f 'lib/signbitl.c'; then $(CYGPATH_W) 'lib/signbitl.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitl.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-signbitl.Tpo lib/$(DEPDIR)/libgnu_a-signbitl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/signbitl.c' object='lib/libgnu_a-signbitl.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-signbitl.obj `if test -f 'lib/signbitl.c'; then $(CYGPATH_W) 'lib/signbitl.c'; else $(CYGPATH_W) '$(srcdir)/lib/signbitl.c'; fi`
+
+lib/libgnu_a-stdio-read.o: lib/stdio-read.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-stdio-read.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-stdio-read.Tpo -c -o lib/libgnu_a-stdio-read.o `test -f 'lib/stdio-read.c' || echo '$(srcdir)/'`lib/stdio-read.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-stdio-read.Tpo lib/$(DEPDIR)/libgnu_a-stdio-read.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/stdio-read.c' object='lib/libgnu_a-stdio-read.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-stdio-read.o `test -f 'lib/stdio-read.c' || echo '$(srcdir)/'`lib/stdio-read.c
+
+lib/libgnu_a-stdio-read.obj: lib/stdio-read.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-stdio-read.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-stdio-read.Tpo -c -o lib/libgnu_a-stdio-read.obj `if test -f 'lib/stdio-read.c'; then $(CYGPATH_W) 'lib/stdio-read.c'; else $(CYGPATH_W) '$(srcdir)/lib/stdio-read.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-stdio-read.Tpo lib/$(DEPDIR)/libgnu_a-stdio-read.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/stdio-read.c' object='lib/libgnu_a-stdio-read.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-stdio-read.obj `if test -f 'lib/stdio-read.c'; then $(CYGPATH_W) 'lib/stdio-read.c'; else $(CYGPATH_W) '$(srcdir)/lib/stdio-read.c'; fi`
+
+lib/libgnu_a-stdio-write.o: lib/stdio-write.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-stdio-write.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-stdio-write.Tpo -c -o lib/libgnu_a-stdio-write.o `test -f 'lib/stdio-write.c' || echo '$(srcdir)/'`lib/stdio-write.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-stdio-write.Tpo lib/$(DEPDIR)/libgnu_a-stdio-write.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/stdio-write.c' object='lib/libgnu_a-stdio-write.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-stdio-write.o `test -f 'lib/stdio-write.c' || echo '$(srcdir)/'`lib/stdio-write.c
+
+lib/libgnu_a-stdio-write.obj: lib/stdio-write.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-stdio-write.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-stdio-write.Tpo -c -o lib/libgnu_a-stdio-write.obj `if test -f 'lib/stdio-write.c'; then $(CYGPATH_W) 'lib/stdio-write.c'; else $(CYGPATH_W) '$(srcdir)/lib/stdio-write.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-stdio-write.Tpo lib/$(DEPDIR)/libgnu_a-stdio-write.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/stdio-write.c' object='lib/libgnu_a-stdio-write.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-stdio-write.obj `if test -f 'lib/stdio-write.c'; then $(CYGPATH_W) 'lib/stdio-write.c'; else $(CYGPATH_W) '$(srcdir)/lib/stdio-write.c'; fi`
+
+lib/libgnu_a-unistd.o: lib/unistd.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-unistd.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-unistd.Tpo -c -o lib/libgnu_a-unistd.o `test -f 'lib/unistd.c' || echo '$(srcdir)/'`lib/unistd.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-unistd.Tpo lib/$(DEPDIR)/libgnu_a-unistd.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/unistd.c' object='lib/libgnu_a-unistd.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-unistd.o `test -f 'lib/unistd.c' || echo '$(srcdir)/'`lib/unistd.c
+
+lib/libgnu_a-unistd.obj: lib/unistd.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-unistd.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-unistd.Tpo -c -o lib/libgnu_a-unistd.obj `if test -f 'lib/unistd.c'; then $(CYGPATH_W) 'lib/unistd.c'; else $(CYGPATH_W) '$(srcdir)/lib/unistd.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-unistd.Tpo lib/$(DEPDIR)/libgnu_a-unistd.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/unistd.c' object='lib/libgnu_a-unistd.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-unistd.obj `if test -f 'lib/unistd.c'; then $(CYGPATH_W) 'lib/unistd.c'; else $(CYGPATH_W) '$(srcdir)/lib/unistd.c'; fi`
+
+lib/uniwidth/libgnu_a-width.o: lib/uniwidth/width.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/uniwidth/libgnu_a-width.o -MD -MP -MF lib/uniwidth/$(DEPDIR)/libgnu_a-width.Tpo -c -o lib/uniwidth/libgnu_a-width.o `test -f 'lib/uniwidth/width.c' || echo '$(srcdir)/'`lib/uniwidth/width.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/uniwidth/$(DEPDIR)/libgnu_a-width.Tpo lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/uniwidth/width.c' object='lib/uniwidth/libgnu_a-width.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/uniwidth/libgnu_a-width.o `test -f 'lib/uniwidth/width.c' || echo '$(srcdir)/'`lib/uniwidth/width.c
+
+lib/uniwidth/libgnu_a-width.obj: lib/uniwidth/width.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/uniwidth/libgnu_a-width.obj -MD -MP -MF lib/uniwidth/$(DEPDIR)/libgnu_a-width.Tpo -c -o lib/uniwidth/libgnu_a-width.obj `if test -f 'lib/uniwidth/width.c'; then $(CYGPATH_W) 'lib/uniwidth/width.c'; else $(CYGPATH_W) '$(srcdir)/lib/uniwidth/width.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/uniwidth/$(DEPDIR)/libgnu_a-width.Tpo lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/uniwidth/width.c' object='lib/uniwidth/libgnu_a-width.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/uniwidth/libgnu_a-width.obj `if test -f 'lib/uniwidth/width.c'; then $(CYGPATH_W) 'lib/uniwidth/width.c'; else $(CYGPATH_W) '$(srcdir)/lib/uniwidth/width.c'; fi`
+
+lib/libgnu_a-wctype-h.o: lib/wctype-h.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-wctype-h.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-wctype-h.Tpo -c -o lib/libgnu_a-wctype-h.o `test -f 'lib/wctype-h.c' || echo '$(srcdir)/'`lib/wctype-h.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-wctype-h.Tpo lib/$(DEPDIR)/libgnu_a-wctype-h.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/wctype-h.c' object='lib/libgnu_a-wctype-h.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-wctype-h.o `test -f 'lib/wctype-h.c' || echo '$(srcdir)/'`lib/wctype-h.c
+
+lib/libgnu_a-wctype-h.obj: lib/wctype-h.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-wctype-h.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-wctype-h.Tpo -c -o lib/libgnu_a-wctype-h.obj `if test -f 'lib/wctype-h.c'; then $(CYGPATH_W) 'lib/wctype-h.c'; else $(CYGPATH_W) '$(srcdir)/lib/wctype-h.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-wctype-h.Tpo lib/$(DEPDIR)/libgnu_a-wctype-h.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/wctype-h.c' object='lib/libgnu_a-wctype-h.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-wctype-h.obj `if test -f 'lib/wctype-h.c'; then $(CYGPATH_W) 'lib/wctype-h.c'; else $(CYGPATH_W) '$(srcdir)/lib/wctype-h.c'; fi`
+
+lib/libgnu_a-wcwidth.o: lib/wcwidth.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-wcwidth.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-wcwidth.Tpo -c -o lib/libgnu_a-wcwidth.o `test -f 'lib/wcwidth.c' || echo '$(srcdir)/'`lib/wcwidth.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-wcwidth.Tpo lib/$(DEPDIR)/libgnu_a-wcwidth.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/wcwidth.c' object='lib/libgnu_a-wcwidth.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-wcwidth.o `test -f 'lib/wcwidth.c' || echo '$(srcdir)/'`lib/wcwidth.c
+
+lib/libgnu_a-wcwidth.obj: lib/wcwidth.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-wcwidth.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-wcwidth.Tpo -c -o lib/libgnu_a-wcwidth.obj `if test -f 'lib/wcwidth.c'; then $(CYGPATH_W) 'lib/wcwidth.c'; else $(CYGPATH_W) '$(srcdir)/lib/wcwidth.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-wcwidth.Tpo lib/$(DEPDIR)/libgnu_a-wcwidth.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/wcwidth.c' object='lib/libgnu_a-wcwidth.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-wcwidth.obj `if test -f 'lib/wcwidth.c'; then $(CYGPATH_W) 'lib/wcwidth.c'; else $(CYGPATH_W) '$(srcdir)/lib/wcwidth.c'; fi`
+
+lib/libgnu_a-xsize.o: lib/xsize.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-xsize.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-xsize.Tpo -c -o lib/libgnu_a-xsize.o `test -f 'lib/xsize.c' || echo '$(srcdir)/'`lib/xsize.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-xsize.Tpo lib/$(DEPDIR)/libgnu_a-xsize.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/xsize.c' object='lib/libgnu_a-xsize.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-xsize.o `test -f 'lib/xsize.c' || echo '$(srcdir)/'`lib/xsize.c
+
+lib/libgnu_a-xsize.obj: lib/xsize.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-xsize.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-xsize.Tpo -c -o lib/libgnu_a-xsize.obj `if test -f 'lib/xsize.c'; then $(CYGPATH_W) 'lib/xsize.c'; else $(CYGPATH_W) '$(srcdir)/lib/xsize.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-xsize.Tpo lib/$(DEPDIR)/libgnu_a-xsize.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/xsize.c' object='lib/libgnu_a-xsize.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-xsize.obj `if test -f 'lib/xsize.c'; then $(CYGPATH_W) 'lib/xsize.c'; else $(CYGPATH_W) '$(srcdir)/lib/xsize.c'; fi`
+
+lib/libgnu_a-fprintf.o: lib/fprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-fprintf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-fprintf.Tpo -c -o lib/libgnu_a-fprintf.o `test -f 'lib/fprintf.c' || echo '$(srcdir)/'`lib/fprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-fprintf.Tpo lib/$(DEPDIR)/libgnu_a-fprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/fprintf.c' object='lib/libgnu_a-fprintf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-fprintf.o `test -f 'lib/fprintf.c' || echo '$(srcdir)/'`lib/fprintf.c
+
+lib/libgnu_a-fprintf.obj: lib/fprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-fprintf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-fprintf.Tpo -c -o lib/libgnu_a-fprintf.obj `if test -f 'lib/fprintf.c'; then $(CYGPATH_W) 'lib/fprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/fprintf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-fprintf.Tpo lib/$(DEPDIR)/libgnu_a-fprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/fprintf.c' object='lib/libgnu_a-fprintf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-fprintf.obj `if test -f 'lib/fprintf.c'; then $(CYGPATH_W) 'lib/fprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/fprintf.c'; fi`
+
+lib/libgnu_a-frexp.o: lib/frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-frexp.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-frexp.Tpo -c -o lib/libgnu_a-frexp.o `test -f 'lib/frexp.c' || echo '$(srcdir)/'`lib/frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-frexp.Tpo lib/$(DEPDIR)/libgnu_a-frexp.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/frexp.c' object='lib/libgnu_a-frexp.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-frexp.o `test -f 'lib/frexp.c' || echo '$(srcdir)/'`lib/frexp.c
+
+lib/libgnu_a-frexp.obj: lib/frexp.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-frexp.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-frexp.Tpo -c -o lib/libgnu_a-frexp.obj `if test -f 'lib/frexp.c'; then $(CYGPATH_W) 'lib/frexp.c'; else $(CYGPATH_W) '$(srcdir)/lib/frexp.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-frexp.Tpo lib/$(DEPDIR)/libgnu_a-frexp.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/frexp.c' object='lib/libgnu_a-frexp.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-frexp.obj `if test -f 'lib/frexp.c'; then $(CYGPATH_W) 'lib/frexp.c'; else $(CYGPATH_W) '$(srcdir)/lib/frexp.c'; fi`
+
+lib/libgnu_a-frexpl.o: lib/frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-frexpl.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-frexpl.Tpo -c -o lib/libgnu_a-frexpl.o `test -f 'lib/frexpl.c' || echo '$(srcdir)/'`lib/frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-frexpl.Tpo lib/$(DEPDIR)/libgnu_a-frexpl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/frexpl.c' object='lib/libgnu_a-frexpl.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-frexpl.o `test -f 'lib/frexpl.c' || echo '$(srcdir)/'`lib/frexpl.c
+
+lib/libgnu_a-frexpl.obj: lib/frexpl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-frexpl.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-frexpl.Tpo -c -o lib/libgnu_a-frexpl.obj `if test -f 'lib/frexpl.c'; then $(CYGPATH_W) 'lib/frexpl.c'; else $(CYGPATH_W) '$(srcdir)/lib/frexpl.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-frexpl.Tpo lib/$(DEPDIR)/libgnu_a-frexpl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/frexpl.c' object='lib/libgnu_a-frexpl.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-frexpl.obj `if test -f 'lib/frexpl.c'; then $(CYGPATH_W) 'lib/frexpl.c'; else $(CYGPATH_W) '$(srcdir)/lib/frexpl.c'; fi`
+
+lib/libgnu_a-isnan.o: lib/isnan.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnan.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnan.Tpo -c -o lib/libgnu_a-isnan.o `test -f 'lib/isnan.c' || echo '$(srcdir)/'`lib/isnan.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnan.Tpo lib/$(DEPDIR)/libgnu_a-isnan.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnan.c' object='lib/libgnu_a-isnan.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnan.o `test -f 'lib/isnan.c' || echo '$(srcdir)/'`lib/isnan.c
+
+lib/libgnu_a-isnan.obj: lib/isnan.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnan.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnan.Tpo -c -o lib/libgnu_a-isnan.obj `if test -f 'lib/isnan.c'; then $(CYGPATH_W) 'lib/isnan.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnan.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnan.Tpo lib/$(DEPDIR)/libgnu_a-isnan.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnan.c' object='lib/libgnu_a-isnan.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnan.obj `if test -f 'lib/isnan.c'; then $(CYGPATH_W) 'lib/isnan.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnan.c'; fi`
+
+lib/libgnu_a-isnand.o: lib/isnand.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnand.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnand.Tpo -c -o lib/libgnu_a-isnand.o `test -f 'lib/isnand.c' || echo '$(srcdir)/'`lib/isnand.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnand.Tpo lib/$(DEPDIR)/libgnu_a-isnand.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnand.c' object='lib/libgnu_a-isnand.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnand.o `test -f 'lib/isnand.c' || echo '$(srcdir)/'`lib/isnand.c
+
+lib/libgnu_a-isnand.obj: lib/isnand.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnand.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnand.Tpo -c -o lib/libgnu_a-isnand.obj `if test -f 'lib/isnand.c'; then $(CYGPATH_W) 'lib/isnand.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnand.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnand.Tpo lib/$(DEPDIR)/libgnu_a-isnand.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnand.c' object='lib/libgnu_a-isnand.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnand.obj `if test -f 'lib/isnand.c'; then $(CYGPATH_W) 'lib/isnand.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnand.c'; fi`
+
+lib/libgnu_a-isnanf.o: lib/isnanf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnanf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnanf.Tpo -c -o lib/libgnu_a-isnanf.o `test -f 'lib/isnanf.c' || echo '$(srcdir)/'`lib/isnanf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnanf.Tpo lib/$(DEPDIR)/libgnu_a-isnanf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnanf.c' object='lib/libgnu_a-isnanf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnanf.o `test -f 'lib/isnanf.c' || echo '$(srcdir)/'`lib/isnanf.c
+
+lib/libgnu_a-isnanf.obj: lib/isnanf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnanf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnanf.Tpo -c -o lib/libgnu_a-isnanf.obj `if test -f 'lib/isnanf.c'; then $(CYGPATH_W) 'lib/isnanf.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnanf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnanf.Tpo lib/$(DEPDIR)/libgnu_a-isnanf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnanf.c' object='lib/libgnu_a-isnanf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnanf.obj `if test -f 'lib/isnanf.c'; then $(CYGPATH_W) 'lib/isnanf.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnanf.c'; fi`
+
+lib/libgnu_a-isnanl.o: lib/isnanl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnanl.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnanl.Tpo -c -o lib/libgnu_a-isnanl.o `test -f 'lib/isnanl.c' || echo '$(srcdir)/'`lib/isnanl.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnanl.Tpo lib/$(DEPDIR)/libgnu_a-isnanl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnanl.c' object='lib/libgnu_a-isnanl.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnanl.o `test -f 'lib/isnanl.c' || echo '$(srcdir)/'`lib/isnanl.c
+
+lib/libgnu_a-isnanl.obj: lib/isnanl.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-isnanl.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-isnanl.Tpo -c -o lib/libgnu_a-isnanl.obj `if test -f 'lib/isnanl.c'; then $(CYGPATH_W) 'lib/isnanl.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnanl.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-isnanl.Tpo lib/$(DEPDIR)/libgnu_a-isnanl.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/isnanl.c' object='lib/libgnu_a-isnanl.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-isnanl.obj `if test -f 'lib/isnanl.c'; then $(CYGPATH_W) 'lib/isnanl.c'; else $(CYGPATH_W) '$(srcdir)/lib/isnanl.c'; fi`
+
+lib/libgnu_a-snprintf.o: lib/snprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-snprintf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-snprintf.Tpo -c -o lib/libgnu_a-snprintf.o `test -f 'lib/snprintf.c' || echo '$(srcdir)/'`lib/snprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-snprintf.Tpo lib/$(DEPDIR)/libgnu_a-snprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/snprintf.c' object='lib/libgnu_a-snprintf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-snprintf.o `test -f 'lib/snprintf.c' || echo '$(srcdir)/'`lib/snprintf.c
+
+lib/libgnu_a-snprintf.obj: lib/snprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-snprintf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-snprintf.Tpo -c -o lib/libgnu_a-snprintf.obj `if test -f 'lib/snprintf.c'; then $(CYGPATH_W) 'lib/snprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/snprintf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-snprintf.Tpo lib/$(DEPDIR)/libgnu_a-snprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/snprintf.c' object='lib/libgnu_a-snprintf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-snprintf.obj `if test -f 'lib/snprintf.c'; then $(CYGPATH_W) 'lib/snprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/snprintf.c'; fi`
+
+lib/libgnu_a-asnprintf.o: lib/asnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-asnprintf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-asnprintf.Tpo -c -o lib/libgnu_a-asnprintf.o `test -f 'lib/asnprintf.c' || echo '$(srcdir)/'`lib/asnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-asnprintf.Tpo lib/$(DEPDIR)/libgnu_a-asnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/asnprintf.c' object='lib/libgnu_a-asnprintf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-asnprintf.o `test -f 'lib/asnprintf.c' || echo '$(srcdir)/'`lib/asnprintf.c
+
+lib/libgnu_a-asnprintf.obj: lib/asnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-asnprintf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-asnprintf.Tpo -c -o lib/libgnu_a-asnprintf.obj `if test -f 'lib/asnprintf.c'; then $(CYGPATH_W) 'lib/asnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/asnprintf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-asnprintf.Tpo lib/$(DEPDIR)/libgnu_a-asnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/asnprintf.c' object='lib/libgnu_a-asnprintf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-asnprintf.obj `if test -f 'lib/asnprintf.c'; then $(CYGPATH_W) 'lib/asnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/asnprintf.c'; fi`
+
+lib/libgnu_a-printf-args.o: lib/printf-args.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-args.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-args.Tpo -c -o lib/libgnu_a-printf-args.o `test -f 'lib/printf-args.c' || echo '$(srcdir)/'`lib/printf-args.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-args.Tpo lib/$(DEPDIR)/libgnu_a-printf-args.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-args.c' object='lib/libgnu_a-printf-args.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-args.o `test -f 'lib/printf-args.c' || echo '$(srcdir)/'`lib/printf-args.c
+
+lib/libgnu_a-printf-args.obj: lib/printf-args.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-args.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-args.Tpo -c -o lib/libgnu_a-printf-args.obj `if test -f 'lib/printf-args.c'; then $(CYGPATH_W) 'lib/printf-args.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-args.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-args.Tpo lib/$(DEPDIR)/libgnu_a-printf-args.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-args.c' object='lib/libgnu_a-printf-args.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-args.obj `if test -f 'lib/printf-args.c'; then $(CYGPATH_W) 'lib/printf-args.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-args.c'; fi`
+
+lib/libgnu_a-printf-parse.o: lib/printf-parse.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-parse.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-parse.Tpo -c -o lib/libgnu_a-printf-parse.o `test -f 'lib/printf-parse.c' || echo '$(srcdir)/'`lib/printf-parse.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-parse.Tpo lib/$(DEPDIR)/libgnu_a-printf-parse.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-parse.c' object='lib/libgnu_a-printf-parse.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-parse.o `test -f 'lib/printf-parse.c' || echo '$(srcdir)/'`lib/printf-parse.c
+
+lib/libgnu_a-printf-parse.obj: lib/printf-parse.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-printf-parse.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-printf-parse.Tpo -c -o lib/libgnu_a-printf-parse.obj `if test -f 'lib/printf-parse.c'; then $(CYGPATH_W) 'lib/printf-parse.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-parse.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-printf-parse.Tpo lib/$(DEPDIR)/libgnu_a-printf-parse.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/printf-parse.c' object='lib/libgnu_a-printf-parse.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-printf-parse.obj `if test -f 'lib/printf-parse.c'; then $(CYGPATH_W) 'lib/printf-parse.c'; else $(CYGPATH_W) '$(srcdir)/lib/printf-parse.c'; fi`
+
+lib/libgnu_a-vasnprintf.o: lib/vasnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-vasnprintf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-vasnprintf.Tpo -c -o lib/libgnu_a-vasnprintf.o `test -f 'lib/vasnprintf.c' || echo '$(srcdir)/'`lib/vasnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-vasnprintf.Tpo lib/$(DEPDIR)/libgnu_a-vasnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/vasnprintf.c' object='lib/libgnu_a-vasnprintf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-vasnprintf.o `test -f 'lib/vasnprintf.c' || echo '$(srcdir)/'`lib/vasnprintf.c
+
+lib/libgnu_a-vasnprintf.obj: lib/vasnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-vasnprintf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-vasnprintf.Tpo -c -o lib/libgnu_a-vasnprintf.obj `if test -f 'lib/vasnprintf.c'; then $(CYGPATH_W) 'lib/vasnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/vasnprintf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-vasnprintf.Tpo lib/$(DEPDIR)/libgnu_a-vasnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/vasnprintf.c' object='lib/libgnu_a-vasnprintf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-vasnprintf.obj `if test -f 'lib/vasnprintf.c'; then $(CYGPATH_W) 'lib/vasnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/vasnprintf.c'; fi`
+
+lib/libgnu_a-vsnprintf.o: lib/vsnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-vsnprintf.o -MD -MP -MF lib/$(DEPDIR)/libgnu_a-vsnprintf.Tpo -c -o lib/libgnu_a-vsnprintf.o `test -f 'lib/vsnprintf.c' || echo '$(srcdir)/'`lib/vsnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-vsnprintf.Tpo lib/$(DEPDIR)/libgnu_a-vsnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/vsnprintf.c' object='lib/libgnu_a-vsnprintf.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-vsnprintf.o `test -f 'lib/vsnprintf.c' || echo '$(srcdir)/'`lib/vsnprintf.c
+
+lib/libgnu_a-vsnprintf.obj: lib/vsnprintf.c
+@am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -MT lib/libgnu_a-vsnprintf.obj -MD -MP -MF lib/$(DEPDIR)/libgnu_a-vsnprintf.Tpo -c -o lib/libgnu_a-vsnprintf.obj `if test -f 'lib/vsnprintf.c'; then $(CYGPATH_W) 'lib/vsnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/vsnprintf.c'; fi`
+@am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) lib/$(DEPDIR)/libgnu_a-vsnprintf.Tpo lib/$(DEPDIR)/libgnu_a-vsnprintf.Po
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	$(AM_V_CC)source='lib/vsnprintf.c' object='lib/libgnu_a-vsnprintf.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCC_FALSE@	DEPDIR=$(DEPDIR) $(CCDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCC_FALSE@	$(AM_V_CC@am__nodep@)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(lib_libgnu_a_CFLAGS) $(CFLAGS) -c -o lib/libgnu_a-vsnprintf.obj `if test -f 'lib/vsnprintf.c'; then $(CYGPATH_W) 'lib/vsnprintf.c'; else $(CYGPATH_W) '$(srcdir)/lib/vsnprintf.c'; fi`
+
 src/libs/libgroff/libgroff_a-getopt.o: src/libs/libgroff/getopt.c
 @am__fastdepCC_TRUE@	$(AM_V_CC)$(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS) -MT src/libs/libgroff/libgroff_a-getopt.o -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-getopt.Tpo -c -o src/libs/libgroff/libgroff_a-getopt.o `test -f 'src/libs/libgroff/getopt.c' || echo '$(srcdir)/'`src/libs/libgroff/getopt.c
 @am__fastdepCC_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-getopt.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-getopt.Po
@@ -7508,20 +8541,6 @@
 @AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
 @am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-nametoindex.obj `if test -f 'src/libs/libgroff/nametoindex.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/nametoindex.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/nametoindex.cpp'; fi`
 
-src/libs/libgroff/libgroff_a-new.o: src/libs/libgroff/new.cpp
-@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-new.o -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo -c -o src/libs/libgroff/libgroff_a-new.o `test -f 'src/libs/libgroff/new.cpp' || echo '$(srcdir)/'`src/libs/libgroff/new.cpp
-@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Po
-@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='src/libs/libgroff/new.cpp' object='src/libs/libgroff/libgroff_a-new.o' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-new.o `test -f 'src/libs/libgroff/new.cpp' || echo '$(srcdir)/'`src/libs/libgroff/new.cpp
-
-src/libs/libgroff/libgroff_a-new.obj: src/libs/libgroff/new.cpp
-@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-new.obj -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo -c -o src/libs/libgroff/libgroff_a-new.obj `if test -f 'src/libs/libgroff/new.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/new.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/new.cpp'; fi`
-@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Po
-@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='src/libs/libgroff/new.cpp' object='src/libs/libgroff/libgroff_a-new.obj' libtool=no @AMDEPBACKSLASH@
-@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
-@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-new.obj `if test -f 'src/libs/libgroff/new.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/new.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/new.cpp'; fi`
-
 src/libs/libgroff/libgroff_a-paper.o: src/libs/libgroff/paper.cpp
 @am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-paper.o -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-paper.Tpo -c -o src/libs/libgroff/libgroff_a-paper.o `test -f 'src/libs/libgroff/paper.cpp' || echo '$(srcdir)/'`src/libs/libgroff/paper.cpp
 @am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-paper.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-paper.Po
@@ -7704,6 +8723,20 @@
 @AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
 @am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-uniuni.obj `if test -f 'src/libs/libgroff/uniuni.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/uniuni.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/uniuni.cpp'; fi`
 
+src/libs/libgroff/libgroff_a-new.o: src/libs/libgroff/new.cpp
+@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-new.o -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo -c -o src/libs/libgroff/libgroff_a-new.o `test -f 'src/libs/libgroff/new.cpp' || echo '$(srcdir)/'`src/libs/libgroff/new.cpp
+@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Po
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='src/libs/libgroff/new.cpp' object='src/libs/libgroff/libgroff_a-new.o' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-new.o `test -f 'src/libs/libgroff/new.cpp' || echo '$(srcdir)/'`src/libs/libgroff/new.cpp
+
+src/libs/libgroff/libgroff_a-new.obj: src/libs/libgroff/new.cpp
+@am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-new.obj -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo -c -o src/libs/libgroff/libgroff_a-new.obj `if test -f 'src/libs/libgroff/new.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/new.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/new.cpp'; fi`
+@am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-new.Po
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	$(AM_V_CXX)source='src/libs/libgroff/new.cpp' object='src/libs/libgroff/libgroff_a-new.obj' libtool=no @AMDEPBACKSLASH@
+@AMDEP_TRUE@@am__fastdepCXX_FALSE@	DEPDIR=$(DEPDIR) $(CXXDEPMODE) $(depcomp) @AMDEPBACKSLASH@
+@am__fastdepCXX_FALSE@	$(AM_V_CXX@am__nodep@)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -c -o src/libs/libgroff/libgroff_a-new.obj `if test -f 'src/libs/libgroff/new.cpp'; then $(CYGPATH_W) 'src/libs/libgroff/new.cpp'; else $(CYGPATH_W) '$(srcdir)/src/libs/libgroff/new.cpp'; fi`
+
 src/libs/libgroff/libgroff_a-version.o: src/libs/libgroff/version.cpp
 @am__fastdepCXX_TRUE@	$(AM_V_CXX)$(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(libgroff_a_CPPFLAGS) $(CPPFLAGS) $(AM_CXXFLAGS) $(CXXFLAGS) -MT src/libs/libgroff/libgroff_a-version.o -MD -MP -MF src/libs/libgroff/$(DEPDIR)/libgroff_a-version.Tpo -c -o src/libs/libgroff/libgroff_a-version.o `test -f 'src/libs/libgroff/version.cpp' || echo '$(srcdir)/'`src/libs/libgroff/version.cpp
 @am__fastdepCXX_TRUE@	$(AM_V_at)$(am__mv) src/libs/libgroff/$(DEPDIR)/libgroff_a-version.Tpo src/libs/libgroff/$(DEPDIR)/libgroff_a-version.Po
@@ -8235,90 +9268,90 @@
 	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^^70-9a-z*$$,7,;x' \
 	      -e 's,\.0-9a-z*$$,,;$(transform);G;s,\n,.,'`; \
 	dir='$(DESTDIR)$(man7dir)'; $(am__uninstall_files_from_dir)
-install-devX10012fontDATA: $(devX10012font_DATA)
+install-devX100_12_fontDATA: $(devX100_12_font_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(devX10012font_DATA)'; test -n "$(devX10012fontdir)" || list=; \
+	@list='$(devX100_12_font_DATA)'; test -n "$(devX100_12_fontdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(devX10012fontdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(devX10012fontdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(devX100_12_fontdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(devX100_12_fontdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX10012fontdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX10012fontdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX100_12_fontdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX100_12_fontdir)" || exit $$?; \
 	done
 
-uninstall-devX10012fontDATA:
+uninstall-devX100_12_fontDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(devX10012font_DATA)'; test -n "$(devX10012fontdir)" || list=; \
+	@list='$(devX100_12_font_DATA)'; test -n "$(devX100_12_fontdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(devX10012fontdir)'; $(am__uninstall_files_from_dir)
-install-devX100fontDATA: $(devX100font_DATA)
+	dir='$(DESTDIR)$(devX100_12_fontdir)'; $(am__uninstall_files_from_dir)
+install-devX100_fontDATA: $(devX100_font_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(devX100font_DATA)'; test -n "$(devX100fontdir)" || list=; \
+	@list='$(devX100_font_DATA)'; test -n "$(devX100_fontdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(devX100fontdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(devX100fontdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(devX100_fontdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(devX100_fontdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX100fontdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX100fontdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX100_fontdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX100_fontdir)" || exit $$?; \
 	done
 
-uninstall-devX100fontDATA:
+uninstall-devX100_fontDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(devX100font_DATA)'; test -n "$(devX100fontdir)" || list=; \
+	@list='$(devX100_font_DATA)'; test -n "$(devX100_fontdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(devX100fontdir)'; $(am__uninstall_files_from_dir)
-install-devX7512fontDATA: $(devX7512font_DATA)
+	dir='$(DESTDIR)$(devX100_fontdir)'; $(am__uninstall_files_from_dir)
+install-devX75_12_fontDATA: $(devX75_12_font_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(devX7512font_DATA)'; test -n "$(devX7512fontdir)" || list=; \
+	@list='$(devX75_12_font_DATA)'; test -n "$(devX75_12_fontdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(devX7512fontdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(devX7512fontdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(devX75_12_fontdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(devX75_12_fontdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX7512fontdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX7512fontdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX75_12_fontdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX75_12_fontdir)" || exit $$?; \
 	done
 
-uninstall-devX7512fontDATA:
+uninstall-devX75_12_fontDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(devX7512font_DATA)'; test -n "$(devX7512fontdir)" || list=; \
+	@list='$(devX75_12_font_DATA)'; test -n "$(devX75_12_fontdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(devX7512fontdir)'; $(am__uninstall_files_from_dir)
-install-devX75fontDATA: $(devX75font_DATA)
+	dir='$(DESTDIR)$(devX75_12_fontdir)'; $(am__uninstall_files_from_dir)
+install-devX75_fontDATA: $(devX75_font_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(devX75font_DATA)'; test -n "$(devX75fontdir)" || list=; \
+	@list='$(devX75_font_DATA)'; test -n "$(devX75_fontdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(devX75fontdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(devX75fontdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(devX75_fontdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(devX75_fontdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX75fontdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX75fontdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(devX75_fontdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(devX75_fontdir)" || exit $$?; \
 	done
 
-uninstall-devX75fontDATA:
+uninstall-devX75_fontDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(devX75font_DATA)'; test -n "$(devX75fontdir)" || list=; \
+	@list='$(devX75_font_DATA)'; test -n "$(devX75_fontdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(devX75fontdir)'; $(am__uninstall_files_from_dir)
+	dir='$(DESTDIR)$(devX75_fontdir)'; $(am__uninstall_files_from_dir)
 install-devasciifontDATA: $(devasciifont_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(devasciifont_DATA)'; test -n "$(devasciifontdir)" || list=; \
@@ -8697,111 +9730,90 @@
 	@list='$(dist_docexamples_DATA)'; test -n "$(docexamplesdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
 	dir='$(DESTDIR)$(docexamplesdir)'; $(am__uninstall_files_from_dir)
-install-dist_glilypondDATA: $(dist_glilypond_DATA)
-	@$(NORMAL_INSTALL)
-	@list='$(dist_glilypond_DATA)'; test -n "$(glilyponddir)" || list=; \
-	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(glilyponddir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(glilyponddir)" || exit 1; \
-	fi; \
-	for p in $$list; do \
-	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
-	  echo "$$d$$p"; \
-	done | $(am__base_list) | \
-	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(glilyponddir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(glilyponddir)" || exit $$?; \
-	done
-
-uninstall-dist_glilypondDATA:
-	@$(NORMAL_UNINSTALL)
-	@list='$(dist_glilypond_DATA)'; test -n "$(glilyponddir)" || list=; \
-	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(glilyponddir)'; $(am__uninstall_files_from_dir)
-install-dist_gpinyinDATA: $(dist_gpinyin_DATA)
+install-dist_hdtblexampleDATA: $(dist_hdtblexample_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(dist_gpinyin_DATA)'; test -n "$(gpinyindir)" || list=; \
+	@list='$(dist_hdtblexample_DATA)'; test -n "$(hdtblexampledir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(gpinyindir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(gpinyindir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(hdtblexampledir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(hdtblexampledir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(gpinyindir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(gpinyindir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(hdtblexampledir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(hdtblexampledir)" || exit $$?; \
 	done
 
-uninstall-dist_gpinyinDATA:
+uninstall-dist_hdtblexampleDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(dist_gpinyin_DATA)'; test -n "$(gpinyindir)" || list=; \
+	@list='$(dist_hdtblexample_DATA)'; test -n "$(hdtblexampledir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(gpinyindir)'; $(am__uninstall_files_from_dir)
-install-dist_grogDATA: $(dist_grog_DATA)
+	dir='$(DESTDIR)$(hdtblexampledir)'; $(am__uninstall_files_from_dir)
+install-dist_hdtbltmacDATA: $(dist_hdtbltmac_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(dist_grog_DATA)'; test -n "$(grogdir)" || list=; \
+	@list='$(dist_hdtbltmac_DATA)'; test -n "$(hdtbltmacdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(grogdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(grogdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(hdtbltmacdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(hdtbltmacdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(grogdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(grogdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(hdtbltmacdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(hdtbltmacdir)" || exit $$?; \
 	done
 
-uninstall-dist_grogDATA:
+uninstall-dist_hdtbltmacDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(dist_grog_DATA)'; test -n "$(grogdir)" || list=; \
+	@list='$(dist_hdtbltmac_DATA)'; test -n "$(hdtbltmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(grogdir)'; $(am__uninstall_files_from_dir)
-install-dist_hdtblexampleDATA: $(dist_hdtblexample_DATA)
+	dir='$(DESTDIR)$(hdtbltmacdir)'; $(am__uninstall_files_from_dir)
+install-dist_localtmacDATA: $(dist_localtmac_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(dist_hdtblexample_DATA)'; test -n "$(hdtblexampledir)" || list=; \
+	@list='$(dist_localtmac_DATA)'; test -n "$(localtmacdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(hdtblexampledir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(hdtblexampledir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(localtmacdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(localtmacdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(hdtblexampledir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(hdtblexampledir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(localtmacdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(localtmacdir)" || exit $$?; \
 	done
 
-uninstall-dist_hdtblexampleDATA:
+uninstall-dist_localtmacDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(dist_hdtblexample_DATA)'; test -n "$(hdtblexampledir)" || list=; \
+	@list='$(dist_localtmac_DATA)'; test -n "$(localtmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(hdtblexampledir)'; $(am__uninstall_files_from_dir)
-install-dist_localtmacDATA: $(dist_localtmac_DATA)
+	dir='$(DESTDIR)$(localtmacdir)'; $(am__uninstall_files_from_dir)
+install-dist_mdocDATA: $(dist_mdoc_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(dist_localtmac_DATA)'; test -n "$(localtmacdir)" || list=; \
+	@list='$(dist_mdoc_DATA)'; test -n "$(mdocdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(localtmacdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(localtmacdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(mdocdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(mdocdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(localtmacdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(localtmacdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(mdocdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(mdocdir)" || exit $$?; \
 	done
 
-uninstall-dist_localtmacDATA:
+uninstall-dist_mdocDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(dist_localtmac_DATA)'; test -n "$(localtmacdir)" || list=; \
+	@list='$(dist_mdoc_DATA)'; test -n "$(mdocdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(localtmacdir)'; $(am__uninstall_files_from_dir)
+	dir='$(DESTDIR)$(mdocdir)'; $(am__uninstall_files_from_dir)
 install-dist_mmDATA: $(dist_mm_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(dist_mm_DATA)'; test -n "$(mmdir)" || list=; \
@@ -8949,111 +9961,90 @@
 	@list='$(dist_pdfmarktmac_DATA)'; test -n "$(pdfmarktmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
 	dir='$(DESTDIR)$(pdfmarktmacdir)'; $(am__uninstall_files_from_dir)
-install-dist_tmacDATA: $(dist_tmac_DATA)
+install-dist_rfc1345tmacDATA: $(dist_rfc1345tmac_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(dist_tmac_DATA)'; test -n "$(tmacdir)" || list=; \
+	@list='$(dist_rfc1345tmac_DATA)'; test -n "$(rfc1345tmacdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(tmacdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(tmacdir)" || exit 1; \
-	fi; \
-	for p in $$list; do \
-	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
-	  echo "$$d$$p"; \
-	done | $(am__base_list) | \
-	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(tmacdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(tmacdir)" || exit $$?; \
-	done
-
-uninstall-dist_tmacDATA:
-	@$(NORMAL_UNINSTALL)
-	@list='$(dist_tmac_DATA)'; test -n "$(tmacdir)" || list=; \
-	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(tmacdir)'; $(am__uninstall_files_from_dir)
-install-dist_tmacmmDATA: $(dist_tmacmm_DATA)
-	@$(NORMAL_INSTALL)
-	@list='$(dist_tmacmm_DATA)'; test -n "$(tmacmmdir)" || list=; \
-	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(tmacmmdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(tmacmmdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(rfc1345tmacdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(rfc1345tmacdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(tmacmmdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(tmacmmdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(rfc1345tmacdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(rfc1345tmacdir)" || exit $$?; \
 	done
 
-uninstall-dist_tmacmmDATA:
+uninstall-dist_rfc1345tmacDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(dist_tmacmm_DATA)'; test -n "$(tmacmmdir)" || list=; \
+	@list='$(dist_rfc1345tmac_DATA)'; test -n "$(rfc1345tmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(tmacmmdir)'; $(am__uninstall_files_from_dir)
-install-grofferDATA: $(groffer_DATA)
+	dir='$(DESTDIR)$(rfc1345tmacdir)'; $(am__uninstall_files_from_dir)
+install-dist_sboxestmacDATA: $(dist_sboxestmac_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(groffer_DATA)'; test -n "$(grofferdir)" || list=; \
+	@list='$(dist_sboxestmac_DATA)'; test -n "$(sboxestmacdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(grofferdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(grofferdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(sboxestmacdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(sboxestmacdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(grofferdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(grofferdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(sboxestmacdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(sboxestmacdir)" || exit $$?; \
 	done
 
-uninstall-grofferDATA:
+uninstall-dist_sboxestmacDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(groffer_DATA)'; test -n "$(grofferdir)" || list=; \
+	@list='$(dist_sboxestmac_DATA)'; test -n "$(sboxestmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(grofferdir)'; $(am__uninstall_files_from_dir)
-install-groffoptsDATA: $(groffopts_DATA)
+	dir='$(DESTDIR)$(sboxestmacdir)'; $(am__uninstall_files_from_dir)
+install-dist_tmacDATA: $(dist_tmac_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(groffopts_DATA)'; test -n "$(groffoptsdir)" || list=; \
+	@list='$(dist_tmac_DATA)'; test -n "$(tmacdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(groffoptsdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(groffoptsdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(tmacdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(tmacdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(groffoptsdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(groffoptsdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(tmacdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(tmacdir)" || exit $$?; \
 	done
 
-uninstall-groffoptsDATA:
+uninstall-dist_tmacDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(groffopts_DATA)'; test -n "$(groffoptsdir)" || list=; \
+	@list='$(dist_tmac_DATA)'; test -n "$(tmacdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(groffoptsdir)'; $(am__uninstall_files_from_dir)
-install-hdtbltmacDATA: $(hdtbltmac_DATA)
+	dir='$(DESTDIR)$(tmacdir)'; $(am__uninstall_files_from_dir)
+install-dist_tmacmmDATA: $(dist_tmacmm_DATA)
 	@$(NORMAL_INSTALL)
-	@list='$(hdtbltmac_DATA)'; test -n "$(hdtbltmacdir)" || list=; \
+	@list='$(dist_tmacmm_DATA)'; test -n "$(tmacmmdir)" || list=; \
 	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(hdtbltmacdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(hdtbltmacdir)" || exit 1; \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(tmacmmdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(tmacmmdir)" || exit 1; \
 	fi; \
 	for p in $$list; do \
 	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; \
 	done | $(am__base_list) | \
 	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(hdtbltmacdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(hdtbltmacdir)" || exit $$?; \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(tmacmmdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(tmacmmdir)" || exit $$?; \
 	done
 
-uninstall-hdtbltmacDATA:
+uninstall-dist_tmacmmDATA:
 	@$(NORMAL_UNINSTALL)
-	@list='$(hdtbltmac_DATA)'; test -n "$(hdtbltmacdir)" || list=; \
+	@list='$(dist_tmacmm_DATA)'; test -n "$(tmacmmdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(hdtbltmacdir)'; $(am__uninstall_files_from_dir)
+	dir='$(DESTDIR)$(tmacmmdir)'; $(am__uninstall_files_from_dir)
 install-htmlpicDATA: $(htmlpic_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(htmlpic_DATA)'; test -n "$(htmlpicdir)" || list=; \
@@ -9243,48 +10234,6 @@
 	@list='$(nodist_hdtblexample_DATA)'; test -n "$(hdtblexampledir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
 	dir='$(DESTDIR)$(hdtblexampledir)'; $(am__uninstall_files_from_dir)
-install-nodist_htmlexamplesDATA: $(nodist_htmlexamples_DATA)
-	@$(NORMAL_INSTALL)
-	@list='$(nodist_htmlexamples_DATA)'; test -n "$(htmlexamplesdir)" || list=; \
-	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(htmlexamplesdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(htmlexamplesdir)" || exit 1; \
-	fi; \
-	for p in $$list; do \
-	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
-	  echo "$$d$$p"; \
-	done | $(am__base_list) | \
-	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(htmlexamplesdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(htmlexamplesdir)" || exit $$?; \
-	done
-
-uninstall-nodist_htmlexamplesDATA:
-	@$(NORMAL_UNINSTALL)
-	@list='$(nodist_htmlexamples_DATA)'; test -n "$(htmlexamplesdir)" || list=; \
-	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(htmlexamplesdir)'; $(am__uninstall_files_from_dir)
-install-nodist_mdocDATA: $(nodist_mdoc_DATA)
-	@$(NORMAL_INSTALL)
-	@list='$(nodist_mdoc_DATA)'; test -n "$(mdocdir)" || list=; \
-	if test -n "$$list"; then \
-	  echo " $(MKDIR_P) '$(DESTDIR)$(mdocdir)'"; \
-	  $(MKDIR_P) "$(DESTDIR)$(mdocdir)" || exit 1; \
-	fi; \
-	for p in $$list; do \
-	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
-	  echo "$$d$$p"; \
-	done | $(am__base_list) | \
-	while read files; do \
-	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(mdocdir)'"; \
-	  $(INSTALL_DATA) $$files "$(DESTDIR)$(mdocdir)" || exit $$?; \
-	done
-
-uninstall-nodist_mdocDATA:
-	@$(NORMAL_UNINSTALL)
-	@list='$(nodist_mdoc_DATA)'; test -n "$(mdocdir)" || list=; \
-	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
-	dir='$(DESTDIR)$(mdocdir)'; $(am__uninstall_files_from_dir)
 install-nodist_momprocessedexampleDATA: $(nodist_momprocessedexample_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(nodist_momprocessedexample_DATA)'; test -n "$(momprocessedexampledir)" || list=; \
@@ -9348,6 +10297,48 @@
 	@list='$(nodist_pdfmarkpdfdoc_DATA)'; test -n "$(pdfmarkpdfdocdir)" || list=; \
 	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
 	dir='$(DESTDIR)$(pdfmarkpdfdocdir)'; $(am__uninstall_files_from_dir)
+install-nodist_sboxesotherdocDATA: $(nodist_sboxesotherdoc_DATA)
+	@$(NORMAL_INSTALL)
+	@list='$(nodist_sboxesotherdoc_DATA)'; test -n "$(sboxesotherdocdir)" || list=; \
+	if test -n "$$list"; then \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(sboxesotherdocdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(sboxesotherdocdir)" || exit 1; \
+	fi; \
+	for p in $$list; do \
+	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
+	  echo "$$d$$p"; \
+	done | $(am__base_list) | \
+	while read files; do \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(sboxesotherdocdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(sboxesotherdocdir)" || exit $$?; \
+	done
+
+uninstall-nodist_sboxesotherdocDATA:
+	@$(NORMAL_UNINSTALL)
+	@list='$(nodist_sboxesotherdoc_DATA)'; test -n "$(sboxesotherdocdir)" || list=; \
+	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
+	dir='$(DESTDIR)$(sboxesotherdocdir)'; $(am__uninstall_files_from_dir)
+install-nodist_sboxespdfdocDATA: $(nodist_sboxespdfdoc_DATA)
+	@$(NORMAL_INSTALL)
+	@list='$(nodist_sboxespdfdoc_DATA)'; test -n "$(sboxespdfdocdir)" || list=; \
+	if test -n "$$list"; then \
+	  echo " $(MKDIR_P) '$(DESTDIR)$(sboxespdfdocdir)'"; \
+	  $(MKDIR_P) "$(DESTDIR)$(sboxespdfdocdir)" || exit 1; \
+	fi; \
+	for p in $$list; do \
+	  if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
+	  echo "$$d$$p"; \
+	done | $(am__base_list) | \
+	while read files; do \
+	  echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(sboxespdfdocdir)'"; \
+	  $(INSTALL_DATA) $$files "$(DESTDIR)$(sboxespdfdocdir)" || exit $$?; \
+	done
+
+uninstall-nodist_sboxespdfdocDATA:
+	@$(NORMAL_UNINSTALL)
+	@list='$(nodist_sboxespdfdoc_DATA)'; test -n "$(sboxespdfdocdir)" || list=; \
+	files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
+	dir='$(DESTDIR)$(sboxespdfdocdir)'; $(am__uninstall_files_from_dir)
 install-nodist_tmacDATA: $(nodist_tmac_DATA)
 	@$(NORMAL_INSTALL)
 	@list='$(nodist_tmac_DATA)'; test -n "$(tmacdir)" || list=; \
@@ -9536,7 +10527,7 @@
 	  test x"$$VERBOSE" = x || cat $(TEST_SUITE_LOG);		\
 	fi;								\
 	echo "$${col}$$br$${std}"; 					\
-	echo "$${col}Testsuite summary for $(PACKAGE_STRING)$${std}";	\
+	echo "$${col}Testsuite summary"$(AM_TESTSUITE_SUMMARY_HEADER)"$${std}";	\
 	echo "$${col}$$br$${std}"; 					\
 	create_testsuite_report --maybe-color;				\
 	echo "$$col$$br$$std";						\
@@ -9570,9 +10561,9 @@
 	        am__force_recheck=am--force-recheck \
 	        TEST_LOGS="$$log_list"; \
 	exit $$?
-contrib/gdiffmk/tests/gdiffmk_tests.sh.log: contrib/gdiffmk/tests/gdiffmk_tests.sh
-	@p='contrib/gdiffmk/tests/gdiffmk_tests.sh'; \
-	b='contrib/gdiffmk/tests/gdiffmk_tests.sh'; \
+contrib/gdiffmk/tests/runtests.sh.log: contrib/gdiffmk/tests/runtests.sh
+	@p='contrib/gdiffmk/tests/runtests.sh'; \
+	b='contrib/gdiffmk/tests/runtests.sh'; \
 	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
 	--log-file $$b.log --trs-file $$b.trs \
 	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
@@ -9584,6 +10575,76 @@
 	--log-file $$b.log --trs-file $$b.trs \
 	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
 	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/LT_SP_AU_without_AT_works.sh.log: contrib/mm/tests/LT_SP_AU_without_AT_works.sh
+	@p='contrib/mm/tests/LT_SP_AU_without_AT_works.sh'; \
+	b='contrib/mm/tests/LT_SP_AU_without_AT_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh.log: contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh
+	@p='contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh'; \
+	b='contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/MT-1-reports-all-TM-numbers.sh.log: contrib/mm/tests/MT-1-reports-all-TM-numbers.sh
+	@p='contrib/mm/tests/MT-1-reports-all-TM-numbers.sh'; \
+	b='contrib/mm/tests/MT-1-reports-all-TM-numbers.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/MT_5_includes_AT_in_SG.sh.log: contrib/mm/tests/MT_5_includes_AT_in_SG.sh
+	@p='contrib/mm/tests/MT_5_includes_AT_in_SG.sh'; \
+	b='contrib/mm/tests/MT_5_includes_AT_in_SG.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/P-indentation-works.sh.log: contrib/mm/tests/P-indentation-works.sh
+	@p='contrib/mm/tests/P-indentation-works.sh'; \
+	b='contrib/mm/tests/P-indentation-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh.log: contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh
+	@p='contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh'; \
+	b='contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/mse_has-sufficient-footnote-space.sh.log: contrib/mm/tests/mse_has-sufficient-footnote-space.sh
+	@p='contrib/mm/tests/mse_has-sufficient-footnote-space.sh'; \
+	b='contrib/mm/tests/mse_has-sufficient-footnote-space.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/place-equation-labels-correctly-in-displays.sh.log: contrib/mm/tests/place-equation-labels-correctly-in-displays.sh
+	@p='contrib/mm/tests/place-equation-labels-correctly-in-displays.sh'; \
+	b='contrib/mm/tests/place-equation-labels-correctly-in-displays.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/remove-stale-bib-entry-data.sh.log: contrib/mm/tests/remove-stale-bib-entry-data.sh
+	@p='contrib/mm/tests/remove-stale-bib-entry-data.sh'; \
+	b='contrib/mm/tests/remove-stale-bib-entry-data.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/mm/tests/short-pages-do-not-overflow-stack.sh.log: contrib/mm/tests/short-pages-do-not-overflow-stack.sh
+	@p='contrib/mm/tests/short-pages-do-not-overflow-stack.sh'; \
+	b='contrib/mm/tests/short-pages-do-not-overflow-stack.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
 contrib/mom/examples/tests-mom.sh.log: contrib/mom/examples/tests-mom.sh
 	@p='contrib/mom/examples/tests-mom.sh'; \
 	b='contrib/mom/examples/tests-mom.sh'; \
@@ -9591,6 +10652,1063 @@
 	--log-file $$b.log --trs-file $$b.trs \
 	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
 	"$$tst" $(AM_TESTS_FD_REDIRECT)
+contrib/rfc1345/tests/rfc1345-smoke-test.sh.log: contrib/rfc1345/tests/rfc1345-smoke-test.sh
+	@p='contrib/rfc1345/tests/rfc1345-smoke-test.sh'; \
+	b='contrib/rfc1345/tests/rfc1345-smoke-test.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+font/devpdf/tests/check-default-foundry.sh.log: font/devpdf/tests/check-default-foundry.sh
+	@p='font/devpdf/tests/check-default-foundry.sh'; \
+	b='font/devpdf/tests/check-default-foundry.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+font/devpdf/tests/check-urw-foundry.sh.log: font/devpdf/tests/check-urw-foundry.sh
+	@p='font/devpdf/tests/check-urw-foundry.sh'; \
+	b='font/devpdf/tests/check-urw-foundry.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh.log: src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh
+	@p='src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh'; \
+	b='src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/devices/grotty/tests/osc8_works.sh.log: src/devices/grotty/tests/osc8_works.sh
+	@p='src/devices/grotty/tests/osc8_works.sh'; \
+	b='src/devices/grotty/tests/osc8_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh.log: src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh
+	@p='src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh'; \
+	b='src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/preconv/tests/do-not-seek-the-unseekable.sh.log: src/preproc/preconv/tests/do-not-seek-the-unseekable.sh
+	@p='src/preproc/preconv/tests/do-not-seek-the-unseekable.sh'; \
+	b='src/preproc/preconv/tests/do-not-seek-the-unseekable.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/preconv/tests/smoke-test.sh.log: src/preproc/preconv/tests/smoke-test.sh
+	@p='src/preproc/preconv/tests/smoke-test.sh'; \
+	b='src/preproc/preconv/tests/smoke-test.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/refer/tests/report-correct-line-numbers.sh.log: src/preproc/refer/tests/report-correct-line-numbers.sh
+	@p='src/preproc/refer/tests/report-correct-line-numbers.sh'; \
+	b='src/preproc/refer/tests/report-correct-line-numbers.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/boxes-and-vertical-rules.sh.log: src/preproc/tbl/tests/boxes-and-vertical-rules.sh
+	@p='src/preproc/tbl/tests/boxes-and-vertical-rules.sh'; \
+	b='src/preproc/tbl/tests/boxes-and-vertical-rules.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/check-horizontal-line-length.sh.log: src/preproc/tbl/tests/check-horizontal-line-length.sh
+	@p='src/preproc/tbl/tests/check-horizontal-line-length.sh'; \
+	b='src/preproc/tbl/tests/check-horizontal-line-length.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/check-line-intersections.sh.log: src/preproc/tbl/tests/check-line-intersections.sh
+	@p='src/preproc/tbl/tests/check-line-intersections.sh'; \
+	b='src/preproc/tbl/tests/check-line-intersections.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/check-vertical-line-length.sh.log: src/preproc/tbl/tests/check-vertical-line-length.sh
+	@p='src/preproc/tbl/tests/check-vertical-line-length.sh'; \
+	b='src/preproc/tbl/tests/check-vertical-line-length.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/cooperate-with-nm-request.sh.log: src/preproc/tbl/tests/cooperate-with-nm-request.sh
+	@p='src/preproc/tbl/tests/cooperate-with-nm-request.sh'; \
+	b='src/preproc/tbl/tests/cooperate-with-nm-request.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/count-continued-input-lines.sh.log: src/preproc/tbl/tests/count-continued-input-lines.sh
+	@p='src/preproc/tbl/tests/count-continued-input-lines.sh'; \
+	b='src/preproc/tbl/tests/count-continued-input-lines.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh.log: src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh
+	@p='src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh'; \
+	b='src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh.log: src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh
+	@p='src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh'; \
+	b='src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh.log: src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh
+	@p='src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh'; \
+	b='src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh.log: src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh
+	@p='src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh'; \
+	b='src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/expand-region-option-works.sh.log: src/preproc/tbl/tests/expand-region-option-works.sh
+	@p='src/preproc/tbl/tests/expand-region-option-works.sh'; \
+	b='src/preproc/tbl/tests/expand-region-option-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/format-time-diagnostics-work.sh.log: src/preproc/tbl/tests/format-time-diagnostics-work.sh
+	@p='src/preproc/tbl/tests/format-time-diagnostics-work.sh'; \
+	b='src/preproc/tbl/tests/format-time-diagnostics-work.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh.log: src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh
+	@p='src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh'; \
+	b='src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh.log: src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh
+	@p='src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh'; \
+	b='src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/save-and-restore-line-numbering.sh.log: src/preproc/tbl/tests/save-and-restore-line-numbering.sh
+	@p='src/preproc/tbl/tests/save-and-restore-line-numbering.sh'; \
+	b='src/preproc/tbl/tests/save-and-restore-line-numbering.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/save-and-restore-tab-stops.sh.log: src/preproc/tbl/tests/save-and-restore-tab-stops.sh
+	@p='src/preproc/tbl/tests/save-and-restore-tab-stops.sh'; \
+	b='src/preproc/tbl/tests/save-and-restore-tab-stops.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh.log: src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh
+	@p='src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh'; \
+	b='src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/preproc/tbl/tests/x-column-modifier-works.sh.log: src/preproc/tbl/tests/x-column-modifier-works.sh
+	@p='src/preproc/tbl/tests/x-column-modifier-works.sh'; \
+	b='src/preproc/tbl/tests/x-column-modifier-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/ab_works.sh.log: src/roff/groff/tests/ab_works.sh
+	@p='src/roff/groff/tests/ab_works.sh'; \
+	b='src/roff/groff/tests/ab_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/adjustment_works.sh.log: src/roff/groff/tests/adjustment_works.sh
+	@p='src/roff/groff/tests/adjustment_works.sh'; \
+	b='src/roff/groff/tests/adjustment_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/break_zero-length_output_line_sanely.sh.log: src/roff/groff/tests/break_zero-length_output_line_sanely.sh
+	@p='src/roff/groff/tests/break_zero-length_output_line_sanely.sh'; \
+	b='src/roff/groff/tests/break_zero-length_output_line_sanely.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/device_control_escapes_express_basic_latin.sh.log: src/roff/groff/tests/device_control_escapes_express_basic_latin.sh
+	@p='src/roff/groff/tests/device_control_escapes_express_basic_latin.sh'; \
+	b='src/roff/groff/tests/device_control_escapes_express_basic_latin.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh.log: src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh
+	@p='src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh'; \
+	b='src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/dot-cp_register_works.sh.log: src/roff/groff/tests/dot-cp_register_works.sh
+	@p='src/roff/groff/tests/dot-cp_register_works.sh'; \
+	b='src/roff/groff/tests/dot-cp_register_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/dot-nm_register_works.sh.log: src/roff/groff/tests/dot-nm_register_works.sh
+	@p='src/roff/groff/tests/dot-nm_register_works.sh'; \
+	b='src/roff/groff/tests/dot-nm_register_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/dot-nn_register_works.sh.log: src/roff/groff/tests/dot-nn_register_works.sh
+	@p='src/roff/groff/tests/dot-nn_register_works.sh'; \
+	b='src/roff/groff/tests/dot-nn_register_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/evc_produces_no_output_if_invalid.sh.log: src/roff/groff/tests/evc_produces_no_output_if_invalid.sh
+	@p='src/roff/groff/tests/evc_produces_no_output_if_invalid.sh'; \
+	b='src/roff/groff/tests/evc_produces_no_output_if_invalid.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/fp_should_not_traverse_directories.sh.log: src/roff/groff/tests/fp_should_not_traverse_directories.sh
+	@p='src/roff/groff/tests/fp_should_not_traverse_directories.sh'; \
+	b='src/roff/groff/tests/fp_should_not_traverse_directories.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/handle_special_input_code_points.sh.log: src/roff/groff/tests/handle_special_input_code_points.sh
+	@p='src/roff/groff/tests/handle_special_input_code_points.sh'; \
+	b='src/roff/groff/tests/handle_special_input_code_points.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/html_works_with_grn_and_eqn.sh.log: src/roff/groff/tests/html_works_with_grn_and_eqn.sh
+	@p='src/roff/groff/tests/html_works_with_grn_and_eqn.sh'; \
+	b='src/roff/groff/tests/html_works_with_grn_and_eqn.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/initialization_is_quiet.sh.log: src/roff/groff/tests/initialization_is_quiet.sh
+	@p='src/roff/groff/tests/initialization_is_quiet.sh'; \
+	b='src/roff/groff/tests/initialization_is_quiet.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/localization_works.sh.log: src/roff/groff/tests/localization_works.sh
+	@p='src/roff/groff/tests/localization_works.sh'; \
+	b='src/roff/groff/tests/localization_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/msoquiet_works.sh.log: src/roff/groff/tests/msoquiet_works.sh
+	@p='src/roff/groff/tests/msoquiet_works.sh'; \
+	b='src/roff/groff/tests/msoquiet_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh.log: src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh
+	@p='src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh'; \
+	b='src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/output_driver_C_and_G_options_work.sh.log: src/roff/groff/tests/output_driver_C_and_G_options_work.sh
+	@p='src/roff/groff/tests/output_driver_C_and_G_options_work.sh'; \
+	b='src/roff/groff/tests/output_driver_C_and_G_options_work.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/recognize_end_of_sentence.sh.log: src/roff/groff/tests/recognize_end_of_sentence.sh
+	@p='src/roff/groff/tests/recognize_end_of_sentence.sh'; \
+	b='src/roff/groff/tests/recognize_end_of_sentence.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/regression_savannah_56555.sh.log: src/roff/groff/tests/regression_savannah_56555.sh
+	@p='src/roff/groff/tests/regression_savannah_56555.sh'; \
+	b='src/roff/groff/tests/regression_savannah_56555.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/regression_savannah_58153.sh.log: src/roff/groff/tests/regression_savannah_58153.sh
+	@p='src/roff/groff/tests/regression_savannah_58153.sh'; \
+	b='src/roff/groff/tests/regression_savannah_58153.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/regression_savannah_58162.sh.log: src/roff/groff/tests/regression_savannah_58162.sh
+	@p='src/roff/groff/tests/regression_savannah_58162.sh'; \
+	b='src/roff/groff/tests/regression_savannah_58162.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/regression_savannah_58337.sh.log: src/roff/groff/tests/regression_savannah_58337.sh
+	@p='src/roff/groff/tests/regression_savannah_58337.sh'; \
+	b='src/roff/groff/tests/regression_savannah_58337.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/regression_savannah_59202.sh.log: src/roff/groff/tests/regression_savannah_59202.sh
+	@p='src/roff/groff/tests/regression_savannah_59202.sh'; \
+	b='src/roff/groff/tests/regression_savannah_59202.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/smoke-test_html_device.sh.log: src/roff/groff/tests/smoke-test_html_device.sh
+	@p='src/roff/groff/tests/smoke-test_html_device.sh'; \
+	b='src/roff/groff/tests/smoke-test_html_device.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh.log: src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh
+	@p='src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh'; \
+	b='src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/soquiet_works.sh.log: src/roff/groff/tests/soquiet_works.sh
+	@p='src/roff/groff/tests/soquiet_works.sh'; \
+	b='src/roff/groff/tests/soquiet_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/string_case_xform_errors.sh.log: src/roff/groff/tests/string_case_xform_errors.sh
+	@p='src/roff/groff/tests/string_case_xform_errors.sh'; \
+	b='src/roff/groff/tests/string_case_xform_errors.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/string_case_xform_requests.sh.log: src/roff/groff/tests/string_case_xform_requests.sh
+	@p='src/roff/groff/tests/string_case_xform_requests.sh'; \
+	b='src/roff/groff/tests/string_case_xform_requests.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/string_case_xform_unicode_escape.sh.log: src/roff/groff/tests/string_case_xform_unicode_escape.sh
+	@p='src/roff/groff/tests/string_case_xform_unicode_escape.sh'; \
+	b='src/roff/groff/tests/string_case_xform_unicode_escape.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/substring_works.sh.log: src/roff/groff/tests/substring_works.sh
+	@p='src/roff/groff/tests/substring_works.sh'; \
+	b='src/roff/groff/tests/substring_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh.log: src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh
+	@p='src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh'; \
+	b='src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/roff/nroff/tests/verbose_option_works.sh.log: src/roff/nroff/tests/verbose_option_works.sh
+	@p='src/roff/nroff/tests/verbose_option_works.sh'; \
+	b='src/roff/nroff/tests/verbose_option_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/utils/grog/tests/PF-does-not-start-pic-region.sh.log: src/utils/grog/tests/PF-does-not-start-pic-region.sh
+	@p='src/utils/grog/tests/PF-does-not-start-pic-region.sh'; \
+	b='src/utils/grog/tests/PF-does-not-start-pic-region.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/utils/grog/tests/avoid-refer-fakeout.sh.log: src/utils/grog/tests/avoid-refer-fakeout.sh
+	@p='src/utils/grog/tests/avoid-refer-fakeout.sh'; \
+	b='src/utils/grog/tests/avoid-refer-fakeout.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/utils/grog/tests/preserve-groff-options.sh.log: src/utils/grog/tests/preserve-groff-options.sh
+	@p='src/utils/grog/tests/preserve-groff-options.sh'; \
+	b='src/utils/grog/tests/preserve-groff-options.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/utils/grog/tests/recognize-perl-pod.sh.log: src/utils/grog/tests/recognize-perl-pod.sh
+	@p='src/utils/grog/tests/recognize-perl-pod.sh'; \
+	b='src/utils/grog/tests/recognize-perl-pod.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+src/utils/grog/tests/smoke-test.sh.log: src/utils/grog/tests/smoke-test.sh
+	@p='src/utils/grog/tests/smoke-test.sh'; \
+	b='src/utils/grog/tests/smoke-test.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an-ext_MR-works.sh.log: tmac/tests/an-ext_MR-works.sh
+	@p='tmac/tests/an-ext_MR-works.sh'; \
+	b='tmac/tests/an-ext_MR-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an-ext_MT-works.sh.log: tmac/tests/an-ext_MT-works.sh
+	@p='tmac/tests/an-ext_MT-works.sh'; \
+	b='tmac/tests/an-ext_MT-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an-ext_UR-works.sh.log: tmac/tests/an-ext_UR-works.sh
+	@p='tmac/tests/an-ext_UR-works.sh'; \
+	b='tmac/tests/an-ext_UR-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh.log: tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh
+	@p='tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh'; \
+	b='tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CS-register-off.sh.log: tmac/tests/an_CS-register-off.sh
+	@p='tmac/tests/an_CS-register-off.sh'; \
+	b='tmac/tests/an_CS-register-off.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CS-register-on.sh.log: tmac/tests/an_CS-register-on.sh
+	@p='tmac/tests/an_CS-register-on.sh'; \
+	b='tmac/tests/an_CS-register-on.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CS-register-unspecified.sh.log: tmac/tests/an_CS-register-unspecified.sh
+	@p='tmac/tests/an_CS-register-unspecified.sh'; \
+	b='tmac/tests/an_CS-register-unspecified.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CT-register-off.sh.log: tmac/tests/an_CT-register-off.sh
+	@p='tmac/tests/an_CT-register-off.sh'; \
+	b='tmac/tests/an_CT-register-off.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CT-register-on.sh.log: tmac/tests/an_CT-register-on.sh
+	@p='tmac/tests/an_CT-register-on.sh'; \
+	b='tmac/tests/an_CT-register-on.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_CT-register-unspecified.sh.log: tmac/tests/an_CT-register-unspecified.sh
+	@p='tmac/tests/an_CT-register-unspecified.sh'; \
+	b='tmac/tests/an_CT-register-unspecified.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_FT-bad-value-should-not-trash-titles.sh.log: tmac/tests/an_FT-bad-value-should-not-trash-titles.sh
+	@p='tmac/tests/an_FT-bad-value-should-not-trash-titles.sh'; \
+	b='tmac/tests/an_FT-bad-value-should-not-trash-titles.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_HY-register-works.sh.log: tmac/tests/an_HY-register-works.sh
+	@p='tmac/tests/an_HY-register-works.sh'; \
+	b='tmac/tests/an_HY-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_LL-init-sanely.sh.log: tmac/tests/an_LL-init-sanely.sh
+	@p='tmac/tests/an_LL-init-sanely.sh'; \
+	b='tmac/tests/an_LL-init-sanely.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_ME-punct-hyphenates.sh.log: tmac/tests/an_ME-punct-hyphenates.sh
+	@p='tmac/tests/an_ME-punct-hyphenates.sh'; \
+	b='tmac/tests/an_ME-punct-hyphenates.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_MR-works.sh.log: tmac/tests/an_MR-works.sh
+	@p='tmac/tests/an_MR-works.sh'; \
+	b='tmac/tests/an_MR-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_MT-body-hyphenates.sh.log: tmac/tests/an_MT-body-hyphenates.sh
+	@p='tmac/tests/an_MT-body-hyphenates.sh'; \
+	b='tmac/tests/an_MT-body-hyphenates.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_MT-works.sh.log: tmac/tests/an_MT-works.sh
+	@p='tmac/tests/an_MT-works.sh'; \
+	b='tmac/tests/an_MT-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_P-register-works.sh.log: tmac/tests/an_P-register-works.sh
+	@p='tmac/tests/an_P-register-works.sh'; \
+	b='tmac/tests/an_P-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_TH-repairs-ad-damage.sh.log: tmac/tests/an_TH-repairs-ad-damage.sh
+	@p='tmac/tests/an_TH-repairs-ad-damage.sh'; \
+	b='tmac/tests/an_TH-repairs-ad-damage.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_TH-repairs-hy-damage.sh.log: tmac/tests/an_TH-repairs-hy-damage.sh
+	@p='tmac/tests/an_TH-repairs-hy-damage.sh'; \
+	b='tmac/tests/an_TH-repairs-hy-damage.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_TS-adds-no-vertical-space.sh.log: tmac/tests/an_TS-adds-no-vertical-space.sh
+	@p='tmac/tests/an_TS-adds-no-vertical-space.sh'; \
+	b='tmac/tests/an_TS-adds-no-vertical-space.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh.log: tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh
+	@p='tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh'; \
+	b='tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_UE-breaks-before-long-URIs.sh.log: tmac/tests/an_UE-breaks-before-long-URIs.sh
+	@p='tmac/tests/an_UE-breaks-before-long-URIs.sh'; \
+	b='tmac/tests/an_UE-breaks-before-long-URIs.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_UE-punct-hyphenates.sh.log: tmac/tests/an_UE-punct-hyphenates.sh
+	@p='tmac/tests/an_UE-punct-hyphenates.sh'; \
+	b='tmac/tests/an_UE-punct-hyphenates.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_UR-body-hyphenates.sh.log: tmac/tests/an_UR-body-hyphenates.sh
+	@p='tmac/tests/an_UR-body-hyphenates.sh'; \
+	b='tmac/tests/an_UR-body-hyphenates.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_UR-works.sh.log: tmac/tests/an_UR-works.sh
+	@p='tmac/tests/an_UR-works.sh'; \
+	b='tmac/tests/an_UR-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_X-register-works.sh.log: tmac/tests/an_X-register-works.sh
+	@p='tmac/tests/an_X-register-works.sh'; \
+	b='tmac/tests/an_X-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_adjust-link-text-correctly.sh.log: tmac/tests/an_adjust-link-text-correctly.sh
+	@p='tmac/tests/an_adjust-link-text-correctly.sh'; \
+	b='tmac/tests/an_adjust-link-text-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_avoid-two-font-denial-of-service.sh.log: tmac/tests/an_avoid-two-font-denial-of-service.sh
+	@p='tmac/tests/an_avoid-two-font-denial-of-service.sh'; \
+	b='tmac/tests/an_avoid-two-font-denial-of-service.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh.log: tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh
+	@p='tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh'; \
+	b='tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_font-remapping-does-not-affect-titles.sh.log: tmac/tests/an_font-remapping-does-not-affect-titles.sh
+	@p='tmac/tests/an_font-remapping-does-not-affect-titles.sh'; \
+	b='tmac/tests/an_font-remapping-does-not-affect-titles.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_handle-degenerate-input-quietly.sh.log: tmac/tests/an_handle-degenerate-input-quietly.sh
+	@p='tmac/tests/an_handle-degenerate-input-quietly.sh'; \
+	b='tmac/tests/an_handle-degenerate-input-quietly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_inner-footer-abbreviation-works.sh.log: tmac/tests/an_inner-footer-abbreviation-works.sh
+	@p='tmac/tests/an_inner-footer-abbreviation-works.sh'; \
+	b='tmac/tests/an_inner-footer-abbreviation-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_link-macros-work-in-paragraph-tags.sh.log: tmac/tests/an_link-macros-work-in-paragraph-tags.sh
+	@p='tmac/tests/an_link-macros-work-in-paragraph-tags.sh'; \
+	b='tmac/tests/an_link-macros-work-in-paragraph-tags.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_link-trailing-text-hugs-previous.sh.log: tmac/tests/an_link-trailing-text-hugs-previous.sh
+	@p='tmac/tests/an_link-trailing-text-hugs-previous.sh'; \
+	b='tmac/tests/an_link-trailing-text-hugs-previous.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_no-break-after-short-paragraph-tags.sh.log: tmac/tests/an_no-break-after-short-paragraph-tags.sh
+	@p='tmac/tests/an_no-break-after-short-paragraph-tags.sh'; \
+	b='tmac/tests/an_no-break-after-short-paragraph-tags.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_output-footer-when-continuously-rendering.sh.log: tmac/tests/an_output-footer-when-continuously-rendering.sh
+	@p='tmac/tests/an_output-footer-when-continuously-rendering.sh'; \
+	b='tmac/tests/an_output-footer-when-continuously-rendering.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_page-footers-present.sh.log: tmac/tests/an_page-footers-present.sh
+	@p='tmac/tests/an_page-footers-present.sh'; \
+	b='tmac/tests/an_page-footers-present.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_page-header-has-current-data.sh.log: tmac/tests/an_page-header-has-current-data.sh
+	@p='tmac/tests/an_page-header-has-current-data.sh'; \
+	b='tmac/tests/an_page-header-has-current-data.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_reset-hyphenation-correctly.sh.log: tmac/tests/an_reset-hyphenation-correctly.sh
+	@p='tmac/tests/an_reset-hyphenation-correctly.sh'; \
+	b='tmac/tests/an_reset-hyphenation-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_title-abbreviation-works.sh.log: tmac/tests/an_title-abbreviation-works.sh
+	@p='tmac/tests/an_title-abbreviation-works.sh'; \
+	b='tmac/tests/an_title-abbreviation-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_use-input-traps-correctly.sh.log: tmac/tests/an_use-input-traps-correctly.sh
+	@p='tmac/tests/an_use-input-traps-correctly.sh'; \
+	b='tmac/tests/an_use-input-traps-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/an_works-with-ec.sh.log: tmac/tests/an_works-with-ec.sh
+	@p='tmac/tests/an_works-with-ec.sh'; \
+	b='tmac/tests/an_works-with-ec.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/andoc_P-register-works.sh.log: tmac/tests/andoc_P-register-works.sh
+	@p='tmac/tests/andoc_P-register-works.sh'; \
+	b='tmac/tests/andoc_P-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/andoc_check-an-to-doc-transition.sh.log: tmac/tests/andoc_check-an-to-doc-transition.sh
+	@p='tmac/tests/andoc_check-an-to-doc-transition.sh'; \
+	b='tmac/tests/andoc_check-an-to-doc-transition.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/andoc_clear-doc-traps.sh.log: tmac/tests/andoc_clear-doc-traps.sh
+	@p='tmac/tests/andoc_clear-doc-traps.sh'; \
+	b='tmac/tests/andoc_clear-doc-traps.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/andoc_flush-between-packages.sh.log: tmac/tests/andoc_flush-between-packages.sh
+	@p='tmac/tests/andoc_flush-between-packages.sh'; \
+	b='tmac/tests/andoc_flush-between-packages.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_CS-works.sh.log: tmac/tests/doc_CS-works.sh
+	@p='tmac/tests/doc_CS-works.sh'; \
+	b='tmac/tests/doc_CS-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_CT-works.sh.log: tmac/tests/doc_CT-works.sh
+	@p='tmac/tests/doc_CT-works.sh'; \
+	b='tmac/tests/doc_CT-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_D-places-page-numbers-correctly.sh.log: tmac/tests/doc_D-places-page-numbers-correctly.sh
+	@p='tmac/tests/doc_D-places-page-numbers-correctly.sh'; \
+	b='tmac/tests/doc_D-places-page-numbers-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh.log: tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh
+	@p='tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh'; \
+	b='tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_Mt-works.sh.log: tmac/tests/doc_Mt-works.sh
+	@p='tmac/tests/doc_Mt-works.sh'; \
+	b='tmac/tests/doc_Mt-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_Nm-works.sh.log: tmac/tests/doc_Nm-works.sh
+	@p='tmac/tests/doc_Nm-works.sh'; \
+	b='tmac/tests/doc_Nm-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_P-register-works.sh.log: tmac/tests/doc_P-register-works.sh
+	@p='tmac/tests/doc_P-register-works.sh'; \
+	b='tmac/tests/doc_P-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_X-register-works.sh.log: tmac/tests/doc_X-register-works.sh
+	@p='tmac/tests/doc_X-register-works.sh'; \
+	b='tmac/tests/doc_X-register-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_accept-mixed-case-section-headings.sh.log: tmac/tests/doc_accept-mixed-case-section-headings.sh
+	@p='tmac/tests/doc_accept-mixed-case-section-headings.sh'; \
+	b='tmac/tests/doc_accept-mixed-case-section-headings.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh.log: tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh
+	@p='tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh'; \
+	b='tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_heading-font-remapping-works.sh.log: tmac/tests/doc_heading-font-remapping-works.sh
+	@p='tmac/tests/doc_heading-font-remapping-works.sh'; \
+	b='tmac/tests/doc_heading-font-remapping-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_indents-correctly.sh.log: tmac/tests/doc_indents-correctly.sh
+	@p='tmac/tests/doc_indents-correctly.sh'; \
+	b='tmac/tests/doc_indents-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_output-footer-when-continuously-rendering.sh.log: tmac/tests/doc_output-footer-when-continuously-rendering.sh
+	@p='tmac/tests/doc_output-footer-when-continuously-rendering.sh'; \
+	b='tmac/tests/doc_output-footer-when-continuously-rendering.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/doc_smoke-test.sh.log: tmac/tests/doc_smoke-test.sh
+	@p='tmac/tests/doc_smoke-test.sh'; \
+	b='tmac/tests/doc_smoke-test.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_chapter-titles-work.sh.log: tmac/tests/e_chapter-titles-work.sh
+	@p='tmac/tests/e_chapter-titles-work.sh'; \
+	b='tmac/tests/e_chapter-titles-work.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_columns-work-on-long-pages.sh.log: tmac/tests/e_columns-work-on-long-pages.sh
+	@p='tmac/tests/e_columns-work-on-long-pages.sh'; \
+	b='tmac/tests/e_columns-work-on-long-pages.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_delayed-text-marks-work.sh.log: tmac/tests/e_delayed-text-marks-work.sh
+	@p='tmac/tests/e_delayed-text-marks-work.sh'; \
+	b='tmac/tests/e_delayed-text-marks-work.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_footnote-marks-work.sh.log: tmac/tests/e_footnote-marks-work.sh
+	@p='tmac/tests/e_footnote-marks-work.sh'; \
+	b='tmac/tests/e_footnote-marks-work.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_footnotes-work-with-columns.sh.log: tmac/tests/e_footnotes-work-with-columns.sh
+	@p='tmac/tests/e_footnotes-work-with-columns.sh'; \
+	b='tmac/tests/e_footnotes-work-with-columns.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_ld-works.sh.log: tmac/tests/e_ld-works.sh
+	@p='tmac/tests/e_ld-works.sh'; \
+	b='tmac/tests/e_ld-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_line-numbering-works.sh.log: tmac/tests/e_line-numbering-works.sh
+	@p='tmac/tests/e_line-numbering-works.sh'; \
+	b='tmac/tests/e_line-numbering-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/e_rejects-too-short-page-lengths.sh.log: tmac/tests/e_rejects-too-short-page-lengths.sh
+	@p='tmac/tests/e_rejects-too-short-page-lengths.sh'; \
+	b='tmac/tests/e_rejects-too-short-page-lengths.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/ec_works.sh.log: tmac/tests/ec_works.sh
+	@p='tmac/tests/ec_works.sh'; \
+	b='tmac/tests/ec_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/latin2_works.sh.log: tmac/tests/latin2_works.sh
+	@p='tmac/tests/latin2_works.sh'; \
+	b='tmac/tests/latin2_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/latin5_works.sh.log: tmac/tests/latin5_works.sh
+	@p='tmac/tests/latin5_works.sh'; \
+	b='tmac/tests/latin5_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/latin9_works.sh.log: tmac/tests/latin9_works.sh
+	@p='tmac/tests/latin9_works.sh'; \
+	b='tmac/tests/latin9_works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/localization-works.sh.log: tmac/tests/localization-works.sh
+	@p='tmac/tests/localization-works.sh'; \
+	b='tmac/tests/localization-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh.log: tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh
+	@p='tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh'; \
+	b='tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/pdfpic_falls-back-to-PSPIC.sh.log: tmac/tests/pdfpic_falls-back-to-PSPIC.sh
+	@p='tmac/tests/pdfpic_falls-back-to-PSPIC.sh'; \
+	b='tmac/tests/pdfpic_falls-back-to-PSPIC.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_IP-indents-using-paragraph-type-size.sh.log: tmac/tests/s_IP-indents-using-paragraph-type-size.sh
+	@p='tmac/tests/s_IP-indents-using-paragraph-type-size.sh'; \
+	b='tmac/tests/s_IP-indents-using-paragraph-type-size.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh.log: tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh
+	@p='tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh'; \
+	b='tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_PN-works.sh.log: tmac/tests/s_PN-works.sh
+	@p='tmac/tests/s_PN-works.sh'; \
+	b='tmac/tests/s_PN-works.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_R-handles-its-arguments.sh.log: tmac/tests/s_R-handles-its-arguments.sh
+	@p='tmac/tests/s_R-handles-its-arguments.sh'; \
+	b='tmac/tests/s_R-handles-its-arguments.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_SH-resets-IP-indentation-amount.sh.log: tmac/tests/s_SH-resets-IP-indentation-amount.sh
+	@p='tmac/tests/s_SH-resets-IP-indentation-amount.sh'; \
+	b='tmac/tests/s_SH-resets-IP-indentation-amount.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_TC-works-with-percent-in-custom-titles.sh.log: tmac/tests/s_TC-works-with-percent-in-custom-titles.sh
+	@p='tmac/tests/s_TC-works-with-percent-in-custom-titles.sh'; \
+	b='tmac/tests/s_TC-works-with-percent-in-custom-titles.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh.log: tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh
+	@p='tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh'; \
+	b='tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_honor-MINGW-when-two-columns.sh.log: tmac/tests/s_honor-MINGW-when-two-columns.sh
+	@p='tmac/tests/s_honor-MINGW-when-two-columns.sh'; \
+	b='tmac/tests/s_honor-MINGW-when-two-columns.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_mark-column-start-correctly.sh.log: tmac/tests/s_mark-column-start-correctly.sh
+	@p='tmac/tests/s_mark-column-start-correctly.sh'; \
+	b='tmac/tests/s_mark-column-start-correctly.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_no-excess-space-around-displays.sh.log: tmac/tests/s_no-excess-space-around-displays.sh
+	@p='tmac/tests/s_no-excess-space-around-displays.sh'; \
+	b='tmac/tests/s_no-excess-space-around-displays.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
+tmac/tests/s_rejects-too-short-page-lengths.sh.log: tmac/tests/s_rejects-too-short-page-lengths.sh
+	@p='tmac/tests/s_rejects-too-short-page-lengths.sh'; \
+	b='tmac/tests/s_rejects-too-short-page-lengths.sh'; \
+	$(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \
+	--log-file $$b.log --trs-file $$b.trs \
+	$(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \
+	"$$tst" $(AM_TESTS_FD_REDIRECT)
 .test.log:
 	@p='$<'; \
 	$(am__set_b); \
@@ -9605,7 +11723,6 @@
 @am__EXEEXT_TRUE@	--log-file $$b.log --trs-file $$b.trs \
 @am__EXEEXT_TRUE@	$(am__common_driver_flags) $(AM_TEST_LOG_DRIVER_FLAGS) $(TEST_LOG_DRIVER_FLAGS) -- $(TEST_LOG_COMPILE) \
 @am__EXEEXT_TRUE@	"$$tst" $(AM_TESTS_FD_REDIRECT)
-
 distdir: $(BUILT_SOURCES)
 	$(MAKE) $(AM_MAKEFLAGS) distdir-am
 
@@ -9667,6 +11784,10 @@
 	tardir=$(distdir) && $(am__tar) | XZ_OPT=$${XZ_OPT--e} xz -c >$(distdir).tar.xz
 	$(am__post_remove_distdir)
 
+dist-zstd: distdir
+	tardir=$(distdir) && $(am__tar) | zstd -c $${ZSTD_CLEVEL-$${ZSTD_OPT--19}} >$(distdir).tar.zst
+	$(am__post_remove_distdir)
+
 dist-tarZ: distdir
 	@echo WARNING: "Support for distribution archives compressed with" \
 		       "legacy program 'compress' is deprecated." >&2
@@ -9709,6 +11830,8 @@
 	  eval GZIP= gzip $(GZIP_ENV) -dc $(distdir).shar.gz | unshar ;;\
 	*.zip*) \
 	  unzip $(distdir).zip ;;\
+	*.tar.zst*) \
+	  zstd -dc $(distdir).tar.zst | $(am__untar) ;;\
 	esac
 	chmod -R a-w $(distdir)
 	chmod u+w $(distdir)
@@ -9724,7 +11847,7 @@
 	    $(DISTCHECK_CONFIGURE_FLAGS) \
 	    --srcdir=../.. --prefix="$$dc_install_base" \
 	  && $(MAKE) $(AM_MAKEFLAGS) \
-	  && $(MAKE) $(AM_MAKEFLAGS) dvi \
+	  && $(MAKE) $(AM_MAKEFLAGS) $(AM_DISTCHECK_DVI_TARGET) \
 	  && $(MAKE) $(AM_MAKEFLAGS) check \
 	  && $(MAKE) $(AM_MAKEFLAGS) install \
 	  && $(MAKE) $(AM_MAKEFLAGS) installcheck \
@@ -9783,12 +11906,13 @@
 all-am: Makefile $(PROGRAMS) $(LIBRARIES) $(SCRIPTS) $(MANS) $(DATA) \
 		$(HEADERS)
 installdirs:
-	for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(prefixexecbindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(prefixexecbindir)" "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man7dir)" "$(DESTDIR)$(devX10012fontdir)" "$(DESTDIR)$(devX100fontdir)" "$(DESTDIR)$(devX7512fontdir)" "$(DESTDIR)$(devX75fontdir)" "$(DESTDIR)$(devasciifontdir)" "$(DESTDIR)$(devcp1047fontdir)" "$(DESTDIR)$(devdvifontdir)" "$(DESTDIR)$(devdvigendir)" "$(DESTDIR)$(devhtmlfontdir)" "$(DESTDIR)$(devlatin1fontdir)" "$(DESTDIR)$(devlbpfontdir)" "$(DESTDIR)$(devpdffontdir)" "$(DESTDIR)$(devpdffontencdir)" "$(DESTDIR)$(devpdffontmapdir)" "$(DESTDIR)$(devutf8fontdir)" "$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chempicdir)" "$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devlj4fontgendir)" "$(DESTDIR)$(devpsfontdir)" "$(DESTDIR)$(devpsgendir)" "$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(glilyponddir)" "$(DESTDIR)$(gpinyindir)" "$(DESTDIR)$(grogdir)" "$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(localtmacdir)" "$(DESTDIR)$(mmdir)" "$(DESTDIR)$(mmexampledir)" "$(DESTDIR)$(momexampledir)" "$(DESTDIR)$(momtmacdir)" "$(DESTDIR)$(olddevpsfontdir)" "$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarktmacdir)" "$(DESTDIR)$(tmacdir)" "$(DESTDIR)$(tmacmmdir)" "$(DESTDIR)$(grofferdir)" "$(DESTDIR)$(groffoptsdir)" "$(DESTDIR)$(hdtbltmacdir)" "$(DESTDIR)$(htmlpicdir)" "$(DESTDIR)$(momhtmldir)" "$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chemexample122dir)" "$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devpsfontdir)" "$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(docpdfdocdir)" "$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(htmlexamplesdir)" "$(DESTDIR)$(mdocdir)" "$(DESTDIR)$(momprocessedexampledir)" "$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarkpdfdocdir)" "$(DESTDIR)$(tmacdir)"; do \
+	for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(prefixexecbindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(bindir)" "$(DESTDIR)$(prefixexecbindir)" "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man7dir)" "$(DESTDIR)$(devX100_12_fontdir)" "$(DESTDIR)$(devX100_fontdir)" "$(DESTDIR)$(devX75_12_fontdir)" "$(DESTDIR)$(devX75_fontdir)" "$(DESTDIR)$(devasciifontdir)" "$(DESTDIR)$(devcp1047fontdir)" "$(DESTDIR)$(devdvifontdir)" "$(DESTDIR)$(devdvigendir)" "$(DESTDIR)$(devhtmlfontdir)" "$(DESTDIR)$(devlatin1fontdir)" "$(DESTDIR)$(devlbpfontdir)" "$(DESTDIR)$(devpdffontdir)" "$(DESTDIR)$(devpdffontencdir)" "$(DESTDIR)$(devpdffontmapdir)" "$(DESTDIR)$(devutf8fontdir)" "$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chempicdir)" "$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devlj4fontgendir)" "$(DESTDIR)$(devpsfontdir)" "$(DESTDIR)$(devpsgendir)" "$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(hdtbltmacdir)" "$(DESTDIR)$(localtmacdir)" "$(DESTDIR)$(mdocdir)" "$(DESTDIR)$(mmdir)" "$(DESTDIR)$(mmexampledir)" "$(DESTDIR)$(momexampledir)" "$(DESTDIR)$(momtmacdir)" "$(DESTDIR)$(olddevpsfontdir)" "$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarktmacdir)" "$(DESTDIR)$(rfc1345tmacdir)" "$(DESTDIR)$(sboxestmacdir)" "$(DESTDIR)$(tmacdir)" "$(DESTDIR)$(tmacmmdir)" "$(DESTDIR)$(htmlpicdir)" "$(DESTDIR)$(momhtmldir)" "$(DESTDIR)$(chemexampledir)" "$(DESTDIR)$(chemexample122dir)" "$(DESTDIR)$(devlj4fontdir)" "$(DESTDIR)$(devpsfontdir)" "$(DESTDIR)$(docexamplesdir)" "$(DESTDIR)$(docpdfdocdir)" "$(DESTDIR)$(hdtblexampledir)" "$(DESTDIR)$(momprocessedexampledir)" "$(DESTDIR)$(otherdocdir)" "$(DESTDIR)$(pdfmarkpdfdocdir)" "$(DESTDIR)$(sboxesotherdocdir)" "$(DESTDIR)$(sboxespdfdocdir)" "$(DESTDIR)$(tmacdir)"; do \
 	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
 	done
 install: $(BUILT_SOURCES)
 	$(MAKE) $(AM_MAKEFLAGS) install-am
-install-exec: install-exec-am
+install-exec: $(BUILT_SOURCES)
+	$(MAKE) $(AM_MAKEFLAGS) install-exec-am
 install-data: install-data-am
 uninstall: uninstall-am
 
@@ -9891,44 +12015,47 @@
 	-rm -f src/preproc/refer/label.cpp
 	-rm -f src/preproc/refer/label.hpp
 	-test -z "$(BUILT_SOURCES)" || rm -f $(BUILT_SOURCES)
-@BUILD_INFODOC_FALSE@install-html-local:
-@BUILD_INFODOC_FALSE@install-pdf-local:
+	-test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES)
 clean: clean-am
 
 clean-am: clean-binPROGRAMS clean-checkPROGRAMS clean-generic \
-	clean-local clean-nobase_binPROGRAMS clean-noinstLIBRARIES \
+	clean-nobase_binPROGRAMS clean-noinstLIBRARIES \
 	clean-prefixexecbinPROGRAMS mostlyclean-am
 
 distclean: distclean-am
 	-rm -f $(am__CONFIG_DISTCLEAN_FILES)
-		-rm -f lib/$(DEPDIR)/asnprintf.Po
-	-rm -f lib/$(DEPDIR)/float.Po
-	-rm -f lib/$(DEPDIR)/fprintf.Po
-	-rm -f lib/$(DEPDIR)/frexp.Po
-	-rm -f lib/$(DEPDIR)/frexpl.Po
-	-rm -f lib/$(DEPDIR)/fseterr.Po
-	-rm -f lib/$(DEPDIR)/isnan.Po
-	-rm -f lib/$(DEPDIR)/isnand.Po
-	-rm -f lib/$(DEPDIR)/isnanf.Po
-	-rm -f lib/$(DEPDIR)/isnanl.Po
-	-rm -f lib/$(DEPDIR)/itold.Po
-	-rm -f lib/$(DEPDIR)/localcharset.Po
-	-rm -f lib/$(DEPDIR)/math.Po
-	-rm -f lib/$(DEPDIR)/memchr.Po
-	-rm -f lib/$(DEPDIR)/printf-args.Po
-	-rm -f lib/$(DEPDIR)/printf-frexp.Po
-	-rm -f lib/$(DEPDIR)/printf-frexpl.Po
-	-rm -f lib/$(DEPDIR)/printf-parse.Po
-	-rm -f lib/$(DEPDIR)/signbitd.Po
-	-rm -f lib/$(DEPDIR)/signbitf.Po
-	-rm -f lib/$(DEPDIR)/signbitl.Po
-	-rm -f lib/$(DEPDIR)/snprintf.Po
-	-rm -f lib/$(DEPDIR)/vasnprintf.Po
-	-rm -f lib/$(DEPDIR)/vsnprintf.Po
-	-rm -f lib/$(DEPDIR)/wctype-h.Po
-	-rm -f lib/$(DEPDIR)/wcwidth.Po
-	-rm -f lib/$(DEPDIR)/xsize.Po
-	-rm -f lib/uniwidth/$(DEPDIR)/width.Po
+		-rm -f lib/$(DEPDIR)/libgnu_a-asnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-float.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-fprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-free.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-frexp.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-frexpl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-fseterr.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnan.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnand.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnanf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnanl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-itold.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-localcharset.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-math.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-memchr.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-args.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-frexp.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-parse.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitd.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-snprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-stdio-read.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-stdio-write.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-unistd.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-vasnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-vsnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-wctype-h.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-wcwidth.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-xsize.Po
+	-rm -f lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po
 	-rm -f src/devices/grodvi/$(DEPDIR)/dvi.Po
 	-rm -f src/devices/grohtml/$(DEPDIR)/html-table.Po
 	-rm -f src/devices/grohtml/$(DEPDIR)/html-text.Po
@@ -10070,11 +12197,11 @@
 distclean-am: clean-am distclean-compile distclean-generic \
 	distclean-hdr distclean-local distclean-tags
 
-@BUILD_INFODOC_FALSE@dvi: dvi-am
+dvi: dvi-am
 
 dvi-am:
 
-@BUILD_INFODOC_FALSE@html: html-am
+html: html-am
 
 html-am:
 
@@ -10082,9 +12209,9 @@
 
 info-am:
 
-install-data-am: install-data-local install-devX10012fontDATA \
-	install-devX100fontDATA install-devX7512fontDATA \
-	install-devX75fontDATA install-devasciifontDATA \
+install-data-am: install-data-local install-devX100_12_fontDATA \
+	install-devX100_fontDATA install-devX75_12_fontDATA \
+	install-devX75_fontDATA install-devasciifontDATA \
 	install-devcp1047fontDATA install-devdvifontDATA \
 	install-devdvigenDATA install-devhtmlfontDATA \
 	install-devlatin1fontDATA install-devlbpfontDATA \
@@ -10093,24 +12220,23 @@
 	install-dist_chemexampleDATA install-dist_chempicDATA \
 	install-dist_devlj4fontDATA install-dist_devlj4fontgenDATA \
 	install-dist_devpsfontDATA install-dist_devpsgenDATA \
-	install-dist_docexamplesDATA install-dist_glilypondDATA \
-	install-dist_gpinyinDATA install-dist_grogDATA \
-	install-dist_hdtblexampleDATA install-dist_localtmacDATA \
-	install-dist_mmDATA install-dist_mmexampleDATA \
-	install-dist_momexampleDATA install-dist_momtmacDATA \
-	install-dist_olddevpsfontDATA install-dist_otherdocDATA \
-	install-dist_pdfmarktmacDATA install-dist_tmacDATA \
-	install-dist_tmacmmDATA install-grofferDATA \
-	install-groffoptsDATA install-hdtbltmacDATA \
+	install-dist_docexamplesDATA install-dist_hdtblexampleDATA \
+	install-dist_hdtbltmacDATA install-dist_localtmacDATA \
+	install-dist_mdocDATA install-dist_mmDATA \
+	install-dist_mmexampleDATA install-dist_momexampleDATA \
+	install-dist_momtmacDATA install-dist_olddevpsfontDATA \
+	install-dist_otherdocDATA install-dist_pdfmarktmacDATA \
+	install-dist_rfc1345tmacDATA install-dist_sboxestmacDATA \
+	install-dist_tmacDATA install-dist_tmacmmDATA \
 	install-htmlpicDATA install-man install-momhtmlDATA \
 	install-nodist_chemexample122DATA \
 	install-nodist_chemexampleDATA install-nodist_devlj4fontDATA \
 	install-nodist_devpsfontDATA install-nodist_docexamplesDATA \
 	install-nodist_docpdfdocDATA install-nodist_hdtblexampleDATA \
-	install-nodist_htmlexamplesDATA install-nodist_mdocDATA \
 	install-nodist_momprocessedexampleDATA \
 	install-nodist_otherdocDATA install-nodist_pdfmarkpdfdocDATA \
-	install-nodist_tmacDATA
+	install-nodist_sboxesotherdocDATA \
+	install-nodist_sboxespdfdocDATA install-nodist_tmacDATA
 	@$(NORMAL_INSTALL)
 	$(MAKE) $(AM_MAKEFLAGS) install-data-hook
 install-dvi: install-dvi-am
@@ -10145,34 +12271,38 @@
 maintainer-clean: maintainer-clean-am
 	-rm -f $(am__CONFIG_DISTCLEAN_FILES)
 	-rm -rf $(top_srcdir)/autom4te.cache
-		-rm -f lib/$(DEPDIR)/asnprintf.Po
-	-rm -f lib/$(DEPDIR)/float.Po
-	-rm -f lib/$(DEPDIR)/fprintf.Po
-	-rm -f lib/$(DEPDIR)/frexp.Po
-	-rm -f lib/$(DEPDIR)/frexpl.Po
-	-rm -f lib/$(DEPDIR)/fseterr.Po
-	-rm -f lib/$(DEPDIR)/isnan.Po
-	-rm -f lib/$(DEPDIR)/isnand.Po
-	-rm -f lib/$(DEPDIR)/isnanf.Po
-	-rm -f lib/$(DEPDIR)/isnanl.Po
-	-rm -f lib/$(DEPDIR)/itold.Po
-	-rm -f lib/$(DEPDIR)/localcharset.Po
-	-rm -f lib/$(DEPDIR)/math.Po
-	-rm -f lib/$(DEPDIR)/memchr.Po
-	-rm -f lib/$(DEPDIR)/printf-args.Po
-	-rm -f lib/$(DEPDIR)/printf-frexp.Po
-	-rm -f lib/$(DEPDIR)/printf-frexpl.Po
-	-rm -f lib/$(DEPDIR)/printf-parse.Po
-	-rm -f lib/$(DEPDIR)/signbitd.Po
-	-rm -f lib/$(DEPDIR)/signbitf.Po
-	-rm -f lib/$(DEPDIR)/signbitl.Po
-	-rm -f lib/$(DEPDIR)/snprintf.Po
-	-rm -f lib/$(DEPDIR)/vasnprintf.Po
-	-rm -f lib/$(DEPDIR)/vsnprintf.Po
-	-rm -f lib/$(DEPDIR)/wctype-h.Po
-	-rm -f lib/$(DEPDIR)/wcwidth.Po
-	-rm -f lib/$(DEPDIR)/xsize.Po
-	-rm -f lib/uniwidth/$(DEPDIR)/width.Po
+		-rm -f lib/$(DEPDIR)/libgnu_a-asnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-float.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-fprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-free.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-frexp.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-frexpl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-fseterr.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnan.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnand.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnanf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-isnanl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-itold.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-localcharset.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-math.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-memchr.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-args.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-frexp.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-frexpl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-printf-parse.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitd.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-signbitl.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-snprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-stdio-read.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-stdio-write.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-unistd.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-vasnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-vsnprintf.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-wctype-h.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-wcwidth.Po
+	-rm -f lib/$(DEPDIR)/libgnu_a-xsize.Po
+	-rm -f lib/uniwidth/$(DEPDIR)/libgnu_a-width.Po
 	-rm -f src/devices/grodvi/$(DEPDIR)/dvi.Po
 	-rm -f src/devices/grohtml/$(DEPDIR)/html-table.Po
 	-rm -f src/devices/grohtml/$(DEPDIR)/html-text.Po
@@ -10319,7 +12449,7 @@
 mostlyclean-am: mostlyclean-compile mostlyclean-generic \
 	mostlyclean-local
 
-@BUILD_INFODOC_FALSE@pdf: pdf-am
+pdf: pdf-am
 
 pdf-am:
 
@@ -10328,8 +12458,8 @@
 ps-am:
 
 uninstall-am: uninstall-binPROGRAMS uninstall-binSCRIPTS \
-	uninstall-devX10012fontDATA uninstall-devX100fontDATA \
-	uninstall-devX7512fontDATA uninstall-devX75fontDATA \
+	uninstall-devX100_12_fontDATA uninstall-devX100_fontDATA \
+	uninstall-devX75_12_fontDATA uninstall-devX75_fontDATA \
 	uninstall-devasciifontDATA uninstall-devcp1047fontDATA \
 	uninstall-devdvifontDATA uninstall-devdvigenDATA \
 	uninstall-devhtmlfontDATA uninstall-devlatin1fontDATA \
@@ -10339,15 +12469,14 @@
 	uninstall-dist_chemexampleDATA uninstall-dist_chempicDATA \
 	uninstall-dist_devlj4fontDATA uninstall-dist_devlj4fontgenDATA \
 	uninstall-dist_devpsfontDATA uninstall-dist_devpsgenDATA \
-	uninstall-dist_docexamplesDATA uninstall-dist_glilypondDATA \
-	uninstall-dist_gpinyinDATA uninstall-dist_grogDATA \
-	uninstall-dist_hdtblexampleDATA uninstall-dist_localtmacDATA \
-	uninstall-dist_mmDATA uninstall-dist_mmexampleDATA \
-	uninstall-dist_momexampleDATA uninstall-dist_momtmacDATA \
-	uninstall-dist_olddevpsfontDATA uninstall-dist_otherdocDATA \
-	uninstall-dist_pdfmarktmacDATA uninstall-dist_tmacDATA \
-	uninstall-dist_tmacmmDATA uninstall-grofferDATA \
-	uninstall-groffoptsDATA uninstall-hdtbltmacDATA \
+	uninstall-dist_docexamplesDATA uninstall-dist_hdtblexampleDATA \
+	uninstall-dist_hdtbltmacDATA uninstall-dist_localtmacDATA \
+	uninstall-dist_mdocDATA uninstall-dist_mmDATA \
+	uninstall-dist_mmexampleDATA uninstall-dist_momexampleDATA \
+	uninstall-dist_momtmacDATA uninstall-dist_olddevpsfontDATA \
+	uninstall-dist_otherdocDATA uninstall-dist_pdfmarktmacDATA \
+	uninstall-dist_rfc1345tmacDATA uninstall-dist_sboxestmacDATA \
+	uninstall-dist_tmacDATA uninstall-dist_tmacmmDATA \
 	uninstall-htmlpicDATA uninstall-local uninstall-man \
 	uninstall-momhtmlDATA uninstall-nobase_binPROGRAMS \
 	uninstall-nodist_chemexample122DATA \
@@ -10356,73 +12485,73 @@
 	uninstall-nodist_docexamplesDATA \
 	uninstall-nodist_docpdfdocDATA \
 	uninstall-nodist_hdtblexampleDATA \
-	uninstall-nodist_htmlexamplesDATA uninstall-nodist_mdocDATA \
 	uninstall-nodist_momprocessedexampleDATA \
 	uninstall-nodist_otherdocDATA \
-	uninstall-nodist_pdfmarkpdfdocDATA uninstall-nodist_tmacDATA \
+	uninstall-nodist_pdfmarkpdfdocDATA \
+	uninstall-nodist_sboxesotherdocDATA \
+	uninstall-nodist_sboxespdfdocDATA uninstall-nodist_tmacDATA \
 	uninstall-prefixexecbinPROGRAMS uninstall-prefixexecbinSCRIPTS
 	@$(NORMAL_INSTALL)
 	$(MAKE) $(AM_MAKEFLAGS) uninstall-hook
 uninstall-man: uninstall-man1 uninstall-man5 uninstall-man7
 
 .MAKE: all check check-am install install-am install-data-am \
-	install-exec-am install-strip uninstall-am
+	install-exec install-exec-am install-strip uninstall-am
 
 .PHONY: CTAGS GTAGS TAGS all all-am am--depfiles am--refresh check \
 	check-TESTS check-am clean clean-binPROGRAMS \
-	clean-checkPROGRAMS clean-cscope clean-generic clean-local \
+	clean-checkPROGRAMS clean-cscope clean-generic \
 	clean-nobase_binPROGRAMS clean-noinstLIBRARIES \
 	clean-prefixexecbinPROGRAMS cscope cscopelist-am ctags \
 	ctags-am dist dist-all dist-bzip2 dist-gzip dist-hook \
-	dist-lzip dist-shar dist-tarZ dist-xz dist-zip distcheck \
-	distclean distclean-compile distclean-generic distclean-hdr \
-	distclean-local distclean-tags distcleancheck distdir \
-	distuninstallcheck dvi dvi-am html html-am info info-am \
-	install install-am install-binPROGRAMS install-binSCRIPTS \
-	install-data install-data-am install-data-hook \
-	install-data-local install-devX10012fontDATA \
-	install-devX100fontDATA install-devX7512fontDATA \
-	install-devX75fontDATA install-devasciifontDATA \
-	install-devcp1047fontDATA install-devdvifontDATA \
-	install-devdvigenDATA install-devhtmlfontDATA \
-	install-devlatin1fontDATA install-devlbpfontDATA \
-	install-devpdffontDATA install-devpdffontencDATA \
-	install-devpdffontmapDATA install-devutf8fontDATA \
-	install-dist_binSCRIPTS install-dist_chemexampleDATA \
-	install-dist_chempicDATA install-dist_devlj4fontDATA \
-	install-dist_devlj4fontgenDATA install-dist_devpsfontDATA \
-	install-dist_devpsgenDATA install-dist_docexamplesDATA \
-	install-dist_glilypondDATA install-dist_gpinyinDATA \
-	install-dist_grogDATA install-dist_hdtblexampleDATA \
-	install-dist_localtmacDATA install-dist_mmDATA \
+	dist-lzip dist-shar dist-tarZ dist-xz dist-zip dist-zstd \
+	distcheck distclean distclean-compile distclean-generic \
+	distclean-hdr distclean-local distclean-tags distcleancheck \
+	distdir distuninstallcheck dvi dvi-am html html-am info \
+	info-am install install-am install-binPROGRAMS \
+	install-binSCRIPTS install-data install-data-am \
+	install-data-hook install-data-local \
+	install-devX100_12_fontDATA install-devX100_fontDATA \
+	install-devX75_12_fontDATA install-devX75_fontDATA \
+	install-devasciifontDATA install-devcp1047fontDATA \
+	install-devdvifontDATA install-devdvigenDATA \
+	install-devhtmlfontDATA install-devlatin1fontDATA \
+	install-devlbpfontDATA install-devpdffontDATA \
+	install-devpdffontencDATA install-devpdffontmapDATA \
+	install-devutf8fontDATA install-dist_binSCRIPTS \
+	install-dist_chemexampleDATA install-dist_chempicDATA \
+	install-dist_devlj4fontDATA install-dist_devlj4fontgenDATA \
+	install-dist_devpsfontDATA install-dist_devpsgenDATA \
+	install-dist_docexamplesDATA install-dist_hdtblexampleDATA \
+	install-dist_hdtbltmacDATA install-dist_localtmacDATA \
+	install-dist_mdocDATA install-dist_mmDATA \
 	install-dist_mmexampleDATA install-dist_momexampleDATA \
 	install-dist_momtmacDATA install-dist_olddevpsfontDATA \
 	install-dist_otherdocDATA install-dist_pdfmarktmacDATA \
+	install-dist_rfc1345tmacDATA install-dist_sboxestmacDATA \
 	install-dist_tmacDATA install-dist_tmacmmDATA install-dvi \
 	install-dvi-am install-exec install-exec-am install-exec-hook \
-	install-grofferDATA install-groffoptsDATA \
-	install-hdtbltmacDATA install-html install-html-am \
-	install-html-local install-htmlpicDATA install-info \
-	install-info-am install-man install-man1 install-man5 \
-	install-man7 install-momhtmlDATA install-nobase_binPROGRAMS \
-	install-nodist_chemexample122DATA \
+	install-html install-html-am install-html-local \
+	install-htmlpicDATA install-info install-info-am install-man \
+	install-man1 install-man5 install-man7 install-momhtmlDATA \
+	install-nobase_binPROGRAMS install-nodist_chemexample122DATA \
 	install-nodist_chemexampleDATA install-nodist_devlj4fontDATA \
 	install-nodist_devpsfontDATA install-nodist_docexamplesDATA \
 	install-nodist_docpdfdocDATA install-nodist_hdtblexampleDATA \
-	install-nodist_htmlexamplesDATA install-nodist_mdocDATA \
 	install-nodist_momprocessedexampleDATA \
 	install-nodist_otherdocDATA install-nodist_pdfmarkpdfdocDATA \
-	install-nodist_tmacDATA install-pdf install-pdf-am \
-	install-pdf-local install-prefixexecbinPROGRAMS \
-	install-prefixexecbinSCRIPTS install-ps install-ps-am \
-	install-strip installcheck installcheck-am installdirs \
-	maintainer-clean maintainer-clean-generic \
-	maintainer-clean-local mostlyclean mostlyclean-compile \
-	mostlyclean-generic mostlyclean-local pdf pdf-am ps ps-am \
-	recheck tags tags-am uninstall uninstall-am \
+	install-nodist_sboxesotherdocDATA \
+	install-nodist_sboxespdfdocDATA install-nodist_tmacDATA \
+	install-pdf install-pdf-am install-pdf-local \
+	install-prefixexecbinPROGRAMS install-prefixexecbinSCRIPTS \
+	install-ps install-ps-am install-strip installcheck \
+	installcheck-am installdirs maintainer-clean \
+	maintainer-clean-generic maintainer-clean-local mostlyclean \
+	mostlyclean-compile mostlyclean-generic mostlyclean-local pdf \
+	pdf-am ps ps-am recheck tags tags-am uninstall uninstall-am \
 	uninstall-binPROGRAMS uninstall-binSCRIPTS \
-	uninstall-devX10012fontDATA uninstall-devX100fontDATA \
-	uninstall-devX7512fontDATA uninstall-devX75fontDATA \
+	uninstall-devX100_12_fontDATA uninstall-devX100_fontDATA \
+	uninstall-devX75_12_fontDATA uninstall-devX75_fontDATA \
 	uninstall-devasciifontDATA uninstall-devcp1047fontDATA \
 	uninstall-devdvifontDATA uninstall-devdvigenDATA \
 	uninstall-devhtmlfontDATA uninstall-devlatin1fontDATA \
@@ -10432,17 +12561,16 @@
 	uninstall-dist_chemexampleDATA uninstall-dist_chempicDATA \
 	uninstall-dist_devlj4fontDATA uninstall-dist_devlj4fontgenDATA \
 	uninstall-dist_devpsfontDATA uninstall-dist_devpsgenDATA \
-	uninstall-dist_docexamplesDATA uninstall-dist_glilypondDATA \
-	uninstall-dist_gpinyinDATA uninstall-dist_grogDATA \
-	uninstall-dist_hdtblexampleDATA uninstall-dist_localtmacDATA \
-	uninstall-dist_mmDATA uninstall-dist_mmexampleDATA \
-	uninstall-dist_momexampleDATA uninstall-dist_momtmacDATA \
-	uninstall-dist_olddevpsfontDATA uninstall-dist_otherdocDATA \
-	uninstall-dist_pdfmarktmacDATA uninstall-dist_tmacDATA \
-	uninstall-dist_tmacmmDATA uninstall-grofferDATA \
-	uninstall-groffoptsDATA uninstall-hdtbltmacDATA uninstall-hook \
-	uninstall-htmlpicDATA uninstall-local uninstall-man \
-	uninstall-man1 uninstall-man5 uninstall-man7 \
+	uninstall-dist_docexamplesDATA uninstall-dist_hdtblexampleDATA \
+	uninstall-dist_hdtbltmacDATA uninstall-dist_localtmacDATA \
+	uninstall-dist_mdocDATA uninstall-dist_mmDATA \
+	uninstall-dist_mmexampleDATA uninstall-dist_momexampleDATA \
+	uninstall-dist_momtmacDATA uninstall-dist_olddevpsfontDATA \
+	uninstall-dist_otherdocDATA uninstall-dist_pdfmarktmacDATA \
+	uninstall-dist_rfc1345tmacDATA uninstall-dist_sboxestmacDATA \
+	uninstall-dist_tmacDATA uninstall-dist_tmacmmDATA \
+	uninstall-hook uninstall-htmlpicDATA uninstall-local \
+	uninstall-man uninstall-man1 uninstall-man5 uninstall-man7 \
 	uninstall-momhtmlDATA uninstall-nobase_binPROGRAMS \
 	uninstall-nodist_chemexample122DATA \
 	uninstall-nodist_chemexampleDATA \
@@ -10450,10 +12578,11 @@
 	uninstall-nodist_docexamplesDATA \
 	uninstall-nodist_docpdfdocDATA \
 	uninstall-nodist_hdtblexampleDATA \
-	uninstall-nodist_htmlexamplesDATA uninstall-nodist_mdocDATA \
 	uninstall-nodist_momprocessedexampleDATA \
 	uninstall-nodist_otherdocDATA \
-	uninstall-nodist_pdfmarkpdfdocDATA uninstall-nodist_tmacDATA \
+	uninstall-nodist_pdfmarkpdfdocDATA \
+	uninstall-nodist_sboxesotherdocDATA \
+	uninstall-nodist_sboxespdfdocDATA uninstall-nodist_tmacDATA \
 	uninstall-prefixexecbinPROGRAMS uninstall-prefixexecbinSCRIPTS
 
 .PRECIOUS: Makefile
@@ -10462,20 +12591,40 @@
 # We need the following in order to create <alloca.h> when the system
 # doesn't have one that works with the given compiler.
 @GL_GENERATE_ALLOCA_H_TRUE@lib/alloca.h: lib/alloca.in.h $(top_builddir)/config.status
-@GL_GENERATE_ALLOCA_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_ALLOCA_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-@GL_GENERATE_ALLOCA_H_TRUE@	  cat $(top_srcdir)/lib/alloca.in.h; \
-@GL_GENERATE_ALLOCA_H_TRUE@	} > $@-t && \
-@GL_GENERATE_ALLOCA_H_TRUE@	mv -f $@-t $@
+@GL_GENERATE_ALLOCA_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_ALLOCA_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_ALLOCA_H_TRUE@	  -e 's|@''HAVE_ALLOCA_H''@|$(HAVE_ALLOCA_H)|g' \
+@GL_GENERATE_ALLOCA_H_TRUE@	  $(top_srcdir)/lib/alloca.in.h > $@-t
+@GL_GENERATE_ALLOCA_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_ALLOCA_H_FALSE@lib/alloca.h: $(top_builddir)/config.status
 @GL_GENERATE_ALLOCA_H_FALSE@	rm -f $@
 
+# We need the following in order to create <assert.h> when the system
+# doesn't have one that works with the given compiler.
+@GL_GENERATE_ASSERT_H_TRUE@lib/assert.h: lib/assert.in.h lib/verify.h $(top_builddir)/config.status
+@GL_GENERATE_ASSERT_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_ASSERT_H_TRUE@	$(gl_V_at){ $(SED_HEADER_STDOUT) \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|@''NEXT_ASSERT_H''@|$(NEXT_ASSERT_H)|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      < $(top_srcdir)/lib/assert.in.h && \
+@GL_GENERATE_ASSERT_H_TRUE@	  sed -e '/@assert.h omit start@/,/@assert.h omit end@/d' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|_gl_verify|_gl_static_assert|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|_GL_VERIFY|_GL_STATIC_ASSERT|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      -e 's|_GL$_STATIC_ASSERT_H$|_GL\1|g' \
+@GL_GENERATE_ASSERT_H_TRUE@	      < $(top_srcdir)/lib/verify.h; \
+@GL_GENERATE_ASSERT_H_TRUE@	} > $@-t
+@GL_GENERATE_ASSERT_H_TRUE@	$(AM_V_at)mv $@-t $@
+@GL_GENERATE_ASSERT_H_FALSE@lib/assert.h: $(top_builddir)/config.status
+@GL_GENERATE_ASSERT_H_FALSE@	rm -f $@
+
 # We need the following in order to create <errno.h> when the system
 # doesn't have one that is POSIX compliant.
 @GL_GENERATE_ERRNO_H_TRUE@lib/errno.h: lib/errno.in.h $(top_builddir)/config.status
-@GL_GENERATE_ERRNO_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_ERRNO_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-@GL_GENERATE_ERRNO_H_TRUE@	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+@GL_GENERATE_ERRNO_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_ERRNO_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -10486,151 +12635,189 @@
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''ENOLINK_VALUE''@|$(ENOLINK_VALUE)|g' \
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''EOVERFLOW_HIDDEN''@|$(EOVERFLOW_HIDDEN)|g' \
 @GL_GENERATE_ERRNO_H_TRUE@	      -e 's|@''EOVERFLOW_VALUE''@|$(EOVERFLOW_VALUE)|g' \
-@GL_GENERATE_ERRNO_H_TRUE@	      < $(top_srcdir)/lib/errno.in.h; \
-@GL_GENERATE_ERRNO_H_TRUE@	} > $@-t && \
-@GL_GENERATE_ERRNO_H_TRUE@	mv $@-t $@
+@GL_GENERATE_ERRNO_H_TRUE@	      $(top_srcdir)/lib/errno.in.h > $@-t
+@GL_GENERATE_ERRNO_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_ERRNO_H_FALSE@lib/errno.h: $(top_builddir)/config.status
 @GL_GENERATE_ERRNO_H_FALSE@	rm -f $@
 
 # We need the following in order to create <float.h> when the system
 # doesn't have one that works with the given compiler.
 @GL_GENERATE_FLOAT_H_TRUE@lib/float.h: lib/float.in.h $(top_builddir)/config.status
-@GL_GENERATE_FLOAT_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_FLOAT_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-@GL_GENERATE_FLOAT_H_TRUE@	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+@GL_GENERATE_FLOAT_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_FLOAT_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 @GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 @GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 @GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 @GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''NEXT_FLOAT_H''@|$(NEXT_FLOAT_H)|g' \
 @GL_GENERATE_FLOAT_H_TRUE@	      -e 's|@''REPLACE_ITOLD''@|$(REPLACE_ITOLD)|g' \
-@GL_GENERATE_FLOAT_H_TRUE@	      < $(top_srcdir)/lib/float.in.h; \
-@GL_GENERATE_FLOAT_H_TRUE@	} > $@-t && \
-@GL_GENERATE_FLOAT_H_TRUE@	mv $@-t $@
+@GL_GENERATE_FLOAT_H_TRUE@	      $(top_srcdir)/lib/float.in.h > $@-t
+@GL_GENERATE_FLOAT_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_FLOAT_H_FALSE@lib/float.h: $(top_builddir)/config.status
 @GL_GENERATE_FLOAT_H_FALSE@	rm -f $@
 
+# We need the following in order to create <inttypes.h> when the system
+# doesn't have one that works with the given compiler.
+lib/inttypes.h: lib/inttypes.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(WARN_ON_USE_H) $(ARG_NONNULL_H)
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's/@''HAVE_INTTYPES_H''@/$(HAVE_INTTYPES_H)/g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_INTTYPES_H''@|$(NEXT_INTTYPES_H)|g' \
+	      -e 's/@''APPLE_UNIVERSAL_BUILD''@/$(APPLE_UNIVERSAL_BUILD)/g' \
+	      -e 's/@''PRIPTR_PREFIX''@/$(PRIPTR_PREFIX)/g' \
+	      -e 's/@''GNULIB_IMAXABS''@/$(GL_GNULIB_IMAXABS)/g' \
+	      -e 's/@''GNULIB_IMAXDIV''@/$(GL_GNULIB_IMAXDIV)/g' \
+	      -e 's/@''GNULIB_STRTOIMAX''@/$(GL_GNULIB_STRTOIMAX)/g' \
+	      -e 's/@''GNULIB_STRTOUMAX''@/$(GL_GNULIB_STRTOUMAX)/g' \
+	      -e 's/@''HAVE_DECL_IMAXABS''@/$(HAVE_DECL_IMAXABS)/g' \
+	      -e 's/@''HAVE_DECL_IMAXDIV''@/$(HAVE_DECL_IMAXDIV)/g' \
+	      -e 's/@''HAVE_DECL_STRTOIMAX''@/$(HAVE_DECL_STRTOIMAX)/g' \
+	      -e 's/@''HAVE_DECL_STRTOUMAX''@/$(HAVE_DECL_STRTOUMAX)/g' \
+	      -e 's/@''HAVE_IMAXDIV_T''@/$(HAVE_IMAXDIV_T)/g' \
+	      -e 's/@''REPLACE_IMAXABS''@/$(REPLACE_IMAXABS)/g' \
+	      -e 's/@''REPLACE_IMAXDIV''@/$(REPLACE_IMAXDIV)/g' \
+	      -e 's/@''REPLACE_STRTOIMAX''@/$(REPLACE_STRTOIMAX)/g' \
+	      -e 's/@''REPLACE_STRTOUMAX''@/$(REPLACE_STRTOUMAX)/g' \
+	      -e 's/@''INT32_MAX_LT_INTMAX_MAX''@/$(INT32_MAX_LT_INTMAX_MAX)/g' \
+	      -e 's/@''INT64_MAX_EQ_LONG_MAX''@/$(INT64_MAX_EQ_LONG_MAX)/g' \
+	      -e 's/@''UINT32_MAX_LT_UINTMAX_MAX''@/$(UINT32_MAX_LT_UINTMAX_MAX)/g' \
+	      -e 's/@''UINT64_MAX_EQ_ULONG_MAX''@/$(UINT64_MAX_EQ_ULONG_MAX)/g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      $(top_srcdir)/lib/inttypes.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
+
 # We need the following in order to create <limits.h> when the system
 # doesn't have one that is compatible with GNU.
 @GL_GENERATE_LIMITS_H_TRUE@lib/limits.h: lib/limits.in.h $(top_builddir)/config.status
-@GL_GENERATE_LIMITS_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_LIMITS_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-@GL_GENERATE_LIMITS_H_TRUE@	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+@GL_GENERATE_LIMITS_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_LIMITS_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_LIMITS_H_TRUE@	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 @GL_GENERATE_LIMITS_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 @GL_GENERATE_LIMITS_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 @GL_GENERATE_LIMITS_H_TRUE@	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 @GL_GENERATE_LIMITS_H_TRUE@	      -e 's|@''NEXT_LIMITS_H''@|$(NEXT_LIMITS_H)|g' \
-@GL_GENERATE_LIMITS_H_TRUE@	      < $(top_srcdir)/lib/limits.in.h; \
-@GL_GENERATE_LIMITS_H_TRUE@	} > $@-t && \
-@GL_GENERATE_LIMITS_H_TRUE@	mv $@-t $@
+@GL_GENERATE_LIMITS_H_TRUE@	      $(top_srcdir)/lib/limits.in.h > $@-t
+@GL_GENERATE_LIMITS_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_LIMITS_H_FALSE@lib/limits.h: $(top_builddir)/config.status
 @GL_GENERATE_LIMITS_H_FALSE@	rm -f $@
 
 # We need the following in order to create <math.h> when the system
 # doesn't have one that works with the given compiler.
 lib/math.h: lib/math.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT_AS_FIRST_DIRECTIVE''@|$(INCLUDE_NEXT_AS_FIRST_DIRECTIVE)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_AS_FIRST_DIRECTIVE_MATH_H''@|$(NEXT_AS_FIRST_DIRECTIVE_MATH_H)|g' \
-	      -e 's/@''GNULIB_ACOSF''@/$(GNULIB_ACOSF)/g' \
-	      -e 's/@''GNULIB_ACOSL''@/$(GNULIB_ACOSL)/g' \
-	      -e 's/@''GNULIB_ASINF''@/$(GNULIB_ASINF)/g' \
-	      -e 's/@''GNULIB_ASINL''@/$(GNULIB_ASINL)/g' \
-	      -e 's/@''GNULIB_ATANF''@/$(GNULIB_ATANF)/g' \
-	      -e 's/@''GNULIB_ATANL''@/$(GNULIB_ATANL)/g' \
-	      -e 's/@''GNULIB_ATAN2F''@/$(GNULIB_ATAN2F)/g' \
-	      -e 's/@''GNULIB_CBRT''@/$(GNULIB_CBRT)/g' \
-	      -e 's/@''GNULIB_CBRTF''@/$(GNULIB_CBRTF)/g' \
-	      -e 's/@''GNULIB_CBRTL''@/$(GNULIB_CBRTL)/g' \
-	      -e 's/@''GNULIB_CEIL''@/$(GNULIB_CEIL)/g' \
-	      -e 's/@''GNULIB_CEILF''@/$(GNULIB_CEILF)/g' \
-	      -e 's/@''GNULIB_CEILL''@/$(GNULIB_CEILL)/g' \
-	      -e 's/@''GNULIB_COPYSIGN''@/$(GNULIB_COPYSIGN)/g' \
-	      -e 's/@''GNULIB_COPYSIGNF''@/$(GNULIB_COPYSIGNF)/g' \
-	      -e 's/@''GNULIB_COPYSIGNL''@/$(GNULIB_COPYSIGNL)/g' \
-	      -e 's/@''GNULIB_COSF''@/$(GNULIB_COSF)/g' \
-	      -e 's/@''GNULIB_COSL''@/$(GNULIB_COSL)/g' \
-	      -e 's/@''GNULIB_COSHF''@/$(GNULIB_COSHF)/g' \
-	      -e 's/@''GNULIB_EXPF''@/$(GNULIB_EXPF)/g' \
-	      -e 's/@''GNULIB_EXPL''@/$(GNULIB_EXPL)/g' \
-	      -e 's/@''GNULIB_EXP2''@/$(GNULIB_EXP2)/g' \
-	      -e 's/@''GNULIB_EXP2F''@/$(GNULIB_EXP2F)/g' \
-	      -e 's/@''GNULIB_EXP2L''@/$(GNULIB_EXP2L)/g' \
-	      -e 's/@''GNULIB_EXPM1''@/$(GNULIB_EXPM1)/g' \
-	      -e 's/@''GNULIB_EXPM1F''@/$(GNULIB_EXPM1F)/g' \
-	      -e 's/@''GNULIB_EXPM1L''@/$(GNULIB_EXPM1L)/g' \
-	      -e 's/@''GNULIB_FABSF''@/$(GNULIB_FABSF)/g' \
-	      -e 's/@''GNULIB_FABSL''@/$(GNULIB_FABSL)/g' \
-	      -e 's/@''GNULIB_FLOOR''@/$(GNULIB_FLOOR)/g' \
-	      -e 's/@''GNULIB_FLOORF''@/$(GNULIB_FLOORF)/g' \
-	      -e 's/@''GNULIB_FLOORL''@/$(GNULIB_FLOORL)/g' \
-	      -e 's/@''GNULIB_FMA''@/$(GNULIB_FMA)/g' \
-	      -e 's/@''GNULIB_FMAF''@/$(GNULIB_FMAF)/g' \
-	      -e 's/@''GNULIB_FMAL''@/$(GNULIB_FMAL)/g' \
-	      -e 's/@''GNULIB_FMOD''@/$(GNULIB_FMOD)/g' \
-	      -e 's/@''GNULIB_FMODF''@/$(GNULIB_FMODF)/g' \
-	      -e 's/@''GNULIB_FMODL''@/$(GNULIB_FMODL)/g' \
-	      -e 's/@''GNULIB_FREXPF''@/$(GNULIB_FREXPF)/g' \
-	      -e 's/@''GNULIB_FREXP''@/$(GNULIB_FREXP)/g' \
-	      -e 's/@''GNULIB_FREXPL''@/$(GNULIB_FREXPL)/g' \
-	      -e 's/@''GNULIB_HYPOT''@/$(GNULIB_HYPOT)/g' \
-	      -e 's/@''GNULIB_HYPOTF''@/$(GNULIB_HYPOTF)/g' \
-	      -e 's/@''GNULIB_HYPOTL''@/$(GNULIB_HYPOTL)/g' \
+	      -e 's/@''GNULIB_ACOSF''@/$(GL_GNULIB_ACOSF)/g' \
+	      -e 's/@''GNULIB_ACOSL''@/$(GL_GNULIB_ACOSL)/g' \
+	      -e 's/@''GNULIB_ASINF''@/$(GL_GNULIB_ASINF)/g' \
+	      -e 's/@''GNULIB_ASINL''@/$(GL_GNULIB_ASINL)/g' \
+	      -e 's/@''GNULIB_ATANF''@/$(GL_GNULIB_ATANF)/g' \
+	      -e 's/@''GNULIB_ATANL''@/$(GL_GNULIB_ATANL)/g' \
+	      -e 's/@''GNULIB_ATAN2F''@/$(GL_GNULIB_ATAN2F)/g' \
+	      -e 's/@''GNULIB_CBRT''@/$(GL_GNULIB_CBRT)/g' \
+	      -e 's/@''GNULIB_CBRTF''@/$(GL_GNULIB_CBRTF)/g' \
+	      -e 's/@''GNULIB_CBRTL''@/$(GL_GNULIB_CBRTL)/g' \
+	      -e 's/@''GNULIB_CEIL''@/$(GL_GNULIB_CEIL)/g' \
+	      -e 's/@''GNULIB_CEILF''@/$(GL_GNULIB_CEILF)/g' \
+	      -e 's/@''GNULIB_CEILL''@/$(GL_GNULIB_CEILL)/g' \
+	      -e 's/@''GNULIB_COPYSIGN''@/$(GL_GNULIB_COPYSIGN)/g' \
+	      -e 's/@''GNULIB_COPYSIGNF''@/$(GL_GNULIB_COPYSIGNF)/g' \
+	      -e 's/@''GNULIB_COPYSIGNL''@/$(GL_GNULIB_COPYSIGNL)/g' \
+	      -e 's/@''GNULIB_COSF''@/$(GL_GNULIB_COSF)/g' \
+	      -e 's/@''GNULIB_COSL''@/$(GL_GNULIB_COSL)/g' \
+	      -e 's/@''GNULIB_COSHF''@/$(GL_GNULIB_COSHF)/g' \
+	      -e 's/@''GNULIB_EXPF''@/$(GL_GNULIB_EXPF)/g' \
+	      -e 's/@''GNULIB_EXPL''@/$(GL_GNULIB_EXPL)/g' \
+	      -e 's/@''GNULIB_EXP2''@/$(GL_GNULIB_EXP2)/g' \
+	      -e 's/@''GNULIB_EXP2F''@/$(GL_GNULIB_EXP2F)/g' \
+	      -e 's/@''GNULIB_EXP2L''@/$(GL_GNULIB_EXP2L)/g' \
+	      -e 's/@''GNULIB_EXPM1''@/$(GL_GNULIB_EXPM1)/g' \
+	      -e 's/@''GNULIB_EXPM1F''@/$(GL_GNULIB_EXPM1F)/g' \
+	      -e 's/@''GNULIB_EXPM1L''@/$(GL_GNULIB_EXPM1L)/g' \
+	      -e 's/@''GNULIB_FABSF''@/$(GL_GNULIB_FABSF)/g' \
+	      -e 's/@''GNULIB_FABSL''@/$(GL_GNULIB_FABSL)/g' \
+	      -e 's/@''GNULIB_FLOOR''@/$(GL_GNULIB_FLOOR)/g' \
+	      -e 's/@''GNULIB_FLOORF''@/$(GL_GNULIB_FLOORF)/g' \
+	      -e 's/@''GNULIB_FLOORL''@/$(GL_GNULIB_FLOORL)/g' \
+	      -e 's/@''GNULIB_FMA''@/$(GL_GNULIB_FMA)/g' \
+	      -e 's/@''GNULIB_FMAF''@/$(GL_GNULIB_FMAF)/g' \
+	      -e 's/@''GNULIB_FMAL''@/$(GL_GNULIB_FMAL)/g' \
+	      -e 's/@''GNULIB_FMOD''@/$(GL_GNULIB_FMOD)/g' \
+	      -e 's/@''GNULIB_FMODF''@/$(GL_GNULIB_FMODF)/g' \
+	      -e 's/@''GNULIB_FMODL''@/$(GL_GNULIB_FMODL)/g' \
+	      -e 's/@''GNULIB_FREXPF''@/$(GL_GNULIB_FREXPF)/g' \
+	      -e 's/@''GNULIB_FREXP''@/$(GL_GNULIB_FREXP)/g' \
+	      -e 's/@''GNULIB_FREXPL''@/$(GL_GNULIB_FREXPL)/g' \
+	      -e 's/@''GNULIB_HYPOT''@/$(GL_GNULIB_HYPOT)/g' \
+	      -e 's/@''GNULIB_HYPOTF''@/$(GL_GNULIB_HYPOTF)/g' \
+	      -e 's/@''GNULIB_HYPOTL''@/$(GL_GNULIB_HYPOTL)/g' \
 	      < $(top_srcdir)/lib/math.in.h | \
-	  sed -e 's/@''GNULIB_ILOGB''@/$(GNULIB_ILOGB)/g' \
-	      -e 's/@''GNULIB_ILOGBF''@/$(GNULIB_ILOGBF)/g' \
-	      -e 's/@''GNULIB_ILOGBL''@/$(GNULIB_ILOGBL)/g' \
-	      -e 's/@''GNULIB_ISFINITE''@/$(GNULIB_ISFINITE)/g' \
-	      -e 's/@''GNULIB_ISINF''@/$(GNULIB_ISINF)/g' \
-	      -e 's/@''GNULIB_ISNAN''@/$(GNULIB_ISNAN)/g' \
-	      -e 's/@''GNULIB_ISNANF''@/$(GNULIB_ISNANF)/g' \
-	      -e 's/@''GNULIB_ISNAND''@/$(GNULIB_ISNAND)/g' \
-	      -e 's/@''GNULIB_ISNANL''@/$(GNULIB_ISNANL)/g' \
-	      -e 's/@''GNULIB_LDEXPF''@/$(GNULIB_LDEXPF)/g' \
-	      -e 's/@''GNULIB_LDEXPL''@/$(GNULIB_LDEXPL)/g' \
-	      -e 's/@''GNULIB_LOG''@/$(GNULIB_LOG)/g' \
-	      -e 's/@''GNULIB_LOGF''@/$(GNULIB_LOGF)/g' \
-	      -e 's/@''GNULIB_LOGL''@/$(GNULIB_LOGL)/g' \
-	      -e 's/@''GNULIB_LOG10''@/$(GNULIB_LOG10)/g' \
-	      -e 's/@''GNULIB_LOG10F''@/$(GNULIB_LOG10F)/g' \
-	      -e 's/@''GNULIB_LOG10L''@/$(GNULIB_LOG10L)/g' \
-	      -e 's/@''GNULIB_LOG1P''@/$(GNULIB_LOG1P)/g' \
-	      -e 's/@''GNULIB_LOG1PF''@/$(GNULIB_LOG1PF)/g' \
-	      -e 's/@''GNULIB_LOG1PL''@/$(GNULIB_LOG1PL)/g' \
-	      -e 's/@''GNULIB_LOG2''@/$(GNULIB_LOG2)/g' \
-	      -e 's/@''GNULIB_LOG2F''@/$(GNULIB_LOG2F)/g' \
-	      -e 's/@''GNULIB_LOG2L''@/$(GNULIB_LOG2L)/g' \
-	      -e 's/@''GNULIB_LOGB''@/$(GNULIB_LOGB)/g' \
-	      -e 's/@''GNULIB_LOGBF''@/$(GNULIB_LOGBF)/g' \
-	      -e 's/@''GNULIB_LOGBL''@/$(GNULIB_LOGBL)/g' \
-	      -e 's/@''GNULIB_MODF''@/$(GNULIB_MODF)/g' \
-	      -e 's/@''GNULIB_MODFF''@/$(GNULIB_MODFF)/g' \
-	      -e 's/@''GNULIB_MODFL''@/$(GNULIB_MODFL)/g' \
-	      -e 's/@''GNULIB_POWF''@/$(GNULIB_POWF)/g' \
-	      -e 's/@''GNULIB_REMAINDER''@/$(GNULIB_REMAINDER)/g' \
-	      -e 's/@''GNULIB_REMAINDERF''@/$(GNULIB_REMAINDERF)/g' \
-	      -e 's/@''GNULIB_REMAINDERL''@/$(GNULIB_REMAINDERL)/g' \
-	      -e 's/@''GNULIB_RINT''@/$(GNULIB_RINT)/g' \
-	      -e 's/@''GNULIB_RINTF''@/$(GNULIB_RINTF)/g' \
-	      -e 's/@''GNULIB_RINTL''@/$(GNULIB_RINTL)/g' \
-	      -e 's/@''GNULIB_ROUND''@/$(GNULIB_ROUND)/g' \
-	      -e 's/@''GNULIB_ROUNDF''@/$(GNULIB_ROUNDF)/g' \
-	      -e 's/@''GNULIB_ROUNDL''@/$(GNULIB_ROUNDL)/g' \
-	      -e 's/@''GNULIB_SIGNBIT''@/$(GNULIB_SIGNBIT)/g' \
-	      -e 's/@''GNULIB_SINF''@/$(GNULIB_SINF)/g' \
-	      -e 's/@''GNULIB_SINL''@/$(GNULIB_SINL)/g' \
-	      -e 's/@''GNULIB_SINHF''@/$(GNULIB_SINHF)/g' \
-	      -e 's/@''GNULIB_SQRTF''@/$(GNULIB_SQRTF)/g' \
-	      -e 's/@''GNULIB_SQRTL''@/$(GNULIB_SQRTL)/g' \
-	      -e 's/@''GNULIB_TANF''@/$(GNULIB_TANF)/g' \
-	      -e 's/@''GNULIB_TANL''@/$(GNULIB_TANL)/g' \
-	      -e 's/@''GNULIB_TANHF''@/$(GNULIB_TANHF)/g' \
-	      -e 's/@''GNULIB_TRUNC''@/$(GNULIB_TRUNC)/g' \
-	      -e 's/@''GNULIB_TRUNCF''@/$(GNULIB_TRUNCF)/g' \
-	      -e 's/@''GNULIB_TRUNCL''@/$(GNULIB_TRUNCL)/g' \
+	  sed -e 's/@''GNULIB_ILOGB''@/$(GL_GNULIB_ILOGB)/g' \
+	      -e 's/@''GNULIB_ILOGBF''@/$(GL_GNULIB_ILOGBF)/g' \
+	      -e 's/@''GNULIB_ILOGBL''@/$(GL_GNULIB_ILOGBL)/g' \
+	      -e 's/@''GNULIB_ISFINITE''@/$(GL_GNULIB_ISFINITE)/g' \
+	      -e 's/@''GNULIB_ISINF''@/$(GL_GNULIB_ISINF)/g' \
+	      -e 's/@''GNULIB_ISNAN''@/$(GL_GNULIB_ISNAN)/g' \
+	      -e 's/@''GNULIB_ISNANF''@/$(GL_GNULIB_ISNANF)/g' \
+	      -e 's/@''GNULIB_ISNAND''@/$(GL_GNULIB_ISNAND)/g' \
+	      -e 's/@''GNULIB_ISNANL''@/$(GL_GNULIB_ISNANL)/g' \
+	      -e 's/@''GNULIB_LDEXPF''@/$(GL_GNULIB_LDEXPF)/g' \
+	      -e 's/@''GNULIB_LDEXPL''@/$(GL_GNULIB_LDEXPL)/g' \
+	      -e 's/@''GNULIB_LOG''@/$(GL_GNULIB_LOG)/g' \
+	      -e 's/@''GNULIB_LOGF''@/$(GL_GNULIB_LOGF)/g' \
+	      -e 's/@''GNULIB_LOGL''@/$(GL_GNULIB_LOGL)/g' \
+	      -e 's/@''GNULIB_LOG10''@/$(GL_GNULIB_LOG10)/g' \
+	      -e 's/@''GNULIB_LOG10F''@/$(GL_GNULIB_LOG10F)/g' \
+	      -e 's/@''GNULIB_LOG10L''@/$(GL_GNULIB_LOG10L)/g' \
+	      -e 's/@''GNULIB_LOG1P''@/$(GL_GNULIB_LOG1P)/g' \
+	      -e 's/@''GNULIB_LOG1PF''@/$(GL_GNULIB_LOG1PF)/g' \
+	      -e 's/@''GNULIB_LOG1PL''@/$(GL_GNULIB_LOG1PL)/g' \
+	      -e 's/@''GNULIB_LOG2''@/$(GL_GNULIB_LOG2)/g' \
+	      -e 's/@''GNULIB_LOG2F''@/$(GL_GNULIB_LOG2F)/g' \
+	      -e 's/@''GNULIB_LOG2L''@/$(GL_GNULIB_LOG2L)/g' \
+	      -e 's/@''GNULIB_LOGB''@/$(GL_GNULIB_LOGB)/g' \
+	      -e 's/@''GNULIB_LOGBF''@/$(GL_GNULIB_LOGBF)/g' \
+	      -e 's/@''GNULIB_LOGBL''@/$(GL_GNULIB_LOGBL)/g' \
+	      -e 's/@''GNULIB_MODF''@/$(GL_GNULIB_MODF)/g' \
+	      -e 's/@''GNULIB_MODFF''@/$(GL_GNULIB_MODFF)/g' \
+	      -e 's/@''GNULIB_MODFL''@/$(GL_GNULIB_MODFL)/g' \
+	      -e 's/@''GNULIB_POWF''@/$(GL_GNULIB_POWF)/g' \
+	      -e 's/@''GNULIB_REMAINDER''@/$(GL_GNULIB_REMAINDER)/g' \
+	      -e 's/@''GNULIB_REMAINDERF''@/$(GL_GNULIB_REMAINDERF)/g' \
+	      -e 's/@''GNULIB_REMAINDERL''@/$(GL_GNULIB_REMAINDERL)/g' \
+	      -e 's/@''GNULIB_RINT''@/$(GL_GNULIB_RINT)/g' \
+	      -e 's/@''GNULIB_RINTF''@/$(GL_GNULIB_RINTF)/g' \
+	      -e 's/@''GNULIB_RINTL''@/$(GL_GNULIB_RINTL)/g' \
+	      -e 's/@''GNULIB_ROUND''@/$(GL_GNULIB_ROUND)/g' \
+	      -e 's/@''GNULIB_ROUNDF''@/$(GL_GNULIB_ROUNDF)/g' \
+	      -e 's/@''GNULIB_ROUNDL''@/$(GL_GNULIB_ROUNDL)/g' \
+	      -e 's/@''GNULIB_SIGNBIT''@/$(GL_GNULIB_SIGNBIT)/g' \
+	      -e 's/@''GNULIB_SINF''@/$(GL_GNULIB_SINF)/g' \
+	      -e 's/@''GNULIB_SINL''@/$(GL_GNULIB_SINL)/g' \
+	      -e 's/@''GNULIB_SINHF''@/$(GL_GNULIB_SINHF)/g' \
+	      -e 's/@''GNULIB_SQRTF''@/$(GL_GNULIB_SQRTF)/g' \
+	      -e 's/@''GNULIB_SQRTL''@/$(GL_GNULIB_SQRTL)/g' \
+	      -e 's/@''GNULIB_TANF''@/$(GL_GNULIB_TANF)/g' \
+	      -e 's/@''GNULIB_TANL''@/$(GL_GNULIB_TANL)/g' \
+	      -e 's/@''GNULIB_TANHF''@/$(GL_GNULIB_TANHF)/g' \
+	      -e 's/@''GNULIB_TRUNC''@/$(GL_GNULIB_TRUNC)/g' \
+	      -e 's/@''GNULIB_TRUNCF''@/$(GL_GNULIB_TRUNCF)/g' \
+	      -e 's/@''GNULIB_TRUNCL''@/$(GL_GNULIB_TRUNCL)/g' \
+	      -e 's/@''GNULIB_MDA_J0''@/$(GL_GNULIB_MDA_J0)/g' \
+	      -e 's/@''GNULIB_MDA_J1''@/$(GL_GNULIB_MDA_J1)/g' \
+	      -e 's/@''GNULIB_MDA_JN''@/$(GL_GNULIB_MDA_JN)/g' \
+	      -e 's/@''GNULIB_MDA_Y0''@/$(GL_GNULIB_MDA_Y0)/g' \
+	      -e 's/@''GNULIB_MDA_Y1''@/$(GL_GNULIB_MDA_Y1)/g' \
+	      -e 's/@''GNULIB_MDA_YN''@/$(GL_GNULIB_MDA_YN)/g' \
 	  | \
 	  sed -e 's|@''HAVE_ACOSF''@|$(HAVE_ACOSF)|g' \
 	      -e 's|@''HAVE_ACOSL''@|$(HAVE_ACOSL)|g' \
@@ -10741,8 +12928,10 @@
 	      -e 's|@''REPLACE_COSF''@|$(REPLACE_COSF)|g' \
 	      -e 's|@''REPLACE_COSHF''@|$(REPLACE_COSHF)|g' \
 	      -e 's|@''REPLACE_EXPF''@|$(REPLACE_EXPF)|g' \
+	      -e 's|@''REPLACE_EXPL''@|$(REPLACE_EXPL)|g' \
 	      -e 's|@''REPLACE_EXPM1''@|$(REPLACE_EXPM1)|g' \
 	      -e 's|@''REPLACE_EXPM1F''@|$(REPLACE_EXPM1F)|g' \
+	      -e 's|@''REPLACE_EXPM1L''@|$(REPLACE_EXPM1L)|g' \
 	      -e 's|@''REPLACE_EXP2''@|$(REPLACE_EXP2)|g' \
 	      -e 's|@''REPLACE_EXP2L''@|$(REPLACE_EXP2L)|g' \
 	      -e 's|@''REPLACE_FABSL''@|$(REPLACE_FABSL)|g' \
@@ -10792,11 +12981,12 @@
 	      -e 's|@''REPLACE_REMAINDER''@|$(REPLACE_REMAINDER)|g' \
 	      -e 's|@''REPLACE_REMAINDERF''@|$(REPLACE_REMAINDERF)|g' \
 	      -e 's|@''REPLACE_REMAINDERL''@|$(REPLACE_REMAINDERL)|g' \
+	      -e 's|@''REPLACE_RINTL''@|$(REPLACE_RINTL)|g' \
 	      -e 's|@''REPLACE_ROUND''@|$(REPLACE_ROUND)|g' \
 	      -e 's|@''REPLACE_ROUNDF''@|$(REPLACE_ROUNDF)|g' \
 	      -e 's|@''REPLACE_ROUNDL''@|$(REPLACE_ROUNDL)|g' \
 	      -e 's|@''REPLACE_SIGNBIT''@|$(REPLACE_SIGNBIT)|g' \
-	      -e 's|@''REPLACE_SIGNBIT_USING_GCC''@|$(REPLACE_SIGNBIT_USING_GCC)|g' \
+	      -e 's|@''REPLACE_SIGNBIT_USING_BUILTINS''@|$(REPLACE_SIGNBIT_USING_BUILTINS)|g' \
 	      -e 's|@''REPLACE_SINF''@|$(REPLACE_SINF)|g' \
 	      -e 's|@''REPLACE_SINHF''@|$(REPLACE_SINHF)|g' \
 	      -e 's|@''REPLACE_SQRTF''@|$(REPLACE_SQRTF)|g' \
@@ -10808,16 +12998,27 @@
 	      -e 's|@''REPLACE_TRUNCL''@|$(REPLACE_TRUNCL)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
+
+# We need the following in order to create <stdbool.h> when the system
+# doesn't have one that works.
+@GL_GENERATE_STDBOOL_H_TRUE@lib/stdbool.h: lib/stdbool.in.h $(top_builddir)/config.status
+@GL_GENERATE_STDBOOL_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_STDBOOL_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_STDBOOL_H_TRUE@	  -e 's/@''HAVE__BOOL''@/$(HAVE__BOOL)/g' \
+@GL_GENERATE_STDBOOL_H_TRUE@	  $(top_srcdir)/lib/stdbool.in.h > $@-t
+@GL_GENERATE_STDBOOL_H_TRUE@	$(AM_V_at)mv $@-t $@
+@GL_GENERATE_STDBOOL_H_FALSE@lib/stdbool.h: $(top_builddir)/config.status
+@GL_GENERATE_STDBOOL_H_FALSE@	rm -f $@
 
 # We need the following in order to create <stddef.h> when the system
 # doesn't have one that works with the given compiler.
 @GL_GENERATE_STDDEF_H_TRUE@lib/stddef.h: lib/stddef.in.h $(top_builddir)/config.status
-@GL_GENERATE_STDDEF_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_STDDEF_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-@GL_GENERATE_STDDEF_H_TRUE@	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+@GL_GENERATE_STDDEF_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_STDDEF_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -10825,18 +13026,17 @@
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''HAVE_MAX_ALIGN_T''@|$(HAVE_MAX_ALIGN_T)|g' \
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''HAVE_WCHAR_T''@|$(HAVE_WCHAR_T)|g' \
 @GL_GENERATE_STDDEF_H_TRUE@	      -e 's|@''REPLACE_NULL''@|$(REPLACE_NULL)|g' \
-@GL_GENERATE_STDDEF_H_TRUE@	      < $(top_srcdir)/lib/stddef.in.h; \
-@GL_GENERATE_STDDEF_H_TRUE@	} > $@-t && \
-@GL_GENERATE_STDDEF_H_TRUE@	mv $@-t $@
+@GL_GENERATE_STDDEF_H_TRUE@	      $(top_srcdir)/lib/stddef.in.h > $@-t
+@GL_GENERATE_STDDEF_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_STDDEF_H_FALSE@lib/stddef.h: $(top_builddir)/config.status
 @GL_GENERATE_STDDEF_H_FALSE@	rm -f $@
 
 # We need the following in order to create <stdint.h> when the system
 # doesn't have one that works with the given compiler.
 @GL_GENERATE_STDINT_H_TRUE@lib/stdint.h: lib/stdint.in.h $(top_builddir)/config.status
-@GL_GENERATE_STDINT_H_TRUE@	$(AM_V_GEN)rm -f $@-t $@ && \
-@GL_GENERATE_STDINT_H_TRUE@	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-@GL_GENERATE_STDINT_H_TRUE@	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+@GL_GENERATE_STDINT_H_TRUE@	$(AM_V_GEN)$(MKDIR_P) 'lib'
+@GL_GENERATE_STDINT_H_TRUE@	$(gl_V_at)$(SED_HEADER_STDOUT) \
+@GL_GENERATE_STDINT_H_TRUE@	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_STDINT_H''@/$(HAVE_STDINT_H)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
@@ -10848,8 +13048,6 @@
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_SYS_INTTYPES_H''@/$(HAVE_SYS_INTTYPES_H)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_SYS_BITYPES_H''@/$(HAVE_SYS_BITYPES_H)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_WCHAR_H''@/$(HAVE_WCHAR_H)/g' \
-@GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_LONG_LONG_INT''@/$(HAVE_LONG_LONG_INT)/g' \
-@GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_UNSIGNED_LONG_LONG_INT''@/$(HAVE_UNSIGNED_LONG_LONG_INT)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''APPLE_UNIVERSAL_BUILD''@/$(APPLE_UNIVERSAL_BUILD)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''BITSIZEOF_PTRDIFF_T''@/$(BITSIZEOF_PTRDIFF_T)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''PTRDIFF_T_SUFFIX''@/$(PTRDIFF_T_SUFFIX)/g' \
@@ -10864,83 +13062,92 @@
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''BITSIZEOF_WINT_T''@/$(BITSIZEOF_WINT_T)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''HAVE_SIGNED_WINT_T''@/$(HAVE_SIGNED_WINT_T)/g' \
 @GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''WINT_T_SUFFIX''@/$(WINT_T_SUFFIX)/g' \
-@GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-@GL_GENERATE_STDINT_H_TRUE@	      < $(top_srcdir)/lib/stdint.in.h; \
-@GL_GENERATE_STDINT_H_TRUE@	} > $@-t && \
-@GL_GENERATE_STDINT_H_TRUE@	mv $@-t $@
+@GL_GENERATE_STDINT_H_TRUE@	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+@GL_GENERATE_STDINT_H_TRUE@	      $(top_srcdir)/lib/stdint.in.h > $@-t
+@GL_GENERATE_STDINT_H_TRUE@	$(AM_V_at)mv $@-t $@
 @GL_GENERATE_STDINT_H_FALSE@lib/stdint.h: $(top_builddir)/config.status
 @GL_GENERATE_STDINT_H_FALSE@	rm -f $@
 
 # We need the following in order to create <stdio.h> when the system
 # doesn't have one that works with the given compiler.
 lib/stdio.h: lib/stdio.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_STDIO_H''@|$(NEXT_STDIO_H)|g' \
-	      -e 's/@''GNULIB_DPRINTF''@/$(GNULIB_DPRINTF)/g' \
-	      -e 's/@''GNULIB_FCLOSE''@/$(GNULIB_FCLOSE)/g' \
-	      -e 's/@''GNULIB_FDOPEN''@/$(GNULIB_FDOPEN)/g' \
-	      -e 's/@''GNULIB_FFLUSH''@/$(GNULIB_FFLUSH)/g' \
-	      -e 's/@''GNULIB_FGETC''@/$(GNULIB_FGETC)/g' \
-	      -e 's/@''GNULIB_FGETS''@/$(GNULIB_FGETS)/g' \
-	      -e 's/@''GNULIB_FOPEN''@/$(GNULIB_FOPEN)/g' \
-	      -e 's/@''GNULIB_FPRINTF''@/$(GNULIB_FPRINTF)/g' \
-	      -e 's/@''GNULIB_FPRINTF_POSIX''@/$(GNULIB_FPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_FPURGE''@/$(GNULIB_FPURGE)/g' \
-	      -e 's/@''GNULIB_FPUTC''@/$(GNULIB_FPUTC)/g' \
-	      -e 's/@''GNULIB_FPUTS''@/$(GNULIB_FPUTS)/g' \
-	      -e 's/@''GNULIB_FREAD''@/$(GNULIB_FREAD)/g' \
-	      -e 's/@''GNULIB_FREOPEN''@/$(GNULIB_FREOPEN)/g' \
-	      -e 's/@''GNULIB_FSCANF''@/$(GNULIB_FSCANF)/g' \
-	      -e 's/@''GNULIB_FSEEK''@/$(GNULIB_FSEEK)/g' \
-	      -e 's/@''GNULIB_FSEEKO''@/$(GNULIB_FSEEKO)/g' \
-	      -e 's/@''GNULIB_FTELL''@/$(GNULIB_FTELL)/g' \
-	      -e 's/@''GNULIB_FTELLO''@/$(GNULIB_FTELLO)/g' \
-	      -e 's/@''GNULIB_FWRITE''@/$(GNULIB_FWRITE)/g' \
-	      -e 's/@''GNULIB_GETC''@/$(GNULIB_GETC)/g' \
-	      -e 's/@''GNULIB_GETCHAR''@/$(GNULIB_GETCHAR)/g' \
-	      -e 's/@''GNULIB_GETDELIM''@/$(GNULIB_GETDELIM)/g' \
-	      -e 's/@''GNULIB_GETLINE''@/$(GNULIB_GETLINE)/g' \
-	      -e 's/@''GNULIB_OBSTACK_PRINTF''@/$(GNULIB_OBSTACK_PRINTF)/g' \
-	      -e 's/@''GNULIB_OBSTACK_PRINTF_POSIX''@/$(GNULIB_OBSTACK_PRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_PCLOSE''@/$(GNULIB_PCLOSE)/g' \
-	      -e 's/@''GNULIB_PERROR''@/$(GNULIB_PERROR)/g' \
-	      -e 's/@''GNULIB_POPEN''@/$(GNULIB_POPEN)/g' \
-	      -e 's/@''GNULIB_PRINTF''@/$(GNULIB_PRINTF)/g' \
-	      -e 's/@''GNULIB_PRINTF_POSIX''@/$(GNULIB_PRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_PUTC''@/$(GNULIB_PUTC)/g' \
-	      -e 's/@''GNULIB_PUTCHAR''@/$(GNULIB_PUTCHAR)/g' \
-	      -e 's/@''GNULIB_PUTS''@/$(GNULIB_PUTS)/g' \
-	      -e 's/@''GNULIB_REMOVE''@/$(GNULIB_REMOVE)/g' \
-	      -e 's/@''GNULIB_RENAME''@/$(GNULIB_RENAME)/g' \
-	      -e 's/@''GNULIB_RENAMEAT''@/$(GNULIB_RENAMEAT)/g' \
-	      -e 's/@''GNULIB_SCANF''@/$(GNULIB_SCANF)/g' \
-	      -e 's/@''GNULIB_SNPRINTF''@/$(GNULIB_SNPRINTF)/g' \
-	      -e 's/@''GNULIB_SPRINTF_POSIX''@/$(GNULIB_SPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_STDIO_H_NONBLOCKING''@/$(GNULIB_STDIO_H_NONBLOCKING)/g' \
-	      -e 's/@''GNULIB_STDIO_H_SIGPIPE''@/$(GNULIB_STDIO_H_SIGPIPE)/g' \
-	      -e 's/@''GNULIB_TMPFILE''@/$(GNULIB_TMPFILE)/g' \
-	      -e 's/@''GNULIB_VASPRINTF''@/$(GNULIB_VASPRINTF)/g' \
-	      -e 's/@''GNULIB_VDPRINTF''@/$(GNULIB_VDPRINTF)/g' \
-	      -e 's/@''GNULIB_VFPRINTF''@/$(GNULIB_VFPRINTF)/g' \
-	      -e 's/@''GNULIB_VFPRINTF_POSIX''@/$(GNULIB_VFPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_VFSCANF''@/$(GNULIB_VFSCANF)/g' \
-	      -e 's/@''GNULIB_VSCANF''@/$(GNULIB_VSCANF)/g' \
-	      -e 's/@''GNULIB_VPRINTF''@/$(GNULIB_VPRINTF)/g' \
-	      -e 's/@''GNULIB_VPRINTF_POSIX''@/$(GNULIB_VPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_VSNPRINTF''@/$(GNULIB_VSNPRINTF)/g' \
-	      -e 's/@''GNULIB_VSPRINTF_POSIX''@/$(GNULIB_VSPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_DPRINTF''@/$(GL_GNULIB_DPRINTF)/g' \
+	      -e 's/@''GNULIB_FCLOSE''@/$(GL_GNULIB_FCLOSE)/g' \
+	      -e 's/@''GNULIB_FDOPEN''@/$(GL_GNULIB_FDOPEN)/g' \
+	      -e 's/@''GNULIB_FFLUSH''@/$(GL_GNULIB_FFLUSH)/g' \
+	      -e 's/@''GNULIB_FGETC''@/$(GL_GNULIB_FGETC)/g' \
+	      -e 's/@''GNULIB_FGETS''@/$(GL_GNULIB_FGETS)/g' \
+	      -e 's/@''GNULIB_FOPEN''@/$(GL_GNULIB_FOPEN)/g' \
+	      -e 's/@''GNULIB_FOPEN_GNU''@/$(GL_GNULIB_FOPEN_GNU)/g' \
+	      -e 's/@''GNULIB_FPRINTF''@/$(GL_GNULIB_FPRINTF)/g' \
+	      -e 's/@''GNULIB_FPRINTF_POSIX''@/$(GL_GNULIB_FPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_FPURGE''@/$(GL_GNULIB_FPURGE)/g' \
+	      -e 's/@''GNULIB_FPUTC''@/$(GL_GNULIB_FPUTC)/g' \
+	      -e 's/@''GNULIB_FPUTS''@/$(GL_GNULIB_FPUTS)/g' \
+	      -e 's/@''GNULIB_FREAD''@/$(GL_GNULIB_FREAD)/g' \
+	      -e 's/@''GNULIB_FREOPEN''@/$(GL_GNULIB_FREOPEN)/g' \
+	      -e 's/@''GNULIB_FSCANF''@/$(GL_GNULIB_FSCANF)/g' \
+	      -e 's/@''GNULIB_FSEEK''@/$(GL_GNULIB_FSEEK)/g' \
+	      -e 's/@''GNULIB_FSEEKO''@/$(GL_GNULIB_FSEEKO)/g' \
+	      -e 's/@''GNULIB_FTELL''@/$(GL_GNULIB_FTELL)/g' \
+	      -e 's/@''GNULIB_FTELLO''@/$(GL_GNULIB_FTELLO)/g' \
+	      -e 's/@''GNULIB_FWRITE''@/$(GL_GNULIB_FWRITE)/g' \
+	      -e 's/@''GNULIB_GETC''@/$(GL_GNULIB_GETC)/g' \
+	      -e 's/@''GNULIB_GETCHAR''@/$(GL_GNULIB_GETCHAR)/g' \
+	      -e 's/@''GNULIB_GETDELIM''@/$(GL_GNULIB_GETDELIM)/g' \
+	      -e 's/@''GNULIB_GETLINE''@/$(GL_GNULIB_GETLINE)/g' \
+	      -e 's/@''GNULIB_OBSTACK_PRINTF''@/$(GL_GNULIB_OBSTACK_PRINTF)/g' \
+	      -e 's/@''GNULIB_OBSTACK_PRINTF_POSIX''@/$(GL_GNULIB_OBSTACK_PRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_PCLOSE''@/$(GL_GNULIB_PCLOSE)/g' \
+	      -e 's/@''GNULIB_PERROR''@/$(GL_GNULIB_PERROR)/g' \
+	      -e 's/@''GNULIB_POPEN''@/$(GL_GNULIB_POPEN)/g' \
+	      -e 's/@''GNULIB_PRINTF''@/$(GL_GNULIB_PRINTF)/g' \
+	      -e 's/@''GNULIB_PRINTF_POSIX''@/$(GL_GNULIB_PRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_PUTC''@/$(GL_GNULIB_PUTC)/g' \
+	      -e 's/@''GNULIB_PUTCHAR''@/$(GL_GNULIB_PUTCHAR)/g' \
+	      -e 's/@''GNULIB_PUTS''@/$(GL_GNULIB_PUTS)/g' \
+	      -e 's/@''GNULIB_REMOVE''@/$(GL_GNULIB_REMOVE)/g' \
+	      -e 's/@''GNULIB_RENAME''@/$(GL_GNULIB_RENAME)/g' \
+	      -e 's/@''GNULIB_RENAMEAT''@/$(GL_GNULIB_RENAMEAT)/g' \
+	      -e 's/@''GNULIB_SCANF''@/$(GL_GNULIB_SCANF)/g' \
+	      -e 's/@''GNULIB_SNPRINTF''@/$(GL_GNULIB_SNPRINTF)/g' \
+	      -e 's/@''GNULIB_SPRINTF_POSIX''@/$(GL_GNULIB_SPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_STDIO_H_NONBLOCKING''@/$(GL_GNULIB_STDIO_H_NONBLOCKING)/g' \
+	      -e 's/@''GNULIB_STDIO_H_SIGPIPE''@/$(GL_GNULIB_STDIO_H_SIGPIPE)/g' \
+	      -e 's/@''GNULIB_TMPFILE''@/$(GL_GNULIB_TMPFILE)/g' \
+	      -e 's/@''GNULIB_VASPRINTF''@/$(GL_GNULIB_VASPRINTF)/g' \
+	      -e 's/@''GNULIB_VDPRINTF''@/$(GL_GNULIB_VDPRINTF)/g' \
+	      -e 's/@''GNULIB_VFPRINTF''@/$(GL_GNULIB_VFPRINTF)/g' \
+	      -e 's/@''GNULIB_VFPRINTF_POSIX''@/$(GL_GNULIB_VFPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_VFSCANF''@/$(GL_GNULIB_VFSCANF)/g' \
+	      -e 's/@''GNULIB_VSCANF''@/$(GL_GNULIB_VSCANF)/g' \
+	      -e 's/@''GNULIB_VPRINTF''@/$(GL_GNULIB_VPRINTF)/g' \
+	      -e 's/@''GNULIB_VPRINTF_POSIX''@/$(GL_GNULIB_VPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_VSNPRINTF''@/$(GL_GNULIB_VSNPRINTF)/g' \
+	      -e 's/@''GNULIB_VSPRINTF_POSIX''@/$(GL_GNULIB_VSPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_MDA_FCLOSEALL''@/$(GL_GNULIB_MDA_FCLOSEALL)/g' \
+	      -e 's/@''GNULIB_MDA_FDOPEN''@/$(GL_GNULIB_MDA_FDOPEN)/g' \
+	      -e 's/@''GNULIB_MDA_FILENO''@/$(GL_GNULIB_MDA_FILENO)/g' \
+	      -e 's/@''GNULIB_MDA_GETW''@/$(GL_GNULIB_MDA_GETW)/g' \
+	      -e 's/@''GNULIB_MDA_PUTW''@/$(GL_GNULIB_MDA_PUTW)/g' \
+	      -e 's/@''GNULIB_MDA_TEMPNAM''@/$(GL_GNULIB_MDA_TEMPNAM)/g' \
 	      < $(top_srcdir)/lib/stdio.in.h | \
-	  sed -e 's|@''HAVE_DECL_FPURGE''@|$(HAVE_DECL_FPURGE)|g' \
+	  sed -e 's|@''HAVE_DECL_FCLOSEALL''@|$(HAVE_DECL_FCLOSEALL)|g' \
+	      -e 's|@''HAVE_DECL_FPURGE''@|$(HAVE_DECL_FPURGE)|g' \
 	      -e 's|@''HAVE_DECL_FSEEKO''@|$(HAVE_DECL_FSEEKO)|g' \
 	      -e 's|@''HAVE_DECL_FTELLO''@|$(HAVE_DECL_FTELLO)|g' \
 	      -e 's|@''HAVE_DECL_GETDELIM''@|$(HAVE_DECL_GETDELIM)|g' \
 	      -e 's|@''HAVE_DECL_GETLINE''@|$(HAVE_DECL_GETLINE)|g' \
+	      -e 's|@''HAVE_DECL_GETW''@|$(HAVE_DECL_GETW)|g' \
 	      -e 's|@''HAVE_DECL_OBSTACK_PRINTF''@|$(HAVE_DECL_OBSTACK_PRINTF)|g' \
+	      -e 's|@''HAVE_DECL_PUTW''@|$(HAVE_DECL_PUTW)|g' \
 	      -e 's|@''HAVE_DECL_SNPRINTF''@|$(HAVE_DECL_SNPRINTF)|g' \
 	      -e 's|@''HAVE_DECL_VSNPRINTF''@|$(HAVE_DECL_VSNPRINTF)|g' \
 	      -e 's|@''HAVE_DPRINTF''@|$(HAVE_DPRINTF)|g' \
@@ -10956,6 +13163,7 @@
 	      -e 's|@''REPLACE_FDOPEN''@|$(REPLACE_FDOPEN)|g' \
 	      -e 's|@''REPLACE_FFLUSH''@|$(REPLACE_FFLUSH)|g' \
 	      -e 's|@''REPLACE_FOPEN''@|$(REPLACE_FOPEN)|g' \
+	      -e 's|@''REPLACE_FOPEN_FOR_FOPEN_GNU''@|$(REPLACE_FOPEN_FOR_FOPEN_GNU)|g' \
 	      -e 's|@''REPLACE_FPRINTF''@|$(REPLACE_FPRINTF)|g' \
 	      -e 's|@''REPLACE_FPURGE''@|$(REPLACE_FPURGE)|g' \
 	      -e 's|@''REPLACE_FREOPEN''@|$(REPLACE_FREOPEN)|g' \
@@ -10986,67 +13194,224 @@
 	      -e 's|@''ASM_SYMBOL_PREFIX''@|$(ASM_SYMBOL_PREFIX)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
+
+# We need the following in order to create <stdlib.h> when the system
+# doesn't have one that works with the given compiler.
+lib/stdlib.h: lib/stdlib.in.h $(top_builddir)/config.status $(CXXDEFS_H) \
+  $(_NORETURN_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_STDLIB_H''@|$(NEXT_STDLIB_H)|g' \
+	      -e 's/@''GNULIB__EXIT''@/$(GL_GNULIB__EXIT)/g' \
+	      -e 's/@''GNULIB_ALIGNED_ALLOC''@/$(GL_GNULIB_ALIGNED_ALLOC)/g' \
+	      -e 's/@''GNULIB_ATOLL''@/$(GL_GNULIB_ATOLL)/g' \
+	      -e 's/@''GNULIB_CALLOC_GNU''@/$(GL_GNULIB_CALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_CALLOC_POSIX''@/$(GL_GNULIB_CALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_CANONICALIZE_FILE_NAME''@/$(GL_GNULIB_CANONICALIZE_FILE_NAME)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
+	      -e 's/@''GNULIB_GETLOADAVG''@/$(GL_GNULIB_GETLOADAVG)/g' \
+	      -e 's/@''GNULIB_GETPROGNAME''@/$(GL_GNULIB_GETPROGNAME)/g' \
+	      -e 's/@''GNULIB_GETSUBOPT''@/$(GL_GNULIB_GETSUBOPT)/g' \
+	      -e 's/@''GNULIB_GRANTPT''@/$(GL_GNULIB_GRANTPT)/g' \
+	      -e 's/@''GNULIB_MALLOC_GNU''@/$(GL_GNULIB_MALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_MALLOC_POSIX''@/$(GL_GNULIB_MALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_MBTOWC''@/$(GL_GNULIB_MBTOWC)/g' \
+	      -e 's/@''GNULIB_MKDTEMP''@/$(GL_GNULIB_MKDTEMP)/g' \
+	      -e 's/@''GNULIB_MKOSTEMP''@/$(GL_GNULIB_MKOSTEMP)/g' \
+	      -e 's/@''GNULIB_MKOSTEMPS''@/$(GL_GNULIB_MKOSTEMPS)/g' \
+	      -e 's/@''GNULIB_MKSTEMP''@/$(GL_GNULIB_MKSTEMP)/g' \
+	      -e 's/@''GNULIB_MKSTEMPS''@/$(GL_GNULIB_MKSTEMPS)/g' \
+	      -e 's/@''GNULIB_POSIX_MEMALIGN''@/$(GL_GNULIB_POSIX_MEMALIGN)/g' \
+	      -e 's/@''GNULIB_POSIX_OPENPT''@/$(GL_GNULIB_POSIX_OPENPT)/g' \
+	      -e 's/@''GNULIB_PTSNAME''@/$(GL_GNULIB_PTSNAME)/g' \
+	      -e 's/@''GNULIB_PTSNAME_R''@/$(GL_GNULIB_PTSNAME_R)/g' \
+	      -e 's/@''GNULIB_PUTENV''@/$(GL_GNULIB_PUTENV)/g' \
+	      -e 's/@''GNULIB_QSORT_R''@/$(GL_GNULIB_QSORT_R)/g' \
+	      -e 's/@''GNULIB_RANDOM''@/$(GL_GNULIB_RANDOM)/g' \
+	      -e 's/@''GNULIB_RANDOM_R''@/$(GL_GNULIB_RANDOM_R)/g' \
+	      -e 's/@''GNULIB_REALLOC_GNU''@/$(GL_GNULIB_REALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_REALLOC_POSIX''@/$(GL_GNULIB_REALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_REALLOCARRAY''@/$(GL_GNULIB_REALLOCARRAY)/g' \
+	      -e 's/@''GNULIB_REALPATH''@/$(GL_GNULIB_REALPATH)/g' \
+	      -e 's/@''GNULIB_RPMATCH''@/$(GL_GNULIB_RPMATCH)/g' \
+	      -e 's/@''GNULIB_SECURE_GETENV''@/$(GL_GNULIB_SECURE_GETENV)/g' \
+	      -e 's/@''GNULIB_SETENV''@/$(GL_GNULIB_SETENV)/g' \
+	      -e 's/@''GNULIB_STRTOD''@/$(GL_GNULIB_STRTOD)/g' \
+	      -e 's/@''GNULIB_STRTOL''@/$(GL_GNULIB_STRTOL)/g' \
+	      -e 's/@''GNULIB_STRTOLD''@/$(GL_GNULIB_STRTOLD)/g' \
+	      -e 's/@''GNULIB_STRTOLL''@/$(GL_GNULIB_STRTOLL)/g' \
+	      -e 's/@''GNULIB_STRTOUL''@/$(GL_GNULIB_STRTOUL)/g' \
+	      -e 's/@''GNULIB_STRTOULL''@/$(GL_GNULIB_STRTOULL)/g' \
+	      -e 's/@''GNULIB_SYSTEM_POSIX''@/$(GL_GNULIB_SYSTEM_POSIX)/g' \
+	      -e 's/@''GNULIB_UNLOCKPT''@/$(GL_GNULIB_UNLOCKPT)/g' \
+	      -e 's/@''GNULIB_UNSETENV''@/$(GL_GNULIB_UNSETENV)/g' \
+	      -e 's/@''GNULIB_WCTOMB''@/$(GL_GNULIB_WCTOMB)/g' \
+	      -e 's/@''GNULIB_MDA_ECVT''@/$(GL_GNULIB_MDA_ECVT)/g' \
+	      -e 's/@''GNULIB_MDA_FCVT''@/$(GL_GNULIB_MDA_FCVT)/g' \
+	      -e 's/@''GNULIB_MDA_GCVT''@/$(GL_GNULIB_MDA_GCVT)/g' \
+	      -e 's/@''GNULIB_MDA_MKTEMP''@/$(GL_GNULIB_MDA_MKTEMP)/g' \
+	      -e 's/@''GNULIB_MDA_PUTENV''@/$(GL_GNULIB_MDA_PUTENV)/g' \
+	      < $(top_srcdir)/lib/stdlib.in.h | \
+	  sed -e 's|@''HAVE__EXIT''@|$(HAVE__EXIT)|g' \
+	      -e 's|@''HAVE_ALIGNED_ALLOC''@|$(HAVE_ALIGNED_ALLOC)|g' \
+	      -e 's|@''HAVE_ATOLL''@|$(HAVE_ATOLL)|g' \
+	      -e 's|@''HAVE_CANONICALIZE_FILE_NAME''@|$(HAVE_CANONICALIZE_FILE_NAME)|g' \
+	      -e 's|@''HAVE_DECL_ECVT''@|$(HAVE_DECL_ECVT)|g' \
+	      -e 's|@''HAVE_DECL_FCVT''@|$(HAVE_DECL_FCVT)|g' \
+	      -e 's|@''HAVE_DECL_GCVT''@|$(HAVE_DECL_GCVT)|g' \
+	      -e 's|@''HAVE_DECL_GETLOADAVG''@|$(HAVE_DECL_GETLOADAVG)|g' \
+	      -e 's|@''HAVE_GETPROGNAME''@|$(HAVE_GETPROGNAME)|g' \
+	      -e 's|@''HAVE_GETSUBOPT''@|$(HAVE_GETSUBOPT)|g' \
+	      -e 's|@''HAVE_GRANTPT''@|$(HAVE_GRANTPT)|g' \
+	      -e 's|@''HAVE_INITSTATE''@|$(HAVE_INITSTATE)|g' \
+	      -e 's|@''HAVE_DECL_INITSTATE''@|$(HAVE_DECL_INITSTATE)|g' \
+	      -e 's|@''HAVE_MBTOWC''@|$(HAVE_MBTOWC)|g' \
+	      -e 's|@''HAVE_MKDTEMP''@|$(HAVE_MKDTEMP)|g' \
+	      -e 's|@''HAVE_MKOSTEMP''@|$(HAVE_MKOSTEMP)|g' \
+	      -e 's|@''HAVE_MKOSTEMPS''@|$(HAVE_MKOSTEMPS)|g' \
+	      -e 's|@''HAVE_MKSTEMP''@|$(HAVE_MKSTEMP)|g' \
+	      -e 's|@''HAVE_MKSTEMPS''@|$(HAVE_MKSTEMPS)|g' \
+	      -e 's|@''HAVE_POSIX_MEMALIGN''@|$(HAVE_POSIX_MEMALIGN)|g' \
+	      -e 's|@''HAVE_POSIX_OPENPT''@|$(HAVE_POSIX_OPENPT)|g' \
+	      -e 's|@''HAVE_PTSNAME''@|$(HAVE_PTSNAME)|g' \
+	      -e 's|@''HAVE_PTSNAME_R''@|$(HAVE_PTSNAME_R)|g' \
+	      -e 's|@''HAVE_QSORT_R''@|$(HAVE_QSORT_R)|g' \
+	      -e 's|@''HAVE_RANDOM''@|$(HAVE_RANDOM)|g' \
+	      -e 's|@''HAVE_RANDOM_H''@|$(HAVE_RANDOM_H)|g' \
+	      -e 's|@''HAVE_RANDOM_R''@|$(HAVE_RANDOM_R)|g' \
+	      -e 's|@''HAVE_REALLOCARRAY''@|$(HAVE_REALLOCARRAY)|g' \
+	      -e 's|@''HAVE_REALPATH''@|$(HAVE_REALPATH)|g' \
+	      -e 's|@''HAVE_RPMATCH''@|$(HAVE_RPMATCH)|g' \
+	      -e 's|@''HAVE_SECURE_GETENV''@|$(HAVE_SECURE_GETENV)|g' \
+	      -e 's|@''HAVE_DECL_SETENV''@|$(HAVE_DECL_SETENV)|g' \
+	      -e 's|@''HAVE_SETSTATE''@|$(HAVE_SETSTATE)|g' \
+	      -e 's|@''HAVE_DECL_SETSTATE''@|$(HAVE_DECL_SETSTATE)|g' \
+	      -e 's|@''HAVE_STRTOD''@|$(HAVE_STRTOD)|g' \
+	      -e 's|@''HAVE_STRTOL''@|$(HAVE_STRTOL)|g' \
+	      -e 's|@''HAVE_STRTOLD''@|$(HAVE_STRTOLD)|g' \
+	      -e 's|@''HAVE_STRTOLL''@|$(HAVE_STRTOLL)|g' \
+	      -e 's|@''HAVE_STRTOUL''@|$(HAVE_STRTOUL)|g' \
+	      -e 's|@''HAVE_STRTOULL''@|$(HAVE_STRTOULL)|g' \
+	      -e 's|@''HAVE_STRUCT_RANDOM_DATA''@|$(HAVE_STRUCT_RANDOM_DATA)|g' \
+	      -e 's|@''HAVE_SYS_LOADAVG_H''@|$(HAVE_SYS_LOADAVG_H)|g' \
+	      -e 's|@''HAVE_UNLOCKPT''@|$(HAVE_UNLOCKPT)|g' \
+	      -e 's|@''HAVE_DECL_UNSETENV''@|$(HAVE_DECL_UNSETENV)|g' \
+	      -e 's|@''REPLACE__EXIT''@|$(REPLACE__EXIT)|g' \
+	      -e 's|@''REPLACE_ALIGNED_ALLOC''@|$(REPLACE_ALIGNED_ALLOC)|g' \
+	      -e 's|@''REPLACE_CALLOC_FOR_CALLOC_GNU''@|$(REPLACE_CALLOC_FOR_CALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_CALLOC_FOR_CALLOC_POSIX''@|$(REPLACE_CALLOC_FOR_CALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_CANONICALIZE_FILE_NAME''@|$(REPLACE_CANONICALIZE_FILE_NAME)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
+	      -e 's|@''REPLACE_GETLOADAVG''@|$(REPLACE_GETLOADAVG)|g' \
+	      -e 's|@''REPLACE_GETPROGNAME''@|$(REPLACE_GETPROGNAME)|g' \
+	      -e 's|@''REPLACE_GETSUBOPT''@|$(REPLACE_GETSUBOPT)|g' \
+	      -e 's|@''REPLACE_INITSTATE''@|$(REPLACE_INITSTATE)|g' \
+	      -e 's|@''REPLACE_MALLOC_FOR_MALLOC_GNU''@|$(REPLACE_MALLOC_FOR_MALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_MALLOC_FOR_MALLOC_POSIX''@|$(REPLACE_MALLOC_FOR_MALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_MBTOWC''@|$(REPLACE_MBTOWC)|g' \
+	      -e 's|@''REPLACE_MKOSTEMP''@|$(REPLACE_MKOSTEMP)|g' \
+	      -e 's|@''REPLACE_MKOSTEMPS''@|$(REPLACE_MKOSTEMPS)|g' \
+	      -e 's|@''REPLACE_MKSTEMP''@|$(REPLACE_MKSTEMP)|g' \
+	      -e 's|@''REPLACE_POSIX_MEMALIGN''@|$(REPLACE_POSIX_MEMALIGN)|g' \
+	      -e 's|@''REPLACE_POSIX_OPENPT''@|$(REPLACE_POSIX_OPENPT)|g' \
+	      -e 's|@''REPLACE_PTSNAME''@|$(REPLACE_PTSNAME)|g' \
+	      -e 's|@''REPLACE_PTSNAME_R''@|$(REPLACE_PTSNAME_R)|g' \
+	      -e 's|@''REPLACE_PUTENV''@|$(REPLACE_PUTENV)|g' \
+	      -e 's|@''REPLACE_QSORT_R''@|$(REPLACE_QSORT_R)|g' \
+	      -e 's|@''REPLACE_RANDOM''@|$(REPLACE_RANDOM)|g' \
+	      -e 's|@''REPLACE_RANDOM_R''@|$(REPLACE_RANDOM_R)|g' \
+	      -e 's|@''REPLACE_REALLOC_FOR_REALLOC_GNU''@|$(REPLACE_REALLOC_FOR_REALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_REALLOC_FOR_REALLOC_POSIX''@|$(REPLACE_REALLOC_FOR_REALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_REALLOCARRAY''@|$(REPLACE_REALLOCARRAY)|g' \
+	      -e 's|@''REPLACE_REALPATH''@|$(REPLACE_REALPATH)|g' \
+	      -e 's|@''REPLACE_SETENV''@|$(REPLACE_SETENV)|g' \
+	      -e 's|@''REPLACE_SETSTATE''@|$(REPLACE_SETSTATE)|g' \
+	      -e 's|@''REPLACE_STRTOD''@|$(REPLACE_STRTOD)|g' \
+	      -e 's|@''REPLACE_STRTOL''@|$(REPLACE_STRTOL)|g' \
+	      -e 's|@''REPLACE_STRTOLD''@|$(REPLACE_STRTOLD)|g' \
+	      -e 's|@''REPLACE_STRTOLL''@|$(REPLACE_STRTOLL)|g' \
+	      -e 's|@''REPLACE_STRTOUL''@|$(REPLACE_STRTOUL)|g' \
+	      -e 's|@''REPLACE_STRTOULL''@|$(REPLACE_STRTOULL)|g' \
+	      -e 's|@''REPLACE_UNSETENV''@|$(REPLACE_UNSETENV)|g' \
+	      -e 's|@''REPLACE_WCTOMB''@|$(REPLACE_WCTOMB)|g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _Noreturn/r $(_NORETURN_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 
 # We need the following in order to create <string.h> when the system
 # doesn't have one that works with the given compiler.
 lib/string.h: lib/string.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_STRING_H''@|$(NEXT_STRING_H)|g' \
-	      -e 's/@''GNULIB_EXPLICIT_BZERO''@/$(GNULIB_EXPLICIT_BZERO)/g' \
-	      -e 's/@''GNULIB_FFSL''@/$(GNULIB_FFSL)/g' \
-	      -e 's/@''GNULIB_FFSLL''@/$(GNULIB_FFSLL)/g' \
-	      -e 's/@''GNULIB_MBSLEN''@/$(GNULIB_MBSLEN)/g' \
-	      -e 's/@''GNULIB_MBSNLEN''@/$(GNULIB_MBSNLEN)/g' \
-	      -e 's/@''GNULIB_MBSCHR''@/$(GNULIB_MBSCHR)/g' \
-	      -e 's/@''GNULIB_MBSRCHR''@/$(GNULIB_MBSRCHR)/g' \
-	      -e 's/@''GNULIB_MBSSTR''@/$(GNULIB_MBSSTR)/g' \
-	      -e 's/@''GNULIB_MBSCASECMP''@/$(GNULIB_MBSCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSNCASECMP''@/$(GNULIB_MBSNCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSPCASECMP''@/$(GNULIB_MBSPCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSCASESTR''@/$(GNULIB_MBSCASESTR)/g' \
-	      -e 's/@''GNULIB_MBSCSPN''@/$(GNULIB_MBSCSPN)/g' \
-	      -e 's/@''GNULIB_MBSPBRK''@/$(GNULIB_MBSPBRK)/g' \
-	      -e 's/@''GNULIB_MBSSPN''@/$(GNULIB_MBSSPN)/g' \
-	      -e 's/@''GNULIB_MBSSEP''@/$(GNULIB_MBSSEP)/g' \
-	      -e 's/@''GNULIB_MBSTOK_R''@/$(GNULIB_MBSTOK_R)/g' \
-	      -e 's/@''GNULIB_MEMCHR''@/$(GNULIB_MEMCHR)/g' \
-	      -e 's/@''GNULIB_MEMMEM''@/$(GNULIB_MEMMEM)/g' \
-	      -e 's/@''GNULIB_MEMPCPY''@/$(GNULIB_MEMPCPY)/g' \
-	      -e 's/@''GNULIB_MEMRCHR''@/$(GNULIB_MEMRCHR)/g' \
-	      -e 's/@''GNULIB_RAWMEMCHR''@/$(GNULIB_RAWMEMCHR)/g' \
-	      -e 's/@''GNULIB_STPCPY''@/$(GNULIB_STPCPY)/g' \
-	      -e 's/@''GNULIB_STPNCPY''@/$(GNULIB_STPNCPY)/g' \
-	      -e 's/@''GNULIB_STRCHRNUL''@/$(GNULIB_STRCHRNUL)/g' \
-	      -e 's/@''GNULIB_STRDUP''@/$(GNULIB_STRDUP)/g' \
-	      -e 's/@''GNULIB_STRNCAT''@/$(GNULIB_STRNCAT)/g' \
-	      -e 's/@''GNULIB_STRNDUP''@/$(GNULIB_STRNDUP)/g' \
-	      -e 's/@''GNULIB_STRNLEN''@/$(GNULIB_STRNLEN)/g' \
-	      -e 's/@''GNULIB_STRPBRK''@/$(GNULIB_STRPBRK)/g' \
-	      -e 's/@''GNULIB_STRSEP''@/$(GNULIB_STRSEP)/g' \
-	      -e 's/@''GNULIB_STRSTR''@/$(GNULIB_STRSTR)/g' \
-	      -e 's/@''GNULIB_STRCASESTR''@/$(GNULIB_STRCASESTR)/g' \
-	      -e 's/@''GNULIB_STRTOK_R''@/$(GNULIB_STRTOK_R)/g' \
-	      -e 's/@''GNULIB_STRERROR''@/$(GNULIB_STRERROR)/g' \
-	      -e 's/@''GNULIB_STRERROR_R''@/$(GNULIB_STRERROR_R)/g' \
-	      -e 's/@''GNULIB_STRSIGNAL''@/$(GNULIB_STRSIGNAL)/g' \
-	      -e 's/@''GNULIB_STRVERSCMP''@/$(GNULIB_STRVERSCMP)/g' \
+	      -e 's/@''GNULIB_EXPLICIT_BZERO''@/$(GL_GNULIB_EXPLICIT_BZERO)/g' \
+	      -e 's/@''GNULIB_FFSL''@/$(GL_GNULIB_FFSL)/g' \
+	      -e 's/@''GNULIB_FFSLL''@/$(GL_GNULIB_FFSLL)/g' \
+	      -e 's/@''GNULIB_MBSLEN''@/$(GL_GNULIB_MBSLEN)/g' \
+	      -e 's/@''GNULIB_MBSNLEN''@/$(GL_GNULIB_MBSNLEN)/g' \
+	      -e 's/@''GNULIB_MBSCHR''@/$(GL_GNULIB_MBSCHR)/g' \
+	      -e 's/@''GNULIB_MBSRCHR''@/$(GL_GNULIB_MBSRCHR)/g' \
+	      -e 's/@''GNULIB_MBSSTR''@/$(GL_GNULIB_MBSSTR)/g' \
+	      -e 's/@''GNULIB_MBSCASECMP''@/$(GL_GNULIB_MBSCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSNCASECMP''@/$(GL_GNULIB_MBSNCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSPCASECMP''@/$(GL_GNULIB_MBSPCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSCASESTR''@/$(GL_GNULIB_MBSCASESTR)/g' \
+	      -e 's/@''GNULIB_MBSCSPN''@/$(GL_GNULIB_MBSCSPN)/g' \
+	      -e 's/@''GNULIB_MBSPBRK''@/$(GL_GNULIB_MBSPBRK)/g' \
+	      -e 's/@''GNULIB_MBSSPN''@/$(GL_GNULIB_MBSSPN)/g' \
+	      -e 's/@''GNULIB_MBSSEP''@/$(GL_GNULIB_MBSSEP)/g' \
+	      -e 's/@''GNULIB_MBSTOK_R''@/$(GL_GNULIB_MBSTOK_R)/g' \
+	      -e 's/@''GNULIB_MEMCHR''@/$(GL_GNULIB_MEMCHR)/g' \
+	      -e 's/@''GNULIB_MEMMEM''@/$(GL_GNULIB_MEMMEM)/g' \
+	      -e 's/@''GNULIB_MEMPCPY''@/$(GL_GNULIB_MEMPCPY)/g' \
+	      -e 's/@''GNULIB_MEMRCHR''@/$(GL_GNULIB_MEMRCHR)/g' \
+	      -e 's/@''GNULIB_MEMSET_EXPLICIT''@/$(GL_GNULIB_MEMSET_EXPLICIT)/g' \
+	      -e 's/@''GNULIB_RAWMEMCHR''@/$(GL_GNULIB_RAWMEMCHR)/g' \
+	      -e 's/@''GNULIB_STPCPY''@/$(GL_GNULIB_STPCPY)/g' \
+	      -e 's/@''GNULIB_STPNCPY''@/$(GL_GNULIB_STPNCPY)/g' \
+	      -e 's/@''GNULIB_STRCHRNUL''@/$(GL_GNULIB_STRCHRNUL)/g' \
+	      -e 's/@''GNULIB_STRDUP''@/$(GL_GNULIB_STRDUP)/g' \
+	      -e 's/@''GNULIB_STRNCAT''@/$(GL_GNULIB_STRNCAT)/g' \
+	      -e 's/@''GNULIB_STRNDUP''@/$(GL_GNULIB_STRNDUP)/g' \
+	      -e 's/@''GNULIB_STRNLEN''@/$(GL_GNULIB_STRNLEN)/g' \
+	      -e 's/@''GNULIB_STRPBRK''@/$(GL_GNULIB_STRPBRK)/g' \
+	      -e 's/@''GNULIB_STRSEP''@/$(GL_GNULIB_STRSEP)/g' \
+	      -e 's/@''GNULIB_STRSTR''@/$(GL_GNULIB_STRSTR)/g' \
+	      -e 's/@''GNULIB_STRCASESTR''@/$(GL_GNULIB_STRCASESTR)/g' \
+	      -e 's/@''GNULIB_STRTOK_R''@/$(GL_GNULIB_STRTOK_R)/g' \
+	      -e 's/@''GNULIB_STRERROR''@/$(GL_GNULIB_STRERROR)/g' \
+	      -e 's/@''GNULIB_STRERROR_R''@/$(GL_GNULIB_STRERROR_R)/g' \
+	      -e 's/@''GNULIB_STRERRORNAME_NP''@/$(GL_GNULIB_STRERRORNAME_NP)/g' \
+	      -e 's/@''GNULIB_SIGABBREV_NP''@/$(GL_GNULIB_SIGABBREV_NP)/g' \
+	      -e 's/@''GNULIB_SIGDESCR_NP''@/$(GL_GNULIB_SIGDESCR_NP)/g' \
+	      -e 's/@''GNULIB_STRSIGNAL''@/$(GL_GNULIB_STRSIGNAL)/g' \
+	      -e 's/@''GNULIB_STRVERSCMP''@/$(GL_GNULIB_STRVERSCMP)/g' \
+	      -e 's/@''GNULIB_MDA_MEMCCPY''@/$(GL_GNULIB_MDA_MEMCCPY)/g' \
+	      -e 's/@''GNULIB_MDA_STRDUP''@/$(GL_GNULIB_MDA_STRDUP)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
 	      < $(top_srcdir)/lib/string.in.h | \
 	  sed -e 's|@''HAVE_EXPLICIT_BZERO''@|$(HAVE_EXPLICIT_BZERO)|g' \
 	      -e 's|@''HAVE_FFSL''@|$(HAVE_FFSL)|g' \
 	      -e 's|@''HAVE_FFSLL''@|$(HAVE_FFSLL)|g' \
 	      -e 's|@''HAVE_MBSLEN''@|$(HAVE_MBSLEN)|g' \
-	      -e 's|@''HAVE_MEMCHR''@|$(HAVE_MEMCHR)|g' \
 	      -e 's|@''HAVE_DECL_MEMMEM''@|$(HAVE_DECL_MEMMEM)|g' \
 	      -e 's|@''HAVE_MEMPCPY''@|$(HAVE_MEMPCPY)|g' \
 	      -e 's|@''HAVE_DECL_MEMRCHR''@|$(HAVE_DECL_MEMRCHR)|g' \
+	      -e 's|@''HAVE_MEMSET_EXPLICIT''@|$(HAVE_MEMSET_EXPLICIT)|g' \
 	      -e 's|@''HAVE_RAWMEMCHR''@|$(HAVE_RAWMEMCHR)|g' \
 	      -e 's|@''HAVE_STPCPY''@|$(HAVE_STPCPY)|g' \
 	      -e 's|@''HAVE_STPNCPY''@|$(HAVE_STPNCPY)|g' \
@@ -11059,10 +13424,17 @@
 	      -e 's|@''HAVE_STRCASESTR''@|$(HAVE_STRCASESTR)|g' \
 	      -e 's|@''HAVE_DECL_STRTOK_R''@|$(HAVE_DECL_STRTOK_R)|g' \
 	      -e 's|@''HAVE_DECL_STRERROR_R''@|$(HAVE_DECL_STRERROR_R)|g' \
+	      -e 's|@''HAVE_STRERRORNAME_NP''@|$(HAVE_STRERRORNAME_NP)|g' \
+	      -e 's|@''HAVE_SIGABBREV_NP''@|$(HAVE_SIGABBREV_NP)|g' \
+	      -e 's|@''HAVE_SIGDESCR_NP''@|$(HAVE_SIGDESCR_NP)|g' \
 	      -e 's|@''HAVE_DECL_STRSIGNAL''@|$(HAVE_DECL_STRSIGNAL)|g' \
 	      -e 's|@''HAVE_STRVERSCMP''@|$(HAVE_STRVERSCMP)|g' \
+	      -e 's|@''REPLACE_FFSLL''@|$(REPLACE_FFSLL)|g' \
 	      -e 's|@''REPLACE_MEMCHR''@|$(REPLACE_MEMCHR)|g' \
 	      -e 's|@''REPLACE_MEMMEM''@|$(REPLACE_MEMMEM)|g' \
+	      -e 's|@''REPLACE_MEMPCPY''@|$(REPLACE_MEMPCPY)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
+	      -e 's|@''REPLACE_STPCPY''@|$(REPLACE_STPCPY)|g' \
 	      -e 's|@''REPLACE_STPNCPY''@|$(REPLACE_STPNCPY)|g' \
 	      -e 's|@''REPLACE_STRCHRNUL''@|$(REPLACE_STRCHRNUL)|g' \
 	      -e 's|@''REPLACE_STRDUP''@|$(REPLACE_STRDUP)|g' \
@@ -11074,52 +13446,249 @@
 	      -e 's|@''REPLACE_STRTOK_R''@|$(REPLACE_STRTOK_R)|g' \
 	      -e 's|@''REPLACE_STRERROR''@|$(REPLACE_STRERROR)|g' \
 	      -e 's|@''REPLACE_STRERROR_R''@|$(REPLACE_STRERROR_R)|g' \
+	      -e 's|@''REPLACE_STRERRORNAME_NP''@|$(REPLACE_STRERRORNAME_NP)|g' \
 	      -e 's|@''REPLACE_STRSIGNAL''@|$(REPLACE_STRSIGNAL)|g' \
 	      -e 's|@''UNDEFINE_STRTOK_R''@|$(UNDEFINE_STRTOK_R)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	      < $(top_srcdir)/lib/string.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 
 # We need the following in order to create <sys/types.h> when the system
 # doesn't have one that works with the given compiler.
 lib/sys/types.h: lib/sys_types.in.h $(top_builddir)/config.status
-	$(AM_V_at)$(MKDIR_P) lib/sys
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib/sys'
+	$(AM_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_SYS_TYPES_H''@|$(NEXT_SYS_TYPES_H)|g' \
 	      -e 's|@''WINDOWS_64_BIT_OFF_T''@|$(WINDOWS_64_BIT_OFF_T)|g' \
 	      -e 's|@''WINDOWS_STAT_INODES''@|$(WINDOWS_STAT_INODES)|g' \
-	      < $(top_srcdir)/lib/sys_types.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/sys_types.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
+
+# We need the following in order to create an empty placeholder for
+# <unistd.h> when the system doesn't have one.
+lib/unistd.h: lib/unistd.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
+	      -e 's|@''HAVE_UNISTD_H''@|$(HAVE_UNISTD_H)|g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_UNISTD_H''@|$(NEXT_UNISTD_H)|g' \
+	      -e 's|@''WINDOWS_64_BIT_OFF_T''@|$(WINDOWS_64_BIT_OFF_T)|g' \
+	      -e 's/@''GNULIB_ACCESS''@/$(GL_GNULIB_ACCESS)/g' \
+	      -e 's/@''GNULIB_CHDIR''@/$(GL_GNULIB_CHDIR)/g' \
+	      -e 's/@''GNULIB_CHOWN''@/$(GL_GNULIB_CHOWN)/g' \
+	      -e 's/@''GNULIB_CLOSE''@/$(GL_GNULIB_CLOSE)/g' \
+	      -e 's/@''GNULIB_COPY_FILE_RANGE''@/$(GL_GNULIB_COPY_FILE_RANGE)/g' \
+	      -e 's/@''GNULIB_DUP''@/$(GL_GNULIB_DUP)/g' \
+	      -e 's/@''GNULIB_DUP2''@/$(GL_GNULIB_DUP2)/g' \
+	      -e 's/@''GNULIB_DUP3''@/$(GL_GNULIB_DUP3)/g' \
+	      -e 's/@''GNULIB_ENVIRON''@/$(GL_GNULIB_ENVIRON)/g' \
+	      -e 's/@''GNULIB_EUIDACCESS''@/$(GL_GNULIB_EUIDACCESS)/g' \
+	      -e 's/@''GNULIB_EXECL''@/$(GL_GNULIB_EXECL)/g' \
+	      -e 's/@''GNULIB_EXECLE''@/$(GL_GNULIB_EXECLE)/g' \
+	      -e 's/@''GNULIB_EXECLP''@/$(GL_GNULIB_EXECLP)/g' \
+	      -e 's/@''GNULIB_EXECV''@/$(GL_GNULIB_EXECV)/g' \
+	      -e 's/@''GNULIB_EXECVE''@/$(GL_GNULIB_EXECVE)/g' \
+	      -e 's/@''GNULIB_EXECVP''@/$(GL_GNULIB_EXECVP)/g' \
+	      -e 's/@''GNULIB_EXECVPE''@/$(GL_GNULIB_EXECVPE)/g' \
+	      -e 's/@''GNULIB_FACCESSAT''@/$(GL_GNULIB_FACCESSAT)/g' \
+	      -e 's/@''GNULIB_FCHDIR''@/$(GL_GNULIB_FCHDIR)/g' \
+	      -e 's/@''GNULIB_FCHOWNAT''@/$(GL_GNULIB_FCHOWNAT)/g' \
+	      -e 's/@''GNULIB_FDATASYNC''@/$(GL_GNULIB_FDATASYNC)/g' \
+	      -e 's/@''GNULIB_FSYNC''@/$(GL_GNULIB_FSYNC)/g' \
+	      -e 's/@''GNULIB_FTRUNCATE''@/$(GL_GNULIB_FTRUNCATE)/g' \
+	      -e 's/@''GNULIB_GETCWD''@/$(GL_GNULIB_GETCWD)/g' \
+	      -e 's/@''GNULIB_GETDOMAINNAME''@/$(GL_GNULIB_GETDOMAINNAME)/g' \
+	      -e 's/@''GNULIB_GETDTABLESIZE''@/$(GL_GNULIB_GETDTABLESIZE)/g' \
+	      -e 's/@''GNULIB_GETENTROPY''@/$(GL_GNULIB_GETENTROPY)/g' \
+	      -e 's/@''GNULIB_GETGROUPS''@/$(GL_GNULIB_GETGROUPS)/g' \
+	      -e 's/@''GNULIB_GETHOSTNAME''@/$(GL_GNULIB_GETHOSTNAME)/g' \
+	      -e 's/@''GNULIB_GETLOGIN''@/$(GL_GNULIB_GETLOGIN)/g' \
+	      -e 's/@''GNULIB_GETLOGIN_R''@/$(GL_GNULIB_GETLOGIN_R)/g' \
+	      -e 's/@''GNULIB_GETOPT_POSIX''@/$(GL_GNULIB_GETOPT_POSIX)/g' \
+	      -e 's/@''GNULIB_GETPAGESIZE''@/$(GL_GNULIB_GETPAGESIZE)/g' \
+	      -e 's/@''GNULIB_GETPASS''@/$(GL_GNULIB_GETPASS)/g' \
+	      -e 's/@''GNULIB_GETPASS_GNU''@/$(GL_GNULIB_GETPASS_GNU)/g' \
+	      -e 's/@''GNULIB_GETUSERSHELL''@/$(GL_GNULIB_GETUSERSHELL)/g' \
+	      -e 's/@''GNULIB_GROUP_MEMBER''@/$(GL_GNULIB_GROUP_MEMBER)/g' \
+	      -e 's/@''GNULIB_ISATTY''@/$(GL_GNULIB_ISATTY)/g' \
+	      -e 's/@''GNULIB_LCHOWN''@/$(GL_GNULIB_LCHOWN)/g' \
+	      -e 's/@''GNULIB_LINK''@/$(GL_GNULIB_LINK)/g' \
+	      -e 's/@''GNULIB_LINKAT''@/$(GL_GNULIB_LINKAT)/g' \
+	      -e 's/@''GNULIB_LSEEK''@/$(GL_GNULIB_LSEEK)/g' \
+	      -e 's/@''GNULIB_PIPE''@/$(GL_GNULIB_PIPE)/g' \
+	      -e 's/@''GNULIB_PIPE2''@/$(GL_GNULIB_PIPE2)/g' \
+	      -e 's/@''GNULIB_PREAD''@/$(GL_GNULIB_PREAD)/g' \
+	      -e 's/@''GNULIB_PWRITE''@/$(GL_GNULIB_PWRITE)/g' \
+	      -e 's/@''GNULIB_READ''@/$(GL_GNULIB_READ)/g' \
+	      -e 's/@''GNULIB_READLINK''@/$(GL_GNULIB_READLINK)/g' \
+	      -e 's/@''GNULIB_READLINKAT''@/$(GL_GNULIB_READLINKAT)/g' \
+	      -e 's/@''GNULIB_RMDIR''@/$(GL_GNULIB_RMDIR)/g' \
+	      -e 's/@''GNULIB_SETHOSTNAME''@/$(GL_GNULIB_SETHOSTNAME)/g' \
+	      -e 's/@''GNULIB_SLEEP''@/$(GL_GNULIB_SLEEP)/g' \
+	      -e 's/@''GNULIB_SYMLINK''@/$(GL_GNULIB_SYMLINK)/g' \
+	      -e 's/@''GNULIB_SYMLINKAT''@/$(GL_GNULIB_SYMLINKAT)/g' \
+	      -e 's/@''GNULIB_TRUNCATE''@/$(GL_GNULIB_TRUNCATE)/g' \
+	      -e 's/@''GNULIB_TTYNAME_R''@/$(GL_GNULIB_TTYNAME_R)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_GETOPT''@/0$(GL_GNULIB_UNISTD_H_GETOPT)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_NONBLOCKING''@/$(GL_GNULIB_UNISTD_H_NONBLOCKING)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_SIGPIPE''@/$(GL_GNULIB_UNISTD_H_SIGPIPE)/g' \
+	      -e 's/@''GNULIB_UNLINK''@/$(GL_GNULIB_UNLINK)/g' \
+	      -e 's/@''GNULIB_UNLINKAT''@/$(GL_GNULIB_UNLINKAT)/g' \
+	      -e 's/@''GNULIB_USLEEP''@/$(GL_GNULIB_USLEEP)/g' \
+	      -e 's/@''GNULIB_WRITE''@/$(GL_GNULIB_WRITE)/g' \
+	      -e 's/@''GNULIB_MDA_ACCESS''@/$(GL_GNULIB_MDA_ACCESS)/g' \
+	      -e 's/@''GNULIB_MDA_CHDIR''@/$(GL_GNULIB_MDA_CHDIR)/g' \
+	      -e 's/@''GNULIB_MDA_CLOSE''@/$(GL_GNULIB_MDA_CLOSE)/g' \
+	      -e 's/@''GNULIB_MDA_DUP''@/$(GL_GNULIB_MDA_DUP)/g' \
+	      -e 's/@''GNULIB_MDA_DUP2''@/$(GL_GNULIB_MDA_DUP2)/g' \
+	      -e 's/@''GNULIB_MDA_EXECL''@/$(GL_GNULIB_MDA_EXECL)/g' \
+	      -e 's/@''GNULIB_MDA_EXECLE''@/$(GL_GNULIB_MDA_EXECLE)/g' \
+	      -e 's/@''GNULIB_MDA_EXECLP''@/$(GL_GNULIB_MDA_EXECLP)/g' \
+	      -e 's/@''GNULIB_MDA_EXECV''@/$(GL_GNULIB_MDA_EXECV)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVE''@/$(GL_GNULIB_MDA_EXECVE)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVP''@/$(GL_GNULIB_MDA_EXECVP)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVPE''@/$(GL_GNULIB_MDA_EXECVPE)/g' \
+	      -e 's/@''GNULIB_MDA_GETCWD''@/$(GL_GNULIB_MDA_GETCWD)/g' \
+	      -e 's/@''GNULIB_MDA_GETPID''@/$(GL_GNULIB_MDA_GETPID)/g' \
+	      -e 's/@''GNULIB_MDA_ISATTY''@/$(GL_GNULIB_MDA_ISATTY)/g' \
+	      -e 's/@''GNULIB_MDA_LSEEK''@/$(GL_GNULIB_MDA_LSEEK)/g' \
+	      -e 's/@''GNULIB_MDA_READ''@/$(GL_GNULIB_MDA_READ)/g' \
+	      -e 's/@''GNULIB_MDA_RMDIR''@/$(GL_GNULIB_MDA_RMDIR)/g' \
+	      -e 's/@''GNULIB_MDA_SWAB''@/$(GL_GNULIB_MDA_SWAB)/g' \
+	      -e 's/@''GNULIB_MDA_UNLINK''@/$(GL_GNULIB_MDA_UNLINK)/g' \
+	      -e 's/@''GNULIB_MDA_WRITE''@/$(GL_GNULIB_MDA_WRITE)/g' \
+	      < $(top_srcdir)/lib/unistd.in.h | \
+	  sed -e 's|@''HAVE_CHOWN''@|$(HAVE_CHOWN)|g' \
+	      -e 's|@''HAVE_COPY_FILE_RANGE''@|$(HAVE_COPY_FILE_RANGE)|g' \
+	      -e 's|@''HAVE_DUP3''@|$(HAVE_DUP3)|g' \
+	      -e 's|@''HAVE_EUIDACCESS''@|$(HAVE_EUIDACCESS)|g' \
+	      -e 's|@''HAVE_EXECVPE''@|$(HAVE_EXECVPE)|g' \
+	      -e 's|@''HAVE_FACCESSAT''@|$(HAVE_FACCESSAT)|g' \
+	      -e 's|@''HAVE_FCHDIR''@|$(HAVE_FCHDIR)|g' \
+	      -e 's|@''HAVE_FCHOWNAT''@|$(HAVE_FCHOWNAT)|g' \
+	      -e 's|@''HAVE_FDATASYNC''@|$(HAVE_FDATASYNC)|g' \
+	      -e 's|@''HAVE_FSYNC''@|$(HAVE_FSYNC)|g' \
+	      -e 's|@''HAVE_FTRUNCATE''@|$(HAVE_FTRUNCATE)|g' \
+	      -e 's|@''HAVE_GETDTABLESIZE''@|$(HAVE_GETDTABLESIZE)|g' \
+	      -e 's|@''HAVE_GETENTROPY''@|$(HAVE_GETENTROPY)|g' \
+	      -e 's|@''HAVE_GETGROUPS''@|$(HAVE_GETGROUPS)|g' \
+	      -e 's|@''HAVE_GETHOSTNAME''@|$(HAVE_GETHOSTNAME)|g' \
+	      -e 's|@''HAVE_GETPAGESIZE''@|$(HAVE_GETPAGESIZE)|g' \
+	      -e 's|@''HAVE_GETPASS''@|$(HAVE_GETPASS)|g' \
+	      -e 's|@''HAVE_GROUP_MEMBER''@|$(HAVE_GROUP_MEMBER)|g' \
+	      -e 's|@''HAVE_LCHOWN''@|$(HAVE_LCHOWN)|g' \
+	      -e 's|@''HAVE_LINK''@|$(HAVE_LINK)|g' \
+	      -e 's|@''HAVE_LINKAT''@|$(HAVE_LINKAT)|g' \
+	      -e 's|@''HAVE_PIPE''@|$(HAVE_PIPE)|g' \
+	      -e 's|@''HAVE_PIPE2''@|$(HAVE_PIPE2)|g' \
+	      -e 's|@''HAVE_PREAD''@|$(HAVE_PREAD)|g' \
+	      -e 's|@''HAVE_PWRITE''@|$(HAVE_PWRITE)|g' \
+	      -e 's|@''HAVE_READLINK''@|$(HAVE_READLINK)|g' \
+	      -e 's|@''HAVE_READLINKAT''@|$(HAVE_READLINKAT)|g' \
+	      -e 's|@''HAVE_SETHOSTNAME''@|$(HAVE_SETHOSTNAME)|g' \
+	      -e 's|@''HAVE_SLEEP''@|$(HAVE_SLEEP)|g' \
+	      -e 's|@''HAVE_SYMLINK''@|$(HAVE_SYMLINK)|g' \
+	      -e 's|@''HAVE_SYMLINKAT''@|$(HAVE_SYMLINKAT)|g' \
+	      -e 's|@''HAVE_UNLINKAT''@|$(HAVE_UNLINKAT)|g' \
+	      -e 's|@''HAVE_USLEEP''@|$(HAVE_USLEEP)|g' \
+	      -e 's|@''HAVE_DECL_ENVIRON''@|$(HAVE_DECL_ENVIRON)|g' \
+	      -e 's|@''HAVE_DECL_EXECVPE''@|$(HAVE_DECL_EXECVPE)|g' \
+	      -e 's|@''HAVE_DECL_FCHDIR''@|$(HAVE_DECL_FCHDIR)|g' \
+	      -e 's|@''HAVE_DECL_FDATASYNC''@|$(HAVE_DECL_FDATASYNC)|g' \
+	      -e 's|@''HAVE_DECL_GETDOMAINNAME''@|$(HAVE_DECL_GETDOMAINNAME)|g' \
+	      -e 's|@''HAVE_DECL_GETLOGIN''@|$(HAVE_DECL_GETLOGIN)|g' \
+	      -e 's|@''HAVE_DECL_GETLOGIN_R''@|$(HAVE_DECL_GETLOGIN_R)|g' \
+	      -e 's|@''HAVE_DECL_GETPAGESIZE''@|$(HAVE_DECL_GETPAGESIZE)|g' \
+	      -e 's|@''HAVE_DECL_GETUSERSHELL''@|$(HAVE_DECL_GETUSERSHELL)|g' \
+	      -e 's|@''HAVE_DECL_SETHOSTNAME''@|$(HAVE_DECL_SETHOSTNAME)|g' \
+	      -e 's|@''HAVE_DECL_TRUNCATE''@|$(HAVE_DECL_TRUNCATE)|g' \
+	      -e 's|@''HAVE_DECL_TTYNAME_R''@|$(HAVE_DECL_TTYNAME_R)|g' \
+	      -e 's|@''HAVE_OS_H''@|$(HAVE_OS_H)|g' \
+	      -e 's|@''HAVE_SYS_PARAM_H''@|$(HAVE_SYS_PARAM_H)|g' \
+	  | \
+	  sed -e 's|@''REPLACE_ACCESS''@|$(REPLACE_ACCESS)|g' \
+	      -e 's|@''REPLACE_CHOWN''@|$(REPLACE_CHOWN)|g' \
+	      -e 's|@''REPLACE_CLOSE''@|$(REPLACE_CLOSE)|g' \
+	      -e 's|@''REPLACE_COPY_FILE_RANGE''@|$(REPLACE_COPY_FILE_RANGE)|g' \
+	      -e 's|@''REPLACE_DUP''@|$(REPLACE_DUP)|g' \
+	      -e 's|@''REPLACE_DUP2''@|$(REPLACE_DUP2)|g' \
+	      -e 's|@''REPLACE_DUP3''@|$(REPLACE_DUP3)|g' \
+	      -e 's|@''REPLACE_EXECL''@|$(REPLACE_EXECL)|g' \
+	      -e 's|@''REPLACE_EXECLE''@|$(REPLACE_EXECLE)|g' \
+	      -e 's|@''REPLACE_EXECLP''@|$(REPLACE_EXECLP)|g' \
+	      -e 's|@''REPLACE_EXECV''@|$(REPLACE_EXECV)|g' \
+	      -e 's|@''REPLACE_EXECVE''@|$(REPLACE_EXECVE)|g' \
+	      -e 's|@''REPLACE_EXECVP''@|$(REPLACE_EXECVP)|g' \
+	      -e 's|@''REPLACE_EXECVPE''@|$(REPLACE_EXECVPE)|g' \
+	      -e 's|@''REPLACE_FACCESSAT''@|$(REPLACE_FACCESSAT)|g' \
+	      -e 's|@''REPLACE_FCHOWNAT''@|$(REPLACE_FCHOWNAT)|g' \
+	      -e 's|@''REPLACE_FDATASYNC''@|$(REPLACE_FDATASYNC)|g' \
+	      -e 's|@''REPLACE_FTRUNCATE''@|$(REPLACE_FTRUNCATE)|g' \
+	      -e 's|@''REPLACE_GETCWD''@|$(REPLACE_GETCWD)|g' \
+	      -e 's|@''REPLACE_GETDOMAINNAME''@|$(REPLACE_GETDOMAINNAME)|g' \
+	      -e 's|@''REPLACE_GETDTABLESIZE''@|$(REPLACE_GETDTABLESIZE)|g' \
+	      -e 's|@''REPLACE_GETENTROPY''@|$(REPLACE_GETENTROPY)|g' \
+	      -e 's|@''REPLACE_GETLOGIN_R''@|$(REPLACE_GETLOGIN_R)|g' \
+	      -e 's|@''REPLACE_GETGROUPS''@|$(REPLACE_GETGROUPS)|g' \
+	      -e 's|@''REPLACE_GETPAGESIZE''@|$(REPLACE_GETPAGESIZE)|g' \
+	      -e 's|@''REPLACE_GETPASS''@|$(REPLACE_GETPASS)|g' \
+	      -e 's|@''REPLACE_GETPASS_FOR_GETPASS_GNU''@|$(REPLACE_GETPASS_FOR_GETPASS_GNU)|g' \
+	      -e 's|@''REPLACE_ISATTY''@|$(REPLACE_ISATTY)|g' \
+	      -e 's|@''REPLACE_LCHOWN''@|$(REPLACE_LCHOWN)|g' \
+	      -e 's|@''REPLACE_LINK''@|$(REPLACE_LINK)|g' \
+	      -e 's|@''REPLACE_LINKAT''@|$(REPLACE_LINKAT)|g' \
+	      -e 's|@''REPLACE_LSEEK''@|$(REPLACE_LSEEK)|g' \
+	      -e 's|@''REPLACE_PIPE2''@|$(REPLACE_PIPE2)|g' \
+	      -e 's|@''REPLACE_PREAD''@|$(REPLACE_PREAD)|g' \
+	      -e 's|@''REPLACE_PWRITE''@|$(REPLACE_PWRITE)|g' \
+	      -e 's|@''REPLACE_READ''@|$(REPLACE_READ)|g' \
+	      -e 's|@''REPLACE_READLINK''@|$(REPLACE_READLINK)|g' \
+	      -e 's|@''REPLACE_READLINKAT''@|$(REPLACE_READLINKAT)|g' \
+	      -e 's|@''REPLACE_RMDIR''@|$(REPLACE_RMDIR)|g' \
+	      -e 's|@''REPLACE_SETHOSTNAME''@|$(REPLACE_SETHOSTNAME)|g' \
+	      -e 's|@''REPLACE_SLEEP''@|$(REPLACE_SLEEP)|g' \
+	      -e 's|@''REPLACE_SYMLINK''@|$(REPLACE_SYMLINK)|g' \
+	      -e 's|@''REPLACE_SYMLINKAT''@|$(REPLACE_SYMLINKAT)|g' \
+	      -e 's|@''REPLACE_TRUNCATE''@|$(REPLACE_TRUNCATE)|g' \
+	      -e 's|@''REPLACE_TTYNAME_R''@|$(REPLACE_TTYNAME_R)|g' \
+	      -e 's|@''REPLACE_UNLINK''@|$(REPLACE_UNLINK)|g' \
+	      -e 's|@''REPLACE_UNLINKAT''@|$(REPLACE_UNLINKAT)|g' \
+	      -e 's|@''REPLACE_USLEEP''@|$(REPLACE_USLEEP)|g' \
+	      -e 's|@''REPLACE_WRITE''@|$(REPLACE_WRITE)|g' \
+	      -e 's|@''UNISTD_H_HAVE_SYS_RANDOM_H''@|$(UNISTD_H_HAVE_SYS_RANDOM_H)|g' \
+	      -e 's|@''UNISTD_H_HAVE_WINSOCK2_H''@|$(UNISTD_H_HAVE_WINSOCK2_H)|g' \
+	      -e 's|@''UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS''@|$(UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS)|g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 
 lib/unitypes.h: lib/unitypes.in.h
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  cat $(top_srcdir)/lib/unitypes.in.h; \
-	} > $@-t && \
-	mv -f $@-t $@
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_TO_AT_t) $(top_srcdir)/lib/unitypes.in.h
+	$(AM_V_at)mv $@-t $@
 
 lib/uniwidth.h: lib/uniwidth.in.h
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  cat $(top_srcdir)/lib/uniwidth.in.h; \
-	} > $@-t && \
-	mv -f $@-t $@
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_TO_AT_t) $(top_srcdir)/lib/uniwidth.in.h
+	$(AM_V_at)mv $@-t $@
 
 # We need the following in order to create <wchar.h> when the system
 # version does not work standalone.
 lib/wchar.h: lib/wchar.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -11127,47 +13696,50 @@
 	      -e 's|@''NEXT_WCHAR_H''@|$(NEXT_WCHAR_H)|g' \
 	      -e 's|@''HAVE_WCHAR_H''@|$(HAVE_WCHAR_H)|g' \
 	      -e 's/@''HAVE_CRTDEFS_H''@/$(HAVE_CRTDEFS_H)/g' \
-	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-	      -e 's/@''GNULIB_BTOWC''@/$(GNULIB_BTOWC)/g' \
-	      -e 's/@''GNULIB_WCTOB''@/$(GNULIB_WCTOB)/g' \
-	      -e 's/@''GNULIB_MBSINIT''@/$(GNULIB_MBSINIT)/g' \
-	      -e 's/@''GNULIB_MBRTOWC''@/$(GNULIB_MBRTOWC)/g' \
-	      -e 's/@''GNULIB_MBRLEN''@/$(GNULIB_MBRLEN)/g' \
-	      -e 's/@''GNULIB_MBSRTOWCS''@/$(GNULIB_MBSRTOWCS)/g' \
-	      -e 's/@''GNULIB_MBSNRTOWCS''@/$(GNULIB_MBSNRTOWCS)/g' \
-	      -e 's/@''GNULIB_WCRTOMB''@/$(GNULIB_WCRTOMB)/g' \
-	      -e 's/@''GNULIB_WCSRTOMBS''@/$(GNULIB_WCSRTOMBS)/g' \
-	      -e 's/@''GNULIB_WCSNRTOMBS''@/$(GNULIB_WCSNRTOMBS)/g' \
-	      -e 's/@''GNULIB_WCWIDTH''@/$(GNULIB_WCWIDTH)/g' \
-	      -e 's/@''GNULIB_WMEMCHR''@/$(GNULIB_WMEMCHR)/g' \
-	      -e 's/@''GNULIB_WMEMCMP''@/$(GNULIB_WMEMCMP)/g' \
-	      -e 's/@''GNULIB_WMEMCPY''@/$(GNULIB_WMEMCPY)/g' \
-	      -e 's/@''GNULIB_WMEMMOVE''@/$(GNULIB_WMEMMOVE)/g' \
-	      -e 's/@''GNULIB_WMEMSET''@/$(GNULIB_WMEMSET)/g' \
-	      -e 's/@''GNULIB_WCSLEN''@/$(GNULIB_WCSLEN)/g' \
-	      -e 's/@''GNULIB_WCSNLEN''@/$(GNULIB_WCSNLEN)/g' \
-	      -e 's/@''GNULIB_WCSCPY''@/$(GNULIB_WCSCPY)/g' \
-	      -e 's/@''GNULIB_WCPCPY''@/$(GNULIB_WCPCPY)/g' \
-	      -e 's/@''GNULIB_WCSNCPY''@/$(GNULIB_WCSNCPY)/g' \
-	      -e 's/@''GNULIB_WCPNCPY''@/$(GNULIB_WCPNCPY)/g' \
-	      -e 's/@''GNULIB_WCSCAT''@/$(GNULIB_WCSCAT)/g' \
-	      -e 's/@''GNULIB_WCSNCAT''@/$(GNULIB_WCSNCAT)/g' \
-	      -e 's/@''GNULIB_WCSCMP''@/$(GNULIB_WCSCMP)/g' \
-	      -e 's/@''GNULIB_WCSNCMP''@/$(GNULIB_WCSNCMP)/g' \
-	      -e 's/@''GNULIB_WCSCASECMP''@/$(GNULIB_WCSCASECMP)/g' \
-	      -e 's/@''GNULIB_WCSNCASECMP''@/$(GNULIB_WCSNCASECMP)/g' \
-	      -e 's/@''GNULIB_WCSCOLL''@/$(GNULIB_WCSCOLL)/g' \
-	      -e 's/@''GNULIB_WCSXFRM''@/$(GNULIB_WCSXFRM)/g' \
-	      -e 's/@''GNULIB_WCSDUP''@/$(GNULIB_WCSDUP)/g' \
-	      -e 's/@''GNULIB_WCSCHR''@/$(GNULIB_WCSCHR)/g' \
-	      -e 's/@''GNULIB_WCSRCHR''@/$(GNULIB_WCSRCHR)/g' \
-	      -e 's/@''GNULIB_WCSCSPN''@/$(GNULIB_WCSCSPN)/g' \
-	      -e 's/@''GNULIB_WCSSPN''@/$(GNULIB_WCSSPN)/g' \
-	      -e 's/@''GNULIB_WCSPBRK''@/$(GNULIB_WCSPBRK)/g' \
-	      -e 's/@''GNULIB_WCSSTR''@/$(GNULIB_WCSSTR)/g' \
-	      -e 's/@''GNULIB_WCSTOK''@/$(GNULIB_WCSTOK)/g' \
-	      -e 's/@''GNULIB_WCSWIDTH''@/$(GNULIB_WCSWIDTH)/g' \
-	      -e 's/@''GNULIB_WCSFTIME''@/$(GNULIB_WCSFTIME)/g' \
+	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+	      -e 's/@''GNULIB_BTOWC''@/$(GL_GNULIB_BTOWC)/g' \
+	      -e 's/@''GNULIB_WCTOB''@/$(GL_GNULIB_WCTOB)/g' \
+	      -e 's/@''GNULIB_MBSINIT''@/$(GL_GNULIB_MBSINIT)/g' \
+	      -e 's/@''GNULIB_MBRTOWC''@/$(GL_GNULIB_MBRTOWC)/g' \
+	      -e 's/@''GNULIB_MBRLEN''@/$(GL_GNULIB_MBRLEN)/g' \
+	      -e 's/@''GNULIB_MBSRTOWCS''@/$(GL_GNULIB_MBSRTOWCS)/g' \
+	      -e 's/@''GNULIB_MBSNRTOWCS''@/$(GL_GNULIB_MBSNRTOWCS)/g' \
+	      -e 's/@''GNULIB_WCRTOMB''@/$(GL_GNULIB_WCRTOMB)/g' \
+	      -e 's/@''GNULIB_WCSRTOMBS''@/$(GL_GNULIB_WCSRTOMBS)/g' \
+	      -e 's/@''GNULIB_WCSNRTOMBS''@/$(GL_GNULIB_WCSNRTOMBS)/g' \
+	      -e 's/@''GNULIB_WCWIDTH''@/$(GL_GNULIB_WCWIDTH)/g' \
+	      -e 's/@''GNULIB_WMEMCHR''@/$(GL_GNULIB_WMEMCHR)/g' \
+	      -e 's/@''GNULIB_WMEMCMP''@/$(GL_GNULIB_WMEMCMP)/g' \
+	      -e 's/@''GNULIB_WMEMCPY''@/$(GL_GNULIB_WMEMCPY)/g' \
+	      -e 's/@''GNULIB_WMEMMOVE''@/$(GL_GNULIB_WMEMMOVE)/g' \
+	      -e 's/@''GNULIB_WMEMPCPY''@/$(GL_GNULIB_WMEMPCPY)/g' \
+	      -e 's/@''GNULIB_WMEMSET''@/$(GL_GNULIB_WMEMSET)/g' \
+	      -e 's/@''GNULIB_WCSLEN''@/$(GL_GNULIB_WCSLEN)/g' \
+	      -e 's/@''GNULIB_WCSNLEN''@/$(GL_GNULIB_WCSNLEN)/g' \
+	      -e 's/@''GNULIB_WCSCPY''@/$(GL_GNULIB_WCSCPY)/g' \
+	      -e 's/@''GNULIB_WCPCPY''@/$(GL_GNULIB_WCPCPY)/g' \
+	      -e 's/@''GNULIB_WCSNCPY''@/$(GL_GNULIB_WCSNCPY)/g' \
+	      -e 's/@''GNULIB_WCPNCPY''@/$(GL_GNULIB_WCPNCPY)/g' \
+	      -e 's/@''GNULIB_WCSCAT''@/$(GL_GNULIB_WCSCAT)/g' \
+	      -e 's/@''GNULIB_WCSNCAT''@/$(GL_GNULIB_WCSNCAT)/g' \
+	      -e 's/@''GNULIB_WCSCMP''@/$(GL_GNULIB_WCSCMP)/g' \
+	      -e 's/@''GNULIB_WCSNCMP''@/$(GL_GNULIB_WCSNCMP)/g' \
+	      -e 's/@''GNULIB_WCSCASECMP''@/$(GL_GNULIB_WCSCASECMP)/g' \
+	      -e 's/@''GNULIB_WCSNCASECMP''@/$(GL_GNULIB_WCSNCASECMP)/g' \
+	      -e 's/@''GNULIB_WCSCOLL''@/$(GL_GNULIB_WCSCOLL)/g' \
+	      -e 's/@''GNULIB_WCSXFRM''@/$(GL_GNULIB_WCSXFRM)/g' \
+	      -e 's/@''GNULIB_WCSDUP''@/$(GL_GNULIB_WCSDUP)/g' \
+	      -e 's/@''GNULIB_WCSCHR''@/$(GL_GNULIB_WCSCHR)/g' \
+	      -e 's/@''GNULIB_WCSRCHR''@/$(GL_GNULIB_WCSRCHR)/g' \
+	      -e 's/@''GNULIB_WCSCSPN''@/$(GL_GNULIB_WCSCSPN)/g' \
+	      -e 's/@''GNULIB_WCSSPN''@/$(GL_GNULIB_WCSSPN)/g' \
+	      -e 's/@''GNULIB_WCSPBRK''@/$(GL_GNULIB_WCSPBRK)/g' \
+	      -e 's/@''GNULIB_WCSSTR''@/$(GL_GNULIB_WCSSTR)/g' \
+	      -e 's/@''GNULIB_WCSTOK''@/$(GL_GNULIB_WCSTOK)/g' \
+	      -e 's/@''GNULIB_WCSWIDTH''@/$(GL_GNULIB_WCSWIDTH)/g' \
+	      -e 's/@''GNULIB_WCSFTIME''@/$(GL_GNULIB_WCSFTIME)/g' \
+	      -e 's/@''GNULIB_MDA_WCSDUP''@/$(GL_GNULIB_MDA_WCSDUP)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
 	      < $(top_srcdir)/lib/wchar.in.h | \
 	  sed -e 's|@''HAVE_WINT_T''@|$(HAVE_WINT_T)|g' \
 	      -e 's|@''HAVE_BTOWC''@|$(HAVE_BTOWC)|g' \
@@ -11183,6 +13755,7 @@
 	      -e 's|@''HAVE_WMEMCMP''@|$(HAVE_WMEMCMP)|g' \
 	      -e 's|@''HAVE_WMEMCPY''@|$(HAVE_WMEMCPY)|g' \
 	      -e 's|@''HAVE_WMEMMOVE''@|$(HAVE_WMEMMOVE)|g' \
+	      -e 's|@''HAVE_WMEMPCPY''@|$(HAVE_WMEMPCPY)|g' \
 	      -e 's|@''HAVE_WMEMSET''@|$(HAVE_WMEMSET)|g' \
 	      -e 's|@''HAVE_WCSLEN''@|$(HAVE_WCSLEN)|g' \
 	      -e 's|@''HAVE_WCSNLEN''@|$(HAVE_WCSNLEN)|g' \
@@ -11209,11 +13782,13 @@
 	      -e 's|@''HAVE_WCSWIDTH''@|$(HAVE_WCSWIDTH)|g' \
 	      -e 's|@''HAVE_WCSFTIME''@|$(HAVE_WCSFTIME)|g' \
 	      -e 's|@''HAVE_DECL_WCTOB''@|$(HAVE_DECL_WCTOB)|g' \
+	      -e 's|@''HAVE_DECL_WCSDUP''@|$(HAVE_DECL_WCSDUP)|g' \
 	      -e 's|@''HAVE_DECL_WCWIDTH''@|$(HAVE_DECL_WCWIDTH)|g' \
 	  | \
 	  sed -e 's|@''REPLACE_MBSTATE_T''@|$(REPLACE_MBSTATE_T)|g' \
 	      -e 's|@''REPLACE_BTOWC''@|$(REPLACE_BTOWC)|g' \
 	      -e 's|@''REPLACE_WCTOB''@|$(REPLACE_WCTOB)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
 	      -e 's|@''REPLACE_MBSINIT''@|$(REPLACE_MBSINIT)|g' \
 	      -e 's|@''REPLACE_MBRTOWC''@|$(REPLACE_MBRTOWC)|g' \
 	      -e 's|@''REPLACE_MBRLEN''@|$(REPLACE_MBRLEN)|g' \
@@ -11225,43 +13800,48 @@
 	      -e 's|@''REPLACE_WCWIDTH''@|$(REPLACE_WCWIDTH)|g' \
 	      -e 's|@''REPLACE_WCSWIDTH''@|$(REPLACE_WCSWIDTH)|g' \
 	      -e 's|@''REPLACE_WCSFTIME''@|$(REPLACE_WCSFTIME)|g' \
+	      -e 's|@''REPLACE_WCSTOK''@|$(REPLACE_WCSTOK)|g' \
+	      -e 's|@''REPLACE_WMEMPCPY''@|$(REPLACE_WMEMPCPY)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 
 # We need the following in order to create <wctype.h> when the system
 # doesn't have one that works with the given compiler.
 lib/wctype.h: lib/wctype.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) 'lib'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's/@''HAVE_WCTYPE_H''@/$(HAVE_WCTYPE_H)/g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_WCTYPE_H''@|$(NEXT_WCTYPE_H)|g' \
 	      -e 's/@''HAVE_CRTDEFS_H''@/$(HAVE_CRTDEFS_H)/g' \
-	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-	      -e 's/@''GNULIB_ISWBLANK''@/$(GNULIB_ISWBLANK)/g' \
-	      -e 's/@''GNULIB_WCTYPE''@/$(GNULIB_WCTYPE)/g' \
-	      -e 's/@''GNULIB_ISWCTYPE''@/$(GNULIB_ISWCTYPE)/g' \
-	      -e 's/@''GNULIB_WCTRANS''@/$(GNULIB_WCTRANS)/g' \
-	      -e 's/@''GNULIB_TOWCTRANS''@/$(GNULIB_TOWCTRANS)/g' \
+	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+	      -e 's/@''GNULIB_ISWBLANK''@/$(GL_GNULIB_ISWBLANK)/g' \
+	      -e 's/@''GNULIB_ISWDIGIT''@/$(GL_GNULIB_ISWDIGIT)/g' \
+	      -e 's/@''GNULIB_ISWXDIGIT''@/$(GL_GNULIB_ISWXDIGIT)/g' \
+	      -e 's/@''GNULIB_WCTYPE''@/$(GL_GNULIB_WCTYPE)/g' \
+	      -e 's/@''GNULIB_ISWCTYPE''@/$(GL_GNULIB_ISWCTYPE)/g' \
+	      -e 's/@''GNULIB_WCTRANS''@/$(GL_GNULIB_WCTRANS)/g' \
+	      -e 's/@''GNULIB_TOWCTRANS''@/$(GL_GNULIB_TOWCTRANS)/g' \
 	      -e 's/@''HAVE_ISWBLANK''@/$(HAVE_ISWBLANK)/g' \
 	      -e 's/@''HAVE_ISWCNTRL''@/$(HAVE_ISWCNTRL)/g' \
 	      -e 's/@''HAVE_WCTYPE_T''@/$(HAVE_WCTYPE_T)/g' \
 	      -e 's/@''HAVE_WCTRANS_T''@/$(HAVE_WCTRANS_T)/g' \
 	      -e 's/@''HAVE_WINT_T''@/$(HAVE_WINT_T)/g' \
 	      -e 's/@''REPLACE_ISWBLANK''@/$(REPLACE_ISWBLANK)/g' \
+	      -e 's/@''REPLACE_ISWDIGIT''@/$(REPLACE_ISWDIGIT)/g' \
+	      -e 's/@''REPLACE_ISWXDIGIT''@/$(REPLACE_ISWXDIGIT)/g' \
 	      -e 's/@''REPLACE_ISWCNTRL''@/$(REPLACE_ISWCNTRL)/g' \
 	      -e 's/@''REPLACE_TOWLOWER''@/$(REPLACE_TOWLOWER)/g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
-	      < $(top_srcdir)/lib/wctype.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/wctype.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 
 mostlyclean-local: mostlyclean-generic
 	@for dir in '' $(MOSTLYCLEANDIRS); do \
@@ -11270,23 +13850,28 @@
 	  fi; \
 	done; \
 	:
+distclean-local: distclean-gnulib-libobjs
+distclean-gnulib-libobjs:
+	-rm -f @gl_LIBOBJDEPS@
+maintainer-clean-local: distclean-gnulib-libobjs
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-shdeps.sed: $(top_srcdir)/arch/misc/shdeps.sh
-	$(SHELL) $(top_srcdir)/arch/misc/shdeps.sh "$(RT_SEP)" "$(SH_SEP)" "$(bindir)" > $@
+$(SH_DEPS_SED_SCRIPT): $(top_srcdir)/$(arch_shdeps_sh)
+	$(AM_V_GEN)$(SHELL) $(top_srcdir)/$(arch_shdeps_sh) \
+	  "$(RT_SEP)" "$(SH_SEP)" "$(bindir)" > $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-# This is strangly built but not installed
+# This is strangely built but not installed
 all: contrib/chem/README
 
 contrib/chem/README: $(chem_srcdir)/README.txt
@@ -11316,19 +13901,19 @@
 
 install-data-local: install_chem_extra
 install_chem_extra:
-@BUILD_EXAMPLES_TRUE@	-test -d $(DESTDIR)$(chemexample122dir) \
-@BUILD_EXAMPLES_TRUE@          || $(mkinstalldirs) $(DESTDIR)$(chemexample122dir);
-@BUILD_EXAMPLES_TRUE@	for i in $(chem_srcdir)/examples/122/*.chem; do \
-@BUILD_EXAMPLES_TRUE@	  n=`echo $$i | sed 's|$(chem_srcdir)/examples/122/||g'`; \
-@BUILD_EXAMPLES_TRUE@	  $(INSTALL_DATA) $$i $(DESTDIR)$(chemexample122dir)/$$n; \
-@BUILD_EXAMPLES_TRUE@	done
+	-test -d $(DESTDIR)$(chemexample122dir) \
+          || $(mkinstalldirs) $(DESTDIR)$(chemexample122dir);
+	for i in $(chem_srcdir)/examples/122/*.chem; do \
+	  n=`echo $$i | sed 's|$(chem_srcdir)/examples/122/||g'`; \
+	  $(INSTALL_DATA) $$i $(DESTDIR)$(chemexample122dir)/$$n; \
+	done
 
 uninstall-local: uninstall_chem_extra
 uninstall_chem_extra:
-@BUILD_EXAMPLES_TRUE@	$(RM) $(DESTDIR)$(exampledir)/chem/122/*
-@BUILD_EXAMPLES_TRUE@	-rmdir $(DESTDIR)$(exampledir)/chem/122
-@BUILD_EXAMPLES_TRUE@	$(RM) $(DESTDIR)$(exampledir)/chem/*
-@BUILD_EXAMPLES_TRUE@	-rmdir $(DESTDIR)$(exampledir)/chem
+	$(RM) $(DESTDIR)$(exampledir)/chem/122/*
+	-rmdir $(DESTDIR)$(exampledir)/chem/122
+	$(RM) $(DESTDIR)$(exampledir)/chem/*
+	-rmdir $(DESTDIR)$(exampledir)/chem
 	-rmdir $(DESTDIR)$(datasubdir)/pic
 
 dist-hook: dist_chem
@@ -11338,15 +13923,11 @@
 	  cp -f $$i $(distdir)/contrib/chem/examples/122; \
 	done
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 eqn2graph: $(top_srcdir)/contrib/eqn2graph/eqn2graph.sh
 	$(AM_V_GEN)sed -e "s|@g@|$(g)|g" \
@@ -11355,11 +13936,11 @@
 	    >$@ \
 	&& chmod +x $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
 gdiffmk: $(gdiffmk_srcdir)/gdiffmk.sh
 	$(AM_V_GEN)sed -e "s|@BINDIR@|$(bindir)|g" \
@@ -11371,25 +13952,14 @@
 	    >$@ \
 	&& chmod +x $@
 
-clean-local: clean_gdiffmk_check
-clean_gdiffmk_check:
-	if test -d $(top_builddir)/contrib/gdiffmk/tests; then \
-	  cd $(top_builddir)/contrib/gdiffmk/tests && \
-	  $(abs_top_srcdir)/contrib/gdiffmk/tests/runtests.sh clean; \
-	fi
-
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 # create perl executable 'glilypond', being stored into 'bindir'
-glilypond: $(glilypond_srcdir)/glilypond.pl shdeps.sed
+glilypond: $(glilypond_srcdir)/glilypond.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)$(RM) $@ \
 	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	       -e "s|@g@|$(g)|g" \
@@ -11406,17 +13976,13 @@
 	  rmdir $(DESTDIR)$(glilyponddir); \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-gperl: $(top_srcdir)/contrib/gperl/gperl.pl shdeps.sed
+gperl: $(top_srcdir)/contrib/gperl/gperl.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)$(RM) $@ \
 	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	       -e "s|@g@|$(g)|g" \
@@ -11427,17 +13993,13 @@
 	       >$@ \
 	&& chmod +x $@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-gpinyin: contrib/gpinyin/gpinyin.pl
+gpinyin: contrib/gpinyin/gpinyin.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	    -e "s|@g@|$(g)|g" \
 	    -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
@@ -11454,15 +14016,11 @@
 	  rmdir $(DESTDIR)$(gpinyindir); \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 grap2graph: $(grap2graph_srcdir)/grap2graph.sh
 	$(AM_V_GEN)sed -e "s|@g@|$(g)|g" \
@@ -11471,86 +14029,37 @@
 	    >$@ \
 	&& chmod +x $@
 
-########################################################################
-### Emacs settings
-# Local Variables:
-# mode: makefile-automake
-# End:
-
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
-# mode: makefile-automake
 # fill-column: 72
-# End:
-# vim: set filetype=automake textwidth=72:
-
-$(ROFF2PROGS): $(groffer_srcdir)/roff2.pl
-	cp $(groffer_srcdir)/roff2.pl $@
-
-# we take roff2.man and replace the @ROFF2MODE@ by the type of file
-# (dvi, pdf, html etc ...)
-$(ROFF2MAN):  $(groffer_srcdir)/roff2.1.man
-	$(AM_V_GEN)$(MKDIR_P) contrib/groffer \
-	&& FILEMODE=`echo $@ | sed 's|contrib/groffer/roff2$a-za-z*$\.1\.man|\1|g'` \
-	&& sed -e 's/@ROFF2MODE@/'"$$FILEMODE"'/g' \
-	       $(groffer_srcdir)/roff2.1.man \
-	       > $@;
-
-groffer: $(GROFFER_PERL) $(GROFFER_REST) $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)sed -f "$(SH_DEPS_SED_SCRIPT)" \
-	   -e "s|@g@|$(g)|g" \
-	   -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
-	   -e "s|@libdir@|$(DESTDIR)$(libdir)|g" \
-	   -e "s|@groffer_dir@|$(DESTDIR)$(groffer_dir)|g" \
-	   -e "s|@VERSION@|$(VERSION)|g" \
-	   -e "$(SH_SCRIPT_SED_CMD)" \
-	   $(groffer_srcdir)/groffer.pl \
-	   >$@ \
-	&& chmod +x $@;
-
-uninstall_groffdirs: uninstall-groffer-hook
-uninstall-groffer-hook:
-	if test -d $(DESTDIR)$(grofferdir); then \
-	  rmdir $(DESTDIR)$(grofferdir); \
-	fi
-
-########################################################################
-# Editor settings
-########################################################################
-#
-# Local Variables:
 # mode: makefile-automake
-# fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
-$(hdtblexample_DATA): $(HDTBLSTRIPFILES)
-@BUILD_EXAMPLES_TRUE@contrib/hdtbl/examples/test-hdtbl.sh: $(top_builddir)/config.status \
-@BUILD_EXAMPLES_TRUE@	$(HDTBLPROCESSEDEXAMPLEFILES) $(top_srcdir)/contrib/hdtbl/examples/test-hdtbl.sh.in
-@BUILD_EXAMPLES_TRUE@	sed -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
-@BUILD_EXAMPLES_TRUE@	    -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
-@BUILD_EXAMPLES_TRUE@	    	$(top_srcdir)/contrib/hdtbl/examples/test-hdtbl.sh.in > $@
-@BUILD_EXAMPLES_TRUE@	chmod +x $@
+# vim: set autoindent filetype=automake textwidth=72:
+
+$(hdtblexample_DATA): $(HDTBLTMACFILES)
+contrib/hdtbl/examples/test-hdtbl.sh: \
+  $(top_builddir)/config.status \
+  $(HDTBLPROCESSEDEXAMPLEFILES) \
+  $(top_srcdir)/$(hdtbl_test_template)
+	$(AM_V_GEN)sed \
+	  -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
+	  -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
+	  $(top_srcdir)/$(hdtbl_test_template) > $@ \
+	&& chmod +x $@
 
 .roff.ps:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(HDTBLGROFF) -Tps \
+	&& $(HDTBLGROFF) -I $(doc_builddir) -I $(doc_srcdir) -Tps \
 	     -dfontpath=$(top_srcdir)/font \
 	     -dsopath=$(hdtbl_srcdir)/ \
 	     -mhdtbl $< >$@
+
 .in.roff:
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& sed -e "s|@fontdir@|$(fontdir)|" \
 	       -e "s|@EGREP@|$(EGREP)|" $< >$@
 
-$(HDTBLPROCESSEDEXAMPLEFILES): gnu.eps groff troff pic tbl \
-  contrib/hdtbl/examples/common.roff
-
-$(HDTBLSTRIPFILES): $(top_srcdir)/tmac/strip.sed
-	@$(MKDIR_P) `dirname $@`
-	sed -f $(top_srcdir)/tmac/strip.sed $(hdtbl_srcdir)/`basename $@`-u > $@;
+$(HDTBLPROCESSEDEXAMPLEFILES): $(DOC_GNU_EPS) groff troff eqn pic tbl \
+  grops font/devps/stamp contrib/hdtbl/examples/common.roff
 
 uninstall_groffdirs: uninstall-hdtbl-hook
 uninstall-hdtbl-hook:
@@ -11558,24 +14067,22 @@
 	  rmdir $(DESTDIR)$(hdtblexampledir); \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 mmroff: $(mm_srcdir)/mmroff.pl
-	$(AM_V_GEN)$(SED) -e 's;/usr/bin/perl;$(PERL);' \
-	    $(mm_srcdir)/mmroff.pl \
-	    >$@ \
-	&& chmod +x $@
+	$(AM_V_GEN)$(SED) \
+	  -e 's;@PERL@;$(PERL);' \
+	  -e 's;@VERSION@;$(VERSION);' \
+	  $(mm_srcdir)/mmroff.pl \
+	  >$@.tmp \
+	  && chmod +x $@.tmp \
+	  && mv $@.tmp $@
 
-# Special installation rules for m.tmac, mse.tmac, mmse.tmac, mm.tmac
-# and MMLOCALE
+# special installation rules for m.tmac, mse.tmac, mmse.tmac, mm.tmac
 install-data-local: install_mm
 install_mm:
 	-test -d $(DESTDIR)$(tmacdir) || $(mkinstalldirs) $(DESTDIR)$(tmacdir)
@@ -11590,19 +14097,11 @@
 	  $(mm_srcdir)/mmse.tmac > $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mmse.tmac
 	@$(SED) -e "s;^.mso m.tmac;.mso $(tmac_m_prefix)m.tmac;g" \
 	  $(mm_srcdir)/mm.tmac > $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mm.tmac
-	@for f in $(MMLOCALE); do \
-	  test -f $(DESTDIR)$(tmacdir)/mm/$$f \
-	    || touch $(DESTDIR)$(tmacdir)/mm/$$f; \
-	done
 uninstall-local: uninstall_mm
 uninstall_mm:
 	if test -d $(DESTDIR)$(mmexampledir); then \
 	  rmdir $(DESTDIR)$(mmexampledir); \
 	fi
-	-for f in $(MMLOCALE); do \
-	  test -s $(DESTDIR)$(tmacdir)/mm/$$f \
-	    || $(RM) $(DESTDIR)$(tmacdir)/mm/$$f; \
-	done
 	$(RM) $(DESTDIR)$(tmacdir)/tmac.$(tmac_m_prefix)m
 	$(RM) $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)m.tmac
 	$(RM) $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mm.tmac
@@ -11618,43 +14117,45 @@
 	  cp -f $$i $(distdir)/contrib/mm/; \
 	done
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-# vim: set filetype=automake:
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@contrib/mom/examples/tests-mom.sh: $(top_builddir)/config.status \
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@	$(MOMPROCESSEDEXAMPLEFILES)  $(top_srcdir)/contrib/mom/examples/test-mom.sh.in
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@	sed -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@            -e "s|@groff_have_urw_fonts@|$(groff_have_urw_fonts)|g" \
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@	    	$(top_srcdir)/contrib/mom/examples/test-mom.sh.in > $@
-@BUILD_PDFEXAMPLES_TRUE@@HAVE_PDFTOOLS_TRUE@	chmod +x $@
+# vim: set autoindent filetype=automake textwidth=72:
+contrib/mom/examples/tests-mom.sh: \
+  $(top_builddir)/config.status \
+  $(MOMPROCESSEDEXAMPLEFILES) \
+  $(top_srcdir)/$(mom_test_template)
+	$(AM_V_GEN)sed \
+	  -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
+	  -e "s|@groff_have_urw_fonts@|$(groff_have_urw_fonts)|g" \
+	  $(top_srcdir)/$(mom_test_template) > $@ \
+	&& chmod +x $@
 .mom.pdf:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
 	&& LC_ALL=C $(MOMPDFMOM) $< >$@
 
 $(MOMPROCESSEDEXAMPLEFILES): $(MOMNORMALFILES) \
-  groff troff gropdf pdfmom penguin.ps penguin.pdf \
-  gnu.eps font/devpdf/build_font_files
+  groff troff gropdf pdfmom penguin.ps penguin.pdf font/devpdf/stamp
 
 penguin.ps:
-	cp $(mom_srcdir)/examples/penguin.ps $@
+	$(AM_V_at)cp $(mom_srcdir)/examples/penguin.ps $@
 penguin.pdf:
-	cp $(mom_srcdir)/examples/penguin.pdf $@
+	$(AM_V_at)cp $(mom_srcdir)/examples/penguin.pdf $@
 
 install-data-hook: install_mom
 install_mom:
-@BUILD_PDFEXAMPLES_TRUE@	for f in $(PDFDOCFILE); do \
-@BUILD_PDFEXAMPLES_TRUE@	  $(RM) $(DESTDIR)$(pdfdocdir)/$$f; \
-@BUILD_PDFEXAMPLES_TRUE@	  ln -s $(exampledir)/mom/$$f $(DESTDIR)$(pdfdocdir)/$$f; \
-@BUILD_PDFEXAMPLES_TRUE@	done
+@USE_GROPDF_TRUE@	for f in $(PDFDOCFILE); do \
+@USE_GROPDF_TRUE@	  $(RM) $(DESTDIR)$(pdfdocdir)/$$f; \
+@USE_GROPDF_TRUE@	  ln -s $(exampledir)/mom/$$f $(DESTDIR)$(pdfdocdir)/$$f; \
+@USE_GROPDF_TRUE@	done
 
 uninstall_groffdirs: uninstall_mom
 uninstall_mom:
 	for f in $(PDFDOCFILE); do \
 	  $(RM) $(DESTDIR)$(pdfdocdir)/$$f; \
 	done
+	-rmdir $(DESTDIR)$(pdfdocdir)
 	if test -d $(DESTDIR)$(exampledir)/mom; then \
 	  rmdir $(DESTDIR)$(exampledir)/mom; \
 	fi
@@ -11662,21 +14163,22 @@
 	  rmdir $(DESTDIR)$(htmldocdir)/mom; \
 	fi
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-# vim: set filetype=automake:
+# vim: set autoindent filetype=automake textwidth=72:
 
 contrib/pdfmark/pdfmark.pdf: contrib/pdfmark/pdfmark.ms
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(PDFROFF) -mspdf --stylesheet=$(pdfmark_srcdir)/cover.ms \
-	     $(top_srcdir)/contrib/pdfmark/pdfmark.ms >$@
+	&& $(PDFROFF) -I $(doc_builddir) -I $(doc_srcdir) -mspdf \
+	  --stylesheet=$(pdfmark_srcdir)/cover.ms \
+	  $(top_srcdir)/contrib/pdfmark/pdfmark.ms >$@
 
 # The pdf files use the local script to generate.
-$(PDFDOCFILES): pdfroff groff troff gropdf 
-$(PDFDOCFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) gnu.eps
+$(PDFDOCFILES): pdfroff groff troff gropdf
+$(PDFDOCFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) \
+  $(DOC_GNU_EPS)
 
 pdfroff: contrib/pdfmark/pdfroff.sh $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)sed -f $(SH_DEPS_SED_SCRIPT) \
@@ -11693,19 +14195,13 @@
 
 uninstall_groffdirs: uninstall-pdfmark-hook
 uninstall-pdfmark-hook:
-@BUILD_PDFDOC_TRUE@	if test -d $(DESTDIR)$(pdfmarkpdfdocdir); then \
-@BUILD_PDFDOC_TRUE@	  rmdir $(DESTDIR)$(pdfmarkpdfdocdir); \
-@BUILD_PDFDOC_TRUE@	fi
+@USE_PDFROFF_TRUE@	-rmdir $(DESTDIR)$(pdfmarkpdfdocdir)
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 pic2graph: $(pic2graph_srcdir)/pic2graph.sh
 	$(AM_V_GEN)sed -e "s|@g@|$(g)|g" \
@@ -11714,365 +14210,532 @@
 	    >$@ \
 	&& chmod +x $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-doc/automake.pdf: doc/automake.mom \
-  groff troff gropdf pdfmom font/devpdf/build_font_files \
-  contrib/mom/om.tmac
+# vim: set autoindent filetype=automake textwidth=72:
 
-# For simplicity, we always call preconv, grn, and eqn.
-.me.txt:
+# Local Variables:
+# fill-column: 72
+# mode: makefile-automake
+# End:
+# vim: set autoindent filetype=automake textwidth=72:
+
+# The ordering of the sed -e expressions is important.
+$(sboxes_builddir)/msboxes.ms: $(SBOXES_EXAMPLEFILES) $(sboxesnotquine)
+	$(AM_V_at)mkdir -p $(sboxes_builddir)
+	$(AM_V_at)$(SED) -n -e '1,/REPLACEME/p' \
+	    $(SBOXES_EXAMPLEFILES) > $@.tmp
+	$(AM_V_at)$(SED) -f $(sboxesnotquine) \
+	    $(SBOXES_EXAMPLEFILES) >> $@.tmp
+	$(AM_V_at)$(SED) -n -e '/REPLACEME/,$$p' \
+	    $(SBOXES_EXAMPLEFILES) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
+
+$(sboxes_builddir)/msboxes.pdf: $(sboxes_builddir)/msboxes.ms \
+  $(dist_sboxestmac_DATA) groff troff gropdf font/devpdf/stamp
+	$(GROFF_V)$(DOC_GROFF) -M$(sboxes_srcdir) -ms -msboxes -Tpdf \
+	  $(sboxes_builddir)/msboxes.ms > $@
+
+uninstall_groffdirs: uninstall_sboxes
+uninstall_sboxes:
+	if test -d $(DESTDIR)$(exampledir)/sboxes; then \
+	  rmdir $(DESTDIR)$(exampledir)/sboxes; \
+	fi
+@USE_GROPDF_TRUE@	-rmdir $(DESTDIR)$(sboxespdfdocdir)
+
+# Local Variables:
+# fill-column: 72
+# mode: makefile-automake
+# End:
+# vim: set autoindent filetype=automake textwidth=72:
+
+@USE_GROHTML_TRUE@$(PROCESSEDDOCFILES_HTML): $(PROCESSEDFILES_DEPS_HTML)
+$(PROCESSEDDOCFILES_PS): $(PROCESSEDFILES_DEPS_PS)
+@USE_GROPDF_TRUE@$(PROCESSEDDOCFILES_PDF): $(PROCESSEDFILES_DEPS_PDF)
+$(PROCESSEDDOCFILES_TXT): $(PROCESSEDFILES_DEPS_TXT)
+doc/automake.pdf: doc/automake.mom pdfmom contrib/mom/om.tmac
+
+$(PROCESSEDEXAMPLEFILES_HTML): $(PROCESSEDFILES_DEPS_HTML)
+$(PROCESSEDEXAMPLEFILES_PS): $(PROCESSEDFILES_DEPS_PS)
+
+# This is a convenience target for (re-)generating all the man pages.
+man-all: $(GROFF_MAN_PAGES_ALL)
+
+# ...and for cleaning them.
+man-clean:
+	$(RM) $(GROFF_MAN_PAGES_ALL)
+
+# Many pages use tbl, a few use eqn, and soelim(1) uses pic.  We also
+# need groff's FreeEuro font so we can embed it.
+#
+# We embed the fonts (-P-e) to (1) honor the current PDF standard, (2)
+# ensure consistent rendering of the document, and (3) exercise this
+# feature of gropdf.
+doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) eqn pic tbl \
+  $(TMAC_PACKAGE_MAN) $(TMAC_PACKAGE_MDOC) font/devps/freeeuro.pfa
+	$(GROFF_V)$(DOC_GROFF) -pet -mandoc -dHF=HB -rC1 \
+	  -rCHECKSTYLE=3 -Tpdf -P-e \
+	  $(GROFF_MAN_PAGES1) \
+	  $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
+	  $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
+
+doc/groff-man-pages.utf8.txt: $(GROFF_MAN_PAGES_ALL) eqn pic tbl \
+  $(TMAC_PACKAGE_MAN) $(TMAC_PACKAGE_MDOC)
+	$(GROFF_V)$(DOC_GROFF) -pet -Tutf8 -mandoc \
+	  -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
+	  $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
+	  $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
+
+doc/grnexmpl.ps: $(doc_srcdir)/grnexmpl.me $(doc_srcdir)/grnexmpl.g \
+  grn eqn
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -k -Tutf8 -ge -me >$@
+	&& $(DOC_GROFF) -Tps -ge -me $(doc_srcdir)/grnexmpl.me >$@
+
+# Generating *.me from *.me.in is, surprisingly, a challenge.
+# 1.  A pattern rule ("%.me: %.me.in") is not portable to NetBSD or
+#     OpenBSD make.
+# 2.  A single-suffix rule works in an isolated Makefile, but _only_
+#     with the .SUFFIXES special target, not with the
+#     (Automake-specific) SUFFIXES macro.
+#       .SUFFIXES: .in
+#       .in:
+#		$(DOC_SED) $< >$@
+#     (One can validly complain that this approach is too general.)
+# 3.  GNU Automake insists that we use the SUFFIXES macro and not the
+#     special target.
+#       error: use variable 'SUFFIXES', not target '.SUFFIXES'
+# 4.  What about a target rule?  We'd have to explicitly write the first
+#     dependency name in the rule commands because NetBSD make (and
+#     reportedly OpenBSD) refuses to honor the $< variable in target
+#     rules.
+#
+# So what is left?  A double-suffix rule--but you have to use it in a
+# special way that is explicitly not countenanced by POSIX.
+#
+#   "The application shall ensure that the target portion is a valid
+#   target name (see Target Rules) of the form .s2 or .s1.s2 (where .s1
+#   and .s2 are suffixes that have been given as prerequisites of the
+#   .SUFFIXES special target and s1 and s2 do not contain any <slash> or
+#   <period> characters.) If there is only one <period> in the target,
+#   it is a single-suffix inference rule. Targets with two periods are
+#   double-suffix inference rules. Inference rules can have only one
+#   target before the <colon>."
+#     (POSIX Issue 8, make(1), "Inference Rules")
+#
+# A double-suffix rule won't work in an obvious way because its
+# semantics are that the suffix is replaced, not removed.  You have to
+# add both suffixes to the .SUFFIXES special target, in order with the
+# dependency first.
+#   .SUFFIXES: .me.in .me
+#   .me.in.me:
+#	$(DOC_SED) $< >$@
+# Thanks to Automake, we must say
+#   SUFFIXES += .me.in .me
+# for reason 3 above.  The GNU Automake manual does not explicitly state
+# that it preserves the ordering of the suffixes, but for now it does.
+#
+# It appears to be dumb luck that this works; the rigamarole by itself
+# justifies to me the worth of GNU Make's pattern rules (which require
+# neither '.SUFFIXES' nor 'SUFFIXES') and establishing semantics for $<
+# in target rules.  But I won't hold my breath waiting on other make(1)
+# implementors to agree.  -- GBR
+.PRECIOUS: $(GENERATEDDOCFILES)
+.me.in.me:
+	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+	&& $(DOC_SED) $< >$@
+
 .me.ps:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -k -Tps -ge -me >$@
+	&& $(DOC_GROFF) -Tps -me $< >$@
 
-.ms.html:
+# Use '-K utf8', not '-k', in case 'configure' didn't find uchardet.
+# The French translation uses tbl; its English counterpart does not.
+doc/meintro_fr.ps: doc/meintro_fr.me preconv
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -P-p -P-b -P-I`basename $< | sed -e 's|.ms$$||'` \
-	                -P-D$(imagedir) -Thtml -ms >$@
-.ms.txt:
+	&& $(DOC_GROFF) -K utf8 -t -Tps -me -mfr $< >$@
+
+doc/ms.ps: $(doc_srcdir)/ms.ms eqn tbl
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -Tascii -ms -mwww >$@
-.ms.ps:
+	&& $(DOC_GROFF) -et -Tps -ms $(doc_srcdir)/ms.ms >$@
+
+doc/pic.ps: $(doc_srcdir)/pic.ms eqn pic tbl
+	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+	&& $(DOC_GROFF) -pet -Tps -ms $(doc_srcdir)/pic.ms >$@
+
+doc/webpage.ps: $(DOC_GNU_EPS) tmac/www.tmac tbl
+doc/webpage.ps: $(doc_srcdir)/webpage.ms
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -Tps -ms -mwww >$@
+	&& $(DOC_GROFF) -I $(doc_srcdir) -I $(doc_builddir) -t -Tps \
+	  -ms -mwww $(doc_srcdir)/webpage.ms >$@
 
-$(PROCESSEDEXAMPLEFILES): $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS) gnu.eps
-$(PROCESSEDEXAMPLEFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) $(hdtbltmac_DATA)
-$(PROCESSEDEXAMPLEFILES): $(dist_tmac_DATA) $(nodist_tmac_DATA)
-$(PROCESSEDDOCFILES): $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS) gnu.eps
+# We have no "generic" ms documents.
+#.ms.ps:
+#	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+#	&& $(DOC_GROFF) -Tps -ms $< >$@
 
+doc/pic.html: eqn pic tbl
 doc/pic.html: tmac/www.tmac
-doc/pic.html: $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS)
-doc/pic.html: doc/examples.stamp
-doc/pic.html: $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA)
-doc/pic.html: $(doc_srcdir)/pic.ms $(devhtmlfont_DATA)
+doc/pic.html: $(doc_srcdir)/pic.ms
 	$(GROFF_V)$(MKDIR_P) $(doc_builddir) \
 	&& cd $(doc_builddir) \
-	&& $(DOC_SED) $(doc_srcdir)/pic.ms \
-	   | $(DOC_GROFF_ONLY) -P-p -P-Ipic -P-D$(imagedir) -P-jpic \
-	                       -Thtml -ms > pic.html
-
-doc/examples.stamp: doc/groff.css
-	@$(MKDIR_P) $(doc_builddir)
-	test -f $(doc_builddir)/groff.css || cp $(doc_srcdir)/groff.css $(doc_builddir)
-	echo timestamp > $@
-
-doc/webpage.html: $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS)
-doc/webpage.html: doc/examples.stamp $(devhtmlfont_DATA)
-doc/webpage.html: $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) 
-doc/webpage.html: $(doc_srcdir)/webpage.ms gnu.eps $(doc_srcdir)/groff.css
-	$(GROFF_V)$(MKDIR_P) doc \
-	&& cd $(doc_builddir) \
-	&& $(DOC_SED) $(doc_srcdir)/webpage.ms \
-	   | $(DOC_GROFF_ONLY) -P-jwebpage -P-nrpb -P-Iwebpage \
-	                       -P-D$(imagedir) -Thtml -ms > webpage.html
+	&& $(DOC_GROFF) -pet -P-Ipic -P-Dimg -P-jpic -Thtml -ms \
+	  $(doc_srcdir)/pic.ms > pic.html
 
-doc/grnexmpl.ps: doc/grnexmpl.me doc/grnexmpl.g
+doc/webpage.html: tbl
+doc/webpage.html: tmac/www.tmac
+doc/webpage.html: $(DOC_GNU_EPS)
+doc/webpage.html: $(doc_srcdir)/groff.css
+doc/webpage.html: $(doc_srcdir)/webpage.ms
+	$(GROFF_V)$(MKDIR_P) $(doc_builddir) \
+	&& cd $(doc_builddir) \
+	&& $(DOC_GROFF) -t -I $(doc_srcdir) -P-jwebpage -P-nrb \
+	  -P-Iwebpage -P-Dimg -Thtml -ms $(doc_srcdir)/webpage.ms \
+	  > webpage.html
 
-# Note that we remove groff.css only if out-of-source build tree
+# We remove groff.css only from an out-of-source build tree.
 mostlyclean-local: mostlyclean_doc
 mostlyclean_doc:
-@BUILD_HTML_TRUE@	if test -d $(doc_builddir); then \
-@BUILD_HTML_TRUE@	  cd $(doc_builddir) && \
-@BUILD_HTML_TRUE@	  for f in $(HTMLDOCFILESALL); do \
-@BUILD_HTML_TRUE@	    $(RM) $$f; \
-@BUILD_HTML_TRUE@	  done; \
-@BUILD_HTML_TRUE@	fi
-@BUILD_HTML_TRUE@	if test -d $(doc_builddir)/$(imagedir); then \
-@BUILD_HTML_TRUE@	  cd $(doc_builddir)/$(imagedir) && \
-@BUILD_HTML_TRUE@	  for f in $(HTMLDOCIMAGEFILES); do \
-@BUILD_HTML_TRUE@	    $(RM) $$f; \
-@BUILD_HTML_TRUE@	  done; \
-@BUILD_HTML_TRUE@	fi
+@USE_GROHTML_TRUE@	if test -d $(doc_builddir); then \
+@USE_GROHTML_TRUE@	  cd $(doc_builddir) \
+@USE_GROHTML_TRUE@	  && for f in $(HTMLDOCFILESALL); do \
+@USE_GROHTML_TRUE@	    $(RM) $$f; \
+@USE_GROHTML_TRUE@	  done; \
+@USE_GROHTML_TRUE@	fi
+@USE_GROHTML_TRUE@	if test -d $(doc_builddir)/img; then \
+@USE_GROHTML_TRUE@	  cd $(doc_builddir)/img \
+@USE_GROHTML_TRUE@	  && for f in $(HTMLDOCIMAGEFILES); do \
+@USE_GROHTML_TRUE@	    $(RM) $$f; \
+@USE_GROHTML_TRUE@	  done; \
+@USE_GROHTML_TRUE@	  rmdir  $(doc_builddir)/img || :; \
+@USE_GROHTML_TRUE@	fi
 	if test $(top_builddir) != $(top_srcdir); then \
 	  $(RM) $(top_builddir)/doc/groff.css; \
 	fi
-
-@BUILD_HTMLEXAMPLES_TRUE@	if test -d $(doc_builddir); then \
-@BUILD_HTMLEXAMPLES_TRUE@	  cd $(doc_builddir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	  for f in $(HTMLEXAMPLEFILESALL); do \
-@BUILD_HTMLEXAMPLES_TRUE@	    $(RM) $$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	  done; \
-@BUILD_HTMLEXAMPLES_TRUE@	fi
-@BUILD_HTMLEXAMPLES_TRUE@	if test -d $(doc_builddir)/$(imagedir); then \
-@BUILD_HTMLEXAMPLES_TRUE@	  cd $(doc_builddir)/$(imagedir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	  for f in $(HTMLEXAMPLEIMAGEFILES); do \
-@BUILD_HTMLEXAMPLES_TRUE@	    $(RM) $$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	  done; \
-@BUILD_HTMLEXAMPLES_TRUE@	fi
+@USE_GROHTML_TRUE@	if test -d $(doc_builddir); then \
+@USE_GROHTML_TRUE@	  cd $(doc_builddir) \
+@USE_GROHTML_TRUE@	  && for f in $(HTMLEXAMPLEFILESALL); do \
+@USE_GROHTML_TRUE@	    $(RM) $$f; \
+@USE_GROHTML_TRUE@	  done; \
+@USE_GROHTML_TRUE@	fi
+@USE_GROHTML_TRUE@	if test -d $(doc_builddir)/img; then \
+@USE_GROHTML_TRUE@	  cd $(doc_builddir)/img \
+@USE_GROHTML_TRUE@	  && for f in $(HTMLEXAMPLEIMAGEFILES); do \
+@USE_GROHTML_TRUE@	    $(RM) $$f; \
+@USE_GROHTML_TRUE@	  done; \
+@USE_GROHTML_TRUE@	  rmdir  $(doc_builddir)/img || :; \
+@USE_GROHTML_TRUE@	fi
 
 install-data-hook: install_doc_htmldoc
 install_doc_htmldoc:
-@BUILD_HTML_TRUE@	cd $(doc_builddir) && \
-@BUILD_HTML_TRUE@	for f in `ls $(HTMLDOCFILESALL)`; do \
-@BUILD_HTML_TRUE@	  $(RM) $(DESTDIR)$(htmldocdir)/$$f; \
-@BUILD_HTML_TRUE@	  $(INSTALL_DATA) $$f $(DESTDIR)$(htmldocdir)/$$f; \
-@BUILD_HTML_TRUE@	done
-@BUILD_HTML_TRUE@	-test -d $(DESTDIR)$(htmldocimagedir) \
-@BUILD_HTML_TRUE@	  || $(mkinstalldirs) $(DESTDIR)$(htmldocimagedir)
-@BUILD_HTML_TRUE@	$(RM) $(DESTDIR)$(htmldocimagedir)/$(HTMLDOCIMAGEFILES)
-@BUILD_HTML_TRUE@	$(INSTALL_DATA) $(doc_builddir)/$(imagedir)/$(HTMLDOCIMAGEFILES) \
-@BUILD_HTML_TRUE@	  $(DESTDIR)$(htmldocimagedir)
-
-install-data-hook: install_doc_examples
-install_doc_examples: gnu.eps
-# Prefer gnu.eps in builddir over srcdir.
-@BUILD_EXAMPLES_TRUE@	d=.; test -f "gnu.eps" || d=$(doc_srcdir); \
-@BUILD_EXAMPLES_TRUE@	  $(RM) $(DESTDIR)$(exampledir)/gnu.eps; \
-@BUILD_EXAMPLES_TRUE@	  $(INSTALL_DATA) $$d/gnu.eps $(DESTDIR)$(exampledir)/gnu.eps
-@BUILD_HTMLEXAMPLES_TRUE@	cd $(doc_builddir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	for f in `ls $(HTMLEXAMPLEFILESALL)`; do \
-@BUILD_HTMLEXAMPLES_TRUE@	  $(RM) $(DESTDIR)$(exampledir)/$$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	  $(INSTALL_DATA) $$f $(DESTDIR)$(exampledir)/$$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	done
-@BUILD_HTMLEXAMPLES_TRUE@	-test -d $(DESTDIR)$(exampleimagedir) \
-@BUILD_HTMLEXAMPLES_TRUE@	  || $(mkinstalldirs) $(DESTDIR)$(exampleimagedir)
-@BUILD_HTMLEXAMPLES_TRUE@	$(RM) $(DESTDIR)$(exampleimagedir)/$(HTMLEXAMPLEIMAGEFILES)
-@BUILD_HTMLEXAMPLES_TRUE@	$(INSTALL_DATA) $(doc_builddir)/$(imagedir)/$(HTMLEXAMPLEIMAGEFILES) \
-@BUILD_HTMLEXAMPLES_TRUE@	  $(DESTDIR)$(exampleimagedir)
+@USE_GROHTML_TRUE@	cd $(doc_builddir) \
+@USE_GROHTML_TRUE@	&& for f in `ls $(HTMLDOCFILESALL)`; do \
+@USE_GROHTML_TRUE@	  $(RM) $(DESTDIR)$(htmldocdir)/$$f; \
+@USE_GROHTML_TRUE@	  $(INSTALL_DATA) $$f $(DESTDIR)$(htmldocdir)/$$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) \
+@USE_GROHTML_TRUE@	  || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/$(imagedir)
+@USE_GROHTML_TRUE@	$(RM) $(DESTDIR)$(htmldocdir)/$(imagedir)/$(HTMLDOCIMAGEFILES)
+@USE_GROHTML_TRUE@	$(INSTALL_DATA) $(doc_builddir)/img/$(HTMLDOCIMAGEFILES) \
+@USE_GROHTML_TRUE@	  $(DESTDIR)$(htmldocdir)/$(imagedir)
+
+install-data-hook: install_doc_gnu_eps install_doc_examples
+
+install_doc_gnu_eps: $(DOC_GNU_EPS)
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if test -f "$$d/gnu.eps"; then \
+	    $(RM) $(DESTDIR)$(exampledir)/gnu.eps; \
+	    $(INSTALL_DATA) \
+	      $$d/gnu.eps $(DESTDIR)$(exampledir)/gnu.eps; \
+	    break; \
+	  fi; \
+	done
+
+install_doc_examples: $(DOC_GNU_EPS)
+@USE_GROHTML_TRUE@	cd $(doc_builddir) \
+@USE_GROHTML_TRUE@	&& for f in `ls $(HTMLEXAMPLEFILESALL)`; do \
+@USE_GROHTML_TRUE@	  $(RM) $(DESTDIR)$(exampledir)/$$f; \
+@USE_GROHTML_TRUE@	  $(INSTALL_DATA) $$f $(DESTDIR)$(exampledir)/$$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(exampledir)/$(imagedir) \
+@USE_GROHTML_TRUE@	  || $(mkinstalldirs) $(DESTDIR)$(exampledir)/$(imagedir)
+@USE_GROHTML_TRUE@	$(RM) \
+@USE_GROHTML_TRUE@	  $(DESTDIR)$(exampledir)/$(imagedir)/$(HTMLEXAMPLEIMAGEFILES)
+@USE_GROHTML_TRUE@	$(INSTALL_DATA) $(doc_builddir)/img/$(HTMLEXAMPLEIMAGEFILES) \
+@USE_GROHTML_TRUE@	  $(DESTDIR)$(exampledir)/$(imagedir)
 
-uninstall-hook: uninstall_doc_examples uninstall_doc_htmldoc uninstall_mom
+uninstall-hook: \
+  uninstall_doc_examples uninstall_doc_htmldoc
 uninstall_doc_examples:
-@BUILD_EXAMPLES_TRUE@	$(RM) -f $(DESTDIR)$(exampledir)/gnu.eps
-@BUILD_HTMLEXAMPLES_TRUE@	-test -d $(DESTDIR)$(docexamplesdir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	cd $(DESTDIR)$(docexamplesdir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	for f in $(HTMLEXAMPLEFILESALL); do \
-@BUILD_HTMLEXAMPLES_TRUE@	  $(RM) $$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	done
-@BUILD_HTMLEXAMPLES_TRUE@	-test -d $(DESTDIR)$(docexamplesdir)/$(imagedir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	cd $(DESTDIR)$(docexamplesdir)/$(imagedir) && \
-@BUILD_HTMLEXAMPLES_TRUE@	for f in $(HTMLEXAMPLEIMAGEFILES); do \
-@BUILD_HTMLEXAMPLES_TRUE@	  $(RM) $$f; \
-@BUILD_HTMLEXAMPLES_TRUE@	done
-@BUILD_HTMLEXAMPLES_TRUE@	-rmdir $(DESTDIR)$(docexamplesdir)/$(imagedir)
-@BUILD_HTMLEXAMPLES_TRUE@	-rmdir $(DESTDIR)$(docexamplesdir)
+	$(RM) $(DESTDIR)$(exampledir)/gnu.eps
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(docexamplesdir) \
+@USE_GROHTML_TRUE@	&& cd $(DESTDIR)$(docexamplesdir) \
+@USE_GROHTML_TRUE@	&& for f in $(HTMLEXAMPLEFILESALL); do \
+@USE_GROHTML_TRUE@	  $(RM) $$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(docexamplesdir)/$(imagedir) \
+@USE_GROHTML_TRUE@	&& cd $(DESTDIR)$(docexamplesdir)/$(imagedir) \
+@USE_GROHTML_TRUE@	&& for f in $(HTMLEXAMPLEIMAGEFILES); do \
+@USE_GROHTML_TRUE@	  $(RM) $$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-rmdir $(DESTDIR)$(docexamplesdir)/$(imagedir)
+@USE_GROHTML_TRUE@	-rmdir $(DESTDIR)$(docexamplesdir)
 
 uninstall_doc_htmldoc:
-@BUILD_HTML_TRUE@	-test -d $(DESTDIR)$(htmldocdir) && \
-@BUILD_HTML_TRUE@	cd $(DESTDIR)$(htmldocdir) && \
-@BUILD_HTML_TRUE@	for f in $(HTMLDOCFILESALL); do \
-@BUILD_HTML_TRUE@	  $(RM) $$f; \
-@BUILD_HTML_TRUE@	done
-@BUILD_HTML_TRUE@	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) && \
-@BUILD_HTML_TRUE@	cd $(DESTDIR)$(htmldocdir)/$(imagedir) && \
-@BUILD_HTML_TRUE@	for f in $(HTMLDOCIMAGEFILES); do \
-@BUILD_HTML_TRUE@	  $(RM) $$f; \
-@BUILD_HTML_TRUE@	done
-@BUILD_HTML_TRUE@	-rmdir $(DESTDIR)$(htmldocdir)/$(imagedir)
-@BUILD_HTML_TRUE@	-rmdir $(DESTDIR)$(htmldocdir)
-
-# Texinfo doc
-#
-# Users who want to print out the groff manual are expected to have a
-# working TeX installation.  Note that texi2dvi properly honours the
-# `MAKEINFO' environment variable.
-#
-# We can't use automake's facilities because the make dist target attempts to 
-# generate a pdf version of groff.texi by invoking texi2dvi without the -e 
-# option, which is needed to build this file.
-# info_TEXINFOS = doc/groff.texi
-# doc_groff_TEXINFOS = doc/fdl.texi
-#
-# Note that GNU standards require to install only info doc. Info doc
-# can still be disabled by passing 
-# --with-doc=<something else than info or yes> 
-# to configure
-
-all: build_infodoc
-@BUILD_INFODOC_TRUE@build_infodoc: doc/groff.info
-@BUILD_INFODOC_TRUE@doc/groff.info: $(doc_srcdir)/groff.texi
-@BUILD_INFODOC_TRUE@	@$(MKDIR_P) $(doc_builddir)
-@BUILD_INFODOC_TRUE@	LANG=C \
-@BUILD_INFODOC_TRUE@	LC_ALL=C \
-@BUILD_INFODOC_TRUE@	$(MAKEINFO) -o doc/groff.info --enable-encoding -I$(doc_srcdir) $(doc_srcdir)/groff.texi
-@BUILD_INFODOC_FALSE@build_infodoc:
-# Rules to generate various doc files from .texi files.
-.texi.txt:
-	@$(MKDIR_P) $(doc_builddir)
-	LANG=C \
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(htmldocdir) \
+@USE_GROHTML_TRUE@	&& cd $(DESTDIR)$(htmldocdir) \
+@USE_GROHTML_TRUE@	&& for f in $(HTMLDOCFILESALL); do \
+@USE_GROHTML_TRUE@	  $(RM) $$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) \
+@USE_GROHTML_TRUE@	&& cd $(DESTDIR)$(htmldocdir)/$(imagedir) \
+@USE_GROHTML_TRUE@	&& for f in $(HTMLDOCIMAGEFILES); do \
+@USE_GROHTML_TRUE@	  $(RM) $$f; \
+@USE_GROHTML_TRUE@	done
+@USE_GROHTML_TRUE@	-rmdir $(DESTDIR)$(htmldocdir)/$(imagedir)
+@USE_GROHTML_TRUE@	-rmdir $(DESTDIR)$(htmldocdir)
+
+all: doc/groff.info doc/groff.txt doc/groff.html $(GROFF_DVI) \
+  $(GROFF_PDF)
+doc/groff.info: $(doc_srcdir)/groff.texi
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
 	LC_ALL=C \
-	$(MAKEINFO) --enable-encoding -I$(doc_srcdir) --plaintext -o $@ $<
-
-.texi.dvi:
-@HAVE_TEXI2DVI_TRUE@	@$(MKDIR_P) $(doc_builddir)
-@HAVE_TEXI2DVI_TRUE@	LANG=C \
-@HAVE_TEXI2DVI_TRUE@	LC_ALL=C \
-@HAVE_TEXI2DVI_TRUE@	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
-@HAVE_TEXI2DVI_TRUE@	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
-@HAVE_TEXI2DVI_TRUE@	$(TEXI2DVI) -e --batch --build-dir=doc/`basename $@`.t2d -o $@ $<
-@HAVE_TEXI2DVI_FALSE@	@echo "Program texi2dvi is missing, cannot generate dvi doc"; \
-@HAVE_TEXI2DVI_FALSE@	exit 1
-
-.texi.pdf:
-@HAVE_TEXI2DVI_TRUE@	@$(MKDIR_P) $(doc_builddir)
-@HAVE_TEXI2DVI_TRUE@	LANG=C \
-@HAVE_TEXI2DVI_TRUE@	LC_ALL=C \
-@HAVE_TEXI2DVI_TRUE@	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
-@HAVE_TEXI2DVI_TRUE@	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
-@HAVE_TEXI2DVI_TRUE@	$(TEXI2DVI) -e --batch --pdf --build-dir=doc/`basename $@`.t2p -o $@ $<
-@HAVE_TEXI2DVI_FALSE@	@echo "Program texi2dvi is missing, cannot generate pdf doc"; \
-@HAVE_TEXI2DVI_FALSE@	exit 1
+	$(MAKEINFO) -o doc/groff.info --enable-encoding \
+	  -I $(doc_srcdir) $(doc_srcdir)/groff.texi
 
-# This will generate both html split into several files and html doc
-# in a single file. If texinfo version < 5.0, we process the resulting
-# (mono) .html file with fixinfo.sh du to a problem with blockquote
-# closing (for example 5.6.1 Setting Registers, the 'Request'
-# blockquote is not properly closed, see fixinfo.sh for more details
+# Distribute the Info files.
+dist-hook: dist-info-bits
+dist-info-bits:
+	chmod u+w $(distdir)/doc
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/groff.info ; then \
+	    cp -f "$$d"/groff.info-* $(distdir)/doc; \
+	    break; \
+	  fi; \
+	done
+.texi.txt:
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
+	LC_ALL=C \
+	$(MAKEINFO) --enable-encoding -I $(doc_srcdir) --plaintext \
+	  -o $@ $<
 .texi.html:
-	@$(MKDIR_P) $(doc_builddir)/
-	LANG=C \
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)/
+	$(AM_V_GEN)LANG=C \
 	LC_ALL=C \
 	$(MAKEINFO) --html -I $(doc_srcdir) \
 	  -o doc/`basename $@`.node $<
-	LANG=C \
+	$(AM_V_at)LANG=C \
 	LC_ALL=C \
 	$(MAKEINFO) --html -I $(doc_srcdir) --no-split \
 	  -o $@ $<
-	if test "$(makeinfo_version_numeric)" -lt 5000; then \
-	  echo "patching $@ with fixinfo.sh"; \
-	  $(SHELL) $(doc_srcdir)/fixinfo.sh \
-	    doc/`basename $@`.mono/`basename $@`; \
-	fi
 
-# Targets to make all the doc in all formats. These doc are not built
-# by default. pdf, dvi, ps, html and their install equivalent
-# install-pdf, install-dvi, install-ps, install-html are standard
-# Automake targets.
+# Define pattern rules to make our Texinfo manual in DVI and PDF
+# formats.  'pdf' and 'dvi' and their installation counterparts
+# 'install-pdf' and 'install-dvi' are standard Automake targets.
+.texi.dvi:
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(AM_V_GEN)LANG=C \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	LC_ALL=C \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	FORCE_SOURCE_DATE=1 \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(PROG_TEXI2DVI) -e --batch --build-dir=doc/`basename $@`.t2d \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	  -o $@ $<
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_FALSE@	@echo "program 'tex' is missing; cannot generate $@" >&2; \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_FALSE@	exit 1
+@HAVE_TEXI2DVI_FALSE@	@echo "program 'texi2dvi' is missing or too old;" \
+@HAVE_TEXI2DVI_FALSE@	  "cannot generate $@" >&2; \
+@HAVE_TEXI2DVI_FALSE@	exit 1
+
+.texi.pdf:
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(AM_V_GEN)LANG=C \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	LC_ALL=C \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	$(PROG_TEXI2DVI) -e --batch --pdf \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_TRUE@	  --build-dir=doc/`basename $@`.t2p -o $@ $<
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_FALSE@	@echo "program 'tex' is missing; cannot generate $@" >&2; \
+@HAVE_TEXI2DVI_TRUE@@USE_TEX_FALSE@	exit 1
+@HAVE_TEXI2DVI_FALSE@	@echo "program 'texi2dvi' is missing or too old;" \
+@HAVE_TEXI2DVI_FALSE@	  "cannot generate $@" >&2; \
+@HAVE_TEXI2DVI_FALSE@	exit 1
+
+install-doc: install-dvi install-html install-pdf
 
-@BUILD_INFODOC_TRUE@doc: doc_all
-@BUILD_INFODOC_TRUE@doc_all: doc_txt dvi pdf html
-@BUILD_INFODOC_TRUE@doc_txt: doc/groff.txt
-@BUILD_INFODOC_TRUE@dvi: doc_dvi
-@BUILD_INFODOC_TRUE@doc_dvi: doc/groff.dvi
-@BUILD_INFODOC_TRUE@pdf: doc_pdf
-@BUILD_INFODOC_TRUE@doc_pdf: doc/groff.pdf
-@BUILD_INFODOC_TRUE@html: doc_html
-@BUILD_INFODOC_TRUE@doc_html: doc/groff.html
-@BUILD_INFODOC_TRUE@install-doc: install-pdf install-html
-
-distclean-local: clean_infodoc clean_otherdoc
-maintainer-clean-local: clean_infodoc clean_otherdoc
-clean_infodoc:
-	-$(RM) $(doc_builddir)/groff.info*
-	-$(RM) $(doc_builddir)/groff.pdf
-	-$(RM) $(doc_builddir)/groff.dvi
-	-$(RM) -r $(doc_builddir)/groff.html.*
-clean_otherdoc:
-	-cd $(doc_builddir) && \
-	  $(RM) -r *.pdf *.html *.txt *.dvi *.t2p *.t2d
+maintainer-clean-local:
+	$(RM) $(doc_builddir)/groff.info*
+	$(RM) $(doc_builddir)/groff.pdf
+	$(RM) $(doc_builddir)/groff.dvi
+	$(RM) $(doc_builddir)/groff.txt
+	$(RM) -r $(doc_builddir)/groff.html.*
+
+install-data-local: install-txt
+install-txt:
+	-test -d $(DESTDIR)$(docdir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(docdir)
+	cp $(top_srcdir)/doc/groff.txt $(DESTDIR)$(docdir)
 
 install-data-local: install_infodoc
-@BUILD_INFODOC_TRUE@install_infodoc: doc/groff.info
-@BUILD_INFODOC_TRUE@	-test -d $(DESTDIR)$(infodir) || $(mkinstalldirs) $(DESTDIR)$(infodir)
-@BUILD_INFODOC_TRUE@	  for p in doc/groff.info `ls doc/groff.info*`; do \
-@BUILD_INFODOC_TRUE@	    f=`basename $$p`; \
-@BUILD_INFODOC_TRUE@	    $(RM) $(DESTDIR)$(infodir)/$$f; \
-@BUILD_INFODOC_TRUE@	    $(INSTALL_DATA) $$p $(DESTDIR)$(infodir)/$$f; \
-@BUILD_INFODOC_TRUE@	  done
-@BUILD_INFODOC_TRUE@	$(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) \
-@BUILD_INFODOC_TRUE@	  $(DESTDIR)$(infodir)/groff.info
-@BUILD_INFODOC_TRUE@install-pdf-local: doc/groff.pdf
-@BUILD_INFODOC_TRUE@	-test -d $(DESTDIR)$(pdfdocdir) || $(mkinstalldirs) $(DESTDIR)$(pdfdocdir)
-@BUILD_INFODOC_TRUE@	cp $(top_builddir)/doc/groff.pdf $(DESTDIR)$(pdfdocdir)
-@BUILD_INFODOC_TRUE@install-html-local: doc/groff.html
-@BUILD_INFODOC_TRUE@	-test -d $(DESTDIR)$(htmldocdir)/groff.html.mono || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/groff.html.mono
-@BUILD_INFODOC_TRUE@	cp -r $(top_builddir)/doc/groff.html $(DESTDIR)$(htmldocdir)/groff.html.mono
-@BUILD_INFODOC_TRUE@	cp -r $(top_builddir)/doc/groff.html.node $(DESTDIR)$(htmldocdir)
-@BUILD_INFODOC_FALSE@install_infodoc:
+install_infodoc: doc/groff.info
+	-test -d $(DESTDIR)$(infodir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(infodir)
+	$(RM) $(DESTDIR)/doc/groff.info*
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/groff.info ; then \
+	    cp "$$d"/groff.info* $(DESTDIR)$(infodir); \
+	    $(INSTALL_INFO) --info-file="$$d"/groff.info \
+	      --info-dir=$(DESTDIR)$(infodir); \
+	    break; \
+	  fi; \
+	done
+install-pdf-local: doc/groff.pdf
+	-test -d $(DESTDIR)$(pdfdocdir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(pdfdocdir)
+	cp $(top_srcdir)/doc/groff.pdf $(DESTDIR)$(pdfdocdir)
+install-html-local: doc/groff.html
+	-test -d $(DESTDIR)$(htmldocdir)/groff.html.mono \
+	  || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/groff.html.mono
+	cp -r $(top_srcdir)/doc/groff.html \
+	  $(DESTDIR)$(htmldocdir)/groff.html.mono
+	cp -r $(top_srcdir)/doc/groff.html.node \
+	  $(DESTDIR)$(htmldocdir)
 
-uninstall-local: uninstall_infodoc uninstall-pdf uninstall-html
+uninstall-local: uninstall_infodoc uninstall-pdf uninstall-html \
+  uninstall-txt
 uninstall_doc: uninstall-local
 uninstall-doc: uninstall-local
 uninstall_infodoc:
-@BUILD_INFODOC_TRUE@	-$(INSTALL_INFO) --remove --info-dir=$(DESTDIR)$(infodir) \
-@BUILD_INFODOC_TRUE@	  $(DESTDIR)$(infodir)/groff.info
-@BUILD_INFODOC_TRUE@	-for f in `ls $(DESTDIR)$(infodir)/groff.info*`; do \
-@BUILD_INFODOC_TRUE@	  $(RM) $$f; \
-@BUILD_INFODOC_TRUE@	done
+	-$(INSTALL_INFO) --remove --info-dir=$(DESTDIR)$(infodir) \
+	  $(DESTDIR)$(infodir)/groff.info
+	-for f in `ls $(DESTDIR)$(infodir)/groff.info*`; do \
+	  $(RM) $$f; \
+	done
 uninstall-pdf:
-@BUILD_INFODOC_TRUE@	-$(RM) -f $(DESTDIR)$(pdfdocdir)/groff.pdf 
+	$(RM) $(DESTDIR)$(pdfdocdir)/groff.pdf
+	-rmdir $(DESTDIR)$(pdfdocdir)
 uninstall-html:
-@BUILD_INFODOC_TRUE@	-$(RM) -r $(DESTDIR)$(htmldocdir)/groff.html.*
-gnu.eps:
-	echo $(XPMTOPPM)
-	if test -f $(top_srcdir)/doc/gnu.eps; then \
-	  cp $(top_srcdir)/doc/gnu.eps . ; \
-	elif test -f $(top_builddir)/doc/gnu.eps; then \
-	  cp $(top_builddir)/doc/gnu.eps . ; \
-	else \
-	  if test ""$(XPMTOPPM) != "found"; then \
-	    echo "Program xpmtoppm is missing, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  if test ""$(pnmtops) != "found"; then \
-	    echo "Program pnmtops is missing, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  if test "$(pnmtops_nosetpage)" != "pnmtops -nosetpage"; then \
-	    echo "Program pnmtops can't handle -nosetpage, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmdepth 15 \
-	    | $(pnmtops_nosetpage) -noturn -rle >$@ ; \
-	fi
+	$(RM) $(DESTDIR)$(htmldocdir)/groff.html.mono/*
+	$(RM) $(DESTDIR)$(htmldocdir)/groff.html.node/*
+uninstall-txt:
+	$(RM) $(DESTDIR)$(docdir)/groff.txt
+$(DOC_GNU_EPS): doc/gnu.xpm
+	$(AM_V_GEN)if test "$(XPMTOPPM)" != found; then \
+	  echo "program 'xpmtoppm' is missing; can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	if test "$(pnmtops)" != found; then \
+	  echo "program 'pnmtops' is missing; can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	if ! echo "$(pnmtops_nosetpage)" | grep -q nosetpage; then \
+	  echo "program 'pnmtops' can't handle -nosetpage option;" \
+	    "can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmdepth 15 \
+	  | $(pnmtops_nosetpage) -noturn -rle >$@
 
-# Copy gnu.eps in 'doc' directory
+# Provide a copy of the image in the distribution archive to accommodate
+# systems without a tool to generate it from an X pixmap.
 dist-hook: dist-gnueps
 dist-gnueps:
 	chmod u+w $(distdir)/doc
-	cp -f gnu.eps $(distdir)/doc
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/$(DOC_GNU_EPS) ; then \
+	    cp -f "$$d"/$(DOC_GNU_EPS) $(distdir)/doc; \
+	    break; \
+	  fi; \
+	done
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
+
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
+#
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX100_font-descriptions
+devX100_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX100_fontsrcdir) \
+	  && sed -e 's/res .*/res 100/' $(xditview_srcdir)/DESC.in \
+	    >$(devX100_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX100_fontsrcdir) -r 100 -s 10 \
+	    $(xditview_srcdir)/FontMap-X11
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
+#
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX100-12_font-descriptions
+devX100-12_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX100_12_fontsrcdir) \
+	  && sed -e 's/res .*/res 100/;s/unitwidth .*/unitwidth 12/' \
+	    $(xditview_srcdir)/DESC.in >$(devX100_12_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX100_12_fontsrcdir) -r 100 -s 12 \
+	    $(xditview_srcdir)/FontMap-X11
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
+#
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX75_font-descriptions
+devX75_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX75_fontsrcdir) \
+	  && sed -e 's/res .*/res 75/' $(xditview_srcdir)/DESC.in \
+	    >$(devX75_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX75_fontsrcdir) -r 75 -s 10 \
+	    $(xditview_srcdir)/FontMap-X11
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
+#
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX75-12_font-descriptions
+devX75-12_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX75_12_fontsrcdir) \
+	  && sed -e 's/res .*/res 75/;s/unitwidth .*/unitwidth 12/' \
+	    $(xditview_srcdir)/DESC.in >$(devX75_12_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX75_12_fontsrcdir) -r 75 -s 12 \
+	    $(xditview_srcdir)/FontMap-X11
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 $(DEVASCIIFONTSFILES): $(devascii_srcdir)/R.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12086,15 +14749,11 @@
 	     $(DEVASCIIRES) $(DEVASCIICPI) $(DEVASCIILPI) \
 	     $(DEVASCIIFONTS) > $@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 $(DEVCP1047FONTSFILES): $(devcp1047_srcdir)/R.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12108,15 +14767,11 @@
 	     $(DEVCP1047RES) $(DEVCP1047CPI) $(DEVCP1047LPI) \
 	     $(DEVCP1047FONTS) > $@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 font/devdvi/DESC: $(devdvi_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12129,37 +14784,33 @@
 	&& (test -z '$(DVIPRINT)' \
 	    || echo print '$(DVIPRINT)' >>$@)
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 $(DEVHTMLFONTSFILES): $(devhtml_srcdir)/R.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(RM) $@ \
 	&& $(SHELL) $(GENFONTSSH) $(devhtml_srcdir)/R.proto \
-	     $(DEVHTMLRES) $(DEVHTMLCPI) `basename $@` > $@
+	  $(DEVHTMLRES) $(DEVHTMLCPI) `basename $@` >$@
 
 font/devhtml/DESC: $(devhtml_srcdir)/DESC.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(SHELL) $(GENDESCSH) $(devhtml_srcdir)/DESC.proto \
-	     $(DEVHTMLRES) $(DEVHTMLCPI) $(DEVHTMLLPI) $(DEVHTMLFONTS) > $@ \
-	&& echo "image_generator $(GHOSTSCRIPT)" >> $@
+	  $(DEVHTMLRES) $(DEVHTMLCPI) $(DEVHTMLLPI) $(DEVHTMLFONTS) \
+	  > $@.tmp \
+	&& echo "image_generator $(GHOSTSCRIPT)" >>$@.tmp \
+	&& mv $@.tmp $@
+font/devhtml/stamp: font/devhtml/DESC $(DEVHTMLFONTSFILES)
+	$(AM_V_at)>$@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 $(DEVLATIN1FONTSFILES): $(devlatin1_srcdir)/R.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12173,15 +14824,11 @@
 	     $(DEVLATIN1RES) $(DEVLATIN1CPI) $(DEVLATIN1LPI) \
 	     $(DEVLATIN1FONTS) > $@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 font/devlbp/DESC: $(devlbp_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12194,15 +14841,11 @@
 	&& (test -z '$(LBPPRINT)' \
 	    || echo print '$(LBPPRINT)' >>$@)
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 font/devlj4/DESC: $(devlj4_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
@@ -12223,39 +14866,32 @@
 	  srcdir=$(devlj4_srcdir)/generate \
 	  HPFTODIT=$(top_builddir)/hpftodit
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+all: font/devpdf/stamp
 
 font/devpdf/enc/text.enc:
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/enc
-	cp -f $(top_srcdir)/font/devps/text.enc \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/enc
+	$(AM_V_at)cp -f $(top_srcdir)/font/devps/text.enc \
 	  $(top_builddir)/font/devpdf/enc
 
-font/devpdf/map/symbolmap:
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/map
-	@cp -f $(top_srcdir)/font/devps/symbolmap \
-	  $(top_builddir)/font/devpdf/map
-
-$(DEVPDFFONTMAP_1):
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/map
-	@cp -f $(top_srcdir)/font/devps/generate/`basename $@` \
+$(devpdffontmapdata):
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/map
+	$(AM_V_at)cp -f \
+	  $(top_srcdir)/font/devps/generate/`basename $@` \
 	  $(top_builddir)/font/devpdf/map
-
-font/devpdf/util/BuildFoundries: shdeps.sed \
-  $(devpdf_srcdir)/util/BuildFoundries.pl
+font/devpdf/util/BuildFoundries: \
+  $(devpdf_srcdir)/util/BuildFoundries.pl $(SH_DEPS_SED_SCRIPT) afmtodit
 	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf/util \
-	&& $(RM) $(top_builddir)/font/devpdf/util/BuildFoundries \
 	&& if test -n "$(PERL)"; then \
 	     sed -f $(SH_DEPS_SED_SCRIPT) \
 	         -e "s|/usr/bin/perl|$(PERL)|" \
-	         -e "s|@GROFF_GHOSTSCRIPT_INTERPRETERS@|$(GHOSTSCRIPT)|" \
+	         -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|" \
+	         -e "s|@PATH_SEPARATOR@|$(PATH_SEPARATOR)|" \
 	         -e "s|@VERSION@|$(VERSION)|" \
 	         -e "s|@GROFF_FONT_DIR@|$(fontdir)|" \
 	         $(devpdf_srcdir)/util/BuildFoundries.pl \
@@ -12268,43 +14904,42 @@
 	         >$(top_builddir)/font/devpdf/util/BuildFoundries; \
 	   fi \
 	&& chmod +x $(top_builddir)/font/devpdf/util/BuildFoundries
-
 font/devpdf/DESC: $(devpdf_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf \
-	&& $(RM) $(top_builddir)/font/devpdf/DESC \
-	&& cat $(devpdf_srcdir)/DESC.in >$(top_builddir)/font/devpdf/DESC \
+	&& cat $(devpdf_srcdir)/DESC.in \
+	  >$(top_builddir)/font/devpdf/DESC \
 	&& if test "$(PAGE)" = A4; then \
 	     echo "papersize a4" >>$(top_builddir)/font/devpdf/DESC; \
 	   else \
-	     echo "papersize letter" >>$(top_builddir)/font/devpdf/DESC; \
+	     echo "papersize letter" \
+	       >>$(top_builddir)/font/devpdf/DESC; \
 	   fi
 
-font/devpdf/Foundry:
-	$(AM_V_GEN)$(RM) $(top_builddir)/font/devpdf/Foundry \
-	&& sed "s|@urwfontsdir@|$(urwfontsdir)|" \
-	       $(devpdf_srcdir)/Foundry.in >$(top_builddir)/$@
-
-all: font/devpdf/build_font_files
-
-# PATH: path to find afmtodit. We add $(abs_top_builddir) because
-# afmtodit is built in the top builddir.
-font/devpdf/build_font_files: afmtodit font/devpdf/DESC \
-  $(devpdffontenc_DATA) $(devpdffontmap_DATA) $(devpdffont_DATA) \
+font/devpdf/Foundry: $(devpdf_srcdir)/Foundry.in
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/
+@HAVE_URW_FONTS_TRUE@	$(AM_V_GEN)sed "s|@urwfontsdir@|$(urwfontsdir)|" \
+@HAVE_URW_FONTS_TRUE@	  $(devpdf_srcdir)/Foundry.in >$@
+@HAVE_URW_FONTS_FALSE@	$(AM_V_GEN)sed "/BEGIN URW/,/END URW/d" \
+@HAVE_URW_FONTS_FALSE@	  $(devpdf_srcdir)/Foundry.in >$@
+
+# This is kind of a cheat, but works because BuildFoundries produces so
+# many artifacts.
+$(DEFAULT_BASE35_FONTS) $(URW_BASE35_FONTS): font/devpdf/download
+font/devpdf/download: $(devpdffontmapdata) font/devpdf/DESC \
+  font/devpdf/Foundry font/devpdf/enc/text.enc \
   font/devpdf/util/BuildFoundries
-	@if $(AM_V_P); then \
-	  set -x; \
-	else \
-	  echo "  GEN      $(top_builddir)/font/devpdf/download"; \
-	fi \
-	&& $(RM) $@ \
-	&& $(MKDIR_P) $(top_builddir)/font/devpdf \
-	&& echo "# foundry	ps name	psfile" > $(top_builddir)/font/devpdf/download \
+	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf \
+	&& echo "# foundry	ps-font-name	ps-font-file" >$@.tmp \
+	&& echo "# A blank foundry is the default." >>$@.tmp \
 	&& PATH="$(abs_top_builddir)$(GROFF_PATH_SEPARATOR)$(abs_top_builddir)/build-aux$(GROFF_PATH_SEPARATOR)$(PATH)" \
 	     $(abs_top_builddir)/font/devpdf/util/BuildFoundries \
-	       $(abs_top_builddir)/font/devpdf \
-	       '$(abs_top_srcdir)/font/devps : $(abs_top_builddir)/font/devps' \
-	       >> $(top_builddir)/font/devpdf/download \
-	&& touch $@
+	       --strict $(abs_top_builddir)/font/devpdf \
+	       '$(abs_top_srcdir)/font/devps:$(abs_top_builddir)/font/devps' \
+	       >>$@.tmp \
+	&& mv $@.tmp $@
+font/devpdf/stamp: font/devpdf/DESC font/devpdf/download \
+  $(devpdffontenc_DATA) $(devpdffontmap_DATA) $(devpdffont_DATA)
+	$(AM_V_at)>$@
 
 mostlyclean-local: mostlyclean_devpdf_extra
 mostlyclean_devpdf_extra:
@@ -12351,32 +14986,51 @@
 	  rmdir $(DESTDIR)$(devpdffontdir); \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
+font/devpdf/tests/check-default-foundry.sh: $(font_devpdf_default_test)
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+	&& sed -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
+	  $(font_devpdf_default_test) > $@ \
+	&& chmod +x $@
+
+font/devpdf/tests/check-urw-foundry.sh: $(font_devpdf_urw_test)
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+	&& sed -e "s|@urwfontsdir@|$(urwfontsdir)|g" \
+	  $(font_devpdf_urw_test) > $@ \
+	&& chmod +x $@
+
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 font/devps/DESC: $(devps_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
-	&& cat $(devps_srcdir)/DESC.in >$@ \
-	&& echo broken $(BROKEN_SPOOLER_FLAGS) >>$@ \
+	&& cat $(devps_srcdir)/DESC.in >$@.tmp \
+	&& echo broken $(BROKEN_SPOOLER_FLAGS) >>$@.tmp \
 	&& if test "$(PAGE)" = A4; then \
-	     echo "papersize a4" >>$@; \
+	     echo "papersize a4" >>$@.tmp; \
 	   else \
-	     echo "papersize letter" >>$@; \
+	     echo "papersize letter" >>$@.tmp; \
 	   fi \
 	&& (test -z '$(PSPRINT)' \
-	    || echo print '$(PSPRINT)' >>$@)
-
-fonts: devps_fonts
+	    || echo print '$(PSPRINT)' >>$@.tmp)
+	$(AM_V_at)mv $@.tmp $@
+font/devps/stamp: font/devps/DESC \
+  $(DEVPSFONTFILES) $(DEVPSFONTFILES_GENERATED)
+	$(AM_V_at)>$@
+
+maintainer-font-descriptions: devps_font-descriptions
+# This target generates font descriptions from installed Type 1 AFM
+# files; these are _not_ normally generated during a build, but provided
+# with the groff source distribution.
+#
 # We add top_builddir to the PATH in case the only afmtodit available is
 # the one in the current build.
-devps_fonts: afmtodit font/devps/DESC
+#
+# The AFM files from which these descriptions are produced must be
+# obtained elsewhere, so this target runs only in "maintainer mode".
+devps_font-descriptions: afmtodit font/devps/DESC
 	PATH=$(top_builddir)$(GROFF_PATH_SEPARATOR)$(PATH) \
 	  $(MAKE) -f $(devps_srcdir)/generate/Makefile \
 	  srcdir=$(devps_srcdir)/generate DESC=$(devps_srcdir)/DESC.in
@@ -12385,67 +15039,50 @@
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
 	&& $(RM) $@ \
 	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
-font/devps/zapfdr.pfa: $(devps_srcdir)/zapfdr.ps
-	$(AM_V_GEN)$(MKDIR_P) font/devps \
-	&& $(RM) $@ \
-	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
-font/devps/symbolsl.pfa: $(devps_srcdir)/symbolsl.ps
+
+.ps.pfa:
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
 	&& $(RM) $@ \
 	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 $(DEVUTF8FONTSFILES): $(devutf8_srcdir)/R.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(RM) $@ \
 	&& $(SHELL) $(GENFONTSSH) $(devutf8_srcdir)/R.proto \
-	     $(DEVUTF8RES) $(DEVUTF8CPI) `basename $@` > $@
+	  $(DEVUTF8RES) $(DEVUTF8CPI) `basename $@` >$@
 
 font/devutf8/DESC: $(devutf8_srcdir)/DESC.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(SHELL) $(GENDESCSH) $(devutf8_srcdir)/DESC.proto \
-	     $(DEVUTF8RES) $(DEVUTF8CPI) $(DEVUTF8LPI) $(DEVUTF8FONTS) > $@
+	  $(DEVUTF8RES) $(DEVUTF8CPI) $(DEVUTF8LPI) $(DEVUTF8FONTS) >$@
+font/devutf8/stamp: font/devutf8/DESC $(DEVUTF8FONTSFILES)
+	$(AM_V_at)>$@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 man:
 	$(MKDIR_P) $(top_builddir)/man
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 defs.h: config.status
 	@$(SHELL) $(top_srcdir)/gendef.sh defs.h \
 	"PROG_PREFIX=\"$(g)\"" \
@@ -12465,67 +15102,60 @@
 	chmod u+w $(distdir)/src/include
 	cp -f $(top_srcdir)/src/include/*.h $(distdir)/src/include
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 src/libs/libbib/index.$(OBJEXT): defs.h
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-# .o files have a 'libgroff_a-' prefix because we set libgroff_a_CPPFLAGS
+# .o files have a 'libgroff_a-' prefix because we set
+# libgroff_a_CPPFLAGS.
 src/libs/libgroff/libgroff_a-device.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-fontfile.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-macropath.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-relocate.$(OBJEXT): defs.h
 
 src/libs/libgroff/version.cpp: $(top_srcdir)/.version
-	@echo Making version.cpp
-	@echo const char \*version_string = \"$(MAJOR_VERSION).$(MINOR_VERSION)\"\; >$@
-	@echo const char \*revision_string = \"$(REVISION)\"\; >>$@
-	@echo extern \"C\" { >>$@
-	@echo const char \*Version_string = \"$(VERSION)\"\; >>$@
-	@echo } >>$@ \
-	  | sed -e 's/\.0\"/\"/' >>$@
+	$(AM_V_at)printf 'const char *version_string = "%s.%s";\n' \
+	  $(MAJOR_VERSION) $(MINOR_VERSION) > $@.tmp
+	$(AM_V_at)printf 'const char *revision_string = "%s";\n' \
+	  $(REVISION) >> $@.tmp
+	$(AM_V_at)printf \
+	  'extern "C" {\nconst char *Version_string = "%s";\n}\n' \
+	  $(VERSION) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
 
 all: charset.alias ref-add.sed ref-del.sed
 
 charset.alias: $(libgroff_srcdir)/config.charset
-	$(SHELL) $(libgroff_srcdir)/config.charset '$(HOST)' > t-$@
-	mv t-$@ $@
-
-ref-add.sed : $(libgroff_srcdir)/ref-add.sin
-	sed -e '/^#/d' \
-	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' $(libgroff_srcdir)/ref-add.sin > t-$@
-	mv t-$@ $@
-
-ref-del.sed : $(libgroff_srcdir)/ref-del.sin
-	sed -e '/^#/d' \
-	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' $(libgroff_srcdir)/ref-del.sin > t-$@
-	mv t-$@ $@
+	$(AM_V_GEN)$(SHELL) $(libgroff_srcdir)/config.charset \
+	    '$(HOST)' > t-$@ \
+	  && mv t-$@ $@
+
+ref-add.sed: $(libgroff_srcdir)/ref-add.sin
+	$(AM_V_GEN)sed -e '/^#/d' \
+	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' \
+	    $(libgroff_srcdir)/ref-add.sin > t-$@ \
+	  && mv t-$@ $@
+
+ref-del.sed: $(libgroff_srcdir)/ref-del.sin
+	$(AM_V_GEN)sed -e '/^#/d' \
+	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' \
+	    $(libgroff_srcdir)/ref-del.sin > t-$@ \
+	  && mv t-$@ $@
 
 install-data-local: install_charset_data
 install_charset_data:
@@ -12561,49 +15191,41 @@
 	  rm -f $(DESTDIR)$(libdir)/t-charset.alias; \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
 gropdf: $(gropdf_dir)/gropdf.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)$(RM) $@ \
@@ -12624,32 +15246,37 @@
 	       >$@ \
 	&& chmod +x $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
+
+$(GXDITVIEW_GROFF_VERSION_H): $(top_srcdir)/.version
+	$(AM_V_at)$(MKDIR_P) `dirname $@`
+	$(AM_V_GEN)printf \
+	  'const char *Version_string = "%s";\n' '@VERSION@' > $@
 
-# Because we defined gxditview_CPPFLAGS, automake renames all the xditview's 
-# objects, adding an "gxditview-" prefix. 
+# Because we defined gxditview_CPPFLAGS, automake renames all of
+# xditview's objects, adding an "gxditview-" prefix.
 @WITHOUT_X11_FALSE@src/devices/xditview/gxditview-device.$(OBJEXT): defs.h
 @WITHOUT_X11_FALSE@src/devices/xditview/gxditview-xditview.$(OBJEXT): $(XDITVIEW_GENHDRS)
 
 @WITHOUT_X11_FALSE@src/devices/xditview/GXditview-ad.h: $(xditview_srcdir)/GXditview.ad
-@WITHOUT_X11_FALSE@	@echo Making $@
-@WITHOUT_X11_FALSE@	$(SHELL) $(xditview_srcdir)/ad2c $(xditview_srcdir)/GXditview.ad > $@
+@WITHOUT_X11_FALSE@	$(AM_V_GEN)$(SHELL) $(xditview_srcdir)/ad2c \
+@WITHOUT_X11_FALSE@	  $(xditview_srcdir)/GXditview.ad > $@
 
 # Custom installation of GXditview.ad and GXditview-color.ad
 install-data-local: install_xditview
@@ -12657,154 +15284,110 @@
 
 @WITHOUT_X11_TRUE@install_xditview:
 @WITHOUT_X11_TRUE@uninstall_xditview:
-@WITHOUT_X11_FALSE@install_xditview: $(xditview_srcdir)/GXditview.ad $(xditview_srcdir)/GXditview-color.ad
-@WITHOUT_X11_FALSE@	-test -d $(DESTDIR)$(appresdir) \
-@WITHOUT_X11_FALSE@	  || $(mkinstalldirs) $(DESTDIR)$(appresdir)
-@WITHOUT_X11_FALSE@	if test -f $(DESTDIR)$(appresdir)/GXditview; then \
-@WITHOUT_X11_FALSE@	  mv $(DESTDIR)$(appresdir)/GXditview \
-@WITHOUT_X11_FALSE@	    $(DESTDIR)$(appresdir)/GXditview.old; \
-@WITHOUT_X11_FALSE@	fi
-@WITHOUT_X11_FALSE@	if test -f $(DESTDIR)$(appresdir)/GXditview-color; then \
-@WITHOUT_X11_FALSE@	  mv $(DESTDIR)$(appresdir)/GXditview-color \
-@WITHOUT_X11_FALSE@	    $(DESTDIR)$(appresdir)/GXditview-color.old; \
-@WITHOUT_X11_FALSE@	fi
+@WITHOUT_X11_FALSE@install_xditview: \
+@WITHOUT_X11_FALSE@  $(xditview_srcdir)/FontMap-X11 \
+@WITHOUT_X11_FALSE@  $(xditview_srcdir)/GXditview.ad \
+@WITHOUT_X11_FALSE@  $(xditview_srcdir)/GXditview-color.ad
+@WITHOUT_X11_FALSE@	$(MKDIR_P) $(DESTDIR)$(fontdir)
+@WITHOUT_X11_FALSE@	$(INSTALL_DATA) $(xditview_srcdir)/FontMap-X11 \
+@WITHOUT_X11_FALSE@	  $(DESTDIR)$(fontdir)/FontMap-X11
+@WITHOUT_X11_FALSE@	-test -d $(DESTDIR)$(appdefdir) \
+@WITHOUT_X11_FALSE@	  || $(mkinstalldirs) $(DESTDIR)$(appdefdir)
 @WITHOUT_X11_FALSE@	$(INSTALL_DATA) $(xditview_srcdir)/GXditview.ad \
-@WITHOUT_X11_FALSE@	  $(DESTDIR)$(appresdir)/GXditview
+@WITHOUT_X11_FALSE@	  $(DESTDIR)$(appdefdir)/GXditview
 @WITHOUT_X11_FALSE@	$(INSTALL_DATA) $(xditview_srcdir)/GXditview-color.ad \
-@WITHOUT_X11_FALSE@	  $(DESTDIR)$(appresdir)/GXditview-color
+@WITHOUT_X11_FALSE@	  $(DESTDIR)$(appdefdir)/GXditview-color
 
 @WITHOUT_X11_FALSE@uninstall_xditview:
-@WITHOUT_X11_FALSE@	rm -f $(DESTDIR)$(appresdir)/GXditview
-@WITHOUT_X11_FALSE@	rm -f $(DESTDIR)$(appresdir)/GXditview-color
+@WITHOUT_X11_FALSE@	rm -f $(DESTDIR)$(appdefdir)/GXditview
+@WITHOUT_X11_FALSE@	rm -f $(DESTDIR)$(appdefdir)/GXditview-color
+@WITHOUT_X11_FALSE@	rm -f $(DESTDIR)$(fontdir)/FontMap-X11
+@WITHOUT_X11_FALSE@	-rmdir $(DESTDIR)$(fontdir) 2>/dev/null
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
+# Since eqn_CPPFLAGS was set, all .o files have an 'eqn-' prefix.
 src/preproc/eqn/eqn-lex.$(OBJEXT): src/preproc/eqn/eqn.hpp
 
 neqn: $(top_srcdir)/src/preproc/eqn/neqn.sh $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)$(RM) $@ \
-	&& sed -e 's/@g@/$(g)/g' \
+	$(AM_V_GEN)sed -e 's/@g@/$(g)/g' \
 	       -f $(SH_DEPS_SED_SCRIPT) \
 	       -e $(SH_SCRIPT_SED_CMD) \
 	       $(top_srcdir)/src/preproc/eqn/neqn.sh \
-	       >$@ \
-	&& chmod +x $@
+	       >$@.tmp \
+	&& chmod +x $@.tmp \
+	&& mv $@.tmp $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 src/preproc/grn/main.$(OBJEXT): defs.h
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 src/preproc/html/pre-html.$(OBJEXT): defs.h
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
+# Since pic_CPPFLAGS was set, all .o files have a 'pic-' prefix.
 src/preproc/pic/pic-lex.$(OBJEXT): src/preproc/pic/pic.hpp
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-# As refer_CPPFLAGS was set, all the .o have a 'refer-' prefix
+# vim: set autoindent filetype=automake textwidth=72:
+
+# Since refer_CPPFLAGS was set, all .o files have a 'refer-' prefix.
 src/preproc/refer/refer-command.$(OBJEXT): defs.h
 src/preproc/refer/refer-ref.$(OBJEXT): defs.h
 src/preproc/refer/refer-refer.$(OBJEXT): defs.h
 src/preproc/refer/refer-token.$(OBJEXT): defs.h
 src/preproc/refer/refer-label.$(OBJEXT): defs.h
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 src/roff/groff/groff.$(OBJEXT): defs.h
 
-groff_opts.tmp: src/roff/groff/groff.cpp
-	@$(GREP) -e ':.*:.*:' $? | sed -e 's/ \t",//g' > $@
-	@echo -n 'groff options: '
-	@cat $@
-
-groff_opts_no_arg.txt: groff_opts.tmp
-	@sed -e 's/a-zA-Z://g' $? > $@
-	@echo -n 'no arg: '
-	@cat $@
-
-groff_opts_with_arg.txt: groff_opts_no_arg.txt
-	@rm -f $@
-	@sed "s/`cat $?`://g" groff_opts.tmp > $@
-	@echo -n 'with arg: '
-	@cat $@
-
-########################################################################
-# Editor settings
-########################################################################
-#
-# Local Variables:
-# mode: makefile-automake
-# fill-column: 72
-# End:
-# vim: set filetype=automake textwidth=72:
-
-# Perl version works for all parts of 'groff'.
-
-grog: $(grog_srcdir)/grog.pl $(GROG) $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)$(RM) $@ \
-	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
-	       -e "1s|^$#! $.*perl|\\1$(PERL)|" \
-	       -e "s|@g@|$(g)|g" \
-	       -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
-	       -e "s|@libdir@|$(DESTDIR)$(libdir)|g" \
-	       -e "s|@EGREP@|$(EGREP)|g" \
-	       -e "s|@VERSION@|$(VERSION)|" \
-	       -e "s|@grog_dir@|$(grog_dir)|" \
-	       -e "$(SH_SCRIPT_SED_CMD)" \
-	       $(grog_srcdir)/grog.pl \
-	       >$@ \
-	&& chmod +x $@
-
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 nroff: $(nroff_srcdir)/nroff.sh $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)rm -f $@ \
@@ -12815,44 +15398,38 @@
 	       >$@ \
 	&& chmod +x $@
 
-########################################################################
-### Emacs settings
 # Local Variables:
 # mode: makefile-automake
+# fill-column: 72
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
 src/roff/troff/input.$(OBJEXT): defs.h
 
 src/roff/troff/majorminor.cpp: $(top_srcdir)/.version
-	@echo Making $@
-	@$(RM) $@
-	@echo const char \*major_version = \"$(MAJOR_VERSION)\"\; >$@
-	@echo const char \*minor_version = \"$(MINOR_VERSION)\"\; >>$@
-	@echo const char \*revision = \"$(REVISION)\"\; >>$@
+	$(AM_V_at)printf 'const char *major_version = "%s";\n' \
+	  $(MAJOR_VERSION) > $@.tmp
+	$(AM_V_at)printf 'const char *minor_version = "%s";\n' \
+	  $(MINOR_VERSION) >> $@.tmp
+	$(AM_V_at)printf 'const char *revision = "%s";\n' \
+	  $(REVISION) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 
 afmtodit: $(afmtodit_srcdir)/afmtodit.pl $(afmtodit_srcdir)/afmtodit.tables
 	$(AM_V_GEN)if test -n "$(PERL)"; then \
-	  sed -e "s|/usr/bin/perl|$(PERL)|" \
+	  sed -e "s|@PERL@|$(PERL)|" \
 	      -e "s|@VERSION@|$(VERSION)|" \
 	      -e "s|@FONTDIR@|$(fontdir)|" \
 	      -e "/@afmtodit.tables@/ r $(afmtodit_srcdir)/afmtodit.tables" \
@@ -12869,25 +15446,33 @@
 	fi \
 	&& chmod +x afmtodit
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+grog: $(grog_srcdir)/grog.pl $(SH_DEPS_SED_SCRIPT)
+	$(AM_V_GEN)$(RM) $@ \
+	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
+	       -e "s|@PERL@|$(PERL)|" \
+	       -e "s|@VERSION@|$(VERSION)|" \
+	       -e "$(SH_SCRIPT_SED_CMD)" \
+	       $(grog_srcdir)/grog.pl \
+	       >$@ \
+	&& chmod +x $@
+
+# Local Variables:
+# mode: makefile-automake
+# fill-column: 72
+# End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
 src/utils/indxbib/indxbib.$(OBJEXT): defs.h
 
 install-data-local: install_indxbib
@@ -12912,61 +15497,62 @@
 uninstall_indxbib:
 	rm -f $(DESTDIR)$(common_words_file)
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 src/utils/lkbib/lkbib.$(OBJEXT): defs.h
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-
-dist-hook: tmac-dist-hook
-tmac-dist-hook:
-	chmod u+w $(distdir)/tmac
-	for f in $(TMACMDOCFILES) $(TMACSTRIPFILES); do \
-	  cp -f $(top_srcdir)/$$f-u $(distdir)/tmac; \
-	done
-
-$(TMACMDOCFILES) $(TMACSTRIPFILES): 
-	$(MKDIR_P) $(top_builddir)/tmac
-	for f in $(TMACMDOCFILES) $(TMACSTRIPFILES); do \
-	   sed -f $(tmac_srcdir)/strip.sed $(top_srcdir)/$$f-u > $(top_builddir)/$$f; \
-	done
+# vim: set autoindent filetype=automake textwidth=72:
 
 tmac/www.tmac: tmac/www.tmac.in
-	$(MKDIR_P) $(top_builddir)/tmac
-	sed -e "s;@PNMTOPS_NOSETPAGE@;$(pnmtops_nosetpage);g" \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/tmac
+	$(AM_V_GEN)sed -e \
+	  "s;@PNMTOPS_NOSETPAGE@;$(pnmtops_nosetpage);g" \
 	  $(tmac_srcdir)/www.tmac.in > $(top_builddir)/tmac/www.tmac
 
+$(M4CHECK): tmac/groff_man.7.man.in
+	$(AM_V_at)! $(EGREP) \
+	  '(^|:space:)($(M4WORDS))($$|:space:)' \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
+tmac/groff_man.7.man: tmac/groff_man.7.man.in $(M4CHECK)
+	$(AM_V_GEN)$(M4) -D_groff_man_not_style \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
+tmac/groff_man_style.7.man: tmac/groff_man.7.man.in $(M4CHECK)
+	$(AM_V_GEN)$(M4) -D_groff_man_style \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
 # The installation of groff compatibility wrappers for vendor-provided
 # non-GNU macro sets is controlled by 'compatibility_wrappers' (see the
 # commentary surrounding m4/groff.m4's
@@ -12998,21 +15584,22 @@
 
 all: tmac/stamp-wrap
 
-# Generate groff compatibility wrappers for all non-GNU OS provided
-# macro sets.
+# Generate compatibility wrappers for non-GNU OS-provided macro packages
+# for which groff provides an alternative implementation.
 tmac/stamp-wrap:
-	$(MKDIR_P) $(top_builddir)/tmac;
-	if test -n "$(tmac_wrap)"; then \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/tmac;
+	$(AM_V_at)if test -n "$(tmac_wrap)"; then \
 	  for m in ""$(tmac_wrap); do \
 	    $(RM) $(top_builddir)/tmac/$$m-wrap; \
 	    if test "$$m" = an; then \
-	      echo .do mso andoc.tmac >>$(top_builddir)/tmac/$$m-wrap; \
+	      echo .do mso an.tmac >>$(top_builddir)/tmac/$$m-wrap; \
 	    fi; \
 	    echo .cp 1 >>$(top_builddir)/tmac/$$m-wrap; \
-	    echo .so $(sys_tmac_prefix)$$m >>$(top_builddir)/tmac/$$m-wrap; \
+	    echo .so $(sys_tmac_prefix)$$m \
+	      >>$(top_builddir)/tmac/$$m-wrap; \
 	  done; \
 	fi
-	touch $@
+	$(AM_V_at)touch $@
 
 # Install groff compatibility wrappers into
 # <prefix>/lib/groff/site-tmac.
@@ -13023,7 +15610,7 @@
 	  if test -n "$(tmac_wrap)"; then \
 	    for m in ""$(tmac_wrap); do \
 	      $(INSTALL_DATA) $(tmac_builddir)/$$m-wrap \
-                $(DESTDIR)$(systemtmacdir)/$$m$(wrapper_suffix).tmac; \
+	        $(DESTDIR)$(systemtmacdir)/$$m$(wrapper_suffix).tmac; \
 	    done; \
 	  fi; \
 	fi
@@ -13070,15 +15657,14 @@
 	  rmdir $(DESTDIR)$(localtmacdir); \
 	fi
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:
+
+.DELETE_ON_ERROR:
+.PRECIOUS: $(TEST_SUITE_LOG)
 
 # if there is a name prefix we install the man pages by hand
 all: generate_man_files
@@ -13145,9 +15731,6 @@
 	  fi; \
 	  rmdir $(DESTDIR)$(dataprogramdir); \
 	fi
-	if test -d $(DESTDIR)$(grog_dir); then \
-	  rmdir $(DESTDIR)$(grog_dir); \
-	fi
 	if test -d $(DESTDIR)$(libprogramdir); then \
 	  if test -d $(DESTDIR)$(systemtmacdir); then \
 	    rm -f $(DESTDIR)$(systemtmacdir)/*; \
@@ -13160,6 +15743,12 @@
 	    rmdir $(DESTDIR)$(exampledir); \
 	  fi; \
 	  if test -d $(DESTDIR)$(htmldocdir); then \
+	    if test -d $(DESTDIR)$(htmldocdir)/groff.html.mono; then \
+	      rmdir $(DESTDIR)$(htmldocdir)/groff.html.mono; \
+	    fi; \
+	    if test -d $(DESTDIR)$(htmldocdir)/groff.html.node; then \
+	      rmdir $(DESTDIR)$(htmldocdir)/groff.html.node; \
+	    fi; \
 	    rmdir $(DESTDIR)$(htmldocdir); \
 	  fi; \
 	  rmdir $(DESTDIR)$(docdir); \
@@ -13174,23 +15763,22 @@
 @USEPROGRAMPREFIX_TRUE@	   done; \
 @USEPROGRAMPREFIX_TRUE@	fi
 .man:
-	$(AM_V_GEN)rm -f $@ \
-	&& $(MKDIR_P) `dirname $@` \
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& LC_ALL=C \
-	 sed -e "s|@APPRESDIR@|`echo $(appresdir) | sed -f $(makevarescape)`|g" \
+	 sed -e "s|@APPDEFDIR@|`echo $(appdefdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@BINDIR@|`echo $(bindir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@COMMON_WORDS_FILE@|`echo $(common_words_file) | sed -f $(makevarescape)`|g" \
+	     -e "s|@COMPATIBILITY_WRAPPERS@|$(compatibility_wrappers)|g" \
 	     -e "s|@DATASUBDIR@|`echo $(datasubdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@DEFAULT_INDEX@|`echo $(indexdir)/$(indexname) | sed -f $(makevarescape)`|g" \
 	     -e "s|@DEFAULT_INDEX_NAME@|`echo $(indexname) | sed -f $(makevarescape)`|g" \
-	     -e "s|@DEVICE@|$(DEVICE)|g" \
+	     -e "s|@DEVICE@|\\\\%$(DEVICE)|g" \
 	     -e "s|@DOCDIR@|`echo $(docdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@EXAMPLEDIR@|`echo $(exampledir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@FONTDIR@|`echo $(fontdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@g@|$(g)|g" \
-	     -e "s!@G@!`echo $(g) | tr 'a-z' 'A-Z'`!g" \
+	     -e "s|@g@|\\\\%$(g)|g" \
 	     -e "s|@HTMLDOCDIR@|`echo $(htmldocdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@INDEX_SUFFIX@|$(indexext)|g" \
+	     -e "s|@INDEX_SUFFIX@|\\\\%$(indexext)|g" \
 	     -e "s|@LEGACYFONTDIR@|`echo $(legacyfontdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@LOCALFONTDIR@|`echo $(localfontdir) | sed -f $(makevarescape)`|g" \
 	     -e "s|@LOCALMACRODIR@|`echo $(localtmacdir) | sed -f $(makevarescape)`|g" \
@@ -13200,12 +15788,14 @@
 	     -e "s|@MAN7EXT@|$(man7ext)|g" \
 	     -e "s|@MDATE@|`$(PERL) $(top_srcdir)/mdate.pl $<`|g" \
 	     -e "s|@OLDFONTDIR@|`echo $(oldfontdir) | sed -f $(makevarescape)`|g" \
+	     -e "s|@PAGE@|\\\\%$(PAGE)|g" \
 	     -e "s|@PDFDOCDIR@|`echo $(pdfdocdir) | sed -f $(makevarescape)`|g" \
+	     -e "s|@PSPRINT@|`echo $(PSPRINT) | sed -f $(makevarescape)`|g" \
 	     -e "s|@SYSTEMMACRODIR@|`echo $(systemtmacdir) | sed -f $(makevarescape)`|g" \
-	     -e "s|@TMAC_AN_PREFIX@|$(tmac_an_prefix)|g" \
-	     -e "s|@TMAC_M_PREFIX@|$(tmac_m_prefix)|g" \
-	     -e "s|@TMAC_MDIR@|$(tmacdir)/mm|g" \
-	     -e "s|@TMAC_S_PREFIX@|$(tmac_s_prefix)|g" \
+	     -e "s|@TMAC_AN_PREFIX@|\\\\%$(tmac_an_prefix)|g" \
+	     -e "s|@TMAC_M_PREFIX@|\\\\%$(tmac_m_prefix)|g" \
+	     -e "s|@TMAC_MDIR@|`echo $(tmacdir) | sed -f $(makevarescape)`/mm|g" \
+	     -e "s|@TMAC_S_PREFIX@|\\\\%$(tmac_s_prefix)|g" \
 	     -e "s|@VERSION@|$(VERSION)|g" \
 	     $< \
 	     >$@
@@ -13214,11 +15804,11 @@
 dist-hook:
 	echo $(VERSION) > $(distdir)/.tarball-version
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:
 
 # Tell versions 3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.

_service:tar_scm:groff-1.22.4.tar.gz/NEWS -> _service:tar_scm:groff-1.23.0.tar.gz/NEWS Changed

@@ -1,11 +1,692 @@
-    Copyright (C) 1992-2018 Free Software Foundation, Inc.
+    Copyright (C) 1992-2023 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-This file describes recent user-visible changes in groff.  Bug fixes are not
-described.  There are more details in the man and info pages.
+This file describes recent user-visible changes in groff.  Bug fixes are
+not described.  There are more details in the man and info pages.
+
+VERSION 1.23.0
+==============
+
+troff
+-----
+
+o The `troffrc` file now loads an English localization file instead of
+  directly housing configuration parameters appropriate to the English
+  language.  See "Macro Packages" below.
+
+o A new read-only register `.cp` is implemented.  Within a `do` request,
+  "\n.cp" holds the saved value of compatibility mode.  See
+  groff_diff(7) or the groff Texinfo manual for rationale, use case, and
+  example.
+
+o New read-only registers `.nm` and `.nn` are implemented.  `.nm` is of
+  Boolean sense, reporting the enablement status of output line
+  numbering (caused by the `nm` request) irrespective of the temporary
+  suspension of numbering with the `nn` request.  `.nn` holds the count
+  of numbered output lines still to have that numbering suppressed.
+  These registers were introduced because there was no way for the
+  formatter (and thus a document) to introspect their state, tbl(1)
+  needs to be able to do so, and the writable line number register `ln`
+  is not a reliable proxy for this information.
+
+o Type size escape sequences of the form "\sNN", where NN is in the
+  range 10-39, are now recognized only in compatibility mode ("groff
+  -C"); when encountered, an error diagnostic is emitted.  Otherwise,
+  "\sN" is interpreted as setting the type size to the single-digit
+  value N (in scaled points), which ends the escape sequence.  This
+  change eliminates a quirk in the language grammar that dates back to
+  the mid-1970s (AT&T troff by Ossanna) but was not documented in the
+  Troff User's Manual until 1992 when Kernighan updated CSTR #54 for
+  device-independent AT&T troff.
+
+  The form "\s(NN" is accepted for two-digit sizes in all known troffs.
+  The form "\sNNN" accepts a numeric expression of variable length; it
+  has been supported by groff since version 1.01 (March 1991) or
+  earlier, by Heirloom Doctools troff since its 2005-08-16 release, and
+  by neatroff, but not by Plan 9 troff.  The form "\s'NNN'" is also
+  widely supported.
+
+  Summary: in your documents, rewrite escape sequences beginning with
+  "\s1", "\s2", or "\s3" in an unambiguous and portable form.  For
+  instance, "\s36" can become any of:
+    \s(36
+    \s36
+    \s'36'
+  You can use
+    grep '\\s123'
+  to find instances in your documents.
+
+  Those who have changed the escape character with the `ec` request (an
+  advanced usage) are expected to be able to cope; ask the development
+  team for support if you need it.
+
+o New requests `soquiet` and `msoquiet` are available.  They operate as
+  `so` and `mso`, respectively, except that they do not emit a warning
+  diagnostic if the file named in their argument does not exist.
+
+o New requests `stringdown` and `stringup` are available.  These change
+  the string named in their argument by replacing each of its bytes with
+  its lowercase or uppercase version (if any), respectively.  groff
+  special characters (see the groff_char(7) man page) in the string will
+  often transform in the expected way due to the regular naming
+  convention for accented letters.  When they do not, use substrings
+  and/or catenation.
+
+o The `ab` request no longer writes "User Abort." to the standard error
+  stream if given no arguments.
+
+o The `fp` request no longer accepts file or font names with slashes in
+  them as arguments.  All font description files are expected to be
+  accessible within the directory of the output device for which they
+  were prepared.
+
+nroff
+-----
+
+o The new option -P takes an argument to pass to the output driver
+  (always grotty(1)).  "-P-i" directs the terminal device to display
+  real italic (oblique) characters instead of underlining: it is up to
+  your terminal (emulator) to support italics (xterm does since patch
+  #314 2014-12-28).  "-P-h" can now be used instead of -h; the latter
+  may eventually be deprecated and repurposed.
+
+o The new option -V emits the constructed groff command that nroff would
+  run to standard output instead of executing it.  Arguments to nroff
+  that contain shell metacharacters may not be sufficiently escaped for
+  the output of nroff -V to be copied and pasted to the shell prompt;
+  this is a historical deficiency of the Bourne shell family not yet
+  corrected by the POSIX standard.
+
+o nroff now recognizes the -b, -E, -k, -K, -R, and -z options and passes
+  them through to groff.
+
+o nroff now supports spaces and tabs between option flag letters and
+  arguments to options, like groff and troff themselves.
+
+groff
+-----
+
+o The -I option now implies -g (run the grn(1) preprocessor), and
+  supplies grn an -M option with the argument to -I.
+
+eqn
+---
+
+o The GNU extension
+
+    delim on
+
+  is now recognized even in AT&T compatibility mode (the -C option) in
+  order to reliably integrate with tbl.  Few eqn documents are expected
+  to use 'o' and 'n' as left and right delimiters, respectively.  If
+  yours does, consider swapping them, or select others.
+
+o The command-line option -D is no longer supported.  It has been
+  undocumented, and issued a warning of its obsolescence upon use, for
+  30 years, since groff 1.06 (September 1992).
+
+pic
+---
+
+o The token `.PY` is now recognized as a synonym of `.PF` to work around
+  a name space collision with the m (mm) macro package, which defines
+  `PF` as a page footer management macro.  (This problem dates back at
+  least to Unix System V Release 2, 1983.)  You should continue to use
+  `.PF` to end pictures with flyback unless a similar problem faces your
+  document.
+
+tbl
+---
+
+o GNU tbl now suspends output line numbering while formatting tables,
+  saving and restoring its status before and after each table region,
+  including the count of lines for which numbering is suppressed.
+  Historical tbl implementations did not, with bizarre consequences when
+  text blocks were used in tables.
+
+Macro packages
+--------------
+
+o mom version 2.5 is distributed with this release.  New features
+  include shaded backgrounds, frames, and colored pages.  Thanks to
+  Peter Schaffter.
+
+o English localization has been split into a dedicated macro file,
+  `en.tmac`, for better parallelism with other localization files and to
+  improve support for multilingual documents.  Those who want a
+  different default input language should edit the troffrc file to
+  source the desired groff locale macro file (`cs.tmac`, `de.tmac`,
+  `den.tmac`, `fr.tmac`, `it.tmac`, `ja.tmac`, `sv.tmac`, or `zh.tmac`)
+  instead of `en.tmac`.
+
+  The default hyphenation mode (as given to the `hy` request) for users
+  of English has changed from "1", which was inappropriate for the
+  TeX-based hyphenation patterns groff has used since at least 1991, to
+  "4".  However, invoking ".hy" without an argument remains synonymous
+  with ".hy 1".
+
+o The hyphenation patterns for English have been updated using the
+  `hyph-en-us.tex` patterns file from the TeX hyph-utf8 project.  The
+  new patterns likely _will_ change the automatic hyphenation break
+  points of your English documents.
+
+o The `PDFPIC` macro (provided by the `pdfpic` package) no longer aborts
+  upon encountering trouble.  Instead, it reports an error and abandons
+  processing of its argument(s).  It is also more sensitive to other
+  kinds of problems and handles them the same way, by issuing a
+  diagnostic and returning.  If you wish `PDFPIC` to abort document
+  processing immediately upon error, you can append an `ab` request to
+  the package's error-handling macro.
+
+    .am pdfpic@error
+    .  ab
+    ..
+
+o The pspic package now also has an error hook macro, which you can use
+  to make failed image loads fatal (or attempt fallback or recovery).
+
+    .am pspic@error-hook
+    .  ab
+    ..
+
+o The new rfc1345 macro package, contributed by Dorai Sitaram, defines
+  special character identifiers implementing RFC 1345 mnemonics (plus
+  some additions from Vim, which itself uses RFC 1345 for its digraphs).
+  It is documented in the groff_rfc1345(7) man page.
+
+o The new sboxes macro package, contributed by Deri James, offers a
+  simple interface to the new gropdf(1) "background" feature.  Using it,
+  ms documents can draw colored rectangles beneath any groff output.
+  See "Using PDF boxes with groff and the ms macros", installed as
+  `msboxes.ms` and `msboxes.pdf` for instructions and a demonstration.
+
+o The an (man) and doc (mdoc) macro packages no longer remap the -, ',
+  and ` input characters to Basic Latin code points on UTF-8 devices,
+  but treat them as groff normally does (and AT&T troff before it did)
+  for typesetting devices, where they become the hyphen, apostrophe or
+  right single quotation mark, and left single quotation mark,
+  respectively.  This change is expected to expose glyph usage errors in
+  man pages.  See the "PROBLEMS" file for a recipe that will conceal
+  these errors.  A better long-term approach is for man pages to adopt
+  correct input practices; the man pages groff_man_style(7),
+  groff_char(7), and man-pages(7) (subsection "Generating optimal
+  glyphs"; from the Linux man-pages project) contain such instructions.
+  Doing so also improves man page typography when formatting for PDF.
+
+  If you maintain a generator of man(7) or mdoc(7) documents (such as a
+  tool that converts other formats to them), and need assistance, please
+  contact the groff@gnu.org mailing list and describe your situation.
+
+o The an (man) macro package can now produce clickable hyperlinks within
+  terminal emulators, using the OSC 8 support added to grotty(1) (see
+  below).  The groff man(7) extension macros `UR` and `MT`, present
+  since 2007, expose this feature.  At present the feature is disabled
+  by default in `man.local` pending more widespread recognition of OSC 8
+  sequences in pager programs.  The package now recognizes a `U`
+  register to enable hyperlinks in any output driver supporting them.
+
+  Use a command like
+    printf '\0338;;man:grotty(1)\033\\grotty(1)\0338;;\033\\\n' | more
+  to check your terminal and pager for OSC 8 support.  If you see
+  "grotty(1)" and no additional garbage characters, then you may wish to
+  edit "man.local" to remove the lines that disable this feature.
+
+o The an (man) macro package supports a new macro, `MR`, intended for
+  use by man page cross references in preference to the font style
+  alternation macros historically used.  Where before you would write
+    .BR ls (1).
+  or
+    .IR ls (1).
+  you should now write
+    .MR ls 1 .
+  (the third argument, typically used for trailing punctuation, is
+  optional).  Because the macro semantically identifies a man page, it
+  can create a clickable hyperlink ("man:ls(1)" for the above example)
+  on supporting devices.  Furthermore, a new string, `MF`, defines the
+  font to be used for setting the man page topic (the first argument to
+  `MR` and `TH`), permitting configuration by distributions, sites, and
+  users.
+
+  Inclusion of the `MR` macro was prompted by its introduction to
+  Plan 9 from User Space's troff in August 2020.  Its purpose is to
+  ameliorate several long-standing problems with man page cross
+  references: (1) the package's lack of inherent hyperlink support for
+  them; (2) false-positive identification of strings resembling man page
+  cross references (as can happen with "exit(1)", "while(1)",
+  "sleep(5)", "time(0)" and others) by terminal emulators and other
+  programs; (3) the unwanted intrusion of hyphens into man page topics,
+  which frustrates copy-and-paste operations (this problem has always
+  been avoidable through use of the \% escape sequence, but cross
+  references are frequent in man pages and some page authors are
+  inexpert *roff users); and (4) deep divisions in man page maintenance
+  communities over which typeface should be used to set the man page
+  topic (italics, roman, or bold).
+
+o Part of the an (man) macro package has been renamed from "an-old.tmac"
+  to "an.tmac", replacing a file that sourced the "andoc.tmac" wrapper.
+  This means that the "-man" argument to groff (or nroff, or troff) will
+  no longer load the andoc wrapper, and not successfully format mdoc(7)
+  man pages.  If you are not sure which macro package a given man page
+  uses, or you wish to batch-process a series of man pages written
+  variously in the man and mdoc formats, be sure to call the formatter
+  with the "-mandoc" option explicitly, as "-man" will no longer do
+  this.  The man-db man(1) implementation has, since 2001, used
+  "-mandoc" preferentially if available when man-db is configured.
+
+o The an (man) and doc (mdoc) macro packages support a new `AD` string
+  to put the default adjustment mode under user control at rendering
+  time.  The default is "b" (adjust lines to both margins) as has been
+  the Unix man(7) default since 1979.
+
+o The an (man) and doc (mdoc) macro packages support new `CS` and `CT`
+  registers to control rendering of man page section headings and topics
+  (seen in the page header), respectively, in full capitals.  These
+  default off (with no visible effect on pages that already fully
+  capitalize such text in man page sources).  The rationale is to
+  encourage man page authors to preserve case distinction information in
+  (or restore it to) their topics and section headings, while giving
+  users (including system administrators, distributors, integrators, and
+  maintainers of man(1) implementations) a way to view the rendered page
+  elements in full capitals if desired.
+
+o The an (man) macro package no longer honors an `ll` request to set the
+  line length on nroff devices prior to processing a man page.  This was
+  deprecated in groff 1.18 (July 2002), and all known man program and
+  macro package implementations either have set an LL register since
+  2002 (man-db man), 2005 (Brouwer/Lucifredi man), or don't let the user
+  vary the line length freely (DWB troff, Solaris troff, Plan 9 troff),
+  don't permit its configuation via the `ll` request (mandoc), or at all
+  (Heirloom Doctools troff).
+
+o The an (man) macro package now interprets the value of the `HY`
+  register as a Boolean; using it to set a specific hyphenation mode is
+  no longer supported.  The groff command-line option `-rHY=0` continues
+  to disable automatic hyphenation of man page text as before.
+
+o The an (man) macro package's `TS` macro no longer inserts vertical
+  space.  It was not documented to do so, but had since groff 1.18 (July
+  2002).  Man page authors may freely use paragraphing macros around
+  tables if vertical space is desired.
+
+o The an (man) macro package no longer attempts to detect misuse of the
+  `R` string as a macro.  The `R` string itself is a legacy feature, not
+  required in modern man pages; see groff_man_style(7).
+
+o The groff_man(7) man page documenting the groff implementation of the
+  an (man) macro package has been split into two pages.  The original
+  page remains as a terser reference for experienced users.  A new page,
+  groff_man_style(7), is a tutorial and style guide containing the same
+  material supplemented with explanations, examples, and advice for the
+  reader who is not an expert in *roff systems or in writing man pages.
+
+o The doc (mdoc) macro package now honors the `C`, `FT`, `HY`, `IN`,
+  `P`, `SN`, and `X` registers and `HF` string as the an (man) package
+  does.
+
+o The doc (mdoc) macro package now renders man page (sub)section cross
+  references cited with the `Sx` macro by quoting them instead of
+  setting them in italics.
+
+o The e (me) macro package has changed its default line length on
+  typesetting devices from 6i to the output device's default (for
+  example, 6.5i on the 'ps' and 'pdf' devices).  You can use
+  "papersize.tmac" to override this length, as in "groff -d paper=a4l"
+  to select A4 paper in landscape orientation, without needing to alter
+  the document.
+
+o The e (me) macro package has changed its support for output line
+  numbering with the `n1` and `n2` macros to resolve several bugs in the
+  previous implementation.  The `n1` macro now accepts an optional `C`
+  argument to set the line number at the existing page offset instead of
+  reducing the page offset to make the line number appear in the left
+  margin.  A second argument to the `n2` macro is no longer supported.
+  A new register `no` makes configurable the amount of horizontal space
+  to be used for the line number (the default is unchanged).
+
+o The e (me) macro package now uses strings `wa` and `wc` to store the
+  terms the package produces in chapter headings created by the `$c`
+  macro.  The strings, which default to "Appendix" and "Chapter",
+  respectively, ease localization of the package and replacement of the
+  terms used without requiring the `$c` macro to be redefined.
+
+o The e (me) macro package has a new macro, `ld`, which "re-localizes
+  the date"; if you modify troff registers `dw`, `mo`, and `yr` (to
+  record a document's date of revision, for instance), call `ld`
+  afterward to update the package's `y2` and `y4` registers and the
+  localized strings `dw` and `mo` for the names of the weekday and
+  month.  `ld` is also used internally to simplify the use of the
+  package with languages other than English; it thus updates the `wa`
+  and `wc` strings as well.  If you want to customize these strings, do
+  so after any `ld` call you make.
+
+o The e (me) macro package now has a register `sx` that eases the
+  configuration of space added to the line height above/below when
+  super/subscripting is used.  It defaults to 0.2m, the value used
+  literally in past definitions of the super/subscripting strings.
+  groff's own 'me' documents redefine it to zero.
+
+o The e (me) macro package's `$v` and `$V` registers have been renamed
+  to `tv` and `dv`--they control the vertical spacing used
+  for text and displays/annotations, respectively.  The old names are
+  still supported as aliases.  The new names reflect the fact that users
+  are expected to set them if desired, unlike other registers and
+  strings beginning with "$".
+
+o The e (me) and s (ms) macro packages now offer a `PF` macro,
+  supporting the pic(1) preprocessor's "flyback" feature.  Thanks to
+  Dave Kemper.
+
+o The m (mm) and s (ms) macro packages no longer implement the `IX`
+  macro.  This undocumented 4.2BSD ms extension was similarly
+  undocumented by groff mm and ms.  No documents applying it are
+  attested.  groff mm documents its own indexing feature, `INITI`.  We
+  otherwise suggest makeindex(1), which supports troff and is available
+  with most TeX distributions, for your mm/ms document indexing needs.
+
+o The m (mm) macro package now adapts to the paper format selected when
+  the macro file "papersize.tmac" is used (by specifying the groff "-d
+  paper" command-line option).  A consequence is that "groff -mm" and
+  "groff -d paper=letter -mm" are _not_ synonymous (when groff is
+  configured to use U.S. letter as the default paper format), because
+  groff mm(7) uses a page offset of 0.963 inches on typesetting devices
+  for compatibility with DWB mm.  If the `W` or `O` registers are also
+  set on the command line, the line length and page offset,
+  respectively, are not overridden by "papersize.tmac".
+
+o The m (mm) macro package now recognizes a `V` register to set the
+  vertical spacing for the document.  Like the existing `S`, it must be
+  set from the command line.  Further, both registers are interpreted
+  correctly if suffixed with a scaling unit, instead of requiring an
+  unscaled value assumed to be points.
+
+o The m (mm) macro package now supports AT&T/DWB mm's `Sm` string.
+
+o The m (mm) macro package now requires a title to be declared when
+  memorandum type 5 is used (".MT 5"), just as type 4 has since groff
+  1.10 (November 1995).
+
+o The m (mm) and s (ms) macro packages no longer manipulate the set of
+  enabled warning categories.  If you want all warnings on, use the
+  `warn` request with no arguments in your document or pass "-w w" to
+  groff (see troff(1) or the groff Texinfo manual for more on warnings).
+
+o The m (mm) and s (ms) macro packages' `R` macros now work analogously
+  to their `B` and `I` macros instead of ignoring their arguments.
+
+o The m (mm) package now offers a `PY` macro, which serves the function
+  of `PF` (end pic(1) picture with flyback) from other macro packages.
+
+o The "ptx.tmac" macro file, a counterpart to the GNU coreutils ptx(1)
+  command for generating permuted indexes, is now installed.  It has
+  long been part of the source distribution.
+
+o The s (ms) macro package now enables the formatter's "no-space mode"
+  after ending displays (`DE`), equations (`EN`), tables (`TS`), and
+  pictures without flyback (`PE`).  This means that display distance
+  spacing (the `DD` register) overrides the spacing that may follow in a
+  subsequent paragraph, section heading, or display instead of
+  accumulating with that distance.  This change is to make the behavior
+  of the package more predictable; you can fine-tune such spacing by
+  setting the `DD` register in desired places.  It has also helped us to
+  improve groff ms's rendering of historical ms(7) documents such as
+  Kernighan & Cherry's "Typesetting Mathematics".
+
+o The s (ms) macro package supports a new string, `FR`, which defines
+  the ratio of the footnote line length to the current line length.  The
+  default expression is "11/12", eleven twelfths of the normal line
+  length, adopted for better compatibility with ms documents prepared
+  with AT&T ms or its descendant implementations in Heirloom Doctools
+  and neatroff.  This is a change from previous groff releases, which
+  used a ratio of five sixths.
+
+  You may wish to set the `FR` string to "1" to align with contemporary
+  typesetting practices.  In Unix Version 7 ms, its descendants, and
+  groff prior to this release, an `FL` register was used for the line
+  length in footnotes; however, setting this register at document
+  initialization time had no effect on the footnote line length in
+  multi-column arrangements.
+
+  `FR` should be used in preference to the old `FL` register in
+  contemporary documents; see the groff Texinfo manual or the "Using
+  groff with the ms macros" document, also part of this release.  Thanks
+  to T. Kurt Bond.
+
+o The s (ms) macro package has added strings, `<` and `>`, to perform
+  subscripting.  They work analogously to the `{` and `}` superscripting
+  strings that have been present in groff ms since 1991 or earlier.
+
+o The s (ms) macro package has added a hook macro, `FS-MARK`, which is
+  called automatically by the `FS` macro (with the same arguments given
+  to `FS`) before any other footnote processing.  It is empty by default
+  but can be defined by the user to, for example, place a hyperlink
+  anchor so that a link within a footnote can return to its referential
+  context.  "Portable Document Format Publishing with GNU Troff",
+  distributed with groff as `pdfmark.ms`, uses this technique.  Thanks
+  to Keith Marshall.
+
+o The s (ms) macro package's `RP` macro recognizes a new optional
+  argument, `no-renumber`, which suppresses the renumbering of the page
+  after the cover page as page 1.  It furthermore recognizes the
+  optional argument `no-repeat-info`, which has the same effect as `no`;
+  the latter will continue to be supported for backward compatibility.
+  Optional arguments to `RP` can be given in any order.
+
+o The s (ms) macro package supports new macros `XN` and `XH` to ease the
+  input of numbered and unnumbered section headings, respectively.  They
+  internally call the `XS` and `XE` macros to produce table of contents
+  entries, and lay a foundation for inclusion of PDF bookmarks, all
+  without requiring retyping of the heading text as the package
+  previously encouraged.  Thanks to Keith Marshall.
+
+o The s (ms) macro package now uses a default line length of 6.5 inches
+  by default, resulting in 1-inch left and right margins.  When the
+  "papersize.tmac" package is used by employing the "-d paper" groff(1)
+  option on typesetting devices, the default page offset and line length
+  are adjusted to maintain these margins.
+
+o The "a4.tmac" file has been dropped from the distribution.  Its
+  successor, "papersize.tmac", has been present and documented for
+  nearly 20 years.  See subsection "Paper format" of groff(1).
+
+o The "safer.tmac" file has been dropped from the distribution.  It was
+  present only to support man(1) programs that unconditionally passed
+  the formatter the "-msafer" option, and had contained only comments
+  for over 20 years.  If your man(1) program has this requirement, you
+  can create an empty file of this name in groff's macro file search
+  path (see troff(1)) or consider migrating to man-db man(1).
+
+Output drivers
+--------------
+
+o On output devices using the Latin-1 character encoding ("groff -T
+  latin1" and the X11 devices) the special character escape sequence
+  \oq (opening quote) is now rendered as code point 0x27 (apostrophe)
+  instead of 0x60 (grave accent).  The ISO 8859/ECMA-94 Latin character
+  sets do not define any glyphs for directional ("typographer's")
+  quotation marks, but the apostrophe is depicted in the defining
+  standard as a neutral (vertical) glyph, whereas the grave accent 0x60
+  and acute accent 0xB4 are mirror-symmetric diacritical marks.
+
+  This change has no effect on _input_ conventions for roff source
+  documents.  You can still get directional single quotes on UTF-8,
+  PostScript, PDF, and other output devices supporting them by typing
+  sequences like `this' in the input (character remapping with 'char'
+  requests and similar notwithstanding).
+
+gropdf
+------
+
+o A new device control command, "background", enables boxes to be drawn
+  underneath other page content.  The boxes can be shaded with colors,
+  drawn with a colored border of configurable thickness, and interrupted
+  by page breaks with special support for breaking before footnotes and
+  similar material.  For convenience, "pdf.tmac" exposes a new macro,
+  `pdfbackground`.  Thanks to Deri James.
+
+grotty
+------
+
+o The "utf8" output device now maps the input characters '^' (caret,
+  circumflex accent, or "hat") and '~' (tilde) to U+02C6 (modifier
+  letter circumflex accent) and U+02DC (small tilde), respectively, for
+  consistency with groff's other output devices.  This change is
+  expected to expose glyph usage errors in man pages.  See the
+  "PROBLEMS" file for a recipe that will conceal these errors.  A better
+  long-term approach is for man pages to adopt correct input practices;
+  the man pages groff_man_style(7), groff_char(7), and man-pages(7)
+  (subsection "Generating optimal glyphs"; from the Linux man-pages
+  project) contain such instructions.  Doing so also improves man page
+  typography when formatting for PDF.
+
+  If you maintain a generator of man(7) or mdoc(7) documents (such as a
+  tool that converts other formats to them), and need assistance, please
+  contact the groff@gnu.org mailing list and describe your situation.
+
+o A new device control command, "link", generates OSC 8 hyperlinks.
+  This means that groff documents can produce clickable links in the
+  terminal window for emulators that support such escape sequences.
+
+o The "sgr" device control command, which dynamically configured support
+  for ISO 6429/ECMA-48 SGR escape sequences (and restored traditional
+  overstriking behavior if disabled), has been removed.  It took effect
+  only at page boundaries.  grotty's "-c" command-line option and the
+  GROFF_NO_SGR environment variable remain supported.
+
+Documentation
+-------------
+
+o groff's Texinfo manual is included in the distribution archive in
+  several formats, including GNU Info, HTML, TeX DVI, PDF, and plain
+  text.  Many sections have been extensively revised and corrected, and
+  much material added to help the learner acquire the groff formatting
+  language (see, for instance, the section/node "Text").
+
+o A compilation of all of groff's man pages in PDF and UTF-8-encoded
+  text (with SGR escape sequences) is produced by the build.  Many of
+  the documents in this 380+-page document have been heavily revised or
+  rewritten, including tbl(1), groff(1), groff_diff(7), groff_font(5),
+  groff(7), groff_char(7), and roff(7).  The PDF version uses pdfmark
+  extensions to produce an internal bookmark for every man page
+  document, section heading, and subsection heading.
+
+o Larry Kollar's "Using groff with the ms Macro Package" has been
+  resurrected after 20+ years, revised, and updated.
+
+o Eric Allman's "me Reference Manual" has been revised in detail.
+
+Miscellaneous
+-------------
+
+o Because all generated forms of groff's Texinfo manual are now included
+  in the distribution archive, building from that archive no longer
+  depends on GNU Texinfo or a TeX installation (the latter was required
+  only for the "doc" target, which had to be explicitly named).
+
+o Building groff from its distribution archive no longer requires byacc
+  (or GNU Bison) to be installed.
+
+o m4 is now required to build.  Any m4 that implements the features
+  documented in the Version 7 Unix m4(1) man page, and the `-D` option,
+  should suffice.
+
+o New 'configure' options '--{en,dis}able-groff-allocator' control
+  whether groff uses its own malloc/free-wrapping allocator to implement
+  all C++ new/delete operations.  groff has used this allocator for over
+  30 years; C++ implementations are more mature now.  The default is now
+  to rely on C++ language runtime support for new/delete.  When building
+  groff, use
+    configure --enable-groff-allocator
+  to re-enable groff's traditional allocator.
+
+o The 'configure' option '--with-appresdir' has been renamed to
+  '--with-appdefdir'.
+
+o Italian language input documents are now supported, including
+  hyphenation patterns from the hyph-utf8 project and localized strings
+  for the ms, me, mm, and mom packages.  Thanks to Edmond Orignac.
+
+o Manual section titles for man pages (those that appear by default in
+  the page header, like "General Commands Manual") are now localized for
+  Czech, German, French, Italian, and Swedish.
+
+o The semantics of the environment variable SOURCE_DATE_EPOCH to groff,
+  support for which was added in 1.22.4, were not established at that
+  time with respect to time zone selection, prompting divergent
+  interpretations; Debian and distributions derived from it have for
+  several years patched groff to implicitly use UTC as the time zone
+  when interpreting the current time (or SOURCE_DATE_EPOCH) as a local
+  time.  While a convenient and defensible choice for reproducible build
+  efforts, it runs against the grain of user expectations.  Systems
+  programmers like time zone-invariant, monotonically increasing clocks;
+  the broader user base usually prefers a clock that follows an
+  applicable civil calendar.  groff programs now reckon
+  SOURCE_DATE_EPOCH with respect to the local time zone.  Users of
+  SOURCE_DATE_EPOCH may wish to also set the TZ environment variable.
+
+o xtotroff now supports a "-d" option to specify the directory in which
+  to generate font description files.
+
+o The 'configure' option '--with-doc' that was introduced in version
+  1.22.3 has been deleted again.  Its basic idea was misguided because
+  each of the documents is only available in a subset of the output
+  formats, so in contrast to the documentation, the option not only
+  affected which output formats were generated, but also restricted the
+  documentation content the user would get in erratic and surprising
+  ways.  The option was also ill-designed insofar as the "examples"
+  keyword did not represent an output format.  Some example files were
+  controlled by the "examples" keyword alone, some by the respective
+  format keywords alone, and some by a combination of both.  The
+  implementation of the option was full of bugs, but few, if any, of
+  these bugs were ever reported by users, giving the impression that
+  few, if any, users ever attempted to use the option, and those who did
+  likely remained unaware that doing so deprived them of parts of the
+  content of the documentation.  Experience has demonstrated that
+  properly maintaining and testing the option exceeds the amount of
+  effort the GNU troff team is able to invest.  Finally, GNU standards
+  contain no recommendation to support this option, and indeed, few, if
+  any, GNU packages apart from groff support it.
+
+o The 'doc' Make target has been eliminated.  'all' (the default Make
+  target) assumes responsibility for generating the groff Texinfo manual
+  in all formats supported by the build host.  This change is only
+  significant when building from a Git checkout or if our Texinfo
+  manual's sources are modified; the distribution archive now provides
+  copies of the manual in Info, plain text, HTML, DVI, and PDF.
+
+o afmtodit no longer writes file names with directory information in
+  them to the "name" directives of the font descriptions it generates.
+  (The `fp` request no longer accepts such names; see "troff" above.)
+
+o afmtodit now exits with status 2 (not 1) upon usage errors.
+
+o afmtodit now recognizes a '-w' option to specify the generated font
+  description's "spacewidth" parameter (see groff_font(5)).  The
+  internal library "libgroff" now emits a diagnostic if a font
+  description file is missing such a directive.  Adding this option
+  enables a well-formed font description to be produced by the tool
+  (without requiring editing by hand).
+
+o pfbtops now exits with status 2 upon usage errors and the standard C
+  library's `EXIT_FAILURE` status (usually 1) on operational failures
+  instead of vice versa.
+
+o groffer has been deleted from the distribution.
+
+o grog no longer supports the "--warnings" option; the one diagnostic
+  message that it enabled has been removed.
+
+o The ditroff(7) man page has been deleted.  The "History" section of
+  roff(7) covers the same subject in greater depth.
+
+o The groff_filenames(5) man page has been deleted.  It had inaccuracies
+  and spurious content.  The "File name conventions" section of roff(7)
+  covers the same subject.
+
+o The lj4_font(5) man page has been deleted.  Its content has moved into
+  the "Fonts" subsection of grolj4(1).
 
 
 VERSION 1.22.4
@@ -14,38 +695,36 @@
 Troff
 -----
 
-o The `hy' request has been extended.  Value 16 enables hyphenation before
-  the last character, and value 32 enables hyphenation after the first
-  character.
-
+o The `hy' request has been extended.  Value 16 enables hyphenation
+  before the last character, and value 32 enables hyphenation after the
+  first character.
 
 PDFPIC
 ------
 
-o PDFPIC has been corrected so the behaviour is the same whether you use the
-  PostScript or PDF drivers.  However, this means that any documents which
-  were written using the old behaviour will not be rendered correctly if
-  using the PDF driver with the new version.
+o PDFPIC has been corrected so the behaviour is the same whether you use
+  the PostScript or PDF drivers.  However, this means that any documents
+  which were written using the old behaviour will not be rendered
+  correctly if using the PDF driver with the new version.
 
   The change would mean that documents which relied on the previous
   behaviour are likely to have a gap underneath the image which was not
-  there before.  If you see this effect there are three ways you can restore
-  the previous behaviour:
+  there before.  If you see this effect there are three ways you can
+  restore the previous behaviour:
 
-  Add the line ".nr PDFPIC_NOSPACE 1" to the document before the first call
-  to .PDFPIC.
+  Add the line ".nr PDFPIC_NOSPACE 1" to the document before the first
+  call to .PDFPIC.
 
-  If it is just a single document which exhibits this behaviour you can run
-  groff adding "-rPDFPIC_NOSPACE=1" to the command line.
+  If it is just a single document which exhibits this behaviour you can
+  run groff adding "-rPDFPIC_NOSPACE=1" to the command line.
 
-  If you have many documents which rely on the previous behaviour you can
-  set an environment variable "export GROFF_PDFPIC_NOSPACE=1" which will
-  restore the previous behaviour for all runs.
+  If you have many documents which rely on the previous behaviour you
+  can set an environment variable "export GROFF_PDFPIC_NOSPACE=1" which
+  will restore the previous behaviour for all runs.
 
-  Note that this change has no effect if you were using .PDFPIC with the
+  This change has no effect if you were using .PDFPIC with the
   PostScript driver--only if you used it with the PDF driver.
 
-
 Gropdf
 ------
 
@@ -54,37 +733,37 @@
 o Handling of glyphs above position 255 is improved to allow many more
   glyphs to be used.
 
-o New macros .pdftransition and .pdfpause are introduced to allow creation
-  of presentation slides.  Partially backward-compatible with present.tmac,
-  specifically the PAUSE, BLOCKS and BLOCKE commands.  Supports all the
-  transition types introduced in PDF v1.5 (see the gropdf man page).
-
+o New macros .pdftransition and .pdfpause are introduced to allow
+  creation of presentation slides.  Partially backward-compatible with
+  present.tmac, specifically the PAUSE, BLOCKS and BLOCKE commands.
+  Supports all the transition types introduced in PDF v1.5 (see the
+  gropdf man page).
 
 Miscellaneous
 -------------
 
-o A new 'configure' option --with-compatibility-wrappers controls how groff
-  compatibility wrappers for vendor-provided non-GNU macro sets are
-  installed (see ./configure --help).
+o A new 'configure' option --with-compatibility-wrappers controls how
+  groff compatibility wrappers for vendor-provided non-GNU macro sets
+  are installed (see ./configure --help).
 
 o eqn2graph, grap2graph, and pic2graph now attempt to adapt to very old
   installed versions of the ImageMagick and GraphicsMagick programs
-  "convert".  They search the output of convert's "-help" option, and use
-  "-trim" if that string is found; otherwise, the old "-crop 0x0" method
-  (which produces incompatible results on versions that _do_ support
-  "-trim") is used.  The programs emit a warning to standard error if the
-  search fails and the old method is used.
+  "convert".  They search the output of convert's "-help" option, and
+  use "-trim" if that string is found; otherwise, the old "-crop 0x0"
+  method (which produces incompatible results on versions that _do_
+  support "-trim") is used.  The programs emit a warning to standard
+  error if the search fails and the old method is used.
 
 o eqn2graph no longer supports the "-unsafe" option.  It did nothing.
 
 o groffer now supports the output of XHTML.  Use the "--xhtml" or
   "--mode=xhtml" command-line options to generate it.
 
-o Much work has been done, and is ongoing, to make groff's man pages better
-  examples for man page writers to follow.  groff_man(7) itself has been
-  expanded and largely rewritten to more precisely document the macro
-  package's behavior and to be more helpful and accessible to man page
-  writers who may never read any other groff documentation.
+o Much work has been done, and is ongoing, to make groff's man pages
+  better examples for man page writers to follow.  groff_man(7) itself
+  has been expanded and largely rewritten to more precisely document the
+  macro package's behavior and to be more helpful and accessible to man
+  page writers who may never read any other groff documentation.
 
 
 VERSION 1.22.3
@@ -108,57 +787,53 @@
   Note that if the option `--with-appresdir' is passed to `configure',
   the `prefix' will not be added to `appresdir'.
 
-
 Glilypond
 ---------
 
-o This new preprocessor (contributed by Bernd Warken) allows embedding of
-  code for GNU LilyPond (http://www.lilypond.org), a music typesetter.  The
-  data gets automatically processed and embedded as EPS images.
-
+o This new preprocessor (contributed by Bernd Warken) allows embedding
+  of code for GNU LilyPond (http://www.lilypond.org), a music
+  typesetter.  The data gets automatically processed and embedded as EPS
+  images.
 
 Gperl
 -----
 
-o Bernd Warken contributed a new preprocessor to handle Perl code that can
-  be evaluated and then processed by groff.
-
+o Bernd Warken contributed a new preprocessor to handle Perl code that
+  can be evaluated and then processed by groff.
 
 Gpinyin
 -------
 
-o Another preprocessor from Bernd Warken to pretty-print Pinyin syllables
-  like `guo2wang2' as `guówáng'.
-
+o Another preprocessor from Bernd Warken to pretty-print Pinyin
+  syllables like `guo2wang2' as `guówáng'.
 
 Pdfroff
 -------
 
-o The pdfroff utility script now activates its `--no-toc-relocation' option
-  by default, unless a request similar to:
+o The pdfroff utility script now activates its `--no-toc-relocation'
+  option by default, unless a request similar to:
 
      .if !\nPHASE .tm pdfroff-option:set toc_relocation=enabled
 
   is invoked during input file processing; (`.if !\nPHASE ...' ensures
-  that the effect of the `.tm' request is restricted to the document setup
-  phase of processing, as pdfroff sets it to 1 or 2 in the output phase,
-  but leaves it unset in the setup phase).
+  that the effect of the `.tm' request is restricted to the document
+  setup phase of processing, as pdfroff sets it to 1 or 2 in the output
+  phase, but leaves it unset in the setup phase).
 
   The bundled `spdf.tmac' macro package, which implicitly activates
   `-mpdfmark' for `ms' macro users, ensures that TOC relocation is
   appropriately enabled, when the `.TC' macro is invoked.
 
-
 Macro Packages
 --------------
 
-o New default values for hyphenation.  The previous values were too strict,
-  suppressing some hyphenation points unnecessarily.
+o New default values for hyphenation.  The previous values were too
+  strict, suppressing some hyphenation points unnecessarily.
 
-o The -mom macro package now has full support for eqn, pic, and tbl, as well
-  as captioning and labelling of PDF images and preprocessor output.  Lists
-  of Figures, Equations, and Tables can now be autogenerated.  PDF_IMAGE has
-  a new FRAME option.
+o The -mom macro package now has full support for eqn, pic, and tbl, as
+  well as captioning and labelling of PDF images and preprocessor
+  output.  Lists of Figures, Equations, and Tables can now be
+  autogenerated.  PDF_IMAGE has a new FRAME option.
 
 o A French introduction to the -me macro package has been added (file
   `meintro_fr.me').
@@ -175,7 +850,6 @@
 
 o The character `#' can now be used as an eqn delimiter within tables.
 
-
 Eqn
 ---
 
@@ -219,17 +893,19 @@
 
 o The -mom macro package has reached version 2.0, focusing on PDF output
   with gropdf (using the new `pdfmom' wrapper script).  See the file
-  `version-2.html' of the -mom documentation for a list of the many changes.
+  `version-2.html' of the -mom documentation for a list of the many
+  changes.
 
-o Some generic Unicode fallback characters (mainly Roman numerals) have been
-  added.
+o Some generic Unicode fallback characters (mainly Roman numerals) have
+  been added.
 
 Gropdf
 ------
 
-o A new driver for generating PDF output directly, contributed by Deri James
-  <deri@chuzzlewit.myzen.co.uk>.  Note that this driver is written in Perl,
-  thus you need a working Perl installation to run this output device.
+o A new driver for generating PDF output directly, contributed by Deri
+  James <deri@chuzzlewit.myzen.co.uk>.  Note that this driver is written
+  in Perl, thus you need a working Perl installation to run this output
+  device.
 
 Pdfmom
 ------
@@ -244,18 +920,19 @@
 Troff
 -----
 
-o The new `lsm' request specifies a macro to be invoked when leading spaces
-  in an input line are encountered (which are removed then).  Number
-  registers `lsn' and `lss' hold the number of removed leading spaces and
-  the corresponding horizontal space, respectively.
+o The new `lsm' request specifies a macro to be invoked when leading
+  spaces in an input line are encountered (which are removed then).
+  Number registers `lsn' and `lss' hold the number of removed leading
+  spaces and the corresponding horizontal space, respectively.
 
 o There is a new warning category `file', enabled by default.  The `mso'
-  request emits warnings in this category when the requested macro file does
-  not exist.
+  request emits warnings in this category when the requested macro file
+  does not exist.
 
 o The new `class' request assigns a short name to a set of characters
   which can be referred to in the `cflags' request.  This is especially
-  useful to control line-breaking and hyphenation rules in CJK languages.
+  useful to control line-breaking and hyphenation rules in CJK
+  languages.
 
 o Three new values for the `cflags' request have been added, which are
   needed for proper CJK support.
@@ -267,8 +944,8 @@
 Tbl
 ---
 
-o A new global option `nowarn' suppresses warnings if tables are longer than
-  the current line width.
+o A new global option `nowarn' suppresses warnings if tables are longer
+  than the current line width.
 
 Afmtodit
 --------
@@ -281,12 +958,12 @@
 o A new macro `%U' has been added to the mdoc package to indicate a URL
   reference within an .Rs/.Re environment.
 
-o Rudimentary support for the Japanese script has been added, most suitable
-  for man page handling as output by grotty.  The file `ja.tmac' contains
-  the necessary setup to allow line breaks before and after CJK characters
-  (with proper exceptions).  Note, however, that no inter-character spacing
-  is implemented yet -- this usually causes many warnings about bad line
-  breaks.
+o Rudimentary support for the Japanese script has been added, most
+  suitable for man page handling as output by grotty.  The file
+  `ja.tmac' contains the necessary setup to allow line breaks before and
+  after CJK characters (with proper exceptions).  Note, however, that no
+  inter-character spacing is implemented yet -- this usually causes many
+  warnings about bad line breaks.
 
 
 VERSION 1.20.1
@@ -303,18 +980,18 @@
 -----
 
 o XHTML support has been added to grohtml and can be specified by
-  -Txhtml.  This option also utilizes the MathML capability of
-  eqn and combines the outputs of both in the final XHTML file.
-  Users can also specify the `-P-V' option together with `-Txhtml'
-  in groff.  This has the effect of creating an XHTML validator
-  button at the bottom of each page.
+  -Txhtml.  This option also utilizes the MathML capability of eqn and
+  combines the outputs of both in the final XHTML file.  Users can also
+  specify the `-P-V' option together with `-Txhtml' in groff.  This has
+  the effect of creating an XHTML validator button at the bottom of each
+  page.
 
 o Some options have been added to control a new preprocessor,
   `preconv' (see below): `-k' activates it, `-K' sets the input
   encoding, and `-D' sets the default encoding.
 
-o A new environment variable `GROFF_ENCODING' sets the encoding
-  of input files; it implies command option `-k'.
+o A new environment variable `GROFF_ENCODING' sets the encoding of input
+  files; it implies command option `-k'.
 
 Troff
 -----
@@ -323,8 +1000,8 @@
   equivalents to the \X and \Y escapes, respectively.
 
 o A new read-only number register `.br' is available which is set to 1
-  if a macro is called as .foo and to 0 if called as 'foo.  This allows to
-  reliably modify requests.
+  if a macro is called as .foo and to 0 if called as 'foo.  This allows
+  to reliably modify requests.
 
     .als bp@orig bp
     .de bp
@@ -344,30 +1021,31 @@
     .ps 12
     Palatino and \fCRCourier\f
 
-  The new number register `.zoom' holds the zoom value of the current font,
-  in multiples of 1/1000th.
+  The new number register `.zoom' holds the zoom value of the current
+  font, in multiples of 1/1000th.
 
 o The `cflags' request has been extended with a new flag value 64, to be
-  used in combination with values 2 (break before character) and 4 (break
-  after character).  If set, the hyphenation codes of the surrounding
-  characters are ignored.
-
-o A new debugging request, `pev', has been added to print all of the current
-  known environments to stderr.  It first prints the state of the current
-  environment, then iterates through all of the known environments, printing
-  each except the one that is current.
+  used in combination with values 2 (break before character) and 4
+  (break after character).  If set, the hyphenation codes of the
+  surrounding characters are ignored.
+
+o A new debugging request, `pev', has been added to print all of the
+  current known environments to stderr.  It first prints the state of
+  the current environment, then iterates through all of the known
+  environments, printing each except the one that is current.
 
 o A new escape `\$^' has been added.  It represents the parameters of a
-  macro as if they were an argument to the `ds' request.  This is used by
-  `trace.tmac'.
+  macro as if they were an argument to the `ds' request.  This is used
+  by `trace.tmac'.
 
 o A new read-only number register `.O' is available which returns the
   current suppression level as set by the `\O' escape.
 
 o The space width emitted by the `\|' and `\^' escape sequences can be
-  controlled on a per-font basis.  If there is a glyph named `\|' or `\^',
-  respectively (note the leading backslash), defined in the current font
-  file, use this glyph's width instead of the default value.
+  controlled on a per-font basis.  If there is a glyph named `\|' or
+  `\^', respectively (note the leading backslash), defined in the
+  current font file, use this glyph's width instead of the default
+  value.
 
   This behaviour is not new, but hasn't been documented before.
 
@@ -380,35 +1058,35 @@
 Preconv
 -------
 
-o This is a new preprocessor to convert various input encodings to something
-  groff understands (this is, ASCII and \uXXXX entities, with `XXXX' a
-  hexadecimal number with 4 to 6 digits, representing a Unicode input code).
-  Normally, preconv should be invoked with options `-k' and `-K' of groff.
-  See the preconv man page for details.
+o This is a new preprocessor to convert various input encodings to
+  something groff understands (this is, ASCII and \uXXXX entities,
+  with `XXXX' a hexadecimal number with 4 to 6 digits, representing a
+  Unicode input code).  Normally, preconv should be invoked with options
+  `-k' and `-K' of groff.  See the preconv man page for details.
 
 Pic
 ---
 
-o int(x) now really behaves as documented: It truncates the non-integer part
-  of x, this is, it rounds towards zero and not towards the next integer
-  less than or equal to x.
+o int(x) now really behaves as documented: It truncates the non-integer
+  part of x, this is, it rounds towards zero and not towards the next
+  integer less than or equal to x.
 
 o Pic now supports up to 32 macro arguments (and up to 16 on EBCDIC
   platforms).
 
-o Heinz-Jürgen Örtel contributed code for two new keywords, `xslanted' and
-  `yslanted', which can change the shape of boxes into arbitrary
+o Heinz-Jürgen Örtel contributed code for two new keywords, `xslanted'
+  and `yslanted', which can change the shape of boxes into arbitrary
   parallelograms.
 
 Tbl
 ---
 
-o Latest versions of DWB tbl introduced an `x' column specifier for a single
-  column expanded to the line width.  GNU tbl has now been extended to
-  support even multiple `x' specifiers within a table.
+o Latest versions of DWB tbl introduced an `x' column specifier for a
+  single column expanded to the line width.  GNU tbl has now been
+  extended to support even multiple `x' specifiers within a table.
 
-o To avoid collision with the new `x' specifier, a block formatting macro
-  must now be selected with specifier letter `m'.
+o To avoid collision with the new `x' specifier, a block formatting
+  macro must now be selected with specifier letter `m'.
 
 Eqn
 ---
@@ -420,25 +1098,25 @@
 Chem
 ----
 
-o The preprocessor `chem' was added.  `chem' is a roff language to generate
-  chemical structure diagrams.  It generates `pic' output.
+o The preprocessor `chem' was added.  `chem' is a roff language to
+  generate chemical structure diagrams.  It generates `pic' output.
 
 Grops
 -----
 
-o The PS font definition files have been regenerated with newer AFM versions
-  from Adobe's 35 core fonts as present in most Level 2 PS printers.  The
-  changes are minor (most notably, the addition of the `Euro' glyph and an
-  extended set of kerning values).
+o The PS font definition files have been regenerated with newer AFM
+  versions from Adobe's 35 core fonts as present in most Level 2 PS
+  printers.  The changes are minor (most notably, the addition of the
+  `Euro' glyph and an extended set of kerning values).
 
-  For backwards compatibility, the old set of font definition files is still
-  available; for details please read the man page of grops.
+  For backwards compatibility, the old set of font definition files is
+  still available; for details please read the man page of grops.
 
 Grotty
 ------
 
-o \D'p...' is now supported if the polygon consists entirely of horizontal
-   and vertical lines.
+o \D'p...' is now supported if the polygon consists entirely of
+  horizontal and vertical lines.
 
 Grohtml
 -------
@@ -448,8 +1126,9 @@
 o New command line option `-V' (to be used in XHTML mode) to produce an
   XHTML validator button.
 
-o New command line option `-y' to produce a right-justified groff signature
-  at the end of the document (in combination with option `-V').
+o New command line option `-y' to produce a right-justified groff
+  signature at the end of the document (in combination with option
+  `-V').
 
 Gxditview
 ---------
@@ -476,8 +1155,8 @@
 Macro Packages
 --------------
 
-o Joachim Walsdorff contributed the `hdtbl' package for the generation of
-  tables, using a syntax very similar to the HTML table model.  For
+o Joachim Walsdorff contributed the `hdtbl' package for the generation
+  of tables, using a syntax very similar to the HTML table model.  For
   example, a table with two cells and two rows looks like this:
 
     .TBL cols=2
@@ -501,17 +1180,19 @@
 
   This package currently works with `-Tps' only.
 
-o -mandoc now supports multiple man pages (in either man or mdoc format).
+o -mandoc now supports multiple man pages (in either man or mdoc
+  format).
 
 o Fabrice Ménard contributed locales support.  In particular, it is now
-  possible to get French localization of the main macro packages (-ms, -mm,
-  -me, and -mom, but not -man and -mdoc which are localized differently) by
-  appending `-mfr' to the list of macro packages.  Example:
+  possible to get French localization of the main macro packages (-ms,
+  -mm, -me, and -mom, but not -man and -mdoc which are localized
+  differently) by appending `-mfr' to the list of macro packages.
+  Example:
 
     groff -ms -mfr foo > foo.ps
 
-  Note that latin-9 input encoding is used for French (to support the `oe'
-  ligature).
+  Note that latin-9 input encoding is used for French (to support the
+  `oe' ligature).
 
 o Swedish macro localization (with `-msv') has been added.
 
@@ -522,33 +1203,34 @@
 
   Note that latin-2 input encoding is used for Czech.
 
-o A new macro `Dx' has been added to the mdoc package which identifies the
-  DragonFly OS.
+o A new macro `Dx' has been added to the mdoc package which identifies
+  the DragonFly OS.
 
 o If mdoc is used to print multiple man pages (together with the -rcR=0
   command line option), each man page now starts a new page.
 
 o -mtrace has been considerably improved, now showing number and string
-  register assignments, among other things.  See the groff_trace man page
-  for details.
+  register assignments, among other things.  See the groff_trace man
+  page for details.
 
 o The PSPIC macro now works with all devices (producing a hollow
   rectangle on devices which don't support inclusion of PS images) and
   is loaded in troffrc at start-up.
 
-o A new auxiliary macro package `62bit' has been added which provides some
-  macros for adding, multiplying, and dividing signed 62bit integers (mainly
-  to handle normal groff number operations without risking overflow errors).
+o A new auxiliary macro package `62bit' has been added which provides
+  some macros for adding, multiplying, and dividing signed 62bit
+  integers (mainly to handle normal groff number operations without
+  risking overflow errors).
 
 o For -ms, Eric S. Raymond contributed support for ancient Bell Labs
-  localisms `.SC', `.UC', `.P1', and `.P2'.  The latter three are enabled
-  only after .SC is called.
+  localisms `.SC', `.UC', `.P1', and `.P2'.  The latter three are
+  enabled only after .SC is called.
 
 o A new string, `SN-STYLE', has been added to the ms macros, controlling
   the formatting of section numbers in headings defined by `.NH'.
 
-o The new macro package `ptx' provides a template definition for the `.xx'
-  macro as needed by GNU ptx (for creating permuted indices).
+o The new macro package `ptx' provides a template definition for the
+  `.xx' macro as needed by GNU ptx (for creating permuted indices).
 
 
 VERSION 1.19.2
@@ -564,9 +1246,9 @@
 o A new read-only, string-valued register `.sty' returns the name of the
   current style.
 
-o Two new conditional operators `F <name>' and `S <name>' have been added.
-  `F' is true if a font <name> exists.  `S' is true if a style <name> has
-  been registered.
+o Two new conditional operators `F <name>' and `S <name>' have been
+  added.  `F' is true if a font <name> exists.  `S' is true if a style
+  <name> has been registered.
 
 o Cyrillic characters have been added to the `utf8' and `html' output
   devices.
@@ -574,23 +1256,25 @@
 Pic
 ---
 
-o The `by' argument in a `for' loop can now be negative if it is additive.
-  For the multiplicative case, it must be greater than zero.
+o The `by' argument in a `for' loop can now be negative if it is
+  additive.  For the multiplicative case, it must be greater than zero.
 
 Eqn
 ---
 
-o The following keywords aren't new but haven't been documented previously:
+o The following keywords aren't new but haven't been documented
+  previously:
 
     undef NAME    (to undefine a macro)
     copy  "FILE"  (a synonym for `include')
     space n       (to modify the vertical spacing before and after
                    an equation)
 
-o The following macros aren't new but haven't been documented previously:
+o The following macros aren't new but haven't been documented
+  previously:
 
     Alpha, ..., Omega   (the same as `ALPHA', ..., `OMEGA')
-    ldots               (three dots on the base line)
+    ldots               (three dots on the baseline)
     dollar              (a dollar glyph)
 
 o The following keywords have been extended.  Again, this isn't new but
@@ -608,8 +1292,8 @@
 Grohtml
 -------
 
-o This device driver has been raised to beta stage; its set of tags should
-  be stable now.
+o This device driver has been raised to beta stage; its set of tags
+  should be stable now.
 
 o New command line option `-s' to set the base point size.
 
@@ -624,14 +1308,14 @@
 Gxditview
 ---------
 
-o On platforms which have the X Window System this program is now built and
-  installed automatically.
+o On platforms which have the X Window System this program is now built
+  and installed automatically.
 
 Xtotroff
 --------
 
-o This program to create font definition files for xditview isn't new but
-  hasn't been installed previously.
+o This program to create font definition files for xditview isn't new
+  but hasn't been installed previously.
 
 Groffer
 -------
@@ -641,41 +1325,43 @@
 Gdiffmk
 -------
 
-o A new script contributed by Mike Bianchi.  It compares two groff, nroff,
-  or troff documents and creates an output with added margin characters
-  (using `.mc') to indicate the differences.
+o A new script contributed by Mike Bianchi.  It compares two groff,
+  nroff, or troff documents and creates an output with added margin
+  characters (using `.mc') to indicate the differences.
 
 Pdfroff
 -------
 
-o A new wrapper script contributed by Keith Marshall to easily create PDF
-  documents with groff.
+o A new wrapper script contributed by Keith Marshall to easily create
+  PDF documents with groff.
 
 Macro packages
 --------------
 
 o ms.tmac
 
-  . Support for fractional point sizes: A value for the `PS', `VS', `FPS',
-    and `VPS' register larger than or equal to 1000 is always divided by
-    1000.  For example, `.nr PS 10250' sets the document's font size to
-    10.25 points.
-
-  . The `Ds' and `De' macros provided in ms since groff version 1.19 have
-    been removed; the equivalent `DS' and `DE' macros should be used
-    instead.  X11 documents which actually use `Ds' and `De' always load a
-    specific macro file from the X11 distribution (`macros.t') which
-    provides proper definitions for the two macros.
+  . Support for fractional point sizes: A value for the `PS', `VS',
+    `FPS', and `VPS' register larger than or equal to 1000 is always
+    divided by 1000.  For example, `.nr PS 10250' sets the document's
+    font size to 10.25 points.
+
+  . The `Ds' and `De' macros provided in ms since groff version 1.19
+    have been removed; the equivalent `DS' and `DE' macros should be
+    used instead.  X11 documents which actually use `Ds' and `De' always
+    load a specific macro file from the X11 distribution (`macros.t')
+    which provides proper definitions for the two macros.
 
-  . The following registers have been added for improving layout control:
+  . The following registers have been added for improving layout
+    control:
 
     PORPHANS
-      Defines number of lines following `LP', `PP', `QP', `IP' or `XP' which
-      must be kept together, before any automatic page break.
+      Defines number of lines following `LP', `PP', `QP', `IP' or `XP'
+      which must be kept together, before any automatic page break.
 
     HORPHANS
-      Sets number of lines of following paragraph which must be kept with a
-      heading, defined by `NH' or `SH', before any automatic page break.
+      Sets number of lines of following paragraph which must be kept
+      with a heading, defined by `NH' or `SH', before any automatic page
+      break.
 
     GROWPS
       Sets the first level of heading (set with `NH') which keeps the
@@ -689,8 +1375,8 @@
       levels remain at 10pt (because \nPS = 10).
 
   . The `SH' macro now accepts a numeric argument, to make heading size
-    match that of `NH' with same argument value when the `GROWPS'/`PSINCR'
-    feature is enabled.
+    match that of `NH' with same argument value when the
+    `GROWPS'/`PSINCR' feature is enabled.
 
   Please refer to the documentation of the ms package for other, minor
   improvements.
@@ -721,9 +1407,9 @@
 -------------
 
 o Two new keywords to the DESC file have been added which are needed for
-  grohtml: `image_generator' and `unscaled_charwidths'.  The former gives
-  the name of the program which creates PNG images, and the latter makes
-  troff always use unscaled character widths.
+  grohtml: `image_generator' and `unscaled_charwidths'.  The former
+  gives the name of the program which creates PNG images, and the latter
+  makes troff always use unscaled character widths.
 
 
 VERSION 1.19.1
@@ -732,10 +1418,10 @@
 Groff
 -----
 
-o The argument of the command line option `-I' is now also passed to troff
-  and grops, specifying a directory to search for files on the command line,
-  files named in `so' and `psbb' requests, and files named in \X'ps: file'
-  and \X'ps: import' escapes.
+o The argument of the command line option `-I' is now also passed to
+  troff and grops, specifying a directory to search for files on the
+  command line, files named in `so' and `psbb' requests, and files named
+  in \X'ps: file' and \X'ps: import' escapes.
 
 o If option `-V' is used more than once, the commands are both printed
   on standard error and run.
@@ -746,33 +1432,34 @@
 o Two new read-only, string-valued registers `.m' and `.M' return the
   name of the current drawing and background color, respectively.
 
-o New read-only register `.U' which is set to 1 if in safer mode and set
-  to 0 if in unsafe mode.
+o New read-only register `.U' which is set to 1 if in unsafe mode, and 0
+  otherwise.
 
 o An input encoding file for latin-5 (a.k.a. ISO 8859-9) has been added.
   Example use:
 
     groff -Tdvi -mlatin5 my_file > my_file.dvi
 
-  Note that some output devices don't support all glyphs of this encoding.
+  Note that some output devices don't support all glyphs of this
+  encoding.
 
 o If the `return' request is called with an argument, it exits twice,
-  namely the current macro and the macro one level higher.  This is
-  used to define a wrapper macro for `return' in trace.tmac.
+  namely the current macro and the macro one level higher.  This is used
+  to define a wrapper macro for `return' in trace.tmac.
 
 o For completeness, two new requests have been added: `dei1' and `ami1'.
   They are equivalent to `dei' and `ami', respectively, but the macros
   are executed with compatibility mode off (similar to `de1' and `am1').
 
 o New command line option `-I' to specify a directory for files (both
-  those on the command line and those named in `psbb' requests).  This is
-  also handled by the groff wrapper program.
+  those on the command line and those named in `psbb' requests).  This
+  is also handled by the groff wrapper program.
 
 o Since version 1.19 you can say `.vs 0'.  Older versions emit a warning
   and convert this to `.vs \n.V'.
 
-  This hasn't been documented properly.  Note that `.vs 0' isn't saved in a
-  diversion since it doesn't result in vertical motion.
+  This hasn't been documented properly.  Note that `.vs 0' isn't saved
+  in a diversion since it doesn't result in vertical motion.
 
 Pic
 ---
@@ -789,10 +1476,10 @@
 ----------
 
 o A new script contributed by Eric S. Raymond <esr@thyrsus.com>.  It
-  converts a grap diagram into a cropped image.  Since it uses gs and the
-  PNM library, virtually all graphics formats are available for output.
-  Note that the grap program itself isn't part of the groff package;
-  see the file MORE.STUFF how to obtain grap.
+  converts a grap diagram into a cropped image.  Since it uses gs and
+  the PNM library, virtually all graphics formats are available for
+  output.  Note that the grap program itself isn't part of the groff
+  package; see the file MORE.STUFF how to obtain grap.
 
 Grohtml
 -------
@@ -802,9 +1489,9 @@
 Grops
 -----
 
-o New command line option `-I' to specify a directory to search for files
-  on the command line and files named in \X'ps: import' and \X'ps: file'
-  escapes.  This is also handled by the groff wrapper program.
+o New command line option `-I' to specify a directory to search for
+  files on the command line and files named in \X'ps: import' and \X'ps:
+  file' escapes.  This is also handled by the groff wrapper program.
 
 o The default value for the `broken' keyword in the DESC file is now 0.
 
@@ -814,11 +1501,11 @@
 o A new man page `lj4_font(5)' documents how fonts are accessed with
   grolj4.
 
-o The built-in fonts for LJ4 and newer PCL 5 devices have been completely
-  revised, mainly to access as much glyphs as possible.  The provided
-  metric files should be compatible with recent PCL 5 printers also.
-  Additionally, font description files have been added for the Arial and
-  Times New Roman family, the MS symbol, and Wingdings fonts.
+o The built-in fonts for LJ4 and newer PCL 5 devices have been
+  completely revised, mainly to access as much glyphs as possible.  The
+  provided metric files should be compatible with recent PCL 5 printers
+  also.  Additionally, font description files have been added for the
+  Arial and Times New Roman family, the MS symbol, and Wingdings fonts.
 
 Afmtodit
 --------
@@ -865,18 +1552,18 @@
 
     groff -Tdvi -mlatin9 my_file > my_file.dvi
 
-  You still need proper fonts with the necessary glyphs.  Out of the box,
-  the groff package supports latin-9 only for -Tps, -Tdvi, and -Tutf8,
-  and latin-2 only for -Tdvi and -Tutf8.
+  You still need proper fonts with the necessary glyphs.  Out of the
+  box, the groff package supports latin-9 only for -Tps, -Tdvi, and
+  -Tutf8, and latin-2 only for -Tdvi and -Tutf8.
 
 o Composite glyphs are now supported.  To do this, a subset of the Adobe
   Glyph List (AGL) Algorithm as described in
 
     http://partners.adobe.com/public/developer/opentype/index_glyph.html
 
-  is used to construct glyph names based on Unicode character codes.  The
-  existing groff glyph names are frozen; no glyph names which can't be
-  constructed algorithmically will be added in the future.
+  is used to construct glyph names based on Unicode character codes.
+  The existing groff glyph names are frozen; no glyph names which can't
+  be constructed algorithmically will be added in the future.
 
   The \... escape sequence has been extended to specify multiple glyph
   components.  Example:
@@ -885,10 +1572,10 @@
 
   this accesses a glyph with the name `u0041_0328'.
 
-  Some groff glyphs which are useful as composites map to `wrong' Unicode
-  code points.  For example, `ho' maps to U+02DB which is a spacing
-  ogonek, whereas a non-spacing ogonek U+0328 is needed for composite
-  glyphs.  The new request
+  Some groff glyphs which are useful as composites map to `wrong'
+  Unicode code points.  For example, `ho' maps to U+02DB which is a
+  spacing ogonek, whereas a non-spacing ogonek U+0328 is needed for
+  composite glyphs.  The new request
 
     .composite from to
 
@@ -904,24 +1591,25 @@
   for more details.
 
 o A new request `fschar' has been added to define font-specific fallback
-  characters.  They are searched after the list of fonts declared with the
-  `fspecial' request but before the list of fonts declared with `special'.
+  characters.  They are searched after the list of fonts declared with
+  the `fspecial' request but before the list of fonts declared with
+  `special'.
 
 o Fallback characters defined with `fschar' can be removed with the
   new `rfschar' request.
 
 o A new request `schar' has been added to define global fallback
-  characters.  They are searched after the list of fonts declared with the
-  `special' request but before the already mounted special fonts.
+  characters.  They are searched after the list of fonts declared with
+  the `special' request but before the already mounted special fonts.
 
 o In groff versions 1.18 and 1.18.1, \D'f ...' didn't move the current
   point horizontally.  Despite of being silly, this change has been
   reverted for backwards compatibility.  Consequently, the intermediate
   output command `Df' also moves the position horizontally again.
 
-  \D'f ...' is deprecated since it depends on the horizontal resolution of
-  the output device (given with the `hor' parameter in the DESC file).
-  Use the new \D'Fg ...' escape instead.
+  \D'f ...' is deprecated since it depends on the horizontal motion
+  quantum of the output device (given with the `hor' parameter in the
+  DESC file).  Use the new \D'Fg ...' escape instead.
 
 o For orthogonality, new \D subcommands to change the fill color are
   available:
@@ -932,8 +1620,8 @@
     \D'Fk ...' (cmyk)
     \D'Fd'     (default color)
 
-  The arguments are the same as with the `defcolor' request.  The current
-  position is *not* changed.
+  The arguments are the same as with the `defcolor' request.  The
+  current position is *not* changed.
 
 o The values set with \H and \S are now available in number registers
   \n.height and \n.slant, respectively.
@@ -943,21 +1631,21 @@
 
 o The new glyph symbol `tno' is a textual variant of `no'.
 
-o The new glyph symbol `+e' represents U+03F5, GREEK LUNATE EPSILON SYMBOL.
-  (Well, it is not really new since it has been previously supported by
-  grolj4.)  The mapping for both the dvi and lj4 symbol font has been
-  changed accordingly so that Greek small letter epsilon, `*e', has the
-  same glyph shape as with other devices.
+o The new glyph symbol `+e' represents U+03F5, GREEK LUNATE EPSILON
+  SYMBOL.  (Well, it is not really new since it has been previously
+  supported by grolj4.)  The mapping for both the dvi and lj4 symbol
+  font has been changed accordingly so that Greek small letter epsilon,
+  `*e', has the same glyph shape as with other devices.
 
 Grops
 -----
 
-o The font `freeeuro.pfa' has been added to provide various default glyph
-  shapes for `eu' and `Eu'.
+o The font `freeeuro.pfa' has been added to provide various default
+  glyph shapes for `eu' and `Eu'.
 
 o It is now possible to access all glyphs in a Type 1 font, not only 256
-  (provided the font file created by afmtodit has proper entries).  grops
-  constructs additional encoding vectors on the fly if necessary.
+  (provided the font file created by afmtodit has proper entries).
+  grops constructs additional encoding vectors on the fly if necessary.
 
 o The paper size is now emitted via the %%DocumentMedia and PageSize
   mechanisms so that it is no longer required to tell `gv' or `ps2pdf'
@@ -975,17 +1663,17 @@
 Grodvi
 ------
 
-o The font cmtex10 has been added as the special font `SC' to the DVI fonts.
-  It is used as a font-specific special font for CW and CWI.
+o The font cmtex10 has been added as the special font `SC' to the DVI
+  fonts.  It is used as a font-specific special font for CW and CWI.
 
 o New options -l and -p to set landscape orientation and the paper size.
-  grodvi now emits a `papersize' special which is understood by DVI drivers
-  like dvips.
+  grodvi now emits a `papersize' special which is understood by DVI
+  drivers like dvips.
 
   Consequently, the DESC file should contain a `papersize' keyword.
 
-o The glyph shapes for \*f and \*e have been exchanged with \+f and
-  \+e, respectively, to be in sync with all other devices.
+o The glyph shapes for \*f and \*e have been exchanged with \+f
+  and \+e, respectively, to be in sync with all other devices.
 
 o Glyphs \HE and \DI have been replaced with \u2662 and \u2661,
   respectively, since the former two glyphs have a black (filled) shape
@@ -994,8 +1682,8 @@
 Grolj4
 ------
 
-o The glyphs \*e and \+e have been exchanged to be in sync with
-  all other devices.
+o The glyphs \*e and \+e have been exchanged to be in sync with all
+  other devices.
 
 o The glyph \~= is now called \|=.  Similar to other devices, \~=
   is now another name for glyph \~~.
@@ -1003,8 +1691,8 @@
 Grotty
 ------
 
-o New option `-r'.  It is similar to the -i option except it tells grotty to
-  use the `reverse video' attribute to render italic fonts.
+o New option `-r'.  It is similar to the -i option except it tells
+  grotty to use the `reverse video' attribute to render italic fonts.
 
 Pic
 ---
@@ -1029,14 +1717,14 @@
 Afmtodit
 --------
 
-o Unencoded glyphs in an AFM file are output also (since grops can now emit
-  multiple encoding vectors for a single font).
+o Unencoded glyphs in an AFM file are output also (since grops can now
+  emit multiple encoding vectors for a single font).
 
 o New option `-m' to prevent negative left italic correction values.
 
-o The mapping and encoding file together with file `DESC' are now searched
-  in the default font directory also.  Please refer to the man page of
-  afmtodit for more details.
+o The mapping and encoding file together with file `DESC' are now
+  searched in the default font directory also.  Please refer to the man
+  page of afmtodit for more details.
 
 Macro Packages
 --------------
@@ -1063,10 +1751,10 @@
 o troff's start-up file `troffrc' now includes `papersize.tmac' to set
   the paper size with the command line option `-dpaper=<size>'.
 
-  Possible values for `<size>' are the same as the predefined `papersize'
-  values in the DESC file (only lowercase; see the groff_font man page)
-  except a7-d7.  An appended `l' (ell) character denotes landscape
-  orientation.  Examples: `a4', `c3l', `letterl'.
+  Possible values for `<size>' are the same as the predefined
+  `papersize' values in the DESC file (only lowercase; see the
+  groff_font man page) except a7-d7.  An appended `l' (ell) character
+  denotes landscape orientation.  Examples: `a4', `c3l', `letterl'.
 
   Most output drivers need additional command line switches `-p' and
   `-l' to override the default paper length and orientation as set in
@@ -1084,25 +1772,26 @@
 Troff
 -----
 
-o The non-slanted PostScript font definition files have been regenerated to
-  include left and right italic correction values.  Applying those to a
-  glyph (this is, prepending the glyph with `\,' and appending `\/' to the
-  glyph) sets the glyph width to the real value given by the horizontal
-  bounding box values.  Without those escapes, the advance width for the
-  particular glyph is used (which can differ considerably).
+o The non-slanted PostScript font definition files have been regenerated
+  to include left and right italic correction values.  Applying those to
+  a glyph (this is, prepending the glyph with `\,' and appending `\/' to
+  the glyph) sets the glyph width to the real value given by the
+  horizontal bounding box values.  Without those escapes, the advance
+  width for the particular glyph is used (which can differ
+  considerably).
 
   Most users will neither need this feature nor notice a difference in
-  existing documents (provided \, and \/ is used as advertised, namely for
-  italic fonts only); its main goal is to improve image generation with
-  grohtml.
+  existing documents (provided \, and \/ is used as advertised, namely
+  for italic fonts only); its main goal is to improve image generation
+  with grohtml.
 
   This is an experimental change, and feedback is welcome.
 
 Tbl
 ---
 
-o Added global option `nospaces' to ignore leading and trailing spaces in
-  data items.
+o Added global option `nospaces' to ignore leading and trailing spaces
+  in data items.
 
 Grolbp
 ------
@@ -1118,7 +1807,8 @@
 Groffer
 -------
 
-o New option `--shell' to select the shell under which groffer shall run.
+o New option `--shell' to select the shell under which groffer shall
+  run.
 
 Macro Packages
 --------------
@@ -1129,18 +1819,19 @@
 o `.IX' is now deprecated for mom; you should use `.IQ' (Indent Quit)
   instead.
 
-o In mom, new inlines `FWD', `BCK', `UP', and `DOWN' deal with horizontal
-  and vertical movements; please refer to contrib/mom/NEWS for more
-  details.
+o In mom, new inlines `FWD', `BCK', `UP', and `DOWN' deal with
+  horizontal and vertical movements; please refer to contrib/mom/NEWS
+  for more details.
 
 o New macro ENDNOTES_HDRFTR_CENTER for mom to better control headers.
 
 Miscellaneous
 -------------
 
-o The `papersize' keyword in the DESC file now accepts multiple arguments.
-  It is scanned from left to the right, and the first valid argument is
-  used. This makes it possible to provide a fallback paper size.
+o The `papersize' keyword in the DESC file now accepts multiple
+  arguments.  It is scanned from left to the right, and the first valid
+  argument is used. This makes it possible to provide a fallback paper
+  size.
 
   Example:
 
@@ -1148,8 +1839,8 @@
 
 o A local font directory has been prepended to the default font path; it
   defaults to /usr/local/share/groff/site-font.  Similar to the normal
-  font searching process, files must be placed into a devXXX subdirectory,
-  e.g.
+  font searching process, files must be placed into a devXXX
+  subdirectory, e.g.
 
     /usr/local/share/groff/site-font/devps/FOO
 
@@ -1159,41 +1850,39 @@
 VERSION 1.18
 ============
 
-***************************************************************************
-*                                                                         *
-*  PLEASE READ THE CHANGES BELOW REGARDING GROTTY, GROFF'S TTY FRONTEND.  *
-*                                                                         *
-***************************************************************************
+************************************************************************
+ PLEASE READ THE CHANGES BELOW REGARDING GROTTY, GROFF'S TTY FRONTEND.
+************************************************************************
 
 Troff
 -----
 
-o Color support has been added to troff and pic (and to the device drivers
-  grops, grodvi, grotty, and grohtml -- other preprocessors and drivers will
-  follow).  A new function `defcolor' defines colors; the escape sequence
-  `\m' sets the drawing color, the escape sequence `\M' specifies the
-  background color for closed objects created with \D'...' commands.
-  `\m' and `\M' switch back to the previous color.  `\m' and `\M'
-  correspond to the new troff output command sets starting with `m' and
-  `DF'.  The device-specific default color is called `default' and can't be
-  redefined.
-
-  Use the `color' request to toggle the usage of colors (default is on); the
-  read-only register `.color' is 0 if colors are not active, and non-zero
-  otherwise.
+o Color support has been added to troff and pic (and to the device
+  drivers grops, grodvi, grotty, and grohtml -- other preprocessors and
+  drivers will follow).  A new function `defcolor' defines colors; the
+  escape sequence `\m' sets the drawing color, the escape sequence `\M'
+  specifies the background color for closed objects created with \D'...'
+  commands.  `\m' and `\M' switch back to the previous color.  `\m'
+  and `\M' correspond to the new troff output command sets starting with
+  `m' and `DF'.  The device-specific default color is called `default'
+  and can't be redefined.
+
+  Use the `color' request to toggle the usage of colors (default is on);
+  the read-only register `.color' is 0 if colors are not active, and
+  non-zero otherwise.
 
   The old `Df' output command is mapped onto `DFg'; all color output
   commands don't change the current font position (consequently, `Df'
   doesn't either).
 
   Outputting color can be disabled in troff and groff with the option -c
-  (it is always disabled in compatibility mode).  See the section on grotty
-  for the GROFF_NO_SGR environment variable also.
+  (it is always disabled in compatibility mode).  See the section on
+  grotty for the GROFF_NO_SGR environment variable also.
 
-  For defining color components as fractions between 0 and 1, a new scaling
-  indicator `f' has been introduced: 1f = 65536u.  For testing whether a
-  color is defined (with .if and .ie), a new conditional operator `m' is
-  available.
+  For defining color components as fractions between 0 and 1, a new
+  scaling indicator `f' has been introduced: 1f = 65536u.  For testing
+  whether a color is defined (with .if and .ie), a new conditional
+  operator `m' is available.
 
   More details can be found in the groff_diff.7 manual page and in
   groff.texinfo.
@@ -1201,8 +1890,8 @@
 o Similar to \m and \M, \f switches back to the previous font.  \fP
   (and \fP) is still valid for backwards compatibility.
 
-o The new escape \F is the same as `.fam'; \F switches back to previous
-  family -- \FP selects family `P'.
+o The new escape \F is the same as `.fam'; \F switches back to
+  previous family -- \FP selects family `P'.
 
 o Two new glyph symbols are available: `eu' is the official Euro symbol;
   `Eu' is a font-specific glyph variant.
@@ -1210,8 +1899,8 @@
 o The new glyph symbols `t+-', `tdi', and `tmu' are textual variants of
   `+-', `di', and `mu', respectively.
 
-o Latin-1 character 181 (PS name `mu', Unicode name U+00B5 MICRO SIGN) has
-  got the troff glyph name `mc'.
+o Latin-1 character 181 (PS name `mu', Unicode name U+00B5 MICRO SIGN)
+  has got the troff glyph name `mc'.
 
 o -Tutf8 is now available on EBCDIC hosts.
 
@@ -1221,8 +1910,8 @@
     .ds xxx This is a \\$1 test.
     \*xxx nice
 
-o It is now possible to have whitespace between the first and second dot (or
-  the name of the ending macro) to end a macro definition.  Example:
+o It is now possible to have whitespace between the first and second dot
+  (or the name of the ending macro) to end a macro definition.  Example:
 
     .de !
     ..
@@ -1235,60 +1924,61 @@
     .  !
     ..
 
-o `.fn' is a new string-valued register which returns the (internal) real
-  font name; styles and families are properly concatenated.
+o `.fn' is a new string-valued register that returns the resolved font
+  font name; a font family and abstract style are catenated.
 
-o Three new read/write registers `seconds', `minutes', and `hours' contain
-  the current time, set at start-up of troff.  Use the `af' request to
-  control their output format.
-
-o The new request `fchar' can be used to provide fallback characters.  It
-  has the same syntax as the `char' request; the only difference is that a
-  character defined with `.char' hides the glyph with the same name in the
-  current font, whereas a character defined with `.fchar' is checked only if
-  the particular glyph isn't found in the current font.  This test happens
-  before checking special fonts.
+o Three new read/write registers `seconds', `minutes', and `hours'
+  contain the current time, set at start-up of troff.  Use the `af'
+  request to control their output format.
+
+o The new request `fchar' can be used to provide fallback characters.
+  It has the same syntax as the `char' request; the only difference is
+  that a character defined with `.char' hides the glyph with the same
+  name in the current font, whereas a character defined with `.fchar' is
+  checked only if the particular glyph isn't found in the current font.
+  This test happens before checking special fonts.
 
 o In analogy to the `tmc' request, `.writec' is the same as `.write' but
   doesn't emit a final newline.
 
-o The new request `itc' is a variant of `.it' for which a line interrupted
-  with \c counts as one input line.
+o The new request `itc' is a variant of `.it' for which a line
+  interrupted with \c counts as one input line.
 
-o Two new requests `ds1' and `as1' which are similar to `ds' and `as' but
-  with compatibility mode disabled during expansion of strings defined by
-  them.
+o Two new requests `ds1' and `as1' which are similar to `ds' and `as'
+  but with compatibility mode disabled during expansion of strings
+  defined by them.
 
 o The syntax of the `substring' request has been changed: The first
-  character in a string now has index 0, the last character has index -1.
-  Note that this is an incompatible change.
+  character in a string now has index 0, the last character has index
+  -1.  Note that this is an incompatible change.
 
 o To emit strings directly to the intermediate output, a new `output'
   request has been added; it is similar to `\!' used at the top level.
 
 o `.hpf' has been extended.  It can now handle most TeX hyphenation
-  pattern files without modification.  To do that, the commands \patterns,
-  \hyphenation, and \endinput are recognized.  Please refer to groff_diff.7
-  for more information.
+  pattern files without modification.  To do that, the commands
+  \patterns, \hyphenation, and \endinput are recognized.  Please refer
+  to groff_diff.7 for more information.
 
-o `hpfcode' is a new request to provide an input encoding mapping for the
-  `hpf' request.
+o `hpfcode' is a new request to provide an input encoding mapping for
+  the `hpf' request.
 
 o The new request `hpfa' appends hyphenation patterns (`hpf' replaces
   already existing patterns).
 
-o A new request `ami' (append macro indirect) has been added.  The first and
-  second parameter of `ami' are taken from string registers rather than
-  directly; this very special request is needed to make `trace.tmac'
-  independent from the escape character (which might even be disabled).
-
-o The new request `sizes' is similar to the `sizes' command in DESC files.
-  It expects the same syntax; the data must be on a single line, and the
-  final `0' can be omitted.
-
-o `trin' (translate input) is a new request which is similar to `tr' with
-  the exception that the `asciify' request uses the character code (if
-  any) before the character translation.  Example:
+o A new request `ami' (append macro indirect) has been added.  The first
+  and second parameter of `ami' are taken from string registers rather
+  than directly; this very special request is needed to make
+  `trace.tmac' independent from the escape character (which might even
+  be disabled).
+
+o The new request `sizes' is similar to the `sizes' command in DESC
+  files.  It expects the same syntax; the data must be on a single line,
+  and the final `0' can be omitted.
+
+o `trin' (translate input) is a new request which is similar to `tr'
+  with the exception that the `asciify' request uses the character code
+  (if any) before the character translation.  Example:
 
     .trin ax
     .di xxx
@@ -1337,52 +2027,53 @@
 Macro Packages
 --------------
 
-o Peter Schaffter <df191@ncf.ca> has contributed a new major macro package
-  called `mom', mainly for non-scientific writers, which takes care of
-  many typographic issues.  It comes with a complete reference (in HTML
-  format) and some examples.  `mom' has been designed to format documents
-  for PostScript output only.
+o Peter Schaffter <df191@ncf.ca> has contributed a new major macro
+  package called `mom', mainly for non-scientific writers, which takes
+  care of many typographic issues.  It comes with a complete reference
+  (in HTML format) and some examples.  `mom' has been designed to format
+  documents for PostScript output only.
 
-o Two macros `AT' (AT&T) and `UC' (Univ. of California) have been added to
-  the man macros for compatibility with older BSD releases.
+o Two macros `AT' (AT&T) and `UC' (Univ. of California) have been added
+  to the man macros for compatibility with older BSD releases.
 
-o Both the man and mdoc macro packages now use the LL and LT registers for
-  setting the line and title length, respectively (similar to those
+o Both the man and mdoc macro packages now use the LL and LT registers
+  for setting the line and title length, respectively (similar to those
   registers in the ms macro package).  If not set on the command line or
-  in a macro file loaded before the macro package itself, they default to
-  78n in nroff mode and 6.5i in troff mode.
-
-o The `-xwidth' specifier in the mdoc macro package has been removed.  Its
-  functionality is now integrated directly into `-width'.  Similarly,
-  `-column' has been extended to provide this functionality also.
+  in a macro file loaded before the macro package itself, they default
+  to 78n in nroff mode and 6.5i in troff mode.
 
-o A new macro `Ex' has been added to the mdoc macro package to document an
-  exit status.
+o The `-xwidth' specifier in the mdoc macro package has been removed.
+  Its functionality is now integrated directly into `-width'.
+  Similarly, `-column' has been extended to provide this functionality
+  also.
+
+o A new macro `Ex' has been added to the mdoc macro package to document
+  an exit status.
+
+o The PSPIC macro has been extended to work with DVI output
+  (`pspic.tmac' is now automatically loaded for -Tdvi), using a dvips
+  special to load the EPS file.
 
-o The PSPIC macro has been extended to work with DVI output (`pspic.tmac' is
-  now automatically loaded for -Tdvi), using a dvips special to load the EPS
-  file.
+o The trace.tmac package now traces calls to `am' also.  Additionally,
+  it works in compatibility mode.
 
-o The trace.tmac package now traces calls to `am' also.  Additionally, it
-  works in compatibility mode.
-
-o `troff.1' has been split.  Differences to Unix troff are now documented
-  in the new man page `groff_diff.7'.
+o `troff.1' has been split.  Differences to Unix troff are now
+  documented in the new man page `groff_diff.7'.
 
 o `groff_mwww.7' has been renamed to `groff_www.7'.  The file mwww.tmac
   has been removed.
 
-o `groff_ms.7' has been completely rewritten.  It now contains a complete
-  reference to the ms macros.
+o `groff_ms.7' has been completely rewritten.  It now contains a
+  complete reference to the ms macros.
 
 o `groff_trace.7' documents the trace macro package.
 
 o Changes in www.tmac:
 
-    Note that HTML support is still in alpha change, so it is rather likely
-    that both macro names and macro syntax will change.  Some of the macros
-    mentioned below aren't really new but haven't been documented properly
-    before.
+    Note that HTML support is still in alpha change, so it is rather
+    likely that both macro names and macro syntax will change.  Some of
+    the macros mentioned below aren't really new but haven't been
+    documented properly before.
 
     The following macros have been renamed:
 
@@ -1393,41 +2084,44 @@
     For consistency, the macros `URL', `FTL', and `MTO' now all have the
     address as the first parameter followed by the description.
 
-    By default, grohtml generates links to all section headings at the top
-    of the document.  Use the new `LK' macro to specify a different place.
+    By default, grohtml generates links to all section headings at the
+    top of the document.  Use the new `LK' macro to specify a different
+    place.
 
     For specifying the background color and a background image, use the
     new macros `BCL' and `BGIMG', respectively.
 
-    The macro `NHR' has been added; it suppresses the generation of top and
-    bottom rules which grohtml emits by default.
+    The macro `NHR' has been added; it suppresses the generation of top
+    and bottom rules which grohtml emits by default.
 
     The new macro `HX' determines the cut-off point for automatic link
     generation to headings.
 
-    The image position parameter names in `IMG' have been changed to `-L',
-    `-R', and `-C'.
+    The image position parameter names in `IMG' have been changed to
+    `-L', `-R', and `-C'.
 
     New macro `PIMG' for inclusion of a PNG image (it automatically
     converts it into an EPS file if not -Thtml is used).
 
-    New macro `MPIMG' for putting a PNG image into the left or right margin
-    (it automatically converts it into an EPS file if not -Thtml is used).
+    New macro `MPIMG' for putting a PNG image into the left or right
+    margin (it automatically converts it into an EPS file if not -Thtml
+    is used).
 
     New macros `HnS', `HnE' to start and end a header line block.
 
     New macro `DC' to produce dropcap characters.
 
-    New macro `HTL' to generate an HTML title line only but no H1 heading.
+    New macro `HTL' to generate an HTML title line only but no H1
+    heading.
 
-    New macros `ULS' and `ULE' to start and end an unordered list.  The new
-    macro `LI' inserts a list item.
+    New macros `ULS' and `ULE' to start and end an unordered list.  The
+    new macro `LI' inserts a list item.
 
 Groff
 -----
 
-o The new command line option `-c' disables color output (which is always
-  disabled in compatibility mode).
+o The new command line option `-c' disables color output (which is
+  always disabled in compatibility mode).
 
 Nroff
 -----
@@ -1439,9 +2133,11 @@
 Pic
 ---
 
-o New keywords `color' (or `colour', `colored', `coloured'), `outline' (or
-  `outlined'), and `shaded' are available.  `outline' sets the color of the
-  outline, `shaded' the fill color, and `color' sets both.  Example:
+o New keywords `color' (or `colour', `colored', `coloured'), `outline'
+  (or `outlined'), and `shaded' are available.  `outline' sets the color
+  of the outline, `shaded' the fill color, and `color' sets both.
+
+  Example:
 
     circle shaded "green" outline "black" ;
 
@@ -1453,22 +2149,23 @@
 ---------
 
 o A new script contributed by Eric S. Raymond <esr@thyrsus.com>.  It
-  converts a PIC diagram into a cropped image.  Since it uses gs and the PNM
-  library, virtually all graphics formats are available for output.
+  converts a PIC diagram into a cropped image.  Since it uses gs and the
+  PNM library, virtually all graphics formats are available for output.
 
 Eqn2graph
 ---------
 
 o A new script contributed by Eric S. Raymond <esr@thyrsus.com>.  It
-  converts an EQN diagram into a cropped image.  Since it uses gs and the
-  PNM library, virtually all graphics formats are available for output.
+  converts an EQN diagram into a cropped image.  Since it uses gs and
+  the PNM library, virtually all graphics formats are available for
+  output.
 
 Groffer
 -------
 
-o A new script contributed by Bernd Warken <bwarken@mayn.de>.  It displays
-  groff files and man pages on X and tty, taking care of most parameters
-  automatically.
+o A new script contributed by Bernd Warken <bwarken@mayn.de>.  It
+  displays groff files and man pages on X and tty, taking care of most
+  parameters automatically.
 
 Grog
 ----
@@ -1480,15 +2177,16 @@
 
 o Color support has been added.
 
-o A new option `-p' is available to select the output paper size.  It has
-  the same syntax as the new `papersize' keyword in the DESC file.
+o A new option `-p' is available to select the output paper size.  It
+  has the same syntax as the new `papersize' keyword in the DESC file.
 
 Grodvi
 ------
 
-o By default, font sizes are now available in the range 5-10000pt, similar
-  to PS fonts. If you want the old behaviour (i.e., font sizes at discrete
-  values only), insert the following at the start of your document:
+o By default, font sizes are now available in the range 5-10000pt,
+  similar to PS fonts. If you want the old behaviour (i.e., font sizes
+  at discrete values only), insert the following at the start of your
+  document:
 
     .if '\*.T'dvi' \
     .  sizes 500 600 700 800 900 1000 1095 1200 1400 1440 1600 \
@@ -1500,46 +2198,48 @@
 o Two font families are now available: `T' and `H'.
 
 o EC and TC fonts have been integrated.  Use `-mec' (calling the file
-  ec.tmac) to switch to them.  Those fonts give a much better coverage of
-  the symbols defined by groff than the CM fonts.
+  ec.tmac) to switch to them.  Those fonts give a much better coverage
+  of the symbols defined by groff than the CM fonts.
 
-  Note that ec.tmac must be called before any language-specific files; it
-  doesn't take care of hcode values.
+  Note that ec.tmac must be called before any language-specific files;
+  it doesn't take care of hcode values.
 
-o Color support has been added.  For drawing commands, colors are translated
-  to gray values currently.
+o Color support has been added.  For drawing commands, colors are
+  translated to gray values currently.
 
 Grotty
 ------
 
-o Color support has been added, using the SGR (ISO 6429, sometimes called
-  ANSI color) escape sequences.
+o Color support has been added, using the SGR (ISO 6429, sometimes
+  called ANSI color) escape sequences.
 
 o SGR escape sequences are now used by default for underlining and bold
-  printing also, no longer using the backspace character trick.  To revert
-  to the old behaviour, use the `-c' switch.
+  printing also, no longer using the backspace character trick.  To
+  revert to the old behaviour, use the `-c' switch.
 
-  Note that you have to use the `-R' option of `less' to make SGR escapes
-  display correctly.  On the other hand, terminal programs and consoles like
-  `xterm' which support SGR sequences natively can directly display the
-  output of grotty.  Consequently, the options `-b', `-B', `-u', and `-U'
-  work only in combination with `-c' and are ignored silently otherwise.
+  Note that you have to use the `-R' option of `less' to make SGR
+  escapes display correctly.  On the other hand, terminal programs and
+  consoles like `xterm' which support SGR sequences natively can
+  directly display the output of grotty.  Consequently, the options
+  `-b', `-B', `-u', and `-U' work only in combination with `-c' and are
+  ignored silently otherwise.
 
   For the `man' program, it may be necessary to add the `-R' option of
-  `less' to the $PAGER environment variable (or $MANPAGER, depending on the
-  used `man' program); alternatively, you can use `man's `-P' option (or
-  adapt its configuration file accordingly).  See man(1) for more details.
+  `less' to the $PAGER environment variable (or $MANPAGER, depending on
+  the used `man' program); alternatively, you can use `man's `-P' option
+  (or adapt its configuration file accordingly).  See man(1) for more
+  details.
 
-o If the environment variable GROFF_NO_SGR is set, SGR output is disabled,
-  reverting to the old behaviour.
+o If the environment variable GROFF_NO_SGR is set, SGR output is
+  disabled, reverting to the old behaviour.
 
-o A new special \X'tty: sgr n' has been added; if n is non-zero or missing,
-  enable SGR output (the default).
+o A new special \X'tty: sgr n' has been added; if n is non-zero or
+  missing, enable SGR output (the default).
 
 o If the new option `-i' is used (only in SGR mode), grotty sends escape
   sequences to set the italic font attribute instead of the underline
-  attribute for italic fonts.  Note that many terminals don't have support
-  for this (including xterm).
+  attribute for italic fonts.  Note that many terminals don't have
+  support for this (including xterm).
 
 Grohtml
 -------
@@ -1550,26 +2250,26 @@
 
 o New option `-b' to set the background colour to white.
 
-o New options `-a' and `-g' to control the number of bits for anti-aliasing
-  used for text and graphics, respectively.  Default value is 4; 0 means
-  no anti-aliasing.
+o New options `-a' and `-g' to control the number of bits for
+  anti-aliasing used for text and graphics, respectively.  Default value
+  is 4; 0 means no anti-aliasing.
 
 o groff character/glyph entities now map onto HTML 4 character entities.
 
 Grolbp
 ------
 
-o Valid paper sizes are now specified as with the new `papersize' keyword
-  in the DESC file.  Specifically, the old custom paper type format
-  `custAAAxBBB' is no longer supported.
+o Valid paper sizes are now specified as with the new `papersize'
+  keyword in the DESC file.  Specifically, the old custom paper type
+  format `custAAAxBBB' is no longer supported.
 
 Miscellaneous
 -------------
 
 o A new manual page `ditroff.7' is available.
 
-o The groff texinfo manual is installed now, together with a bunch
-  of examples.
+o The groff texinfo manual is installed now, together with a bunch of
+  examples.
 
 o A new keyword `papersize' has been added to the DESC file format.  Its
   argument is either
@@ -1582,8 +2282,8 @@
   . a custom paper size definition like `35c,4i'
 
   See groff_font(5) for more details.  This keyword only affects the
-  physical dimensions of the output medium; grops, grolj4, and grolbp use it
-  currently.  troff completely ignores it.
+  physical dimensions of the output medium; grops, grolj4, and grolbp
+  use it currently.  troff completely ignores it.
 
 
 VERSION 1.17.2
@@ -1594,9 +2294,9 @@
 Troff
 -----
 
-o The `IMAGE' macro in www.tmac has changed: Now the optional 2nd parameter
-  gives the horizontal image location (left, centered, or right), and the
-  optional 3rd and 4th parameter the image dimensions.
+o The `IMAGE' macro in www.tmac has changed: Now the optional 2nd
+  parameter gives the horizontal image location (left, centered, or
+  right), and the optional 3rd and 4th parameter the image dimensions.
 
 
 VERSION 1.17.1
@@ -1607,17 +2307,17 @@
 Troff
 -----
 
-o Two new requests `de1' and `am1' which are similar to `de' and `am' but
-  with compatibility mode disabled during expansion of macros defined by
-  them.
+o Two new requests `de1' and `am1' which are similar to `de' and `am'
+  but with compatibility mode disabled during expansion of macros
+  defined by them.
 
 o Added request `brp'.  This is the same as `\p'.
 
 o Similar to other versions of troff, the `ns' request now works in all
   diversions, not only in the top-level one.
 
-o New read-only number register `.ns'.  Returns 1 if in no-space mode,
-  0 otherwise.
+o New read-only number register `.ns'.  Returns 1 if in no-space mode, 0
+  otherwise.
 
 Nroff
 -----
@@ -1630,7 +2330,8 @@
 Grohtml
 -------
 
-o New option `-D dir' to specify a directory in which all images are placed.
+o New option `-D dir' to specify a directory in which all images are
+  placed.
 
 o New option `-I stem' to specify an image name stame.  If not given,
   `grohtml-XXX' is used (`XXX' is the process ID).
@@ -1642,38 +2343,39 @@
 Groff
 -----
 
-o `-mFOO' now searches first for `FOO.tmac' and then for `tmac.FOO'.  The
-  old behaviour has been changed to overcome problems with platforms which
-  have an 8+3 file name limit, and platforms which have other versions of
-  troff installed also.  Additionally, all macro files have been renamed
-  using the latter scheme to avoid 8+3 name clashes.
-
-o The new environment variable GROFF_BIN_PATH is checked for programs groff
-  is calling (preprocessors, troff, and output devices) before PATH.  If not
-  set, it defaults to the directory where the groff binary is located.
-  Previously, it was PATH only.  The nroff script only uses GROFF_BIN_PATH
-  to find the groff binary but passes both the GROFF_BIN_PATH and PATH
-  environment variables to groff.
+o `-mFOO' now searches first for `FOO.tmac' and then for `tmac.FOO'.
+  The old behaviour has been changed to overcome problems with platforms
+  which have an 8+3 file name limit, and platforms which have other
+  versions of troff installed also.  Additionally, all macro files have
+  been renamed using the latter scheme to avoid 8+3 name clashes.
+
+o The new environment variable GROFF_BIN_PATH is checked for programs
+  groff is calling (preprocessors, troff, and output devices) before
+  PATH.  If not set, it defaults to the directory where the groff binary
+  is located.  Previously, it was PATH only.  The nroff script only uses
+  GROFF_BIN_PATH to find the groff binary but passes both the
+  GROFF_BIN_PATH and PATH environment variables to groff.
 
 Troff
 -----
 
-o The mdoc package has been completely rewritten, using the full power of
-  GNU troff to remove limitations of Unix troff (which is no longer
+o The mdoc package has been completely rewritten, using the full power
+  of GNU troff to remove limitations of Unix troff (which is no longer
   supported).  Most important changes are:
 
   . No argument limit
   . Almost all macros are parsed and callable (if it makes sense)
   . `.Lb': prints library names
-  . `.Nm <punctuation>' now works as expected; `.Nm "" <punctuation>' has
-    been withdrawn
+  . `.Nm <punctuation>' now works as expected; `.Nm "" <punctuation>'
+    has been withdrawn
   . Updated `.St' command
   . `.Fx': prints FreeBSD
   . `.Ox': prints OpenBSD
   . `.Bsx': prints BSD/OS
   . `.Brq', `.Bro', `.Brc': brace enclosure macros
   . `.Bd -centered': center lines
-  . `.Bl -xwidth <string>': interpret <string> and use the resulting width
+  . `.Bl -xwidth <string>': interpret <string> and use the resulting
+    width
   . Support for double-sided printing (-rD1 command line switch)
   . Support for 11pt and 12pt document sizes (-rS11, -rS12 command line
     switches)
@@ -1682,16 +2384,18 @@
   documents the mdoc package.
 
   Great care has been taken to assure backwards compatibility.  If you
-  encounter any abnormal results, please report them to bug-groff@gnu.org.
-  2018 UPDATE: This address no longer accepts bug reports; please use the
-  GNU Savannah bug tracker at http://savannah.gnu.org/bugs/?group=groff.
+  encounter any abnormal results, please report them to
+  bug-groff@gnu.org.  2018 UPDATE: This address no longer accepts bug
+  reports; please use the GNU Savannah bug tracker at
+  http://savannah.gnu.org/bugs/?group=groff.
 
 o A new command line option for the `man' macros (similar to the `mdoc'
-  package) has been implemented: `-rcR=1' (now the default in nroff mode)
-  produces one single, very long page instead of multiple pages.  `-rcR=0'
-  deactivates it.
+  package) has been implemented: `-rcR=1' (now the default in nroff
+  mode) produces one single, very long page instead of multiple pages.
+  `-rcR=0' deactivates it.
 
-o The `return' request has been added to return immediately from a macro.
+o The `return' request has been added to return immediately from a
+  macro.
 
 o A new request `nop' (no operation) has been added which is similar to
   `if 1'.  For example,
@@ -1706,9 +2410,9 @@
     .  nop Hallo!
     .\}
 
-o `box' and `boxa' are two new requests which behave similarly to `di' and
-  `da' but don't include a partially filled line (which is restored after
-  ending the diversion).
+o `box' and `boxa' are two new requests which behave similarly to `di'
+  and `da' but don't include a partially filled line (which is restored
+  after ending the diversion).
 
 o The `asciify' request has been extended to `unformat' space characters
   and some other escape sequences also.
@@ -1716,10 +2420,10 @@
   `\ ' is no longer unformatted as a space but remains an unpaddable,
   unbreakable space character.
 
-o The new `unformat' request is similar to `asciify' but only handles space
-  characters and tabs specially if the diversion is reread, retaining font
-  information.  This makes it possible to reformat diversions; for example
-  the following
+o The new `unformat' request is similar to `asciify' but only handles
+  space characters and tabs specially if the diversion is reread,
+  retaining font information.  This makes it possible to reformat
+  diversions; for example the following
 
     .ll 3i
     .
@@ -1755,10 +2459,10 @@
     b02 b03 b04 b05 b06 b07 b08
     b09 b10.
 
-o The new request `linetabs' controls the `line-tabs' mode.  In line-tabs
-  mode, tab distances are computed relative to the (current) output line.
-  Otherwise they are taken relative to the input line.  For example, the
-  following
+o The new request `linetabs' controls the `line-tabs' mode.  In
+  line-tabs mode, tab distances are computed relative to the (current)
+  output line.  Otherwise they are taken relative to the input line.
+  For example, the following
 
     .ds x a\t\c
     .ds y b\t\c
@@ -1776,54 +2480,56 @@
 
     a         b                   c
 
-  The new read-only number register `.linetabs' returns 1 if in line-tabs
-  mode, and 0 otherwise.
+  The new read-only number register `.linetabs' returns 1 if in
+  line-tabs mode, and 0 otherwise.
 
 o Two new requests `tm1' and `tmc' have been added to improve writing
   messages to the terminal.  `tm1' is similar to `tm' but allows leading
-  whitespace.  `tmc' is similar to `tm1' but doesn't emit a final newline.
+  whitespace.  `tmc' is similar to `tm1' but doesn't emit a final
+  newline.
 
 o For compatibility with sqtroff, the request `output' has been added.
-  The behaviour is similar to `\!' at the top-level, that is, it directly
-  inserts its argument into the intermediate output format.  The syntax
-  is similar to .tm1, allowing leading whitespace.
+  The behaviour is similar to `\!' at the top-level, that is, it
+  directly inserts its argument into the intermediate output format.
+  The syntax is similar to .tm1, allowing leading whitespace.
 
 o The new `spreadwarn' request makes troff warn if spaces in an output
   line are widened by a given limit or more.
 
-o Use `warnscale' to change the scaling indicator troff uses for
-  warning messages.
+o Use `warnscale' to change the scaling indicator troff uses for warning
+  messages.
 
 o A new request `dei' (define indirect) has been added.  The first and
   second parameter of `dei' are taken from string registers rather than
   directly; this very special request is needed to make `trace.tmac'
   independent from the escape character (which might even be disabled).
 
-o It is now possible to save and restore the escape character with two new
-  requests `ecs' and `ecr'.
+o It is now possible to save and restore the escape character with two
+  new requests `ecs' and `ecr'.
 
 o The new escape sequence \B'...' is an analogon to `\A': If the string
-  within the delimiters is a valid numeric expression, return character `1',
-  and `0' otherwise.
+  within the delimiters is a valid numeric expression, return character
+  `1', and `0' otherwise.
 
-o The new escape sequence `\:' inserts a zero-width break point.  This is
-  similar to `\%' but without a soft hyphen character.
+o The new escape sequence `\:' inserts a zero-width break point.  This
+  is similar to `\%' but without a soft hyphen character.
 
 o The `tr' request can now map characters onto `\~'.
 
 o Calling the `fam' request without an argument switches back to the
   previous font family.
 
-o The new read-only register `.int' is set to a positive value if the last
-  output line is interrupted (i.e., if the input line contains `\c').
-
-o The `writem' request is not new, but hasn't been documented before.  This
-  is similar to `write' but instead of a string the contents of a given
-  macro or string is written to a stream.
+o The new read-only register `.int' is set to a positive value if the
+  last output line is interrupted (i.e., if the input line contains
+  `\c').
+
+o The `writem' request is not new, but hasn't been documented before.
+  This is similar to `write' but instead of a string the contents of a
+  given macro or string is written to a stream.
 
 o The read/write number register `hp' to get/set the current horizontal
-  position relative to the input line isn't new but hasn't been documented
-  properly before.
+  position relative to the input line isn't new but hasn't been
+  documented properly before.
 
 o `\X' and `\Y' are now transparent for end-of-sentence recognition.
 
@@ -1834,53 +2540,58 @@
 ----
 
 o The grog script now works in non-compatibility mode also (which is the
-  default).  As usual, use the `-C' option to activate compatibility mode.
+  default).  As usual, use the `-C' option to activate compatibility
+  mode.
 
 Grops
 -----
 
-o A new option `-P' resp. a new environment variable `GROPS_PROLOGUE' has
-  been added to select a different prologue file.
+o A new option `-P' resp. a new environment variable `GROPS_PROLOGUE'
+  has been added to select a different prologue file.
 
-o The effect of the former `-mpsnew' option to access more Type 1 characters
-  is now the default and no longer available.  To get the old behaviour
-  (i.e., emulation of some glyphs by composition) use `-mpsold'.
+o The effect of the former `-mpsnew' option to access more Type 1
+  characters is now the default and no longer available.  To get the old
+  behaviour (i.e., emulation of some glyphs by composition) use
+  `-mpsold'.
 
 Miscellaneous
 -------------
 
 o For security reasons the following changes have been done:
 
-  . The tmac.safer file has been replaced with a built-in solution; .open,
-    .opena, .pso, .sy, and .pi are completely disabled in safer mode (which
-    is the default); to enable these requests the `-U' command line flag
-    must be used.
+  . The tmac.safer file has been replaced with a built-in solution;
+    .open, .opena, .pso, .sy, and .pi are completely disabled in safer
+    mode (which is the default); to enable these requests the `-U'
+    command line flag must be used.
 
   . Files specified with the .mso request or given with the `-m' command
-    line option, and hyphenation patterns loaded with `.hpf' are no longer
-    searched in the current directory by default (besides the usual tmac
-    path).  Instead, the home directory is used.  To add the current
-    directory, either use the `-U' or `-M' command line option or set the
-    GROFF_TMAC_PATH environment variable to an appropriate value.
-
-  . troffrc, troffrc-end, and eqnrc are neither searched in the current nor
-    in the home directory (even if -U is given).  Use -M or GROFF_TMAC_PATH
-    to change that.
+    line option, and hyphenation patterns loaded with `.hpf' are no
+    longer searched in the current directory by default (besides the
+    usual tmac path).  Instead, the home directory is used.  To add the
+    current directory, either use the `-U' or `-M' command line option
+    or set the GROFF_TMAC_PATH environment variable to an appropriate
+    value.
+
+  . troffrc, troffrc-end, and eqnrc are neither searched in the current
+    nor in the home directory (even if -U is given).  Use -M or
+    GROFF_TMAC_PATH to change that.
 
   . Similarly, the current directory is no longer part of the font path.
     Use the `-F' command line option or the GROFF_FONT_PATH environment
     variable if you really need the current directory.
 
-o groff now installs its data files into /usr/local/share/groff/<version> by
-  default, following the GNU standard.  Additionally, a local tmac directory
-  (by default /usr/local/share/groff/site-tmac) is scanned before the
-  standard tmac directory.  Wrapper files for system-specific macro packages
-  (if necessary) are put into /usr/local/lib/groff/site-tmac; this directory
+o groff now installs its data files into
+  /usr/local/share/groff/<version> by default, following the GNU
+  standard.  Additionally, a local tmac directory (by default
+  /usr/local/share/groff/site-tmac) is scanned before the standard tmac
+  directory.  Wrapper files for system-specific macro packages (if
+  necessary) are put into /usr/local/lib/groff/site-tmac; this directory
   is searched before the local tmac directory.
 
-o All programs now have option `-v' to show the version number; they exit
-  immediately afterwards, following the GNU standards.  Additionally,
-  `--version' and `--help' have been added, doing the obvious actions.
+o All programs now have option `-v' to show the version number; they
+  exit immediately afterwards, following the GNU standards.
+  Additionally, `--version' and `--help' have been added, doing the
+  obvious actions.
 
 
 VERSION 1.16.1
@@ -1895,38 +2606,39 @@
 Groff
 -----
 
-The anachronism of calling the man macro package with `-man' has been fixed;
-now you can say `-m man' also. The same is true for `ms', `me', `markup',
-`mandoc', and `mdoc'.
+The anachronism of calling the man macro package with `-man' has been
+fixed; now you can say `-m man' also. The same is true for `ms', `me',
+`markup', `mandoc', and `mdoc'.
 
 A new switch `-g' for calling `grn' is available.
 
 A new switch `-G' for calling `grap' is available.
 
-EBCDIC support for tty devices has been added.  On such hosts, IBM code page
-1047 is available with -Tcp1047 instead of -Tascii and -Tlatin1 (and, for
-the moment, -Tutf8).  Note that non-tty devices are not yet supported (but
-installed).
+EBCDIC support for tty devices has been added.  On such hosts, IBM code
+page 1047 is available with -Tcp1047 instead of -Tascii and -Tlatin1
+(and, for the moment, -Tutf8).  Note that non-tty devices are not yet
+supported (but installed).
 
 Troff
 -----
 
-A new command line option to the `man' macros is available: `-rSxx' (with
-`xx' either 10, 11, or 12) to set the base document font size to `xx'
-points.  Additionally, `.SH' now produces larger headings than `.SS'.
+A new command line option to the `man' macros is available: `-rSxx'
+(with `xx' either 10, 11, or 12) to set the base document font size to
+`xx' points.  Additionally, `.SH' now produces larger headings than
+`.SS'.
 
 To solve a problem with the .PSPIC macro which needs the `-U' switch of
 troff to access an external program (psbb), a new request .psbb is now
-available to get the bounding box of a PostScript image file.  The values
-(in PostScript units) are returned in the new read-only number registers
-`llx', `lly', `urx', and `ury'.  Consequently, .PSPIC has been adapted to
-use the new request, and the psbb program has been removed.
+available to get the bounding box of a PostScript image file.  The
+values (in PostScript units) are returned in the new read-only number
+registers `llx', `lly', `urx', and `ury'.  Consequently, .PSPIC has been
+adapted to use the new request, and the psbb program has been removed.
 
 A new predefined writable number register, `year', has been added.  It
 contains the current year.
 
-A new read-only register, `.Y', has been added.  It contains the revision
-number of the groff package.
+A new read-only register, `.Y', has been added.  It contains the
+revision number of the groff package.
 
 `\fP' now behaves as expected in situations like the following where the
 font `foo' is undefined:
@@ -1938,43 +2650,43 @@
 
 The `substring' request is not new, but hasn't been documented before.
 
-The predefined `.T' string register (which holds the current output device)
-is not new, but hasn't been documented before.
+The predefined `.T' string register (which holds the name of the output
+device) is not new, but hasn't been documented before.
 
 A new request `length' computes the length of a string and returns it in
 a number register.
 
-The macro files `tmac.a4' (for specifying A4 paper format) and `tmac.trace'
-(a debugging aid) are now installed also.
+The macro files `tmac.a4' (for specifying A4 paper format) and
+`tmac.trace' (a debugging aid) are now installed also.
 
-A new resource file, `troffrc-end', is now available.  It is invoked after
-all user-specified macros.  Currently used by the html device to include
-tmac.html; thus no need for users to specify -mhtml anymore.
+A new resource file, `troffrc-end', is now available.  It is invoked
+after all user-specified macros.  Currently used by the html device to
+include tmac.html; thus no need for users to specify -mhtml anymore.
 
 The soft hyphen character now has a glyph name: `shc'.
 
-The latin-1 character 173 (PS name `periodcentered') has got the troff glyph
-name `pc' and is no longer intermixed with the symbol character `md' (PS
-name `mathdot').
+The latin-1 character 173 (PS name `periodcentered') has got the troff
+glyph name `pc' and is no longer intermixed with the symbol character
+`md' (PS name `mathdot').
 
-ASCII character 34 (PS name `quotedbl') has got the troff glyph name `dq'
-(which is an alias to character `"').
+ASCII character 34 (PS name `quotedbl') has got the troff glyph name
+`dq' (which is an alias to character `"').
 
-ASCII character 39 (PS name `quoteright') has got the troff glyph name `cq'
-(which is an alias to character "'").
+ASCII character 39 (PS name `quoteright') has got the troff glyph name
+`cq' (which is an alias to character "'").
 
 Some additions to the font description files have been implemented for
 better support of HTML output:
 
-  The new format of lines in the `charset' subsection of font description
-  files is
+  The new format of lines in the `charset' subsection of font
+  description files is
 
      name metrics type code entity_name -- comment
 
   Currently, only the font description files in devhtml use the optional
-  entity_name string to define glyph entities in HTML.  Everything after the
-  entity_name field is ignored; in case this field isn't used, two hyphen
-  characters are now necessary to start a comment.
+  entity_name string to define glyph entities in HTML.  Everything after
+  the entity_name field is ignored; in case this field isn't used, two
+  hyphen characters are now necessary to start a comment.
 
   Two new requests are available in DESC files (currently used only with
   grohtml):
@@ -1990,7 +2702,8 @@
 Grotty
 ------
 
-Bruno Haible <haible@clisp.cons.org> contributed support for UTF8 output.
+Bruno Haible <haible@clisp.cons.org> contributed support for UTF8
+output.
 
 Grohtml
 -------
@@ -1999,8 +2712,8 @@
 
 The obsolete `.LINK' macro has been removed.
 
-.URL, .FTP, and .MAILTO macros now accept an optional third argument which
-is immediately appended to the second argument (to be used with
+.URL, .FTP, and .MAILTO macros now accept an optional third argument
+which is immediately appended to the second argument (to be used with
 punctuation, for example).
 
 Grodvi
@@ -2014,7 +2727,7 @@
 Grolbp
 ------
 
-A new driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser
+A new driver for Canon CaPSL printers (LBP-4 and LBP-8 series laser
 printers).  This code has been contributed by Francisco Andres Verdu
 <pandres@dragonet.es>.
 
@@ -2042,14 +2755,15 @@
 -------------
 
 Three new man pages are available: groff_tmac.5 (documenting how troff
-macros are accessed and where they are found), groff.7 (a short reference of
-the GNU roff language), and roff.7 (a general survey on GNU troff).
+macros are accessed and where they are found), groff.7 (a short
+reference of the GNU roff language), and roff.7 (a general survey on GNU
+troff).
 
 Miscellaneous
 -------------
 
-A partial port to win32 (for use with Microsoft Visual C++ 6.0) is now part
-of the distribution.  It has been contributed by Blake McBride
+A partial port to win32 (for use with Microsoft Visual C++ 6.0) is now
+part of the distribution.  It has been contributed by Blake McBride
 <blake@florida-software.com>.
 
 More information about programs, macros, documentation, etc., which is
@@ -2066,25 +2780,25 @@
 ============
 
 Finally, there are new maintainers for groff.  Mailing lists and a
-development repository are available also. See the file README for details.
-Not all reported bugs could be fixed, so please send mails again if
-something is still not working.
+development repository are available also. See the file README for
+details.  Not all reported bugs could be fixed, so please send mails
+again if something is still not working.
 
-Most of the installation problems should have vanished now (most
-notably the $(tmac_wrap) bug).
+Most of the installation problems should have vanished now (most notably
+the $(tmac_wrap) bug).
 
-There is now a man page called groff_man.7 which documents the basics of the
--man macros.  It has been originally written by Susan G. Kleinmann
+There is now a man page called groff_man.7 which documents the basics of
+the -man macros.  It has been originally written by Susan G. Kleinmann
 <sgk@debian.org>.
 
 A (still incomplete) groff reference manual in texinfo format originally
 contributed by Trent A. Fisher <trent@gnurd.portland.or.us>.
 
-me.man and msafer.man have been renamed to groff_me.man
-resp. groff_msafer.man for consistency.
+me.man and msafer.man have been renamed to groff_me.man resp.
+groff_msafer.man for consistency.
 
-Default strings for macros in doc-common resp. tmac.an no longer contain the
-word `UNIX'.
+Default strings for macros in doc-common resp. tmac.an no longer contain
+the word `UNIX'.
 
 groff should now be Y2k safe (fixes contributed by Paul Eggert
 <eggert@twinsun.com>).
@@ -2093,16 +2807,16 @@
 the default instead of replacing an existent groff binary.
 
 groff, troff, nroff, and pic now support the -U flag to activate unsafe
-behaviour (without -msafer); the -S flag for using the -msafer macros is now
-the default.
+behaviour (without -msafer); the -S flag for using the -msafer macros is
+now the default.
 
 Grohtml
 -------
 
-This is a new output device for producing HTML output contributed by Gaius
-Mulley <gaius@glam.ac.uk>.  It is still very alpha but has been included
-into the distribution so that a lot of people have a chance to test it.  Bug
-reports are highly welcome.
+This is a new output device for producing HTML output contributed by
+Gaius Mulley <gaius@glam.ac.uk>.  It is still very alpha but has been
+included into the distribution so that a lot of people have a chance to
+test it.  Bug reports are highly welcome.
 
 Grolj4
 ------
@@ -2135,29 +2849,29 @@
 
 Complete documentation for pic is now in the file doc/pic.ms.  It was
 contributed by Eric S. Raymond, <esr@thyrsus.com>, who is emphatically
-*not* volunteering to take over groff as he is way overworked with
-half a dozen other projects.
+*not* volunteering to take over groff as he is way overworked with half
+a dozen other projects.
 
 
 VERSION 1.10
 ============
 
 The directory where data files are installed has been changed from
-/usr/local/lib/groff to /usr/local/share/groff to comply with the
-latest GNU coding standards.
+/usr/local/lib/groff to /usr/local/share/groff to comply with the latest
+GNU coding standards.
 
-By default groff programs with Unix equivalents are installed with a
-"g" prefix unless there is an existing (non-groff) troff installation.
+By default groff programs with Unix equivalents are installed with a "g"
+prefix unless there is an existing (non-groff) troff installation.
 
-A new approach is used to make system macro packages available to
-groff.  Instead of simply including /usr/lib/tmac in the list of
-directories searched by groff, the installation process creates for
-each system macro package a wrapper macro package in the groff macro
-directory that references the system macro package.  The groff macro
-packages are now installed with a leading "g" prefix if there is a
-system version of the same macro package, and otherwise without the
-"g" prefix, with the exception that the groff version of -me which is
-always installed as -me.
+A new approach is used to make system macro packages available to groff.
+Instead of simply including /usr/lib/tmac in the list of directories
+searched by groff, the installation process creates for each system
+macro package a wrapper macro package in the groff macro directory that
+references the system macro package.  The groff macro packages are now
+installed with a leading "g" prefix if there is a system version of the
+same macro package, and otherwise without the "g" prefix, with the
+exception that the groff version of -me which is always installed as
+-me.
 
 There is a new device, lj4, for the HP LaserJet 4 (and PCL5
 compatibles).
@@ -2166,8 +2880,8 @@
 -----
 
 groff has a -S option that prevents the use of unsafe features in pic
-and troff.  This uses a new -S option of pic and the -msafer macros
-for troff.
+and troff.  This uses a new -S option of pic and the -msafer macros for
+troff.
 
 Troff
 -----
@@ -2189,11 +2903,10 @@
 VERSION 1.09
 ============
 
-\(rn now produces a character that has the traditional metrics,
-and form corners with \(ul and \(br.  This means that it does not
-align properly with \(sr.  Instead there's a new character
-\radicalex which aligns with \(sr; this is used by eqn for doing
-square roots.
+\(rn now produces a character that has the traditional metrics, and form
+corners with \(ul and \(br.  This means that it does not align properly
+with \(sr.  Instead there's a new character \radicalex which aligns
+with \(sr; this is used by eqn for doing square roots.
 
 Troff
 -----
@@ -2214,8 +2927,8 @@
 Troff
 -----
 
-The escape sequence \Vxxx interpolates the value of the
-environment variable xxx.
+The escape sequence \Vxxx interpolates the value of the environment
+variable xxx.
 
 Tbl
 ---
@@ -2232,7 +2945,7 @@
 -----
 
 The environment variable GROFF_COMMAND_PREFIX can be used to control
-whether groff looks for `gtroff' or `troff' (similarily for the
+whether groff looks for `gtroff' or `troff' (similarly for the
 preprocessors.)
 
 Troff
@@ -2251,16 +2964,16 @@
 Tbl
 ---
 
-There is a `nokeep' option which tells tbl not to use diversions to
-try to keep the table on one page.
+There is a `nokeep' option which tells tbl not to use diversions to try
+to keep the table on one page.
 
 Eqn
 ---
 
 Setting the parameter `nroff' to a non-zero value causes `ndefine' to
-behave like `define' and `tdefine' to be ignored.  This is done by
-eqnrc when the current device is ascii or latin1.  There's a `neqn'
-script that just does `eqn -Tascii'.
+behave like `define' and `tdefine' to be ignored.  This is done by eqnrc
+when the current device is ascii or latin1.  There's a `neqn' script
+that just does `eqn -Tascii'.
 
 Grotty
 ------
@@ -2286,31 +2999,32 @@
 Groff
 -----
 
-The Xps pseudo-device has disappeared.  Instead there is a new -X
-option that tells groff to use gxditview instead of the usual
-postprocessor. (So instead of -TXps, use -XTps or just -X if your
-default device is ps.)
-
-The postprocessor to be used for a particular device is now specified
-by a `postpro' command in the DESC file rather than being compiled
-into groff.  Similarly the command to be used for printing (with the
--l option) is now specified by a `print' command in the DESC file.
-
-The groff command no longer specifies eqnchar as an input file for
-eqn.  Instead eqn automatically loads a file `eqnrc'.  The groff
-command no longer passes the -D option to eqn.  Instead eqnrc sets the
-draw_lines parameter.
-
-The groff command no longer tells troff to load a device-specific
-macro file.  This is handled instead by the `troffrc' file, which is
-always loaded by troff.
+The Xps pseudo-device has disappeared.  Instead there is a new -X option
+that tells groff to use gxditview instead of the usual postprocessor.
+(So instead of -TXps, use -XTps or just -X if your default device is
+ps.)
+
+The postprocessor to be used for a particular device is now specified by
+a `postpro' command in the DESC file rather than being compiled into
+groff.  Similarly the command to be used for printing (with the -l
+option) is now specified by a `print' command in the DESC file.
+
+The groff command no longer specifies eqnchar as an input file for eqn.
+Instead eqn automatically loads a file `eqnrc'.  The groff command no
+longer passes the -D option to eqn.  Instead eqnrc sets the draw_lines
+parameter.
+
+The groff command no longer tells troff to load a device-specific macro
+file.  This is handled instead by the `troffrc' file, which is always
+loaded by troff.
 
 The shell script version of groff has been removed.
 
 Troff
 -----
 
-The `rchar' request removes a character definition established with `char'.
+The `rchar' request removes a character definition established with
+`char'.
 
 Compatibility mode is disabled and the escape character is set to `\'
 while a character definition is being processed.
@@ -2318,29 +3032,29 @@
 The `\#' escape sequence is like `\"' except that the terminating
 newline is ignored.
 
-The `shc' request tells troff which character to insert (instead of
-the default \(hy) when a word is hyphenated at a line break.
+The `shc' request tells troff which character to insert (instead of the
+default \(hy) when a word is hyphenated at a line break.
 
-A font name of 0 (zero) in the DESC file causes no font to be
-mounted on the corresponding font position.  This is useful for
-arranging that special fonts are mounted on positions on which users
-are not likely explicitly to mount fonts.  All groff devices now avoid
-initially mounting fonts on positions 5-9.
+A font name of 0 (zero) in the DESC file causes no font to be mounted on
+the corresponding font position.  This is useful for arranging that
+special fonts are mounted on positions on which users are not likely
+explicitly to mount fonts.  All groff devices now avoid initially
+mounting fonts on positions 5-9.
 
-The `do' request allows a single request or macro to be interpreted
-with compatibility mode disabled.
+The `do' request allows a single request or macro to be interpreted with
+compatibility mode disabled.
 
 troff automatically loads a file `troffrc' before any other input file.
-This can be prevented with the -R option.  This file is responsible
-for loading the device-specific macros.
+This can be prevented with the -R option.  This file is responsible for
+loading the device-specific macros.
 
 Pic
 ---
 
 The -x option has been removed and a -n option has been added.  By
 default, pic now assumes that the postprocessor supports groff
-extensions.  The -n option tells pic to generate output that works
-with ditroff drivers.  The -z option now applies only to TeX mode.
+extensions.  The -n option tells pic to generate output that works with
+ditroff drivers.  The -z option now applies only to TeX mode.
 
 The -p option has been removed. Instead if the -n option is not
 specified, pic generates output that uses \X'ps: ...' if the \n(0p
@@ -2353,11 +3067,11 @@
 ---
 
 Eqn now automatically reads a file `eqnrc' from the macro directory.
-This performs the same role that the eqnchar files used to.  This can
-be prevented by the -R option.
+This performs the same role that the eqnchar files used to.  This can be
+prevented by the -R option.
 
-Setting the draw_lines parameter to a non-zero value causes lines to
-be drawn using \D rather than \l.  The -D option is now obsolete.
+Setting the draw_lines parameter to a non-zero value causes lines to be
+drawn using \D rather than \l.  The -D option is now obsolete.
 
 `uparrow', `downarrow' and `updownarrow' can be used with `left' and
 `right'.
@@ -2369,15 +3083,15 @@
 Grops
 -----
 
-Font description files have been regenerated from newer AFM files.
-You can get access to the additional characters present in the text
-fonts in newer PostScript printers by using -mpsnew.
+Font description files have been regenerated from newer AFM files.  You
+can get access to the additional characters present in the text fonts in
+newer PostScript printers by using -mpsnew.
 
-The default value of the -b option is specified by a `broken' command
-in the DESC file.
+The default value of the -b option is specified by a `broken' command in
+the DESC file.
 
-With the -g option, grops generates PostScript code that guesses
-the page height.  This allows documents to be printed on both letter
+With the -g option, grops generates PostScript code that guesses the
+page height.  This allows documents to be printed on both letter
 (8.5x11) and A4 paper without change.
 
 Grodvi
@@ -2389,8 +3103,8 @@
 Grotty
 ------
 
-The -mtty-char macros contain additional character definitions for
-use with grotty.
+The -mtty-char macros contain additional character definitions for use
+with grotty.
 
 Macros
 ------
@@ -2398,20 +3112,19 @@
 In previous releases the groff -me macros treated the $r and $R number
 registers in a way that was incompatible with the BSD -me macros.  The
 reason for this was that the approach used by the BSD -me macros does
-not work with low resolution devices such as -TX75 and -TX100.
-However, this caused problems with existing -me documents.  In this
-release, the vertical spacing is controlled by the $v and $V registers
-which have the same meaning as $r and $R in earlier groff releases.
-In addition, if the $r or $R register is set to a value that would be
-correct for for the BSD -me macros and a low resolution device is not
-being used, then an appropriate value for the $v or $V register
-is derived from the $r or $R register.
+not work with low resolution devices such as -TX75 and -TX100.  However,
+this caused problems with existing -me documents.  In this release, the
+vertical spacing is controlled by the $v and $V registers which have the
+same meaning as $r and $R in earlier groff releases.  In addition, if
+the $r or $R register is set to a value that would be correct for the
+BSD -me macros and a low resolution device is not being used, then an
+appropriate value for the $v or $V register is derived from the $r or $R
+register.
 
 The groff -me macros work with -C and (I think) with Unix troff.
 
 For backward compatibility with BSD -me, the \*{ and \*} strings are
-also available as \* and \*.  Of course, \* is only usable
-with -C.
+also available as \* and \*.  Of course, \* is only usable with -C.
 
 The \*T string has been deleted.  Use \*(Tm instead.
 
@@ -2446,21 +3159,21 @@
 Grotty
 ------
 
-Horizontal and vertical lines drawn with \D'l ...' are rendered
-using -, | and + characters.  This is intended to give reasonable
-results with boxed tables.  It won't work well with pic.
+Horizontal and vertical lines drawn with \D'l ...' are rendered using -,
+| and + characters.  This is intended to give reasonable results with
+boxed tables.  It won't work well with pic.
 
 Macros
 ------
 
 The -mdoc macros have been upgraded to the version in the second
-Berkeley networking release.  This version is not completely
-compatible with earlier versions; the old version is still available
-as -mdoc.old.  The grog script has been enhanced so that it can
-usually determine whether a document requires the old or new versions.
+Berkeley networking release.  This version is not completely compatible
+with earlier versions; the old version is still available as -mdoc.old.
+The grog script has been enhanced so that it can usually determine
+whether a document requires the old or new versions.
 
-With -TX75, -TX100 and -TXps, the PSPIC macro produces a box
-around where the picture would appear with -Tps.
+With -TX75, -TX100 and -TXps, the PSPIC macro produces a box around
+where the picture would appear with -Tps.
 
 
 VERSION 1.04
@@ -2468,8 +3181,8 @@
 
 An implementation of the -mm macros is included.
 
-The directory in which temporary files are created can be controlled
-by setting the GROFF_TMPDIR or TMPDIR environment variables.
+The directory in which temporary files are created can be controlled by
+setting the GROFF_TMPDIR or TMPDIR environment variables.
 
 Pic
 ---
@@ -2479,10 +3192,9 @@
 Grops
 -----
 
-There are two new \X commands (\X'ps: invis' and \X'ps: endinvis')
-which make it possible to have substitute characters that are
-displayed when previewing with -TXps but ignored when printing with
-grops.
+There are two new \X commands (\X'ps: invis' and \X'ps: endinvis') which
+make it possible to have substitute characters that are displayed when
+previewing with -TXps but ignored when printing with grops.
 
 Xditview
 --------
@@ -2500,24 +3212,24 @@
 ============
 
 There is an implementation of refer and associated programs.  groff -R
-preprocesses with grefer; no mechanism is provided for passing
-arguments to grefer because most grefer options have equivalent
-commands which can be included in the file.  grog also supports refer.
+preprocesses with grefer; no mechanism is provided for passing arguments
+to grefer because most grefer options have equivalent commands which can
+be included in the file.  grog also supports refer.
 
 There is an alternative perl implementation of the grog script.
 
-The code field in lines in the charset section of font description
-files is now allowed to contain an arbitrary integer (previously it
-was required to lie between 0 and 255).  Currently grops and grodvi
-use only the low order 8 bits of the value.  Grodvi uses the
-complete value; however, this is unlikely to be useful with
-traditional TeX tools (.tfm files only allow 8 bit character codes.)
+The code field in lines in the charset section of font description files
+is now allowed to contain an arbitrary integer (previously it was
+required to lie between 0 and 255).  Currently grops and grodvi use only
+the low order 8 bits of the value.  Grodvi uses the complete value;
+however, this is unlikely to be useful with traditional TeX tools (.tfm
+files only allow 8 bit character codes.)
 
 Left and right double quotes can be obtained with \(lq and \(rq
 respectively.
 
-There is a new program called pfbtops which translates PostScript
-fonts in pfb format to ASCII.
+There is a new program called pfbtops which translates PostScript fonts
+in pfb format to ASCII.
 
 A slightly modified version of the Berkeley tmac.doc is included.
 
@@ -2525,13 +3237,13 @@
 -----
 
 In long escape names the closing  is now required to be at the same
-input level as the opening .
+interpolation depth as the opening .
 
 The \A'S' escape sequence returns 1 or 0 according as S is or is not
 suitable for use as a name.
 
-\~ produces an unbreakable space that can be stretched when the line
-is adjusted.
+\~ produces an unbreakable space that can be stretched when the line is
+adjusted.
 
 The `mso' request is like the `so' request except that it searches for
 the file in the same directories in which tmac.X is searched for when
@@ -2554,9 +3266,9 @@
 -----
 
 The compile-time -DBROKEN_SPOOLER option has been replaced by a
-BROKEN_SPOOLER_FLAGS option.  This allows more precise control over
-how grops should workaround broken spoolers and previewers.  There is
-a new -b option that can change this at run-time.
+BROKEN_SPOOLER_FLAGS option.  This allows more precise control over how
+grops should workaround broken spoolers and previewers.  There is a new
+-b option that can change this at run-time.
 
 Grops now generates PostScript that complies with version 3.0 of the
 Document Structuring Convention.
@@ -2575,8 +3287,7 @@
 --------
 
 Parts of xditview have been rewritten so that it can be used with the
-output of gtroff -Tps.  groff -TXps runs gtroff -Tps with
-gxditview.
+output of gtroff -Tps.  groff -TXps runs gtroff -Tps with gxditview.
 
 There is a new menu entry `Print' which brings up a dialog box for
 specifying a command with which the file being previewed should be
@@ -2590,20 +3301,20 @@
 
 The groff command now understands the gtroff `-a' and `-i' options.
 
-With the `m' and `n' scale indicators, the scale factor is rounded
+With the `m' and `n' scaling indicators, the scale factor is rounded
 horizontally before being applied.  This makes (almost) no difference
 for devices with `hor' equal to 1, but it makes groff with -Tascii or
 -Tlatin1 behave more like nroff in its treatment of these scale
-indicators.  Accordingly tmac.tty now calls the `nroff' request so
-that the `n' condition is true.
+indicators.  Accordingly tmac.tty now calls the `nroff' request so that
+the `n' condition is true.
 
-The device-specific macros (tmac.ps, tmac.dvi, tmac.tty and tmac.X)
-have been made to work at least somewhat with -C.  In particular the
-special characters defined by these macros now work with -C.
-
-groff -Tdvi -p now passes pic the -x flag; this enables filling
-of arrowheads and boxes, provided that your dvi driver supports the
-latest version of the tpic specials.
+The device-specific macros (tmac.ps, tmac.dvi, tmac.tty and tmac.X) have
+been made to work at least somewhat with -C.  In particular the special
+characters defined by these macros now work with -C.
+
+groff -Tdvi -p now passes pic the -x flag; this enables filling of
+arrowheads and boxes, provided that your dvi driver supports the latest
+version of the tpic specials.
 
 Eqn
 ---
@@ -2615,8 +3326,8 @@
 Grops
 -----
 
-You can now use psfig with grops.  See the file ps/psfig.diff.  I do
-not recommend using psfig for new documents.
+You can now use psfig with grops.  See the file ps/psfig.diff.  I do not
+recommend using psfig for new documents.
 
 The command \X'ps: file F' is similar to \X'ps: exec ...' except that
 the PostScript code is read from the file F instead of being contained
@@ -2630,13 +3341,13 @@
 Macros
 ------
 
-The groff -me macros now work with the -C option.  As a result, they
-may also work with Unix nroff/troff.
+The groff -me macros now work with the -C option.  As a result, they may
+also work with Unix nroff/troff.
 
-In -me, the $r and $R number registers now contain the line spacing as
-a percentage of the pointsize expressed in units (normally about 120).
-The previous definition was useless with low resolution devices such
-as X75 and X100.
+In -me, the $r and $R number registers now contain the line spacing as a
+percentage of the pointsize expressed in units (normally about 120).
+The previous definition was useless with low resolution devices such as
+X75 and X100.
 
 
 VERSION 1.00
@@ -2644,8 +3355,8 @@
 
 A -ms-like macro-package is now included.
 
-The name for the Icelandic lowercase eth character has been changed
-from \(-d to \(Sd.
+The name for the Icelandic lowercase eth character has been changed from
+\(-d to \(Sd.
 
 Troff
 -----
@@ -2653,8 +3364,8 @@
 There is a new request `nroff', which makes the `n' built-in condition
 true and the `t' built-in condition false; also a new request `troff'
 which undoes the effect of the `nroff' request.  This is intended only
-for backward compatibility: it is usually better to test \n(.H or
-\n(.V or to use the `c' built-in condition.
+for backward compatibility: it is usually better to test \n(.H or \n(.V
+or to use the `c' built-in condition.
 
 The \R escape sequence has been deleted.  Use \E instead.
 
@@ -2662,29 +3373,28 @@
 request.
 
 There is a request `hym' that can ensure that when the current
-adjustment mode is not `b' a line is not hyphenated if it is no
-more than a given amount short, and a request `hys' that can ensure
-that when the current adjustment mode is `b' a line is not
-hyphenated if it can be justified by adding no more than a given
-amount of extra space to each word space.
+adjustment mode is not `b' a line is not hyphenated if it is no more
+than a given amount short, and a request `hys' that can ensure that when
+the current adjustment mode is `b' a line is not hyphenated if it can be
+justified by adding no more than a given amount of extra space to each
+word space.
 
 There is a request `rj' similar to `ce' that right justifies lines.
 
-A warning of type `space' is given when a call is made to an
-undefined request or macro with a name longer than two characters, and
-the first two characters of the name make a name that is defined.
-This is intended to find places where a space has been omitted been a
-request or macro and its argument.  This type of warning is enabled by
-default.
+A warning of type `space' is given when a call is made to an undefined
+request or macro with a name longer than two characters, and the first
+two characters of the name make a name that is defined.  This is
+intended to find places where a space has been omitted been a request or
+macro and its argument.  This type of warning is enabled by default.
 
 Pic
 ---
 
 A comma is permitted between the arguments to the `reset' command.
 
-For use with TeX, there is a new `-c' option that makes gpic treat
-lines beginning with `.' in a way that is more compatible with tpic
-(but ugly).
+For use with TeX, there is a new `-c' option that makes gpic treat lines
+beginning with `.' in a way that is more compatible with tpic (but
+ugly).
 
 Eqn
 ---
@@ -2700,8 +3410,8 @@
 --------
 
 There are two new devices X75-12 and X100-12 which are the same as X75
-and X100 except that they are optimized for documents that use mostly
-12 point text.
+and X100 except that they are optimized for documents that use mostly 12
+point text.
 
 
 VERSION 0.6
@@ -2725,35 +3435,33 @@
 The drivers now all support the `N' command required for this.  The font
 description files have been updated to include unnamed characters.
 
-The `x' command in font description files has been removed: instead
-any unknown commands are automatically made available to the drivers.
-If you constructed your own font files with an earlier version of
-tfmtodit or afmtodit, you must construct them again using the current
-version.
+The `x' command in font description files has been removed: instead any
+unknown commands are automatically made available to the drivers.  If
+you constructed your own font files with an earlier version of tfmtodit
+or afmtodit, you must construct them again using the current version.
 
 Characters between 0200 and 0237 octal are no longer valid input
 characters.  Note that these are not used in ISO 8859.
 
-A command called `grog' has been added, similar to the `doctype'
-command described in Kernighan and Pike.
+A command called `grog' has been added, similar to the `doctype' command
+described in Kernighan and Pike.
 
 Groff
 -----
 
-The groff command has some new options: -V prints the pipeline
-instead of executing it; -P passes an argument to the postprocessor,
--L passes an argument to the spooler.
+The groff command has some new options: -V prints the pipeline instead
+of executing it; -P passes an argument to the postprocessor, -L passes
+an argument to the spooler.
 
 There is a C++ implementation of the groff command.  This handles some
 things slightly better than the shell script.  In particular, it can
 correctly handle arguments containing characters that have a special
-meaning to the shell; it can give an error message when child
-processes other than the last in the pipeline terminate abnormally;
-its exit status can take account of the exit statuses of all its child
-processes; it is a little more efficient; when geqn is used, it
-searches for the eqnchar file in the same way that font metric files
-are searched for, rather than expecting to find it in one particular
-directory.
+meaning to the shell; it can give an error message when child processes
+other than the last in the pipeline terminate abnormally; its exit
+status can take account of the exit statuses of all its child processes;
+it is a little more efficient; when geqn is used, it searches for the
+eqnchar file in the same way that font metric files are searched for,
+rather than expecting to find it in one particular directory.
 
 Gtroff
 ------
@@ -2761,20 +3469,19 @@
 There is font translation feature: For example, you can tell gtroff to
 use font `HR' whenever font `H' is requested with the line
   .ftr H HR
-This would be useful for a document that uses `H' to refer to
-Helvetica.
+This would be useful for a document that uses `H' to refer to Helvetica.
 
 There are some new number registers: `.kern' contains the current kern
 mode, `.lg' the current ligature mode, `.x' the major version number,
-`.y' the minor version number, `.ce' the number of lines to be
-centered in the current environment, `.trunc' the amount of vertical
-space truncated by the most recently sprung vertical position trap,
-`.ne' the amount of vertical space needed in the last `ne' request
-that caused a vertical position trap to be sprung.
+`.y' the minor version number, `.ce' the number of lines to be centered
+in the current environment, `.trunc' the amount of vertical space
+truncated by the most recently sprung vertical position trap, `.ne' the
+amount of vertical space needed in the last `ne' request that caused a
+vertical position trap to be sprung.
 
 The `cf' request now behaves sensibly in a diversion.  If used in a
-diversion, it now arranges for the file to be copied to the output
-when the diversion is reread.
+diversion, it now arranges for the file to be copied to the output when
+the diversion is reread.
 
 There is a new request `trf' (transparent file) similar to `cf', but
 more like `\!'.
@@ -2790,10 +3497,11 @@
 There is a new warning category `escape' which warns about unknown
 escape sequences.
 
-The `fp' request now takes an optional third argument giving the external
-name of the font.
+The `fp' request now takes an optional third argument giving the
+external name of the font.
 
-The `\_' character is now automatically translated to `\(ul' as in troff.
+The `\_' character is now automatically translated to `\(ul' as in
+troff.
 
 The environment variable `GROFF_HYPHEN' gives the name of the file
 containing the hyphenation patterns.
@@ -2803,17 +3511,17 @@
 Characters ", ', ), , *, \(dg are now initially transparent for the
 purposes of end of sentence recognition.
 
-There is an anti-recursion feature in the `char' request, so you can
-say `.char \(bu \s+2\(bu\s-2'.
+There is an anti-recursion feature in the `char' request, so you can say
+`.char \(bu \s+2\(bu\s-2'.
 
-The limit on the number of font positions has been removed.
-Accordingly `\n.fp' never returns 0.
+The limit on the number of font positions has been removed.  Accordingly
+`\n.fp' never returns 0.
 
 The restriction on the number of numbered environments has been removed.
 
-There is a new escape sequence `\E' that makes it possible to
-guarantee that an escape sequence won't get interpreted in copy-mode.
-The `\R' escape sequence is accordingly now deprecated.
+There is a new escape sequence `\E' that makes it possible to guarantee
+that an escape sequence won't get interpreted in copy-mode.  The `\R'
+escape sequence is accordingly now deprecated.
 
 Gpic
 ----
@@ -2821,28 +3529,26 @@
 Arguments of the form `X anything X' (in the `copy thru', `sh', `for',
 `if' and `define' constructs) can now be of the form `{ anything }'.
 
-If the `linethick' variable is negative (as it now is initially),
-lines are drawn with a thickness proportional to the current point
-size.
+If the `linethick' variable is negative (as it now is initially), lines
+are drawn with a thickness proportional to the current point size.
 
 The `rand' function now takes no arguments and returns a number between
 0 and 1.  The old syntax is still supported.
 
 `^' can be used in expressions to indicate exponentiation.
 
-In the `for' construct the argument to the by clause can be prefixed
-by `*' to indicate that the increment is multiplicative.
+In the `for' construct the argument to the by clause can be prefixed by
+`*' to indicate that the increment is multiplicative.
+
+A bare expression may be used as an attribute.  If the current direction
+is `dir', then an attribute `expr' is equivalent to `dir expr'
 
-A bare expression may be used as an attribute.  If the current
-direction is `dir', then an attribute `expr' is equivalent to
-`dir expr'
-
-There is a `sprintf' construct that allows numbers to be formatted and used
-wherever a quoted string can be used.
-
-The height of a text object without an explicit height attribute is
-the number of text strings associated with the object times the value
-of the `textht' variable.
+There is a `sprintf' construct that allows numbers to be formatted and
+used wherever a quoted string can be used.
+
+The height of a text object without an explicit height attribute is the
+number of text strings associated with the object times the value of the
+`textht' variable.
 
 The maximum height and width of a picture is controlled by the
 `maxpswid' and `maxpsht' variables.
@@ -2850,38 +3556,39 @@
 Gtbl
 ----
 
-Gtbl can now handle gracefully the situation where the `ce' request
-has been applied to a table.
+Gtbl can now handle gracefully the situation where the `ce' request has
+been applied to a table.
 
 Geqn
 ----
 
 The `ifdef' primitive has been generalized.
 
-A tilde accent can be put underneath a box using `utilde'.  This
-defined using a general `uaccent' primitive.
+A tilde accent can be put underneath a box using `utilde'.  This defined
+using a general `uaccent' primitive.
 
 Grops
 -----
 
 There is a new PostScript font downloading scheme which handles font
 downloading for imported illustrations.  Previously, the name of the
-file containing the font was given in the `x download' line in the
-groff font metric file.  Now, there is a `download' file which says
-for each PostScript font name which file contains that font.  Grops
-can also now handle inter-font dependencies, where one downloadable
-font depends on some other (possibly downloadable) font.
+file containing the font was given in the `x download' line in the groff
+font metric file.  Now, there is a `download' file which says for each
+PostScript font name which file contains that font.  Grops can also now
+handle inter-font dependencies, where one downloadable font depends on
+some other (possibly downloadable) font.
 
 The `T' font has been removed.  The characters it used to provide are
-now provided by `char' definitions in tmac.ps. TSymbol.ps has also
-been removed, and the tweaks it provided are now provided by `char'
+now provided by `char' definitions in tmac.ps. TSymbol.ps has also been
+removed, and the tweaks it provided are now provided by `char'
 definitions.
 
-##### Emacs
+
+##### Editor settings
 Local Variables:
-version-control: never
 coding: latin-1
-fill-column: 76
+fill-column: 72
 mode: text
+version-control: never
 End:
-# vim: set autoindent textwidth=76:
+# vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/PROBLEMS -> _service:tar_scm:groff-1.23.0.tar.gz/PROBLEMS Changed

@@ -1,4 +1,4 @@
-    Copyright 1989-2018 Free Software Foundation, Inc.
+    Copyright 1989-2023 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -10,126 +10,171 @@
 
 ----------------------------------------------------------------------
 
+Problems are organized into categories underscored with equals signs.
 
+* General Problems
+* Printing and Display Problems
+* Platform-Dependent Macro Problems
+* Compilation Problems
 
-Generic Problems
+Within each category, items are organized in reverse chronological order
+(that is, with the most recent first).  groff version numbers
+corresponding to their inclusion in this file are included as
+guideposts.  Entries have been revised for clarity in the years since.
+
+In the following discussions, several references to "/usr/local" are
+made.  You should read this directory name as the destination directory
+you set up with the "--prefix" option to groff's "configure" script.
+
+
+General Problems
 ================
 
 
+groff 1.23.0
+
+* gdiffmk doesn't work / its automated test fails.
 
-* Displaying a man page on a terminal with/without my favourite pager
-  only gives garbage.
+Some portability issues are known to affect groff's gdiffmk utility.
 
-groff by default now uses SGR escape sequences (`ANSI color') to
-control the display attributes (bold, underlined, colour) on TTYs.
-Some terminals (e.g. `kterm') don't understand SGR, and some pagers
-(e.g. older versions of `less' or `less' without the -R option) don't
-understand SGR either.  There are three solutions to fix this, in
-order of preference; please read the grotty man page for more details.
+- A defect in GNU diffutils 3.9 (January 2023) causes gdiffmk to
+  malfunction and its automated test to fail.  See
+  <https://debbugs.gnu.org/db/61/61193.html>.
 
-The fourth and probably best option is to update your terminal program
-and pager to versions which can handle SGR.
+- gdiffmk does not work with BusyBox diff (which does not implement GNU
+  diff's "-D" option).
 
-  1. Set the GROFF_NO_SGR environment variable.
+- gdiffmk does not work on FreeBSD due to specifics of that platform's
+  expr(1) implementation.
 
-  2. Pass option `-c' to grotty (this is, add `-P-c' to groff's
-     command line options).
+  gdiffmk uses the expr(1) command to parse its arguments.  FreeBSD has
+  extended the syntax of its expr command in a non-backward compatible
+  way that it claims better conforms with POSIX's utility syntax
+  guidelines with respect to option processing: however, POSIX mandates
+  no options for expr.  Other implementations of expr do not support
+  traditional Unix-style options ('-a', '-b', ...), and perhaps as a
+  consequence do not follow FreeBSD's interpretation of the guidelines.
+  You way want to set $EXPR_COMPAT in your shell environment.  We hope
+  to have a workaround for this behavior in a future release.
 
-  3. Append the following fragment to the `troffrc' file:
+----------------------------------------------------------------------
 
+* The `PDFPIC` macro doesn't work / its automated test fails.
 
---- start ---
-.if n \{\
-.  nr _C \n(.C
-.  cp 0
-.
-.  \" The following code sets a top-of-page trap to disable grotty's TTY
-.  \" mode.  Since neither \X nor .output can be used before the first
-.  \" page has started, we must use a trap.  To make it work with troff's
-.  \" -o option, we wait until the first printed page.
-.
-.  de sgr@dummy
-.  .
-.
-.  rn wh wh@old
-.
-.  \" The stand-alone version.  If no other trap is set, we can safely
-.  \" insert the truncated vertical space caused by the trap (if any).
-.  \" Otherwise we assume that the document's main macro package takes
-.  \" care of that.  As soon as the trap has been executed, it is removed.
-.  de1 no@sgr
-.    if \\n.P \{\
-.      if (\\n.t == \\n.p) \{\
-.        rn wh@old wh
-.        rm no@sgr
-.        wh 0
-.        sp \\n.trunc
-.        nop \X'tty: sgr 0'
-.        sp -1
-.    \}\}
-.  .
-.
-.  wh@old 0 no@sgr
-.
-.  \" The piggyback version to be appended to macros planted with the
-.  \" modified `wh' request.
-.  de1 no@sgr1
-.    if \\n.P \{\
-.      rn wh@old wh
-.      ds no@sgr1
-.      nop \X'tty: sgr 0'
-.      sp -1
-.    \}
-.  .
-.
-.  \" We redefine the `wh' request so that `no@sgr1' is appended to
-.  \" the trap macro.
-.  de1 wh
-.    am1 \\$2 sgr@dummy
-.      no@sgr1
-.    sgr@dummy
-.    wh@old \\$1 \\$2
-.  .
-.
-.  cp \n_C
-.\}
---- end ---
+  FAIL: tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh
+
+Due to a limitation (shared by AT&T troff) in the way the `sy` request
+constructs a C string argument to the C library's system(3) function,
+groff requires a GNU sed(1) extension that interprets "\n" as a newline
+in the replacement text of the 's' command.  (We might enhance GNU
+troff's `sy` request to avoid this dependency in the future.)  We have
+observed this problem on Solaris 10 and 11 and Mac OS X 10.11.6, but not
+macOS 12: the last's sed supports the extension in question.
+
+Install GNU sed in the default $PATH as "gsed" and edit
+tmac/pdfpic.tmac.  On line 172, change "sed" to "gsed".  Alternatively,
+you can use the absolute path to GNU sed's location.  (`system()`
+sanitizes $PATH to avoid privilege escalation.)  Then (re-)make the
+"check" target or format your PDFPIC-employing document again.
 
 ----------------------------------------------------------------------
 
-* The UTF-8 output of grotty has strange characters for the minus, the
-  hyphen, and the right quote.  Why?
+groff 1.19.2
+
+* When viewing man pages, some characters on my UTF-8 terminal emulator
+  look funny or copy-and-paste wrong.  Why?
+
+Some Unicode Basic Latin ("ASCII") input characters are mapped to
+non-Basic Latin code points in output for consistency with other output
+devices, like PDF.  See groff_man_style(7) and groff_char(7) for correct
+input conventions and background.  If you use the correct groff special
+character escape sequences to input them, you will get correct output no
+matter what device the input is formatted for.
 
-The used Unicode characters (U+2212 for the minus sign and U+2010 for
-the hyphen) are the correct ones, but many programs can't search them
-properly.  The same is true for the right quote (U+201D).  To map
-those characters back to the ASCII characters, insert the following
-code snippet into the `troffrc' configuration file:
+However, many man pages are written in ignorance of the correct special
+characters to obtain the desired glyphs.  You can conceal these errors
+by adding the following to your site-local man(7) configuration.  The
+file is called "man.local"; its installation directory depends on how
+groff was configured when it was built.
 
+--- start ---
 .if '\*.T'utf8' \{\
-.  char \- \N'45'
-.  char  - \N'45'
-.  char  ' \N'39'
+.  char ' \aq
+.  char - \-
+.  char ^ \ha
+.  char ` \ga
+.  char ~ \ti
 .\}
+--- end ---
 
-----------------------------------------------------------------------
+You may also wish to do the same for "mdoc.local".
+
+In man pages (only), groff maps the minus sign special character '\-' to
+the Basic Latin hyphen-minus (U+002D) because man pages require this
+glyph and there is no historically established *roff input character,
+ordinary or special, for obtaining it when a hyphen and minus sign are
+both separately available.  To obtain a true minus sign, use the special
+character escape sequences '\(mi' or '\mi'.
 
-* Processing mdoc man pages like `groff_mdoc.n' fails if I use
-  `test-groff'.  Why?
+----------------------------------------------------------------------
 
-The mdoc package works only after installation, not with test-groff.
-Reason is that the macro files of mdoc get stripped off the `doc-'
-prefix before they are copied to the final destination.
+* Displaying a man page on a terminal with/without my favorite pager
+  shows garbage.
+
+groff's terminal output driver, grotty, by default uses ISO 6429/ECMA-48
+escape sequences understood by video terminals and their emulators,
+rather than the overstriking sequences implemented for typewriter-like
+terminals used in the 1960s and 1970s.  These escape sequences control
+display attributes like bold and italic or oblique typefaces,
+underlining, foreground and background color selection, and hyperlink
+marking.  Terminal emulators that claim compatibility with the DEC
+VT100, Linux console driver, or xterm should ignore well-formed escape
+sequences that they are not able to support, but some implementations
+are buggy.
+
+Furthermore, the popular "less" pager by default assumes that its input
+will use overstriking sequences.  (This is a surprising choice, as users
+of paper terminals had no need for pager programs; to "scroll back", the
+operator would simply physically pull up the spool of ejected paper to
+read it.)  less(1) must instead be given the '-R' option to interpret
+escape sequences used by video terminals.  Be aware that the
+overstriking convention is inescapably ambiguous in some output
+sequences.  See the grotty(1) man page.
+
+Hyperlink support in terminal emulators is a relatively new initiative
+(as of 2022) employing a sequence known as "OSC 8".
+  https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda
+
+Due to the feature's young age, the man and mdoc macro packages have a
+configuration switch for hyperlink support, and it may be disabled in
+your site's man.local and mdoc.local files.  Use a command like
+  printf '\0338;;man:grotty(1)\033\\grotty(1)\0338;;\033\\\n' | more
+to check your terminal and pager for OSC 8 support.  If you see
+"grotty(1)" and no additional garbage characters, then you may wish to
+edit those site files to remove any lines that disable this feature.
+
+There are a couple of workarounds if you prefer or require overstriking
+sequences rather than ISO 6429/ECMA-48 escape sequences.
+
+  1. Set the GROFF_NO_SGR environment variable to any value.
+
+  2. Pass option '-c' to grotty (that is, add '-P-c' to groff's
+     command-line options).
+
+The third and probably best option is to use terminal and pager programs
+that handle standardized video terminal escape sequences well.
 
 ----------------------------------------------------------------------
 
+groff 1.16
+
 * My document says that the current year is 19100, not 2000.
 
 In groff, as in traditional troff, the yr number register yields the
-year minus 1900.  Unfortunately, there is a longstanding bug in the
-Troff User's Manual <http://cm.bell-labs.com/cm/cs/cstr/54.ps.gz>,
-which incorrectly claims that yr is the last two digits of the year.
-This claim was never true of either Unix troff or of groff.
+year minus 1900.  Unfortunately, the Bell Labs document "Troff User's
+Manual" (Computing Science Technical Report #54) incorrectly claims that
+yr is the last two digits of the year.  This claim has never been true
+AT&T troff nor of groff.
 
 If your text looks like this:
 
@@ -147,94 +192,7 @@
 
 ----------------------------------------------------------------------
 
-* groff can't handle my troff document.  It works fine with AT&T
-  troff.
-
-Read the section on incompatibilities in groff_diff(7).  Try using the
--C option.  Alternatively there's the sed script `tmac/fixmacros.sed'
-which attempts to edit a file of macros so that it can be used with
-groff without the -C flag.
-
-----------------------------------------------------------------------
-
-* gtroff doesn't understand lines like `.ce99' with no space between
-  the name of the request or macro and the arguments.
-
-gtroff requires a space between macro or request and its arguments
-because it allows the use of long names for macros and requests.  You
-can use the -C option or the `cp' request to put gtroff into a
-compatibility mode in which it is not possible to use long names for
-macros but in which no space is required between macros and their
-arguments.  The use of compatibility mode is strongly discouraged.
-
-----------------------------------------------------------------------
-
-* groff -Tdvi produces dvi files that use fonts at weird
-  magnifications.
-
-Yes, it does.  You may need to compile fonts with Metafont at these
-magnifications.  The CompileFonts script in the devdvi/generate
-directory may help you to do this.  (It takes a *long* time on slow
-computers.)
-
-----------------------------------------------------------------------
-
-* Groff doesn't use the font names I'm used to.
-
-Use the `ftr' request.  See groff_diff(7).
-
-----------------------------------------------------------------------
-
-* gpic output is not centered horizontally; pictures sometimes run off
-  the bottom of the page.
-
-The macro package you are using is not supplying appropriate
-definitions of PS and PE.  Give groff a -mpic option.
-
-----------------------------------------------------------------------
-
-* gpic doesn't accept the syntax `chop N M' for chopping both ends of
-  a line.
-
-The correct syntax is `chop N chop M'.
-
-----------------------------------------------------------------------
-
-* With gpic -t, when I print `line ->; box' using a dvi to ps program,
-  the arrow head sticks through into the inside of the box.
-
-The dvi to ps program should be modified to set the line cap and line
-join parameters to 1 while printing tpic specials.
-
-----------------------------------------------------------------------
-
-* gtroff gives warnings about lines like
-  .ev	\" a comment
-  (with a tab after the .ev).
-
-A tab character cannot be used as a substitute for a space character
-(except in one case: between a control character at the beginning of a
-line and the name of a macro or request).  For example, in Unix troff
-
-  .ps	\" restore the previous point size
-
-(with a tab after the .ps) does NOT restore the previous point-size;
-instead it is silently ignored.  Since this is very likely to be an
-error, gtroff can give a warning about it.  If you want to align
-comments, you can do it like this:
-
-  .ev\"				\" a comment
-
-----------------------------------------------------------------------
-
-* I don't like the page headers and footers produced by groff -man.
-
-There seem to be many different styles of page header and footer
-produced by different versions of the -man macros.  You need to put
-modified macros from tmac/an-old.tmac into man.local.  More
-information is available in groff_man(7).
-
-----------------------------------------------------------------------
+groff 1.09
 
 * Where can I get grap?
 
@@ -250,36 +208,26 @@
   them to the height and depth of its argument, but the registers
   always seem to be 0.
 
-\n(st and \n(sb aren't supposed to give the height and depth of the
-string rather they give the minimum and maximum vertical displacement
-of the baseline.  For example for \v'2u'\v'-3u', \n(st is 1 and \n(sb
-is -2.  The height and depth of the string is available in the \nrst
-and \nrsb registers: these are groff extensions.
-
-----------------------------------------------------------------------
-
-* While formatting a manual page, groff complains about not being able
-  to break lines.  The problem seems to be caused by a line like:
-  .TP \w'label'+2
-
-The -man documentation says that the default scale indicator for TP
-macro is `n'.  The groff -man macros implement this correctly, so that
-the argument is evaluated as if it were
-
-  \w'label'n+2n
-
-The Unix -man macros don't implement this correctly (probably because
-it's hard to do in Unix troff); they just append `n' to the entire
-argument, so that it is evaluated as if it were
+\n(st and \n(sb don't give the height and depth of the argument to \w,
+but the maximum vertical displacements of the text baseline above
+(\n(st) and below (\n(sb) its original position.  Consider an example
+where no text is formatted, but small vertical motions are used.
 
-  \w'label'u+2n
+  \w"\v'-1u'\v'3u'"
+  .tm st=\n(st, sb=\n(sb
+    st=1, sb=-2
 
-The solution is to fix the manual page:
+Observe that the sign convention of these registers is opposite that of
+relative vertical motion.  (This is how Documenter's Workbench troff
+and Heirloom Doctools troff work as well.)
 
-  .TP \w'label'u+2
+The height and depth of formatted text in the \w argument are available
+in the \nrst and \nrsb registers; these are groff extensions.
 
 ----------------------------------------------------------------------
 
+groff 1.08
+
 * I'm having problems formatting man pages produced by the perl
   wrapman script.
 
@@ -361,6 +309,8 @@
 
 ----------------------------------------------------------------------
 
+groff 1.07
+
 * groff uses up an enormous amount of memory processing large files.
   I'm using 386BSD 0.1.
 
@@ -396,129 +346,166 @@
         else
   	exprstmt = 0;
 
+----------------------------------------------------------------------
 
+groff 1.06
 
-Printing and Display Problems
-=============================
-
+* groff can't handle my troff document.  It works fine with AT&T
+  troff.
 
+Read the section on incompatibilities in groff_diff(7).  Try using the
+-C option.  Alternatively there's the sed script `tmac/fixmacros.sed'
+which attempts to edit a file of macros so that it can be used with
+groff without the -C flag.
 
-* I'm having problems including PostScript illustrations (EPS) using
-  the PSPIC macro and/or \X'ps: import ...'.
+----------------------------------------------------------------------
 
-A PostScript document must meet three requirements in order to be
-included with the PSPIC macro: it must comply with the Adobe Document
-Structuring Conventions; it must contain a BoundingBox line; it must
-be `well-behaved'.  The BoundingBox line should be of the form:
+* groff -Tdvi produces dvi files that use fonts at weird
+  magnifications.
 
-  %%BoundingBox: llx lly urx ury
+Yes, it does.  You may need to compile fonts with Metafont at these
+magnifications.  The CompileFonts script in the devdvi/generate
+directory may help you to do this.  (It takes a *long* time on slow
+computers.)
 
-where llx, lly, urx, ury are the coordinates of the lower left x,
-lower left y, upper right x, upper right y of the bounding box of
-marks on the page expressed as integers in the default PostScript
-coordinate system (72 units per inch, origin at bottom left corner).
+----------------------------------------------------------------------
 
-The most convenient program to get the bounding box of a document is
-the `ps2epsi' script coming with GhostScript.
+groff 1.01
 
-If you can't use this program, another useful tactic is to print out
-the illustration by itself (you may need to add a `showpage' at the
-end), and physically measure the bounding box.  For more detail on
-these requirements, read the specification of Encapsulated PostScript
-format.  (This is available from the Adobe file server; send a message
-with a body of `help' to ps-file-server@adobe.com.)
+* gpic output is not centered horizontally; pictures sometimes run off
+  the bottom of the page.
 
-If an EPS file to be included via \X'ps: import' does not start with
-`%!PS-Adobe-...', gtroff still includes the file, but grops does not
-add any fonts to the generated output file that are listed in the EPS
-file, even though the files are listed in the `download' file and are
-available in the devps directory.
+The macro package you are using is not supplying appropriate
+definitions of PS and PE.  Give groff a -mpic option.
 
 ----------------------------------------------------------------------
 
-* I've configured groff for A4 paper, but gtroff still seems to think
-  that the length of a page (as returned by `\n(.p') is 11 inches.
+* Groff doesn't use the font names I'm used to.
 
-This is intentional.  The PAGE option during configuration is used
-only by grops.  For compatibility with ditroff, the default page
-length in gtroff is always 11 inches.  The page length can be changed
-with the `pl' request.
+Use the `ftr' request.  See groff_diff(7).
 
-A convenient way to set paper dimensions is to use the -dpaper option
-of groff, together with proper -P options for the postprocessor
-(overriding the default).  For example, use the following for PS
-output on A4 paper in landscape orientation:
+----------------------------------------------------------------------
 
-  groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+* I get errors using the Unix -ms macros with groff -e -C.
+
+Apply this change.  Be careful of copying and pasting it; literal BEL
+characters (Control+G) appear in the source--this is an AT&T troff idiom
+in output comparisons that is never necessary in GNU troff.
 
-See groff_tmac(5) for more information.
+*** /usr/lib/ms/ms.eqn	Tue Apr 25 02:14:28 1989
+--- ms.eqn	Sun Nov 11 10:33:59 1990
+***************
+*** 22,29 ****
+  ..
+  .	\" EN - end of a displayed equation
+  .de EN
+! .if !&#x7;\\*(10&#x7;&#x7; .br
+  .di
+  .rm EZ
+  .nr ZN \\n(dn
+  .if \\n(ZN>0 .if \\n(YE=0 .LP
+--- 22,30 ----
+  ..
+  .	\" EN - end of a displayed equation
+  .de EN
+! .if \\n(.k>0 .br
+  .di
++ .ds 10 \\*(EZ\\
+  .rm EZ
+  .nr ZN \\n(dn
+  .if \\n(ZN>0 .if \\n(YE=0 .LP
 
 ----------------------------------------------------------------------
 
-* When I print the output of groff -Tps, the output is always shifted
-  up by about 0.7 inches; I'm using 8.5x11 inch paper.
+* gpic doesn't accept the syntax `chop N M' for chopping both ends of
+  a line.
 
-Make sure that the paper size is `letter'.  See groff_tmac(5).
+The correct syntax is `chop N chop M'.
 
 ----------------------------------------------------------------------
 
-* When I try to run gxditview, I get the error:
-  Error: Widget viewport has zero width and/or height
-
-This error means you haven't correctly installed the application
-defaults file, GXditview.ad; `make install' does this for you
-automatically, so either you didn't do `make install', or you haven't
-passed a good `--appresdir=<DIR>' argument to groff's configure
-script.
+* With gpic -t, when I print `line ->; box' using a dvi to ps program,
+  the arrow head sticks through into the inside of the box.
 
-See the X(7) man page for information how and where application
-resource files have to be located.  Look for the XAPPLRESDIR and
-XUSERFILESEARCHPATH environment variables.
+The dvi to ps program should be modified to set the line cap and line
+join parameters to 1 while printing tpic specials.
 
 ----------------------------------------------------------------------
 
-* When I preview documents using -TX75 or -TX100, the layout is not
-  the same as when I print the document with -Tps: the line and page
-  breaks come in different places.
+* gtroff doesn't understand lines like `.ce99' with no space between
+  the name of the request or macro and the arguments.
 
-Use `groff -X -Tps'.
+gtroff requires a space between macro or request and its arguments
+because it allows the use of long names for macros and requests.  You
+can use the -C option or the `cp' request to put gtroff into a
+compatibility mode in which it is not possible to use long names for
+macros but in which no space is required between macros and their
+arguments.  The use of compatibility mode is strongly discouraged.
 
 ----------------------------------------------------------------------
 
-* When I try to print the output of groff -Tps, I get no output at all
-  from the printer, and the log file shows the error
-  %% error: undefined; offendingcommand: BP %%
-  I'm using TranScript spooling software.
+* gtroff gives warnings about lines like
+  .ev	\" a comment
+  (with a tab after the .ev).
 
-This is a bug in the page reversal filter in early versions of
-TranScript.  Change the `broken' parameter in
-/usr/local/lib/groff/font/devps/DESC to 7.
+A tab character cannot be used as a substitute for a space character
+(except in one case: between a control character at the beginning of a
+line and the name of a macro or request).  For example, in Unix troff
 
-----------------------------------------------------------------------
+  .ps	\" restore the previous point size
 
-* When I preview groff -Tps output using the Sun OpenWindows 2.0
-  pageview program, all the pages are displayed on top of each other.
+(with a tab after the .ps) does NOT restore the previous point-size;
+instead it is silently ignored.  Since this is very likely to be an
+error, gtroff can give a warning about it.  If you want to align
+comments, you can do it like this:
 
-This is a defect in pageview.  Change the `broken' parameter in
-/usr/local/lib/groff/font/devps/DESC to 2.
+  .ev\"				\" a comment
 
 ----------------------------------------------------------------------
 
-* With groff -TX75, -TX100 or -X, I can only view the first page.
+* I don't like the page headers and footers produced by groff -man.
 
-The left mouse button brings up a menu that allows you to view other
-pages.
+There seem to be many different styles of page header and footer
+produced by different versions of the -man macros.  You need to put
+modified macros from tmac/an.tmac into man.local.  More information is
+available in groff_man(7).
 
 ----------------------------------------------------------------------
 
-* When I print the output of groff -Tdvi, I just get a black dot in
-  upper left corner.
+* While formatting a manual page, groff complains about not being able
+  to break lines.  A line like the following seems to cause this.
+    .TP \w'label'+2
+
+The groff_man(7) man page says that the default scaling unit for the
+`TP` macro is 'n' (ens), and that is how the groff man macros are
+implemented.  Consequently, the macro argument above is evaluated
+equivalently to this expression.
+
+  \w'label'n+2n
+
+AT&T troff's man macros don't implement this correctly (probably because
+it's hard to do in that troff); instead, they append 'n' to the entire
+argument, so that it is evaluated as if it were written as follows.
+
+  \w'label'u+2n
+
+The solution is to fix the manual page.
+
+  .TP \w'label'u+2
+
+It might be better still to avoid such computations in macro arguments,
+however; programs that are not *roff formatters that attempt to
+interpret man pages can lack the ability to interpret numeric
+expressions.  See section "Portability" of groff_man_style(7).
 
-Some dvi drivers (notably early versions of xtex) do not correctly
-handle dvi files that use a resolution different from that used by dvi
-files produced by TeX.  Try getting a more up to date driver.
 
-----------------------------------------------------------------------
+
+Printing and Display Problems
+=============================
+
+
+
+groff 1.09
 
 * How can I use groff with an old LaserJet printer that doesn't work
   with groff -Tlj4?
@@ -527,7 +514,7 @@
 
 - use groff -Tps with GNU Ghostscript;
 
-- use groff -Tdvi with a TeX .dvi to Laserjet driver;
+- use groff -Tdvi with a TeX .dvi to LaserJet driver;
 
 - use groff with the LaserJet driver in Chris Lewis' psroff package
   (available for ftp from:
@@ -547,102 +534,152 @@
 Problems with groff output's not printing are most often caused by the
 spooling system.
 
+----------------------------------------------------------------------
 
+groff 1.04
 
-Platform-Dependent Macro Problems
-=================================
+* When I try to run gxditview, I get the error:
+  Error: Widget viewport has zero width and/or height
+
+This error means you haven't correctly installed the application
+defaults file, GXditview.ad; `make install' does this for you
+automatically, so either you didn't do `make install', or you haven't
+passed a good `--appdefdir=<DIR>' argument to groff's configure
+script.
 
+See the X(7) man page for information how and where application
+defaults files have to be located.  Look for the XAPPLRESDIR and
+XUSERFILESEARCHPATH environment variables.
 
+----------------------------------------------------------------------
 
-* I get lots of errors when I use groff with the AT&T -mm macros.
+groff 1.01
 
-Use the groff -mm macros.
+* I'm having problems including PostScript illustrations (EPS) using
+  the PSPIC macro and/or \X'ps: import ...'.
+
+A PostScript document must meet three requirements in order to be
+included with the PSPIC macro: it must comply with the Adobe Document
+Structuring Conventions; it must contain a BoundingBox line; it must
+be `well-behaved'.  The BoundingBox line should be of the form:
+
+  %%BoundingBox: llx lly urx ury
+
+where llx, lly, urx, ury are the coordinates of the lower left x,
+lower left y, upper right x, upper right y of the bounding box of
+marks on the page expressed as integers in the default PostScript
+coordinate system (72 units per inch, origin at bottom left corner).
+
+The most convenient program to get the bounding box of a document is
+the `ps2epsi' script coming with GhostScript.
+
+If you can't use this program, another useful tactic is to print out
+the illustration by itself (you may need to add a `showpage' at the
+end), and physically measure the bounding box.  For more detail on
+these requirements, read the specification of Encapsulated PostScript
+format.  (This is available from the Adobe file server; send a message
+with a body of `help' to ps-file-server@adobe.com.)
+
+If an EPS file to be included via \X'ps: import' does not start with
+`%!PS-Adobe-...', gtroff still includes the file, but grops does not
+add any fonts to the generated output file that are listed in the EPS
+file, even though the files are listed in the `download' file and are
+available in the devps directory.
 
 ----------------------------------------------------------------------
 
-* groff produces wrapper macros for `ms' and friends which call the
-  system's original macros.  Then, to get groff's ms macro package I
-  have to use `-mgs' instead `-ms'.  Can I avoid this?
+* I've configured groff for A4 paper, but gtroff still seems to think
+  that the length of a page (as returned by `\n(.p') is 11 inches.
 
-Yes.  Configure and compile groff as usual, but install it with
+This is intentional.  The PAGE option during configuration is used
+only by grops.  For compatibility with AT&T troff, the default page
+length in GNU troff is always 11 inches.  The page length can be changed
+with the `pl' request.
 
-  make install tmac_wrap=""
+A convenient way to set paper dimensions is to use the -dpaper option
+of groff, together with proper -P options for the postprocessor
+(overriding the default).  For example, use the following command for
+PostScript output on A4 paper in landscape orientation.
 
-Then no wrapper files are produced, and `-ms' uses groff's `ms'
-macros.
+  groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+
+See groff(1) and groff_tmac(5) for more information.
 
 ----------------------------------------------------------------------
 
-* I'm having problems formatting HP-UX 9.0 man pages with groff -man.
+* When I print the output of groff -Tps, the output is always shifted
+  up by about 0.7 inches; I'm using 8.5x11 inch paper.
 
-Copy HP's tmac.an into /usr/local/share/groff/site-tmac/an.tmac, and
-either put `.cp 1' at the beginning or filter it (and any files it
-.so's) through tmac/fixmacros.sed.
+Make sure that the paper format is "letter".  See groff_tmac(5).
 
 ----------------------------------------------------------------------
 
-* I get errors using the Unix -ms macros with groff -e -C.
+* When I try to print the output of groff -Tps, I get no output at all
+  from the printer, and the log file shows the error
+  %% error: undefined; offendingcommand: BP %%
+  I'm using TranScript spooling software.
+
+This is a bug in the page reversal filter in early versions of
+TranScript.  Change the `broken' parameter in
+/usr/local/lib/groff/font/devps/DESC to 7.
 
-Apply this change:
+----------------------------------------------------------------------
 
-*** /usr/lib/ms/ms.eqn	Tue Apr 25 02:14:28 1989
---- ms.eqn	Sun Nov 11 10:33:59 1990
-***************
-*** 22,29 ****
-  ..
-  .	\" EN - end of a displayed equation
-  .de EN
-! .if !&#x7;\\*(10&#x7;&#x7; .br
-  .di
-  .rm EZ
-  .nr ZN \\n(dn
-  .if \\n(ZN>0 .if \\n(YE=0 .LP
---- 22,30 ----
-  ..
-  .	\" EN - end of a displayed equation
-  .de EN
-! .if \\n(.k>0 .br
-  .di
-+ .ds 10 \\*(EZ\\
-  .rm EZ
-  .nr ZN \\n(dn
-  .if \\n(ZN>0 .if \\n(YE=0 .LP
+* When I preview groff -Tps output using the Sun OpenWindows 2.0
+  pageview program, all the pages are displayed on top of each other.
+
+This is a defect in pageview.  Change the `broken' parameter in
+/usr/local/lib/groff/font/devps/DESC to 2.
 
 ----------------------------------------------------------------------
 
-* I'm having problems formatting Ultrix man pages with groff -man.
+* With groff -TX75, -TX100 or -X, I can only view the first page.
 
-The Ultrix man pages use a number of non-standard extensions to the
-Unix man macros.  One solution is to use the Ultrix -man macros with
-groff.  Copy /usr/lib/tmac/tmac.an to
-/usr/local/share/groff/site-tmac/an.tmac and apply the following patch
-(from Frank Wortner):
+The left mouse button brings up a menu that allows you to view other
+pages.  You can also press <space> and <backspace> to advance and
+retreat the current page view, respectively.
 
-*** /usr/local/lib/groff/tmac/tmac.an     Wed Sep  9 12:29:28 1992
---- /usr/lib/tmac/tmac.an       Fri Jul 24 19:58:19 1992
-***************
-*** 489,495 ****
-  .     \" make special case of shift out of italic
-  .de }S
-  .ds F
-! .if \\$12 .if !\\$5 .ds F \^
-  .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
-  .el \\$3
-  .}f
---- 489,495 ----
-  .     \" make special case of shift out of italic
-  .de }S
-  .ds F
-! .if \\$12 .if !\\$5 .ds F\^
-  .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
-  .el \\$3
-  .}f
+----------------------------------------------------------------------
 
-Another possible solution is to install tmac/man.ultrix as
-/usr/local/share/groff/site-tmac/man.local.
+* When I print the output of groff -Tdvi, I just get a black dot in
+  upper left corner.
+
+Some dvi drivers (notably early versions of xtex) do not correctly
+handle dvi files that use a resolution different from that used by dvi
+files produced by TeX.  Try getting a more up to date driver.
+
+----------------------------------------------------------------------
+
+* When I preview documents using -TX75 or -TX100, the layout is not
+  the same as when I print the document with -Tps: the line and page
+  breaks come in different places.
+
+Use `groff -X -Tps'.
+
+
+
+Platform-Dependent Macro Problems
+=================================
+
+
+
+groff 1.17
+
+* groff produces wrapper macros for `ms' and friends which call the
+  system's original macros.  Then, to get groff's ms macro package I
+  have to use `-mgs' instead `-ms'.  Can I avoid this?
+
+Yes.  Configure and compile groff as usual, but install it with
+
+  make install tmac_wrap=""
+
+Then no wrapper files are produced, and `-ms' uses groff's `ms'
+macros.
 
 ----------------------------------------------------------------------
 
+groff 1.09
+
 * On an SGI system, how can I make the man command use groff?
 
 From David Hinds <dhinds@allegro.stanford.edu> (some of these steps
@@ -651,13 +688,13 @@
 
 Create a script called `eqn':
 
- > #! /bin/sh
+ > #!/bin/sh
  > if  ${1:-""} = /usr/pub/eqnchar  ; then shift ; fi
  > geqn $*
 
 and a script called `neqn':
 
- > #! /bin/sh
+ > #!/bin/sh
  > if  ${1:-""} = /usr/pub/eqnchar  ; then shift ; fi
  > geqn -Tascii $*
 
@@ -720,214 +757,319 @@
 ! # probably not wanted.
 ! exec groff -Wall $T $opts $rest
 
+----------------------------------------------------------------------
+
+groff 1.08
 
+* I'm having problems formatting HP-UX 9.0 man pages with groff -man.
 
-Compilation Problems
-====================
+Copy HP's tmac.an into /usr/local/share/groff/site-tmac/an.tmac, and
+either put `.cp 1' at the beginning or filter it (and any files it
+.so's) through tmac/fixmacros.sed.
 
+----------------------------------------------------------------------
 
+groff 1.07
 
-* Compilation dies with
+* I'm having problems formatting Ultrix man pages with groff -man.
 
-    y.tab.c: In function `int yyparse()':
-    y.tab.c: `size_t' undeclared in namespace `std'
+The Ultrix man pages use a number of non-standard extensions to the
+Unix man macros.  To be fair, SunOS did too, albeit not as many; see
+groff_man(7).  groff embraced SunOS's extensions early on, but not
+Ultrix's. --GBR in 2023  One solution is to use the Ultrix -man macros
+with groff.  Copy /usr/lib/tmac/tmac.an to
+/usr/local/share/groff/site-tmac/an.tmac and apply the following patch
+(from Frank Wortner):
 
-* bison reports conflicts (either on stderr or in the `pic.output'
-  file) while processing `pic.y', and the produced pic binary doesn't
-  work at all.
+*** /usr/local/lib/groff/tmac/tmac.an     Wed Sep  9 12:29:28 1992
+--- /usr/lib/tmac/tmac.an       Fri Jul 24 19:58:19 1992
+***************
+*** 489,495 ****
+  .     \" make special case of shift out of italic
+  .de }S
+  .ds F
+! .if \\$12 .if !\\$5 .ds F \^
+  .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
+  .el \\$3
+  .}f
+--- 489,495 ----
+  .     \" make special case of shift out of italic
+  .de }S
+  .ds F
+! .if \\$12 .if !\\$5 .ds F\^
+  .ie !\\$4 .}S \\$2 \\$1 "\\$3\f\\$1\\$4\\*(F" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
+  .el \\$3
+  .}f
 
-You need bison version 1.875b or greater.  Alternatively, use yacc or
-byacc.
+Another possible solution is to install tmac/man.ultrix as
+/usr/local/share/groff/site-tmac/man.local.
 
 ----------------------------------------------------------------------
 
-* There are many empty `Makefile.dep' files.  Is this a bug?
+groff 1.01
 
-No.  Real dependency files are created with a `make depend' call.
+* I get lots of errors when I use groff with the AT&T -mm macros.
 
-----------------------------------------------------------------------
+Use the groff -mm macros.
 
-* On HP-UX, the compiler complains about missing symbol `alloca'.
 
-Say
 
-  export LDFLAGS=-lPW
+Compilation Problems
+====================
 
-before starting the configure script.
+
+
+groff 1.23.0
+
+* The "initialization_is_quiet" test fails on my NetBSD box.
+
+This is a known problem.  We haven't tracked down the cause yet, but
+have improved the reporting of the test output in hopes that we can
+isolate it in a future release.
 
 ----------------------------------------------------------------------
 
-* The configure script fails on OS/390 (z/OS) Unix.
+* I get a build failure on Cygwin / a system using newlib and GCC 11.
 
-This has been fixed in z/OS V1R3 (aka OS/390 R13).
+"newlib" defines a function called "utoa" which conflicts with a static
+(file scope-local) function in src/libs/libxutil/XFontName.c.
 
-There is a bug in the Language Environment (LE) whereby the test
-program for static destructors fails.  You see the message `configure:
-error: a working C++ compiler is required'.
+We expect to fix this in the near future; in the meantime, you can patch
+the file to rename the function (and update its call sites) or, if you
+don't require the "gxditview" output previewer or "xtotroff" utility,
+you can build groff without X11 support.
 
-Applying PTF UQ42006 is supposed to fix this, but the test program is
-still returning the wrong value (1).  To work around this problem, you
-can comment out the following in the configure script (near line
-2029).  This effectively bypasses the test (static constructors and
-destructors do actually work properly):
-
-#if { (eval echo "$as_me:2029: \"$ac_link\"") >&5
-#  (eval $ac_link) 2>&5
-#  ac_status=$?
-#  echo "$as_me:2032: \$? = $ac_status" >&5
-#  (exit $ac_status); } && { ac_try='./conftest$ac_exeext'
-#  { (eval echo "$as_me:2034: \"$ac_try\"") >&5
-#  (eval $ac_try) 2>&5
-#  ac_status=$?
-#  echo "$as_me:2037: \$? = $ac_status" >&5
-#  (exit $ac_status); }; }; then
-#  echo "$as_me:2039: result: yes" >&5
-#echo "${ECHO_T}yes" >&6
-#else
-#  echo "$as_me: program exited with status $ac_status" >&5
-#echo "$as_me: failed program was:" >&5
-#cat conftest.$ac_ext >&5
-#echo "$as_me:2045: result: no" >&5
-#echo "${ECHO_T}no" >&6;{ { echo "$as_me:2046: error: a working C++ compiler is required" >&5
-#echo "$as_me: error: a working C++ compiler is required" >&2;}
-#   { (exit 1); exit 1; }; }
-#fi
+  $ make distclean
+  $ ./configure --without-x
 
 ----------------------------------------------------------------------
 
-* I get errors when I try to compile groff with DEC C++.
+* The "check-default-foundry" test fails when I run "make check".
 
-Fix the declaration of write() in <unistd.h> so that the second
-argument is a const char *.  Fix the declaration of open() in
-<sys/file.h> so that the first argument is a const char *.
+Your Ghostscript installation may have its fonts embedded in the
+executable; this can be discerned by searching for the pattern "%rom%"
+in its search path.
+
+  $ gs -h | grep '%rom%'
+
+The consequence is that gropdf(1) will be unable to embed fonts into PDF
+files it generates (apart from groff's "EURO" font) when the default
+foundry is used.  This is the same outcome as if Ghostscript were not
+installed at all.  If you install URW fonts (see "INSTALL.extra"), you
+will be able to embed them all by using the "U" foundry with gropdf to
+overcome this problem.
 
 ----------------------------------------------------------------------
 
-* On a host using Unix make (e.g. Solaris), if you are compiling for
-  multiple architectures by building in a subdirectory, the make stops
-  with a message like this:
+* I get a lot of warnings about "sprintf" on macOS.
 
-    make: Fatal error: Don't know how to make target `assert.o'
+Apple has decided to treat the sprintf() standard C library function as
+deprecated even though the C standard itself has not.
 
-  or like this:
+https://developer.apple.com/forums/thread/714675
 
-    make: Fatal error: Can't find /u/src/groff/src/include/Makefile.sub': No such file or directory
+----------------------------------------------------------------------
 
-This occurs because GNU make and Unix make handle VPATH differently,
-and the groff build relies on GNU make's VPATH handling.
+* I get a make(1) failure involving grep and the groff_man.7.man.in file
+  on Solaris 11.
 
-Use GNU make <http://www.gnu.org/software/make/> to work around this.
-In Solaris 8 and 9, GNU make is on the Software Companion CD in
-package SFWgmake and is installed as /opt/sfw/bin/gmake.  Prebuilt
-versions of GNU make for Solaris are also available from
-sunfreeware.com.
+Solaris make(1) has a bug easily exhibited by the following Makefile.
+
+all:
+	! false
+
+Use GNU make instead; it may be available in /opt/csw/bin/gmake.
 
 ----------------------------------------------------------------------
 
-* On Ultrix, the make program stops with the message
+* Tests fail when I run "make check" on Solaris 10 or 11.
 
-    *** Error code 1
+The test suite expects a POSIX-conforming shell and utilities.  Solaris
+10 does not offer these in the default $PATH.  We try to use features
+standardized no later than POSIX Issue 4 (1994).  Unfortunately even
+that is too recent for some implementations.  Solaris 11 has a (mostly)
+conforming shell.  It may help to ensure that "/usr/xpg6/bin" and
+"/usr/xpg4/bin" precede "/usr/bin" in the $PATH when building groff.
 
-    Stop.
+For Solaris 10, it is necessary to modify the shell-based test scripts
+in place to use a conforming shell.  Here is an example.
 
-  for no apparent reason.
+  $ gsed -i -e '1s@#!/bin/sh@#!/usr/xpg4/bin/sh@' \
+      `find . -name '*.sh' | grep /tests/`
+  $ PATH=/usr/xpg4/bin:$PATH gmake check
 
-Use GNU make.
+Some test failures remain expected on Solaris 10 and/or 11.
+
+1.  FAIL: contrib/hdtbl/examples/test-hdtbl.sh
+
+    /usr/bin/tr on Solaris 10 is non-conforming with the POSIX Issue 4
+    standard.  It furthermore issues anonymous diagnostics, saying only
+    "Bad string".
+
+    Install tr from GNU coreutils in the $PATH.  Edit line 57 of each of
+    contrib/hdtbl/examples/fonts_x.in and
+    contrib/hdtbl/examples/fonts_n.in.  Change "tr" to "gtr".
+    Alternatively, you can use the absolute path to GNU tr's location.
+    Re-run "gmake check" as above.  (Some files will be rebuilt.)
+
+    The tr commands in /usr/xpg4/bin and /usr/xpg6/bin also work, but
+    the documents constructed from the above inputs use groff's `pso`
+    request, which wraps the standard C library `popen()` function,
+    which sanitizes $PATH to avoid privilege escalation, thus making it
+    likely that the non-conforming tr in /usr/bin will be found first.
+
+2.  FAIL: src/roff/groff/tests/initialization_is_quiet.sh
+    FAIL: src/roff/groff/tests/msoquiet_works.sh
+    FAIL: src/roff/groff/tests/soquiet_works.sh
+
+    (The first of these might be SKIPped instead.)
+
+    /usr/xpg4/bin/sh is non-conforming with the POSIX Issue 4 standard,
+    despite its name.  Its "unset" builtin is buggy.  (The /usr/bin/sh
+    in Solaris 11 does not have this problem.)
+
+    These tests use the "unset" shell builtin command to prevent
+    environment variables from confounding test results.
+
+    POSIX says "unsetting a variable ... that was not previously set
+    is not considered an error and will not cause the shell to abort."
+
+    Nevertheless this builtin returns an error exit status in this
+    circumstance.
+
+    $ /usr/xpg4/bin/sh -c 'unset _NON_EXISTENT_XYZ; echo $?'
+    1
+
+    You may disregard these failures, edit the test scripts to append
+    "|| true" to the "unset" commands, or change the scripts to use GNU
+    Bash or some other POSIX-conforming shell as illustrated above.
 
 ----------------------------------------------------------------------
 
-* I'm having problems compiling groff on 386BSD 0.1.
+* I get warnings from afmtodit about names already being mapped.
 
-If you're using ash as /bin/sh, you'll need the following patch.
+afmtodit: AGL name 'Delta' already mapped to groff name '*D'; ignoring AGL name 'uni0394'
 
-*** gendef.sh.org	Sun Jun 30 13:30:36 1991
---- gendef.sh	Sun Feb 28 10:23:49 1993
-***************
-*** 3,9 ****
-  file=$1
-  shift
+You can ignore these if they're in the form shown above, where the
+ignored AGL name is 'uniXXXX' and 'XXXX' is four hexadecimal digits.
+The Adobe Glyph List (AGL) has its own names for glyphs; they are often
+different from groff's special character names.  The afmtodit program is
+constructing a mapping from groff special character names to AGL names;
+this can be a one-to-one or many-to-one mapping, but one-to-many will
+not work, so afmtodit discards the excessive mappings.  The example you
+see above is telling you that the groff font description that afmtodit
+is writing cannot map the groff special character '*D' to both 'Delta'
+and 'uni0394'.
 
-! defs="#define $1"
-  shift
-  for def
-  do
---- 3,10 ----
-  file=$1
-  shift
+Which, if any, such warnings you see depends on the version of the URW
+fonts you are building groff against.  See the '--with-urw-fonts-dir'
+option to the "configure" script, and the afmtodit(1) and groff_char(7)
+man pages for more background.
 
-! x=$1
-! defs="#define $x"
-  shift
-  for def
-  do
+----------------------------------------------------------------------
 
-You'll also need to change dirnamemax.c so that it doesn't use
-pathconf().
+* I am building from the Git repository, using 'autoreconf' from a GNU
+  Autoconf release earlier than 2.69, and I get this.
+
+  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
+    warning: underquoted definition of AC_GTKGLEXTMM_SUPPORTS_MULTIHEAD
+  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
+    run info '(automake)Extending aclocal'
+  /usr/share/aclocal/gtkglextmm-1.2.m4:225:
+    or see http://www.gnu.org/software/automake/manual/automake.html#Extending-aclocal
+
+Ignore this.  It doesn't occur in more recent versions of 'autoreconf'.
 
 ----------------------------------------------------------------------
 
-* While compiling on Xenix, ranlib libgroff.a fails.
+* I get warnings about special characters in the groff_char(7) man page.
 
-The system ranlib can't handle externals longer than 40 characters.
-Use the ranlib included in demon.co.uk:/pub/xenix/g++-1.40.3a.v1
-instead.
+troff:man/groff_char.7:1033: warning: special character '.j' not defined
+
+  (...and similar for 'vA', 'bs', '-+', 'coproduct', and '+e'.)
+
+You can ignore these.  groff defines a handful of special characters for
+which historical PostScript fonts usually did not possess glyphs.
+Except for 'bs' (the Bell System logo), we hope to provide fallbacks or
+a supplementary PostScript font in groff in the future (as was done for
+the Euro glyph).
 
 ----------------------------------------------------------------------
 
-* I get errors when I try to compile groff with Sun C++ version 3 or
-  earlier.
+* I get warnings about the "vasnprintf" function.
 
-Groff requires header files that are moderately compatible with AT&T
-C++ and ANSI C.  With some versions of Sun C++, the supplied header
-files need some of the following changes to meet this requirement:
-<string.h> must declare the mem* functions, (just add `#include
-<memory.h>' to <string.h>); the first argument to fopen and freopen
-should be declared as `const char *'; the first argument to fread
-should be declared as `void *'; the first argument to fwrite should be
-declared as `const void *'; malloc should be declared to return
-`void *'; in <alloca.h>, the declaration `extern "C" { void
-*__builtin_alloca(int); }' should be added; in <sys/signal.h> the
-return type and the second argument type of signal() should be changed
-to be `void (*)(int)'.
+lib/vasnprintf.c: In function 'vasnprintf':
+lib/vasnprintf.c:5268:27: warning: format not a string literal, argument types not checked -Wformat-nonliteral
+(and similar)
 
-You can either change them in place, or copy them to some other
-directory and include that directory with a -I option.
+The groff source tree includes gnulib, the GNU portability library
+<https://www.gnu.org/software/gnulib/>.  These warnings are about its
+source code and that project's responsibility to resolve.  We expect a
+future release of gnulib to do so.
 
 ----------------------------------------------------------------------
 
-* I get errors when I try to compile groff with Forte Development 6
-  or 6u1, or Sun C++ version 5.0 through 5.2.
+groff 1.22.4
 
-This is a known problem; see Sun bug #4301919.  See Sun patches
-109482, 109490, 109508, and 109509 for fixes.
+* When compiling on NetBSD, make issues warnings like
+
+  Warning: line 28: Unable to locate font(s)
+  URWGothicL-Demi,a010015l.pfb on the given path(s)
+
+  and
+
+  Warning: line 77: Failed to create groff font 'U-AB' by running
+  afmtodit
+
+In this case install the package "urw-fonts":
+
+  pkgin install urw-fonts
+
+and make the font path known to ghostscript, e.g. with (ksh):
+
+  export GS_LIB=/usr/pkg/share/fonts/urw
 
 ----------------------------------------------------------------------
 
-* I get warnings from the Sun linker while using gcc 3.4.0:
+* Currently (December 2015) building groff fails on NetBSD and
+  FreeBSD with the message:
 
-  ld: warning: relocation error: R_SPARC_UA32:
-      file groff/src/libs/libgroff/libgroff.a(getopt.o): symbol optarg:
-      external symbolic relocation against non-allocatable
-      section .debug_info; cannot be processed at runtime:
-      relocation ignored
+  make1: don't know how to make contrib/chem/chem.1. Stop
 
-This seems to be a known problem (Sun bugs #4910101 and #4910810,
-filed in September 2003; gcc bug #15599, filed May 2004) without a
-public fix as of this writing.  A work-around is to use option
-`-gstabs+' instead of `-g' (and a high probability that the output is
-only debuggable with gdb but not with Sun's debuggers).
+The reason is a bug in the make(1) tool used on those systems related
+to .SUFFIXES lines.
+
+A temporary workaround is to change the Makefile line
+
+  .SUFFIXES: .roff .in .ps .mom .pdf .me .ms .ps .html .txt .texi \
+    .dvi .pdf .xhtml .man .c .cpp .log .o .obj .sed .sin \
+    .test .test$(EXEEXT) .trs .ypp
+
+into
+
+  .SUFFIXES: .man .roff .in .ps .mom .pdf .me .ms .ps .html .txt \
+    .texi .dvi .pdf .xhtml .c .cpp .log .o .obj .sed .sin \
+    .test .test$(EXEEXT) .trs .ypp
+
+(put .man at begin of the list).
+
+The bug is reported to the maintainer of the make(1) tool of those
+systems.
 
 ----------------------------------------------------------------------
 
-* I get lots of `numeric overflow' error messages whenever I run
-  groff; I compiled groff with AT&T C++ 2.0 with an ANSI C compiler.
+groff 1.22.3
+
+* Configuration on MacOS X 10.6 doesn't succeed.
+
+Use
 
-Make sure -DCFRONT_ANSI_BUG is included in DEFINES in the top-level
-Makefile.  If that doesn't solve the problem, define INT_MIN as
--INT_MAX in libgroff/lib.h.
+  ./configure CXX=g++-4.2
 
 ----------------------------------------------------------------------
 
+groff 1.21
+
 * In MacOS X, I want to completely replace the groff that came with
   the system.
 
@@ -944,6 +1086,26 @@
 
 ----------------------------------------------------------------------
 
+groff 1.19.2
+
+* I get warnings from the Sun linker while using gcc 3.4.0:
+
+  ld: warning: relocation error: R_SPARC_UA32:
+      file groff/src/libs/libgroff/libgroff.a(getopt.o): symbol optarg:
+      external symbolic relocation against non-allocatable
+      section .debug_info; cannot be processed at runtime:
+      relocation ignored
+
+This seems to be a known problem (Sun bugs #4910101 and #4910810,
+filed in September 2003; gcc bug #15599, filed May 2004) without a
+public fix as of this writing.  A work-around is to use option
+`-gstabs+' instead of `-g' (and a high probability that the output is
+only debuggable with gdb but not with Sun's debuggers).
+
+----------------------------------------------------------------------
+
+groff 1.19
+
 * When compiling on MacOS X 10.2, groff compiles but does not run
   well, especially `eqn', causing many `can't break line' messages.
 
@@ -959,60 +1121,201 @@
 
 ----------------------------------------------------------------------
 
-* Configuration on MacOS X 10.6 doesn't succeed.
+groff 1.18.0
 
-Use
+* Compilation dies with
 
-  ./configure CXX=g++-4.2
+    y.tab.c: In function `int yyparse()':
+    y.tab.c: `size_t' undeclared in namespace `std'
+
+* bison reports conflicts (either on stderr or in the `pic.output'
+  file) while processing `pic.y', and the produced pic binary doesn't
+  work at all.
+
+You need bison version 1.875b or greater.  Alternatively, use yacc or
+byacc.
 
 ----------------------------------------------------------------------
 
-* When compiling on NetBSD, make issues warnings like
+groff 1.17
 
-  Warning: line 28: Unable to locate font(s)
-  URWGothicL-Demi,a010015l.pfb on the given path(s)
+* On HP-UX, the compiler complains about missing symbol `alloca'.
 
-  and
+Say
 
-  Warning: line 77: Failed to create groff font 'U-AB' by running
-  afmtodit
+  export LDFLAGS=-lPW
 
-In this case install the package "urw-fonts":
+before starting the configure script.
 
-  pkgin install urw-fonts
+----------------------------------------------------------------------
 
-and make the font path known to ghostscript, e.g. with (ksh):
+groff 1.16.1
 
-  export GS_LIB=/usr/pkg/share/fonts/urw
+* On a host using Unix make (e.g. Solaris), if you are compiling for
+  multiple architectures by building in a subdirectory, the make stops
+  with a message like this:
+
+    make: Fatal error: Don't know how to make target `assert.o'
+
+  or like this:
+
+    make: Fatal error: Can't find /u/src/groff/src/include/Makefile.sub': No such file or directory
+
+This occurs because GNU make and Unix make handle VPATH differently,
+and the groff build relies on GNU make's VPATH handling.
+
+Use GNU make <http://www.gnu.org/software/make/> to work around this.
+In Solaris 8 and 9, GNU make is on the Software Companion CD in
+package SFWgmake and is installed as /opt/sfw/bin/gmake.  Prebuilt
+versions of GNU make for Solaris are also available from
+sunfreeware.com.
 
 ----------------------------------------------------------------------
 
-* Currently (December 2015) building groff fails on NetBSD and
-  FreeBSD with the message:
+* There are many empty `Makefile.dep' files.  Is this a bug?
 
-  make1: don't know how to make contrib/chem/chem.1. Stop
+No.  Real dependency files are created with a `make depend' call.
 
-The reason is a bug in the make(1) tool used on those systems related
-to .SUFFIXES lines.
+----------------------------------------------------------------------
 
-A temporary workaround is to change the Makefile line
+groff 1.16
 
-  .SUFFIXES: .roff .in .ps .mom .pdf .me .ms .ps .html .txt .texi \
-    .dvi .pdf .xhtml .man .c .cpp .log .o .obj .sed .sin \
-    .test .test$(EXEEXT) .trs .ypp
+* The configure script fails on OS/390 (z/OS) Unix.
 
-into
+This has been fixed in z/OS V1R3 (aka OS/390 R13).
 
-  .SUFFIXES: .man .roff .in .ps .mom .pdf .me .ms .ps .html .txt \
-    .texi .dvi .pdf .xhtml .c .cpp .log .o .obj .sed .sin \
-    .test .test$(EXEEXT) .trs .ypp
+There is a bug in the Language Environment (LE) whereby the test
+program for static destructors fails.  You see the message `configure:
+error: a working C++ compiler is required'.
+
+Applying PTF UQ42006 is supposed to fix this, but the test program is
+still returning the wrong value (1).  To work around this problem, you
+can comment out the following in the configure script (near line
+2029).  This effectively bypasses the test (static constructors and
+destructors do actually work properly):
+
+#if { (eval echo "$as_me:2029: \"$ac_link\"") >&5
+#  (eval $ac_link) 2>&5
+#  ac_status=$?
+#  echo "$as_me:2032: \$? = $ac_status" >&5
+#  (exit $ac_status); } && { ac_try='./conftest$ac_exeext'
+#  { (eval echo "$as_me:2034: \"$ac_try\"") >&5
+#  (eval $ac_try) 2>&5
+#  ac_status=$?
+#  echo "$as_me:2037: \$? = $ac_status" >&5
+#  (exit $ac_status); }; }; then
+#  echo "$as_me:2039: result: yes" >&5
+#echo "${ECHO_T}yes" >&6
+#else
+#  echo "$as_me: program exited with status $ac_status" >&5
+#echo "$as_me: failed program was:" >&5
+#cat conftest.$ac_ext >&5
+#echo "$as_me:2045: result: no" >&5
+#echo "${ECHO_T}no" >&6;{ { echo "$as_me:2046: error: a working C++ compiler is required" >&5
+#echo "$as_me: error: a working C++ compiler is required" >&2;}
+#   { (exit 1); exit 1; }; }
+#fi
+
+----------------------------------------------------------------------
+
+groff 1.15
+
+* I get errors when I try to compile groff with Forte Development 6
+  or 6u1, or Sun C++ version 5.0 through 5.2.
+
+This is a known problem; see Sun bug #4301919.  See Sun patches
+109482, 109490, 109508, and 109509 for fixes.
+
+----------------------------------------------------------------------
+
+groff 1.08
+
+* I'm having problems compiling groff on 386BSD 0.1.
+
+If you're using ash as /bin/sh, you'll need the following patch.
+
+*** gendef.sh.org	Sun Jun 30 13:30:36 1991
+--- gendef.sh	Sun Feb 28 10:23:49 1993
+***************
+*** 3,9 ****
+  file=$1
+  shift
+
+! defs="#define $1"
+  shift
+  for def
+  do
+--- 3,10 ----
+  file=$1
+  shift
+
+! x=$1
+! defs="#define $x"
+  shift
+  for def
+  do
+
+You'll also need to change dirnamemax.c so that it doesn't use
+pathconf().
+
+----------------------------------------------------------------------
+
+* While compiling on Xenix, ranlib libgroff.a fails.
+
+The system ranlib can't handle externals longer than 40 characters.
+Use the ranlib included in demon.co.uk:/pub/xenix/g++-1.40.3a.v1
+instead.
+
+----------------------------------------------------------------------
+
+groff 1.07
+
+* I get errors when I try to compile groff with DEC C++.
+
+Fix the declaration of write() in <unistd.h> so that the second
+argument is a const char *.  Fix the declaration of open() in
+<sys/file.h> so that the first argument is a const char *.
+
+----------------------------------------------------------------------
+
+* On Ultrix, the make program stops with the message
+
+    *** Error code 1
+
+    Stop.
+
+  for no apparent reason.
+
+Use GNU make.
+
+----------------------------------------------------------------------
+
+groff 1.01
+
+* I get errors when I try to compile groff with Sun C++ version 3 or
+  earlier.
+
+Groff requires header files that are moderately compatible with AT&T
+C++ and ANSI C.  With some versions of Sun C++, the supplied header
+files need some of the following changes to meet this requirement:
+<string.h> must declare the mem* functions, (just add `#include
+<memory.h>' to <string.h>); the first argument to fopen and freopen
+should be declared as `const char *'; the first argument to fread
+should be declared as `void *'; the first argument to fwrite should be
+declared as `const void *'; malloc should be declared to return
+`void *'; in <alloca.h>, the declaration `extern "C" { void
+*__builtin_alloca(int); }' should be added; in <sys/signal.h> the
+return type and the second argument type of signal() should be changed
+to be `void (*)(int)'.
+
+You can either change them in place, or copy them to some other
+directory and include that directory with a -I option.
 
-(put .man at begin of the list).
 
-The bug is reported to the maintainer of the make(1) tool of those
-systems.
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/PROJECTS -> _service:tar_scm:groff-1.23.0.tar.gz/PROJECTS Changed

@@ -1,13 +1,13 @@
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
+# Copyright (C) 1999-2020 Free Software Foundation, Inc.
 #
-# This file is part of `groffer' which is part of `groff'.
+# This file is part of groff.
 #
-# `groff' is free software; you can redistribute it and/or modify it
+# 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.
 #
-# `groff' is distributed in the hope that it will be useful, but
+# 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.
@@ -24,10 +24,10 @@
 	distribution.
 
   refer: `refer' database directory under /usr/local/share.
-  	 There maybe create a default database `Ind' or others for
-  	 storing books and documents for `groff' man pages.
+	 There maybe create a default database `Ind' or others for
+	 storing books and documents for `groff' man pages.
 	 Write the following `groff' programs from Heirloom and
-  	 `refer' history:
+	 `refer' history:
 	 - addbib
 	 - roffbib
 	 - sortbib
@@ -44,7 +44,9 @@
 has gotten there first.
 
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set filetype= textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/README -> _service:tar_scm:groff-1.23.0.tar.gz/README Changed

@@ -1,124 +1,130 @@
-    Copyright (C) 1989-2018 Free Software Foundation, Inc.
+    Copyright (C) 1989-2023 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without
     modification, are permitted in any medium without royalty provided
     the copyright notice and this notice are preserved.
 
-This is the GNU `groff' document formatting system.  The version
-number is given in the file VERSION.
+This is the 'groff' document formatting system, a reimplementation and
+extension of the AT&T Unix 'troff' system.  The version number is given
+in the file '.tarball-version' if you are building from a distribution
+archive; otherwise, building from its Git repository will store it in
+the file '.version'.
 
-Included in this release are implementations of `troff', `pic', `eqn',
-`tbl', `grn', `refer', `-man', `-mdoc', `-mom', and `-ms' macros, and
-drivers for `PostScript', `PDF', `TeX DVI' format, `HP LaserJet 4'
-printers, `Canon CAPSL' printers, `HTML' and `XHTML' formats (beta
-status), and typewriter-like devices.  Also included is a modified
-version of the Berkeley `-me' macros, the enhanced version `gxditview'
-of the X11 `xditview' previewer, and an implementation of the `-mm'
-macros contributed by Joergen Haegg.
+This release includes original implementations (not derived from AT&T
+Unix code) of the 'troff', 'nroff', 'pic', 'eqn', 'tbl', 'refer', and
+'soelim' programs; the 'man' and 'ms' macro packages; and output drivers
+for PostScript, PDF, and TeX DVI file formats, HP LaserJet 4- and Canon
+CaPSL-compatible printers, HTML and XHTML (in beta status), and
+typewriter/terminal devices.
 
-See the file `INSTALL' for instructions on how to install from a
-release.  You will require a C++ compiler.
+It also provides modified versions of BSD Unix additions to Unix troff:
+the 'grn' preprocessor, and the 'mdoc' and 'me' macro packages.
+'gxditview', an enhanced version of the X11 'xditview' previewer for
+'troff' device-independent output, originates from X11R5.
 
-The file `INSTALL.REPO' contains supplementary instructions for
-building directly from a clone of the repository or a snapshot
-tarball.
+Contributed components feature a reimplementation and extension of the
+DWB 'troff' 'mm' macro package by Joergen Haegg, Peter Schaffter's 'mom'
+macro package, and Bernd Warken's reimplementation of the 'chem'
+preprocessor in Perl.
 
-The file `NEWS' describes recent user-visible changes to `groff'.
+See the file 'INSTALL.extra' for instructions on how to install from a
+distribution archive, such as a release, beta, or release candidate.
 
-`groff' is free software.  See the file `COPYING' for copying
-permission.
+The file 'INSTALL.REPO' contains supplementary instructions for building
+directly from a clone of the Git repository.
 
-The file `PROBLEMS' describes various problems that have been
-encountered in compiling, installing, and running `groff'.
+The file 'NEWS' contains a history of user-visible changes to 'groff'.
 
-The file `MORE.STUFF' contains information about add-on packages
-useful for `groff'.
+'groff' is free software.  See the file 'COPYING' for copying
+permissions, and 'LICENSES' for further detail.
 
-The most recent released version of `groff' is always available by
-anonymous ftp from `ftp.gnu.org' in the directory `gnu/groff'.
+The file 'PROBLEMS' describes various issues that users have encountered
+in compiling, installing, and running 'groff'.
 
-The current development version of `groff' is available from a git
-repository at
+The file 'MORE.STUFF' describes some third-party programming and
+documentary resources useful with 'groff'.
 
-  https://savannah.gnu.org/git/?group=groff
+Current and historical releases of 'groff' are available via HTTPS and
+anonymous FTP from the host 'ftp.gnu.org' in the directory 'gnu/groff'.
+
+'groff' has a home page at the GNU Project.
+
+https://www.gnu.org/software/groff/
 
-To view the git repository in your browser, go to
+Administration of the project is done through GNU Savannah.
+
+  https://savannah.gnu.org/git/?group=groff
 
-  http://git.savannah.gnu.org/cgit/groff.git
+'groff' is developed at its Git repository, which has a web interface.
 
-There you can also download snapshots; simply click on a commit entry
-line to get the URL.
+  https://git.savannah.gnu.org/cgit/groff.git
 
-Depending on your requirements, you may need at least some of the
-following tools to build `groff' directly from its source:
+You can view any commit in isolation, and browse the entire source tree
+corresponding to its state as of that commit.  Click the summary line of
+the commit message to expose these options.
 
-  perl >= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
-  ghostscript
-  the psutils package
-  the netpbm package
-  texinfo 4.8
-  bison >= 1.875b or byacc
+Build requirements are discussed in the 'INSTALL.extra' and
+'INSTALL.REPO' files noted above.  'groff' also has runtime
+dependencies.
 
-Note that `texinfo' and `bison' or `byacc' are required only for
-building from repository sources (either a checked out working copy,
-or a commit snapshot).  They are not required for building from a
-stable release tarball.  Also note that the version numbers stated are
-the minimum supported.  No version of `texinfo' < 4.8 works, and the
-original release of `bison' 1.875 is known not to work; you *may* find
-that `bison' releases < 1.875 work, but in case of difficulty, please
-update to a later version *before* posting a bug report.
+Ghostscript is required for creation of PDF and (X)HTML output.
+Production of (X)HTML furthermore demands tools from the 'netpbm' and
+'psutils' packages.
 
-For *all* sources, you need `ghostscript' for creation of either `PDF'
-or `HTML' output; the `netpbm' and `psutils' packages are required
-only for `HTML' output (and for compilation from the repository).  If
-you don't intend to produce output in either of these formats, then
-these packages are unnecessary.
+Perl is required for production of PDF output using the 'gropdf' output
+driver.  (You can alternatively produce PostScript with 'grops' and
+convert that to PDF using Ghostscipt.)  The 'chem', 'gperl', and
+'gpinyin' preprocessors and several utilities, such as 'grog', are also
+written in Perl.
 
-Additionally, producing `PDF' output directly with the `gropdf' device needs
-a working installation of `perl'.  The same is true for some other
-preprocessors like `chem'.
+If 'groff' is configured with 'lp' or 'lpr' support, the corresponding
+program must remain available on the system for the 'groff' command's
+'-l' option to work.  Similarly, build-time detection of development
+headers for the 'uchardet', 'Xaw', and 'Xmu' libraries (and their
+dependencies) assumes that their runtime counterparts will remain
+installed to support the 'groff' that is built.
 
-The `groff' configure script searches for the X11 headers and
-libraries `Xaw' and `Xmu'.  So the corresponding developer packages of
-your system must be installed, otherwise `groff' does not install
-`gxditview' and the `-TX*' devices.  In Debian, the developer packages
-are `libxaw7-dev' and `libxmu-dev'.
+You can view or add to to groff's bug database via its issue tracker on
+the Savannah site (also linked from the groff home page).
 
-Please report bugs using the bug tracker available from the project
-page at
+  http://savannah.gnu.org/bugs/?group=groff
 
-  https://savannah.gnu.org/projects/groff
+To report a problem, you may use the form in the file 'BUG-REPORT'; its
+purpose is to make sure that FSF has all the information it needs to fix
+the bug.  At the very least, read the 'BUG-REPORT' form and make sure
+that you supply all the information that it asks for.  Even if you are
+not sure that something is a bug, please report it so we can determine
+whether it is a software defect, or an omission from our documentation.
 
-You may use the form in the file `BUG-REPORT'; the idea of this is to
-make sure that FSF has all the information it needs to fix the bug.
-At the very least, read the `BUG-REPORT' form and make sure that you
-supply all the information that it asks for.  Even if you are not sure
-that something is a bug, report it: this enables us to determine whether
-it really is a bug.
+If you'd like to modify 'groff' or participate in its development, files
+'HACKING' and 'MANIFEST' will familiarize you with the structure of the
+code and the project's conventions for maintaining it.
 
-Three mailing lists are available:
+Three mailing lists are available.
 
-  bug-groff@gnu.org          for following bug reports
+  bug-groff@gnu.org          a read-only list for following bug reports
   groff@gnu.org              for general discussion of groff
-  groff-commit@gnu.org       a read-only list to follow commits
-                             to the git repository
+  groff-commit@gnu.org       a read-only list for following commits
+                             to the Git repository
 
 To subscribe, send a mail to <list>-request@<domain> (example:
-groff-request@gnu.org for the `groff' list) with the word `subscribe'
-in either the subject or body of the e-mail (don't include the quotes).
-Alternatively, you may subscribe by visiting the web pages at
+groff-request@gnu.org for the 'groff' list) with the word 'subscribe'
+in either the subject or body of the email (don't include the quotes).
+Alternatively, subscribe via our web pages by completing an HTML form.
 
-  http://lists.gnu.org/mailman/listinfo/bug-groff
-  http://lists.gnu.org/mailman/listinfo/groff
-  http://lists.gnu.org/mailman/listinfo/groff-commit
+  https://lists.gnu.org/mailman/listinfo/bug-groff
+  https://lists.gnu.org/mailman/listinfo/groff
+  https://lists.gnu.org/mailman/listinfo/groff-commit
 
 Each of these web pages also provides a link to a browseable archive of
 postings to the corresponding mailing list.
 
-GNU `groff' was written by James Clark <jjc@jclark.com>.
+'groff' was primarily written by James Clark <jjc@jclark.com>.
 
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/README.MinGW -> _service:tar_scm:groff-1.23.0.tar.gz/README.MinGW Changed

@@ -1,4 +1,4 @@
-    Copyright (C) 2003-2018 Free Software Foundation, Inc.
+    Copyright (C) 2003-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -13,194 +13,206 @@
   INTRODUCTION
   ------------
 
-  This file provides recommendations for building a Win32 implementation of
-  GNU Groff, using the MinGW port of GCC for Microsoft (TM) Windows-32
-  platforms.  It is intended to supplement the standard installation
-  instructions (see file INSTALL); it does not replace them.
+  This file provides recommendations for building a Win32 implementation
+  of GNU Groff, using the MinGW port of GCC for Microsoft (TM)
+  Windows-32 platforms.  It is intended to supplement the standard
+  installation instructions (see file INSTALL); it does not replace
+  them.
 
-  You require both the MinGW implementation of GCC and its supporting MSYS
-  toolkit, which provides a Win-32 implementation of the GNU bash shell, and a
-  few other essential utilities; these may be obtained from
+  You require both the MinGW implementation of GCC and its supporting
+  MSYS toolkit, which provides a Win-32 implementation of the GNU bash
+  shell, and a few other essential utilities; these may be obtained from
 
     http://sourceforge.net/projects/mingw
 
-  by following the appropriate download links, where they are available as
-  self-extracting executable installation packages.  If installing both from
-  scratch, it is recommended that MinGW is installed first, as the MSYS
-  installer can then automatically set up the proper environment for running
-  MinGW.
+  by following the appropriate download links, where they are available
+  as self-extracting executable installation packages.  If installing
+  both from scratch, it is recommended that MinGW is installed first, as
+  the MSYS installer can then automatically set up the proper
+  environment for running MinGW.
 
-  Additionally, if you wish to compile groff with support for its HTML (and
-  XHTML) output capability, some additional tools are required as described in
-  the section PREREQUISITES FOR HTML OUTPUT later in this file.
+  Additionally, if you wish to compile groff with support for its HTML
+  (and XHTML) output capability, some additional tools are required as
+  described in the section PREREQUISITES FOR HTML OUTPUT later in this
+  file.
 
 
   BUILDING GROFF WITH MINGW
   -------------------------
 
   *** WARNING ***
-  
-  Before commencing this procedure, you should ensure that you are running the
-  MSYS shell in a *native* Win32 console window, and not in any window managed
-  by the rxvt emulator provided with MSYS; (this emulator suffers from various
-  known defects, which will prevent successful completion of a groff build).
+
+  Before commencing this procedure, you should ensure that you are
+  running the MSYS shell in a *native* Win32 console window, and not in
+  any window managed by the rxvt emulator provided with MSYS; (this
+  emulator suffers from various known defects, which will prevent
+  successful completion of a groff build).
 
   ******
 
-  Assuming that you have obtained the appropriate groff distribution, and that
-  you are already running an MSYS shell, then the configuration, compilation,
-  and installation of groff, using MinGW, is performed in much the same way as
-  it is described in the INSTALL file, which is provided with the groff
-  distribution.  The installation steps are summarised below:
+  Assuming that you have obtained the appropriate groff distribution,
+  and that you are already running an MSYS shell, then the
+  configuration, compilation, and installation of groff, using MinGW, is
+  performed in much the same way as it is described in the INSTALL file,
+  which is provided with the groff distribution.  The installation steps
+  are summarised below:
 
-  1. Change working directory to any suitable location where you may unpack
-     the groff distribution; you must be authorized for write access.
-     Approximately 30MB of free disk space are needed.
+  1. Change working directory to any suitable location where you may
+     unpack the groff distribution; you must be authorized for write
+     access.  Approximately 30MB of free disk space are needed.
 
   2. Unpack the groff distribution:
 
        tar xzf <download-path>/groff-<version>.tar.gz
 
-     This creates a new sub-directory, groff-<version>, containing an image of
-     the groff source tree.  You should now change directory, to make this
-     ./groff-<version> your working directory.
+     This creates a new sub-directory, groff-<version>, containing an
+     image of the groff source tree.  You should now change directory,
+     to make this ./groff-<version> your working directory.
 
-  3. If you are intending to build groff with support for HTML (and XHTML)
-     output, then you must now ensure that the prerequisites described in the
-     later section PREREQUISITES FOR HTML OUTPUT are satisfied, before
-     proceeding to build groff; in particular, please ensure that all required
-     support programs are installed in the current PATH.
+  3. If you are intending to build groff with support for HTML (and
+     XHTML) output, then you must now ensure that the prerequisites
+     described in the later section PREREQUISITES FOR HTML OUTPUT are
+     satisfied, before proceeding to build groff; in particular, please
+     ensure that all required support programs are installed in the
+     current PATH.
 
   4. You are now ready to configure, build, and install groff.  This is
-     accomplished using the conventional procedure, as described in the file
-     INSTALL, i.e.
+     accomplished using the conventional procedure, as described in the
+     file INSTALL, i.e.
 
        ./configure --prefix=<win32-install-path> ...
        make
        make install
 
-     Please observe the syntax for the configure command, indicated above; the
-     default value for --prefix is not suitable for use with MinGW, so the
-     --prefix=<win32-install-path> option must be specified, where
-     <win32-install-path> is the chosen MS-Windows directory in which the
-     groff application files are to be installed (see the later section
-     entitled CHOOSING AN INSTALLATION PATH).  Any other desired configuration
-     options may also be specified, as described in the standard groff
-     installation instructions.
-
-  5. After completing the above, groff should be successfully installed; the
-     build directory is no longer required; it may be simply deleted in its
-     entirety.  Alternatively, you may choose to keep it, but to remove all
-     files which can be reproduced later, by repeating the configure, make and
-     make install steps; this is readily accomplished by the command
+     Please observe the syntax for the configure command, indicated
+     above; the default value for --prefix is not suitable for use with
+     MinGW, so the --prefix=<win32-install-path> option must be
+     specified, where <win32-install-path> is the chosen MS-Windows
+     directory in which the groff application files are to be installed
+     (see the later section entitled CHOOSING AN INSTALLATION PATH).
+     Any other desired configuration options may also be specified, as
+     described in the standard groff installation instructions.
+
+  5. After completing the above, groff should be successfully installed;
+     the build directory is no longer required; it may be simply deleted
+     in its entirety.  Alternatively, you may choose to keep it, but to
+     remove all files which can be reproduced later, by repeating the
+     configure, make and make install steps; this is readily
+     accomplished by the command
 
        make distclean
 
 
-  This completes the installation of groff; please read the final sections of
-  this file, GROFF RUNTIME ENVIRONMENT and CAVEATS AND BUGS, for advice on
-  setting up the runtime environment, and avoiding known runtime problems,
-  before running groff.
+  This completes the installation of groff; please read the final
+  sections of this file, GROFF RUNTIME ENVIRONMENT and CAVEATS AND BUGS,
+  for advice on setting up the runtime environment, and avoiding known
+  runtime problems, before running groff.
 
 
   CHOOSING AN INSTALLATION PATH
   -----------------------------
 
-  It may be noted that the above instructions indicate that the ./configure
-  command must be invoked with an argument specifying a preference for
-  --prefix=<win32-install-path>, whereas the standard groff installation
-  instructions indicate that this may be omitted, in which case it defaults to
-  --prefix=/usr/local.
-
-  In the case of building with MinGW, the default behaviour of configure is
-  not appropriate for the following reasons.
-
-  o The MSYS environment creates a virtual Unix-like file system, with its
-    root mapped to the actual MS-Windows directory where MSYS itself is
-    installed; /usr is also mapped to this MSYS installation directory.
-
-  o All of the MSYS tools, and the MinGW implementation of GCC, refer to files
-    via this virtual file system representation; thus, if the
-    --prefix=<win32-install-path> is not specified when groff is configured,
-    `make install' causes groff to be installed in <MSYS-install-path>/local.
-
-  o groff needs to know its own installation path, so that it can locate its
-    own installed components.  This information is compiled in, using the
-    exact form specified with the --prefix=<win32-install-path> option to
-    configure.
-
-  o Knowledge of the MSYS virtual file system is not imparted to groff; it
-    expects the compiled-in path to its components to be a fully qualified
-    MS-Windows path name (although Unix-style slashes are permitted, and
-    preferred to the MS-Windows style backslashes, to demarcate the directory
-    hierarchy).  Thus, when configuring groff, if
-    --prefix=<win32-install-path> is not correctly specified, then the
-    installed groff application looks for its components in /usr/local, and
-    most likely doesn't find them, because they are actually installed in
-    <MSYS-install-path>/local.
+  It may be noted that the above instructions indicate that the
+  ./configure command must be invoked with an argument specifying a
+  preference for --prefix=<win32-install-path>, whereas the standard
+  groff installation instructions indicate that this may be omitted, in
+  which case it defaults to --prefix=/usr/local.
+
+  In the case of building with MinGW, the default behaviour of configure
+  is not appropriate for the following reasons.
 
-  It is actually convenient, but by no means a requirement, to have groff
-  installed in the /usr/local directory of the MSYS virtual file system; this
-  makes it easy to invoke groff from the MSYS shell, since the virtual
-  /usr/local/bin is normally added automatically to the PATH (the default
-  PATH, as set in MSYS's /etc/profile), when MSYS is started.
+  o The MSYS environment creates a virtual Unix-like file system, with
+    its root mapped to the actual MS-Windows directory where MSYS itself
+    is installed; /usr is also mapped to this MSYS installation
+    directory.
+
+  o All of the MSYS tools, and the MinGW implementation of GCC, refer to
+    files via this virtual file system representation; thus, if the
+    --prefix=<win32-install-path> is not specified when groff is
+    configured, `make install' causes groff to be installed in
+    <MSYS-install-path>/local.
 
-  In order to install groff into MSYS's /usr/local directory, it is necessary
-  to specify the fully qualified absolute MS-Windows path to this directory,
-  when configuring groff, i.e.
+  o groff needs to know its own installation path, so that it can locate
+    its own installed components.  This information is compiled in,
+    using the exact form specified with the
+    --prefix=<win32-install-path> option to configure.
+
+  o Knowledge of the MSYS virtual file system is not imparted to groff;
+    it expects the compiled-in path to its components to be a fully
+    qualified MS-Windows path name (although Unix-style slashes are
+    permitted, and preferred to the MS-Windows style backslashes, to
+    demarcate the directory hierarchy).  Thus, when configuring groff,
+    if --prefix=<win32-install-path> is not correctly specified, then
+    the installed groff application looks for its components in
+    /usr/local, and most likely doesn't find them, because they are
+    actually installed in <MSYS-install-path>/local.
+
+  It is actually convenient, but by no means a requirement, to have
+  groff installed in the /usr/local directory of the MSYS virtual file
+  system; this makes it easy to invoke groff from the MSYS shell, since
+  the virtual /usr/local/bin is normally added automatically to the PATH
+  (the default PATH, as set in MSYS's /etc/profile), when MSYS is
+  started.
+
+  In order to install groff into MSYS's /usr/local directory, it is
+  necessary to specify the fully qualified absolute MS-Windows path to
+  this directory, when configuring groff, i.e.
 
     ./configure --prefix=<MSYS-install-path>/local ...
 
-  For example, on a system where MSYS is installed in the MS-Windows directory
-  D:\MSYS\1.0, the MSYS virtual path /usr/local resolves to the absolute
-  MS-Windows native path D:\MSYS\1.0\local (the /usr component of the MSYS
-  virtual path does not appear in the resolved absolute native path name since
-  MSYS maps this directly to the root of the MSYS virtual file system).  Thus,
-  the --prefix option should be specified to configure as
+  For example, on a system where MSYS is installed in the MS-Windows
+  directory D:\MSYS\1.0, the MSYS virtual path /usr/local resolves to
+  the absolute MS-Windows native path D:\MSYS\1.0\local (the /usr
+  component of the MSYS virtual path does not appear in the resolved
+  absolute native path name since MSYS maps this directly to the root of
+  the MSYS virtual file system).  Thus, the --prefix option should be
+  specified to configure as
 
     ./configure --prefix=D:/MSYS/1.0/local ...
 
-  Note that the backslash characters, which appear in the native MS-Windows
-  form of the path name, are replaced by Unix-style slashes in the argument to
-  configure; this is the preferred syntax.
+  Note that the backslash characters, which appear in the native
+  MS-Windows form of the path name, are replaced by Unix-style slashes
+  in the argument to configure; this is the preferred syntax.
 
-  Also note that the MS-Windows device designator (D: in this instance) is
-  prepended to the specified path, in the normal MS-Windows format, and that,
-  since upper and lower case distinctions are ignored in MS-Windows path
-  names, any combination of upper and lower case is acceptable.
+  Also note that the MS-Windows device designator (D: in this instance)
+  is prepended to the specified path, in the normal MS-Windows format,
+  and that, since upper and lower case distinctions are ignored in
+  MS-Windows path names, any combination of upper and lower case is
+  acceptable.
 
 
   PREREQUISITES FOR HTML OUTPUT
   -----------------------------
 
-  If you intend to use groff for production of HTML or XHTML output, then
-  there are a few dependencies which must be satisfied.  Ideally, these should
-  be resolved before attempting to configure and build groff, since the
-  configuration script does check them.
+  If you intend to use groff for production of HTML or XHTML output,
+  then there are a few dependencies which must be satisfied.  Ideally,
+  these should be resolved before attempting to configure and build
+  groff, since the configuration script does check them.
 
   In order to produce HTML or XHTML output, you first require a working
   implementation of Ghostscript; either the AFPL Ghostscript or the GNU
-  Ghostscript implementation for MS-Windows should be suitable, depending on
-  your licensing preference.  It is highly recommended to use version 8.11
-  or higher due to bugs in older versions.  These may be obtained, in the
-  form of self-installing binary packages, by following the download links
-  for the chosen licensing option, from
+  Ghostscript implementation for MS-Windows should be suitable,
+  depending on your licensing preference.  It is highly recommended to
+  use version 8.11 or higher due to bugs in older versions.  These may
+  be obtained, in the form of self-installing binary packages, by
+  following the download links for the chosen licensing option, from
   http://sourceforge.net/projects/ghostscript.
 
-  Please note that these packages install the Ghostscript interpreter required
-  by groff in the ./bin subdirectory of the Ghostscript installation
-  directory, with the name gswin32c.exe.  However, groff expects this
-  interpreter to be located in the system PATH, with the name gs.exe.  Thus,
-  to ensure that groff can correctly locate the Ghostscript interpreter, it is
-  recommended that the file gswin32c.exe should be copied from the Ghostscript
-  installation directory to the MSYS /usr/local/bin directory, where it should
-  be renamed to gs.exe.
-
-  In addition to a working Ghostscript interpreter, you also require several
-  image manipulation utilities, all of which may be scavenged from various
-  packages available from http://sourceforge.net/projects/gnuwin32, and which
-  should be installed in the MSYS /usr/local/bin directory, or any other
-  suitable directory which is specified in the PATH.  These additional
+  Please note that these packages install the Ghostscript interpreter
+  required by groff in the ./bin subdirectory of the Ghostscript
+  installation directory, with the name gswin32c.exe.  However, groff
+  expects this interpreter to be located in the system PATH, with the
+  name gs.exe.  Thus, to ensure that groff can correctly locate the
+  Ghostscript interpreter, it is recommended that the file gswin32c.exe
+  should be copied from the Ghostscript installation directory to the
+  MSYS /usr/local/bin directory, where it should be renamed to gs.exe.
+
+  In addition to a working Ghostscript interpreter, you also require
+  several image manipulation utilities, all of which may be scavenged
+  from various packages available from
+  http://sourceforge.net/projects/gnuwin32, and which should be
+  installed in the MSYS /usr/local/bin directory, or any other suitable
+  directory which is specified in the PATH.  These additional
   prerequisites are
 
     1. from the netpbm-<version>-bin.zip package:
@@ -223,84 +235,92 @@
 
          psselect.exe
 
-  Note that it is not necessary to install the above four packages in their
-  entirety; of course, you may do so if you wish.
+  Note that it is not necessary to install the above four packages in
+  their entirety; of course, you may do so if you wish.
 
-  Further note that you are advised to avoid the netpbm-10.27 release from the
-  GnuWin32 download repository, as its pnmtopng.exe has been reported to fail
-  on even simple conversions, resulting in failure of the groff build process;
-  the earlier netpbm-10.18.4 has been found to work successfully.  Also, you
-  may find it necessary to use libpng-1.2.7, rather than libpng-1.2.8, in
-  conjunction with this earlier release of netpbm.
+  Further note that you are advised to avoid the netpbm-10.27 release
+  from the GnuWin32 download repository, as its pnmtopng.exe has been
+  reported to fail on even simple conversions, resulting in failure of
+  the groff build process; the earlier netpbm-10.18.4 has been found to
+  work successfully.  Also, you may find it necessary to use
+  libpng-1.2.7, rather than libpng-1.2.8, in conjunction with this
+  earlier release of netpbm.
 
 
   GROFF RUNTIME ENVIRONMENT
   -------------------------
 
-  The runtime environment, provided to groff by MSYS, is essentially the same
-  as would be provided under a Unix or GNU/Linux operating system; thus, any
-  environment variables which may be used to customize the groff runtime
-  environment have similar effects under MSYS, as they would in Unix or
-  GNU/Linux, with the exception that any variable specifying a path should
-  adopt the same syntax as a native MS-Windows PATH specification.
+  The runtime environment, provided to groff by MSYS, is essentially the
+  same as would be provided under a Unix or GNU/Linux operating system;
+  thus, any environment variables which may be used to customize the
+  groff runtime environment have similar effects under MSYS, as they
+  would in Unix or GNU/Linux, with the exception that any variable
+  specifying a path should adopt the same syntax as a native MS-Windows
+  PATH specification.
 
   There is, however, one known problem which is associated with the
-  implementation of the MS-Windows file system, and the manner in which the
-  Microsoft runtime library (which is used by the MinGW implementation of GCC)
-  generates names for temporary files.  This known problem arises when groff
-  is invoked with a current working directory which refers to a network share,
-  for which the user does not have write access in the root directory, and
-  there is no environment variable set to define a writeable location for
-  creating temporary files.  When these conditions arise, groff fails with a
-  `permission denied' error, as soon as it tries to create any temporary file.
-
-  To specify the location for creating temporary files, the standard Unix or
-  GNU/Linux implementation of groff provides the GROFF_TMPDIR or TMPDIR
-  environment variables, whereas MS-Windows applications generally use TMP or
-  TEMP; furthermore, the MS-Windows implementations of Ghostscript apparently
-  support the use of only TEMP or TMPDIR.
-
-  To avoid problems with creation of temporary files, it is recommended that
-  you ensure that both TMP and TEMP are defined, with identical values, to
-  point to a suitable location for creating temporary files; many MS-Windows
-  boxes have them set already, and groff has been adapted to honour them, when
-  built in accordance with the preceding instructions, using MinGW.
+  implementation of the MS-Windows file system, and the manner in which
+  the Microsoft runtime library (which is used by the MinGW
+  implementation of GCC) generates names for temporary files.  This
+  known problem arises when groff is invoked with a current working
+  directory which refers to a network share, for which the user does not
+  have write access in the root directory, and there is no environment
+  variable set to define a writeable location for creating temporary
+  files.  When these conditions arise, groff fails with a `permission
+  denied' error, as soon as it tries to create any temporary file.
+
+  To specify the location for creating temporary files, the standard
+  Unix or GNU/Linux implementation of groff provides the GROFF_TMPDIR or
+  TMPDIR environment variables, whereas MS-Windows applications
+  generally use TMP or TEMP; furthermore, the MS-Windows implementations
+  of Ghostscript apparently support the use of only TEMP or TMPDIR.
+
+  To avoid problems with creation of temporary files, it is recommended
+  that you ensure that both TMP and TEMP are defined, with identical
+  values, to point to a suitable location for creating temporary files;
+  many MS-Windows boxes have them set already, and groff has been
+  adapted to honour them, when built in accordance with the preceding
+  instructions, using MinGW.
 
 
   CAVEATS AND BUGS
   ----------------
 
-  There are two known issues, observed when running groff in the MinGW/MSYS
-  environment, which would not affect groff in its native Unix environment:
+  There are two known issues, observed when running groff in the
+  MinGW/MSYS environment, which would not affect groff in its native
+  Unix environment:
 
   o Running groff with the working directory set to a subdirectory of a
-    network share, where the user does not have write permission in the root
-    directory of the share, causes groff to fail with a `permission denied'
-    exception, if the TMP environment variable is not appropriately defined;
-    it may also be necessary to define the TEMP environment variable, to
-    avoid a similar failure mode, when using the -Thtml or -Txhtml output
-    mode of groff.  This problem is more fully discussed in the preceding
-    section, GROFF RUNTIME ENVIRONMENT.
+    network share, where the user does not have write permission in the
+    root directory of the share, causes groff to fail with a `permission
+    denied' exception, if the TMP environment variable is not
+    appropriately defined; it may also be necessary to define the TEMP
+    environment variable, to avoid a similar failure mode, when using
+    the -Thtml or -Txhtml output mode of groff.  This problem is more
+    fully discussed in the preceding section, GROFF RUNTIME ENVIRONMENT.
 
   o When running groff (or nroff) to process standard input, where the
-    standard input stream is obtained directly from the RXVT console provided
-    with MSYS, groff cannot detect the end-of-file condition for the standard
-    input stream, and hangs.  This appears to be caused by a fault in the MSYS
-    implementation of RXVT; it may be worked around by either starting MSYS
-    without RXVT (see the comments in the MSYS.BAT startup script); in this
-    case standard input is terminated by typing <Ctrl-Z> followed by <RETURN>,
-    on a new input line.  Alternatively, if you prefer to use MSYS with RXVT,
-    you can enter the interactive groff command in the form
+    standard input stream is obtained directly from the RXVT console
+    provided with MSYS, groff cannot detect the end-of-file condition
+    for the standard input stream, and hangs.  This appears to be caused
+    by a fault in the MSYS implementation of RXVT; it may be worked
+    around by either starting MSYS without RXVT (see the comments in the
+    MSYS.BAT startup script); in this case standard input is terminated
+    by typing <Ctrl-Z> followed by <RETURN>, on a new input line.
+    Alternatively, if you prefer to use MSYS with RXVT, you can enter
+    the interactive groff command in the form
 
       cat | groff ...
 
-    in which case <Ctrl-D> terminates the standard input stream, in just the
-    same way it does on a Unix system; the cat executable provided with MSYS
-    does seem to trap the end-of-file condition, and properly signals groff
-    that the input stream has terminated.
+    in which case <Ctrl-D> terminates the standard input stream, in just
+    the same way it does on a Unix system; the cat executable provided
+    with MSYS does seem to trap the end-of-file condition, and properly
+    signals groff that the input stream has terminated.
 
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/TODO -> _service:tar_scm:groff-1.23.0.tar.gz/TODO Changed

@@ -1,13 +1,13 @@
-# Copyright (C) 2000-2018 Free Software Foundation, Inc.
+# Copyright (C) 2000-2020 Free Software Foundation, Inc.
 #
-# This file is part of `groffer' which is part of `groff'.
+# This file is part of groff.
 #
-# `groff' is free software; you can redistribute it and/or modify it
+# 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.
 #
-# `groff' is distributed in the hope that it will be useful, but
+# 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.
@@ -27,8 +27,6 @@
 
 Improve GROFF_PRINT macro in aclocal.m4.
 
-Provide a `check' target.
-
 Provide a `bindist' target.
 
 Implement tmac.bib in terms of tmac.s.

_service:tar_scm:groff-1.22.4.tar.gz/acinclude.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/acinclude.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/aclocal.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/aclocal.m4 Changed

@@ -1,6 +1,6 @@
-# generated automatically by aclocal 1.16.1 -*- Autoconf -*-
+# generated automatically by aclocal 1.16.5 -*- Autoconf -*-
 
-# Copyright (C) 1996-2018 Free Software Foundation, Inc.
+# Copyright (C) 1996-2021 Free Software Foundation, Inc.
 
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -14,8 +14,8 @@
 m4_ifndef(AC_CONFIG_MACRO_DIRS, m4_defun(_AM_CONFIG_MACRO_DIRS, )m4_defun(AC_CONFIG_MACRO_DIRS, _AM_CONFIG_MACRO_DIRS($@)))
 m4_ifndef(AC_AUTOCONF_VERSION,
   m4_copy(m4_PACKAGE_VERSION, AC_AUTOCONF_VERSION))dnl
-m4_if(m4_defn(AC_AUTOCONF_VERSION), 2.69,,
-m4_warning(this file was generated for autoconf 2.69.
+m4_if(m4_defn(AC_AUTOCONF_VERSION), 2.71,,
+m4_warning(this file was generated for autoconf 2.71.
 You have another version of autoconf.  It may work, but is not guaranteed to.
 If you have problems, you may need to regenerate the build system entirely.
 To do so, use the procedure documented by the package, typically 'autoreconf'.))
@@ -364,7 +364,7 @@
         AC_DEFINE(HAVE_$1, 1, Enable m4_tolower($1) support))
 )dnl PKG_HAVE_DEFINE_WITH_MODULES
 
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -379,7 +379,7 @@
 am__api_version='1.16'
 dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to
 dnl require some minimum version.  Point them to the right macro.
-m4_if($1, 1.16.1, ,
+m4_if($1, 1.16.5, ,
       AC_FATAL(Do not call $0, use AM_INIT_AUTOMAKE($1).))dnl
 )
 
@@ -395,14 +395,14 @@
 # Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced.
 # This function is AC_REQUIREd by AM_INIT_AUTOMAKE.
 AC_DEFUN(AM_SET_CURRENT_AUTOMAKE_VERSION,
-AM_AUTOMAKE_VERSION(1.16.1)dnl
+AM_AUTOMAKE_VERSION(1.16.5)dnl
 m4_ifndef(AC_AUTOCONF_VERSION,
   m4_copy(m4_PACKAGE_VERSION, AC_AUTOCONF_VERSION))dnl
 _AM_AUTOCONF_VERSION(m4_defn(AC_AUTOCONF_VERSION)))
 
 # AM_AUX_DIR_EXPAND                                         -*- Autoconf -*-
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -452,9 +452,46 @@
 am_aux_dir=`cd "$ac_aux_dir" && pwd`
 )
 
+# AM_COND_IF                                            -*- Autoconf -*-
+
+# Copyright (C) 2008-2021 Free Software Foundation, Inc.
+#
+# This file is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# _AM_COND_IF
+# _AM_COND_ELSE
+# _AM_COND_ENDIF
+# --------------
+# These macros are only used for tracing.
+m4_define(_AM_COND_IF)
+m4_define(_AM_COND_ELSE)
+m4_define(_AM_COND_ENDIF)
+
+# AM_COND_IF(COND, IF-TRUE, IF-FALSE)
+# ---------------------------------------
+# If the shell condition COND is true, execute IF-TRUE, otherwise execute
+# IF-FALSE.  Allow automake to learn about conditional instantiating macros
+# (the AC_CONFIG_FOOS).
+AC_DEFUN(AM_COND_IF,
+m4_ifndef(_AM_COND_VALUE_$1,
+	   m4_fatal($0: no such condition "$1"))dnl
+_AM_COND_IF($1)dnl
+if test -z "$$1_TRUE"; then :
+  m4_n($2)dnl
+m4_ifval($3,
+_AM_COND_ELSE($1)dnl
+else
+  $3
+)dnl
+_AM_COND_ENDIF($1)dnl
+fidnl
+)
+
 # AM_CONDITIONAL                                            -*- Autoconf -*-
 
-# Copyright (C) 1997-2018 Free Software Foundation, Inc.
+# Copyright (C) 1997-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -485,7 +522,7 @@
 Usually this means the macro was only invoked conditionally.)
 fi))
 
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
+# Copyright (C) 1999-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -676,7 +713,7 @@
 
 # Generate code to set up dependency tracking.              -*- Autoconf -*-
 
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
+# Copyright (C) 1999-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -715,7 +752,9 @@
   done
   if test $am_rc -ne 0; then
     AC_MSG_FAILURE(Something went wrong bootstrapping makefile fragments
-    for automatic dependency tracking.  Try re-running configure with the
+    for automatic dependency tracking.  If GNU make was not used, consider
+    re-running the configure script with MAKE="gmake" (or whatever is
+    necessary).  You can also try re-running configure with the
     '--disable-dependency-tracking' option to at least be able to build
     the package (albeit without support for automatic dependency tracking).)
   fi
@@ -742,7 +781,7 @@
 
 # Do all the work for Automake.                             -*- Autoconf -*-
 
-# Copyright (C) 1996-2018 Free Software Foundation, Inc.
+# Copyright (C) 1996-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -770,6 +809,10 @@
 # release and drop the old call support.
 AC_DEFUN(AM_INIT_AUTOMAKE,
 AC_PREREQ(2.65)dnl
+m4_ifdef(_$0_ALREADY_INIT,
+  m4_fatal($0 expanded multiple times
+m4_defn(_$0_ALREADY_INIT)),
+  m4_define(_$0_ALREADY_INIT, m4_expansion_stack))dnl
 dnl Autoconf wants to disallow AM_ names.  We explicitly allow
 dnl the ones we care about.
 m4_pattern_allow(^AM_A-Z+FLAGS$)dnl
@@ -806,7 +849,7 @@
 _AM_SET_OPTIONS($1)dnl
 dnl Diagnose old-style AC_INIT with new-style AM_AUTOMAKE_INIT.
 m4_if(
-  m4_ifdef(AC_PACKAGE_NAME, ok):m4_ifdef(AC_PACKAGE_VERSION, ok),
+  m4_ifset(AC_PACKAGE_NAME, ok):m4_ifset(AC_PACKAGE_VERSION, ok),
   ok:ok,,
   m4_fatal(AC_INIT should be called with package and version arguments))dnl
  AC_SUBST(PACKAGE, 'AC_PACKAGE_TARNAME')dnl
@@ -858,6 +901,20 @@
 		  m4_define(AC_PROG_OBJCXX,
 			     m4_defn(AC_PROG_OBJCXX)_AM_DEPENDENCIES(OBJCXX)))dnl
 )
+# Variables for tags utilities; see am/tags.am
+if test -z "$CTAGS"; then
+  CTAGS=ctags
+fi
+AC_SUBST(CTAGS)
+if test -z "$ETAGS"; then
+  ETAGS=etags
+fi
+AC_SUBST(ETAGS)
+if test -z "$CSCOPE"; then
+  CSCOPE=cscope
+fi
+AC_SUBST(CSCOPE)
+
 AC_REQUIRE(AM_SILENT_RULES)dnl
 dnl The testsuite driver may need to know about EXEEXT, so add the
 dnl 'am__EXEEXT' conditional if _AM_COMPILER_EXEEXT was seen.  This
@@ -939,7 +996,7 @@
 done
 echo "timestamp for $_am_arg" >`AS_DIRNAME("$_am_arg")`/stamp-h$_am_stamp_count)
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -960,7 +1017,7 @@
 fi
 AC_SUBST(install_sh))
 
-# Copyright (C) 2003-2018 Free Software Foundation, Inc.
+# Copyright (C) 2003-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -981,7 +1038,7 @@
 
 # Check to see how 'make' treats includes.	            -*- Autoconf -*-
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1024,7 +1081,7 @@
 
 # Fake the existence of programs that GNU maintainers use.  -*- Autoconf -*-
 
-# Copyright (C) 1997-2018 Free Software Foundation, Inc.
+# Copyright (C) 1997-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1045,12 +1102,7 @@
 AC_REQUIRE(AM_AUX_DIR_EXPAND)dnl
 AC_REQUIRE_AUX_FILE(missing)dnl
 if test x"${MISSING+set}" != xset; then
-  case $am_aux_dir in
-  *\ * | *\	*)
-    MISSING="\${SHELL} \"$am_aux_dir/missing\"" ;;
-  *)
-    MISSING="\${SHELL} $am_aux_dir/missing" ;;
-  esac
+  MISSING="\${SHELL} '$am_aux_dir/missing'"
 fi
 # Use eval to expand $SHELL
 if eval "$MISSING --is-lightweight"; then
@@ -1063,7 +1115,7 @@
 
 # Helper functions for option handling.                     -*- Autoconf -*-
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1092,7 +1144,7 @@
 AC_DEFUN(_AM_IF_OPTION,
 m4_ifset(_AM_MANGLE_OPTION($1), $2, $3))
 
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
+# Copyright (C) 1999-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1139,7 +1191,7 @@
 # For backward compatibility.
 AC_DEFUN_ONCE(AM_PROG_CC_C_O, AC_REQUIRE(AC_PROG_CC))
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1158,7 +1210,7 @@
 
 # Check to make sure that the build environment is sane.    -*- Autoconf -*-
 
-# Copyright (C) 1996-2018 Free Software Foundation, Inc.
+# Copyright (C) 1996-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1239,7 +1291,7 @@
 rm -f conftest.file
 )
 
-# Copyright (C) 2009-2018 Free Software Foundation, Inc.
+# Copyright (C) 2009-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1299,7 +1351,7 @@
 _AM_SUBST_NOTMAKE(AM_BACKSLASH)dnl
 )
 
-# Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# Copyright (C) 2001-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1327,7 +1379,7 @@
 INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s"
 AC_SUBST(INSTALL_STRIP_PROGRAM))
 
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# Copyright (C) 2006-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1346,7 +1398,7 @@
 
 # Check how to create a tarball.                            -*- Autoconf -*-
 
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
+# Copyright (C) 2004-2021 Free Software Foundation, Inc.
 #
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -1480,7 +1532,7 @@
 m4_include(gnulib_m4/00gnulib.m4)
 m4_include(gnulib_m4/absolute-header.m4)
 m4_include(gnulib_m4/alloca.m4)
-m4_include(gnulib_m4/asm-underscore.m4)
+m4_include(gnulib_m4/assert_h.m4)
 m4_include(gnulib_m4/errno_h.m4)
 m4_include(gnulib_m4/exponentd.m4)
 m4_include(gnulib_m4/exponentf.m4)
@@ -1490,14 +1542,15 @@
 m4_include(gnulib_m4/float_h.m4)
 m4_include(gnulib_m4/fpieee.m4)
 m4_include(gnulib_m4/fprintf-posix.m4)
+m4_include(gnulib_m4/free.m4)
 m4_include(gnulib_m4/frexp.m4)
 m4_include(gnulib_m4/frexpl.m4)
 m4_include(gnulib_m4/fseterr.m4)
 m4_include(gnulib_m4/gnulib-common.m4)
 m4_include(gnulib_m4/gnulib-comp.m4)
-m4_include(gnulib_m4/host-cpu-c-abi.m4)
 m4_include(gnulib_m4/include_next.m4)
 m4_include(gnulib_m4/intmax_t.m4)
+m4_include(gnulib_m4/inttypes.m4)
 m4_include(gnulib_m4/inttypes_h.m4)
 m4_include(gnulib_m4/isnand.m4)
 m4_include(gnulib_m4/isnanf.m4)
@@ -1505,13 +1558,11 @@
 m4_include(gnulib_m4/ldexpl.m4)
 m4_include(gnulib_m4/libunistring-base.m4)
 m4_include(gnulib_m4/limits-h.m4)
-m4_include(gnulib_m4/longlong.m4)
 m4_include(gnulib_m4/math_h.m4)
 m4_include(gnulib_m4/memchr.m4)
 m4_include(gnulib_m4/mmap-anon.m4)
 m4_include(gnulib_m4/multiarch.m4)
 m4_include(gnulib_m4/nocrash.m4)
-m4_include(gnulib_m4/non-recursive-gnulib-prefix-hack.m4)
 m4_include(gnulib_m4/off_t.m4)
 m4_include(gnulib_m4/printf-frexp.m4)
 m4_include(gnulib_m4/printf-frexpl.m4)
@@ -1520,12 +1571,15 @@
 m4_include(gnulib_m4/size_max.m4)
 m4_include(gnulib_m4/snprintf.m4)
 m4_include(gnulib_m4/ssize_t.m4)
+m4_include(gnulib_m4/stdbool.m4)
 m4_include(gnulib_m4/stddef_h.m4)
 m4_include(gnulib_m4/stdint.m4)
 m4_include(gnulib_m4/stdint_h.m4)
 m4_include(gnulib_m4/stdio_h.m4)
+m4_include(gnulib_m4/stdlib_h.m4)
 m4_include(gnulib_m4/string_h.m4)
 m4_include(gnulib_m4/sys_types_h.m4)
+m4_include(gnulib_m4/unistd_h.m4)
 m4_include(gnulib_m4/vasnprintf.m4)
 m4_include(gnulib_m4/vsnprintf.m4)
 m4_include(gnulib_m4/warn-on-use.m4)
@@ -1535,4 +1589,5 @@
 m4_include(gnulib_m4/wcwidth.m4)
 m4_include(gnulib_m4/wint_t.m4)
 m4_include(gnulib_m4/xsize.m4)
+m4_include(gnulib_m4/zzgnulib.m4)
 m4_include(acinclude.m4)

_service:tar_scm:groff-1.22.4.tar.gz/arch/djgpp/README -> _service:tar_scm:groff-1.23.0.tar.gz/arch/djgpp/README Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/djgpp/config.bat -> _service:tar_scm:groff-1.23.0.tar.gz/arch/djgpp/config.bat Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/djgpp/config.sed -> _service:tar_scm:groff-1.23.0.tar.gz/arch/djgpp/config.sed Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/djgpp/config.site -> _service:tar_scm:groff-1.23.0.tar.gz/arch/djgpp/config.site Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/djgpp/t-groff.bat -> _service:tar_scm:groff-1.23.0.tar.gz/arch/djgpp/t-groff.bat Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/mingw/grap2graph.cmd -> _service:tar_scm:groff-1.23.0.tar.gz/arch/mingw/grap2graph.cmd Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/mingw/mingw.am -> _service:tar_scm:groff-1.23.0.tar.gz/arch/mingw/mingw.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/arch/misc/misc.am -> _service:tar_scm:groff-1.23.0.tar.gz/arch/misc/misc.am Changed

@@ -1,33 +1,35 @@
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
+# Copyright (C) 2004-2023 Free Software Foundation, Inc.
 # Original Makefile.sub written by Keith Marshall
-#   (keith.d.marshall@ntlworld.com).
-# Adapted to Automake by Bertrand Garrigues (bertrand.garrigues@laposte.net).
-#
-# Last update: 13 Aug 2015
+#   <keith.d.marshall@ntlworld.com>.
+# Adapted to Automake by Bertrand Garrigues
+#   <bertrand.garrigues@laposte.net>.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
-EXTRA_DIST += arch/misc/shdeps.sh
+
+arch_shdeps_sh = arch/misc/shdeps.sh
+EXTRA_DIST += $(arch_shdeps_sh)
 MOSTLYCLEANFILES += shdeps.sed
 
-shdeps.sed: $(top_srcdir)/arch/misc/shdeps.sh
-	$(SHELL) $(top_srcdir)/arch/misc/shdeps.sh "$(RT_SEP)" "$(SH_SEP)" "$(bindir)" > $@
+$(SH_DEPS_SED_SCRIPT): $(top_srcdir)/$(arch_shdeps_sh)
+	$(AM_V_GEN)$(SHELL) $(top_srcdir)/$(arch_shdeps_sh) \
+	  "$(RT_SEP)" "$(SH_SEP)" "$(bindir)" > $@
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/arch/misc/shdeps.sh -> _service:tar_scm:groff-1.23.0.tar.gz/arch/misc/shdeps.sh Changed

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/compile -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/compile Changed

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/config.guess -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/config.guess Changed

@@ -1,12 +1,14 @@
 #! /bin/sh
 # Attempt to guess a canonical system name.
-#   Copyright 1992-2018 Free Software Foundation, Inc.
+#   Copyright 1992-2023 Free Software Foundation, Inc.
 
-timestamp='2018-08-29'
+# shellcheck disable=SC2006,SC2268 # see below for rationale
+
+timestamp='2023-01-01'
 
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This program is distributed in the hope that it will be useful, but
@@ -27,11 +29,19 @@
 # Originally written by Per Bothner; maintained since 2000 by Ben Elliston.
 #
 # You can get the latest version of this script from:
-# https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess
+# https://git.savannah.gnu.org/cgit/config.git/plain/config.guess
 #
 # Please send patches to <config-patches@gnu.org>.
 
 
+# The "shellcheck disable" line above the timestamp inhibits complaints
+# about features and limitations of the classic Bourne shell that were
+# superseded or lifted in POSIX.  However, this script identifies a wide
+# variety of pre-POSIX systems that do not have POSIX shells at all, and
+# even some reasonably current systems (Solaris 10 as case-in-point) still
+# have a pre-POSIX /bin/sh.
+
+
 me=`echo "$0" | sed -e 's,.*/,,'`
 
 usage="\
@@ -50,7 +60,7 @@
 GNU config.guess ($timestamp)
 
 Originally written by Per Bothner.
-Copyright 1992-2018 Free Software Foundation, Inc.
+Copyright 1992-2023 Free Software Foundation, Inc.
 
 This is free software; see the source for copying conditions.  There is NO
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
@@ -84,6 +94,9 @@
   exit 1
 fi
 
+# Just in case it came from the environment.
+GUESS=
+
 # CC_FOR_BUILD -- compiler used by this script. Note that the use of a
 # compiler to aid in system detection is discouraged as it requires
 # temporary files to be created and, as you can see below, it is a
@@ -96,12 +109,13 @@
 
 tmp=
 # shellcheck disable=SC2172
-trap 'test -z "$tmp" || rm -fr "$tmp"' 1 2 13 15
-trap 'exitcode=$?; test -z "$tmp" || rm -fr "$tmp"; exit $exitcode' 0
+trap 'test -z "$tmp" || rm -fr "$tmp"' 0 1 2 13 15
 
 set_cc_for_build() {
+    # prevent multiple calls if $tmp is already set
+    test "$tmp" && return 0
     : "${TMPDIR=/tmp}"
-    # shellcheck disable=SC2039
+    # shellcheck disable=SC2039,SC3028
     { tmp=`(umask 077 && mktemp -d "$TMPDIR/cgXXXXXX") 2>/dev/null` && test -n "$tmp" && test -d "$tmp" ; } ||
 	{ test -n "$RANDOM" && tmp=$TMPDIR/cg$$-$RANDOM && (umask 077 && mkdir "$tmp" 2>/dev/null) ; } ||
 	{ tmp=$TMPDIR/cg-$$ && (umask 077 && mkdir "$tmp" 2>/dev/null) && echo "Warning: creating insecure temp directory" >&2 ; } ||
@@ -111,7 +125,7 @@
 	,,)    echo "int x;" > "$dummy.c"
 	       for driver in cc gcc c89 c99 ; do
 		   if ($driver -c -o "$dummy.o" "$dummy.c") >/dev/null 2>&1 ; then
-		       CC_FOR_BUILD="$driver"
+		       CC_FOR_BUILD=$driver
 		       break
 		   fi
 	       done
@@ -132,14 +146,12 @@
 
 UNAME_MACHINE=`(uname -m) 2>/dev/null` || UNAME_MACHINE=unknown
 UNAME_RELEASE=`(uname -r) 2>/dev/null` || UNAME_RELEASE=unknown
-UNAME_SYSTEM=`(uname -s) 2>/dev/null`  || UNAME_SYSTEM=unknown
+UNAME_SYSTEM=`(uname -s) 2>/dev/null` || UNAME_SYSTEM=unknown
 UNAME_VERSION=`(uname -v) 2>/dev/null` || UNAME_VERSION=unknown
 
-case "$UNAME_SYSTEM" in
+case $UNAME_SYSTEM in
 Linux|GNU|GNU/*)
-	# If the system lacks a compiler, then just pick glibc.
-	# We could probably try harder.
-	LIBC=gnu
+	LIBC=unknown
 
 	set_cc_for_build
 	cat <<-EOF > "$dummy.c"
@@ -148,24 +160,37 @@
 	LIBC=uclibc
 	#elif defined(__dietlibc__)
 	LIBC=dietlibc
-	#else
+	#elif defined(__GLIBC__)
 	LIBC=gnu
+	#else
+	#include <stdarg.h>
+	/* First heuristic to detect musl libc.  */
+	#ifdef __DEFINED_va_list
+	LIBC=musl
+	#endif
 	#endif
 	EOF
-	eval "`$CC_FOR_BUILD -E "$dummy.c" 2>/dev/null | grep '^LIBC' | sed 's, ,,g'`"
+	cc_set_libc=`$CC_FOR_BUILD -E "$dummy.c" 2>/dev/null | grep '^LIBC' | sed 's, ,,g'`
+	eval "$cc_set_libc"
 
-	# If ldd exists, use it to detect musl libc.
-	if command -v ldd >/dev/null && \
-		ldd --version 2>&1 | grep -q ^musl
-	then
-	    LIBC=musl
+	# Second heuristic to detect musl libc.
+	if  "$LIBC" = unknown  &&
+	   command -v ldd >/dev/null &&
+	   ldd --version 2>&1 | grep -q ^musl; then
+		LIBC=musl
+	fi
+
+	# If the system lacks a compiler, then just pick glibc.
+	# We could probably try harder.
+	if  "$LIBC" = unknown ; then
+		LIBC=gnu
 	fi
 	;;
 esac
 
 # Note: order is significant - the case branches are not exclusive.
 
-case "$UNAME_MACHINE:$UNAME_SYSTEM:$UNAME_RELEASE:$UNAME_VERSION" in
+case $UNAME_MACHINE:$UNAME_SYSTEM:$UNAME_RELEASE:$UNAME_VERSION in
     *:NetBSD:*:*)
 	# NetBSD (nbsd) targets should (where applicable) match one or
 	# more of the tuples: *-*-netbsdelf*, *-*-netbsdaout*,
@@ -177,12 +202,12 @@
 	#
 	# Note: NetBSD doesn't particularly care about the vendor
 	# portion of the name.  We always set it to "unknown".
-	sysctl="sysctl -n hw.machine_arch"
 	UNAME_MACHINE_ARCH=`(uname -p 2>/dev/null || \
-	    "/sbin/$sysctl" 2>/dev/null || \
-	    "/usr/sbin/$sysctl" 2>/dev/null || \
+	    /sbin/sysctl -n hw.machine_arch 2>/dev/null || \
+	    /usr/sbin/sysctl -n hw.machine_arch 2>/dev/null || \
 	    echo unknown)`
-	case "$UNAME_MACHINE_ARCH" in
+	case $UNAME_MACHINE_ARCH in
+	    aarch64eb) machine=aarch64_be-unknown ;;
 	    armeb) machine=armeb-unknown ;;
 	    arm*) machine=arm-unknown ;;
 	    sh3el) machine=shl-unknown ;;
@@ -191,13 +216,13 @@
 	    earmv*)
 		arch=`echo "$UNAME_MACHINE_ARCH" | sed -e 's,^e$armv0-9$.*$,\1,'`
 		endian=`echo "$UNAME_MACHINE_ARCH" | sed -ne 's,^.*$eb$$,\1,p'`
-		machine="${arch}${endian}"-unknown
+		machine=${arch}${endian}-unknown
 		;;
-	    *) machine="$UNAME_MACHINE_ARCH"-unknown ;;
+	    *) machine=$UNAME_MACHINE_ARCH-unknown ;;
 	esac
 	# The Operating System including object format, if it has switched
 	# to ELF recently (or will in the future) and ABI.
-	case "$UNAME_MACHINE_ARCH" in
+	case $UNAME_MACHINE_ARCH in
 	    earm*)
 		os=netbsdelf
 		;;
@@ -218,7 +243,7 @@
 		;;
 	esac
 	# Determine ABI tags.
-	case "$UNAME_MACHINE_ARCH" in
+	case $UNAME_MACHINE_ARCH in
 	    earm*)
 		expr='s/^earmv0-9/-eabi/;s/eb$//'
 		abi=`echo "$UNAME_MACHINE_ARCH" | sed -e "$expr"`
@@ -229,7 +254,7 @@
 	# thus, need a distinct triplet. However, they do not need
 	# kernel version information, so it can be replaced with a
 	# suitable tag, in the style of linux-gnu.
-	case "$UNAME_VERSION" in
+	case $UNAME_VERSION in
 	    Debian*)
 		release='-gnu'
 		;;
@@ -240,45 +265,57 @@
 	# Since CPU_TYPE-MANUFACTURER-KERNEL-OPERATING_SYSTEM:
 	# contains redundant information, the shorter form:
 	# CPU_TYPE-MANUFACTURER-OPERATING_SYSTEM is used.
-	echo "$machine-${os}${release}${abi-}"
-	exit ;;
+	GUESS=$machine-${os}${release}${abi-}
+	;;
     *:Bitrig:*:*)
 	UNAME_MACHINE_ARCH=`arch | sed 's/Bitrig.//'`
-	echo "$UNAME_MACHINE_ARCH"-unknown-bitrig"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE_ARCH-unknown-bitrig$UNAME_RELEASE
+	;;
     *:OpenBSD:*:*)
 	UNAME_MACHINE_ARCH=`arch | sed 's/OpenBSD.//'`
-	echo "$UNAME_MACHINE_ARCH"-unknown-openbsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE_ARCH-unknown-openbsd$UNAME_RELEASE
+	;;
+    *:SecBSD:*:*)
+	UNAME_MACHINE_ARCH=`arch | sed 's/SecBSD.//'`
+	GUESS=$UNAME_MACHINE_ARCH-unknown-secbsd$UNAME_RELEASE
+	;;
     *:LibertyBSD:*:*)
 	UNAME_MACHINE_ARCH=`arch | sed 's/^.*BSD\.//'`
-	echo "$UNAME_MACHINE_ARCH"-unknown-libertybsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE_ARCH-unknown-libertybsd$UNAME_RELEASE
+	;;
     *:MidnightBSD:*:*)
-	echo "$UNAME_MACHINE"-unknown-midnightbsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-midnightbsd$UNAME_RELEASE
+	;;
     *:ekkoBSD:*:*)
-	echo "$UNAME_MACHINE"-unknown-ekkobsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-ekkobsd$UNAME_RELEASE
+	;;
     *:SolidBSD:*:*)
-	echo "$UNAME_MACHINE"-unknown-solidbsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-solidbsd$UNAME_RELEASE
+	;;
+    *:OS108:*:*)
+	GUESS=$UNAME_MACHINE-unknown-os108_$UNAME_RELEASE
+	;;
     macppc:MirBSD:*:*)
-	echo powerpc-unknown-mirbsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=powerpc-unknown-mirbsd$UNAME_RELEASE
+	;;
     *:MirBSD:*:*)
-	echo "$UNAME_MACHINE"-unknown-mirbsd"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-mirbsd$UNAME_RELEASE
+	;;
     *:Sortix:*:*)
-	echo "$UNAME_MACHINE"-unknown-sortix
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-sortix
+	;;
+    *:Twizzler:*:*)
+	GUESS=$UNAME_MACHINE-unknown-twizzler
+	;;
     *:Redox:*:*)
-	echo "$UNAME_MACHINE"-unknown-redox
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-redox
+	;;
     mips:OSF1:*.*)
-        echo mips-dec-osf1
-        exit ;;
+	GUESS=mips-dec-osf1
+	;;
     alpha:OSF1:*:*)
+	# Reset EXIT trap before exiting to avoid spurious non-zero exit code.
+	trap '' 0
 	case $UNAME_RELEASE in
 	*4.0)
 		UNAME_RELEASE=`/usr/sbin/sizer -v | awk '{print $3}'`
@@ -292,7 +329,7 @@
 	# covers most systems running today.  This code pipes the CPU
 	# types through head -n 1, so we only detect the type of CPU 0.
 	ALPHA_CPU_TYPE=`/usr/sbin/psrinfo -v | sed -n -e 's/^  The alpha $.*$ processor.*$/\1/p' | head -n 1`
-	case "$ALPHA_CPU_TYPE" in
+	case $ALPHA_CPU_TYPE in
 	    "EV4 (21064)")
 		UNAME_MACHINE=alpha ;;
 	    "EV4.5 (21064)")
@@ -329,112 +366,121 @@
 	# A Tn.n version is a released field test version.
 	# A Xn.n version is an unreleased experimental baselevel.
 	# 1.2 uses "1.2" for uname -r.
-	echo "$UNAME_MACHINE"-dec-osf"`echo "$UNAME_RELEASE" | sed -e 's/^PVTX//' | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz`"
-	# Reset EXIT trap before exiting to avoid spurious non-zero exit code.
-	exitcode=$?
-	trap '' 0
-	exit $exitcode ;;
+	OSF_REL=`echo "$UNAME_RELEASE" | sed -e 's/^PVTX//' | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz`
+	GUESS=$UNAME_MACHINE-dec-osf$OSF_REL
+	;;
     Amiga*:UNIX_System_V:4.0:*)
-	echo m68k-unknown-sysv4
-	exit ;;
+	GUESS=m68k-unknown-sysv4
+	;;
     *:AamigaOoSs:*:*)
-	echo "$UNAME_MACHINE"-unknown-amigaos
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-amigaos
+	;;
     *:MmorphOoSs:*:*)
-	echo "$UNAME_MACHINE"-unknown-morphos
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-morphos
+	;;
     *:OS/390:*:*)
-	echo i370-ibm-openedition
-	exit ;;
+	GUESS=i370-ibm-openedition
+	;;
     *:z/VM:*:*)
-	echo s390-ibm-zvmoe
-	exit ;;
+	GUESS=s390-ibm-zvmoe
+	;;
     *:OS400:*:*)
-	echo powerpc-ibm-os400
-	exit ;;
+	GUESS=powerpc-ibm-os400
+	;;
     arm:RISC*:1.012*:*|arm:riscix:1.012*:*)
-	echo arm-acorn-riscix"$UNAME_RELEASE"
-	exit ;;
+	GUESS=arm-acorn-riscix$UNAME_RELEASE
+	;;
     arm*:riscos:*:*|arm*:RISCOS:*:*)
-	echo arm-unknown-riscos
-	exit ;;
+	GUESS=arm-unknown-riscos
+	;;
     SR2?01:HI-UX/MPP:*:* | SR8000:HI-UX/MPP:*:*)
-	echo hppa1.1-hitachi-hiuxmpp
-	exit ;;
+	GUESS=hppa1.1-hitachi-hiuxmpp
+	;;
     Pyramid*:OSx*:*:* | MIS*:OSx*:*:* | MIS*:SMP_DC-OSx*:*:*)
 	# akee@wpdis03.wpafb.af.mil (Earle F. Ake) contributed MIS and NILE.
-	if test "`(/bin/universe) 2>/dev/null`" = att ; then
-		echo pyramid-pyramid-sysv3
-	else
-		echo pyramid-pyramid-bsd
-	fi
-	exit ;;
+	case `(/bin/universe) 2>/dev/null` in
+	    att) GUESS=pyramid-pyramid-sysv3 ;;
+	    *)   GUESS=pyramid-pyramid-bsd   ;;
+	esac
+	;;
     NILE*:*:*:dcosx)
-	echo pyramid-pyramid-svr4
-	exit ;;
+	GUESS=pyramid-pyramid-svr4
+	;;
     DRS?6000:unix:4.0:6*)
-	echo sparc-icl-nx6
-	exit ;;
+	GUESS=sparc-icl-nx6
+	;;
     DRS?6000:UNIX_SV:4.2*:7* | DRS?6000:isis:4.2*:7*)
 	case `/usr/bin/uname -p` in
-	    sparc) echo sparc-icl-nx7; exit ;;
-	esac ;;
+	    sparc) GUESS=sparc-icl-nx7 ;;
+	esac
+	;;
     s390x:SunOS:*:*)
-	echo "$UNAME_MACHINE"-ibm-solaris2"`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=$UNAME_MACHINE-ibm-solaris2$SUN_REL
+	;;
     sun4H:SunOS:5.*:*)
-	echo sparc-hal-solaris2"`echo "$UNAME_RELEASE"|sed -e 's/^.*//'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=sparc-hal-solaris2$SUN_REL
+	;;
     sun4*:SunOS:5.*:* | tadpole*:SunOS:5.*:*)
-	echo sparc-sun-solaris2"`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=sparc-sun-solaris2$SUN_REL
+	;;
     i86pc:AuroraUX:5.*:* | i86xen:AuroraUX:5.*:*)
-	echo i386-pc-auroraux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=i386-pc-auroraux$UNAME_RELEASE
+	;;
     i86pc:SunOS:5.*:* | i86xen:SunOS:5.*:*)
-	UNAME_REL="`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`"
-	case `isainfo -b` in
-	    32)
-		echo i386-pc-solaris2"$UNAME_REL"
-		;;
-	    64)
-		echo x86_64-pc-solaris2"$UNAME_REL"
-		;;
-	esac
-	exit ;;
+	set_cc_for_build
+	SUN_ARCH=i386
+	# If there is a compiler, see if it is configured for 64-bit objects.
+	# Note that the Sun cc does not turn __LP64__ into 1 like gcc does.
+	# This test works for both compilers.
+	if test "$CC_FOR_BUILD" != no_compiler_found; then
+	    if (echo '#ifdef __amd64'; echo IS_64BIT_ARCH; echo '#endif') | \
+		(CCOPTS="" $CC_FOR_BUILD -m64 -E - 2>/dev/null) | \
+		grep IS_64BIT_ARCH >/dev/null
+	    then
+		SUN_ARCH=x86_64
+	    fi
+	fi
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=$SUN_ARCH-pc-solaris2$SUN_REL
+	;;
     sun4*:SunOS:6*:*)
 	# According to config.sub, this is the proper way to canonicalize
 	# SunOS6.  Hard to guess exactly what SunOS6 will be like, but
 	# it's likely to be more like Solaris than SunOS4.
-	echo sparc-sun-solaris3"`echo "$UNAME_RELEASE"|sed -e 's/^.*//'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=sparc-sun-solaris3$SUN_REL
+	;;
     sun4*:SunOS:*:*)
-	case "`/usr/bin/arch -k`" in
+	case `/usr/bin/arch -k` in
 	    Series*|S4*)
 		UNAME_RELEASE=`uname -v`
 		;;
 	esac
 	# Japanese Language versions have a version number like `4.1.3-JL'.
-	echo sparc-sun-sunos"`echo "$UNAME_RELEASE"|sed -e 's/-/_/'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/-/_/'`
+	GUESS=sparc-sun-sunos$SUN_REL
+	;;
     sun3*:SunOS:*:*)
-	echo m68k-sun-sunos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-sun-sunos$UNAME_RELEASE
+	;;
     sun*:*:4.2BSD:*)
 	UNAME_RELEASE=`(sed 1q /etc/motd | awk '{print substr($5,1,3)}') 2>/dev/null`
 	test "x$UNAME_RELEASE" = x && UNAME_RELEASE=3
-	case "`/bin/arch`" in
+	case `/bin/arch` in
 	    sun3)
-		echo m68k-sun-sunos"$UNAME_RELEASE"
+		GUESS=m68k-sun-sunos$UNAME_RELEASE
 		;;
 	    sun4)
-		echo sparc-sun-sunos"$UNAME_RELEASE"
+		GUESS=sparc-sun-sunos$UNAME_RELEASE
 		;;
 	esac
-	exit ;;
+	;;
     aushp:SunOS:*:*)
-	echo sparc-auspex-sunos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sparc-auspex-sunos$UNAME_RELEASE
+	;;
     # The situation for MiNT is a little confusing.  The machine name
     # can be virtually everything (everything which is not
     # "atarist" or "atariste" at least should have a processor
@@ -444,41 +490,41 @@
     # MiNT.  But MiNT is downward compatible to TOS, so this should
     # be no problem.
     atariste:*MiNT:*:* | atariste:*mint:*:* | atariste:*TOS:*:*)
-	echo m68k-atari-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-atari-mint$UNAME_RELEASE
+	;;
     atari*:*MiNT:*:* | atari*:*mint:*:* | atariste:*TOS:*:*)
-	echo m68k-atari-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-atari-mint$UNAME_RELEASE
+	;;
     *falcon*:*MiNT:*:* | *falcon*:*mint:*:* | *falcon*:*TOS:*:*)
-	echo m68k-atari-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-atari-mint$UNAME_RELEASE
+	;;
     milan*:*MiNT:*:* | milan*:*mint:*:* | *milan*:*TOS:*:*)
-	echo m68k-milan-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-milan-mint$UNAME_RELEASE
+	;;
     hades*:*MiNT:*:* | hades*:*mint:*:* | *hades*:*TOS:*:*)
-	echo m68k-hades-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-hades-mint$UNAME_RELEASE
+	;;
     *:*MiNT:*:* | *:*mint:*:* | *:*TOS:*:*)
-	echo m68k-unknown-mint"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-unknown-mint$UNAME_RELEASE
+	;;
     m68k:machten:*:*)
-	echo m68k-apple-machten"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-apple-machten$UNAME_RELEASE
+	;;
     powerpc:machten:*:*)
-	echo powerpc-apple-machten"$UNAME_RELEASE"
-	exit ;;
+	GUESS=powerpc-apple-machten$UNAME_RELEASE
+	;;
     RISC*:Mach:*:*)
-	echo mips-dec-mach_bsd4.3
-	exit ;;
+	GUESS=mips-dec-mach_bsd4.3
+	;;
     RISC*:ULTRIX:*:*)
-	echo mips-dec-ultrix"$UNAME_RELEASE"
-	exit ;;
+	GUESS=mips-dec-ultrix$UNAME_RELEASE
+	;;
     VAX*:ULTRIX*:*:*)
-	echo vax-dec-ultrix"$UNAME_RELEASE"
-	exit ;;
+	GUESS=vax-dec-ultrix$UNAME_RELEASE
+	;;
     2020:CLIX:*:* | 2430:CLIX:*:*)
-	echo clipper-intergraph-clix"$UNAME_RELEASE"
-	exit ;;
+	GUESS=clipper-intergraph-clix$UNAME_RELEASE
+	;;
     mips:*:*:UMIPS | mips:*:*:RISCos)
 	set_cc_for_build
 	sed 's/^	//' << EOF > "$dummy.c"
@@ -506,75 +552,76 @@
 	  dummyarg=`echo "$UNAME_RELEASE" | sed -n 's/$0-9*$.*/\1/p'` &&
 	  SYSTEM_NAME=`"$dummy" "$dummyarg"` &&
 	    { echo "$SYSTEM_NAME"; exit; }
-	echo mips-mips-riscos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=mips-mips-riscos$UNAME_RELEASE
+	;;
     Motorola:PowerMAX_OS:*:*)
-	echo powerpc-motorola-powermax
-	exit ;;
+	GUESS=powerpc-motorola-powermax
+	;;
     Motorola:*:4.3:PL8-*)
-	echo powerpc-harris-powermax
-	exit ;;
+	GUESS=powerpc-harris-powermax
+	;;
     Night_Hawk:*:*:PowerMAX_OS | Synergy:PowerMAX_OS:*:*)
-	echo powerpc-harris-powermax
-	exit ;;
+	GUESS=powerpc-harris-powermax
+	;;
     Night_Hawk:Power_UNIX:*:*)
-	echo powerpc-harris-powerunix
-	exit ;;
+	GUESS=powerpc-harris-powerunix
+	;;
     m88k:CX/UX:7*:*)
-	echo m88k-harris-cxux7
-	exit ;;
+	GUESS=m88k-harris-cxux7
+	;;
     m88k:*:4*:R4*)
-	echo m88k-motorola-sysv4
-	exit ;;
+	GUESS=m88k-motorola-sysv4
+	;;
     m88k:*:3*:R3*)
-	echo m88k-motorola-sysv3
-	exit ;;
+	GUESS=m88k-motorola-sysv3
+	;;
     AViiON:dgux:*:*)
 	# DG/UX returns AViiON for all architectures
 	UNAME_PROCESSOR=`/usr/bin/uname -p`
-	if  "$UNAME_PROCESSOR" = mc88100  ||  "$UNAME_PROCESSOR" = mc88110 
+	if test "$UNAME_PROCESSOR" = mc88100 || test "$UNAME_PROCESSOR" = mc88110
 	then
-	    if  "$TARGET_BINARY_INTERFACE"x = m88kdguxelfx  || \
-	        "$TARGET_BINARY_INTERFACE"x = x 
+	    if test "$TARGET_BINARY_INTERFACE"x = m88kdguxelfx || \
+	       test "$TARGET_BINARY_INTERFACE"x = x
 	    then
-		echo m88k-dg-dgux"$UNAME_RELEASE"
+		GUESS=m88k-dg-dgux$UNAME_RELEASE
 	    else
-		echo m88k-dg-dguxbcs"$UNAME_RELEASE"
+		GUESS=m88k-dg-dguxbcs$UNAME_RELEASE
 	    fi
 	else
-	    echo i586-dg-dgux"$UNAME_RELEASE"
+	    GUESS=i586-dg-dgux$UNAME_RELEASE
 	fi
-	exit ;;
+	;;
     M88*:DolphinOS:*:*)	# DolphinOS (SVR3)
-	echo m88k-dolphin-sysv3
-	exit ;;
+	GUESS=m88k-dolphin-sysv3
+	;;
     M88*:*:R3*:*)
 	# Delta 88k system running SVR3
-	echo m88k-motorola-sysv3
-	exit ;;
+	GUESS=m88k-motorola-sysv3
+	;;
     XD88*:*:*:*) # Tektronix XD88 system running UTekV (SVR3)
-	echo m88k-tektronix-sysv3
-	exit ;;
+	GUESS=m88k-tektronix-sysv3
+	;;
     Tek430-90-9:UTek:*:*) # Tektronix 4300 system running UTek (BSD)
-	echo m68k-tektronix-bsd
-	exit ;;
+	GUESS=m68k-tektronix-bsd
+	;;
     *:IRIX*:*:*)
-	echo mips-sgi-irix"`echo "$UNAME_RELEASE"|sed -e 's/-/_/g'`"
-	exit ;;
+	IRIX_REL=`echo "$UNAME_RELEASE" | sed -e 's/-/_/g'`
+	GUESS=mips-sgi-irix$IRIX_REL
+	;;
     ????????:AIX?:12.1:2)   # AIX 2.2.1 or AIX 2.1.1 is RT/PC AIX.
-	echo romp-ibm-aix     # uname -m gives an 8 hex-code CPU id
-	exit ;;               # Note that: echo "'`uname -s`'" gives 'AIX '
+	GUESS=romp-ibm-aix    # uname -m gives an 8 hex-code CPU id
+	;;                    # Note that: echo "'`uname -s`'" gives 'AIX '
     i*86:AIX:*:*)
-	echo i386-ibm-aix
-	exit ;;
+	GUESS=i386-ibm-aix
+	;;
     ia64:AIX:*:*)
-	if  -x /usr/bin/oslevel  ; then
+	if test -x /usr/bin/oslevel ; then
 		IBM_REV=`/usr/bin/oslevel`
 	else
-		IBM_REV="$UNAME_VERSION.$UNAME_RELEASE"
+		IBM_REV=$UNAME_VERSION.$UNAME_RELEASE
 	fi
-	echo "$UNAME_MACHINE"-ibm-aix"$IBM_REV"
-	exit ;;
+	GUESS=$UNAME_MACHINE-ibm-aix$IBM_REV
+	;;
     *:AIX:2:3)
 	if grep bos325 /usr/include/stdio.h >/dev/null 2>&1; then
 		set_cc_for_build
@@ -591,16 +638,16 @@
 EOF
 		if $CC_FOR_BUILD -o "$dummy" "$dummy.c" && SYSTEM_NAME=`"$dummy"`
 		then
-			echo "$SYSTEM_NAME"
+			GUESS=$SYSTEM_NAME
 		else
-			echo rs6000-ibm-aix3.2.5
+			GUESS=rs6000-ibm-aix3.2.5
 		fi
 	elif grep bos324 /usr/include/stdio.h >/dev/null 2>&1; then
-		echo rs6000-ibm-aix3.2.4
+		GUESS=rs6000-ibm-aix3.2.4
 	else
-		echo rs6000-ibm-aix3.2
+		GUESS=rs6000-ibm-aix3.2
 	fi
-	exit ;;
+	;;
     *:AIX:*:4567)
 	IBM_CPU_ID=`/usr/sbin/lsdev -C -c processor -S available | sed 1q | awk '{ print $1 }'`
 	if /usr/sbin/lsattr -El "$IBM_CPU_ID" | grep ' POWER' >/dev/null 2>&1; then
@@ -608,56 +655,56 @@
 	else
 		IBM_ARCH=powerpc
 	fi
-	if  -x /usr/bin/lslpp  ; then
-		IBM_REV=`/usr/bin/lslpp -Lqc bos.rte.libc |
+	if test -x /usr/bin/lslpp ; then
+		IBM_REV=`/usr/bin/lslpp -Lqc bos.rte.libc | \
 			   awk -F: '{ print $3 }' | sed s/0-9*$/0/`
 	else
-		IBM_REV="$UNAME_VERSION.$UNAME_RELEASE"
+		IBM_REV=$UNAME_VERSION.$UNAME_RELEASE
 	fi
-	echo "$IBM_ARCH"-ibm-aix"$IBM_REV"
-	exit ;;
+	GUESS=$IBM_ARCH-ibm-aix$IBM_REV
+	;;
     *:AIX:*:*)
-	echo rs6000-ibm-aix
-	exit ;;
+	GUESS=rs6000-ibm-aix
+	;;
     ibmrt:4.4BSD:*|romp-ibm:4.4BSD:*)
-	echo romp-ibm-bsd4.4
-	exit ;;
+	GUESS=romp-ibm-bsd4.4
+	;;
     ibmrt:*BSD:*|romp-ibm:BSD:*)            # covers RT/PC BSD and
-	echo romp-ibm-bsd"$UNAME_RELEASE"   # 4.3 with uname added to
-	exit ;;                             # report: romp-ibm BSD 4.3
+	GUESS=romp-ibm-bsd$UNAME_RELEASE    # 4.3 with uname added to
+	;;                                  # report: romp-ibm BSD 4.3
     *:BOSX:*:*)
-	echo rs6000-bull-bosx
-	exit ;;
+	GUESS=rs6000-bull-bosx
+	;;
     DPX/2?00:B.O.S.:*:*)
-	echo m68k-bull-sysv3
-	exit ;;
+	GUESS=m68k-bull-sysv3
+	;;
     9000/34??:4.3bsd:1.*:*)
-	echo m68k-hp-bsd
-	exit ;;
+	GUESS=m68k-hp-bsd
+	;;
     hp300:4.4BSD:*:* | 9000/34??:4.3bsd:2.*:*)
-	echo m68k-hp-bsd4.4
-	exit ;;
+	GUESS=m68k-hp-bsd4.4
+	;;
     9000/34678??:HP-UX:*:*)
-	HPUX_REV=`echo "$UNAME_RELEASE"|sed -e 's/^.*.0B*//'`
-	case "$UNAME_MACHINE" in
+	HPUX_REV=`echo "$UNAME_RELEASE" | sed -e 's/^.*.0B*//'`
+	case $UNAME_MACHINE in
 	    9000/31?)            HP_ARCH=m68000 ;;
 	    9000/34??)         HP_ARCH=m68k ;;
 	    9000/6780-90-9)
-		if  -x /usr/bin/getconf ; then
+		if test -x /usr/bin/getconf; then
 		    sc_cpu_version=`/usr/bin/getconf SC_CPU_VERSION 2>/dev/null`
 		    sc_kernel_bits=`/usr/bin/getconf SC_KERNEL_BITS 2>/dev/null`
-		    case "$sc_cpu_version" in
+		    case $sc_cpu_version in
 		      523) HP_ARCH=hppa1.0 ;; # CPU_PA_RISC1_0
 		      528) HP_ARCH=hppa1.1 ;; # CPU_PA_RISC1_1
 		      532)                      # CPU_PA_RISC2_0
-			case "$sc_kernel_bits" in
+			case $sc_kernel_bits in
 			  32) HP_ARCH=hppa2.0n ;;
 			  64) HP_ARCH=hppa2.0w ;;
 			  '') HP_ARCH=hppa2.0 ;;   # HP-UX 10.20
 			esac ;;
 		    esac
 		fi
-		if  "$HP_ARCH" = "" ; then
+		if test "$HP_ARCH" = ""; then
 		    set_cc_for_build
 		    sed 's/^		//' << EOF > "$dummy.c"
 
@@ -696,7 +743,7 @@
 		    test -z "$HP_ARCH" && HP_ARCH=hppa
 		fi ;;
 	esac
-	if  "$HP_ARCH" = hppa2.0w 
+	if test "$HP_ARCH" = hppa2.0w
 	then
 	    set_cc_for_build
 
@@ -717,12 +764,12 @@
 		HP_ARCH=hppa64
 	    fi
 	fi
-	echo "$HP_ARCH"-hp-hpux"$HPUX_REV"
-	exit ;;
+	GUESS=$HP_ARCH-hp-hpux$HPUX_REV
+	;;
     ia64:HP-UX:*:*)
-	HPUX_REV=`echo "$UNAME_RELEASE"|sed -e 's/^.*.0B*//'`
-	echo ia64-hp-hpux"$HPUX_REV"
-	exit ;;
+	HPUX_REV=`echo "$UNAME_RELEASE" | sed -e 's/^.*.0B*//'`
+	GUESS=ia64-hp-hpux$HPUX_REV
+	;;
     3050*:HI-UX:*:*)
 	set_cc_for_build
 	sed 's/^	//' << EOF > "$dummy.c"
@@ -752,36 +799,36 @@
 EOF
 	$CC_FOR_BUILD -o "$dummy" "$dummy.c" && SYSTEM_NAME=`"$dummy"` &&
 		{ echo "$SYSTEM_NAME"; exit; }
-	echo unknown-hitachi-hiuxwe2
-	exit ;;
+	GUESS=unknown-hitachi-hiuxwe2
+	;;
     9000/7??:4.3bsd:*:* | 9000/8?79:4.3bsd:*:*)
-	echo hppa1.1-hp-bsd
-	exit ;;
+	GUESS=hppa1.1-hp-bsd
+	;;
     9000/8??:4.3bsd:*:*)
-	echo hppa1.0-hp-bsd
-	exit ;;
+	GUESS=hppa1.0-hp-bsd
+	;;
     *9??*:MPE/iX:*:* | *3000*:MPE/iX:*:*)
-	echo hppa1.0-hp-mpeix
-	exit ;;
+	GUESS=hppa1.0-hp-mpeix
+	;;
     hp7??:OSF1:*:* | hp8?79:OSF1:*:*)
-	echo hppa1.1-hp-osf
-	exit ;;
+	GUESS=hppa1.1-hp-osf
+	;;
     hp8??:OSF1:*:*)
-	echo hppa1.0-hp-osf
-	exit ;;
+	GUESS=hppa1.0-hp-osf
+	;;
     i*86:OSF1:*:*)
-	if  -x /usr/sbin/sysversion  ; then
-	    echo "$UNAME_MACHINE"-unknown-osf1mk
+	if test -x /usr/sbin/sysversion ; then
+	    GUESS=$UNAME_MACHINE-unknown-osf1mk
 	else
-	    echo "$UNAME_MACHINE"-unknown-osf1
+	    GUESS=$UNAME_MACHINE-unknown-osf1
 	fi
-	exit ;;
+	;;
     parisc*:Lites*:*:*)
-	echo hppa1.1-hp-lites
-	exit ;;
+	GUESS=hppa1.1-hp-lites
+	;;
     C1*:ConvexOS:*:* | convex:ConvexOS:C1*:*)
-	echo c1-convex-bsd
-	exit ;;
+	GUESS=c1-convex-bsd
+	;;
     C2*:ConvexOS:*:* | convex:ConvexOS:C2*:*)
 	if getsysinfo -f scalar_acc
 	then echo c32-convex-bsd
@@ -789,17 +836,18 @@
 	fi
 	exit ;;
     C34*:ConvexOS:*:* | convex:ConvexOS:C34*:*)
-	echo c34-convex-bsd
-	exit ;;
+	GUESS=c34-convex-bsd
+	;;
     C38*:ConvexOS:*:* | convex:ConvexOS:C38*:*)
-	echo c38-convex-bsd
-	exit ;;
+	GUESS=c38-convex-bsd
+	;;
     C4*:ConvexOS:*:* | convex:ConvexOS:C4*:*)
-	echo c4-convex-bsd
-	exit ;;
+	GUESS=c4-convex-bsd
+	;;
     CRAY*Y-MP:*:*:*)
-	echo ymp-cray-unicos"$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'
-	exit ;;
+	CRAY_REL=`echo "$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'`
+	GUESS=ymp-cray-unicos$CRAY_REL
+	;;
     CRAY*A-Z90:*:*:*)
 	echo "$UNAME_MACHINE"-cray-unicos"$UNAME_RELEASE" \
 	| sed -e 's/CRAY.*$A-Z90$/\1/' \
@@ -807,114 +855,135 @@
 	      -e 's/\.^.*$/.X/'
 	exit ;;
     CRAY*TS:*:*:*)
-	echo t90-cray-unicos"$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'
-	exit ;;
+	CRAY_REL=`echo "$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'`
+	GUESS=t90-cray-unicos$CRAY_REL
+	;;
     CRAY*T3E:*:*:*)
-	echo alphaev5-cray-unicosmk"$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'
-	exit ;;
+	CRAY_REL=`echo "$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'`
+	GUESS=alphaev5-cray-unicosmk$CRAY_REL
+	;;
     CRAY*SV1:*:*:*)
-	echo sv1-cray-unicos"$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'
-	exit ;;
+	CRAY_REL=`echo "$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'`
+	GUESS=sv1-cray-unicos$CRAY_REL
+	;;
     *:UNICOS/mp:*:*)
-	echo craynv-cray-unicosmp"$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'
-	exit ;;
+	CRAY_REL=`echo "$UNAME_RELEASE" | sed -e 's/\.^.*$/.X/'`
+	GUESS=craynv-cray-unicosmp$CRAY_REL
+	;;
     F3001:UNIX_System_V:*:* | F700:UNIX_System_V:*:*)
 	FUJITSU_PROC=`uname -m | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz`
 	FUJITSU_SYS=`uname -p | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz | sed -e 's/\///'`
 	FUJITSU_REL=`echo "$UNAME_RELEASE" | sed -e 's/ /_/'`
-	echo "${FUJITSU_PROC}-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}"
-	exit ;;
+	GUESS=${FUJITSU_PROC}-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}
+	;;
     5000:UNIX_System_V:4.*:*)
 	FUJITSU_SYS=`uname -p | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz | sed -e 's/\///'`
 	FUJITSU_REL=`echo "$UNAME_RELEASE" | tr ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz | sed -e 's/ /_/'`
-	echo "sparc-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}"
-	exit ;;
+	GUESS=sparc-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}
+	;;
     i*86:BSD/386:*:* | i*86:BSD/OS:*:* | *:Ascend\ Embedded/OS:*:*)
-	echo "$UNAME_MACHINE"-pc-bsdi"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-bsdi$UNAME_RELEASE
+	;;
     sparc*:BSD/OS:*:*)
-	echo sparc-unknown-bsdi"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sparc-unknown-bsdi$UNAME_RELEASE
+	;;
     *:BSD/OS:*:*)
-	echo "$UNAME_MACHINE"-unknown-bsdi"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-bsdi$UNAME_RELEASE
+	;;
     arm:FreeBSD:*:*)
 	UNAME_PROCESSOR=`uname -p`
 	set_cc_for_build
 	if echo __ARM_PCS_VFP | $CC_FOR_BUILD -E - 2>/dev/null \
 	    | grep -q __ARM_PCS_VFP
 	then
-	    echo "${UNAME_PROCESSOR}"-unknown-freebsd"`echo ${UNAME_RELEASE}|sed -e 's/-(.*//'`"-gnueabi
+	    FREEBSD_REL=`echo "$UNAME_RELEASE" | sed -e 's/-(.*//'`
+	    GUESS=$UNAME_PROCESSOR-unknown-freebsd$FREEBSD_REL-gnueabi
 	else
-	    echo "${UNAME_PROCESSOR}"-unknown-freebsd"`echo ${UNAME_RELEASE}|sed -e 's/-(.*//'`"-gnueabihf
+	    FREEBSD_REL=`echo "$UNAME_RELEASE" | sed -e 's/-(.*//'`
+	    GUESS=$UNAME_PROCESSOR-unknown-freebsd$FREEBSD_REL-gnueabihf
 	fi
-	exit ;;
+	;;
     *:FreeBSD:*:*)
 	UNAME_PROCESSOR=`/usr/bin/uname -p`
-	case "$UNAME_PROCESSOR" in
+	case $UNAME_PROCESSOR in
 	    amd64)
 		UNAME_PROCESSOR=x86_64 ;;
 	    i386)
 		UNAME_PROCESSOR=i586 ;;
 	esac
-	echo "$UNAME_PROCESSOR"-unknown-freebsd"`echo "$UNAME_RELEASE"|sed -e 's/-(.*//'`"
-	exit ;;
+	FREEBSD_REL=`echo "$UNAME_RELEASE" | sed -e 's/-(.*//'`
+	GUESS=$UNAME_PROCESSOR-unknown-freebsd$FREEBSD_REL
+	;;
     i*:CYGWIN*:*)
-	echo "$UNAME_MACHINE"-pc-cygwin
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-cygwin
+	;;
     *:MINGW64*:*)
-	echo "$UNAME_MACHINE"-pc-mingw64
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-mingw64
+	;;
     *:MINGW*:*)
-	echo "$UNAME_MACHINE"-pc-mingw32
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-mingw32
+	;;
     *:MSYS*:*)
-	echo "$UNAME_MACHINE"-pc-msys
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-msys
+	;;
     i*:PW*:*)
-	echo "$UNAME_MACHINE"-pc-pw32
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-pw32
+	;;
+    *:SerenityOS:*:*)
+        GUESS=$UNAME_MACHINE-pc-serenity
+        ;;
     *:Interix*:*)
-	case "$UNAME_MACHINE" in
+	case $UNAME_MACHINE in
 	    x86)
-		echo i586-pc-interix"$UNAME_RELEASE"
-		exit ;;
+		GUESS=i586-pc-interix$UNAME_RELEASE
+		;;
 	    authenticamd | genuineintel | EM64T)
-		echo x86_64-unknown-interix"$UNAME_RELEASE"
-		exit ;;
+		GUESS=x86_64-unknown-interix$UNAME_RELEASE
+		;;
 	    IA64)
-		echo ia64-unknown-interix"$UNAME_RELEASE"
-		exit ;;
+		GUESS=ia64-unknown-interix$UNAME_RELEASE
+		;;
 	esac ;;
     i*:UWIN*:*)
-	echo "$UNAME_MACHINE"-pc-uwin
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-uwin
+	;;
     amd64:CYGWIN*:*:* | x86_64:CYGWIN*:*:*)
-	echo x86_64-unknown-cygwin
-	exit ;;
+	GUESS=x86_64-pc-cygwin
+	;;
     prep*:SunOS:5.*:*)
-	echo powerpcle-unknown-solaris2"`echo "$UNAME_RELEASE"|sed -e 's/^.*//'`"
-	exit ;;
+	SUN_REL=`echo "$UNAME_RELEASE" | sed -e 's/^.*//'`
+	GUESS=powerpcle-unknown-solaris2$SUN_REL
+	;;
     *:GNU:*:*)
 	# the GNU system
-	echo "`echo "$UNAME_MACHINE"|sed -e 's,-/.*$,,'`-unknown-$LIBC`echo "$UNAME_RELEASE"|sed -e 's,/.*$,,'`"
-	exit ;;
+	GNU_ARCH=`echo "$UNAME_MACHINE" | sed -e 's,-/.*$,,'`
+	GNU_REL=`echo "$UNAME_RELEASE" | sed -e 's,/.*$,,'`
+	GUESS=$GNU_ARCH-unknown-$LIBC$GNU_REL
+	;;
     *:GNU/*:*:*)
 	# other systems with GNU libc and userland
-	echo "$UNAME_MACHINE-unknown-`echo "$UNAME_SYSTEM" | sed 's,^^/*/,,' | tr ":upper:" ":lower:"``echo "$UNAME_RELEASE"|sed -e 's/-(.*//'`-$LIBC"
-	exit ;;
+	GNU_SYS=`echo "$UNAME_SYSTEM" | sed 's,^^/*/,,' | tr ":upper:" ":lower:"`
+	GNU_REL=`echo "$UNAME_RELEASE" | sed -e 's/-(.*//'`
+	GUESS=$UNAME_MACHINE-unknown-$GNU_SYS$GNU_REL-$LIBC
+	;;
+    x86_64:Mmanagarm:*:*|i?86:Mmanagarm:*:*)
+	GUESS="$UNAME_MACHINE-pc-managarm-mlibc"
+	;;
+    *:Mmanagarm:*:*)
+	GUESS="$UNAME_MACHINE-unknown-managarm-mlibc"
+	;;
     *:Minix:*:*)
-	echo "$UNAME_MACHINE"-unknown-minix
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-minix
+	;;
     aarch64:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     aarch64_be:Linux:*:*)
 	UNAME_MACHINE=aarch64_be
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     alpha:Linux:*:*)
-	case `sed -n '/^cpu model/s/^.*: $.*$/\1/p' < /proc/cpuinfo` in
+	case `sed -n '/^cpu model/s/^.*: $.*$/\1/p' /proc/cpuinfo 2>/dev/null` in
 	  EV5)   UNAME_MACHINE=alphaev5 ;;
 	  EV56)  UNAME_MACHINE=alphaev56 ;;
 	  PCA56) UNAME_MACHINE=alphapca56 ;;
@@ -925,183 +994,236 @@
 	esac
 	objdump --private-headers /bin/sh | grep -q ld.so.1
 	if test "$?" = 0 ; then LIBC=gnulibc1 ; fi
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
-    arc:Linux:*:* | arceb:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
+    arc:Linux:*:* | arceb:Linux:*:* | arc32:Linux:*:* | arc64:Linux:*:*)
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     arm*:Linux:*:*)
 	set_cc_for_build
 	if echo __ARM_EABI__ | $CC_FOR_BUILD -E - 2>/dev/null \
 	    | grep -q __ARM_EABI__
 	then
-	    echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
+	    GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
 	else
 	    if echo __ARM_PCS_VFP | $CC_FOR_BUILD -E - 2>/dev/null \
 		| grep -q __ARM_PCS_VFP
 	    then
-		echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"eabi
+		GUESS=$UNAME_MACHINE-unknown-linux-${LIBC}eabi
 	    else
-		echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"eabihf
+		GUESS=$UNAME_MACHINE-unknown-linux-${LIBC}eabihf
 	    fi
 	fi
-	exit ;;
+	;;
     avr32*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     cris:Linux:*:*)
-	echo "$UNAME_MACHINE"-axis-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-axis-linux-$LIBC
+	;;
     crisv32:Linux:*:*)
-	echo "$UNAME_MACHINE"-axis-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-axis-linux-$LIBC
+	;;
     e2k:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     frv:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     hexagon:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     i*86:Linux:*:*)
-	echo "$UNAME_MACHINE"-pc-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-linux-$LIBC
+	;;
     ia64:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     k1om:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
+    loongarch32:Linux:*:* | loongarch64:Linux:*:*)
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     m32r*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     m68*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     mips:Linux:*:* | mips64:Linux:*:*)
 	set_cc_for_build
+	IS_GLIBC=0
+	test x"${LIBC}" = xgnu && IS_GLIBC=1
 	sed 's/^	//' << EOF > "$dummy.c"
 	#undef CPU
-	#undef ${UNAME_MACHINE}
-	#undef ${UNAME_MACHINE}el
+	#undef mips
+	#undef mipsel
+	#undef mips64
+	#undef mips64el
+	#if ${IS_GLIBC} && defined(_ABI64)
+	LIBCABI=gnuabi64
+	#else
+	#if ${IS_GLIBC} && defined(_ABIN32)
+	LIBCABI=gnuabin32
+	#else
+	LIBCABI=${LIBC}
+	#endif
+	#endif
+
+	#if ${IS_GLIBC} && defined(__mips64) && defined(__mips_isa_rev) && __mips_isa_rev>=6
+	CPU=mipsisa64r6
+	#else
+	#if ${IS_GLIBC} && !defined(__mips64) && defined(__mips_isa_rev) && __mips_isa_rev>=6
+	CPU=mipsisa32r6
+	#else
+	#if defined(__mips64)
+	CPU=mips64
+	#else
+	CPU=mips
+	#endif
+	#endif
+	#endif
+
 	#if defined(__MIPSEL__) || defined(__MIPSEL) || defined(_MIPSEL) || defined(MIPSEL)
-	CPU=${UNAME_MACHINE}el
+	MIPS_ENDIAN=el
 	#else
 	#if defined(__MIPSEB__) || defined(__MIPSEB) || defined(_MIPSEB) || defined(MIPSEB)
-	CPU=${UNAME_MACHINE}
+	MIPS_ENDIAN=
 	#else
-	CPU=
+	MIPS_ENDIAN=
 	#endif
 	#endif
 EOF
-	eval "`$CC_FOR_BUILD -E "$dummy.c" 2>/dev/null | grep '^CPU'`"
-	test "x$CPU" != x && { echo "$CPU-unknown-linux-$LIBC"; exit; }
+	cc_set_vars=`$CC_FOR_BUILD -E "$dummy.c" 2>/dev/null | grep '^CPU\|^MIPS_ENDIAN\|^LIBCABI'`
+	eval "$cc_set_vars"
+	test "x$CPU" != x && { echo "$CPU${MIPS_ENDIAN}-unknown-linux-$LIBCABI"; exit; }
 	;;
     mips64el:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     openrisc*:Linux:*:*)
-	echo or1k-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=or1k-unknown-linux-$LIBC
+	;;
     or32:Linux:*:* | or1k*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     padre:Linux:*:*)
-	echo sparc-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=sparc-unknown-linux-$LIBC
+	;;
     parisc64:Linux:*:* | hppa64:Linux:*:*)
-	echo hppa64-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=hppa64-unknown-linux-$LIBC
+	;;
     parisc:Linux:*:* | hppa:Linux:*:*)
 	# Look for CPU level
 	case `grep '^cpu^a-z*:' /proc/cpuinfo 2>/dev/null | cut -d' ' -f2` in
-	  PA7*) echo hppa1.1-unknown-linux-"$LIBC" ;;
-	  PA8*) echo hppa2.0-unknown-linux-"$LIBC" ;;
-	  *)    echo hppa-unknown-linux-"$LIBC" ;;
+	  PA7*) GUESS=hppa1.1-unknown-linux-$LIBC ;;
+	  PA8*) GUESS=hppa2.0-unknown-linux-$LIBC ;;
+	  *)    GUESS=hppa-unknown-linux-$LIBC ;;
 	esac
-	exit ;;
+	;;
     ppc64:Linux:*:*)
-	echo powerpc64-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=powerpc64-unknown-linux-$LIBC
+	;;
     ppc:Linux:*:*)
-	echo powerpc-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=powerpc-unknown-linux-$LIBC
+	;;
     ppc64le:Linux:*:*)
-	echo powerpc64le-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=powerpc64le-unknown-linux-$LIBC
+	;;
     ppcle:Linux:*:*)
-	echo powerpcle-unknown-linux-"$LIBC"
-	exit ;;
-    riscv32:Linux:*:* | riscv64:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=powerpcle-unknown-linux-$LIBC
+	;;
+    riscv32:Linux:*:* | riscv32be:Linux:*:* | riscv64:Linux:*:* | riscv64be:Linux:*:*)
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     s390:Linux:*:* | s390x:Linux:*:*)
-	echo "$UNAME_MACHINE"-ibm-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-ibm-linux-$LIBC
+	;;
     sh64*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     sh*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     sparc:Linux:*:* | sparc64:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     tile*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     vax:Linux:*:*)
-	echo "$UNAME_MACHINE"-dec-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-dec-linux-$LIBC
+	;;
     x86_64:Linux:*:*)
-	echo "$UNAME_MACHINE"-pc-linux-"$LIBC"
-	exit ;;
+	set_cc_for_build
+	CPU=$UNAME_MACHINE
+	LIBCABI=$LIBC
+	if test "$CC_FOR_BUILD" != no_compiler_found; then
+	    ABI=64
+	    sed 's/^	    //' << EOF > "$dummy.c"
+	    #ifdef __i386__
+	    ABI=x86
+	    #else
+	    #ifdef __ILP32__
+	    ABI=x32
+	    #endif
+	    #endif
+EOF
+	    cc_set_abi=`$CC_FOR_BUILD -E "$dummy.c" 2>/dev/null | grep '^ABI' | sed 's, ,,g'`
+	    eval "$cc_set_abi"
+	    case $ABI in
+		x86) CPU=i686 ;;
+		x32) LIBCABI=${LIBC}x32 ;;
+	    esac
+	fi
+	GUESS=$CPU-pc-linux-$LIBCABI
+	;;
     xtensa*:Linux:*:*)
-	echo "$UNAME_MACHINE"-unknown-linux-"$LIBC"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-linux-$LIBC
+	;;
     i*86:DYNIX/ptx:4*:*)
 	# ptx 4.0 does uname -s correctly, with DYNIX/ptx in there.
 	# earlier versions are messed up and put the nodename in both
 	# sysname and nodename.
-	echo i386-sequent-sysv4
-	exit ;;
+	GUESS=i386-sequent-sysv4
+	;;
     i*86:UNIX_SV:4.2MP:2.*)
 	# Unixware is an offshoot of SVR4, but it has its own version
 	# number series starting with 2...
 	# I am not positive that other SVR4 systems won't match this,
 	# I just have to hope.  -- rms.
 	# Use sysv4.2uw... so that sysv4* matches it.
-	echo "$UNAME_MACHINE"-pc-sysv4.2uw"$UNAME_VERSION"
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-sysv4.2uw$UNAME_VERSION
+	;;
     i*86:OS/2:*:*)
 	# If we were able to find `uname', then EMX Unix compatibility
 	# is probably installed.
-	echo "$UNAME_MACHINE"-pc-os2-emx
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-os2-emx
+	;;
     i*86:XTS-300:*:STOP)
-	echo "$UNAME_MACHINE"-unknown-stop
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-stop
+	;;
     i*86:atheos:*:*)
-	echo "$UNAME_MACHINE"-unknown-atheos
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-atheos
+	;;
     i*86:syllable:*:*)
-	echo "$UNAME_MACHINE"-pc-syllable
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-syllable
+	;;
     i*86:LynxOS:2.*:* | i*86:LynxOS:3.01*:* | i*86:LynxOS:4.02*:*)
-	echo i386-unknown-lynxos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=i386-unknown-lynxos$UNAME_RELEASE
+	;;
     i*86:*DOS:*:*)
-	echo "$UNAME_MACHINE"-pc-msdosdjgpp
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-msdosdjgpp
+	;;
     i*86:*:4.*:*)
 	UNAME_REL=`echo "$UNAME_RELEASE" | sed 's/\/MP$//'`
 	if grep Novell /usr/include/link.h >/dev/null 2>/dev/null; then
-		echo "$UNAME_MACHINE"-univel-sysv"$UNAME_REL"
+		GUESS=$UNAME_MACHINE-univel-sysv$UNAME_REL
 	else
-		echo "$UNAME_MACHINE"-pc-sysv"$UNAME_REL"
+		GUESS=$UNAME_MACHINE-pc-sysv$UNAME_REL
 	fi
-	exit ;;
+	;;
     i*86:*:5:678*)
 	# UnixWare 7.x, OpenUNIX and OpenServer 6.
 	case `/bin/uname -X | grep "^Machine"` in
@@ -1109,12 +1231,12 @@
 	    *Pentium)	     UNAME_MACHINE=i586 ;;
 	    *Pent*|*Celeron) UNAME_MACHINE=i686 ;;
 	esac
-	echo "$UNAME_MACHINE-unknown-sysv${UNAME_RELEASE}${UNAME_SYSTEM}{$UNAME_VERSION}"
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-sysv${UNAME_RELEASE}${UNAME_SYSTEM}${UNAME_VERSION}
+	;;
     i*86:*:3.2:*)
 	if test -f /usr/options/cb.name; then
 		UNAME_REL=`sed -n 's/.*Version //p' </usr/options/cb.name`
-		echo "$UNAME_MACHINE"-pc-isc"$UNAME_REL"
+		GUESS=$UNAME_MACHINE-pc-isc$UNAME_REL
 	elif /bin/uname -X 2>/dev/null >/dev/null ; then
 		UNAME_REL=`(/bin/uname -X|grep Release|sed -e 's/.*= //')`
 		(/bin/uname -X|grep i80486 >/dev/null) && UNAME_MACHINE=i486
@@ -1124,11 +1246,11 @@
 			&& UNAME_MACHINE=i686
 		(/bin/uname -X|grep '^Machine.*Pentium Pro' >/dev/null) \
 			&& UNAME_MACHINE=i686
-		echo "$UNAME_MACHINE"-pc-sco"$UNAME_REL"
+		GUESS=$UNAME_MACHINE-pc-sco$UNAME_REL
 	else
-		echo "$UNAME_MACHINE"-pc-sysv32
+		GUESS=$UNAME_MACHINE-pc-sysv32
 	fi
-	exit ;;
+	;;
     pc:*:*:*)
 	# Left here for compatibility:
 	# uname -m prints for DJGPP always 'pc', but it prints nothing about
@@ -1136,31 +1258,31 @@
 	# Note: whatever this is, it MUST be the same as what config.sub
 	# prints for the "djgpp" host, or else GDB configure will decide that
 	# this is a cross-build.
-	echo i586-pc-msdosdjgpp
-	exit ;;
+	GUESS=i586-pc-msdosdjgpp
+	;;
     Intel:Mach:3*:*)
-	echo i386-pc-mach3
-	exit ;;
+	GUESS=i386-pc-mach3
+	;;
     paragon:*:*:*)
-	echo i860-intel-osf1
-	exit ;;
+	GUESS=i860-intel-osf1
+	;;
     i860:*:4.*:*) # i860-SVR4
 	if grep Stardent /usr/include/sys/uadmin.h >/dev/null 2>&1 ; then
-	  echo i860-stardent-sysv"$UNAME_RELEASE" # Stardent Vistra i860-SVR4
+	  GUESS=i860-stardent-sysv$UNAME_RELEASE    # Stardent Vistra i860-SVR4
 	else # Add other i860-SVR4 vendors below as they are discovered.
-	  echo i860-unknown-sysv"$UNAME_RELEASE"  # Unknown i860-SVR4
+	  GUESS=i860-unknown-sysv$UNAME_RELEASE     # Unknown i860-SVR4
 	fi
-	exit ;;
+	;;
     mini*:CTIX:SYS*5:*)
 	# "miniframe"
-	echo m68010-convergent-sysv
-	exit ;;
+	GUESS=m68010-convergent-sysv
+	;;
     mc68k:UNIX:SYSTEM5:3.51m)
-	echo m68k-convergent-sysv
-	exit ;;
+	GUESS=m68k-convergent-sysv
+	;;
     M680?0:D-NIX:5.3:*)
-	echo m68k-diab-dnix
-	exit ;;
+	GUESS=m68k-diab-dnix
+	;;
     M68*:*:R3V5678*:*)
 	test -r /sysV68 && { echo 'm68k-motorola-sysv'; exit; } ;;
     3345??:*:4.0:3.0 | 334??A:*:4.0:3.0 | 334??,*:*:4.0:3.0 | 334??/*:*:4.0:3.0 | 4400:*:4.0:3.0 | 4850:*:4.0:3.0 | SKA40:*:4.0:3.0 | SDS2:*:4.0:3.0 | SHG2:*:4.0:3.0 | S7501*:*:4.0:3.0)
@@ -1185,250 +1307,407 @@
 	/bin/uname -p 2>/dev/null | /bin/grep pteron >/dev/null \
 	    && { echo i586-ncr-sysv4.3"$OS_REL"; exit; } ;;
     m68*:LynxOS:2.*:* | m68*:LynxOS:3.0*:*)
-	echo m68k-unknown-lynxos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-unknown-lynxos$UNAME_RELEASE
+	;;
     mc68030:UNIX_System_V:4.*:*)
-	echo m68k-atari-sysv4
-	exit ;;
+	GUESS=m68k-atari-sysv4
+	;;
     TSUNAMI:LynxOS:2.*:*)
-	echo sparc-unknown-lynxos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sparc-unknown-lynxos$UNAME_RELEASE
+	;;
     rs6000:LynxOS:2.*:*)
-	echo rs6000-unknown-lynxos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=rs6000-unknown-lynxos$UNAME_RELEASE
+	;;
     PowerPC:LynxOS:2.*:* | PowerPC:LynxOS:3.01*:* | PowerPC:LynxOS:4.02*:*)
-	echo powerpc-unknown-lynxos"$UNAME_RELEASE"
-	exit ;;
+	GUESS=powerpc-unknown-lynxos$UNAME_RELEASE
+	;;
     SMBES:UNIX_SV:*:*)
-	echo mips-dde-sysv"$UNAME_RELEASE"
-	exit ;;
+	GUESS=mips-dde-sysv$UNAME_RELEASE
+	;;
     RM*:ReliantUNIX-*:*:*)
-	echo mips-sni-sysv4
-	exit ;;
+	GUESS=mips-sni-sysv4
+	;;
     RM*:SINIX-*:*:*)
-	echo mips-sni-sysv4
-	exit ;;
+	GUESS=mips-sni-sysv4
+	;;
     *:SINIX-*:*:*)
 	if uname -p 2>/dev/null >/dev/null ; then
 		UNAME_MACHINE=`(uname -p) 2>/dev/null`
-		echo "$UNAME_MACHINE"-sni-sysv4
+		GUESS=$UNAME_MACHINE-sni-sysv4
 	else
-		echo ns32k-sni-sysv
+		GUESS=ns32k-sni-sysv
 	fi
-	exit ;;
+	;;
     PENTIUM:*:4.0*:*)	# Unisys `ClearPath HMP IX 4000' SVR4/MP effort
 			# says <Richard.M.Bartel@ccMail.Census.GOV>
-	echo i586-unisys-sysv4
-	exit ;;
+	GUESS=i586-unisys-sysv4
+	;;
     *:UNIX_System_V:4*:FTX*)
 	# From Gerald Hewes <hewes@openmarket.com>.
 	# How about differentiating between stratus architectures? -djm
-	echo hppa1.1-stratus-sysv4
-	exit ;;
+	GUESS=hppa1.1-stratus-sysv4
+	;;
     *:*:*:FTX*)
 	# From seanf@swdc.stratus.com.
-	echo i860-stratus-sysv4
-	exit ;;
+	GUESS=i860-stratus-sysv4
+	;;
     i*86:VOS:*:*)
 	# From Paul.Green@stratus.com.
-	echo "$UNAME_MACHINE"-stratus-vos
-	exit ;;
+	GUESS=$UNAME_MACHINE-stratus-vos
+	;;
     *:VOS:*:*)
 	# From Paul.Green@stratus.com.
-	echo hppa1.1-stratus-vos
-	exit ;;
+	GUESS=hppa1.1-stratus-vos
+	;;
     mc68*:A/UX:*:*)
-	echo m68k-apple-aux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=m68k-apple-aux$UNAME_RELEASE
+	;;
     news*:NEWS-OS:6*:*)
-	echo mips-sony-newsos6
-	exit ;;
+	GUESS=mips-sony-newsos6
+	;;
     R34000:*System_V*:*:* | R4000:UNIX_SYSV:*:* | R*000:UNIX_SV:*:*)
-	if  -d /usr/nec ; then
-		echo mips-nec-sysv"$UNAME_RELEASE"
+	if test -d /usr/nec; then
+		GUESS=mips-nec-sysv$UNAME_RELEASE
 	else
-		echo mips-unknown-sysv"$UNAME_RELEASE"
+		GUESS=mips-unknown-sysv$UNAME_RELEASE
 	fi
-	exit ;;
+	;;
     BeBox:BeOS:*:*)	# BeOS running on hardware made by Be, PPC only.
-	echo powerpc-be-beos
-	exit ;;
+	GUESS=powerpc-be-beos
+	;;
     BeMac:BeOS:*:*)	# BeOS running on Mac or Mac clone, PPC only.
-	echo powerpc-apple-beos
-	exit ;;
+	GUESS=powerpc-apple-beos
+	;;
     BePC:BeOS:*:*)	# BeOS running on Intel PC compatible.
-	echo i586-pc-beos
-	exit ;;
+	GUESS=i586-pc-beos
+	;;
     BePC:Haiku:*:*)	# Haiku running on Intel PC compatible.
-	echo i586-pc-haiku
-	exit ;;
-    x86_64:Haiku:*:*)
-	echo x86_64-unknown-haiku
-	exit ;;
+	GUESS=i586-pc-haiku
+	;;
+    ppc:Haiku:*:*)	# Haiku running on Apple PowerPC
+	GUESS=powerpc-apple-haiku
+	;;
+    *:Haiku:*:*)	# Haiku modern gcc (not bound by BeOS compat)
+	GUESS=$UNAME_MACHINE-unknown-haiku
+	;;
     SX-4:SUPER-UX:*:*)
-	echo sx4-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx4-nec-superux$UNAME_RELEASE
+	;;
     SX-5:SUPER-UX:*:*)
-	echo sx5-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx5-nec-superux$UNAME_RELEASE
+	;;
     SX-6:SUPER-UX:*:*)
-	echo sx6-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx6-nec-superux$UNAME_RELEASE
+	;;
     SX-7:SUPER-UX:*:*)
-	echo sx7-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx7-nec-superux$UNAME_RELEASE
+	;;
     SX-8:SUPER-UX:*:*)
-	echo sx8-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx8-nec-superux$UNAME_RELEASE
+	;;
     SX-8R:SUPER-UX:*:*)
-	echo sx8r-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sx8r-nec-superux$UNAME_RELEASE
+	;;
     SX-ACE:SUPER-UX:*:*)
-	echo sxace-nec-superux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=sxace-nec-superux$UNAME_RELEASE
+	;;
     Power*:Rhapsody:*:*)
-	echo powerpc-apple-rhapsody"$UNAME_RELEASE"
-	exit ;;
+	GUESS=powerpc-apple-rhapsody$UNAME_RELEASE
+	;;
     *:Rhapsody:*:*)
-	echo "$UNAME_MACHINE"-apple-rhapsody"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-apple-rhapsody$UNAME_RELEASE
+	;;
+    arm64:Darwin:*:*)
+	GUESS=aarch64-apple-darwin$UNAME_RELEASE
+	;;
     *:Darwin:*:*)
-	UNAME_PROCESSOR=`uname -p` || UNAME_PROCESSOR=unknown
-	set_cc_for_build
-	if test "$UNAME_PROCESSOR" = unknown ; then
-	    UNAME_PROCESSOR=powerpc
+	UNAME_PROCESSOR=`uname -p`
+	case $UNAME_PROCESSOR in
+	    unknown) UNAME_PROCESSOR=powerpc ;;
+	esac
+	if command -v xcode-select > /dev/null 2> /dev/null && \
+		! xcode-select --print-path > /dev/null 2> /dev/null ; then
+	    # Avoid executing cc if there is no toolchain installed as
+	    # cc will be a stub that puts up a graphical alert
+	    # prompting the user to install developer tools.
+	    CC_FOR_BUILD=no_compiler_found
+	else
+	    set_cc_for_build
 	fi
-	if test "`echo "$UNAME_RELEASE" | sed -e 's/\..*//'`" -le 10 ; then
-	    if  "$CC_FOR_BUILD" != no_compiler_found ; then
-		if (echo '#ifdef __LP64__'; echo IS_64BIT_ARCH; echo '#endif') | \
-		       (CCOPTS="" $CC_FOR_BUILD -E - 2>/dev/null) | \
-		       grep IS_64BIT_ARCH >/dev/null
-		then
-		    case $UNAME_PROCESSOR in
-			i386) UNAME_PROCESSOR=x86_64 ;;
-			powerpc) UNAME_PROCESSOR=powerpc64 ;;
-		    esac
-		fi
-		# On 10.4-10.6 one might compile for PowerPC via gcc -arch ppc
-		if (echo '#ifdef __POWERPC__'; echo IS_PPC; echo '#endif') | \
-		       (CCOPTS="" $CC_FOR_BUILD -E - 2>/dev/null) | \
-		       grep IS_PPC >/dev/null
-		then
-		    UNAME_PROCESSOR=powerpc
-		fi
+	if test "$CC_FOR_BUILD" != no_compiler_found; then
+	    if (echo '#ifdef __LP64__'; echo IS_64BIT_ARCH; echo '#endif') | \
+		   (CCOPTS="" $CC_FOR_BUILD -E - 2>/dev/null) | \
+		   grep IS_64BIT_ARCH >/dev/null
+	    then
+		case $UNAME_PROCESSOR in
+		    i386) UNAME_PROCESSOR=x86_64 ;;
+		    powerpc) UNAME_PROCESSOR=powerpc64 ;;
+		esac
+	    fi
+	    # On 10.4-10.6 one might compile for PowerPC via gcc -arch ppc
+	    if (echo '#ifdef __POWERPC__'; echo IS_PPC; echo '#endif') | \
+		   (CCOPTS="" $CC_FOR_BUILD -E - 2>/dev/null) | \
+		   grep IS_PPC >/dev/null
+	    then
+		UNAME_PROCESSOR=powerpc
 	    fi
 	elif test "$UNAME_PROCESSOR" = i386 ; then
-	    # Avoid executing cc on OS X 10.9, as it ships with a stub
-	    # that puts up a graphical alert prompting to install
-	    # developer tools.  Any system running Mac OS X 10.7 or
-	    # later (Darwin 11 and later) is required to have a 64-bit
-	    # processor. This is not true of the ARM version of Darwin
-	    # that Apple uses in portable devices.
-	    UNAME_PROCESSOR=x86_64
+	    # uname -m returns i386 or x86_64
+	    UNAME_PROCESSOR=$UNAME_MACHINE
 	fi
-	echo "$UNAME_PROCESSOR"-apple-darwin"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_PROCESSOR-apple-darwin$UNAME_RELEASE
+	;;
     *:procnto*:*:* | *:QNX:0123456789*:*)
 	UNAME_PROCESSOR=`uname -p`
 	if test "$UNAME_PROCESSOR" = x86; then
 		UNAME_PROCESSOR=i386
 		UNAME_MACHINE=pc
 	fi
-	echo "$UNAME_PROCESSOR"-"$UNAME_MACHINE"-nto-qnx"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_PROCESSOR-$UNAME_MACHINE-nto-qnx$UNAME_RELEASE
+	;;
     *:QNX:*:4*)
-	echo i386-pc-qnx
-	exit ;;
+	GUESS=i386-pc-qnx
+	;;
     NEO-*:NONSTOP_KERNEL:*:*)
-	echo neo-tandem-nsk"$UNAME_RELEASE"
-	exit ;;
+	GUESS=neo-tandem-nsk$UNAME_RELEASE
+	;;
     NSE-*:NONSTOP_KERNEL:*:*)
-	echo nse-tandem-nsk"$UNAME_RELEASE"
-	exit ;;
+	GUESS=nse-tandem-nsk$UNAME_RELEASE
+	;;
     NSR-*:NONSTOP_KERNEL:*:*)
-	echo nsr-tandem-nsk"$UNAME_RELEASE"
-	exit ;;
+	GUESS=nsr-tandem-nsk$UNAME_RELEASE
+	;;
     NSV-*:NONSTOP_KERNEL:*:*)
-	echo nsv-tandem-nsk"$UNAME_RELEASE"
-	exit ;;
+	GUESS=nsv-tandem-nsk$UNAME_RELEASE
+	;;
     NSX-*:NONSTOP_KERNEL:*:*)
-	echo nsx-tandem-nsk"$UNAME_RELEASE"
-	exit ;;
+	GUESS=nsx-tandem-nsk$UNAME_RELEASE
+	;;
     *:NonStop-UX:*:*)
-	echo mips-compaq-nonstopux
-	exit ;;
+	GUESS=mips-compaq-nonstopux
+	;;
     BS2000:POSIX*:*:*)
-	echo bs2000-siemens-sysv
-	exit ;;
+	GUESS=bs2000-siemens-sysv
+	;;
     DS/*:UNIX_System_V:*:*)
-	echo "$UNAME_MACHINE"-"$UNAME_SYSTEM"-"$UNAME_RELEASE"
-	exit ;;
+	GUESS=$UNAME_MACHINE-$UNAME_SYSTEM-$UNAME_RELEASE
+	;;
     *:Plan9:*:*)
 	# "uname -m" is not consistent, so use $cputype instead. 386
 	# is converted to i386 for consistency with other x86
 	# operating systems.
-	# shellcheck disable=SC2154
-	if test "$cputype" = 386; then
+	if test "${cputype-}" = 386; then
 	    UNAME_MACHINE=i386
-	else
-	    UNAME_MACHINE="$cputype"
+	elif test "x${cputype-}" != x; then
+	    UNAME_MACHINE=$cputype
 	fi
-	echo "$UNAME_MACHINE"-unknown-plan9
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-plan9
+	;;
     *:TOPS-10:*:*)
-	echo pdp10-unknown-tops10
-	exit ;;
+	GUESS=pdp10-unknown-tops10
+	;;
     *:TENEX:*:*)
-	echo pdp10-unknown-tenex
-	exit ;;
+	GUESS=pdp10-unknown-tenex
+	;;
     KS10:TOPS-20:*:* | KL10:TOPS-20:*:* | TYPE4:TOPS-20:*:*)
-	echo pdp10-dec-tops20
-	exit ;;
+	GUESS=pdp10-dec-tops20
+	;;
     XKL-1:TOPS-20:*:* | TYPE5:TOPS-20:*:*)
-	echo pdp10-xkl-tops20
-	exit ;;
+	GUESS=pdp10-xkl-tops20
+	;;
     *:TOPS-20:*:*)
-	echo pdp10-unknown-tops20
-	exit ;;
+	GUESS=pdp10-unknown-tops20
+	;;
     *:ITS:*:*)
-	echo pdp10-unknown-its
-	exit ;;
+	GUESS=pdp10-unknown-its
+	;;
     SEI:*:*:SEIUX)
-	echo mips-sei-seiux"$UNAME_RELEASE"
-	exit ;;
+	GUESS=mips-sei-seiux$UNAME_RELEASE
+	;;
     *:DragonFly:*:*)
-	echo "$UNAME_MACHINE"-unknown-dragonfly"`echo "$UNAME_RELEASE"|sed -e 's/-(.*//'`"
-	exit ;;
+	DRAGONFLY_REL=`echo "$UNAME_RELEASE" | sed -e 's/-(.*//'`
+	GUESS=$UNAME_MACHINE-unknown-dragonfly$DRAGONFLY_REL
+	;;
     *:*VMS:*:*)
 	UNAME_MACHINE=`(uname -p) 2>/dev/null`
-	case "$UNAME_MACHINE" in
-	    A*) echo alpha-dec-vms ; exit ;;
-	    I*) echo ia64-dec-vms ; exit ;;
-	    V*) echo vax-dec-vms ; exit ;;
+	case $UNAME_MACHINE in
+	    A*) GUESS=alpha-dec-vms ;;
+	    I*) GUESS=ia64-dec-vms ;;
+	    V*) GUESS=vax-dec-vms ;;
 	esac ;;
     *:XENIX:*:SysV)
-	echo i386-pc-xenix
-	exit ;;
+	GUESS=i386-pc-xenix
+	;;
     i*86:skyos:*:*)
-	echo "$UNAME_MACHINE"-pc-skyos"`echo "$UNAME_RELEASE" | sed -e 's/ .*$//'`"
-	exit ;;
+	SKYOS_REL=`echo "$UNAME_RELEASE" | sed -e 's/ .*$//'`
+	GUESS=$UNAME_MACHINE-pc-skyos$SKYOS_REL
+	;;
     i*86:rdos:*:*)
-	echo "$UNAME_MACHINE"-pc-rdos
-	exit ;;
-    i*86:AROS:*:*)
-	echo "$UNAME_MACHINE"-pc-aros
-	exit ;;
+	GUESS=$UNAME_MACHINE-pc-rdos
+	;;
+    i*86:Fiwix:*:*)
+	GUESS=$UNAME_MACHINE-pc-fiwix
+	;;
+    *:AROS:*:*)
+	GUESS=$UNAME_MACHINE-unknown-aros
+	;;
     x86_64:VMkernel:*:*)
-	echo "$UNAME_MACHINE"-unknown-esx
-	exit ;;
+	GUESS=$UNAME_MACHINE-unknown-esx
+	;;
     amd64:Isilon\ OneFS:*:*)
-	echo x86_64-unknown-onefs
-	exit ;;
+	GUESS=x86_64-unknown-onefs
+	;;
+    *:Unleashed:*:*)
+	GUESS=$UNAME_MACHINE-unknown-unleashed$UNAME_RELEASE
+	;;
 esac
 
+# Do we have a guess based on uname results?
+if test "x$GUESS" != x; then
+    echo "$GUESS"
+    exit
+fi
+
+# No uname command or uname output not recognized.
+set_cc_for_build
+cat > "$dummy.c" <<EOF
+#ifdef _SEQUENT_
+#include <sys/types.h>
+#include <sys/utsname.h>
+#endif
+#if defined(ultrix) || defined(_ultrix) || defined(__ultrix) || defined(__ultrix__)
+#if defined (vax) || defined (__vax) || defined (__vax__) || defined(mips) || defined(__mips) || defined(__mips__) || defined(MIPS) || defined(__MIPS__)
+#include <signal.h>
+#if defined(_SIZE_T_) || defined(SIGLOST)
+#include <sys/utsname.h>
+#endif
+#endif
+#endif
+main ()
+{
+#if defined (sony)
+#if defined (MIPSEB)
+  /* BFD wants "bsd" instead of "newsos".  Perhaps BFD should be changed,
+     I don't know....  */
+  printf ("mips-sony-bsd\n"); exit (0);
+#else
+#include <sys/param.h>
+  printf ("m68k-sony-newsos%s\n",
+#ifdef NEWSOS4
+  "4"
+#else
+  ""
+#endif
+  ); exit (0);
+#endif
+#endif
+
+#if defined (NeXT)
+#if !defined (__ARCHITECTURE__)
+#define __ARCHITECTURE__ "m68k"
+#endif
+  int version;
+  version=`(hostinfo | sed -n 's/.*NeXT Mach $0-9*$.*/\1/p') 2>/dev/null`;
+  if (version < 4)
+    printf ("%s-next-nextstep%d\n", __ARCHITECTURE__, version);
+  else
+    printf ("%s-next-openstep%d\n", __ARCHITECTURE__, version);
+  exit (0);
+#endif
+
+#if defined (MULTIMAX) || defined (n16)
+#if defined (UMAXV)
+  printf ("ns32k-encore-sysv\n"); exit (0);
+#else
+#if defined (CMU)
+  printf ("ns32k-encore-mach\n"); exit (0);
+#else
+  printf ("ns32k-encore-bsd\n"); exit (0);
+#endif
+#endif
+#endif
+
+#if defined (__386BSD__)
+  printf ("i386-pc-bsd\n"); exit (0);
+#endif
+
+#if defined (sequent)
+#if defined (i386)
+  printf ("i386-sequent-dynix\n"); exit (0);
+#endif
+#if defined (ns32000)
+  printf ("ns32k-sequent-dynix\n"); exit (0);
+#endif
+#endif
+
+#if defined (_SEQUENT_)
+  struct utsname un;
+
+  uname(&un);
+  if (strncmp(un.version, "V2", 2) == 0) {
+    printf ("i386-sequent-ptx2\n"); exit (0);
+  }
+  if (strncmp(un.version, "V1", 2) == 0) { /* XXX is V1 correct? */
+    printf ("i386-sequent-ptx1\n"); exit (0);
+  }
+  printf ("i386-sequent-ptx\n"); exit (0);
+#endif
+
+#if defined (vax)
+#if !defined (ultrix)
+#include <sys/param.h>
+#if defined (BSD)
+#if BSD == 43
+  printf ("vax-dec-bsd4.3\n"); exit (0);
+#else
+#if BSD == 199006
+  printf ("vax-dec-bsd4.3reno\n"); exit (0);
+#else
+  printf ("vax-dec-bsd\n"); exit (0);
+#endif
+#endif
+#else
+  printf ("vax-dec-bsd\n"); exit (0);
+#endif
+#else
+#if defined(_SIZE_T_) || defined(SIGLOST)
+  struct utsname un;
+  uname (&un);
+  printf ("vax-dec-ultrix%s\n", un.release); exit (0);
+#else
+  printf ("vax-dec-ultrix\n"); exit (0);
+#endif
+#endif
+#endif
+#if defined(ultrix) || defined(_ultrix) || defined(__ultrix) || defined(__ultrix__)
+#if defined(mips) || defined(__mips) || defined(__mips__) || defined(MIPS) || defined(__MIPS__)
+#if defined(_SIZE_T_) || defined(SIGLOST)
+  struct utsname *un;
+  uname (&un);
+  printf ("mips-dec-ultrix%s\n", un.release); exit (0);
+#else
+  printf ("mips-dec-ultrix\n"); exit (0);
+#endif
+#endif
+#endif
+
+#if defined (alliant) && defined (i860)
+  printf ("i860-alliant-bsd\n"); exit (0);
+#endif
+
+  exit (1);
+}
+EOF
+
+$CC_FOR_BUILD -o "$dummy" "$dummy.c" 2>/dev/null && SYSTEM_NAME=`"$dummy"` &&
+	{ echo "$SYSTEM_NAME"; exit; }
+
+# Apollos put the system type in the environment.
+test -d /usr/apollo && { echo "$ISP-apollo-$SYSTYPE"; exit; }
+
 echo "$0: unable to guess system type" >&2
 
-case "$UNAME_MACHINE:$UNAME_SYSTEM" in
+case $UNAME_MACHINE:$UNAME_SYSTEM in
     mips:Linux | mips64:Linux)
 	# If we got here on MIPS GNU/Linux, output extra information.
 	cat >&2 <<EOF
@@ -1445,9 +1724,17 @@
 operating system you are using. If your script is old, overwrite *all*
 copies of config.guess and config.sub with the latest versions from:
 
-  https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.guess
+  https://git.savannah.gnu.org/cgit/config.git/plain/config.guess
 and
-  https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.sub
+  https://git.savannah.gnu.org/cgit/config.git/plain/config.sub
+EOF
+
+our_year=`echo $timestamp | sed 's,-.*,,'`
+thisyear=`date +%Y`
+# shellcheck disable=SC2003
+script_age=`expr "$thisyear" - "$our_year"`
+if test "$script_age" -lt 3 ; then
+   cat >&2 <<EOF
 
 If $0 has already been updated, send the following data and any
 information you think might be pertinent to config-patches@gnu.org to
@@ -1475,6 +1762,7 @@
 UNAME_SYSTEM  = "$UNAME_SYSTEM"
 UNAME_VERSION = "$UNAME_VERSION"
 EOF
+fi
 
 exit 1

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/config.rpath -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/config.rpath Changed

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/config.sub -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/config.sub Changed

@@ -1,12 +1,14 @@
 #! /bin/sh
 # Configuration validation subroutine script.
-#   Copyright 1992-2018 Free Software Foundation, Inc.
+#   Copyright 1992-2023 Free Software Foundation, Inc.
 
-timestamp='2018-08-29'
+# shellcheck disable=SC2006,SC2268 # see below for rationale
+
+timestamp='2023-01-21'
 
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This program is distributed in the hope that it will be useful, but
@@ -33,7 +35,7 @@
 # Otherwise, we print the canonical config type on stdout and succeed.
 
 # You can get the latest version of this script from:
-# https://git.savannah.gnu.org/gitweb/?p=config.git;a=blob_plain;f=config.sub
+# https://git.savannah.gnu.org/cgit/config.git/plain/config.sub
 
 # This file is supposed to be the same for all GNU packages
 # and recognize all the CPU types, system types and aliases
@@ -50,6 +52,13 @@
 #	CPU_TYPE-MANUFACTURER-KERNEL-OPERATING_SYSTEM
 # It is wrong to echo any other type of specification.
 
+# The "shellcheck disable" line above the timestamp inhibits complaints
+# about features and limitations of the classic Bourne shell that were
+# superseded or lifted in POSIX.  However, this script identifies a wide
+# variety of pre-POSIX systems that do not have POSIX shells at all, and
+# even some reasonably current systems (Solaris 10 as case-in-point) still
+# have a pre-POSIX /bin/sh.
+
 me=`echo "$0" | sed -e 's,.*/,,'`
 
 usage="\
@@ -67,7 +76,7 @@
 version="\
 GNU config.sub ($timestamp)
 
-Copyright 1992-2018 Free Software Foundation, Inc.
+Copyright 1992-2023 Free Software Foundation, Inc.
 
 This is free software; see the source for copying conditions.  There is NO
 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
@@ -89,7 +98,7 @@
     - )	# Use stdin as input.
        break ;;
     -* )
-       echo "$me: invalid option $1$help"
+       echo "$me: invalid option $1$help" >&2
        exit 1 ;;
 
     *local*)
@@ -111,9 +120,12 @@
 esac
 
 # Split fields of configuration type
-IFS="-" read -r field1 field2 field3 field4 <<EOF
+# shellcheck disable=SC2162
+saved_IFS=$IFS
+IFS="-" read field1 field2 field3 field4 <<EOF
 $1
 EOF
+IFS=$saved_IFS
 
 # Separate into logical components for further validation
 case $1 in
@@ -123,37 +135,36 @@
 		;;
 	*-*-*-*)
 		basic_machine=$field1-$field2
-		os=$field3-$field4
+		basic_os=$field3-$field4
 		;;
 	*-*-*)
 		# Ambiguous whether COMPANY is present, or skipped and KERNEL-OS is two
 		# parts
 		maybe_os=$field2-$field3
 		case $maybe_os in
-			nto-qnx* | linux-gnu* | linux-android* | linux-dietlibc \
-			| linux-newlib* | linux-musl* | linux-uclibc* | uclinux-uclibc* \
+			nto-qnx* | linux-* | uclinux-uclibc* \
 			| uclinux-gnu* | kfreebsd*-gnu* | knetbsd*-gnu* | netbsd*-gnu* \
 			| netbsd*-eabi* | kopensolaris*-gnu* | cloudabi*-eabi* \
-			| storm-chaos* | os2-emx* | rtmk-nova*)
+			| storm-chaos* | os2-emx* | rtmk-nova* | managarm-*)
 				basic_machine=$field1
-				os=$maybe_os
+				basic_os=$maybe_os
 				;;
 			android-linux)
 				basic_machine=$field1-unknown
-				os=linux-android
+				basic_os=linux-android
 				;;
 			*)
 				basic_machine=$field1-$field2
-				os=$field3
+				basic_os=$field3
 				;;
 		esac
 		;;
 	*-*)
-		# A lone config we happen to match not fitting any patern
+		# A lone config we happen to match not fitting any pattern
 		case $field1-$field2 in
 			decstation-3100)
 				basic_machine=mips-dec
-				os=
+				basic_os=
 				;;
 			*-*)
 				# Second component is usually, but not always the OS
@@ -161,7 +172,11 @@
 					# Prevent following clause from handling this valid os
 					sun*os*)
 						basic_machine=$field1
-						os=$field2
+						basic_os=$field2
+						;;
+					zephyr*)
+						basic_machine=$field1-unknown
+						basic_os=$field2
 						;;
 					# Manufacturers
 					dec* | mips* | sequent* | encore* | pc533* | sgi* | sony* \
@@ -174,11 +189,11 @@
 					| microblaze* | sim | cisco \
 					| oki | wec | wrs | winbond)
 						basic_machine=$field1-$field2
-						os=
+						basic_os=
 						;;
 					*)
 						basic_machine=$field1
-						os=$field2
+						basic_os=$field2
 						;;
 				esac
 			;;
@@ -190,450 +205,451 @@
 		case $field1 in
 			386bsd)
 				basic_machine=i386-pc
-				os=bsd
+				basic_os=bsd
 				;;
 			a29khif)
 				basic_machine=a29k-amd
-				os=udi
+				basic_os=udi
 				;;
 			adobe68k)
 				basic_machine=m68010-adobe
-				os=scout
+				basic_os=scout
 				;;
 			alliant)
 				basic_machine=fx80-alliant
-				os=
+				basic_os=
 				;;
 			altos | altos3068)
 				basic_machine=m68k-altos
-				os=
+				basic_os=
 				;;
 			am29k)
 				basic_machine=a29k-none
-				os=bsd
+				basic_os=bsd
 				;;
 			amdahl)
 				basic_machine=580-amdahl
-				os=sysv
+				basic_os=sysv
 				;;
 			amiga)
 				basic_machine=m68k-unknown
-				os=
+				basic_os=
 				;;
 			amigaos | amigados)
 				basic_machine=m68k-unknown
-				os=amigaos
+				basic_os=amigaos
 				;;
 			amigaunix | amix)
 				basic_machine=m68k-unknown
-				os=sysv4
+				basic_os=sysv4
 				;;
 			apollo68)
 				basic_machine=m68k-apollo
-				os=sysv
+				basic_os=sysv
 				;;
 			apollo68bsd)
 				basic_machine=m68k-apollo
-				os=bsd
+				basic_os=bsd
 				;;
 			aros)
 				basic_machine=i386-pc
-				os=aros
+				basic_os=aros
 				;;
 			aux)
 				basic_machine=m68k-apple
-				os=aux
+				basic_os=aux
 				;;
 			balance)
 				basic_machine=ns32k-sequent
-				os=dynix
+				basic_os=dynix
 				;;
 			blackfin)
 				basic_machine=bfin-unknown
-				os=linux
+				basic_os=linux
 				;;
 			cegcc)
 				basic_machine=arm-unknown
-				os=cegcc
+				basic_os=cegcc
 				;;
 			convex-c1)
 				basic_machine=c1-convex
-				os=bsd
+				basic_os=bsd
 				;;
 			convex-c2)
 				basic_machine=c2-convex
-				os=bsd
+				basic_os=bsd
 				;;
 			convex-c32)
 				basic_machine=c32-convex
-				os=bsd
+				basic_os=bsd
 				;;
 			convex-c34)
 				basic_machine=c34-convex
-				os=bsd
+				basic_os=bsd
 				;;
 			convex-c38)
 				basic_machine=c38-convex
-				os=bsd
+				basic_os=bsd
 				;;
 			cray)
 				basic_machine=j90-cray
-				os=unicos
+				basic_os=unicos
 				;;
 			crds | unos)
 				basic_machine=m68k-crds
-				os=
+				basic_os=
 				;;
 			da30)
 				basic_machine=m68k-da30
-				os=
+				basic_os=
 				;;
 			decstation | pmax | pmin | dec3100 | decstatn)
 				basic_machine=mips-dec
-				os=
+				basic_os=
 				;;
 			delta88)
 				basic_machine=m88k-motorola
-				os=sysv3
+				basic_os=sysv3
 				;;
 			dicos)
 				basic_machine=i686-pc
-				os=dicos
+				basic_os=dicos
 				;;
 			djgpp)
 				basic_machine=i586-pc
-				os=msdosdjgpp
+				basic_os=msdosdjgpp
 				;;
 			ebmon29k)
 				basic_machine=a29k-amd
-				os=ebmon
+				basic_os=ebmon
 				;;
 			es1800 | OSE68k | ose68k | ose | OSE)
 				basic_machine=m68k-ericsson
-				os=ose
+				basic_os=ose
 				;;
 			gmicro)
 				basic_machine=tron-gmicro
-				os=sysv
+				basic_os=sysv
 				;;
 			go32)
 				basic_machine=i386-pc
-				os=go32
+				basic_os=go32
 				;;
 			h8300hms)
 				basic_machine=h8300-hitachi
-				os=hms
+				basic_os=hms
 				;;
 			h8300xray)
 				basic_machine=h8300-hitachi
-				os=xray
+				basic_os=xray
 				;;
 			h8500hms)
 				basic_machine=h8500-hitachi
-				os=hms
+				basic_os=hms
 				;;
 			harris)
 				basic_machine=m88k-harris
-				os=sysv3
+				basic_os=sysv3
 				;;
-			hp300)
+			hp300 | hp300hpux)
 				basic_machine=m68k-hp
+				basic_os=hpux
 				;;
 			hp300bsd)
 				basic_machine=m68k-hp
-				os=bsd
-				;;
-			hp300hpux)
-				basic_machine=m68k-hp
-				os=hpux
+				basic_os=bsd
 				;;
 			hppaosf)
 				basic_machine=hppa1.1-hp
-				os=osf
+				basic_os=osf
 				;;
 			hppro)
 				basic_machine=hppa1.1-hp
-				os=proelf
+				basic_os=proelf
 				;;
 			i386mach)
 				basic_machine=i386-mach
-				os=mach
-				;;
-			vsta)
-				basic_machine=i386-pc
-				os=vsta
+				basic_os=mach
 				;;
 			isi68 | isi)
 				basic_machine=m68k-isi
-				os=sysv
+				basic_os=sysv
 				;;
 			m68knommu)
 				basic_machine=m68k-unknown
-				os=linux
+				basic_os=linux
 				;;
 			magnum | m3230)
 				basic_machine=mips-mips
-				os=sysv
+				basic_os=sysv
 				;;
 			merlin)
 				basic_machine=ns32k-utek
-				os=sysv
+				basic_os=sysv
 				;;
 			mingw64)
 				basic_machine=x86_64-pc
-				os=mingw64
+				basic_os=mingw64
 				;;
 			mingw32)
 				basic_machine=i686-pc
-				os=mingw32
+				basic_os=mingw32
 				;;
 			mingw32ce)
 				basic_machine=arm-unknown
-				os=mingw32ce
+				basic_os=mingw32ce
 				;;
 			monitor)
 				basic_machine=m68k-rom68k
-				os=coff
+				basic_os=coff
 				;;
 			morphos)
 				basic_machine=powerpc-unknown
-				os=morphos
+				basic_os=morphos
 				;;
 			moxiebox)
 				basic_machine=moxie-unknown
-				os=moxiebox
+				basic_os=moxiebox
 				;;
 			msdos)
 				basic_machine=i386-pc
-				os=msdos
+				basic_os=msdos
 				;;
 			msys)
 				basic_machine=i686-pc
-				os=msys
+				basic_os=msys
 				;;
 			mvs)
 				basic_machine=i370-ibm
-				os=mvs
+				basic_os=mvs
 				;;
 			nacl)
 				basic_machine=le32-unknown
-				os=nacl
+				basic_os=nacl
 				;;
 			ncr3000)
 				basic_machine=i486-ncr
-				os=sysv4
+				basic_os=sysv4
 				;;
 			netbsd386)
 				basic_machine=i386-pc
-				os=netbsd
+				basic_os=netbsd
 				;;
 			netwinder)
 				basic_machine=armv4l-rebel
-				os=linux
+				basic_os=linux
 				;;
 			news | news700 | news800 | news900)
 				basic_machine=m68k-sony
-				os=newsos
+				basic_os=newsos
 				;;
 			news1000)
 				basic_machine=m68030-sony
-				os=newsos
+				basic_os=newsos
 				;;
 			necv70)
 				basic_machine=v70-nec
-				os=sysv
+				basic_os=sysv
 				;;
 			nh3000)
 				basic_machine=m68k-harris
-				os=cxux
+				basic_os=cxux
 				;;
 			nh45000)
 				basic_machine=m88k-harris
-				os=cxux
+				basic_os=cxux
 				;;
 			nindy960)
 				basic_machine=i960-intel
-				os=nindy
+				basic_os=nindy
 				;;
 			mon960)
 				basic_machine=i960-intel
-				os=mon960
+				basic_os=mon960
 				;;
 			nonstopux)
 				basic_machine=mips-compaq
-				os=nonstopux
+				basic_os=nonstopux
 				;;
 			os400)
 				basic_machine=powerpc-ibm
-				os=os400
+				basic_os=os400
 				;;
 			OSE68000 | ose68000)
 				basic_machine=m68000-ericsson
-				os=ose
+				basic_os=ose
 				;;
 			os68k)
 				basic_machine=m68k-none
-				os=os68k
+				basic_os=os68k
 				;;
 			paragon)
 				basic_machine=i860-intel
-				os=osf
+				basic_os=osf
 				;;
 			parisc)
 				basic_machine=hppa-unknown
-				os=linux
+				basic_os=linux
+				;;
+			psp)
+				basic_machine=mipsallegrexel-sony
+				basic_os=psp
 				;;
 			pw32)
 				basic_machine=i586-unknown
-				os=pw32
+				basic_os=pw32
 				;;
 			rdos | rdos64)
 				basic_machine=x86_64-pc
-				os=rdos
+				basic_os=rdos
 				;;
 			rdos32)
 				basic_machine=i386-pc
-				os=rdos
+				basic_os=rdos
 				;;
 			rom68k)
 				basic_machine=m68k-rom68k
-				os=coff
+				basic_os=coff
 				;;
 			sa29200)
 				basic_machine=a29k-amd
-				os=udi
+				basic_os=udi
 				;;
 			sei)
 				basic_machine=mips-sei
-				os=seiux
+				basic_os=seiux
 				;;
 			sequent)
 				basic_machine=i386-sequent
-				os=
+				basic_os=
 				;;
 			sps7)
 				basic_machine=m68k-bull
-				os=sysv2
+				basic_os=sysv2
 				;;
 			st2000)
 				basic_machine=m68k-tandem
-				os=
+				basic_os=
 				;;
 			stratus)
 				basic_machine=i860-stratus
-				os=sysv4
+				basic_os=sysv4
 				;;
 			sun2)
 				basic_machine=m68000-sun
-				os=
+				basic_os=
 				;;
 			sun2os3)
 				basic_machine=m68000-sun
-				os=sunos3
+				basic_os=sunos3
 				;;
 			sun2os4)
 				basic_machine=m68000-sun
-				os=sunos4
+				basic_os=sunos4
 				;;
 			sun3)
 				basic_machine=m68k-sun
-				os=
+				basic_os=
 				;;
 			sun3os3)
 				basic_machine=m68k-sun
-				os=sunos3
+				basic_os=sunos3
 				;;
 			sun3os4)
 				basic_machine=m68k-sun
-				os=sunos4
+				basic_os=sunos4
 				;;
 			sun4)
 				basic_machine=sparc-sun
-				os=
+				basic_os=
 				;;
 			sun4os3)
 				basic_machine=sparc-sun
-				os=sunos3
+				basic_os=sunos3
 				;;
 			sun4os4)
 				basic_machine=sparc-sun
-				os=sunos4
+				basic_os=sunos4
 				;;
 			sun4sol2)
 				basic_machine=sparc-sun
-				os=solaris2
+				basic_os=solaris2
 				;;
 			sun386 | sun386i | roadrunner)
 				basic_machine=i386-sun
-				os=
+				basic_os=
 				;;
 			sv1)
 				basic_machine=sv1-cray
-				os=unicos
+				basic_os=unicos
 				;;
 			symmetry)
 				basic_machine=i386-sequent
-				os=dynix
+				basic_os=dynix
 				;;
 			t3e)
 				basic_machine=alphaev5-cray
-				os=unicos
+				basic_os=unicos
 				;;
 			t90)
 				basic_machine=t90-cray
-				os=unicos
+				basic_os=unicos
 				;;
 			toad1)
 				basic_machine=pdp10-xkl
-				os=tops20
+				basic_os=tops20
 				;;
 			tpf)
 				basic_machine=s390x-ibm
-				os=tpf
+				basic_os=tpf
 				;;
 			udi29k)
 				basic_machine=a29k-amd
-				os=udi
+				basic_os=udi
 				;;
 			ultra3)
 				basic_machine=a29k-nyu
-				os=sym1
+				basic_os=sym1
 				;;
 			v810 | necv810)
 				basic_machine=v810-nec
-				os=none
+				basic_os=none
 				;;
 			vaxv)
 				basic_machine=vax-dec
-				os=sysv
+				basic_os=sysv
 				;;
 			vms)
 				basic_machine=vax-dec
-				os=vms
+				basic_os=vms
+				;;
+			vsta)
+				basic_machine=i386-pc
+				basic_os=vsta
 				;;
 			vxworks960)
 				basic_machine=i960-wrs
-				os=vxworks
+				basic_os=vxworks
 				;;
 			vxworks68)
 				basic_machine=m68k-wrs
-				os=vxworks
+				basic_os=vxworks
 				;;
 			vxworks29k)
 				basic_machine=a29k-wrs
-				os=vxworks
+				basic_os=vxworks
 				;;
 			xbox)
 				basic_machine=i686-pc
-				os=mingw32
+				basic_os=mingw32
 				;;
 			ymp)
 				basic_machine=ymp-cray
-				os=unicos
+				basic_os=unicos
 				;;
 			*)
 				basic_machine=$1
-				os=
+				basic_os=
 				;;
 		esac
 		;;
@@ -685,17 +701,17 @@
 	bluegene*)
 		cpu=powerpc
 		vendor=ibm
-		os=cnk
+		basic_os=cnk
 		;;
 	decsystem10* | dec10*)
 		cpu=pdp10
 		vendor=dec
-		os=tops10
+		basic_os=tops10
 		;;
 	decsystem20* | dec20*)
 		cpu=pdp10
 		vendor=dec
-		os=tops20
+		basic_os=tops20
 		;;
 	delta | 3300 | motorola-3300 | motorola-delta \
 	      | 3300-motorola | delta-motorola)
@@ -705,7 +721,7 @@
 	dpx2*)
 		cpu=m68k
 		vendor=bull
-		os=sysv3
+		basic_os=sysv3
 		;;
 	encore | umax | mmax)
 		cpu=ns32k
@@ -714,7 +730,7 @@
 	elxsi)
 		cpu=elxsi
 		vendor=elxsi
-		os=${os:-bsd}
+		basic_os=${basic_os:-bsd}
 		;;
 	fx2800)
 		cpu=i860
@@ -727,7 +743,7 @@
 	h3050r* | hiux*)
 		cpu=hppa1.1
 		vendor=hitachi
-		os=hiuxwe2
+		basic_os=hiuxwe2
 		;;
 	hp3k90-90-9 | hp90-90-9)
 		cpu=hppa1.0
@@ -770,36 +786,36 @@
 	i*86v32)
 		cpu=`echo "$1" | sed -e 's/86.*/86/'`
 		vendor=pc
-		os=sysv32
+		basic_os=sysv32
 		;;
 	i*86v4*)
 		cpu=`echo "$1" | sed -e 's/86.*/86/'`
 		vendor=pc
-		os=sysv4
+		basic_os=sysv4
 		;;
 	i*86v)
 		cpu=`echo "$1" | sed -e 's/86.*/86/'`
 		vendor=pc
-		os=sysv
+		basic_os=sysv
 		;;
 	i*86sol2)
 		cpu=`echo "$1" | sed -e 's/86.*/86/'`
 		vendor=pc
-		os=solaris2
+		basic_os=solaris2
 		;;
 	j90 | j90-cray)
 		cpu=j90
 		vendor=cray
-		os=${os:-unicos}
+		basic_os=${basic_os:-unicos}
 		;;
 	iris | iris4d)
 		cpu=mips
 		vendor=sgi
-		case $os in
+		case $basic_os in
 		    irix*)
 			;;
 		    *)
-			os=irix4
+			basic_os=irix4
 			;;
 		esac
 		;;
@@ -810,24 +826,26 @@
 	*mint | mint0-9* | *MiNT | *MiNT0-9*)
 		cpu=m68k
 		vendor=atari
-		os=mint
+		basic_os=mint
 		;;
 	news-3600 | risc-news)
 		cpu=mips
 		vendor=sony
-		os=newsos
+		basic_os=newsos
 		;;
 	next | m*-next)
 		cpu=m68k
 		vendor=next
-		case $os in
-		    nextstep* )
+		case $basic_os in
+		    openstep*)
+		        ;;
+		    nextstep*)
 			;;
 		    ns2*)
-		      os=nextstep2
+		      basic_os=nextstep2
 			;;
 		    *)
-		      os=nextstep3
+		      basic_os=nextstep3
 			;;
 		esac
 		;;
@@ -838,12 +856,12 @@
 	op50n-* | op60c-*)
 		cpu=hppa1.1
 		vendor=oki
-		os=proelf
+		basic_os=proelf
 		;;
 	pa-hitachi)
 		cpu=hppa1.1
 		vendor=hitachi
-		os=hiuxwe2
+		basic_os=hiuxwe2
 		;;
 	pbd)
 		cpu=sparc
@@ -880,12 +898,12 @@
 	sde)
 		cpu=mipsisa32
 		vendor=sde
-		os=${os:-elf}
+		basic_os=${basic_os:-elf}
 		;;
 	simso-wrs)
 		cpu=sparclite
 		vendor=wrs
-		os=vxworks
+		basic_os=vxworks
 		;;
 	tower | tower-32)
 		cpu=m68k
@@ -902,7 +920,7 @@
 	w89k-*)
 		cpu=hppa1.1
 		vendor=winbond
-		os=proelf
+		basic_os=proelf
 		;;
 	none)
 		cpu=none
@@ -918,9 +936,12 @@
 		;;
 
 	*-*)
-		IFS="-" read -r cpu vendor <<EOF
+		# shellcheck disable=SC2162
+		saved_IFS=$IFS
+		IFS="-" read cpu vendor <<EOF
 $basic_machine
 EOF
+		IFS=$saved_IFS
 		;;
 	# We use `pc' rather than `unknown'
 	# because (1) that's what they normally are, and
@@ -950,15 +971,15 @@
 
 # Decode basic machines in the full and proper CPU-Company form.
 case $cpu-$vendor in
-	# Here we handle the default manufacturer of certain CPU types in cannonical form. It is in
+	# Here we handle the default manufacturer of certain CPU types in canonical form. It is in
 	# some cases the only manufacturer, in others, it is the most popular.
 	craynv-unknown)
 		vendor=cray
-		os=${os:-unicosmp}
+		basic_os=${basic_os:-unicosmp}
 		;;
 	c90-unknown | c90-cray)
 		vendor=cray
-		os=${os:-unicos}
+		basic_os=${Basic_os:-unicos}
 		;;
 	fx80-unknown)
 		vendor=alliant
@@ -999,10 +1020,15 @@
 		;;
 
 	# Here we normalize CPU types with a missing or matching vendor
+	armh-unknown | armh-alt)
+		cpu=armv7l
+		vendor=alt
+		basic_os=${basic_os:-linux-gnueabihf}
+		;;
 	dpx20-unknown | dpx20-bull)
 		cpu=rs6000
 		vendor=bull
-		os=${os:-bosx}
+		basic_os=${basic_os:-bosx}
 		;;
 
 	# Here we normalize CPU types irrespective of the vendor
@@ -1011,7 +1037,7 @@
 		;;
 	blackfin-*)
 		cpu=bfin
-		os=linux
+		basic_os=linux
 		;;
 	c54x-*)
 		cpu=tic54x
@@ -1024,7 +1050,7 @@
 		;;
 	e500v12-*)
 		cpu=powerpc
-		os=$os"spe"
+		basic_os=${basic_os}"spe"
 		;;
 	mips3*-*)
 		cpu=mips64
@@ -1034,7 +1060,7 @@
 		;;
 	m68knommu-*)
 		cpu=m68k
-		os=linux
+		basic_os=linux
 		;;
 	m9s12z-* | m68hcs12z-* | hcs12z-* | s12z-*)
 		cpu=s12z
@@ -1044,12 +1070,12 @@
 		;;
 	parisc-*)
 		cpu=hppa
-		os=linux
+		basic_os=linux
 		;;
 	pentium-* | p5-* | k5-* | k6-* | nexgen-* | viac3-*)
 		cpu=i586
 		;;
-	pentiumpro-* | p6-* | 6x86-* | athlon-* | athalon_*-*)
+	pentiumpro-* | p6-* | 6x86-* | athlon-* | athlon_*-*)
 		cpu=i686
 		;;
 	pentiumii-* | pentium2-* | pentiumiii-* | pentium3-*)
@@ -1100,11 +1126,14 @@
 	xscale-* | xscaleebl-*)
 		cpu=`echo "$cpu" | sed 's/^xscale/arm/'`
 		;;
+	arm64-* | aarch64le-*)
+		cpu=aarch64
+		;;
 
-	# Recognize the cannonical CPU Types that limit and/or modify the
+	# Recognize the canonical CPU Types that limit and/or modify the
 	# company names they are paired with.
 	cr16-*)
-		os=${os:-elf}
+		basic_os=${basic_os:-elf}
 		;;
 	crisv32-* | etraxfs*-*)
 		cpu=crisv32
@@ -1115,7 +1144,7 @@
 		vendor=axis
 		;;
 	crx-*)
-		os=${os:-elf}
+		basic_os=${basic_os:-elf}
 		;;
 	neo-tandem)
 		cpu=neo
@@ -1137,20 +1166,16 @@
 		cpu=nsx
 		vendor=tandem
 		;;
-	s390-*)
-		cpu=s390
-		vendor=ibm
-		;;
-	s390x-*)
-		cpu=s390x
-		vendor=ibm
+	mipsallegrexel-sony)
+		cpu=mipsallegrexel
+		vendor=sony
 		;;
 	tile*-*)
-		os=${os:-linux-gnu}
+		basic_os=${basic_os:-linux-gnu}
 		;;
 
 	*)
-		# Recognize the cannonical CPU types that are allowed with any
+		# Recognize the canonical CPU types that are allowed with any
 		# company name.
 		case $cpu in
 			1750a | 580 \
@@ -1161,13 +1186,14 @@
 			| alpha64 | alpha64ev4-8 | alpha64ev56 | alpha64ev678 \
 			| alphapca567 | alpha64pca567 \
 			| am33_2.0 \
-			| arc | arceb \
-			| arm  | armlbe | armelb | armv* \
+			| amdgcn \
+			| arc | arceb | arc32 | arc64 \
+			| arm | armlbe | armelb | armv* \
 			| avr | avr32 \
 			| asmjs \
 			| ba \
 			| be32 | be64 \
-			| bfin | bs2000 \
+			| bfin | bpf | bs2000 \
 			| c123* | c30 | cjt90 | c4x \
 			| c8051 | clipper | craynv | csky | cydra \
 			| d10v | d30v | dlx | dsp16xx \
@@ -1181,14 +1207,15 @@
 			| k1om \
 			| le32 | le64 \
 			| lm32 \
+			| loongarch32 | loongarch64 \
 			| m32c | m32r | m32rle \
-			| m5200 | m68000 | m6800123460 | m68360 | m683?2 | m68k | v70 | w65 \
-			| m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x | nvptx | picochip \
+			| m5200 | m68000 | m6800123460 | m68360 | m683?2 | m68k \
+			| m6811 | m68hc11 | m6812 | m68hc12 | m68hcs12x \
 			| m88110 | m88k | maxq | mb | mcore | mep | metag \
 			| microblaze | microblazeel \
 			| mips | mipsbe | mipseb | mipsel | mipsle \
 			| mips16 \
-			| mips64 | mips64el \
+			| mips64 | mips64eb | mips64el \
 			| mips64octeon | mips64octeonel \
 			| mips64orion | mips64orionel \
 			| mips64r5900 | mips64r5900el \
@@ -1199,9 +1226,13 @@
 			| mips64vr5900 | mips64vr5900el \
 			| mipsisa32 | mipsisa32el \
 			| mipsisa32r2 | mipsisa32r2el \
+			| mipsisa32r3 | mipsisa32r3el \
+			| mipsisa32r5 | mipsisa32r5el \
 			| mipsisa32r6 | mipsisa32r6el \
 			| mipsisa64 | mipsisa64el \
 			| mipsisa64r2 | mipsisa64r2el \
+			| mipsisa64r3 | mipsisa64r3el \
+			| mipsisa64r5 | mipsisa64r5el \
 			| mipsisa64r6 | mipsisa64r6el \
 			| mipsisa64sb1 | mipsisa64sb1el \
 			| mipsisa64sr71k | mipsisa64sr71kel \
@@ -1215,32 +1246,37 @@
 			| nds32 | nds32le | nds32be \
 			| nfp \
 			| nios | nios2 | nios2eb | nios2el \
-			| none | np1 | ns16k | ns32k \
+			| none | np1 | ns16k | ns32k | nvptx \
 			| open8 \
 			| or1k* \
 			| or32 \
 			| orion \
+			| picochip \
 			| pdp10 | pdp11 | pj | pjl | pn | power \
 			| powerpc | powerpc64 | powerpc64le | powerpcle | powerpcspe \
 			| pru \
 			| pyramid \
-			| riscv | riscv32 | riscv64 \
+			| riscv | riscv32 | riscv32be | riscv64 | riscv64be \
 			| rl78 | romp | rs6000 | rx \
+			| s390 | s390x \
 			| score \
-			| sh | sh1234 | sh24a | sh24aelb | sh23e | shelb | shlbe \
+			| sh | shl \
+			| sh1234 | sh24a | sh24aelb | sh23e | shelb | shlbe \
 			| sh1234elb |  sh12345lbe | sh23ele | sh64 | sh64le \
 			| sparc | sparc64 | sparc64b | sparc64v | sparc86x | sparclet \
 			| sparclite \
 			| sparcv8 | sparcv9 | sparcv9b | sparcv9v | sv1 | sx* \
 			| spu \
 			| tahoe \
+			| thumbv7* \
 			| tic30 | tic4x | tic54x | tic55x | tic6x | tic80 \
 			| tron \
 			| ubicom32 \
-			| v850 | v850e | v850e1 | v850es | v850e2 | v850e2v3 \
+			| v70 | v850 | v850e | v850e1 | v850es | v850e2 | v850e2v3 \
 			| vax \
 			| visium \
-			| wasm32 \
+			| w65 \
+			| wasm32 | wasm64 \
 			| we32k \
 			| x86 | x86_64 | xc16x | xgate | xps100 \
 			| xstormy16 | xtensa* \
@@ -1270,8 +1306,53 @@
 
 # Decode manufacturer-specific aliases for certain operating systems.
 
-if  x$os != x 
+if test x$basic_os != x
 then
+
+# First recognize some ad-hoc cases, or perhaps split kernel-os, or else just
+# set os.
+case $basic_os in
+	gnu/linux*)
+		kernel=linux
+		os=`echo "$basic_os" | sed -e 's|gnu/linux|gnu|'`
+		;;
+	os2-emx)
+		kernel=os2
+		os=`echo "$basic_os" | sed -e 's|os2-emx|emx|'`
+		;;
+	nto-qnx*)
+		kernel=nto
+		os=`echo "$basic_os" | sed -e 's|nto-qnx|qnx|'`
+		;;
+	*-*)
+		# shellcheck disable=SC2162
+		saved_IFS=$IFS
+		IFS="-" read kernel os <<EOF
+$basic_os
+EOF
+		IFS=$saved_IFS
+		;;
+	# Default OS when just kernel was specified
+	nto*)
+		kernel=nto
+		os=`echo "$basic_os" | sed -e 's|nto|qnx|'`
+		;;
+	linux*)
+		kernel=linux
+		os=`echo "$basic_os" | sed -e 's|linux|gnu|'`
+		;;
+	managarm*)
+		kernel=managarm
+		os=`echo "$basic_os" | sed -e 's|managarm|mlibc|'`
+		;;
+	*)
+		kernel=
+		os=$basic_os
+		;;
+esac
+
+# Now, normalize the OS (knowing we just have one component, it's not a kernel,
+# etc.)
 case $os in
 	# First match some system type aliases that might get confused
 	# with valid system types.
@@ -1283,7 +1364,7 @@
 		os=cnk
 		;;
 	solaris1 | solaris1.*)
-		os=`echo $os | sed -e 's|solaris1|sunos4|'`
+		os=`echo "$os" | sed -e 's|solaris1|sunos4|'`
 		;;
 	solaris)
 		os=solaris2
@@ -1291,9 +1372,6 @@
 	unixware*)
 		os=sysv4.2uw
 		;;
-	gnu/linux*)
-		os=`echo $os | sed -e 's|gnu/linux|linux-gnu|'`
-		;;
 	# es1800 is here to avoid being matched by es* (a different OS)
 	es1800*)
 		os=ose
@@ -1315,12 +1393,9 @@
 		os=sco3.2v4
 		;;
 	sco3.2.4-9*)
-		os=`echo $os | sed -e 's/sco3.2./sco3.2v/'`
+		os=`echo "$os" | sed -e 's/sco3.2./sco3.2v/'`
 		;;
-	sco3.2v4-9* | sco5v6*)
-		# Don't forget version if it is 3.2v4 or newer.
-		;;
-	scout)
+	sco*v* | scout)
 		# Don't match below
 		;;
 	sco*)
@@ -1329,77 +1404,25 @@
 	psos*)
 		os=psos
 		;;
-	# Now accept the basic system types.
-	# The portable systems comes first.
-	# Each alternative MUST end in a * to match a version number.
-	# sysv* is not here because it comes later, after sysvr4.
-	gnu* | bsd* | mach* | minix* | genix* | ultrix* | irix* \
-	     | *vms* | esix* | aix* | cnk* | sunos | sunos34*\
-	     | hpux* | unos* | osf* | luna* | dgux* | auroraux* | solaris* \
-	     | sym* | kopensolaris* | plan9* \
-	     | amigaos* | amigados* | msdos* | newsos* | unicos* | aof* \
-	     | aos* | aros* | cloudabi* | sortix* \
-	     | nindy* | vxsim* | vxworks* | ebmon* | hms* | mvs* \
-	     | clix* | riscos* | uniplus* | iris* | isc* | rtu* | xenix* \
-	     | knetbsd* | mirbsd* | netbsd* \
-	     | bitrig* | openbsd* | solidbsd* | libertybsd* \
-	     | ekkobsd* | kfreebsd* | freebsd* | riscix* | lynxos* \
-	     | bosx* | nextstep* | cxux* | aout* | elf* | oabi* \
-	     | ptx* | coff* | ecoff* | winnt* | domain* | vsta* \
-	     | udi* | eabi* | lites* | ieee* | go32* | aux* | hcos* \
-	     | chorusrdb* | cegcc* | glidix* \
-	     | cygwin* | msys* | pe* | moss* | proelf* | rtems* \
-	     | midipix* | mingw32* | mingw64* | linux-gnu* | linux-android* \
-	     | linux-newlib* | linux-musl* | linux-uclibc* \
-	     | uxpv* | beos* | mpeix* | udk* | moxiebox* \
-	     | interix* | uwin* | mks* | rhapsody* | darwin* \
-	     | openstep* | oskit* | conix* | pw32* | nonstopux* \
-	     | storm-chaos* | tops10* | tenex* | tops20* | its* \
-	     | os2* | vos* | palmos* | uclinux* | nucleus* \
-	     | morphos* | superux* | rtmk* | windiss* \
-	     | powermax* | dnix* | nx6 | nx7 | sei* | dragonfly* \
-	     | skyos* | haiku* | rdos* | toppers* | drops* | es* \
-	     | onefs* | tirtos* | phoenix* | fuchsia* | redox* | bme* \
-	     | midnightbsd*)
-	# Remember, each alternative MUST END IN *, to match a version number.
-		;;
 	qnx*)
-		case $cpu in
-		    x86 | i*86)
-			;;
-		    *)
-			os=nto-$os
-			;;
-		esac
+		os=qnx
 		;;
 	hiux*)
 		os=hiuxwe2
 		;;
-	nto-qnx*)
-		;;
-	nto*)
-		os=`echo $os | sed -e 's|nto|nto-qnx|'`
-		;;
-	sim | xray | os68k* | v88r* \
-	    | windows* | osx | abug | netware* | os9* \
-	    | macos* | mpw* | magic* | mmixware* | mon960* | lnews*)
-		;;
-	linux-dietlibc)
-		os=linux-dietlibc
-		;;
-	linux*)
-		os=`echo $os | sed -e 's|linux|linux-gnu|'`
-		;;
 	lynx*178)
 		os=lynxos178
 		;;
 	lynx*5)
 		os=lynxos5
 		;;
+	lynxos*)
+		# don't get caught up in next wildcard
+		;;
 	lynx*)
 		os=lynxos
 		;;
-	mac*)
+	mac0-9*)
 		os=`echo "$os" | sed -e 's|mac|macos|'`
 		;;
 	opened*)
@@ -1444,12 +1467,9 @@
 	ns2)
 		os=nextstep2
 		;;
-	nsk*)
-		os=nsk
-		;;
 	# Preserve the version number of sinix5.
 	sinix5.*)
-		os=`echo $os | sed -e 's|sinix|sysv|'`
+		os=`echo "$os" | sed -e 's|sinix|sysv|'`
 		;;
 	sinix*)
 		os=sysv4
@@ -1472,18 +1492,12 @@
 	sysvr4)
 		os=sysv4
 		;;
-	# This must come after sysvr4.
-	sysv*)
-		;;
 	ose*)
 		os=ose
 		;;
 	*mint | mint0-9* | *MiNT | MiNT0-9*)
 		os=mint
 		;;
-	zvmoe)
-		os=zvmoe
-		;;
 	dicos*)
 		os=dicos
 		;;
@@ -1500,19 +1514,11 @@
 			;;
 		esac
 		;;
-	nacl*)
-		;;
-	ios)
-		;;
-	none)
-		;;
-	*-eabi)
-		;;
 	*)
-		echo Invalid configuration \`"$1"\': system \`"$os"\' not recognized 1>&2
-		exit 1
+		# No normalization, but not necessarily accepted, that comes below.
 		;;
 esac
+
 else
 
 # Here we handle the default operating systems that come with various machines.
@@ -1525,6 +1531,7 @@
 # will signal an error saying that MANUFACTURER isn't an operating
 # system, and we'll never get to this point.
 
+kernel=
 case $cpu-$vendor in
 	score-*)
 		os=elf
@@ -1536,7 +1543,8 @@
 		os=riscix1.2
 		;;
 	arm*-rebel)
-		os=linux
+		kernel=linux
+		os=gnu
 		;;
 	arm*-semi)
 		os=aout
@@ -1702,84 +1710,193 @@
 		os=none
 		;;
 esac
+
 fi
 
+# Now, validate our (potentially fixed-up) OS.
+case $os in
+	# Sometimes we do "kernel-libc", so those need to count as OSes.
+	musl* | newlib* | relibc* | uclibc*)
+		;;
+	# Likewise for "kernel-abi"
+	eabi* | gnueabi*)
+		;;
+	# VxWorks passes extra cpu info in the 4th filed.
+	simlinux | simwindows | spe)
+		;;
+	# Now accept the basic system types.
+	# The portable systems comes first.
+	# Each alternative MUST end in a * to match a version number.
+	gnu* | android* | bsd* | mach* | minix* | genix* | ultrix* | irix* \
+	     | *vms* | esix* | aix* | cnk* | sunos | sunos34* \
+	     | hpux* | unos* | osf* | luna* | dgux* | auroraux* | solaris* \
+	     | sym* |  plan9* | psp* | sim* | xray* | os68k* | v88r* \
+	     | hiux* | abug | nacl* | netware* | windows* \
+	     | os9* | macos* | osx* | ios* \
+	     | mpw* | magic* | mmixware* | mon960* | lnews* \
+	     | amigaos* | amigados* | msdos* | newsos* | unicos* | aof* \
+	     | aos* | aros* | cloudabi* | sortix* | twizzler* \
+	     | nindy* | vxsim* | vxworks* | ebmon* | hms* | mvs* \
+	     | clix* | riscos* | uniplus* | iris* | isc* | rtu* | xenix* \
+	     | mirbsd* | netbsd* | dicos* | openedition* | ose* \
+	     | bitrig* | openbsd* | secbsd* | solidbsd* | libertybsd* | os108* \
+	     | ekkobsd* | freebsd* | riscix* | lynxos* | os400* \
+	     | bosx* | nextstep* | cxux* | aout* | elf* | oabi* \
+	     | ptx* | coff* | ecoff* | winnt* | domain* | vsta* \
+	     | udi* | lites* | ieee* | go32* | aux* | hcos* \
+	     | chorusrdb* | cegcc* | glidix* | serenity* \
+	     | cygwin* | msys* | pe* | moss* | proelf* | rtems* \
+	     | midipix* | mingw32* | mingw64* | mint* \
+	     | uxpv* | beos* | mpeix* | udk* | moxiebox* \
+	     | interix* | uwin* | mks* | rhapsody* | darwin* \
+	     | openstep* | oskit* | conix* | pw32* | nonstopux* \
+	     | storm-chaos* | tops10* | tenex* | tops20* | its* \
+	     | os2* | vos* | palmos* | uclinux* | nucleus* | morphos* \
+	     | scout* | superux* | sysv* | rtmk* | tpf* | windiss* \
+	     | powermax* | dnix* | nx6 | nx7 | sei* | dragonfly* \
+	     | skyos* | haiku* | rdos* | toppers* | drops* | es* \
+	     | onefs* | tirtos* | phoenix* | fuchsia* | redox* | bme* \
+	     | midnightbsd* | amdhsa* | unleashed* | emscripten* | wasi* \
+	     | nsk* | powerunix* | genode* | zvmoe* | qnx* | emx* | zephyr* \
+	     | fiwix* | mlibc* )
+		;;
+	# This one is extra strict with allowed versions
+	sco3.2v2 | sco3.2v4-9* | sco5v6*)
+		# Don't forget version if it is 3.2v4 or newer.
+		;;
+	none)
+		;;
+	kernel* )
+		# Restricted further below
+		;;
+	*)
+		echo Invalid configuration \`"$1"\': OS \`"$os"\' not recognized 1>&2
+		exit 1
+		;;
+esac
+
+# As a final step for OS-related things, validate the OS-kernel combination
+# (given a valid OS), if there is a kernel.
+case $kernel-$os in
+	linux-gnu* | linux-dietlibc* | linux-android* | linux-newlib* \
+		   | linux-musl* | linux-relibc* | linux-uclibc* | linux-mlibc* )
+		;;
+	uclinux-uclibc* )
+		;;
+	managarm-mlibc* | managarm-kernel* )
+		;;
+	-dietlibc* | -newlib* | -musl* | -relibc* | -uclibc* | -mlibc* )
+		# These are just libc implementations, not actual OSes, and thus
+		# require a kernel.
+		echo "Invalid configuration \`$1': libc \`$os' needs explicit kernel." 1>&2
+		exit 1
+		;;
+	-kernel* )
+		echo "Invalid configuration \`$1': \`$os' needs explicit kernel." 1>&2
+		exit 1
+		;;
+	*-kernel* )
+		echo "Invalid configuration \`$1': \`$kernel' does not support \`$os'." 1>&2
+		exit 1
+		;;
+	kfreebsd*-gnu* | kopensolaris*-gnu*)
+		;;
+	vxworks-simlinux | vxworks-simwindows | vxworks-spe)
+		;;
+	nto-qnx*)
+		;;
+	os2-emx)
+		;;
+	*-eabi* | *-gnueabi*)
+		;;
+	-*)
+		# Blank kernel with real OS is always fine.
+		;;
+	*-*)
+		echo "Invalid configuration \`$1': Kernel \`$kernel' not known to work with OS \`$os'." 1>&2
+		exit 1
+		;;
+esac
+
 # Here we handle the case where we know the os, and the CPU type, but not the
 # manufacturer.  We pick the logical manufacturer.
 case $vendor in
 	unknown)
-		case $os in
-			riscix*)
+		case $cpu-$os in
+			*-riscix*)
 				vendor=acorn
 				;;
-			sunos*)
+			*-sunos*)
 				vendor=sun
 				;;
-			cnk*|-aix*)
+			*-cnk* | *-aix*)
 				vendor=ibm
 				;;
-			beos*)
+			*-beos*)
 				vendor=be
 				;;
-			hpux*)
+			*-hpux*)
 				vendor=hp
 				;;
-			mpeix*)
+			*-mpeix*)
 				vendor=hp
 				;;
-			hiux*)
+			*-hiux*)
 				vendor=hitachi
 				;;
-			unos*)
+			*-unos*)
 				vendor=crds
 				;;
-			dgux*)
+			*-dgux*)
 				vendor=dg
 				;;
-			luna*)
+			*-luna*)
 				vendor=omron
 				;;
-			genix*)
+			*-genix*)
 				vendor=ns
 				;;
-			clix*)
+			*-clix*)
 				vendor=intergraph
 				;;
-			mvs* | opened*)
+			*-mvs* | *-opened*)
+				vendor=ibm
+				;;
+			*-os400*)
 				vendor=ibm
 				;;
-			os400*)
+			s390-* | s390x-*)
 				vendor=ibm
 				;;
-			ptx*)
+			*-ptx*)
 				vendor=sequent
 				;;
-			tpf*)
+			*-tpf*)
 				vendor=ibm
 				;;
-			vxsim* | vxworks* | windiss*)
+			*-vxsim* | *-vxworks* | *-windiss*)
 				vendor=wrs
 				;;
-			aux*)
+			*-aux*)
 				vendor=apple
 				;;
-			hms*)
+			*-hms*)
 				vendor=hitachi
 				;;
-			mpw* | macos*)
+			*-mpw* | *-macos*)
 				vendor=apple
 				;;
-			*mint | mint0-9* | *MiNT | MiNT0-9*)
+			*-*mint | *-mint0-9* | *-*MiNT | *-MiNT0-9*)
 				vendor=atari
 				;;
-			vos*)
+			*-vos*)
 				vendor=stratus
 				;;
 		esac
 		;;
 esac
 
-echo "$cpu-$vendor-$os"
+echo "$cpu-$vendor-${kernel:+$kernel-}$os"
 exit
 
 # Local variables:

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/depcomp -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/depcomp Changed

@@ -1,9 +1,9 @@
 #! /bin/sh
 # depcomp - compile a program generating dependencies as side-effects
 
-scriptversion=2018-03-07.03; # UTC
+scriptversion=2022-09-18.14; # UTC
 
-# Copyright (C) 1999-2018 Free Software Foundation, Inc.
+# Copyright (C) 1999-2023 Free Software Foundation, Inc.
 
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -113,7 +113,6 @@
 # These definitions help.
 upper=ABCDEFGHIJKLMNOPQRSTUVWXYZ
 lower=abcdefghijklmnopqrstuvwxyz
-digits=0123456789
 alpha=${upper}${lower}
 
 if test -z "$depmode" || test -z "$source" || test -z "$object"; then
@@ -198,7 +197,7 @@
   ;;
 
 gcc)
-## Note that this doesn't just cater to obsosete pre-3.x GCC compilers.
+## Note that this doesn't just cater to obsolete pre-3.x GCC compilers.
 ## but also to in-use compilers like IMB xlc/xlC and the HP C compiler.
 ## (see the conditional assignment to $gccflag above).
 ## There are various ways to get dependency output from gcc.  Here's

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/git-version-gen -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/git-version-gen Changed

@@ -1,12 +1,12 @@
 #!/bin/sh
 # Print a version string.
-scriptversion=2018-03-07.03; # UTC
+scriptversion=2022-07-09.08; # UTC
 
-# Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# Copyright (C) 2007-2023 Free Software Foundation, Inc.
 #
 # This program 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 3 of the License, or
 # (at your option) any later version.
 #
 # This program is distributed in the hope that it will be useful,
@@ -65,19 +65,21 @@
 # EXTRA_DIST = $(top_srcdir)/.version
 # BUILT_SOURCES = $(top_srcdir)/.version
 # $(top_srcdir)/.version:
-#	echo $(VERSION) > $@-t && mv $@-t $@
+#	echo '$(VERSION)' > $@-t
+#	mv $@-t $@
 # dist-hook:
-#	echo $(VERSION) > $(distdir)/.tarball-version
+#	echo '$(VERSION)' > $(distdir)/.tarball-version
 
 
 me=$0
 
+year=`expr "$scriptversion" : '$^-*$'`
 version="git-version-gen $scriptversion
 
-Copyright 2011 Free Software Foundation, Inc.
-There is NO warranty.  You may redistribute this software
-under the terms of the GNU General Public License.
-For more information about these matters, see the files named COPYING."
+Copyright (C) ${year} Free Software Foundation, Inc.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law."
 
 usage="\
 Usage: $me OPTION... \$srcdir/.tarball-version TAG-NORMALIZATION-SED-SCRIPT
@@ -92,7 +94,7 @@
    --help             display this help and exit
    --version          output version information and exit
 
-Running without arguments will suffice in most cases."
+Send patches and bug reports to <bug-gnulib@gnu.org>."
 
 prefix=v
 fallback=
@@ -141,11 +143,9 @@
     v=`cat $tarball_version_file` || v=
     case $v in
         *$nl*) v= ;; # reject multi-line output
-        0-9*) ;;
-        *) v= ;;
     esac
     test "x$v" = x \
-        && echo "$0: WARNING: $tarball_version_file is missing or damaged" 1>&2
+        && echo "$0: WARNING: $tarball_version_file is damaged" 1>&2
 fi
 
 if test "x$v" != x

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/install-sh -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/install-sh Changed

@@ -1,7 +1,7 @@
 #!/bin/sh
 # install - install a program, script, or datafile
 
-scriptversion=2018-03-11.20; # UTC
+scriptversion=2020-11-14.01; # UTC
 
 # This originates from X11R5 (mit/util/scripts/install.sh), which was
 # later released in X11R6 (xc/config/util/install.sh) with the
@@ -69,6 +69,11 @@
 # Desired mode of installed file.
 mode=0755
 
+# Create dirs (including intermediate dirs) using mode 755.
+# This is like GNU 'install' as of coreutils 8.32 (2020).
+mkdir_umask=22
+
+backupsuffix=
 chgrpcmd=
 chmodcmd=$chmodprog
 chowncmd=
@@ -99,18 +104,28 @@
      --version  display version info and exit.
 
   -c            (ignored)
-  -C            install only if different (preserve the last data modification time)
+  -C            install only if different (preserve data modification time)
   -d            create directories instead of installing files.
   -g GROUP      $chgrpprog installed files to GROUP.
   -m MODE       $chmodprog installed files to MODE.
   -o USER       $chownprog installed files to USER.
+  -p            pass -p to $cpprog.
   -s            $stripprog installed files.
+  -S SUFFIX     attempt to back up existing files, with suffix SUFFIX.
   -t DIRECTORY  install into DIRECTORY.
   -T            report an error if DSTFILE is a directory.
 
 Environment variables override the default commands:
   CHGRPPROG CHMODPROG CHOWNPROG CMPPROG CPPROG MKDIRPROG MVPROG
   RMPROG STRIPPROG
+
+By default, rm is invoked with -f; when overridden with RMPROG,
+it's up to you to specify -f if you want it.
+
+If -S is not specified, no backups are attempted.
+
+Email bug reports to bug-automake@gnu.org.
+Automake home page: https://www.gnu.org/software/automake/
 "
 
 while test $# -ne 0; do
@@ -137,8 +152,13 @@
     -o) chowncmd="$chownprog $2"
         shift;;
 
+    -p) cpprog="$cpprog -p";;
+
     -s) stripcmd=$stripprog;;
 
+    -S) backupsuffix="$2"
+        shift;;
+
     -t)
         is_target_a_directory=always
         dst_arg=$2
@@ -255,6 +275,10 @@
     dstdir=$dst
     test -d "$dstdir"
     dstdir_status=$?
+    # Don't chown directories that already exist.
+    if test $dstdir_status = 0; then
+      chowncmd=""
+    fi
   else
 
     # Waiting for this to be detected by the "$cpprog $src $dsttmp" command
@@ -301,22 +325,6 @@
   if test $dstdir_status != 0; then
     case $posix_mkdir in
       '')
-        # Create intermediate dirs using mode 755 as modified by the umask.
-        # This is like FreeBSD 'install' as of 1997-10-28.
-        umask=`umask`
-        case $stripcmd.$umask in
-          # Optimize common cases.
-          *23672367) mkdir_umask=$umask;;
-          .*00202 | .0202 | .02) mkdir_umask=22;;
-
-          *0-7)
-            mkdir_umask=`expr $umask + 22 \
-              - $umask % 100 % 40 + $umask % 20 \
-              - $umask % 10 % 4 + $umask % 2
-            `;;
-          *) mkdir_umask=$umask,go-w;;
-        esac
-
         # With -d, create the new directory with the user-specified mode.
         # Otherwise, rely on $mkdir_umask.
         if test -n "$dir_arg"; then
@@ -326,52 +334,49 @@
         fi
 
         posix_mkdir=false
-        case $umask in
-          *1235670-70-7)
-            # POSIX mkdir -p sets u+wx bits regardless of umask, which
-            # is incompatible with FreeBSD 'install' when (umask & 300) != 0.
-            ;;
-          *)
-            # Note that $RANDOM variable is not portable (e.g. dash);  Use it
-            # here however when possible just to lower collision chance.
-            tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$
-
-            trap 'ret=$?; rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir" 2>/dev/null; exit $ret' 0
-
-            # Because "mkdir -p" follows existing symlinks and we likely work
-            # directly in world-writeable /tmp, make sure that the '$tmpdir'
-            # directory is successfully created first before we actually test
-            # 'mkdir -p' feature.
-            if (umask $mkdir_umask &&
-                $mkdirprog $mkdir_mode "$tmpdir" &&
-                exec $mkdirprog $mkdir_mode -p -- "$tmpdir/a/b") >/dev/null 2>&1
-            then
-              if test -z "$dir_arg" || {
-                   # Check for POSIX incompatibilities with -m.
-                   # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or
-                   # other-writable bit of parent directory when it shouldn't.
-                   # FreeBSD 6.1 mkdir -m -p sets mode of existing directory.
-                   test_tmpdir="$tmpdir/a"
-                   ls_ld_tmpdir=`ls -ld "$test_tmpdir"`
-                   case $ls_ld_tmpdir in
-                     d????-?r-*) different_mode=700;;
-                     d????-?--*) different_mode=755;;
-                     *) false;;
-                   esac &&
-                   $mkdirprog -m$different_mode -p -- "$test_tmpdir" && {
-                     ls_ld_tmpdir_1=`ls -ld "$test_tmpdir"`
-                     test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1"
-                   }
-                 }
-              then posix_mkdir=:
-              fi
-              rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir"
-            else
-              # Remove any dirs left behind by ancient mkdir implementations.
-              rmdir ./$mkdir_mode ./-p ./-- "$tmpdir" 2>/dev/null
-            fi
-            trap '' 0;;
-        esac;;
+	# The $RANDOM variable is not portable (e.g., dash).  Use it
+	# here however when possible just to lower collision chance.
+	tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$
+
+	trap '
+	  ret=$?
+	  rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir" 2>/dev/null
+	  exit $ret
+	' 0
+
+	# Because "mkdir -p" follows existing symlinks and we likely work
+	# directly in world-writeable /tmp, make sure that the '$tmpdir'
+	# directory is successfully created first before we actually test
+	# 'mkdir -p'.
+	if (umask $mkdir_umask &&
+	    $mkdirprog $mkdir_mode "$tmpdir" &&
+	    exec $mkdirprog $mkdir_mode -p -- "$tmpdir/a/b") >/dev/null 2>&1
+	then
+	  if test -z "$dir_arg" || {
+	       # Check for POSIX incompatibilities with -m.
+	       # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or
+	       # other-writable bit of parent directory when it shouldn't.
+	       # FreeBSD 6.1 mkdir -m -p sets mode of existing directory.
+	       test_tmpdir="$tmpdir/a"
+	       ls_ld_tmpdir=`ls -ld "$test_tmpdir"`
+	       case $ls_ld_tmpdir in
+		 d????-?r-*) different_mode=700;;
+		 d????-?--*) different_mode=755;;
+		 *) false;;
+	       esac &&
+	       $mkdirprog -m$different_mode -p -- "$test_tmpdir" && {
+		 ls_ld_tmpdir_1=`ls -ld "$test_tmpdir"`
+		 test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1"
+	       }
+	     }
+	  then posix_mkdir=:
+	  fi
+	  rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir"
+	else
+	  # Remove any dirs left behind by ancient mkdir implementations.
+	  rmdir ./$mkdir_mode ./-p ./-- "$tmpdir" 2>/dev/null
+	fi
+	trap '' 0;;
     esac
 
     if
@@ -382,7 +387,7 @@
     then :
     else
 
-      # The umask is ridiculous, or mkdir does not conform to POSIX,
+      # mkdir does not conform to POSIX,
       # or it failed possibly due to a race condition.  Create the
       # directory the slow way, step by step, checking for races as we go.
 
@@ -411,7 +416,7 @@
           prefixes=
         else
           if $posix_mkdir; then
-            (umask=$mkdir_umask &&
+            (umask $mkdir_umask &&
              $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break
             # Don't fail if two instances are running concurrently.
             test -d "$prefix" || exit 1
@@ -451,7 +456,18 @@
     trap 'ret=$?; rm -f "$dsttmp" "$rmtmp" && exit $ret' 0
 
     # Copy the file name to the temp name.
-    (umask $cp_umask && $doit_exec $cpprog "$src" "$dsttmp") &&
+    (umask $cp_umask &&
+     { test -z "$stripcmd" || {
+	 # Create $dsttmp read-write so that cp doesn't create it read-only,
+	 # which would cause strip to fail.
+	 if test -z "$doit"; then
+	   : >"$dsttmp" # No need to fork-exec 'touch'.
+	 else
+	   $doit touch "$dsttmp"
+	 fi
+       }
+     } &&
+     $doit_exec $cpprog "$src" "$dsttmp") &&
 
     # and set any options; do chmod last to preserve setuid bits.
     #
@@ -477,6 +493,13 @@
     then
       rm -f "$dsttmp"
     else
+      # If $backupsuffix is set, and the file being installed
+      # already exists, attempt a backup.  Don't worry if it fails,
+      # e.g., if mv doesn't support -f.
+      if test -n "$backupsuffix" && test -f "$dst"; then
+        $doit $mvcmd -f "$dst" "$dst$backupsuffix" 2>/dev/null
+      fi
+
       # Rename the file to the real destination.
       $doit $mvcmd -f "$dsttmp" "$dst" 2>/dev/null ||
 
@@ -491,9 +514,9 @@
         # file should still install successfully.
         {
           test ! -f "$dst" ||
-          $doit $rmcmd -f "$dst" 2>/dev/null ||
+          $doit $rmcmd "$dst" 2>/dev/null ||
           { $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null &&
-            { $doit $rmcmd -f "$rmtmp" 2>/dev/null; :; }
+            { $doit $rmcmd "$rmtmp" 2>/dev/null; :; }
           } ||
           { echo "$0: cannot unlink or rename $dst" >&2
             (exit 1); exit 1

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/missing -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/missing Changed

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/test-driver -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/test-driver Changed

@@ -3,7 +3,7 @@
 
 scriptversion=2018-03-07.03; # UTC
 
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
+# Copyright (C) 2011-2021 Free Software Foundation, Inc.
 #
 # This program is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
@@ -42,11 +42,13 @@
 {
   cat <<END
 Usage:
-  test-driver --test-name=NAME --log-file=PATH --trs-file=PATH
-              --expect-failure={yes|no} --color-tests={yes|no}
-              --enable-hard-errors={yes|no} --
+  test-driver --test-name NAME --log-file PATH --trs-file PATH
+              --expect-failure {yes|no} --color-tests {yes|no}
+              --enable-hard-errors {yes|no} --
               TEST-SCRIPT TEST-SCRIPT-ARGUMENTS
+
 The '--test-name', '--log-file' and '--trs-file' options are mandatory.
+See the GNU Automake documentation for information.
 END
 }
 
@@ -103,8 +105,11 @@
 trap "st=141; $do_exit" 13
 trap "st=143; $do_exit" 15
 
-# Test script is run here.
-"$@" >$log_file 2>&1
+# Test script is run here. We create the file first, then append to it,
+# to ameliorate tests themselves also writing to the log file. Our tests
+# don't, but others can (automake bug#35762).
+: >"$log_file"
+"$@" >>"$log_file" 2>&1
 estatus=$?
 
 if test $enable_hard_errors = no && test $estatus -eq 99; then
@@ -126,7 +131,7 @@
 # know whether the test passed or failed simply by looking at the '.log'
 # file, without the need of also peaking into the corresponding '.trs'
 # file (automake bug#11814).
-echo "$res $test_name (exit status: $estatus)" >>$log_file
+echo "$res $test_name (exit status: $estatus)" >>"$log_file"
 
 # Report outcome to console.
 echo "${col}${res}${std}: $test_name"

_service:tar_scm:groff-1.22.4.tar.gz/build-aux/ylwrap -> _service:tar_scm:groff-1.23.0.tar.gz/build-aux/ylwrap Changed

_service:tar_scm:groff-1.22.4.tar.gz/configure -> _service:tar_scm:groff-1.23.0.tar.gz/configure Changed

@@ -1,11 +1,12 @@
 #! /bin/sh
 # Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.69 for GNU Troff 1.22.4.
+# Generated by GNU Autoconf 2.71 for GNU roff 1.23.0.
 #
 # Report bugs to <http://savannah.gnu.org/bugs/?group=groff>.
 #
 #
-# Copyright (C) 1992-1996, 1998-2012 Free Software Foundation, Inc.
+# Copyright (C) 1992-1996, 1998-2017, 2020-2021 Free Software Foundation,
+# Inc.
 #
 #
 # This configure script is free software; the Free Software Foundation
@@ -16,14 +17,16 @@
 
 # Be more Bourne compatible
 DUALCASE=1; export DUALCASE # for MKS sh
-if test -n "${ZSH_VERSION+set}" && (emulate sh) >/dev/null 2>&1; then :
+as_nop=:
+if test ${ZSH_VERSION+y} && (emulate sh) >/dev/null 2>&1
+then :
   emulate sh
   NULLCMD=:
   # Pre-4.2 versions of Zsh do word splitting on ${1+"$@"}, which
   # is contrary to our usage.  Disable this feature.
   alias -g '${1+"$@"}'='"$@"'
   setopt NO_GLOB_SUBST
-else
+else $as_nop
   case `(set -o) 2>/dev/null` in #(
   *posix*) :
     set -o posix ;; #(
@@ -33,46 +36,46 @@
 fi
 
 
+
+# Reset variables that may have inherited troublesome values from
+# the environment.
+
+# IFS needs to be set, to space, tab, and newline, in precisely that order.
+# (If _AS_PATH_WALK were called with IFS unset, it would have the
+# side effect of setting IFS to empty, thus disabling word splitting.)
+# Quoting is to prevent editors from complaining about space-tab.
 as_nl='
 '
 export as_nl
-# Printing a long string crashes Solaris 7 /usr/bin/printf.
-as_echo='\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\'
-as_echo=$as_echo$as_echo$as_echo$as_echo$as_echo
-as_echo=$as_echo$as_echo$as_echo$as_echo$as_echo$as_echo
-# Prefer a ksh shell builtin over an external printf program on Solaris,
-# but without wasting forks for bash or zsh.
-if test -z "$BASH_VERSION$ZSH_VERSION" \
-    && (test "X`print -r -- $as_echo`" = "X$as_echo") 2>/dev/null; then
-  as_echo='print -r --'
-  as_echo_n='print -rn --'
-elif (test "X`printf %s $as_echo`" = "X$as_echo") 2>/dev/null; then
-  as_echo='printf %s\n'
-  as_echo_n='printf %s'
-else
-  if test "X`(/usr/ucb/echo -n -n $as_echo) 2>/dev/null`" = "X-n $as_echo"; then
-    as_echo_body='eval /usr/ucb/echo -n "$1$as_nl"'
-    as_echo_n='/usr/ucb/echo -n'
-  else
-    as_echo_body='eval expr "X$1" : "X\$.*\$"'
-    as_echo_n_body='eval
-      arg=$1;
-      case $arg in #(
-      *"$as_nl"*)
-	expr "X$arg" : "X\$.*\$$as_nl";
-	arg=`expr "X$arg" : ".*$as_nl\$.*\$"`;;
-      esac;
-      expr "X$arg" : "X\$.*\$" | tr -d "$as_nl"
-    '
-    export as_echo_n_body
-    as_echo_n='sh -c $as_echo_n_body as_echo'
-  fi
-  export as_echo_body
-  as_echo='sh -c $as_echo_body as_echo'
-fi
+IFS=" ""	$as_nl"
+
+PS1='$ '
+PS2='> '
+PS4='+ '
+
+# Ensure predictable behavior from utilities with locale-dependent output.
+LC_ALL=C
+export LC_ALL
+LANGUAGE=C
+export LANGUAGE
+
+# We cannot yet rely on "unset" to work, but we need these variables
+# to be unset--not just set to an empty or harmless value--now, to
+# avoid bugs in old shells (e.g. pre-3.0 UWIN ksh).  This construct
+# also avoids known problems related to "unset" and subshell syntax
+# in other old shells (e.g. bash 2.01 and pdksh 5.2.14).
+for as_var in BASH_ENV ENV MAIL MAILPATH CDPATH
+do eval test \${$as_var+y} \
+  && ( (unset $as_var) || exit 1) >/dev/null 2>&1 && unset $as_var || :
+done
+
+# Ensure that fds 0, 1, and 2 are open.
+if (exec 3>&0) 2>/dev/null; then :; else exec 0</dev/null; fi
+if (exec 3>&1) 2>/dev/null; then :; else exec 1>/dev/null; fi
+if (exec 3>&2)            ; then :; else exec 2>/dev/null; fi
 
 # The user is always right.
-if test "${PATH_SEPARATOR+set}" != set; then
+if ${PATH_SEPARATOR+false} :; then
   PATH_SEPARATOR=:
   (PATH='/bin;/bin'; FPATH=$PATH; sh -c :) >/dev/null 2>&1 && {
     (PATH='/bin:/bin'; FPATH=$PATH; sh -c :) >/dev/null 2>&1 ||
@@ -81,13 +84,6 @@
 fi
 
 
-# IFS
-# We need space, tab and new line, in precisely that order.  Quoting is
-# there to prevent editors from complaining about space-tab.
-# (If _AS_PATH_WALK were called with IFS unset, it would disable word
-# splitting by setting IFS to empty value.)
-IFS=" ""	$as_nl"
-
 # Find who we are.  Look in the path if we contain no directory separator.
 as_myself=
 case $0 in #((
@@ -96,8 +92,12 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    test -r "$as_dir/$0" && as_myself=$as_dir/$0 && break
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    test -r "$as_dir$0" && as_myself=$as_dir$0 && break
   done
 IFS=$as_save_IFS
 
@@ -109,30 +109,10 @@
   as_myself=$0
 fi
 if test ! -f "$as_myself"; then
-  $as_echo "$as_myself: error: cannot find myself; rerun with an absolute file name" >&2
+  printf "%s\n" "$as_myself: error: cannot find myself; rerun with an absolute file name" >&2
   exit 1
 fi
 
-# Unset variables that we do not need and which cause bugs (e.g. in
-# pre-3.0 UWIN ksh).  But do not cause bugs in bash 2.01; the "|| exit 1"
-# suppresses any "Segmentation fault" message there.  '((' could
-# trigger a bug in pdksh 5.2.14.
-for as_var in BASH_ENV ENV MAIL MAILPATH
-do eval test x\${$as_var+set} = xset \
-  && ( (unset $as_var) || exit 1) >/dev/null 2>&1 && unset $as_var || :
-done
-PS1='$ '
-PS2='> '
-PS4='+ '
-
-# NLS nuisances.
-LC_ALL=C
-export LC_ALL
-LANGUAGE=C
-export LANGUAGE
-
-# CDPATH.
-(unset CDPATH) >/dev/null 2>&1 && unset CDPATH
 
 # Use a proper internal environment variable to ensure we don't fall
   # into an infinite loop, continuously re-executing ourselves.
@@ -154,20 +134,22 @@
 exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
 # Admittedly, this is quite paranoid, since all the known shells bail
 # out after a failed `exec'.
-$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
-as_fn_exit 255
+printf "%s\n" "$0: could not re-execute with $CONFIG_SHELL" >&2
+exit 255
   fi
   # We don't want this to propagate to other subprocesses.
           { _as_can_reexec=; unset _as_can_reexec;}
 if test "x$CONFIG_SHELL" = x; then
-  as_bourne_compatible="if test -n \"\${ZSH_VERSION+set}\" && (emulate sh) >/dev/null 2>&1; then :
+  as_bourne_compatible="as_nop=:
+if test \${ZSH_VERSION+y} && (emulate sh) >/dev/null 2>&1
+then :
   emulate sh
   NULLCMD=:
   # Pre-4.2 versions of Zsh do word splitting on \${1+\"\$@\"}, which
   # is contrary to our usage.  Disable this feature.
   alias -g '\${1+\"\$@\"}'='\"\$@\"'
   setopt NO_GLOB_SUBST
-else
+else \$as_nop
   case \`(set -o) 2>/dev/null\` in #(
   *posix*) :
     set -o posix ;; #(
@@ -187,42 +169,53 @@
 as_fn_failure && { exitcode=1; echo as_fn_failure succeeded.; }
 as_fn_ret_success || { exitcode=1; echo as_fn_ret_success failed.; }
 as_fn_ret_failure && { exitcode=1; echo as_fn_ret_failure succeeded.; }
-if ( set x; as_fn_ret_success y && test x = \"\$1\" ); then :
+if ( set x; as_fn_ret_success y && test x = \"\$1\" )
+then :
 
-else
+else \$as_nop
   exitcode=1; echo positional parameters were not saved.
 fi
 test x\$exitcode = x0 || exit 1
+blah=\$(echo \$(echo blah))
+test x\"\$blah\" = xblah || exit 1
 test -x / || exit 1"
   as_suggested="  as_lineno_1=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_1a=\$LINENO
   as_lineno_2=";as_suggested=$as_suggested$LINENO;as_suggested=$as_suggested" as_lineno_2a=\$LINENO
   eval 'test \"x\$as_lineno_1'\$as_run'\" != \"x\$as_lineno_2'\$as_run'\" &&
   test \"x\`expr \$as_lineno_1'\$as_run' + 1\`\" = \"x\$as_lineno_2'\$as_run'\"' || exit 1
 test \$(( 1 + 1 )) = 2 || exit 1"
-  if (eval "$as_required") 2>/dev/null; then :
+  if (eval "$as_required") 2>/dev/null
+then :
   as_have_required=yes
-else
+else $as_nop
   as_have_required=no
 fi
-  if test x$as_have_required = xyes && (eval "$as_suggested") 2>/dev/null; then :
+  if test x$as_have_required = xyes && (eval "$as_suggested") 2>/dev/null
+then :
 
-else
+else $as_nop
   as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 as_found=false
 for as_dir in /bin$PATH_SEPARATOR/usr/bin$PATH_SEPARATOR$PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
   as_found=:
   case $as_dir in #(
 	 /*)
 	   for as_base in sh bash ksh sh5; do
 	     # Try only shells that exist, to save several forks.
-	     as_shell=$as_dir/$as_base
+	     as_shell=$as_dir$as_base
 	     if { test -f "$as_shell" || test -f "$as_shell.exe"; } &&
-		    { $as_echo "$as_bourne_compatible""$as_required" | as_run=a "$as_shell"; } 2>/dev/null; then :
+		    as_run=a "$as_shell" -c "$as_bourne_compatible""$as_required" 2>/dev/null
+then :
   CONFIG_SHELL=$as_shell as_have_required=yes
-		   if { $as_echo "$as_bourne_compatible""$as_suggested" | as_run=a "$as_shell"; } 2>/dev/null; then :
+		   if as_run=a "$as_shell" -c "$as_bourne_compatible""$as_suggested" 2>/dev/null
+then :
   break 2
 fi
 fi
@@ -230,14 +223,21 @@
        esac
   as_found=false
 done
-$as_found || { if { test -f "$SHELL" || test -f "$SHELL.exe"; } &&
-	      { $as_echo "$as_bourne_compatible""$as_required" | as_run=a "$SHELL"; } 2>/dev/null; then :
-  CONFIG_SHELL=$SHELL as_have_required=yes
-fi; }
 IFS=$as_save_IFS
+if $as_found
+then :
+
+else $as_nop
+  if { test -f "$SHELL" || test -f "$SHELL.exe"; } &&
+	      as_run=a "$SHELL" -c "$as_bourne_compatible""$as_required" 2>/dev/null
+then :
+  CONFIG_SHELL=$SHELL as_have_required=yes
+fi
+fi
 
 
-      if test "x$CONFIG_SHELL" != x; then :
+      if test "x$CONFIG_SHELL" != x
+then :
   export CONFIG_SHELL
              # We cannot yet assume a decent shell, so we have to provide a
 # neutralization value for shells without unset; and this also
@@ -255,18 +255,19 @@
 exec $CONFIG_SHELL $as_opts "$as_myself" ${1+"$@"}
 # Admittedly, this is quite paranoid, since all the known shells bail
 # out after a failed `exec'.
-$as_echo "$0: could not re-execute with $CONFIG_SHELL" >&2
+printf "%s\n" "$0: could not re-execute with $CONFIG_SHELL" >&2
 exit 255
 fi
 
-    if test x$as_have_required = xno; then :
-  $as_echo "$0: This script requires a shell more modern than all"
-  $as_echo "$0: the shells that I found on your system."
-  if test x${ZSH_VERSION+set} = xset ; then
-    $as_echo "$0: In particular, zsh $ZSH_VERSION has bugs and should"
-    $as_echo "$0: be upgraded to zsh 4.3.4 or later."
+    if test x$as_have_required = xno
+then :
+  printf "%s\n" "$0: This script requires a shell more modern than all"
+  printf "%s\n" "$0: the shells that I found on your system."
+  if test ${ZSH_VERSION+y} ; then
+    printf "%s\n" "$0: In particular, zsh $ZSH_VERSION has bugs and should"
+    printf "%s\n" "$0: be upgraded to zsh 4.3.4 or later."
   else
-    $as_echo "$0: Please tell bug-autoconf@gnu.org and
+    printf "%s\n" "$0: Please tell bug-autoconf@gnu.org and
 $0: http://savannah.gnu.org/bugs/?group=groff about your
 $0: system, including any error possibly output before this
 $0: message. Then install a modern shell, or manually run
@@ -294,6 +295,7 @@
 }
 as_unset=as_fn_unset
 
+
 # as_fn_set_status STATUS
 # -----------------------
 # Set $? to STATUS, without forking.
@@ -311,6 +313,14 @@
   as_fn_set_status $1
   exit $1
 } # as_fn_exit
+# as_fn_nop
+# ---------
+# Do nothing but, unlike ":", preserve the value of $?.
+as_fn_nop ()
+{
+  return $?
+}
+as_nop=as_fn_nop
 
 # as_fn_mkdir_p
 # -------------
@@ -325,7 +335,7 @@
     as_dirs=
     while :; do
       case $as_dir in #(
-      *\'*) as_qdir=`$as_echo "$as_dir" | sed "s/'/'\\\\\\\\''/g"`;; #'(
+      *\'*) as_qdir=`printf "%s\n" "$as_dir" | sed "s/'/'\\\\\\\\''/g"`;; #'(
       *) as_qdir=$as_dir;;
       esac
       as_dirs="'$as_qdir' $as_dirs"
@@ -334,7 +344,7 @@
 	 X"$as_dir" : 'X$//$^/' \| \
 	 X"$as_dir" : 'X$//$$' \| \
 	 X"$as_dir" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$as_dir" |
+printf "%s\n" X"$as_dir" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -373,12 +383,13 @@
 # advantage of any shell optimizations that allow amortized linear growth over
 # repeated appends, instead of the typical quadratic growth present in naive
 # implementations.
-if (eval "as_var=1; as_var+=2; test x\$as_var = x12") 2>/dev/null; then :
+if (eval "as_var=1; as_var+=2; test x\$as_var = x12") 2>/dev/null
+then :
   eval 'as_fn_append ()
   {
     eval $1+=\$2
   }'
-else
+else $as_nop
   as_fn_append ()
   {
     eval $1=\$$1\$2
@@ -390,18 +401,27 @@
 # Perform arithmetic evaluation on the ARGs, and store the result in the
 # global $as_val. Take advantage of shells that can avoid forks. The arguments
 # must be portable across $(()) and expr.
-if (eval "test \$(( 1 + 1 )) = 2") 2>/dev/null; then :
+if (eval "test \$(( 1 + 1 )) = 2") 2>/dev/null
+then :
   eval 'as_fn_arith ()
   {
     as_val=$(( $* ))
   }'
-else
+else $as_nop
   as_fn_arith ()
   {
     as_val=`expr "$@" || test $? -eq 1`
   }
 fi # as_fn_arith
 
+# as_fn_nop
+# ---------
+# Do nothing but, unlike ":", preserve the value of $?.
+as_fn_nop ()
+{
+  return $?
+}
+as_nop=as_fn_nop
 
 # as_fn_error STATUS ERROR LINENO LOG_FD
 # ----------------------------------------
@@ -413,9 +433,9 @@
   as_status=$1; test $as_status -eq 0 && as_status=1
   if test "$4"; then
     as_lineno=${as_lineno-"$3"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-    $as_echo "$as_me:${as_lineno-$LINENO}: error: $2" >&$4
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: $2" >&$4
   fi
-  $as_echo "$as_me: error: $2" >&2
+  printf "%s\n" "$as_me: error: $2" >&2
   as_fn_exit $as_status
 } # as_fn_error
 
@@ -442,7 +462,7 @@
 $as_expr X/"$0" : '.*/$^/^/*$/*$' \| \
 	 X"$0" : 'X$//$$' \| \
 	 X"$0" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X/"$0" |
+printf "%s\n" X/"$0" |
     sed '/^.*\/$^/^/*$\/*$/{
 	    s//\1/
 	    q
@@ -486,7 +506,7 @@
       s/-\n.*//
     ' >$as_me.lineno &&
   chmod +x "$as_me.lineno" ||
-    { $as_echo "$as_me: error: cannot create $as_me.lineno; rerun with a POSIX shell" >&2; as_fn_exit 1; }
+    { printf "%s\n" "$as_me: error: cannot create $as_me.lineno; rerun with a POSIX shell" >&2; as_fn_exit 1; }
 
   # If we had to re-execute with $CONFIG_SHELL, we're ensured to have
   # already done that, so ensure we don't try to do so again and fall
@@ -500,6 +520,10 @@
   exit
 }
 
+
+# Determine whether it's possible to make 'echo' print without a newline.
+# These variables are no longer used directly by Autoconf, but are AC_SUBSTed
+# for compatibility with existing Makefiles.
 ECHO_C= ECHO_N= ECHO_T=
 case `echo -n x` in #(((((
 -n*)
@@ -513,6 +537,13 @@
   ECHO_N='-n';;
 esac
 
+# For backward compatibility with old third-party macros, we provide
+# the shell variables $as_echo and $as_echo_n.  New code should use
+# AS_ECHO("message") and AS_ECHO_N("message"), respectively.
+as_echo='printf %s\n'
+as_echo_n='printf %s'
+
+
 rm -f conf$$ conf$$.exe conf$$.file
 if test -d conf$$.dir; then
   rm -f conf$$.dir/conf$$.file
@@ -578,113 +609,98 @@
 MAKEFLAGS=
 
 # Identity of this package.
-PACKAGE_NAME='GNU Troff'
+PACKAGE_NAME='GNU roff'
 PACKAGE_TARNAME='groff'
-PACKAGE_VERSION='1.22.4'
-PACKAGE_STRING='GNU Troff 1.22.4'
+PACKAGE_VERSION='1.23.0'
+PACKAGE_STRING='GNU roff 1.23.0'
 PACKAGE_BUGREPORT='http://savannah.gnu.org/bugs/?group=groff'
-PACKAGE_URL='http://www.gnu.org/software/groff/'
+PACKAGE_URL='https://www.gnu.org/software/groff/'
 
 ac_unique_file="src/roff/groff/groff.cpp"
 # Factoring default headers for most tests.
 ac_includes_default="\
-#include <stdio.h>
-#ifdef HAVE_SYS_TYPES_H
-# include <sys/types.h>
-#endif
-#ifdef HAVE_SYS_STAT_H
-# include <sys/stat.h>
+#include <stddef.h>
+#ifdef HAVE_STDIO_H
+# include <stdio.h>
 #endif
-#ifdef STDC_HEADERS
+#ifdef HAVE_STDLIB_H
 # include <stdlib.h>
-# include <stddef.h>
-#else
-# ifdef HAVE_STDLIB_H
-#  include <stdlib.h>
-# endif
 #endif
 #ifdef HAVE_STRING_H
-# if !defined STDC_HEADERS && defined HAVE_MEMORY_H
-#  include <memory.h>
-# endif
 # include <string.h>
 #endif
-#ifdef HAVE_STRINGS_H
-# include <strings.h>
-#endif
 #ifdef HAVE_INTTYPES_H
 # include <inttypes.h>
 #endif
 #ifdef HAVE_STDINT_H
 # include <stdint.h>
 #endif
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_STAT_H
+# include <sys/stat.h>
+#endif
 #ifdef HAVE_UNISTD_H
 # include <unistd.h>
 #endif"
 
-ac_func_list=
-ac_header_list=
-ac_config_libobj_dir=lib
-ac_subst_vars='gltests_LTLIBOBJS
+ac_header_c_list=
+ac_func_c_list=
+ac_subst_vars='gltests_LIBOBJDEPS
+gltests_LTLIBOBJS
 gltests_LIBOBJS
+gl_LIBOBJDEPS
 gl_LTLIBOBJS
 gl_LIBOBJS
 am__EXEEXT_FALSE
 am__EXEEXT_TRUE
 LTLIBOBJS
+USE_TEX_FALSE
+USE_TEX_TRUE
 HAVE_TEXI2DVI_FALSE
 HAVE_TEXI2DVI_TRUE
-HAVE_PDFTOOLS_FALSE
-HAVE_PDFTOOLS_TRUE
-INSTALL_SHIPPED_HTML_FALSE
-INSTALL_SHIPPED_HTML_TRUE
-BUILD_EXAMPLES_FALSE
-BUILD_EXAMPLES_TRUE
-BUILD_OTHERDOC_FALSE
-BUILD_OTHERDOC_TRUE
-BUILD_PDFEXAMPLES_FALSE
-BUILD_PDFEXAMPLES_TRUE
-BUILD_PDFDOC_FALSE
-BUILD_PDFDOC_TRUE
-BUILD_HTMLEXAMPLES_FALSE
-BUILD_HTMLEXAMPLES_TRUE
-BUILD_HTML_FALSE
-BUILD_HTML_TRUE
-BUILD_INFODOC_FALSE
-BUILD_INFODOC_TRUE
+HAVE_URW_FONTS_FALSE
+HAVE_URW_FONTS_TRUE
+HAVE_GHOSTSCRIPT_FALSE
+HAVE_GHOSTSCRIPT_TRUE
+USE_GROFF_ALLOCATOR_FALSE
+USE_GROFF_ALLOCATOR_TRUE
+USE_GROPDF_FALSE
+USE_GROPDF_TRUE
+USE_PDFROFF_FALSE
+USE_PDFROFF_TRUE
+USE_GROHTML_FALSE
+USE_GROHTML_TRUE
 USEPROGRAMPREFIX_FALSE
 USEPROGRAMPREFIX_TRUE
-MAKE_DONT_HAVE_RM_FALSE
-MAKE_DONT_HAVE_RM_TRUE
+MAKE_DEFINES_RM_FALSE
+MAKE_DEFINES_RM_TRUE
 WITHOUT_X11_FALSE
 WITHOUT_X11_TRUE
 BUILD_WINSCRIPTS_FALSE
 BUILD_WINSCRIPTS_TRUE
-groff_have_urw_fonts
 BASH_PROG
 HAVE_TEST_EF_OPTION
 DIFF_PROG
 GDIFF
 pnmtops_nosetpage
-make_uninstall_pdfexamples
-make_install_pdfexamples
-make_pdfexamples
-make_uninstall_pdfdoc
-make_install_pdfdoc
-make_pdfdoc
+pnmtools_quiet
+use_gropdf
+urwfontsdir
+groff_have_urw_fonts
+use_pdfroff
 ac_ct_AWK
 ALT_AWK_PROGS
-make_uninstall_htmlexamples
-make_install_htmlexamples
-make_htmlexamples
-make_uninstall_htmldoc
-make_install_htmldoc
 make_htmldoc
-pnmtops
 psselect
+pnmtops
 pnmtopng
-pnmcrop
 pnmcut
+pnmcrop
 ac_ct_GHOSTSCRIPT
 GHOSTSCRIPT
 ALT_GHOSTSCRIPT_PROGS
@@ -695,7 +711,6 @@
 g
 PAGE
 BROKEN_SPOOLER_FLAGS
-urwfontsdir
 LIBOBJS
 LIBEXT
 LTLIBICONV
@@ -704,9 +719,6 @@
 LIBM
 LIBC
 SH_SCRIPT_SED_CMD
-PDFIMAGES
-PDFFONTS
-PDFINFO
 UCHARDET_LIBS
 UCHARDET_CFLAGS
 PKG_CONFIG_LIBDIR
@@ -715,20 +727,9 @@
 XPMTOPPM
 LN_S
 INSTALL_INFO
+PROG_TEX
 PROG_TEXI2DVI
-makeinfo_version_numeric
-make_uninstall_infodoc
-make_install_infodoc
-make_infodoc
-make_uninstall_examples
-make_install_examples
-make_examples
-make_uninstall_otherdoc
-make_install_otherdoc
-make_otherdoc
-make_uninstall_shipped_htmldoc
-make_install_shipped_htmldoc
-doc_dist_target_ok
+M4
 YACC
 DVIPRINT
 PSPRINT
@@ -738,8 +739,7 @@
 PERL_VERSION
 SED
 PERL
-groffer_dir
-appresdir
+appdefdir
 XLIBDIRS
 XPROGDIRS
 XDEVDIRS
@@ -753,26 +753,78 @@
 TTYDEVDIRS
 LIBGNU_LTLIBDEPS
 LIBGNU_LIBDEPS
+GL_CFLAG_GNULIB_WARNINGS
+GL_CFLAG_ALLOW_WARNINGS
 gltests_WITNESS
+GL_COND_OBJ_WCWIDTH_FALSE
+GL_COND_OBJ_WCWIDTH_TRUE
+GL_GNULIB_TOWCTRANS
+GL_GNULIB_WCTRANS
+GL_GNULIB_ISWCTYPE
+GL_GNULIB_WCTYPE
+GL_GNULIB_ISWXDIGIT
+GL_GNULIB_ISWDIGIT
+GL_GNULIB_ISWBLANK
 REPLACE_TOWLOWER
 REPLACE_ISWCNTRL
 HAVE_WCTYPE_H
 NEXT_AS_FIRST_DIRECTIVE_WCTYPE_H
 NEXT_WCTYPE_H
 HAVE_ISWCNTRL
+REPLACE_ISWXDIGIT
+REPLACE_ISWDIGIT
 REPLACE_ISWBLANK
 HAVE_WCTRANS_T
 HAVE_WCTYPE_T
 HAVE_ISWBLANK
-GNULIB_TOWCTRANS
-GNULIB_WCTRANS
-GNULIB_ISWCTYPE
-GNULIB_WCTYPE
-GNULIB_ISWBLANK
+GL_GNULIB_MDA_WCSDUP
+GL_GNULIB_WCSFTIME
+GL_GNULIB_WCSWIDTH
+GL_GNULIB_WCSTOK
+GL_GNULIB_WCSSTR
+GL_GNULIB_WCSPBRK
+GL_GNULIB_WCSSPN
+GL_GNULIB_WCSCSPN
+GL_GNULIB_WCSRCHR
+GL_GNULIB_WCSCHR
+GL_GNULIB_WCSDUP
+GL_GNULIB_WCSXFRM
+GL_GNULIB_WCSCOLL
+GL_GNULIB_WCSNCASECMP
+GL_GNULIB_WCSCASECMP
+GL_GNULIB_WCSNCMP
+GL_GNULIB_WCSCMP
+GL_GNULIB_WCSNCAT
+GL_GNULIB_WCSCAT
+GL_GNULIB_WCPNCPY
+GL_GNULIB_WCSNCPY
+GL_GNULIB_WCPCPY
+GL_GNULIB_WCSCPY
+GL_GNULIB_WCSNLEN
+GL_GNULIB_WCSLEN
+GL_GNULIB_WMEMSET
+GL_GNULIB_WMEMPCPY
+GL_GNULIB_WMEMMOVE
+GL_GNULIB_WMEMCPY
+GL_GNULIB_WMEMCMP
+GL_GNULIB_WMEMCHR
+GL_GNULIB_WCWIDTH
+GL_GNULIB_WCSNRTOMBS
+GL_GNULIB_WCSRTOMBS
+GL_GNULIB_WCRTOMB
+GL_GNULIB_MBSNRTOWCS
+GL_GNULIB_MBSRTOWCS
+GL_GNULIB_MBRLEN
+GL_GNULIB_MBRTOWC
+GL_GNULIB_MBSINIT
+GL_GNULIB_WCTOB
+GL_GNULIB_BTOWC
 HAVE_CRTDEFS_H
 HAVE_WINT_T
 NEXT_AS_FIRST_DIRECTIVE_WCHAR_H
 NEXT_WCHAR_H
+REPLACE_WMEMPCPY
+REPLACE_WCSTOK
 REPLACE_WCSFTIME
 REPLACE_WCSWIDTH
 REPLACE_WCWIDTH
@@ -788,6 +840,7 @@
 REPLACE_BTOWC
 REPLACE_MBSTATE_T
 HAVE_DECL_WCWIDTH
+HAVE_DECL_WCSDUP
 HAVE_DECL_WCTOB
 HAVE_WCSFTIME
 HAVE_WCSWIDTH
@@ -814,6 +867,7 @@
 HAVE_WCSNLEN
 HAVE_WCSLEN
 HAVE_WMEMSET
+HAVE_WMEMPCPY
 HAVE_WMEMMOVE
 HAVE_WMEMCPY
 HAVE_WMEMCMP
@@ -827,95 +881,277 @@
 HAVE_MBRTOWC
 HAVE_MBSINIT
 HAVE_BTOWC
-GNULIB_WCSFTIME
-GNULIB_WCSWIDTH
-GNULIB_WCSTOK
-GNULIB_WCSSTR
-GNULIB_WCSPBRK
-GNULIB_WCSSPN
-GNULIB_WCSCSPN
-GNULIB_WCSRCHR
-GNULIB_WCSCHR
-GNULIB_WCSDUP
-GNULIB_WCSXFRM
-GNULIB_WCSCOLL
-GNULIB_WCSNCASECMP
-GNULIB_WCSCASECMP
-GNULIB_WCSNCMP
-GNULIB_WCSCMP
-GNULIB_WCSNCAT
-GNULIB_WCSCAT
-GNULIB_WCPNCPY
-GNULIB_WCSNCPY
-GNULIB_WCPCPY
-GNULIB_WCSCPY
-GNULIB_WCSNLEN
-GNULIB_WCSLEN
-GNULIB_WMEMSET
-GNULIB_WMEMMOVE
-GNULIB_WMEMCPY
-GNULIB_WMEMCMP
-GNULIB_WMEMCHR
-GNULIB_WCWIDTH
-GNULIB_WCSNRTOMBS
-GNULIB_WCSRTOMBS
-GNULIB_WCRTOMB
-GNULIB_MBSNRTOWCS
-GNULIB_MBSRTOWCS
-GNULIB_MBRLEN
-GNULIB_MBRTOWC
-GNULIB_MBSINIT
-GNULIB_WCTOB
-GNULIB_BTOWC
 LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_FALSE
 LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE
 LIBUNISTRING_UNIWIDTH_H
 LIBUNISTRING_UNITYPES_H
+GL_GNULIB_MDA_WRITE
+GL_GNULIB_MDA_UNLINK
+GL_GNULIB_MDA_SWAB
+GL_GNULIB_MDA_RMDIR
+GL_GNULIB_MDA_READ
+GL_GNULIB_MDA_LSEEK
+GL_GNULIB_MDA_ISATTY
+GL_GNULIB_MDA_GETPID
+GL_GNULIB_MDA_GETCWD
+GL_GNULIB_MDA_EXECVPE
+GL_GNULIB_MDA_EXECVP
+GL_GNULIB_MDA_EXECVE
+GL_GNULIB_MDA_EXECV
+GL_GNULIB_MDA_EXECLP
+GL_GNULIB_MDA_EXECLE
+GL_GNULIB_MDA_EXECL
+GL_GNULIB_MDA_DUP2
+GL_GNULIB_MDA_DUP
+GL_GNULIB_MDA_CLOSE
+GL_GNULIB_MDA_CHDIR
+GL_GNULIB_MDA_ACCESS
+GL_GNULIB_WRITE
+GL_GNULIB_USLEEP
+GL_GNULIB_UNLINKAT
+GL_GNULIB_UNLINK
+GL_GNULIB_UNISTD_H_SIGPIPE
+GL_GNULIB_UNISTD_H_NONBLOCKING
+GL_GNULIB_UNISTD_H_GETOPT
+GL_GNULIB_TTYNAME_R
+GL_GNULIB_TRUNCATE
+GL_GNULIB_SYMLINKAT
+GL_GNULIB_SYMLINK
+GL_GNULIB_SLEEP
+GL_GNULIB_SETHOSTNAME
+GL_GNULIB_RMDIR
+GL_GNULIB_READLINKAT
+GL_GNULIB_READLINK
+GL_GNULIB_READ
+GL_GNULIB_PWRITE
+GL_GNULIB_PREAD
+GL_GNULIB_PIPE2
+GL_GNULIB_PIPE
+GL_GNULIB_LSEEK
+GL_GNULIB_LINKAT
+GL_GNULIB_LINK
+GL_GNULIB_LCHOWN
+GL_GNULIB_ISATTY
+GL_GNULIB_GROUP_MEMBER
+GL_GNULIB_GETUSERSHELL
+GL_GNULIB_GETPASS_GNU
+GL_GNULIB_GETPASS
+GL_GNULIB_GETPAGESIZE
+GL_GNULIB_GETOPT_POSIX
+GL_GNULIB_GETLOGIN_R
+GL_GNULIB_GETLOGIN
+GL_GNULIB_GETHOSTNAME
+GL_GNULIB_GETGROUPS
+GL_GNULIB_GETENTROPY
+GL_GNULIB_GETDTABLESIZE
+GL_GNULIB_GETDOMAINNAME
+GL_GNULIB_GETCWD
+GL_GNULIB_FTRUNCATE
+GL_GNULIB_FSYNC
+GL_GNULIB_FDATASYNC
+GL_GNULIB_FCHOWNAT
+GL_GNULIB_FCHDIR
+GL_GNULIB_FACCESSAT
+GL_GNULIB_EXECVPE
+GL_GNULIB_EXECVP
+GL_GNULIB_EXECVE
+GL_GNULIB_EXECV
+GL_GNULIB_EXECLP
+GL_GNULIB_EXECLE
+GL_GNULIB_EXECL
+GL_GNULIB_EUIDACCESS
+GL_GNULIB_ENVIRON
+GL_GNULIB_DUP3
+GL_GNULIB_DUP2
+GL_GNULIB_DUP
+GL_GNULIB_COPY_FILE_RANGE
+GL_GNULIB_CLOSE
+GL_GNULIB_CHOWN
+GL_GNULIB_CHDIR
+GL_GNULIB_ACCESS
+HAVE_UNISTD_H
+NEXT_AS_FIRST_DIRECTIVE_UNISTD_H
+NEXT_UNISTD_H
+UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS
+UNISTD_H_HAVE_WINSOCK2_H
+UNISTD_H_HAVE_SYS_RANDOM_H
+REPLACE_WRITE
+REPLACE_USLEEP
+REPLACE_UNLINKAT
+REPLACE_UNLINK
+REPLACE_TTYNAME_R
+REPLACE_TRUNCATE
+REPLACE_SYMLINKAT
+REPLACE_SYMLINK
+REPLACE_SLEEP
+REPLACE_SETHOSTNAME
+REPLACE_RMDIR
+REPLACE_READLINKAT
+REPLACE_READLINK
+REPLACE_READ
+REPLACE_PWRITE
+REPLACE_PREAD
+REPLACE_PIPE2
+REPLACE_LSEEK
+REPLACE_LINKAT
+REPLACE_LINK
+REPLACE_LCHOWN
+REPLACE_ISATTY
+REPLACE_GETPASS_FOR_GETPASS_GNU
+REPLACE_GETPASS
+REPLACE_GETPAGESIZE
+REPLACE_GETGROUPS
+REPLACE_GETLOGIN_R
+REPLACE_GETENTROPY
+REPLACE_GETDTABLESIZE
+REPLACE_GETDOMAINNAME
+REPLACE_GETCWD
+REPLACE_FTRUNCATE
+REPLACE_FDATASYNC
+REPLACE_FCHOWNAT
+REPLACE_FACCESSAT
+REPLACE_EXECVPE
+REPLACE_EXECVP
+REPLACE_EXECVE
+REPLACE_EXECV
+REPLACE_EXECLP
+REPLACE_EXECLE
+REPLACE_EXECL
+REPLACE_DUP3
+REPLACE_DUP2
+REPLACE_DUP
+REPLACE_COPY_FILE_RANGE
+REPLACE_CLOSE
+REPLACE_CHOWN
+REPLACE_ACCESS
+HAVE_SYS_PARAM_H
+HAVE_OS_H
+HAVE_DECL_TTYNAME_R
+HAVE_DECL_TRUNCATE
+HAVE_DECL_SETHOSTNAME
+HAVE_DECL_GETUSERSHELL
+HAVE_DECL_GETPAGESIZE
+HAVE_DECL_GETLOGIN_R
+HAVE_DECL_GETLOGIN
+HAVE_DECL_GETDOMAINNAME
+HAVE_DECL_FDATASYNC
+HAVE_DECL_FCHDIR
+HAVE_DECL_EXECVPE
+HAVE_DECL_ENVIRON
+HAVE_USLEEP
+HAVE_UNLINKAT
+HAVE_SYMLINKAT
+HAVE_SYMLINK
+HAVE_SLEEP
+HAVE_SETHOSTNAME
+HAVE_READLINKAT
+HAVE_READLINK
+HAVE_PWRITE
+HAVE_PREAD
+HAVE_PIPE2
+HAVE_PIPE
+HAVE_LINKAT
+HAVE_LINK
+HAVE_LCHOWN
+HAVE_GROUP_MEMBER
+HAVE_GETPASS
+HAVE_GETPAGESIZE
+HAVE_GETLOGIN
+HAVE_GETHOSTNAME
+HAVE_GETGROUPS
+HAVE_GETENTROPY
+HAVE_GETDTABLESIZE
+HAVE_FTRUNCATE
+HAVE_FSYNC
+HAVE_FDATASYNC
+HAVE_FCHOWNAT
+HAVE_FCHDIR
+HAVE_FACCESSAT
+HAVE_EXECVPE
+HAVE_EUIDACCESS
+HAVE_DUP3
+HAVE_COPY_FILE_RANGE
+HAVE_CHOWN
 WINDOWS_STAT_INODES
 WINDOWS_64_BIT_OFF_T
 NEXT_AS_FIRST_DIRECTIVE_SYS_TYPES_H
 NEXT_SYS_TYPES_H
 NEXT_AS_FIRST_DIRECTIVE_STRING_H
 NEXT_STRING_H
+NEXT_AS_FIRST_DIRECTIVE_STDLIB_H
+NEXT_STDLIB_H
+GL_COND_OBJ_STDIO_WRITE_FALSE
+GL_COND_OBJ_STDIO_WRITE_TRUE
+GL_COND_OBJ_STDIO_READ_FALSE
+GL_COND_OBJ_STDIO_READ_TRUE
 NEXT_AS_FIRST_DIRECTIVE_STDIO_H
 NEXT_STDIO_H
 GL_GENERATE_STDINT_H_FALSE
 GL_GENERATE_STDINT_H_TRUE
 STDINT_H
-HAVE_SYS_INTTYPES_H
-HAVE_SYS_BITYPES_H
-HAVE_C99_STDINT_H
-WINT_T_SUFFIX
-WCHAR_T_SUFFIX
-SIG_ATOMIC_T_SUFFIX
-SIZE_T_SUFFIX
-PTRDIFF_T_SUFFIX
-HAVE_SIGNED_WINT_T
-HAVE_SIGNED_WCHAR_T
-HAVE_SIGNED_SIG_ATOMIC_T
-BITSIZEOF_WINT_T
-BITSIZEOF_WCHAR_T
-BITSIZEOF_SIG_ATOMIC_T
-BITSIZEOF_SIZE_T
-BITSIZEOF_PTRDIFF_T
-HAVE_STDINT_H
-NEXT_AS_FIRST_DIRECTIVE_STDINT_H
-NEXT_STDINT_H
-HAVE_SYS_TYPES_H
-HAVE_INTTYPES_H
-HAVE_WCHAR_H
-HAVE_UNSIGNED_LONG_LONG_INT
-HAVE_LONG_LONG_INT
-NEXT_AS_FIRST_DIRECTIVE_STDDEF_H
-NEXT_STDDEF_H
 GL_GENERATE_STDDEF_H_FALSE
 GL_GENERATE_STDDEF_H_TRUE
 STDDEF_H
+NEXT_AS_FIRST_DIRECTIVE_STDDEF_H
+NEXT_STDDEF_H
 HAVE_WCHAR_T
 HAVE_MAX_ALIGN_T
 REPLACE_NULL
+GL_GENERATE_STDBOOL_H_FALSE
+GL_GENERATE_STDBOOL_H_TRUE
+STDBOOL_H
+HAVE__BOOL
+GL_COND_OBJ_SIGNBIT3_FALSE
+GL_COND_OBJ_SIGNBIT3_TRUE
+GL_GNULIB_MDA_STRDUP
+GL_GNULIB_MDA_MEMCCPY
+GL_GNULIB_STRVERSCMP
+GL_GNULIB_STRSIGNAL
+GL_GNULIB_SIGDESCR_NP
+GL_GNULIB_SIGABBREV_NP
+GL_GNULIB_STRERRORNAME_NP
+GL_GNULIB_STRERROR_R
+GL_GNULIB_STRERROR
+GL_GNULIB_MBSTOK_R
+GL_GNULIB_MBSSEP
+GL_GNULIB_MBSSPN
+GL_GNULIB_MBSPBRK
+GL_GNULIB_MBSCSPN
+GL_GNULIB_MBSCASESTR
+GL_GNULIB_MBSPCASECMP
+GL_GNULIB_MBSNCASECMP
+GL_GNULIB_MBSCASECMP
+GL_GNULIB_MBSSTR
+GL_GNULIB_MBSRCHR
+GL_GNULIB_MBSCHR
+GL_GNULIB_MBSNLEN
+GL_GNULIB_MBSLEN
+GL_GNULIB_STRTOK_R
+GL_GNULIB_STRCASESTR
+GL_GNULIB_STRSTR
+GL_GNULIB_STRSEP
+GL_GNULIB_STRPBRK
+GL_GNULIB_STRNLEN
+GL_GNULIB_STRNDUP
+GL_GNULIB_STRNCAT
+GL_GNULIB_STRDUP
+GL_GNULIB_STRCHRNUL
+GL_GNULIB_STPNCPY
+GL_GNULIB_STPCPY
+GL_GNULIB_RAWMEMCHR
+GL_GNULIB_MEMSET_EXPLICIT
+GL_GNULIB_MEMRCHR
+GL_GNULIB_MEMPCPY
+GL_GNULIB_MEMMEM
+GL_GNULIB_MEMCHR
+GL_GNULIB_FFSLL
+GL_GNULIB_FFSL
+GL_GNULIB_EXPLICIT_BZERO
+GL_COND_OBJ_MEMCHR_FALSE
+GL_COND_OBJ_MEMCHR_TRUE
 UNDEFINE_STRTOK_R
 REPLACE_STRSIGNAL
+REPLACE_STRERRORNAME_NP
 REPLACE_STRERROR_R
 REPLACE_STRERROR
 REPLACE_STRTOK_R
@@ -927,10 +1163,16 @@
 REPLACE_STRDUP
 REPLACE_STRCHRNUL
 REPLACE_STPNCPY
+REPLACE_STPCPY
+REPLACE_MEMPCPY
 REPLACE_MEMMEM
 REPLACE_MEMCHR
+REPLACE_FFSLL
 HAVE_STRVERSCMP
 HAVE_DECL_STRSIGNAL
+HAVE_SIGDESCR_NP
+HAVE_SIGABBREV_NP
+HAVE_STRERRORNAME_NP
 HAVE_DECL_STRERROR_R
 HAVE_DECL_STRTOK_R
 HAVE_STRCASESTR
@@ -944,51 +1186,13 @@
 HAVE_STPCPY
 HAVE_RAWMEMCHR
 HAVE_DECL_MEMRCHR
+HAVE_MEMSET_EXPLICIT
 HAVE_MEMPCPY
 HAVE_DECL_MEMMEM
-HAVE_MEMCHR
 HAVE_FFSLL
 HAVE_FFSL
 HAVE_EXPLICIT_BZERO
 HAVE_MBSLEN
-GNULIB_STRVERSCMP
-GNULIB_STRSIGNAL
-GNULIB_STRERROR_R
-GNULIB_STRERROR
-GNULIB_MBSTOK_R
-GNULIB_MBSSEP
-GNULIB_MBSSPN
-GNULIB_MBSPBRK
-GNULIB_MBSCSPN
-GNULIB_MBSCASESTR
-GNULIB_MBSPCASECMP
-GNULIB_MBSNCASECMP
-GNULIB_MBSCASECMP
-GNULIB_MBSSTR
-GNULIB_MBSRCHR
-GNULIB_MBSCHR
-GNULIB_MBSNLEN
-GNULIB_MBSLEN
-GNULIB_STRTOK_R
-GNULIB_STRCASESTR
-GNULIB_STRSTR
-GNULIB_STRSEP
-GNULIB_STRPBRK
-GNULIB_STRNLEN
-GNULIB_STRNDUP
-GNULIB_STRNCAT
-GNULIB_STRDUP
-GNULIB_STRCHRNUL
-GNULIB_STPNCPY
-GNULIB_STPCPY
-GNULIB_RAWMEMCHR
-GNULIB_MEMRCHR
-GNULIB_MEMPCPY
-GNULIB_MEMMEM
-GNULIB_MEMCHR
-GNULIB_FFSLL
-GNULIB_FFSL
-GNULIB_EXPLICIT_BZERO
 NEXT_AS_FIRST_DIRECTIVE_MATH_H
 NEXT_MATH_H
 LOCALCHARSET_TESTS_ENVIRONMENT
@@ -996,10 +1200,155 @@
 GL_GENERATE_LIMITS_H_FALSE
 GL_GENERATE_LIMITS_H_TRUE
 LIMITS_H
+GL_GNULIB_STRTOUMAX
+GL_GNULIB_STRTOIMAX
+GL_GNULIB_IMAXDIV
+GL_GNULIB_IMAXABS
+NEXT_AS_FIRST_DIRECTIVE_INTTYPES_H
+NEXT_INTTYPES_H
+UINT64_MAX_EQ_ULONG_MAX
+UINT32_MAX_LT_UINTMAX_MAX
+PRIPTR_PREFIX
+INT64_MAX_EQ_LONG_MAX
+INT32_MAX_LT_INTMAX_MAX
+REPLACE_STRTOUMAX
+REPLACE_STRTOIMAX
+REPLACE_IMAXDIV
+REPLACE_IMAXABS
+HAVE_IMAXDIV
+HAVE_IMAXABS
+HAVE_IMAXDIV_T
+HAVE_DECL_STRTOUMAX
+HAVE_DECL_STRTOIMAX
+HAVE_DECL_IMAXDIV
+HAVE_DECL_IMAXABS
+HAVE_SYS_INTTYPES_H
+HAVE_SYS_BITYPES_H
+HAVE_C99_STDINT_H
+WINT_T_SUFFIX
+WCHAR_T_SUFFIX
+SIG_ATOMIC_T_SUFFIX
+SIZE_T_SUFFIX
+PTRDIFF_T_SUFFIX
+HAVE_SIGNED_WINT_T
+HAVE_SIGNED_WCHAR_T
+HAVE_SIGNED_SIG_ATOMIC_T
+BITSIZEOF_WINT_T
+BITSIZEOF_WCHAR_T
+BITSIZEOF_SIG_ATOMIC_T
+BITSIZEOF_SIZE_T
+BITSIZEOF_PTRDIFF_T
+HAVE_STDINT_H
+NEXT_AS_FIRST_DIRECTIVE_STDINT_H
+NEXT_STDINT_H
+HAVE_SYS_TYPES_H
+HAVE_INTTYPES_H
+HAVE_WCHAR_H
 NEXT_AS_FIRST_DIRECTIVE_LIMITS_H
 NEXT_LIMITS_H
-HOST_CPU_C_ABI
-HOST_CPU
+GL_COND_OBJ_FSETERR_FALSE
+GL_COND_OBJ_FSETERR_TRUE
+GL_GNULIB_MDA_YN
+GL_GNULIB_MDA_Y1
+GL_GNULIB_MDA_Y0
+GL_GNULIB_MDA_JN
+GL_GNULIB_MDA_J1
+GL_GNULIB_MDA_J0
+GL_GNULIB_TRUNCL
+GL_GNULIB_TRUNCF
+GL_GNULIB_TRUNC
+GL_GNULIB_TANHF
+GL_GNULIB_TANL
+GL_GNULIB_TANF
+GL_GNULIB_SQRTL
+GL_GNULIB_SQRTF
+GL_GNULIB_SINHF
+GL_GNULIB_SINL
+GL_GNULIB_SINF
+GL_GNULIB_SIGNBIT
+GL_GNULIB_ROUNDL
+GL_GNULIB_ROUNDF
+GL_GNULIB_ROUND
+GL_GNULIB_RINTL
+GL_GNULIB_RINTF
+GL_GNULIB_RINT
+GL_GNULIB_REMAINDERL
+GL_GNULIB_REMAINDERF
+GL_GNULIB_REMAINDER
+GL_GNULIB_POWF
+GL_GNULIB_MODFL
+GL_GNULIB_MODFF
+GL_GNULIB_MODF
+GL_GNULIB_LOGBL
+GL_GNULIB_LOGBF
+GL_GNULIB_LOGB
+GL_GNULIB_LOG2L
+GL_GNULIB_LOG2F
+GL_GNULIB_LOG2
+GL_GNULIB_LOG1PL
+GL_GNULIB_LOG1PF
+GL_GNULIB_LOG1P
+GL_GNULIB_LOG10L
+GL_GNULIB_LOG10F
+GL_GNULIB_LOG10
+GL_GNULIB_LOGL
+GL_GNULIB_LOGF
+GL_GNULIB_LOG
+GL_GNULIB_LDEXPL
+GL_GNULIB_LDEXPF
+GL_GNULIB_ISNANL
+GL_GNULIB_ISNAND
+GL_GNULIB_ISNANF
+GL_GNULIB_ISNAN
+GL_GNULIB_ISINF
+GL_GNULIB_ISFINITE
+GL_GNULIB_ILOGBL
+GL_GNULIB_ILOGBF
+GL_GNULIB_ILOGB
+GL_GNULIB_HYPOTL
+GL_GNULIB_HYPOTF
+GL_GNULIB_HYPOT
+GL_GNULIB_FREXPL
+GL_GNULIB_FREXP
+GL_GNULIB_FREXPF
+GL_GNULIB_FMODL
+GL_GNULIB_FMODF
+GL_GNULIB_FMOD
+GL_GNULIB_FMAL
+GL_GNULIB_FMAF
+GL_GNULIB_FMA
+GL_GNULIB_FLOORL
+GL_GNULIB_FLOORF
+GL_GNULIB_FLOOR
+GL_GNULIB_FABSL
+GL_GNULIB_FABSF
+GL_GNULIB_EXPM1L
+GL_GNULIB_EXPM1F
+GL_GNULIB_EXPM1
+GL_GNULIB_EXP2L
+GL_GNULIB_EXP2F
+GL_GNULIB_EXP2
+GL_GNULIB_EXPL
+GL_GNULIB_EXPF
+GL_GNULIB_COSHF
+GL_GNULIB_COSL
+GL_GNULIB_COSF
+GL_GNULIB_COPYSIGNL
+GL_GNULIB_COPYSIGNF
+GL_GNULIB_COPYSIGN
+GL_GNULIB_CEILL
+GL_GNULIB_CEILF
+GL_GNULIB_CEIL
+GL_GNULIB_CBRTL
+GL_GNULIB_CBRTF
+GL_GNULIB_CBRT
+GL_GNULIB_ATAN2F
+GL_GNULIB_ATANL
+GL_GNULIB_ATANF
+GL_GNULIB_ASINL
+GL_GNULIB_ASINF
+GL_GNULIB_ACOSL
+GL_GNULIB_ACOSF
 REPLACE_TRUNCL
 REPLACE_TRUNCF
 REPLACE_TRUNC
@@ -1009,11 +1358,12 @@
 REPLACE_SQRTF
 REPLACE_SINHF
 REPLACE_SINF
-REPLACE_SIGNBIT_USING_GCC
+REPLACE_SIGNBIT_USING_BUILTINS
 REPLACE_SIGNBIT
 REPLACE_ROUNDL
 REPLACE_ROUNDF
 REPLACE_ROUND
+REPLACE_RINTL
 REPLACE_REMAINDERL
 REPLACE_REMAINDERF
 REPLACE_REMAINDER
@@ -1062,8 +1412,10 @@
 REPLACE_FABSL
 REPLACE_EXP2L
 REPLACE_EXP2
+REPLACE_EXPM1L
 REPLACE_EXPM1F
 REPLACE_EXPM1
+REPLACE_EXPL
 REPLACE_EXPF
 REPLACE_COSHF
 REPLACE_COSF
@@ -1172,101 +1524,200 @@
 HAVE_ASINF
 HAVE_ACOSL
 HAVE_ACOSF
-GNULIB_TRUNCL
-GNULIB_TRUNCF
-GNULIB_TRUNC
-GNULIB_TANHF
-GNULIB_TANL
-GNULIB_TANF
-GNULIB_SQRTL
-GNULIB_SQRTF
-GNULIB_SINHF
-GNULIB_SINL
-GNULIB_SINF
-GNULIB_SIGNBIT
-GNULIB_ROUNDL
-GNULIB_ROUNDF
-GNULIB_ROUND
-GNULIB_RINTL
-GNULIB_RINTF
-GNULIB_RINT
-GNULIB_REMAINDERL
-GNULIB_REMAINDERF
-GNULIB_REMAINDER
-GNULIB_POWF
-GNULIB_MODFL
-GNULIB_MODFF
-GNULIB_MODF
-GNULIB_LOGBL
-GNULIB_LOGBF
-GNULIB_LOGB
-GNULIB_LOG2L
-GNULIB_LOG2F
-GNULIB_LOG2
-GNULIB_LOG1PL
-GNULIB_LOG1PF
-GNULIB_LOG1P
-GNULIB_LOG10L
-GNULIB_LOG10F
-GNULIB_LOG10
-GNULIB_LOGL
-GNULIB_LOGF
-GNULIB_LOG
-GNULIB_LDEXPL
-GNULIB_LDEXPF
-GNULIB_ISNANL
-GNULIB_ISNAND
-GNULIB_ISNANF
-GNULIB_ISNAN
-GNULIB_ISINF
-GNULIB_ISFINITE
-GNULIB_ILOGBL
-GNULIB_ILOGBF
-GNULIB_ILOGB
-GNULIB_HYPOTL
-GNULIB_HYPOTF
-GNULIB_HYPOT
-GNULIB_FREXPL
-GNULIB_FREXP
-GNULIB_FREXPF
-GNULIB_FMODL
-GNULIB_FMODF
-GNULIB_FMOD
-GNULIB_FMAL
-GNULIB_FMAF
-GNULIB_FMA
-GNULIB_FLOORL
-GNULIB_FLOORF
-GNULIB_FLOOR
-GNULIB_FABSL
-GNULIB_FABSF
-GNULIB_EXPM1L
-GNULIB_EXPM1F
-GNULIB_EXPM1
-GNULIB_EXP2L
-GNULIB_EXP2F
-GNULIB_EXP2
-GNULIB_EXPL
-GNULIB_EXPF
-GNULIB_COSHF
-GNULIB_COSL
-GNULIB_COSF
-GNULIB_COPYSIGNL
-GNULIB_COPYSIGNF
-GNULIB_COPYSIGN
-GNULIB_CEILL
-GNULIB_CEILF
-GNULIB_CEIL
-GNULIB_CBRTL
-GNULIB_CBRTF
-GNULIB_CBRT
-GNULIB_ATAN2F
-GNULIB_ATANL
-GNULIB_ATANF
-GNULIB_ASINL
-GNULIB_ASINF
-GNULIB_ACOSL
-GNULIB_ACOSF
+GL_GNULIB_MDA_PUTENV
+GL_GNULIB_MDA_MKTEMP
+GL_GNULIB_MDA_GCVT
+GL_GNULIB_MDA_FCVT
+GL_GNULIB_MDA_ECVT
+GL_GNULIB_WCTOMB
+GL_GNULIB_UNSETENV
+GL_GNULIB_UNLOCKPT
+GL_GNULIB_SYSTEM_POSIX
+GL_GNULIB_STRTOULL
+GL_GNULIB_STRTOUL
+GL_GNULIB_STRTOLL
+GL_GNULIB_STRTOLD
+GL_GNULIB_STRTOL
+GL_GNULIB_STRTOD
+GL_GNULIB_SETENV
+GL_GNULIB_SECURE_GETENV
+GL_GNULIB_RPMATCH
+GL_GNULIB_REALPATH
+GL_GNULIB_REALLOC_POSIX
+GL_GNULIB_REALLOC_GNU
+GL_GNULIB_REALLOCARRAY
+GL_GNULIB_RANDOM_R
+GL_GNULIB_RANDOM
+GL_GNULIB_QSORT_R
+GL_GNULIB_PUTENV
+GL_GNULIB_PTSNAME_R
+GL_GNULIB_PTSNAME
+GL_GNULIB_POSIX_OPENPT
+GL_GNULIB_POSIX_MEMALIGN
+GL_GNULIB_MKSTEMPS
+GL_GNULIB_MKSTEMP
+GL_GNULIB_MKOSTEMPS
+GL_GNULIB_MKOSTEMP
+GL_GNULIB_MKDTEMP
+GL_GNULIB_MBTOWC
+GL_GNULIB_MALLOC_POSIX
+GL_GNULIB_MALLOC_GNU
+GL_GNULIB_GRANTPT
+GL_GNULIB_GETSUBOPT
+GL_GNULIB_GETPROGNAME
+GL_GNULIB_GETLOADAVG
+GL_GNULIB_FREE_POSIX
+GL_GNULIB_CANONICALIZE_FILE_NAME
+GL_GNULIB_CALLOC_POSIX
+GL_GNULIB_CALLOC_GNU
+GL_GNULIB_ATOLL
+GL_GNULIB_ALIGNED_ALLOC
+GL_GNULIB__EXIT
+GL_COND_OBJ_FREE_FALSE
+GL_COND_OBJ_FREE_TRUE
+REPLACE_WCTOMB
+REPLACE_UNSETENV
+REPLACE_STRTOULL
+REPLACE_STRTOUL
+REPLACE_STRTOLL
+REPLACE_STRTOLD
+REPLACE_STRTOL
+REPLACE_STRTOD
+REPLACE_SETSTATE
+REPLACE_SETENV
+REPLACE_REALPATH
+REPLACE_REALLOCARRAY
+REPLACE_REALLOC_FOR_REALLOC_POSIX
+REPLACE_REALLOC_FOR_REALLOC_GNU
+REPLACE_RANDOM_R
+REPLACE_RANDOM
+REPLACE_QSORT_R
+REPLACE_PUTENV
+REPLACE_PTSNAME_R
+REPLACE_PTSNAME
+REPLACE_POSIX_OPENPT
+REPLACE_POSIX_MEMALIGN
+REPLACE_MKSTEMP
+REPLACE_MKOSTEMPS
+REPLACE_MKOSTEMP
+REPLACE_MBTOWC
+REPLACE_MALLOC_FOR_MALLOC_POSIX
+REPLACE_MALLOC_FOR_MALLOC_GNU
+REPLACE_INITSTATE
+REPLACE_GETSUBOPT
+REPLACE_GETPROGNAME
+REPLACE_GETLOADAVG
+REPLACE_FREE
+REPLACE_CANONICALIZE_FILE_NAME
+REPLACE_CALLOC_FOR_CALLOC_POSIX
+REPLACE_CALLOC_FOR_CALLOC_GNU
+REPLACE_ALIGNED_ALLOC
+REPLACE__EXIT
+HAVE_DECL_UNSETENV
+HAVE_UNLOCKPT
+HAVE_SYS_LOADAVG_H
+HAVE_STRUCT_RANDOM_DATA
+HAVE_STRTOULL
+HAVE_STRTOUL
+HAVE_STRTOLL
+HAVE_STRTOLD
+HAVE_STRTOL
+HAVE_STRTOD
+HAVE_DECL_SETSTATE
+HAVE_SETSTATE
+HAVE_DECL_SETENV
+HAVE_SETENV
+HAVE_SECURE_GETENV
+HAVE_RPMATCH
+HAVE_REALPATH
+HAVE_REALLOCARRAY
+HAVE_RANDOM_R
+HAVE_RANDOM_H
+HAVE_RANDOM
+HAVE_QSORT_R
+HAVE_PTSNAME_R
+HAVE_PTSNAME
+HAVE_POSIX_OPENPT
+HAVE_POSIX_MEMALIGN
+HAVE_MKSTEMPS
+HAVE_MKSTEMP
+HAVE_MKOSTEMPS
+HAVE_MKOSTEMP
+HAVE_MKDTEMP
+HAVE_MBTOWC
+HAVE_DECL_INITSTATE
+HAVE_INITSTATE
+HAVE_GRANTPT
+HAVE_GETSUBOPT
+HAVE_GETPROGNAME
+HAVE_DECL_GETLOADAVG
+HAVE_DECL_GCVT
+HAVE_DECL_FCVT
+HAVE_DECL_ECVT
+HAVE_CANONICALIZE_FILE_NAME
+HAVE_ATOLL
+HAVE_ALIGNED_ALLOC
+HAVE__EXIT
+GL_GNULIB_MDA_TEMPNAM
+GL_GNULIB_MDA_PUTW
+GL_GNULIB_MDA_GETW
+GL_GNULIB_MDA_FILENO
+GL_GNULIB_MDA_FDOPEN
+GL_GNULIB_MDA_FCLOSEALL
+GL_GNULIB_VSPRINTF_POSIX
+GL_GNULIB_VSNPRINTF
+GL_GNULIB_VPRINTF_POSIX
+GL_GNULIB_VPRINTF
+GL_GNULIB_VFPRINTF_POSIX
+GL_GNULIB_VFPRINTF
+GL_GNULIB_VDPRINTF
+GL_GNULIB_VSCANF
+GL_GNULIB_VFSCANF
+GL_GNULIB_VASPRINTF
+GL_GNULIB_TMPFILE
+GL_GNULIB_STDIO_H_SIGPIPE
+GL_GNULIB_STDIO_H_NONBLOCKING
+GL_GNULIB_SPRINTF_POSIX
+GL_GNULIB_SNPRINTF
+GL_GNULIB_SCANF
+GL_GNULIB_RENAMEAT
+GL_GNULIB_RENAME
+GL_GNULIB_REMOVE
+GL_GNULIB_PUTS
+GL_GNULIB_PUTCHAR
+GL_GNULIB_PUTC
+GL_GNULIB_PRINTF_POSIX
+GL_GNULIB_PRINTF
+GL_GNULIB_POPEN
+GL_GNULIB_PERROR
+GL_GNULIB_PCLOSE
+GL_GNULIB_OBSTACK_PRINTF_POSIX
+GL_GNULIB_OBSTACK_PRINTF
+GL_GNULIB_GETLINE
+GL_GNULIB_GETDELIM
+GL_GNULIB_GETCHAR
+GL_GNULIB_GETC
+GL_GNULIB_FWRITE
+GL_GNULIB_FTELLO
+GL_GNULIB_FTELL
+GL_GNULIB_FSEEKO
+GL_GNULIB_FSEEK
+GL_GNULIB_FSCANF
+GL_GNULIB_FREOPEN
+GL_GNULIB_FREAD
+GL_GNULIB_FPUTS
+GL_GNULIB_FPUTC
+GL_GNULIB_FPURGE
+GL_GNULIB_FPRINTF_POSIX
+GL_GNULIB_FPRINTF
+GL_GNULIB_FOPEN_GNU
+GL_GNULIB_FOPEN
+GL_GNULIB_FGETS
+GL_GNULIB_FGETC
+GL_GNULIB_FFLUSH
+GL_GNULIB_FDOPEN
+GL_GNULIB_FCLOSE
+GL_GNULIB_DPRINTF
 REPLACE_VSPRINTF
 REPLACE_VSNPRINTF
 REPLACE_VPRINTF
@@ -1294,6 +1745,7 @@
 REPLACE_FREOPEN
 REPLACE_FPURGE
 REPLACE_FPRINTF
+REPLACE_FOPEN_FOR_FOPEN_GNU
 REPLACE_FOPEN
 REPLACE_FFLUSH
 REPLACE_FDOPEN
@@ -1309,86 +1761,45 @@
 HAVE_DPRINTF
 HAVE_DECL_VSNPRINTF
 HAVE_DECL_SNPRINTF
+HAVE_DECL_PUTW
 HAVE_DECL_OBSTACK_PRINTF
+HAVE_DECL_GETW
 HAVE_DECL_GETLINE
 HAVE_DECL_GETDELIM
 HAVE_DECL_FTELLO
 HAVE_DECL_FSEEKO
 HAVE_DECL_FPURGE
-GNULIB_VSPRINTF_POSIX
-GNULIB_VSNPRINTF
-GNULIB_VPRINTF_POSIX
-GNULIB_VPRINTF
-GNULIB_VFPRINTF_POSIX
-GNULIB_VFPRINTF
-GNULIB_VDPRINTF
-GNULIB_VSCANF
-GNULIB_VFSCANF
-GNULIB_VASPRINTF
-GNULIB_TMPFILE
-GNULIB_STDIO_H_SIGPIPE
-GNULIB_STDIO_H_NONBLOCKING
-GNULIB_SPRINTF_POSIX
-GNULIB_SNPRINTF
-GNULIB_SCANF
-GNULIB_RENAMEAT
-GNULIB_RENAME
-GNULIB_REMOVE
-GNULIB_PUTS
-GNULIB_PUTCHAR
-GNULIB_PUTC
-GNULIB_PRINTF_POSIX
-GNULIB_PRINTF
-GNULIB_POPEN
-GNULIB_PERROR
-GNULIB_PCLOSE
-GNULIB_OBSTACK_PRINTF_POSIX
-GNULIB_OBSTACK_PRINTF
-GNULIB_GETLINE
-GNULIB_GETDELIM
-GNULIB_GETCHAR
-GNULIB_GETC
-GNULIB_FWRITE
-GNULIB_FTELLO
-GNULIB_FTELL
-GNULIB_FSEEKO
-GNULIB_FSEEK
-GNULIB_FSCANF
-GNULIB_FREOPEN
-GNULIB_FREAD
-GNULIB_FPUTS
-GNULIB_FPUTC
-GNULIB_FPURGE
-GNULIB_FPRINTF_POSIX
-GNULIB_FPRINTF
-GNULIB_FOPEN
-GNULIB_FGETS
-GNULIB_FGETC
-GNULIB_FFLUSH
-GNULIB_FDOPEN
-GNULIB_FCLOSE
-GNULIB_DPRINTF
+HAVE_DECL_FCLOSEALL
 HAVE_FEATURES_H
-GNULIB_OVERRIDES_WINT_T
+GNULIBHEADERS_OVERRIDE_WINT_T
 APPLE_UNIVERSAL_BUILD
 HAVE_SAME_LONG_DOUBLE_AS_DOUBLE
-REPLACE_ITOLD
+GL_COND_OBJ_ITOLD_FALSE
+GL_COND_OBJ_ITOLD_TRUE
+GL_COND_OBJ_FLOAT_FALSE
+GL_COND_OBJ_FLOAT_TRUE
 GL_GENERATE_FLOAT_H_FALSE
 GL_GENERATE_FLOAT_H_TRUE
 FLOAT_H
+REPLACE_ITOLD
 NEXT_AS_FIRST_DIRECTIVE_FLOAT_H
 NEXT_FLOAT_H
+GL_GENERATE_ERRNO_H_FALSE
+GL_GENERATE_ERRNO_H_TRUE
+ERRNO_H
 EOVERFLOW_VALUE
 EOVERFLOW_HIDDEN
 ENOLINK_VALUE
 ENOLINK_HIDDEN
 EMULTIHOP_VALUE
 EMULTIHOP_HIDDEN
-GL_GENERATE_ERRNO_H_FALSE
-GL_GENERATE_ERRNO_H_TRUE
-ERRNO_H
 NEXT_AS_FIRST_DIRECTIVE_ERRNO_H
 NEXT_ERRNO_H
+GL_GENERATE_ASSERT_H_FALSE
+GL_GENERATE_ASSERT_H_TRUE
+ASSERT_H
+NEXT_AS_FIRST_DIRECTIVE_ASSERT_H
+NEXT_ASSERT_H
 PRAGMA_COLUMNS
 PRAGMA_SYSTEM_HEADER
 INCLUDE_NEXT_AS_FIRST_DIRECTIVE
@@ -1396,9 +1807,16 @@
 GL_GENERATE_ALLOCA_H_FALSE
 GL_GENERATE_ALLOCA_H_TRUE
 ALLOCA_H
+HAVE_ALLOCA_H
 ALLOCA
 GL_COND_LIBTOOL_FALSE
 GL_COND_LIBTOOL_TRUE
+RANLIB
+ARFLAGS
+AR
+EGREP
+GREP
+CPP
 host_os
 host_vendor
 host_cpu
@@ -1407,9 +1825,6 @@
 build_vendor
 build_cpu
 build
-RANLIB
-ARFLAGS
-AR
 am__fastdepCXX_FALSE
 am__fastdepCXX_TRUE
 CXXDEPMODE
@@ -1420,6 +1835,9 @@
 AM_DEFAULT_VERBOSITY
 AM_DEFAULT_V
 AM_V
+CSCOPE
+ETAGS
+CTAGS
 am__fastdepCC_FALSE
 am__fastdepCC_TRUE
 CCDEPMODE
@@ -1452,9 +1870,6 @@
 INSTALL_DATA
 INSTALL_SCRIPT
 INSTALL_PROGRAM
-EGREP
-GREP
-CPP
 OBJEXT
 EXEEXT
 ac_ct_CC
@@ -1482,6 +1897,7 @@
 docdir
 oldincludedir
 includedir
+runstatedir
 localstatedir
 sharedstatedir
 sysconfdir
@@ -1502,7 +1918,6 @@
 PATH_SEPARATOR
 SHELL
 referdir
-grog_dir
 gpinyin_dir
 glilypond_dir
 libprogramdir
@@ -1512,15 +1927,15 @@
 enable_option_checking
 enable_dependency_tracking
 enable_silent_rules
+enable_cross_guesses
 with_x
-with_appresdir
-with_grofferdir
-with_doc
+with_appdefdir
 with_uchardet
 with_gnu_ld
 enable_rpath
 with_libiconv_prefix
 with_urw_fonts_dir
+enable_groff_allocator
 with_compatibility_wrappers
 with_alt_gs
 with_gs
@@ -1535,10 +1950,10 @@
 LDFLAGS
 LIBS
 CPPFLAGS
-CPP
 CXX
 CXXFLAGS
 CCC
+CPP
 XMKMF
 PKG_CONFIG
 PKG_CONFIG_PATH
@@ -1584,6 +1999,7 @@
 sysconfdir='${prefix}/etc'
 sharedstatedir='${prefix}/com'
 localstatedir='${prefix}/var'
+runstatedir='${localstatedir}/run'
 includedir='${prefix}/include'
 oldincludedir='/usr/include'
 docdir='${datarootdir}/doc/${PACKAGE_TARNAME}'
@@ -1613,8 +2029,6 @@
   *)    ac_optarg=yes ;;
   esac
 
-  # Accept the important Cygnus configure options, so we can diagnose typos.
-
   case $ac_dashdash$ac_option in
   --)
     ac_dashdash=yes ;;
@@ -1655,9 +2069,9 @@
     ac_useropt=`expr "x$ac_option" : 'x-*disable-$.*$'`
     # Reject names that are not valid shell variable names.
     expr "x$ac_useropt" : ".*^-+._$as_cr_alnum" >/dev/null &&
-      as_fn_error $? "invalid feature name: $ac_useropt"
+      as_fn_error $? "invalid feature name: \`$ac_useropt'"
     ac_useropt_orig=$ac_useropt
-    ac_useropt=`$as_echo "$ac_useropt" | sed 's/-+./_/g'`
+    ac_useropt=`printf "%s\n" "$ac_useropt" | sed 's/-+./_/g'`
     case $ac_user_opts in
       *"
 "enable_$ac_useropt"
@@ -1681,9 +2095,9 @@
     ac_useropt=`expr "x$ac_option" : 'x-*enable-$^=*$'`
     # Reject names that are not valid shell variable names.
     expr "x$ac_useropt" : ".*^-+._$as_cr_alnum" >/dev/null &&
-      as_fn_error $? "invalid feature name: $ac_useropt"
+      as_fn_error $? "invalid feature name: \`$ac_useropt'"
     ac_useropt_orig=$ac_useropt
-    ac_useropt=`$as_echo "$ac_useropt" | sed 's/-+./_/g'`
+    ac_useropt=`printf "%s\n" "$ac_useropt" | sed 's/-+./_/g'`
     case $ac_user_opts in
       *"
 "enable_$ac_useropt"
@@ -1836,6 +2250,15 @@
   | -silent | --silent | --silen | --sile | --sil)
     silent=yes ;;
 
+  -runstatedir | --runstatedir | --runstatedi | --runstated \
+  | --runstate | --runstat | --runsta | --runst | --runs \
+  | --run | --ru | --r)
+    ac_prev=runstatedir ;;
+  -runstatedir=* | --runstatedir=* | --runstatedi=* | --runstated=* \
+  | --runstate=* | --runstat=* | --runsta=* | --runst=* | --runs=* \
+  | --run=* | --ru=* | --r=*)
+    runstatedir=$ac_optarg ;;
+
   -sbindir | --sbindir | --sbindi | --sbind | --sbin | --sbi | --sb)
     ac_prev=sbindir ;;
   -sbindir=* | --sbindir=* | --sbindi=* | --sbind=* | --sbin=* \
@@ -1885,9 +2308,9 @@
     ac_useropt=`expr "x$ac_option" : 'x-*with-$^=*$'`
     # Reject names that are not valid shell variable names.
     expr "x$ac_useropt" : ".*^-+._$as_cr_alnum" >/dev/null &&
-      as_fn_error $? "invalid package name: $ac_useropt"
+      as_fn_error $? "invalid package name: \`$ac_useropt'"
     ac_useropt_orig=$ac_useropt
-    ac_useropt=`$as_echo "$ac_useropt" | sed 's/-+./_/g'`
+    ac_useropt=`printf "%s\n" "$ac_useropt" | sed 's/-+./_/g'`
     case $ac_user_opts in
       *"
 "with_$ac_useropt"
@@ -1901,9 +2324,9 @@
     ac_useropt=`expr "x$ac_option" : 'x-*without-$.*$'`
     # Reject names that are not valid shell variable names.
     expr "x$ac_useropt" : ".*^-+._$as_cr_alnum" >/dev/null &&
-      as_fn_error $? "invalid package name: $ac_useropt"
+      as_fn_error $? "invalid package name: \`$ac_useropt'"
     ac_useropt_orig=$ac_useropt
-    ac_useropt=`$as_echo "$ac_useropt" | sed 's/-+./_/g'`
+    ac_useropt=`printf "%s\n" "$ac_useropt" | sed 's/-+./_/g'`
     case $ac_user_opts in
       *"
 "with_$ac_useropt"
@@ -1947,9 +2370,9 @@
 
   *)
     # FIXME: should be removed in autoconf 3.0.
-    $as_echo "$as_me: WARNING: you should use --build, --host, --target" >&2
+    printf "%s\n" "$as_me: WARNING: you should use --build, --host, --target" >&2
     expr "x$ac_option" : ".*^-._$as_cr_alnum" >/dev/null &&
-      $as_echo "$as_me: WARNING: invalid host type: $ac_option" >&2
+      printf "%s\n" "$as_me: WARNING: invalid host type: $ac_option" >&2
     : "${build_alias=$ac_option} ${host_alias=$ac_option} ${target_alias=$ac_option}"
     ;;
 
@@ -1965,7 +2388,7 @@
   case $enable_option_checking in
     no) ;;
     fatal) as_fn_error $? "unrecognized options: $ac_unrecognized_opts" ;;
-    *)     $as_echo "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2 ;;
+    *)     printf "%s\n" "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2 ;;
   esac
 fi
 
@@ -1973,7 +2396,7 @@
 for ac_var in	exec_prefix prefix bindir sbindir libexecdir datarootdir \
 		datadir sysconfdir sharedstatedir localstatedir includedir \
 		oldincludedir docdir infodir htmldir dvidir pdfdir psdir \
-		libdir localedir mandir
+		libdir localedir mandir runstatedir
 do
   eval ac_val=\$$ac_var
   # Remove trailing slashes.
@@ -2029,7 +2452,7 @@
 	 X"$as_myself" : 'X$//$^/' \| \
 	 X"$as_myself" : 'X$//$$' \| \
 	 X"$as_myself" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$as_myself" |
+printf "%s\n" X"$as_myself" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -2086,7 +2509,7 @@
   # Omit some internal or obsolete options to make the list less imposing.
   # This message is too long to be a string in the A/UX 3.1 sh.
   cat <<_ACEOF
-\`configure' configures GNU Troff 1.22.4 to adapt to many kinds of systems.
+\`configure' configures GNU roff 1.23.0 to adapt to many kinds of systems.
 
 Usage: $0 OPTION... VAR=VALUE...
 
@@ -2126,6 +2549,7 @@
   --sysconfdir=DIR        read-only single-machine data PREFIX/etc
   --sharedstatedir=DIR    modifiable architecture-independent data PREFIX/com
   --localstatedir=DIR     modifiable single-machine data PREFIX/var
+  --runstatedir=DIR       modifiable per-process data LOCALSTATEDIR/run
   --libdir=DIR            object code libraries EPREFIX/lib
   --includedir=DIR        C header files PREFIX/include
   --oldincludedir=DIR     C header files for non-gcc /usr/include
@@ -2160,7 +2584,7 @@
 
 if test -n "$ac_init_help"; then
   case $ac_init_help in
-     short | recursive ) echo "Configuration of GNU Troff 1.22.4:";;
+     short | recursive ) echo "Configuration of GNU roff 1.23.0:";;
    esac
   cat <<\_ACEOF
 
@@ -2174,47 +2598,42 @@
                           speeds up one-time build
   --enable-silent-rules   less verbose build output (undo: "make V=1")
   --disable-silent-rules  verbose build output (undo: "make V=0")
+  --enable-cross-guesses={conservative|risky}
+                          specify policy for cross-compilation guesses
   --disable-rpath         do not hardcode runtime library paths
+  --enable-groff-allocator
+                          enable libgroff's allocator for C++ new/delete
 
 Optional Packages:
   --with-PACKAGE=ARG    use PACKAGE ARG=yes
   --without-PACKAGE       do not use PACKAGE (same as --with-PACKAGE=no)
   --with-x                use the X Window System
-  --with-appresdir=DIR    X11 application resource files
-  --with-grofferdir=DIR   groffer files location
-  --with-doc=TYPE       choose which manuals (beside man pages) are
-                          desirable. TYPE can be 'yes' or 'no', or a
-                          comma-separated list of one or multiple of 'html',
-                          'info', 'other', 'pdf', and 'examples', to restrict
-                          what is produced
-  --with-uchardet         Build 'preconv' with uchardet library for file
-                          encoding automatic detection =auto|no|yes
+  --with-appdefdir=DIR    place X11 application defaults files in DIR
+  --with-uchardet={auto|no|yes}
+                          build 'preconv' against uchardet library to
+                          automatically detect input file encoding
   --with-gnu-ld           assume the C compiler uses GNU ld default=no
   --with-libiconv-prefix=DIR  search for libiconv in DIR/include and DIR/lib
   --without-libiconv-prefix     don't search for libiconv in includedir and libdir
   --with-urw-fonts-dir=DIR
-                          Search for URW fonts in this directory
-  --with-compatibility-wrappers=VALUE
+                          search for URW PostScript Type 1 fonts in DIR
+  --with-compatibility-wrappers={check|manual|no|yes}
                           choose whether and how groff compatibility wrappers
-                          for vendor-provided non-GNU macro sets are
-                          installed. VALUE can be 'check', 'yes', 'no' or
-                          'manual'. 'check' (the default) checks for the
-                          existence of vendor-provided non-GNU macro sets, and
-                          implements the 'yes' or 'no' option accordingly.
-                          'yes' generates compatibility wrappers for
-                          vendor-provided non-GNU macro sets to allow their
-                          use with groff-based tools. The compatibility
-                          wrappers are installed with the original macro set
-                          name, while groff implementation of these macro sets
-                          are installed with a 'g' prefix. Thus use of the
-                          groff implementation of these macro sets requires
-                          use of the '-mg<macro>' option (example: -mgan).
-                          'no' only installs the groff implementation of macro
-                          sets. 'manual' generates compatibility wrappers for
-                          vendor-provided non-GNU macro sets as '<macro>-os'.
-                          Use of these groff compatibility wrappers (for
-                          vendor-provided non-GNU macro sets) requires the use
-                          of the '-m<macro>-os' option (example: -man-os).
+                          for vendor-provided non-GNU macro packages are
+                          installed. 'check' searches for such packages, and
+                          behaves as if 'yes' or 'no' were given, accordingly.
+                          'yes' generates compatibility wrappers for the
+                          vendor-provided packages to allow their use with
+                          groff and related tools. The compatibility wrappers
+                          are installed using the vendor-provided names, while
+                          their groff implementations are installed with a 'g'
+                          prefix. Use of the latter thus requires options of
+                          the form '-mg<package>' (example: -mgan). 'no'
+                          installs only the groff implementations. 'manual'
+                          generates compatibility wrappers for the
+                          vendor-provided packages as '<macro>-os'. Use of the
+                          latter thus requires options of the form
+                          '-m<macro>-os' option (example: -man-os).
   --with-alt-gs=LIST      alternative names for ghostscript executable
   --with-gs=PROG          actual /path/name of ghostscript executable
   --with-alt-awk=LIST     alternative names for awk executable
@@ -2228,9 +2647,9 @@
   LIBS        libraries to pass to the linker, e.g. -l<library>
   CPPFLAGS    (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if
               you have headers in a nonstandard directory <include dir>
-  CPP         C preprocessor
   CXX         C++ compiler command
   CXXFLAGS    C++ compiler flags
+  CPP         C preprocessor
   XMKMF       Path to xmkmf, Makefile generator for X Window System
   PKG_CONFIG  path to pkg-config utility
   PKG_CONFIG_PATH
@@ -2247,8 +2666,8 @@
 it to find libraries and programs with nonstandard names/locations.
 
 Report bugs to <http://savannah.gnu.org/bugs/?group=groff>.
-GNU Troff home page: <http://www.gnu.org/software/groff/>.
-General help using GNU software: <http://www.gnu.org/gethelp/>.
+GNU roff home page: <https://www.gnu.org/software/groff/>.
+General help using GNU software: <https://www.gnu.org/gethelp/>.
 _ACEOF
 ac_status=$?
 fi
@@ -2264,9 +2683,9 @@
 case "$ac_dir" in
 .) ac_dir_suffix= ac_top_builddir_sub=. ac_top_build_prefix= ;;
 *)
-  ac_dir_suffix=/`$as_echo "$ac_dir" | sed 's|^\.\\/||'`
+  ac_dir_suffix=/`printf "%s\n" "$ac_dir" | sed 's|^\.\\/||'`
   # A ".." for each directory in $ac_dir_suffix.
-  ac_top_builddir_sub=`$as_echo "$ac_dir_suffix" | sed 's|/^\\/*|/..|g;s|/||'`
+  ac_top_builddir_sub=`printf "%s\n" "$ac_dir_suffix" | sed 's|/^\\/*|/..|g;s|/||'`
   case $ac_top_builddir_sub in
   "") ac_top_builddir_sub=. ac_top_build_prefix= ;;
   *)  ac_top_build_prefix=$ac_top_builddir_sub/ ;;
@@ -2294,7 +2713,8 @@
 ac_abs_srcdir=$ac_abs_top_srcdir$ac_dir_suffix
 
     cd "$ac_dir" || { ac_status=$?; continue; }
-    # Check for guested configure.
+    # Check for configure.gnu first; this name is used for a wrapper for
+    # Metaconfig's "Configure" on case-insensitive file systems.
     if test -f "$ac_srcdir/configure.gnu"; then
       echo &&
       $SHELL "$ac_srcdir/configure.gnu" --help=recursive
@@ -2302,7 +2722,7 @@
       echo &&
       $SHELL "$ac_srcdir/configure" --help=recursive
     else
-      $as_echo "$as_me: WARNING: no configuration information is in $ac_dir" >&2
+      printf "%s\n" "$as_me: WARNING: no configuration information is in $ac_dir" >&2
     fi || ac_status=$?
     cd "$ac_pwd" || { ac_status=$?; break; }
   done
@@ -2311,10 +2731,10 @@
 test -n "$ac_init_help" && exit $ac_status
 if $ac_init_version; then
   cat <<\_ACEOF
-GNU Troff configure 1.22.4
-generated by GNU Autoconf 2.69
+GNU roff configure 1.23.0
+generated by GNU Autoconf 2.71
 
-Copyright (C) 2012 Free Software Foundation, Inc.
+Copyright (C) 2021 Free Software Foundation, Inc.
 This configure script is free software; the Free Software Foundation
 gives unlimited permission to copy, distribute and modify it.
 _ACEOF
@@ -2331,14 +2751,14 @@
 ac_fn_c_try_compile ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  rm -f conftest.$ac_objext
+  rm -f conftest.$ac_objext conftest.beam
   if { { ac_try="$ac_compile"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compile") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -2346,14 +2766,15 @@
     cat conftest.er1 >&5
     mv -f conftest.er1 conftest.err
   fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && {
 	 test -z "$ac_c_werror_flag" ||
 	 test ! -s conftest.err
-       } && test -s conftest.$ac_objext; then :
+       } && test -s conftest.$ac_objext
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
 	ac_retval=1
@@ -2363,176 +2784,6 @@
 
 } # ac_fn_c_try_compile
 
-# ac_fn_c_try_cpp LINENO
-# ----------------------
-# Try to preprocess conftest.$ac_ext, and return whether this succeeded.
-ac_fn_c_try_cpp ()
-{
-  as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  if { { ac_try="$ac_cpp conftest.$ac_ext"
-case "(($ac_try" in
-  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
-  *) ac_try_echo=$ac_try;;
-esac
-eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
-  (eval "$ac_cpp conftest.$ac_ext") 2>conftest.err
-  ac_status=$?
-  if test -s conftest.err; then
-    grep -v '^ *+' conftest.err >conftest.er1
-    cat conftest.er1 >&5
-    mv -f conftest.er1 conftest.err
-  fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; } > conftest.i && {
-	 test -z "$ac_c_preproc_warn_flag$ac_c_werror_flag" ||
-	 test ! -s conftest.err
-       }; then :
-  ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
-sed 's/^/| /' conftest.$ac_ext >&5
-
-    ac_retval=1
-fi
-  eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
-  as_fn_set_status $ac_retval
-
-} # ac_fn_c_try_cpp
-
-# ac_fn_c_check_header_mongrel LINENO HEADER VAR INCLUDES
-# -------------------------------------------------------
-# Tests whether HEADER exists, giving a warning if it cannot be compiled using
-# the include files in INCLUDES and setting the cache variable VAR
-# accordingly.
-ac_fn_c_check_header_mongrel ()
-{
-  as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  if eval \${$3+:} false; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
-$as_echo_n "checking for $2... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-fi
-eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
-else
-  # Is the header compilable?
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking $2 usability" >&5
-$as_echo_n "checking $2 usability... " >&6; }
-cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-$4
-#include <$2>
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  ac_header_compiler=yes
-else
-  ac_header_compiler=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_header_compiler" >&5
-$as_echo "$ac_header_compiler" >&6; }
-
-# Is the header present?
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking $2 presence" >&5
-$as_echo_n "checking $2 presence... " >&6; }
-cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <$2>
-_ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
-  ac_header_preproc=yes
-else
-  ac_header_preproc=no
-fi
-rm -f conftest.err conftest.i conftest.$ac_ext
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_header_preproc" >&5
-$as_echo "$ac_header_preproc" >&6; }
-
-# So?  What about this header?
-case $ac_header_compiler:$ac_header_preproc:$ac_c_preproc_warn_flag in #((
-  yes:no: )
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: accepted by the compiler, rejected by the preprocessor!" >&5
-$as_echo "$as_me: WARNING: $2: accepted by the compiler, rejected by the preprocessor!" >&2;}
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: proceeding with the compiler's result" >&5
-$as_echo "$as_me: WARNING: $2: proceeding with the compiler's result" >&2;}
-    ;;
-  no:yes:* )
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: present but cannot be compiled" >&5
-$as_echo "$as_me: WARNING: $2: present but cannot be compiled" >&2;}
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2:     check for missing prerequisite headers?" >&5
-$as_echo "$as_me: WARNING: $2:     check for missing prerequisite headers?" >&2;}
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: see the Autoconf documentation" >&5
-$as_echo "$as_me: WARNING: $2: see the Autoconf documentation" >&2;}
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2:     section \"Present But Cannot Be Compiled\"" >&5
-$as_echo "$as_me: WARNING: $2:     section \"Present But Cannot Be Compiled\"" >&2;}
-    { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: proceeding with the compiler's result" >&5
-$as_echo "$as_me: WARNING: $2: proceeding with the compiler's result" >&2;}
-( $as_echo "## -------------------------------------------------------- ##
-## Report this to http://savannah.gnu.org/bugs/?group=groff ##
-## -------------------------------------------------------- ##"
-     ) | sed "s/^/$as_me: WARNING:     /" >&2
-    ;;
-esac
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
-$as_echo_n "checking for $2... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  eval "$3=\$ac_header_compiler"
-fi
-eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
-fi
-  eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
-
-} # ac_fn_c_check_header_mongrel
-
-# ac_fn_c_try_run LINENO
-# ----------------------
-# Try to link conftest.$ac_ext, and return whether this succeeded. Assumes
-# that executables *can* be run.
-ac_fn_c_try_run ()
-{
-  as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  if { { ac_try="$ac_link"
-case "(($ac_try" in
-  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
-  *) ac_try_echo=$ac_try;;
-esac
-eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
-  (eval "$ac_link") 2>&5
-  ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; } && { ac_try='./conftest$ac_exeext'
-  { { case "(($ac_try" in
-  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
-  *) ac_try_echo=$ac_try;;
-esac
-eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
-  (eval "$ac_try") 2>&5
-  ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; }; then :
-  ac_retval=0
-else
-  $as_echo "$as_me: program exited with status $ac_status" >&5
-       $as_echo "$as_me: failed program was:" >&5
-sed 's/^/| /' conftest.$ac_ext >&5
-
-       ac_retval=$ac_status
-fi
-  rm -rf conftest.dSYM conftest_ipa8_conftest.oo
-  eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
-  as_fn_set_status $ac_retval
-
-} # ac_fn_c_try_run
-
 # ac_fn_c_check_header_compile LINENO HEADER VAR INCLUDES
 # -------------------------------------------------------
 # Tests whether HEADER exists and can be compiled using the include files in
@@ -2540,26 +2791,28 @@
 ac_fn_c_check_header_compile ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
-$as_echo_n "checking for $2... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
+printf %s "checking for $2... " >&6; }
+if eval test \${$3+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 #include <$2>
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   eval "$3=yes"
-else
+else $as_nop
   eval "$3=no"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
   eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
 
 } # ac_fn_c_check_header_compile
@@ -2570,14 +2823,14 @@
 ac_fn_cxx_try_compile ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  rm -f conftest.$ac_objext
+  rm -f conftest.$ac_objext conftest.beam
   if { { ac_try="$ac_compile"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compile") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -2585,14 +2838,15 @@
     cat conftest.er1 >&5
     mv -f conftest.er1 conftest.err
   fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && {
 	 test -z "$ac_cxx_werror_flag" ||
 	 test ! -s conftest.err
-       } && test -s conftest.$ac_objext; then :
+       } && test -s conftest.$ac_objext
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
 	ac_retval=1
@@ -2602,6 +2856,44 @@
 
 } # ac_fn_cxx_try_compile
 
+# ac_fn_c_try_cpp LINENO
+# ----------------------
+# Try to preprocess conftest.$ac_ext, and return whether this succeeded.
+ac_fn_c_try_cpp ()
+{
+  as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
+  if { { ac_try="$ac_cpp conftest.$ac_ext"
+case "(($ac_try" in
+  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
+  *) ac_try_echo=$ac_try;;
+esac
+eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
+printf "%s\n" "$ac_try_echo"; } >&5
+  (eval "$ac_cpp conftest.$ac_ext") 2>conftest.err
+  ac_status=$?
+  if test -s conftest.err; then
+    grep -v '^ *+' conftest.err >conftest.er1
+    cat conftest.er1 >&5
+    mv -f conftest.er1 conftest.err
+  fi
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; } > conftest.i && {
+	 test -z "$ac_c_preproc_warn_flag$ac_c_werror_flag" ||
+	 test ! -s conftest.err
+       }
+then :
+  ac_retval=0
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
+sed 's/^/| /' conftest.$ac_ext >&5
+
+    ac_retval=1
+fi
+  eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
+  as_fn_set_status $ac_retval
+
+} # ac_fn_c_try_cpp
+
 # ac_fn_c_check_type LINENO TYPE VAR INCLUDES
 # -------------------------------------------
 # Tests whether TYPE exists after having included INCLUDES, setting cache
@@ -2609,17 +2901,18 @@
 ac_fn_c_check_type ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
-$as_echo_n "checking for $2... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
+printf %s "checking for $2... " >&6; }
+if eval test \${$3+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   eval "$3=no"
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 if (sizeof ($2))
 	 return 0;
@@ -2627,12 +2920,13 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 if (sizeof (($2)))
 	    return 0;
@@ -2640,18 +2934,19 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
+else $as_nop
   eval "$3=yes"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
   eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
 
 } # ac_fn_c_check_type
@@ -2662,14 +2957,14 @@
 ac_fn_c_try_link ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  rm -f conftest.$ac_objext conftest$ac_exeext
+  rm -f conftest.$ac_objext conftest.beam conftest$ac_exeext
   if { { ac_try="$ac_link"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -2677,17 +2972,18 @@
     cat conftest.er1 >&5
     mv -f conftest.er1 conftest.err
   fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && {
 	 test -z "$ac_c_werror_flag" ||
 	 test ! -s conftest.err
        } && test -s conftest$ac_exeext && {
 	 test "$cross_compiling" = yes ||
 	 test -x conftest$ac_exeext
-       }; then :
+       }
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
 	ac_retval=1
@@ -2702,72 +2998,48 @@
 
 } # ac_fn_c_try_link
 
-# ac_fn_c_check_func LINENO FUNC VAR
-# ----------------------------------
-# Tests whether FUNC exists, setting the cache variable VAR accordingly
-ac_fn_c_check_func ()
+# ac_fn_c_try_run LINENO
+# ----------------------
+# Try to run conftest.$ac_ext, and return whether this succeeded. Assumes that
+# executables *can* be run.
+ac_fn_c_try_run ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
-$as_echo_n "checking for $2... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-/* Define $2 to an innocuous variant, in case <limits.h> declares $2.
-   For example, HP-UX 11i <limits.h> declares gettimeofday.  */
-#define $2 innocuous_$2
-
-/* System header to define __stub macros and hopefully few prototypes,
-    which can conflict with char $2 (); below.
-    Prefer <limits.h> to <assert.h> if __STDC__ is defined, since
-    <limits.h> exists even on freestanding compilers.  */
-
-#ifdef __STDC__
-# include <limits.h>
-#else
-# include <assert.h>
-#endif
-
-#undef $2
-
-/* Override any GCC internal prototype to avoid an error.
-   Use char because int might match the return type of a GCC
-   builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
-char $2 ();
-/* The GNU C library defines this for functions which it implements
-    to always fail with ENOSYS.  Some functions are actually named
-    something starting with __ and the normal name is an alias.  */
-#if defined __stub_$2 || defined __stub___$2
-choke me
-#endif
+  if { { ac_try="$ac_link"
+case "(($ac_try" in
+  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
+  *) ac_try_echo=$ac_try;;
+esac
+eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
+printf "%s\n" "$ac_try_echo"; } >&5
+  (eval "$ac_link") 2>&5
+  ac_status=$?
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; } && { ac_try='./conftest$ac_exeext'
+  { { case "(($ac_try" in
+  *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
+  *) ac_try_echo=$ac_try;;
+esac
+eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
+printf "%s\n" "$ac_try_echo"; } >&5
+  (eval "$ac_try") 2>&5
+  ac_status=$?
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }; }
+then :
+  ac_retval=0
+else $as_nop
+  printf "%s\n" "$as_me: program exited with status $ac_status" >&5
+       printf "%s\n" "$as_me: failed program was:" >&5
+sed 's/^/| /' conftest.$ac_ext >&5
 
-int
-main ()
-{
-return $2 ();
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  eval "$3=yes"
-else
-  eval "$3=no"
-fi
-rm -f core conftest.err conftest.$ac_objext \
-    conftest$ac_exeext conftest.$ac_ext
+       ac_retval=$ac_status
 fi
-eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+  rm -rf conftest.dSYM conftest_ipa8_conftest.oo
   eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
+  as_fn_set_status $ac_retval
 
-} # ac_fn_c_check_func
+} # ac_fn_c_try_run
 
 # ac_fn_c_compute_int LINENO EXPR VAR INCLUDES
 # --------------------------------------------
@@ -2783,7 +3055,7 @@
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 static int test_array 1 - 2 * !(($2) >= 0);
 test_array 0 = 0;
@@ -2793,14 +3065,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_lo=0 ac_mid=0
   while :; do
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 static int test_array 1 - 2 * !(($2) <= $ac_mid);
 test_array 0 = 0;
@@ -2810,9 +3083,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_hi=$ac_mid; break
-else
+else $as_nop
   as_fn_arith $ac_mid + 1 && ac_lo=$as_val
 			if test $ac_lo -le $ac_mid; then
 			  ac_lo= ac_hi=
@@ -2820,14 +3094,14 @@
 			fi
 			as_fn_arith 2 '*' $ac_mid + 1 && ac_mid=$as_val
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
   done
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 static int test_array 1 - 2 * !(($2) < 0);
 test_array 0 = 0;
@@ -2837,14 +3111,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_hi=-1 ac_mid=-1
   while :; do
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 static int test_array 1 - 2 * !(($2) >= $ac_mid);
 test_array 0 = 0;
@@ -2854,9 +3129,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_lo=$ac_mid; break
-else
+else $as_nop
   as_fn_arith '(' $ac_mid ')' - 1 && ac_hi=$as_val
 			if test $ac_mid -le $ac_hi; then
 			  ac_lo= ac_hi=
@@ -2864,14 +3140,14 @@
 			fi
 			as_fn_arith 2 '*' $ac_mid && ac_mid=$as_val
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
   done
-else
+else $as_nop
   ac_lo= ac_hi=
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 # Binary search between lo and hi bounds.
 while test "x$ac_lo" != "x$ac_hi"; do
   as_fn_arith '(' $ac_hi - $ac_lo ')' / 2 + $ac_lo && ac_mid=$as_val
@@ -2879,7 +3155,7 @@
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 static int test_array 1 - 2 * !(($2) <= $ac_mid);
 test_array 0 = 0;
@@ -2889,12 +3165,13 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_hi=$ac_mid
-else
+else $as_nop
   as_fn_arith '(' $ac_mid ')' + 1 && ac_lo=$as_val
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 done
 case $ac_lo in #((
 ?*) eval "$3=\$ac_lo"; ac_retval=0 ;;
@@ -2904,12 +3181,12 @@
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
-static long int longval () { return $2; }
-static unsigned long int ulongval () { return $2; }
+static long int longval (void) { return $2; }
+static unsigned long int ulongval (void) { return $2; }
 #include <stdio.h>
 #include <stdlib.h>
 int
-main ()
+main (void)
 {
 
   FILE *f = fopen ("conftest.val", "w");
@@ -2937,9 +3214,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   echo >>conftest.val; read $3 <conftest.val; ac_retval=0
-else
+else $as_nop
   ac_retval=1
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -2952,25 +3230,32 @@
 
 } # ac_fn_c_compute_int
 
-# ac_fn_c_check_decl LINENO SYMBOL VAR INCLUDES
-# ---------------------------------------------
+# ac_fn_check_decl LINENO SYMBOL VAR INCLUDES EXTRA-OPTIONS FLAG-VAR
+# ------------------------------------------------------------------
 # Tests whether SYMBOL is declared in INCLUDES, setting cache variable VAR
-# accordingly.
-ac_fn_c_check_decl ()
+# accordingly. Pass EXTRA-OPTIONS to the compiler, using FLAG-VAR.
+ac_fn_check_decl ()
 {
+  ac_save_ac_compile="$ac_compile"
+  if test -n "$ac_compile_for_check_decl"; then
+    ac_compile="$ac_compile_for_check_decl"
+  fi
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
   as_decl_name=`echo $2|sed 's/ *(.*//'`
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $as_decl_name is declared" >&5
+printf %s "checking whether $as_decl_name is declared... " >&6; }
+if eval test \${$3+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   as_decl_use=`echo $2|sed -e 's/(/((/' -e 's/)/) 0&/' -e 's/,/) 0& (/g'`
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $as_decl_name is declared" >&5
-$as_echo_n "checking whether $as_decl_name is declared... " >&6; }
-if eval \${$3+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  eval ac_save_FLAGS=\$$6
+  as_fn_append $6 " $5"
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $4
 int
-main ()
+main (void)
 {
 #ifndef $as_decl_name
 #ifdef __cplusplus
@@ -2984,24 +3269,90 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   eval "$3=yes"
-else
+else $as_nop
   eval "$3=no"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+  eval $6=\$ac_save_FLAGS
+
 fi
 eval ac_res=\$$3
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
   eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
+  ac_compile="$ac_save_ac_compile"
 
-} # ac_fn_c_check_decl
+} # ac_fn_check_decl
+
+# ac_fn_c_check_func LINENO FUNC VAR
+# ----------------------------------
+# Tests whether FUNC exists, setting the cache variable VAR accordingly
+ac_fn_c_check_func ()
+{
+  as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $2" >&5
+printf %s "checking for $2... " >&6; }
+if eval test \${$3+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+/* Define $2 to an innocuous variant, in case <limits.h> declares $2.
+   For example, HP-UX 11i <limits.h> declares gettimeofday.  */
+#define $2 innocuous_$2
+
+/* System header to define __stub macros and hopefully few prototypes,
+   which can conflict with char $2 (); below.  */
+
+#include <limits.h>
+#undef $2
+
+/* Override any GCC internal prototype to avoid an error.
+   Use char because int might match the return type of a GCC
+   builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char $2 ();
+/* The GNU C library defines this for functions which it implements
+    to always fail with ENOSYS.  Some functions are actually named
+    something starting with __ and the normal name is an alias.  */
+#if defined __stub_$2 || defined __stub___$2
+choke me
+#endif
+
+int
+main (void)
+{
+return $2 ();
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_link "$LINENO"
+then :
+  eval "$3=yes"
+else $as_nop
+  eval "$3=no"
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
+    conftest$ac_exeext conftest.$ac_ext
+fi
+eval ac_res=\$$3
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
+  eval $as_lineno_stack; ${as_lineno_stack:+:} unset as_lineno
+
+} # ac_fn_c_check_func
 
 # ac_fn_cxx_try_run LINENO
 # ------------------------
-# Try to link conftest.$ac_ext, and return whether this succeeded. Assumes
-# that executables *can* be run.
+# Try to run conftest.$ac_ext, and return whether this succeeded. Assumes that
+# executables *can* be run.
 ac_fn_cxx_try_run ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
@@ -3011,25 +3362,26 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && { ac_try='./conftest$ac_exeext'
   { { case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_try") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; }; then :
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }; }
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: program exited with status $ac_status" >&5
-       $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: program exited with status $ac_status" >&5
+       printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
        ac_retval=$ac_status
@@ -3046,14 +3398,14 @@
 ac_fn_cxx_try_link ()
 {
   as_lineno=${as_lineno-"$1"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-  rm -f conftest.$ac_objext conftest$ac_exeext
+  rm -f conftest.$ac_objext conftest.beam conftest$ac_exeext
   if { { ac_try="$ac_link"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -3061,17 +3413,18 @@
     cat conftest.er1 >&5
     mv -f conftest.er1 conftest.err
   fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && {
 	 test -z "$ac_cxx_werror_flag" ||
 	 test ! -s conftest.err
        } && test -s conftest$ac_exeext && {
 	 test "$cross_compiling" = yes ||
 	 test -x conftest$ac_exeext
-       }; then :
+       }
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
 	ac_retval=1
@@ -3098,7 +3451,7 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_cpp conftest.$ac_ext") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -3106,14 +3459,15 @@
     cat conftest.er1 >&5
     mv -f conftest.er1 conftest.err
   fi
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } > conftest.i && {
 	 test -z "$ac_cxx_preproc_warn_flag$ac_cxx_werror_flag" ||
 	 test ! -s conftest.err
-       }; then :
+       }
+then :
   ac_retval=0
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
     ac_retval=1
@@ -3122,14 +3476,34 @@
   as_fn_set_status $ac_retval
 
 } # ac_fn_cxx_try_cpp
+ac_configure_args_raw=
+for ac_arg
+do
+  case $ac_arg in
+  *\'*)
+    ac_arg=`printf "%s\n" "$ac_arg" | sed "s/'/'\\\\\\\\''/g"` ;;
+  esac
+  as_fn_append ac_configure_args_raw " '$ac_arg'"
+done
+
+case $ac_configure_args_raw in
+  *$as_nl*)
+    ac_safe_unquote= ;;
+  *)
+    ac_unsafe_z='|&;<>()$`\\"*? ''	' # This string ends in space, tab.
+    ac_unsafe_a="$ac_unsafe_z#~"
+    ac_safe_unquote="s/ '\$^$ac_unsafe_a^$ac_unsafe_z*\$'/ \\1/g"
+    ac_configure_args_raw=`      printf "%s\n" "$ac_configure_args_raw" | sed "$ac_safe_unquote"`;;
+esac
+
 cat >config.log <<_ACEOF
 This file contains any messages produced by compilers while
 running configure, to aid debugging if configure makes a mistake.
 
-It was created by GNU Troff $as_me 1.22.4, which was
-generated by GNU Autoconf 2.69.  Invocation command line was
+It was created by GNU roff $as_me 1.23.0, which was
+generated by GNU Autoconf 2.71.  Invocation command line was
 
-  $ $0 $@
+  $ $0$ac_configure_args_raw
 
 _ACEOF
 exec 5>>config.log
@@ -3162,8 +3536,12 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    $as_echo "PATH: $as_dir"
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    printf "%s\n" "PATH: $as_dir"
   done
 IFS=$as_save_IFS
 
@@ -3198,7 +3576,7 @@
     | -silent | --silent | --silen | --sile | --sil)
       continue ;;
     *\'*)
-      ac_arg=`$as_echo "$ac_arg" | sed "s/'/'\\\\\\\\''/g"` ;;
+      ac_arg=`printf "%s\n" "$ac_arg" | sed "s/'/'\\\\\\\\''/g"` ;;
     esac
     case $ac_pass in
     1) as_fn_append ac_configure_args0 " '$ac_arg'" ;;
@@ -3233,11 +3611,13 @@
 # WARNING: Use '\'' to represent an apostrophe within the trap.
 # WARNING: Do not start the trap code with a newline, due to a FreeBSD 4.0 bug.
 trap 'exit_status=$?
+  # Sanitize IFS.
+  IFS=" ""	$as_nl"
   # Save into config.log some information that might help in debugging.
   {
     echo
 
-    $as_echo "## ---------------- ##
+    printf "%s\n" "## ---------------- ##
 ## Cache variables. ##
 ## ---------------- ##"
     echo
@@ -3248,8 +3628,8 @@
     case $ac_val in #(
     *${as_nl}*)
       case $ac_var in #(
-      *_cv_*) { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: cache variable $ac_var contains a newline" >&5
-$as_echo "$as_me: WARNING: cache variable $ac_var contains a newline" >&2;} ;;
+      *_cv_*) { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: cache variable $ac_var contains a newline" >&5
+printf "%s\n" "$as_me: WARNING: cache variable $ac_var contains a newline" >&2;} ;;
       esac
       case $ac_var in #(
       _ | IFS | as_nl) ;; #(
@@ -3273,7 +3653,7 @@
 )
     echo
 
-    $as_echo "## ----------------- ##
+    printf "%s\n" "## ----------------- ##
 ## Output variables. ##
 ## ----------------- ##"
     echo
@@ -3281,14 +3661,14 @@
     do
       eval ac_val=\$$ac_var
       case $ac_val in
-      *\'\''*) ac_val=`$as_echo "$ac_val" | sed "s/'\''/'\''\\\\\\\\'\'''\''/g"`;;
+      *\'\''*) ac_val=`printf "%s\n" "$ac_val" | sed "s/'\''/'\''\\\\\\\\'\'''\''/g"`;;
       esac
-      $as_echo "$ac_var='\''$ac_val'\''"
+      printf "%s\n" "$ac_var='\''$ac_val'\''"
     done | sort
     echo
 
     if test -n "$ac_subst_files"; then
-      $as_echo "## ------------------- ##
+      printf "%s\n" "## ------------------- ##
 ## File substitutions. ##
 ## ------------------- ##"
       echo
@@ -3296,15 +3676,15 @@
       do
 	eval ac_val=\$$ac_var
 	case $ac_val in
-	*\'\''*) ac_val=`$as_echo "$ac_val" | sed "s/'\''/'\''\\\\\\\\'\'''\''/g"`;;
+	*\'\''*) ac_val=`printf "%s\n" "$ac_val" | sed "s/'\''/'\''\\\\\\\\'\'''\''/g"`;;
 	esac
-	$as_echo "$ac_var='\''$ac_val'\''"
+	printf "%s\n" "$ac_var='\''$ac_val'\''"
       done | sort
       echo
     fi
 
     if test -s confdefs.h; then
-      $as_echo "## ----------- ##
+      printf "%s\n" "## ----------- ##
 ## confdefs.h. ##
 ## ----------- ##"
       echo
@@ -3312,8 +3692,8 @@
       echo
     fi
     test "$ac_signal" != 0 &&
-      $as_echo "$as_me: caught signal $ac_signal"
-    $as_echo "$as_me: exit $exit_status"
+      printf "%s\n" "$as_me: caught signal $ac_signal"
+    printf "%s\n" "$as_me: exit $exit_status"
   } >&5
   rm -f core *.core core.conftest.* &&
     rm -f -r conftest* confdefs* conf$$* $ac_clean_files &&
@@ -3327,63 +3707,48 @@
 # confdefs.h avoids OS command line length limits that DEFS can exceed.
 rm -f -r conftest* confdefs.h
 
-$as_echo "/* confdefs.h */" > confdefs.h
+printf "%s\n" "/* confdefs.h */" > confdefs.h
 
 # Predefined preprocessor variables.
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_NAME "$PACKAGE_NAME"
-_ACEOF
+printf "%s\n" "#define PACKAGE_NAME \"$PACKAGE_NAME\"" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_TARNAME "$PACKAGE_TARNAME"
-_ACEOF
+printf "%s\n" "#define PACKAGE_TARNAME \"$PACKAGE_TARNAME\"" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_VERSION "$PACKAGE_VERSION"
-_ACEOF
+printf "%s\n" "#define PACKAGE_VERSION \"$PACKAGE_VERSION\"" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_STRING "$PACKAGE_STRING"
-_ACEOF
+printf "%s\n" "#define PACKAGE_STRING \"$PACKAGE_STRING\"" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_BUGREPORT "$PACKAGE_BUGREPORT"
-_ACEOF
+printf "%s\n" "#define PACKAGE_BUGREPORT \"$PACKAGE_BUGREPORT\"" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE_URL "$PACKAGE_URL"
-_ACEOF
+printf "%s\n" "#define PACKAGE_URL \"$PACKAGE_URL\"" >>confdefs.h
 
 
 # Let the site file select an alternate cache file if it wants to.
 # Prefer an explicitly selected file to automatically selected ones.
-ac_site_file1=NONE
-ac_site_file2=NONE
 if test -n "$CONFIG_SITE"; then
-  # We do not want a PATH search for config.site.
-  case $CONFIG_SITE in #((
-    -*)  ac_site_file1=./$CONFIG_SITE;;
-    */*) ac_site_file1=$CONFIG_SITE;;
-    *)   ac_site_file1=./$CONFIG_SITE;;
-  esac
+  ac_site_files="$CONFIG_SITE"
 elif test "x$prefix" != xNONE; then
-  ac_site_file1=$prefix/share/config.site
-  ac_site_file2=$prefix/etc/config.site
+  ac_site_files="$prefix/share/config.site $prefix/etc/config.site"
 else
-  ac_site_file1=$ac_default_prefix/share/config.site
-  ac_site_file2=$ac_default_prefix/etc/config.site
+  ac_site_files="$ac_default_prefix/share/config.site $ac_default_prefix/etc/config.site"
 fi
-for ac_site_file in "$ac_site_file1" "$ac_site_file2"
+
+for ac_site_file in $ac_site_files
 do
-  test "x$ac_site_file" = xNONE && continue
-  if test /dev/null != "$ac_site_file" && test -r "$ac_site_file"; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: loading site script $ac_site_file" >&5
-$as_echo "$as_me: loading site script $ac_site_file" >&6;}
+  case $ac_site_file in #(
+  */*) :
+     ;; #(
+  *) :
+    ac_site_file=./$ac_site_file ;;
+esac
+  if test -f "$ac_site_file" && test -r "$ac_site_file"; then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: loading site script $ac_site_file" >&5
+printf "%s\n" "$as_me: loading site script $ac_site_file" >&6;}
     sed 's/^/| /' "$ac_site_file" >&5
     . "$ac_site_file" \
-      || { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+      || { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "failed to load site script $ac_site_file
 See \`config.log' for more details" "$LINENO" 5; }
   fi
@@ -3393,38 +3758,667 @@
   # Some versions of bash will fail to source /dev/null (special files
   # actually), so we avoid doing that.  DJGPP emulates it as a regular file.
   if test /dev/null != "$cache_file" && test -f "$cache_file"; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: loading cache $cache_file" >&5
-$as_echo "$as_me: loading cache $cache_file" >&6;}
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: loading cache $cache_file" >&5
+printf "%s\n" "$as_me: loading cache $cache_file" >&6;}
     case $cache_file in
       \\/* | ?:\\/* ) . "$cache_file";;
       *)                      . "./$cache_file";;
     esac
   fi
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: creating cache $cache_file" >&5
-$as_echo "$as_me: creating cache $cache_file" >&6;}
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: creating cache $cache_file" >&5
+printf "%s\n" "$as_me: creating cache $cache_file" >&6;}
   >$cache_file
 fi
 
-as_fn_append ac_func_list " vasnprintf"
-as_fn_append ac_header_list " features.h"
-as_fn_append ac_func_list " snprintf"
-as_fn_append ac_func_list " __fseterr"
-as_fn_append ac_header_list " limits.h"
-as_fn_append ac_header_list " unistd.h"
-as_fn_append ac_func_list " symlink"
-as_fn_append ac_header_list " math.h"
-as_fn_append ac_header_list " sys/mman.h"
-as_fn_append ac_func_list " mprotect"
+as_fn_append ac_header_c_list " stdio.h stdio_h HAVE_STDIO_H"
+# Test code for whether the C compiler supports C89 (global declarations)
+ac_c_conftest_c89_globals='
+/* Does the compiler advertise C89 conformance?
+   Do not test the value of __STDC__, because some compilers set it to 0
+   while being otherwise adequately conformant. */
+#if !defined __STDC__
+# error "Compiler does not advertise C89 conformance"
+#endif
+
+#include <stddef.h>
+#include <stdarg.h>
+struct stat;
+/* Most of the following tests are stolen from RCS 5.7 src/conf.sh.  */
+struct buf { int x; };
+struct buf * (*rcsopen) (struct buf *, struct stat *, int);
+static char *e (p, i)
+     char **p;
+     int i;
+{
+  return pi;
+}
+static char *f (char * (*g) (char **, int), char **p, ...)
+{
+  char *s;
+  va_list v;
+  va_start (v,p);
+  s = g (p, va_arg (v,int));
+  va_end (v);
+  return s;
+}
+
+/* OSF 4.0 Compaq cc is some sort of almost-ANSI by default.  It has
+   function prototypes and stuff, but not \xHH hex character constants.
+   These do not provoke an error unfortunately, instead are silently treated
+   as an "x".  The following induces an error, until -std is added to get
+   proper ANSI mode.  Curiously \x00 != x always comes out true, for an
+   array size at least.  It is necessary to write \x00 == 0 to get something
+   that is true only with -std.  */
+int osf4_cc_array '\''\x00'\'' == 0 ? 1 : -1;
+
+/* IBM C 6 for AIX is almost-ANSI by default, but it replaces macro parameters
+   inside strings and character constants.  */
+#define FOO(x) '\''x'\''
+int xlc6_cc_arrayFOO(a) == '\''x'\'' ? 1 : -1;
+
+int test (int i, double x);
+struct s1 {int (*f) (int a);};
+struct s2 {int (*f) (double a);};
+int pairnames (int, char **, int *(*)(struct buf *, struct stat *, int),
+               int, int);'
+
+# Test code for whether the C compiler supports C89 (body of main).
+ac_c_conftest_c89_main='
+ok |= (argc == 0 || f (e, argv, 0) != argv0 || f (e, argv, 1) != argv1);
+'
+
+# Test code for whether the C compiler supports C99 (global declarations)
+ac_c_conftest_c99_globals='
+// Does the compiler advertise C99 conformance?
+#if !defined __STDC_VERSION__ || __STDC_VERSION__ < 199901L
+# error "Compiler does not advertise C99 conformance"
+#endif
+
+#include <stdbool.h>
+extern int puts (const char *);
+extern int printf (const char *, ...);
+extern int dprintf (int, const char *, ...);
+extern void *malloc (size_t);
+
+// Check varargs macros.  These examples are taken from C99 6.10.3.5.
+// dprintf is used instead of fprintf to avoid needing to declare
+// FILE and stderr.
+#define debug(...) dprintf (2, __VA_ARGS__)
+#define showlist(...) puts (#__VA_ARGS__)
+#define report(test,...) ((test) ? puts (#test) : printf (__VA_ARGS__))
+static void
+test_varargs_macros (void)
+{
+  int x = 1234;
+  int y = 5678;
+  debug ("Flag");
+  debug ("X = %d\n", x);
+  showlist (The first, second, and third items.);
+  report (x>y, "x is %d but y is %d", x, y);
+}
+
+// Check long long types.
+#define BIG64 18446744073709551615ull
+#define BIG32 4294967295ul
+#define BIG_OK (BIG64 / BIG32 == 4294967297ull && BIG64 % BIG32 == 0)
+#if !BIG_OK
+  #error "your preprocessor is broken"
+#endif
+#if BIG_OK
+#else
+  #error "your preprocessor is broken"
+#endif
+static long long int bignum = -9223372036854775807LL;
+static unsigned long long int ubignum = BIG64;
+
+struct incomplete_array
+{
+  int datasize;
+  double data;
+};
+
+struct named_init {
+  int number;
+  const wchar_t *name;
+  double average;
+};
+
+typedef const char *ccp;
+
+static inline int
+test_restrict (ccp restrict text)
+{
+  // See if C++-style comments work.
+  // Iterate through items via the restricted pointer.
+  // Also check for declarations in for loops.
+  for (unsigned int i = 0; *(text+i) != '\''\0'\''; ++i)
+    continue;
+  return 0;
+}
+
+// Check varargs and va_copy.
+static bool
+test_varargs (const char *format, ...)
+{
+  va_list args;
+  va_start (args, format);
+  va_list args_copy;
+  va_copy (args_copy, args);
+
+  const char *str = "";
+  int number = 0;
+  float fnumber = 0;
+
+  while (*format)
+    {
+      switch (*format++)
+	{
+	case '\''s'\'': // string
+	  str = va_arg (args_copy, const char *);
+	  break;
+	case '\''d'\'': // int
+	  number = va_arg (args_copy, int);
+	  break;
+	case '\''f'\'': // float
+	  fnumber = va_arg (args_copy, double);
+	  break;
+	default:
+	  break;
+	}
+    }
+  va_end (args_copy);
+  va_end (args);
+
+  return *str && number && fnumber;
+}
+'
+
+# Test code for whether the C compiler supports C99 (body of main).
+ac_c_conftest_c99_main='
+  // Check bool.
+  _Bool success = false;
+  success |= (argc != 0);
+
+  // Check restrict.
+  if (test_restrict ("String literal") == 0)
+    success = true;
+  char *restrict newvar = "Another string";
+
+  // Check varargs.
+  success &= test_varargs ("s, d'\'' f .", "string", 65, 34.234);
+  test_varargs_macros ();
+
+  // Check flexible array members.
+  struct incomplete_array *ia =
+    malloc (sizeof (struct incomplete_array) + (sizeof (double) * 10));
+  ia->datasize = 10;
+  for (int i = 0; i < ia->datasize; ++i)
+    ia->datai = i * 1.234;
+
+  // Check named initializers.
+  struct named_init ni = {
+    .number = 34,
+    .name = L"Test wide string",
+    .average = 543.34343,
+  };
+
+  ni.number = 58;
+
+  int dynamic_arrayni.number;
+  dynamic_array0 = argv00;
+  dynamic_arrayni.number - 1 = 543;
+
+  // work around unused variable warnings
+  ok |= (!success || bignum == 0LL || ubignum == 0uLL || newvar0 == '\''x'\''
+	 || dynamic_arrayni.number - 1 != 543);
+'
+
+# Test code for whether the C compiler supports C11 (global declarations)
+ac_c_conftest_c11_globals='
+// Does the compiler advertise C11 conformance?
+#if !defined __STDC_VERSION__ || __STDC_VERSION__ < 201112L
+# error "Compiler does not advertise C11 conformance"
+#endif
+
+// Check _Alignas.
+char _Alignas (double) aligned_as_double;
+char _Alignas (0) no_special_alignment;
+extern char aligned_as_int;
+char _Alignas (0) _Alignas (int) aligned_as_int;
+
+// Check _Alignof.
+enum
+{
+  int_alignment = _Alignof (int),
+  int_array_alignment = _Alignof (int100),
+  char_alignment = _Alignof (char)
+};
+_Static_assert (0 < -_Alignof (int), "_Alignof is signed");
+
+// Check _Noreturn.
+int _Noreturn does_not_return (void) { for (;;) continue; }
+
+// Check _Static_assert.
+struct test_static_assert
+{
+  int x;
+  _Static_assert (sizeof (int) <= sizeof (long int),
+                  "_Static_assert does not work in struct");
+  long int y;
+};
+
+// Check UTF-8 literals.
+#define u8 syntax error!
+char const utf8_literal = u8"happens to be ASCII" "another string";
+
+// Check duplicate typedefs.
+typedef long *long_ptr;
+typedef long int *long_ptr;
+typedef long_ptr long_ptr;
+
+// Anonymous structures and unions -- taken from C11 6.7.2.1 Example 1.
+struct anonymous
+{
+  union {
+    struct { int i; int j; };
+    struct { int k; long int l; } w;
+  };
+  int m;
+} v1;
+'
+
+# Test code for whether the C compiler supports C11 (body of main).
+ac_c_conftest_c11_main='
+  _Static_assert ((offsetof (struct anonymous, i)
+		   == offsetof (struct anonymous, w.k)),
+		  "Anonymous union alignment botch");
+  v1.i = 2;
+  v1.w.k = 5;
+  ok |= v1.i != 5;
+'
+
+# Test code for whether the C compiler supports C11 (complete).
+ac_c_conftest_c11_program="${ac_c_conftest_c89_globals}
+${ac_c_conftest_c99_globals}
+${ac_c_conftest_c11_globals}
+
+int
+main (int argc, char **argv)
+{
+  int ok = 0;
+  ${ac_c_conftest_c89_main}
+  ${ac_c_conftest_c99_main}
+  ${ac_c_conftest_c11_main}
+  return ok;
+}
+"
+
+# Test code for whether the C compiler supports C99 (complete).
+ac_c_conftest_c99_program="${ac_c_conftest_c89_globals}
+${ac_c_conftest_c99_globals}
+
+int
+main (int argc, char **argv)
+{
+  int ok = 0;
+  ${ac_c_conftest_c89_main}
+  ${ac_c_conftest_c99_main}
+  return ok;
+}
+"
+
+# Test code for whether the C compiler supports C89 (complete).
+ac_c_conftest_c89_program="${ac_c_conftest_c89_globals}
+
+int
+main (int argc, char **argv)
+{
+  int ok = 0;
+  ${ac_c_conftest_c89_main}
+  return ok;
+}
+"
+
+as_fn_append ac_header_c_list " stdlib.h stdlib_h HAVE_STDLIB_H"
+as_fn_append ac_header_c_list " string.h string_h HAVE_STRING_H"
+as_fn_append ac_header_c_list " inttypes.h inttypes_h HAVE_INTTYPES_H"
+as_fn_append ac_header_c_list " stdint.h stdint_h HAVE_STDINT_H"
+as_fn_append ac_header_c_list " strings.h strings_h HAVE_STRINGS_H"
+as_fn_append ac_header_c_list " sys/stat.h sys_stat_h HAVE_SYS_STAT_H"
+as_fn_append ac_header_c_list " sys/types.h sys_types_h HAVE_SYS_TYPES_H"
+as_fn_append ac_header_c_list " unistd.h unistd_h HAVE_UNISTD_H"
+as_fn_append ac_header_c_list " wchar.h wchar_h HAVE_WCHAR_H"
+as_fn_append ac_header_c_list " minix/config.h minix_config_h HAVE_MINIX_CONFIG_H"
+# Test code for whether the C++ compiler supports C++98 (global declarations)
+ac_cxx_conftest_cxx98_globals='
+// Does the compiler advertise C++98 conformance?
+#if !defined __cplusplus || __cplusplus < 199711L
+# error "Compiler does not advertise C++98 conformance"
+#endif
+
+// These inclusions are to reject old compilers that
+// lack the unsuffixed header files.
+#include <cstdlib>
+#include <exception>
+
+// <cassert> and <cstring> are *not* freestanding headers in C++98.
+extern void assert (int);
+namespace std {
+  extern int strcmp (const char *, const char *);
+}
+
+// Namespaces, exceptions, and templates were all added after "C++ 2.0".
+using std::exception;
+using std::strcmp;
+
+namespace {
+
+void test_exception_syntax()
+{
+  try {
+    throw "test";
+  } catch (const char *s) {
+    // Extra parentheses suppress a warning when building autoconf itself,
+    // due to lint rules shared with more typical C programs.
+    assert (!(strcmp) (s, "test"));
+  }
+}
+
+template <typename T> struct test_template
+{
+  T const val;
+  explicit test_template(T t) : val(t) {}
+  template <typename U> T add(U u) { return static_cast<T>(u) + val; }
+};
+
+} // anonymous namespace
+'
+
+# Test code for whether the C++ compiler supports C++98 (body of main)
+ac_cxx_conftest_cxx98_main='
+  assert (argc);
+  assert (! argv0);
+{
+  test_exception_syntax ();
+  test_template<double> tt (2.0);
+  assert (tt.add (4) == 6.0);
+  assert (true && !false);
+}
+'
+
+# Test code for whether the C++ compiler supports C++11 (global declarations)
+ac_cxx_conftest_cxx11_globals='
+// Does the compiler advertise C++ 2011 conformance?
+#if !defined __cplusplus || __cplusplus < 201103L
+# error "Compiler does not advertise C++11 conformance"
+#endif
+
+namespace cxx11test
+{
+  constexpr int get_val() { return 20; }
+
+  struct testinit
+  {
+    int i;
+    double d;
+  };
+
+  class delegate
+  {
+  public:
+    delegate(int n) : n(n) {}
+    delegate(): delegate(2354) {}
+
+    virtual int getval() { return this->n; };
+  protected:
+    int n;
+  };
+
+  class overridden : public delegate
+  {
+  public:
+    overridden(int n): delegate(n) {}
+    virtual int getval() override final { return this->n * 2; }
+  };
+
+  class nocopy
+  {
+  public:
+    nocopy(int i): i(i) {}
+    nocopy() = default;
+    nocopy(const nocopy&) = delete;
+    nocopy & operator=(const nocopy&) = delete;
+  private:
+    int i;
+  };
+
+  // for testing lambda expressions
+  template <typename Ret, typename Fn> Ret eval(Fn f, Ret v)
+  {
+    return f(v);
+  }
+
+  // for testing variadic templates and trailing return types
+  template <typename V> auto sum(V first) -> V
+  {
+    return first;
+  }
+  template <typename V, typename... Args> auto sum(V first, Args... rest) -> V
+  {
+    return first + sum(rest...);
+  }
+}
+'
+
+# Test code for whether the C++ compiler supports C++11 (body of main)
+ac_cxx_conftest_cxx11_main='
+{
+  // Test auto and decltype
+  auto a1 = 6538;
+  auto a2 = 48573953.4;
+  auto a3 = "String literal";
+
+  int total = 0;
+  for (auto i = a3; *i; ++i) { total += *i; }
+
+  decltype(a2) a4 = 34895.034;
+}
+{
+  // Test constexpr
+  short sacxx11test::get_val() = { 0 };
+}
+{
+  // Test initializer lists
+  cxx11test::testinit il = { 4323, 435234.23544 };
+}
+{
+  // Test range-based for
+  int array = {9, 7, 13, 15, 4, 18, 12, 10, 5, 3,
+                 14, 19, 17, 8, 6, 20, 16, 2, 11, 1};
+  for (auto &x : array) { x += 23; }
+}
+{
+  // Test lambda expressions
+  using cxx11test::eval;
+  assert (eval ((int x) { return x*2; }, 21) == 42);
+  double d = 2.0;
+  assert (eval (&(double x) { return d += x; }, 3.0) == 5.0);
+  assert (d == 5.0);
+  assert (eval (=(double x) mutable { return d += x; }, 4.0) == 9.0);
+  assert (d == 5.0);
+}
+{
+  // Test use of variadic templates
+  using cxx11test::sum;
+  auto a = sum(1);
+  auto b = sum(1, 2);
+  auto c = sum(1.0, 2.0, 3.0);
+}
+{
+  // Test constructor delegation
+  cxx11test::delegate d1;
+  cxx11test::delegate d2();
+  cxx11test::delegate d3(45);
+}
+{
+  // Test override and final
+  cxx11test::overridden o1(55464);
+}
+{
+  // Test nullptr
+  char *c = nullptr;
+}
+{
+  // Test template brackets
+  test_template<::test_template<int>> v(test_template<int>(12));
+}
+{
+  // Unicode literals
+  char const *utf8 = u8"UTF-8 string \u2500";
+  char16_t const *utf16 = u"UTF-8 string \u2500";
+  char32_t const *utf32 = U"UTF-32 string \u2500";
+}
+'
+
+# Test code for whether the C compiler supports C++11 (complete).
+ac_cxx_conftest_cxx11_program="${ac_cxx_conftest_cxx98_globals}
+${ac_cxx_conftest_cxx11_globals}
+
+int
+main (int argc, char **argv)
+{
+  int ok = 0;
+  ${ac_cxx_conftest_cxx98_main}
+  ${ac_cxx_conftest_cxx11_main}
+  return ok;
+}
+"
+
+# Test code for whether the C compiler supports C++98 (complete).
+ac_cxx_conftest_cxx98_program="${ac_cxx_conftest_cxx98_globals}
+int
+main (int argc, char **argv)
+{
+  int ok = 0;
+  ${ac_cxx_conftest_cxx98_main}
+  return ok;
+}
+"
+
+as_fn_append ac_func_c_list " vasnprintf HAVE_VASNPRINTF"
+as_fn_append ac_header_c_list " features.h features_h HAVE_FEATURES_H"
+as_fn_append ac_func_c_list " snprintf HAVE_SNPRINTF"
+as_fn_append ac_header_c_list " limits.h limits_h HAVE_LIMITS_H"
+as_fn_append ac_func_c_list " symlink HAVE_SYMLINK"
+as_fn_append ac_header_c_list " math.h math_h HAVE_MATH_H"
+as_fn_append ac_header_c_list " sys/mman.h sys_mman_h HAVE_SYS_MMAN_H"
+as_fn_append ac_func_c_list " mprotect HAVE_MPROTECT"
 gl_printf_safe=yes
-as_fn_append ac_header_list " wchar.h"
-as_fn_append ac_header_list " stdint.h"
-as_fn_append ac_header_list " crtdefs.h"
-as_fn_append ac_func_list " iswcntrl"
-as_fn_append ac_header_list " wctype.h"
-as_fn_append ac_func_list " wcwidth"
-as_fn_append ac_header_list " stdlib.h"
-as_fn_append ac_header_list " sys/param.h"
+as_fn_append ac_header_c_list " crtdefs.h crtdefs_h HAVE_CRTDEFS_H"
+as_fn_append ac_func_c_list " iswcntrl HAVE_ISWCNTRL"
+as_fn_append ac_header_c_list " wctype.h wctype_h HAVE_WCTYPE_H"
+as_fn_append ac_func_c_list " wcwidth HAVE_WCWIDTH"
+as_fn_append ac_header_c_list " sys/param.h sys_param_h HAVE_SYS_PARAM_H"
+as_fn_append ac_func_c_list " getpagesize HAVE_GETPAGESIZE"
+
+# Auxiliary files required by this configure script.
+ac_aux_files="config.rpath config.guess config.sub missing install-sh compile"
+
+# Locations in which to look for auxiliary files.
+ac_aux_dir_candidates="${srcdir}/build-aux"
+
+# Search for a directory containing all of the required auxiliary files,
+# $ac_aux_files, from the $PATH-style list $ac_aux_dir_candidates.
+# If we don't find one directory that contains all the files we need,
+# we report the set of missing files from the *first* directory in
+# $ac_aux_dir_candidates and give up.
+ac_missing_aux_files=""
+ac_first_candidate=:
+printf "%s\n" "$as_me:${as_lineno-$LINENO}: looking for aux files: $ac_aux_files" >&5
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+as_found=false
+for as_dir in $ac_aux_dir_candidates
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+  as_found=:
+
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}:  trying $as_dir" >&5
+  ac_aux_dir_found=yes
+  ac_install_sh=
+  for ac_aux in $ac_aux_files
+  do
+    # As a special case, if "install-sh" is required, that requirement
+    # can be satisfied by any of "install-sh", "install.sh", or "shtool",
+    # and $ac_install_sh is set appropriately for whichever one is found.
+    if test x"$ac_aux" = x"install-sh"
+    then
+      if test -f "${as_dir}install-sh"; then
+        printf "%s\n" "$as_me:${as_lineno-$LINENO}:   ${as_dir}install-sh found" >&5
+        ac_install_sh="${as_dir}install-sh -c"
+      elif test -f "${as_dir}install.sh"; then
+        printf "%s\n" "$as_me:${as_lineno-$LINENO}:   ${as_dir}install.sh found" >&5
+        ac_install_sh="${as_dir}install.sh -c"
+      elif test -f "${as_dir}shtool"; then
+        printf "%s\n" "$as_me:${as_lineno-$LINENO}:   ${as_dir}shtool found" >&5
+        ac_install_sh="${as_dir}shtool install -c"
+      else
+        ac_aux_dir_found=no
+        if $ac_first_candidate; then
+          ac_missing_aux_files="${ac_missing_aux_files} install-sh"
+        else
+          break
+        fi
+      fi
+    else
+      if test -f "${as_dir}${ac_aux}"; then
+        printf "%s\n" "$as_me:${as_lineno-$LINENO}:   ${as_dir}${ac_aux} found" >&5
+      else
+        ac_aux_dir_found=no
+        if $ac_first_candidate; then
+          ac_missing_aux_files="${ac_missing_aux_files} ${ac_aux}"
+        else
+          break
+        fi
+      fi
+    fi
+  done
+  if test "$ac_aux_dir_found" = yes; then
+    ac_aux_dir="$as_dir"
+    break
+  fi
+  ac_first_candidate=false
+
+  as_found=false
+done
+IFS=$as_save_IFS
+if $as_found
+then :
+
+else $as_nop
+  as_fn_error $? "cannot find required auxiliary files:$ac_missing_aux_files" "$LINENO" 5
+fi
+
+
+# These three variables are undocumented and unsupported,
+# and are intended to be withdrawn in a future Autoconf release.
+# They can cause serious problems if a builder's source tree is in a directory
+# whose full name contains unusual characters.
+if test -f "${ac_aux_dir}config.guess"; then
+  ac_config_guess="$SHELL ${ac_aux_dir}config.guess"
+fi
+if test -f "${ac_aux_dir}config.sub"; then
+  ac_config_sub="$SHELL ${ac_aux_dir}config.sub"
+fi
+if test -f "$ac_aux_dir/configure"; then
+  ac_configure="$SHELL ${ac_aux_dir}configure"
+fi
+
 # Check that the precious variables saved in the cache have kept the same
 # value.
 ac_cache_corrupted=false
@@ -3435,12 +4429,12 @@
   eval ac_new_val=\$ac_env_${ac_var}_value
   case $ac_old_set,$ac_new_set in
     set,)
-      { $as_echo "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' was set to \`$ac_old_val' in the previous run" >&5
-$as_echo "$as_me: error: \`$ac_var' was set to \`$ac_old_val' in the previous run" >&2;}
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' was set to \`$ac_old_val' in the previous run" >&5
+printf "%s\n" "$as_me: error: \`$ac_var' was set to \`$ac_old_val' in the previous run" >&2;}
       ac_cache_corrupted=: ;;
     ,set)
-      { $as_echo "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' was not set in the previous run" >&5
-$as_echo "$as_me: error: \`$ac_var' was not set in the previous run" >&2;}
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' was not set in the previous run" >&5
+printf "%s\n" "$as_me: error: \`$ac_var' was not set in the previous run" >&2;}
       ac_cache_corrupted=: ;;
     ,);;
     *)
@@ -3449,24 +4443,24 @@
 	ac_old_val_w=`echo x $ac_old_val`
 	ac_new_val_w=`echo x $ac_new_val`
 	if test "$ac_old_val_w" != "$ac_new_val_w"; then
-	  { $as_echo "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' has changed since the previous run:" >&5
-$as_echo "$as_me: error: \`$ac_var' has changed since the previous run:" >&2;}
+	  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: \`$ac_var' has changed since the previous run:" >&5
+printf "%s\n" "$as_me: error: \`$ac_var' has changed since the previous run:" >&2;}
 	  ac_cache_corrupted=:
 	else
-	  { $as_echo "$as_me:${as_lineno-$LINENO}: warning: ignoring whitespace changes in \`$ac_var' since the previous run:" >&5
-$as_echo "$as_me: warning: ignoring whitespace changes in \`$ac_var' since the previous run:" >&2;}
+	  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: warning: ignoring whitespace changes in \`$ac_var' since the previous run:" >&5
+printf "%s\n" "$as_me: warning: ignoring whitespace changes in \`$ac_var' since the previous run:" >&2;}
 	  eval $ac_var=\$ac_old_val
 	fi
-	{ $as_echo "$as_me:${as_lineno-$LINENO}:   former value:  \`$ac_old_val'" >&5
-$as_echo "$as_me:   former value:  \`$ac_old_val'" >&2;}
-	{ $as_echo "$as_me:${as_lineno-$LINENO}:   current value: \`$ac_new_val'" >&5
-$as_echo "$as_me:   current value: \`$ac_new_val'" >&2;}
+	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}:   former value:  \`$ac_old_val'" >&5
+printf "%s\n" "$as_me:   former value:  \`$ac_old_val'" >&2;}
+	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}:   current value: \`$ac_new_val'" >&5
+printf "%s\n" "$as_me:   current value: \`$ac_new_val'" >&2;}
       fi;;
   esac
   # Pass precious variables to config.status.
   if test "$ac_new_set" = set; then
     case $ac_new_val in
-    *\'*) ac_arg=$ac_var=`$as_echo "$ac_new_val" | sed "s/'/'\\\\\\\\''/g"` ;;
+    *\'*) ac_arg=$ac_var=`printf "%s\n" "$ac_new_val" | sed "s/'/'\\\\\\\\''/g"` ;;
     *) ac_arg=$ac_var=$ac_new_val ;;
     esac
     case " $ac_configure_args " in
@@ -3476,11 +4470,12 @@
   fi
 done
 if $ac_cache_corrupted; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-  { $as_echo "$as_me:${as_lineno-$LINENO}: error: changes in the environment can compromise the build" >&5
-$as_echo "$as_me: error: changes in the environment can compromise the build" >&2;}
-  as_fn_error $? "run \`make distclean' and/or \`rm $cache_file' and start over" "$LINENO" 5
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: changes in the environment can compromise the build" >&5
+printf "%s\n" "$as_me: error: changes in the environment can compromise the build" >&2;}
+  as_fn_error $? "run \`${MAKE-make} distclean' and/or \`rm $cache_file'
+	    and start over" "$LINENO" 5
 fi
 ## -------------------- ##
 ## Main body of script. ##
@@ -3496,45 +4491,29 @@
 
 
 
-# SHORT_VERSION contains only the number of REVISION before the first '.',
-# e.g. if REVISION is '3.real.434-5aafd' then SHORT_VERSION is 'x.yy.3',
-# where x and yy are MAJOR_VERSION and MINOR_VERSION, respectively.
-SHORT_VERSION=1.22.4
+# SHORT_VERSION contains only the number of REVISION before the first
+# '.'; e.g., if REVISION is '3.real.434-5aafd' then SHORT_VERSION is
+# 'x.yy.3', where x and yy are MAJOR_VERSION and MINOR_VERSION,
+# respectively.
+SHORT_VERSION=1.23.0
+
+
+# Directories where the helper scripts should be found. This must be
+# consistent with the variable build_aux in bootstrap.conf.
+
+
+ac_config_headers="$ac_config_headers src/include/config.h:src/include/config.hin"
+
+
+
+
+
 
 
-# Directories where the helper scripts should be found. This must be consistent
-# with the variable build_aux in bootstrap.conf
-ac_aux_dir=
-for ac_dir in build-aux "$srcdir"/build-aux; do
-  if test -f "$ac_dir/install-sh"; then
-    ac_aux_dir=$ac_dir
-    ac_install_sh="$ac_aux_dir/install-sh -c"
-    break
-  elif test -f "$ac_dir/install.sh"; then
-    ac_aux_dir=$ac_dir
-    ac_install_sh="$ac_aux_dir/install.sh -c"
-    break
-  elif test -f "$ac_dir/shtool"; then
-    ac_aux_dir=$ac_dir
-    ac_install_sh="$ac_aux_dir/shtool install -c"
-    break
-  fi
-done
-if test -z "$ac_aux_dir"; then
-  as_fn_error $? "cannot find install-sh, install.sh, or shtool in build-aux \"$srcdir\"/build-aux" "$LINENO" 5
-fi
 
-# These three variables are undocumented and unsupported,
-# and are intended to be withdrawn in a future Autoconf release.
-# They can cause serious problems if a builder's source tree is in a directory
-# whose full name contains unusual characters.
-ac_config_guess="$SHELL $ac_aux_dir/config.guess"  # Please don't use this var.
-ac_config_sub="$SHELL $ac_aux_dir/config.sub"  # Please don't use this var.
-ac_configure="$SHELL $ac_aux_dir/configure"  # Please don't use this var.
 
 
 
-ac_config_headers="$ac_config_headers src/include/config.h:src/include/config.hin"
 
 
 
@@ -3549,11 +4528,12 @@
 if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}gcc", so it can be a program name with args.
 set dummy ${ac_tool_prefix}gcc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -3561,11 +4541,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="${ac_tool_prefix}gcc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3576,11 +4560,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -3589,11 +4573,12 @@
   ac_ct_CC=$CC
   # Extract the first word of "gcc", so it can be a program name with args.
 set dummy gcc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_CC"; then
   ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
 else
@@ -3601,11 +4586,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_CC="gcc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3616,11 +4605,11 @@
 fi
 ac_ct_CC=$ac_cv_prog_ac_ct_CC
 if test -n "$ac_ct_CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
-$as_echo "$ac_ct_CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_CC" = x; then
@@ -3628,8 +4617,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     CC=$ac_ct_CC
@@ -3642,11 +4631,12 @@
           if test -n "$ac_tool_prefix"; then
     # Extract the first word of "${ac_tool_prefix}cc", so it can be a program name with args.
 set dummy ${ac_tool_prefix}cc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -3654,11 +4644,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="${ac_tool_prefix}cc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3669,11 +4663,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -3682,11 +4676,12 @@
 if test -z "$CC"; then
   # Extract the first word of "cc", so it can be a program name with args.
 set dummy cc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -3695,15 +4690,19 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    if test "$as_dir/$ac_word$ac_exec_ext" = "/usr/ucb/cc"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    if test "$as_dir$ac_word$ac_exec_ext" = "/usr/ucb/cc"; then
        ac_prog_rejected=yes
        continue
      fi
     ac_cv_prog_CC="cc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3719,18 +4718,18 @@
     # However, it has the same basename, so the bogon will be chosen
     # first if we set CC to just the basename; use the full file name.
     shift
-    ac_cv_prog_CC="$as_dir/$ac_word${1+' '}$@"
+    ac_cv_prog_CC="$as_dir$ac_word${1+' '}$@"
   fi
 fi
 fi
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -3741,11 +4740,12 @@
   do
     # Extract the first word of "$ac_tool_prefix$ac_prog", so it can be a program name with args.
 set dummy $ac_tool_prefix$ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -3753,11 +4753,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="$ac_tool_prefix$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3768,11 +4772,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -3785,11 +4789,12 @@
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_CC"; then
   ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
 else
@@ -3797,11 +4802,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_CC="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -3812,11 +4821,11 @@
 fi
 ac_ct_CC=$ac_cv_prog_ac_ct_CC
 if test -n "$ac_ct_CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
-$as_echo "$ac_ct_CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -3828,34 +4837,138 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+ac_tool_warned=yes ;;
+esac
+    CC=$ac_ct_CC
+  fi
+fi
+
+fi
+if test -z "$CC"; then
+  if test -n "$ac_tool_prefix"; then
+  # Extract the first word of "${ac_tool_prefix}clang", so it can be a program name with args.
+set dummy ${ac_tool_prefix}clang; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$CC"; then
+  ac_cv_prog_CC="$CC" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_CC="${ac_tool_prefix}clang"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
+  fi
+done
+  done
+IFS=$as_save_IFS
+
+fi
+fi
+CC=$ac_cv_prog_CC
+if test -n "$CC"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
+
+
+fi
+if test -z "$ac_cv_prog_CC"; then
+  ac_ct_CC=$CC
+  # Extract the first word of "clang", so it can be a program name with args.
+set dummy clang; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$ac_ct_CC"; then
+  ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_ac_ct_CC="clang"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
+  fi
+done
+  done
+IFS=$as_save_IFS
+
+fi
+fi
+ac_ct_CC=$ac_cv_prog_ac_ct_CC
+if test -n "$ac_ct_CC"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
+
+  if test "x$ac_ct_CC" = x; then
+    CC=""
+  else
+    case $cross_compiling:$ac_tool_warned in
+yes:)
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     CC=$ac_ct_CC
   fi
+else
+  CC="$ac_cv_prog_CC"
 fi
 
 fi
 
 
-test -z "$CC" && { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+test -z "$CC" && { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "no acceptable C compiler found in \$PATH
 See \`config.log' for more details" "$LINENO" 5; }
 
 # Provide some information about the compiler.
-$as_echo "$as_me:${as_lineno-$LINENO}: checking for C compiler version" >&5
+printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C compiler version" >&5
 set X $ac_compile
 ac_compiler=$2
-for ac_option in --version -v -V -qversion; do
+for ac_option in --version -v -V -qversion -version; do
   { { ac_try="$ac_compiler $ac_option >&5"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compiler $ac_option >&5") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -3865,7 +4978,7 @@
     cat conftest.er1 >&5
   fi
   rm -f conftest.er1 conftest.err
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }
 done
 
@@ -3873,7 +4986,7 @@
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -3885,9 +4998,9 @@
 # Try to create an executable without -o first, disregard a.out.
 # It will help us diagnose broken compilers, and finding out an intuition
 # of exeext.
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether the C compiler works" >&5
-$as_echo_n "checking whether the C compiler works... " >&6; }
-ac_link_default=`$as_echo "$ac_link" | sed 's/ -o *conftest^ *//'`
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the C compiler works" >&5
+printf %s "checking whether the C compiler works... " >&6; }
+ac_link_default=`printf "%s\n" "$ac_link" | sed 's/ -o *conftest^ *//'`
 
 # The possible output files:
 ac_files="a.out conftest.exe conftest a.exe a_out.exe b.out conftest.*"
@@ -3908,11 +5021,12 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link_default") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; then :
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }
+then :
   # Autoconf-2.13 could set the ac_cv_exeext variable to `no'.
 # So ignore a value of `no', otherwise this would lead to `EXEEXT = no'
 # in a Makefile.  We should not override ac_cv_exeext if it was cached,
@@ -3929,7 +5043,7 @@
 	# certainly right.
 	break;;
     *.* )
-	if test "${ac_cv_exeext+set}" = set && test "$ac_cv_exeext" != no;
+	if test ${ac_cv_exeext+y} && test "$ac_cv_exeext" != no;
 	then :; else
 	   ac_cv_exeext=`expr "$ac_file" : '^.*$\..*$'`
 	fi
@@ -3945,44 +5059,46 @@
 done
 test "$ac_cv_exeext" = no && ac_cv_exeext=
 
-else
+else $as_nop
   ac_file=''
 fi
-if test -z "$ac_file"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-$as_echo "$as_me: failed program was:" >&5
+if test -z "$ac_file"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
-{ { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+{ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error 77 "C compiler cannot create executables
 See \`config.log' for more details" "$LINENO" 5; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for C compiler default output file name" >&5
-$as_echo_n "checking for C compiler default output file name... " >&6; }
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_file" >&5
-$as_echo "$ac_file" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C compiler default output file name" >&5
+printf %s "checking for C compiler default output file name... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_file" >&5
+printf "%s\n" "$ac_file" >&6; }
 ac_exeext=$ac_cv_exeext
 
 rm -f -r a.out a.out.dSYM a.exe conftest$ac_cv_exeext b.out
 ac_clean_files=$ac_clean_files_save
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for suffix of executables" >&5
-$as_echo_n "checking for suffix of executables... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for suffix of executables" >&5
+printf %s "checking for suffix of executables... " >&6; }
 if { { ac_try="$ac_link"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; then :
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }
+then :
   # If both `conftest.exe' and `conftest' are `present' (well, observable)
 # catch `conftest.exe'.  For instance with Cygwin, `ls conftest' will
 # work properly (i.e., refer to `conftest.exe'), while it won't with
@@ -3996,15 +5112,15 @@
     * ) break;;
   esac
 done
-else
-  { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+else $as_nop
+  { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "cannot compute suffix of executables: cannot compile and link
 See \`config.log' for more details" "$LINENO" 5; }
 fi
 rm -f conftest conftest$ac_cv_exeext
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_exeext" >&5
-$as_echo "$ac_cv_exeext" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_exeext" >&5
+printf "%s\n" "$ac_cv_exeext" >&6; }
 
 rm -f conftest.$ac_ext
 EXEEXT=$ac_cv_exeext
@@ -4013,7 +5129,7 @@
 /* end confdefs.h.  */
 #include <stdio.h>
 int
-main ()
+main (void)
 {
 FILE *f = fopen ("conftest.out", "w");
  return ferror (f) || fclose (f) != 0;
@@ -4025,8 +5141,8 @@
 ac_clean_files="$ac_clean_files conftest.out"
 # Check that the compiler produces executables we can run.  If not, either
 # the compiler is broken, or we cross compile.
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are cross compiling" >&5
-$as_echo_n "checking whether we are cross compiling... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether we are cross compiling" >&5
+printf %s "checking whether we are cross compiling... " >&6; }
 if test "$cross_compiling" != yes; then
   { { ac_try="$ac_link"
 case "(($ac_try" in
@@ -4034,10 +5150,10 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_link") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }
   if { ac_try='./conftest$ac_cv_exeext'
   { { case "(($ac_try" in
@@ -4045,39 +5161,40 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_try") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }; }; then
     cross_compiling=no
   else
     if test "$cross_compiling" = maybe; then
 	cross_compiling=yes
     else
-	{ { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-as_fn_error $? "cannot run C compiled programs.
+	{ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error 77 "cannot run C compiled programs.
 If you meant to cross compile, use \`--host'.
 See \`config.log' for more details" "$LINENO" 5; }
     fi
   fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $cross_compiling" >&5
-$as_echo "$cross_compiling" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $cross_compiling" >&5
+printf "%s\n" "$cross_compiling" >&6; }
 
 rm -f conftest.$ac_ext conftest$ac_cv_exeext conftest.out
 ac_clean_files=$ac_clean_files_save
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for suffix of object files" >&5
-$as_echo_n "checking for suffix of object files... " >&6; }
-if ${ac_cv_objext+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for suffix of object files" >&5
+printf %s "checking for suffix of object files... " >&6; }
+if test ${ac_cv_objext+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -4091,11 +5208,12 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compile") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; then :
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }
+then :
   for ac_file in conftest.o conftest.obj conftest.*; do
   test -f "$ac_file" || continue;
   case $ac_file in
@@ -4104,31 +5222,32 @@
        break;;
   esac
 done
-else
-  $as_echo "$as_me: failed program was:" >&5
+else $as_nop
+  printf "%s\n" "$as_me: failed program was:" >&5
 sed 's/^/| /' conftest.$ac_ext >&5
 
-{ { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+{ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "cannot compute suffix of object files: cannot compile
 See \`config.log' for more details" "$LINENO" 5; }
 fi
 rm -f conftest.$ac_cv_objext conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_objext" >&5
-$as_echo "$ac_cv_objext" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_objext" >&5
+printf "%s\n" "$ac_cv_objext" >&6; }
 OBJEXT=$ac_cv_objext
 ac_objext=$OBJEXT
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C compiler" >&5
-$as_echo_n "checking whether we are using the GNU C compiler... " >&6; }
-if ${ac_cv_c_compiler_gnu+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler supports GNU C" >&5
+printf %s "checking whether the compiler supports GNU C... " >&6; }
+if test ${ac_cv_c_compiler_gnu+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 #ifndef __GNUC__
        choke me
@@ -4138,29 +5257,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_compiler_gnu=yes
-else
+else $as_nop
   ac_compiler_gnu=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 ac_cv_c_compiler_gnu=$ac_compiler_gnu
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_compiler_gnu" >&5
-$as_echo "$ac_cv_c_compiler_gnu" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_compiler_gnu" >&5
+printf "%s\n" "$ac_cv_c_compiler_gnu" >&6; }
+ac_compiler_gnu=$ac_cv_c_compiler_gnu
+
 if test $ac_compiler_gnu = yes; then
   GCC=yes
 else
   GCC=
 fi
-ac_test_CFLAGS=${CFLAGS+set}
+ac_test_CFLAGS=${CFLAGS+y}
 ac_save_CFLAGS=$CFLAGS
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC accepts -g" >&5
-$as_echo_n "checking whether $CC accepts -g... " >&6; }
-if ${ac_cv_prog_cc_g+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $CC accepts -g" >&5
+printf %s "checking whether $CC accepts -g... " >&6; }
+if test ${ac_cv_prog_cc_g+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_save_c_werror_flag=$ac_c_werror_flag
    ac_c_werror_flag=yes
    ac_cv_prog_cc_g=no
@@ -4169,57 +5292,60 @@
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_g=yes
-else
+else $as_nop
   CFLAGS=""
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
+else $as_nop
   ac_c_werror_flag=$ac_save_c_werror_flag
 	 CFLAGS="-g"
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_g=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_c_werror_flag=$ac_save_c_werror_flag
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_g" >&5
-$as_echo "$ac_cv_prog_cc_g" >&6; }
-if test "$ac_test_CFLAGS" = set; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_g" >&5
+printf "%s\n" "$ac_cv_prog_cc_g" >&6; }
+if test $ac_test_CFLAGS; then
   CFLAGS=$ac_save_CFLAGS
 elif test $ac_cv_prog_cc_g = yes; then
   if test "$GCC" = yes; then
@@ -4234,94 +5360,144 @@
     CFLAGS=
   fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $CC option to accept ISO C89" >&5
-$as_echo_n "checking for $CC option to accept ISO C89... " >&6; }
-if ${ac_cv_prog_cc_c89+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  ac_cv_prog_cc_c89=no
+ac_prog_cc_stdc=no
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C11 features" >&5
+printf %s "checking for $CC option to enable C11 features... " >&6; }
+if test ${ac_cv_prog_cc_c11+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c11=no
 ac_save_CC=$CC
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#include <stdarg.h>
-#include <stdio.h>
-struct stat;
-/* Most of the following tests are stolen from RCS 5.7's src/conf.sh.  */
-struct buf { int x; };
-FILE * (*rcsopen) (struct buf *, struct stat *, int);
-static char *e (p, i)
-     char **p;
-     int i;
-{
-  return pi;
-}
-static char *f (char * (*g) (char **, int), char **p, ...)
-{
-  char *s;
-  va_list v;
-  va_start (v,p);
-  s = g (p, va_arg (v,int));
-  va_end (v);
-  return s;
-}
-
-/* OSF 4.0 Compaq cc is some sort of almost-ANSI by default.  It has
-   function prototypes and stuff, but not '\xHH' hex character constants.
-   These don't provoke an error unfortunately, instead are silently treated
-   as 'x'.  The following induces an error, until -std is added to get
-   proper ANSI mode.  Curiously '\x00'!='x' always comes out true, for an
-   array size at least.  It's necessary to write '\x00'==0 to get something
-   that's true only with -std.  */
-int osf4_cc_array '\x00' == 0 ? 1 : -1;
+$ac_c_conftest_c11_program
+_ACEOF
+for ac_arg in '' -std=gnu11
+do
+  CC="$ac_save_CC $ac_arg"
+  if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_cv_prog_cc_c11=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cc_c11" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CC=$ac_save_CC
+fi
 
-/* IBM C 6 for AIX is almost-ANSI by default, but it replaces macro parameters
-   inside strings and character constants.  */
-#define FOO(x) 'x'
-int xlc6_cc_arrayFOO(a) == 'x' ? 1 : -1;
+if test "x$ac_cv_prog_cc_c11" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c11" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c11" >&5
+printf "%s\n" "$ac_cv_prog_cc_c11" >&6; }
+     CC="$CC $ac_cv_prog_cc_c11"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c11
+  ac_prog_cc_stdc=c11
+fi
+fi
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C99 features" >&5
+printf %s "checking for $CC option to enable C99 features... " >&6; }
+if test ${ac_cv_prog_cc_c99+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c99=no
+ac_save_CC=$CC
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_c_conftest_c99_program
+_ACEOF
+for ac_arg in '' -std=gnu99 -std=c99 -c99 -qlanglvl=extc1x -qlanglvl=extc99 -AC99 -D_STDC_C99=
+do
+  CC="$ac_save_CC $ac_arg"
+  if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_cv_prog_cc_c99=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cc_c99" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CC=$ac_save_CC
+fi
 
-int test (int i, double x);
-struct s1 {int (*f) (int a);};
-struct s2 {int (*f) (double a);};
-int pairnames (int, char **, FILE *(*)(struct buf *, struct stat *, int), int, int);
-int argc;
-char **argv;
-int
-main ()
-{
-return f (e, argv, 0) != argv0  ||  f (e, argv, 1) != argv1;
-  ;
-  return 0;
-}
+if test "x$ac_cv_prog_cc_c99" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c99" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c99" >&5
+printf "%s\n" "$ac_cv_prog_cc_c99" >&6; }
+     CC="$CC $ac_cv_prog_cc_c99"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c99
+  ac_prog_cc_stdc=c99
+fi
+fi
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C89 features" >&5
+printf %s "checking for $CC option to enable C89 features... " >&6; }
+if test ${ac_cv_prog_cc_c89+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c89=no
+ac_save_CC=$CC
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_c_conftest_c89_program
 _ACEOF
-for ac_arg in '' -qlanglvl=extc89 -qlanglvl=ansi -std \
-	-Ae "-Aa -D_HPUX_SOURCE" "-Xc -D__EXTENSIONS__"
+for ac_arg in '' -qlanglvl=extc89 -qlanglvl=ansi -std -Ae "-Aa -D_HPUX_SOURCE" "-Xc -D__EXTENSIONS__"
 do
   CC="$ac_save_CC $ac_arg"
-  if ac_fn_c_try_compile "$LINENO"; then :
+  if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_c89=$ac_arg
 fi
-rm -f core conftest.err conftest.$ac_objext
+rm -f core conftest.err conftest.$ac_objext conftest.beam
   test "x$ac_cv_prog_cc_c89" != "xno" && break
 done
 rm -f conftest.$ac_ext
 CC=$ac_save_CC
-
 fi
-# AC_CACHE_VAL
-case "x$ac_cv_prog_cc_c89" in
-  x)
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
-$as_echo "none needed" >&6; } ;;
-  xno)
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
-$as_echo "unsupported" >&6; } ;;
-  *)
-    CC="$CC $ac_cv_prog_cc_c89"
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c89" >&5
-$as_echo "$ac_cv_prog_cc_c89" >&6; } ;;
-esac
-if test "x$ac_cv_prog_cc_c89" != xno; then :
 
+if test "x$ac_cv_prog_cc_c89" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c89" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c89" >&5
+printf "%s\n" "$ac_cv_prog_cc_c89" >&6; }
+     CC="$CC $ac_cv_prog_cc_c89"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c89
+  ac_prog_cc_stdc=c89
+fi
 fi
 
 ac_ext=c
@@ -4330,21 +5506,23 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-ac_ext=c
+
+  ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5
-$as_echo_n "checking whether $CC understands -c and -o together... " >&6; }
-if ${am_cv_prog_cc_c_o+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5
+printf %s "checking whether $CC understands -c and -o together... " >&6; }
+if test ${am_cv_prog_cc_c_o+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -4372,8 +5550,8 @@
   rm -f core conftest*
   unset am_i
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5
-$as_echo "$am_cv_prog_cc_c_o" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5
+printf "%s\n" "$am_cv_prog_cc_c_o" >&6; }
 if test "$am_cv_prog_cc_c_o" != yes; then
    # Losing compiler, so override with the script.
    # FIXME: It is wrong to rewrite CC.
@@ -4390,541 +5568,261 @@
 
 
 
-ac_ext=c
-ac_cpp='$CPP $CPPFLAGS'
-ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
-ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
-ac_compiler_gnu=$ac_cv_c_compiler_gnu
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking how to run the C preprocessor" >&5
-$as_echo_n "checking how to run the C preprocessor... " >&6; }
-# On Suns, sometimes $CPP names a directory.
-if test -n "$CPP" && test -d "$CPP"; then
-  CPP=
-fi
-if test -z "$CPP"; then
-  if ${ac_cv_prog_CPP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-      # Double quotes because CPP needs to be expanded
-    for CPP in "$CC -E" "$CC -E -traditional-cpp" "/lib/cpp"
-    do
-      ac_preproc_ok=false
-for ac_c_preproc_warn_flag in '' yes
-do
-  # Use a header file that comes with gcc, so configuring glibc
-  # with a fresh cross-compiler works.
-  # Prefer <limits.h> to <assert.h> if __STDC__ is defined, since
-  # <limits.h> exists even on freestanding compilers.
-  # On the NeXT, cc -E runs the code through the compiler's parser,
-  # not just through cpp. "Syntax error" is here to catch this case.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifdef __STDC__
-# include <limits.h>
-#else
-# include <assert.h>
-#endif
-		     Syntax error
-_ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
-
-else
-  # Broken: fails on valid input.
-continue
-fi
-rm -f conftest.err conftest.i conftest.$ac_ext
-
-  # OK, works on sane cases.  Now check whether nonexistent headers
-  # can be detected and how.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <ac_nonexistent.h>
-_ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
-  # Broken: success on invalid input.
-continue
-else
-  # Passes both tests.
-ac_preproc_ok=:
-break
-fi
-rm -f conftest.err conftest.i conftest.$ac_ext
-
-done
-# Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
-rm -f conftest.i conftest.err conftest.$ac_ext
-if $ac_preproc_ok; then :
-  break
-fi
-
-    done
-    ac_cv_prog_CPP=$CPP
-
-fi
-  CPP=$ac_cv_prog_CPP
-else
-  ac_cv_prog_CPP=$CPP
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $CPP" >&5
-$as_echo "$CPP" >&6; }
-ac_preproc_ok=false
-for ac_c_preproc_warn_flag in '' yes
-do
-  # Use a header file that comes with gcc, so configuring glibc
-  # with a fresh cross-compiler works.
-  # Prefer <limits.h> to <assert.h> if __STDC__ is defined, since
-  # <limits.h> exists even on freestanding compilers.
-  # On the NeXT, cc -E runs the code through the compiler's parser,
-  # not just through cpp. "Syntax error" is here to catch this case.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifdef __STDC__
-# include <limits.h>
-#else
-# include <assert.h>
-#endif
-		     Syntax error
-_ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
-
-else
-  # Broken: fails on valid input.
-continue
-fi
-rm -f conftest.err conftest.i conftest.$ac_ext
-
-  # OK, works on sane cases.  Now check whether nonexistent headers
-  # can be detected and how.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler is clang" >&5
+printf %s "checking whether the compiler is clang... " >&6; }
+if test ${gl_cv_compiler_clang+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+                 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#include <ac_nonexistent.h>
-_ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
-  # Broken: success on invalid input.
-continue
-else
-  # Passes both tests.
-ac_preproc_ok=:
-break
-fi
-rm -f conftest.err conftest.i conftest.$ac_ext
-
-done
-# Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
-rm -f conftest.i conftest.err conftest.$ac_ext
-if $ac_preproc_ok; then :
-
-else
-  { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-as_fn_error $? "C preprocessor \"$CPP\" fails sanity check
-See \`config.log' for more details" "$LINENO" 5; }
-fi
-
-ac_ext=c
-ac_cpp='$CPP $CPPFLAGS'
-ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
-ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
-ac_compiler_gnu=$ac_cv_c_compiler_gnu
-
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for grep that handles long lines and -e" >&5
-$as_echo_n "checking for grep that handles long lines and -e... " >&6; }
-if ${ac_cv_path_GREP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -z "$GREP"; then
-  ac_path_GREP_found=false
-  # Loop through the user's path and test for each of PROGNAME-LIST
-  as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
-for as_dir in $PATH$PATH_SEPARATOR/usr/xpg4/bin
-do
-  IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_prog in grep ggrep; do
-    for ac_exec_ext in '' $ac_executable_extensions; do
-      ac_path_GREP="$as_dir/$ac_prog$ac_exec_ext"
-      as_fn_executable_p "$ac_path_GREP" || continue
-# Check for GNU ac_path_GREP and select it if it is found.
-  # Check for GNU $ac_path_GREP
-case `"$ac_path_GREP" --version 2>&1` in
-*GNU*)
-  ac_cv_path_GREP="$ac_path_GREP" ac_path_GREP_found=:;;
-*)
-  ac_count=0
-  $as_echo_n 0123456789 >"conftest.in"
-  while :
-  do
-    cat "conftest.in" "conftest.in" >"conftest.tmp"
-    mv "conftest.tmp" "conftest.in"
-    cp "conftest.in" "conftest.nl"
-    $as_echo 'GREP' >> "conftest.nl"
-    "$ac_path_GREP" -e 'GREP$' -e '-(cannot match)-' < "conftest.nl" >"conftest.out" 2>/dev/null || break
-    diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
-    as_fn_arith $ac_count + 1 && ac_count=$as_val
-    if test $ac_count -gt ${ac_path_GREP_max-0}; then
-      # Best one so far, save it but keep looking for a better one
-      ac_cv_path_GREP="$ac_path_GREP"
-      ac_path_GREP_max=$ac_count
-    fi
-    # 10*(2^10) chars as input seems more than enough
-    test $ac_count -gt 10 && break
-  done
-  rm -f conftest.in conftest.tmp conftest.nl conftest.out;;
-esac
 
-      $ac_path_GREP_found && break 3
-    done
-  done
-  done
-IFS=$as_save_IFS
-  if test -z "$ac_cv_path_GREP"; then
-    as_fn_error $? "no acceptable grep could be found in $PATH$PATH_SEPARATOR/usr/xpg4/bin" "$LINENO" 5
-  fi
-else
-  ac_cv_path_GREP=$GREP
-fi
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_GREP" >&5
-$as_echo "$ac_cv_path_GREP" >&6; }
- GREP="$ac_cv_path_GREP"
-
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for egrep" >&5
-$as_echo_n "checking for egrep... " >&6; }
-if ${ac_cv_path_EGREP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if echo a | $GREP -E '(a|b)' >/dev/null 2>&1
-   then ac_cv_path_EGREP="$GREP -E"
-   else
-     if test -z "$EGREP"; then
-  ac_path_EGREP_found=false
-  # Loop through the user's path and test for each of PROGNAME-LIST
-  as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
-for as_dir in $PATH$PATH_SEPARATOR/usr/xpg4/bin
-do
-  IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_prog in egrep; do
-    for ac_exec_ext in '' $ac_executable_extensions; do
-      ac_path_EGREP="$as_dir/$ac_prog$ac_exec_ext"
-      as_fn_executable_p "$ac_path_EGREP" || continue
-# Check for GNU ac_path_EGREP and select it if it is found.
-  # Check for GNU $ac_path_EGREP
-case `"$ac_path_EGREP" --version 2>&1` in
-*GNU*)
-  ac_cv_path_EGREP="$ac_path_EGREP" ac_path_EGREP_found=:;;
-*)
-  ac_count=0
-  $as_echo_n 0123456789 >"conftest.in"
-  while :
-  do
-    cat "conftest.in" "conftest.in" >"conftest.tmp"
-    mv "conftest.tmp" "conftest.in"
-    cp "conftest.in" "conftest.nl"
-    $as_echo 'EGREP' >> "conftest.nl"
-    "$ac_path_EGREP" 'EGREP$' < "conftest.nl" >"conftest.out" 2>/dev/null || break
-    diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
-    as_fn_arith $ac_count + 1 && ac_count=$as_val
-    if test $ac_count -gt ${ac_path_EGREP_max-0}; then
-      # Best one so far, save it but keep looking for a better one
-      ac_cv_path_EGREP="$ac_path_EGREP"
-      ac_path_EGREP_max=$ac_count
-    fi
-    # 10*(2^10) chars as input seems more than enough
-    test $ac_count -gt 10 && break
-  done
-  rm -f conftest.in conftest.tmp conftest.nl conftest.out;;
-esac
-
-      $ac_path_EGREP_found && break 3
-    done
-  done
-  done
-IFS=$as_save_IFS
-  if test -z "$ac_cv_path_EGREP"; then
-    as_fn_error $? "no acceptable egrep could be found in $PATH$PATH_SEPARATOR/usr/xpg4/bin" "$LINENO" 5
-  fi
-else
-  ac_cv_path_EGREP=$EGREP
-fi
-
-   fi
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_EGREP" >&5
-$as_echo "$ac_cv_path_EGREP" >&6; }
- EGREP="$ac_cv_path_EGREP"
-
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for ANSI C header files" >&5
-$as_echo_n "checking for ANSI C header files... " >&6; }
-if ${ac_cv_header_stdc+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stdlib.h>
-#include <stdarg.h>
-#include <string.h>
-#include <float.h>
+           #ifdef __clang__
+           barfbarf
+           #endif
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  ac_cv_header_stdc=yes
-else
-  ac_cv_header_stdc=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-
-if test $ac_cv_header_stdc = yes; then
-  # SunOS 4.x string.h does not declare mem*, contrary to ANSI.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <string.h>
 
 _ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "memchr" >/dev/null 2>&1; then :
-
-else
-  ac_cv_header_stdc=no
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_compiler_clang=no
+else $as_nop
+  gl_cv_compiler_clang=yes
 fi
-rm -f conftest*
-
-fi
-
-if test $ac_cv_header_stdc = yes; then
-  # ISC 2.0.2 stdlib.h does not declare free, contrary to ANSI.
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stdlib.h>
-
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "free" >/dev/null 2>&1; then :
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
-else
-  ac_cv_header_stdc=no
 fi
-rm -f conftest*
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_compiler_clang" >&5
+printf "%s\n" "$gl_cv_compiler_clang" >&6; }
 
-fi
 
-if test $ac_cv_header_stdc = yes; then
-  # /bin/cc in Irix-4.0.5 gets non-ANSI ctype macros unless using -ansi.
-  if test "$cross_compiling" = yes; then :
-  :
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for compiler option needed when checking for declarations" >&5
+printf %s "checking for compiler option needed when checking for declarations... " >&6; }
+if test ${gl_cv_compiler_check_decl_option+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test $gl_cv_compiler_clang = yes; then
+                     save_ac_compile="$ac_compile"
+       ac_compile="$ac_compile -Werror=implicit-function-declaration"
+                     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#include <ctype.h>
-#include <stdlib.h>
-#if ((' ' & 0x0FF) == 0x020)
-# define ISLOWER(c) ('a' <= (c) && (c) <= 'z')
-# define TOUPPER(c) (ISLOWER(c) ? 'A' + ((c) - 'a') : (c))
-#else
-# define ISLOWER(c) \
-		   (('a' <= (c) && (c) <= 'i') \
-		     || ('j' <= (c) && (c) <= 'r') \
-		     || ('s' <= (c) && (c) <= 'z'))
-# define TOUPPER(c) (ISLOWER(c) ? ((c) | 0x40) : (c))
-#endif
 
-#define XOR(e, f) (((e) && !(f)) || (!(e) && (f)))
 int
-main ()
+main (void)
 {
-  int i;
-  for (i = 0; i < 256; i++)
-    if (XOR (islower (i), ISLOWER (i))
-	|| toupper (i) != TOUPPER (i))
-      return 2;
+
+  ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-
-else
-  ac_cv_header_stdc=no
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_compiler_check_decl_option='-Werror=implicit-function-declaration'
+else $as_nop
+  gl_cv_compiler_check_decl_option=none
 fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
-fi
-
-fi
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_header_stdc" >&5
-$as_echo "$ac_cv_header_stdc" >&6; }
-if test $ac_cv_header_stdc = yes; then
-
-$as_echo "#define STDC_HEADERS 1" >>confdefs.h
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+       ac_compile="$save_ac_compile"
+     else
+       gl_cv_compiler_check_decl_option=none
+     fi
 
 fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_compiler_check_decl_option" >&5
+printf "%s\n" "$gl_cv_compiler_check_decl_option" >&6; }
+  if test "x$gl_cv_compiler_check_decl_option" != xnone; then
+    ac_compile_for_check_decl="$ac_compile $gl_cv_compiler_check_decl_option"
+  else
+    ac_compile_for_check_decl="$ac_compile"
+  fi
 
-# On IRIX 5.3, sys/types and inttypes.h are conflicting.
-for ac_header in sys/types.h sys/stat.h stdlib.h string.h memory.h strings.h \
-		  inttypes.h stdint.h unistd.h
-do :
-  as_ac_Header=`$as_echo "ac_cv_header_$ac_header" | $as_tr_sh`
-ac_fn_c_check_header_compile "$LINENO" "$ac_header" "$as_ac_Header" "$ac_includes_default
-"
-if eval test \"x\$"$as_ac_Header"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_header" | $as_tr_cpp` 1
-_ACEOF
 
-fi
 
+ac_header= ac_cache=
+for ac_item in $ac_header_c_list
+do
+  if test $ac_cache; then
+    ac_fn_c_check_header_compile "$LINENO" $ac_header ac_cv_header_$ac_cache "$ac_includes_default"
+    if eval test \"x\$ac_cv_header_$ac_cache\" = xyes; then
+      printf "%s\n" "#define $ac_item 1" >> confdefs.h
+    fi
+    ac_header= ac_cache=
+  elif test $ac_header; then
+    ac_cache=$ac_item
+  else
+    ac_header=$ac_item
+  fi
 done
 
 
 
-  ac_fn_c_check_header_mongrel "$LINENO" "minix/config.h" "ac_cv_header_minix_config_h" "$ac_includes_default"
-if test "x$ac_cv_header_minix_config_h" = xyes; then :
-  MINIX=yes
-else
-  MINIX=
-fi
 
 
-  if test "$MINIX" = yes; then
 
-$as_echo "#define _POSIX_SOURCE 1" >>confdefs.h
 
 
-$as_echo "#define _POSIX_1_SOURCE 2" >>confdefs.h
+if test $ac_cv_header_stdlib_h = yes && test $ac_cv_header_string_h = yes
+then :
 
+printf "%s\n" "#define STDC_HEADERS 1" >>confdefs.h
 
-$as_echo "#define _MINIX 1" >>confdefs.h
+fi
 
 
-$as_echo "#define _NETBSD_SOURCE 1" >>confdefs.h
 
-  fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether it is safe to define __EXTENSIONS__" >&5
-$as_echo_n "checking whether it is safe to define __EXTENSIONS__... " >&6; }
-if ${ac_cv_safe_to_define___extensions__+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether it is safe to define __EXTENSIONS__" >&5
+printf %s "checking whether it is safe to define __EXTENSIONS__... " >&6; }
+if test ${ac_cv_safe_to_define___extensions__+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #         define __EXTENSIONS__ 1
           $ac_includes_default
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_safe_to_define___extensions__=yes
-else
+else $as_nop
   ac_cv_safe_to_define___extensions__=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_safe_to_define___extensions__" >&5
-$as_echo "$ac_cv_safe_to_define___extensions__" >&6; }
-  test $ac_cv_safe_to_define___extensions__ = yes &&
-    $as_echo "#define __EXTENSIONS__ 1" >>confdefs.h
-
-  $as_echo "#define _ALL_SOURCE 1" >>confdefs.h
-
-  $as_echo "#define _DARWIN_C_SOURCE 1" >>confdefs.h
-
-  $as_echo "#define _GNU_SOURCE 1" >>confdefs.h
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_safe_to_define___extensions__" >&5
+printf "%s\n" "$ac_cv_safe_to_define___extensions__" >&6; }
 
-  $as_echo "#define _NETBSD_SOURCE 1" >>confdefs.h
-
-  $as_echo "#define _OPENBSD_SOURCE 1" >>confdefs.h
-
-  $as_echo "#define _POSIX_PTHREAD_SEMANTICS 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_IEC_60559_ATTRIBS_EXT__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_IEC_60559_BFP_EXT__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_IEC_60559_DFP_EXT__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_IEC_60559_FUNCS_EXT__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_IEC_60559_TYPES_EXT__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_LIB_EXT2__ 1" >>confdefs.h
-
-  $as_echo "#define __STDC_WANT_MATH_SPEC_FUNCS__ 1" >>confdefs.h
-
-  $as_echo "#define _TANDEM_SOURCE 1" >>confdefs.h
-
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether _XOPEN_SOURCE should be defined" >&5
-$as_echo_n "checking whether _XOPEN_SOURCE should be defined... " >&6; }
-if ${ac_cv_should_define__xopen_source+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether _XOPEN_SOURCE should be defined" >&5
+printf %s "checking whether _XOPEN_SOURCE should be defined... " >&6; }
+if test ${ac_cv_should_define__xopen_source+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_should_define__xopen_source=no
-     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+    if test $ac_cv_header_wchar_h = yes
+then :
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
           #include <wchar.h>
           mbstate_t x;
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-             #define _XOPEN_SOURCE 500
-             #include <wchar.h>
-             mbstate_t x;
+            #define _XOPEN_SOURCE 500
+            #include <wchar.h>
+            mbstate_t x;
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_should_define__xopen_source=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_should_define__xopen_source" >&5
+printf "%s\n" "$ac_cv_should_define__xopen_source" >&6; }
+
+  printf "%s\n" "#define _ALL_SOURCE 1" >>confdefs.h
+
+  printf "%s\n" "#define _DARWIN_C_SOURCE 1" >>confdefs.h
+
+  printf "%s\n" "#define _GNU_SOURCE 1" >>confdefs.h
+
+  printf "%s\n" "#define _HPUX_ALT_XOPEN_SOCKET_API 1" >>confdefs.h
+
+  printf "%s\n" "#define _NETBSD_SOURCE 1" >>confdefs.h
+
+  printf "%s\n" "#define _OPENBSD_SOURCE 1" >>confdefs.h
+
+  printf "%s\n" "#define _POSIX_PTHREAD_SEMANTICS 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_ATTRIBS_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_BFP_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_DFP_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_FUNCS_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_IEC_60559_TYPES_EXT__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_LIB_EXT2__ 1" >>confdefs.h
+
+  printf "%s\n" "#define __STDC_WANT_MATH_SPEC_FUNCS__ 1" >>confdefs.h
+
+  printf "%s\n" "#define _TANDEM_SOURCE 1" >>confdefs.h
+
+  if test $ac_cv_header_minix_config_h = yes
+then :
+  MINIX=yes
+    printf "%s\n" "#define _MINIX 1" >>confdefs.h
+
+    printf "%s\n" "#define _POSIX_SOURCE 1" >>confdefs.h
+
+    printf "%s\n" "#define _POSIX_1_SOURCE 2" >>confdefs.h
+
+else $as_nop
+  MINIX=
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_should_define__xopen_source" >&5
-$as_echo "$ac_cv_should_define__xopen_source" >&6; }
-  test $ac_cv_should_define__xopen_source = yes &&
-    $as_echo "#define _XOPEN_SOURCE 500" >>confdefs.h
+  if test $ac_cv_safe_to_define___extensions__ = yes
+then :
+  printf "%s\n" "#define __EXTENSIONS__ 1" >>confdefs.h
 
-  $as_echo "#define _HPUX_ALT_XOPEN_SOCKET_API 1" >>confdefs.h
+fi
+  if test $ac_cv_should_define__xopen_source = yes
+then :
+  printf "%s\n" "#define _XOPEN_SOURCE 500" >>confdefs.h
 
+fi
 
 
 am__api_version='1.16'
 
-# Find a good install program.  We prefer a C program (faster),
+
+  # Find a good install program.  We prefer a C program (faster),
 # so one script is as good as another.  But avoid the broken or
 # incompatible versions:
 # SysV /etc/install, /usr/sbin/install
@@ -4938,20 +5836,25 @@
 # OS/2's system install, which has a completely different semantic
 # ./install, which can be erroneously created by make from ./install.sh.
 # Reject install programs that cannot install multiple files.
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for a BSD-compatible install" >&5
-$as_echo_n "checking for a BSD-compatible install... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for a BSD-compatible install" >&5
+printf %s "checking for a BSD-compatible install... " >&6; }
 if test -z "$INSTALL"; then
-if ${ac_cv_path_install+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+if test ${ac_cv_path_install+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    # Account for people who put trailing slashes in PATH elements.
-case $as_dir/ in #((
-  ./ | .// | /cC/* | \
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    # Account for fact that we put trailing slashes in our PATH walk.
+case $as_dir in #((
+  ./ | /cC/* | \
   /etc/* | /usr/sbin/* | /usr/etc/* | /sbin/* | /usr/afsws/bin/* | \
   ?:\\/os2\\/install\\/* | ?:\\/OS2\\/INSTALL\\/* | \
   /usr/ucb/* ) ;;
@@ -4961,13 +5864,13 @@
     # by default.
     for ac_prog in ginstall scoinst install; do
       for ac_exec_ext in '' $ac_executable_extensions; do
-	if as_fn_executable_p "$as_dir/$ac_prog$ac_exec_ext"; then
+	if as_fn_executable_p "$as_dir$ac_prog$ac_exec_ext"; then
 	  if test $ac_prog = install &&
-	    grep dspmsg "$as_dir/$ac_prog$ac_exec_ext" >/dev/null 2>&1; then
+	    grep dspmsg "$as_dir$ac_prog$ac_exec_ext" >/dev/null 2>&1; then
 	    # AIX install.  It has an incompatible calling convention.
 	    :
 	  elif test $ac_prog = install &&
-	    grep pwplus "$as_dir/$ac_prog$ac_exec_ext" >/dev/null 2>&1; then
+	    grep pwplus "$as_dir$ac_prog$ac_exec_ext" >/dev/null 2>&1; then
 	    # program-specific install script used by HP pwplus--don't use.
 	    :
 	  else
@@ -4975,12 +5878,12 @@
 	    echo one > conftest.one
 	    echo two > conftest.two
 	    mkdir conftest.dir
-	    if "$as_dir/$ac_prog$ac_exec_ext" -c conftest.one conftest.two "`pwd`/conftest.dir" &&
+	    if "$as_dir$ac_prog$ac_exec_ext" -c conftest.one conftest.two "`pwd`/conftest.dir/" &&
 	      test -s conftest.one && test -s conftest.two &&
 	      test -s conftest.dir/conftest.one &&
 	      test -s conftest.dir/conftest.two
 	    then
-	      ac_cv_path_install="$as_dir/$ac_prog$ac_exec_ext -c"
+	      ac_cv_path_install="$as_dir$ac_prog$ac_exec_ext -c"
 	      break 3
 	    fi
 	  fi
@@ -4996,7 +5899,7 @@
 rm -rf conftest.one conftest.two conftest.dir
 
 fi
-  if test "${ac_cv_path_install+set}" = set; then
+  if test ${ac_cv_path_install+y}; then
     INSTALL=$ac_cv_path_install
   else
     # As a last resort, use the slow shell script.  Don't cache a
@@ -5006,8 +5909,8 @@
     INSTALL=$ac_install_sh
   fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $INSTALL" >&5
-$as_echo "$INSTALL" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $INSTALL" >&5
+printf "%s\n" "$INSTALL" >&6; }
 
 # Use test -z because SunOS4 sh mishandles braces in ${var-val}.
 # It thinks the first close brace ends the variable substitution.
@@ -5017,8 +5920,8 @@
 
 test -z "$INSTALL_DATA" && INSTALL_DATA='${INSTALL} -m 644'
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether build environment is sane" >&5
-$as_echo_n "checking whether build environment is sane... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether build environment is sane" >&5
+printf %s "checking whether build environment is sane... " >&6; }
 # Reject unsafe characters in $srcdir or the absolute working directory
 # name.  Accept space and tab only in the latter.
 am_lf='
@@ -5072,8 +5975,8 @@
    as_fn_error $? "newly created file is older than distributed files!
 Check your system clock" "$LINENO" 5
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 # If we didn't sleep, we still need to ensure time stamps of config.status and
 # generated files are strictly newer.
 am_sleep_pid=
@@ -5092,23 +5995,19 @@
 # Double any \ or $.
 # By default was `s,x,x', remove it if useless.
 ac_script='s/\\$/&&/g;s/;s,x,x,$//'
-program_transform_name=`$as_echo "$program_transform_name" | sed "$ac_script"`
+program_transform_name=`printf "%s\n" "$program_transform_name" | sed "$ac_script"`
 
-if test x"${MISSING+set}" != xset; then
-  case $am_aux_dir in
-  *\ * | *\	*)
-    MISSING="\${SHELL} \"$am_aux_dir/missing\"" ;;
-  *)
-    MISSING="\${SHELL} $am_aux_dir/missing" ;;
-  esac
+
+  if test x"${MISSING+set}" != xset; then
+  MISSING="\${SHELL} '$am_aux_dir/missing'"
 fi
 # Use eval to expand $SHELL
 if eval "$MISSING --is-lightweight"; then
   am_missing_run="$MISSING "
 else
   am_missing_run=
-  { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: 'missing' script is too old or missing" >&5
-$as_echo "$as_me: WARNING: 'missing' script is too old or missing" >&2;}
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: 'missing' script is too old or missing" >&5
+printf "%s\n" "$as_me: WARNING: 'missing' script is too old or missing" >&2;}
 fi
 
 if test x"${install_sh+set}" != xset; then
@@ -5128,11 +6027,12 @@
   if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}strip", so it can be a program name with args.
 set dummy ${ac_tool_prefix}strip; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_STRIP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_STRIP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$STRIP"; then
   ac_cv_prog_STRIP="$STRIP" # Let the user override the test.
 else
@@ -5140,11 +6040,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_STRIP="${ac_tool_prefix}strip"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5155,11 +6059,11 @@
 fi
 STRIP=$ac_cv_prog_STRIP
 if test -n "$STRIP"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $STRIP" >&5
-$as_echo "$STRIP" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $STRIP" >&5
+printf "%s\n" "$STRIP" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -5168,11 +6072,12 @@
   ac_ct_STRIP=$STRIP
   # Extract the first word of "strip", so it can be a program name with args.
 set dummy strip; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_STRIP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_STRIP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_STRIP"; then
   ac_cv_prog_ac_ct_STRIP="$ac_ct_STRIP" # Let the user override the test.
 else
@@ -5180,11 +6085,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_STRIP="strip"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5195,11 +6104,11 @@
 fi
 ac_ct_STRIP=$ac_cv_prog_ac_ct_STRIP
 if test -n "$ac_ct_STRIP"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_STRIP" >&5
-$as_echo "$ac_ct_STRIP" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_STRIP" >&5
+printf "%s\n" "$ac_ct_STRIP" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_STRIP" = x; then
@@ -5207,8 +6116,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     STRIP=$ac_ct_STRIP
@@ -5220,25 +6129,31 @@
 fi
 INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s"
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for a thread-safe mkdir -p" >&5
-$as_echo_n "checking for a thread-safe mkdir -p... " >&6; }
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for a race-free mkdir -p" >&5
+printf %s "checking for a race-free mkdir -p... " >&6; }
 if test -z "$MKDIR_P"; then
-  if ${ac_cv_path_mkdir+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  if test ${ac_cv_path_mkdir+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH$PATH_SEPARATOR/opt/sfw/bin
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_prog in mkdir gmkdir; do
 	 for ac_exec_ext in '' $ac_executable_extensions; do
-	   as_fn_executable_p "$as_dir/$ac_prog$ac_exec_ext" || continue
-	   case `"$as_dir/$ac_prog$ac_exec_ext" --version 2>&1` in #(
-	     'mkdir (GNU coreutils) '* | \
-	     'mkdir (coreutils) '* | \
+	   as_fn_executable_p "$as_dir$ac_prog$ac_exec_ext" || continue
+	   case `"$as_dir$ac_prog$ac_exec_ext" --version 2>&1` in #(
+	     'mkdir ('*'coreutils) '* | \
+	     'BusyBox '* | \
 	     'mkdir (fileutils) '4.1*)
-	       ac_cv_path_mkdir=$as_dir/$ac_prog$ac_exec_ext
+	       ac_cv_path_mkdir=$as_dir$ac_prog$ac_exec_ext
 	       break 3;;
 	   esac
 	 done
@@ -5249,7 +6164,7 @@
 fi
 
   test -d ./--version && rmdir ./--version
-  if test "${ac_cv_path_mkdir+set}" = set; then
+  if test ${ac_cv_path_mkdir+y}; then
     MKDIR_P="$ac_cv_path_mkdir -p"
   else
     # As a last resort, use the slow shell script.  Don't cache a
@@ -5259,18 +6174,19 @@
     MKDIR_P="$ac_install_sh -d"
   fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $MKDIR_P" >&5
-$as_echo "$MKDIR_P" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $MKDIR_P" >&5
+printf "%s\n" "$MKDIR_P" >&6; }
 
 for ac_prog in gawk mawk nawk awk
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_AWK+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_AWK+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$AWK"; then
   ac_cv_prog_AWK="$AWK" # Let the user override the test.
 else
@@ -5278,11 +6194,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_AWK="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5293,24 +6213,25 @@
 fi
 AWK=$ac_cv_prog_AWK
 if test -n "$AWK"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $AWK" >&5
-$as_echo "$AWK" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $AWK" >&5
+printf "%s\n" "$AWK" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
   test -n "$AWK" && break
 done
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ${MAKE-make} sets \$(MAKE)" >&5
-$as_echo_n "checking whether ${MAKE-make} sets \$(MAKE)... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ${MAKE-make} sets \$(MAKE)" >&5
+printf %s "checking whether ${MAKE-make} sets \$(MAKE)... " >&6; }
 set x ${MAKE-make}
-ac_make=`$as_echo "$2" | sed 's/+/p/g; s/^a-zA-Z0-9_/_/g'`
-if eval \${ac_cv_prog_make_${ac_make}_set+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+ac_make=`printf "%s\n" "$2" | sed 's/+/p/g; s/^a-zA-Z0-9_/_/g'`
+if eval test \${ac_cv_prog_make_${ac_make}_set+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat >conftest.make <<\_ACEOF
 SHELL = /bin/sh
 all:
@@ -5326,12 +6247,12 @@
 rm -f conftest.make
 fi
 if eval test \$ac_cv_prog_make_${ac_make}_set = yes; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
   SET_MAKE=
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
   SET_MAKE="MAKE=${MAKE-make}"
 fi
 
@@ -5348,8 +6269,8 @@
 
 ac_config_commands="$ac_config_commands depfiles"
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ${MAKE-make} supports the include directive" >&5
-$as_echo_n "checking whether ${MAKE-make} supports the include directive... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ${MAKE-make} supports the include directive" >&5
+printf %s "checking whether ${MAKE-make} supports the include directive... " >&6; }
 cat > confinc.mk << 'END'
 am__doit:
 	@echo this is the am__doit target >confinc.out
@@ -5385,11 +6306,12 @@
   fi
 done
 rm -f confinc.* confmf.*
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: ${_am_result}" >&5
-$as_echo "${_am_result}" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: ${_am_result}" >&5
+printf "%s\n" "${_am_result}" >&6; }
 
 # Check whether --enable-dependency-tracking was given.
-if test "${enable_dependency_tracking+set}" = set; then :
+if test ${enable_dependency_tracking+y}
+then :
   enableval=$enable_dependency_tracking;
 fi
 
@@ -5408,7 +6330,8 @@
 
 
 # Check whether --enable-silent-rules was given.
-if test "${enable_silent_rules+set}" = set; then :
+if test ${enable_silent_rules+y}
+then :
   enableval=$enable_silent_rules;
 fi
 
@@ -5418,12 +6341,13 @@
     *) AM_DEFAULT_VERBOSITY=1;;
 esac
 am_make=${MAKE-make}
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $am_make supports nested variables" >&5
-$as_echo_n "checking whether $am_make supports nested variables... " >&6; }
-if ${am_cv_make_support_nested_variables+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if $as_echo 'TRUE=$(BAR$(V))
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $am_make supports nested variables" >&5
+printf %s "checking whether $am_make supports nested variables... " >&6; }
+if test ${am_cv_make_support_nested_variables+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if printf "%s\n" 'TRUE=$(BAR$(V))
 BAR0=false
 BAR1=true
 V=1
@@ -5435,8 +6359,8 @@
   am_cv_make_support_nested_variables=no
 fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_make_support_nested_variables" >&5
-$as_echo "$am_cv_make_support_nested_variables" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_make_support_nested_variables" >&5
+printf "%s\n" "$am_cv_make_support_nested_variables" >&6; }
 if test $am_cv_make_support_nested_variables = yes; then
     AM_V='$(V)'
   AM_DEFAULT_V='$(AM_DEFAULT_VERBOSITY)'
@@ -5468,17 +6392,13 @@
 
 # Define the identity of the package.
  PACKAGE='groff'
- VERSION='1.22.4'
+ VERSION='1.23.0'
 
 
-cat >>confdefs.h <<_ACEOF
-#define PACKAGE "$PACKAGE"
-_ACEOF
+printf "%s\n" "#define PACKAGE \"$PACKAGE\"" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define VERSION "$VERSION"
-_ACEOF
+printf "%s\n" "#define VERSION \"$VERSION\"" >>confdefs.h
 
 # Some tools Automake needs.
 
@@ -5520,11 +6440,12 @@
 
 depcc="$CC"   am_compiler_list=
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5
-$as_echo_n "checking dependency style of $depcc... " >&6; }
-if ${am_cv_CC_dependencies_compiler_type+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5
+printf %s "checking dependency style of $depcc... " >&6; }
+if test ${am_cv_CC_dependencies_compiler_type+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -z "$AMDEP_TRUE" && test -f "$am_depcomp"; then
   # We make a subdir and do the tests there.  Otherwise we can end up
   # making bogus files that we don't know about and never remove.  For
@@ -5631,8 +6552,8 @@
 fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_CC_dependencies_compiler_type" >&5
-$as_echo "$am_cv_CC_dependencies_compiler_type" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_CC_dependencies_compiler_type" >&5
+printf "%s\n" "$am_cv_CC_dependencies_compiler_type" >&6; }
 CCDEPMODE=depmode=$am_cv_CC_dependencies_compiler_type
 
  if
@@ -5646,6 +6567,20 @@
 fi
 
 
+# Variables for tags utilities; see am/tags.am
+if test -z "$CTAGS"; then
+  CTAGS=ctags
+fi
+
+if test -z "$ETAGS"; then
+  ETAGS=etags
+fi
+
+if test -z "$CSCOPE"; then
+  CSCOPE=cscope
+fi
+
+
 
 # POSIX will say in a future version that running "rm -f" with no argument
 # is OK; and we want to be able to make that assumption in our Makefile
@@ -5691,7 +6626,8 @@
 
 
 # Check whether --enable-silent-rules was given.
-if test "${enable_silent_rules+set}" = set; then :
+if test ${enable_silent_rules+y}
+then :
   enableval=$enable_silent_rules;
 fi
 
@@ -5701,12 +6637,13 @@
     *) AM_DEFAULT_VERBOSITY=0;;
 esac
 am_make=${MAKE-make}
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $am_make supports nested variables" >&5
-$as_echo_n "checking whether $am_make supports nested variables... " >&6; }
-if ${am_cv_make_support_nested_variables+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if $as_echo 'TRUE=$(BAR$(V))
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $am_make supports nested variables" >&5
+printf %s "checking whether $am_make supports nested variables... " >&6; }
+if test ${am_cv_make_support_nested_variables+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if printf "%s\n" 'TRUE=$(BAR$(V))
 BAR0=false
 BAR1=true
 V=1
@@ -5718,8 +6655,8 @@
   am_cv_make_support_nested_variables=no
 fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_make_support_nested_variables" >&5
-$as_echo "$am_cv_make_support_nested_variables" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_make_support_nested_variables" >&5
+printf "%s\n" "$am_cv_make_support_nested_variables" >&6; }
 if test $am_cv_make_support_nested_variables = yes; then
     AM_V='$(V)'
   AM_DEFAULT_V='$(AM_DEFAULT_VERBOSITY)'
@@ -5739,11 +6676,12 @@
 if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}gcc", so it can be a program name with args.
 set dummy ${ac_tool_prefix}gcc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -5751,11 +6689,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="${ac_tool_prefix}gcc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5766,11 +6708,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -5779,11 +6721,12 @@
   ac_ct_CC=$CC
   # Extract the first word of "gcc", so it can be a program name with args.
 set dummy gcc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_CC"; then
   ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
 else
@@ -5791,11 +6734,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_CC="gcc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5806,11 +6753,11 @@
 fi
 ac_ct_CC=$ac_cv_prog_ac_ct_CC
 if test -n "$ac_ct_CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
-$as_echo "$ac_ct_CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_CC" = x; then
@@ -5818,8 +6765,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     CC=$ac_ct_CC
@@ -5832,11 +6779,12 @@
           if test -n "$ac_tool_prefix"; then
     # Extract the first word of "${ac_tool_prefix}cc", so it can be a program name with args.
 set dummy ${ac_tool_prefix}cc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -5844,11 +6792,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="${ac_tool_prefix}cc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5859,11 +6811,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -5872,11 +6824,12 @@
 if test -z "$CC"; then
   # Extract the first word of "cc", so it can be a program name with args.
 set dummy cc; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -5885,15 +6838,19 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    if test "$as_dir/$ac_word$ac_exec_ext" = "/usr/ucb/cc"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    if test "$as_dir$ac_word$ac_exec_ext" = "/usr/ucb/cc"; then
        ac_prog_rejected=yes
        continue
      fi
     ac_cv_prog_CC="cc"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5909,18 +6866,18 @@
     # However, it has the same basename, so the bogon will be chosen
     # first if we set CC to just the basename; use the full file name.
     shift
-    ac_cv_prog_CC="$as_dir/$ac_word${1+' '}$@"
+    ac_cv_prog_CC="$as_dir$ac_word${1+' '}$@"
   fi
 fi
 fi
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -5931,11 +6888,12 @@
   do
     # Extract the first word of "$ac_tool_prefix$ac_prog", so it can be a program name with args.
 set dummy $ac_tool_prefix$ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CC"; then
   ac_cv_prog_CC="$CC" # Let the user override the test.
 else
@@ -5943,11 +6901,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CC="$ac_tool_prefix$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -5958,11 +6920,11 @@
 fi
 CC=$ac_cv_prog_CC
 if test -n "$CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
-$as_echo "$CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -5975,11 +6937,12 @@
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_CC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_CC"; then
   ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
 else
@@ -5987,11 +6950,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_CC="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6002,11 +6969,11 @@
 fi
 ac_ct_CC=$ac_cv_prog_ac_ct_CC
 if test -n "$ac_ct_CC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
-$as_echo "$ac_ct_CC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -6018,8 +6985,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     CC=$ac_ct_CC
@@ -6027,25 +6994,129 @@
 fi
 
 fi
+if test -z "$CC"; then
+  if test -n "$ac_tool_prefix"; then
+  # Extract the first word of "${ac_tool_prefix}clang", so it can be a program name with args.
+set dummy ${ac_tool_prefix}clang; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$CC"; then
+  ac_cv_prog_CC="$CC" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_CC="${ac_tool_prefix}clang"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
+  fi
+done
+  done
+IFS=$as_save_IFS
 
+fi
+fi
+CC=$ac_cv_prog_CC
+if test -n "$CC"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CC" >&5
+printf "%s\n" "$CC" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
 
-test -z "$CC" && { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+
+fi
+if test -z "$ac_cv_prog_CC"; then
+  ac_ct_CC=$CC
+  # Extract the first word of "clang", so it can be a program name with args.
+set dummy clang; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$ac_ct_CC"; then
+  ac_cv_prog_ac_ct_CC="$ac_ct_CC" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_ac_ct_CC="clang"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
+  fi
+done
+  done
+IFS=$as_save_IFS
+
+fi
+fi
+ac_ct_CC=$ac_cv_prog_ac_ct_CC
+if test -n "$ac_ct_CC"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CC" >&5
+printf "%s\n" "$ac_ct_CC" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
+
+  if test "x$ac_ct_CC" = x; then
+    CC=""
+  else
+    case $cross_compiling:$ac_tool_warned in
+yes:)
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+ac_tool_warned=yes ;;
+esac
+    CC=$ac_ct_CC
+  fi
+else
+  CC="$ac_cv_prog_CC"
+fi
+
+fi
+
+
+test -z "$CC" && { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "no acceptable C compiler found in \$PATH
 See \`config.log' for more details" "$LINENO" 5; }
 
 # Provide some information about the compiler.
-$as_echo "$as_me:${as_lineno-$LINENO}: checking for C compiler version" >&5
+printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C compiler version" >&5
 set X $ac_compile
 ac_compiler=$2
-for ac_option in --version -v -V -qversion; do
+for ac_option in --version -v -V -qversion -version; do
   { { ac_try="$ac_compiler $ac_option >&5"
 case "(($ac_try" in
   *\"* | *\`* | *\\*) ac_try_echo=\$ac_try;;
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compiler $ac_option >&5") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -6055,20 +7126,21 @@
     cat conftest.er1 >&5
   fi
   rm -f conftest.er1 conftest.err
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }
 done
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C compiler" >&5
-$as_echo_n "checking whether we are using the GNU C compiler... " >&6; }
-if ${ac_cv_c_compiler_gnu+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler supports GNU C" >&5
+printf %s "checking whether the compiler supports GNU C... " >&6; }
+if test ${ac_cv_c_compiler_gnu+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 #ifndef __GNUC__
        choke me
@@ -6078,29 +7150,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_compiler_gnu=yes
-else
+else $as_nop
   ac_compiler_gnu=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 ac_cv_c_compiler_gnu=$ac_compiler_gnu
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_compiler_gnu" >&5
-$as_echo "$ac_cv_c_compiler_gnu" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_compiler_gnu" >&5
+printf "%s\n" "$ac_cv_c_compiler_gnu" >&6; }
+ac_compiler_gnu=$ac_cv_c_compiler_gnu
+
 if test $ac_compiler_gnu = yes; then
   GCC=yes
 else
   GCC=
 fi
-ac_test_CFLAGS=${CFLAGS+set}
+ac_test_CFLAGS=${CFLAGS+y}
 ac_save_CFLAGS=$CFLAGS
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC accepts -g" >&5
-$as_echo_n "checking whether $CC accepts -g... " >&6; }
-if ${ac_cv_prog_cc_g+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $CC accepts -g" >&5
+printf %s "checking whether $CC accepts -g... " >&6; }
+if test ${ac_cv_prog_cc_g+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_save_c_werror_flag=$ac_c_werror_flag
    ac_c_werror_flag=yes
    ac_cv_prog_cc_g=no
@@ -6109,57 +7185,60 @@
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_g=yes
-else
+else $as_nop
   CFLAGS=""
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
+else $as_nop
   ac_c_werror_flag=$ac_save_c_werror_flag
 	 CFLAGS="-g"
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_g=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_c_werror_flag=$ac_save_c_werror_flag
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_g" >&5
-$as_echo "$ac_cv_prog_cc_g" >&6; }
-if test "$ac_test_CFLAGS" = set; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_g" >&5
+printf "%s\n" "$ac_cv_prog_cc_g" >&6; }
+if test $ac_test_CFLAGS; then
   CFLAGS=$ac_save_CFLAGS
 elif test $ac_cv_prog_cc_g = yes; then
   if test "$GCC" = yes; then
@@ -6174,94 +7253,144 @@
     CFLAGS=
   fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $CC option to accept ISO C89" >&5
-$as_echo_n "checking for $CC option to accept ISO C89... " >&6; }
-if ${ac_cv_prog_cc_c89+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  ac_cv_prog_cc_c89=no
+ac_prog_cc_stdc=no
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C11 features" >&5
+printf %s "checking for $CC option to enable C11 features... " >&6; }
+if test ${ac_cv_prog_cc_c11+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c11=no
 ac_save_CC=$CC
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#include <stdarg.h>
-#include <stdio.h>
-struct stat;
-/* Most of the following tests are stolen from RCS 5.7's src/conf.sh.  */
-struct buf { int x; };
-FILE * (*rcsopen) (struct buf *, struct stat *, int);
-static char *e (p, i)
-     char **p;
-     int i;
-{
-  return pi;
-}
-static char *f (char * (*g) (char **, int), char **p, ...)
-{
-  char *s;
-  va_list v;
-  va_start (v,p);
-  s = g (p, va_arg (v,int));
-  va_end (v);
-  return s;
-}
-
-/* OSF 4.0 Compaq cc is some sort of almost-ANSI by default.  It has
-   function prototypes and stuff, but not '\xHH' hex character constants.
-   These don't provoke an error unfortunately, instead are silently treated
-   as 'x'.  The following induces an error, until -std is added to get
-   proper ANSI mode.  Curiously '\x00'!='x' always comes out true, for an
-   array size at least.  It's necessary to write '\x00'==0 to get something
-   that's true only with -std.  */
-int osf4_cc_array '\x00' == 0 ? 1 : -1;
+$ac_c_conftest_c11_program
+_ACEOF
+for ac_arg in '' -std=gnu11
+do
+  CC="$ac_save_CC $ac_arg"
+  if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_cv_prog_cc_c11=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cc_c11" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CC=$ac_save_CC
+fi
 
-/* IBM C 6 for AIX is almost-ANSI by default, but it replaces macro parameters
-   inside strings and character constants.  */
-#define FOO(x) 'x'
-int xlc6_cc_arrayFOO(a) == 'x' ? 1 : -1;
+if test "x$ac_cv_prog_cc_c11" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c11" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c11" >&5
+printf "%s\n" "$ac_cv_prog_cc_c11" >&6; }
+     CC="$CC $ac_cv_prog_cc_c11"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c11
+  ac_prog_cc_stdc=c11
+fi
+fi
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C99 features" >&5
+printf %s "checking for $CC option to enable C99 features... " >&6; }
+if test ${ac_cv_prog_cc_c99+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c99=no
+ac_save_CC=$CC
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_c_conftest_c99_program
+_ACEOF
+for ac_arg in '' -std=gnu99 -std=c99 -c99 -qlanglvl=extc1x -qlanglvl=extc99 -AC99 -D_STDC_C99=
+do
+  CC="$ac_save_CC $ac_arg"
+  if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_cv_prog_cc_c99=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cc_c99" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CC=$ac_save_CC
+fi
 
-int test (int i, double x);
-struct s1 {int (*f) (int a);};
-struct s2 {int (*f) (double a);};
-int pairnames (int, char **, FILE *(*)(struct buf *, struct stat *, int), int, int);
-int argc;
-char **argv;
-int
-main ()
-{
-return f (e, argv, 0) != argv0  ||  f (e, argv, 1) != argv1;
-  ;
-  return 0;
-}
+if test "x$ac_cv_prog_cc_c99" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c99" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c99" >&5
+printf "%s\n" "$ac_cv_prog_cc_c99" >&6; }
+     CC="$CC $ac_cv_prog_cc_c99"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c99
+  ac_prog_cc_stdc=c99
+fi
+fi
+if test x$ac_prog_cc_stdc = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC option to enable C89 features" >&5
+printf %s "checking for $CC option to enable C89 features... " >&6; }
+if test ${ac_cv_prog_cc_c89+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cc_c89=no
+ac_save_CC=$CC
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_c_conftest_c89_program
 _ACEOF
-for ac_arg in '' -qlanglvl=extc89 -qlanglvl=ansi -std \
-	-Ae "-Aa -D_HPUX_SOURCE" "-Xc -D__EXTENSIONS__"
+for ac_arg in '' -qlanglvl=extc89 -qlanglvl=ansi -std -Ae "-Aa -D_HPUX_SOURCE" "-Xc -D__EXTENSIONS__"
 do
   CC="$ac_save_CC $ac_arg"
-  if ac_fn_c_try_compile "$LINENO"; then :
+  if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_prog_cc_c89=$ac_arg
 fi
-rm -f core conftest.err conftest.$ac_objext
+rm -f core conftest.err conftest.$ac_objext conftest.beam
   test "x$ac_cv_prog_cc_c89" != "xno" && break
 done
 rm -f conftest.$ac_ext
 CC=$ac_save_CC
-
 fi
-# AC_CACHE_VAL
-case "x$ac_cv_prog_cc_c89" in
-  x)
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
-$as_echo "none needed" >&6; } ;;
-  xno)
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
-$as_echo "unsupported" >&6; } ;;
-  *)
-    CC="$CC $ac_cv_prog_cc_c89"
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c89" >&5
-$as_echo "$ac_cv_prog_cc_c89" >&6; } ;;
-esac
-if test "x$ac_cv_prog_cc_c89" != xno; then :
 
+if test "x$ac_cv_prog_cc_c89" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cc_c89" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cc_c89" >&5
+printf "%s\n" "$ac_cv_prog_cc_c89" >&6; }
+     CC="$CC $ac_cv_prog_cc_c89"
+fi
+  ac_cv_prog_cc_stdc=$ac_cv_prog_cc_c89
+  ac_prog_cc_stdc=c89
+fi
 fi
 
 ac_ext=c
@@ -6270,21 +7399,23 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-ac_ext=c
+
+  ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5
-$as_echo_n "checking whether $CC understands -c and -o together... " >&6; }
-if ${am_cv_prog_cc_c_o+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $CC understands -c and -o together" >&5
+printf %s "checking whether $CC understands -c and -o together... " >&6; }
+if test ${am_cv_prog_cc_c_o+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -6312,8 +7443,8 @@
   rm -f core conftest*
   unset am_i
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5
-$as_echo "$am_cv_prog_cc_c_o" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_prog_cc_c_o" >&5
+printf "%s\n" "$am_cv_prog_cc_c_o" >&6; }
 if test "$am_cv_prog_cc_c_o" != yes; then
    # Losing compiler, so override with the script.
    # FIXME: It is wrong to rewrite CC.
@@ -6329,6 +7460,90 @@
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
 
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler is clang" >&5
+printf %s "checking whether the compiler is clang... " >&6; }
+if test ${gl_cv_compiler_clang+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+                 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+           #ifdef __clang__
+           barfbarf
+           #endif
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_compiler_clang=no
+else $as_nop
+  gl_cv_compiler_clang=yes
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_compiler_clang" >&5
+printf "%s\n" "$gl_cv_compiler_clang" >&6; }
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for compiler option needed when checking for declarations" >&5
+printf %s "checking for compiler option needed when checking for declarations... " >&6; }
+if test ${gl_cv_compiler_check_decl_option+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test $gl_cv_compiler_clang = yes; then
+                     save_ac_compile="$ac_compile"
+       ac_compile="$ac_compile -Werror=implicit-function-declaration"
+                     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_compiler_check_decl_option='-Werror=implicit-function-declaration'
+else $as_nop
+  gl_cv_compiler_check_decl_option=none
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+       ac_compile="$save_ac_compile"
+     else
+       gl_cv_compiler_check_decl_option=none
+     fi
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_compiler_check_decl_option" >&5
+printf "%s\n" "$gl_cv_compiler_check_decl_option" >&6; }
+  if test "x$gl_cv_compiler_check_decl_option" != xnone; then
+    ac_compile_for_check_decl="$ac_compile $gl_cv_compiler_check_decl_option"
+  else
+    ac_compile_for_check_decl="$ac_compile"
+  fi
+
+
+
+
+
+
+
+
 ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -6339,15 +7554,16 @@
     CXX=$CCC
   else
     if test -n "$ac_tool_prefix"; then
-  for ac_prog in g++ c++ gpp aCC CC cxx cc++ cl.exe FCC KCC RCC xlC_r xlC
+  for ac_prog in g++ c++ gpp aCC CC cxx cc++ cl.exe FCC KCC RCC xlC_r xlC clang++
   do
     # Extract the first word of "$ac_tool_prefix$ac_prog", so it can be a program name with args.
 set dummy $ac_tool_prefix$ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_CXX+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_CXX+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$CXX"; then
   ac_cv_prog_CXX="$CXX" # Let the user override the test.
 else
@@ -6355,11 +7571,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_CXX="$ac_tool_prefix$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6370,11 +7590,11 @@
 fi
 CXX=$ac_cv_prog_CXX
 if test -n "$CXX"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $CXX" >&5
-$as_echo "$CXX" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CXX" >&5
+printf "%s\n" "$CXX" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -6383,15 +7603,16 @@
 fi
 if test -z "$CXX"; then
   ac_ct_CXX=$CXX
-  for ac_prog in g++ c++ gpp aCC CC cxx cc++ cl.exe FCC KCC RCC xlC_r xlC
+  for ac_prog in g++ c++ gpp aCC CC cxx cc++ cl.exe FCC KCC RCC xlC_r xlC clang++
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_CXX+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_CXX+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_CXX"; then
   ac_cv_prog_ac_ct_CXX="$ac_ct_CXX" # Let the user override the test.
 else
@@ -6399,11 +7620,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_CXX="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6414,11 +7639,11 @@
 fi
 ac_ct_CXX=$ac_cv_prog_ac_ct_CXX
 if test -n "$ac_ct_CXX"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CXX" >&5
-$as_echo "$ac_ct_CXX" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_CXX" >&5
+printf "%s\n" "$ac_ct_CXX" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -6430,8 +7655,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     CXX=$ac_ct_CXX
@@ -6441,7 +7666,7 @@
   fi
 fi
 # Provide some information about the compiler.
-$as_echo "$as_me:${as_lineno-$LINENO}: checking for C++ compiler version" >&5
+printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C++ compiler version" >&5
 set X $ac_compile
 ac_compiler=$2
 for ac_option in --version -v -V -qversion; do
@@ -6451,7 +7676,7 @@
   *) ac_try_echo=$ac_try;;
 esac
 eval ac_try_echo="\"\$as_me:${as_lineno-$LINENO}: $ac_try_echo\""
-$as_echo "$ac_try_echo"; } >&5
+printf "%s\n" "$ac_try_echo"; } >&5
   (eval "$ac_compiler $ac_option >&5") 2>conftest.err
   ac_status=$?
   if test -s conftest.err; then
@@ -6461,20 +7686,21 @@
     cat conftest.er1 >&5
   fi
   rm -f conftest.er1 conftest.err
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }
 done
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C++ compiler" >&5
-$as_echo_n "checking whether we are using the GNU C++ compiler... " >&6; }
-if ${ac_cv_cxx_compiler_gnu+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler supports GNU C++" >&5
+printf %s "checking whether the compiler supports GNU C++... " >&6; }
+if test ${ac_cv_cxx_compiler_gnu+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 #ifndef __GNUC__
        choke me
@@ -6484,29 +7710,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   ac_compiler_gnu=yes
-else
+else $as_nop
   ac_compiler_gnu=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 ac_cv_cxx_compiler_gnu=$ac_compiler_gnu
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_cxx_compiler_gnu" >&5
-$as_echo "$ac_cv_cxx_compiler_gnu" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_cxx_compiler_gnu" >&5
+printf "%s\n" "$ac_cv_cxx_compiler_gnu" >&6; }
+ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
+
 if test $ac_compiler_gnu = yes; then
   GXX=yes
 else
   GXX=
 fi
-ac_test_CXXFLAGS=${CXXFLAGS+set}
+ac_test_CXXFLAGS=${CXXFLAGS+y}
 ac_save_CXXFLAGS=$CXXFLAGS
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $CXX accepts -g" >&5
-$as_echo_n "checking whether $CXX accepts -g... " >&6; }
-if ${ac_cv_prog_cxx_g+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $CXX accepts -g" >&5
+printf %s "checking whether $CXX accepts -g... " >&6; }
+if test ${ac_cv_prog_cxx_g+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_save_cxx_werror_flag=$ac_cxx_werror_flag
    ac_cxx_werror_flag=yes
    ac_cv_prog_cxx_g=no
@@ -6515,57 +7745,60 @@
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   ac_cv_prog_cxx_g=yes
-else
+else $as_nop
   CXXFLAGS=""
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
 
-else
+else $as_nop
   ac_cxx_werror_flag=$ac_save_cxx_werror_flag
 	 CXXFLAGS="-g"
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   ac_cv_prog_cxx_g=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_cxx_werror_flag=$ac_save_cxx_werror_flag
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cxx_g" >&5
-$as_echo "$ac_cv_prog_cxx_g" >&6; }
-if test "$ac_test_CXXFLAGS" = set; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cxx_g" >&5
+printf "%s\n" "$ac_cv_prog_cxx_g" >&6; }
+if test $ac_test_CXXFLAGS; then
   CXXFLAGS=$ac_save_CXXFLAGS
 elif test $ac_cv_prog_cxx_g = yes; then
   if test "$GXX" = yes; then
@@ -6580,6 +7813,100 @@
     CXXFLAGS=
   fi
 fi
+ac_prog_cxx_stdcxx=no
+if test x$ac_prog_cxx_stdcxx = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CXX option to enable C++11 features" >&5
+printf %s "checking for $CXX option to enable C++11 features... " >&6; }
+if test ${ac_cv_prog_cxx_11+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cxx_11=no
+ac_save_CXX=$CXX
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_cxx_conftest_cxx11_program
+_ACEOF
+for ac_arg in '' -std=gnu++11 -std=gnu++0x -std=c++11 -std=c++0x -qlanglvl=extended0x -AA
+do
+  CXX="$ac_save_CXX $ac_arg"
+  if ac_fn_cxx_try_compile "$LINENO"
+then :
+  ac_cv_prog_cxx_cxx11=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cxx_cxx11" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CXX=$ac_save_CXX
+fi
+
+if test "x$ac_cv_prog_cxx_cxx11" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cxx_cxx11" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cxx_cxx11" >&5
+printf "%s\n" "$ac_cv_prog_cxx_cxx11" >&6; }
+     CXX="$CXX $ac_cv_prog_cxx_cxx11"
+fi
+  ac_cv_prog_cxx_stdcxx=$ac_cv_prog_cxx_cxx11
+  ac_prog_cxx_stdcxx=cxx11
+fi
+fi
+if test x$ac_prog_cxx_stdcxx = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CXX option to enable C++98 features" >&5
+printf %s "checking for $CXX option to enable C++98 features... " >&6; }
+if test ${ac_cv_prog_cxx_98+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_cv_prog_cxx_98=no
+ac_save_CXX=$CXX
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+$ac_cxx_conftest_cxx98_program
+_ACEOF
+for ac_arg in '' -std=gnu++98 -std=c++98 -qlanglvl=extended -AA
+do
+  CXX="$ac_save_CXX $ac_arg"
+  if ac_fn_cxx_try_compile "$LINENO"
+then :
+  ac_cv_prog_cxx_cxx98=$ac_arg
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam
+  test "x$ac_cv_prog_cxx_cxx98" != "xno" && break
+done
+rm -f conftest.$ac_ext
+CXX=$ac_save_CXX
+fi
+
+if test "x$ac_cv_prog_cxx_cxx98" = xno
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unsupported" >&5
+printf "%s\n" "unsupported" >&6; }
+else $as_nop
+  if test "x$ac_cv_prog_cxx_cxx98" = x
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none needed" >&5
+printf "%s\n" "none needed" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_prog_cxx_cxx98" >&5
+printf "%s\n" "$ac_cv_prog_cxx_cxx98" >&6; }
+     CXX="$CXX $ac_cv_prog_cxx_cxx98"
+fi
+  ac_cv_prog_cxx_stdcxx=$ac_cv_prog_cxx_cxx98
+  ac_prog_cxx_stdcxx=cxx98
+fi
+fi
+
 ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -6588,11 +7915,12 @@
 
 depcc="$CXX"  am_compiler_list=
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5
-$as_echo_n "checking dependency style of $depcc... " >&6; }
-if ${am_cv_CXX_dependencies_compiler_type+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking dependency style of $depcc" >&5
+printf %s "checking dependency style of $depcc... " >&6; }
+if test ${am_cv_CXX_dependencies_compiler_type+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -z "$AMDEP_TRUE" && test -f "$am_depcomp"; then
   # We make a subdir and do the tests there.  Otherwise we can end up
   # making bogus files that we don't know about and never remove.  For
@@ -6699,8 +8027,8 @@
 fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_CXX_dependencies_compiler_type" >&5
-$as_echo "$am_cv_CXX_dependencies_compiler_type" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_CXX_dependencies_compiler_type" >&5
+printf "%s\n" "$am_cv_CXX_dependencies_compiler_type" >&6; }
 CXXDEPMODE=depmode=$am_cv_CXX_dependencies_compiler_type
 
  if
@@ -6716,18 +8044,375 @@
 
 
 
+  # Make sure we can run config.sub.
+$SHELL "${ac_aux_dir}config.sub" sun4 >/dev/null 2>&1 ||
+  as_fn_error $? "cannot run $SHELL ${ac_aux_dir}config.sub" "$LINENO" 5
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking build system type" >&5
+printf %s "checking build system type... " >&6; }
+if test ${ac_cv_build+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_build_alias=$build_alias
+test "x$ac_build_alias" = x &&
+  ac_build_alias=`$SHELL "${ac_aux_dir}config.guess"`
+test "x$ac_build_alias" = x &&
+  as_fn_error $? "cannot guess build type; you must specify one" "$LINENO" 5
+ac_cv_build=`$SHELL "${ac_aux_dir}config.sub" $ac_build_alias` ||
+  as_fn_error $? "$SHELL ${ac_aux_dir}config.sub $ac_build_alias failed" "$LINENO" 5
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_build" >&5
+printf "%s\n" "$ac_cv_build" >&6; }
+case $ac_cv_build in
+*-*-*) ;;
+*) as_fn_error $? "invalid value of canonical build" "$LINENO" 5;;
+esac
+build=$ac_cv_build
+ac_save_IFS=$IFS; IFS='-'
+set x $ac_cv_build
+shift
+build_cpu=$1
+build_vendor=$2
+shift; shift
+# Remember, the first character of IFS is used to create $*,
+# except with old shells:
+build_os=$*
+IFS=$ac_save_IFS
+case $build_os in *\ *) build_os=`echo "$build_os" | sed 's/ /-/g'`;; esac
+
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking host system type" >&5
+printf %s "checking host system type... " >&6; }
+if test ${ac_cv_host+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test "x$host_alias" = x; then
+  ac_cv_host=$ac_cv_build
+else
+  ac_cv_host=`$SHELL "${ac_aux_dir}config.sub" $host_alias` ||
+    as_fn_error $? "$SHELL ${ac_aux_dir}config.sub $host_alias failed" "$LINENO" 5
+fi
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_host" >&5
+printf "%s\n" "$ac_cv_host" >&6; }
+case $ac_cv_host in
+*-*-*) ;;
+*) as_fn_error $? "invalid value of canonical host" "$LINENO" 5;;
+esac
+host=$ac_cv_host
+ac_save_IFS=$IFS; IFS='-'
+set x $ac_cv_host
+shift
+host_cpu=$1
+host_vendor=$2
+shift; shift
+# Remember, the first character of IFS is used to create $*,
+# except with old shells:
+host_os=$*
+IFS=$ac_save_IFS
+case $host_os in *\ *) host_os=`echo "$host_os" | sed 's/ /-/g'`;; esac
+
+
+
+
+
+
+  case "$host_os" in
+    openbsd*)
+
+printf "%s\n" "#define _ISOC11_SOURCE 1" >>confdefs.h
+
+      ;;
+  esac
+
+ac_ext=c
+ac_cpp='$CPP $CPPFLAGS'
+ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
+ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
+ac_compiler_gnu=$ac_cv_c_compiler_gnu
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking how to run the C preprocessor" >&5
+printf %s "checking how to run the C preprocessor... " >&6; }
+# On Suns, sometimes $CPP names a directory.
+if test -n "$CPP" && test -d "$CPP"; then
+  CPP=
+fi
+if test -z "$CPP"; then
+  if test ${ac_cv_prog_CPP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+      # Double quotes because $CC needs to be expanded
+    for CPP in "$CC -E" "$CC -E -traditional-cpp" cpp /lib/cpp
+    do
+      ac_preproc_ok=false
+for ac_c_preproc_warn_flag in '' yes
+do
+  # Use a header file that comes with gcc, so configuring glibc
+  # with a fresh cross-compiler works.
+  # On the NeXT, cc -E runs the code through the compiler's parser,
+  # not just through cpp. "Syntax error" is here to catch this case.
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <limits.h>
+		     Syntax error
+_ACEOF
+if ac_fn_c_try_cpp "$LINENO"
+then :
+
+else $as_nop
+  # Broken: fails on valid input.
+continue
+fi
+rm -f conftest.err conftest.i conftest.$ac_ext
+
+  # OK, works on sane cases.  Now check whether nonexistent headers
+  # can be detected and how.
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <ac_nonexistent.h>
+_ACEOF
+if ac_fn_c_try_cpp "$LINENO"
+then :
+  # Broken: success on invalid input.
+continue
+else $as_nop
+  # Passes both tests.
+ac_preproc_ok=:
+break
+fi
+rm -f conftest.err conftest.i conftest.$ac_ext
+
+done
+# Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
+rm -f conftest.i conftest.err conftest.$ac_ext
+if $ac_preproc_ok
+then :
+  break
+fi
+
+    done
+    ac_cv_prog_CPP=$CPP
+
+fi
+  CPP=$ac_cv_prog_CPP
+else
+  ac_cv_prog_CPP=$CPP
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CPP" >&5
+printf "%s\n" "$CPP" >&6; }
+ac_preproc_ok=false
+for ac_c_preproc_warn_flag in '' yes
+do
+  # Use a header file that comes with gcc, so configuring glibc
+  # with a fresh cross-compiler works.
+  # On the NeXT, cc -E runs the code through the compiler's parser,
+  # not just through cpp. "Syntax error" is here to catch this case.
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <limits.h>
+		     Syntax error
+_ACEOF
+if ac_fn_c_try_cpp "$LINENO"
+then :
+
+else $as_nop
+  # Broken: fails on valid input.
+continue
+fi
+rm -f conftest.err conftest.i conftest.$ac_ext
+
+  # OK, works on sane cases.  Now check whether nonexistent headers
+  # can be detected and how.
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <ac_nonexistent.h>
+_ACEOF
+if ac_fn_c_try_cpp "$LINENO"
+then :
+  # Broken: success on invalid input.
+continue
+else $as_nop
+  # Passes both tests.
+ac_preproc_ok=:
+break
+fi
+rm -f conftest.err conftest.i conftest.$ac_ext
+
+done
+# Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
+rm -f conftest.i conftest.err conftest.$ac_ext
+if $ac_preproc_ok
+then :
+
+else $as_nop
+  { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error $? "C preprocessor \"$CPP\" fails sanity check
+See \`config.log' for more details" "$LINENO" 5; }
+fi
+
+ac_ext=c
+ac_cpp='$CPP $CPPFLAGS'
+ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
+ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
+ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
 
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for grep that handles long lines and -e" >&5
+printf %s "checking for grep that handles long lines and -e... " >&6; }
+if test ${ac_cv_path_GREP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -z "$GREP"; then
+  ac_path_GREP_found=false
+  # Loop through the user's path and test for each of PROGNAME-LIST
+  as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH$PATH_SEPARATOR/usr/xpg4/bin
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_prog in grep ggrep
+   do
+    for ac_exec_ext in '' $ac_executable_extensions; do
+      ac_path_GREP="$as_dir$ac_prog$ac_exec_ext"
+      as_fn_executable_p "$ac_path_GREP" || continue
+# Check for GNU ac_path_GREP and select it if it is found.
+  # Check for GNU $ac_path_GREP
+case `"$ac_path_GREP" --version 2>&1` in
+*GNU*)
+  ac_cv_path_GREP="$ac_path_GREP" ac_path_GREP_found=:;;
+*)
+  ac_count=0
+  printf %s 0123456789 >"conftest.in"
+  while :
+  do
+    cat "conftest.in" "conftest.in" >"conftest.tmp"
+    mv "conftest.tmp" "conftest.in"
+    cp "conftest.in" "conftest.nl"
+    printf "%s\n" 'GREP' >> "conftest.nl"
+    "$ac_path_GREP" -e 'GREP$' -e '-(cannot match)-' < "conftest.nl" >"conftest.out" 2>/dev/null || break
+    diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
+    as_fn_arith $ac_count + 1 && ac_count=$as_val
+    if test $ac_count -gt ${ac_path_GREP_max-0}; then
+      # Best one so far, save it but keep looking for a better one
+      ac_cv_path_GREP="$ac_path_GREP"
+      ac_path_GREP_max=$ac_count
+    fi
+    # 10*(2^10) chars as input seems more than enough
+    test $ac_count -gt 10 && break
+  done
+  rm -f conftest.in conftest.tmp conftest.nl conftest.out;;
+esac
 
+      $ac_path_GREP_found && break 3
+    done
+  done
+  done
+IFS=$as_save_IFS
+  if test -z "$ac_cv_path_GREP"; then
+    as_fn_error $? "no acceptable grep could be found in $PATH$PATH_SEPARATOR/usr/xpg4/bin" "$LINENO" 5
+  fi
+else
+  ac_cv_path_GREP=$GREP
+fi
 
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_GREP" >&5
+printf "%s\n" "$ac_cv_path_GREP" >&6; }
+ GREP="$ac_cv_path_GREP"
 
 
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for egrep" >&5
+printf %s "checking for egrep... " >&6; }
+if test ${ac_cv_path_EGREP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if echo a | $GREP -E '(a|b)' >/dev/null 2>&1
+   then ac_cv_path_EGREP="$GREP -E"
+   else
+     if test -z "$EGREP"; then
+  ac_path_EGREP_found=false
+  # Loop through the user's path and test for each of PROGNAME-LIST
+  as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH$PATH_SEPARATOR/usr/xpg4/bin
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_prog in egrep
+   do
+    for ac_exec_ext in '' $ac_executable_extensions; do
+      ac_path_EGREP="$as_dir$ac_prog$ac_exec_ext"
+      as_fn_executable_p "$ac_path_EGREP" || continue
+# Check for GNU ac_path_EGREP and select it if it is found.
+  # Check for GNU $ac_path_EGREP
+case `"$ac_path_EGREP" --version 2>&1` in
+*GNU*)
+  ac_cv_path_EGREP="$ac_path_EGREP" ac_path_EGREP_found=:;;
+*)
+  ac_count=0
+  printf %s 0123456789 >"conftest.in"
+  while :
+  do
+    cat "conftest.in" "conftest.in" >"conftest.tmp"
+    mv "conftest.tmp" "conftest.in"
+    cp "conftest.in" "conftest.nl"
+    printf "%s\n" 'EGREP' >> "conftest.nl"
+    "$ac_path_EGREP" 'EGREP$' < "conftest.nl" >"conftest.out" 2>/dev/null || break
+    diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
+    as_fn_arith $ac_count + 1 && ac_count=$as_val
+    if test $ac_count -gt ${ac_path_EGREP_max-0}; then
+      # Best one so far, save it but keep looking for a better one
+      ac_cv_path_EGREP="$ac_path_EGREP"
+      ac_path_EGREP_max=$ac_count
+    fi
+    # 10*(2^10) chars as input seems more than enough
+    test $ac_count -gt 10 && break
+  done
+  rm -f conftest.in conftest.tmp conftest.nl conftest.out;;
+esac
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for Minix Amsterdam compiler" >&5
-$as_echo_n "checking for Minix Amsterdam compiler... " >&6; }
-if ${gl_cv_c_amsterdam_compiler+:} false; then :
-  $as_echo_n "(cached) " >&6
+      $ac_path_EGREP_found && break 3
+    done
+  done
+  done
+IFS=$as_save_IFS
+  if test -z "$ac_cv_path_EGREP"; then
+    as_fn_error $? "no acceptable egrep could be found in $PATH$PATH_SEPARATOR/usr/xpg4/bin" "$LINENO" 5
+  fi
 else
+  ac_cv_path_EGREP=$EGREP
+fi
+
+   fi
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_EGREP" >&5
+printf "%s\n" "$ac_cv_path_EGREP" >&6; }
+ EGREP="$ac_cv_path_EGREP"
+
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for Minix Amsterdam compiler" >&5
+printf %s "checking for Minix Amsterdam compiler... " >&6; }
+if test ${gl_cv_c_amsterdam_compiler+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -6738,17 +8423,18 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Amsterdam" >/dev/null 2>&1; then :
+  $EGREP "Amsterdam" >/dev/null 2>&1
+then :
   gl_cv_c_amsterdam_compiler=yes
-else
+else $as_nop
   gl_cv_c_amsterdam_compiler=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_c_amsterdam_compiler" >&5
-$as_echo "$gl_cv_c_amsterdam_compiler" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_c_amsterdam_compiler" >&5
+printf "%s\n" "$gl_cv_c_amsterdam_compiler" >&6; }
 
       if test $gl_cv_c_amsterdam_compiler = yes; then
     if test -z "$AR"; then
@@ -6764,11 +8450,12 @@
         if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}ar", so it can be a program name with args.
 set dummy ${ac_tool_prefix}ar; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_AR+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_AR+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$AR"; then
   ac_cv_prog_AR="$AR" # Let the user override the test.
 else
@@ -6776,11 +8463,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_AR="${ac_tool_prefix}ar"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6791,11 +8482,11 @@
 fi
 AR=$ac_cv_prog_AR
 if test -n "$AR"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $AR" >&5
-$as_echo "$AR" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $AR" >&5
+printf "%s\n" "$AR" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -6804,11 +8495,12 @@
   ac_ct_AR=$AR
   # Extract the first word of "ar", so it can be a program name with args.
 set dummy ar; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_AR+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_AR+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_AR"; then
   ac_cv_prog_ac_ct_AR="$ac_ct_AR" # Let the user override the test.
 else
@@ -6816,11 +8508,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_AR="ar"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6831,11 +8527,11 @@
 fi
 ac_ct_AR=$ac_cv_prog_ac_ct_AR
 if test -n "$ac_ct_AR"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_AR" >&5
-$as_echo "$ac_ct_AR" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_AR" >&5
+printf "%s\n" "$ac_ct_AR" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_AR" = x; then
@@ -6843,8 +8539,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     AR=$ac_ct_AR
@@ -6866,11 +8562,12 @@
             if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}ranlib", so it can be a program name with args.
 set dummy ${ac_tool_prefix}ranlib; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_RANLIB+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_RANLIB+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$RANLIB"; then
   ac_cv_prog_RANLIB="$RANLIB" # Let the user override the test.
 else
@@ -6878,11 +8575,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_RANLIB="${ac_tool_prefix}ranlib"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6893,11 +8594,11 @@
 fi
 RANLIB=$ac_cv_prog_RANLIB
 if test -n "$RANLIB"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $RANLIB" >&5
-$as_echo "$RANLIB" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $RANLIB" >&5
+printf "%s\n" "$RANLIB" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -6906,11 +8607,12 @@
   ac_ct_RANLIB=$RANLIB
   # Extract the first word of "ranlib", so it can be a program name with args.
 set dummy ranlib; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_RANLIB+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_RANLIB+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_RANLIB"; then
   ac_cv_prog_ac_ct_RANLIB="$ac_ct_RANLIB" # Let the user override the test.
 else
@@ -6918,11 +8620,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_RANLIB="ranlib"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -6933,11 +8639,11 @@
 fi
 ac_ct_RANLIB=$ac_cv_prog_ac_ct_RANLIB
 if test -n "$ac_ct_RANLIB"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_RANLIB" >&5
-$as_echo "$ac_ct_RANLIB" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_RANLIB" >&5
+printf "%s\n" "$ac_ct_RANLIB" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_RANLIB" = x; then
@@ -6945,8 +8651,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     RANLIB=$ac_ct_RANLIB
@@ -6960,78 +8666,6 @@
 
 
 
-# Make sure we can run config.sub.
-$SHELL "$ac_aux_dir/config.sub" sun4 >/dev/null 2>&1 ||
-  as_fn_error $? "cannot run $SHELL $ac_aux_dir/config.sub" "$LINENO" 5
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking build system type" >&5
-$as_echo_n "checking build system type... " >&6; }
-if ${ac_cv_build+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  ac_build_alias=$build_alias
-test "x$ac_build_alias" = x &&
-  ac_build_alias=`$SHELL "$ac_aux_dir/config.guess"`
-test "x$ac_build_alias" = x &&
-  as_fn_error $? "cannot guess build type; you must specify one" "$LINENO" 5
-ac_cv_build=`$SHELL "$ac_aux_dir/config.sub" $ac_build_alias` ||
-  as_fn_error $? "$SHELL $ac_aux_dir/config.sub $ac_build_alias failed" "$LINENO" 5
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_build" >&5
-$as_echo "$ac_cv_build" >&6; }
-case $ac_cv_build in
-*-*-*) ;;
-*) as_fn_error $? "invalid value of canonical build" "$LINENO" 5;;
-esac
-build=$ac_cv_build
-ac_save_IFS=$IFS; IFS='-'
-set x $ac_cv_build
-shift
-build_cpu=$1
-build_vendor=$2
-shift; shift
-# Remember, the first character of IFS is used to create $*,
-# except with old shells:
-build_os=$*
-IFS=$ac_save_IFS
-case $build_os in *\ *) build_os=`echo "$build_os" | sed 's/ /-/g'`;; esac
-
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking host system type" >&5
-$as_echo_n "checking host system type... " >&6; }
-if ${ac_cv_host+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test "x$host_alias" = x; then
-  ac_cv_host=$ac_cv_build
-else
-  ac_cv_host=`$SHELL "$ac_aux_dir/config.sub" $host_alias` ||
-    as_fn_error $? "$SHELL $ac_aux_dir/config.sub $host_alias failed" "$LINENO" 5
-fi
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_host" >&5
-$as_echo "$ac_cv_host" >&6; }
-case $ac_cv_host in
-*-*-*) ;;
-*) as_fn_error $? "invalid value of canonical host" "$LINENO" 5;;
-esac
-host=$ac_cv_host
-ac_save_IFS=$IFS; IFS='-'
-set x $ac_cv_host
-shift
-host_cpu=$1
-host_vendor=$2
-shift; shift
-# Remember, the first character of IFS is used to create $*,
-# except with old shells:
-host_os=$*
-IFS=$ac_save_IFS
-case $host_os in *\ *) host_os=`echo "$host_os" | sed 's/ /-/g'`;; esac
-
-
-
 
 
   # IEEE behaviour is the default on all CPUs except Alpha and SH
@@ -7066,9 +8700,10 @@
 
 
 
-
   # Code from module absolute-header:
   # Code from module alloca-opt:
+  # Code from module assert-h:
+  # Code from module attribute:
   # Code from module errno:
   # Code from module extensions:
   # Code from module extern-inline:
@@ -7077,13 +8712,15 @@
 
   # Code from module fprintf-posix:
   # Code from module fpucw:
+  # Code from module free-posix:
   # Code from module frexp-nolibm:
   # Code from module frexpl-nolibm:
   # Code from module fseterr:
+  # Code from module gen-header:
   # Code from module git-version-gen:
   # Code from module havelib:
-  # Code from module host-cpu-c-abi:
   # Code from module include_next:
+  # Code from module inttypes-incomplete:
   # Code from module isnand-nolibm:
   # Code from module isnanf-nolibm:
   # Code from module isnanl-nolibm:
@@ -7093,28 +8730,30 @@
   # Code from module memchr:
   # Code from module multiarch:
   # Code from module nocrash:
-  # Code from module non-recursive-gnulib-prefix-hack:
   # Code from module printf-frexp:
   # Code from module printf-frexpl:
   # Code from module printf-safe:
   # Code from module signbit:
   # Code from module size_max:
+  # Code from module snippet/_Noreturn:
   # Code from module snippet/arg-nonnull:
   # Code from module snippet/c++defs:
   # Code from module snippet/warn-on-use:
   # Code from module snprintf:
   # Code from module ssize_t:
+  # Code from module stdbool-c99:
   # Code from module stddef:
   # Code from module stdint:
   # Code from module stdio:
+  # Code from module stdlib:
   # Code from module streq:
   # Code from module string:
   # Code from module sys_types:
+  # Code from module unistd:
   # Code from module unitypes:
   # Code from module uniwidth/base:
   # Code from module uniwidth/width:
   # Code from module vasnprintf:
-  # Code from module verify:
   # Code from module vsnprintf:
   # Code from module wchar:
   # Code from module wctype-h:
@@ -7126,32 +8765,56 @@
 
 
 
+
+
+
+                        # Check whether --enable-cross-guesses was given.
+if test ${enable_cross_guesses+y}
+then :
+  enableval=$enable_cross_guesses; if test "x$enableval" != xconservative && test "x$enableval" != xrisky; then
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: invalid argument supplied to --enable-cross-guesses" >&5
+printf "%s\n" "$as_me: WARNING: invalid argument supplied to --enable-cross-guesses" >&2;}
+       enableval=conservative
+     fi
+     gl_cross_guesses="$enableval"
+else $as_nop
+  gl_cross_guesses=conservative
+fi
+
+  if test $gl_cross_guesses = risky; then
+    gl_cross_guess_normal="guessing yes"
+    gl_cross_guess_inverted="guessing no"
+  else
+    gl_cross_guess_normal="guessing no"
+    gl_cross_guess_inverted="guessing yes"
+  fi
           LIBC_FATAL_STDERR_=1
   export LIBC_FATAL_STDERR_
 
+
 ac_fn_c_check_type "$LINENO" "size_t" "ac_cv_type_size_t" "$ac_includes_default"
-if test "x$ac_cv_type_size_t" = xyes; then :
+if test "x$ac_cv_type_size_t" = xyes
+then :
 
-else
+else $as_nop
 
-cat >>confdefs.h <<_ACEOF
-#define size_t unsigned int
-_ACEOF
+printf "%s\n" "#define size_t unsigned int" >>confdefs.h
 
 fi
 
 # The Ultrix 4.2 mips builtin alloca declared by alloca.h only works
 # for constant arguments.  Useless!
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for working alloca.h" >&5
-$as_echo_n "checking for working alloca.h... " >&6; }
-if ${ac_cv_working_alloca_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for working alloca.h" >&5
+printf %s "checking for working alloca.h... " >&6; }
+if test ${ac_cv_working_alloca_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <alloca.h>
 int
-main ()
+main (void)
 {
 char *p = (char *) alloca (2 * sizeof (int));
 			  if (p) return 0;
@@ -7159,52 +8822,52 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_working_alloca_h=yes
-else
+else $as_nop
   ac_cv_working_alloca_h=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_working_alloca_h" >&5
-$as_echo "$ac_cv_working_alloca_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_working_alloca_h" >&5
+printf "%s\n" "$ac_cv_working_alloca_h" >&6; }
 if test $ac_cv_working_alloca_h = yes; then
 
-$as_echo "#define HAVE_ALLOCA_H 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ALLOCA_H 1" >>confdefs.h
 
 fi
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for alloca" >&5
-$as_echo_n "checking for alloca... " >&6; }
-if ${ac_cv_func_alloca_works+:} false; then :
-  $as_echo_n "(cached) " >&6
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for alloca" >&5
+printf %s "checking for alloca... " >&6; }
+if test ${ac_cv_func_alloca_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test $ac_cv_working_alloca_h = yes; then
+  ac_cv_func_alloca_works=yes
 else
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#ifdef __GNUC__
-# define alloca __builtin_alloca
-#else
-# ifdef _MSC_VER
+#include <stdlib.h>
+#include <stddef.h>
+#ifndef alloca
+# ifdef __GNUC__
+#  define alloca __builtin_alloca
+# elif defined _MSC_VER
 #  include <malloc.h>
 #  define alloca _alloca
 # else
-#  ifdef HAVE_ALLOCA_H
-#   include <alloca.h>
-#  else
-#   ifdef _AIX
- #pragma alloca
-#   else
-#    ifndef alloca /* predefined by HP cc +Olibcalls */
-void *alloca (size_t);
-#    endif
-#   endif
+#  ifdef  __cplusplus
+extern "C"
 #  endif
+void *alloca (size_t);
 # endif
 #endif
 
 int
-main ()
+main (void)
 {
 char *p = (char *) alloca (1);
 				    if (p) return 0;
@@ -7212,20 +8875,22 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_func_alloca_works=yes
-else
+else $as_nop
   ac_cv_func_alloca_works=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_func_alloca_works" >&5
-$as_echo "$ac_cv_func_alloca_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_func_alloca_works" >&5
+printf "%s\n" "$ac_cv_func_alloca_works" >&6; }
+fi
 
 if test $ac_cv_func_alloca_works = yes; then
 
-$as_echo "#define HAVE_ALLOCA 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ALLOCA 1" >>confdefs.h
 
 else
   # The SVR3 libPW and SVR4 libucb both contain incompatible functions
@@ -7239,58 +8904,19 @@
 
 ALLOCA=\${LIBOBJDIR}alloca.$ac_objext
 
-$as_echo "#define C_ALLOCA 1" >>confdefs.h
-
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether \`alloca.c' needs Cray hooks" >&5
-$as_echo_n "checking whether \`alloca.c' needs Cray hooks... " >&6; }
-if ${ac_cv_os_cray+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined CRAY && ! defined CRAY2
-webecray
-#else
-wenotbecray
-#endif
-
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "webecray" >/dev/null 2>&1; then :
-  ac_cv_os_cray=yes
-else
-  ac_cv_os_cray=no
-fi
-rm -f conftest*
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_os_cray" >&5
-$as_echo "$ac_cv_os_cray" >&6; }
-if test $ac_cv_os_cray = yes; then
-  for ac_func in _getb67 GETB67 getb67; do
-    as_ac_var=`$as_echo "ac_cv_func_$ac_func" | $as_tr_sh`
-ac_fn_c_check_func "$LINENO" "$ac_func" "$as_ac_var"
-if eval test \"x\$"$as_ac_var"\" = x"yes"; then :
-
-cat >>confdefs.h <<_ACEOF
-#define CRAY_STACKSEG_END $ac_func
-_ACEOF
-
-    break
-fi
+printf "%s\n" "#define C_ALLOCA 1" >>confdefs.h
 
-  done
-fi
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking stack direction for C alloca" >&5
-$as_echo_n "checking stack direction for C alloca... " >&6; }
-if ${ac_cv_c_stack_direction+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test "$cross_compiling" = yes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking stack direction for C alloca" >&5
+printf %s "checking stack direction for C alloca... " >&6; }
+if test ${ac_cv_c_stack_direction+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test "$cross_compiling" = yes
+then :
   ac_cv_c_stack_direction=0
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $ac_includes_default
@@ -7311,9 +8937,10 @@
   return find_stack_direction (0, argc + !argv + 20) < 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   ac_cv_c_stack_direction=1
-else
+else $as_nop
   ac_cv_c_stack_direction=-1
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -7321,22 +8948,21 @@
 fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_stack_direction" >&5
-$as_echo "$ac_cv_c_stack_direction" >&6; }
-cat >>confdefs.h <<_ACEOF
-#define STACK_DIRECTION $ac_cv_c_stack_direction
-_ACEOF
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_stack_direction" >&5
+printf "%s\n" "$ac_cv_c_stack_direction" >&6; }
+printf "%s\n" "#define STACK_DIRECTION $ac_cv_c_stack_direction" >>confdefs.h
 
 
 fi
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether the preprocessor supports include_next" >&5
-$as_echo_n "checking whether the preprocessor supports include_next... " >&6; }
-if ${gl_cv_have_include_next+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the preprocessor supports include_next" >&5
+printf %s "checking whether the preprocessor supports include_next... " >&6; }
+if test ${gl_cv_have_include_next+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   rm -rf conftestd1a conftestd1b conftestd2
      mkdir conftestd1a conftestd1b conftestd2
                                                   cat <<EOF > conftestd1a/conftest.h
@@ -7370,29 +8996,31 @@
 /* end confdefs.h.  */
 #include <conftest.h>
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_have_include_next=yes
-else
+else $as_nop
   CPPFLAGS="$gl_save_CPPFLAGS -Iconftestd1a -Iconftestd2"
         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <conftest.h>
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_have_include_next=buggy
-else
+else $as_nop
   gl_cv_have_include_next=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
      CPPFLAGS="$gl_save_CPPFLAGS"
      rm -rf conftestd1a conftestd1b conftestd2
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_have_include_next" >&5
-$as_echo "$gl_cv_have_include_next" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_have_include_next" >&5
+printf "%s\n" "$gl_cv_have_include_next" >&6; }
   PRAGMA_SYSTEM_HEADER=
   if test $gl_cv_have_include_next = yes; then
     INCLUDE_NEXT=include_next
@@ -7412,12 +9040,14 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether system header files limit the line length" >&5
-$as_echo_n "checking whether system header files limit the line length... " >&6; }
-if ${gl_cv_pragma_columns+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether source code line length is unlimited" >&5
+printf %s "checking whether source code line length is unlimited... " >&6; }
+if test ${gl_cv_source_line_length_unlimited+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #ifdef __TANDEM
@@ -7426,18 +9056,19 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "choke me" >/dev/null 2>&1; then :
-  gl_cv_pragma_columns=yes
-else
-  gl_cv_pragma_columns=no
+  $EGREP "choke me" >/dev/null 2>&1
+then :
+  gl_cv_source_line_length_unlimited=no
+else $as_nop
+  gl_cv_source_line_length_unlimited=yes
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_pragma_columns" >&5
-$as_echo "$gl_cv_pragma_columns" >&6; }
-  if test $gl_cv_pragma_columns = yes; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_source_line_length_unlimited" >&5
+printf "%s\n" "$gl_cv_source_line_length_unlimited" >&6; }
+  if test $gl_cv_source_line_length_unlimited = no; then
     PRAGMA_COLUMNS="#pragma COLUMNS 10000"
   else
     PRAGMA_COLUMNS=
@@ -7446,11 +9077,12 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for complete errno.h" >&5
-$as_echo_n "checking for complete errno.h... " >&6; }
-if ${gl_cv_header_errno_h_complete+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for complete errno.h" >&5
+printf %s "checking for complete errno.h... " >&6; }
+if test ${gl_cv_header_errno_h_complete+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -7510,19 +9142,20 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "booboo" >/dev/null 2>&1; then :
+  $EGREP "booboo" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_complete=no
-else
+else $as_nop
   gl_cv_header_errno_h_complete=yes
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_complete" >&5
-$as_echo "$gl_cv_header_errno_h_complete" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_complete" >&5
+printf "%s\n" "$gl_cv_header_errno_h_complete" >&6; }
   if test $gl_cv_header_errno_h_complete = yes; then
-    ERRNO_H=''
+    GL_GENERATE_ERRNO_H=false
   else
 
 
@@ -7535,11 +9168,12 @@
      if test $gl_cv_have_include_next = yes; then
        gl_cv_next_errno_h='<'errno.h'>'
      else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <errno.h>" >&5
-$as_echo_n "checking absolute name of <errno.h>... " >&6; }
-if ${gl_cv_next_errno_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <errno.h>" >&5
+printf %s "checking absolute name of <errno.h>... " >&6; }
+if test ${gl_cv_next_errno_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
 
 
@@ -7573,13 +9207,13 @@
         gl_cv_absolute_errno_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
   sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_errno_h
-           gl_cv_next_errno_h='"'$gl_header'"'
+          gl_header=$gl_cv_absolute_errno_h
+          gl_cv_next_errno_h='"'$gl_header'"'
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_errno_h" >&5
-$as_echo "$gl_cv_next_errno_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_errno_h" >&5
+printf "%s\n" "$gl_cv_next_errno_h" >&6; }
      fi
      NEXT_ERRNO_H=$gl_cv_next_errno_h
 
@@ -7595,24 +9229,16 @@
 
 
 
-    ERRNO_H='errno.h'
+    GL_GENERATE_ERRNO_H=true
   fi
 
-   if test -n "$ERRNO_H"; then
-  GL_GENERATE_ERRNO_H_TRUE=
-  GL_GENERATE_ERRNO_H_FALSE='#'
-else
-  GL_GENERATE_ERRNO_H_TRUE='#'
-  GL_GENERATE_ERRNO_H_FALSE=
-fi
-
-
-  if test -n "$ERRNO_H"; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for EMULTIHOP value" >&5
-$as_echo_n "checking for EMULTIHOP value... " >&6; }
-if ${gl_cv_header_errno_h_EMULTIHOP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  if $GL_GENERATE_ERRNO_H; then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for EMULTIHOP value" >&5
+printf %s "checking for EMULTIHOP value... " >&6; }
+if test ${gl_cv_header_errno_h_EMULTIHOP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -7624,12 +9250,13 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_EMULTIHOP=yes
-else
+else $as_nop
   gl_cv_header_errno_h_EMULTIHOP=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
       if test $gl_cv_header_errno_h_EMULTIHOP = no; then
         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -7643,10 +9270,11 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_EMULTIHOP=hidden
 fi
-rm -f conftest*
+rm -rf conftest*
 
         if test $gl_cv_header_errno_h_EMULTIHOP = hidden; then
                               if ac_fn_c_compute_int "$LINENO" "EMULTIHOP" "gl_cv_header_errno_h_EMULTIHOP"        "
@@ -7655,7 +9283,8 @@
 /* The following two lines are a workaround against an autoconf-2.52 bug.  */
 #include <stdio.h>
 #include <stdlib.h>
-"; then :
+"
+then :
 
 fi
 
@@ -7663,8 +9292,8 @@
       fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_EMULTIHOP" >&5
-$as_echo "$gl_cv_header_errno_h_EMULTIHOP" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_EMULTIHOP" >&5
+printf "%s\n" "$gl_cv_header_errno_h_EMULTIHOP" >&6; }
     case $gl_cv_header_errno_h_EMULTIHOP in
       yes | no)
         EMULTIHOP_HIDDEN=0; EMULTIHOP_VALUE=
@@ -7678,12 +9307,13 @@
   fi
 
 
-  if test -n "$ERRNO_H"; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for ENOLINK value" >&5
-$as_echo_n "checking for ENOLINK value... " >&6; }
-if ${gl_cv_header_errno_h_ENOLINK+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  if $GL_GENERATE_ERRNO_H; then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ENOLINK value" >&5
+printf %s "checking for ENOLINK value... " >&6; }
+if test ${gl_cv_header_errno_h_ENOLINK+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -7695,12 +9325,13 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_ENOLINK=yes
-else
+else $as_nop
   gl_cv_header_errno_h_ENOLINK=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
       if test $gl_cv_header_errno_h_ENOLINK = no; then
         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -7714,10 +9345,11 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_ENOLINK=hidden
 fi
-rm -f conftest*
+rm -rf conftest*
 
         if test $gl_cv_header_errno_h_ENOLINK = hidden; then
                               if ac_fn_c_compute_int "$LINENO" "ENOLINK" "gl_cv_header_errno_h_ENOLINK"        "
@@ -7726,7 +9358,8 @@
 /* The following two lines are a workaround against an autoconf-2.52 bug.  */
 #include <stdio.h>
 #include <stdlib.h>
-"; then :
+"
+then :
 
 fi
 
@@ -7734,8 +9367,8 @@
       fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_ENOLINK" >&5
-$as_echo "$gl_cv_header_errno_h_ENOLINK" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_ENOLINK" >&5
+printf "%s\n" "$gl_cv_header_errno_h_ENOLINK" >&6; }
     case $gl_cv_header_errno_h_ENOLINK in
       yes | no)
         ENOLINK_HIDDEN=0; ENOLINK_VALUE=
@@ -7749,12 +9382,13 @@
   fi
 
 
-  if test -n "$ERRNO_H"; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for EOVERFLOW value" >&5
-$as_echo_n "checking for EOVERFLOW value... " >&6; }
-if ${gl_cv_header_errno_h_EOVERFLOW+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  if $GL_GENERATE_ERRNO_H; then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for EOVERFLOW value" >&5
+printf %s "checking for EOVERFLOW value... " >&6; }
+if test ${gl_cv_header_errno_h_EOVERFLOW+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -7766,12 +9400,13 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_EOVERFLOW=yes
-else
+else $as_nop
   gl_cv_header_errno_h_EOVERFLOW=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
       if test $gl_cv_header_errno_h_EOVERFLOW = no; then
         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -7785,10 +9420,11 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "yes" >/dev/null 2>&1; then :
+  $EGREP "yes" >/dev/null 2>&1
+then :
   gl_cv_header_errno_h_EOVERFLOW=hidden
 fi
-rm -f conftest*
+rm -rf conftest*
 
         if test $gl_cv_header_errno_h_EOVERFLOW = hidden; then
                               if ac_fn_c_compute_int "$LINENO" "EOVERFLOW" "gl_cv_header_errno_h_EOVERFLOW"        "
@@ -7797,7 +9433,8 @@
 /* The following two lines are a workaround against an autoconf-2.52 bug.  */
 #include <stdio.h>
 #include <stdlib.h>
-"; then :
+"
+then :
 
 fi
 
@@ -7805,8 +9442,8 @@
       fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_EOVERFLOW" >&5
-$as_echo "$gl_cv_header_errno_h_EOVERFLOW" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_errno_h_EOVERFLOW" >&5
+printf "%s\n" "$gl_cv_header_errno_h_EOVERFLOW" >&6; }
     case $gl_cv_header_errno_h_EOVERFLOW in
       yes | no)
         EOVERFLOW_HIDDEN=0; EOVERFLOW_VALUE=
@@ -7821,49 +9458,80 @@
 
 
 
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ctype.h defines __header_inline" >&5
+printf %s "checking whether ctype.h defines __header_inline... " >&6; }
+if test ${gl_cv_have___header_inline+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <ctype.h>
+                         #ifndef __header_inline
+                          #error "<ctype.h> does not define __header_inline"
+                         #endif
 
+_ACEOF
+if ac_fn_c_try_cpp "$LINENO"
+then :
+  gl_cv_have___header_inline=yes
+else $as_nop
+  gl_cv_have___header_inline=no
+fi
+rm -f conftest.err conftest.i conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_have___header_inline" >&5
+printf "%s\n" "$gl_cv_have___header_inline" >&6; }
+  if test "$gl_cv_have___header_inline" = yes; then
 
+printf "%s\n" "#define HAVE___HEADER_INLINE 1" >>confdefs.h
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for stdint.h" >&5
-$as_echo_n "checking for stdint.h... " >&6; }
-if ${gl_cv_header_stdint_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  fi
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for stdint.h" >&5
+printf %s "checking for stdint.h... " >&6; }
+if test ${gl_cv_header_stdint_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <sys/types.h>
             #include <stdint.h>
 int
-main ()
+main (void)
 {
 uintmax_t i = (uintmax_t) -1; return !i;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_header_stdint_h=yes
-else
+else $as_nop
   gl_cv_header_stdint_h=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_h" >&5
-$as_echo "$gl_cv_header_stdint_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_h" >&5
+printf "%s\n" "$gl_cv_header_stdint_h" >&6; }
   if test $gl_cv_header_stdint_h = yes; then
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_STDINT_H_WITH_UINTMAX 1
-_ACEOF
+printf "%s\n" "#define HAVE_STDINT_H_WITH_UINTMAX 1" >>confdefs.h
 
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for inttypes.h" >&5
-$as_echo_n "checking for inttypes.h... " >&6; }
-if ${gl_cv_header_inttypes_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for inttypes.h" >&5
+printf %s "checking for inttypes.h... " >&6; }
+if test ${gl_cv_header_inttypes_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -7871,27 +9539,26 @@
 #include <inttypes.h>
 
 int
-main ()
+main (void)
 {
 uintmax_t i = (uintmax_t) -1; return !i;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_header_inttypes_h=yes
-else
+else $as_nop
   gl_cv_header_inttypes_h=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_inttypes_h" >&5
-$as_echo "$gl_cv_header_inttypes_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_inttypes_h" >&5
+printf "%s\n" "$gl_cv_header_inttypes_h" >&6; }
   if test $gl_cv_header_inttypes_h = yes; then
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_INTTYPES_H_WITH_UINTMAX 1
-_ACEOF
+printf "%s\n" "#define HAVE_INTTYPES_H_WITH_UINTMAX 1" >>confdefs.h
 
   fi
 
@@ -7899,20 +9566,25 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports size specifiers as in C99" >&5
-$as_echo_n "checking whether printf supports size specifiers as in C99... " >&6; }
-if ${gl_cv_func_printf_sizes_c99+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports size specifiers as in C99" >&5
+printf %s "checking whether printf supports size specifiers as in C99... " >&6; }
+if test ${gl_cv_func_printf_sizes_c99+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_sizes_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_sizes_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_printf_sizes_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_sizes_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_sizes_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_sizes_c99="guessing no";;
            darwin*)              gl_cv_func_printf_sizes_c99="guessing yes";;
@@ -7927,6 +9599,8 @@
            netbsd1-2* | netbsdelf1-2* | netbsdaout1-2* | netbsdcoff1-2*)
                                  gl_cv_func_printf_sizes_c99="guessing no";;
            netbsd*)              gl_cv_func_printf_sizes_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_printf_sizes_c99="guessing yes";;
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -7937,19 +9611,20 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_printf_sizes_c99="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_sizes_c99="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_sizes_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_sizes_c99="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -7990,9 +9665,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_sizes_c99=yes
-else
+else $as_nop
   gl_cv_func_printf_sizes_c99=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8001,22 +9677,27 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_sizes_c99" >&5
-$as_echo "$gl_cv_func_printf_sizes_c99" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_sizes_c99" >&5
+printf "%s\n" "$gl_cv_func_printf_sizes_c99" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports 'long double' arguments" >&5
-$as_echo_n "checking whether printf supports 'long double' arguments... " >&6; }
-if ${gl_cv_func_printf_long_double+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports 'long double' arguments" >&5
+printf %s "checking whether printf supports 'long double' arguments... " >&6; }
+if test ${gl_cv_func_printf_long_double+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
-           beos*)  gl_cv_func_printf_long_double="guessing no";;
-                   # Guess yes on MSVC, no on mingw.
-           mingw*) cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+                            # Guess no on BeOS.
+           beos*)           gl_cv_func_printf_long_double="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_long_double="guessing yes";;
+                            # Guess yes on MSVC, no on mingw.
+           mingw*)          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #ifdef _MSC_VER
@@ -8025,18 +9706,19 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_printf_long_double="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_long_double="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
-                   ;;
-           *)      gl_cv_func_printf_long_double="guessing yes";;
+                            ;;
+           *)               gl_cv_func_printf_long_double="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -8061,9 +9743,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_long_double=yes
-else
+else $as_nop
   gl_cv_func_printf_long_double=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8072,25 +9755,30 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_long_double" >&5
-$as_echo "$gl_cv_func_printf_long_double" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_long_double" >&5
+printf "%s\n" "$gl_cv_func_printf_long_double" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports infinite 'double' arguments" >&5
-$as_echo_n "checking whether printf supports infinite 'double' arguments... " >&6; }
-if ${gl_cv_func_printf_infinite+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports infinite 'double' arguments" >&5
+printf %s "checking whether printf supports infinite 'double' arguments... " >&6; }
+if test ${gl_cv_func_printf_infinite+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on FreeBSD >= 6.
            freebsd1-5.*)       gl_cv_func_printf_infinite="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_infinite="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_infinite="guessing no";;
            darwin*)              gl_cv_func_printf_infinite="guessing yes";;
@@ -8101,8 +9789,13 @@
            netbsd1-2* | netbsdelf1-2* | netbsdaout1-2* | netbsdcoff1-2*)
                                  gl_cv_func_printf_infinite="guessing no";;
            netbsd*)              gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)       gl_cv_func_printf_infinite="guessing no";;
+           openbsd*)             gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_infinite="guessing no";;
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -8113,19 +9806,20 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_printf_infinite="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_infinite="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_infinite="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_infinite="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -8196,9 +9890,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_infinite=yes
-else
+else $as_nop
   gl_cv_func_printf_infinite=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8207,15 +9902,16 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_infinite" >&5
-$as_echo "$gl_cv_func_printf_infinite" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_infinite" >&5
+printf "%s\n" "$gl_cv_func_printf_infinite" >&6; }
 
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether byte ordering is bigendian" >&5
-$as_echo_n "checking whether byte ordering is bigendian... " >&6; }
-if ${ac_cv_c_bigendian+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether byte ordering is bigendian" >&5
+printf %s "checking whether byte ordering is bigendian... " >&6; }
+if test ${ac_cv_c_bigendian+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_c_bigendian=unknown
     # See if we're dealing with a universal compiler.
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -8226,7 +9922,8 @@
 	     typedef int dummy;
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
 	# Check for potential -arch flags.  It is not universal unless
 	# there are at least two -arch flags with different values.
@@ -8250,7 +9947,7 @@
 	 fi
        done
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     if test $ac_cv_c_bigendian = unknown; then
       # See if sys/param.h defines the BYTE_ORDER macro.
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -8259,7 +9956,7 @@
 	     #include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined BYTE_ORDER && defined BIG_ENDIAN \
 		     && defined LITTLE_ENDIAN && BYTE_ORDER && BIG_ENDIAN \
@@ -8271,7 +9968,8 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -8279,7 +9977,7 @@
 		#include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if BYTE_ORDER != BIG_ENDIAN
 		 not big endian
@@ -8289,14 +9987,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # See if <limits.h> defines _LITTLE_ENDIAN or _BIG_ENDIAN (e.g., Solaris).
@@ -8305,7 +10004,7 @@
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined _LITTLE_ENDIAN || defined _BIG_ENDIAN)
 	      bogus endian macros
@@ -8315,14 +10014,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to _BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #ifndef _BIG_ENDIAN
 		 not big endian
@@ -8332,31 +10032,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # Compile a test program.
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   # Try to guess by grepping values from an object file.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-short int ascii_mm =
+unsigned short int ascii_mm =
 		  { 0x4249, 0x4765, 0x6E44, 0x6961, 0x6E53, 0x7953, 0 };
-		short int ascii_ii =
+		unsigned short int ascii_ii =
 		  { 0x694C, 0x5454, 0x656C, 0x6E45, 0x6944, 0x6E61, 0 };
 		int use_ascii (int i) {
 		  return ascii_mmi + ascii_iii;
 		}
-		short int ebcdic_ii =
+		unsigned short int ebcdic_ii =
 		  { 0x89D3, 0xE3E3, 0x8593, 0x95C5, 0x89C4, 0x9581, 0 };
-		short int ebcdic_mm =
+		unsigned short int ebcdic_mm =
 		  { 0xC2C9, 0xC785, 0x95C4, 0x8981, 0x95E2, 0xA8E2, 0 };
 		int use_ebcdic (int i) {
 		  return ebcdic_mmi + ebcdic_iii;
@@ -8364,14 +10066,15 @@
 		extern int foo;
 
 int
-main ()
+main (void)
 {
 return use_ascii (foo) == use_ebcdic (foo);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   if grep BIGenDianSyS conftest.$ac_objext >/dev/null; then
 	      ac_cv_c_bigendian=yes
 	    fi
@@ -8384,13 +10087,13 @@
 	      fi
 	    fi
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-else
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $ac_includes_default
 int
-main ()
+main (void)
 {
 
 	     /* Are we little or big endian?  From Harbison&Steele.  */
@@ -8406,9 +10109,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   ac_cv_c_bigendian=no
-else
+else $as_nop
   ac_cv_c_bigendian=yes
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8417,17 +10121,17 @@
 
     fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_bigendian" >&5
-$as_echo "$ac_cv_c_bigendian" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_bigendian" >&5
+printf "%s\n" "$ac_cv_c_bigendian" >&6; }
  case $ac_cv_c_bigendian in #(
    yes)
-     $as_echo "#define WORDS_BIGENDIAN 1" >>confdefs.h
+     printf "%s\n" "#define WORDS_BIGENDIAN 1" >>confdefs.h
 ;; #(
    no)
       ;; #(
    universal)
 
-$as_echo "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
+printf "%s\n" "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
 
      ;; #(
    *)
@@ -8437,16 +10141,17 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether long double and double are the same" >&5
-$as_echo_n "checking whether long double and double are the same... " >&6; }
-if ${gl_cv_long_double_equals_double+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether long double and double are the same" >&5
+printf %s "checking whether long double and double are the same... " >&6; }
+if test ${gl_cv_long_double_equals_double+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <float.h>
 int
-main ()
+main (void)
 {
 typedef int checksizeof (long double) == sizeof (double)
                               && LDBL_MANT_DIG == DBL_MANT_DIG
@@ -8458,19 +10163,20 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_long_double_equals_double=yes
-else
+else $as_nop
   gl_cv_long_double_equals_double=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_long_double_equals_double" >&5
-$as_echo "$gl_cv_long_double_equals_double" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_long_double_equals_double" >&5
+printf "%s\n" "$gl_cv_long_double_equals_double" >&6; }
   if test $gl_cv_long_double_equals_double = yes; then
 
-$as_echo "#define HAVE_SAME_LONG_DOUBLE_AS_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define HAVE_SAME_LONG_DOUBLE_AS_DOUBLE 1" >>confdefs.h
 
     HAVE_SAME_LONG_DOUBLE_AS_DOUBLE=1
   else
@@ -8485,18 +10191,20 @@
 
          if test -n "$gl_printf_safe"; then
 
-$as_echo "#define CHECK_PRINTF_SAFE 1" >>confdefs.h
+printf "%s\n" "#define CHECK_PRINTF_SAFE 1" >>confdefs.h
 
   fi
   case "$gl_cv_func_printf_long_double" in
     *yes)
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports infinite 'long double' arguments" >&5
-$as_echo_n "checking whether printf supports infinite 'long double' arguments... " >&6; }
-if ${gl_cv_func_printf_infinite_long_double+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports infinite 'long double' arguments" >&5
+printf %s "checking whether printf supports infinite 'long double' arguments... " >&6; }
+if test ${gl_cv_func_printf_infinite_long_double+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-          if test "$cross_compiling" = yes; then :
+          if test "$cross_compiling" = yes
+then :
   case "$host_cpu" in
                                      # Guess no on ia64, x86_64, i386.
                ia64 | x86_64 | i*86) gl_cv_func_printf_infinite_long_double="guessing no";;
@@ -8504,12 +10212,20 @@
                  case "$host_os" in
                                          # Guess yes on glibc systems.
                    *-gnu* | gnu*)        gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess yes on musl systems.
+                   *-musl*)              gl_cv_func_printf_infinite_long_double="guessing yes";;
                                          # Guess yes on FreeBSD >= 6.
                    freebsd1-5.*)       gl_cv_func_printf_infinite_long_double="guessing no";;
                    freebsd* | kfreebsd*) gl_cv_func_printf_infinite_long_double="guessing yes";;
+                   midnightbsd*)         gl_cv_func_printf_infinite_long_double="guessing yes";;
                                          # Guess yes on HP-UX >= 11.
                    hpux7-9* | hpux10*) gl_cv_func_printf_infinite_long_double="guessing no";;
                    hpux*)                gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess yes on OpenBSD >= 6.0.
+                   openbsd1-5.*)       gl_cv_func_printf_infinite_long_double="guessing no";;
+                   openbsd*)             gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess no on Android.
+                   linux*-android*)      gl_cv_func_printf_infinite_long_double="guessing no";;
                                          # Guess yes on MSVC, no on mingw.
                    mingw*)               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -8520,21 +10236,22 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_printf_infinite_long_double="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_infinite_long_double="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
                                          ;;
-                                         # If we don't know, assume the worst.
-                   *)                    gl_cv_func_printf_infinite_long_double="guessing no";;
+                                         # If we don't know, obey --enable-cross-guesses.
+                   *)                    gl_cv_func_printf_infinite_long_double="$gl_cross_guess_normal";;
                  esac
                  ;;
              esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -8576,7 +10293,7 @@
   /* Allocate a port on which the thread shall listen for exceptions.  */
   if (mach_port_allocate (self, MACH_PORT_RIGHT_RECEIVE, &our_exception_port)
       == KERN_SUCCESS) {
-    /* See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
+    /* See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
     if (mach_port_insert_right (self, our_exception_port, our_exception_port,
                                 MACH_MSG_TYPE_MAKE_SEND)
         == KERN_SUCCESS) {
@@ -8595,7 +10312,7 @@
            for a particular thread.  This has the effect that when our exception
            port gets the message, the thread specific exception port has already
            been asked, and we don't need to bother about it.
-           See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
+           See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
         task_set_exception_ports (self, mask, our_exception_port,
                                   EXCEPTION_DEFAULT, MACHINE_THREAD_STATE);
       }
@@ -8800,9 +10517,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_infinite_long_double=yes
-else
+else $as_nop
   gl_cv_func_printf_infinite_long_double=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8811,8 +10529,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_infinite_long_double" >&5
-$as_echo "$gl_cv_func_printf_infinite_long_double" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_infinite_long_double" >&5
+printf "%s\n" "$gl_cv_func_printf_infinite_long_double" >&6; }
       ;;
     *)
       gl_cv_func_printf_infinite_long_double="irrelevant"
@@ -8821,13 +10539,15 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'a' and 'A' directives" >&5
-$as_echo_n "checking whether printf supports the 'a' and 'A' directives... " >&6; }
-if ${gl_cv_func_printf_directive_a+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'a' and 'A' directives" >&5
+printf %s "checking whether printf supports the 'a' and 'A' directives... " >&6; }
+if test ${gl_cv_func_printf_directive_a+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
                                  # Guess yes on glibc >= 2.5 systems.
@@ -8844,21 +10564,26 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "BZ2908" >/dev/null 2>&1; then :
+  $EGREP "BZ2908" >/dev/null 2>&1
+then :
   gl_cv_func_printf_directive_a="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_directive_a="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
              ;;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_directive_a="guessing yes";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_directive_a="guessing no";;
                                  # Guess no on native Windows.
            mingw*)               gl_cv_func_printf_directive_a="guessing no";;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_directive_a="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_directive_a="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -8881,7 +10606,7 @@
           && strcmp (buf, "-0X6.488P-1 33") != 0
           && strcmp (buf, "-0XC.91P-2 33") != 0))
     result |= 2;
-  /* This catches a FreeBSD 6.1 bug: it doesn't round.  */
+  /* This catches a FreeBSD 13.0 bug: it doesn't round.  */
   if (sprintf (buf, "%.2a %d", 1.51, 33, 44, 55) < 0
       || (strcmp (buf, "0x1.83p+0 33") != 0
           && strcmp (buf, "0x3.05p-1 33") != 0
@@ -8918,9 +10643,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_directive_a=yes
-else
+else $as_nop
   gl_cv_func_printf_directive_a=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -8929,31 +10655,41 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_a" >&5
-$as_echo "$gl_cv_func_printf_directive_a" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_a" >&5
+printf "%s\n" "$gl_cv_func_printf_directive_a" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'F' directive" >&5
-$as_echo_n "checking whether printf supports the 'F' directive... " >&6; }
-if ${gl_cv_func_printf_directive_f+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'F' directive" >&5
+printf %s "checking whether printf supports the 'F' directive... " >&6; }
+if test ${gl_cv_func_printf_directive_f+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_directive_f="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on FreeBSD >= 6.
            freebsd1-5.*)       gl_cv_func_printf_directive_f="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_directive_f="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_directive_f="guessing no";;
            darwin*)              gl_cv_func_printf_directive_f="guessing yes";;
+                                 # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)       gl_cv_func_printf_directive_f="guessing no";;
+           openbsd*)             gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on Solaris >= 2.10.
            solaris2.1-90-9*) gl_cv_func_printf_directive_f="guessing yes";;
            solaris*)             gl_cv_func_printf_directive_f="guessing no";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_directive_f="guessing no";;
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -8964,19 +10700,20 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_printf_directive_f="guessing yes"
-else
+else $as_nop
   gl_cv_func_printf_directive_f="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_directive_f="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_directive_f="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9000,9 +10737,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_directive_f=yes
-else
+else $as_nop
   gl_cv_func_printf_directive_f=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9011,25 +10749,45 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_f" >&5
-$as_echo "$gl_cv_func_printf_directive_f" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_f" >&5
+printf "%s\n" "$gl_cv_func_printf_directive_f" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'n' directive" >&5
-$as_echo_n "checking whether printf supports the 'n' directive... " >&6; }
-if ${gl_cv_func_printf_directive_n+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'n' directive" >&5
+printf %s "checking whether printf supports the 'n' directive... " >&6; }
+if test ${gl_cv_func_printf_directive_n+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
-                   # Guess no on native Windows.
-           mingw*) gl_cv_func_printf_directive_n="guessing no";;
-           *)      gl_cv_func_printf_directive_n="guessing yes";;
+                            # Guess no on glibc when _FORTIFY_SOURCE >= 2.
+           *-gnu* | gnu*)   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#if _FORTIFY_SOURCE >= 2
+                                    error fail
+                                   #endif
+
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_func_printf_directive_n="guessing yes"
+else $as_nop
+  gl_cv_func_printf_directive_n="guessing no"
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+                            ;;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_directive_n="guessing no";;
+                            # Guess no on native Windows.
+           mingw*)          gl_cv_func_printf_directive_n="guessing no";;
+           *)               gl_cv_func_printf_directive_n="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9037,7 +10795,10 @@
 #include <stdlib.h>
 #include <string.h>
 #ifdef _MSC_VER
-/* See page about "Parameter Validation" on msdn.microsoft.com.  */
+#include <inttypes.h>
+/* See page about "Parameter Validation" on msdn.microsoft.com.
+   <https://docs.microsoft.com/en-us/cpp/c-runtime-library/parameter-validation>
+   <https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/set-invalid-parameter-handler-set-thread-local-invalid-parameter-handler>  */
 static void cdecl
 invalid_parameter_handler (const wchar_t *expression,
                            const wchar_t *function,
@@ -9066,9 +10827,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_directive_n=yes
-else
+else $as_nop
   gl_cv_func_printf_directive_n=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9077,41 +10839,41 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_n" >&5
-$as_echo "$gl_cv_func_printf_directive_n" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_n" >&5
+printf "%s\n" "$gl_cv_func_printf_directive_n" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'ls' directive" >&5
-$as_echo_n "checking whether printf supports the 'ls' directive... " >&6; }
-if ${gl_cv_func_printf_directive_ls+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the 'ls' directive" >&5
+printf %s "checking whether printf supports the 'ls' directive... " >&6; }
+if test ${gl_cv_func_printf_directive_ls+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
-           openbsd*)       gl_cv_func_printf_directive_ls="guessing no";;
-           irix*)          gl_cv_func_printf_directive_ls="guessing no";;
-           solaris*)       gl_cv_func_printf_directive_ls="guessing no";;
-           cygwin*)        gl_cv_func_printf_directive_ls="guessing no";;
-           beos* | haiku*) gl_cv_func_printf_directive_ls="guessing no";;
-                           # Guess yes on native Windows.
-           mingw*)         gl_cv_func_printf_directive_ls="guessing yes";;
-           *)              gl_cv_func_printf_directive_ls="guessing yes";;
+                            # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)  gl_cv_func_printf_directive_ls="guessing no";;
+           openbsd*)        gl_cv_func_printf_directive_ls="guessing yes";;
+           irix*)           gl_cv_func_printf_directive_ls="guessing no";;
+           solaris*)        gl_cv_func_printf_directive_ls="guessing no";;
+           cygwin*)         gl_cv_func_printf_directive_ls="guessing no";;
+           beos* | haiku*)  gl_cv_func_printf_directive_ls="guessing no";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_directive_ls="guessing no";;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_printf_directive_ls="guessing yes";;
+           *)               gl_cv_func_printf_directive_ls="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
 #include <stdio.h>
-#include <time.h>
 #include <wchar.h>
 #include <string.h>
 int main ()
@@ -9155,9 +10917,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_directive_ls=yes
-else
+else $as_nop
   gl_cv_func_printf_directive_ls=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9166,29 +10929,33 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_ls" >&5
-$as_echo "$gl_cv_func_printf_directive_ls" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_directive_ls" >&5
+printf "%s\n" "$gl_cv_func_printf_directive_ls" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
-$as_echo_n "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
-if ${gl_cv_func_printf_positions+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
+printf %s "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
+if test ${gl_cv_func_printf_positions+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            netbsd1-3* | netbsdelf1-3* | netbsdaout1-3* | netbsdcoff1-3*)
-                         gl_cv_func_printf_positions="guessing no";;
-           beos*)        gl_cv_func_printf_positions="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_positions="guessing no";;
-           *)            gl_cv_func_printf_positions="guessing yes";;
+                            gl_cv_func_printf_positions="guessing no";;
+           beos*)           gl_cv_func_printf_positions="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_positions="guessing yes";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_positions="guessing no";;
+           *)               gl_cv_func_printf_positions="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9204,9 +10971,10 @@
   return (strcmp (buf, "55 33") != 0);
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_positions=yes
-else
+else $as_nop
   gl_cv_func_printf_positions=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9215,28 +10983,32 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
-$as_echo "$gl_cv_func_printf_positions" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
+printf "%s\n" "$gl_cv_func_printf_positions" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the grouping flag" >&5
-$as_echo_n "checking whether printf supports the grouping flag... " >&6; }
-if ${gl_cv_func_printf_flag_grouping+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the grouping flag" >&5
+printf %s "checking whether printf supports the grouping flag... " >&6; }
+if test ${gl_cv_func_printf_flag_grouping+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
-           cygwin*)      gl_cv_func_printf_flag_grouping="guessing no";;
-           netbsd*)      gl_cv_func_printf_flag_grouping="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_flag_grouping="guessing no";;
-           *)            gl_cv_func_printf_flag_grouping="guessing yes";;
+           cygwin*)         gl_cv_func_printf_flag_grouping="guessing no";;
+           netbsd*)         gl_cv_func_printf_flag_grouping="guessing no";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_flag_grouping="guessing no";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_flag_grouping="guessing no";;
+           *)               gl_cv_func_printf_flag_grouping="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9251,9 +11023,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_flag_grouping=yes
-else
+else $as_nop
   gl_cv_func_printf_flag_grouping=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9262,31 +11035,35 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_grouping" >&5
-$as_echo "$gl_cv_func_printf_flag_grouping" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_grouping" >&5
+printf "%s\n" "$gl_cv_func_printf_flag_grouping" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the left-adjust flag correctly" >&5
-$as_echo_n "checking whether printf supports the left-adjust flag correctly... " >&6; }
-if ${gl_cv_func_printf_flag_leftadjust+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the left-adjust flag correctly" >&5
+printf %s "checking whether printf supports the left-adjust flag correctly... " >&6; }
+if test ${gl_cv_func_printf_flag_leftadjust+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
-                    # Guess yes on HP-UX 11.
-           hpux11*) gl_cv_func_printf_flag_leftadjust="guessing yes";;
-                    # Guess no on HP-UX 10 and older.
-           hpux*)   gl_cv_func_printf_flag_leftadjust="guessing no";;
-                    # Guess yes on native Windows.
-           mingw*)  gl_cv_func_printf_flag_leftadjust="guessing yes";;
-                    # Guess yes otherwise.
-           *)       gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes on HP-UX 11.
+           hpux11*)         gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess no on HP-UX 10 and older.
+           hpux*)           gl_cv_func_printf_flag_leftadjust="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes otherwise.
+           *)               gl_cv_func_printf_flag_leftadjust="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9302,9 +11079,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_flag_leftadjust=yes
-else
+else $as_nop
   gl_cv_func_printf_flag_leftadjust=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9313,31 +11091,37 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_leftadjust" >&5
-$as_echo "$gl_cv_func_printf_flag_leftadjust" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_leftadjust" >&5
+printf "%s\n" "$gl_cv_func_printf_flag_leftadjust" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports the zero flag correctly" >&5
-$as_echo_n "checking whether printf supports the zero flag correctly... " >&6; }
-if ${gl_cv_func_printf_flag_zero+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports the zero flag correctly" >&5
+printf %s "checking whether printf supports the zero flag correctly... " >&6; }
+if test ${gl_cv_func_printf_flag_zero+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
-                          # Guess yes on glibc systems.
-           *-gnu* | gnu*) gl_cv_func_printf_flag_zero="guessing yes";;
-                          # Guess yes on BeOS.
-           beos*)         gl_cv_func_printf_flag_zero="guessing yes";;
-                          # Guess no on native Windows.
-           mingw*)        gl_cv_func_printf_flag_zero="guessing no";;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_printf_flag_zero="guessing no";;
+                            # Guess yes on glibc systems.
+           *-gnu* | gnu*)   gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess yes on musl systems.
+           *-musl*)         gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess yes on BeOS.
+           beos*)           gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_flag_zero="guessing no";;
+                            # Guess no on native Windows.
+           mingw*)          gl_cv_func_printf_flag_zero="guessing no";;
+                            # If we don't know, obey --enable-cross-guesses.
+           *)               gl_cv_func_printf_flag_zero="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9354,9 +11138,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_flag_zero=yes
-else
+else $as_nop
   gl_cv_func_printf_flag_zero=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9365,28 +11150,32 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_zero" >&5
-$as_echo "$gl_cv_func_printf_flag_zero" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_flag_zero" >&5
+printf "%s\n" "$gl_cv_func_printf_flag_zero" >&6; }
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports large precisions" >&5
-$as_echo_n "checking whether printf supports large precisions... " >&6; }
-if ${gl_cv_func_printf_precision+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports large precisions" >&5
+printf %s "checking whether printf supports large precisions... " >&6; }
+if test ${gl_cv_func_printf_precision+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            # Guess no only on Solaris, native Windows, and BeOS systems.
-           solaris*)     gl_cv_func_printf_precision="guessing no" ;;
-           mingw* | pw*) gl_cv_func_printf_precision="guessing no" ;;
-           beos*)        gl_cv_func_printf_precision="guessing no" ;;
-           *)            gl_cv_func_printf_precision="guessing yes" ;;
+           solaris*)        gl_cv_func_printf_precision="guessing no" ;;
+           mingw* | pw*)    gl_cv_func_printf_precision="guessing no" ;;
+           beos*)           gl_cv_func_printf_precision="guessing no" ;;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_precision="guessing yes" ;;
+           *)               gl_cv_func_printf_precision="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -9413,9 +11202,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_precision=yes
-else
+else $as_nop
   gl_cv_func_printf_precision=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -9424,44 +11214,55 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_precision" >&5
-$as_echo "$gl_cv_func_printf_precision" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_precision" >&5
+printf "%s\n" "$gl_cv_func_printf_precision" >&6; }
 
 
-    gl_cv_c_multiarch=no
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether the compiler produces multi-arch binaries" >&5
+printf %s "checking whether the compiler produces multi-arch binaries... " >&6; }
+if test ${gl_cv_c_multiarch+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  gl_cv_c_multiarch=no
+     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #ifndef __APPLE_CC__
-         not a universal capable compiler
-        #endif
-        typedef int dummy;
+            not a universal capable compiler
+           #endif
+           typedef int dummy;
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-
-               arch=
-     prev=
-     for word in ${CC} ${CFLAGS} ${CPPFLAGS} ${LDFLAGS}; do
-       if test -n "$prev"; then
-         case $word in
-           i?86 | x86_64 | ppc | ppc64)
-             if test -z "$arch" || test "$arch" = "$word"; then
-               arch="$word"
-             else
-               gl_cv_c_multiarch=yes
-             fi
-             ;;
-         esac
-         prev=
-       else
-         if test "x$word" = "x-arch"; then
-           prev=arch
-         fi
-       fi
-     done
+if ac_fn_c_try_compile "$LINENO"
+then :
+
+                        arch=
+        prev=
+        for word in ${CC} ${CFLAGS} ${CPPFLAGS} ${LDFLAGS}; do
+          if test -n "$prev"; then
+            case $word in
+              i?86 | x86_64 | ppc | ppc64 | arm | arm64)
+                if test -z "$arch" || test "$arch" = "$word"; then
+                  arch="$word"
+                else
+                  gl_cv_c_multiarch=yes
+                fi
+                ;;
+            esac
+            prev=
+          else
+            if test "x$word" = "x-arch"; then
+              prev=arch
+            fi
+          fi
+        done
 
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_c_multiarch" >&5
+printf "%s\n" "$gl_cv_c_multiarch" >&6; }
   if test $gl_cv_c_multiarch = yes; then
     APPLE_UNIVERSAL_BUILD=1
   else
@@ -9472,11 +11273,12 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf survives out-of-memory conditions" >&5
-$as_echo_n "checking whether printf survives out-of-memory conditions... " >&6; }
-if ${gl_cv_func_printf_enomem+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf survives out-of-memory conditions" >&5
+printf %s "checking whether printf survives out-of-memory conditions... " >&6; }
+if test ${gl_cv_func_printf_enomem+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       gl_cv_func_printf_enomem="guessing no"
       if test "$cross_compiling" = no; then
@@ -9505,7 +11307,7 @@
   struct {
     mach_msg_header_t head;
     mach_msg_body_t msgh_body;
-    char data1024;
+    char data1024;
   } msg;
   mach_msg_return_t retval;
   /* Wait for a message on the exception port.  */
@@ -9522,7 +11324,7 @@
   /* Allocate a port on which the thread shall listen for exceptions.  */
   if (mach_port_allocate (self, MACH_PORT_RIGHT_RECEIVE, &our_exception_port)
       == KERN_SUCCESS) {
-    /* See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
+    /* See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
     if (mach_port_insert_right (self, our_exception_port, our_exception_port,
                                 MACH_MSG_TYPE_MAKE_SEND)
         == KERN_SUCCESS) {
@@ -9541,7 +11343,7 @@
            for a particular thread.  This has the effect that when our exception
            port gets the message, the thread specific exception port has already
            been asked, and we don't need to bother about it.
-           See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
+           See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
         task_set_exception_ports (self, mask, our_exception_port,
                                   EXCEPTION_DEFAULT, MACHINE_THREAD_STATE);
       }
@@ -9647,11 +11449,11 @@
           if { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_link\""; } >&5
   (eval $ac_link) 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; } && test -s conftest$ac_exeext; then
             (./conftest 2>&5
              result=$?
-             $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $result" >&5
+             printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $result" >&5
              if test $result != 0 && test $result != 77; then result=1; fi
              exit $result
             ) >/dev/null 2>/dev/null
@@ -9670,34 +11472,36 @@
       fi
       if test "$gl_cv_func_printf_enomem" = "guessing no"; then
         case "$host_os" in
-                         # Guess yes on glibc systems.
-          *-gnu* | gnu*) gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on Solaris.
-          solaris*)      gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on AIX.
-          aix*)          gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on HP-UX/hppa.
-          hpux*)         case "$host_cpu" in
-                           hppa*) gl_cv_func_printf_enomem="guessing yes";;
-                           *)     gl_cv_func_printf_enomem="guessing no";;
-                         esac
-                         ;;
-                         # Guess yes on IRIX.
-          irix*)         gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on OSF/1.
-          osf*)          gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on BeOS.
-          beos*)         gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on Haiku.
-          haiku*)        gl_cv_func_printf_enomem="guessing yes";;
-                         # If we don't know, assume the worst.
-          *)             gl_cv_func_printf_enomem="guessing no";;
+                           # Guess yes on glibc systems.
+          *-gnu* | gnu*)   gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on Solaris.
+          solaris*)        gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on AIX.
+          aix*)            gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on HP-UX/hppa.
+          hpux*)           case "$host_cpu" in
+                             hppa*) gl_cv_func_printf_enomem="guessing yes";;
+                             *)     gl_cv_func_printf_enomem="guessing no";;
+                           esac
+                           ;;
+                           # Guess yes on IRIX.
+          irix*)           gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on OSF/1.
+          osf*)            gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on BeOS.
+          beos*)           gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on Haiku.
+          haiku*)          gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess no on Android.
+          linux*-android*) gl_cv_func_printf_enomem="guessing no";;
+                           # If we don't know, obey --enable-cross-guesses.
+          *)               gl_cv_func_printf_enomem="$gl_cross_guess_normal";;
         esac
       fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_enomem" >&5
-$as_echo "$gl_cv_func_printf_enomem" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_enomem" >&5
+printf "%s\n" "$gl_cv_func_printf_enomem" >&6; }
 
 
 
@@ -9706,286 +11510,215 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
 
       ;;
   esac
 
-
-
-
-  for ac_func in $ac_func_list
-do :
-  as_ac_var=`$as_echo "ac_cv_func_$ac_func" | $as_tr_sh`
-ac_fn_c_check_func "$LINENO" "$ac_func" "$as_ac_var"
-if eval test \"x\$"$as_ac_var"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_func" | $as_tr_cpp` 1
-_ACEOF
-
-fi
-done
-
-
-
-
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for unsigned long long int" >&5
-$as_echo_n "checking for unsigned long long int... " >&6; }
-if ${ac_cv_type_unsigned_long_long_int+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  ac_cv_type_unsigned_long_long_int=yes
-     if test "x${ac_cv_prog_cc_c99-no}" = xno; then
-       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $CC options needed to detect all undeclared functions" >&5
+printf %s "checking for $CC options needed to detect all undeclared functions... " >&6; }
+if test ${ac_cv_c_undeclared_builtin_options+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  ac_save_CFLAGS=$CFLAGS
+   ac_cv_c_undeclared_builtin_options='cannot detect'
+   for ac_arg in '' -fno-builtin; do
+     CFLAGS="$ac_save_CFLAGS $ac_arg"
+     # This test program should *not* compile successfully.
+     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-  /* For now, do not test the preprocessor; as of 2007 there are too many
-         implementations with broken preprocessors.  Perhaps this can
-         be revisited in 2012.  In the meantime, code should not expect
-         #if to work with literals wider than 32 bits.  */
-      /* Test literals.  */
-      long long int ll = 9223372036854775807ll;
-      long long int nll = -9223372036854775807LL;
-      unsigned long long int ull = 18446744073709551615ULL;
-      /* Test constant expressions.   */
-      typedef int a((-9223372036854775807LL < 0 && 0 < 9223372036854775807ll)
-                     ? 1 : -1);
-      typedef int b(18446744073709551615ULL <= (unsigned long long int) -1
-                     ? 1 : -1);
-      int i = 63;
 int
-main ()
+main (void)
 {
-/* Test availability of runtime routines for shift and division.  */
-      long long int llmax = 9223372036854775807ll;
-      unsigned long long int ullmax = 18446744073709551615ull;
-      return ((ll << 63) | (ll >> 63) | (ll < i) | (ll > i)
-              | (llmax / ll) | (llmax % ll)
-              | (ull << 63) | (ull >> 63) | (ull << i) | (ull >> i)
-              | (ullmax / ull) | (ullmax % ull));
+(void) strchr;
   ;
   return 0;
 }
-
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
-  ac_cv_type_unsigned_long_long_int=no
-fi
-rm -f core conftest.err conftest.$ac_objext \
-    conftest$ac_exeext conftest.$ac_ext
-     fi
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_type_unsigned_long_long_int" >&5
-$as_echo "$ac_cv_type_unsigned_long_long_int" >&6; }
-  if test $ac_cv_type_unsigned_long_long_int = yes; then
-
-$as_echo "#define HAVE_UNSIGNED_LONG_LONG_INT 1" >>confdefs.h
-
-  fi
-
-
-
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for long long int" >&5
-$as_echo_n "checking for long long int... " >&6; }
-if ${ac_cv_type_long_long_int+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  ac_cv_type_long_long_int=yes
-      if test "x${ac_cv_prog_cc_c99-no}" = xno; then
-        ac_cv_type_long_long_int=$ac_cv_type_unsigned_long_long_int
-        if test $ac_cv_type_long_long_int = yes; then
-                                        if test "$cross_compiling" = yes; then :
-  :
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+else $as_nop
+  # This test program should compile successfully.
+        # No library function is consistently available on
+        # freestanding implementations, so test against a dummy
+        # declaration.  Include always-available headers on the
+        # off chance that they somehow elicit warnings.
+        cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
+#include <float.h>
 #include <limits.h>
-                 #ifndef LLONG_MAX
-                 # define HALF \
-                          (1LL << (sizeof (long long int) * CHAR_BIT - 2))
-                 # define LLONG_MAX (HALF - 1 + HALF)
-                 #endif
+#include <stdarg.h>
+#include <stddef.h>
+extern void ac_decl (int, char *);
+
 int
-main ()
+main (void)
 {
-long long int n = 1;
-                 int i;
-                 for (i = 0; ; i++)
-                   {
-                     long long int m = n << i;
-                     if (m >> i != n)
-                       return 1;
-                     if (LLONG_MAX / 2 < m)
-                       break;
-                   }
-                 return 0;
+(void) ac_decl (0, (char *) 0);
+  (void) ac_decl;
+
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-
-else
-  ac_cv_type_long_long_int=no
+if ac_fn_c_try_compile "$LINENO"
+then :
+  if test x"$ac_arg" = x
+then :
+  ac_cv_c_undeclared_builtin_options='none needed'
+else $as_nop
+  ac_cv_c_undeclared_builtin_options=$ac_arg
 fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
+          break
 fi
-
-        fi
-      fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_type_long_long_int" >&5
-$as_echo "$ac_cv_type_long_long_int" >&6; }
-  if test $ac_cv_type_long_long_int = yes; then
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+    done
+    CFLAGS=$ac_save_CFLAGS
 
-$as_echo "#define HAVE_LONG_LONG_INT 1" >>confdefs.h
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_undeclared_builtin_options" >&5
+printf "%s\n" "$ac_cv_c_undeclared_builtin_options" >&6; }
+  case $ac_cv_c_undeclared_builtin_options in #(
+  'cannot detect') :
+    { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error $? "cannot make $CC report undeclared builtins
+See \`config.log' for more details" "$LINENO" 5; } ;; #(
+  'none needed') :
+    ac_c_undeclared_builtin_options='' ;; #(
+  *) :
+    ac_c_undeclared_builtin_options=$ac_cv_c_undeclared_builtin_options ;;
+esac
 
+ac_func=
+for ac_item in $ac_func_c_list
+do
+  if test $ac_func; then
+    ac_fn_c_check_func "$LINENO" $ac_func ac_cv_func_$ac_func
+    if eval test \"x\$ac_cv_func_$ac_func\" = xyes; then
+      echo "#define $ac_item 1" >> confdefs.h
+    fi
+    ac_func=
+  else
+    ac_func=$ac_item
   fi
+done
 
-
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for wchar_t" >&5
-$as_echo_n "checking for wchar_t... " >&6; }
-if ${gt_cv_c_wchar_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for wchar_t" >&5
+printf %s "checking for wchar_t... " >&6; }
+if test ${gt_cv_c_wchar_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <stddef.h>
             wchar_t foo = (wchar_t)'\0';
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gt_cv_c_wchar_t=yes
-else
+else $as_nop
   gt_cv_c_wchar_t=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_wchar_t" >&5
-$as_echo "$gt_cv_c_wchar_t" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_wchar_t" >&5
+printf "%s\n" "$gt_cv_c_wchar_t" >&6; }
   if test $gt_cv_c_wchar_t = yes; then
 
-$as_echo "#define HAVE_WCHAR_T 1" >>confdefs.h
+printf "%s\n" "#define HAVE_WCHAR_T 1" >>confdefs.h
 
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for wint_t" >&5
-$as_echo_n "checking for wint_t... " >&6; }
-if ${gt_cv_c_wint_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for wint_t" >&5
+printf %s "checking for wint_t... " >&6; }
+if test ${gt_cv_c_wint_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
 #include <wchar.h>
             wint_t foo = (wchar_t)'\0';
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gt_cv_c_wint_t=yes
-else
+else $as_nop
   gt_cv_c_wint_t=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_wint_t" >&5
-$as_echo "$gt_cv_c_wint_t" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_wint_t" >&5
+printf "%s\n" "$gt_cv_c_wint_t" >&6; }
   if test $gt_cv_c_wint_t = yes; then
 
-$as_echo "#define HAVE_WINT_T 1" >>confdefs.h
+printf "%s\n" "#define HAVE_WINT_T 1" >>confdefs.h
 
 
-            { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether wint_t is too small" >&5
-$as_echo_n "checking whether wint_t is too small... " >&6; }
-if ${gl_cv_type_wint_t_too_small+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+            { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether wint_t is large enough" >&5
+printf %s "checking whether wint_t is large enough... " >&6; }
+if test ${gl_cv_type_wint_t_large_enough+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#if !(defined __GLIBC__ && !defined __UCLIBC__)
-# include <stddef.h>
-# include <stdio.h>
-# include <time.h>
-#endif
 #include <wchar.h>
               int verifysizeof (wint_t) < sizeof (int) ? -1 : 1;
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_type_wint_t_too_small=no
-else
-  gl_cv_type_wint_t_too_small=yes
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_type_wint_t_large_enough=yes
+else $as_nop
+  gl_cv_type_wint_t_large_enough=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wint_t_too_small" >&5
-$as_echo "$gl_cv_type_wint_t_too_small" >&6; }
-    if test $gl_cv_type_wint_t_too_small = yes; then
-      GNULIB_OVERRIDES_WINT_T=1
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wint_t_large_enough" >&5
+printf "%s\n" "$gl_cv_type_wint_t_large_enough" >&6; }
+    if test $gl_cv_type_wint_t_large_enough = no; then
+      GNULIBHEADERS_OVERRIDE_WINT_T=1
     else
-      GNULIB_OVERRIDES_WINT_T=0
+      GNULIBHEADERS_OVERRIDE_WINT_T=0
     fi
   else
-    GNULIB_OVERRIDES_WINT_T=0
+    GNULIBHEADERS_OVERRIDE_WINT_T=0
   fi
 
 
 
 
 
-  for ac_header in $ac_header_list
-do :
-  as_ac_Header=`$as_echo "ac_cv_header_$ac_header" | $as_tr_sh`
-ac_fn_c_check_header_compile "$LINENO" "$ac_header" "$as_ac_Header" "$ac_includes_default
-"
-if eval test \"x\$"$as_ac_Header"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_header" | $as_tr_cpp` 1
-_ACEOF
-
-fi
-
-done
-
-
-
-
-
   if test $ac_cv_header_features_h = yes; then
     HAVE_FEATURES_H=1
   else
@@ -9996,11 +11729,12 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for intmax_t" >&5
-$as_echo_n "checking for intmax_t... " >&6; }
-if ${gt_cv_c_intmax_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for intmax_t" >&5
+printf %s "checking for intmax_t... " >&6; }
+if test ${gt_cv_c_intmax_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -10014,46 +11748,43 @@
 #endif
 
 int
-main ()
+main (void)
 {
 intmax_t x = -1; return !x;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gt_cv_c_intmax_t=yes
-else
+else $as_nop
   gt_cv_c_intmax_t=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_intmax_t" >&5
-$as_echo "$gt_cv_c_intmax_t" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gt_cv_c_intmax_t" >&5
+printf "%s\n" "$gt_cv_c_intmax_t" >&6; }
   if test $gt_cv_c_intmax_t = yes; then
 
-$as_echo "#define HAVE_INTMAX_T 1" >>confdefs.h
+printf "%s\n" "#define HAVE_INTMAX_T 1" >>confdefs.h
 
   else
 
-    test $ac_cv_type_long_long_int = yes \
-      && ac_type='long long' \
-      || ac_type='long'
-
-cat >>confdefs.h <<_ACEOF
-#define intmax_t $ac_type
-_ACEOF
+printf "%s\n" "#define intmax_t long long" >>confdefs.h
 
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'double'" >&5
-$as_echo_n "checking where to find the exponent in a 'double'... " >&6; }
-if ${gl_cv_cc_double_expbit0+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'double'" >&5
+printf %s "checking where to find the exponent in a 'double'... " >&6; }
+if test ${gl_cv_cc_double_expbit0+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
                                                                       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -10064,14 +11795,16 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "mixed_endianness" >/dev/null 2>&1; then :
+  $EGREP "mixed_endianness" >/dev/null 2>&1
+then :
   gl_cv_cc_double_expbit0="unknown"
-else
+else $as_nop
 
                                                          :
-if ${ac_cv_c_bigendian+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+if test ${ac_cv_c_bigendian+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_c_bigendian=unknown
     # See if we're dealing with a universal compiler.
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -10082,7 +11815,8 @@
 	     typedef int dummy;
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
 	# Check for potential -arch flags.  It is not universal unless
 	# there are at least two -arch flags with different values.
@@ -10106,7 +11840,7 @@
 	 fi
        done
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     if test $ac_cv_c_bigendian = unknown; then
       # See if sys/param.h defines the BYTE_ORDER macro.
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -10115,7 +11849,7 @@
 	     #include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined BYTE_ORDER && defined BIG_ENDIAN \
 		     && defined LITTLE_ENDIAN && BYTE_ORDER && BIG_ENDIAN \
@@ -10127,7 +11861,8 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -10135,7 +11870,7 @@
 		#include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if BYTE_ORDER != BIG_ENDIAN
 		 not big endian
@@ -10145,14 +11880,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # See if <limits.h> defines _LITTLE_ENDIAN or _BIG_ENDIAN (e.g., Solaris).
@@ -10161,7 +11897,7 @@
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined _LITTLE_ENDIAN || defined _BIG_ENDIAN)
 	      bogus endian macros
@@ -10171,14 +11907,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to _BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #ifndef _BIG_ENDIAN
 		 not big endian
@@ -10188,31 +11925,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # Compile a test program.
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   # Try to guess by grepping values from an object file.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-short int ascii_mm =
+unsigned short int ascii_mm =
 		  { 0x4249, 0x4765, 0x6E44, 0x6961, 0x6E53, 0x7953, 0 };
-		short int ascii_ii =
+		unsigned short int ascii_ii =
 		  { 0x694C, 0x5454, 0x656C, 0x6E45, 0x6944, 0x6E61, 0 };
 		int use_ascii (int i) {
 		  return ascii_mmi + ascii_iii;
 		}
-		short int ebcdic_ii =
+		unsigned short int ebcdic_ii =
 		  { 0x89D3, 0xE3E3, 0x8593, 0x95C5, 0x89C4, 0x9581, 0 };
-		short int ebcdic_mm =
+		unsigned short int ebcdic_mm =
 		  { 0xC2C9, 0xC785, 0x95C4, 0x8981, 0x95E2, 0xA8E2, 0 };
 		int use_ebcdic (int i) {
 		  return ebcdic_mmi + ebcdic_iii;
@@ -10220,14 +11959,15 @@
 		extern int foo;
 
 int
-main ()
+main (void)
 {
 return use_ascii (foo) == use_ebcdic (foo);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   if grep BIGenDianSyS conftest.$ac_objext >/dev/null; then
 	      ac_cv_c_bigendian=yes
 	    fi
@@ -10240,13 +11980,13 @@
 	      fi
 	    fi
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-else
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $ac_includes_default
 int
-main ()
+main (void)
 {
 
 	     /* Are we little or big endian?  From Harbison&Steele.  */
@@ -10262,9 +12002,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   ac_cv_c_bigendian=no
-else
+else $as_nop
   ac_cv_c_bigendian=yes
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -10281,7 +12022,7 @@
      gl_cv_cc_double_expbit0="word 1 bit 20" ;; #(
    universal)
 
-$as_echo "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
+printf "%s\n" "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
 
      ;; #(
    *)
@@ -10290,10 +12031,10 @@
 
 
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -10361,9 +12102,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_double_expbit0=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_double_expbit0="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -10373,21 +12115,17 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_double_expbit0" >&5
-$as_echo "$gl_cv_cc_double_expbit0" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_double_expbit0" >&5
+printf "%s\n" "$gl_cv_cc_double_expbit0" >&6; }
   case "$gl_cv_cc_double_expbit0" in
     word*bit*)
       word=`echo "$gl_cv_cc_double_expbit0" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_double_expbit0" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define DBL_EXPBIT0_WORD $word
-_ACEOF
+printf "%s\n" "#define DBL_EXPBIT0_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define DBL_EXPBIT0_BIT $bit
-_ACEOF
+printf "%s\n" "#define DBL_EXPBIT0_BIT $bit" >>confdefs.h
 
       ;;
   esac
@@ -10399,20 +12137,24 @@
 
 
 
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether snprintf returns a byte count as in C99" >&5
+printf %s "checking whether snprintf returns a byte count as in C99... " >&6; }
+if test ${gl_cv_func_snprintf_retval_c99+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether snprintf returns a byte count as in C99" >&5
-$as_echo_n "checking whether snprintf returns a byte count as in C99... " >&6; }
-if ${gl_cv_func_snprintf_retval_c99+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_snprintf_retval_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_snprintf_retval_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_snprintf_retval_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_snprintf_retval_c99="guessing no";;
            darwin*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
@@ -10432,6 +12174,8 @@
            netbsd*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_snprintf_retval_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -10442,19 +12186,20 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_snprintf_retval_c99="guessing yes"
-else
+else $as_nop
   gl_cv_func_snprintf_retval_c99="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_snprintf_retval_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_snprintf_retval_c99="$gl_cross_guess_normal";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -10487,9 +12232,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_snprintf_retval_c99=yes
-else
+else $as_nop
   gl_cv_func_snprintf_retval_c99=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -10498,108 +12244,191 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_retval_c99" >&5
-$as_echo "$gl_cv_func_snprintf_retval_c99" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_retval_c99" >&5
+printf "%s\n" "$gl_cv_func_snprintf_retval_c99" >&6; }
 
 
 
 
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether snprintf truncates the result as in C99" >&5
+printf %s "checking whether snprintf truncates the result as in C99... " >&6; }
+if test ${gl_cv_func_snprintf_truncation_c99+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+      if test "$cross_compiling" = yes
+then :
+
+         case "$host_os" in
+                                 # Guess yes on glibc systems.
+           *-gnu* | gnu*)        gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on FreeBSD >= 5.
+           freebsd1-4.*)       gl_cv_func_snprintf_truncation_c99="guessing no";;
+           freebsd* | kfreebsd*) gl_cv_func_snprintf_truncation_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on Mac OS X >= 10.3.
+           darwin1-6.*)        gl_cv_func_snprintf_truncation_c99="guessing no";;
+           darwin*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on OpenBSD >= 3.9.
+           openbsd1-2.* | openbsd3.0-8 | openbsd3.0-8.*)
+                                 gl_cv_func_snprintf_truncation_c99="guessing no";;
+           openbsd*)             gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on Solaris >= 2.6.
+           solaris2.0-5 | solaris2.0-5.*)
+                                 gl_cv_func_snprintf_truncation_c99="guessing no";;
+           solaris*)             gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on AIX >= 4.
+           aix1-3*)            gl_cv_func_snprintf_truncation_c99="guessing no";;
+           aix*)                 gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on HP-UX >= 11.
+           hpux7-9* | hpux10*) gl_cv_func_snprintf_truncation_c99="guessing no";;
+           hpux*)                gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on IRIX >= 6.5.
+           irix6.5)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on OSF/1 >= 5.
+           osf3-4*)            gl_cv_func_snprintf_truncation_c99="guessing no";;
+           osf*)                 gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on NetBSD >= 3.
+           netbsd1-2* | netbsdelf1-2* | netbsdaout1-2* | netbsdcoff1-2*)
+                                 gl_cv_func_snprintf_truncation_c99="guessing no";;
+           netbsd*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on BeOS.
+           beos*)                gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess no on native Windows.
+           mingw*)               gl_cv_func_snprintf_truncation_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_snprintf_truncation_c99="$gl_cross_guess_normal";;
+         esac
 
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
 
-  for ac_func in snprintf strnlen wcslen wcsnlen mbrtowc wcrtomb
-do :
-  as_ac_var=`$as_echo "ac_cv_func_$ac_func" | $as_tr_sh`
-ac_fn_c_check_func "$LINENO" "$ac_func" "$as_ac_var"
-if eval test \"x\$"$as_ac_var"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_func" | $as_tr_cpp` 1
+#include <stdio.h>
+#include <string.h>
+#if HAVE_SNPRINTF
+# define my_snprintf snprintf
+#else
+# include <stdarg.h>
+static int my_snprintf (char *buf, int size, const char *format, ...)
+{
+  va_list args;
+  int ret;
+  va_start (args, format);
+  ret = vsnprintf (buf, size, format, args);
+  va_end (args);
+  return ret;
+}
+#endif
+static char buf100;
+int main ()
+{
+  strcpy (buf, "ABCDEF");
+  my_snprintf (buf, 3, "%d %d", 4567, 89);
+  if (memcmp (buf, "45\0DEF", 6) != 0)
+    return 1;
+  return 0;
+}
 _ACEOF
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_func_snprintf_truncation_c99=yes
+else $as_nop
+  gl_cv_func_snprintf_truncation_c99=no
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
 
 fi
-done
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_truncation_c99" >&5
+printf "%s\n" "$gl_cv_func_snprintf_truncation_c99" >&6; }
 
-      ac_fn_c_check_decl "$LINENO" "_snprintf" "ac_cv_have_decl__snprintf" "#include <stdio.h>
-"
-if test "x$ac_cv_have_decl__snprintf" = xyes; then :
+
+
+
+
+  ac_fn_c_check_func "$LINENO" "snprintf" "ac_cv_func_snprintf"
+if test "x$ac_cv_func_snprintf" = xyes
+then :
+  printf "%s\n" "#define HAVE_SNPRINTF 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "strnlen" "ac_cv_func_strnlen"
+if test "x$ac_cv_func_strnlen" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRNLEN 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "wcslen" "ac_cv_func_wcslen"
+if test "x$ac_cv_func_wcslen" = xyes
+then :
+  printf "%s\n" "#define HAVE_WCSLEN 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "wcsnlen" "ac_cv_func_wcsnlen"
+if test "x$ac_cv_func_wcsnlen" = xyes
+then :
+  printf "%s\n" "#define HAVE_WCSNLEN 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "mbrtowc" "ac_cv_func_mbrtowc"
+if test "x$ac_cv_func_mbrtowc" = xyes
+then :
+  printf "%s\n" "#define HAVE_MBRTOWC 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "wcrtomb" "ac_cv_func_wcrtomb"
+if test "x$ac_cv_func_wcrtomb" = xyes
+then :
+  printf "%s\n" "#define HAVE_WCRTOMB 1" >>confdefs.h
+
+fi
+
+      ac_fn_check_decl "$LINENO" "_snprintf" "ac_cv_have_decl__snprintf" "#include <stdio.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl__snprintf" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
-
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL__SNPRINTF $ac_have_decl
-_ACEOF
+printf "%s\n" "#define HAVE_DECL__SNPRINTF $ac_have_decl" >>confdefs.h
 
 
 
   case "$gl_cv_func_snprintf_retval_c99" in
     *yes)
 
-$as_echo "#define HAVE_SNPRINTF_RETVAL_C99 1" >>confdefs.h
+printf "%s\n" "#define HAVE_SNPRINTF_RETVAL_C99 1" >>confdefs.h
+
+      ;;
+  esac
+
+  case "$gl_cv_func_snprintf_truncation_c99" in
+    *yes)
+
+printf "%s\n" "#define HAVE_SNPRINTF_TRUNCATION_C99 1" >>confdefs.h
 
       ;;
   esac
 
 
-  GNULIB_DPRINTF=0;
-  GNULIB_FCLOSE=0;
-  GNULIB_FDOPEN=0;
-  GNULIB_FFLUSH=0;
-  GNULIB_FGETC=0;
-  GNULIB_FGETS=0;
-  GNULIB_FOPEN=0;
-  GNULIB_FPRINTF=0;
-  GNULIB_FPRINTF_POSIX=0;
-  GNULIB_FPURGE=0;
-  GNULIB_FPUTC=0;
-  GNULIB_FPUTS=0;
-  GNULIB_FREAD=0;
-  GNULIB_FREOPEN=0;
-  GNULIB_FSCANF=0;
-  GNULIB_FSEEK=0;
-  GNULIB_FSEEKO=0;
-  GNULIB_FTELL=0;
-  GNULIB_FTELLO=0;
-  GNULIB_FWRITE=0;
-  GNULIB_GETC=0;
-  GNULIB_GETCHAR=0;
-  GNULIB_GETDELIM=0;
-  GNULIB_GETLINE=0;
-  GNULIB_OBSTACK_PRINTF=0;
-  GNULIB_OBSTACK_PRINTF_POSIX=0;
-  GNULIB_PCLOSE=0;
-  GNULIB_PERROR=0;
-  GNULIB_POPEN=0;
-  GNULIB_PRINTF=0;
-  GNULIB_PRINTF_POSIX=0;
-  GNULIB_PUTC=0;
-  GNULIB_PUTCHAR=0;
-  GNULIB_PUTS=0;
-  GNULIB_REMOVE=0;
-  GNULIB_RENAME=0;
-  GNULIB_RENAMEAT=0;
-  GNULIB_SCANF=0;
-  GNULIB_SNPRINTF=0;
-  GNULIB_SPRINTF_POSIX=0;
-  GNULIB_STDIO_H_NONBLOCKING=0;
-  GNULIB_STDIO_H_SIGPIPE=0;
-  GNULIB_TMPFILE=0;
-  GNULIB_VASPRINTF=0;
-  GNULIB_VFSCANF=0;
-  GNULIB_VSCANF=0;
-  GNULIB_VDPRINTF=0;
-  GNULIB_VFPRINTF=0;
-  GNULIB_VFPRINTF_POSIX=0;
-  GNULIB_VPRINTF=0;
-  GNULIB_VPRINTF_POSIX=0;
-  GNULIB_VSNPRINTF=0;
-  GNULIB_VSPRINTF_POSIX=0;
-    HAVE_DECL_FPURGE=1;
+    HAVE_DECL_FCLOSEALL=1;
+  HAVE_DECL_FPURGE=1;
   HAVE_DECL_FSEEKO=1;
   HAVE_DECL_FTELLO=1;
   HAVE_DECL_GETDELIM=1;
   HAVE_DECL_GETLINE=1;
+  HAVE_DECL_GETW=1;
   HAVE_DECL_OBSTACK_PRINTF=1;
+  HAVE_DECL_PUTW=1;
   HAVE_DECL_SNPRINTF=1;
   HAVE_DECL_VSNPRINTF=1;
   HAVE_DPRINTF=1;
@@ -10615,6 +12444,7 @@
   REPLACE_FDOPEN=0;
   REPLACE_FFLUSH=0;
   REPLACE_FOPEN=0;
+  REPLACE_FOPEN_FOR_FOPEN_GNU=0;
   REPLACE_FPRINTF=0;
   REPLACE_FPURGE=0;
   REPLACE_FREOPEN=0;
@@ -10644,101 +12474,531 @@
   REPLACE_VSPRINTF=0;
 
 
-  GNULIB_ACOSF=0;
-  GNULIB_ACOSL=0;
-  GNULIB_ASINF=0;
-  GNULIB_ASINL=0;
-  GNULIB_ATANF=0;
-  GNULIB_ATANL=0;
-  GNULIB_ATAN2F=0;
-  GNULIB_CBRT=0;
-  GNULIB_CBRTF=0;
-  GNULIB_CBRTL=0;
-  GNULIB_CEIL=0;
-  GNULIB_CEILF=0;
-  GNULIB_CEILL=0;
-  GNULIB_COPYSIGN=0;
-  GNULIB_COPYSIGNF=0;
-  GNULIB_COPYSIGNL=0;
-  GNULIB_COSF=0;
-  GNULIB_COSL=0;
-  GNULIB_COSHF=0;
-  GNULIB_EXPF=0;
-  GNULIB_EXPL=0;
-  GNULIB_EXP2=0;
-  GNULIB_EXP2F=0;
-  GNULIB_EXP2L=0;
-  GNULIB_EXPM1=0;
-  GNULIB_EXPM1F=0;
-  GNULIB_EXPM1L=0;
-  GNULIB_FABSF=0;
-  GNULIB_FABSL=0;
-  GNULIB_FLOOR=0;
-  GNULIB_FLOORF=0;
-  GNULIB_FLOORL=0;
-  GNULIB_FMA=0;
-  GNULIB_FMAF=0;
-  GNULIB_FMAL=0;
-  GNULIB_FMOD=0;
-  GNULIB_FMODF=0;
-  GNULIB_FMODL=0;
-  GNULIB_FREXPF=0;
-  GNULIB_FREXP=0;
-  GNULIB_FREXPL=0;
-  GNULIB_HYPOT=0;
-  GNULIB_HYPOTF=0;
-  GNULIB_HYPOTL=0;
-  GNULIB_ILOGB=0;
-  GNULIB_ILOGBF=0;
-  GNULIB_ILOGBL=0;
-  GNULIB_ISFINITE=0;
-  GNULIB_ISINF=0;
-  GNULIB_ISNAN=0;
-  GNULIB_ISNANF=0;
-  GNULIB_ISNAND=0;
-  GNULIB_ISNANL=0;
-  GNULIB_LDEXPF=0;
-  GNULIB_LDEXPL=0;
-  GNULIB_LOG=0;
-  GNULIB_LOGF=0;
-  GNULIB_LOGL=0;
-  GNULIB_LOG10=0;
-  GNULIB_LOG10F=0;
-  GNULIB_LOG10L=0;
-  GNULIB_LOG1P=0;
-  GNULIB_LOG1PF=0;
-  GNULIB_LOG1PL=0;
-  GNULIB_LOG2=0;
-  GNULIB_LOG2F=0;
-  GNULIB_LOG2L=0;
-  GNULIB_LOGB=0;
-  GNULIB_LOGBF=0;
-  GNULIB_LOGBL=0;
-  GNULIB_MODF=0;
-  GNULIB_MODFF=0;
-  GNULIB_MODFL=0;
-  GNULIB_POWF=0;
-  GNULIB_REMAINDER=0;
-  GNULIB_REMAINDERF=0;
-  GNULIB_REMAINDERL=0;
-  GNULIB_RINT=0;
-  GNULIB_RINTF=0;
-  GNULIB_RINTL=0;
-  GNULIB_ROUND=0;
-  GNULIB_ROUNDF=0;
-  GNULIB_ROUNDL=0;
-  GNULIB_SIGNBIT=0;
-  GNULIB_SINF=0;
-  GNULIB_SINL=0;
-  GNULIB_SINHF=0;
-  GNULIB_SQRTF=0;
-  GNULIB_SQRTL=0;
-  GNULIB_TANF=0;
-  GNULIB_TANL=0;
-  GNULIB_TANHF=0;
-  GNULIB_TRUNC=0;
-  GNULIB_TRUNCF=0;
-  GNULIB_TRUNCL=0;
+
+  GL_GNULIB_DPRINTF=0
+
+
+
+  GL_GNULIB_FCLOSE=0
+
+
+
+  GL_GNULIB_FDOPEN=0
+
+
+
+  GL_GNULIB_FFLUSH=0
+
+
+
+  GL_GNULIB_FGETC=0
+
+
+
+  GL_GNULIB_FGETS=0
+
+
+
+  GL_GNULIB_FOPEN=0
+
+
+
+  GL_GNULIB_FOPEN_GNU=0
+
+
+
+  GL_GNULIB_FPRINTF=0
+
+
+
+  GL_GNULIB_FPRINTF_POSIX=0
+
+
+
+  GL_GNULIB_FPURGE=0
+
+
+
+  GL_GNULIB_FPUTC=0
+
+
+
+  GL_GNULIB_FPUTS=0
+
+
+
+  GL_GNULIB_FREAD=0
+
+
+
+  GL_GNULIB_FREOPEN=0
+
+
+
+  GL_GNULIB_FSCANF=0
+
+
+
+  GL_GNULIB_FSEEK=0
+
+
+
+  GL_GNULIB_FSEEKO=0
+
+
+
+  GL_GNULIB_FTELL=0
+
+
+
+  GL_GNULIB_FTELLO=0
+
+
+
+  GL_GNULIB_FWRITE=0
+
+
+
+  GL_GNULIB_GETC=0
+
+
+
+  GL_GNULIB_GETCHAR=0
+
+
+
+  GL_GNULIB_GETDELIM=0
+
+
+
+  GL_GNULIB_GETLINE=0
+
+
+
+  GL_GNULIB_OBSTACK_PRINTF=0
+
+
+
+  GL_GNULIB_OBSTACK_PRINTF_POSIX=0
+
+
+
+  GL_GNULIB_PCLOSE=0
+
+
+
+  GL_GNULIB_PERROR=0
+
+
+
+  GL_GNULIB_POPEN=0
+
+
+
+  GL_GNULIB_PRINTF=0
+
+
+
+  GL_GNULIB_PRINTF_POSIX=0
+
+
+
+  GL_GNULIB_PUTC=0
+
+
+
+  GL_GNULIB_PUTCHAR=0
+
+
+
+  GL_GNULIB_PUTS=0
+
+
+
+  GL_GNULIB_REMOVE=0
+
+
+
+  GL_GNULIB_RENAME=0
+
+
+
+  GL_GNULIB_RENAMEAT=0
+
+
+
+  GL_GNULIB_SCANF=0
+
+
+
+  GL_GNULIB_SNPRINTF=0
+
+
+
+  GL_GNULIB_SPRINTF_POSIX=0
+
+
+
+  GL_GNULIB_STDIO_H_NONBLOCKING=0
+
+
+
+  GL_GNULIB_STDIO_H_SIGPIPE=0
+
+
+
+  GL_GNULIB_TMPFILE=0
+
+
+
+  GL_GNULIB_VASPRINTF=0
+
+
+
+  GL_GNULIB_VFSCANF=0
+
+
+
+  GL_GNULIB_VSCANF=0
+
+
+
+  GL_GNULIB_VDPRINTF=0
+
+
+
+  GL_GNULIB_VFPRINTF=0
+
+
+
+  GL_GNULIB_VFPRINTF_POSIX=0
+
+
+
+  GL_GNULIB_VPRINTF=0
+
+
+
+  GL_GNULIB_VPRINTF_POSIX=0
+
+
+
+  GL_GNULIB_VSNPRINTF=0
+
+
+
+  GL_GNULIB_VSPRINTF_POSIX=0
+
+
+
+  GL_GNULIB_MDA_FCLOSEALL=1
+
+
+
+  GL_GNULIB_MDA_FDOPEN=1
+
+
+
+  GL_GNULIB_MDA_FILENO=1
+
+
+
+  GL_GNULIB_MDA_GETW=1
+
+
+
+  GL_GNULIB_MDA_PUTW=1
+
+
+
+  GL_GNULIB_MDA_TEMPNAM=1
+
+
+
+
+    HAVE__EXIT=1;
+  HAVE_ALIGNED_ALLOC=1;
+  HAVE_ATOLL=1;
+  HAVE_CANONICALIZE_FILE_NAME=1;
+  HAVE_DECL_ECVT=1;
+  HAVE_DECL_FCVT=1;
+  HAVE_DECL_GCVT=1;
+  HAVE_DECL_GETLOADAVG=1;
+  HAVE_GETPROGNAME=1;
+  HAVE_GETSUBOPT=1;
+  HAVE_GRANTPT=1;
+  HAVE_INITSTATE=1;
+  HAVE_DECL_INITSTATE=1;
+  HAVE_MBTOWC=1;
+  HAVE_MKDTEMP=1;
+  HAVE_MKOSTEMP=1;
+  HAVE_MKOSTEMPS=1;
+  HAVE_MKSTEMP=1;
+  HAVE_MKSTEMPS=1;
+  HAVE_POSIX_MEMALIGN=1;
+  HAVE_POSIX_OPENPT=1;
+  HAVE_PTSNAME=1;
+  HAVE_PTSNAME_R=1;
+  HAVE_QSORT_R=1;
+  HAVE_RANDOM=1;
+  HAVE_RANDOM_H=1;
+  HAVE_RANDOM_R=1;
+  HAVE_REALLOCARRAY=1;
+  HAVE_REALPATH=1;
+  HAVE_RPMATCH=1;
+  HAVE_SECURE_GETENV=1;
+  HAVE_SETENV=1;
+  HAVE_DECL_SETENV=1;
+  HAVE_SETSTATE=1;
+  HAVE_DECL_SETSTATE=1;
+  HAVE_STRTOD=1;
+  HAVE_STRTOL=1;
+  HAVE_STRTOLD=1;
+  HAVE_STRTOLL=1;
+  HAVE_STRTOUL=1;
+  HAVE_STRTOULL=1;
+  HAVE_STRUCT_RANDOM_DATA=1;
+  HAVE_SYS_LOADAVG_H=0;
+  HAVE_UNLOCKPT=1;
+  HAVE_DECL_UNSETENV=1;
+  REPLACE__EXIT=0;
+  REPLACE_ALIGNED_ALLOC=0;
+  REPLACE_CALLOC_FOR_CALLOC_GNU=0;
+  REPLACE_CALLOC_FOR_CALLOC_POSIX=0;
+  REPLACE_CANONICALIZE_FILE_NAME=0;
+  REPLACE_FREE=0;
+  REPLACE_GETLOADAVG=0;
+  REPLACE_GETPROGNAME=0;
+  REPLACE_GETSUBOPT=0;
+  REPLACE_INITSTATE=0;
+  REPLACE_MALLOC_FOR_MALLOC_GNU=0;
+  REPLACE_MALLOC_FOR_MALLOC_POSIX=0;
+  REPLACE_MBTOWC=0;
+  REPLACE_MKOSTEMP=0;
+  REPLACE_MKOSTEMPS=0;
+  REPLACE_MKSTEMP=0;
+  REPLACE_POSIX_MEMALIGN=0;
+  REPLACE_POSIX_OPENPT=0;
+  REPLACE_PTSNAME=0;
+  REPLACE_PTSNAME_R=0;
+  REPLACE_PUTENV=0;
+  REPLACE_QSORT_R=0;
+  REPLACE_RANDOM=0;
+  REPLACE_RANDOM_R=0;
+  REPLACE_REALLOC_FOR_REALLOC_GNU=0;
+  REPLACE_REALLOC_FOR_REALLOC_POSIX=0;
+  REPLACE_REALLOCARRAY=0;
+  REPLACE_REALPATH=0;
+  REPLACE_SETENV=0;
+  REPLACE_SETSTATE=0;
+  REPLACE_STRTOD=0;
+  REPLACE_STRTOL=0;
+  REPLACE_STRTOLD=0;
+  REPLACE_STRTOLL=0;
+  REPLACE_STRTOUL=0;
+  REPLACE_STRTOULL=0;
+  REPLACE_UNSETENV=0;
+  REPLACE_WCTOMB=0;
+
+
+
+  GL_GNULIB__EXIT=0
+
+
+
+  GL_GNULIB_ALIGNED_ALLOC=0
+
+
+
+  GL_GNULIB_ATOLL=0
+
+
+
+  GL_GNULIB_CALLOC_GNU=0
+
+
+
+  GL_GNULIB_CALLOC_POSIX=0
+
+
+
+  GL_GNULIB_CANONICALIZE_FILE_NAME=0
+
+
+
+  GL_GNULIB_FREE_POSIX=0
+
+
+
+  GL_GNULIB_GETLOADAVG=0
+
+
+
+  GL_GNULIB_GETPROGNAME=0
+
+
+
+  GL_GNULIB_GETSUBOPT=0
+
+
+
+  GL_GNULIB_GRANTPT=0
+
+
+
+  GL_GNULIB_MALLOC_GNU=0
+
+
+
+  GL_GNULIB_MALLOC_POSIX=0
+
+
+
+  GL_GNULIB_MBTOWC=0
+
+
+
+  GL_GNULIB_MKDTEMP=0
+
+
+
+  GL_GNULIB_MKOSTEMP=0
+
+
+
+  GL_GNULIB_MKOSTEMPS=0
+
+
+
+  GL_GNULIB_MKSTEMP=0
+
+
+
+  GL_GNULIB_MKSTEMPS=0
+
+
+
+  GL_GNULIB_POSIX_MEMALIGN=0
+
+
+
+  GL_GNULIB_POSIX_OPENPT=0
+
+
+
+  GL_GNULIB_PTSNAME=0
+
+
+
+  GL_GNULIB_PTSNAME_R=0
+
+
+
+  GL_GNULIB_PUTENV=0
+
+
+
+  GL_GNULIB_QSORT_R=0
+
+
+
+  GL_GNULIB_RANDOM=0
+
+
+
+  GL_GNULIB_RANDOM_R=0
+
+
+
+  GL_GNULIB_REALLOCARRAY=0
+
+
+
+  GL_GNULIB_REALLOC_GNU=0
+
+
+
+  GL_GNULIB_REALLOC_POSIX=0
+
+
+
+  GL_GNULIB_REALPATH=0
+
+
+
+  GL_GNULIB_RPMATCH=0
+
+
+
+  GL_GNULIB_SECURE_GETENV=0
+
+
+
+  GL_GNULIB_SETENV=0
+
+
+
+  GL_GNULIB_STRTOD=0
+
+
+
+  GL_GNULIB_STRTOL=0
+
+
+
+  GL_GNULIB_STRTOLD=0
+
+
+
+  GL_GNULIB_STRTOLL=0
+
+
+
+  GL_GNULIB_STRTOUL=0
+
+
+
+  GL_GNULIB_STRTOULL=0
+
+
+
+  GL_GNULIB_SYSTEM_POSIX=0
+
+
+
+  GL_GNULIB_UNLOCKPT=0
+
+
+
+  GL_GNULIB_UNSETENV=0
+
+
+
+  GL_GNULIB_WCTOMB=0
+
+
+
+  GL_GNULIB_MDA_ECVT=1
+
+
+
+  GL_GNULIB_MDA_FCVT=1
+
+
+
+  GL_GNULIB_MDA_GCVT=1
+
+
+
+  GL_GNULIB_MDA_MKTEMP=1
+
+
+
+  GL_GNULIB_MDA_PUTENV=1
+
+
+
+
     HAVE_ACOSF=1;
   HAVE_ACOSL=1;
   HAVE_ASINF=1;
@@ -10847,8 +13107,10 @@
   REPLACE_COSF=0;
   REPLACE_COSHF=0;
   REPLACE_EXPF=0;
+  REPLACE_EXPL=0;
   REPLACE_EXPM1=0;
   REPLACE_EXPM1F=0;
+  REPLACE_EXPM1L=0;
   REPLACE_EXP2=0;
   REPLACE_EXP2L=0;
   REPLACE_FABSL=0;
@@ -10897,11 +13159,12 @@
   REPLACE_REMAINDER=0;
   REPLACE_REMAINDERF=0;
   REPLACE_REMAINDERL=0;
+  REPLACE_RINTL=0;
   REPLACE_ROUND=0;
   REPLACE_ROUNDF=0;
   REPLACE_ROUNDL=0;
   REPLACE_SIGNBIT=0;
-  REPLACE_SIGNBIT_USING_GCC=0;
+  REPLACE_SIGNBIT_USING_BUILTINS=0;
   REPLACE_SINF=0;
   REPLACE_SINHF=0;
   REPLACE_SQRTF=0;
@@ -10913,1215 +13176,586 @@
   REPLACE_TRUNCL=0;
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexp() can be used without linking with libm" >&5
-$as_echo_n "checking whether frexp() can be used without linking with libm... " >&6; }
-if ${gl_cv_func_frexp_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexp() can be used without linking with libm" >&5
+printf %s "checking whether frexp() can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_frexp_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
              double x;
 int
-main ()
+main (void)
 {
 int e; return frexp (x, &e) > 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_frexp_no_libm=yes
-else
+else $as_nop
   gl_cv_func_frexp_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_no_libm" >&5
-$as_echo "$gl_cv_func_frexp_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_no_libm" >&5
+printf "%s\n" "$gl_cv_func_frexp_no_libm" >&6; }
 
-ac_fn_c_check_decl "$LINENO" "alarm" "ac_cv_have_decl_alarm" "$ac_includes_default"
-if test "x$ac_cv_have_decl_alarm" = xyes; then :
+ac_fn_check_decl "$LINENO" "alarm" "ac_cv_have_decl_alarm" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_alarm" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
+printf "%s\n" "#define HAVE_DECL_ALARM $ac_have_decl" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_ALARM $ac_have_decl
-_ACEOF
 
 
+  GL_GNULIB_ACOSF=0
 
 
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
 
-#ifdef _MSC_VER
-MicrosoftCompiler
-#endif
+  GL_GNULIB_ACOSL=0
 
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "MicrosoftCompiler" >/dev/null 2>&1; then :
-  gl_asmext='asm'
-     gl_c_asm_opt='-c -Fa'
 
-else
-  gl_asmext='s'
-     gl_c_asm_opt='-S'
 
-fi
-rm -f conftest*
+  GL_GNULIB_ASINF=0
 
 
 
+  GL_GNULIB_ASINL=0
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking host CPU and C ABI" >&5
-$as_echo_n "checking host CPU and C ABI... " >&6; }
-if ${gl_cv_host_cpu_c_abi+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  case "$host_cpu" in
 
-       i456786 )
-         gl_cv_host_cpu_c_abi=i386
-         ;;
+  GL_GNULIB_ATANF=0
 
-       x86_64 )
-         # On x86_64 systems, the C compiler may be generating code in one of
-         # these ABIs:
-         # - 64-bit instruction set, 64-bit pointers, 64-bit 'long': x86_64.
-         # - 64-bit instruction set, 64-bit pointers, 32-bit 'long': x86_64
-         #   with native Windows (mingw, MSVC).
-         # - 64-bit instruction set, 32-bit pointers, 32-bit 'long': x86_64-x32.
-         # - 32-bit instruction set, 32-bit pointers, 32-bit 'long': i386.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if (defined __x86_64__ || defined __amd64__ \
-                     || defined _M_X64 || defined _M_AMD64)
-                 int ok;
-                #else
-                 error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __ILP32__ || defined _ILP32
-                    int ok;
-                   #else
-                    error fail
-                   #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=x86_64-x32
-else
-  gl_cv_host_cpu_c_abi=x86_64
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-else
-  gl_cv_host_cpu_c_abi=i386
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
+  GL_GNULIB_ATANL=0
 
-       alphaev4-8 | alphaev56 | alphapca567 | alphaev678 )
-         gl_cv_host_cpu_c_abi=alpha
-         ;;
 
-       arm* | aarch64 )
-         # Assume arm with EABI.
-         # On arm64 systems, the C compiler may be generating code in one of
-         # these ABIs:
-         # - aarch64 instruction set, 64-bit pointers, 64-bit 'long': arm64.
-         # - aarch64 instruction set, 32-bit pointers, 32-bit 'long': arm64-ilp32.
-         # - 32-bit instruction set, 32-bit pointers, 32-bit 'long': arm or armhf.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifdef __aarch64__
-                 int ok;
-                #else
-                 error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __ILP32__ || defined _ILP32
-                   int ok;
-                  #else
-                   error fail
-                  #endif
-
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=arm64-ilp32
-else
-  gl_cv_host_cpu_c_abi=arm64
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-else
-  # Don't distinguish little-endian and big-endian arm, since they
-            # don't require different machine code for simple operations and
-            # since the user can distinguish them through the preprocessor
-            # defines __ARMEL__ vs. __ARMEB__.
-            # But distinguish arm which passes floating-point arguments and
-            # return values in integer registers (r0, r1, ...) - this is
-            # gcc -mfloat-abi=soft or gcc -mfloat-abi=softfp - from arm which
-            # passes them in float registers (s0, s1, ...) and double registers
-            # (d0, d1, ...) - this is gcc -mfloat-abi=hard. GCC 4.6 or newer
-            # sets the preprocessor defines __ARM_PCS (for the first case) and
-            # __ARM_PCS_VFP (for the second case), but older GCC does not.
-            echo 'double ddd; void func (double dd) { ddd = dd; }' > conftest.c
-            # Look for a reference to the register d0 in the .s file.
-            { ac_try='${CC-cc} $CFLAGS $CPPFLAGS $gl_c_asm_opt conftest.c'
-  { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_try\""; } >&5
-  (eval $ac_try) 2>&5
-  ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
-  test $ac_status = 0; }; } >/dev/null 2>&1
-            if LC_ALL=C grep 'd0,' conftest.$gl_asmext >/dev/null; then
-              gl_cv_host_cpu_c_abi=armhf
-            else
-              gl_cv_host_cpu_c_abi=arm
-            fi
-            rm -f conftest*
+  GL_GNULIB_ATAN2F=0
 
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
 
-       hppa1.0 | hppa1.1 | hppa2.0* | hppa64 )
-         # On hppa, the C compiler may be generating 32-bit code or 64-bit
-         # code. In the latter case, it defines _LP64 and __LP64__.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifdef __LP64__
-                 int ok;
-                #else
-                 error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=hppa64
-else
-  gl_cv_host_cpu_c_abi=hppa
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
+  GL_GNULIB_CBRT=0
 
-       ia64* )
-         # On ia64 on HP-UX, the C compiler may be generating 64-bit code or
-         # 32-bit code. In the latter case, it defines _ILP32.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifdef _ILP32
-                 int ok;
-                #else
-                 error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=ia64-ilp32
-else
-  gl_cv_host_cpu_c_abi=ia64
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
 
-       mips* )
-         # We should also check for (_MIPS_SZPTR == 64), but gcc keeps this
-         # at 32.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined _MIPS_SZLONG && (_MIPS_SZLONG == 64)
-                 int ok;
-                #else
-                 error fail
-                #endif
+  GL_GNULIB_CBRTF=0
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=mips64
-else
-  # In the n32 ABI, _ABIN32 is defined, _ABIO32 is not defined (but
-            # may later get defined by <sgidefs.h>), and _MIPS_SIM == _ABIN32.
-            # In the 32 ABI, _ABIO32 is defined, _ABIN32 is not defined (but
-            # may later get defined by <sgidefs.h>), and _MIPS_SIM == _ABIO32.
-            cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if (_MIPS_SIM == _ABIN32)
-                    int ok;
-                   #else
-                    error fail
-                   #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=mipsn32
-else
-  gl_cv_host_cpu_c_abi=mips
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
 
-       powerpc* )
-         # Different ABIs are in use on AIX vs. Mac OS X vs. Linux,*BSD.
-         # No need to distinguish them here; the caller may distinguish
-         # them based on the OS.
-         # On powerpc64 systems, the C compiler may still be generating
-         # 32-bit code. And on powerpc-ibm-aix systems, the C compiler may
-         # be generating 64-bit code.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __powerpc64__ || defined _ARCH_PPC64
-                 int ok;
-                #else
-                 error fail
-                #endif
+  GL_GNULIB_CBRTL=0
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  # On powerpc64, there are two ABIs on Linux: The AIX compatible
-            # one and the ELFv2 one. The latter defines _CALL_ELF=2.
-            cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined _CALL_ELF && _CALL_ELF == 2
-                    int ok;
-                   #else
-                    error fail
-                   #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=powerpc64-elfv2
-else
-  gl_cv_host_cpu_c_abi=powerpc64
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
 
-else
-  gl_cv_host_cpu_c_abi=powerpc
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
+  GL_GNULIB_CEIL=0
 
-       rs6000 )
-         gl_cv_host_cpu_c_abi=powerpc
-         ;;
 
-       riscv32 | riscv64 )
-         # There are 2 architectures (with variants): rv32* and rv64*.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if __riscv_xlen == 64
-                  int ok;
-                #else
-                  error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  cpu=riscv64
-else
-  cpu=riscv32
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         # There are 6 ABIs: ilp32, ilp32f, ilp32d, lp64, lp64f, lp64d.
-         # Size of 'long' and 'void *':
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __LP64__
-                  int ok;
-                #else
-                  error fail
-                #endif
+  GL_GNULIB_CEILF=0
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  main_abi=lp64
-else
-  main_abi=ilp32
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         # Float ABIs:
-         # __riscv_float_abi_double:
-         #   'float' and 'double' are passed in floating-point registers.
-         # __riscv_float_abi_single:
-         #   'float' are passed in floating-point registers.
-         # __riscv_float_abi_soft:
-         #   No values are passed in floating-point registers.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __riscv_float_abi_double
-                  int ok;
-                #else
-                  error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  float_abi=d
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __riscv_float_abi_single
-                     int ok;
-                   #else
-                     error fail
-                   #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  float_abi=f
-else
-  float_abi=''
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+  GL_GNULIB_CEILL=0
 
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         gl_cv_host_cpu_c_abi="${cpu}-${main_abi}${float_abi}"
-         ;;
 
-       s390* )
-         # On s390x, the C compiler may be generating 64-bit (= s390x) code
-         # or 31-bit (= s390) code.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __LP64__ || defined __s390x__
-                  int ok;
-                #else
-                  error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=s390x
-else
-  gl_cv_host_cpu_c_abi=s390
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
+  GL_GNULIB_COPYSIGN=0
 
-       sparc | sparc64 )
-         # UltraSPARCs running Linux have `uname -m` = "sparc64", but the
-         # C compiler still generates 32-bit code.
-         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#if defined __sparcv9 || defined __arch64__
-                 int ok;
-                #else
-                 error fail
-                #endif
 
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_host_cpu_c_abi=sparc64
-else
-  gl_cv_host_cpu_c_abi=sparc
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-         ;;
 
-       *)
-         gl_cv_host_cpu_c_abi="$host_cpu"
-         ;;
-     esac
+  GL_GNULIB_COPYSIGNF=0
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_host_cpu_c_abi" >&5
-$as_echo "$gl_cv_host_cpu_c_abi" >&6; }
 
-    HOST_CPU=`echo "$gl_cv_host_cpu_c_abi" | sed -e 's/-.*//'`
-  HOST_CPU_C_ABI="$gl_cv_host_cpu_c_abi"
 
+  GL_GNULIB_COPYSIGNL=0
 
 
-  # This was
-  #   AC_DEFINE_UNQUOTED(__${HOST_CPU}__)
-  #   AC_DEFINE_UNQUOTED(__${HOST_CPU_C_ABI}__)
-  # earlier, but KAI C++ 3.2d doesn't like this.
-  sed -e 's/-/_/g' >> confdefs.h <<EOF
-#ifndef __${HOST_CPU}__
-#define __${HOST_CPU}__ 1
-#endif
-#ifndef __${HOST_CPU_C_ABI}__
-#define __${HOST_CPU_C_ABI}__ 1
-#endif
-EOF
 
+  GL_GNULIB_COSF=0
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'float'" >&5
-$as_echo_n "checking where to find the exponent in a 'float'... " >&6; }
-if ${gl_cv_cc_float_expbit0+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  GL_GNULIB_COSL=0
 
-      if test "$cross_compiling" = yes; then :
-  gl_cv_cc_float_expbit0="word 0 bit 23"
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
 
-#include <float.h>
-#include <stddef.h>
-#include <stdio.h>
-#include <string.h>
-#define NWORDS \
-  ((sizeof (float) + sizeof (unsigned int) - 1) / sizeof (unsigned int))
-typedef union { float value; unsigned int wordNWORDS; } memory_float;
-static unsigned int ored_wordsNWORDS;
-static unsigned int anded_wordsNWORDS;
-static void add_to_ored_words (float x)
-{
-  memory_float m;
-  size_t i;
-  /* Clear it first, in case
-     sizeof (float) < sizeof (memory_float).  */
-  memset (&m, 0, sizeof (memory_float));
-  m.value = x;
-  for (i = 0; i < NWORDS; i++)
-    {
-      ored_wordsi |= m.wordi;
-      anded_wordsi &= m.wordi;
-    }
-}
-int main ()
-{
-  size_t j;
-  FILE *fp = fopen ("conftest.out", "w");
-  if (fp == NULL)
-    return 1;
-  for (j = 0; j < NWORDS; j++)
-    anded_wordsj = ~ (unsigned int) 0;
-  add_to_ored_words (0.25f);
-  add_to_ored_words (0.5f);
-  add_to_ored_words (1.0f);
-  add_to_ored_words (2.0f);
-  add_to_ored_words (4.0f);
-  /* Remove bits that are common (e.g. if representation of the first mantissa
-     bit is explicit).  */
-  for (j = 0; j < NWORDS; j++)
-    ored_wordsj &= ~anded_wordsj;
-  /* Now find the nonzero word.  */
-  for (j = 0; j < NWORDS; j++)
-    if (ored_wordsj != 0)
-      break;
-  if (j < NWORDS)
-    {
-      size_t i;
-      for (i = j + 1; i < NWORDS; i++)
-        if (ored_wordsi != 0)
-          {
-            fprintf (fp, "unknown");
-            return (fclose (fp) != 0);
-          }
-      for (i = 0; ; i++)
-        if ((ored_wordsj >> i) & 1)
-          {
-            fprintf (fp, "word %d bit %d", (int) j, (int) i);
-            return (fclose (fp) != 0);
-          }
-    }
-  fprintf (fp, "unknown");
-  return (fclose (fp) != 0);
-}
 
-_ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  gl_cv_cc_float_expbit0=`cat conftest.out`
-else
-  gl_cv_cc_float_expbit0="unknown"
-fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
-fi
+  GL_GNULIB_COSHF=0
 
-      rm -f conftest.out
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_expbit0" >&5
-$as_echo "$gl_cv_cc_float_expbit0" >&6; }
-  case "$gl_cv_cc_float_expbit0" in
-    word*bit*)
-      word=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word //' -e 's/ bit.*//'`
-      bit=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_EXPBIT0_WORD $word
-_ACEOF
+  GL_GNULIB_EXPF=0
 
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_EXPBIT0_BIT $bit
-_ACEOF
 
-      ;;
-  esac
+  GL_GNULIB_EXPL=0
 
 
 
+  GL_GNULIB_EXP2=0
 
 
 
+  GL_GNULIB_EXP2F=0
 
 
 
+  GL_GNULIB_EXP2L=0
 
 
 
+  GL_GNULIB_EXPM1=0
 
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_limits_h='<'limits.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <limits.h>" >&5
-$as_echo_n "checking absolute name of <limits.h>... " >&6; }
-if ${gl_cv_next_limits_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
 
-             if test $ac_cv_header_limits_h = yes; then
 
+  GL_GNULIB_EXPM1F=0
 
 
 
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <limits.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
+  GL_GNULIB_EXPM1L=0
 
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
-      ;;
-  esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'limits.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
 
-        gl_cv_absolute_limits_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_limits_h
-           gl_cv_next_limits_h='"'$gl_header'"'
-          else
-               gl_cv_next_limits_h='<'limits.h'>'
-             fi
+  GL_GNULIB_FABSF=0
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_limits_h" >&5
-$as_echo "$gl_cv_next_limits_h" >&6; }
-     fi
-     NEXT_LIMITS_H=$gl_cv_next_limits_h
 
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'limits.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_limits_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_LIMITS_H=$gl_next_as_first_directive
+  GL_GNULIB_FABSL=0
 
 
 
+  GL_GNULIB_FLOOR=0
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether limits.h has LLONG_MAX, WORD_BIT, ULLONG_WIDTH etc." >&5
-$as_echo_n "checking whether limits.h has LLONG_MAX, WORD_BIT, ULLONG_WIDTH etc.... " >&6; }
-if ${gl_cv_header_limits_width+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#ifndef __STDC_WANT_IEC_60559_BFP_EXT__
-             #define __STDC_WANT_IEC_60559_BFP_EXT__ 1
-            #endif
-            #include <limits.h>
-            long long llm = LLONG_MAX;
-            int wb = WORD_BIT;
-            int ullw = ULLONG_WIDTH;
 
-int
-main ()
-{
+  GL_GNULIB_FLOORF=0
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_header_limits_width=yes
-else
-  gl_cv_header_limits_width=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_limits_width" >&5
-$as_echo "$gl_cv_header_limits_width" >&6; }
-  if test "$gl_cv_header_limits_width" = yes; then
-    LIMITS_H=
-  else
-    LIMITS_H=limits.h
-  fi
 
-   if test -n "$LIMITS_H"; then
-  GL_GENERATE_LIMITS_H_TRUE=
-  GL_GENERATE_LIMITS_H_FALSE='#'
-else
-  GL_GENERATE_LIMITS_H_TRUE='#'
-  GL_GENERATE_LIMITS_H_FALSE=
-fi
 
+  GL_GNULIB_FLOORL=0
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for nl_langinfo and CODESET" >&5
-$as_echo_n "checking for nl_langinfo and CODESET... " >&6; }
-if ${am_cv_langinfo_codeset+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <langinfo.h>
-int
-main ()
-{
-char* cs = nl_langinfo(CODESET); return !cs;
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  am_cv_langinfo_codeset=yes
-else
-  am_cv_langinfo_codeset=no
-fi
-rm -f core conftest.err conftest.$ac_objext \
-    conftest$ac_exeext conftest.$ac_ext
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_langinfo_codeset" >&5
-$as_echo "$am_cv_langinfo_codeset" >&6; }
-  if test $am_cv_langinfo_codeset = yes; then
+  GL_GNULIB_FMA=0
 
-$as_echo "#define HAVE_LANGINFO_CODESET 1" >>confdefs.h
 
-  fi
 
+  GL_GNULIB_FMAF=0
 
 
 
+  GL_GNULIB_FMAL=0
 
 
 
+  GL_GNULIB_FMOD=0
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for working fcntl.h" >&5
-$as_echo_n "checking for working fcntl.h... " >&6; }
-if ${gl_cv_header_working_fcntl_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test "$cross_compiling" = yes; then :
-  gl_cv_header_working_fcntl_h=cross-compiling
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <sys/types.h>
-           #include <sys/stat.h>
-           #if HAVE_UNISTD_H
-           # include <unistd.h>
-           #else /* on Windows with MSVC */
-           # include <io.h>
-           # include <stdlib.h>
-           # defined sleep(n) _sleep ((n) * 1000)
-           #endif
-           #include <fcntl.h>
-           #ifndef O_NOATIME
-            #define O_NOATIME 0
-           #endif
-           #ifndef O_NOFOLLOW
-            #define O_NOFOLLOW 0
-           #endif
-           static int const constants =
-            {
-              O_CREAT, O_EXCL, O_NOCTTY, O_TRUNC, O_APPEND,
-              O_NONBLOCK, O_SYNC, O_ACCMODE, O_RDONLY, O_RDWR, O_WRONLY
-            };
+  GL_GNULIB_FMODF=0
 
-int
-main ()
-{
 
-            int result = !constants;
-            #if HAVE_SYMLINK
-            {
-              static char const sym = "conftest.sym";
-              if (symlink ("/dev/null", sym) != 0)
-                result |= 2;
-              else
-                {
-                  int fd = open (sym, O_WRONLY | O_NOFOLLOW | O_CREAT, 0);
-                  if (fd >= 0)
-                    {
-                      close (fd);
-                      result |= 4;
-                    }
-                }
-              if (unlink (sym) != 0 || symlink (".", sym) != 0)
-                result |= 2;
-              else
-                {
-                  int fd = open (sym, O_RDONLY | O_NOFOLLOW);
-                  if (fd >= 0)
-                    {
-                      close (fd);
-                      result |= 4;
-                    }
-                }
-              unlink (sym);
-            }
-            #endif
-            {
-              static char const file = "confdefs.h";
-              int fd = open (file, O_RDONLY | O_NOATIME);
-              if (fd < 0)
-                result |= 8;
-              else
-                {
-                  struct stat st0;
-                  if (fstat (fd, &st0) != 0)
-                    result |= 16;
-                  else
-                    {
-                      char c;
-                      sleep (1);
-                      if (read (fd, &c, 1) != 1)
-                        result |= 24;
-                      else
-                        {
-                          if (close (fd) != 0)
-                            result |= 32;
-                          else
-                            {
-                              struct stat st1;
-                              if (stat (file, &st1) != 0)
-                                result |= 40;
-                              else
-                                if (st0.st_atime != st1.st_atime)
-                                  result |= 64;
-                            }
-                        }
-                    }
-                }
-            }
-            return result;
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  gl_cv_header_working_fcntl_h=yes
-else
-  case $? in #(
-        4) gl_cv_header_working_fcntl_h='no (bad O_NOFOLLOW)';; #(
-        64) gl_cv_header_working_fcntl_h='no (bad O_NOATIME)';; #(
-        68) gl_cv_header_working_fcntl_h='no (bad O_NOATIME, O_NOFOLLOW)';; #(
-         *) gl_cv_header_working_fcntl_h='no';;
-        esac
-fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
-fi
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_working_fcntl_h" >&5
-$as_echo "$gl_cv_header_working_fcntl_h" >&6; }
+  GL_GNULIB_FMODL=0
 
-  case $gl_cv_header_working_fcntl_h in #(
-  *O_NOATIME* | no | cross-compiling) ac_val=0;; #(
-  *) ac_val=1;;
-  esac
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_WORKING_O_NOATIME $ac_val
-_ACEOF
 
+  GL_GNULIB_FREXPF=0
 
-  case $gl_cv_header_working_fcntl_h in #(
-  *O_NOFOLLOW* | no | cross-compiling) ac_val=0;; #(
-  *) ac_val=1;;
-  esac
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_WORKING_O_NOFOLLOW $ac_val
-_ACEOF
 
+  GL_GNULIB_FREXP=0
 
-ac_fn_c_check_decl "$LINENO" "getc_unlocked" "ac_cv_have_decl_getc_unlocked" "$ac_includes_default"
-if test "x$ac_cv_have_decl_getc_unlocked" = xyes; then :
-  ac_have_decl=1
-else
-  ac_have_decl=0
-fi
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_GETC_UNLOCKED $ac_have_decl
-_ACEOF
 
+  GL_GNULIB_FREXPL=0
 
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C Library >= 2.1 or uClibc" >&5
-$as_echo_n "checking whether we are using the GNU C Library >= 2.1 or uClibc... " >&6; }
-if ${ac_cv_gnu_library_2_1+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
 
-#include <features.h>
-#ifdef __GNU_LIBRARY__
- #if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 1) || (__GLIBC__ > 2)
-  Lucky GNU user
- #endif
-#endif
-#ifdef __UCLIBC__
- Lucky user
-#endif
 
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Lucky" >/dev/null 2>&1; then :
-  ac_cv_gnu_library_2_1=yes
-else
-  ac_cv_gnu_library_2_1=no
-fi
-rm -f conftest*
+  GL_GNULIB_HYPOT=0
 
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_gnu_library_2_1" >&5
-$as_echo "$ac_cv_gnu_library_2_1" >&6; }
+  GL_GNULIB_HYPOTF=0
 
-    GLIBC21="$ac_cv_gnu_library_2_1"
 
 
+  GL_GNULIB_HYPOTL=0
 
 
 
+  GL_GNULIB_ILOGB=0
 
 
 
+  GL_GNULIB_ILOGBF=0
 
-  GNULIB_EXPLICIT_BZERO=0;
-  GNULIB_FFSL=0;
-  GNULIB_FFSLL=0;
-  GNULIB_MEMCHR=0;
-  GNULIB_MEMMEM=0;
-  GNULIB_MEMPCPY=0;
-  GNULIB_MEMRCHR=0;
-  GNULIB_RAWMEMCHR=0;
-  GNULIB_STPCPY=0;
-  GNULIB_STPNCPY=0;
-  GNULIB_STRCHRNUL=0;
-  GNULIB_STRDUP=0;
-  GNULIB_STRNCAT=0;
-  GNULIB_STRNDUP=0;
-  GNULIB_STRNLEN=0;
-  GNULIB_STRPBRK=0;
-  GNULIB_STRSEP=0;
-  GNULIB_STRSTR=0;
-  GNULIB_STRCASESTR=0;
-  GNULIB_STRTOK_R=0;
-  GNULIB_MBSLEN=0;
-  GNULIB_MBSNLEN=0;
-  GNULIB_MBSCHR=0;
-  GNULIB_MBSRCHR=0;
-  GNULIB_MBSSTR=0;
-  GNULIB_MBSCASECMP=0;
-  GNULIB_MBSNCASECMP=0;
-  GNULIB_MBSPCASECMP=0;
-  GNULIB_MBSCASESTR=0;
-  GNULIB_MBSCSPN=0;
-  GNULIB_MBSPBRK=0;
-  GNULIB_MBSSPN=0;
-  GNULIB_MBSSEP=0;
-  GNULIB_MBSTOK_R=0;
-  GNULIB_STRERROR=0;
-  GNULIB_STRERROR_R=0;
-  GNULIB_STRSIGNAL=0;
-  GNULIB_STRVERSCMP=0;
-  HAVE_MBSLEN=0;
-    HAVE_EXPLICIT_BZERO=1;
-  HAVE_FFSL=1;
-  HAVE_FFSLL=1;
-  HAVE_MEMCHR=1;
-  HAVE_DECL_MEMMEM=1;
-  HAVE_MEMPCPY=1;
-  HAVE_DECL_MEMRCHR=1;
-  HAVE_RAWMEMCHR=1;
-  HAVE_STPCPY=1;
-  HAVE_STPNCPY=1;
-  HAVE_STRCHRNUL=1;
-  HAVE_DECL_STRDUP=1;
-  HAVE_DECL_STRNDUP=1;
-  HAVE_DECL_STRNLEN=1;
-  HAVE_STRPBRK=1;
-  HAVE_STRSEP=1;
-  HAVE_STRCASESTR=1;
-  HAVE_DECL_STRTOK_R=1;
-  HAVE_DECL_STRERROR_R=1;
-  HAVE_DECL_STRSIGNAL=1;
-  HAVE_STRVERSCMP=1;
-  REPLACE_MEMCHR=0;
-  REPLACE_MEMMEM=0;
-  REPLACE_STPNCPY=0;
-  REPLACE_STRCHRNUL=0;
-  REPLACE_STRDUP=0;
-  REPLACE_STRNCAT=0;
-  REPLACE_STRNDUP=0;
-  REPLACE_STRNLEN=0;
-  REPLACE_STRSTR=0;
-  REPLACE_STRCASESTR=0;
-  REPLACE_STRTOK_R=0;
-  REPLACE_STRERROR=0;
-  REPLACE_STRERROR_R=0;
-  REPLACE_STRSIGNAL=0;
-  UNDEFINE_STRTOK_R=0;
 
 
+  GL_GNULIB_ILOGBL=0
 
 
 
+  GL_GNULIB_ISFINITE=0
 
-  # Check for mmap(). Don't use AC_FUNC_MMAP, because it checks too much: it
-  # fails on HP-UX 11, because MAP_FIXED mappings do not work. But this is
-  # irrelevant for anonymous mappings.
-  ac_fn_c_check_func "$LINENO" "mmap" "ac_cv_func_mmap"
-if test "x$ac_cv_func_mmap" = xyes; then :
-  gl_have_mmap=yes
-else
-  gl_have_mmap=no
-fi
 
 
-  # Try to allow MAP_ANONYMOUS.
-  gl_have_mmap_anonymous=no
-  if test $gl_have_mmap = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for MAP_ANONYMOUS" >&5
-$as_echo_n "checking for MAP_ANONYMOUS... " >&6; }
-    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
+  GL_GNULIB_ISINF=0
 
-#include <sys/mman.h>
-#ifdef MAP_ANONYMOUS
-    I cannot identify this map
-#endif
 
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "I cannot identify this map" >/dev/null 2>&1; then :
-  gl_have_mmap_anonymous=yes
-fi
-rm -f conftest*
 
-    if test $gl_have_mmap_anonymous != yes; then
-      cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
+  GL_GNULIB_ISNAN=0
 
-#include <sys/mman.h>
-#ifdef MAP_ANON
-    I cannot identify this map
-#endif
 
-_ACEOF
-if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "I cannot identify this map" >/dev/null 2>&1; then :
 
-$as_echo "#define MAP_ANONYMOUS MAP_ANON" >>confdefs.h
+  GL_GNULIB_ISNANF=0
 
-         gl_have_mmap_anonymous=yes
-fi
-rm -f conftest*
 
-    fi
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_have_mmap_anonymous" >&5
-$as_echo "$gl_have_mmap_anonymous" >&6; }
-    if test $gl_have_mmap_anonymous = yes; then
 
-$as_echo "#define HAVE_MAP_ANONYMOUS 1" >>confdefs.h
+  GL_GNULIB_ISNAND=0
 
-    fi
-  fi
 
 
+  GL_GNULIB_ISNANL=0
 
 
 
+  GL_GNULIB_LDEXPF=0
 
-  if test $HAVE_MEMCHR = 1; then
-    # Detect platform-specific bugs in some versions of glibc:
-    # memchr should not dereference anything with length 0
-    #   https://bugzilla.redhat.com/show_bug.cgi?id=499689
-    # memchr should not dereference overestimated length after a match
-    #   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=521737
-    #   https://sourceware.org/bugzilla/show_bug.cgi?id=10162
-    # Assume that memchr works on platforms that lack mprotect.
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether memchr works" >&5
-$as_echo_n "checking whether memchr works... " >&6; }
-if ${gl_cv_func_memchr_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test "$cross_compiling" = yes; then :
-  case "$host_os" in
-                    # Guess yes on native Windows.
-            mingw*) gl_cv_func_memchr_works="guessing yes" ;;
-                    # Be pessimistic for now.
-            *)      gl_cv_func_memchr_works="guessing no" ;;
-          esac
 
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
 
-#include <string.h>
-#if HAVE_SYS_MMAN_H
-# include <fcntl.h>
-# include <unistd.h>
-# include <sys/types.h>
-# include <sys/mman.h>
-# ifndef MAP_FILE
-#  define MAP_FILE 0
-# endif
-#endif
+  GL_GNULIB_LDEXPL=0
 
-int
-main ()
-{
 
-  int result = 0;
-  char *fence = NULL;
-#if HAVE_SYS_MMAN_H && HAVE_MPROTECT
-# if HAVE_MAP_ANONYMOUS
-  const int flags = MAP_ANONYMOUS | MAP_PRIVATE;
-  const int fd = -1;
-# else /* !HAVE_MAP_ANONYMOUS */
-  const int flags = MAP_FILE | MAP_PRIVATE;
-  int fd = open ("/dev/zero", O_RDONLY, 0666);
-  if (fd >= 0)
-# endif
-    {
-      int pagesize = getpagesize ();
-      char *two_pages =
-        (char *) mmap (NULL, 2 * pagesize, PROT_READ | PROT_WRITE,
-                       flags, fd, 0);
-      if (two_pages != (char *)(-1)
-          && mprotect (two_pages + pagesize, pagesize, PROT_NONE) == 0)
-        fence = two_pages + pagesize;
-    }
-#endif
-  if (fence)
-    {
-      if (memchr (fence, 0, 0))
-        result |= 1;
-      strcpy (fence - 9, "12345678");
-      if (memchr (fence - 9, 0, 79) != fence - 1)
-        result |= 2;
-      if (memchr (fence - 1, 0, 3) != fence - 1)
-        result |= 4;
-    }
-  return result;
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  gl_cv_func_memchr_works=yes
-else
-  gl_cv_func_memchr_works=no
-fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
-fi
+  GL_GNULIB_LOG=0
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_memchr_works" >&5
-$as_echo "$gl_cv_func_memchr_works" >&6; }
-    case "$gl_cv_func_memchr_works" in
-      *yes) ;;
-      *) REPLACE_MEMCHR=1 ;;
-    esac
-  fi
 
-ac_fn_c_check_decl "$LINENO" "snprintf" "ac_cv_have_decl_snprintf" "$ac_includes_default"
-if test "x$ac_cv_have_decl_snprintf" = xyes; then :
-  ac_have_decl=1
-else
-  ac_have_decl=0
-fi
+  GL_GNULIB_LOGF=0
+
+
+
+  GL_GNULIB_LOGL=0
+
+
+
+  GL_GNULIB_LOG10=0
+
+
+
+  GL_GNULIB_LOG10F=0
+
+
+
+  GL_GNULIB_LOG10L=0
+
+
+
+  GL_GNULIB_LOG1P=0
+
+
+
+  GL_GNULIB_LOG1PF=0
+
+
+
+  GL_GNULIB_LOG1PL=0
+
+
+
+  GL_GNULIB_LOG2=0
+
+
+
+  GL_GNULIB_LOG2F=0
+
+
+
+  GL_GNULIB_LOG2L=0
+
+
+
+  GL_GNULIB_LOGB=0
+
+
+
+  GL_GNULIB_LOGBF=0
+
+
+
+  GL_GNULIB_LOGBL=0
+
+
+
+  GL_GNULIB_MODF=0
+
+
+
+  GL_GNULIB_MODFF=0
+
+
+
+  GL_GNULIB_MODFL=0
+
+
+
+  GL_GNULIB_POWF=0
+
+
+
+  GL_GNULIB_REMAINDER=0
+
+
+
+  GL_GNULIB_REMAINDERF=0
+
+
+
+  GL_GNULIB_REMAINDERL=0
+
+
+
+  GL_GNULIB_RINT=0
+
+
+
+  GL_GNULIB_RINTF=0
+
+
+
+  GL_GNULIB_RINTL=0
+
+
+
+  GL_GNULIB_ROUND=0
+
+
+
+  GL_GNULIB_ROUNDF=0
+
+
+
+  GL_GNULIB_ROUNDL=0
+
+
+
+  GL_GNULIB_SIGNBIT=0
+
+
+
+  GL_GNULIB_SINF=0
+
+
+
+  GL_GNULIB_SINL=0
+
+
+
+  GL_GNULIB_SINHF=0
+
+
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_SNPRINTF $ac_have_decl
+  GL_GNULIB_SQRTF=0
+
+
+
+  GL_GNULIB_SQRTL=0
+
+
+
+  GL_GNULIB_TANF=0
+
+
+
+  GL_GNULIB_TANL=0
+
+
+
+  GL_GNULIB_TANHF=0
+
+
+
+  GL_GNULIB_TRUNC=0
+
+
+
+  GL_GNULIB_TRUNCF=0
+
+
+
+  GL_GNULIB_TRUNCL=0
+
+
+
+  GL_GNULIB_MDA_J0=1
+
+
+
+  GL_GNULIB_MDA_J1=1
+
+
+
+  GL_GNULIB_MDA_JN=1
+
+
+
+  GL_GNULIB_MDA_Y0=1
+
+
+
+  GL_GNULIB_MDA_Y1=1
+
+
+
+  GL_GNULIB_MDA_YN=1
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_limits_h='<'limits.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <limits.h>" >&5
+printf %s "checking absolute name of <limits.h>... " >&6; }
+if test ${gl_cv_next_limits_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_limits_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <limits.h>
 _ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
 
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'limits.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
 
-    REPLACE_NULL=0;
-  HAVE_MAX_ALIGN_T=1;
-  HAVE_WCHAR_T=1;
+        gl_cv_absolute_limits_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
 
+          gl_header=$gl_cv_absolute_limits_h
+          gl_cv_next_limits_h='"'$gl_header'"'
+          else
+               gl_cv_next_limits_h='<'limits.h'>'
+             fi
 
 
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_limits_h" >&5
+printf "%s\n" "$gl_cv_next_limits_h" >&6; }
+     fi
+     NEXT_LIMITS_H=$gl_cv_next_limits_h
 
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'limits.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_limits_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_LIMITS_H=$gl_next_as_first_directive
 
 
 
 
 
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether limits.h has WORD_BIT, BOOL_WIDTH etc." >&5
+printf %s "checking whether limits.h has WORD_BIT, BOOL_WIDTH etc.... " >&6; }
+if test ${gl_cv_header_limits_width+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#ifndef __STDC_WANT_IEC_60559_BFP_EXT__
+             #define __STDC_WANT_IEC_60559_BFP_EXT__ 1
+            #endif
+            #include <limits.h>
+            long long llm = LLONG_MAX;
+            int wb = WORD_BIT;
+            int ullw = ULLONG_WIDTH;
+            int bw = BOOL_WIDTH;
 
+int
+main (void)
+{
 
-  if test $ac_cv_type_long_long_int = yes; then
-    HAVE_LONG_LONG_INT=1
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_header_limits_width=yes
+else $as_nop
+  gl_cv_header_limits_width=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_limits_width" >&5
+printf "%s\n" "$gl_cv_header_limits_width" >&6; }
+  if test "$gl_cv_header_limits_width" = yes; then
+    GL_GENERATE_LIMITS_H=false
   else
-    HAVE_LONG_LONG_INT=0
+    GL_GENERATE_LIMITS_H=true
   fi
 
 
-  if test $ac_cv_type_unsigned_long_long_int = yes; then
-    HAVE_UNSIGNED_LONG_LONG_INT=1
-  else
-    HAVE_UNSIGNED_LONG_LONG_INT=0
-  fi
+
+
+
+
+
+printf "%s\n" "#define HAVE_LONG_LONG_INT 1" >>confdefs.h
+
+
+printf "%s\n" "#define HAVE_UNSIGNED_LONG_LONG_INT 1" >>confdefs.h
 
 
 
@@ -12132,14 +13766,16 @@
   fi
 
 
-      if test $ac_cv_header_inttypes_h = yes; then
+
+  if test $ac_cv_header_inttypes_h = yes; then
     HAVE_INTTYPES_H=1
   else
     HAVE_INTTYPES_H=0
   fi
 
 
-      if test $ac_cv_header_sys_types_h = yes; then
+
+  if test $ac_cv_header_sys_types_h = yes; then
     HAVE_SYS_TYPES_H=1
   else
     HAVE_SYS_TYPES_H=0
@@ -12158,11 +13794,12 @@
      if test $gl_cv_have_include_next = yes; then
        gl_cv_next_stdint_h='<'stdint.h'>'
      else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <stdint.h>" >&5
-$as_echo_n "checking absolute name of <stdint.h>... " >&6; }
-if ${gl_cv_next_stdint_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <stdint.h>" >&5
+printf %s "checking absolute name of <stdint.h>... " >&6; }
+if test ${gl_cv_next_stdint_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
              if test $ac_cv_header_stdint_h = yes; then
 
@@ -12199,16 +13836,16 @@
         gl_cv_absolute_stdint_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
   sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_stdint_h
-           gl_cv_next_stdint_h='"'$gl_header'"'
+          gl_header=$gl_cv_absolute_stdint_h
+          gl_cv_next_stdint_h='"'$gl_header'"'
           else
                gl_cv_next_stdint_h='<'stdint.h'>'
              fi
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stdint_h" >&5
-$as_echo "$gl_cv_next_stdint_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stdint_h" >&5
+printf "%s\n" "$gl_cv_next_stdint_h" >&6; }
      fi
      NEXT_STDINT_H=$gl_cv_next_stdint_h
 
@@ -12232,11 +13869,12 @@
 
 
     if test $ac_cv_header_stdint_h = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether stdint.h conforms to C99" >&5
-$as_echo_n "checking whether stdint.h conforms to C99... " >&6; }
-if ${gl_cv_header_working_stdint_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether stdint.h conforms to C99" >&5
+printf %s "checking whether stdint.h conforms to C99... " >&6; }
+if test ${gl_cv_header_working_stdint_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   gl_cv_header_working_stdint_h=no
        cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -12252,13 +13890,9 @@
 #endif
 
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
@@ -12338,7 +13972,7 @@
 /* Check that SIZE_MAX has the correct type, if possible.  */
 #if 201112 <= __STDC_VERSION__
 int k = _Generic (SIZE_MAX, size_t: 0);
-#elif (2 <= __GNUC__ || defined __IBM__TYPEOF__ \
+#elif (2 <= __GNUC__ || 4 <= __clang_major__ || defined __IBM__TYPEOF__ \
        || (0x5110 <= __SUNPRO_C && !__STDC__))
 extern size_t k;
 extern __typeof__ (SIZE_MAX) k;
@@ -12356,7 +13990,7 @@
       PTRDIFF_MIN == TYPE_MINIMUM (ptrdiff_t)
       && PTRDIFF_MAX == TYPE_MAXIMUM (ptrdiff_t)
       ? 1 : -1;
-  /* Detect bug in FreeBSD 6.0 / ia64.  */
+  /* Detect bug in FreeBSD 6.0/ia64 and FreeBSD 13.0/arm64.  */
   int check_SIG_ATOMIC:
       SIG_ATOMIC_MIN == TYPE_MINIMUM (sig_atomic_t)
       && SIG_ATOMIC_MAX == TYPE_MAXIMUM (sig_atomic_t)
@@ -12405,15 +14039,17 @@
 };
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-                                                    if test "$cross_compiling" = yes; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
+                                                    if test "$cross_compiling" = yes
+then :
   case "$host_os" in
                          # Guess yes on native Windows.
                  mingw*) gl_cv_header_working_stdint_h="guessing yes" ;;
@@ -12421,7 +14057,7 @@
                  *)      gl_cv_header_working_stdint_h="guessing yes" ;;
                esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -12432,13 +14068,9 @@
 #include <stdint.h>
 
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
@@ -12477,7 +14109,7 @@
   };
 
 int
-main ()
+main (void)
 {
 
   const char **mv;
@@ -12499,7 +14131,8 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_header_working_stdint_h=yes
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -12508,26 +14141,27 @@
 
 
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_working_stdint_h" >&5
-$as_echo "$gl_cv_header_working_stdint_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_working_stdint_h" >&5
+printf "%s\n" "$gl_cv_header_working_stdint_h" >&6; }
   fi
 
   HAVE_C99_STDINT_H=0
   HAVE_SYS_BITYPES_H=0
   HAVE_SYS_INTTYPES_H=0
-  STDINT_H=stdint.h
+  GL_GENERATE_STDINT_H=true
   case "$gl_cv_header_working_stdint_h" in
     *yes)
       HAVE_C99_STDINT_H=1
-                  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether stdint.h predates C++11" >&5
-$as_echo_n "checking whether stdint.h predates C++11... " >&6; }
-if ${gl_cv_header_stdint_predates_cxx11_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  gl_cv_header_stdint_predates_cxx11_h=yes
+                        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether stdint.h works without ISO C predefines" >&5
+printf %s "checking whether stdint.h works without ISO C predefines... " >&6; }
+if test ${gl_cv_header_stdint_without_STDC_macros+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  gl_cv_header_stdint_without_STDC_macros=no
          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -12536,13 +14170,9 @@
 #include <stdint.h>
 
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
@@ -12551,34 +14181,37 @@
 int32_t i32 = INT32_C (0x7fffffff);
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_header_stdint_predates_cxx11_h=no
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_header_stdint_without_STDC_macros=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_predates_cxx11_h" >&5
-$as_echo "$gl_cv_header_stdint_predates_cxx11_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_without_STDC_macros" >&5
+printf "%s\n" "$gl_cv_header_stdint_without_STDC_macros" >&6; }
 
-      if test "$gl_cv_header_stdint_predates_cxx11_h" = yes; then
+      if test $gl_cv_header_stdint_without_STDC_macros = no; then
 
-$as_echo "#define __STDC_CONSTANT_MACROS 1" >>confdefs.h
+printf "%s\n" "#define __STDC_CONSTANT_MACROS 1" >>confdefs.h
 
 
-$as_echo "#define __STDC_LIMIT_MACROS 1" >>confdefs.h
+printf "%s\n" "#define __STDC_LIMIT_MACROS 1" >>confdefs.h
 
       fi
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether stdint.h has UINTMAX_WIDTH etc." >&5
-$as_echo_n "checking whether stdint.h has UINTMAX_WIDTH etc.... " >&6; }
-if ${gl_cv_header_stdint_width+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether stdint.h has UINTMAX_WIDTH etc." >&5
+printf %s "checking whether stdint.h has UINTMAX_WIDTH etc.... " >&6; }
+if test ${gl_cv_header_stdint_width+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   gl_cv_header_stdint_width=no
          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -12590,50 +14223,47 @@
               #endif
               #include <stdint.h>
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
               int iw = UINTMAX_WIDTH;
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_header_stdint_width=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_width" >&5
-$as_echo "$gl_cv_header_stdint_width" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_stdint_width" >&5
+printf "%s\n" "$gl_cv_header_stdint_width" >&6; }
       if test "$gl_cv_header_stdint_width" = yes; then
-        STDINT_H=
+        GL_GENERATE_STDINT_H=false
       fi
       ;;
     *)
-                  for ac_header in sys/inttypes.h sys/bitypes.h
-do :
-  as_ac_Header=`$as_echo "ac_cv_header_$ac_header" | $as_tr_sh`
-ac_fn_c_check_header_mongrel "$LINENO" "$ac_header" "$as_ac_Header" "$ac_includes_default"
-if eval test \"x\$"$as_ac_Header"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_header" | $as_tr_cpp` 1
-_ACEOF
+                  ac_fn_c_check_header_compile "$LINENO" "sys/inttypes.h" "ac_cv_header_sys_inttypes_h" "$ac_includes_default"
+if test "x$ac_cv_header_sys_inttypes_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_SYS_INTTYPES_H 1" >>confdefs.h
 
 fi
+ac_fn_c_check_header_compile "$LINENO" "sys/bitypes.h" "ac_cv_header_sys_bitypes_h" "$ac_includes_default"
+if test "x$ac_cv_header_sys_bitypes_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_SYS_BITYPES_H 1" >>confdefs.h
 
-done
+fi
 
       if test $ac_cv_header_sys_inttypes_h = yes; then
         HAVE_SYS_INTTYPES_H=1
@@ -12647,25 +14277,23 @@
 
 
   for gltype in ptrdiff_t size_t ; do
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for bit size of $gltype" >&5
-$as_echo_n "checking for bit size of $gltype... " >&6; }
-if eval \${gl_cv_bitsizeof_${gltype}+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for bit size of $gltype" >&5
+printf %s "checking for bit size of $gltype... " >&6; }
+if eval test \${gl_cv_bitsizeof_${gltype}+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if ac_fn_c_compute_int "$LINENO" "sizeof ($gltype) * CHAR_BIT" "result"        "
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
-#include <limits.h>"; then :
+#include <limits.h>"
+then :
 
-else
+else $as_nop
   result=unknown
 fi
 
@@ -12673,16 +14301,14 @@
 
 fi
 eval ac_res=\$gl_cv_bitsizeof_${gltype}
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
     eval result=\$gl_cv_bitsizeof_${gltype}
     if test $result = unknown; then
                                                 result=0
     fi
     GLTYPE=`echo "$gltype" | tr 'abcdefghijklmnopqrstuvwxyz ' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`
-    cat >>confdefs.h <<_ACEOF
-#define BITSIZEOF_${GLTYPE} $result
-_ACEOF
+    printf "%s\n" "#define BITSIZEOF_${GLTYPE} $result" >>confdefs.h
 
     eval BITSIZEOF_${GLTYPE}=\$result
   done
@@ -12692,25 +14318,23 @@
 
 
   for gltype in sig_atomic_t wchar_t wint_t ; do
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for bit size of $gltype" >&5
-$as_echo_n "checking for bit size of $gltype... " >&6; }
-if eval \${gl_cv_bitsizeof_${gltype}+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for bit size of $gltype" >&5
+printf %s "checking for bit size of $gltype... " >&6; }
+if eval test \${gl_cv_bitsizeof_${gltype}+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if ac_fn_c_compute_int "$LINENO" "sizeof ($gltype) * CHAR_BIT" "result"        "
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
-#include <limits.h>"; then :
+#include <limits.h>"
+then :
 
-else
+else $as_nop
   result=unknown
 fi
 
@@ -12718,16 +14342,14 @@
 
 fi
 eval ac_res=\$gl_cv_bitsizeof_${gltype}
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
     eval result=\$gl_cv_bitsizeof_${gltype}
     if test $result = unknown; then
                                                 result=0
     fi
     GLTYPE=`echo "$gltype" | tr 'abcdefghijklmnopqrstuvwxyz ' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`
-    cat >>confdefs.h <<_ACEOF
-#define BITSIZEOF_${GLTYPE} $result
-_ACEOF
+    printf "%s\n" "#define BITSIZEOF_${GLTYPE} $result" >>confdefs.h
 
     eval BITSIZEOF_${GLTYPE}=\$result
   done
@@ -12736,51 +14358,47 @@
 
 
   for gltype in sig_atomic_t wchar_t wint_t ; do
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether $gltype is signed" >&5
-$as_echo_n "checking whether $gltype is signed... " >&6; }
-if eval \${gl_cv_type_${gltype}_signed+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether $gltype is signed" >&5
+printf %s "checking whether $gltype is signed... " >&6; }
+if eval test \${gl_cv_type_${gltype}_signed+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
             int verify2 * (($gltype) -1 < ($gltype) 0) - 1;
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   result=yes
-else
+else $as_nop
   result=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
        eval gl_cv_type_${gltype}_signed=\$result
 
 fi
 eval ac_res=\$gl_cv_type_${gltype}_signed
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
     eval result=\$gl_cv_type_${gltype}_signed
     GLTYPE=`echo $gltype | tr 'abcdefghijklmnopqrstuvwxyz ' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`
     if test "$result" = yes; then
-      cat >>confdefs.h <<_ACEOF
-#define HAVE_SIGNED_${GLTYPE} 1
-_ACEOF
+      printf "%s\n" "#define HAVE_SIGNED_${GLTYPE} 1" >>confdefs.h
 
       eval HAVE_SIGNED_${GLTYPE}=1
     else
@@ -12795,11 +14413,12 @@
 
 
   for gltype in ptrdiff_t size_t ; do
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $gltype integer literal suffix" >&5
-$as_echo_n "checking for $gltype integer literal suffix... " >&6; }
-if eval \${gl_cv_type_${gltype}_suffix+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $gltype integer literal suffix" >&5
+printf %s "checking for $gltype integer literal suffix... " >&6; }
+if eval test \${gl_cv_type_${gltype}_suffix+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   eval gl_cv_type_${gltype}_suffix=no
        eval result=\$gl_cv_type_${gltype}_signed
        if test "$result" = yes; then
@@ -12821,44 +14440,39 @@
          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
               extern $gltype foo;
               extern $gltype1 foo;
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   eval gl_cv_type_${gltype}_suffix=\$glsuf
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
          eval result=\$gl_cv_type_${gltype}_suffix
          test "$result" != no && break
        done
 fi
 eval ac_res=\$gl_cv_type_${gltype}_suffix
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
     GLTYPE=`echo $gltype | tr 'abcdefghijklmnopqrstuvwxyz ' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`
     eval result=\$gl_cv_type_${gltype}_suffix
     test "$result" = no && result=
     eval ${GLTYPE}_SUFFIX=\$result
-    cat >>confdefs.h <<_ACEOF
-#define ${GLTYPE}_SUFFIX $result
-_ACEOF
+    printf "%s\n" "#define ${GLTYPE}_SUFFIX $result" >>confdefs.h
 
   done
 
@@ -12867,11 +14481,12 @@
 
 
   for gltype in sig_atomic_t wchar_t wint_t ; do
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for $gltype integer literal suffix" >&5
-$as_echo_n "checking for $gltype integer literal suffix... " >&6; }
-if eval \${gl_cv_type_${gltype}_suffix+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $gltype integer literal suffix" >&5
+printf %s "checking for $gltype integer literal suffix... " >&6; }
+if eval test \${gl_cv_type_${gltype}_suffix+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   eval gl_cv_type_${gltype}_suffix=no
        eval result=\$gl_cv_type_${gltype}_signed
        if test "$result" = yes; then
@@ -12893,50 +14508,45 @@
          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 
               extern $gltype foo;
               extern $gltype1 foo;
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   eval gl_cv_type_${gltype}_suffix=\$glsuf
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
          eval result=\$gl_cv_type_${gltype}_suffix
          test "$result" != no && break
        done
 fi
 eval ac_res=\$gl_cv_type_${gltype}_suffix
-	       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
-$as_echo "$ac_res" >&6; }
+	       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_res" >&5
+printf "%s\n" "$ac_res" >&6; }
     GLTYPE=`echo $gltype | tr 'abcdefghijklmnopqrstuvwxyz ' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`
     eval result=\$gl_cv_type_${gltype}_suffix
     test "$result" = no && result=
     eval ${GLTYPE}_SUFFIX=\$result
-    cat >>confdefs.h <<_ACEOF
-#define ${GLTYPE}_SUFFIX $result
-_ACEOF
+    printf "%s\n" "#define ${GLTYPE}_SUFFIX $result" >>confdefs.h
 
   done
 
 
 
-          if test $GNULIB_OVERRIDES_WINT_T = 1; then
+          if test $GNULIBHEADERS_OVERRIDE_WINT_T = 1; then
     BITSIZEOF_WINT_T=32
   fi
 
@@ -12945,75 +14555,78 @@
 
 
 
-  LIMITS_H='limits.h'
-   if test -n "$LIMITS_H"; then
-  GL_GENERATE_LIMITS_H_TRUE=
-  GL_GENERATE_LIMITS_H_FALSE='#'
-else
-  GL_GENERATE_LIMITS_H_TRUE='#'
-  GL_GENERATE_LIMITS_H_FALSE=
-fi
-
+  GL_GENERATE_LIMITS_H=true
 
 
 
 
 
 
-   if test -n "$STDINT_H"; then
-  GL_GENERATE_STDINT_H_TRUE=
-  GL_GENERATE_STDINT_H_FALSE='#'
-else
-  GL_GENERATE_STDINT_H_TRUE='#'
-  GL_GENERATE_STDINT_H_FALSE=
-fi
 
+    HAVE_DECL_IMAXABS=1;
+  HAVE_DECL_IMAXDIV=1;
+  HAVE_DECL_STRTOIMAX=1;
+  HAVE_DECL_STRTOUMAX=1;
+  HAVE_IMAXDIV_T=1;
+  HAVE_IMAXABS=1;
+  HAVE_IMAXDIV=1;
+  REPLACE_IMAXABS=0;
+  REPLACE_IMAXDIV=0;
+  REPLACE_STRTOIMAX=0;
+  REPLACE_STRTOUMAX=0;
+  INT32_MAX_LT_INTMAX_MAX=1;
+  INT64_MAX_EQ_LONG_MAX='defined _LP64';
+  PRIPTR_PREFIX=__PRIPTR_PREFIX;
+  UINT32_MAX_LT_UINTMAX_MAX=1;
+  UINT64_MAX_EQ_ULONG_MAX='defined _LP64';
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for C/C++ restrict keyword" >&5
-$as_echo_n "checking for C/C++ restrict keyword... " >&6; }
-if ${ac_cv_c_restrict+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C/C++ restrict keyword" >&5
+printf %s "checking for C/C++ restrict keyword... " >&6; }
+if test ${ac_cv_c_restrict+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_c_restrict=no
-   # The order here caters to the fact that C++ does not require restrict.
-   for ac_kw in __restrict __restrict__ _Restrict restrict; do
+   # Put '__restrict__' first, to avoid problems with glibc and non-GCC; see:
+   # https://lists.gnu.org/archive/html/bug-autoconf/2016-02/msg00006.html
+   # Put 'restrict' last, because C++ lacks it.
+   for ac_kw in __restrict__ __restrict _Restrict restrict; do
      cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 typedef int *int_ptr;
-           int foo (int_ptr $ac_kw ip) { return ip0; }
-           int bar (int $ac_kw); /* Catch GCC bug 14050.  */
-           int bar (int ip$ac_kw) { return ip0; }
+	   int foo (int_ptr $ac_kw ip) { return ip0; }
+	   int bar (int $ac_kw); /* Catch GCC bug 14050.  */
+	   int bar (int ip$ac_kw) { return ip0; }
 
 int
-main ()
+main (void)
 {
 int s1;
-           int *$ac_kw t = s;
-           t0 = 0;
-           return foo (t) + bar (t);
+	   int *$ac_kw t = s;
+	   t0 = 0;
+	   return foo (t) + bar (t);
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_restrict=$ac_kw
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
      test "$ac_cv_c_restrict" != no && break
    done
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_restrict" >&5
-$as_echo "$ac_cv_c_restrict" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_restrict" >&5
+printf "%s\n" "$ac_cv_c_restrict" >&6; }
 
  case $ac_cv_c_restrict in
    restrict) ;;
-   no) $as_echo "#define restrict /**/" >>confdefs.h
+   no) printf "%s\n" "#define restrict /**/" >>confdefs.h
  ;;
-   *)  cat >>confdefs.h <<_ACEOF
-#define restrict $ac_cv_c_restrict
-_ACEOF
+   *)  printf "%s\n" "#define restrict $ac_cv_c_restrict" >>confdefs.h
  ;;
  esac
 
@@ -13028,14 +14641,1615 @@
 
 
 
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_inttypes_h='<'inttypes.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <inttypes.h>" >&5
+printf %s "checking absolute name of <inttypes.h>... " >&6; }
+if test ${gl_cv_next_inttypes_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_inttypes_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <inttypes.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'inttypes.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_inttypes_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_inttypes_h
+          gl_cv_next_inttypes_h='"'$gl_header'"'
+          else
+               gl_cv_next_inttypes_h='<'inttypes.h'>'
+             fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_inttypes_h" >&5
+printf "%s\n" "$gl_cv_next_inttypes_h" >&6; }
+     fi
+     NEXT_INTTYPES_H=$gl_cv_next_inttypes_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'inttypes.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_inttypes_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_INTTYPES_H=$gl_next_as_first_directive
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+  GL_GNULIB_IMAXABS=0
+
+
+
+  GL_GNULIB_IMAXDIV=0
+
+
+
+  GL_GNULIB_STRTOIMAX=0
+
+
+
+  GL_GNULIB_STRTOUMAX=0
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'float'" >&5
+printf %s "checking where to find the exponent in a 'float'... " >&6; }
+if test ${gl_cv_cc_float_expbit0+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+      if test "$cross_compiling" = yes
+then :
+  gl_cv_cc_float_expbit0="word 0 bit 23"
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <float.h>
+#include <stddef.h>
+#include <stdio.h>
+#include <string.h>
+#define NWORDS \
+  ((sizeof (float) + sizeof (unsigned int) - 1) / sizeof (unsigned int))
+typedef union { float value; unsigned int wordNWORDS; } memory_float;
+static unsigned int ored_wordsNWORDS;
+static unsigned int anded_wordsNWORDS;
+static void add_to_ored_words (float x)
+{
+  memory_float m;
+  size_t i;
+  /* Clear it first, in case
+     sizeof (float) < sizeof (memory_float).  */
+  memset (&m, 0, sizeof (memory_float));
+  m.value = x;
+  for (i = 0; i < NWORDS; i++)
+    {
+      ored_wordsi |= m.wordi;
+      anded_wordsi &= m.wordi;
+    }
+}
+int main ()
+{
+  size_t j;
+  FILE *fp = fopen ("conftest.out", "w");
+  if (fp == NULL)
+    return 1;
+  for (j = 0; j < NWORDS; j++)
+    anded_wordsj = ~ (unsigned int) 0;
+  add_to_ored_words (0.25f);
+  add_to_ored_words (0.5f);
+  add_to_ored_words (1.0f);
+  add_to_ored_words (2.0f);
+  add_to_ored_words (4.0f);
+  /* Remove bits that are common (e.g. if representation of the first mantissa
+     bit is explicit).  */
+  for (j = 0; j < NWORDS; j++)
+    ored_wordsj &= ~anded_wordsj;
+  /* Now find the nonzero word.  */
+  for (j = 0; j < NWORDS; j++)
+    if (ored_wordsj != 0)
+      break;
+  if (j < NWORDS)
+    {
+      size_t i;
+      for (i = j + 1; i < NWORDS; i++)
+        if (ored_wordsi != 0)
+          {
+            fprintf (fp, "unknown");
+            return (fclose (fp) != 0);
+          }
+      for (i = 0; ; i++)
+        if ((ored_wordsj >> i) & 1)
+          {
+            fprintf (fp, "word %d bit %d", (int) j, (int) i);
+            return (fclose (fp) != 0);
+          }
+    }
+  fprintf (fp, "unknown");
+  return (fclose (fp) != 0);
+}
+
+_ACEOF
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_cc_float_expbit0=`cat conftest.out`
+else $as_nop
+  gl_cv_cc_float_expbit0="unknown"
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+      rm -f conftest.out
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_expbit0" >&5
+printf "%s\n" "$gl_cv_cc_float_expbit0" >&6; }
+  case "$gl_cv_cc_float_expbit0" in
+    word*bit*)
+      word=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word //' -e 's/ bit.*//'`
+      bit=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word.*bit //'`
+
+printf "%s\n" "#define FLT_EXPBIT0_WORD $word" >>confdefs.h
+
+
+printf "%s\n" "#define FLT_EXPBIT0_BIT $bit" >>confdefs.h
+
+      ;;
+  esac
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for nl_langinfo and CODESET" >&5
+printf %s "checking for nl_langinfo and CODESET... " >&6; }
+if test ${am_cv_langinfo_codeset+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <langinfo.h>
+int
+main (void)
+{
+char* cs = nl_langinfo(CODESET); return !cs;
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_link "$LINENO"
+then :
+  am_cv_langinfo_codeset=yes
+else $as_nop
+  am_cv_langinfo_codeset=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
+    conftest$ac_exeext conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_langinfo_codeset" >&5
+printf "%s\n" "$am_cv_langinfo_codeset" >&6; }
+  if test $am_cv_langinfo_codeset = yes; then
+
+printf "%s\n" "#define HAVE_LANGINFO_CODESET 1" >>confdefs.h
+
+  fi
+
+
+
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for working fcntl.h" >&5
+printf %s "checking for working fcntl.h... " >&6; }
+if test ${gl_cv_header_working_fcntl_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test "$cross_compiling" = yes
+then :
+  gl_cv_header_working_fcntl_h=cross-compiling
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <sys/types.h>
+           #include <sys/stat.h>
+           #if HAVE_UNISTD_H
+           # include <unistd.h>
+           #else /* on Windows with MSVC */
+           # include <io.h>
+           # include <stdlib.h>
+           # defined sleep(n) _sleep ((n) * 1000)
+           #endif
+           #include <fcntl.h>
+           #ifndef O_NOATIME
+            #define O_NOATIME 0
+           #endif
+           #ifndef O_NOFOLLOW
+            #define O_NOFOLLOW 0
+           #endif
+           static int const constants =
+            {
+              O_CREAT, O_EXCL, O_NOCTTY, O_TRUNC, O_APPEND,
+              O_NONBLOCK, O_SYNC, O_ACCMODE, O_RDONLY, O_RDWR, O_WRONLY
+            };
+
+int
+main (void)
+{
+
+            int result = !constants;
+            #if HAVE_SYMLINK
+            {
+              static char const sym = "conftest.sym";
+              if (symlink ("/dev/null", sym) != 0)
+                result |= 2;
+              else
+                {
+                  int fd = open (sym, O_WRONLY | O_NOFOLLOW | O_CREAT, 0);
+                  if (fd >= 0)
+                    {
+                      close (fd);
+                      result |= 4;
+                    }
+                }
+              if (unlink (sym) != 0 || symlink (".", sym) != 0)
+                result |= 2;
+              else
+                {
+                  int fd = open (sym, O_RDONLY | O_NOFOLLOW);
+                  if (fd >= 0)
+                    {
+                      close (fd);
+                      result |= 4;
+                    }
+                }
+              unlink (sym);
+            }
+            #endif
+            {
+              static char const file = "confdefs.h";
+              int fd = open (file, O_RDONLY | O_NOATIME);
+              if (fd < 0)
+                result |= 8;
+              else
+                {
+                  struct stat st0;
+                  if (fstat (fd, &st0) != 0)
+                    result |= 16;
+                  else
+                    {
+                      char c;
+                      sleep (1);
+                      if (read (fd, &c, 1) != 1)
+                        result |= 24;
+                      else
+                        {
+                          if (close (fd) != 0)
+                            result |= 32;
+                          else
+                            {
+                              struct stat st1;
+                              if (stat (file, &st1) != 0)
+                                result |= 40;
+                              else
+                                if (st0.st_atime != st1.st_atime)
+                                  result |= 64;
+                            }
+                        }
+                    }
+                }
+            }
+            return result;
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_header_working_fcntl_h=yes
+else $as_nop
+  case $? in #(
+        4) gl_cv_header_working_fcntl_h='no (bad O_NOFOLLOW)';; #(
+        64) gl_cv_header_working_fcntl_h='no (bad O_NOATIME)';; #(
+        68) gl_cv_header_working_fcntl_h='no (bad O_NOATIME, O_NOFOLLOW)';; #(
+         *) gl_cv_header_working_fcntl_h='no';;
+        esac
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_working_fcntl_h" >&5
+printf "%s\n" "$gl_cv_header_working_fcntl_h" >&6; }
+
+  case $gl_cv_header_working_fcntl_h in #(
+  *O_NOATIME* | no | cross-compiling) ac_val=0;; #(
+  *) ac_val=1;;
+  esac
+
+printf "%s\n" "#define HAVE_WORKING_O_NOATIME $ac_val" >>confdefs.h
+
+
+  case $gl_cv_header_working_fcntl_h in #(
+  *O_NOFOLLOW* | no | cross-compiling) ac_val=0;; #(
+  *) ac_val=1;;
+  esac
+
+printf "%s\n" "#define HAVE_WORKING_O_NOFOLLOW $ac_val" >>confdefs.h
+
+
+ac_fn_check_decl "$LINENO" "getc_unlocked" "ac_cv_have_decl_getc_unlocked" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_getc_unlocked" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_GETC_UNLOCKED $ac_have_decl" >>confdefs.h
+
+
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C Library >= 2.1 or uClibc" >&5
+printf %s "checking whether we are using the GNU C Library >= 2.1 or uClibc... " >&6; }
+if test ${ac_cv_gnu_library_2_1+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <features.h>
+#ifdef __GNU_LIBRARY__
+ #if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 1) || (__GLIBC__ > 2)
+  Lucky GNU user
+ #endif
+#endif
+#ifdef __UCLIBC__
+ Lucky user
+#endif
+
+_ACEOF
+if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
+  $EGREP "Lucky" >/dev/null 2>&1
+then :
+  ac_cv_gnu_library_2_1=yes
+else $as_nop
+  ac_cv_gnu_library_2_1=no
+fi
+rm -rf conftest*
+
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_gnu_library_2_1" >&5
+printf "%s\n" "$ac_cv_gnu_library_2_1" >&6; }
+
+    GLIBC21="$ac_cv_gnu_library_2_1"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_math_h='<'math.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <math.h>" >&5
+printf %s "checking absolute name of <math.h>... " >&6; }
+if test ${gl_cv_next_math_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_math_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <math.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'math.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_math_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_math_h
+          gl_cv_next_math_h='"'$gl_header'"'
+          else
+               gl_cv_next_math_h='<'math.h'>'
+             fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_math_h" >&5
+printf "%s\n" "$gl_cv_next_math_h" >&6; }
+     fi
+     NEXT_MATH_H=$gl_cv_next_math_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'math.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_math_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_MATH_H=$gl_next_as_first_directive
+
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether NAN macro works" >&5
+printf %s "checking whether NAN macro works... " >&6; }
+if test ${gl_cv_header_math_nan_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <math.h>
+int
+main (void)
+{
+/* Solaris 10 has a broken definition of NAN.  Other platforms
+        fail to provide NAN, or provide it only in C99 mode; this
+        test only needs to fail when NAN is provided but wrong.  */
+         float f = 1.0f;
+#ifdef NAN
+         f = NAN;
+#endif
+         return f == 0;
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_header_math_nan_works=yes
+else $as_nop
+  gl_cv_header_math_nan_works=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_math_nan_works" >&5
+printf "%s\n" "$gl_cv_header_math_nan_works" >&6; }
+  if test $gl_cv_header_math_nan_works = no; then
+    REPLACE_NAN=1
+  fi
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether HUGE_VAL works" >&5
+printf %s "checking whether HUGE_VAL works... " >&6; }
+if test ${gl_cv_header_math_huge_val_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <math.h>
+int
+main (void)
+{
+/* Solaris 10 has a broken definition of HUGE_VAL.  */
+         double d = HUGE_VAL;
+         return d == 0;
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_header_math_huge_val_works=yes
+else $as_nop
+  gl_cv_header_math_huge_val_works=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_math_huge_val_works" >&5
+printf "%s\n" "$gl_cv_header_math_huge_val_works" >&6; }
+  if test $gl_cv_header_math_huge_val_works = no; then
+    REPLACE_HUGE_VAL=1
+  fi
+
+
+
+
+
+
+
+
+  # Check for mmap(). Don't use AC_FUNC_MMAP, because it checks too much: it
+  # fails on HP-UX 11, because MAP_FIXED mappings do not work. But this is
+  # irrelevant for anonymous mappings.
+  ac_fn_c_check_func "$LINENO" "mmap" "ac_cv_func_mmap"
+if test "x$ac_cv_func_mmap" = xyes
+then :
+  gl_have_mmap=yes
+else $as_nop
+  gl_have_mmap=no
+fi
+
+
+  # Try to allow MAP_ANONYMOUS.
+  gl_have_mmap_anonymous=no
+  if test $gl_have_mmap = yes; then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for MAP_ANONYMOUS" >&5
+printf %s "checking for MAP_ANONYMOUS... " >&6; }
+    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <sys/mman.h>
+#ifdef MAP_ANONYMOUS
+    I cannot identify this map
+#endif
+
+_ACEOF
+if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
+  $EGREP "I cannot identify this map" >/dev/null 2>&1
+then :
+  gl_have_mmap_anonymous=yes
+fi
+rm -rf conftest*
+
+    if test $gl_have_mmap_anonymous != yes; then
+      cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <sys/mman.h>
+#ifdef MAP_ANON
+    I cannot identify this map
+#endif
+
+_ACEOF
+if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
+  $EGREP "I cannot identify this map" >/dev/null 2>&1
+then :
+
+printf "%s\n" "#define MAP_ANONYMOUS MAP_ANON" >>confdefs.h
+
+         gl_have_mmap_anonymous=yes
+fi
+rm -rf conftest*
+
+    fi
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_have_mmap_anonymous" >&5
+printf "%s\n" "$gl_have_mmap_anonymous" >&6; }
+    if test $gl_have_mmap_anonymous = yes; then
+
+printf "%s\n" "#define HAVE_MAP_ANONYMOUS 1" >>confdefs.h
+
+    fi
+  fi
+
+
+
+
+  HAVE_MBSLEN=0;
+    HAVE_EXPLICIT_BZERO=1;
+  HAVE_FFSL=1;
+  HAVE_FFSLL=1;
+  HAVE_DECL_MEMMEM=1;
+  HAVE_MEMPCPY=1;
+  HAVE_MEMSET_EXPLICIT=1;
+  HAVE_DECL_MEMRCHR=1;
+  HAVE_RAWMEMCHR=1;
+  HAVE_STPCPY=1;
+  HAVE_STPNCPY=1;
+  HAVE_STRCHRNUL=1;
+  HAVE_DECL_STRDUP=1;
+  HAVE_DECL_STRNDUP=1;
+  HAVE_DECL_STRNLEN=1;
+  HAVE_STRPBRK=1;
+  HAVE_STRSEP=1;
+  HAVE_STRCASESTR=1;
+  HAVE_DECL_STRTOK_R=1;
+  HAVE_DECL_STRERROR_R=1;
+  HAVE_STRERRORNAME_NP=1;
+  HAVE_SIGABBREV_NP=1;
+  HAVE_SIGDESCR_NP=1;
+  HAVE_DECL_STRSIGNAL=1;
+  HAVE_STRVERSCMP=1;
+  REPLACE_FFSLL=0;
+  REPLACE_MEMCHR=0;
+  REPLACE_MEMMEM=0;
+  REPLACE_MEMPCPY=0;
+  REPLACE_STPCPY=0;
+  REPLACE_STPNCPY=0;
+  REPLACE_STRCHRNUL=0;
+  REPLACE_STRDUP=0;
+  REPLACE_STRNCAT=0;
+  REPLACE_STRNDUP=0;
+  REPLACE_STRNLEN=0;
+  REPLACE_STRSTR=0;
+  REPLACE_STRCASESTR=0;
+  REPLACE_STRTOK_R=0;
+  REPLACE_STRERROR=0;
+  REPLACE_STRERROR_R=0;
+  REPLACE_STRERRORNAME_NP=0;
+  REPLACE_STRSIGNAL=0;
+  UNDEFINE_STRTOK_R=0;
+
+
+
+
+
+
+
+
+  # Detect platform-specific bugs in some versions of glibc:
+  # memchr should not dereference anything with length 0
+  #   https://bugzilla.redhat.com/show_bug.cgi?id=499689
+  # memchr should not dereference overestimated length after a match
+  #   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=521737
+  #   https://sourceware.org/bugzilla/show_bug.cgi?id=10162
+  # memchr should cast the second argument to 'unsigned char'.
+  #   This bug exists in Android 4.3.
+  # Assume that memchr works on platforms that lack mprotect.
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether memchr works" >&5
+printf %s "checking whether memchr works... " >&6; }
+if test ${gl_cv_func_memchr_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test "$cross_compiling" = yes
+then :
+  case "$host_os" in
+                           # Guess no on Android.
+          linux*-android*) gl_cv_func_memchr_works="guessing no" ;;
+                           # Guess yes on native Windows.
+          mingw*)          gl_cv_func_memchr_works="guessing yes" ;;
+                           # If we don't know, obey --enable-cross-guesses.
+          *)               gl_cv_func_memchr_works="$gl_cross_guess_normal" ;;
+        esac
+
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <string.h>
+#if HAVE_SYS_MMAN_H
+# include <fcntl.h>
+# include <unistd.h>
+# include <sys/types.h>
+# include <sys/mman.h>
+# ifndef MAP_FILE
+#  define MAP_FILE 0
+# endif
+#endif
+
+int
+main (void)
+{
+
+  int result = 0;
+  char *fence = NULL;
+#if HAVE_SYS_MMAN_H && HAVE_MPROTECT
+# if HAVE_MAP_ANONYMOUS
+  const int flags = MAP_ANONYMOUS | MAP_PRIVATE;
+  const int fd = -1;
+# else /* !HAVE_MAP_ANONYMOUS */
+  const int flags = MAP_FILE | MAP_PRIVATE;
+  int fd = open ("/dev/zero", O_RDONLY, 0666);
+  if (fd >= 0)
+# endif
+    {
+      int pagesize = getpagesize ();
+      char *two_pages =
+        (char *) mmap (NULL, 2 * pagesize, PROT_READ | PROT_WRITE,
+                       flags, fd, 0);
+      if (two_pages != (char *)(-1)
+          && mprotect (two_pages + pagesize, pagesize, PROT_NONE) == 0)
+        fence = two_pages + pagesize;
+    }
+#endif
+  if (fence)
+    {
+      /* Test against bugs on glibc systems.  */
+      if (memchr (fence, 0, 0))
+        result |= 1;
+      strcpy (fence - 9, "12345678");
+      if (memchr (fence - 9, 0, 79) != fence - 1)
+        result |= 2;
+      if (memchr (fence - 1, 0, 3) != fence - 1)
+        result |= 4;
+      /* Test against bug on AIX 7.2.  */
+      if (memchr (fence - 4, '6', 16) != fence - 4)
+        result |= 8;
+    }
+  /* Test against bug on Android 4.3.  */
+  {
+    char input3;
+    input0 = 'a';
+    input1 = 'b';
+    input2 = 'c';
+    if (memchr (input, 0x789abc00 | 'b', 3) != input + 1)
+      result |= 16;
+  }
+  return result;
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_func_memchr_works=yes
+else $as_nop
+  gl_cv_func_memchr_works=no
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_memchr_works" >&5
+printf "%s\n" "$gl_cv_func_memchr_works" >&6; }
+  case "$gl_cv_func_memchr_works" in
+    *yes) ;;
+    *) REPLACE_MEMCHR=1 ;;
+  esac
+
+
+
+  GL_GNULIB_EXPLICIT_BZERO=0
+
+
+
+  GL_GNULIB_FFSL=0
+
+
+
+  GL_GNULIB_FFSLL=0
+
+
+
+  GL_GNULIB_MEMCHR=0
+
+
+
+  GL_GNULIB_MEMMEM=0
+
+
+
+  GL_GNULIB_MEMPCPY=0
+
+
+
+  GL_GNULIB_MEMRCHR=0
+
+
+
+  GL_GNULIB_MEMSET_EXPLICIT=0
+
+
+
+  GL_GNULIB_RAWMEMCHR=0
+
+
+
+  GL_GNULIB_STPCPY=0
+
+
+
+  GL_GNULIB_STPNCPY=0
+
+
+
+  GL_GNULIB_STRCHRNUL=0
+
+
+
+  GL_GNULIB_STRDUP=0
+
+
+
+  GL_GNULIB_STRNCAT=0
+
+
+
+  GL_GNULIB_STRNDUP=0
+
+
+
+  GL_GNULIB_STRNLEN=0
+
+
+
+  GL_GNULIB_STRPBRK=0
+
+
+
+  GL_GNULIB_STRSEP=0
+
+
+
+  GL_GNULIB_STRSTR=0
+
+
+
+  GL_GNULIB_STRCASESTR=0
+
+
+
+  GL_GNULIB_STRTOK_R=0
+
+
+
+  GL_GNULIB_MBSLEN=0
+
+
+
+  GL_GNULIB_MBSNLEN=0
+
+
+
+  GL_GNULIB_MBSCHR=0
+
+
+
+  GL_GNULIB_MBSRCHR=0
+
+
+
+  GL_GNULIB_MBSSTR=0
+
+
+
+  GL_GNULIB_MBSCASECMP=0
+
+
+
+  GL_GNULIB_MBSNCASECMP=0
+
+
+
+  GL_GNULIB_MBSPCASECMP=0
+
+
+
+  GL_GNULIB_MBSCASESTR=0
+
+
+
+  GL_GNULIB_MBSCSPN=0
+
+
+
+  GL_GNULIB_MBSPBRK=0
+
+
+
+  GL_GNULIB_MBSSPN=0
+
+
+
+  GL_GNULIB_MBSSEP=0
+
+
+
+  GL_GNULIB_MBSTOK_R=0
+
+
+
+  GL_GNULIB_STRERROR=0
+
+
+
+  GL_GNULIB_STRERROR_R=0
+
+
+
+  GL_GNULIB_STRERRORNAME_NP=0
+
+
+
+  GL_GNULIB_SIGABBREV_NP=0
+
+
+
+  GL_GNULIB_SIGDESCR_NP=0
+
+
+
+  GL_GNULIB_STRSIGNAL=0
+
+
+
+  GL_GNULIB_STRVERSCMP=0
+
+
+
+  GL_GNULIB_MDA_MEMCCPY=1
+
+
+
+  GL_GNULIB_MDA_STRDUP=1
+
+
+
+ac_fn_check_decl "$LINENO" "snprintf" "ac_cv_have_decl_snprintf" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_snprintf" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_SNPRINTF $ac_have_decl" >>confdefs.h
+
+ac_fn_c_check_type "$LINENO" "_Bool" "ac_cv_type__Bool" "$ac_includes_default"
+if test "x$ac_cv_type__Bool" = xyes
+then :
+
+printf "%s\n" "#define HAVE__BOOL 1" >>confdefs.h
+
+
+fi
+
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for stdbool.h that conforms to C99 or later" >&5
+printf %s "checking for stdbool.h that conforms to C99 or later... " >&6; }
+if test ${ac_cv_header_stdbool_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stdbool.h>
+
+             /* "true" and "false" should be usable in #if expressions and
+                integer constant expressions, and "bool" should be a valid
+                type name.
+
+                Although C99 requires bool, true, and false to be macros,
+                C23 and C++11 overrule that, so do not test for that.
+                Although C99 requires __bool_true_false_are_defined and
+                _Bool, C23 says they are obsolescent, so do not require
+                them.  */
+
+             #if !true
+               #error "'true' is not true"
+             #endif
+             #if true != 1
+               #error "'true' is not equal to 1"
+             #endif
+             char btrue == 1 ? 1 : -1;
+             char ctrue;
+
+             #if false
+               #error "'false' is not false"
+             #endif
+             #if false != 0
+               #error "'false' is not equal to 0"
+             #endif
+             char dfalse == 0 ? 1 : -1;
+
+             enum { e = false, f = true, g = false * true, h = true * 256 };
+
+             char i(bool) 0.5 == true ? 1 : -1;
+             char j(bool) 0.0 == false ? 1 : -1;
+             char ksizeof (bool) > 0 ? 1 : -1;
+
+             struct sb { bool s: 1; bool t; } s;
+             char lsizeof s.t > 0 ? 1 : -1;
+
+             /* The following fails for
+                HP aC++/ANSI C B3910B A.05.55 Dec 04 2003. */
+             bool mh;
+             char nsizeof m == h * sizeof m0 ? 1 : -1;
+             char o-1 - (bool) 0 < 0 ? 1 : -1;
+             /* Catch a bug in an HP-UX C compiler.  See
+                https://gcc.gnu.org/ml/gcc-patches/2003-12/msg02303.html
+                https://lists.gnu.org/r/bug-coreutils/2005-11/msg00161.html
+              */
+             bool p = true;
+             bool *pp = &p;
+
+int
+main (void)
+{
+
+             bool ps = &s;
+             *pp |= p;
+             *pp |= ! p;
+
+             /* Refer to every declared value, so they cannot be
+                discarded as unused.  */
+             return (!b + !c + !d + !e + !f + !g + !h + !i + !j + !k
+                     + !l + !m + !n + !o + !p + !pp + !ps);
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_cv_header_stdbool_h=yes
+else $as_nop
+  ac_cv_header_stdbool_h=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_header_stdbool_h" >&5
+printf "%s\n" "$ac_cv_header_stdbool_h" >&6; }
+
+
+    REPLACE_NULL=0;
+  HAVE_MAX_ALIGN_T=1;
+  HAVE_WCHAR_T=1;
+
+
+
+
+
+
+
+  GL_GENERATE_STDDEF_H=false
+
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for good max_align_t" >&5
+printf %s "checking for good max_align_t... " >&6; }
+if test ${gl_cv_type_max_align_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+/* On FreeBSD 12.0/x86, max_align_t defined by <stddef.h> has
+               the correct alignment with the default (wrong) definition of
+               _Alignof, but a wrong alignment as soon as we activate an
+               ISO C compliant _Alignof definition.  */
+            #if ((defined __GNUC__ && 4 <= __GNUC__) || defined __clang__) && !defined __cplusplus
+             #define _Alignof(type) __builtin_offsetof (struct { char __a; type __b; }, __b)
+            #endif
+            #include <stddef.h>
+            unsigned int s = sizeof (max_align_t);
+            #if defined __GNUC__ || defined __clang__ || defined __IBM__ALIGNOF__
+            int check12 * (__alignof__ (double) <= __alignof__ (max_align_t)) - 1;
+            int check22 * (__alignof__ (long double) <= __alignof__ (max_align_t)) - 1;
+            #endif
+            typedef struct { char a; max_align_t b; } max_helper;
+            typedef struct { char a; long b; } long_helper;
+            typedef struct { char a; double b; } double_helper;
+            typedef struct { char a; long double b; } long_double_helper;
+            int check32 * (offsetof (long_helper, b) <= offsetof (max_helper, b)) - 1;
+            int check42 * (offsetof (double_helper, b) <= offsetof (max_helper, b)) - 1;
+            int check52 * (offsetof (long_double_helper, b) <= offsetof (max_helper, b)) - 1;
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_type_max_align_t=yes
+else $as_nop
+  gl_cv_type_max_align_t=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_max_align_t" >&5
+printf "%s\n" "$gl_cv_type_max_align_t" >&6; }
+  if test $gl_cv_type_max_align_t = no; then
+    HAVE_MAX_ALIGN_T=0
+    GL_GENERATE_STDDEF_H=true
+  fi
+
+  if test $gt_cv_c_wchar_t = no; then
+    HAVE_WCHAR_T=0
+    GL_GENERATE_STDDEF_H=true
+  fi
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether NULL can be used in arbitrary expressions" >&5
+printf %s "checking whether NULL can be used in arbitrary expressions... " >&6; }
+if test ${gl_cv_decl_null_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stddef.h>
+      int test2 * (sizeof NULL == sizeof (void *)) -1;
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_decl_null_works=yes
+else $as_nop
+  gl_cv_decl_null_works=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_decl_null_works" >&5
+printf "%s\n" "$gl_cv_decl_null_works" >&6; }
+  if test $gl_cv_decl_null_works = no; then
+    REPLACE_NULL=1
+    GL_GENERATE_STDDEF_H=true
+  fi
+
+  if $GL_GENERATE_STDDEF_H; then
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_stddef_h='<'stddef.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <stddef.h>" >&5
+printf %s "checking absolute name of <stddef.h>... " >&6; }
+if test ${gl_cv_next_stddef_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stddef.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'stddef.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_stddef_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_stddef_h
+          gl_cv_next_stddef_h='"'$gl_header'"'
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stddef_h" >&5
+printf "%s\n" "$gl_cv_next_stddef_h" >&6; }
+     fi
+     NEXT_STDDEF_H=$gl_cv_next_stddef_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'stddef.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_stddef_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_STDDEF_H=$gl_next_as_first_directive
+
+
+
+
+  fi
+
+
+
+ac_fn_check_decl "$LINENO" "fcloseall" "ac_cv_have_decl_fcloseall" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_fcloseall" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_FCLOSEALL $ac_have_decl" >>confdefs.h
+
+ac_fn_check_decl "$LINENO" "getw" "ac_cv_have_decl_getw" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_getw" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_GETW $ac_have_decl" >>confdefs.h
+
+ac_fn_check_decl "$LINENO" "putw" "ac_cv_have_decl_putw" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_putw" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_PUTW $ac_have_decl" >>confdefs.h
+
+
+
+
+  printf "%s\n" "#define __USE_MINGW_ANSI_STDIO 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_stdio_h='<'stdio.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <stdio.h>" >&5
+printf %s "checking absolute name of <stdio.h>... " >&6; }
+if test ${gl_cv_next_stdio_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stdio.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'stdio.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_stdio_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_stdio_h
+          gl_cv_next_stdio_h='"'$gl_header'"'
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stdio_h" >&5
+printf "%s\n" "$gl_cv_next_stdio_h" >&6; }
+     fi
+     NEXT_STDIO_H=$gl_cv_next_stdio_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'stdio.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_stdio_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_STDIO_H=$gl_next_as_first_directive
+
+
+
+
+
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking which flavor of printf attribute matches inttypes macros" >&5
+printf %s "checking which flavor of printf attribute matches inttypes macros... " >&6; }
+if test ${gl_cv_func_printf_attribute_flavor+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+       #define __STDC_FORMAT_MACROS 1
+       #include <stdio.h>
+       #include <inttypes.h>
+       /* For non-mingw systems, compilation will trivially succeed.
+          For mingw, compilation will succeed for older mingw (system
+          printf, "I64d") and fail for newer mingw (gnu printf, "lld"). */
+       #if (defined _WIN32 && ! defined __CYGWIN__) && \
+         (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
+       extern char PRIdMAX_probesizeof PRIdMAX == sizeof "I64d" ? 1 : -1;
+       #endif
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_func_printf_attribute_flavor=system
+else $as_nop
+  gl_cv_func_printf_attribute_flavor=gnu
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_attribute_flavor" >&5
+printf "%s\n" "$gl_cv_func_printf_attribute_flavor" >&6; }
+  if test "$gl_cv_func_printf_attribute_flavor" = gnu; then
+
+printf "%s\n" "#define GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU 1" >>confdefs.h
+
+  fi
+
+
+
+
+
+
+
+
+
+
+
+
+
+  if test $ac_cv_have_decl_fcloseall = no; then
+    HAVE_DECL_FCLOSEALL=0
+  fi
+
+
+  if test $ac_cv_have_decl_getw = no; then
+    HAVE_DECL_GETW=0
+  fi
+
+
+  if test $ac_cv_have_decl_putw = no; then
+    HAVE_DECL_PUTW=0
+  fi
+
+ac_fn_check_decl "$LINENO" "ecvt" "ac_cv_have_decl_ecvt" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_ecvt" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_ECVT $ac_have_decl" >>confdefs.h
+
+ac_fn_check_decl "$LINENO" "fcvt" "ac_cv_have_decl_fcvt" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_fcvt" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_FCVT $ac_have_decl" >>confdefs.h
+
+ac_fn_check_decl "$LINENO" "gcvt" "ac_cv_have_decl_gcvt" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_gcvt" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_GCVT $ac_have_decl" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_stdlib_h='<'stdlib.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <stdlib.h>" >&5
+printf %s "checking absolute name of <stdlib.h>... " >&6; }
+if test ${gl_cv_next_stdlib_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stdlib.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'stdlib.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_stdlib_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_stdlib_h
+          gl_cv_next_stdlib_h='"'$gl_header'"'
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stdlib_h" >&5
+printf "%s\n" "$gl_cv_next_stdlib_h" >&6; }
+     fi
+     NEXT_STDLIB_H=$gl_cv_next_stdlib_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'stdlib.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_stdlib_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_STDLIB_H=$gl_next_as_first_directive
+
+
+
+
+
+
+
+
+
+
+
+
+  if test $ac_cv_have_decl_ecvt = no; then
+    HAVE_DECL_ECVT=0
+  fi
+
+  if test $ac_cv_have_decl_fcvt = no; then
+    HAVE_DECL_FCVT=0
+  fi
+
+  if test $ac_cv_have_decl_gcvt = no; then
+    HAVE_DECL_GCVT=0
+  fi
+
+
+
+
+
+
+
+
+
+
+
      if test $gl_cv_have_include_next = yes; then
        gl_cv_next_string_h='<'string.h'>'
      else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <string.h>" >&5
-$as_echo_n "checking absolute name of <string.h>... " >&6; }
-if ${gl_cv_next_string_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <string.h>" >&5
+printf %s "checking absolute name of <string.h>... " >&6; }
+if test ${gl_cv_next_string_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
 
 
@@ -13069,13 +16283,13 @@
         gl_cv_absolute_string_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
   sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_string_h
-           gl_cv_next_string_h='"'$gl_header'"'
+          gl_header=$gl_cv_absolute_string_h
+          gl_cv_next_string_h='"'$gl_header'"'
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_string_h" >&5
-$as_echo "$gl_cv_next_string_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_string_h" >&5
+printf "%s\n" "$gl_cv_next_string_h" >&6; }
      fi
      NEXT_STRING_H=$gl_cv_next_string_h
 
@@ -13098,25 +16312,52 @@
 
 
 
-ac_fn_c_check_type "$LINENO" "pid_t" "ac_cv_type_pid_t" "$ac_includes_default"
-if test "x$ac_cv_type_pid_t" = xyes; then :
 
-else
 
-cat >>confdefs.h <<_ACEOF
-#define pid_t int
+
+  ac_fn_c_check_type "$LINENO" "pid_t" "ac_cv_type_pid_t" "$ac_includes_default
+"
+if test "x$ac_cv_type_pid_t" = xyes
+then :
+
+else $as_nop
+                                          cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+          #if defined _WIN64 && !defined __CYGWIN__
+          LLP64
+          #endif
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+
 _ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  ac_pid_type='int'
+else $as_nop
+  ac_pid_type='__int64'
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+printf "%s\n" "#define pid_t $ac_pid_type" >>confdefs.h
+
 
 fi
 
+
 ac_fn_c_check_type "$LINENO" "mode_t" "ac_cv_type_mode_t" "$ac_includes_default"
-if test "x$ac_cv_type_mode_t" = xyes; then :
+if test "x$ac_cv_type_mode_t" = xyes
+then :
 
-else
+else $as_nop
 
-cat >>confdefs.h <<_ACEOF
-#define mode_t int
-_ACEOF
+printf "%s\n" "#define mode_t int" >>confdefs.h
 
 fi
 
@@ -13128,9 +16369,10 @@
 
 
 
-$as_echo "#define _USE_STD_STAT 1" >>confdefs.h
 
 
+printf "%s\n" "#define _USE_STD_STAT 1" >>confdefs.h
+
 
 
 
@@ -13143,11 +16385,12 @@
      if test $gl_cv_have_include_next = yes; then
        gl_cv_next_sys_types_h='<'sys/types.h'>'
      else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <sys/types.h>" >&5
-$as_echo_n "checking absolute name of <sys/types.h>... " >&6; }
-if ${gl_cv_next_sys_types_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <sys/types.h>" >&5
+printf %s "checking absolute name of <sys/types.h>... " >&6; }
+if test ${gl_cv_next_sys_types_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
 
 
@@ -13181,13 +16424,13 @@
         gl_cv_absolute_sys_types_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
   sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_sys_types_h
-           gl_cv_next_sys_types_h='"'$gl_header'"'
+          gl_header=$gl_cv_absolute_sys_types_h
+          gl_cv_next_sys_types_h='"'$gl_header'"'
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_sys_types_h" >&5
-$as_echo "$gl_cv_next_sys_types_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_sys_types_h" >&5
+printf "%s\n" "$gl_cv_next_sys_types_h" >&6; }
      fi
      NEXT_SYS_TYPES_H=$gl_cv_next_sys_types_h
 
@@ -13218,6 +16461,562 @@
 
 
 
+    HAVE_CHOWN=1;
+  HAVE_COPY_FILE_RANGE=1;
+  HAVE_DUP3=1;
+  HAVE_EUIDACCESS=1;
+  HAVE_EXECVPE=1;
+  HAVE_FACCESSAT=1;
+  HAVE_FCHDIR=1;
+  HAVE_FCHOWNAT=1;
+  HAVE_FDATASYNC=1;
+  HAVE_FSYNC=1;
+  HAVE_FTRUNCATE=1;
+  HAVE_GETDTABLESIZE=1;
+  HAVE_GETENTROPY=1;
+  HAVE_GETGROUPS=1;
+  HAVE_GETHOSTNAME=1;
+  HAVE_GETLOGIN=1;
+  HAVE_GETPAGESIZE=1;
+  HAVE_GETPASS=1;
+  HAVE_GROUP_MEMBER=1;
+  HAVE_LCHOWN=1;
+  HAVE_LINK=1;
+  HAVE_LINKAT=1;
+  HAVE_PIPE=1;
+  HAVE_PIPE2=1;
+  HAVE_PREAD=1;
+  HAVE_PWRITE=1;
+  HAVE_READLINK=1;
+  HAVE_READLINKAT=1;
+  HAVE_SETHOSTNAME=1;
+  HAVE_SLEEP=1;
+  HAVE_SYMLINK=1;
+  HAVE_SYMLINKAT=1;
+  HAVE_UNLINKAT=1;
+  HAVE_USLEEP=1;
+  HAVE_DECL_ENVIRON=1;
+  HAVE_DECL_EXECVPE=1;
+  HAVE_DECL_FCHDIR=1;
+  HAVE_DECL_FDATASYNC=1;
+  HAVE_DECL_GETDOMAINNAME=1;
+  HAVE_DECL_GETLOGIN=1;
+  HAVE_DECL_GETLOGIN_R=1;
+  HAVE_DECL_GETPAGESIZE=1;
+  HAVE_DECL_GETUSERSHELL=1;
+  HAVE_DECL_SETHOSTNAME=1;
+  HAVE_DECL_TRUNCATE=1;
+  HAVE_DECL_TTYNAME_R=1;
+  HAVE_OS_H=0;
+  HAVE_SYS_PARAM_H=0;
+  REPLACE_ACCESS=0;
+  REPLACE_CHOWN=0;
+  REPLACE_CLOSE=0;
+  REPLACE_COPY_FILE_RANGE=0;
+  REPLACE_DUP=0;
+  REPLACE_DUP2=0;
+  REPLACE_DUP3=0;
+  REPLACE_EXECL=0;
+  REPLACE_EXECLE=0;
+  REPLACE_EXECLP=0;
+  REPLACE_EXECV=0;
+  REPLACE_EXECVE=0;
+  REPLACE_EXECVP=0;
+  REPLACE_EXECVPE=0;
+  REPLACE_FACCESSAT=0;
+  REPLACE_FCHOWNAT=0;
+  REPLACE_FDATASYNC=0;
+  REPLACE_FTRUNCATE=0;
+  REPLACE_GETCWD=0;
+  REPLACE_GETDOMAINNAME=0;
+  REPLACE_GETDTABLESIZE=0;
+  REPLACE_GETENTROPY=0;
+  REPLACE_GETLOGIN_R=0;
+  REPLACE_GETGROUPS=0;
+  REPLACE_GETPAGESIZE=0;
+  REPLACE_GETPASS=0;
+  REPLACE_GETPASS_FOR_GETPASS_GNU=0;
+  REPLACE_ISATTY=0;
+  REPLACE_LCHOWN=0;
+  REPLACE_LINK=0;
+  REPLACE_LINKAT=0;
+  REPLACE_LSEEK=0;
+  REPLACE_PIPE2=0;
+  REPLACE_PREAD=0;
+  REPLACE_PWRITE=0;
+  REPLACE_READ=0;
+  REPLACE_READLINK=0;
+  REPLACE_READLINKAT=0;
+  REPLACE_RMDIR=0;
+  REPLACE_SETHOSTNAME=0;
+  REPLACE_SLEEP=0;
+  REPLACE_SYMLINK=0;
+  REPLACE_SYMLINKAT=0;
+  REPLACE_TRUNCATE=0;
+  REPLACE_TTYNAME_R=0;
+  REPLACE_UNLINK=0;
+  REPLACE_UNLINKAT=0;
+  REPLACE_USLEEP=0;
+  REPLACE_WRITE=0;
+  UNISTD_H_HAVE_SYS_RANDOM_H=0;
+  UNISTD_H_HAVE_WINSOCK2_H=0;
+  UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS=0;
+
+
+ac_fn_check_decl "$LINENO" "execvpe" "ac_cv_have_decl_execvpe" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_execvpe" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_EXECVPE $ac_have_decl" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_unistd_h='<'unistd.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <unistd.h>" >&5
+printf %s "checking absolute name of <unistd.h>... " >&6; }
+if test ${gl_cv_next_unistd_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_unistd_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <unistd.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'unistd.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_unistd_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_unistd_h
+          gl_cv_next_unistd_h='"'$gl_header'"'
+          else
+               gl_cv_next_unistd_h='<'unistd.h'>'
+             fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_unistd_h" >&5
+printf "%s\n" "$gl_cv_next_unistd_h" >&6; }
+     fi
+     NEXT_UNISTD_H=$gl_cv_next_unistd_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'unistd.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_unistd_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_UNISTD_H=$gl_next_as_first_directive
+
+
+
+
+  if test $ac_cv_header_unistd_h = yes; then
+    HAVE_UNISTD_H=1
+  else
+    HAVE_UNISTD_H=0
+  fi
+
+
+
+
+
+
+
+
+
+
+
+
+
+  if test $ac_cv_have_decl_execvpe = no; then
+    HAVE_DECL_EXECVPE=0
+  fi
+
+
+
+  GL_GNULIB_ACCESS=0
+
+
+
+  GL_GNULIB_CHDIR=0
+
+
+
+  GL_GNULIB_CHOWN=0
+
+
+
+  GL_GNULIB_CLOSE=0
+
+
+
+  GL_GNULIB_COPY_FILE_RANGE=0
+
+
+
+  GL_GNULIB_DUP=0
+
+
+
+  GL_GNULIB_DUP2=0
+
+
+
+  GL_GNULIB_DUP3=0
+
+
+
+  GL_GNULIB_ENVIRON=0
+
+
+
+  GL_GNULIB_EUIDACCESS=0
+
+
+
+  GL_GNULIB_EXECL=0
+
+
+
+  GL_GNULIB_EXECLE=0
+
+
+
+  GL_GNULIB_EXECLP=0
+
+
+
+  GL_GNULIB_EXECV=0
+
+
+
+  GL_GNULIB_EXECVE=0
+
+
+
+  GL_GNULIB_EXECVP=0
+
+
+
+  GL_GNULIB_EXECVPE=0
+
+
+
+  GL_GNULIB_FACCESSAT=0
+
+
+
+  GL_GNULIB_FCHDIR=0
+
+
+
+  GL_GNULIB_FCHOWNAT=0
+
+
+
+  GL_GNULIB_FDATASYNC=0
+
+
+
+  GL_GNULIB_FSYNC=0
+
+
+
+  GL_GNULIB_FTRUNCATE=0
+
+
+
+  GL_GNULIB_GETCWD=0
+
+
+
+  GL_GNULIB_GETDOMAINNAME=0
+
+
+
+  GL_GNULIB_GETDTABLESIZE=0
+
+
+
+  GL_GNULIB_GETENTROPY=0
+
+
+
+  GL_GNULIB_GETGROUPS=0
+
+
+
+  GL_GNULIB_GETHOSTNAME=0
+
+
+
+  GL_GNULIB_GETLOGIN=0
+
+
+
+  GL_GNULIB_GETLOGIN_R=0
+
+
+
+  GL_GNULIB_GETOPT_POSIX=0
+
+
+
+  GL_GNULIB_GETPAGESIZE=0
+
+
+
+  GL_GNULIB_GETPASS=0
+
+
+
+  GL_GNULIB_GETPASS_GNU=0
+
+
+
+  GL_GNULIB_GETUSERSHELL=0
+
+
+
+  GL_GNULIB_GROUP_MEMBER=0
+
+
+
+  GL_GNULIB_ISATTY=0
+
+
+
+  GL_GNULIB_LCHOWN=0
+
+
+
+  GL_GNULIB_LINK=0
+
+
+
+  GL_GNULIB_LINKAT=0
+
+
+
+  GL_GNULIB_LSEEK=0
+
+
+
+  GL_GNULIB_PIPE=0
+
+
+
+  GL_GNULIB_PIPE2=0
+
+
+
+  GL_GNULIB_PREAD=0
+
+
+
+  GL_GNULIB_PWRITE=0
+
+
+
+  GL_GNULIB_READ=0
+
+
+
+  GL_GNULIB_READLINK=0
+
+
+
+  GL_GNULIB_READLINKAT=0
+
+
+
+  GL_GNULIB_RMDIR=0
+
+
+
+  GL_GNULIB_SETHOSTNAME=0
+
+
+
+  GL_GNULIB_SLEEP=0
+
+
+
+  GL_GNULIB_SYMLINK=0
+
+
+
+  GL_GNULIB_SYMLINKAT=0
+
+
+
+  GL_GNULIB_TRUNCATE=0
+
+
+
+  GL_GNULIB_TTYNAME_R=0
+
+
+
+  GL_GNULIB_UNISTD_H_GETOPT=0
+
+
+
+  GL_GNULIB_UNISTD_H_NONBLOCKING=0
+
+
+
+  GL_GNULIB_UNISTD_H_SIGPIPE=0
+
+
+
+  GL_GNULIB_UNLINK=0
+
+
+
+  GL_GNULIB_UNLINKAT=0
+
+
+
+  GL_GNULIB_USLEEP=0
+
+
+
+  GL_GNULIB_WRITE=0
+
+
+
+  GL_GNULIB_MDA_ACCESS=1
+
+
+
+  GL_GNULIB_MDA_CHDIR=1
+
+
+
+  GL_GNULIB_MDA_CLOSE=1
+
+
+
+  GL_GNULIB_MDA_DUP=1
+
+
+
+  GL_GNULIB_MDA_DUP2=1
+
+
+
+  GL_GNULIB_MDA_EXECL=1
+
+
+
+  GL_GNULIB_MDA_EXECLE=1
+
+
+
+  GL_GNULIB_MDA_EXECLP=1
+
+
+
+  GL_GNULIB_MDA_EXECV=1
+
+
+
+  GL_GNULIB_MDA_EXECVE=1
+
+
+
+  GL_GNULIB_MDA_EXECVP=1
+
+
+
+  GL_GNULIB_MDA_EXECVPE=1
+
+
+
+  GL_GNULIB_MDA_GETCWD=1
+
+
+
+  GL_GNULIB_MDA_GETPID=1
+
+
+
+  GL_GNULIB_MDA_ISATTY=1
+
+
+
+  GL_GNULIB_MDA_LSEEK=1
+
+
+
+  GL_GNULIB_MDA_READ=1
+
+
+
+  GL_GNULIB_MDA_RMDIR=1
+
+
+
+  GL_GNULIB_MDA_SWAB=1
+
+
+
+  GL_GNULIB_MDA_UNLINK=1
+
+
+
+  GL_GNULIB_MDA_WRITE=1
+
+
+
+
+
+
 
 
 
@@ -13244,58 +17043,16 @@
     LIBUNISTRING_VERSION_SUBMINOR=`echo "$LIBUNISTRING_VERSION" | sed -n -e "$gl_libunistring_sed_extract_subminor"`
   fi
 
-ac_fn_c_check_decl "$LINENO" "vsnprintf" "ac_cv_have_decl_vsnprintf" "$ac_includes_default"
-if test "x$ac_cv_have_decl_vsnprintf" = xyes; then :
+ac_fn_check_decl "$LINENO" "vsnprintf" "ac_cv_have_decl_vsnprintf" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_vsnprintf" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
-
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_VSNPRINTF $ac_have_decl
-_ACEOF
+printf "%s\n" "#define HAVE_DECL_VSNPRINTF $ac_have_decl" >>confdefs.h
 
 
-  GNULIB_BTOWC=0;
-  GNULIB_WCTOB=0;
-  GNULIB_MBSINIT=0;
-  GNULIB_MBRTOWC=0;
-  GNULIB_MBRLEN=0;
-  GNULIB_MBSRTOWCS=0;
-  GNULIB_MBSNRTOWCS=0;
-  GNULIB_WCRTOMB=0;
-  GNULIB_WCSRTOMBS=0;
-  GNULIB_WCSNRTOMBS=0;
-  GNULIB_WCWIDTH=0;
-  GNULIB_WMEMCHR=0;
-  GNULIB_WMEMCMP=0;
-  GNULIB_WMEMCPY=0;
-  GNULIB_WMEMMOVE=0;
-  GNULIB_WMEMSET=0;
-  GNULIB_WCSLEN=0;
-  GNULIB_WCSNLEN=0;
-  GNULIB_WCSCPY=0;
-  GNULIB_WCPCPY=0;
-  GNULIB_WCSNCPY=0;
-  GNULIB_WCPNCPY=0;
-  GNULIB_WCSCAT=0;
-  GNULIB_WCSNCAT=0;
-  GNULIB_WCSCMP=0;
-  GNULIB_WCSNCMP=0;
-  GNULIB_WCSCASECMP=0;
-  GNULIB_WCSNCASECMP=0;
-  GNULIB_WCSCOLL=0;
-  GNULIB_WCSXFRM=0;
-  GNULIB_WCSDUP=0;
-  GNULIB_WCSCHR=0;
-  GNULIB_WCSRCHR=0;
-  GNULIB_WCSCSPN=0;
-  GNULIB_WCSSPN=0;
-  GNULIB_WCSPBRK=0;
-  GNULIB_WCSSTR=0;
-  GNULIB_WCSTOK=0;
-  GNULIB_WCSWIDTH=0;
-  GNULIB_WCSFTIME=0;
     HAVE_BTOWC=1;
   HAVE_MBSINIT=1;
   HAVE_MBRTOWC=1;
@@ -13309,6 +17066,7 @@
   HAVE_WMEMCMP=1;
   HAVE_WMEMCPY=1;
   HAVE_WMEMMOVE=1;
+  HAVE_WMEMPCPY=1;
   HAVE_WMEMSET=1;
   HAVE_WCSLEN=1;
   HAVE_WCSNLEN=1;
@@ -13335,6 +17093,7 @@
   HAVE_WCSWIDTH=1;
   HAVE_WCSFTIME=1;
   HAVE_DECL_WCTOB=1;
+  HAVE_DECL_WCSDUP=1;
   HAVE_DECL_WCWIDTH=1;
   REPLACE_MBSTATE_T=0;
   REPLACE_BTOWC=0;
@@ -13350,73 +17109,69 @@
   REPLACE_WCWIDTH=0;
   REPLACE_WCSWIDTH=0;
   REPLACE_WCSFTIME=0;
+  REPLACE_WCSTOK=0;
+  REPLACE_WMEMPCPY=0;
 
 
-            { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether <wchar.h> uses 'inline' correctly" >&5
-$as_echo_n "checking whether <wchar.h> uses 'inline' correctly... " >&6; }
-if ${gl_cv_header_wchar_h_correct_inline+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether <wchar.h> uses 'inline' correctly" >&5
+printf %s "checking whether <wchar.h> uses 'inline' correctly... " >&6; }
+if test ${gl_cv_header_wchar_h_correct_inline+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   gl_cv_header_wchar_h_correct_inline=yes
-     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+     case "$host_os" in
+       *-gnu* | gnu*)
+         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-       #define wcstod renamed_wcstod
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
-extern int zero (void);
-int main () { return zero(); }
+
+             #define wcstod renamed_wcstod
+             #include <wchar.h>
+             extern int zero (void);
+             int main () { return zero(); }
 
 _ACEOF
-                              save_ac_compile="$ac_compile"
-     ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest1/`
-     if echo '#include "conftest.c"' >conftest1.c &&
-        { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5
+                                                      save_ac_compile="$ac_compile"
+         ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest1/`
+         if echo '#include "conftest.c"' >conftest1.c \
+            && { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5
   (eval $ac_compile) 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }; then
-       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+           cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-         #define wcstod renamed_wcstod
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
-int zero (void) { return 0; }
+
+               #define wcstod renamed_wcstod
+               #include <wchar.h>
+               int zero (void) { return 0; }
 
 _ACEOF
-              ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest2/`
-       if echo '#include "conftest.c"' >conftest2.c &&
-          { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5
+                      ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest2/`
+           if echo '#include "conftest.c"' >conftest2.c \
+              && { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_compile\""; } >&5
   (eval $ac_compile) 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }; then
-         if $CC -o conftest$ac_exeext $CFLAGS $LDFLAGS conftest1.$ac_objext conftest2.$ac_objext $LIBS >&5 2>&1; then
-           :
-         else
-           gl_cv_header_wchar_h_correct_inline=no
+             if $CC -o conftest$ac_exeext $CFLAGS $LDFLAGS conftest1.$ac_objext conftest2.$ac_objext $LIBS >&5 2>&1; then
+               :
+             else
+               gl_cv_header_wchar_h_correct_inline=no
+             fi
+           fi
          fi
-       fi
-     fi
-     ac_compile="$save_ac_compile"
-     rm -f conftest12.c conftest12.$ac_objext conftest$ac_exeext
+         ac_compile="$save_ac_compile"
+         rm -f conftest12.c conftest12.$ac_objext conftest$ac_exeext
+         ;;
+     esac
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_wchar_h_correct_inline" >&5
-$as_echo "$gl_cv_header_wchar_h_correct_inline" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_wchar_h_correct_inline" >&5
+printf "%s\n" "$gl_cv_header_wchar_h_correct_inline" >&6; }
   if test $gl_cv_header_wchar_h_correct_inline = no; then
     as_fn_error $? "<wchar.h> cannot be used with this compiler ($CC $CFLAGS $CPPFLAGS).
 This is a known interoperability problem of glibc <= 2.5 with gcc >= 4.3 in
@@ -13432,7 +17187,6 @@
 
 
 
-
   if test $ac_cv_header_crtdefs_h = yes; then
     HAVE_CRTDEFS_H=1
   else
@@ -13441,15 +17195,305 @@
 
 
 
-  GNULIB_ISWBLANK=0;
-  GNULIB_WCTYPE=0;
-  GNULIB_ISWCTYPE=0;
-  GNULIB_WCTRANS=0;
-  GNULIB_TOWCTRANS=0;
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_wchar_h='<'wchar.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <wchar.h>" >&5
+printf %s "checking absolute name of <wchar.h>... " >&6; }
+if test ${gl_cv_next_wchar_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_wchar_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <wchar.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'wchar.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_wchar_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_wchar_h
+          gl_cv_next_wchar_h='"'$gl_header'"'
+          else
+               gl_cv_next_wchar_h='<'wchar.h'>'
+             fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_wchar_h" >&5
+printf "%s\n" "$gl_cv_next_wchar_h" >&6; }
+     fi
+     NEXT_WCHAR_H=$gl_cv_next_wchar_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'wchar.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_wchar_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_WCHAR_H=$gl_next_as_first_directive
+
+
+
+
+  if test $ac_cv_header_wchar_h = yes; then
+    HAVE_WCHAR_H=1
+  else
+    HAVE_WCHAR_H=0
+  fi
+
+
+
+
+
+  if test $gt_cv_c_wint_t = yes; then
+    HAVE_WINT_T=1
+  else
+    HAVE_WINT_T=0
+  fi
+
+
+
+
+
+
+
+
+
+
+  ac_fn_check_decl "$LINENO" "wcsdup" "ac_cv_have_decl_wcsdup" "
+      #include <wchar.h>
+
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_wcsdup" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_WCSDUP $ac_have_decl" >>confdefs.h
+
+  if test $ac_cv_have_decl_wcsdup = no; then
+    HAVE_DECL_WCSDUP=0
+  fi
+
+
+
+  GL_GNULIB_BTOWC=0
+
+
+
+  GL_GNULIB_WCTOB=0
+
+
+
+  GL_GNULIB_MBSINIT=0
+
+
+
+  GL_GNULIB_MBRTOWC=0
+
+
+
+  GL_GNULIB_MBRLEN=0
+
+
+
+  GL_GNULIB_MBSRTOWCS=0
+
+
+
+  GL_GNULIB_MBSNRTOWCS=0
+
+
+
+  GL_GNULIB_WCRTOMB=0
+
+
+
+  GL_GNULIB_WCSRTOMBS=0
+
+
+
+  GL_GNULIB_WCSNRTOMBS=0
+
+
+
+  GL_GNULIB_WCWIDTH=0
+
+
+
+  GL_GNULIB_WMEMCHR=0
+
+
+
+  GL_GNULIB_WMEMCMP=0
+
+
+
+  GL_GNULIB_WMEMCPY=0
+
+
+
+  GL_GNULIB_WMEMMOVE=0
+
+
+
+  GL_GNULIB_WMEMPCPY=0
+
+
+
+  GL_GNULIB_WMEMSET=0
+
+
+
+  GL_GNULIB_WCSLEN=0
+
+
+
+  GL_GNULIB_WCSNLEN=0
+
+
+
+  GL_GNULIB_WCSCPY=0
+
+
+
+  GL_GNULIB_WCPCPY=0
+
+
+
+  GL_GNULIB_WCSNCPY=0
+
+
+
+  GL_GNULIB_WCPNCPY=0
+
+
+
+  GL_GNULIB_WCSCAT=0
+
+
+
+  GL_GNULIB_WCSNCAT=0
+
+
+
+  GL_GNULIB_WCSCMP=0
+
+
+
+  GL_GNULIB_WCSNCMP=0
+
+
+
+  GL_GNULIB_WCSCASECMP=0
+
+
+
+  GL_GNULIB_WCSNCASECMP=0
+
+
+
+  GL_GNULIB_WCSCOLL=0
+
+
+
+  GL_GNULIB_WCSXFRM=0
+
+
+
+  GL_GNULIB_WCSDUP=0
+
+
+
+  GL_GNULIB_WCSCHR=0
+
+
+
+  GL_GNULIB_WCSRCHR=0
+
+
+
+  GL_GNULIB_WCSCSPN=0
+
+
+
+  GL_GNULIB_WCSSPN=0
+
+
+
+  GL_GNULIB_WCSPBRK=0
+
+
+
+  GL_GNULIB_WCSSTR=0
+
+
+
+  GL_GNULIB_WCSTOK=0
+
+
+
+  GL_GNULIB_WCSWIDTH=0
+
+
+
+  GL_GNULIB_WCSFTIME=0
+
+
+
+  GL_GNULIB_MDA_WCSDUP=1
+
+
+
+
     HAVE_ISWBLANK=1;
   HAVE_WCTYPE_T=1;
   HAVE_WCTRANS_T=1;
   REPLACE_ISWBLANK=0;
+  REPLACE_ISWDIGIT=0;
+  REPLACE_ISWXDIGIT=0;
 
 
 
@@ -13457,32 +17501,355 @@
 
 
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for inline" >&5
-$as_echo_n "checking for inline... " >&6; }
-if ${ac_cv_c_inline+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+  if test $ac_cv_func_iswcntrl = yes; then
+    HAVE_ISWCNTRL=1
+  else
+    HAVE_ISWCNTRL=0
+  fi
+
+
+
+  if test $gt_cv_c_wint_t = yes; then
+    HAVE_WINT_T=1
+  else
+    HAVE_WINT_T=0
+  fi
+
+
+
+
+
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_wctype_h='<'wctype.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <wctype.h>" >&5
+printf %s "checking absolute name of <wctype.h>... " >&6; }
+if test ${gl_cv_next_wctype_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+             if test $ac_cv_header_wctype_h = yes; then
+
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <wctype.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'wctype.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_wctype_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_wctype_h
+          gl_cv_next_wctype_h='"'$gl_header'"'
+          else
+               gl_cv_next_wctype_h='<'wctype.h'>'
+             fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_wctype_h" >&5
+printf "%s\n" "$gl_cv_next_wctype_h" >&6; }
+     fi
+     NEXT_WCTYPE_H=$gl_cv_next_wctype_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'wctype.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_wctype_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_WCTYPE_H=$gl_next_as_first_directive
+
+
+
+
+  if test $ac_cv_header_wctype_h = yes; then
+    if test $ac_cv_func_iswcntrl = yes; then
+                  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether iswcntrl works" >&5
+printf %s "checking whether iswcntrl works... " >&6; }
+if test ${gl_cv_func_iswcntrl_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+          if test "$cross_compiling" = yes
+then :
+               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stdlib.h>
+                          #if __GNU_LIBRARY__ == 1
+                          Linux libc5 i18n is broken.
+                          #endif
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_func_iswcntrl_works="guessing yes"
+else $as_nop
+  gl_cv_func_iswcntrl_works="guessing no"
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+               #include <wchar.h>
+               #include <wctype.h>
+               int main () { return iswprint ('x') == 0; }
+
+_ACEOF
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_func_iswcntrl_works=yes
+else $as_nop
+  gl_cv_func_iswcntrl_works=no
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_iswcntrl_works" >&5
+printf "%s\n" "$gl_cv_func_iswcntrl_works" >&6; }
+    fi
+    HAVE_WCTYPE_H=1
+  else
+    HAVE_WCTYPE_H=0
+  fi
+
+
+  if test $GNULIBHEADERS_OVERRIDE_WINT_T = 1; then
+    REPLACE_ISWCNTRL=1
+  else
+    case "$gl_cv_func_iswcntrl_works" in
+      *yes) REPLACE_ISWCNTRL=0 ;;
+      *)    REPLACE_ISWCNTRL=1 ;;
+    esac
+  fi
+
+
+  if test $HAVE_ISWCNTRL = 0 || test $REPLACE_ISWCNTRL = 1; then
+        :
+  fi
+
+  if test $REPLACE_ISWCNTRL = 1; then
+    REPLACE_TOWLOWER=1
+  else
+    ac_fn_c_check_func "$LINENO" "towlower" "ac_cv_func_towlower"
+if test "x$ac_cv_func_towlower" = xyes
+then :
+  printf "%s\n" "#define HAVE_TOWLOWER 1" >>confdefs.h
+
+fi
+
+    if test $ac_cv_func_towlower = yes; then
+      REPLACE_TOWLOWER=0
+    else
+      ac_fn_check_decl "$LINENO" "towlower" "ac_cv_have_decl_towlower" "#include <wchar.h>
+          #if HAVE_WCTYPE_H
+          # include <wctype.h>
+          #endif
+
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_towlower" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_TOWLOWER $ac_have_decl" >>confdefs.h
+
+      if test $ac_cv_have_decl_towlower = yes; then
+                                REPLACE_TOWLOWER=1
+      else
+        REPLACE_TOWLOWER=0
+      fi
+    fi
+  fi
+
+
+  if test $HAVE_ISWCNTRL = 0 || test $REPLACE_TOWLOWER = 1; then
+        :
+  fi
+
+          { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for wctype_t" >&5
+printf %s "checking for wctype_t... " >&6; }
+if test ${gl_cv_type_wctype_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <wchar.h>
+            #if HAVE_WCTYPE_H
+            # include <wctype.h>
+            #endif
+            wctype_t a;
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_type_wctype_t=yes
+else $as_nop
+  gl_cv_type_wctype_t=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wctype_t" >&5
+printf "%s\n" "$gl_cv_type_wctype_t" >&6; }
+  if test $gl_cv_type_wctype_t = no; then
+    HAVE_WCTYPE_T=0
+  fi
+
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for wctrans_t" >&5
+printf %s "checking for wctrans_t... " >&6; }
+if test ${gl_cv_type_wctrans_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <wchar.h>
+            #include <wctype.h>
+            wctrans_t a;
+
+int
+main (void)
+{
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_type_wctrans_t=yes
+else $as_nop
+  gl_cv_type_wctrans_t=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wctrans_t" >&5
+printf "%s\n" "$gl_cv_type_wctrans_t" >&6; }
+  if test $gl_cv_type_wctrans_t = no; then
+    HAVE_WCTRANS_T=0
+  fi
+
+
+
+
+
+
+
+  GL_GNULIB_ISWBLANK=0
+
+
+
+  GL_GNULIB_ISWDIGIT=0
+
+
+
+  GL_GNULIB_ISWXDIGIT=0
+
+
+
+  GL_GNULIB_WCTYPE=0
+
+
+
+  GL_GNULIB_ISWCTYPE=0
+
+
+
+  GL_GNULIB_WCTRANS=0
+
+
+
+  GL_GNULIB_TOWCTRANS=0
+
+
+
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for inline" >&5
+printf %s "checking for inline... " >&6; }
+if test ${ac_cv_c_inline+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_c_inline=no
 for ac_kw in inline __inline__ __inline; do
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #ifndef __cplusplus
 typedef int foo_t;
-static $ac_kw foo_t static_foo () {return 0; }
-$ac_kw foo_t foo () {return 0; }
+static $ac_kw foo_t static_foo (void) {return 0; }
+$ac_kw foo_t foo (void) {return 0; }
 #endif
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_inline=$ac_kw
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
   test "$ac_cv_c_inline" != no && break
 done
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_inline" >&5
-$as_echo "$ac_cv_c_inline" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_inline" >&5
+printf "%s\n" "$ac_cv_c_inline" >&6; }
 
 case $ac_cv_c_inline in
   inline | yes) ;;
@@ -13500,6 +17867,90 @@
 esac
 
 
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for C compiler option to allow warnings" >&5
+printf %s "checking for C compiler option to allow warnings... " >&6; }
+if test ${gl_cv_cc_wallow+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  rm -f conftest*
+     echo 'int dummy;' > conftest.c
+     { ac_try='${CC-cc} $CFLAGS $CPPFLAGS -c conftest.c 2>conftest1.err'
+  { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_try\""; } >&5
+  (eval $ac_try) 2>&5
+  ac_status=$?
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }; } >/dev/null
+     { ac_try='${CC-cc} $CFLAGS $CPPFLAGS -Wno-error -c conftest.c 2>conftest2.err'
+  { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$ac_try\""; } >&5
+  (eval $ac_try) 2>&5
+  ac_status=$?
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }; } >/dev/null
+                         if test $? = 0 && test `wc -l < conftest1.err` = `wc -l < conftest2.err`; then
+       gl_cv_cc_wallow='-Wno-error'
+     else
+       gl_cv_cc_wallow=none
+     fi
+     rm -f conftest*
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_wallow" >&5
+printf "%s\n" "$gl_cv_cc_wallow" >&6; }
+  case "$gl_cv_cc_wallow" in
+    none) GL_CFLAG_ALLOW_WARNINGS='' ;;
+    *)    GL_CFLAG_ALLOW_WARNINGS="$gl_cv_cc_wallow" ;;
+  esac
+
+
+
+
+      GL_CFLAG_GNULIB_WARNINGS=''
+  if test -n "$GL_CFLAG_ALLOW_WARNINGS"; then
+                                                                        cat > conftest.c <<\EOF
+      #if __GNUC__ >= 3 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-cast-qual
+      -Wno-conversion
+      -Wno-float-equal
+      -Wno-sign-compare
+      -Wno-undef
+      -Wno-unused-function
+      -Wno-unused-parameter
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 9) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-float-conversion
+      #endif
+      #if __GNUC__ >= 7 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wimplicit-fallthrough
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 8) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-pedantic
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 3) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-sign-conversion
+      -Wno-type-limits
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 5) > 4
+      -Wno-unsuffixed-float-constants
+      #endif
+EOF
+    gl_command="$CC $CFLAGS $CPPFLAGS -E conftest.c > conftest.out"
+    if { { eval echo "\"\$as_me\":${as_lineno-$LINENO}: \"$gl_command\""; } >&5
+  (eval $gl_command) 2>&5
+  ac_status=$?
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  test $ac_status = 0; }; then
+      gl_options=`grep -v '#' conftest.out`
+      for word in $gl_options; do
+        GL_CFLAG_GNULIB_WARNINGS="$GL_CFLAG_GNULIB_WARNINGS $word"
+      done
+    fi
+    rm -f conftest.c conftest.out
+  fi
+
+
+
    if false; then
   GL_COND_LIBTOOL_TRUE=
   GL_COND_LIBTOOL_FALSE='#'
@@ -13521,7 +17972,11 @@
 
 
 
+
+
+
   gl_source_base='lib'
+  gl_source_base_prefix='$(top_build_prefix)lib/'
 
 
   if test $ac_cv_func_alloca_works = no; then
@@ -13530,11 +17985,12 @@
 
   # Define an additional variable used in the Makefile substitution.
   if test $ac_cv_working_alloca_h = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for alloca as a compiler built-in" >&5
-$as_echo_n "checking for alloca as a compiler built-in... " >&6; }
-if ${gl_cv_rpl_alloca+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for alloca as a compiler built-in" >&5
+printf %s "checking for alloca as a compiler built-in... " >&6; }
+if test ${gl_cv_rpl_alloca+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -13545,36 +18001,237 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Need own alloca" >/dev/null 2>&1; then :
+  $EGREP "Need own alloca" >/dev/null 2>&1
+then :
   gl_cv_rpl_alloca=yes
-else
+else $as_nop
   gl_cv_rpl_alloca=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_rpl_alloca" >&5
-$as_echo "$gl_cv_rpl_alloca" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_rpl_alloca" >&5
+printf "%s\n" "$gl_cv_rpl_alloca" >&6; }
     if test $gl_cv_rpl_alloca = yes; then
 
-$as_echo "#define HAVE_ALLOCA 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ALLOCA 1" >>confdefs.h
 
-      ALLOCA_H=alloca.h
+      GL_GENERATE_ALLOCA_H=true
     else
-                  ALLOCA_H=
+                  GL_GENERATE_ALLOCA_H=false
     fi
   else
-    ALLOCA_H=alloca.h
+    GL_GENERATE_ALLOCA_H=true
   fi
 
-   if test -n "$ALLOCA_H"; then
+  if test $ac_cv_working_alloca_h = yes; then
+    HAVE_ALLOCA_H=1
+  else
+    HAVE_ALLOCA_H=0
+  fi
+
+
+
+
+
+
+  case "$GL_GENERATE_ALLOCA_H" in
+    false) ALLOCA_H='' ;;
+    true)
+                  if test -z "$ALLOCA_H"; then
+        ALLOCA_H="${gl_source_base_prefix}alloca.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_ALLOCA_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_ALLOCA_H; then
   GL_GENERATE_ALLOCA_H_TRUE=
   GL_GENERATE_ALLOCA_H_FALSE='#'
 else
   GL_GENERATE_ALLOCA_H_TRUE='#'
   GL_GENERATE_ALLOCA_H_FALSE=
 fi
+:
+    if test -z "${GL_GENERATE_ALLOCA_H_TRUE}" && test -z "${GL_GENERATE_ALLOCA_H_FALSE}"; then
+    GL_GENERATE_ALLOCA_H_TRUE='#'
+    GL_GENERATE_ALLOCA_H_FALSE='#'
+  fi
+
+
+
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for static_assert" >&5
+printf %s "checking for static_assert... " >&6; }
+if test ${gl_cv_static_assert+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  gl_save_CFLAGS=$CFLAGS
+     for gl_working in "yes, a keyword" "yes, an <assert.h> macro"; do
+      case $gl_working in #(
+  *assert.h*) :
+    CFLAGS="$gl_save_CFLAGS -DINCLUDE_ASSERT_H" ;; #(
+  *) :
+     ;;
+esac
+
+      cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#if defined __clang__ && __STDC_VERSION__ < 202311
+             #pragma clang diagnostic error "-Wc2x-extensions"
+             #pragma clang diagnostic error "-Wc++1z-extensions"
+            #endif
+            #ifdef INCLUDE_ASSERT_H
+             #include <assert.h>
+            #endif
+            static_assert (2 + 2 == 4, "arithmetic does not work");
+            static_assert (2 + 2 == 4);
+
+int
+main (void)
+{
+
+            static_assert (sizeof (char) == 1, "sizeof does not work");
+            static_assert (sizeof (char) == 1);
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_static_assert=$gl_working
+else $as_nop
+  gl_cv_static_assert=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+      CFLAGS=$gl_save_CFLAGS
+      test "$gl_cv_static_assert" != no && break
+     done
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_static_assert" >&5
+printf "%s\n" "$gl_cv_static_assert" >&6; }
+
+  GL_GENERATE_ASSERT_H=false
+  case $gl_cv_static_assert in #(
+  yes*keyword*) :
+
+printf "%s\n" "#define HAVE_C_STATIC_ASSERT 1" >>confdefs.h
+ ;; #(
+  no) :
+    GL_GENERATE_ASSERT_H=true
+
+
+
+
+
+
+
+
+     if test $gl_cv_have_include_next = yes; then
+       gl_cv_next_assert_h='<'assert.h'>'
+     else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <assert.h>" >&5
+printf %s "checking absolute name of <assert.h>... " >&6; }
+if test ${gl_cv_next_assert_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+
+
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <assert.h>
+_ACEOF
+                case "$host_os" in
+    aix*) gl_absname_cpp="$ac_cpp -C" ;;
+    *)    gl_absname_cpp="$ac_cpp" ;;
+  esac
+
+  case "$host_os" in
+    mingw*)
+                                          gl_dirsep_regex='/\\'
+      ;;
+    *)
+      gl_dirsep_regex='\/'
+      ;;
+  esac
+      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
+  gl_header_literal_regex=`echo 'assert.h' \
+                           | sed -e "$gl_make_literal_regex_sed"`
+  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
+      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
+      s|^/^/|//&|
+      p
+      q
+    }'
+
+        gl_cv_absolute_assert_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
+  sed -n "$gl_absolute_header_sed"`
+
+          gl_header=$gl_cv_absolute_assert_h
+          gl_cv_next_assert_h='"'$gl_header'"'
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_assert_h" >&5
+printf "%s\n" "$gl_cv_next_assert_h" >&6; }
+     fi
+     NEXT_ASSERT_H=$gl_cv_next_assert_h
+
+     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
+       gl_next_as_first_directive='<'assert.h'>'
+     else
+       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
+       gl_next_as_first_directive=$gl_cv_next_assert_h
+     fi
+     NEXT_AS_FIRST_DIRECTIVE_ASSERT_H=$gl_next_as_first_directive
+
+
+
+ ;; #(
+  *) :
+     ;;
+esac
+
+
+
+
+
+
+
+  case "$GL_GENERATE_ASSERT_H" in
+    false) ASSERT_H='' ;;
+    true)
+                  if test -z "$ASSERT_H"; then
+        ASSERT_H="${gl_source_base_prefix}assert.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_ASSERT_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_ASSERT_H; then
+  GL_GENERATE_ASSERT_H_TRUE=
+  GL_GENERATE_ASSERT_H_FALSE='#'
+else
+  GL_GENERATE_ASSERT_H_TRUE='#'
+  GL_GENERATE_ASSERT_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_ASSERT_H_TRUE}" && test -z "${GL_GENERATE_ASSERT_H_FALSE}"; then
+    GL_GENERATE_ASSERT_H_TRUE='#'
+    GL_GENERATE_ASSERT_H_FALSE='#'
+  fi
+
 
 
 
@@ -13582,16 +18239,52 @@
 
 
 
-  FLOAT_H=
+
+
+
+  case "$GL_GENERATE_ERRNO_H" in
+    false) ERRNO_H='' ;;
+    true)
+                  if test -z "$ERRNO_H"; then
+        ERRNO_H="${gl_source_base_prefix}errno.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_ERRNO_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_ERRNO_H; then
+  GL_GENERATE_ERRNO_H_TRUE=
+  GL_GENERATE_ERRNO_H_FALSE='#'
+else
+  GL_GENERATE_ERRNO_H_TRUE='#'
+  GL_GENERATE_ERRNO_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_ERRNO_H_TRUE}" && test -z "${GL_GENERATE_ERRNO_H_FALSE}"; then
+    GL_GENERATE_ERRNO_H_TRUE='#'
+    GL_GENERATE_ERRNO_H_FALSE='#'
+  fi
+
+
+
+
+
+
+
+
+
+
+  GL_GENERATE_FLOAT_H=false
   REPLACE_FLOAT_LDBL=0
   case "$host_os" in
     aix* | beos* | openbsd* | mirbsd* | irix*)
-      FLOAT_H=float.h
+      GL_GENERATE_FLOAT_H=true
       ;;
     freebsd* | dragonfly*)
       case "$host_cpu" in
         i3456786 )
-          FLOAT_H=float.h
+          GL_GENERATE_FLOAT_H=true
           ;;
         x86_64 )
           # On x86_64 systems, the C compiler may still be generating
@@ -13605,39 +18298,42 @@
                  #endif
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
-else
-  FLOAT_H=float.h
+else $as_nop
+  GL_GENERATE_FLOAT_H=true
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
           ;;
       esac
       ;;
     linux*)
       case "$host_cpu" in
         powerpc*)
-          FLOAT_H=float.h
+          GL_GENERATE_FLOAT_H=true
           ;;
       esac
       ;;
   esac
   case "$host_os" in
     aix* | freebsd* | dragonfly* | linux*)
-      if test -n "$FLOAT_H"; then
+      if $GL_GENERATE_FLOAT_H; then
         REPLACE_FLOAT_LDBL=1
       fi
       ;;
   esac
 
     REPLACE_ITOLD=0
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether conversion from 'int' to 'long double' works" >&5
-$as_echo_n "checking whether conversion from 'int' to 'long double' works... " >&6; }
-if ${gl_cv_func_itold_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether conversion from 'int' to 'long double' works" >&5
+printf %s "checking whether conversion from 'int' to 'long double' works... " >&6; }
+if test ${gl_cv_func_itold_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host" in
            sparc*-*-linux*)
              cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -13649,19 +18345,20 @@
                    #endif
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gl_cv_func_itold_works="guessing no"
-else
+else $as_nop
   gl_cv_func_itold_works="guessing yes"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
              ;;
                    # Guess yes on native Windows.
            mingw*) gl_cv_func_itold_works="guessing yes" ;;
            *)      gl_cv_func_itold_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -13675,9 +18372,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_itold_works=yes
-else
+else $as_nop
   gl_cv_func_itold_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -13686,16 +18384,16 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_itold_works" >&5
-$as_echo "$gl_cv_func_itold_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_itold_works" >&5
+printf "%s\n" "$gl_cv_func_itold_works" >&6; }
   case "$gl_cv_func_itold_works" in
     *no)
       REPLACE_ITOLD=1
-                  FLOAT_H=float.h
+                  GL_GENERATE_FLOAT_H=true
       ;;
   esac
 
-  if test -n "$FLOAT_H"; then
+  if $GL_GENERATE_FLOAT_H; then
 
 
 
@@ -13707,11 +18405,12 @@
      if test $gl_cv_have_include_next = yes; then
        gl_cv_next_float_h='<'float.h'>'
      else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <float.h>" >&5
-$as_echo_n "checking absolute name of <float.h>... " >&6; }
-if ${gl_cv_next_float_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking absolute name of <float.h>" >&5
+printf %s "checking absolute name of <float.h>... " >&6; }
+if test ${gl_cv_next_float_h+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
 
 
@@ -13745,13 +18444,13 @@
         gl_cv_absolute_float_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
   sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_float_h
-           gl_cv_next_float_h='"'$gl_header'"'
+          gl_header=$gl_cv_absolute_float_h
+          gl_cv_next_float_h='"'$gl_header'"'
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_float_h" >&5
-$as_echo "$gl_cv_next_float_h" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_float_h" >&5
+printf "%s\n" "$gl_cv_next_float_h" >&6; }
      fi
      NEXT_FLOAT_H=$gl_cv_next_float_h
 
@@ -13769,29 +18468,34 @@
 
   fi
 
-   if test -n "$FLOAT_H"; then
-  GL_GENERATE_FLOAT_H_TRUE=
-  GL_GENERATE_FLOAT_H_FALSE='#'
-else
-  GL_GENERATE_FLOAT_H_TRUE='#'
-  GL_GENERATE_FLOAT_H_FALSE=
-fi
-
-
-
-  if test $REPLACE_FLOAT_LDBL = 1; then
-
-
 
 
 
 
 
+  case "$GL_GENERATE_FLOAT_H" in
+    false) FLOAT_H='' ;;
+    true)
+                  if test -z "$FLOAT_H"; then
+        FLOAT_H="${gl_source_base_prefix}float.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_FLOAT_H is not set correctly" 1>&2; exit 1 ;;
+  esac
 
-  gl_LIBOBJS="$gl_LIBOBJS float.$ac_objext"
 
+     if $GL_GENERATE_FLOAT_H; then
+  GL_GENERATE_FLOAT_H_TRUE=
+  GL_GENERATE_FLOAT_H_FALSE='#'
+else
+  GL_GENERATE_FLOAT_H_TRUE='#'
+  GL_GENERATE_FLOAT_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_FLOAT_H_TRUE}" && test -z "${GL_GENERATE_FLOAT_H_FALSE}"; then
+    GL_GENERATE_FLOAT_H_TRUE='#'
+    GL_GENERATE_FLOAT_H_FALSE='#'
   fi
-  if test $REPLACE_ITOLD = 1; then
 
 
 
@@ -13799,9 +18503,31 @@
 
 
 
+     if test $REPLACE_FLOAT_LDBL = 1; then
+  GL_COND_OBJ_FLOAT_TRUE=
+  GL_COND_OBJ_FLOAT_FALSE='#'
+else
+  GL_COND_OBJ_FLOAT_TRUE='#'
+  GL_COND_OBJ_FLOAT_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_FLOAT_TRUE}" && test -z "${GL_COND_OBJ_FLOAT_FALSE}"; then
+    GL_COND_OBJ_FLOAT_TRUE='#'
+    GL_COND_OBJ_FLOAT_FALSE='#'
+  fi
 
-  gl_LIBOBJS="$gl_LIBOBJS itold.$ac_objext"
 
+     if test $REPLACE_ITOLD = 1; then
+  GL_COND_OBJ_ITOLD_TRUE=
+  GL_COND_OBJ_ITOLD_FALSE='#'
+else
+  GL_COND_OBJ_ITOLD_TRUE='#'
+  GL_COND_OBJ_ITOLD_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_ITOLD_TRUE}" && test -z "${GL_COND_OBJ_ITOLD_FALSE}"; then
+    GL_COND_OBJ_ITOLD_TRUE='#'
+    GL_COND_OBJ_ITOLD_FALSE='#'
   fi
 
 
@@ -13818,6 +18544,7 @@
 
 
 
+
   gl_cv_func_fprintf_posix=no
   case "$gl_cv_func_printf_sizes_c99" in
     *yes)
@@ -13887,7 +18614,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_INFINITE_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_INFINITE_DOUBLE 1" >>confdefs.h
 
       ;;
   esac
@@ -13902,7 +18629,7 @@
           ;;
         *)
 
-$as_echo "#define NEED_PRINTF_INFINITE_LONG_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_INFINITE_LONG_DOUBLE 1" >>confdefs.h
 
           ;;
       esac
@@ -13916,18 +18643,69 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_DIRECTIVE_A 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_DIRECTIVE_A 1" >>confdefs.h
 
-      for ac_func in nl_langinfo
-do :
-  ac_fn_c_check_func "$LINENO" "nl_langinfo" "ac_cv_func_nl_langinfo"
-if test "x$ac_cv_func_nl_langinfo" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_NL_LANGINFO 1
-_ACEOF
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for nl_langinfo" >&5
+printf %s "checking for nl_langinfo... " >&6; }
+if test ${gl_cv_onwards_func_nl_langinfo+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+  exec 9>&6 6>/dev/null
+
+       case "$host_os" in
+         linux*-android*)
+           ac_fn_check_decl "$LINENO" "nl_langinfo" "ac_cv_have_decl_nl_langinfo" "#include <langinfo.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_nl_langinfo" = xyes
+then :
 
 fi
-done
+           if test $ac_cv_have_decl_nl_langinfo = yes; then
+             ac_fn_c_check_func "$LINENO" "nl_langinfo" "ac_cv_func_nl_langinfo"
+if test "x$ac_cv_func_nl_langinfo" = xyes
+then :
+
+fi
+
+             if test $ac_cv_func_nl_langinfo = yes; then
+               gl_cv_onwards_func_nl_langinfo=yes
+             else
+                                                            gl_cv_onwards_func_nl_langinfo='future OS version'
+             fi
+           else
+             gl_cv_onwards_func_nl_langinfo='future OS version'
+           fi
+           ;;
+         *)
+           ac_fn_c_check_func "$LINENO" "nl_langinfo" "ac_cv_func_nl_langinfo"
+if test "x$ac_cv_func_nl_langinfo" = xyes
+then :
+
+fi
+
+           gl_cv_onwards_func_nl_langinfo=$ac_cv_func_nl_langinfo
+           ;;
+       esac
+
+  exec 6>&9 9>&-
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_onwards_func_nl_langinfo" >&5
+printf "%s\n" "$gl_cv_onwards_func_nl_langinfo" >&6; }
+  case "$gl_cv_onwards_func_nl_langinfo" in
+    future*) ac_cv_func_nl_langinfo=no ;;
+    *)       ac_cv_func_nl_langinfo=$gl_cv_onwards_func_nl_langinfo ;;
+  esac
+  if test $ac_cv_func_nl_langinfo = yes; then
+
+printf "%s\n" "#define HAVE_NL_LANGINFO 1" >>confdefs.h
+
+  fi
 
       ;;
   esac
@@ -13939,7 +18717,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_DIRECTIVE_F 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_DIRECTIVE_F 1" >>confdefs.h
 
       ;;
   esac
@@ -13951,7 +18729,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_DIRECTIVE_LS 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_DIRECTIVE_LS 1" >>confdefs.h
 
       ;;
   esac
@@ -13963,7 +18741,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_FLAG_GROUPING 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_FLAG_GROUPING 1" >>confdefs.h
 
       ;;
   esac
@@ -13975,7 +18753,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_FLAG_LEFTADJUST 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_FLAG_LEFTADJUST 1" >>confdefs.h
 
       ;;
   esac
@@ -13987,7 +18765,7 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_FLAG_ZERO 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_FLAG_ZERO 1" >>confdefs.h
 
       ;;
   esac
@@ -13999,13 +18777,13 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_UNBOUNDED_PRECISION 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_UNBOUNDED_PRECISION 1" >>confdefs.h
 
 
-$as_echo "#define NEED_PRINTF_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_DOUBLE 1" >>confdefs.h
 
 
-$as_echo "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
 
       ;;
   esac
@@ -14017,13 +18795,13 @@
       ;;
     *)
 
-$as_echo "#define NEED_PRINTF_ENOMEM 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_ENOMEM 1" >>confdefs.h
 
 
-$as_echo "#define NEED_PRINTF_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_DOUBLE 1" >>confdefs.h
 
 
-$as_echo "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
+printf "%s\n" "#define NEED_PRINTF_LONG_DOUBLE 1" >>confdefs.h
 
       ;;
   esac
@@ -14072,7 +18850,7 @@
 
   if test $ac_cv_func_vasnprintf = yes; then
 
-$as_echo "#define REPLACE_VASNPRINTF 1" >>confdefs.h
+printf "%s\n" "#define REPLACE_VASNPRINTF 1" >>confdefs.h
 
   fi
 
@@ -14084,14 +18862,13 @@
 
 
 
-
-
   ac_fn_c_check_type "$LINENO" "ptrdiff_t" "ac_cv_type_ptrdiff_t" "$ac_includes_default"
-if test "x$ac_cv_type_ptrdiff_t" = xyes; then :
+if test "x$ac_cv_type_ptrdiff_t" = xyes
+then :
 
-else
+else $as_nop
 
-$as_echo "#define ptrdiff_t long" >>confdefs.h
+printf "%s\n" "#define ptrdiff_t long" >>confdefs.h
 
 
 fi
@@ -14116,7 +18893,7 @@
 
   REPLACE_FPRINTF=1
 
-$as_echo "#define REPLACE_FPRINTF_POSIX 1" >>confdefs.h
+printf "%s\n" "#define REPLACE_FPRINTF_POSIX 1" >>confdefs.h
 
   :
 
@@ -14127,30 +18904,122 @@
 
 
 
-          GNULIB_FPRINTF_POSIX=1
 
 
 
 
+          GL_GNULIB_FPRINTF_POSIX=1
 
-$as_echo "#define GNULIB_TEST_FPRINTF_POSIX 1" >>confdefs.h
 
 
 
 
+printf "%s\n" "#define GNULIB_TEST_FPRINTF_POSIX 1" >>confdefs.h
+
 
 
-  if test $gl_cv_func_frexp_no_libm = yes; then
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexp works" >&5
-$as_echo_n "checking whether frexp works... " >&6; }
-if ${gl_cv_func_frexp_works+:} false; then :
-  $as_echo_n "(cached) " >&6
+                          { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether free is known to preserve errno" >&5
+printf %s "checking whether free is known to preserve errno... " >&6; }
+if test ${gl_cv_func_free_preserves_errno+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <stdlib.h>
+
+int
+main (void)
+{
+#if 2 < __GLIBC__ + (33 <= __GLIBC_MINOR__)
+            #elif defined __OpenBSD__
+            #elif defined __sun
+            #else
+              #error "'free' is not known to preserve errno"
+            #endif
+
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_compile "$LINENO"
+then :
+  gl_cv_func_free_preserves_errno=yes
+else $as_nop
+  gl_cv_func_free_preserves_errno=no
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_free_preserves_errno" >&5
+printf "%s\n" "$gl_cv_func_free_preserves_errno" >&6; }
+
+  case $gl_cv_func_free_preserves_errno in
+   *yes)
+
+printf "%s\n" "#define HAVE_FREE_POSIX 1" >>confdefs.h
+
+    ;;
+   *) REPLACE_FREE=1 ;;
+  esac
+
+
+     if test $REPLACE_FREE = 1; then
+  GL_COND_OBJ_FREE_TRUE=
+  GL_COND_OBJ_FREE_FALSE='#'
 else
+  GL_COND_OBJ_FREE_TRUE='#'
+  GL_COND_OBJ_FREE_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_FREE_TRUE}" && test -z "${GL_COND_OBJ_FREE_FALSE}"; then
+    GL_COND_OBJ_FREE_TRUE='#'
+    GL_COND_OBJ_FREE_FALSE='#'
+  fi
+
+  if test -z "$GL_COND_OBJ_FREE_TRUE"; then :
+
+    :
+
+fi
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FREE_POSIX=1
 
-      if test "$cross_compiling" = yes; then :
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FREE_POSIX 1" >>confdefs.h
+
+
+
+
+
+
+  if test $gl_cv_func_frexp_no_libm = yes; then
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexp works" >&5
+printf %s "checking whether frexp works... " >&6; }
+if test ${gl_cv_func_frexp_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
            netbsd* | irix*) gl_cv_func_frexp_works="guessing no" ;;
            mingw*) # Guess yes with MSVC, no with mingw.
@@ -14163,18 +19032,19 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Good" >/dev/null 2>&1; then :
+  $EGREP "Good" >/dev/null 2>&1
+then :
   gl_cv_func_frexp_works="guessing yes"
-else
+else $as_nop
   gl_cv_func_frexp_works="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
              ;;
            *) gl_cv_func_frexp_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -14242,9 +19112,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_frexp_works=yes
-else
+else $as_nop
   gl_cv_func_frexp_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -14253,8 +19124,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_works" >&5
-$as_echo "$gl_cv_func_frexp_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_works" >&5
+printf "%s\n" "$gl_cv_func_frexp_works" >&6; }
 
     case "$gl_cv_func_frexp_works" in
       *yes) gl_func_frexp_no_libm=yes ;;
@@ -14266,7 +19137,7 @@
   fi
   if test $gl_func_frexp_no_libm = yes; then
 
-$as_echo "#define HAVE_FREXP_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_FREXP_IN_LIBC 1" >>confdefs.h
 
   fi
 
@@ -14287,69 +19158,77 @@
 
 
 
-          GNULIB_FREXP=1
 
 
 
 
+          GL_GNULIB_FREXP=1
 
-$as_echo "#define GNULIB_TEST_FREXP 1" >>confdefs.h
 
 
 
 
+printf "%s\n" "#define GNULIB_TEST_FREXP 1" >>confdefs.h
 
 
-      ac_fn_c_check_decl "$LINENO" "frexpl" "ac_cv_have_decl_frexpl" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_frexpl" = xyes; then :
 
-else
+
+
+
+      ac_fn_check_decl "$LINENO" "frexpl" "ac_cv_have_decl_frexpl" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_frexpl" = xyes
+then :
+
+else $as_nop
   HAVE_DECL_FREXPL=0
 fi
-
   if test $HAVE_DECL_FREXPL = 1; then
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexpl() can be used without linking with libm" >&5
-$as_echo_n "checking whether frexpl() can be used without linking with libm... " >&6; }
-if ${gl_cv_func_frexpl_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexpl() can be used without linking with libm" >&5
+printf %s "checking whether frexpl() can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_frexpl_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
              long double x;
 int
-main ()
+main (void)
 {
 int e; return frexpl (x, &e) > 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_frexpl_no_libm=yes
-else
+else $as_nop
   gl_cv_func_frexpl_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_no_libm" >&5
-$as_echo "$gl_cv_func_frexpl_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_no_libm" >&5
+printf "%s\n" "$gl_cv_func_frexpl_no_libm" >&6; }
 
     if test $gl_cv_func_frexpl_no_libm = yes; then
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexpl works" >&5
-$as_echo_n "checking whether frexpl works... " >&6; }
-if ${gl_cv_func_frexpl_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexpl works" >&5
+printf %s "checking whether frexpl works... " >&6; }
+if test ${gl_cv_func_frexpl_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            aix | aix3-6* | beos* | darwin* | irix* | mingw* | pw*)
@@ -14357,7 +19236,7 @@
            *) gl_cv_func_frexpl_works="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -14387,6 +19266,7 @@
 "C"
 #endif
 long double frexpl (long double, int *);
+long double zero = 0.0L;
 int main()
 {
   int result = 0;
@@ -14444,7 +19324,8 @@
       }
   }
   /* Test on infinite numbers.  */
-  x = 1.0L / 0.0L;
+  /* The Microsoft MSVC 14 compiler chokes on the expression 1.0 / 0.0.  */
+  x = 1.0L / zero;
   {
     int exp;
     long double y = frexpl (x, &exp);
@@ -14454,9 +19335,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_frexpl_works=yes
-else
+else $as_nop
   gl_cv_func_frexpl_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -14465,8 +19347,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_works" >&5
-$as_echo "$gl_cv_func_frexpl_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_works" >&5
+printf "%s\n" "$gl_cv_func_frexpl_works" >&6; }
 
       case "$gl_cv_func_frexpl_works" in
         *yes) gl_func_frexpl_no_libm=yes ;;
@@ -14478,7 +19360,7 @@
     fi
     if test $gl_func_frexpl_no_libm = yes; then
 
-$as_echo "#define HAVE_FREXPL_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_FREXPL_IN_LIBC 1" >>confdefs.h
 
     fi
   fi
@@ -14500,44 +19382,121 @@
 
 
 
-          GNULIB_FREXPL=1
 
 
 
 
+          GL_GNULIB_FREXPL=1
 
-$as_echo "#define GNULIB_TEST_FREXPL 1" >>confdefs.h
 
 
 
 
+printf "%s\n" "#define GNULIB_TEST_FREXPL 1" >>confdefs.h
 
 
-  if test $ac_cv_func___fseterr = no; then
 
 
 
 
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for __fseterr" >&5
+printf %s "checking for __fseterr... " >&6; }
+if test ${gl_cv_onwards_func___fseterr+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
+  exec 9>&6 6>/dev/null
 
+       case "$host_os" in
+         linux*-android*)
+           ac_fn_check_decl "$LINENO" "__fseterr" "ac_cv_have_decl___fseterr" "#include <stdio.h>
+      #include <stdio_ext.h>
 
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl___fseterr" = xyes
+then :
 
-  gl_LIBOBJS="$gl_LIBOBJS fseterr.$ac_objext"
+fi
+           if test $ac_cv_have_decl___fseterr = yes; then
+             ac_fn_c_check_func "$LINENO" "__fseterr" "ac_cv_func___fseterr"
+if test "x$ac_cv_func___fseterr" = xyes
+then :
+
+fi
+
+             if test $ac_cv_func___fseterr = yes; then
+               gl_cv_onwards_func___fseterr=yes
+             else
+                                                            gl_cv_onwards_func___fseterr='future OS version'
+             fi
+           else
+             gl_cv_onwards_func___fseterr='future OS version'
+           fi
+           ;;
+         *)
+           ac_fn_c_check_func "$LINENO" "__fseterr" "ac_cv_func___fseterr"
+if test "x$ac_cv_func___fseterr" = xyes
+then :
+
+fi
+
+           gl_cv_onwards_func___fseterr=$ac_cv_func___fseterr
+           ;;
+       esac
+
+  exec 6>&9 9>&-
+
+
+fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_onwards_func___fseterr" >&5
+printf "%s\n" "$gl_cv_onwards_func___fseterr" >&6; }
+  case "$gl_cv_onwards_func___fseterr" in
+    future*) ac_cv_func___fseterr=no ;;
+    *)       ac_cv_func___fseterr=$gl_cv_onwards_func___fseterr ;;
+  esac
+  if test $ac_cv_func___fseterr = yes; then
+
+printf "%s\n" "#define HAVE___FSETERR 1" >>confdefs.h
 
   fi
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether isnan(double) can be used without linking with libm" >&5
-$as_echo_n "checking whether isnan(double) can be used without linking with libm... " >&6; }
-if ${gl_cv_func_isnand_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
+     if test $ac_cv_func___fseterr = no; then
+  GL_COND_OBJ_FSETERR_TRUE=
+  GL_COND_OBJ_FSETERR_FALSE='#'
 else
+  GL_COND_OBJ_FSETERR_TRUE='#'
+  GL_COND_OBJ_FSETERR_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_FSETERR_TRUE}" && test -z "${GL_COND_OBJ_FSETERR_FALSE}"; then
+    GL_COND_OBJ_FSETERR_TRUE='#'
+    GL_COND_OBJ_FSETERR_FALSE='#'
+  fi
+
+
+
+
+
+
+
+
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether isnan(double) can be used without linking with libm" >&5
+printf %s "checking whether isnan(double) can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_isnand_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnand
              # define isnand(x) __builtin_isnan ((double)(x))
              #else
@@ -14546,29 +19505,30 @@
              #endif
              double x;
 int
-main ()
+main (void)
 {
 return isnand (x);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_isnand_no_libm=yes
-else
+else $as_nop
   gl_cv_func_isnand_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnand_no_libm" >&5
-$as_echo "$gl_cv_func_isnand_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnand_no_libm" >&5
+printf "%s\n" "$gl_cv_func_isnand_no_libm" >&6; }
 
   gl_func_isnand_no_libm=$gl_cv_func_isnand_no_libm
   if test $gl_cv_func_isnand_no_libm = yes; then
 
-$as_echo "#define HAVE_ISNAND_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ISNAND_IN_LIBC 1" >>confdefs.h
 
   fi
 
@@ -14589,54 +19549,58 @@
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether isnan(float) can be used without linking with libm" >&5
-$as_echo_n "checking whether isnan(float) can be used without linking with libm... " >&6; }
-if ${gl_cv_func_isnanf_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether isnan(float) can be used without linking with libm" >&5
+printf %s "checking whether isnan(float) can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_isnanf_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanf
-             # define isnanf(x) __builtin_isnanf ((float)(x))
+             # define isnanf(x) __builtin_isnan ((float)(x))
              #elif defined isnan
              # undef isnanf
              # define isnanf(x) isnan ((float)(x))
              #endif
              float x;
 int
-main ()
+main (void)
 {
 return isnanf (x);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_isnanf_no_libm=yes
-else
+else $as_nop
   gl_cv_func_isnanf_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanf_no_libm" >&5
-$as_echo "$gl_cv_func_isnanf_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanf_no_libm" >&5
+printf "%s\n" "$gl_cv_func_isnanf_no_libm" >&6; }
 
   if test $gl_cv_func_isnanf_no_libm = yes; then
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether isnan(float) works" >&5
-$as_echo_n "checking whether isnan(float) works... " >&6; }
-if ${gl_cv_func_isnanf_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether isnan(float) works" >&5
+printf %s "checking whether isnan(float) works... " >&6; }
+if test ${gl_cv_func_isnanf_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
            irix* | solaris*) gl_cv_func_isnanf_works="guessing no" ;;
            mingw*) # Guess yes on mingw, no on MSVC.
@@ -14649,25 +19613,26 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_isnanf_works="guessing yes"
-else
+else $as_nop
   gl_cv_func_isnanf_works="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
              ;;
            *) gl_cv_func_isnanf_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #include <math.h>
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # undef isnanf
-# define isnanf(x) __builtin_isnanf ((float)(x))
+# define isnanf(x) __builtin_isnan ((float)(x))
 #elif defined isnan
 # undef isnanf
 # define isnanf(x) isnan ((float)(x))
@@ -14707,7 +19672,7 @@
       m.value = NaN ();
       /* Set the bits below the exponent to 01111...111.  */
       m.word0 &= -1U << FLT_EXPBIT0_BIT;
-      m.word0 |= 1U << (FLT_EXPBIT0_BIT - 1) - 1;
+      m.word0 |= (1U << (FLT_EXPBIT0_BIT - 1)) - 1;
       if (!isnanf (m.value))
         result |= 4;
     }
@@ -14716,9 +19681,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_isnanf_works=yes
-else
+else $as_nop
   gl_cv_func_isnanf_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -14727,8 +19693,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanf_works" >&5
-$as_echo "$gl_cv_func_isnanf_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanf_works" >&5
+printf "%s\n" "$gl_cv_func_isnanf_works" >&6; }
 
   fi
   if test $gl_cv_func_isnanf_no_libm = yes \
@@ -14739,7 +19705,7 @@
         }; then
     gl_func_isnanf_no_libm=yes
 
-$as_echo "#define HAVE_ISNANF_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ISNANF_IN_LIBC 1" >>confdefs.h
 
   else
     gl_func_isnanf_no_libm=no
@@ -14758,15 +19724,17 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'float'" >&5
-$as_echo_n "checking where to find the exponent in a 'float'... " >&6; }
-if ${gl_cv_cc_float_expbit0+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'float'" >&5
+printf %s "checking where to find the exponent in a 'float'... " >&6; }
+if test ${gl_cv_cc_float_expbit0+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   gl_cv_cc_float_expbit0="word 0 bit 23"
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -14835,9 +19803,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_float_expbit0=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_float_expbit0="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -14847,21 +19816,17 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_expbit0" >&5
-$as_echo "$gl_cv_cc_float_expbit0" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_expbit0" >&5
+printf "%s\n" "$gl_cv_cc_float_expbit0" >&6; }
   case "$gl_cv_cc_float_expbit0" in
     word*bit*)
       word=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_float_expbit0" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_EXPBIT0_WORD $word
-_ACEOF
+printf "%s\n" "#define FLT_EXPBIT0_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_EXPBIT0_BIT $bit
-_ACEOF
+printf "%s\n" "#define FLT_EXPBIT0_BIT $bit" >>confdefs.h
 
       ;;
   esac
@@ -14870,42 +19835,44 @@
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether isnan(long double) can be used without linking with libm" >&5
-$as_echo_n "checking whether isnan(long double) can be used without linking with libm... " >&6; }
-if ${gl_cv_func_isnanl_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether isnan(long double) can be used without linking with libm" >&5
+printf %s "checking whether isnan(long double) can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_isnanl_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanl
-             # define isnanl(x) __builtin_isnanl ((long double)(x))
+             # define isnanl(x) __builtin_isnan ((long double)(x))
              #elif defined isnan
              # undef isnanl
              # define isnanl(x) isnan ((long double)(x))
              #endif
              long double x;
 int
-main ()
+main (void)
 {
 return isnanl (x);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_isnanl_no_libm=yes
-else
+else $as_nop
   gl_cv_func_isnanl_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanl_no_libm" >&5
-$as_echo "$gl_cv_func_isnanl_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanl_no_libm" >&5
+printf "%s\n" "$gl_cv_func_isnanl_no_libm" >&6; }
 
   gl_func_isnanl_no_libm=$gl_cv_func_isnanl_no_libm
   if test $gl_func_isnanl_no_libm = yes; then
@@ -14913,13 +19880,15 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether isnanl works" >&5
-$as_echo_n "checking whether isnanl works... " >&6; }
-if ${gl_cv_func_isnanl_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether isnanl works" >&5
+printf %s "checking whether isnanl works... " >&6; }
+if test ${gl_cv_func_isnanl_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
            mingw*) # Guess yes on mingw, no on MSVC.
              cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -14931,27 +19900,28 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_func_isnanl_works="guessing yes"
-else
+else $as_nop
   gl_cv_func_isnanl_works="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
              ;;
            *) gl_cv_func_isnanl_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #include <float.h>
 #include <limits.h>
 #include <math.h>
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # undef isnanl
-# define isnanl(x) __builtin_isnanl ((long double)(x))
+# define isnanl(x) __builtin_isnan ((long double)(x))
 #elif defined isnan
 # undef isnanl
 # define isnanl(x) isnan ((long double)(x))
@@ -15056,9 +20026,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_isnanl_works=yes
-else
+else $as_nop
   gl_cv_func_isnanl_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -15067,8 +20038,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanl_works" >&5
-$as_echo "$gl_cv_func_isnanl_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_isnanl_works" >&5
+printf "%s\n" "$gl_cv_func_isnanl_works" >&6; }
 
     case "$gl_cv_func_isnanl_works" in
       *yes) ;;
@@ -15077,7 +20048,7 @@
   fi
   if test $gl_func_isnanl_no_libm = yes; then
 
-$as_echo "#define HAVE_ISNANL_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ISNANL_IN_LIBC 1" >>confdefs.h
 
   fi
 
@@ -15095,13 +20066,15 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'long double'" >&5
-$as_echo_n "checking where to find the exponent in a 'long double'... " >&6; }
-if ${gl_cv_cc_long_double_expbit0+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the exponent in a 'long double'" >&5
+printf %s "checking where to find the exponent in a 'long double'... " >&6; }
+if test ${gl_cv_cc_long_double_expbit0+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
                               gl_cv_cc_long_double_expbit0="unknown"
           case "$host_os" in
@@ -15116,10 +20089,11 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_cc_long_double_expbit0="word 2 bit 0"
 fi
-rm -f conftest*
+rm -rf conftest*
 
               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -15130,15 +20104,16 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Known" >/dev/null 2>&1; then :
+  $EGREP "Known" >/dev/null 2>&1
+then :
   gl_cv_cc_long_double_expbit0="word 1 bit 20"
 fi
-rm -f conftest*
+rm -rf conftest*
 
               ;;
           esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -15152,14 +20127,14 @@
         memory_long_double;
 static unsigned int ored_wordsNWORDS;
 static unsigned int anded_wordsNWORDS;
-static void add_to_ored_words (long double x)
+static void add_to_ored_words (long double *x)
 {
   memory_long_double m;
   size_t i;
   /* Clear it first, in case
      sizeof (long double) < sizeof (memory_long_double).  */
   memset (&m, 0, sizeof (memory_long_double));
-  m.value = x;
+  m.value = *x;
   for (i = 0; i < NWORDS; i++)
     {
       ored_wordsi |= m.wordi;
@@ -15168,17 +20143,15 @@
 }
 int main ()
 {
+  static long double samples5 = { 0.25L, 0.5L, 1.0L, 2.0L, 4.0L };
   size_t j;
   FILE *fp = fopen ("conftest.out", "w");
   if (fp == NULL)
     return 1;
   for (j = 0; j < NWORDS; j++)
     anded_wordsj = ~ (unsigned int) 0;
-  add_to_ored_words (0.25L);
-  add_to_ored_words (0.5L);
-  add_to_ored_words (1.0L);
-  add_to_ored_words (2.0L);
-  add_to_ored_words (4.0L);
+  for (j = 0; j < 5; j++)
+    add_to_ored_words (&samplesj);
   /* Remove bits that are common (e.g. if representation of the first mantissa
      bit is explicit).  */
   for (j = 0; j < NWORDS; j++)
@@ -15208,9 +20181,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_long_double_expbit0=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_long_double_expbit0="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -15220,21 +20194,17 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_long_double_expbit0" >&5
-$as_echo "$gl_cv_cc_long_double_expbit0" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_long_double_expbit0" >&5
+printf "%s\n" "$gl_cv_cc_long_double_expbit0" >&6; }
   case "$gl_cv_cc_long_double_expbit0" in
     word*bit*)
       word=`echo "$gl_cv_cc_long_double_expbit0" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_long_double_expbit0" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define LDBL_EXPBIT0_WORD $word
-_ACEOF
+printf "%s\n" "#define LDBL_EXPBIT0_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define LDBL_EXPBIT0_BIT $bit
-_ACEOF
+printf "%s\n" "#define LDBL_EXPBIT0_BIT $bit" >>confdefs.h
 
       ;;
   esac
@@ -15247,15 +20217,29 @@
 
 
 
+  case "$GL_GENERATE_LIMITS_H" in
+    false) LIMITS_H='' ;;
+    true)
+                  if test -z "$LIMITS_H"; then
+        LIMITS_H="${gl_source_base_prefix}limits.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_LIMITS_H is not set correctly" 1>&2; exit 1 ;;
+  esac
 
 
-
-
-    LOCALCHARSET_TESTS_ENVIRONMENT=
-
-
-
-
+     if $GL_GENERATE_LIMITS_H; then
+  GL_GENERATE_LIMITS_H_TRUE=
+  GL_GENERATE_LIMITS_H_FALSE='#'
+else
+  GL_GENERATE_LIMITS_H_TRUE='#'
+  GL_GENERATE_LIMITS_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_LIMITS_H_TRUE}" && test -z "${GL_GENERATE_LIMITS_H_FALSE}"; then
+    GL_GENERATE_LIMITS_H_TRUE='#'
+    GL_GENERATE_LIMITS_H_FALSE='#'
+  fi
 
 
 
@@ -15264,186 +20248,70 @@
 
 
 
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_math_h='<'math.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <math.h>" >&5
-$as_echo_n "checking absolute name of <math.h>... " >&6; }
-if ${gl_cv_next_math_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
 
-             if test $ac_cv_header_math_h = yes; then
 
 
 
 
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <math.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
 
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
-      ;;
-  esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'math.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
+    LOCALCHARSET_TESTS_ENVIRONMENT=
 
-        gl_cv_absolute_math_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_math_h
-           gl_cv_next_math_h='"'$gl_header'"'
-          else
-               gl_cv_next_math_h='<'math.h'>'
-             fi
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_math_h" >&5
-$as_echo "$gl_cv_next_math_h" >&6; }
-     fi
-     NEXT_MATH_H=$gl_cv_next_math_h
 
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'math.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_math_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_MATH_H=$gl_next_as_first_directive
 
 
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether NAN macro works" >&5
-$as_echo_n "checking whether NAN macro works... " >&6; }
-if ${gl_cv_header_math_nan_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <math.h>
-int
-main ()
-{
-/* Solaris 10 has a broken definition of NAN.  Other platforms
-        fail to provide NAN, or provide it only in C99 mode; this
-        test only needs to fail when NAN is provided but wrong.  */
-         float f = 1.0f;
-#ifdef NAN
-         f = NAN;
-#endif
-         return f == 0;
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_header_math_nan_works=yes
-else
-  gl_cv_header_math_nan_works=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_math_nan_works" >&5
-$as_echo "$gl_cv_header_math_nan_works" >&6; }
-  if test $gl_cv_header_math_nan_works = no; then
-    REPLACE_NAN=1
-  fi
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether HUGE_VAL works" >&5
-$as_echo_n "checking whether HUGE_VAL works... " >&6; }
-if ${gl_cv_header_math_huge_val_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <math.h>
-int
-main ()
-{
-/* Solaris 10 has a broken definition of HUGE_VAL.  */
-         double d = HUGE_VAL;
-         return d == 0;
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_header_math_huge_val_works=yes
+     if test $REPLACE_MEMCHR = 1; then
+  GL_COND_OBJ_MEMCHR_TRUE=
+  GL_COND_OBJ_MEMCHR_FALSE='#'
 else
-  gl_cv_header_math_huge_val_works=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+  GL_COND_OBJ_MEMCHR_TRUE='#'
+  GL_COND_OBJ_MEMCHR_FALSE=
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_header_math_huge_val_works" >&5
-$as_echo "$gl_cv_header_math_huge_val_works" >&6; }
-  if test $gl_cv_header_math_huge_val_works = no; then
-    REPLACE_HUGE_VAL=1
+:
+    if test -z "${GL_COND_OBJ_MEMCHR_TRUE}" && test -z "${GL_COND_OBJ_MEMCHR_FALSE}"; then
+    GL_COND_OBJ_MEMCHR_TRUE='#'
+    GL_COND_OBJ_MEMCHR_FALSE='#'
   fi
 
+  if test -z "$GL_COND_OBJ_MEMCHR_TRUE"; then :
 
 
+  ac_fn_c_check_header_compile "$LINENO" "bp-sym.h" "ac_cv_header_bp_sym_h" "$ac_includes_default"
+if test "x$ac_cv_header_bp_sym_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_BP_SYM_H 1" >>confdefs.h
 
-
-
-  if test $HAVE_MEMCHR = 0 || test $REPLACE_MEMCHR = 1; then
-
-
-
+fi
 
 
 
+fi
 
 
-  gl_LIBOBJS="$gl_LIBOBJS memchr.$ac_objext"
 
 
-  for ac_header in bp-sym.h
-do :
-  ac_fn_c_check_header_mongrel "$LINENO" "bp-sym.h" "ac_cv_header_bp_sym_h" "$ac_includes_default"
-if test "x$ac_cv_header_bp_sym_h" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_BP_SYM_H 1
-_ACEOF
 
-fi
 
-done
 
 
-  fi
 
 
 
 
 
-          GNULIB_MEMCHR=1
 
+          GL_GNULIB_MEMCHR=1
 
 
 
 
-$as_echo "#define GNULIB_TEST_MEMCHR 1" >>confdefs.h
 
+printf "%s\n" "#define GNULIB_TEST_MEMCHR 1" >>confdefs.h
 
 
 
@@ -15454,13 +20322,15 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexp works" >&5
-$as_echo_n "checking whether frexp works... " >&6; }
-if ${gl_cv_func_frexp_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexp works" >&5
+printf %s "checking whether frexp works... " >&6; }
+if test ${gl_cv_func_frexp_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
            netbsd* | irix*) gl_cv_func_frexp_works="guessing no" ;;
            mingw*) # Guess yes with MSVC, no with mingw.
@@ -15473,18 +20343,19 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Good" >/dev/null 2>&1; then :
+  $EGREP "Good" >/dev/null 2>&1
+then :
   gl_cv_func_frexp_works="guessing yes"
-else
+else $as_nop
   gl_cv_func_frexp_works="guessing no"
 fi
-rm -f conftest*
+rm -rf conftest*
 
              ;;
            *) gl_cv_func_frexp_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -15552,9 +20423,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_frexp_works=yes
-else
+else $as_nop
   gl_cv_func_frexp_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -15563,23 +20435,24 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_works" >&5
-$as_echo "$gl_cv_func_frexp_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexp_works" >&5
+printf "%s\n" "$gl_cv_func_frexp_works" >&6; }
 
     case "$gl_cv_func_frexp_works" in
       *yes)
 
-$as_echo "#define HAVE_FREXP_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_FREXP_IN_LIBC 1" >>confdefs.h
 
         ;;
     esac
   fi
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ldexp can be used without linking with libm" >&5
-$as_echo_n "checking whether ldexp can be used without linking with libm... " >&6; }
-if ${gl_cv_func_ldexp_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ldexp can be used without linking with libm" >&5
+printf %s "checking whether ldexp can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_ldexp_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -15587,27 +20460,28 @@
              double x;
              int y;
 int
-main ()
+main (void)
 {
 return ldexp (x, y) < 1;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_ldexp_no_libm=yes
-else
+else $as_nop
   gl_cv_func_ldexp_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexp_no_libm" >&5
-$as_echo "$gl_cv_func_ldexp_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexp_no_libm" >&5
+printf "%s\n" "$gl_cv_func_ldexp_no_libm" >&6; }
   if test $gl_cv_func_ldexp_no_libm = yes; then
 
-$as_echo "#define HAVE_LDEXP_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_LDEXP_IN_LIBC 1" >>confdefs.h
 
   fi
 
@@ -15616,46 +20490,50 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexpl() can be used without linking with libm" >&5
-$as_echo_n "checking whether frexpl() can be used without linking with libm... " >&6; }
-if ${gl_cv_func_frexpl_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexpl() can be used without linking with libm" >&5
+printf %s "checking whether frexpl() can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_frexpl_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
              long double x;
 int
-main ()
+main (void)
 {
 int e; return frexpl (x, &e) > 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_frexpl_no_libm=yes
-else
+else $as_nop
   gl_cv_func_frexpl_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_no_libm" >&5
-$as_echo "$gl_cv_func_frexpl_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_no_libm" >&5
+printf "%s\n" "$gl_cv_func_frexpl_no_libm" >&6; }
 
   if test $gl_cv_func_frexpl_no_libm = yes; then
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether frexpl works" >&5
-$as_echo_n "checking whether frexpl works... " >&6; }
-if ${gl_cv_func_frexpl_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether frexpl works" >&5
+printf %s "checking whether frexpl works... " >&6; }
+if test ${gl_cv_func_frexpl_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            aix | aix3-6* | beos* | darwin* | irix* | mingw* | pw*)
@@ -15663,7 +20541,7 @@
            *) gl_cv_func_frexpl_works="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -15693,6 +20571,7 @@
 "C"
 #endif
 long double frexpl (long double, int *);
+long double zero = 0.0L;
 int main()
 {
   int result = 0;
@@ -15750,7 +20629,8 @@
       }
   }
   /* Test on infinite numbers.  */
-  x = 1.0L / 0.0L;
+  /* The Microsoft MSVC 14 compiler chokes on the expression 1.0 / 0.0.  */
+  x = 1.0L / zero;
   {
     int exp;
     long double y = frexpl (x, &exp);
@@ -15760,9 +20640,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_frexpl_works=yes
-else
+else $as_nop
   gl_cv_func_frexpl_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -15771,8 +20652,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_works" >&5
-$as_echo "$gl_cv_func_frexpl_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_frexpl_works" >&5
+printf "%s\n" "$gl_cv_func_frexpl_works" >&6; }
 
     case "$gl_cv_func_frexpl_works" in
       *yes) gl_func_frexpl_no_libm=yes ;;
@@ -15784,59 +20665,63 @@
   fi
   if test $gl_func_frexpl_no_libm = yes; then
 
-$as_echo "#define HAVE_FREXPL_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_FREXPL_IN_LIBC 1" >>confdefs.h
 
-            ac_fn_c_check_decl "$LINENO" "frexpl" "ac_cv_have_decl_frexpl" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_frexpl" = xyes; then :
+            ac_fn_check_decl "$LINENO" "frexpl" "ac_cv_have_decl_frexpl" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_frexpl" = xyes
+then :
 
-else
+else $as_nop
   HAVE_DECL_FREXPL=0
 fi
-
   fi
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ldexpl() can be used without linking with libm" >&5
-$as_echo_n "checking whether ldexpl() can be used without linking with libm... " >&6; }
-if ${gl_cv_func_ldexpl_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ldexpl() can be used without linking with libm" >&5
+printf %s "checking whether ldexpl() can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_ldexpl_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
              long double x;
 int
-main ()
+main (void)
 {
 return ldexpl (x, -1) > 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_ldexpl_no_libm=yes
-else
+else $as_nop
   gl_cv_func_ldexpl_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexpl_no_libm" >&5
-$as_echo "$gl_cv_func_ldexpl_no_libm" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexpl_no_libm" >&5
+printf "%s\n" "$gl_cv_func_ldexpl_no_libm" >&6; }
 
   if test $gl_cv_func_ldexpl_no_libm = yes; then
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ldexpl works" >&5
-$as_echo_n "checking whether ldexpl works... " >&6; }
-if ${gl_cv_func_ldexpl_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ldexpl works" >&5
+printf %s "checking whether ldexpl works... " >&6; }
+if test ${gl_cv_func_ldexpl_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            aix | aix3-6*) gl_cv_func_ldexpl_works="guessing no" ;;
@@ -15845,7 +20730,7 @@
            *)               gl_cv_func_ldexpl_works="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -15873,9 +20758,10 @@
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_ldexpl_works=yes
-else
+else $as_nop
   gl_cv_func_ldexpl_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -15884,22 +20770,22 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexpl_works" >&5
-$as_echo "$gl_cv_func_ldexpl_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_ldexpl_works" >&5
+printf "%s\n" "$gl_cv_func_ldexpl_works" >&6; }
 
     case "$gl_cv_func_ldexpl_works" in
       *yes)
 
-$as_echo "#define HAVE_LDEXPL_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_LDEXPL_IN_LIBC 1" >>confdefs.h
 
-                        ac_fn_c_check_decl "$LINENO" "ldexpl" "ac_cv_have_decl_ldexpl" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_ldexpl" = xyes; then :
+                        ac_fn_check_decl "$LINENO" "ldexpl" "ac_cv_have_decl_ldexpl" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_ldexpl" = xyes
+then :
 
-else
+else $as_nop
   HAVE_DECL_LDEXPL=0
 fi
-
         ;;
     esac
   fi
@@ -15907,23 +20793,28 @@
 
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking for signbit macro" >&5
-$as_echo_n "checking for signbit macro... " >&6; }
-if ${gl_cv_func_signbit+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
 
-      if test "$cross_compiling" = yes; then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for signbit macro" >&5
+printf %s "checking for signbit macro... " >&6; }
+if test ${gl_cv_func_signbit+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
                           # Guess yes on glibc systems.
            *-gnu* | gnu*) gl_cv_func_signbit="guessing yes" ;;
+                          # Guess yes on musl systems.
+           *-musl*)       gl_cv_func_signbit="guessing yes" ;;
                           # Guess yes on native Windows.
            mingw*)        gl_cv_func_signbit="guessing yes" ;;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_signbit="guessing no" ;;
+                          # If we don't know, obey --enable-cross-guesses.
+           *)             gl_cv_func_signbit="$gl_cross_guess_normal" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16014,9 +20905,10 @@
 
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_signbit=yes
-else
+else $as_nop
   gl_cv_func_signbit=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16025,34 +20917,38 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_signbit" >&5
-$as_echo "$gl_cv_func_signbit" >&6; }
-          { $as_echo "$as_me:${as_lineno-$LINENO}: checking for signbit compiler built-ins" >&5
-$as_echo_n "checking for signbit compiler built-ins... " >&6; }
-if ${gl_cv_func_signbit_gcc+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_signbit" >&5
+printf "%s\n" "$gl_cv_func_signbit" >&6; }
+          { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for signbit compiler built-ins" >&5
+printf %s "checking for signbit compiler built-ins... " >&6; }
+if test ${gl_cv_func_signbit_builtins+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
                           # Guess yes on glibc systems.
-           *-gnu* | gnu*) gl_cv_func_signbit_gcc="guessing yes" ;;
+           *-gnu* | gnu*) gl_cv_func_signbit_builtins="guessing yes" ;;
+                          # Guess yes on musl systems.
+           *-musl*)       gl_cv_func_signbit_builtins="guessing yes" ;;
                           # Guess yes on mingw, no on MSVC.
            mingw*)        if test -n "$GCC"; then
-                            gl_cv_func_signbit_gcc="guessing yes"
+                            gl_cv_func_signbit_builtins="guessing yes"
                           else
-                            gl_cv_func_signbit_gcc="guessing no"
+                            gl_cv_func_signbit_builtins="guessing no"
                           fi
                           ;;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_signbit_gcc="guessing no" ;;
+                          # If we don't know, obey --enable-cross-guesses.
+           *)             gl_cv_func_signbit_builtins="$gl_cross_guess_normal" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # define signbit(x) \
    (sizeof (x) == sizeof (long double) ? __builtin_signbitl (x) : \
     sizeof (x) == sizeof (double) ? __builtin_signbit (x) : \
@@ -16136,10 +21032,11 @@
 
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  gl_cv_func_signbit_gcc=yes
-else
-  gl_cv_func_signbit_gcc=no
+if ac_fn_c_try_run "$LINENO"
+then :
+  gl_cv_func_signbit_builtins=yes
+else $as_nop
+  gl_cv_func_signbit_builtins=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
   conftest.$ac_objext conftest.beam conftest.$ac_ext
@@ -16147,30 +21044,42 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_signbit_gcc" >&5
-$as_echo "$gl_cv_func_signbit_gcc" >&6; }
-      case "$gl_cv_func_signbit_gcc" in
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_signbit_builtins" >&5
+printf "%s\n" "$gl_cv_func_signbit_builtins" >&6; }
+      case "$gl_cv_func_signbit_builtins" in
     *yes)
-      REPLACE_SIGNBIT_USING_GCC=1
+      REPLACE_SIGNBIT_USING_BUILTINS=1
       ;;
     *)
       case "$gl_cv_func_signbit" in
         *yes) ;;
         *)
                     REPLACE_SIGNBIT=1
+          ;;
+      esac
+      ;;
+  esac
+          case "$host_os" in
+    solaris*)
+      REPLACE_SIGNBIT=1
+      ;;
+  esac
+  if test $REPLACE_SIGNBIT = 1; then
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'float'" >&5
-$as_echo_n "checking where to find the sign bit in a 'float'... " >&6; }
-if ${gl_cv_cc_float_signbit+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'float'" >&5
+printf %s "checking where to find the sign bit in a 'float'... " >&6; }
+if test ${gl_cv_cc_float_signbit+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
                               gl_cv_cc_float_signbit="unknown"
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16233,9 +21142,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_float_signbit=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_float_signbit="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16245,21 +21155,17 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_signbit" >&5
-$as_echo "$gl_cv_cc_float_signbit" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_float_signbit" >&5
+printf "%s\n" "$gl_cv_cc_float_signbit" >&6; }
   case "$gl_cv_cc_float_signbit" in
     word*bit*)
       word=`echo "$gl_cv_cc_float_signbit" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_float_signbit" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_SIGNBIT_WORD $word
-_ACEOF
+printf "%s\n" "#define FLT_SIGNBIT_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define FLT_SIGNBIT_BIT $bit
-_ACEOF
+printf "%s\n" "#define FLT_SIGNBIT_BIT $bit" >>confdefs.h
 
       ;;
   esac
@@ -16267,17 +21173,19 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'double'" >&5
-$as_echo_n "checking where to find the sign bit in a 'double'... " >&6; }
-if ${gl_cv_cc_double_signbit+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'double'" >&5
+printf %s "checking where to find the sign bit in a 'double'... " >&6; }
+if test ${gl_cv_cc_double_signbit+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
                               gl_cv_cc_double_signbit="unknown"
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16340,9 +21248,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_double_signbit=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_double_signbit="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16352,21 +21261,17 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_double_signbit" >&5
-$as_echo "$gl_cv_cc_double_signbit" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_double_signbit" >&5
+printf "%s\n" "$gl_cv_cc_double_signbit" >&6; }
   case "$gl_cv_cc_double_signbit" in
     word*bit*)
       word=`echo "$gl_cv_cc_double_signbit" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_double_signbit" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define DBL_SIGNBIT_WORD $word
-_ACEOF
+printf "%s\n" "#define DBL_SIGNBIT_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define DBL_SIGNBIT_BIT $bit
-_ACEOF
+printf "%s\n" "#define DBL_SIGNBIT_BIT $bit" >>confdefs.h
 
       ;;
   esac
@@ -16374,17 +21279,19 @@
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'long double'" >&5
-$as_echo_n "checking where to find the sign bit in a 'long double'... " >&6; }
-if ${gl_cv_cc_long_double_signbit+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking where to find the sign bit in a 'long double'" >&5
+printf %s "checking where to find the sign bit in a 'long double'... " >&6; }
+if test ${gl_cv_cc_long_double_signbit+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
                               gl_cv_cc_long_double_signbit="unknown"
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16447,9 +21354,10 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_cc_long_double_signbit=`cat conftest.out`
-else
+else $as_nop
   gl_cv_cc_long_double_signbit="unknown"
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16459,248 +21367,223 @@
       rm -f conftest.out
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_long_double_signbit" >&5
-$as_echo "$gl_cv_cc_long_double_signbit" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_cc_long_double_signbit" >&5
+printf "%s\n" "$gl_cv_cc_long_double_signbit" >&6; }
   case "$gl_cv_cc_long_double_signbit" in
     word*bit*)
       word=`echo "$gl_cv_cc_long_double_signbit" | sed -e 's/word //' -e 's/ bit.*//'`
       bit=`echo "$gl_cv_cc_long_double_signbit" | sed -e 's/word.*bit //'`
 
-cat >>confdefs.h <<_ACEOF
-#define LDBL_SIGNBIT_WORD $word
-_ACEOF
+printf "%s\n" "#define LDBL_SIGNBIT_WORD $word" >>confdefs.h
 
 
-cat >>confdefs.h <<_ACEOF
-#define LDBL_SIGNBIT_BIT $bit
-_ACEOF
+printf "%s\n" "#define LDBL_SIGNBIT_BIT $bit" >>confdefs.h
 
       ;;
   esac
 
 
-          if test "$gl_cv_cc_float_signbit" = unknown; then
-                        ac_fn_c_check_decl "$LINENO" "copysignf" "ac_cv_have_decl_copysignf" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_copysignf" = xyes; then :
+    if test "$gl_cv_cc_float_signbit" = unknown; then
+            ac_fn_check_decl "$LINENO" "copysignf" "ac_cv_have_decl_copysignf" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_copysignf" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
+printf "%s\n" "#define HAVE_DECL_COPYSIGNF $ac_have_decl" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_COPYSIGNF $ac_have_decl
-_ACEOF
-
-            if test "$ac_cv_have_decl_copysignf" = yes; then
-                            { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether copysignf can be used without linking with libm" >&5
-$as_echo_n "checking whether copysignf can be used without linking with libm... " >&6; }
-if ${gl_cv_func_copysignf_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      if test "$ac_cv_have_decl_copysignf" = yes; then
+                { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether copysignf can be used without linking with libm" >&5
+printf %s "checking whether copysignf can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_copysignf_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-                  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+            cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-                         float x, y;
+                   float x, y;
 int
-main ()
+main (void)
 {
 return copysignf (x, y) < 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_copysignf_no_libm=yes
-else
+else $as_nop
   gl_cv_func_copysignf_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysignf_no_libm" >&5
-$as_echo "$gl_cv_func_copysignf_no_libm" >&6; }
-              if test $gl_cv_func_copysignf_no_libm = yes; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysignf_no_libm" >&5
+printf "%s\n" "$gl_cv_func_copysignf_no_libm" >&6; }
+        if test $gl_cv_func_copysignf_no_libm = yes; then
 
-$as_echo "#define HAVE_COPYSIGNF_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_COPYSIGNF_IN_LIBC 1" >>confdefs.h
 
-              fi
-            fi
-          fi
-          if test "$gl_cv_cc_double_signbit" = unknown; then
-                        ac_fn_c_check_decl "$LINENO" "copysign" "ac_cv_have_decl_copysign" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_copysign" = xyes; then :
+        fi
+      fi
+    fi
+    if test "$gl_cv_cc_double_signbit" = unknown; then
+            ac_fn_check_decl "$LINENO" "copysign" "ac_cv_have_decl_copysign" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_copysign" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
+printf "%s\n" "#define HAVE_DECL_COPYSIGN $ac_have_decl" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_COPYSIGN $ac_have_decl
-_ACEOF
-
-            if test "$ac_cv_have_decl_copysign" = yes; then
-                            { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether copysign can be used without linking with libm" >&5
-$as_echo_n "checking whether copysign can be used without linking with libm... " >&6; }
-if ${gl_cv_func_copysign_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      if test "$ac_cv_have_decl_copysign" = yes; then
+                { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether copysign can be used without linking with libm" >&5
+printf %s "checking whether copysign can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_copysign_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-                  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+            cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-                         double x, y;
+                   double x, y;
 int
-main ()
+main (void)
 {
 return copysign (x, y) < 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_copysign_no_libm=yes
-else
+else $as_nop
   gl_cv_func_copysign_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysign_no_libm" >&5
-$as_echo "$gl_cv_func_copysign_no_libm" >&6; }
-              if test $gl_cv_func_copysign_no_libm = yes; then
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysign_no_libm" >&5
+printf "%s\n" "$gl_cv_func_copysign_no_libm" >&6; }
+        if test $gl_cv_func_copysign_no_libm = yes; then
 
-$as_echo "#define HAVE_COPYSIGN_IN_LIBC 1" >>confdefs.h
+printf "%s\n" "#define HAVE_COPYSIGN_IN_LIBC 1" >>confdefs.h
 
-              fi
-            fi
-          fi
-          if test "$gl_cv_cc_long_double_signbit" = unknown; then
-                        ac_fn_c_check_decl "$LINENO" "copysignl" "ac_cv_have_decl_copysignl" "#include <math.h>
-"
-if test "x$ac_cv_have_decl_copysignl" = xyes; then :
+        fi
+      fi
+    fi
+    if test "$gl_cv_cc_long_double_signbit" = unknown; then
+            ac_fn_check_decl "$LINENO" "copysignl" "ac_cv_have_decl_copysignl" "#include <math.h>
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_copysignl" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
+printf "%s\n" "#define HAVE_DECL_COPYSIGNL $ac_have_decl" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_COPYSIGNL $ac_have_decl
-_ACEOF
-
-            if test "$ac_cv_have_decl_copysignl" = yes; then
-                            { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether copysignl can be used without linking with libm" >&5
-$as_echo_n "checking whether copysignl can be used without linking with libm... " >&6; }
-if ${gl_cv_func_copysignl_no_libm+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      if test "$ac_cv_have_decl_copysignl" = yes; then
+                { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether copysignl can be used without linking with libm" >&5
+printf %s "checking whether copysignl can be used without linking with libm... " >&6; }
+if test ${gl_cv_func_copysignl_no_libm+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-                  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+            cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <math.h>
-                         long double x, y;
+                   long double x, y;
 int
-main ()
+main (void)
 {
 return copysignl (x, y) < 0;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   gl_cv_func_copysignl_no_libm=yes
-else
+else $as_nop
   gl_cv_func_copysignl_no_libm=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysignl_no_libm" >&5
-$as_echo "$gl_cv_func_copysignl_no_libm" >&6; }
-              if test $gl_cv_func_copysignl_no_libm = yes; then
-
-$as_echo "#define HAVE_COPYSIGNL_IN_LIBC 1" >>confdefs.h
-
-              fi
-            fi
-          fi
-          ;;
-      esac
-      ;;
-  esac
-
-  if test $REPLACE_SIGNBIT = 1; then
-
-
-
-
-
-
-
-
-  gl_LIBOBJS="$gl_LIBOBJS signbitf.$ac_objext"
-
-
-
-
-
-
-
-
-
-  gl_LIBOBJS="$gl_LIBOBJS signbitd.$ac_objext"
-
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_copysignl_no_libm" >&5
+printf "%s\n" "$gl_cv_func_copysignl_no_libm" >&6; }
+        if test $gl_cv_func_copysignl_no_libm = yes; then
 
+printf "%s\n" "#define HAVE_COPYSIGNL_IN_LIBC 1" >>confdefs.h
 
+        fi
+      fi
+    fi
+  fi
 
 
+     if test $REPLACE_SIGNBIT = 1; then
+  GL_COND_OBJ_SIGNBIT3_TRUE=
+  GL_COND_OBJ_SIGNBIT3_FALSE='#'
+else
+  GL_COND_OBJ_SIGNBIT3_TRUE='#'
+  GL_COND_OBJ_SIGNBIT3_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_SIGNBIT3_TRUE}" && test -z "${GL_COND_OBJ_SIGNBIT3_FALSE}"; then
+    GL_COND_OBJ_SIGNBIT3_TRUE='#'
+    GL_COND_OBJ_SIGNBIT3_FALSE='#'
+  fi
 
 
 
 
-  gl_LIBOBJS="$gl_LIBOBJS signbitl.$ac_objext"
 
-  fi
 
 
 
 
 
-          GNULIB_SIGNBIT=1
+          GL_GNULIB_SIGNBIT=1
 
 
 
 
 
-$as_echo "#define GNULIB_TEST_SIGNBIT 1" >>confdefs.h
+printf "%s\n" "#define GNULIB_TEST_SIGNBIT 1" >>confdefs.h
 
 
 
 
-  for ac_header in stdint.h
-do :
-  ac_fn_c_check_header_mongrel "$LINENO" "stdint.h" "ac_cv_header_stdint_h" "$ac_includes_default"
-if test "x$ac_cv_header_stdint_h" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_STDINT_H 1
-_ACEOF
+  ac_fn_c_check_header_compile "$LINENO" "stdint.h" "ac_cv_header_stdint_h" "$ac_includes_default"
+if test "x$ac_cv_header_stdint_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STDINT_H 1" >>confdefs.h
 
 fi
 
-done
-
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for SIZE_MAX" >&5
-$as_echo_n "checking for SIZE_MAX... " >&6; }
-if ${gl_cv_size_max+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for SIZE_MAX" >&5
+printf %s "checking for SIZE_MAX... " >&6; }
+if test ${gl_cv_size_max+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-    gl_cv_size_max=
+    gl_cv_size_max=no
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16714,22 +21597,25 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Found it" >/dev/null 2>&1; then :
+  $EGREP "Found it" >/dev/null 2>&1
+then :
   gl_cv_size_max=yes
 fi
-rm -f conftest*
+rm -rf conftest*
 
-    if test -z "$gl_cv_size_max"; then
+    if test $gl_cv_size_max != yes; then
                         if ac_fn_c_compute_int "$LINENO" "sizeof (size_t) * CHAR_BIT - 1" "size_t_bits_minus_1"        "#include <stddef.h>
-#include <limits.h>"; then :
+#include <limits.h>"
+then :
 
-else
+else $as_nop
   size_t_bits_minus_1=
 fi
 
-      if ac_fn_c_compute_int "$LINENO" "sizeof (size_t) <= sizeof (unsigned int)" "fits_in_uint"        "#include <stddef.h>"; then :
+      if ac_fn_c_compute_int "$LINENO" "sizeof (size_t) <= sizeof (unsigned int)" "fits_in_uint"        "#include <stddef.h>"
+then :
 
-else
+else $as_nop
   fits_in_uint=
 fi
 
@@ -16742,17 +21628,18 @@
                  extern unsigned long foo;
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   fits_in_uint=0
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
         fi
                                 if test $fits_in_uint = 1; then
           gl_cv_size_max="(((1U << $size_t_bits_minus_1) - 1) * 2 + 1)"
@@ -16765,13 +21652,11 @@
     fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_size_max" >&5
-$as_echo "$gl_cv_size_max" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_size_max" >&5
+printf "%s\n" "$gl_cv_size_max" >&6; }
   if test "$gl_cv_size_max" != yes; then
 
-cat >>confdefs.h <<_ACEOF
-#define SIZE_MAX $gl_cv_size_max
-_ACEOF
+printf "%s\n" "#define SIZE_MAX $gl_cv_size_max" >>confdefs.h
 
   fi
 
@@ -16779,35 +21664,35 @@
 
 
   gl_cv_func_snprintf_usable=no
-  for ac_func in snprintf
-do :
   ac_fn_c_check_func "$LINENO" "snprintf" "ac_cv_func_snprintf"
-if test "x$ac_cv_func_snprintf" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_SNPRINTF 1
-_ACEOF
+if test "x$ac_cv_func_snprintf" = xyes
+then :
+  printf "%s\n" "#define HAVE_SNPRINTF 1" >>confdefs.h
 
 fi
-done
 
   if test $ac_cv_func_snprintf = yes; then
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether snprintf respects a size of 1" >&5
-$as_echo_n "checking whether snprintf respects a size of 1... " >&6; }
-if ${gl_cv_func_snprintf_size1+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether snprintf respects a size of 1" >&5
+printf %s "checking whether snprintf respects a size of 1... " >&6; }
+if test ${gl_cv_func_snprintf_size1+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
-                   # Guess yes on native Windows.
-           mingw*) gl_cv_func_snprintf_size1="guessing yes" ;;
-           *)      gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_snprintf_size1="guessing yes" ;;
+           *)               gl_cv_func_snprintf_size1="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16833,9 +21718,10 @@
   return buf1 != 'E';
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_snprintf_size1=yes
-else
+else $as_nop
   gl_cv_func_snprintf_size1=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16844,8 +21730,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_size1" >&5
-$as_echo "$gl_cv_func_snprintf_size1" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_size1" >&5
+printf "%s\n" "$gl_cv_func_snprintf_size1" >&6; }
 
     case "$gl_cv_func_snprintf_size1" in
       *yes)
@@ -16854,24 +21740,28 @@
           *yes)
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
-$as_echo_n "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
-if ${gl_cv_func_printf_positions+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
+printf %s "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
+if test ${gl_cv_func_printf_positions+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            netbsd1-3* | netbsdelf1-3* | netbsdaout1-3* | netbsdcoff1-3*)
-                         gl_cv_func_printf_positions="guessing no";;
-           beos*)        gl_cv_func_printf_positions="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_positions="guessing no";;
-           *)            gl_cv_func_printf_positions="guessing yes";;
+                            gl_cv_func_printf_positions="guessing no";;
+           beos*)           gl_cv_func_printf_positions="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_positions="guessing yes";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_positions="guessing no";;
+           *)               gl_cv_func_printf_positions="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -16887,9 +21777,10 @@
   return (strcmp (buf, "55 33") != 0);
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_positions=yes
-else
+else $as_nop
   gl_cv_func_printf_positions=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -16898,8 +21789,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
-$as_echo "$gl_cv_func_printf_positions" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
+printf "%s\n" "$gl_cv_func_printf_positions" >&6; }
 
             case "$gl_cv_func_printf_positions" in
               *yes)
@@ -16945,34 +21836,37 @@
 
 
 
-          GNULIB_SNPRINTF=1
 
 
 
 
+          GL_GNULIB_SNPRINTF=1
 
-$as_echo "#define GNULIB_TEST_SNPRINTF 1" >>confdefs.h
 
 
 
 
+printf "%s\n" "#define GNULIB_TEST_SNPRINTF 1" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define GNULIB_SNPRINTF 1
-_ACEOF
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for ssize_t" >&5
-$as_echo_n "checking for ssize_t... " >&6; }
-if ${gt_cv_ssize_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+printf "%s\n" "#define GNULIB_SNPRINTF 1" >>confdefs.h
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ssize_t" >&5
+printf %s "checking for ssize_t... " >&6; }
+if test ${gt_cv_ssize_t+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <sys/types.h>
 int
-main ()
+main (void)
 {
 int x = sizeof (ssize_t *) + sizeof (ssize_t);
             return !x;
@@ -16980,110 +21874,117 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   gt_cv_ssize_t=yes
-else
+else $as_nop
   gt_cv_ssize_t=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gt_cv_ssize_t" >&5
-$as_echo "$gt_cv_ssize_t" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gt_cv_ssize_t" >&5
+printf "%s\n" "$gt_cv_ssize_t" >&6; }
   if test $gt_cv_ssize_t = no; then
 
-$as_echo "#define ssize_t int" >>confdefs.h
+printf "%s\n" "#define ssize_t int" >>confdefs.h
 
   fi
 
 
 
 
-  STDDEF_H=
 
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for good max_align_t" >&5
-$as_echo_n "checking for good max_align_t... " >&6; }
-if ${gl_cv_type_max_align_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stddef.h>
-            unsigned int s = sizeof (max_align_t);
-            #if defined __GNUC__ || defined __IBM__ALIGNOF__
-            int check12 * (__alignof__ (double) <= __alignof__ (max_align_t)) - 1;
-            int check22 * (__alignof__ (long double) <= __alignof__ (max_align_t)) - 1;
-            #endif
+          if test "$ac_cv_header_stdbool_h" = yes; then
+    case "$host_os" in
+      solaris*)
+        if test -z "$GCC"; then
+          GL_GENERATE_STDBOOL_H=true
+        else
+          GL_GENERATE_STDBOOL_H=false
+        fi
+        ;;
+      *)
+        GL_GENERATE_STDBOOL_H=false
+        ;;
+    esac
+  else
+    GL_GENERATE_STDBOOL_H=true
+  fi
 
-int
-main ()
-{
+  if test "$ac_cv_type__Bool" = yes; then
+    HAVE__BOOL=1
+  else
+    HAVE__BOOL=0
+  fi
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_type_max_align_t=yes
-else
-  gl_cv_type_max_align_t=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_max_align_t" >&5
-$as_echo "$gl_cv_type_max_align_t" >&6; }
-  if test $gl_cv_type_max_align_t = no; then
-    HAVE_MAX_ALIGN_T=0
-    STDDEF_H=stddef.h
-  fi
 
-  if test $gt_cv_c_wchar_t = no; then
-    HAVE_WCHAR_T=0
-    STDDEF_H=stddef.h
-  fi
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether NULL can be used in arbitrary expressions" >&5
-$as_echo_n "checking whether NULL can be used in arbitrary expressions... " >&6; }
-if ${gl_cv_decl_null_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stddef.h>
-      int test2 * (sizeof NULL == sizeof (void *)) -1;
 
-int
-main ()
-{
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_decl_null_works=yes
+  case "$GL_GENERATE_STDBOOL_H" in
+    false) STDBOOL_H='' ;;
+    true)
+                  if test -z "$STDBOOL_H"; then
+        STDBOOL_H="${gl_source_base_prefix}stdbool.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_STDBOOL_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_STDBOOL_H; then
+  GL_GENERATE_STDBOOL_H_TRUE=
+  GL_GENERATE_STDBOOL_H_FALSE='#'
 else
-  gl_cv_decl_null_works=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+  GL_GENERATE_STDBOOL_H_TRUE='#'
+  GL_GENERATE_STDBOOL_H_FALSE=
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_decl_null_works" >&5
-$as_echo "$gl_cv_decl_null_works" >&6; }
-  if test $gl_cv_decl_null_works = no; then
-    REPLACE_NULL=1
-    STDDEF_H=stddef.h
+:
+    if test -z "${GL_GENERATE_STDBOOL_H_TRUE}" && test -z "${GL_GENERATE_STDBOOL_H_FALSE}"; then
+    GL_GENERATE_STDBOOL_H_TRUE='#'
+    GL_GENERATE_STDBOOL_H_FALSE='#'
   fi
 
 
-   if test -n "$STDDEF_H"; then
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+  case "$GL_GENERATE_STDDEF_H" in
+    false) STDDEF_H='' ;;
+    true)
+                  if test -z "$STDDEF_H"; then
+        STDDEF_H="${gl_source_base_prefix}stddef.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_STDDEF_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_STDDEF_H; then
   GL_GENERATE_STDDEF_H_TRUE=
   GL_GENERATE_STDDEF_H_FALSE='#'
 else
   GL_GENERATE_STDDEF_H_TRUE='#'
   GL_GENERATE_STDDEF_H_FALSE=
 fi
+:
+    if test -z "${GL_GENERATE_STDDEF_H_TRUE}" && test -z "${GL_GENERATE_STDDEF_H_FALSE}"; then
+    GL_GENERATE_STDDEF_H_TRUE='#'
+    GL_GENERATE_STDDEF_H_FALSE='#'
+  fi
 
-  if test -n "$STDDEF_H"; then
 
 
 
@@ -17092,75 +21993,105 @@
 
 
 
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_stddef_h='<'stddef.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <stddef.h>" >&5
-$as_echo_n "checking absolute name of <stddef.h>... " >&6; }
-if ${gl_cv_next_stddef_h+:} false; then :
-  $as_echo_n "(cached) " >&6
+
+
+  case "$GL_GENERATE_STDINT_H" in
+    false) STDINT_H='' ;;
+    true)
+                  if test -z "$STDINT_H"; then
+        STDINT_H="${gl_source_base_prefix}stdint.h"
+      fi
+      ;;
+    *) echo "*** GL_GENERATE_STDINT_H is not set correctly" 1>&2; exit 1 ;;
+  esac
+
+
+     if $GL_GENERATE_STDINT_H; then
+  GL_GENERATE_STDINT_H_TRUE=
+  GL_GENERATE_STDINT_H_FALSE='#'
 else
+  GL_GENERATE_STDINT_H_TRUE='#'
+  GL_GENERATE_STDINT_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_STDINT_H_TRUE}" && test -z "${GL_GENERATE_STDINT_H_FALSE}"; then
+    GL_GENERATE_STDINT_H_TRUE='#'
+    GL_GENERATE_STDINT_H_FALSE='#'
+  fi
 
 
 
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stddef.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
 
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
+
+
+
+
+
+  case "$GL_GENERATE_LIMITS_H" in
+    false) LIMITS_H='' ;;
+    true)
+                  if test -z "$LIMITS_H"; then
+        LIMITS_H="${gl_source_base_prefix}limits.h"
+      fi
       ;;
+    *) echo "*** GL_GENERATE_LIMITS_H is not set correctly" 1>&2; exit 1 ;;
   esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'stddef.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
 
-        gl_cv_absolute_stddef_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_stddef_h
-           gl_cv_next_stddef_h='"'$gl_header'"'
+     if $GL_GENERATE_LIMITS_H; then
+  GL_GENERATE_LIMITS_H_TRUE=
+  GL_GENERATE_LIMITS_H_FALSE='#'
+else
+  GL_GENERATE_LIMITS_H_TRUE='#'
+  GL_GENERATE_LIMITS_H_FALSE=
+fi
+:
+    if test -z "${GL_GENERATE_LIMITS_H_TRUE}" && test -z "${GL_GENERATE_LIMITS_H_FALSE}"; then
+    GL_GENERATE_LIMITS_H_TRUE='#'
+    GL_GENERATE_LIMITS_H_FALSE='#'
+  fi
+
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stddef_h" >&5
-$as_echo "$gl_cv_next_stddef_h" >&6; }
-     fi
-     NEXT_STDDEF_H=$gl_cv_next_stddef_h
 
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'stddef.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_stddef_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_STDDEF_H=$gl_next_as_first_directive
 
 
 
 
+
+
+
+
+
+
+     if test $REPLACE_STDIO_READ_FUNCS = 1; then
+  GL_COND_OBJ_STDIO_READ_TRUE=
+  GL_COND_OBJ_STDIO_READ_FALSE='#'
+else
+  GL_COND_OBJ_STDIO_READ_TRUE='#'
+  GL_COND_OBJ_STDIO_READ_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_STDIO_READ_TRUE}" && test -z "${GL_COND_OBJ_STDIO_READ_FALSE}"; then
+    GL_COND_OBJ_STDIO_READ_TRUE='#'
+    GL_COND_OBJ_STDIO_READ_FALSE='#'
   fi
 
 
+     if test $REPLACE_STDIO_WRITE_FUNCS = 1; then
+  GL_COND_OBJ_STDIO_WRITE_TRUE=
+  GL_COND_OBJ_STDIO_WRITE_FALSE='#'
+else
+  GL_COND_OBJ_STDIO_WRITE_TRUE='#'
+  GL_COND_OBJ_STDIO_WRITE_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_STDIO_WRITE_TRUE}" && test -z "${GL_COND_OBJ_STDIO_WRITE_FALSE}"; then
+    GL_COND_OBJ_STDIO_WRITE_TRUE='#'
+    GL_COND_OBJ_STDIO_WRITE_FALSE='#'
+  fi
 
 
-  $as_echo "#define __USE_MINGW_ANSI_STDIO 1" >>confdefs.h
 
 
 
@@ -17169,147 +22100,351 @@
 
 
 
+          GL_GNULIB_FSCANF=1
 
 
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_stdio_h='<'stdio.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <stdio.h>" >&5
-$as_echo_n "checking absolute name of <stdio.h>... " >&6; }
-if ${gl_cv_next_stdio_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
 
 
 
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stdio.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
+printf "%s\n" "#define GNULIB_TEST_FSCANF 1" >>confdefs.h
 
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
-      ;;
-  esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'stdio.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
 
-        gl_cv_absolute_stdio_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_stdio_h
-           gl_cv_next_stdio_h='"'$gl_header'"'
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_stdio_h" >&5
-$as_echo "$gl_cv_next_stdio_h" >&6; }
-     fi
-     NEXT_STDIO_H=$gl_cv_next_stdio_h
+printf "%s\n" "#define GNULIB_FSCANF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_SCANF=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_SCANF 1" >>confdefs.h
+
+
+
+
+
+printf "%s\n" "#define GNULIB_SCANF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FGETC=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FGETC 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_GETC=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_GETC 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_GETCHAR=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_GETCHAR 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FGETS=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FGETS 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FREAD=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FREAD 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FPRINTF=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FPRINTF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_PRINTF=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_PRINTF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_VFPRINTF=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_VFPRINTF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_VPRINTF=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_VPRINTF 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FPUTC=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FPUTC 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_PUTC=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_PUTC 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_PUTCHAR=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_PUTCHAR 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FPUTS=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FPUTS 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_PUTS=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_PUTS 1" >>confdefs.h
+
+
+
+
+
+
+
+
+
+
+
+
+          GL_GNULIB_FWRITE=1
+
+
+
+
+
+printf "%s\n" "#define GNULIB_TEST_FWRITE 1" >>confdefs.h
+
+
 
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'stdio.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_stdio_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_STDIO_H=$gl_next_as_first_directive
 
 
 
 
 
-        { $as_echo "$as_me:${as_lineno-$LINENO}: checking which flavor of printf attribute matches inttypes macros" >&5
-$as_echo_n "checking which flavor of printf attribute matches inttypes macros... " >&6; }
-if ${gl_cv_func_printf_attribute_flavor+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
 
-       #define __STDC_FORMAT_MACROS 1
-       #include <stdio.h>
-       #include <inttypes.h>
-       /* For non-mingw systems, compilation will trivially succeed.
-          For mingw, compilation will succeed for older mingw (system
-          printf, "I64d") and fail for newer mingw (gnu printf, "lld"). */
-       #if (defined _WIN32 && ! defined __CYGWIN__) && \
-         (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-       extern char PRIdMAX_probesizeof PRIdMAX == sizeof "I64d" ? 1 : -1;
-       #endif
 
-int
-main ()
-{
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_func_printf_attribute_flavor=system
-else
-  gl_cv_func_printf_attribute_flavor=gnu
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_attribute_flavor" >&5
-$as_echo "$gl_cv_func_printf_attribute_flavor" >&6; }
-  if test "$gl_cv_func_printf_attribute_flavor" = gnu; then
 
-$as_echo "#define GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU 1" >>confdefs.h
 
-  fi
 
-      GNULIB_FSCANF=1
 
 
-cat >>confdefs.h <<_ACEOF
-#define GNULIB_FSCANF 1
-_ACEOF
 
 
-  GNULIB_SCANF=1
 
 
-cat >>confdefs.h <<_ACEOF
-#define GNULIB_SCANF 1
-_ACEOF
 
 
-  GNULIB_FGETC=1
-  GNULIB_GETC=1
-  GNULIB_GETCHAR=1
-  GNULIB_FGETS=1
-  GNULIB_FREAD=1
 
 
-      GNULIB_FPRINTF=1
-  GNULIB_PRINTF=1
-  GNULIB_VFPRINTF=1
-  GNULIB_VPRINTF=1
-  GNULIB_FPUTC=1
-  GNULIB_PUTC=1
-  GNULIB_PUTCHAR=1
-  GNULIB_FPUTS=1
-  GNULIB_PUTS=1
-  GNULIB_FWRITE=1
 
 
 
@@ -17333,7 +22468,7 @@
             || { test $LIBUNISTRING_VERSION_MAJOR -eq 0 \
                  && { test $LIBUNISTRING_VERSION_MINOR -lt 9 \
                       || { test $LIBUNISTRING_VERSION_MINOR -eq 9 \
-                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 4
+                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 11
                          }
                     }
                }
@@ -17343,7 +22478,9 @@
 
        }
   }; then
-    LIBUNISTRING_UNITYPES_H='unitypes.h'
+            if test -z "$LIBUNISTRING_UNITYPES_H"; then
+      LIBUNISTRING_UNITYPES_H="${gl_source_base_prefix}unitypes.h"
+    fi
   else
     LIBUNISTRING_UNITYPES_H=
   fi
@@ -17351,6 +22488,8 @@
 
 
 
+
+
       if  { test "$HAVE_LIBUNISTRING" != yes \
     || {
 
@@ -17360,7 +22499,7 @@
             || { test $LIBUNISTRING_VERSION_MAJOR -eq 0 \
                  && { test $LIBUNISTRING_VERSION_MINOR -lt 9 \
                       || { test $LIBUNISTRING_VERSION_MINOR -eq 9 \
-                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 4
+                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 11
                          }
                     }
                }
@@ -17370,7 +22509,9 @@
 
        }
   }; then
-    LIBUNISTRING_UNIWIDTH_H='uniwidth.h'
+            if test -z "$LIBUNISTRING_UNIWIDTH_H"; then
+      LIBUNISTRING_UNIWIDTH_H="${gl_source_base_prefix}uniwidth.h"
+    fi
   else
     LIBUNISTRING_UNIWIDTH_H=
   fi
@@ -17378,16 +22519,18 @@
 
 
 
-       if  { test "$HAVE_LIBUNISTRING" != yes \
+
+
+     if  { test "$HAVE_LIBUNISTRING" != yes \
     || {
 
 
 
-            test $LIBUNISTRING_VERSION_MAJOR -lt 0 \
-            || { test $LIBUNISTRING_VERSION_MAJOR -eq 0 \
-                 && { test $LIBUNISTRING_VERSION_MINOR -lt 9 \
-                      || { test $LIBUNISTRING_VERSION_MINOR -eq 9 \
-                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 8
+            test $LIBUNISTRING_VERSION_MAJOR -lt 1 \
+            || { test $LIBUNISTRING_VERSION_MAJOR -eq 1 \
+                 && { test $LIBUNISTRING_VERSION_MINOR -lt 1 \
+                      || { test $LIBUNISTRING_VERSION_MINOR -eq 1 \
+                           && test $LIBUNISTRING_VERSION_SUBMINOR -lt 0
                          }
                     }
                }
@@ -17403,6 +22546,12 @@
   LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE='#'
   LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_FALSE=
 fi
+:
+    if test -z "${LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE}" && test -z "${LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_FALSE}"; then
+    LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE='#'
+    LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_FALSE='#'
+  fi
+
 
 
 
@@ -17452,7 +22601,7 @@
 
   if test $ac_cv_func_vasnprintf = yes; then
 
-$as_echo "#define REPLACE_VASNPRINTF 1" >>confdefs.h
+printf "%s\n" "#define REPLACE_VASNPRINTF 1" >>confdefs.h
 
   fi
 
@@ -17464,14 +22613,13 @@
 
 
 
-
-
   ac_fn_c_check_type "$LINENO" "ptrdiff_t" "ac_cv_type_ptrdiff_t" "$ac_includes_default"
-if test "x$ac_cv_type_ptrdiff_t" = xyes; then :
+if test "x$ac_cv_type_ptrdiff_t" = xyes
+then :
 
-else
+else $as_nop
 
-$as_echo "#define ptrdiff_t long" >>confdefs.h
+printf "%s\n" "#define ptrdiff_t long" >>confdefs.h
 
 
 fi
@@ -17487,35 +22635,35 @@
 
 
   gl_cv_func_vsnprintf_usable=no
-  for ac_func in vsnprintf
-do :
   ac_fn_c_check_func "$LINENO" "vsnprintf" "ac_cv_func_vsnprintf"
-if test "x$ac_cv_func_vsnprintf" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_VSNPRINTF 1
-_ACEOF
+if test "x$ac_cv_func_vsnprintf" = xyes
+then :
+  printf "%s\n" "#define HAVE_VSNPRINTF 1" >>confdefs.h
 
 fi
-done
 
   if test $ac_cv_func_vsnprintf = yes; then
 
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether snprintf respects a size of 1" >&5
-$as_echo_n "checking whether snprintf respects a size of 1... " >&6; }
-if ${gl_cv_func_snprintf_size1+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether snprintf respects a size of 1" >&5
+printf %s "checking whether snprintf respects a size of 1... " >&6; }
+if test ${gl_cv_func_snprintf_size1+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   case "$host_os" in
-                   # Guess yes on native Windows.
-           mingw*) gl_cv_func_snprintf_size1="guessing yes" ;;
-           *)      gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_snprintf_size1="guessing yes" ;;
+           *)               gl_cv_func_snprintf_size1="guessing yes" ;;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -17541,9 +22689,10 @@
   return buf1 != 'E';
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_snprintf_size1=yes
-else
+else $as_nop
   gl_cv_func_snprintf_size1=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -17552,8 +22701,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_size1" >&5
-$as_echo "$gl_cv_func_snprintf_size1" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_snprintf_size1" >&5
+printf "%s\n" "$gl_cv_func_snprintf_size1" >&6; }
 
     case "$gl_cv_func_snprintf_size1" in
       *yes)
@@ -17562,24 +22711,28 @@
           *yes)
 
 
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
-$as_echo_n "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
-if ${gl_cv_func_printf_positions+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether printf supports POSIX/XSI format strings with positions" >&5
+printf %s "checking whether printf supports POSIX/XSI format strings with positions... " >&6; }
+if test ${gl_cv_func_printf_positions+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
 
          case "$host_os" in
            netbsd1-3* | netbsdelf1-3* | netbsdaout1-3* | netbsdcoff1-3*)
-                         gl_cv_func_printf_positions="guessing no";;
-           beos*)        gl_cv_func_printf_positions="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_positions="guessing no";;
-           *)            gl_cv_func_printf_positions="guessing yes";;
+                            gl_cv_func_printf_positions="guessing no";;
+           beos*)           gl_cv_func_printf_positions="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_positions="guessing yes";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_positions="guessing no";;
+           *)               gl_cv_func_printf_positions="guessing yes";;
          esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -17595,9 +22748,10 @@
   return (strcmp (buf, "55 33") != 0);
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_printf_positions=yes
-else
+else $as_nop
   gl_cv_func_printf_positions=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -17606,8 +22760,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
-$as_echo "$gl_cv_func_printf_positions" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_printf_positions" >&5
+printf "%s\n" "$gl_cv_func_printf_positions" >&6; }
 
             case "$gl_cv_func_printf_positions" in
               *yes)
@@ -17653,430 +22807,34 @@
 
 
 
-          GNULIB_VSNPRINTF=1
-
-
-
-
-
-$as_echo "#define GNULIB_TEST_VSNPRINTF 1" >>confdefs.h
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_wchar_h='<'wchar.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <wchar.h>" >&5
-$as_echo_n "checking absolute name of <wchar.h>... " >&6; }
-if ${gl_cv_next_wchar_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-
-             if test $ac_cv_header_wchar_h = yes; then
-
-
-
-
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <wchar.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
-
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
-      ;;
-  esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'wchar.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
-
-        gl_cv_absolute_wchar_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
-
-           gl_header=$gl_cv_absolute_wchar_h
-           gl_cv_next_wchar_h='"'$gl_header'"'
-          else
-               gl_cv_next_wchar_h='<'wchar.h'>'
-             fi
-
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_wchar_h" >&5
-$as_echo "$gl_cv_next_wchar_h" >&6; }
-     fi
-     NEXT_WCHAR_H=$gl_cv_next_wchar_h
-
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'wchar.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_wchar_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_WCHAR_H=$gl_next_as_first_directive
-
-
-
-
-  if test $ac_cv_header_wchar_h = yes; then
-    HAVE_WCHAR_H=1
-  else
-    HAVE_WCHAR_H=0
-  fi
-
-
-
-
-
-  if test $gt_cv_c_wint_t = yes; then
-    HAVE_WINT_T=1
-  else
-    HAVE_WINT_T=0
-  fi
-
-
-
-
-
-
-
-
-
-
-
-
-
-  if test $ac_cv_func_iswcntrl = yes; then
-    HAVE_ISWCNTRL=1
-  else
-    HAVE_ISWCNTRL=0
-  fi
-
-
-
-  if test $gt_cv_c_wint_t = yes; then
-    HAVE_WINT_T=1
-  else
-    HAVE_WINT_T=0
-  fi
-
-
-
-
-
-
-
-
-
-
-
-
-
-     if test $gl_cv_have_include_next = yes; then
-       gl_cv_next_wctype_h='<'wctype.h'>'
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking absolute name of <wctype.h>" >&5
-$as_echo_n "checking absolute name of <wctype.h>... " >&6; }
-if ${gl_cv_next_wctype_h+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-
-             if test $ac_cv_header_wctype_h = yes; then
-
-
-
-
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <wctype.h>
-_ACEOF
-                case "$host_os" in
-    aix*) gl_absname_cpp="$ac_cpp -C" ;;
-    *)    gl_absname_cpp="$ac_cpp" ;;
-  esac
-
-  case "$host_os" in
-    mingw*)
-                                          gl_dirsep_regex='/\\'
-      ;;
-    *)
-      gl_dirsep_regex='\/'
-      ;;
-  esac
-      gl_make_literal_regex_sed='s,$^\\.*/,\\&,g'
-  gl_header_literal_regex=`echo 'wctype.h' \
-                           | sed -e "$gl_make_literal_regex_sed"`
-  gl_absolute_header_sed="/${gl_dirsep_regex}${gl_header_literal_regex}/"'{
-      s/.*"$.*'"${gl_dirsep_regex}${gl_header_literal_regex}"'$".*/\1/
-      s|^/^/|//&|
-      p
-      q
-    }'
 
-        gl_cv_absolute_wctype_h=`(eval "$gl_absname_cpp conftest.$ac_ext") 2>&5 |
-  sed -n "$gl_absolute_header_sed"`
 
-           gl_header=$gl_cv_absolute_wctype_h
-           gl_cv_next_wctype_h='"'$gl_header'"'
-          else
-               gl_cv_next_wctype_h='<'wctype.h'>'
-             fi
 
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_next_wctype_h" >&5
-$as_echo "$gl_cv_next_wctype_h" >&6; }
-     fi
-     NEXT_WCTYPE_H=$gl_cv_next_wctype_h
+          GL_GNULIB_VSNPRINTF=1
 
-     if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
-       gl_next_as_first_directive='<'wctype.h'>'
-     else
-       # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=$gl_cv_next_wctype_h
-     fi
-     NEXT_AS_FIRST_DIRECTIVE_WCTYPE_H=$gl_next_as_first_directive
 
 
 
 
-  if test $ac_cv_header_wctype_h = yes; then
-    if test $ac_cv_func_iswcntrl = yes; then
-                  { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether iswcntrl works" >&5
-$as_echo_n "checking whether iswcntrl works... " >&6; }
-if ${gl_cv_func_iswcntrl_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+printf "%s\n" "#define GNULIB_TEST_VSNPRINTF 1" >>confdefs.h
 
-          if test "$cross_compiling" = yes; then :
-               cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-#include <stdlib.h>
-                          #if __GNU_LIBRARY__ == 1
-                          Linux libc5 i18n is broken.
-                          #endif
-int
-main ()
-{
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_func_iswcntrl_works="guessing yes"
-else
-  gl_cv_func_iswcntrl_works="guessing no"
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-
-               /* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-                  included before <wchar.h>.
-                  BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-                  must be included before <wchar.h>.  */
-               #include <stddef.h>
-               #include <stdio.h>
-               #include <time.h>
-               #include <wchar.h>
-               #include <wctype.h>
-               int main () { return iswprint ('x') == 0; }
-
-_ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  gl_cv_func_iswcntrl_works=yes
-else
-  gl_cv_func_iswcntrl_works=no
-fi
-rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
-  conftest.$ac_objext conftest.beam conftest.$ac_ext
-fi
-
-
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_iswcntrl_works" >&5
-$as_echo "$gl_cv_func_iswcntrl_works" >&6; }
-    fi
-    HAVE_WCTYPE_H=1
-  else
-    HAVE_WCTYPE_H=0
-  fi
-
-
-  case "$gl_cv_func_iswcntrl_works" in
-    *yes) REPLACE_ISWCNTRL=0 ;;
-    *)    REPLACE_ISWCNTRL=1 ;;
-  esac
 
 
-  if test $HAVE_ISWCNTRL = 0 || test $REPLACE_ISWCNTRL = 1; then
-        :
-  fi
-
-  if test $REPLACE_ISWCNTRL = 1; then
-    REPLACE_TOWLOWER=1
-  else
-    for ac_func in towlower
-do :
-  ac_fn_c_check_func "$LINENO" "towlower" "ac_cv_func_towlower"
-if test "x$ac_cv_func_towlower" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_TOWLOWER 1
-_ACEOF
-
-fi
-done
-
-    if test $ac_cv_func_towlower = yes; then
-      REPLACE_TOWLOWER=0
-    else
-      ac_fn_c_check_decl "$LINENO" "towlower" "ac_cv_have_decl_towlower" "/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-             included before <wchar.h>.
-             BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-             must be included before <wchar.h>.  */
-          #include <stddef.h>
-          #include <stdio.h>
-          #include <time.h>
-          #include <wchar.h>
-          #if HAVE_WCTYPE_H
-          # include <wctype.h>
-          #endif
 
-"
-if test "x$ac_cv_have_decl_towlower" = xyes; then :
-  ac_have_decl=1
-else
-  ac_have_decl=0
-fi
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_TOWLOWER $ac_have_decl
-_ACEOF
 
-      if test $ac_cv_have_decl_towlower = yes; then
-                                REPLACE_TOWLOWER=1
-      else
-        REPLACE_TOWLOWER=0
-      fi
-    fi
-  fi
 
 
-  if test $HAVE_ISWCNTRL = 0 || test $REPLACE_TOWLOWER = 1; then
-        :
-  fi
 
-          { $as_echo "$as_me:${as_lineno-$LINENO}: checking for wctype_t" >&5
-$as_echo_n "checking for wctype_t... " >&6; }
-if ${gl_cv_type_wctype_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-               included before <wchar.h>.
-               BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-               must be included before <wchar.h>.  */
-            #include <stddef.h>
-            #include <stdio.h>
-            #include <time.h>
-            #include <wchar.h>
-            #if HAVE_WCTYPE_H
-            # include <wctype.h>
-            #endif
-            wctype_t a;
 
-int
-main ()
-{
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_type_wctype_t=yes
-else
-  gl_cv_type_wctype_t=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wctype_t" >&5
-$as_echo "$gl_cv_type_wctype_t" >&6; }
-  if test $gl_cv_type_wctype_t = no; then
-    HAVE_WCTYPE_T=0
-  fi
 
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for wctrans_t" >&5
-$as_echo_n "checking for wctrans_t... " >&6; }
-if ${gl_cv_type_wctrans_t+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
-/* end confdefs.h.  */
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-               included before <wchar.h>.
-               BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-               must be included before <wchar.h>.  */
-            #include <stddef.h>
-            #include <stdio.h>
-            #include <time.h>
-            #include <wchar.h>
-            #include <wctype.h>
-            wctrans_t a;
 
-int
-main ()
-{
 
-  ;
-  return 0;
-}
-_ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  gl_cv_type_wctrans_t=yes
-else
-  gl_cv_type_wctrans_t=no
-fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
 
-fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_type_wctrans_t" >&5
-$as_echo "$gl_cv_type_wctrans_t" >&6; }
-  if test $gl_cv_type_wctrans_t = no; then
-    HAVE_WCTRANS_T=0
-  fi
 
 
 
@@ -18093,39 +22851,29 @@
 
 
 
-  ac_fn_c_check_decl "$LINENO" "wcwidth" "ac_cv_have_decl_wcwidth" "
-/* AIX 3.2.5 declares wcwidth in <string.h>. */
-#include <string.h>
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
+  ac_fn_check_decl "$LINENO" "wcwidth" "ac_cv_have_decl_wcwidth" "
+    #include <wchar.h>
 
-"
-if test "x$ac_cv_have_decl_wcwidth" = xyes; then :
+" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_wcwidth" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
-
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_WCWIDTH $ac_have_decl
-_ACEOF
+printf "%s\n" "#define HAVE_DECL_WCWIDTH $ac_have_decl" >>confdefs.h
 
   if test $ac_cv_have_decl_wcwidth != yes; then
     HAVE_DECL_WCWIDTH=0
   fi
 
   if test $ac_cv_func_wcwidth != yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether wcwidth is a macro" >&5
-$as_echo_n "checking whether wcwidth is a macro... " >&6; }
-if ${gl_cv_func_wcwidth_macro+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether wcwidth is a macro" >&5
+printf %s "checking whether wcwidth is a macro... " >&6; }
+if test ${gl_cv_func_wcwidth_macro+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -18135,49 +22883,47 @@
 #endif
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "wchar_header_defines_wcwidth" >/dev/null 2>&1; then :
+  $EGREP "wchar_header_defines_wcwidth" >/dev/null 2>&1
+then :
   gl_cv_func_wcwidth_macro=yes
-else
+else $as_nop
   gl_cv_func_wcwidth_macro=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_wcwidth_macro" >&5
-$as_echo "$gl_cv_func_wcwidth_macro" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_wcwidth_macro" >&5
+printf "%s\n" "$gl_cv_func_wcwidth_macro" >&6; }
   fi
 
   if test $ac_cv_func_wcwidth = yes || test $gl_cv_func_wcwidth_macro = yes; then
     HAVE_WCWIDTH=1
-                        { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether wcwidth works reasonably in UTF-8 locales" >&5
-$as_echo_n "checking whether wcwidth works reasonably in UTF-8 locales... " >&6; }
-if ${gl_cv_func_wcwidth_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+                                        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether wcwidth works reasonably in UTF-8 locales" >&5
+printf %s "checking whether wcwidth works reasonably in UTF-8 locales... " >&6; }
+if test ${gl_cv_func_wcwidth_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
-        if test "$cross_compiling" = yes; then :
+        if test "$cross_compiling" = yes
+then :
 
            case "$host_os" in
-                                        # Guess yes on glibc and AIX 7 systems.
-             *-gnu* | gnu* | aix7-9*) gl_cv_func_wcwidth_works="guessing yes";;
-             *)                         gl_cv_func_wcwidth_works="guessing no";;
+                            # Guess yes on glibc systems.
+             *-gnu* | gnu*) gl_cv_func_wcwidth_works="guessing yes";;
+                            # Guess yes on musl systems.
+             *-musl*)       gl_cv_func_wcwidth_works="guessing yes";;
+                            # Guess yes on AIX 7 systems.
+             aix7-9*)     gl_cv_func_wcwidth_works="guessing yes";;
+             *)             gl_cv_func_wcwidth_works="$gl_cross_guess_normal";;
            esac
 
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 #include <locale.h>
-/* AIX 3.2.5 declares wcwidth in <string.h>. */
-#include <string.h>
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
 #include <wchar.h>
 #if !HAVE_DECL_WCWIDTH
 extern
@@ -18189,7 +22935,7 @@
 int main ()
 {
   int result = 0;
-  if (setlocale (LC_ALL, "fr_FR.UTF-8") != NULL)
+  if (setlocale (LC_ALL, "en_US.UTF-8") != NULL)
     {
       if (wcwidth (0x0301) > 0)
         result |= 1;
@@ -18199,13 +22945,16 @@
         result |= 4;
       if (wcwidth (0xFF1A) == 0)
         result |= 8;
+      if (wcwidth (0x2202) > 1)
+        result |= 16;
     }
   return result;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   gl_cv_func_wcwidth_works=yes
-else
+else $as_nop
   gl_cv_func_wcwidth_works=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -18214,8 +22963,8 @@
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_wcwidth_works" >&5
-$as_echo "$gl_cv_func_wcwidth_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_func_wcwidth_works" >&5
+printf "%s\n" "$gl_cv_func_wcwidth_works" >&6; }
     case "$gl_cv_func_wcwidth_works" in
       *yes) ;;
       *no) REPLACE_WCWIDTH=1 ;;
@@ -18224,50 +22973,60 @@
     HAVE_WCWIDTH=0
   fi
 
-  if test $HAVE_WCWIDTH = 0 || test $REPLACE_WCWIDTH = 1; then
 
+     if test $HAVE_WCWIDTH = 0 || test $REPLACE_WCWIDTH = 1; then
+  GL_COND_OBJ_WCWIDTH_TRUE=
+  GL_COND_OBJ_WCWIDTH_FALSE='#'
+else
+  GL_COND_OBJ_WCWIDTH_TRUE='#'
+  GL_COND_OBJ_WCWIDTH_FALSE=
+fi
+:
+    if test -z "${GL_COND_OBJ_WCWIDTH_TRUE}" && test -z "${GL_COND_OBJ_WCWIDTH_FALSE}"; then
+    GL_COND_OBJ_WCWIDTH_TRUE='#'
+    GL_COND_OBJ_WCWIDTH_FALSE='#'
+  fi
 
+  if test -z "$GL_COND_OBJ_WCWIDTH_TRUE"; then :
 
 
 
+  :
 
 
+fi
 
-  gl_LIBOBJS="$gl_LIBOBJS wcwidth.$ac_objext"
 
 
 
-  :
 
-  fi
 
 
 
 
 
-          GNULIB_WCWIDTH=1
 
 
 
 
+          GL_GNULIB_WCWIDTH=1
 
-$as_echo "#define GNULIB_TEST_WCWIDTH 1" >>confdefs.h
 
 
 
 
+printf "%s\n" "#define GNULIB_TEST_WCWIDTH 1" >>confdefs.h
 
-  for ac_header in stdint.h
-do :
-  ac_fn_c_check_header_mongrel "$LINENO" "stdint.h" "ac_cv_header_stdint_h" "$ac_includes_default"
-if test "x$ac_cv_header_stdint_h" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_STDINT_H 1
-_ACEOF
 
-fi
 
-done
+
+
+  ac_fn_c_check_header_compile "$LINENO" "stdint.h" "ac_cv_header_stdint_h" "$ac_includes_default"
+if test "x$ac_cv_header_stdint_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STDINT_H 1" >>confdefs.h
+
+fi
 
 
   # End of code from modules
@@ -18280,6 +23039,8 @@
 
 
 
+
+
   gltests_libdeps=
   gltests_ltlibdeps=
 
@@ -18291,7 +23052,11 @@
 
 
 
+
+
+
   gl_source_base='tests'
+  gl_source_base_prefix=
   gltests_WITNESS=IN_`echo "${PACKAGE-$PACKAGE_TARNAME}" | LC_ALL=C tr abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ | LC_ALL=C sed -e 's/^A-Z0-9_/_/g'`_GNULIB_TESTS
 
   gl_module_indicator_condition=$gltests_WITNESS
@@ -18304,6 +23069,9 @@
 
 
 
+
+
+
   LIBGNU_LIBDEPS="$gl_libdeps"
 
   LIBGNU_LTLIBDEPS="$gl_ltlibdeps"
@@ -18318,12 +23086,13 @@
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
    if test "$cross_compiling" = no; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking that C++ compiler can compile simple program" >&5
-$as_echo_n "checking that C++ compiler can compile simple program... " >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking that C++ compiler can compile simple program" >&5
+printf %s "checking that C++ compiler can compile simple program... " >&6; }
    fi
-   if test "$cross_compiling" = yes; then :
+   if test "$cross_compiling" = yes
+then :
   :
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -18336,12 +23105,13 @@
 
 
 _ACEOF
-if ac_fn_cxx_try_run "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_run "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
       as_fn_error $? "a working C++ compiler is required" "$LINENO" 5
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -18350,12 +23120,13 @@
 
 
    if test "$cross_compiling" = no; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking that C++ static constructors and destructors are called" >&5
-$as_echo_n "checking that C++ static constructors and destructors are called... " >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking that C++ static constructors and destructors are called" >&5
+printf %s "checking that C++ static constructors and destructors are called... " >&6; }
    fi
-   if test "$cross_compiling" = yes; then :
+   if test "$cross_compiling" = yes
+then :
   :
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -18382,12 +23153,13 @@
 
 
 _ACEOF
-if ac_fn_cxx_try_run "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_run "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
       as_fn_error $? "a working C++ compiler is required" "$LINENO" 5
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -18395,8 +23167,8 @@
 fi
 
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking that header files support C++" >&5
-$as_echo_n "checking that header files support C++... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking that header files support C++" >&5
+printf %s "checking that header files support C++... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -18406,7 +23178,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -18418,17 +23190,18 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
       as_fn_error $? "header files do not support C++
 		   (if you are using a version of gcc/g++ earlier than 2.5,
 		   you should install libg++)" "$LINENO" 5
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
@@ -18436,8 +23209,8 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether character set is EBCDIC" >&5
-$as_echo_n "checking whether character set is EBCDIC... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether character set is EBCDIC" >&5
+printf %s "checking whether character set is EBCDIC... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -18452,7 +23225,7 @@
 
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -18460,56 +23233,58 @@
 }
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   groff_cv_ebcdic="yes"
       TTYDEVDIRS="font/devcp1047"
-      { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 
-$as_echo "#define IS_EBCDIC_HOST 1" >>confdefs.h
+printf "%s\n" "#define IS_EBCDIC_HOST 1" >>confdefs.h
 
-else
+else $as_nop
   groff_cv_ebcdic="no"
      TTYDEVDIRS="font/devascii font/devlatin1"
      OTHERDEVDIRS="font/devlj4 font/devlbp"
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
 
 if test "$groff_cv_ebcdic" = "yes"; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking for OS/390 Unix" >&5
-$as_echo_n "checking for OS/390 Unix... " >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for OS/390 Unix" >&5
+printf %s "checking for OS/390 Unix... " >&6; }
      case `uname` in
      OS/390)
        CFLAGS="$CFLAGS -D_ALL_SOURCE"
-       { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; } ;;
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; } ;;
      *)
-       { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; } ;;
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; } ;;
      esac
    fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether to install .cmd wrapper scripts for Windows" >&5
-$as_echo_n "checking whether to install .cmd wrapper scripts for Windows... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether to install .cmd wrapper scripts for Windows" >&5
+printf %s "checking whether to install .cmd wrapper scripts for Windows... " >&6; }
    case "$host_os" in
    *mingw*)
      make_winscripts=winscripts
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; } ;;
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; } ;;
    *)
      make_winscripts=
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; } ;;
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; } ;;
    esac
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for X" >&5
-$as_echo_n "checking for X... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for X" >&5
+printf %s "checking for X... " >&6; }
 
 
 # Check whether --with-x was given.
-if test "${with_x+set}" = set; then :
+if test ${with_x+y}
+then :
   withval=$with_x;
 fi
 
@@ -18520,12 +23295,41 @@
 else
   case $x_includes,$x_libraries in #(
     *\'*) as_fn_error $? "cannot use X directory names containing '" "$LINENO" 5;; #(
-    *,NONE | NONE,*) if ${ac_cv_have_x+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    *,NONE | NONE,*) if test ${ac_cv_have_x+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   # One or both of the vars are not set, and there is no cached value.
-ac_x_includes=no ac_x_libraries=no
-rm -f -r conftest.dir
+ac_x_includes=no
+ac_x_libraries=no
+# Do we need to do anything special at all?
+ac_save_LIBS=$LIBS
+LIBS="-lX11 $LIBS"
+cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+#include <X11/Xlib.h>
+int
+main (void)
+{
+XrmInitialize ()
+  ;
+  return 0;
+}
+_ACEOF
+if ac_fn_c_try_link "$LINENO"
+then :
+  # We can compile and link X programs with no special options.
+  ac_x_includes=
+  ac_x_libraries=
+fi
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
+    conftest$ac_exeext conftest.$ac_ext
+LIBS="$ac_save_LIBS"
+# If that didn't work, only try xmkmf and file system searches
+# for native compilation.
+if test x"$ac_x_includes" = xno && test "$cross_compiling" = no
+then :
+  rm -f -r conftest.dir
 if mkdir conftest.dir; then
   cd conftest.dir
   cat >Imakefile <<'_ACEOF'
@@ -18564,7 +23368,7 @@
   rm -f -r conftest.dir
 fi
 
-# Standard set of common directories for X headers.
+  # Standard set of common directories for X headers.
 # Check X11 before X11Rn because it is often a symlink to the current release.
 ac_x_header_dirs='
 /usr/X11/include
@@ -18591,6 +23395,8 @@
 /usr/local/include/X11R5
 /usr/local/include/X11R4
 
+/opt/X11/include
+
 /usr/X386/include
 /usr/x386/include
 /usr/XFree86/include/X11
@@ -18612,10 +23418,11 @@
 /* end confdefs.h.  */
 #include <X11/Xlib.h>
 _ACEOF
-if ac_fn_c_try_cpp "$LINENO"; then :
+if ac_fn_c_try_cpp "$LINENO"
+then :
   # We can compile using X headers with no special include directory.
 ac_x_includes=
-else
+else $as_nop
   for ac_dir in $ac_x_header_dirs; do
   if test -r "$ac_dir/X11/Xlib.h"; then
     ac_x_includes=$ac_dir
@@ -18636,20 +23443,21 @@
 /* end confdefs.h.  */
 #include <X11/Xlib.h>
 int
-main ()
+main (void)
 {
 XrmInitialize ()
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   LIBS=$ac_save_LIBS
 # We can link X programs with no special library path.
 ac_x_libraries=
-else
+else $as_nop
   LIBS=$ac_save_LIBS
-for ac_dir in `$as_echo "$ac_x_includes $ac_x_header_dirs" | sed s/include/lib/g`
+for ac_dir in `printf "%s\n" "$ac_x_includes $ac_x_header_dirs" | sed s/include/lib/g`
 do
   # Don't even attempt the hair of trying to link an X program!
   for ac_extension in a so sl dylib la dll; do
@@ -18660,19 +23468,21 @@
   done
 done
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 fi # $ac_x_libraries = no
 
+fi
+# Record the results.
 case $ac_x_includes,$ac_x_libraries in #(
-  no,* | *,no | *\'*)
+  no,* | *,no | *\'*) :
     # Didn't find X, or a directory has "'" in its name.
-    ac_cv_have_x="have_x=no";; #(
-  *)
+    ac_cv_have_x="have_x=no" ;; #(
+  *) :
     # Record where we found X for the cache.
     ac_cv_have_x="have_x=yes\
 	ac_x_includes='$ac_x_includes'\
-	ac_x_libraries='$ac_x_libraries'"
+	ac_x_libraries='$ac_x_libraries'" ;;
 esac
 fi
 ;; #(
@@ -18682,8 +23492,8 @@
 fi # $with_x != no
 
 if test "$have_x" != yes; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $have_x" >&5
-$as_echo "$have_x" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $have_x" >&5
+printf "%s\n" "$have_x" >&6; }
   no_x=yes
 else
   # If each of the values was on the command line, it overrides each guess.
@@ -18693,14 +23503,14 @@
   ac_cv_have_x="have_x=yes\
 	ac_x_includes='$x_includes'\
 	ac_x_libraries='$x_libraries'"
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: libraries $x_libraries, headers $x_includes" >&5
-$as_echo "libraries $x_libraries, headers $x_includes" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: libraries $x_libraries, headers $x_includes" >&5
+printf "%s\n" "libraries $x_libraries, headers $x_includes" >&6; }
 fi
 
 if test "$no_x" = yes; then
   # Not all programs may use this symbol, but it does not hurt to define it.
 
-$as_echo "#define X_DISPLAY_MISSING 1" >>confdefs.h
+printf "%s\n" "#define X_DISPLAY_MISSING 1" >>confdefs.h
 
   X_CFLAGS= X_PRE_LIBS= X_LIBS= X_EXTRA_LIBS=
 else
@@ -18713,8 +23523,8 @@
     X_LIBS="$X_LIBS -L$x_libraries"
     # For Solaris; some versions of Sun CC require a space after -R and
     # others require no space.  Words are not sufficient . . . .
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -R must be followed by a space" >&5
-$as_echo_n "checking whether -R must be followed by a space... " >&6; }
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether -R must be followed by a space" >&5
+printf %s "checking whether -R must be followed by a space... " >&6; }
     ac_xsave_LIBS=$LIBS; LIBS="$LIBS -R$x_libraries"
     ac_xsave_c_werror_flag=$ac_c_werror_flag
     ac_c_werror_flag=yes
@@ -18722,42 +23532,44 @@
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_c_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
        X_LIBS="$X_LIBS -R$x_libraries"
-else
+else $as_nop
   LIBS="$ac_xsave_LIBS -R $x_libraries"
        cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+if ac_fn_c_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 	  X_LIBS="$X_LIBS -R $x_libraries"
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: neither works" >&5
-$as_echo "neither works" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: neither works" >&5
+printf "%s\n" "neither works" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
     ac_c_werror_flag=$ac_xsave_c_werror_flag
     LIBS=$ac_xsave_LIBS
@@ -18780,26 +23592,25 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char XOpenDisplay ();
 int
-main ()
+main (void)
 {
 return XOpenDisplay ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
 
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for dnet_ntoa in -ldnet" >&5
-$as_echo_n "checking for dnet_ntoa in -ldnet... " >&6; }
-if ${ac_cv_lib_dnet_dnet_ntoa+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for dnet_ntoa in -ldnet" >&5
+printf %s "checking for dnet_ntoa in -ldnet... " >&6; }
+if test ${ac_cv_lib_dnet_dnet_ntoa+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-ldnet  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -18808,39 +23619,39 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char dnet_ntoa ();
 int
-main ()
+main (void)
 {
 return dnet_ntoa ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_dnet_dnet_ntoa=yes
-else
+else $as_nop
   ac_cv_lib_dnet_dnet_ntoa=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_dnet_dnet_ntoa" >&5
-$as_echo "$ac_cv_lib_dnet_dnet_ntoa" >&6; }
-if test "x$ac_cv_lib_dnet_dnet_ntoa" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_dnet_dnet_ntoa" >&5
+printf "%s\n" "$ac_cv_lib_dnet_dnet_ntoa" >&6; }
+if test "x$ac_cv_lib_dnet_dnet_ntoa" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -ldnet"
 fi
 
     if test $ac_cv_lib_dnet_dnet_ntoa = no; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for dnet_ntoa in -ldnet_stub" >&5
-$as_echo_n "checking for dnet_ntoa in -ldnet_stub... " >&6; }
-if ${ac_cv_lib_dnet_stub_dnet_ntoa+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for dnet_ntoa in -ldnet_stub" >&5
+printf %s "checking for dnet_ntoa in -ldnet_stub... " >&6; }
+if test ${ac_cv_lib_dnet_stub_dnet_ntoa+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-ldnet_stub  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -18849,36 +23660,35 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char dnet_ntoa ();
 int
-main ()
+main (void)
 {
 return dnet_ntoa ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_dnet_stub_dnet_ntoa=yes
-else
+else $as_nop
   ac_cv_lib_dnet_stub_dnet_ntoa=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_dnet_stub_dnet_ntoa" >&5
-$as_echo "$ac_cv_lib_dnet_stub_dnet_ntoa" >&6; }
-if test "x$ac_cv_lib_dnet_stub_dnet_ntoa" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_dnet_stub_dnet_ntoa" >&5
+printf "%s\n" "$ac_cv_lib_dnet_stub_dnet_ntoa" >&6; }
+if test "x$ac_cv_lib_dnet_stub_dnet_ntoa" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -ldnet_stub"
 fi
 
     fi
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
     LIBS="$ac_xsave_LIBS"
 
@@ -18891,16 +23701,18 @@
     # The functions gethostbyname, getservbyname, and inet_addr are
     # in -lbsd on LynxOS 3.0.1/i386, according to Lars Hecking.
     ac_fn_c_check_func "$LINENO" "gethostbyname" "ac_cv_func_gethostbyname"
-if test "x$ac_cv_func_gethostbyname" = xyes; then :
+if test "x$ac_cv_func_gethostbyname" = xyes
+then :
 
 fi
 
     if test $ac_cv_func_gethostbyname = no; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for gethostbyname in -lnsl" >&5
-$as_echo_n "checking for gethostbyname in -lnsl... " >&6; }
-if ${ac_cv_lib_nsl_gethostbyname+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for gethostbyname in -lnsl" >&5
+printf %s "checking for gethostbyname in -lnsl... " >&6; }
+if test ${ac_cv_lib_nsl_gethostbyname+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lnsl  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -18909,39 +23721,39 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char gethostbyname ();
 int
-main ()
+main (void)
 {
 return gethostbyname ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_nsl_gethostbyname=yes
-else
+else $as_nop
   ac_cv_lib_nsl_gethostbyname=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_nsl_gethostbyname" >&5
-$as_echo "$ac_cv_lib_nsl_gethostbyname" >&6; }
-if test "x$ac_cv_lib_nsl_gethostbyname" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_nsl_gethostbyname" >&5
+printf "%s\n" "$ac_cv_lib_nsl_gethostbyname" >&6; }
+if test "x$ac_cv_lib_nsl_gethostbyname" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -lnsl"
 fi
 
       if test $ac_cv_lib_nsl_gethostbyname = no; then
-	{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for gethostbyname in -lbsd" >&5
-$as_echo_n "checking for gethostbyname in -lbsd... " >&6; }
-if ${ac_cv_lib_bsd_gethostbyname+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for gethostbyname in -lbsd" >&5
+printf %s "checking for gethostbyname in -lbsd... " >&6; }
+if test ${ac_cv_lib_bsd_gethostbyname+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lbsd  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -18950,30 +23762,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char gethostbyname ();
 int
-main ()
+main (void)
 {
 return gethostbyname ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_bsd_gethostbyname=yes
-else
+else $as_nop
   ac_cv_lib_bsd_gethostbyname=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_bsd_gethostbyname" >&5
-$as_echo "$ac_cv_lib_bsd_gethostbyname" >&6; }
-if test "x$ac_cv_lib_bsd_gethostbyname" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_bsd_gethostbyname" >&5
+printf "%s\n" "$ac_cv_lib_bsd_gethostbyname" >&6; }
+if test "x$ac_cv_lib_bsd_gethostbyname" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -lbsd"
 fi
 
@@ -18988,16 +23799,18 @@
     # must be given before -lnsl if both are needed.  We assume that
     # if connect needs -lnsl, so does gethostbyname.
     ac_fn_c_check_func "$LINENO" "connect" "ac_cv_func_connect"
-if test "x$ac_cv_func_connect" = xyes; then :
+if test "x$ac_cv_func_connect" = xyes
+then :
 
 fi
 
     if test $ac_cv_func_connect = no; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for connect in -lsocket" >&5
-$as_echo_n "checking for connect in -lsocket... " >&6; }
-if ${ac_cv_lib_socket_connect+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for connect in -lsocket" >&5
+printf %s "checking for connect in -lsocket... " >&6; }
+if test ${ac_cv_lib_socket_connect+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lsocket $X_EXTRA_LIBS $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -19006,30 +23819,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char connect ();
 int
-main ()
+main (void)
 {
 return connect ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_socket_connect=yes
-else
+else $as_nop
   ac_cv_lib_socket_connect=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_socket_connect" >&5
-$as_echo "$ac_cv_lib_socket_connect" >&6; }
-if test "x$ac_cv_lib_socket_connect" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_socket_connect" >&5
+printf "%s\n" "$ac_cv_lib_socket_connect" >&6; }
+if test "x$ac_cv_lib_socket_connect" = xyes
+then :
   X_EXTRA_LIBS="-lsocket $X_EXTRA_LIBS"
 fi
 
@@ -19037,16 +23849,18 @@
 
     # Guillermo Gomez says -lposix is necessary on A/UX.
     ac_fn_c_check_func "$LINENO" "remove" "ac_cv_func_remove"
-if test "x$ac_cv_func_remove" = xyes; then :
+if test "x$ac_cv_func_remove" = xyes
+then :
 
 fi
 
     if test $ac_cv_func_remove = no; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for remove in -lposix" >&5
-$as_echo_n "checking for remove in -lposix... " >&6; }
-if ${ac_cv_lib_posix_remove+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for remove in -lposix" >&5
+printf %s "checking for remove in -lposix... " >&6; }
+if test ${ac_cv_lib_posix_remove+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lposix  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -19055,30 +23869,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char remove ();
 int
-main ()
+main (void)
 {
 return remove ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_posix_remove=yes
-else
+else $as_nop
   ac_cv_lib_posix_remove=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_posix_remove" >&5
-$as_echo "$ac_cv_lib_posix_remove" >&6; }
-if test "x$ac_cv_lib_posix_remove" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_posix_remove" >&5
+printf "%s\n" "$ac_cv_lib_posix_remove" >&6; }
+if test "x$ac_cv_lib_posix_remove" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -lposix"
 fi
 
@@ -19086,16 +23899,18 @@
 
     # BSDI BSD/OS 2.1 needs -lipc for XOpenDisplay.
     ac_fn_c_check_func "$LINENO" "shmat" "ac_cv_func_shmat"
-if test "x$ac_cv_func_shmat" = xyes; then :
+if test "x$ac_cv_func_shmat" = xyes
+then :
 
 fi
 
     if test $ac_cv_func_shmat = no; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: checking for shmat in -lipc" >&5
-$as_echo_n "checking for shmat in -lipc... " >&6; }
-if ${ac_cv_lib_ipc_shmat+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for shmat in -lipc" >&5
+printf %s "checking for shmat in -lipc... " >&6; }
+if test ${ac_cv_lib_ipc_shmat+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lipc  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -19104,30 +23919,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char shmat ();
 int
-main ()
+main (void)
 {
 return shmat ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_ipc_shmat=yes
-else
+else $as_nop
   ac_cv_lib_ipc_shmat=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_ipc_shmat" >&5
-$as_echo "$ac_cv_lib_ipc_shmat" >&6; }
-if test "x$ac_cv_lib_ipc_shmat" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_ipc_shmat" >&5
+printf "%s\n" "$ac_cv_lib_ipc_shmat" >&6; }
+if test "x$ac_cv_lib_ipc_shmat" = xyes
+then :
   X_EXTRA_LIBS="$X_EXTRA_LIBS -lipc"
 fi
 
@@ -19143,11 +23957,12 @@
   # These have to be linked with before -lX11, unlike the other
   # libraries we check for below, so use a different variable.
   # John Interrante, Karl Berry
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for IceConnectionNumber in -lICE" >&5
-$as_echo_n "checking for IceConnectionNumber in -lICE... " >&6; }
-if ${ac_cv_lib_ICE_IceConnectionNumber+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for IceConnectionNumber in -lICE" >&5
+printf %s "checking for IceConnectionNumber in -lICE... " >&6; }
+if test ${ac_cv_lib_ICE_IceConnectionNumber+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lICE $X_EXTRA_LIBS $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -19156,30 +23971,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char IceConnectionNumber ();
 int
-main ()
+main (void)
 {
 return IceConnectionNumber ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_ICE_IceConnectionNumber=yes
-else
+else $as_nop
   ac_cv_lib_ICE_IceConnectionNumber=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_ICE_IceConnectionNumber" >&5
-$as_echo "$ac_cv_lib_ICE_IceConnectionNumber" >&6; }
-if test "x$ac_cv_lib_ICE_IceConnectionNumber" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_ICE_IceConnectionNumber" >&5
+printf "%s\n" "$ac_cv_lib_ICE_IceConnectionNumber" >&6; }
+if test "x$ac_cv_lib_ICE_IceConnectionNumber" = xyes
+then :
   X_PRE_LIBS="$X_PRE_LIBS -lSM -lICE"
 fi
 
@@ -19188,19 +24002,21 @@
 fi
 
 
-   groff_no_x=$no_x
-   if test -z "$groff_no_x"; then
-     OLDCFLAGS=$CFLAGS
-     OLDLDFLAGS=$LDFLAGS
-     OLDLIBS=$LIBS
-     CFLAGS="$CFLAGS $X_CFLAGS"
-     LDFLAGS="$LDFLAGS $X_LIBS"
-     LIBS="$LIBS $X_PRE_LIBS -lX11 $X_EXTRA_LIBS"
-
-     LIBS="$LIBS -lXaw"
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking for Xaw library and header files" >&5
-$as_echo_n "checking for Xaw library and header files... " >&6; }
-     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+
+  groff_no_x=$no_x
+  if test -z "$groff_no_x"
+  then
+    OLDCFLAGS=$CFLAGS
+    OLDLDFLAGS=$LDFLAGS
+    OLDLIBS=$LIBS
+    CFLAGS="$CFLAGS $X_CFLAGS"
+    LDFLAGS="$LDFLAGS $X_LIBS"
+    LIBS="$LIBS $X_PRE_LIBS -lX11 $X_EXTRA_LIBS"
+
+    LIBS="$LIBS -lXaw"
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for Xaw library and header files" >&5
+printf %s "checking for Xaw library and header files... " >&6; }
+    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 
@@ -19210,7 +24026,7 @@
 
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -19218,21 +24034,22 @@
 }
 
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-	groff_no_x="yes"
+if ac_fn_c_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+      groff_no_x=yes
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
-     LIBS="$LIBS -lXmu"
-     { $as_echo "$as_me:${as_lineno-$LINENO}: checking for Xmu library and header files" >&5
-$as_echo_n "checking for Xmu library and header files... " >&6; }
-     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+    LIBS="$LIBS -lXmu"
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for Xmu library and header files" >&5
+printf %s "checking for Xmu library and header files... " >&6; }
+    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 
@@ -19242,7 +24059,7 @@
 
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -19250,77 +24067,67 @@
 }
 
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-	groff_no_x="yes"
+if ac_fn_c_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+      groff_no_x=yes
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
-     CFLAGS=$OLDCFLAGS
-     LDFLAGS=$OLDLDFLAGS
-     LIBS=$OLDLIBS
-   fi
+    CFLAGS=$OLDCFLAGS
+    LDFLAGS=$OLDLDFLAGS
+    LIBS=$OLDLIBS
+  fi
+
+  if ! test "$groff_no_x" = yes
+  then
+    XDEVDIRS="font/devX75 font/devX75-12 font/devX100 font/devX100-12"
+    XPROGDIRS="src/devices/xditview src/utils/xtotroff"
+    XLIBDIRS="src/libs/libxutil"
+  fi
 
-   if test "x$groff_no_x" = "xyes"; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: gxditview and xtotroff won't be built" >&5
-$as_echo "$as_me: gxditview and xtotroff won't be built" >&6;}
-   else
-     XDEVDIRS="font/devX75 font/devX75-12 font/devX100 font/devX100-12"
-     XPROGDIRS="src/devices/xditview src/utils/xtotroff"
-     XLIBDIRS="src/libs/libxutil"
-   fi
 
 
 
 
 
-# Check whether --with-appresdir was given.
-if test "${with_appresdir+set}" = set; then :
-  withval=$with_appresdir;
+
+# Check whether --with-appdefdir was given.
+if test ${with_appdefdir+y}
+then :
+  withval=$with_appdefdir;
 fi
 
+
 if test -z "$groff_no_x"; then
-     if test "x$with_appresdir" = "x"; then
-       if test "x$prefix" = "xNONE"; then
-         appresdir=$ac_default_prefix/lib/X11/app-defaults
+     if test -z "$with_appdefdir"; then
+       if test "$prefix" = NONE; then
+         appdefdir=$ac_default_prefix/lib/X11/app-defaults
        else
-         appresdir=$prefix/lib/X11/app-defaults
+         appdefdir=$prefix/lib/X11/app-defaults
        fi
      else
-       appresdir=$with_appresdir
+       appdefdir=$with_appdefdir
      fi
    fi
 
 libprogramdir=$libdir/groff
 
-
-# Check whether --with-grofferdir was given.
-if test "${with_grofferdir+set}" = set; then :
-  withval=$with_grofferdir;
-fi
-
-if test "x$with_grofferdir" = "x"; then
-    groffer_dir=$libprogramdir/groffer
-  else
-    groffer_dir=$with_grofferdir
-  fi
-
 glilypond_dir=$libprogramdir/glilypond
 
 gpinyin_dir=$libprogramdir/gpinyin
 
-grog_dir=$libprogramdir/grog
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for a sed that does not truncate output" >&5
-$as_echo_n "checking for a sed that does not truncate output... " >&6; }
-if ${ac_cv_path_SED+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for a sed that does not truncate output" >&5
+printf %s "checking for a sed that does not truncate output... " >&6; }
+if test ${ac_cv_path_SED+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
             ac_script=s/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb/
      for ac_i in 1 2 3 4 5 6 7; do
        ac_script="$ac_script$as_nl$ac_script"
@@ -19334,10 +24141,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_prog in sed gsed; do
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_prog in sed gsed
+   do
     for ac_exec_ext in '' $ac_executable_extensions; do
-      ac_path_SED="$as_dir/$ac_prog$ac_exec_ext"
+      ac_path_SED="$as_dir$ac_prog$ac_exec_ext"
       as_fn_executable_p "$ac_path_SED" || continue
 # Check for GNU ac_path_SED and select it if it is found.
   # Check for GNU $ac_path_SED
@@ -19346,13 +24158,13 @@
   ac_cv_path_SED="$ac_path_SED" ac_path_SED_found=:;;
 *)
   ac_count=0
-  $as_echo_n 0123456789 >"conftest.in"
+  printf %s 0123456789 >"conftest.in"
   while :
   do
     cat "conftest.in" "conftest.in" >"conftest.tmp"
     mv "conftest.tmp" "conftest.in"
     cp "conftest.in" "conftest.nl"
-    $as_echo '' >> "conftest.nl"
+    printf "%s\n" '' >> "conftest.nl"
     "$ac_path_SED" -f conftest.sed < "conftest.nl" >"conftest.out" 2>/dev/null || break
     diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
     as_fn_arith $ac_count + 1 && ac_count=$as_val
@@ -19380,19 +24192,21 @@
 fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_SED" >&5
-$as_echo "$ac_cv_path_SED" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_SED" >&5
+printf "%s\n" "$ac_cv_path_SED" >&6; }
  SED="$ac_cv_path_SED"
   rm -f conftest.sed
 
-PERLVERSION=v5.6.1
-   # Extract the first word of "perl", so it can be a program name with args.
+
+  PERLVERSION=v5.6.1
+  # Extract the first word of "perl", so it can be a program name with args.
 set dummy perl; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_path_PERL+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_path_PERL+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   case $PERL in
   \\/* | ?:\\/*)
   ac_cv_path_PERL="$PERL" # Let the user override the test with a path.
@@ -19402,11 +24216,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_path_PERL="$as_dir/$ac_word$ac_exec_ext"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_path_PERL="$as_dir$ac_word$ac_exec_ext"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19419,27 +24237,29 @@
 fi
 PERL=$ac_cv_path_PERL
 if test -n "$PERL"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PERL" >&5
-$as_echo "$PERL" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $PERL" >&5
+printf "%s\n" "$PERL" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-   if test "x$PERL" = "xno"; then
-     as_fn_error 1 "perl binary not found" "$LINENO" 5
-   fi
+  if test "$PERL" = no
+  then
+    as_fn_error 1 "perl binary not found" "$LINENO" 5
+  fi
 
 
 
 
-    if test -n "$PERL"; then :
+    if test -n "$PERL"
+then :
 
         ax_perl_version="$PERLVERSION"
 
-        { $as_echo "$as_me:${as_lineno-$LINENO}: checking for perl version" >&5
-$as_echo_n "checking for perl version... " >&6; }
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for perl version" >&5
+printf %s "checking for perl version... " >&6; }
 
         perl_version=`$PERL --version 2>&1 \
           | $SED -n -e '/This is perl/b inspect
@@ -19447,8 +24267,8 @@
 : inspect
 s/.* (\{0,1\}v$0-9*\.0-9*\.0-9*$)\{0,1\} .*/\1/;p'`
 
-        { $as_echo "$as_me:${as_lineno-$LINENO}: result: $perl_version" >&5
-$as_echo "$perl_version" >&6; }
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $perl_version" >&5
+printf "%s\n" "$perl_version" >&6; }
 
 	PERL_VERSION=$perl_version
 
@@ -19491,31 +24311,34 @@
 
     else
 	    :
-            \
-     as_fn_error 1 "perl version is too old" "$LINENO" 5
+            as_fn_error 1 "perl version is too old" "$LINENO" 5
 
   fi
 
 
-else
+else $as_nop
 
-        { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: could not find the perl interpreter" >&5
-$as_echo "$as_me: WARNING: could not find the perl interpreter" >&2;}
-        \
-     as_fn_error 1 "perl version is too old" "$LINENO" 5
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: could not find the perl interpreter" >&5
+printf "%s\n" "$as_me: WARNING: could not find the perl interpreter" >&2;}
+        as_fn_error 1 "perl version is too old" "$LINENO" 5
 
 fi
 
-if test -z "$PSPRINT"; then
-     for ac_prog in lpr
+
+
+  groff_have_spooler=no
+  if test -z "$PSPRINT"
+  then
+    for ac_prog in lpr
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_LPR+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_LPR+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$LPR"; then
   ac_cv_prog_LPR="$LPR" # Let the user override the test.
 else
@@ -19523,11 +24346,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_LPR="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19538,26 +24365,27 @@
 fi
 LPR=$ac_cv_prog_LPR
 if test -n "$LPR"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LPR" >&5
-$as_echo "$LPR" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $LPR" >&5
+printf "%s\n" "$LPR" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
   test -n "$LPR" && break
 done
 
-     for ac_prog in lp
+    for ac_prog in lp
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_LP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_LP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$LP"; then
   ac_cv_prog_LP="$LP" # Let the user override the test.
 else
@@ -19565,11 +24393,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_LP="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19580,30 +24412,32 @@
 fi
 LP=$ac_cv_prog_LP
 if test -n "$LP"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LP" >&5
-$as_echo "$LP" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $LP" >&5
+printf "%s\n" "$LP" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
   test -n "$LP" && break
 done
 
-     if test -n "$LPR" && test -n "$LP"; then
-       # HP-UX provides an lpr command that emulates lpr using lp,
-       # but it doesn't have lpq; in this case we want to use lp
-       # rather than lpr.
-       for ac_prog in lpq
+    if test -n "$LPR" && test -n "$LP"
+     then
+      # HP-UX provides an lpr command that emulates lpr using lp,
+      # but it doesn't have lpq; in this case we want to use lp
+      # rather than lpr.
+      for ac_prog in lpq
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_LPQ+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_LPQ+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$LPQ"; then
   ac_cv_prog_LPQ="$LPQ" # Let the user override the test.
 else
@@ -19611,11 +24445,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_LPQ="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19626,52 +24464,60 @@
 fi
 LPQ=$ac_cv_prog_LPQ
 if test -n "$LPQ"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LPQ" >&5
-$as_echo "$LPQ" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $LPQ" >&5
+printf "%s\n" "$LPQ" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
   test -n "$LPQ" && break
 done
 
-       test -n "$LPQ" || LPR=
-     fi
-     if test -n "$LPR"; then
-       PSPRINT="$LPR"
-     elif test -n "$LP"; then
-       PSPRINT="$LP"
-     fi
-   fi
+      test -n "$LPQ" || LPR=
+    fi
+    if test -n "$LPR"
+    then
+      PSPRINT="$LPR"
+    elif test -n "$LP"
+    then
+      PSPRINT="$LP"
+    fi
+  fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for command to use for printing PostScript files" >&5
-$as_echo_n "checking for command to use for printing PostScript files... " >&6; }
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PSPRINT" >&5
-$as_echo "$PSPRINT" >&6; }
-
-   # Figure out DVIPRINT from PSPRINT.
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for command to use for printing dvi files" >&5
-$as_echo_n "checking for command to use for printing dvi files... " >&6; }
-   if test -n "$PSPRINT" && test -z "$DVIPRINT"; then
-     if test "x$PSPRINT" = "xlpr"; then
-       DVIPRINT="lpr -d"
-     else
-       DVIPRINT="$PSPRINT"
-     fi
-   fi
+  if test -n "$PSPRINT"
+  then
+    groff_have_spooler="$PSPRINT"
+
+    # Figure out DVIPRINT from PSPRINT.
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking option to use when spooling DVI files" >&5
+printf %s "checking option to use when spooling DVI files... " >&6; }
+    spooler_option=none
+    if test -n "$PSPRINT" && test -z "$DVIPRINT"
+    then
+      if test "$PSPRINT" = lpr
+      then
+        spooler_option=-d
+        DVIPRINT="$PSPRINT $spooler_option"
+      else
+        DVIPRINT="$PSPRINT"
+      fi
+    fi
+
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $spooler_option" >&5
+printf "%s\n" "$spooler_option" >&6; }
+  fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $DVIPRINT" >&5
-$as_echo "$DVIPRINT" >&6; }
 # GROFF_REFER
 referdir=$libprogramdir/refer
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for egrep" >&5
-$as_echo_n "checking for egrep... " >&6; }
-if ${ac_cv_path_EGREP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for egrep" >&5
+printf %s "checking for egrep... " >&6; }
+if test ${ac_cv_path_EGREP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if echo a | $GREP -E '(a|b)' >/dev/null 2>&1
    then ac_cv_path_EGREP="$GREP -E"
    else
@@ -19682,10 +24528,15 @@
 for as_dir in $PATH$PATH_SEPARATOR/usr/xpg4/bin
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_prog in egrep; do
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_prog in egrep
+   do
     for ac_exec_ext in '' $ac_executable_extensions; do
-      ac_path_EGREP="$as_dir/$ac_prog$ac_exec_ext"
+      ac_path_EGREP="$as_dir$ac_prog$ac_exec_ext"
       as_fn_executable_p "$ac_path_EGREP" || continue
 # Check for GNU ac_path_EGREP and select it if it is found.
   # Check for GNU $ac_path_EGREP
@@ -19694,13 +24545,13 @@
   ac_cv_path_EGREP="$ac_path_EGREP" ac_path_EGREP_found=:;;
 *)
   ac_count=0
-  $as_echo_n 0123456789 >"conftest.in"
+  printf %s 0123456789 >"conftest.in"
   while :
   do
     cat "conftest.in" "conftest.in" >"conftest.tmp"
     mv "conftest.tmp" "conftest.in"
     cp "conftest.in" "conftest.nl"
-    $as_echo 'EGREP' >> "conftest.nl"
+    printf "%s\n" 'EGREP' >> "conftest.nl"
     "$ac_path_EGREP" 'EGREP$' < "conftest.nl" >"conftest.out" 2>/dev/null || break
     diff "conftest.out" "conftest.nl" >/dev/null 2>&1 || break
     as_fn_arith $ac_count + 1 && ac_count=$as_val
@@ -19729,20 +24580,22 @@
 
    fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_EGREP" >&5
-$as_echo "$ac_cv_path_EGREP" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_path_EGREP" >&5
+printf "%s\n" "$ac_cv_path_EGREP" >&6; }
  EGREP="$ac_cv_path_EGREP"
 
 
-for ac_prog in byacc 'bison -y' yacc
+
+  for ac_prog in byacc 'bison -y' yacc
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_YACC+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_YACC+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$YACC"; then
   ac_cv_prog_YACC="$YACC" # Let the user override the test.
 else
@@ -19750,11 +24603,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_YACC="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19765,11 +24622,11 @@
 fi
 YACC=$ac_cv_prog_YACC
 if test -n "$YACC"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $YACC" >&5
-$as_echo "$YACC" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $YACC" >&5
+printf "%s\n" "$YACC" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -19777,96 +24634,82 @@
 done
 test -n "$YACC" || YACC="missing"
 
-  if test "x$YACC" = "xmissing" -a -d ${srcdir}/.git; then
-    as_fn_error 1 "Could not find 'yacc' or 'bison'" "$LINENO" 5
+  if ! test -f "$srcdir"/.tarball-version
+  then
+    if test "$YACC" = missing
+    then
+      as_fn_error 1 "could not find 'byacc', 'bison', or 'yacc'" "$LINENO" 5
+    fi
   fi
 
 
-# Check whether --with-doc was given.
-if test "${with_doc+set}" = set; then :
-  withval=$with_doc; doc="$withval"
-else
-  doc=yes
-fi
-
-  test "x$doc" = xno && doc=''
-  if test "x$doc" = xyes; then
-    doc_dist_target_ok=yes
-    docadd_html=yes
-    docadd_info=yes
-    docadd_other=yes
-    docadd_pdf=yes
-    docadd_examples=yes
-  else
-    # Don't use case/esac, verify input.
-    doc_dist_target_ok=no
-    docadd_html=no
-    docadd_info=no
-    docadd_other=no
-    docadd_pdf=no
-    docadd_examples=no
-    OFS=$IFS
-    IFS=','
-    set -- $doc
-    IFS=$OFS
-    for i
-    do
-      test "x$i" = xhtml     && { docadd_html=yes; continue; }
-      test "x$i" = xinfo     && { docadd_info=yes; continue; }
-      test "x$i" = xother    && { docadd_other=yes; continue; }
-      test "x$i" = xpdf      && { docadd_pdf=yes; continue; }
-      test "x$i" = xexamples && { docadd_examples=yes; continue; }
-      { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: Invalid '--with-doc' argument: $i" >&5
-$as_echo "$as_me: WARNING: Invalid '--with-doc' argument: $i" >&2;}
-    done
-  fi
-  if test $docadd_html = yes; then
-    make_install_shipped_htmldoc=install_shipped_htmldoc
-    make_uninstall_shipped_htmldoc=uninstall_shipped_htmldoc
-  else
-    make_install_shipped_htmldoc=
-    make_uninstall_shipped_htmldoc=
-  fi
-  if test $docadd_other = yes; then
-    make_otherdoc=otherdoc
-    make_install_otherdoc=install_otherdoc
-    make_uninstall_otherdoc=uninstall_otherdoc
-  else
-    make_otherdoc=
-    make_install_otherdoc=
-    make_uninstall_otherdoc=
-  fi
-  if test $docadd_examples = yes; then
-    make_examples=examples
-    make_install_examples=install_examples
-    make_uninstall_examples=uninstall_examples
-  else
-    make_examples=
-    make_install_examples=
-    make_uninstall_examples=
+  for ac_prog in m4
+do
+  # Extract the first word of "$ac_prog", so it can be a program name with args.
+set dummy $ac_prog; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_M4+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$M4"; then
+  ac_cv_prog_M4="$M4" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_M4="$ac_prog"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
   fi
+done
+  done
+IFS=$as_save_IFS
 
+fi
+fi
+M4=$ac_cv_prog_M4
+if test -n "$M4"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $M4" >&5
+printf "%s\n" "$M4" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
 
 
+  test -n "$M4" && break
+done
+test -n "$M4" || M4="missing"
 
+  if test "$M4" = missing
+  then
+    as_fn_error 1 "could not find 'm4'" "$LINENO" 5
+  fi
 
 
-
-
-
-# By default automake will set MAKEINFO to MAKEINFO = ${SHELL} <top
-  # src dir>/build-aux/missing makeinfo.As we need a more precise
+  # By default automake will set MAKEINFO to MAKEINFO = ${SHELL} <top
+  # src dir>/build-aux/missing makeinfo.  As we need a more precise
   # check of makeinfo version, we don't use it.
   MAKEINFO=
-   if test $docadd_info = yes; then
-     missing=
-     # Extract the first word of "makeinfo", so it can be a program name with args.
+  missing=
+  # Extract the first word of "makeinfo", so it can be a program name with args.
 set dummy makeinfo; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_MAKEINFO+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_MAKEINFO+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$MAKEINFO"; then
   ac_cv_prog_MAKEINFO="$MAKEINFO" # Let the user override the test.
 else
@@ -19874,11 +24717,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_MAKEINFO="makeinfo"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19889,72 +24736,61 @@
 fi
 MAKEINFO=$ac_cv_prog_MAKEINFO
 if test -n "$MAKEINFO"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $MAKEINFO" >&5
-$as_echo "$MAKEINFO" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $MAKEINFO" >&5
+printf "%s\n" "$MAKEINFO" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-     if test -z "$MAKEINFO"; then
-       missing="'makeinfo' is missing."
-     else
-       { $as_echo "$as_me:${as_lineno-$LINENO}: checking for makeinfo version" >&5
-$as_echo_n "checking for makeinfo version... " >&6; }
-       # We need an additional level of quoting to make sed's regexps work.
-       makeinfo_version=`$MAKEINFO --version 2>&1 \
-        | sed -e 's/^.* $^ ^ *$$/\1/' -e '1q'`
-       { $as_echo "$as_me:${as_lineno-$LINENO}: result: $makeinfo_version" >&5
-$as_echo "$makeinfo_version" >&6; }
-       # Consider only the first two numbers in version number string.
-       makeinfo_version_major=`IFS=.; set x $makeinfo_version; echo 0${2}`
-       makeinfo_version_minor=`IFS=.; set x $makeinfo_version; echo 0${3}`
-       makeinfo_version_numeric=`
-         expr ${makeinfo_version_major}000 \+ ${makeinfo_version_minor}`
-       if test $makeinfo_version_numeric -lt 4008; then
-         missing="'makeinfo' is too old."
-       fi
-     fi
-
-     if test -n "$missing"; then
-       infofile=doc/groff.info
-       test -f ${infofile} || infofile=${srcdir}/${infofile}
-       if test ! -f ${infofile} \
-	|| test ${srcdir}/doc/groff.texi -nt ${infofile}; then
-	 as_fn_error $? "$missing
-Get the 'texinfo' package version 4.8 or newer." "$LINENO" 5
-       else
-	 { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $missing
-Get the 'texinfo' package version 4.8 or newer if you want to convert
-'groff.texi' into a PDF or HTML document." >&5
-$as_echo "$as_me: WARNING: $missing
-Get the 'texinfo' package version 4.8 or newer if you want to convert
-'groff.texi' into a PDF or HTML document." >&2;}
-       fi
-     fi
-
-     make_infodoc=infodoc
-     make_install_infodoc=install_infodoc
-     make_uninstall_infodoc=uninstall_infodoc
-   else
-     make_infodoc=
-     make_install_infodoc=
-     make_uninstall_infodoc=
-     MAKEINFO=
-   fi
+  if test -z "$MAKEINFO"
+  then
+    missing="missing 'makeinfo'"
+  else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for makeinfo version" >&5
+printf %s "checking for makeinfo version... " >&6; }
+    # We need an additional level of quoting to make sed's regexps
+    # work.
+    makeinfo_version=`$MAKEINFO --version 2>&1 \
+     | sed -e 's/^.* $^ ^ *$$/\1/' -e '1q'`
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $makeinfo_version" >&5
+printf "%s\n" "$makeinfo_version" >&6; }
+    # Consider only the first two numbers in version number string.
+    makeinfo_version_major=`IFS=.; set x $makeinfo_version; echo ${2}`
+    makeinfo_version_minor=`IFS=.; set x $makeinfo_version; echo ${3}`
+    makeinfo_version_numeric=`
+      expr ${makeinfo_version_major}000 + $makeinfo_version_minor`
+    if test $makeinfo_version_numeric -lt 5000
+    then
+      missing="'makeinfo' is too old."
+      MAKEINFO=
+    fi
+  fi
 
+  if test -n "$missing"
+  then
+    infofile=doc/groff.info
+    test -f $infofile || infofile="$srcdir"/$infofile
+    if test ! -f $infofile \
+     || test "$srcdir"/doc/groff.texi -nt $infofile
+    then
+      as_fn_error $? "$missing
+Get the 'texinfo' package version 5.0 or newer." "$LINENO" 5
+    fi
+  fi
 
 
 
 
-# Extract the first word of "texi2dvi", so it can be a program name with args.
+  # Extract the first word of "texi2dvi", so it can be a program name with args.
 set dummy texi2dvi; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_PROG_TEXI2DVI+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_PROG_TEXI2DVI+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$PROG_TEXI2DVI"; then
   ac_cv_prog_PROG_TEXI2DVI="$PROG_TEXI2DVI" # Let the user override the test.
 else
@@ -19962,11 +24798,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_PROG_TEXI2DVI="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_PROG_TEXI2DVI="texi2dvi"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -19978,28 +24818,77 @@
 fi
 PROG_TEXI2DVI=$ac_cv_prog_PROG_TEXI2DVI
 if test -n "$PROG_TEXI2DVI"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PROG_TEXI2DVI" >&5
-$as_echo "$PROG_TEXI2DVI" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $PROG_TEXI2DVI" >&5
+printf "%s\n" "$PROG_TEXI2DVI" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-   if test "x$PROG_TEXI2DVI" = "xfound"; then
-      groff_have_texi2dvi=yes;
-   else
-      groff_have_texi2dvi=no;
-   fi
+  groff_have_texi2dvi=no
+  if test "$PROG_TEXI2DVI" != missing && test -n "$MAKEINFO"
+  then
+    groff_have_texi2dvi=yes
+  fi
+
+
+
+  # Extract the first word of "tex", so it can be a program name with args.
+set dummy tex; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_PROG_TEX+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$PROG_TEX"; then
+  ac_cv_prog_PROG_TEX="$PROG_TEX" # Let the user override the test.
+else
+as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
+for as_dir in $PATH
+do
+  IFS=$as_save_IFS
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    for ac_exec_ext in '' $ac_executable_extensions; do
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_PROG_TEX="found"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
+    break 2
+  fi
+done
+  done
+IFS=$as_save_IFS
+
+  test -z "$ac_cv_prog_PROG_TEX" && ac_cv_prog_PROG_TEX="missing"
+fi
+fi
+PROG_TEX=$ac_cv_prog_PROG_TEX
+if test -n "$PROG_TEX"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $PROG_TEX" >&5
+printf "%s\n" "$PROG_TEX" >&6; }
+else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+fi
+
+
+  groff_use_tex=no
+  test "$PROG_TEX" = found && groff_use_tex=yes
 
 if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}ranlib", so it can be a program name with args.
 set dummy ${ac_tool_prefix}ranlib; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_RANLIB+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_RANLIB+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$RANLIB"; then
   ac_cv_prog_RANLIB="$RANLIB" # Let the user override the test.
 else
@@ -20007,11 +24896,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_RANLIB="${ac_tool_prefix}ranlib"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20022,11 +24915,11 @@
 fi
 RANLIB=$ac_cv_prog_RANLIB
 if test -n "$RANLIB"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $RANLIB" >&5
-$as_echo "$RANLIB" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $RANLIB" >&5
+printf "%s\n" "$RANLIB" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -20035,11 +24928,12 @@
   ac_ct_RANLIB=$RANLIB
   # Extract the first word of "ranlib", so it can be a program name with args.
 set dummy ranlib; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_RANLIB+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_RANLIB+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_RANLIB"; then
   ac_cv_prog_ac_ct_RANLIB="$ac_ct_RANLIB" # Let the user override the test.
 else
@@ -20047,11 +24941,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_RANLIB="ranlib"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20062,11 +24960,11 @@
 fi
 ac_ct_RANLIB=$ac_cv_prog_ac_ct_RANLIB
 if test -n "$ac_ct_RANLIB"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_RANLIB" >&5
-$as_echo "$ac_ct_RANLIB" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_RANLIB" >&5
+printf "%s\n" "$ac_ct_RANLIB" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_ct_RANLIB" = x; then
@@ -20074,8 +24972,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     RANLIB=$ac_ct_RANLIB
@@ -20087,16 +24985,16 @@
 
    ac_dir=`cd $ac_aux_dir; pwd`
    ac_install_sh="$ac_dir/install-sh -c"
-if test $docadd_info = yes; then
-     for ac_prog in install-info
+for ac_prog in install-info
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_INSTALL_INFO+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_INSTALL_INFO+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$INSTALL_INFO"; then
   ac_cv_prog_INSTALL_INFO="$INSTALL_INFO" # Let the user override the test.
 else
@@ -20104,11 +25002,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_INSTALL_INFO="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20119,11 +25021,11 @@
 fi
 INSTALL_INFO=$ac_cv_prog_INSTALL_INFO
 if test -n "$INSTALL_INFO"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $INSTALL_INFO" >&5
-$as_echo "$INSTALL_INFO" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $INSTALL_INFO" >&5
+printf "%s\n" "$INSTALL_INFO" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -20131,27 +25033,27 @@
 done
 test -n "$INSTALL_INFO" || INSTALL_INFO=":"
 
-   fi
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ln -s works" >&5
-$as_echo_n "checking whether ln -s works... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ln -s works" >&5
+printf %s "checking whether ln -s works... " >&6; }
 LN_S=$as_ln_s
 if test "$LN_S" = "ln -s"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no, using $LN_S" >&5
-$as_echo "no, using $LN_S" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no, using $LN_S" >&5
+printf "%s\n" "no, using $LN_S" >&6; }
 fi
 
 
 # Extract the first word of "xpmtoppm", so it can be a program name with args.
 set dummy xpmtoppm; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_XPMTOPPM+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_XPMTOPPM+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$XPMTOPPM"; then
   ac_cv_prog_XPMTOPPM="$XPMTOPPM" # Let the user override the test.
 else
@@ -20159,11 +25061,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_XPMTOPPM="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20175,11 +25081,11 @@
 fi
 XPMTOPPM=$ac_cv_prog_XPMTOPPM
 if test -n "$XPMTOPPM"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $XPMTOPPM" >&5
-$as_echo "$XPMTOPPM" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $XPMTOPPM" >&5
+printf "%s\n" "$XPMTOPPM" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -20194,11 +25100,12 @@
 	if test -n "$ac_tool_prefix"; then
   # Extract the first word of "${ac_tool_prefix}pkg-config", so it can be a program name with args.
 set dummy ${ac_tool_prefix}pkg-config; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_path_PKG_CONFIG+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_path_PKG_CONFIG+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   case $PKG_CONFIG in
   \\/* | ?:\\/*)
   ac_cv_path_PKG_CONFIG="$PKG_CONFIG" # Let the user override the test with a path.
@@ -20208,11 +25115,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_path_PKG_CONFIG="$as_dir/$ac_word$ac_exec_ext"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_path_PKG_CONFIG="$as_dir$ac_word$ac_exec_ext"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20224,11 +25135,11 @@
 fi
 PKG_CONFIG=$ac_cv_path_PKG_CONFIG
 if test -n "$PKG_CONFIG"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PKG_CONFIG" >&5
-$as_echo "$PKG_CONFIG" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $PKG_CONFIG" >&5
+printf "%s\n" "$PKG_CONFIG" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -20237,11 +25148,12 @@
   ac_pt_PKG_CONFIG=$PKG_CONFIG
   # Extract the first word of "pkg-config", so it can be a program name with args.
 set dummy pkg-config; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_path_ac_pt_PKG_CONFIG+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_path_ac_pt_PKG_CONFIG+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   case $ac_pt_PKG_CONFIG in
   \\/* | ?:\\/*)
   ac_cv_path_ac_pt_PKG_CONFIG="$ac_pt_PKG_CONFIG" # Let the user override the test with a path.
@@ -20251,11 +25163,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_path_ac_pt_PKG_CONFIG="$as_dir/$ac_word$ac_exec_ext"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_path_ac_pt_PKG_CONFIG="$as_dir$ac_word$ac_exec_ext"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -20267,11 +25183,11 @@
 fi
 ac_pt_PKG_CONFIG=$ac_cv_path_ac_pt_PKG_CONFIG
 if test -n "$ac_pt_PKG_CONFIG"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_pt_PKG_CONFIG" >&5
-$as_echo "$ac_pt_PKG_CONFIG" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_pt_PKG_CONFIG" >&5
+printf "%s\n" "$ac_pt_PKG_CONFIG" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
   if test "x$ac_pt_PKG_CONFIG" = x; then
@@ -20279,8 +25195,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     PKG_CONFIG=$ac_pt_PKG_CONFIG
@@ -20292,37 +25208,40 @@
 fi
 if test -n "$PKG_CONFIG"; then
 	_pkg_min_version=0.9.0
-	{ $as_echo "$as_me:${as_lineno-$LINENO}: checking pkg-config is at least version $_pkg_min_version" >&5
-$as_echo_n "checking pkg-config is at least version $_pkg_min_version... " >&6; }
+	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking pkg-config is at least version $_pkg_min_version" >&5
+printf %s "checking pkg-config is at least version $_pkg_min_version... " >&6; }
 	if $PKG_CONFIG --atleast-pkgconfig-version $_pkg_min_version; then
-		{ $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+		{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 	else
-		{ $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+		{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 		PKG_CONFIG=""
 	fi
 fi
 
+
 # Check whether --with-uchardet was given.
-if test "${with_uchardet+set}" = set; then :
+if test ${with_uchardet+y}
+then :
   withval=$with_uchardet;
 fi
 
-   if test "x$with_uchardet" != "xno"; then :
+    if test "$with_uchardet" != no
+then :
 
 pkg_failed=no
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for UCHARDET" >&5
-$as_echo_n "checking for UCHARDET... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for UCHARDET" >&5
+printf %s "checking for UCHARDET... " >&6; }
 
 if test -n "$UCHARDET_CFLAGS"; then
     pkg_cv_UCHARDET_CFLAGS="$UCHARDET_CFLAGS"
  elif test -n "$PKG_CONFIG"; then
     if test -n "$PKG_CONFIG" && \
-    { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"uchardet >= 0.0.1\""; } >&5
+    { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"uchardet >= 0.0.1\""; } >&5
   ($PKG_CONFIG --exists --print-errors "uchardet >= 0.0.1") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }; then
   pkg_cv_UCHARDET_CFLAGS=`$PKG_CONFIG --cflags "uchardet >= 0.0.1" 2>/dev/null`
 		      test "x$?" != "x0" && pkg_failed=yes
@@ -20336,10 +25255,10 @@
     pkg_cv_UCHARDET_LIBS="$UCHARDET_LIBS"
  elif test -n "$PKG_CONFIG"; then
     if test -n "$PKG_CONFIG" && \
-    { { $as_echo "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"uchardet >= 0.0.1\""; } >&5
+    { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$PKG_CONFIG --exists --print-errors \"uchardet >= 0.0.1\""; } >&5
   ($PKG_CONFIG --exists --print-errors "uchardet >= 0.0.1") 2>&5
   ac_status=$?
-  $as_echo "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
+  printf "%s\n" "$as_me:${as_lineno-$LINENO}: \$? = $ac_status" >&5
   test $ac_status = 0; }; then
   pkg_cv_UCHARDET_LIBS=`$PKG_CONFIG --libs "uchardet >= 0.0.1" 2>/dev/null`
 		      test "x$?" != "x0" && pkg_failed=yes
@@ -20353,8 +25272,8 @@
 
 
 if test $pkg_failed = yes; then
-   	{ $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+   	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 
 if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
         _pkg_short_errors_supported=yes
@@ -20369,172 +25288,46 @@
 	# Put the nasty error message in config.log where it belongs
 	echo "$UCHARDET_PKG_ERRORS" >&5
 
-	if test "x$with_uchardet" = "xyes"; then
-                               { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-as_fn_error $? "Could not found uchardet library
+
+          if test "$with_uchardet" = yes
+          then
+            { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error $? "could not find uchardet library
 See \`config.log' for more details" "$LINENO" 5; }
-                             else
-                               { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: uchardet library not found, preconv \
-might not work properly" >&5
-$as_echo "$as_me: WARNING: uchardet library not found, preconv \
-might not work properly" >&2;}
-                             fi
-                             groff_have_uchardet=no
+          fi
+          groff_have_uchardet=no
 elif test $pkg_failed = untried; then
-     	{ $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-	if test "x$with_uchardet" = "xyes"; then
-                               { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-as_fn_error $? "Could not found uchardet library
+     	{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+
+          if test "$with_uchardet" = yes
+          then
+            { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error $? "could not find uchardet library
 See \`config.log' for more details" "$LINENO" 5; }
-                             else
-                               { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: uchardet library not found, preconv \
-might not work properly" >&5
-$as_echo "$as_me: WARNING: uchardet library not found, preconv \
-might not work properly" >&2;}
-                             fi
-                             groff_have_uchardet=no
+          fi
+          groff_have_uchardet=no
 else
 	UCHARDET_CFLAGS=$pkg_cv_UCHARDET_CFLAGS
 	UCHARDET_LIBS=$pkg_cv_UCHARDET_LIBS
-        { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 
-$as_echo "#define HAVE_UCHARDET 1" >>confdefs.h
+printf "%s\n" "#define HAVE_UCHARDET 1" >>confdefs.h
 
-                             groff_have_uchardet=yes
+        groff_have_uchardet=yes
 fi
-else
+else $as_nop
   groff_have_uchardet=no
-
-fi
-# Extract the first word of "pdfinfo", so it can be a program name with args.
-set dummy pdfinfo; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_PDFINFO+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$PDFINFO"; then
-  ac_cv_prog_PDFINFO="$PDFINFO" # Let the user override the test.
-else
-as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
-for as_dir in $PATH
-do
-  IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_PDFINFO="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
-    break 2
-  fi
-done
-  done
-IFS=$as_save_IFS
-
-  test -z "$ac_cv_prog_PDFINFO" && ac_cv_prog_PDFINFO="missing"
-fi
-fi
-PDFINFO=$ac_cv_prog_PDFINFO
-if test -n "$PDFINFO"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PDFINFO" >&5
-$as_echo "$PDFINFO" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-fi
-
-
-   # Extract the first word of "pdffonts", so it can be a program name with args.
-set dummy pdffonts; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_PDFFONTS+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$PDFFONTS"; then
-  ac_cv_prog_PDFFONTS="$PDFFONTS" # Let the user override the test.
-else
-as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
-for as_dir in $PATH
-do
-  IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_PDFFONTS="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
-    break 2
-  fi
-done
-  done
-IFS=$as_save_IFS
-
-  test -z "$ac_cv_prog_PDFFONTS" && ac_cv_prog_PDFFONTS="missing"
-fi
-fi
-PDFFONTS=$ac_cv_prog_PDFFONTS
-if test -n "$PDFFONTS"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PDFFONTS" >&5
-$as_echo "$PDFFONTS" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-fi
-
-
-   # Extract the first word of "pdfimages", so it can be a program name with args.
-set dummy pdfimages; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_PDFIMAGES+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$PDFIMAGES"; then
-  ac_cv_prog_PDFIMAGES="$PDFIMAGES" # Let the user override the test.
-else
-as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
-for as_dir in $PATH
-do
-  IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_PDFIMAGES="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
-    break 2
-  fi
-done
-  done
-IFS=$as_save_IFS
-
-  test -z "$ac_cv_prog_PDFIMAGES" && ac_cv_prog_PDFIMAGES="missing"
-fi
-fi
-PDFIMAGES=$ac_cv_prog_PDFIMAGES
-if test -n "$PDFIMAGES"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PDFIMAGES" >&5
-$as_echo "$PDFIMAGES" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
 fi
 
 
-   if test "x$PDFINFO" = "xfound" -a "x$PDFFONTS" = "xfound" -a "x$PDFIMAGES" = "xfound"; then
-      groff_have_pdftools=yes;
-   else
-      groff_have_pdftools=no;
-   fi
-
-
 # use a dummy substitution if no csh hack is necessary to avoid errors
 # with non-GNU sed programs
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for csh hash hack" >&5
-$as_echo_n "checking for csh hash hack... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for csh hash hack" >&5
+printf %s "checking for csh hash hack... " >&6; }
 
 cat <<EOF >conftest.sh
 #! /bin/sh
@@ -20545,47 +25338,112 @@
 
    chmod +x conftest.sh
    if echo ./conftest.sh | (csh >/dev/null 2>&1) >/dev/null 2>&1; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
      SH_SCRIPT_SED_CMD='1s/.*/:/'
    else
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
      SH_SCRIPT_SED_CMD='1s/a/a/'
    fi
    rm -f conftest.sh
 
 
 # checks for headers
-for ac_header in stddef.h stdlib.h unistd.h dirent.h limits.h sys/dir.h \
-                  string.h strings.h math.h sys/time.h direct.h process.h
-do :
-  as_ac_Header=`$as_echo "ac_cv_header_$ac_header" | $as_tr_sh`
-ac_fn_c_check_header_mongrel "$LINENO" "$ac_header" "$as_ac_Header" "$ac_includes_default"
-if eval test \"x\$"$as_ac_Header"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_header" | $as_tr_cpp` 1
-_ACEOF
+ac_fn_c_check_header_compile "$LINENO" "stdbool.h" "ac_cv_header_stdbool_h" "$ac_includes_default"
+if test "x$ac_cv_header_stdbool_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STDBOOL_H 1" >>confdefs.h
 
 fi
+ac_fn_c_check_header_compile "$LINENO" "stddef.h" "ac_cv_header_stddef_h" "$ac_includes_default"
+if test "x$ac_cv_header_stddef_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STDDEF_H 1" >>confdefs.h
 
-done
+fi
+ac_fn_c_check_header_compile "$LINENO" "stdlib.h" "ac_cv_header_stdlib_h" "$ac_includes_default"
+if test "x$ac_cv_header_stdlib_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STDLIB_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "unistd.h" "ac_cv_header_unistd_h" "$ac_includes_default"
+if test "x$ac_cv_header_unistd_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_UNISTD_H 1" >>confdefs.h
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for ISC 3.x or 4.x" >&5
-$as_echo_n "checking for ISC 3.x or 4.x... " >&6; }
+fi
+ac_fn_c_check_header_compile "$LINENO" "dirent.h" "ac_cv_header_dirent_h" "$ac_includes_default"
+if test "x$ac_cv_header_dirent_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_DIRENT_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "limits.h" "ac_cv_header_limits_h" "$ac_includes_default"
+if test "x$ac_cv_header_limits_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_LIMITS_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "sys/dir.h" "ac_cv_header_sys_dir_h" "$ac_includes_default"
+if test "x$ac_cv_header_sys_dir_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_SYS_DIR_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "string.h" "ac_cv_header_string_h" "$ac_includes_default"
+if test "x$ac_cv_header_string_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRING_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "strings.h" "ac_cv_header_strings_h" "$ac_includes_default"
+if test "x$ac_cv_header_strings_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRINGS_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "math.h" "ac_cv_header_math_h" "$ac_includes_default"
+if test "x$ac_cv_header_math_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_MATH_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "sys/time.h" "ac_cv_header_sys_time_h" "$ac_includes_default"
+if test "x$ac_cv_header_sys_time_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_SYS_TIME_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "direct.h" "ac_cv_header_direct_h" "$ac_includes_default"
+if test "x$ac_cv_header_direct_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_DIRECT_H 1" >>confdefs.h
+
+fi
+ac_fn_c_check_header_compile "$LINENO" "process.h" "ac_cv_header_process_h" "$ac_includes_default"
+if test "x$ac_cv_header_process_h" = xyes
+then :
+  printf "%s\n" "#define HAVE_PROCESS_H 1" >>confdefs.h
+
+fi
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ISC 3.x or 4.x" >&5
+printf %s "checking for ISC 3.x or 4.x... " >&6; }
    if grep '34\.' /usr/options/cb.name >/dev/null 2>&1
    then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 
-$as_echo "#define _SYSV3 1" >>confdefs.h
+printf "%s\n" "#define _SYSV3 1" >>confdefs.h
 
    else
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
    fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether -D_POSIX_SOURCE is necessary" >&5
-$as_echo_n "checking whether -D_POSIX_SOURCE is necessary... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether -D_POSIX_SOURCE is necessary" >&5
+printf %s "checking whether -D_POSIX_SOURCE is necessary... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -20602,7 +25460,7 @@
 
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -20610,17 +25468,18 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
 
-$as_echo "#define _POSIX_SOURCE 1" >>confdefs.h
+printf "%s\n" "#define _POSIX_SOURCE 1" >>confdefs.h
 
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -20635,8 +25494,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for return type of srand" >&5
-$as_echo_n "checking for return type of srand... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for return type of srand" >&5
+printf %s "checking for return type of srand... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -20647,7 +25506,7 @@
 
 
 int
-main ()
+main (void)
 {
 
   ;
@@ -20655,34 +25514,36 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: void" >&5
-$as_echo "void" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: void" >&5
+printf "%s\n" "void" >&6; }
 
-$as_echo "#define RET_TYPE_SRAND_IS_VOID 1" >>confdefs.h
+printf "%s\n" "#define RET_TYPE_SRAND_IS_VOID 1" >>confdefs.h
 
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: int" >&5
-$as_echo "int" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: int" >&5
+printf "%s\n" "int" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether gettimeofday must be declared" >&5
-$as_echo_n "checking whether gettimeofday must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether gettimeofday must be declared" >&5
+printf %s "checking whether gettimeofday must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_gettimeofday+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_gettimeofday+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -20710,7 +25571,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -20724,19 +25585,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_gettimeofday=no
-else
+else $as_nop
   groff_cv_decl_needed_gettimeofday=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_gettimeofday" >&5
-$as_echo "$groff_cv_decl_needed_gettimeofday" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_gettimeofday" >&5
+printf "%s\n" "$groff_cv_decl_needed_gettimeofday" >&6; }
    if test $groff_cv_decl_needed_gettimeofday = yes; then
 
-$as_echo "#define NEED_DECLARATION_GETTIMEOFDAY 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_GETTIMEOFDAY 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -20745,17 +25607,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether popen must be declared" >&5
-$as_echo_n "checking whether popen must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether popen must be declared" >&5
+printf %s "checking whether popen must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_popen+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_popen+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -20783,7 +25646,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -20797,19 +25660,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_popen=no
-else
+else $as_nop
   groff_cv_decl_needed_popen=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_popen" >&5
-$as_echo "$groff_cv_decl_needed_popen" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_popen" >&5
+printf "%s\n" "$groff_cv_decl_needed_popen" >&6; }
    if test $groff_cv_decl_needed_popen = yes; then
 
-$as_echo "#define NEED_DECLARATION_POPEN 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_POPEN 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -20818,17 +25682,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether pclose must be declared" >&5
-$as_echo_n "checking whether pclose must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether pclose must be declared" >&5
+printf %s "checking whether pclose must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_pclose+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_pclose+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -20856,7 +25721,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -20870,19 +25735,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_pclose=no
-else
+else $as_nop
   groff_cv_decl_needed_pclose=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_pclose" >&5
-$as_echo "$groff_cv_decl_needed_pclose" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_pclose" >&5
+printf "%s\n" "$groff_cv_decl_needed_pclose" >&6; }
    if test $groff_cv_decl_needed_pclose = yes; then
 
-$as_echo "#define NEED_DECLARATION_PCLOSE 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_PCLOSE 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -20891,17 +25757,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether putenv must be declared" >&5
-$as_echo_n "checking whether putenv must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether putenv must be declared" >&5
+printf %s "checking whether putenv must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_putenv+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_putenv+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -20929,7 +25796,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -20943,19 +25810,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_putenv=no
-else
+else $as_nop
   groff_cv_decl_needed_putenv=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_putenv" >&5
-$as_echo "$groff_cv_decl_needed_putenv" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_putenv" >&5
+printf "%s\n" "$groff_cv_decl_needed_putenv" >&6; }
    if test $groff_cv_decl_needed_putenv = yes; then
 
-$as_echo "#define NEED_DECLARATION_PUTENV 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_PUTENV 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -20964,17 +25832,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether rand must be declared" >&5
-$as_echo_n "checking whether rand must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether rand must be declared" >&5
+printf %s "checking whether rand must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_rand+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_rand+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21002,7 +25871,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21016,19 +25885,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_rand=no
-else
+else $as_nop
   groff_cv_decl_needed_rand=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_rand" >&5
-$as_echo "$groff_cv_decl_needed_rand" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_rand" >&5
+printf "%s\n" "$groff_cv_decl_needed_rand" >&6; }
    if test $groff_cv_decl_needed_rand = yes; then
 
-$as_echo "#define NEED_DECLARATION_RAND 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_RAND 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -21037,17 +25907,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether srand must be declared" >&5
-$as_echo_n "checking whether srand must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether srand must be declared" >&5
+printf %s "checking whether srand must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_srand+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_srand+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21075,7 +25946,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21089,19 +25960,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_srand=no
-else
+else $as_nop
   groff_cv_decl_needed_srand=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_srand" >&5
-$as_echo "$groff_cv_decl_needed_srand" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_srand" >&5
+printf "%s\n" "$groff_cv_decl_needed_srand" >&6; }
    if test $groff_cv_decl_needed_srand = yes; then
 
-$as_echo "#define NEED_DECLARATION_SRAND 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_SRAND 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -21110,17 +25982,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether strcasecmp must be declared" >&5
-$as_echo_n "checking whether strcasecmp must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether strcasecmp must be declared" >&5
+printf %s "checking whether strcasecmp must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_strcasecmp+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_strcasecmp+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21148,7 +26021,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21162,19 +26035,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_strcasecmp=no
-else
+else $as_nop
   groff_cv_decl_needed_strcasecmp=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_strcasecmp" >&5
-$as_echo "$groff_cv_decl_needed_strcasecmp" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_strcasecmp" >&5
+printf "%s\n" "$groff_cv_decl_needed_strcasecmp" >&6; }
    if test $groff_cv_decl_needed_strcasecmp = yes; then
 
-$as_echo "#define NEED_DECLARATION_STRCASECMP 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_STRCASECMP 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -21183,17 +26057,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether strncasecmp must be declared" >&5
-$as_echo_n "checking whether strncasecmp must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether strncasecmp must be declared" >&5
+printf %s "checking whether strncasecmp must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_strncasecmp+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_strncasecmp+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21221,7 +26096,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21235,19 +26110,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_strncasecmp=no
-else
+else $as_nop
   groff_cv_decl_needed_strncasecmp=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_strncasecmp" >&5
-$as_echo "$groff_cv_decl_needed_strncasecmp" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_strncasecmp" >&5
+printf "%s\n" "$groff_cv_decl_needed_strncasecmp" >&6; }
    if test $groff_cv_decl_needed_strncasecmp = yes; then
 
-$as_echo "#define NEED_DECLARATION_STRNCASECMP 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_STRNCASECMP 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -21256,17 +26132,18 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether vfprintf must be declared" >&5
-$as_echo_n "checking whether vfprintf must be declared... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether vfprintf must be declared" >&5
+printf %s "checking whether vfprintf must be declared... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   if ${groff_cv_decl_needed_vfprintf+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+   if test ${groff_cv_decl_needed_vfprintf+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21294,7 +26171,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21308,19 +26185,20 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_decl_needed_vfprintf=no
-else
+else $as_nop
   groff_cv_decl_needed_vfprintf=yes
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_vfprintf" >&5
-$as_echo "$groff_cv_decl_needed_vfprintf" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_decl_needed_vfprintf" >&5
+printf "%s\n" "$groff_cv_decl_needed_vfprintf" >&6; }
    if test $groff_cv_decl_needed_vfprintf = yes; then
 
-$as_echo "#define NEED_DECLARATION_VFPRINTF 1" >>confdefs.h
+printf "%s\n" "#define NEED_DECLARATION_VFPRINTF 1" >>confdefs.h
 
    fi
    ac_ext=c
@@ -21335,8 +26213,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for sys_nerr in <errno.h>, <stdio.h>, or <stdlib.h>" >&5
-$as_echo_n "checking for sys_nerr in <errno.h>, <stdio.h>, or <stdlib.h>... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for sys_nerr in <errno.h>, <stdio.h>, or <stdlib.h>" >&5
+printf %s "checking for sys_nerr in <errno.h>, <stdio.h>, or <stdlib.h>... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21348,7 +26226,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21361,25 +26239,26 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_SYS_NERR 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_SYS_NERR 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for sys_errlist in <errno.h>, <stdio.h>, or <stdlib.h>" >&5
-$as_echo_n "checking for sys_errlist in <errno.h>, <stdio.h>, or <stdlib.h>... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for sys_errlist in <errno.h>, <stdio.h>, or <stdlib.h>" >&5
+printf %s "checking for sys_errlist in <errno.h>, <stdio.h>, or <stdlib.h>... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21391,7 +26270,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21404,25 +26283,26 @@
 }
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_SYS_ERRLIST 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_c_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_SYS_ERRLIST 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking C++ <osfcn.h>" >&5
-$as_echo_n "checking C++ <osfcn.h>... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking C++ <osfcn.h>" >&5
+printf %s "checking C++ <osfcn.h>... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21432,7 +26312,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21445,17 +26325,18 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_CC_OSFCN_H 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_CC_OSFCN_H 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -21468,8 +26349,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking C++ <limits.h>" >&5
-$as_echo_n "checking C++ <limits.h>... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking C++ <limits.h>" >&5
+printf %s "checking C++ <limits.h>... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21479,7 +26360,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21493,17 +26374,18 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_CC_LIMITS_H 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_CC_LIMITS_H 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -21516,8 +26398,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking C++ <inttypes.h>" >&5
-$as_echo_n "checking C++ <inttypes.h>... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking C++ <inttypes.h>" >&5
+printf %s "checking C++ <inttypes.h>... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21528,7 +26410,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21540,17 +26422,18 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   groff_cv_header_inttypes_h=yes
 
-$as_echo "#define HAVE_CC_INTTYPES_H 1" >>confdefs.h
+printf "%s\n" "#define HAVE_CC_INTTYPES_H 1" >>confdefs.h
 
-else
+else $as_nop
   groff_cv_header_inttypes_h=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_header_inttypes_h" >&5
-$as_echo "$groff_cv_header_inttypes_h" >&6; }
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_header_inttypes_h" >&5
+printf "%s\n" "$groff_cv_header_inttypes_h" >&6; }
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -21565,8 +26448,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for unsigned long long" >&5
-$as_echo_n "checking for unsigned long long... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for unsigned long long" >&5
+printf %s "checking for unsigned long long... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21578,7 +26461,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21590,15 +26473,16 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_link "$LINENO"; then :
+if ac_fn_cxx_try_link "$LINENO"
+then :
   groff_cv_type_unsigned_long_long=yes
-else
+else $as_nop
   groff_cv_type_unsigned_long_long=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_cv_type_unsigned_long_long" >&5
-$as_echo "$groff_cv_type_unsigned_long_long" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_cv_type_unsigned_long_long" >&5
+printf "%s\n" "$groff_cv_type_unsigned_long_long" >&6; }
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -21612,9 +26496,7 @@
 	  && ac_type='unsigned long long' \
 	  || ac_type='unsigned long'
 
-cat >>confdefs.h <<_ACEOF
-#define uintmax_t $ac_type
-_ACEOF
+printf "%s\n" "#define uintmax_t $ac_type" >>confdefs.h
 
    fi
 ac_ext=cpp
@@ -21623,8 +26505,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking for declaration of time_t" >&5
-$as_echo_n "checking for declaration of time_t... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for declaration of time_t" >&5
+printf %s "checking for declaration of time_t... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21634,7 +26516,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21647,25 +26529,26 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 
-$as_echo "#define LONG_FOR_TIME_T 1" >>confdefs.h
+printf "%s\n" "#define LONG_FOR_TIME_T 1" >>confdefs.h
 
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for return type of signal handlers" >&5
-$as_echo_n "checking for return type of signal handlers... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for return type of signal handlers" >&5
+printf %s "checking for return type of signal handlers... " >&6; }
    for groff_declaration in \
      'extern "C" void (*signal (int, void (*)(int)))(int);' \
      'extern "C" void (*signal (int, void (*)(int)) throw ())(int);' \
@@ -21685,7 +26568,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21697,29 +26580,30 @@
 }
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   break
-else
+else $as_nop
   continue
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    done
 
    if test -n "$groff_declaration"; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: void" >&5
-$as_echo "void" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: void" >&5
+printf "%s\n" "void" >&6; }
 
-$as_echo "#define RETSIGTYPE void" >>confdefs.h
+printf "%s\n" "#define RETSIGTYPE void" >>confdefs.h
 
    else
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: int" >&5
-$as_echo "int" >&6; }
+     { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: int" >&5
+printf "%s\n" "int" >&6; }
 
-$as_echo "#define RETSIGTYPE int" >>confdefs.h
+printf "%s\n" "#define RETSIGTYPE int" >>confdefs.h
 
    fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking struct exception" >&5
-$as_echo_n "checking struct exception... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking struct exception" >&5
+printf %s "checking struct exception... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -21729,7 +26613,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -21741,24 +26625,26 @@
 }
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_STRUCT_EXCEPTION 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_c_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_STRUCT_EXCEPTION 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 
 # check endianness
- { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether byte ordering is bigendian" >&5
-$as_echo_n "checking whether byte ordering is bigendian... " >&6; }
-if ${ac_cv_c_bigendian+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+ { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether byte ordering is bigendian" >&5
+printf %s "checking whether byte ordering is bigendian... " >&6; }
+if test ${ac_cv_c_bigendian+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_cv_c_bigendian=unknown
     # See if we're dealing with a universal compiler.
     cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -21769,7 +26655,8 @@
 	     typedef int dummy;
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
 
 	# Check for potential -arch flags.  It is not universal unless
 	# there are at least two -arch flags with different values.
@@ -21793,7 +26680,7 @@
 	 fi
        done
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     if test $ac_cv_c_bigendian = unknown; then
       # See if sys/param.h defines the BYTE_ORDER macro.
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -21802,7 +26689,7 @@
 	     #include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined BYTE_ORDER && defined BIG_ENDIAN \
 		     && defined LITTLE_ENDIAN && BYTE_ORDER && BIG_ENDIAN \
@@ -21814,7 +26701,8 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -21822,7 +26710,7 @@
 		#include <sys/param.h>
 
 int
-main ()
+main (void)
 {
 #if BYTE_ORDER != BIG_ENDIAN
 		 not big endian
@@ -21832,14 +26720,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # See if <limits.h> defines _LITTLE_ENDIAN or _BIG_ENDIAN (e.g., Solaris).
@@ -21848,7 +26737,7 @@
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #if ! (defined _LITTLE_ENDIAN || defined _BIG_ENDIAN)
 	      bogus endian macros
@@ -21858,14 +26747,15 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   # It does; now see whether it defined to _BIG_ENDIAN or not.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <limits.h>
 
 int
-main ()
+main (void)
 {
 #ifndef _BIG_ENDIAN
 		 not big endian
@@ -21875,31 +26765,33 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   ac_cv_c_bigendian=yes
-else
+else $as_nop
   ac_cv_c_bigendian=no
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
     fi
     if test $ac_cv_c_bigendian = unknown; then
       # Compile a test program.
-      if test "$cross_compiling" = yes; then :
+      if test "$cross_compiling" = yes
+then :
   # Try to guess by grepping values from an object file.
 	 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-short int ascii_mm =
+unsigned short int ascii_mm =
 		  { 0x4249, 0x4765, 0x6E44, 0x6961, 0x6E53, 0x7953, 0 };
-		short int ascii_ii =
+		unsigned short int ascii_ii =
 		  { 0x694C, 0x5454, 0x656C, 0x6E45, 0x6944, 0x6E61, 0 };
 		int use_ascii (int i) {
 		  return ascii_mmi + ascii_iii;
 		}
-		short int ebcdic_ii =
+		unsigned short int ebcdic_ii =
 		  { 0x89D3, 0xE3E3, 0x8593, 0x95C5, 0x89C4, 0x9581, 0 };
-		short int ebcdic_mm =
+		unsigned short int ebcdic_mm =
 		  { 0xC2C9, 0xC785, 0x95C4, 0x8981, 0x95E2, 0xA8E2, 0 };
 		int use_ebcdic (int i) {
 		  return ebcdic_mmi + ebcdic_iii;
@@ -21907,14 +26799,15 @@
 		extern int foo;
 
 int
-main ()
+main (void)
 {
 return use_ascii (foo) == use_ebcdic (foo);
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   if grep BIGenDianSyS conftest.$ac_objext >/dev/null; then
 	      ac_cv_c_bigendian=yes
 	    fi
@@ -21927,13 +26820,13 @@
 	      fi
 	    fi
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-else
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $ac_includes_default
 int
-main ()
+main (void)
 {
 
 	     /* Are we little or big endian?  From Harbison&Steele.  */
@@ -21949,9 +26842,10 @@
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   ac_cv_c_bigendian=no
-else
+else $as_nop
   ac_cv_c_bigendian=yes
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -21960,17 +26854,17 @@
 
     fi
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_bigendian" >&5
-$as_echo "$ac_cv_c_bigendian" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_c_bigendian" >&5
+printf "%s\n" "$ac_cv_c_bigendian" >&6; }
  case $ac_cv_c_bigendian in #(
    yes)
-     $as_echo "#define WORDS_BIGENDIAN 1" >>confdefs.h
+     printf "%s\n" "#define WORDS_BIGENDIAN 1" >>confdefs.h
 ;; #(
    no)
       ;; #(
    universal)
 
-$as_echo "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
+printf "%s\n" "#define AC_APPLE_UNIVERSAL_BUILD 1" >>confdefs.h
 
      ;; #(
    *)
@@ -21980,11 +26874,12 @@
 
 
 # checks for libraries
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for main in -lc" >&5
-$as_echo_n "checking for main in -lc... " >&6; }
-if ${ac_cv_lib_c_main+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for main in -lc" >&5
+printf %s "checking for main in -lc... " >&6; }
+if test ${ac_cv_lib_c_main+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lc  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -21992,34 +26887,37 @@
 
 
 int
-main ()
+main (void)
 {
 return main ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_c_main=yes
-else
+else $as_nop
   ac_cv_lib_c_main=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_c_main" >&5
-$as_echo "$ac_cv_lib_c_main" >&6; }
-if test "x$ac_cv_lib_c_main" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_c_main" >&5
+printf "%s\n" "$ac_cv_lib_c_main" >&6; }
+if test "x$ac_cv_lib_c_main" = xyes
+then :
   LIBC=-lc
 fi
 
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for sin in -lm" >&5
-$as_echo_n "checking for sin in -lm... " >&6; }
-if ${ac_cv_lib_m_sin+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for sin in -lm" >&5
+printf %s "checking for sin in -lm... " >&6; }
+if test ${ac_cv_lib_m_sin+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   ac_check_lib_save_LIBS=$LIBS
 LIBS="-lm  $LIBS"
 cat confdefs.h - <<_ACEOF >conftest.$ac_ext
@@ -22028,30 +26926,29 @@
 /* Override any GCC internal prototype to avoid an error.
    Use char because int might match the return type of a GCC
    builtin and then its argument prototype would still apply.  */
-#ifdef __cplusplus
-extern "C"
-#endif
 char sin ();
 int
-main ()
+main (void)
 {
 return sin ();
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   ac_cv_lib_m_sin=yes
-else
+else $as_nop
   ac_cv_lib_m_sin=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 LIBS=$ac_check_lib_save_LIBS
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_m_sin" >&5
-$as_echo "$ac_cv_lib_m_sin" >&6; }
-if test "x$ac_cv_lib_m_sin" = xyes; then :
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_lib_m_sin" >&5
+printf "%s\n" "$ac_cv_lib_m_sin" >&6; }
+if test "x$ac_cv_lib_m_sin" = xyes
+then :
   LIBM=-lm
 fi
 
@@ -22082,9 +26979,10 @@
 
 
 # Check whether --with-gnu-ld was given.
-if test "${with_gnu_ld+set}" = set; then :
+if test ${with_gnu_ld+y}
+then :
   withval=$with_gnu_ld; test "$withval" = no || with_gnu_ld=yes
-else
+else $as_nop
   with_gnu_ld=no
 fi
 
@@ -22104,8 +27002,8 @@
 ac_prog=ld
 if test "$GCC" = yes; then
   # Check if gcc -print-prog-name=ld gives a path.
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for ld used by $CC" >&5
-$as_echo_n "checking for ld used by $CC... " >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for ld used by $CC" >&5
+printf %s "checking for ld used by $CC... " >&6; }
   case $host in
   *-*-mingw*)
     # gcc leaves a trailing carriage return which upsets mingw
@@ -22134,15 +27032,16 @@
     ;;
   esac
 elif test "$with_gnu_ld" = yes; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for GNU ld" >&5
-$as_echo_n "checking for GNU ld... " >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for GNU ld" >&5
+printf %s "checking for GNU ld... " >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for non-GNU ld" >&5
-$as_echo_n "checking for non-GNU ld... " >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for non-GNU ld" >&5
+printf %s "checking for non-GNU ld... " >&6; }
 fi
-if ${acl_cv_path_LD+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+if test ${acl_cv_path_LD+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -z "$LD"; then
   acl_save_ifs="$IFS"; IFS=$PATH_SEPARATOR
   for ac_dir in $PATH; do
@@ -22171,18 +27070,19 @@
 
 LD="$acl_cv_path_LD"
 if test -n "$LD"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LD" >&5
-$as_echo "$LD" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $LD" >&5
+printf "%s\n" "$LD" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 test -z "$LD" && as_fn_error $? "no acceptable ld found in \$PATH" "$LINENO" 5
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking if the linker ($LD) is GNU ld" >&5
-$as_echo_n "checking if the linker ($LD) is GNU ld... " >&6; }
-if ${acl_cv_prog_gnu_ld+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking if the linker ($LD) is GNU ld" >&5
+printf %s "checking if the linker ($LD) is GNU ld... " >&6; }
+if test ${acl_cv_prog_gnu_ld+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   # I'd rather use --version here, but apparently some GNU lds only accept -v.
 case `$LD -v 2>&1 </dev/null` in
 *GNU* | *'with BFD'*)
@@ -22193,18 +27093,20 @@
   ;;
 esac
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $acl_cv_prog_gnu_ld" >&5
-$as_echo "$acl_cv_prog_gnu_ld" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $acl_cv_prog_gnu_ld" >&5
+printf "%s\n" "$acl_cv_prog_gnu_ld" >&6; }
 with_gnu_ld=$acl_cv_prog_gnu_ld
 
 
 
 
-                                                { $as_echo "$as_me:${as_lineno-$LINENO}: checking for shared library run path origin" >&5
-$as_echo_n "checking for shared library run path origin... " >&6; }
-if ${acl_cv_rpath+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+                                                { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for shared library run path origin" >&5
+printf %s "checking for shared library run path origin... " >&6; }
+if test ${acl_cv_rpath+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
     CC="$CC" GCC="$GCC" LDFLAGS="$LDFLAGS" LD="$LD" with_gnu_ld="$with_gnu_ld" \
     ${CONFIG_SHELL-/bin/sh} "$ac_aux_dir/config.rpath" "$host" > conftest.sh
@@ -22213,8 +27115,8 @@
     acl_cv_rpath=done
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $acl_cv_rpath" >&5
-$as_echo "$acl_cv_rpath" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $acl_cv_rpath" >&5
+printf "%s\n" "$acl_cv_rpath" >&6; }
   wl="$acl_cv_wl"
   acl_libext="$acl_cv_libext"
   acl_shlibext="$acl_cv_shlibext"
@@ -22225,9 +27127,10 @@
   acl_hardcode_direct="$acl_cv_hardcode_direct"
   acl_hardcode_minus_L="$acl_cv_hardcode_minus_L"
     # Check whether --enable-rpath was given.
-if test "${enable_rpath+set}" = set; then :
+if test ${enable_rpath+y}
+then :
   enableval=$enable_rpath; :
-else
+else $as_nop
   enable_rpath=yes
 fi
 
@@ -22237,36 +27140,32 @@
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking how to run the C++ preprocessor" >&5
-$as_echo_n "checking how to run the C++ preprocessor... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking how to run the C++ preprocessor" >&5
+printf %s "checking how to run the C++ preprocessor... " >&6; }
 if test -z "$CXXCPP"; then
-  if ${ac_cv_prog_CXXCPP+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-      # Double quotes because CXXCPP needs to be expanded
-    for CXXCPP in "$CXX -E" "/lib/cpp"
+  if test ${ac_cv_prog_CXXCPP+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+      # Double quotes because $CXX needs to be expanded
+    for CXXCPP in "$CXX -E" cpp /lib/cpp
     do
       ac_preproc_ok=false
 for ac_cxx_preproc_warn_flag in '' yes
 do
   # Use a header file that comes with gcc, so configuring glibc
   # with a fresh cross-compiler works.
-  # Prefer <limits.h> to <assert.h> if __STDC__ is defined, since
-  # <limits.h> exists even on freestanding compilers.
   # On the NeXT, cc -E runs the code through the compiler's parser,
   # not just through cpp. "Syntax error" is here to catch this case.
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#ifdef __STDC__
-# include <limits.h>
-#else
-# include <assert.h>
-#endif
+#include <limits.h>
 		     Syntax error
 _ACEOF
-if ac_fn_cxx_try_cpp "$LINENO"; then :
+if ac_fn_cxx_try_cpp "$LINENO"
+then :
 
-else
+else $as_nop
   # Broken: fails on valid input.
 continue
 fi
@@ -22278,10 +27177,11 @@
 /* end confdefs.h.  */
 #include <ac_nonexistent.h>
 _ACEOF
-if ac_fn_cxx_try_cpp "$LINENO"; then :
+if ac_fn_cxx_try_cpp "$LINENO"
+then :
   # Broken: success on invalid input.
 continue
-else
+else $as_nop
   # Passes both tests.
 ac_preproc_ok=:
 break
@@ -22291,7 +27191,8 @@
 done
 # Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
 rm -f conftest.i conftest.err conftest.$ac_ext
-if $ac_preproc_ok; then :
+if $ac_preproc_ok
+then :
   break
 fi
 
@@ -22303,29 +27204,24 @@
 else
   ac_cv_prog_CXXCPP=$CXXCPP
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $CXXCPP" >&5
-$as_echo "$CXXCPP" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $CXXCPP" >&5
+printf "%s\n" "$CXXCPP" >&6; }
 ac_preproc_ok=false
 for ac_cxx_preproc_warn_flag in '' yes
 do
   # Use a header file that comes with gcc, so configuring glibc
   # with a fresh cross-compiler works.
-  # Prefer <limits.h> to <assert.h> if __STDC__ is defined, since
-  # <limits.h> exists even on freestanding compilers.
   # On the NeXT, cc -E runs the code through the compiler's parser,
   # not just through cpp. "Syntax error" is here to catch this case.
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
-#ifdef __STDC__
-# include <limits.h>
-#else
-# include <assert.h>
-#endif
+#include <limits.h>
 		     Syntax error
 _ACEOF
-if ac_fn_cxx_try_cpp "$LINENO"; then :
+if ac_fn_cxx_try_cpp "$LINENO"
+then :
 
-else
+else $as_nop
   # Broken: fails on valid input.
 continue
 fi
@@ -22337,10 +27233,11 @@
 /* end confdefs.h.  */
 #include <ac_nonexistent.h>
 _ACEOF
-if ac_fn_cxx_try_cpp "$LINENO"; then :
+if ac_fn_cxx_try_cpp "$LINENO"
+then :
   # Broken: success on invalid input.
 continue
-else
+else $as_nop
   # Passes both tests.
 ac_preproc_ok=:
 break
@@ -22350,11 +27247,12 @@
 done
 # Because of `break', _AC_PREPROC_IFELSE's cleaning code was skipped.
 rm -f conftest.i conftest.err conftest.$ac_ext
-if $ac_preproc_ok; then :
+if $ac_preproc_ok
+then :
 
-else
-  { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+else $as_nop
+  { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "C++ preprocessor \"$CXXCPP\" fails sanity check
 See \`config.log' for more details" "$LINENO" 5; }
 fi
@@ -22372,11 +27270,12 @@
   acl_libdirstem2=
   case "$host_os" in
     solaris*)
-                                    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for 64-bit host" >&5
-$as_echo_n "checking for 64-bit host... " >&6; }
-if ${gl_cv_solaris_64bit+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+                                    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for 64-bit host" >&5
+printf %s "checking for 64-bit host... " >&6; }
+if test ${gl_cv_solaris_64bit+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -22386,17 +27285,18 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "sixtyfour bits" >/dev/null 2>&1; then :
+  $EGREP "sixtyfour bits" >/dev/null 2>&1
+then :
   gl_cv_solaris_64bit=yes
-else
+else $as_nop
   gl_cv_solaris_64bit=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gl_cv_solaris_64bit" >&5
-$as_echo "$gl_cv_solaris_64bit" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $gl_cv_solaris_64bit" >&5
+printf "%s\n" "$gl_cv_solaris_64bit" >&6; }
       if test $gl_cv_solaris_64bit = yes; then
         acl_libdirstem=lib/64
         case "$host_cpu" in
@@ -22455,7 +27355,8 @@
 
 
 # Check whether --with-libiconv-prefix was given.
-if test "${with_libiconv_prefix+set}" = set; then :
+if test ${with_libiconv_prefix+y}
+then :
   withval=$with_libiconv_prefix;
     if test "X$withval" = "Xno"; then
       use_additional=no
@@ -22925,11 +27826,12 @@
   done
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for iconv" >&5
-$as_echo_n "checking for iconv... " >&6; }
-if ${am_cv_func_iconv+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for iconv" >&5
+printf %s "checking for iconv... " >&6; }
+if test ${am_cv_func_iconv+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
     am_cv_func_iconv="no, consider installing GNU libiconv"
     am_cv_lib_iconv=no
@@ -22940,7 +27842,7 @@
 #include <iconv.h>
 
 int
-main ()
+main (void)
 {
 iconv_t cd = iconv_open("","");
            iconv(cd,NULL,NULL,NULL,NULL);
@@ -22949,10 +27851,11 @@
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_link "$LINENO"; then :
+if ac_fn_cxx_try_link "$LINENO"
+then :
   am_cv_func_iconv=yes
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
     if test "$am_cv_func_iconv" != yes; then
       am_save_LIBS="$LIBS"
@@ -22964,7 +27867,7 @@
 #include <iconv.h>
 
 int
-main ()
+main (void)
 {
 iconv_t cd = iconv_open("","");
              iconv(cd,NULL,NULL,NULL,NULL);
@@ -22973,24 +27876,26 @@
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_link "$LINENO"; then :
+if ac_fn_cxx_try_link "$LINENO"
+then :
   am_cv_lib_iconv=yes
         am_cv_func_iconv=yes
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
       LIBS="$am_save_LIBS"
     fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_func_iconv" >&5
-$as_echo "$am_cv_func_iconv" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_func_iconv" >&5
+printf "%s\n" "$am_cv_func_iconv" >&6; }
   if test "$am_cv_func_iconv" = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for working iconv" >&5
-$as_echo_n "checking for working iconv... " >&6; }
-if ${am_cv_func_iconv_works+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for working iconv" >&5
+printf %s "checking for working iconv... " >&6; }
+if test ${am_cv_func_iconv_works+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
                   am_save_LIBS="$LIBS"
       if test $am_cv_lib_iconv = yes; then
@@ -22998,12 +27903,13 @@
       fi
       am_cv_func_iconv_works=no
       for ac_iconv_const in '' 'const'; do
-        if test "$cross_compiling" = yes; then :
+        if test "$cross_compiling" = yes
+then :
   case "$host_os" in
              aix* | hpux*) am_cv_func_iconv_works="guessing no" ;;
              *)            am_cv_func_iconv_works="guessing yes" ;;
            esac
-else
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -23015,7 +27921,7 @@
 #endif
 
 int
-main ()
+main (void)
 {
 int result = 0;
   /* Test against AIX 5.1 bug: Failures are not distinguishable from successful
@@ -23115,7 +28021,8 @@
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_run "$LINENO"; then :
+if ac_fn_cxx_try_run "$LINENO"
+then :
   am_cv_func_iconv_works=yes
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -23127,8 +28034,8 @@
       LIBS="$am_save_LIBS"
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_func_iconv_works" >&5
-$as_echo "$am_cv_func_iconv_works" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_func_iconv_works" >&5
+printf "%s\n" "$am_cv_func_iconv_works" >&6; }
     case "$am_cv_func_iconv_works" in
       *no) am_func_iconv=no am_cv_lib_iconv=no ;;
       *)   am_func_iconv=yes ;;
@@ -23138,14 +28045,14 @@
   fi
   if test "$am_func_iconv" = yes; then
 
-$as_echo "#define HAVE_ICONV 1" >>confdefs.h
+printf "%s\n" "#define HAVE_ICONV 1" >>confdefs.h
 
   fi
   if test "$am_cv_lib_iconv" = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking how to link with libiconv" >&5
-$as_echo_n "checking how to link with libiconv... " >&6; }
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result: $LIBICONV" >&5
-$as_echo "$LIBICONV" >&6; }
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking how to link with libiconv" >&5
+printf %s "checking how to link with libiconv... " >&6; }
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $LIBICONV" >&5
+printf "%s\n" "$LIBICONV" >&6; }
   else
             CPPFLAGS="$am_save_CPPFLAGS"
     LIBICONV=
@@ -23155,11 +28062,12 @@
 
 
   if test "$am_cv_func_iconv" = yes; then
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking for iconv declaration" >&5
-$as_echo_n "checking for iconv declaration... " >&6; }
-    if ${am_cv_proto_iconv+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for iconv declaration" >&5
+printf %s "checking for iconv declaration... " >&6; }
+    if test ${am_cv_proto_iconv+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
 
       cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
@@ -23177,31 +28085,30 @@
 #endif
 
 int
-main ()
+main (void)
 {
 
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
+if ac_fn_cxx_try_compile "$LINENO"
+then :
   am_cv_proto_iconv_arg1=""
-else
+else $as_nop
   am_cv_proto_iconv_arg1="const"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
       am_cv_proto_iconv="extern size_t iconv (iconv_t cd, $am_cv_proto_iconv_arg1 char * *inbuf, size_t *inbytesleft, char * *outbuf, size_t *outbytesleft);"
 fi
 
     am_cv_proto_iconv=`echo "$am_cv_proto_iconv" | tr -s ' ' | sed -e 's/( /(/'`
-    { $as_echo "$as_me:${as_lineno-$LINENO}: result:
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result:
          $am_cv_proto_iconv" >&5
-$as_echo "
+printf "%s\n" "
          $am_cv_proto_iconv" >&6; }
 
-cat >>confdefs.h <<_ACEOF
-#define ICONV_CONST $am_cv_proto_iconv_arg1
-_ACEOF
+printf "%s\n" "#define ICONV_CONST $am_cv_proto_iconv_arg1" >>confdefs.h
 
 
   fi
@@ -23222,26 +28129,21 @@
 
 
 
-
-for ac_func in getpagesize
-do :
-  ac_fn_c_check_func "$LINENO" "getpagesize" "ac_cv_func_getpagesize"
-if test "x$ac_cv_func_getpagesize" = xyes; then :
-  cat >>confdefs.h <<_ACEOF
-#define HAVE_GETPAGESIZE 1
-_ACEOF
-
-fi
-done
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for working mmap" >&5
-$as_echo_n "checking for working mmap... " >&6; }
-if ${ac_cv_func_mmap_fixed_mapped+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test "$cross_compiling" = yes; then :
-  ac_cv_func_mmap_fixed_mapped=no
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for working mmap" >&5
+printf %s "checking for working mmap... " >&6; }
+if test ${ac_cv_func_mmap_fixed_mapped+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test "$cross_compiling" = yes
+then :
+  case "$host_os" in # ((
+			  # Guess yes on platforms where we know the result.
+		  linux*) ac_cv_func_mmap_fixed_mapped=yes ;;
+			  # If we don't know, assume the worst.
+		  *)      ac_cv_func_mmap_fixed_mapped=no ;;
+		esac
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 $ac_includes_default
@@ -23273,10 +28175,6 @@
 #include <fcntl.h>
 #include <sys/mman.h>
 
-#if !defined STDC_HEADERS && !defined HAVE_STDLIB_H
-char *malloc ();
-#endif
-
 /* This mess was copied from the GNU getpagesize.h.  */
 #ifndef HAVE_GETPAGESIZE
 # ifdef _SC_PAGESIZE
@@ -23310,7 +28208,7 @@
 #endif /* no HAVE_GETPAGESIZE */
 
 int
-main ()
+main (void)
 {
   char *data, *data2, *data3;
   const char *cdata2;
@@ -23378,12 +28276,15 @@
     if (*(data + i) != *(data3 + i))
       return 14;
   close (fd);
+  free (data);
+  free (data3);
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
+if ac_fn_c_try_run "$LINENO"
+then :
   ac_cv_func_mmap_fixed_mapped=yes
-else
+else $as_nop
   ac_cv_func_mmap_fixed_mapped=no
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
@@ -23391,11 +28292,11 @@
 fi
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_func_mmap_fixed_mapped" >&5
-$as_echo "$ac_cv_func_mmap_fixed_mapped" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_func_mmap_fixed_mapped" >&5
+printf "%s\n" "$ac_cv_func_mmap_fixed_mapped" >&6; }
 if test $ac_cv_func_mmap_fixed_mapped = yes; then
 
-$as_echo "#define HAVE_MMAP 1" >>confdefs.h
+printf "%s\n" "#define HAVE_MMAP 1" >>confdefs.h
 
 fi
 rm -f conftest.mmap conftest.txt
@@ -23403,10 +28304,11 @@
 saved_libs="$LIBS"
 LIBS="$LIBS $LIBC $LIBM"
 ac_fn_c_check_func "$LINENO" "fmod" "ac_cv_func_fmod"
-if test "x$ac_cv_func_fmod" = xyes; then :
-  $as_echo "#define HAVE_FMOD 1" >>confdefs.h
+if test "x$ac_cv_func_fmod" = xyes
+then :
+  printf "%s\n" "#define HAVE_FMOD 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" fmod.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS fmod.$ac_objext"
@@ -23414,12 +28316,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "getcwd" "ac_cv_func_getcwd"
-if test "x$ac_cv_func_getcwd" = xyes; then :
-  $as_echo "#define HAVE_GETCWD 1" >>confdefs.h
+if test "x$ac_cv_func_getcwd" = xyes
+then :
+  printf "%s\n" "#define HAVE_GETCWD 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" getcwd.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS getcwd.$ac_objext"
@@ -23427,12 +28329,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "putenv" "ac_cv_func_putenv"
-if test "x$ac_cv_func_putenv" = xyes; then :
-  $as_echo "#define HAVE_PUTENV 1" >>confdefs.h
+if test "x$ac_cv_func_putenv" = xyes
+then :
+  printf "%s\n" "#define HAVE_PUTENV 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" putenv.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS putenv.$ac_objext"
@@ -23440,12 +28342,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "strcasecmp" "ac_cv_func_strcasecmp"
-if test "x$ac_cv_func_strcasecmp" = xyes; then :
-  $as_echo "#define HAVE_STRCASECMP 1" >>confdefs.h
+if test "x$ac_cv_func_strcasecmp" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRCASECMP 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" strcasecmp.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS strcasecmp.$ac_objext"
@@ -23453,12 +28355,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "strerror" "ac_cv_func_strerror"
-if test "x$ac_cv_func_strerror" = xyes; then :
-  $as_echo "#define HAVE_STRERROR 1" >>confdefs.h
+if test "x$ac_cv_func_strerror" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRERROR 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" strerror.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS strerror.$ac_objext"
@@ -23466,12 +28368,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "strncasecmp" "ac_cv_func_strncasecmp"
-if test "x$ac_cv_func_strncasecmp" = xyes; then :
-  $as_echo "#define HAVE_STRNCASECMP 1" >>confdefs.h
+if test "x$ac_cv_func_strncasecmp" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRNCASECMP 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" strncasecmp.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS strncasecmp.$ac_objext"
@@ -23479,12 +28381,12 @@
 esac
 
 fi
-
 ac_fn_c_check_func "$LINENO" "strtol" "ac_cv_func_strtol"
-if test "x$ac_cv_func_strtol" = xyes; then :
-  $as_echo "#define HAVE_STRTOL 1" >>confdefs.h
+if test "x$ac_cv_func_strtol" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRTOL 1" >>confdefs.h
 
-else
+else $as_nop
   case " $LIBOBJS " in
   *" strtol.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS strtol.$ac_objext"
@@ -23493,22 +28395,52 @@
 
 fi
 
-
 LIBS="$saved_libs"
-for ac_func in gettimeofday isatty kill rename setlocale strsep
-do :
-  as_ac_var=`$as_echo "ac_cv_func_$ac_func" | $as_tr_sh`
-ac_fn_c_check_func "$LINENO" "$ac_func" "$as_ac_var"
-if eval test \"x\$"$as_ac_var"\" = x"yes"; then :
-  cat >>confdefs.h <<_ACEOF
-#define `$as_echo "HAVE_$ac_func" | $as_tr_cpp` 1
-_ACEOF
+ac_fn_c_check_func "$LINENO" "gettimeofday" "ac_cv_func_gettimeofday"
+if test "x$ac_cv_func_gettimeofday" = xyes
+then :
+  printf "%s\n" "#define HAVE_GETTIMEOFDAY 1" >>confdefs.h
 
 fi
-done
+ac_fn_c_check_func "$LINENO" "isatty" "ac_cv_func_isatty"
+if test "x$ac_cv_func_isatty" = xyes
+then :
+  printf "%s\n" "#define HAVE_ISATTY 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "kill" "ac_cv_func_kill"
+if test "x$ac_cv_func_kill" = xyes
+then :
+  printf "%s\n" "#define HAVE_KILL 1" >>confdefs.h
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for mkstemp" >&5
-$as_echo_n "checking for mkstemp... " >&6; }
+fi
+ac_fn_c_check_func "$LINENO" "rename" "ac_cv_func_rename"
+if test "x$ac_cv_func_rename" = xyes
+then :
+  printf "%s\n" "#define HAVE_RENAME 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "setlocale" "ac_cv_func_setlocale"
+if test "x$ac_cv_func_setlocale" = xyes
+then :
+  printf "%s\n" "#define HAVE_SETLOCALE 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "strdup" "ac_cv_func_strdup"
+if test "x$ac_cv_func_strdup" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRDUP 1" >>confdefs.h
+
+fi
+ac_fn_c_check_func "$LINENO" "strsep" "ac_cv_func_strsep"
+if test "x$ac_cv_func_strsep" = xyes
+then :
+  printf "%s\n" "#define HAVE_STRSEP 1" >>confdefs.h
+
+fi
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for mkstemp" >&5
+printf %s "checking for mkstemp... " >&6; }
    ac_ext=cpp
 ac_cpp='$CXXCPP $CPPFLAGS'
 ac_compile='$CXX -c $CXXFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -23527,7 +28459,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -23539,15 +28471,16 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_link "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define HAVE_MKSTEMP 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_link "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define HAVE_MKSTEMP 1" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
       case " $LIBOBJS " in
   *" mkstemp.$ac_objext "* ) ;;
   *) LIBOBJS="$LIBOBJS mkstemp.$ac_objext"
@@ -23555,7 +28488,7 @@
 esac
 
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
@@ -23563,58 +28496,73 @@
 ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_c_compiler_gnu
 
-ac_fn_c_check_decl "$LINENO" "sys_siglist" "ac_cv_have_decl_sys_siglist" "$ac_includes_default"
-if test "x$ac_cv_have_decl_sys_siglist" = xyes; then :
+ac_fn_check_decl "$LINENO" "strsignal" "ac_cv_have_decl_strsignal" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_strsignal" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
-
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_SYS_SIGLIST $ac_have_decl
-_ACEOF
-ac_fn_c_check_decl "$LINENO" "getc_unlocked" "ac_cv_have_decl_getc_unlocked" "$ac_includes_default"
-if test "x$ac_cv_have_decl_getc_unlocked" = xyes; then :
+printf "%s\n" "#define HAVE_DECL_STRSIGNAL $ac_have_decl" >>confdefs.h
+ac_fn_check_decl "$LINENO" "getc_unlocked" "ac_cv_have_decl_getc_unlocked" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_getc_unlocked" = xyes
+then :
   ac_have_decl=1
-else
+else $as_nop
   ac_have_decl=0
 fi
+printf "%s\n" "#define HAVE_DECL_GETC_UNLOCKED $ac_have_decl" >>confdefs.h
 
-cat >>confdefs.h <<_ACEOF
-#define HAVE_DECL_GETC_UNLOCKED $ac_have_decl
-_ACEOF
+ac_fn_check_decl "$LINENO" "sys_siglist" "ac_cv_have_decl_sys_siglist" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_sys_siglist" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_SYS_SIGLIST $ac_have_decl" >>confdefs.h
+ac_fn_check_decl "$LINENO" "getc_unlocked" "ac_cv_have_decl_getc_unlocked" "$ac_includes_default" "$ac_c_undeclared_builtin_options" "CFLAGS"
+if test "x$ac_cv_have_decl_getc_unlocked" = xyes
+then :
+  ac_have_decl=1
+else $as_nop
+  ac_have_decl=0
+fi
+printf "%s\n" "#define HAVE_DECL_GETC_UNLOCKED $ac_have_decl" >>confdefs.h
 
 
-  { $as_echo "$as_me:${as_lineno-$LINENO}: checking for nl_langinfo and CODESET" >&5
-$as_echo_n "checking for nl_langinfo and CODESET... " >&6; }
-if ${am_cv_langinfo_codeset+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for nl_langinfo and CODESET" >&5
+printf %s "checking for nl_langinfo and CODESET... " >&6; }
+if test ${am_cv_langinfo_codeset+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 #include <langinfo.h>
 int
-main ()
+main (void)
 {
 char* cs = nl_langinfo(CODESET); return !cs;
   ;
   return 0;
 }
 _ACEOF
-if ac_fn_c_try_link "$LINENO"; then :
+if ac_fn_c_try_link "$LINENO"
+then :
   am_cv_langinfo_codeset=yes
-else
+else $as_nop
   am_cv_langinfo_codeset=no
 fi
-rm -f core conftest.err conftest.$ac_objext \
+rm -f core conftest.err conftest.$ac_objext conftest.beam \
     conftest$ac_exeext conftest.$ac_ext
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $am_cv_langinfo_codeset" >&5
-$as_echo "$am_cv_langinfo_codeset" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $am_cv_langinfo_codeset" >&5
+printf "%s\n" "$am_cv_langinfo_codeset" >&6; }
   if test $am_cv_langinfo_codeset = yes; then
 
-$as_echo "#define HAVE_LANGINFO_CODESET 1" >>confdefs.h
+printf "%s\n" "#define HAVE_LANGINFO_CODESET 1" >>confdefs.h
 
   fi
 
@@ -23626,14 +28574,14 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether ANSI array delete syntax is supported" >&5
-$as_echo_n "checking whether ANSI array delete syntax is supported... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether ISO C++98 array deletion syntax is supported" >&5
+printf %s "checking whether ISO C++98 array deletion syntax is supported... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -23646,17 +28594,16 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-
-$as_echo "#define ARRAY_DELETE_NEEDS_SIZE 1" >>confdefs.h
-
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+      as_fn_error $? "an ISO C++98-conformant compiler is required" "$LINENO" 5
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -23669,8 +28616,8 @@
 ac_link='$CXX -o conftest$ac_exeext $CXXFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
 ac_compiler_gnu=$ac_cv_cxx_compiler_gnu
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking traditional preprocessor" >&5
-$as_echo_n "checking traditional preprocessor... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether C preprocessor uses pre-ISO C90 syntax" >&5
+printf %s "checking whether C preprocessor uses pre-ISO C90 syntax... " >&6; }
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -23680,7 +28627,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -23692,17 +28639,16 @@
 }
 
 _ACEOF
-if ac_fn_cxx_try_compile "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define TRADITIONAL_CPP 1" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_cxx_try_compile "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+      as_fn_error $? "an ISO C90-conformant C preprocessor is required" "$LINENO" 5
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
    ac_ext=c
 ac_cpp='$CPP $CPPFLAGS'
 ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
@@ -23711,12 +28657,13 @@
 
 
 # checks for operating system services
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking w_coredump" >&5
-$as_echo_n "checking w_coredump... " >&6; }
-   if test "$cross_compiling" = yes; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking w_coredump" >&5
+printf %s "checking w_coredump... " >&6; }
+   if test "$cross_compiling" = yes
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -23727,7 +28674,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -23748,15 +28695,16 @@
 }
 
 _ACEOF
-if ac_fn_c_try_run "$LINENO"; then :
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-
-$as_echo "#define WCOREFLAG 0200" >>confdefs.h
-
-else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+if ac_fn_c_try_run "$LINENO"
+then :
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+
+printf "%s\n" "#define WCOREFLAG 0200" >>confdefs.h
+
+else $as_nop
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
   conftest.$ac_objext conftest.beam conftest.$ac_ext
@@ -23765,94 +28713,130 @@
 
 # URW fonts extra dir
 
+
 # Check whether --with-urw-fonts-dir was given.
-if test "${with_urw_fonts_dir+set}" = set; then :
+if test ${with_urw_fonts_dir+y}
+then :
   withval=$with_urw_fonts_dir; urwfontsdir="$withval"
 fi
 
 
 
+# use groff's own malloc-based allocator for C++ new/delete operators
+
+  # Check whether --enable-groff-allocator was given.
+if test ${enable_groff_allocator+y}
+then :
+  enableval=$enable_groff_allocator; test "$enableval" = yes && groff_use_own_allocator=yes
+else $as_nop
+  groff_use_own_allocator=no
+fi
+
+
+
 # other random stuff
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking default value for grops -b option" >&5
-$as_echo_n "checking default value for grops -b option... " >&6; }
-   test -n "${BROKEN_SPOOLER_FLAGS}" || BROKEN_SPOOLER_FLAGS=0
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $BROKEN_SPOOLER_FLAGS" >&5
-$as_echo "$BROKEN_SPOOLER_FLAGS" >&6; }
-
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking default paper size" >&5
-$as_echo_n "checking default paper size... " >&6; }
-   groff_prefix=$prefix
-   test "x$prefix" = "xNONE" && groff_prefix=$ac_default_prefix
-   if test -z "$PAGE" && test -r /etc/papersize; then
-     PAGE=`cat /etc/papersize | sed -e 's/^ *#.*//g' | tr -d "\n" | awk '{ print  }'`
-   fi
-   if test -z "$PAGE"; then
-     descfile=
-     if test -r "$groff_prefix"/share/groff/font/devps/DESC; then
-       descfile=$groff_prefix/share/groff/font/devps/DESC
-     elif test -r "$groff_prefix"/lib/groff/font/devps/DESC; then
-       descfile=$groff_prefix/lib/groff/font/devps/DESC
-     else
-       for f in "$groff_prefix"/share/groff/*/font/devps/DESC; do
-	 if test -r "$f"; then
-	   descfile=$f
-	   break
-	 fi
-       done
-     fi
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking default value for grops -b option" >&5
+printf %s "checking default value for grops -b option... " >&6; }
+   test -n "$BROKEN_SPOOLER_FLAGS" || BROKEN_SPOOLER_FLAGS=0
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $BROKEN_SPOOLER_FLAGS" >&5
+printf "%s\n" "$BROKEN_SPOOLER_FLAGS" >&6; }
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking default paper format" >&5
+printf %s "checking default paper format... " >&6; }
+  groff_prefix=$prefix
+  test "$prefix" = NONE && groff_prefix=$ac_default_prefix
+  if test -z "$PAGE" && test -r /etc/papersize
+  then
+    sedexpr='s/#.*//;s/ \t\+/ /;s/ \+$//;s/^ \+//;/^$/d;p'
+    PAGE=`sed -n "$sedexpr" /etc/papersize`
+  fi
+  if test -z "$PAGE"
+  then
+    descfile=
+    if test -r "$groff_prefix"/share/groff/font/devps/DESC
+    then
+      descfile=$groff_prefix/share/groff/font/devps/DESC
+    elif test -r "$groff_prefix"/lib/groff/font/devps/DESC
+    then
+      descfile=$groff_prefix/lib/groff/font/devps/DESC
+    else
+      for f in "$groff_prefix"/share/groff/*/font/devps/DESC
+      do
+	if test -r "$f"
+	then
+	  descfile=$f
+	  break
+	fi
+      done
+    fi
 
-     if test -n "$descfile"; then
-       if grep '^paperlength	 \+841890' "$descfile" >/dev/null 2>&1; then
-	 PAGE=A4
-       elif grep '^papersize	 \+aA4' "$descfile" >/dev/null 2>&1; then
-	 PAGE=A4
-       fi
-     fi
-   fi
+    if test -n "$descfile"
+    then
+      if grep -q '^paperlength	 \+841890' "$descfile"
+      then
+	PAGE=A4
+      elif grep -q '^papersize	 \+aA4' "$descfile"
+      then
+	PAGE=A4
+      fi
+    fi
+  fi
 
-   if test -z "$PAGE"; then
-     dom=`awk '($1 == "dom" || $1 == "search") { print $2; exit}' \
-	 /etc/resolv.conf 2>/dev/null`
-     if test -z "$dom"; then
-       dom=`(domainname) 2>/dev/null | tr -d '+'`
-       if test -z "$dom" \
-	  || test "$dom" = '(none)'; then
-	 dom=`(hostname) 2>/dev/null | grep '\.'`
-       fi
-     fi
-     # If the top-level domain is two letters and it's not 'us' or 'ca'
-     # then they probably use A4 paper.
-     case "$dom" in
-     *.UuSs|*.CcAa)
-       ;;
-     *.A-Za-zA-Za-z)
-       PAGE=A4 ;;
-     esac
-   fi
+  if test -z "$PAGE"
+  then
+    domains=
+    if test -r /etc/resolv.conf
+    then
+      sedexpr='s/#.*//;s/ \t\+/ /;s/ \+$//;s/^ \+//;/^$/d;
+/^$domain\|search$/!d;s/$domain\|search$ //;p'
+      domains=`sed -n "$sedexpr" /etc/resolv.conf`
+    fi
+    if test -z "$domains"
+    then
+      domains=`(domainname) 2>/dev/null | tr -d '+'`
+      if test -z "$domains" || test "$domains" = '(none)'
+      then
+        domains=`(hostname) 2>/dev/null | grep '\.'`
+      fi
+    fi
+    # resolv.conf's "search" directive might return multiple domains.
+    # If any top-level domain is two letters and it's not 'us' or 'ca',
+    # assume the system uses A4 paper.
+    for d in $domains
+    do
+      case "$d" in
+      *.UuSs|*.CcAa)
+        ;;
+      *.A-Za-zA-Za-z)
+        PAGE=A4 ;;
+      esac
+    done
+  fi
 
-   test -n "$PAGE" || PAGE=letter
-   if test "x$PAGE" = "xA4"; then
+  test -n "$PAGE" || PAGE=letter
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $PAGE" >&5
+printf "%s\n" "$PAGE" >&6; }
 
-$as_echo "#define PAGEA4 1" >>confdefs.h
 
-   fi
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $PAGE" >&5
-$as_echo "$PAGE" >&6; }
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for existing troff installation" >&5
-$as_echo_n "checking for existing troff installation... " >&6; }
-   if test "x`(echo .tm '|n(.g' | tr '|' '\\\\' | troff -z -i 2>&1) 2>/dev/null`" = x0; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-     g=g
-   else
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-     g=
-   fi
+  g=
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for existing troff installation" >&5
+printf %s "checking for existing troff installation... " >&6; }
+  if test "`(echo .tm '|n(.g' | tr '|' '\\\\' | troff -z -i 2>&1) \
+    2>/dev/null`" = 0
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+    g=g
+  else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+  fi
+
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for prefix of system macro packages" >&5
-$as_echo_n "checking for prefix of system macro packages... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for prefix of system macro packages" >&5
+printf %s "checking for prefix of system macro packages... " >&6; }
    sys_tmac_prefix=
    sys_tmac_file_prefix=
    for d in /usr/share/lib/tmac /usr/lib/tmac; do
@@ -23868,14 +28852,17 @@
        done
      done
    done
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $sys_tmac_prefix" >&5
-$as_echo "$sys_tmac_prefix" >&6; }
+   sys_tmac_prefix_result=none
+   test -z "$sys_tmac_prefix" \
+	|| sys_tmac_prefix_result="$sys_tmac_prefix"
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $sys_tmac_prefix_result" >&5
+printf "%s\n" "$sys_tmac_prefix_result" >&6; }
 
 
-   { $as_echo "$as_me:${as_lineno-$LINENO}: checking which system macro packages should be made available" >&5
-$as_echo_n "checking which system macro packages should be made available... " >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking which system macro packages should be made available" >&5
+printf %s "checking which system macro packages should be made available... " >&6; }
    tmac_wrap=
-   if test "x$sys_tmac_file_prefix" = "xtmac."; then
+   if test "$sys_tmac_file_prefix" = tmac.; then
      for f in $sys_tmac_prefix*; do
        suff=`echo $f | sed -e "s;$sys_tmac_prefix;;"`
        case "$suff" in
@@ -23915,41 +28902,44 @@
      done
      rm -f conftest.sol
    fi
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $tmac_wrap" >&5
-$as_echo "$tmac_wrap" >&6; }
+   tmac_wrap_result="none found"
+   test -z "$tmac_wrap" || tmac_wrap_result="$tmac_wrap"
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $tmac_wrap_result" >&5
+printf "%s\n" "$tmac_wrap_result" >&6; }
 
 
 # Check whether --with-compatibility-wrappers was given.
-if test "${with_compatibility_wrappers+set}" = set; then :
+if test ${with_compatibility_wrappers+y}
+then :
   withval=$with_compatibility_wrappers; compatibility_wrappers="$withval"
-else
+else $as_nop
   compatibility_wrappers="check"
 fi
 
 
-    if test "x$compatibility_wrappers" != "xcheck"  -a \
-            "x$compatibility_wrappers" != "xyes"    -a \
-            "x$compatibility_wrappers" != "xno"     -a \
-            "x$compatibility_wrappers" != "xmanual"
+    if    test "$compatibility_wrappers" != check \
+       && test "$compatibility_wrappers" != yes   \
+       && test "$compatibility_wrappers" != no    \
+       && test "$compatibility_wrappers" != manual
     then
-         { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: Invalid '--with-compatibility-wrappers' argument: '$compatibility_wrappers' - assuming 'check' requested." >&5
-$as_echo "$as_me: WARNING: Invalid '--with-compatibility-wrappers' argument: '$compatibility_wrappers' - assuming 'check' requested." >&2;}
+         { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: Invalid '--with-compatibility-wrappers' argument: '$compatibility_wrappers' - assuming 'check' requested." >&5
+printf "%s\n" "$as_me: WARNING: Invalid '--with-compatibility-wrappers' argument: '$compatibility_wrappers' - assuming 'check' requested." >&2;}
          compatibility_wrappers="check"
     fi
 
-    if test "x$tmac_wrap" = "x"
+    if test -z "$tmac_wrap"
     then
         # No Operating System Macro Sets Present
-        if   test "x$compatibility_wrappers" = "xcheck"
+        if   test "$compatibility_wrappers" = check
         then
             compatibility_wrappers="no"
-        elif test "x$compatibility_wrappers" = "xyes"
+        elif test "$compatibility_wrappers" = yes
         then
             as_fn_error $? "No non-GNU macro sets found - cannot create and install compatibility wrappers" "$LINENO" 5
-        elif test "x$compatibility_wrappers" = "xno"
+        elif test "$compatibility_wrappers" = no
         then
             : # No action required
-        elif test "x$compatibility_wrappers" = "xmanual"
+        elif test "$compatibility_wrappers" = manual
         then
             # 'manual' allows quiet conversion to 'no' to support
             # cross-platform build instructions
@@ -23957,7 +28947,7 @@
         fi
     else
         # One or more Operating System Macro Sets Present
-        if   test "x$compatibility_wrappers" = "xcheck"
+        if   test "$compatibility_wrappers" = check
         then
             compatibility_wrappers="yes"
         fi
@@ -23966,9 +28956,9 @@
     # Now compatibility_wrappers can only be yes, no or manual
 
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking separator character to use in groff search paths" >&5
-$as_echo_n "checking separator character to use in groff search paths... " >&6; }
-   cp ${srcdir}/src/include/nonposix.h conftest.h
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking separator character to use in groff search paths" >&5
+printf %s "checking separator character to use in groff search paths... " >&6; }
+   cp "$srcdir"/src/include/nonposix.h conftest.h
    cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -23979,7 +28969,7 @@
 
 
 int
-main ()
+main (void)
 {
 
 
@@ -23993,20 +28983,22 @@
 }
 
 _ACEOF
-if ac_fn_c_try_compile "$LINENO"; then :
+if ac_fn_c_try_compile "$LINENO"
+then :
   GROFF_PATH_SEPARATOR=":"
-else
+else $as_nop
   GROFF_PATH_SEPARATOR=";"
 fi
-rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GROFF_PATH_SEPARATOR" >&5
-$as_echo "$GROFF_PATH_SEPARATOR" >&6; }
+rm -f core conftest.err conftest.$ac_objext conftest.beam conftest.$ac_ext
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $GROFF_PATH_SEPARATOR" >&5
+printf "%s\n" "$GROFF_PATH_SEPARATOR" >&6; }
 
 
 # Check whether --with-alt-gs was given.
-if test "${with_alt_gs+set}" = set; then :
+if test ${with_alt_gs+y}
+then :
   withval=$with_alt_gs; ALT_GHOSTSCRIPT_PROGS="$withval"
-else
+else $as_nop
   ALT_GHOSTSCRIPT_PROGS="gs gswin32c gsos2"
 fi
 
@@ -24014,19 +29006,21 @@
 
 
 # Check whether --with-gs was given.
-if test "${with_gs+set}" = set; then :
+if test ${with_gs+y}
+then :
   withval=$with_gs; GHOSTSCRIPT=$withval
-else
+else $as_nop
   if test -n "$ac_tool_prefix"; then
   for ac_prog in $ALT_GHOSTSCRIPT_PROGS
   do
     # Extract the first word of "$ac_tool_prefix$ac_prog", so it can be a program name with args.
 set dummy $ac_tool_prefix$ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_GHOSTSCRIPT+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_GHOSTSCRIPT+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$GHOSTSCRIPT"; then
   ac_cv_prog_GHOSTSCRIPT="$GHOSTSCRIPT" # Let the user override the test.
 else
@@ -24034,11 +29028,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_GHOSTSCRIPT="$ac_tool_prefix$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24049,11 +29047,11 @@
 fi
 GHOSTSCRIPT=$ac_cv_prog_GHOSTSCRIPT
 if test -n "$GHOSTSCRIPT"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GHOSTSCRIPT" >&5
-$as_echo "$GHOSTSCRIPT" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $GHOSTSCRIPT" >&5
+printf "%s\n" "$GHOSTSCRIPT" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24066,11 +29064,12 @@
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_GHOSTSCRIPT+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_GHOSTSCRIPT+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_GHOSTSCRIPT"; then
   ac_cv_prog_ac_ct_GHOSTSCRIPT="$ac_ct_GHOSTSCRIPT" # Let the user override the test.
 else
@@ -24078,11 +29077,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_GHOSTSCRIPT="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24093,11 +29096,11 @@
 fi
 ac_ct_GHOSTSCRIPT=$ac_cv_prog_ac_ct_GHOSTSCRIPT
 if test -n "$ac_ct_GHOSTSCRIPT"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_GHOSTSCRIPT" >&5
-$as_echo "$ac_ct_GHOSTSCRIPT" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_GHOSTSCRIPT" >&5
+printf "%s\n" "$ac_ct_GHOSTSCRIPT" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24109,8 +29112,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     GHOSTSCRIPT=$ac_ct_GHOSTSCRIPT
@@ -24119,103 +29122,117 @@
 
 fi
 
-   test "$GHOSTSCRIPT" = "no" && GHOSTSCRIPT=missing
-make_htmldoc=
-   make_install_htmldoc=
-   make_uninstall_htmldoc=
-   make_htmlexamples=
-   make_install_htmlexamples=
-   make_uninstall_htmlexamples=
+   test "$GHOSTSCRIPT" = no && GHOSTSCRIPT=missing
 
 
-   missing=
-   # Extract the first word of "pnmcut", so it can be a program name with args.
-set dummy pnmcut; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_pnmcut+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$pnmcut"; then
-  ac_cv_prog_pnmcut="$pnmcut" # Let the user override the test.
+
+  make_htmldoc=no
+  missing=
+
+      # Extract the first word of "pnmcrop", so it can be a program name with args.
+set dummy pnmcrop; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_pnmcrop+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$pnmcrop"; then
+  ac_cv_prog_pnmcrop="$pnmcrop" # Let the user override the test.
 else
 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_pnmcut="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_pnmcrop="found"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
   done
 IFS=$as_save_IFS
 
-  test -z "$ac_cv_prog_pnmcut" && ac_cv_prog_pnmcut="missing"
+  test -z "$ac_cv_prog_pnmcrop" && ac_cv_prog_pnmcrop="missing"
 fi
 fi
-pnmcut=$ac_cv_prog_pnmcut
-if test -n "$pnmcut"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $pnmcut" >&5
-$as_echo "$pnmcut" >&6; }
+pnmcrop=$ac_cv_prog_pnmcrop
+if test -n "$pnmcrop"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $pnmcrop" >&5
+printf "%s\n" "$pnmcrop" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-      if test $pnmcut = missing; then
-	missing="$missing 'pnmcut'"
-      fi;# Extract the first word of "pnmcrop", so it can be a program name with args.
-set dummy pnmcrop; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_pnmcrop+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$pnmcrop"; then
-  ac_cv_prog_pnmcrop="$pnmcrop" # Let the user override the test.
+      if test $pnmcrop = missing
+      then
+        missing="$missing 'pnmcrop'"
+      fi
+
+      # Extract the first word of "pnmcut", so it can be a program name with args.
+set dummy pnmcut; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_pnmcut+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$pnmcut"; then
+  ac_cv_prog_pnmcut="$pnmcut" # Let the user override the test.
 else
 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_pnmcrop="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_pnmcut="found"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
   done
 IFS=$as_save_IFS
 
-  test -z "$ac_cv_prog_pnmcrop" && ac_cv_prog_pnmcrop="missing"
+  test -z "$ac_cv_prog_pnmcut" && ac_cv_prog_pnmcut="missing"
 fi
 fi
-pnmcrop=$ac_cv_prog_pnmcrop
-if test -n "$pnmcrop"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $pnmcrop" >&5
-$as_echo "$pnmcrop" >&6; }
+pnmcut=$ac_cv_prog_pnmcut
+if test -n "$pnmcut"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $pnmcut" >&5
+printf "%s\n" "$pnmcut" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-      if test $pnmcrop = missing; then
-	missing="$missing 'pnmcrop'"
-      fi;# Extract the first word of "pnmtopng", so it can be a program name with args.
+      if test $pnmcut = missing
+      then
+        missing="$missing 'pnmcut'"
+      fi
+
+      # Extract the first word of "pnmtopng", so it can be a program name with args.
 set dummy pnmtopng; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_pnmtopng+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_pnmtopng+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$pnmtopng"; then
   ac_cv_prog_pnmtopng="$pnmtopng" # Let the user override the test.
 else
@@ -24223,11 +29240,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_pnmtopng="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24239,158 +29260,160 @@
 fi
 pnmtopng=$ac_cv_prog_pnmtopng
 if test -n "$pnmtopng"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $pnmtopng" >&5
-$as_echo "$pnmtopng" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $pnmtopng" >&5
+printf "%s\n" "$pnmtopng" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-      if test $pnmtopng = missing; then
-	missing="$missing 'pnmtopng'"
-      fi;# Extract the first word of "psselect", so it can be a program name with args.
-set dummy psselect; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_psselect+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$psselect"; then
-  ac_cv_prog_psselect="$psselect" # Let the user override the test.
+      if test $pnmtopng = missing
+      then
+        missing="$missing 'pnmtopng'"
+      fi
+
+      # Extract the first word of "pnmtops", so it can be a program name with args.
+set dummy pnmtops; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_pnmtops+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$pnmtops"; then
+  ac_cv_prog_pnmtops="$pnmtops" # Let the user override the test.
 else
 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_psselect="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_pnmtops="found"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
   done
 IFS=$as_save_IFS
 
-  test -z "$ac_cv_prog_psselect" && ac_cv_prog_psselect="missing"
+  test -z "$ac_cv_prog_pnmtops" && ac_cv_prog_pnmtops="missing"
 fi
 fi
-psselect=$ac_cv_prog_psselect
-if test -n "$psselect"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $psselect" >&5
-$as_echo "$psselect" >&6; }
+pnmtops=$ac_cv_prog_pnmtops
+if test -n "$pnmtops"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $pnmtops" >&5
+printf "%s\n" "$pnmtops" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-      if test $psselect = missing; then
-	missing="$missing 'psselect'"
-      fi;# Extract the first word of "pnmtops", so it can be a program name with args.
-set dummy pnmtops; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_pnmtops+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
-  if test -n "$pnmtops"; then
-  ac_cv_prog_pnmtops="$pnmtops" # Let the user override the test.
+      if test $pnmtops = missing
+      then
+        missing="$missing 'pnmtops'"
+      fi
+
+      # Extract the first word of "psselect", so it can be a program name with args.
+set dummy psselect; ac_word=$2
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_psselect+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
+  if test -n "$psselect"; then
+  ac_cv_prog_psselect="$psselect" # Let the user override the test.
 else
 as_save_IFS=$IFS; IFS=$PATH_SEPARATOR
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_prog_pnmtops="found"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_prog_psselect="found"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
   done
 IFS=$as_save_IFS
 
-  test -z "$ac_cv_prog_pnmtops" && ac_cv_prog_pnmtops="missing"
+  test -z "$ac_cv_prog_psselect" && ac_cv_prog_psselect="missing"
 fi
 fi
-pnmtops=$ac_cv_prog_pnmtops
-if test -n "$pnmtops"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $pnmtops" >&5
-$as_echo "$pnmtops" >&6; }
+psselect=$ac_cv_prog_psselect
+if test -n "$psselect"; then
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $psselect" >&5
+printf "%s\n" "$psselect" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
-      if test $pnmtops = missing; then
-	missing="$missing 'pnmtops'"
-      fi;
-
-   test "$GHOSTSCRIPT" = "missing" && missing="$missing 'gs'"
-
-   if test -z "$missing"; then
-     if test $docadd_html = yes; then
-       make_htmldoc=htmldoc
-       make_install_htmldoc=install_htmldoc
-       make_uninstall_htmldoc=uninstall_htmldoc
-       if test $docadd_examples = yes; then
-         make_htmlexamples=html_examples
-         make_install_htmlexamples=install_htmlexamples
-         make_uninstall_htmlexamples=uninstall_htmlexamples
-       fi
-     fi
-   else
-     plural=`set $missing; test $# -gt 1 && echo s`
-     missing=`set $missing
-       missing=""
-       while test $# -gt 0
-	 do
-	   case $# in
-	     1) missing="$missing$1" ;;
-	     2) missing="$missing$1 and " ;;
-	     *) missing="$missing$1, " ;;
-	   esac
-	   shift
-	 done
-	 echo $missing`
+      if test $psselect = missing
+      then
+        missing="$missing 'psselect'"
+      fi
 
-     docnote=.
-     test $docadd_html = yes && docnote=';
-  therefore, it will neither be possible to prepare, nor to install,
-  documentation in HTML format.'
-
-     { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: missing program$plural:
-
-  The program$plural
-     $missing
-  cannot be found in the PATH.
-  Consequently, groff's HTML backend (grohtml) will not work properly$docnote
-     " >&5
-$as_echo "$as_me: WARNING: missing program$plural:
-
-  The program$plural
-     $missing
-  cannot be found in the PATH.
-  Consequently, groff's HTML backend (grohtml) will not work properly$docnote
-     " >&2;}
-     doc_dist_target_ok=no
-   fi
 
+  test "$GHOSTSCRIPT" = "missing" && missing="'gs' $missing"
 
+  if test -z "$missing"
+  then
+      make_htmldoc=yes
+  else
+    plural=`set $missing; test $# -gt 1 && echo s`
+    oxford=`set $missing; test $# -gt 2 && echo ,`
+    missing=`set $missing
+      missing=
+      while test $# -gt 0
+      do
+        case $# in
+          1) missing="$missing$1" ;;
+          2) missing="$missing$1$oxford and " ;;
+          *) missing="$missing$1, " ;;
+        esac
+        shift
+      done
+      echo $missing`
+    verb=`set $missing
+      if test $# -gt 1
+      then
+        echo were
+      else
+        echo was
+      fi`
 
+    grohtml_notice="The program$plural $missing $verb not found in \
+\$PATH.
 
+  Consequently, groff's HTML output driver, 'grohtml', will not work
+  properly.  It will not be possible to prepare or install
+  groff-generated documentation in HTML format.
+"
+   fi
 
 
 
 # Check whether --with-alt-awk was given.
-if test "${with_alt_awk+set}" = set; then :
+if test ${with_alt_awk+y}
+then :
   withval=$with_alt_awk; ALT_AWK_PROGS="$withval"
-else
+else $as_nop
   ALT_AWK_PROGS="gawk mawk nawk awk"
 fi
 
@@ -24398,19 +29421,21 @@
 
 
 # Check whether --with-awk was given.
-if test "${with_awk+set}" = set; then :
+if test ${with_awk+y}
+then :
   withval=$with_awk; AWK=$withval
-else
+else $as_nop
   if test -n "$ac_tool_prefix"; then
   for ac_prog in $ALT_AWK_PROGS
   do
     # Extract the first word of "$ac_tool_prefix$ac_prog", so it can be a program name with args.
 set dummy $ac_tool_prefix$ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_AWK+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_AWK+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$AWK"; then
   ac_cv_prog_AWK="$AWK" # Let the user override the test.
 else
@@ -24418,11 +29443,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_AWK="$ac_tool_prefix$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24433,11 +29462,11 @@
 fi
 AWK=$ac_cv_prog_AWK
 if test -n "$AWK"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $AWK" >&5
-$as_echo "$AWK" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $AWK" >&5
+printf "%s\n" "$AWK" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24450,11 +29479,12 @@
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_ac_ct_AWK+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_ac_ct_AWK+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$ac_ct_AWK"; then
   ac_cv_prog_ac_ct_AWK="$ac_ct_AWK" # Let the user override the test.
 else
@@ -24462,11 +29492,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_ac_ct_AWK="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24477,11 +29511,11 @@
 fi
 ac_ct_AWK=$ac_cv_prog_ac_ct_AWK
 if test -n "$ac_ct_AWK"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_ct_AWK" >&5
-$as_echo "$ac_ct_AWK" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_ct_AWK" >&5
+printf "%s\n" "$ac_ct_AWK" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24493,8 +29527,8 @@
   else
     case $cross_compiling:$ac_tool_warned in
 yes:)
-{ $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
-$as_echo "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: using cross tools not prefixed with host triplet" >&5
+printf "%s\n" "$as_me: WARNING: using cross tools not prefixed with host triplet" >&2;}
 ac_tool_warned=yes ;;
 esac
     AWK=$ac_ct_AWK
@@ -24503,87 +29537,162 @@
 
 fi
 
-   test "$AWK" = "no" && AWK=missing
-make_pdfdoc=
-   make_install_pdfdoc=
-   make_uninstall_pdfdoc=
-   make_pdfexamples=
-   make_install_pdfexamples=
-   make_uninstall_pdfexamples=
+   test "$AWK" = no && AWK=missing
 
 
 
-   missing=""
-   test "$AWK" = missing && missing="'awk'"
-   test "$GHOSTSCRIPT" = missing && missing="$missing 'gs'"
-   if test -z "$missing"; then
-     if test $docadd_pdf = yes; then
-       make_pdfdoc=pdfdoc
-       make_install_pdfdoc=install_pdfdoc
-       make_uninstall_pdfdoc=uninstall_pdfdoc
-       if test $docadd_examples = yes; then
-         make_pdfexamples=pdfexamples
-         make_install_pdfexamples=install_pdfexamples
-         make_uninstall_pdfexamples=uninstall_pdfexamples
-       fi
-     fi
-   else
-     plural=`set $missing; test $# -eq 2 && echo s`
-     test x$plural = xs \
-       && missing=`set $missing; echo "$1 and $2"` \
-       || missing=`echo $missing`
-
-     docnote=.
-     test $docadd_pdf = yes && docnote=';
-  therefore, it will neither be possible to prepare, nor to install,
-  documentation and most of the examples in PDF format.'
-
-     { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: missing program$plural:
-
-  The program$plural $missing cannot be found in the PATH.
-  Consequently, groff's PDF formatter (pdfroff) will not work properly$docnote
-     " >&5
-$as_echo "$as_me: WARNING: missing program$plural:
-
-  The program$plural $missing cannot be found in the PATH.
-  Consequently, groff's PDF formatter (pdfroff) will not work properly$docnote
-     " >&2;}
-     doc_dist_target_ok=no
-   fi
 
+  use_pdfroff=no
+  pdfroff_missing_deps=
 
+  test "$AWK" = missing && pdfroff_missing_deps="awk"
 
+  if test "$GHOSTSCRIPT" = missing
+  then
+    verb=is
 
+    if test -n "$pdfroff_missing_deps"
+    then
+      pdfroff_missing_deps="$pdfroff_missing_deps and "
+      verb=are
+    fi
+    pdfroff_missing_deps="${pdfroff_missing_deps}Ghostscript $verb"
+  fi
 
+  if test -z "$pdfroff_missing_deps"
+  then
+    use_pdfroff=yes
+  fi
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether pnmtops can handle the -nosetpage option" >&5
-$as_echo_n "checking whether pnmtops can handle the -nosetpage option... " >&6; }
-   if echo P2 2 2 255 0 1 2 0 | pnmtops -nosetpage > /dev/null 2>&1 ; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: yes" >&5
-$as_echo "yes" >&6; }
-     pnmtops_nosetpage="pnmtops -nosetpage"
-   else
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-     pnmtops_nosetpage="pnmtops"
-   fi
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether make has builtin variable RM" >&5
-$as_echo_n "checking whether make has builtin variable RM... " >&6; }
-cat <<EOF > test_make_rm.mk
+
+
+
+
+  groff_have_urw_fonts=no
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for URW fonts in Type 1/PFB format" >&5
+printf %s "checking for URW fonts in Type 1/PFB format... " >&6; }
+
+  _list_paths="\
+    /usr/share/fonts/type1/gsfonts/ \
+    /usr/share/fonts/default/Type1/ \
+    /usr/share/fonts/default/Type1/adobestd35/ \
+    /usr/share/fonts/type1/urw-base35/ \
+    /opt/local/share/fonts/urw-fonts/ \
+    /usr/local/share/fonts/ghostscript/"
+
+  if test -n "$urwfontsdir"
+  then
+    _list_paths="$urwfontsdir"
+  fi
+
+  for k in $_list_paths
+  do
+    for _font_file in \
+      URWGothic-Book \
+      URWGothic-Book.t1 \
+      URWGothic-Book.pfb \
+      URWGothicL-Book.pfb \
+      a010013l.pfb
+    do
+      if test -f $k/$_font_file
+      then
+        { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: found in $k" >&5
+printf "%s\n" "found in $k" >&6; }
+        groff_have_urw_fonts=yes
+        urwfontsdir=$k
+        break 2
+      fi
+    done
+  done
+
+  if test $groff_have_urw_fonts = no
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: none found" >&5
+printf "%s\n" "none found" >&6; }
+    urwfontsdir=
+  fi
+
+
+
+
+
+
+
+
+  use_gropdf=no
+  gropdf_missing_deps=
+
+  if test "$GHOSTSCRIPT" != missing \
+    || test "$groff_have_urw_fonts" = yes
+  then
+    use_gropdf=yes
+  fi
+
+
+
+
+
+
+  pnmtools_quiet=
+
+  if test "$make_htmldoc" = yes
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether PNM tools accept the '-quiet' option" >&5
+printf %s "checking whether PNM tools accept the '-quiet' option... " >&6; }
+    if echo P2 2 2 255 0 1 2 0 | pnmtops -quiet > /dev/null 2>&1
+    then
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+      pnmtools_quiet=-quiet
+    else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+    fi
+  fi
+
+
+
+
+
+  pnmtops_nosetpage="pnmtops $pnmtools_quiet"
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether pnmtops accepts the '-nosetpage' option" >&5
+printf %s "checking whether pnmtops accepts the '-nosetpage' option... " >&6; }
+  if echo P2 2 2 255 0 1 2 0 | pnmtops -nosetpage > /dev/null 2>&1
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: yes" >&5
+printf "%s\n" "yes" >&6; }
+    pnmtops_nosetpage="pnmtops $pnmtools_quiet -nosetpage"
+  else
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
+  fi
+
+
+
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether make defines 'RM'" >&5
+printf %s "checking whether make defines 'RM'... " >&6; }
+  make=make
+  if test -n "$MAKE"
+  then
+    make=$MAKE
+  fi
+  cat <<EOF > test_make_rm.mk
 all:
-	@if test -n "\$(RM)"; then \
-	   echo "yes"; \
+	@if test -n "\$(RM)"; \
+	then \
+	   echo yes; \
 	else \
-	   echo "no"; \
+	   echo no; \
 	fi
 EOF
-  groff_is_rm_defined=`make -sf test_make_rm.mk`
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_is_rm_defined" >&5
-$as_echo "$groff_is_rm_defined" >&6; }
+  groff_make_defines_rm=`"$make" -sf test_make_rm.mk`
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_make_defines_rm" >&5
+printf "%s\n" "$groff_make_defines_rm" >&6; }
   rm -f test_make_rm.mk
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for a diff program that supports option -D" >&5
-$as_echo_n "checking for a diff program that supports option -D... " >&6; }
+
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for a diff program that supports option -D" >&5
+printf %s "checking for a diff program that supports option -D... " >&6; }
   groff_has_diff_d_option=no
   DIFF_PROG=diff
   diff -Dx /dev/null /dev/null >/dev/null 2>&1 && groff_has_diff_d_option=yes
@@ -24592,11 +29701,12 @@
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_prog_GDIFF+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_prog_GDIFF+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   if test -n "$GDIFF"; then
   ac_cv_prog_GDIFF="$GDIFF" # Let the user override the test.
 else
@@ -24604,11 +29714,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
     ac_cv_prog_GDIFF="$ac_prog"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24619,11 +29733,11 @@
 fi
 GDIFF=$ac_cv_prog_GDIFF
 if test -n "$GDIFF"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $GDIFF" >&5
-$as_echo "$GDIFF" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $GDIFF" >&5
+printf "%s\n" "$GDIFF" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24637,25 +29751,26 @@
       fi
     fi
   fi
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $groff_has_diff_d_option" >&5
-$as_echo "$groff_has_diff_d_option" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $groff_has_diff_d_option" >&5
+printf "%s\n" "$groff_has_diff_d_option" >&6; }
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether test supports option -ef" >&5
-$as_echo_n "checking whether test supports option -ef... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether test supports option -ef" >&5
+printf %s "checking whether test supports option -ef... " >&6; }
   HAVE_TEST_EF_OPTION=no
   test /dev/null -ef /dev/null > /dev/null 2>&1 && HAVE_TEST_EF_OPTION=yes
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $HAVE_TEST_EF_OPTION" >&5
-$as_echo "$HAVE_TEST_EF_OPTION" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $HAVE_TEST_EF_OPTION" >&5
+printf "%s\n" "$HAVE_TEST_EF_OPTION" >&6; }
 
 for ac_prog in bash
 do
   # Extract the first word of "$ac_prog", so it can be a program name with args.
 set dummy $ac_prog; ac_word=$2
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
-$as_echo_n "checking for $ac_word... " >&6; }
-if ${ac_cv_path_BASH_PROG+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for $ac_word" >&5
+printf %s "checking for $ac_word... " >&6; }
+if test ${ac_cv_path_BASH_PROG+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   case $BASH_PROG in
   \\/* | ?:\\/*)
   ac_cv_path_BASH_PROG="$BASH_PROG" # Let the user override the test with a path.
@@ -24665,11 +29780,15 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
     for ac_exec_ext in '' $ac_executable_extensions; do
-  if as_fn_executable_p "$as_dir/$ac_word$ac_exec_ext"; then
-    ac_cv_path_BASH_PROG="$as_dir/$ac_word$ac_exec_ext"
-    $as_echo "$as_me:${as_lineno-$LINENO}: found $as_dir/$ac_word$ac_exec_ext" >&5
+  if as_fn_executable_p "$as_dir$ac_word$ac_exec_ext"; then
+    ac_cv_path_BASH_PROG="$as_dir$ac_word$ac_exec_ext"
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: found $as_dir$ac_word$ac_exec_ext" >&5
     break 2
   fi
 done
@@ -24681,11 +29800,11 @@
 fi
 BASH_PROG=$ac_cv_path_BASH_PROG
 if test -n "$BASH_PROG"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: $BASH_PROG" >&5
-$as_echo "$BASH_PROG" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $BASH_PROG" >&5
+printf "%s\n" "$BASH_PROG" >&6; }
 else
-  { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: no" >&5
+printf "%s\n" "no" >&6; }
 fi
 
 
@@ -24693,16 +29812,77 @@
 done
 test -n "$BASH_PROG" || BASH_PROG="no"
 
-  if test x$BASH_PROG = xno; then
+  if test "$BASH_PROG" = no; then
      BASH_PROG=/bin/sh
   fi
 
 
-    { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C Library >= 2.1 or uClibc" >&5
-$as_echo_n "checking whether we are using the GNU C Library >= 2.1 or uClibc... " >&6; }
-if ${ac_cv_gnu_library_2_1+:} false; then :
-  $as_echo_n "(cached) " >&6
-else
+
+
+  if test "$GHOSTSCRIPT" != missing
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking for gs version with good left sidebearing handling" >&5
+printf %s "checking for gs version with good left sidebearing handling... " >&6; }
+    ghostscript_notice=
+    ghostscript_version_good=
+    ghostscript_v_string=`"$GHOSTSCRIPT" -v | sed 1q`
+    # Get first word.
+    ghostscript_words=`echo "$ghostscript_v_string" | cut -d\  -f1-`
+
+    # If the first word is "GPL", discard it.
+    if expr "$ghostscript_words" : "GPL" > /dev/null
+    then
+      ghostscript_words=`echo "$ghostscript_words" | cut -d\  -f2-`
+    fi
+
+    # Only do a version check if the program calls itself Ghostscript.
+    if expr "$ghostscript_words" : "Ghostscript" > /dev/null
+    then
+      ghostscript_version_good=no
+      ghostscript_version=`echo "$ghostscript_words" | cut -d\  -f2`
+      ghostscript_major=`echo "$ghostscript_version" | cut -d. -f1`
+      ghostscript_minor=`echo "$ghostscript_version" | cut -d. -f2`
+
+      if test "$ghostscript_major" -lt 9
+      then
+        ghostscript_version_good=yes
+      elif test "$ghostscript_major" -ge 10
+      then
+        ghostscript_version_good=yes
+      elif test "$ghostscript_minor" -ge 54
+      then
+        ghostscript_version_good=yes
+      fi
+    fi
+
+    if test "$ghostscript_version_good" = yes
+    then
+      ghostscript_version="$ghostscript_version (good)"
+    elif test "$ghostscript_version_good" = no
+    then
+      ghostscript_version="$ghostscript_version (buggy)"
+      ghostscript_notice="Buggy version of Ghostscript detected."
+    else
+      ghostscript_notice="Unable to determine version of Ghostscript."
+    fi
+
+    if test -n "$ghostscript_version"
+    then
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: got $ghostscript_version" >&5
+printf "%s\n" "got $ghostscript_version" >&6; }
+    else
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: unable to determine" >&5
+printf "%s\n" "unable to determine" >&6; }
+    fi
+  fi
+
+
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking whether we are using the GNU C Library >= 2.1 or uClibc" >&5
+printf %s "checking whether we are using the GNU C Library >= 2.1 or uClibc... " >&6; }
+if test ${ac_cv_gnu_library_2_1+y}
+then :
+  printf %s "(cached) " >&6
+else $as_nop
   cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
@@ -24718,18 +29898,19 @@
 
 _ACEOF
 if (eval "$ac_cpp conftest.$ac_ext") 2>&5 |
-  $EGREP "Lucky" >/dev/null 2>&1; then :
+  $EGREP "Lucky" >/dev/null 2>&1
+then :
   ac_cv_gnu_library_2_1=yes
-else
+else $as_nop
   ac_cv_gnu_library_2_1=no
 fi
-rm -f conftest*
+rm -rf conftest*
 
 
 
 fi
-{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_gnu_library_2_1" >&5
-$as_echo "$ac_cv_gnu_library_2_1" >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: $ac_cv_gnu_library_2_1" >&5
+printf "%s\n" "$ac_cv_gnu_library_2_1" >&6; }
 
     GLIBC21="$ac_cv_gnu_library_2_1"
 
@@ -24743,39 +29924,6 @@
 
 
 
-# checks for presence of URW fonts (requires ghostscript, which is
-# checked in GROFF_HTML_PROGRAMS
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking whether URW fonts in pfb format are available" >&5
-$as_echo_n "checking whether URW fonts in pfb format are available... " >&6; }
-
-
-   groff_have_urw_fonts=no
-   if test "$AWK" = "missing" -o "$GHOSTSCRIPT" = "missing"; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: awk and gs are required, can't look for URW fonts" >&5
-$as_echo "$as_me: WARNING: awk and gs are required, can't look for URW fonts" >&2;}
-   else
-     _list_paths=`$GHOSTSCRIPT -h | $AWK 'BEGIN { found = 0 } /Search path:/ { found = 1 } /^ *\// { print $'0' }'| tr : ' '`
-     _list_paths="$_list_paths /usr/share/fonts/type1/gsfonts/ \
-               /opt/local/share/fonts/urw-fonts/"
-     if test -n "$urwfontsdir"; then
-       _list_paths="$ _list_paths $urwfontsdir"
-     fi
-     for k in $_list_paths; do
-       if test -f $k/a010013l.pfb; then
-         { $as_echo "$as_me:${as_lineno-$LINENO}: result: found in $k" >&5
-$as_echo "found in $k" >&6; }
-         groff_have_urw_fonts=yes
-         break
-       fi
-     done
-   fi
-   if test $groff_have_urw_fonts = no; then
-     { $as_echo "$as_me:${as_lineno-$LINENO}: result: no" >&5
-$as_echo "no" >&6; }
-   fi
-
-
-
  if test -n "$make_winscripts"; then
   BUILD_WINSCRIPTS_TRUE=
   BUILD_WINSCRIPTS_FALSE='#'
@@ -24793,7 +29941,7 @@
 # src/devices/xditview
 # src/utils/xtotroff
 # src/libs/libxutil
- if test "x$groff_no_x" = "xyes"; then
+ if test "$groff_no_x" = yes; then
   WITHOUT_X11_TRUE=
   WITHOUT_X11_FALSE='#'
 else
@@ -24802,18 +29950,18 @@
 fi
 
 
-# make builtin variable RM
- if test "x$groff_is_rm_defined" = "xno"; then
-  MAKE_DONT_HAVE_RM_TRUE=
-  MAKE_DONT_HAVE_RM_FALSE='#'
+ if test "$groff_make_defines_rm" = yes; then
+  MAKE_DEFINES_RM_TRUE=
+  MAKE_DEFINES_RM_FALSE='#'
 else
-  MAKE_DONT_HAVE_RM_TRUE='#'
-  MAKE_DONT_HAVE_RM_FALSE=
+  MAKE_DEFINES_RM_TRUE='#'
+  MAKE_DEFINES_RM_FALSE=
 fi
 
 
-# Some programs have a "g" prefix if an existing groff installation is detected
- if test x$g = xg; then
+# Some programs have a "g" prefix if an existing troff installation is
+# detected.
+ if test "$g" = g; then
   USEPROGRAMPREFIX_TRUE=
   USEPROGRAMPREFIX_FALSE='#'
 else
@@ -24822,79 +29970,56 @@
 fi
 
 
- if test -n "$make_infodoc"; then
-  BUILD_INFODOC_TRUE=
-  BUILD_INFODOC_FALSE='#'
-else
-  BUILD_INFODOC_TRUE='#'
-  BUILD_INFODOC_FALSE=
-fi
-
- if test -n "$make_htmldoc"; then
-  BUILD_HTML_TRUE=
-  BUILD_HTML_FALSE='#'
-else
-  BUILD_HTML_TRUE='#'
-  BUILD_HTML_FALSE=
-fi
-
- if test -n "$make_htmlexamples"; then
-  BUILD_HTMLEXAMPLES_TRUE=
-  BUILD_HTMLEXAMPLES_FALSE='#'
-else
-  BUILD_HTMLEXAMPLES_TRUE='#'
-  BUILD_HTMLEXAMPLES_FALSE=
-fi
-
- if test -n "$make_pdfdoc"; then
-  BUILD_PDFDOC_TRUE=
-  BUILD_PDFDOC_FALSE='#'
+ if test "$use_grohtml" = yes; then
+  USE_GROHTML_TRUE=
+  USE_GROHTML_FALSE='#'
 else
-  BUILD_PDFDOC_TRUE='#'
-  BUILD_PDFDOC_FALSE=
+  USE_GROHTML_TRUE='#'
+  USE_GROHTML_FALSE=
 fi
 
- if test -n "$make_pdfexamples"; then
-  BUILD_PDFEXAMPLES_TRUE=
-  BUILD_PDFEXAMPLES_FALSE='#'
+ if test "$use_pdfroff" = yes; then
+  USE_PDFROFF_TRUE=
+  USE_PDFROFF_FALSE='#'
 else
-  BUILD_PDFEXAMPLES_TRUE='#'
-  BUILD_PDFEXAMPLES_FALSE=
+  USE_PDFROFF_TRUE='#'
+  USE_PDFROFF_FALSE=
 fi
 
- if test -n "$make_otherdoc"; then
-  BUILD_OTHERDOC_TRUE=
-  BUILD_OTHERDOC_FALSE='#'
+ if test "$use_gropdf" = yes; then
+  USE_GROPDF_TRUE=
+  USE_GROPDF_FALSE='#'
 else
-  BUILD_OTHERDOC_TRUE='#'
-  BUILD_OTHERDOC_FALSE=
+  USE_GROPDF_TRUE='#'
+  USE_GROPDF_FALSE=
 fi
 
- if test -n "$make_examples"; then
-  BUILD_EXAMPLES_TRUE=
-  BUILD_EXAMPLES_FALSE='#'
+ if test "$groff_use_own_allocator" = yes; then
+  USE_GROFF_ALLOCATOR_TRUE=
+  USE_GROFF_ALLOCATOR_FALSE='#'
 else
-  BUILD_EXAMPLES_TRUE='#'
-  BUILD_EXAMPLES_FALSE=
+  USE_GROFF_ALLOCATOR_TRUE='#'
+  USE_GROFF_ALLOCATOR_FALSE=
 fi
 
- if test -n "$make_install_shipped_htmldoc"; then
-  INSTALL_SHIPPED_HTML_TRUE=
-  INSTALL_SHIPPED_HTML_FALSE='#'
+ if test "$GHOSTSCRIPT" != no \
+                && test "$GHOSTSCRIPT" != missing; then
+  HAVE_GHOSTSCRIPT_TRUE=
+  HAVE_GHOSTSCRIPT_FALSE='#'
 else
-  INSTALL_SHIPPED_HTML_TRUE='#'
-  INSTALL_SHIPPED_HTML_FALSE=
+  HAVE_GHOSTSCRIPT_TRUE='#'
+  HAVE_GHOSTSCRIPT_FALSE=
 fi
 
- if test "x$groff_have_pdftools" = "xyes" ; then
-  HAVE_PDFTOOLS_TRUE=
-  HAVE_PDFTOOLS_FALSE='#'
+ if test "$groff_have_urw_fonts" = yes ; then
+  HAVE_URW_FONTS_TRUE=
+  HAVE_URW_FONTS_FALSE='#'
 else
-  HAVE_PDFTOOLS_TRUE='#'
-  HAVE_PDFTOOLS_FALSE=
+  HAVE_URW_FONTS_TRUE='#'
+  HAVE_URW_FONTS_FALSE=
 fi
 
- if test "x$groff_have_texi2dvi" = "xyes" ; then
+ if test "$groff_have_texi2dvi" = yes ; then
   HAVE_TEXI2DVI_TRUE=
   HAVE_TEXI2DVI_FALSE='#'
 else
@@ -24902,6 +30027,14 @@
   HAVE_TEXI2DVI_FALSE=
 fi
 
+ if test "$groff_use_tex" = yes ; then
+  USE_TEX_TRUE=
+  USE_TEX_FALSE='#'
+else
+  USE_TEX_TRUE='#'
+  USE_TEX_FALSE=
+fi
+
 
 ac_config_files="$ac_config_files Makefile"
 
@@ -24934,8 +30067,8 @@
     case $ac_val in #(
     *${as_nl}*)
       case $ac_var in #(
-      *_cv_*) { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: cache variable $ac_var contains a newline" >&5
-$as_echo "$as_me: WARNING: cache variable $ac_var contains a newline" >&2;} ;;
+      *_cv_*) { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: cache variable $ac_var contains a newline" >&5
+printf "%s\n" "$as_me: WARNING: cache variable $ac_var contains a newline" >&2;} ;;
       esac
       case $ac_var in #(
       _ | IFS | as_nl) ;; #(
@@ -24965,15 +30098,15 @@
      /^ac_cv_env_/b end
      t clear
      :clear
-     s/^$^=*$=$.*{}.*$$/test "${\1+set}" = set || &/
+     s/^$^=*$=$.*{}.*$$/test ${\1+y} || &/
      t end
      s/^$^=*$=$.*$$/\1=${\1=\2}/
      :end' >>confcache
 if diff "$cache_file" confcache >/dev/null 2>&1; then :; else
   if test -w "$cache_file"; then
     if test "x$cache_file" != "x/dev/null"; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: updating cache $cache_file" >&5
-$as_echo "$as_me: updating cache $cache_file" >&6;}
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: updating cache $cache_file" >&5
+printf "%s\n" "$as_me: updating cache $cache_file" >&6;}
       if test ! -f "$cache_file" || test -h "$cache_file"; then
 	cat confcache >"$cache_file"
       else
@@ -24987,8 +30120,8 @@
       fi
     fi
   else
-    { $as_echo "$as_me:${as_lineno-$LINENO}: not updating unwritable cache $cache_file" >&5
-$as_echo "$as_me: not updating unwritable cache $cache_file" >&6;}
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: not updating unwritable cache $cache_file" >&5
+printf "%s\n" "$as_me: not updating unwritable cache $cache_file" >&6;}
   fi
 fi
 rm -f confcache
@@ -25005,7 +30138,7 @@
 for ac_i in : $LIBOBJS; do test "x$ac_i" = x: && continue
   # 1. Remove the extension, and $U if already installed.
   ac_script='s/\$U\././;s/\.o$//;s/\.obj$//'
-  ac_i=`$as_echo "$ac_i" | sed "$ac_script"`
+  ac_i=`printf "%s\n" "$ac_i" | sed "$ac_script"`
   # 2. Prepend LIBOBJDIR.  When used with automake>=1.10 LIBOBJDIR
   #    will be set to the directory where LIBOBJS objects are built.
   as_fn_append ac_libobjs " \${LIBOBJDIR}$ac_i\$U.$ac_objext"
@@ -25016,14 +30149,14 @@
 LTLIBOBJS=$ac_ltlibobjs
 
 
-{ $as_echo "$as_me:${as_lineno-$LINENO}: checking that generated files are newer than configure" >&5
-$as_echo_n "checking that generated files are newer than configure... " >&6; }
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: checking that generated files are newer than configure" >&5
+printf %s "checking that generated files are newer than configure... " >&6; }
    if test -n "$am_sleep_pid"; then
      # Hide warnings about reused PIDs.
      wait $am_sleep_pid 2>/dev/null
    fi
-   { $as_echo "$as_me:${as_lineno-$LINENO}: result: done" >&5
-$as_echo "done" >&6; }
+   { printf "%s\n" "$as_me:${as_lineno-$LINENO}: result: done" >&5
+printf "%s\n" "done" >&6; }
 if test -z "${AMDEP_TRUE}" && test -z "${AMDEP_FALSE}"; then
   as_fn_error $? "conditional \"AMDEP\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
@@ -25048,96 +30181,61 @@
   as_fn_error $? "conditional \"GL_COND_LIBTOOL\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${GL_GENERATE_ALLOCA_H_TRUE}" && test -z "${GL_GENERATE_ALLOCA_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_ALLOCA_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${GL_GENERATE_ERRNO_H_TRUE}" && test -z "${GL_GENERATE_ERRNO_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_ERRNO_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${GL_GENERATE_FLOAT_H_TRUE}" && test -z "${GL_GENERATE_FLOAT_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_FLOAT_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-
-
-if test -z "${GL_GENERATE_LIMITS_H_TRUE}" && test -z "${GL_GENERATE_LIMITS_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_LIMITS_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-
 
 
-  # Tell AC_LIBSOURCES where to find source files like alloca.c.
-
-
-  # This hack originated in bison.  It is required when using non-recursive
-  # automake rules to build from gnulib-provided lib/ sources.  Hence, LIB_DIR
-  # is usually simply "lib".  Those rules use the list of names like "fchdir.o"
-  # and "strstr.o" in gl_LIBOBJS.  With non-recursive make, we must prefix each
-  # such file name with the "lib/" prefix.  See also build-aux/prefix-gnulib-mk.
-  gl_LIBOBJS=`echo "$gl_LIBOBJS" | sed -e 's, , lib/,g'`
-
-  # Listing the names of the variables to prefix is error-prone.
-  # Rather, adjust each AC_SUBST'd variable whose name ends in '_H'
-  # and whose value ends in '.h'.
-  for ac_var in $ac_subst_vars
-  do
-    eval "ac_val=\$$ac_var"
-    case $ac_var:$ac_val in
-      *_H:*.h) eval "$ac_var=lib/\$$ac_var";;
-    esac
-  done
-
-
-if test -z "${GL_GENERATE_STDDEF_H_TRUE}" && test -z "${GL_GENERATE_STDDEF_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_STDDEF_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${GL_GENERATE_LIMITS_H_TRUE}" && test -z "${GL_GENERATE_LIMITS_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_LIMITS_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${GL_GENERATE_STDINT_H_TRUE}" && test -z "${GL_GENERATE_STDINT_H_FALSE}"; then
-  as_fn_error $? "conditional \"GL_GENERATE_STDINT_H\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_TRUE}" && test -z "${LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH_FALSE}"; then
-  as_fn_error $? "conditional \"LIBUNISTRING_COMPILE_UNIWIDTH_WIDTH\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
 
     gl_libobjs=
     gl_ltlibobjs=
+    gl_libobjdeps=
     if test -n "$gl_LIBOBJS"; then
       # Remove the extension.
       sed_drop_objext='s/\.o$//;s/\.obj$//'
+      sed_dirname1='s,//*,/,g'
+      sed_dirname2='s,$.$/$,\1,'
+      sed_dirname3='s,^^/*$,.,'
+      sed_dirname4='s,$.$/^/*$,\1,'
+      sed_basename1='s,.*/,,'
       for i in `for i in $gl_LIBOBJS; do echo "$i"; done | sed -e "$sed_drop_objext" | sort | uniq`; do
-        gl_libobjs="$gl_libobjs $i.$ac_objext"
-        gl_ltlibobjs="$gl_ltlibobjs $i.lo"
+        gl_libobjs="$gl_libobjs lib/$i.$ac_objext"
+        gl_ltlibobjs="$gl_ltlibobjs lib/$i.lo"
+        i_dir=`echo "$i" | sed -e "$sed_dirname1" -e "$sed_dirname2" -e "$sed_dirname3" -e "$sed_dirname4"`
+        i_base=`echo "$i" | sed -e "$sed_basename1"`
+        gl_libobjdeps="$gl_libobjdeps lib/$i_dir/\$(DEPDIR)/$i_base.Po"
       done
     fi
     gl_LIBOBJS=$gl_libobjs
 
     gl_LTLIBOBJS=$gl_ltlibobjs
 
+    gl_LIBOBJDEPS=$gl_libobjdeps
+
 
 
     gltests_libobjs=
     gltests_ltlibobjs=
+    gltests_libobjdeps=
     if test -n "$gltests_LIBOBJS"; then
       # Remove the extension.
       sed_drop_objext='s/\.o$//;s/\.obj$//'
+      sed_dirname1='s,//*,/,g'
+      sed_dirname2='s,$.$/$,\1,'
+      sed_dirname3='s,^^/*$,.,'
+      sed_dirname4='s,$.$/^/*$,\1,'
+      sed_basename1='s,.*/,,'
       for i in `for i in $gltests_LIBOBJS; do echo "$i"; done | sed -e "$sed_drop_objext" | sort | uniq`; do
-        gltests_libobjs="$gltests_libobjs $i.$ac_objext"
-        gltests_ltlibobjs="$gltests_ltlibobjs $i.lo"
+        gltests_libobjs="$gltests_libobjs lib/$i.$ac_objext"
+        gltests_ltlibobjs="$gltests_ltlibobjs lib/$i.lo"
+        i_dir=`echo "$i" | sed -e "$sed_dirname1" -e "$sed_dirname2" -e "$sed_dirname3" -e "$sed_dirname4"`
+        i_base=`echo "$i" | sed -e "$sed_basename1"`
+        gltests_libobjdeps="$gltests_libobjdeps lib/$i_dir/\$(DEPDIR)/$i_base.Po"
       done
     fi
     gltests_LIBOBJS=$gltests_libobjs
 
     gltests_LTLIBOBJS=$gltests_ltlibobjs
 
+    gltests_LIBOBJDEPS=$gltests_libobjdeps
+
 
 
 if test -z "${BUILD_WINSCRIPTS_TRUE}" && test -z "${BUILD_WINSCRIPTS_FALSE}"; then
@@ -25148,61 +30246,53 @@
   as_fn_error $? "conditional \"WITHOUT_X11\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${MAKE_DONT_HAVE_RM_TRUE}" && test -z "${MAKE_DONT_HAVE_RM_FALSE}"; then
-  as_fn_error $? "conditional \"MAKE_DONT_HAVE_RM\" was never defined.
+if test -z "${MAKE_DEFINES_RM_TRUE}" && test -z "${MAKE_DEFINES_RM_FALSE}"; then
+  as_fn_error $? "conditional \"MAKE_DEFINES_RM\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
 if test -z "${USEPROGRAMPREFIX_TRUE}" && test -z "${USEPROGRAMPREFIX_FALSE}"; then
   as_fn_error $? "conditional \"USEPROGRAMPREFIX\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_INFODOC_TRUE}" && test -z "${BUILD_INFODOC_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_INFODOC\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${BUILD_HTML_TRUE}" && test -z "${BUILD_HTML_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_HTML\" was never defined.
+if test -z "${USE_GROHTML_TRUE}" && test -z "${USE_GROHTML_FALSE}"; then
+  as_fn_error $? "conditional \"USE_GROHTML\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_HTMLEXAMPLES_TRUE}" && test -z "${BUILD_HTMLEXAMPLES_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_HTMLEXAMPLES\" was never defined.
+if test -z "${USE_PDFROFF_TRUE}" && test -z "${USE_PDFROFF_FALSE}"; then
+  as_fn_error $? "conditional \"USE_PDFROFF\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_PDFDOC_TRUE}" && test -z "${BUILD_PDFDOC_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_PDFDOC\" was never defined.
+if test -z "${USE_GROPDF_TRUE}" && test -z "${USE_GROPDF_FALSE}"; then
+  as_fn_error $? "conditional \"USE_GROPDF\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_PDFEXAMPLES_TRUE}" && test -z "${BUILD_PDFEXAMPLES_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_PDFEXAMPLES\" was never defined.
+if test -z "${USE_GROFF_ALLOCATOR_TRUE}" && test -z "${USE_GROFF_ALLOCATOR_FALSE}"; then
+  as_fn_error $? "conditional \"USE_GROFF_ALLOCATOR\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_OTHERDOC_TRUE}" && test -z "${BUILD_OTHERDOC_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_OTHERDOC\" was never defined.
+if test -z "${HAVE_GHOSTSCRIPT_TRUE}" && test -z "${HAVE_GHOSTSCRIPT_FALSE}"; then
+  as_fn_error $? "conditional \"HAVE_GHOSTSCRIPT\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
-if test -z "${BUILD_EXAMPLES_TRUE}" && test -z "${BUILD_EXAMPLES_FALSE}"; then
-  as_fn_error $? "conditional \"BUILD_EXAMPLES\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${INSTALL_SHIPPED_HTML_TRUE}" && test -z "${INSTALL_SHIPPED_HTML_FALSE}"; then
-  as_fn_error $? "conditional \"INSTALL_SHIPPED_HTML\" was never defined.
-Usually this means the macro was only invoked conditionally." "$LINENO" 5
-fi
-if test -z "${HAVE_PDFTOOLS_TRUE}" && test -z "${HAVE_PDFTOOLS_FALSE}"; then
-  as_fn_error $? "conditional \"HAVE_PDFTOOLS\" was never defined.
+if test -z "${HAVE_URW_FONTS_TRUE}" && test -z "${HAVE_URW_FONTS_FALSE}"; then
+  as_fn_error $? "conditional \"HAVE_URW_FONTS\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
 if test -z "${HAVE_TEXI2DVI_TRUE}" && test -z "${HAVE_TEXI2DVI_FALSE}"; then
   as_fn_error $? "conditional \"HAVE_TEXI2DVI\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
+if test -z "${USE_TEX_TRUE}" && test -z "${USE_TEX_FALSE}"; then
+  as_fn_error $? "conditional \"USE_TEX\" was never defined.
+Usually this means the macro was only invoked conditionally." "$LINENO" 5
+fi
 
 : "${CONFIG_STATUS=./config.status}"
 ac_write_fail=0
 ac_clean_files_save=$ac_clean_files
 ac_clean_files="$ac_clean_files $CONFIG_STATUS"
-{ $as_echo "$as_me:${as_lineno-$LINENO}: creating $CONFIG_STATUS" >&5
-$as_echo "$as_me: creating $CONFIG_STATUS" >&6;}
+{ printf "%s\n" "$as_me:${as_lineno-$LINENO}: creating $CONFIG_STATUS" >&5
+printf "%s\n" "$as_me: creating $CONFIG_STATUS" >&6;}
 as_write_fail=0
 cat >$CONFIG_STATUS <<_ASEOF || as_write_fail=1
 #! $SHELL
@@ -25225,14 +30315,16 @@
 
 # Be more Bourne compatible
 DUALCASE=1; export DUALCASE # for MKS sh
-if test -n "${ZSH_VERSION+set}" && (emulate sh) >/dev/null 2>&1; then :
+as_nop=:
+if test ${ZSH_VERSION+y} && (emulate sh) >/dev/null 2>&1
+then :
   emulate sh
   NULLCMD=:
   # Pre-4.2 versions of Zsh do word splitting on ${1+"$@"}, which
   # is contrary to our usage.  Disable this feature.
   alias -g '${1+"$@"}'='"$@"'
   setopt NO_GLOB_SUBST
-else
+else $as_nop
   case `(set -o) 2>/dev/null` in #(
   *posix*) :
     set -o posix ;; #(
@@ -25242,46 +30334,46 @@
 fi
 
 
+
+# Reset variables that may have inherited troublesome values from
+# the environment.
+
+# IFS needs to be set, to space, tab, and newline, in precisely that order.
+# (If _AS_PATH_WALK were called with IFS unset, it would have the
+# side effect of setting IFS to empty, thus disabling word splitting.)
+# Quoting is to prevent editors from complaining about space-tab.
 as_nl='
 '
 export as_nl
-# Printing a long string crashes Solaris 7 /usr/bin/printf.
-as_echo='\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\'
-as_echo=$as_echo$as_echo$as_echo$as_echo$as_echo
-as_echo=$as_echo$as_echo$as_echo$as_echo$as_echo$as_echo
-# Prefer a ksh shell builtin over an external printf program on Solaris,
-# but without wasting forks for bash or zsh.
-if test -z "$BASH_VERSION$ZSH_VERSION" \
-    && (test "X`print -r -- $as_echo`" = "X$as_echo") 2>/dev/null; then
-  as_echo='print -r --'
-  as_echo_n='print -rn --'
-elif (test "X`printf %s $as_echo`" = "X$as_echo") 2>/dev/null; then
-  as_echo='printf %s\n'
-  as_echo_n='printf %s'
-else
-  if test "X`(/usr/ucb/echo -n -n $as_echo) 2>/dev/null`" = "X-n $as_echo"; then
-    as_echo_body='eval /usr/ucb/echo -n "$1$as_nl"'
-    as_echo_n='/usr/ucb/echo -n'
-  else
-    as_echo_body='eval expr "X$1" : "X\$.*\$"'
-    as_echo_n_body='eval
-      arg=$1;
-      case $arg in #(
-      *"$as_nl"*)
-	expr "X$arg" : "X\$.*\$$as_nl";
-	arg=`expr "X$arg" : ".*$as_nl\$.*\$"`;;
-      esac;
-      expr "X$arg" : "X\$.*\$" | tr -d "$as_nl"
-    '
-    export as_echo_n_body
-    as_echo_n='sh -c $as_echo_n_body as_echo'
-  fi
-  export as_echo_body
-  as_echo='sh -c $as_echo_body as_echo'
-fi
+IFS=" ""	$as_nl"
+
+PS1='$ '
+PS2='> '
+PS4='+ '
+
+# Ensure predictable behavior from utilities with locale-dependent output.
+LC_ALL=C
+export LC_ALL
+LANGUAGE=C
+export LANGUAGE
+
+# We cannot yet rely on "unset" to work, but we need these variables
+# to be unset--not just set to an empty or harmless value--now, to
+# avoid bugs in old shells (e.g. pre-3.0 UWIN ksh).  This construct
+# also avoids known problems related to "unset" and subshell syntax
+# in other old shells (e.g. bash 2.01 and pdksh 5.2.14).
+for as_var in BASH_ENV ENV MAIL MAILPATH CDPATH
+do eval test \${$as_var+y} \
+  && ( (unset $as_var) || exit 1) >/dev/null 2>&1 && unset $as_var || :
+done
+
+# Ensure that fds 0, 1, and 2 are open.
+if (exec 3>&0) 2>/dev/null; then :; else exec 0</dev/null; fi
+if (exec 3>&1) 2>/dev/null; then :; else exec 1>/dev/null; fi
+if (exec 3>&2)            ; then :; else exec 2>/dev/null; fi
 
 # The user is always right.
-if test "${PATH_SEPARATOR+set}" != set; then
+if ${PATH_SEPARATOR+false} :; then
   PATH_SEPARATOR=:
   (PATH='/bin;/bin'; FPATH=$PATH; sh -c :) >/dev/null 2>&1 && {
     (PATH='/bin:/bin'; FPATH=$PATH; sh -c :) >/dev/null 2>&1 ||
@@ -25290,13 +30382,6 @@
 fi
 
 
-# IFS
-# We need space, tab and new line, in precisely that order.  Quoting is
-# there to prevent editors from complaining about space-tab.
-# (If _AS_PATH_WALK were called with IFS unset, it would disable word
-# splitting by setting IFS to empty value.)
-IFS=" ""	$as_nl"
-
 # Find who we are.  Look in the path if we contain no directory separator.
 as_myself=
 case $0 in #((
@@ -25305,8 +30390,12 @@
 for as_dir in $PATH
 do
   IFS=$as_save_IFS
-  test -z "$as_dir" && as_dir=.
-    test -r "$as_dir/$0" && as_myself=$as_dir/$0 && break
+  case $as_dir in #(((
+    '') as_dir=./ ;;
+    */) ;;
+    *) as_dir=$as_dir/ ;;
+  esac
+    test -r "$as_dir$0" && as_myself=$as_dir$0 && break
   done
 IFS=$as_save_IFS
 
@@ -25318,30 +30407,10 @@
   as_myself=$0
 fi
 if test ! -f "$as_myself"; then
-  $as_echo "$as_myself: error: cannot find myself; rerun with an absolute file name" >&2
+  printf "%s\n" "$as_myself: error: cannot find myself; rerun with an absolute file name" >&2
   exit 1
 fi
 
-# Unset variables that we do not need and which cause bugs (e.g. in
-# pre-3.0 UWIN ksh).  But do not cause bugs in bash 2.01; the "|| exit 1"
-# suppresses any "Segmentation fault" message there.  '((' could
-# trigger a bug in pdksh 5.2.14.
-for as_var in BASH_ENV ENV MAIL MAILPATH
-do eval test x\${$as_var+set} = xset \
-  && ( (unset $as_var) || exit 1) >/dev/null 2>&1 && unset $as_var || :
-done
-PS1='$ '
-PS2='> '
-PS4='+ '
-
-# NLS nuisances.
-LC_ALL=C
-export LC_ALL
-LANGUAGE=C
-export LANGUAGE
-
-# CDPATH.
-(unset CDPATH) >/dev/null 2>&1 && unset CDPATH
 
 
 # as_fn_error STATUS ERROR LINENO LOG_FD
@@ -25354,13 +30423,14 @@
   as_status=$1; test $as_status -eq 0 && as_status=1
   if test "$4"; then
     as_lineno=${as_lineno-"$3"} as_lineno_stack=as_lineno_stack=$as_lineno_stack
-    $as_echo "$as_me:${as_lineno-$LINENO}: error: $2" >&$4
+    printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: $2" >&$4
   fi
-  $as_echo "$as_me: error: $2" >&2
+  printf "%s\n" "$as_me: error: $2" >&2
   as_fn_exit $as_status
 } # as_fn_error
 
 
+
 # as_fn_set_status STATUS
 # -----------------------
 # Set $? to STATUS, without forking.
@@ -25387,18 +30457,20 @@
   { eval $1=; unset $1;}
 }
 as_unset=as_fn_unset
+
 # as_fn_append VAR VALUE
 # ----------------------
 # Append the text in VALUE to the end of the definition contained in VAR. Take
 # advantage of any shell optimizations that allow amortized linear growth over
 # repeated appends, instead of the typical quadratic growth present in naive
 # implementations.
-if (eval "as_var=1; as_var+=2; test x\$as_var = x12") 2>/dev/null; then :
+if (eval "as_var=1; as_var+=2; test x\$as_var = x12") 2>/dev/null
+then :
   eval 'as_fn_append ()
   {
     eval $1+=\$2
   }'
-else
+else $as_nop
   as_fn_append ()
   {
     eval $1=\$$1\$2
@@ -25410,12 +30482,13 @@
 # Perform arithmetic evaluation on the ARGs, and store the result in the
 # global $as_val. Take advantage of shells that can avoid forks. The arguments
 # must be portable across $(()) and expr.
-if (eval "test \$(( 1 + 1 )) = 2") 2>/dev/null; then :
+if (eval "test \$(( 1 + 1 )) = 2") 2>/dev/null
+then :
   eval 'as_fn_arith ()
   {
     as_val=$(( $* ))
   }'
-else
+else $as_nop
   as_fn_arith ()
   {
     as_val=`expr "$@" || test $? -eq 1`
@@ -25446,7 +30519,7 @@
 $as_expr X/"$0" : '.*/$^/^/*$/*$' \| \
 	 X"$0" : 'X$//$$' \| \
 	 X"$0" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X/"$0" |
+printf "%s\n" X/"$0" |
     sed '/^.*\/$^/^/*$\/*$/{
 	    s//\1/
 	    q
@@ -25468,6 +30541,10 @@
 as_cr_digits='0123456789'
 as_cr_alnum=$as_cr_Letters$as_cr_digits
 
+
+# Determine whether it's possible to make 'echo' print without a newline.
+# These variables are no longer used directly by Autoconf, but are AC_SUBSTed
+# for compatibility with existing Makefiles.
 ECHO_C= ECHO_N= ECHO_T=
 case `echo -n x` in #(((((
 -n*)
@@ -25481,6 +30558,12 @@
   ECHO_N='-n';;
 esac
 
+# For backward compatibility with old third-party macros, we provide
+# the shell variables $as_echo and $as_echo_n.  New code should use
+# AS_ECHO("message") and AS_ECHO_N("message"), respectively.
+as_echo='printf %s\n'
+as_echo_n='printf %s'
+
 rm -f conf$$ conf$$.exe conf$$.file
 if test -d conf$$.dir; then
   rm -f conf$$.dir/conf$$.file
@@ -25522,7 +30605,7 @@
     as_dirs=
     while :; do
       case $as_dir in #(
-      *\'*) as_qdir=`$as_echo "$as_dir" | sed "s/'/'\\\\\\\\''/g"`;; #'(
+      *\'*) as_qdir=`printf "%s\n" "$as_dir" | sed "s/'/'\\\\\\\\''/g"`;; #'(
       *) as_qdir=$as_dir;;
       esac
       as_dirs="'$as_qdir' $as_dirs"
@@ -25531,7 +30614,7 @@
 	 X"$as_dir" : 'X$//$^/' \| \
 	 X"$as_dir" : 'X$//$$' \| \
 	 X"$as_dir" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$as_dir" |
+printf "%s\n" X"$as_dir" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -25593,8 +30676,8 @@
 # report actual input values of CONFIG_FILES etc. instead of their
 # values after options handling.
 ac_log="
-This file was extended by GNU Troff $as_me 1.22.4, which was
-generated by GNU Autoconf 2.69.  Invocation command line was
+This file was extended by GNU roff $as_me 1.23.0, which was
+generated by GNU Autoconf 2.71.  Invocation command line was
 
   CONFIG_FILES    = $CONFIG_FILES
   CONFIG_HEADERS  = $CONFIG_HEADERS
@@ -25654,18 +30737,20 @@
 $config_commands
 
 Report bugs to <http://savannah.gnu.org/bugs/?group=groff>.
-GNU Troff home page: <http://www.gnu.org/software/groff/>.
-General help using GNU software: <http://www.gnu.org/gethelp/>."
+GNU roff home page: <https://www.gnu.org/software/groff/>.
+General help using GNU software: <https://www.gnu.org/gethelp/>."
 
 _ACEOF
+ac_cs_config=`printf "%s\n" "$ac_configure_args" | sed "$ac_safe_unquote"`
+ac_cs_config_escaped=`printf "%s\n" "$ac_cs_config" | sed "s/^ //; s/'/'\\\\\\\\''/g"`
 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
-ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/\\""\`\$/\\\\&/g'`"
+ac_cs_config='$ac_cs_config_escaped'
 ac_cs_version="\\
-GNU Troff config.status 1.22.4
-configured by $0, generated by GNU Autoconf 2.69,
+GNU roff config.status 1.23.0
+configured by $0, generated by GNU Autoconf 2.71,
   with options \\"\$ac_cs_config\\"
 
-Copyright (C) 2012 Free Software Foundation, Inc.
+Copyright (C) 2021 Free Software Foundation, Inc.
 This config.status script is free software; the Free Software Foundation
 gives unlimited permission to copy, distribute and modify it."
 
@@ -25705,15 +30790,15 @@
   -recheck | --recheck | --rechec | --reche | --rech | --rec | --re | --r)
     ac_cs_recheck=: ;;
   --version | --versio | --versi | --vers | --ver | --ve | --v | -V )
-    $as_echo "$ac_cs_version"; exit ;;
+    printf "%s\n" "$ac_cs_version"; exit ;;
   --config | --confi | --conf | --con | --co | --c )
-    $as_echo "$ac_cs_config"; exit ;;
+    printf "%s\n" "$ac_cs_config"; exit ;;
   --debug | --debu | --deb | --de | --d | -d )
     debug=: ;;
   --file | --fil | --fi | --f )
     $ac_shift
     case $ac_optarg in
-    *\'*) ac_optarg=`$as_echo "$ac_optarg" | sed "s/'/'\\\\\\\\''/g"` ;;
+    *\'*) ac_optarg=`printf "%s\n" "$ac_optarg" | sed "s/'/'\\\\\\\\''/g"` ;;
     '') as_fn_error $? "missing file argument" ;;
     esac
     as_fn_append CONFIG_FILES " '$ac_optarg'"
@@ -25721,7 +30806,7 @@
   --header | --heade | --head | --hea )
     $ac_shift
     case $ac_optarg in
-    *\'*) ac_optarg=`$as_echo "$ac_optarg" | sed "s/'/'\\\\\\\\''/g"` ;;
+    *\'*) ac_optarg=`printf "%s\n" "$ac_optarg" | sed "s/'/'\\\\\\\\''/g"` ;;
     esac
     as_fn_append CONFIG_HEADERS " '$ac_optarg'"
     ac_need_defaults=false;;
@@ -25730,7 +30815,7 @@
     as_fn_error $? "ambiguous option: \`$1'
 Try \`$0 --help' for more information.";;
   --help | --hel | -h )
-    $as_echo "$ac_cs_usage"; exit ;;
+    printf "%s\n" "$ac_cs_usage"; exit ;;
   -q | -quiet | --quiet | --quie | --qui | --qu | --q \
   | -silent | --silent | --silen | --sile | --sil | --si | --s)
     ac_cs_silent=: ;;
@@ -25758,7 +30843,7 @@
 if \$ac_cs_recheck; then
   set X $SHELL '$0' $ac_configure_args \$ac_configure_extra_args --no-create --no-recursion
   shift
-  \$as_echo "running CONFIG_SHELL=$SHELL \$*" >&6
+  \printf "%s\n" "running CONFIG_SHELL=$SHELL \$*" >&6
   CONFIG_SHELL='$SHELL'
   export CONFIG_SHELL
   exec "\$@"
@@ -25772,7 +30857,7 @@
   sed 'h;s/./-/g;s/^.../## /;s/...$/ ##/;p;x;p;x' <<_ASBOX
 ## Running $as_me. ##
 _ASBOX
-  $as_echo "$ac_log"
+  printf "%s\n" "$ac_log"
 } >&5
 
 _ACEOF
@@ -25805,9 +30890,9 @@
 # We use the long form for the default assignment because of an extremely
 # bizarre bug on SunOS 4.1.3.
 if $ac_need_defaults; then
-  test "${CONFIG_FILES+set}" = set || CONFIG_FILES=$config_files
-  test "${CONFIG_HEADERS+set}" = set || CONFIG_HEADERS=$config_headers
-  test "${CONFIG_COMMANDS+set}" = set || CONFIG_COMMANDS=$config_commands
+  test ${CONFIG_FILES+y} || CONFIG_FILES=$config_files
+  test ${CONFIG_HEADERS+y} || CONFIG_HEADERS=$config_headers
+  test ${CONFIG_COMMANDS+y} || CONFIG_COMMANDS=$config_commands
 fi
 
 # Have a temporary directory for convenience.  Make it in the build tree
@@ -26143,7 +31228,7 @@
 	   esac ||
 	   as_fn_error 1 "cannot find input file: \`$ac_f'" "$LINENO" 5;;
       esac
-      case $ac_f in *\'*) ac_f=`$as_echo "$ac_f" | sed "s/'/'\\\\\\\\''/g"`;; esac
+      case $ac_f in *\'*) ac_f=`printf "%s\n" "$ac_f" | sed "s/'/'\\\\\\\\''/g"`;; esac
       as_fn_append ac_file_inputs " '$ac_f'"
     done
 
@@ -26151,17 +31236,17 @@
     # use $as_me), people would be surprised to read:
     #    /* config.h.  Generated by config.status.  */
     configure_input='Generated from '`
-	  $as_echo "$*" | sed 's|^^:*/||;s|:^:*/|, |g'
+	  printf "%s\n" "$*" | sed 's|^^:*/||;s|:^:*/|, |g'
 	`' by configure.'
     if test x"$ac_file" != x-; then
       configure_input="$ac_file.  $configure_input"
-      { $as_echo "$as_me:${as_lineno-$LINENO}: creating $ac_file" >&5
-$as_echo "$as_me: creating $ac_file" >&6;}
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: creating $ac_file" >&5
+printf "%s\n" "$as_me: creating $ac_file" >&6;}
     fi
     # Neutralize special characters interpreted by sed in replacement strings.
     case $configure_input in #(
     *\&* | *\|* | *\\* )
-       ac_sed_conf_input=`$as_echo "$configure_input" |
+       ac_sed_conf_input=`printf "%s\n" "$configure_input" |
        sed 's/\\\\&|/\\\\&/g'`;; #(
     *) ac_sed_conf_input=$configure_input;;
     esac
@@ -26178,7 +31263,7 @@
 	 X"$ac_file" : 'X$//$^/' \| \
 	 X"$ac_file" : 'X$//$$' \| \
 	 X"$ac_file" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$ac_file" |
+printf "%s\n" X"$ac_file" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -26202,9 +31287,9 @@
 case "$ac_dir" in
 .) ac_dir_suffix= ac_top_builddir_sub=. ac_top_build_prefix= ;;
 *)
-  ac_dir_suffix=/`$as_echo "$ac_dir" | sed 's|^\.\\/||'`
+  ac_dir_suffix=/`printf "%s\n" "$ac_dir" | sed 's|^\.\\/||'`
   # A ".." for each directory in $ac_dir_suffix.
-  ac_top_builddir_sub=`$as_echo "$ac_dir_suffix" | sed 's|/^\\/*|/..|g;s|/||'`
+  ac_top_builddir_sub=`printf "%s\n" "$ac_dir_suffix" | sed 's|/^\\/*|/..|g;s|/||'`
   case $ac_top_builddir_sub in
   "") ac_top_builddir_sub=. ac_top_build_prefix= ;;
   *)  ac_top_build_prefix=$ac_top_builddir_sub/ ;;
@@ -26266,8 +31351,8 @@
 case `eval "sed -n \"\$ac_sed_dataroot\" $ac_file_inputs"` in
 *datarootdir*) ac_datarootdir_seen=yes;;
 *@datadir@*|*@docdir@*|*@infodir@*|*@localedir@*|*@mandir@*)
-  { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $ac_file_inputs seems to ignore the --datarootdir setting" >&5
-$as_echo "$as_me: WARNING: $ac_file_inputs seems to ignore the --datarootdir setting" >&2;}
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: $ac_file_inputs seems to ignore the --datarootdir setting" >&5
+printf "%s\n" "$as_me: WARNING: $ac_file_inputs seems to ignore the --datarootdir setting" >&2;}
 _ACEOF
 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
   ac_datarootdir_hack='
@@ -26311,9 +31396,9 @@
   { ac_out=`sed -n '/\${datarootdir}/p' "$ac_tmp/out"`; test -n "$ac_out"; } &&
   { ac_out=`sed -n '/^	 *datarootdir	 *:*=/p' \
       "$ac_tmp/out"`; test -z "$ac_out"; } &&
-  { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $ac_file contains a reference to the variable \`datarootdir'
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: $ac_file contains a reference to the variable \`datarootdir'
 which seems to be undefined.  Please make sure it is defined" >&5
-$as_echo "$as_me: WARNING: $ac_file contains a reference to the variable \`datarootdir'
+printf "%s\n" "$as_me: WARNING: $ac_file contains a reference to the variable \`datarootdir'
 which seems to be undefined.  Please make sure it is defined" >&2;}
 
   rm -f "$ac_tmp/stdin"
@@ -26329,20 +31414,20 @@
   #
   if test x"$ac_file" != x-; then
     {
-      $as_echo "/* $configure_input  */" \
+      printf "%s\n" "/* $configure_input  */" >&1 \
       && eval '$AWK -f "$ac_tmp/defines.awk"' "$ac_file_inputs"
     } >"$ac_tmp/config.h" \
       || as_fn_error $? "could not create $ac_file" "$LINENO" 5
     if diff "$ac_file" "$ac_tmp/config.h" >/dev/null 2>&1; then
-      { $as_echo "$as_me:${as_lineno-$LINENO}: $ac_file is unchanged" >&5
-$as_echo "$as_me: $ac_file is unchanged" >&6;}
+      { printf "%s\n" "$as_me:${as_lineno-$LINENO}: $ac_file is unchanged" >&5
+printf "%s\n" "$as_me: $ac_file is unchanged" >&6;}
     else
       rm -f "$ac_file"
       mv "$ac_tmp/config.h" "$ac_file" \
 	|| as_fn_error $? "could not create $ac_file" "$LINENO" 5
     fi
   else
-    $as_echo "/* $configure_input  */" \
+    printf "%s\n" "/* $configure_input  */" >&1 \
       && eval '$AWK -f "$ac_tmp/defines.awk"' "$ac_file_inputs" \
       || as_fn_error $? "could not create -" "$LINENO" 5
   fi
@@ -26362,7 +31447,7 @@
 	 X"$_am_arg" : 'X$//$^/' \| \
 	 X"$_am_arg" : 'X$//$$' \| \
 	 X"$_am_arg" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$_am_arg" |
+printf "%s\n" X"$_am_arg" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -26382,8 +31467,8 @@
 	  s/.*/./; q'`/stamp-h$_am_stamp_count
  ;;
 
-  :C)  { $as_echo "$as_me:${as_lineno-$LINENO}: executing $ac_file commands" >&5
-$as_echo "$as_me: executing $ac_file commands" >&6;}
+  :C)  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: executing $ac_file commands" >&5
+printf "%s\n" "$as_me: executing $ac_file commands" >&6;}
  ;;
   esac
 
@@ -26409,7 +31494,7 @@
   for am_mf
   do
     # Strip MF so we end up with the name of the file.
-    am_mf=`$as_echo "$am_mf" | sed -e 's/:.*$//'`
+    am_mf=`printf "%s\n" "$am_mf" | sed -e 's/:.*$//'`
     # Check whether this is an Automake generated Makefile which includes
     # dependency-tracking related rules and includes.
     # Grep'ing the whole file directly is not great: AIX grep has a line
@@ -26421,7 +31506,7 @@
 	 X"$am_mf" : 'X$//$^/' \| \
 	 X"$am_mf" : 'X$//$$' \| \
 	 X"$am_mf" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X"$am_mf" |
+printf "%s\n" X"$am_mf" |
     sed '/^X$.*^/$\/\/*^/^/*\/*$/{
 	    s//\1/
 	    q
@@ -26443,7 +31528,7 @@
 $as_expr X/"$am_mf" : '.*/$^/^/*$/*$' \| \
 	 X"$am_mf" : 'X$//$$' \| \
 	 X"$am_mf" : 'X$/$' \| . 2>/dev/null ||
-$as_echo X/"$am_mf" |
+printf "%s\n" X/"$am_mf" |
     sed '/^.*\/$^/^/*$\/*$/{
 	    s//\1/
 	    q
@@ -26468,10 +31553,12 @@
    (exit $ac_status); } || am_rc=$?
   done
   if test $am_rc -ne 0; then
-    { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
-$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+    { { printf "%s\n" "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+printf "%s\n" "$as_me: error: in \`$ac_pwd':" >&2;}
 as_fn_error $? "Something went wrong bootstrapping makefile fragments
-    for automatic dependency tracking.  Try re-running configure with the
+    for automatic dependency tracking.  If GNU make was not used, consider
+    re-running the configure script with MAKE=\"gmake\" (or whatever is
+    necessary).  You can also try re-running configure with the
     '--disable-dependency-tracking' option to at least be able to build
     the package (albeit without support for automatic dependency tracking).
 See \`config.log' for more details" "$LINENO" 5; }
@@ -26518,135 +31605,314 @@
   $ac_cs_success || as_fn_exit 1
 fi
 if test -n "$ac_unrecognized_opts" && test "$enable_option_checking" != no; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: unrecognized options: $ac_unrecognized_opts" >&5
-$as_echo "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2;}
+  { printf "%s\n" "$as_me:${as_lineno-$LINENO}: WARNING: unrecognized options: $ac_unrecognized_opts" >&5
+printf "%s\n" "$as_me: WARNING: unrecognized options: $ac_unrecognized_opts" >&2;}
 fi
 
 
 echo "
-${PACKAGE_NAME} version ${PACKAGE_VERSION}
+$PACKAGE_NAME version $PACKAGE_VERSION
 ----------------------------------------------------------------------
- Prefix                          : ${prefix}
- Compiler                        : ${CC} ${CFLAGS} ${CPPFLAGS}"
-if test "x$groff_no_x" = "xyes"; then
-echo "\
- X11 support                     : no"
-else
-echo "\
- X11 support                     : yes
- X11 resources dir               : $appresdir"
+ installation directory prefix    : $prefix"
+if test -n "$g"
+then
+  echo "\
+ command name prefix              : $g"
+  if test -n "$tmac_wrap"
+  then
+  echo "\
+ prefix used for macro packages   : $tmac_wrap"
+  fi
 fi
-if test "x$doc" = x; then
 echo "\
- Doc build                       : no"
+ C++ compiler and options         : $CXX $CXXFLAGS $CPPFLAGS
+ use libgroff's memory allocator  : $groff_use_own_allocator
+ C compiler and options           : $CC $CFLAGS $CPPFLAGS
+ Perl interpreter version         : $perl_version"
+if test "$groff_no_x" = yes
+then
+  echo "\
+ X11 support                      : disabled"
 else
-echo "\
- Doc build                       : ${doc} "
+  echo "\
+ X11 support                      : enabled
+ X11 app defaults directory       : $appdefdir"
 fi
 echo "\
- URW fonts for pdf               : $groff_have_urw_fonts
- Use uchardet library for preconv: $groff_have_uchardet
- pdftools for distcheck          : $groff_have_pdftools"
+ 'groff -l' uses print spooler    : $groff_have_spooler
+ use URW fonts for PDF output     : $groff_have_urw_fonts"
+if test "$groff_have_urw_fonts" = yes
+then
+ echo "\
+ URW fonts directory              : $urwfontsdir"
+fi
 echo "\
+ preconv can use uchardet library : $groff_have_uchardet
+ can build groff.dvi, groff.pdf   : $groff_use_tex
 ----------------------------------------------------------------------"
 
 if test -z "$groff_no_x"; then
-     if test "x$with_appresdir" = "x"; then
-       { $as_echo "$as_me:${as_lineno-$LINENO}:
-  The application resource files for gxditview (GXditview and
-  GXditview-color) will be installed in:
-
-    $appresdir
-
-  (existing files will be saved by appending '.old' to the file
-  name).
-
-  To install them into a different directory, say,
-  '/etc/X11/app-defaults', add
-  '--with-appresdir=/etc/X11/app-defaults' to the configure script
-  command-line options and rerun it ('prefix' value has no effect on
-  a --with-appresdir option).
-
-  If the gxditview resources are installed in a directory that is not
-  one of the default X11 resources directories (common default
-  directories are /usr/lib/X11/app-defaults,
-  /usr/share/X11/app-defaults and /etc/X11/app-defaults), you will
-  have to set the environment variable XFILESEARCHPATH to this
-  path.  More details can be found in the X(7) manual page, or in \"X
-  Toolkit Intrinsics - C Language Interface manual\".
+     if test -z "$with_appdefdir"; then
+       { printf "%s\n" "$as_me:${as_lineno-$LINENO}: Default X11 application defaults directory \
+assumed.
+
+  The application defaults files for gxditview (GXditview and
+  GXditview-color) will be installed in the following directory.
+
+    $appdefdir
+
+  To install elsewhere, say, '/etc/X11/app-defaults', add
+  '--with-appdefdir=/etc/X11/app-defaults' to the configure script
+  command-line options and rerun it (the 'prefix' value has no effect on
+  a --with-appdefdir option).
+
+  If the gxditview app-defaults are installed in a directory that is not
+  one of the default X11 directories for this purpose (common defaults
+  are /usr/lib/X11/app-defaults, /usr/share/X11/app-defaults, and
+  /etc/X11/app-defaults), you will have to set the environment variable
+  XFILESEARCHPATH to this path.  More details can be found in the X(7)
+  manual page, or in the document \"X Toolkit Intrinsics - C Language
+  Interface manual\".
        " >&5
-$as_echo "$as_me:
-  The application resource files for gxditview (GXditview and
-  GXditview-color) will be installed in:
-
-    $appresdir
-
-  (existing files will be saved by appending '.old' to the file
-  name).
-
-  To install them into a different directory, say,
-  '/etc/X11/app-defaults', add
-  '--with-appresdir=/etc/X11/app-defaults' to the configure script
-  command-line options and rerun it ('prefix' value has no effect on
-  a --with-appresdir option).
-
-  If the gxditview resources are installed in a directory that is not
-  one of the default X11 resources directories (common default
-  directories are /usr/lib/X11/app-defaults,
-  /usr/share/X11/app-defaults and /etc/X11/app-defaults), you will
-  have to set the environment variable XFILESEARCHPATH to this
-  path.  More details can be found in the X(7) manual page, or in \"X
-  Toolkit Intrinsics - C Language Interface manual\".
+printf "%s\n" "$as_me: Default X11 application defaults directory \
+assumed.
+
+  The application defaults files for gxditview (GXditview and
+  GXditview-color) will be installed in the following directory.
+
+    $appdefdir
+
+  To install elsewhere, say, '/etc/X11/app-defaults', add
+  '--with-appdefdir=/etc/X11/app-defaults' to the configure script
+  command-line options and rerun it (the 'prefix' value has no effect on
+  a --with-appdefdir option).
+
+  If the gxditview app-defaults are installed in a directory that is not
+  one of the default X11 directories for this purpose (common defaults
+  are /usr/lib/X11/app-defaults, /usr/share/X11/app-defaults, and
+  /etc/X11/app-defaults), you will have to set the environment variable
+  XFILESEARCHPATH to this path.  More details can be found in the X(7)
+  manual page, or in the document \"X Toolkit Intrinsics - C Language
+  Interface manual\".
        " >&6;}
      fi
    fi
-if test "$groff_have_urw_fonts" = no; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}:
-  No URW fonts in .pfb format were found on your system, URW fonts
-  generation for 'devpdf' will not work properly.  These fonts can be
-  downloaded here:
-
-    http://downloads.ghostscript.com/public/fonts/urw-base35-v1.10.zip
-
-  By default groff will search these fonts in the paths given by \`gs
-  -h' and in these 2 default directories:
-  '/usr/share/fonts/type1/gsfonts/' and
-  '/opt/local/share/fonts/urw-fonts/' (paths used by
-  font/devpdf/Foundry.in).  You can also pass the option
-  '--with-urw-fonts-dir=DIR' to 'configure' to set a custom path.  You
-  would need to re-run the 'configure' script after installing these
-  fonts.
 
+
+
+  awk_names=awk
+  if test -n "$ALT_AWK_PROGS"
+  then
+    awk_names="$ALT_AWK_PROGS"
+  fi
+
+  if test "$AWK" = missing
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: No awk program was found in \$PATH.
+
+  It was sought under the name(s) \"$awk_names\".
+    " >&5
+printf "%s\n" "$as_me: No awk program was found in \$PATH.
+
+  It was sought under the name(s) \"$awk_names\".
+    " >&6;}
+  fi
+
+
+
+
+  gs_names=gs
+  if test -n "$ALT_GHOSTSCRIPT_PROGS"
+  then
+    gs_names="$ALT_GHOSTSCRIPT_PROGS"
+  fi
+
+  if test "$GHOSTSCRIPT" = missing
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: No Ghostscript program was found in \$PATH.
+
+  It was sought under the name(s) \"$gs_names\".
+
+  groff documentation will not be available in HTML.
+
+  'grohtml' will have reduced function, being unable to produce
+  documents using the 'tbl' preprocessor.
+    " >&5
+printf "%s\n" "$as_me: No Ghostscript program was found in \$PATH.
+
+  It was sought under the name(s) \"$gs_names\".
+
+  groff documentation will not be available in HTML.
+
+  'grohtml' will have reduced function, being unable to produce
+  documents using the 'tbl' preprocessor.
+    " >&6;}
+  fi
+
+
+  if test -n "$ghostscript_notice"
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: $ghostscript_notice
+
+  Ghostscript versions 9.00 <= x < 9.54 suffer from a rendering glitch
+  that affects the AT&T troff (and groff) special character '\(lh'; see
+  <https://bugs.ghostscript.com/show_bug.cgi?id=703187>.  If your
+  version of Ghostscript has not been patched to fix this problem, you
+  may need to work around it in groff documents you render for the
+  PostScript (and, for tbl(1) tables, HTML) output devices.
   " >&5
-$as_echo "$as_me:
-  No URW fonts in .pfb format were found on your system, URW fonts
-  generation for 'devpdf' will not work properly.  These fonts can be
-  downloaded here:
-
-    http://downloads.ghostscript.com/public/fonts/urw-base35-v1.10.zip
-
-  By default groff will search these fonts in the paths given by \`gs
-  -h' and in these 2 default directories:
-  '/usr/share/fonts/type1/gsfonts/' and
-  '/opt/local/share/fonts/urw-fonts/' (paths used by
-  font/devpdf/Foundry.in).  You can also pass the option
-  '--with-urw-fonts-dir=DIR' to 'configure' to set a custom path.  You
-  would need to re-run the 'configure' script after installing these
-  fonts.
+printf "%s\n" "$as_me: $ghostscript_notice
 
+  Ghostscript versions 9.00 <= x < 9.54 suffer from a rendering glitch
+  that affects the AT&T troff (and groff) special character '\(lh'; see
+  <https://bugs.ghostscript.com/show_bug.cgi?id=703187>.  If your
+  version of Ghostscript has not been patched to fix this problem, you
+  may need to work around it in groff documents you render for the
+  PostScript (and, for tbl(1) tables, HTML) output devices.
   " >&6;}
   fi
 
-if test "x$groff_have_uchardet" = "xno" -a "x$with_uchardet" != "xno"; then
-  { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING:
-  uchardet library was not found; preprocessor 'preconv', which uses it to detect
-  the input file encoding, might not work properly (to check how and in which
-  order 'preconv' tries to determine the file encoding, see its man page).
+
+  if test "$groff_have_urw_fonts" = no
+  then
+    gs_verbiage=
+    if test "$GHOSTSCRIPT" != missing
+    then
+      gs_verbiage=' as well as the search path shown by the
+  "'"$GHOSTSCRIPT"' -h" command (if available)'
+    fi
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: URW fonts in Type 1/PFB format were not found.
+
+  groff font description files for the URW fonts, used by the 'gropdf'
+  output driver, will not be available.  Use and embedding of fonts from
+  the 'U' foundry in PDF documents generated by groff will not be
+  possible.
+
+  You can obtain the URW base 35 fonts from their GitHub project.  As of
+  this writing (2023-02-15), you can find them in the 'fonts' directory
+  of the following archives (choose one).
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.zip
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.tar.gz
+
+  You may wish to check for a newer release.
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/releases
+
+  'gropdf' looks for these fonts in several directories specified in
+  font/devpdf/Foundry.in$gs_verbiage.
+
+  You will need to \"make distclean\" and re-run the 'configure' script
+  after installing the URW fonts.
+
+  Alternatively, you can pass the option '--with-urw-fonts-dir=DIR'
+  to 'configure' to look for them in the directory DIR you specify.
+  If found, the 'U' foundry will be available via the '-y' option to
+  'gropdf' (accessed via the 'groff' command with the option '-P -y').
+    " >&5
+printf "%s\n" "$as_me: URW fonts in Type 1/PFB format were not found.
+
+  groff font description files for the URW fonts, used by the 'gropdf'
+  output driver, will not be available.  Use and embedding of fonts from
+  the 'U' foundry in PDF documents generated by groff will not be
+  possible.
+
+  You can obtain the URW base 35 fonts from their GitHub project.  As of
+  this writing (2023-02-15), you can find them in the 'fonts' directory
+  of the following archives (choose one).
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.zip
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.tar.gz
+
+  You may wish to check for a newer release.
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/releases
+
+  'gropdf' looks for these fonts in several directories specified in
+  font/devpdf/Foundry.in$gs_verbiage.
+
+  You will need to \"make distclean\" and re-run the 'configure' script
+  after installing the URW fonts.
+
+  Alternatively, you can pass the option '--with-urw-fonts-dir=DIR'
+  to 'configure' to look for them in the directory DIR you specify.
+  If found, the 'U' foundry will be available via the '-y' option to
+  'gropdf' (accessed via the 'groff' command with the option '-P -y').
+    " >&6;}
+  fi
+
+
+  if test "$groff_have_uchardet" = no && test "$with_uchardet" != no
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: The uchardet library was not found.
+
+  The 'preconv' preprocessor program will be unable to attempt automatic
+  inference of an input file's character encoding.  See the preconv(1)
+  man page.
   " >&5
-$as_echo "$as_me: WARNING:
-  uchardet library was not found; preprocessor 'preconv', which uses it to detect
-  the input file encoding, might not work properly (to check how and in which
-  order 'preconv' tries to determine the file encoding, see its man page).
-  " >&2;}
+printf "%s\n" "$as_me: The uchardet library was not found.
+
+  The 'preconv' preprocessor program will be unable to attempt automatic
+  inference of an input file's character encoding.  See the preconv(1)
+  man page.
+  " >&6;}
+  fi
+
+
+
+
+  if test "$make_htmldoc" = no
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: $grohtml_notice" >&5
+printf "%s\n" "$as_me: $grohtml_notice" >&6;}
+  fi
+
+
+
+
+  if test "$use_pdfroff" = no
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: 'pdfroff' will not be functional.
+
+  Because $pdfroff_missing_deps missing, 'pdfroff' will not operate
+  and the 'pdfmark.pdf' document will not be available.
+" >&5
+printf "%s\n" "$as_me: 'pdfroff' will not be functional.
+
+  Because $pdfroff_missing_deps missing, 'pdfroff' will not operate
+  and the 'pdfmark.pdf' document will not be available.
+" >&6;}
   fi
 
+
+
+
+  if test "$use_gropdf" = no
+  then
+    { printf "%s\n" "$as_me:${as_lineno-$LINENO}: 'gropdf' will have reduced function.
+
+  Neither Ghostscript nor URW fonts are available; groff documentation
+  thus will not be available in PDF.
+
+  'gropdf' will be able to handle only documents using the standard PDF
+  base 14 fonts, plus the 'EURO' font groff supplies, and font embedding
+  with its '-e' option (accessed via the 'groff' command with the option
+  '-P -e') will not be possible.
+" >&5
+printf "%s\n" "$as_me: 'gropdf' will have reduced function.
+
+  Neither Ghostscript nor URW fonts are available; groff documentation
+  thus will not be available in PDF.
+
+  'gropdf' will be able to handle only documents using the standard PDF
+  base 14 fonts, plus the 'EURO' font groff supplies, and font embedding
+  with its '-e' option (accessed via the 'groff' command with the option
+  '-P -e') will not be possible.
+" >&6;}
+  fi
+
+

_service:tar_scm:groff-1.22.4.tar.gz/configure.ac -> _service:tar_scm:groff-1.23.0.tar.gz/configure.ac Changed

@@ -1,5 +1,5 @@
 # Autoconf configuration file for groff.
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+# Copyright (C) 1989-2023 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -8,8 +8,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -18,21 +18,22 @@
 #
 # Process this file with autoconf to produce a configure script.
 
-AC_INIT(GNU Troff,
+AC_INIT(GNU roff,
         m4_esyscmd(build-aux/git-version-gen --prefix "" .tarball-version),
         http://savannah.gnu.org/bugs/?group=groff,
         groff)
 
-AC_PREREQ(2.62)
+AC_PREREQ(2.64)
 
-# SHORT_VERSION contains only the number of REVISION before the first '.',
-# e.g. if REVISION is '3.real.434-5aafd' then SHORT_VERSION is 'x.yy.3',
-# where x and yy are MAJOR_VERSION and MINOR_VERSION, respectively.
+# SHORT_VERSION contains only the number of REVISION before the first
+# '.'; e.g., if REVISION is '3.real.434-5aafd' then SHORT_VERSION is
+# 'x.yy.3', where x and yy are MAJOR_VERSION and MINOR_VERSION,
+# respectively.
 AC_SUBST(SHORT_VERSION,
 	m4_bregexp(AC_PACKAGE_VERSION,^$\w+\.\w+\.\w+$.*$,\1))
 
-# Directories where the helper scripts should be found. This must be consistent
-# with the variable build_aux in bootstrap.conf
+# Directories where the helper scripts should be found. This must be
+# consistent with the variable build_aux in bootstrap.conf.
 AC_CONFIG_AUX_DIR(build-aux)
 
 AC_CONFIG_HEADERS(src/include/config.h:src/include/config.hin)
@@ -54,23 +55,21 @@
 GROFF_OS390
 GROFF_CMD_FILES
 GROFF_X11
-GROFF_APPRESDIR_OPTION
-GROFF_APPRESDIR_DEFAULT
+GROFF_APPDEFDIR_OPTION
+GROFF_APPDEFDIR_DEFAULT
 GROFF_LIBPROGRAMDIR_DEFAULT
-GROFF_GROFFERDIR_OPTION
-GROFF_GROFFERDIR_DEFAULT
 GROFF_GLILYPONDDIR_DEFAULT
 GROFF_GPINYINDIR_DEFAULT
-GROFF_GROGDIR_DEFAULT
 GROFF_PERL
 GROFF_PRINT
 # GROFF_REFER
 GROFF_REFERDIR_DEFAULT
 AC_PROG_EGREP
 GROFF_PROG_YACC
-GROFF_DOC_CHECK
-GROFF_MAKEINFO
-GROFF_TEXI2DVI
+GROFF_PROG_M4
+GROFF_PROG_MAKEINFO
+GROFF_PROG_TEXI2DVI
+GROFF_USE_TEX_CHECK
 AC_PROG_RANLIB
 GROFF_INSTALL_SH
 GROFF_INSTALL_INFO
@@ -80,16 +79,17 @@
 GROFF_PROG_XPMTOPPM
 PKG_PROG_PKG_CONFIG
 GROFF_UCHARDET
-GROFF_PDFTOOLS
 
 # use a dummy substitution if no csh hack is necessary to avoid errors
 # with non-GNU sed programs
-GROFF_CSH_HACK(SH_SCRIPT_SED_CMD='1s/.*/:/', SH_SCRIPT_SED_CMD='1s/a/a/')
+GROFF_CSH_HACK(SH_SCRIPT_SED_CMD='1s/.*/:/',
+               SH_SCRIPT_SED_CMD='1s/a/a/')
 AC_SUBST(SH_SCRIPT_SED_CMD)
 
 # checks for headers
-AC_CHECK_HEADERS(stddef.h stdlib.h unistd.h dirent.h limits.h sys/dir.h \
-                  string.h strings.h math.h sys/time.h direct.h process.h)
+AC_CHECK_HEADERS(stdbool.h stddef.h stdlib.h unistd.h dirent.h \
+                  limits.h sys/dir.h string.h strings.h math.h \
+                  sys/time.h direct.h process.h)
 GROFF_ISC_SYSV3
 GROFF_POSIX
 
@@ -138,8 +138,10 @@
 AC_REPLACE_FUNCS(fmod getcwd putenv strcasecmp \
                   strerror strncasecmp strtol)
 LIBS="$saved_libs"
-AC_CHECK_FUNCS(gettimeofday isatty kill rename setlocale strsep)
+AC_CHECK_FUNCS(gettimeofday isatty kill rename setlocale strdup \
+                strsep)
 GROFF_MKSTEMP
+AC_CHECK_DECLS(strsignal, getc_unlocked)
 AC_CHECK_DECLS(sys_siglist, getc_unlocked)
 AM_LANGINFO_CODESET
 
@@ -153,6 +155,9 @@
 # URW fonts extra dir
 GROFF_URW_FONTS_PATH
 
+# use groff's own malloc-based allocator for C++ new/delete operators
+GROFF_USE_GROFF_ALLOCATOR
+
 # other random stuff
 GROFF_BROKEN_SPOOLER_FLAGS
 GROFF_PAGE
@@ -160,80 +165,99 @@
 GROFF_TMAC
 GROFF_WITH_COMPATIBILITY_WRAPPERS
 GROFF_TARGET_PATH_SEPARATOR
-GROFF_HTML_PROGRAMS
-GROFF_PDFDOC_PROGRAMS
+GROFF_CHECK_GROHTML_PROGRAMS
+GROFF_PDFROFF_DEPENDENCIES_CHECK
+GROFF_GROPDF_DEPENDENCIES_CHECK
+GROFF_PNMTOOLS_CAN_BE_QUIET
 GROFF_PNMTOPS_NOSETPAGE
-GROFF_MAKE_RM
+GROFF_MAKE_DEFINES_RM
 GROFF_DIFF_D
 GROFF_HAVE_TEST_EF_OPTION
 GROFF_BASH
+GROFF_GHOSTSCRIPT_VERSION_CHECK
 gl_GLIBC21
 gl_LOCALCHARSET
 
-# checks for presence of URW fonts (requires ghostscript, which is
-# checked in GROFF_HTML_PROGRAMS
-GROFF_URW_FONTS
-
 AM_CONDITIONAL(BUILD_WINSCRIPTS, test -n "$make_winscripts")
 
 # If X11 is not available, don't build:
-# font/devX75 
+# font/devX75
 # font/devX75-12
 # font/devX100
 # font/devX100-12
-# src/devices/xditview 
+# src/devices/xditview
 # src/utils/xtotroff
 # src/libs/libxutil
-AM_CONDITIONAL(WITHOUT_X11, test "x$groff_no_x" = "xyes")
+AM_CONDITIONAL(WITHOUT_X11, test "$groff_no_x" = yes)
 
-# make builtin variable RM
-AM_CONDITIONAL(MAKE_DONT_HAVE_RM, test "x$groff_is_rm_defined" = "xno")
+AM_CONDITIONAL(MAKE_DEFINES_RM, test "$groff_make_defines_rm" = yes)
 
-# Some programs have a "g" prefix if an existing groff installation is detected
-AM_CONDITIONAL(USEPROGRAMPREFIX, test x$g = xg)
+# Some programs have a "g" prefix if an existing troff installation is
+# detected.
+AM_CONDITIONAL(USEPROGRAMPREFIX, test "$g" = g)
 
-AM_CONDITIONAL(BUILD_INFODOC, test -n "$make_infodoc")
-AM_CONDITIONAL(BUILD_HTML, test -n "$make_htmldoc")
-AM_CONDITIONAL(BUILD_HTMLEXAMPLES, test -n "$make_htmlexamples")
-AM_CONDITIONAL(BUILD_PDFDOC, test -n "$make_pdfdoc")
-AM_CONDITIONAL(BUILD_PDFEXAMPLES, test -n "$make_pdfexamples")
-AM_CONDITIONAL(BUILD_OTHERDOC, test -n "$make_otherdoc")
-AM_CONDITIONAL(BUILD_EXAMPLES, test -n "$make_examples")
-AM_CONDITIONAL(INSTALL_SHIPPED_HTML, test -n "$make_install_shipped_htmldoc")
-AM_CONDITIONAL(HAVE_PDFTOOLS, test "x$groff_have_pdftools" = "xyes" )
-AM_CONDITIONAL(HAVE_TEXI2DVI, test "x$groff_have_texi2dvi" = "xyes" )
+AM_CONDITIONAL(USE_GROHTML, test "$use_grohtml" = yes)
+AM_CONDITIONAL(USE_PDFROFF, test "$use_pdfroff" = yes)
+AM_CONDITIONAL(USE_GROPDF, test "$use_gropdf" = yes)
+AM_CONDITIONAL(USE_GROFF_ALLOCATOR,
+               test "$groff_use_own_allocator" = yes)
+AM_CONDITIONAL(HAVE_GHOSTSCRIPT, test "$GHOSTSCRIPT" != no \
+                && test "$GHOSTSCRIPT" != missing)
+AM_CONDITIONAL(HAVE_URW_FONTS, test "$groff_have_urw_fonts" = yes )
+AM_CONDITIONAL(HAVE_TEXI2DVI, test "$groff_have_texi2dvi" = yes )
+AM_CONDITIONAL(USE_TEX, test "$groff_use_tex" = yes )
 
 AC_CONFIG_FILES(Makefile)
 AC_CONFIG_FILES(test-groff, chmod +x test-groff)
 AC_OUTPUT
 
 echo "
-${PACKAGE_NAME} version ${PACKAGE_VERSION}
+$PACKAGE_NAME version $PACKAGE_VERSION
 ----------------------------------------------------------------------
- Prefix                          : ${prefix}
- Compiler                        : ${CC} ${CFLAGS} ${CPPFLAGS}"
-if test "x$groff_no_x" = "xyes"; then
-echo "\
- X11 support                     : no"
-else
-echo "\
- X11 support                     : yes
- X11 resources dir               : $appresdir"
+ installation directory prefix    : $prefix"
+if test -n "$g"
+then
+  echo "\
+ command name prefix              : $g"
+  if test -n "$tmac_wrap"
+  then
+  echo "\
+ prefix used for macro packages   : $tmac_wrap"
+  fi
 fi
-if test "x$doc" = x; then
 echo "\
- Doc build                       : no"
+ C++ compiler and options         : $CXX $CXXFLAGS $CPPFLAGS
+ use libgroff's memory allocator  : $groff_use_own_allocator
+ C compiler and options           : $CC $CFLAGS $CPPFLAGS
+ Perl interpreter version         : $perl_version"
+if test "$groff_no_x" = yes
+then
+  echo "\
+ X11 support                      : disabled"
 else
-echo "\
- Doc build                       : ${doc} "
+  echo "\
+ X11 support                      : enabled
+ X11 app defaults directory       : $appdefdir"
 fi
 echo "\
- URW fonts for pdf               : $groff_have_urw_fonts
- Use uchardet library for preconv: $groff_have_uchardet
- pdftools for distcheck          : $groff_have_pdftools"
+ 'groff -l' uses print spooler    : $groff_have_spooler
+ use URW fonts for PDF output     : $groff_have_urw_fonts"
+if test "$groff_have_urw_fonts" = yes
+then
+ echo "\
+ URW fonts directory              : $urwfontsdir"
+fi
 echo "\
+ preconv can use uchardet library : $groff_have_uchardet
+ can build groff.dvi, groff.pdf   : $groff_use_tex
 ----------------------------------------------------------------------"
 
-GROFF_APPRESDIR_CHECK
-GROFF_URW_FONTS_CHECK
-GROFF_UCHARDET_CHECK
+GROFF_APPDEFDIR_NOTICE
+GROFF_AWK_NOTICE
+GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE
+GROFF_GHOSTSCRIPT_VERSION_NOTICE
+GROFF_URW_FONTS_NOTICE
+GROFF_UCHARDET_NOTICE
+GROFF_GROHTML_PROGRAM_NOTICE
+GROFF_PDFROFF_PROGRAM_NOTICE
+GROFF_GROPDF_PROGRAM_NOTICE

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/ChangeLog Changed

@@ -1,3 +1,57 @@
+2022-08-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* chem.pl: Refactor.
+	  - Rename scalars.
+	    Copyright -> copyright
+	    Program_Version -> chem_version
+	    Groff_Version -> groff_version
+	    Chem_Name -> chem
+	    before_make -> is_in_source_tree
+	  - Rename hash.
+	    at_at -> makevar
+	  - Drop unused hash member `$makevar{'BINDIR'}`.
+	  - Drop scalar `Groff_Version_Preset`, which apparently hadn't
+	    been updated since groff 1.20.  Instead, follow grog(1) and
+	    set the `groff_version` scalar to "DEVELOPMENT" if this is
+	    the version from the groff source tree.  Overwrite its value
+	    with that determined by make(1) if available.
+	  - Tighten usage and version messages; make the latter more
+	    conformant with the format recommended in the GNU Coding
+	    Standards.  Explicitly identify license as GNU GPLv2.
+	  (usage): Refer to "pic" with its command prefix if it is known
+	  to have one.  (If running "unbuilt", we have no way to know.)
+
+2022-08-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* chem.pl: Stop copying "pic.tmac" (fallback troff macro
+	definitions) into the output.  It might not be necessary and it
+	is inappropriate to do so if a macro package offers its own
+	definitions or the user has made other arrangements on the
+	command line.  (The same thing can be achieved with the "-mpic"
+	argument to the formatter or a front end.)  Bump version number.
+
+2022-06-15  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* chem.1.man: Fix markup nits.  Use idiomatic input style,
+	placing newlines after sentences and commas.  Also put an empty
+	request between sentences.
+
+	Fixes <https://savannah.gnu.org/bugs/?51328>.
+
+2022-04-12  Ingo Schwarze <schwarze@openbsd.org>
+
+	Delete the harmful, ill-designed, buggy, and essentially
+	unmaintained and untested --with-doc option of the configure
+	script.  See the NEWS file for more details on the rationale.
+
+	* chem.am: Delete three BUILD_EXAMPLES conditionals.
+
+2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* chem.1.man:
+	* examples/122/README.txt:
+	* examples/README.txt: Delete references to groffer.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* chem.am (chem, README): Use $(AM_V_GEN) to silence file generation.
@@ -303,7 +357,7 @@
 ________________________________________________________________
 License
 
-Copyright (C) 2006-2018  Free Software Foundation, Inc.
+Copyright (C) 2006-2020 Free Software Foundation, Inc.
 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 Copying and distribution of this file, with or without
@@ -313,7 +367,7 @@
 This file is part of `chem', which is part of the `groff' project.
 
 
-####### Emacs settings
+##### Editor settings
 Local Variables:
 mode: change-log
 End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/README.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/README.txt Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/chem.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/chem.1.man Changed

@@ -1,17 +1,15 @@
-.TH @G@CHEM @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@chem \- groff preprocessor for producing chemical structure diagrams
-.
-.\" @g@chem.1 - man page for @g@chem (section 1).
-.\" Source file position:  <groff_source_top>/contrib/chem/chem.man
-.\" Installed position:    $prefix/share/man/man1/@g@chem.1
+.TH @g@chem @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@chem \- embed chemical structure diagrams in
+.I groff
+documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of chem, which is part of groff, a free software
 .\" project.
@@ -24,51 +22,54 @@
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
 .
-.\" ====================================================================
-.\" Setup
-.\" ====================================================================
-.
-.
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr chem_C \n.C
+.do nr *groff_chem_1_man_C \n.cp
 .cp 0
 .
-.
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
-.
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH "SYNOPSIS"
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@chem
-.OP \-\-
-.RI  filespec
-\*(EL
+.RB  \-\- 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY @g@chem
 .B \-h
+.
 .SY @g@chem
 .B \-\-help
 .YS
 .
+.
 .SY @g@chem
 .B \-v
+.
 .SY @g@chem
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I chem
@@ -77,13 +78,13 @@
 Today's version is best suited for organic chemistry (bonds, rings).
 .
 The
-.B @g@chem
+.I @g@chem
 program is a
-.B groff
+.I groff
 preprocessor like
-.BR @g@eqn ,
-.BR @g@pic ,
-.BR @g@tbl ,
+.IR @g@eqn ,
+.IR @g@pic ,
+.IR @g@tbl ,
 etc.
 .
 It generates
@@ -96,15 +97,13 @@
 .
 .
 .P
-A
-.I filespec
-argument is either a file name of an existing file or a minus
-character
-.BR \- ,
-meaning standard input.
-.
-If no argument is specified then standard input is taken
-automatically.
+If no operands are given,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I @g@chem
+reads the standard input stream.
 .
 .B \-h
 and
@@ -120,12 +119,12 @@
 .
 .P
 The program
-.B @g@chem
+.I @g@chem
 originates from the Perl source file
 .IR chem.pl .
 .
 It tells
-.B @g@pic
+.I @g@pic
 to include a copy of the macro file
 .IR chem.pic .
 .
@@ -153,13 +152,11 @@
 .
 .
 .IP
-.nf
-.ft B
+.EX
 \&.cstart
-\fIchem data\fP
+.I chem data
 \&.cend
-.ft
-.fi
+.EE
 .
 .
 .P
@@ -168,7 +165,7 @@
 and
 .B .cend
 start and end the input for
-.BR @g@chem ,
+.IR @g@chem ,
 respectively.
 .
 In
@@ -195,15 +192,13 @@
 As an example,
 .
 .IP
-.nf
-.ft B
+.EX
 \&.cstart
 CH3
 bond
 CH3
 \&.cend
-.ft
-.fi
+.EE
 .
 .
 .P
@@ -213,45 +208,43 @@
 .
 .
 .P
-To actually view this, you must run
-.B @g@chem
-followed by
-.BR groffer :
-.
-.IP
-.B @g@chem file \*(EL | groffer
-.
-.P
 If you want to create just
-.B groff
+.I groff
 output, you must run
-.B @g@chem
+.I @g@chem
 followed by
-.B groff
+.I groff
 with the option
 .B \-p
 for the activation of
-.BR @g@pic :
+.IR @g@pic :
 .IP
-.B @g@chem file \*(EL | groff \-p \*(EL
+.I @g@chem
+.RI  file\~ .\|.\|.\&
+.BR "| groff \-p\~" .\|.\|.
 .
 .
 .\" ====================================================================
-.SH THE LANGUAGE
+.SH Language
 .\" ====================================================================
 .
 The
 .I chem
-input language is rather small.  It provides rings of several styles
-and a way to glue them together as desired, bonds of several styles,
-moieties (e.g.,
+input language is rather small.
+.
+It provides rings of several styles and a way to glue them together as
+desired,
+bonds of several styles,
+moieties
+(e.g.,
 .BR C ,
 .BR NH3 ,
-\*(EL, and strings.
+\&.\|.\|.,
+and strings.
 .
 .
 .\" ====================================================================
-.SS Setting Variables
+.SS "Setting variables"
 .\" ====================================================================
 .
 There are some variables that can be set by commands.
@@ -389,11 +382,11 @@
 .SS Rings
 .\" ====================================================================
 .
-There are lots of rings, but only 5 and 6-sided rings get
-much support.
+There are lots of rings,
+but only five- and six-sided rings get much support.
 .
 .B ring
-by itself is a 6-sided ring;
+by itself is a six-sided ring;
 .B benzene
 is the benzene ring with a circle inside.
 .B aromatic
@@ -407,14 +400,14 @@
 .RB  \%double\ \c
 .IR i , j\ \/\c
 .IR k , l\ \/\c
-\*(EL
+\&.\|.\|.\&
 .RI  picstuff 
 .YS
 .RE
 .
 .
 .P
-The vertices of a ring are numbered 1, 2, \*(EL from the
+The vertices of a ring are numbered 1, 2, \&.\|.\|.\& from the
 vertex that points in the natural compass direction.
 .
 So for a hexagonal ring with the point at the top, the top vertex
@@ -424,18 +417,16 @@
 This is expressed as
 .
 .IP
-.ft B
-.nf
+.EX
 R1: ring pointing up
 R2: ring pointing right
-.fi
-.ft
+.EE
 .
 .
 .P
 The ring vertices are named
 .BR .V1 ,
-\*(EL,
+\&.\|.\|.,
 .BI .V n\fR,\fP
 with
 .B .V1
@@ -459,23 +450,26 @@
 .B R2.V4
 the leftmost.
 .
-These vertex names are used for connecting bonds or other rings.  For
-example,
+These vertex names are used for connecting bonds or other rings.
+.
+For example,
 .
 .IP
-.ft B
-.nf
+.EX
 R1: benzene pointing right
 R2: benzene pointing right with .V6 at R1.V2
-.fi
-.ft
+.EE
+.
+.
 .P
 creates two benzene rings connected along a side.
 .
 .
 .P
 Interior double bonds are specified as
-.BI \%double\  n1 , n2\ n3 , n4\ \fR\*(EL;\fP
+.B \%double
+.IB n1 , "n2 n3" , n4
+.RB .\|.\|. ;
 each number pair adds an interior bond.
 .
 So the alternate form of a benzene ring is
@@ -506,16 +500,16 @@
 .
 .
 .P
-There are two 5-sided rings.
+There are two five-sided rings.
 .
 .B ring5
-is pentagonal with a side that matches the 6-sided ring; it has four
-natural directions.
+is pentagonal with a side that matches the six-sided ring;
+it has four natural directions.
 .
 A
 .B \%flatring
-is a 5-sided ring created by chopping one corner of a 6-sided ring so
-that it exactly matches the 6-sided rings.
+is a five-sided ring created by chopping one corner of a six-sided ring
+so that it exactly matches the six-sided rings.
 .
 .
 .P
@@ -523,7 +517,7 @@
 .
 .
 .\" ====================================================================
-.SS Moieties and Strings
+.SS "Moieties and strings"
 .\" ====================================================================
 .
 A moiety is a string of characters beginning with a capital letter,
@@ -612,8 +606,10 @@
 .
 It represents a string that should be printed (without the quotes).
 .
-Text within quotes \(dq\*(EL\(dq is treated more or less
-like a moiety except that no changes are made to the quoted part.
+Text within quotes
+.BR \(dq .\|.\|.\& \(dq
+is treated more or less like a moiety except that no changes are made to
+the quoted part.
 .
 .
 .\" ====================================================================
@@ -632,7 +628,7 @@
 .
 .IP
 .IB Name :
-\*(EL
+\&.\|.\|.
 .
 .
 .P
@@ -661,17 +657,15 @@
 The specific construction
 .RS
 .TP
-.BR bond\  \*(EL " ; moiety"
+.BR bond \~.\|.\|.\&\~ "; moiety"
 .RE
 .P
 is equivalent to
 .IP
-.ft B
-.nf
+.EX
 bond
 moiety
-.fi
-.ft
+.EE
 .
 .
 .P
@@ -684,7 +678,7 @@
 A period character
 .B .\&
 or a single quote
-.B '
+.B \aq
 in the first column of a line signals a
 .I troff
 command, which is copied through as-is.
@@ -725,9 +719,9 @@
 .
 .P
 Since
-.B @g@chem
+.I @g@chem
 is a
-.B @g@pic
+.I @g@pic
 preprocessor, it is possible to include
 .I pic
 statements in the middle of a diagram to draw things not provided for
@@ -787,7 +781,7 @@
 .
 .
 .\" ====================================================================
-.SS WISH LIST
+.SS "Wish list"
 .\" ====================================================================
 .
 .P
@@ -813,8 +807,12 @@
 .
 .
 .P
-There is no in-line chemistry yet (e.g., analogous to the $\*(EL$
-construct of eqn).
+There is no in-line chemistry yet
+(e.g.,
+analogous to the
+.BR $ .\|.\|. $
+construct of
+.IR eqn ).
 .
 .
 .P
@@ -843,99 +841,85 @@
 .
 .
 .\" ====================================================================
-.SH "FILES"
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @DATASUBDIR@/pic/chem.pic
+.I @DATASUBDIR@/\:pic/\:chem\:.pic
 A collection of
 .I pic
 macros needed by
-.BR @g@chem .
+.IR @g@chem .
 .
 .TP
-.I @MACRODIR@/pic.tmac
+.I @MACRODIR@/\:pic\:.tmac
 A macro file which redefines
-.B .PS
+.BR .PS ,
+.BR .PE ,
 and
-.B .PE
+.B .PF
 to center
 .I pic
 diagrams.
 .
 .TP
-.IR @DOCDIR@/examples/chem/ * .chem
+.IR @DOCDIR@/\:\%examples/\:chem/\: * .chem
 Example files for
 .IR chem .
 .
 .TP
-.IR @DOCDIR@/examples/chem/122/ * .chem
-Example files from the classical
+.IR @DOCDIR@/\:\%examples/\:chem/\:122/\: * .chem
+Example files from the
 .I chem
-article
-.I "CHEM \en A Program for Typesetting Chemical Structure Diagrams"
-CSTR\~#122.
+article by its authors,
+\lqCHEM\emA Program for Typesetting Chemical Structure Diagrams:
+User Manual\rq
+(CSTR\~#122).
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
 The GNU version of
-.B chem
+.I chem
 was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 It is based on the documentation of Brian Kernighan's original
 .I awk
 version of
-.I chem
-at
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:who/\:bwk/\:index.html
-.UE .
+.IR chem .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR \%groff (@MAN1EXT@),
-.BR \%@g@pic (@MAN1EXT@),
-.BR \%groffer (@MAN1EXT@).
+\lqCHEM\emA Program for Typesetting Chemical Diagrams: User
+Manual\rq
+by Jon L.\& Bentley,
+Lynn W.\& Jelinski,
+and
+Brian W.\& Kernighan,
+1992,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 122
 .
 .
 .P
-You can still get the original
-.UR http://\:cm.bell\-labs.com/\:netlib/\:typesetting/\:chem.gz
-chem awk source
-.UE .
-.
-Its
-.B README
-file was used for this manual page.
-.
-.
-.P
-The other classical document on
-.I chem
-is
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:122.ps.gz
-.I "CHEM \en A Program for Typesetting Chemical Structure Diagrams"
-CSTR\~#122
-.UE .
+.MR groff @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \nchem_C
-.
+.cp \n*groff_chem_1_man_C
+.do rr *groff_chem_1_man_C
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/chem.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/chem.am Changed

@@ -1,13 +1,9 @@
 # Automake rules for 'chem'
 
-# File position: <groff-source>/contrib/chem/chem.am
-
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# Copyright (C) 2006-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Moved to automake by Bertrand Garrigues
 #
-# Last update: 22 Aug 2015
-#
 # This file is part of 'chem' which is part of 'groff'.
 #
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -42,7 +38,6 @@
   contrib/chem/examples/penicillin.chem \
   contrib/chem/examples/reserpine.chem
 
-if BUILD_EXAMPLES
 # Files installed in $(exampledir)/chem
 chemexampledir = $(exampledir)/chem
 nodist_chemexample_DATA = $(CHEM_GENEXAMPLES)
@@ -52,7 +47,6 @@
 # lazily installed by the local install target
 chemexample122dir = $(chemexampledir)/122
 nodist_chemexample122_DATA = contrib/chem/examples/122/README
-endif
 EXTRA_DIST += \
   contrib/chem/ChangeLog \
   contrib/chem/chem.1.man \
@@ -66,7 +60,7 @@
 MOSTLYCLEANFILES += $(CHEM_GENEXAMPLES) $(nodist_chemexample122_DATA) \
   contrib/chem/README
 
-# This is strangly built but not installed
+# This is strangely built but not installed
 all: contrib/chem/README
 
 contrib/chem/README: $(chem_srcdir)/README.txt
@@ -96,23 +90,19 @@
 
 install-data-local: install_chem_extra
 install_chem_extra:
-if BUILD_EXAMPLES
 	-test -d $(DESTDIR)$(chemexample122dir) \
           || $(mkinstalldirs) $(DESTDIR)$(chemexample122dir);
 	for i in $(chem_srcdir)/examples/122/*.chem; do \
 	  n=`echo $$i | sed 's|$(chem_srcdir)/examples/122/||g'`; \
 	  $(INSTALL_DATA) $$i $(DESTDIR)$(chemexample122dir)/$$n; \
 	done
-endif
 
 uninstall-local: uninstall_chem_extra
 uninstall_chem_extra:
-if BUILD_EXAMPLES
 	$(RM) $(DESTDIR)$(exampledir)/chem/122/*
 	-rmdir $(DESTDIR)$(exampledir)/chem/122
 	$(RM) $(DESTDIR)$(exampledir)/chem/*
 	-rmdir $(DESTDIR)$(exampledir)/chem
-endif
 	-rmdir $(DESTDIR)$(datasubdir)/pic
 
 dist-hook: dist_chem
@@ -123,12 +113,8 @@
 	done
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/chem.pic -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/chem.pic Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/chem.pl -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/chem.pl Changed

@@ -2,10 +2,8 @@
 
 # chem - a groff preprocessor for producing chemical structure diagrams
 
-# Source file position: <groff-source>/contrib/chem/chem.pl
-# Installed position: <prefix>/bin/chem
-
-my $Copyright = 'Copyright (C) 2006-2014 Free Software Foundation, Inc.';
+my $copyright = 'Copyright (C) 2006-2014, 2022'
+                . ' Free Software Foundation, Inc.';
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 # This file is part of 'chem', which is part of 'groff'.
@@ -26,13 +24,9 @@
 # settings
 ########################################################################
 
-my $Program_Version = '1.0.5';
-
-# this setting of the groff version is only used before make is run,
-# otherwise @VERSION@ will set it.
-my $Groff_Version_Preset='1.20preset';
+my $chem_version = '1.0.6';
+my $groff_version = 'DEVELOPMENT';
 
-# test on Perl version
 require v5.6;
 
 
@@ -50,41 +44,27 @@
 # $Bin is the directory where this script is located
 use FindBin;
 
-my $Chem_Name;
-my $Groff_Version;
+my $chem;
 my $File_chem_pic;
-my $File_pic_tmac;
-
-BEGIN {
-  {
-    my $before_make;		# script before run of 'make'
-    {
-      my $at = '@';
-      $before_make = 1 if '@VERSION@' eq "${at}VERSION${at}";
-    }
 
-    my %at_at;
+my $is_in_source_tree;
+{
+  $is_in_source_tree = 1 if '@VERSION@' eq '@' . 'VERSION' . '@';
+}
 
-    if ($before_make) {
-      my $chem_dir = $FindBin::Bin;
-      $at_at{'BINDIR'} = $chem_dir;
-      $at_at{'G'} = '';
-      $File_chem_pic = File::Spec->catfile($chem_dir, 'chem.pic');
-      $File_pic_tmac = File::Spec->catfile($chem_dir, '..', 'pic.tmac');
-      $Groff_Version = '';
-      $Chem_Name = 'chem';
-    } else {
-      $Groff_Version = '@VERSION@';
-      $at_at{'BINDIR'} = '@BINDIR@';
-      $at_at{'G'} = '@g@';
-      $at_at{'PICDIR'} = '@PICDIR@';
-      $at_at{'TMACDIR'} = '@MACRODIR@';
-      $File_chem_pic =
-	File::Spec->catfile($at_at{'PICDIR'}, 'chem.pic');
-      $File_pic_tmac = File::Spec->catfile($at_at{'TMACDIR'}, 'pic.tmac');
-      $Chem_Name = $at_at{'G'} . 'chem';
-    }
-  }
+my %makevar;
+
+if ($is_in_source_tree) {
+  my $chem_dir = $FindBin::Bin;
+  $makevar{'G'} = '';
+  $File_chem_pic = File::Spec->catfile($chem_dir, 'chem.pic');
+  $chem = 'chem';
+} else {
+  $groff_version = '@VERSION@';
+  $makevar{'G'} = '@g@';
+  $makevar{'PICDIR'} = '@PICDIR@';
+  $File_chem_pic = File::Spec->catfile($makevar{'PICDIR'}, 'chem.pic');
+  $chem = $makevar{'G'} . 'chem';
 }
 
 
@@ -212,10 +192,6 @@
     my @stdin = ();
     my $stdin = 0;
 
-    # for centralizing the pic code
-    open TMAC, "<$File_pic_tmac" and print <TMAC>;
-    close TMAC;
-
     foreach (@ARGV) {
       $count_minus++ if /^-$/;
     }
@@ -408,7 +384,7 @@
     }
 
     if ($Words0 eq 'pic') {
-      # pic pass-thru
+      # pic pass-through
       return 1 if $#Words == 0;
       my $s = $line;
       $s =~ /^\s*pic\s*(.*)$/;
@@ -1218,53 +1194,38 @@
 } # setparams()
 
 
-##########
-# usage()
-#
-# Print usage information for --help.
-#
 sub usage {
-  print "\n";
-  &version();
   print <<EOF;
+usage: $chem file ...
+usage: $chem { -h | --help | -v | --version }
 
-Usage: $Chem_Name option... filespec...
-
-$Chem_Name is a groff preprocessor for producing chemical structure
-diagrams.  The output suits to the pic preprocessor.
-
-"filespec" is one of
-  "filename"       name of a readable file
-  "-"              for standard input
-
-All available options are
-
--h --help         print this usage message.
--v --version      print version information.
+$chem is a groff preprocessor for producing chemical structure
+diagrams.  It produces input for the $makevar{'G'}pic preprocessor.  If
+no file operands are given, or if file is "-", the standard input stream
+is read.
 
+Options:
+ -h, --help     Display this message and exit.
+ -v, --version  Display version information and exit.
 EOF
-} # usage()
+}
 
 
-##########
-# version()
-#
-# Get version information from version.sh and print a text with this.
-#
 sub version {
-  $Groff_Version = $Groff_Version_Preset unless $Groff_Version;
   print <<EOF;
-$Chem_Name $Program_Version (Perl version)
-is part of groff version $Groff_Version.
-$Copyright
-GNU groff and chem come with ABSOLUTELY NO WARRANTY.
-You may redistribute copies of groff and its subprograms
-under the terms of the GNU General Public License.
+$chem (groff $groff_version) $chem_version
+$copyright
+License GPLv2: GNU GPL version 2
+<https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
 EOF
-} # version()
+}
 
 1;
-### Emacs settings
+
 # Local Variables:
+# fill-column: 72
 # mode: CPerl
 # End:
+# vim: set cindent noexpandtab shiftwidth=2 softtabstop=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/README.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/README.txt Changed

@@ -24,29 +24,12 @@
 
 You can view the graphical display of the examples by calling
 
-    groffer <file>
-
-'groffer' calls 'chem' automatically.
-
-If you want to transform example files to a different format use the
-'roff2*' programs:
-
-'roff2dvi' prints dvi format to standard output,
-'roff2html' generates html output,
-'roff2pdf' outputs pdf mode,
-'roff2ps' produces PostScript output,
-'roff2text' generates text output in the groff device 'latin1',
-'roff2x' prints the output  in  the  groff  device  X  that  is
-         suitable  for programs  like 'gxditview' or 'xditview'.
-
-To get a suitable 'groff' output run
-
     @g@chem <file> | groff -p ...
 
 
 ####### License
 
-Copyright (C) 2006-2018 Free Software Foundation, Inc.
+Copyright (C) 2006-2020 Free Software Foundation, Inc.
 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 This file is part of 'chem', which is part of 'groff'.
@@ -67,7 +50,7 @@
 <http://www.gnu.org/licenses/gpl-2.0.html>.
 
 
-####### Emacs settings
+##### Editor settings
 
 Local Variables:
 mode: text

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch2a_ethyl.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch2a_ethyl.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch2b_benzene.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch2b_benzene.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch2c_benzene_right.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch2c_benzene_right.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4a_stick.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4a_stick.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4b_methyl_acetate.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4b_methyl_acetate.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4c_colon.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4c_colon.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4d_HCl.H2O.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4d_HCl.H2O.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4e_CaSO4.2H2O.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4e_CaSO4.2H2O.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4f_C.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4f_C.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4g_BP.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4g_BP.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4h_methacrylate.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4h_methacrylate.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4i_cyclo.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4i_cyclo.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4j_ring4.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4j_ring4.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4k_ring3.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4k_ring3.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4l_vertex.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4l_vertex.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4m_double.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4m_double.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4n_triple.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4n_triple.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4o_aromatic.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4o_aromatic.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4p_cholestanol.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4p_cholestanol.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4q_rings.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4q_rings.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4r_spiro.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4r_spiro.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4s_heteroatoms.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4s_heteroatoms.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4t_polycyclic.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4t_polycyclic.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4u_nicotine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4u_nicotine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4v_histidine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4v_histidine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4w_lsd.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4w_lsd.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4x_anisole.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4x_anisole.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4y_reserpine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4y_reserpine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4z1_eqn_glutamic.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4z1_eqn_glutamic.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch4z2_text.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch4z2_text.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch5a_size.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch5a_size.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch6a_pic.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch6a_pic.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/ch6b_dna.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/ch6b_dna.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAa_polymer.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAa_polymer.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAb_vinyl_chloro.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAb_vinyl_chloro.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAc_morphine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAc_morphine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAd_chlorophyll.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAd_chlorophyll.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAe_chair.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAe_chair.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAf_arrow.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAf_arrow.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAg_circle.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAg_circle.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAh_brackets.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAh_brackets.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chAi_poly_vinyl_chloride.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chAi_poly_vinyl_chloride.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chBa_jump.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chBa_jump.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chBb_bonds.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chBb_bonds.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/122/chBc_rings.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/122/chBc_rings.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/README.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/README.txt Changed

@@ -2,23 +2,6 @@
 
 You can view the graphical display of the examples by calling
 
-    groffer <file>
-
-'groffer' calls 'chem' automatically.
-
-If you want to transform example files to a different format use the
-'roff2*' programs:
-
-'roff2dvi' prints dvi format to standard output,
-'roff2html' generates html output,
-'roff2pdf' outputs pdf mode,
-'roff2ps' produces PostScript output,
-'roff2text' generates text output in the groff device 'latin1',
-'roff2x' prints the output  in  the  groff  device  X  that  is
-         suitable  for programs  like 'gxditview' or 'xditview'.
-
-To get a suitable 'groff' output run
-
     @g@chem <file> | groff -p ...
 
 On the displays, you can see rings consisting of several lines and
@@ -37,7 +20,7 @@
 
 ####### License
 
-Copyright (C) 2006-2018 Free Software Foundation, Inc.
+Copyright (C) 2006-2020 Free Software Foundation, Inc.
 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 This file is part of 'chem', which is part of 'groff'.
@@ -56,7 +39,9 @@
 <http://www.gnu.org/licenses/gpl-2.0.html>.
 
 
-####### Emacs settings
+##### Editor settings
 Local Variables:
+fill-column: 72
 mode: text
 End:
+vim: set textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/atp.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/atp.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/cholesterin.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/cholesterin.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/ethamivan.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/ethamivan.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/lsd.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/lsd.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/morphine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/morphine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/penicillin.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/penicillin.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/chem/examples/reserpine.chem -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/chem/examples/reserpine.chem Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/eqn2graph/eqn2graph.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/eqn2graph/eqn2graph.1.man Changed

@@ -1,6 +1,8 @@
-.TH EQN2GRAPH @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-eqn2graph \- convert an EQN equation into a cropped image
+.TH eqn2graph @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+eqn2graph \- convert an
+.I eqn \" generic
+equation into a cropped image
 .
 .
 .\" ====================================================================
@@ -10,33 +12,57 @@
 .\" This documentation is released to the public domain.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_eqn2graph_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY eqn2graph
-.OP \-format output-format
-.RI  convert-arguments 
+.RB  \-format\~\c
+.IR output-format 
+.RI  convert-argument \~.\|.\|.
 .YS
 .
+.
 .SY eqn2graph
 .B \-\-help
 .YS
 .
+.
 .SY eqn2graph
 .B \-v
+.
 .SY eqn2graph
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I eqn2graph
 reads a one-line
-.IR @g@eqn (@MAN1EXT@)
+.MR @g@eqn @MAN1EXT@
 equation from the standard input and writes an image file,
 by default in Portable Network Graphics (PNG) format,
 to the standard output.
@@ -46,9 +72,9 @@
 The input EQN code should
 .I not
 be preceded by the
-.B \&.EQ
+.B .EQ
 macro that normally precedes it within
-.IR groff (@MAN1EXT@)
+.MR groff @MAN1EXT@
 macros;
 nor do you need to have dollar-sign or other delimiters around the
 equation.
@@ -64,7 +90,7 @@
 Arguments not recognized by
 .I eqn2graph
 are passed to the ImageMagick or GraphicsMagick program
-.IR \%convert (1).
+.MR convert 1 .
 .
 .
 By specifying these, you can give your image a border,
@@ -83,11 +109,21 @@
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
 .TP
-.BI "\-format " output-format
+.BI \-format\~ output-format
 Write the image in
 .IR output-format ,
 which must be understood by
@@ -95,20 +131,8 @@
 the default is PNG.
 .
 .
-.TP
-.B \-\-help
-Display a usage message and exit.
-.
-.
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
-.
-.
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
@@ -128,31 +152,37 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
 .I eqn2graph
 was written by
-.MT esr@\:thyrsus.com
+.MT esr@\:thyrsus\:.com
 Eric S.\& Raymond
 .ME ,
 based on a recipe for
-.IR pic2graph (@MAN1EXT@),
+.MR pic2graph @MAN1EXT@ ,
 by W.\& Richard Stevens.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR pic2graph (@MAN1EXT@),
-.IR grap2graph (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
-.IR groff (@MAN1EXT@),
-.IR \%convert (1)
+.MR pic2graph @MAN1EXT@ ,
+.MR grap2graph @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR convert 1
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_eqn2graph_1_man_C
+.do rr *groff_eqn2graph_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/eqn2graph/eqn2graph.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/eqn2graph/eqn2graph.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/ChangeLog Changed

@@ -1,3 +1,42 @@
+2023-02-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Revise test regime.  Reduce amount of indirection required to
+	run a test, and directly use the same script for standalone and
+	Automake-integrated testing.
+
+	* tests/gdiffmk_tests.sh: Delete.
+	* tests/runtests.sh: Revise to search for test artifact input
+	and output directories (source vs. build).  Drop argument
+	processing, converting two modes ("run" and "clean") into one
+	{run, with cleaning afterward}.  Also ensure we use the build
+	directory to construct "tmp_file.7".  Update authorship credit
+	so that Mike Bianchi isn't asked to support it.
+
+	* tests/baseline.7: Update expected test output.
+
+	* gdiffmk.am (TESTS): Run "runtests.sh" instead of
+	"gdiffmk_tests.sh".
+	(clean-local, clean_gdiffmk_check): Drop targets now that the
+	test script cleans up after itself.
+
+2023-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* tests/runtests.sh: Refactor file handling.  Use narrower globs
+	to match the file names actually used; they are suffixed with a
+	dot and a number, not a number alone.  Honor $TMPDIR when
+	creating the even-more-temporary file.  Revise trap setup so
+	that the trap handler cannot be interrupted if it is already
+	running.  Call the handler, then commit suicide with SIGINT.
+	Use symbolic names for signals, not numbers.  Call new CleanUp
+	function before exiting normally.
+	(CleanUp): Pull temporary file clean-up logic into new function.
+	Also delete the even-more-temporary file used in test 1.
+
+2022-10-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gdiffmk.sh: Drop "GNU" from version information, since this
+	program resides in groff's "contrib" directory.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* gdiffmk.am (gdiffmk): Use $(AM_V_GEN) to silence file generation.
@@ -159,15 +198,15 @@
 
 	First import of gdiffmk files.
 
-Copyright 2004-2009, 2014-2015
-  Free Software Foundation, Inc.
+Copyright 2004-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
+fill-column: 72
 mode: change-log
-coding: latin-1
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/README -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/README Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/gdiffmk.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/gdiffmk.1.man Changed

@@ -1,13 +1,15 @@
-.TH GDIFFMK @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-gdiffmk \- mark differences between groff/nroff/troff files
+.TH gdiffmk @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+gdiffmk \- mark differences between
+.IR groff / nroff / troff
+files
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2004-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2004-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of gdiffmk, which is part of groff, the GNU roff
 .\" type-setting system.
@@ -27,143 +29,175 @@
 .\" <http://www.gnu.org/licenses/>.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_gdiffmk_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY gdiffmk
-.OP \-a addmark
-.OP \-c changemark
-.OP \-d deletemark
+.RB  \-a\~\c
+.IR add-mark 
+.RB  \-c\~\c
+.IR change-mark 
+.RB  \-d\~\c
+.IR delete-mark 
+.RB  \-x\~\c
+.IR diff-command 
 .RB  \-D
 .RB  \-B 
 .RB  \-M
 .IR "mark1 mark2" 
-.OP \-x diffcmd
-.OP \-\-
+.RB  \-\- 
 .I file1
 .I file2
 .RI  output 
 .YS
 .
+.
 .SY gdiffmk
 .B \-\-help
 .YS
 .
+.
 .SY gdiffmk
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B gdiffmk
+.I gdiffmk
 compares two
-.BR groff (1),
-.BR nroff (1),
-or
-.BR troff (1)
+.MR roff @MAN7EXT@
 documents,
 .I file1
 and
 .IR file2 ,
-and creates an output which is
+and creates a
+.I roff
+document consisting of
 .I file2
-with added \lqmargin character\rq (.mc) commands that indicate the
-differences.
+with added margin character
+.RB ( .mc )
+requests indicating output lines that differ from
+.I file1.
 .
-.
-.LP
-If the
-.I output
-filename is present,
-the output is written there.
-.
-If it is
-.B \-
-or absent the output is written to the standard output.
-.
-.
-.LP
 If the
 .I file1
 or
 .I file2
 argument is
-.B \-
-the standard input is read for that input.
-.
-Clearly both cannot be
-.BR \- .
+.RB \lq \- \rq,
+.I gdiffmk
+reads the standard input stream for that input.
 .
+If the
+.I output
+operand is present,
+.I gdiffmk
+writes output to a file of that name.
 .
-.LP
-Note that the output is not necessarily compatible with all macro packages
-and all preprocessors.
+If it is
+.RB \lq \- \rq
+or absent,
+.I gdiffmk
+writes output to the standard output stream.
 .
-See section \(lqBugs\(rq below.
+.RB \lq \- \rq
+cannot be both an input and output operand.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message
+and
+.B \-\-version
+shows version information;
+both exit afterward.
+.
+.
 .TP
-.BI \-a addmark
-Use the
-.I addmark
+.BI \-a\~ add-mark
+Use
+.I add-mark
 for source lines not in
 .I file1
 but present in
 .IR file2 .
 .
 Default:
-.BR + .
+.RB \lq + \rq.
+.
 .
 .TP
 .B \-B
-By default, the deleted texts marked by the
+By default,
+the deleted texts marked by the
 .B \-D
-option end
-with an added troff break command,
+option end with an added
+.I roff
+break request,
 .BR .br ,
 to ensure that the deletions are marked properly.
 .
 This is the only way to guarantee that deletions and small
 changes get flagged.
 .
-This option directs the program not to insert these breaks; it makes
-no sense to use it without
+This option directs the program not to insert these breaks;
+it makes no sense to use it without
 .BR \-D .
 .
+.
 .TP
-.BI \-c changemark
-Use the
-.I changemark
+.BI \-c\~ change-mark
+Use
+.I change-mark
 for changed source lines.
 .
 Default:
-.BR | .
+.RB \lq | \rq.
+.
 .
 .TP
-.BI \-d deletemark
+.BI \-d\~ delete-mark
 Use the
-.I deletemark
+.I delete-mark
 for deleted source lines.
 .
 Default:
-.BR * .
+.RB \lq * \rq.
 .
 .TP
 .B \-D
 Show the deleted portions from changed and deleted text.
 .
-Default delimiting marks:
-.BR "" " \&.\|.\|.\& " "" .
 .
 .TP
-.BI \-M "mark1 mark2"
+.BI \-M\~ "mark1 mark2"
 Change the delimiting marks for the
 .B \-D
 option.
@@ -171,90 +205,100 @@
 It makes no sense to use this option without
 .BR \-D .
 .
+Default delimiting marks:
+.RB \lq  "\rq .\|.\|.\& \lq"  \rq.
+.
+.
 .TP
-.BI \-x diffcmd
+.BI \-x\~ diff-command
 Use the
-.I diffcmd
+.I diff-command
 command to perform the comparison of
 .I file1
 and
 .IR file2 .
 .
 In particular,
-.I diffcmd
+.I diff-command
 should accept the GNU
-.B diff
-.BI \-D name
+.MR diff 1
+.B \-D
 option.
 .
 Default:
-.BR diff (1).
+.BR diff .
+.
 .
 .TP
 .B \-\-
-All the following arguments are treated as file names,
+Treat all subsequent arguments as file names,
 even if they begin with
-.BR \- .
-.
-.TP
-.B \-\-help
-Print a usage message on standard error output and exit.
-.
-.TP
-.B \-\-version
-Print version information on the standard output and exit.
+.RB \lq \- \rq.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
 .
 The output is not necessarily compatible with all macro packages
 and all preprocessors.
 .
-A workaround that is often successful against preprocessor problems is
-to run
-.B gdiffmk
+A workaround that often overcomes preprocessor problems is to run
+.I gdiffmk
 on the output of all the preprocessors instead of the input source.
 .
 .
 .LP
-.B gdiffmk
+.I gdiffmk
 relies on the
-.BI \-D name
+.B \-D
 option of GNU
-.BR diff (1)
+.I diff
 to make a merged \lq#ifdef\rq output format.
 .
-It hasn't been tested whether other versions of
-.BR diff (1)
-do support this option.
+Busybox
+.I diff
+is known to not support it.
 .
-See also the
-.BI \-x diffcmd
+Also see the
+.BI \-x\~ diff-command
 option.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-.B gdiffmk
-was written and is maintained by
-.MT MBianchi@\:Foveal.com
+.
+.I gdiffmk
+was written by
+.MT MBianchi@\:Foveal\:.com
 Mike Bianchi
-.ME .
+.ME ,
+now retired.
+.
+It is maintained by the
+.I groff
+developers.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR nroff (@MAN1EXT@),
-.BR gtroff (@MAN1EXT@),
-.BR diff (@MAN1EXT@)
+.MR groff @MAN1EXT@ ,
+.MR nroff @MAN1EXT@ ,
+.MR gtroff @MAN1EXT@ ,
+.MR roff @MAN7EXT@ ,
+.MR diff @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_gdiffmk_1_man_C
+.do rr *groff_gdiffmk_1_man_C
+.
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/gdiffmk.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/gdiffmk.am Changed

@@ -1,13 +1,9 @@
 # Automake rules for 'gdiffmk' (integration into the groff source tree)
 #
-# File position: <groff-source>/contrib/gdiffmk/gdiffmk.am
-#
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
+# Copyright (C) 2004-2020 Free Software Foundation, Inc.
 # Written by Mike Bianchi <MBianchi@Foveal.com <mailto:MBianchi@Foveal.com>>
 # Automake migration by Bertrand Garrigues
 #
-# Last update: 20 Aug 2015
-#
 # This file is part of the gdiffmk utility, which is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it
@@ -26,14 +22,13 @@
 ########################################################################
 gdiffmk_srcdir = $(top_srcdir)/contrib/gdiffmk
 bin_SCRIPTS += gdiffmk
-TESTS += contrib/gdiffmk/tests/gdiffmk_tests.sh
+TESTS += contrib/gdiffmk/tests/runtests.sh
 man1_MANS += contrib/gdiffmk/gdiffmk.1
 EXTRA_DIST += \
   contrib/gdiffmk/gdiffmk.1.man \
   contrib/gdiffmk/ChangeLog \
   contrib/gdiffmk/README \
   contrib/gdiffmk/gdiffmk.sh \
-  contrib/gdiffmk/tests/gdiffmk_tests.sh \
   contrib/gdiffmk/tests/runtests.sh \
   contrib/gdiffmk/tests/baseline \
   contrib/gdiffmk/tests/baseline.6 \
@@ -56,20 +51,9 @@
 	    >$@ \
 	&& chmod +x $@
 
-clean-local: clean_gdiffmk_check
-clean_gdiffmk_check:
-	if test -d $(top_builddir)/contrib/gdiffmk/tests; then \
-	  cd $(top_builddir)/contrib/gdiffmk/tests && \
-	  $(abs_top_srcdir)/contrib/gdiffmk/tests/runtests.sh clean; \
-	fi
-
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/gdiffmk.sh -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/gdiffmk.sh Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/tests/baseline.7 -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/tests/baseline.7 Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gdiffmk/tests/runtests.sh -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gdiffmk/tests/runtests.sh Changed

@@ -2,8 +2,9 @@
 #
 #	A very simple function test for gdiffmk.sh.
 #
-# Copyright (C) 2004-2018 Free Software Foundation, Inc.
-# Written by Mike Bianchi <MBianchi@Foveal.com <mailto:MBianchi@Foveal.com>>
+# Copyright (C) 2004-2020, 2023 Free Software Foundation, Inc.
+# Written by Mike Bianchi <MBianchi@Foveal.com>.
+# Subsequent modifications by G. Branden Robinson.
 
 # This file is part of the gdiffmk utility, which is part of groff.
 
@@ -21,34 +22,60 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # This file is part of GNU gdiffmk.
 
-# abs_top_srcdir and abs_top_builddir are set by AM_TESTS_ENVIRONMENT
-# (defined in Makefile.am) when running make check
-
-srcdir=${abs_top_srcdir}/contrib/gdiffmk/tests
-
-command=${abs_top_builddir}/gdiffmk
-
-#	Test the number of arguments and the first argument.
-case "$#-$1" in
-1-clean )
-	rm -fv result* tmp_file*
-	exit 0
-	;;
-1-run )
-	;;
-* )
-	echo >&2 "$0  clean | run 
-Run a few simple tests on '${command}'."'
-
-clean	Remove the result? and tmp_file? files.
-run	Run the tests.
-'
-	exit 255
-	;;
-esac
+# abs_top_out_dir is set by AM_TESTS_ENVIRONMENT (defined in
+# Makefile.am) when running "make check".
+
+gdiffmk=${abs_top_out_dir:-.}/gdiffmk
+
+# Locate directory containing our test artifacts.
+in_dir=
+
+for srcroot in . .. ../..
+do
+    # Look for a source file characteristic of the groff source tree.
+    if !  -f "$srcroot"/ChangeLog.115 
+    then
+        continue
+    fi
+
+    d=$srcroot/contrib/gdiffmk/tests
+    if  -d "$d" 
+    then
+        in_dir=$d
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+if  -z "$in_dir" 
+then
+    echo "$0: cannot locate test artifact input directory" >&2
+    exit 77 # skip
+fi
+
+# Locate directory where we'll put the test output.
+out_dir=
+
+for buildroot in . .. ../..
+do
+    d=$buildroot/contrib/gdiffmk/tests
+    if  -d "$d" 
+    then
+        out_dir=$d
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+if  -z "$out_dir" 
+then
+    echo "$0: cannot locate test artifact output directory" >&2
+    exit 77 # skip
+fi
 
 exit_code=0	#  Success
 failure_count=0
+
 TestResult () {
 	if cmp -s $1 $2
 	then
@@ -63,92 +90,98 @@
 	fi
 }
 
-tmpfile=/tmp/$$
-trap 'rm -f ${tmpfile}' 0 1 2 3 15
+CleanUp () {
+	rm -f ${out_dir}/result.* ${out_dir}/tmp_file.* ${tmpfile}
+}
+
+tmpfile=${TMPDIR:-/tmp}/$$
+trap 'trap "" HUP INT QUIT TERM; CleanUp; kill -s INT $$' \
+	HUP INT QUIT TERM
 
 #	Run tests.
 
 #	3 file arguments
-ResultFile=result.1
-${command}  ${srcdir}/file1  ${srcdir}/file2 ${ResultFile} 2>${tmpfile}
+ResultFile=${out_dir}/result.1
+${gdiffmk}  ${in_dir}/file1  ${in_dir}/file2 ${ResultFile} 2>${tmpfile}
 cat ${tmpfile} >>${ResultFile}
-TestResult ${srcdir}/baseline ${ResultFile}
-
+TestResult ${in_dir}/baseline ${ResultFile}
 
 #	OUTPUT to stdout by default
-ResultFile=result.2
-${command}  ${srcdir}/file1  ${srcdir}/file2  >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline ${ResultFile}
-
+ResultFile=${out_dir}/result.2
+${gdiffmk}  ${in_dir}/file1  ${in_dir}/file2  >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline ${ResultFile}
 
 #	OUTPUT to stdout via  -  argument
-ResultFile=result.3
-${command}  ${srcdir}/file1  ${srcdir}/file2 - >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline ${ResultFile}
-
+ResultFile=${out_dir}/result.3
+${gdiffmk}  ${in_dir}/file1  ${in_dir}/file2 - >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline ${ResultFile}
 
 #	FILE1 from standard input via  -  argument
-ResultFile=result.4
-${command}  - ${srcdir}/file2 <${srcdir}/file1  >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline ${ResultFile}
+ResultFile=${out_dir}/result.4
+${gdiffmk}  - ${in_dir}/file2 <${in_dir}/file1  >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline ${ResultFile}
 
 
 #	FILE2 from standard input via  -  argument
-ResultFile=result.5
-${command}  ${srcdir}/file1 - <${srcdir}/file2  >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline ${ResultFile}
+ResultFile=${out_dir}/result.5
+${gdiffmk}  ${in_dir}/file1 - <${in_dir}/file2  >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline ${ResultFile}
 
 
 #	Different values for addmark, changemark, deletemark
-ResultFile=result.6
-${command}  -aA -cC -dD  ${srcdir}/file1 ${srcdir}/file2  >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.6 ${ResultFile}
+ResultFile=${out_dir}/result.6
+${gdiffmk}  -aA -cC -dD  ${in_dir}/file1 ${in_dir}/file2  >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.6 ${ResultFile}
 
 
 #	Different values for addmark, changemark, deletemark
 #	Alternate format of -a -c and -d flag arguments
-ResultFile=result.6a
-${command}  -a A -c C -d D  ${srcdir}/file1 ${srcdir}/file2  >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.6a ${ResultFile}
+ResultFile=${out_dir}/result.6a
+${gdiffmk}  -a A -c C -d D  ${in_dir}/file1 ${in_dir}/file2  >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.6a ${ResultFile}
 
 
 #	Test for accidental file overwrite.
-ResultFile=result.7
-cp ${srcdir}/file2 tmp_file.7
-${command}  -aA -dD -cC  ${srcdir}/file1 tmp_file.7  tmp_file.7	\
+ResultFile=${out_dir}/result.7
+TempFile=${out_dir}/tmp_file.7
+cp ${in_dir}/file2 "$TempFile"
+${gdiffmk}  -aA -dD -cC  ${in_dir}/file1 "$TempFile"  "$TempFile" \
 							>${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.7 ${ResultFile}
+TestResult ${in_dir}/baseline.7 ${ResultFile}
 
 
 #	Test -D option
-ResultFile=result.8
-${command}  -D  ${srcdir}/file1 ${srcdir}/file2 >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.8 ${ResultFile}
+ResultFile=${out_dir}/result.8
+${gdiffmk}  -D  ${in_dir}/file1 ${in_dir}/file2 >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.8 ${ResultFile}
 
 
 #	Test -D  and  -M  options
-ResultFile=result.9
-${command}  -D  -M '<<<<' '>>>>'				\
-			${srcdir}/file1 ${srcdir}/file2 >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.9 ${ResultFile}
+ResultFile=${out_dir}/result.9
+${gdiffmk}  -D  -M '<<<<' '>>>>'				\
+			${in_dir}/file1 ${in_dir}/file2 >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.9 ${ResultFile}
 
 
 #	Test -D  and  -M  options
 #	Alternate format of -M argument.
-ResultFile=result.9a
-${command}  -D  -M'<<<<' '>>>>'				\
-			${srcdir}/file1 ${srcdir}/file2 >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.9a ${ResultFile}
+ResultFile=${out_dir}/result.9a
+${gdiffmk}  -D  -M'<<<<' '>>>>'				\
+			${in_dir}/file1 ${in_dir}/file2 >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.9a ${ResultFile}
 
 
 #	Test -D  and  -B  options
-ResultFile=result.10
-${command}  -D  -B  ${srcdir}/file1 ${srcdir}/file2 >${ResultFile} 2>&1
-TestResult ${srcdir}/baseline.10 ${ResultFile}
+ResultFile=${out_dir}/result.10
+${gdiffmk}  -D  -B  ${in_dir}/file1 ${in_dir}/file2 >${ResultFile} 2>&1
+TestResult ${in_dir}/baseline.10 ${ResultFile}
 
 
 echo failure_count ${failure_count}
 
+# You can comment out the following line to examine failing cases.
+CleanUp
+
 exit ${exit_code}
 
-#	EOF
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/ChangeLog Changed

@@ -1,3 +1,57 @@
+2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* glilypond.pl (version): Report version information in format
+	recommended by GNU coding standards.  Bump micro version number
+	to reflect this and the restructuring immediately previous.
+
+2022-10-19  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Make glilypond script stand alone.
+
+	* args.pl:
+	* oop_fh.pl
+	* subs.pl: Delete, moving their content into...
+	* glilypond.pl: ...here.  Also bump overall license to GPLv3
+	from GPLv2 because all of the deleted files were GPLv3.
+	* glilypond.am (dist_glilypond_DATA): Delete.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* glilypond.am (glilypond): Spell dependency on
+	`$(SH_DEPS_SED_SCRIPT)` using that macro expansion instead of a
+	literal file name.  See groff's doc/automake.mom.
+
+2021-01-06  Colin Watson <cjwatson@debian.org>
+
+	* glilypond.pl: Avoid Perl's unsafe "<>" operator.
+
+	The "<>" operator is implemented using the two-argument form of
+	"open", which interprets magic such as pipe characters, allowing
+	execution of arbitrary commands which is unlikely to be
+	expected.  Perl >= 5.22 has a "<<>>" operator which avoids this,
+	but also forbids the use of "-" to mean the standard input,
+	which is a facility that the affected groff programs document.
+
+	ARGV::readonly would probably also fix this, but I fundamentally
+	dislike the approach of escaping data in preparation for a
+	language facility to unescape it, especially when the required
+	escaping is as non-obvious as it is here.  (For the same reason,
+	I prefer to use subprocess invocation facilities that allow
+	passing the argument list as a list rather than as a string to
+	be interpreted by the shell.)  So I've abandoned this dubious
+	convenience and changed the affected programs to iterate over
+	command-line arguments manually using the three-argument form of
+	open.
+
+	glilypond doesn't need the initial unshift since that's already
+	handled in args.pl.
+
+	Fixes <https://savannah.gnu.org/bugs/?55557>.
+
+2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* glilypond.1.man: Delete references to groffer.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* glilypond.am (glilypond): Use $(AM_V_GEN) to silence file generation.
@@ -222,13 +276,15 @@
 
 ########################################################################
 
-Copyright 2013-2018 Free Software Foundation, Inc.
+Copyright 2013-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
+fill-column: 72
 mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/ChangeLog.0x -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/ChangeLog.0x Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/README.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/README.txt Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/examples/example.groff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/examples/example.groff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/glilypond.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/glilypond.1.man Changed

@@ -1,18 +1,17 @@
 .TH glilypond @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-glilypond \- integrate lilypond parts into groff
+.SH Name
+glilypond \- embed LilyPond musical notation in
+.I groff
+documents
 .
-.\" glilypond - integrate 'lilypond' parts into 'groff' files
-.\" Source file position:  <groff_source_top>/contrib/glilypond.man
-.\" Installed position:    <prefix>/share/man/man1/glilypond.1
 .
-.\" TODO: This page needs a thorough edit by a native English speaker.
+.\" TODO: This page needs a thorough edit by a fluent English speaker.
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2013-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2013-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of glilypond, which is part of GNU groff, a free
 .\" software project.
@@ -25,25 +24,35 @@
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
 .
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_glilypond_1_man_C \n.cp
+.cp 0
 .
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY glilypond
+.RB  \-k 
 .RB { \-\-ly2eps | \-\-pdf2eps }
 .RB  \-e
 .IR directory 
-.OP \-k
 .RB  \-o
 .IR output-file 
 .RB  \-p
@@ -51,28 +60,27 @@
 .RB  \-t
 .IR tdir 
 .RB { \-v | \-V }
-.OP \-
-.OP \-\-
-.RI  filespec
-\*(EL
+.RB  \-\- 
+.RI  file\~ .\|.\|.
+.
+.
 .SY glilypond
 .RB { \-\-ly2eps | \-\-pdf2eps }
 .RB  \-\-eps_dir
 .IR directory 
-.OP \-\-keep_all
+.RB  \-\-keep_all 
 .RB  \-\-output
 .IR output-file 
 .RB  \-\-prefix
 .IR filename-prefix 
 .RB  \-\-temp_dir
 .IR tdir 
-.OP \-\-verbose
-.OP \-
-.OP \-\-
-.RI  filespec
-\*(EL
+.RB  \-\-verbose 
+.RB  \-\- 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY glilypond
 .B \-?
 .SY glilypond
@@ -83,177 +91,122 @@
 .B \-\-usage
 .YS
 .
+.
 .SY glilypond
 .B \-l
 .SY glilypond
 .B \-\-license
 .YS
 .
+.
 .SY glilypond
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B glilypond
-transforms sheet music written in the
-.I lilypond
-language into the
-.BR groff (@MAN7EXT@)
-language using the
-.B .PSPIC
-request, such that
-.BR groff (@MAN1EXT@)
-can transform it into a format that can be displayed directly.
-.
-.B .PDFPIC
-is available, but does on yet work with lilypond.
+.I glilypond
+is a
+.MR groff @MAN7EXT@
+preprocessor that enables the embedding of LilyPond music scores in
+.I groff
+documents.
+.\".
+.\".B .PDFPIC
+.\"is available, but does not yet work with lilypond.
 .
+If no operands are given,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I glilypond
+reads the standard input stream.
 .
-.P
-Files in
-.I groff
-language and
-.I "standard input"
-can be provided as arguments.
+A double-dash argument
+.RB (\lq \-\- \rq)
+causes all subsequent arguments to be interpreted as
+.I file
+operands,
+even if their names start with a dash.
 .
 .
 .\" ====================================================================
-.SH "WORKING GLILYPOND"
+.SH Usage
 .\" ====================================================================
 .
-Together with
-.BR .PSPIC ,
-.B glilypond can work only for
-.I troff
-devices without
-.I PDF
+At present,
+.I glilypond
+works with the
+.I groff
+.BR ps ,
+.BR dvi ,
+.BR html ,
 and
-.I X
+.B xhtml
 devices.
 .
-.
-.P
-I.e., the following
-.B groff
-devices work,
-.BR \-Tps ,
-.BR \-Tdvi ,
-.BR \-Thtml ,
-and
-.BR \-Txhtml .
-.
-.
-.P
-I'm not sure about the
-.B ldp
+The
+.B lbp
 and
 .B lj4
-devices.
+devices are untested.
 .
-.
-.P
-In
-.BR groffer ,
-it is easier to use the following device options, either
-.
-.BR \-\-ps ,
-.BR \-\-div ,
-.BR \-\-html ,
-or
-.BR \-\-xhtml .
-.
-.
-.P
-Unfortunately, the
-.B groff
-option
-.B \-Tpdf
-does not work and the
-.B groffer
-default
-.I PDF
-works neither.
-.
-.
-.P
-But
-.B groffer
-has an additional
-.IR "pdf mode" ,
-not available in
-.BR groff .
-.
-It is based on the
-.I ps mode
-in
-.B groff
-and is called through
-.B groffer \-\-pdf2
-.IR roff-file-with-lilypond .
+Unfortunately,
+the
+.B pdf
+device does not yet work.
 .
 .
 .\" ====================================================================
-.SH "OPTION OVERVIEW"
+.SH "Option overview"
 .\" ====================================================================
 .
-.\" ====================================================================
-.SS "Breaking Options"
-.\" ====================================================================
 .
-.nh
-.nf
 .TP
 .BR \-? | \-h | \-\-help | \-\-usage
-Print help or usage information, then leave the program.
+Display usage information and exit.
 .
 .TP
 .B \-\-version
-Print version information.
+Display version information and exit.
 .
 .TP
 .BR \-l | \-\-license
-Print license information.
-.fi
-.hy
+Display copyright license information and exit.
 .
 .
 .\" ====================================================================
-.SS "Options for building EPS Files"
+.SS "Options for building EPS files"
 .\" ====================================================================
 .
 .TP
-.OP \-\-ly2eps
-Here the
-.B lilypond
-program creates
-.I eps
-files directly.
+.B \-\-ly2eps
+Direct
+.MR lilypond 1
+to create Encapsulated PostScript (EPS) files.
 .
 This is the default.
 .
 .
 .TP
-.OP \-\-pdf2eps
+.B \-\-pdf2eps
 The program
-.B glilypond
-generates a
-.I PDF
-file using
-.BR lilypond .
+.I glilypond
+generates a PDF file using
+.IR lilypond .
 .
-Then the
-.I eps
-file is generated by
-.B pdf2ps
+Then the EPS file is generated by
+.I pdf2ps
 and
-.BR ps2eps R .
+.IR ps2eps .
 .
 .
 .\" ====================================================================
-.SS "Directories and Files"
+.SS "Directories and files"
 .\" ====================================================================
 .
 .TP
@@ -262,7 +215,9 @@
 .I EPS
 files are sent to the temporary directory.
 .
-With this option, you can generate your own directory, in which all useful
+With this option,
+you can generate your own directory,
+in which all useful
 .I EPS
 files are send.
 .
@@ -272,7 +227,7 @@
 .TP
 .BR \-p | \-\-prefix "\fI begin_of_name\fP"
 Normally all temporary files get names that start with the
-.BI ly \*(EL
+.BI ly .\|.\|.\&
 prefix.
 .
 With this option, you can freely change this prefix.
@@ -285,7 +240,7 @@
 files are deleted.
 .
 With this option, all generated files either by the
-.B lilypond
+.I lilypond
 program or other format transposers are kept.
 .
 .
@@ -305,7 +260,7 @@
 .
 .
 .\" ====================================================================
-.SS "Output"
+.SS Output
 .\" ====================================================================
 .
 .TP
@@ -326,7 +281,7 @@
 .
 .
 .\" ====================================================================
-.SS "Short Option Collections"
+.SS "Short option collections"
 .\" ====================================================================
 .
 The argument handling of options
@@ -381,7 +336,7 @@
 .
 .
 .\" ====================================================================
-.SS "Handling of Long Options"
+.SS "Handling of long options"
 .\" ====================================================================
 .
 Arguments that start with a double dash
@@ -476,62 +431,14 @@
 .BR \-\-KeE .
 .
 .
+.br
+.ne 6v
 .\" ====================================================================
-.SH FILESPEC ARGUMENTS
-.\" ====================================================================
-.
-An argument that is not an option or an option argument is called a
-.I filespec
-argument.
-.
-.
-.P
-Without any
-.I filespec
-argument,
-.I "standard input"
-is read.
-.
-.
-.P
-Each
-.I filespec
-argument must either be the name of a readable file or a dash
-.B \-
-for
-.IR "standard input" .
-.
-Each input must be written in the
-.I roff
-or
-.I groff
-language and can include
-.I lilypond
-parts.
-.
-.
-.P
-Normally arguments starting with a dash
-.B \-
-are interpreted as an option.
-.
-But if you use an argument that consists only of a doubled dash
-.B \-\- R ,
-all following arguments are taken as
-.I filespec
-argument, even if such an argument starts with a dash.
-.
-This is handled according to the
-.I GNU
-standard.
-.
-.
-.\" ====================================================================
-.SH "THE LILYPOND PARTS IN ROFF INPUT"
+.SH "LilyPond regions in \fIroff\f input"
 .\" ====================================================================
 .
 .\" ====================================================================
-.SS "Integrated Lilypond Codes"
+.SS "Integrated LilyPond code"
 .\" ====================================================================
 .
 A
@@ -551,8 +458,6 @@
 .EE
 .RE
 .
-.
-.P
 A
 .I groff
 input can have several of these
@@ -587,7 +492,7 @@
 .
 .
 .\" ====================================================================
-.SS "Inclusion of ly-Files"
+.SS "Inclusion of \fI.ly\f files"
 .\" ====================================================================
 .
 An additional command line for file inclusion of
@@ -640,7 +545,7 @@
 .
 .
 .\" ====================================================================
-.SH "GENERATED FILES"
+.SH "Generated files"
 .\" ====================================================================
 .
 By the transformation process of
@@ -658,7 +563,7 @@
 .
 .
 .\" ====================================================================
-.SS "Command Line Options for Directories"
+.SS "Command-line options for directories"
 .\" ====================================================================
 .
 The temporary directory for this program is either created
@@ -685,9 +590,10 @@
 .
 .P
 The beginning of the names of the temporary files can be set by the
-command-line option
-.OP \-p | \-\-prefix
-.IR begin_of_name .
+command-line options
+.B \-p
+or
+.BR \-\-prefix .
 .
 .
 .P
@@ -695,8 +601,10 @@
 .I EPS
 files are deleted finally.
 .
-This can be changed by setting the command-line option
-.OP \-k | \-\-keep_files .
+This can be changed by setting the command-line options
+.B \-k
+or
+.BR \-\-keep_files .
 .
 With this, all temporary files and directories are kept, not deleted.
 .
@@ -713,7 +621,7 @@
 .
 .
 .\" ====================================================================
-.SH "TRANSFORMATION PROCESSES FOR GENERATING EPS FILES"
+.SH "Transformation processes for generating EPS files"
 .\" ====================================================================
 .
 .\" ====================================================================
@@ -728,7 +636,7 @@
 In this mode, the
 .B .ly
 files are transformed by the
-.BR lilypond (1)
+.MR lilypond 1
 program into
 .I PDF
 files, using
@@ -759,11 +667,14 @@
 file.
 .
 This is done by the
-.BR pdf2ps (1)
+.MR pdf2ps 1
 program using
 .RS
 .EX
-\fR$ \fP \fBpdf2ps\fP \fIfile-name\fP \fB.pdf\fP \fIfile-name\fP \fB.ps\fP
+$\~\c
+.B pdf2ps\~\c
+.IB file-name .pdf\~\c
+.IB file-name .pds
 .EE
 .RE
 .
@@ -775,7 +686,7 @@
 file.
 .
 This is done by the
-.BR ps2eps (1)
+.MR ps2eps 1
 program using
 .RS
 .EX
@@ -814,10 +725,10 @@
 In earlier time, this mode was the default.
 .
 But now it does not work any more, so accept the new default
-.BR pdf2eps .
+.IR pdf2eps .
 .
 For testing, this mode can also be chosen by the
-.B glilypond
+.I glilypond
 option
 .BR \-\-ly2eps .
 .
@@ -826,13 +737,15 @@
 In this mode, the
 .B .ly
 files are transformed by the
-.B lilypond
+.I lilypond
 program into many files of different formats, including
 .I eps
 files, using
 .RS
 .EX
-.BI "$ lilypond \-\-ps \-dbackend=eps \-dgs\-load\-fonts \-\-output=" file\-name
+$\~\c
+.B lilypond \-\-ps \-dbackend=eps \-dgs\-load\-fonts \-\-output=\c
+.I file-name
 .EE
 .RE
 for each
@@ -878,21 +791,19 @@
 .
 .
 .\" ====================================================================
-.SH "THE GENERATED NEW ROFF STRUCTURE"
+.SH "Generated \fIgroff\f output"
 .\" ====================================================================
 .
 The new
-.BR groff (@MAN7EXT@)
+.MR groff @MAN7EXT@
 structure generated by
-.B glilypond
+.I glilypond
 is either
 .
 .TP
 1)
 sent to standard output and can there be saved into a file or piped into
-.BR groff (@MAN1EXT@)
-or
-.BR groffer (@MAN1EXT@)
+.MR groff @MAN1EXT@
 or
 .
 .TP
@@ -903,21 +814,22 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-.B glilypond
+.
+.I glilypond
 was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .TP
-.BR groff (@MAN1EXT@)
+.MR groff @MAN1EXT@
 describes the usage of the
 .I groff
 command and contains pointers to further documentation of the
@@ -926,21 +838,21 @@
 .
 .
 .TP
-.BR groff_tmac (@MAN5EXT@)
+.MR groff_tmac @MAN5EXT@
 describes the
 .B .PSPIC
 request.
 .
 .
 .TP
-.BR lilypond (1)
+.MR lilypond 1
 briefly describes the
-.B lilypond
+.I lilypond
 command and contains pointers to further documentation.
 .
 .
 .TP
-.BR pdf2ps (1)
+.MR pdf2ps 1
 transforms a
 .I PDF
 file into a
@@ -949,7 +861,7 @@
 .
 .
 .TP
-.BR ps2eps (1)
+.MR ps2eps 1
 transforms a
 .I PS
 file into an
@@ -957,11 +869,13 @@
 format.
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_glilypond_1_man_C
+.do rr *groff_glilypond_1_man_C
+.
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/glilypond.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/glilypond.am Changed

@@ -1,14 +1,10 @@
 # Automake rules for 'glilypond'
 
-# File position: <groff-source>/contrib/lilypond/glilypond.am
-
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
+# Copyright (C) 2013-2020 Free Software Foundation, Inc.
 # Written by Werner Lemberg <wl@gnu.org> and
 # Bernd Warken <groff-bernd.warken-72@web.de>.
 # Automake migration by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'glilypond' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -32,10 +28,6 @@
 # files going to lib directory '$(glilypond_dir)'
 # TODO glilypond_dir is subsitued by configure.ac, check if this could be removed
 glilyponddir = $(glilypond_dir)
-dist_glilypond_DATA = \
-  contrib/glilypond/subs.pl \
-  contrib/glilypond/oop_fh.pl \
-  contrib/glilypond/args.pl
 
 EXTRA_DIST += \
   contrib/glilypond/ChangeLog \
@@ -47,7 +39,7 @@
 
 
 # create perl executable 'glilypond', being stored into 'bindir'
-glilypond: $(glilypond_srcdir)/glilypond.pl shdeps.sed
+glilypond: $(glilypond_srcdir)/glilypond.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)$(RM) $@ \
 	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	       -e "s|@g@|$(g)|g" \
@@ -65,12 +57,8 @@
 	fi
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/glilypond/glilypond.pl -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/glilypond/glilypond.pl Changed

@@ -24,25 +24,20 @@
 our $Legalese;
 
 {
-  use constant VERSION => 'v1.3.1'; # version of glilypond
+  use constant VERSION => '1.3.2'; # version of glilypond
 
-### This constant 'LICENSE' is the license for this file 'GPL' >= 2
+### This constant 'LICENSE' is the license for this file 'GPL' >= 3
   use constant LICENSE => q*
 glilypond - integrate 'lilypond' into 'groff' files
 
-Source file position: '<groff-source>/contrib/glilypond/glilypond.pl'
-Installed position: '<prefix>/bin/glilypond'
-
-Copyright (C) 2013-2018 Free Software Foundation, Inc.
+Copyright (C) 2013-2020 Free Software Foundation, Inc.
   Written by Bernd Warken <groff-bernd.warken-72@web.de>
 
-Last update: 10 Sep 2015
-
 This file is part of 'GNU groff'.
 
   '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
+'Free Software Foundation', either version 3 of the License, or (at your
 option) any later version.
 
   'GNU groff' is distributed in the hope that it will be useful, but
@@ -139,7 +134,424 @@
     umask 0077; # octal output: 'printf "%03o", umask;'
   }
 
-  require 'subs.pl';
+  use integer;
+  use utf8;
+  use feature 'state';
+
+  my $P_PIC;
+  # $P_PIC = '.PDFPIC';
+  $P_PIC = '.PSPIC';
+
+  ######################################################################
+  # subs for using several times
+  ######################################################################
+
+  sub create_ly2eps {		       # '--ly2eps' default
+    our ( $out, $Read, $Temp );
+
+    my $prefix = $Read->{'file_numbered'};   # w/ dir change to temp dir
+
+    # '$ lilypond --ps -dbackend=eps -dgs-load-fonts \
+    #      output=file_without_extension file.ly'
+    # extensions are added automatically
+    my $opts = '--ps -dbackend=eps -dinclude-eps-fonts -dgs-load-fonts'
+      . " --output=$prefix $prefix";
+    &run_lilypond("$opts");
+
+    Cwd::chdir $Temp->{'cwd'} or
+	die "Could not change to former directory '" .
+	  $Temp->{'cwd'} . "': $!";
+
+    my $eps_dir = $Temp->{'eps_dir'};
+    my $dir = $Temp->{'temp_dir'};
+    opendir( my $dh, $dir ) or
+      die "could not open temporary directory '$dir': $!";
+
+    my $re = qr<
+		 ^
+		 $prefix
+		 -
+		 .*
+		 \.eps
+		 $
+	       >x;
+    my $file;
+    while ( readdir( $dh ) ) {
+      chomp;
+      $file = $_;
+      if ( /$re/ ) {
+	my $file_path = File::Spec->catfile($dir, $file);
+	if ( $eps_dir ) {
+	  my $could_copy = FALSE;
+	  File::Copy::copy($file_path, $eps_dir)
+	      and $could_copy = TRUE;
+	  if ( $could_copy ) {
+	    unlink $file_path;
+	    $file_path = File::Spec->catfile($eps_dir, $_);
+	  }
+	}
+	$out->print( $P_PIC . ' ' . $file_path );
+      }
+    }				# end while readdir
+    closedir( $dh );
+  }				# end sub create_ly2eps()
+
+
+  sub create_pdf2eps {		       # '--pdf2eps'
+    our ( $v, $stdout, $stderr, $out, $Read, $Temp );
+
+    my $prefix = $Read->{'file_numbered'};   # w/ dir change to temp dir
+
+    &run_lilypond("--pdf --output=$prefix $prefix");
+
+    my $file_pdf = $prefix . '.pdf';
+    my $file_ps = $prefix . '.ps';
+
+    # pdf2ps in temp dir
+    my $temp_file = &next_temp_file;
+    $v->print( "\n##### run of 'pdf2ps'" );
+    # '$ pdf2ps file.pdf file.ps'
+    my $output = `pdf2ps $file_pdf $file_ps 2> $temp_file`;
+    die 'Program pdf2ps does not work.' if ( $? );
+    &shell_handling($output, $temp_file);
+    $v->print( "##### end run of 'pdf2ps'\n" );
+
+    # ps2eps in temp dir
+    $temp_file = &next_temp_file;
+    $v->print( "\n##### run of 'ps2eps'" );
+    # '$ ps2eps file.ps'
+    $output = `ps2eps $file_ps 2> $temp_file`;
+    die 'Program ps2eps does not work.' if ( $? );
+    &shell_handling($output, $temp_file);
+    $v->print( "##### end run of 'ps2eps'\n" );
+
+    # change back to former dir
+    Cwd::chdir $Temp->{'cwd'} or
+	die "Could not change to former directory '" .
+	  $Temp->{'cwd'} . "': $!";
+
+    # handling of .eps file
+    my $file_eps = $prefix . '.eps';
+    my $eps_path = File::Spec->catfile($Temp->{'temp_dir'}, $file_eps);
+    if ( $Temp->{'eps_dir'} ) {
+      my $has_copied = FALSE;
+      File::Copy::copy( $eps_path, $Temp->{'eps_dir'} )
+	  and $has_copied = TRUE;
+      if ( $has_copied ) {
+	unlink $eps_path;
+	$eps_path = File::Spec->catfile( $Temp->{'eps_dir'}, $file_eps );
+      } else {
+	$stderr->print( "Could not use EPS-directory." );
+      } # end Temp->{'eps_dir'}
+    }
+    # print into groff output
+    $out->print( $P_PIC . ' ' . $eps_path );
+  }				# end sub create_pdf2eps()
+
+
+  sub is_subdir {		# arg1 is subdir of arg2 (is longer)
+    my ( $dir1, $dir2 ) = @_;
+    $dir1 = &path2abs( $dir1 );;
+    $dir2 = &path2abs( $dir2 );;
+    my @split1 = File::Spec->splitdir($dir1);
+    my @split2 = File::Spec->splitdir($dir2);
+    for ( @split2 ) {
+      next if ( $_ eq shift @split1 );
+      return FALSE;
+    }
+    return TRUE;
+  }
+
+
+  sub license {
+    our ( $Legalese, $stdout );
+    &version;
+    $stdout->print( $Legalese->{'license'} );
+  } # end sub license()
+
+
+  sub make_dir {		# make directory or check if it exists
+    our ( $v, $Args );
+
+    my $dir_arg = shift;
+    chomp $dir_arg;
+    $dir_arg =~ s/^\s*(.*)\s*$/$1/;
+
+    unless ( $dir_arg ) {
+      $v->print( "make_dir(): empty argument" );
+      return FALSE;
+    }
+
+    unless ( File::Spec->file_name_is_absolute($dir_arg) ) {
+      my $res = Cwd::realpath($dir_arg);
+      $res = File::Spec->canonpath($dir_arg) unless ( $res );
+      $dir_arg = $res if ( $res );
+    }
+
+    return $dir_arg if ( -d $dir_arg && -w $dir_arg );
+
+
+    # search thru the dir parts
+    my @dir_parts = File::Spec->splitdir($dir_arg);
+    my @dir_grow;
+    my $dir_grow;
+    my $can_create = FALSE;	# dir could be created if TRUE
+
+   DIRPARTS: for ( @dir_parts ) {
+      push @dir_grow, $_;
+      next DIRPARTS unless ( $_ ); # empty string for root directory
+
+      # from array to path dir string
+      $dir_grow = File::Spec->catdir(@dir_grow);
+
+      next DIRPARTS if ( -d $dir_grow );
+
+      if ( -e $dir_grow ) {  # exists, but not a dir, so must be removed
+	die "Couldn't create dir '$dir_arg', it is blocked by "
+	  . "'$dir_grow'." unless ( -w $dir_grow );
+
+	# now it's writable, but not a dir, so it can be removed
+	unlink ( $dir_grow ) or
+	  die "Couldn't remove '$dir_grow', " .
+	    "so I cannot create dir '$dir_arg': $!";
+      }
+
+      # $dir_grow no longer exists, so the former dir must be writable
+      # in order to create the directory
+      pop @dir_grow;
+      $dir_grow = File::Spec->catdir(@dir_grow);
+
+      die "'$dir_grow' is not writable, " .
+	"so directory '$dir_arg' can't be created."
+	  unless ( -w $dir_grow );
+
+      # former directory is writable, so '$dir_arg' can be created
+
+      File::Path::make_path( $dir_arg,
+			     {
+			      mask => oct('0700'),
+			      verbose => $Args->{'verbose'},
+			     }
+			   )	#  'mkdir -P'
+	  or die "Could not create directory '$dir_arg': $!";
+
+      last DIRPARTS;
+    }
+
+    die "'$dir_arg' is not a writable directory"
+      unless ( -d $dir_arg && -w $dir_arg );
+
+    return $dir_arg;
+
+  } # end sub make_dir()
+
+
+  my $number = 0;
+  sub next_temp_file {
+    our ( $Temp, $v, $Args );
+    ++$number;
+    my $temp_basename = $Args->{'prefix'} . '_temp_' . $number;
+    my $temp_file = File::Spec->catfile( $Temp->{'temp_dir'} ,
+					 $temp_basename );
+    $v->print( "next temporary file: '$temp_file'" );
+    return $temp_file;
+  }				# end sub next_temp_file()
+
+
+  sub path2abs {
+    our ( $Temp, $Args );
+
+    my $path = shift;
+    $path =~ s/
+		^
+		\s*
+		(
+		  .*
+		)
+		\s*
+		$
+	      /$1/x;
+
+    die "path2abs(): argument is empty." unless ( $path );
+
+    # Perl does not support shell '~' for home dir
+    if ( $path =~ /
+		    ^
+		    ~
+		  /x ) {
+      if ( $path eq '~' ) {	# only own home
+	$path = File::HomeDir->my_home;
+      } elsif ( $path =~ m<
+			    ^
+			    ~ /
+			    (
+			      .*
+			    )
+			    $
+			  >x ) {	# subdir of own home
+	$path = File::Spec->catdir( $Temp->{'cwd'}, $1 );
+      } elsif ( $path =~ m<
+			    ^
+			    ~
+			    (
+			      ^/+
+			    )
+			    $
+			  >x ) {	# home of other user
+	$path = File::HomeDir->users_home($1);
+      } elsif ( $path =~ m<
+			    ^
+			    ~
+			    (
+			      ^/+
+			    )
+			    /+
+			    (
+			      .*
+			    )
+			    $
+			  >x ) {	# subdir of other home
+	$path = File::Spec->
+	  catdir( File::HomeDir->users_home($1), $2 );
+      }
+    }
+
+    $path = File::Spec->rel2abs($path);
+
+    # now $path is absolute
+    return $path;
+  } # end sub path2abs()
+
+
+  sub run_lilypond {
+    # arg is the options collection for 'lilypond' to run
+    # either from ly or pdf
+
+    our ( $Temp, $v );
+
+    my $opts = shift;
+    chomp $opts;
+
+    my $temp_file = &next_temp_file;
+    my $output = EMPTYSTRING;
+
+    # change to temp dir
+    Cwd::chdir $Temp->{'temp_dir'} or
+	die "Could not change to temporary directory '" .
+	  $Temp->{'temp_dir'} . "': $!";
+
+    $v->print( "\n##### run of 'lilypond " . $opts . "'" );
+    $output = `lilypond $opts 2>$temp_file`;
+    die "Program lilypond does not work, see '$temp_file': $?"
+      if ( $? );
+    chomp $output;
+    &shell_handling($output, $temp_file);
+    $v->print( "##### end run of 'lilypond'\n" );
+
+    # stay in temp dir
+  } # end sub run_lilypond()
+
+
+  sub shell_handling {
+    # Handle ``-shell-command output in a string (arg1).
+    # stderr goes to temporary file $TempFile.
+
+    our ( $out, $v, $Args );
+
+    my $out_string = shift;
+    my $temp_file = shift;
+
+    my $a = &string2array($out_string); # array ref
+    for ( @$a ) {
+      $out->print( $_ );
+    }
+
+    $temp_file && -f $temp_file && -r $temp_file ||
+      die "shell_handling(): $temp_file is not a readable file.";
+    my $temp = new FH_READ_FILE($temp_file);
+    my $res = $temp->read_all();
+    for ( @$res ) {
+      chomp;
+      $v->print($_);
+    }
+
+    unlink $temp_file unless ( $Args->{'keep_all'} );
+  } # end sub shell_handling()
+
+
+  sub string2array {
+    my $s = shift;
+    my @a = ();
+    for ( split "\n", $s ) {
+      chomp;
+      push @a, $_;
+    }
+    return \@a;
+  } # end string2array()
+
+
+  sub usage {			# for '--help'
+    our ( $Globals, $Args );
+
+    my $p = $Globals->{'prog'};
+    my $usage = EMPTYSTRING;
+    $usage = '###### usage:' . "\n" if ( $Args->{'verbose'} );
+    $usage .= qq*Options for $p:
+Read a 'roff' file or standard input and transform 'lilypond' parts
+(everything between '.lilypond start' and '.lilypond end') into
+'EPS'-files that can be read by groff using '.PSPIC'.
+
+There is also a command '.lilypond include <file_name>' that can
+include a complete 'lilypond' file into the 'groff' document.
+
+
+# Breaking options:
+$p -?|-h|--help|--usage    # usage
+$p --version               # version information
+$p --license               # the license is GPL >= 3
+
+
+# Normal options:
+$p options -- filename ...
+
+There are 2 options for influencing the way how the 'EPS' files for the
+'roff' display are generated:
+--ly2eps           'lilypond' generates 'EPS' files directly (default)
+--pdf2eps          'lilypond' generates a 'PDF' file that is transformed
+
+-k|--keep_all      do not delete any temporary files
+-v|--verbose       print much information to STDERR
+
+Options with an argument:
+-e|--eps_dir=...   use a directory for the EPS files
+-o|--output=...    sent output in the groff language into file ...
+-p|--prefix=...    start for the names of temporary files
+-t|--temp_dir=...  provide the directory for temporary files.
+
+The directories set are created when they do not exist.
+*;
+
+    # old options:
+    # --keep_files       -k: do not delete any temporary files
+    # --file_prefix=...  -p: start for the names of temporary files
+
+    $main::stdout->print( $usage );
+  } # end sub usage()
+
+
+  sub version { # for '--version'
+    our ( $Globals, $Legalese, $stdout, $Args );
+    my $groff_version = '';
+    if ( $Globals->{'groff_version'} ) {
+      $groff_version = "(groff $Globals->{'groff_version'}) ";
+    }
+
+    my $output = EMPTYSTRING;
+    $output = "$Globals->{'prog'} ${groff_version}version "
+      .  $Legalese->{'version'};
+
+    $stdout->print($output);
+  } # end sub version()
 }
 
 #die "test: ";
@@ -147,12 +559,274 @@
 # OOP declarations for some file handles
 ########################################################################
 
-require 'oop_fh.pl';
+use integer;
+
+########################################################################
+# OOP for writing file handles that are open by default, like STD*
+########################################################################
+
+# -------------------------- _FH_WRITE_OPENED --------------------------
+
+{	# FH_OPENED: base class for all opened file handles, like $TD*
+
+  package _FH_WRITE_OPENED;
+  use strict;
+
+  sub new {
+    my ( $pkg, $std ) = @_;
+    bless {
+	   'fh' => $std,
+	  }
+  }
+
+  sub open {
+  }
+
+  sub close {
+  }
+
+  sub print {
+    my $self = shift;
+    for ( @_ ) {
+      print { $self->{'fh'} } $_;
+    }
+  }
+
+}
+
+
+# ------------------------------ FH_STDOUT ----------------------------
+
+{			     # FH_STDOUT: print to normal output STDOUT
+
+  package FH_STDOUT;
+  use strict;
+  @FH_STDOUT::ISA = qw( _FH_WRITE_OPENED );
+
+  sub new {
+    &_FH_WRITE_OPENED::new( '_FH_WRITE_OPENED', *STDOUT );
+  }
+
+}				# end FH_STDOUT
+
+
+# ------------------------------ FH_STDERR -----------------------------
+
+{				# FH_STDERR: print to STDERR
+
+  package FH_STDERR;
+  use strict;
+  @FH_STDERR::ISA = qw( _FH_WRITE_OPENED );
+
+  sub new {
+    &_FH_WRITE_OPENED::new( 'FH_OPENED', *STDERR );
+  }
+
+}				# end FH_STDERR
+
+
+########################################################################
+# OOP for file handles that write into a file or string
+########################################################################
+
+# ------------------------------- FH_FILE ------------------------------
+
+{	       # FH_FILE: base class for writing into a file or string
+
+  package FH_FILE;
+  use strict;
+
+  sub new {
+    my ( $pkg, $file ) = @_;
+    bless {
+	   'fh' => undef,
+	   'file' => $file,
+	   'opened' => main::FALSE,
+	  }
+  }
+
+  sub DESTROY {
+    my $self = shift;
+    $self->close();
+  }
+
+  sub open {
+    my $self = shift;
+    my $file = $self->{'file'};
+    if ( $file && -e $file ) {
+      die "file $file is not writable" unless ( -w $file );
+      die "$file is a directory" if ( -d $file );
+    }
+    open $self->{'fh'}, ">", $self->{'file'}
+      or die "could not open file '$file' for writing: $!";
+    $self->{'opened'} = main::TRUE;
+  }
+
+  sub close {
+    my $self = shift;
+    close $self->{'fh'} if ( $self->{'opened'} );
+    $self->{'opened'} = main::FALSE;
+  }
+
+  sub print {
+    my $self = shift;
+    $self->open() unless ( $self->{'opened'} );
+    for ( @_ ) {
+      print { $self->{'fh'} } $_;
+    }
+  }
+
+}				# end FH_FILE
+
+
+# ------------------------------ FH_STRING -----------------------------
+
+{				# FH_STRING: write into a string
+
+  package FH_STRING;		# write to \string
+  use strict;
+  @FH_STRING::ISA = qw( FH_FILE );
+
+  sub new {
+    my $pkg = shift;		# string is a reference to scalar
+    bless
+      {
+       'fh' => undef,
+       'string' => '',
+       'opened' => main::FALSE,
+      }
+    }
+
+  sub open {
+    my $self = shift;
+    open $self->{'fh'}, ">", \ $self->{'string'}
+      or die "could not open string for writing: $!";
+    $self->{'opened'} = main::TRUE;
+  }
+
+  sub get { # get string, move to array ref, close, and return array ref
+    my $self = shift;
+    return '' unless ( $self->{'opened'} );
+    my $a = &string2array( $self->{'string'} );
+    $self->close();
+    return $a;
+  }
+
+}				# end FH_STRING
+
+
+# -------------------------------- FH_NULL -----------------------------
+
+{				# FH_NULL: write to null device
+
+  package FH_NULL;
+  use strict;
+  @FH_NULL::ISA = qw( FH_FILE FH_STRING );
+
+  use File::Spec;
+
+  my $devnull = File::Spec->devnull();
+  $devnull = '' unless ( -e $devnull && -w $devnull );
+
+  sub new {
+    my $pkg = shift;
+    if ( $devnull ) {
+      &FH_FILE::new( $pkg, $devnull );
+    } else {
+      &FH_STRING::new( $pkg );
+    }
+  } # end new()
+
+}				# end FH_NULL
+
+
+########################################################################
+# OOP for reading file handles
+########################################################################
+
+# ---------------------------- FH_READ_FILE ----------------------------
+
+{ # FH_READ_FILE: read a file
+
+  package FH_READ_FILE;
+  use strict;
+
+  sub new {
+    my ( $pkg, $file ) = @_;
+    die "File '$file' cannot be read." unless ( -f $file && -r $file );
+    bless {
+	   'fh' => undef,
+	   'file' => $file,
+	   'opened' => main::FALSE,
+	  }
+  }
+
+  sub DESTROY {
+    my $self = shift;
+    $self->close();
+  }
+
+  sub open {
+    my $self = shift;
+    my $file = $self->{'file'};
+    if ( $file && -e $file ) {
+      die "file $file is not writable" unless ( -r $file );
+      die "$file is a directory" if ( -d $file );
+    }
+    open $self->{'fh'}, "<", $self->{'file'}
+      or die "could not read file '$file': $!";
+    $self->{'opened'} = main::TRUE;
+  }
+
+  sub close {
+    my $self = shift;
+    close $self->{'fh'} if ( $self->{'opened'} );
+    $self->{'opened'} = main::FALSE;
+  }
+
+  sub read_line {
+    # Read 1 line of the file into a chomped string.
+    # Do not close the read handle at the end.
+    my $self = shift;
+    $self->open() unless ( $self->{'opened'} );
+
+    my $res;
+    if ( defined($res = CORE::readline($self->{'fh'}) ) ) {
+      chomp $res;
+      return $res;
+    } else {
+      $self->close();
+      return undef;
+    }
+  }
+
+  sub read_all {
+    # Read the complete file into an array reference.
+    # Close the read handle at the end.
+    # Return array reference.
+    my $self = shift;
+    $self->open() unless ( $self->{'opened'} );
+
+    my $res = ;
+    my $line;
+    while ( defined ( $line = CORE::readline $self->{'fh'} ) ) {
+      chomp $line;
+      push @$res, $line;
+    }
+    $self->close();
+    $self->{'opened'} = main::FALSE;
+    return $res;
+  }
+
+}
+
+# end of OOP definitions
+
 
 our $stdout = new FH_STDOUT();
 our $stderr = new FH_STDERR();
 
-# verbose printing, not clear wether this will be set by '--verbose',
+# verbose printing, not clear whether this will be set by '--verbose',
 # so store this now into a string, which can be gotten later on, when
 # it will become either STDERR or /dev/null
 our $v = new FH_STRING();
@@ -199,7 +873,468 @@
   };
 
 { # 'Args'
-  require 'args.pl';
+  use integer;
+
+  our ( $Globals, $Args, $stderr, $v, $out );
+
+  # ----------
+  # subs for second run, for remaining long options after splitting and
+  # transfer
+  # ----------
+
+  my %opts_with_arg =
+    (
+
+     '--eps_dir' => sub {
+       $Args->{'eps_dir'} = shift;
+     },
+
+     '--output' => sub {
+       $Args->{'output'} = shift;
+     },
+
+     '--prefix' => sub {
+       $Args->{'prefix'} = shift;
+     },
+
+     '--temp_dir' => sub {
+       $Args->{'temp_dir'} = shift;
+     },
+
+    );				# end of %opts_with_arg
+
+
+  my %opts_noarg =
+    (
+
+     '--help' => sub {
+       &usage;
+       exit;
+     },
+
+     '--keep_all' => sub {
+       $Args->{'keep_all'} = TRUE;
+     },
+
+     '--license' => sub {
+       &license;
+       exit;
+     },
+
+     '--ly2eps' => sub {
+       $Args->{'eps_func'} = 'ly';
+     },
+
+     '--pdf2eps' => sub {
+       $Args->{'eps_func'} = 'pdf';
+     },
+
+     '--verbose' => sub {
+       $Args->{'verbose'} = TRUE;
+     },
+
+     '--version' => sub {
+       &version;
+       exit;
+     },
+
+    );				# end of %opts_noarg
+
+
+  # used variables in both runs
+
+  my @files = EMPTYARRAY;
+
+
+  #----------
+  # first run for command-line arguments
+  #----------
+
+  # global variables for first run
+
+  my @splitted_args;
+  my $double_minus = FALSE;
+  my $arg = EMPTYSTRING;
+  my $has_arg = FALSE;
+
+
+  # Split short option collections and transfer these to suitable long
+  # options from above.  Note that '-v' now means '--verbose' in version
+  # 'v1.1', earlier versions had '--version' for '-v'.
+
+  my %short_opts =
+    (
+     '?' => '--help',
+     'e' => '--eps_dir',
+     'h' => '--help',
+     'l' => '--license',
+     'k' => '--keep_all',
+     'o' => '--output',
+     'p' => '--prefix',
+     't' => '--temp_dir',
+     'v' => '--verbose',
+     'V' => '--verbose',
+    );
+
+
+  # transfer long option abbreviations to the long options from above
+
+  my @long_opts;
+
+  $long_opts3 =
+    {				# option abbreviations of 3 characters
+     '--e' => '--eps_dir',
+     '--f' => '--prefix',		# --f for --file_prefix
+     '--h' => '--help',
+     '--k' => '--keep_all',	# and --keep_files
+     '--o' => '--output',
+     '--p' => '--prefix',		# and --file_prefix
+     '--t' => '--temp_dir',
+     '--u' => '--help',		# '--usage' is mapped to '--help'
+    };
+
+  $long_opts4 =
+    {				# option abbreviations of 4 characters
+     '--li' => '--license',
+     '--ly' => '--ly2eps',
+     '--pd' => '--pdf2eps',
+     '--pr' => '--prefix',
+    };
+
+  $long_opts6 =
+    {				# option abbreviations of 6 characters
+     '--verb' => '--verbose',
+     '--vers' => '--version',
+    };
+
+
+  # subs for short splitting and replacing long abbreviations
+
+  my $split_short = sub {
+
+    my @chars = split //, $1;	# omit leading dash
+
+       # if result is TRUE: run 'next SPLIT' afterwards
+
+     CHARS: while ( @chars ) {
+	 my $c = shift @chars;
+
+	 unless ( exists $short_opts{$c} ) {
+	   $stderr->print( "Unknown short option '-$c'." );
+	   next CHARS;
+	 }
+
+	 # short option exists
+
+	 # map or transfer to special long option from above
+	 my $transopt = $short_opts{$c};
+
+	 if ( exists $opts_noarg{$transopt} ) {
+	   push @splitted_args, $transopt;
+	   $Args->{'verbose'}  = TRUE if ( $transopt eq '--verbose' );
+	   next CHARS;
+	 }
+
+	 if ( exists $opts_with_arg{$transopt} ) {
+	   push @splitted_args, $transopt;
+
+	   if ( @chars ) {
+	     # if @chars is not empty, option $transopt has argument
+	     # in this arg, the rest of characters in @chars
+	     push @splitted_args, join "", @chars;
+	     @chars = EMPTYARRAY;
+	     return TRUE;		# use 'next SPLIT' afterwards
+	   }
+
+	   # optarg is the next argument
+	   $has_arg = $transopt;
+	   return TRUE;		# use 'next SPLIT' afterwards
+	 }			# end of if %opts_with_arg
+       }				# end of while CHARS
+       return FALSE;		# do not do anything
+  };				# end of sub for short_opt_collection
+
+
+  my $split_long = sub {
+    my $from_arg = shift;
+    $from_arg =~ /^(^=+)/;
+    my $opt_part = lc($1);
+    my $optarg = undef;
+    if ( $from_arg =~ /=(.*)$/ ) {
+      $optarg = $1;
+    }
+
+   N: for my $n ( qw/6 4 3/ ) {
+      $opt_part =~ / # match $n characters
+		     ^
+		     (
+		       .{$n}
+		     )
+		   /x;
+      my $argn = $1;		# get the first $n characters
+
+      # no match, so luck for fewer number of chars
+      next N unless ( $argn );
+
+      next N unless ( exists $long_opts$n->{$argn} );
+      # not in $n hash, so go on to next loop for $n
+
+      # now $n-hash has arg
+
+      # map or transfer to special long opt from above
+      my $transopt = $long_opts$n->{$argn};
+
+      # test on option without arg
+      if ( exists $opts_noarg{$transopt} ) { # opt has no arg
+	$stderr->print( 'Option ' . $transopt . 'has no argument: ' .
+			$from_arg . '.' ) if ( defined($optarg) );
+	push @splitted_args, $transopt;
+	$Args->{'verbose'} = TRUE if ( $transopt eq '--verbose' );
+	return TRUE;		# use 'next SPLIT' afterwards
+      }				# end of if %opts_noarg
+
+      # test on option with arg
+      if ( exists $opts_with_arg{$transopt} ) { # opt has arg
+	push @splitted_args, $transopt;
+
+	# test on optarg in arg
+	if ( defined($optarg) ) {
+	  push @splitted_args, $1;
+	  return TRUE; # use 'next SPLIT' afterwards
+	} # end of if optarg in arg
+
+	# has optarg in next arg
+	$has_arg = $transopt;
+	return TRUE; # use 'next SPLIT' afterwards
+      } # end of if %opts_with_arg
+
+      # not with and without option, so is not permitted
+      $stderr->print( "'" . $transopt .
+		      "' is unknown long option from '" . $from_arg . "'" );
+      return TRUE; # use 'next SPLIT' afterwards
+    } # end of for N
+    return FALSE; # do nothing
+  }; # end of split_long()
+
+
+  #----------
+  # do split and transfer arguments
+  #----------
+  sub run_first {
+
+   SPLIT: foreach (@ARGV) {
+      # Transform long and short options into some given long options.
+      # Split long opts with arg into 2 args (no '=').
+      # Transform short option collections into given long options.
+      chomp;
+
+      if ( $has_arg ) {
+	push @splitted_args, $_;
+	$has_arg = EMPTYSTRING;
+	next SPLIT;
+      }
+
+      if ( $double_minus ) {
+	push @files, $_;
+	next SPLIT;
+      }
+
+      if ( $_ eq '-' ) {		# file arg '-'
+	push @files, $_;
+	next SPLIT;
+      }
+
+      if ( $_ eq '--' ) {		# POSIX arg '--'
+	push @splitted_args, $_;
+	$double_minus = TRUE;
+	next SPLIT;
+      }
+
+      if ( / # short option or collection of short options
+	     ^
+	     -
+	     (
+	       ^-
+	       .*
+	     )
+	     $
+	   /x ) {
+	$split_short->($1);
+	next SPLIT;
+      }				# end of short option
+
+      if ( /^--/ ) {		# starts with 2 dashes, a long option
+	$split_long->($_);
+	next SPLIT;
+      }				# end of long option
+
+      # unknown option without leading dash is a file name
+      push @files, $_;
+      next SPLIT;
+    }				# end of foreach SPLIT
+
+				  # all args are considered
+    $stderr->print( "Option '$has_arg' needs an argument." )
+      if ( $has_arg );
+
+
+    push @files, '-' unless ( @files );
+    @ARGV = @splitted_args;
+
+  };		    # end of first run, splitting with map or transfer
+
+
+  #----------
+  # open or ignore verbose output
+  #----------
+  sub install_verbose {
+    if ( $Args->{'verbose'} ) { # '--verbose' was used
+      # make verbose output into $v
+      # get content of string so far as array ref, close
+      my $s = $v->get();
+
+      $v = new FH_STDERR(); # make verbose output into STDERR
+      if ( $s ) {
+	for ( @$s ) {
+	  # print the file content into new verbose output
+	  $v->print($_);
+	}
+      }
+      # verbose output is now active (into STDERR)
+      $v->print( "Option '-v' means '--verbose'." );
+      $v->print( "Version information is printed by option"
+	         . " '--version'."
+      );
+      $v->print( "#" x 72 );
+
+    } else { # '--verbose' was not used
+      # do not be verbose, make verbose invisible
+
+      $v->close(); # close and ignore the string content
+
+      $v = new FH_NULL();
+      # this is either into /dev/null or in an ignored string
+
+    } # end if-else about verbose
+    # '$v->print' works now in any case
+
+    $v->print( "Verbose output was chosen." );
+
+    my $s = $Globals->{'prog_is_installed'} ? '' : ' not';
+    $v->print( $Globals->{'prog'} . " is" . $s .
+	       " installed." );
+
+    $v->print( 'The command-line options are:' );
+
+    $s = "  options:";
+    $s .= " '" . $_ . "'" for ( @ARGV );
+    $v->print( $s );
+
+    $s = "  file names:";
+    $s .= " '" . $_ . "'\n" for ( @files );
+    $v->print( $s );
+  } # end install_verbose()
+
+
+  #----------
+  # second run of command-line arguments
+  #----------
+  sub run_second {
+      # Second run of args with new @ARGV from the former splitting.
+      # Arguments are now split and transformed into special long
+      # options.
+
+      my $double_minus = FALSE;
+      my $has_arg = FALSE;
+
+    ARGS: for my $arg ( @ARGV ) {
+
+	# ignore '--', file names are handled later on
+	last ARGS if ( $arg eq '--' );
+
+	if ( $has_arg ) {
+	  unless ( exists $opts_with_arg{$has_arg} ) {
+	    $stderr->print( "'\%opts_with_args' does not have key '" .
+			      $has_arg . "'." );
+	    next ARGS;
+	  }
+
+	  $opts_with_arg{$has_arg}->($arg);
+	  $has_arg = FALSE;
+	  next ARGS;
+	} # end of $has_arg
+
+	if ( exists $opts_with_arg{$arg} ) {
+	  $has_arg = $arg;
+	  next ARGS;
+	}
+
+	if ( exists $opts_noarg{$arg} ) {
+	  $opts_noarg{$arg}->();
+	  next ARGS;
+	}
+
+	# not a suitable option
+	$stderr->print( "Wrong option '" . $arg . "'." );
+	next ARGS;
+
+      } # end of for ARGS:
+
+
+      if ( $has_arg ) { # after last argument
+	die "Option '$has_arg' needs an argument.";
+      }
+
+    }; # end of second run
+
+
+  sub handle_args {
+    # handling the output of args
+
+    if ( $Args->{'output'} ) { # '--output' was set in the arguments
+      my $out_path = &path2abs($Args->{'output'});
+      die "Output file name $Args->{'output'} cannot be used."
+	unless ( $out_path );
+
+      my ( $file, $dir );
+      ( $file, $dir ) = File::Basename::fileparse($out_path)
+	or die "Could not handle output file path '" . $out_path
+	  . "': directory name '" . $dir . "' and file name '" . $file
+	  . "'.";
+
+      die "Could not find output directory for '" . $Args->{'output'}
+        . "'" unless ( $dir );
+      die "Could not find output file: '" . $Args->{'output'} .
+	"'" unless ( $file );
+
+      if ( -d $dir ) {
+	die "Could not write to output directory '" . $dir . "'."
+	  unless ( -w $dir );
+      } else {
+	$dir = &make_dir($dir);
+	die "Could not create output directory in: '" . $out_path . "'."
+	  unless ( $dir );
+      }
+
+      # now $dir is a writable directory
+
+      if ( -e $out_path ) {
+	die "Could not write to output file '" . $out_path . "'."
+	  unless ( -w $out_path );
+      }
+
+      $out = new FH_FILE( $out_path );
+      $v->print( "Output goes to file '" . $out_path . "'." );
+    } else { # '--output' was not set
+      $out = new FH_STDOUT();
+    }
+    # no $out is the right behavior for standard output
+
+  #  $Args->{'prefix'} .= '_' . $Args->{'eps_func'} . '2eps';
+
+    @ARGV = @files;
+  }
+
   &run_first();
   &install_verbose();
   &run_second();
@@ -288,7 +1423,8 @@
       my @tempdirs = EMPTYARRAY;
       {
 	my $tmpdir = File::Spec->tmpdir();
-	push @tempdirs, $tmpdir if ( $tmpdir && -d $tmpdir && -w $tmpdir );
+	push @tempdirs, $tmpdir
+	  if ( $tmpdir && -d $tmpdir && -w $tmpdir );
 
 	my $root_dir = File::Spec->rootdir(); # '/' in Unix
 	my $root_tmp = File::Spec->catdir($root_dir, 'tmp');
@@ -306,7 +1442,7 @@
       }
 
 
-      my @path_extension = qw( groff ); # TEMPDIR/groff/USER/lilypond/<NUMBER>
+      my @path_extension = qw( groff ); # TEMPDIR/groff/USER/lilypond/N
       {
 	# '$<' is UID of actual user,
 	# 'getpwuid' gets user name in scalar context
@@ -565,73 +1701,81 @@
     ); # end definition %lilypond_args
 
 
- LILYPOND: foreach (<>) {
-    chomp;
-    my $line = $_;
-
+ LILYPOND: foreach my $filename (@ARGV) {
+    my $input;
+    if ($filename eq '-') {
+      $input = \*STDIN;
+    } elsif (not open $input, '<', $filename) {
+      warn $!;
+      next;
+    }
+    while (<$input>) {
+      chomp;
+      my $line = $_;
 
-    # now the lines with '.lilypond ...'
 
-    if ( /
-	   ^
-	   .'
-	   \s*
-	   lilypond
-	   (
-	     .*
-	   )
-	   $
-	 /x ) { # .lilypond ...
-      my $args = $1;
-      $args =~ s/
-		  ^
-		  \s*
-		//x;
-      $args =~ s/
-		  \s*
-		  $
-		//x;
-      $args =~ s/
-		  ^
-		  (
-		    \S*
-		  )
-		  \s*
-		//x;
-      my $arg1 = $1; # 'start', 'end' or 'include'
-      $args =~ s/"'`//g;
-      my $arg2 = $args; # file argument for '.lilypond include'
-
-      if ( exists $lilypond_args{$arg1} ) {
-	$lilypond_args{$arg1}->($arg2);
-	next;
-      } else {
-	# not a suitable argument of '.lilypond'
-	$stderr->print( "Unknown command: '$arg1' '$arg2':  '$line'" );
-      }
+      # now the lines with '.lilypond ...'
 
-      next LILYPOND;
-    } # end if for .lilypond
+      if ( /
+	     ^
+	     .'
+	     \s*
+	     lilypond
+	     (
+	       .*
+	     )
+	     $
+	   /x ) { # .lilypond ...
+	my $args = $1;
+	$args =~ s/
+		    ^
+		    \s*
+		  //x;
+	$args =~ s/
+		    \s*
+		    $
+		  //x;
+	$args =~ s/
+		    ^
+		    (
+		      \S*
+		    )
+		    \s*
+		  //x;
+	my $arg1 = $1; # 'start', 'end' or 'include'
+	$args =~ s/"'`//g;
+	my $arg2 = $args; # file argument for '.lilypond include'
+
+	if ( exists $lilypond_args{$arg1} ) {
+	  $lilypond_args{$arg1}->($arg2);
+	  next;
+	} else {
+	  # not a suitable argument of '.lilypond'
+	  $stderr->print( "Unknown command: '$arg1' '$arg2':  '$line'" );
+	}
 
+	next LILYPOND;
+      } # end if for .lilypond
 
-    if ( $lilypond_mode ) { # do lilypond-mode
-      # see '.lilypond start'
-      $ly->print( $line );
-      next LILYPOND;
-    } # do lilypond-mode
 
-    # unknown line without lilypond
-    unless ( /
-	       ^
-	       .'
-	       \s*
-	       lilypond
-	     /x ) { # not a '.lilypond' line
-      $out->print($line);
-      next LILYPOND;
-    }
+      if ( $lilypond_mode ) { # do lilypond-mode
+	# see '.lilypond start'
+	$ly->print( $line );
+	next LILYPOND;
+      } # do lilypond-mode
 
-  } # end foreach <>
+      # unknown line without lilypond
+      unless ( /
+		 ^
+		 .'
+		 \s*
+		 lilypond
+	       /x ) { # not a '.lilypond' line
+	$out->print($line);
+	next LILYPOND;
+      }
+    } # end while <$input>
+  } # end foreach $filename
 } # end Read
 
 
@@ -723,7 +1867,7 @@
 
   if ( $Temp->{'eps_dir'} ) {
     # EPS files in $Temp->{'eps_dir'} are always kept
-    $v->print( "As EPS directrory is set as '" .
+    $v->print( "As EPS directory is set as '" .
       $Temp->{'eps_dir'} . "', no EPS files there will be deleted." );
 
     opendir my $dh_temp, $Temp->{'eps_dir'} or
@@ -756,8 +1900,8 @@
 
 
 1;
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: CPerl
 # End:
+# vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gperl/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gperl/ChangeLog Changed

@@ -1,3 +1,43 @@
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gperl.pl: Include groff version information when reporting our
+	own (as recommended by GNU coding standards).  Also drop
+	gratuitous quotation of program's own name.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gperl.am (gperl): Spell dependency on `$(SH_DEPS_SED_SCRIPT)`
+	using that macro expansion instead of a literal file name.  See
+	groff's doc/automake.mom.
+
+2021-01-06  Colin Watson <cjwatson@debian.org>
+
+	* gperl.pl: Avoid Perl's unsafe "<>" operator.
+
+	The "<>" operator is implemented using the two-argument form of
+	"open", which interprets magic such as pipe characters, allowing
+	execution of arbitrary commands which is unlikely to be
+	expected.  Perl >= 5.22 has a "<<>>" operator which avoids this,
+	but also forbids the use of "-" to mean the standard input,
+	which is a facility that the affected groff programs document.
+
+	ARGV::readonly would probably also fix this, but I fundamentally
+	dislike the approach of escaping data in preparation for a
+	language facility to unescape it, especially when the required
+	escaping is as non-obvious as it is here.  (For the same reason,
+	I prefer to use subprocess invocation facilities that allow
+	passing the argument list as a list rather than as a string to
+	be interpreted by the shell.)  So I've abandoned this dubious
+	convenience and changed the affected programs to iterate over
+	command-line arguments manually using the three-argument form of
+	open.
+
+	Fixes <https://savannah.gnu.org/bugs/?55557>.
+
+2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gperl.1.man: Delete references to groffer.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* gperl.am (gperl): Use $(AM_V_GEN) to silence file generation.
@@ -85,7 +125,7 @@
 ________________________________________________________________________
 License
 
-Copyright (C) 2014-2018 Free Software Foundation, Inc.
+Copyright (C) 2014-2020 Free Software Foundation, Inc.
 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 Copying and distribution of this file, with or without
@@ -95,7 +135,7 @@
 This file is part of `gperl', which is part of the `groff'
 project.
 
-####### Emacs settings
+##### Editor settings
 
 Local Variables:
 mode: change-log

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gperl/gperl.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gperl/gperl.1.man Changed

@@ -1,12 +1,15 @@
-.TH GPERL @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-gperl \- groff preprocessor for Perl parts in roff files
+.TH gperl @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+gperl \- execute Perl commands in
+.I groff
+documents
+.
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2014-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2014-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of gperl, which is part of groff, a free software
 .\" project.
@@ -18,54 +21,62 @@
 .\" The license text is available in the internet at
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
 .
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_gperl_1_man_C \n.cp
+.cp 0
 .
-.\" Bullet
-.ie t .ds BU \(bu
-.el .ds BU *
-.\" used in '.IP \*(BU 2m' (former .Topic)
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH "SYNOPSIS"
+.SH Synopsis
 .\" ====================================================================
 .
 .SY gperl
-.RI  filespec
-\*(EL
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY gperl
 .B \-h
+.
 .SY gperl
 .B \-\-help
 .YS
 .
 .SY gperl
 .B \-v
+.
 .SY gperl
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 This is a preprocessor for
-.BR \%groff (@MAN1EXT@).
+.MR groff @MAN1EXT@ .
 .
 It allows the use of
-.BR perl (7)
+.MR perl 7
 code in
-.BR groff (7)
+.MR groff @MAN7EXT@
 files.
 .
 The result of a
@@ -78,55 +89,36 @@
 .IR "Perl part" .
 .
 .
-.\" ====================================================================
-.SH "OPTIONS"
-.\" ====================================================================
-.
-So far, there are only
-.I filespec
-or
-.I breaking
-options.
-.
-.
-.P
-.I filespec
-are file names or the minus character
-.B \-
-character for standard input.
-.
-As usual, the argument
-.B \-\-
-can be used in order to let all following arguments mean file names,
-even if the names begin with a minus character
-.BR \- .
-.
-.
 .P
-An option is
-.IR breaking ,
-when the program just writes the information that was asked for and
-then stops.
-.
-All other arguments will be ignored by that.
-.
-These
-.I breaking
-options are here
-.
-.TP
-.B \-h\~\fR|\fB\~\-\-help
-Print help information with a short explanation of options to
-standard output.
-.
+If no operands are given,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I gperl
+reads the standard input stream.
+.
+A double-dash argument
+.RB (\lq \-\- \rq)
+causes all subsequent arguments to be interpreted as
+.I file
+operands,
+even if their names start with a dash.
 .
-.TP
-.B \-v\~\fR|\fB\~\-\-version
-Print version information to standard output.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+whereas
+.B \-v
+and
+.B \-\-version
+display version information;
+all exit afterward.
 .
 .
 .\" ====================================================================
-.SH "PERL PARTS"
+.SH "Perl regions"
 .\" ====================================================================
 .
 .I Perl
@@ -142,7 +134,7 @@
 .
 .
 .\" ====================================================================
-.SS "Starting Perl Mode"
+.SS "Starting Perl mode"
 .\" ====================================================================
 .
 The starting
@@ -151,15 +143,15 @@
 .B start
 as its only argument.
 .RS
-.IP \*(BU 2m
+.IP \(bu
 .B .Perl
-.IP \*(BU 2m
+.IP \(bu
 .B .Perl start
 .RE
 .
 .
 .\" ====================================================================
-.SS "Ending Perl Mode without Storage"
+.SS "Ending Perl mode without storage"
 .\" ====================================================================
 .
 A
@@ -174,9 +166,9 @@
 that's possible, but not necessary.
 .
 .RS
-.IP \*(BU 2m
+.IP \(bu
 .B .Perl stop
-.IP \*(BU 2m
+.IP \(bu
 .BI .Perl " other_than_start"
 .RE
 .
@@ -188,11 +180,11 @@
 .
 .
 .\" ====================================================================
-.SS "Ending Perl Mode with Storage"
+.SS "Ending Perl mode with storage"
 .\" ====================================================================
 .
 A useful feature of
-.B gperl
+.I gperl
 is to store one or more results from the
 .IR "Perl mode" .
 .
@@ -220,7 +212,7 @@
 .
 .P
 This Perl array output can be stored by
-.B gperl
+.I gperl
 in either
 .TP
 .I groff strings
@@ -228,7 +220,7 @@
 .B .ds
 .
 .TP
-.I groff number register
+.I groff register
 by creating a groff command
 .B .rn
 .
@@ -245,10 +237,12 @@
 and
 .B .nr
 changes the mode into
-.I groff number register
+.I groff register
 for all following output parts.
 .
 .
+.br
+.ne 2v
 .P
 By default, all output is saved as strings, so
 .B .ds
@@ -257,16 +251,16 @@
 command.
 .
 That suits to
-.BR \%groff (@MAN7EXT@),
+.MR groff @MAN7EXT@ ,
 because every output can be saved as
 .I groff
-string, but the number registers can be very restrictive.
+string, but the registers can be very restrictive.
 .
 .
 .P
 In
 .IR "string mode" ,
-.B gperl
+.I gperl
 generates a
 .I groff string
 storage line
@@ -277,7 +271,7 @@
 .RE
 .
 In
-.I number register mode
+.I register mode
 the following groff command is generated
 .RS
 .EX
@@ -353,9 +347,9 @@
 .
 .TP
 .BI ".Perl .nr" " var_name1 varname2"
-stores both variables as number register variables.
+stores both variables as register variables.
 .
-.B gperl
+.I gperl
 generates
 .RS
 .EX
@@ -368,7 +362,7 @@
 .TP
 .BI ".Perl .nr " var_name1 " .ds " var_name2
 stores the 1st argument as
-.I number register
+.I register
 and the second as
 .I string
 by
@@ -381,20 +375,7 @@
 .
 .
 .\" ====================================================================
-.SS "Printing towards STDERR is without Storage"
-.\" ====================================================================
-.
-The printing towards
-.IR STDERR ,
-(standard error) works as usual.
-.
-All error information goes to the real normal
-.IR "standard error" ,
-without other automatic storage.
-.
-.
-.\" ====================================================================
-.SH "EXAMPLES"
+.SH Example
 .\" ====================================================================
 .
 A possible
@@ -406,7 +387,7 @@
 .EX
 before
 \&.Perl start
-my $result = 'some data';
+my $result = \aqsome data\aq;
 print $result;
 \&.Perl stop .ds string_var
 after
@@ -428,9 +409,9 @@
 .EE
 .RE
 by
-.B gperl
+.I gperl
 as food for the coming
-.B groff
+.I groff
 run.
 .
 .
@@ -466,43 +447,45 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-.B gperl
+.
+.I gperl
 was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .P
 Man pages related to
 .I groff
 are
-.BR \%groff (@MAN1EXT@),
-.BR \%groff (@MAN7EXT@),
-.BR \%grog (@MAN1EXT@),
+.MR groff @MAN1EXT@ ,
+.MR groff @MAN7EXT@ ,
 and
-.BR \%groffer (@MAN1EXT@).
+.MR grog @MAN1EXT@ .
 .
 .
 .P
 Documents related to
 .I Perl
 are
-.BR \%perl (@MAN1EXT@),
-.BR \%perl (@MAN7EXT@).
+.MR perl 1 ,
+.MR perl 7 .
 .
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_gperl_1_man_C
+.do rr *groff_gperl_1_man_C
+.
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gperl/gperl.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gperl/gperl.am Changed

@@ -1,13 +1,9 @@
 # Automake rules for 'gperl' (preprocessor for added Perl parts)
 
-# File position: <groff-source>/contrib/gperl/gperl.am
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Automake migration by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'gperl' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -33,7 +29,7 @@
   contrib/gperl/gperl.1.man \
   contrib/gperl/gperl.pl
 
-gperl: $(top_srcdir)/contrib/gperl/gperl.pl shdeps.sed
+gperl: $(top_srcdir)/contrib/gperl/gperl.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)$(RM) $@ \
 	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	       -e "s|@g@|$(g)|g" \
@@ -45,12 +41,8 @@
 	&& chmod +x $@
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gperl/gperl.pl -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gperl/gperl.pl Changed

@@ -2,10 +2,7 @@
 
 # gperl - add Perl part to groff files, this is the preprocessor for that
 
-# Source file position: <groff-source>/contrib/gperl/gperl.pl
-# Installed position: <prefix>/bin/gperl
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
@@ -99,7 +96,7 @@
       q(parts in 'roff' files.);
     exit;
   } elsif ( /^(-v|--v|--ve|--ver|--vers|--versi|--versio|--version)$/ ) {
-    print q('gperl' version ) . $version;
+    print "gperl (groff @VERSION@) version $version";
     exit;
   }
 }
@@ -132,121 +129,129 @@
 
 my $perl_mode = 0;
 
-foreach (<>) {
-  chomp;
-  s/\s+$//;
-  my $line = $_;
-  my $is_dot_Perl = $line =~ /^.'\s*Perl(|\s+.*)$/;
-
-  unless ( $is_dot_Perl ) {	# not a '.Perl' line
-    if ( $perl_mode ) {		# is running in Perl mode
-      print OUT $line;
-    } else {			# normal line, not Perl-related
-      print $line;
-    }
+unshift @ARGV, '-' unless @ARGV;
+foreach my $filename (@ARGV) {
+  my $input;
+  if ($filename eq '-') {
+    $input = \*STDIN;
+  } elsif (not open $input, '<', $filename) {
+    warn $!;
     next;
   }
-
-
-  ##########
-  # now the line is a '.Perl' line
-
-  my $args = $line;
-  $args =~ s/\s+$//;	# remove final spaces
-  $args =~ s/^.'\s*Perl\s*//;	# omit .Perl part, leave the arguments
-
-  my @args = split /\s+/, $args;
-
-  ##########
-  # start Perl mode
-  if ( @args == 0 || @args == 1 && $args0 eq 'start' ) {
-    # For '.Perl' no args or first arg 'start' means opening 'Perl' mode.
-    # Everything else means an ending command.
-    if ( $perl_mode ) {
-      # '.Perl' was started twice, ignore
-      print STDERR q('.Perl' starter was run several times);
-      next;
-    } else {	# new Perl start
-      $perl_mode = 1;
-      open OUT, '>', $out_file;
+  while (<$input>) {
+    chomp;
+    s/\s+$//;
+    my $line = $_;
+    my $is_dot_Perl = $line =~ /^.'\s*Perl(|\s+.*)$/;
+
+    unless ( $is_dot_Perl ) {	# not a '.Perl' line
+      if ( $perl_mode ) {		# is running in Perl mode
+        print OUT $line;
+      } else {			# normal line, not Perl-related
+        print $line;
+      }
       next;
     }
-  }
 
-  ##########
-  # now the line must be a Perl ending line (stop)
 
-  unless ( $perl_mode ) {
-    print STDERR 'gperl: there was a Perl ending without being in ' .
-      'Perl mode:';
-    print STDERR '    ' . $line;
-    next;
-  }
+    ##########
+    # now the line is a '.Perl' line
+
+    my $args = $line;
+    $args =~ s/\s+$//;	# remove final spaces
+    $args =~ s/^.'\s*Perl\s*//;	# omit .Perl part, leave the arguments
+
+    my @args = split /\s+/, $args;
+
+    ##########
+    # start Perl mode
+    if ( @args == 0 || @args == 1 && $args0 eq 'start' ) {
+      # For '.Perl' no args or first arg 'start' means opening 'Perl' mode.
+      # Everything else means an ending command.
+      if ( $perl_mode ) {
+        # '.Perl' was started twice, ignore
+        print STDERR q('.Perl' starter was run several times);
+        next;
+      } else {	# new Perl start
+        $perl_mode = 1;
+        open OUT, '>', $out_file;
+        next;
+      }
+    }
 
-  $perl_mode = 0;	# 'Perl' stop calling is correct
-  close OUT;		# close the storing of 'Perl' commands
+    ##########
+    # now the line must be a Perl ending line (stop)
 
-  ##########
-  # run this 'Perl' part, later on about storage of the result
-  # array stores prints with \n
-  my @print_res = `perl $out_file`;
+    unless ( $perl_mode ) {
+      print STDERR 'gperl: there was a Perl ending without being in ' .
+        'Perl mode:';
+      print STDERR '    ' . $line;
+      next;
+    }
 
-  # remove 'stop' arg if exists
-  shift @args if ( $args0 eq 'stop' );
+    $perl_mode = 0;	# 'Perl' stop calling is correct
+    close OUT;		# close the storing of 'Perl' commands
 
-  if ( @args == 0 ) {
-    # no args for saving, so @print_res doesn't matter
-    next;
-  }
+    ##########
+    # run this 'Perl' part, later on about storage of the result
+    # array stores prints with \n
+    my @print_res = `perl $out_file`;
 
-  my @var_names = ();
-  my @mode_names = ();
+    # remove 'stop' arg if exists
+    shift @args if ( $args0 eq 'stop' );
 
-  my $mode = '.ds';
-  for ( @args ) {
-    if ( /^\.?ds$/ ) {
-      $mode = '.ds';
+    if ( @args == 0 ) {
+      # no args for saving, so @print_res doesn't matter
       next;
     }
-    if ( /^\.?nr$/ ) {
-      $mode = '.nr';
-      next;
+
+    my @var_names = ();
+    my @mode_names = ();
+
+    my $mode = '.ds';
+    for ( @args ) {
+      if ( /^\.?ds$/ ) {
+        $mode = '.ds';
+        next;
+      }
+      if ( /^\.?nr$/ ) {
+        $mode = '.nr';
+        next;
+      }
+      push @mode_names, $mode;
+      push @var_names, $_;
     }
-    push @mode_names, $mode;
-    push @var_names, $_;
-  }
 
-  my $n_res = @print_res;
-  my $n_vars = @var_names;
+    my $n_res = @print_res;
+    my $n_vars = @var_names;
 
-  if ( $n_vars < $n_res ) {
-    print STDERR 'gperl: not enough variables for Perl part: ' .
-      $n_vars . ' variables for ' . $n_res . ' output lines.';
-  } elsif ( $n_vars > $n_res ) {
-    print STDERR 'gperl: too many variablenames for Perl part: ' .
-      $n_vars . ' variables for ' . $n_res . ' output lines.';
-  }
-  if ( $n_vars < $n_res ) {
-    print STDERR 'gperl: not enough variables for Perl part: ' .
-      $n_vars . ' variables for ' . $n_res . ' output lines.';
-  }
+    if ( $n_vars < $n_res ) {
+      print STDERR 'gperl: not enough variables for Perl part: ' .
+        $n_vars . ' variables for ' . $n_res . ' output lines.';
+    } elsif ( $n_vars > $n_res ) {
+      print STDERR 'gperl: too many variablenames for Perl part: ' .
+        $n_vars . ' variables for ' . $n_res . ' output lines.';
+    }
+    if ( $n_vars < $n_res ) {
+      print STDERR 'gperl: not enough variables for Perl part: ' .
+        $n_vars . ' variables for ' . $n_res . ' output lines.';
+    }
 
-  my $n_min = $n_res;
-  $n_min = $n_vars if ( $n_vars < $n_res );
-  exit unless ( $n_min );
-  $n_min -= 1; # for starting with 0
+    my $n_min = $n_res;
+    $n_min = $n_vars if ( $n_vars < $n_res );
+    exit unless ( $n_min );
+    $n_min -= 1; # for starting with 0
 
-  for my $i ( 0..$n_min ) {
-    my $value = $print_res$i;
-    chomp $value;
-    print $mode_names$i . ' ' . $var_names$i . ' ' . $value;
+    for my $i ( 0..$n_min ) {
+      my $value = $print_res$i;
+      chomp $value;
+      print $mode_names$i . ' ' . $var_names$i . ' ' . $value;
+    }
   }
 }
 
 
 1;
-########################################################################
-### Emacs settings
 # Local Variables:
 # mode: CPerl
 # End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gpinyin/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gpinyin/ChangeLog Changed

@@ -1,3 +1,109 @@
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gpinyin.pl: Report groff version number along with this
+	program's own when not run from source tree.  Drop dead code.
+	Bump micro version number to reflect recent restructuring.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Make gpinyin script stand alone.
+
+	* subs.pl: Delete, moving its content into...
+	* gpinyin.pl: ...here.
+	(vowel_t): Use explicit list with `my`.
+	(vowel_n, vowel_t): Declare local scalar `$vowel_with_tone`
+	using `my`.
+	* gpinyin.am (dist_gpinyin_DATA): Delete.
+
+2022-05-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gpinyin.am (gpinyin): Fix missing dependency on
+	`$(SH_DEPS_SED_SCRIPT)`.
+
+2021-05-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gpinyin.1.man: Render the tone mark table only if the output
+	device might be capable.
+
+	Fixes <https://savannah.gnu.org/bugs/index.php?55215>.
+
+2021-05-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gpinyin.1.man: Work around inability of grops and gropdf to
+	construct some Unicode composite characters.  Use groff
+	composite special characters for "a" with acute and grave
+	accents, and define strings for "a" with macron (overline) and
+	with háček/caron accents.  Use different string definitions for
+	nroff and troff modes so we don't regress UTF-8 terminal output.
+
+2021-05-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* subs.pl (vowel_t): Fix incorrect rendering of base glyph 'U',
+	which was being forced to lowercase when a dieresis and tone
+	mark were both being applied.  This caused the tone mark to
+	overlap the dieresis, so decrease the font size of the base
+	glyph even more to compensate.  The result is ugly but
+	comprehensible.
+
+	See <https://savannah.gnu.org/bugs/?57524>, partially mitigated
+	but not completely resolved.
+
+2021-05-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* subs.pl (%tones1_Unicode): Fix copy and paste error.  Emit
+	U+01D5 (Latin capital letter u with dieresis and macron) for Ü
+	with tone 1, instead of U+016A (Latin capital letter u with
+	macron).
+
+	Fixes <https://savannah.gnu.org/bugs/?60562>.
+
+2021-05-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* subs.pl (handle_word): Emit \cq instead of \aq when
+	interpolating an apostrophe before a vowel.
+
+	Fixes <https://savannah.gnu.org/bugs/?60561>.
+
+2021-05-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* subs.pl (%tones_glyphs, %tones4_glyphs): Fix hash keys to use
+	the groff dotless i special character into which a lowercase "i"
+	has already been transformed instead of 'i' itself.
+	(vowel_n, vowel_t): Rename variable so that tone-transformed
+	vowel is stored separately.  Add "or warn" to test the result
+	and cheaply assert that we got a string back from our hash
+	lookup on the vowel.
+
+	Fixes <https://savannah.gnu.org/bugs/?60560>.
+
+2021-01-06  Colin Watson <cjwatson@debian.org>
+
+	* gpinyin.pl: Avoid Perl's unsafe "<>" operator.
+
+	The "<>" operator is implemented using the two-argument form of
+	"open", which interprets magic such as pipe characters, allowing
+	execution of arbitrary commands which is unlikely to be
+	expected.  Perl >= 5.22 has a "<<>>" operator which avoids this,
+	but also forbids the use of "-" to mean the standard input,
+	which is a facility that the affected groff programs document.
+
+	ARGV::readonly would probably also fix this, but I fundamentally
+	dislike the approach of escaping data in preparation for a
+	language facility to unescape it, especially when the required
+	escaping is as non-obvious as it is here.  (For the same reason,
+	I prefer to use subprocess invocation facilities that allow
+	passing the argument list as a list rather than as a string to
+	be interpreted by the shell.)  So I've abandoned this dubious
+	convenience and changed the affected programs to iterate over
+	command-line arguments manually using the three-argument form of
+	open.
+
+	Fixes <https://savannah.gnu.org/bugs/?55557>.
+
+2020-04-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* gpinyin.1.man: Delete references to groffer.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* gpinyin.am (gpinyin): Use $(AM_V_GEN) to silence file generation.
@@ -74,7 +180,7 @@
 ________________________________________________________________________
 License
 
-Copyright (C) 2014-2018 Free Software Foundation, Inc.
+Copyright (C) 2014-2020 Free Software Foundation, Inc.
 Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
 Copying and distribution of this file, with or without
@@ -84,8 +190,11 @@
 This file is part of `gpinyin', which is part of the `groff'
 project.
 
-####### Emacs settings
+##### Editor settings
 
 Local Variables:
+fill-column: 72
 mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gpinyin/gpinyin.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gpinyin/gpinyin.1.man Changed

@@ -1,13 +1,16 @@
 '\" t
-.TH GPINYIN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-gpinyin \- use Hanyu Pinyin Chinese in roff
+.TH gpinyin @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+gpinyin \- use Hanyu Pinyin Chinese in
+.I groff
+documents
+.
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2014-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2014-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of gpinyin, which is part of groff, a free
 .\" software project.
@@ -19,6 +22,27 @@
 .\" The license text is available in the internet at
 .\" <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_gpinyin_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Local definitions
 .\" ====================================================================
@@ -27,49 +51,50 @@
 .ie t .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .el   .ds TeX TeX
 .
-.\" Define a string for an ellipsis.
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.
 .
 .\" ====================================================================
-.SH "SYNOPSIS"
+.SH Synopsis
 .\" ====================================================================
 .
 .SY gpinyin
-.RI  input-file
-\*(EL
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY gpinyin
 .B \-h
+.
 .SY gpinyin
 .B \-\-help
 .YS
 .
 .SY gpinyin
 .B \-v
+.
 .SY gpinyin
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B gpinyin
+.I gpinyin
 is a preprocessor for
-.BR \%groff (@MAN1EXT@)
-that facilitates use of the Hanyu Pinyin
-.BR groff (7)
+.MR groff @MAN1EXT@
+that facilitates use of Hanyu Pinyin in
+.MR groff @MAN7EXT@
 files.
 .
-Pinyin is a method for writing the Chinese language with the Latin
-alphabet.
+Pinyin is a method for writing the Mandarin Chinese language with the
+Latin alphabet.
+.
+Mandarin consists of more than four hundred base syllables,
+each spoken with one of five different tones.
 .
-The Chinese language consists of more than four hundred syllables,
-each with one of five different tones.
+Changing the tone applied to the syllable generally alters the meaning
+of the word it forms.
 .
 In Pinyin,
 a syllable is written in the Latin alphabet and a numeric tone indicator
@@ -79,19 +104,34 @@
 .P
 Each
 .I input-file
-is a file name or the hyphen-minus character \lq\-\rq to indicate
-that standard input should be read.
+is a file name or the character
+.RB \lq \- \rq
+to indicate that the standard input stream should be read.
 .
 As usual,
-the argument \lq\-\-\rq can be used in order to force interpretation
-of all remaining arguments as file names,
+the argument
+.RB \lq \-\- \rq
+can be used in order to force interpretation of all remaining arguments
+as file names,
 even if an
 .I input-file
-argument begins with the hyphen-minus character.
+argument begins with a
+.RB \lq \- \rq.
+.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .\" ====================================================================
-.SS "Pinyin Sections"
+.SS "Pinyin sections"
 .\" ====================================================================
 .
 Pinyin sections in
@@ -128,21 +168,13 @@
 .
 .
 .\" ====================================================================
-.SS "Syllables"
+.SS Syllables
 .\" ====================================================================
 .
-The spoken Chinese language is based on about 411
-.IR syllables ;
-see
-.UR http://\:en.wikipedia.org/\:wiki/\:Pinyin_table
-.UE .
-.
-.
-.P
 In Pinyin,
-each syllable consists of one to six letters from the Latin alphabet;
-these letters comprise the fifty-two upper- and lowercase letters from
-the ASCII character set,
+each syllable is represented by one to six letters drawn from the
+fifty-two upper- and lowercase letters of the Unicode basic Latin
+character set,
 plus the letter \lqU\rq with dieresis (umlaut) in both cases\emin
 other words,
 the members of the set \lqa\enzA\enZ\:u\:U\rq.
@@ -152,7 +184,7 @@
 In
 .I groff
 input,
-all ASCII letters are written as themselves.
+all basic Latin letters are written as themselves.
 .
 The \lqu with dieresis\rq can be written as
 \lq\e:u\rq
@@ -174,7 +206,7 @@
 .
 .
 .\" ====================================================================
-.SS "Tones"
+.SS Tones
 .\" ====================================================================
 .
 Each syllable has exactly one of five
@@ -199,24 +231,46 @@
 .
 .
 .P
-The following table summarizes the tones.
-.
-Some output devices will not be able to render every output example.
+.nr gpinyin*do-table 0
+.if t .nr gpinyin*do-table 1
+.if n .if '\*.T'utf8' .nr gpinyin*do-table 1
+.\" XXX: One hack necessitates another; since our table is conditional,
+.\" we need to save the input line counter.
+.nr gpinyin*.c \n.c
+.ie \ngpinyin*do-table \{\
+The tones are written as follows.
 .
 .
 .P
+.\" XXX: This is so gross.  Why can't grops and gropdf figure this out?
+.if t .ds a- \za\a-
+.if n .ds a- \a a-
+.if t .ds a< \za\ah
+.if n .ds a< \a ah
 .if t .ne 8 \" Try to keep the table on one page for printed output.
 .TS
 l l l l l.
 Tone	Description	Diacritic	Example Input	Example Output
 _
-first	flat	\a-	ma1	m\u0061_0304
-second	rising	\aa	ma2	m\u0061_0301
-third	falling-rising	\ah	ma3	m\u0061_030C
-fourth	falling	\ga	ma4	m\u0061_0300
+first	flat	\a-	ma1	m\*a-
+second	rising	\aa	ma2	m\a aa
+third	falling-rising	\ah	ma3	m\*a<
+fourth	falling	\ga	ma4	m\a ga
 fifth	neutral	(none)	ma0	ma
 \^	\^	\^	ma5	\^
 .TE
+.\}
+.lf (\ngpinyin*.c + 25) \" XXX part 2: Restore input line counter.
+.el \{\
+The tone mark table is omitted from this rendering of the man page
+because the selected output device \lq\*.T\rq lacks the character
+repertoire to display it.
+.
+Try another output device.
+.\}
+.rm a-
+.rm a<
+.rr gpinyin*do-table
 .
 .
 .P
@@ -225,82 +279,52 @@
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Authors
 .\" ====================================================================
 .
-.TP
-.B \-h
-.TQ
-.B \-\-help
-Print usage information and exit.
-.
-.
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Print version information and exit.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.
-.B gpinyin
+.I gpinyin
 was written by
-.MT <groff\-bernd.warken\-72@\:web.de>
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 Useful documents on the World Wide Web related to Pinyin include
 .RS 4n
-.br
-.UR http://\:en.wikipedia.org/\:wiki/\:Pinyin
-\lqPinyin\rq (Wikipedia)
-.UE ,
-.
-.br
-.UR http://\:en.wikipedia.org/\:wiki/\:Pinyin_table
-\lqPinyin table\rq (Wikipedia)
-.UE ,
-.
-.\" XXX: dead link
-.\".br
-.\".UR http://\:www.sino.uni\-heidelberg.de/\:course_resources/\:s02/\:\
-.\"py\-vowels.htm
-.\".I Unicode vowels for Pinyin
-.\".UE ,
-.\".
-.br
-.UR http://\:www.foolsworkshop.com/\:ptou/\:index.html
+.UR http://\:www\:.foolsworkshop\:.com/\:ptou/\:index\:.html
 .I Pinyin to Unicode
 .UE ,
 .
 .br
-.UR http://\:www.mandarintools.com/
-.I On-line Chinese Tools
+.UR http://\:www\:.mandarintools\:.com/
+.I On-line Chinese Tools \" sic: On-line
 .UE ,
 .
 .br
-.UR http://\:www.pinyin.info/\:index.html
+.\" XXX: Turning off adjustment like this is ugly; thanks to meter-long
+.\" URLs we need an escape sequence that selectively disables adjustment
+.\" at the end of a word.
+.na
+.UR http://\:www\:.pinyin\:.info/\:index\:.html
 .I Pinyin.info: a guide to the writing of Mandarin Chinese in \
 romanization
 .UE ,
+.ad \*AD
 .
 .br
-.UR http://\:www.pinyin.info/\:rules/\:where.html
-\lqWhere do the tone marks go?\rq (Pinyin.info)
+.UR http://\:www\:.pinyin\:.info/\:rules/\:where.html
+\lqWhere do the tone marks go?\rq
 .UE ,
 .
 .br
-.UR http://\:git.savannah.gnu.org/\:gitweb/\:\
-?p=cjk.git;a=blob_plain;f=doc/\:pinyin.txt;hb=HEAD
-pinyin.txt from the CJK macro package for \*TeX
+.UR http://\:git\:.savannah\:.gnu\:.org/\:gitweb/\:\
+?p=cjk\:.git\:;a=blob_plain\:;f=doc/\:pinyin\:.txt\:;hb=HEAD
+.I pinyin.txt
+from the CJK macro package for \*TeX
 .UE ,
 .br
 .RS -4n
@@ -308,38 +332,47 @@
 .RE
 .
 .br
-.UR http://\:git.savannah.gnu.org/\:gitweb/\:\
-?p=cjk.git;a=blob_plain;f=texinput/p\:inyin.sty;hb=HEAD
-pinyin.sty from the CJK macro package for \*TeX
+.\" XXX: Same ugliness as before.
+.na
+.UR http://\:git\:.savannah\:.gnu\:.org/\:gitweb/\:\
+?p=cjk\:.git\:;a=blob_plain\:;f=texinput/\:pinyin\:.sty\:;hb=HEAD
+.I pinyin.sty
+from the CJK macro package for \*TeX
 .UE .
+.ad \*AD
 .
 .RE
 .
+.
 .P
-.BR \%groff (@MAN1EXT@),
-.BR \%grog (@MAN1EXT@),
+.MR groff @MAN1EXT@
 and
-.BR \%groffer (@MAN1EXT@)
+.MR grog @MAN1EXT@
 explain how to view
 .I roff
 documents.
 .
 .
 .P
-.BR \%groff (@MAN7EXT@)
+.MR groff @MAN7EXT@
 and
-.BR \%groff_char (@MAN7EXT@)
+.MR groff_char @MAN7EXT@
 are comprehensive references covering the language elements of GNU
-.I roff
+.I troff \" GNU
 and the available glyph repertoire,
 respectively.
 .
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.\" Clean up.
+.rm TeX
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_gpinyin_1_man_C
+.do rr *groff_gpinyin_1_man_C
+.
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gpinyin/gpinyin.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gpinyin/gpinyin.am Changed

@@ -1,13 +1,9 @@
 # Automake rules for 'gpinyin' (preprocessor for added Perl parts)
 
-# File position: <groff-source>/contrib/gpinyin/gpinyin.am
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 # Moved to automake by Bertrand Garrigues
 
-# Last update: 22 Aug 2015
-
 # This file is part of 'gpinyin' which is part of 'groff'.
 
 # 'groff' is free software; you can redistribute it and/or modify it
@@ -29,14 +25,13 @@
 gpinyin_srcdir = $(top_srcdir)/contrib/gpinyin
 bin_SCRIPTS += gpinyin
 gpinyindir = $(gpinyin_dir)
-dist_gpinyin_DATA = contrib/gpinyin/subs.pl
 man1_MANS += contrib/gpinyin/gpinyin.1
 EXTRA_DIST += \
   contrib/gpinyin/ChangeLog \
   contrib/gpinyin/gpinyin.1.man \
   contrib/gpinyin/gpinyin.pl
 
-gpinyin: contrib/gpinyin/gpinyin.pl
+gpinyin: contrib/gpinyin/gpinyin.pl $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)sed -f "$(SH_DEPS_SED_SCRIPT)" \
 	    -e "s|@g@|$(g)|g" \
 	    -e "s|@BINDIR@|$(DESTDIR)$(bindir)|g" \
@@ -54,12 +49,8 @@
 	fi
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/gpinyin/gpinyin.pl -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/gpinyin/gpinyin.pl Changed

@@ -2,14 +2,12 @@
 
 # gpinyin - European-like Chinese writing 'pinyin' into 'groff'
 
-# Source file position: <groff-source>/contrib/gpinyin/gpinyin.pl
-# Installed position: <prefix>/bin/gpinyin
-
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 
 # Written by Bernd Warken <groff-bernd.warken-72@web.de>.
 
-my $version = '1.0.4';
+my $version = '1.0.5';
+my $groff_version = '(groff @VERSION@) '; # with trailing space
 
 # This file is part of 'gpinyin', which is part of 'groff'.
 
@@ -57,37 +55,562 @@
 
 $\ = "\n";	# final part for print command
 
+{
+  my $at = '@';
+  $groff_version = '' if '@VERSION@' eq "${at}VERSION${at}";
+}
+
 ########################################################################
-# read-only variables with double-@ construct
+# All Pinyin syllables from wikipedia
 ########################################################################
 
-our $File_split_env_sh;
-our $File_version_sh;
-our $Groff_Version;
+my %syllables =
+  (
+   'a' => 1, 'ai' => 1, 'an' => 1, 'ang' => 1, 'ao' => 1,
+   'ba' => 1, 'bai' => 1, 'ban' => 1, 'bang' => 1, 'bao' => 1,
+   'bei' => 1, 'ben' => 1, 'beng' => 1,
+   'bi' => 1, 'bian' => 1, 'biao' => 1, 'bie' => 1, 'bin' => 1,
+   'bing' => 1, 'bo' => 1, 'bu' => 1,
+   'ca' => 1, 'cai' => 1, 'can' => 1, 'cang' => 1, 'cao' => 1,
+   'ce' => 1, 'cen' => 1, 'ceng' => 1,
+   'cha' => 1, 'chai' => 1, 'chan' => 1, 'chang' => 1, 'chao' => 1,
+   'che' => 1, 'chen' => 1, 'cheng' => 1, 'chi' => 1,
+   'chong' => 1, 'chou' => 1, 'chu' => 1,
+   'chua' => 1, 'chuai' => 1, 'chuan' => 1, 'chuang' => 1,
+   'chui' => 1, 'chun' => 1, 'chuo' => 1,
+   'ci' => 1, 'cong' => 1, 'cou' => 1,
+   'cu' => 1, 'cuan' => 1, 'cui' => 1, 'cun' => 1, 'cuo' => 1,
+   'da' => 1, 'dai' => 1, 'dan' => 1, 'dang' => 1, 'dao' => 1,
+   'de' => 1, 'dei' => 1, 'den' => 1, 'deng' => 1,
+   'di' => 1, 'dian' => 1, 'diao' => 1, 'die' => 1,
+   'ding' => 1, 'diu' => 1, 'dong' => 1, 'dou' => 1,
+   'du' => 1, 'duan' => 1, 'dui' => 1, 'dun' => 1, 'duo' => 1,
+   'e' => 1, 'ei' => 1, 'en' => 1,  'eng' => 1, 'er' => 1,
+   'fa' => 1, 'fan' => 1, 'fang' => 1,
+   'fei' => 1, 'fen' => 1, 'feng' => 1, 'fiao' => 1,
+   'fo' => 1, 'fou' => 1, 'fu' => 1,
+   'ga' => 1, 'gai' => 1, 'gan' => 1, 'gang' => 1, 'gao' => 1,
+   'ge' => 1, 'gei' => 1, 'gen' => 1, 'geng' => 1,
+   'gong' => 1, 'gou' => 1, 'gu' => 1,
+   'gua' => 1, 'guai' => 1, 'guan' => 1, 'guang' => 1, 'gui' => 1,
+   'gun' => 1, 'guo' => 1,
+   'ha' => 1, 'hai' => 1, 'han' => 1, 'hang' => 1, 'hao' => 1,
+   'he' => 1, 'hei' => 1, 'hen' => 1, 'heng' => 1,
+   'hong' => 1, 'hou' => 1,
+   'hu' => 1, 'hua' => 1, 'huai' => 1, 'huan' => 1, 'huang' => 1,
+   'hui' => 1, 'hun' => 1, 'huo' => 1,
+   'ji' => 1, 'jia' => 1, 'jian' => 1, 'jiang' => 1, 'jiao' => 1,
+   'jie' => 1, 'jin' => 1, 'jing' => 1, 'jiong' => 1, 'jiu' => 1,
+   'ju' => 1, 'juan' => 1, 'jue' => 1, 'jun' => 1,
+   'ka' => 1, 'kai' => 1, 'kan' => 1, 'kang' => 1, 'kao' => 1,
+   'ke' => 1, 'kei' => 1, 'ken' => 1, 'keng' => 1,
+   'kong' => 1, 'kou' => 1, 'ku' => 1, 'kua' => 1, 'kuai' => 1,
+   'kuan' => 1, 'kuang' => 1, 'kui' => 1, 'kun' => 1, 'kuo' => 1,
+   'la' => 1, 'lai' => 1, 'lan' => 1, 'lang' => 1, 'lao' => 1,
+   'le' => 1, 'lei' => 1, 'leng' => 1,
+   'li' => 1, 'lia' => 1, 'lian' => 1, 'liang' => 1, 'liao' => 1,
+   'lie' => 1, 'lin' => 1, 'ling' => 1, 'liu' => 1,
+   'lo' => 1, 'long' => 1, 'lou' => 1,
+   'lu' => 1, 'luan' => 1, 'lun' => 1, 'luo' => 1,
+   'lü' => 1, 'lüe' => 1,
+   'ma' => 1, 'mai' => 1, 'man' => 1, 'mang' => 1, 'mao' => 1,
+   'me' => 1, 'mei' => 1, 'men' => 1, 'meng' => 1,
+   'mi' => 1, 'mian' => 1, 'miao' => 1, 'mie' => 1,
+   'min' => 1, 'ming' => 1, 'miu' => 1,
+   'mo' => 1, 'mou' => 1, 'mu' => 1,
+   'na' => 1, 'nai' => 1, 'nan' => 1, 'nang' => 1, 'nao' => 1,
+   'ne' => 1, 'nei' => 1, 'nen' => 1, 'neng' => 1,
+   'ni' => 1, 'nian' => 1, 'niang' => 1, 'niao' => 1, 'nie' => 1,
+   'nin' => 1, 'ning' => 1, 'niu' => 1, 'nong' => 1, 'nou' => 1,
+   'nu' => 1, 'nuan' => 1, 'nun' => 1, 'nuo' => 1,
+   'nü' => 1, 'nüe' => 1,
+   'o' => 1, 'ong' => 1, 'ou' => 1,
+   'pa' => 1, 'pai' => 1, 'pan' => 1, 'pang' => 1, 'pao' => 1,
+   'pei' => 1, 'pen' => 1, 'peng' => 1,
+   'pi' => 1, 'pian' => 1, 'piao' => 1, 'pie' => 1, 'pin' => 1,
+   'ping' => 1, 'po' => 1, 'pou' => 1, 'pu' => 1,
+   'qi' => 1, 'qia' => 1, 'qian' => 1, 'qiang' => 1, 'qiao' => 1, 'qie' => 1,
+   'qin' => 1, 'qing' => 1, 'qiong' => 1, 'qiu' => 1,
+   'qu' => 1, 'quan' => 1, 'que' => 1, 'qun' => 1,
+   'ran' => 1, 'rang' => 1, 'rao' => 1, 're' => 1, 'ren' => 1,
+   'ri' => 1, 'rong' => 1, 'rou' => 1,
+   'ru' => 1, 'ruan' => 1, 'rui' => 1, 'run' => 1, 'ruo' => 1,
+   'sa' => 1, 'sai' => 1, 'san' => 1, 'sang' => 1, 'sao' => 1,
+   'se' => 1, 'sen' => 1, 'seng' => 1,
+   'sha' => 1, 'shai' => 1, 'shan' => 1, 'shang' => 1, 'shao' => 1,
+   'she' => 1, 'shei' => 1, 'shen' => 1, 'sheng' => 1, 'shi' => 1,
+   'shou' => 1, 'shu' => 1, 'shua' => 1, 'shuai' => 1, 'shuan' => 1,
+   'shuang' => 1, 'shui' => 1, 'shun' => 1, 'shuo' => 1,
+   'si' => 1, 'song' => 1, 'sou' => 1, 'su' => 1, 'suan' => 1, 'sui' => 1,
+   'sun' => 1, 'suo' => 1,
+   'ta' => 1, 'tai' => 1, 'tan' => 1, 'tang' => 1, 'tao' => 1,
+   'te' => 1, 'teng' => 1,
+   'ti' => 1, 'tian' => 1, 'tiao' => 1, 'tie' => 1, 'ting' => 1,
+   'tong' => 1, 'tou' => 1,
+   'tu' => 1, 'tuan' => 1, 'tui' => 1, 'tun' => 1, 'tuo' => 1,
+   'wa' => 1, 'wai' => 1, 'wan' => 1, 'wang' => 1,
+   'wei' => 1, 'wen' => 1, 'weng' => 1, 'wo' => 1, 'wu' => 1,
+   'xi' => 1, 'xia' => 1, 'xian' => 1, 'xiang' => 1, 'xiao' => 1,
+   'xie' => 1, 'xin' => 1, 'xing' => 1, 'xiong' => 1, 'xiu' => 1,
+   'xu' => 1, 'xuan' => 1, 'xue' => 1, 'xun' => 1,
+   'ya' => 1, 'yai' => 1, 'yan' => 1, 'yang' => 1, 'yao' => 1,
+   'ye' => 1, 'yi' => 1, 'yin' => 1, 'ying' => 1,
+   'yo' => 1, 'yong' => 1, 'you' => 1,
+   'yu' => 1, 'yuan' => 1, 'yue' => 1, 'yun' => 1,
+   'za' => 1, 'zai' => 1, 'zan' => 1, 'zang' => 1, 'zao' => 1,
+   'ze' => 1, 'zei' => 1, 'zen' => 1, 'zeng' => 1,
+   'zha' => 1, 'zhai' => 1, 'zhan' => 1, 'zhang' => 1, 'zhao' => 1,
+   'zhe' => 1, 'zhei' => 1, 'zhen' => 1, 'zheng' => 1, 'zhi' => 1,
+   'zhong' => 1, 'zhou' => 1, 'zhu' => 1, 'zhua' => 1, 'zhuai' => 1,
+   'zhuan' => 1, 'zhuang' => 1, 'zhui' => 1, 'zhun' => 1, 'zhuo' => 1,
+   'zi' => 1, 'zong' => 1, 'zou' => 1, 'zu' => 1, 'zuan' => 1,
+   'zui' => 1, 'zun' => 1, 'zuo' => 1,
+  );
 
-my $before_make;		# script before run of 'make'
-{
-  my $at = '@';
-  $before_make = 1 if '@VERSION@' eq "${at}VERSION${at}";
-}
+########################################################################
+# Unicode variables for utf8 tty (nroff)
+########################################################################
 
-my %at_at;
-my $file_gpinyin_test_pl;
-my $gpinyin_libdir;
-
-if ($before_make) {
-  my $gpinyin_source_dir = $FindBin::Bin;
-  $at_at{'BINDIR'} = $gpinyin_source_dir;
-  $at_at{'G'} = '';
-  $gpinyin_libdir = '@gpinyin_dir@';
-} else {
-  $at_at{'BINDIR'} = '@BINDIR@';
-  $at_at{'G'} = '@g@';
-  $gpinyin_libdir = '@gpinyin_dir@';
-  unshift(@INC, $gpinyin_libdir);
-}
+my %tones1_Unicode =
+  (
+   'A' => q(\\u0100),
+   'E' => q(\\u0112),
+   'I' => q(\\u012A),
+   'O' => q(\\u014C),
+   'U' => q(\\u016A),
+   'Ü' => q(\\u01D5),
+   'a' => q(\\u0101),
+   'e' => q(\\u0113),
+   'i' => q(\\u012B),
+   'o' => q(\\u014D),
+   'u' => q(\\u016B),
+   'ü' => q(\\u01D6),
+  );
+
+my %tones2_Unicode =
+  (
+   'A' => q(\\u00C1),
+   'E' => q(\\u00C9),
+   'I' => q(\\u00CD),
+   'O' => q(\\u00D3),
+   'U' => q(\\u00DA),
+   'Ü' => q(\\u01D7),
+   'a' => q(\\u00E1),
+   'e' => q(\\u00E9),
+   'i' => q(\\u00ED),
+   'o' => q(\\u00F3),
+   'u' => q(\\u00FA),
+   'ü' => q(\\u01D8),
+  );
+
+my %tones3_Unicode =
+  (
+   'A' => q(\\u01CD),
+   'E' => q(\\u011A),
+   'I' => q(\\u01CF),
+   'O' => q(\\u01D1),
+   'U' => q(\\u01D3),
+   'Ü' => q(\\u01D9),
+   'a' => q(\\u01CE),
+   'e' => q(\\u011B),
+   'i' => q(\\u01D0),
+   'o' => q(\\u01D2),
+   'u' => q(\\u01D4),
+   'ü' => q(\\u01DA),
+  );
+
+my %tones4_Unicode =
+  (
+   'A' => q(\\u00C0),
+   'E' => q(\\u00C8),
+   'I' => q(\\u00CC),
+   'O' => q(\\u00D2),
+   'U' => q(\\u00D9),
+   'Ü' => q(\\u01DB),
+   'a' => q(\\u00E0),
+   'e' => q(\\u00E8),
+   'i' => q(\\u00EC),
+   'o' => q(\\u00F2),
+   'u' => q(\\u00F9),
+   'ü' => q(\\u01DC),
+  );
+
+
+########################################################################
+# glyph variables for troff
+########################################################################
+
+#my $tone1_macron = '\\a-';
+#my $tone2_acute = '\\aa';
+#my $tone3_caron = '\\ah';
+#my $tone4_grave = '\\ga';
+my @accents = ( '', '\\a-', '\\aa', '\\ah', '\\ga', );
+
+my %tones2_glyphs =
+  (
+   'A' => q(\\'A),
+   'E' => q(\\'E),
+   'I' => q(\\'I),
+   'O' => q(\\'O),
+   'U' => q(\\'U),
+   'a' => q(\\'a),
+   'e' => q(\\'e),
+   '\\.i' => q(\\'i),
+   'o' => q(\\'o),
+   'u' => q(\\'u),
+  );
+
+my %tones4_glyphs =
+  (
+   'A' => q(\\`A),
+   'E' => q(\\`E),
+   'I' => q(\\`I),
+   'O' => q(\\`O),
+   'U' => q(\\`U),
+   'a' => q(\\`a),
+   'e' => q(\\`e),
+   '\\.i' => q(\\`i),
+   'o' => q(\\`o),
+   'u' => q(\\`u),
+  );
+
+
+
+########################################################################
+# subs
+########################################################################
+
+# Pinyin consists of syllables with a final number to be translated
+# into an accent.  Such numbered syllables are combined into words.
+# Such words can have a final punctuation.  A line is a collection of
+# such words.
+
+my @roffs = ( 'n',
+	      't',
+	    );
+
+########################################################################
+sub err {
+  my $s = shift;
+  print STDERR $s;
+  1;
+} # err()
+
+
+########################################################################
+sub handle_line {
+  my $starting_blanks = shift;
+  my $line = shift;
+
+#&err('handle_line start: ' . $line);
+
+  my %outline = ( 'n' => $starting_blanks, 't' => $starting_blanks, );
+
+  # transform to Ü only for inside of Perl
+  $line =~ s/\\
+	     \(:U
+	    /Ü/gx;
+  $line =~ s/\\
+	     \:U\
+	    /Ü/gx;
+
+# handle_line()
+
+  # transform to ü only for inside of Perl
+  $line =~ s/\\
+	     \(:u
+	    /ü/gx;
+  $line =~ s/\\
+	     \:u\
+	    /ü/gx;
+
+  $line =~ s/UeE/Ü/g;
+  $line =~ s/ueE/ü/g;
+
+  $line =~ s/\\\(aq/'/g;	# \(aq is an apostrophe
+  $line =~ s/\\\aq\/'/g;	# \aq is an apostrophe
+  $line =~ s/^'//;		# remove leading apostrophe
+  $line =~ s/'$//;		# remove final apostrophe
+  $line =~ s/''+/'/g;	# combine apostrophe groups
+  $line =~ s/(0-4)'/$1/;
+  $line =~ s/(^0-4)'/${1}0/;
+
+  my @words = split /\s+/, $line;
+
+
+# handle_line()
+  for my $word ( @words ) {
+#&err('handle_line word: ' . $word);
+
+    next unless ( $word );
+
+    # this is a word, maybe composed of several syllables
+    my $punctuation = $1 if ( $word =~ s/(,.?!:;*)$// );
+    # '$word' is now without punctuation
+
+    my %outword = &handle_word($word);
+    next unless ( %outword );
+
+    for my $roff ( @roffs ) {
+#&err('handle_line roff ' . $roff .  ': ' . $outword{$roff});
 
-require 'subs.pl';
+      # combine words to line
+      next unless ( $outword{$roff} );
+
+      # non-initial space
+      $outline{$roff} .= ' ' if ( $outline{$roff} );
+
+      $outline{$roff} .= $outword{$roff};
+      $outline{$roff} .= $punctuation;
+    }
+  }
+#for my $roff ( @roffs ) {
+#&err('handle_line end ' . $roff .  ': ' . $outline{$roff});
+#}
+  return %outline;
+} # handle_line()
+
+
+########################################################################
+sub handle_word {
+  my $word = shift;
+#&err('handle_word start: ' . $word);
+
+  $word =~ s/5/0/g;		# transform 5 to 0
+  $word =~ s/(^0-4)$/${1}0/;	# add lacking final no-tone
+
+  # remove apostrophes with tone
+  $word =~ s/
+	      (0-4)
+	      '
+	    /$1/gx;
+  # replace apostrophes without tone by 0
+  $word =~ s/
+	      (^0-4)
+	      '
+	    /${1}0/gx;
+
+# handle_word()
+  # detect wrong tone numbers
+  if ( $word =~ s/5-9/0/g ) {
+    &err('word ' . $word . ': wrong tone number ' . $1);
+    return {};
+  }
+
+  $word =~ s/'//g;		# remove apostrophes
+
+  # remove starting apostrophe or number
+  $word =~ s/^('0-4)+//;
+
+  # add 0 for final no-tone
+  $word .= '0' if ( $word =~ /^0-4$/ );
+
+  if ( $word =~ /^0-9/ ) {	# word starts with number
+    print 'word: ' . $word . ' starts with tone number';
+    $word =~ s/^0-9+//;
+  }
+#&err('handle_word 0: ' . $word);
+
+# handle_word()
+
+  my %outword = ( 'n' => '', 't' => '', );
+
+  # split word into syllables
+  while ( $word =~ /^a-zA-ZüÜ'/ ) {
+    $word =~ s/^(a-zA-ZüÜ'+)(0-4)//;
+    my $syll = $1;
+    my $tone = $2;
+#err('handle_word split: ' . $syll . ' ' . $tone);
+    my %outsyll = &handle_syll( $syll, $tone );
+    next unless ( %outsyll );
+    for my $roff ( @roffs ) {
+      my $out = $outsyll{$roff};
+      $out = '\\cq' . $out if ( $out && $out =~ /^aeo/ );
+      $outword{$roff} .= $out;
+#&err('handle_word ' . $roff . ': ' . $outword{$roff});
+    }
+  }
+  return %outword;
+} # handle_word()
+
+
+########################################################################
+sub handle_syll {
+  my $syll = shift;
+  my $tone = shift;
+#&err( 'handle_syll start: ' . $syll . ' ' . $tone);
+
+  my $lower_case = lc($syll);
+  $lower_case =~ s/Ü/ü/g;
+  unless ( exists($syllables{$lower_case}) ) {
+    err('The syllable ' . $syll . ' is not a Chinese syllable.');
+    return {};
+  }
+
+  my %outsyll = ( 'n' => '', 't' => '', );
+
+  if ( $tone == 0 ) {	# no accent
+    # use u umlaut without accent
+    $syll =~ s/Ü/\\:U/g;
+    $syll =~ s/ü/\\:u/g;
+
+    for my $roff ( @roffs ) {
+      $outsyll{$roff} = $syll;
+#&err('handle_syll 0 outsyll ' . $roff . ': ' . $outsyll{$roff});
+    }
+    return %outsyll;
+  }	# end of tone 0
+
+# handle_syll()
+
+  # split syllable
+  $syll =~
+    /^
+     (a-zA-Z*)
+     (aeiouAEIOUüÜ+)
+     (a-zA-Z*)
+     $/x;
+  my $initial = $1;
+  my $vowels = $2;
+  my $final = $3;
+  unless ( $vowels ) {
+    &err( 'Syllable ' . $syll . ' does not have vowels' );
+    return {};
+  }
+
+  # split vowels
+  my $vowels_before = '';
+  my $vowel = '';
+  my $vowels_after = '';
+
+# handle_syll()
+
+  # find vowel for accent
+  if ( $vowels =~ /^aeiouAEIOU$/ ) {		# only 1 vowel
+#&err('handle_syll single vowel ' . $vowels);
+    $vowel = $vowels;
+  } elsif ( $vowels eq 'ü' ) {
+    $vowel = $vowels;
+  } elsif ( $vowels eq 'Ü' ) {
+    $vowel = $vowels;
+  } elsif ( $vowels =~ /^(^aeAE*)(aeAE)(.*)$/ ) {	# a, A, e or E
+    $vowels_before = $1;
+    $vowel = $2;
+    $vowels_after = $3;
+  } elsif ( $vowels =~ /^(^oO*)(oO)(.*)$/ ) {		# o or O
+    $vowels_before = $1;
+    $vowel = $2;
+    $vowels_after = $3;
+  } elsif ( $vowels =~ /^(\w)(\w)(.*)$/ ) {		# take 2nd vowel
+    $vowels_before = $1;
+    $vowel = $2;
+    $vowels_after = $3;
+  } else {
+    &err( 'Unknown vowels: ' . $vowels . ' in syllable: ' . $syll );
+    return {};
+  }
+
+#  unless ( $vowel =~ /^aeiouAEIOU$/ ) {
+#    print STDERR q(The argument ') . $vowel . q(' is not a vowel!);
+#    return {};
+#  }
+
+# handle_syll()
+
+  $outsyll{'n'} = &vowel_n($vowel, $tone);
+  $outsyll{'t'} = &vowel_t($vowel, $tone);
+
+  for my $roff ( @roffs ) {
+    $outsyll{$roff} = $initial .  $vowels_before .
+      $outsyll{$roff} . $vowels_after .  $final;
+#&err('handle_syll out ' . $roff . ': ' . $outsyll{$roff});
+  }
+
+  return %outsyll;
+} # handle_syll()
+
+
+########################################################################
+sub vowel_n {	# Unicode for nroff
+  my $vowel = shift;
+  my $tone = shift;
+#&err('vowel_n: ' . $vowel . ' ' . $tone);
+
+  return '' unless ( $vowel );
+
+  my $vowel_with_tone;
+  if ( $tone == 1 ) {		# macron
+    $vowel_with_tone = $tones1_Unicode{$vowel};
+  } elsif ( $tone == 2 ) {	# acute
+    $vowel_with_tone = $tones2_Unicode{$vowel};
+  } elsif ( $tone == 3 ) {	# caron
+    $vowel_with_tone = $tones3_Unicode{$vowel};
+  } elsif ( $tone == 4 ) {	# grave
+    $vowel_with_tone = $tones4_Unicode{$vowel};
+  }
+  $vowel_with_tone or warn "failed to apply tone $tone to vowel $vowel";
+  return $vowel_with_tone;
+} # vowel_nr()
+
+
+########################################################################
+sub vowel_t {	# named glyphs for troff
+  my $vowel = shift;
+  my $tone = shift;
+#&err( 'vowel_t: ' . $vowel . ' ' . $tone);
+
+  return '' unless ( $vowel );
+
+  # \o'\s-2\:u\s0\a-'
+  if ( $vowel =~ /üÜ/ ) {
+    my ($ue, $smaller);
+    if ($vowel eq 'ü') {
+      $ue = q(\\:u);
+      $smaller = 2;
+    } else {
+      $ue = q(\\:U);
+      $smaller = 4;
+    }
+    $vowel = q(\\o'\\s-) . $smaller . $ue . q(\\s0) .
+      $accents$tone . q(');
+    return $vowel;
+  }
+
+  $vowel = q(\\.i) if ( $vowel eq 'i' );
+
+  my $vowel_with_tone;
+  if ( $tone == 1 ) {		# macron
+    $vowel_with_tone = q(\\o') . $vowel . $accents$tone . q(');
+  } elsif ( $tone == 2 ) {	# acute
+    $vowel_with_tone = $tones2_glyphs{$vowel};
+  } elsif ( $tone == 3 ) {	# caron
+    $vowel_with_tone = q(\\o') . $vowel . $accents$tone . q(');
+  } elsif ( $tone == 4 ) {	# grave
+    $vowel_with_tone = $tones4_glyphs{$vowel};
+  }
+  $vowel_with_tone or warn "failed to apply tone $tone to vowel $vowel";
+  return $vowel_with_tone;
+} # vowel_t()
+
+
+########################################################################
+sub finish_pinyin_mode {
+#&err( 'finish' );
+  my $n = shift;
+  my $t = shift;
+  push @$n, '\\}';
+  push @$t, '\\}';
+
+  for ( @$n ) {	# Unicode for nroff
+    print;
+  }
+
+  for ( @$t ) {	# glyphs for troff
+    print;
+  }
+
+  1;
+} # finish_pinyin_mode()
 
 
 ########################################################################
@@ -104,7 +627,7 @@
       q(pinyin parts in 'roff' files.);
     exit;
   } elsif (/^(-v|--v|--ve|--ver|--vers|--versi|--versio|--version)$/) {
-    print q('gpinyin' version ) . $version;
+    print "gpinyin ${groff_version}version $version";
     exit;
   }
 }
@@ -126,53 +649,63 @@
    '.el \\{\\',
   );
 
-foreach (<>) {	# get line from input
-  chomp;
-  s/\s+$//;		# remove final spaces
-# &err('gpinyin: ' . $_);
-
-  my $line = $_;	# with starting blanks
-
-  # .pinyin start or begin line
-  if ( $line =~ /^.'\s*pinyin\s+(start|begin)$/ ) {
-    if ( $pinyin_mode ) {
-      # '.pinyin' was started twice, ignore
-      &err( q'.pinyin' starter was run several times );
-    } else {	# new pinyin start
-      $pinyin_mode = 1;
-    }
+unshift @ARGV, '-' unless @ARGV;
+foreach my $filename (@ARGV) {
+  my $input;
+  if ($filename eq '-') {
+    $input = \*STDIN;
+  } elsif (not open $input, '<', $filename) {
+    warn $!;
     next;
   }
+  while (<$input>) {
+    chomp;
+    s/\s+$//;		# remove final spaces
+#   &err('gpinyin: ' . $_);
+
+    my $line = $_;	# with starting blanks
+
+    # .pinyin start or begin line
+    if ( $line =~ /^.'\s*pinyin\s+(start|begin)$/ ) {
+      if ( $pinyin_mode ) {
+        # '.pinyin' was started twice, ignore
+        &err( q'.pinyin' starter was run several times );
+      } else {	# new pinyin start
+        $pinyin_mode = 1;
+      }
+      next;
+    }
 
-  # .pinyin stop or end line
-  if ( $line =~ /^.'\s*pinyin\s+(stop|end)$/ ) {
-    if ( $pinyin_mode ) {		# normal stop
-      $pinyin_mode = 0;
-      &finish_pinyin_mode( \@output_n, \@output_t );
-    } else {	# ignore
-      &err( 'gpinyin: there was a .pinyin stop without ' .
-	'being in pinyin mode' );
+    # .pinyin stop or end line
+    if ( $line =~ /^.'\s*pinyin\s+(stop|end)$/ ) {
+      if ( $pinyin_mode ) {		# normal stop
+        $pinyin_mode = 0;
+        &finish_pinyin_mode( \@output_n, \@output_t );
+      } else {	# ignore
+        &err( 'gpinyin: there was a .pinyin stop without ' .
+          'being in pinyin mode' );
+      }
+      next;
     }
-    next;
-  }
 
-  # now not a .pinyin line
+    # now not a .pinyin line
 
 
-  if ( $pinyin_mode ) {	# within Pinyin
-    my $starting_blanks = '';
-    $starting_blanks = $1 if ( s/^(s+)// );	# handle starting spaces
+    if ( $pinyin_mode ) {	# within Pinyin
+      my $starting_blanks = '';
+      $starting_blanks = $1 if ( s/^(s+)// );	# handle starting spaces
 
-    my %outline = &handle_line($starting_blanks, $line);
-#&err('gpinyin outline n: ' . $outline{'n'} );
-#&err('gpinyin outline t: ' . $outline{'t'} );
-    push @output_n, $outline{'n'};
-    push @output_t, $outline{'t'};
-  } else {	# normal roff line, not within Pinyin
-    print $line;
-  }
-  next;
-}	# end of input line
+      my %outline = &handle_line($starting_blanks, $line);
+#     &err('gpinyin outline n: ' . $outline{'n'} );
+#     &err('gpinyin outline t: ' . $outline{'t'} );
+      push @output_n, $outline{'n'};
+      push @output_t, $outline{'t'};
+    } else {	# normal roff line, not within Pinyin
+      print $line;
+    }
+    next;
+  }	# end of input line
+}
 
 
 ########################################################################
@@ -185,8 +718,8 @@
 
 
 1;
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: CPerl
 # End:
+# vim: set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/grap2graph/grap2graph.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/grap2graph/grap2graph.1.man Changed

@@ -1,6 +1,8 @@
-.TH GRAP2GRAPH @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grap2graph \- convert a GRAP diagram into a cropped image
+.TH grap2graph @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grap2graph \- convert a
+.I grap
+diagram into a cropped image
 .
 .
 .\" ====================================================================
@@ -10,34 +12,58 @@
 .\" This documentation is released to the public domain.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grap2graph_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grap2graph
-.OP \-unsafe
-.OP \-format output-format
-.RI  convert-arguments 
+.RB  \-unsafe 
+.RB  \-format\~\c
+.IR output-format 
+.RI  convert-argument \~.\|.\|.
 .YS
 .
+.
 .SY grap2graph
 .B \-\-help
 .YS
 .
+.
 .SY grap2graph
 .B \-v
+.
 .SY grap2graph
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I grap2graph
 reads a
-.IR grap (1)
+.MR grap 1
 program from the standard input and writes an image file,
 by default in Portable Network Graphics (PNG) format,
 to the standard output.
@@ -47,11 +73,11 @@
 The input GRAP code should
 .I not
 be wrapped with the
-.B \&.G1
+.B .G1
 and
-.B \&.G2
+.B .G2
 macros that normally guard it within
-.IR groff (@MAN1EXT@)
+.MR groff @MAN1EXT@
 documents.
 .
 .
@@ -65,7 +91,7 @@
 Arguments not recognized by
 .I grap2graph
 are passed to the ImageMagick or GraphicsMagick program
-.IR \%convert (1).
+.MR convert 1 .
 .
 .
 By specifying these, you can give your image a border,
@@ -84,11 +110,21 @@
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
 .TP
-.BI "\-format " output-format
+.BI \-format\~ output-format
 Write the image in
 .IR output-format ,
 which must be understood by
@@ -97,11 +133,6 @@
 .
 .
 .TP
-.B \-\-help
-Display a usage message and exit.
-.
-.
-.TP
 .B \-unsafe
 Run
 .I groff
@@ -116,15 +147,8 @@
 default is to forbid this.
 .
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
-.
-.
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
@@ -144,32 +168,38 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
-.B grap2graph
+.I grap2graph
 was written by
-.MT esr@\:thyrsus.com
+.MT esr@\:thyrsus\:.com
 Eric S.\& Raymond
 .ME ,
 based on a recipe for
-.IR pic2graph (@MAN1EXT@),
+.MR pic2graph @MAN1EXT@ ,
 by W.\& Richard Stevens.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR pic2graph (@MAN1EXT@),
-.IR eqn2graph (@MAN1EXT@),
-.IR grap (1),
-.IR @g@pic (@MAN1EXT@),
-.IR groff (@MAN1EXT@),
-.IR \%convert (1)
+.MR pic2graph @MAN1EXT@ ,
+.MR eqn2graph @MAN1EXT@ ,
+.MR grap 1 ,
+.MR @g@pic @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR convert 1
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_grap2graph_1_man_C
+.do rr *groff_grap2graph_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/grap2graph/grap2graph.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/grap2graph/grap2graph.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/ChangeLog Changed

@@ -1,3 +1,83 @@
+2022-06-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am (HDTBLPROCESSEDEXAMPLEFILES): Add dependency on
+	grops.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am (HDTBLPROCESSEDEXAMPLEFILES): Add dependency on devps
+	stamp file since the files' target rule generates PostScript
+	with groff.
+
+2022-04-12  Ingo Schwarze <schwarze@openbsd.org>
+
+	Delete the harmful, ill-designed, buggy, and essentially
+	unmaintained and untested --with-doc option of the configure
+	script.  See the NEWS file for more details on the rationale.
+
+	* hdtbl.am: Delete two BUILD_EXAMPLES conditionals.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am: Eliminate `HDTBL_TFLAG` and `HDTBL_PFLAG` Make
+	macros; they were expanded in only one place.
+	(HDTBLGROFF): Track rename of Make macro `TFLAG` to `MFLAG`.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* examples/mixed_pickles.ms: Die horribly if `PSPIC` call fails.
+
+2022-03-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am (nodist_hdtblexample_DATA,
+	HDTBLPROCESSEDEXAMPLEFILES): Replace hard-coded "gnu.eps" file
+	name with expansion of `DOC_GNU_EPS`.
+	(HDTBLPROCESSEDEXAMPLEFILES): Pass `-I` option to `HDTBLGROFF`
+	to enable location of "gnu.eps" file (for "mixedpickles.roff"
+	document).
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am:
+	(hdtbl_test_template): Pull file name into a new variable.
+	(EXTRA_DIST, contrib/hdtbl/examples/test-hdtbl.sh): Use it.
+	(contrib/hdtbl/examples/test-hdtbl.sh): Build more quietly;
+	prefix rule with `$(AM_V_GEN)`.  Also run `chmod` conditionally.
+
+2021-07-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* hdtbl.am: Remove unnecessary Make variable.
+	(hdtbl_builddir): Delete.
+	(HDTBL_TFLAG): Remove `-M$(hdtbl_builddir)` option; it's no
+	longer needed for hdtbl example document generation needed now
+	that hdtbl is no longer stripped.
+
+2021-07-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Skip the stripper, part 2/3 ("hdtbl").
+
+	* hdmisc.tmac-u: Rename to...
+	* hdmisc.tmac: ...this.
+
+	* hdtbl.tmac-u: Rename to...
+	* hdtbl.tmac: ...this.
+
+	* hdtbl.am (HDSTRIPFILES): Rename to...
+	(HDTBLTMACFILES): ...this.
+	(hdtbltmac_DATA): Rename to...
+	(dist_hdtbltmac_DATA): ...this.
+	(MOSTLYCLEANFILES): Drop $(HDTBLSTRIPFILES).
+	($(HDTBLSTRIPFILES)): Drop target.
+
+2018-12-26  Ingo Schwarze  <schwarze@openbsd.org>
+
+	A missing prerequisite could cause parallel builds to fail.
+
+	* hdtbl.am (HDTBLPROCESSEDEXAMPLEFILES): requires eqn
+	because the .roff.ps target runs HDTBLGROFF =
+	GROFFBIN ... HDTBL_PFLAG = groff ... -t -p -e -U
+	which includes -e.
+
 2018-12-06  Ingo Schwarze  <schwarze@openbsd.org>
 
 	* examples/fonts_n.in, examples/fonts_x.in:
@@ -453,14 +533,16 @@
 
 ________________________________________________________________________
 
-Copyright 2006-2018 Free Software Foundation, Inc.
+Copyright 2006-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
-mode: change-log
 coding: latin-1
+fill-column: 72
+mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/chess_board.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/chess_board.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/col_rowspan_colors.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/col_rowspan_colors.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/color_boxes.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/color_boxes.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/color_nested_tables.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/color_nested_tables.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/color_table_cells.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/color_table_cells.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/color_transitions.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/color_transitions.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/common.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/common.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/fonts_n.in -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/fonts_n.in Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/fonts_x.in -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/fonts_x.in Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/mixed_pickles.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/mixed_pickles.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/rainbow.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/rainbow.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/examples/short_reference.roff -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/examples/short_reference.roff Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/groff_hdtbl.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/groff_hdtbl.7.man Changed

@@ -1,18 +1,14 @@
-.TH GROFF_HDTBL @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_hdtbl \- Heidelberger table macros for GNU roff
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_hdtbl_C \n.C
-.cp 0
+.TH groff_hdtbl @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_hdtbl \- Heidelberger table macros for GNU
+.I roff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2005-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2005-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -26,11 +22,31 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_hdtbl_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .ig
   Some simple formatting macros.  Note that we use '.ig' here and not a
   comment to make 'mandb' 2.4.1 (and probably more recent versions also)
-  happy; otherwise the '.char' lines and the stuff which follows is included
-  in the 'whatis' database.
+  happy; otherwise the '.char' lines and the stuff which follows is
+  included in the 'whatis' database.
 ..
 .
 .
@@ -68,6 +84,7 @@
 .      fam C
 .      \\$2 \&\\\\$*\F\F\\\\*old-fam
 .      fam
+.      rm old-fam
 \\..
 .  .
 .
@@ -81,6 +98,7 @@
 .      fam C
 .      \\$1 \\\\$@ \F\F\\\\*old-fam
 .      fam
+.      rm old-fam
 \\..
 .  .
 .
@@ -129,7 +147,10 @@
 .
 .de XAA
 .  TQ
-.  CRI \\$@
+.  ie (\\n.$ < 2) \
+.    CR \\$@
+.  el \
+.    CRI \\$@
 ..
 .
 .
@@ -162,84 +183,87 @@
 ..
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 The
-.B hdtbl
-macros consist of four base and three optional macros, controlled by about
-twenty arguments.
+.I hdtbl
+macros consist of four base and three optional macros,
+controlled by about twenty arguments.
 .
-The syntax is simple and similar to the
-.B HTML
-table model and nearly as flexible: You can write sequences of tokens (macro
-calls with their arguments and content data), separated by blanks and
-beginning with a macro call, into the same line to get compact and cleanly
-arrranged input.
+The syntax is simple and similar to the HTML table model and nearly as
+flexible:
+you can write sequences of tokens
+(macro calls with their arguments and content data),
+separated by blanks and beginning with a macro call,
+into the same line to get compact and cleanly arrranged input.
 .
 An advantage of
-.B hdtbl
-is that the tables are constructed without calling a preprocessor; this
-means that
-.BR groff 's
+.I hdtbl
+is that the tables are constructed without calling a preprocessor;
+this means that
+.MR groff @MAN7EXT@ 's
 full macro capabilities are available.
 .
-On the other hand, table processing with
-.B hdtbl
+On the other hand,
+table processing with
+.I hdtbl
 is much slower than using the
-.BR tbl (@MAN1EXT@)
+.MR @g@tbl @MAN1EXT@
 preprocessor.
 .
 A further advantage is that the HTML-like syntax of
-.B hdtbl
-will be easily converted to HTML; this is not implemented yet.
+.I hdtbl
+will be easily converted to HTML;
+this is not implemented yet.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
 In this and the next section, we present examples to help users
 understand the basic workflow of
-.BR hdtbl .
+.IR hdtbl .
 .
 First of all, you must load the
 .I hdtbl.tmac
 file.
 .
-As with nearly all other groff macro packages, there are two possibilities
-to do so:
+As with nearly all other
+.I groff
+macro packages,
+there are two possibilities to do so:
 .
 Either add the line
 .
+.
 .PP
-.nf
-.nh
 .RS
-.CR .mso hdtbl.tmac
-.fi
-.hy
+.EX
+\&.mso hdtbl.tmac
+.EE
 .RE
 .
+.
 .PP
 to your
 .I roff
 file before using any macros of the
-.B hdtbl
+.I hdtbl
 package, or add the option
 .
 .PP
-.nf
-.nh
 .RS
-.CR \-m hdtbl
-.fi
-.hy
+.EX
+\-m hdtbl
+.EE
 .RE
 .
+.
 .PP
 to the command line of groff (before the document file which contains
-.B hdtbl
+.I hdtbl
 macros).
 .
 Then you can include on or more tables in your document, where each one
@@ -251,11 +275,15 @@
 .
 .
 .PP
-In this man page, we approximate the result of each example in the
-.I tty
-format to be as generic as possible since
-.B hdtbl
-currently only supports the PS and PDF output devices.
+In this man page,
+we approximate the result of each example as terminal output to be as
+generic as possible since
+.I hdtbl
+currently only supports the
+.B ps
+and
+.B pdf
+output drivers.
 .
 .
 .PP
@@ -264,49 +292,46 @@
 .
 Here we construct a table with only one cell.
 .
+.
 .PP
 .RS
-.nf
-.nh
-.CR .TBL
-.CR .TR
-.CR .TD
-.CI contents of the table cell
-.CR .ETB
-.fi
-.hy
+.EX
+\&.TBL
+\&.TR
+\&.TD
+.I contents of the table cell
+\&.ETB
+.EE
 .RE
 .
 .
 .PP
-A
-.I tty
-representation is
+A terminal representation is
+.
 .
 .PP
-.nf
-.nh
-.ft CR
+.if t .ne 3v
 .RS
+.EX
+.tr -\-
 +------------------------------------------------------+
-| contents-of-the-table-cell                           |
+.\" That's 27 spaces below.
+.RI "| " contents-of-the-table-cell "                           |"
 +------------------------------------------------------+
+.tr --
+.EE
 .RE
-.ft
-.hy
-.fi
 .
 .
 .PP
 Equivalent to the above is the following notation.
 .
+.
 .PP
 .RS
-.nh
-.nf
-.CRI ".TBL .TR .TD \dq" "contents of the table cell" "\dq .ETB"
-.fi
-.hy
+.EX
+.RI ".TBL .TR .TD \dq" "contents of the table cell" "\dq .ETB"
+.EE
 .RE
 .
 .
@@ -329,37 +354,32 @@
 .
 .PP
 .RS
-.nf
-.nh
-.CR ".TBL cols=2"
-.CR ".  TR .TD 1*1 .TD 1*2"
-.CR ".  TR .TD 2*1 .TD 2*2"
-.CR ".ETB"
-.fi
-.hy
+.EX
+\&.TBL cols=2
+\&.\&  TR .TD 1*1 .TD 1*2
+\&.\&  TR .TD 2*1 .TD 2*2
+\&.ETB
+.EE
 .RE
 .
 .
 .PP
-A
-.I tty
-representation is
+A terminal representation is
 .
 .
 .PP
-.nf
-.nh
-.ft CR
+.if t .ne 5v
 .RS
+.EX
+.tr -\-
 +--------------------------+---------------------------+
 | 1*1                      | 1*2                       |
 +--------------------------+---------------------------+
 | 2*1                      | 2*2                       |
 +--------------------------+---------------------------+
+.tr --
+.EE
 .RE
-.ft
-.hy
-.fi
 .
 .
 .PP
@@ -372,11 +392,13 @@
 .
 .
 .PP
-The contents of a table cell is arbitrary; for example, it can be another
-table, without restriction to the nesting depth.
+The contents of a table cell is arbitrary;
+for example,
+it can be another table,
+without restriction to the nesting depth.
 .
-A given table layout can be either constructed with suitably nested tables
-or with proper arguments to
+A given table layout can be either constructed with suitably nested
+tables or with proper arguments to
 .CR .TD
 and
 .CR .TH\c
@@ -384,49 +406,49 @@
 .
 Note, however, that this table
 .
+.
 .PP
 .RS
-.nf
-.nh
-.CR ".TBL"
-.CR ".  TR"
-.CR ".    TD"
-.CR ".      nop 1*1 1*2"
-.CR ".  TR"
-.CR ".    TD"
-.CR ".      TBL cols=2 border="
-.CR ".        TR"
-.CR ".          TD"
-.CR ".            nop 2*1"
-.CR ".          TD"
-.CR ".            nop 2*2"
-.CR ".      ETB"
-.CR ".ETB"
-.fi
-.hy
+.EX
+\&.TBL
+\&.\&  TR
+\&.\&    TD
+\&.\&      nop 1*1 1*2
+\&.\&  TR
+\&.\&    TD
+\&.\&      TBL cols=2 border=
+\&.\&        TR
+\&.\&          TD
+\&.\&            nop 2*1
+\&.\&          TD
+\&.\&            nop 2*2
+\&.\&      ETB
+\&.ETB
+.EE
 .RE
 .
+.
 .PP
 and this table
 .
+.
 .PP
 .RS
-.nf
-.nh
-.CR ".TBL cols=2"
-.CR ".  TR"
-.CR ".    TD colspan=2"
-.CR ".      nop 1*1 1*2"
-.CR ".  TR"
-.CR ".    TD"
-.CR ".      nop 2*1"
-.CR ".    TD"
-.CR ".      nop 2*2"
-.CR ".ETB"
-.fi
-.hy
+.EX
+\&.TBL cols=2
+\&.\&  TR
+\&.\&    TD colspan=2
+\&.\&      nop 1*1 1*2
+\&.\&  TR
+\&.\&    TD
+\&.\&      nop 2*1
+\&.\&    TD
+\&.\&      nop 2*2
+\&.ETB
+.EE
 .RE
 .
+.
 .PP
 are similar but not identical (the use of
 .CR .nop
@@ -437,10 +459,10 @@
 The first table looks like
 .
 .PP
-.nf
-.nh
-.ft CR
+.if t .ne 7v
 .RS
+.EX
+.tr -\-
 +------------------------------------------------------+
 | 1*1 1*2                                              |
 +------------------------------------------------------+
@@ -448,57 +470,58 @@
 | 2*1                         2*2                      |
 |                                                      |
 +------------------------------------------------------+
+.tr --
+.EE
 .RE
-.ft
-.hy
-.fi
+.
 .
 .PP
 and the second one like
 .
+.
 .PP
-.nf
-.nh
-.ft CR
+.if t .ne 5v
 .RS
+.EX
+.tr -\-
 +------------------------------------------------------+
 | 1*1 1*2                                              |
 +---------------------------+--------------------------+
 | 2*1                       | 2*2                      |
 +---------------------------+--------------------------+
+.tr --
+.EE
 .RE
-.ft
-.hy
-.fi
+.
 .
 .PP
-Here the latter table in a more compact form.
+Here is the latter table in a more compact form.
 .
 .PP
 .RS
-.nf
-.nh
-.CR ".TBL cols=2 .TR \dq.TD colspan=2\dq 1*1 1*2"
-.CR ".            TR .TD 2*1 .TD 2*2 .ETB"
-.fi
-.hy
+.EX
+\&.TBL cols=2 .TR \dq.TD colspan=2\dq 1*1 1*2
+\&.\&            TR .TD 2*1 .TD 2*2 .ETB
+.EE
 .RE
 .
 .
 .PP
-If a macro has one or more arguments (see below), and it is not starting a
-line, everything belonging to this macro including the macro itself must be
+If a macro has one or more arguments
+(see below),
+and it is not starting a line,
+everything belonging to this macro including the macro itself must be
 enclosed in double quotes.
 .
 .
 .\" ====================================================================
-.SH MACROS AND ARGUMENTS
+.SH "Macros and arguments"
 .\" ====================================================================
 .
 The order of macro calls and other tokens follows the HTML model.
 .
 In the following list, valid predecessors and successors of all
-.B hdtbl
+.I hdtbl
 macros are given, together with the possible arguments.
 .
 .PP
@@ -535,15 +558,16 @@
 .
 .
 .PP
-However, this is limited to the case where the macro is the first one in the
-line and not already enclosed in double quotes.
+However,
+this is limited to the case where the macro is the first one in the line
+and not already enclosed in double quotes.
 .
 .
 .PP
 Argument values specified below as\~\c
 .CI c
 are colors predefined by
-.B groff
+.I groff
 or colors defined by the user with the
 .CR .defcolor
 request.
@@ -559,7 +583,7 @@
 Argument values\~\c
 .CI n
 are numerical values with the usual
-.B groff
+.I groff
 scaling indicators.
 .
 Some of the arguments are specific to one or two macros, but most of
@@ -614,7 +638,8 @@
 .XAA cols= m
 Number of table columns.
 .
-This argument is necessary if more than one column is in the table and no
+This argument is necessary if more than one column is in the table and
+no
 .CR \oqwidth\cq
 arguments are present.
 .
@@ -657,11 +682,12 @@
 .CI n
 or natural numbers with the pseudo-scaling indicator
 .CR \oq%\cq\c
-, with the meaning \lqpercent of the actual line length (or column length
-for inner tables, respectively)\rq.
+, with the meaning \lqpercent of the actual line length
+(or column length for inner tables,
+respectively)\rq.
 .
-If there are less width values than table columns, the last width value is
-used for the remaining cells.
+If there are less width values than table columns,
+the last width value is used for the remaining cells.
 .
 The argument
 .
@@ -675,8 +701,8 @@
 remaining columns take 1/10 of the column length each.
 .
 .XDEF
-The table width equals the outer line length or column length; the columns
-have equal widths.
+The table width equals the outer line length or column length;
+the columns have equal widths.
 .
 .XAA height= n
 Height of the table.
@@ -789,49 +815,48 @@
 .
 .IP
 .B Remark:
-Overlapping of column and row spanning, as in the following table fragment
-(the overlapping happens in the second cell in the second row), is invalid
-and causes incorrect results.
+Overlapping of column and row spanning,
+as in the following table fragment
+(the overlapping happens in the second cell in the second row),
+is invalid and causes incorrect results.
+.
 .
 .RS
 .IP
-.nh
-.nf
-.CR ".TR .TD 1*1 \dq.TD 1*2 rowspan=2\dq .TD 1*3"
-.CR ".TR \dq.TD 2*1 colspan=2\dq         .TD 2*3"
-.fi
-.hy
+.EX
+\&.TR .TD 1*1 \dq.TD 1*2 rowspan=2\dq .TD 1*3
+\&.TR \dq.TD 2*1 colspan=2\dq         .TD 2*3
+.EE
 .RE
 .
+.
 .PP
 A working example for headers and cells with
 .B colspan
 is
 .
+.
 .PP
 .RS
-.nf
-.nh
-.CR .TBL cols=3
-.CR ".  TR" \dq.TH colspan=2\dq header1+2 .TH header3
-.CR ".  TR" .TD 1*1 .TD 1*2 .TD 1*3
-.CR ".  TR" .TD 2*1 \dq.TD colspan=2\dq 2*2+3
-.CR .ETB
-.fi
-.hy
+.EX
+\&.TBL cols=3
+\&.\&  TR \dq.TH colspan=2\dq header1+2 .TH header3
+\&.\&  TR .TD 1*1 .TD 1*2 .TD 1*3
+\&.\&  TR .TD 2*1 \dq.TD colspan=2\dq 2*2+3
+\&.ETB
+.EE
 .RE
 .
+.
 .PP
 This looks like
 .
+.
 .PP
-.ft CR
-.if t \{\
-.  ne 7v
-.\}
+.if t .ne 7v
 .RS
-.nf
-.nh
+.EX
+.tr -\-
 +------------------------------+---------------+
 |          header1+2           |    header3    |
 +--------------+---------------+---------------+
@@ -839,57 +864,57 @@
 +--------------+---------------+---------------+
 | 2*1          | 2*2+3                         |
 +--------------+-------------------------------+
+.tr --
+.EE
 .RE
-.ft
-.hy
-.fi
+.
 .
 .PP
 A working example with
 .B rowspan
 is
 .
+.
 .PP
 .RS
-.nf
-.nh
-.CR .TBL cols=3
-.CR ".  TR"
-.CR ".  TD" 1*1
-.CR ".  TD" rowspan=2 1+2*2
-.CR ".  TD" 1*3
-.CR .
-.CR ".  TR"
-.CR ".  TD" 2*1
-.CR ".  TD" 2*3
-.CR .ETB
-.fi
-.hy
+.EX
+\&.TBL cols=3
+\&.\&  TR
+\&.\&  TD 1*1
+\&.\&  TD rowspan=2 1+2*2
+\&.\&  TD 1*3
+\&.\&
+\&.\&  TR
+\&.\&  TD 2*1
+\&.\&  TD 2*3
+\&.ETB
+.EE
 .RE
 .
+.
 .PP
 which looks like
 .
+.
 .PP
-.ft CR
+.if t .ne 5v
 .RS
-.nf
-.nh
+.EX
+.tr -\-
 +--------------+---------------+---------------+
 | 1*1          | 1+2*2         | 1*3           |
 +--------------+               +---------------+
 | 2*1          |               | 2*3           |
 +--------------+---------------+---------------+
-.hy
-.fi
+.tr --
+.EE
 .RE
-.ft CR
-.
 .RE
 .RE
 .
 .\"==================================================================
 .
+.
 .TP
 .CB ".ETB \lBhold\rB"
 End of the table.
@@ -905,9 +930,9 @@
 .CR \oqhold\cq
 is given, the table is held until it is freed by calling the macro
 .CR .t*free\c
-, which in turn prints the table immediately, either at the current position
-or at the top of the next page if its height is larger than the remaining
-space on the page.
+, which in turn prints the table immediately,
+either at the current position or at the top of the next page if its
+height is larger than the remaining space on the page.
 .
 .IP \bu 3
 Otherwise, if the table is higher than the remaining space on the page,
@@ -952,7 +977,8 @@
 .
 .
 .\" ====================================================================
-.SS "Arguments common to \fCB.TBL\f, \fCB.TR\f, \fCB.TD\f, and \fCB.TH\f"
+.SS "Arguments common to \fCB.TBL\f, \fCB.TR\f, \fCB.TD\f, \
+and \fCB.TH\f"
 .\" ====================================================================
 .
 The arguments described in this section can be specified with the
@@ -961,8 +987,11 @@
 .CR .TR
 macros, but they are eventually passed on to the table cells.
 .
-If omitted, the defaults take place, which the user can change by setting
-the corresponding default registers or strings, as documented below.
+If omitted,
+the defaults take place,
+which the user can change by setting the corresponding default registers
+or strings,
+as documented below.
 .
 Setting an argument with the
 .CR .TBL
@@ -1000,11 +1029,14 @@
 The font family for the table.
 .
 .CI name
-is one of the groff font families, for example
+is a
+.I groff
+font family identifier,
+such as
 .CR A
-for the AvantGarde fonts or
+for Avant Garde or
 .CR HN
-for Helvetica-Narrow.
+for Helvetica Narrow.
 .
 .XDEF
 The font family found before the table (string
@@ -1025,15 +1057,17 @@
 for roman,
 .BR bold ,
 .IR italic ,
-or \fBIbold italic\f, respectively.
+or \fBIbold italic\f, \" \fBI is not portable man(7)
+respectively.
 .
 As with
-.BR roff 's
-.CR .ft
-request the
+.IR roff 's
+.B .ft
+request,
+the
 .CR \oqfst\cq
-argument can be used to specify the font family and font style together, for
-example
+argument can be used to specify the font family and font style together,
+for example
 .CR \oqfst=HNBI\cq
 instead of
 .CR \oqff=HN\cq
@@ -1114,7 +1148,8 @@
 : a double separator line.
 .
 .IP
-The thickness of the separator lines is the half of the border thickness,
+The thickness of the separator lines is the half of the border
+thickness,
 but at least 0.1\~inches.
 .
 The distance between the double lines is equal to the line thickness.
@@ -1125,8 +1160,8 @@
 .CR \oqborder=0\cq
 for proper formatting the value of
 .CR \oqcsp\cq
-must be at least .05\~inches for single separator lines and .15\~inches for
-double separator lines.
+must be at least \&.05\~inches for single separator lines and
+\&.15\~inches for double separator lines.
 .
 .XDEFS hl=s t*hl
 .
@@ -1156,7 +1191,7 @@
 .
 .
 .\" ====================================================================
-.SH HDTBL CUSTOMIZATION
+.SH "\fIhdtbl\f customization"
 .\" ====================================================================
 .
 .PP
@@ -1164,20 +1199,22 @@
 to minimize the markup needed in each table.
 .
 The following example sets up defaults suitable for typical papers:
+.
+.
 .PP
 .RS
-.nf
-.CR ".ds t*bgc white\e\dq background color
-.CR ".ds t*fgc black\e\dq foreground color
-.CR ".ds t*bc black\e\dq  border color
-.CR ".nr t*cpd 0.1n\e\dq  cell padding
-.fi
+.EX
+\&.ds t*bgc white\rs\dq background color
+\&.ds t*fgc black\rs\dq foreground color
+\&.ds t*bc black\rs\dq  border color
+\&.nr t*cpd 0.1n\rs\dq  cell padding
+.EE
 .RE
 .
 .
 .PP
 The file
-.B examples/common.roff
+.I @EXAMPLEDIR@/\:hdtbl/\:\%common\:.roff
 provides another example setup
 in the \lqminimal Page setup\rq section.
 .
@@ -1191,19 +1228,20 @@
 .
 For example, say
 .
+.
 .PP
 .RS
-.nf
-.CR ".am pg@top"
-.CR ".  t*hm"
-.CR ".."
-.fi
+.EX
+\&.am pg@top
+\&.\&  t*hm
+\&..
+.EE
 .RE
 .
 .
 .PP
 if you use the
-.B ms
+.I ms
 macro package.
 .
 .
@@ -1215,81 +1253,94 @@
 .CR ETB
 macros (table not closed).
 .
-You can append this macro
-to the \lqend\rq macro of your document's main macro package.
+You can call this macro by appending it the to end-of-input macro of
+the main,
+or \lqfull-service\rq,
+macro package your document uses.
+.
+For example,
+try
 .
-For example:
 .
-.PP
 .RS
-.nf
-.nh
-.CR ".am pg@end-text"
-.CR ".  t*EM"
-.CR ".."
-.fi
-.hy
+.EX
+\&.am pg@end\-text
+\&.\&  t*EM
+\&..
+.EE
 .RE
 .
-.PP
-If you use the
-.B ms
-macro package.
+if you use the
+.I ms
+package.
 .
 .
 .\" ====================================================================
-.SH BUGS AND SUGGESTIONS
+.SH "Bugs and suggestions"
 .\" ====================================================================
 .
-Please send your commments to the
-.MT groff@\:gnu.org
-groff mailing list
+Please send your comments to the
+.MT groff@\:gnu\:.org
+.I groff
+mailing list
 .ME
 or directly to the author.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 The
-.B hdtbl
+.I hdtbl
 macro package was written by
-.MT Joachim.Walsdorff@\:urz.uni\-heidelberg.de
+.MT Joachim\:.Walsdorff@\:urz\:.uni\-heidelberg\:.de
 Joachim Walsdorff
 .ME .
 .
 .
 .\" ====================================================================
-.SH SEE ALSO
+.SH "See also"
 .\" ====================================================================
+.
 .TP
-.BR groff (1)
+.MR groff @MAN1EXT@
 provides an overview of GNU
 .I roff
 and details how to invoke
 .I groff
 at the command line.
+.
+.
 .TP
-.BR groff (7)
+.MR groff @MAN7EXT@
 summarizes the
 .I roff
 language and GNU extensions to it.
+.
+.
 .TP
-.BR tbl (1)
+.MR @g@tbl @MAN1EXT@
 describes the traditional
 .I roff
 preprocessor for tables.
 .
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_hdtbl_C
+.\" Unwind (some of) the stuff we've done.
+.rchar \lB
+.rchar \rB
+.rchar \or
+.rchar \ell
+.rchar \oq
+.rchar \cq
 .
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_hdtbl_7_man_C
+.do rr *groff_groff_hdtbl_7_man_C
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/hdmisc.tmac Added

@@ -0,0 +1,327 @@
+.ig
+
+hdmisc.tmac
+
+This file is part of groff, the GNU roff type-setting system.
+
+Copyright (C) 2005-2020 Free Software Foundation, Inc.
+written by Joachim Walsdorff <Joachim.Walsdorff@urz.uni-heidelberg.de>.
+
+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
+(at your option) any later version.
+
+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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+..
+.
+.
+.if d t*getarg \
+.  nx
+.
+.
+.\"	******************************************************************
+.\"	**	Some macros and default settings needed by hdtbl	**
+.\"	******************************************************************
+.
+.
+.\"	Utility macro:	.getarg <key> ...
+.\"
+.\"		Get macro argument.  This macro searches <key> in the
+.\"		remaining arguments and assigns its value to a string
+.\"		register named <key>.  The following syntax forms are
+.\"		recognized.
+.\"
+.\"			<key>=<val>	Assign <val> to string <key>.
+.\"					<val> must not contain spaces.
+.\"			<key>='<val>'	Assign <val> to string <key>.
+.\"					<val> can contain spaces.
+.\"			<key>=		Assign '=' to string <key>.
+.\"			<key>		Assign 'key' to string <key>.
+.\"
+.\"		After return, the string 'args' contains the remaining
+.\"		arguments.
+.\"
+.\"		Example: With the definition of string 'foo' as
+.\"
+.\"			.ds foo aaa=xxx bbb ccc='yyy zzz' ddd= eee
+.\"
+.\"		a call to 'getarg' with
+.\"
+.\"			.getarg ccc \*foo
+.\"
+.\"		sets string 'ccc' to value 'yyy zzz'.  The string 'args'
+.\"		now contains 'aaa=xxx bbb ddd= eee'.  An additional call
+.\"		like
+.\"
+.\"			.getarg ddd \*args
+.\"
+.\"		sets string 'ddd' to value '=', and 'args' contains
+.\"		'aaa=xxx bbb eee'.
+.de t*getarg
+.  ds \\$1
+.  ds args
+.
+.  if (\\n.$ < 2) \
+.    return
+.
+.  ds $1 \\$1\"
+.  shift
+.
+.  length * \\*$1
+.  while \\n.$ \{\
+.    ds * "\\$1\"
+.    ds ** "\\$1\"
+.    length ** \\***
+.    shift
+.    if (\\n* > \\n**) \{\
+.      as args " "\\***"\"			value too short, repeat
+.      continue
+.    \}
+.    substring * 0 (\\n* - 1)
+.    \" The surrounding \? escapes emulate string comparison.
+.    ie !"\?\\*$1\?"\?\\**\?" \{\
+.      as args " "\\***"\"			key not found, repeat
+.      continue
+.    \}
+.    el \{\
+.      ie "\?\\***\?"\?\\*$1\?" \
+.        ds \\*$1 \\*$1\"			return key as string
+.      el \{\
+.        ie "\?\\***\?"\?\\*$1=\?" \
+.          ds \\*$1 =\"			return '='
+.        el \{\
+.          substring ** (\\n* + 1) -1
+.          ds * \\***\"
+.          substring * 0 0
+.
+.          \" check whether value starts with quote
+.          if "\?\\**\?"\?'\?" \{\
+.            substring ** 1 -1
+.            ds * \\***\"
+.            substring * -1 -1
+.
+.            \" search final quote
+.            ie "\?\\**\?"\?'\?" \
+.              substring ** 0 -2
+.            el \{\
+.              as \\*$1 \\*** \"		not found, append argument
+.
+.              while 1 \{\
+.                ds ** \\$1\"			get next argument
+.                ds * \\$1\"
+.                shift
+.                substring * -1 -1
+.
+.                if "\?\\**\?"\?'\?" \{\
+.                  substring ** 0 -2
+.                  break		\"	break if no final quote
+.                \}
+.
+.                as \\*$1 \\*** \"		otherwise append and repeat
+.              \}
+.          \}\}
+.
+.          as \\*$1 \\***\"
+.        \}
+.
+.        as args " \\$@\"
+.    \}\}
+.
+.    return
+.  \}
+..
+.
+.
+.\"	Utility macro:	.index <string1> <string2>
+.\"
+.\"		Check whether <string2> is a substring of <string1> and
+.\"		return its position in number register 't*index', starting
+.\"		with 1.  If not found, return 0.  If <string2> is empty,
+.\"		set 't*index' to -999.
+.de t*index
+.  if "\\$2"" \{\
+.    nr t*index -999
+.    return
+.  \}
+.
+.  length ** \\$1&#x7;
+.  length $2 \\$2
+.  nr * 0-1 1
+.
+.  while (\\n+* < \\n**) \{\
+.    ds * \\$1&#x7;\"
+.    substring * \\n* (\\n* + \\n$2 - 1)
+.    \" The surrounding \? escapes emulate string comparison.
+.    if "\?\\**\?"\?\\$2\?" \
+.      break
+.  \}
+.
+.  ie (\\n* == \\n**) \
+.    nr t*index 0
+.  el \
+.    nr t*index (\\n* + 1)
+..
+.
+.
+.\"	******************************************************************
+.\"	********	non-accumulating space .t*SP v	**********
+.\"	**                                                              **
+.\"	**	nl vor erster Seite -1, oben auf Seite 0 resp. tH	**
+.\"	**	.k nach .sp oder .br 0,					**
+.\"	**		sonst Laenge der angefangenen Zeile		**
+.\"	**	Der Merker M# fuer vorangegangenes .t*SP wird in .HM am	**
+.\"	**	Seitenanfang zurueckgesetzt.				**
+.\"	**	ganz richtig ist .sp + .br = .br + .sp = .sp		**
+.\"	******************************************************************
+.de t*SP
+.  if (\\nnl < 0) \
+.    br			\"	start very first page
+.  nr * \\n.p		\"	save current page length
+.
+.  ie "\\$1"" \
+.    pl +1		\"	without arg increase page length by 1v
+.  el \
+.    pl +\\$1		\"	otherwise use \\$1
+.
+.  nr ** (\\n.p - \\n*)	\" ** now holds arg for .t*SP in base units
+.  pl \\n*u		\"	restore page length
+.
+.  \" we do nothing at start of new page or column
+.  if ((\\nnl - \\ntH) & (\\nnl - \\n<<) : \\n.k) \{\
+.    ie ((\\n.d - \\nM#) : \\n.k) \{\
+.      sp \\n**u	\"	execute .sp
+.      nr S# \\n**	\"	store ** in S#
+.    \}
+.    el \{\
+.      if (\\n** - \\nS#) \{\
+.        sp (\\n**u - \\nS#u)\"	emit difference to previous .t*SP
+.        nr S# \\n**	\"	store ** in S#
+.    \}\}
+.
+.    nr M# \\n.d	\"	store vertical position .d in M#
+.  \}
+..
+.
+.
+.\"	******************************************************************
+.\"	**		Perform all arguments once			**
+.\"	**			P1 is nestable				**
+.\"	******************************************************************
+.de t*P1
+.  \" 'while' command is about five times faster than recursion!
+.  while \\n.$ \{\
+.    nop \\$1
+.    shift
+.  \}
+..
+.
+.
+.\"	******************************************************************
+.\"	**	Hilfsmakro zum Einstellen von Schriftgroesse und	**
+.\"	**	Zeilenabstand, bezogen auf Anfangswerte \nt*s		**
+.\"	**	und \nt*v sowie fuer Hyphenation:			**
+.\"	**		.t*pv s v hy# hart;  macht .br			**
+.\"	**	Bei 4. Argument setzen der Register s und v und hy.	**
+.\"	**	Fuer angefangene Zeile die vorgefundenen Einstellungen	**
+.\"	**								**
+.\"	**   Auxiliary macro to set internal registers for font size	**
+.\"	**   and line spacing, relative to initial values \nt*s and	**
+.\"	**   \nt*v. Optionally sets hyphenation. A fourth argument	**
+.\"	**   initializes internal registers to global default values.	**
+.\"	******************************************************************
+.de t*pv
+.  br
+.
+.  if \\n.$ \
+.    ps (\\nt*su * \\$1z / 1z)
+.
+.  ie (\\n.$ - 1) \
+.    vs (\\nt*vu * \\$2p / 1p)
+.  el \{\
+.    vs (\\nt*vu * \\$1p / 1p)
+.    return
+.  \}
+.
+.  if !""\\$3" \
+.    hy \\$3
+.
+.  if !""\\$4" \{\
+.    nr t*v \\n.v
+.    nr t*s \\n.ps
+.    nr t*hy \\n.hy
+.  \}
+..
+.
+.
+.\"	******************************************************************
+.\"	**		Hilfsmakros pop/pops/popr (pop stackelement):	**
+.\"	**		pop or popr:	pop register			**
+.\"	**		pops:		pop string			**
+.\"	**		.pops|r reg|string stackname			**
+.\"	**		    reg|string: name of reg/string to get the	**
+.\"	**			 popped element				**
+.\"	**		    stack: name of stack			**
+.\"	******************************************************************
+.de *pop
+.  ie "\\$1"pops" \
+.    ds \\$2 \\$4\"		pop first stackelement
+.  el \
+.    nr \\$2 \\$4
+.
+.  ds $3 \\$3\"			remember stackname
+.  shift 4		\"	shift four args
+.
+.  ds \\*$3 "\\$@\"		fill stack with remaining elements
+..
+.
+.de pop
+.  *pop \\$0 \\$1 \\$2 \\*\\$2
+..
+.
+.als popr pop
+.als pops pop
+.
+.
+.\"	******************************************************************
+.\"	**		process diversion				**
+.\"	******************************************************************
+.de t*DI
+.  nr * \\n.u
+.  nf		\"	diversion is already formatted - output it unchanged
+.  \\$1		\"	output the diversion ...
+.  rm \\$1	\"	... and remove it
+.  if \\n* \
+.    fi		\"	reactivate formatting
+..
+.
+.\"	******************************************************************
+.\"	**		error checking at end				**
+.\"	******************************************************************
+.de t*EM
+.
+.  if !"\\*t*kept"" \{\
+.    tm1 "hdtbl: Not all tables have been printed.
+.    tm1 "       Add '.bp' at the end of your document.
+.  \}
+.  if !"\\*t*held"" \{\
+.    tm1 "hdtbl: There are held tables which haven't been printed.
+.    tm1 "       Add '.t*free' at the end of your document.
+.  \}
+.  if \\nt*# \
+.    tm hdtbl: Missing '.ETB' macro; last .TBL in \\*t*FN at line \\*t*LN.
+..
+.
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/hdtbl/hdtbl.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/hdtbl.am Changed

@@ -1,17 +1,17 @@
-# Copyright (C) 2006-2018 Free Software Foundation, Inc.
-#      Written by Werner Lemberg (wl@gnu.org)
+# Copyright (C) 2006-2020 Free Software Foundation, Inc.
+#      Written by Werner Lemberg <wl@gnu.org>
 #      Automake migration by Bertrand Garrigues
-#
+#        <bertrand.garrigues@laposte.net>
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -19,26 +19,22 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 hdtbl_srcdir = $(top_srcdir)/contrib/hdtbl
-hdtbl_builddir = $(top_builddir)/contrib/hdtbl
 
 man7_MANS += contrib/hdtbl/groff_hdtbl.7
 
 # Groff command used to generate .ps files
-HDTBL_TFLAG = -M$(hdtbl_srcdir) -M$(hdtbl_builddir)
-HDTBL_PFLAG=-t -p -e -U
 HDTBLGROFF = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  $(GROFFBIN) $(FFLAG) $(TFLAG) $(HDTBL_TFLAG) $(HDTBL_PFLAG)
+  $(GROFFBIN) $(FFLAG) $(MFLAG) -M$(hdtbl_srcdir) -t -p -e -U
 
-# Files installed in $(tmacdir).
-# These files are generated with 'strip.sed' from their unstripped source file
-# equivalent (e.g. hdtbl.tmac is generated from hdtbl.tmac-u)
-HDTBLSTRIPFILES = \
+HDTBLTMACFILES = \
   contrib/hdtbl/hdtbl.tmac \
   contrib/hdtbl/hdmisc.tmac
 hdtbltmacdir = $(tmacdir)
-hdtbltmac_DATA = $(HDTBLSTRIPFILES)
+dist_hdtbltmac_DATA = $(HDTBLTMACFILES)
+
+hdtbl_test_template = contrib/hdtbl/examples/test-hdtbl.sh.in
 
 # Files installed in $(exampledir)/hdtbl.  HDTBLEXAMPLEFILES are
 # located in the source tree, while HDTBLPROCESSEDEXAMPLEFILES are
@@ -51,7 +47,7 @@
 EXTRA_DIST += \
   contrib/hdtbl/examples/fonts_n.in \
   contrib/hdtbl/examples/fonts_x.in \
-  contrib/hdtbl/examples/test-hdtbl.sh.in
+  $(hdtbl_test_template)
 
 HDTBLEXAMPLEFILES = \
   contrib/hdtbl/examples/common.roff \
@@ -79,61 +75,52 @@
   contrib/hdtbl/examples/short_reference.ps
 
 hdtblexampledir = $(exampledir)/hdtbl
-
-if BUILD_EXAMPLES
 dist_hdtblexample_DATA = $(HDTBLEXAMPLEFILES)
 nodist_hdtblexample_DATA = \
   $(HDTBLGENFILES) \
   $(HDTBLPROCESSEDEXAMPLEFILES) \
-  gnu.eps
-else
-EXTRA_DIST += $(HDTBLEXAMPLEFILES) 
-endif
-$(hdtblexample_DATA): $(HDTBLSTRIPFILES)
+  $(DOC_GNU_EPS)
+
+$(hdtblexample_DATA): $(HDTBLTMACFILES)
 
-MOSTLYCLEANFILES += $(HDTBLGENFILES) $(HDTBLPROCESSEDEXAMPLEFILES) \
-  $(HDTBLSTRIPFILES)
+MOSTLYCLEANFILES += $(HDTBLGENFILES) $(HDTBLPROCESSEDEXAMPLEFILES)
 
 EXTRA_DIST += \
   contrib/hdtbl/ChangeLog \
   contrib/hdtbl/TODO \
-  contrib/hdtbl/groff_hdtbl.7.man \
-  contrib/hdtbl/hdtbl.tmac-u \
-  contrib/hdtbl/hdmisc.tmac-u
+  contrib/hdtbl/groff_hdtbl.7.man
 
-if BUILD_EXAMPLES
 hdtbl_TESTS = contrib/hdtbl/examples/test-hdtbl.sh
 TESTS += $(hdtbl_TESTS)
-contrib/hdtbl/examples/test-hdtbl.sh: $(top_builddir)/config.status \
-	$(HDTBLPROCESSEDEXAMPLEFILES) $(top_srcdir)/contrib/hdtbl/examples/test-hdtbl.sh.in
-	sed -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
-	    -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
-	    	$(top_srcdir)/contrib/hdtbl/examples/test-hdtbl.sh.in > $@
-	chmod +x $@
+contrib/hdtbl/examples/test-hdtbl.sh: \
+  $(top_builddir)/config.status \
+  $(HDTBLPROCESSEDEXAMPLEFILES) \
+  $(top_srcdir)/$(hdtbl_test_template)
+	$(AM_V_GEN)sed \
+	  -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
+	  -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
+	  $(top_srcdir)/$(hdtbl_test_template) > $@ \
+	&& chmod +x $@
 MOSTLYCLEANFILES += $(hdtbl_TESTS)
-endif
 
 # Rule to generate ps and roff files
 SUFFIXES += .roff .in .ps
 
 .roff.ps:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(HDTBLGROFF) -Tps \
+	&& $(HDTBLGROFF) -I $(doc_builddir) -I $(doc_srcdir) -Tps \
 	     -dfontpath=$(top_srcdir)/font \
 	     -dsopath=$(hdtbl_srcdir)/ \
 	     -mhdtbl $< >$@
+
 .in.roff:
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& sed -e "s|@fontdir@|$(fontdir)|" \
 	       -e "s|@EGREP@|$(EGREP)|" $< >$@
 
 
-$(HDTBLPROCESSEDEXAMPLEFILES): gnu.eps groff troff pic tbl \
-  contrib/hdtbl/examples/common.roff
-
-$(HDTBLSTRIPFILES): $(top_srcdir)/tmac/strip.sed
-	@$(MKDIR_P) `dirname $@`
-	sed -f $(top_srcdir)/tmac/strip.sed $(hdtbl_srcdir)/`basename $@`-u > $@;
+$(HDTBLPROCESSEDEXAMPLEFILES): $(DOC_GNU_EPS) groff troff eqn pic tbl \
+  grops font/devps/stamp contrib/hdtbl/examples/common.roff
 
 uninstall_groffdirs: uninstall-hdtbl-hook
 uninstall-hdtbl-hook:
@@ -142,12 +129,8 @@
 	fi
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/hdtbl/hdtbl.tmac Added

@@ -0,0 +1,1003 @@
+.ig
+
+hdtbl.tmac
+
+This file is part of groff, the GNU roff type-setting system.
+
+Copyright (C) 2005-2020 Free Software Foundation, Inc.
+written by Joachim Walsdorff <Joachim.Walsdorff@urz.uni-heidelberg.de>.
+
+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
+(at your option) any later version.
+
+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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+..
+.
+.
+.\"	*****************************************************************
+.\"	*		hdtbl - Heidelberger table macros		*
+.\"	*			Vers. 0.91 December 2005		*
+.\"	*****************************************************************
+.
+.if d TBL \
+.  nx
+.
+.mso hdmisc.tmac
+.mso 62bit.tmac
+.
+.
+.\"	*****************************************************************
+.\"	*		default values for some arguments		*
+.\"	*****************************************************************
+.
+.ds t*hl s\"
+.ds t*vl s\"
+.ds t*tal l\"
+.ds t*hal b\"
+.ds t*val t\"
+.ds t*ff \\n.fam\"
+.ds t*fst \\n.f\"
+.ds t*fsz 1 1\"
+.ds t*fgc red4\"
+.ds t*bgc bisque\"
+.ds t*bc red4\"
+.nr t*cpd .5n
+.nr t*csp .5n
+.nr t*b .1n
+.nr t*cols 1
+.nr t*v \n.v
+.nr t*s \n.ps
+.nr t*hy \n.hy
+.nr t*l \n.ll
+.
+.
+.\"			defaults for table captions
+.nr t*cptn 0 1
+.ds t*cptn "".sp .4" \
+            ".t*pv 1.0 1.0" \
+            ".ad l" \
+            "\m\\*t*fgcTable \\n+t*cptn:\0\k*\c"\"
+.
+.
+.\" for better error messages
+.ds nth-1 st\"
+.ds nth-2 nd\"
+.ds nth-3 rd\"
+.
+.\" initialization of various registers
+.nr t*# 0	\"	table nesting level
+.nr t*numb 0 1	\"	held table diversion #
+.
+.ds *#trc*
+.
+.
+.\"	*****************************************************************
+.\"	*	The four base macros and the two optional macros	*
+.\"	*****************************************************************
+.
+.ie n \
+.  ds g tty:\"
+.el \
+.  ds g ps: exec\"
+.
+.\"	TBL:	table start
+.\"		predecessor: 	text, TD or ETB
+.\"		successor:	CPTN or TR
+.de TBL
+.  ds t*m\\nt*# \\n.m\"
+.  ie \\nt*# \
+.    br
+.  el \{\
+.    ds * \\n.ev\"
+.    ev t*tbl
+.    evc \\**
+.    di t*tbl0
+.    sp .4				\" XXX: hard-coded value
+.    nr t*i \\n.i
+.    ll -\\n.iu
+.    in 0
+.  \}
+.  nr t*# +1
+.
+.  \" Save current location for error checking at end
+.  ds t*FN \\.F\"
+.  ds t*LN \\.c\"
+.
+.  t*getarg cols \\$@\"	from here string 'args' contains the rest of \\$@
+.  ie "\\*cols"" \
+.    nr t*cols\\nt*# \\nt*cols
+.  el \{\
+.    ie \B&#x7;\\*cols&#x7; \
+.      nr t*cols\\nt*# \\*cols
+.    el \
+.      tm \\n.F:\\n.c: Invalid number of columns value '\\*cols'.
+.  \}
+.
+.  t*getarg cpd \\*args                 \"	cell padding
+.  ie "\\*cpd"" \
+.    nr t*cpd\\nt*# \\nt*cpd
+.  el \{\
+.    ie \B&#x7;\\*cpd&#x7; \
+.      nr t*cpd\\nt*# \\*cpd
+.    el \
+.      tm \\n.F:\\n.c: Invalid cell padding value '\\*cpd'.
+.  \}
+.
+.  t*getarg csp \\*args                 \"	cell spacing
+.  ie "\\*csp"" \
+.    nr t*csp\\nt*# \\nt*csp
+.  el \{\
+.    ie \B&#x7;\\*csp&#x7; \
+.      nr t*csp\\nt*# \\*csp
+.    el \
+.      tm \\n.F:\\n.c: Invalid cell spacing value '\\*csp'.
+.  \}
+.
+.  t*getarg border \\*args              \"	border thickness
+.  ie "\\*border"=" \
+.    nr t*b\\nt*# 0-1
+.  el \{\
+.    ie "\\*border"" \
+.      nr t*b\\nt*# \\nt*b
+.    el \{\
+.      ie \B&#x7;\\*border&#x7; \
+.        nr t*b\\nt*# \\*border
+.      el \
+.        tm \\n.F:\\n.c: Invalid border thickness value '\\*border'.
+.  \}\}
+.
+.  t*getarg bc \\*args                  \"	border color
+.  ds t*bc\\nt*# \\*t*bc\"
+.  if !"\\*bc"" \{\
+.    ie m\\*bc \
+.      ds t*bc\\nt*# \\*bc\"
+.    el \{\
+.      ie "\\*bc"=" \
+.        ds t*bc\\nt*# =\"
+.      el \
+.        tm \\n.F:\\n.c: Invalid border color '\\*bc'.
+.  \}\}
+.  ie "\\*bc"=" \
+.    ds t*bc\\nt*#
+.  el \{\
+.    ie "\\*bc"" \
+.      ds t*bc\\nt*# \\*t*bc\"
+.    el \
+.      ds t*bc\\nt*# \\*bc\"
+.  \}
+.
+.  t*getarg width \\*args               \"	table/col widths
+.  if "\\*width"=" \
+.    ds width
+.
+.  nr b/2\\nt*# (\\nt*b\\nt*# / 2)\"	shortcut
+.  nr cscp\\nt*# (\\nt*csp\\nt*# + \\nt*cpd\\nt*#)\"  aux. register
+.
+.  t*getarg height \\*args              \"	table outline height
+.  ie "\\*height"" \
+.    nr t*height\\nt*# 0
+.  el \{\
+.    ie \B&#x7;\\*height&#x7; \
+.      nr t*height\\nt*# (\\*height \
+                            - ((2 * \\ncscp\\nt*#) \
+                                + (3 * \\nb/2\\nt*#)))
+.    el \
+.      tm \\n.F:\\n.c: Invalid height value '\\*height'.
+.  \}
+.
+.  t*cl \\*width                      \"	get cell widths and offsets
+.  t*args \\nt*#                      \"	look for common arguments
+.
+.  t*getarg tal \\*args                 \"	table horizontal alignment
+.  if "\\*tal"" \
+.    ds tal \\*t*tal\"
+.  ie "\\*tal"l" \
+.    nr in\\nt*# \\n.i
+.  el \{\
+.    ie "\\*tal"c" \
+.      nr in\\nt*# (\\n.l - \\nll\\nt*#/2 + \\n.i)
+.    el \{\
+.      ie "\\*tal"r" \
+.        nr in\\nt*# (\\n.l - \\nll\\nt*# + \\n.i)
+.      el \{\
+.        tmc \\n.F:\\n.c: Invalid horizontal table alignment '\\*tal':
+.        tm1 " must be 'l', 'c' or 'r'.
+.  \}\}\}
+.
+.  nr t*r#\\nt*# 0		        \"	initialize row index
+.  mk toptbl\\nt*#
+.
+.  t*P1 \\*args
+..
+.
+.
+.\"	CPTN:	optional table caption
+.\"		predecessor:	TBL
+.\"		successor:	TR
+.de CPTN
+.  ft 1
+.
+.  if "\\$0"CPTN" \
+.    if \\nt*r#\\nt*# \{\
+.      tmc \\n.F:\\n.c: Invalid placement of '.CPTN';
+.      tm1 " must be called immediately after '.TBL'.
+.      return
+.    \}
+.
+.  t*getarg val \\$@
+.  ds args\\nt*# "\\*args\"
+.
+.  t*index "\\*args" .TR
+.  ie \\nt*index \{\
+.    ds *a\\nt*# "\\*args\"
+.    substring args\\nt*# 0 \\nt*index
+.    substring *a\\nt*# \\nt*index-2 -1
+.  \}
+.  el \
+.    ds *a\\nt*#
+.
+.  ie "\\*val"b" \{\
+.    de t*cptn\\nt*#
+.      *CPTN \\*args\\nt*#
+.      rm t*cptn\\nt*#
+\\..
+.  \}
+.  el \{\
+.    ll (\\nll\\nt*#u + \\nin\\nt*#u)
+.    in \\nin\\nt*#u
+.    t*P1 \\*t*cptn
+'    in +\\n*u
+.    t*P1 \\*args\\nt*#
+.    t*pv 1 1
+.    in
+.    mk toptbl\\nt*#
+.  \}
+.
+.  t*P1 \\**a\\nt*#
+..
+.
+.als *CPTN CPTN
+.
+.
+.\"	TR:	table row
+.\"		predecessor:	TBL, CPTN, text, TD or ETB
+.\"		successor:	TD
+.de TR
+.  ft 1
+.  if !\\nt*# \{\
+.    tm \\n.F:\\n.c: Table row (.TR) without preceding table start (.TBL).
+.    return
+.  \}
+.
+.  \" finish previous data cell, if any
+.  if \\nt*r#\\nt*# \
+.    t*dntr 1 \\nc#\\*#t#r \\nt*cols\\nt*# \\**#trc*
+.
+.  nr t*r#\\nt*# +1			\"	row number in this table
+.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		table row identifier
+.					\"	(<level>*<row>)
+.  nr c#\\*#t#r 0 1			\"	clear cell counter
+.  nr dntr\\*#t#r 0 1			\"	clear accumulated row height
+.
+.  t*getarg height \\$@
+.  ie "\\*height"" \
+.    nr t*height\\*#t#r 0
+.  el \{\
+.    ie \B&#x7;\\*height&#x7; \
+.      nr t*height\\*#t#r \\*height
+.    el \
+.      tm \\n.F:\\n.c: Invalid table row height '\\*height'.
+.  \}
+.
+.  \"	If there is a TR with height 'height', the total height of the table
+.  \"	is too high by 3/2 b, independent of the number of TR with 'height'.
+.  t*args \\*#t#r \\nt*#            \"	look for common arguments
+.
+.  t*P1 \\*args
+..
+.
+.
+.\"	TH:	optional table header cell
+.\"		predecessor:	text, TD or TR
+.\"		successor:	text, TD, TR, TBL or ETB
+.\"								
+.\"		cell content bolded and horizontally and vertically centered,
+.\"		else like .TD
+.de TH
+.  ft 1
+.  t*getarg hal \\$@
+.  if "\\*hal"" \
+.    ds hal c\"
+.
+.  t*getarg val \\*args
+.  if "\\*val"" \
+.    ds val m\"
+.
+.  t*getarg fst \\*args
+.  if "\\*fst"" \
+.    ds fst B\"
+.
+.  TD hal=\\*hal val=\\*val fst=\\*fst \\*args
+..
+.
+.
+.\"	TD:	table data cell
+.\"		predecessor:	text, TD or TR
+.\"		successor:	text, TD, TR, TBL or ETB
+.de TD
+.  ft 1
+.  \" finish previous data cell -- note the use of \E
+.  t*dntr 0 \\nc#\\*#t#r-1 \Enc#\\*#t#r \\**#trc*
+.
+.  ds *#trc* \\*#t#r*\\nc#\\*#t#r\"	table cell identifier
+.					\"	(<level>*<row>*<column>)
+.
+.  t*getarg rowspan \\$@
+.  nr rowspan 1
+.  if !"\\*rowspan"" \{\
+.    ie \B&#x7;\\*rowspan&#x7; \{\
+.      nr rowspan (\\*rowspan >? 1)
+.      nr *rsp*\\**#trc* (\\nrowspan - 1)
+.    \}
+.    el \
+.      tm \\n.F:\\n.c: Invalid value of 'rowspan' keyword.
+.  \}
+.
+.  t*getarg colspan \\*args
+.  nr colspan 1
+.  if !"\\*colspan"" \{\
+.    ie \B&#x7;\\*colspan&#x7; \
+.      nr colspan (\\*colspan >? 1)
+.    el \
+.      tm \\n.F:\\n.c: Invalid value of 'colspan' keyword.
+.  \}
+.
+.  t*args \\*#trc \\*#t#r           \"  look for common arguments
+.
+.  nr in\\*#trc \\nin\\nt*#*\\nc#\\*#t#r
+.  nr *cl \\ncll\\nt*#*\\nc#\\*#t#r
+.  nr * 0 1
+.  nr *r \\nt*r#\\nt*#
+.
+.  if (\\nrowspan - 1) \
+.    while (\\n+* <= \\nrowspan) \{\
+.      nr rspan\\nt*#*\\n*r*\\nc#\\*#t#r \\ncolspan
+.      if (\\n* > 1) \
+.        nr cspan\\nt*#*\\n*r*\\nc#\\*#t#r \\ncolspan
+.      nr *r +1
+.    \}
+.
+.  nr * 1 1
+.  nr *c \\nc#\\*#t#r
+.
+.  if (\\ncolspan - 1) \{\
+.    nr vline\\**#trc* 0-1		\"	set 'no vl' flag
+.
+.    while (\\n+* <= \\ncolspan) \{\
+.      nr *c +1
+.      nr *cl +(2 * \\ncscp\\nt*# \
+                + \\nb/2\\nt*# \
+                + \\ncll\\nt*#*\\n*c)
+.      nr c#\\*#t#r +1
+.    \}
+.  \}
+.
+.  if (\\nc#\\nt*#*\\nt*r#\\nt*# > \\nt*cols\\nt*#) \{\
+.    ds * are\"
+.    ds ** columns\"
+.    if (\\nc#\\*#t#r == 1) \{\
+.      ds * is\"
+.      ds ** column\"
+.    \}
+.    tmc \\n.F:\\n.c: There \\** \\nc#\\*#t#r table \\*** (.TD)
+.
+.    ds * are\"
+.    if (\\nt*cols\\nt*# == 1) \
+.      ds * is\"
+.    tm1 " but only \\nt*cols\\nt*# \\** expected.
+.
+.    ds *
+.    length * \\n.F:\\n.c:
+.
+.    while \\n-* \
+.      ds * " \\**\"
+.
+.    tm1 "\\** Remaining .TDs and its contents are ignored.
+.
+.    di *t*dummy*                \"	bypass superfluous input
+.    return
+.  \}
+.
+.  di t*\\*#trc                \"	open cell diversion and set locals
+.  in 0
+.  nr cll\\*#trc \\n*cl
+.  ll \\n*clu
+.  nr *cl\\nt*# \\n.l
+.  gcolor \\*t*fgc\\*#trc
+.  ad \\*t*hal\\*#trc
+.  fam \\*t*ff\\*#trc
+.  ft \\*t*fst\\*#trc
+.  t*pv \\*t*fsz\\*#trc
+.
+.  t*P1 \\*args
+..
+.
+.
+.\"	ETB:	end of table
+.\"		predecessor:	text, TD or ETB
+.\"		successor:	text, TD, TR or TBL
+.de ETB
+.  ie \\nt*# \
+.    if !\\nt*r#\\nt*# \{\
+.      tmc \\n.F:\\n.c: Each table (.TBL)
+.      tm1 " should contain at least one table row (.TR)!
+.    \}
+.  el \{\
+.    tmc \\n.F:\\n.c: Table end (.ETB)
+.    tm1 " without corresponding table start (.TBL)!
+.  \}
+.
+.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		refresh table row identifier
+.  t*dntr 2 \\nc#\\*#t#r \\nt*cols\\nt*# \\**#trc*
+.
+.  t*divs                        \"	print this table
+.
+.  sp \\nb/2\\nt*#u
+.  t*cptn\\nt*#
+.  nr t*# -1
+.
+.  ll \\n*cl\\nt*#u          \"	restore ll outside this table
+.  in 0                          \"	reset indent
+.  gcolor \\*t*m\\nt*#       \"	reset previous fgc
+.
+.  t*getarg hold \\$@
+.  if !\\nt*# \{\
+.    sp .5
+.    di
+.    in \\nt*iu
+.    ie "\\*hold"" \{\
+.      ie (\\n.t - \\ndn) \
+.        t*DI t*tbl0
+.      el \{\
+.        rn t*tbl0 t*tbl\\n+t*numb
+.        ds t*kept \\*t*kept t*tbl\\nt*numb \\ndn\"
+.      \}
+.    \}
+.    el \{\
+.      rn t*tbl0 t*hold\\n+t*numb
+.      tm \\n.F:\\n.c: Table t*hold\\nt*numb held.
+.      ds t*held \\*t*held t*hold\\nt*numb \\ndn\"
+.    \}
+.
+.    ev				\"	restore previous environment
+.  \}
+.
+.  t*P1 \\*args
+..
+.
+.
+.\"	*****************************************************************
+.\"	*	Following the definition of five utility macros		*
+.\"	*	special to hdtbl.					*
+.\"	*	Other utility macros common to hdtbl and hdgroff	*
+.\"	*	are defined in the file hdmisc.tmac.			*
+.\"	*****************************************************************
+.
+.
+.\"	.t*free n
+.\"		print the next n held tables.
+.\"             Don't call it within a table!
+.\"		If the table is higher than the remaining space
+.\"		on the page, the table is printed on the next page.
+.de t*free
+.  if "\\$0"CPTN" \
+.    if \\nt*r#\\nt*# \{\
+.      tmc \\n.F:\\n.c: Invalid placement of '.t*free' within a table;
+.      tm1 " it must be called outside of any table.
+.      return
+.    \}
+.
+.  if "\\*t*held"" \{\
+.    tm \\n.F:\\n.c: No held tables.
+.    return
+.  \}
+.
+.  nr ** (\\$1 >? 1) 1
+.  while !""\\*t*held" \{\
+.    pops * t*held
+.    popr * t*held
+.
+.    ie (\\n.t - \\n*) \{\
+.      ev t*tbl
+.      t*DI \\**
+.      ev
+.    \}
+.    el \{\
+.      rn \\** t*tbl\\n+t*numb
+.      ds t*kept \\*t*kept t*tbl\\nt*numb \\n*\"
+.    \}
+.
+.    if !(\\n-** - 1) \
+.      return
+.  \}
+..
+.
+.
+.\"	The main utility macro for tables:
+.\"		If a table is closed by ETB, this macro is called.  It
+.\"		processes one complete table, i.e., all the table cell
+.\"		diversions, paints the cell backgrounds, draws
+.\"		horizontal and vertical table lines and the table border.
+.\"
+.\"		Nested tables are processed from inside to outside.
+.
+.de t*divs
+.  ll (\\nt*lu + 1c)			\"	avoid warning 'can't break line'
+.  nf
+.
+.  nr b/2 \\nb/2\\nt*#		\"	some abbreviations
+.  nr cscp \\ncscp\\nt*#
+.  nr cscpb (\\nb/2 + \\ncscp)
+.
+.  nr topdiv (\\n.d + \\nb/2 - \\ncscp)\"	top of cell diversion
+.  nr cscpb2 (\\nb/2 / 2 + \\ncscp)
+.
+.  nr #r 0 1
+.  \" outer loop for rows
+.  while (\\n+#r <= \\nt*r#\\nt*#) \{\
+.    \" TODO: insert code here for multipage tables
+.    nr * (\\n#r - 1)
+.    nr topdiv +(\\ndntr\\nt*#*\\n* + \\ncscp + \\ncscpb)
+.
+.    \" if table still smaller than specified table height, increase it
+.    if ((\\n#r == \\nt*r#\\nt*#) & \\nt*height\\nt*#) \
+.      nr dntr\\nt*#*\\n#r (\\ncscpb \
+                                + \\ntoptbl\\nt*# \
+                                + \\nt*height\\nt*# \
+                                - (\\ntopdiv >? \\ndntr\\nt*#*\\n#r))
+.
+.    nr #c 0 1
+.    \" inner loop for cells
+.    while (\\n+#c <= \\nt*cols\\nt*#) \{\
+.      ds #trc \\nt*#*\\n#r*\\n#c\"
+.      \" continue if the diversion is empty
+.      if !d t*\\*#trc \
+.        continue
+.
+.      sp |\\ntopdivu
+.      in (\\nin\\nt*#u + \\nin\\*#trcu)\"	cell offset
+.      nr $1 \\ndntr\\nt*#*\\n#r	\"	cell height
+.
+.      \" if we have spanned rows, calculate resulting row height
+.      \" and position of lower horizontal line
+.      if \\n*rsp*\\*#trc \{\
+.        nr * \\n#r 1
+.        nr rspan\\*#trc 0-1		\"	set 'no hl' flag
+.        nr corr (\\ndn\\*#trc - \\ndntr\\nt*#*\\n#r)
+.
+.        \" clear row span flags in following rows and update row height
+.        while \\n*rsp*\\*#trc \{\
+.          nr *rsp*\\*#trc -1
+.          nr rspan\\nt*#*\\n+**\\n#c 0
+.          nr ** (\\ndntr\\nt*#*\\n* + \\ncscp + \\ncscpb)
+.          nr corr -\\n**
+.          nr $1 +\\n**
+.        \}
+.
+.        if (\\n-* == \\nt*r#\\nt*#) \
+.          nr $1 ((\\nt*height\\nt*# \
+                   - \\n.d \
+                   + \\ntoptbl\\nt*# \
+                   + \\ncscpb) \
+                     >? \\n$1)
+.        nr dntr\\nt*#*\\n* +(\\ncorr >? 0)
+.      \}
+.
+.      \" paint cell background
+.      nr * (2 * \\nt*cpd\\nt*# + \\ncll\\*#trc)\"	background width
+.      nr $1 (\\n$1 >? \\ndn\\*#trc)\"	cell height
+.
+.      if !"\\*t*bgc\\*#trc"=" \{\
+.        nop \h'\\nt*csp\\nt*#u'\
+\M\\*t*bgc\\*#trc\
+\v'(-.67v - \\nt*cpd\\nt*#u)'\
+\D'P \\n*u 0 \
+     0 (2u * \\nt*cpd\\nt*#u + \\n$1u) \
+     -\\n*u 0'\
+\M
+.        sp -1
+.      \}
+.
+.      \" ***   horizontal and vertical single or double lines   ***
+.      \" double and single lines have the same thickness;
+.      \" the double lines' distance is the line thickness.
+.      \"
+.      \" 'border=x': horizontal/vertical lines x/2 thick, minimum .1n
+.      \" 'border=0': no border; horizontal/vertical lines .1n thick
+.      \" 'border=': neither border nor horizontal/vertical lines
+.
+.      nr *t (.1n >? \\nb/2)		\"	thickness of hl/vl; min. .1n
+.      in +\\ncscpu
+.
+.      \" check for vertical and horizontal lines
+.      if (1 + \\nt*b\\nt*#) \{\
+.        if !"\\*t*bc\\nt*#"=" \{\
+.          \" draw horizontal line between this cell and the one below
+.          if (\\nt*r#\\nt*# - \\n#r + \\nrspan\\*#trc) \{\
+.            if !"\\*t*hl\\*#trc"=" \{\
+.              sp \\n$1u
+.              nr * (\\ncscp + \\ncscpb + \\ncll\\*#trc)
+.              nop \X'\*g 1 setlinecap'\
+\h'(-\\ncscpb2u - \\n*tu)'\
+\v'(\\ncscpb2u - .67v)'\
+\m\\*t*bc\\nt*#\
+\D't \\n*tu'\c
+.
+.              ie "\\*t*hl\\*#trc"d" \
+.                nop \v'-\\n*tu'\
+\D'l \\n*u 0'\
+\v'(2u * \\n*tu)'\
+\D'l -\\n*u 0'\
+\D't 0'
+.              el \
+.                nop \D'l \\n*u 0'\
+\D't 0'
+.
+.              sp (-\\n$1u - 1v)
+.          \}\}
+.
+.          nr rspan\\*#trc 0
+.
+.          \" draw vertical line between this cell and the one to the right
+.          if (\\nt*cols\\nt*# - \\n#c + \\nvline\\*#trc) \{\
+.            if !"\\*t*vl\\*#trc"=" \{\
+.              nop \X'\*g 1 setlinecap'\
+\v'(-\\ncscpb2u - .67v)'\
+\m\\*t*bc\\nt*#\
+\h'(\\ncscpb2u - \\n*tu + \\ncll\\*#trcu)'\c
+.
+.              ie "\\*t*vl\\*#trc"d" \
+.                nop \h'-\\n*tu'\
+\D't \\n*tu'\
+\D'l 0 (2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
+\h'(2u * \\n*tu)'\
+\D'l 0 -(2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
+\D't 0'
+.              el \
+.                nop \D't \\n*tu'\
+\D'l 0 (2u * \\ncscpu + \\n$1u + (\\n*tu / 2u))'\
+\D't 0'
+.              sp -1
+.      \}\}\}\}
+.
+.      nr vline\\*#trc 0
+.
+.      \" vert. cell content alignment
+.      nr ** 0
+.
+.      ie "\\*t*val\\*#trc"m" \
+.        nr ** ((\\n$1 - \\ndn\\*#trc) / 2)\"	val=m
+.      el \
+.        if "\\*t*val\\*#trc"b" \
+.          nr ** (\\n$1 - \\ndn\\*#trc)\"	val=b
+.
+.      sp \\n**u			\"	vertical content position
+.
+.      \" finally output the diversion
+.      t*\\*#trc
+.      rm t*\\*#trc
+.    \}
+.  \}
+.
+.  \" draw the box border
+.  in \\nin\\nt*#u
+.  nr ** (\\ntopdiv + \\ndntr\\nt*#*\\n-#r)
+.
+.  if \\nt*b\\nt*# \{\
+.    sp |(\\ntoptbl\\nt*#u + \\nb/2u)
+.    nr $1 (\\ntoptbl\\nt*# - \\n** - \\ncscp)
+.    nr * (\\nll\\nt*# - \\nt*b\\nt*#)
+.
+.    if !"\\*t*bc\\nt*#"=" \
+.      nop \X'\*g 0 setlinejoin 2 setlinecap'\
+\v'-.67v'\
+\h'-\\nb/2u'\
+\m\\*t*bc\\nt*#\
+\D't \\nt*b\\nt*#u'\
+\D'l \\n*u 0'\
+\D'l 0 -\\n$1u'\
+\D'l -\\n*u 0'\
+\D'l 0 \\n$1u'\
+\D't 0'
+.  \}
+.
+.  sp |(\\n**u + \\ncscpbu)
+.  fi
+..
+.
+.
+.\"	Utility macro:	.t*cl width1 width2 ...
+.\"
+.\"		Calculate cell widths, table width, and cell offsets.
+.de t*cl
+.  nr t*cols\\nt*# (\\n.$ >? \\nt*cols\\nt*#)
+.  nr ll\\nt*# 0			\"	accumulated cell widths
+.  nr ** (\\n.l / \\nt*cols\\nt*#)\"	width for remaining cells
+.  nr * 0 1				\"	counter
+.
+.  \" while-loop: Parse user arguments to get each cell's width.
+.  while (\\nt*cols\\nt*# >= \\n+*) \{\
+.    nr $\\n* \\n**
+.    if !"\\$\\n*"" \{\
+.      \" check for '%' pseudo scaling indicator
+.      ds * \\$\\n*\"
+.      substring * -1 -1
+.      ie "\\**"%" \{\
+.        ds ** \\$\\n*\"
+.        substring ** 0 -2
+.        ie \B&#x7;\\***&#x7; \
+.          nr $\\n* (\\*** * \\n.l / 100)
+.        el \
+.          tm \\n.F:\\n.c: Invalid relative cell width '\\***%'.
+.      \}
+.      el \{\
+.        ie \B&#x7;\\$\\n*&#x7; \
+.          nr $\\n* \\$\\n*
+.        el \
+.          tm \\n.F:\\n.c: Invalid cell width '\\$\\n*'.
+.    \}\}
+.
+.    nr ll\\nt*# +\\n$\\n*
+.    nr ** \\n$\\n*
+.  \}
+.
+.  if (\\nll\\nt*# > \\n.l) \
+.    tm \\n.F:\\n.c: Table width larger than column width.
+.
+.  nr ** (0 >? \\nt*b\\nt*#)
+.  nr * 0 1
+.
+.  \" second while loop: Compute final cell widths.
+.  while (\\nt*cols\\nt*# >= \\n+*) \{\
+.    \" Remove border width, if any.
+.    if \\nt*b\\nt*# \{\
+.      \" cell_width := cell_width * (length - 1.5*border) / length
+.      nr #* (\\nll\\nt*# - (3 * \\nt*b\\nt*# / 2))
+.      nr *** (\\nll\\nt*# / 2)
+.      \" avoid multiplication overflow
+.      mult31by31 $\\n* #* ****
+.      add31to62 *** **** ****
+.      div62by31 **** ll\\nt*# $\\n*
+.    \}
+.
+.    \" Get cell widths without padding, spacing, and separator line.
+.    nr cll\\nt*#*\\n* (\\n$\\n* \
+                            - (2 * \\ncscp\\nt*#) \
+                            - \\nb/2\\nt*#)
+.
+.    \" Check whether value is non-positive.
+.    if !\\ncll\\nt*#*\\n* \{\
+.      nr #* (\\nll\\nt*# - (3 * \\nt*b\\nt*# / 2))
+.      nr *** (\\n#* / 2)
+.      nr *h (2 * \\ncscp\\nt*# + \\nb/2\\nt*#)
+.      mult31by31 *h ll\\nt*# ****
+.      add31to62 *** **** ****
+.      div62by31 **** #* *h
+.      ds * \\n*th\"
+.      nr *** (\\n* % 10)
+.      if d nth-\\n*** \
+.        ds * \\n*\\*nth-\\n***\"
+.      tmc \\n.F:\\n.c: The \\** width value (\\$\\n*) is too small.
+.      tm1 " It should be greater than \\n*h.
+.    \}
+.
+.    nr in\\nt*#*\\n* \\n**	\"	cell offset
+.    nr ** +\\n$\\n*
+.  \}
+..
+.
+.
+.\"	Utility macro:	.t*dntr <origin> <cell position> ? <cell ID>
+.\"
+.\"		Close TD diversion, make some calculations, and set
+.\"		some help strings and registers.  <origin> is 0, 1,
+.\"		or 2 if the call of .t*dntr occurs in .TD, .TR, or
+.\"		.ETB, respectively.
+.de t*dntr
+.  nr dn 0				\"	reset diversion height
+.  br					\"	finish cell data
+.
+.  if "\\n.z"*t*dummy*" \
+.    return
+.
+.  ds #t#r \\nt*#*\\nt*r#\\nt*#\"		refresh table row identifier
+.
+.  if \\nc#\\*#t#r \{\
+.    di					\"	close diversion
+.    nr dn\\$4 \\ndn			\"	save height of this cell
+.    if !\\nrspan\\*#trc \{\
+.      \" update row height if not in a row span
+.      nr dntr\\*#t#r (\\ndntr\\*#t#r >? \\ndn)
+.      if \\$2 \
+.        nr dntr\\*#t#r ((\\nt*height\\*#t#r \
+                            - (2 * \\ncscp\\nt*# + \\nb/2\\nt*#)) \
+                            >? \\ndntr\\*#t#r)
+.  \}\}
+.
+.  nr c#\\*#t#r +1
+.  nr * \\$2
+.
+.  \" update column span registers
+.  while (\\n+* <= \\$3) \{\
+.    if r cspan\\*#t#r*\\n* \
+.      nr c#\\*#t#r +\\ncspan\\*#t#r*\\n*
+.    nr cspan\\*#t#r*\\n* 0
+.  \}
+.
+.  ds #trc \\*#t#r*\\nc#\\*#t#r\"
+.
+.  \" only check for cell underflow if called by .TR or .ETB
+.  if (\\$1 & (\\nc#\\*#t#r <= \\nt*cols\\nt*#)) \{\
+.    ds * are\"
+.    ds ** columns\"
+.    if (\\n-c#\\*#t#r == 1) \{\
+.      ds * is\"
+.      ds ** column\"
+.    \}
+.    tmc \\n.F:\\n.c: There \\** only \\nc#\\*#t#r \\***
+.
+.    nr * \\nt*r#\\nt*#
+.    ds * \\n*th\"
+.    nr *** (\\n* % 10)
+.    if d nth-\\n*** \
+.      ds * \\n*\\*nth-\\n***\"
+.    tmc " in the \\** row
+.
+.    ds * are\"
+.    if (\\nt*cols\\nt*# == 1) \
+.      ds * is\"
+.    tm1 " but \\nt*cols\\nt*# \\** expected.
+.  \}
+..
+.
+.
+.\"	Utility-macro:	.t*args level_1 level_2
+.\"
+.\"		Get the arguments common to TBL, TR, and TD for the level
+.\"		in argument 1, using default values from the level in
+.\"		argument 2.  If argument 2 is missing, use the global
+.\"		default values.
+.\"
+.de t*args
+.  ds t*bgc\\$1 \\*t*bgc\\$2\"
+.  ds t*fgc\\$1 \\*t*fgc\\$2\"
+.  ds t*hl\\$1 \\*t*hl\\$2\"
+.  ds t*vl\\$1 \\*t*vl\\$2\"
+.  ds t*hal\\$1 \\*t*hal\\$2\"
+.  ds t*val\\$1 \\*t*val\\$2\"
+.  ds t*ff\\$1 \\*t*ff\\$2\"
+.  ds t*fst\\$1 \\*t*fst\\$2\"
+.  ds t*fsz\\$1 \\*t*fsz\\$2\"
+.
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg bgc \\*args         \"	background color
+.  if !"\\*bgc"" \{\
+.    ie m\\*bgc \
+.      ds t*bgc\\$1 \\*bgc\"
+.    el \{\
+.      ie "\\*bgc"=" \
+.        ds t*bgc\\$1 =\"
+.      el \
+.        tm \\n.F:\\n.c: Invalid background color '\\*bgc'.
+.  \}\}
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg fgc \\*args         \"	foreground color
+.  if !"\\*fgc"" \{\
+.    ie m\\*fgc \
+.      ds t*fgc\\$1 \\*fgc\"
+.    el \{\
+.      ie "\\*fgc"=" \
+.        ds t*fgc\\$1 =\"
+.      el \
+.        tm \\n.F:\\n.c: Invalid foreground color '\\*fgc'.
+.  \}\}
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg hl \\*args          \"	horizontal line between cells
+.  if !"\\*hl"" \
+.    ds t*hl\\$1 \\*hl\"
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg vl \\*args          \"	vertical line between cells
+.  if !"\\*vl"" \
+.    ds t*vl\\$1 \\*vl\"
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg hal \\*args         \"	horizontal table cell alignment
+.  if !"\\*hal"" \{\
+.    t*index bcrl \\*hal
+.    ie \\nt*index \
+.      ds t*hal\\$1 \\*hal\"
+.    el \{\
+.      tmc \\n.F:\\n.c: Invalid horizontal alignment '\\*hal':
+.      tm1 " must be 'b', 'c', 'l' or 'r'.
+.  \}\}
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg val \\*args         \"	vertical table cell alignment
+.  if !"\\*val"" \{\
+.    t*index tmb \\*val
+.    ie \\nt*index \
+.      ds t*val\\$1 \\*val\"
+.    el \{\
+.      tmc \\n.F:\\n.c: Invalid vertical alignment '\\*val':
+.      tm1 " must be 't', 'm' or 'b'.
+.  \}\}
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg ff \\*args          \"	font family
+.  if !"\\*ff"" \
+.    ds t*ff\\$1 \\*ff\"
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg fst \\*args         \"	font style
+.  if !"\\*fst"" \
+.    ds t*fst\\$1 \\*fst\"
+.  if "\\*args"" \
+.    return
+.
+.  t*getarg fsz \\*args         \"	font size and spacing factor
+.  if !"\\*fsz"" \
+.    ds t*fsz\\$1 \\*fsz\"
+..
+.
+.
+.\" Append to your page header macro ('pg@top' for MS)
+.\" to enable tables to span pages.
+.de t*hm
+.  ev t*tbl
+.  nr ** \\n.t
+.  while !""\\*t*kept" \{\
+.    pops * t*kept
+.    popr * t*kept
+.    if (\\n* - \\n**) \{\
+.      tm \\n.F:\\n.c: Table \\** higher than page -- ignored!
+.      break
+.    \}
+.
+.    if (\\n* - \\n.t) \{\
+.      ds t*kept \\n* \\*t*kept\"
+.      ds t*kept \\** \\*t*kept\"
+.      tmc \\n.F:\\n.c: Remaining table(s),
+.      tm1 " because not all fit onto this page.
+.      break
+.    \}
+.
+.    t*DI \\**
+.  \}
+.  ev
+..
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/ChangeLog Changed

@@ -1,3 +1,664 @@
+2023-05-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* groff_mm.7.man (Macros) <INDP>: Clarify operation.
+
+	Fixes <https://savannah.gnu.org/bugs/?64206>.
+
+2023-02-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mm: Add `--help` option support to mmroff.
+
+	* mmroff.pl: Recognize `--help` option.
+	* mmroff.1.man (Synopsis, Options): Document.
+
+2023-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (H, SETR): Trivially refactor.  Rename register to
+	conform to convention: `hd-mark-trimmed` -> `hd@mark-trimmed`.
+	This register is used outside of its "module", "hd".
+
+2023-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (H, LI): Trivially refactor.  Annotate and test
+	threshold registers consistently.
+
+2023-02-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Fix code style nit.  Except for initial register
+	tests for GNU troff formatter and compatibility mode, migrate
+	special character, register, and string interpolation escape
+	sequences from `(xx` form to `xx`.  Also rewrite an instance
+	of `\nP` to `\nP`.
+
+2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	When register `Pt` was 2, paragraphs immediately following
+	displays and lists were being indented, contrary to DWB mm
+	behavior.
+
+	* m.tmac: Replace `par@ind-flag` register with two separate
+	state bits, `par*indentation-eligible` and
+	`par@suppress-indentation`.
+	(P, nP): Remove complex test for deciding whether the current
+	paragraph is being set immediately after a heading.
+	(P): Set `par*indentation-eligible` to the logical complement of
+	`par@suppress-indentation`.  Call `par@doit` (which underlies
+	both `P` and `nP`) unconditionally.
+	(nP): Force `par*indentation-eligible` off, since numbered
+	paragraphs are not influenced by a `Pt` value of "2" in DWB mm.
+	{The paragraph number occupies the indentation space.}
+	(par@doit): Introduce local register `par*do-indent`,
+	manipulate it, and use it to control `ti` request instead of
+	scattering the request across multiple locations.  Remove this
+	register when done.  Clear `par@suppress-indentation` at end,
+	since after indentation is suppressed once, it should not happen
+	again until a special circumstance (the setting of a heading,
+	display, or list) arises.
+	(H): Convert test of `hd*htype` register, which tells us if
+	we're setting a run-in heading or not, from `if` to `ie`.  (The
+	first paragraphing macro call after a run-in heading should
+	_not_ have its indentation suppressed, because the material
+	after the heading title constitutes a first pagraph.)  In the
+	true arm, set `par@suppress-indentation`; in the new else arm,
+	clear it.  This replaces the "complex test" above, and seems
+	much more straightforward and reliable.  Stop manipulating
+	`par@ind-flag`.
+	(df@end, ds@end, LC): Set `par@suppress-indentation` instead of
+	clearing `par@ind-flag`.
+	(LE): Set `par@suppress-indentation`.
+
+	Fixes <https://savannah.gnu.org/bugs/?54909>.  Thanks to Jeff
+	Conrad for the report.
+
+2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #54909.
+
+	* tests/P-indentation-works.sh: Do it.
+	* mm.am (mm_TESTS): Run test.
+
+2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (df@print-float): Eliminate spew at high debug levels.
+	This macro gets called even when there aren't any floating
+	displays pending, so we cannot assume that related registers are
+	defined.
+
+2023-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (P): Fix missing backslash after brace escape sequence.
+	Problem introduced by me in 3b1afbdb8e, 6 January.
+
+2023-01-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Help user navigate the document type macros.  Stop
+	setting up the formatter to throw "unrecognized macro"
+	diagnostics for macros that are plainly documented in
+	groff_mm(7).
+	(@disable): New macro takes a list of macros whose definitions
+	are replaced with a warning diagnostic about how they're no
+	longer unavailable due to use of another document type macro
+	already called, identified by new string `@cover`.
+	(TL, MT, COVER, LT, LO): Define `@cover` and call `@disable`.
+	Drop existing diagnostics that did a similar thing as above,
+	more verbosely.
+
+2023-01-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Revise diagnostic messages.  Use a consistent message
+	format, including a space after a colon and the name of the
+	complaining macro.
+	(pg@header): Drop unnecessary empty comment at end of macro
+	call.  Macro call syntax differs from `ds` request syntax.
+	(2C, MC, FD, FS, FE, DF, LB, LI, LE, LC, AL, ML, VL, BL, DL, RL)
+	(BVL, TH, TE, PS, B1, B2, APPSK, AS, SETR, GETST, GETHN, GETPN)
+	(INITI, IND, LT, LO): Refer to self with `\$0` escape sequence
+	instead of a literal.
+	(2C, MC, PS): Throw fatal error immediately instead of doing
+	other processing first.
+	(2C, MC, FD, FS, FE, DF, ds@set-format, ds@end, LB, LI, LE, LC)
+	(AL, ML, VL, BL, DL, RL, BVL, TH, TE, B1, B2, APPSK, AS, SETR)
+	(GETST, GETHN, GETPN, INITI, IND, let*lt-sign, LT, LO): Stop
+	unnecessarily quoting arguments to @error macro.
+	(FD, LB, VL, BVL, APPSK, SETR, GETST, GETHN, GETPN, INITI):
+	State quantities of expected and actual arguments.
+	(FS, FE, LC, B1, INITI): Clarify message.
+	(DF, DS): Store macro name in `ds@macro` for use in later
+	diagnostics thrown by internal macros.
+	(DS): Drop dead store to register `XXX`; debugging detritus?
+	(ds@set-format): Use `ds@macro`.
+	(ds@set-format, let*lt-sign, LT, LO): Bracket unrecognized
+	argument in single quotes.
+	(ds@set-format): Characterize argument as "unrecognized", not
+	"wrong".  Similarly with the fill style.
+	(LI, LE, IND): Offer advice.
+	(LE): Describe problem in same terms as `LI` ("no list active").
+	(LC): Validate argument as numeric expression and die with
+	diagnostic if it isn't one.
+	(AL, ML, VL, BL, DL, RL, BVL): Weaken fatal diagnostic to
+	warning; excess arguments are not a serious problem.
+	(PS): Simplify control flow; since @error does not return,
+	convert `ie` request to `if` and make `el` branch unconditional.
+	(RP): Weaken fatal diagnostic to warning and return early;
+	calling this macro without any references defined does no
+	structural damage to a document.
+	(INITI): Remove redundant conditional.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (IX): Delete.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (MC): Throw internal error if we don't leave
+	`pg*cols-per-page` in a valid state after invalidating it to
+	count columns.  Also simplify expression.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (1C): Warn and return early instead of bombing out if
+	called when multiple columnation is inactive.  A no-op should
+	not be a fatal error.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (@abort): Introduce macro for internal errors,
+	unconditionally reporting a backtrace...
+	(misc@pop-set, hd@split, MULN, df@print-float, IND): ..and use
+	it instead of `@error` for problems with internal state.
+	(IND): Also fix botch in reported error.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (SA): Reject an argument value > 1 as invalid.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (P): Quote unrecognized argument in warning diagnostic.
+	(OK, PM): Refactor to use `\$0`.
+	(1C): Clarify that formatting can go wrong if you suppress a
+	page break when returning from multi- to single-column mode with
+	a footnote pending.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (Tm): Align with definition of `Sm`, with analogous
+	fallback definitions.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (Sm): Implement string for service mark, for DWB mm
+	compatibility.
+	* groff_mm.7.man: Document it.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (CS): Define to throw diagnostic when used without ".MT
+	4".  (Later, if the "4.MT" file is sourced, this definition is
+	replaced.)
+	* groff_mm.7.man (Description): Clarify `CS` support status.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (MOVE, SM, AT, LO): Weaken diagnostics when given no
+	arguments from (fatal) errors to warnings, then return.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (PIC): Bomb out (with diagnostic) if either of the
+	width or height arguments are not numeric expressions.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (EPIC): Handle and shift off a leading "-L" argument
+	before checking argument count.  Then, if fewer than two
+	arguments remain, throw warning diagnostic and return early
+	instead of bombing out.  Do bomb out (with diagnostic) if either
+	of the width or height arguments are not numeric expressions.
+	Fix bug which prevented third argument from being interpreted.
+	Annotate potential future development.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (AU): Partially revert commit 4fd984adc9, 2021-07-17.
+	`AU` can be called for the sole purpose of "closing" a document
+	title "opened" with `TL`.
+	* groff_mm.7.man (Macros) <AU>: Update description.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (TM): Warn if called without arguments.
+
+2023-01-16  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (AST): Preserve any user-specified leading spaces in
+	argument.
+
+2023-01-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (P): Warn if argument is non-numeric, and discard it.
+	Also warn if argument is out of range; people accustomed to
+	setting the `Pt` register to 2 might mistakenly believe it to be
+	meaningful here.
+
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mm/0.MT:
+	* mm/5.MT: Drop never-read register `cov*mt0-ind`.
+
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Improve cover sheet diagnostics.
+
+	* m.tmac (MT): Warn and ignore if `COVER` or self already
+	called.
+	(COVER): Warn and ignore if `MT` already called.
+	* mm/0.MT (cov@print-title): Abort if title not defined; tell
+	user how to use the macros.
+	(cov@print-authors): Add similar paranoid diagnostic that I
+	don't think is reachable (since you _have_ to call `AU` to
+	"close" `TL`).
+	* mm/4.MT (cov@print-title, cov@print-authors):
+	* mm/5.MT (cov@print-title): As "0.MT".
+
+	* mm/4.MT: Get rid of spurious blank line in file.
+
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Fix Savannah #63613.
+
+	* mm/0.MT (cov*print-authors): Iterate through _all_ technical
+	memorandum numbers instead of stopping one shy of the last.
+	Problem appears to date back to introduction of TM support for
+	memorandum type 1 in commit a48ab7b6d (groff 1.05, 1992-03-18).
+
+	Fixes <https://savannah.gnu.org/bugs/?63613>.
+
+2023-01-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #63613.
+
+	* tests/MT-1-reports-all-TM-numbers.sh: Do it.
+	* mm.am (mm_TESTS): Run test.
+
+2022-12-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (let*mt-sign): Check strings populated by optional
+	arguments to `AU` macro for existence before interpolating them.
+
+	Fixes <https://savannah.gnu.org/bugs/?24049>.  Thanks to Werner
+	Lemberg for the report.
+
+2022-11-22  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mse.tmac: Set `pg*footer-size` to four vees, not four basic
+	units; the latter is too small by orders of magnitude on
+	typesetting output devices.
+
+	Fixes <https://savannah.gnu.org/bugs/?63398>.  Thanks to Hans
+	Bezemer for the report.
+
+2022-11-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #63398.
+
+	* tests/mse_has-sufficient-footnote-space.sh: Do it.
+	* mm.am (mm_TESTS): Run test.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mm: Add `--version` option support to mmroff.
+
+	* mm.am (mmroff): Replace `@VERSION@` token in script.
+	* mmroff.pl: Recognize `--version` option.
+	* mmroff.1.man (Synopsis, Options): Document.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mmroff.pl: Add proper diagnostic subroutine.  Add "progname"
+	scalar to store the name of the program.
+	(Die): New subroutine.
+	(print_index, top level): Call Die() when encountering
+	prohibitive problems instead of flinging a string into a void
+	context.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mmroff.pl: Enable Perl warnings.
+
+2022-10-09  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mm: Refactor generation of "mmroff" script.
+
+	* mmroff.pl: Replace absolute filespec with `@PERL@` replacement
+	token.  This is documentary; the filespec was getting replaced
+	anyway.
+	* mm.am (mmroff): Use more idiomatic token replacement strategy.
+	Also create target as a .tmp-suffixed file at first since it is
+	not initially executable, so that we don't race against anything
+	needing to run it in a parallelized build.  (This is a
+	hypothetical concern; at present, nothing runs mmroff during the
+	build.)
+
+2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (pg@header): Add page length sufficiency check.
+
+	Fixes <https://savannah.gnu.org/bugs/?24048>.  Thanks to Werner
+	Lemberg for the report.
+
+2022-10-02  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #24048.
+
+	* tests/short-pages-do-not-overflow-stack.sh: Test it.
+	* mm.am (mm_TESTS): Run test.
+
+2022-09-17  Nikita Ivanov <nikita.vyach.ivanov@gmail.com>
+
+	* mm/ms.cov (cov@print-title, cov@print-authors): Escape
+	newlines when beginning conditional blocks.
+
+	Fixes <https://savannah.gnu.org/bugs/?63075>.  Problems
+	introduced by me in commits 59d1fd7a5e and 4fd984adc9, both
+	2021-07-17. --GBR
+
+2022-09-16  Nikita Ivanov <nikita.vyach.ivanov@gmail.com>
+
+	* m.tmac (misc@ev-keep): Select configured default font family,
+	as with `.fam H` at the top of the document, for example, when
+	switching to new environment.
+
+	Fixes <https://savannah.gnu.org/bugs/?63067>.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (PY): Add new macro.
+	(PE): Replace `init@reset` call with `PY` (and then space by
+	half a vee as before).
+
+	* groff_mm.7.man (PY): Document it.
+
+	Fixes <https://savannah.gnu.org/bugs/?62900>.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (@warning, @error): Stop pointlessly using no-break
+	control character when invoking the `tm` request, which never
+	causes a break in formatted output.  (Management of the standard
+	output and standard error streams is the user's responsibility.)
+	(@error): Drop old-fashioned asterisk banners around error
+	diagnostics.  Stop invoking `ab` with redundant and sometimes
+	misleading arguments.  In groff 1.23, `ab` exits silently if
+	given none.  We've already issued a diagnostic and moreover not
+	all problems are with "syntax"; some are semantic.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (PS): Validate better; check for 2 arguments exactly.
+
+2022-08-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (PS): Refactor; drop dead code.  The `pic*in` register
+	was used only for dead stores; it was never read or tested.
+
+2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (initialization): In nroff mode, surround automatically
+	numbered footnote markers in body text with square brackets, as
+	groff me(7) and ms(7) do.
+
+2022-08-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (initialization): Recognize new register `V` for
+	setting the vertical spacing from the command line, instead of
+	blindly setting the vertical spacing two points larger than the
+	type size.  Handle setting of `V` and type size `S` in case they
+	are given with an appended scaling unit, using the same
+	technique as groff ms(7)--if the values are over 1,000, assume
+	that conversion to basic units by the formatter has already
+	taken place.
+	* groff_mm.7.man (Registers) <S, V>: Document it.
+
+2022-08-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (:p): Define register as an alias of `ft*nr`; the
+	former name is a documented DWB mm feature.
+
+2022-08-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* groff_mm.7.man: Document more features.
+	(Macros) <)E, VM>: Document these DWB mm internals as exposed by
+	groff mm.
+	(Macros) <B1, B2, MC>: Document as GNU extensions.
+	(Strings) <BU, Ci, F>: Document.
+	(Registers) <:R, Au, Ex, Fg, H8...H14, Oc, S>: Document.
+
+2022-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* groff_mm.7.man: Document further differences between DWB mm
+	and groff mm, including several unimplemented features.
+
+2022-07-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Remove pointless conditionals in initialization.
+	Simplify if-else request pairs that did the same thing in both
+	branches.
+
+2022-07-28  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* groff_mm.7.man: Document `NE` macro.
+
+2022-03-15  Damian McGuckin <damianm@esi.com.au>
+
+	* m.tmac (eq@check): Compensate for display indentation when
+	setting equation label.
+
+	Fixes <https://savannah.gnu.org/bugs/?62190>.
+
+2022-04-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Regression-test Savannah #62190.
+
+	* tests/place-equation-labels-correctly-in-displays.sh: Test it.
+	* mm.am (mm_TESTS): Run test.
+
+2021-08-12  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac (R): Alter to work analogously to `B` and `I` macros;
+	accept multiple arguments if given, and alternate roman with
+	previous font.  Stop explicitly turning off underlining.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Refactor author title handling.
+
+	* m.tmac (AU): Initialize `cov*at!` array element to zero for
+	current author number (`AT` already updates it).
+
+	* mm/ms.cov (cov@print-authors): Enforce requirement documented
+	in groff_mm(7) that .AU is mandatory if .COVER is used.  Emit
+	diagnostic if `cov*au` is not defined, and skip remainder of
+	macro definition.  Test for existence of authors' titles
+	differently; now that `cov*at!` (a count of titles for the
+	current author) is guaranteed to be initialized, we can use it
+	as part of a while loop condition, instead of the hard-coded "9"
+	as an arbitrary limit on the allowed quantity of author titles
+	{though surely even that is obnoxiously high in practice}, and
+	more importantly avoid using a \w escape to measure the width of
+	the interpolation of a potentially undefined string.  Use `nop`
+	to indent text output.  Delete apparent typo causing `mac`
+	warning with respect to undefined `.` macro.  Introduce
+	temporary strings for the author and author title "loop indices"
+	to shorten and clarify logic.  Remove them when done.
+
+	Fixes <https://savannah.gnu.org/bugs/?60926>.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mm/ms.cov (cov@print-title): Enforce requirement documented in
+	groff_mm(7) that .TL is mandatory if .COVER is used.  Emit
+	diagnostic if `cov*title` is not defined, and skip remainder of
+	macro definition.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mm/ms.cov (COVEND): Fix thinko; test for existence of
+	`cov*abs-arg` register with `r` conditional operator, not `d`.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Stop emitting debugging diagnostic using undefined
+	string.  Problem exposed by commit
+	d6d98d2b3e0ad070037073bb288bbaee3fc04cf0, 8 December 2013.
+
+	Fixes <https://savannah.gnu.org/bugs/?60397>.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Stop installing empty macro files.
+
+	* mm.am: Delete variable `MMLOCALE`.
+	(install_mm): Delete `for` loop that touches the files.
+	(uninstall_mm): Delete `for` loop that deletes the files.
+	* m.tmac: Update initializtion.
+	  - Load the `\*@country_locale` file with `msoquiet` instead
+	    of `mso`.
+	  - Add version check to require groff 1.23 or later, since
+	    the `msoquiet` request is now being used.
+	  - Move "include guard" to follow the compatibility mode and
+	    groff version checks.  Remove its `do` prefix.
+	* groff_mm.7.man (Localization): Migrate topic into its own
+	subsection and update discussion.
+
+	Fixes <https://savannah.gnu.org/bugs/?60700>.
+
+2021-07-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mm/ms.cov (cov@print-firm): Do nothing if the `cov*firm`
+	string is not defined.  Silences a `mac` warning and prevents
+	the document date from being incorrectly aligned.
+
+	* tests/ms_cover_sheet_robust_to_missing_AF.sh: Test it.
+	* mm.am (mm_TESTS): Run test.
+
+	Fixes <https://savannah.gnu.org/bugs/?60915>.
+
+2021-07-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Rename `cov*mt-addresse` to `cov*mt-addressee`.
+	* NOTES: Update the only place the foregoing is documented.
+
+2021-05-31  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* groff_mm.7.man (Description/Macros) <LT>: Document the "SP"
+	{simplified} letter style more completely.  Salutations and
+	formal closings are omitted.
+
+	Solves the remaining part of bug #60373, "the formal closing is
+	omitted completely".  And, regarding the salutation, #60390.
+
+	Fixes <https://savannah.gnu.org/bugs/?60373> and
+	<https://savannah.gnu.org/bugs/index.php?60390>.
+
+2021-05-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	* m.tmac (let@sg_SP): Stop placing a comma after the first
+	argument (an author name set by AU) if the second argument is
+	empty (an author title set by AT).
+
+	Solves another part of bug #60373, "the writer's name at the
+	bottom is followed by a trailing comma".
+
+	Fixes <https://savannah.gnu.org/bugs/?60389>.
+
+2021-05-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	* m.tmac (let@print-head): Quote the interpolation of the string
+	`let*lo-SJ`.
+
+	Solves part of bug #60373, "the subject line shows only the
+	first word".
+
+	Fixes <https://savannah.gnu.org/bugs/?60388>.
+
+2021-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression tests for Savannah #60373.
+
+	* tests/LT_SP_AU_without_AT_works.sh:
+	* tests/LT_SP_multi-word_LO_SJ_works.sh: Add tests.
+	* mm.am (mm_TESTS): Run tests.
+
+2021-05-30  Tadziu Hoffman <hoffmann@usm.uni-muenchen.de>
+
+	Fix Savannah #57034.
+
+	* m.tmac (AT): Count author title declarations.
+	(let*mt-sign): Use correct index when iterating author names.
+	Prevent page break between author names and titles.  Iterate
+	author titles and write them.
+
+	Fixes <https://savannah.gnu.org/bugs/?57034>.
+
+2021-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Add regression test for Savannah #57034.
+
+	* tests/MT_5_includes_AT_in_SG.sh: Test it.  Thanks to Ken
+	Mandelberg for the reproducer.
+	* mm.am (mm_TESTS): Add variable storing script name.
+	(TESTS): Append `mm_TESTS` to run it.
+	(EXTRA_DIST):  Append `mm_TESTS` to ship it.
+
+2021-05-30  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
+
+	* mm/5.MT (cov@print-title): Fix missing diagnostic.  Memorandum
+	type 5 now requires a title to be declared with .TL.
+
+	Fixes <https://savannah.gnu.org/bugs/?59563>.
+
+2021-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mm: Cease warning level manipulation.
+
+	Stop mm macro package from manipulating warnings.
+
+	* m.tmac: Remove code that attempted to enable all warnings if
+	none were given on the command line.  It did this by simply
+	comparing the value of the warning register (\n.warn) against
+	the default value; but of course, a user could specify -w
+	options that exactly matched the default and the test would not
+	be able to tell, causing puzzling and undesired behavior.
+	Furthermore, the hard-coded default was out of date and did not
+	correspond to recent releases of groff.  If you want all
+	warnings on, use the ".warn" request with no arguments in your
+	mm document or pass "-w w" to groff (see troff(1) or the Texinfo
+	manual for more on warnings).
+
+	See commit 5aa934e7, 20 February 2020.
+
+2021-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* examples/letter.mm: Revise to be a better example: use macro
+	package more effectively, follow *roff input conventions more
+	carefully, and incorporate more accurate comments.
+
+2021-05-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* m.tmac: Update diagnostics.  When aborting, explicitly tell
+	the user we are doing so (see
+	a334cc97abbdfb9c41e28fcd7c187b81a0a3ceac, 25 September 2020).
+	(@mm): Define new string to hold prefix for diagnostic messages.
+	(@warning, @error): Use @mm.  Reorder diagnostic messages to
+	conform with GNU Coding Standards.
+	(OK, PM): Use @warning instead of `tm` request directly.
+
+2019-09-10  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* Makefile.sim: Delete sed transformation of @G@.  It is no
+	longer needed.
+
 2018-03-01  Werner LEMBERG  <wl@gnu.org>
 
 	* m.tmac: Fix `.hy' value.
@@ -10,8 +671,8 @@
 
 2017-11-02  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-	examples/letter.mm: New; simple example of mm usage.
-	mm.am: Ship the file.
+	* examples/letter.mm: New; simple example of mm usage.
+	* mm.am: Ship the file.
 
 2015-08-22  Bernd Warken  <groff-bernd.warken-72@web.de>
 
@@ -522,7 +1183,7 @@
 	  It didn't setup the @pl, @ll and @po as it should, now it does.
 	* mgm_ref/mgm_roff renamed to mmroff -x
 	* fixed y2k-bug in \*DT
-	* \ncov*year removed, hope noone used that.
+	* \ncov*year removed, hope no one used that.
 	* ISODATE added with Iso as command line flag
 		(iso-date suggested by Paul Eggert)
 	* Added ISODATE to tmac.mse and removed local settings
@@ -588,7 +1249,7 @@
 	*   .S D should set the point size to \nS, not 10.
 	*   .S was setting the vertical spacing based on the old point size
 		instead of the new point size.
-	*   Got rid of a spurrious .br that prevented run-in headings from
+	*   Got rid of a spurious .br that prevented run-in headings from
 		working.
 	*   Reset the .SP counters in pg@header so that spacing on one page
 		won't affect spacing on subsequent pages.
@@ -613,7 +1274,7 @@
 Wed May 15 07:39:32 1996 Jörgen Hägg (jh at axis.se)
 
 	* version 1.29
-	* Syntax and scaling errror fixed, (thanks to Frazer Williams)
+	* Syntax and scaling error fixed, (thanks to Frazer Williams)
 	* DF/DE will now do a line-break before printing the display.
 	* Updated the manual for TB,FG,EX and EC.
 	* Added support for the ms- (and mgs-)macro .IX
@@ -738,7 +1399,7 @@
 	* bug in VERBON fixed, causing strange errors.
 	* section-page footer fixed.
 	* added support for numberregister S
-	* fixed bug with floating displays wich made floats to
+	* fixed bug with floating displays which made floats to
 	  generate space on a page, but broke page anyway.
 	* end-of-page trap reinstalled.
 
@@ -775,7 +1436,7 @@
 	  normal text, but it will still set .vs.
 	* SK was broken, will now produce the requested number of
 	  empty pages.
-	* dotted lines added to LIST OF FIGURES adn friends.
+	* dotted lines added to LIST OF FIGURES and friends.
 	  Also better linespacing.
 
 Mon Feb 22 12:41:06 1993 Joergen Haegg (jh at efd.lth.se)
@@ -843,7 +1504,7 @@
 	* page-break in .EQ moved.
 	* changed unit for footer-size and header-size from units to lines.
 	  Fixes problems with .S and page-breaks.
-	* \n% is now treated as a string, wich makes it possible
+	* \n% is now treated as a string, which makes it possible
 	  to assign new formats to it. Unfortunately, it was necessary
 	  to change the page-number-variable in GETPN to a string.
 	* Makefile.sub included. (Thank you, James)
@@ -997,13 +1658,15 @@
 
 ________________________________________________________________________
 
-Copyright 1991-2018 Free Software Foundation, Inc.
+Copyright 1991-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
+fill-column: 72
 mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/Makefile.sim -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/Makefile.sim Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/NOTES -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/NOTES Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/README -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/README Changed

@@ -1,39 +1,27 @@
-    Copyright (C) 1989-2018 Free Software Foundation, Inc.
+    Copyright (C) 1989-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-This is mgm, a macro package for groff.
+This is mm, a macro package for groff.
 
-It is supposed to be compatible with the DWB mm macros,
-and has several extensions.
+It is supposed to be compatible with the Documenter's Workbench (DWB) mm
+macros, and has several extensions.
 
-Submit bug reports at http://savannah.gnu.org/bugs/?group=groff with a
-description of the problem and a sample of text which reproduces the
-error.
-
-Don't forget to mention the version of mgm (look in the beginning
-of m.tmac) and the version of groff.
+Please submit bug reports using groff's 'BUG-REPORT' file to
+http://savannah.gnu.org/bugs/?group=groff.
 
 Any new ideas or improvements are welcome.
 
-Newest version is available here or at the groff repository.
-ftp://ftp.axis.se/pub/groff/mm<something>.gz
-
-You can install mgm as a separate package without the configure in groff
-with the following command:
-
-make -f Makefile.sim install
-
 This README should be bigger :-)
 
 /Jörgen Hägg
 
-Thanks to everyone who have sent me bug-reports and fixes.
+Thanks to everyone who have sent me bug reports and fixes.
 
 
-### Emacs settings
+##### Editor settings
 Local Variables:
 mode: text
 End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/examples/README -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/examples/README Changed

@@ -1,5 +1,5 @@
     -*- text -*-
-    Copyright (C) 1989-2018 Free Software Foundation, Inc.
+    Copyright (C) 1989-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -14,9 +14,9 @@
 		ms.cov.
 IND		A general indexing method, see manual for INITI.
 LT		The letter macro.
-LT.se		A Swedish example with the extra
-		Swedish macros for getting a letter conforming
-		to Swedish standard letter, both left and right adjusted.
+LT.se		A Swedish example with extra Swedish macros for
+		composing a letter conforming to Swedish standard style,
+		adjusted to left and right margins.
 ML		Marked list, an extended list type.
 MOVE		The MOVE macro, how to begin to print on an exact position.
 MUL		Enhanced multicolumn mode.
@@ -33,7 +33,7 @@
 
 
 And remember, check the manual for all string and number registers,
-I've made sure that mgm is useful in several languages;
+I've made sure that mm is useful in several languages;
 all English output can be redefined.
 
 For Swedish localization, check the manual for groff_mse and the

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/examples/letter.mm -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/examples/letter.mm Changed

@@ -1,11 +1,15 @@
+.\" Set a blank page header; our letter is a single page and does not
+.\" require the default numbering.
+.PH '''
 .\" Set point size to 14.
 .S 14
 .\" Set paragraph type to "indented".
 .nr Pt 1
-								1 November 2017
-.\" Set line spacing to double-spaced.
-.SP 2
-.\" Start display.
+.\" Put the date in a right-aligned display.
+.DS R
+30 May 2021
+.DE
+.\" Start display (left-aligned).
 .DS
 Mr. Ty Coon
 President of Vice, Intellectual Property and Licensing
@@ -14,20 +18,34 @@
 .\" End display.
 .DE
 Dear Mr. Coon,
+.
+.
 .\" Start new paragraph.
 .P
-I would like to request that your wholly-owned subsidiary, Yoyodyne, Inc.,
-disclaim all copyright interest in the program `Gnomovision' (which makes passes
-at compilers) written by Juliet Hacker prior to her employment with Yoyodyne.
+I would like to request that your wholly-owned subsidiary,
+Yoyodyne, Inc.,
+disclaim all copyright interest in the program `Gnomovision'
+(which makes passes at compilers)
+written by Juliet Hacker prior to her employment with Yoyodyne.
+.
+.
 .P
-Our colleagues at the Software Freedom Conservancy have determined and informed
-us that Ms. Hacker's employment agreement is a contract of adhesion.
+Our colleagues at the Software Freedom Conservancy have determined and
+informed us that Ms.\& Hacker's employment agreement is a contract of
+adhesion.
+.
+.
 .P
 Thank you for your prompt attention to this matter.
-.\" Set line spacing to single-spaced.
-.SP
-								Sincerely yours,
-.\" Leave room for signature.
-.SP 2
-								Tracy T. Jordan
-.\" vim: set noexpandtab textwidth=80:
+.
+.
+.\" Put the closing and signature in a right-aligned display as well.
+.DS R
+Sincerely yours,
+.\" Leave three "vees" (3 text line heights) of room for signature.
+.SP 3v
+.
+.
+Tracy T.\& Jordan
+.DE
+.\" vim: set noexpandtab textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/groff_mm.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/groff_mm.7.man Changed

@@ -1,19 +1,15 @@
 '\" t
-.TH GROFF_MM @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_mm \- memorandum macros for GNU roff
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_mm_C \n.C
-.cp 0
+.TH groff_mm @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_mm \- memorandum macros for GNU
+.I roff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -31,160 +27,458 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_mm_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY "groff \-m@TMAC_M_PREFIX@m"
-.RI  option
-\&.\|.\|.\&
-.RI  file
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
 .SY "groff \-m m@TMAC_M_PREFIX@m"
-.RI  option
-\&.\|.\|.\&
-.RI  file
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The groff mm macros are intended to be compatible with the DWB mm macros
-with the following limitations:
+The GNU implementation of the
+.I mm
+macro package is part of the
+.I groff
+document formatting system.
 .
-.TP
-.B \(bu
-No Bell Labs localisms are implemented.
+The
+.I mm
+package is suitable for the composition of
+letters,
+memoranda,
+reports,
+and books.
 .
-.TP
-.B \(bu
-The macros OK and PM are not implemented.
 .
-.TP
-.B \(bu
-groff mm does not support cut marks.
+.P
+Call an
+.I mm
+macro at the beginning of a document to initialize the package.
 .
+A simple
+.I mm
+document might use only
+.B P
+for paragraphing.
 .
-.LP
-.B m@TMAC_M_PREFIX@m
-is intended to support easy localization.
+Set numbered and unnumbered section headings with
+.B H
+and
+.BR HU ,
+respectively.
 .
-Use
-.B m@TMAC_M_PREFIX@mse
-as an example how to adapt the output format to a national standard.
+Change the style of the typeface with
+.BR B ,
+.BR I ,
+and
+.BR R ;
+you can alternate styles with
+.BR BI ,
+.BR BR ,
+.BR IB ,
+.BR IR ,
+.BR RB ,
+and
+.BR RI .
+.
+Several nestable list types are available via
+.BR AL ,
+.BR BL ,
+.BR BVL ,
+.BR DL ,
+.BR ML ,
+.BR RL ,
+and
+.BR VL ;
+each of these begins a list,
+to which
+.B LI
+adds an item and
+.B LE
+ends the (nested) list.
+.
+Customized list arrangements are supported by
+.BR LB .
+.
+.B DS
+and
+.B DF
+start static and floating displays,
+respectively;
+either is terminated with
+.BR DE .
+.
+.
+.P
+.I groff mm
+is intended to be compatible with the
+.I mm
+implementation found in the AT&T Documenter's Workbench (DWB),
+with the following limitations.
+.
+.
+.IP \bu 2n
+Omitted features include
+the logo and company name strings,
+.B }Z
+and
+.BR S ,
+respectively;
+the encoded company site location addresses recognized as the third
+argument to the
+.B AU
+macro;
+the
+.B Pv
+(\lqprivate\rq heading)
+register;
+and the
+.B OK
+(other keywords),
+and
+.B PM
+(proprietary markings)
+macros.
+.
+.
+.IP \bu 2n
+The
+.B CS
+(output cover sheet)
+macro is implemented only for memorandum type 4.
+.
+.
+.IP \bu
+The
+.I grap
+preprocessor is not explicitly supported;
+no
+.B G1
+and
+.B G2
+macros
+are defined.
+.
+.
+.IP \bu
+The registers
+.BR A ,
+.BR C ,
+.BR E ,
+.BR T ,
+and
+.BR U ,
+typically set from the
+.I troff \" generic
+or
+.I nroff \" generic
+command lines with DWB
+.IR mm ,
+are not recognized.
+.
+.
+.IP \bu
+When setting the registers
+.B L
+or
+.B W
+from the command line,
+use an explicit scaling unit to avoid surprises.
+.
+.
+.IP \bu
+DWB
+.IR mm 's
+.B nP
+macro indented the second line of a paragraph to align it with the start
+of the text of the first
+(after the paragraph number);
+.IR "groff mm" 's
+does not.
+.
+.
+.IP \bu
+Cut marks are not supported.
 .
-Localized strings are collected in the file
-.IR @MACRODIR@/ xx .tmac ,
+.
+.P
+DWB
+.I mm
+supported only seven levels of heading.
+.
+As a compatible extension,
+.I groff mm
+supports fourteen,
+introducing new registers
+.B H8
+through
+.BR H14 ,
+and affecting the interpretation of the
+.B HF
+and
+.B HP
+strings.
+.
+.
+.P
+Macro,
+register,
+and string descriptions in this page frequently mention each other;
+most cross references are to macros.
+.
+Where a register or string is referenced,
+its type is explicitly identified.
+.
+.IR mm 's
+macro names are usually in full capitals;
+registers and strings tend to have mixed-case names.
+.
+.
+.\" ====================================================================
+.SS "Document styles"
+.\" ====================================================================
+.
+.I groff mm
+offers three different frameworks for document organization.
+.
+.BR \%COVER /\: \%COVEND
+is a flexible means of preparing any document requiring a cover page.
+.
+.BR LT / LO
+aids preparation of typical Anglophone correspondence
+(business letters,
+for example).
+.
+The
+.B MT
+memorandum type mechanism implements a group of formal styles
+historically used by AT&T Bell Laboratories.
+.
+Your document can select at most one of these approaches;
+when used,
+each disables the others.
+.
+.
+.\" ====================================================================
+.SS Localization
+.\" ====================================================================
+.
+.I groff mm
+is designed to be easily localized.
+.
+For languages other than English,
+strings that can appear in output are collected in the file
+.IR @MACRODIR@/\: xx \:.tmac ,
 where
 .I xx
-denotes the two-letter code for the
-.IR language ,
-as defined in the ISO 639 standard.
+is an ISO\~639 two-letter language identifier.
 .
-For Swedish, this is \oqsv.tmac\cq \en not \oqse\cq, which
-is the ISO 3166 two-letter code for the
-.I country
-(as used for the output format localization).
+Localization packages should be loaded after
+.IR mm ;
+for example,
+you might format a Swedish
+.I mm
+document with the command
+.RB \lq "groff \-mm \-msv" \rq.
 .
 .
-.\"########################################################################
-.LP
-A file called
-.I locale
-or
-.RI country _locale
-is read after the initialization of the global variables.
+.P
+This package can also be localized by site or territory;
+for example,
+.I @MACRODIR@/\:@TMAC_M_PREFIX@mse\:.tmac
+illustrates how to adapt the output to a national standard using its ISO
+3166 territory code.
 .
-It is therefore possible to localize the macros with a different company
-name and so on.
+Such a package can define a string that causes a macro file
+.IR @MACRODIR@/\:mm/\:\% territory _locale
+to be loaded at package initialization.
 .
+If this mechanism is not used,
+.I @MACRODIR@/\:mm/\:\%locale
+is loaded instead.
 .
-.LP
-In this manual, square brackets are used to show optional arguments.
+No diagnostic is produced if these files do not exist.
 .
 .
 .\" ====================================================================
-.SS "Number registers and strings"
+.SS "Registers and strings"
 .\" ====================================================================
 .
-Many macros can be controlled by number registers and strings.
+Much
+.I mm
+behavior can be configured by registers and strings.
 .
-A number register is assigned with the
+A register is assigned with the
 .B nr
-command:
+request.
+.
 .
 .RS
-.LP
-.BI .nr\  "XXX \fR\fP\fB\+-\fP\fR\fPn \fR\fPi\fR\fP\""
+.P
+.B .nr
+.I ident
+.RB  \+- \c
+.I n
+.RI  i 
 .RE
 .
 .
-.LP
-.I XXX
+.P
+.I ident
 is the name of the register,
+and
 .IR n \~is
-the value to be assigned, and
-.IR i \~is
-the increment value for auto-increment.
+the value to be assigned.
 .
 .IR n \~can
-have a plus or minus sign as a prefix if an increment
-or decrement of the current value is wanted.
+be prefixed with a plus or minus sign if incrementation or
+decrementation (respectively) of the register's existing value
+.RI by\~ n
+is desired.
 .
-(Auto-increment or auto-decrement occurs if the number register is
-used with a plus or minus sign,
-.BI \rsn+ XXX 
-or
-.BI \rsn\- XXX \fR.)\fP
+If assignment of a (possibly) negative
+.IR n \~is
+required,
+further prefix it with a zero or enclose it in parentheses.
 .
+If
+.IR i \~is
+specified,
+the register is automatically modified
+.RI by \~i
+prior to interpolation if a plus or minus sign is included in the escape
+sequence as follows.
 .
-.LP
-Strings are defined with
-.BR ds .
 .
 .RS
-.LP
-\fB\&.ds\fP \fIYYY string\fP
+.P
+.B \rsn\c
+.RB  \+- \c
+.BI  ident 
 .RE
 .
 .
-.LP
-The string is assigned everything to the end of the line,
-even blanks.
+.P
+.IR i \~can
+be negative;
+it combines algebraically with the sign in the interpolation escape
+sequence.
 .
-Initial blanks in
-.I string
-should be prefixed with a double-quote.
 .
-(Strings are used in the text as
-.BI \rs* YYY \fR.)\fP
+.P
+Strings are defined with the
+.B ds
+request.
+.
+.
+.RS
+.P
+.B .ds
+.I ident contents
+.RE
+.
+.
+.P
+.I contents
+consumes everything up to the end of the line,
+including trailing spaces.
+.
+It is a good practice to end
+.I contents
+with a comment escape sequence
+.RB ( \rs\dq )
+so that extraneous spaces do not intrude during document maintenance.
+.
+To include leading spaces in
+.IR contents ,
+prefix it with a double quote.
+.
+Strings are interpolated with the
+.B \rs*
+escape sequence.
+.
+.
+.RS
+.P
+.B \rs*\c
+.BI  ident 
+.RE
+.
+.
+.P
+Register and string name spaces are distinct,
+but strings and macros share a name space.
+.
+Defining a string with the same name as an
+.I mm
+macro is not supported and may cause incorrect rendering,
+the emission of diagnostic messages,
+and an error exit status from
+.IR @g@troff .
 .
 .
 .\" ====================================================================
-.SS "Special formatting of number registers"
+.SS "Register format"
 .\" ====================================================================
 .
-A number register is printed with normal digits if no format has been
-given.
+A register is interpolated using Arabic numerals if no other format has
+been assigned to it.
+.
+Assign a format to a register with the
+.B af
+request.
 .
-Set the format with
-.BR af :
 .
 .RS
 .LP
-.BI .af\  "R c"
+.BI .af\~ "R c"
 .RE
 .
 .
 .LP
 .IR R \~is
 the name of the register,
+and
 .IR c \~is
 the format.
 .
+If
+.IR c \~is
+a sequence of Arabic numerals,
+their quantity defines a zero-padded minimum width for the interpolated
+register value.
+.
+.
 .RS
 .LP
 .TS
@@ -192,8 +486,8 @@
 lb lb
 l l.
 Form@Sequence
-1@0, 1, 2, 3, .\|.\|.
-001@000, 001, 002, 003, .\|.\|.
+1@0, 1, 2, 3, .\|.\|., 10, .\|.\|.
+001@000, 001, 002, 003, .\|.\|., 1000, .\|.\|.
 i@0, i, ii, iii, iv, .\|.\|.
 I@0, I, II, III, IV, .\|.\|.
 a@0, a, b, c, .\|.\|., z, aa, ab, .\|.\|.
@@ -207,39 +501,93 @@
 .\" ====================================================================
 .
 In
-.BR m@TMAC_M_PREFIX@m ,
-the fonts (or rather, font styles)
-.BR R \~(normal),
+.IR "groff mm" ,
+the fonts
+(or rather,
+font styles)
+.BR R \~(roman),
 .BR I \~(italic),
 and
 .BR B \~(bold)
-are hardwired to font positions
+are mounted at font positions
 .BR 1 ,
 .BR 2 ,
-and\~\c
-.BR 3 ,
+.RB and\~ 3 ,
 respectively.
 .
-Internally, font positions are used for backwards compatibility.
+Internally,
+font positions are used for backward compatibility.
 .
-From a practical point of view it doesn't make a big difference
-\en a different font family can still be selected with a call to the
-.B .fam
-request or using
-.BR groff 's
+From a practical point of view,
+it doesn't make a big difference\ema different font family can still
+be selected by invoking
+.IR groff 's
+.B fam
+request or using its
 .B \-f
 command-line option.
 .
-On the other hand, if you want to replace just, say, font
+On the other hand,
+if you want to replace just,
+for example,
+.RB font\~ I
+with Zapf Chancery Medium italic
+(available on
+.IR groff 's
+.B pdf
+and
+.B ps
+output devices),
+you have to use the
+.B fp
+request,
+replacing the font at position\~2 with
+.RB \lq .fp\~2\~ZCMI \rq).
+.
+Because the cover sheet,
+memorandum type,
+and
+.MR @g@refer @MAN1EXT@
+integration macros explicitly request fonts named
 .BR B ,
-you have to replace the font at position\~2 (with a call to
-\oq.fp\~2\~.\|.\|.\cq).
+.BR I ,
+and
+.BR R ,
+you will also need to remap these font names with the
+.B ftr
+request,
+for instance with
+.RB \lq .ftr\~I\~ZCMI \rq.
 .
 .
 .\" ====================================================================
-.SS Macros
+.SH Macros
 .\" ====================================================================
 .
+An explicitly empty argument may be specified with a pair of double
+quotes;
+to call a macro
+.B XX
+with an empty second argument but non-empty first and third ones,
+you could input the following.
+.
+.
+.P
+.RS
+.EX
+\&.XX foo \dq\dq baz
+.EE
+.RE
+.
+.
+.P
+Macro names longer than two characters are GNU extensions;
+some shorter names were not part of DWB
+.IR mm 's
+published interface but are documented aspects of
+.I groff mm.
+.
+.
 .TP
 .BI )E\  "level text"
 Add heading text
@@ -249,647 +597,838 @@
 which is either\~0 or in the range 1 to\~7.
 .
 See also
-.BR .H .
+.BR H .
+.
+This undocumented DWB
+.I mm
+macro is exposed by
+.I groff mm
+to enable customized tables of contents.
 .
-This macro is used for customized tables of contents.
 .
 .TP
-.BR 1C\   1 
-Begin one-column processing.
+.BR 1C\~  1 
+Format page text in one column.
 .
-A\~\c
-.B 1
-as an argument disables the page break.
+The page is broken.
+.
+.RB A\~ 1
+argument suppresses this break;
+its use may cause body text and a pending footnote to overprint.
+.
+See
+.BR 2C ,
+.BR MC ,
+and
+.BR NCOL .
 .
-Use wide footnotes, small footnotes may be overprinted.
 .
 .TP
 .B 2C
-Begin two-column processing.
-.
-Splits the page in two columns.
+Begin two-column formatting.
 .
-It is a special case of
+This is a special case of
 .BR MC .
-See also
-.BR 1C .
+.
+See
+.B 1C
+and
+.BR NCOL .
+.
 .
 .TP
 .B AE
-Abstract end, see
+Abstract end;
+stop collecting abstract text.
+.
+See
 .BR AS .
 .
+.
+.\" In DWB mm, the mnemonic for `AF` was "alternate first-page format",
+.\" and was described in the context of the `A` and `E` registers and
+.\" `}Z` and `S` strings, none of which we support.
 .TP
-.BI AF\ \fR\fP name-of-firm \fR\fP
-Author's firm, should be called before
-.BR AU ,
-see also
+.BR AF \~\c
+.IR firm-name 
+Specify firm associated with the document.
+.
+At most one can be declared;
+the firm name is used by memorandum types and available to cover sheets.
+.
+.B AF
+terminates a document title started with
+.BR TL ,
+and can be called without an argument for that purpose.
+.
+See
+.B MT
+and
 .BR COVER .
 .
+.
 .TP
-.BI AL\  \fR\fPtype\ \fR\fPtext-indent\  \fR\fP1\fR\fP
-Start auto-increment list.
+.BR AL \~\c
+.IR type \~ text-indent \~\c
+.BR 1 
+Begin an auto-incrementing numbered list.
 .
-Items are numbered beginning with one.
+Item numbers start at one.
 .
 The
 .I type
-argument controls the format of numbers.
+argument assigns the register format
+(see above)
+of the list item enumerators.
 .
-.RS
-.IP
-.TS
-tab(@);
-lb lb
-l l.
-Arg@Description
-1@Arabic (the default)
-A@Upper-case letters (A\(enZ)
-a@Lower-case letters (a\(enz)
-I@Upper-case roman
-i@Lower-case roman
-.TE
-.RE
+The default
+.RB is\~ 1 .
 .
-.IP
+An explicitly empty
+.I type
+also indicates the default.
+.
+A
 .I text-indent
-sets the indentation and overrides
+argument overrides register
 .BR Li .
-A third argument prohibits printing of a blank line before each item.
 .
-.TP
-.BI APP\  "name text"
-Begin an appendix with name
-.IR name .
+A third argument suppresses the blank line that normally precedes each
+list item.
 .
-Automatic naming occurs if
-.I name
-is
-.BR \dq\dq .
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
-The appendices start with\~\c
-.B A
-if automatic naming is used.
 .
-A new page is ejected, and a header is also produced if the number
-variable
-.B Aph
-is non-zero.
+.TP
+.BR APP \~\c
+.RI  id\~  title 
+Begin an appendix.
+.
+If the identifier
+.I id
+is omitted,
+it is incremented
+(or initialized,
+if necessary).
 .
-This is the default.
+The register format used for
+.I id
+is \lqA\rq.
 .
-The appendix always appears in the \oqList of contents\cq with
-correct page numbers.
+The page is broken.
+.
+The register
+.B Aph
+determines whether an appendix heading is then formatted.
 .
-The name \oqAPPENDIX\cq can be changed by setting the string
+This heading uses the string
 .B App
-to the desired text.
+followed by
+.IR id .
+.
+Appendices appear in any table of contents
+(see
+.BR TC ).
 .
 The string
 .B Apptxt
-contains the current appendix text.
+is set to
+.I title
+if the latter is present,
+and made empty otherwise.
+.
 .
 .TP
-.BI APPSK\  "name pages text"
-Same as
-.BR .APP ,
-but the page number is incremented with
-.IR pages .
+.BI APPSK\~ "id n" \~\c
+.RI  title 
+As
+.BR APP ,
+but increment the page number by
+.IR n .
+.
+Use this macro to \lqskip pages\rq when diagrams or other materials
+not formatted by
+.I @g@troff
+are included in appendices.
 .
-This is used when diagrams or other non-formatted documents are
-included as appendices.
 .
 .TP
-.BI AS\  "\fR\fParg \fR\fPindent\fR\fP"
-Abstract start.
+.BR AS\~ \c
+.IR placement \~ indentation 
+Abstract start;
+begin collecting abstract.
 .
-Indentation is specified in \oqens\cq, but scaling is allowed.
+Input up to the next
+.B AE
+call is included in the abstract.
 .
-Argument
-.I arg
-controls where the abstract is printed.
+.I placement
+influences the location of the abstract on the cover sheet of a
+memorandum
+(see
+.BR MT ).
 .
-.RS
+.BR \%COVER ,
+by contrast,
+ignores
+.I placement
+by default,
+but can be customized to interpret it.
+.
+.
+.IP
 .TS
 tab(@);
-lb lb
+lf(BI) lb
 l lx.
-\fBArg@Placement\fP
+placement@Effect
 0@T{
-Abstract is printed on page\~1 and on the cover sheet if used in the
-released-paper style (\fBMT 4\fP),
-otherwise it is printed on page\~1 without a cover sheet.
+The abstract appears on page\~1 and cover sheet if the document is a
+\lqreleased paper\rq memorandum
+.RB (\lq ".MT 4" \rq);
+otherwise,
+it appears on page\~1 without a cover sheet.
 T}
-1@Abstract is only printed on the cover sheet (\fBMT 4\fP only).
-2@T{
-Abstract is printed only on the cover sheet (other than \fBMT 4\fP only).
-The cover sheet is printed without a need for \fBCS\fP.
+1@T{
+The abstract appears only on the cover sheet
+.RB (\lq ".MT 4" \rq
+only).
 T}
+.\" XXX: This does not appear to be implemented.
+.\"2@T{
+.\"The abstract is printed only on the cover sheet (if not
+.\".BR ".MT 4" )
+.\".
+.\"The cover sheet is printed without a need for \fBCS\fP.
+.\"T}
 .TE
-.RE
+.
 .
 .IP
-An abstract is not printed at all in external letters (\fBMT 5\fP).
+An abstract does not appear at all in external letters
+.RB (\lq ".MT 5" \rq).
 .
-The
-.I indent
-parameter controls the indentation of both margins, otherwise normal
-text indentation is used.
+.RI A\~ placement
+of
+.B 2
+was supported by DWB
+.I mm
+but is not by
+.IR "groff mm" .
+.
+.
+.IP
+A second argument increases the indentation by
+.I indentation
+and reduces the line length by twice this amount.
+.
+A scaling unit of ens is assumed.
+.
+The default is\~0.
 .
+.
+.\" XXX: Do we need a macro for this?  Why is it not a string like App
+.\" or Licon?  It is usefully localizable.
 .TP
-.BI AST\  \fR\fPtitle\fR\fP
-Abstract title.
+.BR AST \~\c
+.RI  caption 
+Set the caption above the abstract to
+.IR caption ,
+or clear it if there is no argument.
 .
-Default is \oqABSTRACT\cq.
+The default is \lqABSTRACT\rq.
 .
-Sets the text above the abstract text.
 .
 .TP
-.BI AT\  "title1 \fR\fPtitle2 \fR.\|.\|.\fP"
-Author's title.
+.BI AT\~ title\c
+\~.\|.\|.
+Specify author's title(s).
 .
+If present,
 .B AT
-must appear just after each
+must appear just after the corresponding author's
 .BR AU .
 .
-The title shows up after the name in the signature block.
+Each
+.I title
+occupies an output line beneath the author's name in the signature block
+used by
+.B LT
+letters
+(see
+.BR SG )
+and in
+.B MT
+memoranda.
 .
-.TP
-.BI AU\  "\fR\fPname \fR\fPinitials \fR\fPloc \fR\fPdept \fR\fPext \fR\fProom \fR\fParg \fR\fParg \fR\fParg\fR\fP"
-Author information.
+The
+.B ms
+cover sheet style also uses it.
+.
+.
+.br
+.ne 7v
+.TP
+.BR AU \~\c
+.RI  name\~\c
+.RI  initials\~\c
+.RI  loc\~\c
+.RI  dept\~\c
+.RI  ext\~\c
+.RI  room\~\c
+.RI  arg1\~\c
+.RI  arg2\~\c
+.RI  arg3 
+Specify author.
+.
+.B AU
+terminates a document title started with
+.BR TL ,
+and can be called without arguments for that purpose.
+.
+Author information is used by cover sheets,
+.B MT
+memoranda,
+and
+.BR SG .
+.
+Further arguments comprise
+initials,
+location,
+department,
+telephone extension,
+room number or name,
+and up to three additional items.
 .
-Specifies the author of the memo or paper, and is printed on the cover
-sheet and on other similar places.
+Repeat
 .B AU
-must not appear before
-.BR TL .
+to identify multiple authors.
+.
+.
+.IP
+Use
+.BR WA / WE
+instead to identify the author for documents employing
+.BR LT .
 .
-The author information can contain initials, location, department,
-telephone extension, room number or name and up to three extra
-arguments.
 .
 .TP
-.BI AV\  \fR\fPname\  \fR\fP1\fR\fP
-Approval signature.
+.BR AV \~\c
+.IR name \~\c
+.BR 1 
+Format approval lines for a handwritten signature and date.
+.
+Two horizontal rules are drawn,
+with the specified
+.I name
+and the text of the string
+.B Letdate
+beneath them.
 .
-Generates an approval line with place for signature and date.
+Above these rules,
+the text in the string
+.B Letapp
+is formatted;
+a second argument replaces this text with a blank line.
 .
-The string \oqAPPROVED:\cq can be changed with variable
-.BR Letapp ;
-it is replaced with an empty lin if there is a second argument.
+See
+.BR LT .
 .
-The string \oqDate\cq can be changed with variable
-.BR Letdate .
 .
+.\" XXX: AVL is misnamed; it should have been called SGL or similar.
 .TP
-.BI AVL\  \fR\fPname\fR\fP
-Letter signature.
+.BR AVL \~\c
+.IR name 
+As
+.BR AV ,
+but the date,
+date rule,
+and approval notation
+.B Letapp
+are omitted.
 .
-Generates a line with place for signature.
 .
 .TP
-.BI B\  "\fR\fPbold-text \fR\fPprev-font-text \fR\fPbold \fR.\|.\|.\fP"
-Begin boldface.
+.BR B \~\c \" space in roman; we must use 2-font macro with \c
+.RI  bold-text\~\c
+.RI  previous-font-text \~.\|.\|.
+Join
+.I bold-text
+in boldface with
+.I previous-font-text
+in the previous font,
+without space between the arguments.
 .
-No limit on the number of arguments.
+If no arguments,
+switch font to bold style.
 .
-All arguments are concatenated to one word; the first, third and so on
-is printed in boldface.
 .
 .TP
 .B B1
-Begin box (as the ms macro).
+Begin boxed,
+kept display.
+.
+The text is indented one character,
+and the right margin is one character shorter.
 .
-Draws a box around the text.
+This is a GNU extension.
 .
-The text is indented one character, and the right margin is one
-character shorter.
 .
 .TP
 .B B2
-End box.
+End boxed,
+kept display.
+.
+This is a GNU extension.
 .
-Finishes the box started with
-.BR B1 .
 .
 .TP
 .B BE
-End bottom block, see
+End bottom block; see
 .BR BS .
 .
+.
 .TP
-.BI BI\  "\fR\fPbold-text \fR\fPitalic-text \fR\fPbold-text \fR.\|.\|.\fP"
-Bold-italic.
+.BR BI \~\c \" space in roman; we must use 2-font macro with \c
+.RI  bold-text\~\c
+.RI  italic-text \~.\|.\|.
+Join
+.I bold-text
+in boldface with
+.I italic-text
+in italics,
+without space between the arguments.
 .
-No limit on the number of arguments,
-see\~\c
-.BR B .
 .
 .TP
-.BI BL\  \fR\fPtext-indent\  \fR\fP1\fR\fP
-Start bullet list.
+.BR BL \~\c
+.IR text-indent \~\c
+.BR 1 
+Begin bulleted list.
 .
-Initializes a list with a bullet and a space in the beginning of each
-list item (see
-.BR LI ).
+Items are prefixed with a bullet and a space.
 .
+A
 .I text-indent
-overrides the default indentation of the list items set by number register
+argument overrides register
 .BR Pi .
 .
-A third argument prohibits printing of a blank line before each item.
+A second argument suppresses blank lines between items.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
+.
 .
 .TP
-.BI BR\  "\fR\fPbold-text \fR\fProman-text \fR\fPbold-text \fR.\|.\|.\fP"
-Bold-roman.
-No limit on the number of arguments.
+.BR BR \~\c \" space in roman; we must use 2-font macro with \c
+.RI  bold-text\~\c
+.RI  roman-text \~.\|.\|.
+Join
+.I bold-text
+in boldface with
+.I roman-text
+in roman style,
+without space between the arguments.
+.
 .
 .TP
 .B BS
-Bottom block start.
+Begin bottom block.
 .
-Begins the definition of a text block which is printed at the bottom
-of each page.
+Input is collected until
+.B BE
+is called,
+and output between the footnote area and footer of each page.
 .
-The block ends with
-.BR BE .
 .
+.\" XXX: Couldn't this have been done with an extra parameter to `VL`?
+.\" Or a register influencing VL behavior?
 .TP
-.BI BVL\  "text-indent \fR\fPmark-indent\ " \fR\fP1\fR\fP
-Start of broken variable-item list.
+.BR BVL \~\c
+.IR text-indent \~ mark-indent \~\c
+.BR 1 
+Begin broken variable-item
+(or \lqtagged\rq)
+list.
 .
-Broken variable-item list has no fixed mark,
-it assumes that every
-.B LI
-has a mark instead.
+Each item is expected to supply its own mark.
 .
-The text always begins at the next line after the mark.
+The line is always broken after the mark;
+contrast
+.BR VL .
 .
 .I text-indent
-sets the indentation to the text, and
+sets the indentation of the text,
+and
 .I mark-indent
-the distance from the current indentation to the mark.
+the distance from the current list indentation to the mark.
+.
+A third argument suppresses the blank line that normally precedes each
+list item.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
-A third argument prohibits printing of a blank line before each item.
 .
 .TP
-.BI COVER\  \fR\fParg\fR\fP
-Begin a coversheet definition.
+.BR \%COVER \~\c \" space in roman; we must use 2-font macro with \c
+.RI  style 
+Begin a cover page description.
 .
-It is important that
-.B .COVER
-appears before any normal text.
-.
-This macro uses
-.I arg
-to build the filename
-.IR @TMAC_MDIR@/ arg .cov .
-.
-Therefore it is possible to create unlimited types of cover sheets.
+.B \%COVER
+must appear before the body text
+(or main matter)
+of a document.
 .
+The argument
+.I style
+is used to construct the file name
+.IR @TMAC_MDIR@/\: style \:.cov
+and load it with the
+.B mso
+request.
+.
+The default
+.I style
+is
+.BR ms ;
+the
 .I ms.cov
-is supposed to look like the ms cover sheet.
-.
-.B .COVER
-requires a
-.B .COVEND
-at the end of the cover definition.
+file prepares a cover page resembling those of the
+.I ms
+package.
+.
+A
+.I .cov
+file must define a
+.B \%COVEND
+macro,
+which a document must call at the end of the cover description.
+.
+Use cover description macros in the following order;
+only
+.B TL
+and
+.B AU
+are required.
 .
-Always use this order of the cover macros:
 .
-.RS
 .IP
-.nf
+.EX
 \&.COVER
 \&.TL
 \&.AF
 \&.AU
 \&.AT
 \&.AS
+.ne 2v
 \&.AE
 \&.COVEND
-.fi
-.RE
+.EE
 .
-.IP
-However, only
-.B .TL
-and
-.B .AU
-are required.
 .
 .TP
 .B COVEND
-Finish the cover description and print the cover page.
+End the cover description.
 .
-It is defined in the cover file.
 .
 .TP
 .B DE
-Display end.
-.
-Ends a block of text or display that begins with
+End static or floating display begun with
 .B DS
 or
 .BR DF .
 .
+.
 .TP
-.BI DF\  "\fR\fPformat \fR\fPfill \fR\fPrindent\fR\fP"
-Begin floating display (no nesting allowed).
+.BR DF\~ \c
+.IR format \~ fill \~ right-indentation 
+Begin floating display.
 .
-A floating display is saved in a queue and is printed in the order entered.
-.IR Format ,
-.IR fill ,
-and
-.I rindent
-are the same as in
+A floating display is saved in a queue and output in the order entered.
+.
+Arguments are handled as in
 .BR DS .
-Floating displays are controlled by the two number registers
+.
+Floating displays cannot be nested.
+.
+Placement of floating displays is controlled by the registers
 .B De
 and
 .BR Df .
 .
-.IP
-.B De register
-.
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@T{
-Nothing special, this is the default.
-T}
-1@T{
-A page eject occurs after each printed display,
-giving only one display per page and no text following it.
-T}
-.TE
-.RE
-.
-.IP
-.B Df register
-.
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@T{
-Displays are printed at the end of each section (when section-page
-numbering is active) or at the end of the document.
-T}
-1@T{
-A new display is printed on the current page if there is enough space,
-otherwise it is printed at the end of the document.
-T}
-2@T{
-One display is printed at the top of each page or column
-(in multi-column mode).
-T}
-3@T{
-Print one display if there is enough space for it,
-otherwise it is printed at the top of the next page or column.
-T}
-4@T{
-Print as many displays as possible in a new page or column.
-A page break occurs between each display if
-.B De
-is not zero.
-T}
-5@T{
-Fill the current page with displays and the rest beginning at a new page
-or column.
-(This is the default.)
-A page break occurs between each display
-if \fBDe\fP is not zero.
-T}
-.TE
-.RE
 .
 .TP
-.BI DL\  \fR\fPtext-indent\  "\fR\fP\fB1\fP \fR\fP\fB1\fP\fR\fP"
-Dash list start.
+.BR DL \~\c
+.IR text-indent \~\c
+.BR 1 
+Begin dashed list.
 .
-Begins a list where each item is printed after a dash.
+Items are prefixed with an em dash and a space.
 .
+A
 .I text-indent
-changes the default indentation of the list items set by number
-register
+argument overrides register
 .BR Pi .
 .
-A second argument prevents an empty line between each list item.
+A second argument suppresses blank lines between items.
 .
-See
-.BR LI .
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
-A third argument prohibits printing of a blank line before each item.
 .
 .TP
-.BI DS\  "\fR\fPformat \fR\fPfill \fR\fPrindent\fR\fP"
-Static display start.
+.BR DS \~\c
+.IR format \~\c
+.IR fill \~\c
+.IR right-indentation 
+Begin static display.
 .
-Begins collection of text until
-.BR DE .
+Input until
+.B DE
+is called is collected into a display.
 .
-The text is printed together on the same page, unless it is longer
-than the height of the page.
+The display is output on a single page unless it is taller than the
+height of the page.
 .
 .B DS
-can be nested arbitrarily.
+can be nested
+(contrast with
+.BR DF ).
 .
-.IP
-.B format
 .
-.RS
 .IP
 .TS
 tab(@);
-l lx.
-\dq\dq@No indentation.
-none@No indentation.
-L@No indentation.
+Lf(BI) Lb
+L Lx.
+format@Effect
+\fInone\f@Do not indent the display.
+L@Do not indent the display.
 I@T{
-Indent text with the value of number register
-.BR Si .
+Indent text by
+.BR \rsnSi .
 T}
 C@Center each line.
 CB@Center the whole display as a block.
 R@Right-adjust the lines.
 RB@Right-adjust the whole display as a block.
 .TE
-.RE
 .
-.IP
-The values \oqL\cq, \oqI\cq, \oqC\cq, and \oqCB\cq can
-also be specified as \oq0\cq, \oq1\cq, \oq2\cq, and
-\oq3\cq, respectively, for compatibility reasons.
 .
 .IP
-.B fill
+The values \lqL\rq,
+\lqI\rq,
+\lqC\rq,
+and \lqCB\rq can also be specified as \lq0\rq,
+\lq1\rq,
+\lq2\rq,
+and
+\lq3\rq,
+respectively,
+for compatibility with
+.RI DWB\~ mm.
+.
 .
-.RS
 .IP
 .TS
 tab(@);
-l l.
-\dq\dq@Line-filling turned off.
-none@Line-filling turned off.
-N@Line-filling turned off.
-F@Line-filling turned on.
+Lf(BI) Lb
+L Lx.
+fill@Effect
+\fInone\f@Disable filling.
+N@Disable filling.
+F@Enable filling.
 .TE
-.RE
+.
+.
+.IP
+\lqN\rq and \lqF\rq can also be specified as \lq0\rq and
+\lq1\rq,
+respectively,
+for compatibility with
+.RI DWB\~ mm.
+.
 .
 .IP
-\oqN\cq and \oqF\cq can also be specified as \oq0\cq and
-\oq1\cq, respectively.
+A third argument
+reduces the line length by
+.I right-indentation.
+.
 .
 .IP
-By default, an empty line is printed before and after the display.
+.I mm
+normally
+places blank lines before and after the display.
 .
-Setting number register
+Set register
 .B Ds
-to\~0 prevents this.
+to\~0 to suppress these.
 .
-.I rindent
-shortens the line length by that amount.
 .
 .TP
-.BI EC\  "\fR\fPtitle \fR\fPoverride \fR\fPflag \fR\fPrefname\fR\fP"
-Equation title.
+.BR EC \~\c
+.RI  title \~ override \~ flag \~  refname 
+Caption an equation.
 .
-Sets a title for an equation.
+The caption consists of the string
+.B Liec
+followed by an automatically incrementing counter stored in the register
+.BR Ec ,
+punctuation configured by the register
+.BR Of ,
+then
+.I title
+(if any).
+.
+Use the
+.B af
+request to configure
+.BR Ec 's
+number format.
 .
-The
 .I override
-argument changes the numbering.
+and
+.I flag
+alter the equation number as follows.
+.
+Omitting
+.I flag
+and specifying
+.B 0
+in its place are equivalent.
 .
-.IP
-.B flag
 .
-.RS
 .IP
 .TS
 tab(@);
-l lx.
-none@T{
-.I override
-is a prefix to the number.
-T}
+Lf(BI) Lb
+L Lx.
+flag@Effect
 0@T{
-.I override
-is a prefix to the number.
+Prefix number with
+.IR override .
 T}
 1@T{
-.I override
-is a suffix to the number.
+Suffix number with
+.IR override .
 T}
 2@T{
-.I override
-replaces the number.
+Replace number with
+.IR override .
 T}
 .TE
-.RE
 .
-.IP
-.B EC
-uses the number register
-.B Ec
-as a counter.
 .
-It is possible to use
-.B .af
-to change the format of the number.
+.IP
+Equation captions are centered irrespective of the alignment of any
+enclosing display.
 .
-If number register
-.B Of
-is\~1, the format of title uses a dash instead of a dot after the
-number.
 .
 .IP
-The string
-.B Le
-controls the title of the List of Equations;
-default is \oqLIST OF EQUATIONS\cq.
+.I refname
+stores the equation number using
+.BR SETR ;
+it can be retreived with
+.RB \lq .GETST
+.IR refname \rq.
 .
-The List of Equations is only printed if number register
-.B Le
-is\~1.
+This argument is a GNU extension.
 .
-The default is\~0.
 .
-The string
-.B Liec
-contains the word \oqEquation\cq, which is printed before the
-number.
+.IP
+Captioned equations are listed in a table of contents
+(see
+.BR TC )
+if the Boolean register
+.B Le
+is true.
 .
-If
-.I refname
-is used,
-then the equation number is saved with
-.BR .SETR ,
-and can be retrieved with \oq\fB.GETST\fP \fIrefname\fP\cq.
+Such a list uses the string
+.B Le
+as a heading.
 .
-.IP
-Special handling of the title occurs if
-.B EC
-is used inside
-.BR DS / DE ;
-it is not affected by the format of
-.BR DS .
 .
 .TP
-.BI EF\  \fR\fParg\fR\fP
-Even-page footer,
-printed just above the normal page footer on even pages.
+.BR EF\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+Define the even-page footer,
+which is formatted just above the normal page footer on even-numbered
+pages.
 .
 See
 .BR PF .
 .
-.IP
-This macro defines string
+.B EF
+defines the string
 .BR EOPef .
 .
+.
 .TP
-.BI EH\  \fR\fParg\fR\fP
-Even-page header,
-printed just below the normal page header on even pages.
+.BR EH\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+Define the even-page header,
+which is formatted just below the normal page header on even-numbered
+pages.
 .
 See
 .BR PH .
 .
-.IP
-This macro defines string
+.B EH
+defines the string
 .BR TPeh .
 .
+.
 .TP
 .B EN
-Equation end, see
+End equation input preprocessed by
+.MR @g@eqn @MAN1EXT@ ;
+see
 .BR EQ .
 .
+.
 .TP
 .B EOP
-End-of-page user-defined macro.
+If defined,
+this macro is called in lieu of normal page footer layout.
 .
-This macro is called instead of the normal printing of the footer.
-.
-The macro is executed in a separate environment,
-without any trap active.
+Headers and footers are formatted in a separate environment.
 .
 See
 .BR TP .
 .
+.
 .IP
-.B Strings available to EOP
-.RS
 .TS
 tab(@);
-l l.
-EOPf@argument of \fBPF\fP
-EOPef@argument of \fBEF\fP
-EOPof@argument of \fBOF\fP
+Cb S
+Lb L.
+Strings available to EOP
+_
+EOPf@argument to \fBPF\fP
+EOPef@argument to \fBEF\fP
+EOPof@argument to \fBOF\fP
 .TE
-.RE
+.
 .
 .TP
 .BI EPIC\  "\fR\fP\fB\-L\fP\fR\fP width height \fR\fPname\fR\fP"
@@ -908,117 +1447,114 @@
 just give the size of the picture.
 .
 .B \-L
-left-adjusts the picture;
+left-aligns the picture;
 the default is to center.
 .
 See
 .BR PIC .
 .
-.TP
-.BI EQ\  \fR\fPlabel\fR\fP
-Equation start.
 .
-.BR EQ / EN
-are the delimiters for equations written for
-.BR @g@eqn (@MAN1EXT@).
+.TP
+.BR EQ \~\c
+.IR label 
+Start equation input preprocessed by
+.MR @g@eqn @MAN1EXT@ .
 .
-.BR EQ / EN
-must be inside of a
-.BR DS / DE
-pair, except if
 .B EQ
-is used to set options for
-.B @g@eqn
-only.
+and
+.B EN
+macro calls bracket an equation region.
 .
-The
+Such regions must be contained in displays
+.RB ( DS / DE ),
+except when the region is used only to configure
+.I @g@eqn
+and not to produce output.
+.
+If present,
 .I label
-argument appears at the right margin of the equation,
-centered vertically within the
-.BR DS / DE
-block,
-unless number register
-.B Eq
-is\~1.
+appears aligned to the right and
+centered vertically within the display;
+see register
+.BR Eq .
 .
-Then the label appears at the left margin.
 .
-.IP
-If there are multiple
-.BR EQ / EN
-blocks within a single
-.BR DS / DE
-pair,
-only the last equation label (if any) is printed.
+If multiple
+.I eqn \" generic
+regions occur within a display,
+only the last
+.I label
+(if any)
+is used.
+.
 .
 .TP
-.BI EX\  "\fR\fPtitle \fR\fPoverride \fR\fPflag \fR\fPrefname\fR\fP"
-Exhibit title.
+.BR EX \~\c
+.RI  title \~ override \~ flag \~  refname 
+Caption an exhibit.
 .
-The arguments are the same as for
+Arguments are handled analogously to
 .BR EC .
 .
-.B EX
-uses the number register
+The register
 .B Ex
-as a counter.
-.
-The string
-.B Lx
-controls the title of the List of Exhibits;
-default is \oqLIST OF EXHIBITS\cq.
-.
-The List of Exhibits is only printed if number register
-.B Lx
-is\~1,
-which is the default.
+is the exhibit counter.
 .
 The string
 .B Liex
-contains the word \oqExhibit\cq, which is printed before the
-number.
+precedes the exhibit number and any
+.I title.
+.
+Exhibit captions are centered irrespective of the alignment of any
+enclosing display.
 .
-If
-.I refname
-is used, the exhibit number is saved with
-.BR .SETR ,
-and can be retrieved with \oq\fB.GETST\fP \fIrefname\fP\cq.
 .
 .IP
-Special handling of the title occurs if
-.B EX
-is used inside
-.BR DS / DE ;
-it is not affected by the format of
-.BR DS .
+Captioned exhibits are listed in a table of contents
+(see
+.BR TC )
+if the Boolean register
+.B Lx
+is true.
+.
+Such a list uses the string
+.B Lx
+as a heading.
 .
-.TP
-.BI FC\  \fR\fPclosing\fR\fP
-Print \oqYours\~very\~truly,\cq as a formal closing of a letter or
-memorandum.
 .
-The argument replaces the default string.
+.TP
+.BR FC \~\c
+.IR closing-text 
+Output the string
+.BR Letfc ,
+or the specified
+.I closing-text,
+as the formal closing of a letter.
 .
-The default is stored in string variable
-.BR Letfc .
 .
 .TP
-.BI FD\  \fR\fParg\  \fR\fP1\fR\fP
-Footnote default format.
+.BR FD \~\c
+.IR arg \~\c
+.BR 1 
+Configure display of footnotes.
 .
-Controls the hyphenation (hyphen),
-right margin justification (adjust),
-and indentation of footnote text (indent).
+The first argument encodes enablement of
+automatic hyphenation,
+adjustment to the right margin,
+indentation of footnote text,
+and left- vs.\& right-alignment of the footnote label within the space
+allocated for it.
 .
-It can also change the label justification (ljust).
 .
-.RS
+.br
+.ne 5v
 .IP
+.\" XXX: We can fit one more row using "nokeep" vs. not using it.
 .TS
-tab(@);
-lb lb lb lb lb
-l l l l l.
-arg@hyphen@adjust@indent@ljust
+tab(@) nokeep;
+Lf(BI) Lb Lb Lb Lb
+L L L L L.
+arg@Hyphenate?@Adjust?@Indent?@Label alignment
 0@no@yes@yes@left
 1@yes@yes@yes@left
 2@no@no@yes@left
@@ -1032,90 +1568,121 @@
 10@no@no@yes@right
 11@yes@no@yes@right
 .TE
-.RE
+.
+.
+.IP
+An
+.I arg
+greater than 11 is treated
+.RB as\~ 0 .
+.
+.IR mm 's
+default
+.RB is\~ 0 .
+.
 .
 .IP
-An argument greater than or equal to 11 is considered as value\~0.
+If a second argument,
+conventionally
+.BR 1 ,
+is given,
+footnote numbering is reset when a first-level heading is encountered.
+.
+See
+.BR FS .
 .
-Default for
-.B m@TMAC_M_PREFIX@m
-is 10.
 .
 .TP
 .B FE
-Footnote end.
+End footnote;
+see
+.BR FS .
+.
 .
 .TP
-.BI FG\  "\fR\fPtitle \fR\fPoverride \fR\fPflag \fR\fPrefname\fR\fP"
-Figure title.
+.BR FG \~\c
+.RI  title \~ override \~ flag \~  refname 
+Caption a figure.
 .
-The arguments are the same as for
+Arguments are handled analogously to
 .BR EC .
-.B FG
-uses the number register
+.
+The register
 .B Fg
-as a counter.
+is the figure counter.
 .
 The string
+.B Lifg
+precedes the figure number and any
+.I title.
+.
+Figure captions are centered irrespective of the alignment of any
+enclosing display.
+.
+.
+.IP
+Captioned figures are listed in a table of contents
+(see
+.BR TC )
+if the Boolean register
 .B Lf
-controls the title of the List of Figures;
-default is \oqLIST OF FIGURES\cq.
+is true.
 .
-The List of Figures is only printed if number register
+Such a list uses the string
 .B Lf
-is\~1, which is the default.
+as a heading.
 .
-The string
-.B Lifg
-contains the word \oqFigure\cq, which is printed before the
-number.
 .
-If
-.I refname
-is used, then the figure number is saved with
-.BR .SETR ,
-and can be retrieved with \oq\fB.GETST\fP \fIrefname\fP\cq.
+.TP
+.BR FS \~\c
+.IR label 
+Start footnote.
 .
-.IP
-Special handling of the title occurs if
-.B FG
-is used inside
-.BR DS / DE ,
-it is not affected by the format of
-.BR DS .
+Input until
+.B FE
+is called is collected into a footnote.
+.
+By default,
+footnotes are automatically numbered starting at 1;
+the number is available in register
+.B :p
+and,
+with a trailing period,
+in
+.RB string\~ F .
 .
-.TP
-.BI FS\  \fR\fPlabel\fR\fP
-Footnote start.
+This string precedes the footnote text at the bottom of the column or
+page.
 .
-The footnote is ended by
-.BR FE .
+Footnotes are vertically separated by the product of
+.RB registers\~ Fs
+and
+.BR Lsp .
 .
-By default, footnotes are automatically numbered;
-the number is available in string\~\c
-.BR F .
+In
+.IR "groff mm" ,
+footnotes may be used in displays.
 .
-Just add
-.B \rs*F
-in the text.
 .
-By adding
-.IR label ,
-it is possible to have other number or names on the footnotes.
+.IP
+A
+.I label
+argument replaces the contents of the string
+.BR F ;
+it need not be numeric.
 .
-Footnotes in displays are now possible.
+In this event,
+the footnote marker in the body text must be explicitly written.
 .
-An empty line separates footnotes;
-the height of the line is controlled by number register
-.BR Fs ,
-default value is\~1.
 .
 .TP
 .BI GETHN\  "refname \fR\fPvarname\fR\fP"
-Include the header number where the corresponding \oq\fBSETR\fP
-\fIrefname\fP\cq was placed.
+Include the heading number where the corresponding
+.RB \lq .SETR
+.IR refname \rq
+was placed.
 .
-This is displayed as \oqX.X.X.\cq in pass\~1.
+This is displayed as \lqX.X.X.\rq in pass\~1.
 .
 See
 .BR INITR .
@@ -1124,16 +1691,18 @@
 .I varname
 is used,
 .B GETHN
-sets the string variable
+sets the string
 .I varname
-to the header number.
+to the heading number.
 .
 .TP
 .BI GETPN\  "refname \fR\fPvarname\fR\fP"
-Include the page number where the corresponding \oq\fBSETR\fP
-\fIrefname\fP\cq was placed.
+Include the page number where the corresponding
+.RB \lq .SETR
+.IR refname \rq
+was placed.
 .
-This is displayed as \oq9999\cq in pass\~1.
+This is displayed as \lq9999\rq in pass\~1.
 .
 See
 .BR INITR .
@@ -1142,7 +1711,7 @@
 .I varname
 is used,
 .B GETPN
-sets the stringvariable
+sets the string
 .I varname
 to the page number.
 .
@@ -1152,7 +1721,7 @@
 .B GETHN
 and
 .B GETPN
-with the text \oqchapter\cq and \oq,\~page\cq.
+with the text \lqchapter\rq and \lq,\~page\rq.
 .
 The string
 .B Qrf
@@ -1173,7 +1742,8 @@
 .B Qrfp
 are set by
 .B GETR
-and contain the page and header number, respectively.
+and contain the page and heading number,
+respectively.
 .
 .TP
 .BI GETST\  "refname \fR\fPvarname\fR\fP"
@@ -1191,684 +1761,616 @@
 See
 .BR INITR .
 .
-.TP
-.BI H\  "level \fR\fPheading-text \fR\fPheading-suffix\fR\fP"
-Numbered section heading.
-.
-Section headers can have a level between 1 and 14;
-level\~1 is the top level.
 .
-The text is given in
-.IR heading-text ,
-and must be surrounded by double quotes if it contains spaces.
+.TP
+.BI H\~ level\~\c
+.RI  title \~ suffix 
+Set a numbered section heading at
+.IR level .
 .
-.I heading-suffix
-is added to the header in the text but not in the table of contents.
+.I mm
+produces numbered
+.I "heading marks"
+of the form
+.IR a . b . c .\|.\|.,
+with up to fourteen levels of nesting.
 .
-This is normally used for footnote marks and similar things.
+Each level's number increases automatically with each
+.B H
+call and is reset to zero when a more significant
+.I level
+is specified.
 .
-Don't use
-.B \rs*F
-in
-.IR heading-suffix ,
-it doesn't work.
+.RB \lq 1 \rq\~is
+the most significant or coarsest division of the document.
 .
-A manual label must be used, see
-.BR FS .
-.sp
-A call to the paragraph macro\~\c
-.B P
-directly after\~\c
+Text after an
 .B H
-is ignored.
+call is formatted as a paragraph;
+calling
+.B P
+is unnecessary.
 .
-.BR H \~takes
-care of spacing and indentation.
 .
 .IP
-.B Page ejection before heading
+.I title
+specifies an optional title;
+it must be double-quoted if it contains spaces.
 .
-.RS
-.IP
-Number register
-.B Ej
-controls page ejection before the heading.
+.I mm
+appends
+.I suffix
+to
+.I title
+in the body of the document,
+but omits it from any table of contents
+(see
+.BR TC ).
 .
-By default, a level-one heading gets two blank lines before it;
-higher levels only get one.
+This facility can be used to annotate the heading title with a footnote.
 .
-A new page is ejected before each first-level heading if number
-register
-.B Ej
-is\~1.
+.I suffix
+should not interpolate
+.RB the\~ F
+string;
+specify a footnote mark explicitly.
 .
-All levels below or equal the value of
-.B Ej
-get a new page.
+See
+.BR FS .
 .
-Default value for
-.B Ej
-is\~0.
-.RE
 .
 .IP
-.B Heading break level
+Heading behavior is highly configurable.
 .
-.RS
-.IP
-A line break occurs after the heading if the heading level is less
-or equal to number register
-.BR Hb .
+Several registers set a
+.I threshold,
+where heading levels at or below the threshold value are handled in one
+way,
+and those above it another.
 .
-Default value is\~2.
-.RE
+For example,
+a heading level within the threshold of register
+.B Cl
+is included in the table of contents
+(see
+.BR TC ).
 .
-.IP
-.B Heading space level
 .
-.RS
 .IP
-A blank line is inserted after the heading if the heading level is
-less or equal to number register
-.BR Hs .
+.I Heading layout.
 .
-Default value is\~2.
+Register
+.B Ej
+sets a threshold for page breaking (ejection) prior to a heading.
 .
-.IP
-Text follows the heading on the same line if the level is greater than
-both
+If not preceded by a page break,
+a heading level below the threshold in register
+.B Hps
+is preceded by the amount of vertical space in register
+.BR Hps1 ,
+and by the amount in
+.B Hps2
+otherwise.
+.
+The
+.B Hb
+register sets a threshold below which a break occurs after the heading,
+and register
+.B Hs
+sets a threshold below which vertical space follows it.
+.
+If the heading level is not less than both of these,
+a
+.I run-in heading
+is produced;
+paragraph text follows on the same output line.
+.
+Otherwise,
+register
+.B Hi
+configures the indentation of text after headings.
+.
+Threshold register
+.B Hc
+enables the centering of headings;
+a heading level below both of the
 .B Hb
 and
-.BR Hs .
-.RE
+.B Hc
+thresholds is centered.
 .
-.IP
-.B Post-heading indent
 .
-.RS
 .IP
-Indentation of the text after the heading is controlled by number
-register
-.BR Hi .
+.I Heading typeface and size.
+.
+The fonts used for heading numbers and titles at each level are
+configured by the
+.B HF
+string.
+.
+The string
+.B HP
+likewise assigns a type size to each heading level.
+.
+.\" XXX: Why not an "Hvs" string?
+The vertical spacing used by headings may be controlled by
+the user-definable macros
+.B HX
+and/or
+.BR HZ .
 .
-Default value is\~0.
 .
 .IP
-.B Hi
-.TS
-tab(@);
-l lx.
-0@The text is left-justified.
-1@T{
-Indentation of the text follows the value of number
-register
-.B Pt ,
-see
-.BR P .
-T}
-2@T{
-The text is lined up with the first word of the heading.
-T}
-.TE
-.RE
-.
-.IP
-.B Centered section headings
-.
-.RS
-.IP
-All headings whose level is equal or below number register
-.B Hc
-and also less than or equal to
-.B Hb
-or
-.B Hs
-are centered.
-.RE
-.
-.IP
-.B Font control of the heading
-.
-.RS
-.IP
-The font of each heading level is controlled by string
-.BR HF .
-.
-It contains a font number or font name for each level.
-.
-Default value is
-.
-.RS
-.IP
-.B 2 2 2 2 2 2 2 2 2 2 2 2 2 2
-.RE
-.
-.IP
-(all headings in italic).
-.
-This could also be written as
-.
-.RS
-.IP
-.B I I I I I I I I I I I I I I
-.RE
-.
-.IP
-Note that some other implementations use
-.B 3\~3\~2\~2\~2\~2\~2
-as the default value.
-.
-All omitted values are presumed to have value\~1.
-.RE
-.
-.IP
-.B Point size control
-.
-.RS
-.IP
-String
-.B HP
-controls the point size of each heading,
-in the same way as
-.B HF
-controls the font.
-.
-A value of\~0 selects the default point size.
-.
-Default value is
+.I Heading number format.
 .
-.RS
-.IP
-.B 0 0 0 0 0 0 0 0 0 0 0 0 0 0
-.RE
-.
-.IP
-Beware that only the point size changes, not the vertical size.
-.
-The latter can be controlled by the user-specified macros
-.B HX
-and/or
-.BR HZ .
-.RE
-.
-.IP
-.B Heading counters
-.
-.RS
-.IP
-Fourteen number registers named
+Registers named
 .B H1
-up to
+through
 .B H14
-contain the counter for each heading level.
-.
-The values are printed using Arabic numerals;
-this can be changed with the macro
-.B HM
-(see below).
+store counters for each heading level.
 .
-All marks are concatenated before printing.
+Their values are printed using Arabic numerals by default;
+see
+.BR HM .
 .
-To avoid this,
-set number register
+The heading levels are catenated with dots for formatting;
+to typeset only the deepest,
+set the
 .B Ht
-to\~1.
+register.
 .
-This only prints the current heading counter at each heading.
-.RE
+Heading numbers are not suffixed with a trailing dot except when only
+the first level is output;
+to omit a dot in this case as well,
+clear the
+.B H1dot
+register.
 .
-.IP
-.B Automatic table of contents
 .
-.RS
 .IP
-All headings whose level is equal or below number register
-.B Cl
-are saved to be printed in the table of contents.
+.I Customizing heading behavior.
 .
-Default value is\~2.
-.RE
+.I mm
+calls
+.I hook
+macros to enable further customization of headings.
 .
-.IP
-.B Special control of the heading, user-defined macros
+(DWB
+.I mm
+called these \lqexits\rq.)
 .
-.RS
-.IP
-The following macros can be defined by the user to get a finer control
-of vertical spacing, fonts, or other features.
+They can be used to change the heading's
+.I mark
+(the numbered portion before any heading title),
+its vertical spacing,
+and its vertical space requirements
+(for instance,
+to require a minimum quantity of subsequent output lines).
 .
-Argument
+Define hook macros in expectation of the following parameters.
+.
+The argument
+.I declared-level
+is the
 .I level
-is the level-argument to\~\c
+argument to
 .BR H ,
-but\~0 for unnumbered headings (see
+.RB or\~ 0
+for unnumbered headings (see
 .BR HU ).
 .
-Argument
-.I rlevel
-is the real level;
-it is set to number register
-.B Hu
+.I actual-level
+is the same as
+.I declared-level
+for numbered headings,
+and the value of
+.RB register\~ Hu
 for unnumbered headings.
 .
-Argument
-.I heading-text
-is the text argument to
+.I title
+is the corresponding argument to
 .B H
-and
+or
 .BR HU .
 .
+.
 .RS
 .TP
-.BI HX\  "level rlevel heading-text"
-This macro is called just before the printing of the heading.
-.
-The following registers are available for
-.BR HX .
-.
-Note that
+.BI HX\~ "declared-level actual-level title"
+.I mm
+calls
 .B HX
-may alter
+before setting the heading.
+.
+Your definition may alter
 .BR }0 ,
 .BR }2 ,
 and
 .BR ;3 .
 .
+.
+.\" XXX: These names are ugly and of no obvious meaning.  Make
+.\" documented aliases for them.
 .RS
 .TP
-.BR }0\  (string)
-Contains the heading mark plus two spaces if
-.I rlevel
+.BR }0\~ (string)
+contains the heading mark plus two spaces if
+.I declared-level
 is non-zero,
-otherwise empty.
+and otherwise is empty.
+.
 .
 .TP
-.BR ;0\  (register)
-Contains the position of the text after the heading.
+.BR ;0\~ (register)
+encodes a position for the text after the heading.
 .
-0\~means that the text should follow the heading on the same line,
-1\~means that a line break should occur before the text,
-and 2\~means that a blank line should separate the heading and the text.
+0\~means that the heading is to be run in,
+1\~means that a break is to occur before the text,
+and 2\~means that vertical space is to separate heading and text.
 .
-.TP
-.BR }2\  (string)
-Contains two spaces if register
-.B ;0
-is\~0.
 .
-It is used to separate the heading from the text.
+.TP
+.BR }2\~ (string)
+is the suffix that separates a run-in heading from the text.
 .
-The string is empty if
+It contains two spaces if register
 .B ;0
-is non-zero.
+is\~0,
+and otherwise is empty.
+.
 .
 .TP
-.BR ;3\  (register)
-Contains the needed space in units after the heading.
+.BR ;3\~ (register)
+contains the vertical space required for the heading to be typeset.
 .
-Default is 2v.
+If that amount is not available,
+the page is broken prior to the heading.
 .
-Can be used to change things like numbering
-.RB ( }0 ),
-vertical spacing
-.RB ( }2 ),
-and the needed space after the heading.
+The default is
+.BR 2v .
 .RE
 .
+.
 .TP
-.BI HY\  "dlevel rlevel heading-text"
-This macro is called after size and font calculations and
-might be used to change indentation.
+.BI HY\~ "declared-level actual-level title"
+.I mm
+calls
+.B HY
+after determing the heading typeface and size.
+.
+It could be used to change indentation.
+.
 .
 .TP
-.BI HZ\  "dlevel rlevel heading-text"
-This macro is called after the printing of the heading,
+.BI HZ\~ "declared-level actual-level title"
+.I mm
+calls
+.B HZ
+after formatting the heading,
 just before
 .B H
 or
 .B HU
-exits.
+returns.
 .
-Can be used to change the page header according to the section heading.
-.RE
+It could be used to change the page header to include a section heading.
+.\" XXX: ...but only for the _next_ page, not the current one.  See
+.\" Savannah #62825.
 .RE
 .
+.
 .TP
 .BI HC\  \fR\fPhyphenation-character\fR\fP
 Set hyphenation character.
 .
-Default value is \oq\rs%\cq.
+Default value is \lq\rs%\rq.
 .
 Resets to the default if called without argument.
 .
-Hyphenation can be turned off by setting number register
+Hyphenation can be turned off by setting register
 .B Hy
 to\~0 at the beginning of the file.
 .
+.
 .TP
 .BI HM\  "\fR\fParg1 \fR\fParg2 \fR.\|.\|.\& \fParg14\fR\fP"
-Heading mark style.
+Set the heading mark style.
 .
-Controls the type of marking for printing of the heading counters.
+Each argument assigns the specified register format
+(see above)
+to the corresponding heading level.
 .
-Default is\~1 for all levels.
+The default
+.RB is\~ 1
+for all levels.
 .
-.IP
-.B Argument
+An explicitly empty argument also indicates the default.
 .
-.TS
-tab(@);
-l l.
-1@Arabic numerals.
-0001@Arabic numerals with leading zeroes, one or more.
-A@upper-case alphabetic
-a@lower-case alphabetic
-I@upper-case roman numerals
-i@lower-case roman numerals
-\dq\dq@Arabic numerals.
-.TE
 .
 .TP
-.BI HU\  heading-text
-Unnumbered section header.
+.BI HU\~ heading-text
+Set an unnumbered section heading.
 .
-.B HU
-behaves like
-.B H
-at the level in number register
-.BR Hu .
+Except for a heading number,
+it is treated as a numbered heading of the level stored in
+.RB register\~ Hu ;
+.RB see\~ H .
 .
-See\~\c
-.BR H .
 .
 .TP
-.BI HX\  "dlevel rlevel heading-text"
-User-defined heading exit.
+.BR I \~\c \" space in roman; we must use 2-font macro with \c
+.RI  italic-text\~\c
+.RI  previous-font-text \~.\|.\|.
+Join
+.I italic-text
+in italics with
+.I previous-font-text
+in the previous font,
+without space between the arguments.
 .
-Called just before printing the header.
+If no arguments,
+switch font to italic style.
 .
-See\~\c
-.BR H .
 .
 .TP
-.BI HY\  "dlevel rlevel heading-text"
-User-defined heading exit.
+.BR IA \~\c
+.IR recipient-name \~\c
+.IR title 
+Specify the inside address in a letter.
 .
-Called just before printing the header.
+Input is collected into the inside address until
+.B IE
+is called,
+and then output.
 .
-See\~\c
-.BR H .
+You can specify multiple recipients with empty
+.BR IA / IE
+pairs;
+only the last address is used.
 .
-.TP
-.BI HZ\  "dlevel rlevel heading-text"
-User-defined heading exit.
+The arguments give each recipient a name and title.
 .
-Called just after printing the header.
+See
+.BR LT .
 .
-See\~\c
-.BR H .
 .
 .TP
-.BI I\  "\fR\fPitalic-text \fR\fPprev-font-text \fR\fPitalic-text \fR.\|.\|.\fP"
-Italic.
+.BR IB \~\c \" space in roman; we must use 2-font macro with \c
+.RI  italic-text\~\c
+.RI  bold-text \~.\|.\|.
+Join
+.I italic-text
+in italics with
+.I bold-text
+in boldface,
+without space between the arguments.
 .
-Changes the font to italic if called without arguments.
 .
-With one argument it sets the word in italic.
-.
-With two arguments it concatenates them and sets the first
-word in italic and the second in the previous font.
+.TP
+.B IE
+End the inside address begun with
+.BR IA .
 .
-There is no limit on the number of argument;
-all are concatenated.
 .
 .TP
-.BI IA\  "\fR\fPaddressee-name \fR\fPtitle\fR\fP"
-Begin specification of the addressee and addressee's address in
-letter style.
+.BI IND\~ argument\~\c
+\&.\|.\|.
+If the Boolean register
+.B Ref
+is true,
+write an index entry as a specially prepared
+.I roff
+comment to the standard error stream,
+with each
+.I argument
+separated from its predecessor by a tab character.
 .
-Several names can be specified with empty
-.BR IA / IE -pairs,
-but only one address.
+The entry's location information is arranged as configured by the most
+recent
+.B INITI
+call.
 .
-See
-.BR LT .
 .
 .TP
-.BI IB\  "\fR\fPitalic-text \fR\fPbold-text \fR\fPitalic-text \fR.\|.\|.\fP"
-Italic-bold.
+.B INDP
+Output the index set up by
+.B INITI
+and populated by
+.B IND
+calls.
 .
-Even arguments are printed in italic, odd in boldface.
+By default,
+.B INDP
+calls
+.B SK
+and writes a centered caption interpolating the string
+.BR Index .
+.
+It then disables filling and calls
+.BR 2C ;
+afterward,
+it restores filling and calls
+.BR 1C .
 .
-See\~\c
-.BR I .
 .
-.TP
-.B IE
-End the address specification after
-.BR IA .
+.IP
+Define macros to customize this behavior.
 .
-.TP
-.BI INITI\  "type filename \fR\fPmacro\fR\fP"
-Initialize the new index system and set the filename to collect index
-lines in with
-.BR IND .
+.B INDP
+calls
+.B TXIND
+before the caption,
+.B TYIND
+.I instead
+of writing the caption,
+and
+.B TZIND
+after formatting the index.
 .
-Argument
-.I type
-selects the type of index: page number, header marks or both.
 .
-The default is page numbers.
+.TP
+.BI INITI\~ "location-type file-name\~"\c
+.RI  macro 
+Initialize
+.IR "groff mm" 's
+indexing system.
 .
-.IP
-It is also possible to create a macro that is responsible
-for formatting each row;
-just add the name of the macro as a third argument.
+Argument
+.I location-type
+selects how the location of each index entry is reported.
 .
-The macro is then called with the index as argument(s).
+.I file-name
+populates an internal string used later by
+.BR INDP .
 .
-.IP
-.B type
 .
 .IP
 .TS
 tab(@);
-l lx.
-N@Page numbers
-H@Header marks
-B@T{
-Both page numbers and header marks,
-separated with a tab character.
-T}
+Lf(BI) Lb
+L Lx.
+location-type@Entry format
+N@page number
+H@heading mark
+B@page number, tab character, heading mark
 .TE
 .
+.
+.IP
+If
+.I macro
+is specified,
+it is called for each index entry
+with the arguments given to
+.BR IND .
+.
+.
 .TP
-.BI INITR\  filename
+.BI INITR\~ id
 Initialize the cross reference macros.
 .
-Cross references are written to stderr and are supposed to be
-redirected into file
-.RI filename .qrf .
-.
-Requires two passes with groff;
-this is handled by a separate program called
-.BR mmroff (@MAN1EXT@).
+Cross references are written to the standard error stream,
+which should be redirected into a file named
+.RI id .qrf .
 .
-This program exists because
-.BR groff (@MAN1EXT@)
-by default deactivates the unsafe operations that are required by
-.BR INITR .
+.MR mmroff @MAN1EXT@
+handles this and the two formatting passes it requires.
+.\".
+.\"This program exists because
+.\".MR groff @MAN1EXT@
+.\"by default deactivates the unsafe operations that are required by
+.\".BR INITR .
 .
-The first pass looks for cross references,
+The first pass identifies cross references,
 and the second one includes them.
+.\"
+.\".B INITR
+.\"can be used several times,
+.\"but it is only the first occurrence of
+.\".B INITR
+.\"that is active.
 .
-.B INITR
-can be used several times,
-but it is only the first occurrence of
-.B INITR
-that is active.
 .
 .IP
-See also
+See
 .BR SETR ,
 .BR GETPN ,
 and
 .BR GETHN .
 .
-.TP
-.BI IND\  "arg1 \fR\fParg2 \fR.\|.\|.\fP"
-Write a line in the index file selected by
-.B INITI
-with all arguments and the page number or header mark separated by tabs.
-.
-.RS
-.IP
-.B Examples
-.
-.IP
-arg1\rstpage number
-.br
-arg1\rstarg2\rstpage number
-.br
-arg1\rstheader mark
-.br
-arg1\rstpage number\rstheader mark
-.RE
 .
 .TP
-.B INDP
-Print the index by running the command specified by string variable
-.BR Indcmd ,
-which has \oqsort\ \-t\rst\cq as the default value.
+.BR IR \~\c \" space in roman; we must use 2-font macro with \c
+.RI  italic-text\~\c
+.RI  roman-text \~.\|.\|.
+Join
+.I italic-text
+in italics with
+.I roman-text
+in roman style,
+without space between the arguments.
 .
-.B INDP
-reads the output from the command to form the index,
-by default in two columns (this can be changed by defining
-.BR TYIND ).
-.
-The index is printed with string variable
-.B Index
-as header,
-default is \oqINDEX\cq.
-.
-One-column processing is reactivated after the list.
-.
-.B INDP
-calls the user-defined macros
-.BR TXIND ,
-.BR TYIND ,
-and
-.B TZIND
-if defined.
-.
-.B TXIND
-is called before printing the string \oqINDEX\cq,
-.B TYIND
-is called instead of printing \oqINDEX\cq, and
-.B TZIND
-is called after the printing and should take care of restoring to
-normal operation again.
 .
 .TP
-.B ISODATE \fR\fP0\fR\fP
-Change the predefined date string in
+.BR ISODATE\~  0 
+Use ISO\~8601 format for the date string
 .B DT
-to ISO-format, this is, \oqYYYY-MM-DD\cq.
-.
-This can also be done by adding
-.B \-rIso=1
-on the command line.
-.
-Reverts to old date format if argument is\~\c
-.BR 0 .
-.
-.TP
-.BI IR\  "\fR\fPitalic-text \fR\fProman-text \fR\fPitalic-text \fR.\|.\|.\fP"
-Italic-roman.
-.
-Even arguments are printed in italic, odd in roman.
-.
-See\~\c
-.BR I .
-.
-.TP
-.BI LB\  "text-indent mark-indent pad type \fR\fPmark \fR\fPLI-space \fR\fPLB-space\fR\fP"
-List-begin macro.
-.
-This is the common macro used for all lists.
-.
-.I text-indent
-is the number of spaces to indent the text from the current indentation.
-.
-.IP
-.I pad
+used by some cover sheet and memorandum types;
+that is,
+.IR YYYY - MM - DD .
+.
+Must be called before
+.B ND
+to be effective.
+.
+If given an argument
+.RB of\~ 0,
+the traditional date format for the
+.I groff
+locale is used;
+this is also the default.
+.
+.
+.TP
+.BI LB\~ "text-indent mark-indent pad type"\~\c
+.RI  mark \~ pre-item-space \~ pre-list-space 
+Begin list.
+.
+The macros
+.BR AL ,
+.BR BL ,
+.BR BVL ,
+.BR DL ,
+.BR ML ,
+.BR RL ,
 and
-.I mark-indent
-control where to put the mark.
+.B VL
+call
+.B LB
+in various ways;
+they are simpler to use and may be preferred if they suit the desired
+purpose.
 .
-The mark is placed within the mark area, and
-.I mark-indent
-sets the number of spaces before this area.
 .
-By default it is\~0.
+.br
+.ne 5v
+.IP
+The nesting level of lists is tracked by
+.I mm;
+the outermost level is\~0.
 .
-The mark area ends where the text begins.
+The text of each list item is indented by
+.I text-indent;
+the default is taken from the
+.B Li
+register
+(in ens).
 .
-The start of the text is still controlled by
-.IR text-indent .
+Each item's mark is indented by
+.I mark-indent;
+the default is
+.BR 0n .
 .
-.IP
-The mark is left-justified within the mark area if
-.I pad
-is\~0.
+The mark is normally left-aligned.
 .
 If
 .I pad
-is greater than\~0,
+is greater than zero,
 .I mark-indent
-is ignored,
-and the mark is placed
+is overridden such that
 .I pad
-spaces before the text.
-.
-This right-justifies the mark.
-.
-.IP
-If
-.I type
-is\~0 the list either has a hanging indentation or,
-if argument
-.I mark
-is given,
-the string
-.I mark
-as a mark.
-.
-.IP
-If
-.I type
-is greater than\~0 automatic numbering occurs,
-using arabic numbers if
-.I mark
-is empty.
+ens of space follow the mark.
 .
-.I mark
-can then be any of \oq1\cq, \oqA\cq, \oqa\cq, \oqI\cq,
-or \oqi\cq.
-.
-.IP
 .I type
 selects one of six possible ways to display the mark.
 .
-.IP
-.B type
 .
-.RS
 .IP
-.br
 .TS
 tab(@);
-l l.
+Lf(BI) Lb
+L L.
+type@Output for a mark \lqx\rq
 1@x.
 2@x)
 3@(x)
@@ -1876,284 +2378,386 @@
 5@<x>
 6@{x}
 .TE
-.RE
+.
 .
 .IP
-Every item in the list gets
-.I LI-space
-number of blank lines before them.
+If
+.I type
+is\~0 and
+.I mark
+is unspecified,
+the items are set with a hanging indent.
+.
+Otherwise,
+.I mark
+is interpreted as a string defining the mark.
+.
+If
+.I type
+is greater than zero,
+items are automatically numbered;
+.I mark
+is interpreted as a register format.
+.
+The default
+.I type
+.RB is\~ 0 .
 .
-Default is\~1.
 .
 .IP
+The last two arguments manage vertical space.
+.
+Unless a list's nesting level is greater than the value of register
+.BR Ls ,
+its items are preceded by
+.I pre-item-space
+multiplied by the register
+.BR Lsp ;
+the default
+.RB is\~ 1 .
+.
 .B LB
-itself prints
-.I LB-space
-blank lines.
+precedes the list by
+.I pre-list-space
+multiplied by the register
+.BR Lsp ;
+the default
+.RB is\~ 0 .
 .
-Default is\~0.
 .
 .TP
-.BI LC\  \fR\fPlist-level\fR\fP
-List-status clear.
+.BR LC \~\c
+.IR list-level 
+Clear list state.
 .
-Terminates all current active lists down to
-.IR list-level ,
-or\~0 if no argument is given.
+Active lists are terminated as if with
+.BR LE ,
+either all
+(the default)
+or only those from the current level down to
+.I list-level
+if specified.
 .
-This is used by\~\c
 .B H
-to clear any active list.
+calls
+.B LC
+automatically.
+.
 .
 .TP
-.B LE \fR\fP1\fR\fP
-List end.
+.BR LE \~ 1 
+End list.
 .
-Terminates the current list.
-.B LE
-outputs a blank line if an argument is given.
+The current list is terminated.
 .
-.TP
-.BI LI\  \fR\fPmark\  \fR\fP1\fR|\fP2\fR\fP
-List item preceding every item in a list.
+An argument
+.RB of\~ 1
+causes
+vertical space in the amount of register
+.B Lsp
+to follow the list.
 .
-Without argument,
-.B LI
-prints the mark determined by the current list type.
 .
-By giving
-.B LI
-one argument, it uses that as the mark instead.
+.TP
+.BR LI \~\c
+.IR mark \~ item-mark-mode 
+Begin a list item.
 .
-Two arguments to
+Input is collected into a list item until the current list is terminated
+or
 .B LI
-makes
-.I mark
-a prefix to the current mark.
-.
-There is no separating space between the prefix and the mark if the
-second argument is \oq2\cq instead of \oq1\cq.
+is called again.
 .
-This behaviour can also be achieved by setting number register
-.B Limsp
-to zero.
+By default,
+the item's text is preceded by any mark configured by the current list.
 .
-A zero length
+If only
 .I mark
-makes a hanging indentation instead.
+is specified,
+it replaces the configured mark.
 .
-.IP
-A blank line is printed before the list item by default.
-.
-This behaviour can be controlled by number register
-.BR Ls .
-.
-Pre-spacing occurs for each list level less than or equal to
-.BR Ls .
+A second argument
+prefixes
+.I mark
+to the configured mark;
+an
+.I item-mark-mode
+value of\~1 places an unbreakable space after
+.I mark,
+while
+a value of\~2 does not
+(rendering the two adjacent).
 .
-Default value is 99.
+Also see register
+.BR Limsp .
 .
-There is no nesting limit.
 .
-.IP
-The indentation can be changed through number register
-.BR Li .
-Default is\~6.
+.TP
+.BI LO\~ option\~\c
+.RI  value 
+Specify letter options;
+see
+.BR LT .
 .
-.IP
-All lists begin with a list initialization macro,
-.BR LB .
+Standard options are as follows.
 .
-There are, however, seven predefined list types to make lists easier
-to use.
+See
+.B IA
+regarding the inside address and string
+.B DT
+regarding the date.
 .
-They all call
-.B LB
-with different default values.
 .
-.RS
 .IP
 .TS
 tab(@);
-l l.
-\fBAL\fP@Automatically Incremented List
-\fBML\fP@Marked List
-\fBVL\fP@Variable-Item List
-\fBBL\fP@Bullet List
-\fBDL\fP@Dash List
-\fBRL\fP@Reference List
-\fBBVL\fP@Broken Variable List.
+Lf(BI) Lb
+L Lx.
+option@Effect
+AT@T{
+Attention;
+put contents of string
+.B LetAT
+and
+.I value
+left-aligned after the inside address.
+T}
+CN@T{
+Confidential;
+put
+.I value,
+or contents of string
+.BR LetCN ,
+left-aligned after the date.
+T}
+RN@T{
+Reference;
+put contents of string
+.B LetRN
+and
+.I value
+after the confidental notation
+(if any)
+and the date,
+aligned with the latter.
+T}
+SA@T{
+Salutation;
+put
+.I value,
+or contents of string
+.BR LetSA ,
+left-aligned after the inside address
+and the confidental notation
+(if any).
+T}
+SJ@T{
+Subject;
+put contents of string
+.B LetSJ
+and
+.I value
+left-aligned after the inside address
+and the attention and salutation notations
+(if any).
+.
+In letter type \lqSP\rq,
+.B LetSJ
+is ignored and
+.I value
+is set in full capitals.
+T}
 .TE
-.RE
 .
-.IP
-These lists are described at other places in this manual.
 .
-See also
-.BR LB .
+.br
+.ne 5v
+.TP
+.BR LT \~\c
+.IR style 
+Format a letter in the designated
+.I style,
+defaulting to
+.B BL
+(see below).
 .
-.TP
-.BI LT\  \fR\fIarg\/\fR\fI
-Format a letter in one of four different styles depending
-on the argument.
+A letter begins with the writer's address
+.RB ( WA / WE ),
+followed by the date
+.RB ( ND ),
+the inside address
+.RB ( IA / IE ),
+the body of the letter
+.RB ( P
+and other general-purpose
+.I mm
+macros),
+the formal closing
+.RB ( FC ),
+the signature
+.RB ( SG ),
+and notations
+.RB ( NS / NE ).
 .
-Also see section \lqInternals\rq below.
+Any of these may be omitted.
 .
-.RS
+Letter options specified with
+.B LO
+add further annotations,
+which are extensible;
+see section \lqInternals\rq below.
+.
+.
+.br
+.ne 6v
 .IP
 .TS
 tab(@);
-lb lb
-l lx.
-Arg@Style
+Lf(BI) Lb
+Lb Lx.
+style@Description
 BL@T{
-Blocked.
-Date line, return address, writer's address and closing
-begins at the center of the line.
+Blocked:
+the writer's address,
+date,
+formal closing,
+and signature are indented to the center of the line.
 .
-All other lines begin at the left margin.
+Everything else is left-aligned.
 T}
 SB@T{
-Semi-blocked.
-Same as blocked,
-except that the first line in every paragraph is indented five spaces.
+Semi-blocked:
+as
+.BR BL ,
+but the first line of each paragraph is indented by
+.BR 5m .
+.\" XXX: https://savannah.gnu.org/bugs/?64315
 T}
 FB@T{
-Full-blocked.
-All lines begin at the left margin.
+Fully blocked:
+everything begins at the left margin.
 T}
 SP@T{
-Simplified.
-Almost the same as the full-blocked style.
-Subject and the writer's identification are printed in all-capital.
+Simplified:
+as
+.BR FB ,
+but a formal closing is omitted,
+and the signature is set in full capitals.
 T}
 .TE
-.RE
 .
-.TP
-.BI LO\  "type \fR\fParg\fR\fP"
-Specify options in letter (see
-.BR .LT ).
 .
-This is a list of the standard options:
+.TP
+.BI MC\~ column-width\~\c
+.RI  gutter-width 
+Begin multi-column layout.
 .
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-CN@T{
-Confidential notation.
-Prints \oqCONFIDENTIAL\cq on the second line below the date line.
+.I groff mm
+creates as many columns of
+.I column-width
+as the line length will permit.
 .
-Any argument replaces \oqCONFIDENTIAL\cq.
+.I gutter-width
+is the interior spacing between columns.
 .
-See also string variable
-.BR LetCN .
-T}
-RN@T{
-Reference notation.
-Prints \oqIn reference to:\cq and the argument two lines below the date line.
-See also string variable
-.BR LetRN .
-T}
-AT@T{
-Attention.
-Prints \oqATTENTION:\cq and the argument below the inside address.
-See also string variable
-.BR LetAT .
-T}
-SA@T{
-Salutation.
-Prints \cqTo Whom It May Concern:\cq or the argument if it was present.
-The salutation is printed two lines below the inside address.
-See also string variable
-.BR LetSA .
-T}
-SJ@T{
-Subject line.
-Prints the argument as subject prefixed with \oqSUBJECT:\cq
-two lines below the inside address,
-except in letter type \oqSP\cq,
-where the subject is printed in all-capital without any prefix.
-See also string variable
-.BR LetSJ .
-T}
-.TE
-.RE
+It defaults to
+.IR column-width /15.
 .
-.TP
-.BI MC\  "column-size \fR\fPcolumn-separation\fR\fP"
-Begin multiple columns.
-.
-Return to normal with
-.BR 1C .
+.B 1C
+returns to single-column layout.
 .
 .B MC
-creates as many columns as the current line length permits.
-.
-.I column-size
-is the width of each column,
-and
-.I column-separation
-is the space between two columns.
+is a GNU extension.
 .
-Default separation is
-.IR column-size /15.
+See
+.B MULB
+for an alternative.
 .
-See also
-.BR 1C .
 .
 .TP
-.BI ML\  "mark \fR\fPtext-indent\ " \fR\fP1\fR\fP
-Marked list start.
-.
-The
+.BI ML\~ "mark \fR\fPtext-indent\~" \fR\fP1\fR\fP
+Start a list with the
 .I mark
-argument is printed before each list item.
+argument preceding each list item.
 .
 .I text-indent
-sets the indent and overrides
+overrides the default indentation of the list items set by register
 .BR Li .
 .
-A third argument prohibits printing of a blank line before each item.
+If a third argument,
+conventionally
+.BR 1 ,
+is given,
+the blank line that normally precedes each list item is suppressed.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
+.
 .
 .TP
-.BI MT\  "\fR\fParg \fR\fPaddressee\fR\fP"
-Memorandum type.
+.BR MT \~\c \" space in roman; we must use 2-font macro with \c
+.RI  type \~ addressee 
+Select memorandum type.
 .
-The argument
-.I arg
-is part of a filename in
-.IR @TMAC_MDIR@/ * .MT .
+These correspond to formats used by AT&T Bell Laboratories,
+where the
+.I mm
+package was initially developed,
+affecting the document layout.
+.
+Some of these included a cover page with a caption categorizing the
+document.
+.
+.I groff mm
+uses
+.I type
+to construct the file name
+.IR @TMAC_MDIR@/\:\% type \:.MT
+and load it with the
+.B mso
+request.
+.
+Memorandum types 0 to\~5 are supported;
+any other value of
+.I type
+is mapped to type\~6.
 .
-Memorandum types 0 to\~5 are supported, including type
-\oqstring\cq (which gets internally mapped to type\~6).
+If
+.I type
+is omitted,
+.B 0
+is implied.
 .
 .I addressee
-just sets a variable, used in the AT&T macros.
+sets a string analogous to one used by AT&T cover sheet macros that are
+not implemented in
+.IR "groff mm" .
 .
-.IP
-.B arg
 .
-.RS
 .IP
 .TS
 tab(@);
-l l.
-0@Normal memorandum, no type printed.
-1@Memorandum with \oqMEMORANDUM FOR FILE\cq printed.
-2@Memorandum with \oqPROGRAMMER'S NOTES\cq printed.
-3@Memorandum with \oqENGINEER'S NOTES\cq printed.
-4@Released paper style.
-5@External letter style.
+Lf(BI) Lb
+L L.
+type@Description
+0@normal memorandum; no caption
+1@captioned \lqMEMORANDUM FOR FILE\rq
+2@captioned \lqPROGRAMMER'S NOTES\rq
+3@captioned \lqENGINEER'S NOTES\rq
+4@released paper
+5@external letter
 .TE
-.RE
+.
 .
 .IP
-See also
-.BR COVER / COVEND ,
-a more flexible type of front page.
+See
+.B \%COVER
+for a more flexible cover sheet mechanism.
+.
 .
 .TP
 .BI MOVE\  "y-pos \fR\fPx-pos \fR\fPline-length\fR\fP"
@@ -2169,133 +2773,154 @@
 .B PGFORM
 without arguments to return to normal.
 .
-.TP
-.BI MULB\  "cw1 space1 \fR\fPcw2 space2 \fR\fPcw3 \fR.\|.\|.\fP"
-Begin a special multi-column mode.
-.
-All columns widths must be specified.
 .
-The space between the columns must be specified also.
+.TP
+.BR MULB \~\c \" space in roman; we must use 2-font macro with \c
+.IR "cw1 space1\~"  "cw2 space2" " .\|.\|.\~" cwn
+Begin alternative multi-column mode.
 .
-The last column does not need any space definition.
+All column widths must be specified,
+as must the amount of space between each column pair.
 .
-.B MULB
-starts a diversion, and
-.B MULE
-ends the diversion and prints the columns.
+The arguments' default scaling unit is
+.BR n .
 .
-The unit for the width and space arguments is \oqn\cq, but
 .B MULB
-accepts all normal unit specifications like \oqc\cq and \oqi\cq.
+uses a diversion and operates in a separate environment.
 .
-.B MULB
-operates in a separate environment.
 .
 .TP
 .B MULN
-Begin the next column.
+Begin next column in alternative column mode.
 .
-This is the only way to switch the column.
 .
 .TP
 .B MULE
-End the multi-column mode and print the columns.
+End alternative multi-column mode and emit the columns.
+.
 .
 .TP
-.BI nP\  \fR\fPtype\fR\fP
-Print numbered paragraph with header level two.
+.B NCOL
+Move to the start of the next column
+(only when using
+.B 2C
+or
+.BR MC ).
+.
+Contrast with
+.BR MULN .
 .
-See
-.BR .P .
 .
 .TP
-.B NCOL
-Force printing to the next column.
+.BR ND \~\c
+.IR arg 
+Set the document's date.
+.
+.I mm
+does not interpret
+.IR arg ;
+it can be a revision identifier
+(or empty).
 .
-Don't use this together with the
-.B MUL*
-macros, see
-.BR 2C .
 .
 .TP
-.BI NS\  \fR\fParg\  \fR\fP1\fR\fP
-Print different types of notations.
+.B NE
+End notation begun with
+.BR NS ;
+filling is enabled.
 .
-The argument selects between the predefined type of notations.
 .
-If the second argument is available,
-then the argument becomes the entire notation.
+.TP
+.BI nP\  \fR\fPtype\fR\fP
+Begin a numbered paragraph at heading level two.
 .
-If the argument doesn't select a predefined type,
-it is printed as \oqCopy (\fIarg\/\fP) to\cq.
+See
+.BR P .
 .
-It is possible to add more standard notations,
-see the string variables
-.B Letns
-and
-.BR Letnsdef .
 .
-.RS
-.IP
-.TS
-tab(@);
-l l.
-\fBArg@Notation\fP
-\fInone\/\fP@Copy To
-\dq\dq@Copy To
-1@Copy To (with att.\&) to
-2@Copy To (without att.\&) to
-3@Att.
-4@Atts.
-5@Enc.
-6@Encs.
-7@Under separate cover
-8@Letter to
-9@Memorandum to
-10@Copy (with atts.\&) to
-11@Copy (without atts.\&) to
-12@Abstract Only to
-13@Complete Memorandum to
-14@CC
-.TE
-.RE
+.br
+.ne 6v
+.TP
+.BR NS \~\c
+.IR code \~\c
+.BR 1 
+Declare notations,
+typically for letters or memoranda,
+of the type specified by
+.IR code .
+.
+The text corresponding to
+.I code
+is output,
+and filling is disabled
+until
+.B NE
+is called.
+.
+Typically,
+a list of names or attachments lies within
+.BR NS / NE .
 .
-.TP
-.BI ND\  new-date
-New date.
+If
+.I code
+is absent or does not match one of the values listed under the
+.B Letns
+string description below,
+each line of notations is formatted as
+.RI "\lqCopy (" line ") to\rq."
+.
+If a second argument,
+conventionally
+.BR 1 ,
+is given,
+.I code
+becomes the entire notation and
+.B NE
+is not necessary.
 .
-Overrides the current date.
+In
+.IR "groff mm" ,
+you can set up further notations to be recognized by
+.BR NS ;
+see the strings
+.B Letns
+and
+.B Letnsdef
+below.
 .
-Date is not printed if
-.I new-date
-is an empty string.
 .
 .TP
-.BI OF\  \fR\fParg\fR\fP
-Odd-page footer, a line printed just above the normal footer.
+.BR OF\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+Define the odd-page footer,
+which is formatted just above the normal page footer on odd-numbered
+pages.
 .
 See
-.B EF
-and
 .BR PF .
 .
-.IP
-This macro defines string
+.B OF
+defines the string
 .BR EOPof .
 .
+.
 .TP
-.BI OH\  \fR\fParg\fR\fP
-Odd-page header, a line printed just below the normal header.
+.BR OH\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+Define the odd-page header,
+which is formatted just below the normal page header on odd-numbered
+pages.
 .
 See
-.B EH
-and
 .BR PH .
 .
-.IP
-This macro defines string
+.B OH
+defines the string
 .BR TPoh .
 .
+.
 .TP
 .B OP
 Make sure that the following text is printed at the top of an
@@ -2303,52 +2928,70 @@
 .
 Does not output an empty page if currently at the top of an odd page.
 .
+.
+.br
+.ne 4v
 .TP
-.BI P\  \fR\fPtype\fR\fP
+.BR P \~\c
+.IR type 
 Begin new paragraph.
 .
-.BR P \~without
-argument produces left\-justified text,
-even the first line of the paragraph.
+If
+.I type
+is missing or\~ 0,
+.BR P \~sets
+the paragraph fully left\-aligned.
 .
-This is the same as setting
+A
 .I type
-to\~0.
+of\~1
+idents the first line by
+.B \rsPi
+ens.
 .
-If the argument is\~1,
-the first line of text following\~\c
-.B P
-is indented by the number of spaces in number register
-.BR Pi ,
-by default\~5.
+Set the register
+.B Pt
+to select a default paragraph indentation style.
 .
-.IP
-Instead of giving an argument to\~\c
-.B P
-it is possible to set the paragraph type in number register
-.BR Pt .
+The register
+.B Ps
+controls the vertical spacing between paragraphs.
 .
-Using 0 and\~1 is the same as adding that value to
-.BR P .
 .
-A value of\~2 indents all paragraphs, except after headings, lists,
-and displays (this value can't be used as an argument to
-.B P
-itself).
+.TP
+.B PE
+Picture end;
+see
+.MR @g@pic @MAN1EXT@ .
 .
-.IP
-The space between two paragraphs is controlled by number register
-.BR Ps ,
-and is\~1 by default (one blank line).
+.
+.TP
+.BR PF\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+Define the page footer.
+.
+The footer is formatted at the bottom of each page;
+the argument is otherwise as described in
+.BR PH .
+.
+.B PF
+defines the string
+.BR EOPf .
+.
+See
+.BR EF ,
+.BR OF ,
+and
+.BR EOP .
 .
 .TP
 .BI PGFORM\  "\fR\fPlinelength \fR\fPpagelength \fR\fPpageoffset\ " \fR\fP1\fR\fP
 Set line length, page length, and/or page offset.
 .
-This macro can be used for special formatting,
-like letter heads and other.
+This macro can be used for letterheads and similar.
 .
-It is normally the first command in a file,
+It is normally the first macro call in a file,
 though it is not necessary.
 .
 .B PGFORM
@@ -2368,132 +3011,150 @@
 .
 .TP
 .B PGNH
-No header is printed on the next page.
+Suppress header on the next page.
 .
-Used to get rid of the header in letters or other special texts.
+This macro must be called before any macros that produce output to
+affect the layout of the first page.
 .
-This macro must be used before any text to inhibit the page header
-on the first page.
 .
 .TP
-.BI "PIC \fR\fP\-B\fR \fP\-L\fR \fP\-C\fR \fP\-R\fR \fP\-I\ " "n\fR\fP filename \fR\fPwidth \fR\fPheight\fR\fP"
-Include a PostScript file in the document.
-.
-The macro depends on
-.BR mmroff (@MAN1EXT@)
-and
-.BR INITR .
-.
-The arguments
-.BR \-L ,
-.BR \-C ,
-.BR \-R ,
+.BR PH\~  \dq\|\aq\c
+.IB left \aq center \aq right \aq\|\dq\c
+
+.RS
+Define the page header,
+formatted at the top of each page,
+as the argument,
+where
+.IR left ,
+.IR center ,
 and
-.BI \-I\  n
-adjust the picture or indent it.
+.I right
+are aligned to the respective locations on the line.
 .
-With no flag the picture is adjusted to the left.
+A
+.RB \lq % \rq
+character in
+.I arg
+is replaced by the page number.
 .
-Adding
-.B \-B
-draws a box around the picture.
+If the argument is absent,
+no page header is set.
 .
-The optional
-.I width
-and
-.I height
-can also be given to resize the picture.
+The default page header is
 .
-.TP
-.B PE
-Picture end.
+.RS
+.EX
+\dq\aq\aq\- % \-\aq\aq\dq
+.EE
+.RE
 .
-Ends a picture for
-.BR @g@pic (@MAN1EXT@).
+which centers the page number between hyphens and formats nothing at the
+upper left and right.
 .
-.TP
-.BI PF\  \fR\fParg\fR\fP
-Page footer.
-.B PF
-sets the line to be printed at the bottom of each page.
+Header macros call
+.B PX
+(if defined)
+after formatting the header.
 .
-Empty by default.
+.B PH
+defines the string
+.BR TPh .
 .
 See
-.B PH
-for the argument specification.
+.BR EH ,
+.BR OH ,
+and
+.BR TP .
+.RE
 .
-.IP
-This macro defines string
-.BR EOPf .
 .
 .TP
-.BI PH\  \fR\fParg\fR\fP
-Page header, a line printed at the top of each page.
-.
-The argument should be specified as
+.BR PIC \~\c
+.RB  \-B \~\c
+.RB  \-C |\c
+.BI \-I\~ n\c
+.RB | \-L \c
+.RB | \-R \~\c
+.IR file \~ width \~ height 
+Include PostScript document
+.IR file .
 .
-.RS
-.IP
-.RI \dq' left-part ' center-part ' right-part '\dq
-.RE
+The optional
+.B \-B
+argument draws a box around the picture.
 .
-.IP
-where
-.IR left-part ,
-.IR center-part ,
+The optional
+.BR \-L ,
+.BR \-C ,
+.BR \-R ,
 and
-.I right-part
-are printed left-justified, centered, and right justified, respectively.
-.
-Within the argument to
-.BR PH ,
-the character \oq%\cq is changed to the current page number.
+.BI \-I\~ n
+arguments align the picture or indent it by
+.I n
+(assuming a scaling unit of
+.BR m ).
 .
-The default argument is
+By default,
+the picture is left-aligned.
 .
-.RS
-.IP
-\dq''- % -''\dq
-.RE
+Optional
+.I width
+and
+.I height
+arguments resize the picture.
 .
-.IP
-which gives the page number between two dashes.
+Use of this macro requires two-pass processing;
+see
+.B INITR
+and
+.MR mmroff @MAN1EXT@ .
 .
-.IP
-This macro defines string
-.BR TPh .
 .
 .TP
 .B PS
-Picture start (from pic).
+Picture start; see
+.MR @g@pic @MAN1EXT@ .
 .
-Begins a picture for
-.BR @g@pic (@MAN1EXT@).
 .
 .TP
-.B PX
-Page header user-defined exit.
+.B PY
+Picture end with flyback.
 .
-This macro is called just after the printing of the page header in
-.I no-space
-mode.
+Ends a
+.MR @g@pic @MAN1EXT@
+picture,
+returning the vertical position to where it was prior to the picture.
 .
-.TP
-.B R
-Roman.
+This is a GNU extension.
 .
-Return to roman font, see also\~\c
-.BR I .
 .
 .TP
-.BI RB\  "\fR\fProman-text \fR\fPbold-text \fR\fProman-text \fR.\|.\|.\fP"
-Roman-bold.
+.BR R \~\c \" space in roman; we must use 2-font macro with \c
+.RI  roman-text\~\c
+.RI  previous-font-text \~.\|.\|.
+Join
+.I roman-text
+in roman style with
+.I previous-font-text
+in the previous font,
+without space between the arguments.
+.
+If no arguments,
+switch font to roman style.
 .
-Even arguments are printed in roman, odd in boldface.
 .
-See\~\c
-.BR I .
+.TP
+.BR RB \~\c \" space in roman; we must use 2-font macro with \c
+.RI  roman-text\~\c
+.RI  bold-text \~.\|.\|.
+Join
+.I roman-text
+in roman style with
+.I bold-text
+in boldface,
+without space between the arguments.
+.
 .
 .TP
 .BI RD\  "\fR\fPprompt \fR\fPdiversion \fR\fPstring\fR\fP"
@@ -2523,126 +3184,177 @@
 See
 .BR RS .
 .
+.
 .TP
-.BI RI\  "\fR\fProman-text \fR\fPitalic-text \fR\fProman-text \fR.\|.\|.\fP"
-Print even arguments in roman, odd in italic.
+.BR RI \~\c \" space in roman; we must use 2-font macro with \c
+.RI  roman-text\~\c
+.RI  italic-text \~.\|.\|.
+Join
+.I roman-text
+in roman style with
+.I italic-text
+in italics,
+without space between the arguments.
 .
-See\~\c
-.BR I .
 .
 .TP
-.BI RL\  \fR\fPtext-indent \fR\fP1\fR\fP
-Reference list start.
+.BR RL \~\c
+.IR text-indent \~\c
+.BR 1 
+Begin reference list.
 .
-Begins a list where each item is preceded with an automatically
-incremented number between square brackets.
+Each item is preceded by an automatically incremented number between
+square brackets;
+compare
+.BR AL .
 .
 .I text-indent
 changes the default indentation.
 .
-.TP
-.BI RP\  "\fR\fParg1 \fR\fParg2\fR\fP"
-Produce reference page.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
-This macro can be used if a reference page is wanted somewhere in the
-document.
+A second argument,
+conventionally
+.BR 1 ,
+suppresses the blank line that normally precedes each list item.
 .
-It is not needed if
-.B TC
-is used to produce a table of contents.
 .
-The reference page is then printed automatically.
+.TP
+.BR RP \~\c \" space in roman; we must use 2-font macro with \c
+.RI  suppress-counter-reset \~ page-ejection-policy 
+Format a reference page,
+listing items accumulated within
+.BR RS / RF
+pairs.
 .
-.IP
-The reference counter is not reset if
-.I arg1
-is\~1.
+The reference counter is reset unless the first argument
+.RB is\~ 1 .
 .
-.IP
-.I arg2
-tells
-.B RP
-whether to eject a page or not.
+Normally,
+page breaks occur before and after the references are output;
+the register
+.B Rpe
+configures this behavior,
+and a second argument overrides its value.
 .
-.IP
-.B arg2
+.B TC
+calls
+.B RP
+automatically if references have accumulated.
 .
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@The reference page is printed on a separate page.
-1@Do not eject page after the list.
-2@Do not eject page before the list.
-3@Do not eject page before and after the list.
-.TE
-.RE
 .
 .IP
-The reference items are separated by a blank line.
+References are list items,
+and thus are vertically separated
+(see
+.BR LB ).
 .
-Setting number register
+Setting register
 .B Ls
-to\~0 suppresses the line.
+.RB to\~ 0
+suppresses this spacing.
 .
-.IP
 The string
 .B Rp
-contains the reference page title and is set to \oqREFERENCES\cq
-by default.
+contains the reference page caption.
 .
-The number register
-.B Rpe
-holds the default value for the second argument of
-.BR RP ;
-it is initially set to\~0.
 .
+.br
+.ne 5v
 .TP
-.BI RS\  \fR\fPstring-name\fR\fP
+.BR RS \~\c
+.IR reference-string 
 Begin an automatically numbered reference definition.
 .
-Put the string
-.B \rs*(Rf
+By default,
+references are numbered starting at 1;
+the number is available in register
+.BR :R .
+.
+Interpolate the string
+.B Rf
 where the reference mark should be and write the reference between
 .BR RS / RF
-at next new line after the reference mark.
-.
-The reference number is stored in number register
-.BR :R .
+on an input line after the reference mark.
 .
 If
-.I string-name
-is given, a string with that name is defined and contains the current
-reference mark.
+.I reference-string
+is specified,
+.I "groff ms"
+also stores the reference mark in a string of that name,
+which can be interpolated as
+.BI \rs* reference-string 
+subsequently.
 .
-The string can be referenced as
-.BI \rs* string-name 
-later in the text.
 .
 .TP
-.BI S\  "\fR\fPsize \fR\fPspacing\fR\fP"
-Set point size and vertical spacing.
+.BR S \~\c
+.IR type-size \~ vertical-spacing 
+Set type size and vertical spacing.
 .
-If any argument is equal to \oqP\cq, the previous value is used.
+Each argument is a
+.I groff
+measurement,
+using an appropriate scaling unit and an optional
+.B +
+or
+.B \-
+prefix to increment or decrement the current value.
+.
+An argument of
+.B P
+restores the previous value,
+.B C
+indicates the current value,
+and
+.B D
+requests the default.
 .
-A \oqC\cq means current value, and \oqD\cq the default value.
+An empty or omitted argument is treated as
+.BR P .
 .
-If \oq+\cq or \oq\-\cq is used before the value,
-the current value is incremented or decremented, respectively.
 .
 .TP
-.BI SA\  \fR\fParg\fR\fP
-Set right-margin justification.
+.BR SA \~\c
+.RI  mode 
+Set or restore the default enablement of adjustment.
+.
+Specify
+.B 0
+or
+.B 1
+as
+.I mode
+to set a document's default explicitly;
+.B 1
+is assumed by
+.IR mm .
 .
-Justification is turned on by default.
+Adjustment can be temporarily suspended with the
+.B na
+request.
+.
+When the
+.B H
+or
+.B HU
+macros are used to format a heading,
+or when
+.B SA
+is called without a
+.I mode
+argument,
+the default adjustment is restored.
 .
-No argument or value \oq0\cq turns off justification,
-and \oq1\cq turns on justification.
 .
 .TP
 .BI SETR\  "refname \fR\fPstring\fR\fP"
-Remember the current header and page number as
+Remember the current heading and page numbers as
 .IR refname .
 .
 Saves
@@ -2653,7 +3365,7 @@
 .
 .I string
 is retrieved with
-.BR .GETST .
+.BR GETST .
 .
 See
 .BR INITR .
@@ -2669,53 +3381,61 @@
 .
 The reference data is the location, department, and initials specified
 with
-.BR .AU .
+.BR AU .
 .
 It is printed at the first author if the second argument is given,
 otherwise at the last.
 .
 No reference data is printed if the author(s) is specified through
-.BR .WA / .WE .
+.BR WA / WE .
 .
 See section \lqInternals\rq below.
 .
+.
 .TP
-.BI SK\  \fR\fPpages\fR\fP
-Skip pages.
+.BR SK \~\c
+.RI  n 
+Skip
+.I n
+pages.
 .
 If
-.I pages
-is\~0 or omitted, a skip to the next page occurs unless it is already
-at the top of a page.
+.I n
+is\~0 or omitted,
+the page is broken unless the drawing position is already at the top of
+a page.
 .
-Otherwise it skips
-.I pages
-pages.
+Otherwise,
+.I n
+pages,
+blank except for any headers and footers,
+are printed.
 .
-.TP
-.BI SM\  "string1 \fR\fPstring2 \fR\fPstring3\fR\fP"
-Make a string smaller.
 .
-If
-.I string2
-is given,
-.I string1
-is made smaller and
-.I string2
-stays at normal size,
-concatenated with
-.IR string1 .
+.br
+.ne 4v \" XXX: 3v should suffice
+.TP
+.BI SM\~ text\~\c
+.RI  post 
+.TQ
+.BI SM\~ "pre text post"
+Format
+.I text
+at a smaller type size,
+joined with any specified
+.I pre
+and
+.I post
+at normal size.
 .
-With three arguments, everything is concatenated, but only
-.I string2
-is made smaller.
 .
 .TP
 .BI SP\  \fR\fPlines\fR\fP
 Space vertically.
 .
 .I lines
-can have any scaling factor, like \oq3i\cq or \oq8v\cq.
+can have any scaling factor,
+like \lq3i\rq or \lq8v\rq.
 .
 Several
 .B SP
@@ -2730,137 +3450,169 @@
 .B SP
 to avoid this.
 .
+.
 .TP
 .B TAB
-Reset tabs to every\ 5n.
+Reset tab stops to every 5\~ens.
 .
-Normally used to reset any previous tab positions.
 .
+.br
+.ne 4v
 .TP
-.BI TB\  "\fR\fPtitle \fR\fPoverride \fR\fPflag \fR\fPrefname\fR\fP"
-Table title.
+.BR TB \~\c
+.RI  title \~ override \~ flag \~  refname 
+Caption a table.
 .
-The arguments are the same as for
+Arguments are handled analogously to
 .BR EC .
 .
-.B TB
-uses the number register
+The register
 .B Tb
-as a counter.
-.
-The string
-.B Lt
-controls the title of the List of Tables;
-default value is \oqLIST OF TABLES\cq.
-.
-The List of Tables is only printed if number register
-.B Lt
-is\~1, which is the default.
+is the table counter.
 .
 The string
 .B Litb
-contains the word \oqTABLE\cq, which is printed before the number.
+precedes the table number and any
+.I title.
 .
-.IP
-Special handling of the title occurs if
-.B TB
-is used inside
-.BR DS / DE ,
-it is not affected by the format of
-.BR DS .
-.
-.TP
-.BI TC\  "\fR\fPslevel \fR\fPspacing \fR\fPtlevel \fR\fPtab \fR\fPh1 \fR\fPh2 \fR\fPh3 \fR\fPh4 \fR\fPh5\fR\fP"
-Table of contents.
+Table captions are centered irrespective of the alignment of any
+enclosing display.
 .
-This macro is normally used as the last line of the document.
 .
-It generates a table of contents with headings up to the level
-controlled by number register
-.BR Cl .
+.IP
+Captioned tables are listed in a table of contents
+(see
+.BR TC )
+if the Boolean register
+.B Lt
+is true.
 .
-Note that
+Such a list uses the string
+.B Lt
+as a heading.
+.
+.
+.TP
+.BR TC \~\c
+.RI  slevel\~\c
+.RI  spacing\~\c
+.RI  tlevel\~\c
+.RI  tab\~\c
+.RI  h1\~\c
+.RI  h2\~\c
+.RI  h3\~\c
+.RI  h4\~\c
+.RI  h5 
+Output table of contents.
+.
+This macro is normally the last called in the document.
+.
+It flushes any pending displays and,
+if any references are pending
+(see
+.BR RS ),
+calls
+.BR RP .
+.
+It then begins a new page with the contents caption,
+stored in the string
+.BR Licon ,
+centered at the top.
+.
+The entries follow after three vees of space.
+.
+Each entry is a
+saved section
+(number and)
+heading title
+(see the
 .B Cl
-controls the saving of headings, it has nothing to do with
-.BR TC .
+register),
+along with its associated page number.
+.
+By default,
+an entry is indented by an amount corresponding to its heading level
+and the maximum heading length encountered at that heading level;
+if defined,
+the string
+.B Ci
+overrides these indentations.
 .
-Headings with a level less than or equal to
+Entries at heading levels up to and including
 .I slevel
-get
+are preceded by
 .I spacing
-number of lines before them.
+vees of space.
 .
-Headings with a level less than or equal to
+Entries at heading levels up to and including
 .I tlevel
-have their page numbers right\-justified with dots or spaces separating
-the text and the page number.
+are followed by a leader and a right-aligned page number.
 .
-Spaces are used if
+If the Boolean-valued
 .I tab
-is greater than zero, dots otherwise.
+argument is true,
+the leader is replaced with horizontal motion in the same amount.
 .
-Other headings have the page number directly at the end of the heading
-text
-.RI ( ragged-right ).
+For entries above heading level
+.IR tlevel ,
+the page number follows the heading text after a word space.
+.
+Each argument
+.IR h1 .\|.\|. h5
+appears in order on its own line,
+centered,
+above the contents caption.
+.
+Page numbering restarts at 1,
+in register format \lqi\rq.
+.
+If the
+.B Oc
+register is true,
+numbering of these pages is suppressed.
 .
-.IP
-The rest of the arguments is printed, centered, before the table of
-contents.
 .
 .IP
-The user-defined macros
-.B TX
-and
-.B TY
-are used if
+If
 .B TC
-is called with at most four arguments.
-.
+is called with at most four arguments,
+it calls the user-defined macro
 .B TX
-is called before the printing of the string \oqCONTENTS\cq,
+(if defined)
+prior to formatting the contents caption,
 and
 .B TY
-is called instead of printing \oqCONTENTS\cq.
+(if defined)
+.I instead
+of formatting the contents caption.
+.
 .
 .IP
-Equivalent macros can be defined for list of figures, tables, equations
-and exhibits by defining
+Analogous handling of lists of figures,
+tables,
+equations,
+and exhibits is achieved by defining
 .BI TX xx
-or
-.BI TY xx\fR,\fP
+and
+.BI TY xx
+macros,
 where
 .I xx
-is \oqFg\cq, \oqTB\cq, \oqEC\cq, or \oqEX\cq,
+is \lqFG\rq,
+\lqTB\rq,
+\lqEC\rq,
+or \lqEX\rq,
 respectively.
 .
-.IP
-String
-.B Ci
-can be set to control the indentations for each heading-level.
-.
-It must be scaled, like
-.
-.RS
-.IP
-\&.ds Ci .25i .5i .75i 1i 1i
-.RE
-.
-.IP
-By default, the indentation is controlled by the maximum length of
-headings in each level.
-.
-.IP
-The string variables
+Similarly,
+the strings
 .BR Lifg ,
 .BR Litb ,
 .BR Liex ,
-.BR Liec ,
 and
-.B Licon
-contain \oqFigure\cq, \oqTABLE\cq, \oqExhibit\cq,
-\oqEquation\cq, and \oqCONTENTS\cq, respectively.
+.B Liec
+determine captions for their respective lists.
 .
-These can be redefined to other languages.
 .
 .TP
 .B TE
@@ -2870,174 +3622,176 @@
 .BR TS .
 .
 .TP
-.B TH \fR\fPN\fR\fP
-Table header.
+.B TH
+End table heading.
+.
+It is repeated after page breaks within a table.
 .
 See
 .BR TS .
 .
-.B TH
-ends the header of the table.
-.
-This header is printed again if a page break occurs.
+The
+.B N
+argument supported by DWB
+.I mm
+is not implemented by
+.I "groff mm."
 .
-Argument \oqN\cq isn't implemented yet.
 .
 .TP
-.BI TL\  "\fR\fPcharging-case-number \fR\fPfiling-case-number\fR\fP"
-Begin title of memorandum.
+.BR TL \~\c
+.IR charging-case-number \~\c
+.IR filing-case-number 
+Begin document title.
 .
-All text up to the next
+Input is collected into the title until
+.B AF
+or
 .B AU
-is included in the title.
+is called,
+and output as directed by the cover page.
 .
 .I charging-case-number
 and
 .I filing-case-number
-are saved for use in the front page processing.
+are saved for use in memorandum types 0 and 5.
 .
-.TP
-.BI TM\  "\fR\fPnum1 \fR\fPnum2 \fR.\|.\|.\fP"
-Technical memorandum numbers used in
-.BR .MT .
+See
+.BR MT .
 .
-An unlimited number of arguments may be given.
 .
 .TP
-.B TP
-Top-of-page user-defined macro.
+.BI TM\~ number\c
+\~.\|.\|.
+Declare technical memorandum number(s) used by
+.BR MT .
 .
-This macro is called instead of the normal page header.
 .
-It is possible to get complete control over the header.
-.
-Note that the header and the footer are printed in a separate environment.
+.br
+.ne 6v
+.TP
+.B TP
+If defined,
+this macro is called in lieu of normal page header layout.
 .
-Line length is preserved, though.
+Headers and footers are formatted in a separate environment.
 .
 See
 .BR EOP .
 .
+.
 .IP
-.B strings available to TP
-.RS
 .TS
 tab(@);
-l l.
-TPh@argument of \fBPH\fP
-TPeh@argument of \fBEH\fP
-TPoh@argument of \fBOH\fP
+Cb S
+Lb L.
+Strings available to TP
+_
+TPh@argument to \fBPH\fP
+TPeh@argument to \fBEH\fP
+TPoh@argument to \fBOH\fP
 .TE
-.RE
+.
 .
 .TP
 .B TS \fR\fPH\fR\fP
 Table start.
 .
-This is the start of a table specification to
-.BR @g@tbl (@MAN1EXT@).
-.
-.B TS
-ends with
-.BR TE .
-.
-Argument \oqH\cq tells
-.B m@TMAC_M_PREFIX@m
-that the table has a header.
-.
-See
-.BR TH .
-.
-.TP
-.B TX
-User-defined table of contents exit.
-.
-This macro is called just before
-.B TC
-prints the word \oqCONTENTS\cq.
+Argument \lqH\rq tells
+.I mm
+that the table has a heading.
 .
 See
-.BR TC .
-.
-.TP
-.B TY
-User-defined table of contents exit.
-.
-This macro is called instead of printing \oqCONTENTS\cq.
+.BR TE ,
+.BR TH ,
+and
+.MR @g@tbl @MAN1EXT@ .
 .
-See
-.BR TC .
 .
 .TP
-.BI VERBON\  "\fR\fPflag \fR\fPpoint-size \fR\fPfont\fR\fP"
-Begin verbatim output using Courier font.
-.
-Usually for printing programs.
+.BR VERBON \~\c \" space in roman; we must use 2-font macro with \c
+.RI  format \~ type-size \~ font 
+Begin verbatim display,
+where characters have equal width.
 .
-All characters have equal width.
+.I format
+controls several parameters.
 .
-The point size can be changed with the second argument.
+Add up the values of desired features;
+the default
+.RB is\~ 0 .
 .
-By specifying a third argument it is possible to use another font
-instead of Courier.
+On typesetting devices,
+further arguments configure the
+.I type-size
+in scaled points,
+and the face
+.RI ( font );
+the default is
+.B CR
+(Courier roman).
 .
-.I flag
-controls several special features.
-.
-Its value is the sum of all wanted features.
 .
-.RS
 .IP
 .TS
 tab(@);
 lb lb
 l lx.
-Arg@Description
-1@T{
-Disable the escape character (\rs).
-This is normally turned on during verbose output.
-T}
-2@Add an empty line before the verbose text.
-4@Add an empty line after the verbose text.
+Value@Effect
+1@Disable the formatter's escape character (\rs).
+2@Vertically space before the display.
+4@Vertically space after the display.
 8@T{
-Print the verbose text with numbered lines.
-This adds four digit-sized spaces in the beginning of each line.
-Finer control is available with the string variable
+Number output lines; call formatter's
+.B nm
+request with arguments in string
 .BR Verbnm .
-It contains all arguments to the
-.BR troff (@MAN1EXT@)
-command
-.BR .nm ,
-normally \oq1\cq.
 T}
 16@T{
-Indent the verbose text by \oq5n\cq.
-.
-This is controlled by the number-variable
-.B Verbin
-(in units).
+Indent by the amount stored in register
+.BR Verbin .
 T}
 .TE
-.RE
+.
 .
 .TP
 .B VERBOFF
-End verbatim output.
+End verbatim display.
+.
 .
 .TP
-.BI VL\  "text-indent \fR\fPmark-indent\ " \fR\fP1\fR\fP
-Variable-item list.
+.BR VL \~\c
+.IR text-indent \~ mark-indent \~\c
+.BR 1 
+Begin variable-item
+(or \lqtagged\rq)
+list.
 .
-It has no fixed mark, it assumes that every
-.B LI
-has a mark instead.
+Each item should supply its own mark,
+or tag.
+.
+If the mark is wider than
+.I mark-indent,
+one space separates it from subsequent text;
+contrast
+.BR BVL .
 .
 .I text-indent
-sets the indent to the text, and
+sets the indentation of the text,
+and
 .I mark-indent
-the distance from the current indentation to the mark.
+the distance from the current list indentation to the mark.
+.
+A third argument suppresses the blank line that normally precedes each
+list item.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
-A third argument prohibits printing of a blank line before each item.
 .
 .TP
 .BI "VM \fR\fP\-T\fR \fP" "top \fR\fPbottom\fR\fP"
@@ -3057,7 +3811,8 @@
 .IR bottom .
 .
 If no argument is given, reset the margin to zero, or to the default
-(\oq7v 5v\cq) if
+(\lq7v 5v\rq)
+if
 .B \-T
 is used.
 .
@@ -3069,77 +3824,183 @@
 .B \-T
 and setting top and/or bottom margin to less than the default.
 .
+This undocumented DWB
+.I mm
+macro is exposed by
+.I groff mm
+to increase user control of page layout.
+.
+.
 .TP
-.BI WA\  "\fR\fPwriter-name \fR\fPtitle\fR\fP"
-Begin specification of the writer and writer's address.
+.BR WA \~\c
+.IR writer's-name \~\c
+.IR title 
+Specify the writer(s) of an
+.B LT
+letter.
+.
+Input is collected into the writer's address until
+.B WA
+is called,
+and then output.
 .
-Several names can be specified with empty
+You can specify multiple writers with empty
 .BR WA / WE
-pairs, but only one address.
+pairs;
+only the last address is used.
+.
+The arguments give each writer a name and title.
 .
-.TP
-.B WE
-End the address specification after
-.BR .WA .
 .
 .TP
-.BI WC\  "\fR\fPformat1\fR \fPformat2\fR .\|.\|.\fP"
-Footnote and display width control.
+.BR WC \~\c
+.IR format \~.\|.\|.
+Control width of footnotes and displays.
+.
 .
+.IP
 .RS
 .TS
 tab(@);
-l lx.
+Lf(BI) Lb
+Lb Lx.
+format@Effect
 N@T{
-Set default mode which is equal to using the options
-.BR \-WF ,
-.BR \-FF ,
-.BR \-WD ,
-and
-.BR FB .
+equivalent to
+.RB \lq "\-WF \-FF \-WD" \rq
+.\" FB \" XXX: see Savannah ticket reference below
+(default)
 T}
 WF@T{
-Wide footnotes, wide also in two-column mode.
+set footnotes at full line length,
+even in two-column mode
+.\" XXX: what about multi-column modes more generally?
+T}
+\-WF@T{
+set footnotes using column line length
 T}
--WF@Normal footnote width, follow column mode.
 FF@T{
-All footnotes gets the same width as the first footnote encountered.
+apply width of first footnote to encountered to subsequent ones
 T}
--FF@T{
-Normal footnotes, width follows \fBWF\fP and \fB-WF\fP.
+\-FF@T{
+footnote width determined by
+.B WF
+and
+.B \-WF
 T}
 WD@T{
-Wide displays, wide also in two-column mode.
-T}
--WD@T{
-Normal display width, follow column mode.
-T}
-FB@T{
-Floating displays generates a line break when printed on the current
-page.
+set displays at full line length,
+even in two-column mode
+.\" XXX: what about multi-column modes more generally?
 T}
--FB@T{
-Floating displays does not generate line break.
+\-WD@T{
+set displays using column line length
 T}
 .TE
 .RE
+.\" XXX: See <https://savannah.gnu.org/bugs/?64316>.
+.\"FB@T{
+.\"Break when outputting floating displays.
+.\"T}
+.\"\-FB@T{
+.\"Do not break when outputting floating displays.
+.\"T}
+.
+.
+.TP
+.B WE
+End the writer's address begun with
+.BR WA .
 .
 .
+.br
+.ne 4v
 .\" ====================================================================
-.SS "Strings used in m@TMAC_M_PREFIX@m"
+.SH Strings
 .\" ====================================================================
 .
+Many
+.I mm
+strings interpolate predefined,
+localizable text.
+.
+These are presented in quotation marks.
+.
+.
 .TP
 .B App
-A string containing the word \oqAPPENDIX\cq.
+\lqAPPENDIX\rq
+.
 .
 .TP
 .B Apptxt
-The current appendix text.
+stores the
+.I title
+argument to the last
+.B APP
+call.
+.
+.
+.TP
+.B BU
+interpolates a bullet
+(see
+.BR BL ).
+.
+.
+.TP
+.B Ci
+is a list of indentation amounts to use for table of contents heading
+levels,
+overriding their automatic computation.
+.
+Each word must be a horizontal measurement
+(like
+.RB \lq 1i \rq)
+and is mapped one-to-one to heading levels 1,
+2,
+and so on.
+.
+.
+.TP
+.B DT
+The date;
+set by the
+.B ND
+macro
+(defaults to the date the document is formatted).
+.
+The format is the conventional one for the
+.I groff
+locale,
+but see the
+.B ISODATE
+macro and
+.B Iso
+register.
+.
 .
 .TP
 .B EM
-Em dash string
+interpolates an em dash.
+.
+.
+.TP
+.B F
+interpolates an automatically numbered footnote marker;
+the number is used by the next
+.B FS
+call without an argument.
+.
+In
+.I troff
+mode,
+the marker is superscripted;
+in
+.I nroff
+mode,
+it is surrounded by square brackets.
+.
 .
 .TP
 .B H1txt
@@ -3151,191 +4012,268 @@
 .
 Also updated in table of contents & friends.
 .
+.
 .TP
 .B HF
-Font list for headings, \oq2 2 2 2 2 2 2\cq by default.
+assigns font identifiers,
+separated by spaces,
+to heading levels in one-to-one correspondence.
+.
+Each identifier may be a font mounting position,
+font name,
+or style name.
+.
+Omitted values are assumed to be\~1.
+.
+The default is
+.RB \lq "2 2 2 2 2 2 2 2 2 2 2 2 2 2" \rq,
+which places all headings in italics.
+.
+DWB
+.IR mm 's
+default was
+.RB \lq "3 3 2 2 2 2 2" \rq.
 .
-Non-numeric font names may also be used.
 .
 .TP
 .B HP
-Point size list for headings.
+assigns type sizes,
+separated by spaces,
+to heading levels in one-to-one correspondence.
+.
+Each size is interpreted in scaled points;
+zero values are translated to
+.BR 10 .
+.
+Omitted values are assumed to be\~0
+(and are translated accordingly).
+.
+The default is
+.RB \lq "0 0 0 0 0 0 0 0 0 0 0 0 0 0" \rq.
 .
-By default, this is \cq0 0 0 0 0 0 0\cq which is the same as \oq10
-10 10 10 10 10 10\cq.
 .
 .TP
 .B Index
-Contains the string \oqINDEX\cq.
+\lqINDEX\rq
+.
 .
 .TP
-.B Indcmd
-Contains the index command.
+.B Le
+\lqLIST OF EQUATIONS\rq
 .
-Default value is \oqsort\ \-t\rst\cq.
 .
 .TP
-.B Lifg
-String containing \oqFigure\cq.
+.B Letfc
+\lqYours very truly,\rq
+(see
+.BR FC )
 .
-.TP
-.B Litb
-String containing \oqTABLE\cq.
 .
 .TP
-.B Liex
-String containing \oqExhibit\cq.
+.B Letapp
+\lqAPPROVED:\rq
+(see
+.BR AV )
 .
-.TP
-.B Liec
-String containing \oqEquation\cq.
 .
 .TP
-.B Licon
-String containing \oqCONTENTS\cq.
+.B LetAT
+\lqATTENTION:\rq
+(see
+.BR LO )
 .
-.TP
-.B Lf
-Contains the string \oqLIST OF FIGURES\cq.
 .
 .TP
-.B Lt
-Contains the string \oqLIST OF TABLES\cq.
+.B LetCN
+\lqCONFIDENTIAL\rq
+(see
+.BR LO )
+.
 .
 .TP
-.B Lx
-Contains the string \oqLIST OF EXHIBITS\cq.
+.B Letdate
+\lqDate\rq
+(see
+.BR AV )
+.
 .
 .TP
-.B Le
-Contains the string \oqLIST OF EQUATIONS\cq.
+.B Letns
+is a group of strings structuring the notations produced by
+.BR NS .
+.
+If the
+.I code
+argument to
+.B NS
+has no corresponding string,
+the notation is included between parentheses,
+prefixed with
+.BR Letns!copy ,
+and suffixed with
+.BR Letns!to .
+.
+Observe the spaces after \lqCopy\rq and before \lqto\rq.
+.
+.
+.RS
+.P
+.TS
+tab(@);
+Lb Lb Lb
+L L L.
+NS code@String@Contents
+0@Letns!0@Copy to
+1@Letns!1@Copy (with att.\&) to
+2@Letns!2@Copy (without att.\&) to
+3@Letns!3@Att.
+4@Letns!4@Atts.
+5@Letns!5@Enc.
+6@Letns!6@Encs.
+7@Letns!7@Under separate cover
+8@Letns!8@Letter to
+9@Letns!9@Memorandum to
+10@Letns!10@Copy (with atts.\&) to
+11@Letns!11@Copy (without atts.\&) to
+12@Letns!12@Abstract Only to
+13@Letns!13@Complete Memorandum to
+14@Letns!14@CC
+\em@Letns!copy@Copy \fI(with trailing space)\fP
+\em@Letns!to@ to \fI(note leading space)\fP
+.TE
+.RE
+.
 .
 .TP
-.B Letfc
-Contains the string \oqYours very truly,\cq,
-used in
-.BR .FC .
+.B Letnsdef
+Select the notation format used by
+.B NS
+when it is given no argument.
+.
+The default is
+.RB \lq 0 \rq.
+.
 .
 .TP
-.B Letapp
-Contains the string \oqAPPROVED:\cq,
-used in
-.BR .AV .
+.B LetRN
+\lqIn reference to:\rq
+(see
+.BR LO )
+.
 .
 .TP
-.B Letdate
-Contains the string \oqDate\cq,
-used in
-.BR .AV .
+.B LetSA
+\lqTo Whom It May Concern:\rq
+(see
+.BR LO )
+.
 .
 .TP
-.B LetCN
-Contains the string \oqCONFIDENTIAL\cq,
-used in
-.BR ".LO CN" .
+.B LetSJ
+\lqSUBJECT:\rq
+(see
+.BR LO )
+.
 .
 .TP
-.B LetSA
-Contains the string \oqTo Whom It May Concern:\cq,
-used in
-.BR ".LO SA" .
+.B Lf
+\lqLIST OF FIGURES\rq
+.
 .
 .TP
-.B LetAT
-Contains the string \oqATTENTION:\cq,
-used in
-.BR ".LO AT" .
+.B Licon
+\lqCONTENTS\rq
+.
 .
 .TP
-.B LetSJ
-Contains the string \oqSUBJECT:\cq,
-used in
-.BR ".LO SJ" .
+.B Liec
+\lqEquation\rq
+.
 .
 .TP
-.B LetRN
-Contains the string \oqIn reference to:\cq,
-used in
-.BR ".LO RN" .
+.B Liex
+\lqExhibit\rq
+.
 .
 .TP
-.B Letns
-is an array containing the different strings used in
-.BR .NS .
+.B Lifg
+\lqFigure\rq
 .
-It is really a number of string variables prefixed with
-.BR Letns! .
 .
-If the argument doesn't exist, it is included between
-.B ()
-with
-.B Letns!copy
-as a prefix and
-.B Letns!to
-as a suffix.
+.TP
+.B Litb
+\lqTABLE\rq
 .
-Observe the space after \oqCopy\cq and before \oqto\cq.
 .
-.RS
-.IP
-.TS
-tab(@);
-lb lb
-l l.
-Name@Value
-Letns!0@Copy to
-Letns!1@Copy (with att.\&) to
-Letns!2@Copy (without att.\&) to
-Letns!3@Att.
-Letns!4@Atts.
-Letns!5@Enc.
-Letns!6@Encs.
-Letns!7@Under separate cover
-Letns!8@Letter to
-Letns!9@Memorandum to
-Letns!10@Copy (with atts.\&) to
-Letns!11@Copy (without atts.\&) to
-Letns!12@Abstract Only to
-Letns!13@Complete Memorandum to
-Letns!14@CC
-Letns!copy@Copy \fI(with trailing space)\fP
-Letns!to@ to \fI(note leading space)\fP
-.TE
-.RE
+.TP
+.B Lt
+\lqLIST OF TABLES\rq
+.
 .
 .TP
-.B Letnsdef
-Define the standard notation used when no argument is given to
-.BR .NS .
+.B Lx
+\lqLIST OF EXHIBITS\rq
 .
-Default is\~0.
 .
 .TP
-.B "MO1 \(en MO12"
-Strings containing the month names \oqJanuary\cq through
-\oqDecember\cq.
+.BR MO1 \|.\|.\|.\| MO12
+\lqJanuary\rq through \lqDecember\rq
+.
 .
 .TP
 .B Qrf
-String containing \oqSee chapter \rs\rs*Qrfh, page
-\rs\rsnQrfp.\cq.
+\lqSee chapter \rs\rs*Qrfh,
+page \rs\rsnQrfp.\rq
+.
+.
+.TP
+.B Rf
+interpolates an automatically numbered reference mark;
+the number is used by the next
+.B RS
+call.
+.
+In
+.I troff
+mode,
+the marker is superscripted;
+in
+.I nroff
+mode,
+it is surrounded by square brackets.
+.
 .
 .TP
 .B Rp
-Contains the string \oqREFERENCES\cq.
+\lqREFERENCES\rq
+.
+.
+.
+.TP
+.B Sm
+interpolates
+.if c \u2120 \u2120,
+the service mark sign.
+.
 .
 .TP
 .B Tcst
-Contains the current status of the table of contents and list of
-figures, etc.
+interpolates an indicator of the
+.B TC
+macro's processing status.
 .
-Empty outside of
-.BR .TC .
+If
+.B TC
+is not operating,
+it is empty.
+.
+User-defined
+.B TP
+or
+.B EOP
+macros might condition page headers or footers on its contents.
 .
-Useful in user-defined macros like
-.BR .TP .
 .
-.RS
 .IP
 .TS
 tab(@);
@@ -3349,594 +4287,1029 @@
 ex@List of exhibits
 ap@Appendix
 .TE
-.RE
+.
 .
 .TP
 .B Tm
-Contains the string \oq\rs(tm\cq, the trade mark symbol.
+interpolates
+.if c \tm \tm,
+the trade mark sign.
+.
 .
 .TP
 .B Verbnm
-Argument to
-.B .nm
-in the
-.B .VERBON
-command.
+supplies argument(s) to the
+.B nm
+request employed by the
+.B VERBON
+macro.
 .
-Default is\~1.
+The default is\~\lq1\rq.
 .
 .
+.br
+.ne 4v
 .\" ====================================================================
-.SS "Number variables used in m@TMAC_M_PREFIX@m"
+.SH Registers
 .\" ====================================================================
 .
+Default register values,
+where meaningful,
+are shown in parentheses.
+.
+Many are also marked as Boolean-valued,
+meaning that they are considered \lqtrue\rq
+(on,
+enabled)
+when they have a positive value,
+and \lqfalse\rq
+(off,
+disabled)
+otherwise.
+.
+.
 .TP
-.B Aph
-Print an appendix page for every new appendix  if this number variable
-is non-zero.
+.B .mgm
+indicates that
+.I groff mm
+is in use
+(Boolean-valued;
+.BR 1 ).
 .
-No output occurs if
+.
+.TP
+.B :p
+is an auto-incrementing footnote counter;
+see
+.BR FS .
+.
+.
+.TP
+.B :R
+is an auto-incrementing reference counter;
+see
+.BR RS .
+.
+.
+.TP
 .B Aph
-is zero, but there is always an appendix entry in the \oqList of
-contents\cq.
+formats an appendix heading
+(and title,
+if supplied);
+see
+.B APP
+(Boolean-valued;
+.BR 1 ).
+.
+.
+.TP
+.B Au
+includes supplemental author information
+(the third and subsequent arguments to
+.BR AU )
+in memorandum \lqfrom\rq information;
+see
+.B COVER
+and
+.B MT
+(Boolean-valued;
+.BR 1 ).
+.
 .
 .TP
 .B Cl
-Contents level (in the range 0 to 14).
+sets the threshold for inclusion of headings in a table of contents.
+.
+Headings at levels above this value are excluded;
+see
+.B H
+and
+.B TC
+.RB ( 2 ).
 .
-The contents is saved if a heading level is lower than or equal to the
-value of
-.BR Cl .
+The
+.B Cl
+register controls whether a heading is
+.I saved
+for output in the table of contents at the time
+.B H
+or
+.B HU
+is called;
+if you change
+.BR Cl 's
+value immediately prior to calling
+.BR TC ,
+you are unlikely to get the result you want.
 .
-Default is\~2.
 .
 .TP
 .B Cp
-Eject page between list of table, list of figure, etc., if the value of
-.B Cp
-is zero.
+suppresses page breaks before lists of captioned
+equations,
+exhibits,
+figures,
+and tables,
+and before an index;
+see
+.BR EC ,
+.BR EX ,
+.BR FG ,
+.BR TB ,
+and
+.B INDP
+(Boolean-valued;
+.\" DWB 3.3's manual said this was 1, but the code said 0.
+.BR 0 ).
 .
-Default is\~0.
 .
 .TP
 .B D
-Debug flag.
+produces debugging information for the
+.I mm
+package on the standard error stream.
 .
-Values greater than zero produce debug information of increasing
-verbosity.
+A value of\~0 outputs nothing;
+1\~reports formatting progress.
 .
-A value of\~1 gives information about the progress of formatting.
+Higher values communicate internal state information of increasing
+verbosity
+.RB ( 0 ).
 .
-Default is\~0.
 .
 .TP
 .B De
-If set to\~1, eject after floating display is output.
+causes a page break after a floating display is output;
+see
+.B DF
+(Boolean-valued;
+.BR 0 ).
 .
-Default is\~0.
 .
 .TP
-.B Dsp
-If defined, it controls the space output before and after static
-displays.
+.B Df
+configures the behavior of
+.BR DF .
 .
-Otherwise the value of
-.B Lsp
-is used.
+The following values are recognized;
+4 and 5 do not override the
+.B De
+register
+.RB ( 5 ).
 .
-.TP
-.B Df
-Control floating keep output.
 .
-This is a number in the range 0 to 5, with a default value of\~5.
+.IP
+.TS
+tab(@);
+Lb Lb
+L Lx.
+Value@Effect
+0@T{
+Flush pending displays
+at the end of each section
+when section-page numbering is active,
+otherwise at the end of the document.
+T}
+1@T{
+Flush a pending display
+on the current page or column
+if there is enough space,
+otherwise at the end of the document.
+T}
+2@T{
+Flush one pending display
+at the top of each page or column.
+T}
+3@T{
+Flush a pending display
+on the current page or column
+if there is enough space,
+otherwise at the top of the next.
+T}
+4@T{
+Flush as many pending displays
+as possible in a new page or column.
+T}
+5@T{
+Fill columns or pages with flushed displays
+until none remain.
+T}
+.TE
 .
-See
-.BR .DF .
 .
 .TP
 .B Ds
-If set to\~1, use the amount of space stored in register
+puts vertical space in the amount of register
+.B Dsp
+(if defined) or
 .B Lsp
-before and after display.
+before and after each static display;
+see
+.B DS
+(Boolean-valued;
+.BR 1 ).
+.
+.
+.TP
+.B Dsp
+configures the amount of vertical space placed
+before and after static displays;
+see
+.B DS
+and register
+.B Ds
+.RI ( undefined ).
+.
+.
+.TP
+.B Ec
+is an auto-incrementing equation counter;
+see
+.BR EC .
 .
-Default is\~1.
 .
 .TP
 .B Ej
-If set to\~1, eject page before each first-level heading.
+sets the threshold for page breaks (ejection) prior to the format of
+headings.
+.
+Headings at levels above this value are set on the same page and column
+if possible;
+see
+.B H
+.RB ( 0 ).
 .
-Default is\~0.
 .
 .TP
 .B Eq
-Equation labels are left-adjusted if set to\~0 and right-adjusted if
-set to\~1.
+aligns an equation label to the left of a display instead of the right
+(Boolean-valued;
+.BR 0 ).
+.
+.
+.TP
+.B Ex
+is an auto-incrementing exhibit counter;
+see
+.BR EX .
+.
+.
+.TP
+.B Fg
+is an auto-incrementing figure counter;
+see
+.BR FG .
 .
-Default is\~0.
 .
 .TP
 .B Fs
-Footnote spacing.
+is multiplied by register
+.B Lsp
+to vertically separate footnotes;
+see
+.B FS
+.RB ( 1 ).
 .
-Default is\~1.
 .
 .TP
-.B "H1 \(en H7"
-Heading counters
+.BR H1 \|.\|.\|.\| H14
+are auto-incrementing counters corresponding to each heading level;
+see
+.BR H .
 .
+.
+.\" XXX: This could be generalized to an "Hdot" threshold register with
+.\" a default of 2.
 .TP
 .B H1dot
-Append a dot after the level-one heading number if value is greater
-than zero.
+appends a period to the number of a level one heading;
+see
+.B H
+(Boolean-valued;
+.BR 1 ).
 .
-Default is\~1.
 .
+.\" XXX: This may be insufficiently general; see Savannah #62825.
 .TP
 .B H1h
-A copy of number register
-.BR H1 ,
-but it is incremented just before the page break.
+is a copy of
+A copy of register
+.RB register\~ H1 ,
+but it is incremented just before a page break.
+.
+This can be useful in user-defined macros;
+see
+.B H
+and
+.BR HX .
 .
-Useful in user-defined header macros.
 .
 .TP
 .B Hb
-Heading break level.
+sets the threshold for breaking the line after formatting a heading.
 .
-A number in the range 0 to 14, with a default value of\~2.
+Text after headings at levels above this value are set on the same
+output line if possible;
+see
+.B H
+.RB ( 2 ).
 .
-See\~\c
-.BR .H .
 .
 .TP
 .B Hc
-Heading centering level.
+sets the threshold for centering a heading.
 .
-A number in the range 0 to 14, with a default value value of\~0.
+Headings at levels above this value use the prevailing alignment
+(that is,
+they are not centered);
+see
+.B H
+.RB ( 0 ).
 .
-See\~\c
-.BR .H .
 .
 .TP
 .B Hi
-Heading temporary indent.
+configures the indentation of text after headings.
+.
+It does not affect \lqrun-in\rq headings.
+.
+The following values are recognized;
+see
+.B H
+and
+.B P
+.RB ( 1 ).
 .
-A number in the range 0 to 2, with a default value of\~1.
 .
-.RS
 .IP
 .TS
 tab(@);
-l lx.
-0@no indentation, left margin
-1@T{
-indent to the right, similar to
-.RB \oq ".P 1" \cq
-T}
-2@T{
-indent to line up with text part of preceding heading
-T}
+Lb Lb
+L Lx.
+Value@Effect
+0@no indentation
+1@indent per the paragraph type
+2@indent to align with heading title
 .TE
-.RE
+.
 .
 .TP
 .B Hps
-Heading pre-space level.
+sets the heading level threshold for application of preceding vertical
+space;
+see
+.BR H .
 .
-If the heading level is less than or equal to
-.BR Hps ,
-two lines precede the section heading instead of one.
+Headings at levels above the value in register
+.B Hps
+use the amount of space in register
+.BR Hps1 ;
+otherwise that in
+.BR Hps2 .
 .
-Default is first level only.
+The value of
+.B Hps
+should be strictly greater than that of
+.B Ej
+.RB ( 1 ).
 .
-The real amount of lines is controlled by the variables
-.B Hps1
-and
-.BR Hps2 .
 .
 .TP
 .B Hps1
-Number of lines preceding
-.B .H
-if the heading level is greater than
-.BR Hps .
+configures the amount of vertical space preceding a heading above the
+.B Hps
+threshold;
+see
+.B H
+.RI ( troff
+devices:
+.BR 0.5v ;
+.I nroff
+devices:
+.BR 1v ).
 .
-Value is in units, default is 0.5.
 .
 .TP
 .B Hps2
-Number of lines preceding
-.B .H
-if the heading level is less than or equal to
-.BR Hps .
+configures the amount of vertical space preceding a heading at or below
+the
+.B Hps
+threshold;
+see
+.B H
+.RI ( troff
+devices:
+.BR 1v ;
+.I nroff
+devices:
+.BR 2v ).
 .
-Value is in units, default is\~1.
 .
 .TP
 .B Hs
-Heading space level.
+sets the heading level threshold for application of succeeding vertical
+space.
 .
-A number in the range 0 to 14, with a default value of\~2.
+If the heading level is greater than
+.BR Hs ,
+the heading is followed by vertical space in the amount of
+.RB register\~ Hss ;
+see
+.B H
+.RB ( 2 ).
 .
-See\~\c
-.BR .H .
 .
 .TP
 .B Hss
-Number of lines following
-.B .H
-if the heading level is less than or equal to
-.BR Hs .
+is multiplied by register
+.B Lsp
+to produce vertical space after headings above the
+threshold in
+.RB register\~ Hs ;
+see
+.B H
+.RB ( 1 ).
 .
-Value is in units, default is\~1.
 .
 .TP
 .B Ht
-Heading numbering type.
+suppresses output of heading level counters above the lowest when the
+heading is formatted;
+see
+.B H
+(Boolean-valued;
+.BR 0 ).
+.
 .
-.RS
-.IP
-.TS
-tab(@);
-l l.
-0@multiple levels (1.1.1, 1.1.2, etc.)
-1@single level
-.TE
-.RE
-.IP
-Default is\~0.
 .
 .TP
 .B Hu
-Unnumbered heading level.
+sets the heading level used by unnumbered headings;
+see
+.B HU
+.RB ( 2 ).
 .
-Default is\~2.
 .
 .TP
 .B Hy
-Hyphenation status of text body.
-.
-.RS
-.IP
-.TS
-7tab(@);
-l l.
-0@no hyphenation
-1@hyphenation on, set to value\~6
-.TE
-.RE
+enables automatic hyphenation of words
+(Boolean-valued;
+.BR 0 ).
 .
-.IP
-Default is\~0.
 .
 .TP
 .B Iso
-Set this variable to\~1 on the command line to get an ISO-formatted
-date string (\fB\-rIso=1\fP).
+configures the use of ISO\~8601 date format
+if specified
+(with any value)
+on the command line;
+see
+.BR ISODATE .
+.
+The default is determined by localization files.
 .
-Useless inside of a document.
 .
 .TP
 .B L
-Page length, only for command-line settings.
+defines the page length for the document,
+and must be set from the command line.
 .
-.TP
-.B Letwam
-Maximum lines in return-address, used in
-.BR .WA / .WE .
+A scaling unit should be appended.
+.
+The default is that of the selected
+.I groff
+output device.
 .
-Default is\~14.
 .
 .TP
-.BR Lf ,\  Lt ,\  Lx ,\  Le
-Enable (1) or disable (0) the printing of List of figures,
+.B Le
+.TQ
+.B Lf
+.TQ
+.B Lt
+.TQ
+.B Lx
+configure the report of lists of equation,
+figure,
+table,
+and exhibit captions,
+respectively,
+after a table of contents;
+see
+.B TC
+(Boolean-valued;
+.BR Le :\~ 0 ;
+.BR Lf ,
+.BR Lt ,
+.BR Lx :\~ 1 ).
+.
 .
-List of tables, List of exhibits and List of equations, respectively.
+.\" XXX: What is the rationale for this feature?
+.TP
+.B Letwam
+sets the maximum number of input lines permitted in a writer's address;
+see
+.B WA
+and
+.B WE
+.RB ( 14 ).
 .
-Default values are Lf=1, Lt=1, Lx=1, and Le=0.
 .
 .TP
 .B Li
-List indentation, used by
-.BR .AL .
+configures the amount of indentation in ens applied to list items;
+see
+.B LI
+.RB ( 6 ).
 .
-Default is\~6.
 .
 .TP
 .B Limsp
-A flag controlling the insertion of space between prefix and mark in
-automatic lists
-.RB ( .AL ).
+inserts a space between the prefix and the mark
+in automatically numbered lists;
+see
+.B AL
+(Boolean-valued;
+.BR 1 ).
 .
-.RS
-.IP
-.TS
-tab(@);
-l l.
-0@no space
-1@emit space
-.TE
-.RE
 .
 .TP
 .B Ls
-List space threshold.
+sets a threshold for placement of vertical space before list items.
 .
-If current list level is greater than
-.B Ls
-no spacing occurs around lists.
+If the list nesting level is greater than this value,
+no such spacing occurs;
+see
+.B LI
+.RB ( 99 ).
 .
-Default is\~99.
 .
 .TP
 .B Lsp
-The vertical space used by an empty line.
+configures the base amount of vertical space used for separation
+in the document.
+.
+.I mm
+applies this spacing to many contexts,
+sometimes with multipliers;
+see
+.BR DS ,
+.BR FS ,
+.BR H ,
+.BR LI ,
+and
+.B P
+.RI ( troff
+devices:
+.BR 0.5v ;
+.I nroff
+devices:
+.BR 1v ).
 .
-The default is 0.5v in troff mode and 1v in nroff mode.
 .
 .TP
 .B N
-Page numbering style.
-.
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@normal header for all pages.
-1@T{
-header replaces footer on first page, header is empty.
-T}
-2@page header is removed on the first page.
-3@\oqsection-page\cq numbering style enabled.
-4@page header is removed on the first page.
-5@T{
-\oqsection-page\cq and \oqsection-figure\cq numbering style enabled.
-T}
-.TE
-.RE
+configures the header and footer placements used by
+.BR PH .
 .
-.IP
-Default is\~0.
+The default footer is empty.
 .
-See also the number registers
+If \lqsection-page\rq numbering is selected,
+the default header becomes empty
+and the default footer becomes
+.RI \lq x - y \rq,
+where
+.IR x \~is
+is the section number
+(the number of the current first-level heading)
+.RI and\~ y
+the page number within the section.
+.\" XXX: section-figure numbering needs more documentation.
+.
+The following values are recognized;
+for finer control,
+see
+.BR PH ,
+.BR PF ,
+.BR EH ,
+.BR EF ,
+.BR OH ,
+and
+.BR OF ,
+and registers
 .B Sectf
 and
 .BR Sectp .
 .
-.TP
-.B Np
-A flag to control whether paragraphs are numbered.
+Value 5 is a GNU extension
+.RB ( 0 ).
+.
 .
-.RS
 .IP
 .TS
 tab(@);
-l l.
-0@not numbered
-1@numbered in first-level headings.
+Lb Lb
+L Lx.
+Value@Effect
+0@Set header on all pages.
+1@Move header to footer on page 1.
+2@Omit header on page 1.
+3@Use \lqsection-page\rq numbering style on all pages.
+4@Omit header on all pages.
+5@T{
+Use \lqsection-page\rq and \lqsection-figure\rq \
+numbering style on all pages.
+T}
 .TE
-.RE
 .
-.IP
-Default is\~0.
+.
+.TP
+.B Np
+causes paragraphs after first-level headings (only) to be numbered
+in the format
+.IR s . p ,
+where
+.IR s \~is
+is the section number
+(the number of the current first-level heading)
+and
+.IR p \~is
+the paragraph number,
+starting at 1;
+see
+.B H
+and
+.B P
+(Boolean-valued;
+.BR 0 ).
+.
 .
 .TP
 .B O
-Page offset, only for command-line settings.
+defines the page offset of the document,
+and must be set from the command line.
+.
+A scaling unit should be appended.
+.
+The default
+.RB is\~ \&.75i
+on terminal devices.
+.
+On typesetters,
+it is
+.B \&.963i
+or set to
+.B 1i
+by the
+.I papersize.tmac
+package;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+.
+.TP
+.B Oc
+suppresses the appearance of page numbers in the table of contents;
+see
+.B TC
+(Boolean-valued;
+.BR 0 ).
+.
 .
+.\" XXX: This really should just be a string, shouldn't it?
 .TP
 .B Of
-Format of figure, table, exhibit, and equation titles.
+selects a separator format within equation,
+exhibit,
+figure,
+and table captions;
+see
+.BR EC ,
+.BR EX ,
+.BR FG ,
+and
+.BR TB .
+.
+The following values are recognized;
+the spaces shown are unpaddable
+.RB ( 0 ).
+.
 .
-.RS
 .IP
 .TS
 tab(@);
-l l.
-0@\dq. \dq
-1@\dq - \dq
+Lb Lb
+L Lx.
+Value@Effect
+0@\dq.  \dq
+1@\dq \em \dq
 .TE
-.RE
 .
-.IP
-Default is\~0.
 .
 .TP
 .B P
-Current page-number, normally the same as \oq%\cq unless
-\oqsection-page\cq numbering style is enabled.
+interpolates the current page number;
+it is the same as
+.RB register\~ %
+except when
+\lqsection-page\rq numbering is enabled.
+.
 .
 .TP
 .B Pi
-Paragraph indentation.
+configures the amount of indentation in ens applied to the first line of
+a paragraph;
+see
+.B P
+.RB ( 5 ).
 .
-Default is\~5.
 .
 .TP
 .B Pgps
-A flag to control whether header and footer point size should follow
-the current settings or just change when the header and footer are
-defined.
+causes the type size and vertical spacing set by
+.B S
+to apply to headers and footers,
+overriding the
+.B HP
+string.
 .
-.RS
-.IP
-.TS
-tab(@);
-l lx.
-0@T{
-Point size only changes to the current setting when
-.BR .PH ,
-.BR .PF ,
-.BR .OH ,
-.BR .EH ,
-.BR .OF ,
+If not set,
+.B S
+calls affect headers and footers only when followed by
+.BR PH ,
+.BR PF ,
+.BR OH ,
+.BR EH ,
+.BR OF ,
 or
-.B .OE
-is executed.
-T}
-1@T{
-Point size changes after every
-.BR .S .
-This is the default.
-T}
-.TE
-.RE
+.B OE
+calls
+(Boolean-valued;
+.BR 1 ).
+.
 .
 .TP
 .B Ps
-Paragraph spacing.
-Default is\~1.
+is multiplied by register
+.B Lsp
+to vertically separate paragraphs;
+see
+.B P
+.RB ( 1 ).
+.
 .
 .TP
 .B Pt
-Paragraph type.
+determines when a first-line indentation is applied to a paragraph;
+see
+.B P
+.RB ( 0 ).
+.
 .
-.RS
 .IP
 .TS
 tab(@);
-l lx.
-0@left-justified
-1@indented paragraphs
+Lb Lb
+L Lx.
+Value@Effect
+0@never
+1@always
 2@T{
-indented paragraphs except after
-.BR .H ,
-.BR .DE ,
+always,
+except immediately after
+.BR H ,
+.BR DE ,
 or
-.BR .LE .
+.B LE
 T}
 .TE
-.RE
 .
-.IP
-Default is\~0.
 .
 .TP
+.B Ref
+is used internally to control
+.MR mmroff 1 's
+two-pass approach to index and reference management;
+see
+.B INITI
+and
+.B RS
+(Boolean-valued;
+.BR 0 ).
+.
+.
+.\" XXX: Why is this not named `Rpej`?
+.TP
 .B Rpe
-Set default value for second argument of
-.BR .RP .
+configures the default page ejection policy for reference pages;
+see
+.B RP
+.RB ( 0 ).
+.
+.
+.IP
+.TS
+tab(@);
+Lb Lb
+L Lx.
+Value@Effect
+0@Break the page before and after the list of references.
+1@Suppress page break after the list.
+2@Suppress page break before the list.
+3@Suppress page breaks before and after the list.
+.TE
+.
+.
+.TP
+.B S
+defines the type size for the document,
+and must be set from the command line.
+.
+A scaling unit should be appended;
+.B p
+is typical
+.RB ( 10p ).
 .
-Default is\~0.
 .
 .TP
 .B Sectf
-A flag controlling \oqsection-figures\cq numbering style.
+selects the \lqsection-figure\rq numbering style.
 .
-A non-zero value enables this.
+Its default
+.RB is\~ 0
+unless
+.RB register\~ N
+is set
+.RB to\~ 5
+at the command line
+(Boolean-valued).
 .
-See also register\~\c
-.BR N .
 .
 .TP
 .B Sectp
-A flag controlling \cqsection-page\cq numbering style.
+selects the \lqsection-page\rq numbering style.
 .
-A non-zero value enables this.
+Its default
+.RB is\~ 0
+unless
+.RB register\~ N
+is set
+.RB to\~ 3
+.RB or\~ 5
+at the command line
+(Boolean-valued).
 .
-See also register\~\c
-.BR N .
 .
 .TP
 .B Si
-Display indentation.
+configures the amount of display indentation in ens;
+see
+.B DS
+.RB ( 5 ).
+.
+.
+.TP
+.B Tb
+is an auto-incrementing table counter;
+see
+.BR TB .
+.
+.
+.TP
+.B V
+defines the vertical spacing for the document,
+and must be set from the command line.
+.
+A scaling unit should be appended;
+.B p
+is typical.
+.
+The default vertical spacing is 120% of the type size.
 .
-Default is\~5.
 .
 .TP
 .B Verbin
-Indentation for
-.BR .VERBON .
+configures the amount of indentation for verbatim displays
+when indentation is selected;
+see
+.B \%VERBON
+.RB ( 5n ).
 .
-Default is 5n.
 .
 .TP
 .B W
-Line length, only for command-line settings.
+defines the \lqwidth\rq
+of the document
+(that is,
+the length of an output line with no indentation);
+it must be set from the command line.
+.
+A scaling unit should be appended.
+.
+The default
+.RB is\~ 6i
+or assigned by the
+.I papersize.tmac
+package;
+see
+.MR groff_tmac @MAN5EXT@ .
 .
-.TP
-.B .mgm
-Always\~1.
 .
 .
 .\" ====================================================================
-.SH INTERNALS
+.SH Internals
 .\" ====================================================================
 .
-The letter macros are using different submacros depending on the
-letter type.
-.
-The name of the submacro has the letter type as suffix.
+The
+.B LT
+letter macros call further macros depending on the letter type,
+with which they are suffixed.
 .
-It is therefore possible to define other letter types, either in the
-national macro-file, or as local additions.
+It is therefore possible to define additional letter types,
+either in the territory-specific macro file,
+or as local additions.
 .
-.B .LT
-sets the number variables
+.B LT
+sets the registers
 .B Pt
 and
 .B Pi
-to 0 and\~5, respectively.
+to 0 and\~5, \" XXX: ...but doesn't use Pi for indentation...
+respectively.
+.\" XXX: and why aren't both of these actions the responsibility of
+.\" let@init_type as described below?
+.
+The following macros must be defined to support a new letter type.
 .
-The following strings and macros must be defined for a new letter type.
 .
 .TP
 .BI let@init_ type
-This macro is called directly by
-.BR .LT .
+.B LT
+calls this macro to initialize any registers and other data needed by
+the letter type.
 .
-It is supposed to initialize variables and other stuff.
 .
 .TP
 .BI let@head_ type
-This macro prints the letter head,
-and is called instead of the normal page header.
+formats the letterhead;
+it is called instead of the usual page header macro.
+.
+Its definition should remove the alias
+.B let@header
+unless the letterhead is desired on subsequent pages.
 .
-It is supposed to remove the alias
-.BR let@header ,
-otherwise it is called for all pages.
 .
 .TP
-.BI let@sg_ "type name title n flag \fR\fParg1 \fR\fParg2 \fR.\|.\|.\fP"
-.B .SG
-is calling this macro only for letters;
-memorandums have its own processing.
+.BI let@sg_ type\~\c
+.IR "name title n is-final\~"  SG-arg\~ .\|.\|.
+.B SG
+calls this macro only for letters;
+.B MT
+memoranda have their own signature processing.
 .
 .I name
 and
 .I title
 are specified through
-.BR .WA / .WB .
+.BR WA / WE .
 .
 .IR n \~is
-the counter, 1-max, and
-.I flag
-is true for the last name.
+the index of the
+.IR n th
+writer,
+and
+.I is-final
+is true for the last writer to be listed.
+.
+Further
+.B SG
+arguments are appended to the signature line.
 .
-Any other argument to
-.B .SG
-is appended.
 .
 .TP
 .BI let@fc_ "type closing"
 This macro is called by
-.BR .FC ,
+.BR FC ,
 and has the formal closing as the argument.
 .
 .
-.LP
-.B .LO
-is implemented as a general option-macro.
+.P
+.B LO
+implements letter options.
 .
-It demands that a string named
+It requires that a string named
 .BI Let type
-is defined, where
+be defined,
+where
 .I type
 is the letter type.
 .
-.B .LO
-then assigns the argument to the string variable
-.BI let*lo- type\fR.\fP
+.B LO
+then assigns its second argument
+.RI ( value )
+to the string
+.BI let*lo\- type\c
+\&.
 .
 .
 .\" ====================================================================
@@ -3945,51 +5318,111 @@
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
 .I @MACRODIR@/@TMAC_M_PREFIX@m.tmac
+is the
+.I groff
+implementation of the memorandum macros.
+.
+.
+.TP
+.I @MACRODIR@/mm.tmac
+is wrapper to load
+.IR m.tmac .
+.
+.
+.TP
+.I @MACRODIR@/refer\-mm.tmac
+implements
+.MR @g@refer @MAN1EXT@
+support for
+.IR mm .
+.
+.
+.TP
+.I @TMAC_MDIR@/ms.cov
+implements an
+.IR ms -like
+cover sheet.
+.
+.
+.TP
+.I @TMAC_MDIR@/0.MT
+implements memorandum types 0\en3 and 6.
+.
+.
 .TP
-.IR @TMAC_MDIR@/ * .cov
+.I @TMAC_MDIR@/4.MT
+implements memorandum type 4.
+.
+.
 .TP
-.IR @TMAC_MDIR@/ * .MT
+.I @TMAC_MDIR@/5.MT
+implements memorandum type 5.
+.
+.
 .TP
 .I @TMAC_MDIR@/locale
+performs any (further) desired necessary localization;
+empty by default.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 The GNU version of the
 .I mm
 macro package was written by
-.MT jh@\:axis.se
+.MT jh@\:axis\:.se
 J\:orgen H\:agg
 .ME
 of Lund, Sweden.
 .
 .
-.na
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@tbl (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@)
-.br
-.BR groff_mmse (@MAN7EXT@)
+.UR https://tkurtbond\:.github\:.io/\:troff/\:mm\-all\:.pdf
+.I MM \- A Macro Package for Generating Documents
+.UE ,
+the DWB\~3.3
+.I mm
+manual,
+introduces the package but does not document GNU extensions.
+.
+.
+.P
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \lqinfo groff\rq.
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR @g@tbl @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+.MR @g@refer @MAN1EXT@ ,
+.MR groff_mmse @MAN7EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_mm_C
+.cp \n*groff_groff_mm_7_man_C
+.do rr *groff_groff_mm_7_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
-.\" coding: latin-1
 .\" End:
-.\" vim:set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/groff_mmse.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/groff_mmse.7.man Changed

@@ -1,18 +1,16 @@
-.TH GROFF_MMSE @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAMN
-groff_mmse \- svenska \(rqmemorandum\(rq makro f\(:or GNU roff
+.TH groff_mmse @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Namn
+groff_mmse \- svenska \(rqmemorandum\(rq makro f\(:or GNU
+.I roff
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_mmse_C \n.C
-.cp 0
-.
+.\" Skrivet av Jörgen Hägg, Lund, Sverige
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -29,37 +27,48 @@
 .\" included in translations approved by the Free Software Foundation
 .\" instead of in the original English.
 .
-.\"
-.\" Skrivet av Jörgen Hägg, Lund, Sverige
-.\"
 .
-.mso sv.tmac
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_mmse_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH SYNTAX
+.SH Syntax
 .\" ====================================================================
 .
 .SY "groff \-m@TMAC_M_PREFIX@mse"
-.RI  flaggor
-\&.\|.\|.\&
-.RI  filer
-\&.\|.\|.\&
+.RI  flaggor\~ .\|.\|.\&
+.RI  filer\~ .\|.\|.
+.
 .SY "groff \-m m@TMAC_M_PREFIX@mse"
-.RI  flaggor
-\&.\|.\|.\&
-.RI  filer
-\&.\|.\|.\&
+.RI  flaggor\~ .\|.\|.\&
+.RI  filer\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH BESKRIVNING
+.SH Beskrivning
 .\" ====================================================================
 .
-.B m@TMAC_M_PREFIX@mse
+.I m@TMAC_M_PREFIX@mse
 är en svensk variant av
-.BR m@TMAC_M_PREFIX@m .
+.IR m@TMAC_M_PREFIX@m .
 Alla texter är översatta.
 En A4 sida får text som är 13\~cm bred,
 3,5\~cm indragning samt är 28,5\~cm hög.
@@ -73,12 +82,12 @@
 som argument.
 Detta ger ett svenskt försättsblad.
 Se
-.BR groff_mm (@MAN7EXT@)
+.MR groff_mm @MAN7EXT@
 för övriga detaljer.
 .
 .
 .\" ====================================================================
-.SH BREV
+.SH Brev
 .\" ====================================================================
 .
 Tillgängliga brevtyper:
@@ -122,7 +131,8 @@
 .
 .TP
 .BI ".LO BET\ " beteckning
-Anger beteckning (ärendebeteckning i form av diarienummer eller liknande).
+Anger beteckning
+(ärendebeteckning i form av diarienummer eller liknande).
 .
 .TP
 .BI ".LO SIDOR\ " antal
@@ -137,14 +147,14 @@
 .
 .
 .\" ====================================================================
-.SH "SKRIVET AV"
+.SH "Skrivet av"
 .\" ====================================================================
 .
 Jörgen Hägg, Lund, Sweden <Jorgen.Hagg@axis.se>
 .
 .
 .\" ====================================================================
-.SH FILER
+.SH Filer
 .\" ====================================================================
 .
 .TP
@@ -153,26 +163,21 @@
 .IR @TMAC_MDIR@/se_ * .cov
 .
 .
-.na
 .\" ====================================================================
-.SH "SE OCKSÅ"
+.SH "Se också"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@tbl (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@)
-.br
-.BR groff_mm (@MAN7EXT@)
+.MR groff_mm @MAN7EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_mmse_C
+.cp \n*groff_groff_mmse_7_man_C
+.do rr *groff_groff_mmse_7_man_C
 .
 .
 .\" Local Variables:
 .\" coding: latin-1
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/m.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/m.tmac Changed

@@ -1,14 +1,14 @@
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2023 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -16,22 +16,34 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 
-Naming convention stolen from mgs.
+Naming convention adapted from groff ms.
 Local names	module*name
 Extern names	module@name
 Env.var		environ:name
 Index		array!index
 ..
-.if !\n(.g .ab These mm macros require groff.
-.do if d PH .nx
-.if \n(.C .ab The groff mm macros do not work in compatibility mode.
-.if (\n.warn == 65543) .warn
+.if !\n(.g \
+.  ab groff mm macros require groff extensions; aborting
+.
+.if \n(.C \
+.  ab groff mm macros do not work in compatibility mode; aborting
+.
+.ds @mm m.tmac\"
+.
+.if (\n.x\n.y < 123) \{\
+.  ds mm-msg \*@mm: groff mm macros require groff 1.23 or later,\"
+.  as mm-msg " but found groff \n.x.\n.y; aborting\"
+.  ab \*mm-msg
+.\}
+.
+.if d PH .nx
+.
 .mso devtag.tmac
 .\" ######## init #######
-.\"	Contents level 0:14, contents saved if heading level <= Cl
+.\"	create table of contents entry for headings of level <= Cl
 .nr Cl 2
 .\"	Eject page between LIST OF XXXX if Cp == 0
 .nr Cp 0
@@ -43,16 +55,16 @@
 .nr Df 5
 .\"	space before and after display if == 1 0:1
 .nr Ds 1
-.\"	Eject page
+.\"	eject page before headings of level <= Ej
 .nr Ej 0
 .\"	Equation label adjust 0=left, 1=right
 .nr Eq 0
 .\"	Bullet string (for .BL)
-.ie n .ds BU \(bu
-.el .ds BU \s-2\(bu\s0
+.ie n .ds BU \bu
+.el .ds BU \s-2\bu\s0
 .\"	Em dash string
 .ie n .ds EM " --
-.el .ds EM \(em
+.el .ds EM \em
 .\"	Footnote spacing
 .nr Fs 1
 .\"	H1-H7	heading counters
@@ -70,9 +82,9 @@
 .nr H12 0 1
 .nr H13 0 1
 .nr H14 0 1
-.\"	Heading break level 0:14
+.\"	break after headings of level <= Hb
 .nr Hb 2
-.\"	heading centering level, 0:14
+.\"	center headings of level <= Hc
 .nr Hc 0
 .\"	header format
 .ds HF 2 2 2 2 2 2 2 2 2 2 2 2 2 2
@@ -83,7 +95,7 @@
 .nr Hi 1
 .\"	header pointsize
 .ds HP 0 0 0 0 0 0 0 0 0 0 0 0 0 0
-.\"	heading space level 0:14
+.\"	put vertical space of \nHss after headings of level <= Hs
 .nr Hs 2
 .\"	heading numbering type
 .\"	0 -> multiple (1.1.1 ...)
@@ -104,10 +116,10 @@
 .nr Lx 1
 .ds Le LIST OF EQUATIONS
 .nr Le 0
-.\"	List indent, used by .AL
+.\"	List indentation in ens, used by .AL
 .nr Li 6
-.\"	List space, if listlevel > Ls then no spacing will occur around lists.
-.nr Ls 99
+.\"	put vertical space before list items of nesting level <= Ls
+.nr Ls 99 \" TODO: use \n.R; see Savannah #63587
 .\"	Numbering style 0:5
 .if !r N .nr N 0
 .\"	numbered paragraphs
@@ -121,7 +133,7 @@
 .nr Oc 0
 .\"	Page-number, normally same as %.
 .nr P 0
-.\"	paragraph indent
+.\"	paragraph indentation in ens
 .nr Pi 5
 .\"	paragraph spacing
 .nr Ps 1
@@ -134,14 +146,24 @@
 .ds Rp REFERENCES
 .\"	Reference page eject status
 .nr Rpe 0
-.\"	Display indent
+.\"	display indentation in ens
 .nr Si 5
 .\"
 .\" Current state of TOC, empty outside TC, inside
 .\" it will be set to co,fg,tb,ec,ex or ap.
 .ds Tcst
 .\"
-.ds Tm \(tm
+.ie t .ds Sm \v'-.4m'\s-3SM\s0\v'.4m'\"
+.el \{\
+.	ie c \u2120 .ds Sm \u2120\"
+.	el            .ds Sm (SM)\"
+.\}
+.
+.ie t .ds Tm \v'-.4m'\s-3TM\s0\v'.4m'\"
+.el \{\
+.	ie c \tm .ds Tm \tm\"
+.	el         .ds Tm (TM)\"
+.\}
 .\"
 .\"---------------------------------------------
 .\"	Internal global variables
@@ -166,27 +188,31 @@
 .	el .ds @sdf_font R
 .\}
 .\"
-.\"	Current pointsize and vertical space, always in points.
+.\"	Set the type size and vertical spacing.  If given on the command
+.\"	line, these have already been converted to basic units.
 .if !r S .nr S 10
-.ps \nS
-.vs \nS+2
+.ie (\nS >= 1000) .ps \nSz/1000u
+.el                 .ps \nS
+.nr *vs-default \n.ps*120/100
+.if !r V .nr V \n*vs-default
+.ie (\nV >= 1000) .vs \nVp/1000u
+.el                 .vs \nV
+.rm *vs-default
 .\"
 .nr @ps \n.ps
 .nr @vs \n.v
 .if \nD>1 .tm @ps=\n@ps, @vs=\n@vs
 .if \nD>3 .tm INIT: l:\n.l p:\n.p o:\n.o
 .\"
-.\"	Page length
+.\"	page length
 .if r L \{\
-.	ie n .pl \nLu
-.	el .pl \nLu
+.	pl \nLu
 .\}
 .nr @pl \n.p
 .\"
-.\"	page width
+.\"	line length
 .ie r W \{\
-.	ie n .ll \nWu
-.	el .ll \nWu
+.	ll \nWu
 .\}
 .el .ll 6i
 .nr @ll \n.l
@@ -221,16 +247,14 @@
 .\" Add a dot after level one heading number if >0
 .nr H1dot 1
 .\"
-.\" header prespace level. If level <= Hps, then two lines will be printed
-.\" before the header instead of one.
+.\" put vertical space of \nHps2 before headings of level <= Hps
 .nr Hps 1
 .\"
-.\" These variables controls the number of lines preceding .H.
-.\" Hps1 is the number of lines when level > Hps
+.\" amount of vertical space before headings when level > Hps
 .nr Hps1 0.5v
 .if n .nr Hps1 1v
 .\"
-.\" Hps2 is the number of lines when level <= Hps
+.\" amount of vertical space before headings when level <= Hps
 .nr Hps2 1v
 .if n .nr Hps2 2v
 .\"
@@ -293,7 +317,7 @@
 .if \nN=5 .nr Sectf 1
 .\"
 .\" argument to .nm in .VERBON.
-.ds Verbnm "1
+.ds Verbnm 1\"
 .\" indent for VERBON
 .nr Verbin 5n
 .\"
@@ -358,12 +382,12 @@
 .\"
 .\"---------------------------------------------
 .\" set local variables.
-.ie d @country .mso mm/\*@country_locale
-.el .mso mm/locale
+.ie d @country .msoquiet mm/\*@country_locale
+.el .msoquiet mm/locale
 .\"---------------------------------------------
-.if \nD .tm Groff mm, version \*RE.
 .\" ####### module init ######
 .\"	reset all things
+.\" XXX: Resets .cu and .ul but _not_ .ce or .rj.
 .de init@reset
 .ie \\nmisc@adjust 'ad
 .el 'na
@@ -375,15 +399,20 @@
 .vs \\n@vsu
 ..
 .de @warning
-'tm WARNING:(\\n.F) input line \\n.c:\\$*
+.tm \\*@mm:\\n.F:\\n.c: warning: \\$*
 .if \\nD .backtrace
 ..
+.\" All errors are fatal.
 .de @error
-'tm ******************
-'tm ERROR:(\\n.F) input line \\n.c:\\$*
+.tm \\*@mm:\\n.F:\\n.c: error: \\$*
 .if \\nD .backtrace
-'tm ******************
-.ab "Input aborted, syntax error"
+.ab
+..
+.
+.de @abort
+.tm \\*@mm:\\n.F:\\n.c: internal error: \\$*
+.backtrace
+.ab
 ..
 .de misc@toupper
 .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
@@ -406,7 +435,8 @@
  .p=\\n.p .t=\\n.t .z=\\n.z nl=\\nnl dn=\\ndn n=\\ndebug*n
 ..
 .\" ####### module par #################################
-.nr par@ind-flag 1	\" indent on following P if Pt=2
+.nr par*indentation-eligible 1		\" indent following P if Pt=2
+.nr par@suppress-indentation 0
 .nr hd*last-pos -1
 .nr hd*last-hsize -1
 .nr par*number 0 1
@@ -423,44 +453,50 @@
 .\"------------
 .\" paragraph
 .de P
+.if \\n.$ \{\
+.	ie !\B'\\$1' \{\
+.		@warning \\$0: expected numeric argument, got '\\$1'
+.		shift
+.	\}
+.	el .if (\\$1 > 1) \
+.		@warning \\$0: ignoring unsupported paragraph type \
+'\\$1'
+.\}
 .\"	skip P if previous heading
 .if \\nD>2 \{\
 .	tm Paragraph nl=\\nnl, last=\\nhd*last-pos
 .	tm Paragraph .k=\\n.k, hsize=\\nhd*last-hsize
 .\}
-.if !((\\nnl=\\nhd*last-pos)&(\\nhd*last-hsize=\\n.k)) \{\
-.	if \\nD>2 .tm Paragraph set ind-flag=1
-.	nr par@ind-flag 1
-.	\" any collected unprinted text?
-.	par@doit \\$*
-.\}
+.nr par*indentation-eligible 1-\\npar@suppress-indentation
+.par@doit \\$*
 .if \\nNp \\nH1.\\n+par*number\ \ \c
 ..
 .\"------------
 .de nP
-.\"	skip P if previous heading
 .if \\nD>2 \{\
 .	tm Paragraph nl=\\nnl, last=\\nhd*last-pos
 .	tm Paragraph .k=\\n.k, hsize=\\nhd*last-hsize
 .\}
-.if !((\\nnl=\\nhd*last-pos)&(\\nhd*last-hsize=\\n.k)) \{\
-.	if \\nD>2 .tm Paragraph set ind-flag=1
-.	nr par@ind-flag 1
-.\}
-.par@doit \\$*
+.\" A first-line indentation is meaningless for a numbered paragraph.
+.nr par*indentation-eligible 0
+.par@doit
 \\nH2.\\n+par*number2\ \ \c
-.nr par@ind-flag 1
 ..
 .\"------------
 .de par@doit
 .SP (u;\\nPs*\\nLsp)
-.ie  \\n.$ \{\
-.	if \\$1=1 .ti +\\nPin
+.nr par*do-indent 0
+.ie \\n.$ \{\
+.	if \\$1=1 .nr par*do-indent 1
 .\}
 .el \{\
-.	if \\nPt=1 .ti +\\nPin
-.	if (\\nPt=2)&\\npar@ind-flag .ti +\\nPin
+.	if \\nPt=1 .nr par*do-indent 1
+.	if (\\nPt=2)&\\npar*indentation-eligible \
+.		nr par*do-indent 1
 .\}
+.if \\npar*do-indent .ti +\\nPin
+.rr par*do-indent
+.nr par@suppress-indentation 0
 ..
 .\" ####### module line #######################################
 .de SP
@@ -486,12 +522,22 @@
 .nr line*lp\\n.z \\n.d
 ..
 .\" ######## module misc ###############
+.\" XXX: This register value is meaningless.
+.\"   .ad b
+.\"   .nr misc@adjust \n.j
+.\" might be better...
 .nr misc@adjust 14
 .de SA
 .if \\n.$ \{\
-.	if \\$1-1 .@error "SA: bad arg: \\$1"
+.	if ((\\$1 < 0) : (\\$1 > 1)) .@error \\$0: invalid argument \
+'\\$1'
+.\" XXX: ...then...
+.\"   .ad l
+.\"   .nr misc@adjust \\n.j
 .	nr misc@adjust 0\\$1
 .\}
+.\" XXX: ...and finally an unconditional.
+.\"   .ad \\n.j
 .ie \\nmisc@adjust 'ad
 .el 'na
 ..
@@ -499,9 +545,11 @@
 .\" switch environment, keep all important settings.
 .de misc@ev-keep
 .nr misc*ll \\n.l
+.ds misc*fam \\n.fam
 .ev \\$1
 .ll \\nmisc*llu
 .lt \\nmisc*llu
+.fam \\*misc*fam
 ..
 .\"-------------
 .\" .misc@push stackname value
@@ -519,7 +567,7 @@
 .de misc@pop-set
 .ds misc*st-name \\$1
 .shift
-.if \\n.$<1 .@error "stack \\*misc*st-name empty"
+.if \\n.$<1 .@abort stack '\\*misc*st-name' empty
 .ds misc*pop \\$1
 .shift
 .ds \\*misc*st-name \\$*
@@ -585,7 +633,10 @@
 .\" .MOVE y x linelength
 .\" move to line y, indent to x
 .de MOVE
-.if !\\n.$ .@error "MOVE y x: no arguments"
+.if !\\n.$ \{\
+.	@warning \\$0: ignoring; no arguments specified
+.	return
+.\}
 .if \\nnl<0 \c
 .\" move to Y-pos
 .sp |(v;\\$1)
@@ -602,7 +653,10 @@
 ..
 .\"-------------
 .de SM
-.if !\\n.$ .@error "SM: no arguments"
+.if !\\n.$ \{\
+.	@warning \\$0: ignoring; no arguments specified
+.	return
+.\}
 .if \\n.$=1 \s-1\\$1\s0
 .if \\n.$=2 \s-1\\$1\s0\\$2
 .if \\n.$=3 \\$1\s-1\\$2\s0\\$3
@@ -693,14 +747,14 @@
 .rm misc*rd misc*rd2
 ..
 .\"------------
-.\" VERBON flag pointsize font
+.\" VERBON flag type-size font
 .\"	flag
 .\"	bit	function
-.\"	0	escape on
+.\"	0	escape character disablement
 .\"	1	add an empty line before verbose text
 .\"	2	add an empty line after verbose text
-.\"	3	numbered lines (controlled by the string Verbnm)
-.\"	4	indent text by the numbervariable Verbin.
+.\"	3	number output lines using Verbnm string for .nm args
+.\"	4	indent text by amount in register Verbin
 .de VERBON
 .br
 .nr misc*verb 0\\$1
@@ -801,10 +855,14 @@
 .	nr pict*id +1
 .	shift
 .	if \\n.$>0 \{\
+.		if !\B'\\$1' .@error \\$0: width parameter is not \
+numeric; got '\\$1'
 .		nr pict*width (i;\\$1)
 .		shift
 .	\}
 .	if \\n.$>0 \{\
+.		if !\B'\\$1' .@error \\$0: height parameter is not \
+numeric; got '\\$1'
 .		nr pict*height (i;\\$1)
 .		shift
 .	\}
@@ -878,19 +936,26 @@
 .\}
 ..
 .\" external picture
-.\" -L	left adjust
+.\" -L	left align
 .de EPIC
-.if \\n.$<2 .@error "EPIC: Not enough arguments"
 .nr pict*adj 0		\" centered
 .if '\\$1'-L' \{\
-.	shift 1		\" left adjust
+.	shift
 .	nr pict*adj 1
 .\}
+.if \\n.$<2 \{\
+.	@warning \\$0: ignoring; expected width and height arguments
+.	return
+.\}
+.\" Permit a document to start with EPIC.
 .if \\nnl<0 \&
-.nr pict*w \\$1
-.nr pict*h \\$2
-.ds pict*name "External picture
-.if !''$3' .ds pict*name \\$3
+.ie \B'\\$1' .nr pict*w \\$1
+.el          .@error \\$0: width parameter is not numeric; got '\\$1'
+.ie \B'\\$2' .nr pict*h \\$2
+.el          .@error \\$0: height parameter is not numeric; got '\\$2'
+.\" XXX: This is kind of lame.  It's also not localized.
+.ds pict*name External picture\"
+.if !''\\$3' .ds pict*name " \\$3\"
 .ne \\npict*hu
 .sp \\npict*hu-1v
 .nr pict*ind 0
@@ -921,16 +986,31 @@
 .acc@over-def ' \'
 .acc@over-def ^ ^
 .acc@over-def ~ ~
-.acc@over-def : \(ad
-.acc@over-def ; \(ad
-.acc@under-def , \(ac
+.acc@over-def : \ad
+.acc@over-def ; \ad
+.acc@under-def , \ac
 .\" ######## module uni #################
 .\" unimplemented macros
+.de @disable
+.ds @end \" empty
+.while \\n.$ \{\
+.	rm \\$1 \" in case it's aliased
+.	de \\$1 @end
+.		@warning \\$1: ignoring; unavailable after \\*@cover
+.	@end
+.	shift
+.\}
+..
+.rm @end
+.
+.de CS
+.@warning \\$0: not implemented except with ".MT 4"
+..
 .de OK
-'tm "OK: not implemented"
+.@warning \\$0: not implemented
 ..
 .de PM
-'tm "PM: not implemented"
+.@warning \\$0: not implemented
 ..
 .\" ######## module hd #################
 .\" support for usermacro
@@ -947,7 +1027,10 @@
 .\"-------------
 .\" .hd@split variable index name val1 val2 ...
 .de hd@split
-.if \\$2>(\\n.$-3) .@error "\\$3 must have at least \\$2 values (\\*\\$3).
+.\" TODO: Verify that this isn't reachable due to ordinary user error;
+.\" if it is, make it an @error.
+.if \\$2>(\\n.$-3) .@abort \\$3 must have at least \\$2 values \
+(\\*\\$3)
 .nr hd*sp-tmp \\$2+3
 .ds \\$1 \\$\\nhd*sp-tmp
 ..
@@ -984,9 +1067,8 @@
 .el .nr H1h \\nH1 1
 .if \\nhd*level=1 .nr H1h +1
 .\"
-.\"	Check if it's time for new page. Only if text has
-.\"	appeared before.
-.if \\nEj&(\\nEj>=\\nhd*level)&(\\nnl>\\nhd*cur-bline) .pg@next-page
+.\" Break page before headings of level <= Ej.
+.if ((\\nhd*level<=\\nEj)&(\\nnl>\\nhd*cur-bline)) .pg@next-page
 .\"
 .\" increment current counter
 .nr H\\nhd*level +1
@@ -1000,24 +1082,25 @@
 .if \\nhd*level>1 .as hd*mark \\nH2
 .\"
 .nr hd*i 2 1
-.while \\n+hd*i<15 .if \\nhd*level>(\\nhd*i-1) .as hd*mark .\\nH\\nhd*i
+.while \\n+hd*i<15 .if \\nhd*level>(\\nhd*i-1) \
+.	as hd*mark .\\nH\\nhd*i
 .if \\nHt .ds hd*mark \\nH\\nhd*level.
 .\"
 .\" special case, no dot after level one heading if not H1dot true
 .if (\\nhd*level=1)&(\\nH1dot=0) .ds hd*mark \\nH1
 .\"
-.ds hd-mark-trimmed \\*hd*mark\" save hd-mark w/o spaces for references
-.as hd*mark \ \ \"			add spaces between mark and heading
-.if !\\nhd*arg1 .ds hd*mark\"		no mark for unnumbered
+.ds hd@mark-trimmed \\*hd*mark\" mark without spaces, for references
+.as hd*mark \ \ \"	add spaces between heading mark and title
+.if !\\nhd*arg1 .ds hd*mark \" empty; no mark for unnumbered heading
 .\"
 .if \\nD>1 .tm At header \\*hd*mark "\\$2"
-.nr hd*htype 0				\" hd*htype = check break and space
-.					\" 0 = run-in, 1 = break only, 2 = space
+.nr hd*htype 0			\" hd*htype = check break and space
+.				\" 0 = run-in, 1 = break only, 2 = space
 .if \\nhd*level<=\\nHb .nr hd*htype 1
 .if \\nhd*level<=\\nHs .nr hd*htype 2
 .					\" two spaces if hd*htype == 0
 .ie (\\nhd*htype=0)&(\w@\\$2@) .ds hd*suf-space "  \"
-.el .ds hd*suf-space
+.el .ds hd*suf-space \" empty
 .nr hd*need 2v				\" hd*need = header need space
 .\"---------- user macro HX ------------
 .\" User exit macro to override numbering.
@@ -1036,9 +1119,9 @@
 .br
 .di
 .rm hd*div
-.if \\nhd*htype .na \"		no adjust if run-in
+.if \\nhd*htype .na \"	do not adjust heading if not run-in
 .if \\nhd*htype<2 .nr hd*need +\\nLspu \"	add some extra space
-.ne \\nhd*needu+\\ndnu+.5p-1v \"	this is the needed space for a header
+.ne \\nhd*needu+\\ndnu+.5p-1v \"	space needed for a heading
 .\"
 .\" size and font calculations
 .hd@split hd*font \\nhd*level HF \\*HF\"	get font for this level
@@ -1090,13 +1173,15 @@
 .\"	do break or space
 .if \\nhd*htype .br
 .if \\nhd*htype>1 .SP (u;\\nLsp*\\nHss)
-.if \\nhd*htype \{\
+.ie \\nhd*htype \{\
 .	\"	indent if Hi=1 and Pt=1
 .	if (\\nHi=1)&(\\nPt=1) .ti +\\nPin
 .	\"	indent size of mark if Hi=2
 .	if \\nhd*htype&(\\nHi>1) .ti +\\nhd*mark-sizeu
+.	nr par@suppress-indentation 1
 .\}
-.nr par@ind-flag 0			\" no indent on .P if Pt=2
+.\" We're setting a run-in heading; the next paragraph is normal.
+.el .nr par@suppress-indentation 0
 .\"
 .\"	check if it is time to reset footnotes
 .if (\\nhd*level=1)&\\nft*clear-at-header .nr ft*nr 0 1
@@ -1112,7 +1197,6 @@
 .if d HZ .HZ \\nhd*level \\nhd*arg1 "\\$2\\$3"
 .nr hd*last-pos \\nnl
 .nr hd*last-hsize \\n.k
-.nr par@ind-flag 0
 .\" HTML: end of heading
 .misc@tag EO-H
 ..
@@ -1137,7 +1221,7 @@
 .wh 0 pg@header
 .em pg@end-of-text
 .\"
-.ds pg*header ''- \\nP -''
+.ds pg*header ''- \\nP -''
 .ds pg*footer
 .if \nN=4 .ds pg*header ''''
 .if (\nN=3):(\nN=5) \{\
@@ -1237,6 +1321,13 @@
 .\" Disable in HTML mode
 .if !'\*.T'html' \{\
 .if \\nD>1 .tm Page# \\n% (\\n.F:\\nc.)
+.	if (u;(\\npg*header-size + \\npg*extra-header-size \
+       + \\npg*footer-size + \\npg*extra-footer-size \
+       + \\n.V) >= \\n.p) \{\
+.		pl \\nnlu
+.		@error insufficient page length; aborting
+.	\}
+.\}
 .\" check if Hy has been changed
 .ie \\nHy 'hy 14
 .el 'nh
@@ -1510,8 +1601,11 @@
 ..
 .\" An argument disables the page-break.
 .de 1C
+.if \\npg*cols-per-page<=1 \{\
+.	@warning \\$0: multicolumn mode not active
+.	return
+.\}
 .br
-.if \\npg*cols-per-page<=1 .@error "1C: multicolumn mode not active"
 .nr pg*cols-per-page 1
 .nr pg*column-sep 0
 .nr pg*column-size \\n@ll
@@ -1523,7 +1617,9 @@
 .el \{\
 .	if d ft*div \{\
 .		if \\npg*ncol-i>0 \{\
-.			@warning 1C: footnotes will be messy
+.			@warning \\$0: returning to single-column \
+layout with suppressed page break and footnote pending; output may be \
+messy
 .		\}
 .	\}
 .	if \\npg*last-ncol>0 \{\
@@ -1533,9 +1629,10 @@
 .\}
 ..
 .de 2C
+.if \\npg*cols-per-page>1 .@error \\$0: multicolumn mode already \
+active
 .br
 .nr pg*head-mark \\nnlu
-.if \\npg*cols-per-page>1 .@error "2C: multicolumn mode already active"
 .nr pg*cols-per-page 2
 .nr pg*column-sep \\n@ll/15
 .nr pg*column-size (\\n@llu*7)/15
@@ -1546,21 +1643,24 @@
 ..
 .\" MC column-size  column-separation 
 .de MC
+.if \\npg*cols-per-page>1 .@error \\$0: multicolumn mode already \
+active
 .br
 .nr pg*head-mark \\nnlu
-.if \\npg*cols-per-page>1 .@error "MC: multicolumn mode already active"
 .ie ''\\$1' .nr pg*column-size \\n.l
 .el .nr pg*column-size (n;\\$1)
 .ie ''\\$2' .nr pg*column-sep \\npg*column-size/15
 .el .nr pg*column-sep (n;\\$2)
 .\"
 .\" calculate the number of columns/page
-.nr pg*cols-per-page 0
+.nr pg*cols-per-page 0 \" temporarily invalid!
 .nr pg*i \\npg*column-size
 .while \\npg*i<=\\n.l \{\
-.	nr pg*cols-per-page \\npg*cols-per-page+1
+.	nr pg*cols-per-page +1
 .	nr pg*i \\npg*i+\\npg*column-sep+\\npg*column-size
 .\}
+.if \\npg*cols-per-page<0 .@abort \\npg*cols-per-page columns in \
+page
 .nr pg*cur-column 0 1
 .nr pg*cur-po \\n@pou
 .ll \\npg*column-sizeu
@@ -1611,7 +1711,8 @@
 ..
 .\"-----------
 .de MULN
-.if \\npg*mul-x>=\\npg*mul-max-col .@error "MULN: Undefined columnwidth"
+.if \\npg*mul-x>=\\npg*mul-max-col .@abort undefined column width \
+(pg*mul-x=\\npg*mul-x >= pg*mul-max-col=\\npg*mul-max)
 .br
 .if \\n.d>\\npg*mul-last .nr pg*mul-last \\n.d
 .rt +0
@@ -1647,6 +1748,7 @@
 .nr ft*note-size 0
 .nr ft*busy 0
 .nr ft*nr 0 1
+.aln :p ft*nr
 .nr ft*wide 0
 .nr ft*hyphen 0\"	hyphenation value
 .nr ft*adjust 1\"	>0 if adjust true
@@ -1655,7 +1757,8 @@
 .nr ft*exist 0\"	not zero if there are any footnotes to be printed
 .nr ft*clear-at-header 0\" >0 if footnotes should be reset at first level head.
 .\"
-.ds F \v'-.4m'\s-3\\n+ft*nr\s0\v'.4m'
+.ie t .ds F \v'-.4m'\s-3\\n+ft*nr\s0\v'.4m'
+.el   .ds F \\n+ft*nr
 .\"
 .\"-----------------
 .\" init footnote environment
@@ -1677,7 +1780,7 @@
 .\" set footnote format
 .\" no support for two column processing (yet). $$$
 .de FD
-.if \\n.$=0 .@error "FD: bad arg \\$1"
+.if \\n.$=0 .@error \\$0: expected 1 or 2 arguments, got \\n.$
 .ie \\n.$=2 .nr ft*clear-at-header 1
 .el .nr ft*clear-at-header 0
 .\"
@@ -1734,7 +1837,7 @@
 .\" begin footnote
 .\" Change environment, switch to diversion and print the foot-note mark.
 .de FS
-.if \\nft*busy .@error "FS: missing FE"
+.if \\nft*busy .@error \\$0: cannot nest; missing FE?
 .nr ft*busy 1
 .ev ft*ev
 .ft@init
@@ -1769,7 +1872,7 @@
 .di
 'in 0
 'nf
-.if \\n@plu<\\ndnu .@error "FE: too big footnote"
+.if \\n@plu<\\ndnu .@error \\$0: footnote bigger than page area
 .if !d ft*div .nr dn +1v
 .if \\nD>3 .tm FE: foot-trap=\\npg*foot-trap .d=\\n.d dn=\\ndn
 .ie (\\npg*foot-trapu-\\n.du)<\\ndnu \{\
@@ -1839,7 +1942,9 @@
 .\" floating display start
 .\" nested DF/DE is not allowed.
 .de DF
-.if \\ndf*float .@error "DF:nested floating is not allowed. Use DS."
+.if \\ndf*float .@error \\$0: cannot nest floating keeps; use DS \
+within DF/DE
+.ds ds@macro \\$0
 .ds@set-format \\$@
 .\"
 .nr df*old-ll \\n.l
@@ -1870,7 +1975,7 @@
 .\"	move div to the floating display list
 .rn df*div df*fdiv!\\ndf*fnr
 .\"
-.nr par@ind-flag 0
+.nr par@suppress-indentation 1	\" no indentation after displays
 .\" print float if queue is empty and the display fits into
 .\" the current page
 .if ((\\ndf*fnr>=\\ndf*o-fnr)&(\\ndn<\\n.t)) .df@print-float 1
@@ -1900,11 +2005,16 @@
 .\"	4	beginning of new page
 .\"
 .de df@print-float
-.if \\nDf>5 .@error "Df=\\nDf, max value is 5"
+.if \\nDf>5 .@abort invalid float type: 5 < Df (\\nDf)
 .if !\\nds*float-busy \{\
 .	nr ds*float-busy 1
 .\" at .DE
-.	if \\nD>3 .tm print-float: .t=\\n.t, h=\\ndf*height!\\ndf*o-fnr
+.	if \\nD>3 \{\
+.		tmc print-float: .t=\\n.t
+.		if r df*height!\\ndf*o-fnr \
+.			tmc , h=\\ndf*height!\\ndf*o-fnr
+.		tm
+.	\}
 .	\" Df = 1 or 5
 .	if (\\$1=1)&((\\nDf=1):(\\nDf=5)) \{\
 .		if \\n.t>\\ndf*height!\\ndf*o-fnr \{\
@@ -2012,7 +2122,7 @@
 .de ds@set-format
 .ie \\n.$ \{\
 .	ie r ds*format!\\$1 .nr ds*format \\nds*format!\\$1
-.	el .@error "DS/DF:wrong format:\\$1"
+.	el .@error \\*ds@macro: unrecognized format '\\$1'
 .\}
 .el .nr ds*format 0
 .if \\nD>2 .tm set format=\\nds*format
@@ -2020,7 +2130,7 @@
 .nr ds*fill 0
 .if \\n.$>1 \{\
 .	ie r ds*fill!\\$2 .nr ds*fill \\nds*fill!\\$2
-.	el .@error "\\*ds*type:wrong fill:\\$2"
+.	el .@error \\*ds@macro: unrecognized fill style '\\$2'
 .\}
 .if \\nD>2 .tm set fill=\\nds*fill
 .nr ds*rindent 0
@@ -2069,8 +2179,8 @@
 .\" static display start
 .\" nested DS/DE is allowed. No limit on depth.
 .de DS
+.ds ds@macro \\$0
 .br
-.nr XXX \\nnl
 .nr ds*lvl +1
 .ds@set-format \\$@
 .\"
@@ -2090,13 +2200,16 @@
 .di ds*div!\\nds*snr
 .\"
 .nr ds*div-ll \\nds*old-ll
-.if \\nds*format=1 .nr ds*div-ll -\\n(Sin
+.if \\nds*format=1 .nr ds*div-ll -\\nSin
 .ds@set-new-ev \\nds*div-ll
 .nr df*float 0
 ..
 .\"--------------------------------------------
 .de ds@end
-.if \\n-ds*lvl<0 .@error "DE: no corresponding DS"
+.\" We hard-code the DE macro name here since this macro is internal but
+.\" only DE calls it.  We also know we're closing a static keep because
+.\" df@end is called otherwise.  See `DE`.
+.if \\n-ds*lvl<0 .@error DE: no corresponding DS
 .br
 .di
 .\" **********
@@ -2140,7 +2253,7 @@
 .if \\nds*format=4 'rj 0
 .rm ds*div!\\nds*snr
 .nr ds*snr -1
-.nr par@ind-flag 0
+.nr par@suppress-indentation 1	\" no indentation after displays
 .ev
 ..
 .\"########### module list ###################
@@ -2159,7 +2272,7 @@
 .\"	the major list-begin macro.
 .\"	If type == -1 a 'break' will occur.
 .de LB
-.if \\n.$<4 .@error "LB: not enough arguments, min 4"
+.if \\n.$<4 .@error \\$0: expected at least 4 arguments, got \\n.$
 .misc@push cind \\n.i
 .misc@push tind \\nli*tind
 .misc@push mind \\nli*mind
@@ -2189,8 +2302,10 @@
 ..
 .\"---------------
 .de LI
-.if \\nli*lvl<1 .@error "LI:no lists active"
-.if \\nli*li-spc&(\\nLs>=\\nli*lvl) .SP (u;\\nli*li-spc*\\nLsp)
+.if \\nli*lvl<1 .@error \\$0: no list active; call AL, BL, BVL, ... \
+first
+.if \\nli*li-spc&(\\nli*lvl<=\\nLs) \
+.	SP (u;\\nli*li-spc*\\nLsp)
 .ne 2v
 .\"
 .ds li*c-mark \\*li*mark
@@ -2235,23 +2350,29 @@
 .ds li*mark \\*li*mark-list!\\nli*lvl
 ..
 .de LE
-.if \\nli*lvl<1 .@error "LE:mismatched"
+.if \\nli*lvl<1 .@error \\$0: no list active; call AL, BL, BVL, ... \
+and LI first
 .li@pop
 .if '\\$1'1' .SP \\nLspu
+.nr par@suppress-indentation 1	\" no indentation after lists
 ..
 .\"-------------
 .\"	list status clear.
 .\"	terminate all lists to level i
 .de LC
-.ie \\n.$<1 .nr li*i 0
-.el .nr li*i \\$1
-.if \\nli*i>\\nli*lvl .@error "LC: incorrect argument: \\nli*i (too big)"
+.nr li*i 0
+.if \\n.$ \{\
+.	ie \B'\\$1' .nr li*i \\$1
+.	el          .@error \\$0: argument not numeric: '\\nli*i'
+.\}
+.if \\nli*i>\\nli*lvl .@error \\$0 invalid argument: \\nli*i \
+exceeds depth of nested lists (\\nli*lvl)
 .while \\nli*lvl>\\nli*i .li@pop
-.nr par@ind-flag 0
+.nr par@suppress-indentation 1	\" no indentation after lists
 ..
 .\"-------------
 .de AL
-.if \\n.$>3 .@error "AL: too many arguments"
+.if \\n.$>3 .@warning \\$0: ignoring excess arguments
 .if \\nD>2 .tm AL $*
 .ie \\n.$<=1 .LB \\nLi 0 2 1 "\\$1"
 .el \{\
@@ -2263,7 +2384,7 @@
 .\}
 ..
 .de ML
-.if \\n.$>3 .@error "ML: too many arguments"
+.if \\n.$>3 .@warning \\$0: ignoring excess arguments
 .if \\nD>2 .tm ML $*
 .nr li*ml-width \w@\\$1@u+1n
 .if \\n.$<2 .LB \\nli*ml-widthu 0 1 0 "\\$1"
@@ -2275,14 +2396,14 @@
 ..
 .de VL
 .if \\nD>2 .tm VL $*
-.if \\n.$>3 .@error "VL: too many arguments"
-.if \\n.$<1 .@error "VL: missing text-indent"
+.if \\n.$>3 .@warning \\$0: ignoring excess arguments
+.if \\n.$<1 .@error \\$0: expected 1 to 3 arguments, got \\n.$
 .ie \\n.$<3 .LB 0\\$1 0\\$2 0 0
 .el .LB 0\\$1 0\\$2 0 0 \& 0 1
 ..
 .de BL
 .if \\nD>2 .tm BL $*
-.if \\n.$>2 .@error "BL: too many arguments"
+.if \\n.$>2 .@warning \\$0: ignoring excess arguments
 .if \\n.$<1 .LB \\nPi 0 1 0 \\*BU
 .if \\n.$=1 .LB 0\\$1 0 1 0 \\*BU
 .if \\n.$=2 \{\
@@ -2292,17 +2413,17 @@
 ..
 .de DL
 .if \\nD>2 .tm DL $*
-.if \\n.$>2 .@error "DL: too many arguments"
-.if \\n.$<1 .LB \\nPi 0 1 0 \(em
-.if \\n.$=1 .LB 0\\$1 0 1 0 \(em
+.if \\n.$>2 .@warning \\$0: ignoring excess arguments
+.if \\n.$<1 .LB \\nPi 0 1 0 \em
+.if \\n.$=1 .LB 0\\$1 0 1 0 \em
 .if \\n.$=2 \{\
-.	ie '\\$1'' .LB \\nPi 0 1 0 \(em 0 1
-.	el .LB 0\\$1 0 1 0 \(em 0 1
+.	ie '\\$1'' .LB \\nPi 0 1 0 \em 0 1
+.	el .LB 0\\$1 0 1 0 \em 0 1
 .\}
 ..
 .de RL
 .if \\nD>2 .tm RL $*
-.if \\n.$>2 .@error "RL: too many arguments"
+.if \\n.$>2 .@warning \\$0: ignoring excess arguments
 .if \\n.$<1 .LB 6 0 2 4
 .if \\n.$=1 .LB 0\\$1 0 2 4
 .if \\n.$=2 \{\
@@ -2313,13 +2434,13 @@
 .\" Broken Variable List. As .VL but text begin on the next line
 .de BVL
 .if \\nD>2 .tm BVL $*
-.if \\n.$>3 .@error "BVL: too many arguments"
-.if \\n.$<1 .@error "BVL: missing text-indent"
+.if \\n.$>3 .@warning \\$0: ignoring excess arguments
+.if \\n.$<1 .@error \\$0: expected 1 to 3 arguments, got \\n.$
 .ie \\n.$<3 .LB 0\\$1 0\\$2 0 -1
 .el .LB 0\\$1 0\\$2 0 -1 \& 0 1
 ..
 .\" ####### module tbl #######################################
-.\" This module is copied from groff_ms and modified for mgm.
+.\" This module is copied from groff_ms and modified for mm.
 .\" Yes, it does not resemble the original anymore :-).
 .\" Don't know if I missed something important.
 .\" Groff_ms is written by James Clark.
@@ -2364,10 +2485,10 @@
 .	ie '\\$1'N' .if !\\ntbl*header-written .tbl@print-header
 .	el .tbl@print-header
 .\}
-.el .@error ".TH without .TS H"
+.el .@error \\$0: .TH without .TS H"
 ..
 .de TE
-.ie '\\n(.z'tbl*header-div' .@error ".TS H but no .TH before .TE"
+.ie '\\n.z'tbl*header-div' .@error \\$0: .TS H but no .TH before .TE
 .el \{\
 .	nr tbl*have-header 0
 .\}
@@ -2378,23 +2499,20 @@
 ..
 .\" ####### module pic #######################################
 .de PS
-.nr pic*in 0
+.if !\\n.$=2 \{\
+.	ds pic*msg \\$0: expected 2 arguments, got \\n.$\"
+.	as pic*msg ; not preprocessed with pic?\"
+.	@error \\*pic*msg
+.\}
 .br
 .SP .5
-.ie \\n.$<2 .@error "PS: bad arguments. Probably not processed with pic."
-.el \{\
-.	if !\\nds*lvl .ne (u;\\$1)+1v
-.\" should be contained between .DS/.DE
-.if r ds*format \{\
-.		if \\nds*lvl&((\\nds*format=2):(\\nds*format=3)) \{\
-.			nr pic*in \\n.i
-.\" .		in +(u;\\n.l-\\n.i-\\$2/2)
-.		\}
-.	\}
-.\}
+.if r ds*format .if !\\nds*lvl .ne (u;\\$1)+1v
 ..
-.de PE
+.de PY
 .init@reset
+..
+.de PE
+.PY
 .SP .5
 ..
 .\" ####### module eq #######################################
@@ -2414,8 +2532,11 @@
 \h'|0'\\*eq*label
 .	\}
 .	el \{\
-.		\"	label to the right
-\h'|\\n.lu-\w'\\*eq*label'u'\\*eq*label
+.		\"	label to the right, possibly compensating for
+.		\"	indented display
+.		ie \\nds*format=1 \
+\h'|\\n.lu-\w'\\*eq*label'u+\\nSin'\\*eq*label
+.		el \h'|\\n.lu-\w'\\*eq*label'u'\\*eq*label
 .	\}
 .	rt
 .\}
@@ -2600,7 +2721,7 @@
 .el .ds lix*numb \\$3
 .\"
 .ie !\\nOf .ds lix*ds-form .\ \ \"
-.el .ds lix*ds-form "\ \(em\ \"
+.el .ds lix*ds-form "\ \em\ \"
 .nr lix*in \\n.i
 .ds lix*label \\*Li\\$1\ \\*lix*numb\\*lix*ds-form
 .if !'\\$5'' \{\
@@ -2717,10 +2838,6 @@
 ..
 .\"########################### module fnt ############################
 .\" some font macros.
-.de R
-.ft 1
-.ul 0
-..
 .\"-----------
 .de fnt@switch
 .ul 0
@@ -2744,6 +2861,10 @@
 .ie \\n.$ .fnt@switch \f2 \f\\n.f \\$@
 .el .ft 2
 ..
+.de R
+.ie \\n.$ .fnt@switch \f1 \f\\n.f \\$@
+.el .ft 1
+..
 .de IB
 .if \\n.$ .fnt@switch \f2 \f3 \\$@
 ..
@@ -2768,7 +2889,7 @@
 .nr box*ll 0
 .\" .B1 and .B2 works like .DS
 .de B1
-.if \\nbox*ll .@error "B1: missing B2"
+.if \\nbox*ll .@error \\$0: cannot nest; missing B2?
 .nr box*ll \\n.l
 .nr box*ind \\n.i
 .nr box*hyp \\n.hy
@@ -2784,7 +2905,7 @@
 .hy \\n.hy
 ..
 .de B2
-.if !\\nbox*ll .@error "B2: missing B1"
+.if !\\nbox*ll .@error \\$0: no corresponding B1
 .br
 .di
 .nr box*height \\ndn
@@ -2856,7 +2977,10 @@
 ..
 .\"-----------
 .de RP
-.if !d ref*mac .@error "RP: No references!"
+.if !d ref*mac \{\
+.	@warning \\$0: ignoring; no references defined
+.	return
+.\}
 .ie !''\\$2' .nr ref*i 0\\$2
 .el .nr ref*i \\nRpe
 .if \\nref*i<2 .SK
@@ -2922,7 +3046,7 @@
 .\" .APPSK name pages text
 .\" name == "" -> autonumber
 .de APPSK
-.if \\n.$<2 .@error "APPSK: too few arguments"
+.if \\n.$<2 .@error \\$0: expected 2 or 3 arguments, got \\n.$
 .app@set-ind "\\$1"
 .\"
 .ds Tcst ap
@@ -2975,7 +3099,8 @@
 .\"	indent stored in cov*abs-ind
 .\" number of authors stored in cov*au
 .\" author(s) stored in cov*au!x!y
-.\" author(s) title stored in cov*at!x!y
+.\" number of authors' titles stored in cov*at!x
+.\" title(s) of author(s) stored in cov*at!x!y
 .\" 	x is the author-index 1-cov*au, y is the argument-index 1-9.
 .\" author(s) firm stored in cov*firm
 .\" new date (if .ND exists) is stored in cov*new-date
@@ -2985,7 +3110,8 @@
 .\"
 .nr cov*au 0
 .de TL
-.rm IA IE WA WE LO LT
+.ds @cover \\$0
+.@disable IA IE WA WE LO LT \" can't use with LT and friends
 .if \\n.$>0 .ds cov*title-charge-case \\$1
 .if \\n.$>1 .ds cov*title-file-case \\$2
 .pg@disable-top-trap
@@ -2997,11 +3123,13 @@
 .ec
 ..
 .\"-------------------
-.\" .AU name initials loc dept ext room arg arg arg
+.\" .AU name initials loc dept ext room arg arg arg
 .de AU
 .cov@title-end
+.if !\\n.$ .return \" AU is being used only to end a TL.
 .pg@disable-top-trap
 .nr cov*au +1
+.nr cov*at!\\ncov*au 0 \" no titles for this author yet
 .nr cov*i 0 1
 .ds cov*au!\\ncov*au!1
 .while \\n.$>=\\n+cov*i \{\
@@ -3014,11 +3142,15 @@
 .\}
 ..
 .\"-------------------
-.\" .AT title1 title2 ... title9 
-.\" Well, thats all that COVEND look for.
-.\" Must appear directly after .AU
+.\" .AT title ...
+.\" Any quantity of titles may be declared.
+.\" Must be called directly after the corresponding .AU.
 .de AT
-.if \\n.$<1 .@error "AT: no arguments"
+.if !\\n.$ \{\
+.	@warning \\$0: ignoring; no arguments specified
+.	return
+.\}
+.nr cov*at!\\ncov*au \\n.$
 .nr cov*i 0 1
 .while \\n.$>=\\n+cov*i \{\
 .	ds cov*at!\\ncov*au!\\ncov*i "\\$\\ncov*i
@@ -3030,12 +3162,12 @@
 .if !''\\$1' .ds cov*firm \\$1
 ..
 .de AST
-.ds cov*abs-name \\$1
+.ds cov*abs-name "\\$1\"
 ..
 .de AS
 .pg@disable-top-trap
-.if d cov*abstract .@error "AS: only one abstract allowed"
-.if !''\\n.z' .@error "AS: no diversion allowed (previous .AS?)"
+.if d cov*abstract .@error \\$0: only one abstract allowed
+.if !''\\n.z' .@error \\$0: no diversion allowed (previous .AS?)
 .nr cov*abs-arg 0\\$1
 .nr cov*abs-ind (n;0\\$2)
 .de cov*abstract AE
@@ -3064,8 +3196,12 @@
 .\" switch to ISO-date if register Iso exist: YYYY-MM-DD
 .if r Iso .ISODATE 1
 .\"-------------------
-.\" save technical numbers.
+.\" Save technical memorandum numbers.
 .de TM
+.if !\\n.$ \{\
+.	@warning \\$0: ignoring; no arguments specified
+.	return
+.\}
 .nr cov*i 0 1
 .while \\n.$>=\\n+cov*i .ds cov*mt-tm!\\ncov*i \\$\\ncov*i
 .nr cov*mt-tm-max \\n.$
@@ -3085,18 +3221,22 @@
 .ds cov*mt-file!6 0.MT
 .\"------------
 .de MT
+.ds @cover \\$0
+.@disable COVER IA IE WA WE LO LT
 .ie \\n.$ \{\
 .	ie d cov*mt-file!\\$1 .ds cov*mt-type \\$1
 .	el .ds cov*mt-type 6
 .\}
 .el .ds cov*mt-type 1
-.ds cov*mt-addresse "\\$2
+.ds cov*mt-addressee "\\$2
 .ds cov*mt-type-text "\\$1
 .ie d @country .ds cov*str mm/\\*@country_
 .el .ds cov*str mm/
 .mso \\*cov*str\\*cov*mt-file!\\*cov*mt-type
 ..
 .de COVER
+.ds @cover \\$0
+.@disable IA IE WA WE LO LT MT
 .ie !\\n.$ .ds cov*cov-type ms
 .el .ds cov*cov-type \\$1
 .pg@disable-top-trap
@@ -3125,18 +3265,18 @@
 .\"---------------
 .\" set a reference.
 .de SETR
-.if \\n.$<1 .@error "SETR:reference name missing"
-.if !r qrf*pass .tm "SETR: No .INITR in this file"
+.if \\n.$<1 .@error \\$0: expected 1 or 2 arguments, got \\n.$
+.if !r qrf*pass .tm \\$0: no .INITR in this file \" XXX: .@error?
 .if \\nRef \{\
 .	ds qrf*name qrf*ref-\\$1
-.	if \\nD>2 .tm SETR: ref \\*qrf*name=\\*hd-mark-trimmed,\\n%
+.	if \\nD>2 .tm SETR: ref \\*qrf*name=\\*hd@mark-trimmed,\\n%
 .	\" heading-number
-.	ds \\*qrf*name-hn \\*hd-mark-trimmed
+.	ds \\*qrf*name-hn \\*hd@mark-trimmed
 .	\" page-number
 .	ds \\*qrf*name-pn \\n%
 .	\"
 .	if \\nRef \{\
-.		tm .ds \\*qrf*name-hn \\*hd-mark-trimmed
+.		tm .ds \\*qrf*name-hn \\*hd@mark-trimmed
 .		tm .ds \\*qrf*name-pn \\n%
 .		if !'\\$2'' .tm .ds \\*qrf*name-xx \\$2
 .	\}
@@ -3146,8 +3286,8 @@
 .\" get misc-string
 .\" If two arg -> set var. arg to misc-string.
 .de GETST
-.if \\n.$<1 .@error "GETST:reference name missing"
-.if !r qrf*pass .tm "GETST: No .INITR in this file"
+.if \\n.$<1 .@error \\$0: expected 1 or 2 arguments, got \\n.$
+.if !r qrf*pass .tm \\$0: no .INITR in this file \" XXX: .@error?
 .ds qrf*name qrf*ref-\\$1
 .	if d \\*qrf*name-xx \{\
 .		ie \\n.$>1 .ds \\$2 \\*\\*qrf*name-xx
@@ -3159,8 +3299,8 @@
 .\" get header-number
 .\" If two arg -> set var. arg to header-number.
 .de GETHN
-.if \\n.$<1 .@error "GETHN:reference name missing"
-.if !r qrf*pass .tm "GETHN: No .INITR in this file"
+.if \\n.$<1 .@error \\$0: expected 1 or 2 arguments, got \\n.$
+.if !r qrf*pass .tm \\$0: no .INITR in this file \" XXX: .@error?
 .ds qrf*name qrf*ref-\\$1
 .if d \\*qrf*name-hn \{\
 .	ie \\n.$>1 .ds \\$2 \\*\\*qrf*name-hn
@@ -3171,8 +3311,8 @@
 .\" get page-number
 .\" If two arg -> set var. arg to page-number.
 .de GETPN
-.if \\n.$<1 .@error "GETPN:reference name missing"
-.if !r qrf*pass .tm "GETPN: No .INITR in this file"
+.if \\n.$<1 .@error \\$0: expected 1 or 2 arguments, got \\n.$
+.if !r qrf*pass .tm \\$0: no .INITR in this file \" XXX: .@error?
 .ds qrf*name qrf*ref-\\$1
 .if d \\*qrf*name-pn \{\
 .	ie \\n.$>1 .ds \\$2 \\*\\*qrf*name-pn
@@ -3181,10 +3321,8 @@
 ..
 .\"----------
 .de GETR
-.if \\n.$<1 .@error "GETR:reference name missing"
-.ie !r qrf*pass \{\
-.	tm "GETR: No .INITR in this file"
-.\}
+.if \\n.$<1 .@error \\$0: expected an argument
+.ie !r qrf*pass .tm \\$0: no .INITR in this file" \" XXX: .@error?
 .el \{\
 .	GETHN \\$1 Qrfh
 .	GETPN \\$1 Qrfp
@@ -3192,22 +3330,16 @@
 .\}
 ..
 .\"########################### module ind ############################
-.\" Support for mgs-style indexing, borrowed from mgs.
-.de IX
-.	tm \\$1\t\\$2\t\\$3\t\\$4 ... \\n%
-..
 .\"--------------------
 .\" Another type of index system
 .\" INITI type filename macro
 .de INITI
-.if \\n.$<1 .@error "INITI:type missing"
+.if \\n.$<2 .@error \\$0: expected 2 or 3 arguments, got \\n.$
 .\" ignore if INITI has already been used
-.if \\n.$>1 \{\
-.	if d ind*file .@error "INITI:file already set"
-.	ds ind*file \\$2.ind
-.	if \\nD>1 .tm INITI: source \\*ind*file
-.\}
-.if !d ind*file .@error "INITI:file not specified"
+.if d ind*file .@error \\$0: index file name already set
+.ds ind*file \\$2.ind
+.if \\nD>1 .tm INITI: source \\*ind*file
+.if !d ind*file .@error \\$0: index file name not specified
 .ds ind*type \\$1
 .if \\nRef \{\
 .	if \\n.$>2 .tm .\\\\" Imacro: \\$3
@@ -3215,13 +3347,13 @@
 ..
 .\"---------------
 .de IND
-.if !d ind*file .@error "IND: No active INITI"
+.if !d ind*file .@error \\$0: no active index; call INITI"
 .if \\nD>1 .tm IND: type=\\*ind*type
-.ds ind*ref
+.ds ind*ref \" empty
 .if '\\*ind*type'N' .ds ind*ref \\n%
 .if '\\*ind*type'H' .ds ind*ref \\*hd*mark
 .if '\\*ind*type'B' .ds ind*ref \\*hd*mark\t\\n%
-.if '\\*ind*ref'' .@error "IND:wrong index type: \\*ind*ref"
+.if '\\*ind*ref'' .@abort invalid index type '\\*ind*type'
 .\"
 .ds ind*line \\$1
 .while \\n.$>0 \{\
@@ -3284,7 +3416,10 @@
 ..
 .\"------------------------
 .de let*lt-sign
-.if !d let@sg_\\*let*type .@error "SG: letter type \\*let*type undefined"
+.\" We hard-code the SG macro name here since this macro is internal but
+.\" only SG calls it.
+.if !d let@sg_\\*let*type .@error SG: letter type '\\*let*type' \
+undefined
 .df@print-float 3
 .nr let*i 0 1
 .nr let*j 0
@@ -3300,22 +3435,32 @@
 .ne \\ncov*auu*4v
 .ie \\n.$>1 .nr let*k 1
 .el .nr let*k \\ncov*au
-.ds let*tmp \\*cov*au!\\nlet*k!3-\\*cov*au!\\nlet*k!4-
+.ds let*tmp \" empty
+.if d cov*au!\\nlet*k!3 \{\
+.	as let*tmp \\*cov*au!\\nlet*k!3\"
+.	if d cov*au!\\nlet*k!4 \
+.		as let*tmp -\\*cov*au!\\nlet*k!4-\"
+.\}
 .nr let*i 0 1
 .while \\n+let*i<=\\ncov*au \{\
-.	if \\nlet*i>1 .as let*tmp /
-.	as let*tmp \\*cov*au!\\nlet*k!2
+.	if \\nlet*i>1 .as let*tmp /\"
+.	if d cov*au!\\nlet*i!2 .as let*tmp \\*cov*au!\\nlet*i!2\"
 .\}
 .if !''\\$1' .as let*tmp -\\$1
 .in (u;\\n.l/2)
 .nf
 .nr let*i 0 1
 .while \\n+let*i<=\\ncov*au \{\
+.	ne 3v+\\ncov*at!\\nlet*iv
 .	SP 3v
 .	if \\nlet*i=\\nlet*k \{\
 \Z'\h'-(u;\\n.l/2)'\\*let*tmp'\c
 .	\}
 \\*cov*au!\\nlet*i!1
+.	nr let*j 0 1
+.	while \\n+let*j<=\\ncov*at!\\nlet*i \{\
+\\*cov*at!\\nlet*i!\\nlet*j
+.	\}
 .\}
 .fi
 .in
@@ -3350,12 +3495,13 @@
 .\" let@header is called from the header. It is supposed
 .\" to remove the alias itself.
 .de LT
-.rm AF AS AE AT AU CS OK TL MT
+.ds @cover LT
+.@disable AF AS AE AT AU COVER CS OK TL MT \" same list as LO
 .ds let*type BL
 .nr Pi 5
 .nr Pt 0
 .if !''\\$1' .ds let*type \\$1
-.if !d let@head_\\*let*type .@error "LT: unknown letter type \\$1"
+.if !d let@head_\\*let*type .@error \\$0: unknown letter type '\\$1'
 .shift
 .als let@header let@head_\\*let*type
 .let@init_\\*let*type \\$@
@@ -3428,12 +3574,14 @@
 .nf
 .if \\$3=1 .sp
 .sp
-.misc@toupper "\\$1, \\$2"
+.ie '\\$2'' .misc@toupper "\\$1"
+.el         .misc@toupper "\\$1, \\$2"
 .if \\$4 .sp
 .if \w'\\$5'&\\$4 \\$5
 .fi
 ..
 .de let@fc_SP
+.\" Simplified letters have no formal closing, just space before SG.
 .sp 2
 ..
 .\"--------------------------------------
@@ -3486,7 +3634,7 @@
 .if d let*lo-SJ \{\
 .	ie '\\*let*type'SP' \{\
 .		sp 2
-.		misc@toupper \\*let*lo-SJ
+.		misc@toupper "\\*let*lo-SJ"
 .		sp
 .	\}
 .	el \{\
@@ -3565,9 +3713,13 @@
 .\"-------------------
 .\" Letter options
 .de LO
-.rm AF AS AE AT AU CS OK TL MT
-.if ''\\$1' .@error "LO: missing option"
-.if !d Let\\$1 .@error "LO: unknown option (\\$1)"
+.ds @cover \\$0
+.@disable AF AS AE AT AU COVER CS OK TL MT \" same list as LT
+.if !\\n.$ \{\
+.	@warning \\$0: ignoring; no arguments specified
+.	return
+.\}
+.if !d Let\\$1 .@error \\$0: unrecognized option '\\$1'
 .ds let*lo-\\$1 \\$2
 .if \nD>1 .tm Letter option \\$1 \\$2
 ..
@@ -3575,10 +3727,6 @@
 .\" Start with a clean slate
 .init@reset
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mm.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mm.am Changed

@@ -1,6 +1,4 @@
-# Copyright 1991-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright 1991-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -50,11 +48,6 @@
 mmexampledir=$(exampledir)/mm
 dist_mmexample_DATA = $(MMEXAMPLEFILES)
 
-# Local configuration files with default values.
-MMLOCALE = \
-  locale \
-  se_locale
-
 EXTRA_DIST += \
   contrib/mm/ChangeLog \
   contrib/mm/examples \
@@ -67,15 +60,32 @@
   contrib/mm/mmroff.1.man \
   contrib/mm/mmroff.pl
 
+mm_TESTS = \
+  contrib/mm/tests/LT_SP_AU_without_AT_works.sh \
+  contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh \
+  contrib/mm/tests/MT-1-reports-all-TM-numbers.sh \
+  contrib/mm/tests/MT_5_includes_AT_in_SG.sh \
+  contrib/mm/tests/P-indentation-works.sh \
+  contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh \
+  contrib/mm/tests/mse_has-sufficient-footnote-space.sh \
+  contrib/mm/tests/place-equation-labels-correctly-in-displays.sh \
+  contrib/mm/tests/remove-stale-bib-entry-data.sh \
+  contrib/mm/tests/short-pages-do-not-overflow-stack.sh
+TESTS += $(mm_TESTS)
+EXTRA_DIST += \
+  $(mm_TESTS) \
+  contrib/mm/tests/artifacts/60657.ref
 
 mmroff: $(mm_srcdir)/mmroff.pl
-	$(AM_V_GEN)$(SED) -e 's;/usr/bin/perl;$(PERL);' \
-	    $(mm_srcdir)/mmroff.pl \
-	    >$@ \
-	&& chmod +x $@
+	$(AM_V_GEN)$(SED) \
+	  -e 's;@PERL@;$(PERL);' \
+	  -e 's;@VERSION@;$(VERSION);' \
+	  $(mm_srcdir)/mmroff.pl \
+	  >$@.tmp \
+	  && chmod +x $@.tmp \
+	  && mv $@.tmp $@
 
-# Special installation rules for m.tmac, mse.tmac, mmse.tmac, mm.tmac
-# and MMLOCALE
+# special installation rules for m.tmac, mse.tmac, mmse.tmac, mm.tmac
 install-data-local: install_mm
 install_mm:
 	-test -d $(DESTDIR)$(tmacdir) || $(mkinstalldirs) $(DESTDIR)$(tmacdir)
@@ -90,19 +100,11 @@
 	  $(mm_srcdir)/mmse.tmac > $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mmse.tmac
 	@$(SED) -e "s;^.mso m.tmac;.mso $(tmac_m_prefix)m.tmac;g" \
 	  $(mm_srcdir)/mm.tmac > $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mm.tmac
-	@for f in $(MMLOCALE); do \
-	  test -f $(DESTDIR)$(tmacdir)/mm/$$f \
-	    || touch $(DESTDIR)$(tmacdir)/mm/$$f; \
-	done
 uninstall-local: uninstall_mm
 uninstall_mm:
 	if test -d $(DESTDIR)$(mmexampledir); then \
 	  rmdir $(DESTDIR)$(mmexampledir); \
 	fi
-	-for f in $(MMLOCALE); do \
-	  test -s $(DESTDIR)$(tmacdir)/mm/$$f \
-	    || $(RM) $(DESTDIR)$(tmacdir)/mm/$$f; \
-	done
 	$(RM) $(DESTDIR)$(tmacdir)/tmac.$(tmac_m_prefix)m
 	$(RM) $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)m.tmac
 	$(RM) $(DESTDIR)$(tmacdir)/$(tmac_m_prefix)mm.tmac
@@ -119,9 +121,8 @@
 	done
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-# vim: set filetype=automake:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mm/0.MT -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mm/0.MT Changed

@@ -1,15 +1,14 @@
-.\" -*- nroff -*-
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -17,7 +16,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 ..
 .
@@ -25,8 +24,8 @@
 .\" Cover sheet. Memorandum type 0-3 and "string".
 .\"------------
 .if !r Au .nr Au 1
-.nr cov*mt0-ind 1.1c
 .de cov@print-title
+.if !d cov*title .@error title not defined; call TL and AU before MT
 .MOVE 4.8c 1.5c
 .S 8
 subject:
@@ -46,6 +45,8 @@
 ..
 .\"------------
 .de cov@print-authors
+.\" The following diagnostic might be unreachable.
+.if !r cov*au .@error no authors defined; call AU before MT
 .MOVE 5.7c 13.3c
 .nf
 .S 8
@@ -75,7 +76,7 @@
 TM
 .	in 1.5c
 .	sp -1
-.	while \\n+cov*i<\\ncov*mt-tm-max \\*cov*mt-tm!\\ncov*i
+.	while \\n+cov*i<=\\ncov*mt-tm-max \\*cov*mt-tm!\\ncov*i
 .	in
 .	ft
 .\}
@@ -166,3 +167,9 @@
 .	pg@enable-trap
 .	ds cov*mt-printed
 .\}
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mm/4.MT -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mm/4.MT Changed

@@ -1,15 +1,14 @@
-.\" -*- nroff -*-
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -17,7 +16,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 ..
 .
@@ -25,7 +24,7 @@
 .\" Cover sheet. Memorandum type 4
 .\"------------
 .de cov@print-title
-.if !d cov*title .@error title (.TL) not defined!
+.if !d cov*title .@error title not defined; call TL and AU before MT
 .MOVE 2.8c
 .S +2
 .ad c
@@ -39,6 +38,8 @@
 ..
 .\"------------
 .de cov@print-authors
+.\" The following diagnostic might be unreachable.
+.if !r cov*au .@error no authors defined; call AU before MT
 .SP 0.5
 .I
 .S +1
@@ -101,4 +102,9 @@
 .cov@print-firm
 .cov@print-abstract
 ..
-
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mm/5.MT -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mm/5.MT Changed

@@ -1,15 +1,14 @@
-.\" -*- nroff -*-
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -17,15 +16,15 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 ..
 .
 .\"------------
 .\" Cover sheet. Memorandum type 5
 .\"------------
-.nr cov*mt0-ind 1.1c
 .de cov@print-title
+.if !d cov*title .@error title not defined; call TL and AU before MT
 .B
 .ll 9c
 .fi
@@ -54,3 +53,9 @@
 .	pg@enable-trap
 .	ds cov*mt-printed
 .\}
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mm/ms.cov -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mm/ms.cov Changed

@@ -1,15 +1,15 @@
 .\" -*- nroff -*-
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -17,7 +17,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 ..
 .
@@ -25,42 +25,50 @@
 .\" Cover sheet. Mostly like ms cover.
 .\"------------
 .de cov@print-title
-.in 0
-.misc@ev-keep cov*ev
-.init@reset
-.ad c
-.hy 0
-.fi
-.B
-.cov*title
-.br
-.ad b
-.R
-.ev
+.ie !d cov*title .@error COVEND: no title (TL) defined
+.el \{\
+.	in 0
+.	misc@ev-keep cov*ev
+.	init@reset
+.	ad c
+.	hy 0
+.	fi
+.	B
+.	cov*title
+.	br
+.	ad b
+.	R
+.	ev
+.\}
 ..
 .\"------------
 .de cov@print-authors
-.SP
-.nr cov*i 0 1
-.while \\n+cov*i<=\\ncov*au \{\
-.	ce
-\fI\\*cov*au!\\ncov*i!1\fP
-.	nr cov*j 0 1
-.	while \\n+cov*j<=9 \{\
-.		if d cov*at!\\ncov*i!\\ncov*j \{\
-.			if \w'\\*cov*at!\\ncov*i!\\ncov*j' \{\
-.				ce
-\s-1\\*cov*at!\\ncov*i!\\ncov*j\s0
-.			.\}
+.ie !\\ncov*au .@error COVEND: no authors (AU) defined
+.el \{\
+.	SP
+.	nr cov*i 0 1
+.	while \\n+cov*i<=\\ncov*au \{\
+.		ds cov*aname \\*cov*au!\\ncov*i!1
+.		ce
+.		nop \fI\\*cov*aname\fP
+.		nr cov*j 0 1
+.		while \\n+cov*j<=\\ncov*at!\\ncov*i \{\
+.			ds cov*atitle \\*cov*at!\\ncov*i!\\ncov*j
+.			ce
+.			nop \s-1\\*cov*atitle\s0
 .		\}
+.		rm cov*atitle
 .	\}
+.	rm cov*aname
 .\}
 ..
 .\"------------
 .de cov@print-firm
-.SP .5
-.ce
-\\*cov*firm
+.if d cov*firm \{\
+.	SP .5
+.	ce
+.	nop \\*cov*firm
+.\}
 ..
 .\"------------
 .de cov@print-abstract
@@ -89,7 +97,8 @@
 .\"-----------------
 .de COVEND
 .br
-.if d cov*default-firm .if !d cov*firm .ds cov*firm \\*cov*default-firm
+.if d cov*default-firm \
+.	if !d cov*firm .ds cov*firm \\*cov*default-firm
 .sp |4.2c
 .cov@print-title
 .cov@print-authors
@@ -99,8 +108,14 @@
 .pg@enable-top-trap
 .bp 1
 .pg@enable-trap
-.if d cov*abs-arg .if \\ncov*abs-arg \{\
+.if r cov*abs-arg .if \\ncov*abs-arg \{\
 .	cov@print-abstract ABSTRACT
 .	SP 2
 .\}
 ..
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mmroff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mmroff.1.man Changed

@@ -1,18 +1,15 @@
-.TH MMROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-mmroff \- cross-reference preprocessor for GNU roff mm macro package
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr mmroff_C \n.C
-.cp 0
+.TH mmroff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+mmroff \- cross-referencing front end for GNU
+.I roff mm
+macro package
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -30,83 +27,145 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_mmroff_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY mmroff
-.OP \-x
-.I groff-arguments
+.RB  \-x 
+.IR groff-argument \~.\|.\|.
+.YS
+.
+.
+.SY mmroff
+.B \-\-help
+.YS
+.
+.
+.SY mmroff
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I mmroff
-is a simple preprocessor for
+is a simple wrapper for
 .IR groff ,
-used for expanding cross references in
+used to expand cross references in
 .IR m@TMAC_M_PREFIX@m ;
 see
-.IR groff_mm (@MAN7EXT@).
+.MR groff_mm @MAN7EXT@ .
 .
+It runs
 .I groff
-is executed twice, first with
+with the
+.B \-mm
+option twice,
+first with
 .B \-z
 and
 .B \-rRef=1
-to collect all cross references and then to do the real processing
-when the cross-reference file is up to date.
+to populate cross-reference and index files with their corresponding
+entries,
+and then again to produce the document.
+.
+It also handles the inclusion of PostScript images with the
+.B PIC
+macro.
+.
+Documents that do not use these features of
+.I "groff mm"
+(the
+.BR INITI ,
+.BR IND ,
+.BR INDP ,
+.BR INITR ,
+.BR SETR ,
+.BR GETHN ,
+.BR GETPN ,
+.BR GETR ,
+.BR GETST ,
+and
+.B PIC
+macros)
+do not require
+.IR \%mmroff .
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays
+a usage message,
+while
+.B \-\-version
+shows version information;
+both exit afterward.
+.
+.
 .TP
 .B \-x
-Just create the cross-reference file.
-.
-This can be used to refresh the cross-reference file; it isn't
-always needed to have accurate cross references and by using this
-option
-.I groff
-will only be run once.
+Create or update the cross-reference file and exit.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
-.B mmroff
+.I mmroff
 was written by
-.MT jh@\:axis.se
-Jörgen Hägg
+.MT jh@\:axis\:.se
+J\o adrgen H\a adgg
 .ME
-of Lund, Sweden.
+of Lund,
+Sweden.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR groff_mm (@MAN7EXT@),
-.IR groff_mmse (@MAN7EXT@),
-.IR groff (@MAN1EXT@),
-.IR @g@troff (@MAN1EXT@),
-.IR @g@tbl (@MAN1EXT@),
-.IR @g@pic (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@)
+.MR groff_mm @MAN7EXT@ ,
+.MR groff_mmse @MAN7EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR @g@tbl @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \nmmroff_C
+.cp \n*groff_mmroff_1_man_C
+.do rr *groff_mmroff_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
-.\" coding: latin-1
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mmroff.pl -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mmroff.pl Changed

@@ -1,6 +1,5 @@
-#! /usr/bin/perl
-# -*- Perl -*-
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+#!@PERL@
+# Copyright (C) 1989-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -18,6 +17,10 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 use strict;
+use warnings;
+
+(my $progname = $0) =~s @.*/@@;
+
 # runs groff in safe mode, that seems to be the default
 # installation now. That means that I have to fix all nice
 # features outside groff. Sigh.
@@ -25,6 +28,17 @@
 # of security holes.
 
 my $no_exec;
+
+if (grep(/^--help$/, @ARGV)) {
+	print "usage: mmroff -x groff-option ... file ...\n";
+	exit;
+}
+
+if (grep(/^--version$/, @ARGV)) {
+	print "mmroff (groff) @VERSION@\n";
+	exit;
+}
+
 # check for -x and remove it
 if (grep(/^-x$/, @ARGV)) {
 	$no_exec++;
@@ -84,12 +98,17 @@
 }
 close(MACRO);
 
+sub Die {
+	print STDERR "$progname: fatal error: @_\n";
+	exit 1;
+}
 
 if ($rfilename) {
 	push(@out, ".nr pict*max-height $max_height\n") if defined $max_height;
 	push(@out, ".nr pict*max-width $max_width\n") if defined $max_width;
 
-	open(OUT, ">$rfilename") || "create $rfilename:$!";
+	open(OUT, ">$rfilename")
+		or &Die("unable to create $rfilename:$!");
 	print OUT '.\" references', "\n";
 	my $i;
 	for $i (@out) {
@@ -104,7 +123,7 @@
 sub print_index {
 	my ($f, $ind, $macro) = @_;
 
-	open(OUT, ">$f") || "create $f:$!";
+	open(OUT, ">$f") or &Die("unable to create $f:$!");
 	my $i;
 	for $i (sort @$ind) {
 		if ($macro) {
@@ -155,8 +174,6 @@
 
 
 1;
-########################################################################
-### Emacs settings
 # Local Variables:
 # mode: CPerl
 # End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/mse.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/mse.tmac Changed

@@ -1,14 +1,14 @@
 .ig
 
-Copyright (C) 1991-2018 Free Software Foundation, Inc.
-mgm is written by Jörgen Hägg <jh@axis.com>
+Copyright (C) 1991-2020 Free Software Foundation, Inc.
+mm is written by Jörgen Hägg <jh@axis.com>
 
-mgm is free software; you can redistribute it and/or modify it under
+mm 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
 (at your option) any later version.
 
-mgm is distributed in the hope that it will be useful, but WITHOUT ANY
+mm 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.
@@ -16,7 +16,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-Please submit bug reports with examples at
+Please submit bug reports using groff's 'BUG-REPORT' file to
 http://savannah.gnu.org/bugs/?group=groff.
 ..
 .
@@ -43,7 +43,7 @@
 .po \n@pou
 .pl \n@plu
 .
-.nr pg*footer-size 4\"                  1v+footer+even/odd footer+1v
+.nr pg*footer-size 4v\"                  1v+footer+even/odd footer+1v
 .\"------------------------------------------------
 .\" Dokumentnamn
 .ds LetDNAMN
@@ -159,10 +159,6 @@
 ..
 .\"  -----------------------------------
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mm/refer-mm.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/refer-mm.tmac Changed

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/LT_SP_AU_without_AT_works.sh Added

@@ -0,0 +1,50 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60373 (3/3).
+#
+# Ensure that an author name (AU) with no title (AT) isn't rendered with
+# a trailing comma.
+#
+# Thanks to Robert Goulding for the reproducer.
+
+EXAMPLE='.LT SP
+.WA "John Doe"
+Nowhere,
+USA.
+.WE
+.IA "Jane Smith"
+Somewhere,
+UK.
+.IE
+.LO SJ "Letter of Introduction"
+.LO SA "Dear Ms.\& Smith"
+.P
+This is the text of the letter.
+.FC "Yours sincerely,"
+.SG'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -mm \
+    | grep -Eqx ':space:+JOHN DOE:space:*'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/LT_SP_multi-word_LO_SJ_works.sh Added

@@ -0,0 +1,49 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60373 (1/3).
+#
+# Ensure that a multi-word subject line (LO SJ) gets rendered.
+#
+# Thanks to Robert Goulding for the reproducer.
+
+EXAMPLE='.LT SP
+.WA "John Doe"
+Nowhere,
+USA.
+.WE
+.IA "Jane Smith"
+Somewhere,
+UK.
+.IE
+.LO SJ "Letter of Introduction"
+.LO SA "Dear Ms.\& Smith"
+.P
+This is the text of the letter.
+.FC "Yours sincerely,"
+.SG'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -mm \
+    | grep -Eqx ':space:+LETTER OF INTRODUCTION:space:*'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/MT-1-reports-all-TM-numbers.sh Added

@@ -0,0 +1,53 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #63613.  The identifiers of all technical
+# memoranda should be formatted.
+
+input='.TL
+My Memo
+.AU "Random Hacker"
+.TM 23-SKIDOO 24-URTHRU
+.MT 1
+This is my memo.
+.
+There are many like it but this one is mine.'
+
+output=$(printf "%s\n" "$input" | "$groff" -mm -Tascii -P-cbou)
+echo "$output"
+
+echo "checking that first TM number is present" >&2
+echo "$output" | grep -q "23-SKIDOO" || wail
+
+echo "checking that second TM number is present" >&2
+echo "$output" | grep -q "24-URTHRU" || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/MT_5_includes_AT_in_SG.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #57034.
+#
+# Ensure that an author's title (if any) is written in the signature.
+#
+# Thanks to Ken Mandelberg for the reproducer.
+
+EXAMPLE='.TL
+Inquiry
+.AU "John SMITH"
+.AT "Director"
+.MT 5
+.P
+sentence
+.FC Sincerely,
+.SG'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -mm \
+    | grep -Eqx ':space:+Director:space:*'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/P-indentation-works.sh Added

@@ -0,0 +1,135 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #54909.  Check other cases as well.
+
+input='.P
+P1 not indented.
+.P 0
+P2 not indented.
+.P 1
+P3 indented.
+.nr Pt 2
+.P
+P4 indented.
+.H 1 Heading
+.P
+P5 not indented.
+.P
+P6 indented.
+.H 3 "Run-in heading."
+Some text.
+.P
+P7 indented.
+.DS
+display
+.DE
+.P
+P8 not indented.
+.P
+P9 indented.
+.BL
+.LI
+list item
+.LE
+.P
+P10 not indented.
+.P
+P11 indented.'
+
+output=$(printf "%s\n" "$input" | "$groff" -mm -Tascii -P-cbou)
+echo "$output"
+
+#       P1 not indented.
+#
+#       P2 not indented.
+#
+#            P3 indented.
+#
+#            P4 indented.
+#
+#
+#       1.  Heading
+#
+#       P5 not indented.
+#
+#            P6 indented.
+#
+#       1.0.1  Run-in heading.  Some text.
+#
+#            P7 indented.
+#
+#       display
+#
+#       P8 not indented.
+#
+#            P9 indented.
+#
+#          o list item
+#
+#       P10 not indented.
+#
+#            P11 indented.
+
+echo "checking that initial untyped paragraph not indented" >&2
+echo "$output" | grep -Eqx ' {7}P1 not indented\.' || wail
+
+echo "checking that initial type 0 paragraph not indented" >&2
+echo "$output" | grep -Eqx ' {7}P2 not indented\.' || wail
+
+echo "checking that first paragraph after Pt=2 indented" >&2
+echo "$output" | grep -Eqx ' {12}P3 indented\.' || wail
+
+echo "checking that second paragraph after Pt=2 indented" >&2
+echo "$output" | grep -Eqx ' {12}P4 indented\.' || wail
+
+echo "checking that first paragraph after heading not indented" >&2
+echo "$output" | grep -Eqx ' {7}P5 not indented\.' || wail
+
+echo "checking that second paragraph after heading indented" >&2
+echo "$output" | grep -Eqx ' {12}P6 indented\.' || wail
+
+echo "checking that paragraph after run-in heading indented" >&2
+echo "$output" | grep -Eqx ' {12}P7 indented\.' || wail
+
+echo "checking that first paragraph after display not indented" >&2
+echo "$output" | grep -Eqx ' {7}P8 not indented\.' || wail
+
+echo "checking that second paragraph after display indented" >&2
+echo "$output" | grep -Eqx ' {12}P9 indented\.' || wail
+
+echo "checking that first paragraph after list not indented" >&2
+echo "$output" | grep -Eqx ' {7}P10 not indented\.' || wail
+
+echo "checking that second paragraph after list indented" >&2
+echo "$output" | grep -Eqx ' {12}P11 indented\.' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/artifacts Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/artifacts/60657.ref Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/ms_cover_sheet_robust_to_missing_AF.sh Added

@@ -0,0 +1,39 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60915.
+#
+# Ensure that a missing firm definition doesn't disrupt cover sheet
+# layout.
+
+EXAMPLE='.COVER
+.ND 2020-07-17
+.TL
+The Great American Novel
+.AU "Eileen M. Plausible"
+.COVEND'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -mm \
+    | grep -Fqx '       2020-07-17' # 7 spaces
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/mse_has-sufficient-footnote-space.sh Added

@@ -0,0 +1,77 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savnnah #63398.
+
+input='.de M
+.  nr N \\\\$1-1
+.  if \\\\$1 .M \\\\nN
+Sed ut perspiciatis, unde omnis iste natus error sit voluptatem
+accusantium doloremque laudantium, totam rem aperiam eaque ipsa, quae ab
+illo inventore veritatis et quasi architecto beatae vitae dicta sunt,
+explicabo.\\\\*F
+.  FS
+footnote text
+.  FE
+..
+.P
+.M 16'
+
+# .de M
+# .  nr N \\$1-1
+# .  if \\$1 .M \\nN
+# Sed ut perspiciatis, unde omnis iste natus error sit voluptatem
+# accusantium doloremque laudantium, totam rem aperiam eaque ipsa, quae ab
+# illo inventore veritatis et quasi architecto beatae vitae dicta sunt,
+# explicabo.\\*F
+# .FS
+# blather
+# .FE
+# Nemo enim ipsam voluptatem, quia voluptas sit, aspernatur
+# aut odit aut fugit, sed quia consequuntur magni dolores eos, qui ratione
+# voluptatem sequi nesciunt, neque porro quisquam est, qui dolorem ipsum,
+# quia dolor sit amet consectetur adipiscivelit, sed quia non-numquam eius
+# modi tempora incidunt, ut labore et dolore magnam aliquam quaerat
+# voluptatem.  Ut enim ad minima veniam, quis nostrum exercitationem ullam
+# corporis suscipitlaboriosam, nisi ut aliquid ex ea commodi consequatur?
+# Quis autem vel eum iure reprehenderit, qui inea voluptate velit esse,
+# quam nihil molestiae consequatur, vel illum, qui dolorem eum fugiat, quo
+# voluptas nulla pariatur?  At vero eos et accusamus et iusto odio
+# dignissimos ducimus, qui blanditiis praesentium voluptatum deleniti
+# atque corrupti, quos dolores et quas molestias excepturi sint, obcaecati
+# cupiditate non-provident, similique sunt in culpa, qui officia deserunt
+# mollitia animi, id est laborum et dolorum fuga.  Et harum quidem rerum
+# facilis est et expedita distinctio.  Nam libero tempore, cum soluta
+# nobis est eligendi optio, cumque nihil impedit, quo minus id, quod
+# maxime placeat, facere possimus, omnis voluptas assumenda est, omnis
+# dolor repellendus.  Temporibus autem quibusdam et aut officiis debitis
+# aut rerum necessitatibus saepe eveniet, ut et voluptates repudiandae
+# sint et molestiae non-recusandae.  Itaque earum rerum hic tenetur a
+# sapiente delectus, ut aut reiciendis voluptatibus maiores alias
+# consequatur aut perferendis doloribus asperiores repellat.
+# ..
+# .P
+# .M 4
+
+output=$(echo "$input" | "$groff" -mm -mmse -Tps)
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/place-equation-labels-correctly-in-displays.sh Added

@@ -0,0 +1,62 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #62190.  Check left- and center-aligned
+# displayed equations as well.
+
+input='.DS L
+.EQ (1)
+p = q
+.EN
+.DE
+.DS I
+.EQ (2)
+w = z
+.EN
+.DE
+.DS C
+.EQ (3)
+x = y
+.EN
+.DE'
+
+output=$(printf "%s\n" "$input" | "$groff" -e -mm -Tascii -P-cbou)
+
+echo "checking left-aligned displayed equation" >&2
+echo "$output" | grep -Eq 'p=q {54}$1$' || wail
+
+echo "checking indented displayed equation" >&2
+echo "$output" | grep -Eq 'w=z {49}$2$' || wail
+
+echo "checking centered displayed equation" >&2
+echo "$output" | grep -Eq 'x=y {26}$3$' || wail
+
+test -z "$fail" || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/remove-stale-bib-entry-data.sh Added

@@ -0,0 +1,72 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #60657.  Ensure data from a bibliographic
+# entry don't carry over to the next.
+
+# Locate directory containing our test artifacts.
+artifact_dir=
+
+for buildroot in . .. ../..
+do
+    d=$buildroot/contrib/mm/tests/artifacts
+    if  -d "$d" 
+    then
+        artifact_dir=$d
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+test -z "$artifact_dir" && exit 77 # skip
+
+input=".R1
+bibliography $artifact_dir/60657.ref
+.R2"
+
+output=$(echo "$input" | "$groff" -R -mm -Tascii -P-cbou)
+
+echo "checking first entry"
+echo "$output" \
+    | grep -q "1\. First Author in First Book\. Test one\.$" \
+    || wail
+
+echo "checking second entry"
+echo "$output" \
+    | grep -q "2\. Second Author in Second Book\.$" \
+    || wail
+
+echo "checking third entry"
+echo "$output" \
+    | grep -q "3\. Third Author\.$" \
+    || wail
+
+test -z "$fail" || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mm/tests/short-pages-do-not-overflow-stack.sh Added

@@ -0,0 +1,59 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #24048.  Pages that are too short to
+# accommodate minimal header and footer requirements should not cause
+# infinite trap recursion.
+
+input='.COVER
+.TL
+Title
+.AU "R. Thurston Howell"
+.AT "Professor of Agnotology" "Publisher, Posterior Analytics Weekly"
+.COVEND
+.P
+Main matter goes here.'
+
+echo "checking that sample document fits using default length" >&2
+output=$(printf "%s\n" "$input" \
+    | "$groff" -b -mm -Tascii -P-cbou) || wail
+
+echo "checking that sample document fits using -rL5v" >&2
+output=$(printf "%s\n" "$input" \
+    | "$groff" -b -rL5v -mm -Tascii -P-cbou) || wail
+
+echo "checking that sample document fails gracefully using -rL4v" >&2
+error=$(printf "%s\n" "$input" \
+    | "$groff" -b -rL4v -mm -Tascii -P-cbou -z 2>&1)
+# Assume that >= 10 lines of stderr must be due to a giant backtrace.
+test $(echo "$error" | wc -l) -lt 10 || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/BUGS -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/BUGS Changed

@@ -1,5 +1,5 @@
     -*- text -*-
-    Copyright 2004-2018 Free Software Foundation, Inc.
+    Copyright 2004-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
@@ -21,6 +21,129 @@
 
 ====================================================================
 
+Version 2.5_c
+=============
+
+#R_MARGIN not being respected in PAGEWIDTH.
+---Fixed---
+
+Version 2.5_b
+=============
+PAGINATE not restoring page numbers after being disabled.
+---Fixed---
+
+Sentence space not being restored after a terminating REF.
+---Fixed---
+
+CODE <OFF> not always correctly restoring point size of text
+afterwards.
+---Fixed---
+
+BLANKPAGE broken when columns are enabled.
+---Fixed---
+
+Registers #FROM_COVERTITLE and #FROM_DOC_COVERTITLE not being
+cleared in macro COLLATE.
+---Fixed---
+
+DROPCAP not calculating distance to FOOTER trap correctly.
+---Fixed---
+
+Version 2.5
+===========
+
+Page offset not being restored correctly after CENTRE_BLOCK.
+---Fixed---
+
+LEFT_HANG intermittently causing type to be raised out of position.
+---Fixed---
+
+$CHAPTER_STRING default not being set in COPYSTYLE.
+---Fixed---
+
+When using mom bare metal, NEWPAGE depositing a superfluous blank
+page unless B_MARGIN has been set explicitly.
+---Fixed---
+
+Version 2.4-4_e
+===============
+
+LANDSCAPE arg to PAPER not being appended to $PAPER so PAPER 
+isn't picking it up when PAPER is called at the top of DEFAULTS. 
+---Fixed---
+
+BLANKPAGE with NULL arg printing incorrect page number when page
+numbering is restored.
+---Fixed---
+
+BLANKPAGE with DIVIDER arg spitting out one too many pages.
+---Fixed---
+
+Hyphens appearing mid-line in runon footnotes.
+---Fixed---
+
+Version 2.4-4_b
+===============
+SMALLCAPS introducing a small indent equal to a wordspace when
+called after PP.
+---Fixed---
+
+Version 2.4-4_a
+===============
+BIBLIOGRAPHY_SPACING not being respected.
+---Fixed---
+
+Version 2.4-4
+=============
+Default PAPER settings overwriting user-entered PAGEWIDTH,
+PAGELENGTH, and PAGE.
+---Fixed---
+
+QUOTE and BLOCKQUOTE indents shifting after page breaks.
+---Fixed---
+
+Version 2.4-3
+=============
+TYPEWRITE: Inline \*PREV calling \*ULX without explicitly
+returning to TYPEWRITER font.
+---Fixed---
+
+%u field in refer databases not triggering ref*type 0 (Internet
+reference).
+---Fixed---
+
+Idem field of refer databases overwriting first occurrence of author
+name.
+---Fixed---
+
+Captions not fully respecting TYPEWRITE.
+---Fixed---
+
+COVERTEXT not fully respecting TYPEWRITE.
+---Fixed---
+
+Changes to font family inside a COVERTEXT block not being reset to
+default document family when the block is terminated.
+---Fixed---
+
+Unwanted linespace before labels above tables.
+---Fixed---
+
+Label number of AUTOLABEL_TABLES incrementing by 2 instead of 1.
+---Fixed---
+
+Page number of the page before a bibliography not printing.
+---Fixed---
+
+Version 2.4-1
+=============
+tbl not respecting pre-tbl fill mode.
+---Fixed---
+
+COVER and DOC_COVER not always capturing pertinent title and
+copyright.
+---Fixed---
+
 Version 2.4
 ===========
 BIBLIOGRAPHY output broken.
@@ -171,7 +294,7 @@
 forced to the next page, causing running text to overprint.
 ---Fixed---
 
-Text after defered floats not being shimmed properly.
+Text after deferred floats not being shimmed properly.
 ---Fixed---
 
 Tables that span pages overprinting first two lines of table on new
@@ -287,7 +410,7 @@
 Use of \E*UC and \E*LC inside strings for HDRFTR_RECTO and
 HDRFTR_VERSO breaking headers.
 ---Not fixable.  CAPS option added to HDRFTR_RECTO/VERSO to
-   accomodate situations where capitalized reserved
+   accommodate situations where capitalized reserved
    strings(\*$TITLE, \*$AUTHOR, etc) are desired.---
 
 COLLATE depositing a blank page if last output line before it falls
@@ -685,7 +808,7 @@
 #FN_COUNT_FOR_COLS for all footnote markers and handling.
 ---Fixed---
 
-Deferred footnotes that occured on the second to last page of
+Deferred footnotes that occurred on the second to last page of
 documents not printing.
 ---Fixed---

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/ChangeLog Changed

@@ -1,3 +1,145 @@
+2023-06-15
+
+	* om.tmac: Enclose all calls to \D't n' in \Z
+
+2023-03-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	mom: Generate test script even if we'll skip it.
+
+	* examples/test-mom.sh.in: Check availability of required
+	pdfinfo(1) and pdfimages(1) commands at test time; skip if they
+	aren't present.
+	* mom.am !HAVE_PDFTOOLS: Generate the test script even if
+	these tools aren't available.
+
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am (uninstall_mom): Clean more fastidiously; try to remove
+	the configured `pdfdocdir` in the event it is empty, but do not
+	fail if it isn't.  (It can be a directory shared with other
+	groff components; we don't know in what order the uninstall
+	targets will serialize, but the last one run should succeed.)
+
+2023-02-02
+	* om.tmac (UNDERSCORE, UNDERSCORE2): Add PREFIX and SUFFIX
+	arguments so surrounding punctuation can be protected from
+	underscoring.
+
+2023-01-16
+	* om.tmac (PRINTSTYLE): Abort with message if nroff is called on
+	a document using PRINTSTYLE TYPESET.
+
+	Fixes <https://savannah.gnu.org/bugs/?63581>.  Thanks to Gene
+	for the report.
+
+2022-11-16
+
+	* om.tmac (PAPER): Adjust #R_MARGIN to work with papersize.tmac.
+
+2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* om.tmac (FORCE_RECTO): Use backslash before newline when
+	starting multi-line conditional block.
+
+2022-09-02
+
+	* examples/mom-pdf.mom: Fixes missing parameter to \*SIZE at
+	line 457.
+
+	* om.tmac: Fixes CODE <anything> not restoring point size
+	correctly.  The point size was being stored in a number register
+	instead of a string.
+
+	* BUGS: Updated.
+
+	Fixes <https://savannah.gnu.org/bugs/?62996>.
+
+2022-08-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am (MOMPDFMOM): Pass `PDFMOMBIN` '-K utf8', not '-k', in
+	case 'configure' didn't find uchardet.
+
+	Fixes <https://savannah.gnu.org/bugs/?62975>.  Thanks to Bjarni
+	Ingi Gislason for the report.
+
+2022-05-31
+
+	* Make mom emit a warning and abort when tbl(1) data present
+		without a corresponding -t on the command line.
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* momdoc/appendices.html: Reflect file rename in groff
+	distribution: the name of the file mapping Adobe Glyph List
+	names to groff special character identifiers for text (as
+	opposed to "special") fonts has changed from "textmap" to
+	"text.map".
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am (MOMPROCESSEDEXAMPLEFILES): Include "typesetting.pdf"
+	only if `HAVE_URW_FONTS`, since the document demands them.
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am ($(MOMPROCESSEDEXAMPLEFILES)): Depend on new name for
+	devpdf stamp file.
+
+2022-04-12  Ingo Schwarze <schwarze@openbsd.org>
+
+	Delete the harmful, ill-designed, buggy, and essentially
+	unmaintained and untested --with-doc option of the configure
+	script.  See the NEWS file for more details on the rationale.
+
+	* mom.am: Delete one INSTALL_SHIPPED_HTML and one BUILD_EXAMPLES
+	conditional and use BUILD_PDFDOC instead of BUILD_PDFEXAMPLES.
+
+2021-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am: Eliminate `MOM_TFLAG` and `MOM_PFLAG` Make macros;
+	they were expanded in only one place.
+	(MOMPDFMOM): Track rename of Make macro `TFLAG` to `MFLAG`.
+
+2022-03-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am (MOMPROCESSEDEXAMPLEFILES): Drop dependency on gnu.eps.
+	No mom document appears to require this file; it came in with
+	the initial Automake file for mom in commit 4d84d0f1d, 27
+	January 2015, and may have been a copy-and-paste error.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* mom.am (mom_test_template): Pull file name into a new
+	variable.
+	(EXTRA_DIST, contrib/mom/examples/tests-mom.sh): Use it.
+	(contrib/mom/examples/tests-mom.sh): Build more quietly;
+	prefix rule with `$(AM_V_GEN)`.  Also run `chmod` conditionally.
+
+2021-10-04
+
+	* version 2.5 release (see NEWS)
+
+	* removed orphaned stubs for abandoned cutaround feature from
+		om.tmac
+
+2019-12-26
+
+	* added PREFIX_CHAPTER argument to HEADING_STYLE
+
+	* added TOC_HEADING; single line, non-pagenumbered insertions into
+		the TOC
+
+2019-11-03
+
+	* templates added for setting up copyright pages
+
+	* updated mom.am to include the templates when building
+		pdfs in mom/examples
+
 2018-11-24
 
 	* version 2.4 release (see NEWS)
@@ -20,7 +162,7 @@
 
 2017-10-29  Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
 
-	om.tmac-u: Fix typo in register reference.
+	* om.tmac-u: Fix typo in register reference.
 
 	Fix bug https://savannah.gnu.org/bugs/?51608.
 
@@ -200,7 +342,7 @@
 
 * Thu Sep 20 2012
 
-	o Simplify enviroment handling.
+	o Simplify environment handling.
 
 * Fri Aug 31 2012
 
@@ -218,7 +360,7 @@
 
 * Thu Sep 8 2011
 
-	o Added register #SUBHEAD, analagous to #HEAD, to fix excessive
+	o Added register #SUBHEAD, analogous to #HEAD, to fix excessive
 	spacing between SUBHEADs and SUBSUBHEADs.
 
 * Sun Feb 20 2011
@@ -933,7 +1075,7 @@
 	footnotes, both "normal" footnotes and footnotes that occur inside
 	QUOTE, BLOCKQUOTE and EPIGRAPH.
 
-	o Addtion of font "styles" to om.tmac, plus changes to the FAMILY
+	o Addition of font "styles" to om.tmac, plus changes to the FAMILY
 	and FT macros to manage them.  New section in the doc appendices
 	on adding fonts and managing the new font styles.
 
@@ -947,7 +1089,7 @@
 	used in justified text.
 
 	o NEWPAGE, which used to be an alias for .bp, has been moved into
-	its own macro, in order to make it more responsive to some unusal
+	its own macro, in order to make it more responsive to some unusual
 	situations.
 
 	o Some changes to elvis_syn.new, including that the file
@@ -1224,7 +1366,7 @@
 
 	o Changed .ne in .HEAD when PRINTSTYLE TYPESET from 5 to 4.  With
 	5, heads required at least 2 lines of text underneath or they'd be
-	defered to the next page, which created too much whitespace at the
+	deferred to the next page, which created too much whitespace at the
 	end of the page.  Heads will now be processed on the same page if
 	the head plus at least one line of text underneath fits.  I figure
 	it's easier for the user to break to a new page manually if this
@@ -1548,7 +1690,7 @@
 
 	o String tabs weren't working as advertised when set from within a
 	tab.  Fixed.  Two new registers added: #ST_OFFSET and #IN_TAB.
-	String tabs now behave poperly and intuitively when set within
+	String tabs now behave properly and intuitively when set within
 	tabs.
 
 	o Added a note to docs about surrounding \w'...' escape with
@@ -1630,15 +1772,17 @@
 
 ##### License
 
-Copyright 2004-2018 Free Software Foundation, Inc.
+Copyright 2004-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
-##### Emacs settings
+##### Editor settings
 Local Variables:
-version-control: never
-mode: change-log
 coding: latin-1
+fill-column: 72
+mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/NEWS -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/NEWS Changed

@@ -1,16 +1,20 @@
     -*- text -*-
-    Copyright (C) 2004-2018  Free Software Foundation, Inc.
+    Copyright (C) 2004-2020 Free Software Foundation, Inc.
 
     Copying and distribution of this file, with or without modification,
     are permitted in any medium without royalty provided the copyright
     notice and this notice are preserved.
 
-Release 2.4
+Release 2.5
 -----------
-General bug fix release, with an overhaul of float, image, and
+Addition of shaded backgrounds, frames, and page colour.
+
+Releases 2.4 — 2.4-4_e
+----------------------
+General bug fix releases, with an overhaul of float, image, and
 pre-processor handling to correct inconsistencies in spacing,
 indents, labels, and captions.  Corrects page numbering issue in
-"Lists of..." when pre-processor material is floated and defered.
+"Lists of..." when pre-processor material is floated and deferred.
 
 Release 2.3
 -----------
@@ -180,7 +184,7 @@
 and doc covers in the pagination scheme.
 
 The convenience macro, CODE, has been made more convenient.  A new
-control macro allows setting users' prefered fixed-width fonts.
+control macro allows setting users' preferred fixed-width fonts.
 Additionally, CODE can now be called inline.
 
 New inline escapes, \*UC and \*LC, have been added to allow
@@ -256,7 +260,7 @@
 -------------
 Bug fixes: First baseline of type wasn't going where it was supposed
 to when the docheader was turned off; fixes to errors in html
-formattting of docs.
+formatting of docs.
 
 Release 1.3
 -----------

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/TODO -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/TODO Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/copyright -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/copyright Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/README-fr.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/README-fr.txt Changed

@@ -1,9 +1,9 @@
-     -*- mode: text; coding: utf-8; -*-
-    Copyright (C) 2014-2018 Free Software Foundation, Inc.
+-*- mode: text; coding: utf-8; -*-
+Copyright (C) 2014-2020 Free Software Foundation, Inc.
 
-    Copying and distribution of this file, with or without modification,
-    are permitted in any medium without royalty provided the copyright
-    notice and this notice are preserved.
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.
 
 ========================================================================
 
@@ -96,6 +96,12 @@
 d'indenter le premier paragraphe de chaque section -- ceci est l'usage
 en typographie française.
 
+***copyright-default.mom/copyright-chapter.mom***
+
+Deux fichiers qui montrent la bonne façon d'insérer une page des
+droits d'auteur dans les documents créés avec mom.  "Default" est
+pour DOCTYPE DEFAULT; "chapter" est pour DOCTYPE CHAPTER.
+
 ***mom-pdf.mom***
 
 Le manuel "Producing PDFs with mom and groff".

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/README.txt -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/README.txt Changed

@@ -1,9 +1,9 @@
-    -*- mode: text; coding: utf-8; -*-
-    Copyright (C) 2004-2018 Free Software Foundation, Inc.
+-*- mode: text; coding: utf-8; -*-
+Copyright (C) 2004-2020 Free Software Foundation, Inc.
 
-    Copying and distribution of this file, with or without modification,
-    are permitted in any medium without royalty provided the copyright
-    notice and this notice are preserved.
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.
 
 ========================================================================
 
@@ -89,6 +89,12 @@
 indent the first paragraph of a section -- this is the usual
 convention in French typesetting.
 
+***copyright-default.mom/copyright-chapter.mom***
+
+These two files demonstrate the correct way to insert a copyright
+page into mom documents.  "Default" is for DOCTYPE DEFAULT;
+"chapter" is for DOCTYPE CHAPTER.
+
 ***mom-pdf.mom***
 
 The manual, Producing PDFs with mom and groff.

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/copyright-chapter.mom Added

@@ -0,0 +1,160 @@
+.\" -*- mode: text; coding: utf-8; -*-
+\#
+\# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+\#
+\# Copying and distribution of this file, with or without modification,
+\# are permitted in any medium without royalty provided the copyright
+\# notice and this notice are preserved.
+\#
+.ig
+***Template for creating a copyright page, DOCTYPE CHAPTER***
+.
+Mom documents comprised of chapters using DOCTYPE CHAPTER require
+the START macro to begin each chapter, and the COLLATE macro to join
+it to the subsequent chapter.
+.
+A copyright page (also called an edition page), which is not a
+chapter, should be treated as a DOCTYPE DEFAULT.  The text of
+the copyright page is entered after START and joined to the first
+chapter (DOCTYPE CHAPTER) with COLLATE.
+.
+Copyright pages are not identified by a title or heading, however
+they require a TITLE in order to be included in PDF viewer outlines
+and the Table of Contents.  Supplying '.TITLE "Copyright"'
+but disabling the DOCHEADER achieves both these requirements.
+.
+Pagination should also be disabled for the copyright page.  Both
+docheader and pagination should be re-enabled before the START of
+the first chapter.
+..
+.
+.\" Cover setup
+.
+.\" By default, mom uses the last TITLE macro before START for the
+.\" title that appears on the cover.  Since the TITLE is "Copyright,"
+.\" mom needs to be told explicitly to use a different title.
+.
+.\" Cover and PDF viewer setup
+.
+.DOCTITLE "Book Title"
+.TITLE DOC_COVER \
+  "\*$DOCTITLE" \" Title for the cover page
+.AUTHOR \
+  "Book Author"
+.DOC_COVER \
+  TITLE AUTHOR
+.PDF_TITLE  \
+  "DOCTYPE CHAPTER with copyright page" \" For PDF viewer titlebar
+.
+.\" Copyright page setup
+.
+.PRINTSTYLE TYPESET
+.DOCTYPE    DEFAULT \" Copyright page is not a chapter.
+.
+.DOCHEADER  off 1i  \" Turn off docheader for copyright page.
+.                   \" Begin text 1 inch from page top.
+.PAGINATION off     \" Disable pagination for copyright page.
+.
+.TITLE "Copyright"  \" Required for the PDF viewer outline; does not
+.                   \" get printed because docheader is disabled.
+.NO_TOC_ENTRY       \" So copyright page is not included in the TOC
+.
+.START              \" Begin example copyright page
+All rights reserved.  No part of this publication may be reproduced,
+distributed, or transmitted in any form or by any means, including
+photocopying, recording, or other electronic or mechanical methods,
+without the prior written permission of the publisher, except
+in the case of brief quotations embodied in critical reviews
+and certain other noncommercial uses permitted by copyright
+law.  For permission requests, write to the publisher, addressed
+“Attention: Permissions Coordinator,” at the address below.
+.SP
+.LEFT
+Copyright \co2019 Copyright Holder
+.SP
+Additional information...
+.TOC_AFTER_HERE \" Place TOC after copyright page.
+.
+.COLLATE
+.
+.\" Chapter setup
+.
+.DOCTYPE CHAPTER  \" Begin using DOCTYPE CHAPTER.
+.TITLE \
+  "\*$DOCTITLE" \" Needed for page headers.
+.                 \" Only required before first chapter.
+.CHAPTER 1
+.CHAPTER_TITLE \
+  "Sample Chapter"
+.DOCHEADER        \" Re-enable docheader.
+.PAGINATE         \" Re-enable pagination.
+.PAGENUMBER 1
+.
+.START \" Begin first chapter.
+.PP
+Lorem ipsum dolor sit amet, consectetur adipiscing elit.  Sed at
+ante.  Mauris eleifend, quam a vulputate dictum, massa quam dapibus
+leo, eget vulputate orci purus ut lorem.  In fringilla mi in ligula.
+Pellentesque aliquam quam vel dolor.  Nunc adipiscing.  Sed quam odio,
+tempus ac, aliquam molestie, varius ac, tellus.  Vestibulum ut nulla
+aliquam risus rutrum interdum.  Pellentesque lorem.  Curabitur sit
+amet erat quis risus feugiat viverra.  Pellentesque augue justo,
+sagittis et, lacinia at, venenatis non, arcu.  Nunc nec libero.  In
+cursus dictum risus.  Etiam tristique nisl a nulla.  Ut a orci.
+Curabitur dolor nunc, egestas at, accumsan at, malesuada nec, magna.
+.PP
+Nulla facilisi.  Nunc volutpat.  Vestibulum ante ipsum primis in
+faucibus orci luctus et ultrices posuere cubilia Curae; Ut sit
+amet orci vel mauris blandit vehicula.  Nullam quis enim.  Integer
+dignissim viverra velit.  Curabitur in odio.  In hac habitasse platea
+dictumst.  Ut consequat, tellus eu volutpat varius, justo orci
+elementum dolor, sed imperdiet nulla tellus ut diam.  Vestibulum
+ipsum ante, malesuada quis, tempus ac, placerat sit amet, elit.
+.PP
+Sed eget turpis a pede tempor malesuada.  Vivamus quis mi at leo
+pulvinar hendrerit.  Cum sociis natoque penatibus et magnis dis
+parturient montes, nascetur ridiculus mus.  Pellentesque aliquet
+lacus vitae pede.  Nullam mollis dolor ac nisi.  Phasellus sit amet
+urna.  Praesent pellentesque sapien sed lacus.  Donec lacinia odio
+in odio.  In sit amet elit.  Maecenas gravida interdum urna.  Integer
+pretium, arcu vitae imperdiet facilisis, elit tellus tempor nisi,
+vel feugiat ante velit sit amet mauris.  Vivamus arcu.  Integer
+pharetra magna ac lacus.  Aliquam vitae sapien in nibh vehicula
+auctor.  Suspendisse leo mauris, pulvinar sed, tempor et, consequat
+ac, lacus.  Proin velit.  Nulla semper lobortis mauris.  Duis urna
+erat, ornare et, imperdiet eu, suscipit sit amet, massa.  Nulla nulla
+nisi, pellentesque at, egestas quis, fringilla eu, diam.
+.PP
+Donec semper, sem nec tristique tempus, justo neque commodo nisl,
+ut gravida sem tellus suscipit nunc.  Aliquam erat volutpat.  Ut
+tincidunt pretium elit.  Aliquam pulvinar.  Nulla cursus.  Suspendisse
+potenti.  Etiam condimentum hendrerit felis.  Duis iaculis aliquam
+enim.  Donec dignissim augue vitae orci.  Curabitur luctus felis a
+metus.  Cum sociis natoque penatibus et magnis dis parturient montes,
+nascetur ridiculus mus.  In varius neque at enim.  Suspendisse massa
+nulla, viverra in, bibendum vitae, tempor quis, lorem.
+.PP
+Donec dapibus orci sit amet elit.  Maecenas rutrum ultrices lectus.
+Aliquam suscipit, lacus a iaculis adipiscing, eros orci pellentesque
+nisl, non pharetra dolor urna nec dolor.  Integer cursus dolor vel
+magna.  Integer ultrices feugiat sem.  Proin nec nibh.  Duis eu dui
+quis nunc sagittis lobortis.  Fusce pharetra, enim ut sodales luctus,
+lectus arcu rhoncus purus, in fringilla augue elit vel lacus.  In
+hac habitasse platea dictumst.  Aliquam erat volutpat.  Fusce iaculis
+elit id tellus.  Ut accumsan malesuada turpis.  Suspendisse potenti.
+Vestibulum lacus augue, lobortis mattis, laoreet in, varius at,
+nisi.  Nunc gravida.  Phasellus faucibus.  In hac habitasse platea
+dictumst.  Integer tempor lacus eget lectus.  Praesent fringilla augue
+fringilla.
+.PP
+Pellentesque aliquam quam vel dolor.  Nunc adipiscing.  Sed quam odio,
+tempus ac, aliquam molestie, varius ac, tellus.  Vestibulum ut nulla
+aliquam risus rutrum interdum.  Pellentesque lorem.  Curabitur sit
+amet erat quis risus feugiat viverra.  Pellentesque augue justo,
+sagittis et, lacinia at, venenatis non, arcu.  Nunc nec libero.  In
+cursus dictum risus.  Etiam tristique nisl a nulla.  Ut a orci.
+.TOC
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/copyright-default.mom Added

@@ -0,0 +1,149 @@
+.\" -*- mode: text; coding: utf-8; -*-
+\#
+\# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+\#
+\# Copying and distribution of this file, with or without modification,
+\# are permitted in any medium without royalty provided the copyright
+\# notice and this notice are preserved.
+\#
+.ig
+***Template for created a copyright page, DOCTYPE DEFAULT***
+
+Mom documents comprised of titled sections using DOCTYPE DEFAULT
+(e.g. a collection of articles or a book of short stories by
+different authors) require the START macro to begin each new
+section, and the COLLATE macro to join it to the subsequent section.
+.
+A copyright page (also called an edition page) should be treated
+as a titled section.  The text of the copyright page is entered
+after START and joined to the next major section (i.e. the beginning
+of a document's content) with COLLATE.
+.
+Copyright pages are not identified by a title or heading, however
+they require a TITLE in order to be included in PDF viewer outlines
+and, if desired, the Table of Contents.  Supplying '.TITLE "Copyright"'
+but disabling the DOCHEADER achieves both these requirements.
+.
+Pagination should also be disabled for the copyright page.  Both
+docheader and pagination should be re-enabled before the START of
+the first (titled) section of the document.
+..
+.
+.\" Cover and PDF viewer setup
+.
+.\" By default, mom uses the last TITLE macro before START for the
+.\" title that appears on the cover.  Since the TITLE is "Copyright,"
+.\" mom needs to be told explicitly to use a different title.
+.
+.TITLE DOC_COVER \
+  "Document Title"
+.EDITOR DOC_COVER \
+  "Document Editor"
+.ATTRIBUTE_STRING DOC_COVER \
+  "Edited by"
+.DOC_COVER \
+  TITLE EDITOR
+.PDF_TITLE \
+  "DOCTYPE DEFAULT with copyright page" \" For PDF viewer titlebar
+.
+.\" Copyright page setup
+.
+.PRINTSTYLE TYPESET
+.DOCHEADER  off 1i \" Turn off docheader for copyright page.
+.                  \" Begin text 1 inch from page top.
+.PAGINATION off    \" Disable pagination for copyright page.
+.
+.TITLE "Copyright" \" Required for PDF viewer outline; does not
+.                  \" get printed because docheader is disabled.
+.
+.NO_TOC_ENTRY      \" So copyright page is not included in the TOC
+.
+.START             \" Begin copyright page
+All rights reserved.  No part of this publication may be reproduced,
+distributed, or transmitted in any form or by any means, including
+photocopying, recording, or other electronic or mechanical methods,
+without the prior written permission of the publisher, except
+in the case of brief quotations embodied in critical reviews
+and certain other noncommercial uses permitted by copyright
+law.  For permission requests, write to the publisher, addressed
+“Attention: Permissions Coordinator,” at the address below.
+.SP
+.LEFT
+Copyright \co2019 Copyright Holder
+.SP
+Additional information...
+.TOC_AFTER_HERE    \" Place TOC after copyright page.
+.
+.COLLATE
+.
+.\" Sample article setup
+.
+.TITLE \
+  "Sample article" \" Title of first article
+.AUTHOR \
+  "Article Author"
+.DOCHEADER         \" Re-enable docheader.
+.PAGINATE          \" Re-enable pagination.
+.PAGENUMBER 1
+.
+.START
+.PP
+Lorem ipsum dolor sit amet, consectetur adipiscing elit.  Sed at
+ante.  Mauris eleifend, quam a vulputate dictum, massa quam dapibus
+leo, eget vulputate orci purus ut lorem.  In fringilla mi in ligula.
+Pellentesque aliquam quam vel dolor.  Nunc adipiscing.  Sed quam odio,
+tempus ac, aliquam molestie, varius ac, tellus.  Vestibulum ut nulla
+aliquam risus rutrum interdum.  Pellentesque lorem.  Curabitur sit
+amet erat quis risus feugiat viverra.  Pellentesque augue justo,
+sagittis et, lacinia at, venenatis non, arcu.  Nunc nec libero.  In
+cursus dictum risus.  Etiam tristique nisl a nulla.  Ut a orci.
+Curabitur dolor nunc, egestas at, accumsan at, malesuada nec, magna.
+.PP
+Nulla facilisi.  Nunc volutpat.  Vestibulum ante ipsum primis in
+faucibus orci luctus et ultrices posuere cubilia Curae; Ut sit
+amet orci vel mauris blandit vehicula.  Nullam quis enim.  Integer
+dignissim viverra velit.  Curabitur in odio.  In hac habitasse platea
+dictumst.  Ut consequat, tellus eu volutpat varius, justo orci
+elementum dolor, sed imperdiet nulla tellus ut diam.  Vestibulum
+ipsum ante, malesuada quis, tempus ac, placerat sit amet, elit.
+.PP
+Sed eget turpis a pede tempor malesuada.  Vivamus quis mi at leo
+pulvinar hendrerit.  Cum sociis natoque penatibus et magnis dis
+parturient montes, nascetur ridiculus mus.  Pellentesque aliquet
+lacus vitae pede.  Nullam mollis dolor ac nisi.  Phasellus sit amet
+urna.  Praesent pellentesque sapien sed lacus.  Donec lacinia odio
+in odio.  In sit amet elit.  Maecenas gravida interdum urna.  Integer
+pretium, arcu vitae imperdiet facilisis, elit tellus tempor nisi,
+vel feugiat ante velit sit amet mauris.  Vivamus arcu.  Integer
+pharetra magna ac lacus.  Aliquam vitae sapien in nibh vehicula
+auctor.  Suspendisse leo mauris, pulvinar sed, tempor et, consequat
+ac, lacus.  Proin velit.  Nulla semper lobortis mauris.  Duis urna
+erat, ornare et, imperdiet eu, suscipit sit amet, massa.  Nulla nulla
+nisi, pellentesque at, egestas quis, fringilla eu, diam.
+.PP
+Donec semper, sem nec tristique tempus, justo neque commodo nisl,
+ut gravida sem tellus suscipit nunc.  Aliquam erat volutpat.  Ut
+tincidunt pretium elit.  Aliquam pulvinar.  Nulla cursus.  Suspendisse
+potenti.  Etiam condimentum hendrerit felis.  Duis iaculis aliquam
+enim.  Donec dignissim augue vitae orci.  Curabitur luctus felis a
+metus.  Cum sociis natoque penatibus et magnis dis parturient montes,
+nascetur ridiculus mus.  In varius neque at enim.  Suspendisse massa
+nulla, viverra in, bibendum vitae, tempor quis, lorem.
+.PP
+Donec dapibus orci sit amet elit.  Maecenas rutrum ultrices lectus.
+Aliquam suscipit, lacus a iaculis adipiscing, eros orci pellentesque
+nisl, non pharetra dolor urna nec dolor.  Integer cursus dolor vel
+magna.  Integer ultrices feugiat sem.  Proin nec nibh.  Duis eu dui
+quis nunc sagittis lobortis.  Fusce pharetra, enim ut sodales luctus,
+lectus arcu rhoncus purus, in fringilla augue elit vel lacus.  In
+hac habitasse platea dictumst.  Aliquam erat volutpat.  Fusce iaculis
+elit id tellus.  Ut accumsan malesuada turpis.  Suspendisse potenti.
+Vestibulum lacus augue, lobortis mattis, laoreet in, varius at,
+nisi.  Nunc gravida.  Phasellus faucibus.  In hac habitasse platea
+dictumst.  Integer tempor lacus eget lectus.  Praesent fringilla augue
+fringilla dui.
+.TOC
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/elvis_syntax -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/elvis_syntax Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/elvis_syntax.new -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/elvis_syntax.new Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/letter.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/letter.mom Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/mom-pdf.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/mom-pdf.mom Changed

@@ -1,6 +1,6 @@
 .\" -*- mode: text; coding: utf-8; -*-
 .\"
-.\" Copyright (C) 2012-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2012-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of mom, which is part of groff, a free software
 .\" project.
@@ -40,12 +40,12 @@
 .PT_SIZE  10.5
 .AUTOLEAD 3
 .PARA_INDENT 0  \" No indent because we're spacing paragraphs.
-.\" Copyright notice
 .COVERTEXT
 .SP .5v
 .QUAD CENTER
 .HY off
 .IB 8P
+.\" Copyright notice
 This file is part of groff.
 .SP .5v
 Groff is free software.  You can redistribute it
@@ -99,24 +99,24 @@
 .\"
 .FOOTNOTE_SIZE -1
 .\" Character definitions for program names, opts, etc.
-.char \ghostscript      \*BDghostscript\*PREV
-.char \groff            \*BDgroff\*PREV
-.char \gropdf           \*BDgropdf\*PREV
-.char \grops            \*BDgrops\*PREV
-.char \man              \*BDman\*PREV
-.char \-mom             \*BD\-mom\*PREV
-.char \mom              \*BDmom\*PREV
-.char \-mpdfmark        \*BD\-mpdfmark\*PREV
-.char \ms               \*BDms\*PREV
-.char \pdfmom           \*BDpdfmom\*PREV
-.char \pdfroff          \*BDpdfroff\*PREV
-.char \-P-e             \*BD\-P\-e\*PREV
-.char \-P-p<papersize>  \*BD\-P\-p<papersize>\*PREV
-.char \ps2pdf           \*BDps2pdf\*PREV
-.char \psselect         \*BDpsselect\*PREV
-.char \-T               \*BD\-T\*PREV
-.char \-Tpdf            \*BD\-Tpdf\*PREV
-.char \-Tps             \*BD\-Tps\*PREV
+.char \ghostscript     \*BDghostscript\*PREV
+.char \groff           \*BDgroff\*PREV
+.char \gropdf          \*BDgropdf\*PREV
+.char \grops           \*BDgrops\*PREV
+.char \man             \*BDman\*PREV
+.char \-mom            \*BD\-mom\*PREV
+.char \mom             \*BDmom\*PREV
+.char \-mpdfmark       \*BD\-mpdfmark\*PREV
+.char \ms              \*BDms\*PREV
+.char \pdfmom          \*BDpdfmom\*PREV
+.char \pdfroff         \*BDpdfroff\*PREV
+.char \-P-e            \*BD\-P\-e\*PREV
+.char \-P-p<papersize> \*BD\-P\-p<papersize>\*PREV
+.char \ps2pdf          \*BDps2pdf\*PREV
+.char \psselect        \*BDpsselect\*PREV
+.char \-T              \*BD\-T\*PREV
+.char \-Tpdf           \*BD\-Tpdf\*PREV
+.char \-Tps            \*BD\-Tps\*PREV
 .\" Strings for inline code
 .ds cod  \E*CODE\&\E*COND
 .ds codx \E*CONDX\E*CODE off\&
@@ -128,13 +128,6 @@
 . nop \*COND\\$*\*CONDX
 . QUOTE OFF
 ..
-.\" Note box
-.de BOX-NOTE
-. ie \\n#NUM_ARGS=1 .DBX .5 0 \\n.lu \\$1
-. el .DBX .5 0 \\$1 \\$2
-. ALD 15p
-. IB 6p
-..
 .\" Table of contents
 .TOC_PADDING 2
 .SPACE_TOC_ITEMS
@@ -145,7 +138,7 @@
 .\"
 .DOCHEADER_ADVANCE 5c \" Begin docheader this distance down from top of page
 .\"
-.NO_SHIM
+.NO_SHIM \" Use flex spacing
 .START
 .\"
 .SP .5c
@@ -191,7 +184,7 @@
 .COD "pdfmom doc.mom > doc.pdf
 One reason to prefer using the native PDF driver (via \pdfmom or
 \-Tpdf) is that papersizes set within mom source files (see
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/typesetting.html#page-setup-intro SUFFIX ) \
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/typesetting.html#page-setup-intro SUFFIX ) \
   "paper and page setup macros"
 do not require a corresponding \-P-p<papersize> flag on the
 command line.
@@ -299,12 +292,12 @@
 URL.  If it ends in \*cod\dq+\dq\*codx\*BU9, the URL is
 surrounded by quotes.  As an example,
 .RW 0
-.COD "\&.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/toc.html
+.COD "\&.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/toc.html
 would open mom's online documentation at
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/toc.html SUFFIX "." 
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/toc.html SUFFIX "." 
 The same, with \*cod\dqhere\dq\*codx supplied as
 hotlink text, lets you click
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/toc.html "here"
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/toc.html "here"
 instead.
 .HEADING 2 NAMED colour  "Assigning a colour to links"
 .PP
@@ -312,9 +305,9 @@
 .COD "\&.PDF_LINK_COLOR <xcolor> | <newcolor> | <r g b> | <#rrggbb>
 where \*cod<xcolor>\*codx or \*cod<newcolor>\*codx are the names
 of colours already initialized with
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/color.html#xcolor "XCOLOR"
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/color.html#xcolor "XCOLOR"
 or
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/color.html#newcolor SUFFIX . "NEWCOLOR"
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/color.html#newcolor SUFFIX . "NEWCOLOR"
 If you prefer to define a new colour (using the RGB colour scheme),
 enter it either as 3 numbers between
 0.0 \*UP 1p\->\*DOWN 1p 1\*BU4.0
@@ -412,7 +405,7 @@
 .COD ".PDF_TITLE \dq\dq \e\dq ie. with a blank argument
 .IBQ
 .FLOAT off
-.SP .5v
+\#.SP .5v
 .HEADING 1 NAMED toc "Tables of Contents"
 .RLD .5v
 .HEADING 2 NAMED toc:gen "Generating a Table of Contents 
@@ -423,7 +416,7 @@
 file. (Formatting of the printable Table of Contents is discussed in
 detail in the
 .PDF_WWW_LINK \
-http://www.schaffter.ca/mom/momdoc/tables-of-contents.html#top \
+https://www.schaffter.ca/mom/momdoc/tables-of-contents.html#top \
 SUFFIX ). "mom documentation"
 When the file is processed and loaded in a viewer, entries in the
 Table of Contents will be clickable links.
@@ -461,7 +454,7 @@
 BEFORE_DOCCOVER
 AFTER_DOCCOVER
 BEFORE_COVER
-AFTER_COVER\*SIZE
+AFTER_COVER\*SIZE +.7
 .SP .25v
 .ILQ
 .JUSTIFY
@@ -532,18 +525,20 @@
 For either invocation, it is not necessary to add \-mom or
 \-mpdfmark, as these are implied.
 .PP
+.RW .04
 If Encapsulated PostScript or plain PostScript images have been
 embedded in a document with
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/images.html#pspic SUFFIX , \
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/images.html#pspic SUFFIX , \
   "PSPIC"
 the \-Tps option must be used.  In most other cases, \pdfmom
 with no \-T flag is preferable.
+.RW 0
 .HEADING 2 NAMED papersize "Setting papersize within a source file"
 .PP
 A significant convenience afforded by using \pdfmom (or \groff
 with the \-Tpdf flag) is that papersizes or page dimensions set
 within mom source files (see
-.PDF_WWW_LINK http://www.schaffter.ca/mom/momdoc/typesetting.html#page-setup-intro \
+.PDF_WWW_LINK https://www.schaffter.ca/mom/momdoc/typesetting.html#page-setup-intro \
   SUFFIX ) "paper and page setup macros"
 do not require a corresponding \-P-p<papersize> option on the
 command line.  It is even possible to create documents with
@@ -552,8 +547,8 @@
 "Differences between pdfmom and pdfroff"
 .PP
 Several features described in this manual are not available when
-using \pdfmom with the \-Tps option, or when using \pdfroff, or
-\groff\~\-Tps\~\-mpdfmark:
+the \-Tps option is given to \pdfmom, nor when using \pdfroff
+or \groff\~\-Tps\~\-mpdfmark:
 .SP .25v
 .QUAD LEFT
 .HYPHENATION off
@@ -587,8 +582,6 @@
 does not support all the features described here
 .ITEM
 accepts images and graphics embedded with PSPIC
-.ITEM
-is mature and well-tested code
 .LIST OFF
 .IQ
 .ALD .4v
@@ -605,27 +598,20 @@
 .ITEM
 is not compatible with
 .PDF_WWW_LINK \
-  http://www.schaffter.ca/mom/momdoc/docprocessing.html#printstyle \
+  https://www.schaffter.ca/mom/momdoc/docprocessing.html#printstyle \
   "PRINTSTYLE TYPEWRITE"
 underlining (e.g., of italics)
 .ITEM
 generally produces larger files; these can be reduced by piping
 the output through \ps2pdf\*B
-.FLOAT
-.QUAD LEFT
-.BR_AT_LINE_KERN
-.IL -2P
-.BOX-NOTE (\n.lu-6P) 3P
-.EW .3
-\*BDNote:\*PREV Owing to a known bug, PDF files piped
-through \ps2pdf lose some of
-.EW 0
-their metadata, notably the window title set with
-\*codPDF_TITLE\*codx.
-.SP .75
-.FLOAT off
-.ITEM
-is newer code with less testing
+.sp -1.25v
+.BOX OUTLINED black SHADED grey90 WEIGHT 1p INSET 6p
+.JUSTIFY
+\*BDNote:\*PREV Owing to a known bug, PDF files piped through
+\ps2pdf lose some of their metadata, notably the window title set
+with \*codPDF_TITLE\*codx.
+.BOX STOP
+.SP -.25v
 .LIST OFF
 .TOC
 .\" Local Variables:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/mom.vim -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/mom.vim Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/mon_premier_doc.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/mon_premier_doc.mom Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/sample_docs.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/sample_docs.mom Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/slide-demo.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/slide-demo.mom Changed

@@ -1,13 +1,12 @@
 .\" -*- mode: text; coding: utf-8; -*-
-.
-.\"----------------------------------------------------------------
-.\" Make first slide black.  Remove if printing to save ink.
-.po 0
-.ll 11i
-.DBX SOLID 0 \n.lu \n.pu
-.\"----------------------------------------------------------------
-.
-.\"----------------------------------------------------------------
+\#
+\# Copyright (C) 2004-2020 Free Software Foundation, Inc.
+\# Revised for version 2.5 2021-08.
+\#
+\# Copying and distribution of this file, with or without modification,
+\# are permitted in any medium without royalty provided the copyright
+\# notice and this notice are preserved.
+\#
 .\" Macro for code blocks
 .de CODE_BLOCK
 . ie \\n.$ \{\
@@ -74,7 +73,12 @@
 .
 .STRING hand \*darkred\rh\*black
 .
+.\" Make first slide black.
+.\" If printing, remove to save ink.
+.SLIDE_COLOR black
+.
 .START
+.SLIDE_COLOR off
 .
 .ADD_SPACE 9p
 .IB 8P
@@ -250,12 +254,44 @@
 .PT_SIZE +2
 .
 .NEWSLIDE "Blinds .5"
+.SLIDE_COLOR antiquewhite
 .
 .ADD_SPACE 9p
 .
-.HEADING 1 "Macros and preprocessors"
+.HEADING 1 "Highlighting items
 .SP .5v
+.PP
+The BOX macro lets you highlight items as they are revealed with
+frames and shaded backgrounds\*HANG .
+.PAUSE "Fade .5"
+.BOX SHADED pink INSET 3p
+.PP
+This item is highlighted with a shaded background\*HANG .
+.PAUSE
+.PP
+The highlight moves to each new item as it's revealed\*HANG .
+.PAUSE
+.PP
+Highlighting can continue for as many slides as you want\*HANG .
+.PAUSE
+.PP
+If there are no pauses on a slide, BOX can be used
+.BR
+to provide a background for all the items\*HANG .
+.PAUSE
+.PP
+The SLIDE_COLOR macro lets you colour
+.BR
+the whole slide (q.v.)\*HANG .
+.BOX off
+.
+.NEWSLIDE "Box 1 . O"
+.SLIDE_COLOR off
+.
+.ADD_SPACE 9p
 .
+.HEADING 1 "Macros and preprocessors"
+.SP .5v
 .PP
 Slides can make full use of all mom's document processing and
 typesetting macros, including preprocessors and image insertion\*HANG .
@@ -265,20 +301,22 @@
 .
 .PAD "\
 \*FWD 4P+6p\*ST1#\*ST1X\
-\*FWD 1P\*ST2#\*ST2X\
-\*FWD 3P+6p\*ST3#\*ST3X\
+\*FWD 2P+6p\*ST2\*FWD 12P\\*ST2X\
+\*FWD 3P+9p\*ST3#\*ST3X\
 \*FWD 3P\*ST4#\*ST4X\*FWD 2P"
 .
 .ST 1 L
-.ST 2 L
-.ST 3 L
-.ST 4 L
+.ST 2 C
+.ST 3 C
+.ST 4 C
 .
 .PAUSE "Fade .5"
 .
 .TAB 1
 .PT_SIZE -1.5
+.CENTER
 \*BD\*blue2\*DOWN 6ptbl
+.LEFT
 .mk
 .PT_SIZE -1
 .COLOR blue2
@@ -307,7 +345,7 @@
 \*FWD 10p\*DOWN 6ppic
 .COLOR green4
 .SP 3p
-.PS 2
+.PS 2 LEFT
 A: ellipse wid 0.5 ht 0.5
   arrow color "green4" up 0.2 from A.n
   arrow color "green4" up 0.2 right 0.2 from A.ne
@@ -345,11 +383,11 @@
 .COLOR blue2
 \*DOWN 6ppdf image\*black\*PREV
 .SP 2P+6p
-.PDF_IMAGE -L penguin.pdf 81p 96p FRAME
+.PDF_IMAGE -C penguin.pdf 81p 96p FRAME
 .TQ
 .
 .NEWSLIDE "Box 1 . O"
-.ADD_SPACE 9p
+.ADD_SPACE 5p
 .IB 10P
 .PT_SIZE +1.5
 .
@@ -394,3 +432,7 @@
 . DCL SOLID \n+dcl-indP 9p 9p blue2
 .\}
 .CENTER_BLOCK off
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/test-mom.sh.in -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/test-mom.sh.in Changed

@@ -1,6 +1,6 @@
 #!/bin/sh
 #
-# Copyright (C) 2018- Free Software Foundation, Inc.
+# Copyright (C) 2018-2020 Free Software Foundation, Inc.
 # 
 # This file is part of groff.
 # 
@@ -29,6 +29,8 @@
   sample_docs.pdf
   slide-demo.pdf
   typesetting.pdf
+  copyright-chapter.pdf
+  copyright-default.pdf
   "
 
 if test "$have_urw_fonts" != "yes"; then
@@ -36,6 +38,15 @@
     exit 77
 fi
 
+for cmd in pdfinfo pdfimages
+do
+    if ! command -v $cmd >/dev/null
+    then
+        echo "cannot locate '$cmd' command; skipping" >&2
+        exit 77 # skip
+    fi
+done
+
 # $1: pdf file
 # $2: expected number of pages
 check_number_pages()
@@ -70,8 +81,10 @@
 check_number_pages "$examplesdir/mom-pdf.pdf" 8
 check_number_pages "$examplesdir/mon_premier_doc.pdf" 5
 check_number_pages "$examplesdir/sample_docs.pdf" 12
-check_number_pages "$examplesdir/slide-demo.pdf" 27
+check_number_pages "$examplesdir/slide-demo.pdf" 33
 check_number_pages "$examplesdir/typesetting.pdf" 3
+check_number_pages "$examplesdir/copyright-chapter.pdf" 5
+check_number_pages "$examplesdir/copyright-default.pdf" 5
 
 check_has_images "$examplesdir/typesetting.pdf"
 check_has_images "$examplesdir/slide-demo.pdf"

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/examples/typesetting.mom -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/examples/typesetting.mom Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/groff_mom.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/groff_mom.7.man Changed

@@ -1,19 +1,14 @@
-.TH GROFF_MOM @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_mom \- groff \(lqmom\(rq macros; \(lqmom\(rq is a \(lqroff\(rq \
-language, part of \(lqgroff\(rq
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_mom_C \n.C
-.cp 0
+.TH groff_mom @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_mom \- modern macros for document composition with GNU
+.I roff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2002-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2002-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of mom, which is part of groff, the GNU roff
 .\" type-setting system.
@@ -33,12 +28,30 @@
 .\" <http://www.gnu.org/licenses/>.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_mom_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Setup
 .\" ====================================================================
 .
-.ds Ellipsis \&.\|.\|.\&\"
-.
 .hw line-space
 .
 .
@@ -61,212 +74,160 @@
 .  if (\\n.$ = 1) .as result \,\f\\$1
 .  nh
 .  nop \\*result\&
-.  hy
+.  rm result
+.  hy \\nHY
 ..
 .
 .
 .\" ====================================================================
-.SH "SYNOPSIS"
+.SH Synopsis
 .\" ====================================================================
 .
-.SY pdfmom
-.RB  \-Tps
-.RI  pdfroff-option
-\*Ellipsis
-.RI  groff-option
-\*Ellipsis
-.I file
-\*Ellipsis
-.YS
-.
 .SY groff
 .B \-mom
-.RI  option
-\*Ellipsis
-.I file
-\*Ellipsis
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
 .SY groff
 .B "\-m mom"
-.RI  option
-\*Ellipsis
-.I file
-\*Ellipsis
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH CALLING MOM
+.SH Description
 .\" ====================================================================
 .
-.B mom
+.I mom
 is a macro set for
-.BR groff ,
-designed primarily to format documents for
-.I PDF
-and
-.I PostScript
-output.
+.IR groff ,
+designed primarily to prepare documents for PDF and PostScript output.
 .
 .
-.P
-.B mom
-provides two categories of macros: macros for typesetting, and
-macros for document processing.
+.I mom
+provides macros in two categories: typesetting
+and document processing.
 .
-The typesetting macros provide access to groff's typesetting
-capabilities in ways that are simpler to master than groff's
-primitives.
+The former provide access to
+.IR groff 's
+typesetting capabilities in ways that are simpler to master than
+.IR groff 's
+requests and escape sequences.
 .
-The document processing macros provide highly customizable markup
-tags that allow the user to design and output professional-looking
-documents with a minimum of typesetting intervention.
+The latter provide highly customizable markup tags that allow the user
+to design and output professional-looking documents with a minimum of
+typesetting intervention.
 .
 .
 .P
 Files processed with
-.BR pdfmom (@MAN1EXT@)
-with or without the
-.RI \-T ps
-option, produce
-.I PDF
-documents.
-.
-The documents include a
-.I PDF
-outline that appears in the \oqContents\cq panel of document
-viewers, and may contain clickable internal and external links.
+.MR pdfmom @MAN1EXT@
+produce PDF documents.
 .
+The documents include a PDF outline that appears in the navigation pane
+panel of document viewers,
+and may contain clickable internal and external links.
 .
 .P
-When
-.RI \-T ps
-is absent,
-.B groff's
-native
-.I PDF
-driver,
-.BR gropdf ,
+Normally.
+.IR groff 's
+native PDF driver,
+.MR gropdf @MAN1EXT@ ,
 is used to generate the output.
 .
-When given, the output is still
-.IR PDF ,
-but processing is passed over to
-.BR pdfroff ,
+When
+.I pdfmom
+is given the
+.RB \lq "\-T ps" \rq
+option,
+it still produces PDF,
+but processing is delegated to
+.IR pdfroff ,
 which uses
-.B groff's
+.IR groff 's
 PostScript driver,
-.BR grops \&.
-Not all
-.I PDF
-features are available when
-.RI \-T ps
-is given; its primary use is to allow processing of files with
-embedded
-.I PostScript
+.MR grops @MAN1EXT@ .
+.
+Not all PDF features are available when
+.B \-T ps
+is given;
+its primary use is to allow processing of files with embedded PostScript
 images.
+.\" XXX: but we have PDFPIC now...so -Tps is necessary only for people
+.\" who want to avoid use of unsafe mode?
 .
 .
 .P
 Files processed with
 .B groff \-mom
 (or
-.BI "\-m " mom\/\c
-) produce
-.I PostScript
-output by default.
+.BR "\-m mom" )
+format for the device specified with the
+.B \-T
+option.
+.
+(In this installation,
+.B @DEVICE@
+is the default output device.)
 .
 .
 .P
-.B mom
-comes with her own very complete documentation in
-.I HTML
-format.
+.I mom
+comes with her own comprehensive documentation in HTML.
 .
-A separate
-.IR "PDF manual" ,
-.I Producing PDFs
-with groff and
-.BR mom ,
-covers full
-.B mom
-or
-.I PDF
-usage.
+A PDF manual,
+\lqProducing PDFs with
+.I groff
+and
+.IR mom \rq,
+discusses preparation of PDF documents with
+.I mom
+in detail.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @MACRODIR@/\:om.tmac
-\en the main macro file
-.TQ
 .I @MACRODIR@/\:mom.tmac
-\en a wrapper file that calls om.tmac directly.
+is a wrapper enabling the package to be loaded with
+.RB \lq "groff \-m mom" \rq.
 .
-.TP
-.I @HTMLDOCDIR@/\:mom/\:toc.html
-\en entry point to the HTML documentation
-.
-.TP
-.I @PDFDOCDIR@/\:mom\-pdf.pdf
-\en the PDF manual,
-.I Producing PDFs with groff and mom
 .
 .TP
-.IR @EXAMPLEDIR@/\:mom/\: * .mom
-\en example files using mom
-.
-.
-.\" ====================================================================
-.SH DOCUMENTATION IN ALPHABETICAL ORDER
-.\" ====================================================================
-.
-.
-This part of the man page contains information just as in groff(7),
-.I mom macros
-and
-.I mom escape sequences
-in alphabetical order.
-.
+.I @MACRODIR@/\:om.tmac
+implements the package.
 .
-.P
-The logical order of
-.I mom macros
-and
-.I mom escape sequences
-is very well documented in
 .
 .TP
 .I @HTMLDOCDIR@/\:mom/\:toc.html
-\en entry point to the HTML documentation
-.
-.
-.P
-That document is quite good for beginners, but other users should be
-happy to have some documentation in reference style.
+is the entry point to the HTML documentation.
 .
 .
-.P
-So we restrict this part to the alphabetical order of macros and
-escape sequences.
-.
-But, so far, we took all documentation details from the
-.I toc.html
-file, just in a more useful alphabetical order.
+.TP
+.I @PDFDOCDIR@/\:mom\-pdf.pdf
+is \lqProducing PDFs with
+.I groff
+and
+.IR mom \rq,
+by Deri James and Peter Schaffter.
 .
 .
-So this part of the man page is nothing new, but only a logical
-arrangement.
+.TP
+.IR @EXAMPLEDIR@/\:mom/\: * .mom
+are examples of
+.I mom
+usage.
 .
 .
 .\" ====================================================================
-.SH "QUICK REFERENCE"
+.SH Reference
 .\" ====================================================================
 .
 .\" ====================================================================
-.SS "Quick Reference of Inline Escape Sequences in alphabetical Order"
+.SS "Escape sequences"
 .\" ====================================================================
 .
 .TP
@@ -276,7 +237,7 @@
 .
 .TP
 .FONT B \rs*BCK I " n" B 
-move backwards in a line
+move backward in a line
 .
 .
 .TP
@@ -310,13 +271,13 @@
 .
 .
 .TP
-.FONT B \rs*CONDSUP R \*Ellipsis B \rs*CONDSUPX
+.FONT B \rs*CONDSUP R .\|.\|. B \rs*CONDSUPX
 pseudo-condensed superscript
 .
 .
 .TP
 .FONT B \rs*DOWN I " n" B 
-temporarily move downwards in a line
+temporarily move downward in a line
 .
 .
 .TP
@@ -338,7 +299,7 @@
 .
 .
 .TP
-.FONT B \rs*EXTSUP R \*Ellipsis B \rs*EXTSUPX
+.FONT B \rs*EXTSUP R .\|.\|. B \rs*EXTSUPX
 pseudo extended superscript
 .
 .
@@ -382,12 +343,12 @@
 .
 .
 .TP
-.FONT B \rs*ST I <n> B  R \*Ellipsis B \rs*ST I <n> B X
+.FONT B \rs*ST I <n> B  R .\|.\|. B \rs*ST I <n> B X
 string tabs (mark tab positions inline)
 .
 .
 .TP
-.FONT B \rs*SUP R \*Ellipsis B \rs*SUPX
+.FONT B \rs*SUP R .\|.\|. B \rs*SUPX
 superscript
 .
 .
@@ -399,17 +360,17 @@
 .
 .
 .TP
-.FONT B \rs*UL R \*Ellipsis B \rs*ULX
+.FONT B \rs*UL R .\|.\|. B \rs*ULX
 invoke underlining inline (fixed width fonts only)
 .
 .
 .TP
 .FONT B \rs*UP I " n" B 
-temporarily move upwards in a line
+temporarily move upward in a line
 .
 .
 .\" ====================================================================
-.SS "Quick Reference of Macros in alphabetical Order"
+.SS Macros
 .\" ====================================================================
 .
 .TP
@@ -625,11 +586,11 @@
 .
 .
 .\" ====================================================================
-.SH "DOCUMENTATION OF DETAILS"
+.SH "Documentation of details"
 .\" ====================================================================
 .
 .\" ====================================================================
-.SS "Details of Inline Escape Sequences in alphabetical Order"
+.SS "Details of inline escape sequences in alphabetical order"
 .\" ====================================================================
 .
 .TP
@@ -639,12 +600,12 @@
 .
 .TP
 .FONT B \rs*BCK I " n" B 
-move wards in a line
+move backward in a line
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" BOLDER
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*BOLDER
 .TQ
@@ -660,11 +621,14 @@
 .B \rs*BOLDERX
 turns the feature off.
 .
-Both are inline escapes, therefore they should not appear as separate
-lines, but rather be embedded in text lines, like this:
+Both are inline escape sequences;
+therefore,
+they should not appear as separate lines,
+but rather be embedded in text lines, like this:
 .RS
 .EX
-.FONT R "Not " B \rs*BOLDER R everything B \rs*BOLDERX R " is as it seems."
+.FONT R "Not " B \rs*BOLDER R everything B \rs*BOLDERX \
+R " is as it seems."
 .EE
 .RE
 .
@@ -672,7 +636,8 @@
 Alternatively, if you wanted the whole line emboldened, you should do
 .RS
 .EX
-.FONT B \rs*BOLDER R "Not everything is as it seems." B \rs*BOLDERX
+.FONT B \rs*BOLDER R "Not everything is as it seems." \
+B \rs*BOLDERX
 .EE
 .RE
 .
@@ -683,7 +648,7 @@
 .P
 Note: If you're using the document processing macros with
 .BR "\%.PRINTSTYLE \%TYPEWRITE" ,
-.B mom
+.I mom
 ignores
 .B \rs*BOLDER
 requests.
@@ -691,18 +656,18 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" BU
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*BU I " n" B 
 move characters pairs closer together inline (related to macro
 .BR \%.KERN )
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" COND
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*COND
 .TQ
@@ -718,8 +683,10 @@
 .B \rs*CONDX
 turns the feature off.
 .
-Both are inline escapes, therefore they should not appear as separate
-lines, but rather be embedded in text lines, like this:
+Both are inline escape sequences;
+therefore,
+they should not appear as separate lines,
+but rather be embedded in text lines, like this:
 .RS
 .EX
 .FONT B \rs*COND I "Not everything is as it seems." B \rs*CONDX
@@ -737,11 +704,11 @@
 .B \%.PT_SIZE
 macro or with the
 .B \rss
-inline escape.
+inline escape sequence.
 .
 If you wish the new point size to be pseudo-condensed, simply reinvoke
 .B \%\rs*COND
-afterwards.
+afterward.
 .
 Equally,
 .B \%\rs*COND
@@ -751,7 +718,7 @@
 .P
 Note: If you're using the document processing macros with
 .BR "\%.PRINTSTYLE \%TYPEWRITE" ,
-.B mom
+.I mom
 ignores
 .B \%\rs*COND
 requests.
@@ -759,34 +726,34 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" CONDSUP
-.\" ======================================================================
+.\" ====================================================================
 .TP
-.FONT B \rs*CONDSUP R \*Ellipsis B \rs*CONDSUPX
+.FONT B \rs*CONDSUP R .\|.\|. B \rs*CONDSUPX
 pseudo-condensed superscript
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" DOWN
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*DOWN I " n" B 
-temporarily move downwards in a line
+temporarily move downward in a line
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" EN-MARK
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*EN\-MARK
 mark initial line of a range of line numbers (for use with line
 numbered endnotes)
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" EXT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*EXT
 .TQ
@@ -802,8 +769,10 @@
 .B \rs*EXTX
 turns the feature off.
 .
-Both are inline escapes, therefore they should not appear as separate
-lines, but rather be embedded in text lines, like this:
+Both are inline escape sequences;
+therefore,
+they should not appear as separate lines,
+but rather be embedded in text lines, like this:
 .RS
 .EX
 .FONT B \rs*EXT I "Not everything is as it seems." B \rs*EXTX
@@ -821,13 +790,13 @@
 .B \%.PT_SIZE
 macro or with the
 .B \rss
-inline escape.
+inline escape sequence.
 .
 If you wish the new point size to be
 .IR \%pseudo-extended ,
 simply reinvoke
 .B \%\rs*EXT
-afterwards.
+afterward.
 .
 Equally,
 .B \%\rs*EXT
@@ -837,7 +806,7 @@
 .P
 Note: If you are using the document processing macros with
 .BR "\%.PRINTSTYLE \%TYPEWRITE" ,
-.B mom
+.I mom
 ignores
 .B \%\rs*EXT
 requests.
@@ -845,59 +814,59 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" EXTSUP
-.\" ======================================================================
+.\" ====================================================================
 .TP
-.FONT B \rs*EXTSUP R \*Ellipsis B \rs*EXTSUPX
+.FONT B \rs*EXTSUP R .\|.\|. B \rs*EXTSUPX
 pseudo extended superscript
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FU
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*FU I " n" B 
 move characters pairs further apart inline (related to macro
 .BR .KERN )
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FWD
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*FWD I " n" B 
 move forward in a line
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" LEADER
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*LEADER
 insert leaders at the end of a line
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" RULE
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*RULE
 draw a full measure rule
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" PT_SIZE
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*SIZE I " n" B 
 change the point size inline (related to macro
 .BR \%.PT_SIZE )
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" SLANT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*SLANT
 .TQ
@@ -915,14 +884,14 @@
 .B \%\rs*SLANTX
 turns the feature off.
 .
-Both are
-.I inline
-.IR escapes ,
-therefore they should not appear as separate lines, but rather be
-embedded in text lines, like this:
+Both are inline escape sequences;
+therefore,
+they should not appear as separate lines,
+but rather be embedded in text lines, like this:
 .RS
 .EX
-.FONT R "Not " B \rs*SLANT R everything B \rs*SLANTX R " is as it seems."
+.FONT R "Not " B \rs*SLANT R everything B \rs*SLANTX \
+R " is as it seems."
 .EE
 .RE
 .
@@ -932,7 +901,8 @@
 you'd do
 .RS
 .EX
-.FONT B \rs*SLANT R "Not everything is as it seems." B \rs*SLANTX
+.FONT B \rs*SLANT R "Not everything is as it seems." \
+B \rs*SLANTX
 .EE
 .RE
 .
@@ -944,7 +914,7 @@
 .P
 Note: If you're using the document processing macros with
 .BR "\%.PRINTSTYLE \%TYPEWRITE" ,
-.B mom
+.I mom
 underlines pseudo-italics by default.
 .
 To change this behaviour, use the special macro
@@ -953,11 +923,11 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" ST
-.\" ======================================================================
+.\" ====================================================================
 .TP
-.FONT B \rs*ST I <number> B  R \*Ellipsis B \rs*ST I <number> B X
+.FONT B \rs*ST I <number> B  R .\|.\|. B \rs*ST I <number> B X
 Mark positions of string tabs
 .
 .RS
@@ -983,8 +953,8 @@
 below.
 .
 .P
-String tabs need to be marked off with inline escapes before being set
-up with the
+String tabs need to be marked off with inline escape sequences before
+being set up with the
 .B .ST
 macro.
 .
@@ -997,7 +967,8 @@
 The following shows a sample input line with string tab markers.
 .RS
 .EX
-.FONT B \rs*ST1 R "Now is the time" B \rs*ST1X R " for all " B \rs*ST2 R "good men" B \rs*ST2X R " to come to the aid of the party."
+.BR \rs*ST1 "De minimus" \rs*ST1X \c
+.RB "non curat" \rs*ST2 lex \rs*ST2X .
 .EE
 .RE
 .
@@ -1014,15 +985,15 @@
 and ends after
 .IR men .
 .
-.I Inline escapes
-(e.g.\&
+.I Inline escape sequences
+(e.g.,
 .I font
 or
 .I point size
 .IR changes ,
 or horizontal movements, including padding) are taken into account
 when
-.B mom
+.I mom
 determines the
 .I position
 and
@@ -1054,10 +1025,10 @@
 .P
 .I IMPORTANT:
 Owing to the way
-.B groff
+.I groff
 processes input lines and turns them into output lines, it is not
 possible for
-.B mom
+.I mom
 to
 .I guess
 the correct starting position of string tabs marked off in lines that
@@ -1113,33 +1084,33 @@
 you should do:
 .RS
 .EX
-.B .QUAD CENTER
-.B .PAD """#\rs*ST1A line of text\rs*ST1X#"""
-.B .EL
-.B .ST 1
-.B .TAB 1
-.B .PT_SIZE 24
-.B .ALD 3p
-.B \rs*RULE \rs" Note that you can't use \rs*UP or \rs*DOWN with \rs*RULE\""
-.B .RLD 3p
-.B .TQ
+\&.QUAD CENTER
+\&.PAD "#\rs*ST1A line of text\rs*ST1X#"
+\&.EL
+\&.ST 1
+\&.TAB 1
+\&.PT_SIZE 24
+\&.ALD 3p
+\&\rs" You can\aqt use \rs*UP or \rs*DOWN with \rs*RULE.
+\&.RLD 3p
+\&.TQ
 .EE
 .RE
 .
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" SUP
-.\" ======================================================================
+.\" ====================================================================
 .TP
-.FONT B \rs*SUP R \*Ellipsis B \rs*SUPX
+.FONT B \rs*SUP R .\|.\|. B \rs*SUPX
 superscript
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" TB+
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \rs*TB+
 Inline escape for
@@ -1147,37 +1118,37 @@
 .RI ( "Tab Next" )
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" UL
-.\" ======================================================================
+.\" ====================================================================
 .TP
-.FONT B \rs*UL R \*Ellipsis B \rs*ULX
+.FONT B \rs*UL R .\|.\|. B \rs*ULX
 invoke underlining inline (fixed width fonts only)
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" UP
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B \rs*UP I " n" B 
-temporarily move upwards in a line
+temporarily move upward in a line
 .
 .
 .\" ====================================================================
-.SS "Details of Macros in alphabetical Order"
+.SS "Details of macros in alphabetical order"
 .\" ====================================================================
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" AUTOLEAD
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B .AUTOLEAD
 set the linespacing relative to the point size
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Bottom Margin
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .B_MARGIN " <bottom margin>"
 Bottom Margin
@@ -1193,7 +1164,7 @@
 don't want your type to go.
 .
 When the bottom margin is reached,
-.B mom
+.I mom
 starts a new page.
 .
 .B .B_MARGIN requires a unit of measure.
@@ -1203,7 +1174,7 @@
 To set a nominal bottom margin of 3/4 inch, enter
 .RS
 .EX
-.B \&.B_MARGIN \&.75i
+.B .B_MARGIN .75i
 .EE
 .RE
 .
@@ -1233,9 +1204,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Fallback Font
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI \%.FALLBACK_FONT " <fallback font> " " ABORT | WARN "
 Fallback Font
@@ -1247,7 +1218,7 @@
 .B \%.FAMILY
 (i.e.\& a non-existent
 .IR family ),
-.BR mom ,
+.IR mom ,
 by default, uses the
 .IR "fallback font" ,
 .B Courier Medium Roman
@@ -1314,7 +1285,7 @@
 .
 .TP
 .B .FALLBACK_FONT WARN
-.B mom
+.I mom
 will issue a warning whenever you try to access a non-existent
 .I font
 but will continue processing your file with the default
@@ -1356,27 +1327,31 @@
 just enter
 .B \%".FALLBACK_FONT ABORT"
 and
-.B mom
+.I mom
 will once again abort on
 .IR "font errors" .
 .
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FAM
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .FAM " <family>"
-Type Family, alias of \fB.FAMILY\fR
+Type Family,
+alias of
+.B .FAMILY
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FAMILY
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .FAMILY " <family>"
-Type Family, alias \fB.FAM\fR
+Type Family,
+alias of
+.B .FAM
 .
 .RS
 .
@@ -1457,23 +1432,29 @@
 .IR I .
 .
 .P
-Additional note: If you are running a version of groff lower than
-1.19.2, you must follow all
+Additional note: If you are running a
+.I groff
+version prior to
+1.19.2,
+you must follow all
 .B .FAMILY
 requests with a
 .B .FT
-request, otherwise
-.B mom
+request,
+otherwise
+.I mom
 will set all type up to the next
 .B .FT
 request in the fallback font.
 .
 .P
-If you are running a version of groff greater than or equal to 1.19.2,
+If you are running
+.I groff
+1.19.2 or later,
 when you invoke the
 .B .FAMILY
 macro,
-.B mom
+.I mom
 .I remembers
 the font style
 .BR ( Roman ,
@@ -1494,7 +1475,7 @@
 .
 .P
 However, if the font style does not exist in the new family,
-.B mom
+.I mom
 will set all subsequent type in the fallback font (by default,
 .B Courier Medium
 .BR Roman )
@@ -1506,7 +1487,7 @@
 .P
 For example, assuming you don't have the font
 .B Medium Condensed Roman
-.RB  ( mom
+.RI ( mom
 extension
 .IR CD )
 in the
@@ -1534,9 +1515,10 @@
 Please see the Appendices,
 .I Adding fonts to
 .IR groff ,
-for information on adding fonts and families to groff, as well as to
+for information on adding fonts and families to
+.IR groff , as well as to
 see a list of the extensions
-.B mom
+.I mom
 provides to
 .IR groff 's
 basic
@@ -1594,18 +1576,18 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FONT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI ".FONT R | B | BI | " "<any other valid font style>"
 Alias to
 .B .FT
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" FT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI ".FT R | B | BI | " "<any other valid font style>"
 Set font
@@ -1659,7 +1641,7 @@
 .
 .P
 Have a look here for a list of the weight/style arguments
-.B mom
+.I mom
 allows.
 .
 Be aware, though, that you must have the fonts, correctly installed
@@ -1675,28 +1657,35 @@
 .B \%.FAMILY
 macro.
 .
+.
 .P
 How
-.B mom
+.I mom
 reacts to an invalid argument to
 .B .FT
-depends on which version of groff you're using.
+depends on which version of
+.I groff
+you're using.
 .
 If your
-.I groff version
-is greater than or equal to 1.19.2,
-.B mom
-will issue a warning and, depending on how you've set up the fallback
-font, either continue processing using the fallback font, or abort
-(allowing you to correct the problem).  If your
-.I groff version
-is less than 1.19.2,
-.B mom
-will silently continue processing, using either the fallback font or
-the font that was in effect prior to the invalid
+.I groff
+version is 1.19.2 or later,
+.I mom
+will issue a warning and,
+depending on how you've set up the fallback font,
+either continue processing using the fallback font,
+or abort
+(allowing you to correct the problem).
+.
+In earlier versions,
+.I mom
+will silently continue processing,
+using either the fallback font or the font that was in effect prior to
+the invalid
 .B .FT
 call.
 .
+.
 .P
 .B .FT
 will also accept, as an argument, a full
@@ -1734,9 +1723,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Hanging Indent
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.HI " " <measure> " 
 Hanging indent \em the optional argument requires a unit of measure.
@@ -1747,11 +1736,11 @@
 A hanging indent looks like this:
 .RS
 .EX
-\fB  The thousand injuries of Fortunato I had borne as best I
-    could, but when he ventured upon insult, I vowed
-    revenge.  You who so well know the nature of my soul
-    will not suppose, however, that I gave utterance to a
-    threat, at length I would be avenged\*Ellipsis
+The thousand injuries of Fortunato I had borne as best I
+  could, but when he ventured upon insult, I vowed
+  revenge.\&  You who so well know the nature of my soul
+  will not suppose, however, that I gave utterance to a
+  threat, at length I would be avenged.\|.\|.
 .EE
 .RE
 .
@@ -1802,7 +1791,7 @@
 .B \%.HI
 do not require you to supply a
 .IR measure ;
-.B mom
+.I mom
 keeps track of the last measure you gave it.
 .
 .P
@@ -1827,7 +1816,7 @@
 are NOT additive.
 .
 Each time you pass a measure to
-.B .HI ,
+.BR .HI ,
 the measure is treated literally.
 .
 .B
@@ -1837,7 +1826,7 @@
 .
 .P
 .I Note:
-.B mom
+.I mom
 has macros for setting lists.
 .
 This recipe exists to demonstrate the use of
@@ -1845,30 +1834,30 @@
 only.
 .RS
 .EX
-.B ".PAGE 8.5i 11i 1i 1i 1i 1i"
-.B ".FAMILY  T"
-.B ".FT      R"
-.B ".PT_SIZE 12"
-.B ".LS      14"
-.B ".JUSTIFY"
-.B ".KERN"
-.B ".SS 0"
-.B ".IL \rsw'\rs0\rs0.'"
-.B ".HI \rsw'\rs0\rs0.'"
-\fB1.\rs0The most important point to be considered is whether the
-answer to the meaning of Life, the Universe, and Everything
-really is 42.  We have no-one's word on the subject except
-Mr.\& Adams'.
-.B .HI
+\&.PAGE 8.5i 11i 1i 1i 1i 1i
+\&.FAMILY  T
+\&.FT      R
+\&.PT_SIZE 12
+\&.LS      14
+\&.JUSTIFY
+\&.KERN
+\&.SS 0
+\&.IL \rsw\aq\rs0\rs0.\aq
+\&.HI \rsw\aq\rs0\rs0.\aq
+1.\rs0The most important point to be considered is whether
+the answer to the meaning of Life, the Universe, and
+Everything really is 42.\&  We have no one\aqs word on the
+subject except Mr.\& Adams\aqs.
+\&.HI
 2.\rs0If the answer to the meaning of Life, the Universe,
 and Everything is indeed 42, what impact does this have on
-the politics of representation?  42 is, after all not a
-prime number.  Are we to infer that prime numbers don't
+the politics of representation?\&  42 is, after all not a
+prime number.\&  Are we to infer that prime numbers don\aqt
 deserve equal rights and equal access in the universe?
-.B .HI
-3.\rs0If 42 is deemed non-exclusionary, how do we present it
-as the answer and, at the same time, forestall debate on its
-exclusionary implications?
+\&.HI
+3.\rs0If 42 is deemed non-exclusionary, how do we present
+it as the answer and, at the same time, forestall debate
+on its exclusionary implications?
 .EE
 .RE
 .
@@ -1876,7 +1865,7 @@
 First, we invoke a left indent with a measure equal to the width of 2
 figures spaces plus a period (using the \rsw inline escape).
 .
-At this point, the left indent is active; text afterwards would
+At this point, the left indent is active; text afterward would
 normally be indented.
 .
 However, we invoke a hanging indent of exactly the same width, which
@@ -1886,7 +1875,7 @@
 .
 Because we begin the first line with a number, a period, and a figure
 space, the actual text
-.RI ( "The most important point\*Ellipsis" )
+.RI ( "The most important point.\|.\|.\&" )
 starts at exactly the same spot as the indented lines that follow.
 .
 .P
@@ -1908,9 +1897,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" IB - INDENT BOTH
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.IB " " <left measure> <right measure> " 
 Indent both \em the optional argument requires a unit of measure
@@ -1998,9 +1987,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" IL - INDENT LEFT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.IL " " <measure> " 
 Indent left \em the optional argument requires a unit of measure
@@ -2039,7 +2028,7 @@
 For example,
 .RS
 .EX
-.B .IL \rsw'margarine'
+.B .IL \rsw\aqmargarine\aq
 .EE
 .RE
 indents text by the width of the word
@@ -2051,7 +2040,7 @@
 indents by its last active value.
 .
 See the brief explanation of how
-.B mom
+.I mom
 handles indents for more details.
 .
 .P
@@ -2072,9 +2061,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" IQ - quit any/all indents
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.IQ " " <measure> " 
 IQ \em quit any/all indents
@@ -2091,7 +2080,7 @@
 .
 .B .IX
 will continue to behave as before, but
-.B mom
+.I mom
 will issue a warning to
 .I stderr
 indicating that you should update your documents.
@@ -2134,9 +2123,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" IR - INDENT RIGHT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.IR " " <measure> " 
 Indent right \em the optional argument requires a unit of measure
@@ -2173,7 +2162,7 @@
 For example,
 .RS
 .EX
-.B .IR \rsw'jello'
+.B .IR \rsw\aqjello\aq
 .EE
 .RE
 indents text by the width of the word
@@ -2185,7 +2174,7 @@
 indents by its last active value.
 .
 See the brief explanation of how
-.B mom
+.I mom
 handles indents for more details.
 .
 .P
@@ -2206,9 +2195,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Left Margin
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .L_MARGIN " <left margin>"
 Left Margin
@@ -2219,7 +2208,8 @@
 L_MARGIN establishes the distance from the left edge of the printer
 sheet at which you want your type to start.
 .
-It may be used any time, and remains in effect until you enter a new value.
+It may be used any time,
+and remains in effect until you enter a new value.
 .
 .P
 Left indents and tabs are calculated from the value you pass to
@@ -2231,7 +2221,9 @@
 .
 Decimal fractions are allowed.
 .
-Therefore, to set the left margin at 3 picas (1/2 inch), you'd enter either
+Therefore,
+to set the left margin at 3 picas (1/2 inch),
+you'd enter either
 .RS
 .EX
 .B .L_MARGIN 3P
@@ -2252,8 +2244,8 @@
 .B .PAPER
 without invoking
 .B .L_MARGIN
-(either before or afterwards),
-.B mom
+(either before or afterward),
+.I mom
 automatically sets
 .B .L_MARGIN
 to
@@ -2268,9 +2260,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" MCO - BEGIN MULTI-COLUMN SETTING
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B .MCO
 Begin multi-column setting.
@@ -2303,9 +2295,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" MCR - RETURN TO TOP OF COLUMN
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B \%.MCR
 Once you've turned
@@ -2313,13 +2305,14 @@
 on (with
 .BR \%.MCO ),
 .BR .MCR ,
-at any time, returns you to the
-.IR "top of your columns".
+at any time,
+returns you to the
+.IR "top of your columns" . \" XXX: Are italics truly required here?
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" MCX - EXIT MULTI-COLUMNS
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.MCX  " "<distance to advance below longest column>" " "
 Optional argument requires a unit of measure.
@@ -2327,6 +2320,9 @@
 .RS
 .
 .P
+Exit multi-columns.
+.
+.P
 .B .MCX
 takes you out of any
 .I tab
@@ -2393,9 +2389,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Start a new Page
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B .NEWPAGE
 .
@@ -2414,9 +2410,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Page
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI ".PAGE " <width> "  " <length> "  " <lm> "  " <rm> "  " \
              <tm> "  " <bm> "     "
@@ -2477,7 +2473,9 @@
 .RE
 .
 .P
-Now suppose you also want to set the top margin, say, at 1\(en1/2 inches.
+Now suppose you also want to set the top margin,
+say,
+at 1\(en1/2 inches.
 .
 .I <tm>
 comes after
@@ -2490,10 +2488,12 @@
 macro would look like this:
 .RS
 .EX
-\fCB.PAGE 11i 17i 1i 1i 1.5i
+.tr -\-
+\&.PAGE 11i 17i 1i 1i 1.5i
                  |   |
 required right---+   +---top margin
-        margin\fR
+        margin
+.tr --
 .EE
 .RE
 .
@@ -2501,7 +2501,7 @@
 Clearly,
 .B .PAGE
 is best used when you want a convenient way to tell
-.B mom
+.I mom
 just the dimensions of your printer sheet (width and length), or when
 you want to tell her everything about the page (dimensions and all the
 margins), for example
@@ -2535,7 +2535,8 @@
 .P
 Please read the
 .I Important note
-on page dimensions and papersize for information on ensuring groff
+on page dimensions and papersize for information on ensuring
+.I groff
 respects your
 .B .PAGE
 dimensions and margins.
@@ -2543,13 +2544,13 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Page Length
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .PAGELENGTH " <length of printer sheet>"
 tells
-.B mom
+.I mom
 how long your printer sheet is.
 .
 It works just like
@@ -2559,7 +2560,7 @@
 .
 .P
 Therefore, to tell
-.B mom
+.I mom
 your printer sheet is 11 inches long, you enter
 .RS
 .EX
@@ -2568,15 +2569,17 @@
 .RE
 .
 Please read the important note on page dimensions and papersize for
-information on ensuring groff respects your
+information on ensuring
+.I groff
+respects your
 .IR PAGELENGTH .
 .
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Page Width
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .PAGEWIDTH " <width of printer sheet>"
 .
@@ -2594,7 +2597,7 @@
 Decimal fractions are allowed.
 .
 Hence, to tell
-.B mom
+.I mom
 that the width of your printer sheet is 8\(12 inches, you enter
 .RS
 .EX
@@ -2604,15 +2607,17 @@
 .
 .P
 Please read the Important note on page dimensions and papersize for
-information on ensuring groff respects your
+information on ensuring
+.I groff
+respects your
 .IR PAGEWIDTH .
 .
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Paper
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .PAPER " <paper type>"
 provides a convenient way to set the page dimensions for some common
@@ -2641,9 +2646,9 @@
 .B .PRINTSTYLE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" PT_SIZE - POINT SIZE OF TYPE
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .PT_SIZE " <size of type in points>"
 Point size of type, does not require a
@@ -2686,7 +2691,7 @@
 .I Point sizes
 may be
 .I fractional
-(e.g.\&
+(e.g.,
 .I 10.25
 or
 .IR 12.5 ).
@@ -2706,12 +2711,13 @@
 .I \-
 the original value.
 .
-For example, if the
+For example,
+if the
 .I point size
 is
-.I 12 ,
+.IR 12 ,
 and you want
-.I 14 ,
+.IR 14 ,
 you can do
 .RS
 .EX
@@ -2763,9 +2769,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Right Margin
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .R_MARGIN " <right margin>"
 Right Margin
@@ -2788,7 +2794,8 @@
 .
 The reason is that
 .B .R_MARGIN
-calculates line length from the overall page dimensions and the left margin.
+calculates line length from the overall page dimensions and the left
+margin.
 .
 .P
 Obviously, it can't make the calculation if it doesn't know the page
@@ -2835,7 +2842,7 @@
 .
 On the other hand, if you know the line length for a patch of type
 should be 17 picas and 3 points, entering the line length with LL is
-much easier than calculating the right margin, e.g.\&
+much easier than calculating the right margin, e.g.,
 .RS
 .EX
 .B .LL 17P+3p
@@ -2850,8 +2857,8 @@
 .B PAPER
 without invoking
 .B .R_MARGIN
-afterwards,
-.B mom
+afterward,
+.I mom
 automatically sets
 .B .R_MARGIN
 to
@@ -2872,9 +2879,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" ST - Set String Tabs
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .FONT B .ST I " <tab number> " B "L | R | C | J  QUAD "
 .
@@ -2883,7 +2890,7 @@
 After
 .I string tabs
 have been marked off on an input line (see
-.BR \rs*ST\*Ellipsis\rs*STX ),
+.BR \rs*ST.\|.\|.\&\rs*STX ),
 you need to
 .I set
 them by giving them a direction and, optionally, the
@@ -2899,7 +2906,7 @@
 .B .ST
 an indent or a line length (that's already taken care of, inline,
 by
-.BR \rs*ST\*Ellipsis\rs*STX ).
+.BR \rs*ST.\|.\|.\&\rs*STX ).
 .
 .P
 If you want string
@@ -2934,9 +2941,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" TAB - Call Tabs
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI \%.TAB " <tab number>"
 After
@@ -2984,14 +2991,19 @@
 .EE
 .RE
 .
+.
 .P
-If you want the tabs to line up, use
+If you want the tabs to line up,
+use
 .B .TN
-.RI ( "Tab Next" )
-or, more conveniently, the inline escape \rs*TB+:
+(\lqTab Next\rq)
+or,
+more conveniently,
+the inline escape sequence
+.BR \rs*TB+ :
 .RS
 .EX
-\fB.TAB 1
+.BR .TAB \~1
 A line of text in tab 1.\rs*TB+
 A line of text in tab 2.
 .EE
@@ -2999,10 +3011,11 @@
 which produces
 .RS
 .EX
-.B "A line of text in tab 1.   A line of text in tab 2."
+.B "A line of text in tab 1.\&   A line of text in tab 2."
 .EE
 .RE
 .
+.
 .P
 If the text in your tabs runs to several lines, and you want the first
 lines of each tab to align, you must use the multi-column macros.
@@ -3039,7 +3052,7 @@
 To demonstrate:
 .RS
 .EX
-\fBTAB 1
+TAB 1
 Carrots
 Potatoes
 Broccoli
@@ -3052,7 +3065,7 @@
 produces, on output
 .RS
 .EX
-\fBCarrots
+Carrots
 Potatoes
 Broccoli
             $1.99/5 lbs
@@ -3063,18 +3076,18 @@
 .
 .RE
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" TB - Call Tabs Alias
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .TB " <tab number>"
 Alias to
 .B .TAB
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" TI - TEMPORARY (LEFT) INDENT
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI "\%.TI " " <measure> " 
 Temporary left indent \em the optional argument requires a
@@ -3110,7 +3123,7 @@
 Subsequent invocations of
 .B .TI
 do not require you to supply a measure;
-.B mom
+.I mom
 keeps track of the last measure you gave it.
 .
 .P
@@ -3136,9 +3149,9 @@
 .RS
 .EX
 .B .TI 1P
-.B The beginning of a paragraph\*Ellipsis
+.B The beginning of a paragraph.\|.\|.\&
 .B .TI 2P
-.B The beginning of another paragraph\*Ellipsis
+.B The beginning of another paragraph.\|.\|.\&
 .EE
 .RE
 .
@@ -3146,9 +3159,9 @@
 .
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" TN - Tab Next
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B .TN
 Tab Next
@@ -3187,7 +3200,7 @@
 .B .TN
 with the
 .B \rsc
-inline escape.
+inline escape sequence.
 .
 Conversely, if you did give a
 .B QUAD
@@ -3219,13 +3232,13 @@
 In other words, you cannot do
 .RS
 .EX
-\fB.TAB 1
+\&.TAB 1
 Some text\rsc
 \&.TN
 Some more text\rsc
 \&.TN
 \&.TN
-Yet more text\fR
+Yet more text
 .EE
 .RE
 .
@@ -3238,7 +3251,7 @@
 should be entered
 .RS
 .EX
-\fB.TAB 1
+\&.TAB 1
 Some text\rsc
 \&.TN
 Some more text\rsc
@@ -3258,9 +3271,9 @@
 .RE
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Tab Quit
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .B .TQ
 .B TQ
@@ -3278,9 +3291,9 @@
 .IR tabs .
 .
 .
-.\" ======================================================================
+.\" ====================================================================
 .\" Top Margin
-.\" ======================================================================
+.\" ====================================================================
 .TP
 .BI .T_MARGIN " <top margin>"
 Top margin
@@ -3346,56 +3359,69 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 .I mom
 was written by
-.MT peter@\:schaffter.ca
+.MT peter@\:schaffter\:.ca
 Peter Schaffter
 .ME .
 .
 PDF support was provided by
-.MT deri@\:chuzzlewit.demon.co.uk
+.MT deri@\:chuzzlewit\:.myzen\:.co\:.uk
 Deri James
 .ME .
 .
-The alphabetical documentation of macros and escape sequences in this
-man page were written by the
-.I mom
-team.
+This manual page was written by Bernd Warken.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR groff_mom (@MAN7EXT@),
-.
 .TP
-.I \%@HTMLDOCDIR@/\:mom/\:toc.html
-\en entry point to the HTML documentation
+.I @HTMLDOCDIR@/\:mom/\:toc\:.html
+entry point to the HTML documentation
+.
 .
 .TP
-.UR http://\:www.schaffter.ca/\:mom/\:momdoc/\:toc.html
+.UR http://\:www\:.schaffter\:.ca/\:mom/\:momdoc/\:toc\:.html
 .UE
-\en HTML documentation online
+HTML documentation online
+.
 .
 .TP
-.UR http://\:www.schaffter.ca/\:mom/
+.UR http://\:www\:.schaffter\:.ca/\:mom/
 .UE
-\en the mom macros homepage
+the
+.I mom
+macros homepage
 .
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_mom_C
+.P
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
 .
+You can browse it interactively with \lqinfo groff\rq.
+.
+.
+.P
+.MR pdfmom @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_mom_7_man_C
+.do rr *groff_groff_mom_7_man_C
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/mom.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/mom.am Changed

@@ -1,17 +1,17 @@
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
-#      Written by Werner Lemberg (wl@gnu.org)
+# Copyright (C) 2002-2020 Free Software Foundation, Inc.
+#      Written by Werner Lemberg <wl@gnu.org>
 #      Automake migration by Bertrand Garrigues
-#
+#        <bertrand.garrigues@laposte.net>
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -20,14 +20,14 @@
 
 mom_srcdir = $(top_srcdir)/contrib/mom
 
-# pdfmom command used to generated .pdf
-MOM_TFLAG = -M$(mom_srcdir)
-MOM_KFLAG = -k -p -e -t
+# pdfmom command used to generate .pdf
+#
+# Use '-K utf8', not '-k', in case 'configure' didn't find uchardet.
 MOMPDFMOM = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
   PDFMOM_BIN_PATH="$(top_builddir)" \
-  $(PDFMOMBIN) $(FFLAG) $(TFLAG) $(MOM_TFLAG) $(MOM_KFLAG)
+  $(PDFMOMBIN) $(FFLAG) $(MFLAG) -M$(mom_srcdir) -K utf8 -p -e -t
 
 man7_MANS += contrib/mom/groff_mom.7
 
@@ -40,7 +40,6 @@
 dist_momtmac_DATA = $(MOMNORMALFILES)
 
 # Files installed in htmldocdir/mom
-if INSTALL_SHIPPED_HTML
 MOMHTMLDOCFILES=\
   contrib/mom/momdoc/stylesheet.css \
   contrib/mom/momdoc/appendices.html \
@@ -67,7 +66,6 @@
   contrib/mom/momdoc/version-2.html
 momhtmldir = $(htmldocdir)/mom
 momhtml_DATA = $(MOMHTMLDOCFILES)
-endif
 
 # Files installed in $(examplesdir)/mom.  MOMEXAMPLEFILES are located
 # in the source tree, while MOMPROCESSEDEXAMPLEFILES are generated in
@@ -85,39 +83,44 @@
   contrib/mom/examples/penguin.ps \
   contrib/mom/examples/penguin.pdf \
   contrib/mom/examples/mom.vim \
-  contrib/mom/examples/slide-demo.mom
-if BUILD_EXAMPLES
+  contrib/mom/examples/slide-demo.mom \
+  contrib/mom/examples/copyright-default.mom \
+  contrib/mom/examples/copyright-chapter.mom
 momexampledir = $(exampledir)/mom
 dist_momexample_DATA = $(MOMEXAMPLEFILES)
-else
-EXTRA_DIST += $(MOMEXAMPLEFILES)
-endif
 
-if BUILD_PDFEXAMPLES
+if USE_GROPDF
 MOMPROCESSEDEXAMPLEFILES = \
   contrib/mom/examples/letter.pdf \
   contrib/mom/examples/mom-pdf.pdf \
   contrib/mom/examples/mon_premier_doc.pdf \
   contrib/mom/examples/sample_docs.pdf \
-  contrib/mom/examples/typesetting.pdf \
-  contrib/mom/examples/slide-demo.pdf
+  contrib/mom/examples/slide-demo.pdf \
+  contrib/mom/examples/copyright-default.pdf \
+  contrib/mom/examples/copyright-chapter.pdf
+if HAVE_URW_FONTS
+MOMPROCESSEDEXAMPLEFILES += contrib/mom/examples/typesetting.pdf
+endif
 momprocessedexampledir = $(exampledir)/mom
 nodist_momprocessedexample_DATA = $(MOMPROCESSEDEXAMPLEFILES)
+endif
+
+mom_test_template = contrib/mom/examples/test-mom.sh.in
 
-if HAVE_PDFTOOLS
 # Small test suite on mom examples
 mom_TESTS = contrib/mom/examples/tests-mom.sh
 TESTS += $(mom_TESTS)
-contrib/mom/examples/tests-mom.sh: $(top_builddir)/config.status \
-	$(MOMPROCESSEDEXAMPLEFILES)  $(top_srcdir)/contrib/mom/examples/test-mom.sh.in
-	sed -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
-            -e "s|@groff_have_urw_fonts@|$(groff_have_urw_fonts)|g" \
-	    	$(top_srcdir)/contrib/mom/examples/test-mom.sh.in > $@
-	chmod +x $@
+contrib/mom/examples/tests-mom.sh: \
+  $(top_builddir)/config.status \
+  $(MOMPROCESSEDEXAMPLEFILES) \
+  $(top_srcdir)/$(mom_test_template)
+	$(AM_V_GEN)sed \
+	  -e "s|@abs_top_builddir@|$(abs_top_builddir)|g" \
+	  -e "s|@groff_have_urw_fonts@|$(groff_have_urw_fonts)|g" \
+	  $(top_srcdir)/$(mom_test_template) > $@ \
+	&& chmod +x $@
 MOSTLYCLEANFILES += $(mom_TESTS)
-endif
-endif
-EXTRA_DIST += contrib/mom/examples/test-mom.sh.in
+EXTRA_DIST += $(mom_test_template)
 
 # For this list of files we add a symlink from $(exampledir)/mom to $(pdfdocdir)
 PDFDOCFILE = mom-pdf.pdf
@@ -135,24 +138,23 @@
   penguin.ps \
   penguin.pdf
 
-# Rule to generated .pdf files from .mom files
+# rule to generate .pdf files from .mom files
 SUFFIXES += .mom .pdf
 .mom.pdf:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
 	&& LC_ALL=C $(MOMPDFMOM) $< >$@
 
 $(MOMPROCESSEDEXAMPLEFILES): $(MOMNORMALFILES) \
-  groff troff gropdf pdfmom penguin.ps penguin.pdf \
-  gnu.eps font/devpdf/build_font_files
+  groff troff gropdf pdfmom penguin.ps penguin.pdf font/devpdf/stamp
 
 penguin.ps:
-	cp $(mom_srcdir)/examples/penguin.ps $@
+	$(AM_V_at)cp $(mom_srcdir)/examples/penguin.ps $@
 penguin.pdf:
-	cp $(mom_srcdir)/examples/penguin.pdf $@
+	$(AM_V_at)cp $(mom_srcdir)/examples/penguin.pdf $@
 
 install-data-hook: install_mom
 install_mom:
-if BUILD_PDFEXAMPLES
+if USE_GROPDF
 	for f in $(PDFDOCFILE); do \
 	  $(RM) $(DESTDIR)$(pdfdocdir)/$$f; \
 	  ln -s $(exampledir)/mom/$$f $(DESTDIR)$(pdfdocdir)/$$f; \
@@ -164,6 +166,7 @@
 	for f in $(PDFDOCFILE); do \
 	  $(RM) $(DESTDIR)$(pdfdocdir)/$$f; \
 	done
+	-rmdir $(DESTDIR)$(pdfdocdir)
 	if test -d $(DESTDIR)$(exampledir)/mom; then \
 	  rmdir $(DESTDIR)$(exampledir)/mom; \
 	fi
@@ -172,9 +175,8 @@
 	fi
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
-# vim: set filetype=automake:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/appendices.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/appendices.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/color.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/color.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/cover.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/cover.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/definitions.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/definitions.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/docelement.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/docelement.html Changed

@@ -2,7 +2,7 @@
 
 
 <div class="macro-id-overline">
@@ -750,7 +748,7 @@
 invoke <kbd>.FAMILY</kbd> immediately after <kbd>.PP</kbd> in every
 paragraph whose family you wish to differ from the prevailing
 document family.  Alternatively, set the family and font for
-paragraphs with PP_FONT, giving it a complete family+font name, e.g.,
+paragraphs with PP_FONT, giving it a complete family+font name, e.g.
 <br/>
 <span class="pre-in-pp">
   PP_FONT TI
@@ -799,7 +797,7 @@
 <span class="note">Note:</span>
 PP_FONT has no effect when the PRINTSTYLE is <kbd>TYPEWRITE</kbd>.
 If you wish to set whole typewritten paragraphs in italic, invoke
-invoke <kbd>.FT I</kbd> immediately after <kbd>.PP</kbd>.  Depending
+<kbd>.FT I</kbd> immediately after <kbd>.PP</kbd>.  Depending
 on which of
 <a href="docprocessing.html#printstyle-italics">UNDERLINE_ITALIC</a>
 or
@@ -812,12 +810,12 @@
 <h4 id="pp-color" class="docs" style="margin-top: -.25em;">3. Paragraph colour</h4>
 
 <p>
-Mom has no special control macro for colourizing paragraphs.  If you
-wish a colourized paragraph, you must use the macro
+Mom has no special control macro for colourising paragraphs.  If you
+wish a colourised paragraph, you must use the macro
 <a href="color.html#color">COLOR</a>
 or the
 <a href="definitions.html#inline">inline escape</a>,
-<a href="color.html#color-inline"><kbd>\*&lt;colourname&gt;</kbd></a>,
+<a href="color.html#color-inline"><kbd><span class="nobr">\*&lt;colourname&gt;</span></kbd></a>,
 <i>after</i> <kbd>.PP</kbd>.  The colour must be one pre-defined (or
 &#8220;initialized&#8221;) with
 <a href="color.html#newcolor">NEWCOLOR</a>
@@ -877,9 +875,9 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Warning:</span>
-Changing a paragraph&#8217;s leading will almost certaininly screw
-up mom&#8217;s ability to balance the bottom margin of pages.
-Should you absolutely require a change of paragraph&#8217;s leading and
+Changing a paragraph&#8217;s leading will almost certainly screw up
+mom&#8217;s ability to balance the bottom margin of pages.  Should
+you absolutely require a change to a paragraph&#8217;s leading and
 need to get mom back on track leading-wise afterwards, use the
 <a href="docprocessing.html#shim">SHIM</a>
 or
@@ -895,10 +893,10 @@
 is 16 points, adjusted to fill the page.
 </p>
 
-<h4 id="pp-just-quad" class="docs" style="margin-top: -.25em;">5. Justification/quad</h4>
+<h4 id="pp-just-quad" class="docs" style="margin-top: -.25em;">5. Justification / quad</h4>
 
 <p>
-The justification/quad-direction of regular text paragraphs (ie
+The justification/quad-direction of regular text paragraphs (i.e.
 <a href="definitions.html#just">justified</a>,
 or
 <a href="definitions.html#filled">filled</a>
@@ -1007,12 +1005,12 @@
 
 <p>
 If you wish to have first paragraphs indented, invoke the macro
-<kbd>.INDENT_FIRST_PARAS</kbd> without an argument, either before or
-after
+INDENT_FIRST_PARAS without an argument, either before or after
 <a href="docprocessing.html#start">START</a>.
 INDENT_FIRST_PARAS is a toggle macro, therefore passing it any
-argument (<b>OFF, QUIT, Q, X</b>...) cancels its effect, meaning
-that first paragraphs will once again not be indented.
+argument (<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>Q</kbd>,
+<kbd>X</kbd>...) cancels its effect, meaning that first paragraphs
+will once again not be indented.
 </p>
 
 <h4 id="pp-space" class="docs">8. Inter-paragraph spacing</h4>
@@ -1020,11 +1018,12 @@
 <p>
 By default, mom does not insert a blank line between
 paragraphs.  If you would like her to do so, invoke the macro
-<kbd>.PARA_SPACE</kbd> without an argument, either before or after
+PARA_SPACE without an argument, either before or after
 <a href="docprocessing.html#start">START</a>.
 PARA_SPACE is a toggle macro, therefore passing it any argument
-(<b>OFF, QUIT, Q, X</b>...) cancels its effect, meaning that
-paragraphs will once again not be separated by a blank line.
+(<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>Q</kbd>, <kbd>X</kbd>...)
+cancels its effect, meaning that paragraphs will once again not be
+separated by a blank line.
 </p>
 
 <p>
@@ -1065,7 +1064,7 @@
 after an initial paragraph.  Initial paragraphs are those that come
 immediately after the
 <a href="definitions.html#docheader">docheader</a>
-(ie the start of a document),
+(i.e. the start of a document),
 <a href="#epigraph-intro">epigraphs</a>,
 <a href="#heading-intro">headings</a>,
 and
@@ -1105,11 +1104,13 @@
 </ul>
 
 <p>
-Heads, subheads, and deeper levels of section headings are handled by 
-a single macro HEADING to which you pass an argument stating the
-desired level.  <kbd>.HEADING 1 &quot;&lt;text&gt;&quot;</kbd>, for
-example, would be a main head; <kbd>.HEADING 2
-&quot;&lt;text&gt;&quot;</kbd> would be a subhead; etc.
+Heads, subheads, and deeper levels of section headings are
+handled by a single macro, HEADING, to which you pass an argument
+stating the desired level.
+<kbd><span class="nobr">.HEADING 1 &quot;&lt;text&gt;&quot;</span></kbd>,
+for example, would be a main head;
+<kbd><span class="nobr">.HEADING 2 &quot;&lt;text&gt;&quot;</span></kbd>
+would be a subhead; etc.
 </p>
 
 <p>
@@ -1124,7 +1125,7 @@
 
 <p>
 Headings can also be numbered on a per-heading-level basis,
-hierarchically and concatenatively, e.g.,
+hierarchically and concatenatively, e.g.
 <br/>
 <span class="pre-in-pp">
   1.
@@ -1140,7 +1141,7 @@
 Mom initially sets up a very basic style for nine levels of heading,
 of which you can have an infinite number, although as has been said,
 if you need more than four levels of heading, you should consider
-re-organizing your material.  The pared-down style of mom&#8217;s
+re-organising your material.  The pared-down style of mom&#8217;s
 defaults is intentional; it is expected that you will design
 headings to your own specifications with the
 <a href="definitions.html#controlmacro">control macro</a>,
@@ -1164,7 +1165,7 @@
 
 <div class="box-macro-args">
 Macro: <b>HEADING</b> <kbd class="macro-args">&lt;level&gt; 
-PARAHEAD   NAMED &lt;pdf-id&gt;  &quot;&lt;heading text&gt;&quot;
+PARAHEAD   NAMED &lt;pdf-id&gt;  &quot;&lt;heading text&gt;&quot;</kbd>
 </div>
 
 <p>
@@ -1194,8 +1195,8 @@
 </p>
 
 <p>
-The optional third argument, <kbd>NAMED &lt;id&gt;</kbd>, gives the
-heading a unique, non-printing identifier that allows it to
+The optional third argument, <kbd>NAMED &lt;id&gt;</kbd>, gives
+the heading a unique, non-printing identifier that allows it to be
 referenced from anywhere in the final PDF document with the PDF_LINK
 macro, provided the mom file is processed with
 <a href="using.html#pdfmom" style="font-weight: bold">pdfmom</a>.
@@ -1269,7 +1270,7 @@
 difference is usually not apparent.  Alternatively, you may pass the
 <kbd>NO_SHIM</kbd> or <kbd>NO_FLEX</kbd> argument to
 <a href="#heading-style">HEADING_STYLE</a>
-to prevent shimming or flex-spacing of any particlar heading level
+to prevent shimming or flex-spacing of any particular heading level
 either globally or selectively.  If shimming/flex-spacing is
 disabled selectively with
 <br/>
@@ -1326,7 +1327,8 @@
   CAPS | NO_CAPS \
   SMALLCAPS | NO_SMALLCAPS \
   BASELINE_ADJUST &lt;amount to raise heading from the baseline&gt; \
-  NEEDS &lt;lines of text required beneath the heading &gt;
+  NEEDS &lt;lines of text required beneath the heading&gt; \
+  PREFIX_CHAPTER &lt;n&gt; \
   SPACE_AFTER | NO_SPACE_AFTER \
   NUMBER | NO_NUMBER \
   NO_SHIM | SHIM \
@@ -1337,7 +1339,7 @@
 <p>
 You may enter your entire argument list on a single line, or, if it
 is very long, break it into shorter lines with the
-&#8220;line-continued&#8221; backslash {<kbd>\</kbd>), as shown
+&#8220;line-continued&#8221; backslash (<kbd>\</kbd>), as shown
 above.
 </p>
 
@@ -1355,10 +1357,10 @@
 <kbd>UNDERSCORE</kbd> and <kbd>UNDERSCORE2</kbd> require that a
 weight for the underscore be given, in points (decimal fractions
 allowed), but without the unit of measure <kbd>p</kbd> appended.
-They also require that the underscore's distance from the baseline
-be supplied; in the case of UNDERSCORE2, an additional gap argument
-representing the distance between the two underscores must be
-provided.
+They also require that the underscore&#8217;s distance from the
+baseline be supplied; in the case of UNDERSCORE2, an additional gap
+argument representing the distance between the two underscores must
+be provided.
 </p>
 
 <p class="defaults" style="margin-bottom: 1em">
@@ -1383,21 +1385,38 @@
 
 <p class="defaults" style="margin-bottom: 1em">
 <kbd>NEEDS</kbd> lets you reserve the number of lines of text
-required beneath a heading, including fractions thereof (e.g.,
+required beneath a heading, including fractions thereof (e.g.
 &#8220;1.5&#8221; for one line of text plus half a linespace).
 If a heading falls near the bottom margin and there isn&#8217;t
 sufficient room for both the heading and the reserved space, mom
 will break to a new page for the heading.  A
 <a href="definitions.html#unitofmeasure">unit of measure</a>
 should not be appended to the argument.
+<span class="note"><i>Note:</i></span> If you have
+<a href="goodies.html#dropcap">DROPCAP</a>s
+after headings, you must increase the value of <kbd>NEEDS</kbd>
+to match the number of dropcap lines.
+</p>
+
+<p class="defaults" style="margin-bottom: 1em">
+<kbd>PREFIX_CHAPTER</kbd> instructs mom to prefix the current
+chapter number to numbered headings.  If mom is unable to determine
+a chapter number, she will ask for one.
+</p>
+
+<p class="defaults" style="margin-bottom: 1em">
+Note that using <kbd>PREFIX_CHAPTER</kbd> with an explicit chapter
+number will also set the chapter number for subsequent
+<a href="images.html#autolabel">automatically-generated image and pre-processor labels</a>
+as well.
 </p>
 
 <p class="defaults" style="margin-bottom: 1em">
 <kbd>SPACE_AFTER</kbd> inserts a blank line equal to the current
 <a href="definitions.html#leading">leading</a> after a HEADING.
-If you'd like a full linespace after a heading level, use
-<kbd>SPACE_AFTER</kbd>.  If you'd like additional space before a
-heading level, you must introduce it yourself with
+If you&#8217;d like a full linespace after a heading level, use
+<kbd>SPACE_AFTER</kbd>.  If you&#8217;d like additional space before
+a heading level, you must introduce it yourself with
 <a href="typesetting.html#space">SPACE</a>
 or
 <a href="typesetting.html#ald">ALD</a>.
@@ -1426,7 +1445,7 @@
 <p class="defaults" style="padding-bottom: .5em">
 The argument list is long, so you may want to break it into
 several lines by using the backslash character (<kbd>\</kbd>).
-Here's an example of how you might style a level 1 heading:
+Here&#8217;s an example of how you might style a level 1 heading:
 <br/>
 <span class="pre defaults">
   .HEADING_STYLE 1 \
@@ -1436,7 +1455,7 @@
   BASELINE_ADJUST 3p \
   NUMBER
 </span>
-This creates a level-1 heading style that's bold, centred,
+This creates a level-1 heading style that&#8217;s bold, centred,
 underscored and numbered, raised by 3 points from the baseline.
 </p>
 </div>
@@ -1453,16 +1472,25 @@
 </div>
 
 <p>
-If you&#8217;ve requested numbering for any level of heading and
-you&#8217;d like mom, in addition, to prefix a chapter number to the
-numbering scheme, you can do so with PREFIX_CHAPTER_NUMBER.
+If, in addition to numbering heads, you want mom to prepend the
+chapter number, invoke <kbd>.PREFIX_CHAPTER_NUMBER</kbd>.
+</p>
+
+<p>
+When you invoke <kbd>.PREFIX_CHAPTER_NUMBER</kbd> without an
+argument, mom checks to see whether the argument you passed to <a
+href="docprocessing.html#chapter">CHAPTER</a> (if it&#8217;s been
+called) is a digit.  If it isn&#8217;t (say you&#8217;ve numbered your
+chapter &#8220;One&#8221; instead of &#8220;1&#8221;), mom will
+abort with a request that you pass PREFIX_CHAPTER_NUMBER a digit
+representing the chapter number.
 </p>
 
 <p>
 After you invoke <kbd>.PREFIX_CHAPTER_NUMBER</kbd>, mom will prepend
-the current chapter number to all headings you have requested be
-numbered with
-<a href="#heading-style"><kbd>.HEADING_STYLE &lt;n&gt; NUMBER</a>.
+the chapter number to all headings you have requested be numbered
+with
+<a href="#heading-style"><kbd>.HEADING_STYLE &lt;n&gt; NUMBER</kbd></a>.
 Thus, assuming chapter number twelve (12):
 <br/>
 <span class="pre-in-pp">
@@ -1477,31 +1505,27 @@
 </span>
 </p>
 
-<p>
-When you invoke <kbd>.PREFIX_CHAPTER_NUMBER</kbd> without an
-argument, mom checks to see whether the argument you passed to
-<a href="docprocessing.html#chapter">CHAPTER</a>
-is a digit.  If it is, she immediately starts pre-pending the
-current chapter number to numbered head elements.  If it isn&#8217;t
-(say you&#8217;ve called your chapter &#8220;One&#8221; instead
-of &#8220;1&#8221;), mom will abort with a request that you pass
-PREFIX_CHAPTER_NUMBER a digit representing the current chapter
-number.
+<div class="box-tip">
+<p class="tip">
+<span class="note">Note:</span>
+If a chapter number is given to PREFIX_CHAPTER_NUMBER, automatically
+generated labels with a prepended chapter number are also affected.
 </p>
+</div>
 
 <p>
-In collated documents, mom automatically increments
-the digit used by PREFIX_CHAPTER_NUMBER by one
-(current chapter digit + 1) every time you invoke <a
-href="rectoverso.html#collate"><kbd>.COLLATE</kbd></a>, even if
-you&#8217;ve (temporarily) turned off the prefixing of chapter
-numbers.  Thus, even if you call your chapters &#8220;One&#8221;,
-&#8220;Two&#8221;, &#8220;Three&#8221; instead of &#8220;1&#8221;,
-&#8220;2&#8221;, &#8220;3&#8221;, mom will Do The Right Thing
-with respect to numbering head elements in all collated chapters
-following the first invocation of PREFIX_CHAPTER_NUMBER (assuming,
-of course, that the collated chapters are in incrementing order; if
-not, you must must put
+In collated documents, mom automatically increments the digit used
+by PREFIX_CHAPTER_NUMBER by one (current chapter digit + 1) every
+time you invoke
+<a href="rectoverso.html#collate"><kbd>.COLLATE</kbd></a>,
+even if you&#8217;ve (temporarily) turned off the prefixing
+of chapter numbers.  Thus, even if you number your chapters
+&#8220;One&#8221;, &#8220;Two&#8221;, &#8220;Three&#8221; instead of
+&#8220;1&#8221;, &#8220;2&#8221;, &#8220;3&#8221;, mom will Do The
+Right Thing with respect to numbering head (and label) elements
+in all collated chapters following the first invocation of
+PREFIX_CHAPTER_NUMBER (assuming, of course, that the collated
+chapters are in incrementing order; if not, you must put
 <br/>
 <span class="pre-in-pp">
   .PREFIX_CHAPTER_NUMBER &lt;chapter number&gt;
@@ -1512,14 +1536,15 @@
 
 <p>
 PREFIX_CHAPTER_NUMBER can be disabled by passing it any argument
-other than a digit (e.g., <b>OFF, QUIT, END, X</b>, etc), although,
-as noted above, mom will keep, and&mdash;in the case of collated
-documents&mdash;increment the chapter number, allowing you to turn
-prefixing of chapter numbers to numbered head elements off and on
-according to your needs or whims.
+other than a digit (e.g. (<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>Q</kbd>,
+<kbd>X</kbd>...), although, as noted above, mom will keep,
+and&mdash;in the case of collated documents&mdash;increment the
+chapter number, allowing you to turn prefixing of chapter numbers to
+numbered head elements off and on according to your needs or whims.
 </p>
 
-<p>
+<div class="box-tip">
+<p class="tip">
 <span class="note">Note:</span>
 Because PREFIX_CHAPTER_NUMBER takes an (optional) digit representing
 the chapter number, it&#8217;s use need not be restricted to
@@ -1533,7 +1558,7 @@
 <a href="definitions.html#numericargument">numeric argument</a>
 in your document setup. 
 </p>
-
+</div>
 <div class="rule-short"><hr/></div>
 
 
@@ -1570,19 +1595,20 @@
 <a href="#subhead">SUBHEAD</a> (now HEADING 2),
 and
 <a href="#subsubhead">SUBSUBHEAD</a> (now HEADING 3).
-Mom also emits a message to stderr alerting you to what she's doing.
+Mom also emits a message to stderr alerting you to what she&#8217;s
+doing.
 </p>
 
 <p>
 The control macros formerly associated with oldstyle headings are no
-longer present in mom's macro file, which means that if you
-made changes to mom's default for those headings, you must recreate
-the changes with the
+longer present in mom&#8217;s macro file, which means that if you
+made changes to mom&#8217;s default for those headings, you must
+recreate the changes with the
 <a href="#heading-style">HEADING_STYLE</a>
 macro.  The entire style need not be recreated, only those
-parameters that differed from mom's defaults.  Thus, if your HEADs
-were set flush left, instead of the oldstyle default, centred, but
-otherwise kept mom's settings, you need only do
+parameters that differed from mom&#8217;s defaults.  Thus, if your
+HEADs were set flush left, instead of the oldstyle default, centred,
+but otherwise kept mom&#8217;s settings, you need only do
 <br/>
 <span class="pre-in-pp">
   .HEADING_STYLE 1 QUAD L
@@ -1606,7 +1632,7 @@
 Equally, the macro NUMBER_PARAHEADS is no longer available.  You
 must enable numbering of the correct level for paraheads with
 HEADING_STYLE.  Again assuming a heading level of 3 for paraheads,
-it's simply done:
+it&#8217;s simply done:
 <br/>
 <span class="pre-in-pp">
   .HEADING_STYLE 3 NUMBER
@@ -1748,7 +1774,7 @@
 <br/>
 <span class="pre-in-pp">
   FAMILY          = prevailing document family
-  FONT            = bold (TYPESET); italic, ie underlined (TYPEWRITE)
+  FONT            = bold (TYPESET); italic, i.e. underlined (TYPEWRITE)
   SIZE            = +.5 (TYPESET); +0 (TYPEWRITE)
   QUAD            = L 
   BASELINE_ADJUST = 1/8 the current leading
@@ -1824,7 +1850,7 @@
 <p>
 Linebreaks (&#8220;author linebreaks&#8221;, &#8220;section
 breaks&#8221;) are gaps in the vertical flow of running text that
-indicate a shift in content (e.g., a scene change in story).  They
+indicate a shift in content (e.g. a scene change in story).  They
 are frequently set off by typographic symbols, sometimes whimsical
 in nature.
 </p>
@@ -1884,8 +1910,8 @@
 </p>
 
 <p>
-The first argument is any valid groff character (e.g., <kbd>*</kbd>
-an asterisk, <kbd>\dg</kbd> a dagger, <kbd>\fZD\N'141\fP</kbd>
+The first argument is any valid groff character (e.g. <kbd>*</kbd>
+an asterisk, <kbd>\dg</kbd> a dagger, <kbd>\fZD\N'141'\fP</kbd>
 an arbitrary character from Zapf Dingbats, <kbd>\l'4P'</kbd> a
 4-pica long rule). Mom sets the character centred on the current
 line length.  (See <kbd>man groff_char</kbd> for a list of all
@@ -1897,7 +1923,7 @@
 </p>
 
 <p>
-The third argument is a +|-value by which to raise (+) or lower (-)
+The third argument is a +|-value by which to raise (-) or lower (+)
 the character in order to make it appear visually centred between
 sections of text.  This lets you make vertical adjustments to
 characters that don&#8217;t sit on the
@@ -1918,7 +1944,7 @@
 <span class="pre-in-pp">
   .LINEBREAK_CHAR * 3 -3p
 </span>
-ie three asterisks, lowered 3 points from their normal vertical
+i.e. three asterisks, raised 3 points from their normal vertical
 position (for
 <a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPESET</kbd></a>;
 the vertical adjustment is -2 points for
@@ -1979,7 +2005,7 @@
 
 <p>
 Since mom originally came into being to serve the needs of creative
-writers (ie novelists, short story writers, etc.&mdash;not
+writers (i.e. novelists, short story writers, etc.&mdash;not
 to cast aspersions on the creativity of mathematicians and
 programmers), she sets quotes in italics
 <a href="docprocessing.html#printstyle">(PRINTSTYLE <kbd>TYPESET</kbd>)</a>
@@ -1988,7 +2014,7 @@
 indented from the left margin.  Obviously, she&#8217;s thinking
 &#8220;quotes from poetry or song lyrics&#8221;, but with the
 <a href="#quote-control">QUOTE control macros</a>
-you can change her defaults so QUOTE serves other needs, e.g.,
+you can change her defaults so QUOTE serves other needs, e.g.
 entering verbatim snippets of programming code, command-line
 instructions, and so on.  (See the
 <a href="#code">CODE</a>
@@ -2007,7 +2033,7 @@
 <a href="docprocessing.html#printstyle">PRINTSTYLE <kbd>TYPESET</kbd></a>,
 it&#8217;s 1/2 of the prevailing
 <a href="definitions.html#leading">leading</a>
-if the quote fits fully on the page (ie with running text above
+if the quote fits fully on the page (i.e. with running text above
 and below it), otherwise it&#8217;s a full linespace either above
 or below as is necessary to balance the page to the bottom margin.
 This behaviour can be changed with the control macro
@@ -2033,10 +2059,10 @@
 
 <p class="tip-bottom">
 If you don&#8217;t want the behaviour
-described above (ie you don&#8217;t want mom putting additional shim
+described above (i.e., you don&#8217;t want mom putting additional shim
 or flex-spacing around quotes and
 blockquotes), put <kbd>.NO_SHIM</kbd> or/and <kbd>.NO_FLEX</kbd>
-in the style sheet section of your document (ie after PRINTSTYLE
+in the style sheet section of your document (i.e. after PRINTSTYLE
 but before START), which will disable shimming or/and flex-spacing
 globally for all tags, or disable shimming/flex-spacing
 on a per-instance basis prior to <kbd>.QUOTE</kbd> or
@@ -2054,11 +2080,11 @@
 start on one page and finish on the next.  If you wish to keep the
 text together as a block, deferred to the following page if the
 block doesn&#8217;t all fit on one page, wrap
-(BLOCK)QUOTE&nbsp;/&nbsp;(BLOCK)QUOTE&nbsp;OFF
+<kbd><span class="nobr">(BLOCK)QUOTE...(BLOCK)QUOTE&nbsp;OFF</span></kbd>
 inside a
-<a href="images.html#floats-intro">float</a>.  If you further wish to
-force a page break before the floated quote or blockquote (leaving
-whitespace at the bottom of the page, pass
+<a href="images.html#floats-intro">float</a>.
+If you further wish to force a page break before the floated quote
+or blockquote (leaving whitespace at the bottom of the page, pass
 <a href="images.html#float">FLOAT</a>
 the <kbd>FORCE</kbd> argument.
 <span class="pre-in-pp">
@@ -2081,7 +2107,9 @@
 with the macros
 <a href="images.html#label">LABEL</a>
 and
-<a href="images.html#caption">CAPTION</a>.
+<a href="images.html#caption">CAPTION</a>
+(see
+<a href="images.html#float-label-caption">Labelling and captioning floats</a>).
 </p>
 
 
@@ -2101,7 +2129,7 @@
 <p>
 QUOTE is a toggle macro.  To begin a section of quoted text, invoke
 it with no argument, then type in your quote.  When you&#8217;re
-finished, invoke <kbd>.QUOTE</kbd> with any argument (e.g., <kbd>OFF,
+finished, invoke <kbd>.QUOTE</kbd> with any argument (e.g. <kbd>OFF,
 END, X, Q</kbd>...) to turn it off.  Example:
 <br/>
 <span class="pre-in-pp">
@@ -2164,7 +2192,7 @@
 <span class="pre defaults">
 .QUOTE_FAMILY   default = prevailing document family; default is Times Roman
 .QUOTE_FONT     default = italic; underlined in TYPEWRITE
-.QUOTE_SIZE     default = +0 (ie same size as paragraph text)
+.QUOTE_SIZE     default = +0 (i.e. same size as paragraph text)
 <a id="quote-autolead">.QUOTE_AUTOLEAD default = none; leading of quotes is the same as paragraphs </a>
 .QUOTE_COLOR    default = black
 .QUOTE_INDENT  (see below, "Quote indent")
@@ -2186,8 +2214,19 @@
 <a href="definitions.html#picaspoints">picas</a>
 for TYPEWRITE) to arrive at the quote indent, or a distance with a
 <a href="definitions.html#unitofmesaure">unit of measure</a>
-appended.  Both result in quotes being indented equally from the
-left and right margins.
+appended.
+</p>
+
+<p>
+Be careful when using QUOTE.  If a quote is set flush left (the
+default), the QUOTE_INDENT applies only to the left margin.  Because
+quote lines are output as-is (see
+<a href="definitions.html#no-fill">no-fill mode</a>),
+they do not respect line length and may extend beyond a document's
+right margin.  Similarly, if a quote is being set flush right, the
+indent applies only to the right margin; long lines may extend into
+the left margin.  Centered quotes are never indented, so long lines
+may extend beyond both the left and right margins.
 </p>
 
 <p>
@@ -2200,7 +2239,7 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Note:</span>
-If your PARA_INDENT is 0 (ie no indenting of the first line of
+If your PARA_INDENT is 0 (i.e. no indenting of the first line of
 paragraphs), you <i>must</i> set a QUOTE_INDENT yourself, with a
 unit of measure appended to the argument. Mom has no default for
 QUOTE_INDENT if paragraph first lines are not being indented.
@@ -2219,7 +2258,8 @@
 with no argument.  If you wish to restore mom&#8217;s
 default behaviour regarding the spacing of quotes (see
 <a href="#quote-spacing">Quote spacing</a>),
-invoke the macro with any argument (<kbd>OFF, QUIT, END, X</kbd>...)
+invoke the macro with any argument (<kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>...)
 </p>
 
 <div class="box-tip">
@@ -2236,10 +2276,10 @@
 By default in
 <a href="docprocessing.html#printstyle">PRINTSTYLE TYPEWRITE</a>,
 mom underlines quotes.  If you&#8217;d rather she didn&#8217;t,
-invoke <kbd>.UNDERLINE_QUOTES</kbd> with any argument (<b>OFF,
-QUIT, END, X</b>...) to disable the feature.  Invoke it without
-an argument to restore mom&#8217;s default underlining of
-quotes.
+invoke <kbd>.UNDERLINE_QUOTES</kbd> with any argument
+(<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>...)
+to disable the feature.  Invoke it without an argument to restore
+mom&#8217;s default underlining of quotes.
 </p>
 
 <p>
@@ -2248,7 +2288,7 @@
 the typesetting macro
 <a href="typesetting.html#font">FT I</a>.
 Furthermore, since mom underlines all instances of italics by
-default in <b>PRINTSTYLE TYPEWRITE</b>, you must also make sure that
+default in PRINTSTYLE&nbsp;TYPEWRITE, you must also make sure that
 ITALIC_MEANS_ITALIC is enabled (see
 <a href="docprocessing.html#typewrite-control">PRINTSTYLE TYPEWRITE control macros</a>).
 </p>
@@ -2260,7 +2300,7 @@
 <h2 id="blockquote-intro" class="macro-group">Blockquotes (cited material)</h2>
 
 <ul style="margin-left: -.5em;">
-  <li><a href="#blockquote-description">Introduction</a>
+  <li><a href="#blockquote-description">Introduction</a></li>
   <li><a href="#blockquote">Tag: BLOCKQUOTE</a></li>
   <li><a href="#blockquote-control">BLOCKQUOTE control macros</a></li>
 </ul>
@@ -2322,7 +2362,7 @@
 BLOCKQUOTE is a toggle macro.  To begin a cited passage, invoke
 the tag with no argument, then type in your blockquote.  When
 you&#8217;re finished, invoke <kbd>.BLOCKQUOTE</kbd> with any
-argument (e.g., <kbd>OFF, END, X, Q</kbd>...) to turn it off.
+argument (e.g. <kbd>OFF, END, X, Q</kbd>...) to turn it off.
 Example:
 <br/>
 <span class="pre-in-pp">
@@ -2365,7 +2405,7 @@
 <span class="note">Note:</span>
 The aliases CITE and CITATION may be used in place of the BLOCKQUOTE
 tag, as well as in any of the control macros that begin or end with
-<kbd>BLOCKQUOTE_</kbd>.
+BLOCKQUOTE_.
 </p>
 </div>
 
@@ -2406,7 +2446,7 @@
 <kbd>BLOCKQUOTE_INDENT</kbd> takes one of two kinds of argument: an
 integer representing the amount by which to multiply the argument
 passed to
-<a href="#para-indent"><kbd>.PARA_INDENT</kbd></a>
+<a href="#para-indent">PARA_INDENT</a>
 (by default, 2
 <a href="definitions.html#em">ems</a>
 for TYPESET, 3
@@ -2427,8 +2467,8 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Note:</span>
-If your PARA_INDENT is 0 (ie no indenting of the first line of
-paragraphs), you <i>must</i> set a BLOCKQUOTE_INDENT yourself, with
+If your PARA_INDENT is 0 (i.e. no indenting of the first line of
+paragraphs), you must set a BLOCKQUOTE_INDENT yourself, with
 a unit of measure appended to the argument.  Mom has no default for
 BLOCKQUOTE_INDENT if paragraph first lines are not being indented.
 </p>
@@ -2448,8 +2488,8 @@
 with no argument.  If you wish to restore mom&#8217;s default
 behaviour regarding the spacing of blockquotes (see
 <a href="#quote-spacing">Quote spacing</a>),
-invoke the macro with any argument (<b>OFF, QUIT, END,
-X</b>...).
+invoke the macro with any argument (<kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>...).
 </p>
 
 <div class="box-tip">
@@ -2483,7 +2523,7 @@
 </div>
 
 <div class="box-macro-args">
-Macro: <b>CODE</b> <kbd class="macro-args">BR | BREAK | SPREAD toggle</kbd>
+Macro: <b>CODE</b> <kbd class="macro-args">BR | BREAK | SPREAD &lt;anything&gt;</kbd>
 </div>
 
 <p class="requires" style="font-style: normal">
@@ -2491,8 +2531,9 @@
 </p>
 
 <p>
-When you invoke the macro <kbd>.CODE</kbd> or insert <kbd>\*CODE</kbd> into
-running text, mom switches to a
+When you invoke the macro CODE or insert
+<kbd><span class="nobr">\*CODE</span></kbd> into running text, mom switches to
+a
 <a href="definitions.html#fixedwidthfont">fixed-width font</a>
 (Courier, by default) and turns
 <a href="goodies.html#smartquotes">SMARTQUOTES</a>
@@ -2516,7 +2557,7 @@
   .CODE
   .ESC_CHAR character
   &lt;code&gt;
-  .ESC_CHAR .
+  .ESC_CHAR \
   .CODE OFF
 </span>
 Be aware that changing the escape character prevents subsequent
@@ -2538,7 +2579,7 @@
 <kbd>.CODE</kbd> does not cause a line break when
 you&#8217;re in a
 <a href="definitions.html#filled">fill mode</a>
-(ie
+(i.e.
 <a href="typesetting.html#justify">JUSTIFY</a>
 or
 <a href="typesetting.html#quad">QUAD</a>
@@ -2553,12 +2594,12 @@
 you want a break afterwards, you must supply it manually with
 <a href="typesetting.html#br">BR</a>
 unless what follows immediately is a macro that automatically causes
-a break (e.g.,
+a break (e.g.
 <a href="#pp">PP</a>).
 </p>
 
-<p class="tip-bottom">
-In all likelihood, if you want the situation described above (ie a
+<p id="quote-code" class="tip-bottom">
+In all likelihood, if you want the situation described above (i.e. a
 break before and after CODE), what you probably want is to use
 <a href="quote">QUOTE</a>
 in conjunction with CODE, like this:
@@ -2581,32 +2622,32 @@
 
 <p>
 Passing any argument other than <kbd>BR</kbd>, <kbd>BREAK</kbd> or
-<kbd>SPREAD</kbd> to CODE (e.g., <kbd>OFF, QUIT, END, X,</kbd> etc.)
-turns CODE off and returns the family, font, and smartquotes back to
-their former state.
+<kbd>SPREAD</kbd> to CODE (e.g. <kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>, etc) turns CODE off and returns the
+family, font, and smartquotes back to their former state.
 </p>
 
 <h4 class="docs" style="font-size: 102%">Using <kbd>\*CODE</kbd> inline</h4>
 
 <p>
-<kbd>\*CODE</kbd> invokes <kbd>.CODE</kbd>, allowing you to
+<kbd><span class="nobr">\*CODE</span></kbd> invokes <kbd>.CODE</kbd>, allowing you to
 bracket code snippets inline.  It does not accept the <kbd>BR</kbd>,
 <kbd>BREAK</kbd>, or <kbd>SPREAD</kbd> arguments.  It is most useful
 for short snippets, as in the following example.
 <br/>
 <span class="pre-in-pp">
-  \*CODEapropos\*CODE OFF and \*CODEman&nbsp;-k\*CODE are identical.
+  \*CODEapropos\*CODE X and \*CODEman&nbsp;-k\*CODE X are identical.
 </span>
 </p>
 
 <p>
-<kbd>\*CODE</kbd> does not permit changing the escape character,
-so <kbd>\e</kbd> or a doubled backslash must be used.  Furthermore,
-if your code starts with a period, you must enter it as
-&#8220;<kbd>\&.</kbd>&#8221;.
+<kbd><span class="nobr">\*CODE</span></kbd> does not permit changing the escape
+character, so <kbd>\e</kbd> or a doubled backslash must be used.
+Furthermore, if your code starts with a period, you must enter it as
+&#8220;<kbd>\&amp;.</kbd>&#8221;.
 <br/>
 <span class="pre-in-pp">
-  Registers are created with the \*CODE\&.nr\*CODE OFF request.
+  Registers are created with the \*CODE\&amp;.nr\*CODE X request.
 </span>
 </p>
 
@@ -2628,15 +2669,15 @@
   .CODE
    echo "Hello, world" | sed -e 's/Hello,/Goodbye, cruel/'\c
   .CODE OFF
-  \&.  As this demonstrates...
+  \&amp;.  As this demonstrates...
 </span>
-Use of <kbd>\*CODE</kbd> inline does not require the
-<kbd>\c</kbd>, however periods and apostrophes after
-<kbd>\*CODE&nbsp;OFF</kbd> still need to be introduced with
-<kbd>\&</kbd>, as in this example:
+Use of <kbd><span class="nobr">\*CODE</span></kbd> inline does not require
+the <kbd>\c</kbd>, however periods and apostrophes after
+<kbd><span class="nobr">\*CODE&nbsp;X</span></kbd> still need to be introduced
+with <kbd>\&amp;</kbd>, as in this example:
 <br/>
 <span class="pre-in-pp">
-  ...append the unit of measure \*CODEp\*CODE&nbsp;OFF\&. New sentence...
+  ...append the unit of measure \*CODEp\*CODE&nbsp;OFF\&amp;. New sentence...
 </span>
 </p>
 
@@ -2677,9 +2718,9 @@
 CODE_SIZE works a little differently from the other _SIZE macros
 (see <a href="#control-macro-args">Arguments to the control
 macros</a>).  The argument you pass it is a percentage of the
-prevailing document point size.  It does not require a pre-pended
+prevailing document point size.  It does not require a prepended
 plus (<kbd>+</kbd>) or minus (<kbd>-</kbd>) sign, nor an appended
-percent sign (<kbd>%</kbd>).  Thus, is you want the point size of your CODE font to be
+percent sign (<kbd>%</kbd>).  Thus, if you want the point size of your CODE font to be
 90% of the prevailing document point size, you enter:
 <br/>
 <span class="pre-in-pp">
@@ -2688,13 +2729,14 @@
 Fixed-width fonts have notoriously whimsical
 <a href="definitions.html#xheight">x-heights</a>,
 meaning that they frequently look bigger (or, in some cases,
-smaller) than the type surrounding them, even if they're technically
-the same point size.  CODE_SIZE lets you choose a percentage of the
-prevailing point size for your fixed-width CODE font so it doesn't look
-gangly or miniscule in relation to the type around it.  All
-invocations of <kbd>.CODE</kbd> or <kbd>\*CODE</kbd> will use this
-size, so that if you decide to change the prevailing point size of your
-document, the CODE font will be scaled proportionally.
+smaller) than the type surrounding them, even if they&#8217;re
+technically the same point size.  CODE_SIZE lets you choose a
+percentage of the prevailing point size for your fixed-width
+CODE font so it doesn&#8217;t look gangly or minuscule in relation
+to the type around it.  All invocations of <kbd>.CODE</kbd> or
+<kbd><span class="nobr">\*CODE</span></kbd> will use this size, so that if you
+decide to change the prevailing point size of your document, the
+CODE font will be scaled proportionally.
 </p>
 
 <div class="rule-short"><hr/></div>
@@ -2724,7 +2766,8 @@
 the LIST macro.  Then, for every item in the list, you invoke
 the macro <kbd>.ITEM</kbd> followed by the text of the item.
 When a list is finished, you exit the list with
-<kbd>.LIST&nbsp;OFF</kbd> (or <kbd>QUIT, END, BACK,</kbd> etc.)
+<kbd>.LIST&nbsp;OFF</kbd> (or <kbd>QUIT</kbd>, <kbd>END</kbd>,
+<kbd>BACK</kbd>, etc.)
 </p>
 
 <p>
@@ -2732,7 +2775,7 @@
 left margin of running text that comes before it, like this:
 <br/>
 <span class="pre-in-pp">
-  My daily schedule needs organizing.  I can&#8217;t
+  My daily schedule needs organising.  I can&#8217;t
   seem to get everything done I want.
   o an hour&#8217;s worth of exercise
   o time to prepare at least one healthy
@@ -2784,7 +2827,7 @@
 Mom centres lists over the entire line length, disregarding
 <a href="typesetting.html#ib">IB</a>
 if it is in effect.  If there are lines in the list that exceed
-the the margins of IB, they must be broken manually with
+the margins of IB, they must be broken manually with
 <kbd>.BR</kbd> if you wish to keep them within the indented margins.
 </p>
 </div>
@@ -2807,9 +2850,9 @@
 </div>
 
 <p>
-Invoked by itself (ie with no argument), LIST
+Invoked by itself (i.e. with no argument), LIST
 initializes a list with bullets as the default enumerator.
-Afterward,s each block of input text preceded by
+Afterwards, each block of input text preceded by
 <kbd><a href="#item">.ITEM</a></kbd>,
 on a line by itself, is treated as a list item.
 </p>
@@ -2822,7 +2865,7 @@
 you must supply an enumerator (and optionally, a separator) for the
 list, unless you want mom&#8217;s default enumerator, which is a
 bullet.  Within nested lists, mom stores the enumerator, separator
-and indent for any list you return <i>backwards</i> to (ie with
+and indent for any list you return <i>backwards</i> to (i.e. with
 <kbd>.LIST OFF</kbd>), but does not store any information for lists
 you move <i>forward</i> to.
 </p>
@@ -2840,14 +2883,14 @@
 uppercase letters), <kbd>alpha</kbd> (for lowercase letters),
 <kbd>ROMAN&lt;n&gt;</kbd> (for uppercase roman numerals),
 <kbd>roman&lt;n&gt;</kbd> (for lowercase roman numerals) tell
-<kbd>mom</kbd> what kind of enumerator to use for a given list.
+mom what kind of enumerator to use for a given list.
 </p>
 
 <p>
 The arguments, <kbd>ROMAN&lt;n&gt;</kbd> and
 <kbd>roman&lt;n&gt;</kbd>, are special.  You must append to them
-a digit (arabic, e.g., "1" or "9" or "17") saying how many items a
-particular roman-numeralled LIST is going to have. Mom requires this
+a digit (arabic, e.g. "1" or "9" or "17") saying how many items a
+particular roman-numeraled LIST is going to have. Mom requires this
 information in order to align roman numerals sensibly, and will
 abort&mdash;with a message &mdash; if you don&#8217;t provide it.
 (For setting roman numeral and digit lists with the enumerators
@@ -2856,7 +2899,7 @@
 </p>
 
 <p>
-A roman-numeralled list containing, say, five items, would be set
+A roman-numeraled list containing, say, five items, would be set
 up like this:
 <br/>
 <span class="pre-in-pp">
@@ -2896,8 +2939,7 @@
 </span>
 If your enumerator contains spaces, you must enclose the
 <kbd>&lt;character&gt;</kbd> argument in both LIST and ITEM in
-double-quotes,
-e.g.
+double-quotes, e.g.
 <br/>
 <span class="pre-in-pp">
   .LIST VARIABLE "\*UP 1p\bu\*DOWN 1p"
@@ -2935,7 +2977,7 @@
 adjusted with
 <a href="definitions.html#inlines">inline escapes</a>
 in the argument passed to USER.  For example, to raise the position
-of <kbd>\sq</kbd> slightly, you might do
+of <kbd><span class="nobr">\sq</span></kbd> slightly, you might do
 <span class="pre-in-pp">
   .LIST USER "\*UP .25p\sq\*DOWN .25p"
     or
@@ -3002,7 +3044,7 @@
 <h3 class="docs">The third argument &ndash; prefix style</h3>
 
 <p>
-Additionally, you may give a prefix (ie a character
+Additionally, you may give a prefix (i.e. a character
 that comes <i>before</i> the enumerator) when your
 enumerator style for a particular list is <kbd>DIGIT</kbd>,
 <kbd>ALPHA</kbd>, <kbd>alpha</kbd>, <kbd>ROMAN&lt;n&gt;</kbd> or
@@ -3040,13 +3082,13 @@
 </p>
 </div>
 
-<h3 class="docs">Exiting lists &ndash; LIST OFF/BACK or QUIT_LISTS</h3>
+<h3 class="docs">Exiting lists &ndash; LIST OFF / BACK or QUIT_LISTS</h3>
 
 <p>
 Any single argument to <kbd>LIST</kbd> other than
 <kbd>BULLET</kbd>, <kbd>DASH</kbd>, <kbd>DIGIT</kbd>,
 <kbd>ALPHA</kbd>, <kbd>alpha</kbd>, <kbd>ROMAN&lt;n&gt;</kbd>,
-<kbd>roman&lt;n&gt;</kbd> or <kbd>USER</kbd> (e.g.,
+<kbd>roman&lt;n&gt;</kbd> or <kbd>USER</kbd> (e.g.
 <kbd>LIST&nbsp;OFF</kbd> or <kbd>LIST&nbsp;BACK</kbd>) takes you out
 of the current list.
 </p>
@@ -3059,12 +3101,12 @@
 
 <p>
 If you are in a nested list, mom moves you back one list-level
-(ie does not take you out of the list structure) and restores the
+(i.e., does not take you out of the list structure) and restores the
 enumerator, separator and indent appropriate to that level.
 </p>
 
 <p>
-Each invocation of <kbd>.LIST</kbd> should thus be be matched by
+Each invocation of <kbd>.LIST</kbd> should thus be matched by
 a corresponding <kbd>.LIST&nbsp;OFF</kbd> in order to fully exit
 lists.  For example,
 <br/>
@@ -3227,12 +3269,12 @@
 <span class="pre-in-pp">
   Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
   sed diam nonumy eirmod tempor invidunt ut labore.
-      o List 1 item
-      o List 1 item
+      &bull; List 1 item
+      &bull; List 1 item
           - List 2 item
           - List 2 item
-      o List 1 item
-      o List 1 item
+      &bull; List 1 item
+      &bull; List 1 item
   Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
   sed diam nonumy eirmod tempor invidunt ut labore.
 </span>
@@ -3241,7 +3283,7 @@
 <h4 id="reset-list" class="docs" style="margin-top: -.25em;">2. Resetting an initialized list&#8217;s enumerator &ndash; RESET_LIST</h4>
 
 <p>
-In nested lists, if your choice of list enumerator for a given level
+In nested lists, if your choice of enumerator for a given level
 of list is <kbd>DIGIT</kbd>, <kbd>ALPHA</kbd>, <kbd>alpha</kbd>,
 <kbd>ROMAN</kbd> or <kbd>roman</kbd>, you may sometimes want to
 reset the list&#8217;s enumerator when you return to that list.
@@ -3249,37 +3291,34 @@
 <br/>
 <span class="pre-in-pp">
   Things to do religiously each and every day:
-  1. Take care of the dog
-     a) walk every day
-     b) brush once a week
-        - trim around the eyes every fourth brushing
-        - don&#8217;t forget to check nails
-  2. Feed the cat
-     a) soft food on Mon., Wed. and Fri.
-     b) dry food on Tues., Thurs. and Sat.
-     c) canned tuna on Sunday
+  &bull; take care of the dog
+    a) walk every day
+    b) brush once a week
+       - trim around the eyes every fourth brushing
+       - don&#8217;t forget to check nails
+  &bull; feed the cat
+    d) soft food on Mon., Wed. and Fri.
+    e) dry food on Tues., Thurs. and Sat.
+    f) canned tuna on Sunday
 </span>
 </p>
 
 <p>
-Normally, within a nested list, when you return to an
-incrementally-enumerated list, the enumerator continues incrementing
-from where it left off.  That means, in the example above, the
-normal state of affairs for the alpha'ed list under
-<br/>
-<span class="pre-in-pp">
-  2.  Feed the cat
-</span>
-would be d), e) and f).  The solution, in such a case, is simply
-to reset the enumerator&mdash;before <kbd>.ITEM</kbd>&mdash;with
-the macro <kbd>.RESET_LIST</kbd>.  By default, with no argument,
-<kbd>.RESET_LIST</kbd> resets the enumerator to 1, A, a, I or i
-depending on the style of enumerator.  You may, if you wish, pass
-<kbd>.RESET_LIST</kbd> a
-<a href="definitions.html#numericargument">numeric argument</a>
-representing the starting enumerator for the reset (if different
-from "1"), although I can&#8217;t at present think of a use for this
-feature.
+The alpha-enumerated items under &#8220;Feed the cat&#8221;
+would be normally a), b), c), but we want d), e), f).  The
+solution is to reset the second <kbd>.LIST alpha</kbd>&#8217;s
+enumerator&mdash;before the first <kbd>.ITEM</kbd>&mdash;with
+the macro RESET_LIST.
+</p>
+
+<p>
+With no argument, <kbd>.RESET_LIST</kbd> resets an incrementing
+enumerator to 1, A, a, I or i depending on the style of enumerator.
+If you pass <kbd>.RESET_LIST</kbd> a
+<a href="definitions.html#numericargument">numeric argument</a>,
+it represents the starting position for an incrementing enumerator.  In
+the example above, <kbd>.RESET_LIST 4</kbd>&nbsp;starts the second
+alpha-ed list at d).
 </p>
 
 <h4 id="pad-list-digits" class="docs" style="margin-top: -.25em;">3. Padding digit enumerators &ndash; PAD_LIST_DIGITS</h4>
@@ -3332,7 +3371,7 @@
 
 <p>
 If you&#8217;d like the roman numerals to line
-up flush right (ie be padded "left"), simply
+up flush right (i.e. be padded "left"), simply
 invoke <kbd>.PAD_LIST_DIGITS&nbsp;LEFT</kbd> after
 <kbd>.LIST&nbsp;ROMAN&lt;n&gt;</kbd> or
 <kbd>.LIST&nbsp;roman&lt;n&gt;</kbd> and before <kbd>.ITEM</kbd>.
@@ -3424,7 +3463,7 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Note:</span>
-Do not use <kbd>NUMBER_LINES</kbd> inside 
+Do not use NUMBER_LINES inside 
 <a href="#quote">QUOTE</a>
 or
 <a href="#blockquote">BLOCKQUOTE</a>.
@@ -3444,9 +3483,9 @@
 you must, at a minimum, tell it what line number you want the
 <i>next</i>
 <a href="definitions.html#outputline">output line</a>
-to have.  The optional arguments <kbd>which lines to number</kbd>
-and <kbd>gutter</kbd> allow you to state which lines should
-be numbered (e.g., every five or every ten lines), and the gutter to
+to have.  The optional arguments <kbd>&lt;which lines to number&gt;</kbd>
+and <kbd>&lt;gutter&gt;</kbd> allow you to state which lines should
+be numbered (e.g. every five or every ten lines), and the gutter to
 place between line numbers and
 <a href="definitions.html#running">running text</a>.
 </p>
@@ -3462,7 +3501,7 @@
 
 <p>
 If you want only every five lines numbered, pass mom the optional
-<kbd>which lines to number</kbd> argument, like this:
+<kbd>&lt;which lines to number&gt;</kbd> argument, like this:
 <span class="pre-in-pp">
   .NUMBER_LINES 1 5
 </span>
@@ -3479,15 +3518,16 @@
 </p>
 
 <p>
-If you want line number <kbd>1</kbd> to be numbered, you have to
-invoke <kbd>.NUMBER_LINES 1 1</kbd> before the first output line
-you want numbered, then study your <i>output</i> copy and determine
-where best to insert the following in your <i>input</i> input text:
+If you want line number <kbd>1</kbd> to be numbered, you have
+to invoke <kbd><span class="nobr">.NUMBER_LINES 1 1</span></kbd> before the
+first output line you want numbered, then study your <i>output</i>
+copy and determine where best to insert the following in your
+<i>input</i> text:
 <br/>
 <span class="pre-in-pp">
   .NUMBER_LINES \nln 5
 </span>
-(The escape, <kbd>\nln</kbd>, ensures that NUMBER_LINES
+(The escape <kbd>\nln</kbd> ensures that NUMBER_LINES
 automatically supplies the correct value for the first argument,
 <kbd>&lt;start number&gt;</kbd>.)
 </p>
@@ -3539,7 +3579,7 @@
 <span class="pre-in-pp">
   .NUMBER_LINES&nbsp;OFF
 </span>
-(or <kbd>END, QUIT, X,</kbd> etc).
+(or <kbd>END</kbd>, <kbd>QUIT</kbd>, <kbd>X</kbd>, etc).
 </p>
 
 <p>To resume line numbering:
@@ -3568,7 +3608,7 @@
       you should re-invoke, at a minimum,
       <kbd>.NUMBER_LINES&nbsp;1</kbd> for each collated
       document, in order to ensure that each begins with the
-      number, <kbd>1</kbd>, prepended to the first line.
+      number <kbd>1</kbd> prepended to the first line.
   </li>
   <li style="margin-top: .25em;">Occasionally, you may want to
       change the current gutter between line numbers and running
@@ -3672,27 +3712,25 @@
 <span class="pre-in-pp">
   .NUMBER_BLOCKQUOTE_LINES
 </span>
-either before or after <kbd>NUMBER_LINES</kbd>.  Both behave
-identically with respect to the affected macro (ie <kbd>QUOTE</kbd>
-or <kbd>BLOCKQUOTE</kbd>).
+either before or after NUMBER_LINES. Both behave identically with
+respect to the affected macro (i.e. QUOTE or BLOCKQUOTE).
 </p>
 
 <h5 id="number-quote-lines-selective" class="docs" style="font-size: 87%">&bull;&nbsp;Selectively enabling line numbering for QUOTEs and BLOCKQUOTEs</h5>
 
 <p>
-If you&#8217;d like to enable line numbering
-selectively for quotes and blockquotes <i>only</i>, enable
-<kbd>NUMBER_QUOTE_LINES</kbd> or <kbd>NUMBER_BLOCKQUOTE_LINES</kbd>
-first, followed by <kbd>NUMBER_LINES&nbsp;&lt;n&gt;</kbd>, where
-<kbd>&lt;n&gt;</kbd> is the first line number of the quote
-or blockquote.  Afterwards, enter your <kbd>QUOTE</kbd> or
-<kbd>BLOCKQUOTE</kbd>.  When the quote or blockquote is finished (ie
-after <kbd>QUOTE&nbsp;OFF</kbd> or <kbd>BLOCKQUOTE&nbsp;OFF</kbd>),
-turn line numbering off.  Each subsequent quote or blockquote you
-want line numbered requires only <kbd>NUMBER_LINES &lt;n&gt;</kbd>
-(with a corresponding <kbd>NUMBER_LINES OFF</kbd>) until you turn
-<kbd>NUMBER_QUOTE_LINES</kbd> or <kbd>NUMBER_BLOCKQUOTE_LINES</kbd>
-off.
+If you&#8217;d like to enable line numbering selectively for quotes
+and blockquotes <i>only</i>, invoke <kbd>.NUMBER_QUOTE_LINES</kbd>
+or <kbd>.NUMBER_BLOCKQUOTE_LINES</kbd> first, followed by
+<kbd>.NUMBER_LINES&nbsp;&lt;n&gt;</kbd>, where <kbd>&lt;n&gt;</kbd>
+is the first line number of the quote or blockquote.  Afterwards,
+enter your QUOTE or BLOCKQUOTE.  When the quote or blockquote
+is finished (i.e. after <kbd>.QUOTE&nbsp;OFF</kbd> or
+<kbd>.BLOCKQUOTE&nbsp;OFF</kbd>), turn line numbering off.  Each
+subsequent quote or blockquote you want line numbered requires
+only <kbd>.NUMBER_LINES &lt;n&gt;</kbd> (with a corresponding
+<kbd>.NUMBER_LINES OFF</kbd>) until you turn NUMBER_QUOTE_LINES or
+NUMBER_BLOCKQUOTE_LINES off.
 </p>
 
 <p>
@@ -3725,15 +3763,15 @@
 unit of measure, it is not possible for line numbers in quotes
 or blockquotes to hang outside a document&#8217;s overall left
 margin and be reliably flush with the line numbers of paragraph
-text.  Conseqently, line numbers in quotes or blockquotes hang
+text.  Consequently, line numbers in quotes or blockquotes hang
 to the left of the quote, separated by the currently active
-gutter for <kbd>NUMBER_LINES</kbd>.
+gutter for NUMBER_LINES.
 </p>
 
 <p>
-If you&#8217;d like to change the line number gutter for
-quotes or blockquotes, invoke <kbd>NUMBER_QUOTE_LINES</kbd> or
-<kbd>NUMBER_BLOCKQUOTE_LINES</kbd> with a digit representing the
+If you&#8217;d like to change the line number gutter for quotes
+or blockquotes, invoke <kbd>.NUMBER_QUOTE_LINES</kbd> or
+<kbd>.NUMBER_BLOCKQUOTE_LINES</kbd> with a digit representing the
 number of
 <a href="definitions.html#figurespace">figure spaces</a>
 you&#8217;d like between the line numbers and the quoted text, like this:
@@ -3766,8 +3804,8 @@
 </p>
 
 <p>
-Once having turned <kbd>NUMBER_QUOTE_LINES</kbd> or
-<kbd>NUMBER_BLOCKQUOTE_LINES</kbd> on, you may disable them with
+Once having turned NUMBER_QUOTE_LINES or NUMBER_BLOCKQUOTE_LINES on,
+you may disable them with
 <span class="pre-in-pp">
   .NUMBER_QUOTE_LINES OFF
 </span>
@@ -3872,7 +3910,7 @@
 <p>
 If mom sees that a portion of a footnote cannot be fit on its page,
 she carries that portion over to the next page.  If an entire
-footnote can&#8217;t be fit on its page (ie  FOOTNOTE has been
+footnote can&#8217;t be fit on its page (i.e., FOOTNOTE has been
 called too close to the bottom), she defers the footnote to the next
 page, but sets it with the appropriate marker from the previous
 page.
@@ -3889,7 +3927,7 @@
 
 <p>
 In the unfortunate happenstance that a deferred footnote is the
-only footnote on its page (ie it&#8217;s marked in the document
+only footnote on its page (i.e., it&#8217;s marked in the document
 body with a star) and the page it&#8217;s deferred to has its own
 footnotes, mom separates the deferred footnote from the page&#8217;s
 proper footnote(s) with a blank line.  This avoids the confusion
@@ -3920,7 +3958,8 @@
 putting a
 <a href="typesetting.html#space"><kbd>.SPACE</kbd></a>
 command at the end of the footnote text, before
-<kbd>.FOOTNOTE&nbsp;OFF</kbd> (or <kbd>X, QUIT, EXIT</kbd>, etc).
+<kbd>.FOOTNOTE&nbsp;OFF</kbd> (or <kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>, etc).
 </p>
 
 <p>
@@ -4052,8 +4091,9 @@
 In the second instance, you must explicitly tell mom that
 you want input text after <kbd>.FOOTNOTE&nbsp;OFF</kbd> to
 begin on a new output line.  This is accomplished by passing
-<kbd>.FOOTNOTE&nbsp;OFF</kbd> (or <kbd>QUIT, END, X,</kbd> etc) an
-additional argument: <kbd>BREAK</kbd> or <kbd>BR</kbd>.
+<kbd>.FOOTNOTE&nbsp;OFF</kbd> (or <kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>, etc) an additional argument:
+<kbd>BREAK</kbd> or <kbd>BR</kbd>.
 </p>
 
 <p>
@@ -4133,7 +4173,7 @@
 </div>
 
 <div class="box-macro-args">
-Tag: FOOTNOTE <kbd class="macro-args">&lt;toggle&gt;  BREAK | BR  | INDENT LEFT | RIGHT | BOTH &lt;indent value&gt;</kbd>
+Tag: FOOTNOTE <kbd class="macro-args">&lt;toggle&gt;  BREAK | BR   INDENT LEFT | RIGHT | BOTH &lt;indent value&gt; </kbd>
 </div>
 
 <p class="requires">
@@ -4145,8 +4185,9 @@
 <p>
 FOOTNOTE is a toggle macro, therefore invoking it on a line by
 itself allows you to enter a footnote in the body of a document.
-Invoking it with any argument other than INDENT (ie <kbd>OFF,
-QUIT, END, X...</kbd>) tells mom you&#8217;re finished.
+Invoking it with any argument other than <kbd>INDENT</kbd> (i.e.
+<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>...)
+tells mom you&#8217;re finished.
 </p>
 
 <p>
@@ -4196,7 +4237,7 @@
 or
 <a href="typesetting.html#quad">QUAD</a>),
 the line <i>after</i> a <kbd>.FOOTNOTE&nbsp;OFF</kbd> should be
-entered as if there were no interruption in the input text, ie
+entered as if there were no interruption in the input text, i.e.,
 the line should begin with a literal space or punctuation mark (see
 explanation and examples
 <a href="#fn-and-punct">here</a>).
@@ -4206,9 +4247,10 @@
 In
 <a href="definitions.html#filled">no-fill</a>
 modes, the optional argument <kbd>BREAK</kbd> or <kbd>BR</kbd> may
-be used after the <kbd>OFF</kbd> (or <kbd>QUIT, END, X,</kbd> etc.)
-argument to instruct mom not to join the next input line to the
-previous output.  See
+be used after the <kbd>OFF</kbd> (or <kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc) argument to
+instruct mom not to join the next input line to the previous output.
+See
 <a href="#fn-and-punct-nofill">here</a>
 for a more complete explanation, with examples.
 </p>
@@ -4224,7 +4266,7 @@
 </div>
 
 <div class="defaults-container" style="background-color: #ded4bd; border: none;">
-<h3 id="footnote-control" class="docs defaults">FOOTNOTE control macros macros and defaults</h3>
+<h3 id="footnote-control" class="docs defaults">FOOTNOTE control macros and defaults</h3>
 
 <ol style="margin-top: .5em; padding-bottom: .5em;">
   <li><a href="#footnote-general">Family/font/size/colour/lead/quad</a></li>
@@ -4272,13 +4314,13 @@
 <h4 id="footnote-markers" class="docs" style="margin-top: -1.25em;">2. Footnote markers &ndash; FOOTNOTE_MARKERS</h4>
 
 <p>
-If you don&#8217;t want footnote markers, in either the body of
+If you don&#8217;t want footnote markers in either the body of
 the document or beside footnote entries themselves, toggle them
-off with <kbd>.FOOTNOTE_MARKERS&nbsp;OFF</kbd> (or <kbd>END, QUIT,
-X</kbd>...).  This means, of course, that you&#8217;ll
-have to roll your own.  If you want them back on, invoke
-<kbd>.FOOTNOTE_MARKERS</kbd> with no argument.  Footnote markers are
-on by default.
+off with <kbd>.FOOTNOTE_MARKERS&nbsp;OFF</kbd> (or <kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>...).  This means,
+of course, that you&#8217;ll have to roll your own.  If you want
+them back on, invoke <kbd>.FOOTNOTE_MARKERS</kbd> with no argument.
+Footnote markers are on by default.
 </p>
 
 <p>
@@ -4390,22 +4432,27 @@
 what you want is a single line number, you need only invoke
 <kbd>.FOOTNOTE</kbd>, <i>without the terminating</i> <kbd>\c</kbd>,
 at the appropriate place in running text.  Input lines after the
-footnote has been terminated (e.g., with <kbd>.FOOTNOTE OFF</kbd>)
-must begin at the left margin.
+footnote has been terminated (e.g. with
+<kbd>.FOOTNOTE&nbsp;OFF</kbd>) are entered normally.
 </p>
 
 <p>
-If you want a range of line numbers (e.g.,&nbsp;5-11&nbsp;),
-insert, directly into the first line of the range you want,
-the <a href="definitions.html#inlines">inline escape</a>,
-<kbd>\*FN_MARK</kbd>.  For the terminating line number of the
-range, you need only invoke <kbd>.FOOTNOTE</kbd> (again, without the
-terminating <kbd>\c</kbd>); mom is smart enough to figure out that
-where <kbd>.FOOTNOTE</kbd> was invoked represents the terminating
-line number.  Range-numbered footnotes are always output on the
-page where <kbd>.FOOTNOTE</kbd> was invoked, not the page where
-<kbd>\*FN_MARK</kbd> appears (subject, of course, to the rules for
-footnotes that fall too close to the bottom of a page, as outlined
+If you want a range of line numbers (e.g.&nbsp;5-11&nbsp;),
+insert, directly into the first line of the range you want, the
+<a href="definitions.html#inlines">inline escape</a>,
+<kbd><span class="nobr">\*FN_MARK</span></kbd>.  For the terminating line
+number of the range, you need only invoke <kbd>.FOOTNOTE</kbd>
+(again, without the terminating <kbd>\c</kbd>); mom is smart enough
+to figure out that where <kbd>.FOOTNOTE</kbd> was invoked represents
+the terminating line number.
+</p>
+
+<p>
+Range-numbered footnotes are always output on the page
+where <kbd>.FOOTNOTE</kbd> was invoked, not the page where
+<kbd><span class="nobr">\*FN_MARK</span></kbd> appears (subject, of course, to
+the rules for footnotes that fall too close to the bottom of a page,
+as outlined
 <a href="#footnote-rules">here</a>).
 </p>
 
@@ -4484,7 +4531,7 @@
 <p style="margin-left: .5em;">
 Finally, if your footnote marker style is <kbd>LINE</kbd>, you may
 instruct mom to do &#8220;run-on style&#8221; footnotes.  Run-on
-footnotes do not treat footnotes as discrete entities, ie each
+footnotes do not treat footnotes as discrete entities, i.e. each
 beginning on a new line.  Rather, each footnote is separated from
 the footnote before it by horizontal space in the running line, so
 that the footnotes on any given page form a continuous block, like
@@ -4553,10 +4600,11 @@
 <h4 id="footnote-rule" class="docs" style="margin-top: -.25em;">7. Footnote rule &ndash; FOOTNOTE_RULE</h4>
 
 <p>
-If you don&#8217;t want a footnote separator rule, toggle it off with
-<kbd>.FOOTNOTE_RULE&nbsp;OFF</kbd> (or <kbd>END, QUIT, X</kbd>...).
-Toggle it back on by invoking <kbd>.FOOTNOTE_RULE</kbd> with no
-argument.  The default is to print the rule.
+If you don&#8217;t want a footnote separator rule, toggle it
+off with <kbd>.FOOTNOTE_RULE&nbsp;OFF</kbd> (or <kbd>END</kbd>,
+<kbd>QUIT</kbd>, <kbd>X</kbd>...).  Toggle it back on by invoking
+<kbd>.FOOTNOTE_RULE</kbd> with no argument.  The default is to print
+the rule.
 </p>
 
 <h4 id="footnote-rule-length" class="docs" style="margin-top: -.25em;">8. Footnote rule length &ndash; FOOTNOTE_RULE_LENGTH</h4>
@@ -4574,7 +4622,7 @@
 is required.  The default is 4
 <a href="definitions.html#picaspoints">picas</a>
 for both
-<a href="docprocessing.html#printstyle">PRINTSTYLES</a>.
+<a href="docprocessing.html#printstyle">PRINTSTYLE</a>s.
 </p>
 
 <h4 id="footnote-rule-weight" class="docs" style="margin-top: -.25em;">9. Footnote rule weight &ndash; FOOTNOTE_RULE_WEIGHT</h4>
@@ -4731,7 +4779,7 @@
 <a href="#blockquote-control">blockquote control macros</a>.
 However, you must make the changes <i>within</i> each endnote,
 prior to invoking <kbd>.QUOTE</kbd> or <kbd>.BLOCKQUOTE</kbd>,
-and undo them prior to terminating the endnote (ie before
+and undo them prior to terminating the endnote (i.e. before
 <kbd>.ENDNOTE&nbsp;OFF</kbd>), otherwise the changes will affect
 subsequent quotes and blockquotes that appear in the document body
 as well.
@@ -4765,7 +4813,7 @@
 By default, mom starts the endnotes page with a bold, centred head,
 &#8220;ENDNOTES&#8221;.  Subsequently, for each section in a
 <a href="rectoverso.html#collate-intro">collated</a>
-document (e.g., chapters in a book), she identifies the section in bold
+document (e.g. chapters in a book), she identifies the section in bold
 type, flush left and underscored, followed by one-half linespace.
 Endnotes pertaining to the section are output underneath, identified
 by superscript numbers.  The text of the endnotes themselves is
@@ -4818,8 +4866,9 @@
 <p>
 ENDNOTE is a toggle macro, therefore invoking it on a line by itself
 allows you to enter an endnote in the body of a document.  Invoking
-it with any other argument (ie <kbd>OFF, QUIT, END, X...</kbd>)
-tells mom that you&#8217;ve finished the endnote.
+it with any other argument (i.e. <kbd>OFF</kbd>, <kbd>QUIT</kbd>,
+<kbd>END</kbd>, <kbd>X</kbd>...) tells mom that you&#8217;ve
+finished the endnote.
 </p>
 
 <div class="box-tip">
@@ -4858,7 +4907,7 @@
 or
 <a href="typesetting.html#quad">QUAD</a>,
 the line after <kbd>.ENDNOTE&nbsp;OFF</kbd> should be
-entered as if there were no interruption in the input text, ie
+entered as if there were no interruption in the input text, i.e.,
 the line should begin with a literal space or punctuation mark (see
 explanation and examples for footnotes, which apply equally to
 endnotes,
@@ -4869,9 +4918,10 @@
 In
 <a href="definitions.html#filled">no-fill</a>
 modes, the optional argument <kbd>BREAK</kbd> or <kbd>BR</kbd> may
-be used after the <kbd>OFF</kbd> (or <kbd>QUIT, END, X,</kbd> etc.)
-argument to instruct mom not to join the next input line to the
-previous output.  See
+be used after the <kbd>OFF</kbd> (or <kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc) argument to
+instruct mom not to join the next input line to the previous output.
+See
 <a href="#fn-and-punct-nofill">here</a>
 for a more complete explanation.  The examples are for
 <kbd>.FOOTNOTE</kbd>, but apply equally to <kbd>.ENDNOTE</kbd>.
@@ -4897,13 +4947,13 @@
 <p>
 Unlike footnotes, which mom automatically outputs at the bottom
 of pages, endnotes must be explicitly output by you, the
-user. ENDNOTES, by itself (ie without any argument), is the macro
+user. ENDNOTES, by itself (i.e. without any argument), is the macro
 to do this.
 </p>
 
 <p>
 Typically, you&#8217;ll use ENDNOTES at the end of a document.  If
-it&#8217;s a single (ie not collated) document, mom will print
+it&#8217;s a single (i.e. not collated) document, mom will print
 the endnotes pertaining to it.  If it&#8217;s a collated document,
 mom will print all the endnotes contained within all sections of
 the document (typically chapters), appropriately identified and
@@ -5140,8 +5190,8 @@
 </p>
 
 <p>
-If you'd like some whitespace between endnotes, just invoke
-ENDNOTE_SPACING with the amount of space you want, e.g.,
+If you&#8217;d like some whitespace between endnotes, just invoke
+ENDNOTE_SPACING with the amount of space you want, e.g.
 <br/>
 <span class="pre-in-pp">
   .ENDNOTE_SPACING 6p
@@ -5185,7 +5235,7 @@
 single-spacing back to double-spacing for different spacing of
 endnotes output at the ends of separate documents in a collated
 document, invoke <kbd>.SINGLESPACE_ENDNOTES</kbd> with any argument
-(<kbd>OFF, QUIT, Q, X</kbd>...).
+(<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>...).
 </p>
 
 
@@ -5305,7 +5355,7 @@
 <p>
 Use this macro with caution.  If all endnotes for several
 <a href="rectoverso.html#collate">collated</a>
-documents are to be output at once, ie not at the end of each
+documents are to be output at once, i.e. not at the end of each
 separate doc, ENDNOTES_FIRST_PAGENUMBER tells mom what page number
 to put on the first page of the endnotes.
 </p>
@@ -5434,8 +5484,8 @@
 <p>
 If, for some reason, having enabled the header/footer centre string
 on endnotes pages, you wish to disable it, invoke the same macro
-with any argument (<kbd>OFF, QUIT, Q, X</kbd>...).
-</p>
+with any argument (<kbd>OFF</kbd>, <kbd>QUIT</kbd>, <kbd>END</kbd>,
+<kbd>X</kbd>...). </p>
 
 <h5 id="endnotes-allows-headers" class="docs" style="margin-top: -.5em; margin-bottom: .5em; margin-left: .5em;">&bull;&nbsp;Allow headers on endnotes pages</h5>
 
@@ -5536,7 +5586,7 @@
 </div>
 
 <p class="requires">
-&bull;&nbsp;Argument requires a <a href="definitions.html#unitofmeasure">unit of measusure</a>
+&bull;&nbsp;Argument requires a <a href="definitions.html#unitofmeasure">unit of measure</a>
 </p>
 
 <p class="alias" style="margin-top: -1em; margin-bottom: 0;">
@@ -5566,7 +5616,7 @@
 </span>
 </p>
 
-
+
 
 <h5 id="endnotes-header-underscore" class="docs" style="margin-top: -1em; margin-bottom: .5em; margin-left: .5em;">&bull;&nbsp;Header (first-page title) underscoring</h5>
 
@@ -5595,7 +5645,7 @@
 will place a single rule underneath the endnotes page title.  Invoked
 with the argument, <kbd>DOUBLE</kbd>, ENDNOTES_HEADER_UNDERSCORE will
 double-underscore the title.  Invoked with any other non-numeric
-argument, (e.g., <kbd>OFF, NO, X</kbd>, etc.) the macro disables
+argument, (e.g. <kbd>OFF, NO, X</kbd>, etc.) the macro disables
 underscoring of the title.
 </p>
 
@@ -5663,7 +5713,7 @@
 If you&#8217;re generating a table of contents, you may want the
 endnotes pages title to be in caps, but the toc entry in caps/lower
 case.  If the argument to
-<kbd><a href="#endnotes-header-string">ENDNOTES_HEADER_STRING</a></kbd>
+<a href="#endnotes-header-string">ENDNOTES_HEADER_STRING</a>
 is in caps/lower case and ENDNOTES_HEADER_CAPS is on, this is exactly
 what will happen.
 </p>
@@ -5696,7 +5746,7 @@
 If you don&#8217;t want any identifying title, invoke
 <kbd>.ENDNOTE_TITLE</kbd> with a blank argument, either two
 double-quotes side by side (<kbd>&quot;&quot;</kbd>) or no argument
-at all.  This is particularly useful if you have a single (ie
+at all.  This is particularly useful if you have a single (i.e.
 non-collated) document and find having the document&#8217;s title
 included in the endnotes redundant.
 </p>
@@ -5756,7 +5806,7 @@
 what you want is a single line number, you need only invoke
 <kbd>.ENDNOTE</kbd> at the appropriate place in running
 text <i>without the terminating</i> <kbd>\c</kbd>.  Input lines
-after the endnote has been terminated (e.g., with <kbd>.ENDNOTE
+after the endnote has been terminated (e.g. with <kbd>.ENDNOTE
 OFF</kbd>) must begin at the left margin.
 </p>
 
@@ -5770,14 +5820,14 @@
 </p>
 
 <p id="en-mark">
-If you want a range of line numbers (e.g.,&nbsp;5-11&nbsp;),
+If you want a range of line numbers (e.g.&nbsp;5-11&nbsp;),
 insert, directly into the first line of the range you want, the
 <a href="definitions.html#inlines">inline escape</a>,
-<kbd>\*EN-MARK</kbd>.  For the terminating line number of the
-range, you need only invoke <kbd>.ENDNOTE</kbd> (again, without the
-terminating <kbd>\c</kbd>).  Mom is smart enough to figure out that
-where <kbd>.ENDNOTE</kbd> is invoked represents the terminating line
-number.
+<kbd><span class="nobr">\*EN-MARK</span></kbd>.  For the terminating line
+number of the range, you need only invoke <kbd>.ENDNOTE</kbd>
+(again, without the terminating <kbd>\c</kbd>).  Mom is smart enough
+to figure out that where <kbd>.ENDNOTE</kbd> is invoked represents
+the terminating line number.
 </p>
 
 <div id="endnote-linenumbers-note" class="box-tip">
@@ -5847,7 +5897,7 @@
 more (the total number of endnotes is greater than 99), use the
 macro
 <a href="docelement.html#endnote-numbers-align">ENDNOTE_NUMBERS_ALIGN</a>,
-to set the desired amount of reserved space, e.g.,
+to set the desired amount of reserved space, e.g.
 <br/>
 <span class="pre-in-pp">
   .ENDNOTE_NUMBERS_ALIGN RIGHT 1
@@ -6149,7 +6199,7 @@
 she&#8217;s done, and where. </p>
 
 <p>
-In the event that a margin note, sucessfully begun on a page, runs
+In the event that a margin note, successfully begun on a page, runs
 past your bottom margin (or the last line before footnotes begin),
 the margin note will &#8220;flow&#8221; onto the next page.  If
 it is a &#8220;left&#8221; margin note, it will continue in the
@@ -6182,7 +6232,7 @@
 
 <p>
 Adjustments to the vertical position of margin notes must be done
-inside the margin note (ie after <kbd>.MN</kbd>), at the top,
+inside the margin note (i.e. after <kbd>.MN</kbd>), at the top,
 before entering text.  The commands to use are
 <kbd>\!<a href="typesetting.html#ald">.ALD</a></kbd>
 (to lower the margin note) and
@@ -6226,7 +6276,7 @@
 <p>
 The arguments may be entered in any order, and since the list is
 long, use of the backslash character ( <kbd>\</kbd> ) to put each on
-a separate line is recommended, e.g.,
+a separate line is recommended, e.g.
 <br/>
 <span class="pre-in-pp">
   .MN_INIT \
@@ -6336,7 +6386,7 @@
 <a href="definitions.html#picaspoints">points</a>
 as its unit of measure, so don&#8217;t tack a unit of measure onto
 the end of the argument.  The default lead is the same as paragraph
-text (ie the document&#8217;s base leading).
+text (i.e. the document&#8217;s base leading).
 </p>
 
 <h4 class="docs arg-list"><kbd>COLOR &lt;value&gt;</kbd></h4>
@@ -6366,7 +6416,7 @@
 The values can be added together, so, for example, if you want
 neither the first two nor the last two characters of words
 hyphenated, the hyphenation-flag would be 12.  The default value is
-14 (ie 2+4+8).
+14 (i.e. 2+4+8).
 </p>
 
 
@@ -6388,8 +6438,9 @@
 </p>
 
 <p>
-Any argument, such as <kbd>OFF</kbd> (or <kbd>QUIT, END, X</kbd>,
-etc) exits the current margin note.
+Any argument, such as <kbd>OFF</kbd> (or <kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc) exits the
+current margin note.
 </p>
 
 <div class="rule-short"><hr/></div>
@@ -6477,7 +6528,7 @@
 
 
 
-<h3 id="finis-control" class="docs" style="margin-bottom: -1em">Finis contol macros</h3>
+<h3 id="finis-control" class="docs" style="margin-bottom: -1em">Finis control macros</h3>
 
 <p>
 Since FINIS is only used once in a document, it has few control
@@ -6509,7 +6560,7 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Note:</span>
-If you pass FINIS_STRING a blank string, ie
+If you pass FINIS_STRING a blank string,
 <br/>
 <span class="pre-in-pp">
     .FINIS_STRING ""
@@ -6536,7 +6587,7 @@
 <span class="pre-in-pp">
     .FINIS_STRING_CAPS OFF
 </span>
-<kbd>OFF</kbd>, above, could be anything, e.g., <kbd>NO</kbd> or
+<kbd>OFF</kbd>, above, could be anything, e.g. <kbd>NO</kbd> or
 <kbd>X</kbd>.
 </p>
 
@@ -6546,11 +6597,11 @@
 
 <p>
 Invoking the control macro <kbd>.FINIS_COLOR</kbd> with a
-pre-defined (or &#8220;initalized&#8221;) colour changes the colour
+pre-defined (or &#8220;initialized&#8221;) colour changes the colour
 of both the FINIS string and the em-dashes that surround it.  If you
 use the
 <a href="definitions.html#inline">inline escape</a>,
-<a href="color.html#color-inline"><kbd>\*&lt;colourname&gt;</kbd></a>,
+<a href="color.html#color-inline"><kbd><span class="nobr">\*&lt;colourname&gt;</span></kbd></a>,
 in the argument passed to FINIS, only the text will be in the
 new colour; the em-dashes will be in the default document colour
 (usually black).

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/docprocessing.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/docprocessing.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/goodies.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/goodies.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/graphical.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/graphical.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/headfootpage.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/headfootpage.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/images.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/images.html Changed

@@ -2,7 +2,7 @@
 
+
 
 <div class="macro-id-overline">
 <h3 id="pdf-image" class= "macro-id">PDF_IMAGE</h3>
 </div>
 
 <div class="box-macro-args">
-Macro: <b>PDF_IMAGE</b> <kbd class="macro-args"> -L | -C | -R | -I &lt;indent&gt;  \
+Macro: <b>PDF_IMAGE</b> \
 <br/>
-&lt;image-file.pdf&gt; &lt;width&gt; &lt;height&gt;  SCALE &lt;factor&gt;  \
+<kbd class="macro-args"> -L | -C | -R | -I &lt;indent&gt;  \
+<br/>
+&lt;pdf image file&gt; &lt;width&gt; &lt;height&gt;  SCALE &lt;factor&gt;  \
 <br/>
  ADJUST +|-&lt;vertical adjustment&gt;   NO_SHIM   NO_FLEX  \
 <br/>
@@ -212,8 +230,10 @@
 <div class="box-tip">
 <p class="tip">
 <span class="note">Note:</span>
-Arguments may be broken into several lines using the
-&#8220;line-continued&#8221; backslash (<b>\</b>), as shown above.
+Mom files with embedded PDF images must be processed with
+pdfmom&nbsp;doc.mom&nbsp;&gt;&nbsp;doc.pdf.  Arguments may be broken
+into several lines using the &#8220;line-continued&#8221; backslash
+(<b>\</b>), as shown above.
 </p>
 </div>
 
@@ -273,7 +293,7 @@
 <kbd>SHORT_CAPTION</kbd>, and <kbd>LABEL</kbd> last.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SCALE'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SCALE</h5>
 
 <p>
 <kbd>SCALE</kbd> allows you to scale the image by
@@ -283,10 +303,11 @@
 sign or unit of measure should be appended.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'ADJUST'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">ADJUST</h5>
 
 <p>
-<kbd>ADJUST</kbd> lets you raise (<kbd>+</kbd>) or lower (<kbd>-</kbd>) the image
+<kbd>ADJUST</kbd> lets you raise (<kbd>-</kbd>) or lower
+(<kbd>+</kbd>) the image
 <span style="font-style: italic">within the space allotted for it</span>
 by the amount you specify.  This is useful for achieving good
 optical centering between surrounding blocks of type.  A unit of
@@ -309,7 +330,7 @@
 </p>
 </div>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_SHIM'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_SHIM</h5>
 
 <p>
 <kbd>NO_SHIM</kbd> instructs mom not to apply
@@ -319,15 +340,15 @@
 after the image falls properly on the page&#8217;s
 <a href="definitions.html#baseline-grid">baseline grid</a>,
 but can result in slightly unequal spacing above and below
-(correctible with the <kbd>ADJUST</kbd> argument).
+(correctable with the <kbd>ADJUST</kbd> argument).
 <kbd>NO_SHIM</kbd> is useful when you have several images on the
 page and there are visible differences in the spacing beneath them
 as a result of shimming.  To ensure a flush bottom margin, the last
-image on the page should be shimmed, ie should not be given the
+image on the page should be shimmed, i.e. should not be given the
 <kbd>NO_SHIM</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_FLEX'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_FLEX</h5>
 
 <p>
 <kbd>NO_FLEX</kbd> instructs mom not to apply
@@ -337,10 +358,10 @@
 on the page and you want to distribute excess vertical
 whitespace on the page amongst other flex-spacing points on the
 page.  If there are no others, the final image should be
-flex-spaced, ie not given the <kbd>NO_FLEX</kbd> argument.
+flex-spaced, i.e. not given the <kbd>NO_FLEX</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'FRAME'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">FRAME</h5>
 
 <p>
 <kbd>FRAME</kbd> instructs mom to put a frame around the image.
@@ -348,7 +369,7 @@
 <a href="#pdf-image-frame">PDF_IMAGE_FRAME</a>.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CAPTION</h5>
 
 <p>
 <kbd>CAPTION</kbd> allows you to give the image a caption.  By
@@ -360,7 +381,7 @@
 The text of the caption must be surrounded by double-quotes.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SHORT_CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SHORT_CAPTION</h5>
 
 <p>
 <kbd>SHORT_CAPTION</kbd> allows you to trim long captions for
@@ -368,7 +389,7 @@
 by double-quotes, is what will appear in the List.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'LABEL'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">LABEL</h5>
 
 <p>
 <kbd>LABEL</kbd>, if given, appears beneath the image.  The text you
@@ -379,7 +400,7 @@
 which, if enabled, overrides the <kbd>LABEL</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'TARGET'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">TARGET</h5>
 
 <p>
 <kbd>TARGET</kbd> followed by a unique name surrounded by
@@ -389,15 +410,20 @@
 </p>
 
 <p>
+<b><i>Please note:</i></b> The following functionality is available
+only with groff 1.22.4 or later.
+</p>
+
+<p>
 When
 <a href="#autolabel">autolabelling</a>
 is enabled and the document is processed with
 <a href="using.html#pdfmom" style="font-weight: bold">pdfmom</a>,
 the target name can be used to generate the target&#8217;s label
-number in running text if it is entered as a groff string, ie of the
-form <kbd>\*name</kbd>.  For example, if you create a target named
-&#8220;foo&#8221; for a pdf image whose autolabel number would be 3,
-entering
+number in running text if it is entered as a groff string, i.e. of the
+form <kbd><span class="nobr">\*name</span></kbd>.  For example, if you create
+a target named &#8220;foo&#8221; for a pdf image whose autolabel
+number would be 3, entering
 <br/>
 <span class="pre-in-pp">
   See
@@ -409,15 +435,6 @@
 link &#8220;Figure 5.3&#8221;.
 </p>
 
-<p>
-Remember that mom files with embedded PDF images must be processed
-with
-<br/>
-<span class="pre-in-pp">
- pdfmom doc.mom &gt; doc.pdf
-</span>
-</p>
-
 <div class="box-tip">
 <p class="tip-top">
 <span class="note">Note: Version 2.0-c change</span>
@@ -472,6 +489,8 @@
 </span>
 leaves the inset value and rule weight at their current value and
 changes the frame colour to blue.
+</p>
+
 <p>
 Frames are drawn <span class="italic">outside</span> the image at
 its requested dimensions inclusive of scaling.  Colours must be
@@ -640,6 +659,19 @@
 </p>
 
 <p>
+Floats always begin in
+<a href="definitions.html#filled">no-fill mode</a>.
+Text entered immediately after FLOAT will be set line-for-line
+unless a
+<a href="typesetting.html#justify">JUSTIFY</a>
+or
+<a href="typesetting.html#quad">QUAD&nbsp;L|R|C</a>
+precedes it.  Alternatively, any macro that sets a quad direction
+may be used, e.g.
+<a href="docelement.html#pp">PP</a>.
+</p>
+
+<p>
 Floats always deposit a break before they begin, which means the
 line beforehand will not be
 <a href="definitions.html#filled">filled</a>.
@@ -693,7 +725,28 @@
 </div>
 
 <div class="box-macro-args">
-Macro: <b>FLOAT</b> <kbd class="macro-args"> ADJUST +|-&lt;amount&gt;   FORCE   SPAN   INDENT &lt;value&gt;   CENTER   RIGHT   NO_SHIM  NO_FLEX  | TARGET "&lt;name&gt;" | &lt;anything&gt;</kbd>
+Macro: <b>FLOAT</b> <kbd class="macro-args">&lt;arguments&gt; | &lt;anything&gt;
+<br/>
+Arguments:
+<br/>
+ ADJUST +|-&lt;amount&gt;  \
+<br/>
+ FORCE  \
+<br/>
+ SPAN  \
+<br/>
+ INDENT &lt;value&gt;  \
+<br/>
+ CENTER  \
+<br/>
+ RIGHT  \
+<br/>
+ NO_SHIM \
+<br/>
+ NO_FLEX  \
+<br/>
+ TARGET "&lt;name&gt;" </kbd>
+<br/>
 </div>
 
 <div class="box-tip">
@@ -733,10 +786,11 @@
 <p style="margin-top: -.5em">
 To begin a float, simply invoke <kbd>.FLOAT</kbd> and follow it with
 whatever you want the float to contain.  When you&#8217;re done,
-invoke <kbd>.FLOAT&nbsp;OFF</kbd> (or <kbd>QUIT, END, X</kbd>, etc).
+invoke <kbd>.FLOAT&nbsp;OFF</kbd> (or <kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc).
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'ADJUST'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">ADJUST</h5>
 
 <p>
 The optional <kbd>ADJUST</kbd> argument tells mom to raise
@@ -746,7 +800,7 @@
 <a href="definitions.html#unitofmeasure">unit of measure</a>
 appended.  <kbd>ADJUST</kbd> gives you precise control over
 the vertical centering of floats, allowing you to compensate for
-unequal spacing that may result of from the automatic
+unequal spacing that may result from the automatic
 <a href="docprocessing.html#shim">shimming</a>
 or
 <a href="docprocessing.html#flex">flex-spacing</a>
@@ -756,17 +810,17 @@
 <p>
 <kbd>ADJUST</kbd> is ignored for the first float deferred to
 a following page but respected for subsequent deferred floats
-output immediately afterward.
+output immediately afterwards.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'FORCE'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">FORCE</h5>
 
 <p>
 The <kbd>FORCE</kbd> argument instructs mom to output the float
 exactly where it occurs in the input file.  With <kbd>FORCE</kbd>,
 mom immediately breaks to a new page to output the float if it does
 not fit on the current page.  While this is somewhat contrary to the
-notion of floats (ie that running text should continue to fill the
+notion of floats (i.e. that running text should continue to fill the
 page), there are circumstances where it may be desirable.
 </p>
 
@@ -776,7 +830,7 @@
 immediately before terminating the float.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SPAN'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SPAN</h5>
 
 <p>
 The <kbd>SPAN</kbd> argument tells mom that a float, if deferred,
@@ -786,7 +840,7 @@
 acceptable within floats that are given the <kbd>SPAN</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'INDENT'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">INDENT</h5>
 
 <p>
 <kbd>INDENT</kbd> allows you to indent a float from the left margin
@@ -795,22 +849,22 @@
 appended to it.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CENTER'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CENTER</h5>
 
 <p>
 <kbd>CENTER</kbd> instructs mom to center a float if it is not
 already centered by default.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'RIGHT'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">RIGHT</h5>
 
 <p>
-<kbd>RIGHT</kbd> instructs mom to place a float a the right of the
-page; the longest line in the float will be flush with the page's
-right margin.
+<kbd>RIGHT</kbd> instructs mom to place a float at the right of the
+page; the longest line in the float will be flush with the
+page&#8217;s right margin.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_SHIM'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_SHIM</h5>
 
 <p>
 <kbd>NO_SHIM</kbd> instructs mom not to apply
@@ -820,15 +874,15 @@
 after the float falls properly on the page&#8217;s
 <a href="definitions.html#baseline-grid">baseline grid</a>,
 but can result in slightly unequal spacing above and below
-(correctible with the <kbd>ADJUST</kbd> argument).
+(correctable with the <kbd>ADJUST</kbd> argument).
 <kbd>NO_SHIM</kbd> is useful when you have several floats on the
 page and there are visible differences in the spacing beneath them
 as a result of shimming.  To ensure a flush bottom margin, the last
-float on the page should be shimmed, ie should not be given the
+float on the page should be shimmed, i.e. should not be given the
 <kbd>NO_SHIM</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_FLEX'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_FLEX</h5>
 
 <p>
 <kbd>NO_FLEX</kbd> instructs mom not to apply
@@ -838,10 +892,10 @@
 on the page and you want to distribute excess vertical
 whitespace on the page amongst other flex-spacing points on the
 page.  If there are no others, the final float should be
-flex-spaced, ie not given the <kbd>NO_FLEX</kbd> argument.
+flex-spaced, i.e. not given the <kbd>NO_FLEX</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'TARGET'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">TARGET</h5>
 
 <p>
 <kbd>TARGET</kbd> followed by a unique name surrounded by
@@ -870,7 +924,7 @@
 <a href="definitions.html#filled">no-fill mode</a>,
 with each input line beginning at the left margin.  If this is not
 what you want, you must specify the preferred horizontal alignment
-<i>within the float</i> (e.g.,
+<i>within the float</i> (e.g.
 <a href="typesetting.html#lrc">CENTER</a>
 or
 <a href="typesetting.html#lrc">RIGHT</a>).
@@ -987,7 +1041,7 @@
 </div>
 
 <div class="box-macro-args">
-Macro: <b>LABEL</b></a>
+Macro: <b>LABEL</b>
 <kbd class="macro-args">"&lt;label&gt;"  CAPTION "&lt;caption&gt;"   SHORT_CAPTION  \
 <br/>
  TO_LIST FIGURES | TABLES | EQUATIONS </kbd>
@@ -1022,12 +1076,14 @@
 <h3  id="reserved-label-strings" class="docs" style="text-transform: none">Reserved variables for labels</h3>
 
 <p>
-Mom reserves strings you may use when entering label text after
-the <kbd>LABEL</kbd> argument. <kbd>\*chapter</kbd> holds the
-current chapter or major section number. <kbd>\*fig-label</kbd>,
-<kbd>\*tbl-label</kbd>, and <kbd>\*eqn-label</kbd>
-increment the label number of the appropriate label type by one,
-and are initially set to zero after each invocation of
+Mom reserves strings you may use when entering
+label text after the <kbd>LABEL</kbd> argument.
+<kbd><span class="nobr">\*chapter</span></kbd> holds the current chapter
+or major section number. <kbd><span class="nobr">\*fig-label</span></kbd>,
+<kbd><span class="nobr">\*tbl-label</span></kbd>, and
+<kbd><span class="nobr">\*eqn-label</span></kbd> increment the label number of
+the appropriate label type by one, and are initially set to zero
+after each invocation of
 <a href="docprocessing.html#start">START</a>
 when the
 <a href="docprocessing.html#doctype">DOCTYPE</a>
@@ -1043,7 +1099,8 @@
 
 <p>
 If your <b>DOCTYPE</b> is <kbd>DEFAULT</kbd> or <kbd>NAMED</kbd>,
-you must reset <kbd>\*&lt;type&gt;-label</kbd> after each
+you must reset <kbd><span class="nobr">\*&lt;type&gt;-label</span></kbd> after
+each
 <a href="docprocessing.html#collate">COLLATE</a>
 by entering
 <br/>
@@ -1056,7 +1113,7 @@
 <p>
 If
 <a href="#autolabel">autolabelling</a>
-is enabled, e.g., <kbd>.AUTOLABEL_IMAGES</kbd> (List
+is enabled, e.g. <kbd>.AUTOLABEL_IMAGES</kbd> (List
 of Figures) or <kbd>.AUTOLABEL_PIC</kbd> (also List of Figures),
 the prefix is stripped from the label when it appears in
 the List.  Thus, if you have invoked <kbd>.AUTOLABEL_PIC</kbd>,
@@ -1120,12 +1177,13 @@
 
 <p>
 If, for some reason, you want only the caption appended to the List,
-give <kbd>\&</kbd> as the first argument to LABEL, followed by
+give <kbd>\&amp;</kbd> as the first argument to LABEL, followed by
 <kbd>CAPTION&nbsp;&#8220;caption&#8221;</kbd>:
 <br/>
 <span class="pre-in-pp">
-  .LABEL \& \
-   CAPTION "caption"
+  .LABEL \&amp; \
+  CAPTION "caption"
+</span>
 </p>
 
 <div class="box-tip">
@@ -1146,6 +1204,7 @@
 <br/>
 <span class="pre-in-pp">
   .TO_FIGURES EQUATIONS
+</span>
 </p>
 </div>
 
@@ -1154,7 +1213,7 @@
 </div>
 
 <div class="box-macro-args">
-Macro: <b>CAPTION</b></a>
+Macro: <b>CAPTION</b>
 <kbd class="macro-args">"&lt;caption&gt;" \
 <br/>
  "&lt;additional line&gt;"  "&lt;additional line&gt;"...   \
@@ -1168,7 +1227,7 @@
 </p>
 
 <p>
-If you want a caption at the top, put <kbd>CAPTIO</kbd> immediately
+If you want a caption at the top, put <kbd>CAPTION</kbd> immediately
 underneath
 <a href="#float">FLOAT</a>
 and follow it with the text of the caption surrounded by double-quotes:
@@ -1222,19 +1281,19 @@
 <h2 id="preprocessor-support" class="docs">Preprocessor support</h2>
 
 <p>
-Mom offers full support for the <b>eqn</b> (equations),
-<b>pic</b> (diagrams), <b>tbl</b> (tables), and <b>refer</b>
-(bibliographies/citations) preprocessors, including captions,
-labelling, autolabelling, and inclusion in the Lists of Equations,
-Figures, and Tables.
+Mom offers full support for the <b>eqn</b> (equations), <b>pic</b>
+(diagrams), <b>grap</b> (graphs), <b>tbl</b> (tables) and
+<b>refer</b> (bibliographies/citations) preprocessors, including
+captions, labelling, autolabelling, and inclusion in the Lists of
+Equations, Figures, and Tables.
 </p>
 
 <p>
 Other than <b>refer</b>, which is discussed at length in the <a
 href="refer.html">Bibliographies and references</a> section, it is
 beyond the scope of this documentation to cover full preprocessor
-usage.  Consult the manpages <b>eqn(1)</b>, <b>pic(1)</b>, and
-<b>tbl(1)</b> for instructions.
+usage.  Consult the manpages <b>eqn(1)</b>, <b>pic(1)</b>,
+<b>grap(1)</b> and <b>tbl(1)</b> for instructions.
 </p>
 
 <div class="box-tip">
@@ -1251,7 +1310,7 @@
 
 <p>
 Mom documents can include tables generated with the groff
-preprocessor, <b>tbl</b>.  If you are unfamiliar with <b>tbl</b>, I
+preprocessor <b>tbl</b>.  If you are unfamiliar with <b>tbl</b>, I
 recommend downloading a copy of
 <a href="http://plan9.bell-labs.com/10thEdMan/tbl.pdf">Tbl - A Program to Format Tables</a>,
 which, in addition to providing a thorough introduction, contains
@@ -1311,7 +1370,7 @@
 will be printed at the top of each page&#8217;s table output.  In the
 event that there is not enough room to print the table header and
 at least one row of table data near the bottom of a page, mom will
-break to a new page before beginning table output, leaving a blank
+break to a new page before beginning table output, leaving a gap
 in
 <a href="definitions.html#running">running text</a>.
 </p>
@@ -1350,7 +1409,7 @@
 <a href="docprocessing.html#no-flex">NO_FLEX</a>,
 or by passing the <kbd>NO_SHIM</kbd> or <kbd>NO_FLEX</kbd> argument
 to <kbd>.TS</kbd>.  In either case, you will still likely want to
-adjust the spacing around with table with the <kbd>AJUST</kbd>
+adjust the spacing around with table with the <kbd>ADJUST</kbd>
 argument to <kbd>.TS</kbd>.  Tables inside floats should be adjusted
 with the <kbd>ADJUST</kbd> argument to
 <a href="#float">FLOAT</a>,
@@ -1396,7 +1455,7 @@
 <br/>
 Macro: <a href="#th"><b>TH</b></a> <kbd class="macro-args">(optional, only if .TS H)</kbd>
 <br/>
-Macro: <a href="#te"><b>TE</b></a> <kbd class="macro-args"> SOURCE "&lt;text of table source&gt;" 
+Macro: <a href="#te"><b>TE</b></a> <kbd class="macro-args"> SOURCE "&lt;text of table source&gt;" </kbd>
 </div>
 
 <p>
@@ -1459,7 +1518,7 @@
 <kbd>SHORT_CAPTION</kbd>, and/or <kbd>LABEL</kbd> last.
 </p>
 
-<h5 id="h" class="docs" style="margin-top: 1em; text-transform: none">'H'</h5>
+<h5 id="h" class="docs" style="margin-top: 1em; text-transform: none">H</h5>
 
 <p>
 With the <b>H</b> argument, a table will span as many pages as
@@ -1501,10 +1560,10 @@
 </p>
 </div>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'BOXED'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">BOXED</h5>
 
 <p>
-If a table is to be boxed (ie <kbd>tbl</kbd> is given the flags
+If a table is to be boxed (i.e., <kbd>tbl</kbd> is given the flags
 <kbd>'box'</kbd> or <kbd>'allbox'</kbd>) you must pass the argument
 <kbd>BOXED</kbd> to <kbd>.TS</kbd>, as in this example:
 <br/>
@@ -1519,10 +1578,10 @@
 </span>
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CENTER'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CENTER</h5>
 
 <p>
-If a table is to be centered on the page, (ie <kbd>tbl</kbd> is
+If a table is to be centered on the page, (i.e., <kbd>tbl</kbd> is
 given the <kbd>'center'</kbd> flag), you must pass the argument
 <kbd>CENTER</kbd> to <kbd>.TS</kbd>, as in this example, which
 creates a (possibly) multipage boxed table, centered on the page,
@@ -1542,17 +1601,17 @@
 </span>
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NEEDS'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NEEDS</h5>
 
 <p>
 If a table is not inside a float and you pass <kbd>.TS </kbd> the
 <kbd>H</kbd> argument (which you should; see the tip
 <a href="#h-tip">here</a>),
-mom begins output immediately where the table occurs in the input
-file <i>if there is enough room on the output page for the table
-header plus at least one row of table data</i>.  If there isn't
-enough room, mom breaks to a new page before beginning the table,
-leaving a gap in
+mom begins output immediately where the table occurs in the
+input file <i>if there is enough room on the output page for the
+table header plus at least one row of table data</i>.  If there
+isn&#8217;t enough room, mom breaks to a new page before beginning
+the table, leaving a gap in
 <a href="definitions.html#running">running text</a>
 at the bottom of the previous page.  If, for aesthetic reasons,
 you would prefer that mom require more than one row of table data
@@ -1561,17 +1620,18 @@
 number of rows.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'ADJUST'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">ADJUST</h5>
 
 <p>
-<kbd>ADJUST</kbd> lets you raise (<kbd>+</kbd>) or lower
-(<kbd>-</kbd>) the table <span style="font-style: italic">within
-the space allotted for it</span> by the amount you specify.  This
-is useful for achieving good optical centering between surrounding
-blocks of type.  A unit of measure is required.
+<kbd>ADJUST</kbd> lets you raise (<kbd>-</kbd>) or lower
+(<kbd>+</kbd>) the table
+<span style="font-style: italic">within the space allotted for it</span>
+by the amount you specify.  This is useful for achieving good
+optical centering between surrounding blocks of type.  A unit of
+measure is required.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_SHIM'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_SHIM</h5>
 
 <p>
 <kbd>NO_SHIM</kbd> instructs mom not to apply
@@ -1581,15 +1641,15 @@
 after the table falls properly on the page&#8217;s
 <a href="definitions.html#baseline-grid">baseline grid</a>,
 but can result in slightly unequal spacing above and below
-(correctible with the <kbd>ADJUST</kbd> argument).
+(correctable with the <kbd>ADJUST</kbd> argument).
 <kbd>NO_SHIM</kbd> is useful when you have several tables on the
 page and there are visible differences in the spacing beneath them
 as a result of shimming.  To ensure a flush bottom margin, the last
-table on the page should be shimmed, ie should not be given the
+table on the page should be shimmed, i.e. should not be given the
 <kbd>NO_SHIM</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_FLEX'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_FLEX</h5>
 
 <p>
 <kbd>NO_FLEX</kbd> instructs mom not to apply
@@ -1599,10 +1659,10 @@
 on the page and you want to distribute excess vertical
 whitespace on the page amongst other flex-spacing points on the
 page.  If there are no others, the final table should be
-flex-spaced, ie not given the <kbd>NO_FLEX</kbd> argument.
+flex-spaced, i.e. not given the <kbd>NO_FLEX</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CAPTION</h5>
 
 <p>
 <kbd>CAPTION</kbd> allows you to give the table a caption.  By
@@ -1621,7 +1681,7 @@
 <a href="#th">TH</a>.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SHORT_CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SHORT_CAPTION</h5>
 
 <p>
 <kbd>SHORT_CAPTION</kbd> allows you to trim long captions for
@@ -1629,7 +1689,7 @@
 by double-quotes, is what will appear in the List.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'LABEL'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">LABEL</h5>
 
 <p>
 <kbd>LABEL</kbd>, if given, appears beneath the table.  The text you
@@ -1640,7 +1700,7 @@
 which, if enabled, overrides the <kbd>LABEL</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'TARGET'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">TARGET</h5>
 
 <p>
 <kbd>TARGET</kbd> followed by a unique name surrounded by
@@ -1650,15 +1710,20 @@
 </p>
 
 <p>
+<b><i>Please note:</i></b> The following functionality is available
+only with groff 1.22.4 or later.
+</p>
+
+<p>
 When
 <a href="#autolabel">autolabelling</a>
 is enabled and the document is processed with
 <a href="using.html#pdfmom" style="font-weight: bold">pdfmom</a>,
 the target name can be used to generate the target&#8217;s label
-number in running text if it is entered as a groff string, ie of
-the form <kbd>\*name</kbd>.  For example, if you create a target
-called &#8220;foo&#8221; for a table whose autolabel number would be
-3, entering
+number in running text if it is entered as a groff string, i.e. of
+the form <kbd><span class="nobr">\*name</span></kbd>.  For example, if you
+create a target called &#8220;foo&#8221; for a table whose autolabel
+number would be 3, entering
 <br/>
 <span class="pre-in-pp">
   See
@@ -1690,7 +1755,7 @@
 your table has a caption), you can suppress it by placing
 <kbd>.TH</kbd> immediately underneath your <kbd>tbl</kbd> formatting
 specifications, the last line of which always ends with a period
-(see <kbd>tbl(1)</kbd>).</p>
+(see <kbd>tbl(1)</kbd>).
 </p>
 
 <p>
@@ -1721,7 +1786,7 @@
 
 <p>
 Mom documents can include diagrams generated with the groff
-preprocessor, <b>pic</b>.  If you are unfamiliar with <b>pic</b>, I
+preprocessor <b>pic</b>.  If you are unfamiliar with <b>pic</b>, I
 recommend downloading a copy of
 <a href="http://www.kohala.com/start/troff/gpic.raymond.ps">Making Pictures with GNU PIC</a>
 which provides a thorough introduction and contains many examples.
@@ -1734,7 +1799,10 @@
 Diagrams created with <kbd>pic</kbd> begin with the macro
 <kbd>.PS</kbd> (<b>P</b>ic <b>S</b>tart) and end with
 <kbd>.PE</kbd> (<b>P</b>ic <b>E</b>nd).  Everything between them is
-intrepreted by the preprocessor as pic instructions.
+interpreted by the preprocessor as pic instructions.  Please note:
+<i>Making Pictures with GNU PIC</i> says that <kbd>.PF</kbd> can
+also be used to terminate a pic diagram, but this is not supported
+by mom.
 </p>
 
 <p>
@@ -1776,13 +1844,11 @@
 Macro: <b>PS</b>
 <kbd class="macro-args">
 <br/>
-Arguments:
+Arguments:  &lt;width&gt;&nbsp;&lt;height&gt; 
+<kbd class="macro-args">
+<br/>
+&nbsp;&nbsp; LEFT </kbd>
 <br/>
-&nbsp;&nbsp; width </kbd> <span style="font-size: 95%">(in inches; no unit of measure required)</span>
-<kbd class="macro-args"><br/>
-&nbsp;&nbsp; height </kbd> <span style="font-size: 95%">(in
-inches; no unit of measure required)</span>
-<kbd class="macro-args"><br/>
 &nbsp;&nbsp; ADJUST +|-&lt;vertical adjustment&gt;</kbd>
 <span style="font-size: 95%">
 (<a href="definitions.html#unitofmeasure">unit of measure</a>
@@ -1823,44 +1889,59 @@
 <p>
 The <kbd>width</kbd> and <kbd>height</kbd> arguments to
 <kbd>.PS</kbd> are idiosyncratic owing to the preprocessor itself.
-If a width argument is supplied, the diagram, but not any text it
-contains, is scaled to the given width.  If a literal width argument
-of <kbd>0</kbd> (zero) is given and a height argument is supplied,
-the diagram, but not any text it contains, will be scaled to the
-requested height.  In the case of two non-zero arguments being
-given, only the height scaling is applied.
+Both are optional and both expect a value in inches, so neither
+argument should have a
+(<a href="definitions.html#unitofmeasure">unit of measure</a>
+appended.
+</p>
+
+<p>
+If the <kbd>width</kbd> argument is supplied, the diagram, but
+not any text it contains, is scaled to the given width.  If a
+literal width argument of <kbd>0</kbd> (zero) is given and a
+<kbd>height</kbd> argument is supplied, the diagram, but not any
+text it contains, will be scaled to the requested height.  In the
+case of two non-zero arguments being given, only the height scaling
+is applied.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'ADJUST'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">LEFT</h5>
 
 <p>
-<kbd>ADJUST</kbd> lets you raise (<kbd>+</kbd>) or lower
-(<kbd>-</kbd>) a diagram
+By default, pic diagrams are centred on the page.  If you would
+prefer them to be flush left, pass <kbd>PS</kbd> the <kbd>LEFT</kbd>
+argument.
+</p>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">ADJUST</h5>
+
+<p>
+<kbd>ADJUST</kbd> lets you raise (<kbd>-</kbd>) or lower
+(<kbd>+</kbd>) a diagram
 <span style="font-style: italic">within the space allotted for it</span>
 by the amount you specify.  This is useful for achieving good
 optical centering between surrounding blocks of type.  A unit of
 measure is required.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_SHIM'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_SHIM</h5>
 
 <p>
 <kbd>NO_SHIM</kbd> instructs mom not to apply
 <a href="docprocessing.html#shim-vs-flex">shimming</a>
-after a <b>pic</b> diagrame, which she will do automatically when
+after a <b>pic</b> diagram, which she will do automatically when
 shimming is enabled, which it is by default.  Shimming ensures that
-running text after the diagrame falls properly on the page&#8217;s
+running text after the diagram falls properly on the page&#8217;s
 <a href="definitions.html#baseline-grid">baseline grid</a>,
 but can result in slightly unequal spacing above and below
-(correctible with the <kbd>ADJUST</kbd> argument).
+(correctable with the <kbd>ADJUST</kbd> argument).
 <kbd>NO_SHIM</kbd> is useful when you have several diagrams on the
 page and there are visible differences in the spacing beneath them
 as a result of shimming.  To ensure a flush bottom margin, the last
-diagram on the page should be shimmed, ie should not be given the
+diagram on the page should be shimmed, i.e. should not be given the
 <kbd>NO_SHIM</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_FLEX'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_FLEX</h5>
 
 <p>
 <kbd>NO_FLEX</kbd> instructs mom not to apply
@@ -1870,10 +1951,10 @@
 have several diagrams on the page and you want to distribute excess
 vertical whitespace on the page amongst other flex-spacing points
 on the page.  If there are no others, the final diagram should be
-flex-spaced, ie not given the <kbd>NO_FLEX</kbd> argument.
+flex-spaced, i.e. not given the <kbd>NO_FLEX</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CAPTION</h5>
 
 <p>
 <kbd>CAPTION</kbd> allows you to give the diagram a caption.  By
@@ -1885,7 +1966,7 @@
 The text of the caption must be surrounded by double-quotes.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SHORT_CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SHORT_CAPTION</h5>
 
 <p>
 <kbd>SHORT_CAPTION</kbd> allows you to trim long captions for
@@ -1893,7 +1974,7 @@
 by double-quotes, is what will appear in the List.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'LABEL'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">LABEL</h5>
 
 <p>
 <kbd>LABEL</kbd>, if given, appears beneath the diagram.  The text you
@@ -1904,7 +1985,7 @@
 which, if enabled, overrides the <kbd>LABEL</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'TARGET'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">TARGET</h5>
 
 <p>
 <kbd>TARGET</kbd> followed by a unique name surrounded by
@@ -1914,15 +1995,20 @@
 </p>
 
 <p>
+<b><i>Please note:</i></b> The following functionality is available
+only with groff 1.22.4 or later.
+</p>
+
+<p>
 When
 <a href="#autolabel">autolabelling</a>
 is enabled and the document is processed with
 <a href="using.html#pdfmom" style="font-weight: bold">pdfmom</a>,
 the target name can be used to generate the target&#8217;s label
-number in running text if it is entered as a groff string, ie of
-the form <kbd>\*name</kbd>.  For example, if you create a target
-called &#8220;foo&#8221; for a diagram whose autolabel number would
-be 3, entering
+number in running text if it is entered as a groff string, i.e. of
+the form <kbd><span class="nobr">\*name</span></kbd>.  For example, if you
+create a target called &#8220;foo&#8221; for a diagram whose
+autolabel number would be 3, entering
 <br/>
 <span class="pre-in-pp">
   See
@@ -1934,7 +2020,7 @@
 link &#8220;Figure 5.3&#8221;.
 </p>
 
-
+
 
 <div class="macro-id-overline">
 <h3 id="pic-text-style" class= "macro-id">PIC_TEXT_STYLE</h3>
@@ -2026,8 +2112,9 @@
 the scope of this documentation, but is covered in the manpage
 <kbd>eqn(1)</kbd>.  You can also download a copy of Ted
 Harding&#8217;s
-
-<a href="http://www.zen89632.zen.co.uk/Groff/Eqn/eqnguide.pdf">A Guide to Typesetting Mathematics Using GNU eqn</a>,
+<a href="http://lists.gnu.org/archive/html/groff/2013-10/pdfTyBN2VWR1c.pdf">
+A Guide to Typesetting Mathematics Using GNU eqn
+</a>,
 which contains useful examples.  If you use <b>eqn</b>, you must give groff or
 pdfmom the <b>-e</b> flag.
 
@@ -2042,7 +2129,7 @@
 <br/>
 <kbd class="macro-args">Arguments:
 <br/>
-&nbsp;&nbsp; -L | -C | -I &lt;ident&gt; </kbd>
+&nbsp;&nbsp; -L | -C | -I &lt;indent&gt; </kbd>
 <span style="font-size: 95%">
 (<a href="definitions.html#unitofmeasure">unit of measure</a>
 required)
@@ -2068,7 +2155,7 @@
 <br/>
 &nbsp;&nbsp; TARGET "&lt;name&gt;" 
 <br/>
-Macro: <a href="#en"><b>EN</b></a> <kbd class="macro-args">  CONTINUED | CONT | ... </kbd>
+&nbsp;&nbsp; CONTINUED | CONT | ... </kbd>
 </div>
 
 <div class="box-tip">
@@ -2111,18 +2198,18 @@
 <kbd>.EQ</kbd>.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'ADJUST'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">ADJUST</h5>
 
 <p>
-<kbd>ADJUST</kbd> lets you raise (<kbd>+</kbd>) or lower
-(<kbd>-</kbd>) an equation
+<kbd>ADJUST</kbd> lets you raise (<kbd>-</kbd>) or lower
+(<kbd>+</kbd>) an equation
 <span style="font-style: italic">within the space allotted for it</span>
 by the amount you specify.  This is useful for achieving good
 optical centering between surrounding blocks of type.  A unit of
 measure is required.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_SHIM'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_SHIM</h5>
 
 <p>
 <kbd>NO_SHIM</kbd> instructs mom not to apply
@@ -2132,15 +2219,15 @@
 after the equation falls properly on the page&#8217;s
 <a href="definitions.html#baseline-grid">baseline grid</a>,
 but can result in slightly unequal spacing above and
-below (correctible with the <kbd>ADJUST</kbd> argument).
+below (correctable with the <kbd>ADJUST</kbd> argument).
 <kbd>NO_SHIM</kbd> is useful when you have several equations on the
 page and there are visible differences in the spacing beneath them
 as a result of shimming.  To ensure a flush bottom margin, the last
-equation on the page should be shimmed, ie should not be given the
+equation on the page should be shimmed, i.e. should not be given the
 <kbd>NO_SHIM</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'NO_FLEX'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">NO_FLEX</h5>
 
 <p>
 <kbd>NO_FLEX</kbd> instructs mom not to apply
@@ -2150,18 +2237,17 @@
 equations on the page and you want to distribute excess vertical
 whitespace on the page amongst other flex-spacing points on
 the page.  If there are no others, the final equation should be
-flex-spaced, ie not given the <kbd>NO_FLEX</kbd> argument.
+flex-spaced, i.e. not given the <kbd>NO_FLEX</kbd> argument.
 </p>
 
-</p>
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">CAPTION</h5>
 
 <p>
 <kbd>CAPTION</kbd> allows you to give the equation a caption.  
 Equation captions always appear beneath the equation.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SHORT_CAPTION'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SHORT_CAPTION</h5>
 
 <p>
 <kbd>SHORT_CAPTION</kbd> allows you to trim long captions for
@@ -2169,7 +2255,7 @@
 by double-quotes, is what will appear in the List.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'LABEL'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">LABEL</h5>
 
 <p>
 <kbd>LABEL</kbd>, if given, appears on the same baseline as the last line of the
@@ -2182,7 +2268,7 @@
 which, if enabled, overrides the <kbd>LABEL</kbd> argument.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'SHIFT_LABEL'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">SHIFT_LABEL</h5>
 
 <p>
 <kbd>SHIFT_LABEL</kbd> allows you to raise (<kbd>-</kbd>) or lower
@@ -2193,7 +2279,7 @@
 one line, thus centering it vertically on the equation.
 </p>
 
-<h5 class="docs" style="margin-top: 1em; text-transform: none">'TARGET'</h5>
+<h5 class="docs" style="margin-top: 1em; text-transform: none">TARGET</h5>
 
 <p>
 <kbd>TARGET</kbd> followed by a unique name surrounded by
@@ -2203,15 +2289,20 @@
 </p>
 
 <p>
+<b><i>Please note:</i></b> The following functionality is available
+only with groff 1.22.4 or later.
+</p>
+
+<p>
 When
 <a href="#autolabel">autolabelling</a>
 is enabled and the document is processed with
 <a href="using.html#pdfmom" style="font-weight: bold">pdfmom</a>,
 the target name can be used to generate the target&#8217;s label
-number in running text if it is entered as a groff string, ie of
-the form <kbd>\*name</kbd>.  For example, if you create a target
-called &#8220;foo&#8221; for an equation whose autolabel number
-would be 3, entering
+number in running text if it is entered as a groff string, i.e. of
+the form <kbd><span class="nobr">\*name</span></kbd>.  For example, if you
+create a target called &#8220;foo&#8221; for an equation whose
+autolabel number would be 3, entering
 <br/>
 <span class="pre-in-pp">
   See
@@ -2235,17 +2326,17 @@
 <p>
 If an equation needs to span multiple lines, possibly aligned
 with <b>eqn</b>&#8217;s <kbd>'mark'</kbd> and <kbd>'lineup'</kbd>
-directives, separate invocations of <kbd>.EQ/.EN</kbd> are required
-for each line, and the optional argument, <kbd>CONTINUED</kbd> (or
-<kbd>CONT</kbd>, or <kbd>...</kbd> three dots, an ellipsis), must
-be passed to <kbd>.EN</kbd>.
+directives, separate invocations of <kbd><span class="nobr">.EQ/.EN</span></kbd>
+are required for each line, and the optional argument,
+<kbd>CONTINUED</kbd> (or <kbd>CONT</kbd>, or <kbd>...</kbd> three
+dots, an ellipsis), must be passed to <kbd>.EN</kbd>.
 </p>
 
 <p>
 If <kbd>-L</kbd> or <kbd>-I</kbd> is given to the first
 <kbd>.EQ</kbd> of a multi-line equation, they remain in effect
-until the final <kbd>.EN</kbd>, which does not have the
-<kbd>CONTINUED</kbd> argument.
+until an <kbd>.EN</kbd> without the <kbd>CONTINUED</kbd> argument
+is reached.
 </p>
 
 <p>
@@ -2346,7 +2437,7 @@
 Autolabelling may be disabled on-the-fly by giving any argument
 other than <kbd>PREFIX</kbd>, <kbd>SUFFIX</kbd>, or
 <kbd>PREFIX_CHAPTER</kbd> to the appropriate macro.  For example,
-</br>
+<br/>
 <span class="pre-in-pp">
   .AUTOLABEL_IMAGES NO
 </span>
@@ -2358,9 +2449,9 @@
 <p>
 By default, when <b>AUTOLABEL</b> is enabled, the label numbers are
 prefixed, and, in the case of equations, suffixed, with strings such
-that they appear for tables as &#8220;Table &lt;n&gt;&#8221;, for
-<b>pic</b> diagrams and pdf images as &#8220;Fig. &lt;n&gt;&#8221;,
-and for equations as &#8220;(&lt;n&gt;)&#8221;.
+that they appear for tables as &#8220;Table&nbsp;&lt;n&gt;&#8221;, for
+<b>pic</b> diagrams and pdf images as &#8220;Fig.&nbsp;&lt;n&gt;&#8221;,
+and for equations as &#8220;Eq.&nbsp;(&lt;n&gt;)&#8221;.
 </p>
 
 <p>
@@ -2420,12 +2511,13 @@
 <a href="docprocessing.html#doctype">DOCTYPE&nbsp;DEFAULT</a>
 as if it were <b>DOCTYPE&nbsp;CHAPTER</b>, hence, with
 <kbd>PREFIX_CHAPTER</kbd>, each collated <b>DEFAULT</b>
-doctype's prefixed &#8220;chapter&#8221; number is incremented
-and the label number itself reset to &#8220;1&#8221;.  If
-you do not give <kbd>PREFIX_CHAPTER</kbd>, the label number
-is <i>not</i> reset automatically.  To reset it, invoke
+doctype&#8217;s prefixed &#8220;chapter&#8221; number is
+incremented and the label number itself reset to &#8220;1&#8221;.
+If you do not supply the <kbd>PREFIX_CHAPTER</kbd> argument, the
+label number is <i>not</i> reset automatically.  To reset it, invoke
 <kbd>.AUTOLABEL_&lt;type&gt;</kbd> after each
 <a href="docprocessing.html#collate">COLLATE</a>.
+</p>
 </div>
 
 <div id="set-autolabel" class="box-macro-args" style="margin-top: .5em">
@@ -2466,8 +2558,7 @@
 </div>
 
 <div class="box-macro-args" style="margin-top: .5em">
-Macro: <b>CAPTION_AFTER_LABEL</b> <kbd class="macro-args">IMG | PIC | TBL | ALL  &lt;anything&gt;</kbd> 
-</kbd>
+Macro: <b>CAPTION_AFTER_LABEL</b> <kbd class="macro-args">IMG | PIC | TBL | ALL  &lt;anything&gt; </kbd>
 </div>
 
 <p>
@@ -2498,8 +2589,8 @@
 <p>
 If
 <a href="#mla">MLA</a>
-is enabled, there's no need to invoke <kbd>CAPTION_AFTER_LABEL</kbd>
-as this is implied.
+is enabled, there&#8217;s no need to invoke
+<kbd>CAPTION_AFTER_LABEL</kbd> as this is implied.
 </p>
 
 <div class="box-tip">
@@ -2526,8 +2617,7 @@
 </div>
 
 <div class="box-macro-args" style="margin-top: .5em">
-Macro: <b>MLA</b> <kbd class="macro-args">  &lt;anything&gt;</kbd> 
-</kbd>
+Macro: <b>MLA</b> <kbd class="macro-args">  &lt;anything&gt; </kbd>
 </div>
 
 <p>
@@ -2639,8 +2729,8 @@
 Regardless of the quad direction, captions, labels and sources
 are set on the width of the figure, table, or pdf image
 unless you pass the optional <kbd>ON_LL</kbd> argument to
-<kbd>QUAD&nbsp;&lt;direction&gt;</kbd>, in which case the prevailing
-document line length is used instead.
+<kbd><span class="nobr">QUAD&nbsp;&lt;direction&gt;</span></kbd>, in which case
+the prevailing document line length is used instead.
 </p>
 
 <h5 class="docs" style="text-transform: none">&bull;&nbsp;eqn</h5>
@@ -2651,9 +2741,10 @@
 equation positioning, which is, again by default, centered.  If the
 equation is positioned left, the label will appear at the right
 margin regardless of the direction you give to <kbd>QUAD</kbd>.  If
-the equation is indented with the <kbd>-I&nbsp;&lt;indent&gt;</kbd>
-option, a quad direction of <kbd>LEFT</kbd> is observed, but may
-overprint the last line of the equation.
+the equation is indented with the
+<kbd><span class="nobr">-I&nbsp;&lt;indent&gt;</span></kbd> option, a quad
+direction of <kbd>LEFT</kbd> is observed, but may overprint the last
+line of the equation.
 </p>
 
 <p>
@@ -2751,8 +2842,8 @@
 </p>
 
 <p>
-Also like the Table of Contents, entries in the Lists' output are
-clickable PDF links when a document is viewed at the screen.
+Also like the Table of Contents, entries in the Lists&#8217; output
+are clickable PDF links when a document is viewed at the screen.
 </p>
 
 <h3 id="lists-placement" class="docs">Placement of Lists</h3>
@@ -2796,6 +2887,7 @@
 <kbd class="macro-args">Arguments:
 <br/>
 &nbsp;&nbsp; TITLE_STRING "&lt;string&gt;"   START_PAGENUM &lt;page number&gt; 
+</kbd>
 </div>
 
 <p>
@@ -2992,6 +3084,418 @@
 <kbd>NO_PAGINATION</kbd> disables pagination of Lists pages.
 </p>
 
+<h2 id="box-intro" class="docs">Shaded backgrounds and frames (boxes)</h2>
+
+<p>
+Mom lets you add shaded backgrounds and frames to text and other
+material.  For convenience, she calls backgrounds and frames
+&#8220;boxes.&#8221; Entire passages may be boxed, or individual
+document elements like headings, quotes, or pre-processor output.
+Furthermore, boxes may be nested.
+</p>
+
+<p>
+Boxes start on the baseline where the boxed material would have
+started were it not for the box, subject to minor aesthetic
+corrections mom takes the liberty of making.
+</p>
+
+<p>
+Boxes extend from the current left margin to the current right
+margin, respecting any active left and/or right indents.  There are
+two exceptions,
+<a href="docelement.html#epigraph">EPIGRAPH BLOCK</a>
+and
+<a href="docelement.html#blockquote">BLOCKQUOTE</a>,
+which are discussed
+<a href="#quotes">here</a>.
+</p>
+
+<p>
+After a box is started, active left and right indents are
+cleared.  The box&#8217;s inset determines the new left and right
+margins.  Indents set inside a box are relative to the inset.
+When a box is stopped, formerly active left and right indents
+are restored.
+</p>
+ 
+<p>
+Frames are drawn from the perimeter inward.  The inset is
+relative to the inner edge of the frame.
+</p>
+
+<p>
+If a box (including the bottom inset) can complete on a page, it
+does, even if there is no further room for type.  This may, on
+occasion, result in slight deviations from normal bottom margin
+alignment.
+</p>
+
+<p>
+Boxes span pages whenever the boxed material continues on the next
+page.  Spanning boxes extend fully to the bottom margin of the page
+on which they begin, leaving a slightly larger inset at the bottom
+than around the other sides.
+</p>
+
+<p>
+When there is not enough room to set at least one line of type
+inside a box, mom defers starting the box until the next page,
+leaving a gap.
+</p>
+
+<p>
+Boxed material is not
+<a href="docprocessing.html#shim-vs-flex">shimmed</a>
+or
+<a href="docprocessing.html#shim-vs-flex">flexed</a>.
+If either was active prior to the box, it is restored when the box
+ends and mom automatically shims or flexes whatever comes next.
+</p>
+
+<div class="box-tip">
+<p class="tip">
+<span class="important">NOTE:</span>
+Shaded backgrounds and frames are not available when your
+<a href="docprocessing.html#printstyle">PRINTSTYLE</a>
+is <kbd>TYPEWRITE</kbd> or when
+<a href="docprocessing.html#columns">COLUMNS</a> are enabled.
+</p>
+</div>
+
+<div class="macro-id-overline">
+<h3 id="box" class= "macro-id">BOX</h3>
+</div>
+
+<div id="box-macro" class="box-macro-args" style="margin-top: .5em">
+Macro: <b>BOX</b> <kbd class="macro-args">  &lt;arguments&gt;  | &lt;anything&gt;
+<br/>
+Arguments:
+<br/>
+ SHADED &lt;color&gt; | OUTLINED &lt;colour&gt;  \
+<br/>
+ INSET &lt;dist&gt;  \
+<br/>
+ WEIGHT &lt;wt&gt;  \
+<br/>
+ ADJUST +|-&lt;amount&gt;  \
+<br/>
+ EQN | PIC | GRAP | IMG 
+</kbd>
+</div>
+
+<p>
+Without arguments, BOX begins a shaded grey background.
+The material inside is inset by one
+<a href="definitions.html#picaspoints">pica</a>.
+Any other type of box requires at a minimum either
+<kbd>SHADED</kbd> or <kbd>OUTLINED</kbd>.  In the case of boxes
+that are to contain pdf images or pre-processor material for
+<a href="#eqn">eqn</a>,
+<a href="#pic">pic</a>,
+or
+<a href="#grap">grap</a>,
+<kbd>IMG</kbd>, <kbd>EQN</kbd>, <kbd>PIC</kbd>, or <kbd>GRAP</kbd>
+must also be given.  Note that
+<a href="#tbl">tbl</a>
+does not have this requirement.
+</p>
+
+<p>
+BOX is a
+<a href="definitions.html#toggle">toggle macro</a>,
+so any argument other than one in the list completes the box
+(<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc).
+</p>
+
+<p>
+Boxes should be started inside toggle macros like
+<a href="docelement.html#quote">QUOTE</a>
+or
+<a href="#float">FLOAT</a>
+just after the macro is called, and terminated just before toggling
+the macro off (unless you wish the box to enclose further material).
+</p>
+
+<p>
+Non-toggle macros like
+<a href="docelement.html#heading">HEADING</a>
+or
+<a href="docelement.html#pp">PP</a>
+require that the box be started beforehand.  Boxed pre-processor
+material must be fully enclosed by BOX&nbsp;/&nbsp;BOX&nbsp;OFF, as
+in this recipe for a one-off boxed pic diagram:
+<span class="pre-in-pp">
+.BOX
+.PS
+&lt;pic commands&gt;
+.PE
+.BOX OFF
+</span>
+Arguments to BOX are not sticky.  Each time you invoke BOX, you
+must invoke it with arguments unless you want mom&#8217;s default grey
+background.  If all or several boxes in a document require the same
+arguments, create a macro at the top of the input file that calls
+BOX with the arguments you want, e.g.
+<span class="pre-in-pp">
+&nbsp;&nbsp;.de PINK_BOX
+&nbsp;&nbsp;.BOX \
+&nbsp;&nbsp;&nbsp;&nbsp;SHADED pink \
+&nbsp;&nbsp;&nbsp;&nbsp;OUTLINED darkred \
+&nbsp;&nbsp;&nbsp;&nbsp;WEIGHT 1p \
+&nbsp;&nbsp;&nbsp;&nbsp;INSET 9p
+&nbsp;&nbsp;..
+</span>
+<kbd>.PINK_BOX</kbd> may then be used instead of <kbd>.BOX</kbd> any
+time you want a box with those arguments.
+</p>
+
+<h3 class="docs">SHADED | OUTLINED</h3>
+
+<p>
+<kbd>SHADED</kbd> or <kbd>OUTLINED</kbd> are required.  Both may
+be given, resulting in a shaded background with a frame, and both
+require a colour, e.g.
+<span class="pre-in-pp">
+&nbsp;&nbsp;.BOX SHADED blue OUTLINED black
+</span>
+The colour may be
+</p>
+
+<ul style="margin-top: -1em;">
+  <li>an xcolor name</li>
+  <li>a colour initialized with
+      <a href="color.html#newcolor">NEWCOLOR</a>
+      or
+      <a href="color.html#xcolor">XCOLOR</a>
+  </li>
+  <li>an RGB hexadecimal string beginning with (e.g. #FF0000)</li>
+</ul>
+
+<p>
+Note that without <kbd>SHADED</kbd>, the above would simply draw a
+black frame.
+</p>
+
+<h3 class="docs">WEIGHT</h3>
+
+<p>
+Mom&#8217;s default weight for <kbd>OUTLINED</kbd> is 1/2
+<a href="definitions.html#picaspoints">point</a>.
+If you&#8217;d like to change it, give <kbd>WEIGHT</kbd> the desired
+value with a unit of measure appended, typically points, e.g.
+<span class="pre-in-pp">
+&nbsp;&nbsp;.BOX OUTLINED black WEIGHT 1p
+</span>
+</p>
+
+<h3 class="docs">INSET</h3>
+
+<p>
+Mom&#8217;s default inset for boxes is one
+<a href="definitions.html#picaspoints">pica</a>
+on all sides.  If you&#8217;d like a larger or smaller inset, give
+<kbd>INSET</kbd> the distance you want with a unit of measure
+appended, e.g.
+<span class="pre-in-pp">
+&nbsp;&nbsp;.BOX SHADED pink INSET 2m
+</span>
+</p>
+
+<h3 class="docs">ADJUST</h3>
+
+<p>
+If you are not happy with the starting position of a box, you can
+change it by giving <kbd>ADJUST</kbd> the distance you want it
+raised (-) or lowered (+) with a unit of measure appended.  For
+example, to lower a box three points,
+<span class="pre-in-pp">
+&nbsp;&nbsp;.BOX OUTLINED black ADJUST +3p
+</span>
+To raise it,
+<span class="pre-in-pp">
+&nbsp;&nbsp;.BOX OUTLINED black ADJUST -3p
+</span>
+</p>
+
+<h3 class="docs">PIC / GRAP / EQN / IMG</h3>
+
+<p>
+The <kbd>PIC</kbd> argument must be given to BOX if the box contains
+any
+<a href="#pic">pic</a>
+diagrams.  Likewise, graphs made with
+<a href="#grap">grap</a>,
+equations made with
+<a href="#eqn">eqn</a>,
+and
+<a href="#pdf-image">pdf images</a>
+require a corresponding <kbd>GRAP</kbd>, <kbd>EQN</kbd>, or
+<kbd>IMG</kbd> argument.
+</p>
+
+<p>
+If you&#8217;re boxing a single diagram, graph, or pdf image, wrap
+it in a float, like this:
+<span class="pre-in-pp">
+&nbsp;&nbsp;.FLOAT
+&nbsp;&nbsp;.BOX PIC &lt;other parameters&gt;
+&nbsp;&nbsp;.PS
+&nbsp;&nbsp;&lt;pic input&gt;
+&nbsp;&nbsp;.PE
+&nbsp;&nbsp;.BOX OFF
+&nbsp;&nbsp;.FLOAT OFF
+</span>
+Notice that in the case of pdf images, pic, and grap, this
+represents a change from the norm, where the use of FLOAT may be
+destructive and is discouraged.
+</p>
+
+<h2 id="box-notes" class="docs">Additional notes on BOX usage and behaviour</h2>
+
+<h3 id="qbef" class="docs">QUOTE, BLOCKQUOTE, EPIGRAPH, FLOAT</h3>
+
+<p>
+<a href="docelement.html#quote">QUOTE</a>,
+<a href="docelement.html#blockquote">BLOCKQUOTE</a>,
+<a href="docelement.html#epigraph">EPIGRAPH</a>,
+and
+<a href="images.html#float">FLOAT</a>
+require that boxes be started <i>after</i> they are
+invoked and stopped just before they are toggled off:
+<span class="pre-in-pp">
+&nbsp;&nbsp;.QUOTE
+&nbsp;&nbsp;.BOX &lt;parameters&gt;
+&nbsp;&nbsp;Text of quote
+&nbsp;&nbsp;.BOX OFF
+&nbsp;&nbsp;.QUOTE OFF
+</span>
+</p>
+
+<h3 id="code" class="docs">CODE</h3>
+
+<p>
+If you&#8217;re boxing 
+<a href="docelement.html#code">CODE</a>
+that&#8217;s wrapped inside
+<a href="docelement.html#quote">QUOTE</a>,
+as described
+<a href="docelement.html#quote-code">here</a>,
+set the quote indent to &#8220;0&#8221; with
+<span class="pre-in-pp">
+&nbsp;&nbsp;.QUOTE_STYLE INDENT 0
+</span>
+so that the box&#8217;s leftmost inset is respected.  
+</p>
+
+<p>
+Here&#8217;s a recipe for setting boxed code with an 18-point inset:
+<span class="pre-in-pp">
+&nbsp;&nbsp;.QUOTE_STYLE INDENT 0
+&nbsp;&nbsp;.QUOTE
+&nbsp;&nbsp;.CODE
+&nbsp;&nbsp;.BOX INSET 18p
+&nbsp;&nbsp;Hello, world.
+&nbsp;&nbsp;.BOX OFF
+&nbsp;&nbsp;.QUOTE OFF
+</span>
+Note that CODE, wrapped inside QUOTE, does not require a corresponding CODE OFF.
+</p>
+
+<h4 id="quotes" class="docs">Description of boxed BLOCKQUOTES and EPIGRAPH BLOCKS</h4>
+
+<p>
+When you box a BLOCKQUOTE, or an EPIGRAPH with the <kbd>BLOCK</kbd>
+argument, the box is centred on the page and is only as wide as the
+blockquote or epigraph plus the box&#8217;s inset.
+</p>
+
+<p>
+QUOTE and EPIGRAPH (without the <kbd>BLOCK</kbd> argument), on the
+other hand, set the box fully to the left and right margins.
+</p>
+
+<h4 id="leftover" class="docs">Leftover box syndrome</h4>
+
+<p>
+Boxed quotes and blockquotes sometimes exhibit leftover box
+syndrome, where the page after a fully terminated boxed quote or
+blockquote begins with an empty bit of box.  Equally, you may
+sometimes see the lower edge of a quote&#8217;s or
+blockquote&#8217;s box falling slightly below the page&#8217;s
+bottom margin.
+</p>
+
+<p>
+The solution in both situations is to use the <kbd>ADJUST</kbd>
+argument to raise or lower the box&#8217;s starting position.
+Leftover box syndrome is usually fixed by raising the box slightly.
+When the box runs too deep, lowering it is generally recommended,
+although this will result in a widowed line at the top of the next
+page.  In either case, some experimentation is necessary.
+</p>
+
+<h3 id="slides" class="docs">SLIDES</h3>
+
+<p>
+On a slide with no pauses, boxes behave as they do in printed
+documents.
+</p>
+
+<p>
+When a slide contains pauses, only the material up to the first
+pause is boxed.  As subsequent material is revealed, the box changes
+location, moving down to surround each new item.  This behaviour
+persists until the box is stopped, making it useful for highlighting
+material as it is revealed.
+</p>
+
+<h3 id="footnotes" class="docs">Footnotes</h3>
+
+<p>
+You don&#8217;t have to worry about boxes encroaching on footnotes.
+Mom makes sure they don&#8217;t.
+</p>
+
+<h2 id="page-color-intro" class="docs">Page colour</h2>
+
+<p>
+Mom lets you change the page (&#8220;paper&#8221;) colour
+from white to anything you like.  While this has limited application
+in printed documents, it can be effective in
+<a href="docprocessing.html#slides">slide presentations</a>.
+</p>
+
+<div class="macro-id-overline">
+<h3 id="page-color" class= "macro-id">PAGE_COLOR</h3>
+</div>
+
+<div id="page-color-macro" class="box-macro-args" style="margin-top: .5em">
+Macro: <b>PAGE_COLOR</b> <kbd class="macro-args"> &lt;color&gt; | OFF | off</kbd>
+</div>
+<p class="requires" style="font-style: normal">
+<i>Aliased as</i> <kbd>PAGE_COLOUR</kbd>, <kbd>SLIDE_COLOR</kbd>,
+<i>and</i> <kbd>SLIDE_COLOUR</kbd>.
+</p>
+
+<p>
+When you invoke PAGE_COLOR with a <kbd>color</kbd> argument, the
+current and subsequent pages turn the colour you request.  If
+more than one instance of PAGE_COLOR appears before a page break,
+including <kbd>PAGE_COLOR OFF</kbd>, only the last applies.
+</p>
+
+<div class="box-tip">
+<p class="tip">
+<span class="note">Note:</span>
+Unlike other
+<a href="definitions.html#toggle">toggle macros</a>,
+PAGE_COLOR requires the use of <kbd>OFF</kbd> or <kbd>off</kbd>
+to terminate it rather than an arbitrary string (<kbd>OFF</kbd>,
+<kbd>QUIT</kbd>, <kbd>END</kbd>, <kbd>X</kbd>, etc).
+</p>
+</div>
+
 <div class="rule-long"><hr/></div>

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/inlines.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/inlines.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/intro.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/intro.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/letters.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/letters.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/macrolist.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/macrolist.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/rectoverso.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/rectoverso.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/refer.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/refer.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/reserved.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/reserved.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/stylesheet.css -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/stylesheet.css Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 2004-2018  Free Software Foundation, Inc. */
+/* Copyright (C) 2004-2020 Free Software Foundation, Inc. */
 /* This file is part of mom, which is part of groff, a free software */
 /* project. */
 
@@ -27,7 +27,7 @@
 
 .page /* Page setup: page color, size and border */
 {
-  width: 760px ;
+  width: 67% ;
   position: relative ;
   top: 12px ;
   bottom: 12px ;
@@ -37,6 +37,13 @@
   color: #302419 ;
   background-color: #ffffeb ;
   font: 1em/1.5em arial,sans-serif ;
+  font-variant-ligatures: none;
+}
+
+.nobr /* Make <nobr> a class property */
+{
+  white-space: nowrap ;
+  hyphens: none ;
 }
 
 /* Heads */
@@ -206,13 +213,11 @@
 .box-macro-args /* Macro name+args */
 {
   display: block ;
-  width: 736px ;
-  max-width: 736px ;
   border: solid 1px #302419 ;
   padding-top: 5px ;
   padding-bottom: 3px ;
-  padding-left: 12px ;
-  padding-right: 12px ;
+  padding-left: 15px ;
+  padding-right: 15px ;
   background-color: #ffffff ;
   white-space: nowrap ;
   overflow: auto ;
@@ -220,8 +225,7 @@
 .box-code
 {
   display: block ;
-  width: 679px ;
-  max-width: 679px ;
+  width: 100% ;
   border: solid 1px #302419 ;
   padding-top: 5px ;
   padding-bottom: 18px ;

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/tables-of-contents.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/tables-of-contents.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/toc.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/toc.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/typesetting.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/typesetting.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/using.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/using.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/momdoc/version-2.html -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/momdoc/version-2.html Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/mom/om.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/mom/om.tmac Changed

@@ -1,7 +1,7 @@
 .ig
 Mom -- a typesetting/document-processing macro set for groff.
 
-Copyright (C) 2002-2018  Free Software Foundation, Inc.
+Copyright (C) 2002-2020  Free Software Foundation, Inc.
  Written by Peter Schaffter <peter@schaffter.ca>
  PDF integration contributed by Deri James <deri.james@chuzzlewit.co.uk>
 
@@ -20,8 +20,8 @@
 You should have received a copy of the GNU General Public License
 along with this program. If not, see <http://www.gnu.org/licenses/>.
 
-Version 2.4
------------
+Version 2.5_d
+-------------
 Antoine de St-Exupéry asserted that elegance in engineering is
 achieved not when there is nothing left to add, but when there is
 nothing left to take away.
@@ -41,7 +41,6 @@
 Deri James (pdf integration), Robin Haberkorn (tbl integration, eqn
 extensions, and float management).
 ..
-.\" %beginstrip%
 \#
 \# ====================================================================
 \#
@@ -54,7 +53,7 @@
 .if (\n.x\n.y < 118) \
 .   ab mom: You need GNU troff version 1.18 or higher to run this version of mom.
 \# Mom version
-.ds version 2.4
+.ds version 2.5_d
 .if dVERSION \{\
 .   ab mom: Version \*version
 .\}
@@ -468,7 +467,7 @@
 .    ie !\\n#DOCS=1 \
 .       if \\n#B_MARGIN_SET=1 .DO_B_MARGIN
 .    el \{\
-.       if \\n#COLUMNS=1 .nr #COL_NUM \\n#NUM_COLS
+.       if (\\n#COLUMNS=1):(\\n#COLUMNS=2) .nr #COL_NUM \\n#NUM_COLS
 .       if !\\n#FN_DEPTH \{\
 .          ch FN_OVERFLOW_TRAP
 .          nr #RESET_FN_OVERFLOW_TRAP 1
@@ -478,13 +477,15 @@
 .       if \\n#FLEX_ACTIVE \
 .          if !\\n#NO_FLEX \
 .             tm .ds pre-newpage-\\n% \\n%@\\n#COL_NUM
-.    if (\\n@TOP=0):(\\n#END_COVER=1) \
-.       bp
-.    rr #END_COVER
-.    if \\n#RESET_FN_OVERFLOW_TRAP \{\
-.       wh -\\n#FN_OVERFLOW_TRAP_POSu FN_OVERFLOW_TRAP
-.       rr #RESET_FN_OVERFLOW_TRAP_POS
-.   \}
+.    ie \\n#DOCS=1 \{\
+.       if (\\n@TOP=0):(\\n#END_COVER=1) .bp
+.       rr #END_COVER
+.       if \\n#RESET_FN_OVERFLOW_TRAP \{\
+.          wh -\\n#FN_OVERFLOW_TRAP_POSu FN_OVERFLOW_TRAP
+.          rr #RESET_FN_OVERFLOW_TRAP_POS
+.      \}
+.    \}
+.    el .if !\\n#B_MARGIN_SET=1 .bp
 .END
 \#
 .ALIAS NEWSLIDE NEWPAGE
@@ -653,7 +654,16 @@
 .          nr #RESET_TRAPS 1
 .       \}
 .    \}
-.    el .if \\n#AUTO_LEAD .vs \\n.psu+\\n#AUTOLEADINGu
+.    el \{\
+.       if \\n#AUTO_LEAD \{\
+.          nr #SAVED_VS \\n.v
+.          vs \\n.psu+\\n#AUTOLEADINGu
+.       \}
+.    \}
+.    if \\npdfbx-running=1 \{\
+.       nr #VS_DIFF \\n#SAVED_VS-\\n.v
+.       ch FOOTER \\n#VARIABLE_FOOTER_POSu+\\n#VS_DIFFu
+.    \}
 .END
 \#
 \# SIZE (inline)
@@ -690,7 +700,12 @@
 .       rr #AUTOLEAD_VALUE
 .       rr #AUTOLEADING
 .    \}
+.    nr #SAVED_VS \\n.v
 .    vs \\$1
+.    if \\npdfbx-running=1 \{\
+.       nr #VS_DIFF \\n#SAVED_VS-\\n.v
+.       ch FOOTER \\n#VARIABLE_FOOTER_POSu+\\n#VS_DIFFu
+.    \}
 .    if !\\n#START \
 .       if \\n.t<\\n.v 'bp
 .END
@@ -1076,7 +1091,7 @@
 .    \}
 .    if '\\$0'ADD_SPACE' \{\
 .       vpt 0
-.       nr #ALD (u;\\$1)
+.       nr #ALD \\$1
 .       rs
 .       nop \&
 .       br
@@ -1431,6 +1446,7 @@
 \#   Justifies text left and right.
 \#
 .MAC JUSTIFY END
+\#.    if r pdfbx-top 'sp -1
 .    if \\n#TAB_ACTIVE=0 \{\
 .       nr #QUAD 1
 .       ds $RESTORE_QUAD_VALUE \\*$QUAD_VALUE
@@ -1455,7 +1471,15 @@
 \#   mode is enabled.
 \#
 .MAC QUAD END
-.    br
+.    if r pdfbx-top \{\
+'       sp -1
+.       rr pdfbx-top
+.    \}
+.\" The QUAD in PP adds an unwanted linespace after a HEADING at the
+.\" top of a pdf box because of this .br, so HEADING assigns the
+.\" tmp register "bx-top\nstack" to inhibit it.
+.    ie !r pdfbx-top\\nstack .br
+.    el .rr pdfbx-top\\nstack
 .    if \\n#COVERTEXT_PP \
 .       ds $RESTORE_DOC_QUAD \\*$QUAD_VALUE
 .    ds $QUAD_VALUE \\$1
@@ -1812,7 +1836,7 @@
 .       rm $ST\\n#LOOP_FILL
 .    \}
 .    rr #LOOP
-.    ie '\\n.z'FLOAT*DIV' \{\
+.    ie !'\\n.z'' \{\
 \!.     po \\n#L_MARGINu
 \!.     ll \\n#L_LENGTHu
 .    \}
@@ -1973,19 +1997,18 @@
 .END
 \#
 .MAC UNDERLINE END
-\c
 .    ds $SAVED_SS_VAR \\*$SS_VAR
 .    ie '\\$1'' \{\
 .       nr #UNDERLINE_ON 1
-.       ss \\n.ss (\\n.ss-\\n.ss)
+.       ss \\n.ss 0
 .       ie !n .nop \X'ps: exec \\n_w \\n_d decorline'\c
-.       el .ul 1000
+.       el .cu 1000
 .    \}
 .    el \{\
 .       nr #UNDERLINE_ON 0
 .       if !'\\*$SAVED_SS_VAR'' .SS \\*$SAVED_SS_VAR
 .       ie !n .nop \X'ps: exec decornone'\c
-.       el .ul 0
+.       el .cu 0
 .    \}
 .END
 \#
@@ -2002,7 +2025,7 @@
 .MAC UL END
 \c
 .    ds $SAVED_SS_VAR \\*$SS_VAR
-.    ss \\n.ss (\\n.ss-\\n.ss)
+.    ss \\n.ss 0
 .    ie !'\\n.z'' \{\
 \c
 .       ie !n \{\
@@ -2011,7 +2034,7 @@
 .       \}
 .       el \{\
 \?\R'#UNDERLINE_ON 1'\?\c
-.          ul 1000
+.          cu 1000
 .       \}
 .    \}
 .    el \{\
@@ -2021,7 +2044,7 @@
 .       \}
 .       el \{\
 \R'#UNDERLINE_ON 1'\c
-.          ul 1000
+.          cu 1000
 .       \}
 .    \}
 .END
@@ -2037,7 +2060,7 @@
 .       \}
 .       el \{\
 \?\R'#UNDERLINE_ON 0'\?\c
-.          ul 0
+.          cu 0
 .       \}
 .    \}
 .    el \{\
@@ -2047,7 +2070,7 @@
 .       \}
 .       el \{\
 .          nr #UNDERLINE_ON 0
-.          ul 0
+.          cu 0
 .       \}
 .    \}
 .END
@@ -2078,9 +2101,19 @@
 .    nr #SAVED_UNDERSCORE_WEIGHT     \\n#UNDERSCORE_WEIGHT
 .    nr #SAVED_UNDERSCORE_WEIGHT_ADJ \\n#UNDERSCORE_WEIGHT_ADJ
 .    ds $SAVED_UNDERSCORE_GAP        \\*$UNDERSCORE_GAP
-.    if \\n#NUM_ARGS=2 \{\
-.       ds $UNDERSCORE_GAP \\$1
-.       shift
+.    if \\n#NUM_ARGS>=2 \{\
+.       if \B'\\$1' \{\
+.          ds $UNDERSCORE_GAP \\$1
+.          shift
+.       \}
+.       if '\\$1'PREFIX' \{\
+.          ds $PREFIX \\$2
+.          shift 2
+.       \}
+.       if '\\$1'SUFFIX' \{\
+.          ds $SUFFIX \\$2
+.          shift 2
+.       \}
 .    \}
 .    if !'\\*$TITLE_TYPE'' \{\
 .       nr #UNDERSCORE_WEIGHT     \\n#\\*$TITLE_TYPE_UNDERLINE_WEIGHT
@@ -2089,21 +2122,21 @@
 .    \}
 .    nr #TEXT_WIDTH \w'\\$1'
 .    ie \\n.u=1 \{\
-\Z'\\$1'\
+\\*$PREFIX\Z'\\$1'\
 \Z'\D't \\n#UNDERSCORE_WEIGHT''\
 \v'\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu'\
 \D'l \\n#TEXT_WIDTHu 0'\
 \Z'\D't \\n#RULE_WEIGHT''\
-\v'-(\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu)'\c
+\v'-(\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu)'\\*$SUFFIX\c
 .       nop
 .    \}
 .    el \{\
-\Z'\\$1'\
+\\*$PREFIX\Z'\\$1'\
 \Z'\D't \\n#UNDERSCORE_WEIGHT''\
 \v'\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu'\
 \D'l \\n#TEXT_WIDTHu 0'\
 \Z'\D't \\n#RULE_WEIGHT''\
-\v'-(\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu)'
+\v'-(\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu)'\\*$SUFFIX
 .    \}
 .    nr #UNDERSCORE_WEIGHT     \\n#SAVED_UNDERSCORE_WEIGHT
 .    nr #UNDERSCORE_WEIGHT_ADJ \\n#SAVED_UNDERSCORE_WEIGHT_ADJ
@@ -2111,6 +2144,8 @@
 .    rr #SAVED_UNDERSCORE_WEIGHT
 .    rr #SAVED_UNDERSCORE_WEIGHT_ADJ
 .    rm $SAVED_UNDERSCORE_GAP
+.    rm $PREFIX
+.    rm $SUFFIX
 .    rm $TITLE_TYPE
 .END
 \#
@@ -2129,10 +2164,23 @@
 .    nr #SAVED_UNDERSCORE_WEIGHT_ADJ \\n#UNDERSCORE_WEIGHT_ADJ
 .    ds $SAVED_UNDERSCORE_GAP        \\*$UNDERSCORE_GAP
 .    ds $SAVED_RULE_GAP              \\*$RULE_GAP
-.    if \\n#NUM_ARGS=2 \{\
-.       ds $UNDERSCORE_GAP \\$1
-.       shift
-.    \}
+.    if \\n#NUM_ARGS>=2 \{\
+.       if \B'\\$1' \{\
+.          ds $UNDERSCORE_GAP \\$1
+.          shift
+.       \}
+.       if \B'\\$1' \{\
+.          ds $RULE_GAP \\$1
+.          shift
+.       \}
+.       if '\\$1'PREFIX' \{\
+.          ds $PREFIX \\$2
+.          shift 2
+.       \}
+.       if '\\$1'SUFFIX' \{\
+.          ds $SUFFIX \\$2
+.          shift 2
+.       \}
 .    if \\n#NUM_ARGS=3 \{\
 .       ds $UNDERSCORE_GAP \\$1
 .       ds $RULE_GAP \\$2
@@ -2146,30 +2194,32 @@
 .    \}
 .    nr #TEXT_WIDTH \w'\\$1'
 .    ie \\n.u=1 \{\
-\Z'\\$1'\
+\\*$PREFIX\Z'\\$1'\
 \Z'\D't \\n#UNDERSCORE_WEIGHT''\
 \v'\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu'\
 \Z'\D'l \\n#TEXT_WIDTHu 0''\
 \v'\\*$RULE_GAP+\\n#UNDERSCORE_WEIGHTu'\
 \D'l \\n#TEXT_WIDTHu 0'\
 \Z'\D't \\n#RULE_WEIGHT''\
-\v'-(\\*$UNDERSCORE_GAP+\\*$RULE_GAP)-(\\n#UNDERSCORE_WEIGHTu*2u)'\c
+\v'-(\\*$UNDERSCORE_GAP+\\*$RULE_GAP)-(\\n#UNDERSCORE_WEIGHTu*2u)'\\*$SUFFIX\c
 .    \}
 .    el \{\
-\Z'\\$1'\
+\\*$PREFIX\Z'\\$1'\
 \Z'\D't \\n#UNDERSCORE_WEIGHT''\
 \v'\\*$UNDERSCORE_GAP+\\n#UNDERSCORE_WEIGHT_ADJu'\
 \Z'\D'l \\n#TEXT_WIDTHu 0''\
 \v'\\*$RULE_GAP+\\n#UNDERSCORE_WEIGHTu'\
 \D'l \\n#TEXT_WIDTHu 0'\
 \Z'\D't \\n#RULE_WEIGHT''\
-\v'-(\\*$UNDERSCORE_GAP+\\*$RULE_GAP)-(\\n#UNDERSCORE_WEIGHTu*2u)'
+\v'-(\\*$UNDERSCORE_GAP+\\*$RULE_GAP)-(\\n#UNDERSCORE_WEIGHTu*2u)'\\*$SUFFIX
 .    \}
 .    nr #UNDERSCORE_WEIGHT     \\n#SAVED_UNDERSCORE_WEIGHT
 .    nr #UNDERSCORE_WEIGHT_ADJ \\n#SAVED_UNDERSCORE_WEIGHT_ADJ
 .    ds $UNDERSCORE_GAP        \\*$SAVED_UNDERSCORE_GAP
 .    rr #SAVED_UNDERSCORE_WEIGHT
 .    rr #SAVED_UNDERSCORE_WEIGHT_ADJ
+.    rm $PREFIX
+.    rm $SUFFIX
 .    rm $SAVED_UNDERSCORE_GAP
 .    rm $SAVED_RULE_GAP
 .    rm $TITLE_TYPE
@@ -2654,7 +2704,7 @@
 .    \}
 .    if d$DC_ADJUST .ps \\*$DC_ADJUSTp
 .    nr #DC_LINES +1
-.    if \\n#DC_LINESv>\\n.t \{\
+.    if (\\n#DC_LINESv-1v)>(\\n.t-1) \{\
 .       nr pgnum \\n%+\\n#PAGE_NUM_ADJ 1
 .       if \\n#COLUMNS=1 .ds col-num ", column \\n#COL_NUM
 .       tm1 \
@@ -2786,10 +2836,8 @@
 \#   described horizontal rule.
 \# *Notes:
 \#   Rules are drawn left-to-right, from the baseline down, and
-\#   return to their point of origin.  Color must be set in the
-\#   macro; otherwise the color will be black, regardless of current
-\#   .gcolor.  If no arg given, the rule weight is the one set by
-\#   RULE_WEIGHT.
+\#   return to their point of origin.  If no arg given (full measure
+\#   rule), the rule weight is the one set by RULE_WEIGHT.
 \#
 .MAC DRH END
 .    GRAPHICAL_OBJ
@@ -2797,7 +2845,10 @@
 .    ds $RL_INDENT \\$2
 .    ds $RL_LENGTH \\$3
 .    ie !'\\$4'' .ds $RL_COLOR  \\$4
-.    el          .ds $RL_COLOR \\*default
+.    el \{\
+.       ie '\\n.m'' .ds $RL_COLOR \\*default
+.       el .ds $RL_COLOR \\n.m
+.    \}
 .    nr #SAVED_WEIGHT     \\n#RULE_WEIGHT
 .    nr #SAVED_WEIGHT_ADJ \\n#RULE_WEIGHT_ADJ
 .    di NULL
@@ -2809,31 +2860,31 @@
 .          nr #RESTORE_L_LENGTH \\n.l
 .          if \\n#INDENT_BOTH_ACTIVE .ll \\n.lu-\\n#BL_INDENTu
 .          if \\n#INDENT_LEFT_ACTIVE .ll \\n.lu-\\n#L_INDENTu
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$RL_INDENT-\\n#RULE_WEIGHTu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$RL_INDENT+\\n#RULE_WEIGHT_ADJu'\
 \v'\\n#RULE_WEIGHT_ADJu'\
 \D'l \En.lu 0'\v'-\\n#RULE_WEIGHT_ADJu'\
 \v'-\\n#RULE_WEIGHT_ADJu'\
-\D't \\n#SAVED_RULE_WEIGHT'
+\Z'\D't \\n#SAVED_RULE_WEIGHT''
 .          ll \\n#RESTORE_L_LENGTHu
 .          rr #RESTORE_L_LENGTH
 .       \}
 .       el \{\
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$RL_INDENT-\\n#RULE_WEIGHTu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$RL_INDENT+\\n#RULE_WEIGHT_ADJu'\
 \v'\\n#RULE_WEIGHT_ADJu'\
 \D'l \En.lu 0'\v'-\\n#RULE_WEIGHT_ADJu'\
 \v'-\\n#RULE_WEIGHT_ADJu'\
-\D't \\n#SAVED_RULE_WEIGHT'
+\Z'\D't \\n#SAVED_RULE_WEIGHT''
 .       \}
 .    \}
 .    el \{\
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$RL_INDENT-\\n#RULE_WEIGHTu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$RL_INDENT+\\n#RULE_WEIGHT_ADJu'\
 \v'\\n#RULE_WEIGHT_ADJu'\
 \D'l \\*$RL_LENGTH 0'\
 \v'-\\n#RULE_WEIGHT_ADJu'\
-\D't \\n#SAVED_RULE_WEIGHT'
+\Z'\D't \\n#SAVED_RULE_WEIGHT''
 .          rr #RESTORE_L_LENGTH
 .    \}
 .    if \\n#FILLED=1 \{\
@@ -2881,16 +2932,18 @@
 .       if \\n#INDENT_BOTH_ACTIVE .ll \\n.lu-\\n#BL_INDENTu
 .       if \\n#INDENT_LEFT_ACTIVE .ll \\n.lu-\\n#L_INDENTu
 .       PRINT \
-\D't \\n#RULE_WEIGHT'\v'\\n#RULE_WEIGHT_ADJu'\
-\h'-\\n#RULE_WEIGHTu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\v'\\n#RULE_WEIGHT_ADJu'\
+\h'\\n#RULE_WEIGHT_ADJu'\
 \D'l \En.lu 0'\v'-\\n#RULE_WEIGHT_ADJu'\h'|0'\c
 .       ll
 .       rr #RESTORE_L_LENGTH
 .    \}
 .    el \{\
 .       PRINT \
-\D't \\n#RULE_WEIGHT'\v'\\n#RULE_WEIGHT_ADJu'\
-\h'-\\n#RULE_WEIGHTu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\v'\\n#RULE_WEIGHT_ADJu'\
+\h'\\n#RULE_WEIGHT_ADJu'\
 \D'l \En.lu 0'\v'-\\n#RULE_WEIGHT_ADJu'\h'|0'\c
 .    \}
 .    if \\nfill \{\
@@ -2910,10 +2963,7 @@
 \#   Draws described vertical rule.
 \# *Notes:
 \#   Rules are drawn left-to-right, from the baseline down, and
-\#   return to their point of origin.  Color must be set in the
-\#   macro; otherwise the color will be black, regardless of current
-\#   .gcolor.
-\#
+\#   return to their point of origin.
 .MAC DRV END
 .    GRAPHICAL_OBJ
 .    ds $RL_WEIGHT \\$1
@@ -2921,13 +2971,16 @@
 .    ds $RL_DEPTH  \\$3
 .    ie !'\\$4'' \
 .       ds $RL_COLOR  \\$4
-.    el .ds $RL_COLOR \\*default
+.    el \{\
+.       ie '\\n.m'' .ds $RL_COLOR \\*default
+.       el .ds $RL_COLOR \\n.m
+.    \}
 .    nr #SAVED_WEIGHT     \\n#RULE_WEIGHT
 .    nr #SAVED_WEIGHT_ADJ \\n#RULE_WEIGHT_ADJ
 .    RULE_WEIGHT \\*$RL_WEIGHT
 .    COLOR \\*$RL_COLOR
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$RL_INDENT-\\n#RULE_WEIGHT_ADJu'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$RL_INDENT+\\n#RULE_WEIGHTu+\\n#RULE_WEIGHT_ADJu'\
 \D'l 0 \\*$RL_DEPTH'\
 \D't \\n#SAVED_RULE_WEIGHT'
 .    if \\n#FILLED=1 \{\
@@ -2956,47 +3009,68 @@
 \# BOXES - DBX
 \# -----------
 \# *Arguments:
-\#   <rule weight> | SOLID> <indent> <length> <depth>  <color> 
+\#   <rule weight>|SOLID <indent> <width>|FULL_MEASURE <depth>  <color> 
 \# *Function:
 \#   Draws described box.
 \# *Notes:
 \#   Boxes are drawn left-to-right, from the baseline down, and
 \#   return to their point of origin.  Box rules are drawn from the
-\#   perimeter inwards.  Color must be set in the macro; otherwise
-\#   the color will be black, regardless of current .gcolor.  If no
-\#   arg given, the rule weight is the one set by RULE_WEIGHT.
+\#   perimeter inwards.
 \#
 .MAC DBX END
 .    GRAPHICAL_OBJ
 .    ie '\\$1'SOLID' .nr #BX_SOLID 1
-.    el              .ds $BX_WEIGHT \\$1
+.    el .ds $BX_WEIGHT \\$1
 .    ds $BX_INDENT \\$2
-.    ds $BX_WIDTH  \\$3
+.    ie '\\$3'FULL_MEASURE' \{\
+.       ie (\\n#INDENT_LEFT_ACTIVE+\\n#INDENT_RIGHT_ACTIVE+\\n#INDENT_BOTH_ACTIVE)=0 \{\
+.          nr #WIDTH \\n.l
+.          ds $BX_WIDTH \\n#WIDTHu
+.       \}
+.       el \{\
+.          if \\n#INDENT_LEFT_ACTIVE \{\
+.             nr #WIDTH \\n.l-\\n#L_INDENT
+.             ds $BX_WIDTH \\n#WIDTHu
+.          \}
+.          if \\n#INDENT_RIGHT_ACTIVE \{\
+.             nr #WIDTH \\n.l
+.             ds $BX_WIDTH \\n#WIDTHu
+.          \}
+.          if \\n#INDENT_BOTH_ACTIVE \{\
+.             nr #WIDTH \\n.l-(\\n#BL_INDENT)
+.             ds $BX_WIDTH \\n#WIDTHu
+.          \}
+.       \}
+.    \}
+.    el .ds $BX_WIDTH \\$3
 .    ds $BX_DEPTH  \\$4
 .    ie !'\\$5'' \{\
 .       ie d$\\$5_FILL .ds $BX_COLOR \\*$\\$5_FILL
 .       el             .ds $BX_COLOR \\$5
 .    \}
-.    el .ds $BX_COLOR \\*default
+.    el \{\
+.       ie '\\n.m'' .ds $BX_COLOR \\*default
+.       el .ds $BX_COLOR \\n.m
+.    \}
 .    nr #SAVED_WEIGHT     \\n#RULE_WEIGHT
 .    nr #SAVED_WEIGHT_ADJ \\n#WEIGHT_ADJ
 .    if !'\\$1'SOLID' .RULE_WEIGHT \\*$BX_WEIGHT
 .    ds $BX_INDENT \\*$BX_INDENT-\\n#WEIGHT_ADJu
 .    ie \\n#BX_SOLID=1 \{\
 .       fcolor \\*$BX_COLOR
-\h'\\*$BX_INDENT'\
+\h'\\*$BX_INDENT+\\n#BOX_WEIGHT_ADJu+\\n#RULE_WEIGHTu'\
 \D'P \\*$BX_WIDTH 0 0 \\*$BX_DEPTH -\\*$BX_WIDTH 0 0 -\\*$BX_DEPTH'
 .       fcolor
 .       rr #BX_SOLID
 .    \}
 .    el \{\
 .       COLOR \\*$BX_COLOR
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$BX_INDENT'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$BX_INDENT+\\n#RULE_WEIGHTu+\\n#RULE_WEIGHT_ADJu'\
 \v'\\n#WEIGHT_ADJu'\
 \D'p \\*$BX_WIDTH-\\n#RULE_WEIGHTu 0 0 \\*$BX_DEPTH-\\n#RULE_WEIGHTu -\\*$BX_WIDTH+\\n#RULE_WEIGHTu 0 0 -\\*$BX_DEPTH+\\n#RULE_WEIGHTu'\
 \v'-\\n#WEIGHT_ADJu'\
-\D't \\n#SAVED_RULE_WEIGHT'
+\Z'\D't \\n#SAVED_RULE_WEIGHT''
 .       gcolor
 .    \}
 .    sp -1v
@@ -3025,36 +3099,56 @@
 \# ELLIPSES - DCL
 \# --------------
 \# *Arguments:
-\#   <rule weight> | SOLID> <indent> <width> <depth>  <color> 
+\#   <rule weight>|SOLID <indent> <width>|FULL_MEASURE <depth>  <color> 
 \# *Function:
 \#   Draws described ellipses.
 \# *Notes:
 \#   Ellipses (circles) are drawn left-to-right, from the baseline
 \#   down, and return to their point of origin.  Ellipse rules are
-\#   drawn from the perimeter inwards.  Color must be set in the
-\#   macro; otherwise the color will be black, regardless of current
-\#   .gcolor.  If no arg given, the rule weight is the one set by
-\#   RULE_WEIGHT.
+\#   drawn from the perimeter inwards.
 \#
 .MAC DCL END
 .    GRAPHICAL_OBJ
 .    ie '\\$1'SOLID' .nr #CL_SOLID 1
-.    el              .ds $CL_WEIGHT \\$1
+.    el .ds $CL_WEIGHT \\$1
 .    ds $CL_INDENT \\$2
 .    ds $CL_WIDTH  \\$3
+.    ie '\\$3'FULL_MEASURE' \{\
+.       ie (\\n#INDENT_LEFT_ACTIVE+\\n#INDENT_RIGHT_ACTIVE+\\n#INDENT_BOTH_ACTIVE)=0 \
+.          nr #WIDTH \\n.l
+.       ds $CL_WIDTH \\n#WIDTHu
+.       el \{\
+.          if \\n#INDENT_LEFT_ACTIVE \{\
+.             nr #WIDTH \\n.l-\\n#L_INDENT
+.             ds $CL_WIDTH \\n#WIDTHu
+.          \}
+.          if \\n#INDENT_RIGHT_ACTIVE \{\
+.             nr #WIDTH \\n.l
+.             ds $CL_WIDTH \\n#WIDTHu
+.          \}
+.          if \\n#INDENT_BOTH_ACTIVE \{\
+.             nr #WIDTH \\n.l-(\\n#BL_INDENT)
+.             ds $CL_WIDTH \\n#WIDTHu
+.          \}
+.       \}
+.    \}
+.    el .ds $CL_WIDTH \\$3
 .    ds $CL_DEPTH  \\$4
 .    ie !'\\$5'' \{\
 .       ie d$\\$5_FILL .ds $CL_COLOR \\*$\\$5_FILL
 .       el             .ds $CL_COLOR \\$5
 .    \}
-.    el .ds $CL_COLOR \\*default
+.    el \{\
+.       ie '\\n.m'' .ds $CL_COLOR \\*default
+.       el .ds $CL_COLOR \\n.m
+.    \}
 .    nr #SAVED_WEIGHT     \\n#RULE_WEIGHT
 .    nr #SAVED_WEIGHT_ADJ \\n#WEIGHT_ADJ
 .    if !'\\$1'SOLID' .RULE_WEIGHT \\*$CL_WEIGHT
 .    ds $CL_INDENT \\*$CL_INDENT-\\n#WEIGHT_ADJu
 .    ie \\n#CL_SOLID=1 \{\
 .       fcolor \\*$CL_COLOR
-\h'\\*$CL_INDENT'\
+\h'\\*$CL_INDENT+\\n#RULE_WEIGHTu'\
 \v'\\*$CL_DEPTH/2u'\
 \D'E \\*$CL_WIDTH-\\n#RULE_WEIGHTu \\*$CL_DEPTH-\\n#RULE_WEIGHTu'\
 \v'-\\*$CL_DEPTH/2u'
@@ -3063,12 +3157,12 @@
 .    \}
 .    el \{\
 .       COLOR \\*$CL_COLOR
-\D't \\n#RULE_WEIGHT'\
-\h'\\*$CL_INDENT'\
+\Z'\D't \\n#RULE_WEIGHT''\
+\h'\\*$CL_INDENT+\\n#RULE_WEIGHTu+\\n#RULE_WEIGHT_ADJu'\
 \v'\\*$CL_DEPTH/2u'\
 \D'e \\*$CL_WIDTH-\\n#RULE_WEIGHTu \\*$CL_DEPTH-\\n#RULE_WEIGHTu'\
 \v'-(\\*$CL_DEPTH/2u)'\
-\D't \\n#SAVED_RULE_WEIGHT'
+\Z'\D't \\n#SAVED_RULE_WEIGHT''
 .       gcolor
 .    \}
 .    sp -1v
@@ -3212,7 +3306,7 @@
 .END
 \#
 \# Aliases for RULE_WEIGHT
-\# 
+\#
 .ALIAS BIB_STRING_UNDERLINE_WEIGHT RULE_WEIGHT
 .ALIAS DOCTYPE_UNDERLINE_WEIGHT    RULE_WEIGHT
 .ALIAS EN_STRING_UNDERLINE_WEIGHT  RULE_WEIGHT
@@ -3226,7 +3320,7 @@
 .ALIAS UNDERSCORE_WEIGHT           RULE_WEIGHT
 \#
 \# Default rule weights
-\# 
+\#
 .nr #BIB_STRING_UNDERLINE_WEIGHT 500
 .nr #DOCTYPE_UNDERLINE_WEIGHT    500
 .nr #EN_STRING_UNDERLINE_WEIGHT  500
@@ -3327,10 +3421,10 @@
 \#
 .MAC SS END
 .    ds $SS_VAR \\$1
-.    ie '\\$1'0' .ss \\n.ss (\\n.ss-\\n.ss)
+.    ie '\\$1'0' .ss \\n.ss 0
 .    el \{\
 .       ie '\\$1'DEFAULT' .ss \\n.ss
-.       el                .ss \\n.ss (0+\\*$SS_VAR)
+.       el                .ss \\n.ss \\*$SS_VAR
 .    \}
 .END
 \#
@@ -3350,14 +3444,15 @@
 .       br
 .       in \\n#L_INDENTu
 .       ta \\n.lu-\\n#L_INDENTu
+.       if \\n#IN_ITEM .nr #IN_ITEM_L_INDENT 0
 .    \}
 .    el \{\
 .       br
-.       nr #L_INDENT +(\\$1)
+.       nr #L_INDENT +(u;\\$1)
 .       in \\n#L_INDENTu
 .       ta \\n.lu-\\n#L_INDENTu
+.       if \\n#IN_ITEM .nr #IN_ITEM_L_INDENT +(u;\\$1)
 .    \}
-.    if \\n#IN_ITEM .nr #IN_ITEM_L_INDENT +(\\$1)
 .END
 \#
 \# +++INDENT RIGHT+++
@@ -3380,7 +3475,7 @@
 .    \}
 .    el \{\
 .       br
-.       nr #R_INDENT +(\\$1)
+.       nr #R_INDENT (u;\\$1)
 .       ie \\n#TAB_ACTIVE \{\
 .          ll \\n.lu-\\n#R_INDENTu
 .          ta \\n.lu-\\n#L_INDENTu
@@ -3450,11 +3545,19 @@
 .    ie \\n#IN_ITEM .nr #L_INDENT -\\n#IN_ITEM_L_INDENT
 .    el \{\
 .       br
-.       in 0
+.       ie \\npdfbx-running=1 \
+.          ie !r pdfbx-clear \{\
+.             in \\*wt\\nstack+\\*gap\\nstacku+\\n#IL_ACTIVEu
+.          el .in \\*wt\\nstack+\\*gap\\nstacku
+.       \}
+.       el .in 0
 .       rr #INDENT_LEFT_ACTIVE
 .       nr #L_INDENT_ILX \\n#L_INDENT
 .    \}
 .    if '\\$1'CLEAR' \{\
+.       if \\npdfbx-running=1 \
+.          if !r pdfbx-clear \
+.             in \\*wt\\nstack+\\*gap\\nstacku
 .       rr #L_INDENT
 .       rr #INDENT_STYLE_LEFT
 .       rr #L_INDENT_ILX
@@ -3472,11 +3575,19 @@
 .          ta \\n.lu
 .       \}
 .       el \{\
-.          ll \\n#L_LENGTHu
+.          ie \\npdfbx-running=1 \{\
+.             if !r pdfbx-clear \
+.                ll \\npdfbx-llu
+.          \}
+.          el .ll \\n#DOC_L_LENGTHu
 .          ta \\n.lu
 .       \}
 .    \}
 .    if '\\$1'CLEAR' \{\
+.       if \\npdfbx-running=1 \{\
+.          if !r pdfbx-clear \
+.             ll \\n#L_LENGTHu-(\\*wt\\nstack+\\*gap\\nstacku)
+.       \}
 .       rr #R_INDENT
 .       rr #INDENT_STYLE_RIGHT
 .    \}
@@ -3611,28 +3722,15 @@
 \#   characters that have the form \c.
 \#
 .MAC LEFT_HANG END
-.    ie '\\$0'LEFT_HANG' \{\
-.       vpt 0
-.       sp -1
-.       nr #HANG \w'\\$1'
-.       in +\\n#HANGu
-.       ll +\\n#HANGu
-.       ie !\\n.z .po -\\n#HANGu
-.       el \!.po -\\n#HANGu
-.       ti -\\n#HANGu
-.       vpt
-.    \}
-.    el \{\
-.       vpt 0
-.       in
-.       ll
-.       po
-.       vpt
-.    \}
+.    nr hang-char-width \w'\\$1'
+.    ds hang-char-gutter \\$2
+.    ie '\\*hang-char-gutter'' \
+.       nr hang-char \\nhang-char-width
+.    el \
+.       nr hang-char \\nhang-char-width+\\*hang-char-gutter
+\h'-\\nhang-charu'\c
 .END
 \#
-.ALIAS NO_HANG LEFT_HANG
-\#
 .MAC HANG END
 \c
 .if '\\$1'\rq' .nr #OPEN_CLOSE 0
@@ -3914,13 +4012,13 @@
 .    if '\\$0'LC_TO_CAPS' \{\
 .       nr #LOOP 0 1
 .       while \\n+#LOOP<=58 \{\
-.          tr \\*$c\\n#LOOP\\*$C\\n#LOOP  
+.          tr \\*$c\\n#LOOP\\*$C\\n#LOOP
 .       \}
 .    \}
 .    if '\\$0'CAPS_TO_LC' \{\
 .       nr #LOOP 0 1
 .       while \\n+#LOOP<=58 \{\
-.          tr \\*$c\\n#LOOP\\*$c\\n#LOOP  
+.          tr \\*$c\\n#LOOP\\*$c\\n#LOOP
 .       \}
 .    \}
 .END
@@ -3940,28 +4038,31 @@
 \#   SMALLCAPS has no inline escape eqiv. to \*UC.
 \#
 .MAC SMALLCAPS END
-.    if \\n.int .nop \& \c
-.    nr sc*size \\n.ps*\\nsc*factor/1000
-.    if \\nsc*wt-adj .nr sc*wt-adj-factor \\nsc*size*\\nsc*wt-adj/1000
-.    if \\nsc*extend .nr sc*extend-factor \\nsc*size*\\nsc*extend/1000
-.    ie '\\$1'' \{\
-.       nr #SMALLCAPS_ON 1
-.       nr #LOOP 0 1
-.       while \\n+#LOOP<=58 \{\
-.          char \\*$c\\n#LOOP \
+.    if \\n#PRINT_STYLE=2 \{\
+.       if !\\n.u \
+.          if \\n.int .nop \& \c
+.       nr sc*size \\n.ps*\\nsc*factor/1000
+.       if \\nsc*wt-adj .nr sc*wt-adj-factor \\nsc*size*\\nsc*wt-adj/1000
+.       if \\nsc*extend .nr sc*extend-factor \\nsc*size*\\nsc*extend/1000
+.       ie '\\$1'' \{\
+.          nr #SMALLCAPS_ON 1
+.          nr #LOOP 0 1
+.          while \\n+#LOOP<=58 \{\
+.             char \\*$c\\n#LOOP \
 \Z'\s\\nsc*sizeu+\\nsc*extend-factoru\H'-\\nsc*extend-factoru'\
 \\*$C\\n#LOOP'\
 \h'\\nsc*wt-adj-factoru'\\*$C\\n#LOOP\s0
+.          \}
+.       \}
+.       el \{\
+.          nr #LOOP 0 1
+.          while \\n+#LOOP<=58 \{\
+.             rchar \\*$c\\n#LOOP
+.         \}
+.         rr sc*wt-adj-factor
+.         rr sc*extend-factor
+.         rr #SMALLCAPS_ON
 .       \}
-.    \}
-.    el \{\
-.       nr #LOOP 0 1
-.       while \\n+#LOOP<=58 \{\
-.          rchar \\*$c\\n#LOOP
-.      \}
-.      rr sc*wt-adj-factor
-.      rr sc*extend-factor
-.      rr #SMALLCAPS_ON
 .    \}
 .END
 \#
@@ -4017,7 +4118,7 @@
 \#   The routine is diverted so it remains invisible to output.
 \#
 .MAC SIZESPECS END
-.    if '\\n.z'FLOAT*DIV' \
+.    if !'\\n.z'' \
 .       if \\ndn .nr saved-dn \\ndn
 .    di TYPESIZE
 E\R'#CAP_HEIGHT \\n.cht'
@@ -4028,7 +4129,7 @@
 .    ds $X_HEIGHT \\n#X_HEIGHTu
 .    ds $DESCENDER \\n#DESCENDERu
 .    di
-.    if '\\n.z'FLOAT*DIV' \
+.    if !'\\n.z'' \
 .       nr dn \\nsaved-dn
 .END
 \#
@@ -4094,8 +4195,11 @@
 \#   LETTER | LEGAL | STATEMENT | TABLOID | LEDGER | FOLIO | QUARTO | 10x14 | EXECUTIVE | A3 | A4 | A5 | B4 | B5
 \# *Function:
 \#   Sets up dimensions for different paper sizes.
+\# *Notes:
+\#   LANDSCAPE may be given after papersize arg.
 \#
 .MAC PAPER END
+.    vs 0
 .    ds $PAPER \\$1
 .    if '\\*$PAPER'LETTER' \{\
 .       PAGEWIDTH  8.5i
@@ -4157,9 +4261,12 @@
 .       nr #PAGE_WIDTH_TMP \\n#PAGE_WIDTH
 .       PAGEWIDTH \\n#PAGE_LENGTHu
 .       PAGELENGTH \\n#PAGE_WIDTH_TMPu
+.       as $PAPER " LANDSCAPE\"
 .    \}
 .    if !r#L_MARGIN .L_MARGIN \\n.o
-.    if !r#R_MARGIN .R_MARGIN 1i
+.    if !r#R_MARGIN .R_MARGIN \\n#PAGE_WIDTHu-\\n#L_MARGINu-1i
+.    if '\\*.T'pdf' .br
+.    vs
 .END
 \#
 \# ====================================================================
@@ -4176,8 +4283,17 @@
 \#   Number registers: TYPEWRITE=1, TYPESET=2.
 \#
 .MAC PRINTSTYLE END
+.    if n \{\
+.       if '\\$1'TYPESET' \{\
+.         pl 1
+.         ab mom: Terminal output requires PRINTSTYLE TYPEWRITE.  Aborting.
+.       \}
+.    \}
 .    if !\\n#COLLATE=1 \{\
-.       if !d$PAPER .PAPER LETTER
+.       if !d$PAPER \{\
+.          PAGELENGTH 11i
+.          PAGEWIDTH  8.5i
+.       \}
 .       if '\\$1'TYPEWRITE' \{\
 .          nr #PRINT_STYLE 1
 .          if !\\n#DOC_TYPE=4 \{\
@@ -4210,12 +4326,14 @@
 .          nr #BOLDER_UNITS 0
 .          nr #CONDENSE 0
 .          nr #EXTEND 0
-.          if !\\n#ITALIC_MEANS_ITALIC .rm IT
+.          if !\\n#ITALIC_MEANS_ITALIC \{\
+.             rm IT
+.             rm PREV
+.             UNDERLINE_ITALIC
+.          \}
 .          rm BD
 .          rm BDI
-.          if !\\n#ITALIC_MEANS_ITALIC .rm PREV
 .          if !\\n#SLANT_MEANS_SLANT   .UNDERLINE_SLANT
-.          if !\\n#ITALIC_MEANS_ITALIC .UNDERLINE_ITALIC
 .          if !\\n#UNDERLINE_QUOTES    .UNDERLINE_QUOTES
 .          nr #IGNORE_COLUMNS 1
 .          nr #RULE_WEIGHT 500
@@ -4353,7 +4471,7 @@
 .       rm PREV
 .       ds ROM  \E*ULX
 .       ds IT   \E*UL
-.       ds PREV \E*ULX
+.       ds PREV \fP\E*ULX
 .    \}
 .END
 \#
@@ -4422,9 +4540,9 @@
 .       if !d$DRAFT .DRAFT 1
 .    \}
 .    if '\\*$COPY_STYLE'FINAL' .nr #COPY_STYLE 2
-.    if !d$CHAPTER_STRING  .CHAPTER_STRING "Chapter"
-.    if !d$DRAFT_STRING    .DRAFT_STRING "Draft"
-.    if !d$REVISION_STRING .REVISION_STRING "Rev."
+.    if '\\*$CHAPTER_STRING''  .CHAPTER_STRING "Chapter"
+.    if '\\*$DRAFT_STRING''    .DRAFT_STRING "Draft"
+.    if '\\*$REVISION_STRING'' .REVISION_STRING "Rev."
 .\" Default
 .    if \\n#DOC_TYPE=1 \{\
 .       ie \\n#COPY_STYLE=1 \{\
@@ -4809,8 +4927,10 @@
 .MAC COPYRIGHT END          \"For use on cover pages only
 .   ie \\n#NUM_ARGS=1 \
 .       ds $COVER_COPYRIGHT \co\\$1
-.    el \
+.    el \{\
+.       if '\\$1'COVER'     .ds $COVER_COPYRIGHT \co\\$2
 .       if '\\$1'DOC_COVER' .ds $DOC_COVER_COPYRIGHT \co\\$2
+.    \}
 .END
 \#
 .MAC COPYRIGHT_V_ADJUST END
@@ -4875,7 +4995,8 @@
 \# *Function:
 \#   Creates strings and sets registers for document types.
 \# *Notes:
-\#   Number registers: DEFAULT=1, CHAPTER=2, NAMED=3, LETTER=4
+\#   Number registers: DEFAULT=1, CHAPTER=2, NAMED=3, LETTER=4,
+\#   SLIDES=5
 \#
 .MAC DOCTYPE END
 .    if '\\$1'DEFAULT' .nr #DOC_TYPE 1
@@ -5475,7 +5596,7 @@
 .       ds $STYLE_TYPE PAGENUM
 .    nr #LOOP 0 1
 .    nr #STYLE_PARAMS \\n#NUM_ARGS
-.    while \\n+#LOOP<=\\n#STYLE_PARAMS \{\ 
+.    while \\n+#LOOP<=\\n#STYLE_PARAMS \{\
 .       if '\\$1'FAMILY' \{\
 .          shift
 .          \\*$STYLE_TYPE_FAMILY \\$1
@@ -5663,7 +5784,6 @@
 .ds STYLE_TYPE_36 TITLE
 .ds STYLE_TYPE_37 TOC_HEADER
 .
-.
 .nr #LOOP 0 1
 .while \n+#LOOP<=37 \{\
 . ALIAS \*STYLE_TYPE_\n#LOOP_STYLE           _STYLE
@@ -5753,11 +5873,14 @@
 \#
 .MAC DEFAULTS END
 .    if !\\n#DOC_TYPE=5 \{\
-.       ie !d $PAPER .PAPER LETTER
+.       ie !d $PAPER \{\
+.          PAGEWIDTH \\n#PAGE_WIDTHu
+.          PAGELENGTH \\n.pu
+.       \}
 .       el .PAPER \\*$PAPER
 .    \}
 .    if !\\n#DOC_TYPE .DOCTYPE DEFAULT
-.    if !r #CH_NUM .nr #CH_NUM 1 
+.    if !r #CH_NUM .nr #CH_NUM 1
 .    ie \\n#PAGENUM_STYLE_SET .PAGENUM_STYLE \\*$PAGENUM_STYLE
 .    el \
 .       if !\\n#COPY_STYLE=1 .PAGENUM_STYLE DIGIT
@@ -5777,10 +5900,8 @@
 .    if !r #DOC_HEADER .DOCHEADER
 .    if !r #HEADERS_ON .HEADERS
 .    if !r #PAGINATE   .PAGINATE
-.\"
 .    if !r #HEADER_MARGIN .HEADER_MARGIN 4P+6p
 .    if !r #HEADER_GAP    .HEADER_GAP 3P
-.\"
 .    if \\n#FOOTERS_ON \{\
 .       HEADERS OFF
 .       ie \\n#PAGINATE \
@@ -5818,7 +5939,10 @@
 .       rm $SAVED_DOC_FAM
 .    \}
 .    el .ds $DOC_FAM \\*$FAMILY
-.    nr #DOC_PT_SIZE  \\n#PT_SIZE
+.    ie !r #DOC_PT_SIZE .nr #DOC_PT_SIZE \\n#PT_SIZE
+.    el \
+.       if !\\n#DOC_PT_SIZE=\\n#PT_SIZE \
+.          nr #DOC_PT_SIZE \\n#PT_SIZE
 .    if \\n#TOC          .nr #DOC_PT_SIZE \\n#TOC_PS
 .    if \\n#ENDNOTES     .nr #DOC_PT_SIZE \\n#EN_PS
 .    if \\n#BIBLIOGRAPHY .nr #DOC_PT_SIZE \\n#BIB_PS
@@ -6483,6 +6607,14 @@
 .           ds $TOC_HEAD_\\n#HD_LEVEL_FAM \\*$TOC_FAM
 .    \}
 .    if '\\*$TOC_TITLE_FAM'' .TOC_TITLE_FAMILY \\*$DOC_FAM
+.\" TOC heading (single, non-pagenumbered line insertion)
+.    if !d $TOC_HEADING_FAM   .ds $TOC_HEADING_FAM \\*$DOC_FAM
+.    if !d $TOC_HEADING_FT    .ds $TOC_HEADING_FT R
+.    if !d $TOC_HEADING_SIZE  .ds $TOC_HEADING_SIZE +0
+.    if !d $TOC_HEADING_COLOR .ds $TOC_HEADING_COLOR black
+.    if !d $TOC_HEADING_QUAD  .ds $TOC_HEADING_QUAD L
+.    if !d $SPACE_ABOVE       .ds $SPACE_ABOVE .75v
+.    if !d $SPACE_BENEATH     .ds $SPACE_BENEATH .25v
 .\" Re-run MNinit to capture strings and registers set in DEFAULTS.
 .    if !'\\*$MN-arg1'' \{\
 .       MNinit \
@@ -6508,8 +6640,8 @@
 .    if '\\$0'DOC_HEADER_QUAD' .ds $CALLING_MACRO DOCHEADER
 .    if '\\$0'COVER_H_POS'     .ds $CALLING_MACRO COVER
 .    if '\\$0'DOC_COVER_H_POS' .ds $CALLING_MACRO DOC_COVER
-.    substring $\\*$CALLING_MACRO_QUAD 0 0
 .    ie !'\\*$\\*$CALLING_MACRO_QUAD'' \{\
+.       substring $\\*$CALLING_MACRO_QUAD 0 0
 .       if '\\*$\\*$CALLING_MACRO_QUAD'L' .LEFT
 .       if '\\*$\\*$CALLING_MACRO_QUAD'C' .CENTER
 .       if '\\*$\\*$CALLING_MACRO_QUAD'C' .RIGHT
@@ -6523,6 +6655,11 @@
 .MAC DO_TITLE_OR_AUTHOR END
 .    ie '\\$0'DO_AUTHORS' .ds $TTL_AUTH AUTHOR
 .    el .ds $TTL_AUTH TITLE
+.    if '\\*$\\*$PRFX\\*$TTL_AUTH_1'' \{\
+.       if !'\\*$\\*$PRFXDOC\\*$TTL_AUTH_1'' \
+.          ds $\\*$PRFX\\*$TTL_AUTH_1 "\&"
+.       if !'\\*$AUTHOR_1'' .rm $PRFX
+.    \}
 .    if !'\\*$\\*$PRFX\\*$TTL_AUTH_1'' \{\
 .       if '\\$0'DO_SUBTITLE' \{\
 .          if '\\*$PRFX'\\*DOC_COVER_SUB' \{\
@@ -6531,8 +6668,9 @@
 .          \}
 .       \}
 .       if !\\n#PRINT_STYLE=1 \{\
-\#.          if (\\n#COVER=1):(\\n#DOC_COVER=1) \
-\#.             rn $PRFX $PRFX_SAVED
+.          if (\\n#COVER=1):(\\n#DOC_COVER=1) \
+.             if !'\\*$PRFX'SUB' \
+.                rn $PRFX $PRFX_SAVED
 .          fam  \\*$\\*$COVER_TYPE\\*$PRFX\\*$TTL_AUTH_FAM
 .          ft   \\*$\\*$COVER_TYPE\\*$PRFX\\*$TTL_AUTH_FT
 .          ps \
@@ -6547,8 +6685,10 @@
 .             COLOR \\*$\\*$COVER_TYPE\\*$PRFX\\*$TTL_AUTH_COLOR
 .          if \\n#\\*$COVER_TYPE\\*$PRFX\\*$TTL_AUTH_CAPS=1 .CAPS
 .          if \\n#\\*$COVER_TYPE\\*$PRFX\\*$TTL_AUTH_SMALLCAPS=1 .SMALLCAPS
-\#.          if (\\n#COVER=1):(\\n#DOC_COVER=1) \
-\#.             rn $PRFX_SAVED $PRFX
+.          if (\\n#COVER=1):(\\n#DOC_COVER=1) \
+.             rn $PRFX_SAVED $PRFX
+.          if \\n#\\*DOC_COVER_TITLE=2 \
+.             ds $PRFX DOC
 .       \}
 .       if \\n#\\*DOC_COVER_SUB \{\
 .          rr #\\*DOC_COVER_SUB
@@ -6805,7 +6945,6 @@
 .          DO_TITLE
 .          rm $PRFX
 .          rr #CHAPTER+TITLE
-.          RLD \\n#DOC_LEADu \" Just looks better this way
 .       \}
 .    \}
 .    FAMILY \\*$DOC_FAM
@@ -6906,11 +7045,20 @@
 .       ds DOC_ DOC_
 .    \}
 .    el .nr #COVER 1
-.    nr #ARG_NUM 0 1
-.    nr #COVER_ITEM \\n#NUM_ARGS  \"loop count
-.    if \\n#NUM_ARGS=1 \
+.    if \\n#NUM_ARGS=1 \{\
 .       if '\\$1'\\*DOC_COVERTEXT' \
 .          nr #\\*DOC_COVERTEXT_ONLY 1
+.    \}
+.    if \\n#NUM_ARGS=3 \{\
+.       if '\\$1'\\*DOC_COVERTEXT' \
+.          if '\\$2'PDF_OUTLINE_LABEL' \
+.             nr #\\*DOC_COVERTEXT_ONLY 1
+.       if '\\$1'PDF_OUTLINE_LABEL' \
+.          if '\\$2'\\*DOC_COVERTEXT' \
+.             nr #\\*DOC_COVERTEXT_ONLY 1
+.    \}
+.    nr #ARG_NUM 0 1
+.    nr #COVER_ITEM \\n#NUM_ARGS  \"loop count
 .    while \\n+#ARG_NUM<=\\n#COVER_ITEM \{\
 .       if '\\$1'DOCTITLE' \{\
 .          nr #\\*DOC_COVER_TITLE 2
@@ -6954,6 +7102,10 @@
 .          nr #\\*DOC_COVER_AUTHOR 1
 .          shift
 .       \}
+.       if '\\$1'EDITOR' \{\
+.          nr #\\*DOC_COVER_AUTHOR 1
+.          shift
+.       \}
 .       if '\\$1'DOCTYPE' \{\
 .          nr #\\*DOC_COVER_DOCTYPE 1
 .          shift
@@ -6996,10 +7148,9 @@
 \#
 .MAC COVERTITLE END
 .    rm DOC_
-.    if '\\$0'DOC_COVERTITLE' \{\
+.    if '\\$0'DOC_COVERTITLE' \
 .       ds DOC_ DOC_
-.       nr #FROM_\\*DOC_COVERTITLE 1
-.    \}
+.    nr #FROM_\\*DOC_COVERTITLE 1
 .    ie \\n#NUM_ARGS=0 \{\
 .       nr argc 0 1
 .       while \\n+argc<=3 \{\
@@ -7027,7 +7178,7 @@
 .MAC COVER_ATTRIBUTE_STRING END
 .    if '\\$0'DOC_COVER_ATTRIBUTE_STRING' \
 .       ds DOC_ DOC_
-.    ds $\\*DOC_COVER_ATTRIBUTE_STRING \\$1 
+.    ds $\\*DOC_COVER_ATTRIBUTE_STRING \\$1
 .    rm DOC_
 .END
 .
@@ -7063,7 +7214,10 @@
 .    ie '\\$1'' \{\
 .       nr #COVERTEXT_PP 1
 .       di \\*DOC_COVER_TEXT
-.       ev 1
+.       ev COVER_TEXT
+.       evc 0
+\!.     if \\\\n#\\*DOC_COVERTEXT_ONLY \
+.          sp |\\\\n#T_MARGINu-\\\\n#DOC_LEADu
 \!.     ie !\\n#\\*DOC_COVERTEXT_START_POS \{\
 \!.        sp |\\n.pu/3u-1v
 \!.     \}
@@ -7101,7 +7255,7 @@
 \#  <width> and <height> are required.  With no further args, images
 \#  are set at 0,0 by default so that full page images fill the entire
 \#  printer sheet.
-\#  
+\#
 \#  Positioning args are the same as PDF_IMAGE.  -L, -R, -C and -I <ind>
 \#  observe the left and right margins.
 \#
@@ -7337,7 +7491,7 @@
 .       if \\n#\\*DOC_COVER_COLOR=1 \
 .          COLOR \\*$\\*DOC_COVER_COLOR
 .    \\*DOC_COVER_H_POS
-.    if \\n#\\*DOC_COVER_TITLE=2 .ds DOC DOC
+.    if (\\n#\\*DOC_COVER_TITLE=1):(\\n#\\*DOC_COVER_TITLE=2) .ds DOC DOC
 .    fam \\*$\\*DOC_COVER_\\*DOCTITLE_FAM
 .    ft  \\*$\\*DOC_COVER_\\*DOCTITLE_FT
 .    ps  \\*$\\*DOC_COVER_\\*DOCTITLE_SIZE_CHANGE
@@ -7485,10 +7639,16 @@
 .       \}
 .       PDF_BOOKMARK 1 \\*$PDF_\\*DOC_COVER_LABEL \\*PDF_BM
 .    \}
-.    ie !'\\*DOC_'' \
-.       if !\\n#DOC_COVER_TITLE .PDF_BOOKMARK 1 Cover page
-.    el \
-.       if !\\n#COVER_TITLE .PDF_BOOKMARK 1 Title page
+.    ie !'\\*DOC_'' \{\
+.       if !\\n#DOC_COVER_TITLE \
+.          if '\\*$PDF_\\*DOC_COVER_LABEL'' \
+.             PDF_BOOKMARK 1 Cover page
+.    \}
+.    el \{\
+.       if !\\n#COVER_TITLE \
+.          if '\\*$PDF_\\*DOC_COVER_LABEL'' \
+.             PDF_BOOKMARK 1 Title page
+.    \}
 .    rr #\\*DOC_COVER_TITLE
 .\" Subtitle
 .    if \\n#\\*DOC_COVER_SUBTITLE=1 \{\
@@ -7541,7 +7701,7 @@
 .             ie \\n#\\*DOC_COVER_ATTRIBUTE_UNDERLINE=2 \
 .                UNDERSCORE2 \\*$\\*DOC_COVER_ATTRIBUTE_UNDERLINE_GAP \
 \\*$\\*DOC_COVER_ATTRIBUTE_RULE_GAP "\\*$\\*DOC_COVER_ATTRIBUTE_STRING"
-.             el .UNDERSCORE \\*$\\*DOC_COVER_ATTRIBUTE_STRING 
+.             el .UNDERSCORE \\*$\\*DOC_COVER_ATTRIBUTE_STRING
 .          \}
 .          el .PRINT "\\*$\\*DOC_COVER_ATTRIBUTE_STRING"
 .          SMALLCAPS off
@@ -7556,9 +7716,9 @@
 .          if !'\\*$\\*DOC_COVER_AUTHOR_SPACER'' \
 .             sp \\*$\\*DOC_COVER_AUTHOR_SPACER
 .       \}
-.       if '\\$0'COVER' \
+.       if '\\$0'DO_COVER' \
 .          ds $PRFX COVER_
-.       if '\\$0'DOC_COVER' \
+.       if '\\$0'DO_DOC_COVER' \
 .          ds $PRFX DOC_COVER_
 .       DO_AUTHORS
 .       rm $PRFX
@@ -7588,7 +7748,7 @@
 .             ie \\n#\\*DOC_COVER_DOCTYPE_UNDERLINE=2 \
 .                UNDERSCORE2 \\*$\\*DOC_COVER_DOCTYPE_UNDERLINE_GAP \
 \\*$\\*DOC_COVER_DOCTYPE_RULE_GAP "\\*$DOC_TYPE"
-.             el .UNDERSCORE "\\*$DOC_TYPE" 
+.             el .UNDERSCORE "\\*$DOC_TYPE"
 .          \}
 .          el .PRINT "\\*$DOC_TYPE"
 .          SMALLCAPS off
@@ -7608,6 +7768,8 @@
 .          \\*DOC_COVER_TEXT
 .          ev
 .       \}
+.       if \\n#\\*DOC_COVERTEXT_ONLY \
+.          PDF_BOOKMARK 1 \\*$PDF_\\*DOC_COVER_LABEL \\*PDF_BM
 .       rr #\\*DOC_COVERTEXT
 .       rm \\*DOC_COVER_TEXT
 .       rr #DOING_COVERTEXT
@@ -7626,6 +7788,8 @@
 .       rr #COPYRIGHT_V_POS
 .    \}
 .    if \\n#\\*DOC_COVER_COPYRIGHT=1 \{\
+.       if '\\*$\\*DOC_COVER_COPYRIGHT'' \
+.          ds $\\*DOC_COVER_COPYRIGHT \\*$COVER_COPYRIGHT
 .       QUAD \\*$\\*DOC_COVER_COPYRIGHT_QUAD
 .       if \\n#\\*DOC_COVER_COPYRIGHT_COLOR=1 \
 .          COLOR \\*$\\*DOC_COVER_COPYRIGHT_COLOR
@@ -7689,7 +7853,6 @@
 .       if \\nTOC.RELOCATE==4 \
 .          if !rTOC_BH .TOC_AFTER_HERE
 .    \}
-.    if '\\$0'DO_DOC_COVER' .rm DOC_
 .    END_COVER
 .END
 \#
@@ -7698,6 +7861,19 @@
 .MAC END_COVER END
 .    EOL
 .    vpt
+.    rr #\\*DOC_COVERTEXT_ONLY
+.    rr #\\*DOC_COVER_TITLE
+.    rr #\\*DOC_COVERTITLE
+.    rr #\\*DOC_COVER_SUBTITLE
+.    rr #\\*DOC_COVER_AUTHOR
+.    rr #\\*DOC_COVER_DOCTYPE
+.    rr #\\*DOC_COVER_COPYRIGHT
+.    rr #\\*DOC_COVER_MISC
+.    rr #\\*DOC_COVERTEXT
+.    rr #\\*DOC_COVER_IMAGE
+.    rr #\\*DOC_COVER_BLANKPAGE
+.    rm $PDF_\\*DOC_COVER_LABEL
+.    rr #\\*DOC_COVER
 .    if '\\*$COVER_TYPE'DOC_COVER_' .ds DOC DOC
 .    rm $COVER_TYPE
 .    if \\n#DOC_TYPE=5 .nr #SKIP 1
@@ -7706,7 +7882,7 @@
 .    rr #NEWPAGE
 .    rr #SKIP
 .    if \\n#PAGINATION_WAS_ON=1 .nr % +1
-.    ie \\n#\\*DOCCOVER_BLANKPAGE=1 \{\
+.    ie \\n#\\*DOC_COVER_BLANKPAGE=1 \{\
 .       if \\nTOC.RELOCATE \
 .          if !\\n#TOC_BH .TOC_AFTER_HERE
 .\" Without the empty PDF_BOOKMARK, (doc)cover BLANKPAGE causes
@@ -7715,8 +7891,9 @@
 .       PDF_BOOKMARK 1
 .       nop \&
 .       bp
-.       rr #\\*DOCCOVER_BLANKPAGE
+.       rr #\\*DOC_COVER_BLANKPAGE
 .       if !\\n#\\*DOCCOVERS_COUNT=1 .nr % -2
+.       rm DOC_
 .    \}
 .    el \
 .       if !\\n#\\*DOCCOVERS_COUNT=1 .nr #PAGE_NUM_ADJ -1
@@ -7741,6 +7918,7 @@
 .    rr #DOING_COVER
 .    if \\n.ns .nop \&
 .    if \\n#RECTO_VERSO .nr #RV_POST_COVER 1
+.    rm DOC_
 .END
 \#
 \# +++START THE DOCUMENT+++
@@ -7807,10 +7985,12 @@
 .    nr @L_MARGIN \\n#DOC_L_MARGIN
 .    nr @R_MARGIN \\n#DOC_R_MARGIN
 .\" Covers and doc covers
-.    if \\n#DOC_COVERS=1 \
+.    if \\n#DOC_COVERS=1 \{\
 .       if \\n#DOC_COVER=1 .DO_DOC_COVER
-.    if \\n#COVERS=1 \
+.    \}
+.    if \\n#COVERS=1 \{\
 .       if \\n#COVER=1 .DO_COVER
+.    \}
 .    nr PDFHREF.VIEW.LEADING \\nPDFHREF.VIEW.LEADING.T
 .    if !\\n#TOC .RV_HARD_SET_MARGINS
 .    if \\n#COLUMNS .COLUMNS \\n#NUM_COLS \\n#GUTTERu
@@ -7875,10 +8055,15 @@
 .          rm $TOC_TITLE_ITEM_OLD
 .       \}
 .    \}
+.    if !'\\*$TOC_HEADING'' \{\
+.       HEADING_TO_TOC
+.       rm $TOC_HEADING
+.    \}
 .    if !\\n#TOC \{\
 .       if !'\\*$TOC_TITLE_ITEM'' \{\
 .          PDF_BOOKMARK 1 \\*$TOC_TITLE_ITEM
-.          TITLE_TO_TOC
+.          if !r #NO_TOC_ENTRY .TITLE_TO_TOC
+.          if r #NO_TOC_ENTRY  .rr #NO_TOC_ENTRY
 .       \}
 .    \}
 .    if !\\n#TOC .nr #POST_TOP 1
@@ -7893,6 +8078,10 @@
 .    rr #COLLATE
 .    rr #PAGINATION_STATE
 .\" End collate stuff
+.    if \\n#DOC_TYPE=5 \{\
+.       rr @TOP
+.       ch RR_@TOP
+.    \}
 .    sp |\\n#DOCHEADER_ADVANCEu-\\n#DOC_LEADu
 .    ie \\n#DOC_HEADER=0 \{\
 .       if \\n.ns .rs
@@ -7903,7 +8092,7 @@
 .       PP
 .       PARA_INDENT \\n#STORED_PP_INDENTu
 .       rr #STORED_PP_INDENT
-.       ie r#ADVANCE_FROM_TOP \{\
+.       ie r #ADVANCE_FROM_TOP \{\
 .          br
 .          sp |\\n#ADVANCE_FROM_TOPu-1v
 .          if \\n#ADJ_DOC_LEAD=1 \
@@ -8318,7 +8507,7 @@
 .    el \{\
 .       rr #NO_SHIM
 .       rr #SHIM
-.       rr #FLEX_ACTIVE 1
+.       rr #FLEX_ACTIVE
 .   \}
 .END
 \#
@@ -8329,9 +8518,9 @@
 .       if !'\\$0'SHIM_1' .return
 .    if !\\n#NO_FLEX \{\
 .       if !'\\$0'SHIM_1' \{\
-.          tm1 "mom: 
+.          tm1 "mom: \
 SHIM, line \\n.c, is incompatible with flex-spacing, which is enabled.
-.          tm1 "       
+.          tm1 "       \
 Flex-spacing must be disabled with NO_FLEX before using SHIM.
 .          ab mom: Aborting '\\n.F', line \\n.c.
 .       \}
@@ -8574,8 +8763,16 @@
 \#   Forces doccover and cover pages to recto
 \#
 .MAC FORCE_RECTO END
-.    ie '\\$1'' .nr #FORCE_RECTO 1
-.    el .rr #FORCE_RECTO
+.    ie '\\$1'' \{\
+.       nr #FORCE_RECTO 1
+.       nr #DOC_COVER_BLANKPAGE 1
+.       nr #COVER_BLANKPAGE 1
+.    \}
+.    el \{\
+.       rr #FORCE_RECTO
+.       rr #DOC_COVER_BLANKPAGE
+.       rr #COVER_BLANKPAGE
+.    \}
 .END
 \#
 .MAC RV_HARD_SET_MARGINS END
@@ -8835,10 +9032,8 @@
 .          while \\n#EPI_WHITESPACE>\\n#DOC_LEAD \{\
 .             nr #EPI_WHITESPACE -\\n#DOC_LEAD
 .          \}
-.          ie \\n#PRINT_STYLE=1 \{\
-.             if \\n#EPI_WHITESPACE=\\n#DOC_LEAD \
-.                ALD \\n#EPI_WHITESPACEu/2u
-.          \}
+.          ie \\n#PRINT_STYLE=1 \
+.             ALD \\n#DOC_LEADu/2u
 .          el \{\
 .             if \\n#EPI_WHITESPACE<\\n#DOC_LEAD \
 .                ALD \
@@ -8866,36 +9061,12 @@
 .             ALD \\n#EPI_WHITESPACEu-\\n#DOC_LEADu
 .       \}
 .    \}
-.    if \\n#EPIGRAPH=1 \{\
-.       po \\n#L_MARGINu
-.       if \\n#COLUMNS \{\
-.          po \\n#COL_\\n#COL_NUM_L_MARGINu
-.          nr #L_MARGIN \\n.o
-.       \}
-.    \}
-.    if \\n#EPIGRAPH=2 \{\
-.       ie !\\n#EPI_OFFSET_VALUE=0 \
-.          nr #EPI_OFFSET \
-\\n#L_MARGIN+(\\n#PP_INDENT*\\n#EPI_OFFSET_VALUE)
-.       el \
-.          if !'\\*$EPI_OFFSET_VALUE'' \
-.             nr #EPI_OFFSET \\n#L_MARGIN+\\*$EPI_OFFSET_VALUE
-.       if \\n#COLUMNS \{\
-.          ie !\\n#EPI_OFFSET_VALUE=0 \
-.             nr #EPI_OFFSET \
-\\n#COL_\\n#COL_NUM_L_MARGIN+(\\n#PP_INDENT*\\n#EPI_OFFSET_VALUE)
-.          el \
-.             if !'\\*$EPI_OFFSET_VALUE'' \
-.                nr #EPI_OFFSET \
-\\n#COL_\\n#COL_NUM_L_MARGIN+\\*$EPI_OFFSET_VALUE
-.       \}
-.       if !\\n#EPI_OFFSET=0 .po \\n#EPI_OFFSETu
-.    \}
+.    SET_EPI_OFFSET
 .    nf
 .    EPI_TEXT
 .    br
 .    ie \\n#START \{\
-.       if \\n#PRINT_STYLE=1 .SHIM
+.       if \\n#PRINT_STYLE=1 .SHIM_1
 .       if \\n#PRINT_STYLE=2 \{\
 .          if \\n#EPI_WHITESPACE<\\n#DOC_LEAD \
 .             ALD \\n#EPI_WHITESPACEu/2u
@@ -8917,10 +9088,8 @@
 .             ALD \\n#EPI_WHITESPACEu-(\\n#DOC_LEADu-\\n#EPI_LEADu)
 .          \}
 .          el \{\
-.             ie \\n#PRINT_STYLE=1 \{\
-.                if \\n#EPI_WHITESPACE=\\n#DOC_LEAD \
-.                   ALD \\n#EPI_WHITESPACEu
-.             \}
+.             ie \\n#PRINT_STYLE=1 \
+.                SHIM_1
 .             el \{\
 .                if \\n#EPI_WHITESPACE<\\n#DOC_LEAD \
 .                   ALD \\n#EPI_WHITESPACEu/2u
@@ -8928,6 +9097,7 @@
 .                   ALD (\\n#EPI_WHITESPACEu/2u)-\\n#DOC_LEADu
 .             \}
 .          \}
+.          SHIM
 .       \}
 .       el \{\
 .          nr #EPI_LINES_TO_END \\n#EPI_LINES-\\n#EPI_LINES_TO_TRAP
@@ -8971,6 +9141,37 @@
 .    \}
 .END
 \#
+.MAC SET_EPI_OFFSET END
+.    if \\n#EPIGRAPH=1 \{\
+.       po \\n#L_MARGINu
+.       if \\n#COLUMNS \{\
+.          po \\n#COL_\\n#COL_NUM_L_MARGINu
+.          nr #L_MARGIN \\n.o
+.       \}
+.    \}
+.    if \\n#EPIGRAPH=2 \{\
+.       ie !\\n#EPI_OFFSET_VALUE=0 \
+.          nr #EPI_OFFSET \
+\\n#L_MARGIN+(\\n#PP_INDENT*\\n#EPI_OFFSET_VALUE)
+.       el \
+.          if !'\\*$EPI_OFFSET_VALUE'' \
+.             nr #EPI_OFFSET \\n#L_MARGIN+\\*$EPI_OFFSET_VALUE
+.       if \\n#COLUMNS \{\
+.          ie !\\n#EPI_OFFSET_VALUE=0 \
+.             nr #EPI_OFFSET \
+\\n#COL_\\n#COL_NUM_L_MARGIN+(\\n#PP_INDENT*\\n#EPI_OFFSET_VALUE)
+.          el \
+.             if !'\\*$EPI_OFFSET_VALUE'' \
+.                nr #EPI_OFFSET \
+\\n#COL_\\n#COL_NUM_L_MARGIN+\\*$EPI_OFFSET_VALUE
+.       \}
+.       if !'\\$0'GET_EPI_OFFSET' \
+.          if !\\n#EPI_OFFSET=0 .po \\n#EPI_OFFSETu
+.    \}
+.END
+.
+.ALIAS GET_EPI_OFFSET SET_EPI_OFFSET
+\#
 \# ====================================================================
 \#
 \# +++FINIS MACRO+++
@@ -9044,7 +9245,7 @@
 .ALIAS SLIDE# PAGE#
 \#
 .MAC RESTORE_SPACE END
-.   vpt 0
+.   if !\\n#START .vpt 0
 .   if \\n@TOP \{\
 .      ch RR_@TOP
 .      rr @TOP
@@ -9059,7 +9260,7 @@
 .      fi
 .      rr #FILLED
 .   \}
-.   vpt
+.   if !\\n#START .vpt
 .END
 \#
 \# HDRFTR RULE GAP
@@ -9488,7 +9689,7 @@
 .MAC HDRFTR_RECTO END
 .    nr #USERDEF_HDRFTR 1
 .    ds $QUAD_TYPE \\$1
-.    substring $QUAD-TYPE 0 0
+.    substring $QUAD_TYPE 0 0
 .    if '\\*$QUAD_TYPE'L' .nr #USERDEF_HDRFTR_RECTO_QUAD 1
 .    if '\\*$QUAD_TYPE'C' .nr #USERDEF_HDRFTR_RECTO_QUAD 2
 .    if '\\*$QUAD_TYPE'R' .nr #USERDEF_HDRFTR_RECTO_QUAD 3
@@ -9515,10 +9716,10 @@
 .MAC HDRFTR_VERSO END
 .    nr #USERDEF_HDRFTR 1
 .    ds $QUAD_TYPE \\$1
-.    substring $QUAD-TYPE 0 0
-.    if '\\*$QUAD_TYPE'L'     .nr #USERDEF_HDRFTR_VERSO_QUAD 1
-.    if '\\*$QUAD_TYPE\\$1'C' .nr #USERDEF_HDRFTR_VERSO_QUAD 2
-.    if '\\*$QUAD_TYPE\\$1'R' .nr #USERDEF_HDRFTR_VERSO_QUAD 3
+.    if !'\\*$QUAD_TYPE'' .substring $QUAD_TYPE 0 0
+.    if '\\*$QUAD_TYPE'L' .nr #USERDEF_HDRFTR_VERSO_QUAD 1
+.    if '\\*$QUAD_TYPE'C' .nr #USERDEF_HDRFTR_VERSO_QUAD 2
+.    if '\\*$QUAD_TYPE'R' .nr #USERDEF_HDRFTR_VERSO_QUAD 3
 .    shift
 .    ie '\\$1'CAPS' \{\
 .       nr #HDRFTR_VERSO_CAPS 1
@@ -9928,8 +10129,8 @@
 .    if \\n#DOC_TYPE=5 \{\
 .       if \\n#SLIDE_FOOTERS \{\
 .          PRINT_FOOTER
-.       if \\n#HDRFTR_BOTH \
-.          HEADER_RECTO \\*$HDR_RECTO_QUAD "\\*$HDR_RECTO_STRING"
+.          if \\n#HDRFTR_BOTH \
+.             HEADER_RECTO \\*$HDR_RECTO_QUAD "\\*$HDR_RECTO_STRING"
 .       \}
 .    \}
 .    nr flex-spaces 0
@@ -10023,6 +10224,18 @@
 .    \}
 .    nr #PAGE_TOP \\nnl
 .    ev
+.\" PDF boxes
+.    if \\npdfbx-running=1 \{\
+.       if !\\npdfbx-div-start \{\
+.          ps \\n#SIZE_AT_FOOTERu
+.          SIZESPECS
+.          ds pdfbx-cap-adj \\*$CAP_HEIGHT
+.          ps
+.          sp |\\ntu-\\n#LEAD_AT_FOOTERu
+.          sp (\\*wt\\nstack/2u)+\\*pdfbx-cap-adj+\\*gap\\nstacku
+.          ch FOOTER \\n#VFP\\nstacku
+.       \}
+.    \}
 .    po \\n#L_MARGINu
 .    if \\n#RECTO_VERSO .nr #L_MARGIN +\\n#L_MARGIN_DIFF
 .    if \\n#CAPS_WAS_ON \{\
@@ -10033,12 +10246,19 @@
 .    if \\n#QUOTE \{\
 .       ie \\n#TAB_ACTIVE .TAB \\n#CURRENT_TAB
 .       el \{\
-.          ie \\n#Q_OFFSET_VALUE .nr #Q_OFFSET \
-\\n#L_MARGIN+(\\n#PP_INDENT*\\n#Q_OFFSET_VALUE)
-.          el .nr #Q_OFFSET \\n#L_MARGIN+\\*$Q_OFFSET_VALUE
-.          po \\n#Q_OFFSETu
+.          ie r #\\*BQ_OFFSET_VALUE .nr #\\*BQ_OFFSET \
+\\n#L_MARGIN+(\\n#PP_INDENT*\\n#\\*BQ_OFFSET_VALUE)
+.          el .nr #\\*BQ_OFFSET \\n#L_MARGIN+\\*$\\*BQ_OFFSET_VALUE
+.          ie \\n#QUOTE=1 \{\
+.             if !'\\*$Q_QUAD'CENTER' \
+.                if !'\\*$Q_QUAD'RIGHT' \
+.                   po \\n#Q_OFFSETu
+.          \}
+.          el .po \\n#\\*BQ_OFFSETu
+.       \}
+.       if !\\npdfbx-running=0 \{\
+.          if \\n#PRINT_STYLE=2 .sp \\n#Q_LEAD_DIFFu
 .       \}
-.       if \\n#PRINT_STYLE=2 .sp \\n#Q_LEAD_DIFFu
 .    \}
 .    if \\n#IN_LIST \
 .       po +\\n#LIST_OFFSET_VALUEu
@@ -10129,7 +10349,7 @@
 .       vs 0
 .       ie !n \
 .          nop \R'#UNDERLINE_ON 1'\X'ps: exec \\n_w \\n_d decorline'
-.       el .ul 1000
+.       el .cu 1000
 .       br
 .       ns
 .       rr #UNDERLINE_WAS_ON
@@ -10205,6 +10425,12 @@
 .    if r flex:force .rr flex:force
 .    rr ref*last
 .    if !\\nfloat*defer .ev 0
+.    if (\\npdfbx-running=1):(\\n#DOC_TYPE=5) \{\
+.       rr @TOP
+.       ch RR_@TOP
+.    \}
+.    if \\npdfbx-running=1 \
+.       ch FOOTER \\n#VFP\\nstacku
 .END
 \#
 \# ====================================================================
@@ -10278,6 +10504,13 @@
 \#
 .MAC FOOTER END
 .    if r #START .rr #START
+.    if \\npdfbx-running \{\
+.       if \\n#FN_COUNT \{\
+.          nr pdfbx-fn-trap \\nnl+\\*wt\\nstack+\\*gap\\nstack
+.          nop \!x X pdf: background footnote \\npdfbx-fn-trapz
+.          rr pdfbx-fn-trap
+.       \}
+.    \}
 .    CALCULATE_FLEX
 .    if \\n#DOING_COVERTEXT \{\
 .       tm1 "mom: COVERTEXT exceeds cover page depth.
@@ -10286,12 +10519,13 @@
 .    vpt 0
 .    rr #LB_4_HD
 .    rr #QUOTE_4_HD
-.    nr #SAVED_LEAD \\n.v
+.    nr #LEAD_AT_FOOTER \\n.v
+.    nr #SIZE_AT_FOOTER \\n.ps
 .    if !r pg-trans .nr pg-trans 0 1
 .    ev PAGE_TRANSITION\\n+pg-trans
 .    pdfmarksuspend
 .    ie !n .nop \X'ps: exec decornone'
-.    el .ul 0
+.    el .cu 0
 .    br
 .    if \\n#UNDERLINE_ON=1 .nr #UNDERLINE_WAS_ON 1
 .    if \\nMN-left>0 \{\
@@ -10337,8 +10571,8 @@
 .          FOOTNOTES
 .          rm FOOTNOTES
 .          if d RUNON_FOOTNOTES   .rm RUNON_FOOTNOTES
-.          if \\n#PRINT_STYLE=1 .vs \\n#SAVED_LEADu
-.          if \\n#PRINT_STYLE=2 .vs \\n#SAVED_LEADu
+.          if \\n#PRINT_STYLE=1 .vs \\n#LEAD_AT_FOOTERu
+.          if \\n#PRINT_STYLE=2 .vs \\n#LEAD_AT_FOOTERu
 .          if '\\n.z'FN_OVERFLOW' \{\
 .             di
 .             nr #FN_OVERFLOW_DEPTH \\n#DIVER_DEPTH
@@ -10354,14 +10588,17 @@
 .    \}
 .    nr @TOP 1
 .    ie \\n#COLUMNS=1 \{\
-.       ie (\\n#COL_NUM=\\n#NUM_COLS):(\\n#NEWPAGE=1) .DO_FOOTER
+.       ie (\\n#COL_NUM=\\n#NUM_COLS):(\\n#NEWPAGE=1) \{\
+.          rr #NEWPAGE
+.          DO_FOOTER
+.       \}
 .       el \{\
 .          ie (\\n#ENDNOTES=1):(\\n#BIBLIOGRAPHY=1) \{\
 .             if \\n#ENDNOTES .sp |\\necu-\\n#EN_LEADu
 .             if \\n#BIBLIOGRAPHY .sp |\\nbcu-\\n#BIB_LEADu
 .          \}
 .          el \{\
-.            vs \\n#SAVED_LEADu
+.            vs \\n#LEAD_AT_FOOTERu
 .            rt \\ndcu
 .            nr flex-spaces 0
 .          \}
@@ -10390,7 +10627,7 @@
 .          \}
 .          nr #L_MARGIN \\n.o
 .          if \\n#FN_DEPTH .PROCESS_FN_LEFTOVER
-.          vs \\n#SAVED_LEADu
+.          vs \\n#LEAD_AT_FOOTERu
 .          if \\n#PREV_FN_DEFERRED .nr #PREV_FN_DEFERRED 2
 .          rr #RULED
 .          if !\\n#EPIGRAPH .rr #COL_NEXT
@@ -10398,7 +10635,7 @@
 .          if \\n#RESET_FN_COUNTERS=1 \{\
 .             rr #RESET_FN_COUNTERS
 .             PROCESS_FN_IN_DIVER
-.             LS \\n#SAVED_LEADu
+.             LS \\n#LEAD_AT_FOOTERu
 .             nr #FN_COUNT \\n#FN_COUNT 1
 .             nr #FN_COUNT_FOR_COLS \\n#FN_COUNT_FOR_COLS 1
 .             rm FN_IN_DIVER
@@ -10489,6 +10726,11 @@
 \#   Resets CAPS and UNDERLINE if they were on.
 \#
 .MAC DO_FOOTER END
+.\" Kill pdfbackground if BoxStop causes a page break
+.    if r pdfbxstop \{\
+.       pdfbackground off
+.       rr pdfbx-running
+.    \}
 .\" Part of workaround for refer spitting out a blank page if the
 .\" last reference falls on the bottom line.
 .    if \\nnum*refs \{\
@@ -10681,8 +10923,13 @@
 \#   If PARAHEAD given, HEADING must come after PP.
 \#
 .MAC HEADING END
-'    br
-.    if \\n@TOP .br
+.    ie !r pdfbx-top \{\
+'       br
+.       if \\n@TOP .br
+.    \}
+.    el \{\
+.       if r pdfbx-running .nr pdfbx-top 1
+.    \}
 .    if !\B'\\$1' \{\
 .       tm1 "mom: The first argument to \\$0 must be a numeric heading level.
 .       ab   mom: Aborting '\\n.F' at \\$0, line \\n.c.
@@ -10718,7 +10965,8 @@
 .             if \\n#HEAD_\\n#LEVEL_SPACE_AFTER .nr #HEADING_NEEDS +1v
 .             if \\n.t<\\n#HEADING_NEEDS .sp \\n.tu
 .             vpt 0
-.             if !\\n#SPACE_ADDED .if !\\n#LINEBREAK .sp
+.             if !r pdfbx-top \
+.               if !\\n#SPACE_ADDED .if !\\n#LINEBREAK .sp
 .          \}
 .          el \{\
 .             ie !\\n#PP \{\
@@ -10737,10 +10985,12 @@
 .       ie !\\n#SPACE_ADDED \{\
 .          if !\\n.ns \{\
 .             ie !\\n#NO_SHIM \
-.                if !\\n#HEAD_\\n#LEVEL_NO_SHIM .SHIM
+.                if !\\n#HEAD_\\n#LEVEL_NO_SHIM \
+.                   if !r pdfbx-top .SHIM
 .             el \{\
 .                if !\\n#NO_FLEX \
-.                   if !\\n#HEAD_\\n#LEVEL_NO_FLEX .FLEX 
+.                   if !\\n#HEAD_\\n#LEVEL_NO_FLEX \
+.                   if !r pdfbx-top .FLEX
 .             \}
 .          \}
 .       \}
@@ -10772,6 +11022,18 @@
 .       fam \\*$HEAD_\\n#LEVEL_FAM
 .       ft  \\*$HEAD_\\n#LEVEL_FT
 .       ps  \\n#DOC_PT_SIZEu\\*$HEAD_\\n#LEVEL_SIZE
+.       if r pdfbx-top \{\
+.          SIZESPECS
+.          ie \\n#PP=0 \{\
+.             rt
+.             ds pdfbx-cap-adj \\*$CAP_HEIGHT
+.             sp (\\*wt\\nstack/2u)+\\*pdfbx-cap-adj+\\*gap\\nstacku
+.          \}
+.          el \{\
+.             nr pdfbx-cap-adj \\*$CAP_HEIGHT-\\*pdfbx-cap-adj
+.             sp \\npdfbx-cap-adju
+.          \}
+.       \}
 .       nf
 .    \}
 .\" Numbering
@@ -10951,7 +11213,7 @@
 .       nr #CAPS_RESTORE 1
 .    \}
 .    if \\n#HEAD_\\n#LEVEL_CAPS \{\
-.       CAPS 
+.       CAPS
 .       nr #CAPS_OFF 1
 .    \}
 .    if \\n#SMALLCAPS_ON \{\
@@ -10959,12 +11221,16 @@
 .       nr #SMALLCAPS_RESTORE 1
 .    \}
 .    if \\n#HEAD_\\n#LEVEL_SMALLCAPS \{\
-.       SMALLCAPS 
+.       SMALLCAPS
 .       nr #SMALLCAPS_OFF 1
 .    \}
 .    if !'\\*$HEAD_\\n#LEVEL_COLOR'' \
 .       COLOR \\*$HEAD_\\n#LEVEL_COLOR
 .    nop \X'ps: exec decornone'\c
+.    if r pdfbx-top \{\
+.       ds $RESTORE_ADJ \\*$HEAD_\\n#LEVEL_BASELINE_ADJ
+.       ds $HEAD_\\n#LEVEL_BASELINE_ADJ 0
+.    \}
 .    nr #ARG_NUM 0 1
 .    while \\n+#ARG_NUM<=\\n#NUM_ARGS \{\
 .       if \\n#PARAHEAD \
@@ -10973,7 +11239,7 @@
 .       if (\\n#HEAD_\\n#LEVEL_UNDERSCORE=0)&(\\n#HEAD_\\n#LEVEL_UNDERSCORE2=0) \{\
 .          ie \\n#HD_NUM_INDENT \{\
 .             if !'\\*$HEAD_\\n#LEVEL_QUAD'CENTER' \
-.                ti \\n#HD_NUM_INDENTu 
+.                ti \\n#HD_NUM_INDENTu
 .             PRINT \
 "\v'-\\*$HEAD_\\n#LEVEL_BASELINE_ADJ'\\$\\n#ARG_NUM
 .             br
@@ -10992,7 +11258,8 @@
 .                            ie \\n#PP=1 .br
 .                            el \{\
 .                               nr #PP_TEXT_OFFSET +\\n#PP_INDENT
-.                               ti \\n#PP_INDENTu
+.                               ie !\\npdfbx-running .ti \\n#PP_INDENTu
+.                               el .ti \\n#PP_INDENTu+\\*wt\\nstack+\\*gap\\nstacku
 .                            \}
 .                         \}
 .                      \}
@@ -11011,7 +11278,7 @@
 .          UNDERSCORE_WEIGHT \\*$HEAD_\\n#LEVEL_UL_WEIGHT
 .          ie \\n#HD_NUM_INDENT \{\
 .             if !'\\*$HEAD_\\n#LEVEL_QUAD'CENTER' \
-.                ti \\n#HD_NUM_INDENTu 
+.                ti \\n#HD_NUM_INDENTu
 .             UNDERSCORE \\*$HEAD_\\n#LEVEL_UL_GAP \
                 "\v'-\\*$HEAD_\\n#LEVEL_BASELINE_ADJ'\\$\\n#ARG_NUM
 .             br
@@ -11046,7 +11313,7 @@
 .          UNDERSCORE_WEIGHT \\*$HEAD_\\n#LEVEL_UL2_WEIGHT
 .          ie \\n#HD_NUM_INDENT \{\
 .             if !'\\*$HEAD_\\n#LEVEL_QUAD'CENTER' \
-.                ti \\n#HD_NUM_INDENTu 
+.                ti \\n#HD_NUM_INDENTu
 .             UNDERSCORE2 \\*$HEAD_\\n#LEVEL_UL2_GAP_1 \
                 \\*$HEAD_\\n#LEVEL_UL2_GAP_2 \
                 "\v'-\\*$HEAD_\\n#LEVEL_BASELINE_ADJ'\\$\\n#ARG_NUM
@@ -11081,6 +11348,10 @@
 .       \}
 .       if !\\n#HD_NUM_INDENT .nr #HD_NUM_INDENT \w'\\*$HD_NUM'
 .    \}
+.    if r pdfbx-top \{\
+.       ds $HEAD_\\n#LEVEL_BASELINE_ADJ \\*$RESTORE_ADJ
+.       if !\\n#PARAHEAD .sp \\*$HEAD_\\n#LEVEL_BASELINE_ADJ 
+.    \}
 .    if !\\n#PARAHEAD \
 .       if \\n#HEAD_\\n#LEVEL_SPACE_AFTER .sp
 .    if \\n#CAPS_OFF \{\
@@ -11102,11 +11373,6 @@
 .    ev
 .    rm $HD_NUM
 .    rr #HD_NUM_INDENT
-.    if \\n#PARAHEAD   .ti \\n#PP_TEXT_OFFSETu
-.    if !\\n#PARAHEAD  .nr #PP 0
-.    rr #PARAHEAD
-.    if \\n#LB_4_HD    .rr #LB_4_HD
-.    if \\n#QUOTE_4_HD .rr #QUOTE_4_HD
 .    if \\n@TOP \{\
 .       ch RR_@TOP
 .       rr @TOP
@@ -11114,8 +11380,20 @@
 .       nop \&
 .       sp -1
 .    \}
+.    if \\n#PARAHEAD \{\
+.       ie !\\npdfbx-running .ti \\n#PP_TEXT_OFFSETu
+.       el .ti \\n#PP_TEXT_OFFSETu+\\*wt\\nstack+\\*gap\\nstacku
+.    \}
+.    if !\\n#PARAHEAD  .nr #PP 0
+.    rr #PARAHEAD
+.    if \\n#LB_4_HD    .rr #LB_4_HD
+.    if \\n#QUOTE_4_HD .rr #QUOTE_4_HD
 .    vpt
 .    rr nl-from-heading
+.    if r pdfbx-top \{\
+.       rr pdfbx-top
+.       nr pdfbx-top\\nstack 1
+.    \}
 .END
 \#
 \# HEADING_STYLE
@@ -11131,7 +11409,7 @@
 \#   QUAD   <direction>
 \#   NUMBER | NO_NUMBER
 \#   SPACE_AFTER | NO_SPACE_AFTER
-\#   UNDERSCORE <weight> <gap> | UNDERSCORE2 <weight> <gap1> <gap2> 
+\#   UNDERSCORE <weight> <gap> | UNDERSCORE2 <weight> <gap1> <gap2>
 \#   NO_UNDERSCORE | NO_UNDERSCORE2
 \#   BASELINE_ADJUST
 \#---when called as TOC_ENTRY_STYLE this is also available---
@@ -11156,14 +11434,16 @@
 \#   <level> will have their indents adjusted accordingly.
 \#
 .MAC HEADING_STYLE END
-.    if !\B'\\$1' \{\
-.       tm1 "mom: The first argument to \\$0 must be a numeric heading level.
-.       ab   mom: Aborting '\\n.F' at \\$0, line \\n.c.
-.    \}
-.    nr #LEVEL \\$1
-.    if \\n#FROM_OLDSTYLE .nr #LEVEL_\\n#LEVEL_SET 1
-.    shift
+.    if !'\\$0'TOC_HEADING_STYLE' \{\
+.       if !\B'\\$1' \{\
+.          tm1 "mom: The first argument to \\$0 must be a numeric heading level.
+.          ab   mom: Aborting '\\n.F' at \\$0, line \\n.c.
+.       \}
+.       nr #LEVEL \\$1
+.       if \\n#FROM_OLDSTYLE .nr #LEVEL_\\n#LEVEL_SET 1
+.       shift
 .\" Prepend TOC_ to style strings if called as TOC_ENTRY_STYLE
+.    \}
 .    if '\\$0'TOC_ENTRY_STYLE' .ds $TOC TOC_
 .    nr #ARG_NUM 0 1
 .    nr #ATTRIB \\n#NUM_ARGS
@@ -11214,6 +11494,16 @@
 .          rr #HEAD_\\n#LEVEL_UNDERSCORE2
 .          shift
 .       \}
+.       if '\\$1'SPACE_ABOVE' \{\
+.          shift
+.          ds $SPACE_ABOVE \\$1
+.          shift
+.       \}
+.       if '\\$1'SPACE_BENEATH' \{\
+.          shift
+.          ds $SPACE_BENEATH \\$1
+.          shift
+.       \}
 .       if '\\$1'SPACE_AFTER' \{\
 .          nr #HEAD_\\n#LEVEL_SPACE_AFTER 1
 .          shift
@@ -11224,31 +11514,42 @@
 .       \}
 .       if '\\$1'FAMILY' \{\
 .          shift
-.          ds $\\*$TOCHEAD_\\n#LEVEL_FAM  \\$1
+.          ds $\\*$TOCHEAD_\\n#LEVEL_FAM \\$1
+.          if '\\$0'TOC_HEADING_STYLE' .ds $TOC_HEADING_FAM \\$1
 .          shift
 .       \}
 .       if '\\$1'FONT' \{\
 .          shift
-.          ds $\\*$TOCHEAD_\\n#LEVEL_FT   \\$1
+.          ds $\\*$TOCHEAD_\\n#LEVEL_FT \\$1
+.          if '\\$0'TOC_HEADING_STYLE' .ds $TOC_HEADING_FT \\$1
 .          shift
 .       \}
 .       if '\\$1'SIZE' \{\
 .          shift
 .          ds $\\*$TOCHEAD_\\n#LEVEL_SIZE \\$1
+.          if '\\$0'TOC_HEADING_STYLE' .ds $TOC_HEADING_SIZE \\$1
 .          shift
 .       \}
 .       if '\\$1'QUAD' \{\
 .          shift
 .          ds $QUAD_TYPE \\$1
 .          substring $QUAD_TYPE 0 0
-.          if '\\*$QUAD_TYPE'L' .ds $HEAD_\\n#LEVEL_QUAD LEFT
-.          if '\\*$QUAD_TYPE'C' .ds $HEAD_\\n#LEVEL_QUAD CENTER
-.          if '\\*$QUAD_TYPE'R' .ds $HEAD_\\n#LEVEL_QUAD RIGHT
+.          ie !'\\$0'TOC_HEADING_STYLE' \{\
+.             if '\\*$QUAD_TYPE'L' .ds $HEAD_\\n#LEVEL_QUAD LEFT
+.             if '\\*$QUAD_TYPE'C' .ds $HEAD_\\n#LEVEL_QUAD CENTER
+.             if '\\*$QUAD_TYPE'R' .ds $HEAD_\\n#LEVEL_QUAD RIGHT
+.          \}
+.          el \{\
+.             if '\\*$QUAD_TYPE'L' .ds $TOC_HEADING_QUAD LEFT
+.             if '\\*$QUAD_TYPE'C' .ds $TOC_HEADING_QUAD CENTER
+.             if '\\*$QUAD_TYPE'R' .ds $TOC_HEADING_QUAD RIGHT
+.          \}
 .          shift
 .       \}
 .       if '\\$1'COLOR' \{\
 .          shift
 .          ds $\\*$TOCHEAD_\\n#LEVEL_COLOR \\$1
+.          if '\\$0'TOC_HEADING_STYLE' .ds $TOC_HEADING_COLOR \\$1
 .          shift
 .       \}
 .       if '\\$1'BASELINE_ADJUST' \{\
@@ -11281,6 +11582,13 @@
 .          rr #NUMBER_HEAD_\\n#LEVEL
 .          shift
 .       \}
+.       if '\\$1'PREFIX_CHAPTER' \{\
+.          shift
+.          ie \B'\\$1' \{\
+.             PREFIX_CHAPTER_NUMBER \\$1
+.          \}
+.          el .PREFIX_CHAPTER_NUMBER
+.       \}
 .       if '\\$1'INDENT' \{\
 .          shift
 .          nr #TOC_HEAD_\\n#LEVEL_INDENT \\$1
@@ -11313,7 +11621,8 @@
 .    if d$TOC .rm $TOC
 .END
 .
-.ALIAS TOC_ENTRY_STYLE HEADING_STYLE
+.ALIAS TOC_ENTRY_STYLE   HEADING_STYLE
+.ALIAS TOC_HEADING_STYLE HEADING_STYLE
 \#
 \# OLDSTYLE HEADINGS
 \# -----------------
@@ -11492,15 +11801,30 @@
 \# *Arguments:
 \#   <none> | <chapter number> | <anything>
 \# *Function:
-\#   Toggles register #PREFIX_CH_NUM. Sets register #CH_NUM from
-\#   string $CHAPTER if $CHAPTER is a digit; if <chapter number> arg
-\#   given, sets #CH_NUM to arg.
+\#   Toggles register #PREFIX_CH_NUM. Uses $CHAPTER to set #CH_NUM
+\#   if $CHAPTER is a digit; if <chapter number> given, sets #CH_NUM
+\#   to arg.
 \# *Notes:
 \#   Default is OFF.
 \#
 .MAC PREFIX_CHAPTER_NUMBER END
+.    if \\n#NUM_ARGS=0 \{\
+.       if !'\\*$CHAPTER'' \{\
+.          if !\B'\\*$CHAPTER' \{\
+.             tm1 "mom: \\$0 at line \\n.c cannot determine a chapter number.
+.             tm1 "       Enter the current chapter number as a digit after PREFIX_CHAPTER.
+.             ab  mom: Aborting '\\n.F', line \\n.c.
+.          \}
+.       \}
+.    \}
 .    ie '\\$1'' .nr #PREFIX_CH_NUM 1
-.    el .rr #PREFIX_CH_NUM
+.    el \{\
+.      ie \B'\\$1' \{\
+.        nr #PREFIX_CH_NUM 1
+.        nr #CH_NUM \\$1
+.      \}
+.      el .rr #PREFIX_CH_NUM
+.   \}
 .END
 \#
 \# ====================================================================
@@ -11547,7 +11871,12 @@
 \#
 .MAC LINEBREAK END
 .    if r #Q_AT_TOP .rr #Q_AT_TOP
-.    ie  '\\*$LINEBREAK_CHAR'' .sp 2
+.    if \\n@TOP .RESTORE_SPACE
+.    ie '\\*$LINEBREAK_CHAR'' \{\
+.       br
+.       nop \&
+.       sp
+.    \}
 .    el \{\
 .       ie \\n#END_QUOTE .
 .       el .sp
@@ -11679,6 +12008,7 @@
 .       el .ti \\n#PP_INDENTu
 .       return
 .    \}
+.    if \\n#PP>0 .br
 .    if \\n#DOC_TYPE=4 \{\
 .       if !'\\n.z'' .di
 .       nr #TOTAL_FIELDS \\n#FIELD
@@ -11788,6 +12118,10 @@
 .                \}
 .             \}
 .          \}
+.          if \\nrestore-pp-space \{\
+.             rr restore-pp-space
+.             PARA_SPACE
+.          \}
 .          ie \\n#INDENT_ACTIVE .ti \\n#INDENTu+\\n#PP_INDENTu
 .          el .ti \\n#PP_INDENTu
 .          if '\\n.z'END_NOTES' \
@@ -11847,11 +12181,12 @@
 .    if r #QUOTE_4_HD .rr #QUOTE_4_HD
 .    if r #LB_4_HD .rr #LB_4_HD
 .END
+\#
 \# ====================================================================
 \#
 \# +++QUOTES+++
 \#
-\# ---Line for line quotes, i.e. poetry or code snippets---
+\# ---Line for line quotes, e.g. poetry or code snippets---
 \#
 \# UNDERLINE QUOTES
 \# ----------------
@@ -11947,6 +12282,7 @@
 .       br
 .    el 'br
 .    if \\n#PP>0 .rr #START
+.    if '\\n.z'FLOAT*DIV' .nr Q-float 1
 .    if \\n#LINENUMBERS=1 \{\
 .       nr #LINENUMBERS 2
 .       nr #NEXT_LN \\nln
@@ -11965,7 +12301,7 @@
 .       nr #IN_DIVER 1
 .       nr #QUOTE 1
 .       di P_QUOTE
-.       if '\\*$Q_QUAD'LEFT' \{\
+.       if '\\*$Q_QUAD'RIGHT' \{\
 .          ie !'\\*$Q_OFFSET_VALUE'' .ll \\n#L_LENGTHu-\\*$Q_OFFSET_VALUE
 .          el .ll \\n#L_LENGTHu-(\\n#PP_INDENTu*\\n#Q_OFFSET_VALUEu)
 .       \}
@@ -12080,7 +12416,7 @@
 .          if \\n#CODE_COLOR=1 .COLOR \\*$CODE_COLOR
 .          char ' \aq
 .          if !\\n#CODE_SIZE_ADJ=0 \{\
-.             nr #RESTORE_SIZE \\n.s
+.             ds $RESTORE_SIZE \\n.s
 .             ps \\n#PT_SIZEu*\\n#CODE_SIZE_ADJu/100u
 .          \}
 .          if \\n#SQ_ON \{\
@@ -12090,9 +12426,9 @@
 .       \}
 .    \}
 .    el \{\
-.       fam \\*#RESTORE_FAM
-.       ft  \\*#RESTORE_FT
-.       if !\\n#CODE_SIZE_ADJ=0 .ps \\n#RESTORE_SIZE
+.       fam \\*$RESTORE_FAM
+.       ft  \\*$RESTORE_FT
+.       if !\\n#CODE_SIZE_ADJ=0 .ps \\*$RESTORE_SIZE
 .       rm $RESTORE_FAM
 .       rm $RESTORE_FT
 .       rm $RESTORE_SIZE
@@ -12109,6 +12445,7 @@
 .          SMARTQUOTES
 .       \}
 .       if \\n#QUOTE .sp -1
+.       if \\npdfbx-end .if !\\n#QUOTE .sp -1
 .    \}
 .END
 \#
@@ -12130,8 +12467,11 @@
 \#   but required if there's more than one.
 \#
 .MAC BLOCKQUOTE END
-.    br
+.    ie \\n@TOP \
+.       br
+.    el 'br
 .    if \\n#PP>0 .rr #START
+.    if '\\n.z'FLOAT*DIV' .nr Q-float 1
 .    if \\n#LINENUMBERS=1 \{\
 .       nr #LINENUMBERS 2
 .       nr #NEXT_LN \\nln
@@ -12141,7 +12481,6 @@
 .       ds $BQ_SPACE_ADJUST \\$2
 .       shift 2
 .    \}
-.    if \\nin-cutaround .nr #PP_INDENT \\nrestore-pp-ind/2
 .    ie '\\$1'' \{\
 .       ev BLOCKQUOTE
 .       evc 0
@@ -12152,16 +12491,9 @@
 .       nr #QUOTE    2
 .       nr #PP_STYLE 2
 .       nr #Q_PP     0
-.       if \\nin-cutaround \{\
-.          if '\\*cutaround-type'RIGHT' \{\
-.             nr reset-ll 1
-.             nr #L_LENGTH \\n#DOC_L_LENGTH-\\ncutaround-width-1v\\*width-adj
-.          \}
-.       \}
 .       di B_QUOTE
 .       ie !'\\*$BQ_OFFSET_VALUE'' .ll \\n#L_LENGTHu-(\\*$BQ_OFFSET_VALUE*2u)
 .       el .ll \\n#L_LENGTHu-(\\n#PP_INDENTu*(\\n#BQ_OFFSET_VALUEu*2u))
-.       if \\nin-cutaround .nr #PP_INDENT \\n.i+\\npp-ind-tmp
 .       if \\n#ENDNOTE \{\
 .          if \\n#EN_NUMBERS_ALIGN_RIGHT \{\
 .             ie r#BQ_OFFSET_VALUE \
@@ -12288,12 +12620,6 @@
 .    di
 .    if '\\$0'DO_BLOCKQUOTE' .ds BQ BQ
 .    if '\\$0'DO_QUOTE'      .ds BQ Q
-.    if \\nin-cutaround \{\
-.       if \\ndn>\\n.t \{\
-.          tm1 "mom: Blockquote depth exceeds cutaround depth."
-.          ab   mom: Aborting at line \\n.c.
-.       \}
-.    \}
 .    rr #IN_DIVER
 .    if \\n#RESET_FN_COUNTERS=2 \{\
 .       if !\\n#FN_COUNT=1 \{\
@@ -12308,14 +12634,17 @@
 .    REMOVE_INDENT
 .    ev
 .    nr #Q_LEAD_DIFF \\n#LEAD-\\n#\\*BQ_LEAD_REAL
-.    if !'\\n.z'FLOAT*DIV' \{\
-.       br
-.       nr #CALCULATE_ONLY 1
-.       nr #CURRENT_V_POS \\nnl+\\n#Q_DEPTH
-.       SHIM
-.       rr #CALCULATE_ONLY
-.       nr #Q_SPACE_EQ (\\n#SHIM/2)
-.       nr #TRAP \\n.t-1
+.    nr q-lead-diff \\n#Q_LEAD_DIFF
+.    if !\\npdfbx-running \{\
+.       if !'\\n.z'FLOAT*DIV' \{\
+.          br
+.          nr #CALCULATE_ONLY 1
+.          nr #CURRENT_V_POS \\nnl+\\n#Q_DEPTH
+.          SHIM
+.          rr #CALCULATE_ONLY
+.          nr #Q_SPACE_EQ (\\n#SHIM/2)
+.          nr #TRAP \\n.t-1
+.       \}
 .    \}
 .    if \\n#ENDNOTE \{\
 .       nr #RESET_QUOTE_SPACING \\n#FULLSPACE_QUOTES
@@ -12342,14 +12671,14 @@
 .       el \{\
 .          if !\\nnl=\\n#PAGE_TOP \{\
 .             ie \\n#Q_DEPTH<(\\n#TRAP_DISTANCE-1) \{\
-.                ie ((\\n#TRAP_DISTANCE-1)-\\n#Q_DEPTH)<\\n#DOC_LEAD \{\
-.                   ie !\\nin-cutaround .Q_NOFIT
-.                   el .Q_FITS
-.                \}
+.                ie ((\\n#TRAP_DISTANCE-1)-\\n#Q_DEPTH)<\\n#DOC_LEAD \
+.                   Q_NOFIT
 .                el \{\
-.                   ie (\\n#TRAP_DISTANCE-\\n#DOC_LEAD)<\\n#DOC_LEAD .Q_NOFIT
+.                   ie (\\n#TRAP_DISTANCE-\\n#DOC_LEAD)<\\n#DOC_LEAD \
+.                      Q_NOFIT
 .                   el \{\
-.                      ie (\\n#Q_DEPTH+\\n.v)=(\\n#TRAP_DISTANCE-1) .Q_NOFIT
+.                      ie (\\n#Q_DEPTH+\\n.v)=(\\n#TRAP_DISTANCE-1) \
+.                         Q_NOFIT
 .                      el .Q_FITS
 .                   \}
 .                \}
@@ -12396,16 +12725,17 @@
 .          in +\\n#EN_PP_INDENTu*\\n#\\*BQ_OFFSET_VALUEu
 .       el .in +\\*$\\*BQ_OFFSET_VALUE
 .    \}
-.    ie \\n#START=1 \{\
-.       ie !\\n#Q_LEAD_DIFF<0 \
-.          if !\\n#NO_SHIM .sp \\n#Q_SPACE_EQu
-.       el .RLD 0-\\n#Q_LEAD_DIFFu
-.    \}
+.    ie \\n#START=1 \
+.       RLD 0-\\n#Q_LEAD_DIFFu
 .    el \{\
-.       if \\n#PRINT_STYLE=2 \
-.          ie !\\n#NO_SHIM \
-.             sp \\n#Q_SPACE_EQu+(\\n#Q_LEAD_DIFFu/2u)
-.          el .if !\\n#NO_FLEX .FLEX
+.       if \\n#PRINT_STYLE=2 \{\
+.          ie !\\npdfbx-post-q \{\
+.             ie !\\n#NO_SHIM \
+.                sp \\n#Q_SPACE_EQu+(\\n#Q_LEAD_DIFFu/2u)
+.             el .if !\\n#NO_FLEX .FLEX
+.          \}
+.          el .sp -.5
+.       \}
 .    \}
 .    if \\n#QUOTE=1 \{\
 .       if !'\\*$Q_SPACE_ADJUST'' .sp +\\*$Q_SPACE_ADJUST
@@ -12426,43 +12756,42 @@
 .       \}
 .    \}
 .    if !\\n#START .rr #QUOTE
-.    if \\nin-cutaround .nr #PP_INDENT \\npp-ind-tmp
-\#.    if !\\nev-popped .ev \" Needed once cutarounds are implemented
 .    rr delay-ev-pop
-.    if \\nreset-ll \{\
-.       if '\\*cutaround-type'RIGHT' \{\
-.          ll \\n#DOC_L_LENGTHu
-.          rr reset-ll
-.       \}
-.    \}
 .    if !'\\n.z'FLOAT*DIV' \{\
-.       if \\n#PRINT_STYLE=1 \
+.       if \\n#PRINT_STYLE=1 \{\
 .          if !\\n.v=\\n#DOC_LEAD \{\
-.             ie !\\n#NO_SHIM .SHIM
-.             el \
-.                if !\\n#NO_FLEX .FLEX
+.             if !r pdfbx-post-q \{\
+.                ie !\\n#NO_SHIM .SHIM
+.                el \
+.                   if !\\n#NO_FLEX .FLEX
+.             \}
 .          \}
+.       \}
 .       if \\n#PRINT_STYLE=2 \{\
 .          ie \\n#START \{\
 .             ie \\n#PP_SPACE .
 .             el \{\
-.                sp \\n#DOC_LEADu
-.                ie !\\n#NO_SHIM .SHIM
-.                el \
-.                   if !\\n#NO_FLEX .FLEX
+.                sp \\n#DOC_LEADu/2u
+.                if !r pdfbx-post-q \{\
+.                   ie !\\n#NO_SHIM .SHIM
+.                   el \
+.                      if !\\n#NO_FLEX .FLEX
+.                \}
 .             \}
 .          \}
 .          el \{\
 .             ie \\n#HEAD=1 \{\
 .                sp \\n#DOC_LEADu
-.                ie !\\n#NO_SHIM .SHIM
-.                el \
-.                   if !\\n#NO_FLEX .FLEX
+.                if !r pdfbx-post-q \{\
+.                   ie !\\n#NO_SHIM .SHIM
+.                   el \
+.                      if !\\n#NO_FLEX .FLEX
+.                \}
 .             \}
 .             el \{\
 .                ie \\n#FULLSPACE_QUOTES \{\
 .                   ie \\n#ENDNOTE .ALD \\n#EN_LEADu
-.                   el !'\\n.z'FLOAT*DIV' .ALD \\n#DOC_LEADu
+.                   el .if !'\\n.z'FLOAT*DIV' .ALD \\n#DOC_LEADu
 .                \}
 .                el \
 .                   if !'\\n.z'FLOAT*DIV' .ALD \\n#DOC_LEADu/2u
@@ -12476,14 +12805,22 @@
 .                   \}
 .                   el \{\
 .                      ie !\\n#NO_SHIM .SHIM
-.                      el \
-.                         if !\\n#NO_FLEX .FLEX
+.                      el .if !\\n#NO_FLEX .FLEX
 .                   \}
 .                \}
 .                el \{\
-.                   ie !\\n#NO_SHIM .SHIM
-.                   el \
-.                      if !\\n#NO_FLEX .FLEX
+.                   ie r pdfbx-post-q \{\
+.                      if \\n.t>1v \{\
+.                      ie !\\n#NO_SHIM .SHIM
+.                      el \
+.                         if !\\n#NO_FLEX .FLEX
+.                      \}
+.                   \}
+.                   el \{\
+.                      ie !\\n#NO_SHIM .SHIM
+.                      el \
+.                         if !\\n#NO_FLEX .FLEX
+.                   \}
 .\" Make sure that Q_LEAD_DIFF is not added to the first line of
 .\" normal text at the top of any page following output of a quote
 .\" whose last line falls on B_MARGIN of the previous page.
@@ -12573,7 +12910,7 @@
 .\" grid (ie. on the first valid baseline of the page).
 .             ie \\n#Q_TOP=\\n#PAGE_TOP \{\
 .                if \\n#QUOTE=1 .ds $QUOTE_TYPE Q
-.                if \\n#QUOTE=2 .ds $QUOTE_TYPE B 
+.                if \\n#QUOTE=2 .ds $QUOTE_TYPE B
 .                rn \\*$QUOTE_TYPE_QUOTE Q_TEMP
 .                di \\*$QUOTE_TYPE_QUOTE
 .                nf
@@ -12603,7 +12940,7 @@
 .       ds quote-type quote
 .    \}
 .    if \\n#QUOTE=2 \{\
-.       ds $QUOTE_TYPE B 
+.       ds $QUOTE_TYPE B
 .       ds quote-type blockquote
 .    \}
 .    if \\nhas-caption \{\
@@ -12628,7 +12965,7 @@
 .          el .sp \\n#DOC_LEADu+\\n#Q_LEAD_DIFFu
 .       \}
 .       el \{\
-.          if '\\*$QUOTE_TYPE'Q' .sp \\n#DOC_LEADu
+.          sp .5
 .          if \\n@TOP .rs
 .       \}
 .       ie \\n#Q_LEAD_REAL \
@@ -12651,11 +12988,13 @@
 .\" are on.  The difference by which it's off is #Q_LEAD_DIFF
 .\" (the +\\n#Q_LEAD_DIFF at the end of the line, above).  Hack
 .\" solution: temporarily lower the FOOTER trap position.
-.       if !\\n#Q_DEPTH=0 \{\
-.          nr #SAVED_FOOTER_POS \\n#VARIABLE_FOOTER_POS
-.          ch FOOTER \\n#VARIABLE_FOOTER_POSu+.25v
-.       \}
-.    \}
+.   if !\\npdfbx-running \{\
+.      if !\\n#Q_DEPTH=0 \{\
+.         nr #SAVED_FOOTER_POS \\n#VARIABLE_FOOTER_POS
+.         ch FOOTER \\n#VARIABLE_FOOTER_POSu+.25v
+.      \}
+.   \}
+.\}
 .END
 \#
 \# ====================================================================
@@ -12672,9 +13011,16 @@
 \#   Default is on.
 \#
 .MAC PAGINATE END
-.    ie '\\$1'' .nr #PAGINATE 1
+.    ie '\\$1'' \{\
+.       nr #PAGINATE 1
+.       if \\n#SAVED_V_POS \{\
+.          nr #PAGE_NUM_V_POS \\n#SAVED_V_POS
+.          rr #SAVED_V_POS
+.       \}
+.    \}
 .    el \{\
 .      nr #PAGINATE 0
+.      nr #SAVED_V_POS \\n#PAGE_NUM_V_POS
 .      rr #PAGE_NUM_V_POS
 .    \}
 .    if \\n#HF_OFF=1 \{\
@@ -13411,6 +13757,7 @@
 .       if \\n#INDENT_FIRST_PARAS .nr #INDENT_FIRSTS 1
 .       INDENT_FIRST_PARAS
 .\" Prepare FOOTNOTE to receive footnote text.
+.       if \\n.hy .nr #RESTORE_HY_PARAMS \\n.hy
 .       ev FOOTNOTES
 .       ll \\n#DOC_L_LENGTHu
 .       ta \\n.lu
@@ -13459,6 +13806,7 @@
 .       \}
 .       el \{\
 .          ie \\n#RUN_ON \{\
+.             nh
 .             da RUNON_FOOTNOTES
 .             nr #RUNON_FOOTNOTES 1
 .          \}
@@ -13628,8 +13976,8 @@
 .                el \
 .                   ds $FN_LINENUMBER \
 \h'0+\\n#FN_INDENTu'\\n#FN_MARK\v'-.1m'-\v'.1m'\\n#FN_MARK_2\\*$FN_LN_SEP
-.                \}
 .             \}
+.          \}
 .          if !\\n#NO_FN_MARKER \
 .             PRINT \\*$FN_LINENUMBER\c
 .          rm $FN_LINENUMBER
@@ -13678,7 +14026,7 @@
 .\" Terminate FOOTNOTES or FN_IN_DIVER diversion
 .          di
 .          HY_SET 1 \\n#DIVERSIONS_HY_MARGINu (\\n#PT_SIZEu/1000u/8u)p
-.          hy 14
+.          if \\n#RESTORE_HY_PARAMS .hy \\n#RESTORE_HY_PARAMS
 .\" More housekeeping
 .\" Turn off indent possibly set by FOOTNOTE INDENT
 .          in 0
@@ -14028,7 +14376,7 @@
 \# outputting FOOTNOTES).  It checks for whether we have a "deferred
 \# footnote" situation, and resets counters and number registers
 \# accordingly.  Lastly, if we have some footnote overflow, it calls
-\# DIVERT_FN_OVERFLOW.
+\# DIVERT_FN_LEFTOVER.
 \#
 .MAC PROCESS_FN_LEFTOVER END
 .    if \\n#PREV_FN_DEFERRED=2 \
@@ -15148,23 +15496,12 @@
 \# *Argument:
 \#   <amount of space>
 \# *Function:
-\#   Gets value for #BIB_SPACE in units.
+\#   Gets value for $BIB_SPACE.
 \# *Notes:
 \#   Requires a unit of measure.
 \#
 .MAC BIBLIOGRAPHY_SPACING END
 .    ds $BIB_SPACE \\$1
-.    if \\n#BIB_LEAD=0 \{\
-.       nr #DEFER_BIB_SPACING 1
-.       return
-.    \}
-.    ds $EVAL_BIB_SPACE \\*$BIB_SPACE
-.    substring $EVAL_BIB_SPACE -1
-.    ie '\\*$EVAL_BIB_SPACE'v' \{\
-.       substring $BIB_SPACE 0 0
-.       nr #BIB_SPACE \\n#BIB_LEAD*\\*$BIB_SPACE
-.    \}
-.    el .nr #BIB_SPACE (\\$1)
 .END
 \#
 \# Bibliography (user space macro)
@@ -15182,9 +15519,9 @@
 .       rr #EN_REF
 .       nr #BIBLIOGRAPHY 1
 .       nr #BIB_FIRST_PAGE 1
-.       nr #SKIP_FOOTER +1
+\#.       nr #SKIP_FOOTER +1
 .       SETUP_BIBLIOGRAPHY
-.       nr #SKIP_FOOTER -1
+\#.       nr #SKIP_FOOTER -1
 .       if \\n#PRINT_STYLE=1 \{\
 .          ie \\n#SINGLE_SPACE=1 .vs \\n#BIB_LEADu
 .          el \{\
@@ -15232,6 +15569,24 @@
 .ds $TOC_PN_TYPEWRITE \\*ST102^\\*ST102X\\*ST103\
 \h'\w'0'u*\\n#TOC_PN_PADDINGu'\\*ST103X
 \#
+\# Macro to remove titles from the TOC.
+\# Primarily to remove the copyright page from the TOC.
+\#
+.MAC NO_TOC_ENTRY END
+.    nr #NO_TOC_ENTRY 1
+.END
+\#
+\# USER-INSERTED HEADING IN TOC
+\# ----------------------------
+\# *Arguments:
+\#   <text>
+\# *Function:
+\#   Inserts a single line of non-pagenumbered text into the TOC.
+\#
+.MAC TOC_HEADING END
+.    ds $TOC_HEADING \\$1
+.END
+\#
 \# TOC collector
 \#
 .MAC TO_TOC END
@@ -15239,7 +15594,7 @@
 .    nr #TOC_CH_NUM_INDENT \w'\\*$TOC_CH_NUM'
 .    da TOC_ENTRIES
 \!.  ie \\\\n#SKIP_ENTRY=1 \{\
-.     rr #SKIP_ENTRY
+.       rr #SKIP_ENTRY
 \!.  \}
 \!.  el \{\
 .       TQ
@@ -15274,6 +15629,7 @@
 .             \}
 .          \}
 .       \}
+\!.     vpt 0
 \!.     PAD_MARKER ^
 .       if !'\\$0'HD_TO_TOC' \{\
 \!.        if \\n#TOC_TITLE_CAPS=1 .CAPS
@@ -15282,7 +15638,6 @@
 .          nr #POST_TOP 1
 \!.        if \\n#TOC_HEAD_\\n#LEVEL_CAPS=1 .CAPS
 .       \}
-\!.     vpt 0
 .       ie '\\$0'HD_TO_TOC' \{\
 .          if \\n#PRINT_STYLE=1 \{\
 .             ds $TOC_HEAD_\\n#LEVEL_FAM \\*$TYPEWRITER_FAM
@@ -15296,14 +15651,47 @@
 "\\*PDFBOOKMARK.NAME"
 .       \}
 .       el \{\
-.          if \\n#PRINT_STYLE=1 \{\
-.             ds $TOC_TITLE_FAM \\*$TYPEWRITER_FAM
-.             ds $TOC_TITLE_FT  R
+.          ie '\\$0'HEADING_TO_TOC' \{\
+.             if \\n#PRINT_STYLE=1 \{\
+.                ds $TOC_TITLE_FAM \\*$TYPEWRITER_FAM
+.                ds $TOC_TITLE_FT R
+.             \}
+.             if !'\\*$TOC_HEADING_QUAD'' \{\
+.                substring $TOC_HEADING_QUAD 0 0
+.                if '\\*$TOC_HEADING_QUAD'L' \!.LEFT
+.                if '\\*$TOC_HEADING_QUAD'C' \!.CENTER
+.                if '\\*$TOC_HEADING_QUAD'R' \!.RIGHT
+.             \}
+\!.           vpt
+\!.           ne \\*$SPACE_ABOVE+\\*$SPACE_BENEATH+2v
+\!.           vpt 0
+.             if \\n#PRINT_STYLE=2 \
+.                if \\n#POST_TOP \!.sp \\*$SPACE_ABOVE
+.             ie \\n#PRINT_STYLE=1 \!.nop \\*$TOC_HEADING
+.             el \{\
+\!.              nop \
+\f\\*$TOC_HEADING_FAM\\*$TOC_HEADING_FT\
+\s\\*$TOC_HEADING_SIZE\
+\m\\*$TOC_HEADING_COLOR\
+\\*$TOC_HEADING\
+\m\s0\fP
+.             \}
+.             if \\n#PRINT_STYLE=2 \{\
+.                ie \\n#SPACE_TOC_ITEMS \
+.                   if \\n#POST_TOP=0 \!.sp \\*$SPACE_BENEATH
+.                el \!.sp \\*$SPACE_BENEATH
+.             \}
+\!.           vpt
+.             da
+.             ev
+.             return
 .          \}
-\!.        PAD \
+.          el \{\
+\!.           PAD \
 "\f\\*$TOC_TITLE_FAM\\*$TOC_TITLE_FT\
 \h'\\n#TOC_TITLE_INDENTu'\\*$TOC_TITLE_ITEM\\*$TOC_PN\\*_TYPEWRITE" \
 "\\*PDFBOOKMARK.NAME"
+.          \}
 .       \}
 .       ie '\\$0'HD_TO_TOC' \
 \!.        if \\n#TOC_HEAD_\\n#LEVEL_CAPS=1 .CAPS OFF
@@ -15325,13 +15713,14 @@
 \!.        ps \\*$TOC_PN_SIZE_CHANGE
 .       \}
 \!.     PRINT \\n#TOC_ENTRY_PN
-\!. \}
-.   da
-.   ev
+\!.  \}
+.    da
+.    ev
 .END
 .
 .ALIAS HD_TO_TOC    TO_TOC
 .ALIAS TITLE_TO_TOC TO_TOC
+.ALIAS HEADING_TO_TOC TO_TOC
 \#
 \# Control macros for toc
 \# ----------------------
@@ -15743,7 +16132,7 @@
 .    \}
 .    el .DOC_LEAD \\*$TOC_LEAD
 .    ie \\n#TOC_HEADER_V_POS \
-.      DOCHEADER OFF \\n#TOC_HEADER_V_POSu-\\n#DOC_LEADu 
+.      DOCHEADER OFF \\n#TOC_HEADER_V_POSu-\\n#DOC_LEADu
 .    el .DOCHEADER OFF \\n#T_MARGINu-\\n#DOC_LEADu
 .    if (\\n#PRINT_STYLE=1)&(\\n#SINGLE_SPACE=1) \
 .       DOCHEADER OFF \\n#T_MARGINu-(\\n#DOC_LEADu*2u)
@@ -15889,6 +16278,7 @@
 \#
 .MAC LIST END
 .    br
+.    if r pdfbx-top 'sp -1
 .    ds $1ST_LETTER \\$1
 .    if !'\\*$1ST_LETTER'' .substring $1ST_LETTER 0 0
 .    if '\\*$1ST_LETTER'r' .ds $1ST_LETTER R
@@ -16120,7 +16510,7 @@
 .       ie \\n#INDENT_ACTIVE=1 \{\
 .          if \\n#INDENT_STYLE_LEFT=1 \{\
 .             if \\n#L_INDENT_ILX \{\
-.                rr #L_INDENT 
+.                rr #L_INDENT
 .                rr #L_INDENT_ILX
 .             \}
 .             nr #L_INDENT \\n#L_INDENT+\\n#LIST_INDENT\\n#DEPTH
@@ -16165,7 +16555,7 @@
 .    ie \\n#NUM_ARGS=2 .sp \\$2
 .    el \
 .       if \B'\\$1' .sp \\$1
-.    if '\\*$ENUMERATOR_TYPE\\n#DEPTH'plain' .nop 
+.    if '\\*$ENUMERATOR_TYPE\\n#DEPTH'plain' .nop
 .    if !r#DEPTH .return
 .    if \\n#LINENUMBERS=1 \{\
 .       NUMBER_LINES OFF
@@ -16555,7 +16945,7 @@
 \# *Arguments:
 \#   none
 \# *Function:
-\#   Resets register enumerators to 1 or a.
+\#   Resets register enumerators to 1, a, i...
 \#
 .MAC RESET_LIST END
 .    ie '\\$1'' .nr #ENUMERATOR\\n#DEPTH 0 1
@@ -16571,78 +16961,82 @@
 \#   effect prior to LIST.
 \#
 .MAC QUIT_LISTS END
-.   br
-.   if '\\n.z'LIST*DIV' \{\
-\!.    rr #IN_LIST
-.      di
-.   \}
-.   IQ CLEAR
-.   nr #HL_INDENT \\n#STORED_HL_INDENT
-.   nr #T_INDENT  \\n#STORED_T_INDENT
-.   nr #L_INDENT  \\n#STORED_L_INDENT
-.   nr #R_INDENT \\n#STORED_R_INDENT
-.   nr #BL_INDENT \\n#STORED_BL_INDENT
-.   nr #BR_INDENT \\n#STORED_BR_INDENT
-.   rr #STORED_HL_INDENT
-.   if \\n#LIST_CENTER \
-.      nr #LIST_OFFSET_VALUE \\n.l-\\ndl/2
-.   if \\n#LIST_RIGHT \
-.      nr #LIST_OFFSET_VALUE \\n.l-\\ndl
-.   po +\\n#LIST_OFFSET_VALUEu
-.   if \\n.u .nr #FILLED 1
-.   nf
-.   if dLIST*DIV \{\
-.      LIST*DIV
-.      rm LIST*DIV
-.   \}
-.   if \\n#FILLED .fi
-.   if !\\n#PRE_LIST_QUAD=\\n.j .ad \\n#PRE_LIST_QUAD
-.   rr #FILLED
-.   po
-.   rr #PRE_LIST_QUAD
-.   if \\n#RESTORE_PREV_INDENT=1 \
-.      IL
-.   if \\n#RESTORE_PREV_INDENT=2 \{\
-.      ll \\n#ORIG_L_LENGTHu
-.      IB
-.   \}
-.   if \\n#RESTORE_PREV_INDENT=3 \{\
-.      ll \\n#ORIG_L_LENGTHu
-.      IR
-.   \}
-.   if \\n#RESTORE_PREV_INDENT=4 \{\
-.      nr #R_INDENT \\n#STORED_R_INDENT
-.      nr #L_INDENT \\n#STORED_L_INDENT
-.      ll \\n#ORIG_L_LENGTHu
-.      IR
-.      IL
-.   \}
+.    br
+.    if '\\n.z'LIST*DIV' \{\
+\!.     rr #IN_LIST
+.       di
+.    \}
+.    IQ CLEAR
+.    nr #HL_INDENT \\n#STORED_HL_INDENT
+.    nr #T_INDENT  \\n#STORED_T_INDENT
+.    nr #L_INDENT  \\n#STORED_L_INDENT
+.    nr #R_INDENT  \\n#STORED_R_INDENT
+.    nr #BL_INDENT \\n#STORED_BL_INDENT
+.    nr #BR_INDENT \\n#STORED_BR_INDENT
+.    rr #STORED_HL_INDENT
+.    if \\n#LIST_CENTER \
+.       nr #LIST_OFFSET_VALUE \\n.l-\\ndl/2
+.    if \\n#LIST_RIGHT \{\
+.       nr #LIST_OFFSET_VALUE \\n.l-\\ndl
+.       if r pdfbx-running \
+.          nr #LIST_OFFSET_VALUE \
+\\n.l-\\ndl-\\*gap\\nstack-(\\*wt\\nstack/2)
+.    \}
+.    po +\\n#LIST_OFFSET_VALUEu
+.    if \\n.u .nr #FILLED 1
+.    nf
+.    if dLIST*DIV \{\
+.       LIST*DIV
+.       rm LIST*DIV
+.    \}
+.    if \\n#FILLED .fi
+.    if !\\n#PRE_LIST_QUAD=\\n.j .ad \\n#PRE_LIST_QUAD
+.    rr #FILLED
+.    po
+.    rr #PRE_LIST_QUAD
+.    if \\n#RESTORE_PREV_INDENT=1 \
+.       IL
+.    if \\n#RESTORE_PREV_INDENT=2 \{\
+.       ll \\n#ORIG_L_LENGTHu
+.       IB
+.    \}
+.    if \\n#RESTORE_PREV_INDENT=3 \{\
+.       ll \\n#ORIG_L_LENGTHu
+.       IR
+.    \}
+.    if \\n#RESTORE_PREV_INDENT=4 \{\
+.       nr #R_INDENT \\n#STORED_R_INDENT
+.       nr #L_INDENT \\n#STORED_L_INDENT
+.       ll \\n#ORIG_L_LENGTHu
+.       IR
+.       IL
+.    \}
 .\" Clean up after exiting last depth of list
-.   nr #REMOVE 0 1
-.   while \\n+#REMOVE<=\\n#TOTAL_LISTS \{\
-.      rr #LIST_INDENT\\n#REMOVE
-.      rr #ENUMERATOR\\n#REMOVE
-.      rm $ENUMERATOR\\n#REMOVE
-.      rm $SEPARATOR\\n#REMOVE
-.      rm $ENUMERATOR_TYPE\\n#REMOVE
-.      rr #PAD_LIST_DIGITS\\n#REMOVE
-.      rr #SHIFT_LIST\\n#REMOVE
-.   \}
-.   rr #STORED_L_INDENT
-.   rr #STORED_BL_INDENT
-.   rr #STORED_BR_INDENT
-.   rr #STORED_R_INDENT
-.   rr #STORED_R_INDENT
-.   rr #REMOVE
-.   rr #TOTAL_LISTS
-.   rr #QUIT
-.   rr #DEPTH
-.   rr #NEXT_DEPTH_BACK
-.   rr #RESTORE_PREV_INDENT
-.   rr #ORIG_L_LENGTH
-.   rr #CURRENT_L_LENGTH
-.   rr #IN_ITEM
-.   rr #IN_ITEM_L_INDENT
+.    nr #REMOVE 0 1
+.    while \\n+#REMOVE<=\\n#TOTAL_LISTS \{\
+.       rr #LIST_INDENT\\n#REMOVE
+.       rr #ENUMERATOR\\n#REMOVE
+.       rm $ENUMERATOR\\n#REMOVE
+.       rm $SEPARATOR\\n#REMOVE
+.       rm $ENUMERATOR_TYPE\\n#REMOVE
+.       rr #PAD_LIST_DIGITS\\n#REMOVE
+.       rr #SHIFT_LIST\\n#REMOVE
+.    \}
+.    rr #STORED_L_INDENT
+.    rr #STORED_BL_INDENT
+.    rr #STORED_BR_INDENT
+.    rr #STORED_R_INDENT
+.    rr #STORED_R_INDENT
+.    rr #REMOVE
+.    rr #TOTAL_LISTS
+.    rr #QUIT
+.    rr #DEPTH
+.    rr #NEXT_DEPTH_BACK
+.    rr #RESTORE_PREV_INDENT
+.    rr #ORIG_L_LENGTH
+.    rr #CURRENT_L_LENGTH
+.    rr #IN_ITEM
+.    rr #IN_ITEM_L_INDENT
 .END
 \#
 \# SET LIST INDENT
@@ -16744,6 +17138,7 @@
 .    IQ CLEAR
 .    TQ
 .    LL \\n#DOC_L_LENGTHu
+.    PT_SIZE \\n#DOC_PT_SIZEu
 .    QUAD \\*$DOC_QUAD
 .    nr #SAVED_DOC_LEAD \\n#DOC_LEAD
 .    nr #COLLATED_DOC 1
@@ -16792,6 +17187,8 @@
 .    MISC
 .    rr #COVER_TITLE
 .    rr #DOC_COVER_TITLE
+.    rr #FROM_COVERTITLE
+.    rr #FROM_DOC_COVERTITLE
 .    rr #MISC
 .    rr #COVER_MISC
 .    rr #DOC_COVER_MISC
@@ -16817,7 +17214,7 @@
 .    \}
 .    nr #LOOP 0 1
 .    while \\n+#LOOP<=\\n@LEVEL \
-.       rr #TOC_HEAD_\\n#LOOP_INDENT_SET 1
+.       rr #TOC_HEAD_\\n#LOOP_INDENT_SET
 .    if \\n#FLEX_ACTIVE .rr #NO_FLEX
 .END
 \#
@@ -16831,7 +17228,6 @@
 \#   Begin, suspend/turn off, or resume numbering of output lines.
 \#
 .MAC NUMBER_LINES END
-.    br
 .    if '\\n.z'EPI_TEXT' .return
 .    if '\\$1'' \{\
 .       tm1 "mom: NUMBER_LINES at line \\n.c has no argument.
@@ -17016,6 +17412,7 @@
 .          nr #RESTORE_PN_V_POS \\n#PAGE_NUM_V_POS
 .          PAGINATION OFF
 .       \}
+.       if \\n#COLUMNS=1 .nr #COLUMNS +1
 .       NEWPAGE \" Break to blank page
 .       nop \&
 .       br
@@ -17030,9 +17427,9 @@
 .       \}
 .       if !'\\$1'DIVIDER' .if \\n#HEADERS_WERE_ON .HEADERS
 .    \}
-.    NEWPAGE
+.    if \\n#COLUMNS=2 .nr #COLUMNS -1
+.    NEWPAGE \" Break to text page
 .    ie '\\$1'DIVIDER' \{\
-.       nop \&
 .       if \\n#BLANKPAGE_AFTER_DEFER .bp
 .       if \\n#FOOTERS_WERE_ON .FOOTERS
 .          if \\n#RESTORE_PN_V_POS \{\
@@ -17053,22 +17450,25 @@
 .       \}
 .       if '\\$1'NULL' \{\
 .          if \\n#FOOTERS_WERE_ON .FOOTERS
+.          if \\n#RESTORE_PN_V_POS=2 \
+.             nr #PAGE_NUM_V_POS \\n#RESTORE_PN_V_POS
 .          if \\n#PAGE_NUM_V_POS=2 \
 .             if \\n#PAGINATE_WAS_ON .PAGINATE
+.          nr #PAGE_NUM_ADJ -\\n#HOW_MANY
 .       \}
 .    \}
 .    if \\n#PAGINATE=1 \
-.       if '\\$1'NULL' .nr #PAGE_NUM_ADJ -\\n#HOW_MANY
-.       if \\n#RESTORE_PN_V_POS=1 \{\
-.          RESTORE_SPACE
-.          sp |\\n#HEADER_MARGINu
-.          PRINT_PAGE_NUMBER
-.       \}
+.    if \\n#RESTORE_PN_V_POS=1 \{\
+.       RESTORE_SPACE
+.       sp |\\n#HEADER_MARGINu
+.       PRINT_PAGE_NUMBER
+.    \}
 .    if \\n#LINENUMBERS_WERE_ON .NUMBER_LINES RESUME
 .    rr #HOW_MANY
 .    rr #HEADERS_WERE_ON
 .    rr #FOOTERS_WERE_ON
 .    rr #PAGINATE_WAS_ON
+.    rr #RESTORE_PN_V_POS
 .END
 \#
 \# FLOATS
@@ -17089,6 +17489,11 @@
 .    if !\\ntbl*no-top-hook .tbl@top-hook
 .    rr tbl*no-top-hook
 .    sp |\\n#T_MARGINu-\\n#DOC_LEADu
+.    if r pdfbx-defer \{\
+.       nr lead-diff \\n#LEAD_AT_FOOTER-\\n.v
+.       sp |\\ntu-\\n.vu+\\nlead-diffu
+.       rr pdfbx-defer
+.    \}
 .    nr defer-count \\ndefer
 .    nr #TMP_PAGE_OFFSET \\n.o
 .    po \\n#L_MARGINu
@@ -17117,7 +17522,7 @@
 .       rr pic*top-lead-diff
 .       rr float*pic
 .    \}
-.    if \\nfloat*img \{\
+.    if \\nfloat*img:1 \{\
 .       ie \\n#COLUMNS \
 .          sp |\\ndcu
 .       el \
@@ -17127,6 +17532,7 @@
 .          rr pdf-img:frame
 .       \}
 .    \}
+.    if \\ndefers .rr defers
 .    nr loop-count  0 1
 .    nr new-defer   0 1
 .    while \\n+loop-count<=\\ndefer-count \{\
@@ -17144,24 +17550,31 @@
 .          ch FN_OVERFLOW_TRAP -\\n#FN_OVERFLOW_TRAP_POSu
 .       \}
 .       ie !\\nfloat-span:\\nloop-count \{\
-.          ie ((\\nfloat-depth:\\nloop-count-\\n.v)>\\n.t):(\\nD-float:\\nloop-count>\\n.t) \{\
+.          ie ((\\nfloat-depth:\\nloop-count-\\n.v)>\\n.t):(\\nD-float:\\nloop-count>\\n.t):(\\ndefers=1) \{\
 .\" Insufficient space, defer to next page
+.             nr defers 1
 .             rn FLOAT*DIV:\\nloop-count NEW*FLOAT*DIV:\\n+new-defer
 .             rnn float-depth:\\nloop-count new-float-depth:\\nnew-defer
 .             rnn D-float:\\nloop-count new-D-float:\\nnew-defer
 .          \}
 .          el \{\
 .             output-float
-.             ie (\\n.t-1)<(\\n#DOC_LEADu/2) .SHIM_1
-.             el .sp .5
+.             ie !r pdfboxed \{\
+.                ie (\\n.t-2)<(\\n#DOC_LEADu/2) .SHIM_1
+.                el .sp .5
+.             \}
+.             el .rr pdfboxed
 .          \}
 .       \}
 .       el \{\
 .          rr tbl*no-top-hook
 .          if \\nfloat-span:\\nloop-count \
 .             rn tbl*header-div:\\nloop-count tbl*header-div:span
-.          output-float
-.          sp .5
+.          ie !r pdfboxed \{\
+.             output-float
+.             sp .5
+.          \}
+.          el .rr pdfboxed
 .       \}
 .       if !\\nloop-count=\\ndefer-count .rr flexed
 .       rr float-span:\\nloop-count
@@ -17196,11 +17609,11 @@
 .    rr #TMP_PAGE_OFFSET
 .    ch FOOTER \\n#VARIABLE_FOOTER_POSu
 .    ch FN_OVERFLOW_TRAP -\\n#FN_OVERFLOW_TRAP_POSu
-.    if !\\n.t=1 .if \\n.t<\\n.v .bp
+.    if \\nfloat-depth:1>\\n.t .bp
 .    ie !\\n#NO_SHIM .SHIM
 .    el \{\
 .       if !\\n#NO_FLEX \
-.          if !\\nflexed .FLEX 
+.          if !\\nflexed .FLEX
 .    \}
 .    if !\\n#NO_SHIM \
 .       if \\n#SHIM>(\\n#DOC_LEAD-(\\n#DOC_LEAD/4)) \
@@ -17235,7 +17648,7 @@
 \#
 .MAC output-float END
 .    if \\nfloat*img \{\
-.       nr no-top-space:1 1
+.       if \\nloop-count=1 .nr no-top-space:1 1
 .    \}
 .    vpt 0
 .    if \\n.ns \{\
@@ -17250,7 +17663,7 @@
 .       \}
 .       el .sp |\\ndcu
 .       if \\nfloat*tbl:1 \{\
-.          RESTORE_SPACE
+.          if !\\nno-top-space:1 .RESTORE_SPACE
 .          ie \\ntbl*caption-top-lead-diff \{\
 .             sp \\ntbl*caption-top-lead-diffu
 .             rr tbl*caption-top-lead-diff
@@ -17267,7 +17680,6 @@
 .          RESTORE_SPACE
 .          if \\npdf-img*caption-top-lead-diff \{\
 .             sp \\npdf-img*caption-top-lead-diffu
-.             rr float*img:1
 .             rr pdf-img*caption-top-lead-diff
 .          \}
 .       \}
@@ -17283,6 +17695,7 @@
 .    nf
 .    if \\nq-float \
 .       if !\\nhas-caption .sp \\n#Q_LEAD_DIFFu
+.       if \\nQ-float=2 .sp |\\ntu-.5v
 .    ns
 .    vpt
 .    if \\ncheck-indent \{\
@@ -17308,11 +17721,19 @@
 .       rm float-adj:\\nloop-count
 .       rr restore-v-pos
 .    \}
+.    if r float*img:1 \{\
+.       sp .5
+.       rr float*img:1
+.    \}
+.    if r Q-float:1 \{\
+.       if !\\n#FULLSPACE_QUOTES .sp -.5
+.       rr Q-float:1
+.    \}
 .    if \\n#COLUMNS \
-.       if !'\\*pic*space-adj:\\nloop-count'' .sp -\\*pic*space-adj:\\nloop-count
+.       if !'\\*pic*space-adj:\\nloop-count'' \
+.          sp -\\*pic*space-adj:\\nloop-count
 .    rm pic*space-adj:\\nloop-count
-.    if \\nD-float:1 \
-.       rr D-float:1
+.    if \\nD-float:1 .rr D-float:1
 .    rr D-float
 .    rr @no-shim
 .    rr q-float
@@ -17333,7 +17754,9 @@
 \#   the diversion within the space allotted.  FORCE breaks to
 \#   a new page immediately.
 \#
+\#
 .MAC FLOAT END
+.    nr ll-pre-float \\n.l
 .    if \\n#NUM_ARGS>0 \{\
 .       nr loop-count 0 1
 .       nr loop-counter \\n#NUM_ARGS
@@ -17431,6 +17854,7 @@
 .       ds ev-pre-float \\n.ev
 .       ev FLOAT
 .       evc \\*ev-pre-float
+.       if \\n.u .nr fill-pre-float 1 \" Needed for tbl
 .       di FLOAT*DIV
 .       if !'\\*float*target'' .PDF_TARGET "\\*float*target
 .       rm float*target
@@ -17534,6 +17958,7 @@
 .                nr no-top-space:\\ndefer 1
 .             \}
 .             if \\nD-float .nr D-float:\\ndefer \\nD-float
+.             if \\nQ-float .nr Q-float:\\ndefer \\n#Q-float
 .             nr float-depth:\\ndefer \\ndn
 .             if \\n#FORCE \{\
 .                ie \\n#COLUMNS .COL_NEXT
@@ -17589,7 +18014,7 @@
 .       if !'\\n.ev'protect' \{\
 .          ev protect
 .          evc FLOAT
-'           nf
+'          nf
 .       \}
 .       if \\nfloat*tbl \{\
 .          if \\ntbl*boxed \
@@ -17619,8 +18044,7 @@
 .             el \{\
 .                if \\ndn-save=\\nbx-tbl-depth .sp .35v
 .                rr dn-save
-.                ie \\ntbl*plain-boxed .sp .5v
-.                el \{\
+.                if !\\ntbl*plain-boxed \{\
 .                   if !\\ntbl*autolabel \{\
 .                      if !\\n#MLA \{\
 .                        if \\ntbl@label=1 .sp .5
@@ -17666,6 +18090,10 @@
 .       if !'\\*float-adj'' \
 .          if !\\nno-adjust .sp -\\*float-adj
 .       vpt
+.       if \\nQ-float \{\
+.          sp .5
+.          rr Q-float
+.       \}
 .       if !\\n#NO_SHIM \
 .          if !\\n@no-shim .SHIM
 .       rm float-adj
@@ -17687,6 +18115,7 @@
 .       if \\n#NO_SHIM \
 .          if !\\n#NO_FLEX .nr post-float 1
 .       ev \\*ev-pre-float
+.       rr fill-pre-float
 .       rm ev-pre-float
 .    \}
 .END
@@ -17902,7 +18331,8 @@
 \#
 \# Set up a default papersize of US letter
 \#
-.PAPER LETTER
+.PAGEWIDTH 8.5i
+.PAGELENGTH 11i
 \#
 \# ====================================================================
 \#
@@ -18657,7 +19087,7 @@
 .             if '\\*pdf-img:pos'-I' \{\
 .                ll \\npdf-img:indu+\\npdf-img:widthu+(\\npdf-img:frame-insetu*2u)
 .                in \\npdf-img:indu
-.             \}   
+.             \}
 .          \}
 .       \}
 .    \}
@@ -18666,7 +19096,7 @@
 .          ie \\npic*left .ll \\npic*div-widthu
 .          el \{\
 .             ll \\npic*div-widthu
-\!.           in \\nll-pre-picu-\\npic*div-widthu/2u
+.                in (\\nll-pre-floatu-\\npic*div-widthu)/2u
 .          \}
 .       \}
 .    \}
@@ -18747,10 +19177,13 @@
 .    if '\\*spec-type'cap' .ds spec-type caption
 .    if '\\*spec-type'lab' .ds spec-type label
 .    if '\\*spec-type'sou' .ds spec-type source
+.    ie \\n#PRINT_STYLE=1 .TYPEWRITER
+.    el \{\
 '    fam \\*\\*label-type*\\*spec-type-family
-'    ft \\*\\*label-type*\\*spec-type-font
-'    ps \\n#DOC_PT_SIZEu\\*\\*label-type*\\*spec-type-size-change
-.    COLOR \\*\\*label-type*\\*spec-type-color
+'       ft \\*\\*label-type*\\*spec-type-font
+'       ps \\n#DOC_PT_SIZEu\\*\\*label-type*\\*spec-type-size-change
+.       \m\\*\\*label-type*\\*spec-type-color
+.    \}
 .END
 \#
 .ALIAS tbl*caption-style style
@@ -18784,7 +19217,7 @@
 \# *Notes:
 \#   SIZE is relative to running text.
 \#   QUAD optional arg says quad on full line length rather than
-\#    pdf-img or pre-processor output.  
+\#    pdf-img or pre-processor output.
 \#
 .MAC CAPTION_LABEL_SPECS END
 .    if '\\$0'CAPTIONS' .ds spec-type caption
@@ -18871,7 +19304,7 @@
 .             ds \\*label-type*\\*spec-type-quad \\$1
 .             substring \\*label-type*\\*spec-type-quad 0 0
 .             if \\n\\*label-type*\\*spec-type-quad-on-ll \
-.                rr \\*label-type*\\*spec-type-quad-on-ll 
+.                rr \\*label-type*\\*spec-type-quad-on-ll
 .             if '\\$2'ON_LL' \
 .                nr \\*label-type*\\*spec-type-quad-on-ll 1
 .          \}
@@ -19357,7 +19790,7 @@
 \# *Notes:
 \#   Used to set autolabel number when manual labelling of floats
 \#   (in conjunction with TO_LIST) disrupts auto-incrementing.
-\#   
+\#
 .MAC SET_AUTOLABEL END
 .    rm labelnum-type
 .    if '\\$1'FIG' .ds labelnum-type fig
@@ -19916,6 +20349,11 @@
 .MAC TS END
 .    if \\n.t<\\n#DOC_LEAD .nr begin-tbl 1
 .    br
+.    rr tbl*pdfbx
+.    if r pdfbx-top \{\
+.       rt
+.       sp (\\*wt\\nstack/2u)+\\*gap\\nstacku
+.    \}
 .    rr begin-tbl
 .    rm tbl*caption
 .    rm tbl*label
@@ -19929,14 +20367,11 @@
 .    nr lead-pre-tbl \\n.v
 .    nr tbl*needs 1
 .    nr doing-tbl 1
-.    if !'\\n.z'FLOAT*DIV' \{\
-.       if \\n.u .nr fill 1
-.       nf
-.    \}
+.    nf
 .    if '\\n.z'FLOAT*DIV' .nr float*tbl 1
 .    if !'\\n.z'FLOAT*DIV' \{\
 .       if \\n.t=1 \{\
-.          if !\\n@TOP \{\
+.          if (\\n@TOP=0)&(\\n#START=0) \{\
 .             ie \\n#COLUMNS .COL_NEXT internal
 .             el .NEWPAGE
 .          \}
@@ -19944,73 +20379,85 @@
 .    \}
 .    nr loop-count 0 1
 .    nr loop-counter \\n#NUM_ARGS
-.    while \\n+loop-count<=\\nloop-counter \{\
+.    ie \\n#NUM_ARGS=1 \{\
 .       if '\\$1'H' \{\
-.          nr tbl*have-header 1
-.          shift
-.          if \\n#NUM_ARGS=0 .nr tbl*plain 1
-.       \}
-.       if '\\$1'BOXED' \{\
-.          nr tbl*boxed 1
-.          shift
+.         nr tbl*have-header 1
+.         nr tbl*plain 1
 .       \}
-.       if '\\$1'CENTER' \{\
-.          if \\n#INDENT_BOTH_ACTIVE \{\
-.             IBX
-.             nr #RESTORE_INDENT_BOTH 1
+.    \}
+.    el \{\
+.       while \\n+loop-count<=\\nloop-counter \{\
+.          if '\\$1'H' \{\
+.             nr tbl*have-header 1
+.             shift
 .          \}
-.          nr tbl*center 1
-.          shift
-.       \}
-.       if '\\$1'CENTRE' \{\
-.          if \\n#INDENT_BOTH_ACTIVE \{\
-.             IBX
-.             nr #RESTORE_INDENT_BOTH 1
+.          if '\\$1'BOXED' \{\
+.             nr tbl*boxed 1
+.             shift
+.          \}
+.          if '\\$1'CENTER' \{\
+.             if \\n#INDENT_BOTH_ACTIVE \{\
+.                IBX
+.                nr #RESTORE_INDENT_BOTH 1
+.             \}
+.             nr tbl*center 1
+.             shift
+.          \}
+.          if '\\$1'CENTRE' \{\
+.             if \\n#INDENT_BOTH_ACTIVE \{\
+.                IBX
+.                nr #RESTORE_INDENT_BOTH 1
+.             \}
+.             nr tbl*center 1
+.             shift
+.          \}
+.          if '\\$1'NEEDS' \{\
+.             nr tbl*needs \\$2
+.             shift 2
+.          \}
+.          if '\\$1'NO_SHIM' \{\
+.             nr tbl*no-shim 1
+.             shift
+.          \}
+.          if '\\$1'NO_FLEX' \{\
+.             nr tbl*no-flex 1
+.             shift
+.          \}
+.          if '\\$1'ADJUST' \{\
+.             ds tbl*space-adj \\$2
+.             shift 2
+.          \}
+.          if '\\$1'CAPTION' \{\
+.             nr tbl*have-caption 1
+.             ds tbl*caption \\$2
+.             shift 2
+.          \}
+.          if '\\$1'SHORT_CAPTION' \{\
+.             ds tbl*caption-short \\$2
+.             shift 2
+.          \}
+.          if '\\$1'LABEL' \{\
+.             nr tbl*have-label 1
+.             ds tbl*label \\$2
+.             shift 2
+.          \}
+.          if '\\$1'TARGET' \{\
+.             ds target "\\$2
+.             PDF_TARGET "\\*target
+.             shift 2
 .          \}
-.          nr tbl*center 1
-.          shift
-.       \}
-.       if '\\$1'NEEDS' \{\
-.          nr tbl*needs \\$2
-.          shift 2
-.       \}
-.       if '\\$1'NO_SHIM' \{\
-.          nr tbl*no-shim 1
-.          shift
-.       \}
-.       if '\\$1'NO_FLEX' \{\
-.          nr tbl*no-flex 1
-.          shift
-.       \}
-.       if '\\$1'ADJUST' \{\
-.          ds tbl*space-adj \\$2
-.          shift 2
-.       \}
-.       if '\\$1'CAPTION' \{\
-.          nr tbl*have-caption 1
-.          ds tbl*caption \\$2
-.          shift 2
-.       \}
-.       if '\\$1'SHORT_CAPTION' \{\
-.          ds tbl*caption-short \\$2
-.          shift 2
-.       \}
-.       if '\\$1'LABEL' \{\
-.          nr tbl*have-label 1
-.          ds tbl*label \\$2
-.          shift 2
-.       \}
-.       if '\\$1'TARGET' \{\
-.          ds target "\\$2
-.          PDF_TARGET "\\*target
-.          shift 2
 .       \}
 .    \}
+.    if (\\ntbl*have-caption=0):(\\ntbl*caption-after-label=1) \{\
+.       rr pdfbx-top
+.       if \\ntbl*boxed .sp -1p
+.    \}
+.    if \\ntbl*have-header .nr tbl*needs +1
 .    if (\\ntbl*have-label=1):(\\ntbl*autolabel=1) \
 .       ds label-type tbl
 .    if (\\ntbl*have-caption=1)&(\\ntbl*have-header=0) \
 .       tbl*caption-warning
-.    if \\ntbl*boxed=1 \{\
+.    if \\ntbl*boxed \{\
 .       if (\\ntbl*have-label=0)&(\\ntbl*have-caption=0)&\
 (\\ntbl*autolabel=0)&(\\ntbl*have-source=0) \
 .       nr tbl*plain-boxed 1
@@ -20063,8 +20510,10 @@
 .      \}
 .    \}
 .    if \\nnl=\\n#PAGE_TOP .ns
-.    if '\\n.z'FLOAT*DIV' \
-.       if \\ndefer>0 .sp .5v
+.    if '\\n.z'FLOAT*DIV' \{\
+.       ie \\ndefer>0 .sp .5v
+.       el .sp .25v
+.    \}
 .    if \\n@TOP .rr @TOP
 .    ds ev-current \\n.ev
 .    if (\\nnl=\\n#PAGE_TOP):(\\nnl=\\ndc) \
@@ -20077,6 +20526,7 @@
 .          if (\\ntbl*caption-after-label=1):(\\ntbl*have-caption=0) \
 .             sp 1n
 .    \}
+.    fi
 .    if \\ntbl*have-header \{\
 .       di tbl*header-div
 .       ev table-header
@@ -20173,9 +20623,10 @@
 .             \}
 .             rr tbl@needs
 .          \}
-.          if (\\ntbl*have-caption=1)&(\\ntbl*caption-after-label=0) \
+.          if (\\ntbl*have-caption=1)&(\\ntbl*caption-after-label=0) \{\
 .             TBL*CAPTION
-.          vs
+.             vs
+.          \}
 .          tbl*print-header
 .       \}
 .    \}
@@ -20201,6 +20652,11 @@
 .END
 \#
 .MAC TE END
+.    if !r TW \{\
+.       tm1 "mom: '\\n.F' contains tbl(1) data but '-t' flag is missing from
+.       tm1 "        the command line.
+.       ab Aborting.
+.    \}
 .    ev tbl*end \" Needed because of .ad changes
 .    evc \\*ev-current 
 .    nh
@@ -20220,8 +20676,6 @@
 .    \}
 .    if (\\n#MLA=1)&(\\ntbl*have-source=0) .tbl*source-warning
 .    if !'\\n.z'FLOAT*DIV' \{\
-.       ch FOOTER \\n#VARIABLE_FOOTER_POSu
-.       ch FN_OVERFLOW_TRAP -\\n#FN_OVERFLOW_TRAP_POSu
 .       if \\n.t<(\\n.v/2u) \{\
 .          ie (\\ntbl*have-label=1):\
 (\\ntbl*caption-after-label=1):\
@@ -20251,6 +20705,7 @@
 .\" finishes without room for further input at bottom of page
 .             rm tbl*header-div
 .             nr tbl*no-print-header 1
+.             nr tbl*no-top-hook 1
 .             ie \\n#COLUMNS \
 .                COL_NEXT internal
 .             el .NEWPAGE
@@ -20277,10 +20732,10 @@
 .             if !'\\*tbl*label-space'' .sp \\*tbl*label-space
 .             ie \\ntbl*autolabel \{\
 .                ie !\\ntbl*caption-after-label .nop \
-\\*tbl*label-prfx\\*chapno\\ntbl*label-num\\*tbl*label-sffx
+\\*tbl*label
 .                el \{\
 .                   nop \
-\\*tbl*label-prfx\\*chapno\\n+tbl*label-num\\*tbl*label-sffx\|
+\\*tbl*label\|
 .                   tbl*caption-style
 .                   vs \\n.psu+\\ntbl*caption-autoleadu
 .                   ds tbl*caption-old \\*tbl*caption
@@ -20371,8 +20826,8 @@
 .    ev
 .    if !\\ntbl*plain \{\
 .       ie \\ntbl*plain-boxed \{\
-.          ie \\n#MLA .if !\\ntbl*have-source .sp .5v
-.          el .sp .5v
+.          ie \\n#MLA .if !\\ntbl*have-source .sp .6v
+.          el .sp
 .       \}
 .       el \{\
 .          if !\\ntbl*have-source \{\
@@ -20390,19 +20845,27 @@
 .    if !'\\*tbl*space-adj'' .sp -\\*tbl*space-adju
 .    if \\n#MLA \
 .       sp .5v
-.    ie !\\ntbl*no-shim \{\
-.       ie !\\n#NO_SHIM \
-.          if !'\\n.z'FLOAT*DIV' .SHIM
+.    if !r pdfbx-running \{\
+.       ie !\\ntbl*no-shim \{\
+.           ie !\\n#NO_SHIM \
+.             if !'\\n.z'FLOAT*DIV' .SHIM
+.          el \
+.             if !\\ntbl*no-flex \
+.                if !\\n#NO_FLEX \
+.                   if !'\\n.z'FLOAT*DIV' .FLEX
+.       \}
 .       el \
 .          if !\\ntbl*no-flex \
 .             if !\\n#NO_FLEX \
 .                if !'\\n.z'FLOAT*DIV' .FLEX
 .    \}
-.    el \
-.       if !\\ntbl*no-flex \
-.          if !\\n#NO_FLEX \
-.             if !'\\n.z'FLOAT*DIV' .FLEX
+.    ie \\ntbl*boxed \{\
+.       nr tbl*pdfbx 2
+.       if \\ntbl*have-label .nr tbl*pdfbx 3
+.    \}
+.    el .nr tbl*pdfbx 1
 .    TBL*CLEANUP
+.    it 2 rr-tbl*pdfbx
 .END
 \#
 \# Utility macros for tbl
@@ -20416,7 +20879,8 @@
 .    nr tbl*caption-top-lead-diff \\ntbl*caption-lead-diff
 .    ie !\\n#MLA \{\
 .       if \\ntbl*have-caption \{\
-.          ie !'\\n.z'FLOAT*DIV' \{\
+.\" Get rid of these guys when you're sure you don't need them.
+\#.          if !'\\n.z'FLOAT*DIV' \{\
 .             if !\\ntbl*caption-after-label \{\
 .                ie (\\nnl=\\n#PAGE_TOP):(\\nnl=\\ndc) \{\
 .                   RESTORE_SPACE
@@ -20426,10 +20890,19 @@
 .                 \}
 .                 el \{\
 .                    if \\n.ns .if !(\\nnl=\\n#PAGE_TOP) .rs
-.                    sp \\n#DOC_LEADu/2u
+.                    if !\\npdfbx-top .sp \\n#DOC_LEADu/2u
+.                 \}
+.                 if \\npdfbx-top \{\
+.                    ps \\*tbl*caption-size-change
+.                    SIZESPECS
+.                    ps
+.                    nr pdfbx-top 1 \" SIZESPECS trips rr-pdfbx-top
+.                    rt
+.                    sp \\*gap\\nstacku+\\*wt\\nstack\
++\\ntbl*caption-top-lead-diffu+\\*$CAP_HEIGHT+.5p
 .                 \}
 .             \}
-.          \}
+\#.          \}
 .          nh
 .       \}
 .    \}
@@ -20498,10 +20971,9 @@
 .             sp \\*tbl*caption-space
 .          if \\ntbl*caption-lead-diff-adj \{\
 .             sp -\\ntbl*caption-lead-diffu
-.             rr tbl*label-lead-diff-adj
+.             rr tbl*caption-lead-diff-adj
 .          \}
-.          if \\nfill .fi
-.          rr fill
+.          if \\nfill-pre-float .fi
 .       \}
 .       el \{\
 .          if (\\ntbl*have-label=0) \{\
@@ -20539,7 +21011,14 @@
 .          \}
 .          if \\ntbl*label-with-chapter \
 .             ds chapno \\n#CH_NUM.
+.          if r pdfbx-top \
+.             if \\n#MLA .nr pdfbx-mla-tbl-top 1
 .          TBL*SET_LABEL_QUAD \\*tbl*label-quad
+.          if \\npdfbx-mla-tbl-top \{\
+.             sp
+.             sp \\ntbl*label-lead-diffu
+.             rr pdfbx-mla-tbl-top
+.          \}
 .          di tbl*mla-label-caption
 \!.        in 0
 .          ie \\ntbl*autolabel \{\
@@ -20646,8 +21125,8 @@
 .    \}
 .    br
 .    if !'\\*tbl*caption-space'' .sp \\*tbl*caption-space
-\!.  if \\\\nfloat*tbl .ev FLOAT
-.    ev \\*ev-current
+.    ie \\nfloat*tbl .ev FLOAT
+.    el .ev \\*ev-current
 .END
 \#
 .MAC TBL*CLEANUP END
@@ -20747,10 +21226,6 @@
 .    if '\\n.z'FLOAT*DIV' \
 .       if \\ntbl*center .ce 1000
 .    mk #T
-.    if !'\\n.z'FLOAT*DIV' \{\
-.       ch FOOTER \\n#VARIABLE_FOOTER_POSu+\\n#DOC_LEADu
-.       ch FN_OVERFLOW_TRAP -\\n#FN_OVERFLOW_TRAP_POSu+\\n#DOC_LEADu
-.    \}
 .END
 \#
 .MAC tbl@bottom-hook END
@@ -20809,10 +21284,10 @@
 .       if !\\npgnum .nr pgnum \\n%+\\n#PAGE_NUM_ADJ
 .       br
 .       if \\n.u .nr fill 1
-.       na
 .       rr float*eqn
 .       if '\\n.z'FLOAT*DIV' .nr float*eqn 1
 .       nr eqn*restore-adj \\n.j
+.       na
 .       if !\\ncontinued \{\
 .          PDF_TARGET eqn:\\n+lists*target
 .          rr eqn*type
@@ -20971,11 +21446,15 @@
 .          if '\\*DD'' \{\
 .             ds DD .5v
 .             if !\\n@TOP \{\
-.                sp \\*DD
+.                ie r pdfbx-top \{\
+.                   SIZESPECS
+.                   rt
+.                   sp (\\*wt\\nstack/2u)+\\*gap\\nstacku+\\*$CAP_HEIGHT
+.                \}
+.                el .sp \\*DD
 .                if !'\\*eqn*space-adj'' .sp \\*eqn*space-adju
 .             \}
 .          \}
-.          if \\ncutaround .ll \\neqn*cutaround-widthu
 .          ie \\neqn*type=1 \{\
 .             ta (u;\\n.l-\\n.i)R
 .             ie \\ncontinued .nop \\*eqn*div
@@ -20997,7 +21476,6 @@
 \v'-\\*eqn*shift-label'\
 \\*revert-specs
 .             \}
-.             if \\neqn-cutaround .ll
 .             if !\\ncontinued \{\
 .                if \\neqn*have-caption \
 .                   ADD_CAPTION
@@ -21119,9 +21597,16 @@
 .\" if continuing (ie is a multi-line equation), don't space and SHIM
 .       if !\\ncontinued \{\
 .          br
-.          if !\\n@TOP \
-.             if !\\n.t<(\\*DD+1) \
+.          if !\\n@TOP \{\
+.             if !\\n.t<(\\*DD+1) \{\
 .                sp \\*DD
+.                ie !\\neqn*have-caption \{\
+.                   sp .25v
+.                   if \\npdfbx-running .nr eqn*pdfbx 1
+.                \}
+.                el .if \\npdfbx-running .nr eqn*pdfbx 2
+.             \}
+.          \}
 .          if !'\\*eqn*space-adj'' .sp -\\*eqn*space-adju
 .          ie !\\neqn*no-shim \{\
 .             ie !\\n#NO_SHIM \
@@ -21151,7 +21636,6 @@
 .       rr eqn@ind*cont
 .       rr eqn*left
 .       rr eqn@left*cont
-.       if !\\neqn-cutaround .rm eqn*space-adj
 .    \}
 .    nr eqn*copy-in 1
 .    ad \\neqn*restore-adj
@@ -21276,18 +21760,25 @@
 \# Main macros
 \#
 .MAC PS END
+.    if \\npdfbx-running \{\
+.       ie !r pdfbx-top .nr pic*pdfbx 2
+.       el .nr pic*pdfbx 1
+.    \}
 .    if !\\n#PP .nop
 .    br
 .    have-adjust \\$@ \" Adjusting is handled by FLOAT
-.    if !'\\n.z'FLOAT*DIV' .FLOAT ADJUST \\*pic*space-adj
+.    if !'\\n.z'FLOAT*DIV' \
+.       FLOAT ADJUST \\*pic*space-adj
 .    PDF_TARGET fig:\\n+lists*target
 .    ds ev-current \\n.ev
 .    rr float*pic
+.    rr pic*have-label
+.    rr grap
 .    nr float*pic 1
 .    nr ind-pre-pic  \\n.i
-.    nr ll-pre-pic   \\n.l
 .    nr lead-pre-pic \\n.v
-.    if \\n#MLA .sp .5v
+.    if \\n#MLA \
+.       if !\\npdfbx-running .sp .5v
 .    in 0
 .    ev PIC
 .    evc \\nev-current
@@ -21433,16 +21924,46 @@
 \!.     in -\\nind-pre-picu
 .       sp \\npic*caption-lead-diffu
 \!.     if \\\\n.ns .rs
+.       if \\npic*pdfbx=1 \{\
+.          SIZESPECS
+.          if \\nPIC=1 \!.rt
+.          if \\nPIC=2 .rt
+.          sp \\npic*caption-lead-diffu
+.          sp \\*wt\\nstack+\\*gap\\nstacku+\\*$CAP_HEIGHT
+.          nr pic*pdfbx 2
+.       \}
 .       nop \\*pic*caption
-.       if \\n#PRINT_STYLE=1 .sp .5v
+.       if \\n#PRINT_STYLE=1 .sp .5
 .       if !'\\*pic*caption-space'' \
-.          sp \\*pic*caption-space
+.          sp \\*pic*caption-space-\\npic*text-autoleadp
 .       br
-.       if \\ngrap \!.sp -2v
 .       ev
 .    \}
-.    if !\\npic*left \!.in \\nll-pre-picu-\\npic*div-widthu/2u
-.    if (\\ngrap=1)&(\\npic*caption-after-label=1) \!.sp -2
+.    if \\npic*pdfbx=1 \{\
+.       if (\\npic*have-caption=0):(\\npic*caption-after-label=1) \{\
+.          if \\nPIC=1 \!.rt
+.          if \\nPIC=2 .rt
+.          sp  \\n#DOC_LEADu/2u
+.          sp \\*wt\\nstack+\\*gap\\nstacku
+.\" Correct for wandering top of pic
+.          sp -\\npic*text-autoleadp
+.        \}
+.    \}
+.    if !\\npic*left \
+.       in (\\nll-pre-floatu-\\npic*div-widthu)/2u
+.    if \\ngrap \
+\!.     sp -2
+.    if (\\ngrap=1)&(\\npic*caption-after-label=1) \
+\!.     sp -2
+.    if \\npdfbx-running \{\
+.       if \\npdfbx-top \{\
+.          ie !\\npic*left \!.in -\\*gap\\nstacku*2u
+.          el .in -\\*wt\\nstack
+.       \}
+.    \}
+.    if (\\npic*pdfbx=0):(\\npic*pdfbx=2) \
+.       if (\\npic*have-caption=0)&(\\npic*caption-after-label=0) \
+\!.        sp -.5-\\npic*text-autoleadp
 .    pic*div
 .    br
 .    if (\\npic*have-label=1):(\\npic*autolabel=1):(\\npic*caption-after-label=1) \{\
@@ -21459,12 +21980,20 @@
 .       \}
 .       PIC*SET_LABEL_QUAD \\*pic*label-quad
 \!.     in -\\nind-pre-picu
-.       sp \\nlead-pre-labelu-\\n.vu
 .       if !'\\*pic*label-space'' .sp \\*pic*label-space
 .       if \\n#PRINT_STYLE=1 .sp .5v
-.       if \\n#PRINT_STYLE=2 .sp .25v
+.       if \\n#PRINT_STYLE=2 \{\
+.          SIZESPECS
+.          if !\\npic*pdfbx \{\
+.             ie !\\ngrap .sp -1
+.             el .sp -1.5
+.          \}
+.          sp \\*$CAP_HEIGHT+.5
+.          if \\ngrap .if !\\npic*have-label .sp -.5
+.       \}
 .       ie \\npic*autolabel \
-.          nop \\*pic*label-prfx\\*chapno\\nfig*label-num\\*pic*label-sffx\|
+.          nop \
+\\*pic*label-prfx\\*chapno\\nfig*label-num\\*pic*label-sffx\|
 .       el \
 .          if !'\\*pic*label'' .nop \\*pic*label
 .       if dLABEL.REFS \{\
@@ -21487,19 +22016,24 @@
 .       ev
 .       in 0
 .    \}
+.    if \\npic*pdfbx .nr pic*pdfbx 2
 .    ev
-.    sp .5v
-.    FLOAT off
+.    if !\\npdfbx-running \
+.       sp .5
+.    if \\npic*pdfbx=2 .if !\\ngrap .sp .5
+.    ie \\npdfbx-running \
+.       if \\nPIC=1 .FLOAT off
+.    el .FLOAT off
+.    it 1 rr-pic*pdfbx
 .    in \\nind-pre-picu
-.    rm pic*caption
-.    if !\\ndefer .rm pic*label
+.    if !\\ndefer .rr pic*have-caption
 .    rm pic*left
 .    rm short
-.    if !\\ncutaround .rm pic*space-adj
-.    if !\\ndefer .rr pic*have-caption
-.    rr grap
 .    rr float*pic
 .    if '\\*pic*label-sffx-tmp'.' .ds pic*label-sffx .
+.    if \\npdfbx-running=0 .rr pdfbx-running
+.    if r pdfbx-top .rr pdfbx-top
+.    if '\\*pic*label-sffx-tmp'.' .ds pic*label-sffx .
 .END
 \#
 \# ***refer***
@@ -21515,7 +22049,6 @@
 .       if r #EN_REF .rr #EN_REF
 .       nr #FN_REF 1
 .    \}
-.    REF_STYLE NOTE
 .END
 \#
 \# Endnote references
@@ -21530,7 +22063,6 @@
 .       nr #EN_REF 1
 .       if !r#EN_MARKER_STYLE .ENDNOTE_MARKER_STYLE SUPERSCRIPT
 .    \}
-.    REF_STYLE NOTE
 .END
 \#
 \# Prepare mom for a reference
@@ -21590,8 +22122,9 @@
 .    REF_BRACKETS_NOTICE \\$0
 .END
 \#
-\# These four pairs of aliases allow users to embed references in
-\# text and have them surrounded by (), , {} or <>.
+\# These four pairs of aliases used to allow users to embed
+\# references in text and have them surrounded by (), , {} or <>.
+\# bracket-label should be used in the refer block instead.
 \#
 .ALIAS REF( REF_BRACKETS_START
 .ALIAS REF) REF_BRACKETS_END
@@ -21605,10 +22138,6 @@
 .ALIAS REF< REF_BRACKETS_START
 .ALIAS REF> REF_BRACKETS_END
 \#
-.MAC REF_STYLE END
-.    REF_BRACKETS_NOTICE \\$0
-.END
-\#
 \# Refer indenting
 \# ---------------
 \# *Argument:
@@ -21712,6 +22241,7 @@
 .   el .nr ref*type 2
 .   if d q .nr ref*type 2
 .\}
+.if d u .nr ref*type 0 \" If %u exists, always treat as Internet ref
 .if \\nref*type=3 \{\
 .   if !'\\*(R'' \{\
 .      nr ref*type 4
@@ -21746,6 +22276,7 @@
 \# of collected references
 \#
 .de <
+.rm author \" If not, persists over multiple 'bibliography' commands
 .als ref*print ref*end-print
 .nr #REF 1
 .if \\n#BIB_LIST=1 \{\
@@ -21785,7 +22316,7 @@
 .\" Part of workaround for refer spitting out a blank page if the
 .\" last ref falls on the bottom line.
 \\*ref*string\R'ref*num*first-pass +1'\?\R'ref*num +1'\?
-.sp \\n#BIB_SPACEu
+.sp \\*$BIB_SPACE
 .ie \\n#BIB_LIST=0 .in
 .el .IL -\\n#REF_BIB_INDENTu
 .nn 0
@@ -21800,13 +22331,11 @@
 \# string definitions (ref*add-<x>), so we have to make sure that there
 \# aren't two spaces when the printstyle is TYPESET.  Since I find that
 \# references look a bit crowded with 0 sentence space, I've bumped it
-\# up to +4.  User's sentence spacing is reset in FOOTNOTES and ENDNOTES.
+\# up to +8.  User's sentence spacing is reset in FOOTNOTES and ENDNOTES.
 \#
 .de ref*build
-.if \\n#PRINT_STYLE=2 \{\
-.   ds $RESTORE_SS_VAR \\*$SS_VAR
-.   SS +8
-.\}
+.if \\n#PRINT_STYLE=2 \
+.   if (\\n#FN_REF+\\n#EN_REF)>0 .SS +8
 .rm ref*string
 .while \\n.$ \{\
 .   if d \\$1 \{\
@@ -21841,32 +22370,49 @@
 .de ref*add-A
 .ds eval*A \\*(A
 .substring eval*A -1
-.if '\\*eval*A'.' \
-.   if !'\\*$REF_STYLE'NOTE' .chop A
-.\" Per MLA, NOTE should not use idem, therefore if %i contains other than
-.\" idem (e.g., ed., trans.), transpose it to after author's name
-.ie '\\*$REF_STYLE'NOTE' \{\
-.   ie !'\\*idem'' .ref*field A "" "" ", \\*idem"
+.if !\\nskip-A \{\
+.   if '\\*eval*A'.' \
+.      if !\\n#FN_REF+\\n#EN_REF .chop A
+.\" Per MLA, footnotes and endnotes should not use idem, therefore
+.\" if %i contains other than idem (e.g., ed., trans.), transpose it
+.\" to after author's name
+.   ie \\n#FN_REF+\\n#EN_REF=1 \{\
+.      ie !'\\*idem'' .ref*field A "" "" "? \\*idem"
+.      el .ref*field A
+.      rm idem
 .   el .ref*field A
-.   rm idem
-.el .ref*field A
+.   \}
 .\}
 .if \\n(A .nr ref*suppress-period 1
+.rr skip-A
 ..
-\# %i Idem.  BIBLIO: In all instances, removes %A field and replaces
-\# it with a dash; if %i field contains other than the word, idem,
-\# appends it to the dash
+\# %i Idem.
+\#
+\# In bibliographies, per MLA, replace %A with long dash after
+\# first entry with author's name; if %i field contains other than
+\# the word 'idem', appends it to the dash.
+\# In foot/endnotes, idem is ignored; MLA requires full name for
+\# each foot/endnote entry.
+\#
 .de ref*add-i
-.ie '\\*$REF_STYLE'NOTE' \{\
+.\" Is a foot/endnote.
+.ie \\n#FN_REF+\\n#EN_REF=1 \{\
 .   ie '\\*(i'idem' .rm i
 .   el .ds idem \\*(i
 .\}
 .el \{\
+.   rr skip-A
+.\" %i is idem
 .   ie '\\*(i'idem' \{\
-.      rm A
-.      rm i
-.      ref*field i "" \idem "" " "
+.\" If A (%A) is the same as the last A, captured in 'author'.
+.      if '\\*(A'\\*author' \{\
+.         rm i
+.         ref*field i "" \idem "" " "
+.         nr skip-A 1
+.      \}
+.      ds author \\*(A
 .   \}
+.\" %i is not 'idem'; attach to long dash
 .   el \{\
 .      ds eval*i \\*(i
 .      substring eval*i -1
@@ -21882,7 +22428,7 @@
 ..
 \# %m Multiple authors (et al.)
 .de ref*add-m
-.if !'\\*$REF_STYLE'NOTE' \{\
+.if !\\n#FN_REF+\\n#EN_REF \{\
 .   ds eval*m \\*(m
 .   substring eval*m -1
 .   if '\\*eval*m'.' .chop m
@@ -21892,24 +22438,24 @@
 \# %p Post-author string (e.g., Preface, Foreword, etc)
 .de ref*add-p
 .\" Convert first letter to uppercase, per MLA, if BIBLIO
-.if '\\*$REF_STYLE'BIBLIO' \{\
+.if !\\n#FN_REF+\\n#EN_REF \{\
 .   ds initial*cap \\*(p
 .   substring initial*cap 0 0
 .   ds p*string \\*(p
 .   substring p*string 1
 .   ds p \E*UC\\*initial*cap\E*LC\\*p*string
 .\}
-.ie '\\*$REF_STYLE'NOTE' .ref*field p ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field p ,
 .el .ref*field p . " "
 ..
 \# %Q Author(s) when author is not a person
 .de ref*add-Q
-.ie '\\*$REF_STYLE'NOTE' .ref*field Q
+.ie \\n#FN_REF+\\n#EN_REF .ref*field Q
 .el .ref*field Q
 ..
 \# %T Title (generic)
 .de ref*add-T1
-.ie '\\*$REF_STYLE'NOTE' .ref*field T , \E*IT \E*ref*restore-ss
+.ie \\n#FN_REF+\\n#EN_REF .ref*field T , \E*IT \E*ref*restore-ss
 .el \{\
 .   ie !'\\*(A'' .ref*field T . " \E*IT" \E*ref*restore-ss
 .   el \{\
@@ -21918,11 +22464,10 @@
 .   \}
 .\}
 .if \\n(T .nr ref*suppress-period \\n(T
-.
 ..
 \# %T Title of a chapter or article
 .de ref*add-T2
-.ie '\\*$REF_STYLE'NOTE' \
+.ie \\n#FN_REF+\\n#EN_REF \
 .   ref*field T , \lq "" \rq
 .el \{\
 .   ie '\\*(A'' \{\
@@ -21935,7 +22480,7 @@
 ..
 \# %B Book title (when citing an article from a book)
 .de ref*add-B
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\n(T .ref*field B "" \E*IT \E*ref*restore-ss
 .   el .ref*field B , \E*IT \E*ref*restore-ss
 .\}
@@ -21953,7 +22498,7 @@
 ..
 \# %q Titles that must go in quotes (e.g. an unpublished dissertation)
 .de ref*add-q
-.ie '\\*$REF_STYLE'NOTE' .ref*field q , \lq "" \rq
+.ie \\n#FN_REF+\\n#EN_REF .ref*field q , \lq "" \rq
 .el \{\
 .   ie !'\\*(A'' .ref*field q . " \lq" "" \rq
 .   el \{\
@@ -21968,7 +22513,7 @@
 ..
 \# %J Journal name
 .de ref*add-J
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\n(T .ref*field J "" "\E*IT" \E*ref*restore-ss
 .   el .ref*field J , "\E*IT" \E*ref*restore-ss
 .\}
@@ -21979,7 +22524,7 @@
 ..
 \# %M Magazine or newspaper name
 .de ref*add-M
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\n(T .ref*field M "" "\E*IT" \E*ref*restore-ss
 .   el .ref*field M , "\E*IT" \E*ref*restore-ss
 .\}
@@ -22043,7 +22588,7 @@
 .\" End workaround
 .ie !\\nref*type=0 \{\
 .   ie \\n(E>0 \{\
-.      ie '\\*$REF_STYLE'NOTE' \{\
+.      ie \\n#FN_REF+\\n#EN_REF \{\
 .         ie \\n(T .ref*field E "" "ed. "
 .         el .ref*field E , "ed. "
 .      \}
@@ -22053,7 +22598,7 @@
 .      \}
 .   \}
 .   el \{\
-.      ie '\\*$REF_STYLE'NOTE' \{\
+.      ie \\n#FN_REF+\\n#EN_REF \{\
 .         ie \\n(T .ref*field E "" "ed. "
 .         el .ref*field E , "ed. "
 .      \}
@@ -22074,7 +22619,7 @@
 .de ref*add-e
 .ie \\n(T .ref*field e "" "" " ed."
 .el \{\
-.   ie '\\*$REF_STYLE'NOTE' .ref*field e , "" " ed."
+.   ie \\n#FN_REF+\\n#EN_REF .ref*field e , "" " ed."
 .   el .ref*field e . " " " ed."
 .\}
 .nr ref*suppress-period 1
@@ -22086,7 +22631,7 @@
 .if \\nref*type=1 \
 .   ref*field V
 .if \\nref*type=2 \{\
-.   ie '\\*$REF_STYLE'NOTE' .ref*field V , "vol. "
+.   ie \\n#FN_REF+\\n#EN_REF .ref*field V , "vol. "
 .   el \{\
 .      ie \\n(T .ref*field V "" " Vol. "
 .      el .ref*field V . " Vol. "
@@ -22107,7 +22652,7 @@
 .if \\nref*type=1 \
 .   ref*field S
 .if \\nref*type=2 \{\
-.   ie '\\*$REF_STYLE'NOTE' \{\
+.   ie \\n#FN_REF+\\n#EN_REF \{\
 .      ie \\n(T .ref*field S
 .      el .ref*field S ,
 .   \}
@@ -22130,7 +22675,7 @@
 ..
 \# %C City
 .de ref*add-C
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie r d \{\
 .      ref*field C
 .      rr d
@@ -22151,7 +22696,7 @@
 ..
 \# %I Publisher (I stands for Issuer)
 .de ref*add-I
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie !'\\*(C'' .ref*field I :
 .   el .ref*field I "" (
 .\}
@@ -22167,18 +22712,18 @@
 \# %D Date of publication
 .de ref*add-D
 .if \\nref*type=0 \{\
-.   ie '\\*$REF_STYLE'NOTE' .ref*field D ,
+.   ie \\n#FN_REF+\\n#EN_REF .ref*field D ,
 .   el .ref*field D . " "
 .\}
 .if \\nref*type=1 \
 .   ref*field D "" "(" ")"
 .if \\nref*type=2 \{\
-.   ie '\\*$REF_STYLE'NOTE' .ref*field D , "" )
+.   ie \\n#FN_REF+\\n#EN_REF .ref*field D , "" )
 .   el .ref*field D ,
 .\}
 .if \\nref*type=3 \{\
 .   ie !'\\*(C'' \{\
-.      ie '\\*$REF_STYLE'NOTE' .ref*field D , "" )
+.      ie \\n#FN_REF+\\n#EN_REF .ref*field D , "" )
 .      el .ref*field D ,
 .   \}
 .   el \{\
@@ -22188,7 +22733,7 @@
 .         ie '\\*eval*D'1' .ds kern \*BU3
 .         el .ds kern \*BU2
 .         ie \\n#PRINT_STYLE=2 \
-.           if '\\*$REF_STYLE'NOTE' .ref*field D "" (\\*kern )
+.           if \\n#FN_REF+\\n#EN_REF .ref*field D "" (\\*kern )
 .         el .ref*field D
 .      \}
 .      rm eval*D
@@ -22204,7 +22749,7 @@
 \# %P Page number(s)
 .de ref*add-P
 .if \\nref*type=5 .nr ref*type 1
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\nref*type=1 .ref*field P : "" .
 .   el .ref*field P "" "\|"
 .   if \\nref*type=1 .nr ref*suppress-period 1
@@ -22219,7 +22764,7 @@
 ..
 \# %G Gov't. ordering number
 .de ref*add-G
-.ie '\\*$REF_STYLE'NOTE' ref*field G ,
+.ie \\n#FN_REF+\\n#EN_REF ref*field G ,
 .el .ref*field G . " "
 ..
 \# %O Other (info that goes after %T or %B but is hard to categorize; e.g., a dissertation)
@@ -22231,9 +22776,9 @@
 .substring initial*cap 0 0
 .ds O*string \\*(O
 .substring O*string 1
-.if '\\*$REF_STYLE'BIBLIO' \
+.if !\\n#FN_REF+\\n#EN_REF \
 .   ds O \E*UC\\*initial*cap\E*LC\\*O*string
-.ie '\\*$REF_STYLE'NOTE' .ref*field O ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field O ,
 .el \{\
 .   if \\n(O=1 .chop O
 .   ie r e .ref*field O "" " "
@@ -22252,7 +22797,7 @@
 .if '\\*eval*n'.' .chop n
 .if '\\*eval*n'?' .nr n 1
 .if '\\*eval*n'!' .nr n 1
-.ie '\\*$REF_STYLE'NOTE' .ref*field n ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field n ,
 .el \{\
 .   ie !'\\*(P'' .ref*field n "" " "
 .   el .ref*field n . " "
@@ -22269,7 +22814,7 @@
 \# -------------
 \# %d date of publication (the original date of publication)
 .de ref*add-d
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ref*field d "" ( ;
 .   nr d 1
 .\}
@@ -22282,7 +22827,7 @@
 \# %b main author when citing from a preface, introduction, foreword
 \# or afterword
 .de ref*add-b
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\n(T .ref*field b "" "by"
 .   el .ref*field b , "by "
 .\}
@@ -22295,7 +22840,7 @@
 \# %t title, if different from original title (the T field, which s/b
 \# the original title)
 .de ref*add-t
-.ie '\\*$REF_STYLE'NOTE' .ref*field t , "rpt. of \E*IT " \E*ref*restore-ss
+.ie \\n#FN_REF+\\n#EN_REF .ref*field t , "rpt. of \E*IT " \E*ref*restore-ss
 .el \{\
 .   ie \\n(T .ref*field t "" " Rpt. of \E*IT " \E*ref*restore-ss
 .   el .ref*field t . " Rpt. of \E*IT " \E*ref*restore-ss
@@ -22307,7 +22852,7 @@
 \# ----------------
 \# %l Trans(l)ator
 .de ref*add-l
-.ie '\\*$REF_STYLE'NOTE' \{\
+.ie \\n#FN_REF+\\n#EN_REF \{\
 .   ie \\n(T .ref*field l "" "trans. "
 .   el .ref*field l , "trans. "
 .\}
@@ -22319,7 +22864,7 @@
 ..
 \# %r Translato(r) and edito(r)
 .de ref*add-r
-.ie '\\*$REF_STYLE'NOTE' .ref*field r , "trans. and ed. "
+.ie \\n#FN_REF+\\n#EN_REF .ref*field r , "trans. and ed. "
 .el \{\
 .   ie \\n(T .ref*field r "" " Trans. and ed. "
 .   el .ref*field r . " Trans. and ed. "
@@ -22331,13 +22876,13 @@
 \# --------
 \# %s Site name
 .de ref*add-s
-.ie '\\*$REF_STYLE'NOTE' .ref*field s , \E*IT \E*ref*restore-ss
+.ie \\n#FN_REF+\\n#EN_REF .ref*field s , \E*IT \E*ref*restore-ss
 .el \{\
 .ie \\n(s .ref*field s "" ".\E*IT" \E*ref*restore-ss
 .el .ref*field s . " \E*IT" \E*ref*restore-ss
 .\}
 .\" refer doesn't set reg T to 1 for these titles, so we do it here
-.if !'\\*$REF_STYLE'NOTE' \{\
+.if !\\n#FN_REF+\\n#EN_REF \{\
 .   ds eval*s \\*(s
 .   substring eval*s -1
 .   rr T
@@ -22349,7 +22894,7 @@
 ..
 \# %c content of site (ie. Web, Online posting, etc)
 .de ref*add-c
-.ie '\\*$REF_STYLE'NOTE' .ref*field c ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field c ,
 .el \{\
 .   ie \\n(T .ref*field c "" " "
 .   el .ref*field c . " "
@@ -22358,7 +22903,7 @@
 ..
 \# %o organization, group or sponsor of site
 .de ref*add-o
-.ie '\\*$REF_STYLE'NOTE' .ref*field o ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field o ,
 .el \{\
 .   ie \\n(T .ref*field o "" " "
 .   el .ref*field o . " "
@@ -22367,7 +22912,7 @@
 ..
 \# %a access date, i.e. the date you read it
 .de ref*add-a
-.ie '\\*$REF_STYLE'NOTE' .ref*field a ,
+.ie \\n#FN_REF+\\n#EN_REF .ref*field a ,
 .el \{\
 .   ie \\n(T .ref*field a "" " "
 .   el .ref*field a . " "
@@ -22979,7 +23524,6 @@
 \#    PREFIX text : text to prefix link
 \#    SUFFIX text : text after link
 \#    text
-\#
 \# *Notes
 \#    Text is output as a hotspot link to named destination.
 \#    If text has final '*' it is replaced with the text associated with the link
@@ -23090,11 +23634,12 @@
 \#   <image file> <width> <height> are required.
 \#
 .MAC PDF_IMAGE END
+.    br
 .    if !'\\n.z'FLOAT*DIV' \{\
 .       nr pdf-img:float 1
 .       FLOAT
-.       PDF_TARGET fig:\\n+lists*target
 .    \}
+.    PDF_TARGET fig:\\n+lists*target
 .    nr float*img 1
 .    ds ev-current \\n.ev
 .    ev IMG
@@ -23204,6 +23749,12 @@
 \!.           TO_FIGURES "\\*pdf-img*caption\\*short"
 .       \}
 .    \}
+.    if r IMG \{\
+.       if \\npdfbx-top \
+.         rt
+.       sp (\\*wt\\nstack/2u)+\\*gap\\nstacku
+.       nr img*pdfbx 1
+.    \}
 .    di PDF*IMAGE
 .    if \\n@TOP \{\
 .       ch RR_@TOP
@@ -23219,7 +23770,8 @@
 .          \}
 .       \}
 .       if !\\npdf-img*caption-after-label \{\
-.          if !\\n@TOP .sp .5v
+.          if !r pdfbx-top \
+.             if !\\n@TOP \!.sp .5v
 .          nr lead-pre-caption \\n.v
 .          ev caption
 .          evc IMG
@@ -23228,10 +23780,29 @@
 .             img*caption-style
 .             vs \\n.psu+\\npdf-img*caption-autoleadu
 .          \}
+.          if r pdfbx-top .nr restore-pdfbx-top 1
 .          PDF_IMG*SET_CAPTION_QUAD \\*pdf-img*caption-quad
+.          if r restore-pdfbx-top \{\
+.             nr pdfbx-top 1
+.             rr restore-pdfbx-top
+.          \}
 .          nr pdf-img*caption-top-lead-diff \\nlead-pre-caption-\\n.v
-.          sp \\nlead-pre-captionu-\\n.vu
+.          if r pdfbx-top \{\
+.             SIZESPECS
+.           rt
+.             sp \\npdf-img*caption-top-lead-diffu
+.             sp (\\*wt\\nstack)+\\*gap\\nstacku+\\*$CAP_HEIGHT
+.             rr pdfbx-top
+.          \}
+.          if \\npdfbx-running \{\
+.             in -(\\*wt\\nstack)+\\*gap\\nstacku
+.             ll -(\\*wt\\nstack)+\\*gap\\nstacku
+.          \}
 .          nop \\*pdf-img*caption
+.          if r pdfbx-running \{\
+.             in
+.             ll
+.          \}
 .          br
 .          if !'\\*pdf-img*caption-space'' .sp \\*pdf-img*caption-space
 .          ev
@@ -23270,6 +23841,7 @@
 .    \}
 .    ti \\npdf-img:indu+\\npdf-img:frame-insetu
 .    nop \X'pdf: pdfpic \\*pdf-img:file -L \\npdf-img:widthz \\npdf-img:depthz'
+.    if r pdfbx-top .rr pdfbx-top
 .    if '\\*pdf-img:pos'-C' .nr pdf-img:ind +\\npdf-img:frame-inset
 .    sp \\npdf-img:depthu
 .    if \\npdf-img:frame .sp \\npdf-img:frame-insetu
@@ -23291,8 +23863,14 @@
 .       if \\npdf-img*label-with-chapter \
 .          ds chapno \\n#CH_NUM.
 .       PDF_IMG*SET_LABEL_QUAD \\*pdf-img*label-quad
-.       sp \\nlead-pre-labelu-\\n.vu
+.       SIZESPECS
+.       nr pdf-img*label-lead-diff \\nlead-pre-label-\\n.v
+.       sp -.5+\\*$CAP_HEIGHT+\\npdf-img*label-lead-diffu
 .       if !'\\*pdf-img*label-space'' .sp \\*pdf-img*label-space
+.       if \\npdfbx-running \{\
+.          in -(\\*wt\\nstack)+\\*gap\\nstacku
+.          ll -(\\*wt\\nstack)+\\*gap\\nstacku
+.       \}
 .       ie \\npdf-img*autolabel \{\
 .          nop \
 \\*pdf-img*label-prfx\\*chapno\\n+fig*label-num\\*pdf-img*label-sffx\|
@@ -23305,6 +23883,10 @@
 .       fam
 .       ft
 .       ps
+.       if r pdfbx-running \{\
+.          in
+.          ll
+.       \}
 .       gcolor
 .       if !'\\*pdf-img*caption'' \{\
 .          if \\npdf-img*caption-after-label \{\
@@ -23337,6 +23919,10 @@
 .       FLOAT off
 .       nr dl \\npdf-img:width
 .    \}
+.    if \\nimg*pdfbx \{\
+.       sp .5
+.       nr img*pdfbx 2
+.    \}
 .    if !\\npdf-img:float \{\
 .       ie !\\n#NO_SHIM \
 .          if !\\npdf-img*no-shim .SHIM
@@ -23344,7 +23930,7 @@
 .          if !\\n#NO_FLEX \
 .             if !\\npdf-img*no-flex .FLEX
 .    \}
-.    PDF_IMAGE_CLEAN 
+.    PDF_IMAGE_CLEAN
 .END
 \#
 \# PDF_IMAGE_FRAME
@@ -23381,7 +23967,7 @@
 .       \}
 .       el \{\
 .          ds frame-arg \\$1
-.          substring frame-arg -1 
+.          substring frame-arg -1
 .          length arg-len \\*frame-arg
 .          if \\narg-len=1 \{\
 .             tm1 "mom: \\$0 rule weight argument at line \\n.c
@@ -23420,15 +24006,12 @@
 .    rr pdf-img:no-shim
 .    rr pdf-img:no-flex
 .    rr pdf-img:scale
-.\" Cutarounds not yet implemented
 .    if !\\ndefer \
-.       if !\\ncutaround \
-.          rr pdf-img*have-caption
-.    if !\\ncutaround \{\
-.       rr pdf-img:frame-inset
-.       rr pdf-img:width
-.    \}
+.       rr pdf-img*have-caption
+.    rr pdf-img:frame-inset
+.    rr pdf-img:width
 .    if '\\*pdf-img*label-sffx-tmp'.' .ds pdf-img*label-sffx .
+.    it 1 rr-img*pdfbx
 .END
 \#
 .de pdfmomclean
@@ -23452,6 +24035,12 @@
 ..
 \#
 .MAC PAUSE END
+.    nr pdfbx-inhibit-space 1
+.    if \\npdfbx-running \{\
+.       nr pdfbx-pause 1
+.       rr pdfbx-inhibit-space
+.       BoxStop
+.    \}
 .    vpt 0
 .    br
 .    vpt
@@ -23463,6 +24052,11 @@
 .       pdfpause
 .       pdftransition BLOCK \\$1
 .    \}
+.    if \\npdfbx-pause \{\
+.       BoxStart \\*pdfbx-args
+.       rr pdfbx-pause
+.       rr pdfbx-inhibit-space
+.    \}
 .END
 \#
 .MAC TRANSITION END
@@ -23471,6 +24065,506 @@
 .    el .pdftransition PAGE \\$1
 .END
 \#
+\# Shaded backgrounds and frames (pdf boxes), page colour
+\#
+\# BOX
+\# ---
+\# *Arguments:
+\#   SHADED <color> | OUTLINED <color> \
+\#    WEIGHT <wt>   INSET <dist>  \
+\#    ADJUST +|-<amount>  \
+\#    EQN | PIC | GRAP | IMG 
+\# *Function:
+\#   Calls BoxStart with the supplied arguments or stops a running
+\#   box.
+\# *Notes:
+\#   If OUTLINED given but no WEIGHT, the default weight is .5p.
+\#   Otherwise, args have no defaults.
+\#
+.MAC BOX END
+.    nr #FROM_BOX 1
+.    ie \\n#NUM_ARGS=0 \
+.       BoxStart SHADED grey85 INSET 1P
+.    el \{\
+.       ie \\n#NUM_ARGS=1 .BoxStop
+.       el .BoxStart \\$*
+.   \}
+.   rr #FROM_BOX
+.END
+\#
+\# PAGE COLOUR
+\# -----------
+\# *Arguments:
+\#   <color> | OFF | off
+\# *Function:
+\#   Sets pagefill to <color> or stops pagefill.
+\# *Notes:
+\#   OFF|off is required instead of the usual <anything>.
+\#
+.MAC PAGE_COLOR END
+.    ie !'\\$1'OFF' \{\
+.       ie !'\\$1'off' \{\
+.          fcolor \\$1
+.          device pdf: background pagefill
+.       \}
+.       el .device pdf: background off
+.    \}
+.    el .device pdf: background off
+.END
+\#
+.ALIAS PAGE_COLOUR  PAGE_COLOR
+.ALIAS SLIDE_COLOR  PAGE_COLOR
+.ALIAS SLIDE_COLOUR PAGE_COLOR
+\#
+\# Begin or end a box; called from BoxStart
+\#
+.de pdfbackground
+. device pdf: background \\$*
+. if '\\$1'off' \{\
+.   ie (\\nstack-1)=0 \{\
+.     if \\n.t>(1.6v+(\\*wt\\nstack/2u)) \
+.     sp \\*wt\\nstack/2u
+.   \}
+. el \{\
+.   nr pdfbx-container \\nstack-1
+.   if \\n.t>=((\\*wt\\nstack/2u)+(\\*gap\\npdfbx-container)+(\\*wt\\npdfbx-container)) \
+.     sp \\*wt\\nstack/2u
+.   \}
+. \}
+..
+\#
+\# Input trap macros
+\#
+.de rr-pdfbx-top
+. rr pdfbx-top
+..
+\#
+.de rr-pdfbx-end
+. rr pdfbx-end
+..
+\#
+.de rr-pdfbxstop
+. rr pdfbxstop
+..
+\#
+.de rr-pic*pdfbx
+. rr pic*pdfbx
+..
+\#
+.de rr-tbl*pdfbx
+. rr tbl*pdfbx
+..
+\#
+.de rr-img*pdfbx
+. rr img*pdfbx
+..
+\#
+.de rr-pdfbx-post-q
+. rr pdfbx-post-q
+..
+\#
+.de rr-pdfbx-div-start 
+. rr pdfbx-div-start
+..
+\#
+\# Heavy lifting macros called from BOX.
+\#
+.de BoxStart
+. ds pdfbx-args \\$*
+. if \\npdfbx-inhibit-space .sp -1
+. rr pdfbx-inhibit-space
+. if \\n#PP_SPACE \{\
+.   nr restore-pp-space 1
+.   PARA_SPACE off
+. \}
+. if \\n#PRINT_STYLE=1 \{\
+.   tm1 "mom: PRINTSTYLE TYPEWRITE does not permit shaded backgrounds and frames.
+.   tm1 "       Continuing to process without backgrounds or frames.
+.   return
+. \}
+. if \\n#COLUMNS \{\
+.   tm1 "mom: Shaded backgrounds and frames are not available when COLUMNS are enabled.
+.   tm1 "       Continuing to process without backgrounds or frames.
+.   return
+. \}
+. if \\nQ-float=1 .nr Q-float 2
+. if !'\\n.z'' \{\
+.   nr pdfbx-div-start 1
+\!.   it 1 rr-pdfbx-div-start
+. \}
+. if !\\n#NO_SHIM \{\
+.    NO_SHIM
+.    nr pdfbx-restore-shim 1
+. \}
+. if !\\n#NO_FLEX \{\
+.   NO_FLEX
+.   nr pdfbx-restore-flex 1
+. \}
+. if (\\n#NO_SHIM=0)&(\\n#NO_FLEX=1) .nr pdfbx-restore-shim 1
+. if (\\n#NO_SHIM=1)&(\\n#NO_FLEX=0) .nr pdfbx-restore-flex 1
+. rr shad
+. rr outl
+. rm wt
+. rm pdfbx-adj
+. nr pdfbx-running 1
+. nr pdfbx-top 1
+. nr stack +1
+. nr pdfbx-prev \\nstack-1
+. ds type " "
+. ie r #FROM_BOX .ds calling-macro BOX
+. el .ds calling-macro \\$0
+. while \\n.$ \{\
+.   if !'\\$1'SHADED' \
+.   if !'\\$1'OUTLINED' \
+.   if !'\\$1'WEIGHT' \
+.   if !'\\$1'INSET' \
+.   if !'\\$1'PIC' \
+.   if !'\\$1'GRAP' \
+.   if !'\\$1'EQN' \
+.   if !'\\$1'IMG' \
+.   if !'\\$1'ADJUST' \{\
+.     tm mom: Invalid argument '\\$1' to \\*calling-macro, line \\n.c.
+.     shift 1
+.   \}
+.   if '\\$1'SHADED' \{\
+.     nop \\M\\$2\c
+.     nr shad 1
+.     chop type
+.     as type "fill"
+.     shift 2
+.   \}
+.   if '\\$1'OUTLINED' \{\
+.     nop \\m\\$2\c
+.     nr outl 1
+.     chop type
+.     as type "box"
+.     shift 2
+.   \}
+.   if '\\$1'WEIGHT' \{\
+.     ds wt \\$2
+.     shift 2
+.   \}
+.   if '\\$1'INSET' \{\
+.     nr gap \\$2
+.     shift 2
+.   \}
+.   if '\\$1'ADJUST' \{\
+.     ds pdfbx-adj \\$2
+.     shift 2
+.   \}
+.   if '\\$1'PIC' \{\
+.     ie '\\n.z'FLOAT*DIV' .nr PIC 2
+.     el .nr PIC 1
+.     shift 1
+.   \}
+.   if '\\$1'GRAP' \{\
+.     ie '\\n.z'FLOAT*DIV' .nr PIC 2
+.     el .nr PIC 1
+.     shift 1
+.   \}
+.   if '\\$1'EQN' \{\
+.     nr EQN 1
+.     shift 1
+.   \}
+.   if '\\$1'IMG' \{\
+.     nr IMG 1
+.     shift 1
+.   \}
+. \}
+. if '\\*type' ' .ds type "fill "
+. chop type
+. if !r gap .nr gap 1P
+. ie \\noutl \
+.   if '\\*wt'' .ds wt .5p
+. el .ds wt 0
+. if d pdfbx-adj .sp \\*pdfbx-adj
+. if \\n@TOP \{\
+.   RESTORE_SPACE
+.   sp -1
+.   nr @TOP 1
+. \}
+. nr pdfbxstop 1 \" Stop box in footer if .br causes a page break
+. br
+. if \\nQ-float=2 .sp -.5
+. rr pdfbxstop
+. fl
+. SIZESPECS
+. ds pdfbx-cap-adj \\*$CAP_HEIGHT
+.\" Top spacing
+. if \\n#EPIGRAPH+\\n#QUOTE=0 \
+.   if \\n#START .sp -2
+. if \\n#EPIGRAPH \{\
+.   ie \\n#START \!.sp -2
+.   el \!.sp -1.5
+. \}
+. if \\n#QUOTE \{\
+.   if !\\n@TOP  \!.sp -.5-\\*pdfbx-cap-adj
+.   if \\n#START \!.sp .5+\\*wt
+.   rr @TOP
+. \}
+. if '\\n.z'FLOAT*DIV' \{\
+.   if !\\n#START \!.sp -1
+.   nr no-top-space:1 1
+.   nr pdfboxed 1
+. \}
+. if \\nstack=1 \{\
+.   if \\n#INDENT_LEFT_ACTIVE  .nr #IL_ACTIVE \\n#L_INDENT 
+.   if \\n#INDENT_RIGHT_ACTIVE .nr #IR_ACTIVE \\n#R_INDENT 
+.   if \\n#INDENT_BOTH_ACTIVE  \{\
+.     nr #IBL_ACTIVE \\n#BL_INDENT 
+.     nr #IBR_ACTIVE \\n#BR_INDENT 
+.   \}
+.   if \\n#IN_ITEM \
+.     if \\n#BR_INDENT .nr #IBR_ACTIVE \\n#BR_INDENT 
+. \}
+.\" Set l
+. nr pdfbx-l \\n#L_MARGIN
+. if \\n#EPIGRAPH=2 \{\
+.   GET_EPI_OFFSET
+.   nr pdfbx-l \\n#EPI_OFFSET
+. \}
+. if \\n#QUOTE=2 \{\
+.   ie \\n#BQ_OFFSET_VALUE \
+.     nr pdfbx-l \\n#L_MARGIN+(\\n#PP_INDENT*\\n#BQ_OFFSET_VALUE)
+.   el \
+.     nr pdfbx-l \\n#L_MARGIN+(\\*$BQ_OFFSET_VALUE)
+. \}
+. ie \\nstack=1 \
+.   nr l \\npdfbx-l+(\\*wt/2)+\\n#IL_ACTIVE+\\n#IBL_ACTIVE
+.   el .nr l +(\\*wt\\npdfbx-prev/2)+\\*gap\\npdfbx-prev+(\\*wt/2)
+.\" Set r
+. nr r \\npdfbx-l+\\n.l-(\\*wt/2u)
+. if \\n#QUOTE=1    .nr r \\npdfbx-l+\\n#L_LENGTH-(\\*wt/2)
+. if \\n#IR_ACTIVE  .nr r \\npdfbx-l+\\n#L_LENGTH-\\n#IR_ACTIVE-(\\*wt/2)
+. if \\n#IBR_ACTIVE .nr r \\npdfbx-l+\\n#L_LENGTH-\\n#IBR_ACTIVE-(\\*wt/2)
+.\" Set t
+. ie \\nstack=1 .nr t \\n#T_MARGIN+(\\*wt/2)
+. el .nr t +(\\*wt\\npdfbx-prev/2)+\\*gap\\npdfbx-prev+(\\*wt/2)
+.\" Set b
+. nr b \\n.p+\\n#VARIABLE_FOOTER_POS-(\\*wt/2)+\\n#DOC_LEADu
+.\" Clear indents
+. if \\nstack=1 \{\
+.   nr pdfbx-clear 1
+.   ILX CLEAR
+.   IRX CLEAR
+.   if !\\n#QUOTE=2 \
+.     if !\\n#EPIGRAPH=2 \
+.       IBX CLEAR
+.   if \\n#IR_ACTIVE .nr pdfbx-pre-ll \\n#L_LENGTH
+.   rr pdfbx-clear 
+. \}
+.\" See if box fits
+.\" PIC and IMG are in floats, which take care of fit/defer.
+. if (\\nPIC=0)&(\\nIMG=0) \{\
+.   if '\\n.z'' \{\
+.     nr pdfbx-min \
+        (\\*wt*2)+\\*pdfbx-cap-adj+(\\ngap*2)
+.     if r EQN .nr pdfbx-min +1v
+.     if \\n.t<\\npdfbx-min \{\
+.       rr pdfbx-running
+.       bp
+.       nr pdfbx-running 1
+.       RESTORE_SPACE
+.     \}
+.   \}
+. \}
+.\" FOOTER trap
+. if !r #VFP0 .nr #VFP0 \\n#VARIABLE_FOOTER_POS
+. nr #VFP\\nstack 0\\n#VFP\\npdfbx-prev-\\*wt-\\ngap
+. nr #VARIABLE_FOOTER_POS 0\\n#VFP\\nstack
+. ch FOOTER \\n#VARIABLE_FOOTER_POSu
+. mk
+. sp \\*wt/2u
+.
+. pdfbackground \\*type \\nlz \\ntz \\nrz \\nbz \\*wt
+.
+.\" Always start at wt+gap
+. ie \\n#IL_ACTIVE:\\n#IBL_ACTIVE \
+.   IL \\ngapu+\\*wt+\\n#IL_ACTIVEu+\\n#IBL_ACTIVEu
+. el .IL \\ngapu+\\*wt
+. ie \\n#IR_ACTIVE:\\n#IBR_ACTIVE \
+.   IR \\ngapu+\\*wt+\\n#IR_ACTIVEu+\\n#IBR_ACTIVEu
+. el .IR \\ngapu+\\*wt
+. nr pdfbx-ll \\n.l
+. rt
+. sp \\*wt+\\*pdfbx-cap-adj+\\ngapu
+. if (\\nshad=1) .nop \\M\c
+. if (\\noutl=1) .nop \\m\c
+. ds gap\\nstack \\ngap
+. ds wt\\nstack  \\*wt
+. rm wt type
+. it 2 rr-pdfbx-top
+..
+\#
+.de BoxStop
+. if \\n#PRINT_STYLE=1 .return
+. if \\n#COLUMNS=1     .return
+. if \\n#QUOTE=1 .nr pdfboxed 1
+. if \\npdfbx-end=\\nnl \{\
+.   ie !'\\n.z'FLOAT*DIV' .nr pdfbxstop-consec 1
+.   el \
+\!.   if '\\n.z'FLOAT*DIV' .nr pdfbxstop-consec 1
+.   rr pdfbx-end
+. \}
+. nr pdfbxstop 1 \" Stop box in footer if EOL causes a page break
+. if !'\\n.z'' \!.nr pdfbxstop 1
+. EOL
+. rr pdfbxstop
+. if (\\n.ns+\\n@TOP)>0 .RESTORE_SPACE
+. nr pdfbx-prev \\nstack-1
+. nr #VARIABLE_FOOTER_POS 0\\n#VFP\\npdfbx-prev
+. if \\nstack=1 \{\
+.   if !\\n#FN_COUNT .nr #VARIABLE_FOOTER_POS 0-\\n#B_MARGIN
+. \}
+. ch FOOTER \\n#VARIABLE_FOOTER_POSu
+. if !'\\n.z'' \!.ch FOOTER \\n#VARIABLE_FOOTER_POSu
+. ie !r pdfbxstop-consec \{\
+.   sp \\*gap\\nstacku+(\\*wt\\nstack/2u)
+.   if r tbl*pdfbx \{\
+.     if \\ntbl*pdfbx=1 .sp -.6
+.     if \\ntbl*pdfbx=2 .sp -.6-1p
+.     if \\ntbl*pdfbx=3 .sp -.6+1.5p
+.   \}
+.   if r eqn*pdfbx \{\
+.     if \\neqn*pdfbx=1 .sp -.75
+.     if \\neqn*pdfbx=2 .sp -.5
+.     rr eqn*pdfbx
+.   \}
+. \}
+. el \{\
+.   sp
+.   if r pdfbx-post-space .sp -\\npdfbx-post-spaceu
+.   rr pdfbx-post-space
+.   sp (\\*wt\\nstack/2u)+\\*gap\\nstacku
+.   if \\n.t<(\\*wt\\nstack+\\*gap\\nstack) \{\
+.     nr pdfbx-container \\nstack+1
+.     sp \\*wt\\npdfbx-container/2u
+.   \}
+. \}
+. if \\npic*pdfbx=2 \
+.   sp -.5
+. if \\ngrap \
+.   if \\npic*have-label \
+.     sp .5
+. if \\nimg*pdfbx=2 \
+.   sp -.5
+.
+. pdfbackground off
+.
+. EOL
+. if \\n.t<1v \{\
+.   nr pdfbxstop 1 \" Stop box in footer if .br causes a page break
+.   br
+. \}
+. if \\npdfbx-pause .sp -2
+. if \\npic*pdfbx \
+.   if \\npic*have-label .sp .5
+. IL -(\\*gap\\nstacku+\\*wt\\nstack)
+. IR -(\\*gap\\nstacku+\\*wt\\nstack)
+.\" Bottom spacing
+.\"  If the .sp or .br in the ie/el clause causes a break, tell
+.\"  HEADER to skip the PDF boxes stanza.
+. nr pdfbxstop 1
+. if !'\\n.z'' \!.nr pdfbxstop 1
+. if '\\n.z'FLOAT*DIV' .if \\nfloat*tbl .sp -.5
+. ie \\n.t>1v \{\
+.   nr pdfbx-post-space 1.6v
+.   if \\n#EPIGRAPH \
+.      nr pdfbx-post-space .6v
+. \}
+. el .br
+. rr pdfbxstop
+. if '\\n.z'FLOAT*DIV' \!.rr pdfbxstop
+. sp \\npdfbx-post-spaceu
+. if \\npic*pdfbx \
+.   sp -.5
+. if \\nimg*pdfbx \
+.   sp -.5
+. if \\n#QUOTE .sp -.5+(\\*wt\\nstack/2u)
+. nr pdfbx-end \\nnl
+. it 2 rr-pdfbx-end
+. rr pdfbxstop-consec
+. ie '\\n.z'' .rr pdfbx-running
+. el \{\
+\!. rr pdfbx-running
+\!. nr pdfbx-defer 1
+. \}
+. ie '\\n.z'' .nr stack \\nstack-1
+. el \{\
+\!.nr stack-for-float \\nstack
+\!.nr stack \\nstack-1
+. \}
+. if \\npic*pdfbx .rr pic*pdfbx
+. if \\ntbl*pdfbx .rr tbl*pdfbx
+. if \\nimg*pdfbx .rr img*pdfbx
+. if \\nstack=0 \{\
+.   ILX CLEAR
+.   IRX CLEAR
+.   IBX CLEAR
+.   if \\n#IL_ACTIVE \{\
+.     nr #L_INDENT \\n#IL_ACTIVE
+.     IL
+.     rr #IL_ACTIVE
+.   \}
+.   if \\n#IR_ACTIVE \{\
+.     nr #R_INDENT \\n#IR_ACTIVE
+.     ll \\npdfbx-pre-llu
+.     IR
+.     rr pdfbx-pre-ll
+.     rr #IR_ACTIVE
+.   \}
+.   if \\n#IBR_ACTIVE \{\
+.     ll \\npdfbx-pre-llu
+.     IB \\n#IBL_ACTIVEu \\n#IBR_ACTIVEu
+.     rr pdfbx-pre-ll
+.     rr #IBR_ACTIVE
+.     rr #IBL_ACTIVE
+.   \}
+.   if r PIC \{\
+.     rr pic*pdfbx
+.     rr PIC
+.   \}
+.   if r EQN \{\
+.     rr eqn*pdfbx
+.     rr EQN
+.   \}
+.   if r IMG \{\
+.     rr img*pdfbx
+.     rr IMG
+.   \}
+. \}
+. if '\\n.z'P_QUOTE' \{\
+.   nr pdfbx-post-q 1
+.   it 2 rr-pdfbx-post-q
+. \}
+. if d pdfbx-adj .rm pdfbx-adj
+. if \\nrestore-pp-space \{\
+.   rr restore-pp-space
+.   PARA_SPACE
+. \}
+. if \\npdfbx-restore-shim \{\
+.   NO_SHIM off
+.   rr pdfbx-restore-shim
+. \}
+. if \\npdfbx-restore-flex \{\
+.   NO_FLEX off
+.   rr pdfbx-restore-flex
+. \}
+. ie '\\n.z'' \{\
+.   if \\nstack=0 \{\
+.     rr #VFP0
+.     if !\\n#NO_SHIM .SHIM
+.     if !\\n#NO_FLEX .FLEX
+.   \}
+. \}
+. el \{\
+\!. if (\\\\nstack=0) \{\
+.     rr #VFP0
+.     if !r #EPIGRAPH \!.SHIM
+.   \}
+. \}
+..
+\#
 \# Local Variables:
 \# mode: nroff
 \# End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/ChangeLog Changed

@@ -1,3 +1,237 @@
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* pdfmark.am (uninstall-pdfmark-hook): Simplify uninstallation.
+	Try to remove the configured `pdfdocdir` in the event it is
+	empty, but do not fail if it isn't.  (It can be a directory
+	shared with other groff components; we don't know in what order
+	the uninstall targets will serialize, but the last one run
+	should succeed.)
+
+2022-09-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sanitize.tmac: Move comment to where escape sequences are
+	recognized.  Problem arose in commit 058b63ce3d, 2021-09-04.
+
+	troff:.../contrib/pdfmark/sanitize.tmac:162: warning: macro '\"'
+	not defined
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* pdfmark.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* pdfmark.am: Eliminate `PDFMARK_TFLAG` and `PDFMARK_PFLAG` Make
+	macros; they were expanded in only one place.
+	(PDFROFF): Track rename of Make macro `TFLAG` to `MFLAG`.
+
+2022-03-30  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* cover.ms: Die horribly if `PSPIC` call fails.
+
+2022-03-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* pdfmark.am (PDFDOCFILES): Replace hard-coded "gnu.eps"
+	file name with expansion of `DOC_GNU_EPS`.
+	(contrib/pdfmark/pdfmark.pdf): Pass `-I` option to pdfroff(1) to
+	enable location of "gnu.eps" file.
+
+2021-10-24  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Adapt to accommodate global XH and XN implementations.
+
+	cf. <https://savannah.gnu.org/bugs/?58946#comment13>
+
+	* spdf.tmac (XH-INIT, XN-INIT, XH-UPDATE-TOC): Delete definitions;
+	the defaults, provided by s.tmac, are now sufficient.
+	(XH-REPLACEMENT, XN-REPLACEMENT): Define these, rather than...
+	(XH, XN): ...these, respectively.
+
+2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Make a minor layout adjustment.
+
+	* pdfmark.ms (Section 2.4.3): Add a vertical space reservation, to
+	avoid a widow line at the end of the paragraph explaining use of...
+	(PDFHREF.Y): ...this computed register, in the definition of...
+	(PDFBOOKMARK.VIEW): ...this.
+
+2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Clarify references to use of the -Tpdf option.
+
+	* pdfmark.ms (Section 2, Section 3.1): Add footnotes, indicating that
+	only "-Tps" and "-Tpdf" output formats are supported, and that "-Tpdf"
+	may avoid a separate step, to convert from PostScript to PDF.
+
+2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Work around misplacement of link "hot-spots" in footnotes.
+
+	* pdfmark.ms (pdfhref-nobreak): New document-local macro; used instead
+	of "pdfhref", this forces paragraph adjustment before placement of any
+	unbreakable link text, for which line-wrap may be required.  Currently
+	observed only within footnotes, without adjustment, the "hot-spot" for
+	the link may be placed 1v above its associated text.
+
+2021-10-02  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Link footnote reference marks to footnote text.
+
+	* pdfmark.ms (FP): Redefine locally; replace s.tmac default.
+	(FF): Do not redefine; our FP replacement macro does not use it.
+	d FS-MARK (FS-MARK): Redefine locally; map it to...
+	(pdf:fn.mark): ...this locally defined macro.
+	!d FS-MARK (@FS): Rename s.tmac implementation as...
+	(pdf:fn.record): ...this, then redefine @FS itself, to call...
+	(pdf:fn.mark, pdf:fn.record): ...these, in respective order.
+	(groff-1.19.1, GhostScript-8.14): Update footnote reference syntax.
+	(Ghostscript-8.14, MSYS): Emulate sentence space after footnote mark.
+	(*): Replace s.tmac string definition; make it equivalent to "\c",
+	after renaming its original implementation as...
+	(pdf:fn.index): ...this; synchronize references with changes to...
+	(pdf:fn.index.count): ...this new locally defined register; it is
+	auto-incremented by one, as each footnote is placed.
+
+2021-10-01  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Incorporate user-defined TOC leader style.
+
+	* pdfmark.ms: Make some comment tidy-up adjustments.
+	(TC-LEADER, TC-MARGIN): Define them, to take advantage of new
+	s.tmac features; cf. <https://savannah.gnu.org/bugs/?61157>.
+
+2021-09-18  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Factor a further unnecessary macro out of spdf.tmac
+
+	* spdf.tmac (XR): Remove it; relocate it to...
+	* pdfmark.ms (XR): ...here.
+
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Add comments to annotate locally-defined font change macros.
+
+	* pdfmark.ms (EM): Annotate this locally-defined emphasis macro...
+	(CWB, CWI, CWBI): ...these constant width font interpolation macros...
+	(=): ...and this locally-defined IP tag variant string.
+
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Update defunct internet URL references.
+
+	* pdfmark.ms (pdfmark-manual): Adobe moved the document (again);
+	update the document reference macro, to follow the URL relocation.
+	(www.mingw.org): The MinGW Project has relinquished this domain;
+	update the URL reference, to follow web-site relocation to...
+	(mingw.osdn.io): ...here.
+
+2021-09-13  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Factor document-specific bloat out of spdf.tmac
+
+	* spdf.tmac: Reorganize; add many comments.
+	(XN): Retained, but reimplemented, to serve as...
+	(XH, XN): ...both of these; add callback hooks for...
+	(XH-INIT, XN-INIT, XH-UPDATE-TOC): ...these; provide no-op stubs;
+	factor out TOC collection code, delegating to XH-UPDATE-TOC.
+	(opt*XN-N, opt*XN-S, opt*XN-X): Rename internal macros to...
+	(de spdf:XH-N, de spdf:XH-S, de spdf:XH-X): ...these, respectively.
+	(AN, @AN, IE, IS, LU, NN, PXREF, SAME-PAGE, XM): Delete; we do not
+	require these; if users do, they should define their own.
+	(pdf@toc): Delete internal macro; fold body into...
+	(TC): ...this.
+
+	* pdfmark.ms (XH-UPDATE-TOC): Implement callback; it is based on...
+	(XN): ...original implementation of this, factored out of spdf.tmac,
+	but with significant simplification, to remove unnecessary code.
+	(XNVS1, XNVS2, XNVS3): Tighten vertical spacing.
+
+2021-09-04  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Reduce potential for user-space exposure of "ms" internals.
+
+	* spdf.tmac (@NH): Append to s.tmac macro; assign...
+	(spdf:nh*hl): ...this new internal register; alias it to...
+	(.NH): ...this new public name, hence making it track...
+	(nh*hl): ...this s.tmac internal numeric register.
+	(XN): Use \n.NH instead of \nnh*hl.
+
+2021-09-03  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Sanitize text for use in PDF document outlines.
+
+	* sanitize.tmac: New file; it implements...
+	(sanitize): ...this new macro; interprets its first argument as a
+	string name, and copies its remaining arguments to the named string,
+	discarding specific embedded troff escape sequences; currently...
+	(\F): ...only this is identified as "specifically discardable".
+
+	* pdfmark.am (TMACFILES): Add sanitize.tmac
+
+	* spdf.tmac (mso): Include sanitize.tmac
+	(xn*ref, xn*argc): Rename all occurrences...
+	(spdf:refname, spdf:argc): ...to these, respectively.
+	(XN): Stop inserting $* directly into PDF outlines; instead, use...
+	(spdf:bm.text): ...this new string; this is locally defined by...
+	(spdf:bm.define): ...this new macro; passed the original $* from
+	XN, this itself, is locally defined as a redirectable alias for...
+	(spdf:bm.basic): ...this new local macro; it simply copies $*,
+	passed from XN, to the string named by its first argument, (which is
+	always spdf:bm.text), so reproducing previous behaviour.
+	(opt*XN-S): New macro; defined for internal use only, it adds a "-S"
+	option to XN, such that, when specified, it temporarily redirects...
+	(spdf:bm.define): ...this macro mapping alias to...
+	(sanitize): ...this.
+
+	* pdfmark.ms (XN): Add "-S" option for all headings which include...
+	(\FC...\F): ...this escape sequence.
+
+2021-08-21  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Define, and use registered trade mark strings.
+
+	* pdfmark.ms (Adobe, Acrobat, Distiller, PostScript, Microsoft):
+	Define as strings.  Each expands to its own name, followed by the
+	registered trademark symbol, as a superscript, and optional trailing
+	punctuation, below the superscript.  Use each as required.
+
+2021-08-21  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Prefer "-ize" to "-ise" where etymology permits.
+
+	* pdfmark.ms: For all verbs, and their derivative nouns, for which
+	British English allows either "-ise" or "-ize" as ending, prefer the
+	"-ize" form of verb, and "-ization" form of noun, throughout.
+
+2021-08-20  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Correct a spelling error.
+
+	* pdfmark.ms (Section 2.5.3.1): Fix typo: s/exanple/example/.
+
+2021-08-20  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Space out section headings in pdfmark.ms source.
+
+	* pdfmark.ms (.NH): Precede each instance by one null request, to
+	improve readability.
+
+2021-08-18  Keith Marshall  <keith.d.marshall@ntlworld.com>
+
+	Refine pdfroff "missing ghostscript" diagnostic.
+
+	* pdfroff.sh $GS = ":": Fix typo: s/connot/cannot/; refine text.
+
+2020-12-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* pdfmark.am (PDFROFF): Call pdfroff without
+	`--keep-temporary-files` option.  Temporary directories are
+	created with mktemp(1) and files with an embedded process
+	identifier, which frustrates reproducible builds.
+
+	See <https://savannah.gnu.org/bugs/?57218>.
+
 2018-02-28  Werner LEMBERG  <wl@gnu.org>
 
 	* pdfmark.am (pdfmark.pdf): Use $(GROFF_V).
@@ -435,14 +669,15 @@
 
 ________________________________________________________________________
 
-Copyright (C) 2004-2018 Free Software Foundation, Inc.
+Copyright (C) 2004-2020 Free Software Foundation, Inc.
 
 Copying and distribution of this file, with or without modification,
 are permitted in any medium without royalty provided the copyright
 notice and this notice are preserved.
 
 Local Variables:
-version-control: never
-coding: latin-1
+fill-column: 72
 mode: change-log
+version-control: never
 End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/PROBLEMS -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/PROBLEMS Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/README -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/README Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/TODO -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/TODO Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/cover.ms -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/cover.ms Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/pdfmark.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/pdfmark.am Changed

@@ -1,9 +1,7 @@
-# Copyright (C) 2005-2018 Free Software Foundation, Inc.
+# Copyright (C) 2005-2021 Free Software Foundation, Inc.
 #      Written by Keith Marshall (keith.d.marshall@ntlworld.com)
 #      Automake migration by Bertrand Garrigues
 #
-# Last update: 22 Aug 2015
-#
 # This file is part of groff.
 #
 # groff is free software; you can redistribute it and/or modify it under
@@ -29,6 +27,7 @@
 # Files installed in $(tmacdir)
 TMACFILES = \
   contrib/pdfmark/pdfmark.tmac \
+  contrib/pdfmark/sanitize.tmac \
   contrib/pdfmark/spdf.tmac
 pdfmarktmacdir = $(tmacdir)
 dist_pdfmarktmac_DATA = $(TMACFILES)
@@ -36,7 +35,7 @@
 # Files installed in $(pdfdocdir)
 PDFDOCFILES = \
   contrib/pdfmark/pdfmark.pdf
-if BUILD_PDFDOC
+if USE_PDFROFF
 pdfmarkpdfdocdir = $(pdfdocdir)
 nodist_pdfmarkpdfdoc_DATA = $(PDFDOCFILES)
 MOSTLYCLEANFILES += $(PDFDOCFILES)
@@ -54,24 +53,24 @@
   contrib/pdfmark/pdfroff.1.man \
   contrib/pdfmark/pdfroff.sh
 
-PDFMARK_PFLAG =-dpaper=$(PAGE) -P-p$(PAGE)
-PDFMARK_TFLAG = -M$(pdfmark_srcdir)
 PDFROFF=\
   GROFF_TMPDIR=. \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_DIR="$(GROFF_BIN_DIR)" \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  ./pdfroff --keep-temporary-files \
-  $(FFLAG) $(TFLAG) $(PDFMARK_TFLAG) $(PDFMARK_PFLAG)
+  ./pdfroff \
+  $(FFLAG) $(MFLAG) -dpaper=$(PAGE) -P-p$(PAGE) -M$(pdfmark_srcdir)
 
 contrib/pdfmark/pdfmark.pdf: contrib/pdfmark/pdfmark.ms
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(PDFROFF) -mspdf --stylesheet=$(pdfmark_srcdir)/cover.ms \
-	     $(top_srcdir)/contrib/pdfmark/pdfmark.ms >$@
+	&& $(PDFROFF) -I $(doc_builddir) -I $(doc_srcdir) -mspdf \
+	  --stylesheet=$(pdfmark_srcdir)/cover.ms \
+	  $(top_srcdir)/contrib/pdfmark/pdfmark.ms >$@
 
 # The pdf files use the local script to generate.
-$(PDFDOCFILES): pdfroff groff troff gropdf 
-$(PDFDOCFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) gnu.eps
+$(PDFDOCFILES): pdfroff groff troff gropdf
+$(PDFDOCFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) \
+  $(DOC_GNU_EPS)
 
 pdfroff: contrib/pdfmark/pdfroff.sh $(SH_DEPS_SED_SCRIPT)
 	$(AM_V_GEN)sed -f $(SH_DEPS_SED_SCRIPT) \
@@ -88,19 +87,13 @@
 
 uninstall_groffdirs: uninstall-pdfmark-hook
 uninstall-pdfmark-hook:
-if BUILD_PDFDOC
-	if test -d $(DESTDIR)$(pdfmarkpdfdocdir); then \
-	  rmdir $(DESTDIR)$(pdfmarkpdfdocdir); \
-	fi
+if USE_PDFROFF
+	-rmdir $(DESTDIR)$(pdfmarkpdfdocdir)
 endif
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/pdfmark.ms -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/pdfmark.ms Changed

@@ -1,11 +1,9 @@
 .ig
 pdfmark.ms
 
-File position: <groff-source>/contrib/pdfmark/pdfmark.ms
-
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2004-2018 Free Software Foundation, Inc.
+Copyright (C) 2004-2021 Free Software Foundation, Inc.
 written by Keith Marshall <keith.d.marshall@ntlworld.com>
 
 Permission is granted to copy, distribute and/or modify this document
@@ -24,33 +22,33 @@
 .AU Keith Marshall
 .AI <keith.d.marshall@ntlworld.com>
 .CE
-.\"
+.
 .\" Specify the Internet address for the groff web site.
 .\"
 .ds GROFF-WEBSITE http://www.gnu.org/software/groff
-.\"
+.
 .\" Set the PDF default document view attribute, to ensure that the document
 .\" outline is visible, each time the document is opened in Acrobat Reader.
 .\"
 .pdfview /PageMode /UseOutlines
 .\"
-.\" Initialise the outline view to show only three heading levels,
+.\" Initialize the outline view to show only three heading levels,
 .\" with additional subordinate level headings folded.
 .\"
 .nr PDFOUTLINE.FOLDLEVEL 3
-.\"
+.
 .\" Add document identification meta-data
 .\"
 .pdfinfo /Title     Portable Document Format Publishing with GNU Troff
 .pdfinfo /Author    Keith Marshall
 .pdfinfo /Subject   Tips and Techniques for Exploiting PDF Features with GNU Troff
 .pdfinfo /Keywords  groff troff PDF pdfmark
-.\"
+.
 .\" Set the default cross reference format to indicate section numbers,
 .\" rather than page numbers, when we insert a reference pointer.
 .\"
 .ds PDFHREF.INFO section \\*SN-NO-DOT \\$*
-.\"
+.
 .\" Define a macro, to print reference links WITHOUT the usual "see" prefix.
 .\"
 .de XR-NO-PREFIX
@@ -59,31 +57,130 @@
 .XR \\$@
 .rn xx PDFHREF.PREFIX
 ..
-.\"
-.\" Define a string,
-.\" to insert a Registered Trade Mark symbol as a superscript.
+.
+.\" Define a string, to insert a Registered Trade Mark symbol as
+.\" a superscript...
 .\"
 .ds rg \*{\(rg\*}
 .\"
+.\" ...and use it to define strings, representing frequently used
+.\" registered trade marks.
+.\"
+.ds Adobe "Adobe\Z'\\$1'\*(rg\"
+.ds Acrobat "Acrobat\Z'\\$1'\*(rg\"
+.ds Distiller "Distiller\Z'\\$1'\*(rg\"
+.ds PostScript "PostScript\Z'\\$1'\*(rg\"
+.\"
+.ds Microsoft "Microsoft\Z'\\$1'\*(rg\"
+.
 .\" Establish the page layout.
 .\"
 .nr PO  2.5c
 .nr LL 17.0c
 .nr LT 17.0c
-.nr HY  0
-.nr FF  3
 .nr DI  5n
+.nr HY  0
+.
+.\" Within the table of contents, the width of the right-hand margin,
+.\" in which space is reserved for the display of page numbers, and the
+.\" appearance of the leaders which precede it, are controlled by:-
 .\"
+.char \TC-LEADER \h'0.8n'.
+.nr TC-MARGIN \w'00000'
+.
 .\" Generate headers in larger point sizes, for NH levels < 4,
 .\" with point size increasing by 1.5p, for each lesser NH level.
 .\"
 .nr GROWPS 4
 .nr PSINCR 1.5p
+.
+.
+.\" Implement an interface with the FS macro (from s.tmac) to facilitate
+.\" placement of footnote reference marks, with each serving as an active
+.\" pdfhref link to the associated footnote itself.
+.\"
+.de pdf:fn.mark nr
+.\" Macro to replace original duty performed by "\**"; must be invoked
+.\" at point of footnote mark placement, e.g. by FS, BEFORE recording of
+.\" the associated text within the footnote diversion is commenced.
+.\"
+.ie \\n.$ \{\
+.   pdfhref L -D pdf:fn\\$1 -- \\$2
+.   pdfhref M -N pdf:fn\\$1r
+.   \}
+.\"
+.\" s.tmac does not publicly expose its auto-incrementing footnote index;
+.\" to avoid a dependency on an undocumented internal feature, we create
+.\" our own counter, while keeping the internal index synchronized, by
+.\" interpolating a renamed "\**", each time we increment our counter.
+.\"
+.el .\\$0 \\n+pdf:fn.index.count \\*pdf:fn.index
+.nr pdf:fn.index.count 0 1
+.rn * pdf:fn.index
+.ds * \c
+.
+.\" For versions of s.tmac which support the FS-MARK callback hook, it
+.\" is sufficient for us to answer the callback request.
+.\"
+.\" FIXME: in time, we may be able to unconditionally assume that this
+.\" callback hook will be supported...
+.\"
+.ie d FS-MARK .als FS-MARK pdf:fn.mark
+.el \{\
+.\" ...but in the interim, we may need to redefine s.tmac's FS macro,
+.\" (actually the @FS internal macro, rather than FS itself), to gain
+.\" an effect equivalent to taking control of FS-MARK, to achieve the
+.\" placement of a footnote mark as an active pdfhref link.
+.\"
+.rn @FS pdf:fn.record
+.de @FS
+.pdf:fn.mark
+.pdf:fn.record
+..
+.\}
+.\" Override s.tmac's (undocumented) footnote output hook; this emulates
+.\" the default output style for \nFF == 3 footnotes, with the footnote
+.\" number formatted as a pdfhref link back to the position at which the
+.\" footnote marker appears, within the document text.
+.\"
+.de FP
+.LP
+.nr pdf:fn.tag.width (u;2*\\nFI)
+.ds pdf:fn.tag \s'-1.5p'\\$1.\s'+1.5p'
+.pdfhref M -N pdf:fn\\$1
+.in +\\npdf:fn.tag.widthu
+.ti -\\npdf:fn.tag.widthu
+.nr pdf:fn.tag.width -\\w'\\*pdf:fn.tag'u
+.pdfhref L -D pdf:fn\\$1r -A \\h'\\npdf:fn.tag.widthu'\c -- \\*pdf:fn.tag
+..
+.de pdfhref-nobreak
+.\" FIXME: I've only noticed this anomaly when planting pdfhref links
+.\" within footnotes; if the start of the link text is placed near the
+.\" line length limit, and all of it is moved to the start of the next
+.\" line, the "hot-spot" region is computed to be one line higher than
+.\" it should be; ending the preceding input line with "\c", and then
+.\" invoking pdfhref via this wrapper, works around this issue.
+.\"
+.ie \\n.l-\\n.i-\\n.k-\\w'\\$\\n.$' \&
+.el \p
+.pdfhref \\$*
+..
+.
+.\" Define a local macro to facilitate choice of style for emphasis;
+.\" by default, make it equivalent to the ms standard "I" macro.
 .\"
 .de EM
 .\".I "\s'+0.3'\\$1\s0" "\\$2" "\\$3"
 .I \\$@
 ..
+.\" Also, define variations on the ms standard "CW" macro, to add
+.\" bold, italic, and both styles to constant width text; note that
+.\" each of these accept two additional arguments, in comparison to
+.\" standard "CW", such that \$1 specifies the text which is to be
+.\" styled, \$2 and \$3 specify inner after/before bracketting, to
+.\" set as regular "CW" text,  while \$4 and \$5 become equivalent
+.\" to \$2 and \$3 of standard "CW", acting as outer bracketting.
+.\"
 .de CWB
 \\$5\fC\\$3\fP\f(CB\\$1\fP\fC\\$2\fP\\$4
 ..
@@ -93,50 +190,138 @@
 .de CWBI
 \\$5\fC\\$3\fP\fCBI\\$1\fP\fC\\$2\fP\\$4
 ..
+.\" Finally, augment this group with a variant string, which may be
+.\" used to set constant width tags on "IP" paragraphs, with \$1 set
+.\" as if by "CWB", followed by an optional suffix set as if by "CWBI",
+.\" and with the suffix bracketted by \$3 after and \$4 before, each
+.\" set in the regular "CW" style.
+.\"
 .ds = \f(CB\\$1\f(CR\\$4\fCBI\\$2\f(CR\\$3
+.
+.\" Additionally, add a cross-reference convenience macro, emulating
+.\" the style of the "ms" font change macros...
+.\"
+.\"  .XR <dest-name> <affixed> <prefix>
+.\"
+.\" ...such that, when invoked with one, two, or three arguments, this
+.\" expands to the equivalent of:
 .\"
+.\"  .pdfhref L -D <dest-name> -A <affixed> -P <prefix>
+.\"
+.\" to place a pdfhref reference link, to a named destination, within
+.\" the same document, using the reference text which is predefined in
+.\" the reference dictionary entry associated with the destination.
+.\"
+.de XR
+.if \\n(.$ \{\
+.   if \\nOPMODE \{\
+.         ds xr!argv -D "\\$1"
+.         if \\n(.$>1 .as xr!argv " -A "\\$2"
+.         if \\n(.$>2 .as xr!argv " -P "\\$3"
+.         pdfhref L \\*xr!argv
+.         rm xr!argv
+.      \}
+.   \}
+..
+.
 .NH 1
-.\" When we use numbered section headings, we might like to automatically
-.\" insert a table of contents entry, using the text of the heading itself.
-.\" The "ms" macros don't provide any standard mechanism for doing this,
-.\" but "spdf.tmac" adds the "XN" macro, which will do it for us.
+.\" Conventionally, in "ms", NH precedes text which is to be set as a
+.\" numbered section heading, but it makes no provision for automatic
+.\" reference to that heading in a table of contents, or (in the case
+.\" of PDF document production) in a document outline.  Both of these
+.\" limitations may be mitigated, by using the XN macro, (provided by
+.\" spdf.tmac), which sets its arguments, both as text to be included
+.\" in the section heading,  as printed, and as an assocated document
+.\" outline reference;  it will also make this same text available to
+.\" the user-specified callback macro,  XH-UPDATE-TOC, whereby it may
+.\" be used, e.g. to construct a table of contents entry.
+.\"
+.\" Within the table of contents, structural layout will be achieved,
+.\" under the direction of the following spacing control constants:
 .\"
-.\" Here's a simple example of how we might use it.  In this case, the word
-.\" "Introduction" will appear both in the body of the document, as the text
-.\" of the heading, and it will be added to the table of contents, which is
-.\" subsequently "printed" using the "TC" macro; in both locations, it will
-.\" be prefixed by the section number.
+.ds XNVS1 0.50v  \" leading for top level
+.ds XNVS2 0.15v  \" leading at nesting level increment
+.ds XNVS3 0.30v  \" leading following nested group
 .\"
-.\" As an additional side effect, any use of "XN" will cause the table of
-.\" contents entry to be automatically reproduced, with the exception of its
-.\" page number reference, as a PDF document outline entry.  Thus, the use
-.\" of "XN" to specify numbered section headings results in the automatic
-.\" creation of a numbered PDF document outline.  This automatic creation
-.\" of the outline is completely transparent, and will occur regardless
-.\" of whether the "TC" macro is subsequently invoked, or not.
+.\" Note that one TOC related callback hook is shared by both XH and
+.\" XN; its is called XH-UPDATE-TOC, regardless of whether called by
+.\" XH or by XN; when called by XN, it is invoked with arguments:
 .\"
+.\"  .XH-UPDATE-TOC <outline-level> <section-number> <text> ...
+.\"
+.de XH-UPDATE-TOC
+.\" This implementation of XH-UPDATE-TOC utilizes the rudimentary ms
+.\" mechanism for formatting a table of contents, using XS and XE to
+.\" bracket individual entries.
+.   XS
+.   \" A local register, tc*hl, is used to track the outline level
+.   \" of each TOC entry, as it is added; it is not defined, until
+.   \" the first entry is recorded...
+.   \"
+.      if r tc*hl \{\
+.         \" ...after which, we use it to establish indentation,
+.         \" to reflect changes in outline level.
+.         \"
+.            ie \\$1>1 \{\
+.               \" When at any outline level greater than one,
+.               \" any level increment will be offset by XNVS2
+.               \" units of vertical space...
+.               \"
+.                  ie \\$1>\\ntc*hl .sp \\*XNVS2
+.
+.               \" ...whereas any decrement will be offset by
+.               \" XNVS3 units.
+.               \"
+.                  el .if \\ntc*hl>\\$1 .sp \\*XNVS3
+.               \}
+.
+.         \" ...but every top-level entry, after the first, is
+.         \" offset by XNVS1 units.
+.         \"
+.            el .sp \\*XNVS1
+.         \}
+.
+.   \" \$1 becomes the effective outline level for the current table
+.   \" of contents entry, but we must ensure that it is one or more.
+.   \"
+.      ie \\$1 .nr tc*hl \\$1
+.      el .nr tc*hl 1
+.
+.   \" The current outline level determines the indentation at which
+.   \" we place the section number reference...
+.   \"
+.      nop \h'\\ntc*hl-1m'\\$2\c
+.
+.   \" ...after which we discard \$1 and \$2,  allowing us to append
+.   \" all remaining arguments, ensuring that there is at least 0.5n
+.   \" of following space, before the first leader dot.
+.   \"
+.      shift 2
+.      nop \h'1.5n'\\$*\h'0.5n'
+.   XE
+..
 .XN Introduction
 .\"
-.\" If using an old s.tmac, without the SN-NO-DOT extension,
-.\" make sure we get SOMETHING in section number references.
+.\" If using an old s.tmac, without the SN-NO-DOT extension, ensure
+.\" that we get SOMETHING in section number references.
 .\"
-.if !dSN-NO-DOT .als SN-NO-DOT SN
+.if !d SN-NO-DOT .als SN-NO-DOT SN
 .LP
 It might appear that it is a fairly simple matter to
-produce documents in Adobe\*(rg\~\(lqPortable\~Document\~Format\(rq,
+produce documents in \*Adobe\~\(lqPortable\~Document\~Format\(rq,
 commonly known as PDF, using
 .CW groff ) GNU\~Troff\~(
 as the document formatter.
 Indeed,
 .CW groff 's
-default output format is the native Adobe\*(rg\~PostScript\*(rg format,
-which PDF producers such as Adobe\*(rg Acrobat\*(rg Distiller\*(rg,
+default output format is the native \*Adobe\~\*PostScript format,
+which PDF producers such as \*Adobe \*Acrobat \*Distiller ,
 or GhostScript, expect as their input format.
 Thus, the PDF production process would seem to entail simply
 formatting the document source with
 .CW groff ,
-to produce a PostScript\*(rg version of the document,
-which can subsequently be processed by Acrobat\*(rg Distiller\*(rg
+to produce a \*PostScript version of the document,
+which can subsequently be processed by \*Acrobat \*Distiller
 or GhostScript, to generate the final PDF document.
 .LP
 For many PDF production requirements,
@@ -145,16 +330,15 @@
 in which the resultant PDF document represents no more than
 an on screen image of the printed form of the document, if
 .CW groff 's
-PostScript\*(rg output were printed directly.
+\*PostScript output were printed directly.
 .LP
 The Portable Document Format provides a number of features,
 which significantly enhance the experience of reading a document on screen,
 but which are of little or no value to a document which is merely printed.
 It
 .EM is
-possible to exploit these PDF features, which are described in the Adobe\*(rg
-.\"
-.de pdfmark-manual
+possible to exploit these PDF features, which are described in the \*Adobe
+.de pdfmark-manual pdfmark-manual
 .\" This is an example of a resource reference specified by URI ...
 .\" We may need to refer often to the Adobe pdfmark Reference Manual,
 .\" so we create the internet link definition using a macro, to make
@@ -164,24 +348,23 @@
 .\" preceding it with "--", to avoid "invalid character in name" type
 .\" error messages from groff (caused by the use of "\~").
 .\"
-.pdfhref W -D http://partners.adobe.com/public/developer/en/acrobat/sdk/pdf/pdf_creation_apis_and_specs/pdfmarkReference.pdf \
+.pdfhref W -D https://www.adobe.com/go/acrobatsdk_pdfmark \
     -P \(lq -A \(rq\\$1 -- pdfmark\~Reference\~Manual
-..
 .pdfmark-manual ,
 with some refinement of the simple PDF production method, provided
 appropriate \(lqfeature implementing\(rq instructions can be embedded into
 .CW groff 's
-PostScript\*(rg rendering of the document.
+\*PostScript rendering of the document.
 This, of course, implies that the original document source, which
 .CW groff
-will process to generate the PostScript\*(rg description of the document,
+will process to generate the \*PostScript description of the document,
 must include appropriate markup to exploit the desired PDF features.
 It is this preparation of the
 .CW groff
 document source to exploit a number of these features,
 which provides the principal focus of this document.
 .LP
-The markup techniques to be described have been utilised in the production of
+The markup techniques to be described have been utilized in the production of
 the PDF version of this document itself.
 This has been formatted using
 .CW groff 's
@@ -196,16 +379,16 @@
 .IP \(bu
 Selecting a default document view, which defines how the document will appear
 when opened in the reader application; for example, when this document is
-opened in Acrobat\*(rg\~Reader, it should display the top of the cover sheet,
+opened in \*Acrobat\~Reader, it should display the top of the cover sheet,
 in the document view pane, while a document outline should appear to the left,
 in the \(lqBookmarks\(rq pane.
 .IP \(bu
 Adding document identification \(lqmeta\(hydata\(rq,
-which can be accessed, in Acrobat\*(rg\~Reader,
+which can be accessed, in \*Acrobat\~Reader,
 by inspecting the \(lqFile\^/\^Document\~Properties\^/\^Summary\(rq.
 .IP \(bu
 Creating a document outline, which will be displayed in the \(lqBookmarks\(rq
-pane of Acrobat\*(rg\~Reader, such that readers may quickly navigate to any
+pane of \*Acrobat\~Reader, such that readers may quickly navigate to any
 section of the document, simply by clicking on the associated heading
 in the outline view.
 .IP \(bu
@@ -220,33 +403,29 @@
 .LP
 All of the techniques described have been tested on
 .EM both
-GNU/Linux, and on Microsoft\*(rg Windows\(tm2000 operating platforms, using
+GNU/Linux, and on \*Microsoft Windows\(tm2000 operating platforms, using
 .CW groff
-.CW 1.19.1 ,\c
-.pdfhref L -D footnote1 -- \**
+.CW 1.19.1 ,\**
 .FS
-.pdfhref M footnote1
 Later versions should, and some earlier versions may, be equally suitable.
-See
-.pdfhref W \*GROFF-WEBSITE
+See\c
+.pdfhref-nobreak W \*GROFF-WEBSITE
 for information and availability of the latest version.
 .FE
 in association with
 .CW AFPL
 .CW GhostScript
-.CW 8.14 .\c
-.pdfhref L -D footnote2 -- \**
+.CW 8.14 .\**
 .FS
-.pdfhref M footnote2
 Again, other versions may be suitable.
-See
-.pdfhref W http://ghostscript.com
+See\c
+.pdfhref-nobreak W http://ghostscript.com
 for information and availability.
 .FE
+\&
 Other tools employed, which should be readily available on
 .EM any
 Unix\(tm
-.LG
 or GNU/Linux system, are
 .CW sed ,
 .CW awk
@@ -256,12 +435,12 @@
 .CW groff
 input files.
 These additional utilities are not provided, as standard,
-on the Microsoft\*(rg Windows\(tm platform,
+on the \*Microsoft Windows\(tm platform,
 but several third party implementations are available.
 Some worth considering include the MKS\*(rg\~Toolkit,\**
 .FS
-A commercial offering; see
-.pdfhref W http://mkssoftware.com/products/tk/default.asp
+A commercial offering; see\c
+.pdfhref-nobreak W http://mkssoftware.com/products/tk/default.asp
 for information.
 .FE
 Cygwin,\**
@@ -274,28 +453,28 @@
 .LG
 emulation environment and
 Unix\(tm
-.LG
-toolkit for 32\(hybit Microsoft\*(rg Windows\(tm platforms; see
-.pdfhref W http://cygwin.com
+toolkit for \%32\(hybit \*Microsoft Windows\(tm platforms; see\c
+.pdfhref-nobreak W http://cygwin.com
 for information and download.
 .FE
 or MSYS.\**
 .FS
 Another free, but minimal suite of common
 Unix\(tm
-.LG
-tools for 32\(hybit Microsoft\*(rg Windows\(tm, available for download from
-.pdfhref W -A ; http://www.mingw.org
+tools for \%32\(hybit \*Microsoft Windows\(tm, available for download from\c
+.pdfhref-nobreak W -A ; https://mingw.osdn.io
 it
 .EM does 
 include those tools listed above,
 and is the package which was actually used when performing the Windows\(tm2000
 platform tests referred to in the text.
 .FE
+\&
 This list is by no means exhaustive, and should in no way be construed as an
 endorsement of any of these packages, nor to imply that other similar packages,
 which may be available, are in any way inferior to them.
 .bp
+.
 .NH 1
 .\" We may wish a section heading to represent a named destination,
 .\" so that we can create a linked reference to it, from some other 
@@ -320,18 +499,57 @@
 .CW groff
 document source, which should then be processed with a
 .CW groff
-command of the form
+command of the form\**
+.FS
+.pdfhref M pdf-features-fn
+.nr pdf-features-fn \nfn*text-num
+Note that,
+if any
+.CW -T \^\c
+.CWI dev
+option is specified,
+it should be either
+.CW -T \^\c
+.CW ps ,
+or
+.CW -T \^\c
+.CW pdf ;
+any other explicit choice is unlikely to be compatible with
+.CW -m \|\|\c
+.CW pdfmark ,
+and will have an unpredictable
+(possibly erroneous)
+effect on the output.
+If no
+.CW -T \^\c
+.CWI dev
+option is specified,
+(in which case
+.CW -T \^\c
+.CW ps
+is implicitly assumed),
+or if
+.CW -T \^\c
+.CW ps
+is explicitly specified,
+then the output will be produced in \*PostScript format,
+and will require conversion to PDF,
+(e.g. by using GhostScript tools);
+explicit specification of
+.CW -T \^\c
+.CW pdf
+will result in direct output in PDF format,
+thus obviating the need for conversion.
+.FE
 .QP
 .fam C
-groff -Tps -m
-.I name " -m"
+groff -Tps\h'0.2p'|\h'0.2p'-Tpdf -m\F\|\|\FC\c
+.I name 
+-m\F\|\|\FC\c
 .B pdfmark
-.I options \& -
-.I "file ..." \& "... "
-.LP
-(Or use the PDF post-processor to avoid using ghostscript,
-.CW -Tpdf\c
-).
+.I options \F\|\|\FC\c -
+.I file \F\|\|\FC\c "... "
+\&...
 .LP
 It may be noted that the
 .CW pdfmark
@@ -342,16 +560,17 @@
 of their choice, to format their documents, while also using the
 .CW pdfmark
 macros to add PDF features.
+.
 .NH 2
-.XN -N pdfmark-operator -- The \FCpdfmark\F Operator
+.XN -S -N pdfmark-operator -- The \FCpdfmark\F Operator
 .LP
 All PDF features are implemented by embedding instances of the
 .B \FCpdfmark\F
-operator, as described in the Adobe\*(rg
+operator, as described in the \*Adobe
 .pdfmark-manual ,
 into
 .CW groff 's
-PostScript\*(rg output stream.
+\*PostScript output stream.
 To facilitate the use of this operator, the
 .CW pdfmark
 macro package defines the primitive
@@ -359,7 +578,7 @@
 macro; it simply emits its argument list,
 as arguments to a
 .CW pdfmark
-operator, in the PostScript\*(rg output stream.
+operator, in the \*PostScript output stream.
 .LP
 .pdfhref M -N pdfmark-example
 To illustrate the use of the
@@ -412,6 +631,7 @@
 than those currently supported directly by the
 .CW pdfmark
 macro package.
+.
 .NH 2
 .XN -N docview -- Selecting an Initial Document View
 .LP
@@ -421,7 +641,7 @@
 at the default magnification set for the reader,
 and outline and thumbnail views will be hidden.
 When using a PDF reader,
-such as Acrobat\*(rg\~Reader,
+such as \*Acrobat\~Reader,
 which supports the
 .CW /DOCVIEW
 class of the
@@ -435,7 +655,7 @@
 .QP
 .CW ".pdfview /PageMode /UseOutlines"
 .LP
-will cause Acrobat\*(rg\~Reader to open the document outline view,
+will cause \*Acrobat\~Reader to open the document outline view,
 to the left of the normal page view,
 while
 .QP
@@ -462,7 +682,7 @@
 .LP
 It should be noted that the view controlling meta\(hydata, defined by the
 .CW pdfview
-macro, is not written immediately to the PostScript\*(rg output stream,
+macro, is not written immediately to the \*PostScript output stream,
 but is stored in an internal meta\(hydata \(lqcache\(rq,
 (simply implemented as a
 .CW groff
@@ -478,7 +698,7 @@
 .\"     .pdfhref L -D pdfsync -P ( -A ).
 .\"
 .XR pdfsync ). (
-.\"
+.
 .NH 2
 .XN -N docinfo -- Adding Document Identification Meta-Data
 .LP
@@ -525,7 +745,7 @@
 .CW /DOCINFO
 records specified with the
 .CW pdfinfo
-macro are not immediately written to the PostScript\*(rg output stream;
+macro are not immediately written to the \*PostScript output stream;
 they are stored in the same meta\(hydata cache as
 .CW /DOCVIEW
 specifications, until this cache is explicitly flushed,
@@ -533,13 +753,14 @@
 .CW pdfsync
 macro,
 .XR pdfsync ). (
+.
 .NH 2
 .XN -N add-outline -- Creating a Document Outline
 .LP
 A PDF document outline comprises a table of references,
 to \(lqbookmarked\(rq locations within the document.
 When the document is viewed in an \(lqoutline\~aware\(rq PDF document reader,
-such as Adobe\*(rg Acrobat\*(rg Reader,
+such as \*Adobe \*Acrobat Reader,
 this table of \(lqbookmarks\(rq may be displayed in a document outline pane,
 or \(lqBookmarks\(rq pane, to the left of the main document view.
 Individual references in the outline view may then be selected,
@@ -550,12 +771,13 @@
 references to \(lqbookmarked\(rq locations within the document.
 The
 .CW pdfmark
-macro package provides a single generalised macro,
+macro package provides a single generalized macro,
 .CW pdfhref ,
 for creating and linking to \(lqhypertext\(rq reference marks.
 This macro will be described more comprehensively in a later section,
 .XR pdfhref ); (
 the description here is restricted to its use for defining document outline entries.
+.
 .NH 3
 .XN -N basic-outline -- A Basic Document Outline
 .LP
@@ -625,6 +847,7 @@
 .QP
 .CW
 \&.pdfbookmark 3 \*(SN A Basic Document Outline
+.
 .NH 3
 .XN Hierarchical Structure in a Document Outline
 .LP
@@ -696,7 +919,7 @@
 To resolve this paradox, the
 .CW pdfhref
 macro creates the outline entry in two distinct phases \(em
-a destination marker is placed in the PostScript\*(rg output stream immediately,
+a destination marker is placed in the \*PostScript output stream immediately,
 when the outline reference is defined,
 but the actual outline entry is stored in an internal \(lqoutline cache\(rq,
 until its subordinate hierarchy has been fully defined;
@@ -727,11 +950,12 @@
 .pdfhref L -D pdfsync -A ,
 .pdfhref F
 .\"
-to synchronise the output state with the cache state,
+to synchronize the output state with the cache state,
 .XR pdfsync ), (
 at the end of the
 .CW groff
 formatting run.
+.
 .NH 3
 .XN -N outline-view -- Associating a Document View with an Outline Reference
 .LP
@@ -749,7 +973,7 @@
 macro, to create an outline entry,
 should include its own view specification,
 the actual specification assigned to each entry is derived from
-a generalised specification defined in the string
+a generalized specification defined in the string
 .CW PDFBOOKMARK.VIEW ,
 together with the setting of the numeric register
 .CW PDFHREF.VIEW.LEADING ,
@@ -805,7 +1029,7 @@
 .CW PDFBOOKMARK.VIEW
 .EM must
 be specified in terms of valid view specification parameters,
-as described in the Adobe\*(rg
+as described in the \*Adobe
 .pdfmark-manual .
 .LP
 Note the use of the register
@@ -827,12 +1051,13 @@
 definition, by the
 .CW grops
 .CW u \(rq \(lq
-operator, to convert it to PostScript\*(rg units on output.
+operator, to convert it to \*PostScript units on output.
 It may be used in any redefined specification for
 .CW PDFBOOKMARK.VIEW ,
 (or in the analogous definition of
 .CW PDFHREF.VIEW ,
 described in
+'ne 2v
 .XR-NO-PREFIX pdfhref-view ),
 but
 .EM not
@@ -855,7 +1080,7 @@
 page size specifications to
 .CW groff ,
 .CW grops
-and to the PostScript\*(rg to PDF converter employed,
+and to the \*PostScript to PDF converter employed,
 and avoiding any page length changes within the document source.
 .LP
 Also note that
@@ -871,6 +1096,7 @@
 invoking the
 .CW pdfhref
 macro.
+.
 .NH 3
 .XN -N outline-folding -- Folding the Outline to Conceal Less Significant Headings
 .LP
@@ -898,7 +1124,7 @@
 .QS
 .LD
 .fam C
-\&.\e" Initialise the outline view to show only three heading levels,
+\&.\e" Initialize the outline view to show only three heading levels,
 \&.\e" with additional subordinate level headings folded.
 \&.\e"
 \&.nr PDFOUTLINE.FOLDLEVEL 3
@@ -944,6 +1170,7 @@
 .EM immediately
 before the change,
 which should immediately preceed a level one heading.
+.
 .NH 3
 .XN -N multipart-outline -- Outlines for Multipart Documents
 .LP
@@ -956,13 +1183,13 @@
 .LP
 As the overall size of the PDF document increases,
 it may become convenient to divide it into smaller,
-individually formatted PostScript\*(rg components,
+individually formatted \*PostScript components,
 which are then assembled, in the appropriate order,
 to create a composite PDF document.
 While this strategy may simplify the overall process of creating and
 editing larger documents, it does introduce a problem in creating
 an overall document outline,
-since each individual PostScript\*(rg component will be assigned
+since each individual \*PostScript component will be assigned
 duplicated sequences of \(lqbookmark\(rq names,
 with each name ultimately referring to multiple locations in the composite document.
 To avoid such reference naming conflicts, the
@@ -1005,7 +1232,7 @@
 .CW ms
 package,
 .XR using-spdf ), (
-the table of contents is collected into a separate PostScript\*(rg section
+the table of contents is collected into a separate \*PostScript section
 from the main body of the document.
 In the \(lqbody\(rq section, the document outline is \(lquntagged\(rq,
 but in the \(lqTable\~of\~Contents\(rq section, a modified version of the
@@ -1024,6 +1251,7 @@
 this may equally well be specified as
 .QP
 .CW ".pdfbookmark -T T 1 \e\e*TOC"
+.
 .NH 3
 .XN Delegation of the Outline Definition
 .LP
@@ -1059,6 +1287,7 @@
 is delegated to the
 .CW XN
 macro.
+.
 .NH 2
 .XN -N pdfhref -- Adding Reference Marks and Links
 .LP
@@ -1078,7 +1307,7 @@
 indicates that the general purpose of this macro is to define
 .EM any
 type of dynamic reference mark, within a PDF document.
-Its generalised usage syntax takes the form
+Its generalized usage syntax takes the form
 .QP
 .fam C
 .B .pdfhref
@@ -1150,19 +1379,20 @@
 during the PDF document formatting process,
 .XR create-map ). (
 .IP \*= I
-Initialise support for
+Initialize support for
 .CW pdfhref
 features.
 The current
 .CW pdfhref
-implementation provides only one such feature which requires initialisation
+implementation provides only one such feature which requires initialization
 \(em a helper macro which must be attached to a user supplied page trap handler,
 in order to support mapping of reference \(lqhot\(hyspots\(rq
 which extend through a page transition;
 .XR page-trap ). (
 .QE
+.
 .NH 3
-.XN Optional Features of the \FCpdfhref\F Macro
+.XN -S -- Optional Features of the \FCpdfhref\F Macro
 .LP
 The behaviour of a number of the
 .CW pdfhref
@@ -1196,7 +1426,6 @@
 It may be noted that this paradigm for specifying options
 is reminiscent of most
 Unix\(tm
-.LG
 shells; however, in the case of the
 .CW pdfhref
 macro, omission of the space separating an option flag from its argument is
@@ -1515,6 +1744,7 @@
 .CWB -F
 option.
 .QE
+.
 .NH 3
 .XN -N mark-dest -- Marking a Reference Destination
 .LP
@@ -1610,6 +1840,7 @@
 to be \(lqechoed\(rq in the document text,
 at the point where the reference mark is placed,
 in addition to its inclusion in the cross reference map.
+.
 .NH 4
 .XN -N export-map -- Mapping a Destination for Cross Referencing
 .LP
@@ -1633,7 +1864,7 @@
 the cross reference map is generated will be discussed in
 .pdfhref F SECREF L -D do-xref -A ;
 .pdfhref F
-however, it is important to recognise that
+however, it is important to recognize that
 .EM what
 content is included in the cross reference map is established
 when the reference destination is defined \(em it is derived
@@ -1667,6 +1898,7 @@
 to export additional cross reference information,
 or to modify the default format for cross reference links,
 .XR set-format ). (
+.
 .NH 4
 .XN -N pdfhref-view -- Associating a Document View with a Reference Mark
 .LP
@@ -1757,6 +1989,7 @@
 .pdfhref F
 relating to its use, and indeed to page position computations in general,
 apply equally to marked reference views and to outline reference views.
+.
 .NH 3
 .XN -N link-named -- Linking to a Marked Reference Destination
 .LP
@@ -1779,6 +2012,7 @@
 .XR link-intern ), (
 or is defined as a named destination in a different PDF document,
 .XR link-extern ). (
+.
 .NH 4
 .XN -N link-intern -- References within a Single PDF Document
 .LP
@@ -1915,9 +2149,10 @@
 factors established when the named destination is marked,
 .XR mark-dest ), (
 and also by the formatting rules in effect when the link is placed,
-the presentation of a suitable exanple will be deferred,
+the presentation of a suitable example will be deferred,
 until the formatting mechanism has been explained,
 .XR set-format ). (
+.
 .NH 4
 .XN -N link-extern -- References to Destinations in Other PDF Documents
 .LP
@@ -2060,6 +2295,7 @@
 a reference to an external destination will be deferred,
 until the formatting mechanism has been explained,
 .XR set-format ). (
+.
 .NH 3
 .XN -N add-weblink -- Linking to Internet Resources
 .LP
@@ -2163,6 +2399,7 @@
 \&.pdfhref W -A , \*GROFF-WEBSITE
 the requisite mark up might be:\e(en
 .DE
+.
 .NH 3
 .XN -N set-format -- Establishing a Format for References
 .LP
@@ -2185,6 +2422,7 @@
 .XR set-colour
 \(em unless the user specifically chooses to adopt, and implement,
 some alternative strategy.
+.
 .NH 4
 .XN -N set-colour -- Using Colour to Demarcate Link Regions
 .LP
@@ -2194,12 +2432,15 @@
 or even in other documents, or on the World Wide Web,
 it is usually desirable to make the regions
 where these active links are placed stand out from the surrounding text.
+.
 .NH 4
 .XN -N user-format -- Specifying Reference Text Explicitly
+.
 .NH 4
 .XN -N auto-format -- Using Automatically Formatted Reference Text
+.
 .NH 4
-.XN -N custom-format -- Customising Automatically Formatted Reference Text
+.XN -N custom-format -- Customizing Automatically Formatted Reference Text
 .LP
 It is incumbent on the user,
 if employing automatic formatting of the displayed reference,
@@ -2211,6 +2452,7 @@
 thus, it may be easiest to
 .EM always
 use manual formatting for external references.
+.
 .NH 3
 .XN Problematic Links
 .LP
@@ -2224,6 +2466,7 @@
 does function as expected.
 A number of scenarios, which are known to be troublesome,
 are described below.
+.
 .NH 4
 .XN -N page-trap -- Links with a Page Transition in the Active Region
 .LP
@@ -2260,7 +2503,7 @@
 marking the end of normal running text on each page.
 .KS
 .IP \n+ITEM.
-Initialise the
+Initialize the
 .CW pdfhref
 hook into this page transition trap, by invoking
 .RS
@@ -2280,16 +2523,16 @@
 .RE
 .QE
 .LP
-It may be observed that this initialisation of the
+It may be observed that this initialization of the
 .CW pdfhref
 page transition hook is, typically, required only once
 .EM before
 document formatting begins.
 Users of document formatting macro packages may reasonably expect that
-this initialisation should be performed by the macro package itself.
+this initialization should be performed by the macro package itself.
 Thus, writers of such macro packages which include
 .CW pdfmark
-bindings, should provide appropriate initialisation,
+bindings, should provide appropriate initialization,
 so relieving the end user of this responsibility.
 The following example, abstracted from the sample
 .CW ms
@@ -2306,10 +2549,12 @@
 \&.
 \&.pdfhref I -PT pg@bottom
 .DE
+.
 .NH 2
 .XN -N add-note -- Annotating a PDF Document using Pop-Up Notes
+.
 .NH 2
-.XN -N pdfsync -- Synchronising Output and \FCpdfmark\F Contexts
+.XN -S -N pdfsync -- Synchronizing Output and \FCpdfmark\F Contexts
 .LP
 It has been noted previously, that the
 .CW pdfview
@@ -2325,7 +2570,7 @@
 .XR add-outline ), (
 do not immediately write their
 .CW pdfmark
-output to the PostScript\*(rg data stream;
+output to the \*PostScript data stream;
 instead, they cache their output, in a
 .CW groff
 diversion, in the case of the
@@ -2356,7 +2601,7 @@
 .CW pdfmark
 macro package provides the
 .CW pdfsync
-macro, (to synchronise the cache and output states).
+macro, (to synchronize the cache and output states).
 In its simplest form, it is invoked without arguments, i.e.
 .QP
 .fam C
@@ -2425,6 +2670,7 @@
 .EM before
 it commences the formatting of the table of contents section.
 .bp
+.
 .NH 1
 .XN -N pdf-layout -- PDF Document Layout
 .LP
@@ -2459,8 +2705,9 @@
 as to how the
 .CW pdfmark
 macros may be employed with their chosen primary macro package.
+.
 .NH 2
-.XN -N using-spdf -- Using \FCpdfmark\F Macros with the \FCms\F Macro Package
+.XN -S -N using-spdf -- Using \FCpdfmark\F Macros with the \FCms\F Macro Package
 .LP
 The use of the binding macro package,
 .CW spdf.tmac ,
@@ -2471,17 +2718,41 @@
 macros,
 simply by issuing a
 .CW groff
-command of the form
+command of the form\**
+.FS
+Once again,
+.pdfhref L -D pdf-features-fn -- as noted in footnote\*{\npdf-features-fn\*}
+to
+.XR-NO-PREFIX pdf-features ,
+do not specify any
+.CW -T \^\c
+.CWI dev
+option,
+other than
+.CW -T \^\c
+.CW ps ,
+or
+.CW -T \^\c
+.CW pdf ;
+specify
+.CW -T \^\c
+.CW pdf ,
+if you wish to avoid the conversion of \*PostScript output to PDF,
+which will be required if you specify
+.CW -T \^\c
+.CW ps ,
+or if you omit the
+.CW -T \^\c
+.CWI dev
+option entirely.
+.FE
 .QP
 .fam C
-groff -Tps
-.B -mspdf
-.I "-options ...\&"  
-file(s) ...
-.LP
-(Or use the PDF post-processor to avoid using ghostscript,
-.CW -Tpdf\c
-).
+groff -Tps\h'0.2p'|\h'0.2p'-Tpdf -m\F\|\|\FC\c
+.B spdf
+.I options \F\|\|\FC\c -
+.I file \F\|\|\FC\c "... "
+\&...
 .LP
 When using the
 .CW spdf.tmac
@@ -2509,8 +2780,9 @@
 These additional macros,
 and the issues they are intended to address,
 are described below.
+.
 .NH 3
-.XN \FCms\F Section Headings in PDF Documents
+.XN -S -- \FCms\F Section Headings in PDF Documents
 .LP
 Traditionally,
 .CW ms
@@ -2522,7 +2794,7 @@
 However,
 there is no standard mechanism for generating a
 table of contents entry based on the text of the section heading;
-neither is there any recognised standard method for establishing a
+neither is there any recognized standard method for establishing a
 cross reference link to the section.
 .LP
 To address this
@@ -2536,14 +2808,20 @@
 to be used in conjunction with the
 .CW NH
 macro.
+.
 .NH 4
-.XN -N xn-macro -- The \FCXN\F Macro
+.XN -S -N xn-macro -- The \FCXN\F Macro
+.bp
+.
 .NH 1
 .XN The PDF Publishing Process
+.
 .NH 2
 .XN -N do-xref -- Resolving Cross References
+.
 .NH 3
 .XN -N create-map -- Creating a Document Reference Map
+.
 .NH 3
 .XN -N import-map -- Deploying a Document Reference Map
 .TC

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/pdfmark.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/pdfmark.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/pdfroff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/pdfroff.1.man Changed

@@ -1,21 +1,14 @@
-.TH PDFROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-pdfroff \- create PDF documents using groff
+.TH pdfroff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+pdfroff \- construct files in Portable Document Format using
+.I groff
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr pdfroff_C \n.C
-.cp 0
-.
-.
-.\" pdfroff.1
-.\" File position: <groff-source>/contrib/pdfmark/pdfroff.man
-.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2005-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2005-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -29,63 +22,62 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
-.\" ====================================================================
-.\" Local macro definitions
-.
-.hw pdfmark
-.
-.
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_pdfroff_1_man_C \n.cp
+.cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY pdfroff
-.OP \-abcegilpstzCEGNRSUVXZ
-.OP \-d cs
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-L arg
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-P arg
-.OP \-r cn
-.OP \-T dev
-.OP \-w name
-.OP \-W name
-.OP \-\-emit\-ps
-.OP \-\-no\-toc\-relocation
-.OP \-\-no-kill\-null\-pages
+.RI  groff-option 
+.RB  \-\-emit\-ps 
+.RB  \-\-no\-toc\-relocation 
+.RB  \-\-no\-kill\-null\-pages 
 .RB  \-\-stylesheet=\c
 .IR name 
-.OP \-\-no\-pdf\-output
+.RB  \-\-no\-pdf\-output 
 .RB  \-\-pdf\-output=\c
 .IR name 
-.OP \-\-no\-reference\-dictionary
+.RB  \-\-no\-reference\-dictionary 
 .RB  \-\-reference\-dictionary=\c
 .IR  name 
-.OP \-\-report\-progress
-.OP \-\-keep\-temporary\-files
-.RI  file
-\&.\|.\|.\&
+.RB  \-\-report\-progress 
+.RB  \-\-keep\-temporary\-files 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY pdfroff
 .B \-h
+.
 .SY pdfroff
 .B \-\-help
 .YS
 .
+.
 .SY pdfroff
 .B \-v
 .RI  groff-option
 \&.\|.\|.\&
+.
 .SY pdfroff
 .B \-\-version
 .RI  groff-option
@@ -93,127 +85,171 @@
 .YS
 .
 .
+.P
+.I groff-option
+is any short option supported by
+.MR groff @MAN1EXT@
+except for
+.BR \-h ,
+.BR \-T ,
+and
+.BR \-v ;
+see section \lqUsage\rq below.
+.
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B pdfroff
+.I pdfroff
 is a wrapper program for the GNU text processing system,
-.BR  groff .
+.IR groff .
 .
 It transparently handles the mechanics of multiple pass
-.B groff
-processing, when applied to suitably marked up
-.B groff
+.I groff
+processing,
+when applied to suitably marked up
+.I groff
 source files,
 such that tables of contents and body text are formatted separately,
-and are subsequently combined in the correct order, for final publication
-as a single PDF document.
+and are subsequently combined in the correct order,
+for final publication as a single PDF document.
+.
+A further optional \lqstyle sheet\rq capability is provided;
+this allows for the definition of content which is required to precede
+the table of contents,
+in the published document.
 .
-A further optional
-\*(lqstyle sheet\*(rq
-capability is provided;
-this allows for the definition of content which is required to precede the
-table of contents, in the published document.
 .
 .P
 For each invocation of
-.BR pdfroff ,
+.IR pdfroff ,
 the ultimate
-.B groff
-output stream is post-processed by the GhostScript interpreter,
-to produce a finished PDF document.
+.I groff
+output stream is post-processed by the Ghostscript
+.MR gs 1
+interpreter to produce a finished PDF document.
+.
 .
 .P
-.B pdfroff
-makes no assumptions about, and imposes no restrictions on, the use of
-any
-.B groff
+.I pdfroff
+makes no assumptions about,
+and imposes no restrictions on,
+the use of any
+.I groff
 macro packages which the user may choose to employ,
 in order to achieve a desired document format;
-however, it
+however,
+it
 .I does
 include specific built in support for the
-.B pdfmark
-macro package, should the user choose to employ it.
+.I \%pdfmark
+macro package,
+should the user choose to employ it.
 .
-Specifically, if the
+Specifically,
+if the
 .I pdfhref
-macro, defined in the
-.I pdfmark.tmac
-package, is used to define public reference marks, or dynamic links to
-such reference marks, then
-.B pdfroff
+macro,
+defined in the
+.I \%pdfmark.tmac
+package,
+is used to define public reference marks,
+or dynamic links to such reference marks,
+then
+.I pdfroff
 performs as many preformatting
-.B groff
-passes as required, up to a maximum limit of
+.I groff
+passes as required,
+up to a maximum limit of
 .IR four ,
-in order to compile a document reference dictionary, to resolve
-references, and to expand the dynamically defined content of links.
+in order to compile a document reference dictionary,
+to resolve
+references,
+and to expand the dynamically defined content of links.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
 The command line is parsed in accordance with normal GNU conventions,
-but with one exception \(em when specifying any short form option
-(i.e., a single character option introduced by a single hyphen),
-and if that option expects an argument, then it
+but with one exception\(emwhen specifying any short form option
+(i.e.,
+a single character option introduced by a single hyphen),
+and if that option expects an argument,
+then it
 .I must
-be specified independently (i.e., it may
+be specified independently
+(i.e.,
+it may
 .I not
 be appended to any group of other single character short form options).
 .
 .
 .P
-Long form option names (i.e., those introduced by a double hyphen) may
+Long form option names
+(i.e.,
+those introduced by a double hyphen)
+may
 be abbreviated to their minimum length unambiguous initial substring.
 .
 .
 .P
 Otherwise,
-.B pdfroff
+.I pdfroff
 usage closely mirrors that of
-.B groff
+.I groff
 itself.
 .
-Indeed, with the exception of the
+Indeed,
+with the exception of the
 .BR \-h ,
 .BR \-v ,
 and
 .BI \-T \ dev
-short form options, and all long form options, which are parsed
+short form options,
+and all long form options,
+which are parsed
 internally by
-.BR pdfroff ,
+.IR pdfroff ,
 all options and file name arguments specified on the command line are
 passed on to
-.BR groff ,
+.IR groff ,
 to control the formatting of the PDF document.
 .
 Consequently,
-.B pdfroff
-accepts all options and arguments, as specified in
-.BR groff (@MAN1EXT@),
-which may also be considered as the definitive reference for all standard
-.B pdfroff
+.I pdfroff
+accepts all options and arguments,
+as specified in
+.MR groff @MAN1EXT@ ,
+which may also be considered as the definitive reference for all
+standard
+.I pdfroff
 options and argument usage.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-.B pdfroff
-accepts all of the short form options (i.e., those introduced by a
-single hyphen), which are available with
-.B groff
+.I pdfroff
+accepts all of the short form options
+(i.e.,
+those introduced by a
+single hyphen),
+which are available with
+.I groff
 itself.
 .
-In most cases, these are simply passed transparently to
-.BR groff ;
-the following, however, are handled specially by
-.BR pdfroff .
+In most cases,
+these are simply passed transparently to
+.IR groff ;
+the following,
+however,
+are handled specially by
+.IR pdfroff .
+.
 .
 .TP
 .B \-h
@@ -221,33 +257,39 @@
 .BR \-\-help ;
 see below.
 .
+.
 .TP
 .B \-i
-Process standard input, after all other specified input files.
+Process standard input,
+after all other specified input files.
 .
 This is passed transparently to
-.BR groff ,
-but, if grouped with other options, it
+.IR groff ,
+but,
+if grouped with other options,
+it
 .I must
 be the first in the group.
 .
-Hiding it within a group breaks standard input processing, in the
-multiple pass
-.B groff
+Hiding it within a group breaks standard input processing,
+in the multiple-pass
+.I groff
 processing context of
-.BR pdfroff .
+.IR pdfroff .
+.
 .
 .TP
 .BI \-T \ dev
 Only
 .B \-T\ ps
 is supported by
-.BR pdfroff .
+.IR pdfroff .
 .
 Attempting to specify any other device causes
-.B pdfroff
+.I pdfroff
 to abort.
 .
+.
 .TP
 .B \-v
 Same as
@@ -257,133 +299,157 @@
 .
 .P
 See
-.BR groff (@MAN1EXT@)
-for a description of all other short form options, which are
+.MR groff @MAN1EXT@
+for a description of all other short form options,
+which are
 transparently passed through
-.B pdfroff
+.I pdfroff
 to
-.BR groff .
+.IR groff .
 .
 .
 .P
-All long form options (i.e., those introduced by a double hyphen) are
-interpreted locally by
-.BR pdfroff ;
+All long form options
+(i.e.,
+those introduced by a double hyphen)
+are interpreted locally by
+.IR pdfroff ;
 they are
-.B not
+.I not
 passed on to
-.BR groff ,
+.IR groff ,
 unless otherwise stated below.
 .
+.
 .TP
 .B \-\-help
 Causes
-.B pdfroff
-to display a summary of the its usage syntax, and supported options,
+.I pdfroff
+to display a summary of the its usage syntax,
+and supported options,
 and then exit.
 .
+.
 .TP
 .B \-\-emit\-ps
-Suppresses the final output conversion step, causing
-.B pdfroff
+Suppresses the final output conversion step,
+causing
+.I pdfroff
 to emit PostScript output instead of PDF.
 .
-This may be useful, to capture intermediate PostScript output, when
-using a specialised postprocessor, such as
+This may be useful to capture intermediate PostScript output when using
+a specialised postprocessor,
+such as
 .I gpresent
 for example,
-in place of the default
-.I GhostScript
-PDF writer.
+in place of the default Ghostscript PDF writer.
+.
 .
 .TP
 .B \-\-keep\-temporary\-files
-Suppresses the deletion of temporary files, which normally occurs
+Suppresses the deletion of temporary files,
+which normally occurs
 after
-.B pdfroff
-has completed PDF document formatting; this may be useful, when
-debugging formatting problems.
+.I pdfroff
+has completed PDF document formatting;
+this may be useful when debugging formatting problems.
+.
 .
 .IP
 See section \lqFiles\rq below for a description of the temporary
 files used by
-.BR pdfroff .
+.IR pdfroff .
+.
 .
 .TP
 .B \-\-no\-pdf\-output
 May be used with the
 .BI \%\-\-reference\-dictionary= name
-option (described below) to eliminate the overhead of PDF formatting,
-when running
-.B pdfroff
-to create a reference dictionary, for use in a different document.
+option
+(described below)
+to eliminate the overhead of PDF formatting when running
+.I pdfroff
+to create a reference dictionary for use in a different document.
+.
 .
 .TP
 .B \-\-no\-reference\-dictionary
-May be used to eliminate the overhead of creating a reference dictionary,
+May be used to eliminate the overhead of creating a reference
+dictionary,
 when it is known that the target PDF document contains no public
-references, created by the
-.I pdfhref
+references,
+created by the
+.B pdfhref
 macro.
 .
+.
 .TP
 .B \-\-no\-toc\-relocation
 May be used to eliminate the extra
-.B groff
+.I groff
 processing pass,
 which is required to generate a table of contents,
 and relocate it to the start of the PDF document,
 when processing any document which lacks an automatically
 generated table of contents.
 .
+.
 .TP
 .B \-\-no\-kill\-null\-pages
 While preparing for simulation of the manual collation step,
 which is traditionally required to relocate a
 .I "table of contents"
 to the start of a document,
-.B pdfroff
+.I pdfroff
 accumulates a number of empty page descriptions
-into the intermediate
-.I PostScript
-output stream.
+into the intermediate PostScript output stream.
+.
 During the final collation step,
 these empty pages are normally discarded from the finished document;
 this option forces
-.B pdfroff
+.I pdfroff
 to leave them in place.
 .
+.
 .TP
 .BI \-\-pdf\-output= name
 Specifies the name to be used for the resultant PDF document;
-if unspecified, the PDF output is written to standard output.
+if unspecified,
+the PDF output is written to standard output.
+.
 A future version of
-.B pdfroff
+.I pdfroff
 may use this option,
 to encode the document name in a generated reference dictionary.
 .
+.
 .TP
 .BI \-\-reference\-dictionary= name
-Specifies the name to be used for the generated reference dictionary file;
-if unspecified, the reference dictionary is created in a temporary file,
+Specifies the name to be used for the generated reference dictionary
+file;
+if unspecified,
+the reference dictionary is created in a temporary file,
 which is deleted when
-.B pdfroff
+.I pdfroff
 completes processing of the current document.
 .
 This option
 .I must
-be specified, if it is desired to save the reference dictionary,
+be specified,
+if it is desired to save the reference dictionary,
 for use in references placed in other PDF documents.
 .
+.
 .TP
 .B \-\-report\-progress
 Causes
-.B pdfroff
+.I pdfroff
 to display an informational message on standard error,
 at the start of each
-.B groff
+.I groff
 processing pass.
 .
+.
 .TP
 .BI \-\-stylesheet= name
 Specifies the name of an
@@ -394,36 +460,41 @@
 the table of contents,
 in the formatted PDF document.
 .
+.
 .TP
 .B \-\-version
 Causes
-.B pdfroff
+.I pdfroff
 to display a version identification message.
 .
 The entire command line is then passed transparently to
-.BR groff ,
+.IR groff ,
 in a
 .I one
 pass operation
 .IR only ,
 in order to display the associated
-.B groff
-version information, before exiting.
+.I groff
+version information,
+before exiting.
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
-The following environment variables may be set, and exported,
+The following environment variables may be set,
+and exported,
 to modify the behaviour of
-.BR pdfroff .
+.IR pdfroff .
+.
 .
 .TP
 .I PDFROFF_COLLATE
 Specifies the program to be used
 for collation of the finished PDF document.
 .
+.
 .IP
 This collation step may be required to move
 .I tables of contents
@@ -431,15 +502,20 @@
 when formatting with traditional macro packages,
 which print them at the end.
 .
-However, users should not normally need to specify
+However,
+users should not normally need to specify
 .IR \%PDFROFF_COLLATE ,
-(and indeed, are not encouraged to do so).  If unspecified,
-.B pdfroff
+(and indeed,
+are not encouraged to do so).
+.
+If unspecified,
+.I pdfroff
 uses
-.BR sed (@MAN1EXT@)
+.MR sed @MAN1EXT@
 by default,
 which normally suffices.
 .
+.
 .IP
 If
 .I \%PDFROFF_COLLATE
@@ -447,82 +523,84 @@
 specified,
 then it must act as a filter,
 accepting a list of file name arguments,
-and write its output to the
-.I stdout
-stream,
+and write its output to the standard output stream,
 whence it is piped to the
 .IR \%PDFROFF_POSTPROCESSOR_COMMAND ,
 to produce the finished PDF output.
 .
+.
 .IP
 When specifying
 .IR \%PDFROFF_COLLATE ,
 it is normally necessary to also specify
 .IR \%PDFROFF_KILL_NULL_PAGES .
 .
+.
 .IP
 .I \%PDFROFF_COLLATE
 is ignored,
 if
-.B pdfroff
+.I pdfroff
 is invoked with the
-.I \%\-\-no\-kill\-null\-pages
+.B \%\-\-no\-kill\-null\-pages
 option.
 .
+.
 .TP
 .I PDFROFF_KILL_NULL_PAGES
 Specifies options to be passed to the
 .I \%PDFROFF_COLLATE
 program.
 .
+.
 .IP
 It should not normally be necessary to specify
 .IR \%PDFROFF_KILL_NULL_PAGES .
 .
 The internal default is a
-.BR sed (@MAN1EXT@)
+.MR sed @MAN1EXT@
 script,
 which is intended to remove completely blank pages
 from the collated output stream,
 and which should be appropriate in most applications of
-.BR pdfroff .
+.IR pdfroff .
 .
 However,
 if any alternative to
-.BR sed (@MAN1EXT@)
+.MR sed @MAN1EXT@
 is specified for
 .IR \%PDFROFF_COLLATE ,
 then it is likely that a corresponding alternative specification for
 .I \%PDFROFF_KILL_NULL_PAGES
 is required.
 .
+.
 .IP
 As in the case of
 .IR \%PDFROFF_COLLATE ,
 .I \%PDFROFF_KILL_NULL_PAGES
-is ignored, if
-.B pdfroff
+is ignored,
+if
+.I pdfroff
 is invoked with the
-.I \%\-\-no\-kill\-null\-pages
+.B \%\-\-no\-kill\-null\-pages
 option.
 .
+.
 .TP
 .I PDFROFF_POSTPROCESSOR_COMMAND
 Specifies the command to be used for the final document conversion
 from PostScript intermediate output to PDF.
 .
 It must behave as a filter,
-writing its output to the
-.I stdout
-stream,
+writing its output to the standard output stream,
 and must accept an arbitrary number of
 .I files .\|.\|.\&
 arguments,
 with the special case of
-.I \-
-representing the
-.I stdin
-stream.
+.RB \lq \- \rq
+representing the standard input stream.
+.
 .
 .IP
 If unspecified,
@@ -536,31 +614,36 @@
 .EE
 .RE
 .
+.
 .TP
 .I GROFF_TMPDIR
 Identifies the directory in which
-.B pdfroff
+.I pdfroff
 should create temporary files.
 .
 If
 .I \%GROFF_TMPDIR
 is
 .I not
-specified, then the variables
+specified,
+then the variables
 .IR TMPDIR ,
 .I TMP
 and
 .I TEMP
-are considered in turn, as possible temporary file repositories.
-If none of these are set, then temporary files are created
+are considered in turn as possible temporary file repositories.
+.
+If none of these are set,
+then temporary files are created
 in the current directory.
 .
+.
 .TP
 .I GROFF_GHOSTSCRIPT_INTERPRETER
-Specifies the program to be invoked, when
-.B pdfroff
+Specifies the program to be invoked when
+.I pdfroff
 converts
-.B groff
+.I groff
 PostScript output to PDF.
 .
 If
@@ -574,36 +657,48 @@
 .
 If
 .I \%GROFF_GHOSTSCRIPT_INTERPRETER
-is not specified, then
-.B pdfroff
+is not specified,
+then
+.I pdfroff
 searches the process
 .IR PATH ,
 looking for a program with any of the well known names
-for the GhostScript interpreter;
-if no GhostScript interpreter can be found,
-.B pdfroff
+for the Ghostscript interpreter;
+if no Ghostscript interpreter can be found,
+.I pdfroff
 aborts.
 .
+.
 .TP
 .I GROFF_AWK_INTERPRETER
-Specifies the program to be invoked, when
-.B pdfroff
+Specifies the program to be invoked when
+.I pdfroff
 is extracting reference dictionary entries from a
-.B groff
+.I groff
 intermediate message stream.
 .
 If
 .I \%GROFF_AWK_INTERPRETER
-is not specified, then
-.B pdfroff
+is not specified,
+then
+.I pdfroff
 searches the process
 .IR PATH ,
-looking for any of the preferred programs, \oqgawk\cq,
-\oqmawk\cq, \oqnawk\cq, and \oqawk\cq, in this order; if
-none of these are found,
-.B pdfroff
-issues a warning message, and continue processing;
-however, in this case, no reference dictionary is created.
+looking for any of the preferred programs,
+.IR gawk ,
+.IR mawk ,
+.IR nawk ,
+and
+.IR awk ,
+in that order;
+if none of these are found,
+.I pdfroff
+issues a warning message,
+and continue processing;
+however,
+in this case,
+no reference dictionary is created.
+.
 .
 .TP
 .I OSTYPE
@@ -618,6 +713,7 @@
 .I PATH
 to search for external helper programs.
 .
+.
 .TP
 .I PATH_SEPARATOR
 If set,
@@ -631,42 +727,48 @@
 .I PATH
 to search for external helper programs.
 .
+.
 .TP
 .I SHOW_PROGRESS
-If this is set to a non-empty value, then
-.B pdfroff
+If this is set to a non-empty value,
+then
+.I pdfroff
 always behaves as if the
 .B \%\-\-report\-progress
-option is specified, on the command line.
+option is specified on the command line.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 Input and output files for
-.B pdfroff
+.I pdfroff
 may be named according to any convention of the user's choice.
-Typically, input files may be named according to the choice of the
-principal formatting macro package, e.g.,
+.
+Typically,
+input files may be named according to the choice of the principal
+normatting macro package,
+e.g.,
 .RI file .ms
 might be an input file for formatting using the
-.B ms
+.I ms
 macros
 .RI ( s.tmac );
-normally, the final output file should be named
+normally,
+the final output file should be named
 .RI file .pdf .
 .
 .
 .P
-Temporary files, created by
-.BR pdfroff ,
+Temporary files created by
+.I pdfroff
 are placed in the file system hierarchy,
 in or below the directory specified by environment variables
 (see section \lqEnvironment\rq above).
 .
 If
-.BR mktemp (@MAN1EXT@)
+.MR mktemp @MAN1EXT@
 is available,
 it is invoked to create a private subdirectory of
 the nominated temporary files directory,
@@ -676,29 +778,35 @@
 the temporary files will be placed within it,
 otherwise they will be placed directly in the directory
 nominated in the environment.
+.
+.
 .P
 All temporary files themselves
 are named according to the convention
 .IR pdf $$ . *,
 where
 .I $$
-is the standard shell variable representing the process ID of the
-.B pdfroff
-process itself, and
+is the standard shell variable representing the process identifier of
+the
+.I pdfroff
+process itself,
+and
 .I *
 represents any of the extensions used by
-.B pdfroff
+.I pdfroff
 to identify the following temporary and intermediate files.
 .
+.
 .TP
 .IR pdf $$ .tmp
 A scratch pad file,
 used to capture reference data emitted by
-.BR groff ,
+.IR groff ,
 during the
 .I reference dictionary
 compilation phase.
 .
+.
 .TP
 .IR pdf $$ .ref
 The
@@ -714,6 +822,7 @@
 entries,
 as collected in the preceding pass).
 .
+.
 .IP
 If the
 .BR \%\-\-reference\-dictionary =\c
@@ -725,6 +834,7 @@
 rather than
 .IR pdf $$ .ref .
 .
+.
 .TP
 .IR pdf $$ .cmp
 Used to collect
@@ -750,6 +860,7 @@
 is appended to this intermediate file,
 for inclusion in the final formatting passes.
 .
+.
 .TP
 .IR pdf $$ .tc
 An intermediate
@@ -758,16 +869,17 @@
 in which \lqTable of Contents\rq entries are collected,
 to facilitate relocation before the body text,
 on ultimate output to the
-.I GhostScript
+.I Ghostscript
 postprocessor.
 .
+.
 .TP
 .IR pdf $$ .ps
 An intermediate
 .I PostScript
 file,
 in which the body text is collected prior to ultimate output to the
-.I GhostScript
+.I Ghostscript
 postprocessor,
 in the proper sequence,
 .I after
@@ -775,65 +887,95 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-.B pdfroff
+.
+.I pdfroff
 was written by
-.MT keith.d.marshall@\:ntlworld.com
+.MT keith\:.d\:.marshall@\:ntlworld\:.com
 Keith Marshall
-.ME .
+.ME ,
+who maintains it at
+.UR https://\:osdn\:.net/\:users/\:keith/\:pf/\:\%groff-pdfmark/\
+\:wiki/\:\%FrontPage
+his
+.I groff-pdfmark
+OSDN site
+.UE .
+.
+.IR groff 's
+version may be withdrawn in a future release.
 .
 .
 .\" ====================================================================
-.SH SEE ALSO
+.SH "See also"
 .\" ====================================================================
 .
-See
-.BR groff (@MAN1EXT@)
-for the definitive reference to document formatting with
-.BR groff .
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \lqinfo groff\rq.
+.
 .
+.P
 Since
-.B pdfroff
+.I pdfroff
 provides a superset of all
-.B groff
+.I groff
 capabilities,
-.BR groff (@MAN1EXT@)
-may also be considered to be the definitive reference to all
+the above manual,
+or its terser reference page,
+.MR groff @MAN7EXT@
+may also be considered definitive references to all
 .I standard
 capabilities of
-.BR pdfroff ,
+.IR pdfroff ,
 with this document providing the reference to
-.BR pdfroff 's
+.IR pdfroff 's
 extended features.
 .
 .
 .P
 While
-.B pdfroff
-imposes neither any restriction on, nor any requirement for,
+.I pdfroff
+imposes neither any restriction on,
+nor any requirement for,
 the use of any specific
-.B groff
-macro package, a number of supplied macro packages,
+.I groff
+macro package,
+a number of supplied macro packages,
 and in particular those associated with the package
-.IR pdfmark.tmac ,
+.IR \%pdfmark.tmac ,
 are best suited for use with
-.B pdfroff
+.I pdfroff
 as the preferred formatter.
 .
-Detailed documentation on the use of these packages may be found,
-in PDF format, in the reference guide
-.BR "\*(lqPortable Document Format Publishing with GNU Troff\*(rq" ,
-included in the installed documentation set as
-.IR @PDFDOCDIR@/pdfmark.pdf .
+.
+.TP
+.I @PDFDOCDIR@/\:\%pdfmark.pdf
+\lqPortable Document Format Publishing with GNU
+.IR Troff \rq,
+by Keith Marshall,
+offers detailed documentation on the use of these packages.
+.
+This file,
+together with its source,
+.IR \%pdfmark.ms ,
+is part of the
+.I groff
+distribution.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \npdfroff_C
+.cp \n*groff_pdfroff_1_man_C
+.do rr *groff_pdfroff_1_man_C
 .
 .
-.\" ====================================================================
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/pdfroff.sh -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/pdfroff.sh Changed

_service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/sanitize.tmac Added

@@ -0,0 +1,170 @@
+.ig
+
+sanitize.tmac
+
+Copyright (C) 2021 Free Software Foundation, Inc.
+     Written by Keith Marshall (keith.d.marshall@ntlworld.com)
+
+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 the Free
+Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+..
+.eo
+.de sanitize
+.\" Usage: .sanitize name text ...
+.\"
+.\" Remove designated formatting escape sequences from "text ..."; return
+.\" the sanitized text in a string register, identified by "name".
+.\"
+.\" Begin by initializing the named result as an empty string, bind it to
+.\" an internal reference name, and discard the "name" argument, to leave
+.\" only the text which is to be sanitized, as residual arguments.
+.\"
+.   ds \$1
+.   als sanitize:result \$1
+.   shift
+.
+.\" Initialize a working string register, which we will cyclically reduce
+.\" until it becomes empty, after starting with all of the text passed as
+.\" the residual arguments, and establish its initial length.
+.\"
+.   ds sanitize:residual "\$*\"
+.   length sanitize:residual.length "\$*\"
+.
+.\" Begin the cyclic reduction loop...
+.\"
+.   while \nsanitize:residual.length \{\
+.   \"
+.   \" ...assuming, at the start of each cycle, that the next character
+.   \" will not be skipped, and that it will be moved from the residual,
+.   \" to the result, as the character-by-character scan proceeds.
+.   \"
+.      nr sanitize:skip.count 0
+.      sanitize:scan.execute
+.
+.   \" For each character scanned, we need to check if it matches the
+.   \" normal escape character; the check is most readily performed, if
+.   \" an alternative escape character is introduced, and when a match
+.   \" is found, we prepare to skip an escape sequence.
+.   \"
+.      ec !
+.      if '!*sanitize:scan.char'\' .nr sanitize:skip.count 1
+.      ec
+.      ie \nsanitize:skip.count \{\
+.      \"
+.      \" When a possible escape sequence has been detected, we back it
+.      \" up, (in case it isn't recognized, and we need to reinstate its
+.      \" content into the result string), then scan ahead to check for
+.      \" an identifiable escape sequence...
+.      \"
+.         rn sanitize:scan.char sanitize:hold
+.         sanitize:scan.execute
+.         ie d sanitize:esc-\*sanitize:scan.char \
+.         \"
+.         \" ...which we delegate to its appropriate handler, to skip...
+.         \"
+.            sanitize:esc-\*sanitize:scan.char
+.
+.      \" ...but, in the case of an unrecognized escape sequence, we copy
+.      \" its backed-up content, followed by the character retrieved from
+.      \" the current scan cycle, to the result string.
+.      \"
+.         el .as sanitize:result "\*sanitize:hold\*sanitize:scan.char\"
+.      \}
+.
+.   \" When the current scan cycle has retrieved a character, which isn't
+.   \" part of any possible escape sequence, we simply copy that character
+.   \" to the result string.
+.   \"
+.      el .as sanitize:result "\*sanitize:scan.char\"
+.   \}
+.
+.\" Clean up the register space, by deleting all of the string registers,
+.\" and numeric registers, which are designated as temporary, for private
+.\" use within this macro only.
+.\"
+.   rm sanitize:hold sanitize:scan.char sanitize:residual sanitize:result
+.   rr sanitize:residual.length sanitize:skip.count
+..
+.de sanitize:scan.execute
+.\" Usage (internal): .sanitize:scan.execute
+.\"
+.\" Perform a single-character reduction of sanitize:residual, by copying
+.\" its initial character to sanitize:scan.char, and then deleting it from
+.\" sanitize:residual itself.  (Note that we use arithmetic decrementation
+.\" of sanitize:residual.length, rather than repeating the length request
+.\" on sanitize:residual, because reduction WILL fail when there is only
+.\" one character remaining).
+.\"
+.   nr sanitize:residual.length -1
+.   ds sanitize:scan.char "\*sanitize:residual\"
+.   substring sanitize:scan.char 0 0
+.   substring sanitize:residual 1
+..
+.de sanitize:skip-(
+.\" Usage (internal): .sanitize:skip-(
+.\"
+.\" For any identified escape sequence, with a two-character property name,
+.\" simply skip over the next two characters in the residual string.
+.\"
+.   nr sanitize:residual.length -2
+.   substring sanitize:residual 2
+..
+.de sanitize:skip-
+.\" Usage (internal): .sanitize:skip-
+.\"
+.\" For any identified escape sequence, with an arbitrary-length property
+.\" name, skip following characters in the residual string, until we find
+.\" a terminal "" character, or we exhaust the residual.
+.\"
+.   while \nsanitize:skip.count \{\
+.      sanitize:scan.execute
+.      ie \nsanitize:residual.length \{\
+.      \" We haven't yet exhausted the residual; if we find a nested ""
+.      \" character, increment the nesting level, otherwise decrement it
+.      \" for each ""; it will become zero at the terminal "".
+.      \"
+.         ie '\*sanitize:scan.char'' .nr sanitize:skip.count +1
+.         el .if '\*sanitize:scan.char'' .nr sanitize:skip.count -1
+.      \}
+.      \" Stop unconditionally, if we do exhaust the residual.
+.      \"
+.      el .nr sanitize:skip.count 0
+.   \}
+..
+.de sanitize:esc-generic
+.\" Usage: .sanitize:esc-X
+.\"
+.\" (X represents any legitimate single-character escape sequence id).
+.\"
+.\" Handler for skipping "\X" sequences, in text which is to be sanitized;
+.\" this will automatically detect sequences conforming to any of the forms
+.\" "\Xc", "\X(cc", or "\X...", and will handle each appropriately.  The
+.\" implementation is generic, and may be aliased to handle any specific
+.\" escape sequences, which exhibit similar semantics.
+.\"
+.   sanitize:scan.execute
+.   if d sanitize:skip-\*sanitize:scan.char \
+.      sanitize:skip-\*sanitize:scan.char
+..
+.ec
+.\" Map the generic handler to specific escape sequences, as required.
+.\"
+.als sanitize:esc-F sanitize:esc-generic
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:
+.\" sanitize.tmac: end of file

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pdfmark/spdf.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pdfmark/spdf.tmac Changed

@@ -2,7 +2,10 @@
 
 spdf.tmac
 
-Copyright (C) 2004-2018 Free Software Foundation, Inc.
+Binding macros for use of "-m pdfmark" in conjunction with "-ms".
+
+
+Copyright (C) 2004-2021 Free Software Foundation, Inc.
      Written by Keith Marshall (keith.d.marshall@ntlworld.com)
 
 This file is part of groff.
@@ -21,128 +24,259 @@
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 ..
+.\" Bindings
+.\" ========
+.\"
+.\" Generic output mode control flag; pdfmark.tmac will bind this to
+.\" its own internal PDFOPMODE flag.
 .\"
-.if !rOPMODE .nr OPMODE 1
+.if !r OPMODE .nr OPMODE 1
 .\"
 .mso s.tmac
+.mso sanitize.tmac
 .mso pdfmark.tmac
+.
+.\" Establish a handler to clean up output context, at end of document.
 .\"
+.de pdf@exit em
+.   if \\nOPMODE .pdfsync
+.   pg@end-text
+.em pdf@exit
+.
+.
 .\" Omitted Sections
 .\" ================
 .\"
 .\" Define section markers, for special document sections,
 .\" which are to be omitted from regular document processing.
 .\"
+.\" .OMIT <name1> <name2>
+.\"
+.\" Defines a pair of macros, <name1> and <name2>, such that execution
+.\" of .<name1> marks the start of a block of troff input which should
+.\" be ignored; this block ends, on execution of .<name2>
+.\"
 .de OMIT OMIT
-.de \\$1
-.omit@begin \\$1 \\$2
-..
-.de \\$2
-.omit@end \\$1 \\$2
-..
+.   de \\$1
+.      omit@begin \\$1 \\$2
+.   .
+.   de \\$2
+.      omit@end \\$1 \\$2
+.   .
+.\" Definition of the OMIT macro itself, ends when it is first used,
+.\" to identify an omitted section marker macro pair.
+.\"
 .OMIT CS CE    \" front cover text, processed independently
 .OMIT MS ME    \" menu definitions, for info documents only
+.
+.\" Actual omission is initiated by recording the name of the block
+.\" start macro, followed by injection of an "ig" request...
 .\"
 .de omit@begin
-.ds omit@section \\$1
-.ig \\$2
+.   ds omit@section \\$1
+\.  ig \\$2
 ..
+.\" ...and terminates with verification that the end macro matches
+.\" the start macro, and removal of the start macro record; (error
+.\" reporting uses the "@error" macro, from s.tmac).
+.\"
 .de omit@end
-.if !'\\*omit@section'\\$1' .@error \\$2 without \\$1
-.rm omit@section
+.   if !'\\*omit@section'\\$1' .@error \\$2 without \\$1
+.   rm omit@section
 ..
-.de XM
+.
+.\" Document Outlines, and Section Headings
+.\" =======================================
+.\"
+.\" .XH -N <name> -S -X <outline-level> <heading-text> ...
+.\" .XN -N <name> -S -X <heading-text> ...
+.\"
+.\" Use after SH, and XN <n> respectively, to define text to be set
+.\" within the section heading, as a PDF document ouline entry, and
+.\" optionally, as a table of contents entry.
+.\"
+.\" Options:
+.\"  -N <name>        Assigns <name> as a pdfhref destination,
+.\"                   and associates it with the heading.
+.\"
+.\"  -S               Strip troff font-change escapes from the
+.\"                   text copied to the document outline.
+.\"
+.\"  -X               Force pdfhref destination assignment; if
+.\"                   -N <name> is unspecified, use first word
+.\"                   of <heading-text> as <name>.
+.\"
+.\" Arguments:
+.\"  <outline-level>  The nesting level of the heading, within
+.\"                   the document outline, and TOC.  Required
+.\"                   for XH; inferred from NH <n>, for XN.
+.\"
+.\"  <heading-text>   Text (required) to appear within each of
+.\"                   the section heading, document outline,
+.\"                   and (optionally) TOC.
 .\"
-.pdfhref M -X \\$@
+.\" Hooks:
+.\"  XH-INIT          User-defined macro, called on entry to XH;
+.\"                   used to specify initialization state which
+.\"                   may be needed after using SH; e.g. specify
+.\"                   a PDFHREF.INFO state without incorporation
+.\"                   of any "section" references.
+.\"
+.\"  XN-INIT          User-defined macro, called on entry to XN;
+.\"                   used to specify initialization state which
+.\"                   may be needed after using NH; e.g. specify
+.\"                   a PDFHREF.INFO state which may incorporate
+.\"                   "section" references.
+.\"
+.\"  XH-UPDATE-TOC    User-defined macro, called by both XH, and
+.\"                   XN; (there is no XN-UPDATE-TOC).   Must be
+.\"                   defined, if a TOC entry is to be generated
+.\"                   by either XH, or XN;  the format of such a
+.\"                   TOC  entry is determined by the definition
+.\"                   of this macro.
+.\"
+.\" Our replacements for both XH, and XN macros share a common entry
+.\" point; we map both to their respective replacement hooks, so that
+.\" we may continue to take advantage of setup logic in s.tmac.  When
+.\" these are eventually invoked, they will have been renamed so that
+.\" they replace XH, and XH respectively.
+.\"
+.de XH-REPLACEMENT als
+.als XN-REPLACEMENT XH-REPLACEMENT
+.\" FIXME: within s.tmac, the heading level established by the most
+.\" recent prior invocation of the NH macro is tracked by the "nh*hl"
+.\" private register; perhaps s.tmac could expose this more publicly,
+.\" as by this ostensibly read-only alias, since we need it to keep
+.\" PDF document outlines in synchronization with NH level...
+.\"
+.\" .aln .NH nh*hl
+.\"
+.\" ...but maybe a local "belt and braces" approach is better anyway,
+.\" to insulate "nh*hl" from possible abuse of our ".NH" register, by
+.\" any users who may be determined to shoot themselves in the foot!
+.\"
+.ie r nh*hl .nr spdf:nh*hl \nnh*hl
+.el .nr spdf:nh*hl 0
+.am @NH
+.   nr spdf:nh*hl \\nnh*hl
 ..
-.de XR
-.if \\n(.$ \{\
-.   if \\nOPMODE \{\
-.      ds spdf!opts -D "\\$1"
-.      if \\n(.$>1 .as spdf!opts " -A "\\$2"
-.      if \\n(.$>2 .as spdf!opts " -P "\\$3"
-.      pdfhref L \\*spdf!opts
-.      rm spdf!opts
+.aln .NH spdf:nh*hl
+.
+.\" The common entry point for both XH, and XN, handles initialization,
+.\" and interpretation of any specified options, before handing over to
+.\" one of two distinct formatting helper macros, which are specific to
+.\" the XH, and XN implementations respectively.
+.\"
+.am XH-REPLACEMENT \" thus serving as implementation for both XH and XN
+.\"
+.\" The user is expected to furnish the XH-INIT, XH-UPDATE-TOC, and
+.\" XN-INIT handlers.  (Note that the XH-UPDATE-TOC hook serves both
+.\" XH and XN; there is no separate XN-UPDATE-TOC).  A suitable stub
+.\" for each is provided by s.tmac; we have no need to replace them.
+.\"
+.   \\$0-INIT
+.   rm spdf:refname
+.   als spdf:bm.define spdf:bm.basic
+.   while d spdf:XH\\$1 \{\
+.         spdf:XH\\$1 \\$*
+.         shift \\nspdf:argc
 .      \}
-.   \}
+.   rr spdf:argc
+.   if '\\$1'--' .shift
+.   spdf:\\$0.format \\$@
 ..
+.\" Interpret the "-N <name>" option...
 .\"
-.\" Document Outlines, Section Headings and Table of Contents
-.\" =========================================================
-.\"
-.de XN
-.\" Use AFTER .NH n, to define the text of the numbered heading,
-.\" automatically generating a matching formatted TOC entry, and
-.\" a PDF document outline entry.
-.\"
-.\" String registers XNVS1, XNVS2 and XNVS3 establish additional leading,
-.\" prior to top level headings, preceding each level of indented subheading,
-.\" and following each nested level of subheading, respectively
-.\" (strings are used, rather than numeric registers, so that these
-.\"  additional spacing parameters may be set relative to the current
-.\"  document line spacing, as set by \nVS).
-.\"
-.rm xn*ref
-.while dopt*XN\\$1 \{\
-.   opt*XN\\$1 \\$*
-.   shift \\nxn*argc
-.   \}
-.rr xn*argc
-.if '\\$1'--' .shift
-.if dxn*ref .XM -N \\*xn*ref -- \\$@
-.rm xn*ref
-.pdfhref O \\nnh*hl "\\*(SN \\$*"
-.XS
-.if rtc*hl \{\
-.   if !dXNVS1 .ds XNVS1 1.0v  \" default leading for top level
-.   if !dXNVS2 .ds XNVS2 0.3v  \" default leading at nesting increment
-.   if !dXNVS3 .ds XNVS3 0.6v  \" default leading following nested group
-.   if \\nnh*hl==1 \{\
-.      sp \\*XNVS1
-.      nr tc*hl-max 1
-.      \}
-.   ie \\nnh*hl<\\ntc*hl .if \\nnh*hl>1 .sp \\*XNVS3
-.   el \{\
-.      ie \\nnh*hl>\\ntc*hl .sp \\*XNVS2
-.      el \{\
-.         if !r tc*hl-max .nr tc*hl-max 1
-.         ie \\ntc*hl-max>\\nnh*hl .sp \\*XNVS3
-.         el .nr tc*hl-max \\nnh*hl
-.         \}
-.      \}
-.   \}
-.nr tc*hl \\nnh*hl
-\h'\\nnh*hl-1m'\c
-\&\\*(SN\h'1n'\\$*
-.\".pdfhref L -D \\*PDFBOOKMARK.NAME -- \&\\*(SN\h'1n'\\$*
-.XE
-\&\\$*
+.de spdf:XH-N
+.   ds spdf:refname \\$2
+.   nr spdf:argc 2
 ..
-.de opt*XN-N
-.nr xn*argc 2
-.ds xn*ref \\$2
+.\" ...the "-X" option, and...
+.\"
+.de spdf:XH-X
+.   if !d spdf:refname .ds spdf:refname \\\\$1
+.   nr spdf:argc 1
 ..
-.de opt*XN-X
-.nr xn*argc 1
-.if !dxn*ref .ds xn*ref \\\\$1
+.\" ...the "-S" option.
+.\"
+.de spdf:XH-S
+.   als spdf:bm.define sanitize
+.   nr spdf:argc 1
 ..
-.de LU
-.LP
-The content for this section is not yet available.
+.\" By default, when the "-S" option is not specified, the text
+.\" incorporated into the PDF document outline will be a simple
+.\" verbatim copy of the arguments.
+.\"
+.de spdf:bm.basic
+.   shift \" ignore \$1; it should always be "spdf:bm.text"
+.   ds spdf:bm.text "\\$*\"
 ..
-.de AN
-.ie \\n(.$ .@AN \\$*
-.el .@AN Note
+.\" After initialization, and interpretation of options, the XH
+.\" and XN implementations diverge, into this helper macro, which
+.\" is specific to the XH implementation...
+.\"
+.de spdf:XH.format
+.   XH-UPDATE-TOC \\$@
+.   ds spdf:bm.argv \\$1
+.   shift \" finalization doesn't want the outline level in \$1
+.   spdf:XH.finalize \\$@
 ..
-.de @AN
-.SH
-\\$*
-.LP
+.\" ...and this, which is specific to XN...
+.\"
+.de spdf:XN.format
+.   ds spdf:bm.argv \\n.NH \\*SN
+.   XH-UPDATE-TOC \\n.NH \\*SN \\$@
+.   spdf:XH.finalize \\$@
+..
+.\" ...before ultimately converging back into this finalization
+.\" macro, which is once again common to both XH and XN.
+.\"
+.de spdf:XH.finalize
+.   spdf:bm.define spdf:bm.text "\\$*"
+.   if d spdf:refname .pdfhref M -X -N \\*spdf:refname -- \\$@
+.   pdfhref O \\*spdf:bm.argv \\*spdf:bm.text
+.   rm spdf:refname spdf:bm.argv spdf:bm.text
+.   nop \\$*
 ..
+.
+.\" Cross-Reference Marshalling
+.\" ===========================
+.\"
+.\" s.tmac provides the "pg@bottom" macro, which has already
+.\" been installed as a page transition trap.  To ensure proper
+.\" mapping of "pdfhref" links which overflow the bottom of any
+.\" page, we need to install the "pdfhref" page transition hook,
+.\" as an addendum to this macro.
+.
+.pdfhref I -PT pg@bottom
+.
+.
+.\" Phased Output Control
+.\" =====================
+.\"
+.\" Segregate output of table of contents, and document body text,
+.\" into two distinct output phases, to facilitate assembly of the
+.\" aggregate document in the correct order, particularly when the
+.\" TOC is generated at the end, by the default "ms" mechanism.
+.\"
 .nr PDF-TOC-ONLY  1
 .nr PDF-BODY-TEXT 2
+.\"
+.\" .OP <output-phase>
+.\"
+.\" If the user-specified PHASE numeric register has been defined,
+.\" and its value matches the <output-phase> argument value, (or if
+.\" no <output-phase> argument is specified), then set the OPMODE
+.\" control flag to one, and activate groff's "pen-down" mode.
+.\"
+.\" Otherwise, if <output-phase> is specified, but does NOT match
+.\" PHASE, set OPMODE to zero, and select "pen-up" mode.
+.\"
+.\" Alternatively, if PHASE has not been defined, unconditionally
+.\" set OPMODE to one, and leave groff's pen state unchanged.
+.\"
 .de OP
-.ie rPHASE \{\
+.ie r PHASE \{\
 .   ie \\n(.$ \{\
 .      nr op:request 0
 .      while \\n(.$ \{\
@@ -158,67 +292,35 @@
 .   \}
 .el .nr OPMODE 1
 ..
-.nr SAME-PAGE 0
-.de NN
-.if !\\nSAME-PAGE .bp
-.nr SAME-PAGE 0
-.NH \\$1
-.nn*setname \\$2
-.shift 2
-.XN -N \\*nn*name -- \\$@
-.rm nn*name
-..
-.de nn*setname
-.ds nn*name \\$1
-.shift
-.while \\n(.$ \{\
-.   as nn*name -\\$1
-.   shift
-.   \}
-..
-.de PXREF
-.nn*setname \\$2
-.XR \\*nn*name )\\$1 (
-.rm nn*name
-..
-.de IS
-.RS
-.nr LL \\n(LL-\\n(PI
-..
-.de IE
-.RE
-.nr LL \\n(LL+\\n(PI
-..
-.\" Override the standard ms macro,
-.\" to ensure the document outline cache is flushed
-.\" BEFORE emitting the table of contents.
+.
+.\" Table of Contents Generation
+.\" ============================
+.\"
+.\" .TC no
+.\"
+.\" Replaces (and emulates) the TC macro, from s.tmac, to ensure
+.\" that the pdfmark document outline cache is flushed, before TOC
+.\" generation commences, that an outline reference is added for the
+.\" TOC itself, and that pdfroff TOC relocation mode is enabled, for
+.\" the TOC output phase of document production.
+.\"
 .de TC
-.pdfsync O
-.P1
-.OP \nPDF-TOC-ONLY
-.pg@begin 1 i
-.if !\\nPHASE .tm pdfroff-option:set toc_relocation=enabled
-.if \\nOPMODE .pdf@toc
-.PX \\$1
-..
-.de pdf@toc
-.pdfhref O -T T 1 "\\*TOC"
-.pdfsync O
-..
-.de pdf@exit
-.if \\nOPMODE .pdfsync
-.pg@end-text
+.   pdfsync O
+.   P1
+.   OP \nPDF-TOC-ONLY
+.   pg@begin 1 i
+.   if !\\nPHASE .tm pdfroff-option:set toc_relocation=enabled
+.   if \\nOPMODE \{\
+.         pdfhref O -T T 1 "\\*TOC"
+.         pdfsync O
+.      \}
+.   PX \\$1
 ..
-.em pdf@exit
-.OP \nPDF-BODY-TEXT
 .
-.\" groff "ms" provides the "pg@bottom" macro, which has already
-.\" been installed as a page transition trap.  To ensure proper
-.\" mapping of "pdfhref" links which overflow the bottom of any
-.\" page, we need to install the "pdfhref" page transition hook,
-.\" as an addendum to this macro.
+.\" Initialize the default output state, for production of "body-text".
+.\"
+.OP \nPDF-BODY-TEXT
 .
-.pdfhref I -PT pg@bottom
 .\" Local Variables:
 .\" mode: nroff
 .\" End:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pic2graph/pic2graph.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pic2graph/pic2graph.1.man Changed

@@ -1,6 +1,8 @@
-.TH PIC2GRAPH @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-pic2graph \- convert a PIC diagram into a cropped image
+.TH pic2graph @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+pic2graph \- convert a
+.I pic
+diagram into a cropped image
 .
 .
 .\" ====================================================================
@@ -10,41 +12,66 @@
 .\" This documentation is released to the public domain.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_pic2graph_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY pic2graph
-.OP \-unsafe
-.OP \-format output-format
-.OP \-eqn delimiters
-.RI  convert-arguments 
+.RB  \-unsafe 
+.RB  \-format\~\c
+.IR output-format 
+.RB  \-eqn\~\c
+.IR delimiters 
+.RI  convert-argument \~.\|.\|.
 .YS
 .
+.
 .SY pic2graph
 .B \-\-help
 .YS
 .
+.
 .SY pic2graph
 .B \-v
+.
 .SY pic2graph
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I pic2graph
 reads a
-.IR @g@pic (@MAN1EXT@)
+.MR @g@pic @MAN1EXT@
 program from the standard input and writes an image file,
 by default in Portable Network Graphics (PNG) format,
 to the standard output.
 .
 It furthermore translates
-.IR @g@eqn (@MAN1EXT@)
+.MR @g@eqn @MAN1EXT@
 constructs, so it can be used for generating images of mathematical
 formulae.
 .
@@ -53,11 +80,11 @@
 The input PIC code should
 .I not
 be wrapped with the
-.B \&.PS
+.B .PS
 and
-.B \&.PE
+.BR .PE / .PF
 macros that normally guard it within
-.IR groff (@MAN1EXT@)
+.MR groff @MAN1EXT@
 documents.
 .
 .
@@ -71,7 +98,7 @@
 Arguments not recognized by
 .I pic2graph
 are passed to the ImageMagick or GraphicsMagick program
-.IR \%convert (1).
+.MR convert 1 .
 .
 .
 By specifying these, you can give your image a border,
@@ -90,11 +117,20 @@
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
 .TP
-.BI "\-eqn " delimiters
+.BI \-eqn\~ delimiters
 Use
 .I delimiters
 as the opening and closing
@@ -112,7 +148,7 @@
 .
 .
 .TP
-.BI "\-format " output-format
+.BI \-format\~ output-format
 Write the image in
 .IR output-format ,
 which must be understood by
@@ -121,11 +157,6 @@
 .
 .
 .TP
-.B \-\-help
-Display a usage message and exit.
-.
-.
-.TP
 .B \-unsafe
 Run
 .I groff
@@ -140,15 +171,8 @@
 default is to forbid this.
 .
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
-.
-.
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
@@ -168,37 +192,43 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
 .I pic2graph
 was written by
-.MT esr@\:thyrsus.com
+.MT esr@\:thyrsus\:.com
 Eric S.\& Raymond
 .ME ,
 based on a recipe by W.\& Richard Stevens.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 W.\& Richard Stevens,
-.UR http://\:www.kohala.com/\:start/\:troff/\:pic2html.html
+.UR http://\:www\:.kohala\:.com/\:start/\:troff/\:pic2html\:.html
 .I Turning PIC into HTML
 .UE
 .
 .
 .PP
-.IR eqn2graph (@MAN1EXT@),
-.IR grap2graph (@MAN1EXT@),
-.IR @g@pic (@MAN1EXT@),
-.IR @g@eqn (@MAN1EXT@),
-.IR groff (@MAN1EXT@),
-.IR \%convert (1)
+.MR eqn2graph @MAN1EXT@ ,
+.MR grap2graph @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR convert 1
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_pic2graph_1_man_C
+.do rr *groff_pic2graph_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/contrib/pic2graph/pic2graph.am -> _service:tar_scm:groff-1.23.0.tar.gz/contrib/pic2graph/pic2graph.am Changed

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345 Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/COPYRIGHT Added

@@ -0,0 +1,23 @@
+Copyright (c) 2021 Dorai Sitaram
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice (including
+the next paragraph) shall be included in all copies or
+substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/groff_rfc1345.7.man Added

@@ -0,0 +1,265 @@
+.TH groff_rfc1345 @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_rfc1345 \- special character names from RFC 1345 and Vim digraphs
+.
+.
+.\" ====================================================================
+.\" Legal Terms
+.\" ====================================================================
+.\"
+.\" Copyright (c) 2021 Dorai Sitaram
+.\"
+.\" Permission is hereby granted, free of charge, to any person
+.\" obtaining a copy of this software and associated documentation files
+.\" (the "Software"), to deal in the Software without restriction,
+.\" including without limitation the rights to use, copy, modify, merge,
+.\" publish, distribute, sublicense, and/or sell copies of the Software,
+.\" and to permit persons to whom the Software is furnished to do so,
+.\" subject to the following conditions:
+.\"
+.\" The above copyright notice and this permission notice (including the
+.\" next paragraph) shall be included in all copies or substantial
+.\" portions of the Software.
+.\"
+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+.\" NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+.\" BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+.\" ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+.\" CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+.\" SOFTWARE.
+.
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_rfc1345_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
+.
+The file
+.I rfc1345.tmac
+defines special character escape sequences for
+.MR groff @MAN7EXT@
+based on the glyph mnemonics specified in RFC 1345 and the digraph table
+of the text editor Vim.
+.
+Each escape sequence translates to a Unicode code point,
+and will render correctly if the underlying font is a Unicode font that
+covers the code point.
+.
+.
+.PP
+For example,
+.RB \lq \rsRx \rq
+is the \lqrecipe\rq or \lqprescription take\rq symbol,
+and maps to the code point U+211E.
+.
+.I groff
+lets you write it as
+.RB \lq \rsu211E \rq,
+but
+.RB \lq \rsRx \rq
+is more mnemonic.
+.
+.
+.PP
+For a list of the glyph names provided,
+please see the file
+.IR rfc1345.tmac ,
+which contains definitions of the form
+.
+.RS
+.EX
+\&.char \rsRx \rsu211E    \rs" PRESCRIPTION TAKE
+.EE
+.RE
+.
+where
+.BR .char 's
+first argument defines a
+.I groff
+special character escape sequence with a mnemonic glyph name,
+its second argument is a special character escape sequence based on the
+code point,
+and the comment describes the glyph defined.
+.
+.
+.PP
+The RFC 1345 glyph names cover a wide range of Unicode code points,
+including
+supplemental Latin,
+Greek,
+Cyrillic,
+Hebrew,
+Arabic,
+Hiragana,
+Katakana,
+and Bopomofo letters,
+punctuation,
+math notation,
+currency
+symbols,
+industrial and entertainment icons,
+and box-drawing symbols.
+.
+.
+.PP
+The Vim digraph table is practically a subset of RFC 1345
+(being limited to two-character mnemonics),
+but,
+as a newer implementation,
+adds four mnemonics not specified in the RFC
+(the horizontal ellipsis,
+the Euro sign,
+and two mappings for the rouble sign).
+.
+These have also been added to
+.IR rfc1345.tmac .
+.
+.
+.PP
+.I rfc1345.tmac
+contains a total of 1,696 glyph names.
+.
+It is not an
+error to load
+.I rfc1345.tmac
+if your font does not have all the glyphs,
+as long as it contains the glyphs that you actually use in your
+document.
+.
+.
+.PP
+The RFC 1345 mnemonics are not identical in every case to the mappings
+for special character glyph names that are built in to
+.IR groff ;
+for example,
+.RB \lq \rs<< \rq
+means the \lqmuch less than\rq sign (U+226A) when
+.I rfc1345.tmac
+is not loaded and this special character is not otherwise defined by a
+document or macro package.
+.
+.I rfc1345.tmac
+redefines
+.RB \lq \rs<< \rq
+to the \lqleft-pointing double angle quotation mark\rq (U+00AB).
+.
+See
+.MR groff_char @MAN7EXT@
+for the full list of predefined special character escape sequences.
+.
+.
+.\" ====================================================================
+.SS Usage
+.\" ====================================================================
+.
+Load the
+.I rfc1345.tmac
+file.
+.
+This can be done by either adding
+.RB \lq ".mso rfc1345.tmac" \rq
+to your document before the first use of any of the glyph names the
+macro file defines,
+or by using the
+.MR @g@troff @MAN1EXT@
+option
+.RB \lq "\-m rfc1345" \rq
+from the shell.
+.
+.
+.\" ====================================================================
+.SS Bugs
+.\" ====================================================================
+.
+As the
+.I groff
+Texinfo manual notes,
+\lqonly the current font is checked for ligatures and kerns;
+neither special fonts nor entities defined with the
+.B char
+request
+(and its siblings)
+are taken into account.\rq
+.
+Many of the characters defined in
+.I rfc1345.tmac
+are accented Latin letters,
+and will be affected by this deficiency,
+.UR https://\:savannah\:.gnu\:.org/\:bugs/\:?59932
+producing subpar typography
+.UE .
+.
+.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
+.
+.TP
+.I @MACRODIR@/\:rfc1345\:.tmac
+implements the character mappings.
+.
+.
+.\" ====================================================================
+.SH Authors
+.\" ====================================================================
+.
+.I rfc1345\:.tmac
+was contributed by
+.MT ds26gte@\:yahoo\:.com
+Dorai Sitaram
+.ME .
+.
+.
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
+.
+.UR https://\:tools\:.ietf\:.org/\:html/\:rfc1345
+RFC 1345
+.UE ,
+by Keld Simonsen,
+June 1992.
+.
+.
+.PP
+The Vim digraph table can be listed using the
+.MR vim 1
+command
+.RB \lq ":help \%digraph\-table" \rq.
+.
+.
+.PP
+.MR groff_char @MAN7EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_rfc1345_7_man_C
+.do rr *groff_groff_rfc1345_7_man_C
+.
+.
+.\" Local Variables:
+.\" fill-column: 72
+.\" mode: nroff
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/rfc1345.am Added

@@ -0,0 +1,41 @@
+# Copyright 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+rfc1345_srcdir = $(top_srcdir)/contrib/rfc1345
+rfc1345_builddir = $(top_builddir)/contrib/rfc1345
+
+man7_MANS += contrib/rfc1345/groff_rfc1345.7
+
+# files installed in $(tmacdir)
+rfc1345tmacdir = $(tmacdir)
+dist_rfc1345tmac_DATA = contrib/rfc1345/rfc1345.tmac
+
+rfc1345_TESTS= \
+  contrib/rfc1345/tests/rfc1345-smoke-test.sh
+TESTS += $(rfc1345_TESTS)
+EXTRA_DIST += $(rfc1345_TESTS)
+
+EXTRA_DIST += \
+  contrib/rfc1345/groff_rfc1345.7.man \
+  contrib/rfc1345/COPYRIGHT
+
+
+# Local Variables:
+# fill-column: 72
+# mode: makefile-automake
+# End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/rfc1345.tmac Added

@@ -0,0 +1,1705 @@
+.ig
+rfc1345.tmac
+
+Adds glyph names formed from
+- the mnemonics specified in
+  RFC 1345, https://www.rfc-editor.org/rfc/rfc1345.txt,
+  Keld Simonsen, June 1992; and
+- the digraphs ,. Eu =R =P from Vim's digraph table.
+..
+.char \!I \u00A1    \" INVERTED EXCLAMATION MARK
+.char \Ct \u00A2    \" CENT SIGN
+.char \Pd \u00A3    \" POUND SIGN
+.char \Cu \u00A4    \" CURRENCY SIGN
+.char \Ye \u00A5    \" YEN SIGN
+.char \BB \u00A6    \" BROKEN BAR
+.char \SE \u00A7    \" SECTION SIGN
+.char \': \u00A8    \" DIAERESIS
+.char \Co \u00A9    \" COPYRIGHT SIGN
+.char \-a \u00AA    \" FEMININE ORDINAL INDICATOR
+.char \<< \u00AB    \" LEFT-POINTING DOUBLE ANGLE QUOTATION MARK
+.char \NO \u00AC    \" NOT SIGN
+.char \-- \u00AD    \" SOFT HYPHEN
+.char \Rg \u00AE    \" REGISTERED SIGN
+.char \'m \u00AF    \" MACRON
+.char \DG \u00B0    \" DEGREE SIGN
+.char \+- \u00B1    \" PLUS-MINUS SIGN
+.char \2S \u00B2    \" SUPERSCRIPT TWO
+.char \3S \u00B3    \" SUPERSCRIPT THREE
+.char \'' \u00B4    \" ACUTE ACCENT
+.char \My \u00B5    \" MICRO SIGN
+.char \PI \u00B6    \" PILCROW SIGN
+.char \.M \u00B7    \" MIDDLE DOT
+.char \', \u00B8    \" CEDILLA
+.char \1S \u00B9    \" SUPERSCRIPT ONE
+.char \-o \u00BA    \" MASCULINE ORDINAL INDICATOR
+.char \>> \u00BB    \" RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK
+.char \14 \u00BC    \" VULGAR FRACTION ONE QUARTER
+.char \12 \u00BD    \" VULGAR FRACTION ONE HALF
+.char \34 \u00BE    \" VULGAR FRACTION THREE QUARTERS
+.char \?I \u00BF    \" INVERTED QUESTION MARK
+.char \A! \u00C0    \" LATIN CAPITAL LETTER A WITH GRAVE
+.char \A' \u00C1    \" LATIN CAPITAL LETTER A WITH ACUTE
+.char \A> \u00C2    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX
+.char \A? \u00C3    \" LATIN CAPITAL LETTER A WITH TILDE
+.char \A: \u00C4    \" LATIN CAPITAL LETTER A WITH DIAERESIS
+.char \AA \u00C5    \" LATIN CAPITAL LETTER A WITH RING ABOVE
+.char \AE \u00C6    \" LATIN CAPITAL LETTER AE
+.char \C, \u00C7    \" LATIN CAPITAL LETTER C WITH CEDILLA
+.char \E! \u00C8    \" LATIN CAPITAL LETTER E WITH GRAVE
+.char \E' \u00C9    \" LATIN CAPITAL LETTER E WITH ACUTE
+.char \E> \u00CA    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX
+.char \E: \u00CB    \" LATIN CAPITAL LETTER E WITH DIAERESIS
+.char \I! \u00CC    \" LATIN CAPITAL LETTER I WITH GRAVE
+.char \I' \u00CD    \" LATIN CAPITAL LETTER I WITH ACUTE
+.char \I> \u00CE    \" LATIN CAPITAL LETTER I WITH CIRCUMFLEX
+.char \I: \u00CF    \" LATIN CAPITAL LETTER I WITH DIAERESIS
+.char \D- \u00D0    \" LATIN CAPITAL LETTER ETH (Icelandic)
+.char \N? \u00D1    \" LATIN CAPITAL LETTER N WITH TILDE
+.char \O! \u00D2    \" LATIN CAPITAL LETTER O WITH GRAVE
+.char \O' \u00D3    \" LATIN CAPITAL LETTER O WITH ACUTE
+.char \O> \u00D4    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX
+.char \O? \u00D5    \" LATIN CAPITAL LETTER O WITH TILDE
+.char \O: \u00D6    \" LATIN CAPITAL LETTER O WITH DIAERESIS
+.char \*X \u00D7    \" MULTIPLICATION SIGN
+.char \O/ \u00D8    \" LATIN CAPITAL LETTER O WITH STROKE
+.char \U! \u00D9    \" LATIN CAPITAL LETTER U WITH GRAVE
+.char \U' \u00DA    \" LATIN CAPITAL LETTER U WITH ACUTE
+.char \U> \u00DB    \" LATIN CAPITAL LETTER U WITH CIRCUMFLEX
+.char \U: \u00DC    \" LATIN CAPITAL LETTER U WITH DIAERESIS
+.char \Y' \u00DD    \" LATIN CAPITAL LETTER Y WITH ACUTE
+.char \TH \u00DE    \" LATIN CAPITAL LETTER THORN (Icelandic)
+.char \ss \u00DF    \" LATIN SMALL LETTER SHARP S (German)
+.char \a! \u00E0    \" LATIN SMALL LETTER A WITH GRAVE
+.char \a' \u00E1    \" LATIN SMALL LETTER A WITH ACUTE
+.char \a> \u00E2    \" LATIN SMALL LETTER A WITH CIRCUMFLEX
+.char \a? \u00E3    \" LATIN SMALL LETTER A WITH TILDE
+.char \a: \u00E4    \" LATIN SMALL LETTER A WITH DIAERESIS
+.char \aa \u00E5    \" LATIN SMALL LETTER A WITH RING ABOVE
+.char \ae \u00E6    \" LATIN SMALL LETTER AE
+.char \c, \u00E7    \" LATIN SMALL LETTER C WITH CEDILLA
+.char \e! \u00E8    \" LATIN SMALL LETTER E WITH GRAVE
+.char \e' \u00E9    \" LATIN SMALL LETTER E WITH ACUTE
+.char \e> \u00EA    \" LATIN SMALL LETTER E WITH CIRCUMFLEX
+.char \e: \u00EB    \" LATIN SMALL LETTER E WITH DIAERESIS
+.char \i! \u00EC    \" LATIN SMALL LETTER I WITH GRAVE
+.char \i' \u00ED    \" LATIN SMALL LETTER I WITH ACUTE
+.char \i> \u00EE    \" LATIN SMALL LETTER I WITH CIRCUMFLEX
+.char \i: \u00EF    \" LATIN SMALL LETTER I WITH DIAERESIS
+.char \d- \u00F0    \" LATIN SMALL LETTER ETH (Icelandic)
+.char \n? \u00F1    \" LATIN SMALL LETTER N WITH TILDE
+.char \o! \u00F2    \" LATIN SMALL LETTER O WITH GRAVE
+.char \o' \u00F3    \" LATIN SMALL LETTER O WITH ACUTE
+.char \o> \u00F4    \" LATIN SMALL LETTER O WITH CIRCUMFLEX
+.char \o? \u00F5    \" LATIN SMALL LETTER O WITH TILDE
+.char \o: \u00F6    \" LATIN SMALL LETTER O WITH DIAERESIS
+.char \-: \u00F7    \" DIVISION SIGN
+.char \o/ \u00F8    \" LATIN SMALL LETTER O WITH STROKE
+.char \u! \u00F9    \" LATIN SMALL LETTER U WITH GRAVE
+.char \u' \u00FA    \" LATIN SMALL LETTER U WITH ACUTE
+.char \u> \u00FB    \" LATIN SMALL LETTER U WITH CIRCUMFLEX
+.char \u: \u00FC    \" LATIN SMALL LETTER U WITH DIAERESIS
+.char \y' \u00FD    \" LATIN SMALL LETTER Y WITH ACUTE
+.char \th \u00FE    \" LATIN SMALL LETTER THORN (Icelandic)
+.char \y: \u00FF    \" LATIN SMALL LETTER Y WITH DIAERESIS
+.char \A- \u0100    \" LATIN CAPITAL LETTER A WITH MACRON
+.char \a- \u0101    \" LATIN SMALL LETTER A WITH MACRON
+.char \A( \u0102    \" LATIN CAPITAL LETTER A WITH BREVE
+.char \a( \u0103    \" LATIN SMALL LETTER A WITH BREVE
+.char \A; \u0104    \" LATIN CAPITAL LETTER A WITH OGONEK
+.char \a; \u0105    \" LATIN SMALL LETTER A WITH OGONEK
+.char \C' \u0106    \" LATIN CAPITAL LETTER C WITH ACUTE
+.char \c' \u0107    \" LATIN SMALL LETTER C WITH ACUTE
+.char \C> \u0108    \" LATIN CAPITAL LETTER C WITH CIRCUMFLEX
+.char \c> \u0109    \" LATIN SMALL LETTER C WITH CIRCUMFLEX
+.char \C. \u010A    \" LATIN CAPITAL LETTER C WITH DOT ABOVE
+.char \c. \u010B    \" LATIN SMALL LETTER C WITH DOT ABOVE
+.char \C< \u010C    \" LATIN CAPITAL LETTER C WITH CARON
+.char \c< \u010D    \" LATIN SMALL LETTER C WITH CARON
+.char \D< \u010E    \" LATIN CAPITAL LETTER D WITH CARON
+.char \d< \u010F    \" LATIN SMALL LETTER D WITH CARON
+.char \D/ \u0110    \" LATIN CAPITAL LETTER D WITH STROKE
+.char \d/ \u0111    \" LATIN SMALL LETTER D WITH STROKE
+.char \E- \u0112    \" LATIN CAPITAL LETTER E WITH MACRON
+.char \e- \u0113    \" LATIN SMALL LETTER E WITH MACRON
+.char \E( \u0114    \" LATIN CAPITAL LETTER E WITH BREVE
+.char \e( \u0115    \" LATIN SMALL LETTER E WITH BREVE
+.char \E. \u0116    \" LATIN CAPITAL LETTER E WITH DOT ABOVE
+.char \e. \u0117    \" LATIN SMALL LETTER E WITH DOT ABOVE
+.char \E; \u0118    \" LATIN CAPITAL LETTER E WITH OGONEK
+.char \e; \u0119    \" LATIN SMALL LETTER E WITH OGONEK
+.char \E< \u011A    \" LATIN CAPITAL LETTER E WITH CARON
+.char \e< \u011B    \" LATIN SMALL LETTER E WITH CARON
+.char \G> \u011C    \" LATIN CAPITAL LETTER G WITH CIRCUMFLEX
+.char \g> \u011D    \" LATIN SMALL LETTER G WITH CIRCUMFLEX
+.char \G( \u011E    \" LATIN CAPITAL LETTER G WITH BREVE
+.char \g( \u011F    \" LATIN SMALL LETTER G WITH BREVE
+.char \G. \u0120    \" LATIN CAPITAL LETTER G WITH DOT ABOVE
+.char \g. \u0121    \" LATIN SMALL LETTER G WITH DOT ABOVE
+.char \G, \u0122    \" LATIN CAPITAL LETTER G WITH CEDILLA
+.char \g, \u0123    \" LATIN SMALL LETTER G WITH CEDILLA
+.char \H> \u0124    \" LATIN CAPITAL LETTER H WITH CIRCUMFLEX
+.char \h> \u0125    \" LATIN SMALL LETTER H WITH CIRCUMFLEX
+.char \H/ \u0126    \" LATIN CAPITAL LETTER H WITH STROKE
+.char \h/ \u0127    \" LATIN SMALL LETTER H WITH STROKE
+.char \I? \u0128    \" LATIN CAPITAL LETTER I WITH TILDE
+.char \i? \u0129    \" LATIN SMALL LETTER I WITH TILDE
+.char \I- \u012A    \" LATIN CAPITAL LETTER I WITH MACRON
+.char \i- \u012B    \" LATIN SMALL LETTER I WITH MACRON
+.char \I( \u012C    \" LATIN CAPITAL LETTER I WITH BREVE
+.char \i( \u012D    \" LATIN SMALL LETTER I WITH BREVE
+.char \I; \u012E    \" LATIN CAPITAL LETTER I WITH OGONEK
+.char \i; \u012F    \" LATIN SMALL LETTER I WITH OGONEK
+.char \I. \u0130    \" LATIN CAPITAL LETTER I WITH DOT ABOVE
+.char \i. \u0131    \" LATIN SMALL LETTER I DOTLESS
+.char \IJ \u0132    \" LATIN CAPITAL LIGATURE IJ
+.char \ij \u0133    \" LATIN SMALL LIGATURE IJ
+.char \J> \u0134    \" LATIN CAPITAL LETTER J WITH CIRCUMFLEX
+.char \j> \u0135    \" LATIN SMALL LETTER J WITH CIRCUMFLEX
+.char \K, \u0136    \" LATIN CAPITAL LETTER K WITH CEDILLA
+.char \k, \u0137    \" LATIN SMALL LETTER K WITH CEDILLA
+.char \kk \u0138    \" LATIN SMALL LETTER KRA (Greenlandic)
+.char \L' \u0139    \" LATIN CAPITAL LETTER L WITH ACUTE
+.char \l' \u013A    \" LATIN SMALL LETTER L WITH ACUTE
+.char \L, \u013B    \" LATIN CAPITAL LETTER L WITH CEDILLA
+.char \l, \u013C    \" LATIN SMALL LETTER L WITH CEDILLA
+.char \L< \u013D    \" LATIN CAPITAL LETTER L WITH CARON
+.char \l< \u013E    \" LATIN SMALL LETTER L WITH CARON
+.char \L. \u013F    \" LATIN CAPITAL LETTER L WITH MIDDLE DOT
+.char \l. \u0140    \" LATIN SMALL LETTER L WITH MIDDLE DOT
+.char \L/ \u0141    \" LATIN CAPITAL LETTER L WITH STROKE
+.char \l/ \u0142    \" LATIN SMALL LETTER L WITH STROKE
+.char \N' \u0143    \" LATIN CAPITAL LETTER N WITH ACUTE
+.char \n' \u0144    \" LATIN SMALL LETTER N WITH ACUTE
+.char \N, \u0145    \" LATIN CAPITAL LETTER N WITH CEDILLA
+.char \n, \u0146    \" LATIN SMALL LETTER N WITH CEDILLA
+.char \N< \u0147    \" LATIN CAPITAL LETTER N WITH CARON
+.char \n< \u0148    \" LATIN SMALL LETTER N WITH CARON
+.char \'n \u0149    \" LATIN SMALL LETTER N PRECEDED BY APOSTROPHE
+.char \NG \u014A    \" LATIN CAPITAL LETTER ENG (Lappish)
+.char \ng \u014B    \" LATIN SMALL LETTER ENG (Lappish)
+.char \O- \u014C    \" LATIN CAPITAL LETTER O WITH MACRON
+.char \o- \u014D    \" LATIN SMALL LETTER O WITH MACRON
+.char \O( \u014E    \" LATIN CAPITAL LETTER O WITH BREVE
+.char \o( \u014F    \" LATIN SMALL LETTER O WITH BREVE
+.char \O" \u0150    \" LATIN CAPITAL LETTER O WITH DOUBLE ACUTE
+.char \o" \u0151    \" LATIN SMALL LETTER O WITH DOUBLE ACUTE
+.char \OE \u0152    \" LATIN CAPITAL LIGATURE OE
+.char \oe \u0153    \" LATIN SMALL LIGATURE OE
+.char \R' \u0154    \" LATIN CAPITAL LETTER R WITH ACUTE
+.char \r' \u0155    \" LATIN SMALL LETTER R WITH ACUTE
+.char \R, \u0156    \" LATIN CAPITAL LETTER R WITH CEDILLA
+.char \r, \u0157    \" LATIN SMALL LETTER R WITH CEDILLA
+.char \R< \u0158    \" LATIN CAPITAL LETTER R WITH CARON
+.char \r< \u0159    \" LATIN SMALL LETTER R WITH CARON
+.char \S' \u015A    \" LATIN CAPITAL LETTER S WITH ACUTE
+.char \s' \u015B    \" LATIN SMALL LETTER S WITH ACUTE
+.char \S> \u015C    \" LATIN CAPITAL LETTER S WITH CIRCUMFLEX
+.char \s> \u015D    \" LATIN SMALL LETTER S WITH CIRCUMFLEX
+.char \S, \u015E    \" LATIN CAPITAL LETTER S WITH CEDILLA
+.char \s, \u015F    \" LATIN SMALL LETTER S WITH CEDILLA
+.char \S< \u0160    \" LATIN CAPITAL LETTER S WITH CARON
+.char \s< \u0161    \" LATIN SMALL LETTER S WITH CARON
+.char \T, \u0162    \" LATIN CAPITAL LETTER T WITH CEDILLA
+.char \t, \u0163    \" LATIN SMALL LETTER T WITH CEDILLA
+.char \T< \u0164    \" LATIN CAPITAL LETTER T WITH CARON
+.char \t< \u0165    \" LATIN SMALL LETTER T WITH CARON
+.char \T/ \u0166    \" LATIN CAPITAL LETTER T WITH STROKE
+.char \t/ \u0167    \" LATIN SMALL LETTER T WITH STROKE
+.char \U? \u0168    \" LATIN CAPITAL LETTER U WITH TILDE
+.char \u? \u0169    \" LATIN SMALL LETTER U WITH TILDE
+.char \U- \u016A    \" LATIN CAPITAL LETTER U WITH MACRON
+.char \u- \u016B    \" LATIN SMALL LETTER U WITH MACRON
+.char \U( \u016C    \" LATIN CAPITAL LETTER U WITH BREVE
+.char \u( \u016D    \" LATIN SMALL LETTER U WITH BREVE
+.char \U0 \u016E    \" LATIN CAPITAL LETTER U WITH RING ABOVE
+.char \u0 \u016F    \" LATIN SMALL LETTER U WITH RING ABOVE
+.char \U" \u0170    \" LATIN CAPITAL LETTER U WITH DOUBLE ACUTE
+.char \u" \u0171    \" LATIN SMALL LETTER U WITH DOUBLE ACUTE
+.char \U; \u0172    \" LATIN CAPITAL LETTER U WITH OGONEK
+.char \u; \u0173    \" LATIN SMALL LETTER U WITH OGONEK
+.char \W> \u0174    \" LATIN CAPITAL LETTER W WITH CIRCUMFLEX
+.char \w> \u0175    \" LATIN SMALL LETTER W WITH CIRCUMFLEX
+.char \Y> \u0176    \" LATIN CAPITAL LETTER Y WITH CIRCUMFLEX
+.char \y> \u0177    \" LATIN SMALL LETTER Y WITH CIRCUMFLEX
+.char \Y: \u0178    \" LATIN CAPITAL LETTER Y WITH DIAERESIS
+.char \Z' \u0179    \" LATIN CAPITAL LETTER Z WITH ACUTE
+.char \z' \u017A    \" LATIN SMALL LETTER Z WITH ACUTE
+.char \Z. \u017B    \" LATIN CAPITAL LETTER Z WITH DOT ABOVE
+.char \z. \u017C    \" LATIN SMALL LETTER Z WITH DOT ABOVE
+.char \Z< \u017D    \" LATIN CAPITAL LETTER Z WITH CARON
+.char \z< \u017E    \" LATIN SMALL LETTER Z WITH CARON
+.char \O9 \u01A0    \" LATIN CAPITAL LETTER O WITH HORN
+.char \o9 \u01A1    \" LATIN SMALL LETTER O WITH HORN
+.char \OI \u01A2    \" LATIN CAPITAL LETTER OI
+.char \oi \u01A3    \" LATIN SMALL LETTER OI
+.char \yr \u01A6    \" LATIN LETTER YR
+.char \U9 \u01AF    \" LATIN CAPITAL LETTER U WITH HORN
+.char \u9 \u01B0    \" LATIN SMALL LETTER U WITH HORN
+.char \Z/ \u01B5    \" LATIN CAPITAL LETTER Z WITH STROKE
+.char \z/ \u01B6    \" LATIN SMALL LETTER Z WITH STROKE
+.char \ED \u01B7    \" LATIN CAPITAL LETTER EZH
+.char \A< \u01CD    \" LATIN CAPITAL LETTER A WITH CARON
+.char \a< \u01CE    \" LATIN SMALL LETTER A WITH CARON
+.char \I< \u01CF    \" LATIN CAPITAL LETTER I WITH CARON
+.char \i< \u01D0    \" LATIN SMALL LETTER I WITH CARON
+.char \O< \u01D1    \" LATIN CAPITAL LETTER O WITH CARON
+.char \o< \u01D2    \" LATIN SMALL LETTER O WITH CARON
+.char \U< \u01D3    \" LATIN CAPITAL LETTER U WITH CARON
+.char \u< \u01D4    \" LATIN SMALL LETTER U WITH CARON
+.char \U:- \u01D5    \" LATIN CAPITAL LETTER U WITH DIAERESIS AND MACRON
+.char \u:- \u01D6    \" LATIN SMALL LETTER U WITH DIAERESIS AND MACRON
+.char \U:' \u01D7    \" LATIN CAPITAL LETTER U WITH DIAERESIS AND ACUTE
+.char \u:' \u01D8    \" LATIN SMALL LETTER U WITH DIAERESIS AND ACUTE
+.char \U:< \u01D9    \" LATIN CAPITAL LETTER U WITH DIAERESIS AND CARON
+.char \u:< \u01DA    \" LATIN SMALL LETTER U WITH DIAERESIS AND CARON
+.char \U:! \u01DB    \" LATIN CAPITAL LETTER U WITH DIAERESIS AND GRAVE
+.char \u:! \u01DC    \" LATIN SMALL LETTER U WITH DIAERESIS AND GRAVE
+.char \A1 \u01DE    \" LATIN CAPITAL LETTER A WITH DIAERESIS AND MACRON
+.char \a1 \u01DF    \" LATIN SMALL LETTER A WITH DIAERESIS AND MACRON
+.char \A7 \u01E0    \" LATIN CAPITAL LETTER A WITH DOT ABOVE AND MACRON
+.char \a7 \u01E1    \" LATIN SMALL LETTER A WITH DOT ABOVE AND MACRON
+.char \A3 \u01E2    \" LATIN CAPITAL LETTER AE WITH MACRON
+.char \a3 \u01E3    \" LATIN SMALL LETTER AE WITH MACRON
+.char \G/ \u01E4    \" LATIN CAPITAL LETTER G WITH STROKE
+.char \g/ \u01E5    \" LATIN SMALL LETTER G WITH STROKE
+.char \G< \u01E6    \" LATIN CAPITAL LETTER G WITH CARON
+.char \g< \u01E7    \" LATIN SMALL LETTER G WITH CARON
+.char \K< \u01E8    \" LATIN CAPITAL LETTER K WITH CARON
+.char \k< \u01E9    \" LATIN SMALL LETTER K WITH CARON
+.char \O; \u01EA    \" LATIN CAPITAL LETTER O WITH OGONEK
+.char \o; \u01EB    \" LATIN SMALL LETTER O WITH OGONEK
+.char \O1 \u01EC    \" LATIN CAPITAL LETTER O WITH OGONEK AND MACRON
+.char \o1 \u01ED    \" LATIN SMALL LETTER O WITH OGONEK AND MACRON
+.char \EZ \u01EE    \" LATIN CAPITAL LETTER EZH WITH CARON
+.char \ez \u01EF    \" LATIN SMALL LETTER EZH WITH CARON
+.char \j< \u01F0    \" LATIN SMALL LETTER J WITH CARON
+.char \G' \u01F4    \" LATIN CAPITAL LETTER G WITH ACUTE
+.char \g' \u01F5    \" LATIN SMALL LETTER G WITH ACUTE
+.char \AA' \u01FA    \" LATIN CAPITAL LETTER A WITH RING ABOVE AND ACUTE
+.char \aa' \u01FB    \" LATIN SMALL LETTER A WITH RING ABOVE AND ACUTE
+.char \AE' \u01FC    \" LATIN CAPITAL LETTER AE WITH ACUTE
+.char \ae' \u01FD    \" LATIN SMALL LETTER AE WITH ACUTE
+.char \O/' \u01FE    \" LATIN CAPITAL LETTER O WITH STROKE AND ACUTE
+.char \o/' \u01FF    \" LATIN SMALL LETTER O WITH STROKE AND ACUTE
+.char \;S \u02BF    \" MODIFIER LETTER LEFT HALF RING
+.char \'< \u02C7    \" CARON
+.char \'( \u02D8    \" BREVE
+.char \'. \u02D9    \" DOT ABOVE
+.char \'0 \u02DA    \" RING ABOVE
+.char \'; \u02DB    \" OGONEK
+.char \'" \u02DD    \" DOUBLE ACUTE ACCENT
+.char \A% \u0386    \" GREEK CAPITAL LETTER ALPHA WITH ACUTE
+.char \E% \u0388    \" GREEK CAPITAL LETTER EPSILON WITH ACUTE
+.char \Y% \u0389    \" GREEK CAPITAL LETTER ETA WITH ACUTE
+.char \I% \u038A    \" GREEK CAPITAL LETTER IOTA WITH ACUTE
+.char \O% \u038C    \" GREEK CAPITAL LETTER OMICRON WITH ACUTE
+.char \U% \u038E    \" GREEK CAPITAL LETTER UPSILON WITH ACUTE
+.char \W% \u038F    \" GREEK CAPITAL LETTER OMEGA WITH ACUTE
+.char \i3 \u0390    \" GREEK SMALL LETTER IOTA WITH ACUTE AND DIAERESIS
+.char \A* \u0391    \" GREEK CAPITAL LETTER ALPHA
+.char \B* \u0392    \" GREEK CAPITAL LETTER BETA
+.char \G* \u0393    \" GREEK CAPITAL LETTER GAMMA
+.char \D* \u0394    \" GREEK CAPITAL LETTER DELTA
+.char \E* \u0395    \" GREEK CAPITAL LETTER EPSILON
+.char \Z* \u0396    \" GREEK CAPITAL LETTER ZETA
+.char \Y* \u0397    \" GREEK CAPITAL LETTER ETA
+.char \H* \u0398    \" GREEK CAPITAL LETTER THETA
+.char \I* \u0399    \" GREEK CAPITAL LETTER IOTA
+.char \K* \u039A    \" GREEK CAPITAL LETTER KAPPA
+.char \L* \u039B    \" GREEK CAPITAL LETTER LAMDA
+.char \M* \u039C    \" GREEK CAPITAL LETTER MU
+.char \N* \u039D    \" GREEK CAPITAL LETTER NU
+.char \C* \u039E    \" GREEK CAPITAL LETTER XI
+.char \O* \u039F    \" GREEK CAPITAL LETTER OMICRON
+.char \P* \u03A0    \" GREEK CAPITAL LETTER PI
+.char \R* \u03A1    \" GREEK CAPITAL LETTER RHO
+.char \S* \u03A3    \" GREEK CAPITAL LETTER SIGMA
+.char \T* \u03A4    \" GREEK CAPITAL LETTER TAU
+.char \U* \u03A5    \" GREEK CAPITAL LETTER UPSILON
+.char \F* \u03A6    \" GREEK CAPITAL LETTER PHI
+.char \X* \u03A7    \" GREEK CAPITAL LETTER CHI
+.char \Q* \u03A8    \" GREEK CAPITAL LETTER PSI
+.char \W* \u03A9    \" GREEK CAPITAL LETTER OMEGA
+.char \J* \u03AA    \" GREEK CAPITAL LETTER IOTA WITH DIAERESIS
+.char \V* \u03AB    \" GREEK CAPITAL LETTER UPSILON WITH DIAERESIS
+.char \a% \u03AC    \" GREEK SMALL LETTER ALPHA WITH ACUTE
+.char \e% \u03AD    \" GREEK SMALL LETTER EPSILON WITH ACUTE
+.char \y% \u03AE    \" GREEK SMALL LETTER ETA WITH ACUTE
+.char \i% \u03AF    \" GREEK SMALL LETTER IOTA WITH ACUTE
+.char \u3 \u03B0    \" GREEK SMALL LETTER UPSILON WITH ACUTE AND DIAERESIS
+.char \a* \u03B1    \" GREEK SMALL LETTER ALPHA
+.char \b* \u03B2    \" GREEK SMALL LETTER BETA
+.char \g* \u03B3    \" GREEK SMALL LETTER GAMMA
+.char \d* \u03B4    \" GREEK SMALL LETTER DELTA
+.char \e* \u03B5    \" GREEK SMALL LETTER EPSILON
+.char \z* \u03B6    \" GREEK SMALL LETTER ZETA
+.char \y* \u03B7    \" GREEK SMALL LETTER ETA
+.char \h* \u03B8    \" GREEK SMALL LETTER THETA
+.char \i* \u03B9    \" GREEK SMALL LETTER IOTA
+.char \k* \u03BA    \" GREEK SMALL LETTER KAPPA
+.char \l* \u03BB    \" GREEK SMALL LETTER LAMDA
+.char \m* \u03BC    \" GREEK SMALL LETTER MU
+.char \n* \u03BD    \" GREEK SMALL LETTER NU
+.char \c* \u03BE    \" GREEK SMALL LETTER XI
+.char \o* \u03BF    \" GREEK SMALL LETTER OMICRON
+.char \p* \u03C0    \" GREEK SMALL LETTER PI
+.char \r* \u03C1    \" GREEK SMALL LETTER RHO
+.char \*s \u03C2    \" GREEK SMALL LETTER FINAL SIGMA
+.char \s* \u03C3    \" GREEK SMALL LETTER SIGMA
+.char \t* \u03C4    \" GREEK SMALL LETTER TAU
+.char \u* \u03C5    \" GREEK SMALL LETTER UPSILON
+.char \f* \u03C6    \" GREEK SMALL LETTER PHI
+.char \x* \u03C7    \" GREEK SMALL LETTER CHI
+.char \q* \u03C8    \" GREEK SMALL LETTER PSI
+.char \w* \u03C9    \" GREEK SMALL LETTER OMEGA
+.char \j* \u03CA    \" GREEK SMALL LETTER IOTA WITH DIAERESIS
+.char \v* \u03CB    \" GREEK SMALL LETTER UPSILON WITH DIAERESIS
+.char \o% \u03CC    \" GREEK SMALL LETTER OMICRON WITH ACUTE
+.char \u% \u03CD    \" GREEK SMALL LETTER UPSILON WITH ACUTE
+.char \w% \u03CE    \" GREEK SMALL LETTER OMEGA WITH ACUTE
+.char \'G \u03D8    \" GREEK NUMERAL SIGN
+.char \,G \u03D9    \" GREEK LOWER NUMERAL SIGN
+.char \T3 \u03DA    \" GREEK CAPITAL LETTER STIGMA
+.char \t3 \u03DB    \" GREEK SMALL LETTER STIGMA
+.char \M3 \u03DC    \" GREEK CAPITAL LETTER DIGAMMA
+.char \m3 \u03DD    \" GREEK SMALL LETTER DIGAMMA
+.char \K3 \u03DE    \" GREEK CAPITAL LETTER KOPPA
+.char \k3 \u03DF    \" GREEK SMALL LETTER KOPPA
+.char \P3 \u03E0    \" GREEK CAPITAL LETTER SAMPI
+.char \p3 \u03E1    \" GREEK SMALL LETTER SAMPI
+.char \'% \u03F4    \" ACUTE ACCENT AND DIAERESIS (Tonos and Dialytika)
+.char \j3 \u03F5    \" GREEK IOTA BELOW
+.char \IO \u0401    \" CYRILLIC CAPITAL LETTER IO
+.char \D% \u0402    \" CYRILLIC CAPITAL LETTER DJE (Serbocroatian)
+.char \G% \u0403    \" CYRILLIC CAPITAL LETTER GJE (Macedonian)
+.char \IE \u0404    \" CYRILLIC CAPITAL LETTER UKRAINIAN IE
+.char \DS \u0405    \" CYRILLIC CAPITAL LETTER DZE (Macedonian)
+.char \II \u0406    \" CYRILLIC CAPITAL LETTER BYELORUSSIAN-UKRAINIAN I
+.char \YI \u0407    \" CYRILLIC CAPITAL LETTER YI (Ukrainian)
+.char \J% \u0408    \" CYRILLIC CAPITAL LETTER JE
+.char \LJ \u0409    \" CYRILLIC CAPITAL LETTER LJE
+.char \NJ \u040A    \" CYRILLIC CAPITAL LETTER NJE
+.char \Ts \u040B    \" CYRILLIC CAPITAL LETTER TSHE (Serbocroatian)
+.char \KJ \u040C    \" CYRILLIC CAPITAL LETTER KJE (Macedonian)
+.char \V% \u040E    \" CYRILLIC CAPITAL LETTER SHORT U (Byelorussian)
+.char \DZ \u040F    \" CYRILLIC CAPITAL LETTER DZHE
+.char \A= \u0410    \" CYRILLIC CAPITAL LETTER A
+.char \B= \u0411    \" CYRILLIC CAPITAL LETTER BE
+.char \V= \u0412    \" CYRILLIC CAPITAL LETTER VE
+.char \G= \u0413    \" CYRILLIC CAPITAL LETTER GHE
+.char \D= \u0414    \" CYRILLIC CAPITAL LETTER DE
+.char \E= \u0415    \" CYRILLIC CAPITAL LETTER IE
+.char \Z% \u0416    \" CYRILLIC CAPITAL LETTER ZHE
+.char \Z= \u0417    \" CYRILLIC CAPITAL LETTER ZE
+.char \I= \u0418    \" CYRILLIC CAPITAL LETTER I
+.char \J= \u0419    \" CYRILLIC CAPITAL LETTER SHORT I
+.char \K= \u041A    \" CYRILLIC CAPITAL LETTER KA
+.char \L= \u041B    \" CYRILLIC CAPITAL LETTER EL
+.char \M= \u041C    \" CYRILLIC CAPITAL LETTER EM
+.char \N= \u041D    \" CYRILLIC CAPITAL LETTER EN
+.char \O= \u041E    \" CYRILLIC CAPITAL LETTER O
+.char \P= \u041F    \" CYRILLIC CAPITAL LETTER PE
+.char \R= \u0420    \" CYRILLIC CAPITAL LETTER ER
+.char \S= \u0421    \" CYRILLIC CAPITAL LETTER ES
+.char \T= \u0422    \" CYRILLIC CAPITAL LETTER TE
+.char \U= \u0423    \" CYRILLIC CAPITAL LETTER U
+.char \F= \u0424    \" CYRILLIC CAPITAL LETTER EF
+.char \H= \u0425    \" CYRILLIC CAPITAL LETTER HA
+.char \C= \u0426    \" CYRILLIC CAPITAL LETTER TSE
+.char \C% \u0427    \" CYRILLIC CAPITAL LETTER CHE
+.char \S% \u0428    \" CYRILLIC CAPITAL LETTER SHA
+.char \Sc \u0429    \" CYRILLIC CAPITAL LETTER SHCHA
+.char \=" \u042A    \" CYRILLIC CAPITAL LETTER HARD SIGN
+.char \Y= \u042B    \" CYRILLIC CAPITAL LETTER YERU
+.char \%" \u042C    \" CYRILLIC CAPITAL LETTER SOFT SIGN
+.char \JE \u042D    \" CYRILLIC CAPITAL LETTER E
+.char \JU \u042E    \" CYRILLIC CAPITAL LETTER YU
+.char \JA \u042F    \" CYRILLIC CAPITAL LETTER YA
+.char \a= \u0430    \" CYRILLIC SMALL LETTER A
+.char \b= \u0431    \" CYRILLIC SMALL LETTER BE
+.char \v= \u0432    \" CYRILLIC SMALL LETTER VE
+.char \g= \u0433    \" CYRILLIC SMALL LETTER GHE
+.char \d= \u0434    \" CYRILLIC SMALL LETTER DE
+.char \e= \u0435    \" CYRILLIC SMALL LETTER IE
+.char \z% \u0436    \" CYRILLIC SMALL LETTER ZHE
+.char \z= \u0437    \" CYRILLIC SMALL LETTER ZE
+.char \i= \u0438    \" CYRILLIC SMALL LETTER I
+.char \j= \u0439    \" CYRILLIC SMALL LETTER SHORT I
+.char \k= \u043A    \" CYRILLIC SMALL LETTER KA
+.char \l= \u043B    \" CYRILLIC SMALL LETTER EL
+.char \m= \u043C    \" CYRILLIC SMALL LETTER EM
+.char \n= \u043D    \" CYRILLIC SMALL LETTER EN
+.char \o= \u043E    \" CYRILLIC SMALL LETTER O
+.char \p= \u043F    \" CYRILLIC SMALL LETTER PE
+.char \r= \u0440    \" CYRILLIC SMALL LETTER ER
+.char \s= \u0441    \" CYRILLIC SMALL LETTER ES
+.char \t= \u0442    \" CYRILLIC SMALL LETTER TE
+.char \u= \u0443    \" CYRILLIC SMALL LETTER U
+.char \f= \u0444    \" CYRILLIC SMALL LETTER EF
+.char \h= \u0445    \" CYRILLIC SMALL LETTER HA
+.char \c= \u0446    \" CYRILLIC SMALL LETTER TSE
+.char \c% \u0447    \" CYRILLIC SMALL LETTER CHE
+.char \s% \u0448    \" CYRILLIC SMALL LETTER SHA
+.char \sc \u0449    \" CYRILLIC SMALL LETTER SHCHA
+.char \=' \u044A    \" CYRILLIC SMALL LETTER HARD SIGN
+.char \y= \u044B    \" CYRILLIC SMALL LETTER YERU
+.char \%' \u044C    \" CYRILLIC SMALL LETTER SOFT SIGN
+.char \je \u044D    \" CYRILLIC SMALL LETTER E
+.char \ju \u044E    \" CYRILLIC SMALL LETTER YU
+.char \ja \u044F    \" CYRILLIC SMALL LETTER YA
+.char \io \u0451    \" CYRILLIC SMALL LETTER IO
+.char \d% \u0452    \" CYRILLIC SMALL LETTER DJE (Serbocroatian)
+.char \g% \u0453    \" CYRILLIC SMALL LETTER GJE (Macedonian)
+.char \ie \u0454    \" CYRILLIC SMALL LETTER UKRAINIAN IE
+.char \ds \u0455    \" CYRILLIC SMALL LETTER DZE (Macedonian)
+.char \ii \u0456    \" CYRILLIC SMALL LETTER BYELORUSSIAN-UKRAINIAN I
+.char \yi \u0457    \" CYRILLIC SMALL LETTER YI (Ukrainian)
+.char \j% \u0458    \" CYRILLIC SMALL LETTER JE
+.char \lj \u0459    \" CYRILLIC SMALL LETTER LJE
+.char \nj \u045A    \" CYRILLIC SMALL LETTER NJE
+.char \ts \u045B    \" CYRILLIC SMALL LETTER TSHE (Serbocroatian)
+.char \kj \u045C    \" CYRILLIC SMALL LETTER KJE (Macedonian)
+.char \v% \u045E    \" CYRILLIC SMALL LETTER SHORT U (Byelorussian)
+.char \dz \u045F    \" CYRILLIC SMALL LETTER DZHE
+.char \Y3 \u0462    \" CYRILLIC CAPITAL LETTER YAT
+.char \y3 \u0463    \" CYRILLIC SMALL LETTER YAT
+.char \O3 \u046A    \" CYRILLIC CAPITAL LETTER BIG YUS
+.char \o3 \u046B    \" CYRILLIC SMALL LETTER BIG YUS
+.char \F3 \u0472    \" CYRILLIC CAPITAL LETTER FITA
+.char \f3 \u0473    \" CYRILLIC SMALL LETTER FITA
+.char \V3 \u0474    \" CYRILLIC CAPITAL LETTER IZHITSA
+.char \v3 \u0475    \" CYRILLIC SMALL LETTER IZHITSA
+.char \C3 \u0480    \" CYRILLIC CAPITAL LETTER KOPPA
+.char \c3 \u0481    \" CYRILLIC SMALL LETTER KOPPA
+.char \G3 \u0490    \" CYRILLIC CAPITAL LETTER GHE WITH UPTURN
+.char \g3 \u0491    \" CYRILLIC SMALL LETTER GHE WITH UPTURN
+.char \A+ \u05D0    \" HEBREW LETTER ALEF
+.char \B+ \u05D1    \" HEBREW LETTER BET
+.char \G+ \u05D2    \" HEBREW LETTER GIMEL
+.char \D+ \u05D3    \" HEBREW LETTER DALET
+.char \H+ \u05D4    \" HEBREW LETTER HE
+.char \W+ \u05D5    \" HEBREW LETTER VAV
+.char \Z+ \u05D6    \" HEBREW LETTER ZAYIN
+.char \X+ \u05D7    \" HEBREW LETTER HET
+.char \Tj \u05D8    \" HEBREW LETTER TET
+.char \J+ \u05D9    \" HEBREW LETTER YOD
+.char \K% \u05DA    \" HEBREW LETTER FINAL KAF
+.char \K+ \u05DB    \" HEBREW LETTER KAF
+.char \L+ \u05DC    \" HEBREW LETTER LAMED
+.char \M% \u05DD    \" HEBREW LETTER FINAL MEM
+.char \M+ \u05DE    \" HEBREW LETTER MEM
+.char \N% \u05DF    \" HEBREW LETTER FINAL NUN
+.char \N+ \u05E0    \" HEBREW LETTER NUN
+.char \S+ \u05E1    \" HEBREW LETTER SAMEKH
+.char \E+ \u05E2    \" HEBREW LETTER AYIN
+.char \P% \u05E3    \" HEBREW LETTER FINAL PE
+.char \P+ \u05E4    \" HEBREW LETTER PE
+.char \Zj \u05E5    \" HEBREW LETTER FINAL TSADI
+.char \ZJ \u05E6    \" HEBREW LETTER TSADI
+.char \Q+ \u05E7    \" HEBREW LETTER QOF
+.char \R+ \u05E8    \" HEBREW LETTER RESH
+.char \Sh \u05E9    \" HEBREW LETTER SHIN
+.char \T+ \u05EA    \" HEBREW LETTER TAV
+.char \,+ \u060C    \" ARABIC COMMA
+.char \;+ \u061B    \" ARABIC SEMICOLON
+.char \?+ \u061F    \" ARABIC QUESTION MARK
+.char \H' \u0621    \" ARABIC LETTER HAMZA
+.char \aM \u0622    \" ARABIC LETTER ALEF WITH MADDA ABOVE
+.char \aH \u0623    \" ARABIC LETTER ALEF WITH HAMZA ABOVE
+.char \wH \u0624    \" ARABIC LETTER WAW WITH HAMZA ABOVE
+.char \ah \u0625    \" ARABIC LETTER ALEF WITH HAMZA BELOW
+.char \yH \u0626    \" ARABIC LETTER YEH WITH HAMZA ABOVE
+.char \a+ \u0627    \" ARABIC LETTER ALEF
+.char \b+ \u0628    \" ARABIC LETTER BEH
+.char \tm \u0629    \" ARABIC LETTER TEH MARBUTA
+.char \t+ \u062A    \" ARABIC LETTER TEH
+.char \tk \u062B    \" ARABIC LETTER THEH
+.char \g+ \u062C    \" ARABIC LETTER JEEM
+.char \hk \u062D    \" ARABIC LETTER HAH
+.char \x+ \u062E    \" ARABIC LETTER KHAH
+.char \d+ \u062F    \" ARABIC LETTER DAL
+.char \dk \u0630    \" ARABIC LETTER THAL
+.char \r+ \u0631    \" ARABIC LETTER REH
+.char \z+ \u0632    \" ARABIC LETTER ZAIN
+.char \s+ \u0633    \" ARABIC LETTER SEEN
+.char \sn \u0634    \" ARABIC LETTER SHEEN
+.char \c+ \u0635    \" ARABIC LETTER SAD
+.char \dd \u0636    \" ARABIC LETTER DAD
+.char \tj \u0637    \" ARABIC LETTER TAH
+.char \zH \u0638    \" ARABIC LETTER ZAH
+.char \e+ \u0639    \" ARABIC LETTER AIN
+.char \i+ \u063A    \" ARABIC LETTER GHAIN
+.char \++ \u0640    \" ARABIC TATWEEL
+.char \f+ \u0641    \" ARABIC LETTER FEH
+.char \q+ \u0642    \" ARABIC LETTER QAF
+.char \k+ \u0643    \" ARABIC LETTER KAF
+.char \l+ \u0644    \" ARABIC LETTER LAM
+.char \m+ \u0645    \" ARABIC LETTER MEEM
+.char \n+ \u0646    \" ARABIC LETTER NOON
+.char \h+ \u0647    \" ARABIC LETTER HEH
+.char \w+ \u0648    \" ARABIC LETTER WAW
+.char \j+ \u0649    \" ARABIC LETTER ALEF MAKSURA
+.char \y+ \u064A    \" ARABIC LETTER YEH
+.char \:+ \u064B    \" ARABIC FATHATAN
+.char \"+ \u064C    \" ARABIC DAMMATAN
+.char \=+ \u064D    \" ARABIC KASRATAN
+.char \/+ \u064E    \" ARABIC FATHA
+.char \'+ \u064F    \" ARABIC DAMMA
+.char \1+ \u0650    \" ARABIC KASRA
+.char \3+ \u0651    \" ARABIC SHADDA
+.char \0+ \u0652    \" ARABIC SUKUN
+.char \aS \u0670    \" SUPERSCRIPT ARABIC LETTER ALEF
+.char \p+ \u067E    \" ARABIC LETTER PEH
+.char \v+ \u06A4    \" ARABIC LETTER VEH
+.char \gf \u06AF    \" ARABIC LETTER GAF
+.char \0a \u06F0    \" EASTERN ARABIC-INDIC DIGIT ZERO
+.char \1a \u06F1    \" EASTERN ARABIC-INDIC DIGIT ONE
+.char \2a \u06F2    \" EASTERN ARABIC-INDIC DIGIT TWO
+.char \3a \u06F3    \" EASTERN ARABIC-INDIC DIGIT THREE
+.char \4a \u06F4    \" EASTERN ARABIC-INDIC DIGIT FOUR
+.char \5a \u06F5    \" EASTERN ARABIC-INDIC DIGIT FIVE
+.char \6a \u06F6    \" EASTERN ARABIC-INDIC DIGIT SIX
+.char \7a \u06F7    \" EASTERN ARABIC-INDIC DIGIT SEVEN
+.char \8a \u06F8    \" EASTERN ARABIC-INDIC DIGIT EIGHT
+.char \9a \u06F9    \" EASTERN ARABIC-INDIC DIGIT NINE
+.char \A-0 \u1E00    \" LATIN CAPITAL LETTER A WITH RING BELOW
+.char \a-0 \u1E01    \" LATIN SMALL LETTER A WITH RING BELOW
+.char \B. \u1E02    \" LATIN CAPITAL LETTER B WITH DOT ABOVE
+.char \b. \u1E03    \" LATIN SMALL LETTER B WITH DOT ABOVE
+.char \B-. \u1E04    \" LATIN CAPITAL LETTER B WITH DOT BELOW
+.char \b-. \u1E05    \" LATIN SMALL LETTER B WITH DOT BELOW
+.char \B_ \u1E06    \" LATIN CAPITAL LETTER B WITH LINE BELOW
+.char \b_ \u1E07    \" LATIN SMALL LETTER B WITH LINE BELOW
+.char \C,' \u1E08    \" LATIN CAPITAL LETTER C WITH CEDILLA AND ACUTE
+.char \c,' \u1E09    \" LATIN SMALL LETTER C WITH CEDILLA AND ACUTE
+.char \D. \u1E0A    \" LATIN CAPITAL LETTER D WITH DOT ABOVE
+.char \d. \u1E0B    \" LATIN SMALL LETTER D WITH DOT ABOVE
+.char \D-. \u1E0C    \" LATIN CAPITAL LETTER D WITH DOT BELOW
+.char \d-. \u1E0D    \" LATIN SMALL LETTER D WITH DOT BELOW
+.char \D_ \u1E0E    \" LATIN CAPITAL LETTER D WITH LINE BELOW
+.char \d_ \u1E0F    \" LATIN SMALL LETTER D WITH LINE BELOW
+.char \D, \u1E10    \" LATIN CAPITAL LETTER D WITH CEDILLA
+.char \d, \u1E11    \" LATIN SMALL LETTER D WITH CEDILLA
+.char \D-> \u1E12    \" LATIN CAPITAL LETTER D WITH CIRCUMFLEX BELOW
+.char \d-> \u1E13    \" LATIN SMALL LETTER D WITH CIRCUMFLEX BELOW
+.char \E-! \u1E14    \" LATIN CAPITAL LETTER E WITH MACRON AND GRAVE
+.char \e-! \u1E15    \" LATIN SMALL LETTER E WITH MACRON AND GRAVE
+.char \E-' \u1E16    \" LATIN CAPITAL LETTER E WITH MACRON AND ACUTE
+.char \e-' \u1E17    \" LATIN SMALL LETTER E WITH MACRON AND ACUTE
+.char \E-> \u1E18    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX BELOW
+.char \e-> \u1E19    \" LATIN SMALL LETTER E WITH CIRCUMFLEX BELOW
+.char \E-? \u1E1A    \" LATIN CAPITAL LETTER E WITH TILDE BELOW
+.char \e-? \u1E1B    \" LATIN SMALL LETTER E WITH TILDE BELOW
+.char \E,( \u1E1C    \" LATIN CAPITAL LETTER E WITH CEDILLA AND BREVE
+.char \e,( \u1E1D    \" LATIN SMALL LETTER E WITH CEDILLA AND BREVE
+.char \F. \u1E1E    \" LATIN CAPITAL LETTER F WITH DOT ABOVE
+.char \f. \u1E1F    \" LATIN SMALL LETTER F WITH DOT ABOVE
+.char \G- \u1E20    \" LATIN CAPITAL LETTER G WITH MACRON
+.char \g- \u1E21    \" LATIN SMALL LETTER G WITH MACRON
+.char \H. \u1E22    \" LATIN CAPITAL LETTER H WITH DOT ABOVE
+.char \h. \u1E23    \" LATIN SMALL LETTER H WITH DOT ABOVE
+.char \H-. \u1E24    \" LATIN CAPITAL LETTER H WITH DOT BELOW
+.char \h-. \u1E25    \" LATIN SMALL LETTER H WITH DOT BELOW
+.char \H: \u1E26    \" LATIN CAPITAL LETTER H WITH DIAERESIS
+.char \h: \u1E27    \" LATIN SMALL LETTER H WITH DIAERESIS
+.char \H, \u1E28    \" LATIN CAPITAL LETTER H WITH CEDILLA
+.char \h, \u1E29    \" LATIN SMALL LETTER H WITH CEDILLA
+.char \H-( \u1E2A    \" LATIN CAPITAL LETTER H WITH BREVE BELOW
+.char \h-( \u1E2B    \" LATIN SMALL LETTER H WITH BREVE BELOW
+.char \I-? \u1E2C    \" LATIN CAPITAL LETTER I WITH TILDE BELOW
+.char \i-? \u1E2D    \" LATIN SMALL LETTER I WITH TILDE BELOW
+.char \I:' \u1E2E    \" LATIN CAPITAL LETTER I WITH DIAERESIS AND ACUTE
+.char \i:' \u1E2F    \" LATIN SMALL LETTER I WITH DIAERESIS AND ACUTE
+.char \K' \u1E30    \" LATIN CAPITAL LETTER K WITH ACUTE
+.char \k' \u1E31    \" LATIN SMALL LETTER K WITH ACUTE
+.char \K-. \u1E32    \" LATIN CAPITAL LETTER K WITH DOT BELOW
+.char \k-. \u1E33    \" LATIN SMALL LETTER K WITH DOT BELOW
+.char \K_ \u1E34    \" LATIN CAPITAL LETTER K WITH LINE BELOW
+.char \k_ \u1E35    \" LATIN SMALL LETTER K WITH LINE BELOW
+.char \L-. \u1E36    \" LATIN CAPITAL LETTER L WITH DOT BELOW
+.char \l-. \u1E37    \" LATIN SMALL LETTER L WITH DOT BELOW
+.char \L--. \u1E38    \" LATIN CAPITAL LETTER L WITH DOT BELOW AND MACRON
+.char \l--. \u1E39    \" LATIN SMALL LETTER L WITH DOT BELOW AND MACRON
+.char \L_ \u1E3A    \" LATIN CAPITAL LETTER L WITH LINE BELOW
+.char \l_ \u1E3B    \" LATIN SMALL LETTER L WITH LINE BELOW
+.char \L-> \u1E3C    \" LATIN CAPITAL LETTER L WITH CIRCUMFLEX BELOW
+.char \l-> \u1E3D    \" LATIN SMALL LETTER L WITH CIRCUMFLEX BELOW
+.char \M' \u1E3E    \" LATIN CAPITAL LETTER M WITH ACUTE
+.char \m' \u1E3F    \" LATIN SMALL LETTER M WITH ACUTE
+.char \M. \u1E40    \" LATIN CAPITAL LETTER M WITH DOT ABOVE
+.char \m. \u1E41    \" LATIN SMALL LETTER M WITH DOT ABOVE
+.char \M-. \u1E42    \" LATIN CAPITAL LETTER M WITH DOT BELOW
+.char \m-. \u1E43    \" LATIN SMALL LETTER M WITH DOT BELOW
+.char \N. \u1E44    \" LATIN CAPITAL LETTER N WITH DOT ABOVE
+.char \n. \u1E45    \" LATIN SMALL LETTER N WITH DOT ABOVE
+.char \N-. \u1E46    \" LATIN CAPITAL LETTER N WITH DOT BELOW
+.char \n-. \u1E47    \" LATIN SMALL LETTER N WITH DOT BELOW
+.char \N_ \u1E48    \" LATIN CAPITAL LETTER N WITH LINE BELOW
+.char \n_ \u1E49    \" LATIN SMALL LETTER N WITH LINE BELOW
+.char \N-> \u1E4A    \" LATIN CAPITAL LETTER N WITH CIRCUMFLEX BELOW
+.char \N-> \u1E4B    \" LATIN SMALL LETTER N WITH CIRCUMFLEX BELOW
+.char \O?' \u1E4C    \" LATIN CAPITAL LETTER O WITH TILDE AND ACUTE
+.char \o?' \u1E4D    \" LATIN SMALL LETTER O WITH TILDE AND ACUTE
+.char \O?: \u1E4E    \" LATIN CAPITAL LETTER O WITH TILDE AND DIAERESIS
+.char \o?: \u1E4F    \" LATIN SMALL LETTER O WITH TILDE AND DIAERESIS
+.char \O-! \u1E50    \" LATIN CAPITAL LETTER O WITH MACRON AND GRAVE
+.char \o-! \u1E51    \" LATIN SMALL LETTER O WITH MACRON AND GRAVE
+.char \O-' \u1E52    \" LATIN CAPITAL LETTER O WITH MACRON AND ACUTE
+.char \o-' \u1E53    \" LATIN SMALL LETTER O WITH MACRON AND ACUTE
+.char \P' \u1E54    \" LATIN CAPITAL LETTER P WITH ACUTE
+.char \p' \u1E55    \" LATIN SMALL LETTER P WITH ACUTE
+.char \P. \u1E56    \" LATIN CAPITAL LETTER P WITH DOT ABOVE
+.char \p. \u1E57    \" LATIN SMALL LETTER P WITH DOT ABOVE
+.char \R. \u1E58    \" LATIN CAPITAL LETTER R WITH DOT ABOVE
+.char \r. \u1E59    \" LATIN SMALL LETTER R WITH DOT ABOVE
+.char \R-. \u1E5A    \" LATIN CAPITAL LETTER R WITH DOT BELOW
+.char \r-. \u1E5B    \" LATIN SMALL LETTER R WITH DOT BELOW
+.char \R--. \u1E5C    \" LATIN CAPITAL LETTER R WITH DOT BELOW AND MACRON
+.char \r--. \u1E5D    \" LATIN SMALL LETTER R WITH DOT BELOW AND MACRON
+.char \R_ \u1E5E    \" LATIN CAPITAL LETTER R WITH LINE BELOW
+.char \r_ \u1E5F    \" LATIN SMALL LETTER R WITH LINE BELOW
+.char \S. \u1E60    \" LATIN CAPITAL LETTER S WITH DOT ABOVE
+.char \s. \u1E61    \" LATIN SMALL LETTER S WITH DOT ABOVE
+.char \S-. \u1E62    \" LATIN CAPITAL LETTER S WITH DOT BELOW
+.char \s-. \u1E63    \" LATIN SMALL LETTER S WITH DOT BELOW
+.char \S'. \u1E64    \" LATIN CAPITAL LETTER S WITH ACUTE AND DOT ABOVE
+.char \s'. \u1E65    \" LATIN SMALL LETTER S WITH ACUTE AND DOT ABOVE
+.char \S<. \u1E66    \" LATIN CAPITAL LETTER S WITH CARON AND DOT ABOVE
+.char \s<. \u1E67    \" LATIN SMALL LETTER S WITH CARON AND DOT ABOVE
+.char \S.-. \u1E68    \" LATIN CAPITAL LETTER S WITH DOT BELOW AND DOT ABOVE
+.char \S.-. \u1E69    \" LATIN SMALL LETTER S WITH DOT BELOW AND DOT ABOVE
+.char \T. \u1E6A    \" LATIN CAPITAL LETTER T WITH DOT ABOVE
+.char \t. \u1E6B    \" LATIN SMALL LETTER T WITH DOT ABOVE
+.char \T-. \u1E6C    \" LATIN CAPITAL LETTER T WITH DOT BELOW
+.char \t-. \u1E6D    \" LATIN SMALL LETTER T WITH DOT BELOW
+.char \T_ \u1E6E    \" LATIN CAPITAL LETTER T WITH LINE BELOW
+.char \t_ \u1E6F    \" LATIN SMALL LETTER T WITH LINE BELOW
+.char \T-> \u1E70    \" LATIN CAPITAL LETTER T WITH CIRCUMFLEX BELOW
+.char \t-> \u1E71    \" LATIN SMALL LETTER T WITH CIRCUMFLEX BELOW
+.char \U--: \u1E72    \" LATIN CAPITAL LETTER U WITH DIAERESIS BELOW
+.char \u--: \u1E73    \" LATIN SMALL LETTER U WITH DIAERESIS BELOW
+.char \U-? \u1E74    \" LATIN CAPITAL LETTER U WITH TILDE BELOW
+.char \u-? \u1E75    \" LATIN SMALL LETTER U WITH TILDE BELOW
+.char \U-> \u1E76    \" LATIN CAPITAL LETTER U WITH CIRCUMFLEX BELOW
+.char \u-> \u1E77    \" LATIN SMALL LETTER U WITH CIRCUMFLEX BELOW
+.char \U?' \u1E78    \" LATIN CAPITAL LETTER U WITH TILDE AND ACUTE
+.char \u?' \u1E79    \" LATIN SMALL LETTER U WITH TILDE AND ACUTE
+.char \U-: \u1E7A    \" LATIN CAPITAL LETTER U WITH MACRON AND DIAERESIS
+.char \u-: \u1E7B    \" LATIN SMALL LETTER U WITH MACRON AND DIAERESIS
+.char \V? \u1E7C    \" LATIN CAPITAL LETTER V WITH TILDE
+.char \v? \u1E7D    \" LATIN SMALL LETTER V WITH TILDE
+.char \V-. \u1E7E    \" LATIN CAPITAL LETTER V WITH DOT BELOW
+.char \v-. \u1E7F    \" LATIN SMALL LETTER V WITH DOT BELOW
+.char \W! \u1E80    \" LATIN CAPITAL LETTER W WITH GRAVE
+.char \w! \u1E81    \" LATIN SMALL LETTER W WITH GRAVE
+.char \W' \u1E82    \" LATIN CAPITAL LETTER W WITH ACUTE
+.char \w' \u1E83    \" LATIN SMALL LETTER W WITH ACUTE
+.char \W: \u1E84    \" LATIN CAPITAL LETTER W WITH DIAERESIS
+.char \w: \u1E85    \" LATIN SMALL LETTER W WITH DIAERESIS
+.char \W. \u1E86    \" LATIN CAPITAL LETTER W WITH DOT ABOVE
+.char \w. \u1E87    \" LATIN SMALL LETTER W WITH DOT ABOVE
+.char \W-. \u1E88    \" LATIN CAPITAL LETTER W WITH DOT BELOW
+.char \w-. \u1E89    \" LATIN SMALL LETTER W WITH DOT BELOW
+.char \X. \u1E8A    \" LATIN CAPITAL LETTER X WITH DOT ABOVE
+.char \x. \u1E8B    \" LATIN SMALL LETTER X WITH DOT ABOVE
+.char \X: \u1E8C    \" LATIN CAPITAL LETTER X WITH DIAERESIS
+.char \x: \u1E8D    \" LATIN SMALL LETTER X WITH DIAERESIS
+.char \Y. \u1E8E    \" LATIN CAPITAL LETTER Y WITH DOT ABOVE
+.char \y. \u1E8F    \" LATIN SMALL LETTER Y WITH DOT ABOVE
+.char \Z> \u1E90    \" LATIN CAPITAL LETTER Z WITH CIRCUMFLEX
+.char \z> \u1E91    \" LATIN SMALL LETTER Z WITH CIRCUMFLEX
+.char \Z-. \u1E92    \" LATIN CAPITAL LETTER Z WITH DOT BELOW
+.char \z-. \u1E93    \" LATIN SMALL LETTER Z WITH DOT BELOW
+.char \Z_ \u1E94    \" LATIN CAPITAL LETTER Z WITH LINE BELOW
+.char \z_ \u1E95    \" LATIN SMALL LETTER Z WITH LINE BELOW
+.char \h_ \u1E96    \" LATIN SMALL LETTER H WITH LINE BELOW
+.char \t: \u1E97    \" LATIN SMALL LETTER T WITH DIAERESIS
+.char \w0 \u1E98    \" LATIN SMALL LETTER W WITH RING ABOVE
+.char \y0 \u1E99    \" LATIN SMALL LETTER Y WITH RING ABOVE
+.char \A-. \u1EA0    \" LATIN CAPITAL LETTER A WITH DOT BELOW
+.char \a-. \u1EA1    \" LATIN SMALL LETTER A WITH DOT BELOW
+.char \A2 \u1EA2    \" LATIN CAPITAL LETTER A WITH HOOK ABOVE
+.char \a2 \u1EA3    \" LATIN SMALL LETTER A WITH HOOK ABOVE
+.char \A>' \u1EA4    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX AND ACUTE
+.char \a>' \u1EA5    \" LATIN SMALL LETTER A WITH CIRCUMFLEX AND ACUTE
+.char \A>! \u1EA6    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX AND GRAVE
+.char \a>! \u1EA7    \" LATIN SMALL LETTER A WITH CIRCUMFLEX AND GRAVE
+.char \A>2 \u1EA8    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX AND HOOK ABOVE
+.char \a>2 \u1EA9    \" LATIN SMALL LETTER A WITH CIRCUMFLEX AND HOOK ABOVE
+.char \A>? \u1EAA    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX AND TILDE
+.char \a>? \u1EAB    \" LATIN SMALL LETTER A WITH CIRCUMFLEX AND TILDE
+.char \A>-. \u1EAC    \" LATIN CAPITAL LETTER A WITH CIRCUMFLEX AND DOT BELOW
+.char \a>-. \u1EAD    \" LATIN SMALL LETTER A WITH CIRCUMFLEX AND DOT BELOW
+.char \A(' \u1EAE    \" LATIN CAPITAL LETTER A WITH BREVE AND ACUTE
+.char \a(' \u1EAF    \" LATIN SMALL LETTER A WITH BREVE AND ACUTE
+.char \A(! \u1EB0    \" LATIN CAPITAL LETTER A WITH BREVE AND GRAVE
+.char \a(! \u1EB1    \" LATIN SMALL LETTER A WITH BREVE AND GRAVE
+.char \A(2 \u1EB2    \" LATIN CAPITAL LETTER A WITH BREVE AND HOOK ABOVE
+.char \a(2 \u1EB3    \" LATIN SMALL LETTER A WITH BREVE AND HOOK ABOVE
+.char \A(? \u1EB4    \" LATIN CAPITAL LETTER A WITH BREVE AND TILDE
+.char \a(? \u1EB5    \" LATIN SMALL LETTER A WITH BREVE AND TILDE
+.char \A(-. \u1EB6    \" LATIN CAPITAL LETTER A WITH BREVE AND DOT BELOW
+.char \a(-. \u1EB7    \" LATIN SMALL LETTER A WITH BREVE AND DOT BELOW
+.char \E-. \u1EB8    \" LATIN CAPITAL LETTER E WITH DOT BELOW
+.char \e-. \u1EB9    \" LATIN SMALL LETTER E WITH DOT BELOW
+.char \E2 \u1EBA    \" LATIN CAPITAL LETTER E WITH HOOK ABOVE
+.char \e2 \u1EBB    \" LATIN SMALL LETTER E WITH HOOK ABOVE
+.char \E? \u1EBC    \" LATIN CAPITAL LETTER E WITH TILDE
+.char \e? \u1EBD    \" LATIN SMALL LETTER E WITH TILDE
+.char \E>' \u1EBE    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND ACUTE
+.char \e>' \u1EBF    \" LATIN SMALL LETTER E WITH CIRCUMFLEX AND ACUTE
+.char \E>! \u1EC0    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND GRAVE
+.char \e>! \u1EC1    \" LATIN SMALL LETTER E WITH CIRCUMFLEX AND GRAVE
+.char \E>2 \u1EC2    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE
+.char \e>2 \u1EC3    \" LATIN SMALL LETTER E WITH CIRCUMFLEX AND HOOK ABOVE
+.char \E>? \u1EC4    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND TILDE
+.char \e>? \u1EC5    \" LATIN SMALL LETTER E WITH CIRCUMFLEX AND TILDE
+.char \E>-. \u1EC6    \" LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND DOT BELOW
+.char \e>-. \u1EC7    \" LATIN SMALL LETTER E WITH CIRCUMFLEX AND DOT BELOW
+.char \I2 \u1EC8    \" LATIN CAPITAL LETTER I WITH HOOK ABOVE
+.char \i2 \u1EC9    \" LATIN SMALL LETTER I WITH HOOK ABOVE
+.char \I-. \u1ECA    \" LATIN CAPITAL LETTER I WITH DOT BELOW
+.char \i-. \u1ECB    \" LATIN SMALL LETTER I WITH DOT BELOW
+.char \O-. \u1ECC    \" LATIN CAPITAL LETTER O WITH DOT BELOW
+.char \o-. \u1ECD    \" LATIN SMALL LETTER O WITH DOT BELOW
+.char \O2 \u1ECE    \" LATIN CAPITAL LETTER O WITH HOOK ABOVE
+.char \o2 \u1ECF    \" LATIN SMALL LETTER O WITH HOOK ABOVE
+.char \O>' \u1ED0    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX AND ACUTE
+.char \o>' \u1ED1    \" LATIN SMALL LETTER O WITH CIRCUMFLEX AND ACUTE
+.char \O>! \u1ED2    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX AND GRAVE
+.char \o>! \u1ED3    \" LATIN SMALL LETTER O WITH CIRCUMFLEX AND GRAVE
+.char \O>2 \u1ED4    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX AND HOOK ABOVE
+.char \o>2 \u1ED5    \" LATIN SMALL LETTER O WITH CIRCUMFLEX AND HOOK ABOVE
+.char \O>? \u1ED6    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX AND TILDE
+.char \o>? \u1ED7    \" LATIN SMALL LETTER O WITH CIRCUMFLEX AND TILDE
+.char \O>-. \u1ED8    \" LATIN CAPITAL LETTER O WITH CIRCUMFLEX AND DOT BELOW
+.char \o>-. \u1ED9    \" LATIN SMALL LETTER O WITH CIRCUMFLEX AND DOT BELOW
+.char \O9' \u1EDA    \" LATIN CAPITAL LETTER O WITH HORN AND ACUTE
+.char \o9' \u1EDB    \" LATIN SMALL LETTER O WITH HORN AND ACUTE
+.char \O9! \u1EDC    \" LATIN CAPITAL LETTER O WITH HORN AND GRAVE
+.char \o9! \u1EDD    \" LATIN SMALL LETTER O WITH HORN AND GRAVE
+.char \O92 \u1EDE    \" LATIN CAPITAL LETTER O WITH HORN AND HOOK ABOVE
+.char \o92 \u1EDF    \" LATIN SMALL LETTER O WITH HORN AND HOOK ABOVE
+.char \O9? \u1EE0    \" LATIN CAPITAL LETTER O WITH HORN AND TILDE
+.char \o9? \u1EE1    \" LATIN SMALL LETTER O WITH HORN AND TILDE
+.char \O9-. \u1EE2    \" LATIN CAPITAL LETTER O WITH HORN AND DOT BELOW
+.char \o9-. \u1EE3    \" LATIN SMALL LETTER O WITH HORN AND DOT BELOW
+.char \U-. \u1EE4    \" LATIN CAPITAL LETTER U WITH DOT BELOW
+.char \u-. \u1EE5    \" LATIN SMALL LETTER U WITH DOT BELOW
+.char \U2 \u1EE6    \" LATIN CAPITAL LETTER U WITH HOOK ABOVE
+.char \u2 \u1EE7    \" LATIN SMALL LETTER U WITH HOOK ABOVE
+.char \U9' \u1EE8    \" LATIN CAPITAL LETTER U WITH HORN AND ACUTE
+.char \u9' \u1EE9    \" LATIN SMALL LETTER U WITH HORN AND ACUTE
+.char \U9! \u1EEA    \" LATIN CAPITAL LETTER U WITH HORN AND GRAVE
+.char \u9! \u1EEB    \" LATIN SMALL LETTER U WITH HORN AND GRAVE
+.char \U92 \u1EEC    \" LATIN CAPITAL LETTER U WITH HORN AND HOOK ABOVE
+.char \u92 \u1EED    \" LATIN SMALL LETTER U WITH HORN AND HOOK ABOVE
+.char \U9? \u1EEE    \" LATIN CAPITAL LETTER U WITH HORN AND TILDE
+.char \u9? \u1EEF    \" LATIN SMALL LETTER U WITH HORN AND TILDE
+.char \U9-. \u1EF0    \" LATIN CAPITAL LETTER U WITH HORN AND DOT BELOW
+.char \u9-. \u1EF1    \" LATIN SMALL LETTER U WITH HORN AND DOT BELOW
+.char \Y! \u1EF2    \" LATIN CAPITAL LETTER Y WITH GRAVE
+.char \y! \u1EF3    \" LATIN SMALL LETTER Y WITH GRAVE
+.char \Y-. \u1EF4    \" LATIN CAPITAL LETTER Y WITH DOT BELOW
+.char \y-. \u1EF5    \" LATIN SMALL LETTER Y WITH DOT BELOW
+.char \Y2 \u1EF6    \" LATIN CAPITAL LETTER Y WITH HOOK ABOVE
+.char \y2 \u1EF7    \" LATIN SMALL LETTER Y WITH HOOK ABOVE
+.char \Y? \u1EF8    \" LATIN CAPITAL LETTER Y WITH TILDE
+.char \y? \u1EF9    \" LATIN SMALL LETTER Y WITH TILDE
+.char \;' \u1F00    \" GREEK DASIA AND ACUTE ACCENT
+.char \,' \u1F01    \" GREEK PSILI AND ACUTE ACCENT
+.char \;! \u1F02    \" GREEK DASIA AND VARIA
+.char \,! \u1F03    \" GREEK PSILI AND VARIA
+.char \?; \u1F04    \" GREEK DASIA AND PERISPOMENI
+.char \?, \u1F05    \" GREEK PSILI AND PERISPOMENI
+.char \!: \u1F06    \" GREEK DIAERESIS AND VARIA
+.char \?: \u1F07    \" GREEK DIAERESIS AND PERISPOMENI
+.char \1N \u2002    \" EN SPACE
+.char \1M \u2003    \" EM SPACE
+.char \3M \u2004    \" THREE-PER-EM SPACE
+.char \4M \u2005    \" FOUR-PER-EM SPACE
+.char \6M \u2006    \" SIX-PER-EM SPACE
+.char \1T \u2009    \" THIN SPACE
+.char \1H \u200A    \" HAIR SPACE
+.char \-1 \u2010    \" HYPHEN
+.char \-N \u2013    \" EN DASH
+.char \-M \u2014    \" EM DASH
+.char \-3 \u2015    \" HORIZONTAL BAR
+.char \!2 \u2016    \" DOUBLE VERTICAL LINE
+.char \=2 \u2017    \" DOUBLE LOW LINE
+.char \'6 \u2018    \" LEFT SINGLE QUOTATION MARK
+.char \'9 \u2019    \" RIGHT SINGLE QUOTATION MARK
+.char \.9 \u201A    \" SINGLE LOW-9 QUOTATION MARK
+.char \9' \u201B    \" SINGLE HIGH-REVERSED-9 QUOTATION MARK
+.char \"6 \u201C    \" LEFT DOUBLE QUOTATION MARK
+.char \"9 \u201D    \" RIGHT DOUBLE QUOTATION MARK
+.char \:9 \u201E    \" DOUBLE LOW-9 QUOTATION MARK
+.char \9" \u201F    \" DOUBLE HIGH-REVERSED-9 QUOTATION MARK
+.char \/- \u2020    \" DAGGER
+.char \/= \u2021    \" DOUBLE DAGGER
+.char \.. \u2025    \" TWO DOT LEADER
+.char \,. \u2026    \" HORIZONTAL ELLIPSIS (Vim)
+.char \%0 \u2030    \" PER MILLE SIGN
+.char \1' \u2032    \" PRIME
+.char \2' \u2033    \" DOUBLE PRIME
+.char \3' \u2034    \" TRIPLE PRIME
+.char \1" \u2035    \" REVERSED PRIME
+.char \2" \u2036    \" REVERSED DOUBLE PRIME
+.char \3" \u2037    \" REVERSED TRIPLE PRIME
+.char \Ca \u2038    \" CARET
+.char \<1 \u2039    \" SINGLE LEFT-POINTING ANGLE QUOTATION MARK
+.char \>1 \u203A    \" SINGLE RIGHT-POINTING ANGLE QUOTATION MARK
+.char \:X \u203B    \" REFERENCE MARK
+.char \!*2 \u203C    \" DOUBLE EXCLAMATION MARK
+.char \'- \u203E    \" OVERLINE
+.char \/f \u2044    \" FRACTION SLASH
+.char \0S \u2070    \" SUPERSCRIPT DIGIT ZERO
+.char \4S \u2074    \" SUPERSCRIPT DIGIT FOUR
+.char \5S \u2075    \" SUPERSCRIPT DIGIT FIVE
+.char \6S \u2076    \" SUPERSCRIPT DIGIT SIX
+.char \7S \u2077    \" SUPERSCRIPT DIGIT SEVEN
+.char \8S \u2078    \" SUPERSCRIPT DIGIT EIGHT
+.char \9S \u2079    \" SUPERSCRIPT DIGIT NINE
+.char \+S \u207A    \" SUPERSCRIPT PLUS SIGN
+.char \-S \u207B    \" SUPERSCRIPT MINUS
+.char \=S \u207C    \" SUPERSCRIPT EQUALS SIGN
+.char $S \u207D    \" SUPERSCRIPT LEFT PARENTHESIS
+.char $S \u207E    \" SUPERSCRIPT RIGHT PARENTHESIS
+.char \nS \u207F    \" SUPERSCRIPT LATIN SMALL LETTER N
+.char \0s \u2080    \" SUBSCRIPT DIGIT ZERO
+.char \1s \u2081    \" SUBSCRIPT DIGIT ONE
+.char \2s \u2082    \" SUBSCRIPT DIGIT TWO
+.char \3s \u2083    \" SUBSCRIPT DIGIT THREE
+.char \4s \u2084    \" SUBSCRIPT DIGIT FOUR
+.char \5s \u2085    \" SUBSCRIPT DIGIT FIVE
+.char \6s \u2086    \" SUBSCRIPT DIGIT SIX
+.char \7s \u2087    \" SUBSCRIPT DIGIT SEVEN
+.char \8s \u2088    \" SUBSCRIPT DIGIT EIGHT
+.char \9s \u2089    \" SUBSCRIPT DIGIT NINE
+.char \+s \u208A    \" SUBSCRIPT PLUS SIGN
+.char \-s \u208B    \" SUBSCRIPT MINUS
+.char \=s \u208C    \" SUBSCRIPT EQUALS SIGN
+.char $s \u208D    \" SUBSCRIPT LEFT PARENTHESIS
+.char $s \u208E    \" SUBSCRIPT RIGHT PARENTHESIS
+.char \Li \u20A4    \" LIRA SIGN
+.char \Pt \u20A7    \" PESETA SIGN
+.char \W= \u20A9    \" WON SIGN
+.char \Eu \u20AC    \" EURO SIGN (Vim)
+.char \=R \u20BD    \" ROUBLE SIGN (Vim)
+.char \=P \u20BD    \" ROUBLE SIGN (Vim)
+.char \oC \u2103    \" DEGREE CENTIGRADE
+.char \co \u2105    \" CARE OF
+.char \oF \u2109    \" DEGREE FAHRENHEIT
+.char \N0 \u2116    \" NUMERO SIGN
+.char \PO \u2117    \" SOUND RECORDING COPYRIGHT
+.char \Rx \u211E    \" PRESCRIPTION TAKE
+.char \SM \u2120    \" SERVICE MARK
+.char \TM \u2122    \" TRADE MARK SIGN
+.char \Om \u2126    \" OHM SIGN
+.char \AO \u212B    \" ANGSTROEM SIGN
+.char \13 \u2153    \" VULGAR FRACTION ONE THIRD
+.char \23 \u2154    \" VULGAR FRACTION TWO THIRDS
+.char \15 \u2155    \" VULGAR FRACTION ONE FIFTH
+.char \25 \u2156    \" VULGAR FRACTION TWO FIFTHS
+.char \35 \u2157    \" VULGAR FRACTION THREE FIFTHS
+.char \45 \u2158    \" VULGAR FRACTION FOUR FIFTHS
+.char \16 \u2159    \" VULGAR FRACTION ONE SIXTH
+.char \56 \u215A    \" VULGAR FRACTION FIVE SIXTHS
+.char \18 \u215B    \" VULGAR FRACTION ONE EIGHTH
+.char \38 \u215C    \" VULGAR FRACTION THREE EIGHTHS
+.char \58 \u215D    \" VULGAR FRACTION FIVE EIGHTHS
+.char \78 \u215E    \" VULGAR FRACTION SEVEN EIGHTHS
+.char \1R \u2160    \" ROMAN NUMERAL ONE
+.char \2R \u2161    \" ROMAN NUMERAL TWO
+.char \3R \u2162    \" ROMAN NUMERAL THREE
+.char \4R \u2163    \" ROMAN NUMERAL FOUR
+.char \5R \u2164    \" ROMAN NUMERAL FIVE
+.char \6R \u2165    \" ROMAN NUMERAL SIX
+.char \7R \u2166    \" ROMAN NUMERAL SEVEN
+.char \8R \u2167    \" ROMAN NUMERAL EIGHT
+.char \9R \u2168    \" ROMAN NUMERAL NINE
+.char \aR \u2169    \" ROMAN NUMERAL TEN
+.char \bR \u216A    \" ROMAN NUMERAL ELEVEN
+.char \cR \u216B    \" ROMAN NUMERAL TWELVE
+.char \50R \u216C    \" ROMAN NUMERAL FIFTY
+.char \100R \u216D    \" ROMAN NUMERAL ONE HUNDRED
+.char \500R \u216E    \" ROMAN NUMERAL FIVE HUNDRED
+.char \1000R \u216F    \" ROMAN NUMERAL ONE THOUSAND
+.char \1r \u2170    \" SMALL ROMAN NUMERAL ONE
+.char \2r \u2171    \" SMALL ROMAN NUMERAL TWO
+.char \3r \u2172    \" SMALL ROMAN NUMERAL THREE
+.char \4r \u2173    \" SMALL ROMAN NUMERAL FOUR
+.char \5r \u2174    \" SMALL ROMAN NUMERAL FIVE
+.char \6r \u2175    \" SMALL ROMAN NUMERAL SIX
+.char \7r \u2176    \" SMALL ROMAN NUMERAL SEVEN
+.char \8r \u2177    \" SMALL ROMAN NUMERAL EIGHT
+.char \9r \u2178    \" SMALL ROMAN NUMERAL NINE
+.char \ar \u2179    \" SMALL ROMAN NUMERAL TEN
+.char \br \u217A    \" SMALL ROMAN NUMERAL ELEVEN
+.char \cr \u217B    \" SMALL ROMAN NUMERAL TWELVE
+.char \50r \u217C    \" SMALL ROMAN NUMERAL FIFTY
+.char \100r \u217D    \" SMALL ROMAN NUMERAL ONE HUNDRED
+.char \500r \u217E    \" SMALL ROMAN NUMERAL FIVE HUNDRED
+.char \1000r \u217F    \" SMALL ROMAN NUMERAL ONE THOUSAND
+.char \1000RCD \u2180    \" ROMAN NUMERAL ONE THOUSAND C D
+.char \5000R \u2181    \" ROMAN NUMERAL FIVE THOUSAND
+.char \10000R \u2182    \" ROMAN NUMERAL TEN THOUSAND
+.char \<- \u2190    \" LEFTWARDS ARROW
+.char \-! \u2191    \" UPWARDS ARROW
+.char \-> \u2192    \" RIGHTWARDS ARROW
+.char \-v \u2193    \" DOWNWARDS ARROW
+.char \<> \u2194    \" LEFT RIGHT ARROW
+.char \UD \u2195    \" UP DOWN ARROW
+.char \<!! \u2196    \" NORTH WEST ARROW
+.char \//> \u2197    \" NORTH EAST ARROW
+.char \!!> \u2198    \" SOUTH EAST ARROW
+.char \<// \u2199    \" SOUTH WEST ARROW
+.char \<= \u21D0    \" LEFTWARDS DOUBLE ARROW
+.char \=> \u21D2    \" RIGHTWARDS DOUBLE ARROW
+.char \== \u21D4    \" LEFT RIGHT DOUBLE ARROW
+.char \FA \u2200    \" FOR ALL
+.char \dP \u2202    \" PARTIAL DIFFERENTIAL
+.char \TE \u2203    \" THERE EXISTS
+.char \/0 \u2205    \" EMPTY SET
+.char \DE \u2206    \" INCREMENT
+.char \NB \u2207    \" NABLA
+.char $- \u2208    \" ELEMENT OF
+.char \-) \u220B    \" CONTAINS AS MEMBER
+.char \*P \u220F    \" N-ARY PRODUCT
+.char \+Z \u2211    \" N-ARY SUMMATION
+.char \-2 \u2212    \" MINUS SIGN
+.char \-+ \u2213    \" MINUS-OR-PLUS SIGN
+.char \*- \u2217    \" ASTERISK OPERATOR
+.char \Ob \u2218    \" RING OPERATOR
+.char \Sb \u2219    \" BULLET OPERATOR
+.char \RT \u221A    \" SQUARE ROOT
+.char \0( \u221D    \" PROPORTIONAL TO
+.char \00 \u221E    \" INFINITY
+.char \-L \u221F    \" RIGHT ANGLE
+.char \-V \u2220    \" ANGLE
+.char \PP \u2225    \" PARALLEL TO
+.char \AN \u2227    \" LOGICAL AND
+.char \OR \u2228    \" LOGICAL OR
+.char \(U \u2229    \" INTERSECTION
+.char $U \u222A    \" UNION
+.char \In \u222B    \" INTEGRAL
+.char \DI \u222C    \" DOUBLE INTEGRAL
+.char \Io \u222E    \" CONTOUR INTEGRAL
+.char \.: \u2234    \" THEREFORE
+.char \:. \u2235    \" BECAUSE
+.char \:R \u2236    \" RATIO
+.char \:: \u2237    \" PROPORTION
+.char \?1 \u223C    \" TILDE OPERATOR
+.char \CG \u223E    \" INVERTED LAZY S
+.char \?- \u2243    \" ASYMPTOTICALLY EQUAL TO
+.char \?= \u2245    \" APPROXIMATELY EQUAL TO
+.char \?2 \u2248    \" ALMOST EQUAL TO
+.char \=? \u224C    \" ALL EQUAL TO
+.char \HI \u2253    \" IMAGE OF OR APPROXIMATELY EQUAL TO
+.char \!= \u2260    \" NOT EQUAL TO
+.char \=3 \u2261    \" IDENTICAL TO
+.char \=< \u2264    \" LESS-THAN OR EQUAL TO
+.char \>= \u2265    \" GREATER-THAN OR EQUAL TO
+.char \<* \u226A    \" MUCH LESS-THAN
+.char \*> \u226B    \" MUCH GREATER-THAN
+.char \!< \u226E    \" NOT LESS-THAN
+.char \!> \u226F    \" NOT GREATER-THAN
+.char $C \u2282    \" SUBSET OF
+.char $C \u2283    \" SUPERSET OF
+.char $_ \u2286    \" SUBSET OF OR EQUAL TO
+.char $_ \u2287    \" SUPERSET OF OR EQUAL TO
+.char \0. \u2299    \" CIRCLED DOT OPERATOR
+.char \02 \u229A    \" CIRCLED RING OPERATOR
+.char \-T \u22A5    \" UP TACK
+.char \.P \u22C5    \" DOT OPERATOR
+.char \:3 \u22EE    \" VERTICAL ELLIPSIS
+.char \.3 \u22EF    \" MIDLINE HORIZONTAL ELLIPSIS
+.char \Eh \u2302    \" HOUSE
+.char \<7 \u2308    \" LEFT CEILING
+.char \>7 \u2309    \" RIGHT CEILING
+.char \7< \u230A    \" LEFT FLOOR
+.char \7> \u230B    \" RIGHT FLOOR
+.char \NI \u2310    \" REVERSED NOT SIGN
+.char \(A \u2312    \" ARC
+.char \TR \u2315    \" TELEPHONE RECORDER
+.char \Iu \u2320    \" TOP HALF INTEGRAL
+.char \Il \u2321    \" BOTTOM HALF INTEGRAL
+.char \</ \u2329    \" LEFT-POINTING ANGLE BRACKET
+.char \/> \u232A    \" RIGHT-POINTING ANGLE BRACKET
+.char \Vs \u2423    \" OPEN BOX
+.char \1h \u2440    \" OCR HOOK
+.char \3h \u2441    \" OCR CHAIR
+.char \2h \u2442    \" OCR FORK
+.char \4h \u2443    \" OCR INVERTED FORK
+.char \1j \u2446    \" OCR BRANCH BANK IDENTIFICATION
+.char \2j \u2447    \" OCR AMOUNT OF CHECK
+.char \3j \u2448    \" OCR DASH
+.char \4j \u2449    \" OCR CUSTOMER ACCOUNT NUMBER
+.char \1-o \u2460    \" CIRCLED DIGIT ONE
+.char \2-o \u2461    \" CIRCLED DIGIT TWO
+.char \3-o \u2462    \" CIRCLED DIGIT THREE
+.char \4-o \u2463    \" CIRCLED DIGIT FOUR
+.char \5-o \u2464    \" CIRCLED DIGIT FIVE
+.char \6-o \u2465    \" CIRCLED DIGIT SIX
+.char \7-o \u2466    \" CIRCLED DIGIT SEVEN
+.char \8-o \u2467    \" CIRCLED DIGIT EIGHT
+.char \9-o \u2468    \" CIRCLED DIGIT NINE
+.char \10-o \u2469    \" CIRCLED NUMBER TEN
+.char \11-o \u246A    \" CIRCLED NUMBER ELEVEN
+.char \12-o \u246B    \" CIRCLED NUMBER TWELVE
+.char \13-o \u246C    \" CIRCLED NUMBER THIRTEEN
+.char \14-o \u246D    \" CIRCLED NUMBER FOURTEEN
+.char \15-o \u246E    \" CIRCLED NUMBER FIFTEEN
+.char \16-o \u246F    \" CIRCLED NUMBER SIXTEEN
+.char \17-o \u2470    \" CIRCLED NUMBER SEVENTEEN
+.char \18-o \u2471    \" CIRCLED NUMBER EIGHTEEN
+.char \19-o \u2472    \" CIRCLED NUMBER NINETEEN
+.char \20-o \u2473    \" CIRCLED NUMBER TWENTY
+.char \(1) \u2474    \" PARENTHESIZED DIGIT ONE
+.char \(2) \u2475    \" PARENTHESIZED DIGIT TWO
+.char \(3) \u2476    \" PARENTHESIZED DIGIT THREE
+.char \(4) \u2477    \" PARENTHESIZED DIGIT FOUR
+.char \(5) \u2478    \" PARENTHESIZED DIGIT FIVE
+.char \(6) \u2479    \" PARENTHESIZED DIGIT SIX
+.char \(7) \u247A    \" PARENTHESIZED DIGIT SEVEN
+.char \(8) \u247B    \" PARENTHESIZED DIGIT EIGHT
+.char \(9) \u247C    \" PARENTHESIZED DIGIT NINE
+.char \(10) \u247D    \" PARENTHESIZED NUMBER TEN
+.char \(11) \u247E    \" PARENTHESIZED NUMBER ELEVEN
+.char \(12) \u247F    \" PARENTHESIZED NUMBER TWELVE
+.char \(13) \u2480    \" PARENTHESIZED NUMBER THIRTEEN
+.char \(14) \u2481    \" PARENTHESIZED NUMBER FOURTEEN
+.char \(15) \u2482    \" PARENTHESIZED NUMBER FIFTEEN
+.char \(16) \u2483    \" PARENTHESIZED NUMBER SIXTEEN
+.char \(17) \u2484    \" PARENTHESIZED NUMBER SEVENTEEN
+.char \(18) \u2485    \" PARENTHESIZED NUMBER EIGHTEEN
+.char \(19) \u2486    \" PARENTHESIZED NUMBER NINETEEN
+.char \(20) \u2487    \" PARENTHESIZED NUMBER TWENTY
+.char \1. \u2488    \" DIGIT ONE FULL STOP
+.char \2. \u2489    \" DIGIT TWO FULL STOP
+.char \3. \u248A    \" DIGIT THREE FULL STOP
+.char \4. \u248B    \" DIGIT FOUR FULL STOP
+.char \5. \u248C    \" DIGIT FIVE FULL STOP
+.char \6. \u248D    \" DIGIT SIX FULL STOP
+.char \7. \u248E    \" DIGIT SEVEN FULL STOP
+.char \8. \u248F    \" DIGIT EIGHT FULL STOP
+.char \9. \u2490    \" DIGIT NINE FULL STOP
+.char \10. \u2491    \" NUMBER TEN FULL STOP
+.char \11. \u2492    \" NUMBER ELEVEN FULL STOP
+.char \12. \u2493    \" NUMBER TWELVE FULL STOP
+.char \13. \u2494    \" NUMBER THIRTEEN FULL STOP
+.char \14. \u2495    \" NUMBER FOURTEEN FULL STOP
+.char \15. \u2496    \" NUMBER FIFTEEN FULL STOP
+.char \16. \u2497    \" NUMBER SIXTEEN FULL STOP
+.char \17. \u2498    \" NUMBER SEVENTEEN FULL STOP
+.char \18. \u2499    \" NUMBER EIGHTEEN FULL STOP
+.char \19. \u249A    \" NUMBER NINETEEN FULL STOP
+.char \20. \u249B    \" NUMBER TWENTY FULL STOP
+.char \(a) \u249C    \" PARENTHESIZED LATIN SMALL LETTER A
+.char \(b) \u249D    \" PARENTHESIZED LATIN SMALL LETTER B
+.char \(c) \u249E    \" PARENTHESIZED LATIN SMALL LETTER C
+.char \(d) \u249F    \" PARENTHESIZED LATIN SMALL LETTER D
+.char \(e) \u24A0    \" PARENTHESIZED LATIN SMALL LETTER E
+.char \(f) \u24A1    \" PARENTHESIZED LATIN SMALL LETTER F
+.char \(g) \u24A2    \" PARENTHESIZED LATIN SMALL LETTER G
+.char \(h) \u24A3    \" PARENTHESIZED LATIN SMALL LETTER H
+.char \(i) \u24A4    \" PARENTHESIZED LATIN SMALL LETTER I
+.char \(j) \u24A5    \" PARENTHESIZED LATIN SMALL LETTER J
+.char \(k) \u24A6    \" PARENTHESIZED LATIN SMALL LETTER K
+.char \(l) \u24A7    \" PARENTHESIZED LATIN SMALL LETTER L
+.char \(m) \u24A8    \" PARENTHESIZED LATIN SMALL LETTER M
+.char \(n) \u24A9    \" PARENTHESIZED LATIN SMALL LETTER N
+.char \(o) \u24AA    \" PARENTHESIZED LATIN SMALL LETTER O
+.char \(p) \u24AB    \" PARENTHESIZED LATIN SMALL LETTER P
+.char \(q) \u24AC    \" PARENTHESIZED LATIN SMALL LETTER Q
+.char \(r) \u24AD    \" PARENTHESIZED LATIN SMALL LETTER R
+.char \(s) \u24AE    \" PARENTHESIZED LATIN SMALL LETTER S
+.char \(t) \u24AF    \" PARENTHESIZED LATIN SMALL LETTER T
+.char \(u) \u24B0    \" PARENTHESIZED LATIN SMALL LETTER U
+.char \(v) \u24B1    \" PARENTHESIZED LATIN SMALL LETTER V
+.char \(w) \u24B2    \" PARENTHESIZED LATIN SMALL LETTER W
+.char \(x) \u24B3    \" PARENTHESIZED LATIN SMALL LETTER X
+.char \(y) \u24B4    \" PARENTHESIZED LATIN SMALL LETTER Y
+.char \(z) \u24B5    \" PARENTHESIZED LATIN SMALL LETTER Z
+.char \A-o \u24B6    \" CIRCLED LATIN CAPITAL LETTER A
+.char \B-o \u24B7    \" CIRCLED LATIN CAPITAL LETTER B
+.char \C-o \u24B8    \" CIRCLED LATIN CAPITAL LETTER C
+.char \D-o \u24B9    \" CIRCLED LATIN CAPITAL LETTER D
+.char \E-o \u24BA    \" CIRCLED LATIN CAPITAL LETTER E
+.char \F-o \u24BB    \" CIRCLED LATIN CAPITAL LETTER F
+.char \G-o \u24BC    \" CIRCLED LATIN CAPITAL LETTER G
+.char \H-o \u24BD    \" CIRCLED LATIN CAPITAL LETTER H
+.char \I-o \u24BE    \" CIRCLED LATIN CAPITAL LETTER I
+.char \J-o \u24BF    \" CIRCLED LATIN CAPITAL LETTER J
+.char \K-o \u24C0    \" CIRCLED LATIN CAPITAL LETTER K
+.char \L-o \u24C1    \" CIRCLED LATIN CAPITAL LETTER L
+.char \M-o \u24C2    \" CIRCLED LATIN CAPITAL LETTER M
+.char \N-o \u24C3    \" CIRCLED LATIN CAPITAL LETTER N
+.char \O-o \u24C4    \" CIRCLED LATIN CAPITAL LETTER O
+.char \P-o \u24C5    \" CIRCLED LATIN CAPITAL LETTER P
+.char \Q-o \u24C6    \" CIRCLED LATIN CAPITAL LETTER Q
+.char \R-o \u24C7    \" CIRCLED LATIN CAPITAL LETTER R
+.char \S-o \u24C8    \" CIRCLED LATIN CAPITAL LETTER S
+.char \T-o \u24C9    \" CIRCLED LATIN CAPITAL LETTER T
+.char \U-o \u24CA    \" CIRCLED LATIN CAPITAL LETTER U
+.char \V-o \u24CB    \" CIRCLED LATIN CAPITAL LETTER V
+.char \W-o \u24CC    \" CIRCLED LATIN CAPITAL LETTER W
+.char \X-o \u24CD    \" CIRCLED LATIN CAPITAL LETTER X
+.char \Y-o \u24CE    \" CIRCLED LATIN CAPITAL LETTER Y
+.char \Z-o \u24CF    \" CIRCLED LATIN CAPITAL LETTER Z
+.char \a-o \u24D0    \" CIRCLED LATIN SMALL LETTER A
+.char \b-o \u24D1    \" CIRCLED LATIN SMALL LETTER B
+.char \c-o \u24D2    \" CIRCLED LATIN SMALL LETTER C
+.char \d-o \u24D3    \" CIRCLED LATIN SMALL LETTER D
+.char \e-o \u24D4    \" CIRCLED LATIN SMALL LETTER E
+.char \f-o \u24D5    \" CIRCLED LATIN SMALL LETTER F
+.char \g-o \u24D6    \" CIRCLED LATIN SMALL LETTER G
+.char \h-o \u24D7    \" CIRCLED LATIN SMALL LETTER H
+.char \i-o \u24D8    \" CIRCLED LATIN SMALL LETTER I
+.char \j-o \u24D9    \" CIRCLED LATIN SMALL LETTER J
+.char \k-o \u24DA    \" CIRCLED LATIN SMALL LETTER K
+.char \l-o \u24DB    \" CIRCLED LATIN SMALL LETTER L
+.char \m-o \u24DC    \" CIRCLED LATIN SMALL LETTER M
+.char \n-o \u24DD    \" CIRCLED LATIN SMALL LETTER N
+.char \o-o \u24DE    \" CIRCLED LATIN SMALL LETTER O
+.char \p-o \u24DF    \" CIRCLED LATIN SMALL LETTER P
+.char \q-o \u24E0    \" CIRCLED LATIN SMALL LETTER Q
+.char \r-o \u24E1    \" CIRCLED LATIN SMALL LETTER R
+.char \s-o \u24E2    \" CIRCLED LATIN SMALL LETTER S
+.char \t-o \u24E3    \" CIRCLED LATIN SMALL LETTER T
+.char \u-o \u24E4    \" CIRCLED LATIN SMALL LETTER U
+.char \v-o \u24E5    \" CIRCLED LATIN SMALL LETTER V
+.char \w-o \u24E6    \" CIRCLED LATIN SMALL LETTER W
+.char \x-o \u24E7    \" CIRCLED LATIN SMALL LETTER X
+.char \y-o \u24E8    \" CIRCLED LATIN SMALL LETTER Y
+.char \z-o \u24E9    \" CIRCLED LATIN SMALL LETTER Z
+.char \0-o \u24EA    \" CIRCLED DIGIT ZERO
+.char \hh \u2500    \" BOX DRAWINGS LIGHT HORIZONTAL
+.char \HH \u2501    \" BOX DRAWINGS HEAVY HORIZONTAL
+.char \vv \u2502    \" BOX DRAWINGS LIGHT VERTICAL
+.char \VV \u2503    \" BOX DRAWINGS HEAVY VERTICAL
+.char \3- \u2504    \" BOX DRAWINGS LIGHT TRIPLE DASH HORIZONTAL
+.char \3_ \u2505    \" BOX DRAWINGS HEAVY TRIPLE DASH HORIZONTAL
+.char \3! \u2506    \" BOX DRAWINGS LIGHT TRIPLE DASH VERTICAL
+.char \3/ \u2507    \" BOX DRAWINGS HEAVY TRIPLE DASH VERTICAL
+.char \4- \u2508    \" BOX DRAWINGS LIGHT QUADRUPLE DASH HORIZONTAL
+.char \4_ \u2509    \" BOX DRAWINGS HEAVY QUADRUPLE DASH HORIZONTAL
+.char \4! \u250A    \" BOX DRAWINGS LIGHT QUADRUPLE DASH VERTICAL
+.char \4/ \u250B    \" BOX DRAWINGS HEAVY QUADRUPLE DASH VERTICAL
+.char \dr \u250C    \" BOX DRAWINGS LIGHT DOWN AND RIGHT
+.char \dR \u250D    \" BOX DRAWINGS DOWN LIGHT AND RIGHT HEAVY
+.char \Dr \u250E    \" BOX DRAWINGS DOWN HEAVY AND RIGHT LIGHT
+.char \DR \u250F    \" BOX DRAWINGS HEAVY DOWN AND RIGHT
+.char \dl \u2510    \" BOX DRAWINGS LIGHT DOWN AND LEFT
+.char \dL \u2511    \" BOX DRAWINGS DOWN LIGHT AND LEFT HEAVY
+.char \Dl \u2512    \" BOX DRAWINGS DOWN HEAVY AND LEFT LIGHT
+.char \LD \u2513    \" BOX DRAWINGS HEAVY DOWN AND LEFT
+.char \ur \u2514    \" BOX DRAWINGS LIGHT UP AND RIGHT
+.char \uR \u2515    \" BOX DRAWINGS UP LIGHT AND RIGHT HEAVY
+.char \Ur \u2516    \" BOX DRAWINGS UP HEAVY AND RIGHT LIGHT
+.char \UR \u2517    \" BOX DRAWINGS HEAVY UP AND RIGHT
+.char \ul \u2518    \" BOX DRAWINGS LIGHT UP AND LEFT
+.char \uL \u2519    \" BOX DRAWINGS UP LIGHT AND LEFT HEAVY
+.char \Ul \u251A    \" BOX DRAWINGS UP HEAVY AND LEFT LIGHT
+.char \UL \u251B    \" BOX DRAWINGS HEAVY UP AND LEFT
+.char \vr \u251C    \" BOX DRAWINGS LIGHT VERTICAL AND RIGHT
+.char \vR \u251D    \" BOX DRAWINGS VERTICAL LIGHT AND RIGHT HEAVY
+.char \Udr \u251E    \" BOX DRAWINGS UP HEAVY AND RIGHT DOWN LIGHT
+.char \uDr \u251F    \" BOX DRAWINGS DOWN HEAVY AND RIGHT UP LIGHT
+.char \Vr \u2520    \" BOX DRAWINGS VERTICAL HEAVY AND RIGHT LIGHT
+.char \UdR \u2521    \" BOX DRAWINGS DOWN LIGHT AND RIGHT UP HEAVY
+.char \uDR \u2522    \" BOX DRAWINGS UP LIGHT AND RIGHT DOWN HEAVY
+.char \VR \u2523    \" BOX DRAWINGS HEAVY VERTICAL AND RIGHT
+.char \vl \u2524    \" BOX DRAWINGS LIGHT VERTICAL AND LEFT
+.char \vL \u2525    \" BOX DRAWINGS VERTICAL LIGHT AND LEFT HEAVY
+.char \Udl \u2526    \" BOX DRAWINGS UP HEAVY AND LEFT DOWN LIGHT
+.char \uDl \u2527    \" BOX DRAWINGS DOWN HEAVY AND LEFT UP LIGHT
+.char \Vl \u2528    \" BOX DRAWINGS VERTICAL HEAVY AND LEFT LIGHT
+.char \UdL \u2529    \" BOX DRAWINGS DOWN LIGHT AND LEFT UP HEAVY
+.char \uDL \u252A    \" BOX DRAWINGS UP LIGHT AND LEFT DOWN HEAVY
+.char \VL \u252B    \" BOX DRAWINGS HEAVY VERTICAL AND LEFT
+.char \dh \u252C    \" BOX DRAWINGS LIGHT DOWN AND HORIZONTAL
+.char \dLr \u252D    \" BOX DRAWINGS LEFT HEAVY AND RIGHT DOWN LIGHT
+.char \dlR \u252E    \" BOX DRAWINGS RIGHT HEAVY AND LEFT DOWN LIGHT
+.char \dH \u252F    \" BOX DRAWINGS DOWN LIGHT AND HORIZONTAL HEAVY
+.char \Dh \u2530    \" BOX DRAWINGS DOWN HEAVY AND HORIZONTAL LIGHT
+.char \DLr \u2531    \" BOX DRAWINGS RIGHT LIGHT AND LEFT DOWN HEAVY
+.char \DlR \u2532    \" BOX DRAWINGS LEFT LIGHT AND RIGHT DOWN HEAVY
+.char \DH \u2533    \" BOX DRAWINGS HEAVY DOWN AND HORIZONTAL
+.char \uh \u2534    \" BOX DRAWINGS LIGHT UP AND HORIZONTAL
+.char \uLr \u2535    \" BOX DRAWINGS LEFT HEAVY AND RIGHT UP LIGHT
+.char \ulR \u2536    \" BOX DRAWINGS RIGHT HEAVY AND LEFT UP LIGHT
+.char \uH \u2537    \" BOX DRAWINGS UP LIGHT AND HORIZONTAL HEAVY
+.char \Uh \u2538    \" BOX DRAWINGS UP HEAVY AND HORIZONTAL LIGHT
+.char \ULr \u2539    \" BOX DRAWINGS RIGHT LIGHT AND LEFT UP HEAVY
+.char \UlR \u253A    \" BOX DRAWINGS LEFT LIGHT AND RIGHT UP HEAVY
+.char \UH \u253B    \" BOX DRAWINGS HEAVY UP AND HORIZONTAL
+.char \vh \u253C    \" BOX DRAWINGS LIGHT VERTICAL AND HORIZONTAL
+.char \vLr \u253D    \" BOX DRAWINGS LEFT HEAVY AND RIGHT VERTICAL LIGHT
+.char \vlR \u253E    \" BOX DRAWINGS RIGHT HEAVY AND LEFT VERTICAL LIGHT
+.char \vH \u253F    \" BOX DRAWINGS VERTICAL LIGHT AND HORIZONTAL HEAVY
+.char \Udh \u2540    \" BOX DRAWINGS UP HEAVY AND DOWN HORIZONTAL LIGHT
+.char \uDh \u2541    \" BOX DRAWINGS DOWN HEAVY AND UP HORIZONTAL LIGHT
+.char \Vh \u2542    \" BOX DRAWINGS VERTICAL HEAVY AND HORIZONTAL LIGHT
+.char \UdLr \u2543    \" BOX DRAWINGS LEFT UP HEAVY AND RIGHT DOWN LIGHT
+.char \UdlR \u2544    \" BOX DRAWINGS RIGHT UP HEAVY AND LEFT DOWN LIGHT
+.char \uDLr \u2545    \" BOX DRAWINGS LEFT DOWN HEAVY AND RIGHT UP LIGHT
+.char \uDlR \u2546    \" BOX DRAWINGS RIGHT DOWN HEAVY AND LEFT UP LIGHT
+.char \UdH \u2547    \" BOX DRAWINGS DOWN LIGHT AND UP HORIZONTAL HEAVY
+.char \uDH \u2548    \" BOX DRAWINGS UP LIGHT AND DOWN HORIZONTAL HEAVY
+.char \VLr \u2549    \" BOX DRAWINGS RIGHT LIGHT AND LEFT VERTICAL HEAVY
+.char \VlR \u254A    \" BOX DRAWINGS LEFT LIGHT AND RIGHT VERTICAL HEAVY
+.char \VH \u254B    \" BOX DRAWINGS HEAVY VERTICAL AND HORIZONTAL
+.char \FD \u2571    \" BOX DRAWINGS LIGHT DIAGONAL UPPER RIGHT TO LOWER LEFT
+.char \BD \u2572    \" BOX DRAWINGS LIGHT DIAGONAL UPPER LEFT TO LOWER RIGHT
+.char \TB \u2580    \" UPPER HALF BLOCK
+.char \LB \u2584    \" LOWER HALF BLOCK
+.char \FB \u2588    \" FULL BLOCK
+.char \lB \u258C    \" LEFT HALF BLOCK
+.char \RB \u2590    \" RIGHT HALF BLOCK
+.char \.S \u2591    \" LIGHT SHADE
+.char \:S \u2592    \" MEDIUM SHADE
+.char \?S \u2593    \" DARK SHADE
+.char \fS \u25A0    \" BLACK SQUARE
+.char \OS \u25A1    \" WHITE SQUARE
+.char \RO \u25A2    \" WHITE SQUARE WITH ROUNDED CORNERS
+.char \Rr \u25A3    \" WHITE SQUARE CONTAINING BLACK SMALL SQUARE
+.char \RF \u25A4    \" SQUARE WITH HORIZONTAL FILL
+.char \RY \u25A5    \" SQUARE WITH VERTICAL FILL
+.char \RH \u25A6    \" SQUARE WITH ORTHOGONAL CROSSHATCH FILL
+.char \RZ \u25A7    \" SQUARE WITH UPPER LEFT TO LOWER RIGHT FILL
+.char \RK \u25A8    \" SQUARE WITH UPPER RIGHT TO LOWER LEFT FILL
+.char \RX \u25A9    \" SQUARE WITH DIAGONAL CROSSHATCH FILL
+.char \sB \u25AA    \" BLACK SMALL SQUARE
+.char \SR \u25AC    \" BLACK RECTANGLE
+.char \Or \u25AD    \" WHITE RECTANGLE
+.char \UT \u25B2    \" BLACK UP-POINTING TRIANGLE
+.char \uT \u25B3    \" WHITE UP-POINTING TRIANGLE
+.char \PR \u25B6    \" BLACK RIGHT-POINTING TRIANGLE
+.char \Tr \u25B7    \" WHITE RIGHT-POINTING TRIANGLE
+.char \Dt \u25BC    \" BLACK DOWN-POINTING TRIANGLE
+.char \dT \u25BD    \" WHITE DOWN-POINTING TRIANGLE
+.char \PL \u25C0    \" BLACK LEFT-POINTING TRIANGLE
+.char \Tl \u25C1    \" WHITE LEFT-POINTING TRIANGLE
+.char \Db \u25C6    \" BLACK DIAMOND
+.char \Dw \u25C7    \" WHITE DIAMOND
+.char \LZ \u25CA    \" LOZENGE
+.char \0m \u25CB    \" WHITE CIRCLE
+.char \0o \u25CE    \" BULLSEYE
+.char \0M \u25CF    \" BLACK CIRCLE
+.char \0L \u25D0    \" CIRCLE WITH LEFT HALF BLACK
+.char \0R \u25D1    \" CIRCLE WITH RIGHT HALF BLACK
+.char \Sn \u25D8    \" INVERSE BULLET
+.char \Ic \u25D9    \" INVERSE WHITE CIRCLE
+.char \Fd \u25E2    \" BLACK LOWER RIGHT TRIANGLE
+.char \Bd \u25E3    \" BLACK LOWER LEFT TRIANGLE
+.char \*2 \u2605    \" BLACK STAR
+.char \*1 \u2606    \" WHITE STAR
+.char \TEL \u260E    \" BLACK TELEPHONE
+.char \tel \u260F    \" WHITE TELEPHONE
+.char \<H \u261C    \" WHITE LEFT POINTING INDEX
+.char \>H \u261E    \" WHITE RIGHT POINTING INDEX
+.char \0u \u263A    \" WHITE SMILING FACE
+.char \0U \u263B    \" BLACK SMILING FACE
+.char \SU \u263C    \" WHITE SUN WITH RAYS
+.char \Fm \u2640    \" FEMALE SIGN
+.char \Ml \u2642    \" MALE SIGN
+.char \cS \u2660    \" BLACK SPADE SUIT
+.char \cH \u2661    \" WHITE HEART SUIT
+.char \cD \u2662    \" WHITE DIAMOND SUIT
+.char \cC \u2663    \" BLACK CLUB SUIT
+.char \cS- \u2664    \" WHITE SPADE SUIT
+.char \cH- \u2665    \" BLACK HEART SUIT
+.char \cD- \u2666    \" BLACK DIAMOND SUIT
+.char \cC- \u2667    \" WHITE CLUB SUIT
+.char \Md \u2669    \" QUARTER NOTE
+.char \M8 \u266A    \" EIGHTH NOTE
+.char \M2 \u266B    \" BARRED EIGHTH NOTES
+.char \M16 \u266C    \" BARRED SIXTEENTH NOTES
+.char \Mb \u266D    \" MUSIC FLAT SIGN
+.char \Mx \u266E    \" MUSIC NATURAL SIGN
+.char \MX \u266F    \" MUSIC SHARP SIGN
+.char \OK \u2713    \" CHECK MARK
+.char \XX \u2717    \" BALLOT X
+.char \-X \u2720    \" MALTESE CROSS
+.char \IS \u3000    \" IDEOGRAPHIC SPACE
+.char \,_ \u3001    \" IDEOGRAPHIC COMMA
+.char \._ \u3002    \" IDEOGRAPHIC PERIOD
+.char \+" \u3003    \" DITTO MARK
+.char \+_ \u3004    \" IDEOGRAPHIC DITTO MARK
+.char \*_ \u3005    \" IDEOGRAPHIC ITERATION MARK
+.char \;_ \u3006    \" IDEOGRAPHIC CLOSING MARK
+.char \0_ \u3007    \" IDEOGRAPHIC NUMBER ZERO
+.char \<+ \u300A    \" LEFT DOUBLE ANGLE BRACKET
+.char \>+ \u300B    \" RIGHT DOUBLE ANGLE BRACKET
+.char \<' \u300C    \" LEFT CORNER BRACKET
+.char \>' \u300D    \" RIGHT CORNER BRACKET
+.char \<" \u300E    \" LEFT WHITE CORNER BRACKET
+.char \>" \u300F    \" RIGHT WHITE CORNER BRACKET
+.char $" \u3010    \" LEFT BLACK LENTICULAR BRACKET
+.char $" \u3011    \" RIGHT BLACK LENTICULAR BRACKET
+.char \=T \u3012    \" POSTAL MARK
+.char \=_ \u3013    \" GETA MARK
+.char $' \u3014    \" LEFT TORTOISE SHELL BRACKET
+.char $' \u3015    \" RIGHT TORTOISE SHELL BRACKET
+.char $I \u3016    \" LEFT WHITE LENTICULAR BRACKET
+.char $I \u3017    \" RIGHT WHITE LENTICULAR BRACKET
+.char \-? \u301C    \" WAVE DASH
+.char \=T:) \u3020    \" POSTAL MARK FACE
+.char \A5 \u3041    \" HIRAGANA LETTER SMALL A
+.char \a5 \u3042    \" HIRAGANA LETTER A
+.char \I5 \u3043    \" HIRAGANA LETTER SMALL I
+.char \i5 \u3044    \" HIRAGANA LETTER I
+.char \U5 \u3045    \" HIRAGANA LETTER SMALL U
+.char \u5 \u3046    \" HIRAGANA LETTER U
+.char \E5 \u3047    \" HIRAGANA LETTER SMALL E
+.char \e5 \u3048    \" HIRAGANA LETTER E
+.char \O5 \u3049    \" HIRAGANA LETTER SMALL O
+.char \o5 \u304A    \" HIRAGANA LETTER O
+.char \ka \u304B    \" HIRAGANA LETTER KA
+.char \ga \u304C    \" HIRAGANA LETTER GA
+.char \ki \u304D    \" HIRAGANA LETTER KI
+.char \gi \u304E    \" HIRAGANA LETTER GI
+.char \ku \u304F    \" HIRAGANA LETTER KU
+.char \gu \u3050    \" HIRAGANA LETTER GU
+.char \ke \u3051    \" HIRAGANA LETTER KE
+.char \ge \u3052    \" HIRAGANA LETTER GE
+.char \ko \u3053    \" HIRAGANA LETTER KO
+.char \go \u3054    \" HIRAGANA LETTER GO
+.char \sa \u3055    \" HIRAGANA LETTER SA
+.char \za \u3056    \" HIRAGANA LETTER ZA
+.char \si \u3057    \" HIRAGANA LETTER SI
+.char \zi \u3058    \" HIRAGANA LETTER ZI
+.char \su \u3059    \" HIRAGANA LETTER SU
+.char \zu \u305A    \" HIRAGANA LETTER ZU
+.char \se \u305B    \" HIRAGANA LETTER SE
+.char \ze \u305C    \" HIRAGANA LETTER ZE
+.char \so \u305D    \" HIRAGANA LETTER SO
+.char \zo \u305E    \" HIRAGANA LETTER ZO
+.char \ta \u305F    \" HIRAGANA LETTER TA
+.char \da \u3060    \" HIRAGANA LETTER DA
+.char \ti \u3061    \" HIRAGANA LETTER TI
+.char \di \u3062    \" HIRAGANA LETTER DI
+.char \tU \u3063    \" HIRAGANA LETTER SMALL TU
+.char \tu \u3064    \" HIRAGANA LETTER TU
+.char \du \u3065    \" HIRAGANA LETTER DU
+.char \te \u3066    \" HIRAGANA LETTER TE
+.char \de \u3067    \" HIRAGANA LETTER DE
+.char \to \u3068    \" HIRAGANA LETTER TO
+.char \do \u3069    \" HIRAGANA LETTER DO
+.char \na \u306A    \" HIRAGANA LETTER NA
+.char \ni \u306B    \" HIRAGANA LETTER NI
+.char \nu \u306C    \" HIRAGANA LETTER NU
+.char \ne \u306D    \" HIRAGANA LETTER NE
+.char \no \u306E    \" HIRAGANA LETTER NO
+.char \ha \u306F    \" HIRAGANA LETTER HA
+.char \ba \u3070    \" HIRAGANA LETTER BA
+.char \pa \u3071    \" HIRAGANA LETTER PA
+.char \hi \u3072    \" HIRAGANA LETTER HI
+.char \bi \u3073    \" HIRAGANA LETTER BI
+.char \pi \u3074    \" HIRAGANA LETTER PI
+.char \hu \u3075    \" HIRAGANA LETTER HU
+.char \bu \u3076    \" HIRAGANA LETTER BU
+.char \pu \u3077    \" HIRAGANA LETTER PU
+.char \he \u3078    \" HIRAGANA LETTER HE
+.char \be \u3079    \" HIRAGANA LETTER BE
+.char \pe \u307A    \" HIRAGANA LETTER PE
+.char \ho \u307B    \" HIRAGANA LETTER HO
+.char \bo \u307C    \" HIRAGANA LETTER BO
+.char \po \u307D    \" HIRAGANA LETTER PO
+.char \ma \u307E    \" HIRAGANA LETTER MA
+.char \mi \u307F    \" HIRAGANA LETTER MI
+.char \mu \u3080    \" HIRAGANA LETTER MU
+.char \me \u3081    \" HIRAGANA LETTER ME
+.char \mo \u3082    \" HIRAGANA LETTER MO
+.char \yA \u3083    \" HIRAGANA LETTER SMALL YA
+.char \ya \u3084    \" HIRAGANA LETTER YA
+.char \yU \u3085    \" HIRAGANA LETTER SMALL YU
+.char \yu \u3086    \" HIRAGANA LETTER YU
+.char \yO \u3087    \" HIRAGANA LETTER SMALL YO
+.char \yo \u3088    \" HIRAGANA LETTER YO
+.char \ra \u3089    \" HIRAGANA LETTER RA
+.char \ri \u308A    \" HIRAGANA LETTER RI
+.char \ru \u308B    \" HIRAGANA LETTER RU
+.char \re \u308C    \" HIRAGANA LETTER RE
+.char \ro \u308D    \" HIRAGANA LETTER RO
+.char \wA \u308E    \" HIRAGANA LETTER SMALL WA
+.char \wa \u308F    \" HIRAGANA LETTER WA
+.char \wi \u3090    \" HIRAGANA LETTER WI
+.char \we \u3091    \" HIRAGANA LETTER WE
+.char \wo \u3092    \" HIRAGANA LETTER WO
+.char \n5 \u3093    \" HIRAGANA LETTER N
+.char \vu \u3094    \" HIRAGANA LETTER VU
+.char \"5 \u309B    \" KATAKANA-HIRAGANA VOICED SOUND MARK
+.char \05 \u309C    \" KATAKANA-HIRAGANA SEMI-VOICED SOUND MARK
+.char \*5 \u309D    \" HIRAGANA ITERATION MARK
+.char \+5 \u309E    \" HIRAGANA VOICED ITERATION MARK
+.char \a6 \u30A1    \" KATAKANA LETTER SMALL A
+.char \A6 \u30A2    \" KATAKANA LETTER A
+.char \i6 \u30A3    \" KATAKANA LETTER SMALL I
+.char \I6 \u30A4    \" KATAKANA LETTER I
+.char \u6 \u30A5    \" KATAKANA LETTER SMALL U
+.char \U6 \u30A6    \" KATAKANA LETTER U
+.char \e6 \u30A7    \" KATAKANA LETTER SMALL E
+.char \E6 \u30A8    \" KATAKANA LETTER E
+.char \o6 \u30A9    \" KATAKANA LETTER SMALL O
+.char \O6 \u30AA    \" KATAKANA LETTER O
+.char \Ka \u30AB    \" KATAKANA LETTER KA
+.char \Ga \u30AC    \" KATAKANA LETTER GA
+.char \Ki \u30AD    \" KATAKANA LETTER KI
+.char \Gi \u30AE    \" KATAKANA LETTER GI
+.char \Ku \u30AF    \" KATAKANA LETTER KU
+.char \Gu \u30B0    \" KATAKANA LETTER GU
+.char \Ke \u30B1    \" KATAKANA LETTER KE
+.char \Ge \u30B2    \" KATAKANA LETTER GE
+.char \Ko \u30B3    \" KATAKANA LETTER KO
+.char \Go \u30B4    \" KATAKANA LETTER GO
+.char \Sa \u30B5    \" KATAKANA LETTER SA
+.char \Za \u30B6    \" KATAKANA LETTER ZA
+.char \Si \u30B7    \" KATAKANA LETTER SI
+.char \Zi \u30B8    \" KATAKANA LETTER ZI
+.char \Su \u30B9    \" KATAKANA LETTER SU
+.char \Zu \u30BA    \" KATAKANA LETTER ZU
+.char \Se \u30BB    \" KATAKANA LETTER SE
+.char \Ze \u30BC    \" KATAKANA LETTER ZE
+.char \So \u30BD    \" KATAKANA LETTER SO
+.char \Zo \u30BE    \" KATAKANA LETTER ZO
+.char \Ta \u30BF    \" KATAKANA LETTER TA
+.char \Da \u30C0    \" KATAKANA LETTER DA
+.char \Ti \u30C1    \" KATAKANA LETTER TI
+.char \Di \u30C2    \" KATAKANA LETTER DI
+.char \TU \u30C3    \" KATAKANA LETTER SMALL TU
+.char \Tu \u30C4    \" KATAKANA LETTER TU
+.char \Du \u30C5    \" KATAKANA LETTER DU
+.char \Te \u30C6    \" KATAKANA LETTER TE
+.char \De \u30C7    \" KATAKANA LETTER DE
+.char \To \u30C8    \" KATAKANA LETTER TO
+.char \Do \u30C9    \" KATAKANA LETTER DO
+.char \Na \u30CA    \" KATAKANA LETTER NA
+.char \Ni \u30CB    \" KATAKANA LETTER NI
+.char \Nu \u30CC    \" KATAKANA LETTER NU
+.char \Ne \u30CD    \" KATAKANA LETTER NE
+.char \No \u30CE    \" KATAKANA LETTER NO
+.char \Ha \u30CF    \" KATAKANA LETTER HA
+.char \Ba \u30D0    \" KATAKANA LETTER BA
+.char \Pa \u30D1    \" KATAKANA LETTER PA
+.char \Hi \u30D2    \" KATAKANA LETTER HI
+.char \Bi \u30D3    \" KATAKANA LETTER BI
+.char \Pi \u30D4    \" KATAKANA LETTER PI
+.char \Hu \u30D5    \" KATAKANA LETTER HU
+.char \Bu \u30D6    \" KATAKANA LETTER BU
+.char \Pu \u30D7    \" KATAKANA LETTER PU
+.char \He \u30D8    \" KATAKANA LETTER HE
+.char \Be \u30D9    \" KATAKANA LETTER BE
+.char \Pe \u30DA    \" KATAKANA LETTER PE
+.char \Ho \u30DB    \" KATAKANA LETTER HO
+.char \Bo \u30DC    \" KATAKANA LETTER BO
+.char \Po \u30DD    \" KATAKANA LETTER PO
+.char \Ma \u30DE    \" KATAKANA LETTER MA
+.char \Mi \u30DF    \" KATAKANA LETTER MI
+.char \Mu \u30E0    \" KATAKANA LETTER MU
+.char \Me \u30E1    \" KATAKANA LETTER ME
+.char \Mo \u30E2    \" KATAKANA LETTER MO
+.char \YA \u30E3    \" KATAKANA LETTER SMALL YA
+.char \Ya \u30E4    \" KATAKANA LETTER YA
+.char \YU \u30E5    \" KATAKANA LETTER SMALL YU
+.char \Yu \u30E6    \" KATAKANA LETTER YU
+.char \YO \u30E7    \" KATAKANA LETTER SMALL YO
+.char \Yo \u30E8    \" KATAKANA LETTER YO
+.char \Ra \u30E9    \" KATAKANA LETTER RA
+.char \Ri \u30EA    \" KATAKANA LETTER RI
+.char \Ru \u30EB    \" KATAKANA LETTER RU
+.char \Re \u30EC    \" KATAKANA LETTER RE
+.char \Ro \u30ED    \" KATAKANA LETTER RO
+.char \WA \u30EE    \" KATAKANA LETTER SMALL WA
+.char \Wa \u30EF    \" KATAKANA LETTER WA
+.char \Wi \u30F0    \" KATAKANA LETTER WI
+.char \We \u30F1    \" KATAKANA LETTER WE
+.char \Wo \u30F2    \" KATAKANA LETTER WO
+.char \N6 \u30F3    \" KATAKANA LETTER N
+.char \Vu \u30F4    \" KATAKANA LETTER VU
+.char \KA \u30F5    \" KATAKANA LETTER SMALL KA
+.char \KE \u30F6    \" KATAKANA LETTER SMALL KE
+.char \Va \u30F7    \" KATAKANA LETTER VA
+.char \Vi \u30F8    \" KATAKANA LETTER VI
+.char \Ve \u30F9    \" KATAKANA LETTER VE
+.char \Vo \u30FA    \" KATAKANA LETTER VO
+.char \.6 \u30FB    \" KATAKANA MIDDLE DOT
+.char \-6 \u30FC    \" KATAKANA-HIRAGANA PROLONGED SOUND MARK
+.char \*6 \u30FD    \" KATAKANA ITERATION MARK
+.char \+6 \u30FE    \" KATAKANA VOICED ITERATION MARK
+.char \b4 \u3105    \" BOPOMOFO LETTER B
+.char \p4 \u3106    \" BOPOMOFO LETTER P
+.char \m4 \u3107    \" BOPOMOFO LETTER M
+.char \f4 \u3108    \" BOPOMOFO LETTER F
+.char \d4 \u3109    \" BOPOMOFO LETTER D
+.char \t4 \u310A    \" BOPOMOFO LETTER T
+.char \n4 \u310B    \" BOPOMOFO LETTER N
+.char \l4 \u310C    \" BOPOMOFO LETTER L
+.char \g4 \u310D    \" BOPOMOFO LETTER G
+.char \k4 \u310E    \" BOPOMOFO LETTER K
+.char \h4 \u310F    \" BOPOMOFO LETTER H
+.char \j4 \u3110    \" BOPOMOFO LETTER J
+.char \q4 \u3111    \" BOPOMOFO LETTER Q
+.char \x4 \u3112    \" BOPOMOFO LETTER X
+.char \zh \u3113    \" BOPOMOFO LETTER ZH
+.char \ch \u3114    \" BOPOMOFO LETTER CH
+.char \sh \u3115    \" BOPOMOFO LETTER SH
+.char \r4 \u3116    \" BOPOMOFO LETTER R
+.char \z4 \u3117    \" BOPOMOFO LETTER Z
+.char \c4 \u3118    \" BOPOMOFO LETTER C
+.char \s4 \u3119    \" BOPOMOFO LETTER S
+.char \a4 \u311A    \" BOPOMOFO LETTER A
+.char \o4 \u311B    \" BOPOMOFO LETTER O
+.char \e4 \u311C    \" BOPOMOFO LETTER E
+.char \eh4 \u311D    \" BOPOMOFO LETTER EH
+.char \ai \u311E    \" BOPOMOFO LETTER AI
+.char \ei \u311F    \" BOPOMOFO LETTER EI
+.char \au \u3120    \" BOPOMOFO LETTER AU
+.char \ou \u3121    \" BOPOMOFO LETTER OU
+.char \an \u3122    \" BOPOMOFO LETTER AN
+.char \en \u3123    \" BOPOMOFO LETTER EN
+.char \aN \u3124    \" BOPOMOFO LETTER ANG
+.char \eN \u3125    \" BOPOMOFO LETTER ENG
+.char \er \u3126    \" BOPOMOFO LETTER ER
+.char \i4 \u3127    \" BOPOMOFO LETTER I
+.char \u4 \u3128    \" BOPOMOFO LETTER U
+.char \iu \u3129    \" BOPOMOFO LETTER IU
+.char \v4 \u312A    \" BOPOMOFO LETTER V
+.char \nG \u312B    \" BOPOMOFO LETTER NG
+.char \gn \u312C    \" BOPOMOFO LETTER GN
+.char \(JU) \u321C    \" PARENTHESIZED HANGUL JU
+.char \1c \u3220    \" PARENTHESIZED IDEOGRAPH ONE
+.char \2c \u3221    \" PARENTHESIZED IDEOGRAPH TWO
+.char \3c \u3222    \" PARENTHESIZED IDEOGRAPH THREE
+.char \4c \u3223    \" PARENTHESIZED IDEOGRAPH FOUR
+.char \5c \u3224    \" PARENTHESIZED IDEOGRAPH FIVE
+.char \6c \u3225    \" PARENTHESIZED IDEOGRAPH SIX
+.char \7c \u3226    \" PARENTHESIZED IDEOGRAPH SEVEN
+.char \8c \u3227    \" PARENTHESIZED IDEOGRAPH EIGHT
+.char \9c \u3228    \" PARENTHESIZED IDEOGRAPH NINE
+.char \10c \u3229    \" PARENTHESIZED IDEOGRAPH TEN
+.char \KSC \u327F    \" KOREAN STANDARD SYMBOL
+.char \ff \uFB00    \" LATIN SMALL LIGATURE FF
+.char \fi \uFB01    \" LATIN SMALL LIGATURE FI
+.char \fl \uFB02    \" LATIN SMALL LIGATURE FL
+.char \ffi \uFB03    \" LATIN SMALL LIGATURE FFI
+.char \ffl \uFB04    \" LATIN SMALL LIGATURE FFL
+.char \ft \uFB05    \" LATIN SMALL LIGATURE FT
+.char \st \uFB06    \" LATIN SMALL LIGATURE ST
+.char \3+; \uFE7D    \" ARABIC SHADDA MEDIAL FORM
+.char \aM. \uFE82    \" ARABIC LETTER ALEF WITH MADDA ABOVE FINAL FORM
+.char \aH. \uFE84    \" ARABIC LETTER ALEF WITH HAMZA ABOVE FINAL FORM
+.char \a+- \uFE8D    \" ARABIC LETTER ALEF ISOLATED FORM
+.char \a+. \uFE8E    \" ARABIC LETTER ALEF FINAL FORM
+.char \b+- \uFE8F    \" ARABIC LETTER BEH ISOLATED FORM
+.char \b+, \uFE90    \" ARABIC LETTER BEH INITIAL FORM
+.char \b+; \uFE91    \" ARABIC LETTER BEH MEDIAL FORM
+.char \b+. \uFE92    \" ARABIC LETTER BEH FINAL FORM
+.char \tm- \uFE93    \" ARABIC LETTER TEH MARBUTA ISOLATED FORM
+.char \tm. \uFE94    \" ARABIC LETTER TEH MARBUTA FINAL FORM
+.char \t+- \uFE95    \" ARABIC LETTER TEH ISOLATED FORM
+.char \t+, \uFE96    \" ARABIC LETTER TEH INITIAL FORM
+.char \t+; \uFE97    \" ARABIC LETTER TEH MEDIAL FORM
+.char \t+. \uFE98    \" ARABIC LETTER TEH FINAL FORM
+.char \tk- \uFE99    \" ARABIC LETTER THEH ISOLATED FORM
+.char \tk, \uFE9A    \" ARABIC LETTER THEH INITIAL FORM
+.char \tk; \uFE9B    \" ARABIC LETTER THEH MEDIAL FORM
+.char \tk. \uFE9C    \" ARABIC LETTER THEH FINAL FORM
+.char \g+- \uFE9D    \" ARABIC LETTER JEEM ISOLATED FORM
+.char \g+, \uFE9E    \" ARABIC LETTER JEEM INITIAL FORM
+.char \g+; \uFE9F    \" ARABIC LETTER JEEM MEDIAL FORM
+.char \g+. \uFEA0    \" ARABIC LETTER JEEM FINAL FORM
+.char \hk- \uFEA1    \" ARABIC LETTER HAH ISOLATED FORM
+.char \hk, \uFEA2    \" ARABIC LETTER HAH INITIAL FORM
+.char \hk; \uFEA3    \" ARABIC LETTER HAH MEDIAL FORM
+.char \hk. \uFEA4    \" ARABIC LETTER HAH FINAL FORM
+.char \x+- \uFEA5    \" ARABIC LETTER KHAH ISOLATED FORM
+.char \x+, \uFEA6    \" ARABIC LETTER KHAH INITIAL FORM
+.char \x+; \uFEA7    \" ARABIC LETTER KHAH MEDIAL FORM
+.char \x+. \uFEA8    \" ARABIC LETTER KHAH FINAL FORM
+.char \d+- \uFEA9    \" ARABIC LETTER DAL ISOLATED FORM
+.char \d+. \uFEAA    \" ARABIC LETTER DAL FINAL FORM
+.char \dk- \uFEAB    \" ARABIC LETTER THAL ISOLATED FORM
+.char \dk. \uFEAC    \" ARABIC LETTER THAL FINAL FORM
+.char \r+- \uFEAD    \" ARABIC LETTER REH ISOLATED FORM
+.char \r+. \uFEAE    \" ARABIC LETTER REH FINAL FORM
+.char \z+- \uFEAF    \" ARABIC LETTER ZAIN ISOLATED FORM
+.char \z+. \uFEB0    \" ARABIC LETTER ZAIN FINAL FORM
+.char \s+- \uFEB1    \" ARABIC LETTER SEEN ISOLATED FORM
+.char \s+, \uFEB2    \" ARABIC LETTER SEEN INITIAL FORM
+.char \s+; \uFEB3    \" ARABIC LETTER SEEN MEDIAL FORM
+.char \s+. \uFEB4    \" ARABIC LETTER SEEN FINAL FORM
+.char \sn- \uFEB5    \" ARABIC LETTER SHEEN ISOLATED FORM
+.char \sn, \uFEB6    \" ARABIC LETTER SHEEN INITIAL FORM
+.char \sn; \uFEB7    \" ARABIC LETTER SHEEN MEDIAL FORM
+.char \sn. \uFEB8    \" ARABIC LETTER SHEEN FINAL FORM
+.char \c+- \uFEB9    \" ARABIC LETTER SAD ISOLATED FORM
+.char \c+, \uFEBA    \" ARABIC LETTER SAD INITIAL FORM
+.char \c+; \uFEBB    \" ARABIC LETTER SAD MEDIAL FORM
+.char \c+. \uFEBC    \" ARABIC LETTER SAD FINAL FORM
+.char \dd- \uFEBD    \" ARABIC LETTER DAD ISOLATED FORM
+.char \dd, \uFEBE    \" ARABIC LETTER DAD INITIAL FORM
+.char \dd; \uFEBF    \" ARABIC LETTER DAD MEDIAL FORM
+.char \dd. \uFEC0    \" ARABIC LETTER DAD FINAL FORM
+.char \tj- \uFEC1    \" ARABIC LETTER TAH ISOLATED FORM
+.char \tj, \uFEC2    \" ARABIC LETTER TAH INITIAL FORM
+.char \tj; \uFEC3    \" ARABIC LETTER TAH MEDIAL FORM
+.char \tj. \uFEC4    \" ARABIC LETTER TAH FINAL FORM
+.char \zH- \uFEC5    \" ARABIC LETTER ZAH ISOLATED FORM
+.char \zH, \uFEC6    \" ARABIC LETTER ZAH INITIAL FORM
+.char \zH; \uFEC7    \" ARABIC LETTER ZAH MEDIAL FORM
+.char \zH. \uFEC8    \" ARABIC LETTER ZAH FINAL FORM
+.char \e+- \uFEC9    \" ARABIC LETTER AIN ISOLATED FORM
+.char \e+, \uFECA    \" ARABIC LETTER AIN INITIAL FORM
+.char \e+; \uFECB    \" ARABIC LETTER AIN MEDIAL FORM
+.char \e+. \uFECC    \" ARABIC LETTER AIN FINAL FORM
+.char \i+- \uFECD    \" ARABIC LETTER GHAIN ISOLATED FORM
+.char \i+, \uFECE    \" ARABIC LETTER GHAIN INITIAL FORM
+.char \i+; \uFECF    \" ARABIC LETTER GHAIN MEDIAL FORM
+.char \i+. \uFED0    \" ARABIC LETTER GHAIN FINAL FORM
+.char \f+- \uFED1    \" ARABIC LETTER FEH ISOLATED FORM
+.char \f+, \uFED2    \" ARABIC LETTER FEH INITIAL FORM
+.char \f+; \uFED3    \" ARABIC LETTER FEH MEDIAL FORM
+.char \f+. \uFED4    \" ARABIC LETTER FEH FINAL FORM
+.char \q+- \uFED5    \" ARABIC LETTER QAF ISOLATED FORM
+.char \q+, \uFED6    \" ARABIC LETTER QAF INITIAL FORM
+.char \q+; \uFED7    \" ARABIC LETTER QAF MEDIAL FORM
+.char \q+. \uFED8    \" ARABIC LETTER QAF FINAL FORM
+.char \k+- \uFED9    \" ARABIC LETTER KAF ISOLATED FORM
+.char \k+, \uFEDA    \" ARABIC LETTER KAF INITIAL FORM
+.char \k+; \uFEDB    \" ARABIC LETTER KAF MEDIAL FORM
+.char \k+. \uFEDC    \" ARABIC LETTER KAF FINAL FORM
+.char \l+- \uFEDD    \" ARABIC LETTER LAM ISOLATED FORM
+.char \l+, \uFEDE    \" ARABIC LETTER LAM INITIAL FORM
+.char \l+; \uFEDF    \" ARABIC LETTER LAM MEDIAL FORM
+.char \l+. \uFEE0    \" ARABIC LETTER LAM FINAL FORM
+.char \m+- \uFEE1    \" ARABIC LETTER MEEM ISOLATED FORM
+.char \m+, \uFEE2    \" ARABIC LETTER MEEM INITIAL FORM
+.char \m+; \uFEE3    \" ARABIC LETTER MEEM MEDIAL FORM
+.char \m+. \uFEE4    \" ARABIC LETTER MEEM FINAL FORM
+.char \n+- \uFEE5    \" ARABIC LETTER NOON ISOLATED FORM
+.char \n+, \uFEE6    \" ARABIC LETTER NOON INITIAL FORM
+.char \n+; \uFEE7    \" ARABIC LETTER NOON MEDIAL FORM
+.char \n+. \uFEE8    \" ARABIC LETTER NOON FINAL FORM
+.char \h+- \uFEE9    \" ARABIC LETTER HEH ISOLATED FORM
+.char \h+, \uFEEA    \" ARABIC LETTER HEH INITIAL FORM
+.char \h+; \uFEEB    \" ARABIC LETTER HEH MEDIAL FORM
+.char \h+. \uFEEC    \" ARABIC LETTER HEH FINAL FORM
+.char \w+- \uFEED    \" ARABIC LETTER WAW ISOLATED FORM
+.char \w+. \uFEEE    \" ARABIC LETTER WAW FINAL FORM
+.char \j+- \uFEEF    \" ARABIC LETTER ALEF MAKSURA ISOLATED FORM
+.char \j+. \uFEF0    \" ARABIC LETTER ALEF MAKSURA FINAL FORM
+.char \y+- \uFEF1    \" ARABIC LETTER YEH ISOLATED FORM
+.char \y+, \uFEF2    \" ARABIC LETTER YEH INITIAL FORM
+.char \y+; \uFEF3    \" ARABIC LETTER YEH MEDIAL FORM
+.char \y+. \uFEF4    \" ARABIC LETTER YEH FINAL FORM
+.char \lM- \uFEF5    \" ARABIC LIGATURE LAM WITH ALEF WITH MADDA ABOVE ISOLATED FORM
+.char \lM. \uFEF6    \" ARABIC LIGATURE LAM WITH ALEF WITH MADDA ABOVE FINAL FORM
+.char \lH- \uFEF7    \" ARABIC LIGATURE LAM WITH ALEF WITH HAMZA ABOVE ISOLATED FORM
+.char \lH. \uFEF8    \" ARABIC LIGATURE LAM WITH ALEF WITH HAMZA ABOVE FINAL FORM
+.char \lh- \uFEF9    \" ARABIC LIGATURE LAM WITH ALEF WITH HAMZA BELOW ISOLATED FORM
+.char \lh. \uFEFA    \" ARABIC LIGATURE LAM WITH ALEF WITH HAMZA BELOW FINAL FORM
+.char \la- \uFEFB    \" ARABIC LIGATURE LAM WITH ALEF ISOLATED FORM
+.char \la. \uFEFC    \" ARABIC LIGATURE LAM WITH ALEF FINAL FORM

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/rfc1345/tests/rfc1345-smoke-test.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes/ChangeLog Added

@@ -0,0 +1,202 @@
+2023-02-18  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am (uninstall_sboxes): Clean more fastidiously; try to
+	remove the configured `sboxespdfdocdir` in the event it is
+	empty, but do not fail if it isn't.  (It can be a directory
+	shared with other groff components; we don't know in what order
+	the uninstall targets will serialize, but the last one run
+	should succeed.)
+
+2022-10-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Escape newline after opening conditional block.
+
+2022-05-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am: Rename `BUILD_PDFDOC` to `USE_GROPDF`.
+
+2022-05-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am ($(sboxes_builddir)/msboxes.pdf): Depend on new name
+	for devpdf stamp file.
+
+2022-04-03  Ingo Schwarze <schwarze@openbsd.org>
+
+	* sboxes.am: msboxes.ms is documentation, not merely an example.
+	Consequently, install msboxes.ms unconditionally and msboxes.pdf
+	if BUILD_PDFDOC is enabled, both to the documentation directory
+	rather than to the examples directory.
+
+2022-04-02  Ingo Schwarze <schwarze@openbsd.org>
+
+	* sboxes.am: Stop installing msboxes.ms.in;
+	installing msboxes.ms and msboxes.pdf is enough.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am: Track rename of `DOC_GROFF_ONLY` to `DOC_GROFF`.
+
+2022-03-29  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* msboxes.ms.in: Tweak sboxes documentation to imply ms
+	dependency.
+
+	Fixes <https://savannah.gnu.org/bugs/?62062>.
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* sboxes.am: fix non-portable syntax in the msboxes.pdf target
+	by using DOC_GROFF_ONLY rather than DOC_GROFF in order to not
+	use $< outside a suffix rule; DOC_GROFF functionality is not
+	needed here in the first place.
+
+2022-03-22  Ingo Schwarze <schwarze@openbsd.org>
+
+	* sboxes.am: make the build of msboxes.{ms,pdf} work with BSD
+	make by using $(sboxes_builddir) consistently to prevent
+	variations in target names.
+
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Prefix early diagnostics with package file name
+	literally.  (We don't yet know if we can use \* string
+	interpolation.)  It is better to violate DRY a little here than
+	to obscure from the user what is emitting the diagnostic.
+
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Skip macro package instead of aborting if there
+	are prerequisite problems.  This is an auxiliary package; it is
+	not necessarily fatal to the user's purposes if it doesn't load.
+
+2022-02-06  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* notquine.sed: Convert tilde to special character when inlining
+	document source (\~ is used).
+
+2021-11-01  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* msboxes.ms.in: Retitle document to "Using PDF Boxes with
+	_groff and_ the ms macros" (emphasis added) to make it clearer
+	that this package does not _require_ ms.
+
+2021-10-27  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* notquine.sed: Improve portability and tighten logic.  Thanks
+	to Axel Kielhorn for the report and Andreas Kusalananda Kähäri
+	for the suggested improvements.
+
+2021-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Rename strings and macro I introduced so that
+	they fit Deri's selection within the name space (prefix "bx").
+	Rename existing macros to use the groff ms(7) naming convention.
+	None of the macros in this "module" seem meant to be visible to
+	other modules, so suffix the module name with '*' instead of
+	'@'.  Drop unused 7th argument in a `pdfbackground` call.
+
+2021-10-24  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Define GSBOX register as 0, then redefine it as 1
+	only if the output device is `pdf`.  (This way a document author
+	can easily and separately test the presence of the package and
+	whether the device-specific feature is likely to work.)
+	(pdfbackground): Only define (overriding `pdf.tmac`) if GSBOX is
+	false.
+	* msboxes.ms.in: Document this aspect of the package interface.
+
+2021-10-21  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am (SBOXES_FLAGS): Drop variable since we only expand
+	it in one place.
+	($(sboxes_builddir)/msboxes.pdf): Be more consistent with the
+	rest of our build, particularly documentation generated in the
+	groff `doc` directory.  Use `GROFF_V` instead of `AM_V_GEN` to
+	control output (since it is in fact groff producing the target).
+	Use `DOC_GROFF` to produce the document rather than
+	`test-groff`.  Use the former `SBOXES_FLAGS` here.
+
+2021-10-20  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am ($(sboxes_builddir)/msboxes.ms,
+	$(sboxes_builddir)/msboxes.pdf): Be quieter by default; use
+	$(AM_V_at) and $(AM_V_GEN) more consistently with the rest of
+	the build.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Rename macros to get out of user name space.  Our
+	ms package documentation says that externally visible names will
+	consist only of uppercase letters and digits.
+	(BoxStart): Rename to BOXSTART.
+	(BoxStop): Rename to BOXSTOP.
+	* msboxes.ms.in: Document and use new names.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac: Add more prerequisite checking.  Check `GS`
+	register for groff ms macros specifically.  Check installed
+	version of groff since the gropdf in earlier versions won't
+	implement the underlying feature.  Add new string to introduce
+	diagnostic messages now that we have more than one (that we can
+	emit without limp-along AT&T compatibility mode).
+	(sboxes*error): Use new string in diagnostic message.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.tmac (sboxes*error): Add new macro to produce
+	diagnostic message in a standard format.
+	(BoxStart): Use it.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	Make msboxes.ms quote its own source through a
+	self-interpolation process (with help from sed and the build
+	system), avoiding the need to manually keep the source document
+	and its quoted form in sync.
+
+	* msboxes.ms: Rename to...
+	* msboxes.ms.in: ...this.
+	* notquine.sed: New file; this sed script performs quotation of
+	roff syntax characters (and hyphens), inserts the quoted form of
+	the document's source into itself, and reproduces Deri's
+	Schrödinger's footnote trick.
+	* sboxes.am: Introduce new variables `sboxes_builddir` and
+	`sboxesnotquine` for convenience.  Update value of
+	$(SBOXES_EXAMPLEFILES) to point to the new .in source file.  Add
+	the generated ms document to $(SBOXES_PROCESSEDEXAMPLEFILES) and
+	$(MOSTLYCLEANFILES).  Add the `notquine` sed script to the
+	distribution archive via $(EXTRA_DIST).
+	($(sboxes_builddir)/msboxes.ms): New rule produces the ms
+	document from msboxes.ms.in, constructing it with sed.
+	($(sboxes_builddir)/msboxes.pdf): Update rule to add dependency
+	on source document, use new `sboxes_builddir` variable, and look
+	for source document in the build tree instead of the source.
+
+2021-10-17  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am: Add this ChangeLog to `EXTRA_DIST`.
+
+2021-10-11  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+	* sboxes.am (MOSTLYCLEANFILES): Add
+	`$(SBOXES_PROCESSEDEXAMPLEFILES)`; allows `distcheck` target to
+	succeed.
+
+________________________________________________________________________
+
+##### License
+
+Copyright 2021 Free Software Foundation, Inc.
+
+Copying and distribution of this file, with or without modification,
+are permitted in any medium without royalty provided the copyright
+notice and this notice are preserved.
+
+##### Editor settings
+Local Variables:
+fill-column: 72
+mode: change-log
+version-control: never
+End:
+vim:set autoindent textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes/msboxes.ms.in Added

@@ -0,0 +1,272 @@
+.\" groff -ms -msboxes -Tpdf
+.nr LL 17c
+.nr PO 2c
+.nr PS 11
+.nr VS 13
+.nr PI 3.5n
+.nr HM 2c
+.nr FM 2c
+.nr QI 7n
+.ss 12 0
+.ND March 2021
+.EH '%''March 2021'
+.EF ''''
+.OH 'Using PDF boxes with \fIgroff\f and the \fIms\f macros''%'
+.OF ''''
+.\" Define a quotation macro.
+.de Qq
+.  nop \lq\\$1\rq\\$2
+..
+.\" Define a macro for code literals; use bold and disable hyphenation.
+.de Lt
+.  ft B
+.  nh
+.  nop \&\\$1\c
+.  hy \\nHY
+.  ft
+.  nop \&\\$2
+..
+.ds FAM H
+.TL
+Using PDF boxes with
+.BI groff
+and the
+.BI ms
+macros
+.AU
+Deri James
+.AI
+deri@chuzzlewit.myzen.co.uk
+.LP
+An extension in version 1.23.0 of
+.I gropdf ,
+the PDF output driver for the
+.I groff
+document formatting system,
+allows coloured rectangles to be placed beneath any output created by
+.I groff .
+The extension can be accessed via a device control escape sequence
+.Lt "\rsX\aqpdf: background" \~.\|.\|.\|\c
+.Lt \aq
+or a convenience macro
+.Lt pdfbackground
+supporting the same parameters.
+.QS
+.BOXSTART SHADED cornsilk OUTLINED brown INDENT 2n WEIGHT 1p
+\Mfloralwhite\c
+.pdfbackground pagefill
+\M\c
+.B
+\rsX\aqpdf: background
+.BI
+cmd left top right bottom weight\aq
+.br
+.Lt .pdfbackground
+.BI
+cmd left top right bottom weight
+.LP
+each produce a background rectangle on the page, where
+.IP \fIcmd 8n \" indent enough to fit "bottom" tag
+is the command, which can be any of
+.Qq page|fill|box
+in combination.
+Thus,
+.Qq pagefill
+would draw a rectangle which covers the whole current page size (in
+which case the rest of the parameters can be omitted because the box
+dimensions are taken from the current media size).
+.Qq boxfill ,
+on the other hand, requires the given dimensions to place the box.
+Including
+.Qq fill
+in the command will paint the rectangle with the current fill colour (as
+with
+.Lt \rsM )
+and including
+.Qq box
+will give the rectangle a border in the current stroke colour
+(as with
+.Lt \rsm ).
+.sp \nPDu
+.I cmd
+may also be
+.Qq off
+on its own, which will terminate drawing the current box.
+If you have specified a page colour with
+.Qq pagefill ,
+it is always the first box in the stack, and if you specify it again, it
+will replace the first entry.
+Be aware that the
+.Qq pagefill
+box renders the page opaque, so tools that
+.Qq watermark
+PDF pages are unlikely to be successful.
+To return the background to transparent, issue an
+.Qq off
+command with no other boxes open.
+.sp \nPDu
+Finally,
+.I cmd
+may be
+.Qq footnote
+followed by a new value for
+.I bottom ,
+which will be used for all open boxes on the current page.
+This is to allow room for footnote areas that grow while a page is
+processed (to accommodate multiple footnotes,
+for instance).\mred\**\m\" FOOTNOTE
+.FS
+If the value is negative, it is used as an offset from the bottom of the
+page.
+.FE
+.nr oldPD \nPD
+.nr PD 0
+.IP \fIleft
+.IP \fItop
+.IP \fIright
+.IP \fIbottom
+.nr PD \noldPD
+are the coordinates of the box.
+The
+.I top
+and
+.I bottom
+coordinates are the minimum and maximum for the box, since the actual
+start of the box is
+.I groff 's
+drawing position when you issue the command, and the bottom of the box
+is the point where you turn the box
+.Qq off .
+The top and bottom coordinates are used only if the box drawing extends
+onto the next page; ordinarily, they would be set to the header and
+footer margins.
+.IP \fIweight
+provides the line width for the border if
+.Qq box
+is included in the command.
+.BOXSTOP
+.QE
+For an even more convenient interface, include
+.Lt \-msboxes
+on the
+.I groff
+command line; the
+.I sboxes
+package defines the macros
+.Lt BOXSTART
+and
+.Lt BOXSTOP .
+.QS
+.BOXSTART SHADED cornsilk OUTLINED brown INDENT 2n WEIGHT 1p
+.BOXSTART SHADED cornsilk3 INDENT 2p
+.Lt .BOXSTART
+.Lt SHADED
+.I colour
+.Lt OUTLINED
+.I colour
+.Lt INDENT
+.I size
+.Lt WEIGHT
+.I size
+.BOXSTOP
+.LP
+begins a box,
+where the argument after
+.Lt SHADED
+gives the fill colour and that after
+.Lt OUTLINED
+the border colour.
+Omit the former to get a borderless filled box and the latter for a
+border with no fill.
+The specified
+.Lt WEIGHT
+is used if the box is
+.Lt OUTLINED .
+.LP
+.Lt INDENT
+precedes a value which leaves a gap between the border and the contents
+inside the box.
+.LP
+Each
+.I colour
+must be a defined
+.I groff
+colour name,
+and each
+.I size
+a valid
+.I groff
+numeric expression.
+The keyword/value pairs can be specified in any order.
+.BOXSTOP
+.QE
+Boxes can be stacked, so you can start a box within another box; usually
+the later boxes would be smaller than the containing box, but this is
+not enforced.
+When using
+.Lt BOXSTART ,
+the left position is the current indent minus the
+.Lt INDENT
+in the command,
+and the right position is the left position (calculated above) plus the
+current line length and twice the indent.
+The synopsis of
+.Lt BOXSTART
+above itself uses a
+.Lt BOXSTART
+call without borders and with a
+.Lt 2p
+(two point) indent.
+.QS
+.BOXSTART SHADED cornsilk OUTLINED brown INDENT 2n WEIGHT 1p
+.BOXSTART SHADED cornsilk3 INDENT 2p
+.Lt .BOXSTOP
+.BOXSTOP
+.LP
+takes no parameters.
+It closes the most recently started box at the current vertical position
+after adding its
+.Lt INDENT
+spacing.
+.BOXSTOP
+.QE
+Your
+.I groff
+documents can conditionally exercise the
+.I sboxes
+macros.
+The register
+.Lt GSBOX
+is defined if the package is loaded, and interpolates a true value if
+the
+.Lt pdf
+output device is in use.
+.LP
+.I sboxes
+furthermore hooks into the
+.I "groff ms"
+package to receive notifications when footnotes are growing, so that it
+can close boxes on a page before footnotes are printed.
+When that condition obtains,
+.I sboxes
+will close open boxes two points\**
+.FS
+This amount probably will not match the box's
+.Lt INDENT .
+.FE
+above the footnote separator and re-open them on the next page.
+.LP
+This document was produced using the following code.
+.ds FAM C
+.nr PS 11
+.nr VS 13
+.LP
+.BOXSTART SHADED white OUTLINED brown INDENT 2n WEIGHT 1p
+.nf
+\# REPLACEME
+.BOXSTOP
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes/notquine.sed Added

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes/sboxes.am Added

@@ -0,0 +1,74 @@
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#      Written by Bertrand Garrigues <bertrand.garrigues@laposte.net>
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+sboxes_srcdir = $(top_srcdir)/contrib/sboxes
+sboxes_builddir = $(top_builddir)/contrib/sboxes
+sboxesnotquine = $(sboxes_srcdir)/notquine.sed
+
+sboxestmacdir = $(tmacdir)
+dist_sboxestmac_DATA = contrib/sboxes/sboxes.tmac
+
+EXTRA_DIST += \
+    contrib/sboxes/ChangeLog \
+    contrib/sboxes/msboxes.ms.in \
+    contrib/sboxes/notquine.sed
+
+SBOXES_EXAMPLEFILES = $(sboxes_srcdir)/msboxes.ms.in
+
+sboxesotherdocdir = $(docdir)
+nodist_sboxesotherdoc_DATA = $(sboxes_builddir)/msboxes.ms
+
+if USE_GROPDF
+sboxespdfdocdir = $(pdfdocdir)
+nodist_sboxespdfdoc_DATA = $(sboxes_builddir)/msboxes.pdf
+endif
+
+MOSTLYCLEANFILES += msboxes.ms \
+	$(nodist_sboxesotherdoc_DATA) \
+	$(nodist_sboxespdfdoc_DATA)
+
+# The ordering of the sed -e expressions is important.
+$(sboxes_builddir)/msboxes.ms: $(SBOXES_EXAMPLEFILES) $(sboxesnotquine)
+	$(AM_V_at)mkdir -p $(sboxes_builddir)
+	$(AM_V_at)$(SED) -n -e '1,/REPLACEME/p' \
+	    $(SBOXES_EXAMPLEFILES) > $@.tmp
+	$(AM_V_at)$(SED) -f $(sboxesnotquine) \
+	    $(SBOXES_EXAMPLEFILES) >> $@.tmp
+	$(AM_V_at)$(SED) -n -e '/REPLACEME/,$$p' \
+	    $(SBOXES_EXAMPLEFILES) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
+
+$(sboxes_builddir)/msboxes.pdf: $(sboxes_builddir)/msboxes.ms \
+  $(dist_sboxestmac_DATA) groff troff gropdf font/devpdf/stamp
+	$(GROFF_V)$(DOC_GROFF) -M$(sboxes_srcdir) -ms -msboxes -Tpdf \
+	  $(sboxes_builddir)/msboxes.ms > $@
+
+uninstall_groffdirs: uninstall_sboxes
+uninstall_sboxes:
+	if test -d $(DESTDIR)$(exampledir)/sboxes; then \
+	  rmdir $(DESTDIR)$(exampledir)/sboxes; \
+	fi
+if USE_GROPDF
+	-rmdir $(DESTDIR)$(sboxespdfdocdir)
+endif
+
+# Local Variables:
+# fill-column: 72
+# mode: makefile-automake
+# End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/contrib/sboxes/sboxes.tmac Added

@@ -0,0 +1,147 @@
+.ig
+
+sboxes.tmac
+
+Copyright (C) 2021 Free Software Foundation, Inc.
+     Written by Deri James (deri@chuzzlewit.myzen.co.uk)
+
+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 the Free
+Software Foundation, either version 3 of the License, or (at your
+option) any later version.
+
+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 this program.  If not, see <http://www.gnu.org/licenses/>.
+..
+.if !\n(.g \{\
+.  tm sboxes.tmac: macros require groff extensions; not loading
+.  nx
+.\}
+.
+.if \n(.C \{\
+.  tm sboxes.tmac: macros do not work in compatibility mode; not loading
+.  nx
+.\}
+.
+.\" Define a string for use in diagnostic messages.
+.ds bx*name sboxes.tmac\"
+.
+.if !r GS \
+.  ab \*bx*name: ms macros must be loaded first; aborting
+.
+.if (\n.x\n.y < 123) \{\
+.  ds bx*msg \*bx*name: groff 1.23 or later is required,\"
+.  as bx*msg " but found groff \n.x.\n.y; not loading\"
+.  tm \*bx*msg
+.  nx
+.\}
+.
+.\" See if already loaded.
+.if r GSBOX .nx
+.
+.\" GSBOX is defined if the package is loaded, and true if it will work.
+.nr GSBOX 0
+.if '\*.T'pdf' \
+.  nr GSBOX 1
+.
+.nr bx*stack 0
+.
+.de bx*error
+.  tm \*bx*name:\\n.F:\\n.c: error: \\$*
+..
+.
+.\" Define dummy macro if we're not formatting for the pdf device.
+.if !\nGSBOX \{\
+.  de pdfbackground
+.  .
+.\}
+.
+.\" Link into ms macros to trap footnote growth
+.am fn@print-sep
+.  nr bx*pb \\nnlu-2p
+.  nop \!x X pdf: background footnote \\nbx*pbz
+.  rr bx*pb
+..
+.\" Has PD been actioned?
+.am par*start
+.  nr bx*PD \\nPD
+..
+.
+.de BOXSTART
+.  fl
+.  nr bx*stack \\nbx*stack+1u
+.  nr bx*shad 0
+.  nr bx*outl 0
+.  nr bx*ind 1P
+.  ds bx*wt 0
+.  ds bx*type "\"
+.  while \\n.$ \{\
+.    ie 'SHADED'\\$1' \{\
+.       nop \\M\\$2\c
+.       nr bx*shad 1
+.       as bx*type "fill\"
+.       shift 2
+.    \}
+.    el \{\
+.     ie 'OUTLINED'\\$1' \{\
+.       nop \\m\\$2\c
+.       nr bx*outl 1
+.       as bx*type "box\"
+.       shift 2
+.     \}
+.     el \{\
+.       ie 'WEIGHT'\\$1' \{\
+.         ds bx*wt \\$2
+.         shift 2
+.       \}
+.       el \{\
+.         ie 'INDENT'\\$1' \{\
+.           nr bx*ind \\$2
+.           shift 2
+.         \}
+.         el \{\
+.           bx*error ignoring unrecognized BOXSTART parameter '\\$1'
+.           shift
+.         \}
+.       \}
+.     \}
+.    \}
+.  \}
+.
+.  if '\\*bx*type'' .ds bx*type "fill"
+.  nr bx*l \\n\\n.ev:lis+\\n.os-\\nbx*indu
+.  nr bx*r \\nbx*lu+\\n.l-\\n\\n.ev:li+(\\nbx*indu*2u)
+.  nr bx*gap \\n.v-\\n.ps+\\*bx*wt
+.  nr bx*bot \\n.pu-\\nFMu+\\nbx*indu+\\n.psu
+.  nr bx*top \\nHM-\\nbx*indu+\\nbx*gapu
+.  ne \\nbx*indu+2v+\\*bx*wt
+.  sp -(2v-(\\nbx*PDu*2u))u
+.  pdfbackground \\*bx*type \\nbx*lz \\nbx*topz \
+                              \\nbx*rz \\nbx*botz \
+                              \\*bx*wt
+.  sp (\\nbx*indu-1v)u
+.  if (\\nbx*shad=1) .nop \\M\c
+.  if (\\nbx*outl=1) .nop \\m\c
+.  ds bx*ind\\nbx*stack \\nbx*ind
+.  rr bx*shad bx*outl bx*ind bx*bot bx*top bx*l bx*r
+.  rm wt type
+.  sp -(\\nbx*gapu)
+.  nr bx*PD 0
+..
+.de BOXSTOP
+.  sp \\*bx*ind\\nbx*stacku-\\n.psru
+.  pdfbackground off
+.  nr bx*stack \\nbx*stack-1u
+..
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set expandtab filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/doc/automake.mom -> _service:tar_scm:groff-1.23.0.tar.gz/doc/automake.mom Changed

@@ -1,6 +1,6 @@
 .\" -*- mode: text; coding: utf-8; -*-
 .\"
-.\" Copyright ©2014, 2017 Free Software Foundation
+.\" Copyright ©2014 - 2022 Free Software Foundation
 .\" 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 .\"
 .\" Permission is hereby granted, free of charge, to any person
@@ -108,8 +108,8 @@
 .SHIFT_LIST 1m
 .ITEM
 .SP 3p
-Clone the gnulib repository as a git submodule in 'gnulib',
-add the needed gnulib sources files in `lib', 
+Clone the gnulib repository as a git submodule in `gnulib',
+add the needed gnulib sources files in `lib',
 add the needed gnulib m4 macros in `gnulib_m4'.
 .SP 3p
 .ITEM
@@ -142,7 +142,7 @@
 .
 .WS +2
 .EW .5
-Note that aclocal.m4 is generated and the groff m4 macros are
+The file aclocal.m4 is generated and the groff m4 macros are
 included via the acinclude.m4 file.
 .WS DEFAULT
 .EW 0
@@ -166,7 +166,7 @@
 $ make
 .CODE OFF
 .QUOTE OFF
-Note that parallel build is also supported and `make' can be invoked
+Parallel build is also supported: `make' can be invoked
 with the -j option, which will greatly speed up the build.
 .
 .HEADING 2 "Automake in the autotools process"
@@ -214,7 +214,7 @@
 .PP
 Automake defines a set of special variables that are used to
 generate various build rules in the final Makefile.  Note however
-that if Automake's pre-defined rules are not enough, you still have
+that if Automake's predefined rules are not enough, you still have
 the possibility of adding handwritten standard `make' rules in a
 Makefile.am; these rules will be copied verbatim in the Makefile.in
 and then in the final Makefile.
@@ -225,7 +225,7 @@
 Previously, when groff used `autoconf' only and not `automake',
 you had to invoke manually the autotools, depending on what you
 modified.  For example, to change the file `aclocal.m4', you had
-to run the shell command 'aclocal -I m4'; to recreate the files
+to run the shell command `aclocal -I m4'; to recreate the files
 `configure' and `Makefile', you had to use the command 'autoreconf
 - I m4'.
 .PP
@@ -245,7 +245,7 @@
 sources of this program in a variable that starts with the name of
 your program and ends with \*CODE_SOURCES\*CODE OFF\&.  In the
 groff project we have only 1 top-level Makefile.am that includes
-several .am files.
+several \&.am files.
 .PP
 Take for example the build of grolbp, in src/devices/grolbp/grolbp.am. 
 The file starts with:
@@ -255,10 +255,10 @@
 .CODE OFF
 .QUOTE OFF
 This says that a program named `grolbp' is added to the list of the
-programs that should be built.  Note that \*CODEbin_PROGRAMS\*CODE OFF
-is initialized to an empty string in the top-level Makefile.am,
-which includes grolbp.am.  (We will see later why we don't write
-directly
+programs that should be built.  The variable
+\*CODEbin_PROGRAMS\*CODE OFF is initialized to an empty string in
+the top-level Makefile.am, which includes grolbp.am.  (We will see later
+why we don't write directly
 \*CODEbin_PROGRAMS\~=\~grolbp\*CODE OFF in a Makefile.am in the
 grolbp directory.)
 .PP
@@ -288,7 +288,7 @@
 the distribution tarball.  That is why the headers are also listed
 in \*CODEgrolbp_SOURCES\*CODE OFF: it is not necessary to add
 them in order to correctly build `grolbp', but this way the headers
-will be distributed.  Note that:
+will be distributed.
 .
 .SP 3p
 .QUAD LEFT
@@ -301,7 +301,7 @@
 .ITEM
 The binaries are generated in the top-level build directory.
 .ITEM
-The .o files are generated in the directory where the source files
+The \&.o files are generated in the directory where the source files
 are located, or, in the case of an out-of-source build tree, in a
 directory that is the replication of the source tree directory.
 For example if you built groff in a `build' directory, lbp.o
@@ -357,9 +357,10 @@
 .ILQ
 .PP
 The use of specific CPPFLAGS changes the name of the generated objects:
-the .o object files are prefixed with the name of the program.
-For example, the .o file corresponding to src/devices/xditview/device.c
-will be src/devices/xditview/gxditview-device.o.
+the \&.o object files are prefixed with the name of the program.
+For example, the \&.o file corresponding to
+src/devices/xditview/device.c will be
+src/devices/xditview/gxditview-device.o.
 .
 .HEADING 2 "Cleaning"
 .
@@ -414,8 +415,8 @@
 similar special variable for scripts:  \*CODEbin_SCRIPTS\*CODE OFF\&.
 The scripts listed in this variable will automatically be
 built (of course you have to provide your custom rule to build the
-script), installed and uninstalled when invoking 'make', 'make
-install' and 'make uninstall'.  The main difference is that unlike
+script), installed and uninstalled when invoking `make', `make
+install' and `make uninstall'.  The main difference is that unlike
 the programs listed in \*CODEbin_PROGRAMS\*CODE OFF, the scripts
 will not be cleaned by default.  They are not distributed by default
 either.  In the groff project, \*CODEbin_SCRIPTS\*CODE OFF are
@@ -431,31 +432,34 @@
 bin_SCRIPTS += gropdf pdfmom
   ...
 gropdf: $(gropdf_dir)/gropdf.pl $(SH_DEPS_SED_SCRIPT)
-        rm -f $@
+        $(AM_V_GEN)$(RM) $@ \\
         sed -f $(SH_DEPS_SED_SCRIPT) \\
             -e "s|@VERSION@|$(VERSION)|" \\
             -e "s|@PERL@|$(PERL)|" \\
             -e "s|@GROFF_FONT_DIR@|$(fontpath)|" \\
-            -e "s|@RT_SEP@|$(RT_SEP)|" $(gropdf_dir)/gropdf.pl >$@
-        chmod +x $@
+            -e "s|@RT_SEP@|$(RT_SEP)|" $(gropdf_dir)/gropdf.pl \\
+            >$@ \
+        && chmod +x $@
 
 pdfmom: $(gropdf_dir)/pdfmom.pl $(SH_DEPS_SED_SCRIPT)
-        rm -f $@
+        $(AM_V_GEN)$(RM) $@ \\
         sed -f $(SH_DEPS_SED_SCRIPT) \\
             -e "s|@VERSION@|$(VERSION)|" \\
-            -e "s|@PERL@|$(PERL)|" $(gropdf_dir)/pdfmom.pl >$@
-        chmod +x $@
+            -e "s|@RT_SEP@|$(RT_SEP)|" \\
+            -e "s|@PERL@|$(PERL)|" $(gropdf_dir)/pdfmom.pl \\
+            >$@
+        && chmod +x $@
 .QUOTE OFF
 .QUOTE_INDENT 2m
 .CODE_SIZE 100
-Note that in this example the '@' symbol is protected by square
-brackets to prevent the substitution of the variable by `automake'.
+In this example, the `@' symbol is protected by square brackets to
+prevent the substitution of the variable by `automake'.
 .
 .HEADING 1 "Non-recursive make schema"
 .
 .PP
 There are two possibilities for organizing the Makefile.am of a
-large project, using a recusive or a non-recursive `make'.
+large project, using a recursive or a non-recursive `make'.
 .
 .HEADING 2 "1st possibility: make recursion"
 .
@@ -465,7 +469,7 @@
 sub-directory lists the programs that should be built.  If we had
 chosen this type of organization, we would have a Makefile.am in
 src/devices/grolbp and in each directory that contain sources to
-build a program (tbl, eqn, troff etc ...).  We would write in the
+build a program (tbl, eqn, troff, and so on).  We would write in the
 top-level Makefile.am:
 .QUOTE
 .IL
@@ -511,10 +515,10 @@
 .PP
 The idea is to have a single Makefile that contains all the rules.
 That is why we have only a single Makefile.am in the top-level
-directory which includes all the .am files that define rules
+directory which includes all the \&.am files that define rules
 to build the various programs.  The inclusion is done with the
 \*CODEinclude\*CODE OFF directive, not \*CODESUBDIRS\*CODE OFF\&.
-Using 'include' is like copying the contents of the included
+Using `include' is like copying the contents of the included
 file into the top-level Makefile.am, and will not generate other
 Makefile.
 .PP
@@ -524,11 +528,11 @@
 bin_PROGAMS = 
 .CODE OFF
 .QUOTE OFF
-and then all the .am files that define a program to be built (e.g.
+and then all the \&.am files that define a program to be built (e.g.
 src/devices/grolbp/grolbp.am, src/roff/troff/troff.am, and so on)
 overload this variable, so that at the end, all the programs that
 should be built are listed in this \*CODEbin_PROGRAMS\*CODE OFF
-variable.  This is the reason why all the paths in the various .am
+variable.  This is the reason why all the paths in the various \&.am
 files are relative to the top-level directory: at the end we will
 have only one Makefile in the top-level directory of the build tree.
 .PP
@@ -539,7 +543,7 @@
 system, `make' will have to be invoked in all the sub-directories.
 .PP
 Note also that in order to make `gnulib' work with this
-non-recursive schema, the `non-recursive-gnulib-prefix-hack'
+non-recursive schema, the `--automake-subdir'
 configuration should be selected in bootstrap.conf.
 .
 .HEADING 1 "Installing data"
@@ -549,7 +553,7 @@
 variables used to list files that should be installed in a
 particular location.  The prefix of the variables should refer to
 another previously defined variable that ends with a `dir' suffix.
-This varibale that ends with `dir' defines where the files should be
+This variable that ends with `dir' defines where the files should be
 installed.
 .
 .HEADING 2 "A simple case"
@@ -568,7 +572,7 @@
 .QUOTE OFF
 .WS -4
 \*CODEDEVX100FONTS\*CODE OFF is just a list of font files,
-defined at the begining of devX100.am.  \*CODEfontdir\*CODE OFF
+defined at the beginning of devX100.am.  \*CODEfontdir\*CODE OFF
 is where all the font directories are installed, it is defined
 in the top-level Makefile.am.  The conditional
 \*CODEif\~!WITHOUT_X11\*CODE OFF
@@ -584,8 +588,8 @@
 .QUOTE OFF
 Because we declared a variable ending with `dir', we are allowed
 to define \*CODEdevX100font_DATA\*CODE OFF (you remove the
-`dir' suffix and add \*CODE_DATA\*CODE OFF).  Note that
-wildcards are not supported in the special variable that end with
+`dir' suffix and add \*CODE_DATA\*CODE OFF).  Wildcards are not
+supported in the special variables that end with
 \*CODE_DATA\*CODE OFF\&.
 .PP
 With these two lines, `make install' will install the files
@@ -597,7 +601,7 @@
 (uninstall_groffdirs in Makefile.am).
 .PP
 Because the files listed in \*CODEdevX100font_DATA\*CODE OFF
-are not distributed by default, we explicitely added them to the
+are not distributed by default, we explicitly added them to the
 \*CODEEXTRA_DIST\*CODE OFF variable, which lists all the files
 that should be distributed and that are not taken into account by
 the default automake rules.
@@ -667,7 +671,7 @@
 defines a set of targets to extend the clean targets with your
 own rules: clean-local, mostlyclean-local, distclean-local or
 maintainerclean-local.  An example of such extension exists in
-font/devpdf/devpdf.am: because some fonts are not explicitely listed
+font/devpdf/devpdf.am: because some fonts are not explicitly listed
 in a \*CODExxx_DATA\*CODE OFF variable but generated by a custom
 rule, we define an extra rule to extend the `mostlyclean' target:
 .CODE_SIZE 92
@@ -710,11 +714,11 @@
 .JUSTIFY
 .HY DEFAULT
 .
-There are no garantees on the order of execution of these local
+There are no guarantees on the order of execution of these local
 rules.  An example of local rule is the installation of GXditview.ad
 and GXditview-color.ad files in src/devices/xditview/xditview.am: if
 theses files are already installed, the old files are first saved.
-Also, the final file that is installed is stripped from its .ad
+Also, the final file that is installed is stripped from its \&.ad
 suffix.  Thus the usage of a custom rule rather than the definition
 of a \*CODExxx_DATA\*CODE OFF variable:
 .FLEX
@@ -726,19 +730,19 @@
 .SP
 ...
 install_xditview: $(xditview_srcdir)/GXditview.ad
-        -test -d $(DESTDIR)$(appresdir) \\
-          || $(mkinstalldirs) $(DESTDIR)$(appresdir)
-        if test -f $(DESTDIR)$(appresdir)/GXditview; then \\
-          mv $(DESTDIR)$(appresdir)/GXditview \\
-            $(DESTDIR)$(appresdir)/GXditview.old; \\
+        -test -d $(DESTDIR)$(appdefdir) \\
+          || $(mkinstalldirs) $(DESTDIR)$(appdefdir)
+        if test -f $(DESTDIR)$(appdefdir)/GXditview; then \\
+          mv $(DESTDIR)$(appdefdir)/GXditview \\
+            $(DESTDIR)$(appdefdir)/GXditview.old; \\
         fi
         ...
         $(INSTALL_DATA) $(xditview_srcdir)/GXditview.ad \\
-          $(DESTDIR)$(appresdir)/GXditview
+          $(DESTDIR)$(appdefdir)/GXditview
 .CODE OFF
 .QUOTE OFF
 .PP
-Hooks, on the other hand, are garanteed to be executed after all the
+Hooks, on the other hand, are guaranteed to be executed after all the
 standard targets have been executed.
 .BR
 .SP 3p

_service:tar_scm:groff-1.22.4.tar.gz/doc/doc.am -> _service:tar_scm:groff-1.23.0.tar.gz/doc/doc.am Changed

@@ -1,18 +1,17 @@
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
-#      Original Makefile.sub written by Werner Lemberg <wl@gnu.org>
-#      Automake migration by 
-#      Bertrand Garrigues <bertrand.garrigues@laposte.net>
-#
+# Copyright (C) 2002-2022 Free Software Foundation, Inc.
+# Original Makefile.sub written by Werner Lemberg <wl@gnu.org>.
+# Adapted to Automake by Bertrand Garrigues
+#   (bertrand.garrigues@laposte.net).
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -22,58 +21,101 @@
 doc_srcdir = $(abs_top_srcdir)/doc
 doc_builddir = $(abs_top_builddir)/doc
 
-DOC_SED = $(SED) -e "s;@VERSION@;$(VERSION);"
+# Some document sources are parameterized in configuration options like
+# the groff version number and the command prefix.  Use this in target
+# rules to prepare formattable versions of them from .in files.
+DOC_SED = $(SED) \
+  -e "s;@VERSION@;$(VERSION);" \
+  -e "s;@g@;$(g);g;"
 
-DOC_GROFF_ONLY=\
+# Use this in target rules to run the build tree's groff.
+#
+# It includes flags to locate its tmac and device/font description
+# directories and to produce verbose diagnostics in the event of syntax
+# or formatting problems.
+DOC_GROFF = \
   GROFF_COMMAND_PREFIX= \
   GROFF_BIN_PATH="$(GROFF_BIN_PATH)" \
-  $(GROFFBIN) -I$(abs_top_builddir) -M $(doc_srcdir) \
-	$(TFLAG) $(FFLAG) -Upet -ww 
+  $(GROFFBIN) -M $(doc_srcdir) $(MFLAG) $(FFLAG) -ww -b
 
-DOC_GROFF = $(DOC_SED) $< | $(DOC_GROFF_ONLY)
+# This image file is used by several documents in the groff source tree.
+DOC_GNU_EPS = doc/gnu.eps
 
 # Other doc, installed in $(docdir)
-if BUILD_OTHERDOC
 # Files located in the source tree
-DOCFILES= \
-  doc/meref.me \
+DOCFILES_INST = \
+  doc/me-revisions \
+  doc/ms.ms \
+  doc/pic.ms
+DOCFILES_NOINST = \
+  doc/meintro.me.in \
+  doc/meintro_fr.me.in \
+  doc/meref.me.in
+# Files that undergo a transformation prior to groff processing
+GENERATEDDOCFILES = \
   doc/meintro.me \
   doc/meintro_fr.me \
-  doc/pic.ms
+  doc/meref.me
 # Files generated in the build tree
-PROCESSEDDOCFILES = \
+if USE_GROHTML
+PROCESSEDDOCFILES_HTML = \
+  doc/pic.html
+endif
+if USE_GROPDF
+PROCESSEDDOCFILES_PDF = \
+  doc/automake.pdf \
+  doc/groff-man-pages.pdf
+endif
+PROCESSEDDOCFILES_PS = \
   doc/meref.ps \
   doc/meintro.ps \
   doc/meintro_fr.ps \
+  doc/ms.ps \
   doc/pic.ps
+PROCESSEDDOCFILES_TXT = \
+  doc/groff-man-pages.utf8.txt
+PROCESSEDDOCFILES = \
+  $(PROCESSEDDOCFILES_HTML) \
+  $(PROCESSEDDOCFILES_PS) \
+  $(PROCESSEDDOCFILES_PDF) \
+  $(PROCESSEDDOCFILES_TXT)
+
+# Declare minimal dependencies for documents by output driver.
+PROCESSEDFILES_DEPS_HTML = pre-grohtml groff troff post-grohtml \
+  font/devhtml/stamp font/devps/stamp
+PROCESSEDFILES_DEPS_PS = groff troff grops font/devps/stamp
+PROCESSEDFILES_DEPS_PDF = groff troff gropdf font/devpdf/stamp
+PROCESSEDFILES_DEPS_TXT = groff troff grotty font/devutf8/stamp
+
+if USE_GROHTML
+$(PROCESSEDDOCFILES_HTML): $(PROCESSEDFILES_DEPS_HTML)
+endif
+$(PROCESSEDDOCFILES_PS): $(PROCESSEDFILES_DEPS_PS)
+if USE_GROPDF
+$(PROCESSEDDOCFILES_PDF): $(PROCESSEDFILES_DEPS_PDF)
+endif
+$(PROCESSEDDOCFILES_TXT): $(PROCESSEDFILES_DEPS_TXT)
 
 otherdocdir = $(docdir)
-dist_otherdoc_DATA = $(DOCFILES)
-nodist_otherdoc_DATA = $(PROCESSEDDOCFILES)
-MOSTLYCLEANFILES += $(PROCESSEDDOCFILES)
-else
-EXTRA_DIST += $(DOCFILES)
-endif
+dist_otherdoc_DATA = $(DOCFILES_INST)
+nodist_otherdoc_DATA = $(PROCESSEDDOCFILES) $(GENERATEDDOCFILES)
+MOSTLYCLEANFILES += $(GENERATEDDOCFILES) $(PROCESSEDDOCFILES)
+EXTRA_DIST += $(DOCFILES_NOINST)
 
 # pdf doc, written in mom and therefore using contrib/mom/mom.am
 # definitions
 EXTRA_DIST += doc/automake.mom
-if BUILD_PDFDOC
+if USE_GROPDF
 docpdfdocdir = $(pdfdocdir)
 nodist_docpdfdoc_DATA = doc/automake.pdf
-MOSTLYCLEANFILES += doc/automake.pdf
 endif
-doc/automake.pdf: doc/automake.mom \
-  groff troff gropdf pdfmom font/devpdf/build_font_files \
-  contrib/mom/om.tmac
+doc/automake.pdf: doc/automake.mom pdfmom contrib/mom/om.tmac
 
 # GNU PIC html documentation, installed in $(htmldocdir)
 # Other pic*.html files are installed by the local rule
-if BUILD_HTML
-HTMLDOCFILES = \
-  doc/pic.html
+if USE_GROHTML
 htmlpicdir = $(htmldocdir)
-htmlpic_DATA = $(HTMLDOCFILES)
+htmlpic_DATA = $(PROCESSEDDOCFILES_HTML)
 HTMLDOCFILESALL = pic*.html
 HTMLDOCIMAGEFILES = pic*
 endif
@@ -87,179 +129,345 @@
   doc/grnexmpl.g \
   doc/grnexmpl.me
 
-if BUILD_EXAMPLES
 # Generated in the build tree
-PROCESSEDEXAMPLEFILES = \
+if USE_GROHTML
+PROCESSEDEXAMPLEFILES_HTML = doc/webpage.html
+else
+PROCESSEDEXAMPLEFILES_HTML =
+endif
+PROCESSEDEXAMPLEFILES_PS = \
   doc/webpage.ps \
   doc/grnexmpl.ps
+PROCESSEDEXAMPLEFILES = \
+  $(PROCESSEDEXAMPLEFILES_HTML) \
+  $(PROCESSEDEXAMPLEFILES_PS)
+
+$(PROCESSEDEXAMPLEFILES_HTML): $(PROCESSEDFILES_DEPS_HTML)
+$(PROCESSEDEXAMPLEFILES_PS): $(PROCESSEDFILES_DEPS_PS)
+
 docexamplesdir = $(exampledir)
 dist_docexamples_DATA = $(EXAMPLEFILES)
 nodist_docexamples_DATA = $(PROCESSEDEXAMPLEFILES)
 MOSTLYCLEANFILES += $(PROCESSEDEXAMPLEFILES)
-else
-EXTRA_DIST += $(EXAMPLEFILES)
-endif
 
-if BUILD_HTMLEXAMPLES
-# webpage.html is generated, webpage*.html files are installed by the local rule.
-HTMLEXAMPLEFILES = doc/webpage.html
+if USE_GROHTML
+# webpage.html is generated; webpage*.html files are installed by the
+# local rule.
 HTMLEXAMPLEFILESALL = webpage*.html
 HTMLEXAMPLEIMAGEFILES = webpage*
 htmlexamplesdir = $(exampledir)
-nodist_htmlexamples_DATA = $(HTMLEXAMPLEFILES)
 endif
 
+# Locate image subdirectory for HTML documents relative to an
+# installation directory such as `htmldocdir` or `exampledir`.  Do _not_
+# use for locating files within the source or build trees.
 imagedir = img
-htmldocimagedir = $(htmldocdir)/img
-exampleimagedir = $(exampledir)/img
-
-MOSTLYCLEANFILES += doc/examples.stamp
 
 EXTRA_DIST += \
-  doc/gnu.xpm \
-  doc/fixinfo.sh \
   doc/txi-en.tex
 
-SUFFIXES += .me .ms .ps .html .txt .texi .dvi .pdf .xhtml
-
-# For simplicity, we always call preconv, grn, and eqn.
-.me.txt:
+# Introduce variables to house the groff man pages.  We break the list
+# of page sources into multiple chunks because we have to load Swedish
+# localization before formatting groff_mmse.7 and then reload English
+# localization afterward.  This also serves as a test of groff locale
+# switching; being lazy and shunting groff_mmse.7 off to the end of the
+# document would not achieve this goal (and not loading Swedish
+# localization at all to format it would be gauche).
+GROFF_MAN_PAGES1 = \
+  src/utils/addftinfo/addftinfo.1 \
+  src/utils/afmtodit/afmtodit.1 \
+  contrib/chem/chem.1 \
+  src/preproc/eqn/eqn.1 \
+  contrib/eqn2graph/eqn2graph.1 \
+  contrib/gdiffmk/gdiffmk.1 \
+  contrib/glilypond/glilypond.1 \
+  contrib/gperl/gperl.1 \
+  contrib/gpinyin/gpinyin.1 \
+  contrib/grap2graph/grap2graph.1 \
+  src/preproc/grn/grn.1 \
+  src/devices/grodvi/grodvi.1 \
+  src/roff/groff/groff.1 \
+  src/utils/grog/grog.1 \
+  src/devices/grohtml/grohtml.1 \
+  src/devices/grolbp/grolbp.1 \
+  src/devices/grolj4/grolj4.1 \
+  src/devices/gropdf/gropdf.1 \
+  src/devices/grops/grops.1 \
+  src/devices/grotty/grotty.1 \
+  $(GXDITVIEW_MAN1) \
+  src/utils/hpftodit/hpftodit.1 \
+  src/utils/indxbib/indxbib.1 \
+  src/utils/lkbib/lkbib.1 \
+  src/utils/lookbib/lookbib.1 \
+  contrib/mm/mmroff.1 \
+  src/preproc/eqn/neqn.1 \
+  src/roff/nroff/nroff.1 \
+  src/devices/gropdf/pdfmom.1 \
+  contrib/pdfmark/pdfroff.1 \
+  src/utils/pfbtops/pfbtops.1 \
+  src/preproc/pic/pic.1 \
+  contrib/pic2graph/pic2graph.1 \
+  src/preproc/preconv/preconv.1 \
+  src/preproc/refer/refer.1 \
+  src/preproc/soelim/soelim.1 \
+  src/preproc/tbl/tbl.1 \
+  src/utils/tfmtodit/tfmtodit.1 \
+  src/roff/troff/troff.1 \
+  $(XTOTROFF_MAN1) \
+  man/groff_font.5 \
+  man/groff_out.5 \
+  man/groff_tmac.5 \
+  man/groff.7 \
+  man/groff_char.7 \
+  man/groff_diff.7 \
+  contrib/hdtbl/groff_hdtbl.7 \
+  tmac/groff_man.7 \
+  tmac/groff_man_style.7 \
+  tmac/groff_mdoc.7 \
+  tmac/groff_me.7 \
+  contrib/mm/groff_mm.7
+
+GROFF_MAN_PAGES2 = \
+  contrib/mm/groff_mmse.7
+
+GROFF_MAN_PAGES3 = \
+  contrib/mom/groff_mom.7 \
+  tmac/groff_ms.7 \
+  contrib/rfc1345/groff_rfc1345.7 \
+  tmac/groff_trace.7 \
+  tmac/groff_www.7 \
+  man/roff.7
+
+GROFF_MAN_PAGES_ALL = $(GROFF_MAN_PAGES1) $(GROFF_MAN_PAGES2) \
+  $(GROFF_MAN_PAGES3)
+
+# This is a convenience target for (re-)generating all the man pages.
+man-all: $(GROFF_MAN_PAGES_ALL)
+
+# ...and for cleaning them.
+man-clean:
+	$(RM) $(GROFF_MAN_PAGES_ALL)
+
+# Many pages use tbl, a few use eqn, and soelim(1) uses pic.  We also
+# need groff's FreeEuro font so we can embed it.
+#
+# We embed the fonts (-P-e) to (1) honor the current PDF standard, (2)
+# ensure consistent rendering of the document, and (3) exercise this
+# feature of gropdf.
+doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) eqn pic tbl \
+  $(TMAC_PACKAGE_MAN) $(TMAC_PACKAGE_MDOC) font/devps/freeeuro.pfa
+	$(GROFF_V)$(DOC_GROFF) -pet -mandoc -dHF=HB -rC1 \
+	  -rCHECKSTYLE=3 -Tpdf -P-e \
+	  $(GROFF_MAN_PAGES1) \
+	  $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
+	  $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
+
+doc/groff-man-pages.utf8.txt: $(GROFF_MAN_PAGES_ALL) eqn pic tbl \
+  $(TMAC_PACKAGE_MAN) $(TMAC_PACKAGE_MDOC)
+	$(GROFF_V)$(DOC_GROFF) -pet -Tutf8 -mandoc \
+	  -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
+	  $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
+	  $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
+
+doc/grnexmpl.ps: $(doc_srcdir)/grnexmpl.me $(doc_srcdir)/grnexmpl.g \
+  grn eqn
+	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+	&& $(DOC_GROFF) -Tps -ge -me $(doc_srcdir)/grnexmpl.me >$@
+
+# Generating *.me from *.me.in is, surprisingly, a challenge.
+# 1.  A pattern rule ("%.me: %.me.in") is not portable to NetBSD or
+#     OpenBSD make.
+# 2.  A single-suffix rule works in an isolated Makefile, but _only_
+#     with the .SUFFIXES special target, not with the
+#     (Automake-specific) SUFFIXES macro.
+#       .SUFFIXES: .in
+#       .in:
+#		$(DOC_SED) $< >$@
+#     (One can validly complain that this approach is too general.)
+# 3.  GNU Automake insists that we use the SUFFIXES macro and not the
+#     special target.
+#       error: use variable 'SUFFIXES', not target '.SUFFIXES'
+# 4.  What about a target rule?  We'd have to explicitly write the first
+#     dependency name in the rule commands because NetBSD make (and
+#     reportedly OpenBSD) refuses to honor the $< variable in target
+#     rules.
+#
+# So what is left?  A double-suffix rule--but you have to use it in a
+# special way that is explicitly not countenanced by POSIX.
+#
+#   "The application shall ensure that the target portion is a valid
+#   target name (see Target Rules) of the form .s2 or .s1.s2 (where .s1
+#   and .s2 are suffixes that have been given as prerequisites of the
+#   .SUFFIXES special target and s1 and s2 do not contain any <slash> or
+#   <period> characters.) If there is only one <period> in the target,
+#   it is a single-suffix inference rule. Targets with two periods are
+#   double-suffix inference rules. Inference rules can have only one
+#   target before the <colon>."
+#     (POSIX Issue 8, make(1), "Inference Rules")
+#
+# A double-suffix rule won't work in an obvious way because its
+# semantics are that the suffix is replaced, not removed.  You have to
+# add both suffixes to the .SUFFIXES special target, in order with the
+# dependency first.
+#   .SUFFIXES: .me.in .me
+#   .me.in.me:
+#	$(DOC_SED) $< >$@
+# Thanks to Automake, we must say
+#   SUFFIXES += .me.in .me
+# for reason 3 above.  The GNU Automake manual does not explicitly state
+# that it preserves the ordering of the suffixes, but for now it does.
+#
+# It appears to be dumb luck that this works; the rigamarole by itself
+# justifies to me the worth of GNU Make's pattern rules (which require
+# neither '.SUFFIXES' nor 'SUFFIXES') and establishing semantics for $<
+# in target rules.  But I won't hold my breath waiting on other make(1)
+# implementors to agree.  -- GBR
+.PRECIOUS: $(GENERATEDDOCFILES)
+SUFFIXES += .me.in .me
+.me.in.me:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -k -Tutf8 -ge -me >$@
+	&& $(DOC_SED) $< >$@
+
 .me.ps:
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -k -Tps -ge -me >$@
+	&& $(DOC_GROFF) -Tps -me $< >$@
 
-.ms.html:
+# Use '-K utf8', not '-k', in case 'configure' didn't find uchardet.
+# The French translation uses tbl; its English counterpart does not.
+doc/meintro_fr.ps: doc/meintro_fr.me preconv
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -P-p -P-b -P-I`basename $< | sed -e 's|.ms$$||'` \
-	                -P-D$(imagedir) -Thtml -ms >$@
-.ms.txt:
+	&& $(DOC_GROFF) -K utf8 -t -Tps -me -mfr $< >$@
+
+doc/ms.ps: $(doc_srcdir)/ms.ms eqn tbl
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -Tascii -ms -mwww >$@
-.ms.ps:
+	&& $(DOC_GROFF) -et -Tps -ms $(doc_srcdir)/ms.ms >$@
+
+doc/pic.ps: $(doc_srcdir)/pic.ms eqn pic tbl
 	$(GROFF_V)$(MKDIR_P) `dirname $@` \
-	&& $(DOC_GROFF) -Tps -ms -mwww >$@
+	&& $(DOC_GROFF) -pet -Tps -ms $(doc_srcdir)/pic.ms >$@
 
-$(PROCESSEDEXAMPLEFILES): $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS) gnu.eps
-$(PROCESSEDEXAMPLEFILES): $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) $(hdtbltmac_DATA)
-$(PROCESSEDEXAMPLEFILES): $(dist_tmac_DATA) $(nodist_tmac_DATA)
-$(PROCESSEDDOCFILES): $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS) gnu.eps
+doc/webpage.ps: $(DOC_GNU_EPS) tmac/www.tmac tbl
+doc/webpage.ps: $(doc_srcdir)/webpage.ms
+	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+	&& $(DOC_GROFF) -I $(doc_srcdir) -I $(doc_builddir) -t -Tps \
+	  -ms -mwww $(doc_srcdir)/webpage.ms >$@
+
+# We have no "generic" ms documents.
+#.ms.ps:
+#	$(GROFF_V)$(MKDIR_P) `dirname $@` \
+#	&& $(DOC_GROFF) -Tps -ms $< >$@
 
+doc/pic.html: eqn pic tbl
 doc/pic.html: tmac/www.tmac
-doc/pic.html: $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS)
-doc/pic.html: doc/examples.stamp
-doc/pic.html: $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA)
-doc/pic.html: $(doc_srcdir)/pic.ms $(devhtmlfont_DATA)
+doc/pic.html: $(doc_srcdir)/pic.ms
 	$(GROFF_V)$(MKDIR_P) $(doc_builddir) \
 	&& cd $(doc_builddir) \
-	&& $(DOC_SED) $(doc_srcdir)/pic.ms \
-	   | $(DOC_GROFF_ONLY) -P-p -P-Ipic -P-D$(imagedir) -P-jpic \
-	                       -Thtml -ms > pic.html
-
-doc/examples.stamp: doc/groff.css
-	@$(MKDIR_P) $(doc_builddir)
-	test -f $(doc_builddir)/groff.css || cp $(doc_srcdir)/groff.css $(doc_builddir)
-	echo timestamp > $@
-
-doc/webpage.html: $(bin_PROGRAMS) $(prefixexecbin_PROGRAMS)
-doc/webpage.html: doc/examples.stamp $(devhtmlfont_DATA)
-doc/webpage.html: $(dist_devpsfont_DATA) $(nodist_devpsfont_DATA) 
-doc/webpage.html: $(doc_srcdir)/webpage.ms gnu.eps $(doc_srcdir)/groff.css
-	$(GROFF_V)$(MKDIR_P) doc \
+	&& $(DOC_GROFF) -pet -P-Ipic -P-Dimg -P-jpic -Thtml -ms \
+	  $(doc_srcdir)/pic.ms > pic.html
+
+doc/webpage.html: tbl
+doc/webpage.html: tmac/www.tmac
+doc/webpage.html: $(DOC_GNU_EPS)
+doc/webpage.html: $(doc_srcdir)/groff.css
+doc/webpage.html: $(doc_srcdir)/webpage.ms
+	$(GROFF_V)$(MKDIR_P) $(doc_builddir) \
 	&& cd $(doc_builddir) \
-	&& $(DOC_SED) $(doc_srcdir)/webpage.ms \
-	   | $(DOC_GROFF_ONLY) -P-jwebpage -P-nrpb -P-Iwebpage \
-	                       -P-D$(imagedir) -Thtml -ms > webpage.html
+	&& $(DOC_GROFF) -t -I $(doc_srcdir) -P-jwebpage -P-nrb \
+	  -P-Iwebpage -P-Dimg -Thtml -ms $(doc_srcdir)/webpage.ms \
+	  > webpage.html
 
-doc/grnexmpl.ps: doc/grnexmpl.me doc/grnexmpl.g
-
-# Note that we remove groff.css only if out-of-source build tree
+# We remove groff.css only from an out-of-source build tree.
 mostlyclean-local: mostlyclean_doc
 mostlyclean_doc:
-if BUILD_HTML
+if USE_GROHTML
 	if test -d $(doc_builddir); then \
-	  cd $(doc_builddir) && \
-	  for f in $(HTMLDOCFILESALL); do \
+	  cd $(doc_builddir) \
+	  && for f in $(HTMLDOCFILESALL); do \
 	    $(RM) $$f; \
 	  done; \
 	fi
-	if test -d $(doc_builddir)/$(imagedir); then \
-	  cd $(doc_builddir)/$(imagedir) && \
-	  for f in $(HTMLDOCIMAGEFILES); do \
+	if test -d $(doc_builddir)/img; then \
+	  cd $(doc_builddir)/img \
+	  && for f in $(HTMLDOCIMAGEFILES); do \
 	    $(RM) $$f; \
 	  done; \
+	  rmdir  $(doc_builddir)/img || :; \
 	fi
 endif
 	if test $(top_builddir) != $(top_srcdir); then \
 	  $(RM) $(top_builddir)/doc/groff.css; \
 	fi
-
-if BUILD_HTMLEXAMPLES
+if USE_GROHTML
 	if test -d $(doc_builddir); then \
-	  cd $(doc_builddir) && \
-	  for f in $(HTMLEXAMPLEFILESALL); do \
+	  cd $(doc_builddir) \
+	  && for f in $(HTMLEXAMPLEFILESALL); do \
 	    $(RM) $$f; \
 	  done; \
 	fi
-	if test -d $(doc_builddir)/$(imagedir); then \
-	  cd $(doc_builddir)/$(imagedir) && \
-	  for f in $(HTMLEXAMPLEIMAGEFILES); do \
+	if test -d $(doc_builddir)/img; then \
+	  cd $(doc_builddir)/img \
+	  && for f in $(HTMLEXAMPLEIMAGEFILES); do \
 	    $(RM) $$f; \
 	  done; \
+	  rmdir  $(doc_builddir)/img || :; \
 	fi
 endif
 
 install-data-hook: install_doc_htmldoc
 install_doc_htmldoc:
-if BUILD_HTML
-	cd $(doc_builddir) && \
-	for f in `ls $(HTMLDOCFILESALL)`; do \
+if USE_GROHTML
+	cd $(doc_builddir) \
+	&& for f in `ls $(HTMLDOCFILESALL)`; do \
 	  $(RM) $(DESTDIR)$(htmldocdir)/$$f; \
 	  $(INSTALL_DATA) $$f $(DESTDIR)$(htmldocdir)/$$f; \
 	done
-	-test -d $(DESTDIR)$(htmldocimagedir) \
-	  || $(mkinstalldirs) $(DESTDIR)$(htmldocimagedir)
-	$(RM) $(DESTDIR)$(htmldocimagedir)/$(HTMLDOCIMAGEFILES)
-	$(INSTALL_DATA) $(doc_builddir)/$(imagedir)/$(HTMLDOCIMAGEFILES) \
-	  $(DESTDIR)$(htmldocimagedir)
+	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/$(imagedir)
+	$(RM) $(DESTDIR)$(htmldocdir)/$(imagedir)/$(HTMLDOCIMAGEFILES)
+	$(INSTALL_DATA) $(doc_builddir)/img/$(HTMLDOCIMAGEFILES) \
+	  $(DESTDIR)$(htmldocdir)/$(imagedir)
 endif
 
-install-data-hook: install_doc_examples
-install_doc_examples: gnu.eps
-if BUILD_EXAMPLES
-# Prefer gnu.eps in builddir over srcdir.
-	d=.; test -f "gnu.eps" || d=$(doc_srcdir); \
-	  $(RM) $(DESTDIR)$(exampledir)/gnu.eps; \
-	  $(INSTALL_DATA) $$d/gnu.eps $(DESTDIR)$(exampledir)/gnu.eps
-endif
-if BUILD_HTMLEXAMPLES
-	cd $(doc_builddir) && \
-	for f in `ls $(HTMLEXAMPLEFILESALL)`; do \
+install-data-hook: install_doc_gnu_eps install_doc_examples
+
+install_doc_gnu_eps: $(DOC_GNU_EPS)
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if test -f "$$d/gnu.eps"; then \
+	    $(RM) $(DESTDIR)$(exampledir)/gnu.eps; \
+	    $(INSTALL_DATA) \
+	      $$d/gnu.eps $(DESTDIR)$(exampledir)/gnu.eps; \
+	    break; \
+	  fi; \
+	done
+
+install_doc_examples: $(DOC_GNU_EPS)
+if USE_GROHTML
+	cd $(doc_builddir) \
+	&& for f in `ls $(HTMLEXAMPLEFILESALL)`; do \
 	  $(RM) $(DESTDIR)$(exampledir)/$$f; \
 	  $(INSTALL_DATA) $$f $(DESTDIR)$(exampledir)/$$f; \
 	done
-	-test -d $(DESTDIR)$(exampleimagedir) \
-	  || $(mkinstalldirs) $(DESTDIR)$(exampleimagedir)
-	$(RM) $(DESTDIR)$(exampleimagedir)/$(HTMLEXAMPLEIMAGEFILES)
-	$(INSTALL_DATA) $(doc_builddir)/$(imagedir)/$(HTMLEXAMPLEIMAGEFILES) \
-	  $(DESTDIR)$(exampleimagedir)
+	-test -d $(DESTDIR)$(exampledir)/$(imagedir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(exampledir)/$(imagedir)
+	$(RM) \
+	  $(DESTDIR)$(exampledir)/$(imagedir)/$(HTMLEXAMPLEIMAGEFILES)
+	$(INSTALL_DATA) $(doc_builddir)/img/$(HTMLEXAMPLEIMAGEFILES) \
+	  $(DESTDIR)$(exampledir)/$(imagedir)
 endif
 
-uninstall-hook: uninstall_doc_examples uninstall_doc_htmldoc uninstall_mom
+uninstall-hook: \
+  uninstall_doc_examples uninstall_doc_htmldoc
 uninstall_doc_examples:
-if BUILD_EXAMPLES
-	$(RM) -f $(DESTDIR)$(exampledir)/gnu.eps
-endif
-if BUILD_HTMLEXAMPLES
-	-test -d $(DESTDIR)$(docexamplesdir) && \
-	cd $(DESTDIR)$(docexamplesdir) && \
-	for f in $(HTMLEXAMPLEFILESALL); do \
+	$(RM) $(DESTDIR)$(exampledir)/gnu.eps
+if USE_GROHTML
+	-test -d $(DESTDIR)$(docexamplesdir) \
+	&& cd $(DESTDIR)$(docexamplesdir) \
+	&& for f in $(HTMLEXAMPLEFILESALL); do \
 	  $(RM) $$f; \
 	done
-	-test -d $(DESTDIR)$(docexamplesdir)/$(imagedir) && \
-	cd $(DESTDIR)$(docexamplesdir)/$(imagedir) && \
-	for f in $(HTMLEXAMPLEIMAGEFILES); do \
+	-test -d $(DESTDIR)$(docexamplesdir)/$(imagedir) \
+	&& cd $(DESTDIR)$(docexamplesdir)/$(imagedir) \
+	&& for f in $(HTMLEXAMPLEIMAGEFILES); do \
 	  $(RM) $$f; \
 	done
 	-rmdir $(DESTDIR)$(docexamplesdir)/$(imagedir)
@@ -267,221 +475,237 @@
 endif
 
 uninstall_doc_htmldoc:
-if BUILD_HTML
-	-test -d $(DESTDIR)$(htmldocdir) && \
-	cd $(DESTDIR)$(htmldocdir) && \
-	for f in $(HTMLDOCFILESALL); do \
+if USE_GROHTML
+	-test -d $(DESTDIR)$(htmldocdir) \
+	&& cd $(DESTDIR)$(htmldocdir) \
+	&& for f in $(HTMLDOCFILESALL); do \
 	  $(RM) $$f; \
 	done
-	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) && \
-	cd $(DESTDIR)$(htmldocdir)/$(imagedir) && \
-	for f in $(HTMLDOCIMAGEFILES); do \
+	-test -d $(DESTDIR)$(htmldocdir)/$(imagedir) \
+	&& cd $(DESTDIR)$(htmldocdir)/$(imagedir) \
+	&& for f in $(HTMLDOCIMAGEFILES); do \
 	  $(RM) $$f; \
 	done
 	-rmdir $(DESTDIR)$(htmldocdir)/$(imagedir)
 	-rmdir $(DESTDIR)$(htmldocdir)
 endif
 
-# Texinfo doc
+# groff Texinfo manual
 #
-# Users who want to print out the groff manual are expected to have a
-# working TeX installation.  Note that texi2dvi properly honours the
-# `MAKEINFO' environment variable.
+# We produce all possible formats by by default and ship them in the
+# distribution archive ('make dist') so that people don't need to have
+# 'makeinfo' or TeX available.
 #
-# We can't use automake's facilities because the make dist target attempts to 
-# generate a pdf version of groff.texi by invoking texi2dvi without the -e 
-# option, which is needed to build this file.
-# info_TEXINFOS = doc/groff.texi
-# doc_groff_TEXINFOS = doc/fdl.texi
+# The GNU info, plain text, and HTML formats require only 'makeinfo'.
 #
-# Note that GNU standards require to install only info doc. Info doc
-# can still be disabled by passing 
-# --with-doc=<something else than info or yes> 
-# to configure
-
-all: build_infodoc
-if BUILD_INFODOC
-build_infodoc: doc/groff.info
-groffinfodir = $(infodir)
-groffpdfdir = $(infodir)
-MOSTLYCLEANFILES += doc/groff.info doc/groff.info-2 doc/groff.info-2
-doc/groff.info: $(doc_srcdir)/groff.texi
-	@$(MKDIR_P) $(doc_builddir)
-	LANG=C \
-	LC_ALL=C \
-	$(MAKEINFO) -o doc/groff.info --enable-encoding -I$(doc_srcdir) $(doc_srcdir)/groff.texi
-else
-build_infodoc:
+# DVI and PDF require a working TeX installation.  We can't use
+# Automake's facilities for PDF production because its 'dist' target
+# attempts to generate 'groff.pdf' by invoking 'texi2dvi' without the
+# '-E' option (use 'makeinfo' to expand macros), which is needed to
+# build this file.  'texi2dvi' honors the 'MAKEINFO' environment
+# variable.
+#
+# Were the foregoing not true, we would simply say this:
+#info_TEXINFOS = doc/groff.texi
+#doc_groff_TEXINFOS = doc/fdl.texi
+
+if USE_TEX
+GROFF_DVI = doc/groff.dvi
+GROFF_PDF = doc/groff.pdf
 endif
+
+all: doc/groff.info doc/groff.txt doc/groff.html $(GROFF_DVI) \
+  $(GROFF_PDF)
+
+# Distribute the manual in source form as well.
 EXTRA_DIST += doc/groff.texi doc/fdl.texi
 
-# GNU Make has a built-in variable TEXI2DVI but it is not the case of
-# all 'make' implementation.  As it default to 'texi2dvi' we simply
-# redefine it here.
+EXTRA_DIST += doc/groff.info
+MAINTAINERCLEANFILES += doc/groff.info
+doc/groff.info: $(doc_srcdir)/groff.texi
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
+	LC_ALL=C \
+	$(MAKEINFO) -o doc/groff.info --enable-encoding \
+	  -I $(doc_srcdir) $(doc_srcdir)/groff.texi
 
-TEXI2DVI = texi2dvi
-texi2dvi_missing = no
-# Rules to generate various doc files from .texi files.
+# Distribute the Info files.
+dist-hook: dist-info-bits
+dist-info-bits:
+	chmod u+w $(distdir)/doc
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/groff.info ; then \
+	    cp -f "$$d"/groff.info-* $(distdir)/doc; \
+	    break; \
+	  fi; \
+	done
+
+EXTRA_DIST += doc/groff.txt
+MAINTAINERCLEANFILES += doc/groff.txt
 .texi.txt:
-	@$(MKDIR_P) $(doc_builddir)
-	LANG=C \
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
+	LC_ALL=C \
+	$(MAKEINFO) --enable-encoding -I $(doc_srcdir) --plaintext \
+	  -o $@ $<
+
+# Generate HTML, both split into several files, and as a single file.
+# 'html' and its installation counterpart 'install-html' are standard
+# Automake targets.
+EXTRA_DIST += doc/groff.html doc/groff.html.node
+MAINTAINERCLEANFILES += doc/groff.html doc/groff.html.node
+.texi.html:
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)/
+	$(AM_V_GEN)LANG=C \
+	LC_ALL=C \
+	$(MAKEINFO) --html -I $(doc_srcdir) \
+	  -o doc/`basename $@`.node $<
+	$(AM_V_at)LANG=C \
 	LC_ALL=C \
-	$(MAKEINFO) --enable-encoding -I$(doc_srcdir) --plaintext -o $@ $<
+	$(MAKEINFO) --html -I $(doc_srcdir) --no-split \
+	  -o $@ $<
 
+EXTRA_DIST += doc/groff.dvi doc/groff.pdf
+
+# Define pattern rules to make our Texinfo manual in DVI and PDF
+# formats.  'pdf' and 'dvi' and their installation counterparts
+# 'install-pdf' and 'install-dvi' are standard Automake targets.
 .texi.dvi:
 if HAVE_TEXI2DVI
-	@$(MKDIR_P) $(doc_builddir)
-	LANG=C \
+if USE_TEX
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
 	LC_ALL=C \
 	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
 	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
-	$(TEXI2DVI) -e --batch --build-dir=doc/`basename $@`.t2d -o $@ $<
+	FORCE_SOURCE_DATE=1 \
+	$(PROG_TEXI2DVI) -e --batch --build-dir=doc/`basename $@`.t2d \
+	  -o $@ $<
 else
-	@echo "Program texi2dvi is missing, cannot generate dvi doc"; \
+	@echo "program 'tex' is missing; cannot generate $@" >&2; \
 	exit 1
-endif
+endif # USE_TEX
+else
+	@echo "program 'texi2dvi' is missing or too old;" \
+	  "cannot generate $@" >&2; \
+	exit 1
+endif # HAVE_TEXI2DVI
 
 .texi.pdf:
 if HAVE_TEXI2DVI
-	@$(MKDIR_P) $(doc_builddir)
-	LANG=C \
+if USE_TEX
+	$(AM_V_at)$(MKDIR_P) $(doc_builddir)
+	$(AM_V_GEN)LANG=C \
 	LC_ALL=C \
 	TEXINPUTS="$(top_srcdir)/build-aux:$(TEXINPUTS)" \
 	MAKEINFO='$(MAKEINFO) -I $(doc_srcdir)' \
-	$(TEXI2DVI) -e --batch --pdf --build-dir=doc/`basename $@`.t2p -o $@ $<
+	$(PROG_TEXI2DVI) -e --batch --pdf \
+	  --build-dir=doc/`basename $@`.t2p -o $@ $<
 else
-	@echo "Program texi2dvi is missing, cannot generate pdf doc"; \
+	@echo "program 'tex' is missing; cannot generate $@" >&2; \
 	exit 1
-endif
-
-# This will generate both html split into several files and html doc
-# in a single file. If texinfo version < 5.0, we process the resulting
-# (mono) .html file with fixinfo.sh du to a problem with blockquote
-# closing (for example 5.6.1 Setting Registers, the 'Request'
-# blockquote is not properly closed, see fixinfo.sh for more details
-.texi.html:
-	@$(MKDIR_P) $(doc_builddir)/
-	LANG=C \
-	LC_ALL=C \
-	$(MAKEINFO) --html -I $(doc_srcdir) \
-	  -o doc/`basename $@`.node $<
-	LANG=C \
-	LC_ALL=C \
-	$(MAKEINFO) --html -I $(doc_srcdir) --no-split \
-	  -o $@ $<
-	if test "$(makeinfo_version_numeric)" -lt 5000; then \
-	  echo "patching $@ with fixinfo.sh"; \
-	  $(SHELL) $(doc_srcdir)/fixinfo.sh \
-	    doc/`basename $@`.mono/`basename $@`; \
-	fi
+endif # USE_TEX
+else
+	@echo "program 'texi2dvi' is missing or too old;" \
+	  "cannot generate $@" >&2; \
+	exit 1
+endif # HAVE_TEXI2DVI
 
-# Targets to make all the doc in all formats. These doc are not built
-# by default. pdf, dvi, ps, html and their install equivalent
-# install-pdf, install-dvi, install-ps, install-html are standard
-# Automake targets.
+install-doc: install-dvi install-html install-pdf
 
-if BUILD_INFODOC
-doc: doc_all
-doc_all: doc_txt dvi pdf html
-doc_txt: doc/groff.txt
-dvi: doc_dvi
-doc_dvi: doc/groff.dvi
-pdf: doc_pdf
-doc_pdf: doc/groff.pdf
-html: doc_html
-doc_html: doc/groff.html
-install-doc: install-pdf install-html
-endif
+maintainer-clean-local:
+	$(RM) $(doc_builddir)/groff.info*
+	$(RM) $(doc_builddir)/groff.pdf
+	$(RM) $(doc_builddir)/groff.dvi
+	$(RM) $(doc_builddir)/groff.txt
+	$(RM) -r $(doc_builddir)/groff.html.*
 
-distclean-local: clean_infodoc clean_otherdoc
-maintainer-clean-local: clean_infodoc clean_otherdoc
-clean_infodoc:
-	-$(RM) $(doc_builddir)/groff.info*
-	-$(RM) $(doc_builddir)/groff.pdf
-	-$(RM) $(doc_builddir)/groff.dvi
-	-$(RM) -r $(doc_builddir)/groff.html.*
-clean_otherdoc:
-	-cd $(doc_builddir) && \
-	  $(RM) -r *.pdf *.html *.txt *.dvi *.t2p *.t2d
+install-data-local: install-txt
+install-txt:
+	-test -d $(DESTDIR)$(docdir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(docdir)
+	cp $(top_srcdir)/doc/groff.txt $(DESTDIR)$(docdir)
 
 install-data-local: install_infodoc
-if BUILD_INFODOC
 install_infodoc: doc/groff.info
-	-test -d $(DESTDIR)$(infodir) || $(mkinstalldirs) $(DESTDIR)$(infodir)
-	  for p in doc/groff.info `ls doc/groff.info*`; do \
-	    f=`basename $$p`; \
-	    $(RM) $(DESTDIR)$(infodir)/$$f; \
-	    $(INSTALL_DATA) $$p $(DESTDIR)$(infodir)/$$f; \
-	  done
-	$(INSTALL_INFO) --info-dir=$(DESTDIR)$(infodir) \
-	  $(DESTDIR)$(infodir)/groff.info
+	-test -d $(DESTDIR)$(infodir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(infodir)
+	$(RM) $(DESTDIR)/doc/groff.info*
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/groff.info ; then \
+	    cp "$$d"/groff.info* $(DESTDIR)$(infodir); \
+	    $(INSTALL_INFO) --info-file="$$d"/groff.info \
+	      --info-dir=$(DESTDIR)$(infodir); \
+	    break; \
+	  fi; \
+	done
 install-pdf-local: doc/groff.pdf
-	-test -d $(DESTDIR)$(pdfdocdir) || $(mkinstalldirs) $(DESTDIR)$(pdfdocdir)
-	cp $(top_builddir)/doc/groff.pdf $(DESTDIR)$(pdfdocdir)
+	-test -d $(DESTDIR)$(pdfdocdir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(pdfdocdir)
+	cp $(top_srcdir)/doc/groff.pdf $(DESTDIR)$(pdfdocdir)
 install-html-local: doc/groff.html
-	-test -d $(DESTDIR)$(htmldocdir)/groff.html.mono || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/groff.html.mono
-	cp -r $(top_builddir)/doc/groff.html $(DESTDIR)$(htmldocdir)/groff.html.mono
-	cp -r $(top_builddir)/doc/groff.html.node $(DESTDIR)$(htmldocdir)
-else
-install_infodoc:
-endif
-
-uninstall-local: uninstall_infodoc uninstall-pdf uninstall-html
+	-test -d $(DESTDIR)$(htmldocdir)/groff.html.mono \
+	  || $(mkinstalldirs) $(DESTDIR)$(htmldocdir)/groff.html.mono
+	cp -r $(top_srcdir)/doc/groff.html \
+	  $(DESTDIR)$(htmldocdir)/groff.html.mono
+	cp -r $(top_srcdir)/doc/groff.html.node \
+	  $(DESTDIR)$(htmldocdir)
+
+uninstall-local: uninstall_infodoc uninstall-pdf uninstall-html \
+  uninstall-txt
 uninstall_doc: uninstall-local
 uninstall-doc: uninstall-local
 uninstall_infodoc:
-if BUILD_INFODOC
 	-$(INSTALL_INFO) --remove --info-dir=$(DESTDIR)$(infodir) \
 	  $(DESTDIR)$(infodir)/groff.info
 	-for f in `ls $(DESTDIR)$(infodir)/groff.info*`; do \
 	  $(RM) $$f; \
 	done
-endif
 uninstall-pdf:
-if BUILD_INFODOC
-	-$(RM) -f $(DESTDIR)$(pdfdocdir)/groff.pdf 
-endif
+	$(RM) $(DESTDIR)$(pdfdocdir)/groff.pdf
+	-rmdir $(DESTDIR)$(pdfdocdir)
 uninstall-html:
-if BUILD_INFODOC
-	-$(RM) -r $(DESTDIR)$(htmldocdir)/groff.html.*
-endif
-
-# File used by contrib/hdtbl and contrib/pdfmark. It is distributed in
-# doc.eps. We try in priority to use the file in 'doc'.
-EXTRA_DIST += doc/gnu.xpm
-MOSTLYCLEANFILES += gnu.eps
-gnu.eps:
-	echo $(XPMTOPPM)
-	if test -f $(top_srcdir)/doc/gnu.eps; then \
-	  cp $(top_srcdir)/doc/gnu.eps . ; \
-	elif test -f $(top_builddir)/doc/gnu.eps; then \
-	  cp $(top_builddir)/doc/gnu.eps . ; \
-	else \
-	  if test ""$(XPMTOPPM) != "found"; then \
-	    echo "Program xpmtoppm is missing, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  if test ""$(pnmtops) != "found"; then \
-	    echo "Program pnmtops is missing, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  if test "$(pnmtops_nosetpage)" != "pnmtops -nosetpage"; then \
-	    echo "Program pnmtops can't handle -nosetpage, can't generate gnu.eps" ; \
-	    exit 1; \
-	  fi; \
-	  xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmdepth 15 \
-	    | $(pnmtops_nosetpage) -noturn -rle >$@ ; \
-	fi
-
-# Copy gnu.eps in 'doc' directory
+	$(RM) $(DESTDIR)$(htmldocdir)/groff.html.mono/*
+	$(RM) $(DESTDIR)$(htmldocdir)/groff.html.node/*
+uninstall-txt:
+	$(RM) $(DESTDIR)$(docdir)/groff.txt
+
+# An image of a gnu in enscapsulated PostScript is generated during the
+# build process if necessary.  Our configure script assumes pnmdepth is
+# available if xpmtoppm is (see macro "GROFF_PROG_XPMTOPPM").
+EXTRA_DIST += $(DOC_GNU_EPS) doc/gnu.xpm
+$(DOC_GNU_EPS): doc/gnu.xpm
+	$(AM_V_GEN)if test "$(XPMTOPPM)" != found; then \
+	  echo "program 'xpmtoppm' is missing; can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	if test "$(pnmtops)" != found; then \
+	  echo "program 'pnmtops' is missing; can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	if ! echo "$(pnmtops_nosetpage)" | grep -q nosetpage; then \
+	  echo "program 'pnmtops' can't handle -nosetpage option;" \
+	    "can't generate $@" >&2; \
+	  exit 1; \
+	fi; \
+	xpmtoppm $(top_srcdir)/doc/gnu.xpm | pnmdepth 15 \
+	  | $(pnmtops_nosetpage) -noturn -rle >$@
+
+# Provide a copy of the image in the distribution archive to accommodate
+# systems without a tool to generate it from an X pixmap.
 dist-hook: dist-gnueps
 dist-gnueps:
 	chmod u+w $(distdir)/doc
-	cp -f gnu.eps $(distdir)/doc
+	for d in $(doc_builddir) $(doc_srcdir); do \
+	  if  -f "$$d"/$(DOC_GNU_EPS) ; then \
+	    cp -f "$$d"/$(DOC_GNU_EPS) $(distdir)/doc; \
+	    break; \
+	  fi; \
+	done
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.dvi Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html Added

@@ -0,0 +1,24945 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>The GNU Troff Manual</title>
+
+<meta name="description" content="The GNU Troff Manual">
+<meta name="keywords" content="The GNU Troff Manual">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="#Top" rel="start" title="Top">
+<link href="#Request-Index" rel="index" title="Request Index">
+<link href="#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="dir.html#Top" rel="up" title="(dir)">
+<link href="#Introduction" rel="next" title="Introduction">
+<link href="dir.html#Top" rel="prev" title="(dir)">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="top-level-extent" id="Top">
+<div class="nav-panel">
+<p>
+Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h1 class="top" id="GNU-troff">GNU <code class="code">troff</code></h1>
+
+
+<p>This manual documents GNU <code class="code">troff</code> version 1.23.0.
+</p>
+<p>Copyright &copy; 1994&ndash;2023 Free Software Foundation, Inc.
+</p>
+<blockquote class="quotation">
+<p>Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
+copy of the license is included in the section entitled &ldquo;GNU Free
+Documentation License&rdquo;.
+</p></blockquote>
+
+
+
+
+
+<div class="element-contents" id="SEC_Contents">
+<h2 class="contents-heading">Table of Contents</h2>
+
+<div class="contents">
+
+<ul class="toc-numbered-mark">
+  <li><a id="toc-Introduction-1" href="#Introduction">1 Introduction</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Background-1" href="#Background">1.1 Background</a></li>
+    <li><a id="toc-What-Is-groff_003f-1" href="#What-Is-groff_003f">1.2 What Is <code class="code">groff</code>?</a></li>
+    <li><a id="toc-groff-Capabilities-1" href="#groff-Capabilities">1.3 <code class="code">groff</code> Capabilities</a></li>
+    <li><a id="toc-Macro-Packages-1" href="#Macro-Package-Intro">1.4 Macro Packages</a></li>
+    <li><a id="toc-Preprocessors" href="#Preprocessor-Intro">1.5 Preprocessors</a></li>
+    <li><a id="toc-Output-Devices" href="#Output-Device-Intro">1.6 Output Devices</a></li>
+    <li><a id="toc-Installation-1" href="#Installation">1.7 Installation</a></li>
+    <li><a id="toc-Conventions-Used-in-This-Manual-1" href="#Conventions-Used-in-This-Manual">1.8 Conventions Used in This Manual</a></li>
+    <li><a id="toc-Credits-1" href="#Credits">1.9 Credits</a></li>
+  </ul></li>
+  <li><a id="toc-Invoking-groff-1" href="#Invoking-groff">2 Invoking <code class="code">groff</code></a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Options" href="#Groff-Options">2.1 Options</a></li>
+    <li><a id="toc-Environment-1" href="#Environment">2.2 Environment</a></li>
+    <li><a id="toc-Macro-Directories-1" href="#Macro-Directories">2.3 Macro Directories</a></li>
+    <li><a id="toc-Font-Directories-1" href="#Font-Directories">2.4 Font Directories</a></li>
+    <li><a id="toc-Paper-Format-1" href="#Paper-Format">2.5 Paper Format</a></li>
+    <li><a id="toc-Invocation-Examples-1" href="#Invocation-Examples">2.6 Invocation Examples</a></li>
+  </ul></li>
+  <li><a id="toc-Tutorial-for-Macro-Users-1" href="#Tutorial-for-Macro-Users">3 Tutorial for Macro Users</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Basics-1" href="#Basics">3.1 Basics</a></li>
+    <li><a id="toc-Common-Features-1" href="#Common-Features">3.2 Common Features</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Paragraphs-1" href="#Paragraphs">3.2.1 Paragraphs</a></li>
+      <li><a id="toc-Sections-and-Chapters-1" href="#Sections-and-Chapters">3.2.2 Sections and Chapters</a></li>
+      <li><a id="toc-Headers-and-Footers-1" href="#Headers-and-Footers">3.2.3 Headers and Footers</a></li>
+      <li><a id="toc-Page-Layout-1" href="#Page-Layout-Adjustment">3.2.4 Page Layout</a></li>
+      <li><a id="toc-Displays-and-Keeps-1" href="#Displays-and-Keeps">3.2.5 Displays and Keeps</a></li>
+      <li><a id="toc-Footnotes-and-Endnotes-1" href="#Footnotes-and-Endnotes">3.2.6 Footnotes and Endnotes</a></li>
+      <li><a id="toc-Table-of-Contents-1" href="#Table-of-Contents">3.2.7 Table of Contents</a></li>
+      <li><a id="toc-Indexing-1" href="#Indexing">3.2.8 Indexing</a></li>
+      <li><a id="toc-Document-Formats-1" href="#Document-Formats">3.2.9 Document Formats</a></li>
+      <li><a id="toc-Columnation-1" href="#Columnation">3.2.10 Columnation</a></li>
+      <li><a id="toc-Font-and-Size-Changes-1" href="#Font-and-Size-Changes">3.2.11 Font and Size Changes</a></li>
+      <li><a id="toc-Predefined-Text-1" href="#Predefined-Text">3.2.12 Predefined Text</a></li>
+      <li><a id="toc-Preprocessor-Support-1" href="#Preprocessor-Support">3.2.13 Preprocessor Support</a></li>
+      <li><a id="toc-Configuration-and-Customization-1" href="#Configuration-and-Customization">3.2.14 Configuration and Customization</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-Macro-Packages-2" href="#Major-Macro-Packages">4 Macro Packages</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-man-1" href="#man">4.1 <samp class="file">man</samp></a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Optional-man-extensions-1" href="#Optional-man-extensions">4.1.1 Optional <samp class="file">man</samp> extensions</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Custom-headers-and-footers" href="#Custom-headers-and-footers">Custom headers and footers</a></li>
+        <li><a id="toc-Ultrix_002dspecific-man-macros" href="#Ultrix_002dspecific-man-macros">Ultrix-specific man macros</a></li>
+        <li><a id="toc-Simple-example" href="#Simple-example">Simple example</a></li>
+      </ul></li>
+    </ul></li>
+    <li><a id="toc-mdoc-1" href="#mdoc">4.2 <samp class="file">mdoc</samp></a></li>
+    <li><a id="toc-me-1" href="#me">4.3 <samp class="file">me</samp></a></li>
+    <li><a id="toc-mm-1" href="#mm">4.4 <samp class="file">mm</samp></a></li>
+    <li><a id="toc-mom-1" href="#mom">4.5 <samp class="file">mom</samp></a></li>
+    <li><a id="toc-ms-1" href="#ms">4.6 <samp class="file">ms</samp></a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Introduction-2" href="#ms-Introduction">4.6.1 Introduction</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Basic-information" href="#ms-basic-information">4.6.1.1 Basic information</a></li>
+      </ul></li>
+      <li><a id="toc-Document-Structure" href="#ms-Document-Structure">4.6.2 Document Structure</a></li>
+      <li><a id="toc-Document-Control-Settings" href="#ms-Document-Control-Settings">4.6.3 Document Control Settings</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Margin-settings" href="#Margin-settings">Margin settings</a></li>
+        <li><a id="toc-Titles-_0028headers_002c-footers_0029" href="#Titles-_0028headers_002c-footers_0029">Titles (headers, footers)</a></li>
+        <li><a id="toc-Text-settings" href="#Text-settings">Text settings</a></li>
+        <li><a id="toc-Paragraph-settings" href="#Paragraph-settings">Paragraph settings</a></li>
+        <li><a id="toc-Heading-settings" href="#Heading-settings">Heading settings</a></li>
+        <li><a id="toc-Footnote-settings" href="#Footnote-settings">Footnote settings</a></li>
+        <li><a id="toc-Display-settings" href="#Display-settings">Display settings</a></li>
+        <li><a id="toc-Other-settings" href="#Other-settings">Other settings</a></li>
+      </ul></li>
+      <li><a id="toc-Document-Description-Macros" href="#ms-Document-Description-Macros">4.6.4 Document Description Macros</a></li>
+      <li><a id="toc-Body-Text" href="#ms-Body-Text">4.6.5 Body Text</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Text-settings-1" href="#Text-settings-in-ms">4.6.5.1 Text settings</a></li>
+        <li><a id="toc-Typographical-symbols" href="#Typographical-symbols-in-ms">4.6.5.2 Typographical symbols</a></li>
+        <li><a id="toc-Paragraphs-2" href="#Paragraphs-in-ms">4.6.5.3 Paragraphs</a></li>
+        <li><a id="toc-Headings" href="#Headings-in-ms">4.6.5.4 Headings</a></li>
+        <li><a id="toc-Typeface-and-decoration-1" href="#Typeface-and-decoration">4.6.5.5 Typeface and decoration</a></li>
+        <li><a id="toc-Lists" href="#Lists-in-ms">4.6.5.6 Lists</a></li>
+        <li><a id="toc-Indented-regions" href="#Indented-regions-in-ms">4.6.5.7 Indented regions</a></li>
+        <li><a id="toc-Keeps_002c-boxed-keeps_002c-and-displays" href="#ms-keeps-and-displays">4.6.5.8 Keeps, boxed keeps, and displays</a></li>
+        <li><a id="toc-Tables_002c-figures_002c-equations_002c-and-references" href="#ms-Insertions">4.6.5.9 Tables, figures, equations, and references</a></li>
+        <li><a id="toc-Footnotes" href="#ms-Footnotes">4.6.5.10 Footnotes</a></li>
+        <li><a id="toc-Language-and-localization" href="#ms-language-and-localization">4.6.5.11 Language and localization</a></li>
+      </ul></li>
+      <li><a id="toc-Page-layout" href="#ms-Page-Layout">4.6.6 Page layout</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Headers-and-footers" href="#ms-Headers-and-Footers">4.6.6.1 Headers and footers</a></li>
+        <li><a id="toc-Tab-stops" href="#Tab-Stops-in-ms">4.6.6.2 Tab stops</a></li>
+        <li><a id="toc-Margins" href="#ms-Margins">4.6.6.3 Margins</a></li>
+        <li><a id="toc-Multiple-columns" href="#ms-Multiple-Columns">4.6.6.4 Multiple columns</a></li>
+        <li><a id="toc-Creating-a-table-of-contents" href="#ms-TOC">4.6.6.5 Creating a table of contents</a></li>
+      </ul></li>
+      <li><a id="toc-Differences-from-AT_0026T-ms-1" href="#Differences-from-AT_0026T-ms">4.6.7 Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Unix-Version-7-ms-macros-not-implemented-by-groff-ms" href="#Missing-Unix-Version-7-ms-Macros">4.6.7.1 Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></a></li>
+      </ul></li>
+      <li><a id="toc-Legacy-Features" href="#ms-Legacy-Features">4.6.8 Legacy Features</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-AT_0026T-accent-mark-strings" href="#AT_0026T-accent-mark-strings">AT&amp;T accent mark strings</a></li>
+        <li><a id="toc-Berkeley-accent-mark-and-glyph-strings" href="#Berkeley-accent-mark-and-glyph-strings">Berkeley accent mark and glyph strings</a></li>
+      </ul></li>
+      <li><a id="toc-Naming-Conventions" href="#ms-Naming-Conventions">4.6.9 Naming Conventions</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-GNU-troff-Reference-1" href="#GNU-troff-Reference">5 GNU <code class="code">troff</code> Reference</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Text-1" href="#Text">5.1 Text</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Filling-1" href="#Filling">5.1.1 Filling</a></li>
+      <li><a id="toc-Sentences-1" href="#Sentences">5.1.2 Sentences</a></li>
+      <li><a id="toc-Hyphenation-1" href="#Hyphenation">5.1.3 Hyphenation</a></li>
+      <li><a id="toc-Breaking-1" href="#Breaking">5.1.4 Breaking</a></li>
+      <li><a id="toc-Adjustment-1" href="#Adjustment">5.1.5 Adjustment</a></li>
+      <li><a id="toc-Tabs-and-Leaders-1" href="#Tabs-and-Leaders">5.1.6 Tabs and Leaders</a></li>
+      <li><a id="toc-Requests-and-Macros-1" href="#Requests-and-Macros">5.1.7 Requests and Macros</a></li>
+      <li><a id="toc-Macro-Packages-3" href="#Macro-Packages">5.1.8 Macro Packages</a></li>
+      <li><a id="toc-Input-Encodings-1" href="#Input-Encodings">5.1.9 Input Encodings</a></li>
+      <li><a id="toc-Input-Conventions-1" href="#Input-Conventions">5.1.10 Input Conventions</a></li>
+    </ul></li>
+    <li><a id="toc-Page-Geometry-1" href="#Page-Geometry">5.2 Page Geometry</a></li>
+    <li><a id="toc-Measurements-1" href="#Measurements">5.3 Measurements</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Motion-Quanta-1" href="#Motion-Quanta">5.3.1 Motion Quanta</a></li>
+      <li><a id="toc-Default-Units-1" href="#Default-Units">5.3.2 Default Units</a></li>
+    </ul></li>
+    <li><a id="toc-Numeric-Expressions-1" href="#Numeric-Expressions">5.4 Numeric Expressions</a></li>
+    <li><a id="toc-Identifiers-1" href="#Identifiers">5.5 Identifiers</a></li>
+    <li><a id="toc-Formatter-Instructions-1" href="#Formatter-Instructions">5.6 Formatter Instructions</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Control-Characters-1" href="#Control-Characters">5.6.1 Control Characters</a></li>
+      <li><a id="toc-Invoking-Requests-1" href="#Invoking-Requests">5.6.2 Invoking Requests</a></li>
+      <li><a id="toc-Calling-Macros-1" href="#Calling-Macros">5.6.3 Calling Macros</a></li>
+      <li><a id="toc-Using-Escape-Sequences-1" href="#Using-Escape-Sequences">5.6.4 Using Escape Sequences</a></li>
+      <li><a id="toc-Delimiters-1" href="#Delimiters">5.6.5 Delimiters</a></li>
+    </ul></li>
+    <li><a id="toc-Comments-1" href="#Comments">5.7 Comments</a></li>
+    <li><a id="toc-Registers-1" href="#Registers">5.8 Registers</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Setting-Registers-1" href="#Setting-Registers">5.8.1 Setting Registers</a></li>
+      <li><a id="toc-Interpolating-Registers-1" href="#Interpolating-Registers">5.8.2 Interpolating Registers</a></li>
+      <li><a id="toc-Auto_002dincrement-1" href="#Auto_002dincrement">5.8.3 Auto-increment</a></li>
+      <li><a id="toc-Assigning-Register-Formats-1" href="#Assigning-Register-Formats">5.8.4 Assigning Register Formats</a></li>
+      <li><a id="toc-Built_002din-Registers-1" href="#Built_002din-Registers">5.8.5 Built-in Registers</a></li>
+    </ul></li>
+    <li><a id="toc-Manipulating-Filling-and-Adjustment-1" href="#Manipulating-Filling-and-Adjustment">5.9 Manipulating Filling and Adjustment</a></li>
+    <li><a id="toc-Manipulating-Hyphenation-1" href="#Manipulating-Hyphenation">5.10 Manipulating Hyphenation</a></li>
+    <li><a id="toc-Manipulating-Spacing-1" href="#Manipulating-Spacing">5.11 Manipulating Spacing</a></li>
+    <li><a id="toc-Tabs-and-Fields-1" href="#Tabs-and-Fields">5.12 Tabs and Fields</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Leaders-1" href="#Leaders">5.12.1 Leaders</a></li>
+      <li><a id="toc-Fields-1" href="#Fields">5.12.2 Fields</a></li>
+    </ul></li>
+    <li><a id="toc-Character-Translations-1" href="#Character-Translations">5.13 Character Translations</a></li>
+    <li><a id="toc-troff-and-nroff-Modes-1" href="#troff-and-nroff-Modes">5.14 <code class="code">troff</code> and <code class="code">nroff</code> Modes</a></li>
+    <li><a id="toc-Line-Layout-1" href="#Line-Layout">5.15 Line Layout</a></li>
+    <li><a id="toc-Line-Continuation-1" href="#Line-Continuation">5.16 Line Continuation</a></li>
+    <li><a id="toc-Page-Layout-2" href="#Page-Layout">5.17 Page Layout</a></li>
+    <li><a id="toc-Page-Control-1" href="#Page-Control">5.18 Page Control</a></li>
+    <li><a id="toc-Using-Fonts-1" href="#Using-Fonts">5.19 Using Fonts</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Selecting-Fonts-1" href="#Selecting-Fonts">5.19.1 Selecting Fonts</a></li>
+      <li><a id="toc-Font-Families-1" href="#Font-Families">5.19.2 Font Families</a></li>
+      <li><a id="toc-Font-Positions-1" href="#Font-Positions">5.19.3 Font Positions</a></li>
+      <li><a id="toc-Using-Symbols-1" href="#Using-Symbols">5.19.4 Using Symbols</a></li>
+      <li><a id="toc-Character-Classes-1" href="#Character-Classes">5.19.5 Character Classes</a></li>
+      <li><a id="toc-Special-Fonts-1" href="#Special-Fonts">5.19.6 Special Fonts</a></li>
+      <li><a id="toc-Artificial-Fonts-1" href="#Artificial-Fonts">5.19.7 Artificial Fonts</a></li>
+      <li><a id="toc-Ligatures-and-Kerning-1" href="#Ligatures-and-Kerning">5.19.8 Ligatures and Kerning</a></li>
+      <li><a id="toc-Italic-Corrections-1" href="#Italic-Corrections">5.19.9 Italic Corrections</a></li>
+      <li><a id="toc-Dummy-Characters-1" href="#Dummy-Characters">5.19.10 Dummy Characters</a></li>
+    </ul></li>
+    <li><a id="toc-Manipulating-Type-Size-and-Vertical-Spacing-1" href="#Manipulating-Type-Size-and-Vertical-Spacing">5.20 Manipulating Type Size and Vertical Spacing</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Changing-the-Type-Size-1" href="#Changing-the-Type-Size">5.20.1 Changing the Type Size</a></li>
+      <li><a id="toc-Changing-the-Vertical-Spacing-1" href="#Changing-the-Vertical-Spacing">5.20.2 Changing the Vertical Spacing</a></li>
+      <li><a id="toc-Using-Fractional-Type-Sizes-1" href="#Using-Fractional-Type-Sizes">5.20.3 Using Fractional Type Sizes</a></li>
+    </ul></li>
+    <li><a id="toc-Colors-1" href="#Colors">5.21 Colors</a></li>
+    <li><a id="toc-Strings-1" href="#Strings">5.22 Strings</a></li>
+    <li><a id="toc-Conditionals-and-Loops-1" href="#Conditionals-and-Loops">5.23 Conditionals and Loops</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Operators-in-Conditionals-1" href="#Operators-in-Conditionals">5.23.1 Operators in Conditionals</a></li>
+      <li><a id="toc-if_002dthen-1" href="#if_002dthen">5.23.2 if-then</a></li>
+      <li><a id="toc-if_002delse-1" href="#if_002delse">5.23.3 if-else</a></li>
+      <li><a id="toc-Conditional-Blocks-1" href="#Conditional-Blocks">5.23.4 Conditional Blocks</a></li>
+      <li><a id="toc-while-1" href="#while">5.23.5 while</a></li>
+    </ul></li>
+    <li><a id="toc-Writing-Macros-1" href="#Writing-Macros">5.24 Writing Macros</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Parameters-1" href="#Parameters">5.24.1 Parameters</a></li>
+      <li><a id="toc-Copy-Mode-1" href="#Copy-Mode">5.24.2 Copy Mode</a></li>
+    </ul></li>
+    <li><a id="toc-Page-Motions-1" href="#Page-Motions">5.25 Page Motions</a></li>
+    <li><a id="toc-Drawing-Geometric-Objects-1" href="#Drawing-Geometric-Objects">5.26 Drawing Geometric Objects</a></li>
+    <li><a id="toc-Deferring-Output-1" href="#Deferring-Output">5.27 Deferring Output</a></li>
+    <li><a id="toc-Traps-1" href="#Traps">5.28 Traps</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Vertical-Position-Traps-1" href="#Vertical-Position-Traps">5.28.1 Vertical Position Traps</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Page-Location-Traps-1" href="#Page-Location-Traps">5.28.1.1 Page Location Traps</a></li>
+        <li><a id="toc-The-Implicit-Page-Trap-1" href="#The-Implicit-Page-Trap">5.28.1.2 The Implicit Page Trap</a></li>
+        <li><a id="toc-Diversion-Traps-1" href="#Diversion-Traps">5.28.1.3 Diversion Traps</a></li>
+      </ul></li>
+      <li><a id="toc-Input-Line-Traps-1" href="#Input-Line-Traps">5.28.2 Input Line Traps</a></li>
+      <li><a id="toc-Blank-Line-Traps-1" href="#Blank-Line-Traps">5.28.3 Blank Line Traps</a></li>
+      <li><a id="toc-Leading-Space-Traps-1" href="#Leading-Space-Traps">5.28.4 Leading Space Traps</a></li>
+      <li><a id="toc-End_002dof_002dinput-Traps-1" href="#End_002dof_002dinput-Traps">5.28.5 End-of-input Traps</a></li>
+    </ul></li>
+    <li><a id="toc-Diversions-1" href="#Diversions">5.29 Diversions</a></li>
+    <li><a id="toc-Punning-Names-1" href="#Punning-Names">5.30 Punning Names</a></li>
+    <li><a id="toc-Environments-1" href="#Environments">5.31 Environments</a></li>
+    <li><a id="toc-Suppressing-Output-1" href="#Suppressing-Output">5.32 Suppressing Output</a></li>
+    <li><a id="toc-I_002fO-1" href="#I_002fO">5.33 I/O</a></li>
+    <li><a id="toc-Postprocessor-Access-1" href="#Postprocessor-Access">5.34 Postprocessor Access</a></li>
+    <li><a id="toc-Miscellaneous-1" href="#Miscellaneous">5.35 Miscellaneous</a></li>
+    <li><a id="toc-gtroff-Internals" href="#Gtroff-Internals">5.36 <code class="code">gtroff</code> Internals</a></li>
+    <li><a id="toc-Debugging-1" href="#Debugging">5.37 Debugging</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Warnings-1" href="#Warnings">5.37.1 Warnings</a></li>
+    </ul></li>
+    <li><a id="toc-Implementation-Differences-1" href="#Implementation-Differences">5.38 Implementation Differences</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Safer-Mode-1" href="#Safer-Mode">5.38.1 Safer Mode</a></li>
+      <li><a id="toc-Compatibility-Mode-1" href="#Compatibility-Mode">5.38.2 Compatibility Mode</a></li>
+      <li><a id="toc-Other-Differences-1" href="#Other-Differences">5.38.3 Other Differences</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-File-Formats-1" href="#File-Formats">6 File Formats</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-gtroff-Output-1" href="#gtroff-Output">6.1 <code class="code">gtroff</code> Output</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Language-Concepts-1" href="#Language-Concepts">6.1.1 Language Concepts</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Separation-1" href="#Separation">6.1.1.1 Separation</a></li>
+        <li><a id="toc-Argument-Units-1" href="#Argument-Units">6.1.1.2 Argument Units</a></li>
+        <li><a id="toc-Document-Parts-1" href="#Document-Parts">6.1.1.3 Document Parts</a></li>
+      </ul></li>
+      <li><a id="toc-Command-Reference-1" href="#Command-Reference">6.1.2 Command Reference</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Comment-Command-1" href="#Comment-Command">6.1.2.1 Comment Command</a></li>
+        <li><a id="toc-Simple-Commands-1" href="#Simple-Commands">6.1.2.2 Simple Commands</a></li>
+        <li><a id="toc-Graphics-Commands-1" href="#Graphics-Commands">6.1.2.3 Graphics Commands</a></li>
+        <li><a id="toc-Device-Control-Commands-1" href="#Device-Control-Commands">6.1.2.4 Device Control Commands</a></li>
+        <li><a id="toc-Obsolete-Command-1" href="#Obsolete-Command">6.1.2.5 Obsolete Command</a></li>
+      </ul></li>
+      <li><a id="toc-Intermediate-Output-Examples-1" href="#Intermediate-Output-Examples">6.1.3 Intermediate Output Examples</a></li>
+      <li><a id="toc-Output-Language-Compatibility-1" href="#Output-Language-Compatibility">6.1.4 Output Language Compatibility</a></li>
+    </ul></li>
+    <li><a id="toc-Device-and-Font-Description-Files-1" href="#Device-and-Font-Description-Files">6.2 Device and Font Description Files</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-DESC-File-Format-1" href="#DESC-File-Format">6.2.1 <samp class="file">DESC</samp> File Format</a></li>
+      <li><a id="toc-Font-Description-File-Format-1" href="#Font-Description-File-Format">6.2.2 Font Description File Format</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-Copying-This-Manual-1" href="#Copying-This-Manual">Appendix A Copying This Manual</a></li>
+  <li><a id="toc-Request-Index-1" href="#Request-Index" rel="index">Appendix B Request Index</a></li>
+  <li><a id="toc-Escape-Sequence-Index-1" href="#Escape-Sequence-Index" rel="index">Appendix C Escape Sequence Index</a></li>
+  <li><a id="toc-Operator-Index-1" href="#Operator-Index" rel="index">Appendix D Operator Index</a></li>
+  <li><a id="toc-Register-Index-1" href="#Register-Index" rel="index">Appendix E Register Index</a></li>
+  <li><a id="toc-Macro-Index-1" href="#Macro-Index" rel="index">Appendix F Macro Index</a></li>
+  <li><a id="toc-String-Index-1" href="#String-Index" rel="index">Appendix G String Index</a></li>
+  <li><a id="toc-File-Keyword-Index-1" href="#File-Keyword-Index" rel="index">Appendix H File Keyword Index</a></li>
+  <li><a id="toc-Program-and-File-Index-1" href="#Program-and-File-Index" rel="index">Appendix I Program and File Index</a></li>
+  <li><a id="toc-Concept-Index-1" href="#Concept-Index" rel="index">Appendix J Concept Index</a></li>
+</ul>
+</div>
+</div>
+<hr>
+<div class="chapter-level-extent" id="Introduction">
+<div class="nav-panel">
+<p>
+Next: <a href="#Invoking-groff" accesskey="n" rel="next">Invoking <code class="code">groff</code></a>, Previous: <a href="#Top" accesskey="p" rel="prev">GNU <code class="code">troff</code></a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="Introduction-1">1 Introduction</h2>
+<a class="index-entry-id" id="index-introduction"></a>
+
+<p>GNU <code class="code">roff</code> (or <code class="code">groff</code>) is a programming system for
+typesetting documents.  It is highly flexible and has been used
+extensively for over thirty years.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Background" accesskey="1">Background</a></li>
+<li><a href="#What-Is-groff_003f" accesskey="2">What Is <code class="code">groff</code>?</a></li>
+<li><a href="#groff-Capabilities" accesskey="3"><code class="code">groff</code> Capabilities</a></li>
+<li><a href="#Macro-Package-Intro" accesskey="4">Macro Packages</a></li>
+<li><a href="#Preprocessor-Intro" accesskey="5">Preprocessors</a></li>
+<li><a href="#Output-Device-Intro" accesskey="6">Output Devices</a></li>
+<li><a href="#Installation" accesskey="7">Installation</a></li>
+<li><a href="#Conventions-Used-in-This-Manual" accesskey="8">Conventions Used in This Manual</a></li>
+<li><a href="#Credits" accesskey="9">Credits</a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="Background">
+<div class="nav-panel">
+<p>
+Next: <a href="#What-Is-groff_003f" accesskey="n" rel="next">What Is <code class="code">groff</code>?</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Background-1">1.1 Background</h3>
+<a class="index-entry-id" id="index-background"></a>
+
+<p>M. Douglas McIlroy, formerly of AT&amp;T Bell Laboratories and present at
+the creation of the Unix operating system, offers an authoritative
+historical summary.
+</p>
+<blockquote class="quotation">
+<p>The prime reason for Unix was the desire of Ken Thompson, Dennis
+Ritchie, and Joe Ossanna to have a pleasant environment for software
+development.  The fig leaf that got the nod from &hellip;
+management was that an early use would be to develop a &ldquo;stand-alone&rdquo;
+word-processing system for use in typing pools and secretarial offices.
+Perhaps they had in mind &ldquo;dedicated&rdquo;, as distinct from
+&ldquo;stand-alone&rdquo;; that&rsquo;s what eventuated in various cases, most notably
+in the legal/patent department and in the AT&amp;T CEO&rsquo;s office.
+</p>
+<p>Both those systems were targets of opportunity, not foreseen from the
+start.  When Unix was up and running on the PDP-11, Joe got wind of
+the legal department having installed a commercial word processor.
+He went to pitch Unix as an alternative and clinched a trial by
+promising to make <code class="code">roff</code> able to number lines by tomorrow in order
+to fulfill a patent-office requirement that the commercial system did
+not support.
+</p>
+<p>Modems were installed so legal-department secretaries could try the
+Research machine.  They liked it and Joe&rsquo;s superb customer service.
+Soon the legal department got a system of their own.  Joe went on to
+create <code class="code">nroff</code> and <code class="code">troff</code>.  Document preparation became a
+widespread use of Unix, but no stand-alone word-processing system was
+ever undertaken.
+</p></blockquote>
+
+<p>A history relating <code class="code">groff</code> to its predecessors <code class="code">roff</code>,
+<code class="code">nroff</code>, and <code class="code">troff</code> is available in the <cite class="cite">roff<span class="r">(7)</span></cite>
+man page.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="What-Is-groff_003f">
+<div class="nav-panel">
+<p>
+Next: <a href="#groff-Capabilities" accesskey="n" rel="next"><code class="code">groff</code> Capabilities</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="What-Is-groff_003f-1">1.2 What Is <code class="code">groff</code>?</h3>
+<a class="index-entry-id" id="index-what-is-groff_003f"></a>
+<a class="index-entry-id" id="index-groff_002d_002d_002dwhat-is-it_003f"></a>
+
+<p><code class="code">groff</code> (GNU <code class="code">roff</code>) is a typesetting system that reads plain
+text input files that include formatting commands to produce output in
+PostScript, PDF, HTML, DVI, or other formats, or for display to a
+terminal.  Formatting commands can be low-level typesetting primitives,
+macros from a supplied package, or user-defined macros.  All three
+approaches can be combined.
+</p>
+<p>A reimplementation and extension of the typesetter from <abbr class="acronym">AT&amp;T</abbr>
+Unix, <code class="code">groff</code> is present on most <abbr class="acronym">POSIX</abbr> systems owing to
+its long association with Unix manuals (including man pages).  It and
+its predecessor are notable for their production of several best-selling
+software engineering texts.  <code class="code">groff</code> is capable of producing
+typographically sophisticated documents while consuming minimal system
+resources.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="groff-Capabilities">
+<div class="nav-panel">
+<p>
+Next: <a href="#Macro-Package-Intro" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="#What-Is-groff_003f" accesskey="p" rel="prev">What Is <code class="code">groff</code>?</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="groff-Capabilities-1">1.3 <code class="code">groff</code> Capabilities</h3>
+<a class="index-entry-id" id="index-groff-capabilities"></a>
+<a class="index-entry-id" id="index-capabilities-of-groff"></a>
+
+<p>GNU <code class="code">troff</code> is a typesetting document formatter; it provides a wide
+range of low-level text and page operations within the framework of a
+programming language.  These operations compose to generate footnotes,
+tables of contents, mathematical equations, diagrams, multi-column text,
+and other elements of typeset works.  Here is a survey of formatter
+features; all are under precise user control.
+</p>
+<ul class="itemize mark-bullet">
+<li>text filling, breaking, alignment to the left or right margin; centering
+
+</li><li>adjustment of inter-word space size to justify text, and of
+inter-sentence space size to suit local style conventions
+
+</li><li>automatic and manual determination of hyphenation break points
+
+</li><li>pagination
+
+</li><li>selection of any font available to the output device
+
+</li><li>adjustment of type size and vertical spacing (or &ldquo;leading&rdquo;)
+
+</li><li>configuration of line length and indentation amounts; columnation
+
+</li><li>drawing of geometric primitives (lines, arcs, polygons, circles,
+&hellip;)
+
+</li><li>setup of stroke and fill colors (where supported by the output
+device)
+
+</li><li>embedding of hyperlinks, images, document metadata, and other inclusions
+(where supported by the output device)
+</li></ul>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Macro-Package-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="#Preprocessor-Intro" accesskey="n" rel="next">Preprocessors</a>, Previous: <a href="#groff-Capabilities" accesskey="p" rel="prev"><code class="code">groff</code> Capabilities</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Macro-Packages-1">1.4 Macro Packages</h3>
+<a class="index-entry-id" id="index-macro-package_002c-introduction"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-introduction"></a>
+
+<p>Elemental typesetting functions can be be challenging to use directly
+with complex documents.  A <em class="dfn">macro</em> facility specifies how certain
+routine operations, such as starting paragraphs, or printing headers and
+footers, should be performed in terms of those low-level instructions.
+Macros can be specific to one document or collected together into a
+<em class="dfn">macro package</em> for use by many.  Several macro packages available;
+the most widely used are provided with <code class="code">groff</code>.  They are
+<samp class="file">man</samp>, <samp class="file">mdoc</samp>, <samp class="file">me</samp>, <samp class="file">mm</samp>, <samp class="file">mom</samp>, and
+<samp class="file">ms</samp>.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Preprocessor-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="#Output-Device-Intro" accesskey="n" rel="next">Output Devices</a>, Previous: <a href="#Macro-Package-Intro" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Preprocessors">1.5 Preprocessors</h3>
+<a class="index-entry-id" id="index-preprocessors"></a>
+
+<p>An alternative approach to complexity management, particularly when
+constructing tables, setting mathematics, or drawing diagrams, lies in
+preprocessing.  A <em class="dfn">preprocessor</em> employs a domian-specific language
+to ease the generation of tables, equations, and so forth in terms that
+are convenient for human entry.  Each preprocessor reads a document and
+translates the parts of it that apply to it into GNU <code class="code">troff</code> input.
+Command-line options to <code class="command">groff</code> tell it which preprocessors to
+use.
+</p>
+<p><code class="code">groff</code> provides preprocessors for laying out tables
+(<code class="command">gtbl</code>), typesetting equations (<code class="command">geqn</code>), drawing
+diagrams (<code class="command">gpic</code> and <code class="command">ggrn</code>), inserting bibliographic
+references (<code class="command">grefer</code>), and drawing chemical structures
+(<code class="command">gchem</code>).  An associated program that is useful when dealing
+with preprocessors is <code class="command">gsoelim</code>.<a class="footnote" id="DOCF1" href="#FOOT1"><sup>1</sup></a>
+</p>
+<p><code class="code">groff</code> also supports <code class="code">grap</code>, a preprocessor for drawing
+graphs.  A free implementation of it can be obtained separately.
+</p>
+<p>Unique to <code class="code">groff</code> is the <code class="code">preconv</code> preprocessor that enables
+<code class="code">groff</code> to handle documents in a variety of input encodings.
+</p>
+<p>Other preprocessors exist, but no free implementations
+are known.  An example is <code class="command">ideal</code>, which draws diagrams using a
+mathematical constraint language.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Output-Device-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previous: <a href="#Preprocessor-Intro" accesskey="p" rel="prev">Preprocessors</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Output-Devices">1.6 Output Devices</h3>
+<a class="index-entry-id" id="index-postprocessors"></a>
+<a class="index-entry-id" id="index-output-devices"></a>
+<a class="index-entry-id" id="index-devices-for-output"></a>
+
+<p>GNU <code class="code">troff</code>&rsquo;s output is in a device-independent page description
+language, which is then read by an <em class="dfn">output driver</em> that translates
+this language into a file format or byte stream that a piece of
+(possibly emulated) hardware understands.  <code class="code">groff</code> features output
+drivers for PostScript devices, terminal emulators (and other simple
+typewriter-like machines), X11 (for previewing), TeX DVI, HP
+LaserJet&nbsp;4/PCL5 and Canon LBP printers (which use <abbr class="acronym">CaPSL</abbr>),
+<abbr class="acronym">HTML</abbr>, <abbr class="acronym">XHTML</abbr>, and <abbr class="acronym">PDF</abbr>.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Installation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Conventions-Used-in-This-Manual" accesskey="n" rel="next">Conventions Used in This Manual</a>, Previous: <a href="#Output-Device-Intro" accesskey="p" rel="prev">Output Devices</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Installation-1">1.7 Installation</h3>
+<a class="index-entry-id" id="index-installation"></a>
+
+<p>Locate installation instructions in the files <samp class="file">INSTALL</samp>,
+<samp class="file">INSTALL.extra</samp>, and <samp class="file">INSTALL.REPO</samp> in the <code class="code">groff</code> source
+distribution.  Being a GNU project, <code class="code">groff</code> supports the familiar
+&lsquo;<samp class="samp">./configure &amp;&amp; make</samp>&rsquo; command sequence.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Conventions-Used-in-This-Manual">
+<div class="nav-panel">
+<p>
+Next: <a href="#Credits" accesskey="n" rel="next">Credits</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Conventions-Used-in-This-Manual-1">1.8 Conventions Used in This Manual</h3>
+
+<p>We apply the term &ldquo;groff&rdquo; to the language documented here, the GNU
+implementation of the overall system, the project that develops that
+system, and the command of that name.  In the first sense, <code class="code">groff</code>
+is an extended dialect of the <code class="code">roff</code> language, for which many
+similar implementations exist.
+</p>
+<p>The <code class="code">roff</code> language features several major categories for which
+many items are predefined.  Presentations of these items feature the
+form in which the item is most commonly used on the left, and, aligned
+to the right margin, the name of the category in brackets.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bexample_005d"><span class="category-def">Register: </span><span><strong class="def-name">\nexample</strong><a class="copiable-link" href='#index-_005cn_005bexample_005d'> &para;</a></span></dt>
+<dd><p>The register &lsquo;<samp class="samp">example</samp>&rsquo; is one that that <code class="code">groff</code> <em class="emph">doesn&rsquo;t</em>
+predefine.  You can create it yourself, though; see <a class="ref" href="#Setting-Registers">Setting Registers</a>.
+</p></dd></dl>
+
+<p>To make this document useful as a reference and not merely amiable
+bedtime reading, we tend to present these syntax items in exhaustive
+detail when they arise.  References to topics discussed later in the
+text are frequent; skip material you don&rsquo;t understand yet.
+</p>
+<p>We use Texinfo&rsquo;s &ldquo;result&rdquo; (&rArr;) and error&rarr; notations to
+present output written to the standard output and standard error
+streams, respectively.  Diagnostic messages from the GNU <code class="code">troff</code>
+formatter and other programs are examples of the latter, but the
+formatter can also be directed to write user-specified messages to the
+standard error stream.  The notation then serves to identify the
+output stream and does not necessarily mean that an error has
+occurred.<a class="footnote" id="DOCF2" href="#FOOT2"><sup>2</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ echo &quot;Twelve o'clock and&quot; | groff -Tascii | sed '/^$/d'
+    &rArr; Twelve o'clock and
+$ echo '.tm all is well.' | groff &gt; /dev/null
+    error&rarr; all is well.
+</pre></div></div>
+
+<p>Sometimes we use &rArr; somewhat abstractly to represent formatted
+text that you will need to use a PostScript or PDF viewer program (or a
+printer) to observe.  While arguably an abuse of notation, we think this
+preferable to requiring the reader to understand the syntax of these
+page description languages.
+</p>
+<p>We also present diagnostic messages in an abbreviated form, often
+omitting the name of the program issuing them, the input file name, and
+line number or other positional information when such data do not serve
+to illuminate the topic under discussion.
+</p>
+<p>Most examples are of <code class="code">roff</code> language input that would be placed in
+a text file.  Occasionally, we start an example with a &lsquo;<samp class="samp">$</samp>&rsquo;
+character to indicate a shell prompt, as seen above.
+</p>
+<p>You are encouraged to try the examples yourself, and to alter them to
+better learn <code class="code">groff</code>&rsquo;s behavior.  Our examples frequently need to
+direct the formatter to set a line length (with &lsquo;<samp class="samp">.ll</samp>&rsquo;) that will
+fit within the page margins of this manual.  We mention this so that you
+know why it is there before we discuss the <code class="code">ll</code> request
+formally.<a class="footnote" id="DOCF3" href="#FOOT3"><sup>3</sup></a>
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Credits">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Conventions-Used-in-This-Manual" accesskey="p" rel="prev">Conventions Used in This Manual</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Credits-1">1.9 Credits</h3>
+<a class="index-entry-id" id="index-credits"></a>
+
+<p>We adapted portions of this manual from existing documents.  James
+Clark&rsquo;s man pages were an essential resource; we have updated them in
+parallel with the development of this manual.  We based the tutorial for
+macro users on Eric Allman&rsquo;s introduction to his <samp class="file">me</samp> macro package
+(which we also provide, little altered from 4.4BSD).  Larry Kollar
+contributed much of the material on the <samp class="file">ms</samp> macro package.
+</p>
+
+
+<hr>
+</div>
+</div>
+<div class="chapter-level-extent" id="Invoking-groff">
+<div class="nav-panel">
+<p>
+Next: <a href="#Tutorial-for-Macro-Users" accesskey="n" rel="next">Tutorial for Macro Users</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="Invoking-groff-1">2 Invoking <code class="code">groff</code></h2>
+<a class="index-entry-id" id="index-invoking-groff"></a>
+<a class="index-entry-id" id="index-groff-invocation"></a>
+
+<p>This chapter focuses on how to invoke the <code class="code">groff</code> front end.  This
+front end takes care of the details of constructing the pipeline among
+the preprocessors, <code class="code">gtroff</code> and the postprocessor.
+</p>
+<p>It has become a tradition that GNU programs get the prefix &lsquo;<samp class="samp">g</samp>&rsquo; to
+distinguish them from their original counterparts provided by the host
+(see <a class="pxref" href="#Environment">Environment</a>).  Thus, for example, <code class="code">geqn</code> is GNU
+<code class="code">eqn</code>.  On operating systems like GNU/Linux or the Hurd, which
+don&rsquo;t contain proprietary versions of <code class="code">troff</code>, and on
+MS-DOS/MS-Windows, where <code class="code">troff</code> and associated programs are not
+available at all, this prefix is omitted since GNU <code class="code">troff</code> is the
+only incarnation of <code class="code">troff</code> used.  Exception: &lsquo;<samp class="samp">groff</samp>&rsquo; is never
+replaced by &lsquo;<samp class="samp">roff</samp>&rsquo;.
+</p>
+<p>In this document, we consequently say &lsquo;<samp class="samp">gtroff</samp>&rsquo; when talking about
+the GNU <code class="code">troff</code> program.  All other implementations of <code class="code">troff</code> are called <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, which is the common origin of almost all <code class="code">troff</code>
+implementations<a class="footnote" id="DOCF4" href="#FOOT4"><sup>4</sup></a> (with more or less compatible changes).  Similarly, we say
+&lsquo;<samp class="samp">gpic</samp>&rsquo;, &lsquo;<samp class="samp">geqn</samp>&rsquo;, and so on.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Groff-Options" accesskey="1">Options</a></li>
+<li><a href="#Environment" accesskey="2">Environment</a></li>
+<li><a href="#Macro-Directories" accesskey="3">Macro Directories</a></li>
+<li><a href="#Font-Directories" accesskey="4">Font Directories</a></li>
+<li><a href="#Paper-Format" accesskey="5">Paper Format</a></li>
+<li><a href="#Invocation-Examples" accesskey="6">Invocation Examples</a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="Groff-Options">
+<div class="nav-panel">
+<p>
+Next: <a href="#Environment" accesskey="n" rel="next">Environment</a>, Previous: <a href="#Invoking-groff" accesskey="p" rel="prev">Invoking <code class="code">groff</code></a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Options">2.1 Options</h3>
+<a class="index-entry-id" id="index-options"></a>
+
+<a class="index-entry-id" id="index-groff"></a>
+<a class="index-entry-id" id="index-gtroff"></a>
+<a class="index-entry-id" id="index-gpic"></a>
+<a class="index-entry-id" id="index-geqn"></a>
+<a class="index-entry-id" id="index-ggrn"></a>
+<a class="index-entry-id" id="index-grap"></a>
+<a class="index-entry-id" id="index-gtbl"></a>
+<a class="index-entry-id" id="index-gchem"></a>
+<a class="index-entry-id" id="index-grefer"></a>
+<a class="index-entry-id" id="index-gsoelim"></a>
+<a class="index-entry-id" id="index-preconv"></a>
+<p><code class="code">groff</code> normally runs the <code class="code">gtroff</code> program and a
+postprocessor appropriate for the selected device.  The default device
+is &lsquo;<samp class="samp">ps</samp>&rsquo; (but it can be changed when <code class="code">groff</code> is configured and
+built).  It can optionally preprocess with any of <code class="code">gpic</code>,
+<code class="code">geqn</code>, <code class="code">gtbl</code>, <code class="code">ggrn</code>, <code class="code">grap</code>, <code class="code">gchem</code>,
+<code class="code">grefer</code>, <code class="code">gsoelim</code>, or <code class="code">preconv</code>.
+</p>
+<p>This section documents only options to the <code class="code">groff</code> front end.  Many
+of the arguments to <code class="code">groff</code> are passed on to <code class="code">gtroff</code>;
+therefore, those are also included.  Arguments to preprocessors and
+output drivers can be found in the man pages <cite class="cite">gpic<span class="r">(1)</span></cite>,
+<cite class="cite">geqn<span class="r">(1)</span></cite>, <cite class="cite">gtbl<span class="r">(1)</span></cite>, <cite class="cite">ggrn<span class="r">(1)</span></cite>,
+<cite class="cite">grefer<span class="r">(1)</span></cite>, <cite class="cite">gchem<span class="r">(1)</span></cite>, <cite class="cite">gsoelim<span class="r">(1)</span></cite>,
+<cite class="cite">preconv<span class="r">(1)</span></cite>, <cite class="cite">grotty<span class="r">(1)</span></cite>, <cite class="cite">grops<span class="r">(1)</span></cite>,
+<cite class="cite">gropdf<span class="r">(1)</span></cite>, <cite class="cite">grohtml<span class="r">(1)</span></cite>, <cite class="cite">grodvi<span class="r">(1)</span></cite>,
+<cite class="cite">grolj4<span class="r">(1)</span></cite>, <cite class="cite">grolbp<span class="r">(1)</span></cite>, and <cite class="cite">gxditview<span class="r">(1)</span></cite>.
+</p>
+<p>The command-line format for <code class="code">groff</code> is:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff  -abceghijklpstvzCEGNRSUVXZ   -d<var class="var">cs</var>   -D<var class="var">arg</var> 
+       -f<var class="var">fam</var>   -F<var class="var">dir</var>   -I<var class="var">dir</var>   -K<var class="var">arg</var> 
+       -L<var class="var">arg</var>   -m<var class="var">name</var>   -M<var class="var">dir</var>   -n<var class="var">num</var> 
+       -o<var class="var">list</var>   -P<var class="var">arg</var>   -r<var class="var">cn</var>   -T<var class="var">dev</var> 
+       -w<var class="var">name</var>   -W<var class="var">name</var>   <var class="var">files</var>&hellip; 
+</pre></div></div>
+
+<p>The command-line format for <code class="code">gtroff</code> is as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">gtroff  -abcivzCERU   -d<var class="var">cs</var>   -f<var class="var">fam</var>   -F<var class="var">dir</var> 
+        -m<var class="var">name</var>   -M<var class="var">dir</var>   -n<var class="var">num</var>   -o<var class="var">list</var> 
+        -r<var class="var">cn</var>   -T<var class="var">name</var>   -w<var class="var">name</var>   -W<var class="var">name</var> 
+        <var class="var">files</var>&hellip; 
+</pre></div></div>
+
+<p>Obviously, many of the options to <code class="code">groff</code> are actually passed on to
+<code class="code">gtroff</code>.
+</p>
+<p>Options without an argument can be grouped behind a
+single&nbsp;<samp class="option">-</samp>.  A filename of&nbsp;<samp class="file">-</samp> denotes the
+standard input.  Whitespace is permitted between an option and its
+argument.
+</p>
+<p>The <code class="code">grog</code> command can be used to guess the correct <code class="code">groff</code>
+command to format a file.  See its man page <cite class="cite">grog<span class="r">(1)</span></cite>; type
+&lsquo;<samp class="samp">man grog</samp>&rsquo; at the command line to view it.
+</p>
+<p><code class="command">groff</code>&rsquo;s command-line options are as follows.
+</p>
+<a class="index-entry-id" id="index-command_002dline-options"></a>
+<dl class="table">
+<dt id='index-plain-text-approximation-output-register-_0028_002eA_0029'><span>&lsquo;<samp class="samp">-a</samp>&rsquo;<a class="copiable-link" href='#index-plain-text-approximation-output-register-_0028_002eA_0029'> &para;</a></span></dt>
+<dd><p>Generate a plain text approximation of the typeset output.  The
+read-only register <code class="code">.A</code> is set to&nbsp;1.  See <a class="xref" href="#Built_002din-Registers">Built-in Registers</a>.  This option produces a sort of abstract preview of the
+formatted output.
+</p>
+<ul class="itemize mark-bullet">
+<li>Page breaks are marked by a phrase in angle brackets; for example,
+&lsquo;<samp class="samp">&lt;beginning of page&gt;</samp>&rsquo;.
+
+</li><li>Lines are broken where they would be in the formatted output.
+
+</li><li>A horizontal motion of any size is represented as one space.  Adjacent
+horizontal motions are not combined.  Inter-sentence space nodes (those
+arising from the second argument to the <code class="code">ss</code> request) are not
+represented.
+
+</li><li>Vertical motions are not represented.
+
+</li><li>Special characters are rendered in angle brackets; for example, the
+default soft hyphen character appears as &lsquo;<samp class="samp">&lt;hy&gt;</samp>&rsquo;.
+</li></ul>
+
+<p>The above description should not be considered a specification; the
+details of <samp class="option">-a</samp> output are subject to change.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-b</samp>&rsquo;</dt>
+<dd><p>Write a backtrace reporting the state of <code class="command">gtroff</code>&rsquo;s input parser
+to the standard error stream with each diagnostic message.  The line
+numbers given in the backtrace might not always be correct, because
+<code class="command">gtroff</code>&rsquo;s idea of line numbers can be confused by requests that
+append to
+macros.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-c</samp>&rsquo;</dt>
+<dd><p>Start with color output disabled.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-C</samp>&rsquo;</dt>
+<dd><p>Enable AT&amp;T <code class="command">troff</code> compatibility mode; implies <samp class="option">-c</samp>.
+See <a class="xref" href="#Implementation-Differences">Implementation Differences</a>, for the list of incompatibilities
+between <code class="command">groff</code> and <abbr class="acronym">AT&amp;T</abbr> <code class="command">troff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-d<var class="var">c</var><var class="var">text</var></samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">-d<var class="var">string</var>=<var class="var">text</var></samp>&rsquo;</dt>
+<dd><p>Define <code class="code">roff</code> string <var class="var">c</var> or <var class="var">string</var> as&nbsp;<var class="var">t</var> or
+<var class="var">text</var>.  <var class="var">c</var>&nbsp;must be one character; <var class="var">string</var> can be
+of arbitrary length.  Such string assignments happen before any macro
+file is loaded, including the startup file.  Due to <code class="code">getopt_long</code>
+limitations, <var class="var">c</var>&nbsp;cannot be, and <var class="var">string</var> cannot contain, an
+equals sign, even though that is a valid character in a <code class="code">roff</code>
+identifier.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-D<var class="var">enc</var></samp>&rsquo;</dt>
+<dd><p>Set fallback input encoding used by <code class="command">preconv</code> to <var class="var">enc</var>;
+implies <samp class="option">-k</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-e</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">geqn</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-E</samp>&rsquo;</dt>
+<dd><p>Inhibit <code class="command">gtroff</code> error messages.  This option does <em class="emph">not</em>
+suppress messages sent to the standard error stream by documents or
+macro packages using <code class="code">tm</code> or related requests.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-f<var class="var">fam</var></samp>&rsquo;</dt>
+<dd><p>Use <var class="var">fam</var> as the default font family.  See <a class="xref" href="#Font-Families">Font Families</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-F<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search in directory <samp class="file"><var class="var">dir</var></samp> for the selected output device&rsquo;s
+directory of device and font description files.  See the description of
+<code class="env">GROFF_FONT_PATH</code> in <a class="ref" href="#Environment">Environment</a> below for the default search
+locations and ordering.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-g</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">ggrn</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-G</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">grap</code> preprocessor; implies <samp class="option">-p</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-h</samp>&rsquo;</dt>
+<dd><p>Display a usage message and exit.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-i</samp>&rsquo;</dt>
+<dd><p>Read the standard input after all the named input files have been
+processed.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-I<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search the directory <var class="var">dir</var> for files named in several contexts;
+implies <samp class="option">-g</samp> and <samp class="option">-s</samp>.
+</p>
+<ul class="itemize mark-bullet">
+<li><code class="command">gsoelim</code> replaces <code class="code">so</code> requests with the contents of their
+file name arguments.
+
+</li><li><code class="command">gtroff</code> searches for files named as operands in its command
+line and as arguments to <code class="code">psbb</code>, <code class="code">so</code>, and <code class="code">soquiet</code>
+requests.
+
+</li><li>Output drivers may search for files; for instance, <code class="command">grops</code> looks
+for files named in &lsquo;<samp class="samp">\X'ps: import <span class="r">&hellip;</span>'</samp>&rsquo;, &lsquo;<samp class="samp">\X'ps: file
+<span class="r">&hellip;</span>'</samp>&rsquo;, and &lsquo;<samp class="samp">\X'pdf: pdfpic <span class="r">&hellip;</span>'</samp>&rsquo; device control
+escape sequences.
+</li></ul>
+
+<p>This option may be specified more than once; the directories are
+searched in the order specified.  If you want to search the current
+directory before others, add &lsquo;<samp class="samp">-I .</samp>&rsquo; at the desired place.  The
+current working directory is otherwise searched last.  <samp class="option">-I</samp> works
+similarly to, and is named for, the &ldquo;include&rdquo; option of Unix C
+compilers.
+</p>
+<p><samp class="option">-I</samp> options are passed to <code class="command">gsoelim</code>, <code class="command">gtroff</code>,
+and output drivers; with the flag letter changed to <samp class="option">-M</samp>, they
+are also passed to <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-j</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gchem</code> preprocessor.  Implies <samp class="option">-p</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-k</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">preconv</code> preprocessor.  Refer to its man page for its
+behavior if neither of <code class="command">groff</code>&rsquo;s <samp class="option">-K</samp> or <samp class="option">-D</samp>
+options is also specified.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-K<var class="var">enc</var></samp>&rsquo;</dt>
+<dd><p>Set input encoding used by <code class="command">preconv</code> to <var class="var">enc</var>; implies
+<samp class="option">-k</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-l</samp>&rsquo;</dt>
+<dd><p>Send the output to a spooler for printing.  The <code class="code">print</code> directive
+in the device description file specifies the default command to be used;
+see <a class="ref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.
+See options <samp class="option">-L</samp> and <samp class="option">-X</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-L<var class="var">arg</var></samp>&rsquo;</dt>
+<dd><p>Pass <var class="var">arg</var> to the print spooler program.  If multiple <var class="var">arg</var>s are
+required, pass each with a separate <samp class="option">-L</samp> option.  <code class="command">groff</code>
+does not prefix an option dash to <var class="var">arg</var> before passing it to the
+spooler program.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-m<var class="var">name</var></samp>&rsquo;</dt>
+<dd><p>Process the file <samp class="file"><var class="var">name</var>.tmac</samp> prior to any input files.
+If not found, <samp class="file">tmac.<var class="var">name</var></samp> is attempted.  <var class="var">name</var>
+(in both arrangements) is presumed to be a macro file; see the
+description of <code class="env">GROFF_TMAC_PATH</code> in <a class="ref" href="#Environment">Environment</a> below for the
+default search locations and ordering.  This option and its argument are
+also passed to <code class="command">geqn</code>, <code class="command">grap</code>, and <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-M<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search directory <samp class="file"><var class="var">dir</var></samp> for macro files;  see the description
+of <code class="env">GROFF_TMAC_PATH</code> in <a class="ref" href="#Environment">Environment</a> below for the default
+search locations and ordering.  This option and its argument are also
+passed to <code class="command">geqn</code>, <code class="command">grap</code>, and <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-n<var class="var">num</var></samp>&rsquo;</dt>
+<dd><p>Number the first page <var class="var">num</var>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-N</samp>&rsquo;</dt>
+<dd><p>Prohibit newlines between <code class="code">eqn</code> delimiters: pass <samp class="option">-N</samp> to
+<code class="command">geqn</code>.
+</p>
+</dd>
+<dt id='index-print-current-page-register-_0028_002eP_0029'><span>&lsquo;<samp class="samp">-o<var class="var">list</var></samp>&rsquo;<a class="copiable-link" href='#index-print-current-page-register-_0028_002eP_0029'> &para;</a></span></dt>
+<dd><p>Output only pages in <var class="var">list</var>, which is a comma-separated list of page
+ranges; &lsquo;<samp class="samp"><var class="var">n</var></samp>&rsquo; means page&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp"><var class="var">m</var>-<var class="var">n</var></samp>&rsquo;
+means every page between <var class="var">m</var> and&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp">-<var class="var">n</var></samp>&rsquo; means
+every page up to&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp"><var class="var">n</var>-</samp>&rsquo; means every page from
+<var class="var">n</var>&nbsp;on.  <code class="command">gtroff</code> stops processing and exits after
+formatting the last page enumerated in <var class="var">list</var>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gpic</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-P<var class="var">arg</var></samp>&rsquo;</dt>
+<dd><p>Pass <var class="var">arg</var> to the postprocessor.  If multiple <var class="var">arg</var>s are
+required, pass each with a separate <samp class="option">-P</samp> option.  <code class="command">groff</code>
+does not prefix an option dash to <var class="var">arg</var> before passing it to the
+postprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-r<var class="var">c</var><var class="var">numeric-expression</var></samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">-r<var class="var">register</var>=<var class="var">expr</var></samp>&rsquo;</dt>
+<dd><p>Set <code class="code">roff</code> register&nbsp;<var class="var">c</var> or <var class="var">register</var> to the value
+<var class="var">numeric-expression</var> (see <a class="pxref" href="#Numeric-Expressions">Numeric Expressions</a>).
+<var class="var">c</var>&nbsp;must be one character; <var class="var">register</var> can be of arbitrary
+length.  Such register assignments happen before any macro file is
+loaded, including the startup file.  Due to <code class="code">getopt_long</code>
+limitations, <var class="var">c</var>&nbsp;cannot be, and <var class="var">register</var> cannot contain,
+an equals sign, even though that is a valid character in a <code class="code">roff</code>
+identifier.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-R</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">grefer</code> preprocessor.  No mechanism is provided for passing
+arguments to <code class="command">grefer</code> because most <code class="command">grefer</code> options have
+equivalent language elements that can be specified within the document.
+</p>
+<a class="index-entry-id" id="index-troffrc"></a>
+<a class="index-entry-id" id="index-troffrc_002dend"></a>
+<p><code class="command">gtroff</code> also accepts a <samp class="option">-R</samp> option, which is not
+accessible via <code class="command">groff</code>.  This option prevents the loading of the
+<samp class="file">troffrc</samp> and <samp class="file">troffrc-end</samp> files.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-s</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gsoelim</code> preprocessor.
+</p>
+</dd>
+<dt id='index-open-request_002c-and-safer-mode'><span>&lsquo;<samp class="samp">-S</samp>&rsquo;<a class="copiable-link" href='#index-open-request_002c-and-safer-mode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-opena-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-pso-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-sy-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-pi-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-safer-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-safer"></a>
+<p>Operate in &ldquo;safer&rdquo; mode; see <samp class="option">-U</samp> below for its opposite.  For
+security reasons, safer mode is enabled by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-t</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gtbl</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-T<var class="var">dev</var></samp>&rsquo;</dt>
+<dd><p>Direct <code class="command">gtroff</code> to format the input for the output device
+<var class="var">dev</var>.  <code class="command">groff</code> then calls an output driver to convert
+<code class="command">gtroff</code>&rsquo;s output to a form appropriate for <var class="var">dev</var>.  The
+following output devices are available.
+</p>
+<dl class="table">
+<dt><code class="code">ps</code></dt>
+<dd><p>For PostScript printers and previewers.
+</p>
+</dd>
+<dt><code class="code">pdf</code></dt>
+<dd><p>For <abbr class="acronym">PDF</abbr> viewers or printers.
+</p>
+</dd>
+<dt><code class="code">dvi</code></dt>
+<dd><p>For TeX DVI format.
+</p>
+</dd>
+<dt><code class="code">X75</code></dt>
+<dd><p>For a 75<span class="dmn">dpi</span> X11 previewer.
+</p>
+</dd>
+<dt><code class="code">X75-12</code></dt>
+<dd><p>For a 75<span class="dmn">dpi</span> X11 previewer with a 12-point base font in the
+document.
+</p>
+</dd>
+<dt><code class="code">X100</code></dt>
+<dd><p>For a 100<span class="dmn">dpi</span> X11 previewer.
+</p>
+</dd>
+<dt><code class="code">X100-12</code></dt>
+<dd><p>For a 100<span class="dmn">dpi</span> X11 previewer with a 12-point base font in the
+document.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-ASCII'><span><code class="code">ascii</code><a class="copiable-link" href='#index-encoding_002c-output_002c-ASCII'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-encoding_002c-output_002c-ISO-646"></a>
+<a class="index-entry-id" id="index-ASCII-output-encoding"></a>
+<a class="index-entry-id" id="index-ISO-646-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-ASCII"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-ISO-646"></a>
+<p>For typewriter-like devices using the (7-bit) <abbr class="acronym">ASCII</abbr>
+(ISO&nbsp;646) character set.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029'><span><code class="code">latin1</code><a class="copiable-link" href='#index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d1-_0028ISO-8859_002d1_0029-output-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d1-_0028Latin_002d1_0029-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029"></a>
+<p>For typewriter-like devices that support the <span class="w-nolinebreak-text">Latin-1</span>
+(ISO&nbsp;<span class="w-nolinebreak-text">8859-1</span>) character set.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-UTF_002d8'><span><code class="code">utf8</code><a class="copiable-link" href='#index-encoding_002c-output_002c-UTF_002d8'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-UTF_002d8-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-UTF_002d8"></a>
+<p>For typewriter-like devices that use the Unicode (ISO&nbsp;10646)
+character set with <span class="w-nolinebreak-text">UTF-8</span> encoding.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-EBCDIC'><span><code class="code">cp1047</code><a class="copiable-link" href='#index-encoding_002c-output_002c-EBCDIC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EBCDIC-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-EBCDIC"></a>
+<a class="index-entry-id" id="index-encoding_002c-output_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-code-page-1047-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-IBM-code-page-1047-output-encoding"></a>
+<a class="index-entry-id" id="index-CCSID-1047-output-encoding-_0028EBCDIC_0029"></a>
+<p>For typewriter-like devices that use the <abbr class="acronym">EBCDIC</abbr> encoding IBM
+code page 1047.
+</p>
+</dd>
+<dt><code class="code">lj4</code></dt>
+<dd><p>For HP LaserJet4-compatible (or other PCL5-compatible) printers.
+</p>
+</dd>
+<dt><code class="code">lbp</code></dt>
+<dd><p>For Canon <abbr class="acronym">CaPSL</abbr> printers (<span class="w-nolinebreak-text">LBP-4</span> and <span class="w-nolinebreak-text">LBP-8</span> series laser
+printers).
+</p>
+<a class="index-entry-id" id="index-pre_002dgrohtml"></a>
+<a class="index-entry-id" id="index-post_002dgrohtml"></a>
+<a class="index-entry-id" id="index-grohtml_002c-the-program"></a>
+</dd>
+<dt><code class="code">html</code></dt>
+<dt><code class="code">xhtml</code></dt>
+<dd><p>To produce <abbr class="acronym">HTML</abbr> and <abbr class="acronym">XHTML</abbr> output, respectively.
+This driver consists of two parts, a preprocessor
+(<code class="command">pre-grohtml</code>) and a postprocessor (<code class="command">post-grohtml</code>).
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029"></a>
+<a class="index-entry-id" id="index-output-device-usage-register-_0028_002eT_0029"></a>
+<p>The predefined GNU <code class="code">troff</code> string <code class="code">.T</code> contains the name of
+the output device; the read-only register <code class="code">.T</code> is set to&nbsp;1 if
+this option is used (which is always true if <code class="command">groff</code> is used to
+call GNU <code class="command">troff</code>).  See <a class="xref" href="#Built_002din-Registers">Built-in Registers</a>.
+</p>
+<p>The postprocessor to be used for a device is specified by the
+<code class="code">postpro</code> command in the device description file.  (See <a class="xref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.)  This can be overridden with the
+<samp class="option">-X</samp> option.
+</p>
+</dd>
+<dt id='index-mode_002c-unsafe'><span>&lsquo;<samp class="samp">-U</samp>&rsquo;<a class="copiable-link" href='#index-mode_002c-unsafe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-unsafe-mode"></a>
+<p>Operate in <em class="dfn">unsafe mode</em>, which enables the <code class="code">open</code>,
+<code class="code">opena</code>, <code class="code">pi</code>, <code class="code">pso</code>, and <code class="code">sy</code> requests.  These
+requests are disabled by default because they allow an untrusted input
+document to write to arbitrary file names and run arbitrary commands.
+This option also adds the current directory to the macro package search
+path; see the <samp class="option">-m</samp> option above.  <samp class="option">-U</samp> is passed to
+<code class="command">gpic</code> and <code class="command">gtroff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-v</samp>&rsquo;</dt>
+<dd><p>Write version information for <code class="command">groff</code> and all programs run by it
+to the standard output stream; that is, the given command line is
+processed in the usual way, passing <samp class="option">-v</samp> to the formatter and any
+pre- or postprocessors invoked.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>
+<dd><p>Output the pipeline that would be run by <code class="command">groff</code>
+(as a wrapper program) to the standard output stream, but do not execute
+it.  If given more than once, the pipeline is both written to the
+standard error stream and run.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-w<var class="var">category</var></samp>&rsquo;</dt>
+<dd><p>Enable warnings in <var class="var">category</var>.  Categories are listed in
+<a class="ref" href="#Warnings">Warnings</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-W<var class="var">category</var></samp>&rsquo;</dt>
+<dd><p>Inhibit warnings in <var class="var">category</var>.  Categories are listed in
+<a class="ref" href="#Warnings">Warnings</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-X</samp>&rsquo;</dt>
+<dd><p>Use <code class="command">gxditview</code> instead of the usual postprocessor to (pre)view
+a document on an X11 display.  Combining this option with
+<samp class="option">-Tps</samp> uses the font metrics of the PostScript device, whereas
+the <samp class="option">-TX75</samp> and <samp class="option">-TX100</samp> options use the metrics of X11
+fonts.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-z</samp>&rsquo;</dt>
+<dd><p>Suppress formatted output from <code class="command">gtroff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-Z</samp>&rsquo;</dt>
+<dd><p>Disable postprocessing.  <code class="command">gtroff</code> output will appear on the
+standard output stream (unless suppressed with <samp class="option">-z</samp>; see
+<a class="ref" href="#gtroff-Output"><code class="code">gtroff</code> Output</a> for a description of this format.
+</p></dd>
+</dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Environment">
+<div class="nav-panel">
+<p>
+Next: <a href="#Macro-Directories" accesskey="n" rel="next">Macro Directories</a>, Previous: <a href="#Groff-Options" accesskey="p" rel="prev">Options</a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Environment-1">2.2 Environment</h3>
+<a class="index-entry-id" id="index-environment-variables"></a>
+<a class="index-entry-id" id="index-variables-in-environment"></a>
+
+<p>There are also several environment variables (of the operating system,
+not within <code class="code">gtroff</code>) that can modify the behavior of <code class="code">groff</code>.
+</p>
+<dl class="table">
+<dt id='index-GROFF_005fBIN_005fPATH_002c-environment-variable'><span><code class="code">GROFF_BIN_PATH</code><a class="copiable-link" href='#index-GROFF_005fBIN_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>This search path, followed by <code class="code">PATH</code>, is used for commands executed
+by <code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable'><span><code class="code">GROFF_COMMAND_PREFIX</code><a class="copiable-link" href='#index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-command-prefix"></a>
+<a class="index-entry-id" id="index-prefix_002c-for-commands"></a>
+<p>If this is set to&nbsp;<var class="var">X</var>, then <code class="command">groff</code> runs
+<code class="command"><var class="var">X</var>troff</code> instead of <code class="command">gtroff</code>.  This also applies
+to <code class="command">tbl</code>, <code class="command">pic</code>, <code class="command">eqn</code>, <code class="command">grn</code>,
+<code class="command">chem</code>, <code class="command">refer</code>, and <code class="command">soelim</code>.  It does not
+apply to <code class="command">grops</code>, <code class="command">grodvi</code>, <code class="command">grotty</code>,
+<code class="command">pre-grohtml</code>, <code class="command">post-grohtml</code>, <code class="command">preconv</code>,
+<code class="command">grolj4</code>, <code class="command">gropdf</code>, and <code class="command">gxditview</code>.
+</p>
+<p>The default command prefix is determined during the installation
+process.  If a non-GNU <code class="code">troff</code> system is found, prefix &lsquo;<samp class="samp">g</samp>&rsquo; is
+used, none otherwise.
+</p>
+</dd>
+<dt id='index-GROFF_005fENCODING_002c-environment-variable'><span><code class="code">GROFF_ENCODING</code><a class="copiable-link" href='#index-GROFF_005fENCODING_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>The value of this variable is passed to the <code class="code">preconv</code>
+preprocessor&rsquo;s <samp class="option">-e</samp> option to select the character encoding of
+input files.  This variable&rsquo;s existence implies the <code class="code">groff</code> option
+<samp class="option">-k</samp>.  If set but empty, <code class="code">groff</code> calls <code class="code">preconv</code>
+without an <samp class="option">-e</samp> option.  <code class="code">groff</code>&rsquo;s <samp class="option">-K</samp> option
+overrides <code class="env">GROFF_ENCODING</code>.  See the <cite class="cite">preconv<span class="r">(7)</span></cite> man page;
+type &lsquo;<samp class="samp">man preconv</samp>&rsquo; at the command line to view it.
+</p>
+</dd>
+<dt id='index-GROFF_005fFONT_005fPATH_002c-environment-variable'><span><code class="code">GROFF_FONT_PATH</code><a class="copiable-link" href='#index-GROFF_005fFONT_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A list of directories in which to seek the selected output device&rsquo;s
+directory of device and font description files.  GNU <code class="code">troff</code>
+will search directories given as arguments to any specified <samp class="option">-F</samp>
+options before these, and a built-in list of directories after them.
+See <a class="xref" href="#Font-Directories">Font Directories</a> and the <cite class="cite">troff<span class="r">(1)</span></cite> or
+<cite class="cite">gtroff<span class="r">(1)</span></cite> man pages.
+</p>
+</dd>
+<dt id='index-GROFF_005fTMAC_005fPATH_002c-environment-variable'><span><code class="code">GROFF_TMAC_PATH</code><a class="copiable-link" href='#index-GROFF_005fTMAC_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A list of directories in which to seek macro files.  GNU <code class="code">troff</code>
+will search directories given as arguments to any specified <samp class="option">-M</samp>
+options before these, and a built-in list of directories after them.
+See <a class="xref" href="#Macro-Directories">Macro Directories</a> and the <cite class="cite">troff<span class="r">(1)</span></cite> or
+<cite class="cite">gtroff<span class="r">(1)</span></cite> man pages.
+</p>
+</dd>
+<dt id='index-GROFF_005fTMPDIR_002c-environment-variable'><span><code class="code">GROFF_TMPDIR</code><a class="copiable-link" href='#index-GROFF_005fTMPDIR_002c-environment-variable'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TMPDIR_002c-environment-variable"></a>
+<p>The directory in which <code class="code">groff</code> creates temporary files.  If this is
+not set and <code class="env">TMPDIR</code> is set, temporary files are created in that
+directory.  Otherwise temporary files are created in a system-dependent
+default directory (on Unix and GNU/Linux systems, this is usually
+<samp class="file">/tmp</samp>).  <code class="code">grops</code>, <code class="code">grefer</code>, <code class="code">pre-grohtml</code>, and
+<code class="code">post-grohtml</code> can create temporary files in this directory.
+</p>
+</dd>
+<dt id='index-GROFF_005fTYPESETTER_002c-environment-variable'><span><code class="code">GROFF_TYPESETTER</code><a class="copiable-link" href='#index-GROFF_005fTYPESETTER_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>Sets the default output device.  If empty or not set, a build-time
+default (often <code class="code">ps</code>) is used.  The <samp class="option">-T<var class="var">dev</var></samp> option
+overrides <code class="env">GROFF_TYPESETTER</code>.
+</p>
+</dd>
+<dt id='index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable'><span><code class="code">SOURCE_DATE_EPOCH</code><a class="copiable-link" href='#index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A timestamp (expressed as seconds since the Unix epoch) to use as the
+output creation timestamp in place of the current time.  The time is
+converted to human-readable form using <cite class="cite">localtime<span class="r">(3)</span></cite> when the
+formatter starts up and stored in registers usable by documents and
+macro packages (see <a class="pxref" href="#Built_002din-Registers">Built-in Registers</a>).
+</p>
+</dd>
+<dt id='index-TZ_002c-environment-variable'><span><code class="code">TZ</code><a class="copiable-link" href='#index-TZ_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>The time zone to use when converting the current time (or value of
+<code class="env">SOURCE_DATE_EPOCH</code>) to human-readable form; see
+<cite class="cite">tzset<span class="r">(3)</span></cite>.
+</p></dd>
+</dl>
+
+<p>MS-DOS and MS-Windows ports of <code class="code">groff</code> use semicolons, rather than
+colons, to separate the directories in the lists described above.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Macro-Directories">
+<div class="nav-panel">
+<p>
+Next: <a href="#Font-Directories" accesskey="n" rel="next">Font Directories</a>, Previous: <a href="#Environment" accesskey="p" rel="prev">Environment</a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Macro-Directories-1">2.3 Macro Directories</h3>
+<a class="index-entry-id" id="index-macro-directories"></a>
+<a class="index-entry-id" id="index-directories-for-macros"></a>
+<a class="index-entry-id" id="index-searching-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-searching"></a>
+
+<p>A macro file must have a name in the form <code class="code"><var class="var">name</var>.tmac</code> or
+<code class="code">tmac.<var class="var">name</var></code> and be placed in a <em class="dfn">tmac directory</em> to be
+found by the <samp class="option">-m<var class="var">name</var></samp> command-line option.<a class="footnote" id="DOCF5" href="#FOOT5"><sup>5</sup></a>
+<a class="index-entry-id" id="index-tmac_002c-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-for-tmac-files"></a>
+<a class="index-entry-id" id="index-tmac_002c-path"></a>
+<a class="index-entry-id" id="index-path_002c-for-tmac-files"></a>
+<a class="index-entry-id" id="index-locating-macro-files"></a>
+<a class="index-entry-id" id="index-macro-file-search-path"></a>
+<a class="index-entry-id" id="index-file_002c-macro_002c-search-path"></a>
+<a class="index-entry-id" id="index-locating-macro-packages"></a>
+<a class="index-entry-id" id="index-macro-package-search-path"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-search-path"></a>
+Together, these directories constitute the <em class="dfn">tmac path</em>.  Each
+directory is searched in the following order until the desired macro
+file is found or the list is exhausted.
+</p>
+<ul class="itemize mark-bullet">
+<li>Directories specified with GNU <code class="code">troff</code>&rsquo;s or <code class="code">groff</code>&rsquo;s
+<samp class="option">-M</samp> command-line option.
+
+</li><li><a class="index-entry-id" id="index-GROFF_005fTMAC_005fPATH_002c-environment-variable-1"></a>
+Directories listed in the <code class="env">GROFF_TMAC_PATH</code> environment variable.
+
+</li><li><a class="index-entry-id" id="index-safer-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-1"></a>
+<a class="index-entry-id" id="index-unsafe-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-1"></a>
+<a class="index-entry-id" id="index-current-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-current"></a>
+The current working directory (only if in unsafe mode using the
+<samp class="option">-U</samp> command-line option).
+
+</li><li><a class="index-entry-id" id="index-home-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-home"></a>
+The user&rsquo;s home directory, <code class="env">HOME</code>.
+
+</li><li><a class="index-entry-id" id="index-site_002dlocal-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-site_002dlocal"></a>
+<a class="index-entry-id" id="index-platform_002dspecific-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-platform_002dspecific"></a>
+A platform-dependent directory, a site-local (platform-independent)
+directory, and the main <i class="slanted">tmac</i> directory.  The locations
+corresponding to your installation are listed in section &ldquo;Environment&rdquo;
+of <cite class="cite">gtroff<span class="r">(1)</span></cite>.  If not otherwise configured, they are as
+follows.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">/usr/local/lib/groff/site-tmac
+/usr/local/share/groff/site-tmac
+/usr/local/share/groff/1.23.0/tmac
+</pre></div></div>
+
+<p>The foregoing assumes that the version of <code class="code">groff</code> is 1.23.0, and
+that the installation prefix was <samp class="file">/usr/local</samp>.  It is possible to
+fine-tune these locations during the source configuration process.
+</p></li></ul>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Font-Directories">
+<div class="nav-panel">
+<p>
+Next: <a href="#Paper-Format" accesskey="n" rel="next">Paper Format</a>, Previous: <a href="#Macro-Directories" accesskey="p" rel="prev">Macro Directories</a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Font-Directories-1">2.4 Font Directories</h3>
+<a class="index-entry-id" id="index-font-directories"></a>
+<a class="index-entry-id" id="index-directories-for-fonts"></a>
+<a class="index-entry-id" id="index-searching-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-searching"></a>
+
+<p><code class="code">groff</code> enforces few restrictions on how font description files are
+named.  For its family/style mechanism to work (see <a class="pxref" href="#Font-Families">Font Families</a>),
+the names of fonts within a family should start with the family name,
+followed by the style.  For example, the Times family uses &lsquo;<samp class="samp">T</samp>&rsquo; for
+the family name and &lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, &lsquo;<samp class="samp">I</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo; to
+indicate the styles &lsquo;roman&rsquo;, &lsquo;bold&rsquo;, &lsquo;italic&rsquo;, and &lsquo;bold italic&rsquo;,
+respectively.  Thus the final font names are &lsquo;<samp class="samp">TR</samp>&rsquo;, &lsquo;<samp class="samp">TB</samp>&rsquo;,
+&lsquo;<samp class="samp">TI</samp>&rsquo;, and &lsquo;<samp class="samp">TBI</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-font-path"></a>
+<a class="index-entry-id" id="index-path_002c-for-font-files"></a>
+<p>Font description files are kept in <em class="dfn">font directories</em>, which
+together constitute the <em class="dfn">font path</em>.  The search procedure
+always appends the directory <code class="code">dev</code><var class="var">name</var>, where <var class="var">name</var> is
+the name of the output device.  Assuming TeX DVI output, and
+<samp class="file">/foo/bar</samp> as a font directory, the font description files for
+<code class="command">grodvi</code> must be in <samp class="file">/foo/bar/devdvi</samp>.
+Each directory in the font path is searched in the following order until
+the desired font description file is found or the list is exhausted.
+</p>
+<ul class="itemize mark-bullet">
+<li>Directories specified with GNU <code class="code">troff</code>&rsquo;s or <code class="code">groff</code>&rsquo;s
+<samp class="option">-f</samp> command-line option.  All output drivers (and some
+preprocessors) support this option as well, because they require
+information about the glyphs to be rendered in the document.
+
+</li><li><a class="index-entry-id" id="index-GROFF_005fFONT_005fPATH_002c-environment-variable-1"></a>
+Directories listed in the <code class="env">GROFF_FONT_PATH</code> environment variable.
+
+</li><li><a class="index-entry-id" id="index-site_002dlocal-directory-1"></a>
+<a class="index-entry-id" id="index-directory_002c-site_002dlocal-1"></a>
+A site-local directory and the main font description directory.
+The locations corresponding to your installation are listed in section
+&ldquo;Environment&rdquo; of <cite class="cite">gtroff<span class="r">(1)</span></cite>.  If not otherwise configured,
+they are as follows.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">/usr/local/share/groff/site-font
+/usr/local/share/groff/1.23.0/font
+</pre></div></div>
+
+<p>The foregoing assumes that the version of <code class="code">groff</code> is 1.23.0, and
+that the installation prefix was <samp class="file">/usr/local</samp>.  It is possible to
+fine-tune these locations during the source configuration process.
+</p></li></ul>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Paper-Format">
+<div class="nav-panel">
+<p>
+Next: <a href="#Invocation-Examples" accesskey="n" rel="next">Invocation Examples</a>, Previous: <a href="#Font-Directories" accesskey="p" rel="prev">Font Directories</a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Paper-Format-1">2.5 Paper Format</h3>
+<a class="index-entry-id" id="index-paper-format"></a>
+<a class="index-entry-id" id="index-format_002c-paper"></a>
+<a class="index-entry-id" id="index-paper-size"></a>
+<a class="index-entry-id" id="index-size_002c-paper"></a>
+<a class="index-entry-id" id="index-landscape-page-orientation"></a>
+<a class="index-entry-id" id="index-orientation_002c-landscape"></a>
+<a class="index-entry-id" id="index-page-orientation_002c-landscape"></a>
+
+<p>In <code class="code">groff</code>, the page dimensions for the formatter GNU <code class="code">troff</code>
+and for output devices are handled separately.  See <a class="xref" href="#Page-Layout">Page Layout</a>, for
+vertical manipulation of the page size, and See <a class="xref" href="#Line-Layout">Line Layout</a>, for
+horizontal changes.
+<a class="index-entry-id" id="index-papersize_002etmac"></a>
+<a class="index-entry-id" id="index-troffrc-1"></a>
+The <samp class="file">papersize</samp> macro package, normally loaded by <samp class="file">troffrc</samp> at
+startup, provides an interface for configuring page dimensions by
+convenient names, like &lsquo;<samp class="samp">letter</samp>&rsquo; or &lsquo;<samp class="samp">a4</samp>&rsquo;; see
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite>.  The default used by the formatter depends on
+its build configuration, but is usually one of the foregoing, as
+geographically appropriate.
+</p>
+<p>It is up to each macro package to respect the page dimensions configured
+in this way.
+</p>
+<p>For each output device, the size of the output medium can be set in its
+<samp class="file">DESC</samp> file.  Most output drivers also recognize a command-line
+option <samp class="option">-p</samp> to override the default dimensions and an option
+<samp class="option">-l</samp> to use landscape orientation.  See <a class="xref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>, for
+a description of the <code class="code">papersize</code> keyword, which takes an argument
+of the same form as <samp class="option">-p</samp>.  The output driver&rsquo;s man page, such as
+<cite class="cite">grops<span class="r">(1)</span></cite>, may also be helpful.
+</p>
+<p><code class="code">groff</code> uses the command-line option <samp class="option">-P</samp> to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms &gt; foo.ps
+</pre></div></div>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Invocation-Examples">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Paper-Format" accesskey="p" rel="prev">Paper Format</a>, Up: <a href="#Invoking-groff" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Invocation-Examples-1">2.6 Invocation Examples</h3>
+<a class="index-entry-id" id="index-invocation-examples"></a>
+<a class="index-entry-id" id="index-examples-of-invocation"></a>
+
+<p><code class="code">roff</code> systems are best known for formatting man pages.  Once a
+<code class="command">man</code> librarian program has located a man page, it may execute
+a <code class="code">groff</code> command much like the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -t -man -Tutf8 /usr/share/man/man1/groff.1
+</pre></div></div>
+
+<p>The librarian will also pipe the output through a pager, which might not
+interpret the SGR terminal escape sequences <code class="command">groff</code> emits for
+boldface, underlining, or italics; see the <cite class="cite">grotty<span class="r">(1)</span></cite> man page
+for a discussion.
+</p>
+<p>To process a <code class="code">roff</code> input file using the preprocessors
+<code class="command">gtbl</code> and <code class="command">gpic</code> and the <samp class="file">me</samp> macro package in the
+way to which AT&amp;T <code class="code">troff</code> users were accustomed, one would type (or
+script) a pipeline.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">gpic foo.me | gtbl | gtroff -me -Tutf8 | grotty
+</pre></div></div>
+
+<p>Using <code class="command">groff</code>, this pipe can be shortened to an equivalent
+command.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -p -t -me -T utf8 foo.me
+</pre></div></div>
+
+<p>An even easier way to do this is to use <code class="command">grog</code> to guess the
+preprocessor and macro options and execute the result by using the
+command substitution feature of the shell.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$(grog -Tutf8 foo.me)
+</pre></div></div>
+
+<p>Each command-line option to a postprocessor must be specified with any
+required leading dashes &lsquo;<samp class="samp">-</samp>&rsquo;
+because <code class="command">groff</code> passes the arguments as-is to the postprocessor;
+this permits arbitrary arguments to be transmitted.  For example, to
+pass a title to the <code class="command">gxditview</code> postprocessor,
+the shell commands
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -X -P -title -P 'trial run' mydoc.t
+</pre></div></div>
+
+<p>and
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -X -Z mydoc.t | gxditview -title 'trial run' -
+</pre></div></div>
+
+<p>are equivalent.
+</p>
+
+
+
+<hr>
+</div>
+</div>
+<div class="chapter-level-extent" id="Tutorial-for-Macro-Users">
+<div class="nav-panel">
+<p>
+Next: <a href="#Major-Macro-Packages" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="#Invoking-groff" accesskey="p" rel="prev">Invoking <code class="code">groff</code></a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="Tutorial-for-Macro-Users-1">3 Tutorial for Macro Users</h2>
+<a class="index-entry-id" id="index-tutorial-for-macro-users"></a>
+<a class="index-entry-id" id="index-macros_002c-tutorial-for-users"></a>
+<a class="index-entry-id" id="index-user_0027s-tutorial-for-macros"></a>
+<a class="index-entry-id" id="index-user_0027s-macro-tutorial"></a>
+
+<p>Most users of the <code class="code">roff</code> language employ a macro package to format
+their documents.  Successful macro packages ease the composition
+process; their users need not have mastered the full formatting
+language, nor understand features like diversions, traps, and
+environments.  This chapter aims to familiarize you with basic concepts
+and mechanisms common to many macro packages (like &ldquo;displays&rdquo;).  If
+you prefer a meticulous and comprehensive presentation, try <a class="ref" href="#GNU-troff-Reference">GNU <code class="code">troff</code> Reference</a> instead.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Basics" accesskey="1">Basics</a></li>
+<li><a href="#Common-Features" accesskey="2">Common Features</a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="Basics">
+<div class="nav-panel">
+<p>
+Next: <a href="#Common-Features" accesskey="n" rel="next">Common Features</a>, Previous: <a href="#Tutorial-for-Macro-Users" accesskey="p" rel="prev">Tutorial for Macro Users</a>, Up: <a href="#Tutorial-for-Macro-Users" accesskey="u" rel="up">Tutorial for Macro Users</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Basics-1">3.1 Basics</h3>
+<a class="index-entry-id" id="index-basics-of-macro-package-usage"></a>
+<a class="index-entry-id" id="index-macro-package-usage_002c-basics-of"></a>
+
+<p>Let us first survey some basic concepts necessary to use a macro package
+fruitfully.<a class="footnote" id="DOCF6" href="#FOOT6"><sup>6</sup></a>
+References are made throughout to more detailed information.
+</p>
+<p>GNU <code class="code">troff</code> reads an input file prepared by the user and outputs a
+formatted document suitable for publication or framing.  The input
+consists of text, or words to be printed, and embedded commands
+(<i class="slanted">requests</i> and <i class="slanted">escape sequences</i>), which tell GNU
+<code class="code">troff</code> how to format the output.  See <a class="xref" href="#Formatter-Instructions">Formatter Instructions</a>.
+</p>
+<p>The word <i class="slanted">argument</i> is used in this chapter to mean a word or
+number that appears on the same line as a request, and which modifies
+the meaning of that request.  For example, the request
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp
+</pre></div></div>
+
+<p>spaces one line, but
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp 4
+</pre></div></div>
+
+<p>spaces four lines.  The number&nbsp;4 is an argument to the <code class="code">sp</code>
+request, which says to space four lines instead of one.  Arguments are
+separated from the request and from each other by spaces (<em class="emph">not</em>
+tabs).  See <a class="xref" href="#Invoking-Requests">Invoking Requests</a>.
+</p>
+<p>The primary function of GNU <code class="code">troff</code> is to collect words from input
+lines, fill output lines with those words, adjust the line to the
+right-hand margin by widening spaces, and output the result.  For
+example, the input:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Now is the time
+for all good men
+to come to the aid
+of their party.
+Four score and seven
+years ago, etc.
+</pre></div></div>
+
+<p>is read, packed onto output lines, and justified to produce:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; Now is the time for all good men to come to the aid of
+  &rArr; their party.  Four score and seven years ago, etc.
+</pre></div></div>
+
+<p>Sometimes a new output line should be started even though the current
+line is not yet full&mdash;for example, at the end of a paragraph.  To do
+this it is possible to force a <i class="slanted">break</i>, starting a new output
+line.  Some requests cause a break automatically, as do (normally) blank
+input lines and input lines beginning with a space or tab.
+</p>
+<p>Not all input lines are <i class="slanted">text lines</i>&mdash;words to be formatted.
+Some are <i class="slanted">control lines</i> that tell a macro package (or GNU
+<code class="code">troff</code> directly) how to format the text.  Control lines start with
+a dot (&lsquo;<samp class="samp">.</samp>&rsquo;) or an apostrophe (&lsquo;<samp class="samp">'</samp>&rsquo;) as the first character, and
+can be followed by a <i class="slanted">macro call</i>.
+</p>
+<p>The formatter also does more complex things, such as automatically
+numbering pages, skipping over page boundaries, putting footnotes in the
+correct place, and so forth.
+</p>
+<p>Here are a few hints for preparing text for input to GNU <code class="code">troff</code>.
+</p>
+<ul class="itemize mark-bullet">
+<li>First, keep the input lines short.  Short input lines are easier to
+edit, and GNU <code class="code">troff</code> packs words onto longer lines anyhow.
+
+</li><li>In keeping with this, it is helpful to begin a new line after every
+comma or phrase, since common corrections are to add or delete sentences
+or phrases.
+
+</li><li>End each sentence with two spaces&mdash;or better, start each sentence on a
+new line.  GNU <code class="code">troff</code> recognizes characters that usually end a
+sentence, and inserts inter-sentence space accordingly.
+
+</li><li>Do not hyphenate words at the end of lines&mdash;GNU <code class="code">troff</code> is smart
+enough to hyphenate words as needed, but is not smart enough to take
+hyphens out and join a word back together.  Also, words such as
+&ldquo;mother-in-law&rdquo; should not be broken over a line, since then a space
+can occur where not wanted, such as &ldquo;<span class="w-nolinebreak-text">mother-</span>&nbsp;in-law&rdquo;.
+</li></ul>
+
+<p>We offer further advice in <a class="ref" href="#Input-Conventions">Input Conventions</a>.
+</p>
+<a class="index-entry-id" id="index-vertical-spacing-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical-_0028introduction_0029"></a>
+<p>GNU <code class="code">troff</code> permits alteration of the distance between lines of
+text.  This is termed <i class="slanted">vertical spacing</i> and is expressed in the
+same units as the type size&mdash;the point.  The default is 10-point type
+on 12-point spacing.  To get <i class="slanted">double-spaced</i> text you would set
+the vertical spacing to 24 points.  Some, but not all, macro packages
+expose a macro or register to configure the vertical spacing.
+</p>
+<p>A number of requests allow you to change the way the output is arranged
+on the page, sometimes called the <i class="slanted">layout</i> of the output page.
+Most macro packages don&rsquo;t supply macros for performing these (at least
+not without performing other actions besides), as they are such basic
+operations.  The macro packages for writing man pages, <samp class="file">man</samp> and
+<samp class="file">mdoc</samp>, don&rsquo;t encourage explicit use of these requests at all.
+</p>
+<a class="index-entry-id" id="index-spacing-_0028introduction_0029"></a>
+<p>The request &lsquo;<samp class="samp">.sp&nbsp;<var class="var">N</var></samp>&rsquo; leaves <var class="var">N</var>&nbsp;lines of blank
+space.  <var class="var">N</var>&nbsp;can be omitted (skipping a single line) or can
+be of the form <var class="var">N</var>i (for <var class="var">N</var>&nbsp;inches) or <var class="var">N</var>c (for
+<var class="var">N</var>&nbsp;centimeters).  For example, the input:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp 1.5i
+My thoughts on the subject
+.sp
+</pre></div></div>
+
+<p>leaves one and a half inches of space, followed by the line &ldquo;My
+thoughts on the subject&rdquo;, followed by a single blank line (more
+measurement units are available; see <a class="ref" href="#Measurements">Measurements</a>).
+</p>
+<p>If you seek precision in spacing, be advised when using a macro package
+that it might not honor <code class="code">sp</code> requests as you expect; it can use a
+formatter feature called <i class="slanted">no-space mode</i> to prevent excess space
+from accumulating.  Macro packages typically offer registers to control
+spacing between paragraphs, before section headings, and around displays
+(discussed below); use these facilities preferentially.
+See <a class="xref" href="#Manipulating-Spacing">Manipulating Spacing</a>.
+</p>
+<a class="index-entry-id" id="index-centering-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-centering-_0028introduction_0029"></a>
+<p>Text lines can be centered by using the <code class="code">ce</code> request.  The line
+after <code class="code">ce</code> is centered (horizontally) on the page.  To center more
+than one line, use &lsquo;<samp class="samp">.ce&nbsp;<var class="var">N</var></samp>&rsquo; (where <var class="var">N</var> is the number
+of lines to center), followed by the <var class="var">N</var>&nbsp;lines.  To center many
+lines without counting them, type:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ce 1000
+lines to center
+.ce 0
+</pre></div></div>
+
+<p>The &lsquo;<samp class="samp">.ce&nbsp;0</samp>&rsquo; request tells GNU <code class="code">troff</code> to center zero more
+lines, in other words, stop centering.
+</p>
+<a class="index-entry-id" id="index-right_002daligning-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-right_002daligning-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-right_002djustifying-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-right_002djustifying-_0028introduction_0029"></a>
+<p>GNU <code class="code">troff</code> also offers the <code class="code">rj</code> request for right-aligning
+text.  It works analogously to <code class="code">ce</code> and is convenient for setting
+epigraphs.
+</p>
+<a class="index-entry-id" id="index-page-break-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-break_002c-page-_0028introduction_0029"></a>
+<p>The <code class="code">bp</code> request starts a new page; this necessarily implies an
+ordinary (line) break.
+</p>
+<a class="index-entry-id" id="index-break-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-line-break-_0028introduction_0029"></a>
+<p>All of these requests cause a break; that is, they always start a new
+line.  To start a new line without performing any other action, use
+<code class="code">br</code>.  If you invoke them with the apostrophe &lsquo;<samp class="samp">'</samp>&rsquo;, the
+<i class="slanted">no-break control character</i>, the (initial) break they normally
+perform is suppressed.  &lsquo;<samp class="samp">'br</samp>&rsquo; does nothing.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Common-Features">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Basics" accesskey="p" rel="prev">Basics</a>, Up: <a href="#Tutorial-for-Macro-Users" accesskey="u" rel="up">Tutorial for Macro Users</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Common-Features-1">3.2 Common Features</h3>
+<a class="index-entry-id" id="index-common-features"></a>
+<a class="index-entry-id" id="index-features_002c-common"></a>
+
+<p>GNU <code class="code">troff</code> provides low-level operations for formatting a
+document.  Many routine operations are undertaken in nearly all
+documents that require a series of such primitive operations to be
+performed.  These common tasks are grouped into <i class="slanted">macros</i>, which
+are then collected into a <i class="slanted">macro package</i>.
+</p>
+<p>Macro packages come in two varieties: &ldquo;major&rdquo; or &ldquo;full-service&rdquo;
+ones that manage page layout, and &ldquo;minor&rdquo; or &ldquo;auxiliary&rdquo; ones that
+do not, instead fulfilling narrow, specific tasks.  Find a list in the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.  Type &lsquo;<samp class="samp">man groff_tmac</samp>&rsquo; at the
+command line to view it.
+</p>
+<p>We survey several capabilities of full-service macro package below.
+Each package employs its own macros to exercise them.  For details,
+consult its man page or, for <samp class="file">ms</samp>, see <a class="ref" href="#ms"><samp class="file">ms</samp></a>.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Paragraphs" accesskey="1">Paragraphs</a></li>
+<li><a href="#Sections-and-Chapters" accesskey="2">Sections and Chapters</a></li>
+<li><a href="#Headers-and-Footers" accesskey="3">Headers and Footers</a></li>
+<li><a href="#Page-Layout-Adjustment" accesskey="4">Page Layout</a></li>
+<li><a href="#Displays-and-Keeps" accesskey="5">Displays and Keeps</a></li>
+<li><a href="#Footnotes-and-Endnotes" accesskey="6">Footnotes and Endnotes</a></li>
+<li><a href="#Table-of-Contents" accesskey="7">Table of Contents</a></li>
+<li><a href="#Indexing" accesskey="8">Indexing</a></li>
+<li><a href="#Document-Formats" accesskey="9">Document Formats</a></li>
+<li><a href="#Columnation">Columnation</a></li>
+<li><a href="#Font-and-Size-Changes">Font and Size Changes</a></li>
+<li><a href="#Predefined-Text">Predefined Text</a></li>
+<li><a href="#Preprocessor-Support">Preprocessor Support</a></li>
+<li><a href="#Configuration-and-Customization">Configuration and Customization</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Paragraphs">
+<div class="nav-panel">
+<p>
+Next: <a href="#Sections-and-Chapters" accesskey="n" rel="next">Sections and Chapters</a>, Previous: <a href="#Common-Features" accesskey="p" rel="prev">Common Features</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Paragraphs-1">3.2.1 Paragraphs</h4>
+<a class="index-entry-id" id="index-paragraphs"></a>
+
+<p>Paragraphs can be separated and indented in various ways.  Some start
+with a blank line and have a first-line indentation, like most of the
+ones in this manual.  Block paragraphs omit the indentation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; Some  men  look  at constitutions with sanctimonious
+  &rArr; reverence,  and  deem  them  like  the  ark  of  the
+  &rArr; covenant, too sacred to be touched.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-tags_002c-paragraph"></a>
+<a class="index-entry-id" id="index-tagged-paragraphs"></a>
+<a class="index-entry-id" id="index-lists"></a>
+<p>We also frequently encounter <i class="slanted">tagged</i> paragraphs, which begin
+with a tag or label at the left margin and indent the remaining text.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; one  This  is the first paragraph.  Notice how the
+  &rArr;      first line of the resulting  paragraph  lines
+  &rArr;      up with the other lines in the paragraph.
+</pre></div></div>
+
+<p>If the tag is too wide for the indentation, the line is broken.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; longlabel
+  &rArr;      The  label does not align with the subsequent
+  &rArr;      lines, but they align with each other.
+</pre></div></div>
+
+<p>A variation of the tagged paragraph is the itemized or enumerated
+paragraph, which might use punctuation or a digit for a tag,
+respectively.  These are frequently used to construct lists.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; o    This  list  item  starts with a bullet.  When
+  &rArr;      producing output for a device using the ASCII
+  &rArr;      character set, an 'o' is formatted instead.
+</pre></div></div>
+
+<p>Often, use of the same macro without a tag continues such a discussion.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; -xyz  This option is recognized but ignored.
+  &rArr;
+  &rArr;       It had a security hole that we don't discuss.
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Sections-and-Chapters">
+<div class="nav-panel">
+<p>
+Next: <a href="#Headers-and-Footers" accesskey="n" rel="next">Headers and Footers</a>, Previous: <a href="#Paragraphs" accesskey="p" rel="prev">Paragraphs</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Sections-and-Chapters-1">3.2.2 Sections and Chapters</h4>
+
+<p>The simplest kind of section heading is unnumbered, set in a bold or
+italic style, and occupies a line by itself.  Others possess
+automatically numbered multi-level headings and/or different typeface
+styles or sizes at different levels.  More sophisticated macro packages
+supply macros for designating chapters and appendices.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Headers-and-Footers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Page-Layout-Adjustment" accesskey="n" rel="next">Page Layout</a>, Previous: <a href="#Sections-and-Chapters" accesskey="p" rel="prev">Sections and Chapters</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Headers-and-Footers-1">3.2.3 Headers and Footers</h4>
+
+<p><i class="slanted">Headers</i> and <i class="slanted">footers</i> occupy the top and bottom of
+each page, respectively, and contain data like the page number and the
+article or chapter title.  Their appearance is not affected by the
+running text.  Some packages allow for different titles on even- and
+odd-numbered pages (for printed, bound material).
+</p>
+<p>Headers and footers are together called <i class="slanted">titles</i>, and comprise
+three parts: left-aligned, centered, and right-aligned.  A &lsquo;<samp class="samp">%</samp>&rsquo;
+character appearing anywhere in a title is automatically replaced by the
+page number.  See <a class="xref" href="#Page-Layout">Page Layout</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Page-Layout-Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="#Displays-and-Keeps" accesskey="n" rel="next">Displays and Keeps</a>, Previous: <a href="#Headers-and-Footers" accesskey="p" rel="prev">Headers and Footers</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Page-Layout-1">3.2.4 Page Layout</h4>
+
+<p>Most macro packages let the user specify the size of the page margins.
+The top and bottom margins are typically handled differently than the
+left and right margins; the latter two are derived from the
+<i class="slanted">page offset</i>, <i class="slanted">indentation</i>, and <i class="slanted">line length</i>.
+See <a class="xref" href="#Line-Layout">Line Layout</a>.  Commonly, packages support registers to tune these
+values.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Displays-and-Keeps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Footnotes-and-Endnotes" accesskey="n" rel="next">Footnotes and Endnotes</a>, Previous: <a href="#Page-Layout-Adjustment" accesskey="p" rel="prev">Page Layout</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Displays-and-Keeps-1">3.2.5 Displays and Keeps</h4>
+<a class="index-entry-id" id="index-displays"></a>
+
+<p><i class="slanted">Displays</i> are sections of text set off from the surrounding
+material (typically paragraphs), often differing in indentation, and/or
+spacing.  Tables, block quotations, and figures are displayed.
+Equations and code examples, when not much shorter than an output line,
+often are.  Lists may or may not be.  Packages for setting man pages
+support example displays but not keeps.
+</p>
+<a class="index-entry-id" id="index-keeps-_0028introduction_0029"></a>
+<p>A <i class="slanted">keep</i> is a group of output lines, often a display, that is
+formatted on a single page if possible; it causes a page break to happen
+early so as to not interrupt the kept material.
+</p>
+<a class="index-entry-id" id="index-keep_002c-floating"></a>
+<a class="index-entry-id" id="index-floating-keep"></a>
+<p><i class="slanted">Floating keeps</i> can move, or &ldquo;float&rdquo;, relative to the text
+around them in the input.  They are useful for displays that are
+captioned and referred to by name, as with &ldquo;See figure&nbsp;3&rdquo;.
+Depending on the package, a floating keep appears at the bottom of the
+current page if it fits, and at the top of the next otherwise.
+Alternatively, floating keeps might be deferred to the end of a section.
+Using a floating keep can avoid the large vertical spaces that may
+precede a tall keep of the ordinary sort when it won&rsquo;t fit on the page.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Footnotes-and-Endnotes">
+<div class="nav-panel">
+<p>
+Next: <a href="#Table-of-Contents" accesskey="n" rel="next">Table of Contents</a>, Previous: <a href="#Displays-and-Keeps" accesskey="p" rel="prev">Displays and Keeps</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Footnotes-and-Endnotes-1">3.2.6 Footnotes and Endnotes</h4>
+<a class="index-entry-id" id="index-footnotes"></a>
+<a class="index-entry-id" id="index-endnotes"></a>
+
+<p><i class="slanted">Footnotes</i> and <i class="slanted">endnotes</i> are forms of delayed
+formatting.  They are recorded at their points of relevance in
+the input, but not formatted there.  Instead, a <i class="slanted">mark</i> cues the
+reader to check the &ldquo;foot&rdquo;, or bottom, of the current page, or in the
+case of endnotes, an annotation list later in the document.  Macro
+packages that support these features also supply a means of
+automatically numbering either type of annotation.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Table-of-Contents">
+<div class="nav-panel">
+<p>
+Next: <a href="#Indexing" accesskey="n" rel="next">Indexing</a>, Previous: <a href="#Footnotes-and-Endnotes" accesskey="p" rel="prev">Footnotes and Endnotes</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Table-of-Contents-1">3.2.7 Table of Contents</h4>
+<a class="index-entry-id" id="index-table-of-contents"></a>
+<a class="index-entry-id" id="index-contents_002c-table-of"></a>
+
+<p>A package may handle a <i class="slanted">table of contents</i> by directing section
+heading macros to save section heading text and the page number where it
+occurs for use in a later <i class="slanted">entry</i> for a table of contents.  It
+writes the collected entries at the end of the document, once all are
+known, upon request.  A row of dots (a <i class="slanted">leader</i>) bridges the
+text on the left with its location on the right.  Other collections
+might work in this manner, providing lists of figures or tables.
+</p>
+<p>A table of contents is often found at the end of a GNU <code class="code">troff</code>
+document because the formatter processes the document in a single pass.
+The <code class="command">gropdf</code> output driver supports a PDF feature that relocates
+pages at the time the document is rendered; see the <cite class="cite">gropdf<span class="r">(1)</span></cite>
+man page.  Type &lsquo;<samp class="samp">man gropdf</samp>&rsquo; at the command line to view it.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Indexing">
+<div class="nav-panel">
+<p>
+Next: <a href="#Document-Formats" accesskey="n" rel="next">Document Formats</a>, Previous: <a href="#Table-of-Contents" accesskey="p" rel="prev">Table of Contents</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Indexing-1">3.2.8 Indexing</h4>
+<a class="index-entry-id" id="index-index_002c-in-macro-package"></a>
+
+<a class="index-entry-id" id="index-makeindex"></a>
+<p>An index is similar to a table of contents, in that entry labels and
+locations must be collected, but poses a greater challenge because it
+needs to be sorted before it is output.  Here, processing the document
+in multiple passes is inescapable, and tools like the <code class="code">makeindex</code>
+program are necessary.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Document-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="#Columnation" accesskey="n" rel="next">Columnation</a>, Previous: <a href="#Indexing" accesskey="p" rel="prev">Indexing</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Document-Formats-1">3.2.9 Document Formats</h4>
+<a class="index-entry-id" id="index-document-formats"></a>
+
+<p>Some macro packages supply stock configurations of certain documents,
+like business letters and memoranda.  These often also have provision
+for a <i class="slanted">cover sheet</i>, which may be rigid in its format.  With
+these features, it is even more important to use the package&rsquo;s macros in
+preference to the formatter requests presented earlier, where possible.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Columnation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Font-and-Size-Changes" accesskey="n" rel="next">Font and Size Changes</a>, Previous: <a href="#Document-Formats" accesskey="p" rel="prev">Document Formats</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Columnation-1">3.2.10 Columnation</h4>
+
+<p>Macro packages apart from <samp class="file">man</samp> and <samp class="file">mdoc</samp> for man page
+formatting offer a facility for setting multiple columns on the page.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Font-and-Size-Changes">
+<div class="nav-panel">
+<p>
+Next: <a href="#Predefined-Text" accesskey="n" rel="next">Predefined Text</a>, Previous: <a href="#Columnation" accesskey="p" rel="prev">Columnation</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Font-and-Size-Changes-1">3.2.11 Font and Size Changes</h4>
+
+<p>The formatter&rsquo;s requests and escape sequences for setting the typeface
+and size are not always intuitive, so all macro packages provide macros
+to make these operations simpler.  They also make it more convenient to
+change typefaces in the middle of a word and can handle italic
+corrections automatically.  See <a class="xref" href="#Italic-Corrections">Italic Corrections</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Predefined-Text">
+<div class="nav-panel">
+<p>
+Next: <a href="#Preprocessor-Support" accesskey="n" rel="next">Preprocessor Support</a>, Previous: <a href="#Font-and-Size-Changes" accesskey="p" rel="prev">Font and Size Changes</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Predefined-Text-1">3.2.12 Predefined Text</h4>
+
+<p>Most macro packages supply predefined strings to set prepared text like
+the date, or to perform operations like super- and subscripting.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Preprocessor-Support">
+<div class="nav-panel">
+<p>
+Next: <a href="#Configuration-and-Customization" accesskey="n" rel="next">Configuration and Customization</a>, Previous: <a href="#Predefined-Text" accesskey="p" rel="prev">Predefined Text</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Preprocessor-Support-1">3.2.13 Preprocessor Support</h4>
+
+<p>All macro packages provide support for various preprocessors and may
+extend their functionality by defining macros to set their contents in
+displays.  Examples include <code class="code">TS</code> and <code class="code">TE</code> for <code class="command">gtbl</code>,
+<code class="code">EQ</code> and <code class="code">EN</code> for <code class="command">geqn</code>, and <code class="code">PS</code> and <code class="code">PE</code>
+for <code class="command">gpic</code>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Configuration-and-Customization">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Preprocessor-Support" accesskey="p" rel="prev">Preprocessor Support</a>, Up: <a href="#Common-Features" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Configuration-and-Customization-1">3.2.14 Configuration and Customization</h4>
+
+<p>Packages provide means of customizing many of the details of how the
+package behaves.  These range from setting the default type size to
+changing the appearance of section headers.
+</p>
+
+
+
+
+<hr>
+</div>
+</div>
+</div>
+<div class="chapter-level-extent" id="Major-Macro-Packages">
+<div class="nav-panel">
+<p>
+Next: <a href="#GNU-troff-Reference" accesskey="n" rel="next">GNU <code class="code">troff</code> Reference</a>, Previous: <a href="#Tutorial-for-Macro-Users" accesskey="p" rel="prev">Tutorial for Macro Users</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="Macro-Packages-2">4 Macro Packages</h2>
+<a class="index-entry-id" id="index-major-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-major"></a>
+<a class="index-entry-id" id="index-macro-package_002c-major"></a>
+
+<p>This chapter surveys the &ldquo;major&rdquo; macro packages that come with
+<code class="code">groff</code>.  One, <samp class="file">ms</samp>, is presented in detail.
+</p>
+<a class="index-entry-id" id="index-full_002dservice-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-full_002dservice"></a>
+<a class="index-entry-id" id="index-macro-package_002c-full_002dservice"></a>
+<p>Major macro packages are also sometimes described as <em class="dfn">full-service</em>
+due to the breadth of features they provide and because more than one
+cannot be used by the same document; for example
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -m man foo.man -m ms bar.doc
+</pre></div></div>
+
+<p>doesn&rsquo;t work.  Option arguments are processed before non-option
+arguments; the above (failing) sample is thus reordered to
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -m man -m ms foo.man bar.doc
+</pre></div></div>
+
+<a class="index-entry-id" id="index-minor-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-minor"></a>
+<a class="index-entry-id" id="index-macro-package_002c-minor"></a>
+<a class="index-entry-id" id="index-auxiliary-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-auxiliary"></a>
+<a class="index-entry-id" id="index-macro-package_002c-auxiliary"></a>
+<p>Many auxiliary, or &ldquo;minor&rdquo;, macro packages are also available.  They
+may in general be used with any full-service macro package and handle a
+variety of tasks from character encoding selection, to language
+localization, to inlining of raster images.  See the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page for a list.  Type &lsquo;<samp class="samp">man
+groff_tmac</samp>&rsquo; at the command line to view it.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="#man" accesskey="1"><samp class="file">man</samp></a></li>
+<li><a href="#mdoc" accesskey="2"><samp class="file">mdoc</samp></a></li>
+<li><a href="#me" accesskey="3"><samp class="file">me</samp></a></li>
+<li><a href="#mm" accesskey="4"><samp class="file">mm</samp></a></li>
+<li><a href="#mom" accesskey="5"><samp class="file">mom</samp></a></li>
+<li><a href="#ms" accesskey="6"><samp class="file">ms</samp></a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="man">
+<div class="nav-panel">
+<p>
+Next: <a href="#mdoc" accesskey="n" rel="next"><samp class="file">mdoc</samp></a>, Previous: <a href="#Major-Macro-Packages" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="man-1">4.1 <samp class="file">man</samp></h3>
+<a class="index-entry-id" id="index-manual-pages"></a>
+<a class="index-entry-id" id="index-man-pages"></a>
+<a class="index-entry-id" id="index-an_002etmac"></a>
+<a class="index-entry-id" id="index-man_002etmac"></a>
+
+<p>The <code class="code">man</code> macro package is the most widely used and probably the
+most important ever developed for <code class="code">troff</code>.  It is easy to use, and
+a vast majority of manual pages (&ldquo;man pages&rdquo;) are written in it.
+</p>
+<p><code class="code">groff</code>&rsquo;s implementation is documented in the
+<cite class="cite">groff_man<span class="r">(7)</span></cite> man page.  Type &lsquo;<samp class="samp">man groff_man</samp>&rsquo; at the
+command line to view it.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Optional-man-extensions" accesskey="1">Optional <samp class="file">man</samp> extensions</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Optional-man-extensions">
+<div class="nav-panel">
+<p>
+Up: <a href="#man" accesskey="u" rel="up"><samp class="file">man</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Optional-man-extensions-1">4.1.1 Optional <samp class="file">man</samp> extensions</h4>
+
+<a class="index-entry-id" id="index-man_002elocal"></a>
+<p>Use the file <samp class="file">man.local</samp> for local extensions to the <code class="code">man</code>
+macros or for style changes.
+</p>
+<ul class="mini-toc">
+<li><a href="#Custom-headers-and-footers" accesskey="1">Custom headers and footers</a></li>
+<li><a href="#Ultrix_002dspecific-man-macros" accesskey="2">Ultrix-specific man macros</a></li>
+<li><a href="#Simple-example" accesskey="3">Simple example</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="Custom-headers-and-footers">
+<h4 class="unnumberedsubsubsec">Custom headers and footers</h4>
+<a class="index-entry-id" id="index-man-macros_002c-custom-headers-and-footers"></a>
+
+<p>In <code class="code">groff</code> versions 1.18.2 and later, you can specify custom
+headers and footers by redefining the following macros in
+<samp class="file">man.local</samp>.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PT</code></strong><a class="copiable-link" href='#index-_002ePT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PT-_005bman_005d"></a>
+<p>Control the content of the headers.  Normally, the header prints the
+command name and section number on either side, and the optional fifth
+argument to <code class="code">TH</code> in the center.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BT</code></strong><a class="copiable-link" href='#index-_002eBT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BT-_005bman_005d"></a>
+<p>Control the content of the footers.  Normally, the footer prints the
+page number and the third and fourth arguments to <code class="code">TH</code>.
+</p>
+<p>Use the <code class="code">FT</code> register to specify the footer position.  The default
+is &minus;0.5<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Ultrix_002dspecific-man-macros">
+<h4 class="unnumberedsubsubsec">Ultrix-specific man macros</h4>
+<a class="index-entry-id" id="index-Ultrix_002dspecific-man-macros"></a>
+<a class="index-entry-id" id="index-man-macros_002c-Ultrix_002dspecific"></a>
+
+<a class="index-entry-id" id="index-man_002eultrix"></a>
+<p>The <code class="code">groff</code> source distribution includes a file named
+<samp class="file">man.ultrix</samp>, containing macros compatible with the Ultrix variant
+of <code class="code">man</code>.  Copy this file into <samp class="file">man.local</samp> (or use the
+<code class="code">mso</code> request to load it) to enable the following macros.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">key</i></span></var><a class="copiable-link" href='#index-_002eCT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CT-_005bman_005d"></a>
+<p>Print &lsquo;<samp class="samp">&lt;CTRL/<var class="var">key</var>&gt;</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCW"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CW</code></strong><a class="copiable-link" href='#index-_002eCW'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CW-_005bman_005d"></a>
+<p>Print subsequent text using a &ldquo;constant-width&rdquo; (monospaced) typeface
+(Courier roman).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDs"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.Ds</code></strong><a class="copiable-link" href='#index-_002eDs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Ds-_005bman_005d"></a>
+<p>Begin a non-filled display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDe"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.De</code></strong><a class="copiable-link" href='#index-_002eDe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-De-_005bman_005d"></a>
+<p>End a non-filled display started with <code class="code">Ds</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EX</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eEX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EX-_005bman_005d"></a>
+<p>Begin a non-filled display using a monospaced typeface (Courier roman).
+Use the optional <var class="var">indent</var> argument to indent the display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EE</code></strong><a class="copiable-link" href='#index-_002eEE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EE-_005bman_005d"></a>
+<p>End a non-filled display started with <code class="code">EX</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eG"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.G</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eG'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-G-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica.  If no text is present on the line where
+the macro is called, then the text of the next line appears in
+Helvetica.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eGL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.GL</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eGL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GL-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica oblique.  If no text is present on the line
+where the macro is called, then the text of the next line appears in
+Helvetica Oblique.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eHB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.HB</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eHB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HB-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica bold.  If no text is present on the line
+where the macro is called, then all text up to the next <code class="code">HB</code>
+appears in Helvetica bold.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TB</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eTB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TB-_005bman_005d"></a>
+<p>Identical to <code class="code">HB</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eMS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.MS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">title</i></span> <span class="r"><i class="slanted">sect</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002eMS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MS-_005bman_005d"></a>
+<p>Set a man page reference in Ultrix format.  The <var class="var">title</var> is in
+Courier instead of italic.  Optional punctuation follows the section
+number without an intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NT</code></strong> <var class="def-var-arguments"><code class="code">C</code> <span class="r"><i class="slanted">title</i></span></var><a class="copiable-link" href='#index-_002eNT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NT-_005bman_005d"></a>
+<p>Begin a note.  Print the optional <span class="r"><i class="slanted">title</i></span>, or the word &ldquo;Note&rdquo;,
+centered on the page.  Text following the macro makes up the body of the
+note, and is indented on both sides.  If the first argument is <code class="code">C</code>,
+the body of the note is printed centered (the second argument replaces
+the word &ldquo;Note&rdquo; if specified).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NE</code></strong><a class="copiable-link" href='#index-_002eNE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NE-_005bman_005d"></a>
+<p>End a note begun with <code class="code">NT</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PN</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">path</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002ePN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PN-_005bman_005d"></a>
+<p>Set the path name in a monospaced typeface (Courier roman), followed by
+optional punctuation.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePn"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.Pn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">punct</i></span> <span class="r"><i class="slanted">path</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002ePn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Pn-_005bman_005d"></a>
+<p>If called with two arguments, identical to <code class="code">PN</code>.  If called with
+three arguments, set the second argument in a monospaced typeface
+(Courier roman), bracketed by the first and third arguments in the
+current font.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eR"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.R</code></strong><a class="copiable-link" href='#index-_002eR'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-R-_005bman_005d"></a>
+<p>Switch to roman font and turn off any underlining in effect.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RN</code></strong><a class="copiable-link" href='#index-_002eRN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RN-_005bman_005d"></a>
+<p>Print the string &lsquo;<samp class="samp">&lt;RETURN&gt;</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eVS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.VS</code></strong> <var class="def-var-arguments"><code class="code">4</code></var><a class="copiable-link" href='#index-_002eVS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VS-_005bman_005d"></a>
+<p>Start printing a change bar in the margin if the number&nbsp;<code class="code">4</code> is
+specified.  Otherwise, this macro does nothing.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eVE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.VE</code></strong><a class="copiable-link" href='#index-_002eVE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VE-_005bman_005d"></a>
+<p>End printing the change bar begun by <code class="code">VS</code>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Simple-example">
+<h4 class="unnumberedsubsubsec">Simple example</h4>
+
+<p>The following example <samp class="file">man.local</samp> file alters the <code class="code">SH</code> macro
+to add some extra vertical space before printing the heading.  Headings
+are printed in Helvetica bold.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Make the heading fonts Helvetica
+.ds HF HB
+.
+.\&quot; Put more space in front of headings.
+.rn SH SH-orig
+.de SH
+.  if t .sp (u;\\nPD*2)
+.  SH-orig \\$*
+..
+</pre></div></div>
+
+
+
+<hr>
+</div>
+</div>
+</div>
+<div class="section-level-extent" id="mdoc">
+<div class="nav-panel">
+<p>
+Next: <a href="#me" accesskey="n" rel="next"><samp class="file">me</samp></a>, Previous: <a href="#man" accesskey="p" rel="prev"><samp class="file">man</samp></a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="mdoc-1">4.2 <samp class="file">mdoc</samp></h3>
+<a class="index-entry-id" id="index-mdoc-macros"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the BSD <samp class="file">doc</samp> package for man
+pages is documented in the <cite class="cite">groff_mdoc<span class="r">(7)</span></cite> man page.  Type
+&lsquo;<samp class="samp">man groff_mdoc</samp>&rsquo; at the command line to view it.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="me">
+<div class="nav-panel">
+<p>
+Next: <a href="#mm" accesskey="n" rel="next"><samp class="file">mm</samp></a>, Previous: <a href="#mdoc" accesskey="p" rel="prev"><samp class="file">mdoc</samp></a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="me-1">4.3 <samp class="file">me</samp></h3>
+<a class="index-entry-id" id="index-me-macro-package"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the BSD <samp class="file">me</samp> macro package is
+documented using itself.  A tutorial, <samp class="file">meintro.me</samp>, and reference,
+<samp class="file">meref.me</samp>, are available in <code class="code">groff</code>&rsquo;s documentation
+directory.  A <cite class="cite">groff_me<span class="r">(7)</span></cite> man page is also available and
+identifies the installation path for these documents.  Type &lsquo;<samp class="samp">man
+groff_me</samp>&rsquo; at the command line to view it.
+</p>
+<p>A French translation of the tutorial is available as
+<samp class="file">meintro_fr.me</samp> and installed parallel to the English version.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="mm">
+<div class="nav-panel">
+<p>
+Next: <a href="#mom" accesskey="n" rel="next"><samp class="file">mom</samp></a>, Previous: <a href="#me" accesskey="p" rel="prev"><samp class="file">me</samp></a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="mm-1">4.4 <samp class="file">mm</samp></h3>
+<a class="index-entry-id" id="index-mm-macro-package"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the <abbr class="acronym">AT&amp;T</abbr> memorandum macro
+package is documented in the <cite class="cite">groff_mm<span class="r">(7)</span></cite> man page.  Type
+&lsquo;<samp class="samp">man groff_mm</samp>&rsquo; at the command line) to view it.
+</p>
+<p>A Swedish localization of <samp class="file">mm</samp> is also available; see
+<cite class="cite">groff_mmse<span class="r">(7)</span></cite>.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="mom">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms" accesskey="n" rel="next"><samp class="file">ms</samp></a>, Previous: <a href="#mm" accesskey="p" rel="prev"><samp class="file">mm</samp></a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="mom-1">4.5 <samp class="file">mom</samp></h3>
+<a class="index-entry-id" id="index-mom-macro-package"></a>
+
+<p>The main documentation files for the <samp class="file">mom</samp> macros are in
+<abbr class="acronym">HTML</abbr> format.  Additional, useful documentation is in
+<abbr class="acronym">PDF</abbr> format.  See the <cite class="cite">groff<span class="r">(1)</span></cite> man page, section
+&ldquo;Installation Directories&rdquo;, for their location.
+</p>
+<ul class="itemize mark-bullet">
+<li><samp class="file">toc.html</samp>
+Entry point to the full mom manual.
+
+</li><li><samp class="file">macrolist.html</samp>
+Hyperlinked index of macros with brief descriptions, arranged by
+category.
+
+</li><li><samp class="file">mom-pdf.pdf</samp>
+<abbr class="acronym">PDF</abbr> features and usage.
+</li></ul>
+
+<p>The mom macros are in active development between <code class="code">groff</code> releases.
+The most recent version, along with up-to-date documentation, is
+available at <a class="uref" href="http://www.schaffter.ca/mom/mom-05.html">http://www.schaffter.ca/mom/mom-05.html</a>.
+</p>
+<p>The <cite class="cite">groff_mom<span class="r">(7)</span></cite> man page (type &lsquo;<samp class="samp">man groff_mom</samp>&rsquo; at
+the command line) contains a partial list of available macros, however
+their usage is best understood by consulting the <abbr class="acronym">HTML</abbr>
+documentation.
+</p>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="ms">
+<div class="nav-panel">
+<p>
+Previous: <a href="#mom" accesskey="p" rel="prev"><samp class="file">mom</samp></a>, Up: <a href="#Major-Macro-Packages" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="ms-1">4.6 <samp class="file">ms</samp></h3>
+<a class="index-entry-id" id="index-ms-macros"></a>
+
+<p>The <samp class="file">ms</samp> (&ldquo;manuscript&rdquo;) package is suitable for the preparation
+of letters, memoranda, reports, and books.  These <code class="code">groff</code>
+macros feature cover page and table of contents generation,
+automatically numbered headings, several paragraph styles, a variety of
+text styling options, footnotes, and multi-column page layouts.
+<samp class="file">ms</samp> supports the <code class="command">tbl</code>, <code class="command">eqn</code>, <code class="command">pic</code>, and
+<code class="command">refer</code> preprocessors for inclusion of tables, mathematical
+equations, diagrams, and standardized bibliographic citations.  This
+implementation is mostly compatible with the documented interface and
+behavior of AT&amp;T Unix Version&nbsp;7 <samp class="file">ms</samp>.  Many extensions from
+4.2BSD (Berkeley)
+and Tenth Edition Research Unix have been recreated.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#ms-Introduction" accesskey="1">Introduction</a></li>
+<li><a href="#ms-Document-Structure" accesskey="2">Document Structure</a></li>
+<li><a href="#ms-Document-Control-Settings" accesskey="3">Document Control Settings</a></li>
+<li><a href="#ms-Document-Description-Macros" accesskey="4">Document Description Macros</a></li>
+<li><a href="#ms-Body-Text" accesskey="5">Body Text</a></li>
+<li><a href="#ms-Page-Layout" accesskey="6">Page layout</a></li>
+<li><a href="#Differences-from-AT_0026T-ms" accesskey="7">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a></li>
+<li><a href="#ms-Legacy-Features" accesskey="8">Legacy Features</a></li>
+<li><a href="#ms-Naming-Conventions" accesskey="9">Naming Conventions</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="ms-Introduction">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Document-Structure" accesskey="n" rel="next">Document Structure</a>, Previous: <a href="#ms" accesskey="p" rel="prev"><samp class="file">ms</samp></a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Introduction-2">4.6.1 Introduction</h4>
+
+<p>The <samp class="file">ms</samp> macros are the oldest surviving package for <code class="code">roff</code>
+systems.<a class="footnote" id="DOCF7" href="#FOOT7"><sup>7</sup></a>  While the <samp class="file">man</samp>
+package was designed for brief reference documents, the <samp class="file">ms</samp> macros
+are also suitable for longer works intended for printing and possible
+publication.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#ms-basic-information" accesskey="1">Basic information</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="ms-basic-information">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Document-Structure" accesskey="n" rel="next">Document Structure</a>, Previous: <a href="#ms-Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#ms-Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Basic-information">4.6.1.1 Basic information</h4>
+
+<p><samp class="file">ms</samp> documents are plain text files; prepare them with your
+preferred text editor.  If you&rsquo;re in a hurry to start, know that
+<samp class="file">ms</samp> needs one of its macros called at the beginning of a document
+so that it can initialize.  A <em class="dfn">macro</em> is a formatting instruction to
+<samp class="file">ms</samp>.  Put a macro call on a line by itself.  Use &lsquo;<samp class="samp">.PP</samp>&rsquo; if you
+want your paragraph&rsquo;s first line to be indented, or &lsquo;<samp class="samp">.LP</samp>&rsquo; if you
+don&rsquo;t.
+</p>
+<p>After that, start typing normally.  It is a good practice to start each
+sentence on a new line, or to put two spaces after sentence-ending
+punctuation, so that the formatter knows where the sentence boundaries
+are.  You can separate paragraphs with further paragraphing macros, or
+with blank lines, and you can indent with tabs.  When you need one of
+the features mentioned earlier (see <a class="pxref" href="#ms"><samp class="file">ms</samp></a>), return to this part of the
+manual.
+</p>
+<p>Format the document with the <code class="command">groff</code> command.  <code class="command">nroff</code>
+can be useful for previewing.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">$ editor radical.ms
+$ nroff -ww -z -ms radical.ms # check for errors
+$ nroff -ms radical.ms | less -R
+$ groff -T ps -ms radical.ms &gt; radical.ps
+$ see radical.ps
+</pre></div>
+</td></tr></table>
+
+<p>Our <samp class="file">radical.ms</samp> document might look like this.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.LP
+Radical novelties are so disturbing that they tend to be
+suppressed or ignored, to the extent that even the
+possibility of their existence in general is more often
+denied than admitted.
+
+&rarr;That's what Dijkstra said, anyway.
+</pre></div>
+</td></tr></table>
+
+<p><samp class="file">ms</samp> exposes many aspects of document layout to user control via
+<code class="code">groff</code>&rsquo;s <em class="dfn">registers</em> and <em class="dfn">strings</em>, which store numbers
+and text, respectively.  Measurements in <code class="code">groff</code> are expressed with
+a suffix called a <em class="dfn">scaling unit</em>.
+</p>
+<dl class="table">
+<dt><code class="code">i</code></dt>
+<dd><p>inches
+</p>
+</dd>
+<dt><code class="code">c</code></dt>
+<dd><p>centimeters
+</p>
+</dd>
+<dt><code class="code">p</code></dt>
+<dd><p>points (1/72 inch)
+</p>
+</dd>
+<dt><code class="code">P</code></dt>
+<dd><p>picas (1/6 inch)
+</p>
+</dd>
+<dt><code class="code">v</code></dt>
+<dd><p>vees; current vertical spacing
+</p>
+</dd>
+<dt><code class="code">m</code></dt>
+<dd><p>ems; width of an &ldquo;M&rdquo; in the current font
+</p>
+</dd>
+<dt><code class="code">n</code></dt>
+<dd><p>ens; one-half em
+</p></dd>
+</dl>
+
+<p>Set registers with the <code class="code">nr</code> request and strings with the <code class="code">ds</code>
+request.  <em class="dfn">Requests</em> are like macro calls; they go on lines by
+themselves and start with the <em class="dfn">control character</em>, a dot (<code class="code">.</code>).
+The difference is that they directly instruct the formatter program,
+rather than the macro package.  We&rsquo;ll discuss a few as applicable.  It
+is wise to specify a scaling unit when setting any register that
+represents a length, size, or distance.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PS 10.5p \&quot; Use 10.5-point type.
+.ds FAM P    \&quot; Use Palatino font family.
+</pre></div>
+</td></tr></table>
+
+<p>In the foregoing, we see that <code class="code">\&quot;</code> begins a comment.  This is an
+example of an <em class="dfn">escape sequence</em>, the other kind of formatting
+instruction.  Escape sequences can appear anywhere.  They begin with the
+escape character (<code class="code">\</code>) and are followed by at least one more
+character.  <samp class="file">ms</samp> documents
+tend to use only a few of <code class="code">groff</code>&rsquo;s many requests and escape
+sequences; see <a class="ref" href="#Request-Index">Request Index</a> and <a class="ref" href="#Escape-Sequence-Index">Escape Sequence Index</a> or
+the <cite class="cite">groff<span class="r">(7)</span></cite> man page for complete lists.
+</p>
+<dl class="table">
+<dt><code class="code">\&quot;</code></dt>
+<dd><p>Begin comment; ignore remainder of line.
+</p>
+</dd>
+<dt><code class="code">\n<var class="var">reg</var></code></dt>
+<dd><p>Interpolate value of register <var class="var">reg</var>.
+</p>
+</dd>
+<dt><code class="code">\*<var class="var">str</var></code></dt>
+<dd><p>Interpolate contents of string <var class="var">str</var>.
+</p>
+</dd>
+<dt><code class="code">\*<var class="var">s</var></code></dt>
+<dd><p>abbreviation of <code class="code">\*<var class="var">s</var></code>; the name <var class="var">s</var> must be only one
+character
+</p>
+</dd>
+<dt><code class="code">\<var class="var">char</var></code></dt>
+<dd><p>Interpolate glyph of special character named <var class="var">char</var>.
+</p>
+</dd>
+<dt><code class="code">\&amp;</code></dt>
+<dd><p>dummy character
+</p>
+</dd>
+<dt><code class="code">\~</code></dt>
+<dd><p>Insert an unbreakable space that is adjustable like a normal space.
+</p>
+</dd>
+<dt><code class="code">\|</code></dt>
+<dd><p>Move horizontally by one-sixth em (&ldquo;thin space&rdquo;).
+</p></dd>
+</dl>
+
+<p>Prefix any words that start with a dot &lsquo;<samp class="samp">.</samp>&rsquo; or neutral apostrophe
+&lsquo;<samp class="samp">'</samp>&rsquo; with <code class="code">\&amp;</code> if they are at the beginning of an input line
+(or might become that way in editing) to prevent them from being
+interpreted as macro calls or requests.  Suffix &lsquo;<samp class="samp">.</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;, and
+&lsquo;<samp class="samp">!</samp>&rsquo; with <code class="code">\&amp;</code> when needed to cancel end-of-sentence detection.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">My exposure was \&amp;.5 to \&amp;.6 Sv of neutrons, said Dr.\&amp;
+Wallace after the criticality incident.
+</pre></div>
+</td></tr></table>
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="ms-Document-Structure">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Document-Control-Settings" accesskey="n" rel="next">Document Control Settings</a>, Previous: <a href="#ms-Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Document-Structure">4.6.2 Document Structure</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-general-structure"></a>
+
+<p>The <samp class="file">ms</samp> macro package expects a certain amount of structure:
+a well-formed document contains at least one paragraphing or heading
+macro call.  Longer documents have a structure as follows.
+</p>
+<dl class="table">
+<dt><strong class="strong">Document type</strong></dt>
+<dd><p>Calling the <code class="code">RP</code> macro at the beginning of your document puts the
+document description (see below) on a cover page.  Otherwise, <samp class="file">ms</samp>
+places the information (if any) on the first page, followed immediately
+by the body text.  Some document types found in other <samp class="file">ms</samp>
+implementations are specific to <abbr class="acronym">AT&amp;T</abbr> or Berkeley, and are not
+supported by <code class="code">groff</code> <samp class="file">ms</samp>.
+</p>
+</dd>
+<dt><strong class="strong">Format and layout</strong></dt>
+<dd><p>By setting registers and strings, you can configure your document&rsquo;s
+typeface, margins, spacing, headers and footers, and footnote
+arrangement.  See <a class="xref" href="#ms-Document-Control-Settings">Document Control Settings</a>.
+</p>
+</dd>
+<dt><strong class="strong">Document description</strong></dt>
+<dd><p>A document description consists of any of: a title, one or more authors&rsquo;
+names and affiliated institutions, an abstract, and a date or other
+identifier.  See <a class="xref" href="#ms-Document-Description-Macros">Document Description Macros</a>.
+</p>
+</dd>
+<dt><strong class="strong">Body text</strong></dt>
+<dd><p>The main matter of your document follows its description (if any).
+<samp class="file">ms</samp> supports highly structured text consisting of paragraphs
+interspersed with multi-level headings (chapters, sections, subsections,
+and so forth) and augmented by lists, footnotes, tables, diagrams, and
+similar material.  See <a class="xref" href="#ms-Body-Text">Body Text</a>.
+</p>
+</dd>
+<dt><strong class="strong">Tables of contents</strong></dt>
+<dd><p>Macros enable the collection of entries for a table of contents (or
+index) as the material they discuss appears in the document.  You then
+call a macro to emit the table of contents at the end of your document.
+The table of contents must necessarily follow the rest of the text since
+GNU <code class="code">troff</code> is a single-pass formatter; it thus cannot determine
+the page number of a division of the text until it has been set and
+output.  Since <samp class="file">ms</samp> was designed for the production of hard copy,
+the traditional procedure was to manually relocate the pages containing
+the table of contents between the cover page and the body text.  Today,
+page resequencing is more often done in the digital domain.  An index
+works similarly, but because it typically needs to be sorted after
+collection, its preparation requires separate processing.
+</p></dd>
+</dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="ms-Document-Control-Settings">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Document-Description-Macros" accesskey="n" rel="next">Document Description Macros</a>, Previous: <a href="#ms-Document-Structure" accesskey="p" rel="prev">Document Structure</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Document-Control-Settings">4.6.3 Document Control Settings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-document-control-settings"></a>
+
+<p><samp class="file">ms</samp> exposes many aspects of document layout to user control via
+<code class="code">groff</code> requests.  To use them, you must understand how to define
+registers and strings.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">reg value</var><a class="copiable-link" href='#index-_002enr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr"></a>
+<p>Set register <var class="var">reg</var> to <var class="var">value</var>.  If <var class="var">reg</var> doesn&rsquo;t exist, GNU
+<code class="code">troff</code> creates it.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eds"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds</code></strong> <var class="def-var-arguments">name contents</var><a class="copiable-link" href='#index-_002eds'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds"></a>
+<p>Set string <var class="var">name</var> to <var class="var">contents</var>.
+</p></dd></dl>
+
+<p>A list of document control registers and strings follows.  For any
+parameter whose default is unsatisfactory, define its register or string
+before calling any <samp class="file">ms</samp> macro other than <code class="code">RP</code>.
+</p>
+<ul class="mini-toc">
+<li><a href="#Margin-settings" accesskey="1">Margin settings</a></li>
+<li><a href="#Titles-_0028headers_002c-footers_0029" accesskey="2">Titles (headers, footers)</a></li>
+<li><a href="#Text-settings" accesskey="3">Text settings</a></li>
+<li><a href="#Paragraph-settings" accesskey="4">Paragraph settings</a></li>
+<li><a href="#Heading-settings" accesskey="5">Heading settings</a></li>
+<li><a href="#Footnote-settings" accesskey="6">Footnote settings</a></li>
+<li><a href="#Display-settings" accesskey="7">Display settings</a></li>
+<li><a href="#Other-settings" accesskey="8">Other settings</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="Margin-settings">
+<h4 class="unnumberedsubsubsec">Margin settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPO_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPO</code></strong><a class="copiable-link" href='#index-_005cn_005bPO_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PO-_005bms_005d"></a>
+<p>Defines the page offset (i.e., the left margin).
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: Varies by output device and paper format; 1<span class="dmn">i</span> is used for
+typesetters using U.S. letter paper, and zero for terminals.
+See <a class="xref" href="#Paper-Format">Paper Format</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bLL_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nLL</code></strong><a class="copiable-link" href='#index-_005cn_005bLL_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LL-_005bms_005d"></a>
+<p>Defines the line length (i.e., the width of the body text).
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: Varies by output device and paper format; 6.5<span class="dmn">i</span> is used
+for typesetters using U.S. letter paper (see <a class="pxref" href="#Paper-Format">Paper Format</a>) and
+65<span class="dmn">n</span> on terminals.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bLT_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nLT</code></strong><a class="copiable-link" href='#index-_005cn_005bLT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LT-_005bms_005d"></a>
+<p>Defines the title line length (i.e., the header and footer width).  This
+is usually the same as <code class="code">LL</code>, but need not be.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: Varies by output device and paper format; 6.5<span class="dmn">i</span> is used
+for typesetters using U.S. letter paper (see <a class="pxref" href="#Paper-Format">Paper Format</a>) and
+65<span class="dmn">n</span> on terminals.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHM</code></strong><a class="copiable-link" href='#index-_005cn_005bHM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HM-_005bms_005d"></a>
+<p>Defines the header margin height at the top of the page.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 1<span class="dmn">i</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFM</code></strong><a class="copiable-link" href='#index-_005cn_005bFM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FM-_005bms_005d"></a>
+<p>Defines the footer margin height at the bottom of the page.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 1<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Titles-_0028headers_002c-footers_0029">
+<h4 class="unnumberedsubsubsec">Titles (headers, footers)</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bLH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*LH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bLH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LH-_005bms_005d"></a>
+<p>Defines the text displayed in the left header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bCH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*CH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bCH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CH-_005bms_005d"></a>
+<p>Defines the text displayed in the center header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: &lsquo;<samp class="samp">-\n%-</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bRH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*RH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bRH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RH-_005bms_005d"></a>
+<p>Defines the text displayed in the right header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bLF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*LF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bLF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LF-_005bms_005d"></a>
+<p>Defines the text displayed in the left footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bCF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*CF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bCF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CF-_005bms_005d"></a>
+<p>Defines the text displayed in the center footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bRF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*RF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bRF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RF-_005bms_005d"></a>
+<p>Defines the text displayed in the right footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Text-settings">
+<h4 class="unnumberedsubsubsec">Text settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPS</code></strong><a class="copiable-link" href='#index-_005cn_005bPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PS-_005bms_005d-1"></a>
+<p>Defines the type size of the body text.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 10<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bVS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nVS</code></strong><a class="copiable-link" href='#index-_005cn_005bVS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VS-_005bms_005d"></a>
+<p>Defines the vertical spacing (type size plus leading).
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 12<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHY_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHY</code></strong><a class="copiable-link" href='#index-_005cn_005bHY_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HY-_005bms_005d"></a>
+<p>Defines the automatic hyphenation mode used with the <code class="code">hy</code> request.
+Setting <code class="code">HY</code> to&nbsp;0 is equivalent to using the <code class="code">nh</code>
+request.  This is a Tenth Edition Research Unix extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 6.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bFAM_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*FAM</code></strong><a class="copiable-link" href='#index-_005c_002a_005bFAM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FAM-_005bms_005d"></a>
+<p>Defines the font family used to typeset the document.  This is a GNU
+extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: defined by the output device; often &lsquo;<samp class="samp">T</samp>&rsquo; (see <a class="pxref" href="#ms-Body-Text">Body Text</a>)
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Paragraph-settings">
+<h4 class="unnumberedsubsubsec">Paragraph settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPI</code></strong><a class="copiable-link" href='#index-_005cn_005bPI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PI-_005bms_005d"></a>
+<p>Defines the indentation amount used by the <code class="code">PP</code>, <code class="code">IP</code> (unless
+overridden by an optional argument), <code class="code">XP</code>, and <code class="code">RS</code> macros.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 5<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPD</code></strong><a class="copiable-link" href='#index-_005cn_005bPD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PD-_005bms_005d"></a>
+<p>Defines the space between paragraphs.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 0.3<span class="dmn">v</span> (1<span class="dmn">v</span> on low-resolution devices).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bQI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nQI</code></strong><a class="copiable-link" href='#index-_005cn_005bQI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QI-_005bms_005d"></a>
+<p>Defines the indentation amount used on both sides of a paragraph set
+with the <code class="code">QP</code> or between the <code class="code">QS</code> and <code class="code">QE</code> macros.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 5<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPORPHANS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPORPHANS</code></strong><a class="copiable-link" href='#index-_005cn_005bPORPHANS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PORPHANS-_005bms_005d"></a>
+<p>Defines the minimum number of initial lines of any paragraph that must
+be kept together to avoid isolated lines at the bottom of a page.  If a
+new paragraph is started close to the bottom of a page, and there is
+insufficient space to accommodate <code class="code">PORPHANS</code> lines before an
+automatic page break, then a page break is forced before the start of
+the paragraph.  This is a GNU extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 1.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Heading-settings">
+<h4 class="unnumberedsubsubsec">Heading settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPSINCR_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPSINCR</code></strong><a class="copiable-link" href='#index-_005cn_005bPSINCR_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PSINCR-_005bms_005d"></a>
+<p>Defines an increment in type size to be applied to a heading at a
+lesser depth than that specified in <code class="code">GROWPS</code>.  The value of
+<code class="code">PSINCR</code> should be specified in points with the <span class="dmn">p</span> scaling
+unit and may include a fractional component; for example, &lsquo;<samp class="samp">.nr&nbsp;PSINCR&nbsp;1.5p</samp>&rsquo; sets a type size increment of 1.5<span class="dmn">p</span>.  This is a GNU
+extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: 1<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bGROWPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nGROWPS</code></strong><a class="copiable-link" href='#index-_005cn_005bGROWPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GROWPS-_005bms_005d"></a>
+<p>Defines the heading depth above which the type size increment set by
+<code class="code">PSINCR</code> becomes effective.  For each heading depth less than the
+value of <code class="code">GROWPS</code>, the type size is increased by <code class="code">PSINCR</code>.
+Setting <code class="code">GROWPS</code> to any value less than&nbsp;2 disables the
+incremental heading size feature.  This is a GNU extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: 0.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHORPHANS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHORPHANS</code></strong><a class="copiable-link" href='#index-_005cn_005bHORPHANS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HORPHANS-_005bms_005d"></a>
+<p>Defines the minimum number of lines of an immediately succeeding
+paragraph that should be kept together with any heading introduced by
+the <code class="code">NH</code> or <code class="code">SH</code> macros.  If a heading is placed close to the
+bottom of a page, and there is insufficient space to accommodate both
+the heading and at least <code class="code">HORPHANS</code> lines of the following
+paragraph, before an automatic page break, then the page break is forced
+before the heading.  This is a GNU extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 1.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bSN_002dSTYLE_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-STYLE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dSTYLE_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dSTYLE-_005bms_005d"></a>
+<p>Defines the style used to print numbered headings.  See <a class="xref" href="#Headings-in-ms">Headings</a>.  This is a GNU extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: alias of <code class="code">SN-DOT</code>
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Footnote-settings">
+<h4 class="unnumberedsubsubsec">Footnote settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFI</code></strong><a class="copiable-link" href='#index-_005cn_005bFI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FI-_005bms_005d"></a>
+<p>Defines the footnote indentation.  This is a Berkeley extension.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: 2<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFF_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFF</code></strong><a class="copiable-link" href='#index-_005cn_005bFF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FF-_005bms_005d"></a>
+<p>Defines the format of automatically numbered footnotes,
+and those for which the <code class="code">FS</code> request is given a marker argument, at
+the bottom of a column or page.  This is a Berkeley extension.
+</p><dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>Set an automatic number<a class="footnote" id="DOCF8" href="#FOOT8"><sup>8</sup></a> as a
+superscript (on typesetter devices) or surrounded by square brackets (on
+terminals).  The footnote paragraph is indented as with <code class="code">PP</code> if
+there is an <code class="code">FS</code> argument or an automatic number, and as with
+<code class="code">LP</code> otherwise.  This is the default.
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>As <code class="code">0</code>, but set the marker as regular text and follow an
+automatic number with a period.
+</p>
+</dd>
+<dt><code class="code">2</code></dt>
+<dd><p>As <code class="code">1</code>, but without indentation (like <code class="code">LP</code>).
+</p>
+</dd>
+<dt><code class="code">3</code></dt>
+<dd><p>As <code class="code">1</code>, but set the footnote paragraph with the marker hanging
+(like <code class="code">IP</code>).
+</p></dd>
+</dl>
+
+<p>Effective: next footnote.
+</p>
+<p>Default: 0.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFPS</code></strong><a class="copiable-link" href='#index-_005cn_005bFPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FPS-_005bms_005d"></a>
+<p>Defines the footnote type size.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nPS - 2p</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFVS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFVS</code></strong><a class="copiable-link" href='#index-_005cn_005bFVS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FVS-_005bms_005d"></a>
+<p>Defines the footnote vertical spacing.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nFPS + 2p</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFPD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFPD</code></strong><a class="copiable-link" href='#index-_005cn_005bFPD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FPD-_005bms_005d"></a>
+<p>Defines the footnote paragraph spacing.  This is a GNU extension.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nPD / 2</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bFR_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*FR</code></strong><a class="copiable-link" href='#index-_005c_002a_005bFR_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FR-_005bms_005d"></a>
+<p>Defines the ratio of the footnote line length to the current line
+length.  This is a GNU extension.
+</p>
+<p>Effective: next footnote in single-column arrangements, next page
+otherwise.
+</p>
+<p>Default: <code class="code">11/12</code>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Display-settings">
+<h4 class="unnumberedsubsubsec">Display settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bDD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nDD</code></strong><a class="copiable-link" href='#index-_005cn_005bDD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DD-_005bms_005d"></a>
+<p>Sets the display distance&mdash;the vertical spacing before and after a
+display, a <code class="code">tbl</code> table, an <code class="code">eqn</code> equation, or a <code class="code">pic</code>
+image.  This is a Berkeley extension.
+</p>
+<p>Effective: next display boundary.
+</p>
+<p>Default: 0.5<span class="dmn">v</span> (1<span class="dmn">v</span> on low-resolution devices).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bDI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nDI</code></strong><a class="copiable-link" href='#index-_005cn_005bDI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DI-_005bms_005d"></a>
+<p>Sets the default amount by which to indent a display started with
+<code class="code">DS</code> and <code class="code">ID</code> without arguments, to &lsquo;<samp class="samp">.DS&nbsp;I</samp>&rsquo; without
+an indentation argument, and to equations set with &lsquo;<samp class="samp">.EQ&nbsp;I</samp>&rsquo;.
+This is a GNU extension.
+</p>
+<p>Effective: next indented display.
+</p>
+<p>Default: 0.5<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Other-settings">
+<h4 class="unnumberedsubsubsec">Other settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bMINGW_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nMINGW</code></strong><a class="copiable-link" href='#index-_005cn_005bMINGW_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MINGW-_005bms_005d"></a>
+<p>Defines the default minimum width between columns in a multi-column
+document.  This is a GNU extension.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 2<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bTC_002dMARGIN_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nTC-MARGIN</code></strong><a class="copiable-link" href='#index-_005cn_005bTC_002dMARGIN_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TC_002dMARGIN-_005bms_005d"></a>
+<p>Defines the width of the field in which page numbers are set in a table
+of contents entry; the right margin thus moves inboard by this amount.
+This is a GNU extension.
+</p>
+<p>Effective: next <code class="code">PX</code> call.
+</p>
+<p>Default: <code class="code">\w'000'</code>
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="ms-Document-Description-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Body-Text" accesskey="n" rel="next">Body Text</a>, Previous: <a href="#ms-Document-Control-Settings" accesskey="p" rel="prev">Document Control Settings</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Document-Description-Macros">4.6.4 Document Description Macros</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-document-description"></a>
+<a class="index-entry-id" id="index-document-description-macros_002c-_005bms_005d"></a>
+
+<p>Only the simplest document lacks a title.<a class="footnote" id="DOCF9" href="#FOOT9"><sup>9</sup></a>  As its level of sophistication (or
+complexity) increases, it tends to acquire a date of revision,
+explicitly identified authors, sponsoring institutions for authors, and,
+at the rarefied heights, an abstract of its content.  Define these
+data by calling the macros below in the order shown; <code class="code">DA</code> or
+<code class="code">ND</code> can be called to set the document date (or other identifier)
+at any time before (a) the abstract, if present, or (b) its information
+is required in a header or footer.  Use of these macros is optional,
+except that <code class="code">TL</code> is mandatory if any of <code class="code">RP</code>, <code class="code">AU</code>,
+<code class="code">AI</code>, or <code class="code">AB</code> is called, and <code class="code">AE</code> is mandatory if
+<code class="code">AB</code> is called.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RP</code></strong> <var class="def-var-arguments"><code class="code">no-repeat-info</code> <code class="code">no-renumber</code></var><a class="copiable-link" href='#index-_002eRP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RP-_005bms_005d"></a>
+<p>Use the &ldquo;report&rdquo; (<abbr class="acronym">AT&amp;T</abbr>: &ldquo;released paper&rdquo;) format for your
+document, creating a separate cover page.  The default arrangement is to
+place most of the document description (title, author names and
+institutions, and abstract, but not the date) at the top of the first
+page.  If the optional <code class="code">no-repeat-info</code> argument is given,
+<samp class="file">ms</samp> produces a cover page but does not repeat any of its
+information subsequently (but see the <code class="code">DA</code> macro below regarding
+the date).  Normally, <code class="code">RP</code> sets the page number following the cover
+page to&nbsp;1.  Specifying the optional <code class="code">no-renumber</code> argument
+suppresses this alteration.  Optional arguments can occur in any order.
+<code class="code">no</code> is recognized as a synonym of <code class="code">no-repeat-info</code> for
+<code class="code">AT&amp;T</code> compatibility.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TL</code></strong><a class="copiable-link" href='#index-_002eTL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TL-_005bms_005d"></a>
+<p>Specify the document title.  <samp class="file">ms</samp> collects text on input lines
+following this call into the title until reaching <code class="code">AU</code>, <code class="code">AB</code>,
+or a heading or paragraphing macro call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAU"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AU</code></strong><a class="copiable-link" href='#index-_002eAU'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AU-_005bms_005d"></a>
+<p>Specify an author&rsquo;s name.  <samp class="file">ms</samp> collects text on input lines
+following this call into the author&rsquo;s name until reaching <code class="code">AI</code>,
+<code class="code">AB</code>, another <code class="code">AU</code>, or a heading or paragraphing macro call.
+Call it repeatedly to specify multiple authors.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AI</code></strong><a class="copiable-link" href='#index-_002eAI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AI-_005bms_005d"></a>
+<p>Specify the preceding author&rsquo;s institution.  An <code class="code">AU</code> call is
+usefully followed by at most one <code class="code">AI</code> call; if there are more, the
+last <code class="code">AI</code> call controls.  <samp class="file">ms</samp> collects text on input lines
+following this call into the author&rsquo;s institution until reaching
+<code class="code">AU</code>, <code class="code">AB</code>, or a heading or paragraphing macro call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DA</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">x</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eDA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DA-_005bms_005d"></a>
+<p>Typeset the current date, or any arguments <var class="var">x</var>, in the center
+footer, and, if <code class="code">RP</code> is also called, left-aligned at the end of the
+description information on the cover page.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eND"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.ND</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">x</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eND'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ND-_005bms_005d"></a>
+<p>Typeset the current date, or any arguments <var class="var">x</var>, if <code class="code">RP</code> is also
+called, left-aligned at the end of the document description on the cover
+page.  This is <code class="code">groff</code> <samp class="file">ms</samp>&rsquo;s default.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AB</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002eAB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AB-_005bms_005d"></a>
+<p>Begin the abstract.  <samp class="file">ms</samp> collects text on input lines following
+this call into the abstract until reaching an <code class="code">AE</code> call.  By
+default, <samp class="file">ms</samp> places the word &ldquo;ABSTRACT&rdquo; centered and in italics
+above the text of the abstract.  The optional argument <code class="code">no</code>
+suppresses this heading.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AE</code></strong><a class="copiable-link" href='#index-_002eAE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AE-_005bms_005d"></a>
+<p>End the abstract.
+</p></dd></dl>
+
+<p>An example document description, using a cover page, follows.
+<a class="index-entry-id" id="index-cover-page-in-_005bms_005d_002c-example-markup"></a>
+<a class="index-entry-id" id="index-example-markup_002c-cover-page-in-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.RP
+.TL
+The Inevitability of Code Bloat
+in Commercial and Free Software
+.AU
+J.\&amp; Random Luser
+.AI
+University of West Bumblefuzz
+.AB
+This report examines the long-term growth of the code
+bases in two large,
+popular software packages;
+the free Emacs and the commercial Microsoft Word.
+While differences appear in the type or order of
+features added,
+due to the different methodologies used,
+the results are the same in the end.
+.PP
+The free software approach is shown to be superior in
+that while free software can become as bloated as
+commercial offerings,
+free software tends to have fewer serious bugs and the
+added features are more in line with user demand.
+.AE
+
+<span class="r">&hellip;the rest of the paper&hellip;</span>
+</pre></div>
+</td></tr></table>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="ms-Body-Text">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Page-Layout" accesskey="n" rel="next">Page layout</a>, Previous: <a href="#ms-Document-Description-Macros" accesskey="p" rel="prev">Document Description Macros</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Body-Text">4.6.5 Body Text</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-body-text"></a>
+
+<p>A variety of macros, registers, and strings can be used to structure and
+style the body of your document.  They organize your text into
+paragraphs, headings, footnotes, and inclusions of material such as
+tables and figures.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Text-settings-in-ms" accesskey="1">Text settings</a></li>
+<li><a href="#Typographical-symbols-in-ms" accesskey="2">Typographical symbols</a></li>
+<li><a href="#Paragraphs-in-ms" accesskey="3">Paragraphs</a></li>
+<li><a href="#Headings-in-ms" accesskey="4">Headings</a></li>
+<li><a href="#Typeface-and-decoration" accesskey="5">Typeface and decoration</a></li>
+<li><a href="#Lists-in-ms" accesskey="6">Lists</a></li>
+<li><a href="#Indented-regions-in-ms" accesskey="7">Indented regions</a></li>
+<li><a href="#ms-keeps-and-displays" accesskey="8">Keeps, boxed keeps, and displays</a></li>
+<li><a href="#ms-Insertions" accesskey="9">Tables, figures, equations, and references</a></li>
+<li><a href="#ms-Footnotes">Footnotes</a></li>
+<li><a href="#ms-language-and-localization">Language and localization</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="Text-settings-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#Typographical-symbols-in-ms" accesskey="n" rel="next">Typographical symbols</a>, Previous: <a href="#ms-Body-Text" accesskey="p" rel="prev">Body Text</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Text-settings-1">4.6.5.1 Text settings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-text-settings"></a>
+
+<p>The <code class="code">FAM</code> string, a GNU extension, sets the font family for body
+text; the default is &lsquo;<samp class="samp">T</samp>&rsquo;.  The <code class="code">PS</code> and <code class="code">VS</code> registers
+set the type size and vertical spacing (distance between text
+baselines), respectively.  The font family and type size are ignored on
+terminal devices.  Setting these parameters before the first call of a
+heading, paragraphing, or (non-date) document description macro also
+applies them to headers, footers, and (for <code class="code">FAM</code>) footnotes.
+</p>
+<p>Which font families are available depends on the output device; as a
+convention, <code class="code">T</code> selects a serif family (&ldquo;Times&rdquo;), <code class="code">H</code> a
+sans-serif family (&ldquo;Helvetica&rdquo;), and <code class="code">C</code> a monospaced family
+(&ldquo;Courier&rdquo;).  The man page for the output driver documents its font
+repertoire.  Consult the <cite class="cite">groff<span class="r">(1)</span></cite> man page for lists of
+available output devices and their drivers.
+</p>
+<p>The hyphenation mode (as used by the <code class="code">hy</code> request) is set from the
+<code class="code">HY</code> register.  Setting <code class="code">HY</code> to &lsquo;<samp class="samp">0</samp>&rsquo; is equivalent to
+using the <code class="code">nh</code> request.  This is a Tenth Edition Research Unix
+extension.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Typographical-symbols-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#Paragraphs-in-ms" accesskey="n" rel="next">Paragraphs</a>, Previous: <a href="#Text-settings-in-ms" accesskey="p" rel="prev">Text settings</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Typographical-symbols">4.6.5.2 Typographical symbols</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-obtaining-typographical-symbols"></a>
+
+<p><samp class="file">ms</samp> provides a few strings to obtain typographical symbols not
+easily entered with the keyboard.  These and many others are available
+as special character escape sequences&mdash;see the <cite class="cite">groff_char<span class="r">(7)</span></cite>
+man page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*-</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002d-_005bms_005d"></a>
+<p>Interpolate an em dash.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bQ_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Q</code></strong><a class="copiable-link" href='#index-_005c_002a_005bQ_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Q-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bU_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*U</code></strong><a class="copiable-link" href='#index-_005c_002a_005bU_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-U-_005bms_005d"></a>
+<p>Interpolate typographer&rsquo;s quotation marks where available, and neutral
+double quotes otherwise.  <code class="code">\*Q</code> is the left quote and <code class="code">\*U</code>
+the right.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Paragraphs-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#Headings-in-ms" accesskey="n" rel="next">Headings</a>, Previous: <a href="#Typographical-symbols-in-ms" accesskey="p" rel="prev">Typographical symbols</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Paragraphs-2">4.6.5.3 Paragraphs</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-paragraph-handling"></a>
+
+<p>Paragraphing macros <em class="dfn">break</em>, or terminate, any pending output line
+so that a new paragraph can begin.  Several paragraph types are
+available, differing in how indentation applies to them: to left, right,
+or both margins; to the first output line of the paragraph, all output
+lines, or all but the first.  All paragraphing macro calls cause the
+insertion of vertical space in the amount stored in the <code class="code">PD</code>
+register, except at page or column breaks.  Alternatively, a blank input
+line breaks the output line and vertically spaces by one vee.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eLP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LP</code></strong><a class="copiable-link" href='#index-_002eLP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LP-_005bms_005d"></a>
+<p>Set a paragraph without any (additional) indentation.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PP</code></strong><a class="copiable-link" href='#index-_002ePP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PP-_005bms_005d"></a>
+<p>Set a paragraph with a first-line left indentation in the amount stored
+in the <code class="code">PI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eIP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.IP</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">marker</i></span> <span class="r"><i class="slanted">width</i></span></var><a class="copiable-link" href='#index-_002eIP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-IP-_005bms_005d"></a>
+<p>Set a paragraph with a left indentation.  The optional <var class="var">marker</var> is
+not indented and is empty by default.  It has several applications;
+see <a class="ref" href="#Lists-in-ms">Lists</a>.  <var class="var">width</var> overrides the indentation amount
+stored in the <code class="code">PI</code> register; its default unit is &lsquo;<samp class="samp">n</samp>&rsquo;.  Once
+specified, <var class="var">width</var> applies to further <code class="code">IP</code> calls until
+specified again or a heading or different paragraphing macro is called.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eQP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QP</code></strong><a class="copiable-link" href='#index-_002eQP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QP-_005bms_005d"></a>
+<p>Set a paragraph indented from both left and right margins by the amount
+stored in the <code class="code">QI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eQS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QS</code></strong><a class="copiable-link" href='#index-_002eQS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eQE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QE</code></strong><a class="copiable-link" href='#index-_002eQE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QE-_005bms_005d"></a>
+<p>Begin (<code class="code">QS</code>) and end (<code class="code">QE</code>) a region where each paragraph is
+indented from both margins by the amount stored in the <code class="code">QI</code>
+register.  The text between <code class="code">QS</code> and <code class="code">QE</code> can be structured
+further by use of other paragraphing macros.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XP</code></strong><a class="copiable-link" href='#index-_002eXP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XP-_005bms_005d"></a>
+<p>Set an &ldquo;exdented&rdquo; paragraph&mdash;one with a left indentation in the
+amount stored in the <code class="code">PI</code> register on every line <em class="emph">except</em> the
+first (also known as a hanging indent).  This is a Berkeley extension.
+</p></dd></dl>
+
+<p>The following example illustrates the use of paragraphing macros.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 2
+Cases used in the 2001 study
+.LP
+Two software releases were considered for this report.
+.PP
+The first is commercial software;
+the second is free.
+.IP \bu
+Microsoft Word for Windows,
+starting with version 1.0 through the current version
+(Word 2000).
+.IP \bu
+GNU Emacs,
+from its first appearance as a standalone editor through
+the current version (v20).
+See Bloggs 2002 for details.
+.QP
+Franklin's Law applied to software:
+software expands to outgrow both RAM and disk space over
+time.
+.SH
+Bibliography
+.XP
+Bloggs, Joseph R.,
+.I &quot;Everyone's a Critic&quot; ,
+Underground Press, March 2002.
+A definitive work that answers all questions and
+criticisms about the quality and usability of free
+software.
+</pre></div>
+</td></tr></table>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Headings-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#Typeface-and-decoration" accesskey="n" rel="next">Typeface and decoration</a>, Previous: <a href="#Paragraphs-in-ms" accesskey="p" rel="prev">Paragraphs</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Headings">4.6.5.4 Headings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-headings"></a>
+
+<p>Use headings to create a sequential or hierarchical structure for your
+document.  The <samp class="file">ms</samp> macros print headings in <strong class="strong">bold</strong> using
+the same font family and, by default, type size as the body text.
+Headings are available with and without automatic numbering.  Text on
+input lines following the macro call becomes the heading&rsquo;s title.  Call
+a paragraphing macro to end the heading text and start the section&rsquo;s
+content.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span></var><a class="copiable-link" href='#index-_002eNH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eNH-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NH</code></strong> <var class="def-var-arguments"><code class="t">S</code> <span class="r"><i class="slanted">heading-depth-index</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eNH-1'> &para;</a></span></dt>
+<dd><p>Set an automatically numbered heading.
+</p>
+<p><samp class="file">ms</samp> produces a numbered heading the form <var class="var">a.b.c&hellip;</var>, to
+any depth desired, with the numbering of each depth increasing
+automatically and being reset to zero when a more significant level is
+increased.  &ldquo;1&rdquo;&nbsp;is the most significant or coarsest division of
+the document.  Only non-zero values are output.  If <var class="var">depth</var> is
+omitted, it is taken to be &lsquo;<samp class="samp">1</samp>&rsquo;.
+</p>
+<p>If you specify <var class="var">depth</var> such that an ascending gap occurs relative to
+the previous <code class="code">NH</code> call&mdash;that is, you &ldquo;skip a depth&rdquo;, as by
+&lsquo;<samp class="samp">.NH 1</samp>&rsquo; and then &lsquo;<samp class="samp">.NH 3</samp>&rsquo;&mdash;<code class="code">groff</code> <samp class="file">ms</samp> emits a
+warning on the standard error stream.
+</p>
+<p>Alternatively, you can give <code class="code">NH</code> a first argument of&nbsp;<code class="code">S</code>,
+followed by integers to number the heading depths explicitly.  Further
+automatic numbering, if used, resumes using the specified indices as
+their predecessors.
+This feature is a Berkeley extension.
+</p></dd></dl>
+
+<p>An example may be illustrative.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+Animalia
+.NH 2
+Arthropoda
+.NH 3
+Crustacea
+.NH 2
+Chordata
+.NH S 6 6 6
+Daimonia
+.NH 1
+Plantae
+</pre></div>
+</td></tr></table>
+
+<p>The above results in numbering as follows; the vertical space that
+normally precedes each heading is omitted.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">1.  Animalia
+1.1.  Arthropoda
+1.1.1.  Crustacea
+1.2.  Chordata
+6.6.6.  Daimonia
+7.  Plantae
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bSN_002dSTYLE_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-STYLE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dSTYLE_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dSTYLE-_005bms_005d-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_002dDOT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-DOT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dDOT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dDOT-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_002dNO_002dDOT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-NO-DOT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dNO_002dDOT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dNO_002dDOT-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN-_005bms_005d"></a>
+<p>After <code class="code">NH</code> is called, the assigned number is made available in the
+strings <code class="code">SN-DOT</code> (as it appears in a printed heading with default
+formatting, followed by a terminating period) and <code class="code">SN-NO-DOT</code> (with
+the terminating period omitted).  These are GNU extensions.
+</p>
+<p>You can control the style used to print numbered headings by defining an
+appropriate alias for the string <code class="code">SN-STYLE</code>.  By default,
+<code class="code">SN-STYLE</code> is aliased to <code class="code">SN-DOT</code>.  If you prefer to omit the
+terminating period from numbers appearing in numbered headings, you may
+define the alias as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als SN-STYLE SN-NO-DOT
+</pre></div></div>
+
+<p>Any such change in numbering style becomes effective from the next use
+of <code class="code">NH</code> following redefinition of the alias for <code class="code">SN-STYLE</code>.
+The formatted number of the current heading is available in the
+<code class="code">SN</code> string (a feature first documented by Berkeley), which
+facilitates its inclusion in, for example, table captions, equation
+labels, and <code class="code">XS</code>/<code class="code">XA</code>/<code class="code">XE</code> table of contents entries.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eSH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.SH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span></var><a class="copiable-link" href='#index-_002eSH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SH-_005bms_005d"></a>
+<p>Set an unnumbered heading.
+</p>
+<p>The optional <var class="var">depth</var> argument is a GNU extension indicating the
+heading depth corresponding to the <var class="var">depth</var> argument of <code class="code">NH</code>.
+It matches the type size at which the heading is set to that of a
+numbered heading at the same depth when the <code class="code">GROWPS</code> and
+<code class="code">PSINCR</code> heading size adjustment mechanism is in effect.
+</p></dd></dl>
+
+<p>If the <code class="code">GROWPS</code> register is set to a value greater than the
+<var class="var">level</var> argument to <code class="code">NH</code> or <code class="code">SH</code>, the type size of a
+heading produced by these macros increases by <code class="code">PSINCR</code> units over
+the size specified by <code class="code">PS</code> multiplied by the difference of
+<code class="code">GROWPS</code> and <var class="var">level</var>.  The value stored in <code class="code">PSINCR</code> is
+interpreted in <code class="code">groff</code> basic units; the <code class="code">p</code> scaling unit
+should be employed when assigning a value specified in points.  For
+example, the sequence
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PS 10
+.nr GROWPS 3
+.nr PSINCR 1.5p
+.NH 1
+Carnivora
+.NH 2
+Felinae
+.NH 3
+Felis catus
+.SH 2
+Machairodontinae
+</pre></div>
+</td></tr></table>
+
+<p>will cause &ldquo;1. Carnivora&rdquo; to be printed in 13-point text, followed by
+&ldquo;1.1. Felinae&rdquo; in 11.5-point text, while &ldquo;1.1.1. Felis catus&rdquo; and
+all more deeply nested heading levels will remain in the 10-point text
+specified by the <code class="code">PS</code> register.  &ldquo;Machairodontinae&rdquo; is printed at
+11.5 points, since it corresponds to heading level&nbsp;2.
+</p>
+<p>The <code class="code">HORPHANS</code> register operates in conjunction with the <code class="code">NH</code>
+and <code class="code">SH</code> macros to inhibit the printing of isolated headings at the
+bottom of a page; it specifies the minimum number of lines of an
+immediately subsequent paragraph that must be kept on the same page as
+the heading.  If insufficient space remains on the current page to
+accommodate the heading and this number of lines of paragraph text, a
+page break is forced before the heading is printed.  Any display macro
+call or <code class="code">tbl</code>, <code class="code">pic</code>, or <code class="code">eqn</code> region between the heading
+and the subsequent paragraph suppresses this grouping.  See <a class="xref" href="#ms-keeps-and-displays">Keeps, boxed keeps, and displays</a> and <a class="ref" href="#ms-Insertions">Tables, figures, equations, and references</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Typeface-and-decoration">
+<div class="nav-panel">
+<p>
+Next: <a href="#Lists-in-ms" accesskey="n" rel="next">Lists</a>, Previous: <a href="#Headings-in-ms" accesskey="p" rel="prev">Headings</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Typeface-and-decoration-1">4.6.5.5 Typeface and decoration</h4>
+
+<p>The <samp class="file">ms</samp> macros provide a variety of ways to style text.
+Attend closely to the ordering of arguments labeled <var class="var">pre</var> and
+<var class="var">post</var>, which is not intuitive.  Support for <var class="var">pre</var>
+arguments is a GNU extension.<a class="footnote" id="DOCF10" href="#FOOT10"><sup>10</sup></a>
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B-_005bms_005d"></a>
+<p>Style <var class="var">text</var> in <b class="b">bold</b>, followed by <var class="var">post</var> in the previous
+font style without intervening space, and preceded by <var class="var">pre</var>
+similarly.  Without arguments, <samp class="file">ms</samp> styles subsequent text in bold
+until the next paragraphing, heading, or no-argument typeface macro
+call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eR-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.R</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eR-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-R-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use the roman style (upright text of normal weight)
+instead of bold.  Argument recognition is a GNU extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.I</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-I-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use an <i class="i">italic</i> or oblique style instead of bold.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BI</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eBI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BI-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use a bold italic or bold oblique style instead of
+upright bold.  This is a Tenth Edition Research Unix extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCW-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CW</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eCW-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CW-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use a <code class="t">constant-width</code> (monospaced) roman typeface
+instead of bold.  This is a Tenth Edition Research Unix extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BX</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eBX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BX-_005bms_005d"></a>
+<p>Typeset <var class="var">text</var> and draw a box around it.  On terminal devices,
+reverse video is used instead.  If you want <var class="var">text</var> to contain space,
+use unbreakable space or horizontal motion escape sequences (<code class="code">\~</code>,
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\^</code>, <code class="code">\|</code>, <code class="code">\0</code> or <code class="code">\h</code>).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eUL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.UL</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span></var><a class="copiable-link" href='#index-_002eUL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-UL-_005bms_005d"></a>
+<p>Typeset <var class="var">text</var> with an underline.  <var class="var">post</var>, if present, is set
+after <var class="var">text</var> with no intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eLG"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LG</code></strong><a class="copiable-link" href='#index-_002eLG'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LG-_005bms_005d"></a>
+<p>Set subsequent text in larger type (two points larger than the
+current size) until the next type size, paragraphing, or heading macro
+call.  You can specify this macro multiple times to enlarge the type
+size as needed.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eSM"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.SM</code></strong><a class="copiable-link" href='#index-_002eSM'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SM-_005bms_005d"></a>
+<p>Set subsequent text in smaller type (two points smaller than the current
+size) until the next type size, paragraphing, or heading macro call.
+You can specify this macro multiple times to reduce the type size as
+needed.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NL</code></strong><a class="copiable-link" href='#index-_002eNL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NL-_005bms_005d"></a>
+<p>Set subsequent text at the normal type size (the amount in the <code class="code">PS</code>
+register).
+</p></dd></dl>
+
+<p><var class="var">pre</var> and <var class="var">post</var> arguments are typically used to simplify the
+attachment of punctuation to styled words.  When <var class="var">pre</var> is used,
+a hyphenation control escape sequence <code class="code">\%</code> that would ordinarily
+start <var class="var">text</var> must start <var class="var">pre</var> instead to have the desired
+effect.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">The CS course's students found one C language keyword
+.CW static ) \%(
+most troublesome.
+</pre></div>
+</td></tr></table>
+
+<p>The foregoing example produces output as follows.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted"><span class="r">The CS course&rsquo;s students found one C language keyword (<code class="t">static</code>)
+most troublesome.</span>
+</pre></div>
+</td></tr></table>
+
+<p>You can use the output line continuation escape sequence <code class="code">\c</code> to
+achieve the same result (see <a class="pxref" href="#Line-Continuation">Line Continuation</a>).  It is also
+portable to older <samp class="file">ms</samp> implementations.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">The CS course's students found one C language keyword
+\%(\c
+.CW \%static )
+most troublesome.
+</pre></div>
+</td></tr></table>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> also offers strings to begin and end super- and
+subscripting.  These are GNU extensions.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007b_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*{</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007b_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007b-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005b_007d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*}</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007d-_005bms_005d"></a>
+<p>Begin and end superscripting, respectively.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003c_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*&lt;</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003c_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003c-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005b_003e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*&gt;</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003e-_005bms_005d"></a>
+<p>Begin and end subscripting, respectively.
+</p></dd></dl>
+
+<p>Rather than calling the <code class="code">CW</code> macro, in <code class="code">groff</code> <samp class="file">ms</samp> you
+might prefer to change the font family to Courier by setting the
+<code class="code">FAM</code> string to &lsquo;<samp class="samp">C</samp>&rsquo;.  You can then use all four style macros
+above, returning to the default family (Times) with &lsquo;<samp class="samp">.ds FAM T</samp>&rsquo;.
+Because changes to <code class="code">FAM</code> take effect only at the next paragraph,
+<code class="code">CW</code> remains useful to &ldquo;inline&rdquo; a change to the font family,
+similarly to the practice of this document in noting syntactical
+elements of <samp class="file">ms</samp> and <code class="code">groff</code>.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Lists-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#Indented-regions-in-ms" accesskey="n" rel="next">Indented regions</a>, Previous: <a href="#Typeface-and-decoration" accesskey="p" rel="prev">Typeface and decoration</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Lists">4.6.5.6 Lists</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-lists"></a>
+
+<p>The <var class="var">marker</var> argument to the <code class="code">IP</code> macro can be employed to
+present a variety of lists; for instance, you can use a bullet glyph
+(<code class="code">\bu</code>) for unordered lists, a number (or auto-incrementing
+register) for numbered lists, or a word or phrase for glossary-style or
+definition lists.  If you set the paragraph indentation register
+<code class="code">PI</code> before calling <code class="code">IP</code>, you can later reorder the items in
+the list without having to ensure that a <var class="var">width</var> argument remains
+affixed to the first call.
+</p>
+<p>The following is an example of a bulleted list.
+<a class="index-entry-id" id="index-example-markup_002c-bulleted-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-bulleted-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PI 2n
+A bulleted list:
+.IP \bu
+lawyers
+.IP \bu
+guns
+.IP \bu
+money
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A bulleted list:
+
+&bull; lawyers
+
+&bull; guns
+
+&bull; money
+</pre></div></div>
+
+<p>The following is an example of a numbered list.
+<a class="index-entry-id" id="index-example-markup_002c-numbered-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-numbered-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr step 0 1
+.nr PI 3n
+A numbered list:
+.IP \n+step
+lawyers
+.IP \n+step
+guns
+.IP \n+step
+money
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A numbered list:
+
+1. lawyers
+
+2. guns
+
+3. money
+</pre></div></div>
+
+<p>Here we have employed the <code class="code">nr</code> request to create a register of our
+own, &lsquo;<samp class="samp">step</samp>&rsquo;.  We initialized it to zero and assigned it an
+auto-increment of 1.  Each time we use the escape sequence
+&lsquo;<samp class="samp">\n+PI</samp>&rsquo; (note the plus sign), the formatter applies the increment
+just before interpolating the register&rsquo;s value.  Preparing the <code class="code">PI</code>
+register as well enables us to rearrange the list without the tedium of
+updating macro calls.
+</p>
+<p>The next example illustrates a glossary-style list.
+<a class="index-entry-id" id="index-example-markup_002c-glossary_002dstyle-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-glossary_002dstyle-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">A glossary-style list:
+.IP lawyers 0.4i
+Two or more attorneys.
+.IP guns
+Firearms,
+preferably large-caliber.
+.IP money
+Gotta pay for those
+lawyers and guns!
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A glossary-style list:
+
+lawyers
+      Two or more attorneys.
+
+guns  Firearms, preferably large-caliber.
+
+money
+      Gotta pay for those lawyers and guns!
+</pre></div></div>
+
+<p>In the previous example, observe how the <code class="code">IP</code> macro places the
+definition on the same line as the term if it has enough space.  If this
+is not what you want, there are a few workarounds we will illustrate by
+modifying the example.  First, you can use a <code class="code">br</code> request to force
+a break after printing the term or label.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns
+.br
+Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>Second, you could apply the <code class="code">\p</code> escape sequence to force a break.
+The space following the escape sequence is important; if you omit it,
+<code class="code">groff</code> prints the first word of the paragraph text on the same
+line as the term or label (if it fits) <em class="emph">then</em> breaks the line.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns
+\p Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>Finally, you may append a horizontal motion to the marker with the
+<code class="code">\h</code> escape sequence; using the same amount as the indentation will
+ensure that the marker is too wide for <code class="code">groff</code> to treat it as
+&ldquo;fitting&rdquo; on the same line as the paragraph text.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns\h'0.4i'
+Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>In each case, the result is the same.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A glossary-style list:
+
+lawyers
+      Two or more attorneys.
+
+guns
+      Firearms, preferably large-caliber.
+
+money
+      Gotta pay for those lawyers and guns!
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Indented-regions-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-keeps-and-displays" accesskey="n" rel="next">Keeps, boxed keeps, and displays</a>, Previous: <a href="#Lists-in-ms" accesskey="p" rel="prev">Lists</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Indented-regions">4.6.5.7 Indented regions</h4>
+
+<p>You may need to indent a region of text while otherwise formatting it
+normally.  Indented regions can be nested; you can change <code class="code">\nPI</code>
+before each call to vary the amount of inset.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RS</code></strong><a class="copiable-link" href='#index-_002eRS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RS-_005bms_005d"></a>
+<p>Begin a region where headings, paragraphs, and displays are indented
+(further) by the amount stored in the <code class="code">PI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RE</code></strong><a class="copiable-link" href='#index-_002eRE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RE-_005bms_005d"></a>
+<p>End the (next) most recent indented region.
+</p></dd></dl>
+
+<p>This feature enables you to easily line up text under hanging and
+indented paragraphs.
+<a class="index-entry-id" id="index-ms-macros_002c-nested-lists"></a>
+<a class="index-entry-id" id="index-nested-lists-_005bms_005d"></a>
+For example, you may wish to structure lists hierarchically.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP \bu 2
+Lawyers:
+.RS
+.IP \bu
+Dewey,
+.IP \bu
+Cheatham,
+and
+.IP \bu
+and Howe.
+.RE
+.IP \bu
+Guns
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">&bull; Lawyers:
+
+  &bull;  Dewey,
+
+  &bull;  Cheatham, and
+
+  &bull;  Howe.
+
+&bull; Guns
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-keeps-and-displays">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Insertions" accesskey="n" rel="next">Tables, figures, equations, and references</a>, Previous: <a href="#Indented-regions-in-ms" accesskey="p" rel="prev">Indented regions</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Keeps_002c-boxed-keeps_002c-and-displays">4.6.5.8 Keeps, boxed keeps, and displays</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-displays"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-keeps"></a>
+<a class="index-entry-id" id="index-keeps-_005bms_005d"></a>
+
+<p>On occasion, you may want to <em class="dfn">keep</em> several lines of text, or a
+region of a document, together on a single page, preventing an automatic
+page break within certain boundaries.  This can cause a page break to
+occur earlier than it normally would.  For example, you may want to keep
+two paragraphs together, or a paragraph that refers to a table, list, or
+figure adjacent to the item it discusses.  <samp class="file">ms</samp> provides the
+<code class="code">KS</code> and <code class="code">KE</code> macros for this purpose.
+</p>
+<p>You can alternatively specify a <em class="dfn">floating keep</em>: if a keep cannot
+fit on the current page, <samp class="file">ms</samp> holds its contents and
+allows material following the keep (in the source document) to fill the
+remainder of the current page.  When the page breaks, whether by
+reaching the end or <code class="code">bp</code> request, <samp class="file">ms</samp> puts the floating keep
+at the beginning of the next page.  This is useful for placing large
+graphics or tables that do not need to appear exactly where they occur
+in the source document.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eKS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KS</code></strong><a class="copiable-link" href='#index-_002eKS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eKF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KF</code></strong><a class="copiable-link" href='#index-_002eKF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KF-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eKE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KE</code></strong><a class="copiable-link" href='#index-_002eKE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KE-_005bms_005d"></a>
+<p><code class="code">KS</code> begins a keep, <code class="code">KF</code> a floating keep, and <code class="code">KE</code> ends a
+keep of either kind.
+</p></dd></dl>
+
+<p>As an alternative to the keep mechanism, the <code class="code">ne</code> request forces a
+page break if there is not at least the amount of vertical space
+specified in its argument remaining on the page (see <a class="pxref" href="#Page-Control">Page Control</a>).
+One application of <code class="code">ne</code> is to reserve space on the page for a
+figure or illustration to be included later.
+</p>
+<a class="index-entry-id" id="index-boxes-_005bms_005d"></a>
+<p>A <em class="dfn">boxed keep</em> has a frame drawn around it.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eB1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B1</code></strong><a class="copiable-link" href='#index-_002eB1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B1-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eB2"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B2</code></strong><a class="copiable-link" href='#index-_002eB2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B2-_005bms_005d"></a>
+<p><code class="code">B1</code> begins a keep with a box drawn around it.  <code class="code">B2</code> ends a
+boxed keep.
+</p></dd></dl>
+
+<p>Boxed keep macros cause breaks; if you need to box a word or phrase
+within a line, see the <code class="code">BX</code> macro in <a class="ref" href="#Typeface-and-decoration">Typeface and decoration</a>.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.  If you wish to box one or more
+paragraphs, you may improve the appearance by calling <code class="code">B1</code> after
+the first paragraphing macro, and by adding a small amount of vertical
+space before calling <code class="code">B2</code>.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.LP
+.B1
+.I Warning:
+Happy Fun Ball may suddenly accelerate to dangerous
+speeds.
+.sp \nPD/2 \&quot; space by half the inter-paragraph distance
+.B2
+</pre></div>
+</td></tr></table>
+
+<p>If you want a boxed keep to float, you will need to enclose the
+<code class="code">B1</code> and <code class="code">B2</code> calls within a pair of <code class="code">KF</code> and <code class="code">KE</code>
+calls.
+</p>
+<a class="index-entry-id" id="index-displays-_005bms_005d"></a>
+<p><em class="dfn">Displays</em> turn off filling; lines of verse or program code are
+shown with their lines broken as in the source document without
+requiring <code class="code">br</code> requests between lines.  Displays can be kept on a
+single page or allowed to break across pages.  The <code class="code">DS</code> macro
+begins a kept display of the layout specified in its first argument;
+non-kept displays are begun with dedicated macros corresponding to their
+layout.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">L</code></var><a class="copiable-link" href='#index-_002eDS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eLD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LD</code></strong><a class="copiable-link" href='#index-_002eLD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LD-_005bms_005d"></a>
+<p>Begin (<code class="code">DS</code>: kept) left-aligned display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">I</code> <span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eDS-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-1"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eID"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.ID</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eID'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ID-_005bms_005d"></a>
+<p>Begin (<code class="code">DS</code>: kept) display indented by <var class="var">indent</var> if specified,
+and by the amount of the <code class="code">DI</code> register otherwise.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-2"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">B</code></var><a class="copiable-link" href='#index-_002eDS-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-2"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eBD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BD</code></strong><a class="copiable-link" href='#index-_002eBD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) a block display: the entire display is
+left-aligned, but indented such that the longest line in the display
+is centered on the page.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-3"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">C</code></var><a class="copiable-link" href='#index-_002eDS-3'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-3"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eCD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CD</code></strong><a class="copiable-link" href='#index-_002eCD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) centered display: each line in the display
+is centered.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-4"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">R</code></var><a class="copiable-link" href='#index-_002eDS-4'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-4"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eRD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RD</code></strong><a class="copiable-link" href='#index-_002eRD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) right-aligned display.  This is a GNU
+extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DE</code></strong><a class="copiable-link" href='#index-_002eDE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DE-_005bms_005d"></a>
+<p>End any display.
+</p></dd></dl>
+
+<p>The distance stored in the <code class="code">DD</code> register is inserted before and
+after each pair of display macros; this is a Berkeley extension.  In
+<code class="code">groff</code> <samp class="file">ms</samp>, this distance replaces any adjacent
+inter-paragraph distance or subsequent spacing prior to a section
+heading.  The <code class="code">DI</code> register is a GNU extension; its value is an
+indentation applied to displays created with &lsquo;<samp class="samp">.DS</samp>&rsquo; and &lsquo;<samp class="samp">.ID</samp>&rsquo;
+without arguments, to &lsquo;<samp class="samp">.DS I</samp>&rsquo; without an indentation argument, and
+to indented equations set with &lsquo;<samp class="samp">.EQ</samp>&rsquo;.  Changes to either register
+take effect at the next display boundary.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-Insertions">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Footnotes" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="#ms-keeps-and-displays" accesskey="p" rel="prev">Keeps, boxed keeps, and displays</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Tables_002c-figures_002c-equations_002c-and-references">4.6.5.9 Tables, figures, equations, and references</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-tables"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-figures"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-equations"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-references"></a>
+<a class="index-entry-id" id="index-tables-_005bms_005d"></a>
+<a class="index-entry-id" id="index-figures-_005bms_005d"></a>
+<a class="index-entry-id" id="index-equations-_005bms_005d"></a>
+<a class="index-entry-id" id="index-references-_005bms_005d"></a>
+
+<p>The <samp class="file">ms</samp> package is often used with the <code class="code">tbl</code>, <code class="code">pic</code>,
+<code class="code">eqn</code>, and <code class="code">refer</code> preprocessors.
+<a class="index-entry-id" id="index-tbl"></a>
+<a class="index-entry-id" id="index-pic"></a>
+<a class="index-entry-id" id="index-eqn"></a>
+<a class="index-entry-id" id="index-refer"></a>
+Mark text meant for preprocessors by enclosing it in pairs of tokens
+as follows, with nothing between the dot and the macro name.  The
+preprocessors match these tokens only at the start of an input line.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TS</code></strong> <var class="def-var-arguments"><code class="code">H</code></var><a class="copiable-link" href='#index-_002eTS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eTE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TE</code></strong><a class="copiable-link" href='#index-_002eTE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TE-_005bms_005d"></a>
+<p>Demarcate a table to be processed by the <code class="code">tbl</code> preprocessor.  The
+optional argument&nbsp;<code class="code">H</code> to <code class="code">TS</code> instructs <samp class="file">ms</samp> to
+repeat table rows (often column headings) at the top of each new page
+the table spans, if applicable; calling the <code class="code">TH</code> macro marks the
+end of such rows.  The GNU <cite class="cite">tbl<span class="r">(1)</span></cite> man page provides a
+comprehensive reference to the preprocessor and offers examples of its
+use.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PS</code></strong><a class="copiable-link" href='#index-_002ePS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002ePE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PE</code></strong><a class="copiable-link" href='#index-_002ePE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PE-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002ePF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PF</code></strong><a class="copiable-link" href='#index-_002ePF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PF-_005bms_005d"></a>
+<p><code class="code">PS</code> begins a picture to be processed by the <code class="command">gpic</code>
+preprocessor; either of <code class="code">PE</code> or <code class="code">PF</code> ends it, the latter with
+&ldquo;flyback&rdquo; to the vertical position at its top.  You can create
+<code class="code">pic</code> input manually or with a program such as <code class="code">xfig</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEQ"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EQ</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">align</i></span> <span class="r"><i class="slanted">label</i></span></var><a class="copiable-link" href='#index-_002eEQ'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EQ-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EN</code></strong><a class="copiable-link" href='#index-_002eEN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EN-_005bms_005d"></a>
+<p>Demarcate an equation to be processed by the <code class="code">eqn</code> preprocessor.
+The equation is centered by default; <var class="var">align</var> can be &lsquo;<samp class="samp">C</samp>&rsquo;,
+&lsquo;<samp class="samp">L</samp>&rsquo;, or &lsquo;<samp class="samp">I</samp>&rsquo; to (explicitly) center, left-align, or indent it
+by the amount stored in the <code class="code">DI</code> register, respectively.  If
+specified, <var class="var">label</var> is set right-aligned.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e_005b"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.</code></strong><a class="copiable-link" href='#index-_002e_005b'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005b-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002e_005d"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.</code></strong><a class="copiable-link" href='#index-_002e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005d-_005bms_005d"></a>
+<p>Demarcate a bibliographic citation to be processed by the <code class="code">refer</code>
+preprocessor.  The GNU <cite class="cite">refer<span class="r">(1)</span></cite> man page provides a
+comprehensive reference to the preprocessor and the format of its
+bibliographic database.  Type &lsquo;<samp class="samp">man refer</samp>&rsquo; at the command line to
+view it.
+</p></dd></dl>
+
+<p>When <code class="code">refer</code> emits collected references (as might be done on a
+&ldquo;Works Cited&rdquo; page), it interpolates the <code class="code">REFERENCES</code> string as
+an unnumbered heading (<code class="code">SH</code>).
+</p>
+<a class="index-entry-id" id="index-table_002c-multi_002dpage_002c-example-_005bms_005d"></a>
+<a class="index-entry-id" id="index-multi_002dpage-table-example-_005bms_005d"></a>
+<p>The following is an example of how to set up a table that may print
+across two or more pages.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.TS H
+allbox;
+Cb | Cb .
+Part&rarr;Description
+_
+.TH
+.T&amp;
+GH-1978&rarr;Fribulating gonkulator
+<span class="r">&hellip;the rest of the table follows&hellip;</span>
+.TE
+</pre></div>
+</td></tr></table>
+
+<p>Attempting to place a multi-page table inside a keep can lead to
+unpleasant results, particularly if the <code class="code">tbl</code> <code class="code">allbox</code> option
+is used.
+</p>
+<a class="index-entry-id" id="index-equation-example-_005bms_005d"></a>
+<p>Mathematics can be typeset using the language of the <code class="code">eqn</code>
+preprocessor.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.EQ C (\*SN-NO-DOTa)
+p ~ = ~ q sqrt { ( 1 + ~ ( x / q sup 2 ) }
+.EN
+</pre></div>
+</td></tr></table>
+
+<p>This input formats a labelled equation.  We used the <code class="code">SN-NO-DOT</code>
+string to base the equation label on the current heading number, giving
+us more flexibility to reorganize the document.
+</p>
+<p>Use <code class="command">groff</code> options to run preprocessors on the input:
+<samp class="option">-e</samp> for <code class="command">geqn</code>, <samp class="option">-p</samp> for <code class="command">gpic</code>,
+<samp class="option">-R</samp> for <code class="command">grefer</code>, and <samp class="option">-t</samp> for <code class="command">gtbl</code>.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-Footnotes">
+<div class="nav-panel">
+<p>
+Previous: <a href="#ms-Insertions" accesskey="p" rel="prev">Tables, figures, equations, and references</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Footnotes">4.6.5.10 Footnotes</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-footnotes"></a>
+<a class="index-entry-id" id="index-footnotes-_005bms_005d"></a>
+
+<a class="index-entry-id" id="index-footnote-marker-_005bms_005d"></a>
+<a class="index-entry-id" id="index-marker_002c-footnote-_005bms_005d"></a>
+<p>A footnote is typically anchored to a place in the text with a
+<em class="dfn">marker</em>, which is a small integer, a symbol such as a dagger, or
+arbitrary user-specified text.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002a_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\**</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002a_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002a-_005bms_005d"></a>
+<p>Place an <em class="dfn">automatic number</em>, an automatically generated numeric
+footnote marker, in the text.  Each time this string is interpolated,
+the number it produces increments by one.  Automatic numbers start at 1.
+This is a Berkeley extension.
+</p></dd></dl>
+
+<p>Enclose the footnote text in <code class="code">FS</code> and <code class="code">FE</code> macro calls to set
+it at the nearest available &ldquo;foot&rdquo;, or bottom, of a text column or
+page.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eFS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.FS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">marker</i></span></var><a class="copiable-link" href='#index-_002eFS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eFE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.FE</code></strong><a class="copiable-link" href='#index-_002eFE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FE-_005bms_005d"></a>
+<p>Begin (<code class="code">FS</code>) and end (<code class="code">FE</code>) a footnote.  <code class="code">FS</code> calls
+<code class="code">FS-MARK</code> with any supplied <var class="var">marker</var> argument, which is then
+also placed at the beginning of the footnote text.  If <var class="var">marker</var> is
+omitted, the next pending automatic footnote number enqueued by
+interpolation of the <code class="code">*</code> string is used, and if none exists,
+nothing is prefixed.
+</p></dd></dl>
+
+<p>You may not desire automatically numbered footnotes in spite of their
+convenience.  You can indicate a footnote with a symbol or other text by
+specifying its marker at the appropriate place (for example, by using
+<code class="code">\dg</code> for the dagger glyph) <em class="emph">and</em> as an argument to the
+<code class="code">FS</code> macro.  Such manual marks should be repeated as arguments to
+<code class="code">FS</code> or as part of the footnote text to disambiguate their
+correspondence.  You may wish to use <code class="code">\*{</code> and <code class="code">\*}</code> to
+superscript the marker at the anchor point, in the footnote text, or
+both.
+</p>
+<p><code class="code">groff</code> <samp class="file">ms</samp> provides a hook macro, <code class="code">FS-MARK</code>, for
+user-determined operations to be performed when the <code class="code">FS</code> macro is
+called.  It is passed the same arguments as <code class="code">FS</code> itself.  An
+application of <code class="code">FS-MARK</code> is anchor placement for a hyperlink
+reference, so that a footnote can link back to its referential
+context.<a class="footnote" id="DOCF11" href="#FOOT11"><sup>11</sup></a>  By default, this macro has an empty definition.
+<code class="code">FS-MARK</code> is a GNU extension.
+</p>
+<a class="index-entry-id" id="index-footnotes_002c-and-keeps-_005bms_005d"></a>
+<a class="index-entry-id" id="index-keeps_002c-and-footnotes-_005bms_005d"></a>
+<a class="index-entry-id" id="index-footnotes_002c-and-displays-_005bms_005d"></a>
+<a class="index-entry-id" id="index-displays_002c-and-footnotes-_005bms_005d"></a>
+<p>Footnotes can be safely used within keeps and displays, but you should
+avoid using automatically numbered footnotes within floating keeps.  You
+can place a second <code class="code">\**</code> interpolation between a <code class="code">\**</code> and its
+corresponding <code class="code">FS</code> call as long as each <code class="code">FS</code> call occurs
+<em class="emph">after</em> the corresponding <code class="code">\**</code> and occurrences of <code class="code">FS</code>
+are in the same order as corresponding occurrences of <code class="code">\**</code>.
+</p>
+<p>Footnote text is formatted as paragraphs are, using analogous
+parameters.  The registers <code class="code">FI</code>, <code class="code">FPD</code>, <code class="code">FPS</code>, and
+<code class="code">FVS</code> correspond to <code class="code">PI</code>, <code class="code">PD</code>, <code class="code">PS</code>, and <code class="code">CS</code>,
+respectively; <code class="code">FPD</code>, <code class="code">FPS</code>, and <code class="code">FVS</code> are GNU extensions.
+</p>
+<p>The <code class="code">FF</code> register controls the formatting of automatically numbered
+footnote paragraphs and those for which <code class="code">FS</code> is given a marker
+argument.  See <a class="xref" href="#ms-Document-Control-Settings">Document Control Settings</a>.
+</p>
+<p>The default footnote line length is 11/12ths of the normal line length
+for compatibility with the expectations of historical <samp class="file">ms</samp>
+documents; you may wish to set the <code class="code">FR</code> string to &lsquo;<samp class="samp">1</samp>&rsquo; to align
+with contemporary typesetting practices.  In the
+past,<a class="footnote" id="DOCF12" href="#FOOT12"><sup>12</sup></a> an <code class="code">FL</code> register
+was used for the line length in footnotes; however, setting this
+register at document initialization time had no effect on the footnote
+line length in multi-column arrangements.<a class="footnote" id="DOCF13" href="#FOOT13"><sup>13</sup></a>
+</p>
+<p><code class="code">FR</code> should be used in preference to the old <code class="code">FL</code> register in
+contemporary documents.  The footnote line length is effectively
+computed as &lsquo;<samp class="samp"><i class="slanted">column-width</i> * \*FR</samp>&rsquo;.  If an absolute
+footnote line length is required, recall that arithmetic expressions in
+<code class="code">roff</code> input are evaluated strictly from left to right, with no
+operator precedence (parentheses are honored).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds FR 0+3i \&quot; Set footnote line length to 3 inches.
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-language-and-localization">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Page-Layout" accesskey="n" rel="next">Page layout</a>, Previous: <a href="#ms-Footnotes" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="#ms-Body-Text" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Language-and-localization">4.6.5.11 Language and localization</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-language"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-localization"></a>
+<a class="index-entry-id" id="index-language-_005bms_005d"></a>
+<a class="index-entry-id" id="index-localization-_005bms_005d"></a>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> provides several strings that you can customize
+for your own purposes, or redefine to adapt the macro package to
+languages other than English.  It is already localized for
+Czech, German, French, Italian, and Swedish.  Load the desired
+localization macro package after <samp class="file">ms</samp>; see the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">$ groff -ms -mfr bienvenue.ms
+</pre></div>
+</td></tr></table>
+
+<p>The following strings are available.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bREFERENCES_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*REFERENCES</code></strong><a class="copiable-link" href='#index-_005c_002a_005bREFERENCES_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-REFERENCES-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of a references
+(bibliography) page produced with GNU <cite class="cite">refer<span class="r">(1)</span></cite>.  The default
+is &lsquo;<samp class="samp">References</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bABSTRACT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*ABSTRACT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bABSTRACT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ABSTRACT-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of the abstract.  The
+default is &lsquo;<samp class="samp">\fIABSTRACT\f</samp>&rsquo;; it includes font selection escape
+sequences to set the word in italics.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bTOC_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*TOC</code></strong><a class="copiable-link" href='#index-_005c_002a_005bTOC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TOC-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of the table of contents.
+The default is &lsquo;<samp class="samp">Table of Contents</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bMONTH1_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH1</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH1_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH1-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH2_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH2</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH2_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH2-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH3_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH3</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH3_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH3-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH4_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH4</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH4_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH4-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH5_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH5</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH5_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH5-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH6_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH6</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH6_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH6-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH7_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH7</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH7_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH7-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH8_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH8</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH8_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH8-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH9_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH9</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH9_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH9-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH10_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH10</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH10_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH10-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH11_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH11</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH11_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH11-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH12_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH12</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH12_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH12-_005bms_005d"></a>
+<p>Contain the full names of the calendar months.  The defaults are in
+English: &lsquo;<samp class="samp">January</samp>&rsquo;, &lsquo;<samp class="samp">February</samp>&rsquo;, and so on.
+</p></dd></dl>
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="ms-Page-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="#Differences-from-AT_0026T-ms" accesskey="n" rel="next">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Previous: <a href="#ms-Body-Text" accesskey="p" rel="prev">Body Text</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Page-layout">4.6.6 Page layout</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-page-layout"></a>
+<a class="index-entry-id" id="index-page-layout-_005bms_005d"></a>
+
+<p><samp class="file">ms</samp>&rsquo;s default page layout arranges text in a single column with
+the page number between hyphens centered in a header on each page except
+the first, and produces no footers.  You can customize this arrangement.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#ms-Headers-and-Footers" accesskey="1">Headers and footers</a></li>
+<li><a href="#Tab-Stops-in-ms" accesskey="2">Tab stops</a></li>
+<li><a href="#ms-Margins" accesskey="3">Margins</a></li>
+<li><a href="#ms-Multiple-Columns" accesskey="4">Multiple columns</a></li>
+<li><a href="#ms-TOC" accesskey="5">Creating a table of contents</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="ms-Headers-and-Footers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Tab-Stops-in-ms" accesskey="n" rel="next">Tab stops</a>, Previous: <a href="#ms-Page-Layout" accesskey="p" rel="prev">Page layout</a>, Up: <a href="#ms-Page-Layout" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Headers-and-footers">4.6.6.1 Headers and footers</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-headers"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-footers"></a>
+<a class="index-entry-id" id="index-headers-_005bms_005d"></a>
+<a class="index-entry-id" id="index-footers-_005bms_005d"></a>
+
+<p>There are multiple ways to produce headers and footers.  One is to
+define the strings <code class="code">LH</code>, <code class="code">CH</code>, and <code class="code">RH</code> to set the left,
+center, and right headers, respectively; and <code class="code">LF</code>, <code class="code">CF</code>, and
+<code class="code">RF</code> to set the left, center, and right footers.  This approach
+suffices for documents that do not distinguish odd- and even-numbered
+pages.
+</p>
+<p>Another method is to call macros that set headers or footers for odd- or
+even-numbered pages.  Each such macro takes a delimited argument
+separating the left, center, and right header or footer texts from each
+other.  You can replace the neutral apostrophes (<code class="code">'</code>) shown below
+with any character not appearing in the header or footer text.  These
+macros are Berkeley extensions.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eOH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.OH</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eOH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EH</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eEH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eOF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.OF</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eOF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OF-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EF</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eEF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EF-_005bms_005d"></a>
+<p>The <code class="code">OH</code> and <code class="code">EH</code> macros define headers for odd- (recto)
+and even-numbered (verso) pages, respectively; the <code class="code">OF</code> and
+<code class="code">EF</code> macros define footers for them.
+</p></dd></dl>
+
+<p>With either method, a percent sign <code class="code">%</code> in header or footer text is
+replaced by the current page number.  By default, <samp class="file">ms</samp> places no
+header on a page numbered &ldquo;1&rdquo; (regardless of its number format).
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eP1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.P1</code></strong><a class="copiable-link" href='#index-_002eP1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-P1-_005bms_005d"></a>
+<p>Typeset the header even on page&nbsp;1.  To be effective, this macro
+must be called before the header trap is sprung on any page numbered
+&ldquo;1&rdquo;; in practice, unless your page numbering is unusual, this means
+that you should call it early, before <code class="code">TL</code> or any heading or
+paragraphing macro.  This is a Berkeley extension.
+</p></dd></dl>
+
+<p>For even greater flexibility, <samp class="file">ms</samp> is designed to permit the
+redefinition of the macros that are called when the <code class="code">groff</code> traps
+that ordinarily cause the headers and footers to be output are sprung.
+<code class="code">PT</code> (&ldquo;page trap&rdquo;) is called by <samp class="file">ms</samp> when the header is to
+be written, and <code class="code">BT</code> (&ldquo;bottom trap&rdquo;) when the footer is to be.
+The <code class="code">groff</code> page location trap that <samp class="file">ms</samp> sets up to format the
+header also calls the (normally undefined) <code class="code">HD</code> macro after
+<code class="code">PT</code>; you can define <code class="code">HD</code> if you need additional processing
+after setting the header (for example, to draw a line below it).
+The <code class="code">HD</code> hook is a Berkeley extension.  Any such macros you
+(re)define must implement any desired specialization for odd-, even-, or
+first numbered pages.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Tab-Stops-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Margins" accesskey="n" rel="next">Margins</a>, Previous: <a href="#ms-Headers-and-Footers" accesskey="p" rel="prev">Headers and footers</a>, Up: <a href="#ms-Page-Layout" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Tab-stops">4.6.6.2 Tab stops</h4>
+
+<p>Use the <code class="code">ta</code> request to define tab stops as needed.  See <a class="xref" href="#Tabs-and-Fields">Tabs and Fields</a>.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TA</code></strong><a class="copiable-link" href='#index-_002eTA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TA-_005bms_005d"></a>
+<p>Reset the tab stops to the <samp class="file">ms</samp> default (every 5 ens).
+Redefine this macro to create a different set of default tab stops.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-Margins">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Multiple-Columns" accesskey="n" rel="next">Multiple columns</a>, Previous: <a href="#Tab-Stops-in-ms" accesskey="p" rel="prev">Tab stops</a>, Up: <a href="#ms-Page-Layout" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Margins">4.6.6.3 Margins</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-margins"></a>
+
+<p>Control margins using the registers summarized in &ldquo;Margin settings&rdquo; in
+<a class="ref" href="#ms-Document-Control-Settings">Document Control Settings</a> above.  There is no setting for the
+right margin; the combination of page offset <code class="code">\nPO</code> and line
+length <code class="code">\nLL</code> determines it.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-Multiple-Columns">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-TOC" accesskey="n" rel="next">Creating a table of contents</a>, Previous: <a href="#ms-Margins" accesskey="p" rel="prev">Margins</a>, Up: <a href="#ms-Page-Layout" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Multiple-columns">4.6.6.4 Multiple columns</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-multiple-columns"></a>
+<a class="index-entry-id" id="index-multiple-columns-_005bms_005d"></a>
+
+<p><samp class="file">ms</samp> can set text in as many columns as reasonably fit on the page.
+The following macros force a page break if a multi-column layout is
+active when they are called.  The <code class="code">MINGW</code> register stores the
+default minimum gutter width; it is a GNU extension.  When multiple
+columns are in use, keeps and the <code class="code">HORPHANS</code> and <code class="code">PORPHANS</code>
+registers work with respect to column breaks instead of page breaks.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e1C"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.1C</code></strong><a class="copiable-link" href='#index-_002e1C'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-1C-_005bms_005d"></a>
+<p>Arrange page text in a single column (the default).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e2C"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.2C</code></strong><a class="copiable-link" href='#index-_002e2C'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-2C-_005bms_005d"></a>
+<p>Arrange page text in two columns.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eMC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.MC</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">column-width</i></span> <span class="r"><i class="slanted">gutter-width</i></span></var><a class="copiable-link" href='#index-_002eMC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MC-_005bms_005d"></a>
+<p>Arrange page text in multiple columns.  If you specify no arguments, it
+is equivalent to the <code class="code">2C</code> macro.  Otherwise, <var class="var">column-width</var> is
+the width of each column and <var class="var">gutter-width</var> is the minimum distance
+between columns.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="ms-TOC">
+<div class="nav-panel">
+<p>
+Next: <a href="#Differences-from-AT_0026T-ms" accesskey="n" rel="next">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Previous: <a href="#ms-Multiple-Columns" accesskey="p" rel="prev">Multiple columns</a>, Up: <a href="#ms-Page-Layout" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Creating-a-table-of-contents">4.6.6.5 Creating a table of contents</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-creating-table-of-contents"></a>
+<a class="index-entry-id" id="index-table-of-contents_002c-creating-_005bms_005d"></a>
+
+<p>Because <code class="code">roff</code> formatters process their input in a single pass,
+material on page 50, for example, cannot influence what appears on
+page&nbsp;1&mdash;this poses a challenge for a table of contents at its
+traditional location in front matter, if you wish to avoid manually
+maintaining it.  <samp class="file">ms</samp> enables the collection of material to be
+presented in the table of contents as it appears, saving its page number
+along with it, and then emitting the collected contents on demand toward
+the end of the document.  The table of contents can then be resequenced
+to its desired location by physically rearranging the pages of a printed
+document, or as part of post-processing&mdash;with a <cite class="cite">sed<span class="r">(1)</span></cite>
+script to reorder the pages in <code class="command">troff</code>&rsquo;s output, with
+<cite class="cite">pdfjam<span class="r">(1)</span></cite>, or with <cite class="cite">gropdf<span class="r">(1)</span></cite>&rsquo;s
+&lsquo;<samp class="samp">.pdfswitchtopage</samp>&rsquo; feature, for example.
+</p>
+<p>Define an entry to appear in the table of contents by bracketing its
+text between calls to the <code class="code">XS</code> and <code class="code">XE</code> macros.  A typical
+application is to call them immediately after <code class="code">NH</code> or <code class="code">SH</code> and
+repeat the heading text within them.  The <code class="code">XA</code> macro, used within
+&lsquo;<samp class="samp">.XS</samp>&rsquo;/&lsquo;<samp class="samp">.XE</samp>&rsquo; pairs, supplements an entry&mdash;for instance, when
+it requires multiple output lines, whether because a heading is too long
+to fit or because style dictates that page numbers not be repeated.  You
+may wish to indent the text thus wrapped to correspond to its heading
+depth; this can be done in the entry text by prefixing it with tabs or
+horizontal motion escape sequences, or by providing a second argument to
+the <code class="code">XA</code> macro.  <code class="code">XS</code> and <code class="code">XA</code> automatically associate
+the page number where they are called with the text following them, but
+they accept arguments to override this behavior.  At the end of the
+document, call <code class="code">TC</code> or <code class="code">PX</code> to emit the table of contents;
+<code class="code">TC</code> resets the page number to &lsquo;<samp class="samp">i</samp>&rsquo; (Roman numeral one), and
+then calls <code class="code">PX</code>.  All of these macros are Berkeley extensions.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002eXS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XA</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span> <span class="r"><i class="slanted">indentation</i></span></var><a class="copiable-link" href='#index-_002eXA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XA-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XE</code></strong><a class="copiable-link" href='#index-_002eXE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XE-_005bms_005d"></a>
+<p>Begin, supplement, and end a table of contents entry.  Each entry is
+associated with <var class="var">page-number</var> (otherwise the current page number); a
+<var class="var">page-number</var> of &lsquo;<samp class="samp">no</samp>&rsquo; prevents a leader and page number from
+being emitted for that entry.  Use of <code class="code">XA</code> within
+<code class="code">XS</code>/<code class="code">XE</code> is optional; it can be repeated.  If
+<var class="var">indentation</var> is present, a supplemental entry is indented by that
+amount; ens are assumed if no unit is indicated.  Text on input lines
+between <code class="code">XS</code> and <code class="code">XE</code> is stored for later recall by <code class="code">PX</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PX</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002ePX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PX-_005bms_005d"></a>
+<p>Switch to single-column layout.  Unless <code class="code">no</code> is specified, center
+and interpolate the <code class="code">TOC</code> string in bold and two points larger than
+the body text.  Emit the table of contents entries.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TC</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002eTC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TC-_005bms_005d"></a>
+<p>Set the page number to&nbsp;1, the page number format to lowercase Roman
+numerals, and call <code class="code">PX</code> (with a <code class="code">no</code> argument, if present).
+</p></dd></dl>
+
+<p>Here&rsquo;s an example of typical <samp class="file">ms</samp> table of contents preparation.
+We employ horizontal escape sequences <code class="code">\h</code> to indent the entries by
+sectioning depth.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+Introduction
+.XS
+Introduction
+.XE
+<span class="r">&hellip;</span>
+.NH 2
+Methodology
+.XS
+\h'2n'Methodology
+.XA
+\h'4n'Fassbinder's Approach
+\h'4n'Kahiu's Approach
+.XE
+<span class="r">&hellip;</span>
+.NH 1
+Findings
+.XS
+Findings
+.XE
+<span class="r">&hellip;</span>
+.TC
+</pre></div>
+</td></tr></table>
+
+<p>The remaining features in this subsubsection are GNU extensions.
+<code class="code">groff</code> <samp class="file">ms</samp> obviates the need to repeat heading text after
+<code class="code">XS</code> calls.  Call <code class="code">XN</code> and <code class="code">XH</code> after <code class="code">NH</code> and
+<code class="code">SH</code>, respectively.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH-_005bms_005d"></a>
+<p>Format <var class="var">heading-text</var> and create a corresponding table of contents
+entry.  <code class="code">XN</code> computes the indentation from the depth of the
+preceding <code class="code">NH</code> call; <code class="code">XH</code> requires a <var class="var">depth</var> argument to
+do so.
+</p></dd></dl>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> encourages customization of table of contents
+entry production.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN_002dREPLACEMENT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN-REPLACEMENT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXN_002dREPLACEMENT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN_002dREPLACEMENT-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH_002dREPLACEMENT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH-REPLACEMENT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH_002dREPLACEMENT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH_002dREPLACEMENT-_005bms_005d"></a>
+<p>These hook macros implement <code class="code">XN</code> and <code class="code">XH</code>, respectively.
+They call <code class="code">XN-INIT</code> and pass their <var class="var">heading-text</var> arguments to
+<code class="code">XH-UPDATE-TOC</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN_002dINIT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN-INIT</code></strong><a class="copiable-link" href='#index-_002eXN_002dINIT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN_002dINIT-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH_002dUPDATE_002dTOC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH-UPDATE-TOC</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH_002dUPDATE_002dTOC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH_002dUPDATE_002dTOC-_005bms_005d"></a>
+<p>The <code class="code">XN-INIT</code> hook macro does nothing by default.
+<code class="code">XH-UPDATE-TOC</code> brackets <var class="var">heading-text</var> with <code class="code">XS</code> and
+<code class="code">XE</code> calls, indenting it by 2 ens per level of <var class="var">depth</var> beyond
+the first.
+</p></dd></dl>
+
+<p>We could therefore produce a table of contents similar to that in the
+previous example with fewer macro calls.  (The difference is that this
+input follows the &ldquo;Approach&rdquo; entries with leaders and page numbers.)
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+.XN Introduction
+<span class="r">&hellip;</span>
+.NH 2
+.XN Methodology
+.XH 3 &quot;Fassbinder's Approach&quot;
+.XH 3 &quot;Kahiu's Approach&quot;
+<span class="r">&hellip;</span>
+.NH 1
+.XN Findings
+<span class="r">&hellip;</span>
+</pre></div>
+</td></tr></table>
+
+<p>To get the section number of the numbered headings into the table of
+contents entries, we might define <code class="code">XN-REPLACEMENT</code> as follows.
+(We obtain the heading depth from <code class="code">groff</code> <samp class="file">ms</samp>&rsquo;s internal
+register <code class="code">nh*hl</code>.)
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.de XN-REPLACEMENT
+.XN-INIT
+.XH-UPDATE-TOC \\nnh*hl \\$@
+\&amp;\\*SN \\$*
+..
+</pre></div>
+</td></tr></table>
+
+<p>You can change the style of the leader that bridges each table of
+contents entry with its page number; define the <code class="code">TC-LEADER</code> special
+character by using the <code class="code">char</code> request.  A typical leader combines
+the dot glyph &lsquo;<samp class="samp">.</samp>&rsquo; with a horizontal motion escape sequence to
+spread the dots.  The width of the page number field is stored in the
+<code class="code">TC-MARGIN</code> register.
+</p>
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="Differences-from-AT_0026T-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Naming-Conventions" accesskey="n" rel="next">Naming Conventions</a>, Previous: <a href="#ms-Page-Layout" accesskey="p" rel="prev">Page layout</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Differences-from-AT_0026T-ms-1">4.6.7 Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></h4>
+<a class="index-entry-id" id="index-ms-macros_002c-groff-differences-from-AT_0026T"></a>
+<a class="index-entry-id" id="index-AT_0026T-ms_002c-macro-package-differences"></a>
+
+<p>The <code class="code">groff</code> <samp class="file">ms</samp> macros are an independent reimplementation,
+using no <abbr class="acronym">AT&amp;T</abbr> code.  Since they take advantage of the extended
+features of <code class="code">groff</code>, they cannot be used with <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>.  <code class="code">groff</code> <samp class="file">ms</samp> supports features described above
+as Berkeley and Tenth Edition Research Unix extensions, and adds several
+of its own.
+</p>
+<ul class="itemize mark-bullet">
+<li>The internals of <code class="code">groff</code> <samp class="file">ms</samp> differ from the internals of
+<abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>.  Documents that depend upon implementation
+details of <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> may not format properly with
+<code class="code">groff</code> <samp class="file">ms</samp>.  Such details include macros whose function was
+not documented in the <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>
+manual.<a class="footnote" id="DOCF14" href="#FOOT14"><sup>14</sup></a>
+
+</li><li>The error-handling policy of <code class="code">groff</code> <samp class="file">ms</samp> is to detect and
+report errors, rather than to ignore them silently.
+
+</li><li>Tenth Edition Research Unix supported <code class="code">P1</code>/<code class="code">P2</code> macros to bracket code
+examples; <code class="code">groff</code> <samp class="file">ms</samp> does not.
+
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> does not work in GNU <code class="code">troff</code>&rsquo;s
+<abbr class="acronym">AT&amp;T</abbr> compatibility mode.  If loaded when that mode is enabled,
+it aborts processing with a diagnostic message.
+
+</li><li>Multiple line spacing is not supported.  Use a larger vertical spacing
+instead.
+
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> uses the same header and footer defaults in both
+<code class="code">nroff</code> and <code class="code">troff</code> modes as <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> does in
+<code class="code">troff</code> mode; <abbr class="acronym">AT&amp;T</abbr>&rsquo;s default in <code class="code">nroff</code> mode is to
+put the date, in U.S. traditional format (e.g., &ldquo;January 1, 2021&rdquo;),
+in the center footer (the <code class="code">CF</code> string).
+
+</li><li>Many <code class="code">groff</code> <samp class="file">ms</samp> macros, including those for paragraphs,
+headings, and displays, cause a reset of paragraph rendering parameters,
+and may change the indentation; they do so not by incrementing or
+decrementing it, but by setting it absolutely.  This can cause problems
+for documents that define additional macros of their own that try to
+manipulate indentation.  Use the <samp class="file">ms</samp> <code class="code">RS</code> and <code class="code">RE</code>
+macros instead of the <code class="code">in</code> request.
+
+</li><li><a class="index-entry-id" id="index-fractional-type-sizes-in-ms-macros"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-fractional-type-sizes-in"></a>
+<abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> interpreted the values of the registers
+<code class="code">PS</code> and <code class="code">VS</code> in points, and did not support the use of
+scaling units with them.  <code class="code">groff</code> <samp class="file">ms</samp> interprets values of
+the registers <code class="code">PS</code>, <code class="code">VS</code>, <code class="code">FPS</code>, and <code class="code">FVS</code> equal to
+or larger than&nbsp;1,000 (one thousand) as decimal fractions multiplied
+by&nbsp;1,000.<a class="footnote" id="DOCF15" href="#FOOT15"><sup>15</sup></a>  This threshold makes use of a
+scaling unit with these parameters practical for high-resolution
+devices while preserving backward compatibility.  It also permits
+expression of non-integral type sizes.  For example, &lsquo;<samp class="samp">groff
+-rPS=10.5p</samp>&rsquo; at the shell prompt is equivalent to placing &lsquo;<samp class="samp">.nr PS
+10.5p</samp>&rsquo; at the beginning of the document.
+
+</li><li><abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>&rsquo;s <code class="code">AU</code> macro supported arguments used with
+some document types; <code class="code">groff</code> <samp class="file">ms</samp> does not.
+
+</li><li>Right-aligned displays are available.  The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>
+manual observes that &ldquo;it is tempting to assume that &lsquo;<samp class="samp">.DS R</samp>&rsquo; will
+right adjust lines, but it doesn&rsquo;t work&rdquo;.  In <code class="code">groff</code> <samp class="file">ms</samp>,
+it does.
+
+</li><li>To make <code class="code">groff</code> <samp class="file">ms</samp> use the default page offset (which also
+specifies the left margin), the <code class="code">PO</code> register must stay undefined
+until the first <samp class="file">ms</samp> macro is called.
+
+<p>This implies that &lsquo;<samp class="samp">\nPO</samp>&rsquo; should not be used early in the
+document, unless it is changed also: accessing an undefined register
+automatically defines it.
+</p>
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> supports the <code class="code">PN</code> register, but it is not
+necessary; you can access the page number via the usual <code class="code">%</code>
+register and invoke the <code class="code">af</code> request to assign a different format
+to it if desired.<a class="footnote" id="DOCF16" href="#FOOT16"><sup>16</sup></a>
+
+</li><li>The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> manual documents registers <code class="code">CW</code> and
+<code class="code">GW</code> as setting the default column width and &ldquo;intercolumn gap&rdquo;,
+respectively, and which applied when <code class="code">MC</code> was called with fewer
+than two arguments.  <code class="code">groff</code> <samp class="file">ms</samp> instead treats <code class="code">MC</code>
+without arguments as synonymous with <code class="code">2C</code>; there is thus no
+occasion for a default column width register.  Further, the <code class="code">MINGW</code>
+register and the second argument to <code class="code">MC</code> specify a <em class="emph">minimum</em>
+space between columns, not the fixed gutter width of <abbr class="acronym">AT&amp;T</abbr>
+<samp class="file">ms</samp>.
+
+</li><li>The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> manual did not document the <code class="code">QI</code>
+register; Berkeley and <code class="code">groff</code> <samp class="file">ms</samp> do.
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bGS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nGS</code></strong><a class="copiable-link" href='#index-_005cn_005bGS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GS-_005bms_005d"></a>
+<p>The register <code class="code">GS</code> is set to&nbsp;1 by the <code class="code">groff</code> <samp class="file">ms</samp>
+macros, but is not used by the <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> package.
+Documents that need to determine whether they are being formatted with
+<code class="code">groff</code> <samp class="file">ms</samp> or another implementation should test this
+register.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Missing-Unix-Version-7-ms-Macros" accesskey="1">Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="Missing-Unix-Version-7-ms-Macros">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Differences-from-AT_0026T-ms" accesskey="p" rel="prev">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Up: <a href="#Differences-from-AT_0026T-ms" accesskey="u" rel="up">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Unix-Version-7-ms-macros-not-implemented-by-groff-ms">4.6.7.1 Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></h4>
+
+<p>Several macros described in the Unix Version&nbsp;7 <samp class="file">ms</samp>
+documentation are unimplemented by <code class="code">groff</code> <samp class="file">ms</samp> because they
+are specific to the requirements of documents produced internally by
+Bell Laboratories, some of which also require a glyph for the Bell
+System logo that <code class="code">groff</code> does not support.  These macros
+implemented several document type formats
+(<code class="code">EG</code>, <code class="code">IM</code>, <code class="code">MF</code>, <code class="code">MR</code>, <code class="code">TM</code>, <code class="code">TR</code>), were meaningful only in conjunction with the use of certain document
+types
+(<code class="code">AT</code>, <code class="code">CS</code>, <code class="code">CT</code>, <code class="code">OK</code>, <code class="code">SG</code>), stored the postal addresses of Bell Labs sites
+(<code class="code">HO</code>, <code class="code">IH</code>, <code class="code">MH</code>, <code class="code">PY</code>, <code class="code">WH</code>), or lacked a stable definition over time
+(<code class="code">UX</code>). To compatibly render historical <samp class="file">ms</samp> documents using these macros,
+we advise your documents to invoke the <code class="code">rm</code> request to remove any
+such macros it uses and then define replacements with an authentically
+typeset original at hand.<a class="footnote" id="DOCF17" href="#FOOT17"><sup>17</sup></a>  For
+informal purposes, a simple definition of <code class="code">UX</code> should maintain the
+readability of the document&rsquo;s substance.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.rm UX
+.ds UX Unix\&quot;
+</pre></div>
+</td></tr></table>
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="ms-Legacy-Features">
+<div class="nav-panel">
+<p>
+Next: <a href="#ms-Naming-Conventions" accesskey="n" rel="next">Naming Conventions</a>, Previous: <a href="#Differences-from-AT_0026T-ms" accesskey="p" rel="prev">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Legacy-Features">4.6.8 Legacy Features</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-strings"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-special-characters"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-accent-marks"></a>
+<a class="index-entry-id" id="index-accent-marks-_005bms_005d"></a>
+<a class="index-entry-id" id="index-special-characters-_005bms_005d"></a>
+<a class="index-entry-id" id="index-strings-_005bms_005d"></a>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> retains some legacy features solely to support
+formatting of historical documents; contemporary ones should not use
+them because they can render poorly.  See the <cite class="cite">groff_char<span class="r">(7)</span></cite>
+man page.
+</p>
+<ul class="mini-toc">
+<li><a href="#AT_0026T-accent-mark-strings" accesskey="1">AT&amp;T accent mark strings</a></li>
+<li><a href="#Berkeley-accent-mark-and-glyph-strings" accesskey="2">Berkeley accent mark and glyph strings</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="AT_0026T-accent-mark-strings">
+<h4 class="unnumberedsubsubsec">AT&amp;T accent mark strings</h4>
+
+<p>AT&amp;T <samp class="file">ms</samp> defined accent mark strings as follows.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0027_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0027_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0027-_005bms_005d"></a>
+<p>Apply acute accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0060_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">`</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0060_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0060-_005bms_005d"></a>
+<p>Apply grave accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003a_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*:</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003a_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003a-_005bms_005d"></a>
+<p>Apply dieresis (umlaut) to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*^</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005e-_005bms_005d"></a>
+<p>Apply circumflex accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*~</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007e-_005bms_005d"></a>
+<p>Apply tilde accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bC_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*C</code></strong><a class="copiable-link" href='#index-_005c_002a_005bC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-C-_005bms_005d"></a>
+<p>Apply caron to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002c_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*,</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002c_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002c-_005bms_005d"></a>
+<p>Apply cedilla to subsequent glyph.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Berkeley-accent-mark-and-glyph-strings">
+<h4 class="unnumberedsubsubsec">Berkeley accent mark and glyph strings</h4>
+
+<p>Berkeley <samp class="file">ms</samp> offered an <code class="code">AM</code> macro; calling it redefined the
+AT&amp;T accent mark strings (except for &lsquo;<samp class="samp">\*C</samp>&rsquo;), applied them to the
+<em class="emph">preceding</em> glyph, and defined additional strings, some for spacing
+glyphs.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAM"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AM</code></strong><a class="copiable-link" href='#index-_002eAM'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AM-_005bms_005d"></a>
+<p>Enable alternative accent mark and glyph-producing strings.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0027_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0027_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0027-_005bms_005d-1"></a>
+<p>Apply acute accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0060_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">`</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0060_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0060-_005bms_005d-1"></a>
+<p>Apply grave accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003a_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*:</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003a_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003a-_005bms_005d-1"></a>
+<p>Apply dieresis (umlaut) to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005e_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*^</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005e_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005e-_005bms_005d-1"></a>
+<p>Apply circumflex accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007e_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*~</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007e_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007e-_005bms_005d-1"></a>
+<p>Apply tilde accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002c_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*,</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002c_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002c-_005bms_005d-1"></a>
+<p>Apply cedilla to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*/</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002f-_005bms_005d"></a>
+<p>Apply stroke (slash) to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bv_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*v</code></strong><a class="copiable-link" href='#index-_005c_002a_005bv_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-v-_005bms_005d"></a>
+<p>Apply caron to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*_</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005f-_005bms_005d"></a>
+<p>Apply macron to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*.</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002e-_005bms_005d"></a>
+<p>Apply underdot to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bo_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*o</code></strong><a class="copiable-link" href='#index-_005c_002a_005bo_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-o-_005bms_005d"></a>
+<p>Apply ring accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*?</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003f-_005bms_005d"></a>
+<p>Interpolate inverted question mark.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0021_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*!</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0021_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0021-_005bms_005d"></a>
+<p>Interpolate inverted exclamation mark.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b8_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*8</code></strong><a class="copiable-link" href='#index-_005c_002a_005b8_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-8-_005bms_005d"></a>
+<p>Interpolate small letter sharp s.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bq_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*q</code></strong><a class="copiable-link" href='#index-_005c_002a_005bq_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-q-_005bms_005d"></a>
+<p>Interpolate small letter o with hook accent (ogonek).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b3_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*3</code></strong><a class="copiable-link" href='#index-_005c_002a_005b3_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-3-_005bms_005d"></a>
+<p>Interpolate small letter yogh.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bd_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*d-</code></strong><a class="copiable-link" href='#index-_005c_002a_005bd_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-d_002d-_005bms_005d"></a>
+<p>Interpolate small letter eth.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bD_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*D-</code></strong><a class="copiable-link" href='#index-_005c_002a_005bD_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-D_002d-_005bms_005d"></a>
+<p>Interpolate capital letter eth.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bth_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*th</code></strong><a class="copiable-link" href='#index-_005c_002a_005bth_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-th-_005bms_005d"></a>
+<p>Interpolate small letter thorn.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bTh_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Th</code></strong><a class="copiable-link" href='#index-_005c_002a_005bTh_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Th-_005bms_005d"></a>
+<p>Interpolate capital letter thorn.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bae_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*ae</code></strong><a class="copiable-link" href='#index-_005c_002a_005bae_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ae-_005bms_005d"></a>
+<p>Interpolate small æ ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bAe_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Ae</code></strong><a class="copiable-link" href='#index-_005c_002a_005bAe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Ae-_005bms_005d"></a>
+<p>Interpolate capital Æ ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005boe_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*oe</code></strong><a class="copiable-link" href='#index-_005c_002a_005boe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-oe-_005bms_005d"></a>
+<p>Interpolate small oe ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bOE_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*OE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bOE_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OE-_005bms_005d"></a>
+<p>Interpolate capital OE ligature.
+</p></dd></dl>
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="ms-Naming-Conventions">
+<div class="nav-panel">
+<p>
+Previous: <a href="#ms-Legacy-Features" accesskey="p" rel="prev">Legacy Features</a>, Up: <a href="#ms" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Naming-Conventions">4.6.9 Naming Conventions</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-naming-conventions"></a>
+<a class="index-entry-id" id="index-naming-conventions_002c-ms-macros"></a>
+
+<p>The following conventions are used for names of macros, strings, and
+registers.  External names available to documents that use the
+<code class="code">groff</code> <samp class="file">ms</samp> macros contain only uppercase letters and digits.
+</p>
+<p>Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
+</p>
+<ul class="itemize mark-bullet">
+<li>Names used only within one module are of the form
+<var class="var">module</var><code class="code">*</code><var class="var">name</var>.
+
+</li><li>Names used outside the module in which they are defined are of the form
+<var class="var">module</var><code class="code">@</code><var class="var">name</var>.
+
+</li><li>Names associated with a particular environment are of the form
+<var class="var">environment</var><code class="code">:</code><var class="var">name</var>; these are used only within the
+<code class="code">par</code> module.
+
+</li><li><var class="var">name</var> does not have a module prefix.
+
+</li><li>Constructed names used to implement arrays are of the form
+<var class="var">array</var><code class="code">!</code><var class="var">index</var>.
+</li></ul>
+
+<p>Thus the <code class="code">groff</code> <samp class="file">ms</samp> macros reserve the following names.
+</p>
+<ul class="itemize mark-bullet">
+<li>Names containing the characters <code class="code">*</code>, <code class="code">@</code>, and&nbsp;<code class="code">:</code>.
+
+</li><li>Names containing only uppercase letters and digits.
+</li></ul>
+
+
+
+<hr>
+</div>
+</div>
+</div>
+<div class="chapter-level-extent" id="GNU-troff-Reference">
+<div class="nav-panel">
+<p>
+Next: <a href="#File-Formats" accesskey="n" rel="next">File Formats</a>, Previous: <a href="#Major-Macro-Packages" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="GNU-troff-Reference-1">5 GNU <code class="code">troff</code> Reference</h2>
+<a class="index-entry-id" id="index-reference_002c-gtroff"></a>
+<a class="index-entry-id" id="index-gtroff_002c-reference"></a>
+
+<p>This chapter covers <em class="emph">all</em> of the facilities of the GNU
+<code class="code">troff</code> formatting engine.  Users of macro packages may skip it if
+not interested in details.
+</p>
+
+
+
+
+<ul class="mini-toc">
+<li><a href="#Text" accesskey="1">Text</a></li>
+<li><a href="#Page-Geometry" accesskey="2">Page Geometry</a></li>
+<li><a href="#Measurements" accesskey="3">Measurements</a></li>
+<li><a href="#Numeric-Expressions" accesskey="4">Numeric Expressions</a></li>
+<li><a href="#Identifiers" accesskey="5">Identifiers</a></li>
+<li><a href="#Formatter-Instructions" accesskey="6">Formatter Instructions</a></li>
+<li><a href="#Comments" accesskey="7">Comments</a></li>
+<li><a href="#Registers" accesskey="8">Registers</a></li>
+<li><a href="#Manipulating-Filling-and-Adjustment" accesskey="9">Manipulating Filling and Adjustment</a></li>
+<li><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></li>
+<li><a href="#Manipulating-Spacing">Manipulating Spacing</a></li>
+<li><a href="#Tabs-and-Fields">Tabs and Fields</a></li>
+<li><a href="#Character-Translations">Character Translations</a></li>
+<li><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></li>
+<li><a href="#Line-Layout">Line Layout</a></li>
+<li><a href="#Line-Continuation">Line Continuation</a></li>
+<li><a href="#Page-Layout">Page Layout</a></li>
+<li><a href="#Page-Control">Page Control</a></li>
+<li><a href="#Using-Fonts">Using Fonts</a></li>
+<li><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></li>
+<li><a href="#Colors">Colors</a></li>
+<li><a href="#Strings">Strings</a></li>
+<li><a href="#Conditionals-and-Loops">Conditionals and Loops</a></li>
+<li><a href="#Writing-Macros">Writing Macros</a></li>
+<li><a href="#Page-Motions">Page Motions</a></li>
+<li><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></li>
+<li><a href="#Deferring-Output">Deferring Output</a></li>
+<li><a href="#Traps">Traps</a></li>
+<li><a href="#Diversions">Diversions</a></li>
+<li><a href="#Punning-Names">Punning Names</a></li>
+<li><a href="#Environments">Environments</a></li>
+<li><a href="#Suppressing-Output">Suppressing Output</a></li>
+<li><a href="#I_002fO">I/O</a></li>
+<li><a href="#Postprocessor-Access">Postprocessor Access</a></li>
+<li><a href="#Miscellaneous">Miscellaneous</a></li>
+<li><a href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a></li>
+<li><a href="#Debugging">Debugging</a></li>
+<li><a href="#Implementation-Differences">Implementation Differences</a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="Text">
+<div class="nav-panel">
+<p>
+Next: <a href="#Measurements" accesskey="n" rel="next">Measurements</a>, Previous: <a href="#GNU-troff-Reference" accesskey="p" rel="prev">GNU <code class="code">troff</code> Reference</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Text-1">5.1 Text</h3>
+<a class="index-entry-id" id="index-text_002c-GNU-troff-processing"></a>
+
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> was designed to take input as it would be
+composed on a typewriter, including the teletypewriters used as early
+computer terminals, and relieve the user drafting a document of concern
+with details like line length, hyphenation breaking, and the achievement
+of straight margins.  Early in its development, the program gained the
+ability to prepare output for a phototypesetter; a document could then
+be prepared for output to either a teletypewriter, a phototypesetter, or
+both.  GNU <code class="code">troff</code> continues this tradition of permitting an author
+to compose a single master version of a document which can then be
+rendered for a variety of output formats or devices.
+</p>
+<p><code class="code">roff</code> input files contain text interspersed with instructions to
+control the formatter.  Even in the absence of such instructions, GNU
+<code class="code">troff</code> still processes its input in several ways, by filling,
+hyphenating, breaking, and adjusting it, and supplementing it with
+inter-sentence space.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Filling" accesskey="1">Filling</a></li>
+<li><a href="#Sentences" accesskey="2">Sentences</a></li>
+<li><a href="#Hyphenation" accesskey="3">Hyphenation</a></li>
+<li><a href="#Breaking" accesskey="4">Breaking</a></li>
+<li><a href="#Adjustment" accesskey="5">Adjustment</a></li>
+<li><a href="#Tabs-and-Leaders" accesskey="6">Tabs and Leaders</a></li>
+<li><a href="#Requests-and-Macros" accesskey="7">Requests and Macros</a></li>
+<li><a href="#Macro-Packages" accesskey="8">Macro Packages</a></li>
+<li><a href="#Input-Encodings" accesskey="9">Input Encodings</a></li>
+<li><a href="#Input-Conventions">Input Conventions</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Filling">
+<div class="nav-panel">
+<p>
+Next: <a href="#Sentences" accesskey="n" rel="next">Sentences</a>, Previous: <a href="#Text" accesskey="p" rel="prev">Text</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Filling-1">5.1.1 Filling</h4>
+
+<p>When GNU <code class="code">troff</code> starts up, it obtains information about the device
+for which it is preparing output.<a class="footnote" id="DOCF18" href="#FOOT18"><sup>18</sup></a>  An essential property is the length of the output
+line, such as &ldquo;6.5 inches&rdquo;.
+</p>
+<a class="index-entry-id" id="index-word_002c-definition-of"></a>
+<a class="index-entry-id" id="index-filling"></a>
+<p>GNU <code class="code">troff</code> interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can&mdash;this is known as <em class="dfn">filling</em>.  To GNU
+<code class="code">troff</code>, a <em class="dfn">word</em> is any sequence of one or more characters
+that aren&rsquo;t spaces or newlines.  The exceptions separate
+words.<a class="footnote" id="DOCF19" href="#FOOT19"><sup>19</sup></a>  To disable filling, see
+<a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">It is a truth universally acknowledged
+that a single man in possession of a
+good fortune must be in want of a wife.
+    &rArr; It is a truth universally acknowledged that a
+    &rArr; single man in possession of a good fortune must
+    &rArr; be in want of a wife.
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Sentences">
+<div class="nav-panel">
+<p>
+Next: <a href="#Hyphenation" accesskey="n" rel="next">Hyphenation</a>, Previous: <a href="#Filling" accesskey="p" rel="prev">Filling</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Sentences-1">5.1.2 Sentences</h4>
+<a class="index-entry-id" id="index-sentences"></a>
+
+<p>A passionate debate has raged for decades among writers of the English
+language over whether more space should appear between adjacent
+sentences than between words within a sentence, and if so, how much, and
+what other circumstances should influence this spacing.<a class="footnote" id="DOCF20" href="#FOOT20"><sup>20</sup></a>
+GNU <code class="code">troff</code> follows the example of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>;
+it attempts to detect the boundaries between sentences, and supplies
+additional inter-sentence space between them.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Hello, world!
+Welcome to groff.
+    &rArr; Hello, world!  Welcome to groff.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-end_002dof_002dsentence-characters"></a>
+<a class="index-entry-id" id="index-sentence-space"></a>
+<a class="index-entry-id" id="index-space-between-sentences"></a>
+<a class="index-entry-id" id="index-French-spacing"></a>
+<p>GNU <code class="code">troff</code> flags certain characters (normally &lsquo;<samp class="samp">!</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;,
+and &lsquo;<samp class="samp">.</samp>&rsquo;) as potentially ending a sentence.  When GNU <code class="code">troff</code>
+encounters one of these <em class="dfn">end-of-sentence characters</em> at the end of
+an input line, or one of them is followed by two (unescaped) spaces on
+the same input line, it appends an inter-word space followed by an
+inter-sentence space in the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">R. Harper subscribes to a maxim of P. T. Barnum.
+    &rArr; R. Harper subscribes to a maxim of P. T. Barnum.
+</pre></div></div>
+
+<p>In the above example, inter-sentence space is not added after &lsquo;<samp class="samp">P.</samp>&rsquo;
+or &lsquo;<samp class="samp">T.</samp>&rsquo; because the periods do not occur at the end of an input
+line, nor are they followed by two or more spaces.  Let&rsquo;s imagine that
+we&rsquo;ve heard something about defamation from Mr. Harper&rsquo;s attorney,
+recast the sentence, and reflowed it in our text editor.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">I submit that R. Harper subscribes to a maxim of P. T.
+Barnum.
+    &rArr; I submit that R. Harper subscribes to a maxim of
+    &rArr; P. T.  Barnum.
+</pre></div></div>
+
+<p>&ldquo;Barnum&rdquo; doesn&rsquo;t begin a sentence!  What to do?  Let us meet our first
+<em class="dfn">escape sequence</em>, a series of input characters that give
+instructions to GNU <code class="code">troff</code> instead of being used to construct
+output device glyphs.<a class="footnote" id="DOCF21" href="#FOOT21"><sup>21</sup></a> An escape sequence begins with the backslash character <code class="code">\</code>
+by default, an uncommon character in natural language text, and is
+<em class="emph">always</em> followed by at least one other character, hence the term
+&ldquo;sequence&rdquo;.
+</p>
+<a class="index-entry-id" id="index-_005c_0026_002c-at-end-of-sentence"></a>
+<p>The dummy character escape sequence <code class="code">\&amp;</code> can be used after an
+end-of-sentence character to defeat end-of-sentence detection on a
+per-instance basis.  We can therefore rewrite our input more
+defensively.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">I submit that R.\&amp; Harper subscribes to a maxim of P.\&amp;
+T.\&amp; Barnum.
+    &rArr; I submit that R. Harper subscribes to a maxim of
+    &rArr; P. T. Barnum.
+</pre></div></div>
+
+<p>Adding text caused our input to wrap; now, we don&rsquo;t need <code class="code">\&amp;</code> after
+&lsquo;<samp class="samp">T.</samp>&rsquo; but we do after &lsquo;<samp class="samp">P.</samp>&rsquo;.  Consistent use of the escape
+sequence ensures that potential sentence boundaries are robust to
+editing activities.  Further advice along these lines will follow in
+<a class="ref" href="#Input-Conventions">Input Conventions</a>.
+</p>
+<a class="index-entry-id" id="index-end_002dof_002dsentence-transparent-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-end_002dof_002dsentence-transparent"></a>
+<a class="index-entry-id" id="index-dg-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-dd-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-rq-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-cq-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0022_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0027_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0029_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_005d_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_002a_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-special-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-special"></a>
+<p>Normally, the occurrence of a visible non-end-of-sentence character (as
+opposed to a space or tab) immediately after an end-of-sentence
+character cancels detection of the end of a sentence.  For example, it
+would be incorrect for GNU <code class="code">troff</code> to infer the end of a sentence
+after the dot in &lsquo;<samp class="samp">3.14159</samp>&rsquo;.  However, several characters are
+treated <em class="emph">transparently</em> after the occurrence of an end-of-sentence
+character.  That is, GNU <code class="code">troff</code> does not cancel end-of-sentence
+detection when it processes them.  This is because such characters are
+often used as footnote markers or to close quotations and
+parentheticals.  The default set is &lsquo;<samp class="samp">&quot;</samp>&rsquo;, &lsquo;<samp class="samp">'</samp>&rsquo;, &lsquo;<samp class="samp">)</samp>&rsquo;,
+&lsquo;<samp class="samp"></samp>&rsquo;, &lsquo;<samp class="samp">*</samp>&rsquo;, <code class="code">\dg</code>, <code class="code">\dd</code>, <code class="code">\rq</code>, and
+<code class="code">\cq</code>.  The last four are examples of <em class="dfn">special characters</em>,
+escape sequences whose purpose is to obtain glyphs that are not easily
+typed at the keyboard, or which have special meaning to GNU <code class="code">troff</code>
+(like <code class="code">\</code> itself).<a class="footnote" id="DOCF22" href="#FOOT22"><sup>22</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\lqThe idea that the poor should have leisure has always
+been shocking to the rich.\rq
+(Bertrand Russell, 1935)
+    &rArr; &quot;The idea that the poor should have
+    &rArr; leisure has always been shocking to
+    &rArr; the rich.&quot;  (Bertrand Russell, 1935)
+</pre></div></div>
+
+<p>The sets of characters that potentially end sentences or are transparent
+to sentence endings are configurable.  See the <code class="code">cflags</code> request in
+<a class="ref" href="#Using-Symbols">Using Symbols</a>.  To change the additional inter-sentence space
+amount&mdash;even to remove it entirely&mdash;see <a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Hyphenation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Breaking" accesskey="n" rel="next">Breaking</a>, Previous: <a href="#Sentences" accesskey="p" rel="prev">Sentences</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Hyphenation-1">5.1.3 Hyphenation</h4>
+<a class="index-entry-id" id="index-hyphenation"></a>
+
+<p>When an output line is nearly full, it is uncommon for the next word
+collected from the input to exactly fill it&mdash;typically, there is room
+left over only for part of the next word.  The process of splitting a
+word so that it appears partially on one line (with a hyphen to indicate
+to the reader that the word has been broken) with its remainder on the
+next is <em class="dfn">hyphenation</em>.  Hyphenation points can be manually
+specified; GNU <code class="code">troff</code> also uses a hyphenation algorithm and
+language-specific pattern files (based on those used in TeX) to
+decide which words can be hyphenated and where.
+</p>
+<p>Hyphenation does not always occur even when the hyphenation rules for a
+word allow it; it can be disabled, and when not disabled there are
+several parameters that can prevent it in certain circumstances.
+See <a class="xref" href="#Manipulating-Hyphenation">Manipulating Hyphenation</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Breaking">
+<div class="nav-panel">
+<p>
+Next: <a href="#Adjustment" accesskey="n" rel="next">Adjustment</a>, Previous: <a href="#Hyphenation" accesskey="p" rel="prev">Hyphenation</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Breaking-1">5.1.4 Breaking</h4>
+<a class="index-entry-id" id="index-break"></a>
+<a class="index-entry-id" id="index-implicit-line-break"></a>
+<a class="index-entry-id" id="index-line-break_002c-output"></a>
+<a class="index-entry-id" id="index-output-line-break"></a>
+
+<p>Once an output line is full, the next word (or remainder of a hyphenated
+one) is placed on a different output line; this is called a <em class="dfn">break</em>.
+In this manual and in <code class="code">roff</code> discussions generally, a &ldquo;break&rdquo; if
+not further qualified always refers to the termination of an output
+line.  When the formatter is filling text, it introduces breaks
+automatically to keep output lines from exceeding the configured line
+length.  After an automatic break, GNU <code class="code">troff</code> adjusts the line if
+applicable (see below), and then resumes collecting and filling text on
+the next output line.
+</p>
+<p>Sometimes, a line cannot be broken automatically.  This usually does
+not happen with natural language text unless the output line length has
+been manipulated to be extremely short, but it can with specialized
+text like program source code.  We can use <code class="code">perl</code> at the shell
+prompt to contrive an example of failure to break the line.  We also
+employ the <samp class="option">-z</samp> option to suppress normal output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ perl -e 'print &quot;#&quot; x 80, &quot;\n&quot;;' | nroff -z
+    error&rarr; warning: cannot break line
+</pre></div></div>
+
+<p>The remedy for these cases is to tell GNU <code class="code">troff</code> where the line
+may be broken without hyphens.  This is done with the non-printing break
+point escape sequence &lsquo;<samp class="samp">\:</samp>&rsquo;; see <a class="ref" href="#Manipulating-Hyphenation">Manipulating Hyphenation</a>.
+</p>
+<a class="index-entry-id" id="index-blank-line"></a>
+<a class="index-entry-id" id="index-empty-line"></a>
+<a class="index-entry-id" id="index-line_002c-blank"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029"></a>
+<p>What if the document author wants to stop filling lines temporarily, for
+instance to start a new paragraph?  There are several solutions.  A
+blank input line not only causes a break, but by default it also outputs
+a one-line vertical space (effectively a blank output line).  This
+behavior can be modified; see <a class="ref" href="#Blank-Line-Traps">Blank Line Traps</a>.  Macro packages
+may discourage or disable the blank line method of paragraphing in favor
+of their own macros.
+</p>
+<a class="index-entry-id" id="index-leading-spaces"></a>
+<a class="index-entry-id" id="index-spaces_002c-leading-and-trailing"></a>
+<a class="index-entry-id" id="index-trailing-spaces-on-text-lines"></a>
+<a class="index-entry-id" id="index-leading-space-macro-_0028lsm_0029"></a>
+<p>A line that begins with one or more spaces causes a break.  The spaces
+are output at the beginning of the next line without being
+<em class="emph">adjusted</em> (see below); however, this behavior can be modified
+(see <a class="pxref" href="#Leading-Space-Traps">Leading Space Traps</a>).  Again, macro packages may provide other
+methods of producing indented paragraphs.  Trailing spaces on text lines
+are discarded.<a class="footnote" id="DOCF23" href="#FOOT23"><sup>23</sup></a>
+</p>
+<p>What if the file ends before enough words have been collected to fill an
+output line?  Or the output line is exactly full but not yet broken, and
+there is no more input?  GNU <code class="code">troff</code> interprets the end of input as
+a break.  Certain requests also cause breaks, implicitly or explicitly.
+This is discussed in <a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="#Tabs-and-Leaders" accesskey="n" rel="next">Tabs and Leaders</a>, Previous: <a href="#Breaking" accesskey="p" rel="prev">Breaking</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Adjustment-1">5.1.5 Adjustment</h4>
+
+<a class="index-entry-id" id="index-extra-spaces-between-words"></a>
+<p>After GNU <code class="code">troff</code> performs an automatic break, it may then
+<em class="dfn">adjust</em> the line, widening inter-word spaces until the text reaches
+the right margin.  Extra spaces between words are preserved.  Leading
+and trailing spaces are handled as noted above.  Text can be aligned to
+the left or right margin only, or centered; see <a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Tabs-and-Leaders">
+<div class="nav-panel">
+<p>
+Next: <a href="#Input-Conventions" accesskey="n" rel="next">Input Conventions</a>, Previous: <a href="#Adjustment" accesskey="p" rel="prev">Adjustment</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Tabs-and-Leaders-1">5.1.6 Tabs and Leaders</h4>
+
+<a class="index-entry-id" id="index-horizontal-tab-character"></a>
+<a class="index-entry-id" id="index-tab-character"></a>
+<a class="index-entry-id" id="index-character_002c-horizontal-tab"></a>
+<a class="index-entry-id" id="index-leader-character"></a>
+<a class="index-entry-id" id="index-character_002c-leader"></a>
+<a class="index-entry-id" id="index-tab-stops"></a>
+<a class="index-entry-id" id="index-stops_002c-tab"></a>
+<p>GNU <code class="code">troff</code> translates input horizontal tab characters (&ldquo;tabs&rdquo;)
+and <kbd class="key">Control+A</kbd> characters (&ldquo;leaders&rdquo;) into movements to the next
+tab stop.  Tabs simply move to the next tab stop; leaders place enough
+periods to fill the space.  Tab stops are by default located every half
+inch measured from the drawing position corresponding to the beginning
+of the input line; see <a class="ref" href="#Page-Geometry">Page Geometry</a>.   Tabs and leaders do not
+cause breaks and therefore do not interrupt filling.  Below, we use
+arrows &rarr; and bullets &bull; to indicate input tabs and
+leaders, respectively.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">1
+&rarr; 2 &rarr; 3 &bull; 4
+&rarr; &bull; 5
+&rArr; 1         2       3.......4         ........5
+</pre></div></div>
+
+<p>Tabs and leaders lend themselves to table construction.<a class="footnote" id="DOCF24" href="#FOOT24"><sup>24</sup></a> The tab and leader glyphs can be
+configured, and further facilities for sophisticated table composition
+are available; see <a class="ref" href="#Tabs-and-Fields">Tabs and Fields</a>.  There are many details to
+track when using such low-level features, so most users turn to the
+<cite class="cite">tbl<span class="r">(1)</span></cite> preprocessor to lay out tables.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Requests-and-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="#Macro-Packages" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="#Tabs-and-Leaders" accesskey="p" rel="prev">Tabs and Leaders</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Requests-and-Macros-1">5.1.7 Requests and Macros</h4>
+
+<p>We have now encountered almost all of the syntax there is in the
+<code class="code">roff</code> language, with an exception already noted in passing.
+<a class="index-entry-id" id="index-request"></a>
+<a class="index-entry-id" id="index-control-character-_0028_002e_0029"></a>
+<a class="index-entry-id" id="index-character_002c-control-_0028_002e_0029"></a>
+<a class="index-entry-id" id="index-no_002dbreak-control-character-_0028_0027_0029"></a>
+<a class="index-entry-id" id="index-character_002c-no_002dbreak-control-_0028_0027_0029"></a>
+<a class="index-entry-id" id="index-control-character_002c-no_002dbreak-_0028_0027_0029"></a>
+A <em class="dfn">request</em> is an instruction to the formatter that occurs after a
+<em class="dfn">control character</em>, which is recognized at the beginning of an
+input line.  The regular control character is a dot (<code class="code">.</code>).  Its
+counterpart, the <em class="dfn">no-break control character</em>, a neutral apostrophe
+(<code class="code">'</code>), suppresses the break that is implied by some requests.
+These characters were chosen because it is uncommon for lines of text in
+natural languages to begin with them.
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-as-control-character-suppressor"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-as-control-character-suppressor"></a>
+If you require a formatted period or apostrophe (closing single
+quotation mark) where GNU <code class="code">troff</code> is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence, &lsquo;<samp class="samp">\&amp;</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-control-line"></a>
+<p>An input line beginning with a control character is called a
+<em class="dfn">control line</em>.
+<a class="index-entry-id" id="index-text-line"></a>
+Every line of input that is not a control line is a <em class="dfn">text
+line</em>.<a class="footnote" id="DOCF25" href="#FOOT25"><sup>25</sup></a>
+</p>
+<a class="index-entry-id" id="index-argument"></a>
+<p>Requests often take <em class="dfn">arguments</em>, words (separated from the request
+name and each other by spaces) that specify details of the action GNU
+<code class="code">troff</code> is expected to perform.  If a request is meaningless
+without arguments, it is typically ignored.
+</p>
+<p>GNU <code class="code">troff</code>&rsquo;s requests and escape sequences comprise the control
+language of the formatter.  Of key importance are the requests that
+define macros.  Macros are invoked like requests, enabling the request
+repertoire to be extended or overridden.<a class="footnote" id="DOCF26" href="#FOOT26"><sup>26</sup></a>
+</p>
+<a class="index-entry-id" id="index-macro"></a>
+<a class="index-entry-id" id="index-calling-a-macro"></a>
+<a class="index-entry-id" id="index-interpolation"></a>
+<p>A <em class="dfn">macro</em> can be thought of as an abbreviation you can define for a
+collection of control and text lines.  When the macro is <em class="dfn">called</em> by
+giving its name after a control character, it is replaced with what it
+stands for.  The process of textual replacement is known as
+<em class="dfn">interpolation</em>.<a class="footnote" id="DOCF27" href="#FOOT27"><sup>27</sup></a>  Interpolations are handled as soon as they are
+recognized, and once performed, a <code class="code">roff</code> formatter scans the
+replacement for further requests, macro calls, and escape sequences.
+</p>
+<p>In <code class="code">roff</code> systems, the <code class="code">de</code> request defines a
+macro.<a class="footnote" id="DOCF28" href="#FOOT28"><sup>28</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de DATE
+2020-11-14
+..
+</pre></div></div>
+
+<p>The foregoing input produces no output by itself; all we have done is
+store some information.  Observe the pair of dots that ends the macro
+definition.  This is a default; you can specify your own terminator for
+the macro definition as the second argument to the <code class="code">de</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de NAME ENDNAME
+Heywood Jabuzzoff
+.ENDNAME
+</pre></div></div>
+
+<p>In fact, the ending marker is itself the name of a macro to be
+called, or a request to be invoked, if it is defined at the time its
+control line is read.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de END
+Big Rip
+..
+.de START END
+Big Bang
+.END
+.START
+    &rArr; Big Rip Big Bang
+</pre></div></div>
+
+<p>In the foregoing example, &ldquo;Big Rip&rdquo; printed before &ldquo;Big Bang&rdquo;
+because its macro was <em class="emph">called</em> first.  Consider what would happen
+if we dropped <code class="code">END</code> from the &lsquo;<samp class="samp">.de START</samp>&rsquo; line and added
+<code class="code">..</code> after <code class="code">.END</code>.  Would the order change?
+</p>
+<p>Let us consider a more elaborate example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de DATE
+2020-10-05
+..
+.
+.de BOSS
+D.\&amp; Kruger,
+J.\&amp; Peterman
+..
+.
+.de NOTICE
+Approved:
+.DATE
+by
+.BOSS
+..
+.
+Insert tedious regulatory compliance paragraph here.
+
+.NOTICE
+
+Insert tedious liability disclaimer paragraph here.
+
+.NOTICE
+    &rArr; Insert tedious regulatory compliance paragraph here.
+    &rArr;
+    &rArr; Approved: 2020-10-05 by D. Kruger, J. Peterman
+    &rArr;
+    &rArr; Insert tedious liability disclaimer paragraph here.
+    &rArr;
+    &rArr; Approved: 2020-10-05 by D. Kruger, J. Peterman
+</pre></div></div>
+
+<p>The above document started with a series of control lines.  Three macros
+were defined, with a <code class="code">de</code> request declaring each macro&rsquo;s name, and
+the &ldquo;body&rdquo; of the macro starting on the next line and continuing until
+a line with two dots &lsquo;<samp class="samp"><code class="code">..</code></samp>&rsquo; marked its end.  The text proper
+began only after the macros were defined; this is a common pattern.
+Only the <code class="code">NOTICE</code> macro was called &ldquo;directly&rdquo; by the document;
+<code class="code">DATE</code> and <code class="code">BOSS</code> were called only by <code class="code">NOTICE</code> itself.
+Escape sequences were used in <code class="code">BOSS</code>, two levels of macro
+interpolation deep.
+</p>
+<p>The advantage in typing and maintenance economy may not be obvious from
+such a short example, but imagine a much longer document with dozens of
+such paragraphs, each requiring a notice of managerial approval.
+Consider what must happen if you are in charge of generating a new
+version of such a document with a different date, for a different boss.
+With well-chosen macros, you only have to change each datum in one
+place.
+</p>
+<p>In practice, we would probably use strings (see <a class="pxref" href="#Strings">Strings</a>) instead of
+macros for such simple interpolations; what is important here is to
+glimpse the potential of macros and the power of recursive
+interpolation.
+</p>
+<p>We could have defined <code class="code">DATE</code> and <code class="code">BOSS</code> in the opposite order;
+perhaps less obviously, we could also have defined them <em class="emph">after</em>
+<code class="code">NOTICE</code>.  &ldquo;Forward references&rdquo; like this are acceptable because
+the body of a macro definition is not (completely) interpreted, but
+stored instead (see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).  While a macro is being defined (or
+appended to), requests are not interpreted and macros not interpolated,
+whereas some commonly used escape sequences <em class="emph">are</em> interpreted.
+<code class="code">roff</code> systems also support recursive macro calls, as long as you
+have a way to break the recursion (see <a class="pxref" href="#Conditionals-and-Loops">Conditionals and Loops</a>).
+Maintainable <code class="code">roff</code> documents tend to arrange macro definitions to
+minimize forward references.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Macro-Packages">
+<div class="nav-panel">
+<p>
+Next: <a href="#Input-Encodings" accesskey="n" rel="next">Input Encodings</a>, Previous: <a href="#Requests-and-Macros" accesskey="p" rel="prev">Requests and Macros</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Macro-Packages-3">5.1.8 Macro Packages</h4>
+<a class="index-entry-id" id="index-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro"></a>
+
+<p>Macro definitions can be collected into <em class="dfn">macro files</em>, <code class="code">roff</code>
+input files designed to produce no output themselves but instead ease
+the preparation of other <code class="code">roff</code> documents.  There is no syntactical
+difference between a macro file and any other <code class="code">roff</code> document; only
+its purpose distinguishes it.  When a macro file is installed at a
+standard location and suitable for use by a general audience, it is
+often termed a <em class="dfn">macro package</em>.<a class="footnote" id="DOCF29" href="#FOOT29"><sup>29</sup></a>  Macro packages can be
+loaded by supplying the <samp class="option">-m</samp> option to GNU <code class="command">troff</code> or a
+<code class="code">groff</code> front end.  Alternatively, a document requiring a macro
+package can load it with the <code class="code">mso</code> (&ldquo;macro source&rdquo;) request.
+</p>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Input-Encodings">
+<div class="nav-panel">
+<p>
+Next: <a href="#Input-Conventions" accesskey="n" rel="next">Input Conventions</a>, Previous: <a href="#Macro-Packages" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Input-Encodings-1">5.1.9 Input Encodings</h4>
+
+<p>The <code class="command">groff</code> command&rsquo;s <samp class="option">-k</samp> option calls the
+<code class="command">preconv</code> preprocessor to perform input character encoding
+conversions.  Input to the GNU <code class="code">troff</code> formatter itself, on the
+other hand, must be in one of two encodings it can recognize.
+</p>
+<dl class="table">
+<dt id='index-encoding_002c-input_002c-EBCDIC'><span><code class="code">cp1047</code><a class="copiable-link" href='#index-encoding_002c-input_002c-EBCDIC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EBCDIC_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-EBCDIC"></a>
+<a class="index-entry-id" id="index-encoding_002c-input_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-code-page-1047_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-IBM-code-page-1047-input-encoding"></a>
+<a class="index-entry-id" id="index-cp1047_002etmac"></a>
+<p>The code page 1047 input encoding works only on <abbr class="acronym">EBCDIC</abbr>
+platforms (and conversely, the other input encodings don&rsquo;t work with
+<abbr class="acronym">EBCDIC</abbr>); the file <samp class="file">cp1047.tmac</samp> is loaded at startup.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029'><span><code class="code">latin1</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d1-_0028ISO-8859_002d1_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d1-_0028Latin_002d1_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029"></a>
+<a class="index-entry-id" id="index-latin1_002etmac"></a>
+<p>ISO <span class="w-nolinebreak-text">Latin-1</span>, an encoding for Western European languages, is the
+default input encoding on non-<abbr class="acronym">EBCDIC</abbr> platforms; the file
+<samp class="file">latin1.tmac</samp> is loaded at startup.
+</p></dd>
+</dl>
+
+<p>Any document that is encoded in ISO 646:1991 (a descendant of USAS
+<span class="w-nolinebreak-text">X3.4-1968</span> or &ldquo;US-ASCII&rdquo;), or, equivalently, uses only code points
+from the &ldquo;C0 Controls&rdquo; and &ldquo;Basic Latin&rdquo; parts of the Unicode
+character set is also a valid ISO <span class="w-nolinebreak-text">Latin-1</span> document; the standards
+are interchangeable in their first 128 code points.<a class="footnote" id="DOCF30" href="#FOOT30"><sup>30</sup></a>
+</p>
+<p>Other encodings are supported by means of macro packages.
+</p>
+<dl class="table">
+<dt id='index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029'><span><code class="code">latin2</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d2-_0028ISO-8859_002d2_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d2-_0028Latin_002d2_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d2-_0028ISO-8859_002d2_0029"></a>
+<a class="index-entry-id" id="index-latin2_002etmac"></a>
+<p>To use ISO <span class="w-nolinebreak-text">Latin-2</span>, an encoding for Central and Eastern European
+languages, invoke &lsquo;<samp class="samp">.mso&nbsp;latin2.tmac</samp>&rsquo; at the beginning of your
+document or supply &lsquo;<samp class="samp">-mlatin2</samp>&rsquo; as a command-line argument to
+<code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029'><span><code class="code">latin5</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d5-_0028ISO-8859_002d9_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d9-_0028Latin_002d5_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d5-_0028ISO-8859_002d9_0029"></a>
+<a class="index-entry-id" id="index-latin5_002etmac"></a>
+<p>To use ISO <span class="w-nolinebreak-text">Latin-5</span>, an encoding for the Turkish language, invoke
+&lsquo;<samp class="samp">.mso&nbsp;latin5.tmac</samp>&rsquo; at the beginning of your document or
+supply &lsquo;<samp class="samp">-mlatin5</samp>&rsquo; as a command-line argument to <code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029'><span><code class="code">latin9</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d9-_0028ISO-8859_002d15_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d15-_0028Latin_002d9_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d9-_0028ISO-8859_002d15_0029"></a>
+<a class="index-entry-id" id="index-latin9_002etmac"></a>
+<p>ISO <span class="w-nolinebreak-text">Latin-9</span> succeeds <span class="w-nolinebreak-text">Latin-1</span>; it includes a Euro sign and better
+glyph coverage for French.  To use this encoding, invoke &lsquo;<samp class="samp">.mso&nbsp;latin9.tmac</samp>&rsquo; at the beginning of your document or supply
+&lsquo;<samp class="samp">-mlatin9</samp>&rsquo; as a command-line argument to <code class="code">groff</code>.
+</p></dd>
+</dl>
+
+<p>Some characters from an input encoding may not be available with a
+particular output driver, or their glyphs may not have representation in
+the font used.  For terminal devices, fallbacks are defined, like
+&lsquo;<samp class="samp">EUR</samp>&rsquo; for the Euro sign and &lsquo;<samp class="samp">(C)</samp>&rsquo; for the copyright sign.  For
+typesetter devices, you may need to &ldquo;mount&rdquo; fonts that support glyphs
+required by the document.  See <a class="xref" href="#Font-Positions">Font Positions</a>.
+</p>
+<a class="index-entry-id" id="index-freeeuro_002epfa"></a>
+<a class="index-entry-id" id="index-ec_002etmac"></a>
+<p>Because a Euro glyph was not historically defined in PostScript fonts,
+<code class="code">groff</code> comes with a font called <samp class="file">freeeuro.pfa</samp> that provides
+the Euro in several styles.  Standard PostScript fonts contain the
+glyphs from <span class="w-nolinebreak-text">Latin-5</span> and <span class="w-nolinebreak-text">Latin-9</span> that <span class="w-nolinebreak-text">Latin-1</span> lacks, so these
+encodings are supported for the <samp class="option">ps</samp> and <samp class="option">pdf</samp> output
+devices as <code class="code">groff</code> ships, while <span class="w-nolinebreak-text">Latin-2</span> is not.
+</p>
+<p>Unicode supports characters from all other input encodings; the
+<samp class="option">utf8</samp> output driver for terminals therefore does as well.  The
+DVI output driver supports the <span class="w-nolinebreak-text">Latin-2</span> and <span class="w-nolinebreak-text">Latin-9</span> encodings if
+the command-line option <samp class="option">-mec</samp> is used as well.  <a class="footnote" id="DOCF31" href="#FOOT31"><sup>31</sup></a>
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Input-Conventions">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Input-Encodings" accesskey="p" rel="prev">Input Encodings</a>, Up: <a href="#Text" accesskey="u" rel="up">Text</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Input-Conventions-1">5.1.10 Input Conventions</h4>
+<a class="index-entry-id" id="index-input-conventions"></a>
+<a class="index-entry-id" id="index-conventions-for-input"></a>
+
+<p>Since GNU <code class="code">troff</code> fills text automatically, it is common practice
+in the <code class="code">roff</code> language to avoid visual composition of text in input
+files: the esthetic appeal of the formatted output is what matters.
+Therefore, <code class="code">roff</code> input should be arranged such that it is easy for
+authors and maintainers to compose and develop the document, understand
+the syntax of <code class="code">roff</code> requests, macro calls, and preprocessor
+languages used, and predict the behavior of the formatter.  Several
+traditions have accrued in service of these goals.
+</p>
+<ul class="itemize mark-bullet">
+<li>Follow sentence endings in the input with newlines to ease their
+recognition (see <a class="pxref" href="#Sentences">Sentences</a>).  It is frequently convenient to end
+text lines after colons and semicolons as well, as these typically
+precede independent clauses.  Consider doing so after commas; they often
+occur in lists that become easy to scan when itemized by line, or
+constitute supplements to the sentence that are added, deleted, or
+updated to clarify it.  Parenthetical and quoted phrases are also good
+candidates for placement on text lines by themselves.
+
+</li><li>Set your text editor&rsquo;s line length to 72 characters or
+fewer.<a class="footnote" id="DOCF32" href="#FOOT32"><sup>32</sup></a>
+This limit, combined with the previous item of advice, makes it less
+common that an input line will wrap in your text editor, and thus will
+help you perceive excessively long constructions in your text.  Recall
+that natural languages originate in speech, not writing, and that
+punctuation is correlated with pauses for breathing and changes in
+prosody.
+
+</li><li>Use <code class="code">\&amp;</code> after &lsquo;<samp class="samp">!</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;, and &lsquo;<samp class="samp">.</samp>&rsquo; if they are
+followed by space, tab, or newline characters and don&rsquo;t end a sentence.
+
+</li><li>In filled text lines, use <code class="code">\&amp;</code> before &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">'</samp>&rsquo; if they
+are preceded by space, so that reflowing the input doesn&rsquo;t turn them
+into control lines.
+
+</li><li>Do not use spaces to perform indentation or align columns of a table.
+Leading spaces are reliable when text is not being filled.
+
+</li><li>Comment your document.  It is never too soon to apply comments to
+record information of use to future document maintainers (including your
+future self).  We thus introduce another escape sequence, <code class="code">\&quot;</code>,
+which causes GNU <code class="code">troff</code> to ignore the remainder of the input line.
+
+</li><li>Use the empty request&mdash;a control character followed immediately by a
+newline&mdash;to visually manage separation of material in input files.
+Many of the <code class="code">groff</code> project&rsquo;s own documents use an empty request
+between sentences, after macro definitions, and where a break is
+expected, and two empty requests between paragraphs or other requests or
+macro calls that will introduce vertical space into the document.
+
+<p>You can combine the empty request with the comment escape sequence to
+include whole-line comments in your document, and even &ldquo;comment out&rdquo;
+sections of it.
+</p></li></ul>
+
+<p>We conclude this section with an example sufficiently long to illustrate
+most of the above suggestions in practice.  For the purpose of fitting
+the example between the margins of this manual with the font used for
+its typeset version, we have shortened the input line length to 56
+columns.  As before, an arrow &rarr; indicates a tab character.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.\&quot;   nroff this_file.roff | less
+.\&quot;   groff -T ps this_file.roff &gt; this_file.ps
+&rarr;The theory of relativity is intimately connected with
+the theory of space and time.
+.
+I shall therefore begin with a brief investigation of
+the origin of our ideas of space and time,
+although in doing so I know that I introduce a
+controversial subject.  \&quot; remainder of paragraph elided
+.
+.
+
+&rarr;The experiences of an individual appear to us arranged
+in a series of events;
+in this series the single events which we remember
+appear to be ordered according to the criterion of
+\lqearlier\rq and \lqlater\rq, \&quot; punct swapped
+which cannot be analysed further.
+.
+There exists,
+therefore,
+for the individual,
+an I-time,
+or subjective time.
+.
+This itself is not measurable.
+.
+I can,
+indeed,
+associate numbers with the events,
+in such a way that the greater number is associated with
+the later event than with an earlier one;
+but the nature of this association may be quite
+arbitrary.
+.
+This association I can define by means of a clock by
+comparing the order of events furnished by the clock
+with the order of a given series of events.
+.
+We understand by a clock something which provides a
+series of events which can be counted,
+and which has other properties of which we shall speak
+later.
+.\&quot; Albert Einstein, _The Meaning of Relativity_, 1922
+</pre></div>
+</td></tr></table>
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Page-Geometry">
+<div class="nav-panel">
+<p>
+Next: <a href="#Measurements" accesskey="n" rel="next">Measurements</a>, Previous: <a href="#Text" accesskey="p" rel="prev">Text</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Page-Geometry-1">5.2 Page Geometry</h3>
+<a class="index-entry-id" id="index-page_002c-geometry-of"></a>
+<a class="index-entry-id" id="index-geometry_002c-page"></a>
+
+<p><code class="code">roff</code> systems format text under certain assumptions about the size
+of the output medium, or page.  For the formatter to correctly break a
+line it is filling, it must know the line length, which it derives from
+the page width (see <a class="pxref" href="#Line-Layout">Line Layout</a>).  For it to decide whether to write
+an output line to the current page or wait until the next one, it must
+know the page length (see <a class="pxref" href="#Page-Layout">Page Layout</a>).
+</p>
+<a class="index-entry-id" id="index-device-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-device"></a>
+<a class="index-entry-id" id="index-basic-units"></a>
+<a class="index-entry-id" id="index-units_002c-basic"></a>
+<a class="index-entry-id" id="index-machine-units"></a>
+<a class="index-entry-id" id="index-units_002c-machine"></a>
+<p>A device&rsquo;s <em class="dfn">resolution</em> converts practical units like inches or
+centimeters to <em class="dfn">basic units</em>, a convenient length measure for the
+output device or file format.  The formatter and output driver use basic
+units to reckon page measurements.  The device description file defines
+its resolution and page dimensions (see <a class="pxref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>).
+</p>
+<a class="index-entry-id" id="index-page"></a>
+<p>A <em class="dfn">page</em> is a two-dimensional structure upon which a <code class="code">roff</code>
+system imposes a rectangular coordinate system with its upper left
+corner as the origin.  Coordinate values are in basic units and increase
+down and to the right.  Useful ones are therefore always positive and
+within numeric ranges corresponding to the page boundaries.
+</p>
+<a class="index-entry-id" id="index-drawing-position"></a>
+<a class="index-entry-id" id="index-position_002c-drawing"></a>
+<p>While the formatter (and, later, output driver) is processing a page, it
+keeps track of its <em class="dfn">drawing position</em>, which is the location at
+which the next glyph will be written, from which the next motion will be
+measured, or where a geometric object will commence rendering.
+<a class="index-entry-id" id="index-text-baseline"></a>
+<a class="index-entry-id" id="index-baseline_002c-text"></a>
+Notionally, glyphs are drawn from the text baseline upward and to the
+right.<a class="footnote" id="DOCF33" href="#FOOT33"><sup>33</sup></a>  The <em class="dfn">text baseline</em> is a (usually invisible) line upon
+which the glyphs of a typeface are aligned.  A glyph therefore
+&ldquo;starts&rdquo; at its bottom-left corner.  If drawn at the origin, a typical
+letter glyph would lie partially or wholly off the page, depending on
+whether, like &ldquo;g&rdquo;, it features a descender below the baseline.
+</p>
+<a class="index-entry-id" id="index-page-offset"></a>
+<a class="index-entry-id" id="index-offset_002c-page"></a>
+<p>Such a situation is nearly always undesirable.  It is furthermore
+conventional not to write or draw at the extreme edges of the page.
+Therefore the initial drawing position of a <code class="code">roff</code> formatter is not
+at the origin, but below and to the right of it.  This rightward shift
+from the left edge is known as the <em class="dfn">page
+offset</em>.<a class="footnote" id="DOCF34" href="#FOOT34"><sup>34</sup></a>  The downward shift leaves room for a text output
+line.
+</p>
+<p>Text is arranged on a one-dimensional lattice of text baselines from the
+top to the bottom of the page.
+<a class="index-entry-id" id="index-vertical-spacing"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical"></a>
+<a class="index-entry-id" id="index-vee"></a>
+<em class="dfn">Vertical spacing</em> is the distance between adjacent text baselines.
+Typographic tradition sets this quantity to 120% of the type size.  The
+initial drawing position is one unit of vertical spacing below the page
+top.  Typographers term this unit a <i class="slanted">vee</i>.
+</p>
+<a class="index-entry-id" id="index-page-break"></a>
+<a class="index-entry-id" id="index-break_002c-page"></a>
+<a class="index-entry-id" id="index-page-ejection"></a>
+<a class="index-entry-id" id="index-ejection_002c-page"></a>
+<p>Vertical spacing has an impact on page-breaking decisions.  Generally,
+when a break occurs, the formatter moves the drawing position to the
+next text baseline automatically.  If the formatter were already writing
+to the last line that would fit on the page, advancing by one vee would
+place the next text baseline off the page.  Rather than let that happen,
+<code class="code">roff</code> formatters instruct the output driver to eject the page,
+start a new one, and again set the drawing position to one vee below the
+page top; this is a <em class="dfn">page break</em>.
+</p>
+<p>When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one.  Macro packages keep
+users from having to confront this difficulty by setting &ldquo;traps&rdquo;
+(see <a class="pxref" href="#Traps">Traps</a>); moreover, all but the simplest page layouts tend to
+have headers and footers, or at least bear vertical margins larger than
+one vee.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Measurements">
+<div class="nav-panel">
+<p>
+Next: <a href="#Numeric-Expressions" accesskey="n" rel="next">Numeric Expressions</a>, Previous: <a href="#Text" accesskey="p" rel="prev">Text</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Measurements-1">5.3 Measurements</h3>
+<a class="index-entry-id" id="index-measurements"></a>
+<a class="index-entry-id" id="index-scaling-indicator"></a>
+<a class="index-entry-id" id="index-indicator_002c-scaling"></a>
+
+<a class="index-entry-id" id="index-units-of-measurement"></a>
+<a class="index-entry-id" id="index-measurement-units"></a>
+<p>The formatter sometimes requires the input of numeric parameters to
+specify measurements.  These are specified as integers or decimal
+fractions with an optional <em class="dfn">scaling unit</em> suffixed.  A scaling unit
+is a letter that immediately follows the last digit of a number.  Digits
+after the decimal point are optional.  Measurement expressions include
+&lsquo;<samp class="samp">10.5p</samp>&rsquo;, &lsquo;<samp class="samp">11i</samp>&rsquo;, and &lsquo;<samp class="samp">3.c</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-basic-units_002c-conversion-to"></a>
+<a class="index-entry-id" id="index-units_002c-basic_002c-conversion-to"></a>
+<a class="index-entry-id" id="index-conversion-to-basic-units"></a>
+<p>Measurements are scaled by the scaling unit and stored internally (with
+any fractional part discarded) in basic units.
+<a class="index-entry-id" id="index-device-resolution_002c-obtaining-in-the-formatter"></a>
+<a class="index-entry-id" id="index-resolution_002c-device_002c-obtaining-in-the-formatter"></a>
+The device resolution can therefore be obtained by storing a value of
+&lsquo;<samp class="samp">1i</samp>&rsquo; to a register.  The only constraint on the basic unit is that
+it is at least as small as any other unit.
+</p>
+<dl class="table">
+<dd><a class="index-entry-id" id="index-basic-scaling-unit-_0028u_0029"></a>
+<a class="index-entry-id" id="index-u-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-u"></a>
+<a class="index-entry-id" id="index-scaling-unit-u"></a>
+</dd>
+<dt><code class="code">u</code></dt>
+<dd><p>Basic unit.
+</p>
+</dd>
+<dt id='index-inch-scaling-unit-_0028i_0029'><span><code class="code">i</code><a class="copiable-link" href='#index-inch-scaling-unit-_0028i_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-i-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-i"></a>
+<a class="index-entry-id" id="index-scaling-unit-i"></a>
+<p>Inch; defined as 2.54&nbsp;centimeters.
+</p>
+</dd>
+<dt id='index-centimeter-scaling-unit-_0028c_0029'><span><code class="code">c</code><a class="copiable-link" href='#index-centimeter-scaling-unit-_0028c_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-c-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-c"></a>
+<a class="index-entry-id" id="index-scaling-unit-c"></a>
+<p>Centimeter; a centimeter is about 0.3937&nbsp;inches.
+</p>
+</dd>
+<dt id='index-point-scaling-unit-_0028p_0029'><span><code class="code">p</code><a class="copiable-link" href='#index-point-scaling-unit-_0028p_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-p-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-p"></a>
+<a class="index-entry-id" id="index-scaling-unit-p"></a>
+<p>Point; a typesetter&rsquo;s unit used for measuring type size.
+There are 72&nbsp;points to an inch.
+</p>
+</dd>
+<dt id='index-pica-scaling-unit-_0028P_0029'><span><code class="code">P</code><a class="copiable-link" href='#index-pica-scaling-unit-_0028P_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-P-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-P"></a>
+<a class="index-entry-id" id="index-scaling-unit-P"></a>
+<p>Pica; another typesetter&rsquo;s unit.  There are 6&nbsp;picas to an inch and
+12&nbsp;points to a pica.
+</p>
+</dd>
+<dt><code class="code">s</code></dt>
+<dt><code class="code">z</code></dt>
+<dd><p>See <a class="xref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>, for a discussion of these units.
+</p>
+</dd>
+<dt><code class="code">f</code></dt>
+<dd><p>GNU <code class="code">troff</code> defines this unit to scale decimal fractions in the
+interval 0, 1 to 16-bit unsigned integers.  It multiplies a quantity
+by 65,536.  See <a class="xref" href="#Colors">Colors</a>, for usage.
+</p></dd>
+</dl>
+
+<p>The magnitudes of other scaling units depend on the text formatting
+parameters in effect.  These are useful when specifying measurements
+that need to scale with the typeface or vertical spacing.
+</p>
+<dl class="table">
+<dt id='index-em-scaling-unit-_0028m_0029'><span><code class="code">m</code><a class="copiable-link" href='#index-em-scaling-unit-_0028m_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-m-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-m"></a>
+<a class="index-entry-id" id="index-scaling-unit-m"></a>
+<p>Em; an em is equal to the current type size in points.  It is named thus
+because it is approximately the width of the letter&nbsp;&lsquo;<samp class="samp">M</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-en-scaling-unit-_0028n_0029'><span><code class="code">n</code><a class="copiable-link" href='#index-en-scaling-unit-_0028n_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-n-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-n"></a>
+<a class="index-entry-id" id="index-scaling-unit-n"></a>
+<p>En; an en is one-half em.
+</p>
+</dd>
+<dt id='index-vertical-space-unit-_0028v_0029'><span><code class="code">v</code><a class="copiable-link" href='#index-vertical-space-unit-_0028v_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-space_002c-vertical_002c-unit-_0028v_0029"></a>
+<a class="index-entry-id" id="index-vee-scaling-unit-_0028v_0029"></a>
+<a class="index-entry-id" id="index-v-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-v"></a>
+<a class="index-entry-id" id="index-scaling-unit-v"></a>
+<p>Vee; recall <a class="ref" href="#Page-Geometry">Page Geometry</a>.
+</p>
+</dd>
+<dt id='index-M-scaling-unit'><span><code class="code">M</code><a class="copiable-link" href='#index-M-scaling-unit'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-unit_002c-scaling_002c-M"></a>
+<a class="index-entry-id" id="index-scaling-unit-M"></a>
+<p>Hundredth of an em.
+</p></dd>
+</dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Motion-Quanta" accesskey="1">Motion Quanta</a></li>
+<li><a href="#Default-Units" accesskey="2">Default Units</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Motion-Quanta">
+<div class="nav-panel">
+<p>
+Next: <a href="#Default-Units" accesskey="n" rel="next">Default Units</a>, Previous: <a href="#Measurements" accesskey="p" rel="prev">Measurements</a>, Up: <a href="#Measurements" accesskey="u" rel="up">Measurements</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Motion-Quanta-1">5.3.1 Motion Quanta</h4>
+<a class="index-entry-id" id="index-motion-quanta"></a>
+<a class="index-entry-id" id="index-quanta_002c-motion"></a>
+
+<p>An output device&rsquo;s basic unit <code class="code">u</code> is not necessarily its smallest
+addressable length; <code class="code">u</code> can be smaller to avoid problems with
+integer roundoff.  The minimum distances that a device can work with in
+the horizontal and vertical directions are termed its <em class="dfn">motion
+quanta</em>.  Measurements are rounded to applicable motion quanta.
+Half-quantum fractions round toward zero.
+</p>
+<a class="index-entry-id" id="index-horizontal-motion-quantum-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-horizontal_002c-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-horizontal-resolution-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-resolution_002c-horizontal_002c-register-_0028_002eH_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eH_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.H</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eH"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eV_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.V</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eV_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eV"></a>
+<p>These read-only registers interpolate the horizontal and vertical motion
+quanta, respectively, of the output device in basic units.
+</p></dd></dl>
+
+<p>For example, we might draw short baseline rules on a terminal device as
+follows.  See <a class="xref" href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tm \n.H
+    error&rarr; 24
+.nf
+\l'36u' 36u
+\l'37u' 37u
+    &rArr; _ 36u
+    &rArr; __ 37u
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Default-Units">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Motion-Quanta" accesskey="p" rel="prev">Motion Quanta</a>, Up: <a href="#Measurements" accesskey="u" rel="up">Measurements</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Default-Units-1">5.3.2 Default Units</h4>
+<a class="index-entry-id" id="index-default-units"></a>
+<a class="index-entry-id" id="index-units_002c-default"></a>
+
+<p>A general-purpose register (one created or updated with the <code class="code">nr</code>
+request; see see <a class="pxref" href="#Registers">Registers</a>) is implicitly dimensionless, or reckoned
+in basic units if interpreted in a measurement context.  But it is
+convenient for many requests and escape sequences to infer a scaling
+unit for an argument if none is specified.  An explicit scaling unit
+(not after a closing parenthesis) can override an undesirable default.
+Effectively, the default unit is suffixed to the expression if a scaling
+unit is not already present.  GNU <code class="code">troff</code>&rsquo;s use of integer
+arithmetic should also be kept in mind (see <a class="pxref" href="#Numeric-Expressions">Numeric Expressions</a>).
+</p>
+<p>The <code class="code">ll</code> request interprets its argument in ems by default.
+Consider several attempts to set a line length of 3.5&nbsp;inches when
+the type size is 10&nbsp;points on a terminal device with a resolution
+of 240 basic units and horizontal motion quantum of 24.  Some
+expressions become zero; the request clamps them to that quantum.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 3.5i      \&quot; 3.5i (= 840u)
+.ll 7/2       \&quot; 7u/2u -&gt; 3u -&gt; 3m -&gt; 0, clamped to 24u
+.ll (7 / 2)u  \&quot; 7u/2u -&gt; as above
+.ll 7/2i      \&quot; 7u/2i -&gt; 7u/480u -&gt; 0 -&gt; as above
+.ll 7i/2      \&quot; 7i/2u -&gt; 1680u/2m -&gt; 1680u/24u -&gt; 35u
+.ll 7i/2u     \&quot; 3.5i (= 840u)
+</pre></div></div>
+
+<a class="index-entry-id" id="index-measurements_002c-specifying-safely"></a>
+<p>The safest way to specify measurements is to attach a scaling unit.  To
+multiply or divide by a dimensionless quantity, use &lsquo;<samp class="samp">u</samp>&rsquo; as its
+scaling unit.
+</p>
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Numeric-Expressions">
+<div class="nav-panel">
+<p>
+Next: <a href="#Identifiers" accesskey="n" rel="next">Identifiers</a>, Previous: <a href="#Measurements" accesskey="p" rel="prev">Measurements</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Numeric-Expressions-1">5.4 Numeric Expressions</h3>
+<a class="index-entry-id" id="index-numeric-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-numeric"></a>
+
+<p>A <em class="dfn">numeric expression</em> evaluates to an integer: it can be as
+simple as a literal &lsquo;<samp class="samp">0</samp>&rsquo; or it can be a complex sequence of register
+and string interpolations interleaved with measurements and operators.
+</p>
+<p>GNU <code class="code">troff</code> provides a set of mathematical and logical operators
+familiar to programmers&mdash;as well as some unusual ones&mdash;but supports
+only integer arithmetic.<a class="footnote" id="DOCF35" href="#FOOT35"><sup>35</sup></a>  The internal data type
+used for computing results is usually a 32-bit signed integer, which
+suffices to represent magnitudes within a range of ±2
+billion.<a class="footnote" id="DOCF36" href="#FOOT36"><sup>36</sup></a>
+</p>
+<a class="index-entry-id" id="index-arithmetic-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-arithmetic"></a>
+<a class="index-entry-id" id="index-truncating-division"></a>
+<a class="index-entry-id" id="index-addition"></a>
+<a class="index-entry-id" id="index-subtraction"></a>
+<a class="index-entry-id" id="index-multiplication"></a>
+<a class="index-entry-id" id="index-division_002c-truncating"></a>
+<a class="index-entry-id" id="index-modulus"></a>
+<a class="index-entry-id" id="index-_002b"></a>
+<a class="index-entry-id" id="index-_002d"></a>
+<a class="index-entry-id" id="index-_002a"></a>
+<a class="index-entry-id" id="index-_002f"></a>
+<a class="index-entry-id" id="index-_0025"></a>
+<p>Arithmetic infix operators perform a function on the numeric expressions
+to their left and right; they are <code class="code">+</code> (addition), <code class="code">-</code>
+(subtraction), <code class="code">*</code> (multiplication), <code class="code">/</code> (truncating
+division), and <code class="code">%</code> (modulus).  <em class="dfn">Truncating division</em> rounds to
+the integer nearer to zero, no matter how large the fractional portion.
+Overflow and division (or modulus) by zero are errors and abort
+evaluation of a numeric expression.
+<a class="index-entry-id" id="index-unary-arithmetic-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-unary-arithmetic"></a>
+<a class="index-entry-id" id="index-negation"></a>
+<a class="index-entry-id" id="index-assertion-_0028arithmetic-operator_0029"></a>
+<a class="index-entry-id" id="index-_002d-1"></a>
+<a class="index-entry-id" id="index-_002b-1"></a>
+<a class="index-entry-id" id="index-if-request_002c-and-the-_0021-operator"></a>
+<a class="index-entry-id" id="index-while-request_002c-and-the-_0021-operator"></a>
+</p>
+<p>Arithmetic unary operators operate on the numeric expression to their
+right; they are <code class="code">-</code> (negation) and <code class="code">+</code> (assertion&mdash;for
+completeness; it does nothing).  The unary minus must often be used
+with parentheses to avoid confusion with the decrementation operator,
+discussed below.
+</p>
+<p>Observe the rounding behavior and effect of negative operands on the
+modulus and truncating division operators.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr T 199/100
+.nr U 5/2
+.nr V (-5)/2
+.nr W 5/-2
+.nr X 5%2
+.nr Y (-5)%2
+.nr Z 5%-2
+T=\nT U=\nU V=\nV W=\nW X=\nX Y=\nY Z=\nZ
+    &rArr; T=1 U=2 V=-2 W=-2 X=1 Y=-1 Z=1
+</pre></div></div>
+
+<p>The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.  Division and modulus operators satisfy the following
+property: given a dividend&nbsp;<var class="var">a</var> and a divisor&nbsp;<var class="var">b</var>, a
+quotient&nbsp;<var class="var">q</var> formed by &lsquo;<samp class="samp">(a / b)</samp>&rsquo; and a
+remainder&nbsp;<var class="var">r</var> by &lsquo;<samp class="samp">(a % b)</samp>&rsquo;, then <em class="math">qb + r = a</em>.
+</p>
+<a class="index-entry-id" id="index-scaling-operator"></a>
+<a class="index-entry-id" id="index-operator_002c-scaling"></a>
+<a class="index-entry-id" id="index-_003b"></a>
+<p>GNU <code class="code">troff</code>&rsquo;s scaling operator, used with parentheses as
+<code class="code">(<var class="var">c</var>;<var class="var">e</var>)</code>, evaluates a numeric expression&nbsp;<var class="var">e</var>
+using&nbsp;<var class="var">c</var> as the default scaling unit.  If <var class="var">c</var> is omitted,
+scaling units are ignored in the evaluation of&nbsp;<var class="var">e</var>.  This
+operator can save typing by avoiding the attachment of scaling units to
+every operand out of caution.  Your macros can select a sensible default
+unit in case the user neglects to supply one.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Indent by amount given in first argument; assume ens.
+.de Indent
+.  in (n;\\$1)
+..
+</pre></div></div>
+
+<p>Without the scaling operator, the foregoing macro would, if called with
+a unitless argument, cause indentation by the <code class="code">in</code> request&rsquo;s
+default scaling unit (ems).  The result would be twice as much
+indentation as expected.
+</p>
+<a class="index-entry-id" id="index-extremum-operators-_0028_003e_003f_002c-_003c_003f_0029"></a>
+<a class="index-entry-id" id="index-operators_002c-extremum-_0028_003e_003f_002c-_003c_003f_0029"></a>
+<a class="index-entry-id" id="index-maximum-operator"></a>
+<a class="index-entry-id" id="index-minimum-operator"></a>
+<a class="index-entry-id" id="index-_003e_003f"></a>
+<a class="index-entry-id" id="index-_003c_003f"></a>
+<p>GNU <code class="code">troff</code> also provides a pair of operators to compute the
+extrema of two operands: <code class="code">&gt;?</code> (maximum) and <code class="code">&lt;?</code> (minimum).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr slots 5
+.nr candidates 3
+.nr salaries (\nslots &lt;? \ncandidates)
+Looks like we'll end up paying \nsalaries salaries.
+    &rArr; Looks like we'll end up paying 3 salaries.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-comparison-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-comparison"></a>
+<a class="index-entry-id" id="index-greater-than-_0028or-equal-to_0029-operator"></a>
+<a class="index-entry-id" id="index-less-than-_0028or-equal-to_0029-operator"></a>
+<a class="index-entry-id" id="index-equality-operator"></a>
+<a class="index-entry-id" id="index-_003c"></a>
+<a class="index-entry-id" id="index-_003e"></a>
+<a class="index-entry-id" id="index-_003e_003d"></a>
+<a class="index-entry-id" id="index-_003c_003d"></a>
+<a class="index-entry-id" id="index-_003d"></a>
+<a class="index-entry-id" id="index-_003d_003d"></a>
+<p>Comparison operators comprise <code class="code">&lt;</code> (less than), <code class="code">&gt;</code> (greater
+than), <code class="code">&lt;=</code> (less than or equal), <code class="code">&gt;=</code> (greater than or
+equal), and <code class="code">=</code> (equal).  <code class="code">==</code> is a synonym for <code class="code">=</code>.
+When evaluated, a comparison is replaced with &lsquo;<samp class="samp">0</samp>&rsquo; if it is false
+and &lsquo;<samp class="samp">1</samp>&rsquo; if true.  In the <code class="code">roff</code> language, positive values are
+true, others false.
+</p>
+<a class="index-entry-id" id="index-logical-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-logical"></a>
+<a class="index-entry-id" id="index-logical-_0060_0060and_0027_0027-operator"></a>
+<a class="index-entry-id" id="index-logical-conjunction-operator"></a>
+<a class="index-entry-id" id="index-logical-_0060_0060or_0027_0027-operator"></a>
+<a class="index-entry-id" id="index-logical-disjunction-operator"></a>
+<a class="index-entry-id" id="index-_0026"></a>
+<a class="index-entry-id" id="index-_003a"></a>
+<p>We can operate on truth values with the logical operators <code class="code">&amp;</code>
+(logical conjunction or &ldquo;and&rdquo;) and <code class="code">:</code> (logical disjunction or
+&ldquo;or&rdquo;).  They evaluate as comparison operators do.
+</p>
+<a class="index-entry-id" id="index-_0021"></a>
+<a class="index-entry-id" id="index-complementation_002c-logical"></a>
+<a class="index-entry-id" id="index-logical-complementation-operator"></a>
+<a class="index-entry-id" id="index-logical-not_002c-limitation-in-expression"></a>
+<a class="index-entry-id" id="index-expression_002c-limitation-of-logical-not-in"></a>
+<p>A logical complementation (&ldquo;not&rdquo;) operator, <code class="code">!</code>, works only
+within <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> requests.
+Furthermore, <code class="code">!</code> is recognized only at the beginning of a numeric
+expression not contained by another numeric expression.  In other words,
+it must be the &ldquo;outermost&rdquo; operator.  Including it elsewhere in the
+expression produces a warning in the &lsquo;<samp class="samp">number</samp>&rsquo; category
+(see <a class="pxref" href="#Warnings">Warnings</a>), and its expression evaluates false.  This
+unfortunate limitation maintains compatibility with <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>.  Test a numeric expression for falsity by
+comparing it to a false value.<a class="footnote" id="DOCF37" href="#FOOT37"><sup>37</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr X 1
+.nr Y 0
+.\&quot; This does not work as expected.
+.if (\nX)&amp;(!\nY) .nop A: X is true, Y is false
+.
+.\&quot; Use this construct instead.
+.if (\nX)&amp;(\nY&lt;=0) .nop B: X is true, Y is false
+    error&rarr; warning: expected numeric expression, got '!'
+    &rArr; B: X is true, Y is false
+</pre></div></div>
+
+<a class="index-entry-id" id="index-parentheses"></a>
+<a class="index-entry-id" id="index-order-of-evaluation-in-expressions"></a>
+<a class="index-entry-id" id="index-expression_002c-order-of-evaluation"></a>
+<a class="index-entry-id" id="index-_0028"></a>
+<a class="index-entry-id" id="index-_0029"></a>
+<p>The <code class="code">roff</code> language has no operator precedence: expressions are
+evaluated strictly from left to right, in contrast to schoolhouse
+arithmetic.  Use parentheses <code class="code">(</code> <code class="code">)</code> to impose a desired
+precedence upon subexpressions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr X 3+5*4
+.nr Y (3+5)*4
+.nr Z 3+(5*4)
+X=\nX Y=\nY Z=\nZ
+    &rArr; X=32 Y=32 Z=23
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_002b_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-_002d_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-motion-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-motion"></a>
+<a class="index-entry-id" id="index-_002b-_0028unary_0029"></a>
+<a class="index-entry-id" id="index-_002d-_0028unary_0029"></a>
+<p>For many requests and escape sequences that cause motion on the page,
+the unary operators <code class="code">+</code> and <code class="code">-</code> work differently when leading
+a numeric expression.  They then indicate a motion relative to the
+drawing position: positive is down in vertical contexts, right in
+horizontal ones.
+</p>
+<a class="index-entry-id" id="index-bp-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-in-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ll-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-lt-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-nm-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-nr-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pl-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pn-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-po-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ps-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pvs-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-rt-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ti-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cH_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cR_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cs_002c-using-_002b-and-_002d-with"></a>
+<p><code class="code">+</code> and <code class="code">-</code> are also treated differently by the following
+requests and escape sequences: <code class="code">bp</code>, <code class="code">in</code>, <code class="code">ll</code>,
+<code class="code">lt</code>, <code class="code">nm</code>, <code class="code">nr</code>, <code class="code">pl</code>, <code class="code">pn</code>, <code class="code">po</code>,
+<code class="code">ps</code>, <code class="code">pvs</code>, <code class="code">rt</code>, <code class="code">ti</code>, <code class="code">\H</code>, <code class="code">\R</code>, and
+<code class="code">\s</code>.  Here, leading plus and minus signs serve as incrementation
+and decrementation operators, respectively.  To negate an expression,
+subtract it from zero or include the unary minus in parentheses with its
+argument.  See <a class="xref" href="#Setting-Registers">Setting Registers</a>, for examples.
+</p>
+<a class="index-entry-id" id="index-_007c"></a>
+<a class="index-entry-id" id="index-_007c_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-absolute-_0028sic_0029-position-operator-_0028_007c_0029"></a>
+<a class="index-entry-id" id="index-position_002c-absolute-_0028sic_0029-operator-_0028_007c_0029"></a>
+<a class="index-entry-id" id="index-boundary_002drelative-motion-operator-_0028_007c_0029"></a>
+<p>A leading <code class="code">|</code> operator indicates a motion relative not to the
+drawing position but to a boundary.  For horizontal motions, the
+measurement specifies a distance relative to a drawing position
+corresponding to the beginning of the <em class="emph">input</em> line.  By default,
+tab stops reckon movements in this way.  Most escape sequences do not;
+<code class="code">|</code> tells them to do so.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Mind the \h'1.2i'gap.
+.br
+Mind the \h'|1.2i'gap.
+.br
+Mind the
+\h'|1.2i'gap.
+    &rArr; Mind the             gap.
+    &rArr; Mind the    gap.
+    &rArr; Mind the             gap.
+</pre></div></div>
+
+<p>One use of this feature is to define macros whose scope is limited to
+the output they format.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; underline word $1 with trailing punctuation $2
+.de Underline
+.  nop \\$1\l'|0\ul'\\$2
+..
+Typographical emphasis is best used
+.Underline sparingly .
+</pre></div></div>
+
+<p>In the above example, &lsquo;<samp class="samp">|0</samp>&rsquo; specifies a negative motion from the
+current position (at the end of the argument just emitted, <code class="code">\$1</code>)
+to the beginning of the input line.  Thus, the <code class="code">\l</code> escape sequence
+in this case draws a line from right to left.  A macro call occurs at
+the beginning of an input line;<a class="footnote" id="DOCF38" href="#FOOT38"><sup>38</sup></a> if the <code class="code">|</code>
+operator were omitted, then the underline would be drawn at zero
+distance from the current position, producing device-dependent, and
+likely undesirable, results.  On the &lsquo;<samp class="samp">ps</samp>&rsquo; output device, it
+underlines the period.
+</p>
+<p>For vertical motions, the <code class="code">|</code> operator specifies a distance from
+the first text baseline on the page or in the current
+diversion,<a class="footnote" id="DOCF39" href="#FOOT39"><sup>39</sup></a>  using the current vertical
+spacing.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A
+.br
+B \Z'C'\v'|0'D
+    &rArr; A D
+    &rArr; B C
+</pre></div></div>
+
+<p>In the foregoing example, we&rsquo;ve used the <code class="code">\Z</code> escape sequence
+(see <a class="pxref" href="#Page-Motions">Page Motions</a>) to restore the drawing position after formatting
+&lsquo;<samp class="samp">C</samp>&rsquo;, then moved vertically to the first text baseline on the page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cB_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\B<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cB_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cB"></a>
+<a class="index-entry-id" id="index-numeric-expression_002c-valid"></a>
+<a class="index-entry-id" id="index-valid-numeric-expression"></a>
+<p>Interpolate&nbsp;1 if <var class="var">anything</var> is a valid numeric expression,
+and&nbsp;0 otherwise.  The delimiter need not be a neutral apostrophe;
+see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p></dd></dl>
+
+<p>You might use <code class="code">\B</code> along with the <code class="code">if</code> request to filter out
+invalid macro or string arguments.  See <a class="xref" href="#Conditionals-and-Loops">Conditionals and Loops</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Indent by amount given in first argument; assume ens.
+.de Indent
+.  if \B'\\$1' .in (n;\\$1)
+..
+</pre></div></div>
+
+<p>A register interpolated as an operand in a numeric expression must have
+an Arabic format; luckily, this is the default.  See <a class="xref" href="#Assigning-Register-Formats">Assigning Register Formats</a>.
+</p>
+<a class="index-entry-id" id="index-space-characters_002c-in-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-and-space-characters"></a>
+<p>Because spaces separate arguments to requests, spaces are not allowed in
+numeric expressions unless the (sub)expression containing them is
+surrounded by parentheses.  See <a class="xref" href="#Invoking-Requests">Invoking Requests</a>, and
+<a class="ref" href="#Conditionals-and-Loops">Conditionals and Loops</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+.nr a 1+2 + 2+1
+\na
+    error&rarr; expected numeric expression, got a space
+    &rArr; 3
+.nr a 1+(2 + 2)+1
+\na
+    &rArr; 6
+</pre></div></div>
+
+<p>The <code class="code">nr</code> request (see <a class="pxref" href="#Setting-Registers">Setting Registers</a>) expects its second and
+optional third arguments to be numeric expressions; a bare <code class="code">+</code> does
+not qualify, so our first attempt got a warning.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Identifiers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Formatter-Instructions" accesskey="n" rel="next">Formatter Instructions</a>, Previous: <a href="#Numeric-Expressions" accesskey="p" rel="prev">Numeric Expressions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Identifiers-1">5.5 Identifiers</h3>
+<a class="index-entry-id" id="index-identifiers"></a>
+
+<p>An <em class="dfn">identifier</em> labels a GNU <code class="code">troff</code> datum such as a register,
+name (macro, string, or diversion), typeface, color, special character,
+character class, environment, or stream.  Valid identifiers consist of
+one or more ordinary characters.
+<a class="index-entry-id" id="index-ordinary-character"></a>
+<a class="index-entry-id" id="index-character_002c-ordinary"></a>
+An <i class="slanted">ordinary character</i> is an input character that is not the
+escape character, a leader, tab, newline, or invalid as GNU <code class="code">troff</code>
+input.
+</p>
+<a class="index-entry-id" id="index-invalid-input-characters"></a>
+<a class="index-entry-id" id="index-input-characters_002c-invalid"></a>
+<a class="index-entry-id" id="index-characters_002c-invalid-input"></a>
+<a class="index-entry-id" id="index-Unicode"></a>
+<p>Invalid input characters are a subset of control characters (from the
+sets &ldquo;C0 Controls&rdquo; and &ldquo;C1 Controls&rdquo; as Unicode describes them).
+When GNU <code class="code">troff</code> encounters one in an identifier, it produces a
+warning in category &lsquo;<samp class="samp">input</samp>&rsquo; (see <a class="pxref" href="#Warnings">Warnings</a>).  They are removed
+during interpretation: an identifier &lsquo;<samp class="samp">foo</samp>&rsquo;, followed by an invalid
+character and then &lsquo;<samp class="samp">bar</samp>&rsquo;, is processed as &lsquo;<samp class="samp">foobar</samp>&rsquo;.
+</p>
+<p>On a machine using the ISO 646, 8859, or 10646 character encodings,
+invalid input characters are <code class="code">0x00</code>, <code class="code">0x08</code>, <code class="code">0x0B</code>,
+<code class="code">0x0D</code>&ndash;<code class="code">0x1F</code>, and <code class="code">0x80</code>&ndash;<code class="code">0x9F</code>.  On an
+<abbr class="acronym">EBCDIC</abbr> host, they are <code class="code">0x00</code>&ndash;<code class="code">0x01</code>, <code class="code">0x08</code>,
+<code class="code">0x09</code>, <code class="code">0x0B</code>, <code class="code">0x0D</code>&ndash;<code class="code">0x14</code>,
+<code class="code">0x17</code>&ndash;<code class="code">0x1F</code>, and
+<code class="code">0x30</code>&ndash;<code class="code">0x3F</code>.<a class="footnote" id="DOCF40" href="#FOOT40"><sup>40</sup></a>  Some of these code points are used
+by GNU <code class="code">troff</code> internally, making it non-trivial to extend the
+program to accept UTF-8 or other encodings that use characters from
+these ranges.<a class="footnote" id="DOCF41" href="#FOOT41"><sup>41</sup></a>
+</p>
+<p>Thus, the identifiers &lsquo;<samp class="samp">br</samp>&rsquo;, &lsquo;<samp class="samp">PP</samp>&rsquo;, &lsquo;<samp class="samp">end-list</samp>&rsquo;,
+&lsquo;<samp class="samp">ref*normal-print</samp>&rsquo;, &lsquo;<samp class="samp">|</samp>&rsquo;, &lsquo;<samp class="samp">@_</samp>&rsquo;, and &lsquo;<samp class="samp">!&quot;#$%'()*+,-./</samp>&rsquo;
+are all valid.  Discretion should be exercised to prevent confusion.
+Identifiers starting with &lsquo;<samp class="samp">(</samp>&rsquo; or &lsquo;<samp class="samp"></samp>&rsquo; require care.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 9
+.nr y 1
+.nr (x 2
+.nr y 3
+.nr sum1 (\n(x + \ny)
+    error&rarr; a space character is not allowed in an escape
+    error&rarr;   sequence parameter
+A:2+3=\nsum1
+.nr sum2 (\n((x + \ny)
+B:2+3=\nsum2
+.nr sum3 (\n(x + \n(y)
+C:2+3=\nsum3
+    &rArr; A:2+3=1 B:2+3=5 C:2+3=5
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005d_002c-as-part-of-an-identifier"></a>
+<p>An identifier with a closing bracket (&lsquo;<samp class="samp"></samp>&rsquo;) in its name can&rsquo;t be
+accessed with bracket-form escape sequences that expect an identifier as
+a parameter.  For example, &lsquo;<samp class="samp">\foo</samp>&rsquo; accesses the glyph &lsquo;<samp class="samp">foo</samp>&rsquo;,
+followed by &lsquo;<samp class="samp"></samp>&rsquo; in whatever the surrounding context is, whereas
+&lsquo;<samp class="samp">\C'foo'</samp>&rsquo; formats a glyph named &lsquo;<samp class="samp">foo</samp>&rsquo;.  Similarly, the
+identifier &lsquo;<samp class="samp">(</samp>&rsquo; can&rsquo;t be interpolated <em class="emph">except</em> with bracket
+forms.
+</p>
+<a class="index-entry-id" id="index-refer_002c-and-macro-names-starting-with-_005b-or-_005d"></a>
+<a class="index-entry-id" id="index-_005b_002c-macro-names-starting-with_002c-and-refer"></a>
+<a class="index-entry-id" id="index-_005d_002c-macro-names-starting-with_002c-and-refer"></a>
+<a class="index-entry-id" id="index-macro-names_002c-starting-with-_005b-or-_005d_002c-and-refer"></a>
+<p>If you begin a macro, string, or diversion name with either of the
+characters &lsquo;<samp class="samp"></samp>&rsquo; or &lsquo;<samp class="samp"></samp>&rsquo;, you foreclose use of the <code class="code">grefer</code>
+preprocessor, which recognizes &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">.</samp>&rsquo; as bibliographic
+reference delimiters.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cA_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\A<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cA_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cA"></a>
+<p>Interpolate&nbsp;1 if <var class="var">anything</var> is a valid identifier, and&nbsp;0
+otherwise.  The delimiter need not be a neutral apostrophe; see
+<a class="ref" href="#Delimiters">Delimiters</a>.  Because invalid input characters are removed (see
+above), invalid identifiers are empty or contain spaces, tabs, or
+newlines.
+</p>
+<p>You can employ <code class="code">\A</code> to validate a macro argument before using it to
+construct another escape sequence or identifier.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; usage: .init-coordinate-pair name val1 val2
+.\&quot; Create a coordinate pair where name!x=val1 and
+.\&quot; name!y=val2.
+.de init-coordinate-pair
+.  if \A'\\$1' \{\
+.    if \B'\\$2' .nr \\$1!x \\$2
+.    if \B'\\$3' .nr \\$1!y \\$3
+.  \}
+..
+.init-coordinate-pair center 5 10
+The center is at (\ncenter!x, \ncenter!y).
+.init-coordinate-pair &quot;poi&rarr;nt&quot; trash garbage \&quot; ignored
+.init-coordinate-pair point trash garbage \&quot; ignored
+    &rArr; The center is at (5, 10).
+</pre></div></div>
+
+<p>In this example, we also validated the numeric arguments; the registers
+&lsquo;<samp class="samp">point!x</samp>&rsquo; and &lsquo;<samp class="samp">point!y</samp>&rsquo; remain undefined.  See <a class="xref" href="#Numeric-Expressions">Numeric Expressions</a> for the <code class="code">\B</code> escape sequence.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-undefined-identifiers"></a>
+<a class="index-entry-id" id="index-identifiers_002c-undefined"></a>
+<p>How GNU <code class="code">troff</code> handles the interpretation of an undefined
+identifier depends on the context.  There is no way to invoke an
+undefined request; such syntax is interpreted as a macro call instead.
+If the identifier is interpreted as a string, macro, or diversion, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">mac</samp>&rsquo;, defines it as
+empty, and interpolates nothing.  If the identifier is interpreted as a
+register, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">reg</samp>&rsquo;,
+initializes it to zero, and interpolates that value.  See <a class="xref" href="#Warnings">Warnings</a>,
+<a class="ref" href="#Interpolating-Registers">Interpolating Registers</a>, and <a class="ref" href="#Strings">Strings</a>.  Attempting to use an
+undefined typeface, special character, color, character class,
+environment, or stream generally provokes an error diagnostic.
+</p>
+<a class="index-entry-id" id="index-name-space_002c-common_002c-of-macros_002c-diversions_002c-and-strings"></a>
+<a class="index-entry-id" id="index-common-name-space-of-macros_002c-diversions_002c-and-strings"></a>
+<a class="index-entry-id" id="index-macros_002c-shared-name-space-with-strings-and-diversions"></a>
+<a class="index-entry-id" id="index-strings_002c-shared-name-space-with-macros-and-diversions"></a>
+<a class="index-entry-id" id="index-diversions_002c-shared-name-space-with-macros-and-strings"></a>
+<p>Identifiers for requests, macros, strings, and diversions share one name
+space; special characters and character classes another.  No other
+object types do.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  nop foo
+..
+.di xxx
+bar
+.br
+.di
+.
+.xxx
+    &rArr; bar
+</pre></div></div>
+
+<p>The foregoing example shows that GNU <code class="code">troff</code> reuses the identifier
+&lsquo;<samp class="samp">xxx</samp>&rsquo;, changing it from a macro to a diversion.  No warning is
+emitted, and the previous contents of &lsquo;<samp class="samp">xxx</samp>&rsquo; are lost.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Formatter-Instructions">
+<div class="nav-panel">
+<p>
+Next: <a href="#Registers" accesskey="n" rel="next">Registers</a>, Previous: <a href="#Identifiers" accesskey="p" rel="prev">Identifiers</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Formatter-Instructions-1">5.6 Formatter Instructions</h3>
+<a class="index-entry-id" id="index-formatter-instructions"></a>
+<a class="index-entry-id" id="index-instructing-the-formatter"></a>
+
+<p>To support documents that require more than filling, automatic line
+breaking and hyphenation, adjustment, and supplemental inter-sentence
+space, the <code class="code">roff</code> language offers two means of embedding
+instructions to the formatter.
+</p>
+<a class="index-entry-id" id="index-request-1"></a>
+<p>One is a <em class="dfn">request</em>, which begins with a control character and takes
+up the remainder of the input line.  Requests often perform relatively
+large-scale operations such as setting the page length, breaking the
+line, or starting a new page.  They also conduct internal operations
+like defining macros.
+</p>
+<a class="index-entry-id" id="index-escape-sequence"></a>
+<a class="index-entry-id" id="index-sequence_002c-escape"></a>
+<p>The other is an <em class="dfn">escape sequence</em>, which begins with the escape
+character and can be embedded anywhere in the input, even in arguments
+to requests and other escape sequences.  Escape sequences interpolate
+special characters, strings, or registers, and handle comparatively
+minor formatting tasks like sub- and superscripting.
+</p>
+<p>Some operations, such as font selection and type size alteration, are
+available via both requests and escape sequences.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Control-Characters" accesskey="1">Control Characters</a></li>
+<li><a href="#Invoking-Requests" accesskey="2">Invoking Requests</a></li>
+<li><a href="#Calling-Macros" accesskey="3">Calling Macros</a></li>
+<li><a href="#Using-Escape-Sequences" accesskey="4">Using Escape Sequences</a></li>
+<li><a href="#Delimiters" accesskey="5">Delimiters</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Control-Characters">
+<div class="nav-panel">
+<p>
+Next: <a href="#Invoking-Requests" accesskey="n" rel="next">Invoking Requests</a>, Previous: <a href="#Formatter-Instructions" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="#Formatter-Instructions" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Control-Characters-1">5.6.1 Control Characters</h4>
+<a class="index-entry-id" id="index-control-characters"></a>
+<a class="index-entry-id" id="index-configuring-control-characters"></a>
+<a class="index-entry-id" id="index-changing-control-characters"></a>
+
+<p>The mechanism of using <code class="code">roff</code>&rsquo;s control characters to invoke
+requests and call macros was introduced in <a class="ref" href="#Requests-and-Macros">Requests and Macros</a>.
+Control characters are recognized only at the beginning of an input
+line, or at the beginning of the branch of a control structure request;
+see <a class="ref" href="#Conditionals-and-Loops">Conditionals and Loops</a>.
+</p>
+<p>A few requests cause a break implicitly; use the no-break control
+character to prevent the break.  Break suppression is its sole
+behavioral distinction.  Employing the no-break control character to
+invoke requests that don&rsquo;t cause breaks is harmless but poor style.
+See <a class="xref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+<a class="index-entry-id" id="index-control-character_002c-changing-_0028cc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-control_002c-changing-_0028cc_0029"></a>
+<a class="index-entry-id" id="index-no_002dbreak-control-character_002c-changing-_0028c2_0029"></a>
+<a class="index-entry-id" id="index-character_002c-no_002dbreak-control_002c-changing-_0028c2_0029"></a>
+<a class="index-entry-id" id="index-control-character_002c-no_002dbreak_002c-changing-_0028c2_0029"></a>
+<p>The control &lsquo;<samp class="samp">.</samp>&rsquo; and no-break control &lsquo;<samp class="samp">'</samp>&rsquo; characters can each
+be changed to any ordinary character<a class="footnote" id="DOCF42" href="#FOOT42"><sup>42</sup></a>
+with the <code class="code">cc</code> and <code class="code">c2</code> requests, respectively.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002ecc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cc"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the control character.
+If&nbsp;<var class="var">o</var> is absent or invalid, the default control character
+&lsquo;<samp class="samp">.</samp>&rsquo; is selected.  The identity of the control character is
+associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ec2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.c2</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002ec2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-c2"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the no-break control
+character.  If&nbsp;<var class="var">o</var> is absent or invalid, the default no-break
+control character &lsquo;<samp class="samp">'</samp>&rsquo; is selected.  The identity of the no-break
+control character is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<p>When writing a macro, you might wish to know which control character was
+used to call it.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ebr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.br</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ebr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ebr-1"></a>
+<p>This read-only register interpolates&nbsp;1 if the currently executing
+macro was called using the normal control character and&nbsp;0
+otherwise.  If a macro is interpolated as a string, the <code class="code">.br</code>
+register&rsquo;s value is inherited from the context of the string
+interpolation.  See <a class="xref" href="#Strings">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-intercepting-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-intercepting"></a>
+<a class="index-entry-id" id="index-modifying-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-modifying"></a>
+<p>Use this register to reliably intercept requests that imply breaks.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als bp*orig bp
+.de bp
+.  ie \\n.br .bp*orig
+.  el          'bp*orig
+..
+</pre></div></div>
+
+<p>Testing the <code class="code">.br</code> register outside of a macro definition makes no
+sense.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Invoking-Requests">
+<div class="nav-panel">
+<p>
+Next: <a href="#Calling-Macros" accesskey="n" rel="next">Calling Macros</a>, Previous: <a href="#Control-Characters" accesskey="p" rel="prev">Control Characters</a>, Up: <a href="#Formatter-Instructions" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Invoking-Requests-1">5.6.2 Invoking Requests</h4>
+<a class="index-entry-id" id="index-invoking-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-invoking"></a>
+
+<p>A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.  The invocation of an
+unrecognized request is interpreted as a macro call.  Defining a macro
+with the same name as a request replaces the request.  Deleting a
+request name with the <code class="code">rm</code> request makes it unavailable.  The
+<code class="code">als</code> request can alias requests, permitting them to be wrapped or
+non-destructively replaced.  See <a class="xref" href="#Strings">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-request-arguments"></a>
+<a class="index-entry-id" id="index-arguments-to-requests"></a>
+<a class="index-entry-id" id="index-tabs_002c-and-macro-arguments"></a>
+<a class="index-entry-id" id="index-macro-arguments_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-arguments-to-macros_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-tabs_002c-and-request-arguments"></a>
+<a class="index-entry-id" id="index-request-arguments_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-arguments-to-requests_002c-and-tabs"></a>
+<p>There is no inherent limit on argument length or quantity.  Most
+requests take one or more arguments, and ignore any they do not expect.
+A request may be separated from its arguments by tabs or spaces, but
+only spaces can separate an argument from its successor.  Only one
+between arguments is necessary; any excess is ignored.  GNU <code class="code">troff</code>
+does not allow tabs for argument separation.<a class="footnote" id="DOCF43" href="#FOOT43"><sup>43</sup></a>
+</p>
+<p>Generally, a space <em class="emph">within</em> a request argument is not relevant, not
+meaningful, or is supported by bespoke provisions, as with the <code class="code">tl</code>
+request&rsquo;s delimiters (see <a class="pxref" href="#Page-Layout">Page Layout</a>).  Some requests, like
+<code class="code">ds</code>, interpret the remainder of the control line as a single
+argument.  See <a class="xref" href="#Strings">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-structuring-source-code-of-documents-or-macro-packages"></a>
+<a class="index-entry-id" id="index-documents_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-macro-package_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-package_002c-package_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-indentation_002c-of-roff-source-code"></a>
+<p>Spaces and tabs immediately after a control character are ignored.
+Commonly, authors structure the source of documents or macro files with
+them.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
+.
+.
+.de right-align
+.&rarr;if \\n.br \
+.&rarr;&rarr;br
+.&rarr;rj \\$1
+..
+</pre></div></div>
+
+<a class="index-entry-id" id="index-blank-line-trap-_0028blm_0029"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029-1"></a>
+<p>If you assign an empty blank line trap, you can separate macro
+definitions (or any input lines) with blank lines.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de do-nothing
+..
+.blm do-nothing  \&quot; activate blank line trap
+
+.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
+
+
+.de right-align
+.&rarr;if \\n.br \
+.&rarr;&rarr;br
+.&rarr;rj \\$1
+..
+
+.blm             \&quot; deactivate blank line trap
+</pre></div></div>
+
+<p>See <a class="xref" href="#Blank-Line-Traps">Blank Line Traps</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Calling-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="#Using-Escape-Sequences" accesskey="n" rel="next">Using Escape Sequences</a>, Previous: <a href="#Invoking-Requests" accesskey="p" rel="prev">Invoking Requests</a>, Up: <a href="#Formatter-Instructions" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Calling-Macros-1">5.6.3 Calling Macros</h4>
+<a class="index-entry-id" id="index-calling-macros"></a>
+<a class="index-entry-id" id="index-macro-arguments"></a>
+<a class="index-entry-id" id="index-arguments-to-macros"></a>
+
+<p>If a macro of the desired name does not exist when called, it is
+created, assigned an empty definition, and a warning in category
+&lsquo;<samp class="samp">mac</samp>&rsquo; is emitted.  Calling an undefined macro <em class="emph">does</em> end a
+macro definition naming it as its end macro (see <a class="pxref" href="#Writing-Macros">Writing Macros</a>).
+</p>
+<a class="index-entry-id" id="index-spaces_002c-in-a-macro-argument"></a>
+<p>To embed spaces <em class="emph">within</em> a macro argument, enclose the argument in
+neutral double quotes <code class="code">&quot;</code>.  Horizontal motion escape sequences are
+sometimes a better choice for arguments to be formatted as text.
+</p>
+<p>Consider calls to a hypothetical section heading macro &lsquo;<samp class="samp">uh</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.uh The Mouse Problem
+.uh &quot;The Mouse Problem&quot;
+.uh The\~Mouse\~Problem
+.uh The\ Mouse\ Problem
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_007e_002c-difference-from-_005cSP"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-difference-from-_005c_007e"></a>
+<p>The first line calls <code class="code">uh</code> with three arguments: &lsquo;<samp class="samp">The</samp>&rsquo;,
+&lsquo;<samp class="samp">Mouse</samp>&rsquo;, and &lsquo;<samp class="samp">Problem</samp>&rsquo;.  The remainder call the <code class="code">uh</code>
+macro with one argument, &lsquo;<samp class="samp">The Mouse Problem</samp>&rsquo;.  The last solution,
+using escaped spaces, can be found in documents prepared for
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  It can cause surprise when text is
+adjusted, because <code class="code">\<kbd class="key">SP</kbd></code> inserts a <em class="emph">fixed-width</em>,
+non-breaking space.  GNU <code class="code">troff</code>&rsquo;s <code class="code">\~</code> escape sequence
+inserts an adjustable, non-breaking space.<a class="footnote" id="DOCF44" href="#FOOT44"><sup>44</sup></a>
+</p>
+<a class="index-entry-id" id="index-_0022_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-double-quote_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-_005c_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-backslash_002c-embedding-in-a-macro-argument"></a>
+<p>The foregoing raises the question of how to embed neutral double quotes
+or backslashes in macro arguments when <em class="emph">those</em> characters are
+desired as literals.  In GNU <code class="code">troff</code>, the special character escape
+sequence <code class="code">\rs</code> produces a backslash and <code class="code">\dq</code> a neutral
+double quote.
+</p>
+<p>In GNU <code class="code">troff</code>&rsquo;s <abbr class="acronym">AT&amp;T</abbr> compatibility mode, these
+characters remain available as <code class="code">\(rs</code> and <code class="code">\(dq</code>,
+respectively.  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> did not consistently define
+these special characters,
+but its descendants can be made to support them.  See <a class="xref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.
+</p>
+<p>If even that is not feasible, options remain.  To obtain a literal
+escape character in a macro argument, you can simply type it if you
+change or disable the escape character first.  See <a class="xref" href="#Using-Escape-Sequences">Using Escape Sequences</a>.  Otherwise, you must escape the escape character repeatedly
+to a context-dependent extent.  See <a class="xref" href="#Copy-Mode">Copy Mode</a>.
+</p>
+<p>For the (neutral) double quote, you have recourse to an obscure
+syntactical feature of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  Because a double
+quote can begin a macro argument, the formatter keeps track of whether
+the current argument was started thus, and doesn&rsquo;t require a space after
+the double quote that ends it.<a class="footnote" id="DOCF45" href="#FOOT45"><sup>45</sup></a>  In
+the argument list to a macro, a double quote that <em class="emph">isn&rsquo;t</em> preceded
+by a space <em class="emph">doesn&rsquo;t</em> start a macro argument.  If not preceded by a
+double quote that began an argument, this double quote becomes part of
+the argument.  Furthermore, within a quoted argument, a pair of adjacent
+double quotes becomes a literal double quote.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+.. \&quot; 4 backslashes on the next line
+.eq a&quot; &quot;b c&quot; &quot;de&quot;f\\\\g&quot; h&quot;&quot;i &quot;j&quot;&quot;k&quot;
+    error&rarr; arg1:a&quot; arg2:b c arg3:de
+    error&rarr; arg4:f\g&quot; arg5:h&quot;&quot;i arg6:j&quot;k
+</pre></div></div>
+
+<p>Apart from the complexity of the rules, this traditional solution has
+the disadvantage that double quotes don&rsquo;t survive repeated argument
+expansion in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> or GNU <code class="code">troff</code>&rsquo;s
+compatibility mode.  This can frustrate efforts to pass such arguments
+intact through multiple macro calls.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1
+.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+..
+.de xe
+.  eq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6
+.. \&quot; 8 backslashes on the next line
+.xe a&quot; &quot;b c&quot; &quot;de&quot;f\\\\\\\\g&quot; h&quot;&quot;i &quot;j&quot;&quot;k&quot;
+    error&rarr; arg1:a&quot; arg2:b arg3:c
+    error&rarr; arg4:de arg5:f\g&quot; arg6:h&quot;&quot;i
+</pre></div></div>
+
+<a class="index-entry-id" id="index-input-level"></a>
+<a class="index-entry-id" id="index-level_002c-input"></a>
+<a class="index-entry-id" id="index-interpolation-depth"></a>
+<a class="index-entry-id" id="index-depth_002c-interpolation"></a>
+<p>Outside of compatibility mode, GNU <code class="code">troff</code> doesn&rsquo;t exhibit this
+problem because it tracks the nesting depth of interpolations.
+See <a class="xref" href="#Implementation-Differences">Implementation Differences</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Using-Escape-Sequences">
+<div class="nav-panel">
+<p>
+Next: <a href="#Delimiters" accesskey="n" rel="next">Delimiters</a>, Previous: <a href="#Calling-Macros" accesskey="p" rel="prev">Calling Macros</a>, Up: <a href="#Formatter-Instructions" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Using-Escape-Sequences-1">5.6.4 Using Escape Sequences</h4>
+<a class="index-entry-id" id="index-using-escape-sequences"></a>
+<a class="index-entry-id" id="index-escape-sequences"></a>
+
+<p>Whereas requests must occur on control lines, escape sequences can occur
+intermixed with text and may appear in arguments to requests, macros,
+and other escape sequences.
+<a class="index-entry-id" id="index-_005c"></a>
+An escape sequence is introduced by the escape character, a backslash
+<code class="code">\</code> (but see the <code class="code">ec</code> request below).  The next character
+selects the escape&rsquo;s function.
+</p>
+<p>Escape sequences vary in length.  Some take an argument, and of those,
+some have different syntactical forms for a one-character,
+two-character, or arbitrary-length argument.  Others accept <em class="emph">only</em>
+an arbitrary-length argument.  In the former scheme, a one-character
+argument follows the function character immediately, an opening
+parenthesis &lsquo;<samp class="samp">(</samp>&rsquo; introduces a two-character argument (no closing
+parenthesis is used), and an argument of arbitrary length is enclosed in
+brackets &lsquo;<samp class="samp"></samp>&rsquo;.  In the latter scheme, the user selects a delimiter
+character.  A few escape sequences are idiosyncratic, and support both
+of the foregoing conventions (<code class="code">\s</code>), designate their own
+termination sequence (<code class="code">\?</code>), consume input until the next newline
+(<code class="code">\!</code>, <code class="code">\&quot;</code>, <code class="code">\#</code>), or support an additional modifier
+character (<code class="code">\s</code> again, and <code class="code">\n</code>).  As with requests, use of
+some escape sequences in source documents may interact poorly with a
+macro package you use; consult its documentation to learn of &ldquo;safe&rdquo;
+sequences or alternative facilities it provides to achieve the desired
+result.
+</p>
+<p>If an escape character is followed by a character that does not
+identify a defined operation, the escape character is ignored (producing
+a diagnostic of the &lsquo;<samp class="samp">escape</samp>&rsquo; warning category, which is not enabled
+by default) and the following character is processed normally.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tps -ww
+.nr N 12
+.ds co white
+.ds animal elephant
+I have \fI\nN \*(co \*animals,\f
+said \P.\&amp;\~Pseudo Pachyderm.
+    error&rarr; warning: escape character ignored before 'P'
+    &rArr; I have <i class="slanted">12 white elephants,</i> said P. Pseudo Pachyderm.
+</pre></div></div>
+
+<p>Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.  This rule affords flexibility in
+using escape sequences to construct parameters to other escape
+sequences.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds family C\&quot; Courier
+.ds style I\&quot; oblique
+Choice a typeface \f(\*family\*stylewisely.
+    &rArr; Choose a typeface <i class="slanted">wisely.</i>
+</pre></div></div>
+
+<p>In the above, the syntax form &lsquo;<samp class="samp">\f(</samp>&rsquo; accepts only two characters for
+an argument; the example works because the subsequent escape sequences
+are interpolated before the selection escape sequence argument is
+processed, and strings <code class="code">family</code> and <code class="code">style</code> interpolate one
+character each.<a class="footnote" id="DOCF46" href="#FOOT46"><sup>46</sup></a>
+</p>
+<p>The escape character is nearly always interpreted when encountered; it
+is therefore desirable to have a way to interpolate it, disable it, or
+change it.
+</p>
+<a class="index-entry-id" id="index-formatting-the-escape-character-_0028_005ce_0029"></a>
+<a class="index-entry-id" id="index-escape-character_002c-formatting-_0028_005ce_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ce-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\e</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ce-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ce"></a>
+<p>Interpolate the escape character.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-formatting-a-backslash-glyph-_0028_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-backslash-glyph_002c-formatting-_0028_005c_005brs_005d_0029"></a>
+<p>The <code class="code">\rs</code> special character escape sequence formats a backslash
+glyph.  In macro and string definitions, the input sequences <code class="code">\\</code>
+and <code class="code">\E</code> defer interpretation of escape sequences.  See <a class="xref" href="#Copy-Mode">Copy Mode</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eeo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.eo</code></strong><a class="copiable-link" href='#index-_002eeo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-eo"></a>
+<a class="index-entry-id" id="index-disabling-_005c-_0028eo_0029"></a>
+<a class="index-entry-id" id="index-_005c_002c-disabling-_0028eo_0029"></a>
+<p>Disable the escape mechanism except in copy mode.  Once this request is
+invoked, no input character is recognized as starting an escape
+sequence in interpretation mode.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eec"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ec</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002eec'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ec"></a>
+<a class="index-entry-id" id="index-escape-character_002c-changing-_0028ec_0029"></a>
+<a class="index-entry-id" id="index-character_002c-escape_002c-changing-_0028ec_0029"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the escape character.
+If&nbsp;<var class="var">o</var> is absent or invalid, the default escape character
+&lsquo;<samp class="samp">\</samp>&rsquo; is selected.
+</p></dd></dl>
+
+<p>Switching escape sequence interpretation off to define a macro and back
+on afterward can obviate the need to double the escape character within
+the definition.  See <a class="xref" href="#Writing-Macros">Writing Macros</a>.  This technique is not available
+if your macro needs to interpolate values at the time it is
+<em class="emph">defined</em>&mdash;but many do not.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; simplified `BR` macro from the man(7) macro package
+.eo
+.de BR
+.  ds result \&amp;
+.  while (\n.$ &gt;= 2) \{\
+.    as result \fB\$1\fR\$2\&quot;
+.    shift 2
+.  \}
+.  if \n.$ .as result \fB\$1\&quot;
+\*result
+.  rm result
+.  ft R
+..
+.ec
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eecs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ecs</code></strong><a class="copiable-link" href='#index-_002eecs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ecs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eecr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ecr</code></strong><a class="copiable-link" href='#index-_002eecr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ecr"></a>
+<p>The <code class="code">ecs</code> request stores the escape character for recall with
+<code class="code">ecr</code>.  <code class="code">ecr</code> sets the escape character to &lsquo;<samp class="samp">\</samp>&rsquo; if none
+has been saved.
+</p>
+<p>Use these requests together to temporarily change the escape character.
+</p></dd></dl>
+
+<p>Using a different escape character, or disabling it, when calling macros
+not under your control will likely cause errors, since GNU <code class="code">troff</code>
+has no mechanism to &ldquo;intern&rdquo; macros&mdash;that is, to convert a macro
+definition into a form independent of its
+representation.<a class="footnote" id="DOCF47" href="#FOOT47"><sup>47</sup></a>  When a
+macro is called, its contents are interpreted literally.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Delimiters">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Using-Escape-Sequences" accesskey="p" rel="prev">Using Escape Sequences</a>, Up: <a href="#Formatter-Instructions" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Delimiters-1">5.6.5 Delimiters</h4>
+<a class="index-entry-id" id="index-delimiting-escape-sequence-arguments"></a>
+<a class="index-entry-id" id="index-escape-sequence-argument-delimiters"></a>
+<a class="index-entry-id" id="index-delimiters_002c-for-escape-sequence-arguments"></a>
+<a class="index-entry-id" id="index-arguments_002c-to-escape-sequences_002c-delimiting"></a>
+
+<a class="index-entry-id" id="index-_0027_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0022_002c-as-delimiter"></a>
+<p>Some escape sequences that require parameters use delimiters.  The
+neutral apostrophe <code class="code">'</code> is a popular choice and shown in this
+document.  The neutral double quote <code class="code">&quot;</code> is also commonly seen.
+Letters, numerals, and leaders can be used.  Punctuation characters
+are likely better choices, except for those defined as infix operators
+in numeric expressions; see below.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\l'1.5i\bu' \&quot; draw 1.5 inches of bullet glyphs
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_0025_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_005e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_003f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0029_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c0_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ca_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cc_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cd_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ce_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cE_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cp_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cr_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ct_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cu_002c-as-delimiter"></a>
+<p>The following escape sequences don&rsquo;t take arguments and thus are allowed
+as delimiters:
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\%</code>, <code class="code">\|</code>, <code class="code">\^</code>, <code class="code">\{</code>,
+<code class="code">\}</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\?</code>, <code class="code">\)</code>, <code class="code">\/</code>, <code class="code">\,</code>, <code class="code">\&amp;</code>, <code class="code">\:</code>,
+<code class="code">\~</code>, <code class="code">\0</code>, <code class="code">\a</code>, <code class="code">\c</code>, <code class="code">\d</code>, <code class="code">\e</code>,
+<code class="code">\E</code>, <code class="code">\p</code>, <code class="code">\r</code>, <code class="code">\t</code>, and <code class="code">\u</code>.  However,
+using them this way is discouraged; they can make the input confusing to
+read.
+</p>
+<a class="index-entry-id" id="index-_005cA_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cb_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005co_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cw_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cX_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cZ_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-newline_002c-as-delimiter"></a>
+<p>A few escape sequences,
+<code class="code">\A</code>,
+<code class="code">\b</code>,
+<code class="code">\o</code>,
+<code class="code">\w</code>,
+<code class="code">\X</code>,
+and <code class="code">\Z</code>, accept a newline as a delimiter.  Newlines that serve
+as delimiters continue to be recognized as input line terminators.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A caf\o
+e\(aa
+in Paris
+    &rArr; A café in Paris
+</pre></div></div>
+
+<p>Use of newlines as delimiters in escape sequences is also discouraged.
+</p>
+<a class="index-entry-id" id="index-_005cD_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005ch_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cH_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cl_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cL_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cN_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cR_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cs_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cS_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cv_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cx_002c-delimiters-allowed-by"></a>
+<p>Finally, the escape sequences <code class="code">\D</code>, <code class="code">\h</code>, <code class="code">\H</code>,
+<code class="code">\l</code>, <code class="code">\L</code>, <code class="code">\N</code>, <code class="code">\R</code>, <code class="code">\s</code>, <code class="code">\S</code>,
+<code class="code">\v</code>, and <code class="code">\x</code> prohibit many delimiters.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-numerals_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-digits_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-_002e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-decimal-point_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-dot_002c-as-delimiter"></a>
+the numerals <code class="code">0</code>-<code class="code">9</code> and the decimal point <code class="code">.</code>
+
+</li><li><a class="index-entry-id" id="index-operators_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-_002b_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0025_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0026_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0028_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0029_002c-as-delimiter"></a>
+the (single-character) operators &lsquo;<samp class="samp">+-/*%&lt;&gt;=&amp;:()</samp>&rsquo;
+
+</li><li><a class="index-entry-id" id="index-space-character_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-tab-character_002c-as-delimiter"></a>
+the space and tab characters
+
+</li><li><a class="index-entry-id" id="index-_005c_0025_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_002f_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005cc_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005ce_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005cp_002c-as-delimiter-1"></a>
+any escape sequences other than <code class="code">\%</code>, <code class="code">\:</code>, <code class="code">\{</code>,
+<code class="code">\}</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\/</code>, <code class="code">\c</code>, <code class="code">\e</code>, and <code class="code">\p</code>
+</li></ul>
+
+<p>Delimiter syntax is complex and flexible primarily for historical
+reasons; the foregoing restrictions need be kept in mind mainly when
+using <code class="code">groff</code> in <abbr class="acronym">AT&amp;T</abbr> compatibility mode.  GNU
+<code class="code">troff</code> keeps track of the nesting depth of escape sequence
+interpolations, so the only characters you need to avoid using as
+delimiters are those that appear in the arguments you input, not any
+that result from interpolation. Typically, <code class="code">'</code> works fine.
+See <a class="xref" href="#Implementation-Differences">Implementation Differences</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tps
+.de Mw
+.  nr wd \w'\\$1'
+.  tm &quot;\\$1&quot; is \\n(wd units wide.
+..
+.Mw Wet'suwet'en
+.Mw Wet+200i
+.cp 1 \&quot; turn on compatibility mode
+.Mw Wet'suwet'en
+.Mw Wet'
+.Mw Wet+200i
+    error&rarr; &quot;Wet'suwet'en&quot; is 54740 units wide.
+    error&rarr; &quot;Wet'+200i&quot; is 42610 units wide.
+    error&rarr; &quot;Wet'suwet'en&quot; is 15860 units wide.
+    error&rarr; &quot;Wet'&quot; is 15860 units wide.
+    error&rarr; &quot;Wet'+200i&quot; is 14415860 units wide.
+</pre></div></div>
+
+<p>We see here that in compatibility mode, the part of the argument after
+the <code class="code">'</code> delimiter escapes from its context and, if nefariously
+crafted, influences the computation of the <var class="var">wd</var> register&rsquo;s value in
+a surprising way.
+</p>
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Comments">
+<div class="nav-panel">
+<p>
+Next: <a href="#Registers" accesskey="n" rel="next">Registers</a>, Previous: <a href="#Formatter-Instructions" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Comments-1">5.7 Comments</h3>
+<a class="index-entry-id" id="index-comments"></a>
+
+<p>One of the most common forms of escape sequence is the
+comment.<a class="footnote" id="DOCF48" href="#FOOT48"><sup>48</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0022-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\&quot;</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0022-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0022"></a>
+<p>Start a comment.  Everything up to the next newline is ignored.
+</p>
+<p>This may sound simple, but it can be tricky to keep the comments from
+interfering with the appearance of the output.
+<a class="index-entry-id" id="index-ds_002c-ds1-requests_002c-and-comments"></a>
+<a class="index-entry-id" id="index-as_002c-as1-requests_002c-and-comments"></a>
+If the escape sequence is to the right of some text or a request, that
+portion of the line is ignored, but spaces preceding it are processed
+normally by GNU <code class="code">troff</code>.  This affects only the <code class="code">ds</code> and
+<code class="code">as</code> requests and their variants.
+</p>
+<a class="index-entry-id" id="index-tabs_002c-before-comments"></a>
+<a class="index-entry-id" id="index-comments_002c-lining-up-with-tabs"></a>
+<p>One possibly irritating idiosyncrasy is that tabs should not be used to
+vertically align comments in the source document.  Tab characters are
+not treated as separators between a request name and its first argument,
+nor between arguments.
+</p>
+<a class="index-entry-id" id="index-undefined-request"></a>
+<a class="index-entry-id" id="index-request_002c-undefined"></a>
+<p>A comment on a line by itself is treated as a blank line, because after
+eliminating the comment, that is all that remains.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test
+\&quot; comment
+Test
+    &rArr; Test
+    &rArr;
+    &rArr; Test
+</pre></div></div>
+
+<p>To avoid this, it is common to combine the empty request with the
+comment escape sequence as &lsquo;<samp class="samp">.\&quot;</samp>&rsquo;, causing the input line to be
+ignored.
+</p>
+<a class="index-entry-id" id="index-_0027_002c-as-a-comment"></a>
+<p>Another commenting scheme sometimes seen is three consecutive single
+quotes (<code class="code">'''</code>) at the beginning of a line.  This works, but GNU
+<code class="code">troff</code> emits a warning diagnostic (if enabled) about an undefined
+macro (namely &lsquo;<samp class="samp">''</samp>&rsquo;).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0023-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\#</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0023-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0023"></a>
+<p>Start a comment; everything up to and including the next newline is
+ignored.  This <code class="code">groff</code> extension was introduced to avoid the
+problems described above.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test
+\# comment
+Test
+    &rArr; Test Test
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eig"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ig</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eig'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ig"></a>
+<p>Ignore input until, in the current conditional block (if
+any),<a class="footnote" id="DOCF49" href="#FOOT49"><sup>49</sup></a> the macro <var class="var">end</var> is called
+at the start of a control line, or the control line &lsquo;<samp class="samp">..</samp>&rsquo; is
+encountered if <var class="var">end</var> is not specified.  <code class="code">ig</code> is parsed as if it
+were a macro definition, but its contents are discarded, not
+stored.<a class="footnote" id="DOCF50" href="#FOOT50"><sup>50</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">hand\c
+.de TX
+fasting
+..
+.ig TX
+This is part of a large block of input that has been
+temporarily(?) commented out.
+We can restore it simply by removing the .ig request and
+the call of its end macro.
+.TX
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; handfasting
+</pre></div></div>
+</dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Registers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Manipulating-Filling-and-Adjustment" accesskey="n" rel="next">Manipulating Filling and Adjustment</a>, Previous: <a href="#Formatter-Instructions" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Registers-1">5.8 Registers</h3>
+<a class="index-entry-id" id="index-registers"></a>
+
+<p>In the <code class="code">roff</code> language, numbers can be stored in <em class="dfn">registers</em>.
+Many built-in registers exist, supplying anything from the date to
+details of formatting parameters.  You can also define your own.
+See <a class="xref" href="#Identifiers">Identifiers</a>, for information on constructing a valid name for a
+register.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Setting-Registers" accesskey="1">Setting Registers</a></li>
+<li><a href="#Interpolating-Registers" accesskey="2">Interpolating Registers</a></li>
+<li><a href="#Auto_002dincrement" accesskey="3">Auto-increment</a></li>
+<li><a href="#Assigning-Register-Formats" accesskey="4">Assigning Register Formats</a></li>
+<li><a href="#Built_002din-Registers" accesskey="5">Built-in Registers</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Setting-Registers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Interpolating-Registers" accesskey="n" rel="next">Interpolating Registers</a>, Previous: <a href="#Registers" accesskey="p" rel="prev">Registers</a>, Up: <a href="#Registers" accesskey="u" rel="up">Registers</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Setting-Registers-1">5.8.1 Setting Registers</h4>
+<a class="index-entry-id" id="index-setting-registers-_0028nr_002c-_005cR_0029"></a>
+<a class="index-entry-id" id="index-registers_002c-setting-_0028nr_002c-_005cR_0029"></a>
+
+<p>Define registers and update their values with the <code class="code">nr</code> request or
+the <code class="code">\R</code> escape sequence.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">ident value</var><a class="copiable-link" href='#index-_002enr-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cR_0027ident-value_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\R<code class="code">'</code></code><span class="r"><i class="slanted">ident value</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cR_0027ident-value_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cR"></a>
+<p>Set register <var class="var">ident</var> to <var class="var">value</var>.  If <var class="var">ident</var> doesn&rsquo;t exist,
+GNU <code class="code">troff</code> creates it.  In the <code class="code">\R</code> escape sequence, the
+delimiter need not be a neutral apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.  It
+also does not produce an input token in GNU <code class="code">troff</code>.  See <a class="xref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a (((17 + (3 * 4))) % 4)
+\na
+.\R'a (((17 + (3 * 4))) % 4)'
+\na
+    &rArr; 1 1
+</pre></div></div>
+
+<p>(Later, we will discuss additional forms of <code class="code">nr</code> and <code class="code">\R</code> that
+can change a register&rsquo;s value after it is dereferenced but before it is
+interpolated.  See <a class="xref" href="#Auto_002dincrement">Auto-increment</a>.)
+</p>
+<p>The complete transparency of <code class="code">\R</code> can cause surprising effects if
+you use registers like <code class="code">.k</code>, which get evaluated at the time they
+are accessed.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 1.6i
+.
+aaa bbb ccc ddd eee fff ggg hhh\R':k \n.k'
+.tm :k == \n:k
+    &rArr; :k == 126950
+.
+.br
+.
+aaa bbb ccc ddd eee fff ggg hhh\h'0'\R':k \n.k'
+.tm :k == \n:k
+    &rArr; :k == 15000
+</pre></div></div>
+
+<p>If you process this with the PostScript device (<code class="code">-Tps</code>), there will
+be a line break eventually after <code class="code">ggg</code> in both input lines.
+However, after processing the space after <code class="code">ggg</code>, the partially
+collected line is not overfull yet, so GNU <code class="code">troff</code> continues to
+collect input until it sees the space (or in this case, the newline)
+after <code class="code">hhh</code>.  At this point, the line is longer than the line
+length, and the line gets broken.
+</p>
+<p>In the first input line, since the <code class="code">\R</code> escape sequence leaves no
+traces, the check for the overfull line hasn&rsquo;t been done yet at the
+point where <code class="code">\R</code> gets handled, and you get a value for the
+<code class="code">.k</code> register that is even greater than the current line length.
+</p>
+<p>In the second input line, the insertion of <code class="code">\h'0'</code> to cause a
+zero-width motion forces GNU <code class="code">troff</code> to check the line length,
+which in turn causes the start of a new output line.  Now <code class="code">.k</code>
+returns the expected value.
+</p></dd></dl>
+
+<p><code class="code">nr</code> and <code class="code">\R</code> each have two additional special forms to
+increment or decrement a register.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">ident <code class="t">+</code><span class="r"><i class="slanted">value</i></span></var><a class="copiable-link" href='#index-_002enr-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr-2"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002enr-3"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">ident <code class="t">-</code><span class="r"><i class="slanted">value</i></span></var><a class="copiable-link" href='#index-_002enr-3'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cR_0027ident-_002bvalue_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\R<code class="code">'</code></code><span class="r"><i class="slanted">ident <code class="t">+</code>value</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cR_0027ident-_002bvalue_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cR-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cR_0027ident-_002dvalue_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\R<code class="code">'</code></code><span class="r"><i class="slanted">ident <code class="t">-</code>value</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cR_0027ident-_002dvalue_0027'> &para;</a></span></dt>
+<dd><p>Increment (decrement) register <var class="var">ident</var> by <var class="var">value</var>.  In the
+<code class="code">\R</code> escape sequence, the delimiter need not be a neutral
+apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.nr a +1
+\na
+    &rArr; 2
+</pre></div></div>
+
+<a class="index-entry-id" id="index-negating-register-values"></a>
+<p>A leading minus sign in <var class="var">value</var> is always interpreted as a
+decrementation operator, not an algebraic sign.  To assign a register a
+negative value or the negated value of another register, you can
+force GNU <code class="code">troff</code> to interpret &lsquo;<samp class="samp">-</samp>&rsquo; as a negation or minus,
+rather than decrementation, operator: enclose it with its operand in
+parentheses or subtract it from zero.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 7
+.nr b 3
+.nr a -\nb
+\na
+    &rArr; 4
+.nr a (-\nb)
+\na
+    &rArr; -3
+.nr a 0-\nb
+\na
+    &rArr; -3
+</pre></div></div>
+
+<p>If a register&rsquo;s prior value does not exist (the register was undefined),
+an increment or decrement is applied as if to&nbsp;0.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002err"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rr</code></strong> <var class="def-var-arguments">ident</var><a class="copiable-link" href='#index-_002err'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rr"></a>
+<a class="index-entry-id" id="index-removing-a-register-_0028rr_0029"></a>
+<a class="index-entry-id" id="index-register_002c-removing-_0028rr_0029"></a>
+<p>Remove register <var class="var">ident</var>.  If <var class="var">ident</var> doesn&rsquo;t exist, the request
+is ignored.  Technically, only the name is removed; the register&rsquo;s
+contents are still accessible under aliases created with <code class="code">aln</code>, if
+any.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ernn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rnn</code></strong> <var class="def-var-arguments">ident1 ident2</var><a class="copiable-link" href='#index-_002ernn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rnn"></a>
+<a class="index-entry-id" id="index-renaming-a-register-_0028rnn_0029"></a>
+<a class="index-entry-id" id="index-register_002c-renaming-_0028rnn_0029"></a>
+<p>Rename register <var class="var">ident1</var> to <var class="var">ident2</var>.  If <var class="var">ident1</var> doesn&rsquo;t
+exist, the request is ignored.  Renaming a built-in register does not
+otherwise alter its properties.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ealn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.aln</code></strong> <var class="def-var-arguments">new old</var><a class="copiable-link" href='#index-_002ealn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-aln"></a>
+<a class="index-entry-id" id="index-alias_002c-register_002c-creating-_0028aln_0029"></a>
+<a class="index-entry-id" id="index-creating-alias-for-register-_0028aln_0029"></a>
+<a class="index-entry-id" id="index-register_002c-creating-alias-for-_0028aln_0029"></a>
+<p>Create an alias <var class="var">new</var> for an existing register <var class="var">old</var>, causing
+the names to refer to the same stored object.  If <var class="var">old</var> is
+undefined, a warning in category &lsquo;<samp class="samp">reg</samp>&rsquo; is produced and the request
+is ignored.  See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and
+suppression of warnings.
+</p>
+<a class="index-entry-id" id="index-alias_002c-register_002c-removing-_0028rr_0029"></a>
+<a class="index-entry-id" id="index-removing-alias-for-register-_0028rr_0029"></a>
+<a class="index-entry-id" id="index-register_002c-removing-alias-for-_0028rr_0029"></a>
+<p>To remove a register alias, invoke <code class="code">rr</code> on its name.  A register&rsquo;s
+contents do not become inaccessible until it has no more names.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Interpolating-Registers">
+<div class="nav-panel">
+<p>
+Next: <a href="#Auto_002dincrement" accesskey="n" rel="next">Auto-increment</a>, Previous: <a href="#Setting-Registers" accesskey="p" rel="prev">Setting Registers</a>, Up: <a href="#Registers" accesskey="u" rel="up">Registers</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Interpolating-Registers-1">5.8.2 Interpolating Registers</h4>
+<a class="index-entry-id" id="index-interpolating-registers-_0028_005cn_0029"></a>
+<a class="index-entry-id" id="index-registers_002c-interpolating-_0028_005cn_0029"></a>
+
+<p>Register contents are interpolated with the <code class="code">\n</code> escape sequence.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cni"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cni'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_005bident_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nested-assignments"></a>
+<a class="index-entry-id" id="index-assignments_002c-nested"></a>
+<a class="index-entry-id" id="index-indirect-assignments"></a>
+<a class="index-entry-id" id="index-assignments_002c-indirect"></a>
+<p>Interpolate register with name <var class="var">ident</var> (one-character
+name&nbsp;<var class="var">i</var>, two-character name <var class="var">id</var>).  <code class="code">\n</code> is
+interpreted even in copy mode (see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).  If the register is
+undefined, it is created and assigned a value of&nbsp;&lsquo;<samp class="samp">0</samp>&rsquo;, that
+value is interpolated, and a warning in category &lsquo;<samp class="samp">reg</samp>&rsquo; is emitted.
+See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and suppression of
+warnings.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 5
+.nr as \na+\na
+\n(as
+    &rArr; 10
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a1 5
+.nr ab 6
+.ds str b
+.ds num 1
+\na\nnum
+    &rArr; 5
+\na\*str
+    &rArr; 6
+</pre></div></div>
+</dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Auto_002dincrement">
+<div class="nav-panel">
+<p>
+Next: <a href="#Assigning-Register-Formats" accesskey="n" rel="next">Assigning Register Formats</a>, Previous: <a href="#Interpolating-Registers" accesskey="p" rel="prev">Interpolating Registers</a>, Up: <a href="#Registers" accesskey="u" rel="up">Registers</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Auto_002dincrement-1">5.8.3 Auto-increment</h4>
+<a class="index-entry-id" id="index-auto_002dincrementation-of-a-register"></a>
+<a class="index-entry-id" id="index-incrementation_002c-automatic_002c-of-a-register"></a>
+<a class="index-entry-id" id="index-decrementation_002c-automatic_002c-of-a-register"></a>
+
+<p>Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.  The value of the increment is
+specified with a third argument to the <code class="code">nr</code> request, and a special
+interpolation syntax is used to alter and then retrieve the register&rsquo;s
+value.  Together, these features are called
+<em class="dfn">auto-increment</em>.<a class="footnote" id="DOCF51" href="#FOOT51"><sup>51</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr-4"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">ident value incr</var><a class="copiable-link" href='#index-_002enr-4'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr-3"></a>
+<a class="index-entry-id" id="index-_005cR_002c-difference-from-nr"></a>
+<p>Set register <var class="var">ident</var> to <var class="var">value</var> and its auto-incrementation
+amount to to <var class="var">incr</var>.  The <code class="code">\R</code> escape sequence doesn&rsquo;t support
+an <var class="var">incr</var> argument.
+</p></dd></dl>
+
+<p>Auto-incrementation is not <em class="emph">completely</em> automatic; the <code class="code">\n</code>
+escape sequence in its basic form never alters the value of a register.
+To apply auto-incrementation to a register, interpolate it with
+&lsquo;<samp class="samp">\n±</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_002bi"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002bi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cn-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_002di"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002di'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002b_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002b_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002d_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002d_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002b_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002b_005bident_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002d_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002d_005bident_005d'> &para;</a></span></dt>
+<dd><p>Increment or decrement <var class="var">ident</var> (one-character
+name&nbsp;<var class="var">i</var>, two-character name <var class="var">id</var>) by the register&rsquo;s
+auto-incrementation value and then interpolate the new register value.
+If <var class="var">ident</var> has no auto-incrementation value, interpolate as with
+<code class="code">\n</code>.
+</p></dd></dl>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0 1
+.nr xx 0 5
+.nr foo 0 -2
+\n+a, \n+a, \n+a, \n+a, \n+a
+.br
+\n-(xx, \n-(xx, \n-(xx, \n-(xx, \n-(xx
+.br
+\n+foo, \n+foo, \n+foo, \n+foo, \n+foo
+    &rArr; 1, 2, 3, 4, 5
+    &rArr; -5, -10, -15, -20, -25
+    &rArr; -2, -4, -6, -8, -10
+</pre></div></div>
+
+<a class="index-entry-id" id="index-increment-value-without-changing-the-register"></a>
+<a class="index-entry-id" id="index-value_002c-incrementing-without-changing-the-register"></a>
+<p>To change the increment value without changing the value of a register,
+assign the register&rsquo;s value to itself by interpolating it, and specify
+the desired increment normally.  Apply an increment of &lsquo;<samp class="samp">0</samp>&rsquo; to
+disable auto-incrementation of the register.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Assigning-Register-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="#Built_002din-Registers" accesskey="n" rel="next">Built-in Registers</a>, Previous: <a href="#Auto_002dincrement" accesskey="p" rel="prev">Auto-increment</a>, Up: <a href="#Registers" accesskey="u" rel="up">Registers</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Assigning-Register-Formats-1">5.8.4 Assigning Register Formats</h4>
+<a class="index-entry-id" id="index-assign-number-format-to-register-_0028af_0029"></a>
+<a class="index-entry-id" id="index-number-formats_002c-assigning-to-register-_0028af_0029"></a>
+<a class="index-entry-id" id="index-register_002c-assigning-number-format-to-_0028af_0029"></a>
+
+<p>A writable register&rsquo;s value can be interpolated in several number
+formats.  By default, conventional Arabic numerals are used.
+Other formats see use in sectioning and outlining schemes and
+alternative page numbering arrangements.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eaf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.af</code></strong> <var class="def-var-arguments">reg fmt</var><a class="copiable-link" href='#index-_002eaf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-af"></a>
+<p>Use number format <var class="var">fmt</var> when interpolating register <var class="var">reg</var>.
+Valid number formats are as follows.
+</p>
+<dl class="table">
+<dt><code class="code">0<span class="r">&hellip;</span></code></dt>
+<dd><p>Arabic numerals 0, 1, 2, and so on.
+Any decimal digit is equivalent to &lsquo;<samp class="samp">0</samp>&rsquo;; the formatter merely counts
+the digits specified.  Multiple Arabic numerals in <var class="var">fmt</var> cause
+interpolations to be zero-padded on the left if necessary to at least as
+many digits as specified (interpolations never truncate a register
+value).  A register with format &lsquo;<samp class="samp">00</samp>&rsquo; interpolates values 1, 2, 3 as
+&lsquo;<samp class="samp">01</samp>&rsquo;, &lsquo;<samp class="samp">02</samp>&rsquo;, &lsquo;<samp class="samp">03</samp>&rsquo;.  The default format for all writable
+registers is &lsquo;<samp class="samp">0</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-Roman-numerals'><span><code class="code">I</code><a class="copiable-link" href='#index-Roman-numerals'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-numerals_002c-Roman"></a>
+<p>Uppercase Roman numerals: 0, I, II, III, IV,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">i</code></dt>
+<dd><p>Lowercase Roman numerals: 0, i, ii, iii, iv,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">A</code></dt>
+<dd><p>Uppercase letters: 0, A, B, C, &hellip;,&nbsp;Z, AA, AB,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">a</code></dt>
+<dd><p>Lowercase letters: 0, a, b, c, &hellip;,&nbsp;z, aa, ab,&nbsp;<small class="enddots">...</small>
+</p></dd>
+</dl>
+
+<p>Omitting <var class="var">fmt</var> causes a warning in category &lsquo;<samp class="samp">missing</samp>&rsquo;.
+See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and suppression of
+warnings.  Specifying an unrecognized format is an error.
+</p>
+<p>Zero values are interpolated as &lsquo;<samp class="samp">0</samp>&rsquo; in non-Arabic formats.
+Negative quantities are prefixed with &lsquo;<samp class="samp">-</samp>&rsquo; irrespective of format.
+In Arabic formats, the sign supplements the field width.  If <var class="var">reg</var>
+doesn&rsquo;t exist, it is created with a zero value.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 10
+.af a 0           \&quot; the default format
+\na,
+.af a I
+\na,
+.af a 321
+.nr a (-\na)
+\na,
+.af a a
+\na
+    &rArr; 10, X, -010, -j
+</pre></div></div>
+
+<a class="index-entry-id" id="index-Roman-numerals_002c-extrema-_0028maximum-and-minimum_0029"></a>
+<a class="index-entry-id" id="index-extreme-values-representable-with-Roman-numerals"></a>
+<a class="index-entry-id" id="index-maximum-value-representable-with-Roman-numerals"></a>
+<a class="index-entry-id" id="index-minimum-value-representable-with-Roman-numerals"></a>
+<p>The representable extrema in the &lsquo;<samp class="samp">i</samp>&rsquo; and &lsquo;<samp class="samp">I</samp>&rsquo; formats
+correspond to Arabic ±39,999.  GNU <code class="code">troff</code> uses &lsquo;<samp class="samp">w</samp>&rsquo; and
+&lsquo;<samp class="samp">z</samp>&rsquo; to represent 5,000 and 10,000 in Roman numerals, respectively,
+following the convention of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>&mdash;currently, the
+correct glyphs for Roman numerals five thousand (<code class="code">U+2181</code>) and ten
+thousand (<code class="code">U+2182</code>) are not used.
+</p>
+<a class="index-entry-id" id="index-read_002donly-register_002c-changing-format"></a>
+<a class="index-entry-id" id="index-changing-format_002c-and-read_002donly-registers"></a>
+<p>Assigning the format of a read-only register is an error.  Instead, copy
+the read-only register&rsquo;s value to, and assign the format of, a writable
+register.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cgr"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g</code><span class="r"><i class="slanted">r</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cgr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cg"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cg_0028rg"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g(</code><span class="r"><i class="slanted">rg</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cg_0028rg'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cg_005breg_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g</code><span class="r"><i class="slanted">reg</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cg_005breg_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-format-of-register-_0028_005cg_0029"></a>
+<a class="index-entry-id" id="index-register_002c-format-_0028_005cg_0029"></a>
+<p>Interpolate the format of the register <var class="var">reg</var> (one-character
+name&nbsp;<var class="var">r</var>, two-character name <var class="var">rg</var>).  Zeroes represent
+Arabic formats.  If <var class="var">reg</var> is not defined, <var class="var">reg</var> is not created
+and nothing is interpolated.  <code class="code">\g</code> is interpreted even in copy mode
+(see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-register-format_002c-in-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-and-register-format"></a>
+<p>GNU <code class="code">troff</code> interprets only Arabic numerals.  The Roman numeral or
+alphabetic formats cannot be used as operands to arithmetic operators in
+expressions (see <a class="pxref" href="#Numeric-Expressions">Numeric Expressions</a>).  For instance, it may be
+desirable to test the page number independently of its format.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.af % i \&quot; front matter
+.de header-trap
+.  \&quot; To test the page number, we need it in Arabic.
+.  ds saved-page-number-format \\g%\&quot;
+.  af % 0
+.  nr page-number-in-decimal \\n%
+.  af % \\*saved-page-number-format
+.  ie \\npage-number-in-decimal=1 .do-first-page-stuff
+.  el \{\
+.    ie o .do-odd-numbered-page-stuff
+.    el   .do-even-numbered-page-stuff
+.  \}
+.  rm saved-page-number-format
+..
+.wh 0 header-trap
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Built_002din-Registers">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Assigning-Register-Formats" accesskey="p" rel="prev">Assigning Register Formats</a>, Up: <a href="#Registers" accesskey="u" rel="up">Registers</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Built_002din-Registers-1">5.8.5 Built-in Registers</h4>
+<a class="index-entry-id" id="index-built_002din-registers"></a>
+<a class="index-entry-id" id="index-registers_002c-built_002din"></a>
+
+<p>Predefined registers whose identifiers start with a dot are read-only.
+Many are Boolean-valued, interpolating a true or false value testable
+with the <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code> requests.  Some read-only
+registers are string-valued, meaning that they interpolate text.
+</p>
+<a class="index-entry-id" id="index-removing-a-built_002din-register"></a>
+<a class="index-entry-id" id="index-register_002c-built_002din_002c-removing"></a>
+<a class="index-entry-id" id="index-built_002din-register_002c-removing"></a>
+<p><strong class="strong">Caution:</strong> Built-in registers are subject to removal like
+others; once removed, they can be recreated only as normal writable
+registers and will not reflect formatter state.
+</p>
+<p>A register name (without the dot) is often associated with a request of
+the same name.  A complete listing of all built-in registers can be
+found in <a class="ref" href="#Register-Index">Register Index</a>.
+</p>
+<p>We present here a few built-in registers that are not described
+elsewhere in this manual; they have to do with invariant properties of
+GNU <code class="code">troff</code>, or obtain information about the formatter&rsquo;s
+command-line options, processing progress, or the operating environment.
+</p>
+<dl class="table">
+<dt id='index-_002eA'><span><code class="code">\n.A</code><a class="copiable-link" href='#index-_002eA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-approximation-output-register-_0028_002eA_0029"></a>
+<a class="index-entry-id" id="index-plain-text-approximation-output-register-_0028_002eA_0029-1"></a>
+<p>Approximate output is being formatted (Boolean-valued); see
+<code class="command">groff</code> <samp class="option">-a</samp> option (<a class="ref" href="#Groff-Options">Options</a>).
+</p>
+</dd>
+<dt id='index-c_002e'><span><code class="code">\n.c</code><a class="copiable-link" href='#index-c_002e'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ec"></a>
+</dd>
+<dt><code class="code">\nc.</code></dt>
+<dd><a class="index-entry-id" id="index-input-line-number-register-_0028_002ec_002c-c_002e_0029"></a>
+<a class="index-entry-id" id="index-line-number_002c-input_002c-register-_0028_002ec_002c-c_002e_0029"></a>
+<p>Input line number.  &lsquo;<samp class="samp">c.</samp>&rsquo; is a writable synonym,
+affecting subsequent interpolations of both &lsquo;<samp class="samp">.c</samp>&rsquo; and &lsquo;<samp class="samp">c.</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-current-input-file-name-register-_0028_002eF_0029'><span><code class="code">\n.F</code><a class="copiable-link" href='#index-current-input-file-name-register-_0028_002eF_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-input-file-name_002c-current_002c-register-_0028_002eF_0029"></a>
+<a class="index-entry-id" id="index-_002eF"></a>
+<p>Name of input file (string-valued).
+</p>
+</dd>
+<dt id='index-_002eg'><span><code class="code">\n.g</code><a class="copiable-link" href='#index-_002eg'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GNU-troff_002c-identification-register-_0028_002eg_0029"></a>
+<a class="index-entry-id" id="index-GNU_002dspecific-register-_0028_002eg_0029"></a>
+<p>Always true in GNU <code class="code">troff</code> (Boolean-valued).  Documents can use
+this to ask the formatter if it claims <code class="code">groff</code> compatibility.
+</p>
+</dd>
+<dt id='index-_002eP'><span><code class="code">\n.P</code><a class="copiable-link" href='#index-_002eP'> &para;</a></span></dt>
+<dd><p>Output page selection status (Boolean-valued); see <code class="command">groff</code>
+<samp class="option">-o</samp> option (<a class="ref" href="#Groff-Options">Options</a>).
+</p>
+</dd>
+<dt id='index-number-of-registers-register-_0028_002eR_0029'><span><code class="code">\n.R</code><a class="copiable-link" href='#index-number-of-registers-register-_0028_002eR_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-registers_002c-number-of_002c-register-_0028_002eR_0029"></a>
+<a class="index-entry-id" id="index-_002eR-2"></a>
+<p>Count of available unused registers; always 10,000 in GNU
+<code class="code">troff</code>.<a class="footnote" id="DOCF52" href="#FOOT52"><sup>52</sup></a>
+</p>
+</dd>
+<dt id='index-_002eT-2'><span><code class="code">\n.T</code><a class="copiable-link" href='#index-_002eT-2'> &para;</a></span></dt>
+<dd><p>Indicator of output device selection (Boolean-valued); see
+<code class="command">groff</code> <samp class="option">-T</samp> option (<a class="ref" href="#Groff-Options">Options</a>).
+</p>
+</dd>
+<dt id='index-safer-mode-2'><span><code class="code">\n.U</code><a class="copiable-link" href='#index-safer-mode-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mode_002c-safer-2"></a>
+<a class="index-entry-id" id="index-unsafe-mode-2"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-2"></a>
+<a class="index-entry-id" id="index-_002eU"></a>
+<p>Unsafe mode enablement status (Boolean-valued); see <code class="command">groff</code>
+<samp class="option">-U</samp> option (<a class="ref" href="#Groff-Options">Options</a>).
+</p>
+</dd>
+<dt id='index-_002ex'><span><code class="code">\n.x</code><a class="copiable-link" href='#index-_002ex'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-major-version-number-register-_0028_002ex_0029"></a>
+<a class="index-entry-id" id="index-version-number_002c-major_002c-register-_0028_002ex_0029"></a>
+<p>Major version number of the running GNU <code class="code">troff</code> formatter.  For
+example, if the version number is 1.23.0, then <code class="code">.x</code>
+contains&nbsp;&lsquo;<samp class="samp">1</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_002ey'><span><code class="code">\n.y</code><a class="copiable-link" href='#index-_002ey'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-minor-version-number-register-_0028_002ey_0029"></a>
+<a class="index-entry-id" id="index-version-number_002c-minor_002c-register-_0028_002ey_0029"></a>
+<p>Minor version number of the running GNU <code class="code">troff</code> formatter.  For
+example, if the version number is 1.23.0, then <code class="code">.y</code>
+contains&nbsp;&lsquo;<samp class="samp">23</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_002eY'><span><code class="code">\n.Y</code><a class="copiable-link" href='#index-_002eY'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-revision-number-register-_0028_002eY_0029"></a>
+<p>Revision number of the running GNU <code class="code">troff</code> formatter.  For example,
+if the version number is 1.23.0, then <code class="code">.Y</code> contains&nbsp;&lsquo;<samp class="samp">0</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_0024_0024'><span><code class="code">\n$$</code><a class="copiable-link" href='#index-_0024_0024'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-process-ID-of-GNU-troff-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-PID-of-GNU-troff-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-GNU-troff_002c-process-ID-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-GNU-troff_002c-PID-register-_0028_0024_0024_0029"></a>
+<p>Process identifier (PID) of the GNU <code class="code">troff</code> program in its
+operating environment.
+</p></dd>
+</dl>
+
+<p>Date- and time-related registers are set per the local time as
+determined by <cite class="cite">localtime<span class="r">(3)</span></cite> when the formatter launches.  This
+initialization can be overridden by <code class="env">SOURCE_DATE_EPOCH</code> and
+<code class="env">TZ</code>; see <a class="ref" href="#Environment">Environment</a>.
+</p>
+<dl class="table">
+<dt id='index-seconds_002c-current-time-_0028seconds_0029'><span><code class="code">\nseconds</code><a class="copiable-link" href='#index-seconds_002c-current-time-_0028seconds_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-seconds-_0028seconds_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-seconds-_0028seconds_0029"></a>
+<a class="index-entry-id" id="index-seconds"></a>
+<p>Count of seconds elapsed in the minute (0&ndash;60). </p>
+</dd>
+<dt id='index-minutes_002c-current-time-_0028minutes_0029'><span><code class="code">\nminutes</code><a class="copiable-link" href='#index-minutes_002c-current-time-_0028minutes_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-minutes-_0028minutes_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-minutes-_0028minutes_0029"></a>
+<a class="index-entry-id" id="index-minutes"></a>
+<p>Count of minutes elapsed in the hour (0&ndash;59).
+</p>
+</dd>
+<dt id='index-hours_002c-current-time-_0028hours_0029'><span><code class="code">\nhours</code><a class="copiable-link" href='#index-hours_002c-current-time-_0028hours_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-hours-_0028hours_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-hours-_0028hours_0029"></a>
+<a class="index-entry-id" id="index-hours"></a>
+<p>Count of hours elapsed since midnight (0&ndash;23).
+</p>
+</dd>
+<dt id='index-day-of-the-week-register-_0028dw_0029'><span><code class="code">\ndw</code><a class="copiable-link" href='#index-day-of-the-week-register-_0028dw_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-day-of-the-week-register-_0028dw_0029"></a>
+<a class="index-entry-id" id="index-dw"></a>
+<p>Day of the week (1&ndash;7; 1 is Sunday).
+</p>
+</dd>
+<dt id='index-day-of-the-month-register-_0028dy_0029'><span><code class="code">\ndy</code><a class="copiable-link" href='#index-day-of-the-month-register-_0028dy_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-day-of-the-month-register-_0028dy_0029"></a>
+<a class="index-entry-id" id="index-dy"></a>
+<p>Day of the month (1&ndash;31).
+</p>
+</dd>
+<dt id='index-month-of-the-year-register-_0028mo_0029'><span><code class="code">\nmo</code><a class="copiable-link" href='#index-month-of-the-year-register-_0028mo_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-month-of-the-year-register-_0028mo_0029"></a>
+<a class="index-entry-id" id="index-mo"></a>
+<p>Month of the year (1&ndash;12).
+</p>
+</dd>
+<dt id='index-date_002c-year-register-_0028year_002c-yr_0029'><span><code class="code">\nyear</code><a class="copiable-link" href='#index-date_002c-year-register-_0028year_002c-yr_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-year_002c-current_002c-register-_0028year_002c-yr_0029"></a>
+<a class="index-entry-id" id="index-year"></a>
+<p>Gregorian year.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-yr-register"></a>
+</dd>
+<dt id='index-yr'><span><code class="code">\nyr</code><a class="copiable-link" href='#index-yr'> &para;</a></span></dt>
+<dd><p>Gregorian year minus&nbsp;1900.  This register is incorrectly documented
+in the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual as storing the last two digits
+of the current year.  That claim stopped being true in 2000.  Old
+<code class="code">troff</code> input that looks like:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">'\&quot; The year number is a surprise after 1999.
+This document was formatted in 19\n(yr.
+</pre></div></div>
+
+<p>can be corrected to:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This document was formatted in \nyear.
+</pre></div></div>
+
+<p>or, for portability across many <code class="code">roff</code> programs, to the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr y4 1900+\n(yr
+This document was formatted in \n(y4.
+</pre></div></div>
+</dd>
+</dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Manipulating-Filling-and-Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="#Manipulating-Hyphenation" accesskey="n" rel="next">Manipulating Hyphenation</a>, Previous: <a href="#Registers" accesskey="p" rel="prev">Registers</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Manipulating-Filling-and-Adjustment-1">5.9 Manipulating Filling and Adjustment</h3>
+<a class="index-entry-id" id="index-manipulating-filling-and-adjustment"></a>
+<a class="index-entry-id" id="index-filling-and-adjustment_002c-manipulating"></a>
+<a class="index-entry-id" id="index-adjustment-and-filling_002c-manipulating"></a>
+<a class="index-entry-id" id="index-justifying-text"></a>
+<a class="index-entry-id" id="index-text_002c-justifying"></a>
+
+<a class="index-entry-id" id="index-break-1"></a>
+<a class="index-entry-id" id="index-line-break"></a>
+<a class="index-entry-id" id="index-bp-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-ce-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-cf-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-fi-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-fl-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-in-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-nf-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-rj-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-sp-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-ti-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-trf-request_002c-causing-implicit-break"></a>
+<p>When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in <a class="ref" href="#Breaking">Breaking</a>.
+The <code class="code">br</code> request likewise causes a break.  Several other requests
+imply breaks: <code class="code">bp</code>, <code class="code">ce</code>, <code class="code">cf</code>, <code class="code">fi</code>, <code class="code">fl</code>,
+<code class="code">in</code>, <code class="code">nf</code>, <code class="code">rj</code>, <code class="code">sp</code>, <code class="code">ti</code>, and <code class="code">trf</code>.
+If the no-break control character is used with any of these requests,
+GNU <code class="code">troff</code> suppresses the break; instead the requested operation
+takes effect at the next break.  &lsquo;<samp class="samp">'br</samp>&rsquo; does nothing.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 55n
+This line is normally filled and adjusted.
+.br
+A line's alignment is decided
+'ce \&quot; Center the next input line (no break).
+when it is output.
+This line returns to normal filling and adjustment.
+    &rArr; This line is normally filled and adjusted.
+    &rArr;    A line's alignment is decided when it is output.
+    &rArr; This line returns to normal filling and adjustment.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-pending-output-line"></a>
+<a class="index-entry-id" id="index-partially-collected-line"></a>
+<a class="index-entry-id" id="index-output-line-properties"></a>
+<a class="index-entry-id" id="index-properties-of-output-lines"></a>
+<p>Output line properties like page offset, indentation, adjustment, and
+even the location of its text baseline, are not determined until the
+line has been broken.  An output line is said to be <em class="dfn">pending</em> if
+some input has been collected but an output line corresponding to it has
+not yet been written; such an output line is also termed <em class="dfn">partially
+collected</em>.  If no output line is pending, it is as if a break has
+already happened; additional breaks, whether explicit or implicit, have
+no effect.  If the vertical drawing position is negative&mdash;as it is when
+the formatter starts up&mdash;a break starts a new page (even if no output
+line is pending) unless an end-of-input macro is being interpreted.
+See <a class="xref" href="#End_002dof_002dinput-Traps">End-of-input Traps</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.br</code></strong><a class="copiable-link" href='#index-_002ebr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-br"></a>
+<p>Break the line: emit any pending output line without adjustment.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">foo bar
+.br
+baz
+'br
+qux
+    &rArr; foo bar
+    &rArr; baz qux
+</pre></div></div>
+</dd></dl>
+
+<p>Sometimes you want to prevent a break within a phrase or between a
+quantity and its units.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\~</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007e"></a>
+<a class="index-entry-id" id="index-unbreakable-space-_0028_005c_007e_0029"></a>
+<a class="index-entry-id" id="index-space_002c-unbreakable-_0028_005c_007e_0029"></a>
+<p>Insert an unbreakable space that is adjustable like an ordinary space.
+It is discarded from the end of an output line if a break is forced.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Set the output speed to\~1.
+There are 1,024\~bytes in 1\~KiB.
+J.\~F.\~Ossanna wrote the original CSTR\~#54.
+</pre></div></div>
+</dd></dl>
+
+<p>By default, GNU <code class="code">troff</code> fills text and adjusts it to reach the
+output line length.  The <code class="code">nf</code> request disables filling; the
+<code class="code">fi</code> request reënables it.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efi"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fi</code></strong><a class="copiable-link" href='#index-_002efi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fi"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eu_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.u</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eu_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eu"></a>
+<a class="index-entry-id" id="index-filling-of-output_002c-enabling-_0028fi_0029"></a>
+<a class="index-entry-id" id="index-output_002c-filling_002c-enablement-of-_0028fi_0029"></a>
+<a class="index-entry-id" id="index-fill-mode-_0028fi_0029_002c-enabling"></a>
+<a class="index-entry-id" id="index-mode_002c-fill-_0028fi_0029_002c-enabling"></a>
+<p>Enable filling of output lines; a pending output line is broken.  The
+read-only register <code class="code">.u</code> is set to&nbsp;1.  The filling enablement
+status, sometimes called <em class="dfn">fill mode</em>, is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).  See <a class="xref" href="#Line-Continuation">Line Continuation</a>, for
+interaction with the <code class="code">\c</code> escape sequence.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nf</code></strong><a class="copiable-link" href='#index-_002enf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nf"></a>
+<a class="index-entry-id" id="index-filling-of-output_002c-disabling-_0028nf_0029"></a>
+<a class="index-entry-id" id="index-output_002c-filling_002c-disablement-of-_0028nf_0029"></a>
+<a class="index-entry-id" id="index-no_002dfill-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dfill"></a>
+<a class="index-entry-id" id="index-fill-mode_002c-disabling"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-disabling"></a>
+<p>Disable filling of output lines: the output line length (see <a class="pxref" href="#Line-Layout">Line Layout</a>) is ignored and output lines are broken where the input lines
+are.  A pending output line is broken and adjustment is suppressed.  The
+read-only register <code class="code">.u</code> is set to&nbsp;0.  The filling enablement
+status is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).  See
+<a class="ref" href="#Line-Continuation">Line Continuation</a>, for interaction with the <code class="code">\c</code> escape
+sequence.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ead"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ad</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">mode</i></span></var><a class="copiable-link" href='#index-_002ead'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ad"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ej_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.j</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ej_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ej"></a>
+<p>Enable output line adjustment in <var class="var">mode</var>, taking effect when the
+pending (or next) output line is broken.  Adjustment is suppressed when
+filling is.  <var class="var">mode</var> can have one of the following values.
+</p>
+<dl class="table">
+<dt><code class="code">b</code></dt>
+<dt><code class="code">n</code></dt>
+<dd><p>Adjust &ldquo;normally&rdquo;: if the output line does not consume the distance
+between the indentation and the configured output line length, GNU
+<code class="code">troff</code> stretches adjustable spaces within the line until that
+length is reached.  When the indentation is zero, this mode spreads the
+line to both the left and right margins.  This is the GNU <code class="code">troff</code>
+default.
+</p>
+</dd>
+<dt id='index-centered-text-_0028filled_0029'><span><code class="code">c</code><a class="copiable-link" href='#index-centered-text-_0028filled_0029'> &para;</a></span></dt>
+<dd><p>Center filled text.  Contrast with the <code class="code">ce</code> request, which centers
+text <em class="emph">without</em> filling it.
+</p>
+</dd>
+<dt id='index-ragged_002dright-text'><span><code class="code">l</code><a class="copiable-link" href='#index-ragged_002dright-text'> &para;</a></span></dt>
+<dd><p>Align text to the left without adjusting it.
+</p>
+</dd>
+<dt id='index-ragged_002dleft-text'><span><code class="code">r</code><a class="copiable-link" href='#index-ragged_002dleft-text'> &para;</a></span></dt>
+<dd><p>Align text to the right without adjusting it.
+</p></dd>
+</dl>
+
+<p><var class="var">mode</var> can also be a value previously stored in the <code class="code">.j</code>
+register.  Using <code class="code">ad</code> without an argument is the same as &lsquo;<samp class="samp">.ad
+\n.j</samp>&rsquo;; unless filling is disabled, GNU <code class="code">troff</code> resumes adjusting
+lines in the same way it did before adjustment was disabled by
+invocation of the <code class="code">na</code> request.
+</p>
+<a class="index-entry-id" id="index-adjustment-mode-register-_0028_002ej_0029"></a>
+<p>The adjustment mode and enablement status are encoded in the read-only
+register <code class="code">.j</code>.  These parameters are associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>The value of <code class="code">.j</code> for any adjustment mode is an implementation
+detail and should not be relied upon as a programmer&rsquo;s interface.  Do
+not write logic to interpret or perform arithmetic on it.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 48n
+.de AD
+.  br
+.  ad \\$1
+..
+.de NA
+.  br
+.  na
+..
+left
+.AD r
+.nr ad \n(.j
+right
+.AD c
+center
+.NA
+left
+.AD
+center
+.AD \n(ad
+right
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; left
+    &rArr;                                            right
+    &rArr;                      center
+    &rArr; left
+    &rArr;                      center
+    &rArr;                                            right
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ena"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.na</code></strong><a class="copiable-link" href='#index-_002ena'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-na"></a>
+<p>Disable output line adjustment.  This produces the same output as
+left-alignment, but the value of the adjustment mode register <code class="code">.j</code>
+is altered differently.  The adjustment mode and enablement status are
+associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebrp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.brp</code></strong><a class="copiable-link" href='#index-_002ebrp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-brp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cp-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\p</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cp-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cp"></a>
+<p>Break, adjusting the line per the current adjustment mode.  <code class="code">\p</code>
+schedules a break with adjustment at the next word boundary.  The escape
+sequence is itself neither a break nor a space of any kind; it can thus
+be placed in the middle of a word to cause a break at the end of that
+word.
+</p>
+<p>Breaking with immediate adjustment can produce ugly results since GNU
+<code class="code">troff</code> doesn&rsquo;t have a sophisticated paragraph-building algorithm,
+as TeX has, for example.  Instead, GNU <code class="code">troff</code> fills and adjusts
+a paragraph line by line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 4.5i
+This is an uninteresting sentence.
+This is an uninteresting sentence.\p
+This is an uninteresting sentence.
+</pre></div></div>
+
+<p>is formatted as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This  is  an uninteresting sentence.  This is
+an          uninteresting           sentence.
+This is an uninteresting sentence.
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-productive-input-line"></a>
+<a class="index-entry-id" id="index-input-line_002c-productive"></a>
+<a class="index-entry-id" id="index-line_002c-productive-input"></a>
+<p>To clearly present the next couple of requests, we must introduce the
+concept of &ldquo;productive&rdquo; input lines.  A <em class="dfn">productive input line</em> is
+one that directly produces formatted output.  Text lines produce
+output,<a class="footnote" id="DOCF53" href="#FOOT53"><sup>53</sup></a> as do control
+lines containing requests like <code class="code">tl</code> or escape sequences like
+<code class="code">\D</code>.  Macro calls are not <em class="emph">directly</em> productive, and thus not
+counted, but their interpolated contents can be.  Empty requests, and
+requests and escape sequences that define registers or strings or alter
+the formatting environment (as with changes to the size, face, height,
+slant, or color of the type) are not productive.  We will also preview
+the output line continuation escape sequence, <code class="code">\c</code>, which
+&ldquo;connects&rdquo; two input lines that would otherwise be counted separately.
+<a class="footnote" id="DOCF54" href="#FOOT54"><sup>54</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de hello
+Hello, world!
+..
+.ce \&quot; center output of next productive input line
+.
+.nr junk-reg 1
+.ft I
+Chorus: \c
+.ft
+.hello
+Went the day well?
+  &rArr;                  <i class="slanted">Chorus:</i> Hello, world!
+  &rArr; Went the day well?
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ece"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ce</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ece'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ce"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ece_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ce</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ece_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ece-1"></a>
+<a class="index-entry-id" id="index-centered-text-_0028unfilled_0029"></a>
+<a class="index-entry-id" id="index-centering-lines-_0028ce_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-centering-_0028ce_0029"></a>
+<p>Break (unless the no-break control character is used), center the output
+of the next <var class="var">n</var> productive input lines with respect to the line
+length and indentation without filling, then break again regardless of
+the invoking control character.
+If the argument is not positive, centering is disabled.  Omitting the
+argument implies an <var class="var">n</var> of &lsquo;<samp class="samp">1</samp>&rsquo;.  The count of lines remaining
+to be centered is stored in the read-only register <code class="code">.ce</code> and is
+associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-ce-request_002c-difference-from-_002ead-c"></a>
+<p>While the &lsquo;<samp class="samp">.ad&nbsp;c</samp>&rsquo; request also centers text, it fills the text
+as well.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de FR
+This is a small text fragment that shows the differences
+between the `.ce' and the `.ad c' requests.
+..
+.ll 4i
+.ce 1000
+.FR
+.ce 0
+
+.ad c
+.FR
+    &rArr; This is a small text fragment that shows
+    &rArr;              the differences
+    &rArr; between the &lsquo;.ce&rsquo; and the &lsquo;.ad c&rsquo; requests.
+    &rArr;
+    &rArr; This is a small text fragment that shows
+    &rArr;  the differences between the &lsquo;.ce&rsquo; and
+    &rArr;         the &lsquo;.ad c&rsquo; requests.
+</pre></div></div>
+
+<p>The previous example illustrates a common idiom of turning centering on
+for a quantity of lines far in excess of what is required, and off again
+after the text to be centered.  This technique relieves humans of
+counting lines for requests that take a count of input lines as an
+argument.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erj"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rj</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002erj'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rj"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002erj_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.rj</code></strong><a class="copiable-link" href='#index-_005cn_005b_002erj_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002erj-1"></a>
+<a class="index-entry-id" id="index-justifying-text-_0028rj_0029"></a>
+<a class="index-entry-id" id="index-text_002c-justifying-_0028rj_0029"></a>
+<a class="index-entry-id" id="index-right_002djustifying-_0028rj_0029"></a>
+<p>Break (unless the no-break control character is used), align the output
+of the next <var class="var">n</var> productive input lines to the right margin without
+filling, then break again regardless of the control character.
+If the argument is not positive, right-alignment is disabled.  Omitting
+the argument implies an <var class="var">n</var> of &lsquo;<samp class="samp">1</samp>&rsquo;.  The count of lines
+remaining to be right-aligned is stored in the read-only register
+<code class="code">.rj</code> and is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 49n
+.rj 3
+At first I hoped that such a technically unsound
+project would collapse but I soon realized it was
+doomed to success. \em C. A. R. Hoare
+    &rArr;  At first I hoped that such a technically unsound
+    &rArr; project would collapse but I soon realized it was
+    &rArr;              doomed to success. -- C. A. R. Hoare
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ess"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ss</code></strong> <var class="def-var-arguments">word-space-size <span class="r"><i class="slanted">additional-sentence-space-size</i></span></var><a class="copiable-link" href='#index-_002ess'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ss"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ess_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ss</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ess_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ess-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esss_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sss</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esss_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esss"></a>
+<a class="index-entry-id" id="index-word-space-size-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-size-of-word-space-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-space-between-words-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-inter_002dsentence-space-size-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-sentence-space-size-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-size-of-sentence-space-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-space-between-sentences-register-_0028_002esss_0029"></a>
+<p>Set the sizes of spaces between words and
+sentences<a class="footnote" id="DOCF55" href="#FOOT55"><sup>55</sup></a> in twelfths
+of font&rsquo;s space width (typically one-fourth to one-third em for Western
+scripts).  The default for both parameters is&nbsp;12.  Negative values
+are erroneous.
+<a class="index-entry-id" id="index-inter_002dword-spacing_002c-minimal"></a>
+<a class="index-entry-id" id="index-minimal-inter_002dword-spacing"></a>
+<a class="index-entry-id" id="index-space_002c-between-words"></a>
+The first argument is a minimum; if an output line undergoes adjustment,
+such spaces may increase in width.
+<a class="index-entry-id" id="index-inter_002dsentence-space_002c-additional"></a>
+<a class="index-entry-id" id="index-additional-inter_002dsentence-space"></a>
+<a class="index-entry-id" id="index-space_002c-between-sentences"></a>
+The optional second argument sets the amount of additional space
+separating sentences on the same output line.  If omitted, this amount
+is set to <var class="var">word-space-size</var>.  The request is ignored if there are no
+parameters.
+</p>
+<a class="index-entry-id" id="index-filling_002c-and-inter_002dsentence-space"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-and-inter_002dsentence-space"></a>
+<p>Additional inter-sentence space is used only if the output line is not
+full when the end of a sentence occurs in the input.  If a sentence ends
+at the end of an input line, then both an inter-word space and an
+inter-sentence space are added to the output; if two spaces follow the
+end of a sentence in the middle of an input line, then the second space
+becomes an inter-sentence space in the output.  Additional
+inter-sentence space is not adjusted, but the inter-word space that
+always precedes it may be.  Further input spaces after the second, if
+present, are adjusted as normal.
+</p>
+<p>The read-only registers <code class="code">.ss</code> and <code class="code">.sss</code> hold the minimal
+inter-word space and additional inter-sentence space amounts,
+respectively.  These parameters are part of the environment
+(see <a class="pxref" href="#Environments">Environments</a>), and rounded down to the nearest multiple
+of&nbsp;12 on terminals.
+</p>
+<a class="index-entry-id" id="index-discardable-horizontal-space"></a>
+<a class="index-entry-id" id="index-space_002c-discardable_002c-horizontal"></a>
+<a class="index-entry-id" id="index-horizontal-discardable-space"></a>
+<p>The <code class="code">ss</code> request can insert discardable horizontal space; that is,
+space that is discarded at a break.  For example, some footnote styles
+collect the notes into a single paragraph with large gaps between
+each note.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 48n
+1.\~J. Fict. Ch. Soc. 6 (2020), 3\en14.
+.ss 12 48 \&quot; applies to next sentence ending
+Reprints no longer available through FCS.
+.ss 12 \&quot; go back to normal
+2.\~Better known for other work.
+    &rArr; 1.  J.  Fict. Ch. Soc. 6 (2020), 3-14.  Reprints
+    &rArr; no longer available through FCS.      2.  Better
+    &rArr; known for other work.
+</pre></div></div>
+
+<p>If <em class="emph">undiscardable</em> space is required, use the <code class="code">\h</code> escape
+sequence.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Manipulating-Hyphenation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Manipulating-Spacing" accesskey="n" rel="next">Manipulating Spacing</a>, Previous: <a href="#Manipulating-Filling-and-Adjustment" accesskey="p" rel="prev">Manipulating Filling and Adjustment</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Manipulating-Hyphenation-1">5.10 Manipulating Hyphenation</h3>
+<a class="index-entry-id" id="index-manipulating-hyphenation"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-manipulating"></a>
+
+<a class="index-entry-id" id="index-hyphenation_002c-automatic"></a>
+<a class="index-entry-id" id="index-automatic-hyphenation"></a>
+<p>When filling, GNU <code class="code">troff</code> hyphenates words as needed at
+user-specified and automatically determined hyphenation points.  The
+machine-driven determination of hyphenation points in words requires
+algorithms and data, and is susceptible to conventions and preferences.
+Before tackling such <em class="dfn">automatic hyphenation</em>, let us consider how
+hyphenation points can be set explicitly.
+</p>
+<a class="index-entry-id" id="index-hyphenation_002c-explicit"></a>
+<a class="index-entry-id" id="index-explicit-hyphenation"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-manual"></a>
+<a class="index-entry-id" id="index-manual-hyphenation"></a>
+<p>Explicitly hyphenated words such as &ldquo;mother-in-law&rdquo; are eligible for
+breaking after each of their hyphens.  Relatively few words in a
+language offer such obvious break points, however, and automatic
+detection of syllabic (or phonetic) boundaries for hyphenation is not
+perfect,<a class="footnote" id="DOCF56" href="#FOOT56"><sup>56</sup></a> particularly for
+unusual words found in technical literature.  We can instruct GNU
+<code class="code">troff</code> how to hyphenate specific words if the need arises.
+</p>
+<a class="index-entry-id" id="index-hyphenation-exceptions"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehw"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hw</code></strong> <var class="def-var-arguments">word &hellip;</var><a class="copiable-link" href='#index-_002ehw'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hw"></a>
+<p>Define each <em class="dfn">hyphenation exception</em> <var class="var">word</var> with each hyphen &lsquo;-&rsquo;
+in the word indicating a hyphenation point.  For example, the request
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.hw in-sa-lub-rious alpha
+</pre></div></div>
+
+<p>marks potential hyphenation points in &ldquo;insalubrious&rdquo;, and prevents
+&ldquo;alpha&rdquo; from being hyphenated at all.
+</p>
+<p>Besides the space character, any character whose hyphenation code is
+zero can be used to separate the arguments of <code class="code">hw</code> (see the
+<code class="code">hcode</code> request below).  In addition, this request can be used more
+than once.
+</p>
+<a class="index-entry-id" id="index-hw-request_002c-and-hy-restrictions"></a>
+<p>Hyphenation points specified with <code class="code">hw</code> are not subject to the
+within-word placement restrictions imposed by the <code class="code">hy</code> request (see
+below).
+</p>
+<p>Hyphenation exceptions specified with the <code class="code">hw</code> request are
+associated with the hyphenation language (see the <code class="code">hla</code> request
+below) and environment (see <a class="pxref" href="#Environments">Environments</a>); invoking the <code class="code">hw</code>
+request in the absence of a hyphenation language is an error.
+</p>
+<p>The request is ignored if there are no parameters.
+</p></dd></dl>
+
+<p>These are known as hyphenation <i class="slanted">exceptions</i> in the expectation
+that most users will avail themselves of automatic hyphenation; these
+exceptions override any rules that would normally apply to a word
+matching a hyphenation exception defined with <code class="code">hw</code>.
+</p>
+<p>Situations also arise when only a specific occurrence of a word needs
+its hyphenation altered or suppressed, or when a URL or similar string
+needs to be breakable in sensible places without hyphenation.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0025-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\%</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0025-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0025"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_003a-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\:</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_003a-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_003a"></a>
+<a class="index-entry-id" id="index-hyphenation-character-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-character_002c-hyphenation-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-disabling-hyphenation-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-disabling-_0028_005c_0025_0029"></a>
+<p>To tell GNU <code class="code">troff</code> how to hyphenate words as they occur in input,
+use the <code class="code">\%</code> escape sequence; it is the default <em class="dfn">hyphenation
+character</em>.  Each instance within a word indicates to GNU <code class="code">troff</code>
+that the word may be hyphenated at that point, while prefixing a word
+with this escape sequence prevents it from being otherwise hyphenated.
+This mechanism affects only that occurrence of the word; to change the
+hyphenation of a word for the remainder of input processing, use the
+<code class="code">hw</code> request.
+</p>
+<a class="index-entry-id" id="index-_005cX_002c-followed-by-_005c_0025"></a>
+<a class="index-entry-id" id="index-_005cY_002c-followed-by-_005c_0025"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-following-_005cX-or-_005cY"></a>
+<p>GNU <code class="code">troff</code> regards the escape sequences <code class="code">\X</code> and <code class="code">\Y</code> as
+starting a word; that is, the <code class="code">\%</code> escape sequence in, say,
+&lsquo;<samp class="samp">\X'...'\%foobar</samp>&rsquo; or &lsquo;<samp class="samp">\Y'...'\%foobar</samp>&rsquo; no longer
+prevents hyphenation of &lsquo;<samp class="samp">foobar</samp>&rsquo; but inserts a hyphenation point
+just prior to it; most likely this isn&rsquo;t what you want.
+See <a class="xref" href="#Postprocessor-Access">Postprocessor Access</a>.
+</p>
+<a class="index-entry-id" id="index-non_002dprinting-break-point-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-without-hyphens-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-file-names_002c-breaking-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-file-names-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-URLs_002c-breaking-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-URLs-_0028_005c_003a_0029"></a>
+<p><code class="code">\:</code> inserts a non-printing break point; that is, a word can break
+there, but the soft hyphen glyph (see below) is not written to the
+output if it does.  This escape sequence is an input word boundary, so
+the remainder of the word is subject to hyphenation as normal.
+</p>
+<p>You can combine <code class="code">\:</code> and <code class="code">\%</code> to control breaking of a file
+name or URL, or to permit hyphenation only after certain explicit
+hyphens within a word.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">The \%Lethbridge-Stewart-\:\%Sackville-Baggins divorce
+was, in retrospect, inevitable once the contents of
+\%/var/log/\:\%httpd/\:\%access_log on the family web
+server came to light, revealing visitors from Hogwarts.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">char</i></span></var><a class="copiable-link" href='#index-_002ehc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hc"></a>
+<p>Change the hyphenation character to <var class="var">char</var>.  This character then
+works as the <code class="code">\%</code> escape sequence normally does, and thus no longer
+appears in the output.<a class="footnote" id="DOCF57" href="#FOOT57"><sup>57</sup></a>  Without an
+argument, <code class="code">hc</code> resets the hyphenation character to <code class="code">\%</code> (the
+default).  The hyphenation character is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eshc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.shc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002eshc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-shc"></a>
+<a class="index-entry-id" id="index-soft-hyphen-character_002c-setting-_0028shc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-soft-hyphen_002c-setting-_0028shc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-soft-hyphen-_0028hy_0029"></a>
+<a class="index-entry-id" id="index-soft-hyphen-glyph-_0028hy_0029"></a>
+<a class="index-entry-id" id="index-char-request_002c-and-soft-hyphen-character"></a>
+<a class="index-entry-id" id="index-tr-request_002c-and-soft-hyphen-character"></a>
+<p>Set the <em class="dfn">soft hyphen character</em>, inserted when a word is hyphenated
+automatically or at a hyphenation character, to the ordinary or special
+character&nbsp;<var class="var">c</var>.<a class="footnote" id="DOCF58" href="#FOOT58"><sup>58</sup></a>  If the argument is omitted, the soft
+hyphen character is set to the default, <code class="code">\hy</code>.  If no glyph for
+<var class="var">c</var> exists in the font in use at a potential hyphenation point, then
+the line is not broken there.  Neither character definitions (specified
+with the <code class="code">char</code> and similar requests) nor translations (specified
+with the <code class="code">tr</code> request) are applied to <var class="var">c</var>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-hyphenation-parameters_002c-automatic"></a>
+<a class="index-entry-id" id="index-automatic-hyphenation-parameters"></a>
+<p>Several requests influence automatic hyphenation.  Because conventions
+vary, a variety of hyphenation modes is available to the <code class="code">hy</code>
+request; these determine whether hyphenation will apply to a
+word prior to breaking a line at the end of a page (more or less; see
+below for details), and at which positions within that word
+automatically determined hyphenation points are permissible.  The places
+within a word that are eligible for hyphenation are determined by
+language-specific data and lettercase relationships.  Furthermore,
+hyphenation of a word might be suppressed due to a limit on
+consecutive hyphenated lines (<code class="code">hlm</code>), a minimum line length
+threshold (<code class="code">hym</code>), or because the line can instead be adjusted with
+additional inter-word space (<code class="code">hys</code>).
+</p>
+<a class="index-entry-id" id="index-hyphenation-mode-register-_0028_002ehy_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehy"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hy</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">mode</i></span></var><a class="copiable-link" href='#index-_002ehy'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hy"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehy_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hy</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehy_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehy-1"></a>
+<p>Set automatic hyphenation mode to <var class="var">mode</var>, an integer encoding
+conditions for hyphenation; if omitted, &lsquo;<samp class="samp">1</samp>&rsquo; is implied.  The
+hyphenation mode is available in the read-only register &lsquo;<samp class="samp">.hy</samp>&rsquo;; it
+is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).  The default
+hyphenation mode depends on the localization file loaded when GNU
+<code class="code">troff</code> starts up; see the <code class="code">hpf</code> request below.
+</p>
+<p>Typesetting practice generally does not avail itself of every
+opportunity for hyphenation, but the details differ by language and site
+mandates.  The hyphenation modes of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> were
+implemented with English-language publishing practices of the 1970s in
+mind, not a scrupulous enumeration of conceivable parameters.  GNU
+<code class="code">troff</code> extends those modes such that finer-grained control is
+possible, favoring compatibility with older implementations over a more
+intuitive arrangement.  The means of hyphenation mode control is a set
+of numbers that can be added up to encode the behavior
+sought.<a class="footnote" id="DOCF59" href="#FOOT59"><sup>59</sup></a>  The entries in the
+following table are termed <em class="dfn">values</em>; the sum of the desired
+values is the <em class="dfn">mode</em>.
+</p>
+<dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>disables hyphenation.
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>enables hyphenation except after the first and before the last character
+of a word.
+</p></dd>
+</dl>
+
+<p>The remaining values &ldquo;imply&rdquo; 1; that is, they enable hyphenation
+under the same conditions as &lsquo;<samp class="samp">.hy 1</samp>&rsquo;, and then apply or lift
+restrictions relative to that basis.
+</p>
+<dl class="table">
+<dt><code class="code">2</code></dt>
+<dd><p>disables hyphenation of the last word on a page,<a class="footnote" id="DOCF60" href="#FOOT60"><sup>60</sup></a> even for explicitly hyphenated words.
+</p>
+</dd>
+<dt><code class="code">4</code></dt>
+<dd><p>disables hyphenation before the last two characters of a word.
+</p>
+</dd>
+<dt><code class="code">8</code></dt>
+<dd><p>disables hyphenation after the first two characters of a word.
+</p>
+</dd>
+<dt><code class="code">16</code></dt>
+<dd><p>enables hyphenation before the last character of a word.
+</p>
+</dd>
+<dt><code class="code">32</code></dt>
+<dd><p>enables hyphenation after the first character of a word.
+</p></dd>
+</dl>
+
+<p>Apart from value&nbsp;2, restrictions imposed by the hyphenation mode
+are <em class="emph">not</em> respected for words whose hyphenations have been
+specified with the hyphenation character (&lsquo;<samp class="samp">\%</samp>&rsquo; by default) or the
+<code class="code">hw</code> request.
+</p>
+<p>Nonzero values in the previous table are additive.  For example,
+mode&nbsp;12 causes GNU <code class="code">troff</code> to hyphenate neither the last two
+nor the first two characters of a word.  Some values cannot be used
+together because they contradict; for instance, values 4 and&nbsp;16,
+and values 8 and&nbsp;32.  As noted, it is superfluous to add 1 to any
+non-zero even mode.
+</p>
+<a class="index-entry-id" id="index-hyphenation-pattern-files"></a>
+<a class="index-entry-id" id="index-pattern-files_002c-for-hyphenation"></a>
+<p>The automatic placement of hyphens in words is determined by
+<em class="dfn">pattern files</em>, which are derived from TeX and available for
+several languages.  The number of characters at the beginning of a word
+after which the first hyphenation point should be inserted is determined
+by the patterns themselves; it can&rsquo;t be reduced further without
+introducing additional, invalid hyphenation points (unfortunately, this
+information is not part of a pattern file&mdash;you have to know it in
+advance).  The same is true for the number of characters at the end of
+a word before the last hyphenation point should be inserted.  For
+example, you can supply the following input to &lsquo;<samp class="samp">echo $(nroff)</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 1
+.hy 48
+splitting
+</pre></div></div>
+
+<p>You will get
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">s- plit- t- in- g
+</pre></div></div>
+
+<p>instead of the correct &lsquo;split- ting&rsquo;.  English patterns as distributed
+with GNU <code class="code">troff</code> need two characters at the beginning and three
+characters at the end; this means that value&nbsp;4 of <code class="code">hy</code> is
+mandatory.  Value&nbsp;8 is possible as an additional restriction, but
+values&nbsp;16 and&nbsp;32 should be avoided, as should mode&nbsp;1.
+Modes&nbsp;4 and&nbsp;6 are typical.
+</p>
+<p>A table of left and right minimum character counts for hyphenation as
+needed by the patterns distributed with GNU <code class="code">troff</code> follows; see
+the <cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page for more information on GNU
+<code class="code">troff</code>&rsquo;s language macro files.
+</p>
+<table class="multitable">
+<thead><tr><th>language</th><th>pattern name</th><th>left min</th><th>right min</th></tr></thead>
+<tbody><tr><td>Czech</td><td>cs</td><td>2</td><td>2</td></tr>
+<tr><td>English</td><td>en</td><td>2</td><td>3</td></tr>
+<tr><td>French</td><td>fr</td><td>2</td><td>3</td></tr>
+<tr><td>German traditional</td><td>det</td><td>2</td><td>2</td></tr>
+<tr><td>German reformed</td><td>den</td><td>2</td><td>2</td></tr>
+<tr><td>Italian</td><td>it</td><td>2</td><td>2</td></tr>
+<tr><td>Swedish</td><td>sv</td><td>1</td><td>2</td></tr>
+</tbody>
+</table>
+
+<p>Hyphenation exceptions within pattern files (i.e., the words within a
+TeX <code class="code">\hyphenation</code> group) obey the hyphenation restrictions
+given by <code class="code">hy</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enh"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nh</code></strong><a class="copiable-link" href='#index-_002enh'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nh"></a>
+<p>Disable automatic hyphenation; i.e., set the hyphenation mode to&nbsp;0
+(see above).  The hyphenation mode of the last call to <code class="code">hy</code> is not
+remembered.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehpf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpf</code></strong> <var class="def-var-arguments">pattern-file</var><a class="copiable-link" href='#index-_002ehpf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ehpfa"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpfa</code></strong> <var class="def-var-arguments">pattern-file</var><a class="copiable-link" href='#index-_002ehpfa'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpfa"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ehpfcode"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpfcode</code></strong> <var class="def-var-arguments">a b c d &hellip;</var><a class="copiable-link" href='#index-_002ehpfcode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpfcode"></a>
+<a class="index-entry-id" id="index-hyphenation-patterns-_0028hpf_0029"></a>
+<a class="index-entry-id" id="index-patterns-for-hyphenation-_0028hpf_0029"></a>
+<p>Read hyphenation patterns from <var class="var">pattern-file</var>, which is sought
+in the same way that macro files are with the <code class="code">mso</code> request or the
+<samp class="option">-m<var class="var">name</var></samp> command-line option to <code class="code">groff</code>.  The
+<var class="var">pattern-file</var> should have the same format as (simple) TeX
+pattern files.  More specifically, the following scanning rules are
+implemented.
+</p>
+<ul class="itemize mark-bullet">
+<li>A percent sign starts a comment (up to the end of the line) even if
+preceded by a backslash.
+
+</li><li>&ldquo;Digraphs&rdquo; like <code class="code">\$</code> are not supported.
+
+</li><li><code class="code">^^<var class="var">xx</var></code> (where each <var class="var">x</var> is 0&ndash;9 or a&ndash;f) and
+<code class="code">^^<var class="var">c</var></code> (character <var class="var">c</var> in the code point range 0&ndash;127
+decimal) are recognized; other uses of <code class="code">^</code> cause an error.
+
+</li><li>No macro expansion is performed.
+
+</li><li><code class="code">hpf</code> checks for the expression <code class="code">\patterns{&hellip;}</code>
+(possibly with whitespace before or after the braces).  Everything
+between the braces is taken as hyphenation patterns.  Consequently,
+<code class="code">{</code> and <code class="code">}</code> are not allowed in patterns.
+
+</li><li>Similarly, <code class="code">\hyphenation{&hellip;}</code> gives a list of hyphenation
+exceptions.
+
+</li><li><code class="code">\endinput</code> is recognized also.
+
+</li><li>For backward compatibility, if <code class="code">\patterns</code> is missing, the whole
+file is treated as a list of hyphenation patterns (except that the
+<code class="code">%</code> character is recognized as the start of a comment).
+</li></ul>
+
+<p>The <code class="code">hpfa</code> request appends a file of patterns to the current list.
+</p>
+<p>The <code class="code">hpfcode</code> request defines mapping values for character codes in
+pattern files.  It is an older mechanism no longer used by GNU
+<code class="code">troff</code>&rsquo;s own macro files; for its successor, see <code class="code">hcode</code>
+below.  <code class="code">hpf</code> or <code class="code">hpfa</code> apply the mapping after reading the
+patterns but before replacing or appending to the active list of
+patterns.  Its arguments are pairs of character codes&mdash;integers from 0
+to&nbsp;255.  The request maps character code&nbsp;<var class="var">a</var> to
+code&nbsp;<var class="var">b</var>, code&nbsp;<var class="var">c</var> to code&nbsp;<var class="var">d</var>, and so on.
+Character codes that would otherwise be invalid in GNU <code class="code">troff</code> can
+be used.  By default, every code maps to itself except those for letters
+&lsquo;A&rsquo; to &lsquo;Z&rsquo;, which map to those for &lsquo;a&rsquo; to &lsquo;z&rsquo;.
+</p>
+<a class="index-entry-id" id="index-localization"></a>
+<a class="index-entry-id" id="index-troffrc-2"></a>
+<a class="index-entry-id" id="index-cs_002etmac"></a>
+<a class="index-entry-id" id="index-de_002etmac"></a>
+<a class="index-entry-id" id="index-en_002etmac"></a>
+<a class="index-entry-id" id="index-fr_002etmac"></a>
+<a class="index-entry-id" id="index-it_002etmac"></a>
+<a class="index-entry-id" id="index-ja_002etmac"></a>
+<a class="index-entry-id" id="index-sv_002etmac"></a>
+<a class="index-entry-id" id="index-zh_002etmac"></a>
+<p>The set of hyphenation patterns is associated with the language set by
+the <code class="code">hla</code> request (see below).  The <code class="code">hpf</code> request is usually
+invoked by a localization file loaded by the <samp class="file">troffrc</samp>
+file.<a class="footnote" id="DOCF61" href="#FOOT61"><sup>61</sup></a>
+</p>
+<p>A second call to <code class="code">hpf</code> (for the same language) replaces the
+hyphenation patterns with the new ones.  Invoking <code class="code">hpf</code> or
+<code class="code">hpfa</code> causes an error if there is no hyphenation language.  If no
+<code class="code">hpf</code> request is specified (either in the document, in a file
+loaded at startup, or in a macro package), GNU <code class="code">troff</code> won&rsquo;t
+automatically hyphenate at all.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehcode"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hcode</code></strong> <var class="def-var-arguments">c1 code1 c2 code2 &hellip;</var><a class="copiable-link" href='#index-_002ehcode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hcode"></a>
+<a class="index-entry-id" id="index-hyphenation-code-_0028hcode_0029"></a>
+<a class="index-entry-id" id="index-code_002c-hyphenation-_0028hcode_0029"></a>
+<p>Set the hyphenation code of character <var class="var">c1</var> to <var class="var">code1</var>, that of
+<var class="var">c2</var> to <var class="var">code2</var>, and so on.  A hyphenation code must be an
+ordinary character (not a special character escape sequence) other than
+a digit or a space.  The request is ignored if given no arguments.
+</p>
+<p>For hyphenation to work, hyphenation codes must be set up.  At
+startup, GNU <code class="code">troff</code> assigns hyphenation codes to the letters
+&lsquo;<samp class="samp">a</samp>&rsquo;&ndash;&lsquo;<samp class="samp">z</samp>&rsquo; (mapped to themselves), to the letters
+&lsquo;<samp class="samp">A</samp>&rsquo;&ndash;&lsquo;<samp class="samp">Z</samp>&rsquo; (mapped to &lsquo;<samp class="samp">a</samp>&rsquo;&ndash;&lsquo;<samp class="samp">z</samp>&rsquo;), and zero to all other
+characters.  Normally, hyphenation patterns contain only lowercase
+letters which should be applied regardless of case.  In other words,
+they assume that the words &lsquo;FOO&rsquo; and &lsquo;Foo&rsquo; should be hyphenated exactly
+as &lsquo;foo&rsquo; is.  The <code class="code">hcode</code> request extends this principle to letters
+outside the Unicode basic Latin alphabet; without it, words containing
+such letters won&rsquo;t be hyphenated properly even if the corresponding
+hyphenation patterns contain them.
+</p>
+<p>For example, the following <code class="code">hcode</code> requests are necessary to assign
+hyphenation codes to the letters &lsquo;<samp class="samp">ÄäÖöÜüß</samp>&rsquo;, needed for German.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.hcode ä ä  Ä ä
+.hcode ö ö  Ö ö
+.hcode ü ü  Ü ü
+.hcode ß ß
+</pre></div></div>
+
+<p>Without these assignments, GNU <code class="code">troff</code> treats the German word
+&lsquo;Kindergärten&rsquo; (the plural form of &lsquo;kindergarten&rsquo;) as two words
+&lsquo;kinderg&rsquo; and &lsquo;rten&rsquo; because the hyphenation code of the
+umlaut&nbsp;a is zero by default, just like a space.  There is a German
+hyphenation pattern that covers &lsquo;kinder&rsquo;, so GNU <code class="code">troff</code> finds
+the hyphenation &lsquo;kin-der&rsquo;.  The other two hyphenation points
+(&lsquo;kin-der-gär-ten&rsquo;) are missed.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehla"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hla</code></strong> <var class="def-var-arguments">lang</var><a class="copiable-link" href='#index-_002ehla'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hla"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehla_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hla</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehla_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehla-1"></a>
+<a class="index-entry-id" id="index-hpf-request_002c-and-hyphenation-language"></a>
+<a class="index-entry-id" id="index-hw-request_002c-and-hyphenation-language"></a>
+<a class="index-entry-id" id="index-troffrc-3"></a>
+<a class="index-entry-id" id="index-troffrc_002dend-1"></a>
+<p>Set the hyphenation language to <var class="var">lang</var>.  Hyphenation exceptions
+specified with the <code class="code">hw</code> request and hyphenation patterns and
+exceptions specified with the <code class="code">hpf</code> and <code class="code">hpfa</code> requests are
+associated with the hyphenation language.  The <code class="code">hla</code> request is
+usually invoked by a localization file, which is turn loaded by the
+<samp class="file">troffrc</samp> or <samp class="file">troffrc-end</samp> file; see the <code class="code">hpf</code> request
+above.
+</p>
+<a class="index-entry-id" id="index-hyphenation-language-register-_0028_002ehla_0029"></a>
+<p>The hyphenation language is available in the read-only string-valued
+register &lsquo;<samp class="samp">.hla</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehlm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hlm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ehlm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hlm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehlm_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hlm</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehlm_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehlm-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehlc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hlc</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehlc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehlc"></a>
+<a class="index-entry-id" id="index-explicit-hyphen-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-hyphen_002c-explicit-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-consecutive-hyphenated-lines-_0028hlm_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-consecutive-hyphenated-_0028hlm_0029"></a>
+<a class="index-entry-id" id="index-hyphenated-lines_002c-consecutive-_0028hlm_0029"></a>
+<p>Set the maximum quantity of consecutive hyphenated lines to <var class="var">n</var>.  If
+<var class="var">n</var> is negative, there is no maximum.  If omitted, <var class="var">n</var>
+is&nbsp;&minus;1.  This value is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).  Only lines output from a given environment
+count toward the maximum associated with that environment.  Hyphens
+resulting from <code class="code">\%</code> are counted; explicit hyphens are not.
+</p>
+<a class="index-entry-id" id="index-hyphenation-consecutive-line-limit-register-_0028_002ehlm_0029"></a>
+<a class="index-entry-id" id="index-hyphenation-consecutive-line-count-register-_0028_002ehlc_0029"></a>
+<p>The <code class="code">.hlm</code> read-only register stores this maximum.  The count of
+immediately preceding consecutive hyphenated lines is available in the
+read-only register <code class="code">.hlc</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehym"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hym</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ehym'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hym"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehym_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hym</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehym_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehym-1"></a>
+<a class="index-entry-id" id="index-hyphenation-margin-_0028hym_0029"></a>
+<a class="index-entry-id" id="index-margin-for-hyphenation-_0028hym_0029"></a>
+<a class="index-entry-id" id="index-ad-request_002c-and-hyphenation-margin"></a>
+<p>Set the (right) hyphenation margin to <var class="var">length</var>.  If the adjustment
+mode is not &lsquo;<samp class="samp">b</samp>&rsquo; or &lsquo;<samp class="samp">n</samp>&rsquo;, the line is not hyphenated if it is
+shorter than <var class="var">length</var>.  Without an argument, the hyphenation margin
+is reset to its default value, 0.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+The hyphenation margin is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>A negative argument resets the hyphenation margin to zero, emitting a
+warning in category &lsquo;<samp class="samp">range</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-hyphenation-margin-register-_0028_002ehym_0029"></a>
+<p>The hyphenation margin is available in the <code class="code">.hym</code> read-only
+register.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehys"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hys</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">hyphenation-space</i></span></var><a class="copiable-link" href='#index-_002ehys'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hys"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehys_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hys</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehys_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehys-1"></a>
+<a class="index-entry-id" id="index-hyphenation-space-_0028hys_0029"></a>
+<a class="index-entry-id" id="index-hyphenation-space-adjustment-threshold"></a>
+<a class="index-entry-id" id="index-ad-request_002c-and-hyphenation-space"></a>
+<p>Suppress hyphenation of the line in adjustment modes &lsquo;<samp class="samp">b</samp>&rsquo; or
+&lsquo;<samp class="samp">n</samp>&rsquo; if it can be justified by adding no more than
+<var class="var">hyphenation-space</var> extra space to each inter-word space.  Without
+an argument, the hyphenation space adjustment threshold is set to its
+default value, 0.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  The
+hyphenation space adjustment threshold is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>A negative argument resets the hyphenation space adjustment threshold to
+zero, emitting a warning in category &lsquo;<samp class="samp">range</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-hyphenation-space-adjustment-threshold-register-_0028_002ehys_0029"></a>
+<p>The hyphenation space adjustment threshold is available in the
+<code class="code">.hys</code> read-only register.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Manipulating-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="#Tabs-and-Fields" accesskey="n" rel="next">Tabs and Fields</a>, Previous: <a href="#Manipulating-Hyphenation" accesskey="p" rel="prev">Manipulating Hyphenation</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Manipulating-Spacing-1">5.11 Manipulating Spacing</h3>
+<a class="index-entry-id" id="index-manipulating-spacing"></a>
+<a class="index-entry-id" id="index-spacing_002c-manipulating"></a>
+
+<p>A break causes the formatter to update the vertical drawing position at
+which the new text baseline is aligned.  You can alter this location.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">distance</i></span></var><a class="copiable-link" href='#index-_002esp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sp"></a>
+<p>Break and move the next text baseline down by <var class="var">distance</var>, or until
+springing a page location trap.<a class="footnote" id="DOCF62" href="#FOOT62"><sup>62</sup></a>
+If invoked with the no-break control character, <code class="code">sp</code> moves the
+pending output line&rsquo;s text baseline by <var class="var">distance</var>.  A negative
+<var class="var">distance</var> will not reduce the position of the text baseline below
+zero.  Inside a diversion, any <var class="var">distance</var> argument is ignored.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">distance</var> is not specified,
+&lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 5v \&quot; Set page length to 5 vees.
+.de xx
+\-\-\-
+.  br
+..
+.wh 0 xx \&quot; Set a trap at the top of the page.
+foo on page \n%
+.sp 2v
+bar on page \n%
+.sp 50v \&quot; This will cause a page break.
+baz on page \n%
+.pl \n(nlu \&quot; Truncate page to current position.
+    &rArr; ---
+    &rArr; foo on page 1
+    &rArr;
+    &rArr;
+    &rArr; bar on page 1
+    &rArr; ---
+    &rArr; baz on page 2
+</pre></div></div>
+
+<p>You might use the following macros to set the baseline of the next
+output text at a given distance from the top or the bottom of the page.
+We subtract one line height (<code class="code">\n.v</code>) because the <code class="code">|</code>
+operator moves to one vee below the page top (recall <a class="ref" href="#Numeric-Expressions">Numeric Expressions</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de y-from-top-down
+.  sp |\\$1-\\n.vu
+..
+.
+.de y-from-bot-up
+.  sp |\\n.pu-\\$1-\\n.vu
+..
+</pre></div></div>
+
+<p>A call to &lsquo;<samp class="samp">.y-from-bot-up 10c</samp>&rsquo; means that the next text baseline
+will be 10&nbsp;cm from the bottom edge of the paper.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002els"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ls</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">count</i></span></var><a class="copiable-link" href='#index-_002els'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ls"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eL_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.L</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eL_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eL"></a>
+<a class="index-entry-id" id="index-double_002dspacing-_0028ls_0029"></a>
+<p>Set the line spacing; add <var class="var">count</var>&minus;1 blank lines after each
+line of text.  With no argument, GNU <code class="code">troff</code> uses the previous
+value before the last <code class="code">ls</code> call.  The default is <code class="code">1</code>.
+</p>
+
+<a class="index-entry-id" id="index-line-spacing-register-_0028_002eL_0029"></a>
+<p>The read-only register <code class="code">.L</code> contains the current line spacing; it
+is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<p>The <code class="code">ls</code> request is a coarse mechanism.  See <a class="xref" href="#Changing-the-Type-Size">Changing the Type Size</a>, for the requests <code class="code">vs</code> and <code class="code">pvs</code> as alternatives to
+<code class="code">ls</code>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cx_0027spacing_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\x<code class="code">'</code></code><span class="r"><i class="slanted">spacing</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cx_0027spacing_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ea_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.a</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ea_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ea"></a>
+<p>Sometimes, an output line requires additional vertical spacing, for
+instance to allow room for a tall construct like an inline equation with
+exponents or subscripts (particularly if they are iterated).  The
+<code class="code">\x</code> escape sequence takes a delimited measurement (like
+&lsquo;<samp class="samp">\x'3p'</samp>&rsquo;) to increase the vertical spacing of the pending output
+line.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  If the measurement is
+positive, extra vertical space is inserted below the current line; a
+negative measurement adds space above.  If <code class="code">\x</code> is applied to the
+pending output line multiple times, the maxima of the positive and
+negative adjustments are separately applied.  The delimiter need not be
+a neutral apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p>
+<a class="index-entry-id" id="index-extra-post_002dvertical-line-space-register-_0028_002ea_0029"></a>
+<p>The <code class="code">.a</code> read-only register contains the extra vertical spacing
+<em class="emph">after</em> the text baseline of the most recently emitted output line.
+(In other words, it is the largest positive argument to <code class="code">\x</code>
+encountered on that line.)  This quantity is exposed via a register
+because if an output line requires this &ldquo;extra post-vertical line
+spacing&rdquo;, and the subsequent output line requires &ldquo;extra pre-vertical
+line spacing&rdquo; (a negative argument to <code class="code">\x</code>), then applying both
+can lead to excessive spacing between the output lines.  Text that is
+piling high on line <var class="var">n</var> might not require (as much) extra
+pre-vertical line spacing if line <var class="var">n</var>&minus;1 carries extra
+post-vertical line spacing.
+</p>
+<p>Use of <code class="code">\x</code> can be necessary in combination with the
+bracket-building escape sequence <code class="code">\b</code>,<a class="footnote" id="DOCF63" href="#FOOT63"><sup>63</sup></a> as the following example shows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+This is a test of \rsb (1).
+This is a test of \rsb (2).
+This is a test of \b'xyz'\x'-1m'\x'1m' (3).
+This is a test of \rsb (4).
+This is a test of \rsb (5).
+    &rArr; This is a test of \b (1).
+    &rArr; This is a test of \b (2).
+    &rArr;                   x
+    &rArr; This is a test of y (3).
+    &rArr;                   z
+    &rArr; This is a test of \b (4).
+    &rArr; This is a test of \b (5).
+</pre></div></div>
+</dd></dl>
+
+<p>Without <code class="code">\x</code>, the backslashes on the lines marked &lsquo;<samp class="samp">(2)</samp>&rsquo; and
+&lsquo;<samp class="samp">(4)</samp>&rsquo; would be overprinted.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ens"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ns</code></strong><a class="copiable-link" href='#index-_002ens'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ns"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ers"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rs</code></strong><a class="copiable-link" href='#index-_002ers'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ens_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ns</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ens_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ens-1"></a>
+<a class="index-entry-id" id="index-sp-request_002c-and-no_002dspace-mode"></a>
+<a class="index-entry-id" id="index-no_002dspace-mode-_0028ns_0029"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dspace-_0028ns_0029"></a>
+<a class="index-entry-id" id="index-blank-lines_002c-disabling"></a>
+<a class="index-entry-id" id="index-lines_002c-blank_002c-disabling"></a>
+<p>Enable <em class="dfn">no-space mode</em>.  Vertical spacing, whether by <code class="code">sp</code>
+requests or blank input lines, is disabled.  The <code class="code">bp</code> request to
+advance to the next page is also disabled, unless it is accompanied by a
+page number (see <a class="pxref" href="#Page-Control">Page Control</a>).  No-space mode ends automatically
+when text<a class="footnote" id="DOCF64" href="#FOOT64"><sup>64</sup></a> is formatted for output <a class="footnote" id="DOCF65" href="#FOOT65"><sup>65</sup></a> or the <code class="code">rs</code> request is invoked, which ends
+no-space mode.  The read-only register <code class="code">.ns</code> interpolates a Boolean
+value indicating the enablement of no-space mode.
+</p>
+<p>A paragraphing macro might ordinarily insert vertical space to separate
+paragraphs.  A section heading macro could invoke <code class="code">ns</code> to suppress
+this spacing for the first paragraph in a section.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Tabs-and-Fields">
+<div class="nav-panel">
+<p>
+Next: <a href="#Character-Translations" accesskey="n" rel="next">Character Translations</a>, Previous: <a href="#Manipulating-Spacing" accesskey="p" rel="prev">Manipulating Spacing</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Tabs-and-Fields-1">5.12 Tabs and Fields</h3>
+<a class="index-entry-id" id="index-tabs_002c-and-fields"></a>
+<a class="index-entry-id" id="index-fields_002c-and-tabs"></a>
+
+<a class="index-entry-id" id="index-tab-character-encoding"></a>
+<p>A tab character (<abbr class="acronym">ISO</abbr> code point&nbsp;9, <abbr class="acronym">EBCDIC</abbr>
+code point&nbsp;5) causes a horizontal movement to the next tab stop, if
+any.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ct-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\t</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ct-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ct"></a>
+<a class="index-entry-id" id="index-tab-character_002c-non_002dinterpreted-_0028_005ct_0029"></a>
+<a class="index-entry-id" id="index-character_002c-tab_002c-non_002dinterpreted-_0028_005ct_0029"></a>
+<a class="index-entry-id" id="index-_005ct_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005ct"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005ct"></a>
+<p>Interpolate a tab in copy mode; see <a class="ref" href="#Copy-Mode">Copy Mode</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eta"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ta</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n1</i></span> <span class="r"><i class="slanted">n2</i></span> &hellip; <span class="r"><i class="slanted">nn</i></span> <code class="t">T</code> <span class="r"><i class="slanted">r1</i></span>  <span class="r"><i class="slanted">r2</i></span> &hellip; <span class="r"><i class="slanted">rn</i></span></var><a class="copiable-link" href='#index-_002eta'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ta"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002etabs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.tabs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002etabs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002etabs"></a>
+<p>Change tab stop positions.  This request takes a series of tab
+specifiers as arguments (optionally divided into two groups with the
+letter &lsquo;<samp class="samp">T</samp>&rsquo;) that indicate where each tab stop is to be, overriding
+any previous settings.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  Invoking
+<code class="code">ta</code> without an argument removes all tab stops.
+<a class="index-entry-id" id="index-default-tab-stops"></a>
+<a class="index-entry-id" id="index-tab-stops_002c-default"></a>
+GNU <code class="code">troff</code>&rsquo;s startup value is &lsquo;<samp class="samp">T&nbsp;0.5i</samp>&rsquo;.
+</p>
+<p>Tab stops can be specified absolutely&mdash;as distances from the left
+margin.  The following example sets six tab stops, one every inch.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i 2i 3i 4i 5i 6i
+</pre></div></div>
+
+<p>Tab stops can also be specified using a leading &lsquo;<samp class="samp">+</samp>&rsquo;, which means
+that the specified tab stop is set relative to the previous tab stop.
+For example, the following is equivalent to the previous example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i +1i +1i +1i +1i +1i
+</pre></div></div>
+
+<p>GNU <code class="code">troff</code> supports an extended syntax to specify repeating tab
+stops.  These stops appear after a &lsquo;<samp class="samp">T</samp>&rsquo; argument.  Their values are
+always taken as distances relative to the previous tab stop.  This is
+the idiomatic way to specify tab stops at equal intervals in
+<code class="code">groff</code>.  The following is, yet again, the same as the previous
+examples.  It does more, in fact, since it defines an infinite number of
+tab stops at one-inch intervals.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta T 1i
+</pre></div></div>
+
+<p>Now we are ready to interpret the full syntax given above.  The
+<code class="code">ta</code> request sets tabs at positions <var class="var">n1</var>, <var class="var">n2</var>, &hellip;,
+<var class="var">nn</var>, then at <var class="var">nn</var>+<var class="var">r1</var>, <var class="var">nn</var>+<var class="var">r2</var>, &hellip;,
+<var class="var">nn</var>+<var class="var">rn</var>, then at <var class="var">nn</var>+<var class="var">rn</var>+<var class="var">r1</var>,
+<var class="var">nn</var>+<var class="var">rn</var>+<var class="var">r2</var>, &hellip;, <var class="var">nn</var>+<var class="var">rn</var>+<var class="var">rn</var>, and so
+on.
+</p>
+<p>For example, &lsquo;<samp class="samp">4c +6c T 3c 5c 2c</samp>&rsquo; is equivalent to &lsquo;<samp class="samp">4c 10c 13c
+18c 20c 23c 28c 30c &hellip;</samp>&rsquo;.
+</p>
+<p>Text written to a tab column (i.e., between two tab stops, or between a
+tab stop and an output line boundary) may be aligned to the right or
+left, or centered in the column.  This alignment is determined by
+appending &lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">L</samp>&rsquo;, or &lsquo;<samp class="samp">C</samp>&rsquo; to the tab specifier.  The
+default is &lsquo;<samp class="samp">L</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i 2iC 3iR
+</pre></div></div>
+
+<p>The beginning of an output line is not a tab stop; the text that begins
+an output line is placed according to the configured alignment and
+indentation; see <a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a> and <a class="ref" href="#Line-Layout">Line Layout</a>.
+</p>
+<p>A tab stop is converted into a non-breakable horizontal movement that
+cannot be adjusted.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 2i
+.ds foo a\tb\tc
+.ta T 1i
+\*foo
+    error&rarr; warning: cannot break line
+    &rArr; a         b         c
+</pre></div></div>
+
+<p>The above creates a single output line that is a bit longer than two
+inches (we use a string to show exactly where the tab stops are).
+Now consider the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 2i
+.ds bar a\tb c\td
+.ta T 1i
+\*bar
+    error&rarr; warning: cannot adjust line
+    &rArr; a         b
+    &rArr; c       d
+</pre></div></div>
+
+<p>GNU <code class="code">troff</code> first converts the line&rsquo;s tab stops into unbreakable
+horizontal movements, then breaks after &lsquo;<samp class="samp">b</samp>&rsquo;.  This usually isn&rsquo;t
+what you want.
+</p>
+<p>Superfluous tab characters&mdash;those that do not correspond to a tab
+stop&mdash;are ignored except for the first, which delimits the characters
+belonging to the last tab stop for right-alignment or centering.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds Z   foo\tbar\tbaz
+.ds ZZ  foo\tbar\tbazqux
+.ds ZZZ foo\tbar\tbaz\tqux
+.ta 2i 4iR
+\*Z
+.br
+\*ZZ
+.br
+\*ZZZ
+.br
+    &rArr; foo                 bar              baz
+    &rArr; foo                 bar           bazqux
+    &rArr; foo                 bar              bazqux
+</pre></div></div>
+
+<p>The first line right-aligns &ldquo;baz&rdquo; within the second tab stop.  The
+second line right-aligns &ldquo;bazqux&rdquo; within it.  The third line
+right-aligns only &ldquo;baz&rdquo; because of the additional tab character, which
+marks the end of the text occupying the last tab stop defined.
+</p>
+<p>Tab stops are associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-tab-stop-settings-register-_0028_002etabs_0029"></a>
+<a class="index-entry-id" id="index-_002eS-register_002c-Plan-9-alias-for-_002etabs"></a>
+<a class="index-entry-id" id="index-_002etabs-register_002c-Plan-9-alias-_0028_002eS_0029"></a>
+<p>The read-only register <code class="code">.tabs</code> contains a string
+representation of the current tab settings suitable for use as an
+argument to the <code class="code">ta</code> request.<a class="footnote" id="DOCF66" href="#FOOT66"><sup>66</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds tab-string \n.tabs
+\*tab-string
+    &rArr; T120u
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002etc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tc"></a>
+<a class="index-entry-id" id="index-tab-repetition-character-_0028tc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-tab-repetition-_0028tc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-tab-repetition-_0028tc_0029"></a>
+<p>Set the tab repetition character to the ordinary or special character
+<var class="var">c</var>; normally, no glyph is written when moving to a tab stop (and
+some output devices may output space characters to achieve this motion).
+A <em class="dfn">tab repetition character</em> causes the formatter to write as many
+instances of <var class="var">c</var> as are necessary to occupy the interval from the
+horizontal drawing position to the next tab stop.  With no argument, GNU
+<code class="code">troff</code> reverts to the default behavior.  The tab repetition
+character is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+Only a single character of <var class="var">c</var> is recognized; any excess is ignored.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elinetabs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.linetabs</code></strong> <var class="def-var-arguments">n</var><a class="copiable-link" href='#index-_002elinetabs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-linetabs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elinetabs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.linetabs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elinetabs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elinetabs-1"></a>
+<a class="index-entry-id" id="index-tab_002c-line_002dtabs-mode"></a>
+<a class="index-entry-id" id="index-line_002dtabs-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-line_002dtabs"></a>
+<p>If <var class="var">n</var> is missing or non-zero, activate <em class="dfn">line-tabs</em>; deactivate
+it otherwise (the default).  Active line-tabs cause GNU <code class="code">troff</code>
+to compute tab distances relative to the start of the output line
+instead of the input line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Tabs
+.  ds x a\t\c
+.  ds y b\t\c
+.  ds z c
+.  ta 1i 3i
+\\*x
+\\*y
+\\*z
+..
+.Tabs
+.br
+.linetabs
+.Tabs
+    &rArr; a         b         c
+    &rArr; a         b                   c
+</pre></div></div>
+
+<p>Line-tabs activation is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).  The read-only register <code class="code">.linetabs</code>
+interpolates&nbsp;1 if line-tabs are active, and 0 otherwise.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Leaders" accesskey="1">Leaders</a></li>
+<li><a href="#Fields" accesskey="2">Fields</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Leaders">
+<div class="nav-panel">
+<p>
+Next: <a href="#Fields" accesskey="n" rel="next">Fields</a>, Previous: <a href="#Tabs-and-Fields" accesskey="p" rel="prev">Tabs and Fields</a>, Up: <a href="#Tabs-and-Fields" accesskey="u" rel="up">Tabs and Fields</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Leaders-1">5.12.1 Leaders</h4>
+<a class="index-entry-id" id="index-leaders"></a>
+
+<p>Sometimes it is desirable to fill a tab stop with a given glyph,
+but also use tab stops normally on the same output line.  An example is
+a table of contents entry that uses dots to bridge the entry name with
+its page number, which is itself aligned between tab stops.  The
+<code class="code">roff</code> language provides <em class="dfn">leaders</em> for this
+purpose.<a class="footnote" id="DOCF67" href="#FOOT67"><sup>67</sup></a>
+</p>
+<a class="index-entry-id" id="index-leader-character-1"></a>
+<p>A leader character (<abbr class="acronym">ISO</abbr> and <abbr class="acronym">EBCDIC</abbr> code
+point&nbsp;1, also known as <abbr class="acronym">SOH</abbr> or &ldquo;start of heading&rdquo;),
+behaves similarly to a tab character: it moves to the next tab stop.
+The difference is that for this movement, the default fill character is
+a period &lsquo;<samp class="samp">.</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ca-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\a</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ca-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ca"></a>
+<a class="index-entry-id" id="index-leader-character_002c-non_002dinterpreted-_0028_005ca_0029"></a>
+<a class="index-entry-id" id="index-character_002c-leader_002c-non_002dinterpreted-_0028_005ca_0029"></a>
+<a class="index-entry-id" id="index-_005ca_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005ca"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005ca"></a>
+<p>Interpolate a leader in copy mode; see <a class="ref" href="#Copy-Mode">Copy Mode</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002elc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lc"></a>
+<a class="index-entry-id" id="index-leader-repetition-character-_0028lc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-leader-repetition-_0028lc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-leader-repetition-_0028lc_0029"></a>
+<p>Set the leader repetition character to the ordinary or special character
+<var class="var">c</var>.  Recall <a class="ref" href="#Tabs-and-Leaders">Tabs and Leaders</a>: when encountering a leader
+character in the input, the formatter writes as many dots &lsquo;<samp class="samp">.</samp>&rsquo; as
+are necessary until
+reaching the next tab stop; this is the <em class="dfn">leader definition
+character</em>.  Omitting <var class="var">c</var> unsets the leader
+character.  With no argument, GNU <code class="code">troff</code> treats leaders the same
+as tabs.  The leader repetition character is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).  Only a single <var class="var">c</var> is
+recognized; any excess is ignored.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-table-of-contents-1"></a>
+<a class="index-entry-id" id="index-contents_002c-table-of-1"></a>
+<p>A table of contents, for example, may define tab stops after a section
+number, a title, and a gap to be filled with leader dots.  The page
+number follows the leader, after a right-aligned final tab stop wide
+enough to house the largest page number occurring in the document.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds entry1 19.\tThe Prophet\a\t98
+.ds entry2 20.\tAll Astir\a\t101
+.ta .5i 4.5i +.5iR
+.nf
+\*entry1
+\*entry2
+    &rArr; 19.  The Prophet.............................   98
+    &rArr; 20.  All Astir...............................  101
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Fields">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Leaders" accesskey="p" rel="prev">Leaders</a>, Up: <a href="#Tabs-and-Fields" accesskey="u" rel="up">Tabs and Fields</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Fields-1">5.12.2 Fields</h4>
+<a class="index-entry-id" id="index-fields"></a>
+
+<a class="index-entry-id" id="index-field-delimiting-character-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-delimiting-character_002c-for-fields-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-field-delimiting-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-field-padding-character-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-padding-character_002c-for-fields-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-field-padding-_0028fc_0029"></a>
+<p><em class="dfn">Fields</em> are a more general way of laying out tabular data.  A field
+is defined as the data between a pair of <em class="dfn">delimiting characters</em>.
+It contains substrings that are separated by <em class="dfn">padding characters</em>.
+The width of a field is the distance on the <em class="emph">input</em> line from the
+position where the field starts to the next tab stop.  A padding
+character inserts an adjustable space similar to TeX&rsquo;s <code class="code">\hss</code>
+command (thus it can even be negative) to make the sum of all substring
+lengths plus the adjustable space equal to the field width.  If more
+than one padding character is inserted, the available space is evenly
+distributed among them.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">delim-char</i></span> <span class="r"><i class="slanted">padding-char</i></span></var><a class="copiable-link" href='#index-_002efc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fc"></a>
+<p>Define a delimiting and a padding character for fields.  If the latter
+is missing, the padding character defaults to a space character.  If
+there is no argument at all, the field mechanism is disabled (which is
+the default).  In contrast to, e.g., the tab repetition character,
+delimiting and padding characters are <em class="emph">not</em> associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fc # ^
+.ta T 3i
+#foo^bar^smurf#
+.br
+#foo^^bar^smurf#
+    &rArr; foo         bar          smurf
+    &rArr; foo            bar       smurf
+</pre></div></div>
+</dd></dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Character-Translations">
+<div class="nav-panel">
+<p>
+Next: <a href="#troff-and-nroff-Modes" accesskey="n" rel="next"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Previous: <a href="#Tabs-and-Fields" accesskey="p" rel="prev">Tabs and Fields</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Character-Translations-1">5.13 Character Translations</h3>
+<a class="index-entry-id" id="index-character-translations"></a>
+<a class="index-entry-id" id="index-translations-of-characters"></a>
+
+<p>A <em class="dfn">translation</em> is a mapping of an input character to an output
+glyph.  The mapping occurs at output time, i.e., the input character
+gets assigned the metric information of the mapped output character
+right before input tokens are converted to nodes (see <a class="pxref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>, for more on this process).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tr</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etrin"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trin</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etrin'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trin"></a>
+<p>Translate character <var class="var">a</var> to glyph&nbsp;<var class="var">b</var>, character <var class="var">c</var> to
+glyph&nbsp;<var class="var">d</var>, and so on.  If there is an odd number of characters
+in the argument, the last one is translated to a fixed-width space (the
+same one obtained by the <code class="code">\<kbd class="key">SP</kbd></code> escape sequence).
+</p>
+<p>The <code class="code">trin</code> request is identical to <code class="code">tr</code>, but when you unformat
+a diversion with <code class="code">asciify</code> it ignores the translation.
+See <a class="xref" href="#Diversions">Diversions</a>, for details about the <code class="code">asciify</code> request.
+</p>
+<p>Some notes:
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-_005c_0028_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_005b_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005cC_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005cN_002c-and-translations"></a>
+<a class="index-entry-id" id="index-char-request_002c-and-translations"></a>
+<a class="index-entry-id" id="index-special-characters-1"></a>
+<a class="index-entry-id" id="index-character_002c-special"></a>
+<a class="index-entry-id" id="index-numbered-glyph-_0028_005cN_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-numbered-_0028_005cN_0029"></a>
+Special characters (<code class="code">\(<var class="var">xx</var></code>, <code class="code">\<var class="var">xxx</var></code>,
+<code class="code">\C'<var class="var">xxx</var>'</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>),
+glyphs defined with the <code class="code">char</code> request, and numbered glyphs
+(<code class="code">\N'<var class="var">xxx</var>'</code>) can be translated also.
+
+</li><li><a class="index-entry-id" id="index-_005ce_002c-and-translations"></a>
+The <code class="code">\e</code> escape can be translated also.
+
+</li><li><a class="index-entry-id" id="index-_005c_0025_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_007e_002c-and-translations"></a>
+Characters can be mapped onto the <code class="code">\%</code> and <code class="code">\~</code> escape
+sequences (but <code class="code">\%</code> and <code class="code">\~</code> can&rsquo;t be mapped onto another
+glyph).
+
+</li><li><a class="index-entry-id" id="index-backspace-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-backspace_002c-and-translations"></a>
+<a class="index-entry-id" id="index-leader-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-leader_002c-and-translations"></a>
+<a class="index-entry-id" id="index-newline-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-newline_002c-and-translations"></a>
+<a class="index-entry-id" id="index-tab-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-tab_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005ca_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005ct_002c-and-translations"></a>
+The following characters can&rsquo;t be translated: space (with one exception,
+see below), backspace, newline, leader (and <code class="code">\a</code>), tab (and
+<code class="code">\t</code>).
+
+</li><li><a class="index-entry-id" id="index-shc-request_002c-and-translations"></a>
+Translations are not considered for finding the soft hyphen character
+set with the <code class="code">shc</code> request.
+
+</li><li><a class="index-entry-id" id="index-_005c_0026_002c-and-translations"></a>
+The pair &lsquo;<samp class="samp"><var class="var">c</var>\&amp;</samp>&rsquo; (an arbitrary character&nbsp;<var class="var">c</var> followed
+by the dummy character) maps this character to &ldquo;nothing&rdquo;.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr a\&amp;
+foo bar
+    &rArr; foo br
+</pre></div></div>
+
+<p>Even the space character can be mapped to the dummy character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr aa \&amp;
+foo bar
+    &rArr; foobar
+</pre></div></div>
+
+<p>As shown in the example, the space character can&rsquo;t be the first
+character/glyph pair as an argument of <code class="code">tr</code>.  Additionally, it is
+not possible to map the space character to any other glyph; requests
+like &lsquo;<samp class="samp">.tr&nbsp;aa&nbsp;x</samp>&rsquo; undo &lsquo;<samp class="samp">.tr&nbsp;aa&nbsp;\&amp;</samp>&rsquo; instead.
+</p>
+<p>If justification is active, lines are justified in spite of the &lsquo;empty&rsquo;
+space character (but there is no minimal distance, i.e., the space
+character, between words).
+</p>
+</li><li>After an output glyph has been constructed (this happens at the moment
+immediately before the glyph is appended to an output glyph list, either
+by direct output, in a macro, diversion, or string), it is no longer
+affected by <code class="code">tr</code>.
+
+</li><li>Translating character to glyphs where one of them or both are undefined
+is possible also; <code class="code">tr</code> does not check whether the elements of its
+argument exist.
+
+<p>See <a class="xref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>.
+</p>
+</li><li>Without an argument, the <code class="code">tr</code> request is ignored.
+</li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etrnt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trnt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etrnt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trnt"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-and-trnt"></a>
+<p><code class="code">trnt</code> is the same as the <code class="code">tr</code> request except that the
+translations do not apply to text that is transparently throughput into
+a diversion with <code class="code">\!</code>.  See <a class="xref" href="#Diversions">Diversions</a>.
+</p>
+<p>For example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr ab
+.di x
+\!.tm a
+.di
+.x
+</pre></div></div>
+
+<p>prints &lsquo;<samp class="samp">b</samp>&rsquo; to the standard error stream; if <code class="code">trnt</code> is used
+instead of <code class="code">tr</code> it prints &lsquo;<samp class="samp">a</samp>&rsquo;.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="troff-and-nroff-Modes">
+<div class="nav-panel">
+<p>
+Next: <a href="#Line-Layout" accesskey="n" rel="next">Line Layout</a>, Previous: <a href="#Character-Translations" accesskey="p" rel="prev">Character Translations</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="troff-and-nroff-Modes-1">5.14 <code class="code">troff</code> and <code class="code">nroff</code> Modes</h3>
+<a class="index-entry-id" id="index-troff-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-troff"></a>
+<a class="index-entry-id" id="index-nroff-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-nroff"></a>
+
+<p>Historically, <code class="code">nroff</code> and <code class="code">troff</code> were two separate programs;
+the former for terminal output, the latter for typesetters.  GNU
+<code class="code">troff</code> merges both functions into one executable<a class="footnote" id="DOCF68" href="#FOOT68"><sup>68</sup></a> that sends its output to a
+device driver (<code class="code">grotty</code> for terminal devices, <code class="code">grops</code> for
+PostScript, and so on) which interprets this intermediate output format.
+When discussing <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, it makes sense to talk
+about <em class="dfn"><code class="code">nroff</code> mode</em> and <em class="dfn"><code class="code">troff</code> mode</em> since the
+differences are hard-coded.  GNU <code class="code">troff</code> takes information from
+device and font description files without handling requests specially if
+a terminal output device is used, so such a strong distinction is
+unnecessary.
+</p>
+<p>Usually, a macro package can be used with all output devices.
+Nevertheless, it is sometimes necessary to make a distinction between
+terminal and non-terminal devices: GNU <code class="code">troff</code> provides two
+built-in conditions &lsquo;<samp class="samp">n</samp>&rsquo; and &lsquo;<samp class="samp">t</samp>&rsquo; for the <code class="code">if</code>, <code class="code">ie</code>,
+and <code class="code">while</code> requests to decide whether GNU <code class="code">troff</code> shall
+behave like <code class="code">nroff</code> or like <code class="code">troff</code>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etroff"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.troff</code></strong><a class="copiable-link" href='#index-_002etroff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-troff"></a>
+<a class="index-entry-id" id="index-troffrc-4"></a>
+<a class="index-entry-id" id="index-troffrc_002dend-2"></a>
+<p>Make the &lsquo;<samp class="samp">t</samp>&rsquo; built-in condition true (and the &lsquo;<samp class="samp">n</samp>&rsquo; built-in
+condition false) for <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> conditional
+requests.  This is the default if GNU <code class="code">troff</code> (<em class="emph">not</em>
+<code class="code">groff</code>) is started with the <samp class="option">-R</samp> switch to avoid loading of
+the startup files <samp class="file">troffrc</samp> and <samp class="file">troffrc-end</samp>.  Without
+<samp class="option">-R</samp>, GNU <code class="code">troff</code> stays in <code class="code">troff</code> mode if the output
+device is not a terminal (e.g., &lsquo;ps&rsquo;).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enroff"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nroff</code></strong><a class="copiable-link" href='#index-_002enroff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nroff"></a>
+<a class="index-entry-id" id="index-tty_002etmac"></a>
+<p>Make the &lsquo;<samp class="samp">n</samp>&rsquo; built-in condition true (and the &lsquo;<samp class="samp">t</samp>&rsquo; built-in
+condition false) for <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> conditional
+requests.  This is the default if GNU <code class="code">troff</code> uses a terminal
+output device; the code for switching to <code class="code">nroff</code> mode is in the
+file <samp class="file">tty.tmac</samp>, which is loaded by the startup file
+<code class="code">troffrc</code>.
+</p></dd></dl>
+
+<p>See <a class="xref" href="#Conditionals-and-Loops">Conditionals and Loops</a>, for more details on built-in conditions.
+</p>
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Line-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="#Line-Continuation" accesskey="n" rel="next">Line Continuation</a>, Previous: <a href="#troff-and-nroff-Modes" accesskey="p" rel="prev"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Line-Layout-1">5.15 Line Layout</h3>
+<a class="index-entry-id" id="index-line-layout"></a>
+<a class="index-entry-id" id="index-layout_002c-line"></a>
+
+<a class="index-entry-id" id="index-dimensions_002c-line"></a>
+<a class="index-entry-id" id="index-line-dimensions"></a>
+<p>The following drawing shows the dimensions that <code class="code">gtroff</code> uses for
+placing a line of output onto the page.  They are labeled with the
+request that manipulates each dimension.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">     --&gt;| in |&lt;--
+        |&lt;-----------ll------------&gt;|
+   +----+----+----------------------+----+
+   |    :    :                      :    |
+   +----+----+----------------------+----+
+--&gt;| po |&lt;--
+   |&lt;--------paper width----------------&gt;|
+</pre></div></div>
+
+<p>These dimensions are:
+</p>
+<dl class="ftable">
+<dt id='index-po'><span><code class="code">po</code><a class="copiable-link" href='#index-po'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-left-margin-_0028po_0029"></a>
+<a class="index-entry-id" id="index-margin_002c-left-_0028po_0029"></a>
+<a class="index-entry-id" id="index-page-offset-_0028po_0029"></a>
+<a class="index-entry-id" id="index-offset_002c-page-_0028po_0029"></a>
+<p><em class="dfn">Page offset</em>&mdash;this is the leftmost position of text on the final
+output, defining the <em class="dfn">left margin</em>.
+</p>
+</dd>
+<dt id='index-in'><span><code class="code">in</code><a class="copiable-link" href='#index-in'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-indentation-_0028in_0029"></a>
+<a class="index-entry-id" id="index-line-indentation-_0028in_0029"></a>
+<p><em class="dfn">Indentation</em>&mdash;this is the distance from the left margin where
+text is printed.
+</p>
+</dd>
+<dt id='index-ll'><span><code class="code">ll</code><a class="copiable-link" href='#index-ll'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-line-length-_0028ll_0029"></a>
+<a class="index-entry-id" id="index-length-of-line-_0028ll_0029"></a>
+<p><em class="dfn">Line length</em>&mdash;this is the distance from the left margin to right
+margin.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-margin_002c-right"></a>
+<a class="index-entry-id" id="index-right-margin"></a>
+<p>The right margin is not explicitly configured; the combination of page
+offset and line length provides the information necessary to derive it.
+</p>
+<p>A simple demonstration:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 3i
+This is text without indentation.
+The line length has been set to 3\~inches.
+.in +.5i
+.ll -.5i
+Now the left and right margins are both increased.
+.in
+.ll
+Calling .in and .ll without parameters restores
+the previous values.
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; This  is text without indenta-
+    &rArr; tion.   The  line  length  has
+    &rArr; been set to 3 inches.
+    &rArr;      Now   the  left  and
+    &rArr;      right  margins   are
+    &rArr;      both increased.
+    &rArr; Calling  .in  and  .ll without
+    &rArr; parameters restores the previ-
+    &rArr; ous values.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-po-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epo-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epo-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eo_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.o</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eo_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eo"></a>
+<a class="index-entry-id" id="index-tty_002etmac-1"></a>
+<p>Set page offset to <var class="var">offset</var> (or increment or decrement its current
+value by <var class="var">offset</var>).  If invoked without an argument, the page offset
+is restored to the value before the previous <code class="code">po</code> request.
+This request does not cause a break; the page offset in effect when an
+output line is broken prevails (see <a class="pxref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>).  The initial value is 1<span class="dmn">i</span> and the default scaling
+unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  On terminal devices, the page offset is set to zero
+by a driver-specific macro file, <samp class="file">tty.tmac</samp>.  The current page
+offset can be found in the read-only register &lsquo;<samp class="samp">.o</samp>&rsquo;.
+<a class="index-entry-id" id="index-CSTR-_002354-errata-1"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-po-request"></a>
+This request is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as using a default scaling unit of &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.po 3i
+\n.o
+    &rArr; 720
+.po -1i
+\n.o
+    &rArr; 480
+.po
+\n.o
+    &rArr; 720
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ein"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-in-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ein-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ein-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ei_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.i</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ei_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ei"></a>
+<p>Set indentation to <var class="var">indent</var> (or increment or decrement the current
+value by <var class="var">indent</var>).  This request causes a break.  Initially, there
+is no indentation.
+</p>
+<p>If <code class="code">in</code> is called without an argument, the indentation is reset to
+the previous value before the last call to <code class="code">in</code>.  The default
+scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<p>If a negative indentation value is specified (which is not allowed),
+<code class="code">gtroff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the
+indentation to zero.
+</p>
+<p>The effect of <code class="code">in</code> is delayed until a partially collected line (if
+it exists) is output.  A temporary indentation value is reset to zero
+also.
+</p>
+<p>The current indentation (as set by <code class="code">in</code>) can be found in the
+read-only register &lsquo;<samp class="samp">.i</samp>&rsquo;.  The indentation is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eti"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments">offset</var><a class="copiable-link" href='#index-_002eti'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ti"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eti-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002eti-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002eti-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002eti-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ein_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.in</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ein_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ein-3"></a>
+<p>Temporarily indent the next output line by <var class="var">offset</var>.  If an
+increment or decrement value is specified, adjust the temporary
+indentation relative to the value set by the <code class="code">in</code> request.
+</p>
+<p>This request causes a break; its value is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).  The default scaling unit is
+&lsquo;<samp class="samp">m</samp>&rsquo;.  A call of <code class="code">ti</code> without an argument is ignored.
+</p>
+<p>If the total indentation value is negative (which is not allowed),
+<code class="code">gtroff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the
+temporary indentation to zero.  &lsquo;Total indentation&rsquo; is either
+<var class="var">offset</var> if specified as an absolute value, or the temporary plus
+normal indentation, if <var class="var">offset</var> is given as a relative value.
+</p>
+<p>The effect of <code class="code">ti</code> is delayed until a partially collected line (if
+it exists) is output.
+</p>
+<p>The read-only register <code class="code">.in</code> is the indentation that applies to the
+current output line.
+</p>
+<p>The difference between <code class="code">.i</code> and <code class="code">.in</code> is that the latter takes
+into account whether a partially collected line still uses the old
+indentation value or a temporary indentation value is active.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ell"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ll-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ell-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ell-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002el_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.l</code></strong><a class="copiable-link" href='#index-_005cn_005b_002el_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002el"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ell_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ll</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ell_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ell-3"></a>
+<p>Set the line length to <var class="var">length</var> (or increment or decrement the
+current value by <var class="var">length</var>).  Initially, the line length is set to
+6.5<span class="dmn">i</span>.  The effect of <code class="code">ll</code> is delayed until a partially
+collected line (if it exists) is output.  The default scaling unit is
+&lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<p>If <code class="code">ll</code> is called without an argument, the line length is reset to
+the previous value before the last call to <code class="code">ll</code>.  If a negative
+line length is specified (which is not allowed), <code class="code">gtroff</code> emits a
+warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the line length to zero.  The
+line length is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-line-length-register-_0028_002el_0029"></a>
+<p>The current line length (as set by <code class="code">ll</code>) can be found in the
+read-only register &lsquo;<samp class="samp">.l</samp>&rsquo;.  The read-only register <code class="code">.ll</code> is the
+line length that applies to the current output line.
+</p>
+<p>Similar to <code class="code">.i</code> and <code class="code">.in</code>, the difference between <code class="code">.l</code>
+and <code class="code">.ll</code> is that the latter takes into account whether a partially
+collected line still uses the old line length value.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Line-Continuation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Page-Layout" accesskey="n" rel="next">Page Layout</a>, Previous: <a href="#Line-Layout" accesskey="p" rel="prev">Line Layout</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Line-Continuation-1">5.16 Line Continuation</h3>
+<a class="index-entry-id" id="index-line-control"></a>
+<a class="index-entry-id" id="index-control_002c-line"></a>
+
+<p>When filling is enabled, input and output line breaks generally do not
+correspond.  The <code class="code">roff</code> language therefore distinguishes input and
+output line continuation.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cRET-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<kbd class="key">RET</kbd></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cRET-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cRET"></a>
+<a class="index-entry-id" id="index-input-line-continuation-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-continuation-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-continuation_002c-input-line-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-_005cnewline"></a>
+<p><code class="code">\<kbd class="key">RET</kbd></code> (a backslash immediately followed by a newline)
+suppresses the effects of that newline in the input.  The next input
+line thus retains the classification of its predecessor as a control or
+text line.  <code class="code">\<kbd class="key">RET</kbd></code> is useful for managing line lengths in the
+input during document maintenance; you can break an input line in the
+middle of a request invocation, macro call, or escape sequence.  Input
+line continuation is invisible to the formatter, with two exceptions:
+the <code class="code">|</code> operator recognizes the new input line
+(see <a class="pxref" href="#Numeric-Expressions">Numeric Expressions</a>), and the input line counter register
+<code class="code">.c</code> is incremented.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 50n
+.de I
+.  ft I
+.  nop \\$*
+.  ft
+..
+Our film class watched
+.I The Effect of Gamma Rays on Man-in-the-Moon
+Marigolds. \&quot; whoops, the input line wrapped
+.br
+.I My own opus begins on line \n.c \
+and ends on line \n.c.
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; Our film class watched <i class="i">The Effect of Gamma Rays on</i>
+    &rArr; <i class="i">Man-in-the-Moon</i> Marigolds.
+    &rArr; <i class="i">My own opus begins on line 11 and ends on line 12.</i>
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cc-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\c</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cc-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cc"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eint_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.int</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eint_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eint"></a>
+<a class="index-entry-id" id="index-output-line_002c-continuation-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-line_002c-output_002c-continuation-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-continuation_002c-output-line-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-interrupted-line"></a>
+<a class="index-entry-id" id="index-line_002c-interrupted"></a>
+<a class="index-entry-id" id="index-_005cR_002c-after-_005cc"></a>
+<p><code class="code">\c</code> continues an output line.  Nothing after it on the input line
+is formatted.  In contrast to <code class="code">\<kbd class="key">RET</kbd></code>, a line after <code class="code">\c</code>
+remains a new input line, so a control character is recognized at its
+beginning.  The visual results depend on whether filling is enabled; see
+<a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-_005cc_002c-when-filling-enabled"></a>
+<a class="index-entry-id" id="index-fill-mode_002c-and-_005cc"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-and-_005cc"></a>
+If filling is enabled, a word interrupted with <code class="code">\c</code> is continued
+with the text on the next input text line, without an intervening space.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">This is a te\c
+st.
+    &rArr; This is a test.
+</pre></div></div>
+
+</li><li><a class="index-entry-id" id="index-_005cc_002c-when-filling-disabled"></a>
+<a class="index-entry-id" id="index-no_002dfill-mode_002c-and-_005cc"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dfill_002c-and-_005cc"></a>
+If filling is disabled, the next input text line after <code class="code">\c</code> is
+handled as a continuation of the same input text line.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+This is a \c
+test.
+    &rArr; This is a test.
+</pre></div></div>
+</li></ul>
+
+<p>An intervening control line that causes a break overrides <code class="code">\c</code>,
+flushing out the pending output line in the usual way.
+</p>
+<a class="index-entry-id" id="index-interrupted-line-register-_0028_002eint_0029"></a>
+<a class="index-entry-id" id="index-continued-output-line-register-_0028_002eint_0029"></a>
+<p>The <code class="code">.int</code> register contains a positive value if the last output
+line was continued with <code class="code">\c</code>; this datum is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).<a class="footnote" id="DOCF69" href="#FOOT69"><sup>69</sup></a>
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Page-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="#Page-Control" accesskey="n" rel="next">Page Control</a>, Previous: <a href="#Line-Continuation" accesskey="p" rel="prev">Line Continuation</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Page-Layout-2">5.17 Page Layout</h3>
+<a class="index-entry-id" id="index-page-layout"></a>
+<a class="index-entry-id" id="index-layout_002c-page"></a>
+
+<p>The formatter permits configuration of the page length and page number.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pl"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epl-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epl-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ep_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.p</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ep_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ep"></a>
+<a class="index-entry-id" id="index-page-length_002c-configuring-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-length-of-the-page_002c-configuring-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-configuring-the-page-length-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-setting-the-page-length-_0028pl_0029"></a>
+<p>Change (increase or decrease) the page length per the numeric expression
+<var class="var">length</var>.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  A negative
+<var class="var">length</var> is valid, but an uncommon application: it prevents page
+location traps from being sprung,<a class="footnote" id="DOCF70" href="#FOOT70"><sup>70</sup></a> and each
+output line is placed on a new page.  If <var class="var">length</var> is invalid, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo;.  If <var class="var">length</var>
+is absent or invalid, &lsquo;<samp class="samp">11i</samp>&rsquo; is assumed.
+</p>
+<a class="index-entry-id" id="index-page-length-register-_0028_002ep_0029"></a>
+<p>The read-only register &lsquo;<samp class="samp">.p</samp>&rsquo; interpolates the current page length.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments">num</var><a class="copiable-link" href='#index-_002epn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epn-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">num</i></span></var><a class="copiable-link" href='#index-_002epn-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epn-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">num</i></span></var><a class="copiable-link" href='#index-_002epn-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002epn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epn-3"></a>
+<a class="index-entry-id" id="index-page-number_002c-configuring-next-_0028pn_0029"></a>
+<a class="index-entry-id" id="index-next-page-number_002c-configuring-_0028pn_0029"></a>
+<a class="index-entry-id" id="index-number_002c-page_002c-next_002c-configuring-_0028pn_0029"></a>
+<p>Change (increase or decrease) the page number of the <em class="emph">next</em> page
+per the numeric expression <var class="var">num</var>.  If <var class="var">num</var> is invalid, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and ignores the
+request.  Without an argument, <code class="code">pn</code> is ignored.
+</p>
+<a class="index-entry-id" id="index-next-page-number-register-_0028_002epn_0029"></a>
+<a class="index-entry-id" id="index-page-number_002c-next_002c-register-_0028_002epn_0029"></a>
+<p>The read-only register <code class="code">.pn</code> interpolates <var class="var">num</var> if set by
+<code class="code">pn</code> on the current page, or the current page number plus&nbsp;1.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-headers"></a>
+<a class="index-entry-id" id="index-footers"></a>
+<a class="index-entry-id" id="index-titles"></a>
+<p>The formatter offers special support for typesetting headers and
+footers, collectively termed <em class="dfn">titles</em>.  Titles have an independent
+line length, and their placement on the page is not restricted.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tl</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002etl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tl"></a>
+<a class="index-entry-id" id="index-title-line_002c-formatting-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-formatting-a-title-line-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-three_002dpart-title-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-page-number-character-_0028_0025_0029"></a>
+<p>Format an output line as a title consisting of <var class="var">left</var>, <var class="var">center</var>,
+and <var class="var">right</var>, each aligned accordingly.  The delimiter need not be a
+neutral apostrophe: <code class="code">tl</code> accepts the same delimiters as most escape
+sequences; see <a class="ref" href="#Delimiters">Delimiters</a>.  If not used as the delimiter, any
+<em class="dfn">page number character</em> character is replaced with the current page
+number; the default is &lsquo;<samp class="samp">%</samp>&rsquo;; see the the <code class="code">pc</code> request below.
+Without an argument, <code class="code">tl</code> is ignored.  <code class="code">tl</code> writes the title
+line immediately, ignoring any partially collected line.
+</p>
+<p>It is not an error to omit delimiters after the first.  For example,
+&lsquo;<samp class="samp">.tl&nbsp;/Thesis</samp>&rsquo; is interpreted as &lsquo;<samp class="samp">.tl&nbsp;/Thesis///</samp>&rsquo;: it
+sets a title line comprising only the left-aligned word &lsquo;<samp class="samp">Thesis</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002elt-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002elt-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.lt</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elt-3"></a>
+<a class="index-entry-id" id="index-length-of-title-line_002c-configuring-_0028lt_0029"></a>
+<a class="index-entry-id" id="index-title-length_002c-configuring-_0028lt_0029"></a>
+<p>Change (increase or decrease) the line length used by titles per the
+numeric expression <var class="var">length</var>.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+If <var class="var">length</var> is negative, GNU emits a warning in category
+&lsquo;<samp class="samp">range</samp>&rsquo; and treats <var class="var">length</var> as &lsquo;<samp class="samp">0</samp>&rsquo;.  If <var class="var">length</var> is
+invalid, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and
+ignores the request.  The formatter&rsquo;s default title length is
+&lsquo;<samp class="samp">6.5i</samp>&rsquo;.  With no argument, the title length is restored to the
+previous value.  The title length is is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-title-line-length-register-_0028_002elt_0029"></a>
+<p>The read-only register &lsquo;<samp class="samp">.lt</samp>&rsquo; interpolates the title line length.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">char</i></span></var><a class="copiable-link" href='#index-_002epc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pc"></a>
+<a class="index-entry-id" id="index-changing-the-page-number-character-_0028pc_0029"></a>
+<a class="index-entry-id" id="index-page-number-character_002c-changing-_0028pc_0029"></a>
+<a class="index-entry-id" id="index-_0025-1"></a>
+<p>Set the page number character to <var class="var">char</var>.  With no argument, the page
+number character is disabled.  <code class="code">pc</code> does not affect the
+register&nbsp;<code class="code">%</code>.
+</p></dd></dl>
+
+<p>The following example exercises title features.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.lt 50n
+This is my partially collected
+.tl 'Isomers 2023'%'Dextrose Edition'
+line.
+    &rArr; Isomers 2023             1        Dextrose Edition
+    &rArr; This is my partially collected line.
+</pre></div></div>
+
+<p>We most often see titles used in page header and footer traps.
+See <a class="xref" href="#Traps">Traps</a>.
+</p>
+
+<hr>
+</div>
+<div class="section-level-extent" id="Page-Control">
+<div class="nav-panel">
+<p>
+Next: <a href="#Using-Fonts" accesskey="n" rel="next">Using Fonts</a>, Previous: <a href="#Page-Layout" accesskey="p" rel="prev">Page Layout</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Page-Control-1">5.18 Page Control</h3>
+<a class="index-entry-id" id="index-page-control"></a>
+<a class="index-entry-id" id="index-control_002c-page"></a>
+
+<a class="index-entry-id" id="index-page-break-1"></a>
+<a class="index-entry-id" id="index-break_002c-page-1"></a>
+<a class="index-entry-id" id="index-page-ejection-1"></a>
+<a class="index-entry-id" id="index-ejection_002c-page-1"></a>
+<p>Discretionary page breaks can prevent the unwanted separation of
+content.  A new page number takes effect during page ejection; see
+<a class="ref" href="#The-Implicit-Page-Trap">The Implicit Page Trap</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-bp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ebp-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ebp-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_0025_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n%</code></strong><a class="copiable-link" href='#index-_005cn_005b_0025_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0025-2"></a>
+<a class="index-entry-id" id="index-new-page-_0028bp_0029"></a>
+<a class="index-entry-id" id="index-page_002c-new-_0028bp_0029"></a>
+<p>Break the page and change (increase or decrease) the next page number
+per the numeric expression <var class="var">page-number</var>.  If <var class="var">page-number</var> is
+invalid, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and
+ignores the argument.  This request causes a break.  A page break
+advances the vertical drawing position to the bottom of the page,
+springing traps.  See <a class="xref" href="#Page-Location-Traps">Page Location Traps</a>.
+<a class="index-entry-id" id="index-bp-request_002c-and-top_002dlevel-diversion"></a>
+<a class="index-entry-id" id="index-top_002dlevel-diversion_002c-and-bp"></a>
+<a class="index-entry-id" id="index-diversion_002c-top_002dlevel_002c-and-bp"></a>
+<code class="code">bp</code> has effect only if invoked within the top-level
+diversion.<a class="footnote" id="DOCF71" href="#FOOT71"><sup>71</sup></a>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-2"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-bp-request"></a>
+This request is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as having a default scaling unit of &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-page-number-register-_0028_0025_0029"></a>
+<a class="index-entry-id" id="index-current-page-number-_0028_0025_0029"></a>
+<p>The register <code class="code">%</code> interpolates the current page number.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de BP
+'  bp \&quot; schedule page break once current line is output
+..
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ene"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ne</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002ene'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ne"></a>
+<a class="index-entry-id" id="index-orphan-lines_002c-preventing-with-ne"></a>
+<a class="index-entry-id" id="index-conditional-page-break-_0028ne_0029"></a>
+<a class="index-entry-id" id="index-page-break_002c-conditional-_0028ne_0029"></a>
+<p>Force a page break if insufficient vertical space is available (assert
+&ldquo;needed&rdquo; space).  <code class="code">ne</code> tests the distance to the next page
+location trap; see <a class="ref" href="#Page-Location-Traps">Page Location Traps</a>, and breaks the page if
+that amount is less than <var class="var">space</var>.  The default scaling unit is
+&lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">space</var> is invalid, GNU <code class="code">troff</code> emits a warning
+in category &lsquo;<samp class="samp">number</samp>&rsquo; and ignores the argument.  If <var class="var">space</var> is
+not specified, &lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p>
+<a class="index-entry-id" id="index-widow"></a>
+<p>We can require space for at least the first two output lines of a
+paragraph, preventing its first line from being <i class="slanted">widowed</i> at the
+page bottom.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ne 2v
+Considering how common illness is,
+how tremendous the spiritual change that it brings,
+how astonishing,
+when the lights of health go down,
+the undiscovered countries that are then disclosed,
+what wastes and deserts of the soul a slight attack
+of influenza brings to view,
+</pre></div></div>
+
+<p>This method is reliable only if no output line is pending when <code class="code">ne</code>
+is invoked.  When macro packages are used, this is often not the case:
+their paragraphing macros perform the break.  You may need to experiment
+with placing the <code class="code">ne</code> after the paragraphing macro, or <code class="code">br</code>
+and <code class="code">ne</code> before it.
+</p>
+<a class="index-entry-id" id="index-orphan"></a>
+<a class="index-entry-id" id="index-widow-1"></a>
+<p><code class="code">ne</code> is also useful to force grouping of section headings with
+their subsequent paragraphs, or tables with their captions and/or
+explanations.  Macro packages often use <code class="code">ne</code> with diversions to
+implement keeps and displays; see <a class="ref" href="#Diversions">Diversions</a>.  They may also offer
+parameters for widow and orphan management.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esv"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sv</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002esv'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sv"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eos"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.os</code></strong><a class="copiable-link" href='#index-_002eos'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-os"></a>
+<a class="index-entry-id" id="index-ne-request_002c-comparison-with-sv"></a>
+<p>Require vertical space as <code class="code">ne</code> does, but also <i class="slanted">save</i> it for
+later output by the <code class="code">os</code> request.  If <var class="var">space</var> is available
+before the next page location trap, it is output immediately.  Both
+requests ignore a partially collected line, taking effect at the next
+break.
+<a class="index-entry-id" id="index-sv-request_002c-and-no_002dspace-mode"></a>
+<a class="index-entry-id" id="index-os-request_002c-and-no_002dspace-mode"></a>
+<code class="code">sv</code> and <code class="code">os</code> ignore no-space mode (recall <a class="ref" href="#Manipulating-Spacing">Manipulating Spacing</a>).  While the <code class="code">sv</code> request allows negative values for
+<var class="var">space</var>, <code class="code">os</code> ignores them.  The default scaling unit is
+&lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">space</var> is not specified, &lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bnl_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nnl</code></strong><a class="copiable-link" href='#index-_005cn_005bnl_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nl"></a>
+<a class="index-entry-id" id="index-vertical-drawing-position-_0028nl_0029"></a>
+<a class="index-entry-id" id="index-vertical-position_002c-drawing-_0028nl_0029"></a>
+<a class="index-entry-id" id="index-drawing-position_002c-vertical-_0028nl_0029"></a>
+<p><code class="code">nl</code> interpolates or sets the vertical drawing position.  When the
+formatter starts, the first page transition hasn&rsquo;t happened yet, and
+<code class="code">nl</code> is negative.  If a header trap has been planted on the page
+(typically at vertical position <code class="code">0</code>), you can assign a negative
+value to <code class="code">nl</code> to spring it if that page has already started
+(see <a class="pxref" href="#Page-Location-Traps">Page Location Traps</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de HD
+.  sp
+.  tl ''Goldbach Solution''
+.  sp
+..
+.
+First page.
+.bp
+.wh 0 HD \&quot; plant header trap at top of page
+.nr nl (-1)
+Second page.
+    &rArr; First page.
+    &rArr;
+    &rArr; <span class="r"><i class="i">(blank lines elided)</i></span>
+    &rArr;
+    &rArr;                         Goldbach Solution
+    &rArr;
+    &rArr; <span class="r"><i class="i">(blank lines elided)</i></span>
+    &rArr;
+    &rArr; Second page.
+</pre></div></div>
+
+<p>Without resetting <code class="code">nl</code> to a negative value, the trap just planted
+would be active beginning with the <em class="emph">next</em> page, not the current
+one.
+</p>
+<p>See <a class="xref" href="#Diversions">Diversions</a>, for a comparison of <code class="code">nl</code> with the <code class="code">.h</code> and
+<code class="code">.d</code> registers.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Using-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="n" rel="next">Manipulating Type Size and Vertical Spacing</a>, Previous: <a href="#Page-Control" accesskey="p" rel="prev">Page Control</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Using-Fonts-1">5.19 Using Fonts</h3>
+<a class="index-entry-id" id="index-font"></a>
+
+<a class="index-entry-id" id="index-typeface"></a>
+<a class="index-entry-id" id="index-font-family"></a>
+<a class="index-entry-id" id="index-font-style"></a>
+<a class="index-entry-id" id="index-style_002c-font"></a>
+<a class="index-entry-id" id="index-family_002c-font"></a>
+<a class="index-entry-id" id="index-text-font"></a>
+<a class="index-entry-id" id="index-special-font"></a>
+<a class="index-entry-id" id="index-unstyled-font"></a>
+<a class="index-entry-id" id="index-font_002c-text"></a>
+<a class="index-entry-id" id="index-font_002c-special"></a>
+<a class="index-entry-id" id="index-font_002c-unstyled"></a>
+<p>In digital typography, a <em class="dfn">font</em> is a collection of characters in a
+specific typeface that a device can render as glyphs at a desired
+size.<a class="footnote" id="DOCF72" href="#FOOT72"><sup>72</sup></a>  A <code class="code">roff</code> formatter can change typefaces at any
+point in the text.  The basic faces are a set of <em class="dfn">styles</em> combining
+upright and slanted shapes with normal and heavy stroke weights:
+&lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">I</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo;&mdash;these stand for
+<i class="slanted">roman</i>, <i class="slanted">italic</i>, <i class="slanted">bold</i>, and
+<i class="slanted">bold-italic</i>.  For linguistic text, GNU <code class="code">troff</code> groups
+typefaces into <em class="dfn">families</em> containing each of these
+styles.<a class="footnote" id="DOCF73" href="#FOOT73"><sup>73</sup></a>  A <em class="dfn">text font</em> is thus often a family
+combined with a style, but it need not be: consider the <code class="code">ps</code> and
+<code class="code">pdf</code> devices&rsquo; <code class="code">ZCMI</code> (Zapf Chancery Medium italic)&mdash;often,
+no other style of Zapf Chancery Medium is provided.  On typesetting
+devices, at least one <em class="dfn">special font</em> is available, comprising
+<em class="dfn">unstyled</em> glyphs for mathematical operators and other purposes.
+</p>
+<a class="index-entry-id" id="index-font-description-file"></a>
+<a class="index-entry-id" id="index-description-file_002c-font"></a>
+<a class="index-entry-id" id="index-file_002c-font-description"></a>
+<a class="index-entry-id" id="index-font-metrics"></a>
+<a class="index-entry-id" id="index-metrics_002c-font"></a>
+<a class="index-entry-id" id="index-mounting-position"></a>
+<a class="index-entry-id" id="index-mounting-position-1"></a>
+<a class="index-entry-id" id="index-position_002c-mounting"></a>
+<p>Like <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, GNU <code class="code">troff</code> does not itself load
+or manipulate a digital font file;<a class="footnote" id="DOCF74" href="#FOOT74"><sup>74</sup></a> instead it
+works with a <em class="dfn">font description file</em> that characterizes it,
+including its glyph repertoire and the <em class="dfn">metrics</em> (dimensions) of
+each glyph.<a class="footnote" id="DOCF75" href="#FOOT75"><sup>75</sup></a>  This
+information permits the formatter to accurately place glyphs with
+respect to each other.  Before using a font description, the formatter
+associates it with a <em class="dfn">mounting position</em>, a place in an ordered list
+of available typefaces.
+<a class="index-entry-id" id="index-abstract-font-style"></a>
+<a class="index-entry-id" id="index-font-style_002c-abstract"></a>
+<a class="index-entry-id" id="index-style_002c-font_002c-abstract"></a>
+So that a document need not be strongly coupled to a specific font
+family, in GNU <code class="code">troff</code> an output device can associate a style in
+the abstract sense with a mounting position.  Thus the default family
+can be combined with a style dynamically, producing a <em class="dfn">resolved font
+name</em>.
+</p>
+<p>Fonts often have trademarked names, and even Free Software fonts can
+require renaming upon modification.  <code class="code">groff</code> maintains a
+convention that a device&rsquo;s serif font family is given the name &lsquo;<samp class="samp">T</samp>&rsquo;
+(&ldquo;Times&rdquo;), its sans-serif family &lsquo;<samp class="samp">H</samp>&rsquo; (&ldquo;Helvetica&rdquo;), and its
+monospaced family &lsquo;<samp class="samp">C</samp>&rsquo; (&ldquo;Courier&rdquo;).  Historical inertia has driven
+<code class="code">groff</code>&rsquo;s font identifiers to short uppercase abbreviations of font
+names, as with &lsquo;<samp class="samp">TR</samp>&rsquo;, &lsquo;<samp class="samp">TI</samp>&rsquo;, &lsquo;<samp class="samp">TB</samp>&rsquo;, &lsquo;<samp class="samp">TBI</samp>&rsquo;, and a
+special font &lsquo;<samp class="samp">S</samp>&rsquo;.
+</p>
+<p>The default family used with abstract styles can be changed at any time;
+initially, it is &lsquo;<samp class="samp">T</samp>&rsquo;.  Typically, abstract styles are arranged in
+the first four mounting positions in the order shown above.  The default
+mounting position, and therefore style, is always &lsquo;<samp class="samp">1</samp>&rsquo; (&lsquo;<samp class="samp">R</samp>&rsquo;).
+By issuing appropriate formatter instructions, you can override these
+defaults before your document writes its first glyph.
+</p>
+<a class="index-entry-id" id="index-graphic-renditions"></a>
+<a class="index-entry-id" id="index-renditions_002c-graphic"></a>
+<a class="index-entry-id" id="index-character-cell-attributes"></a>
+<a class="index-entry-id" id="index-attributes_002c-character-cell"></a>
+<a class="index-entry-id" id="index-cell_002c-character_002c-attributes"></a>
+<p>Terminal output devices cannot change font families and lack special
+fonts.  They support style changes by overstriking, or by altering
+ISO&nbsp;6429/ECMA-48 <em class="dfn">graphic renditions</em> (character cell
+attributes).
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Selecting-Fonts" accesskey="1">Selecting Fonts</a></li>
+<li><a href="#Font-Families" accesskey="2">Font Families</a></li>
+<li><a href="#Font-Positions" accesskey="3">Font Positions</a></li>
+<li><a href="#Using-Symbols" accesskey="4">Using Symbols</a></li>
+<li><a href="#Character-Classes" accesskey="5">Character Classes</a></li>
+<li><a href="#Special-Fonts" accesskey="6">Special Fonts</a></li>
+<li><a href="#Artificial-Fonts" accesskey="7">Artificial Fonts</a></li>
+<li><a href="#Ligatures-and-Kerning" accesskey="8">Ligatures and Kerning</a></li>
+<li><a href="#Italic-Corrections" accesskey="9">Italic Corrections</a></li>
+<li><a href="#Dummy-Characters">Dummy Characters</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Selecting-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="#Font-Families" accesskey="n" rel="next">Font Families</a>, Previous: <a href="#Using-Fonts" accesskey="p" rel="prev">Using Fonts</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Selecting-Fonts-1">5.19.1 Selecting Fonts</h4>
+<a class="index-entry-id" id="index-font_002c-selection"></a>
+
+<p>We use <em class="dfn">font</em> to refer to any of several means of identifying a
+font: by mounting position (&lsquo;<samp class="samp">3</samp>&rsquo;), by abstract style (&lsquo;<samp class="samp">B</samp>&rsquo;), or
+by its identifier (&lsquo;<samp class="samp">TB</samp>&rsquo;).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eft"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ft</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">font</i></span></var><a class="copiable-link" href='#index-_002eft'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ft"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cff"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f</code><span class="r"><i class="slanted">f</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cf_0028fn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f(</code><span class="r"><i class="slanted">fn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cf_0028fn'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cf_005bfont_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f</code><span class="r"><i class="slanted">font</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cf_005bfont_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efn"></a>
+<a class="index-entry-id" id="index-changing-fonts-_0028ft_002c-_005cf_0029"></a>
+<a class="index-entry-id" id="index-fonts_002c-changing-_0028ft_002c-_005cf_0029"></a>
+<a class="index-entry-id" id="index-sty-request_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-fam-request_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-_005cF_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-styles"></a>
+<a class="index-entry-id" id="index-family"></a>
+<a class="index-entry-id" id="index-DESC"></a>
+<a class="index-entry-id" id="index-selecting-the-previous-font-_0028ft_0029"></a>
+<a class="index-entry-id" id="index-previous-font_002c-selecting-_0028ft_0029"></a>
+<a class="index-entry-id" id="index-font_002c-previous_002c-slecting-_0028ft_0029"></a>
+<p>The <code class="code">ft</code> request selects the typeface <var class="var">font</var>.  If the argument
+is absent or &lsquo;<samp class="samp">P</samp>&rsquo;, it selects the previously chosen font.  If
+<var class="var">font</var> is a non-negative integer, it is interpreted as mounting
+position; the font mounted there is selected.  If that position refers
+to an abstract style, it is combined with the default family (see
+<code class="code">fam</code> and <code class="code">\F</code> below) to make a resolved font name.  If the
+mounting position is not a style and no font is mounted there, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">font</samp>&rsquo; and ignores the
+request.
+</p>
+<p>If <var class="var">font</var> matches a style name, it is combined with the current
+family to make a resolved font name.  Otherwise, <var class="var">font</var> is assumed
+to already be a resolved font name.
+</p>
+<a class="index-entry-id" id="index-automatic-font-mounting"></a>
+<a class="index-entry-id" id="index-font-mounting_002c-automatic"></a>
+<a class="index-entry-id" id="index-mounting_002c-font_002c-automatic"></a>
+<p>The resolved font name is subject to translation (see request <code class="code">ftr</code>
+below).  Next, the (possibly translated) font name&rsquo;s mounting position
+is looked up; if not mounted, <var class="var">font</var> is sought on the file system as
+a font description file and, if located, automatically mounted at the
+next available position (see register <code class="code">.fp</code> below).  If the font
+was mounted using an identifier different from its font description file
+name (see request <code class="code">fp</code> below), that file name is then looked up.
+If a font description file for the resolved font name is not found, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">font</samp>&rsquo; and ignores the
+request.
+</p>
+<p>The <code class="code">\f</code> escape sequence is similar, using one-character name (or
+mounting position) <var class="var">f</var>, two-character name <var class="var">fn</var>, or a name
+<var class="var">font</var> of arbitrary length.
+<a class="index-entry-id" id="index-previous-font_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029"></a>
+<a class="index-entry-id" id="index-font_002c-previous_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029"></a>
+&lsquo;<samp class="samp">\f</samp>&rsquo; selects the previous font.  The syntax form &lsquo;<samp class="samp">\fP</samp>&rsquo; is
+supported for backward compatibility, and &lsquo;<samp class="samp">\fP</samp>&rsquo; for consistency.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">eggs, bacon,
+.ft I
+spam,
+.ft
+and sausage.
+.br
+eggs, bacon, \fIspam,\fP and sausage.
+    &rArr; eggs, bacon, <i class="slanted">spam,</i> and sausage
+    &rArr; eggs, bacon, <i class="slanted">spam,</i> and sausage
+</pre></div></div>
+
+<p>The current and previously selected fonts are properties of the
+environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>The read-only string-valued register <code class="code">.fn</code> contains the resolved
+font name of the selected font.
+</p>
+<p><code class="code">\f</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>; it thus
+can be used in requests that expect a single-character argument.  We can
+assign a font to a margin character as follows (see <a class="pxref" href="#Miscellaneous">Miscellaneous</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \fIx\f
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eftr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ftr</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">g</i></span></var><a class="copiable-link" href='#index-_002eftr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ftr"></a>
+<a class="index-entry-id" id="index-font-translation-_0028ftr_0029"></a>
+<a class="index-entry-id" id="index-ft-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-ul-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-bd-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-_005cf_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-cs-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-special-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-fp-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-sty-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-if-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-ie-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-while-request_002c-and-font-translations"></a>
+<p>Translate font&nbsp;<var class="var">f</var> to font&nbsp;<var class="var">g</var>.  Whenever a font
+named&nbsp;<var class="var">f</var> is referred to in a <code class="code">\f</code> escape sequence, in the
+<code class="code">F</code> and <code class="code">S</code> conditional operators, or in the <code class="code">ft</code>,
+<code class="code">ul</code>, <code class="code">bd</code>, <code class="code">cs</code>, <code class="code">tkf</code>, <code class="code">special</code>,
+<code class="code">fspecial</code>, <code class="code">fp</code>, or <code class="code">sty</code> requests, font&nbsp;<var class="var">g</var> is
+used.  If <var class="var">g</var> is missing or equal to&nbsp;<var class="var">f</var> the translation is
+undone.
+</p>
+<p>Font translations cannot be chained.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ftr XXX TR
+.ftr XXX YYY
+.ft XXX
+    error&rarr; warning: can't find font 'XXX'
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efzoom"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fzoom</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">zoom</i></span></var><a class="copiable-link" href='#index-_002efzoom'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fzoom"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ezoom_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.zoom</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ezoom_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ezoom"></a>
+<a class="index-entry-id" id="index-magnification-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-font_002c-magnification-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-zoom-factor-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-factor_002c-zoom_002c-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-font_002c-zoom-factor-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-optical-size-of-a-font"></a>
+<a class="index-entry-id" id="index-font_002c-optical-size"></a>
+<a class="index-entry-id" id="index-size_002c-optical_002c-of-a-font"></a>
+<p>Set magnification of font&nbsp;<var class="var">f</var> to factor <var class="var">zoom</var>, which must
+be a non-negative integer multiple of 1/1000th.  This request is useful
+to adjust the optical size of a font in relation to the others.  In the
+example below, font <code class="code">CR</code> is magnified by 10% (the zoom factor is
+thus 1.1).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fam P
+.fzoom CR 1100
+.ps 12
+Palatino and \fCRCourier\f
+</pre></div></div>
+
+<p>A missing or zero value of <var class="var">zoom</var> is the same as a value of 1000,
+which means no magnification.  <var class="var">f</var>&nbsp;must be a resolved font
+name, not an abstract style.
+</p>
+<p>The magnification of a font is completely transparent to GNU
+<code class="code">troff</code>; a change of the zoom factor doesn&rsquo;t cause any effect
+except that the dimensions of glyphs, (word) spaces, kerns, etc., of the
+affected font are adjusted accordingly.
+</p>
+<p>The zoom factor of the current font is available in the read-only
+register &lsquo;<samp class="samp">.zoom</samp>&rsquo;, in multiples of 1/1000th.  It returns zero if
+there is no magnification.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Font-Families">
+<div class="nav-panel">
+<p>
+Next: <a href="#Font-Positions" accesskey="n" rel="next">Font Positions</a>, Previous: <a href="#Selecting-Fonts" accesskey="p" rel="prev">Selecting Fonts</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Font-Families-1">5.19.2 Font Families</h4>
+<a class="index-entry-id" id="index-font-families"></a>
+<a class="index-entry-id" id="index-families_002c-font"></a>
+<a class="index-entry-id" id="index-font-styles"></a>
+<a class="index-entry-id" id="index-styles_002c-font"></a>
+
+<p>To accommodate the wide variety of fonts available, GNU <code class="code">troff</code>
+distinguishes <em class="dfn">font families</em> and <em class="dfn">font styles</em>.  A resolved
+font name is the catenation of a font family and a style.  Selecting an
+abstract style causes GNU <code class="code">troff</code> to combine it with the default
+font family.
+</p>
+<p>You can thus compose a document using abstract styles exclusively for
+its body or running text, selecting a specific family only for titles or
+examples, for instance, and change the default family on the command
+line (recall <a class="ref" href="#Groff-Options">Options</a>).
+</p>
+<p>Fonts for the devices <code class="code">ps</code>, <code class="code">pdf</code>, <code class="code">dvi</code>, <code class="code">lj4</code>,
+<code class="code">lbp</code>, and the X11 devices support this mechanism.  By default,
+GNU <code class="code">troff</code> uses the Times family with the four styles &lsquo;<samp class="samp">R</samp>&rsquo;,
+&lsquo;<samp class="samp">I</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efam"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fam</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">family</i></span></var><a class="copiable-link" href='#index-_002efam'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fam"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efam_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fam</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efam_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efam-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cFf"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F</code><span class="r"><i class="slanted">f</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cFf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cF"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cF_0028fm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F(</code><span class="r"><i class="slanted">fm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cF_0028fm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cF_005bfamily_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F</code><span class="r"><i class="slanted">family</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cF_005bfamily_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-changing-font-family-_0028fam_002c-_005cF_0029"></a>
+<a class="index-entry-id" id="index-font-family_002c-changing-_0028fam_002c-_005cF_0029"></a>
+<p>Set the default font family, used in combination with abstract styles to
+construct a resolved font name, to <var class="var">family</var> (one-character
+name&nbsp;<var class="var">f</var>, two-character name <var class="var">fm</var>).  If no argument is
+given, GNU <code class="code">troff</code> selects the previous font family; if there none,
+is it falls back to the device&rsquo;s default<a class="footnote" id="DOCF76" href="#FOOT76"><sup>76</sup></a> or its own (&lsquo;<samp class="samp">T</samp>&rsquo;).
+</p>
+<p>The <code class="code">\F</code> escape sequence works similarly.  In disanalogy to
+<code class="code">\f</code>, &lsquo;<samp class="samp">\FP</samp>&rsquo; makes &lsquo;<samp class="samp">P</samp>&rsquo; the default family.  Use
+&lsquo;<samp class="samp">\F</samp>&rsquo; to select the previous default family.  The default font
+family is available in the read-only string-valued register <code class="code">.fam</code>;
+it is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">spam,     \&quot; startup defaults are T (Times) R (roman)
+.fam H    \&quot; make Helvetica the default family
+spam,     \&quot; family H + style R = HR
+.ft B     \&quot; family H + style B = HB
+spam,
+.ft CR    \&quot; Courier roman (default family not changed)
+spam,
+.ft       \&quot; back to Helvetica bold
+spam,
+.fam T    \&quot; make Times the default family
+spam,     \&quot; family T + style B = TB
+.ft AR    \&quot; font AR (not a style)
+baked beans,
+.ft R     \&quot; family T + style R = TR
+and spam.
+</pre></div></div>
+
+<p><code class="code">\F</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font family on the fly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \FPx\F
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esty"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sty</code></strong> <var class="def-var-arguments">n style</var><a class="copiable-link" href='#index-_002esty'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sty"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esty_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sty</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esty_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esty-1"></a>
+<a class="index-entry-id" id="index-setting-up-an-abstract-font-style-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-abstract-font-style_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-font-style_002c-abstract_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-style_002c-font_002c-abstract_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-cs-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-bd-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-uf-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-font-styles"></a>
+<p>Associate an abstract style <var class="var">style</var> with mounting
+position&nbsp;<var class="var">n</var>, which must be a non-negative integer.  If the
+requests <code class="code">cs</code>, <code class="code">bd</code>, <code class="code">tkf</code>, <code class="code">uf</code>, or <code class="code">fspecial</code>
+are applied to an abstract style, they are instead applied to the member
+of the current family corresponding to that style.
+</p>
+<a class="index-entry-id" id="index-DESC-1"></a>
+<a class="index-entry-id" id="index-styles-1"></a>
+<p>The default family can be set with the <samp class="option">-f</samp> option (see <a class="pxref" href="#Groff-Options">Options</a>).  The <code class="code">styles</code> command in the <samp class="file">DESC</samp> file controls
+which font positions (if any) are initially associated with abstract
+styles rather than fonts.
+</p>
+<p><strong class="strong">Caution:</strong> The <var class="var">style</var> argument is not validated.
+Errors may occur later, when the formatter attempts to construct a
+resolved font name, or format a character for output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr BarPos \n.fp
+.sty \n.fp Bar
+.fam Foo
+.ft \nBarPos
+.tm .f=\n.f
+A
+    error&rarr; error: no font family named 'Foo' exists
+    error&rarr; .f=41
+    error&rarr; error: cannot format glyph: no current font
+</pre></div></div>
+
+<p>When an abstract style has been selected, the read-only string-valued
+register &lsquo;<samp class="samp">.sty</samp>&rsquo; interpolates its name; this datum is associated
+with the environment (see <a class="pxref" href="#Environments">Environments</a>).  Otherwise, &lsquo;<samp class="samp">.sty</samp>&rsquo;
+interpolates nothing.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Font-Positions">
+<div class="nav-panel">
+<p>
+Next: <a href="#Using-Symbols" accesskey="n" rel="next">Using Symbols</a>, Previous: <a href="#Font-Families" accesskey="p" rel="prev">Font Families</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Font-Positions-1">5.19.3 Font Positions</h4>
+<a class="index-entry-id" id="index-font-positions"></a>
+<a class="index-entry-id" id="index-positions_002c-font"></a>
+
+<p>To support typeface indirection through abstract styles, and for
+compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, the formatter maintains
+a list of font <em class="dfn">positions</em> at which fonts required by a document are
+<em class="dfn">mounted</em>.  An output device&rsquo;s description file <samp class="file">DESC</samp>
+typically configures a set of pre-mounted fonts; see <a class="ref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.  A font need not be explicitly mounted before
+it is selected; GNU <code class="code">troff</code> will search <code class="env">GROFF_FONT_PATH</code> for
+it by name and mount it at the first free mounting position on demand.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fp</code></strong> <var class="def-var-arguments">pos id <span class="r"><i class="slanted">font-description-file-name</i></span></var><a class="copiable-link" href='#index-_002efp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ef_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.f</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ef_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ef"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efp-1"></a>
+<a class="index-entry-id" id="index-mounting-a-font-_0028fp_0029"></a>
+<a class="index-entry-id" id="index-font_002c-mounting-_0028fp_0029"></a>
+<p>Mount a font under the name <var class="var">id</var> at mounting position <var class="var">pos</var>, a
+non-negative integer.  When the formatter starts up, it reads the output
+device&rsquo;s description to mount an initial set of faces, and selects font
+position&nbsp;1.  Position&nbsp;0 is unused by default.  Unless the
+<var class="var">font-description-file-name</var> argument is given, <var class="var">id</var> should be
+the name of a font description file stored in a directory corresponding
+to the selected output device.  GNU <code class="code">troff</code> does not traverse
+directories to locate the font description file.
+</p>
+<a class="index-entry-id" id="index-font-aliasing-with-third-argument-to-fp-request"></a>
+<a class="index-entry-id" id="index-aliasing-fonts-with-third-argument-to-fp-request"></a>
+<p>The optional third argument enables font names to be aliased, which can
+be necessary in compatibility mode since AT&amp;T <code class="code">troff</code> syntax
+affords no means of identifying fonts with names longer than two
+characters, like &lsquo;<samp class="samp">TBI</samp>&rsquo; or &lsquo;<samp class="samp">ZCMI</samp>&rsquo;, in a font selection escape
+sequence.  See <a class="xref" href="#Compatibility-Mode">Compatibility Mode</a>.  You can also alias fonts on
+mounting for convenience or abstraction.  (See below regarding the
+<code class="code">.fp</code> register.)
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fp \n.fp SC ZCMI
+Send a \f(SChand-written\fP thank-you note.
+.fp \n.fp Emph TI
+.fp \n.fp Strong TB
+Are \fEmphthese names\f \fStrongcomfortable\f?
+</pre></div></div>
+
+<p>&lsquo;<samp class="samp">DESC</samp>&rsquo;, &lsquo;<samp class="samp">P</samp>&rsquo;, and non-negative integers are not usable as font
+identifiers.
+</p>
+<a class="index-entry-id" id="index-font-position-register-_0028_002ef_0029"></a>
+<p>The position of the currently selected font (or abstract style) is
+available in the read-only register &lsquo;<samp class="samp">.f</samp>&rsquo;.  It is associated with
+the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>You can copy the value of <code class="code">.f</code> to another register to save it for
+later use.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr saved-font \n.f
+<span class="r">&hellip; <i class="i">text involving many font changes</i> &hellip;</span>
+.ft \nsaved-font
+</pre></div></div>
+
+<a class="index-entry-id" id="index-next-free-font-position-register-_0028_002efp_0029"></a>
+<p>The index of the next (non-zero) free font position is available in the
+read-only register &lsquo;<samp class="samp">.fp</samp>&rsquo;.
+<a class="index-entry-id" id="index-DESC-file_002c-and-font-mounting"></a>
+Fonts not listed in the <samp class="file">DESC</samp> file are automatically mounted at
+position &lsquo;<samp class="samp">\n.fp</samp>&rsquo; when selected with the <code class="code">ft</code> request or
+<code class="code">\f</code> escape sequence.  When mounting a font at a position
+explicitly with the <code class="code">fp</code> request, this same practice should be
+followed, although GNU <code class="code">troff</code> does not enforce this strictly.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Using-Symbols">
+<div class="nav-panel">
+<p>
+Next: <a href="#Character-Classes" accesskey="n" rel="next">Character Classes</a>, Previous: <a href="#Font-Positions" accesskey="p" rel="prev">Font Positions</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Using-Symbols-1">5.19.4 Using Symbols</h4>
+<a class="index-entry-id" id="index-using-symbols"></a>
+<a class="index-entry-id" id="index-symbols_002c-using"></a>
+
+<a class="index-entry-id" id="index-glyph"></a>
+<a class="index-entry-id" id="index-character"></a>
+<a class="index-entry-id" id="index-glyph_002c-distinguished-from-character"></a>
+<a class="index-entry-id" id="index-character_002c-distinguished-from-glyph"></a>
+<a class="index-entry-id" id="index-ligature"></a>
+<p>A <em class="dfn">glyph</em> is a graphical representation of a <em class="dfn">character</em>.  While
+a character is an abstraction of semantic information, a glyph is
+something that can be seen on screen or paper.  A character has many
+possible representation forms (for example, the character &lsquo;A&rsquo; can be
+written in an upright or slanted typeface, producing distinct
+glyphs).  Sometimes, a sequence of characters map to a single glyph:
+this is a <em class="dfn">ligature</em>&mdash;the most common is &lsquo;fi&rsquo;.
+</p>
+<p>Space characters never become glyphs in GNU <code class="code">troff</code>.  If not
+discarded (as when trailing on text lines), they are represented by
+horizontal motions in the output.
+</p>
+<a class="index-entry-id" id="index-symbol"></a>
+<a class="index-entry-id" id="index-special-fonts"></a>
+<a class="index-entry-id" id="index-fonts"></a>
+<a class="index-entry-id" id="index-DESC-2"></a>
+<a class="index-entry-id" id="index-special-request_002c-and-glyph-search-order"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-glyph-search-order"></a>
+<p>A <em class="dfn">symbol</em> is simply a named glyph.  Within <code class="code">gtroff</code>, all glyph
+names of a particular font are defined in its font file.  If the user
+requests a glyph not available in this font, <code class="code">gtroff</code> looks up an
+ordered list of <em class="dfn">special fonts</em>.  By default, the PostScript output
+device supports the two special fonts &lsquo;<samp class="samp">SS</samp>&rsquo; (slanted symbols) and
+&lsquo;<samp class="samp">S</samp>&rsquo; (symbols) (the former is looked up before the latter).  Other
+output devices use different names for special fonts.  Fonts mounted
+with the <code class="code">fonts</code> keyword in the <samp class="file">DESC</samp> file are globally
+available.  To install additional special fonts locally (i.e., for a
+particular font), use the <code class="code">fspecial</code> request.
+</p>
+<p>Here are the exact rules how <code class="code">gtroff</code> searches a given symbol:
+</p>
+<ul class="itemize mark-bullet">
+<li>If the symbol has been defined with the <code class="code">char</code> request, use it.
+This hides a symbol with the same name in the current font.
+
+</li><li>Check the current font.
+
+</li><li>If the symbol has been defined with the <code class="code">fchar</code> request, use it.
+
+</li><li>Check whether the current font has a font-specific list of special
+fonts; test all fonts in the order of appearance in the last
+<code class="code">fspecial</code> call if appropriate.
+
+</li><li>If the symbol has been defined with the <code class="code">fschar</code> request for the
+current font, use it.
+
+</li><li>Check all fonts in the order of appearance in the last <code class="code">special</code>
+call.
+
+</li><li>If the symbol has been defined with the <code class="code">schar</code> request, use it.
+
+</li><li>As a last resort, consult all fonts loaded up to now for special fonts
+and check them, starting with the lowest font number.  This can
+sometimes lead to surprising results since the <code class="code">fonts</code> line in
+the <samp class="file">DESC</samp> file often contains empty positions, which are filled
+later on.  For example, consider the following:
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">fonts 3 0 0 FOO
+</pre></div></div>
+
+<p>This mounts font <code class="code">foo</code> at font position&nbsp;3.  We assume that
+<code class="code">FOO</code> is a special font, containing glyph <code class="code">foo</code>, and that no
+font has been loaded yet.  The line
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fspecial BAR BAZ
+</pre></div></div>
+
+<p>makes font <code class="code">BAZ</code> special only if font <code class="code">BAR</code> is active.  We
+further assume that <code class="code">BAZ</code> is really a special font, i.e., the font
+description file contains the <code class="code">special</code> keyword, and that it also
+contains glyph <code class="code">foo</code> with a special shape fitting to font
+<code class="code">BAR</code>.  After executing <code class="code">fspecial</code>, font <code class="code">BAR</code> is loaded
+at font position&nbsp;1, and <code class="code">BAZ</code> at position&nbsp;2.
+</p>
+<p>We now switch to a new font <code class="code">XXX</code>, trying to access glyph
+<code class="code">foo</code> that is assumed to be missing.  There are neither
+font-specific special fonts for <code class="code">XXX</code> nor any other fonts made
+special with the <code class="code">special</code> request, so <code class="code">gtroff</code> starts the
+search for special fonts in the list of already mounted fonts, with
+increasing font positions.  Consequently, it finds <code class="code">BAZ</code> before
+<code class="code">FOO</code> even for <code class="code">XXX</code>, which is not the intended behaviour.
+</p></li></ul>
+
+<p>See <a class="xref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>, and <a class="ref" href="#Special-Fonts">Special Fonts</a>, for
+more details.
+</p>
+<a class="index-entry-id" id="index-list-of-special-characters-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-special-characters_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-characters_002c-special_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-available-glyphs_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-glyphs_002c-available_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<p>The <cite class="cite">groff_char<span class="r">(7)</span></cite> man page houses a complete list of
+predefined special character names, but the availability of any as a
+glyph is device- and font-dependent.  For example, say
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">man -Tdvi groff_char &gt; groff_char.dvi
+</pre></div></div>
+
+<p>to obtain those available with the DVI device and default font
+configuration.<a class="footnote" id="DOCF77" href="#FOOT77"><sup>77</sup></a>  If you want to use an additional macro package to change
+the fonts used, <code class="code">groff</code> (or <code class="code">gtroff</code>) must be run directly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -Tdvi -mec -man groff_char.7 &gt; groff_char.dvi
+</pre></div></div>
+
+<a class="index-entry-id" id="index-composite-glyph-names"></a>
+<a class="index-entry-id" id="index-glyph-names_002c-composite"></a>
+<a class="index-entry-id" id="index-groff-glyph-list-_0028GGL_0029"></a>
+<a class="index-entry-id" id="index-GGL-_0028groff-glyph-list_0029"></a>
+<a class="index-entry-id" id="index-Adobe-Glyph-List-_0028AGL_0029"></a>
+<p>Special character names not listed in <cite class="cite">groff_char<span class="r">(7)</span></cite> are
+derived algorithmically, using a simplified version of the Adobe Glyph
+List (AGL) algorithm, which is described in
+<a class="uref" href="https://github.com/adobe-type-tools/agl-aglfn">https://github.com/adobe-type-tools/agl-aglfn</a>.  The (frozen)
+set of names that can&rsquo;t be derived algorithmically is called the
+<em class="dfn"><code class="code">groff</code> glyph list (GGL)</em>.
+</p>
+<ul class="itemize mark-bullet">
+<li>A glyph for Unicode character U+<var class="var">XXXX</var><var class="var">X</var><var class="var">X</var>, which is
+not a composite character is named
+<code class="code">u<var class="var">XXXX</var><span class="r"></span><var class="var">X</var><span class="r"></span><var class="var">X</var><span class="r"></span></code>.  <var class="var">X</var> must be an
+uppercase hexadecimal digit.  Examples: <code class="code">u1234</code>, <code class="code">u008E</code>,
+<code class="code">u12DB8</code>.  The largest Unicode value is 0x10FFFF.  There must be at
+least four <code class="code">X</code> digits; if necessary, add leading zeroes (after the
+&lsquo;<samp class="samp">u</samp>&rsquo;).  No zero padding is allowed for character codes greater than
+0xFFFF.  Surrogates (i.e., Unicode values greater than 0xFFFF
+represented with character codes from the surrogate area U+D800-U+DFFF)
+are not allowed either.
+
+</li><li>A glyph representing more than a single input character is named
+
+<div class="display">
+<pre class="display-preformatted">&lsquo;<samp class="samp">u</samp>&rsquo; <var class="var">component1</var> &lsquo;<samp class="samp">_</samp>&rsquo; <var class="var">component2</var> &lsquo;<samp class="samp">_</samp>&rsquo; <var class="var">component3</var> &hellip;
+</pre></div>
+
+<p>Example: <code class="code">u0045_0302_0301</code>.
+</p>
+<p>For simplicity, all Unicode characters that are composites must be
+maximally decomposed to NFD;<a class="footnote" id="DOCF78" href="#FOOT78"><sup>78</sup></a> for example,
+<code class="code">u00CA_0301</code> is not a valid glyph name since U+00CA (<small class="sc">LATIN
+CAPITAL LETTER E WITH CIRCUMFLEX</small>) can be further decomposed into U+0045
+(<small class="sc">LATIN CAPITAL LETTER E</small>) and U+0302 (<small class="sc">COMBINING CIRCUMFLEX
+ACCENT</small>).  <code class="code">u0045_0302_0301</code> is thus the glyph name for U+1EBE,
+<small class="sc">LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND ACUTE</small>.
+</p>
+</li><li>groff maintains a table to decompose all algorithmically derived glyph
+names that are composites itself.  For example, <code class="code">u0100</code> (<small class="sc">LATIN
+LETTER A WITH MACRON</small>) is automatically decomposed into
+<code class="code">u0041_0304</code>.  Additionally, a glyph name of the GGL is preferred
+to an algorithmically derived glyph name; <code class="code">groff</code> also
+automatically does the mapping.  Example: The glyph <code class="code">u0045_0302</code> is
+mapped to <code class="code">^E</code>.
+
+</li><li>glyph names of the GGL can&rsquo;t be used in composite glyph names; for
+example, <code class="code">^E_u0301</code> is invalid.
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0028nm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_005bname_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\</code><span class="r"><i class="slanted">name</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005bname_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_005bbase_002dglyph-combining_002dcomponent-_2026_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\</code><span class="r"><i class="slanted">base-glyph combining-component &hellip;</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005bbase_002dglyph-combining_002dcomponent-_2026_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0028"></a>
+<a class="index-entry-id" id="index-_005c_005b"></a>
+<p>Typeset a special character <var class="var">name</var> (two-character name <var class="var">nm</var>) or
+a composite glyph consisting of <var class="var">base-glyph</var> overlaid with one or
+more <var class="var">combining-component</var>s.  For example, &lsquo;<samp class="samp">\A ho</samp>&rsquo; is a
+capital letter &ldquo;A&rdquo; with a &ldquo;hook accent&rdquo; (ogonek).
+</p>
+<p>There is no special syntax for one-character names&mdash;the analogous form
+&lsquo;<samp class="samp">\<var class="var">n</var></samp>&rsquo; would collide with other escape sequences.  However, the
+four escape sequences <code class="code">\'</code>, <code class="code">\-</code>, <code class="code">\_</code>, and <code class="code">\`</code>,
+are translated on input to the special character escape sequences
+<code class="code">\aa</code>, <code class="code">\-</code>, <code class="code">\ul</code>, and <code class="code">\ga</code>, respectively.
+</p>
+<p>A special character name of length one is not the same thing as an
+ordinary character: that is, the character <code class="code">a</code> is not the same as
+<code class="code">\a</code>.
+</p>
+<p>If <var class="var">name</var> is undefined, a warning in category &lsquo;<samp class="samp">char</samp>&rsquo; is
+produced and the escape is ignored.  See <a class="xref" href="#Warnings">Warnings</a>, for information
+about the enablement and suppression of warnings.
+</p>
+<p>GNU <code class="code">troff</code> resolves <code class="code">\<span class="r">&hellip;</span></code> with more than a single
+component as follows:
+</p>
+<ul class="itemize mark-bullet">
+<li>Any component that is found in the GGL is converted to the
+<code class="code">u<var class="var">XXXX</var></code> form.
+
+</li><li>Any component <code class="code">u<var class="var">XXXX</var></code> that is found in the list of
+decomposable glyphs is decomposed.
+
+</li><li>The resulting elements are then concatenated with &lsquo;<samp class="samp">_</samp>&rsquo; in between,
+dropping the leading &lsquo;<samp class="samp">u</samp>&rsquo; in all elements but the first.
+</li></ul>
+
+<p>No check for the existence of any component (similar to <code class="code">tr</code>
+request) is done.
+</p>
+<p>Examples:
+</p>
+<dl class="table">
+<dt><code class="code">\A ho</code></dt>
+<dd><p>&lsquo;<samp class="samp">A</samp>&rsquo; maps to <code class="code">u0041</code>, &lsquo;<samp class="samp">ho</samp>&rsquo; maps to <code class="code">u02DB</code>, thus the
+final glyph name would be <code class="code">u0041_02DB</code>.  This is not the expected
+result: the ogonek glyph &lsquo;<samp class="samp">ho</samp>&rsquo; is a spacing ogonek, but for a
+proper composite a non-spacing ogonek (U+0328) is necessary.  Looking
+into the file <samp class="file">composite.tmac</samp>, one can find &lsquo;<samp class="samp">.composite&nbsp;ho&nbsp;u0328</samp>&rsquo;, which changes the mapping of &lsquo;<samp class="samp">ho</samp>&rsquo; while a composite glyph
+name is constructed, causing the final glyph name to be
+<code class="code">u0041_0328</code>.
+</p>
+</dd>
+<dt><code class="code">\^E u0301</code></dt>
+<dt><code class="code">\^E aa</code></dt>
+<dt><code class="code">\E a^ aa</code></dt>
+<dt><code class="code">\E ^ <code class="code">'</code></code></dt>
+<dd><p>&lsquo;<samp class="samp">^E</samp>&rsquo; maps to <code class="code">u0045_0302</code>, thus the final glyph name is
+<code class="code">u0045_0302_0301</code> in all forms (assuming proper calls of the
+<code class="code">composite</code> request).
+</p></dd>
+</dl>
+
+<p>It is not possible to define glyphs with names like &lsquo;<samp class="samp">A&nbsp;ho</samp>&rsquo;
+within a <code class="code">groff</code> font file.  This is not really a limitation;
+instead, you have to define <code class="code">u0041_0328</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cC_0027xxx_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\C<code class="code">'</code></code><span class="r"><i class="slanted">xxx</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cC_0027xxx_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cC"></a>
+<a class="index-entry-id" id="index-named-character-_0028_005cC_0029"></a>
+<a class="index-entry-id" id="index-character_002c-named-_0028_005cC_0029"></a>
+<p>Typeset the glyph of the special character <var class="var">xxx</var>.  Normally, it is
+more convenient to use <code class="code">\<var class="var">xxx</var></code>, but <code class="code">\C</code> has some
+advantages: it is compatible with <abbr class="acronym">AT&amp;T</abbr> device-independent
+<code class="code">troff</code> (and therefore available in compatibility
+mode<a class="footnote" id="DOCF79" href="#FOOT79"><sup>79</sup></a>) and can interpolate special
+characters with &lsquo;<samp class="samp"></samp>&rsquo; in their names.  The delimiter need not be
+a neutral apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecomposite"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.composite</code></strong> <var class="def-var-arguments">id1 id2</var><a class="copiable-link" href='#index-_002ecomposite'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-composite"></a>
+<a class="index-entry-id" id="index-composite_002etmac"></a>
+<p>Map special character name <var class="var">id1</var> to <var class="var">id2</var> if <var class="var">id1</var> is used
+in <code class="code">\...</code> with more than one component.  See above for examples.
+This is a strict rewriting of the special character name; no check is
+performed for the existence of a glyph for either.  A set of default
+mappings for many accents can be found in the file
+<samp class="file">composite.tmac</samp>, loaded by the default <samp class="file">troffrc</samp> at startup.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cN_0027n_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\N<code class="code">'</code></code><span class="r"><i class="slanted">n</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cN_0027n_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cN"></a>
+<a class="index-entry-id" id="index-numbered-glyph-_0028_005cN_0029-1"></a>
+<a class="index-entry-id" id="index-glyph_002c-numbered-_0028_005cN_0029-1"></a>
+<a class="index-entry-id" id="index-char-request_002c-used-with-_005cN"></a>
+<a class="index-entry-id" id="index-Unicode-1"></a>
+<p>Typeset the glyph with code&nbsp;<var class="var">n</var> in the current font
+(<code class="code">n</code>&nbsp;is <em class="emph">not</em> the input character code).  The number
+<var class="var">n</var>&nbsp;can be any non-negative decimal integer.  Most devices only
+have glyphs with codes between 0 and&nbsp;255; the Unicode output device
+uses codes in the range 0&ndash;65535.  If the current font does not contain
+a glyph with that code, special fonts are <em class="emph">not</em> searched.  The
+<code class="code">\N</code> escape sequence can be conveniently used in conjunction with
+the <code class="code">char</code> request:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.char \phone \fZD\N'37'
+</pre></div></div>
+
+<a class="index-entry-id" id="index-DESC-3"></a>
+<a class="index-entry-id" id="index-unnamed-glyphs"></a>
+<a class="index-entry-id" id="index-glyphs_002c-unnamed"></a>
+<p>The code of each glyph is given in the fourth column in the font
+description file after the <code class="code">charset</code> command.  It is possible to
+include unnamed glyphs in the font description file by using a name of
+&lsquo;<samp class="samp">---</samp>&rsquo;; the <code class="code">\N</code> escape sequence is the only way to use these.
+</p>
+<p>No kerning is applied to glyphs accessed with <code class="code">\N</code>.  The delimiter
+need not be a neutral apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p></dd></dl>
+
+<p>A few escape sequences are also special characters.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0027-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<code class="code">'</code></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0027-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0027"></a>
+<p>An escaped neutral apostrophe is a synonym for <code class="code">\aa</code> (acute
+accent).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0060-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<code class="code">`</code></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0060-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0060"></a>
+<p>An escaped grave accent is a synonym for <code class="code">\ga</code> (grave accent).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002d-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\-</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002d"></a>
+<p>An escaped hyphen-minus is a synonym for <code class="code">\-</code> (minus sign).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005f-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\_</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005f-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005f"></a>
+<p>An escaped underscore (&ldquo;low line&rdquo;) is a synonym for <code class="code">\ul</code>
+(underrule).  On typesetting devices, the underrule is font-invariant
+and drawn lower than the underscore &lsquo;<samp class="samp">_</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecflags"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cflags</code></strong> <var class="def-var-arguments">n c1 c2 &hellip;</var><a class="copiable-link" href='#index-_002ecflags'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cflags"></a>
+<a class="index-entry-id" id="index-glyph-properties-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-character-properties-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-properties-of-glyphs-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-properties-of-characters-_0028cflags_0029"></a>
+<p>Assign properties encoded by the number <var class="var">n</var> to characters <var class="var">c1</var>,
+<var class="var">c2</var>, and so on.
+</p>
+<p>Input characters, including special characters introduced by an escape,
+have certain properties associated with them.<a class="footnote" id="DOCF80" href="#FOOT80"><sup>80</sup></a>
+These properties can be modified with this request.  The first argument
+is the sum of the desired flags and the remaining arguments are the
+characters to be assigned those properties.  Spaces between the <var class="var">cn</var>
+arguments are optional.  Any argument <var class="var">cn</var> can be a character class
+defined with the <code class="code">class</code> request rather than an individual
+character.  See <a class="xref" href="#Character-Classes">Character Classes</a>.
+</p>
+<p>The non-negative integer <var class="var">n</var> is the sum of any of the following.
+Some combinations are nonsensical, such as &lsquo;<samp class="samp">33</samp>&rsquo; (1 + 32).
+</p>
+<dl class="table">
+<dt id='index-end_002dof_002dsentence-characters-1'><span><code class="code">1</code><a class="copiable-link" href='#index-end_002dof_002dsentence-characters-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-end_002dof_002dsentence"></a>
+<p>Recognize the character as ending a sentence if followed by a newline
+or two spaces.  Initially, characters &lsquo;<samp class="samp">.?!</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-hyphenating-characters'><span><code class="code">2</code><a class="copiable-link" href='#index-hyphenating-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-hyphenation"></a>
+<p>Enable breaks before the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, no characters have this property.
+</p>
+</dd>
+<dt id='index-_005c_002d-glyph_002c-and-cflags'><span><code class="code">4</code><a class="copiable-link" href='#index-_005c_002d-glyph_002c-and-cflags'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hy-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-em-glyph_002c-and-cflags"></a>
+<p>Enable breaks after the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, characters &lsquo;<samp class="samp">\-\hy\em</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-overlapping-characters'><span><code class="code">8</code><a class="copiable-link" href='#index-overlapping-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-overlapping"></a>
+<a class="index-entry-id" id="index-ul-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-rn-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-ru-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-radicalex-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-sqrtex-glyph_002c-and-cflags"></a>
+<p>Mark the glyph associated with this character as overlapping other
+instances of itself horizontally.  Initially, characters
+&lsquo;<samp class="samp">\ul\rn\ru\radicalex\sqrtex</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-br-glyph_002c-and-cflags'><span><code class="code">16</code><a class="copiable-link" href='#index-br-glyph_002c-and-cflags'> &para;</a></span></dt>
+<dd><p>Mark the glyph associated with this character as overlapping other
+instances of itself vertically.  Initially, the character &lsquo;<samp class="samp">\br</samp>&rsquo;
+has this property.
+</p>
+</dd>
+<dt id='index-transparent-characters'><span><code class="code">32</code><a class="copiable-link" href='#index-transparent-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-character_002c-transparent"></a>
+<a class="index-entry-id" id="index-_0022_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_0027_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_0029_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_005d_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_002a_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-dg-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-dd-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-rq-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-cq-glyph_002c-at-end-of-sentence-1"></a>
+<p>Mark the character as transparent for the purpose of end-of-sentence
+recognition.  In other words, an end-of-sentence character followed by
+any number of characters with this property is treated as the end of a
+sentence if followed by a newline or two spaces.  This is the same as
+having a zero space factor in TeX.  Initially, characters
+&lsquo;<samp class="samp">&quot;')*\dg\dd\rq\cq</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt><code class="code">64</code></dt>
+<dd><p>Ignore hyphenation codes of the surrounding characters.  Use this in
+combination with values 2 and&nbsp;4 (initially, no characters have this
+property).
+</p>
+<p>For example, if you need an automatic break point after the en-dash in
+numeric ranges like &ldquo;3000&ndash;5000&rdquo;, insert
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cflags 68 \en
+</pre></div></div>
+
+<p>into your document.  However, this practice can lead to bad layout if
+done thoughtlessly; in most situations, a better solution instead of
+changing the <code class="code">cflags</code> value is to insert <code class="code">\:</code> right after the
+hyphen at the places that really need a break point.
+</p></dd>
+</dl>
+
+<p>The remaining values were implemented for East Asian language support;
+those who use alphabetic scripts exclusively can disregard them.
+</p>
+<dl class="table">
+<dt><code class="code">128</code></dt>
+<dd><p>Prohibit a line break before the character, but allow a line break after
+the character.  This works only in combination with flags 256 and 512
+and has no effect otherwise.  Initially, no characters have this
+property.
+</p>
+</dd>
+<dt><code class="code">256</code></dt>
+<dd><p>Prohibit a line break after the character, but allow a line break before
+the character.  This works only in combination with flags 128 and 512
+and has no effect otherwise.  Initially, no characters have this
+property.
+</p>
+</dd>
+<dt><code class="code">512</code></dt>
+<dd><p>Allow line break before or after the character.  This works only in
+combination with flags 128 and 256 and has no effect otherwise.
+Initially, no characters have this property.
+</p></dd>
+</dl>
+
+<p>In contrast to values 2 and&nbsp;4, the values 128, 256, and 512 work
+pairwise.  If, for example, the left character has value 512, and the
+right character 128, no break will be automatically inserted between
+them.  If we use value&nbsp;6 instead for the left character, a break
+after the character can&rsquo;t be suppressed since the neighboring character
+on the right doesn&rsquo;t get examined.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002echar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.char</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002echar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-char"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efchar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fchar</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002efchar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fchar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fschar</code></strong> <var class="def-var-arguments">f c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002efschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fschar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.schar</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-schar"></a>
+<a class="index-entry-id" id="index-defining-character-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-fallback-character-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-character_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-character_002c-defining-fallback-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-fallback-character_002c-defining-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-creating-new-characters-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-symbol-_0028char_0029"></a>
+<a class="index-entry-id" id="index-symbol_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-glyph-_0028char_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-escape-character_002c-while-defining-glyph"></a>
+<a class="index-entry-id" id="index-character_002c-escape_002c-while-defining-glyph"></a>
+<a class="index-entry-id" id="index-tr-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-cp-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-rc-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-lc-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005cl_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005cL_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005ce_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-hcode-request_002c-and-glyph-definitions"></a>
+<p>Define a new character or glyph&nbsp;<var class="var">c</var> to be <var class="var">contents</var>, which
+can be empty.  More precisely, <code class="code">char</code> defines a <code class="code">groff</code> object
+(or redefines an existing one) that is accessed with the
+name&nbsp;<var class="var">c</var> on input, and produces <var class="var">contents</var> on output.
+Every time glyph&nbsp;<var class="var">c</var> needs to be printed, <var class="var">contents</var> is
+processed in a temporary environment and the result is wrapped up into a
+single object.  Compatibility mode is turned off and the escape
+character is set to&nbsp;<code class="code">\</code> while <var class="var">contents</var> is processed.
+Any emboldening, constant spacing, or track kerning is applied to this
+object rather than to individual glyphs in <var class="var">contents</var>.
+</p>
+<p>An object defined by these requests can be used just like a normal glyph
+provided by the output device.  In particular, other characters can be
+translated to it with the <code class="code">tr</code> or <code class="code">trin</code> requests; it can be
+made the leader character with the <code class="code">lc</code> request; repeated patterns
+can be drawn with it using the <code class="code">\l</code> and <code class="code">\L</code> escape sequences;
+and words containing&nbsp;<var class="var">c</var> can be hyphenated correctly if the
+<code class="code">hcode</code> request is used to give the object a hyphenation code.
+</p>
+<p>There is a special anti-recursion feature: use of the object within its
+own definition is handled like a normal character (not
+defined with <code class="code">char</code>).
+</p>
+<p>The <code class="code">tr</code> and <code class="code">trin</code> requests take precedence if <code class="code">char</code>
+accesses the same symbol.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr XY
+X
+    &rArr; Y
+.char X Z
+X
+    &rArr; Y
+.tr XX
+X
+    &rArr; Z
+</pre></div></div>
+
+<p>The <code class="code">fchar</code> request defines a fallback glyph: <code class="code">gtroff</code> only
+checks for glyphs defined with <code class="code">fchar</code> if it cannot find the glyph
+in the current font.  <code class="code">gtroff</code> carries out this test before
+checking special fonts.
+</p>
+<p><code class="code">fschar</code> defines a fallback glyph for font&nbsp;<var class="var">f</var>:
+<code class="code">gtroff</code> checks for glyphs defined with <code class="code">fschar</code> after the
+list of fonts declared as font-specific special fonts with the
+<code class="code">fspecial</code> request, but before the list of fonts declared as global
+special fonts with the <code class="code">special</code> request.
+</p>
+<p>Finally, the <code class="code">schar</code> request defines a global fallback glyph:
+<code class="code">gtroff</code> checks for glyphs defined with <code class="code">schar</code> after the list
+of fonts declared as global special fonts with the <code class="code">special</code>
+request, but before the already mounted special fonts.
+</p>
+<p>See <a class="xref" href="#Character-Classes">Character Classes</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erchar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rchar</code></strong> <var class="def-var-arguments">c &hellip;</var><a class="copiable-link" href='#index-_002erchar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rchar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002erfschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rfschar</code></strong> <var class="def-var-arguments">f c &hellip;</var><a class="copiable-link" href='#index-_002erfschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rfschar"></a>
+<a class="index-entry-id" id="index-removing-glyph-definition-_0028rchar_002c-rfschar_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029"></a>
+<a class="index-entry-id" id="index-fallback-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029"></a>
+<p>Remove definition of each ordinary or special character <var class="var">c</var>,
+undoing the effect of a <code class="code">char</code>, <code class="code">fchar</code>, or <code class="code">schar</code>
+request.  Those supplied by font description files cannot be removed.
+Spaces and tabs may separate <var class="var">c</var>&nbsp;arguments.
+</p>
+<p>The request <code class="code">rfschar</code> removes glyph definitions defined with
+<code class="code">fschar</code> for font&nbsp;<var class="var">f</var>.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Character-Classes">
+<div class="nav-panel">
+<p>
+Next: <a href="#Special-Fonts" accesskey="n" rel="next">Special Fonts</a>, Previous: <a href="#Using-Symbols" accesskey="p" rel="prev">Using Symbols</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Character-Classes-1">5.19.5 Character Classes</h4>
+<a class="index-entry-id" id="index-character-classes"></a>
+<a class="index-entry-id" id="index-classes_002c-character"></a>
+
+<p>Classes are particularly useful for East Asian languages such as
+Chinese, Japanese, and Korean, where the number of needed characters is
+much larger than in European languages, and where large sets of
+characters share the same properties.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eclass"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.class</code></strong> <var class="def-var-arguments">name c1 c2 &hellip;</var><a class="copiable-link" href='#index-_002eclass'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-class"></a>
+<a class="index-entry-id" id="index-character-class-_0028class_0029"></a>
+<a class="index-entry-id" id="index-defining-character-class-_0028class_0029"></a>
+<a class="index-entry-id" id="index-class-of-characters-_0028class_0029"></a>
+<p>Define a character class (or simply &ldquo;class&rdquo;) <var class="var">name</var> comprising
+the characters <var class="var">c1</var>, <var class="var">c2</var>, and so on.
+</p>
+<p>A class thus defined can then be referred to in lieu of listing all the
+characters within it.  Currently, only the <code class="code">cflags</code> request can
+handle references to character classes.
+</p>
+<p>In the request&rsquo;s simplest form, each <var class="var">cn</var> is a character (or special
+character).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.class quotes ' \aq \dq \oq \cq \lq \rq
+</pre></div></div>
+
+<p>Since class and glyph names share the same name space, it is recommended
+to start and end the class name with <code class="code"></code> and <code class="code"></code>,
+respectively, to avoid collisions with existing character names defined
+by GNU <code class="code">troff</code> or the user (with <code class="code">char</code> and related requests).
+This practice applies the presence of <code class="code"></code> in the class name to
+prevent the use of the special character escape form
+<code class="code">\<span class="r">&hellip;</span></code>, thus you must use the <code class="code">\C</code> escape to access
+a class with such a name.
+</p>
+<a class="index-entry-id" id="index-GGL-_0028groff-glyph-list_0029-1"></a>
+<a class="index-entry-id" id="index-groff-glyph-list-_0028GGL_0029-1"></a>
+<p>You can also use a character range notation consisting of a
+start character followed by &lsquo;<samp class="samp">-</samp>&rsquo; and then an end character.
+Internally, GNU <code class="code">troff</code> converts these two symbol names to
+Unicode code points (according to the <code class="code">groff</code> glyph list GGL),
+which then give the start and end value of the range.  If that fails,
+the class definition is skipped.
+</p>
+<p>Furthermore, classes can be nested.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.class prepunct , : ; &gt; }
+.class prepunctx \C'prepunct' \u2013-\u2016
+</pre></div></div>
+
+<p>The class &lsquo;<samp class="samp">prepunctx</samp>&rsquo; thus contains the contents of the class
+<code class="code">prepunct</code> as defined above (the set &lsquo;<samp class="samp">, : ; &gt; }</samp>&rsquo;), and
+characters in the range between <code class="code">U+2013</code> and <code class="code">U+2016</code>.
+</p>
+<p>If you want to include &lsquo;<samp class="samp">-</samp>&rsquo; in a class, it must be the first
+character value in the argument list, otherwise it gets misinterpreted
+as part of the range syntax.
+</p>
+<p>It is not possible to use class names as end points of range
+definitions.
+</p>
+<p>A typical use of the <code class="code">class</code> request is to control line-breaking
+and hyphenation rules as defined by the <code class="code">cflags</code> request.  For
+example, to inhibit line breaks before the characters belonging to the
+<code class="code">prepunctx</code> class defined in the previous example, you can write
+the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cflags 2 \C'prepunctx'
+</pre></div></div>
+
+<p>See the <code class="code">cflags</code> request in <a class="ref" href="#Using-Symbols">Using Symbols</a>, for more details.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Special-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="#Artificial-Fonts" accesskey="n" rel="next">Artificial Fonts</a>, Previous: <a href="#Character-Classes" accesskey="p" rel="prev">Character Classes</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Special-Fonts-1">5.19.6 Special Fonts</h4>
+<a class="index-entry-id" id="index-special-fonts-1"></a>
+<a class="index-entry-id" id="index-fonts_002c-special"></a>
+
+<p>Special fonts are those that <code class="code">gtroff</code> searches when it cannot find
+the requested glyph in the current font.  The Symbol font is usually a
+special font.
+</p>
+<p><code class="code">gtroff</code> provides the following two requests to add more special
+fonts.  See <a class="xref" href="#Using-Symbols">Using Symbols</a>, for a detailed description of the glyph
+searching mechanism in <code class="code">gtroff</code>.
+</p>
+<p>Usually, only non-TTY devices have special fonts.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002especial"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.special</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">s1</i></span> <span class="r"><i class="slanted">s2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002especial'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-special-2"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efspecial"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fspecial</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">s1</i></span> <span class="r"><i class="slanted">s2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002efspecial'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fspecial"></a>
+<a class="index-entry-id" id="index-fonts-1"></a>
+<a class="index-entry-id" id="index-DESC-4"></a>
+<p>Use the <code class="code">special</code> request to define special fonts.  Initially, this
+list is empty.
+</p>
+<p>Use the <code class="code">fspecial</code> request to designate special fonts only when
+font&nbsp;<var class="var">f</var> is active.  Initially, this list is empty.
+</p>
+<p>Previous calls to <code class="code">special</code> or <code class="code">fspecial</code> are overwritten;
+without arguments, the particular list of special fonts is set to empty.
+Special fonts are searched in the order they appear as arguments.
+</p>
+<p>All fonts that appear in a call to <code class="code">special</code> or <code class="code">fspecial</code>
+are loaded.
+</p>
+<p>See <a class="xref" href="#Using-Symbols">Using Symbols</a>, for the exact search order of glyphs.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Artificial-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="#Ligatures-and-Kerning" accesskey="n" rel="next">Ligatures and Kerning</a>, Previous: <a href="#Special-Fonts" accesskey="p" rel="prev">Special Fonts</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Artificial-Fonts-1">5.19.7 Artificial Fonts</h4>
+<a class="index-entry-id" id="index-artificial-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-artificial"></a>
+
+<p>There are a number of requests and escape sequences for artificially
+creating fonts.  These are largely vestiges of the days when output
+devices did not have a wide variety of fonts, and when <code class="code">nroff</code> and
+<code class="code">troff</code> were separate programs.  Most of them are no longer
+necessary in GNU <code class="code">troff</code>.  Nevertheless, they are supported.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cH_0027height_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted">height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027height_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cH"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cH_0027_002bheight_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted"><code class="t">+</code>height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027_002bheight_0027'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cH_0027_002dheight_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted"><code class="t">-</code>height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027_002dheight_0027'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eheight_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.height</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eheight_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eheight"></a>
+<a class="index-entry-id" id="index-changing-the-font-height-_0028_005cH_0029"></a>
+<a class="index-entry-id" id="index-font-height_002c-changing-_0028_005cH_0029"></a>
+<a class="index-entry-id" id="index-height_002c-font_002c-changing-_0028_005cH_0029"></a>
+<p>Change (increment, decrement) the height of the current font, but not
+the width.  If <var class="var">height</var> is zero, restore the original height.
+Default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p>
+<p>The read-only register <code class="code">.height</code> contains the font height as set by
+<code class="code">\H</code>.
+</p>
+<p>Currently, only the <samp class="option">-Tps</samp> and <samp class="option">-Tpdf</samp> devices support
+this feature.
+</p>
+<p><code class="code">\H</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \H'+5z'x\H'0'
+</pre></div></div>
+
+<p>In compatibility mode, <code class="code">gtroff</code> behaves differently: If an
+increment or decrement is used, it is always taken relative to the
+current type size and not relative to the previously selected font
+height.  Thus,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1
+\H'+5'test \H'+5'test
+</pre></div></div>
+
+<p>prints the word &lsquo;<samp class="samp">test</samp>&rsquo; twice with the same font height (five points
+larger than the current font size).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cS_0027slant_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\S<code class="code">'</code></code><span class="r"><i class="slanted">slant</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cS_0027slant_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cS"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eslant_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.slant</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eslant_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eslant"></a>
+<a class="index-entry-id" id="index-changing-the-font-slant-_0028_005cS_0029"></a>
+<a class="index-entry-id" id="index-font-slant_002c-changing-_0028_005cS_0029"></a>
+<a class="index-entry-id" id="index-slant_002c-font_002c-changing-_0028_005cS_0029"></a>
+<p>Slant the current font by <var class="var">slant</var> degrees.  Positive values slant to
+the right.  Only integer values are possible.
+</p>
+<p>The read-only register <code class="code">.slant</code> contains the font slant as set by
+<code class="code">\S</code>.
+</p>
+<p>Currently, only the <samp class="option">-Tps</samp> and <samp class="option">-Tpdf</samp> devices support
+this feature.
+</p>
+<p><code class="code">\S</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \S'20'x\S'0'
+</pre></div></div>
+
+<a class="index-entry-id" id="index-CSTR-_002354-errata-3"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-_005cS-escape"></a>
+<p>This escape is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual; the slant is always set to an absolute value.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eul"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ul</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">lines</i></span></var><a class="copiable-link" href='#index-_002eul'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ul"></a>
+<a class="index-entry-id" id="index-underlining-_0028ul_0029"></a>
+<p>The <code class="code">ul</code> request normally underlines subsequent lines if a TTY
+output device is used.  Otherwise, the lines are printed in italics
+(only the term &lsquo;underlined&rsquo; is used in the following).  The single
+argument is the quantity of input lines to be underlined; with no
+argument, the next line is underlined.  If <var class="var">lines</var> is zero or
+negative, stop the effects of <code class="code">ul</code> (if it was active).  Requests
+and empty lines do not count for computing the number of underlined
+input lines, even if they produce some output like <code class="code">tl</code>.  Lines
+inserted by macros (e.g., invoked by a trap) do count.
+</p>
+<p>At the beginning of <code class="code">ul</code>, the current font is stored and the
+underline font is activated.  Within the span of a <code class="code">ul</code> request, it
+is possible to change fonts, but after the last line affected by
+<code class="code">ul</code> the saved font is restored.
+</p>
+<p>This number of lines still to be underlined is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).  The underline font can be changed
+with the <code class="code">uf</code> request.
+</p>
+
+
+<p>The <code class="code">ul</code> request does not underline spaces.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecu"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cu</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">lines</i></span></var><a class="copiable-link" href='#index-_002ecu'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cu"></a>
+<a class="index-entry-id" id="index-continuous-underlining-_0028cu_0029"></a>
+<a class="index-entry-id" id="index-underlining_002c-continuous-_0028cu_0029"></a>
+<p>The <code class="code">cu</code> request is similar to <code class="code">ul</code> but underlines spaces as
+well (if a TTY output device is used).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002euf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.uf</code></strong> <var class="def-var-arguments">font</var><a class="copiable-link" href='#index-_002euf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-uf"></a>
+<a class="index-entry-id" id="index-underline-font-_0028uf_0029"></a>
+<a class="index-entry-id" id="index-font-for-underlining-_0028uf_0029"></a>
+<p>Set the underline font (globally) used by <code class="code">ul</code> and <code class="code">cu</code>.  By
+default, this is the font at position&nbsp;2.  <var class="var">font</var> can be either
+a non-negative font position or the name of a font.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebd"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bd</code></strong> <var class="def-var-arguments">font <span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002ebd'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-bd"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ebd-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bd</code></strong> <var class="def-var-arguments">font1 font2 <span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002ebd-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.b</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eb"></a>
+<a class="index-entry-id" id="index-imitating-boldface-_0028bd_0029"></a>
+<a class="index-entry-id" id="index-boldface_002c-imitating-_0028bd_0029"></a>
+<p>Embolden <var class="var">font</var> by overstriking its glyphs offset by <var class="var">offset</var>
+units minus one.
+</p>
+<p>Two syntax forms are available.
+</p>
+<ul class="itemize mark-bullet">
+<li>Imitate a bold font unconditionally.  The first argument specifies the
+font to embolden, and the second is the number of basic units, minus
+one, by which the two glyphs are offset.  If the second argument is
+missing, emboldening is turned off.
+
+<p><var class="var">font</var> can be either a non-negative font position or the name of a
+font.
+</p>
+<p><var class="var">offset</var> is available in the <code class="code">.b</code> read-only register if a
+special font is active; in the <code class="code">bd</code> request, its default unit is
+&lsquo;<samp class="samp">u</samp>&rsquo;.
+</p>
+</li><li><a class="index-entry-id" id="index-fspecial-request_002c-and-imitating-bold"></a>
+<a class="index-entry-id" id="index-special"></a>
+<a class="index-entry-id" id="index-embolding-of-special-fonts"></a>
+<a class="index-entry-id" id="index-special-fonts_002c-emboldening"></a>
+Imitate a bold form conditionally.  Embolden <var class="var">font1</var> by <var class="var">offset</var>
+only if font <var class="var">font2</var> is the current font.  This request can be
+issued repeatedly to set up different emboldening values for different
+current fonts.  If the second argument is missing, emboldening is turned
+off for this particular current font.
+
+<p>This affects special fonts only (either set up with the <code class="code">special</code>
+command in font files or with the <code class="code">fspecial</code> request).
+</p></li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cs</code></strong> <var class="def-var-arguments">font <span class="r"><i class="slanted">width</i></span> <span class="r"><i class="slanted">em-size</i></span></var><a class="copiable-link" href='#index-_002ecs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cs"></a>
+<a class="index-entry-id" id="index-constant-glyph-space-mode-_0028cs_0029"></a>
+<a class="index-entry-id" id="index-mode-for-constant-glyph-space-_0028cs_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-constant-space"></a>
+<a class="index-entry-id" id="index-ps-request_002c-and-constant-glyph-space-mode"></a>
+<p>Switch to and from <em class="dfn">constant glyph space mode</em>.  If activated, the
+width of every glyph is <em class="math"><var class="var">width</var>/36</em> ems.  The em size is given
+absolutely by <var class="var">em-size</var>; if this argument is missing, the em value
+is taken from the current font size (as set with the <code class="code">ps</code> request)
+when the font is effectively in use.  Without second and third argument,
+constant glyph space mode is deactivated.
+</p>
+<p>Default scaling unit for <var class="var">em-size</var> is &lsquo;<samp class="samp">z</samp>&rsquo;; <var class="var">width</var> is an
+integer.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Ligatures-and-Kerning">
+<div class="nav-panel">
+<p>
+Next: <a href="#Dummy-Characters" accesskey="n" rel="next">Dummy Characters</a>, Previous: <a href="#Artificial-Fonts" accesskey="p" rel="prev">Artificial Fonts</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Ligatures-and-Kerning-1">5.19.8 Ligatures and Kerning</h4>
+<a class="index-entry-id" id="index-ligatures-and-kerning"></a>
+<a class="index-entry-id" id="index-kerning-and-ligatures"></a>
+
+<p>Ligatures are groups of characters that are run together, i.e, producing
+a single glyph.  For example, the letters &lsquo;f&rsquo; and &lsquo;i&rsquo; can form a
+ligature &lsquo;fi&rsquo; as in the word &lsquo;file&rsquo;.  This produces a cleaner look
+(albeit subtle) to the printed output.  Usually, ligatures are not
+available in fonts for TTY output devices.
+</p>
+<p>Most PostScript fonts support the fi and fl ligatures.  The C/A/T
+typesetter that was the target of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> also
+supported &lsquo;ff&rsquo;, &lsquo;ffi&rsquo;, and &lsquo;ffl&rsquo; ligatures.  Advanced typesetters or
+&lsquo;expert&rsquo; fonts may include ligatures for &lsquo;ft&rsquo; and &lsquo;ct&rsquo;, although GNU
+<code class="code">troff</code> does not support these (yet).
+</p>
+<p>Only the current font is checked for ligatures and kerns; neither
+special fonts nor special charcters defined with the <code class="code">char</code> request
+(and its siblings) are taken into account.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elg"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lg</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002elg'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lg"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elg_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.lg</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elg_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elg-1"></a>
+<a class="index-entry-id" id="index-activating-ligatures-_0028lg_0029"></a>
+<a class="index-entry-id" id="index-ligatures_002c-activating-_0028lg_0029"></a>
+<a class="index-entry-id" id="index-ligatures-enabled-register-_0028_002elg_0029"></a>
+<p>Switch the ligature mechanism on or off; if the parameter is non-zero or
+missing, ligatures are enabled, otherwise disabled.  Default is on.  The
+current ligature mode can be found in the read-only register <code class="code">.lg</code>
+(set to 1 or&nbsp;2 if ligatures are enabled, 0&nbsp;otherwise).
+</p>
+<p>Setting the ligature mode to&nbsp;2 enables the two-character ligatures
+(fi, fl, and ff) and disables the three-character ligatures (ffi and
+ffl).
+</p></dd></dl>
+
+<p><em class="dfn">Pairwise kerning</em> is another subtle typesetting mechanism that
+modifies the distance between a glyph pair to improve readability.  In
+most cases (but not always) the distance is decreased.
+Typewriter-like fonts and fonts for terminals where all glyphs have the
+same width don&rsquo;t use kerning.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ekern"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.kern</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002ekern'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-kern"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ekern_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.kern</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ekern_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ekern-1"></a>
+<a class="index-entry-id" id="index-activating-kerning-_0028kern_0029"></a>
+<a class="index-entry-id" id="index-kerning_002c-activating-_0028kern_0029"></a>
+<a class="index-entry-id" id="index-kerning-enabled-register-_0028_002ekern_0029"></a>
+<p>Switch kerning on or off.  If the parameter is non-zero or missing,
+enable pairwise kerning, otherwise disable it.  The read-only register
+<code class="code">.kern</code> is set to&nbsp;1 if pairwise kerning is enabled,
+0&nbsp;otherwise.
+</p>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-effect-on-kerning"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-kerning"></a>
+<p>If the font description file contains pairwise kerning information,
+glyphs from that font are kerned.  Kerning between two glyphs can be
+inhibited by placing <code class="code">\&amp;</code> between them: &lsquo;<samp class="samp">V\&amp;A</samp>&rsquo;.
+</p>
+<p>See <a class="xref" href="#Font-Description-File-Format">Font Description File Format</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-track-kerning"></a>
+<a class="index-entry-id" id="index-kerning_002c-track"></a>
+<p><em class="dfn">Track kerning</em> expands or reduces the space between glyphs.  This
+can be handy, for example, if you need to squeeze a long word onto a
+single line or spread some text to fill a narrow column.  It must be
+used with great care since it is usually considered bad typography if
+the reader notices the effect.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etkf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tkf</code></strong> <var class="def-var-arguments">f s1 n1 s2 n2</var><a class="copiable-link" href='#index-_002etkf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tkf"></a>
+<a class="index-entry-id" id="index-activating-track-kerning-_0028tkf_0029"></a>
+<a class="index-entry-id" id="index-track-kerning_002c-activating-_0028tkf_0029"></a>
+<p>Enable track kerning for font&nbsp;<var class="var">f</var>.  If the current font
+is&nbsp;<var class="var">f</var> the width of every glyph is increased by an amount
+between <var class="var">n1</var> and <var class="var">n2</var> (<var class="var">n1</var>, <var class="var">n2</var> can be negative); if
+the current type size is less than or equal to <var class="var">s1</var> the width is
+increased by <var class="var">n1</var>; if it is greater than or equal to <var class="var">s2</var> the
+width is increased by <var class="var">n2</var>; if the type size is greater than or
+equal to <var class="var">s1</var> and less than or equal to <var class="var">s2</var> the increase in
+width is a linear function of the type size.
+</p>
+<p>The default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo; for <var class="var">s1</var> and <var class="var">s2</var>, &lsquo;<samp class="samp">p</samp>&rsquo;
+for <var class="var">n1</var> and <var class="var">n2</var>.
+</p>
+<p>The track kerning amount is added even to the rightmost glyph in a line;
+for large values it is thus recommended to increase the line length by
+the same amount to compensate.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Italic-Corrections">
+<div class="nav-panel">
+<p>
+Next: <a href="#Dummy-Characters" accesskey="n" rel="next">Dummy Characters</a>, Previous: <a href="#Ligatures-and-Kerning" accesskey="p" rel="prev">Ligatures and Kerning</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Italic-Corrections-1">5.19.9 Italic Corrections</h4>
+
+<p>When typesetting adjacent glyphs from typefaces of different slants, the
+space between them may require adjustment.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002f-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\/</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002f-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002f"></a>
+<a class="index-entry-id" id="index-italic-correction-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-correction_002c-italic-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-correction-between-oblique-and-upright-glyph-_0028_005c_002f_002c-_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-roman-glyph_002c-correction-after-italic-glyph-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-upright-glyph_002c-correction-after-oblique-glyph-_0028_005c_002f_0029"></a>
+<p>Apply an <em class="dfn">italic correction</em>: modify the spacing of the preceding
+glyph so that the distance between it and the following glyph is correct
+if the latter is of upright shape.  For example, if an
+italic&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; is followed immediately by a roman right
+parenthesis, then in many fonts the top right portion of
+the&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; overlaps the top left of the right parenthesis, which
+is ugly.  Use this escape sequence whenever an oblique glyph is
+immediately followed by an upright glyph without any intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\,</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002c"></a>
+<a class="index-entry-id" id="index-left-italic-correction-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-correction_002c-left-italic-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-correction-between-upright-and-oblique-glyph-_0028_005c_002f_002c-_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-roman-glyph_002c-correction-before-italic-glyph-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-upright-glyph_002c-correction-before-oblique-glyph-_0028_005c_002c_0029"></a>
+<p>Apply a <em class="dfn">left italic correction</em>: modify the spacing of the
+following glyph so that the distance between it and the preceding
+glyph is correct if the latter is of upright shape.  For example,
+if a roman left parenthesis is immediately followed by an
+italic&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo;, then in many fonts the bottom left portion of
+the&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; overlaps the bottom of the left parenthesis, which is
+ugly.  Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
+</p></dd></dl>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Dummy-Characters">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Italic-Corrections" accesskey="p" rel="prev">Italic Corrections</a>, Up: <a href="#Using-Fonts" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Dummy-Characters-1">5.19.10 Dummy Characters</h4>
+
+<p>As discussed in <a class="ref" href="#Requests-and-Macros">Requests and Macros</a>, the first character on an
+input line is treated specially.  Further, formatting a glyph has many
+consequences on formatter state (see <a class="pxref" href="#Environments">Environments</a>).  Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0026-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\&amp;</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0026-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0026"></a>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029"></a>
+<p>Interpolate a dummy character, which is constitutive of output but
+invisible.<a class="footnote" id="DOCF81" href="#FOOT81"><sup>81</sup></a>  Its presence alters the interpretation context of a
+subsequent input character, and enjoys several applications.
+</p>
+<ul class="itemize mark-bullet">
+<li>Prevent insertion of extra space after an end-of-sentence character.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test.
+Test.
+    &rArr; Test.  Test.
+Test.\&amp;
+Test.
+    &rArr; Test. Test.
+</pre></div></div>
+
+</li><li>Prevent recognition of a control character.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.Test
+    error&rarr; warning: macro 'Test' not defined
+\&amp;.Test
+    &rArr; .Test
+</pre></div></div>
+
+</li><li>Prevent kerning between two glyphs.
+
+
+</li><li>Translate a character to &ldquo;nothing&rdquo;.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr JIjiK\&amp;k\&amp;UVuv
+Post universitum, alea jacta est, OK?
+    &rArr; Post vniversitvm, alea iacta est, O?
+</pre></div></div>
+</li></ul>
+
+<p>The dummy character escape sequence sees use in macro definitions as a
+means of ensuring that arguments are treated as text even if they begin
+with spaces or control characters.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de HD \&quot; typeset a simple bold heading
+.  sp
+.  ft B
+\&amp;\\$1 \&quot; exercise: remove the \&amp;
+.  ft
+.  sp
+..
+.HD .\|.\|.\|surprised?
+</pre></div></div>
+</dd></dl>
+
+<p>One way to think about the dummy character is to imagine placing the
+symbol &lsquo;<samp class="samp">&amp;</samp>&rsquo; in the input at a certain location; if doing so has all
+the side effects on formatting that you desire except for sticking an
+ugly ampersand in the midst of your text, the dummy character is what
+you want in its place.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0029-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\)</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0029-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0029"></a>
+<a class="index-entry-id" id="index-transparent-dummy-character-_0028_005c_0029_0029"></a>
+<a class="index-entry-id" id="index-character_002c-transparent-dummy-_0028_005c_0029_0029"></a>
+<a class="index-entry-id" id="index-dummy-character_002c-transparent-_0028_005c_0029_0029"></a>
+<p>Interpolate a <i class="slanted">transparent</i> dummy character&mdash;one that is
+transparent to end-of-sentence detection.  It behaves as <code class="code">\&amp;</code>,
+except that <code class="code">\&amp;</code> is treated as letters and numerals normally are
+after &lsquo;<samp class="samp">.</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo; and &lsquo;<samp class="samp">!</samp>&rsquo;; <code class="code">\&amp;</code> cancels end-of-sentence
+detection, and <code class="code">\)</code> does not.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Suffix-&amp;
+.  nop \&amp;\\$1
+..
+.
+.de Suffix-)
+.  nop \)\\$1
+..
+.
+Here's a sentence.\c
+.Suffix-&amp; '
+Another one.\c
+.Suffix-) '
+And a third.
+    &rArr; Here's a sentence.' Another one.'  And a third.
+</pre></div></div>
+</dd></dl>
+
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Manipulating-Type-Size-and-Vertical-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="#Colors" accesskey="n" rel="next">Colors</a>, Previous: <a href="#Using-Fonts" accesskey="p" rel="prev">Using Fonts</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Manipulating-Type-Size-and-Vertical-Spacing-1">5.20 Manipulating Type Size and Vertical Spacing</h3>
+<a class="index-entry-id" id="index-manipulating-type-size-and-vertical-spacing"></a>
+
+<a class="index-entry-id" id="index-text-baseline-1"></a>
+<a class="index-entry-id" id="index-baseline_002c-text-1"></a>
+<a class="index-entry-id" id="index-type-size"></a>
+<a class="index-entry-id" id="index-size_002c-size"></a>
+<a class="index-entry-id" id="index-vertical-spacing-1"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical-1"></a>
+<p>These concepts were introduced in <a class="ref" href="#Page-Geometry">Page Geometry</a>.  The height of a
+font&rsquo;s tallest glyph is one em, which is equal to the type size in
+points.<a class="footnote" id="DOCF82" href="#FOOT82"><sup>82</sup></a>  A vertical spacing of less than 120% of
+the type size can make a document hard to read.  Larger proportions can
+be useful to spread the text for annotations or proofreader&rsquo;s marks.  By
+default, GNU <code class="code">troff</code> uses 10&nbsp;point type on 12&nbsp;point
+spacing.
+<a class="index-entry-id" id="index-leading"></a>
+Typographers call the difference between type size and vertical spacing
+<em class="dfn">leading</em>.<a class="footnote" id="DOCF83" href="#FOOT83"><sup>83</sup></a>
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Changing-the-Type-Size" accesskey="1">Changing the Type Size</a></li>
+<li><a href="#Changing-the-Vertical-Spacing" accesskey="2">Changing the Vertical Spacing</a></li>
+<li><a href="#Using-Fractional-Type-Sizes" accesskey="3">Using Fractional Type Sizes</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Changing-the-Type-Size">
+<div class="nav-panel">
+<p>
+Next: <a href="#Changing-the-Vertical-Spacing" accesskey="n" rel="next">Changing the Vertical Spacing</a>, Previous: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="p" rel="prev">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Changing-the-Type-Size-1">5.20.1 Changing the Type Size</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eps"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ps"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eps-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002eps-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cssize"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\s</code><span class="r"><i class="slanted">size</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cssize'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002es_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.s</code></strong><a class="copiable-link" href='#index-_005cn_005b_002es_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002es"></a>
+<a class="index-entry-id" id="index-changing-type-sizes-_0028ps_002c-_005cs_0029"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-changing-_0028ps_002c-_005cs_0029"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-changing-_0028ps_002c-_005cs_0029"></a>
+<p>Use the <code class="code">ps</code> request or the <code class="code">\s</code> escape sequence to change
+(increase, decrease) the type size (in scaled points).  Specify
+<var class="var">size</var> as either an absolute type size, or as a relative change from
+the current size.  <code class="code">ps</code> with no argument restores the previous
+size.  The <code class="code">ps</code> request&rsquo;s default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;.  The
+requested size is rounded to the nearest valid size (with ties rounding
+down) within the limits supported by the device.  If the requested size
+is non-positive, it is treated as 1<span class="dmn">u</span>.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-4"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-ps-request"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-_005cs-escape-sequence"></a>
+<p>Type size alteration is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual, which claims &ldquo;if the requested size is invalid,
+the next larger valid size will result, with a maximum of
+36&rdquo;.<a class="footnote" id="DOCF84" href="#FOOT84"><sup>84</sup></a>
+</p>
+<a class="index-entry-id" id="index-type-size-registers-_0028_002es_002c-_002eps_0029"></a>
+<a class="index-entry-id" id="index-point-size-registers-_0028_002es_002c-_002eps_0029"></a>
+<p>The read-only string-valued register <code class="code">.s</code> interpolates the type
+size in points as a decimal fraction; it is associated with the
+environment (see <a class="pxref" href="#Environments">Environments</a>).  To obtain the type size in scaled
+points, interpolate the <code class="code">.ps</code> register instead (see <a class="pxref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>).
+</p>
+<p>The <code class="code">\s</code> escape sequence supports a variety of syntax forms.
+</p>
+<dl class="table">
+<dt><code class="code">\s<var class="var">n</var></code></dt>
+<dd><p>Set the type size to <var class="var">n</var>&nbsp;points.  <var class="var">n</var>&nbsp;must be a single
+digit.  If <var class="var">n</var>&nbsp;is 0, restore the previous size.
+</p>
+</dd>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dd><p>Increase or decrease the type size by <var class="var">n</var>&nbsp;points.
+<var class="var">n</var>&nbsp;must be exactly one digit.
+</p>
+</dd>
+<dt><code class="code">\s(<var class="var">nn</var></code></dt>
+<dd><p>Set the type size to <var class="var">nn</var>&nbsp;points.  <var class="var">nn</var> must be exactly two
+digits.
+</p>
+</dd>
+<dt><code class="code">\s+(<var class="var">nn</var></code></dt>
+<dt><code class="code">\s-(<var class="var">nn</var></code></dt>
+<dt><code class="code">\s(+<var class="var">nn</var></code></dt>
+<dt><code class="code">\s(-<var class="var">nn</var></code></dt>
+<dd><p>Alter the type size in points by the two-digit value <var class="var">nn</var>.
+</p></dd>
+</dl>
+
+<p>See <a class="xref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>, for further syntactical forms of the
+<code class="code">\s</code> escape sequence that additionally accept decimal fractions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">snap, snap,
+.ps +2
+grin, grin,
+.ps +2
+wink, wink, \s+2nudge, nudge,\s+8 say no more!
+.ps 10
+</pre></div></div>
+</dd></dl>
+
+<p>The <code class="code">\s</code> escape sequence affects the environment immediately and
+doesn&rsquo;t produce an input token.  Consequently, it can be used in
+requests like <code class="code">mc</code>, which expects a single character as an
+argument, to change the type size on the fly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \s20x\s0
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esizes"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sizes</code></strong> <var class="def-var-arguments">s1 s2 &hellip; sn <code class="t">0</code></var><a class="copiable-link" href='#index-_002esizes'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sizes-1"></a>
+<p>The <samp class="file">DESC</samp> file specifies which type sizes are allowed by the
+output device; see <a class="ref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>.  Use the <code class="code">sizes</code> request
+to change this set of permissible sizes.  Arguments are in scaled
+points; see <a class="ref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>.  Each can be a single
+type size (such as &lsquo;<samp class="samp">12000</samp>&rsquo;), or a range of sizes (such as
+&lsquo;<samp class="samp">4000-72000</samp>&rsquo;).  You can optionally end the list with a &lsquo;<samp class="samp">0</samp>&rsquo;.
+</p></dd></dl>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Changing-the-Vertical-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="#Using-Fractional-Type-Sizes" accesskey="n" rel="next">Using Fractional Type Sizes</a>, Previous: <a href="#Changing-the-Type-Size" accesskey="p" rel="prev">Changing the Type Size</a>, Up: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Changing-the-Vertical-Spacing-1">5.20.2 Changing the Vertical Spacing</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002evs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002evs-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002evs-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ev_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.v</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ev_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ev"></a>
+<a class="index-entry-id" id="index-changing-vertical-line-spacing-_0028vs_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-spacing_002c-changing-_0028vs_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-spacing-register-_0028_002ev_0029"></a>
+<p>Set the vertical spacing to, or alter it by, <var class="var">space</var>.  The default
+scaling unit is &lsquo;<samp class="samp">p</samp>&rsquo;.  If <code class="code">vs</code> is called without an argument,
+the vertical spacing is reset to the previous value before the last call
+to <code class="code">vs</code>.
+<a class="index-entry-id" id="index-_002eV-register_002c-and-vs"></a>
+GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; if <var class="var">space</var>
+is negative; the vertical spacing is then set to the smallest possible
+positive value, the vertical motion quantum (as found in the <code class="code">.V</code>
+register).
+</p>
+<p>&lsquo;<samp class="samp">.vs&nbsp;0</samp>&rsquo; isn&rsquo;t saved in a diversion since it doesn&rsquo;t result in
+a vertical motion.  You must explicitly issue this request before
+interpolating the diversion.
+</p>
+<p>The read-only register <code class="code">.v</code> contains the vertical spacing; it is
+associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-vertical-line-spacing_002c-effective-value"></a>
+<p>When a break occurs, GNU <code class="code">troff</code> performs the following procedure.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-extra-pre_002dvertical-line-space-_0028_005cx_0029"></a>
+<a class="index-entry-id" id="index-line-space_002c-extra-pre_002dvertical-_0028_005cx_0029"></a>
+Move the drawing position vertically by the <em class="dfn">extra pre-vertical line
+space</em>, the minimum of all negative <code class="code">\x</code> escape sequence arguments
+in the pending output line.
+
+</li><li>Move the drawing position vertically by the vertical line spacing.
+
+</li><li>Write out the pending output line.
+
+</li><li><a class="index-entry-id" id="index-extra-post_002dvertical-line-space-_0028_005cx_0029"></a>
+<a class="index-entry-id" id="index-line-space_002c-extra-post_002dvertical-_0028_005cx_0029"></a>
+Move the drawing position vertically by the <em class="dfn">extra post-vertical line
+space</em>, the maximum of all positive <code class="code">\x</code> escape sequence arguments
+in the line that has just been output.
+
+</li><li><a class="index-entry-id" id="index-post_002dvertical-line-spacing"></a>
+<a class="index-entry-id" id="index-line-spacing_002c-post_002dvertical-_0028pvs_0029"></a>
+Move the drawing position vertically by the <em class="dfn">post-vertical line
+spacing</em> (see below).
+</li></ul>
+
+<a class="index-entry-id" id="index-double_002dspacing-_0028vs_002c-pvs_0029"></a>
+<p>Prefer <code class="code">vs</code> or <code class="code">pvs</code> over <code class="code">ls</code> to produce double-spaced
+documents.  <code class="code">vs</code> and <code class="code">pvs</code> have finer granularity than
+<code class="code">ls</code>; moreover, some preprocessors assume single spacing.
+See <a class="xref" href="#Manipulating-Spacing">Manipulating Spacing</a>, regarding the <code class="code">\x</code> escape sequence and
+the <code class="code">ls</code> request.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epvs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pvs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epvs-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epvs-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002epvs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pvs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epvs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epvs-3"></a>
+<a class="index-entry-id" id="index-ls-request_002c-alternative-to-_0028pvs_0029"></a>
+<a class="index-entry-id" id="index-post_002dvertical-line-spacing_002c-changing-_0028pvs_0029"></a>
+<a class="index-entry-id" id="index-post_002dvertical-line-spacing-register-_0028_002epvs_0029"></a>
+<p>Set the post-vertical spacing to, or alter it by, <var class="var">space</var>.  The
+default scaling unit is &lsquo;<samp class="samp">p</samp>&rsquo;.  If <code class="code">pvs</code> is called without an
+argument, the post-vertical spacing is reset to the previous value
+before the last call to <code class="code">pvs</code>.  GNU <code class="code">troff</code> emits a warning in
+category &lsquo;<samp class="samp">range</samp>&rsquo; if <var class="var">space</var> is negative; the post-vertical
+spacing is then set to zero.
+</p>
+<p>The read-only register <code class="code">.pvs</code> contains the post-vertical spacing;
+it is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Using-Fractional-Type-Sizes">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Changing-the-Type-Size" accesskey="p" rel="prev">Changing the Type Size</a>, Up: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Using-Fractional-Type-Sizes-1">5.20.3 Using Fractional Type Sizes</h4>
+<a class="index-entry-id" id="index-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-fractional-point-sizes"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-sizes_002c-fractional-type"></a>
+
+<p>AT&amp;T <code class="code">troff</code> interpreted all type size measurements in points.
+Combined with integer arithmetic, this design choice made it impossible
+to support, for instance, ten and a half-point type.  In GNU
+<code class="code">troff</code>, an output device can select a scaling factor that
+subdivides a point into &ldquo;scaled points&rdquo;.  A type size expressed in
+scaled points can thus represent a non-integral type size.
+</p>
+<a class="index-entry-id" id="index-s-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-s"></a>
+<a class="index-entry-id" id="index-scaling-unit-s"></a>
+<a class="index-entry-id" id="index-z-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-z"></a>
+<a class="index-entry-id" id="index-scaling-unit-z"></a>
+<a class="index-entry-id" id="index-ps-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-cs-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-_005cH_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-_005cs_002c-with-fractional-type-sizes"></a>
+<p>A <em class="dfn">scaled point</em> is equal to <em class="math">1/<var class="var">sizescale</var></em> points, where
+<var class="var">sizescale</var> is specified in the device description file <samp class="file">DESC</samp>,
+and defaults to&nbsp;1.<a class="footnote" id="DOCF85" href="#FOOT85"><sup>85</sup></a>  Requests and escape sequences in GNU <code class="code">troff</code> interpret
+arguments that represent a type size in scaled points, which the
+formatter multiplies by <var class="var">sizescale</var> and converts to an integer.
+Arguments treated in this way comprise those to the escape sequences
+<code class="code">\H</code> and <code class="code">\s</code>, to the request <code class="code">ps</code>, the third argument to
+the <code class="code">cs</code> request, and the second and fourth arguments to the
+<code class="code">tkf</code> request.  Scaled points may be specified explicitly with the
+<code class="code">z</code> scaling unit.
+</p>
+<p>For example, if <var class="var">sizescale</var> is&nbsp;1000, then a scaled point is one
+thousandth of a point.  The request &lsquo;<samp class="samp">.ps 10.5</samp>&rsquo; is synonymous with
+&lsquo;<samp class="samp">.ps 10.5z</samp>&rsquo; and sets the type size to 10,500&nbsp;scaled points, or
+10.5&nbsp;points.  Consequently, in GNU <code class="code">troff</code>, the register
+<code class="code">.s</code> can interpolate a non-integral type size.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eps_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ps</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eps_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eps-3"></a>
+<p>This read-only register interpolates the type size in scaled points; it
+is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<p>It makes no sense to use the &lsquo;<samp class="samp">z</samp>&rsquo; scaling unit in a numeric
+expression whose default scaling unit is neither &lsquo;<samp class="samp">u</samp>&rsquo; nor &lsquo;<samp class="samp">z</samp>&rsquo;,
+so GNU <code class="code">troff</code> disallows this.  Similarly, it is nonsensical to use
+a scaling unit other than &lsquo;<samp class="samp">z</samp>&rsquo; or &lsquo;<samp class="samp">u</samp>&rsquo; in a numeric expression
+whose default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;, and so GNU <code class="code">troff</code>
+disallows this as well.
+</p>
+<p>Another GNU <code class="code">troff</code> scaling unit, &lsquo;<samp class="samp">s</samp>&rsquo;, multiplies by the
+number of basic units in a scaled point.  Thus, &lsquo;<samp class="samp">\n.pss</samp>&rsquo; is equal
+to &lsquo;<samp class="samp">1m</samp>&rsquo; by definition.  Do not confuse the &lsquo;<samp class="samp">s</samp>&rsquo; and &lsquo;<samp class="samp">z</samp>&rsquo;
+scaling units.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002epsr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.psr</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epsr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epsr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sr</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esr"></a>
+<a class="index-entry-id" id="index-last_002drequested-type-size-registers-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-type-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-last_002drequested-point-size-registers-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-point-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-_002eps-register_002c-in-comparison-with-_002epsr"></a>
+<a class="index-entry-id" id="index-_002es-register_002c-in-comparison-with-_002esr"></a>
+<p>Output devices may be limited in the type sizes they can employ.  The
+<code class="code">.s</code> and <code class="code">.ps</code> registers represent the type size selected by
+the output driver as it understands a device&rsquo;s capability.  The last
+<em class="emph">requested</em> type size is interpolated in scaled points by the
+read-only register <code class="code">.psr</code> and in points as a decimal fraction by
+the read-only string-valued register <code class="code">.sr</code>.  Both are associated
+with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<p>For example, if a type size of 10.95 points is requested, and the
+nearest size permitted by a <code class="code">sizes</code> request (or by the <code class="code">sizes</code>
+or <code class="code">sizescale</code> directives in the device&rsquo;s <samp class="file">DESC</samp> file) is 11
+points, the output driver uses the latter value.
+</p></dd></dl>
+
+<p>The <code class="code">\s</code> escape sequence offers the following syntax forms that
+work with fractional type sizes and accept scaling units.  You may of
+course give them integral arguments.  The delimited forms need not use
+the neutral apostrophe; see <a class="ref" href="#Delimiters">Delimiters</a>.
+</p>
+<dl class="table">
+<dt><code class="code">\s<var class="var">n</var></code></dt>
+<dt><code class="code">\s'<var class="var">n</var>'</code></dt>
+<dd><p>Set the type size to <var class="var">n</var>&nbsp;scaled points; <var class="var">n</var>&nbsp;is a
+numeric expression with a default scaling unit of &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p>
+</dd>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dt><code class="code">\s'+<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s'-<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s+'<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s-'<var class="var">n</var>'</code></dt>
+<dd><p>Increase or decrease the type size by <var class="var">n</var>&nbsp;scaled points;
+<var class="var">n</var>&nbsp;is a numeric expression (which may start with a minus sign)
+with a default scaling unit of &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p></dd>
+</dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Colors">
+<div class="nav-panel">
+<p>
+Next: <a href="#Strings" accesskey="n" rel="next">Strings</a>, Previous: <a href="#Manipulating-Type-Size-and-Vertical-Spacing" accesskey="p" rel="prev">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Colors-1">5.21 Colors</h3>
+<a class="index-entry-id" id="index-colors"></a>
+
+<a class="index-entry-id" id="index-stroke-color"></a>
+<a class="index-entry-id" id="index-color_002c-stroke"></a>
+<a class="index-entry-id" id="index-fill-color"></a>
+<a class="index-entry-id" id="index-color_002c-fill"></a>
+<p>GNU <code class="code">troff</code> supports color output with a variety of color spaces
+and up to 16 bits per channel.  Some devices, particularly terminals,
+may be more limited.  When color support is enabled, two colors are
+current at any given time: the <em class="dfn">stroke color</em>, with which glyphs,
+rules (lines), and geometric objects like circles and polygons are
+drawn, and the <em class="dfn">fill color</em>, which can be used to paint the interior
+of a closed geometric figure.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.color</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ecolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-color"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecolor_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.color</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecolor_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecolor-1"></a>
+<p>If <var class="var">n</var> is missing or non-zero, enable the output of color-related
+device-independent output commands (this is the default); otherwise,
+disable them.  This request sets a global flag; it does not produce an
+input token (see <a class="pxref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>).
+</p>
+<p>The read-only register <code class="code">.color</code> is&nbsp;1 if colors are enabled,
+0&nbsp;otherwise.
+</p>
+<p>Color can also be disabled with the <samp class="option">-c</samp> command-line option.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edefcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.defcolor</code></strong> <var class="def-var-arguments">ident scheme color-component &hellip;</var><a class="copiable-link" href='#index-_002edefcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-defcolor"></a>
+<p>Define a color named <var class="var">ident</var>.  <var class="var">scheme</var> selects a color space
+and determines the quantity of required <var class="var">color-component</var>s; it must
+be one of &lsquo;<samp class="samp">rgb</samp>&rsquo; (three components), &lsquo;<samp class="samp">cmy</samp>&rsquo; (three), &lsquo;<samp class="samp">cmyk</samp>&rsquo;
+(four), or &lsquo;<samp class="samp">gray</samp>&rsquo; (one).  &lsquo;<samp class="samp">grey</samp>&rsquo; is accepted as a synonym of
+&lsquo;<samp class="samp">gray</samp>&rsquo;.  The color components can be encoded as a single
+hexadecimal value starting with &lsquo;<samp class="samp">#</samp>&rsquo; or &lsquo;<samp class="samp">##</samp>&rsquo;.  The former
+indicates that each component is in the range 0&ndash;255 (0&ndash;FF), the latter
+the range 0&ndash;65,535 (0&ndash;FFFF).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.defcolor half gray #7f
+.defcolor pink rgb #FFC0CB
+.defcolor magenta rgb  ##ffff0000ffff
+</pre></div></div>
+
+<a class="index-entry-id" id="index-f-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-f"></a>
+<a class="index-entry-id" id="index-scaling-unit-f"></a>
+<p>Alternatively, each color component can be specified as a decimal
+fraction in the range 0&ndash;1, interpreted using a default scaling
+unit of&nbsp;<code class="code">f</code>, which multiplies its value by 65,536 (but
+clamps it at 65,535).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.defcolor gray50 rgb 0.5 0.5 0.5
+.defcolor darkgreen rgb 0.1f 0.5f 0.2f
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-default-color"></a>
+<a class="index-entry-id" id="index-color_002c-default"></a>
+<p>Each output device has a color named &lsquo;<samp class="samp">default</samp>&rsquo;, which cannot be
+redefined.  A device&rsquo;s default stroke and fill colors are not
+necessarily the same.  For the <code class="code">dvi</code>, <code class="code">html</code>, <code class="code">pdf</code>,
+<code class="code">ps</code>, and <code class="code">xhtml</code> output devices, GNU <code class="code">troff</code>
+automatically loads a macro file defining many color names at startup.
+By the same mechanism, the devices supported by <code class="code">grotty</code> recognize
+the eight standard ISO&nbsp;6429/EMCA-48 color names.<a class="footnote" id="DOCF86" href="#FOOT86"><sup>86</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002egcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.gcolor</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">color</i></span></var><a class="copiable-link" href='#index-_002egcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-gcolor"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cmc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cmc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cm_0028co"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m(</code><span class="r"><i class="slanted">co</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cm_0028co'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cm_005bcolor_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m</code><span class="r"><i class="slanted">color</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cm_005bcolor_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002em_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.m</code></strong><a class="copiable-link" href='#index-_005cn_005b_002em_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002em"></a>
+<p>Set the stroke color to <var class="var">color</var>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.gcolor red
+The next words
+.gcolor
+\mredare in red\m
+and these words are in the previous color.
+</pre></div></div>
+
+<p>The escape sequence <code class="code">\m</code> restores the previous stroke color, as
+does a <code class="code">gcolor</code> request without an argument.
+</p>
+<a class="index-entry-id" id="index-stroke-color-name-register-_0028_002em_0029"></a>
+<a class="index-entry-id" id="index-name_002c-stroke-color_002c-register-_0028_002em_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-stroke_002c-register-_0028_002em_0029"></a>
+<p>The name of the current stroke color is available in the read-only
+string-valued register &lsquo;<samp class="samp">.m</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).  It interpolates nothing when the stroke color
+is the default.
+</p>
+<p><code class="code">\m</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>
+(see <a class="pxref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>).  It therefore can be used in requests like
+<code class="code">mc</code> (which expects a single character as an argument) to change
+the color on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \mredx\m
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fcolor</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">color</i></span></var><a class="copiable-link" href='#index-_002efcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fcolor"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cMc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cMc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cM"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cM_0028co"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M(</code><span class="r"><i class="slanted">co</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cM_0028co'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cM_005bcolor_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M</code><span class="r"><i class="slanted">color</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cM_005bcolor_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.M</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eM"></a>
+<p>Set the fill color for objects drawn with <code class="code">\D'&hellip;'</code> escape
+sequences.  The escape sequence <code class="code">\M</code> restores the previous fill
+color, as does an <code class="code">fcolor</code> request without an argument.
+</p>
+<a class="index-entry-id" id="index-background-color-name-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-name_002c-background-color_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-background_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-fill-color-name-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-name_002c-fill-color_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-fill_002c-register-_0028_002eM_0029"></a>
+<p>The name of the current fill color is available in the read-only
+string-valued register &lsquo;<samp class="samp">.M</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).  It interpolates nothing when the fill color
+is the default.  <code class="code">\M</code> doesn&rsquo;t produce an input token in GNU
+<code class="code">troff</code>.
+</p>
+<p>Create an ellipse with a red interior as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\Mred\h'0.5i'\D'E 2i 1i'\M
+</pre></div></div>
+</dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Strings">
+<div class="nav-panel">
+<p>
+Next: <a href="#Conditionals-and-Loops" accesskey="n" rel="next">Conditionals and Loops</a>, Previous: <a href="#Colors" accesskey="p" rel="prev">Colors</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Strings-1">5.22 Strings</h3>
+<a class="index-entry-id" id="index-strings"></a>
+
+<p>GNU <code class="code">troff</code> supports strings primarily for user convenience.
+Conventionally, if one would define a macro only to interpolate a small
+amount of text, without invoking requests or calling any other macros,
+one defines a string instead.  Only one string is predefined by the
+language.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002eT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*.T</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002eT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eT"></a>
+<a class="index-entry-id" id="index-_002eT-1"></a>
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029-1"></a>
+<p>Contains the name of the output device (for example, &lsquo;<samp class="samp">utf8</samp>&rsquo; or
+&lsquo;<samp class="samp">pdf</samp>&rsquo;).
+</p></dd></dl>
+
+<p>The <code class="code">ds</code> request creates a string with a specified name and
+contents and the <code class="code">\*</code> escape sequence dereferences its name,
+interpolating its contents.  If the string named by the <code class="code">\*</code> escape
+sequence does not exist, it is defined as empty, nothing is
+interpolated, and a warning in category &lsquo;<samp class="samp">mac</samp>&rsquo; is emitted.
+See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and suppression of
+warnings.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eds-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eds-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eds1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eds1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002an"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002an'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002a"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002a_0028nm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bname-_005barg1-arg2-_2026_005d_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*</code><span class="r"><i class="slanted">name <span class="sansserif"></span>arg1 arg2 &hellip;<span class="sansserif"></span></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002a_005bname-_005barg1-arg2-_2026_005d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-string-interpolation-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-string-expansion-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-interpolation-of-strings-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-expansion-of-strings-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-string-arguments"></a>
+<a class="index-entry-id" id="index-arguments_002c-to-strings"></a>
+<p>Define a string called <var class="var">name</var> with contents <var class="var">contents</var>.  If
+<var class="var">name</var> already exists as an alias, the target of the alias is
+redefined; see <code class="code">als</code> and <code class="code">rm</code> below.  If <code class="code">ds</code> is called
+with only one argument, <var class="var">name</var> is defined as an empty string.
+Otherwise, GNU <code class="code">troff</code> stores <var class="var">contents</var> in copy
+mode.<a class="footnote" id="DOCF87" href="#FOOT87"><sup>87</sup></a>
+</p>
+<p>The <code class="code">\*</code> escape sequence interpolates a previously defined string
+variable <var class="var">name</var> (one-character name&nbsp;<var class="var">n</var>, two-character name
+<var class="var">nm</var>).  The bracketed interpolation form accepts arguments that are
+handled as macro arguments are; recall <a class="ref" href="#Calling-Macros">Calling Macros</a>.  In
+contrast to macro calls, however, if a closing bracket &lsquo;<samp class="samp"></samp>&rsquo; occurs
+in a string argument, that argument must be enclosed in double quotes.
+<code class="code">\*</code> is interpreted even in copy mode.  When defining strings,
+argument interpolations must be escaped if they are to reference
+parameters from the calling context; See <a class="xref" href="#Parameters">Parameters</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds cite (\\$1, \\$2)
+Gray codes are explored in \*cite Morgan 1998.
+    &rArr; Gray codes are explored in (Morgan, 1998).
+</pre></div></div>
+
+
+<a class="index-entry-id" id="index-trailing-spaces-in-string-definitions-and-appendments"></a>
+<a class="index-entry-id" id="index-comments_002c-with-ds"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-comments"></a>
+<p><strong class="strong">Caution:</strong> Unlike other requests, the second argument to the
+<code class="code">ds</code> request consumes the remainder of the input line, including
+trailing spaces.  This means that comments on a line with such a request
+can introduce unwanted space into a string when they are set off from
+the material they annotate, as is conventional.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \&quot; water
+</pre></div></div>
+
+<p>Instead, place the comment on another line or put the comment escape
+sequence immediately adjacent to the last character of the string.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\&quot; water
+</pre></div></div>
+
+<p>Ending string definitions (and appendments) with a comment, even an
+empty one, prevents unwanted space from creeping into them during source
+document maintenance.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds author Alice Pleasance Liddell\&quot;
+.ds empty \&quot; might be appended to later with .as
+</pre></div></div>
+
+<a class="index-entry-id" id="index-trailing-double-quotes-in-strings"></a>
+<a class="index-entry-id" id="index-double-quotes_002c-trailing_002c-in-strings"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-double-quotes"></a>
+<a class="index-entry-id" id="index-leading-spaces-with-ds"></a>
+<a class="index-entry-id" id="index-spaces-with-ds"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-leading-spaces"></a>
+<p>An initial neutral double quote <code class="code">&quot;</code> in <var class="var">contents</var> is stripped
+to allow embedding of leading spaces.  Any other <code class="code">&quot;</code> is interpreted
+literally, but it is wise to use the special character escape sequence
+<code class="code">\dq</code> instead if the string might be interpolated as part of a
+macro argument; see <a class="ref" href="#Calling-Macros">Calling Macros</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds salutation &quot;         Yours in a white wine sauce,\&quot;
+.ds c-var-defn &quot;  char mydate=\dq2020-07-29\dq;\&quot;
+</pre></div></div>
+
+<a class="index-entry-id" id="index-multi_002dline-strings"></a>
+<a class="index-entry-id" id="index-strings_002c-multi_002dline"></a>
+<a class="index-entry-id" id="index-newline-character_002c-in-strings_002c-escaping"></a>
+<a class="index-entry-id" id="index-escaping-newline-characters_002c-in-strings"></a>
+<p>Strings are not limited to a single input line of text.
+<code class="code">\<kbd class="key">RET</kbd></code> works just as it does elsewhere.  The resulting string
+is stored <em class="emph">without</em> the newlines.  Care is therefore required when
+interpolating strings while filling is disabled.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds foo This string contains \
+text on multiple lines \
+of input.
+</pre></div></div>
+
+<p>It is not possible to embed a newline in a string that will be
+interpreted as such when the string is interpolated.  To achieve that
+effect, use <code class="code">\*</code> to interpolate a macro instead; see <a class="ref" href="#Punning-Names">Punning Names</a>.
+</p>
+<p>Because strings are similar to macros, they too can be defined so as to
+suppress AT&amp;T <code class="code">troff</code> compatibility mode when used; see
+<a class="ref" href="#Writing-Macros">Writing Macros</a> and <a class="ref" href="#Compatibility-Mode">Compatibility Mode</a>.  The <code class="code">ds1</code>
+request defines a string such that compatibility mode is off when the
+string is later interpolated.  To be more precise, a <em class="dfn">compatibility
+save</em> input token is inserted at the beginning of the string, and a
+<em class="dfn">compatibility restore</em> input token at the end.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr xxx 12345
+.ds aa The value of xxx is \\nxxx.
+.ds1 bb The value of xxx is \\nxxx.
+.
+.cp 1
+.
+\*(aa
+    error&rarr; warning: register '' not defined
+    &rArr; The value of xxx is 0xxx.
+\*(bb
+    &rArr; The value of xxx is 12345.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eas"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.as</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eas'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-as"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eas1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.as1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eas1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-as1"></a>
+<a class="index-entry-id" id="index-appending-to-a-string-_0028as_0029"></a>
+<a class="index-entry-id" id="index-string_002c-appending-_0028as_0029"></a>
+<p>The <code class="code">as</code> request is similar to <code class="code">ds</code> but appends <var class="var">contents</var>
+to the string stored as <var class="var">name</var> instead of redefining it.  If
+<var class="var">name</var> doesn&rsquo;t exist yet, it is created.  If <code class="code">as</code> is called
+with only one argument, no operation is performed (beyond dereferencing
+the string).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.as salutation &quot; with shallots, onions and garlic,\&quot;
+</pre></div></div>
+
+<p>The <code class="code">as1</code> request is similar to <code class="code">as</code>, but compatibility mode
+is switched off when the appended portion of the string is later
+interpolated.  To be more precise, a <em class="dfn">compatibility save</em> input
+token is inserted at the beginning of the appended string, and a
+<em class="dfn">compatibility restore</em> input token at the end.
+</p></dd></dl>
+
+<p>Several requests exist to perform rudimentary string operations.
+Strings can be queried (<code class="code">length</code>) and modified (<code class="code">chop</code>,
+<code class="code">substring</code>, <code class="code">stringup</code>, <code class="code">stringdown</code>), and their names
+can be manipulated through renaming, removal, and aliasing (<code class="code">rn</code>,
+<code class="code">rm</code>, <code class="code">als</code>).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elength"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.length</code></strong> <var class="def-var-arguments">reg anything</var><a class="copiable-link" href='#index-_002elength'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-length"></a>
+<a class="index-entry-id" id="index-length-of-a-string-_0028length_0029"></a>
+<a class="index-entry-id" id="index-string_002c-length-of-_0028length_0029"></a>
+<a class="index-entry-id" id="index-length-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-length-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-length-request"></a>
+<p>Compute the number of characters of <var class="var">anything</var> and store the count
+in the register <var class="var">reg</var>.  If <var class="var">reg</var> doesn&rsquo;t exist, it is created.
+<var class="var">anything</var> is read in copy mode.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xxx abcd\h'3i'efgh
+.length yyy \*xxx
+\nyyy
+    &rArr; 14
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002echop"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.chop</code></strong> <var class="def-var-arguments">object</var><a class="copiable-link" href='#index-_002echop'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-chop"></a>
+<p>Remove the last character from the macro, string, or diversion named
+<var class="var">object</var>.  This is useful for removing the newline from the end of a
+diversion that is to be interpolated as a string.  This request can be
+used repeatedly on the same <var class="var">object</var>; see <a class="ref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>,
+for details on nodes inserted additionally by GNU <code class="code">troff</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esubstring"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.substring</code></strong> <var class="def-var-arguments">str start <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002esubstring'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-substring"></a>
+<a class="index-entry-id" id="index-substring-_0028substring_0029"></a>
+<p>Replace the string named <var class="var">str</var> with its substring bounded by the
+indices <var class="var">start</var> and <var class="var">end</var>, inclusively.  The first character in
+the string has index&nbsp;0.  If <var class="var">end</var> is omitted, it is implicitly
+set to the largest valid value (the string length minus one).  Negative
+indices count backward from the end of the string: the last character
+has index&nbsp;&minus;1, the character before the last has
+index&nbsp;&minus;2, and so on.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xxx abcdefgh
+.substring xxx 1 -4
+\*xxx
+    &rArr; bcde
+.substring xxx 2
+\*xxx
+    &rArr; de
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002estringdown"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.stringdown</code></strong> <var class="def-var-arguments">str</var><a class="copiable-link" href='#index-_002estringdown'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-stringdown"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002estringup"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.stringup</code></strong> <var class="def-var-arguments">str</var><a class="copiable-link" href='#index-_002estringup'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-stringup"></a>
+<a class="index-entry-id" id="index-case_002dtransforming-a-string-_0028stringdown_002c-stringup_0029"></a>
+<a class="index-entry-id" id="index-uppercasing-a-string-_0028stringup_0029"></a>
+<a class="index-entry-id" id="index-lowercasing-a-string-_0028stringdown_0029"></a>
+<a class="index-entry-id" id="index-up_002dcasing-a-string-_0028stringup_0029"></a>
+<a class="index-entry-id" id="index-down_002dcasing-a-string-_0028stringdown_0029"></a>
+<p>Alter the string named <var class="var">str</var> by replacing each of its bytes with its
+lowercase (<code class="code">stringdown</code>) or uppercase (<code class="code">stringup</code>) version (if
+one exists).  Special characters in the string will often transform in
+the expected way due to the regular naming convention for accented
+characters.  When they do not, use substrings and/or catenation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds resume R\'esum\'e
+\*resume
+.stringdown resume
+\*resume
+.stringup resume
+\*resume
+    &rArr; Résumé résumé RÉSUMÉ
+</pre></div></div>
+</dd></dl>
+
+<p>(In practice, we would end the <code class="code">ds</code> request with a comment escape
+<code class="code">\&quot;</code> to prevent space from creeping into the definition during
+source document maintenance.)
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ern"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rn</code></strong> <var class="def-var-arguments">old new</var><a class="copiable-link" href='#index-_002ern'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rn"></a>
+<a class="index-entry-id" id="index-renaming-request-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-request_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-macro-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-string-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-string_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-diversion-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-renaming-_0028rn_0029"></a>
+<p>Rename the request, macro, diversion, or string <var class="var">old</var> to <var class="var">new</var>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rm</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002erm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rm"></a>
+<a class="index-entry-id" id="index-removing-request-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-request_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-macro-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-string-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-string_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-diversion-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-removing-_0028rm_0029"></a>
+<p>Remove the request, macro, diversion, or string <var class="var">name</var>.  GNU
+<code class="code">troff</code> treats subsequent invocations as if the name had never
+been defined.
+</p></dd></dl>
+
+<a class="anchor" id="als"></a><dl class="first-deffn">
+<dt class="deffn" id="index-_002eals"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.als</code></strong> <var class="def-var-arguments">new old</var><a class="copiable-link" href='#index-_002eals'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-als"></a>
+<a class="index-entry-id" id="index-alias_002c-string_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-macro_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-diversion_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-string-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-macro-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-diversion-_0028als_0029"></a>
+<a class="index-entry-id" id="index-string_002c-creating-alias-for-_0028als_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-creating-alias-for-_0028als_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-creating-alias-for-_0028als_0029"></a>
+<p>Create an alias <var class="var">new</var> for the existing request, string, macro, or
+diversion object named <var class="var">old</var>, causing the names to refer to the same
+stored object.  If <var class="var">old</var> is undefined, a warning in category
+&lsquo;<samp class="samp">mac</samp>&rsquo; is produced, and the request is ignored.  See <a class="xref" href="#Warnings">Warnings</a>,
+for information about the enablement and suppression of warnings.
+</p>
+<p>To understand how the <code class="code">als</code> request works, consider two different
+storage pools: one for objects (macros, strings, etc.), and another
+for names.  As soon as an object is defined, GNU <code class="code">troff</code> adds it to
+the object pool, adds its name to the name pool, and creates a link
+between them.  When <code class="code">als</code> creates an alias, it adds a new name to
+the name pool that gets linked to the same object as the old name.
+</p>
+<p>Now consider this example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+..
+.
+.als bar foo
+.
+.de bar
+.  foo
+..
+.
+.bar
+    error&rarr; input stack limit exceeded (probable infinite
+    error&rarr; loop)
+</pre></div></div>
+
+<p>In the above, <code class="code">bar</code> remains an <em class="emph">alias</em>&mdash;another name
+for&mdash;the object referred to by <code class="code">foo</code>, which the second <code class="code">de</code>
+request replaces.  Alternatively, imagine that the <code class="code">de</code> request
+<em class="emph">dereferences</em> its argument before replacing it.  Either way, the
+result of calling <code class="code">bar</code> is a recursive loop that finally leads to
+an error.  See <a class="xref" href="#Writing-Macros">Writing Macros</a>.
+</p>
+<a class="index-entry-id" id="index-alias_002c-string_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-macro_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-diversion_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-string-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-macro-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-diversion-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-string_002c-removing-alias-for-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-removing-alias-for-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-removing-alias-for-_0028rm_0029"></a>
+<p>To remove an alias, call <code class="code">rm</code> on its name.  The object itself is
+not destroyed until it has no more names.
+</p>
+<p>When a request, macro, string, or diversion is aliased, redefinitions
+and appendments &ldquo;write through&rdquo; alias names.  To replace an alias with
+a separately defined object, you must use the <code class="code">rm</code> request on its
+name first.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Conditionals-and-Loops">
+<div class="nav-panel">
+<p>
+Next: <a href="#Writing-Macros" accesskey="n" rel="next">Writing Macros</a>, Previous: <a href="#Strings" accesskey="p" rel="prev">Strings</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Conditionals-and-Loops-1">5.23 Conditionals and Loops</h3>
+<a class="index-entry-id" id="index-conditionals-and-loops"></a>
+<a class="index-entry-id" id="index-loops-and-conditionals"></a>
+
+<p><code class="code">groff</code> has <code class="code">if</code> and <code class="code">while</code> control structures like
+other languages.  However, the syntax for grouping multiple input lines
+in the branches or bodies of these structures is unusual.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Operators-in-Conditionals" accesskey="1">Operators in Conditionals</a></li>
+<li><a href="#if_002dthen" accesskey="2">if-then</a></li>
+<li><a href="#if_002delse" accesskey="3">if-else</a></li>
+<li><a href="#Conditional-Blocks" accesskey="4">Conditional Blocks</a></li>
+<li><a href="#while" accesskey="5">while</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Operators-in-Conditionals">
+<div class="nav-panel">
+<p>
+Next: <a href="#if_002dthen" accesskey="n" rel="next">if-then</a>, Previous: <a href="#Conditionals-and-Loops" accesskey="p" rel="prev">Conditionals and Loops</a>, Up: <a href="#Conditionals-and-Loops" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Operators-in-Conditionals-1">5.23.1 Operators in Conditionals</h4>
+
+<a class="index-entry-id" id="index-if-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-ie-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-while-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-conditional-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-conditional"></a>
+<p>In <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> requests, in addition to the
+numeric expressions described in <a class="ref" href="#Numeric-Expressions">Numeric Expressions</a>, several
+Boolean operators are available; the members of this expanded class are
+termed <em class="dfn">conditional expressions</em>.
+</p>
+<dl class="table">
+<dt><code class="code">c <var class="var">glyph</var></code></dt>
+<dd><p>True if <var class="var">glyph</var> is available, where <var class="var">glyph</var> is an ordinary
+character, a special character &lsquo;<samp class="samp">\(<var class="var">xx</var></samp>&rsquo; or &lsquo;<samp class="samp">\<var class="var">xxx</var></samp>&rsquo;,
+&lsquo;<samp class="samp">\N'<var class="var">xxx</var>'</samp>&rsquo;, or has been defined by any of the <code class="code">char</code>,
+<code class="code">fchar</code>, <code class="code">fschar</code>, or <code class="code">schar</code> requests.
+</p>
+</dd>
+<dt><code class="code">d <var class="var">name</var></code></dt>
+<dd><p>True if a string, macro, diversion, or request called <var class="var">name</var> exists.
+</p>
+</dd>
+<dt><code class="code">e</code></dt>
+<dd><p>True if the current page is even-numbered.
+</p>
+</dd>
+<dt><code class="code">F <var class="var">font</var></code></dt>
+<dd><p>True if <var class="var">font</var> exists.  <var class="var">font</var> is handled as if it were opened
+with the <code class="code">ft</code> request (that is, font translation and styles are
+applied), without actually mounting it.
+</p>
+</dd>
+<dt><code class="code">m <var class="var">color</var></code></dt>
+<dd><p>True if <var class="var">color</var> is defined.
+</p>
+</dd>
+<dt id='index-conditional-output-for-terminal-_0028TTY_0029'><span><code class="code">n</code><a class="copiable-link" href='#index-conditional-output-for-terminal-_0028TTY_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TTY_002c-conditional-output-for"></a>
+<a class="index-entry-id" id="index-terminal_002c-conditional-output-for"></a>
+<p>True if the document is being processed in <code class="code">nroff</code> mode.
+See <a class="xref" href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>.
+</p>
+</dd>
+<dt><code class="code">o</code></dt>
+<dd><p>True if the current page is odd-numbered.
+</p>
+</dd>
+<dt><code class="code">r <var class="var">register</var></code></dt>
+<dd><p>True if <var class="var">register</var> exists.
+</p>
+</dd>
+<dt><code class="code">S <var class="var">style</var></code></dt>
+<dd><p>True if <var class="var">style</var> is available for the current font family.  Font
+translation is applied.
+</p>
+</dd>
+<dt><code class="code">t</code></dt>
+<dd><p>True if the document is being processed in <code class="code">troff</code> mode.
+See <a class="xref" href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>.
+</p>
+<a class="index-entry-id" id="index-vtroff"></a>
+</dd>
+<dt><code class="code">v</code></dt>
+<dd><p>Always false.  This condition is recognized only for compatibility with
+certain other <code class="code">troff</code> implementations.<a class="footnote" id="DOCF88" href="#FOOT88"><sup>88</sup></a>
+</p></dd>
+</dl>
+
+<p>If the first argument to an <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code>
+request begins with a non-alphanumeric character apart from <code class="code">!</code>
+(see below); it performs an <i class="slanted">output comparison test</i>.
+<a class="footnote" id="DOCF89" href="#FOOT89"><sup>89</sup></a>
+</p>
+<a class="index-entry-id" id="index-output-comparison-operator"></a>
+<dl class="table">
+<dt><code class="code"><code class="code">'</code><var class="var">xxx</var><code class="code">'</code><var class="var">yyy</var><code class="code">'</code></code></dt>
+<dd><p>True if formatting the comparands <var class="var">xxx</var> and <var class="var">yyy</var> produces the
+same output commands.  The delimiter need not be a neutral apostrophe:
+the output comparison operator accepts the same delimiters as most
+escape sequences; see <a class="ref" href="#Delimiters">Delimiters</a>.  This <em class="dfn">output comparison
+operator</em> formats <var class="var">xxx</var> and <var class="var">yyy</var> in separate environments;
+after the comparison, the resulting data are discarded.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ie &quot;|&quot;\fR|\fP&quot; true
+.el false
+    &rArr; true
+</pre></div></div>
+
+<p>The resulting glyph properties, including font family, style, size, and
+slant, must match, but not necessarily the requests and/or escape
+sequences used to obtain them.  In the previous example, &lsquo;<samp class="samp">|</samp>&rsquo; and
+&lsquo;<samp class="samp">\fR|\fP</samp>&rsquo; result in &lsquo;<samp class="samp">|</samp>&rsquo; glyphs in the same typefaces at the
+same positions, so the comparands are equal.  If &lsquo;<samp class="samp">.ft&nbsp;I</samp>&rsquo; had
+been added before the &lsquo;<samp class="samp">.ie</samp>&rsquo;, they would differ: the first &lsquo;<samp class="samp">|</samp>&rsquo;
+would produce an italic &lsquo;<samp class="samp">|</samp>&rsquo;, not a roman one.  Motions must match
+in orientation and magnitude to within the applicable horizontal and
+vertical motion quanta of the device, after rounding.  &lsquo;<samp class="samp">.if
+&quot;\u\d&quot;\v'0'&quot;</samp>&rsquo; is false even though both comparands result in zero net
+motion, because motions are not interpreted or optimized but sent as-is
+to the output.<a class="footnote" id="DOCF90" href="#FOOT90"><sup>90</sup></a>  On the other hand, &lsquo;<samp class="samp">.if &quot;\d&quot;\v'0.5m'&quot;</samp>&rsquo; is true, because
+<code class="code">\d</code> is defined as a downward motion of one-half em.<a class="footnote" id="DOCF91" href="#FOOT91"><sup>91</sup></a>
+</p>
+<a class="index-entry-id" id="index-string-comparison"></a>
+<a class="index-entry-id" id="index-comparison-of-strings"></a>
+<p>Surround the comparands with <code class="code">\?</code> to avoid formatting them; this
+causes them to be compared character by character, as with string
+comparisons in other programming languages.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ie &quot;\?|\?&quot;\?\fR|\fP\?&quot; true
+.el false
+    &rArr; false
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_003f_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005c_003f"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005c_003f"></a>
+<p>Since comparands protected with <code class="code">\?</code> are read in copy mode
+(see <a class="pxref" href="#Copy-Mode">Copy Mode</a>), they need not even be valid <code class="code">groff</code> syntax.
+The escape character is still lexically recognized, however, and
+consumes the next character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds a \
+.ds b \
+.if '\?\*a\?'\?\*b\?' a and b equivalent
+.if '\?\\?'\?\\?' backslashes equivalent
+    &rArr; a and b equivalent
+</pre></div></div>
+</dd>
+</dl>
+
+<p>The above operators can&rsquo;t be combined with most others, but a leading
+&lsquo;<samp class="samp">!</samp>&rsquo;, not followed immediately by spaces or tabs, complements an
+expression.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 1
+.ie !r x register x is not defined
+.el      register x is defined
+    &rArr; register x is defined
+</pre></div></div>
+
+<p>Spaces and tabs are optional immediately after the &lsquo;<samp class="samp">c</samp>&rsquo;, &lsquo;<samp class="samp">d</samp>&rsquo;,
+&lsquo;<samp class="samp">F</samp>&rsquo;, &lsquo;<samp class="samp">m</samp>&rsquo;, &lsquo;<samp class="samp">r</samp>&rsquo;, and &lsquo;<samp class="samp">S</samp>&rsquo; operators, but right after
+&lsquo;<samp class="samp">!</samp>&rsquo;, they end the predicate and the conditional evaluates
+true.<a class="footnote" id="DOCF92" href="#FOOT92"><sup>92</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 1
+.ie ! r x register x is not defined
+.el       register x is defined
+    &rArr; r x register x is not defined
+</pre></div></div>
+
+<p>The unexpected &lsquo;<samp class="samp">r x</samp>&rsquo; in the output is a clue that our conditional
+was not interpreted as we planned, but matters may not always be so
+obvious.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="if_002dthen">
+<div class="nav-panel">
+<p>
+Next: <a href="#if_002delse" accesskey="n" rel="next">if-else</a>, Previous: <a href="#Operators-in-Conditionals" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="#Conditionals-and-Loops" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="if_002dthen-1">5.23.2 if-then</h4>
+<a class="index-entry-id" id="index-if_002dthen"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eif"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.if</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002eif'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-if"></a>
+<p>Evaluate the conditional expression <var class="var">cond-expr</var>, and if it evaluates
+true (or to a positive value), interpret the remainder of the line
+<var class="var">anything</var> as if it were an input line.  Recall from <a class="ref" href="#Invoking-Requests">Invoking Requests</a> that any quantity of spaces between arguments to requests
+serves only to separate them; leading spaces in <var class="var">anything</var> are thus
+not seen.  <var class="var">anything</var> effectively <em class="emph">cannot</em> be omitted; if
+<var class="var">cond-expr</var> is true and <var class="var">anything</var> is empty, the newline at the
+end of the control line is interpreted as a blank input line (and
+therefore a blank text line).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">super\c
+tanker
+.nr force-word-break 1
+super\c
+.if ((\nforce-word-break = 1) &amp; \n.int)
+tanker
+    &rArr; supertanker super tanker
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enop"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nop</code></strong> <var class="def-var-arguments">anything</var><a class="copiable-link" href='#index-_002enop'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nop"></a>
+<p>Interpret <var class="var">anything</var> as if it were an input line.  This is similar
+to &lsquo;<samp class="samp">.if&nbsp;1</samp>&rsquo;.  <code class="code">nop</code> is not really &ldquo;no operation&rdquo;; its
+argument <em class="emph">is</em> processed&mdash;unconditionally.  It can be used to cause
+text lines to share indentation with surrounding control lines.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als real-MAC MAC
+.de wrapped-MAC
+.  tm MAC: called with arguments \\$@
+.  nop \\*real-MAC\\
+..
+.als MAC wrapped-MAC
+\# Later...
+.als MAC real-MAC
+</pre></div></div>
+
+<p>In the above, we&rsquo;ve used aliasing, <code class="code">nop</code>, and the interpolation of
+a macro as a string to interpose a wrapper around the macro &lsquo;<samp class="samp">MAC</samp>&rsquo;
+(perhaps to debug it).
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="if_002delse">
+<div class="nav-panel">
+<p>
+Next: <a href="#while" accesskey="n" rel="next">while</a>, Previous: <a href="#Operators-in-Conditionals" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="#Conditionals-and-Loops" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="if_002delse-1">5.23.3 if-else</h4>
+<a class="index-entry-id" id="index-if_002delse"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eie"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ie</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002eie'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ie"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eel"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.el</code></strong> <var class="def-var-arguments">anything</var><a class="copiable-link" href='#index-_002eel'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-el"></a>
+<p>Use the <code class="code">ie</code> and <code class="code">el</code> requests to write an if-then-else.  The
+first request is the &ldquo;if&rdquo; part and the latter is the &ldquo;else&rdquo; part.
+Unusually among programming languages, any number of non-conditional
+requests may be interposed between the <code class="code">ie</code> branch and the
+<code class="code">el</code> branch.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0
+.ie \na a is non-zero.
+.nr a +1
+.el a was not positive but is now \na.
+    &rArr; a was not positive but is now 1.
+</pre></div></div>
+
+<p>Another way in which <code class="code">el</code> is an ordinary request is that it does
+not lexically &ldquo;bind&rdquo; more tightly to its <code class="code">ie</code> counterpart than it
+does to any other request.  This fact can surprise C programmers.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.nr z 0
+.ie \nz \
+.  ie \na a is true
+.  el     a is false
+.el z is false
+    error&rarr; warning: unbalanced 'el' request
+    &rArr; a is false
+</pre></div></div>
+
+<p>To conveniently nest conditionals, keep reading.
+</p>
+</dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Conditional-Blocks">
+<div class="nav-panel">
+<p>
+Next: <a href="#while" accesskey="n" rel="next">while</a>, Previous: <a href="#Operators-in-Conditionals" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="#Conditionals-and-Loops" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Conditional-Blocks-1">5.23.4 Conditional Blocks</h4>
+<a class="index-entry-id" id="index-conditional-blocks"></a>
+<a class="index-entry-id" id="index-blocks_002c-conditional"></a>
+
+<p>It is frequently desirable for a control structure to govern more than
+one request, macro call, text line, or a combination of the foregoing.
+The opening and closing brace escape sequences <code class="code">\{</code> and <code class="code">\}</code>
+define such groups.  These <em class="dfn">conditional blocks</em> can furthermore be
+nested.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007b-2"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\{</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007b-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007b"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_007d-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\}</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007b-1"></a>
+<a class="index-entry-id" id="index-_005c_007d"></a>
+<a class="index-entry-id" id="index-beginning-of-conditional-block-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-end-of-conditional-block-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-conditional-block_002c-beginning-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-conditional-block_002c-end-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-block_002c-conditional_002c-beginning-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-block_002c-conditional_002c-end-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequences-_0028_005c_007b_002c-_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-escape-sequences_002c-brace-_0028_005c_007b_002c-_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-opening-brace-escape-sequence-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-closing-brace-escape-sequence-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequence_002c-opening-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequence_002c-closing-_0028_005c_007d_0029"></a>
+<p><code class="code">\{</code> begins a conditional block; it must appear (after optional
+spaces and tabs) immediately subsequent to the conditional expression of
+an <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code>
+request,<a class="footnote" id="DOCF93" href="#FOOT93"><sup>93</sup></a> or as the argument to an <code class="code">el</code>
+request.
+</p>
+<p><code class="code">\}</code> ends a condition block and should appear on a line with other
+occurrences of itself as necessary to match <code class="code">\{</code> sequences.  It
+can be preceded by a control character, spaces, and tabs.  Input after
+any quantity of <code class="code">\}</code> sequences on the same line is processed only
+if all of the preceding conditions to which they correspond are true.
+Furthermore, a <code class="code">\}</code> closing the body of a <code class="code">while</code> request
+must be the last such escape sequence on an input line.
+</p>
+<p>Brace escape sequences outside of control structures have no meaning and
+produce no output.
+</p>
+<p><strong class="strong">Caution:</strong> Input lines using <code class="code">\{</code> often end with
+<code class="code">\RET</code>, especially in macros that consist primarily of control
+lines.  Forgetting to use <code class="code">\RET</code> on an input line after <code class="code">\{</code>
+is a common source of error.
+</p></dd></dl>
+
+<p>We might write the following in a page header macro.  If we delete
+<code class="code">\RET</code>, the header will carry an unwanted extra empty line (except
+on page&nbsp;1).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if (\\n% != 1) \{\
+.  ie ((\\n% % 2) = 0) .tl \\*even-numbered-page-title
+.  el                    .tl \\*odd-numbered-page-title
+.\}
+</pre></div></div>
+
+<p>Let us take a closer look at how conditional blocks nest.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A
+.if 0 \{ B
+C
+D
+\}E
+F
+    &rArr; A F
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">N
+.if 1 \{ O
+.  if 0 \{ P
+Q
+R\} S\} T
+U
+    &rArr; N O U
+</pre></div></div>
+
+<p>The above behavior may challenge the intuition; it was implemented to
+retain compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  For clarity, it
+is idiomatic to end input lines with <code class="code">\{</code> (followed by
+<code class="code">\<kbd class="key">RET</kbd></code> if appropriate), and to precede <code class="code">\}</code> on an input
+line with nothing more than a control character, spaces, tabs, and other
+instances of itself.
+</p>
+<p>We can use <code class="code">ie</code>, <code class="code">el</code>, and conditional blocks to simulate the
+multi-way &ldquo;switch&rdquo; or &ldquo;case&rdquo; control structures of other languages.
+The following example is adapted from the <code class="code">groff</code> <samp class="file">man</samp>
+package.  Indentation is used to clarify the logic.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Simulate switch/case in roff.
+.      ie '\\$2'1' .ds title General Commands\&quot;
+.el \{.ie '\\$2'2' .ds title System Calls\&quot;
+.el \{.ie '\\$2'3' .ds title Library Functions\&quot;
+.el \{.ie '\\$2'4' .ds title Kernel Interfaces\&quot;
+.el \{.ie '\\$2'5' .ds title File Formats\&quot;
+.el \{.ie '\\$2'6' .ds title Games\&quot;
+.el \{.ie '\\$2'7' .ds title Miscellaneous Information\&quot;
+.el \{.ie '\\$2'8' .ds title System Management\&quot;
+.el \{.ie '\\$2'9' .ds title Kernel Development\&quot;
+.el                .ds title \&quot; empty
+.\}\}\}\}\}\}\}\}
+</pre></div></div>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="while">
+<div class="nav-panel">
+<p>
+Previous: <a href="#if_002delse" accesskey="p" rel="prev">if-else</a>, Up: <a href="#Conditionals-and-Loops" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="while-1">5.23.5 while</h4>
+<a class="index-entry-id" id="index-while"></a>
+
+<p><code class="code">groff</code> provides a looping construct: the <code class="code">while</code> request.
+Its syntax matches the <code class="code">if</code> request.
+</p>
+<a class="index-entry-id" id="index-body_002c-of-a-while-request"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewhile"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.while</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002ewhile'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-while-1"></a>
+<p>Evaluate the conditional expression <var class="var">cond-expr</var>, and repeatedly
+execute <var class="var">anything</var> unless and until <var class="var">cond-expr</var> evaluates false.
+<var class="var">anything</var>, which is often a conditional block, is referred to as
+the <code class="code">while</code> request&rsquo;s <em class="dfn">body</em>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0 1
+.while (\na &lt; 9) \{\
+\n+a,
+.\}
+\n+a
+    &rArr; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
+</pre></div></div>
+
+<a class="index-entry-id" id="index-de-request_002c-and-while"></a>
+<p>GNU <code class="code">troff</code> treats the body of a <code class="code">while</code> request similarly to
+that of a <code class="code">de</code> request (albeit one not read in copy
+mode<a class="footnote" id="DOCF94" href="#FOOT94"><sup>94</sup></a>), but stores it under an internal name
+and deletes it when the loop finishes.  The operation of a macro
+containing a <code class="code">while</code> request can slow significantly if the
+<code class="code">while</code> body is large.  Each time the macro is executed, the
+<code class="code">while</code> body is parsed and stored again.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  nr num 10
+.  while (\\nnum &gt; 0) \{\
+.    \&quot; many lines of code
+.    nr num -1
+.  \}
+..
+</pre></div></div>
+
+<a class="index-entry-id" id="index-recursive-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-recursive"></a>
+<p>An often better solution&mdash;and one that is more portable, since
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> lacked the <code class="code">while</code> request&mdash;is to
+instead write a recursive macro.  It will be parsed only
+once.<a class="footnote" id="DOCF95" href="#FOOT95"><sup>95</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de yyy
+.  if (\\nnum &gt; 0) \{\
+.    \&quot; many lines of code
+.    nr num -1
+.    yyy
+.  \}
+..
+.
+.de xxx
+.  nr num 10
+.  yyy
+..
+</pre></div></div>
+
+<p>To prevent infinite loops, the default number of available recursion
+levels is 1,000 or somewhat less.<a class="footnote" id="DOCF96" href="#FOOT96"><sup>96</sup></a>  You can
+disable this protective measure, or raise the limit, by setting the
+<code class="code">slimit</code> register.  See <a class="xref" href="#Debugging">Debugging</a>.
+</p>
+<p>As noted above, if a <code class="code">while</code> body begins with a conditional block,
+its closing brace must end an input line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if 1 \{\
+.  nr a 0 1
+.  while (\na &lt; 10) \{\
+.    nop \n+a
+.\}\}
+    error&rarr; unbalanced brace escape sequences
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebreak"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.break</code></strong><a class="copiable-link" href='#index-_002ebreak'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-break-2"></a>
+<a class="index-entry-id" id="index-while-request_002c-confusing-with-br"></a>
+<a class="index-entry-id" id="index-break-request_002c-in-a-while-loop"></a>
+<a class="index-entry-id" id="index-continue-request_002c-in-a-while-loop"></a>
+<p>Exit a <code class="code">while</code> loop.  Do not confuse this request with a
+typographical break or the <code class="code">br</code> request.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002econtinue"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.continue</code></strong><a class="copiable-link" href='#index-_002econtinue'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-continue"></a>
+<p>Skip the remainder of a <code class="code">while</code> loop&rsquo;s body, immediately starting
+the next iteration.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Writing-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="#Page-Motions" accesskey="n" rel="next">Page Motions</a>, Previous: <a href="#Conditionals-and-Loops" accesskey="p" rel="prev">Conditionals and Loops</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Writing-Macros-1">5.24 Writing Macros</h3>
+<a class="index-entry-id" id="index-writing-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-writing"></a>
+
+<p>A <em class="dfn">macro</em> is a stored collection of text and control lines that can
+be interpolated multiple times.  Use macros to define common operations.
+Macros are called in the same way that requests are invoked.  While
+requests exist for the purpose of creating macros, simply calling an
+undefined macro, or interpolating it as a string, will cause it to be
+defined as empty.  See <a class="xref" href="#Identifiers">Identifiers</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ede"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.de</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002ede'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-de"></a>
+<p>Define a macro <var class="var">name</var>, replacing the definition of any existing
+request, macro, string, or diversion called <var class="var">name</var>.  If
+<var class="var">name</var> already exists as an alias, the target of the alias is
+redefined; recall <a class="ref" href="#Strings">Strings</a>.  GNU <code class="code">troff</code> enters copy
+mode,<a class="footnote" id="DOCF97" href="#FOOT97"><sup>97</sup></a> storing subsequent input lines as the
+macro definition.  If the optional second argument is not specified, the
+definition ends with the control line &lsquo;<samp class="samp">..</samp>&rsquo; (two dots).
+Alternatively, <var class="var">end</var> identifies a macro whose call syntax at the
+start of a control line ends the definition of <var class="var">name</var>; <var class="var">end</var> is
+then called normally.  A macro definition must end in the same
+conditional block (if any) in which it began (see <a class="pxref" href="#Conditional-Blocks">Conditional Blocks</a>).  Spaces or tabs are permitted after the control character in
+the line containing this ending token (either &lsquo;<samp class="samp">.</samp>&rsquo; or
+&lsquo;<samp class="samp"><var class="var">end</var></samp>&rsquo;), but a tab immediately after the token prevents its
+recognition as the end of a macro definition.  The macro <var class="var">end</var> can
+be called with arguments.<a class="footnote" id="DOCF98" href="#FOOT98"><sup>98</sup></a>
+</p>
+<p>Here is a small example macro called &lsquo;<samp class="samp">P</samp>&rsquo; that causes a break and
+inserts some vertical space.  It could be used to separate paragraphs.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de P
+.  br
+.  sp .8v
+..
+</pre></div></div>
+
+<p>We can define one macro within another.  Attempting to nest &lsquo;<samp class="samp">..</samp>&rsquo;
+naïvely will end the outer definition because the inner definition
+isn&rsquo;t interpreted as such until the outer macro is later interpolated.
+We can use an end macro instead.  Each level of nesting should use a
+unique end macro.
+</p>
+<p>An end macro need not be defined until it is called.  This fact enables
+a nested macro definition to begin inside one macro and end inside
+another.  Consider the following example.<a class="footnote" id="DOCF99" href="#FOOT99"><sup>99</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de m1
+.  de m2 m3
+you
+..
+.de m3
+Hello,
+Joe.
+..
+.de m4
+do
+..
+.m1
+know?
+.  m3
+What
+.m4
+.m2
+    &rArr; Hello, Joe.  What do you know?
+</pre></div></div>
+
+<p>A nested macro definition <em class="emph">can</em> be terminated with &lsquo;<samp class="samp">..</samp>&rsquo; and
+nested macros <em class="emph">can</em> reuse end macros, but these control lines must
+be escaped multiple times for each level of nesting.  The necessity of
+this escaping and the utility of nested macro definitions will become
+clearer when we employ macro parameters and consider the behavior of
+copy mode in detail.
+</p></dd></dl>
+
+<p><code class="code">de</code> defines a macro that inherits the compatibility mode
+enablement status of its context (see <a class="pxref" href="#Implementation-Differences">Implementation Differences</a>).
+Often it is desirable to make a macro that uses <code class="code">groff</code> features
+callable from contexts where compatibility mode is on; for instance,
+when writing extensions to a historical macro package.  To achieve this,
+compatibility mode needs to be switched off while such a macro is
+interpreted&mdash;without disturbing that state when it is finished.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ede1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.de1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002ede1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-de1"></a>
+<p>The <code class="code">de1</code> request defines a macro to be interpreted with
+compatibility mode disabled.  When <var class="var">name</var> is called, compatibility
+mode enablement status is saved; it is restored when the call completes.
+Observe the extra backlash before the interpolation of register
+&lsquo;<samp class="samp">xxx</samp>&rsquo;; we&rsquo;ll explore this subject in <a class="ref" href="#Copy-Mode">Copy Mode</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr xxx 12345
+.de aa
+The value of xxx is \\nxxx.
+.  br
+..
+.de1 bb
+The value of xxx is \\nxxx.
+..
+.cp 1
+.aa
+    error&rarr; warning: register '' not defined
+    &rArr; The value of xxx is 0xxx.
+.bb
+    &rArr; The value of xxx is 12345.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edei"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dei</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002edei'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dei"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002edei1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dei1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002edei1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dei1"></a>
+<p>The <code class="code">dei</code> request defines a macro with its name and end
+macro indirected through strings.  That is, it interpolates strings
+named <var class="var">name</var> and <var class="var">end</var> before performing the definition.
+</p>
+<p>The following examples are equivalent.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xx aa
+.ds yy bb
+.dei xx yy
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de aa bb
+</pre></div></div>
+
+<p>The <code class="code">dei1</code> request bears the same relationship to <code class="code">dei</code> as
+<code class="code">de1</code> does to <code class="code">de</code>; it temporarily turns compatibility mode
+off when <var class="var">name</var> is called.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eam"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.am</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eam'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-am"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eam1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.am1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eam1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-am1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eami"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ami</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eami'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ami"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eami1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ami1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eami1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ami1"></a>
+<a class="index-entry-id" id="index-appending-to-a-macro-_0028am_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-appending-to-_0028am_0029"></a>
+<p><code class="code">am</code> appends subsequent input lines to macro <var class="var">name</var>, extending
+its definition, and otherwise working as <code class="code">de</code> does.
+</p>
+<p>To make the previously defined &lsquo;<samp class="samp">P</samp>&rsquo; macro set indented instead of
+block paragraphs, add the necessary code to the existing macro.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.am P
+.ti +5n
+..
+</pre></div></div>
+
+<p>The other requests are analogous to their &lsquo;<samp class="samp">de</samp>&rsquo; counterparts.  The
+<code class="code">am1</code> request turns off compatibility mode during interpretation of
+the appendment.  The <code class="code">ami</code> request appends indirectly, meaning that
+strings <var class="var">name</var> and <var class="var">end</var> are interpolated with the resulting
+names used before appending.  The <code class="code">ami1</code> request is similar to
+<code class="code">ami</code>, disabling compatibility mode during interpretation of the
+appended lines.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-trace_002etmac"></a>
+<p>Using <samp class="file">trace.tmac</samp>, you can trace calls to <code class="code">de</code>,
+<code class="code">de1</code>, <code class="code">am</code>, and <code class="code">am1</code>.  You can also use the
+<code class="code">backtrace</code> request at any point desired to troubleshoot tricky
+spots (see <a class="pxref" href="#Debugging">Debugging</a>).
+</p>
+<p>See <a class="xref" href="#Strings">Strings</a>, for the <code class="code">als</code>, <code class="code">rm</code>, and <code class="code">rn</code> requests to
+create an alias of, remove, and rename a macro, respectively.
+</p>
+<a class="index-entry-id" id="index-object-creation"></a>
+<p>Macro identifiers share their name space with requests, strings, and
+diversions; see <a class="ref" href="#Identifiers">Identifiers</a>.  The <code class="code">am</code>, <code class="code">as</code>, <code class="code">da</code>,
+<code class="code">de</code>, <code class="code">di</code>, and <code class="code">ds</code> requests (together with their
+variants) create a new object only if the name of the macro, diversion,
+or string is currently undefined or if it is defined as a request;
+normally, they modify the value of an existing object.  See <a class="xref" href="#als">the
+description of the <code class="code">als</code> request</a>, for pitfalls when redefining a
+macro that is aliased.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ereturn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.return</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">anything</i></span></var><a class="copiable-link" href='#index-_002ereturn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-return"></a>
+<p>Exit a macro, immediately returning to the caller.  If called with an
+argument <var class="var">anything</var>, exit twice&mdash;the current macro and the macro
+one level higher.  This is used to define a wrapper macro for
+<code class="code">return</code> in <samp class="file">trace.tmac</samp>.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Parameters" accesskey="1">Parameters</a></li>
+<li><a href="#Copy-Mode" accesskey="2">Copy Mode</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Parameters">
+<div class="nav-panel">
+<p>
+Next: <a href="#Copy-Mode" accesskey="n" rel="next">Copy Mode</a>, Previous: <a href="#Writing-Macros" accesskey="p" rel="prev">Writing Macros</a>, Up: <a href="#Writing-Macros" accesskey="u" rel="up">Writing Macros</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Parameters-1">5.24.1 Parameters</h4>
+<a class="index-entry-id" id="index-parameters"></a>
+
+<p>Macro calls and string interpolations optionally accept a list of
+arguments; recall <a class="ref" href="#Calling-Macros">Calling Macros</a>.  At the time such an
+interpolation takes place, these <em class="dfn">parameters</em> can be examined using
+a register and a variety of escape sequences starting with &lsquo;<samp class="samp">\$</samp>&rsquo;.
+All such escape sequences are interpreted even in copy mode, a fact we
+shall motivate and explain below (see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002e_0024_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.$</code></strong><a class="copiable-link" href='#index-_005cn_005b_002e_0024_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002e_0024"></a>
+<a class="index-entry-id" id="index-parameter-count-register-_0028_002e_0024_0029"></a>
+<p>The count of parameters available to a macro or string is kept in this
+read-only register.  The <code class="code">shift</code> request can change its value.
+</p></dd></dl>
+
+<p>Any individual parameter can be accessed by its position in the list of
+arguments to the macro call, numbered from left to right starting at 1,
+with one of the following escape sequences.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0024n"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024n'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_0028nn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$(</code><span class="r"><i class="slanted">nn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_0028nn'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_0024_005bnnn_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$</code><span class="r"><i class="slanted">nnn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_005bnnn_005d'> &para;</a></span></dt>
+<dd><p>Interpolate the <var class="var">n</var>th, <var class="var">nn</var>th, or <var class="var">nnn</var>th parameter.  The
+first form expects only a single digit (1&le;<var class="var">n</var>&le;9)), the
+second two digits (01&le;<var class="var">nn</var>&le;99)), and the third any
+positive integer <var class="var">nnn</var>.  Macros and strings accept an unlimited
+number of parameters.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eshift"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.shift</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002eshift'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-shift"></a>
+<p>Shift the parameters <var class="var">n</var> places (1&nbsp;by default).  This is a
+&ldquo;left shift&rdquo;: what was parameter&nbsp;<var class="var">i</var> becomes parameter
+<em class="math"><var class="var">i</var>-<var class="var">n</var></em>.  The parameters formerly in positions 1
+to&nbsp;<var class="var">n</var> are no longer available.  Shifting by a non-positive
+amount performs no operation.  The register <code class="code">.$</code> is adjusted
+accordingly.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-copy-mode_002c-and-macro-parameters"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-macro-parameters"></a>
+<a class="index-entry-id" id="index-macro_002c-parameters-_0028_005c_0024_0029"></a>
+<a class="index-entry-id" id="index-parameters_002c-macro-_0028_005c_0024_0029"></a>
+<p>In practice, parameter interpolations are usually seen prefixed with an
+extra escape character.  This is because the <code class="code">\$</code> family of escape
+sequences is interpreted even in copy mode.<a class="footnote" id="DOCF100" href="#FOOT100"><sup>100</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0024_002a-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$*</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_002a-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_002a"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_0040-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$@</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_0040-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_0040"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_005e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$^</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_005e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_005e"></a>
+<p>In some cases it is convenient to interpolate all of the parameters at
+once (to pass them to a request, for instance).  The <code class="code">\$*</code> escape
+concatenates the parameters, separating them with spaces.  <code class="code">\$@</code>
+is similar, concatenating the parameters, surrounding each with double
+quotes and separating them with spaces.  If not in compatibility mode,
+the interpolation depth of double quotes is preserved (see <a class="pxref" href="#Calling-Macros">Calling Macros</a>).  <code class="code">\$^</code> interpolates all parameters as if they were
+arguments to the <code class="code">ds</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+. tm $1='\\$1'
+. tm $2='\\$2'
+. tm $*='\\$*'
+. tm $@='\\$@'
+. tm $^='\\$^'
+..
+.foo &quot; This is a &quot;test&quot;
+    error&rarr; $1=' This is a '
+    error&rarr; $2='test&quot;'
+    error&rarr; $*=' This is a  test&quot;'
+    error&rarr; $@='&quot; This is a &quot; &quot;test&quot;&quot;'
+    error&rarr; $^='&quot; This is a &quot;test&quot;'
+</pre></div></div>
+
+<p><code class="code">\$*</code> is useful when writing a macro that doesn&rsquo;t need to
+distinguish its arguments, or even to not interpret them; examples
+include macros that produce diagnostic messages by wrapping the
+<code class="code">tm</code> or <code class="code">ab</code> requests.  Use <code class="code">\$@</code> when writing a macro
+that may need to shift its parameters and/or wrap a macro or request
+that finds the count significant.  If in doubt, prefer <code class="code">\$@</code> to
+<code class="code">\$*</code>.  An application of <code class="code">\$^</code> is seen in <samp class="file">trace.tmac</samp>,
+which redefines some requests and macros for debugging purposes.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_00240-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$0</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_00240-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_00240"></a>
+<a class="index-entry-id" id="index-macro-name-register-_0028_005c_00240_0029"></a>
+<a class="index-entry-id" id="index-als-request_002c-and-_005c_00240"></a>
+<p>Interpolate the name by which the macro being interpreted was called.
+The <code class="code">als</code> request can cause a macro to have more than one name.
+Applying string interpolation to a macro does not change this name.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+.  tm \\$0
+..
+.als bar foo
+.
+.de aaa
+.  foo
+..
+.de bbb
+.  bar
+..
+.de ccc
+\\*foo\\
+..
+.de ddd
+\\*bar\\
+..
+.
+.aaa
+    error&rarr; foo
+.bbb
+    error&rarr; bar
+.ccc
+    error&rarr; ccc
+.ddd
+    error&rarr; ddd
+</pre></div></div>
+</dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Copy-Mode">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Parameters" accesskey="p" rel="prev">Parameters</a>, Up: <a href="#Writing-Macros" accesskey="u" rel="up">Writing Macros</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Copy-Mode-1">5.24.2 Copy Mode</h4>
+<a class="index-entry-id" id="index-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-copy"></a>
+<a class="index-entry-id" id="index-mode_002c-copy-1"></a>
+
+<a class="index-entry-id" id="index-_005cn_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005c_0024_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005cRET_002c-when-reading-text-for-a-macro"></a>
+<p>When GNU <code class="code">troff</code> processes certain requests, most importantly those
+which define or append to a macro or string, it does so in <em class="dfn">copy
+mode</em>: it copies the characters of the definition into a dedicated
+storage region, interpolating the escape sequences <code class="code">\n</code>, <code class="code">\g</code>,
+<code class="code">\$</code>, <code class="code">\*</code>, <code class="code">\V</code>, and <code class="code">\?</code> normally; interpreting
+<code class="code">\<kbd class="key">RET</kbd></code> immediately; discarding comments <code class="code">\&quot;</code> and
+<code class="code">\#</code>; interpolating the current leader, escape, or tab character
+with <code class="code">\a</code>, <code class="code">\e</code>, and <code class="code">\t</code>, respectively; and storing all
+other escape sequences in an encoded form.
+</p>
+<a class="index-entry-id" id="index-interpretation-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-interpretation"></a>
+<p>The complement of copy mode&mdash;a <code class="code">roff</code> formatter&rsquo;s behavior when
+not defining or appending to a macro, string, or diversion&mdash;where all
+macros are interpolated, requests invoked, and valid escape sequences
+processed immediately upon recognition, can be termed
+<em class="dfn">interpretation mode</em>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\\</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005c"></a>
+<p>The escape character, <code class="code">\</code> by default, can escape itself.  This
+enables you to control whether a given <code class="code">\n</code>, <code class="code">\g</code>, <code class="code">\$</code>,
+<code class="code">\*</code>, <code class="code">\V</code>, or <code class="code">\?</code> escape sequence is interpreted at the
+time the macro containing it is defined, or later when the macro is
+called.<a class="footnote" id="DOCF101" href="#FOOT101"><sup>101</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 20
+.de y
+.nr x 10
+\&amp;\nx
+\&amp;\\nx
+..
+.y
+    &rArr; 20 10
+</pre></div></div>
+
+<p>You can think of <code class="code">\\</code> as a &ldquo;delayed&rdquo; backslash; it is the escape
+character followed by a backslash from which the escape character has
+removed its special meaning.  Consequently, &lsquo;<samp class="samp">\\</samp>&rsquo; is not an escape
+sequence in the usual sense.  In any escape sequence &lsquo;<samp class="samp">\<var class="var">X</var></samp>&rsquo;
+that GNU <code class="code">troff</code> does not recognize, the escape character is
+ignored and <var class="var">X</var> is output.  An unrecognized escape sequence causes
+a warning in category &lsquo;<samp class="samp">escape</samp>&rsquo;, with two exceptions&mdash;&lsquo;<samp class="samp">\\</samp>&rsquo; is
+the first.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-_005c_005c_002c-when-reading-text-for-a-macro"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\.</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002e"></a>
+<p><code class="code">\.</code> escapes the control character.  It is similar to <code class="code">\\</code> in
+that it isn&rsquo;t a true escape sequence.  It is used to permit nested macro
+definitions to end without a named macro call to conclude them.  Without
+a syntax for escaping the control character, this would not be possible.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de m1
+foo
+.
+.  de m2
+bar
+\\..
+.
+..
+.m1
+.m2
+    &rArr; foo bar
+</pre></div></div>
+
+<p>The first backslash is consumed while the macro is read, and the second
+is interpreted when macro <code class="code">m1</code> is called.
+</p></dd></dl>
+
+<p><code class="code">roff</code> documents should not use the <code class="code">\\</code> or <code class="code">\.</code>
+character sequences outside of copy mode; they serve only to obfuscate
+the input.  Use <code class="code">\e</code> to represent the escape character,
+<code class="code">\rs</code> to obtain a backslash glyph, and <code class="code">\&amp;</code> before &lsquo;<samp class="samp">.</samp>&rsquo;
+and &lsquo;<samp class="samp">'</samp>&rsquo; where GNU <code class="code">troff</code> expects them as control characters
+if you mean to use them literally (recall <a class="ref" href="#Requests-and-Macros">Requests and Macros</a>).
+</p>
+<p>Macro definitions can be nested to arbitrary depth.  The mechanics of
+parsing the escape character have significant consequences for this
+practice.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de M1
+\\$1
+.  de M2
+\\\\$1
+.    de M3
+\\\\\\\\$1
+\\\\..
+.    M3 hand.
+\\..
+.  M2 of
+..
+This understeer is getting
+.M1 out
+    &rArr; This understeer is getting out of hand.
+</pre></div></div>
+
+<p>Each escape character is interpreted twice&mdash;once in copy mode, when the
+macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of
+<code class="code">\n</code>, <code class="code">\g</code>, <code class="code">\$</code>, <code class="code">\*</code>, <code class="code">\V</code>, and <code class="code">\?</code> at
+each nesting level, which can be daunting.  GNU <code class="code">troff</code> offers a
+solution.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cE-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\E</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cE-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cE"></a>
+<p><code class="code">\E</code> represents an escape character that is not interpreted in copy
+mode.  You can use it to ease the writing of nested macro definitions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de M1
+.  nop \E$1
+.  de M2
+.    nop \E$1
+.    de M3
+.      nop \E$1
+\\\\..
+.    M3 better.
+\\..
+.  M2 bit
+..
+This vehicle handles
+.M1 a
+    &rArr; This vehicle handles a bit better.
+</pre></div></div>
+
+<p>Observe that because <code class="code">\.</code> is not a true escape sequence, we can&rsquo;t
+use <code class="code">\E</code> to keep &lsquo;<samp class="samp">..</samp>&rsquo; from ending a macro definition
+prematurely.  If the multiplicity of backslashes complicates
+maintenance, use end macros.
+</p>
+<p><code class="code">\E</code> is also convenient to define strings containing escape
+sequences that need to work when used in copy mode (for example, as
+macro arguments), or which will be interpolated at varying macro nesting
+depths.  We might define strings to begin and end superscripting
+as follows.<a class="footnote" id="DOCF102" href="#FOOT102"><sup>102</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds { \v'-.9m\s'\En.s*7u/10u'+.7m'
+.ds } \v'-.7m\s0+.9m'
+</pre></div></div>
+
+<p>When the <code class="code">ec</code> request is used to redefine the escape character,
+<code class="code">\E</code> also makes it easier to distinguish the semantics of an escape
+character from the other meaning(s) its character might have.  Consider
+the use of an unusual escape character, &lsquo;<samp class="samp">-</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.ec -
+.de xx
+--na
+..
+.xx
+    &rArr; -na
+</pre></div></div>
+
+<p>This result may surprise you; some people expect &lsquo;<samp class="samp">1</samp>&rsquo; to be output
+since register &lsquo;<samp class="samp">a</samp>&rsquo; has clearly been defined with that value.  What
+has happened?  The robotic replacement of &lsquo;<samp class="samp">\</samp>&rsquo; with &lsquo;<samp class="samp">-</samp>&rsquo; has led
+us astray.  You might recognize the sequence &lsquo;<samp class="samp">--</samp>&rsquo; more readily with
+the default escape character as &lsquo;<samp class="samp">\-</samp>&rsquo;, the special character escape
+sequence for the minus sign glyph.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.ec -
+.de xx
+-Ena
+..
+.xx
+    &rArr; 1
+</pre></div></div>
+</dd></dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Page-Motions">
+<div class="nav-panel">
+<p>
+Next: <a href="#Drawing-Geometric-Objects" accesskey="n" rel="next">Drawing Geometric Objects</a>, Previous: <a href="#Writing-Macros" accesskey="p" rel="prev">Writing Macros</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Page-Motions-1">5.25 Page Motions</h3>
+<a class="index-entry-id" id="index-page-motions"></a>
+<a class="index-entry-id" id="index-motions_002c-page"></a>
+
+<p>See <a class="xref" href="#Manipulating-Spacing">Manipulating Spacing</a>, for a discussion of the most commonly used
+request for vertical motion, <code class="code">sp</code>, which spaces downward by one
+vee.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emk"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mk</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">reg</i></span></var><a class="copiable-link" href='#index-_002emk'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mk"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ert"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">dist</i></span></var><a class="copiable-link" href='#index-_002ert'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rt"></a>
+<a class="index-entry-id" id="index-marking-vertical-page-location-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-page-location_002c-vertical_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-location_002c-vertical_002c-page_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-vertical-page-location_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-returning-to-marked-vertical-page-location-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-page-location_002c-vertical_002c-returning-to-marked-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-location_002c-vertical_002c-page_002c-returning-to-marked-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-vertical-page-location_002c-returning-to-marked-_0028rt_0029"></a>
+<p>You can <em class="dfn">mark</em> a location on a page for subsequent <em class="dfn">return</em>.
+<code class="code">mk</code> takes an argument, a register name in which to store the
+current page location.  If given no argument, it stores the location in
+an internal register.  This location can be used later by the <code class="code">rt</code>
+or the <code class="code">sp</code> requests (or the <code class="code">\v</code> escape).
+</p>
+<p>The <code class="code">rt</code> request returns <em class="emph">upward</em> to the location marked with
+the last <code class="code">mk</code> request.  If used with an argument, it returns to a
+vertical position&nbsp;<var class="var">dist</var> from the top of the page (no previous
+call to <code class="code">mk</code> is necessary in this case).  The default scaling
+unit is &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<p>If a page break occurs between a <code class="code">mk</code> request and its matching
+<code class="code">rt</code> request, the <code class="code">rt</code> request is silently ignored.
+</p>
+<p>A simple implementation of a macro to set text in two columns follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr column-length 1.5i
+.nr column-gap 4m
+.nr bottom-margin 1m
+.
+.de 2c
+.  br
+.  mk
+.  ll \\ncolumn-lengthu
+.  wh -\\nbottom-marginu 2c-trap
+.  nr right-side 0
+..
+.
+.de 2c-trap
+.  ie \\nright-side \{\
+.    nr right-side 0
+.    po -(\\ncolumn-lengthu + \\ncolumn-gapu)
+.    \&quot; remove trap
+.    wh -\\nbottom-marginu
+.  \}
+.  el \{\
+.    \&quot; switch to right side
+.    nr right-side 1
+.    po +(\\ncolumn-lengthu + \\ncolumn-gapu)
+.    rt
+.  \}
+..
+</pre></div></div>
+
+<p>Now let us apply our two-column macro.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 1.5i
+.ll 4i
+This is a small test that shows how the
+rt request works in combination with mk.
+
+.2c
+Starting here, text is typeset in two columns.
+Note that this implementation isn't robust
+and thus not suited for a real two-column
+macro.
+    &rArr; This is a small test that shows how the
+    &rArr; rt request works in combination with mk.
+    &rArr;
+    &rArr; Starting  here,    isn't    robust
+    &rArr; text is typeset    and   thus  not
+    &rArr; in two columns.    suited  for   a
+    &rArr; Note that  this    real two-column
+    &rArr; implementation     macro.
+</pre></div></div>
+</dd></dl>
+
+<p>Several escape sequences enable fine control of movement about the page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cv_0027expr_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\v<code class="code">'</code></code><span class="r"><i class="slanted">expr</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cv_0027expr_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cv"></a>
+<a class="index-entry-id" id="index-vertical-motion-_0028_005cv_0029"></a>
+<a class="index-entry-id" id="index-motion_002c-vertical-_0028_005cv_0029"></a>
+<p>Vertically move the drawing position.  <var class="var">expr</var> indicates the
+magnitude of motion: positive is downward and and negative upward.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  The motion is relative to the current
+drawing position unless <var class="var">expr</var> begins with the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  See <a class="xref" href="#Numeric-Expressions">Numeric Expressions</a>.
+</p>
+<p>Text processing continues at the new drawing position; usually, vertical
+motions should be in balanced pairs to avoid a confusing page layout.
+</p>
+<p><code class="code">\v</code> will not spring a vertical position trap.  This can be useful;
+for example, consider a page bottom trap macro that prints a marker in
+the margin to indicate continuation of a footnote.  See <a class="xref" href="#Traps">Traps</a>.
+</p></dd></dl>
+
+<p>A few escape sequences that produce vertical motion are unusual.  They
+are thought to originate early in AT&amp;T <code class="code">nroff</code> history to achieve
+super- and subscripting by half-line motions on line printers and
+teletypewriters before the phototypesetter made more precise positioning
+available.  They are reckoned in ems&mdash;not vees&mdash;to maintain continuity
+with their original purpose of moving relative to the size of the type
+rather than the distance between text baselines (vees).<a class="footnote" id="DOCF103" href="#FOOT103"><sup>103</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cr-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\r</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cr-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cu-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\u</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cu-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cu"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cd-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\d</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cd-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cd"></a>
+<p>Move upward&nbsp;1<span class="dmn">m</span>, upward&nbsp;.5<span class="dmn">m</span>, and
+downward&nbsp;.5<span class="dmn">m</span>, respectively.
+</p></dd></dl>
+
+<p>Let us see these escape sequences in use.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Obtain 100 cm\u3\d of \ka\d\092\h'|\nau'\r233\dU.
+</pre></div></div>
+
+<p>In the foregoing we have paired <code class="code">\u</code> and <code class="code">\d</code> to typeset a
+superscript, and later a full em negative (&ldquo;reverse&rdquo;) motion to place
+a superscript above a subscript.  A numeral-width horizontal motion
+escape sequence aligns the proton and nucleon numbers, while <code class="code">\k</code>
+marks a horizontal position to which <code class="code">\h</code> returns so that we could
+stack them.  (We shall discuss these horizontal motion escape sequences
+presently.)  In serious applications, we often want to alter the type
+size of the -scripts and to fine-tune the vertical motions, as the
+<code class="code">groff</code> <samp class="file">ms</samp> package does with its super- and subscripting
+string definitions.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ch_0027expr_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\h<code class="code">'</code></code><span class="r"><i class="slanted">expr</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005ch_0027expr_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ch"></a>
+<a class="index-entry-id" id="index-inserting-horizontal-space-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-horizontal-space-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-space_002c-horizontal-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-horizontal-motion-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-motion_002c-horizontal-_0028_005ch_0029"></a>
+<p>Horizontally move the drawing position.  <var class="var">expr</var> indicates the
+magnitude of motion: positive is rightward and negative leftward.  The
+default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  The motion is relative to the current
+drawing position unless <var class="var">expr</var> begins with the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  See <a class="xref" href="#Numeric-Expressions">Numeric Expressions</a>.
+</p></dd></dl>
+
+<p>The following string definition sets the TeX
+logo.<a class="footnote" id="DOCF104" href="#FOOT104"><sup>104</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\&quot;
+</pre></div></div>
+
+<p>There are a number of special-case escape sequences for horizontal
+motion.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cSP-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<kbd class="key">SP</kbd></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cSP-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cSP"></a>
+<a class="index-entry-id" id="index-space_002c-unbreakable-and-unadjustable-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-unbreakable-and-unadjustable-space-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-unadjustable-and-unbreakable-space-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-_005cspace"></a>
+<p>Move right one word space.  (The input is a backslash followed by a
+space.)  This escape sequence can be thought of as a non-adjustable,
+unbreakable space.  Usually you want <code class="code">\~</code> instead; see
+<a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-thin-space-_0028_005c_007c_0029"></a>
+<a class="index-entry-id" id="index-space_002c-thin-_0028_005c_007c_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\|</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007c"></a>
+<p>Move one-sixth <span class="dmn">em</span> to the right on typesetting output devices.  If
+a glyph named &lsquo;<samp class="samp">\|</samp>&rsquo; is defined in the current font, its width is
+used instead, even on terminal output devices.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-hair-space-_0028_005c_005e_0029"></a>
+<a class="index-entry-id" id="index-space_002c-hair-_0028_005c_005e_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\^</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005e"></a>
+<p>Move one-twelfth <span class="dmn">em</span> to the right on typesetting output devices.
+If a glyph named &lsquo;<samp class="samp">\^</samp>&rsquo; is defined in the current font, its width is
+used instead, even on terminal output devices.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c0-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\0</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c0-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c0"></a>
+<a class="index-entry-id" id="index-space_002c-width-of-a-digit-_0028numeral_0029-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-digit_002dwidth-space-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-figure-space-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-numeral_002dwidth-space-_0028_005c0_0029"></a>
+<p>Move right by the width of a numeral in the current font.
+</p></dd></dl>
+
+<p>Horizontal motions are not discarded at the end of an output line as
+word spaces are.  See <a class="xref" href="#Breaking">Breaking</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cw_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\w<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cw_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cw"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bst_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nst</code></strong><a class="copiable-link" href='#index-_005cn_005bst_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-st"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bsb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nsb</code></strong><a class="copiable-link" href='#index-_005cn_005bsb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005brst_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nrst</code></strong><a class="copiable-link" href='#index-_005cn_005brst_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rst"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005brsb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nrsb</code></strong><a class="copiable-link" href='#index-_005cn_005brsb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rsb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bct_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nct</code></strong><a class="copiable-link" href='#index-_005cn_005bct_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ct"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bssc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nssc</code></strong><a class="copiable-link" href='#index-_005cn_005bssc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ssc"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bskw_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nskw</code></strong><a class="copiable-link" href='#index-_005cn_005bskw_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-skw"></a>
+<a class="index-entry-id" id="index-width-escape-_0028_005cw_0029"></a>
+<p>Interpolate the width of <var class="var">anything</var> in basic units.  This escape
+sequence allows several properties of formatted output to be measured
+without writing it out.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">The length of the string 'abc' is \w'abc'u.
+    &rArr; The length of the string 'abc' is 72u.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-dummy-environment_002c-used-by-_005cw-escape-sequence"></a>
+<a class="index-entry-id" id="index-environment_002c-dummy_002c-used-by-_005cw-escape-sequence"></a>
+<p><var class="var">anything</var> is processed in a dummy environment: this means that
+font and type size changes, for example, may occur within it without
+affecting subsequent output.
+</p>
+<p>After each use, <code class="code">\w</code> sets several registers.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-5"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-sb-register"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-st-register"></a>
+<dl class="table">
+<dt><code class="code">st</code></dt>
+<dt><code class="code">sb</code></dt>
+<dd><p>The maximum vertical displacements of the text baseline above and below,
+respectively.  The sign convention is opposite that of relative vertical
+motions; that is, depth below the (original) baseline is negative.
+These registers are incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as &ldquo;the highest and lowest extent of the argument
+to <code class="code">\w</code> relative to the baseline&rdquo;.
+</p>
+</dd>
+<dt><code class="code">rst</code></dt>
+<dt><code class="code">rsb</code></dt>
+<dd><p>Like <code class="code">st</code> and <code class="code">sb</code>, but taking account of the heights and
+depths of glyphs.  In other words, these registers store the highest and
+lowest vertical positions attained by <var class="var">anything</var>, doing what
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> documented <code class="code">st</code> and <code class="code">sb</code> as doing.
+</p>
+</dd>
+<dt><code class="code">ct</code></dt>
+<dd><p>Characterizes the geometry of glyphs occurring in <var class="var">anything</var>.
+</p>
+<dl class="table">
+<dt>0</dt>
+<dd><p>only short glyphs, no descenders or tall glyphs
+</p>
+</dd>
+<dt>1</dt>
+<dd><p>at least one descender
+</p>
+</dd>
+<dt>2</dt>
+<dd><p>at least one tall glyph
+</p>
+</dd>
+<dt>3</dt>
+<dd><p>at least one each of a descender and a tall glyph
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">ssc</code></dt>
+<dd><p>The amount of horizontal space (possibly negative) that should be added
+to the last glyph before a subscript.
+</p>
+</dd>
+<dt><code class="code">skw</code></dt>
+<dd><p>How far to right of the center of the last glyph in the <code class="code">\w</code>
+argument, the center of an accent from a roman font should be placed
+over that glyph.
+</p></dd>
+</dl>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ckp"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k</code><span class="r"><i class="slanted">p</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ckp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ck"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005ck_0028ps"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k(</code><span class="r"><i class="slanted">ps</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ck_0028ps'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005ck_005bposition_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k</code><span class="r"><i class="slanted">position</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ck_005bposition_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-saving-horizontal-input-line-position-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-horizontal-input-line-position_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-input-line-position_002c-horizontal_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal-input-line_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-horizontal-position_002c-saving-_0028_005ck_0029"></a>
+<p>Store the current horizontal position in the <em class="emph">input</em> line in a
+register with the name <var class="var">position</var> (one-character name&nbsp;<var class="var">p</var>,
+two-character name <var class="var">ps</var>).  Use this, for example, to return to the
+beginning of a string for highlighting or other decoration.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bhp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nhp</code></strong><a class="copiable-link" href='#index-_005cn_005bhp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hp"></a>
+<a class="index-entry-id" id="index-horizontal-input-line-position-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-input-line_002c-horizontal-position_002c-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal_002c-in-input-line_002c-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-horizontal-position_002c-register-_0028hp_0029"></a>
+<p>The current horizontal position at the input line.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ek_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.k</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ek_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ek"></a>
+<a class="index-entry-id" id="index-horizontal-output-line-position-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-output-line_002c-horizontal-position_002c-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal_002c-in-output-line_002c-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-line_002c-output_002c-horizontal-position_002c-register-_0028_002ek_0029"></a>
+<p>A read-only register containing the current horizontal output position
+(relative to the current indentation).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005co_0027abc_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\o<code class="code">'</code></code><span class="r"><i class="slanted">abc&hellip;</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005co_0027abc_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005co"></a>
+<a class="index-entry-id" id="index-overstriking-glyphs-_0028_005co_0029"></a>
+<a class="index-entry-id" id="index-glyphs_002c-overstriking-_0028_005co_0029"></a>
+<p>Overstrike the glyphs of characters <var class="var">a</var>, <var class="var">b</var>, <var class="var">c</var>, &hellip;;
+the glyphs are centered, written, and the drawing position advanced by
+the widest of the glyphs.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005czc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\z</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005czc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cz"></a>
+<a class="index-entry-id" id="index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029"></a>
+<a class="index-entry-id" id="index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029"></a>
+<p>Format the character <var class="var">c</var> with zero width; that is, without advancing
+the drawing position.  Use <code class="code">\z</code> to overstrike glyphs aligned to
+their left edges, in contrast to <code class="code">\o</code>&rsquo;s centering.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cZ_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Z<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cZ_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cZ"></a>
+<a class="index-entry-id" id="index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029-1"></a>
+<a class="index-entry-id" id="index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029-1"></a>
+<p>Save the drawing position, format <var class="var">anything</var>, then restore it.  Tabs
+and leaders in the argument are ignored with an error diagnostic.
+</p>
+<p>We might implement a strike-through macro thus.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de ST
+.nr width \w'\\$1'
+\Z@\v'-.25m'\l'\\nwidthu'@\\$1
+..
+.
+This is
+.ST &quot;a test&quot;
+an actual emergency!
+</pre></div></div>
+</dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Drawing-Geometric-Objects">
+<div class="nav-panel">
+<p>
+Next: <a href="#Traps" accesskey="n" rel="next">Traps</a>, Previous: <a href="#Page-Motions" accesskey="p" rel="prev">Page Motions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Drawing-Geometric-Objects-1">5.26 Drawing Geometric Objects</h3>
+<a class="index-entry-id" id="index-drawing-requests"></a>
+<a class="index-entry-id" id="index-requests-for-drawing"></a>
+
+<p>A few of the formatter&rsquo;s escape sequences draw lines and other geometric
+objects.  Combined with each other and with page motion commands
+(see <a class="pxref" href="#Page-Motions">Page Motions</a>), a wide variety of figures is possible.  For
+complex drawings, these operations can be cumbersome; the preprocessors
+<code class="code">gpic</code> or <code class="code">ggrn</code> are typically used instead.
+</p>
+<p>The <code class="code">\l</code> and <code class="code">\L</code> escape sequences draw horizontal and
+vertical sequences of glyphs, respectively.  Even the simplest of
+output devices supports them.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cl_0027l_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\l<code class="code">'</code></code><span class="r"><i class="slanted">l</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cl_0027l_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cl"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cl_0027lc_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\l<code class="code">'</code></code><span class="r"><i class="slanted">lc</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cl_0027lc_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-horizontal-lines-_0028_005cl_0029"></a>
+<a class="index-entry-id" id="index-horizontal-line_002c-drawing-_0028_005cl_0029"></a>
+<a class="index-entry-id" id="index-line_002c-horizontal_002c-drawing-_0028_005cl_0029"></a>
+<p>Draw a horizontal line of length <var class="var">l</var> from the drawing position.
+Rightward motion is positive.  Afterward, the drawing position is at the
+right end of the line.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-baseline-rule-special-character_0028_005c_005bru_005d_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-underscore-_0028_005c_005bru_005d_0029"></a>
+<a class="index-entry-id" id="index-line-drawing-glyph"></a>
+<a class="index-entry-id" id="index-glyph_002c-for-line-drawing"></a>
+<p>The optional second parameter&nbsp;<var class="var">c</var> is a character with which to
+draw the line.  The default is the baseline rule special character,
+<code class="code">\ru</code>.
+</p>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence"></a>
+<p>If <var class="var">c</var> is a valid scaling unit, put <code class="code">\&amp;</code> after <var class="var">l</var> to
+disambiguate the input.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de textbox
+\br\\$*\br\l'|0\rn'\l'|0\ul'
+..
+</pre></div></div>
+
+<p>The foregoing outputs a box rule (a vertical line), the text
+argument(s), and another box rule.  We employ the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  Finally, the line-drawing escape sequences
+draw a radical extender (a form of overline) and an underline from the
+drawing position to the position coresponding to beginning of the
+<em class="emph">input</em> line.  The drawing position returns to just after the
+right-hand box rule because the lengths of the drawn lines are negative,
+as noted above.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cL_0027l_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\L<code class="code">'</code></code><span class="r"><i class="slanted">l</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cL_0027l_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cL"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cL_0027lc_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\L<code class="code">'</code></code><span class="r"><i class="slanted">lc</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cL_0027lc_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-vertical-lines-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-drawing-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-line_002c-vertical_002c-drawing-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-line-drawing-glyph-1"></a>
+<a class="index-entry-id" id="index-glyph-for-line-drawing"></a>
+<a class="index-entry-id" id="index-box-rule-glyph-_0028_005c_005bbr_005d_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-box-rule-_0028_005c_005bbr_005d_0029"></a>
+<p>Draw a vertical line of length <var class="var">l</var> from the drawing position.
+Downward motion is positive.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  The
+default character is the box rule, <code class="code">\br</code>.  As with vertical
+motion escape sequences, text processing continues where the line ends.
+<code class="code">\L</code> is otherwise similar to <code class="code">\l</code>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ nroff &lt;&lt;EOF
+This is a \L'3v'test.
+EOF
+    &rArr; This is a
+    &rArr;           |
+    &rArr;           |
+    &rArr;           |test.
+</pre></div></div>
+
+<p>When writing text, the drawing position is at the text baseline; recall
+<a class="ref" href="#Page-Geometry">Page Geometry</a>.
+</p></dd></dl>
+
+<p>The <code class="code">\D</code> escape sequence provides <em class="dfn">drawing commands</em> that
+direct the output device to render geometrical objects rather than
+glyphs.  Specific devices may support only a subset, or may feature
+additional ones; consult the man page for the output driver in use.
+Terminal devices in particular implement almost none.  See <a class="xref" href="#Graphics-Commands">Graphics Commands</a>.
+</p>
+<p>Rendering starts at the drawing position; when finished, the drawing
+position is left at the rightmost point of the object, even for closed
+figures, except where noted.  GNU <code class="code">troff</code> draws stroked (outlined)
+objects with the stroke color, and shades filled ones with the fill
+color.  See <a class="xref" href="#Colors">Colors</a>.  Coordinates <var class="var">h</var> and <var class="var">v</var> are horizontal
+and vertical motions relative to the drawing position or previous point
+in the command.  The default scaling unit for horizontal measurements
+(and diameters of circles) is &lsquo;<samp class="samp">m</samp>&rsquo;; for vertical ones, &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<p>Circles, ellipses, and polygons can be drawn filled or stroked.  These
+are independent properties; if you want a filled, stroked figure, you
+must draw the same figure twice using each drawing command.  A filled
+figure is always smaller than an outlined one because the former is
+drawn only within its defined area, whereas strokes have a line
+thickness (set with &lsquo;<samp class="samp">\D't'</samp>&rsquo;).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\h'1i'\v'1i'\
+\# increase line thickness
+\Z'\D't 5p''\
+\# draw stroked (unfilled) polygon
+\Z'\D'p 3 3 -6 0''\
+\# draw filled (solid) polygon
+\Z'\D'P 3 3 -6 0''
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cD_0027command-argument-_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\D<code class="code">'</code></code><span class="r"><i class="slanted">command argument &hellip;</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cD_0027command-argument-_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cD"></a>
+<p>Drawing command escape sequence parameters begin with an ordinary
+character, <var class="var">command</var>, selecting the type of object to be drawn,
+followed by <var class="var">argument</var>s whose meaning is determined by
+<var class="var">command</var>.
+</p>
+<dl class="table">
+<dt id='index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029'><span><code class="code">\D'~ <var class="var">h1</var> <var class="var">v1</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>'</code><a class="copiable-link" href='#index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-spline_002c-drawing-_0028_005cD_0027_007e-_2026_0027_0029"></a>
+<p>Draw a B-spline to each point in sequence, leaving the drawing position
+at (<var class="var">hn</var>, <var class="var">vn</var>).
+</p>
+</dd>
+<dt id='index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029'><span><code class="code">\D'a <var class="var">hc</var> <var class="var">vc</var> <var class="var">h</var> <var class="var">v</var>'</code><a class="copiable-link" href='#index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-an-arc-_0028_005cD_0027a-_2026_0027_0029"></a>
+<p>Draw a circular arc centered at (<var class="var">hc</var>, <var class="var">vc</var>) counterclockwise
+from the drawing position to a point (<var class="var">h</var>, <var class="var">v</var>) relative to the
+center.  <a class="footnote" id="DOCF105" href="#FOOT105"><sup>105</sup></a>
+</p>
+</dd>
+<dt id='index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029'><span><code class="code">\D'c <var class="var">d</var>'</code><a class="copiable-link" href='#index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-circle-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-circle_002c-outlined_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-circle-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<p>Draw a circle of diameter <var class="var">d</var> with its leftmost point at the drawing
+position.
+</p>
+</dd>
+<dt id='index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029'><span><code class="code">\D'C <var class="var">d</var>'</code><a class="copiable-link" href='#index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-circle-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-circle_002c-solid_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-circle-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'C <span class="r">&hellip;</span>'</samp>&rsquo;, but the circle is filled.
+</p>
+</dd>
+<dt id='index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029'><span><code class="code">\D'e <var class="var">h</var> <var class="var">v</var>'</code><a class="copiable-link" href='#index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-ellipse-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-ellipse_002c-outlined_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-ellipse-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<p>Draw an ellipse of width <var class="var">h</var> and height <var class="var">v</var> with its leftmost
+point at the drawing position.
+</p>
+</dd>
+<dt id='index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029'><span><code class="code">\D'E <var class="var">x</var> <var class="var">y</var>'</code><a class="copiable-link" href='#index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-ellipse-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-ellipse_002c-solid_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-ellipse-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'e <span class="r">&hellip;</span>'</samp>&rsquo;, but the ellipse is filled.
+</p>
+</dd>
+<dt id='index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029'><span><code class="code">\D'l <var class="var">dx</var> <var class="var">dy</var>'</code><a class="copiable-link" href='#index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-line-_0028_005cD_0027l-_2026_0027_0029"></a>
+<p>Draw line from the drawing position to (<var class="var">h</var>, <var class="var">v</var>).
+</p>
+<p>The following is a macro for drawing a box around a text argument; for
+simplicity, the box margin is a fixed at 0.2<span class="dmn">m</span>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de TEXTBOX
+.  nr @wd \w'\\$1'
+\h'.2m'\
+\h'-.2m'\v'(.2m - \\nrsbu)'\
+\D'l 0 -(\\nrstu - \\nrsbu + .4m)'\
+\D'l (\\n@wdu + .4m) 0'\
+\D'l 0 (\\nrstu - \\nrsbu + .4m)'\
+\D'l -(\\n@wdu + .4m) 0'\
+\h'.2m'\v'-(.2m - \\nrsbu)'\
+\\$1\
+\h'.2m'
+..
+</pre></div></div>
+
+<p>The argument is measured with the <code class="code">\w</code> escape sequence.  Its width
+is stored in register <code class="code">@wd</code>.  <code class="code">\w</code> also sets the registers
+<code class="code">rst</code> and <code class="code">rsb</code>; these contain its maximum vertical extents of
+the argument.  Then, four lines are drawn to form a box, offset by the
+box margin.
+</p>
+</dd>
+<dt id='index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029'><span><code class="code">\D'p <var class="var">h1</var> <var class="var">v1</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>'</code><a class="copiable-link" href='#index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-polygon-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-polygon_002c-outlined_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-polygon-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<p>Draw polygon with vertices at drawing position and each point in
+sequence.  GNU <code class="code">troff</code> closes the polygon by drawing a line from
+(<var class="var">hn</var>, <var class="var">vn</var>) back to the initial drawing position.
+Afterward, the drawing position is left at (<var class="var">hn</var>, <var class="var">vn</var>).
+</p>
+</dd>
+<dt id='index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029'><span><code class="code">\D'P <var class="var">dx1</var> <var class="var">dy1</var> <var class="var">dx2</var> <var class="var">dy2</var> &hellip;'</code><a class="copiable-link" href='#index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-polygon-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-polygon_002c-solid_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-polygon-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'P <span class="r">&hellip;</span>'</samp>&rsquo;, but the polygon is filled.
+</p>
+<p>The following macro is like the &lsquo;<samp class="samp">\D'l'</samp>&rsquo; example, but shades the
+box.  We draw the box before writing the text because colors in GNU
+<code class="code">troff</code> have no transparency; in othe opposite order, the filled
+polygon would occlude the text.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de TEXTBOX
+.  nr @wd \w'\\$1'
+\h'.2m'\
+\h'-.2m'\v'(.2m - \\nrsbu)'\
+\Mlightcyan\
+\D'P 0 -(\\nrstu - \\nrsbu + .4m) \
+     (\\n@wdu + .4m) 0 \
+     0 (\\nrstu - \\nrsbu + .4m) \
+     -(\\n@wdu + .4m) 0'\
+\h'.2m'\v'-(.2m - \\nrsbu)'\
+\M\
+\\$1\
+\h'.2m'
+..
+</pre></div></div>
+
+</dd>
+<dt id='index-line-thickness-_0028_005cD_0027t-_2026_0027_0029'><span><code class="code">\D't <var class="var">n</var>'</code><a class="copiable-link" href='#index-line-thickness-_0028_005cD_0027t-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-thickness-of-lines-_0028_005cD_0027t-_2026_0027_0029"></a>
+<p>Set the stroke thickness of geometric objects to <var class="var">n</var> basic units.  A
+zero <var class="var">n</var> selects the minimal supported thickness.  A negative
+<var class="var">n</var> selects a thickness proportional to the type size; this is the
+default.
+</p></dd>
+</dl>
+</dd></dl>
+
+<p>In a hazy penumbra between text rendering and drawing commands we locate
+the bracket-building escape sequence, <code class="code">\b</code>.  It can assemble
+apparently large glyphs by vertically stacking ordinary ones.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cb_0027contents_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\b<code class="code">'</code></code><span class="r"><i class="slanted">contents</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cb_0027contents_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cb"></a>
+<a class="index-entry-id" id="index-pile_002c-glyph-_0028_005cb_0029"></a>
+<a class="index-entry-id" id="index-glyph-pile-_0028_005cb_0029"></a>
+<a class="index-entry-id" id="index-stacking-glyphs-_0028_005cb_0029"></a>
+<p>Pile and center a sequence of glyphs vertically on the output line.
+<em class="dfn">Piling</em> stacks glyphs corresponding to each character in
+<var class="var">contents</var>, read from left to right, and placed from top to bottom.
+GNU <code class="code">troff</code> separates the glyphs vertically by 1<span class="dmn">m</span>, and the
+pile itself is centered 0.5<span class="dmn">m</span> above the text baseline.  The
+horizontal drawing position is then advanced by the width of the widest
+glyph in the pile.
+</p>
+<a class="index-entry-id" id="index-_005cb_002c-limitations-of"></a>
+<a class="index-entry-id" id="index-limitations-of-_005cb-escape-sequence"></a>
+<p>This rather inflexible positioning algorithm doesn&rsquo;t work with the
+<code class="code">dvi</code> output device since its bracket pieces vary in height.
+Instead, use the <code class="code">geqn</code> preprocessor.
+</p>
+<p><a class="ref" href="#Manipulating-Spacing">Manipulating Spacing</a> describes how to adjust the vertical spacing
+of the output line with the <code class="code">\x</code> escape sequence.
+</p>
+<p>The application of <code class="code">\b</code> that lends its name is construction of
+brackets, braces, and parentheses when typesetting mathematics.  We
+might construct a large opening (left) brace as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\b'\lt\bv\lk\bv\lb'
+</pre></div></div>
+
+<p>See <cite class="cite">groff_char<span class="r">(7)</span></cite> for a list of special character
+identifiers.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Deferring-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="#Traps" accesskey="n" rel="next">Traps</a>, Previous: <a href="#Drawing-Geometric-Objects" accesskey="p" rel="prev">Drawing Geometric Objects</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Deferring-Output-1">5.27 Deferring Output</h3>
+<a class="index-entry-id" id="index-deferred-output"></a>
+
+<a class="index-entry-id" id="index-environment"></a>
+<a class="index-entry-id" id="index-diversion"></a>
+<a class="index-entry-id" id="index-trap"></a>
+<p>A few <code class="code">roff</code> language elements are generally not used in simple
+documents, but arise as page layouts become more sophisticated and
+demanding.  <em class="dfn">Environments</em> collect formatting parameters like line
+length and typeface.  A <em class="dfn">diversion</em> stores formatted output for
+later use.  A <em class="dfn">trap</em> is a condition on the input or output, tested
+automatically by the formatter, that is associated with a macro, causing
+it to be called when that condition is fulfilled.
+</p>
+<p>Footnote support often exercises all three of the foregoing features.  A
+simple implementation might work as follows.  A pair of macros is
+defined: one starts a footnote and the other ends it.  The author calls
+the first macro where a footnote marker is desired.  The macro
+establishes a diversion so that the footnote text is collected at the
+place in the body text where its corresponding marker appears.  An
+environment is created for the footnote so that it is set at a smaller
+typeface.  The footnote text is formatted in the diversion using that
+environment, but it does not yet appear in the output.  The document
+author calls the footnote end macro, which returns to the previous
+environment and ends the diversion.  Later, after much more body text in
+the document, a trap, set a small distance above the page bottom, is
+sprung.  The macro called by the trap draws a line across the page and
+emits the stored diversion.  Thus, the footnote is rendered.
+</p>
+<p>Diversions and traps make the text formatting process non-linear.  Let
+us imagine a set of text lines or paragraphs labelled &lsquo;<samp class="samp">A</samp>&rsquo;,
+&lsquo;<samp class="samp">B</samp>&rsquo;, and so on.  If we set up a trap that produces text &lsquo;<samp class="samp">T</samp>&rsquo;
+(as a page footer, say), and we also use a diversion to store the
+formatted text &lsquo;<samp class="samp">D</samp>&rsquo;, then a document with input text in the order
+&lsquo;<samp class="samp">A B C D E F</samp>&rsquo; might render as &lsquo;<samp class="samp">A B C E T F</samp>&rsquo;.  The diversion
+&lsquo;<samp class="samp">D</samp>&rsquo; will never be output if we do not call for it.
+</p>
+<p>Environments of themselves are not a source of non-linearity in document
+formatting: environment switches have immediate effect.  One could
+always write a macro to change as many formatting parameters as desired
+with a single convenient call.  But because diversions can be nested and
+macros called by traps that are sprung by other trap-called macros, they
+may be called upon in varying contexts.  For example, consider a page
+header that is always to be set in Helvetica.  A document that uses
+Times for most of its body text, but Courier for displayed code
+examples, poses a challenge if a page break occurs in the middle of a
+code display; if the header trap assumes that the &ldquo;previous font&rdquo; is
+always Times, the rest of the example will be formatted in the wrong
+typeface.  One could carefully save all formatting parameters upon
+entering the trap and restore them upon leaving it, but this is verbose,
+error-prone, and not future-proof as the <code class="code">groff</code> language develops.
+Environments save us considerable effort.
+</p>
+
+<hr>
+</div>
+<div class="section-level-extent" id="Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Diversions" accesskey="n" rel="next">Diversions</a>, Previous: <a href="#Deferring-Output" accesskey="p" rel="prev">Deferring Output</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Traps-1">5.28 Traps</h3>
+<a class="index-entry-id" id="index-traps"></a>
+
+<p><em class="dfn">Traps</em> are locations in the output or conditions on the input that,
+when reached or fulfilled, call a specified macro.  These traps can
+occur at a given location on the page, at a given location in the
+current diversion (together, these are known as <i class="slanted">vertical
+position traps</i>), at a blank line, at a line with leading space
+characters, after a quantity of input lines, or at the end of input.
+Macros called by traps are passed no arguments.
+<a class="index-entry-id" id="index-planting-a-trap"></a>
+<a class="index-entry-id" id="index-trap_002c-planting"></a>
+Setting a trap is also called <em class="dfn">planting</em> one.
+<a class="index-entry-id" id="index-trap_002c-springing"></a>
+<a class="index-entry-id" id="index-springing-a-trap"></a>
+It is said that a trap is <em class="dfn">sprung</em> if its condition is fulfilled.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Vertical-Position-Traps" accesskey="1">Vertical Position Traps</a></li>
+<li><a href="#Input-Line-Traps" accesskey="2">Input Line Traps</a></li>
+<li><a href="#Blank-Line-Traps" accesskey="3">Blank Line Traps</a></li>
+<li><a href="#Leading-Space-Traps" accesskey="4">Leading Space Traps</a></li>
+<li><a href="#End_002dof_002dinput-Traps" accesskey="5">End-of-input Traps</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Vertical-Position-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Page-Location-Traps" accesskey="n" rel="next">Page Location Traps</a>, Previous: <a href="#Traps" accesskey="p" rel="prev">Traps</a>, Up: <a href="#Traps" accesskey="u" rel="up">Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Vertical-Position-Traps-1">5.28.1 Vertical Position Traps</h4>
+<a class="index-entry-id" id="index-vertical-position-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-vertical-position"></a>
+
+<p>A <em class="dfn">vertical position trap</em> calls a macro when the formatter&rsquo;s
+vertical drawing position reaches or passes, in the downward direction,
+a certain location on the output page or in a diversion.  Its
+applications include setting page headers and footers, body text in
+multiple columns, and footnotes.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002evpt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vpt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002evpt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vpt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002evpt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.vpt</code></strong><a class="copiable-link" href='#index-_005cn_005b_002evpt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002evpt-1"></a>
+<a class="index-entry-id" id="index-enabling-vertical-position-traps-_0028vpt_0029"></a>
+<a class="index-entry-id" id="index-vertical-position-traps_002c-enabling-_0028vpt_0029"></a>
+<a class="index-entry-id" id="index-vertical-position-trap-enable-register-_0028_002evpt_0029"></a>
+<p>Enable vertical position traps if <var class="var">flag</var> is non-zero or absent;
+disable them otherwise.  Vertical position traps are those set by the
+<code class="code">wh</code> request or by <code class="code">dt</code> within a diversion.  The parameter
+that controls whether vertical position traps are enabled is global.
+Initially, vertical position traps are enabled.  The current value is
+stored in the <code class="code">.vpt</code> read-only register.
+</p>
+<a class="index-entry-id" id="index-page-break_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-break_002c-page_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-page-ejection_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-ejection_002c-page_002c-prevented-by-vpt"></a>
+<p>A page can&rsquo;t be ejected if <code class="code">vpt</code> is set to zero; see <a class="ref" href="#The-Implicit-Page-Trap">The Implicit Page Trap</a>.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Page-Location-Traps" accesskey="1">Page Location Traps</a></li>
+<li><a href="#The-Implicit-Page-Trap" accesskey="2">The Implicit Page Trap</a></li>
+<li><a href="#Diversion-Traps" accesskey="3">Diversion Traps</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="Page-Location-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#The-Implicit-Page-Trap" accesskey="n" rel="next">The Implicit Page Trap</a>, Previous: <a href="#Vertical-Position-Traps" accesskey="p" rel="prev">Vertical Position Traps</a>, Up: <a href="#Vertical-Position-Traps" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Page-Location-Traps-1">5.28.1.1 Page Location Traps</h4>
+<a class="index-entry-id" id="index-page-location-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location"></a>
+
+<p>A <em class="dfn">page location trap</em> is a vertical position trap that applies to
+the page; that is, to undiverted output.  Many can be present; manage
+them with the <code class="code">wh</code> and <code class="code">ch</code> requests.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewh"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.wh</code></strong> <var class="def-var-arguments">dist <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002ewh'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-wh"></a>
+<p>Plant macro <var class="var">name</var> as page location trap at <var class="var">dist</var>.  The default
+scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  Non-negative values for <var class="var">dist</var> set the
+trap relative to the top of the page; negative values set the trap
+relative to the bottom of the page.  It is not possible to plant a trap
+less than one basic unit from the page bottom: a <var class="var">dist</var> of <code class="code">-0</code>
+is interpreted as <code class="code">0</code>, the top of the page.<a class="footnote" id="DOCF106" href="#FOOT106"><sup>106</sup></a>  An existing <em class="emph">visible</em> trap (see below) at
+<var class="var">dist</var> is removed; this is <code class="code">wh</code>&rsquo;s sole function if <var class="var">name</var>
+is missing.
+</p>
+<p>A trap is sprung only if it is <em class="dfn">visible</em>, meaning that its location
+is reachable on the page<a class="footnote" id="DOCF107" href="#FOOT107"><sup>107</sup></a> and it
+is not hidden by another trap at the same location already planted
+there.
+</p>
+<a class="index-entry-id" id="index-page-headers"></a>
+<a class="index-entry-id" id="index-page-footers"></a>
+<a class="index-entry-id" id="index-headers-1"></a>
+<a class="index-entry-id" id="index-footers-1"></a>
+<a class="index-entry-id" id="index-top-margin"></a>
+<a class="index-entry-id" id="index-margin_002c-top"></a>
+<a class="index-entry-id" id="index-bottom-margin"></a>
+<a class="index-entry-id" id="index-margin_002c-bottom"></a>
+<p>A macro package might set headers and footers as follows; this example
+configures vertical margins of one inch to the body text, and one
+half-inch to the titles.  Observe the use of the no-break control
+character with <code class="code">sp</code> request to position our text baselines,
+and the page number character &lsquo;<samp class="samp">%</samp>&rsquo; used with the <code class="code">tl</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; hdfo.roff
+.de hd                  \&quot; page header
+'  sp .5i
+'  tl '\\*(Ti''\\*(Da'  \&quot; title and date strings
+'  sp .5i
+..
+.de fo                  \&quot; page footer
+'  sp .5i
+.  tl ''%''
+.  bp
+..
+.wh 0   hd             \&quot; trap at top of the page
+.wh -1i fo             \&quot; trap 1 inch from bottom
+</pre></div></div>
+
+<p>To use these traps, copy the above (or load it from a file with the
+<code class="code">so</code> or <code class="code">mso</code> requests), then set up the strings it uses.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.so hdfo.roff
+.ds Ti Final Report\&quot;
+.ds Da 21 May 2023\&quot;
+.ti
+On 5 August of last year,
+this committee tasked me with the investigation of the
+CFIT (controlled flight into terrain) incident of
+.\&quot; <i class="i">...and so on...</i>
+</pre></div></div>
+
+<p>A trap above the top or at or below the bottom of the page can be made
+visible by either moving it into the page area or increasing the page
+length so that the trap is on the page.  Negative trap values always use
+the <em class="emph">current</em> page length; they are not converted to an absolute
+vertical position.
+<a class="index-entry-id" id="index-page-location-traps_002c-debugging"></a>
+<a class="index-entry-id" id="index-debugging-page-location-traps"></a>
+We can use the <code class="code">ptr</code> request to dump our page location traps to the
+standard error stream (see <a class="pxref" href="#Debugging">Debugging</a>).  Their positions are reported
+in basic units; an <code class="code">nroff</code> device example follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 5i
+.wh -1i xx
+.ptr
+    error&rarr; xx      -240
+.pl 100i
+.ptr
+    error&rarr; xx      -240
+</pre></div></div>
+
+<p>It is possible to have more than one trap at the same location (although
+only one at a time can be visible); to achieve this, the traps must be
+defined at different locations, then moved to the same place with the
+<code class="code">ch</code> request.  In the following example, the many empty lines
+caused by the <code class="code">bp</code> request are not shown in the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de a
+.  nop a
+..
+.de b
+.  nop b
+..
+.de c
+.  nop c
+..
+.
+.wh 1i a
+.wh 2i b
+.wh 3i c
+.bp
+    &rArr; a b c
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ch b 1i
+.ch c 1i
+.bp
+    &rArr; a
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ch a 0.5i
+.bp
+    &rArr; a b
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002et_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.t</code></strong><a class="copiable-link" href='#index-_005cn_005b_002et_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002et"></a>
+<a class="index-entry-id" id="index-distance-to-next-vertical-position-trap-register-_0028_002et_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-distance-to-next-vertical-position_002c-register-_0028_002et_0029"></a>
+<p>The read-only register <code class="code">.t</code> holds the distance to the next vertical
+position trap.  If there are no traps between the current position and
+the bottom of the page, it contains the distance to the page bottom.
+Within a diversion, in the absence of a diversion trap, this distance is
+the largest representable integer in basic units&mdash;effectively infinite.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ech"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ch</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">dist</i></span></var><a class="copiable-link" href='#index-_002ech'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ch"></a>
+<a class="index-entry-id" id="index-changing-trap-location-_0028ch_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-changing-location-_0028ch_0029"></a>
+<p>Change the location of a trap by moving macro <var class="var">name</var> to new location
+<var class="var">dist</var>, or by unplanting it altogether if <var class="var">dist</var> is absent.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  Parameters to <code class="code">ch</code> are specified
+in the opposite order from <code class="code">wh</code>.  If <var class="var">name</var> is the earliest
+planted macro of multiple traps at the same location, (re)moving it from
+that location exposes the macro next least recently planted at the same
+place.<a class="footnote" id="DOCF108" href="#FOOT108"><sup>108</sup></a>
+</p>
+<p>Changing a trap&rsquo;s location is useful for building up footnotes in a
+diversion to allow more space at the bottom of the page for them.
+</p>
+
+</dd></dl>
+
+<p>The same macro can be installed simultaneously at multiple locations;
+however, only the earliest-planted instance&mdash;that has not yet been
+deleted with <code class="code">wh</code>&mdash;will be moved by <code class="code">ch</code>.  The following
+example (using an <code class="code">nroff</code> device) illustrates this behavior.  Blank
+lines have been elided from the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de T
+Trap sprung at \\n(nlu.
+.br
+..
+.wh 1i T
+.wh 2i T
+foo
+.sp 11i
+.bp
+.ch T 4i
+bar
+.sp 11i
+.bp
+.ch T 5i
+baz
+.sp 11i
+.bp
+.wh 5i
+.ch T 6i
+qux
+.sp 11i
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; foo
+    &rArr; Trap sprung at 240u.
+    &rArr; Trap sprung at 480u.
+    &rArr; bar
+    &rArr; Trap sprung at 480u.
+    &rArr; Trap sprung at 960u.
+    &rArr; baz
+    &rArr; Trap sprung at 480u.
+    &rArr; Trap sprung at 1200u.
+    &rArr; qux
+    &rArr; Trap sprung at 1440u.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ene_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ne</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ene_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ene-1"></a>
+<p>The read-only register <code class="code">.ne</code> contains the amount of space that was
+needed in the last <code class="code">ne</code> request that caused a trap to be sprung;
+it is useful in conjunction with the <code class="code">.trunc</code> register.  See <a class="xref" href="#Page-Control">Page Control</a>.  Since the <code class="code">.ne</code> register is set only by traps, it
+doesn&rsquo;t make sense to interpolate it outside of macros called by traps.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002etrunc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.trunc</code></strong><a class="copiable-link" href='#index-_005cn_005b_002etrunc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002etrunc"></a>
+<a class="index-entry-id" id="index-ne-request_002c-and-the-_002etrunc-register"></a>
+<a class="index-entry-id" id="index-truncated-vertical-space-register-_0028_002etrunc_0029"></a>
+<p>A read-only register containing the amount of vertical space truncated
+from an <code class="code">sp</code> request by the most recently sprung vertical
+position trap, or, if the trap was sprung by an <code class="code">ne</code> request,
+minus the amount of vertical motion produced by the <code class="code">ne</code>
+request.  In other words, at the point a trap is sprung, it
+represents the difference of what the vertical position would have
+been but for the trap, and what the vertical position actually is.
+Since the <code class="code">.trunc</code> register is set only by traps, it doesn&rsquo;t make
+sense to interpolate it outside of macros called by traps.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002epe_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pe</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epe"></a>
+<a class="index-entry-id" id="index-bp-request_002c-and-traps-_0028_002epe_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-sprung-by-bp-request-_0028_002epe_0029"></a>
+<a class="index-entry-id" id="index-page-ejection-status-register-_0028_002epe_0029"></a>
+<p>This Boolean-valued, read-only register interpolates&nbsp;1 while a page
+is being ejected, and 0&nbsp;otherwise.
+</p>
+<p>In the following example, we plant the same trap at the top and the
+bottom of the page.  We also make the trap report its name and the
+vertical drawing position.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de T
+.tm \\$0: page \\n%, nl=\\nnl .pe=\\n.pe
+..
+.ll 46n
+.wh 0 T
+.wh -1v T
+Those who can make you believe absurdities can make you
+commit atrocities. \em Voltaire
+    error&rarr; T: page 1, nl=0 .pe=0
+    error&rarr; T: page 1, nl=2600 .pe=1
+    &rArr; Those who can make you believe absurdities can
+    &rArr; make you commit atrocities. -- Voltaire
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-diversions_002c-and-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-and-diversions"></a>
+<p>When designing macros, keep in mind that diversions and traps do
+normally interact.  For example, if a trap calls a header macro (while
+outputting a diversion) that tries to change the font on the current
+page, the effect is not visible before the diversion has completely been
+printed (except for input protected with <code class="code">\!</code> or <code class="code">\?</code>) since
+the data in the diversion is already formatted.  In most cases, this is
+not the expected behaviour.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="The-Implicit-Page-Trap">
+<div class="nav-panel">
+<p>
+Next: <a href="#Diversion-Traps" accesskey="n" rel="next">Diversion Traps</a>, Previous: <a href="#Page-Location-Traps" accesskey="p" rel="prev">Page Location Traps</a>, Up: <a href="#Vertical-Position-Traps" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="The-Implicit-Page-Trap-1">5.28.1.2 The Implicit Page Trap</h4>
+<a class="index-entry-id" id="index-implicit-trap"></a>
+<a class="index-entry-id" id="index-trap_002c-implicit"></a>
+
+<a class="index-entry-id" id="index-page-break-2"></a>
+<a class="index-entry-id" id="index-break_002c-page-2"></a>
+<a class="index-entry-id" id="index-page-ejection-2"></a>
+<a class="index-entry-id" id="index-ejection_002c-page-2"></a>
+<p>If, after starting GNU <code class="code">troff</code> without loading a macro package, you
+use the <code class="code">ptr</code> request to dump a list of the active traps to the
+standard error stream,<a class="footnote" id="DOCF109" href="#FOOT109"><sup>109</sup></a>  nothing is reported.
+Yet the <code class="code">.t</code> register will report a steadily decreasing value with
+every output line your document produces, and once the value of
+<code class="code">.t</code> gets to within <code class="code">.V</code> of zero, you will notice that
+something trap-like happens&mdash;the page is ejected, a new one begins, and
+the value of <code class="code">.t</code> becomes large once more.
+</p>
+<p>This <em class="dfn">implicit page trap</em> always exists in the top-level
+diversion;<a class="footnote" id="DOCF110" href="#FOOT110"><sup>110</sup></a> it works like a trap in some
+ways but not others.  Its purpose is to eject the current page and start
+the next one.  It has no name, so it cannot be moved or deleted with
+<code class="code">wh</code> or <code class="code">ch</code> requests.  You cannot hide it by placing another
+trap at its location, and can move it only by redefining the page length
+with <code class="code">pl</code>.  Its operation is suppressed when vertical page traps
+are disabled with GNU <code class="code">troff</code>&rsquo;s <code class="code">vpt</code> request.
+</p>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Diversion-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Input-Line-Traps" accesskey="n" rel="next">Input Line Traps</a>, Previous: <a href="#The-Implicit-Page-Trap" accesskey="p" rel="prev">The Implicit Page Trap</a>, Up: <a href="#Vertical-Position-Traps" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Diversion-Traps-1">5.28.1.3 Diversion Traps</h4>
+<a class="index-entry-id" id="index-diversion-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-diversion"></a>
+
+<p>A diversion is not formatted in the context of a page, so it lacks page
+location traps; instead it can have a <em class="dfn">diversion trap</em>.  There can
+exist at most one such vertical position trap per diversion.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">dist</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002edt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dt"></a>
+<a class="index-entry-id" id="index-_002et-register_002c-and-diversions"></a>
+<a class="index-entry-id" id="index-setting-diversion-trap-_0028dt_0029"></a>
+<a class="index-entry-id" id="index-diversion-trap_002c-setting-_0028dt_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-diversion_002c-setting-_0028dt_0029"></a>
+<p>Set a trap <em class="emph">within</em> a diversion at location <var class="var">dist</var>, which is
+interpreted relative to diversion rather than page boundaries.  If invoked with
+fewer than two arguments, any diversion trap in the current diversion is
+removed.  The register <code class="code">.t</code> works within diversions.  It is an
+error to invoke <code class="code">dt</code> in the top-level diversion.
+See <a class="xref" href="#Diversions">Diversions</a>.
+</p></dd></dl>
+
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="Input-Line-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Blank-Line-Traps" accesskey="n" rel="next">Blank Line Traps</a>, Previous: <a href="#Diversion-Traps" accesskey="p" rel="prev">Diversion Traps</a>, Up: <a href="#Traps" accesskey="u" rel="up">Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Input-Line-Traps-1">5.28.2 Input Line Traps</h4>
+<a class="index-entry-id" id="index-input-line-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-input-line"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eit"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.it</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eit'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-it"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eitc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.itc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eitc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-itc"></a>
+<a class="index-entry-id" id="index-setting-input-line-trap-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-input-line-trap_002c-setting-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-input-line_002c-setting-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-clearing-input-line-trap-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-input-line-trap_002c-clearing-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-input-line_002c-clearing-_0028it_002c-itc_0029"></a>
+<p>Set an input line trap, calling macro <var class="var">name</var> after processing the
+next <var class="var">n</var>&nbsp;productive input lines (recall <a class="ref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>).  Any existing input line trap in the
+environment is replaced.  Without arguments, <code class="code">it</code> and <code class="code">itc</code>
+clear any input line trap that has not yet sprung.
+</p>
+<p>Consider a macro &lsquo;<samp class="samp">.ST <var class="var">s n</var></samp>&rsquo; which sets the next
+<var class="var">n</var>&nbsp;input lines in the font style&nbsp;<var class="var">s</var>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de ST \&quot; Use style $1 for next $2 text lines.
+.  it \\$2 ES
+.  ft \\$1
+..
+.de ES \&quot; end ST
+.  ft R
+..
+.ST I 1
+oblique
+face
+.ST I 1
+oblique\c
+face
+    &rArr; <i class="i">oblique</i> face <i class="i">oblique</i>face &nbsp;<span class="r">(second &ldquo;face&rdquo; upright)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-input-line-traps-and-interrupted-lines-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-interrupted-lines-and-input-line-traps-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-input-line_002c-and-interrupted-lines-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-interrupted_002c-and-input-line-traps-_0028itc_0029"></a>
+<p>Unlike the <code class="code">ce</code> and <code class="code">rj</code> requests, <code class="code">it</code> counts lines
+interrupted with the <code class="code">\c</code> escape sequence separately (see <a class="pxref" href="#Line-Continuation">Line Continuation</a>); <code class="code">itc</code> does not.  To see the difference, let&rsquo;s
+change the previous example to use <code class="code">itc</code> instead.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><span class="r">&hellip;</span>
+.  itc \\$2 ES
+<span class="r">&hellip;</span>
+    &rArr; <i class="i">oblique</i> face <i class="i">obliqueface</i> &nbsp;<span class="r">(second &ldquo;face&rdquo; oblique)</span>
+</pre></div></div>
+
+<p>You can think of the <code class="code">ce</code> and <code class="code">rj</code> requests as implicitly
+creating an input line trap with <code class="code">itc</code> that schedules a break when
+the trap is sprung.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de BR
+.  br
+.  <i class="slanted">internal: disable centering-without-filling</i>
+..
+.
+.de ce
+.  if \\n.br .br
+.  itc \\$1 BR
+.  <i class="slanted">internal: enable centering-without-filling</i>
+..
+</pre></div></div>
+
+<p>Let us consider in more detail the sorts of input lines that are or are
+not &ldquo;productive&rdquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Trap
+TRAP SPRUNG
+..
+.de Mac
+.if r a \l'5n'
+..
+.it 2 Trap
+.
+foo
+.Mac
+bar
+baz
+.it 1 Trap
+.sp \&quot; moves, but does not write or draw
+qux
+.itc 1 Trap
+\h'5n'\c \&quot; moves, but does not write or draw
+jat
+</pre></div></div>
+
+<p>When &lsquo;<samp class="samp">Trap</samp>&rsquo; gets called depends on whether the &lsquo;<samp class="samp">a</samp>&rsquo; register is
+defined; the control line with the <code class="code">if</code> request may or may not
+produce written output.  We also see that the spacing request <code class="code">sp</code>,
+while certainly affecting the output, does not spring the input line
+trap.  Similarly, the horizontal motion escape sequence <code class="code">\h</code> also
+affected the output, but was not &ldquo;written&rdquo;.  Observe that we had to
+follow it with <code class="code">\c</code> and use <code class="code">itc</code> to prevent the newline at
+the end of the text line from causing a word break, which, like an
+ordinary space character, counts as written output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tascii input-trap-example.groff
+    &rArr; foo bar TRAP SPRUNG baz
+    &rArr;
+    &rArr; qux TRAP SPRUNG      jat TRAP SPRUNG
+$ groff -Tascii -ra1 input-trap-example.groff
+    &rArr; foo _____ TRAP SPRUNG bar baz
+    &rArr;
+    &rArr; qux TRAP SPRUNG      jat TRAP SPRUNG
+</pre></div></div>
+</dd></dl>
+
+<p>Input line traps are associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>); switching to another environment suspends the
+current input line trap, and going back resumes it, restoring the count
+of qualifying lines enumerated in that environment.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Blank-Line-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#Leading-Space-Traps" accesskey="n" rel="next">Leading Space Traps</a>, Previous: <a href="#Input-Line-Traps" accesskey="p" rel="prev">Input Line Traps</a>, Up: <a href="#Traps" accesskey="u" rel="up">Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Blank-Line-Traps-1">5.28.3 Blank Line Traps</h4>
+<a class="index-entry-id" id="index-blank-line-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-blank-line"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eblm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.blm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eblm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-blm"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029-2"></a>
+<p>Set a blank line trap, calling the macro <var class="var">name</var> when GNU
+<code class="code">troff</code> encounters a blank line in an input file, instead of the
+usual behavior (see <a class="pxref" href="#Breaking">Breaking</a>).  A line consisting only of spaces is
+also treated as blank and subject to this trap.  If no argument is
+supplied, the default blank line behavior is (re-)established.
+</p></dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Leading-Space-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="#End_002dof_002dinput-Traps" accesskey="n" rel="next">End-of-input Traps</a>, Previous: <a href="#Blank-Line-Traps" accesskey="p" rel="prev">Blank Line Traps</a>, Up: <a href="#Traps" accesskey="u" rel="up">Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Leading-Space-Traps-1">5.28.4 Leading Space Traps</h4>
+<a class="index-entry-id" id="index-leading-space-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-leading-space"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elsm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lsm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002elsm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lsm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blsn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlsn</code></strong><a class="copiable-link" href='#index-_005cn_005blsn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lsn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blss_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlss</code></strong><a class="copiable-link" href='#index-_005cn_005blss_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lss"></a>
+<a class="index-entry-id" id="index-leading-spaces-macro-_0028lsm_0029"></a>
+<p>Set a leading space trap, calling the macro <var class="var">name</var> when GNU
+<code class="code">troff</code> encounters leading spaces in an input line; the implicit
+line break that normally happens in this case is suppressed.  If no
+argument is supplied, the default leading space behavior is
+(re-)established (see <a class="pxref" href="#Breaking">Breaking</a>).
+</p>
+<p>The count of leading spaces on an input line is stored in register
+<code class="code">lsn</code>, and the amount of corresponding horizontal motion in
+register <code class="code">lss</code>, irrespective of whether a leading space trap is
+set.  When it is, the leading spaces are removed from the input line,
+and no motion is produced before calling <var class="var">name</var>.
+</p>
+</dd></dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="End_002dof_002dinput-Traps">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Leading-Space-Traps" accesskey="p" rel="prev">Leading Space Traps</a>, Up: <a href="#Traps" accesskey="u" rel="up">Traps</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="End_002dof_002dinput-Traps-1">5.28.5 End-of-input Traps</h4>
+<a class="index-entry-id" id="index-end_002dof_002dinput-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-end_002dof_002dinput"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.em</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-em"></a>
+<a class="index-entry-id" id="index-setting-end_002dof_002dinput-trap-_0028em_0029"></a>
+<a class="index-entry-id" id="index-end_002dof_002dinput-trap_002c-setting-_0028em_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-end_002dof_002dinput_002c-setting-_0028em_0029"></a>
+<a class="index-entry-id" id="index-end_002dof_002dinput-macro-_0028em_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-end_002dof_002dinput-_0028em_0029"></a>
+<p>Set a trap at the end of input, calling macro <var class="var">name</var> after the last
+line of the last input file has been processed.  If no argument is
+given, any existing end-of-input trap is removed.
+</p>
+<p>For example, if the document had to have a section at the bottom of the
+last page for someone to approve it, the <code class="code">em</code> request could be
+used.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de approval
+\c
+.  ne 3v
+.  sp (\\n.tu - 3v)
+.  in +4i
+.  lc _
+.  br
+Approved:\t\a
+.  sp
+Date:\t\t\a
+..
+.
+.em approval
+</pre></div></div>
+
+<p>The <code class="code">\c</code> in the above example needs explanation.  For historical
+reasons (compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>), the
+end-of-input macro exits as soon as it causes a page break if no
+partially collected line remains.<a class="footnote" id="DOCF111" href="#FOOT111"><sup>111</sup></a>
+</p>
+<a class="index-entry-id" id="index-page-break_002c-final"></a>
+<a class="index-entry-id" id="index-break_002c-page_002c-final"></a>
+<a class="index-entry-id" id="index-page-ejection_002c-of-final-page"></a>
+<a class="index-entry-id" id="index-ejection_002c-page_002c-of-final-page"></a>
+<p>Let us assume that there is no <code class="code">\c</code> in the above <code class="code">approval</code>
+macro, that the page is full, and last output line has been broken with,
+say, a <code class="code">br</code> request.  Because there is no more room, a <code class="code">ne</code>
+request at this point causes a page ejection, which in turn makes
+<code class="code">troff</code> exit immediately as just described.  In most situations,
+this is not desired; people generally want to format the input after
+<code class="code">ne</code>.
+</p>
+<p>To force processing of the whole end-of-input macro independently of
+this behavior, it is thus advisable to (invisibly) ensure the existence
+of a partially collected line (<code class="code">\c</code>) whenever there is a chance
+that a page break can happen.  In the above example, invoking the
+<code class="code">ne</code> request ensures that there is room for the subsequent
+formatted output on the same page, so we need insert <code class="code">\c</code> only
+once.
+</p>
+<p>The next example shows how to append three lines, then start a new page
+unconditionally.  Since &lsquo;<samp class="samp">.ne&nbsp;1</samp>&rsquo; doesn&rsquo;t give the desired
+effect&mdash;there is always one line available or we are already at the
+beginning of the next page&mdash;we temporarily increase the page length by
+one line so that we can use &lsquo;<samp class="samp">.ne&nbsp;2</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de EM
+.pl +1v
+\c
+.ne 2
+line one
+.br
+\c
+.ne 2
+line two
+.br
+\c
+.ne 2
+line three
+.br
+.pl -1v
+\c
+'bp
+..
+.em EM
+</pre></div></div>
+
+<p>This specific feature affects only the first potential page break caused
+by the end-of-input macro; further page breaks emitted by the macro are
+handled normally.
+</p>
+<p>Another possible use of the <code class="code">em</code> request is to make GNU
+<code class="code">troff</code> emit a single large page instead of multiple pages.  For
+example, one may want to produce a long plain text file for reading
+in a terminal or emulator without page footers and headers interrupting
+the body of the document.  One approach is to set the page length at the
+beginning of the document to a very large value to hold all the
+text,<a class="footnote" id="DOCF112" href="#FOOT112"><sup>112</sup></a> and
+automatically adjust it to the exact height of the document after the
+text has been output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de adjust-page-length
+.  br
+.  pl \\nnlu \&quot; \nnl: current vertical position
+..
+.
+.de single-page-mode
+.  pl 99999
+.  em adjust-page-length
+..
+.
+.\&quot; Activate the above code if configured.
+.if \ndo-continuous-rendering \
+.  single-page-mode
+</pre></div></div>
+
+<p>Since only one end-of-input trap exists and another macro package may
+already use it, care must be taken not to break the mechanism.  A simple
+solution would be to append the above macro to the macro package&rsquo;s
+end-of-input macro using the <code class="code">am</code> request.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Diversions">
+<div class="nav-panel">
+<p>
+Next: <a href="#Punning-Names" accesskey="n" rel="next">Punning Names</a>, Previous: <a href="#Traps" accesskey="p" rel="prev">Traps</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Diversions-1">5.29 Diversions</h3>
+<a class="index-entry-id" id="index-diversions"></a>
+
+<p>In <code class="code">roff</code> systems it is possible to format text as if for output,
+but instead of writing it immediately, one can <em class="dfn">divert</em> the
+formatted text into a named storage area.  It is retrieved later by
+specifying its name after a control character.   The same name space is
+used for such <i class="slanted">diversions</i> as for strings and macros; see
+<a class="ref" href="#Identifiers">Identifiers</a>.  Such text is sometimes said to be &ldquo;stored in a
+macro&rdquo;, but this coinage obscures the important distinction between
+macros and strings on one hand and diversions on the other; the former
+store <em class="emph">unformatted</em> input text, and the latter capture
+<em class="emph">formatted</em> output.  Diversions also do not interpret arguments.
+Applications of diversions include &ldquo;keeps&rdquo; (preventing a page break
+from occurring at an inconvenient place by forcing a set of output lines
+to be set as a group), footnotes, tables of contents, and indices.
+<a class="index-entry-id" id="index-top_002dlevel-diversion"></a>
+<a class="index-entry-id" id="index-diversion_002c-top_002dlevel"></a>
+For orthogonality it is said that GNU <code class="code">troff</code> is in the
+<em class="dfn">top-level diversion</em> if no diversion is active (that is, formatted
+output is being &ldquo;diverted&rdquo; immediately to the output device).
+</p>
+<p>Dereferencing an undefined diversion will create an empty one of that
+name and cause a warning in category &lsquo;<samp class="samp">mac</samp>&rsquo; to be emitted.
+See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and suppression of
+warnings.  A diversion does not exist for the purpose of testing with
+the <code class="code">d</code> conditional operator until its initial definition ends
+(see <a class="pxref" href="#Operators-in-Conditionals">Operators in Conditionals</a>).  The following requests are used to
+create and alter diversions.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edi"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.di</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002edi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-di"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eda"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.da</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eda'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-da"></a>
+<a class="index-entry-id" id="index-beginning-diversion-_0028di_002c-box_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-beginning-_0028di_002c-box_0029"></a>
+<a class="index-entry-id" id="index-ending-diversion-_0028di_002c-box_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-ending-_0028di_002c-box_0029"></a>
+<a class="index-entry-id" id="index-appending-to-a-diversion-_0028da_002c-boxa_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-appending-to-_0028da_002c-boxa_0029"></a>
+<p>Start collecting formatted output in a diversion called <var class="var">name</var>.  The
+<code class="code">da</code> request appends to a diversion called <var class="var">name</var>, creating it
+if necessary.  If <var class="var">name</var> already exists as an alias, the target of
+the alias is replaced or appended to; recall <a class="ref" href="#Strings">Strings</a>.  The pending
+output line is diverted as well.  Switching to another environment (with
+the <code class="code">ev</code> request) before invoking <code class="code">di</code> or <code class="code">da</code> avoids
+including any pending output line in the diversion; see
+<a class="ref" href="#Environments">Environments</a>.
+</p>
+<p>Invoking <code class="code">di</code> or <code class="code">da</code> without an argument stops diverting
+output to the diversion named by the most recent corresponding request.
+If <code class="code">di</code> or <code class="code">da</code> is called without an argument when there is no
+current diversion, a warning in category &lsquo;<samp class="samp">di</samp>&rsquo; is produced.
+See <a class="xref" href="#Warnings">Warnings</a>, for information about the enablement and suppression
+of warnings.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Before the diversion.
+.di yyy
+In the diversion.
+.br
+.di
+After the diversion.
+.br
+    &rArr; After the diversion.
+.yyy
+    &rArr; Before the diversion.  In the diversion.
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-box-_0028diversion-operation_0029"></a>
+<p>GNU <code class="code">troff</code> supports <em class="dfn">box</em> requests to exclude a partially
+collected line from a diversion, as this is often desirable.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebox"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.box</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002ebox'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-box"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eboxa"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.boxa</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eboxa'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-boxa"></a>
+<p>Divert (or append) output to <var class="var">name</var>, similarly to the <code class="code">di</code> and
+<code class="code">da</code> requests, respectively.  Any pending output line is <em class="emph">not</em>
+included in the diversion.  Without an argument, stop diverting output;
+any pending output line inside the diversion is discarded.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Before the box.
+.box xxx
+In the box.
+.br
+Hidden treasure.
+.box
+After the box.
+.br
+    &rArr; Before the box.  After the box.
+.xxx
+    &rArr; In the box.
+</pre></div></div>
+</dd></dl>
+
+<p>Apart from pending output line inclusion and the request names that
+populate them, boxes are handled exactly as diversions are.  All of the
+following <code class="code">groff</code> language elements can be used with them
+interchangeably.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ez_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.z</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ez_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ez"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ed_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.d</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ed_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ed"></a>
+<a class="index-entry-id" id="index-nl-register_002c-and-_002ed"></a>
+<a class="index-entry-id" id="index-nested-diversions"></a>
+<a class="index-entry-id" id="index-diversion_002c-nested"></a>
+<a class="index-entry-id" id="index-diversion-name-register-_0028_002ez_0029"></a>
+<a class="index-entry-id" id="index-vertical-position-in-diversion-register-_0028_002ed_0029"></a>
+<a class="index-entry-id" id="index-position_002c-vertical_002c-in-diversion_002c-register-_0028_002ed_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-vertical-position-in_002c-register-_0028_002ed_0029"></a>
+<p>Diversions may be nested.  The read-only string-valued register
+<code class="code">.z</code> contains the name of the current diversion.  The read-only
+register <code class="code">.d</code> contains the current vertical place in the diversion.
+If the input text is not being diverted, <code class="code">.d</code> reports the same
+location as the register <code class="code">nl</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eh_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.h</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eh_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eh"></a>
+<a class="index-entry-id" id="index-high_002dwater-mark-register-_0028_002eh_0029"></a>
+<a class="index-entry-id" id="index-mark_002c-high_002dwater_002c-register-_0028_002eh_0029"></a>
+<a class="index-entry-id" id="index-position-of-lowest-text-line-_0028_002eh_0029"></a>
+<a class="index-entry-id" id="index-text-line_002c-position-of-lowest-_0028_002eh_0029"></a>
+<p>The read-only register <code class="code">.h</code> stores the <em class="dfn">high-water mark</em> on the
+current page or in the current diversion.  It corresponds to the text
+baseline of the lowest line on the page.<a class="footnote" id="DOCF113" href="#FOOT113"><sup>113</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tm .h==\n.h, nl==\nnl
+    &rArr; .h==0, nl==-1
+This is a test.
+.br
+.sp 2
+.tm .h==\n.h, nl==\nnl
+    &rArr; .h==40, nl==120
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_002eh-register_002c-difference-from-nl"></a>
+<a class="index-entry-id" id="index-nl-register_002c-difference-from-_002eh"></a>
+<p>As implied by the example, vertical motion does not produce text
+baselines and thus does not increase the value interpolated by
+&lsquo;<samp class="samp">\n.h</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bdn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\ndn</code></strong><a class="copiable-link" href='#index-_005cn_005bdn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bdl_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\ndl</code></strong><a class="copiable-link" href='#index-_005cn_005bdl_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dl"></a>
+<a class="index-entry-id" id="index-dn-register_002c-and-da-_0028boxa_0029"></a>
+<a class="index-entry-id" id="index-dl-register_002c-and-da-_0028boxa_0029"></a>
+<a class="index-entry-id" id="index-da-request_002c-and-dn-_0028dl_0029"></a>
+<a class="index-entry-id" id="index-boxa-request_002c-and-dn-_0028dl_0029"></a>
+<p>After completing a diversion, the writable registers <code class="code">dn</code> and
+<code class="code">dl</code> contain its vertical and horizontal sizes.  Only the lines
+just processed are counted: for the computation of <code class="code">dn</code> and
+<code class="code">dl</code>, the requests <code class="code">da</code> and <code class="code">boxa</code> are handled as if
+<code class="code">di</code> and <code class="code">box</code> had been used, respectively&mdash;lines that have
+been already stored in the diversion (box) are not taken into account.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Center text both horizontally and vertically.
+.\&quot; Macro .(c starts centering mode; .)c terminates it.
+.
+.\&quot; Disable the escape character with .eo so that we
+.\&quot; don't have to double backslashes on the &quot;\n&quot;s.
+.eo
+.de (c
+.  br
+.  ev (c
+.  evc 0
+.  in 0
+.  nf
+.  di @c
+..
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de )c
+.  br
+.  ev
+.  di
+.  nr @s (((\n.tu - \ndnu) / 2u) - 1v)
+.  sp \n@su
+.  ce 1000
+.  @c
+.  ce 0
+.  sp \n@su
+.  br
+.  fi
+.  rr @s
+.  rm @c
+..
+.ec
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0021anything"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\!</code><span class="r"><i class="slanted">anything</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0021anything'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0021"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_003fanything_005c_003f"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\?</code><span class="r"><i class="slanted">anything</i></span><code class="t">\?</code></strong><a class="copiable-link" href='#index-_005c_003fanything_005c_003f'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_003f"></a>
+<a class="index-entry-id" id="index-transparent-output-_0028_005c_0021_002c-_005c_003f_0029"></a>
+<a class="index-entry-id" id="index-output_002c-transparent-_0028_005c_0021_002c-_005c_003f_0029"></a>
+<p><em class="dfn">Transparently</em> embed <var class="var">anything</var> into the current diversion,
+preventing requests, macro calls, and escape sequences from being
+interpreted when read into a diversion.  This is useful for preventing
+them from taking effect until the diverted text is actually output.  The
+<code class="code">\!</code> escape sequence transparently embeds input up to and including
+the end of the line.  The <code class="code">\?</code> escape sequence transparently embeds
+input until its own next occurrence.
+</p>
+<a class="index-entry-id" id="index-_005c_003f_002c-and-copy-mode-1"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005c_003f-1"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005c_003f-1"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005c_0021"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005c_0021"></a>
+<p><var class="var">anything</var> may not contain newlines; use <code class="code">\!</code> by itself to
+embed newlines in a diversion.  The escape sequence <code class="code">\?</code> is also
+recognized in copy mode and turned into a single internal code; it is
+this code that terminates <var class="var">anything</var>.  Thus the following example
+prints&nbsp;4.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 1
+.nf
+.di d
+\?\\?\\\\?\\\\\\\\nx\\\\?\\?\?
+.di
+.nr x 2
+.di e
+.d
+.di
+.nr x 3
+.di f
+.e
+.di
+.nr x 4
+.f
+</pre></div></div>
+
+<p>Both escape sequences read the data in copy mode.
+</p>
+<a class="index-entry-id" id="index-_005c_0021_002c-in-top_002dlevel-diversion"></a>
+<a class="index-entry-id" id="index-top_002dlevel-diversion_002c-and-_005c_0021"></a>
+<a class="index-entry-id" id="index-diversion_002c-top_002dlevel_002c-and-_005c_0021"></a>
+<p>If <code class="code">\!</code> is used in the top-level diversion, its argument is
+directly embedded into GNU <code class="code">troff</code>&rsquo;s intermediate output.  This can
+be used, for example, to control a postprocessor that processes the data
+before it is sent to an output driver.
+</p>
+<a class="index-entry-id" id="index-_005c_003f_002c-in-top_002dlevel-diversion"></a>
+<a class="index-entry-id" id="index-top_002dlevel-diversion_002c-and-_005c_003f"></a>
+<a class="index-entry-id" id="index-diversion_002c-top_002dlevel_002c-and-_005c_003f"></a>
+<p>The <code class="code">\?</code> escape used in the top-level diversion produces no output
+at all; its argument is simply ignored.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-_005c_0021_002c-and-output-request"></a>
+<a class="index-entry-id" id="index-output-request_002c-and-_005c_0021"></a>
+<a class="index-entry-id" id="index-output-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-output-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-output-request"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eoutput"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.output</code></strong> <var class="def-var-arguments">contents</var><a class="copiable-link" href='#index-_002eoutput'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-output"></a>
+<p>Emit <var class="var">contents</var> directly to GNU <code class="code">troff</code>&rsquo;s intermediate output
+(subject to copy mode interpretation); this is similar to <code class="code">\!</code> used
+at the top level.  An initial neutral double quote in <var class="var">contents</var> is
+stripped to allow embedding of leading spaces.
+</p>
+<p>This request can&rsquo;t be used before the first page has started&mdash;if you
+get an error, simply insert <code class="code">.br</code> before the <code class="code">output</code> request.
+</p>
+<p>Use with caution!  It is normally only needed for mark-up used by a
+postprocessor that does something with the output before sending it to
+the output device, filtering out <var class="var">contents</var> again.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002easciify"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.asciify</code></strong> <var class="def-var-arguments">div</var><a class="copiable-link" href='#index-_002easciify'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-asciify"></a>
+<a class="index-entry-id" id="index-unformatting-diversions-_0028asciify_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-unformatting-_0028asciify_0029"></a>
+<a class="index-entry-id" id="index-trin-request_002c-and-asciify"></a>
+<p><em class="dfn">Unformat</em> the diversion <var class="var">div</var> in a way such that Unicode basic
+Latin (<abbr class="acronym">ASCII</abbr>) characters, characters translated with the
+<code class="code">trin</code> request, space characters, and some escape sequences, that
+were formatted and diverted into <var class="var">div</var> are treated like ordinary
+input characters when <var class="var">div</var> is reread.  Doing so can be useful in
+conjunction with the <code class="code">writem</code> request.  <code class="code">asciify</code> can be also
+used for gross hacks; for example, the following sets
+register&nbsp;<code class="code">n</code> to&nbsp;1.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr @.
+.di x
+@nr n 1
+.br
+.di
+.tr @@
+.asciify x
+.x
+</pre></div></div>
+
+<p><code class="code">asciify</code> cannot return all items in a diversion to their source
+equivalent: nodes such as those produced by the <code class="code">\N</code> escape
+sequence will remain nodes, so the result cannot be guaranteed to be a
+pure string.  See <a class="xref" href="#Copy-Mode">Copy Mode</a>.  Glyph parameters such as the type face
+and size are not preserved; use <code class="code">unformat</code> to achieve that.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eunformat"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.unformat</code></strong> <var class="def-var-arguments">div</var><a class="copiable-link" href='#index-_002eunformat'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-unformat"></a>
+<p>Like <code class="code">asciify</code>, unformat the diversion <var class="var">div</var>.  However,
+<code class="code">unformat</code> handles only tabs and spaces between words, the latter
+usually arising from spaces or newlines in the input.  Tabs are treated
+as input tokens, and spaces become adjustable again.  The vertical sizes
+of lines are not preserved, but glyph information (font, type size,
+space width, and so on) is retained.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Punning-Names">
+<div class="nav-panel">
+<p>
+Next: <a href="#Environments" accesskey="n" rel="next">Environments</a>, Previous: <a href="#Diversions" accesskey="p" rel="prev">Diversions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Punning-Names-1">5.30 Punning Names</h3>
+<a class="index-entry-id" id="index-diversions-1"></a>
+
+<p>Macros, strings, and diversions share a name space; recall
+<a class="ref" href="#Identifiers">Identifiers</a>.  Internally, the same mechanism is used to store
+them.  You can thus call a macro with string interpolation syntax and
+vice versa.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de subject
+Typesetting
+..
+.de predicate
+rewards attention to detail
+..
+\*subject \*predicate.
+Truly.
+    &rArr; Typesetting
+    &rArr;  rewards attention to detail Truly.
+</pre></div></div>
+
+<p>What went wrong?  Strings don&rsquo;t contain newlines, but macros do.  String
+interpolation placed a newline at the end of &lsquo;<samp class="samp">\*subject</samp>&rsquo;, and the
+next thing on the input was a space.  Then when &lsquo;<samp class="samp">\*predicate</samp>&rsquo; was
+interpolated, it was followed by the empty request &lsquo;<samp class="samp">.</samp>&rsquo; on a line by
+itself.  If we want to use macros as strings, we must take interpolation
+behavior into account.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de subject
+Typesetting\\
+..
+.de predicate
+rewards attention to detail\\
+..
+\*subject \*predicate.
+Truly.
+    &rArr; Typesetting rewards attention to detail.  Truly.
+</pre></div></div>
+
+<p>By ending each text line of the macros with an escaped
+<code class="code">\<kbd class="key">RET</kbd></code>, we get the desired effect (see <a class="pxref" href="#Line-Continuation">Line Continuation</a>).<a class="footnote" id="DOCF114" href="#FOOT114"><sup>114</sup></a>
+What would have happened if we had used only one backslash at a time
+instead?
+</p>
+<p>Interpolating a string does not hide existing macro arguments.  We can
+also place the escaped newline outside the string interpolation instead
+of within the string definition.  Thus, in a macro, a more efficient way
+of doing
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.xx \\$@
+</pre></div></div>
+
+<p>is
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\\*xx\\
+</pre></div></div>
+
+<p>The latter calling syntax doesn&rsquo;t change the value of <code class="code">\$0</code>, which
+is then inherited from the calling macro (see <a class="pxref" href="#Parameters">Parameters</a>).
+</p>
+<p>Diversions can be also called with string syntax.  It is sometimes
+convenient to copy one-line diversions to a string.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xx
+the
+.ft I
+interpolation system
+.ft
+.br
+.di
+.ds yy This is a test of \*(xx\c
+\*(yy.
+    &rArr; This is a test of the <i class="i">interpolation system</i>.
+</pre></div></div>
+
+<p>As the previous example shows, it is possible to store formatted output
+in strings.  The <code class="code">\c</code> escape sequence prevents the subsequent
+newline from being interpreted as a break (again,
+see <a class="pxref" href="#Line-Continuation">Line Continuation</a>).
+</p>
+<p>Copying multi-output line diversions produces unexpected results.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xxx
+a funny
+.br
+test
+.br
+.di
+.ds yyy This is \*xxx\c
+\*yyy.
+    &rArr; test This is a funny.
+</pre></div></div>
+
+<p>Usually, it is not predictable whether a diversion contains one or more
+output lines, so this mechanism should be avoided.  With <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, this was the only solution to strip off a final newline
+from a diversion.  Another disadvantage is that the spaces in the copied
+string are already formatted, preventing their adjustment.  This can
+cause ugly results.
+</p>
+<a class="index-entry-id" id="index-stripping-final-newline-in-diversions"></a>
+<a class="index-entry-id" id="index-diversion_002c-stripping-final-newline"></a>
+<a class="index-entry-id" id="index-final-newline_002c-stripping-in-diversions"></a>
+<a class="index-entry-id" id="index-newline_002c-final_002c-stripping-in-diversions"></a>
+<a class="index-entry-id" id="index-horizontal-space_002c-unformatting"></a>
+<a class="index-entry-id" id="index-space_002c-horizontal_002c-unformatting"></a>
+<a class="index-entry-id" id="index-unformatting-horizontal-space"></a>
+<p>A clean solution to this problem is available in GNU <code class="code">troff</code>, using
+the requests <code class="code">chop</code> to remove the final newline of a diversion, and
+<code class="code">unformat</code> to make the horizontal spaces adjustable again.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.box xxx
+a funny
+.br
+test
+.br
+.box
+.chop xxx
+.unformat xxx
+This is \*xxx.
+    &rArr; This is a funny test.
+</pre></div></div>
+
+<p>See <a class="xref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>.
+</p>
+
+<hr>
+</div>
+<div class="section-level-extent" id="Environments">
+<div class="nav-panel">
+<p>
+Next: <a href="#Suppressing-Output" accesskey="n" rel="next">Suppressing Output</a>, Previous: <a href="#Diversions" accesskey="p" rel="prev">Diversions</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Environments-1">5.31 Environments</h3>
+<a class="index-entry-id" id="index-environments"></a>
+
+<p>As discussed in <a class="ref" href="#Deferring-Output">Deferring Output</a>, environments store most of the
+parameters that determine the appearance of text.  A default environment
+named &lsquo;<samp class="samp">0</samp>&rsquo; exists when GNU <code class="code">troff</code> starts up; it is modified by
+formatting-related requests and escape sequences.
+</p>
+<a class="index-entry-id" id="index-stack"></a>
+<p>You can create new environments and switch among them.  Only one is
+current at any given time.  Active environments are managed using a
+<em class="dfn">stack</em>, a data structure supporting &ldquo;push&rdquo; and &ldquo;pop&rdquo;
+operations.  The current environment is at the top of the stack.
+The same environment name can be pushed onto the stack multiple times,
+possibly interleaved with others.  Popping the environment stack does
+not destroy the current environment; it remains accessible by name and
+can be made current again by pushing it at any time.  Environments
+cannot be renamed or deleted, and can only be modified when current.  To
+inspect the environment stack, use the <code class="code">pev</code> request; see
+<a class="ref" href="#Debugging">Debugging</a>.
+</p>
+<p>Environments store the following information.
+</p>
+<ul class="itemize mark-bullet">
+<li>a partially collected line, if any
+
+</li><li>data about the most recently output glyph and line (registers
+<code class="code">.cdp</code>, <code class="code">.cht</code>, <code class="code">.csk</code>, <code class="code">.n</code>, <code class="code">.w</code>)
+
+</li><li>typeface parameters (size, family, style, height and slant, inter-word
+and inter-sentence space sizes)
+
+</li><li>page parameters (line length, title length, vertical spacing, line
+spacing, indentation, line numbering, centering, right-alignment,
+underlining, hyphenation parameters)
+
+</li><li>filling enablement; adjustment enablement and mode
+
+</li><li>tab stops; tab, leader, escape, control, no-break control, hyphenation,
+and margin characters
+
+</li><li>input line traps
+
+</li><li>stroke and fill colors
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eev"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ev</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">ident</i></span></var><a class="copiable-link" href='#index-_002eev'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ev"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eev_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ev</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eev_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eev-1"></a>
+<a class="index-entry-id" id="index-switching-environments-_0028ev_0029"></a>
+<a class="index-entry-id" id="index-environment_002c-switching-_0028ev_0029"></a>
+<a class="index-entry-id" id="index-environment-number_002fname-register-_0028_002eev_0029"></a>
+<p>Enter the environment <var class="var">ident</var>, which is created if it does not
+already exist, using the same parameters as for the default environment
+used at startup.  With no argument, GNU <code class="code">troff</code> switches to the
+previous environment.
+</p>
+<p>Invoking <code class="code">ev</code> with an argument puts environment <var class="var">ident</var> onto
+the top of the environment stack.  (If it isn&rsquo;t already present in the
+stack, this is a proper push.)  Without an argument, <code class="code">ev</code> pops the
+environment stack, making the previous environment current.  It is an
+error to pop the environment stack with no previous environment
+available.  The read-only string-valued register <code class="code">.ev</code> contains the
+name of the current environment&mdash;the one at the top of the stack.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ev footnote-env
+.fam N
+.ps 6
+.vs 8
+.ll -.5i
+.ev
+
+<span class="r">&hellip;</span>
+
+.ev footnote-env
+\dg Observe the smaller text and vertical spacing.
+.ev
+</pre></div></div>
+
+<p>We can familiarize ourselves with stack behavior by wrapping the
+<code class="code">ev</code> request with a macro that reports the contents of the
+<code class="code">.ev</code> register to the standard error stream.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de EV
+.  ev \\$1
+.  tm environment is now \\n.ev
+..
+.
+.EV foo
+.EV bar
+.EV
+.EV baz
+.EV
+.EV
+.EV
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">    error&rarr; environment is now foo
+    error&rarr; environment is now bar
+    error&rarr; environment is now foo
+    error&rarr; environment is now baz
+    error&rarr; environment is now foo
+    error&rarr; environment is now 0
+    error&rarr; error: environment stack underflow
+    error&rarr; environment is now 0
+</pre></div></div>
+
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eevc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.evc</code></strong> <var class="def-var-arguments">environment</var><a class="copiable-link" href='#index-_002eevc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-evc"></a>
+<a class="index-entry-id" id="index-copying-environment-_0028evc_0029"></a>
+<a class="index-entry-id" id="index-environment_002c-copying-_0028evc_0029"></a>
+<p>Copy the contents of <var class="var">environment</var> to the current environment.
+</p>
+<p>The following environment data are not copied.
+</p>
+<ul class="itemize mark-bullet">
+<li>a partially collected line, if present;
+
+</li><li>the interruption status of the previous input line (due to use of the
+<code class="code">\c</code> escape sequence);
+
+</li><li>the count of remaining lines to center, to right-justify, or to
+underline (with or without underlined spaces)&mdash;these are set to zero;
+
+</li><li>the activation status of temporary indentation;
+
+</li><li>input line traps and their associated data;
+
+</li><li>the activation status of line numbering (which can be reactivated with
+&lsquo;<samp class="samp">.nm&nbsp;+0</samp>&rsquo;); and
+
+</li><li>the count of consecutive hyphenated lines (set to zero).
+</li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ew_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.w</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ew_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ew"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002echt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cht</code></strong><a class="copiable-link" href='#index-_005cn_005b_002echt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002echt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecdp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cdp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecdp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecdp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecsk_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.csk</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecsk_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecsk"></a>
+<a class="index-entry-id" id="index-environment_002c-dimensions-of-last-glyph-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-width_002c-of-last-glyph-_0028_002ew_0029"></a>
+<a class="index-entry-id" id="index-height_002c-of-last-glyph-_0028_002echt_0029"></a>
+<a class="index-entry-id" id="index-depth_002c-of-last-glyph-_0028_002ecdp_0029"></a>
+<a class="index-entry-id" id="index-skew_002c-of-last-glyph-_0028_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-last-glyph_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-last_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<p>The <code class="code">\n.w</code> register contains the width of the last glyph
+formatted in the environment.
+</p>
+<p>The <code class="code">\n.cht</code> register contains the height of the last glyph
+formatted in the environment.
+</p>
+<p>The <code class="code">\n.cdp</code> register contains the depth of the last glyph
+formatted in the environment.  It is positive for glyphs extending below
+the baseline.
+</p>
+<p>The <code class="code">\n.csk</code> register contains the <em class="dfn">skew</em> (how far to the
+right of the glyph&rsquo;s center that GNU <code class="code">troff</code> should place an
+accent) of the last glyph formatted in the environment.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002en_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.n</code></strong><a class="copiable-link" href='#index-_005cn_005b_002en_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002en"></a>
+<a class="index-entry-id" id="index-environment_002c-previous-line-length-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-line-length_002c-previous-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-length-of-previous-line-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-previous-line-length-_0028_002en_0029"></a>
+<p>The <code class="code">\n.n</code> register contains the length of the previous output
+line emitted in the environment.
+</p></dd></dl>
+
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Suppressing-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="#Colors" accesskey="n" rel="next">Colors</a>, Previous: <a href="#Environments" accesskey="p" rel="prev">Environments</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Suppressing-Output-1">5.32 Suppressing Output</h3>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cO_005bnum_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\O</code><span class="r"><i class="slanted">num</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cO_005bnum_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cO"></a>
+<a class="index-entry-id" id="index-suppressing-output-_0028_005cO_0029"></a>
+<a class="index-entry-id" id="index-output_002c-suppressing-_0028_005cO_0029"></a>
+<p>Suppress GNU <code class="code">troff</code> output of glyphs and geometric objects.  The
+sequences <code class="code">\O2</code>, <code class="code">\O3</code>, <code class="code">\O4</code>, and <code class="code">\O5</code> are
+intended for internal use by <code class="code">grohtml</code>.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O0</samp>&rsquo;</dt>
+<dd><p>Disable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
+level (see <code class="code">\O3</code> and <code class="code">\04</code> below).  Horizontal motions
+corresponding to non-overstruck glyph widths still occur.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O1</samp>&rsquo;</dt>
+<dd><p>Enable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
+level.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-opminx"></a>
+<a class="index-entry-id" id="index-opminy"></a>
+<a class="index-entry-id" id="index-opmaxx"></a>
+<a class="index-entry-id" id="index-opmaxy"></a>
+<p><code class="code">\O0</code> and <code class="code">\O1</code> also reset the four registers <code class="code">opminx</code>,
+<code class="code">opminy</code>, <code class="code">opmaxx</code>, and <code class="code">opmaxy</code> to &minus;1.  These
+four registers mark the top left and bottom right hand corners of a box
+encompassing all written or drawn output.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O2</samp>&rsquo;</dt>
+<dd><p>At the outermost suppression level, enable emission of glyphs and
+geometric objects, and write to the standard error stream the page
+number and values of the four aforementioned registers encompassing
+glyphs written since the last interpolation of a <code class="code">\O</code> sequence, as
+well as the page offset, line length, image file name (if any),
+horizontal and vertical device motion quanta, and input file name.
+Numeric values are in basic units.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O3</samp>&rsquo;</dt>
+<dd><p>Begin a nested suppression level.  <code class="command">grohtml</code> uses this mechanism
+to create images of output preprocessed with <code class="command">gpic</code>,
+<code class="command">geqn</code>, and <code class="command">gtbl</code>.  At startup, GNU <code class="code">troff</code> is at
+the outermost suppression level.  <code class="command">pre-grohtml</code> generates these
+sequences when processing the document, using GNU <code class="command">troff</code> with
+the <code class="code">ps</code> output device, Ghostscript, and the PNM tools to produce
+images in PNG format.  They start a new page if the device is not
+<code class="code">html</code> or <code class="code">xhtml</code>, to reduce the number of images crossing a
+page boundary.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O4</samp>&rsquo;</dt>
+<dd><p>End a nested suppression level.
+</p></dd>
+</dl>
+
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O5<var class="var">P</var><var class="var">file</var></samp>&rsquo;</dt>
+<dd><p>At the outermost suppression level, write the name <code class="code">file</code> to the
+standard error stream at position <var class="var">P</var>, which must be one of
+<code class="code">l</code>, <code class="code">r</code>, <code class="code">c</code>, or&nbsp;<code class="code">i</code>, corresponding to left,
+right, centered, and inline alignments within the document,
+respectively.  <var class="var">file</var> is a name associated with the production of
+the next image.
+</p></dd>
+</dl>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eO_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.O</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eO_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eO"></a>
+<a class="index-entry-id" id="index-suppression-nesting-level-register"></a>
+<a class="index-entry-id" id="index-nesting-level_002c-suppression_002c-register"></a>
+<a class="index-entry-id" id="index-level_002c-suppression-nesting_002c-register"></a>
+<p>Output suppression nesting level applied by <code class="code">\O3</code> and <code class="code">\O4</code>
+escape sequences.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="I_002fO">
+<div class="nav-panel">
+<p>
+Next: <a href="#Postprocessor-Access" accesskey="n" rel="next">Postprocessor Access</a>, Previous: <a href="#Suppressing-Output" accesskey="p" rel="prev">Suppressing Output</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="I_002fO-1">5.33 I/O</h3>
+<a class="index-entry-id" id="index-i_002fo"></a>
+<a class="index-entry-id" id="index-input-and-output-requests"></a>
+<a class="index-entry-id" id="index-requests-for-input-and-output"></a>
+<a class="index-entry-id" id="index-output-and-input-requests"></a>
+
+<p><code class="code">gtroff</code> has several requests for including files:
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.so</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002eso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-so"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002esoquiet"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.soquiet</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002esoquiet'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-soquiet"></a>
+<a class="index-entry-id" id="index-including-a-file-_0028so_0029"></a>
+<a class="index-entry-id" id="index-file_002c-inclusion-_0028so_0029"></a>
+<p>Replace the <code class="code">so</code> request&rsquo;s control line with the contents of the
+file named by the argument, &ldquo;sourcing&rdquo; it.  <var class="var">file</var> is sought in
+the directories specified by <samp class="option">-I</samp> command-line option.  If
+<var class="var">file</var> does not exist, a warning in category &lsquo;<samp class="samp">file</samp>&rsquo; is produced
+and the request has no further effect.  See <a class="xref" href="#Warnings">Warnings</a>, for
+information about the enablement and suppression of warnings.
+</p>
+<p><code class="code">so</code> can be useful for large documents; e.g., allowing each chapter
+of a book to be kept in a separate file.  However, files interpolated
+with <code class="code">so</code> are not preprocessed; to overcome this limitation, see
+the <cite class="cite">gsoelim<span class="r">(1)</span></cite> man page.
+</p>
+<p>Since GNU <code class="code">troff</code> replaces the entire control line with the
+contents of a file, it matters whether <code class="code">file</code> is terminated with a
+newline or not.  Assume that file <samp class="file">xxx</samp> contains only the word
+&lsquo;<samp class="samp">foo</samp>&rsquo; without a trailing newline.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ printf 'foo' &gt; xxx
+
+The situation is
+.so xxx
+bar.
+    &rArr; The situation is foobar.
+</pre></div></div>
+
+<p><code class="code">soquiet</code> works the same way, except that no warning diagnostic is
+issued if <var class="var">file</var> does not exist.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pso</code></strong> <var class="def-var-arguments">command</var><a class="copiable-link" href='#index-_002epso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pso"></a>
+<p>Read the standard output from the specified <var class="var">command</var> and include
+it in place of the <code class="code">pso</code> request.
+</p>
+<a class="index-entry-id" id="index-safer-mode-3"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-3"></a>
+<a class="index-entry-id" id="index-unsafe-mode-3"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-3"></a>
+<p>It is an error to use this request in safer mode, which is the
+default.  Invoke GNU <code class="code">troff</code> or a front end with the <samp class="option">-U</samp>
+option to enable unsafe mode.
+</p>
+<p>The comment regarding a final newline for the <code class="code">so</code> request is valid
+for <code class="code">pso</code> also.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mso</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002emso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mso"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002emsoquiet"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.msoquiet</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002emsoquiet'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-msoquiet"></a>
+<p>Identical to the <code class="code">so</code> and <code class="code">soquiet</code> requests, respectively,
+except that <code class="code">gtroff</code> searches for the specified <var class="var">file</var> in the
+same directories as macro files for the <samp class="option">-m</samp> command-line option.
+If the file name to be included has the form <samp class="file"><var class="var">name</var>.tmac</samp> and
+it isn&rsquo;t found, these requests try to include <samp class="file">tmac.<var class="var">name</var></samp> and
+vice versa.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etrf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trf</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002etrf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ecf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cf</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002ecf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cf"></a>
+<a class="index-entry-id" id="index-transparent-output-_0028cf_002c-trf_0029"></a>
+<a class="index-entry-id" id="index-output_002c-transparent-_0028cf_002c-trf_0029"></a>
+<a class="index-entry-id" id="index-cf-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-cf-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-cf-request"></a>
+<a class="index-entry-id" id="index-trf-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-trf-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-trf-request"></a>
+<p>Transparently output the contents of <var class="var">file</var>.  Each line is output as
+if it were preceded by <code class="code">\!</code>; however, the lines are <em class="emph">not</em>
+subject to copy mode interpretation.  If the file does not end with a
+newline, <code class="code">trf</code> adds one.  Both requests cause a break.
+</p>
+<p>When used in a diversion, these requests embed a node (see <a class="pxref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>) in it that, when reread, causes the contents of <var class="var">file</var>
+to be transparently copied to the output.  In <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, the contents of <var class="var">file</var> are immediately copied to the
+output regardless of whether there is a current diversion; this
+behaviour is so anomalous that it must be considered a bug.
+</p>
+<a class="index-entry-id" id="index-trf-request_002c-and-invalid-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-invalid-for-trf-request"></a>
+<a class="index-entry-id" id="index-invalid-characters-for-trf-request"></a>
+<p>While <code class="code">cf</code> copies the contents of <var class="var">file</var> completely
+unprocessed, <code class="code">trf</code> disallows characters such as NUL that are not
+valid <code class="code">gtroff</code> input characters (see <a class="pxref" href="#Identifiers">Identifiers</a>).
+</p>
+<p>For <code class="code">cf</code>, within a diversion, &ldquo;completely unprocessed&rdquo; means that
+each line of a file to be inserted is handled as if it were preceded by
+<code class="code">\!\\!</code>.
+</p>
+<p>To define a macro&nbsp;<code class="code">x</code> containing the contents of
+file&nbsp;<samp class="file">f</samp>, use
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ev 1
+.di x
+.trf f
+.di
+.ev
+</pre></div></div>
+
+<p>The calls to <code class="code">ev</code> prevent the partially collected output line
+from becoming part of the diversion (see <a class="pxref" href="#Diversions">Diversions</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enx"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nx</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">file</i></span></var><a class="copiable-link" href='#index-_002enx'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nx"></a>
+<a class="index-entry-id" id="index-processing-next-file-_0028nx_0029"></a>
+<a class="index-entry-id" id="index-file_002c-processing-next-_0028nx_0029"></a>
+<a class="index-entry-id" id="index-next-file_002c-processing-_0028nx_0029"></a>
+<p>Force <code class="code">gtroff</code> to continue processing of the file specified as an
+argument.  If no argument is given, immediately jump to the end of file.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erd"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rd</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">prompt</i></span> <span class="r"><i class="slanted">arg1</i></span> <span class="r"><i class="slanted">arg2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002erd'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rd"></a>
+<a class="index-entry-id" id="index-reading-from-standard-input-_0028rd_0029"></a>
+<a class="index-entry-id" id="index-standard-input_002c-reading-from-_0028rd_0029"></a>
+<a class="index-entry-id" id="index-input_002c-standard_002c-reading-from-_0028rd_0029"></a>
+<p>Read from standard input, and include what is read as though it were
+part of the input file.  Text is read until a blank line is encountered.
+</p>
+<p>If standard input is a TTY input device (keyboard), write <var class="var">prompt</var>
+to standard error, followed by a colon (or send BEL for a beep if no
+argument is given).
+</p>
+<p>Arguments after <var class="var">prompt</var> are available for the input.  For example,
+the line
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.rd data foo bar
+</pre></div></div>
+
+<p>with the input &lsquo;<samp class="samp">This&nbsp;is&nbsp;\$2.</samp>&rsquo; prints
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This is bar.
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-form-letters"></a>
+<a class="index-entry-id" id="index-letters_002c-form"></a>
+<p>Using the <code class="code">nx</code> and <code class="code">rd</code> requests, it is easy to set up form
+letters.  The form letter template is constructed like this, putting the
+following lines into a file called <samp class="file">repeat.let</samp>:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ce
+\*(td
+.sp 2
+.nf
+.rd
+.sp
+.rd
+.fi
+Body of letter.
+.bp
+.nx repeat.let
+</pre></div></div>
+
+<a class="index-entry-id" id="index-ex-request_002c-used-with-nx-and-rd"></a>
+<p>When this is run, a file containing the following lines should be
+redirected in.  Requests included in this file are executed as though
+they were part of the form letter.  The last block of input is the
+<code class="code">ex</code> request, which tells GNU <code class="code">troff</code> to stop processing.  If
+this were not there, <code class="code">troff</code> would not know when to stop.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Trent A. Fisher
+708 NW 19th Av., #202
+Portland, OR  97209
+
+Dear Trent,
+
+Len Adollar
+4315 Sierra Vista
+San Diego, CA  92103
+
+Dear Mr. Adollar,
+
+.ex
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epi"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pi</code></strong> <var class="def-var-arguments">pipe</var><a class="copiable-link" href='#index-_002epi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pi"></a>
+<p>Pipe the output of <code class="code">gtroff</code> to the shell command(s) specified by
+<var class="var">pipe</var>.  This request must occur before <code class="code">gtroff</code> has a chance
+to print anything.
+</p>
+<a class="index-entry-id" id="index-safer-mode-4"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-4"></a>
+<a class="index-entry-id" id="index-unsafe-mode-4"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-4"></a>
+<p>It is an error to use this request in safer mode, which is the
+default.  Invoke GNU <code class="code">troff</code> or a front end with the <samp class="option">-U</samp>
+option to enable unsafe mode.
+</p>
+<p>Multiple calls to <code class="code">pi</code> are allowed, acting as a chain.  For
+example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pi foo
+.pi bar
+...
+</pre></div></div>
+
+<p>is the same as &lsquo;<samp class="samp">.pi&nbsp;foo&nbsp;|&nbsp;bar</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-groff_002c-and-pi-request"></a>
+<a class="index-entry-id" id="index-pi-request_002c-and-groff"></a>
+<p>The intermediate output format of GNU <code class="code">troff</code> is piped to the
+specified commands.  Consequently, calling <code class="code">groff</code> without the
+<samp class="option">-Z</samp> option normally causes a fatal error.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-system-commands_002c-running"></a>
+<a class="index-entry-id" id="index-running-system-commands"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esy"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sy</code></strong> <var class="def-var-arguments">cmds</var><a class="copiable-link" href='#index-_002esy'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sy"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bsystat_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nsystat</code></strong><a class="copiable-link" href='#index-_005cn_005bsystat_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-systat"></a>
+<p>Execute the shell command(s) specified by <var class="var">cmds</var>.  The output is not
+saved anywhere, so it is up to the user to do so.
+</p>
+<a class="index-entry-id" id="index-safer-mode-5"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-5"></a>
+<a class="index-entry-id" id="index-unsafe-mode-5"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-5"></a>
+<p>It is an error to use this request in safer mode; this is the default.
+Give GNU <code class="code">troff</code> or a front end program the <samp class="option">-U</samp> option to
+enable unsafe mode.
+</p>
+<p>The following code fragment introduces the current time into a document.
+</p>
+<a class="index-entry-id" id="index-perl"></a>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sy perl -e 'printf &quot;.nr H %d\\n.nr M %d\\n.nr S %d\\n&quot;,\
+             (localtime(time))2,1,0' &gt; /tmp/x\n$$
+.so /tmp/x\n$$
+.sy rm /tmp/x\n$$
+\nH:\nM:\nS
+</pre></div></div>
+
+<p>This works by having the Perl script (run by <code class="code">sy</code>) write
+<code class="code">nr</code> requests that set the registers <code class="code">H</code>, <code class="code">M</code>, and
+<code class="code">S</code> to a temporary file.  The <code class="code">roff</code> document then reads the
+temporary file using the <code class="code">so</code> request.
+</p>
+<a class="index-entry-id" id="index-time_002c-formatting"></a>
+<a class="index-entry-id" id="index-formatting-the-time"></a>
+<p>The registers <code class="code">seconds</code>, <code class="code">minutes</code>, and <code class="code">hours</code>,
+initialized at startup of GNU <code class="code">troff</code>, should satisfy most
+requirements.  Use the <code class="code">af</code> request to format their values for
+output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.af hours 00
+.af minutes 00
+.af seconds 00
+\nhours:\nminutes:\nseconds
+    &rArr; 02:17:54
+</pre></div></div>
+
+<a class="index-entry-id" id="index-system_0028_0029-return-value-register-_0028systat_0029"></a>
+<p>The writable register <code class="code">systat</code> contains the return value of the
+<code class="code">system()</code> function executed by the last <code class="code">sy</code> request.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eopen"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.open</code></strong> <var class="def-var-arguments">stream file</var><a class="copiable-link" href='#index-_002eopen'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-open"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eopena"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.opena</code></strong> <var class="def-var-arguments">stream file</var><a class="copiable-link" href='#index-_002eopena'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-opena"></a>
+<a class="index-entry-id" id="index-opening-file-_0028open_0029"></a>
+<a class="index-entry-id" id="index-file_002c-opening-_0028open_0029"></a>
+<a class="index-entry-id" id="index-appending-to-a-file-_0028opena_0029"></a>
+<a class="index-entry-id" id="index-file_002c-appending-to-_0028opena_0029"></a>
+<p>Open the specified <var class="var">file</var> for writing and associates the specified
+<var class="var">stream</var> with it.
+</p>
+<p>The <code class="code">opena</code> request is like <code class="code">open</code>, but if the file exists,
+append to it instead of truncating it.
+</p>
+<a class="index-entry-id" id="index-safer-mode-6"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-6"></a>
+<a class="index-entry-id" id="index-unsafe-mode-6"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-6"></a>
+<p>It is an error to use these requests in safer mode; this is the default.
+Give GNU <code class="code">troff</code> or a front end program the <samp class="option">-U</samp> option to
+enable unsafe mode.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewrite"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.write</code></strong> <var class="def-var-arguments">stream data</var><a class="copiable-link" href='#index-_002ewrite'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-write"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ewritec"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.writec</code></strong> <var class="def-var-arguments">stream data</var><a class="copiable-link" href='#index-_002ewritec'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-writec"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-write-request"></a>
+<a class="index-entry-id" id="index-write-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-write-request"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-writec-request"></a>
+<a class="index-entry-id" id="index-writec-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-writec-request"></a>
+<a class="index-entry-id" id="index-writing-to-file-_0028write_002c-writec_0029"></a>
+<a class="index-entry-id" id="index-file_002c-writing-to-_0028write_002c-writec_0029"></a>
+<p>Write to the file associated with the specified <var class="var">stream</var>.  The
+stream must previously have been the subject of an open request.  The
+remainder of the line is interpreted as the <code class="code">ds</code> request reads its
+second argument: an initial neutral double quote in <var class="var">contents</var> is
+stripped to allow embedding of leading spaces, and it is read in copy
+mode.
+</p>
+<p>The <code class="code">writec</code> request is like <code class="code">write</code>, but only <code class="code">write</code>
+appends a newline to the data.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewritem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.writem</code></strong> <var class="def-var-arguments">stream xx</var><a class="copiable-link" href='#index-_002ewritem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-writem"></a>
+<a class="index-entry-id" id="index-asciify-request_002c-and-writem"></a>
+<p>Write the contents of the macro or string <var class="var">xx</var> to the file
+associated with the specified <var class="var">stream</var>.
+</p>
+<a class="index-entry-id" id="index-writem-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-writem-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-writem-request"></a>
+<p><var class="var">xx</var> is read in copy mode, i.e., already formatted elements are
+ignored.  Consequently, diversions must be unformatted with the
+<code class="code">asciify</code> request before calling <code class="code">writem</code>.  Usually, this
+means a loss of information.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eclose"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.close</code></strong> <var class="def-var-arguments">stream</var><a class="copiable-link" href='#index-_002eclose'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-close"></a>
+<a class="index-entry-id" id="index-closing-file-_0028close_0029"></a>
+<a class="index-entry-id" id="index-file_002c-closing-_0028close_0029"></a>
+<p>Close the specified <var class="var">stream</var>; the stream is no longer an acceptable
+argument to the <code class="code">write</code> request.
+</p>
+<p>Here a simple macro to write an index entry.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.open idx test.idx
+.
+.de IX
+.  write idx \\n% \\$*
+..
+.
+.IX test entry
+.
+.close idx
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cVe"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V</code><span class="r"><i class="slanted">e</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cVe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cV"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cV_0028ev"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V(</code><span class="r"><i class="slanted">ev</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cV_0028ev'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cV_005benv_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V</code><span class="r"><i class="slanted">env</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cV_005benv_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cV_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005cV"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005cV"></a>
+<p>Interpolate the contents of the specified environment variable <var class="var">env</var>
+(one-character name&nbsp;<var class="var">e</var>, two-character name <var class="var">ev</var>) as
+returned by the function <cite class="cite">getenv<span class="r">(3)</span></cite>.  <code class="code">\V</code> is interpreted
+even in copy mode (see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Postprocessor-Access">
+<div class="nav-panel">
+<p>
+Next: <a href="#Miscellaneous" accesskey="n" rel="next">Miscellaneous</a>, Previous: <a href="#I_002fO" accesskey="p" rel="prev">I/O</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Postprocessor-Access-1">5.34 Postprocessor Access</h3>
+<a class="index-entry-id" id="index-postprocessor-access"></a>
+<a class="index-entry-id" id="index-access-to-postprocessor"></a>
+
+<p>Two escape sequences and two requests enable documents to pass
+information directly to a postprocessor.  These are useful for
+exercising device-specific capabilities that the <code class="code">groff</code> language
+does not abstract or generalize; examples include the embedding of
+hyperlinks and image files.  Device-specific functions are documented in
+each output driver&rsquo;s man page, such as <cite class="cite">gropdf<span class="r">(1)</span></cite>,
+<cite class="cite">grops<span class="r">(1)</span></cite>, or <cite class="cite">grotty<span class="r">(1)</span></cite>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edevice"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.device</code></strong> <var class="def-var-arguments">xxx <span class="r">&hellip;</span></var><a class="copiable-link" href='#index-_002edevice'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-device"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cX_0027xxx-_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\X<code class="code">'</code></code><span class="r"><i class="slanted">xxx <span class="r">&hellip;</span></i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cX_0027xxx-_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cX"></a>
+<p>Embed all <var class="var">xxx</var> arguments into GNU <code class="code">troff</code> output as parameters
+to a device control command &lsquo;<samp class="samp">x&nbsp;X</samp>&rsquo;.  The meaning and
+interpretation of such parameters is determined by the output driver or
+other postprocessor.
+</p>
+<a class="index-entry-id" id="index-device-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-device-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-device-request"></a>
+<p>The <code class="code">device</code> request processes its arguments in copy mode
+(see <a class="pxref" href="#Copy-Mode">Copy Mode</a>).  An initial neutral double quote in <var class="var">contents</var>
+is stripped to allow embedding of leading spaces.
+<a class="index-entry-id" id="index-_005c_0026_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_0029_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-in-_005cX"></a>
+By contrast, within <code class="code">\X</code> arguments, the escape sequences <code class="code">\&amp;</code>,
+<code class="code">\)</code>, <code class="code">\%</code>, and <code class="code">\:</code> are ignored; <code class="code">\<kbd class="key">SP</kbd></code> and
+<code class="code">\~</code> are converted to single space characters; and <code class="code">\\</code> has
+its escape character stripped.  So that the basic Latin subset of the
+Unicode character set<a class="footnote" id="DOCF115" href="#FOOT115"><sup>115</sup></a> can be reliably encoded in device control
+commands, seven special character escape sequences (&lsquo;<samp class="samp">\-</samp>&rsquo;,
+&lsquo;<samp class="samp">\aq</samp>&rsquo;, &lsquo;<samp class="samp">\dq</samp>&rsquo;, &lsquo;<samp class="samp">\ga</samp>&rsquo;, &lsquo;<samp class="samp">\ha</samp>&rsquo;, &lsquo;<samp class="samp">\rs</samp>&rsquo;,
+and &lsquo;<samp class="samp">\ti</samp>&rsquo;,) are mapped to basic Latin characters; see the
+<cite class="cite">groff_char<span class="r">(7)</span></cite> man page.  For this transformation, character
+translations and special character definitions are
+ignored.<a class="footnote" id="DOCF116" href="#FOOT116"><sup>116</sup></a> The use of any
+other escape sequence in <code class="code">\X</code> parameters is normally an error.
+</p>
+<a class="index-entry-id" id="index-use_005fcharnames_005fin_005fspecial"></a>
+<a class="index-entry-id" id="index-DESC-file_002c-and-use_005fcharnames_005fin_005fspecial-keyword"></a>
+<a class="index-entry-id" id="index-_005cX_002c-and-special-characters"></a>
+<p>If the <code class="code">use_charnames_in_special</code> directive appears in the output
+device&rsquo;s <samp class="file">DESC</samp> file, the use of special character escape sequences
+is <em class="emph">not</em> an error; they are simply output verbatim (with the
+exception of the seven mapped to Unicode basic Latin characters,
+discussed above).  <code class="code">use_charnames_in_special</code> is currently employed
+only by <code class="code">grohtml</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edevicem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.devicem</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002edevicem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-devicem"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cYn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cYn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cY"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cY_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cY_0028nm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cY_005bname_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y</code><span class="r"><i class="slanted">name</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cY_005bname_005d'> &para;</a></span></dt>
+<dd><p>This is approximately equivalent to &lsquo;<samp class="samp">\X'\*<var class="var">name</var>'</samp>&rsquo;
+(one-character name&nbsp;<var class="var">n</var>, two-character name <var class="var">nm</var>).
+However, the contents of the string or macro <var class="var">name</var> are not
+interpreted; also it is permitted for <var class="var">name</var> to have been defined as
+a macro and thus contain newlines (it is not permitted for the argument
+to <code class="code">\X</code> to contain newlines).  The inclusion of newlines requires
+an extension to the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output format, and
+confuses drivers that do not know about this extension (see <a class="pxref" href="#Device-Control-Commands">Device Control Commands</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etag"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tag</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002etag'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tag"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etaga"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.taga</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002etaga'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-taga"></a>
+<p>Reserved for internal use.
+</p></dd></dl>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Miscellaneous">
+<div class="nav-panel">
+<p>
+Next: <a href="#Gtroff-Internals" accesskey="n" rel="next"><code class="code">gtroff</code> Internals</a>, Previous: <a href="#Postprocessor-Access" accesskey="p" rel="prev">Postprocessor Access</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Miscellaneous-1">5.35 Miscellaneous</h3>
+
+<p>We document here GNU <code class="code">troff</code> features that fit poorly elsewhere.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">start</i></span> <span class="r"><i class="slanted">increment</i></span> <span class="r"><i class="slanted">space</i></span> <span class="r"><i class="slanted">indentation</i></span></var><a class="copiable-link" href='#index-_002enm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bln_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nln</code></strong><a class="copiable-link" href='#index-_005cn_005bln_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ln"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002enm_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.nm</code></strong><a class="copiable-link" href='#index-_005cn_005b_002enm_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002enm-1"></a>
+<a class="index-entry-id" id="index-printing-line-numbers-_0028nm_0029"></a>
+<a class="index-entry-id" id="index-line-numbers_002c-printing-_0028nm_0029"></a>
+<a class="index-entry-id" id="index-numbers_002c-line_002c-printing-_0028nm_0029"></a>
+<p>Begin (or, with no arguments, cease) numbering output lines.
+<var class="var">start</var> assigns the number of the <em class="emph">next</em> output line.  Only
+line numbers divisible by <var class="var">increment</var> are marked (default:
+&lsquo;<samp class="samp">1</samp>&rsquo;).  <var class="var">space</var> configures the horizontal spacing between the
+number and the text (default: &lsquo;<samp class="samp">1</samp>&rsquo;).  Any given <var class="var">indentation</var> is
+applied to the numbers (default: &lsquo;<samp class="samp">0</samp>&rsquo;).  The third and fourth
+arguments are reckoned in numeral widths (<code class="code">\0</code>).  <var class="var">start</var> must
+be non-negative and <var class="var">increment</var> positive.
+</p>
+<p>The formatter aligns the number to the right in a width of three numeral
+spaces plus <var class="var">indentation</var>, then catenates <var class="var">space</var> and the output
+line.  The line length is <em class="emph">not</em> reduced.  Depending on the value of
+the page offset,<a class="footnote" id="DOCF117" href="#FOOT117"><sup>117</sup></a> numbers wider than
+the allocated space protrude into the left margin, or shift the output
+line to the right.
+</p>
+<p>Line numbering parameters corresponding to missing arguments are not
+altered.  After numbering is disabled, &lsquo;<samp class="samp">.nm +0</samp>&rsquo; resumes it using
+the previously active parameters.
+</p>
+<p>The parameters of <code class="code">nm</code> are associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-output-line-number-register-_0028ln_0029"></a>
+<a class="index-entry-id" id="index-line-number_002c-output_002c-register-_0028ln_0029"></a>
+<p>While numbering is enabled, the output line number register <code class="code">ln</code> is
+updated as each line is output, even if no line number is formatted with
+it because it is being skipped (it is not a multiple of <var class="var">increment</var>)
+or because numbering is suppressed (see the <code class="code">nn</code> request below).
+</p>
+<p>The <code class="code">.nm</code> register tracks the enablement status of numbering.
+Temporary suspension of numbering with the <code class="code">nn</code> request does
+<em class="emph">not</em> alter its value.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.po 5n
+.ll 44n
+Programming,
+when stripped of all its circumstantial irrelevancies,
+.nm 999 1 1 -4
+boils down to no more and no less than
+.nm +0 3
+very effective thinking so as to avoid unmastered
+.nn 2
+complexity,
+to very vigorous separation of your many
+different concerns.
+.br
+\(em Edsger Dijkstra
+.sp
+.nm 1 1 1
+This guy's arrogance takes your breath away.
+.br
+\(em John Backus
+    &rArr;      Programming,  when  stripped of all its cir-
+    &rArr;  999 cumstantial irrelevancies, boils down to  no
+    &rArr;      more  and no less than very effective think-
+    &rArr;      ing so as to avoid unmastered complexity, to
+    &rArr;      very vigorous separation of your  many  dif-
+    &rArr;      ferent concerns.
+    &rArr; 1002 -- Edsger Dijkstra
+    &rArr;
+    &rArr;    1 This guy&rsquo;s arrogance takes your breath away.
+    &rArr;    2 -- John Backus
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">skip</i></span></var><a class="copiable-link" href='#index-_002enn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002enn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.nn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002enn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002enn-1"></a>
+<p>Suppress numbering of the next <var class="var">skip</var> output lines that would
+otherwise be numbered.  The default is&nbsp;1.  <code class="code">nn</code> can be invoked
+when line numbering is not active; suppression of numbering will take
+effect for <var class="var">skip</var> lines once <code class="code">nm</code> enables it.
+</p>
+<p>The <code class="code">.nn</code> register stores the count of output lines still to have
+their numbering suppressed.
+</p>
+<p>This count is associated with the environment (see <a class="pxref" href="#Environments">Environments</a>).
+</p></dd></dl>
+
+<p>To test whether the current output line will be numbered, you must check
+both the <code class="code">.nm</code> and <code class="code">.nn</code> registers.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  .de is-numbered
+  .  nop This line
+  .  ie (\\n.nm &amp; (1-\\n.nn)) IS
+  .  el                           ISN'T
+  .  nop numbered.
+  .  br
+  ..
+  Test line numbering.
+  .is-numbered
+  .nm 1
+  .nn 1
+  .is-numbered
+  .is-numbered
+  .nm
+  .is-numbered
+    &rArr; Test line numbering.  This line ISN&rsquo;T numbered.
+    &rArr; This line ISN&rsquo;T numbered.
+    &rArr;   1 This line IS numbered.
+    &rArr; This line ISN&rsquo;T numbered.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">margin-character</i></span> <span class="r"><i class="slanted">distance</i></span></var><a class="copiable-link" href='#index-_002emc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mc"></a>
+<a class="index-entry-id" id="index-margin-glyph-_0028mc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-for-margins-_0028mc_0029"></a>
+<p>Begin (or, with no arguments, cease) writing a <em class="dfn">margin-character</em> to
+the right of each output line.  The <var class="var">distance</var> argument separates
+<var class="var">margin-character</var> from the right margin.  If absent, the most
+recent value is used; the default is 10&nbsp;points.  If an output line
+exceeds the line length, the margin character is appended to it.
+<a class="index-entry-id" id="index-tl-request_002c-and-mc"></a>
+No margin character is written on lines produced by the <code class="code">tl</code>
+request.
+</p>
+<p>The margin character is a property of the output line; the margin
+character last configured when the line is output controls.  If the
+margin character is disabled before an output line breaks, none is
+output (but see below).
+</p>
+<p>The margin character is associated with the environment
+(see <a class="pxref" href="#Environments">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 5i
+.nf
+.mc \br
+This paragraph is marked with a margin character.
+.sp
+As seen above, vertical space isn't thus marked.
+\&amp;
+An output line that is present, but empty, is.
+    &rArr; This paragraph is marked with a margin character.  |
+    &rArr;
+    &rArr; As seen above, vertical space isn&rsquo;t thus marked.   |
+    &rArr;                                                    |
+    &rArr; An output line that is present, but empty, is.     |
+</pre></div></div>
+</dd></dl>
+
+<p>For compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, a call to <code class="code">mc</code>
+to set the margin character can&rsquo;t be undone immediately; at least one
+line gets a margin character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 10n
+.nf
+.mc |
+.mc *
+.mc
+foo
+bar
+    &rArr; foo        *
+    &rArr; bar
+</pre></div></div>
+
+<a class="index-entry-id" id="index-gdiffmk"></a>
+<a class="index-entry-id" id="index-nrchbar"></a>
+<a class="index-entry-id" id="index-changebar"></a>
+<a class="index-entry-id" id="index-diffmk"></a>
+<p>The margin character mechanism is commonly used to annotate changes in
+documents.  The <code class="code">groff</code> distribution ships a program,
+<code class="command">gdiffmk</code>, to assist with this task.<a class="footnote" id="DOCF118" href="#FOOT118"><sup>118</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epsbb"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.psbb</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002epsbb'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-psbb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bllx_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nllx</code></strong><a class="copiable-link" href='#index-_005cn_005bllx_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-llx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blly_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlly</code></strong><a class="copiable-link" href='#index-_005cn_005blly_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lly"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005burx_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nurx</code></strong><a class="copiable-link" href='#index-_005cn_005burx_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-urx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bury_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nury</code></strong><a class="copiable-link" href='#index-_005cn_005bury_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ury"></a>
+<a class="index-entry-id" id="index-PostScript_002c-bounding-box"></a>
+<a class="index-entry-id" id="index-bounding-box"></a>
+<p>Retrieve the bounding box of the PostScript image found in <var class="var">file</var>,
+which must conform to Adobe&rsquo;s <em class="dfn">Document Structuring Conventions</em>
+(DSC), locate a <code class="code">%%BoundingBox</code> comment, and store the (upper-,
+lower-, <span class="w-nolinebreak-text">-left</span>, <span class="w-nolinebreak-text">-right</span>) values into the registers <code class="code">llx</code>,
+<code class="code">lly</code>, <code class="code">urx</code>, and <code class="code">ury</code>.  If an error occurs (for
+example, if no <code class="code">%%BoundingBox</code> comment is present), the formatter
+sets these registers to&nbsp;0.
+</p>
+<p>The search path for <var class="var">file</var> can be controlled with the <samp class="option">-I</samp>
+command-line option.
+</p></dd></dl>
+
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Gtroff-Internals">
+<div class="nav-panel">
+<p>
+Next: <a href="#Debugging" accesskey="n" rel="next">Debugging</a>, Previous: <a href="#Miscellaneous" accesskey="p" rel="prev">Miscellaneous</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="gtroff-Internals">5.36 <code class="code">gtroff</code> Internals</h3>
+
+<a class="index-entry-id" id="index-input-token"></a>
+<a class="index-entry-id" id="index-token_002c-input"></a>
+<a class="index-entry-id" id="index-output-node"></a>
+<a class="index-entry-id" id="index-node_002c-output"></a>
+<p><code class="code">gtroff</code> processes input in three steps.  One or more input
+characters are converted to an <em class="dfn">input token</em>.<a class="footnote" id="DOCF119" href="#FOOT119"><sup>119</sup></a>  Then, one or more input tokens are converted to
+an <em class="dfn">output node</em>.  Finally, output nodes are converted to the
+intermediate output language understood by all output devices.
+</p>
+<p>Actually, before step one happens, <code class="code">gtroff</code> converts certain escape
+sequences into reserved input characters (not accessible by the user);
+such reserved characters are used for other internal processing also &ndash;
+this is the very reason why not all characters are valid input.
+See <a class="xref" href="#Identifiers">Identifiers</a>, for more on this topic.
+</p>
+<p>For example, the input string &lsquo;<samp class="samp">fi\:u</samp>&rsquo; is converted into a
+character token &lsquo;<samp class="samp">f</samp>&rsquo;, a character token &lsquo;<samp class="samp">i</samp>&rsquo;, and a special
+token &lsquo;<samp class="samp">:u</samp>&rsquo; (representing u&nbsp;umlaut).  Later on, the character
+tokens &lsquo;<samp class="samp">f</samp>&rsquo; and &lsquo;<samp class="samp">i</samp>&rsquo; are merged to a single output node
+representing the ligature glyph &lsquo;<samp class="samp">fi</samp>&rsquo; (provided the current font has
+a glyph for this ligature); the same happens with &lsquo;<samp class="samp">:u</samp>&rsquo;.  All output
+glyph nodes are &lsquo;processed&rsquo;, which means that they are invariably
+associated with a given font, font size, advance width, etc.  During the
+formatting process, <code class="code">gtroff</code> itself adds various nodes to control
+the data flow.
+</p>
+<p>Macros, diversions, and strings collect elements in two chained lists: a
+list of input tokens that have been passed unprocessed, and a list of
+output nodes.  Consider the following diversion.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xxx
+a
+\!b
+c
+.br
+.di
+</pre></div></div>
+
+<p>It contains these elements.
+</p>
+<table class="multitable">
+<tbody><tr><td>node list</td><td>token list</td><td>element number</td></tr>
+<tr><td><i class="i">line start node</i></td><td>&mdash;</td><td>1</td></tr>
+<tr><td><i class="i">glyph node <code class="code">a</code></i></td><td>&mdash;</td><td>2</td></tr>
+<tr><td><i class="i">word space node</i></td><td>&mdash;</td><td>3</td></tr>
+<tr><td>&mdash;</td><td><code class="code">b</code></td><td>4</td></tr>
+<tr><td>&mdash;</td><td><code class="code">\n</code></td><td>5</td></tr>
+<tr><td><i class="i">glyph node <code class="code">c</code></i></td><td>&mdash;</td><td>6</td></tr>
+<tr><td><i class="i">vertical size node</i></td><td>&mdash;</td><td>7</td></tr>
+<tr><td><i class="i">vertical size node</i></td><td>&mdash;</td><td>8</td></tr>
+<tr><td>&mdash;</td><td><code class="code">\n</code></td><td>9</td></tr>
+</tbody>
+</table>
+
+<a class="index-entry-id" id="index-_005cv_002c-internal-representation"></a>
+<p>Elements 1, 7, and&nbsp;8 are inserted by <code class="code">gtroff</code>; the latter two
+(which are always present) specify the vertical extent of the last line,
+possibly modified by <code class="code">\x</code>.  The <code class="code">br</code> request finishes the
+pending output line, inserting a newline input token, which is
+subsequently converted to a space when the diversion is reread.  Note
+that the word space node has a fixed width that isn&rsquo;t adjustable
+anymore.  To convert horizontal space nodes back to input tokens, use
+the <code class="code">unformat</code> request.
+</p>
+<p>Macros only contain elements in the token list (and the node list is
+empty); diversions and strings can contain elements in both lists.
+</p>
+<p>The <code class="code">chop</code> request simply reduces the number of elements in a
+macro, string, or diversion by one.  Exceptions are <em class="dfn">compatibility
+save</em> and <em class="dfn">compatibility ignore</em> input tokens, which are ignored.
+The <code class="code">substring</code> request also ignores those input tokens.
+</p>
+<p>Some requests like <code class="code">tr</code> or <code class="code">cflags</code> work on glyph identifiers
+only; this means that the associated glyph can be changed without
+destroying this association.  This can be very helpful for substituting
+glyphs.  In the following example, we assume that glyph &lsquo;<samp class="samp">foo</samp>&rsquo; isn&rsquo;t
+available by default, so we provide a substitution using the
+<code class="code">fchar</code> request and map it to input character &lsquo;<samp class="samp">x</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fchar \foo foo
+.tr x \foo
+</pre></div></div>
+
+<p>Now let us assume that we install an additional special font &lsquo;<samp class="samp">bar</samp>&rsquo;
+that has glyph &lsquo;<samp class="samp">foo</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.special bar
+.rchar \foo
+</pre></div></div>
+
+<p>Since glyphs defined with <code class="code">fchar</code> are searched before glyphs in
+special fonts, we must call <code class="code">rchar</code> to remove the definition of the
+fallback glyph.  Anyway, the translation is still active; &lsquo;<samp class="samp">x</samp>&rsquo; now
+maps to the real glyph &lsquo;<samp class="samp">foo</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-compatibility-mode_002c-and-parameters"></a>
+<a class="index-entry-id" id="index-mode_002c-compatibility_002c-and-parameters"></a>
+<a class="index-entry-id" id="index-arguments_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-parameters_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-macro-arguments_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-request-arguments_002c-and-compatibility-mode"></a>
+<p>Macro and request arguments preserve compatibility mode enablement.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1     \&quot; switch to compatibility mode
+.de xx
+\\$1
+..
+.cp 0     \&quot; switch compatibility mode off
+.xx caf\'e
+    &rArr; café
+</pre></div></div>
+
+<p>Since compatibility mode is enabled while <code class="code">de</code> is invoked, the
+macro <code class="code">xx</code> enables compatibility mode when it is called.  Argument
+<code class="code">$1</code> can still be handled properly because it inherits the
+compatibility mode enablement status that was active at the point where
+<code class="code">xx</code> was called.
+</p>
+<p>After interpolation of the parameters, the compatibility save and
+restore tokens are removed.
+</p>
+
+
+
+<hr>
+</div>
+<div class="section-level-extent" id="Debugging">
+<div class="nav-panel">
+<p>
+Next: <a href="#Implementation-Differences" accesskey="n" rel="next">Implementation Differences</a>, Previous: <a href="#Gtroff-Internals" accesskey="p" rel="prev"><code class="code">gtroff</code> Internals</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Debugging-1">5.37 Debugging</h3>
+<a class="index-entry-id" id="index-debugging"></a>
+
+<div class="flushright"><p class="flushright-paragraph"><i class="slanted">Standard troff voodoo, just put a power of two backslashes in
+front of it until it works and if you still have problems add a \c.</i>
+&mdash; Ron Natalie
+</p></div>
+<p>GNU <code class="code">troff</code> is not the easiest language to debug, in part thanks to
+its design features of recursive interpolation and the use of
+multi-stage pipeline processing in the surrounding system.  Nevertheless
+there exist several features useful for troubleshooting.
+</p>
+<p>Preprocessors use the <code class="code">lf</code> request to preserve the identity of the
+line numbers and names of input files.  GNU <code class="code">troff</code> emits a variety
+of error diagnostics and supports several categories of warning; the
+output of these can be selectively suppressed.  A trace of the
+formatter&rsquo;s input processing stack can be emitted when errors or
+warnings occur by means of GNU <code class="code">troff</code>&rsquo;s <samp class="option">-b</samp> option, or
+produced on demand with the <code class="code">backtrace</code> request.  The <code class="code">tm</code>
+and related requests can be used to emit customized diagnostic messages
+or for instrumentation while troubleshooting.  The <code class="code">ex</code> and
+<code class="code">ab</code> requests cause early termination with successful and error
+exit codes respectively, to halt further processing when continuing
+would be fruitless.  Examine the state of the formatter with requests
+that write lists of defined names (macros, strings, and diversions),
+environments, registers, and page location traps to the standard error
+stream.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lf</code></strong> <var class="def-var-arguments">line <span class="r"><i class="slanted">file</i></span></var><a class="copiable-link" href='#index-_002elf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lf"></a>
+<a class="index-entry-id" id="index-soelim"></a>
+<a class="index-entry-id" id="index-multi_002dfile-documents"></a>
+<a class="index-entry-id" id="index-documents_002c-multi_002dfile"></a>
+<a class="index-entry-id" id="index-setting-input-line-number-_0028lf_0029"></a>
+<a class="index-entry-id" id="index-input-line-number_002c-setting-_0028lf_0029"></a>
+<a class="index-entry-id" id="index-number_002c-input-line_002c-setting-_0028lf_0029"></a>
+<p>Set the input line number (and, optionally, the file name) GNU
+<code class="code">troff</code> shall use for error and warning messages.  <var class="var">line</var> is
+the input line number of the <em class="emph">next</em> line.  Without an argument, the
+request is ignored.
+</p>
+<p><code class="code">lf</code>&rsquo;s primary purpose is to aid the debugging of documents that
+undergo preprocessing.  Programs like <code class="command">tbl</code> that transform input
+in their own languages into <code class="code">roff</code> requests use it so that any
+diagnostic messages emitted by <code class="code">troff</code> correspond to the source
+document.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tm</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etm1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tm1</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etm1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tm1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etmc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tmc</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etmc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tmc"></a>
+<a class="index-entry-id" id="index-printing-to-stderr-_0028tm_002c-tm1_002c-tmc_0029"></a>
+<a class="index-entry-id" id="index-stderr_002c-printing-to-_0028tm_002c-tm1_002c-tmc_0029"></a>
+<p>Send <var class="var">message</var>, which consumes the remainder of the input line and
+cannot contain special characters, to the standard error stream,
+followed by a newline.  Leading spaces in <var class="var">message</var> are ignored.
+</p>
+<p><code class="code">tm1</code> is similar, but recognizes and strips a leading neutral
+double quote from <var class="var">message</var> to allow the embedding of leading
+spaces.
+</p>
+<p><code class="code">tmc</code> works as <code class="code">tm1</code>, but does not append a newline.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eab"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ab</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">message</i></span></var><a class="copiable-link" href='#index-_002eab'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ab"></a>
+<a class="index-entry-id" id="index-aborting-_0028ab_0029"></a>
+<p>Write any <var class="var">message</var> to the standard error stream (like <code class="code">tm</code>)
+and then abort GNU <code class="code">troff</code>; that is, stop processing and terminate
+with a failure status.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eex"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ex</code></strong><a class="copiable-link" href='#index-_002eex'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ex"></a>
+<a class="index-entry-id" id="index-ex-request_002c-use-in-debugging"></a>
+<a class="index-entry-id" id="index-exiting-_0028ex_0029"></a>
+<p>Exit GNU <code class="code">troff</code>; that is, stop processing and terminate with a
+successful status.  To stop processing only the current file, use the
+<code class="code">nx</code> request; see <a class="ref" href="#I_002fO">I/O</a>.
+</p></dd></dl>
+
+<p>When doing something involved, it is useful to leave the debugging
+statements in the code and have them turned on by a command-line flag.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if \nDB .tm debugging output
+</pre></div></div>
+
+<p>To activate such statements, use the <samp class="option">-r</samp> option to set the
+register.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -rDB=1 <i class="slanted">file</i>
+</pre></div></div>
+
+<p>If it is known in advance that there are many errors and no useful
+output, GNU <code class="code">troff</code> can be forced to suppress formatted output with
+the <samp class="option">-z</samp> option.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epev"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pev</code></strong><a class="copiable-link" href='#index-_002epev'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pev"></a>
+<a class="index-entry-id" id="index-dumping-environments-_0028pev_0029"></a>
+<a class="index-entry-id" id="index-environments_002c-dumping-_0028pev_0029"></a>
+<p>Report the state of the current environment followed by that of all
+other environments to the standard error stream.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pm</code></strong><a class="copiable-link" href='#index-_002epm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pm"></a>
+<a class="index-entry-id" id="index-dumping-symbol-table-_0028pm_0029"></a>
+<a class="index-entry-id" id="index-symbol-table_002c-dumping-_0028pm_0029"></a>
+<p>Report, to the standard error stream, the names of all defined macros,
+strings, and diversions with their sizes in bytes.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epnr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pnr</code></strong><a class="copiable-link" href='#index-_002epnr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pnr"></a>
+<a class="index-entry-id" id="index-dumping-registers-_0028pnr_0029"></a>
+<a class="index-entry-id" id="index-registers_002c-dumping-_0028pnr_0029"></a>
+<p>Report the names and contents of all currently defined registers to the
+standard error stream.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eptr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ptr</code></strong><a class="copiable-link" href='#index-_002eptr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ptr"></a>
+<a class="index-entry-id" id="index-dumping-page-location-traps-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-listing-page-location-traps-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location_002c-dumping-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location_002c-listing-_0028ptr_0029"></a>
+<p>Report the names and positions of all page location traps to the
+standard error stream.  Empty slots in the list, where a trap has been
+planted but subsequently (re)moved, are printed as well.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fl</code></strong><a class="copiable-link" href='#index-_002efl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fl"></a>
+<a class="index-entry-id" id="index-flush-output-_0028fl_0029"></a>
+<a class="index-entry-id" id="index-output_002c-flush-_0028fl_0029"></a>
+<a class="index-entry-id" id="index-interactive-use-of-gtroff"></a>
+<a class="index-entry-id" id="index-gtroff_002c-interactive-use"></a>
+<p>Instruct <code class="code">gtroff</code> to flush its output immediately.  The intent is
+for interactive use, but this behaviour is currently not implemented in
+<code class="code">gtroff</code>.  Contrary to Unix <code class="code">troff</code>, TTY output is sent to a
+device driver also (<code class="code">grotty</code>), making it non-trivial to communicate
+interactively.
+</p>
+<p>This request causes a line break.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebacktrace"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.backtrace</code></strong><a class="copiable-link" href='#index-_002ebacktrace'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-backtrace"></a>
+<a class="index-entry-id" id="index-backtrace-of-input-stack-_0028backtrace_0029"></a>
+<a class="index-entry-id" id="index-input-stack_002c-backtrace-_0028backtrace_0029"></a>
+<p>Write the state of the input stack to the standard error stream.
+</p>
+<p>Consider the following in a file <samp class="file">test</samp>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  backtrace
+..
+.de yyy
+.  xxx
+..
+.
+.yyy
+    error&rarr; troff: backtrace: 'test':2: macro 'xxx'
+    error&rarr; troff: backtrace: 'test':5: macro 'yyy'
+    error&rarr; troff: backtrace: file 'test':8
+</pre></div></div>
+
+<p>The <samp class="option">-b</samp> option of GNU <code class="code">troff</code> causes a backtrace to be
+generated on each error or warning.  Some warnings have to be enabled;
+See <a class="xref" href="#Warnings">Warnings</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bslimit_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nslimit</code></strong><a class="copiable-link" href='#index-_005cn_005bslimit_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-slimit"></a>
+<a class="index-entry-id" id="index-input-stack_002c-setting-limit"></a>
+<p>If greater than&nbsp;0, sets the maximum quantity of objects on GNU
+<code class="code">troff</code>&rsquo;s internal input stack.  If less than or equal to&nbsp;0,
+there is no limit: recursion can continue until program memory is
+exhausted.  The default is 1,000.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewarnscale"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.warnscale</code></strong> <var class="def-var-arguments">su</var><a class="copiable-link" href='#index-_002ewarnscale'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-warnscale"></a>
+<p>Set the scaling unit used in certain warnings to <var class="var">su</var>, which can take the values &lsquo;<samp class="samp">u</samp>&rsquo;, &lsquo;<samp class="samp">i</samp>&rsquo;, &lsquo;<samp class="samp">c</samp>&rsquo;,
+&lsquo;<samp class="samp">p</samp>&rsquo;, and &lsquo;<samp class="samp">P</samp>&rsquo;.  The default is &lsquo;<samp class="samp">i</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002espreadwarn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.spreadwarn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">limit</i></span></var><a class="copiable-link" href='#index-_002espreadwarn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-spreadwarn"></a>
+<p>Emit a <code class="code">break</code> warning if the additional space inserted for each
+space between words in an output line adjusted to both margins with
+&lsquo;<samp class="samp">.ad&nbsp;b</samp>&rsquo; is larger than or equal to <var class="var">limit</var>.  A negative
+value is treated as zero; an absent argument toggles the warning on and
+off without changing <var class="var">limit</var>.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+At startup, <code class="code">spreadwarn</code> is inactive and <var class="var">limit</var> is 3<span class="dmn">m</span>.
+</p>
+<p>For example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.spreadwarn 0.2m
+</pre></div></div>
+
+<p>causes a warning if <code class="code">break</code> warnings are not suppressed and
+<code class="code">gtroff</code> must add 0.2<span class="dmn">m</span> or more for each inter-word space in a
+line.  See <a class="xref" href="#Warnings">Warnings</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-warnings"></a>
+<p>GNU <code class="code">troff</code> has command-line options for reporting warnings
+(<samp class="option">-w</samp>) and backtraces (<samp class="option">-b</samp>) when a warning or an error
+occurs.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewarn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.warn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ewarn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-warn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ewarn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.warn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ewarn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ewarn-1"></a>
+<a class="index-entry-id" id="index-warning-level-_0028warn_0029"></a>
+<p>Select the categories, or &ldquo;types&rdquo;, of reported warnings.
+<var class="var">n</var>&nbsp;is the sum of the numeric codes associated with each
+warning category that is to be enabled; all other categories are
+disabled.  The categories and their associated codes are listed in
+<a class="ref" href="#Warnings">Warnings</a>.  For example, &lsquo;<samp class="samp">.warn 0</samp>&rsquo; disables all warnings, and
+&lsquo;<samp class="samp">.warn 1</samp>&rsquo; disables all warnings except those about missing glyphs.
+If no argument is given, all warning categories are enabled.
+</p>
+<p>The read-only register <code class="code">.warn</code> contains the sum of the numeric
+codes of enabled warning categories.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="#Warnings" accesskey="1">Warnings</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Warnings">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Debugging" accesskey="p" rel="prev">Debugging</a>, Up: <a href="#Debugging" accesskey="u" rel="up">Debugging</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Warnings-1">5.37.1 Warnings</h4>
+<a class="index-entry-id" id="index-warnings-1"></a>
+
+<p>Warning diagnostics emitted by GNU <code class="code">troff</code> are divided into named,
+numbered categories.  The name associated with each warning category is
+used by the <samp class="option">-w</samp> and <samp class="option">-W</samp> options.  Each category is also
+assigned a power of two; the sum of enabled category values is used by
+the <code class="code">warn</code> request and the <code class="code">.warn</code> register.
+</p>
+<p>Warnings of each category are produced under the following
+circumstances.
+</p>
+<a class="index-entry-id" id="index-categories_002c-warning"></a>
+<a class="index-entry-id" id="index-warning-categories"></a>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">char</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">1</samp>&rsquo;</dt>
+<dd><p>No mounted font defines a glyph for the requested character.  This
+category is enabled by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">number</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">2</samp>&rsquo;</dt>
+<dd><p>An invalid numeric expression was encountered.  This category is enabled
+by default.
+See <a class="xref" href="#Numeric-Expressions">Numeric Expressions</a>.
+</p>
+</dd>
+<dt id='index-filling_002c-and-break-warnings'><span>&lsquo;<samp class="samp">break</samp>&rsquo;<a class="copiable-link" href='#index-filling_002c-and-break-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">4</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-mode_002c-fill_002c-and-break-warnings"></a>
+<p>A filled output line could not be broken such that its length was less
+than the output line length &lsquo;<samp class="samp">\n.l</samp>&rsquo;.  This category is enabled by
+default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">delim</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">8</samp>&rsquo;</dt>
+<dd><p>The closing delimiter in an escape sequence was missing or mismatched.
+</p>
+</dd>
+<dt id='index-ie-request_002c-and-warnings'><span>&lsquo;<samp class="samp">el</samp>&rsquo;<a class="copiable-link" href='#index-ie-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">16</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-el-request_002c-and-warnings"></a>
+<p>The <code class="code">el</code> request was encountered with no prior corresponding
+<code class="code">ie</code> request.  See <a class="xref" href="#if_002delse">if-else</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">scale</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">32</samp>&rsquo;</dt>
+<dd><p>A scaling unit inappropriate to its context was used in a numeric
+expression.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">range</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">64</samp>&rsquo;</dt>
+<dd><p>A numeric expression was out of range for its context.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">syntax</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">128</samp>&rsquo;</dt>
+<dd><p>A self-contradictory hyphenation mode was requested; an empty or
+incomplete numeric expression was encountered; an operand to a numeric
+operator was missing; an attempt was made to define a recursive, empty,
+or nonsensical character class; or a <code class="code">groff</code> extension conditional
+expression operator was used while in compatibility mode.
+</p>
+</dd>
+<dt id='index-di-request_002c-and-warnings'><span>&lsquo;<samp class="samp">di</samp>&rsquo;<a class="copiable-link" href='#index-di-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">256</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-da-request_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-box-request_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-boxa-request_002c-and-warnings"></a>
+<p>A <code class="code">di</code>, <code class="code">da</code>, <code class="code">box</code>, or <code class="code">boxa</code> request was invoked
+without an argument when there was no current diversion.
+</p>
+</dd>
+<dt id='index-de_002c-de1_002c-dei-requests_002c-and-warnings'><span>&lsquo;<samp class="samp">mac</samp>&rsquo;<a class="copiable-link" href='#index-de_002c-de1_002c-dei-requests_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">512</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-am_002c-am1_002c-ami-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-ds_002c-ds1-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-as_002c-as1-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-di-request_002c-and-warnings-1"></a>
+<a class="index-entry-id" id="index-da-request_002c-and-warnings-1"></a>
+<a class="index-entry-id" id="index-box_002c-boxa-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-and-warnings"></a>
+<p>An undefined string, macro, or diversion was used.  When such an object
+is dereferenced, an empty one of that name is automatically created.
+So, unless it is later deleted, at most one warning is given for each.
+</p>
+<p>This warning is also emitted upon an attempt to move an unplanted trap
+macro (see <a class="pxref" href="#Page-Location-Traps">Page Location Traps</a>).  In such cases, the unplanted macro
+is <em class="emph">not</em> dereferenced, so it is not created if it does not exist.
+</p>
+</dd>
+<dt id='index-nr-request_002c-and-warnings'><span>&lsquo;<samp class="samp">reg</samp>&rsquo;<a class="copiable-link" href='#index-nr-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">1024</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-_005cR_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-_005cn_002c-and-warnings"></a>
+<p>An undefined register was used.  When an undefined register is
+dereferenced, it is automatically defined with a value of&nbsp;0.  So,
+unless it is later deleted, at most one warning is given for each.
+</p>
+</dd>
+<dt id='index-_005ct_002c-and-warnings'><span>&lsquo;<samp class="samp">tab</samp>&rsquo;<a class="copiable-link" href='#index-_005ct_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">2048</samp>&rsquo;</dt>
+<dd><p>A tab character was encountered where a number was expected, or appeared
+in an unquoted macro argument.
+</p>
+</dd>
+<dt id='index-_005c_007d_002c-and-warnings'><span>&lsquo;<samp class="samp">right-brace</samp>&rsquo;<a class="copiable-link" href='#index-_005c_007d_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">4096</samp>&rsquo;</dt>
+<dd><p>A right brace escape sequence <code class="code">\}</code> was encountered where a number
+was expected.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">missing</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">8192</samp>&rsquo;</dt>
+<dd><p>A request was invoked with a mandatory argument absent.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">input</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">16384</samp>&rsquo;</dt>
+<dd><p>An invalid character occurred on the input stream.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">escape</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">32768</samp>&rsquo;</dt>
+<dd><p>An unsupported escape sequence was encountered.
+</p>
+</dd>
+<dt id='index-compatibility-mode'><span>&lsquo;<samp class="samp">space</samp>&rsquo;<a class="copiable-link" href='#index-compatibility-mode'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">65536</samp>&rsquo;</dt>
+<dd><p>A space was missing between a request or macro and its argument.  This
+warning is produced when an undefined name longer than two characters is
+encountered and the first two characters of the name constitute a
+defined name.  No request is invoked, no macro called, and an empty
+macro is not defined.  This category is enabled by default.  It never
+occurs in compatibility mode.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">font</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">131072</samp>&rsquo;</dt>
+<dd><p>A non-existent font was selected, or the selection was ignored because a
+font selection escape sequence was used after the output line
+continuation escape sequence on an input line.  This category is enabled
+by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">ig</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">262144</samp>&rsquo;</dt>
+<dd><p>An invalid escape sequence occurred in input ignored using the <code class="code">ig</code>
+request.  This warning category diagnoses a condition that is an error
+when it occurs in non-ignored input.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">color</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">524288</samp>&rsquo;</dt>
+<dd><p>An undefined color was selected, an attempt was made to define a color
+using an unrecognized color space, an invalid component in a color
+definition was encountered, or an attempt was made to redefine a default
+color.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">file</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">1048576</samp>&rsquo;</dt>
+<dd><p>An attempt was made to load a file that does not exist.  This category
+is enabled by default.
+</p></dd>
+</dl>
+
+<p>Two warning names group other warning categories for convenience.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">all</samp>&rsquo;</dt>
+<dd><p>All warning categories except &lsquo;<samp class="samp">di</samp>&rsquo;, &lsquo;<samp class="samp">mac</samp>&rsquo; and &lsquo;<samp class="samp">reg</samp>&rsquo;.
+This shorthand is intended to produce all warnings that are useful with
+macro packages written for <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> and its
+descendants, which have less fastidious diagnostics than GNU
+<code class="code">troff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">w</samp>&rsquo;</dt>
+<dd><p>All warning categories.  Authors of documents and macro packages
+targeting <code class="code">groff</code> are encouraged to use this setting.
+</p></dd>
+</dl>
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Implementation-Differences">
+<div class="nav-panel">
+<p>
+Next: <a href="#Safer-Mode" accesskey="n" rel="next">Safer Mode</a>, Previous: <a href="#Debugging" accesskey="p" rel="prev">Debugging</a>, Up: <a href="#GNU-troff-Reference" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Implementation-Differences-1">5.38 Implementation Differences</h3>
+<a class="index-entry-id" id="index-implementation-differences"></a>
+<a class="index-entry-id" id="index-differences-in-implementation"></a>
+<a class="index-entry-id" id="index-incompatibilities-with-AT_0026T-troff"></a>
+
+<p>GNU <code class="code">troff</code> has a number of features that cause incompatibilities
+with documents written for other versions of <code class="code">troff</code>.  Some GNU
+extensions to <code class="code">troff</code> have become supported by other
+implementations.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Safer-Mode" accesskey="1">Safer Mode</a></li>
+<li><a href="#Compatibility-Mode" accesskey="2">Compatibility Mode</a></li>
+<li><a href="#Other-Differences" accesskey="3">Other Differences</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Safer-Mode">
+<div class="nav-panel">
+<p>
+Next: <a href="#Compatibility-Mode" accesskey="n" rel="next">Compatibility Mode</a>, Previous: <a href="#Implementation-Differences" accesskey="p" rel="prev">Implementation Differences</a>, Up: <a href="#Implementation-Differences" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Safer-Mode-1">5.38.1 Safer Mode</h4>
+<a class="index-entry-id" id="index-safer-mode-7"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-7"></a>
+
+<a class="index-entry-id" id="index-pi-request_002c-disabled-by-default"></a>
+<a class="index-entry-id" id="index-sy-request_002c-disabled-by-default"></a>
+<p>The formatter operates in &ldquo;safer&rdquo; mode by default; to mitigate risks
+from untrusted input documents, the <code class="code">pi</code> and <code class="code">sy</code> requests are
+disabled.  GNU <code class="code">troff</code>&rsquo;s <samp class="option">-U</samp> option enables &ldquo;unsafe
+mode&rdquo;, restoring their function and enabling additional <code class="code">groff</code>
+extension requests, <code class="code">open</code>, <code class="code">opena</code>, and <code class="code">pso</code>.
+See <a class="xref" href="#I_002fO">I/O</a>.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Compatibility-Mode">
+<div class="nav-panel">
+<p>
+Next: <a href="#Safer-Mode" accesskey="n" rel="next">Safer Mode</a>, Previous: <a href="#Other-Differences" accesskey="p" rel="prev">Other Differences</a>, Up: <a href="#Implementation-Differences" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Compatibility-Mode-1">5.38.2 Compatibility Mode</h4>
+<a class="index-entry-id" id="index-compatibility-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-compatibility"></a>
+
+<a class="index-entry-id" id="index-long-names"></a>
+<a class="index-entry-id" id="index-names_002c-long"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cn_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Long identifier names may be GNU <code class="code">troff</code>&rsquo;s most obvious innovation.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> interprets &lsquo;<samp class="samp">.dsabcd</samp>&rsquo; as defining a
+string &lsquo;<samp class="samp">ab</samp>&rsquo; with contents &lsquo;<samp class="samp">cd</samp>&rsquo;.  Normally, GNU <code class="code">troff</code>
+interprets this as a call of a macro named <code class="code">dsabcd</code>.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> also interprets &lsquo;<samp class="samp">\*</samp>&rsquo; and &lsquo;<samp class="samp">\n</samp>&rsquo; as
+an interpolation of a string or register, respectively, named &lsquo;<samp class="samp"></samp>&rsquo;.
+In GNU <code class="code">troff</code>, however, the &lsquo;<samp class="samp"></samp>&rsquo; is normally interpreted as
+delimiting a long name.  In compatibility mode, GNU <code class="code">troff</code>
+interprets names in the traditional way; they thus can be two characters
+long at most.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ecp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eC_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.C</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eC"></a>
+<p>If <var class="var">n</var> is missing or non-zero, turn on compatibility mode;
+otherwise, turn it off.
+</p>
+<p>The read-only register <code class="code">.C</code> is&nbsp;1 if compatibility mode is on,
+0&nbsp;otherwise.
+</p>
+<p>Compatibility mode can be also turned on with the <samp class="option">-C</samp>
+command-line option.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.do</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002edo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-do"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecp-1"></a>
+<p>The <code class="code">do</code> request interprets the string, request, diversion, or
+macro <var class="var">name</var> (along with any further arguments) with compatibility
+mode disabled.  Compatibility mode is restored (only if it was active)
+when the <em class="emph">expansion</em> of <var class="var">name</var> is interpreted; that is, the
+restored compatibility state applies to the contents of the macro,
+string, or diversion <var class="var">name</var> as well as data read from files or pipes
+if <var class="var">name</var> is any of the <code class="code">so</code>, <code class="code">soquiet</code>, <code class="code">mso</code>,
+<code class="code">msoquiet</code>, or <code class="code">pso</code> requests.
+</p>
+<p>The following example illustrates several aspects of <code class="code">do</code> behavior.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de mac1
+FOO
+..
+.de1 mac2
+groff
+.mac1
+..
+.de mac3
+compatibility
+.mac1
+..
+.de ma
+\\$1
+..
+.cp 1
+.do mac1
+.do mac2 \&quot; mac2, defined with .de1, calls &quot;mac1&quot;
+.do mac3 \&quot; mac3 calls &quot;ma&quot; with argument &quot;c1&quot;
+.do mac3 \ti \&quot; groff syntax accepted in .do arguments
+    &rArr; FOO groff FOO compatibility c1 ~
+</pre></div></div>
+
+<p>The read-only register <code class="code">.cp</code>, meaningful only when dereferenced
+from a <code class="code">do</code> request, is&nbsp;1 if compatibility mode was on when
+the <code class="code">do</code> request was encountered, and 0&nbsp;if it was not.  This
+register is specialized and may require a statement of rationale.
+</p>
+<p>When writing macro packages or documents that use GNU <code class="code">troff</code>
+features and which may be mixed with other packages or documents that do
+not&mdash;common scenarios include serial processing of man pages or use of
+the <code class="code">so</code> or <code class="code">mso</code> requests&mdash;you may desire correct operation
+regardless of compatibility mode enablement in the surrounding context.
+It may occur to you to save the existing value of &lsquo;<samp class="samp">\n(.C</samp>&rsquo; into a
+register, say, &lsquo;<samp class="samp">_C</samp>&rsquo;, at the beginning of your file, turn
+compatibility mode off with &lsquo;<samp class="samp">.cp 0</samp>&rsquo;, then restore it from that
+register at the end with &lsquo;<samp class="samp">.cp \n(_C</samp>&rsquo;.  At the same time, a modular
+design of a document or macro package may lead you to multiple layers of
+inclusion.  You cannot use the same register name everywhere lest you
+&ldquo;clobber&rdquo; the value from a preceding or enclosing context.  The
+two-character register name space of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> is
+confining and mnemonically challenging; you may wish to use the more
+capacious name space of GNU <code class="code">troff</code>.  However, attempting &lsquo;<samp class="samp">.nr
+_my_saved_C \n(.C</samp>&rsquo; will not work in compatibility mode; the register
+name is too long.  &ldquo;This is exactly what <code class="code">do</code> is for,&rdquo; you think,
+&lsquo;<samp class="samp">.do nr _my_saved_C \n(.C</samp>&rsquo;.  The foregoing will always save zero to
+your register, because <code class="code">do</code> turns compatibility mode <em class="emph">off</em>
+while it interprets its argument list.
+</p>
+<p>To robustly save compatibility mode before switching it off, use
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.do nr _my_saved_C \n.cp
+.cp 0
+</pre></div></div>
+
+<p>at the beginning of your file, followed by
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp \n_my_saved_C
+.do rr _my_saved_C
+</pre></div></div>
+
+<p>at the end.  As in the C language, we all have to share one big
+name space, so choose a register name that is unlikely to collide with
+other uses.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-input-level-in-delimited-arguments"></a>
+<a class="index-entry-id" id="index-interpolation-depth-in-delimited-arguments"></a>
+<a class="index-entry-id" id="index-delimited-arguments_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Normally, GNU <code class="code">troff</code> preserves the interpolation depth in
+delimited arguments, but not in compatibility mode.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xx '
+\w'abc\*(xxdef'
+    &rArr; 168 <span class="r">(normal mode on a terminal device)</span>
+    &rArr; 72def' <span class="r">(compatibility mode on a terminal device)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005cf_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cH_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cs_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cS_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Furthermore, the escape sequences <code class="code">\f</code>, <code class="code">\H</code>, <code class="code">\m</code>,
+<code class="code">\M</code>, <code class="code">\R</code>, <code class="code">\s</code>, and <code class="code">\S</code> are transparent for the
+purpose of recognizing a control character at the beginning of a line
+only in compatibility mode.  For example, this code produces bold output
+in both cases, but the text differs.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xx
+Hello!
+..
+\fB.xx\fP
+    &rArr; .xx <span class="r">(normal mode)</span>
+    &rArr; Hello! <span class="r">(compatibility mode)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005cs_002c-incompatibilities-with-AT_0026T-troff-1"></a>
+<p>Normally, the syntax form <code class="code">\s</code><var class="var">n</var> accepts only a single
+character (a digit) for <var class="var">n</var>, consistently with other forms that
+originated in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, like <code class="code">\*</code>, <code class="code">\$</code>,
+<code class="code">\f</code>, <code class="code">\g</code>, <code class="code">\k</code>, <code class="code">\n</code>, and <code class="code">\z</code>.  In
+compatibility mode only, a non-zero&nbsp;<var class="var">n</var> must be in the range
+4&ndash;39.  Legacy documents relying upon this quirk of parsing<a class="footnote" id="DOCF120" href="#FOOT120"><sup>120</sup></a> should be migrated to another
+<code class="code">\s</code> form.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Other-Differences">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Compatibility-Mode" accesskey="p" rel="prev">Compatibility Mode</a>, Up: <a href="#Implementation-Differences" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Other-Differences-1">5.38.3 Other Differences</h4>
+
+<p><code class="code">groff</code> request names unrecognized by other <code class="code">troff</code>
+implementations will likely be ignored by them; escape sequences that
+are <code class="code">groff</code> extensions are liable to be interpreted as if the
+escape character were not present.
+<a class="index-entry-id" id="index-_005c_007e_002c-incompatibilities-with-AT_0026T-troff"></a>
+For example, the adjustable, non-breaking escape sequence <code class="code">\~</code>
+is also supported by Heirloom Doctools <code class="code">troff</code> 050915 (September
+2005), <code class="code">mandoc</code> 1.9.5 (2009-09-21), <code class="code">neatroff</code> (commit
+1c6ab0f6e, 2016-09-13), and Plan&nbsp;9 from User Space <code class="code">troff</code>
+(commit 93f8143600, 2022-08-12), but not by Solaris or Documenter&rsquo;s
+Workbench <code class="code">troff</code>s.
+See <a class="xref" href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a>.
+</p>
+<a class="index-entry-id" id="index-_005cA_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007c_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_005e_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cc_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>GNU <code class="code">troff</code> does not allow the use of the escape sequences
+<code class="code">\|</code>, <code class="code">\^</code>, <code class="code">\&amp;</code>, <code class="code">\{</code>, <code class="code">\}</code>,
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\%</code>, and <code class="code">\c</code> in identifiers; <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>
+does.  The <code class="code">\A</code> escape sequence (see <a class="pxref" href="#Identifiers">Identifiers</a>) may be
+helpful in avoiding use of these escape sequences in names.
+</p>
+<a class="index-entry-id" id="index-adjustment-to-both-margins_002c-difference-from-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-rivers"></a>
+<p>When adjusting to both margins, <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> at first
+adjusts spaces starting from the right; GNU <code class="code">troff</code> begins from
+the left.  Both implementations adjust spaces from opposite ends on
+alternating output lines in this adjustment mode to prevent &ldquo;rivers&rdquo;
+in the text.
+</p>
+<a class="index-entry-id" id="index-hyphenation_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>GNU <code class="code">troff</code> does not always hyphenate words as <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> does.  The <abbr class="acronym">AT&amp;T</abbr> implementation uses a set of
+hard-coded rules specific to English, while GNU <code class="code">troff</code> uses
+language-specific hyphenation pattern files derived from TeX.
+Furthermore, in old versions of <code class="code">troff</code> there was a limited amount
+of space to store hyphenation exceptions (arguments to the <code class="code">hw</code>
+request); GNU <code class="code">troff</code> has no such restriction.
+</p>
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029_002c-in-other-implementations"></a>
+<p>GNU <code class="code">troff</code> predefines a string <code class="code">.T</code> containing the argument
+given to the <samp class="option">-T</samp> command-line option, namely the current output
+device (for example, &lsquo;<samp class="samp">pdf</samp>&rsquo; or &lsquo;<samp class="samp">utf8</samp>&rsquo;).  The existence of this
+string is a common feature of post-CSTR&nbsp;#54
+<code class="code">troff</code>s<a class="footnote" id="DOCF121" href="#FOOT121"><sup>121</sup></a> but valid values are specific
+to each implementation.
+</p>
+<a class="index-entry-id" id="index-removal-of-read_002donly-registers_002c-incompatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-register_002c-read_002donly_002c-removal_002c-incompatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-read_002donly-register-removal_002c-incompatibility-with-AT_0026T-troff"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> ignored attempts to remove read-only
+registers; GNU <code class="code">troff</code> honors such requests.  See <a class="xref" href="#Built_002din-Registers">Built-in Registers</a>.
+</p>
+<a class="index-entry-id" id="index-output-device-usage-register-_0028_002eT_0029_002c-incompatibility-with-AT_0026T-troff"></a>
+<p>The (read-only) register <code class="code">.T</code> interpolates&nbsp;1 if GNU
+<code class="code">troff</code> is called with the <samp class="option">-T</samp> command-line option, and
+0&nbsp;otherwise.  This behavior differs from AT&amp;T <code class="code">troff</code>, which
+interpolated&nbsp;1 only if <code class="code">nroff</code> was the formatter and was
+called with <samp class="option">-T</samp>.
+</p>
+<a class="index-entry-id" id="index-lf-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> and other implementations handle the
+<code class="code">lf</code> request differently.  For them, its <var class="var">line</var> argument
+changes the line number of the <em class="emph">current</em> line.
+</p>
+<a class="index-entry-id" id="index-environment-availability-and-naming_002c-incompatibilities-with"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> had only environments named &lsquo;<samp class="samp">0</samp>&rsquo;,
+&lsquo;<samp class="samp">1</samp>&rsquo;, and &lsquo;<samp class="samp">2</samp>&rsquo;.  In GNU <code class="code">troff</code>, any number of environments
+may exist, using any valid identifiers for their names
+(see <a class="pxref" href="#Identifiers">Identifiers</a>.)
+</p>
+<a class="index-entry-id" id="index-fractional-point-sizes-1"></a>
+<a class="index-entry-id" id="index-fractional-type-sizes-1"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-fractional-1"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-fractional-1"></a>
+<a class="index-entry-id" id="index-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-ps-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Fractional type sizes cause one noteworthy incompatibility.  In
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> the <code class="code">ps</code> request ignores scaling units
+and thus &lsquo;<samp class="samp">.ps 10u</samp>&rsquo; sets the type size to 10&nbsp;points, whereas in
+GNU <code class="code">troff</code> it sets the type size to 10&nbsp;<em class="emph">scaled</em> points.
+See <a class="xref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>.
+</p>
+<a class="index-entry-id" id="index-ab-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">ab</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> writes no message to the standard error stream if no
+arguments are given, and it exits with a failure status instead of a
+successful one.
+</p>
+<a class="index-entry-id" id="index-bp-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">bp</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> does not accept a scaling unit on the argument, a page
+number; the former (somewhat uselessly) does.
+</p>
+<a class="index-entry-id" id="index-pm-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">pm</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> reports the sizes of macros, strings, and diversions in
+bytes and ignores an argument to report only the sum of the sizes.
+</p>
+<a class="index-entry-id" id="index-ss-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Unlike <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, GNU <code class="code">troff</code> does not ignore the
+<code class="code">ss</code> request if the output is a terminal device; instead, the
+values of minimal inter-word and additional inter-sentence space are
+each rounded down to the nearest multiple of&nbsp;12.
+</p>
+<a class="index-entry-id" id="index-bd-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-cs-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-tr-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-fp-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-input-characters-and-output-glyphs_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-output-glyphs_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-characters_002c-input_002c-and-output-glyphs_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-glyphs_002c-output_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff"></a>
+<p>In GNU <code class="code">troff</code> there is a fundamental difference between
+(unformatted) characters and (formatted) glyphs.  Everything that
+affects how a glyph is output is stored with the glyph node; once a
+glyph node has been constructed, it is unaffected by any subsequent
+requests that are executed, including <code class="code">bd</code>, <code class="code">cs</code>, <code class="code">tkf</code>,
+<code class="code">tr</code>, or <code class="code">fp</code> requests.  Normally, glyphs are constructed from
+characters immediately before the glyph is added to an output line.
+Macros, diversions, and strings are all, in fact, the same type of
+object; they contain a sequence of intermixed character and glyph nodes.
+Special characters transform from one to the other: before being added
+to the output, they behave as characters; afterward, they are glyphs.  A
+glyph node does not behave like a character node when it is processed by
+a macro: it does not inherit any of the special properties that the
+character from which it was constructed might have had.  For example,
+the input
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di x
+\\\\
+.br
+.di
+.x
+</pre></div></div>
+
+<p>produces &lsquo;<samp class="samp">\\</samp>&rsquo; in GNU <code class="code">troff</code>.  Each pair of backslashes
+becomes one backslash <em class="emph">glyph</em>; the resulting backslashes are thus
+not interpreted as escape <em class="emph">characters</em> when they are reread as the
+diversion is output.  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> <em class="emph">would</em> interpret
+them as escape characters when rereading them and end up printing one
+&lsquo;<samp class="samp">\</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-printing-backslash-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-backslash_002c-printing-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-_005ce_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff-1"></a>
+<a class="index-entry-id" id="index-_005c_003f_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-transparent-output_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-output_002c-transparent_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>One correct way to obtain a printable backslash in most documents is to
+use the <code class="code">\e</code> escape sequence; this always prints a single instance
+of the current escape character,<a class="footnote" id="DOCF122" href="#FOOT122"><sup>122</sup></a> regardless of whether or not it is used in a diversion; it
+also works in both GNU <code class="code">troff</code> and <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.
+</p>
+<p>The other correct way, appropriate in contexts independent of the
+backslash&rsquo;s common use as a <code class="code">troff</code> escape character&mdash;perhaps in
+discussion of character sets or other programming languages&mdash;is
+the character escape <code class="code">\(rs</code> or <code class="code">\rs</code>, for &ldquo;reverse
+solidus&rdquo;, from its name in the <abbr class="acronym">ECMA-6</abbr> (<abbr class="acronym">ISO/IEC</abbr> 646)
+standard.<a class="footnote" id="DOCF123" href="#FOOT123"><sup>123</sup></a>
+</p>
+<p>To store an escape sequence in a diversion that is interpreted when the
+diversion is reread, either use the traditional <code class="code">\!</code> transparent
+output facility, or, if this is unsuitable, the new <code class="code">\?</code> escape
+sequence.  See <a class="xref" href="#Diversions">Diversions</a> and <a class="ref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>.
+</p>
+<p>In the somewhat pathological case where a diversion exists containing a
+partially collected line and a partially collected line at the top-level
+diversion has never existed, <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> will output the
+partially collected line at the end of input; GNU <code class="code">troff</code> will not.
+</p>
+
+
+
+
+<hr>
+</div>
+</div>
+</div>
+<div class="chapter-level-extent" id="File-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="#Copying-This-Manual" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="#GNU-troff-Reference" accesskey="p" rel="prev">GNU <code class="code">troff</code> Reference</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="chapter" id="File-Formats-1">6 File Formats</h2>
+<a class="index-entry-id" id="index-file-formats"></a>
+<a class="index-entry-id" id="index-formats_002c-file"></a>
+
+<p>All files read and written by <code class="code">gtroff</code> are text files.  The
+following two sections describe their format.
+</p>
+
+
+
+
+<ul class="mini-toc">
+<li><a href="#gtroff-Output" accesskey="1"><code class="code">gtroff</code> Output</a></li>
+<li><a href="#Device-and-Font-Description-Files" accesskey="2">Device and Font Description Files</a></li>
+</ul>
+<hr>
+<div class="section-level-extent" id="gtroff-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="#Device-and-Font-Description-Files" accesskey="n" rel="next">Device and Font Description Files</a>, Previous: <a href="#File-Formats" accesskey="p" rel="prev">File Formats</a>, Up: <a href="#File-Formats" accesskey="u" rel="up">File Formats</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="gtroff-Output-1">6.1 <code class="code">gtroff</code> Output</h3>
+<a class="index-entry-id" id="index-gtroff_002c-output"></a>
+<a class="index-entry-id" id="index-output_002c-gtroff"></a>
+
+<p>This section describes the <code class="code">groff</code> intermediate output format
+produced by GNU <code class="code">troff</code>.
+</p>
+<p>As <code class="code">groff</code> is a wrapper program around GNU <code class="code">troff</code> and
+automatically calls an output driver (or &ldquo;postprocessor&rdquo;), this output
+does not show up normally.  This is why it is called
+<em class="emph">intermediate</em>.  <code class="code">groff</code> provides the option <samp class="option">-Z</samp> to
+inhibit postprocessing such that the produced intermediate output is
+sent to standard output just as it is when calling GNU <code class="code">troff</code>
+directly.
+</p>
+<a class="index-entry-id" id="index-troff-output"></a>
+<a class="index-entry-id" id="index-output_002c-troff"></a>
+<a class="index-entry-id" id="index-intermediate-output"></a>
+<a class="index-entry-id" id="index-output_002c-intermediate"></a>
+<p>Here, the term <em class="dfn">troff output</em> describes what is output by
+GNU <code class="code">troff</code>, while <em class="dfn">intermediate output</em> refers to the language
+that is accepted by the parser that prepares this output for the output
+drivers.  This parser handles whitespace more flexibly than
+<abbr class="acronym">AT&amp;T</abbr>&rsquo;s implementation and implements obsolete elements for
+compatibility; otherwise, both formats are the same.<a class="footnote" id="DOCF124" href="#FOOT124"><sup>124</sup></a>
+</p>
+<p>The main purpose of the intermediate output concept is to facilitate the
+development of postprocessors by providing a common programming
+interface for all devices.  It has a language of its own that is
+completely different from the <code class="code">gtroff</code> language.  While the
+<code class="code">gtroff</code> language is a high-level programming language for text
+processing, the intermediate output language is a kind of low-level
+assembler language by specifying all positions on the page for writing
+and drawing.
+</p>
+<p>The intermediate output produced by <code class="code">gtroff</code> is fairly readable,
+while output from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> is rather hard to
+understand because of strange habits that are still supported, but not
+used any longer by <code class="code">gtroff</code>.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#Language-Concepts" accesskey="1">Language Concepts</a></li>
+<li><a href="#Command-Reference" accesskey="2">Command Reference</a></li>
+<li><a href="#Intermediate-Output-Examples" accesskey="3">Intermediate Output Examples</a></li>
+<li><a href="#Output-Language-Compatibility" accesskey="4">Output Language Compatibility</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="Language-Concepts">
+<div class="nav-panel">
+<p>
+Next: <a href="#Command-Reference" accesskey="n" rel="next">Command Reference</a>, Previous: <a href="#gtroff-Output" accesskey="p" rel="prev"><code class="code">gtroff</code> Output</a>, Up: <a href="#gtroff-Output" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Language-Concepts-1">6.1.1 Language Concepts</h4>
+
+<p>The fundamental operation of the GNU <code class="code">troff</code> formatter is the
+translation of the <code class="code">groff</code> input language into a device-independent
+form primarily concerned with what has to be written or drawn at
+specific positions on the output device.  This language is simple and
+imperative.  In the following discussion, the term <em class="dfn">command</em> always
+refers to this intermediate output language, and never to the
+<code class="code">groff</code> language intended for direct use by document authors.
+Intermediate output commands comprise several categories: glyph output;
+font, color, and text size selection; motion of the printing position;
+page advancement; drawing of geometric objects; and device control
+commands, a catch-all for operations not easily classified as any of the
+foregoing, such as directives to start and stop output, identify the
+intended output device, or place URL hyperlinks in supported output
+formats.
+</p>
+
+<ul class="mini-toc">
+<li><a href="#Separation" accesskey="1">Separation</a></li>
+<li><a href="#Argument-Units" accesskey="2">Argument Units</a></li>
+<li><a href="#Document-Parts" accesskey="3">Document Parts</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="Separation">
+<div class="nav-panel">
+<p>
+Next: <a href="#Argument-Units" accesskey="n" rel="next">Argument Units</a>, Previous: <a href="#Language-Concepts" accesskey="p" rel="prev">Language Concepts</a>, Up: <a href="#Language-Concepts" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Separation-1">6.1.1.1 Separation</h4>
+
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output has strange requirements regarding
+whitespace.  The <code class="code">gtroff</code> output parser, however, is more tolerant,
+making whitespace maximally optional.  Such characters, i.e., the tab,
+space, and newline, always have a syntactical meaning.  They are never
+printable because spacing within the output is always done by
+positioning commands.
+</p>
+<p>Any sequence of space or tab characters is treated as a single
+<em class="dfn">syntactical space</em>.  It separates commands and arguments, but is
+only required when there would occur a clashing between the command code
+and the arguments without the space.  Most often, this happens when
+variable-length command names, arguments, argument lists, or command
+clusters meet.  Commands and arguments with a known, fixed length need
+not be separated by syntactical space.
+</p>
+<p>A line break is a syntactical element, too.  Every command argument can
+be followed by whitespace, a comment, or a newline character.  Thus a
+<em class="dfn">syntactical line break</em> is defined to consist of optional
+syntactical space that is optionally followed by a comment, and a
+newline character.
+</p>
+<p>The normal commands, those for positioning and text, consist of a single
+letter taking a fixed number of arguments.  For historical reasons, the
+parser allows stacking of such commands on the same line, but
+fortunately, in <code class="code">gtroff</code>&rsquo;s intermediate output, every command with
+at least one argument is followed by a line break, thus providing
+excellent readability.
+</p>
+<p>The other commands&mdash;those for drawing and device controlling&mdash;have a
+more complicated structure; some recognize long command names, and some
+take a variable number of arguments.  So all &lsquo;<samp class="samp">D</samp>&rsquo; and &lsquo;<samp class="samp">x</samp>&rsquo;
+commands were designed to request a syntactical line break after their
+last argument.  Only one command, &lsquo;<samp class="samp">x&nbsp;X</samp>&rsquo;, has an argument that
+can span several input lines; all other commands must have all of
+their arguments on the same line as the command, i.e., the arguments may
+not be split by a line break.
+</p>
+<p>Empty lines (these are lines containing only space and/or a comment),
+can occur everywhere.  They are just ignored.
+</p>
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Argument-Units">
+<div class="nav-panel">
+<p>
+Next: <a href="#Document-Parts" accesskey="n" rel="next">Document Parts</a>, Previous: <a href="#Separation" accesskey="p" rel="prev">Separation</a>, Up: <a href="#Language-Concepts" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Argument-Units-1">6.1.1.2 Argument Units</h4>
+
+<p>Some commands take integer arguments that are assumed to represent
+values in a measurement unit, but the letter for the corresponding
+scaling unit is not written with the output command arguments.  Most
+commands assume the scaling unit &lsquo;<samp class="samp">u</samp>&rsquo;, the basic unit of the device,
+some use &lsquo;<samp class="samp">z</samp>&rsquo;, the scaled point unit of the device, while others,
+such as the color commands, expect plain integers.
+</p>
+<p>Single characters can have the eighth bit set, as can the names of
+fonts and special characters.  The names of characters and fonts can be
+of arbitrary length.  A character that is to be printed is always in
+the current font.
+</p>
+<p>A string argument is always terminated by the next whitespace character
+(space, tab, or newline); an embedded &lsquo;<samp class="samp">#</samp>&rsquo; character is regarded as
+part of the argument, not as the beginning of a comment command.  An
+integer argument is already terminated by the next non-digit character,
+which then is regarded as the first character of the next argument or
+command.
+</p>
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Document-Parts">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Argument-Units" accesskey="p" rel="prev">Argument Units</a>, Up: <a href="#Language-Concepts" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Document-Parts-1">6.1.1.3 Document Parts</h4>
+
+<p>A correct intermediate output document consists of two parts, the
+<em class="dfn">prologue</em> and the <em class="dfn">body</em>.
+</p>
+<p>The task of the prologue is to set the general device parameters using
+three exactly specified commands.  <code class="code">gtroff</code>&rsquo;s prologue is
+guaranteed to consist of the following three lines (in that order):
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">x T <var class="var">device</var>
+x res <var class="var">n</var> <var class="var">h</var> <var class="var">v</var>
+x init
+</pre></div></div>
+
+<p>with the arguments set as outlined in <a class="ref" href="#Device-Control-Commands">Device Control Commands</a>.
+The parser for the intermediate output format is able to interpret
+additional whitespace and comments as well even in the prologue.
+</p>
+<p>The body is the main section for processing the document data.
+Syntactically, it is a sequence of any commands different from the ones
+used in the prologue.  Processing is terminated as soon as the first
+&lsquo;<samp class="samp">x&nbsp;stop</samp>&rsquo; command is encountered; the last line of any
+<code class="code">gtroff</code> intermediate output always contains such a command.
+</p>
+<p>Semantically, the body is page oriented.  A new page is started by a
+&lsquo;<samp class="samp">p</samp>&rsquo; command.  Positioning, writing, and drawing commands are always
+done within the current page, so they cannot occur before the first
+&lsquo;<samp class="samp">p</samp>&rsquo; command.  Absolute positioning (by the &lsquo;<samp class="samp">H</samp>&rsquo; and &lsquo;<samp class="samp">V</samp>&rsquo;
+commands) is done relative to the current page; all other positioning is
+done relative to the current location within this page.
+</p>
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="Command-Reference">
+<div class="nav-panel">
+<p>
+Next: <a href="#Intermediate-Output-Examples" accesskey="n" rel="next">Intermediate Output Examples</a>, Previous: <a href="#Language-Concepts" accesskey="p" rel="prev">Language Concepts</a>, Up: <a href="#gtroff-Output" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Command-Reference-1">6.1.2 Command Reference</h4>
+
+<p>This section describes all intermediate output commands, both from
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> as well as the <code class="code">gtroff</code> extensions.
+</p>
+
+<ul class="mini-toc">
+<li><a href="#Comment-Command" accesskey="1">Comment Command</a></li>
+<li><a href="#Simple-Commands" accesskey="2">Simple Commands</a></li>
+<li><a href="#Graphics-Commands" accesskey="3">Graphics Commands</a></li>
+<li><a href="#Device-Control-Commands" accesskey="4">Device Control Commands</a></li>
+<li><a href="#Obsolete-Command" accesskey="5">Obsolete Command</a></li>
+</ul>
+<hr>
+<div class="subsubsection-level-extent" id="Comment-Command">
+<div class="nav-panel">
+<p>
+Next: <a href="#Simple-Commands" accesskey="n" rel="next">Simple Commands</a>, Previous: <a href="#Command-Reference" accesskey="p" rel="prev">Command Reference</a>, Up: <a href="#Command-Reference" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Comment-Command-1">6.1.2.1 Comment Command</h4>
+
+<dl class="table">
+<dt><code class="code">#<var class="var">anything</var>&lsaquo;<span class="r">end of line</span>&rsaquo;</code></dt>
+<dd><p>A comment.  Ignore any characters from the &lsquo;<samp class="samp">#</samp>&rsquo; character up to the
+next newline character.
+</p>
+<p>This command is the only possibility for commenting in the intermediate
+output.  Each comment can be preceded by arbitrary syntactical space;
+every command can be terminated by a comment.
+</p></dd>
+</dl>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Simple-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="#Graphics-Commands" accesskey="n" rel="next">Graphics Commands</a>, Previous: <a href="#Comment-Command" accesskey="p" rel="prev">Comment Command</a>, Up: <a href="#Command-Reference" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Simple-Commands-1">6.1.2.2 Simple Commands</h4>
+
+<p>The commands in this subsection have a command code consisting of a
+single character, taking a fixed number of arguments.  Most of them are
+commands for positioning and text writing.  These commands are tolerant
+of whitespace.  Optionally, syntactical space can be inserted before,
+after, and between the command letter and its arguments.  All of these
+commands are stackable; i.e., they can be preceded by other simple
+commands or followed by arbitrary other commands on the same line.  A
+separating syntactical space is necessary only when two integer
+arguments would clash or if the preceding argument ends with a string
+argument.
+</p>
+<dl class="table">
+<dt><code class="code">C <var class="var">id</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset the glyph of the special character <var class="var">id</var>.  Trailing
+syntactical space is necessary to allow special character names of
+arbitrary length.  The drawing position is not advanced.
+</p>
+</dd>
+<dt><code class="code">c <var class="var">g</var></code></dt>
+<dd><p>Typeset the glyph of the ordinary character&nbsp;<var class="var">c</var>.  The drawing
+position is not advanced.
+</p>
+</dd>
+<dt><code class="code">f <var class="var">n</var></code></dt>
+<dd><p>Select the font mounted at position&nbsp;<var class="var">n</var>.  <var class="var">n</var>&nbsp;cannot
+be negative.
+</p>
+</dd>
+<dt><code class="code">H <var class="var">n</var></code></dt>
+<dd><p>Horizontally move the drawing position to <var class="var">n</var>&nbsp;basic units from
+the left edge of the page.  <var class="var">n</var>&nbsp;cannot be negative.
+</p>
+</dd>
+<dt><code class="code">h <var class="var">n</var></code></dt>
+<dd><p>Move the drawing position right <var class="var">n</var> basic units.  <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> allowed negative <var class="var">n</var>; GNU <code class="code">troff</code> does not produce
+such values, but <code class="code">groff</code>&rsquo;s output driver library handles them.
+</p>
+</dd>
+<dt><code class="code">m <var class="var">color-scheme</var> <span class="r"></span><var class="var">component</var> &hellip;<span class="r"></span></code></dt>
+<dd><p>Select the stroke color using the <var class="var">component</var>s in the color space
+<var class="var">scheme</var>.  Each <var class="var">component</var> is an integer between 0 and 65535.
+The quantity of components and their meanings vary with each
+<var class="var">scheme</var>.  This command is a <code class="code">groff</code> extension.
+</p>
+<dl class="table">
+<dt><code class="code">mc <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var></code></dt>
+<dd><p>Use the CMY color scheme with components cyan, magenta, and yellow.
+</p>
+</dd>
+<dt><code class="code">md</code></dt>
+<dd><p>Use the default color (no components; black in most cases).
+</p>
+</dd>
+<dt><code class="code">mg <var class="var">gray</var></code></dt>
+<dd><p>Use a grayscale color scheme with a component ranging between 0 (black)
+and 65535 (white).
+</p>
+</dd>
+<dt><code class="code">mk <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var> <var class="var">black</var></code></dt>
+<dd><p>Use the CMYK color scheme with components cyan, magenta, yellow, and
+black.
+</p>
+</dd>
+<dt><code class="code">mr <var class="var">red</var> <var class="var">green</var> <var class="var">blue</var></code></dt>
+<dd><p>Use the RGB color scheme with components red, green, and blue.
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">N <var class="var">n</var></code></dt>
+<dd><p>Typeset the glyph with index&nbsp;<var class="var">n</var> in the current font.
+<var class="var">n</var>&nbsp;is normally a non-negative integer.  The drawing position
+is not advanced.  The <code class="code">html</code> and <code class="code">xhtml</code> devices use this
+command with negative&nbsp;<var class="var">n</var> to produce unbreakable space; the
+absolute value of <var class="var">n</var> is taken and interpreted in basic units.
+</p>
+</dd>
+<dt><code class="code">n <var class="var">b</var> <var class="var">a</var></code></dt>
+<dd><p>Indicate a break.  No action is performed; the command is present to
+make the output more easily parsed.  The integers <var class="var">b</var>
+and&nbsp;<var class="var">a</var> describe the vertical space amounts before and after
+the break, respectively.  GNU <code class="code">troff</code> issues this command but
+<code class="code">groff</code>&rsquo;s output driver library ignores it.  See <code class="code">v</code> and
+<code class="code">V</code> below.
+</p>
+</dd>
+<dt><code class="code">p <var class="var">n</var></code></dt>
+<dd><p>Begin a new page, setting its number to&nbsp;<var class="var">n</var>.  Each page is
+independent, even from those using the same number.  The vertical
+drawing position is set to&nbsp;0.  All positioning, writing, and
+drawing commands are interpreted in the context of a page, so a
+<code class="code">p</code>&nbsp;command must precede them.
+</p>
+</dd>
+<dt><code class="code">s <var class="var">n</var></code></dt>
+<dd><p>Set type size to <var class="var">n</var> scaled points (unit&nbsp;<code class="code">z</code> in GNU
+<code class="code">troff</code>.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> used unscaled points <code class="code">p</code> instead;
+see <a class="ref" href="#Output-Language-Compatibility">Output Language Compatibility</a>.
+</p>
+</dd>
+<dt><code class="code">t <var class="var">xyz</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dt><code class="code">t <var class="var">xyz</var> <var class="var">dummy-arg</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset a word <var class="var">xyz</var>; that is, set a sequence of ordinary glyphs
+named <var class="var">x</var>, <var class="var">y</var>, <var class="var">z</var>, &hellip;, terminated by a space
+character or a line break; an optional second integer argument is
+ignored (this allows the formatter to generate an even number of
+arguments). Each glyph is set at the current drawing position, and the position is
+then advanced horizontally by the glyph&rsquo;s width.  A glyph&rsquo;s width is
+read from its metrics in the font description file, scaled to the
+current type size, and rounded to a multiple of the horizontal motion
+quantum.  Use the <code class="code">C</code> command to emplace glyphs of special
+characters.  The <code class="code">t</code>&nbsp;command is a <code class="code">groff</code> extension and
+is output only for devices whose <samp class="file">DESC</samp> file contains the
+<code class="code">tcommand</code> directive; see <a class="ref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>.
+</p>
+</dd>
+<dt><code class="code">u <var class="var">n</var> <var class="var">xyz</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset word <var class="var">xyz</var> with track kerning.  As <code class="code">t</code>, but after
+placing each glyph, the drawing position is further advanced
+horizontally by&nbsp;<var class="var">n</var> basic units (<code class="code">u</code>).  The
+<code class="code">u</code>&nbsp;command is a <code class="code">groff</code> extension and is output only for
+devices whose <samp class="file">DESC</samp> file contains the <code class="code">tcommand</code> directive;
+see <a class="ref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>.
+</p>
+</dd>
+<dt><code class="code">V <var class="var">n</var></code></dt>
+<dd><p>Vertically move the drawing position to <var class="var">n</var>&nbsp;basic units from
+the top edge of the page.  <var class="var">n</var>&nbsp;cannot be negative.
+</p>
+</dd>
+<dt><code class="code">v <var class="var">n</var></code></dt>
+<dd><p>Move the drawing position down <var class="var">n</var> basic units.  <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> allowed negative <var class="var">n</var>; GNU <code class="code">troff</code> does not produce
+such values, but <code class="code">groff</code>&rsquo;s output driver library handles them.
+</p>
+</dd>
+<dt><code class="code">w</code></dt>
+<dd><p>Indicate an inter-word space.  No action is performed; the command is
+present to make the output more easily parsed.  Only adjustable,
+breakable inter-word spaces are thus described; those resulting from
+<code class="code">\~</code> or horizontal motion escape sequences are not.  GNU
+<code class="code">troff</code> issues this command but <code class="code">groff</code>&rsquo;s output driver
+library ignores it.  See <code class="code">h</code> and <code class="code">H</code> above.
+</p></dd>
+</dl>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Graphics-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="#Device-Control-Commands" accesskey="n" rel="next">Device Control Commands</a>, Previous: <a href="#Simple-Commands" accesskey="p" rel="prev">Simple Commands</a>, Up: <a href="#Command-Reference" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Graphics-Commands-1">6.1.2.3 Graphics Commands</h4>
+
+<p>Each graphics or drawing command in the intermediate output starts with
+the letter &lsquo;<samp class="samp">D</samp>&rsquo;, followed by one or two characters that specify a
+subcommand; this is followed by a fixed or variable number of integer
+arguments that are separated by a single space character.  A &lsquo;<samp class="samp">D</samp>&rsquo;
+command may not be followed by another command on the same line (apart
+from a comment), so each &lsquo;<samp class="samp">D</samp>&rsquo; command is terminated by a syntactical
+line break.
+</p>
+<p><code class="code">gtroff</code> output follows the classical spacing rules (no space
+between command and subcommand, all arguments are preceded by a single
+space character), but the parser allows optional space between the
+command letters and makes the space before the first argument optional.
+As usual, each space can be any sequence of tab and space characters.
+</p>
+<p>Some graphics commands can take a variable number of arguments.  In this
+case, they are integers representing a size measured in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;.  The arguments called <var class="var">h1</var>, <var class="var">h2</var>, &hellip;, <var class="var">hn</var>
+stand for horizontal distances where positive means right, negative
+left.  The arguments called <var class="var">v1</var>, <var class="var">v2</var>, &hellip;, <var class="var">vn</var> stand
+for vertical distances where positive means down, negative up.  All
+these distances are offsets relative to the current location.
+</p>
+<p>Each graphics command directly corresponds to a similar <code class="code">gtroff</code>
+<code class="code">\D</code> escape sequence.  See <a class="xref" href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a>.
+</p>
+<p>Unknown &lsquo;<samp class="samp">D</samp>&rsquo; commands are assumed to be device-specific.  Its
+arguments are parsed as strings; the whole information is then sent to
+the postprocessor.
+</p>
+<p>In the following command reference, the syntax element &lsaquo;<span class="r">line
+break</span>&rsaquo; means a syntactical line break as defined above.
+</p>
+<dl class="table">
+<dt><code class="code">D~ <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw B-spline from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>), then
+to offset (<var class="var">h2</var>,<var class="var">v2</var>), if given, etc., up to
+(<var class="var">hn</var>,<var class="var">vn</var>).  This command takes a variable number of argument
+pairs; the current position is moved to the terminal point of the drawn
+curve.
+</p>
+</dd>
+<dt><code class="code">Da <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw arc from current position to
+(<var class="var">h1</var>,<var class="var">v1</var>)<em class="math">+</em>(<var class="var">h2</var>,<var class="var">v2</var>) with center at
+(<var class="var">h1</var>,<var class="var">v1</var>); then move the current position to the final point
+of the arc.
+</p>
+</dd>
+<dt><code class="code">DC <var class="var">d</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dt><code class="code">DC <var class="var">d</var> <var class="var">dummy-arg</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid circle using the current fill color with
+diameter&nbsp;<var class="var">d</var> (integer in basic units &lsquo;<samp class="samp">u</samp>&rsquo;) with leftmost
+point at the current position; then move the current position to the
+rightmost point of the circle.  An optional second integer argument is
+ignored (this allows the formatter to generate an even number of
+arguments).  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dc <var class="var">d</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw circle line with diameter&nbsp;<var class="var">d</var> (integer in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;) with leftmost point at the current position; then move the
+current position to the rightmost point of the circle.
+</p>
+</dd>
+<dt><code class="code">DE <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid ellipse in the current fill color with a horizontal
+diameter of&nbsp;<var class="var">h</var> and a vertical diameter of&nbsp;<var class="var">v</var> (both
+integers in basic units &lsquo;<samp class="samp">u</samp>&rsquo;) with the leftmost point at the current
+position; then move to the rightmost point of the ellipse.  This command
+is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">De <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw an outlined ellipse with a horizontal diameter of&nbsp;<var class="var">h</var> and
+a vertical diameter of&nbsp;<var class="var">v</var> (both integers in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;) with the leftmost point at current position; then move to the
+rightmost point of the ellipse.
+</p>
+</dd>
+<dt><code class="code">DF <var class="var">color-scheme</var> <span class="r"></span><var class="var">component</var> &hellip;<span class="r"></span>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using different color schemes;
+the analogous command for setting the color of text, line graphics, and
+the outline of graphic objects is &lsquo;<samp class="samp">m</samp>&rsquo;.  The color components are
+specified as integer arguments between 0 and 65535.  The number of color
+components and their meaning vary for the different color schemes.
+These commands are generated by <code class="code">gtroff</code>&rsquo;s escape sequences
+&lsquo;<samp class="samp">\D'F &hellip;'</samp>&rsquo; and <code class="code">\M</code> (with no other corresponding
+graphics commands).  No position changing.  This command is a
+<code class="code">gtroff</code> extension.
+</p>
+<dl class="table">
+<dt><code class="code">DFc <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the CMY color scheme,
+having the 3&nbsp;color components <var class="var">cyan</var>, <var class="var">magenta</var>, and
+<var class="var">yellow</var>.
+</p>
+</dd>
+<dt><code class="code">DFd&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects to the default fill color value
+(black in most cases).  No component arguments.
+</p>
+</dd>
+<dt><code class="code">DFg <var class="var">gray</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects to the shade of gray given by
+the argument, an integer between 0 (black) and 65535 (white).
+</p>
+</dd>
+<dt><code class="code">DFk <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var> <var class="var">black</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the CMYK color scheme,
+having the 4&nbsp;color components <var class="var">cyan</var>, <var class="var">magenta</var>,
+<var class="var">yellow</var>, and <var class="var">black</var>.
+</p>
+</dd>
+<dt><code class="code">DFr <var class="var">red</var> <var class="var">green</var> <var class="var">blue</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the RGB color scheme,
+having the 3&nbsp;color components <var class="var">red</var>, <var class="var">green</var>, and
+<var class="var">blue</var>.
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">Df <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The argument&nbsp;<var class="var">n</var> must be an integer in the range <em class="math">-32767</em>
+to 32767.
+</p>
+<dl class="table">
+<dt><em class="math">0 &le; <var class="var">n</var> &le; 1000</em></dt>
+<dd><p>Set the color for filling solid drawing objects to a shade of gray,
+where 0 corresponds to solid white, 1000 (the default) to solid black,
+and values in between to intermediate shades of gray; this is obsoleted
+by command &lsquo;<samp class="samp">DFg</samp>&rsquo;.
+</p>
+</dd>
+<dt><em class="math"><var class="var">n</var> &lt; 0</em> or <em class="math"><var class="var">n</var> &gt; 1000</em></dt>
+<dd><p>Set the filling color to the color that is currently being used for the
+text and the outline, see command &lsquo;<samp class="samp">m</samp>&rsquo;.  For example, the command
+sequence
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">mg 0 0 65535
+Df -1
+</pre></div></div>
+
+<p>sets all colors to blue.
+</p></dd>
+</dl>
+
+<p>No position changing.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dl <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw line from current position to offset (<var class="var">h</var>,<var class="var">v</var>) (integers in
+basic units &lsquo;<samp class="samp">u</samp>&rsquo;); then set current position to the end of the drawn
+line.
+</p>
+</dd>
+<dt><code class="code">Dp <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a polygon line from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>),
+from there to offset (<var class="var">h2</var>,<var class="var">v2</var>), etc., up to offset
+(<var class="var">hn</var>,<var class="var">vn</var>), and from there back to the starting position.  For
+historical reasons, the position is changed by adding the sum of all
+arguments with odd index to the actual horizontal position and the even
+ones to the vertical position.  Although this doesn&rsquo;t make sense it is
+kept for compatibility.
+This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">DP <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid polygon in the current fill color rather than an outlined
+polygon, using the same arguments and positioning as the corresponding
+&lsquo;<samp class="samp">Dp</samp>&rsquo; command.
+This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dt <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set the current line thickness to&nbsp;<var class="var">n</var> (an integer in basic
+units &lsquo;<samp class="samp">u</samp>&rsquo;) if <em class="math"><var class="var">n</var>&gt;0</em>; if <em class="math"><var class="var">n</var>=0</em> select the
+smallest available line thickness; if <em class="math"><var class="var">n</var>&lt;0</em> set the line
+thickness proportional to the type size (this is the default before the
+first &lsquo;<samp class="samp">Dt</samp>&rsquo; command was specified).  For historical reasons, the
+horizontal position is changed by adding the argument to the actual
+horizontal position, while the vertical position is not changed.
+Although this doesn&rsquo;t make sense it is kept for compatibility.
+This command is a <code class="code">gtroff</code> extension.
+</p></dd>
+</dl>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Device-Control-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="#Obsolete-Command" accesskey="n" rel="next">Obsolete Command</a>, Previous: <a href="#Graphics-Commands" accesskey="p" rel="prev">Graphics Commands</a>, Up: <a href="#Command-Reference" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Device-Control-Commands-1">6.1.2.4 Device Control Commands</h4>
+
+<p>Each device control command starts with the letter &lsquo;<samp class="samp">x</samp>&rsquo;, followed by
+a space character (optional or arbitrary space or tab in <code class="code">gtroff</code>)
+and a subcommand letter or word; each argument (if any) must be preceded
+by a syntactical space.  All &lsquo;<samp class="samp">x</samp>&rsquo; commands are terminated by a
+syntactical line break; no device control command can be followed by
+another command on the same line (except a comment).
+</p>
+<p>The subcommand is basically a single letter, but to increase
+readability, it can be written as a word, i.e., an arbitrary sequence of
+characters terminated by the next tab, space, or newline character.  All
+characters of the subcommand word but the first are simply ignored.  For
+example, <code class="code">gtroff</code> outputs the initialization command &lsquo;<samp class="samp">x&nbsp;i</samp>&rsquo;
+as &lsquo;<samp class="samp">x&nbsp;init</samp>&rsquo; and the resolution command &lsquo;<samp class="samp">x&nbsp;r</samp>&rsquo; as
+&lsquo;<samp class="samp">x&nbsp;res</samp>&rsquo;.
+</p>
+<p>In the following, the syntax element &lsaquo;<span class="r">line break</span>&rsaquo; means a
+syntactical line break (see <a class="pxref" href="#Separation">Separation</a>).
+</p>
+<dl class="table">
+<dt><code class="code">xF <var class="var">name</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">F</samp>&rsquo; stands for <var class="var">Filename</var>.
+</p>
+<p>Use <var class="var">name</var> as the intended name for the current file in error
+reports.  This is useful for remembering the original file name when
+<code class="code">gtroff</code> uses an internal piping mechanism.  The input file is not
+changed by this command.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">xf <var class="var">n</var> <var class="var">s</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">f</samp>&rsquo; stands for <var class="var">font</var>.
+</p>
+<p>Mount font position&nbsp;<var class="var">n</var> (a non-negative integer) with font
+named&nbsp;<var class="var">s</var> (a text word).  See <a class="xref" href="#Font-Positions">Font Positions</a>.
+</p>
+</dd>
+<dt><code class="code">xH <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">H</samp>&rsquo; stands for <var class="var">Height</var>.
+</p>
+<p>Set glyph height to&nbsp;<var class="var">n</var> (a positive integer in scaled points
+&lsquo;<samp class="samp">z</samp>&rsquo;).  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> uses the unit points (&lsquo;<samp class="samp">p</samp>&rsquo;)
+instead.  See <a class="xref" href="#Output-Language-Compatibility">Output Language Compatibility</a>.
+</p>
+</dd>
+<dt><code class="code">xi&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">i</samp>&rsquo; stands for <var class="var">init</var>.
+</p>
+<p>Initialize device.  This is the third command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xp&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">p</samp>&rsquo; stands for <var class="var">pause</var>.
+</p>
+<p>Parsed but ignored.  The <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual documents
+this command as
+</p>
+<div class="display">
+<pre class="display-preformatted">pause device, can be restarted
+</pre></div>
+
+<p>but GNU <code class="code">troff</code> output drivers do nothing with this command.
+</p>
+</dd>
+<dt><code class="code">xr <var class="var">n</var> <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">r</samp>&rsquo; stands for <var class="var">resolution</var>.
+</p>
+<p>Resolution is&nbsp;<var class="var">n</var>, while <var class="var">h</var> is the minimal horizontal
+motion, and <var class="var">v</var> the minimal vertical motion possible with this
+device; all arguments are positive integers in basic units &lsquo;<samp class="samp">u</samp>&rsquo; per
+inch.  This is the second command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xS <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">S</samp>&rsquo; stands for <var class="var">Slant</var>.
+</p>
+<p>Set slant to&nbsp;<var class="var">n</var> (an integer in basic units &lsquo;<samp class="samp">u</samp>&rsquo;).
+</p>
+</dd>
+<dt><code class="code">xs&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">s</samp>&rsquo; stands for <var class="var">stop</var>.
+</p>
+<p>Terminates the processing of the current file; issued as the last
+command of any intermediate <code class="code">troff</code> output.
+</p>
+</dd>
+<dt><code class="code">xt&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">t</samp>&rsquo; stands for <var class="var">trailer</var>.
+</p>
+<p>Generate trailer information, if any.  In GNU <code class="code">troff</code>, this is
+ignored.
+</p>
+</dd>
+<dt><code class="code">xT <var class="var">xxx</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">T</samp>&rsquo; stands for <var class="var">Typesetter</var>.
+</p>
+<p>Set the name of the output driver to <var class="var">xxx</var>, a sequence of
+non-whitespace characters terminated by whitespace.  The possible names
+correspond to those of <code class="code">groff</code>&rsquo;s <samp class="option">-T</samp> option.  This is the
+first command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xu <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">u</samp>&rsquo; stands for <var class="var">underline</var>.
+</p>
+<p>Configure underlining of spaces.  If <var class="var">n</var> is&nbsp;1, start
+underlining of spaces; if <var class="var">n</var> is&nbsp;0, stop underlining of spaces.
+This is needed for the <code class="code">cu</code> request in <code class="code">nroff</code> mode and is
+ignored otherwise.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">xX <var class="var">anything</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">x</samp>&rsquo; stands for <var class="var">X-escape</var>.
+</p>
+<p>Send string <var class="var">anything</var> uninterpreted to the device.  If the line
+following this command starts with a &lsquo;<samp class="samp">+</samp>&rsquo; character this line is
+interpreted as a continuation line in the following sense.  The &lsquo;<samp class="samp">+</samp>&rsquo;
+is ignored, but a newline character is sent instead to the device, the
+rest of the line is sent uninterpreted.  The same applies to all
+following lines until the first character of a line is not a &lsquo;<samp class="samp">+</samp>&rsquo;
+character.  This command is generated by the <code class="code">gtroff</code> escape
+sequence <code class="code">\X</code>.  The line-continuing feature is a <code class="code">gtroff</code>
+extension.
+</p></dd>
+</dl>
+
+<hr>
+</div>
+<div class="subsubsection-level-extent" id="Obsolete-Command">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Device-Control-Commands" accesskey="p" rel="prev">Device Control Commands</a>, Up: <a href="#Command-Reference" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsubsection" id="Obsolete-Command-1">6.1.2.5 Obsolete Command</h4>
+<p>In <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output, the writing of a single glyph is
+mostly done by a very strange command that combines a horizontal move
+and a single character giving the glyph name.  It doesn&rsquo;t have a command
+code, but is represented by a 3-character argument consisting of exactly
+2&nbsp;digits and a character.
+</p>
+<dl class="table">
+<dt><var class="var">dd</var><var class="var">g</var></dt>
+<dd><p>Move right <var class="var">dd</var> (exactly two decimal digits) basic units &lsquo;<samp class="samp">u</samp>&rsquo;,
+then print glyph&nbsp;<var class="var">g</var> (represented as a single character).
+</p>
+<p>In GNU <code class="code">troff</code>, arbitrary syntactical space around and within this
+command is allowed.  Only when a preceding command on the same line ends
+with an argument of variable length is a separating space obligatory.
+In <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, large clusters of these and other
+commands are used, mostly without spaces; this made such output almost
+unreadable.
+</p></dd>
+</dl>
+
+<p>For modern high-resolution devices, this command does not make sense
+because the width of the glyphs can become much larger than two decimal
+digits.  In <code class="code">gtroff</code>, this is only used for the devices <code class="code">X75</code>,
+<code class="code">X75-12</code>, <code class="code">X100</code>, and <code class="code">X100-12</code>.  For other devices, the
+commands &lsquo;<samp class="samp">t</samp>&rsquo; and &lsquo;<samp class="samp">u</samp>&rsquo; provide a better functionality.
+</p>
+
+<hr>
+</div>
+</div>
+<div class="subsection-level-extent" id="Intermediate-Output-Examples">
+<div class="nav-panel">
+<p>
+Next: <a href="#Output-Language-Compatibility" accesskey="n" rel="next">Output Language Compatibility</a>, Previous: <a href="#Command-Reference" accesskey="p" rel="prev">Command Reference</a>, Up: <a href="#gtroff-Output" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Intermediate-Output-Examples-1">6.1.3 Intermediate Output Examples</h4>
+
+<p>This section presents the intermediate output generated from the same
+input for three different devices.  The input is the sentence &lsquo;<samp class="samp">hell
+world</samp>&rsquo; fed into <code class="code">gtroff</code> on the command line.
+</p>
+<dl class="table">
+<dt>High-resolution device <code class="code">ps</code></dt>
+<dd>
+<p>This is the standard output of <code class="code">gtroff</code> if no <samp class="option">-T</samp> option is
+given.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">shell&gt; echo &quot;hell world&quot; | groff -Z -T ps
+
+x T ps
+x res 72000 1 1
+x init
+</pre></div><pre class="example-preformatted">p1
+x font 5 TR
+f5
+s10000
+V12000
+H72000
+thell
+wh2500
+tw
+H96620
+torld
+n12000 0
+</pre><div class="group"><pre class="example-preformatted">x trailer
+V792000
+x stop
+</pre></div></div>
+
+<p>This output can be fed into <code class="code">grops</code> to get its representation as a
+PostScript file.
+</p>
+</dd>
+<dt>Low-resolution device <code class="code">latin1</code></dt>
+<dd>
+<p>This is similar to the high-resolution device except that the
+positioning is done at a minor scale.  Some comments (lines starting
+with &lsquo;<samp class="samp">#</samp>&rsquo;) were added for clarification; they were not generated by
+the formatter.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">shell&gt; echo &quot;hell world&quot; | groff -Z -T latin1
+
+# prologue
+x T latin1
+x res 240 24 40
+x init
+</pre></div><pre class="example-preformatted"># begin a new page
+p1
+# font setup
+x font 1 R
+f1
+s10
+# initial positioning on the page
+V40
+H0
+# write text 'hell'
+thell
+# inform about space, and issue a horizontal jump
+wh24
+# write text 'world'
+tworld
+# announce line break, but do nothing because...
+n40 0
+</pre><div class="group"><pre class="example-preformatted"># ...the end of the document has been reached
+x trailer
+V2640
+x stop
+</pre></div></div>
+
+<p>This output can be fed into <code class="code">grotty</code> to get a formatted text
+document.
+</p>
+</dd>
+<dt><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output</dt>
+<dd><p>Since a computer monitor has a much lower resolution than modern
+printers, the intermediate output for X11 devices can use the
+jump-and-write command with its 2-digit displacements.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">shell&gt; echo &quot;hell world&quot; | groff -Z -T X100
+
+x T X100
+x res 100 1 1
+x init
+</pre></div><pre class="example-preformatted">p1
+x font 5 TR
+f5
+s10
+V16
+H100
+# write text with jump-and-write commands
+ch07e07l03lw06w11o07r05l03dh7
+n16 0
+</pre><div class="group"><pre class="example-preformatted">x trailer
+V1100
+x stop
+</pre></div></div>
+
+<p>This output can be fed into <code class="code">xditview</code> or <code class="code">gxditview</code> for
+displaying in&nbsp;X.
+</p>
+<p>Due to the obsolete jump-and-write command, the text clusters in the
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output are almost unreadable.
+</p></dd>
+</dl>
+
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Output-Language-Compatibility">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Intermediate-Output-Examples" accesskey="p" rel="prev">Intermediate Output Examples</a>, Up: <a href="#gtroff-Output" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Output-Language-Compatibility-1">6.1.4 Output Language Compatibility</h4>
+
+<p>The intermediate output language of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> was
+first documented in <cite class="cite">A Typesetter-independent TROFF</cite>, by Brian
+Kernighan, and by 1992 the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual was
+updated to incorprate a description of it.
+</p>
+<p>The GNU <code class="code">troff</code> intermediate output format is compatible with this
+specification except for the following features.
+</p>
+<ul class="itemize mark-bullet">
+<li>The classical quasi-device independence is not yet implemented.
+
+</li><li>The old hardware was very different from what we use today.  So the
+<code class="code">groff</code> devices are also fundamentally different from the ones
+in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  For example, the <abbr class="acronym">AT&amp;T</abbr>
+PostScript device is called <code class="code">post</code> and has a resolution of only 720
+units per inch, suitable for printers 20 years ago, while <code class="code">groff</code>&rsquo;s
+<code class="code">ps</code> device has a resolution of 72000 units per inch.  Maybe, by
+implementing some rescaling mechanism similar to the classical
+quasi-device independence, <code class="code">groff</code> could emulate <abbr class="acronym">AT&amp;T</abbr>&rsquo;s
+<code class="code">post</code> device.
+
+</li><li>The B-spline command &lsquo;<samp class="samp">D~</samp>&rsquo; is correctly handled by the intermediate
+output parser, but the drawing routines aren&rsquo;t implemented in some of
+the postprocessor programs.
+
+</li><li>The argument of the commands &lsquo;<samp class="samp">s</samp>&rsquo; and &lsquo;<samp class="samp">x&nbsp;H</samp>&rsquo; has the
+implicit unit scaled point &lsquo;<samp class="samp">z</samp>&rsquo; in <code class="code">gtroff</code>, while
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> has point (&lsquo;<samp class="samp">p</samp>&rsquo;).  This isn&rsquo;t an
+incompatibility but a compatible extension, for both units coincide for
+all devices without a <code class="code">sizescale</code> parameter in the <samp class="file">DESC</samp>
+file, including all postprocessors from <abbr class="acronym">AT&amp;T</abbr> and
+<code class="code">groff</code>&rsquo;s text devices.  The few <code class="code">groff</code> devices with a
+<code class="code">sizescale</code> parameter either do not exist for <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, have a different name, or seem to have a different
+resolution.  So conflicts are very unlikely.
+
+</li><li>The position changing after the commands &lsquo;<samp class="samp">Dp</samp>&rsquo;, &lsquo;<samp class="samp">DP</samp>&rsquo;, and
+&lsquo;<samp class="samp">Dt</samp>&rsquo; is illogical, but as old versions of <code class="code">gtroff</code> used this
+feature it is kept for compatibility reasons.
+
+
+</li></ul>
+
+
+
+<hr>
+</div>
+</div>
+<div class="section-level-extent" id="Device-and-Font-Description-Files">
+<div class="nav-panel">
+<p>
+Previous: <a href="#gtroff-Output" accesskey="p" rel="prev"><code class="code">gtroff</code> Output</a>, Up: <a href="#File-Formats" accesskey="u" rel="up">File Formats</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h3 class="section" id="Device-and-Font-Description-Files-1">6.2 Device and Font Description Files</h3>
+<a class="index-entry-id" id="index-font-files"></a>
+<a class="index-entry-id" id="index-files_002c-font"></a>
+
+<p>The <code class="code">groff</code> font and output device description formats are slight
+extensions of those used by <abbr class="acronym">AT&amp;T</abbr> device-independent
+<code class="code">troff</code>.  In distinction to the <abbr class="acronym">AT&amp;T</abbr> implementation,
+<code class="code">groff</code> lacks a binary format; all files are text
+files.<a class="footnote" id="DOCF125" href="#FOOT125"><sup>125</sup></a>  The device and font description files for a device <var class="var">name</var>
+are stored in a <samp class="file">dev<var class="var">name</var></samp> directory.  The device description
+file is called <samp class="file">DESC</samp>, and, for each font supported by the device,
+a font description file is called&nbsp;<samp class="file"><var class="var">f</var></samp>, where
+<var class="var">f</var>&nbsp;is usually an abbreviation of a font&rsquo;s name and/or style.
+For example, the <code class="code">ps</code> (PostScript) device has <code class="code">groff</code> font
+description files for Times roman (<samp class="file">TR</samp>) and Zapf Chancery Medium
+italic (<samp class="file">ZCMI</samp>), among many others, while the <code class="code">utf8</code> device
+(for terminal emulators) has only font descriptions for the roman,
+italic, bold, and bold-italic styles (<samp class="file">R</samp>, <samp class="file">I</samp>, <samp class="file">B</samp>, and
+<samp class="file">BI</samp>, respectively).
+</p>
+<p>Device and font description files are read both by the formatter, GNU
+<code class="code">troff</code>, and by output drivers.  The programs delegate these files&rsquo;
+processing to an internal library, <samp class="file">libgroff</samp>, ensuring their
+consistent interpretation.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="#DESC-File-Format" accesskey="1"><samp class="file">DESC</samp> File Format</a></li>
+<li><a href="#Font-Description-File-Format" accesskey="2">Font Description File Format</a></li>
+</ul>
+<hr>
+<div class="subsection-level-extent" id="DESC-File-Format">
+<div class="nav-panel">
+<p>
+Next: <a href="#Font-Description-File-Format" accesskey="n" rel="next">Font Description File Format</a>, Previous: <a href="#Device-and-Font-Description-Files" accesskey="p" rel="prev">Device and Font Description Files</a>, Up: <a href="#Device-and-Font-Description-Files" accesskey="u" rel="up">Device and Font Description Files</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="DESC-File-Format-1">6.2.1 <samp class="file">DESC</samp> File Format</h4>
+<a class="index-entry-id" id="index-DESC-file-format"></a>
+<a class="index-entry-id" id="index-font-description-file-format"></a>
+<a class="index-entry-id" id="index-format-of-font-description-file"></a>
+
+<p>The <samp class="file">DESC</samp> file contains a series of directives; each begins a
+line.  Their order is not important, with two exceptions: (1) the
+<code class="code">res</code> directive must precede any <code class="code">papersize</code> directive; and
+(2) the <code class="code">charset</code> directive must come last (if at all).  If a
+directive name is repeated, later entries in the file override previous
+ones (except that the paper dimensions are computed based on the
+<code class="code">res</code> directive last seen when <code class="code">papersize</code> is encountered).
+Spaces and/or tabs separate words and are ignored at line boundaries.
+<a class="index-entry-id" id="index-comments-in-device-description-files"></a>
+<a class="index-entry-id" id="index-device-description-files_002c-comments"></a>
+<a class="index-entry-id" id="index-_0023"></a>
+Comments start with the &lsquo;<samp class="samp">#</samp>&rsquo; character and extend to the end of a
+line.  Empty lines are ignored.
+</p>
+<dl class="table">
+<dt id='index-family-1'><span><code class="code">family <var class="var">fam</var></code><a class="copiable-link" href='#index-family-1'> &para;</a></span></dt>
+<dd><p>The default font family is <var class="var">fam</var>.
+</p>
+</dd>
+<dt id='index-fonts-2'><span><code class="code">fonts <var class="var">n</var> <var class="var">F1</var> <span class="r">&hellip;</span> <var class="var">Fn</var></code><a class="copiable-link" href='#index-fonts-2'> &para;</a></span></dt>
+<dd><p>Fonts <var class="var">F1</var>, &hellip;, <var class="var">Fn</var> are mounted at font positions
+<var class="var">m</var>+1, &hellip;, <var class="var">m</var>+<var class="var">n</var> where <var class="var">m</var> is the number of
+<code class="code">styles</code> (see below).  This directive may extend over more than one
+line.  A font name of&nbsp;<code class="code">0</code> causes no font to be mounted at the
+corresponding position.
+</p>
+</dd>
+<dt id='index-hor'><span><code class="code">hor <var class="var">n</var></code><a class="copiable-link" href='#index-hor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-horizontal-motion-quantum"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-horizontal"></a>
+<a class="index-entry-id" id="index-quantum_002c-horizontal-motion"></a>
+<a class="index-entry-id" id="index-horizontal-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-horizontal"></a>
+<p>The horizontal motion quantum is <var class="var">n</var>&nbsp;basic units.  All
+horizontal quantities are rounded to multiples of&nbsp;<var class="var">n</var>.
+</p>
+</dd>
+<dt id='index-image_005fgenerator'><span><code class="code">image_generator <var class="var">program</var></code><a class="copiable-link" href='#index-image_005fgenerator'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PostScript_002c-PNG-image-generation"></a>
+<a class="index-entry-id" id="index-PNG-image-generation-from-PostScript"></a>
+<p>Use <var class="var">program</var> to generate PNG images from PostScript input.  Under
+GNU/Linux, this is usually <code class="code">gs</code>, but under other systems (notably
+Cygwin) it might be set to another name.  The <code class="code">grohtml</code> driver uses
+this directive.
+</p>
+</dd>
+<dt id='index-paperlength'><span><code class="code">paperlength <var class="var">n</var></code><a class="copiable-link" href='#index-paperlength'> &para;</a></span></dt>
+<dd><p>The vertical dimension of the output medium is <var class="var">n</var>&nbsp;basic units
+(deprecated: use <code class="code">papersize</code> instead).
+</p>
+</dd>
+<dt id='index-papersize'><span><code class="code">papersize <var class="var">format-or-dimension-pair-or-file-name</var> <span class="r">&hellip;</span></code><a class="copiable-link" href='#index-papersize'> &para;</a></span></dt>
+<dd><p>The dimensions of the output medium are as according to the
+argument, which is either a standard paper format, a pair of dimensions,
+or the name of a plain text file containing either of the foregoing.
+</p>
+<p>Recognized paper formats are the ISO and DIN formats
+<code class="code">A0</code>&ndash;<code class="code">A7</code>, <code class="code">B0</code>&ndash;<code class="code">B7</code>, <code class="code">C0</code>&ndash;<code class="code">C7</code>,
+<code class="code">D0</code>&ndash;<code class="code">D7</code>; the U.S. paper types <code class="code">letter</code>,
+<code class="code">legal</code>, <code class="code">tabloid</code>, <code class="code">ledger</code>, <code class="code">statement</code>, and
+<code class="code">executive</code>; and the envelope formats <code class="code">com10</code>, <code class="code">monarch</code>,
+and <code class="code">DL</code>.  Matching is performed without regard for lettercase.
+</p>
+<p>Alternatively, the argument can be a custom paper format in the format
+<code class="code"><var class="var">length</var>,<var class="var">width</var></code> (with no spaces before or after the
+comma).  Both <var class="var">length</var> and <var class="var">width</var> must have a unit appended;
+valid units are &lsquo;<samp class="samp">i</samp>&rsquo; for inches, &lsquo;<samp class="samp">c</samp>&rsquo; for centimeters, &lsquo;<samp class="samp">p</samp>&rsquo;
+for points, and &lsquo;<samp class="samp">P</samp>&rsquo; for picas.  Example: &lsquo;<samp class="samp">12c,235p</samp>&rsquo;.  An
+argument that starts with a digit is always treated as a custom paper
+format.
+</p>
+<p>Finally, the argument can be a file name (e.g., <samp class="file">/etc/papersize</samp>);
+if the file can be opened, the first line is read and a match attempted
+against each of the other forms.  No comment syntax is supported.
+</p>
+<p>More than one argument can be specified;
+each is scanned in turn and the first valid paper specification used.
+</p>
+</dd>
+<dt id='index-paperwidth'><span><code class="code">paperwidth <var class="var">n</var></code><a class="copiable-link" href='#index-paperwidth'> &para;</a></span></dt>
+<dd><p>The horizontal dimension of the output medium is <var class="var">n</var>&nbsp;basic
+units (deprecated: use <code class="code">papersize</code> instead).
+</p>
+</dd>
+<dt id='index-pass_005ffilenames'><span><code class="code">pass_filenames</code><a class="copiable-link" href='#index-pass_005ffilenames'> &para;</a></span></dt>
+<dd><p>Direct GNU <code class="code">troff</code> to emit the name of the source file being
+processed.  This is achieved with the intermediate output command
+&lsquo;<samp class="samp">x F</samp>&rsquo;, which <code class="code">grohtml</code> interprets.
+</p>
+</dd>
+<dt id='index-postpro'><span><code class="code">postpro <var class="var">program</var></code><a class="copiable-link" href='#index-postpro'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as the postprocessor.
+</p>
+</dd>
+<dt id='index-prepro'><span><code class="code">prepro <var class="var">program</var></code><a class="copiable-link" href='#index-prepro'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as a preprocessor.  The <code class="code">html</code> and <code class="code">xhtml</code>
+output devices use this directive.
+</p>
+</dd>
+<dt id='index-print'><span><code class="code">print <var class="var">program</var></code><a class="copiable-link" href='#index-print'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as a spooler program for printing.  If omitted, the
+<samp class="option">-l</samp> and <samp class="option">-L</samp> options of <code class="code">groff</code> are ignored.
+</p>
+</dd>
+<dt id='index-res'><span><code class="code">res <var class="var">n</var></code><a class="copiable-link" href='#index-res'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-device-resolution-1"></a>
+<a class="index-entry-id" id="index-resolution_002c-device-1"></a>
+<p>The device resolution is <var class="var">n</var>&nbsp;basic units per inch.
+</p>
+</dd>
+<dt id='index-sizes'><span><code class="code">sizes <var class="var">s1</var> <span class="r">&hellip;</span> <var class="var">sn</var> 0</code><a class="copiable-link" href='#index-sizes'> &para;</a></span></dt>
+<dd><p>The device has fonts at <var class="var">s1</var>, &hellip;, <var class="var">sn</var> scaled points (see
+below).  The list of sizes must be terminated by&nbsp;<code class="code">0</code>.  Each
+<var class="var">si</var> can also be a range of sizes <var class="var">m</var>&ndash;<var class="var">n</var>.  The list can
+extend over more than one line.
+</p>
+</dd>
+<dt id='index-sizescale'><span><code class="code">sizescale <var class="var">n</var></code><a class="copiable-link" href='#index-sizescale'> &para;</a></span></dt>
+<dd><p>A typographical point is subdivided into <var class="var">n</var>&nbsp;scaled points.
+The default is&nbsp;<code class="code">1</code>.  See <a class="xref" href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a>.
+</p>
+</dd>
+<dt id='index-styles-2'><span><code class="code">styles <var class="var">S1</var> <span class="r">&hellip;</span> <var class="var">Sm</var></code><a class="copiable-link" href='#index-styles-2'> &para;</a></span></dt>
+<dd><p>The first&nbsp;<var class="var">m</var> mounting positions are associated with styles
+<var class="var">S1</var>, &hellip;, <var class="var">Sm</var>.
+</p>
+</dd>
+<dt id='index-tcommand'><span><code class="code">tcommand</code><a class="copiable-link" href='#index-tcommand'> &para;</a></span></dt>
+<dd><p>The postprocessor can handle the &lsquo;<samp class="samp">t</samp>&rsquo; and &lsquo;<samp class="samp">u</samp>&rsquo; intermediate
+output commands.
+</p>
+</dd>
+<dt id='index-unicode'><span><code class="code">unicode</code><a class="copiable-link" href='#index-unicode'> &para;</a></span></dt>
+<dd><p>The output device supports the complete Unicode repertoire.  This
+directive is useful only for devices that produce character entities
+instead of glyphs.
+</p>
+<p>If <code class="code">unicode</code> is present, no <code class="code">charset</code> section is required in
+the font description files since the Unicode handling built into
+<code class="code">groff</code> is used.  However, if there are entries in a font
+description file&rsquo;s <code class="code">charset</code> section, they either override the
+default mappings for those particular characters or add new mappings
+(normally for composite characters).
+</p>
+<p>The <code class="code">utf8</code>, <code class="code">html</code>, and <code class="code">xhtml</code> output devices use this
+directive.
+</p>
+</dd>
+<dt id='index-unitwidth'><span><code class="code">unitwidth <var class="var">n</var></code><a class="copiable-link" href='#index-unitwidth'> &para;</a></span></dt>
+<dd><p>Quantities in the font description files are in basic units for fonts
+whose type size is <var class="var">n</var>&nbsp;scaled points.
+</p>
+</dd>
+<dt id='index-unscaled_005fcharwidths'><span><code class="code">unscaled_charwidths</code><a class="copiable-link" href='#index-unscaled_005fcharwidths'> &para;</a></span></dt>
+<dd><p>Make the font handling module always return unscaled character widths.
+The <code class="code">grohtml</code> driver uses this directive.
+</p>
+</dd>
+<dt id='index-use_005fcharnames_005fin_005fspecial-1'><span><code class="code">use_charnames_in_special</code><a class="copiable-link" href='#index-use_005fcharnames_005fin_005fspecial-1'> &para;</a></span></dt>
+<dd><p>GNU <code class="code">troff</code> should encode special characters inside device control
+commands; see <a class="ref" href="#Postprocessor-Access">Postprocessor Access</a>.  The <code class="code">grohtml</code> driver
+uses this directive.
+</p>
+</dd>
+<dt id='index-vert'><span><code class="code">vert <var class="var">n</var></code><a class="copiable-link" href='#index-vert'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vertical-motion-quantum"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-vertical"></a>
+<a class="index-entry-id" id="index-quantum_002c-vertical-motion"></a>
+<a class="index-entry-id" id="index-vertical-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-vertical"></a>
+<p>The vertical motion quantum is <var class="var">n</var>&nbsp;basic units.  All vertical
+quantities are rounded to multiples of&nbsp;<var class="var">n</var>.
+</p>
+</dd>
+<dt id='index-charset'><span><code class="code">charset</code><a class="copiable-link" href='#index-charset'> &para;</a></span></dt>
+<dd><p>This line and everything following it in the file are ignored.  It is
+recognized for compatibility with other <code class="code">troff</code> implementations.
+In GNU <code class="code">troff</code>, character set repertoire is described on a
+per-font basis.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-spare1"></a>
+<a class="index-entry-id" id="index-spare2"></a>
+<a class="index-entry-id" id="index-biggestfont"></a>
+<p>GNU <code class="code">troff</code> recognizes but ignores the directives <code class="code">spare1</code>,
+<code class="code">spare2</code>, and <code class="code">biggestfont</code>.
+</p>
+<p>The <code class="code">res</code>, <code class="code">unitwidth</code>, <code class="code">fonts</code>, and <code class="code">sizes</code> lines
+are mandatory.  Directives not listed above are ignored by GNU
+<code class="code">troff</code> but may be used by postprocessors to obtain further
+information about the device.
+</p>
+
+<hr>
+</div>
+<div class="subsection-level-extent" id="Font-Description-File-Format">
+<div class="nav-panel">
+<p>
+Previous: <a href="#DESC-File-Format" accesskey="p" rel="prev"><samp class="file">DESC</samp> File Format</a>, Up: <a href="#Device-and-Font-Description-Files" accesskey="u" rel="up">Device and Font Description Files</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="subsection" id="Font-Description-File-Format-1">6.2.2 Font Description File Format</h4>
+<a class="index-entry-id" id="index-font-file_002c-format"></a>
+<a class="index-entry-id" id="index-font-description-file_002c-format"></a>
+<a class="index-entry-id" id="index-format-of-font-files"></a>
+<a class="index-entry-id" id="index-format-of-font-description-files"></a>
+
+<p>On typesetting output devices, each font is typically available at
+multiple sizes.  While paper measurements in the device description file
+are in absolute units, measurements applicable to fonts must be
+proportional to the type size.  <code class="code">groff</code> achieves this using the
+precedent set by <abbr class="acronym">AT&amp;T</abbr> device-independent <code class="code">troff</code>: one
+font size is chosen as a norm, and all others are scaled linearly
+relative to that basis.  The &ldquo;unit width&rdquo; is the number of basic units
+per point when the font is rendered at this nominal size.
+</p>
+<p>For instance, <code class="code">groff</code>&rsquo;s <code class="code">lbp</code> device uses a <code class="code">unitwidth</code>
+of&nbsp;800.  Its Times roman font &lsquo;<samp class="samp">TR</samp>&rsquo; has a <code class="code">spacewidth</code>
+of&nbsp;833; this is also the width of its comma, period, centered
+period, and mathematical asterisk, while its &lsquo;<samp class="samp">M</samp>&rsquo; is 2,963 basic
+units.  Thus, an &lsquo;<samp class="samp">M</samp>&rsquo; on the <code class="code">lbp</code> device is 2,963 basic units
+wide at a notional type size of 800&nbsp;points.<a class="footnote" id="DOCF126" href="#FOOT126"><sup>126</sup></a>
+</p>
+<p>A font description file has two sections.  The first is a sequence of
+directives, and is parsed similarly to the <samp class="file">DESC</samp> file described
+above.  Except for the directive names that begin the second section,
+their ordering is immaterial.  Later directives of the same name
+override earlier ones, spaces and tabs are handled in the same way,
+<a class="index-entry-id" id="index-comments-in-font-description-files"></a>
+<a class="index-entry-id" id="index-font-description-files_002c-comments"></a>
+<a class="index-entry-id" id="index-_0023-1"></a>
+and the same comment syntax is supported.  Empty lines are ignored
+throughout.
+</p>
+<dl class="table">
+<dt id='index-name'><span><code class="code">name <var class="var">f</var></code><a class="copiable-link" href='#index-name'> &para;</a></span></dt>
+<dd><p>The name of the font is&nbsp;<var class="var">f</var>.  &lsquo;<samp class="samp">DESC</samp>&rsquo; is an invalid font
+name.  Simple integers are valid, but their use is
+discouraged.<a class="footnote" id="DOCF127" href="#FOOT127"><sup>127</sup></a>
+</p>
+</dd>
+<dt id='index-spacewidth'><span><code class="code">spacewidth <var class="var">n</var></code><a class="copiable-link" href='#index-spacewidth'> &para;</a></span></dt>
+<dd><p>The width of an unadjusted inter-word space is <var class="var">n</var>&nbsp;basic units.
+</p></dd>
+</dl>
+
+<p>The directives above must appear in the first section; those below are
+optional.
+</p>
+<dl class="table">
+<dt id='index-slant'><span><code class="code">slant <var class="var">n</var></code><a class="copiable-link" href='#index-slant'> &para;</a></span></dt>
+<dd><p>The font&rsquo;s glyphs have a slant of <var class="var">n</var>&nbsp;degrees; a positive
+<var class="var">n</var> slants in the direction of text flow.
+</p>
+</dd>
+<dt id='index-ligatures'><span><code class="code">ligatures <var class="var">lig1</var> <span class="r">&hellip;</span> <var class="var">lign</var> <span class="r"></span>0<span class="r"></span></code><a class="copiable-link" href='#index-ligatures'> &para;</a></span></dt>
+<dd><p>Glyphs <var class="var">lig1</var>, &hellip;, <var class="var">lign</var> are ligatures; possible ligatures
+are &lsquo;<samp class="samp">ff</samp>&rsquo;, &lsquo;<samp class="samp">fi</samp>&rsquo;, &lsquo;<samp class="samp">fl</samp>&rsquo;, &lsquo;<samp class="samp">ffi</samp>&rsquo; and &lsquo;<samp class="samp">ffl</samp>&rsquo;.  For
+compatibility with other <code class="code">troff</code> implementations, the list of
+ligatures may be terminated with a&nbsp;<code class="code">0</code>.  The list of ligatures
+must not extend over more than one line.
+</p>
+</dd>
+<dt id='index-special-fonts-2'><span><code class="code">special</code><a class="copiable-link" href='#index-special-fonts-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-special-1"></a>
+<p>The font is <em class="dfn">special</em>: when a glyph is requested that is not present
+in the current font, it is sought in any mounted fonts that bear this
+property.
+</p></dd>
+</dl>
+
+<p>Other directives in this section are ignored by GNU <code class="code">troff</code>, but
+may be used by postprocessors to obtain further information about the
+font.
+</p>
+<p>The second section contains one or two subsections.  These can appear in
+either order; the first one encountered commences the second section.
+Each starts with a directive on a line by itself.  A <code class="code">charset</code>
+subsection is mandatory unless the associated <samp class="file">DESC</samp> file contains
+the <code class="code">unicode</code> directive.  Another subsection, <code class="code">kernpairs</code>,
+is optional.
+</p>
+<a class="index-entry-id" id="index-charset-1"></a>
+<p>The directive <code class="code">charset</code> starts the character set
+subsection.<a class="footnote" id="DOCF128" href="#FOOT128"><sup>128</sup></a>  It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
+</p>
+<blockquote class="quotation">
+<p><var class="var">name</var> <var class="var">metrics</var> <var class="var">type</var> <var class="var">code</var> <var class="var">entity-name</var>
+<code class="code">--</code> <var class="var">comment</var>
+</p></blockquote>
+
+<a class="index-entry-id" id="index-8_002dbit-input"></a>
+<a class="index-entry-id" id="index-input_002c-8_002dbit"></a>
+<a class="index-entry-id" id="index-accessing-unnamed-glyphs-with-_005cN"></a>
+<a class="index-entry-id" id="index-unnamed-glyphs_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-characters_002c-unnamed_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-glyphs_002c-unnamed_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-_002d_002d_002d"></a>
+<p><var class="var">name</var> identifies the glyph:
+if <var class="var">name</var> is a printable character&nbsp;<var class="var">c</var>, it corresponds to
+the <code class="code">troff</code> ordinary character&nbsp;<var class="var">c</var>.  If <var class="var">name</var> is a
+multi-character sequence not beginning with <code class="code">\</code>, it corresponds to
+the GNU <code class="code">troff</code> special character escape sequence
+&lsquo;<samp class="samp">\<var class="var">name</var></samp>&rsquo;.  A name consisting of three minus signs,
+&lsquo;<samp class="samp">---</samp>&rsquo;, is special and indicates that the glyph is unnamed: such
+glyphs can be accessed only by the <code class="code">\N</code> escape sequence in
+<code class="code">troff</code>.  A special character named &lsquo;<samp class="samp">---</samp>&rsquo; can still be defined
+using <code class="code">char</code> and similar requests.  The <var class="var">name</var> &lsquo;<samp class="samp">\-</samp>&rsquo;
+defines the minus sign glyph.  Finally, <var class="var">name</var> can be the
+unbreakable one-sixth and one-twelfth space escape sequences, <code class="code">\|</code>
+and <code class="code">\^</code> (&ldquo;thin&rdquo; and &ldquo;hair&rdquo; spaces, respectively), in which
+case only the width metric described below is interpreted; a font can
+thus customize the widths of these spaces.
+</p>
+<p>The form of the <var class="var">metrics</var> field is as follows.
+</p>
+<div class="display">
+<div class="group"><pre class="display-preformatted"><var class="var">width</var><code class="code">,</code><var class="var">height</var><code class="code">,</code><var class="var">depth</var><code class="code">,</code><var class="var">italic-correction</var>
+  <code class="code">,</code><var class="var">left-italic-correction</var><code class="code">,</code><var class="var">subscript-correction</var>
+</pre></div></div>
+
+<p>There must not be any spaces, tabs, or newlines between these
+<em class="dfn">subfields</em> (which have been split here into two lines only for
+better legibility).  The subfields are in basic units expressed as
+decimal integers.  Unspecified subfields default to&nbsp;<code class="code">0</code>.
+Since there is no associated binary format, these values are not
+required to fit into the C language data type &lsquo;<samp class="samp">char</samp>&rsquo; as they are in
+<abbr class="acronym">AT&amp;T</abbr> device-independent <code class="code">troff</code>.
+</p>
+<p>The <var class="var">width</var> subfield gives the width of the glyph.  The <var class="var">height</var>
+subfield gives the height of the glyph (upward is positive); if a glyph
+does not extend above the baseline, it should be given a zero height,
+rather than a negative height.  The <var class="var">depth</var> subfield gives the depth
+of the glyph, that is, the distance below the baseline to which the
+glyph extends (downward is positive); if a glyph does not extend below
+the baseline, it should be given a zero depth, rather than a negative
+depth.  Italic corrections are relevant to glyphs in italic or oblique
+styles.  The <var class="var">italic-correction</var> is the amount of space that should
+be added after an oblique glyph to be followed immediately by an upright
+glyph.  The <var class="var">left-italic-correction</var> is the amount of space that
+should be added before an oblique glyph to be preceded immediately by an
+upright glyph.  The <var class="var">subscript-correction</var> is the amount of space
+that should be added after an oblique glyph to be followed by a
+subscript; it should be less than the italic correction.
+</p>
+<p>For fonts used with typesetting devices, the <var class="var">type</var> field gives a
+featural description of the glyph: it is a bit mask recording whether
+the glyph is an ascender, descender, both, or neither.  When a <code class="code">\w</code>
+escape sequence is interpolated, these values are bitwise or-ed
+together for each glyph and stored in the <code class="code">nr</code> register.  In font
+descriptions for terminal devices, all glyphs might have a type of zero,
+regardless of their appearance.
+</p>
+<dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>means the glyph lies entirely between the baseline and a horizontal line
+at the &ldquo;x-height&rdquo; of the font; typical examples are &lsquo;<samp class="samp">a</samp>&rsquo;,
+&lsquo;<samp class="samp">c</samp>&rsquo;, and &lsquo;<samp class="samp">x</samp>&rsquo;;
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>means the glyph descends below the baseline, like &lsquo;<samp class="samp">p</samp>&rsquo;;
+</p>
+</dd>
+<dt><code class="code">2</code></dt>
+<dd><p>means the glyph ascends above the font&rsquo;s x-height, like &lsquo;<samp class="samp">A</samp>&rsquo; or
+&lsquo;<samp class="samp">b</samp>&rsquo;; and
+</p>
+</dd>
+<dt><code class="code">3</code></dt>
+<dd><p>means the glyph is both an ascender and a descender&mdash;this is true of
+parentheses in some fonts.
+</p></dd>
+</dl>
+
+<p>The <var class="var">code</var> field gives a numeric identifier that the postprocessor
+uses to render the glyph.  The glyph can be specified to <code class="code">troff</code>
+using this code by means of the <code class="code">\N</code> escape sequence.  <var class="var">code</var>
+can be any integer.<a class="footnote" id="DOCF129" href="#FOOT129"><sup>129</sup></a>
+</p>
+<p>The <var class="var">entity-name</var> field defines an identifier for the glyph that the
+postprocessor uses to print the GNU <code class="code">troff</code> glyph <var class="var">name</var>.  This
+field is optional; it was introduced so that the <code class="code">grohtml</code> output
+driver could encode its character set.  For example, the glyph
+&lsquo;<samp class="samp">\Po</samp>&rsquo; is represented by &lsquo;<samp class="samp">&amp;pound;</samp>&rsquo; in <abbr class="acronym">HTML</abbr> 4.0.
+For efficiency, these data are now compiled directly into
+<code class="code">grohtml</code>.  <code class="code">grops</code> uses the field to build sub-encoding
+arrays for PostScript fonts containing more than 256 glyphs.  Anything
+on the line after the <var class="var">entity-name</var> field or &lsquo;<samp class="samp">--</samp>&rsquo; is ignored.
+</p>
+<p>A line in the <code class="code">charset</code> section can also have the form
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><var class="var">name</var> &quot;
+</pre></div></div>
+
+<p>identifying <var class="var">name</var> as another name for the glyph mentioned in the
+preceding line.  Such aliases can be chained.
+</p>
+<a class="index-entry-id" id="index-kernpairs"></a>
+<p>The directive <code class="code">kernpairs</code> starts a list of kerning adjustments to
+be made to adjacent glyph pairs from this font.  It contains a sequence
+of lines formatted as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><var class="var">g1</var> <var class="var">g2</var> <var class="var">n</var>
+</pre></div></div>
+
+<p>The foregoing means that when glyph <var class="var">g1</var> is typeset immediately
+before <var class="var">g2</var>, the space between them should be increased
+by&nbsp;<var class="var">n</var>.  Most kerning pairs should have a negative value
+for&nbsp;<var class="var">n</var>.
+</p>
+
+
+
+
+<hr>
+</div>
+</div>
+</div>
+<div class="appendix-level-extent" id="Copying-This-Manual">
+<div class="nav-panel">
+<p>
+Next: <a href="#Request-Index" accesskey="n" rel="next">Request Index</a>, Previous: <a href="#Font-Description-File-Format" accesskey="p" rel="prev">Font Description File Format</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Copying-This-Manual-1">Appendix A Copying This Manual</h2>
+
+<div class="center">Version 1.3, 3 November 2008
+</div>
+
+<div class="display">
+<pre class="display-preformatted">Copyright &copy; 2000-2018 Free Software Foundation, Inc.
+<a class="uref" href="http://fsf.org/">http://fsf.org/</a>
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+</pre></div>
+
+<ol class="enumerate" start="0">
+<li> PREAMBLE
+
+<p>The purpose of this License is to make a manual, textbook, or other
+functional and useful document <em class="dfn">free</em> in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
+</p>
+<p>This License is a kind of &ldquo;copyleft&rdquo;, which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+</p>
+<p>We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+</p>
+</li><li> APPLICABILITY AND DEFINITIONS
+
+<p>This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License.  Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein.  The &ldquo;Document&rdquo;, below,
+refers to any such manual or work.  Any member of the public is a
+licensee, and is addressed as &ldquo;you&rdquo;.  You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
+</p>
+<p>A &ldquo;Modified Version&rdquo; of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+</p>
+<p>A &ldquo;Secondary Section&rdquo; is a named appendix or a front-matter section
+of the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document&rsquo;s overall
+subject (or to related matters) and contains nothing that could fall
+directly within that overall subject.  (Thus, if the Document is in
+part a textbook of mathematics, a Secondary Section may not explain
+any mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+</p>
+<p>The &ldquo;Invariant Sections&rdquo; are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.  If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant.  The Document may contain zero
+Invariant Sections.  If the Document does not identify any Invariant
+Sections then there are none.
+</p>
+<p>The &ldquo;Cover Texts&rdquo; are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.  A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
+</p>
+<p>A &ldquo;Transparent&rdquo; copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, that is suitable for revising the document
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text.  A copy that is not &ldquo;Transparent&rdquo; is called &ldquo;Opaque&rdquo;.
+</p>
+<p>Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input
+format, SGML or XML using a publicly available
+DTD, and standard-conforming simple HTML,
+PostScript or PDF designed for human modification.  Examples
+of transparent image formats include PNG, XCF and
+JPG.  Opaque formats include proprietary formats that can be
+read and edited only by proprietary word processors, SGML or
+XML for which the DTD and/or processing tools are
+not generally available, and the machine-generated HTML,
+PostScript or PDF produced by some word processors for
+output purposes only.
+</p>
+<p>The &ldquo;Title Page&rdquo; means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, &ldquo;Title Page&rdquo; means
+the text near the most prominent appearance of the work&rsquo;s title,
+preceding the beginning of the body of the text.
+</p>
+<p>The &ldquo;publisher&rdquo; means any person or entity that distributes copies
+of the Document to the public.
+</p>
+<p>A section &ldquo;Entitled XYZ&rdquo; means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language.  (Here XYZ stands for a
+specific section name mentioned below, such as &ldquo;Acknowledgements&rdquo;,
+&ldquo;Dedications&rdquo;, &ldquo;Endorsements&rdquo;, or &ldquo;History&rdquo;.)  To &ldquo;Preserve the Title&rdquo;
+of such a section when you modify the Document means that it remains a
+section &ldquo;Entitled XYZ&rdquo; according to this definition.
+</p>
+<p>The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document.  These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+</p>
+</li><li> VERBATIM COPYING
+
+<p>You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+</p>
+<p>You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+</p>
+</li><li> COPYING IN QUANTITY
+
+<p>If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document&rsquo;s license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+</p>
+<p>If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+</p>
+<p>If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
+</p>
+<p>It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+</p>
+</li><li> MODIFICATIONS
+
+<p>You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+</p>
+<ol class="enumerate" type="A" start="1">
+<li> Use in the Title Page (and on the covers, if any) a title distinct
+from that of the Document, and from those of previous versions
+(which should, if there were any, be listed in the History section
+of the Document).  You may use the same title as a previous version
+if the original publisher of that version gives permission.
+
+</li><li> List on the Title Page, as authors, one or more persons or entities
+responsible for authorship of the modifications in the Modified
+Version, together with at least five of the principal authors of the
+Document (all of its principal authors, if it has fewer than five),
+unless they release you from this requirement.
+
+</li><li> State on the Title page the name of the publisher of the
+Modified Version, as the publisher.
+
+</li><li> Preserve all the copyright notices of the Document.
+
+</li><li> Add an appropriate copyright notice for your modifications
+adjacent to the other copyright notices.
+
+</li><li> Include, immediately after the copyright notices, a license notice
+giving the public permission to use the Modified Version under the
+terms of this License, in the form shown in the Addendum below.
+
+</li><li> Preserve in that license notice the full lists of Invariant Sections
+and required Cover Texts given in the Document&rsquo;s license notice.
+
+</li><li> Include an unaltered copy of this License.
+
+</li><li> Preserve the section Entitled &ldquo;History&rdquo;, Preserve its Title, and add
+to it an item stating at least the title, year, new authors, and
+publisher of the Modified Version as given on the Title Page.  If
+there is no section Entitled &ldquo;History&rdquo; in the Document, create one
+stating the title, year, authors, and publisher of the Document as
+given on its Title Page, then add an item describing the Modified
+Version as stated in the previous sentence.
+
+</li><li> Preserve the network location, if any, given in the Document for
+public access to a Transparent copy of the Document, and likewise
+the network locations given in the Document for previous versions
+it was based on.  These may be placed in the &ldquo;History&rdquo; section.
+You may omit a network location for a work that was published at
+least four years before the Document itself, or if the original
+publisher of the version it refers to gives permission.
+
+</li><li> For any section Entitled &ldquo;Acknowledgements&rdquo; or &ldquo;Dedications&rdquo;, Preserve
+the Title of the section, and preserve in the section all the
+substance and tone of each of the contributor acknowledgements and/or
+dedications given therein.
+
+</li><li> Preserve all the Invariant Sections of the Document,
+unaltered in their text and in their titles.  Section numbers
+or the equivalent are not considered part of the section titles.
+
+</li><li> Delete any section Entitled &ldquo;Endorsements&rdquo;.  Such a section
+may not be included in the Modified Version.
+
+</li><li> Do not retitle any existing section to be Entitled &ldquo;Endorsements&rdquo; or
+to conflict in title with any Invariant Section.
+
+</li><li> Preserve any Warranty Disclaimers.
+</li></ol>
+
+<p>If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version&rsquo;s license notice.
+These titles must be distinct from any other section titles.
+</p>
+<p>You may add a section Entitled &ldquo;Endorsements&rdquo;, provided it contains
+nothing but endorsements of your Modified Version by various
+parties&mdash;for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+</p>
+<p>You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+</p>
+<p>The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+</p>
+</li><li> COMBINING DOCUMENTS
+
+<p>You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice, and that you preserve all their Warranty Disclaimers.
+</p>
+<p>The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+</p>
+<p>In the combination, you must combine any sections Entitled &ldquo;History&rdquo;
+in the various original documents, forming one section Entitled
+&ldquo;History&rdquo;; likewise combine any sections Entitled &ldquo;Acknowledgements&rdquo;,
+and any sections Entitled &ldquo;Dedications&rdquo;.  You must delete all
+sections Entitled &ldquo;Endorsements.&rdquo;
+</p>
+</li><li> COLLECTIONS OF DOCUMENTS
+
+<p>You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+</p>
+<p>You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+</p>
+</li><li> AGGREGATION WITH INDEPENDENT WORKS
+
+<p>A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, is called an &ldquo;aggregate&rdquo; if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation&rsquo;s users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+</p>
+<p>If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document&rsquo;s Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
+</p>
+</li><li> TRANSLATION
+
+<p>Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers.  In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+</p>
+<p>If a section in the Document is Entitled &ldquo;Acknowledgements&rdquo;,
+&ldquo;Dedications&rdquo;, or &ldquo;History&rdquo;, the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
+</p>
+</li><li> TERMINATION
+
+<p>You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense, or distribute it is void, and
+will automatically terminate your rights under this License.
+</p>
+<p>However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+</p>
+<p>Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+</p>
+<p>Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, receipt of a copy of some or all of the same material does
+not give you any rights to use it.
+</p>
+</li><li> FUTURE REVISIONS OF THIS LICENSE
+
+<p>The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time.  Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.  See
+<a class="uref" href="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</a>.
+</p>
+<p>Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License &ldquo;or any later version&rdquo; applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.  If the Document
+specifies that a proxy can decide which future versions of this
+License can be used, that proxy&rsquo;s public statement of acceptance of a
+version permanently authorizes you to choose that version for the
+Document.
+</p>
+</li><li> RELICENSING
+
+<p>&ldquo;Massive Multiauthor Collaboration Site&rdquo; (or &ldquo;MMC Site&rdquo;) means any
+World Wide Web server that publishes copyrightable works and also
+provides prominent facilities for anybody to edit those works.  A
+public wiki that anybody can edit is an example of such a server.  A
+&ldquo;Massive Multiauthor Collaboration&rdquo; (or &ldquo;MMC&rdquo;) contained in the
+site means any set of copyrightable works thus published on the MMC
+site.
+</p>
+<p>&ldquo;CC-BY-SA&rdquo; means the Creative Commons Attribution-Share Alike 3.0
+license published by Creative Commons Corporation, a not-for-profit
+corporation with a principal place of business in San Francisco,
+California, as well as future copyleft versions of that license
+published by that same organization.
+</p>
+<p>&ldquo;Incorporate&rdquo; means to publish or republish a Document, in whole or
+in part, as part of another Document.
+</p>
+<p>An MMC is &ldquo;eligible for relicensing&rdquo; if it is licensed under this
+License, and if all works that were first published under this License
+somewhere other than this MMC, and subsequently incorporated in whole
+or in part into the MMC, (1) had no cover texts or invariant sections,
+and (2) were thus incorporated prior to November 1, 2008.
+</p>
+<p>The operator of an MMC Site may republish an MMC contained in the site
+under CC-BY-SA on the same site at any time before August 1, 2009,
+provided the MMC is eligible for relicensing.
+</p>
+</li></ol>
+
+<h3 class="heading" id="ADDENDUM_003a-How-to-use-this-License-for-your-documents">ADDENDUM: How to use this License for your documents</h3>
+
+<p>To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+</p>
+<div class="example smallexample">
+<div class="group"><pre class="example-preformatted">  Copyright (C)  <var class="var">year</var>  <var class="var">your name</var>.
+  Permission is granted to copy, distribute and/or modify this document
+  under the terms of the GNU Free Documentation License, Version 1.3
+  or any later version published by the Free Software Foundation;
+  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+  Texts.  A copy of the license is included in the section entitled ``GNU
+  Free Documentation License''.
+</pre></div></div>
+
+<p>If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+replace the &ldquo;with&hellip;Texts.&rdquo; line with this:
+</p>
+<div class="example smallexample">
+<div class="group"><pre class="example-preformatted">    with the Invariant Sections being <var class="var">list their titles</var>, with
+    the Front-Cover Texts being <var class="var">list</var>, and with the Back-Cover Texts
+    being <var class="var">list</var>.
+</pre></div></div>
+
+<p>If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+</p>
+<p>If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
+</p>
+
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Request-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Escape-Sequence-Index" accesskey="n" rel="next">Escape Sequence Index</a>, Previous: <a href="#Copying-This-Manual" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Request-Index-1">Appendix B Request Index</h2>
+
+<p>Request names appear without a leading control character; the defaults
+are <code class="code">.</code> for the regular control character and <code class="code">'</code> for the
+no-break control character.
+</p>
+<div class="printindex rq-printindex">
+<table class="rq-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Request-Index_rq_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-W"><b>W</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="rq-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ab"><code>ab</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ad"><code>ad</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-af"><code>af</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-aln"><code>aln</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-als"><code>als</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-am"><code>am</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-am1"><code>am1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ami"><code>ami</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ami1"><code>ami1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-as"><code>as</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-as1"><code>as1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-asciify"><code>asciify</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backtrace"><code>backtrace</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bd"><code>bd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blm"><code>blm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Blank-Line-Traps">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-box"><code>box</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boxa"><code>boxa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp"><code>bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-br"><code>br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break-2"><code>break</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-brp"><code>brp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-c2"><code>c2</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cc"><code>cc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ce"><code>ce</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cf"><code>cf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cflags"><code>cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ch"><code>ch</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-char"><code>char</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-chop"><code>chop</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-class"><code>class</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-close"><code>close</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color"><code>color</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-composite"><code>composite</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continue"><code>continue</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cp"><code>cp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs"><code>cs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cu"><code>cu</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-da"><code>da</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-de"><code>de</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-de1"><code>de1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defcolor"><code>defcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dei"><code>dei</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dei1"><code>dei1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device"><code>device</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-devicem"><code>devicem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-di"><code>di</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-do"><code>do</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds"><code>ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds-1"><code>ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds1"><code>ds1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dt"><code>dt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ec"><code>ec</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ecr"><code>ecr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ecs"><code>ecs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-el"><code>el</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002delse">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-em"><code>em</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-eo"><code>eo</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ev"><code>ev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-evc"><code>evc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ex"><code>ex</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fam"><code>fam</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fc"><code>fc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fchar"><code>fchar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fcolor"><code>fcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fi"><code>fi</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fl"><code>fl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fp"><code>fp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fschar"><code>fschar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fspecial"><code>fspecial</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ft"><code>ft</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ftr"><code>ftr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fzoom"><code>fzoom</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gcolor"><code>gcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hc"><code>hc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hcode"><code>hcode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hla"><code>hla</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hlm"><code>hlm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hpf"><code>hpf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hpfa"><code>hpfa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hpfcode"><code>hpfcode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hw"><code>hw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hy"><code>hy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hym"><code>hym</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hys"><code>hys</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ie"><code>ie</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002delse">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if"><code>if</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002dthen">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ig"><code>ig</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-in-1"><code>in</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-it"><code>it</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-itc"><code>itc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kern"><code>kern</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lc"><code>lc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length"><code>length</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lf"><code>lf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lg"><code>lg</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-linetabs"><code>linetabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ll-1"><code>ll</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ls"><code>ls</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lsm"><code>lsm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lt"><code>lt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mc"><code>mc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mk"><code>mk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mso"><code>mso</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-msoquiet"><code>msoquiet</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-na"><code>na</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ne"><code>ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nf"><code>nf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nh"><code>nh</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nm"><code>nm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nn"><code>nn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nop"><code>nop</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002dthen">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr-1"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr-2"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr-3"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nroff"><code>nroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ns"><code>ns</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nx"><code>nx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-open"><code>open</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opena"><code>opena</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-os"><code>os</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output"><code>output</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pc"><code>pc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pev"><code>pev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pi"><code>pi</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pl"><code>pl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pm"><code>pm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pn"><code>pn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pnr"><code>pnr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-po-1"><code>po</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps"><code>ps</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-psbb"><code>psbb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pso"><code>pso</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ptr"><code>ptr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pvs"><code>pvs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rchar"><code>rchar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rd"><code>rd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-return"><code>return</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rfschar"><code>rfschar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rj"><code>rj</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rm"><code>rm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rn"><code>rn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rnn"><code>rnn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rr"><code>rr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rs"><code>rs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rt"><code>rt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-schar"><code>schar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-shc"><code>shc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-shift"><code>shift</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sizes-1"><code>sizes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-so"><code>so</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-soquiet"><code>soquiet</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sp"><code>sp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-2"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spreadwarn"><code>spreadwarn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ss"><code>ss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stringdown"><code>stringdown</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stringup"><code>stringup</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sty"><code>sty</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-substring"><code>substring</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sv"><code>sv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sy"><code>sy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ta"><code>ta</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tag"><code>tag</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-taga"><code>taga</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tc"><code>tc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ti"><code>ti</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tkf"><code>tkf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tl"><code>tl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tm"><code>tm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tm1"><code>tm1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tmc"><code>tmc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tr"><code>tr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trf"><code>trf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trin"><code>trin</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trnt"><code>trnt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troff"><code>troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uf"><code>uf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ul"><code>ul</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unformat"><code>unformat</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vpt"><code>vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vs"><code>vs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-W">W</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warn"><code>warn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warnscale"><code>warnscale</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-wh"><code>wh</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while-1"><code>while</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-write"><code>write</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writec"><code>writec</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writem"><code>writem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="rq-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Request-Index_rq_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-W"><b>W</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Escape-Sequence-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Operator-Index" accesskey="n" rel="next">Operator Index</a>, Previous: <a href="#Request-Index" accesskey="p" rel="prev">Request Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Escape-Sequence-Index-1">Appendix C Escape Sequence Index</h2>
+
+<p>The escape character, <code class="code">\</code> by default, is always followed by at
+least one more input character, making an escape <em class="emph">sequence</em>.  Any
+input token <code class="code">\<var class="var">X</var></code> with <var class="var">X</var> not in the list below emits a
+warning and interpolates glyph <var class="var">X</var>.  Note the entries for <code class="code">\.</code>,
+which may be obscured by the leader dots, and for <code class="code">\<kbd class="key">RET</kbd></code> and
+<code class="code">\<kbd class="key">SP</kbd></code>, which are sorted alphabetically, not by code point
+order.
+</p>
+<div class="printindex es-printindex">
+<table class="es-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Escape-Sequence-Index_es_symbol-1">\</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c-1"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021"><code>\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0022"><code>\&quot;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0023"><code>\#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0024"><code>\$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0024_002a"><code>\$*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_00240"><code>\$0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0024_0040"><code>\$@</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0024_005e"><code>\$^</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025"><code>\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026"><code>\&amp;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0027"><code>\<code class="code">'</code></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0028"><code>$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0029"><code>$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002a"><code>\*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002c"><code>\,</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d"><code>\-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002e"><code>\.</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002f"><code>\/</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c0"><code>\0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003a"><code>\:</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f"><code>\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cA"><code>\A</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ca"><code>\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cB"><code>\B</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cb"><code>\b</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc"><code>\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cC"><code>\C</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cd"><code>\d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cD"><code>\D</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce"><code>\e</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cE"><code>\E</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cf"><code>\f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cF"><code>\F</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cg"><code>\g</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH"><code>\H</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ch"><code>\h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ck"><code>\k</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cl"><code>\l</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cL"><code>\L</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cm"><code>\m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cM"><code>\M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cn"><code>\n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cn-1"><code>\n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cN"><code>\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cnewline"><code>\<i class="slanted">newline</i></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005co"><code>\o</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cO"><code>\O</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cp"><code>\p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR"><code>\R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR-1"><code>\R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cr"><code>\r</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cRET"><code>\<kbd class="key">RET</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cS"><code>\S</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs"><code>\s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cSP"><code>\<kbd class="key">SP</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cspace"><code>\<i class="slanted">space</i></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ct"><code>\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cu"><code>\u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cv"><code>\v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cV"><code>\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cw"><code>\w</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cx"><code>\x</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cX"><code>\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cY"><code>\Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cz"><code>\z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cZ"><code>\Z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005b"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005c"><code>\\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005e"><code>\^</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005f"><code>\_</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0060"><code>\<code class="code">`</code></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007b"><code>\{</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007b-1"><code>\{</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007c"><code>\|</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007d"><code>\}</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007e"><code>\~</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Operator-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Register-Index" accesskey="n" rel="next">Register Index</a>, Previous: <a href="#Escape-Sequence-Index" accesskey="p" rel="prev">Escape Sequence Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Operator-Index-1">Appendix D Operator Index</h2>
+
+<div class="printindex op-printindex">
+<table class="op-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Operator-Index_op_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-4"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-5"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-6"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-7"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-8"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-9"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-11"><b>;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-12"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-13"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-14"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-15"><b>|</b></a>
+</td></tr></table>
+<table class="op-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-1">!</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021"><code>!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-3">&amp;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0026"><code>&amp;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-4">(</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0028"><code>(</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-5">)</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0029"><code>)</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-6">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002a"><code>*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-7">+</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002b"><code>+</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002b-1"><code>+</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002b-_0028unary_0029"><code>+ <span class="r">(unary)</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-8">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d"><code>-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-1"><code>-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-_0028unary_0029"><code>- <span class="r">(unary)</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-9">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f"><code>/</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-10">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003a"><code>:</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-11">;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003b"><code>;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-12">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c"><code>&lt;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_003d"><code>&lt;=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_003f"><code>&lt;?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-13">=</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003d"><code>=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003d_003d"><code>==</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-14">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003e"><code>&gt;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003e_003d"><code>&gt;=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003e_003f"><code>&gt;?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-15">|</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007c"><code>|</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="op-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Operator-Index_op_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-4"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-5"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-6"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-7"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-8"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-9"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-11"><b>;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-12"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-13"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-14"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-15"><b>|</b></a>
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Register-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Macro-Index" accesskey="n" rel="next">Macro Index</a>, Previous: <a href="#Operator-Index" accesskey="p" rel="prev">Operator Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Register-Index-1">Appendix E Register Index</h2>
+
+<p>The macro package or program a specific register belongs to is appended
+in brackets.
+</p>
+<p>A register name&nbsp;<code class="code">x</code> consisting of exactly one character can be
+accessed as &lsquo;<samp class="samp">\nx</samp>&rsquo;.  A register name <code class="code">xx</code> consisting of exactly
+two characters can be accessed as &lsquo;<samp class="samp">\n(xx</samp>&rsquo;.  Register names
+<code class="code">xxx</code> of any length can be accessed as &lsquo;<samp class="samp">\nxxx</samp>&rsquo;.
+</p>
+<div class="printindex vr-printindex">
+<table class="vr-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Register-Index_vr_symbol-1"><b>$</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-3"><b>.</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Y"><b>Y</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="vr-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-1">$</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0024_0024"><code>$$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025-1"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025-2"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-3">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002e_0024"><code>.$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eA"><code>.A</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ea"><code>.a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eb"><code>.b</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ebr-1"><code>.br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ec"><code>.c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eC"><code>.C</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecdp"><code>.cdp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ece-1"><code>.ce</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002echt"><code>.cht</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecolor-1"><code>.color</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecp-1"><code>.cp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ecsk"><code>.csk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ed"><code>.d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eev-1"><code>.ev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eF"><code>.F</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ef"><code>.f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002efam-1"><code>.fam</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002efn"><code>.fn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002efp-1"><code>.fp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eg"><code>.g</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eH"><code>.H</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eh"><code>.h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eheight"><code>.height</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehla-1"><code>.hla</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehlc"><code>.hlc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehlm-1"><code>.hlm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehy-1"><code>.hy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehym-1"><code>.hym</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ehys-1"><code>.hys</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ei"><code>.i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ein-3"><code>.in</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eint"><code>.int</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ej"><code>.j</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ek"><code>.k</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ekern-1"><code>.kern</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eL"><code>.L</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002el"><code>.l</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002elg-1"><code>.lg</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002elinetabs-1"><code>.linetabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ell-3"><code>.ll</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002elt-3"><code>.lt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002em"><code>.m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eM"><code>.M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002en"><code>.n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ene-1"><code>.ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002enm-1"><code>.nm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002enn-1"><code>.nn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ens-1"><code>.ns</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eo"><code>.o</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eO"><code>.O</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eP"><code>.P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ep"><code>.p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epe"><code>.pe</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epn-3"><code>.pn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eps-3"><code>.ps</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epsr"><code>.psr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002epvs-3"><code>.pvs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eR-2"><code>.R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002erj-1"><code>.rj</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002es"><code>.s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eslant"><code>.slant</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002esr"><code>.sr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ess-1"><code>.ss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002esss"><code>.sss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002esty-1"><code>.sty</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eT-2"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002et"><code>.t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002etabs"><code>.tabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002etrunc"><code>.trunc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eU"><code>.U</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eu"><code>.u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eV"><code>.V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ev"><code>.v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002evpt-1"><code>.vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ew"><code>.w</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ewarn-1"><code>.warn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ex"><code>.x</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ey"><code>.y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eY"><code>.Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ez"><code>.z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002ezoom"><code>.zoom</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-c_002e"><code>c.</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ct"><code>ct</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DD-_005bms_005d"><code>DD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DI-_005bms_005d"><code>DI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dl"><code>dl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dn"><code>dn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dw"><code>dw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dy"><code>dy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FF-_005bms_005d"><code>FF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FI-_005bms_005d"><code>FI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FM-_005bms_005d"><code>FM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FPD-_005bms_005d"><code>FPD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FPS-_005bms_005d"><code>FPS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FVS-_005bms_005d"><code>FVS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROWPS-_005bms_005d"><code>GROWPS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GS-_005bms_005d"><code>GS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Differences-from-AT_0026T-ms">Differences from AT&amp;T ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-HM-_005bms_005d"><code>HM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-HORPHANS-_005bms_005d"><code>HORPHANS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hours"><code>hours</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hp"><code>hp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-HY-_005bms_005d"><code>HY <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LL-_005bms_005d"><code>LL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-llx"><code>llx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lly"><code>lly</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ln"><code>ln</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lsn"><code>lsn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lss"><code>lss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LT-_005bms_005d"><code>LT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MINGW-_005bms_005d"><code>MINGW <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minutes"><code>minutes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mo"><code>mo</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nl"><code>nl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opmaxx"><code>opmaxx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opmaxy"><code>opmaxy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opminx"><code>opminx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opminy"><code>opminy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PD-_005bms_005d"><code>PD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PI-_005bms_005d"><code>PI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PO-_005bms_005d"><code>PO <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PORPHANS-_005bms_005d"><code>PORPHANS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PS-_005bms_005d-1"><code>PS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PSINCR-_005bms_005d"><code>PSINCR <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-QI-_005bms_005d"><code>QI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rsb"><code>rsb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rst"><code>rst</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sb"><code>sb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-seconds"><code>seconds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-skw"><code>skw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-slimit"><code>slimit</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ssc"><code>ssc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-st"><code>st</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-systat"><code>systat</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TC_002dMARGIN-_005bms_005d"><code>TC-MARGIN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-urx"><code>urx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ury"><code>ury</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-VS-_005bms_005d"><code>VS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-Y">Y</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-year"><code>year</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-yr"><code>yr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="vr-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Register-Index_vr_symbol-1"><b>$</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-3"><b>.</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Y"><b>Y</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Macro-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#String-Index" accesskey="n" rel="next">String Index</a>, Previous: <a href="#Register-Index" accesskey="p" rel="prev">Register Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Macro-Index-1">Appendix F Macro Index</h2>
+
+<p>The macro package a specific macro belongs to is appended in brackets.
+They appear without the leading control character (normally &lsquo;<samp class="samp">.</samp>&rsquo;).
+</p>
+<div class="printindex ma-printindex">
+<table class="ma-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-1"><b>1</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-2"><b>2</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-3"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-4"><b></b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-X"><b>X</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="ma-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-1">1</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-1C-_005bms_005d"><code>1C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Multiple-Columns">ms Multiple Columns</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-2">2</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-2C-_005bms_005d"><code>2C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Multiple-Columns">ms Multiple Columns</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-3"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005b-_005bms_005d"><code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-4"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005d-_005bms_005d"><code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AB-_005bms_005d"><code>AB <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AE-_005bms_005d"><code>AE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AI-_005bms_005d"><code>AI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AM-_005bms_005d"><code>AM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AU-_005bms_005d"><code>AU <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-B-_005bms_005d"><code>B <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-B1-_005bms_005d"><code>B1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-B2-_005bms_005d"><code>B2 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-BD-_005bms_005d"><code>BD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-BI-_005bms_005d"><code>BI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-BT-_005bman_005d"><code>BT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-BX-_005bms_005d"><code>BX <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CD-_005bms_005d"><code>CD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CT-_005bman_005d"><code>CT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CW-_005bman_005d"><code>CW <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CW-_005bms_005d"><code>CW <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DA-_005bms_005d"><code>DA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-De-_005bman_005d"><code>De <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DE-_005bms_005d"><code>DE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Ds-_005bman_005d"><code>Ds <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DS-_005bms_005d"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DS-_005bms_005d-1"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DS-_005bms_005d-2"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DS-_005bms_005d-3"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DS-_005bms_005d-4"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EE-_005bman_005d"><code>EE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EF-_005bms_005d"><code>EF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EH-_005bms_005d"><code>EH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EN-_005bms_005d"><code>EN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EQ-_005bms_005d"><code>EQ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EX-_005bman_005d"><code>EX <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FE-_005bms_005d"><code>FE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FS-_005bms_005d"><code>FS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-G-_005bman_005d"><code>G <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GL-_005bman_005d"><code>GL <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-HB-_005bman_005d"><code>HB <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-I-_005bms_005d"><code>I <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ID-_005bms_005d"><code>ID <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-IP-_005bms_005d"><code>IP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-KE-_005bms_005d"><code>KE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-KF-_005bms_005d"><code>KF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-KS-_005bms_005d"><code>KS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LD-_005bms_005d"><code>LD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LG-_005bms_005d"><code>LG <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LP-_005bms_005d"><code>LP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MC-_005bms_005d"><code>MC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Multiple-Columns">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MS-_005bman_005d"><code>MS <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ND-_005bms_005d"><code>ND <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-NE-_005bman_005d"><code>NE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-NH-_005bms_005d"><code>NH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-NL-_005bms_005d"><code>NL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-NT-_005bman_005d"><code>NT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-OF-_005bms_005d"><code>OF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-OH-_005bms_005d"><code>OH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-P1-_005bms_005d"><code>P1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PE-_005bms_005d"><code>PE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PF-_005bms_005d"><code>PF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PN-_005bman_005d"><code>PN <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Pn-_005bman_005d"><code>Pn <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PP-_005bms_005d"><code>PP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PS-_005bms_005d"><code>PS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PT-_005bman_005d"><code>PT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PX-_005bms_005d"><code>PX <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-QE-_005bms_005d"><code>QE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-QP-_005bms_005d"><code>QP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-QS-_005bms_005d"><code>QS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-R-_005bman_005d"><code>R <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-R-_005bms_005d"><code>R <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RD-_005bms_005d"><code>RD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RE-_005bms_005d"><code>RE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indented-regions-in-ms">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RN-_005bman_005d"><code>RN <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RP-_005bms_005d"><code>RP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RS-_005bms_005d"><code>RS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indented-regions-in-ms">Indented regions in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SH-_005bms_005d"><code>SH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SM-_005bms_005d"><code>SM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TA-_005bms_005d"><code>TA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tab-Stops-in-ms">Tab Stops in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TB-_005bman_005d"><code>TB <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TC-_005bms_005d"><code>TC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TE-_005bms_005d"><code>TE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TL-_005bms_005d"><code>TL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TS-_005bms_005d"><code>TS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-UL-_005bms_005d"><code>UL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-VE-_005bman_005d"><code>VE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-VS-_005bman_005d"><code>VS <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-X">X</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XA-_005bms_005d"><code>XA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XE-_005bms_005d"><code>XE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XH-_005bms_005d"><code>XH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XH_002dREPLACEMENT-_005bms_005d"><code>XH-REPLACEMENT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XH_002dUPDATE_002dTOC-_005bms_005d"><code>XH-UPDATE-TOC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XN-_005bms_005d"><code>XN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XN_002dINIT-_005bms_005d"><code>XN-INIT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XN_002dREPLACEMENT-_005bms_005d"><code>XN-REPLACEMENT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XP-_005bms_005d"><code>XP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-XS-_005bms_005d"><code>XS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="ma-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-1"><b>1</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-2"><b>2</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-3"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-4"><b></b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-X"><b>X</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="String-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#File-Keyword-Index" accesskey="n" rel="next">File Keyword Index</a>, Previous: <a href="#Macro-Index" accesskey="p" rel="prev">Macro Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="String-Index-1">Appendix G String Index</h2>
+
+<p>The macro package or program a that defines or uses each string is
+appended in brackets. (Only one string, <code class="code">.T</code>, is defined by the
+<code class="code">troff</code> formatter itself.)  See <a class="xref" href="#Strings">Strings</a>.
+</p>
+
+<div class="printindex st-printindex">
+<table class="st-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#String-Index_st_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-2"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-3"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-4"><b>,</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-5"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-6"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-7"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-8"><b>3</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-9"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-11"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-12"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-13"><b>?</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-14"><b>^</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-15"><b>_</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-16"><b>`</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-17"><b>{</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-18"><b>}</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-19"><b>~</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#String-Index_st_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="st-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-1">!</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0021-_005bms_005d"><code>! <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-2">'</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027-_005bms_005d"><code><code class="code">'</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027-_005bms_005d-1"><code><code class="code">'</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-3">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002a-_005bms_005d"><code>* <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-4">,</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002c-_005bms_005d"><code>, <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002c-_005bms_005d-1"><code>, <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-5">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d-_005bms_005d"><code>- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typographical-symbols-in-ms">Typographical symbols in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-6">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002e-_005bms_005d"><code>. <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eT"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eT-1"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-7">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f-_005bms_005d"><code>/ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-8">3</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-3-_005bms_005d"><code>3 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-9">8</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-8-_005bms_005d"><code>8 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-10">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003a-_005bms_005d"><code>: <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003a-_005bms_005d-1"><code>: <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-11">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c-_005bms_005d"><code>&lt; <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-12">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003e-_005bms_005d"><code>&gt; <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-13">?</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003f-_005bms_005d"><code>? <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-14">^</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005e-_005bms_005d"><code>^ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005e-_005bms_005d-1"><code>^ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-15">_</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005f-_005bms_005d"><code>_ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-16">`</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0060-_005bms_005d"><code><code class="code">`</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0060-_005bms_005d-1"><code><code class="code">`</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-17">{</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007b-_005bms_005d"><code>{ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-18">}</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007d-_005bms_005d"><code>} <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typeface-and-decoration">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-19">~</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007e-_005bms_005d"><code>~ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007e-_005bms_005d-1"><code>~ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ABSTRACT-_005bms_005d"><code>ABSTRACT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ae-_005bms_005d"><code>ae <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Ae-_005bms_005d"><code>Ae <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-C-_005bms_005d"><code>C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CF-_005bms_005d"><code>CF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CH-_005bms_005d"><code>CH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-d_002d-_005bms_005d"><code>d- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-D_002d-_005bms_005d"><code>D- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FAM-_005bms_005d"><code>FAM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-FR-_005bms_005d"><code>FR <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LF-_005bms_005d"><code>LF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-LH-_005bms_005d"><code>LH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH1-_005bms_005d"><code>MONTH1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH10-_005bms_005d"><code>MONTH10 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH11-_005bms_005d"><code>MONTH11 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH12-_005bms_005d"><code>MONTH12 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH2-_005bms_005d"><code>MONTH2 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH3-_005bms_005d"><code>MONTH3 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH4-_005bms_005d"><code>MONTH4 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH5-_005bms_005d"><code>MONTH5 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH6-_005bms_005d"><code>MONTH6 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH7-_005bms_005d"><code>MONTH7 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH8-_005bms_005d"><code>MONTH8 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-MONTH9-_005bms_005d"><code>MONTH9 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-o-_005bms_005d"><code>o <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-oe-_005bms_005d"><code>oe <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-OE-_005bms_005d"><code>OE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Q-_005bms_005d"><code>Q <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typographical-symbols-in-ms">Typographical symbols in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-q-_005bms_005d"><code>q <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-REFERENCES-_005bms_005d"><code>REFERENCES <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RF-_005bms_005d"><code>RF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-RH-_005bms_005d"><code>RH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SN-_005bms_005d"><code>SN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SN_002dDOT-_005bms_005d"><code>SN-DOT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SN_002dNO_002dDOT-_005bms_005d"><code>SN-NO-DOT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SN_002dSTYLE-_005bms_005d"><code>SN-STYLE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SN_002dSTYLE-_005bms_005d-1"><code>SN-STYLE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-th-_005bms_005d"><code>th <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Th-_005bms_005d"><code>Th <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TOC-_005bms_005d"><code>TOC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-U-_005bms_005d"><code>U <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typographical-symbols-in-ms">Typographical symbols in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-v-_005bms_005d"><code>v <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="st-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#String-Index_st_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-2"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-3"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-4"><b>,</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-5"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-6"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-7"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-8"><b>3</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-9"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-11"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-12"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-13"><b>?</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-14"><b>^</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-15"><b>_</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-16"><b>`</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-17"><b>{</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-18"><b>}</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-19"><b>~</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#String-Index_st_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="File-Keyword-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Program-and-File-Index" accesskey="n" rel="next">Program and File Index</a>, Previous: <a href="#String-Index" accesskey="p" rel="prev">String Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="File-Keyword-Index-1">Appendix H File Keyword Index</h2>
+
+<div class="printindex ky-printindex">
+<table class="ky-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-1"><b>#</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-2"><b>-</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="ky-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_symbol-1">#</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0023"><code>#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0023-1"><code>#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_symbol-2">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002d_002d"><code>---</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-biggestfont"><code>biggestfont</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-charset"><code>charset</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-charset-1"><code>charset</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-family"><code>family</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-family-1"><code>family</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts-1"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts-2"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hor"><code>hor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-image_005fgenerator"><code>image_generator</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kernpairs"><code>kernpairs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligatures"><code>ligatures</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name"><code>name</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paperlength"><code>paperlength</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize"><code>papersize</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paperwidth"><code>paperwidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pass_005ffilenames"><code>pass_filenames</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-postpro"><code>postpro</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-prepro"><code>prepro</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-print"><code>print</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-res"><code>res</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sizes"><code>sizes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sizescale"><code>sizescale</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-slant"><code>slant</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacewidth"><code>spacewidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spare1"><code>spare1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spare2"><code>spare2</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-1"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-styles"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-styles-1"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-styles-2"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tcommand"><code>tcommand</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unicode"><code>unicode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unitwidth"><code>unitwidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unscaled_005fcharwidths"><code>unscaled_charwidths</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-use_005fcharnames_005fin_005fspecial"><code>use_charnames_in_special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-use_005fcharnames_005fin_005fspecial-1"><code>use_charnames_in_special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vert"><code>vert</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="ky-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-1"><b>#</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-2"><b>-</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Program-and-File-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="#Concept-Index" accesskey="n" rel="next">Concept Index</a>, Previous: <a href="#File-Keyword-Index" accesskey="p" rel="prev">File Keyword Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Program-and-File-Index-1">Appendix I Program and File Index</h2>
+
+<div class="printindex pg-printindex">
+<table class="pg-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="pg-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-an_002etmac"><code>an.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#man">man</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changebar"><code>changebar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-composite_002etmac"><code>composite.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cp1047_002etmac"><code>cp1047.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs_002etmac"><code>cs.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-de_002etmac"><code>de.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-1"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-2"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-3"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-4"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diffmk"><code>diffmk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ec_002etmac"><code>ec.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-en_002etmac"><code>en.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-eqn"><code>eqn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fr_002etmac"><code>fr.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-freeeuro_002epfa"><code>freeeuro.pfa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gchem"><code>gchem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gdiffmk"><code>gdiffmk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-geqn"><code>geqn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ggrn"><code>ggrn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gpic"><code>gpic</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-grap"><code>grap</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-grefer"><code>grefer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff"><code>groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gsoelim"><code>gsoelim</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gtbl"><code>gtbl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gtroff"><code>gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-it_002etmac"><code>it.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-J">J</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ja_002etmac"><code>ja.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-latin1_002etmac"><code>latin1.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-latin2_002etmac"><code>latin2.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-latin5_002etmac"><code>latin5.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-latin9_002etmac"><code>latin9.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-makeindex"><code>makeindex</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indexing">Indexing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man_002elocal"><code>man.local</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man_002etmac"><code>man.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#man">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man_002eultrix"><code>man.ultrix</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nrchbar"><code>nrchbar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-papersize_002etmac"><code>papersize.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-perl"><code>perl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pic"><code>pic</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-post_002dgrohtml"><code>post-grohtml</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pre_002dgrohtml"><code>pre-grohtml</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-preconv"><code>preconv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-refer"><code>refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-soelim"><code>soelim</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sv_002etmac"><code>sv.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tbl"><code>tbl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trace_002etmac"><code>trace.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc-1"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc-2"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc-3"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc-4"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc_002dend"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc_002dend-1"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troffrc_002dend-2"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tty_002etmac"><code>tty.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tty_002etmac-1"><code>tty.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vtroff"><code>vtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-Z">Z</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-zh_002etmac"><code>zh.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="pg-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+<hr>
+</div>
+<div class="appendix-level-extent" id="Concept-Index">
+<div class="nav-panel">
+<p>
+Previous: <a href="#Program-and-File-Index" accesskey="p" rel="prev">Program and File Index</a>, Up: <a href="#Top" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h2 class="appendix" id="Concept-Index-1">Appendix J Concept Index</h2>
+
+<div class="printindex cp-printindex">
+<table class="cp-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-1"><b>&quot;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-4"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-5"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-6"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-7"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-8"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-9"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-10"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-11"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-12"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-13"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-14"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-15"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-16"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-17"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-18"><b>\</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-19"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-20"><b>|</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="cp-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-1">&quot;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022_002c-as-delimiter"><code class="code">&quot;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022_002c-at-end-of-sentence"><code class="code">&quot;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022_002c-at-end-of-sentence-1"><code class="code">&quot;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0022_002c-embedding-in-a-macro-argument"><code class="code">&quot;</code>, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0025_002c-as-delimiter"><code class="code">%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-3">&amp;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0026_002c-as-delimiter"><code class="code">&amp;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-4">'</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027_002c-as-a-comment"><code class="code">'</code>, as a comment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027_002c-as-delimiter"><code class="code">'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027_002c-at-end-of-sentence"><code class="code">'</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0027_002c-at-end-of-sentence-1"><code class="code">'</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-5">(</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0028_002c-as-delimiter"><code class="code">(</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-6">)</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0029_002c-as-delimiter"><code class="code">)</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0029_002c-at-end-of-sentence"><code class="code">)</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_0029_002c-at-end-of-sentence-1"><code class="code">)</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-7">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002a_002c-as-delimiter"><code class="code">*</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002a_002c-at-end-of-sentence"><code class="code">*</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002a_002c-at-end-of-sentence-1"><code class="code">*</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-8">+</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002b_002c-and-page-motion"><code class="code">+</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002b_002c-as-delimiter"><code class="code">+</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-9">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002c-and-page-motion"><code class="code">-</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002d_002c-as-delimiter"><code class="code">-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-10">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002e_002c-as-delimiter"><code class="code">.</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eh-register_002c-difference-from-nl"><code class="code">.h</code> register, difference from <code class="code">nl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eps-register_002c-in-comparison-with-_002epsr"><code class="code">.ps</code> register, in comparison with <code class="code">.psr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002es-register_002c-in-comparison-with-_002esr"><code class="code">.s</code> register, in comparison with <code class="code">.sr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eS-register_002c-Plan-9-alias-for-_002etabs"><code class="code">.S</code> register, Plan&nbsp;9 alias for <code class="code">.tabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002et-register_002c-and-diversions"><code class="code">.t</code> register, and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002etabs-register_002c-Plan-9-alias-_0028_002eS_0029"><code class="code">.tabs</code> register, Plan&nbsp;9 alias (<code class="code">.S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002eV-register_002c-and-vs"><code class="code">.V</code> register, and <code class="code">vs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-11">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_002f_002c-as-delimiter"><code class="code">/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-12">8</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-8_002dbit-input">8-bit input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-13">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003a_002c-as-delimiter"><code class="code">:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-14">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003c_002c-as-delimiter"><code class="code">&lt;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-15">=</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003d_002c-as-delimiter"><code class="code">=</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-16">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_003e_002c-as-delimiter"><code class="code">&gt;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-17"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005b_002c-macro-names-starting-with_002c-and-refer"><code class="code"></code>, macro names starting with, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-18">\</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-and-copy-mode"><code class="code">\!</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-and-output-request"><code class="code">\!</code>, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-and-trnt"><code class="code">\!</code>, and <code class="code">trnt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-as-delimiter"><code class="code">\!</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-as-delimiter-1"><code class="code">\!</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-in-top_002dlevel-diversion"><code class="code">\!</code>, in top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\!</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff-1"><code class="code">\!</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0024_002c-when-reading-text-for-a-macro"><code class="code">\$</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-and-translations"><code class="code">\%</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-as-delimiter"><code class="code">\%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-as-delimiter-1"><code class="code">\%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-following-_005cX-or-_005cY"><code class="code">\%</code>, following <code class="code">\X</code> or <code class="code">\Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-in-_005cX"><code class="code">\%</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0025_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\%</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-and-glyph-definitions"><code class="code">\&amp;</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-and-translations"><code class="code">\&amp;</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-as-delimiter"><code class="code">\&amp;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-at-end-of-sentence"><code class="code">\&amp;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-in-_005cX"><code class="code">\&amp;</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0026_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\&amp;</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0027_002c-and-translations"><code class="code">\'</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0027_002c-as-delimiter"><code class="code">\'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0027_002c-as-delimiter-1"><code class="code">\'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0027_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\'</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0028_002c-and-translations"><code class="code">$</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0029_002c-as-delimiter"><code class="code">$</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0029_002c-in-_005cX"><code class="code">\)</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002a_002c-and-warnings"><code class="code">\*</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002a_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\*</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002a_002c-when-reading-text-for-a-macro"><code class="code">\*</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002c-disabling-_0028eo_0029"><code class="code">\</code>, disabling (<code class="code">eo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002c-embedding-in-a-macro-argument"><code class="code">\</code>, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002c_002c-as-delimiter"><code class="code">\,</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d-glyph_002c-and-cflags"><code class="code">\-</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d_002c-and-translations"><code class="code">\-</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d_002c-as-delimiter"><code class="code">\-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d_002c-as-delimiter-1"><code class="code">\-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002d_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\-</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002f_002c-as-delimiter"><code class="code">\/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_002f_002c-as-delimiter-1"><code class="code">\/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c0_002c-as-delimiter"><code class="code">\0</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003a_002c-as-delimiter"><code class="code">\:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003a_002c-as-delimiter-1"><code class="code">\:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003a_002c-in-_005cX"><code class="code">\:</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f_002c-and-copy-mode"><code class="code">\?</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f_002c-and-copy-mode-1"><code class="code">\?</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f_002c-as-delimiter"><code class="code">\?</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f_002c-in-top_002dlevel-diversion"><code class="code">\?</code>, in top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_003f_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\?</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ca_002c-and-copy-mode"><code class="code">\a</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ca_002c-and-translations"><code class="code">\a</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ca_002c-as-delimiter"><code class="code">\a</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cA_002c-delimiters-allowed-by"><code class="code">\A</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cA_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\A</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cb_002c-delimiters-allowed-by"><code class="code">\b</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cb_002c-limitations-of"><code class="code">\b</code>, limitations of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cC_002c-and-translations"><code class="code">\C</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc_002c-as-delimiter"><code class="code">\c</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc_002c-as-delimiter-1"><code class="code">\c</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\c</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc_002c-when-filling-disabled"><code class="code">\c</code>, when filling disabled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cc_002c-when-filling-enabled"><code class="code">\c</code>, when filling enabled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cd_002c-as-delimiter"><code class="code">\d</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cD_002c-delimiters-allowed-by"><code class="code">\D</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce_002c-and-glyph-definitions"><code class="code">\e</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce_002c-and-translations"><code class="code">\e</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce_002c-as-delimiter"><code class="code">\e</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cE_002c-as-delimiter"><code class="code">\E</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce_002c-as-delimiter-1"><code class="code">\e</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ce_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\e</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cF_002c-and-changing-fonts"><code class="code">\F</code>, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cf_002c-and-font-translations"><code class="code">\f</code>, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cf_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\f</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ch_002c-delimiters-allowed-by"><code class="code">\h</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH_002c-delimiters-allowed-by"><code class="code">\H</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\H</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH_002c-using-_002b-and-_002d-with"><code class="code">\H</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cH_002c-with-fractional-type-sizes"><code class="code">\H</code>, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cl_002c-and-glyph-definitions"><code class="code">\l</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cL_002c-and-glyph-definitions"><code class="code">\L</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cl_002c-delimiters-allowed-by"><code class="code">\l</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cL_002c-delimiters-allowed-by"><code class="code">\L</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cN_002c-and-translations"><code class="code">\N</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cn_002c-and-warnings"><code class="code">\n</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cN_002c-delimiters-allowed-by"><code class="code">\N</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cn_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\n</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cn_002c-when-reading-text-for-a-macro"><code class="code">\n</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005co_002c-delimiters-allowed-by"><code class="code">\o</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cp_002c-as-delimiter"><code class="code">\p</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cp_002c-as-delimiter-1"><code class="code">\p</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR_002c-after-_005cc"><code class="code">\R</code>, after <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR_002c-and-warnings"><code class="code">\R</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cr_002c-as-delimiter"><code class="code">\r</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR_002c-delimiters-allowed-by"><code class="code">\R</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR_002c-difference-from-nr"><code class="code">\R</code>, difference from <code class="code">nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cR_002c-using-_002b-and-_002d-with"><code class="code">\R</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cRET_002c-when-reading-text-for-a-macro">\<kbd class="key">RET</kbd>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs_002c-delimiters-allowed-by"><code class="code">\s</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cS_002c-delimiters-allowed-by"><code class="code">\S</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\s</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cS_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\S</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs_002c-incompatibilities-with-AT_0026T-troff-1"><code class="code">\s</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs_002c-using-_002b-and-_002d-with"><code class="code">\s</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cs_002c-with-fractional-type-sizes"><code class="code">\s</code>, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cSP_002c-as-delimiter"><code class="code">\<kbd class="key">SP</kbd></code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cSP_002c-difference-from-_005c_007e"><code class="code">\<kbd class="key">SP</kbd></code>, difference from <code class="code">\~</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cSP_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\<kbd class="key">SP</kbd></code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ct_002c-and-copy-mode"><code class="code">\t</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ct_002c-and-translations"><code class="code">\t</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ct_002c-and-warnings"><code class="code">\t</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005ct_002c-as-delimiter"><code class="code">\t</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cu_002c-as-delimiter"><code class="code">\u</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cV_002c-and-copy-mode"><code class="code">\V</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cv_002c-delimiters-allowed-by"><code class="code">\v</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cv_002c-internal-representation"><code class="code">\v</code>, internal representation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cw_002c-delimiters-allowed-by"><code class="code">\w</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cX_002c-and-special-characters"><code class="code">\X</code>, and special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cX_002c-delimiters-allowed-by"><code class="code">\X</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cx_002c-delimiters-allowed-by"><code class="code">\x</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cX_002c-followed-by-_005c_0025"><code class="code">\X</code>, followed by <code class="code">\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cY_002c-followed-by-_005c_0025"><code class="code">\Y</code>, followed by <code class="code">\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005cZ_002c-delimiters-allowed-by"><code class="code">\Z</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005b_002c-and-translations"><code class="code">\</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005c_002c-when-reading-text-for-a-macro"><code class="code">\\</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005e_002c-as-delimiter"><code class="code">\^</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005e_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\^</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005f_002c-and-translations"><code class="code">\_</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005f_002c-as-delimiter"><code class="code">\_</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005f_002c-as-delimiter-1"><code class="code">\_</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_005f_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\_</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0060_002c-and-translations"><code class="code">\`</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0060_002c-as-delimiter"><code class="code">\`</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0060_002c-as-delimiter-1"><code class="code">\`</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_0060_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\`</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007b_002c-as-delimiter"><code class="code">\{</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007b_002c-as-delimiter-1"><code class="code">\{</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007b_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\{</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007c_002c-as-delimiter"><code class="code">\|</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007c_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\|</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007d_002c-and-warnings"><code class="code">\}</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007d_002c-as-delimiter"><code class="code">\}</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007d_002c-as-delimiter-1"><code class="code">\}</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007d_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\}</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007e_002c-and-translations"><code class="code">\~</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007e_002c-as-delimiter"><code class="code">\~</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007e_002c-difference-from-_005cSP"><code class="code">\~</code>, difference from <code class="code">\<kbd class="key">SP</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005c_007e_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\~</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-19"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005d_002c-as-part-of-an-identifier"><code class="code"></code>, as part of an identifier</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005d_002c-at-end-of-sentence"><code class="code"></code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005d_002c-at-end-of-sentence-1"><code class="code"></code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_005d_002c-macro-names-starting-with_002c-and-refer"><code class="code"></code>, macro names starting with, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-20">|</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-_007c_002c-and-page-motion"><code class="code">|</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ab-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ab</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-aborting-_0028ab_0029">aborting (<code class="code">ab</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-absolute-_0028sic_0029-position-operator-_0028_007c_0029">absolute <i class="slanted">(sic)</i> position operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-abstract-font-style">abstract font style</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-abstract-font-style_002c-setting-up-_0028sty_0029">abstract font style, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accent-marks-_005bms_005d">accent marks <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-access-to-postprocessor">access to postprocessor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-accessing-unnamed-glyphs-with-_005cN">accessing unnamed glyphs with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-activating-kerning-_0028kern_0029">activating kerning (<code class="code">kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-activating-ligatures-_0028lg_0029">activating ligatures (<code class="code">lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-activating-track-kerning-_0028tkf_0029">activating track kerning (<code class="code">tkf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ad-request_002c-and-hyphenation-margin"><code class="code">ad</code> request, and hyphenation margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ad-request_002c-and-hyphenation-space"><code class="code">ad</code> request, and hyphenation space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-addition">addition</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-additional-inter_002dsentence-space">additional inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-adjustment-and-filling_002c-manipulating">adjustment and filling, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-adjustment-mode-register-_0028_002ej_0029">adjustment mode register (<code class="code">.j</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-adjustment-to-both-margins_002c-difference-from-AT_0026T-troff">adjustment to both margins, difference from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Adobe-Glyph-List-_0028AGL_0029">Adobe Glyph List (AGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-diversion_002c-creating-_0028als_0029">alias, diversion, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-diversion_002c-removing-_0028rm_0029">alias, diversion, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-macro_002c-creating-_0028als_0029">alias, macro, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-macro_002c-removing-_0028rm_0029">alias, macro, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-register_002c-creating-_0028aln_0029">alias, register, creating (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-register_002c-removing-_0028rr_0029">alias, register, removing (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-string_002c-creating-_0028als_0029">alias, string, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-alias_002c-string_002c-removing-_0028rm_0029">alias, string, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-aliasing-fonts-with-third-argument-to-fp-request">aliasing fonts with third argument to <code class="code">fp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-als-request_002c-and-_005c_00240"><code class="code">als</code> request, and <code class="code">\$0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-am_002c-am1_002c-ami-requests_002c-and-warnings"><code class="code">am</code>, <code class="code">am1</code>, <code class="code">ami</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-appending-to-a-diversion-_0028da_002c-boxa_0029">appending to a diversion (<code class="code">da</code>, <code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-appending-to-a-file-_0028opena_0029">appending to a file (<code class="code">opena</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-appending-to-a-macro-_0028am_0029">appending to a macro (<code class="code">am</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-appending-to-a-string-_0028as_0029">appending to a string (<code class="code">as</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-approximation-output-register-_0028_002eA_0029">approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029">arc, drawing (&lsquo;<samp class="samp">\D'a &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-argument">argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments-to-macros">arguments to macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments-to-macros_002c-and-tabs">arguments to macros, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments-to-requests">arguments to requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments-to-requests_002c-and-tabs">arguments to requests, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments_002c-and-compatibility-mode">arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments_002c-to-escape-sequences_002c-delimiting">arguments, to escape sequences, delimiting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arguments_002c-to-strings">arguments, to strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-arithmetic-operators">arithmetic operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-artificial-fonts">artificial fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-as_002c-as1-requests_002c-and-comments"><code class="code">as</code>, <code class="code">as1</code> requests, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-as_002c-as1-requests_002c-and-warnings"><code class="code">as</code>, <code class="code">as1</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ASCII-output-encoding"><abbr class="acronym">ASCII</abbr> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-asciify-request_002c-and-writem"><code class="code">asciify</code> request, and <code class="code">writem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-assertion-_0028arithmetic-operator_0029">assertion (arithmetic operator)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-assign-number-format-to-register-_0028af_0029">assign number format to register (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-assignments_002c-indirect">assignments, indirect</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-assignments_002c-nested">assignments, nested</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-AT_0026T-ms_002c-macro-package-differences"><abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>, macro package differences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Differences-from-AT_0026T-ms">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-attributes_002c-character-cell">attributes, character cell</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-auto_002dincrementation-of-a-register">auto-incrementation of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-automatic-font-mounting">automatic font mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-automatic-hyphenation">automatic hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-automatic-hyphenation-parameters">automatic hyphenation parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-auxiliary-macro-package">auxiliary macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-available-glyphs_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">available glyphs, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-background">background</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Background">Background</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-background-color-name-register-_0028_002eM_0029">background color name register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backslash-glyph_002c-formatting-_0028_005c_005brs_005d_0029">backslash glyph, formatting (<code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backslash_002c-embedding-in-a-macro-argument">backslash, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backslash_002c-printing-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029">backslash, printing (<code class="code">\\</code>, <code class="code">\e</code>, <code class="code">\E</code>, <code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backspace-character_002c-and-translations">backspace character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-backtrace-of-input-stack-_0028backtrace_0029">backtrace of input stack (<code class="code">backtrace</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-baseline-rule-special-character_0028_005c_005bru_005d_0029">baseline rule special character(<code class="code">\ru</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-baseline_002c-text">baseline, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-baseline_002c-text-1">baseline, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-basic-scaling-unit-_0028u_0029">basic scaling unit (<code class="code">u</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-basic-units">basic units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-basic-units_002c-conversion-to">basic units, conversion to</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-basics-of-macro-package-usage">basics of macro package usage</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bd-request_002c-and-font-styles"><code class="code">bd</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bd-request_002c-and-font-translations"><code class="code">bd</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bd-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">bd</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-beginning-diversion-_0028di_002c-box_0029">beginning diversion (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-beginning-of-conditional-block-_0028_005c_007b_0029">beginning of conditional block (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line">blank line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line-macro-_0028blm_0029">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line-macro-_0028blm_0029-1">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line-macro-_0028blm_0029-2">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Blank-Line-Traps">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line-trap-_0028blm_0029">blank line trap (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-line-traps">blank line traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Blank-Line-Traps">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blank-lines_002c-disabling">blank lines, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-block_002c-conditional_002c-beginning-_0028_005c_007b_0029">block, conditional, beginning (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-block_002c-conditional_002c-end-_0028_005c_007d_0029">block, conditional, end (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-blocks_002c-conditional">blocks, conditional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-body_002c-of-a-while-request">body, of a while request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boldface_002c-imitating-_0028bd_0029">boldface, imitating (<code class="code">bd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bottom-margin">bottom margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boundary_002drelative-motion-operator-_0028_007c_0029">boundary-relative motion operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bounding-box">bounding box</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-box-_0028diversion-operation_0029">box (diversion operation)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-box-request_002c-and-warnings"><code class="code">box</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-box-rule-glyph-_0028_005c_005bbr_005d_0029">box rule glyph (<code class="code">\br</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-box_002c-boxa-requests_002c-and-warnings"><code class="code">box</code>, <code class="code">boxa</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boxa-request_002c-and-dn-_0028dl_0029"><code class="code">boxa</code> request, and <code class="code">dn</code> (<code class="code">dl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boxa-request_002c-and-warnings"><code class="code">boxa</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-boxes-_005bms_005d">boxes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp-request_002c-and-top_002dlevel-diversion"><code class="code">bp</code> request, and top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp-request_002c-and-traps-_0028_002epe_0029"><code class="code">bp</code> request, and traps (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp-request_002c-causing-implicit-break"><code class="code">bp</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">bp</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bp-request_002c-using-_002b-and-_002d-with"><code class="code">bp</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-br-glyph_002c-and-cflags"><code class="code">br</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-brace-escape-sequence_002c-closing-_0028_005c_007d_0029">brace escape sequence, closing (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-brace-escape-sequence_002c-opening-_0028_005c_007d_0029">brace escape sequence, opening (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-brace-escape-sequences-_0028_005c_007b_002c-_005c_007d_0029">brace escape sequences (<code class="code">\{</code>, <code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break">break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break-1">break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break-_0028introduction_0029">break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break-request_002c-in-a-while-loop"><code class="code">break</code> request, in a <code class="code">while</code> loop</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page-1">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page-2">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page-_0028introduction_0029">break, page (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page_002c-final">break, page, final</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-break_002c-page_002c-prevented-by-vpt">break, page, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-breaking-file-names-_0028_005c_003a_0029">breaking file names (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-breaking-URLs-_0028_005c_003a_0029">breaking URLs (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-breaking-without-hyphens-_0028_005c_003a_0029">breaking without hyphens (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-built_002din-register_002c-removing">built-in register, removing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-built_002din-registers">built-in registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-bulleted-list_002c-example-markup-_005bms_005d">bulleted list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-c-scaling-unit"><code class="code">c</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-calling-a-macro">calling a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-calling-macros">calling macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-capabilities-of-groff">capabilities of <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#groff-Capabilities"><code class="code">groff</code> Capabilities</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-case_002dtransforming-a-string-_0028stringdown_002c-stringup_0029">case-transforming a string (<code class="code">stringdown</code>, <code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-categories_002c-warning">categories, warning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CCSID-1047-output-encoding-_0028EBCDIC_0029">CCSID 1047 output encoding (EBCDIC)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ce-request_002c-causing-implicit-break"><code class="code">ce</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ce-request_002c-difference-from-_002ead-c"><code class="code">ce</code> request, difference from &lsquo;<samp class="samp">.ad&nbsp;c</samp>&rsquo;</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cell_002c-character_002c-attributes">cell, character, attributes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-centered-text-_0028filled_0029">centered text (filled)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-centered-text-_0028unfilled_0029">centered text (unfilled)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-centering-lines-_0028ce_0029">centering lines (<code class="code">ce</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-centering-lines-_0028introduction_0029">centering lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-centimeter-scaling-unit-_0028c_0029">centimeter scaling unit (<code class="code">c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cf-request_002c-and-copy-mode"><code class="code">cf</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cf-request_002c-causing-implicit-break"><code class="code">cf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-control-characters">changing control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-font-family-_0028fam_002c-_005cF_0029">changing font family (<code class="code">fam</code>, <code class="code">\F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-fonts-_0028ft_002c-_005cf_0029">changing fonts (<code class="code">ft</code>, <code class="code">\f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-format_002c-and-read_002donly-registers">changing format, and read-only registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-the-font-height-_0028_005cH_0029">changing the font height (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-the-font-slant-_0028_005cS_0029">changing the font slant (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-the-page-number-character-_0028pc_0029">changing the page number character (<code class="code">pc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-trap-location-_0028ch_0029">changing trap location (<code class="code">ch</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-type-sizes-_0028ps_002c-_005cs_0029">changing type sizes (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-changing-vertical-line-spacing-_0028vs_0029">changing vertical line spacing (<code class="code">vs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-char-request_002c-and-soft-hyphen-character"><code class="code">char</code> request, and soft hyphen character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-char-request_002c-and-translations"><code class="code">char</code> request, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-char-request_002c-used-with-_005cN"><code class="code">char</code> request, used with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character">character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-cell-attributes">character cell attributes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-class-_0028class_0029">character class (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-classes">character classes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-properties-_0028cflags_0029">character properties (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character-translations">character translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-backspace_002c-and-translations">character, backspace, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-control-_0028_002e_0029">character, control (<code class="code">.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-control_002c-changing-_0028cc_0029">character, control, changing (<code class="code">cc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-defining-_0028char_0029">character, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-defining-fallback-_0028fchar_002c-fschar_002c-schar_0029">character, defining fallback (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-distinguished-from-glyph">character, distinguished from glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-dummy-_0028_005c_0026_0029">character, dummy (<code class="code">\&amp;</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-dummy-_0028_005c_0026_0029_002c-as-control-character-suppressor">character, dummy (<code class="code">\&amp;</code>), as control character suppressor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-kerning">character, dummy (<code class="code">\&amp;</code>), effect on kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence">character, dummy (<code class="code">\&amp;</code>), effect on <code class="code">\l</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-escape_002c-changing-_0028ec_0029">character, escape, changing (<code class="code">ec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-escape_002c-while-defining-glyph">character, escape, while defining glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-field-delimiting-_0028fc_0029">character, field delimiting (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-field-padding-_0028fc_0029">character, field padding (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-horizontal-tab">character, horizontal tab</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-hyphenation-_0028_005c_0025_0029">character, hyphenation (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-leader">character, leader</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-leader-repetition-_0028lc_0029">character, leader repetition (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-leader_002c-and-translations">character, leader, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-leader_002c-non_002dinterpreted-_0028_005ca_0029">character, leader, non-interpreted (<code class="code">\a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-named-_0028_005cC_0029">character, named (<code class="code">\C</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-newline_002c-and-translations">character, newline, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-no_002dbreak-control-_0028_0027_0029">character, no-break control (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-no_002dbreak-control_002c-changing-_0028c2_0029">character, no-break control, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-ordinary">character, ordinary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-soft-hyphen_002c-setting-_0028shc_0029">character, soft hyphen, setting (<code class="code">shc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-special">character, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-tab-repetition-_0028tc_0029">character, tab repetition (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-tab_002c-and-translations">character, tab, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-tab_002c-non_002dinterpreted-_0028_005ct_0029">character, tab, non-interpreted (<code class="code">\t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-transparent">character, transparent</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-character_002c-transparent-dummy-_0028_005c_0029_0029">character, transparent dummy (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-end_002dof_002dsentence">characters, end-of-sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-end_002dof_002dsentence-transparent">characters, end-of-sentence transparent</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-hyphenation">characters, hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-input_002c-and-output-glyphs_002c-compatibility-with-AT_0026T-troff">characters, input, and output glyphs, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-invalid-for-trf-request">characters, invalid for <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-invalid-input">characters, invalid input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-overlapping">characters, overlapping</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-special">characters, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-special_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">characters, special, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-characters_002c-unnamed_002c-accessing-with-_005cN">characters, unnamed, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">circle, filled, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-circle_002c-outlined_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">circle, outlined, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-circle_002c-solid_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">circle, solid, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">circle, stroked, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-class-of-characters-_0028class_0029">class of characters (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-classes_002c-character">classes, character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-clearing-input-line-trap-_0028it_002c-itc_0029">clearing input line trap (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-closing-brace-escape-sequence-_0028_005c_007d_0029">closing brace escape sequence (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-closing-file-_0028close_0029">closing file (<code class="code">close</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-code-page-1047-output-encoding">code page 1047 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-code-page-1047_002c-input-encoding">code page 1047, input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-code_002c-hyphenation-_0028hcode_0029">code, hyphenation (<code class="code">hcode</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-name_002c-background_002c-register-_0028_002eM_0029">color name, background, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-name_002c-fill_002c-register-_0028_002eM_0029">color name, fill, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color-name_002c-stroke_002c-register-_0028_002em_0029">color name, stroke, register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color_002c-default">color, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color_002c-fill">color, fill</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-color_002c-stroke">color, stroke</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-colors">colors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-command-prefix">command prefix</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-command_002dline-options">command-line options</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments">comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments-in-device-description-files">comments in device description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments-in-font-description-files">comments in font description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-lining-up-with-tabs">comments, lining up with tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comments_002c-with-ds">comments, with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-common-features">common features</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Common-Features">Common Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-common-name-space-of-macros_002c-diversions_002c-and-strings">common name space of macros, diversions, and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comparison-of-strings">comparison of strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-comparison-operators">comparison operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compatibility-mode">compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compatibility-mode-1">compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-compatibility-mode_002c-and-parameters">compatibility mode, and parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-complementation_002c-logical">complementation, logical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-composite-glyph-names">composite glyph names</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-block_002c-beginning-_0028_005c_007b_0029">conditional block, beginning (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-block_002c-end-_0028_005c_007d_0029">conditional block, end (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-blocks">conditional blocks</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-expressions">conditional expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-output-for-terminal-_0028TTY_0029">conditional output for terminal (TTY)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditional-page-break-_0028ne_0029">conditional page break (<code class="code">ne</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conditionals-and-loops">conditionals and loops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditionals-and-Loops">Conditionals and Loops</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuring-control-characters">configuring control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-configuring-the-page-length-_0028pl_0029">configuring the page length (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-consecutive-hyphenated-lines-_0028hlm_0029">consecutive hyphenated lines (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-constant-glyph-space-mode-_0028cs_0029">constant glyph space mode (<code class="code">cs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-contents_002c-table-of">contents, table of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Table-of-Contents">Table of Contents</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-contents_002c-table-of-1">contents, table of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continuation_002c-input-line-_0028_005cRET_0029">continuation, input line (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continuation_002c-output-line-_0028_005cc_0029">continuation, output line (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continue-request_002c-in-a-while-loop"><code class="code">continue</code> request, in a <code class="code">while</code> loop</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continued-output-line-register-_0028_002eint_0029">continued output line register (<code class="code">.int</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-continuous-underlining-_0028cu_0029">continuous underlining (<code class="code">cu</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-character-_0028_002e_0029">control character (<code class="code">.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-character_002c-changing-_0028cc_0029">control character, changing (<code class="code">cc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-character_002c-no_002dbreak-_0028_0027_0029">control character, no-break (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-character_002c-no_002dbreak_002c-changing-_0028c2_0029">control character, no-break, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-characters">control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control-line">control line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control_002c-line">control, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-control_002c-page">control, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conventions-for-input">conventions for input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Conventions">Input Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-conversion-to-basic-units">conversion to basic units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode">copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode-1">copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-cf-request">copy mode, and <code class="code">cf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-device-request">copy mode, and <code class="code">device</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-length-request">copy mode, and <code class="code">length</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-macro-parameters">copy mode, and macro parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-output-request">copy mode, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-trf-request">copy mode, and <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-write-request">copy mode, and <code class="code">write</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-writec-request">copy mode, and <code class="code">writec</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-writem-request">copy mode, and <code class="code">writem</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005c_0021">copy mode, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005c_003f">copy mode, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005c_003f-1">copy mode, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005ca">copy mode, and <code class="code">\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005ct">copy mode, and <code class="code">\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copy-mode_002c-and-_005cV">copy mode, and <code class="code">\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-copying-environment-_0028evc_0029">copying environment (<code class="code">evc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-correction-between-oblique-and-upright-glyph-_0028_005c_002f_002c-_005c_002c_0029">correction between oblique and upright glyph (<code class="code">\/</code>, <code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-correction-between-upright-and-oblique-glyph-_0028_005c_002f_002c-_005c_002c_0029">correction between upright and oblique glyph (<code class="code">\/</code>, <code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-correction_002c-italic-_0028_005c_002f_0029">correction, italic (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-correction_002c-left-italic-_0028_005c_002c_0029">correction, left italic (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cover-page-in-_005bms_005d_002c-example-markup">cover page in <samp class="file">ms</samp>, example markup</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cp-request_002c-and-glyph-definitions"><code class="code">cp</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cq-glyph_002c-at-end-of-sentence"><code class="code">cq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cq-glyph_002c-at-end-of-sentence-1"><code class="code">cq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-creating-alias-for-register-_0028aln_0029">creating alias for register (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-creating-alias_002c-for-diversion-_0028als_0029">creating alias, for diversion (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-creating-alias_002c-for-macro-_0028als_0029">creating alias, for macro (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-creating-alias_002c-for-string-_0028als_0029">creating alias, for string (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-creating-new-characters-_0028char_0029">creating new characters (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-credits">credits</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Credits">Credits</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs-request_002c-and-font-styles"><code class="code">cs</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs-request_002c-and-font-translations"><code class="code">cs</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">cs</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-cs-request_002c-with-fractional-type-sizes"><code class="code">cs</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata-1">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata-2">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata-3">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata-4">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-errata-5">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-bp-request">CSTR&nbsp;#54 erratum, <code class="code">bp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-po-request">CSTR&nbsp;#54 erratum, <code class="code">po</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-ps-request">CSTR&nbsp;#54 erratum, <code class="code">ps</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-sb-register">CSTR&nbsp;#54 erratum, <code class="code">sb</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-st-register">CSTR&nbsp;#54 erratum, <code class="code">st</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-yr-register">CSTR&nbsp;#54 erratum, <code class="code">yr</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-_005cS-escape">CSTR&nbsp;#54 erratum, <code class="code">\S</code> escape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-CSTR-_002354-erratum_002c-_005cs-escape-sequence">CSTR&nbsp;#54 erratum, <code class="code">\s</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-directory">current directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-input-file-name-register-_0028_002eF_0029">current input file name register (<code class="code">.F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-page-number-_0028_0025_0029">current page number (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-time_002c-hours-_0028hours_0029">current time, hours (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-time_002c-minutes-_0028minutes_0029">current time, minutes (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-current-time_002c-seconds-_0028seconds_0029">current time, seconds (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-da-request_002c-and-dn-_0028dl_0029"><code class="code">da</code> request, and <code class="code">dn</code> (<code class="code">dl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-da-request_002c-and-warnings"><code class="code">da</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-da-request_002c-and-warnings-1"><code class="code">da</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-date_002c-day-of-the-month-register-_0028dy_0029">date, day of the month register (<code class="code">dy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-date_002c-day-of-the-week-register-_0028dw_0029">date, day of the week register (<code class="code">dw</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-date_002c-month-of-the-year-register-_0028mo_0029">date, month of the year register (<code class="code">mo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-date_002c-year-register-_0028year_002c-yr_0029">date, year register (<code class="code">year</code>, <code class="code">yr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-day-of-the-month-register-_0028dy_0029">day of the month register (<code class="code">dy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-day-of-the-week-register-_0028dw_0029">day of the week register (<code class="code">dw</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dd-glyph_002c-at-end-of-sentence"><code class="code">dd</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dd-glyph_002c-at-end-of-sentence-1"><code class="code">dd</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-de-request_002c-and-while"><code class="code">de</code> request, and <code class="code">while</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-de_002c-de1_002c-dei-requests_002c-and-warnings"><code class="code">de</code>, <code class="code">de1</code>, <code class="code">dei</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging">debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-debugging-page-location-traps">debugging page location traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-decimal-point_002c-as-delimiter">decimal point, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-decrementation_002c-automatic_002c-of-a-register">decrementation, automatic, of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-default-color">default color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-default-tab-stops">default tab stops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-default-units">default units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Default-Units">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-deferred-output">deferred output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Deferring-Output">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defining-character-_0028char_0029">defining character (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defining-character-class-_0028class_0029">defining character class (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defining-fallback-character-_0028fchar_002c-fschar_002c-schar_0029">defining fallback character (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defining-glyph-_0028char_0029">defining glyph (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-defining-symbol-_0028char_0029">defining symbol (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-delimited-arguments_002c-incompatibilities-with-AT_0026T-troff">delimited arguments, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-delimiters_002c-for-escape-sequence-arguments">delimiters, for escape sequence arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-delimiting-character_002c-for-fields-_0028fc_0029">delimiting character, for fields (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-delimiting-escape-sequence-arguments">delimiting escape sequence arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-depth_002c-interpolation">depth, interpolation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-depth_002c-of-last-glyph-_0028_002ecdp_0029">depth, of last glyph (<code class="code">.cdp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-file-format"><samp class="file">DESC</samp> file format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-file_002c-and-font-mounting"><samp class="file">DESC</samp> file, and font mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-DESC-file_002c-and-use_005fcharnames_005fin_005fspecial-keyword"><samp class="file">DESC</samp> file, and <code class="code">use_charnames_in_special</code> keyword</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-description-file_002c-font">description file, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-description-files_002c-comments">device description files, comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-request_002c-and-copy-mode"><code class="code">device</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-resolution">device resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-resolution-1">device resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-device-resolution_002c-obtaining-in-the-formatter">device resolution, obtaining in the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-devices-for-output">devices for output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Output-Device-Intro">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dg-glyph_002c-at-end-of-sentence"><code class="code">dg</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dg-glyph_002c-at-end-of-sentence-1"><code class="code">dg</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-di-request_002c-and-warnings"><code class="code">di</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-di-request_002c-and-warnings-1"><code class="code">di</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-differences-in-implementation">differences in implementation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Implementation-Differences">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-digit_002dwidth-space-_0028_005c0_0029">digit-width space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-digits_002c-as-delimiters">digits, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dimensions_002c-line">dimensions, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directories-for-fonts">directories for fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directories-for-macros">directories for macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-current">directory, current</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-for-tmac-files">directory, for tmac files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-home">directory, home</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-platform_002dspecific">directory, platform-specific</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-site_002dlocal">directory, site-local</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-directory_002c-site_002dlocal-1">directory, site-local</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-disabling-hyphenation-_0028_005c_0025_0029">disabling hyphenation (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-disabling-_005c-_0028eo_0029">disabling <code class="code">\</code> (<code class="code">eo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-discardable-horizontal-space">discardable horizontal space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-displays">displays</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Displays-and-Keeps">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-displays-_005bms_005d">displays <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-displays_002c-and-footnotes-_005bms_005d">displays, and footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-distance-to-next-vertical-position-trap-register-_0028_002et_0029">distance to next vertical position trap register (<code class="code">.t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion">diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Deferring-Output">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion-name-register-_0028_002ez_0029">diversion name register (<code class="code">.z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion-trap_002c-setting-_0028dt_0029">diversion trap, setting (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion-traps">diversion traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-appending-to-_0028da_002c-boxa_0029">diversion, appending to (<code class="code">da</code>, <code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-beginning-_0028di_002c-box_0029">diversion, beginning (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-creating-alias-for-_0028als_0029">diversion, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-ending-_0028di_002c-box_0029">diversion, ending (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-nested">diversion, nested</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-removing-_0028rm_0029">diversion, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-removing-alias-for-_0028rm_0029">diversion, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-renaming-_0028rn_0029">diversion, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-stripping-final-newline">diversion, stripping final newline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-top_002dlevel">diversion, top-level</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-top_002dlevel_002c-and-bp">diversion, top-level, and <code class="code">bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-top_002dlevel_002c-and-_005c_0021">diversion, top-level, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-top_002dlevel_002c-and-_005c_003f">diversion, top-level, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-unformatting-_0028asciify_0029">diversion, unformatting (<code class="code">asciify</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversion_002c-vertical-position-in_002c-register-_0028_002ed_0029">diversion, vertical position in, register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversions">diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversions-1">diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversions_002c-and-traps">diversions, and traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-diversions_002c-shared-name-space-with-macros-and-strings">diversions, shared name space with macros and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-division_002c-truncating">division, truncating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dl-register_002c-and-da-_0028boxa_0029"><code class="code">dl</code> register, and <code class="code">da</code> (<code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dn-register_002c-and-da-_0028boxa_0029"><code class="code">dn</code> register, and <code class="code">da</code> (<code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-document-description-macros_002c-_005bms_005d">document description macros, <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-document-formats">document formats</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Document-Formats">Document Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-documents_002c-multi_002dfile">documents, multi-file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-documents_002c-structuring-the-source-of">documents, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dot_002c-as-delimiter">dot, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-double-quote_002c-embedding-in-a-macro-argument">double quote, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-double-quotes_002c-trailing_002c-in-strings">double quotes, trailing, in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-double_002dspacing-_0028ls_0029">double-spacing (<code class="code">ls</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-double_002dspacing-_0028vs_002c-pvs_0029">double-spacing (<code class="code">vs</code>, <code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-down_002dcasing-a-string-_0028stringdown_0029">down-casing a string (<code class="code">stringdown</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-filled-circle-_0028_005cD_0027C-_2026_0027_0029">drawing a filled circle (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-filled-ellipse-_0028_005cD_0027E-_2026_0027_0029">drawing a filled ellipse (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-filled-polygon-_0028_005cD_0027P-_2026_0027_0029">drawing a filled polygon (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-line-_0028_005cD_0027l-_2026_0027_0029">drawing a line (&lsquo;<samp class="samp">\D'l &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-solid-circle-_0028_005cD_0027C-_2026_0027_0029">drawing a solid circle (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-solid-ellipse-_0028_005cD_0027E-_2026_0027_0029">drawing a solid ellipse (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-solid-polygon-_0028_005cD_0027P-_2026_0027_0029">drawing a solid polygon (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029">drawing a spline (&lsquo;<samp class="samp">\D'~ &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-stroked-circle-_0028_005cD_0027c-_2026_0027_0029">drawing a stroked circle (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-stroked-ellipse-_0028_005cD_0027e-_2026_0027_0029">drawing a stroked ellipse (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-a-stroked-polygon-_0028_005cD_0027p-_2026_0027_0029">drawing a stroked polygon (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-an-arc-_0028_005cD_0027a-_2026_0027_0029">drawing an arc (&lsquo;<samp class="samp">\D'a &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-an-outlined-circle-_0028_005cD_0027c-_2026_0027_0029">drawing an outlined circle (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-an-outlined-ellipse-_0028_005cD_0027e-_2026_0027_0029">drawing an outlined ellipse (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-an-outlined-polygon-_0028_005cD_0027p-_2026_0027_0029">drawing an outlined polygon (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-horizontal-lines-_0028_005cl_0029">drawing horizontal lines (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-position">drawing position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-position_002c-vertical-_0028nl_0029">drawing position, vertical (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-requests">drawing requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-drawing-vertical-lines-_0028_005cL_0029">drawing vertical lines (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds-request_002c-and-comments"><code class="code">ds</code> request, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds-request_002c-and-double-quotes"><code class="code">ds</code> request, and double quotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds-request_002c-and-leading-spaces"><code class="code">ds</code> request, and leading spaces</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds_002c-ds1-requests_002c-and-comments"><code class="code">ds</code>, <code class="code">ds1</code> requests, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ds_002c-ds1-requests_002c-and-warnings"><code class="code">ds</code>, <code class="code">ds1</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-character-_0028_005c_0026_0029">dummy character (<code class="code">\&amp;</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-character-_0028_005c_0026_0029_002c-as-control-character-suppressor">dummy character (<code class="code">\&amp;</code>), as control character suppressor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-character-_0028_005c_0026_0029_002c-effect-on-kerning">dummy character (<code class="code">\&amp;</code>), effect on kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-character-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence">dummy character (<code class="code">\&amp;</code>), effect on <code class="code">\l</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-character_002c-transparent-_0028_005c_0029_0029">dummy character, transparent (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dummy-environment_002c-used-by-_005cw-escape-sequence">dummy environment, used by <code class="code">\w</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dumping-environments-_0028pev_0029">dumping environments (<code class="code">pev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dumping-page-location-traps-_0028ptr_0029">dumping page location traps (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dumping-registers-_0028pnr_0029">dumping registers (<code class="code">pnr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-dumping-symbol-table-_0028pm_0029">dumping symbol table (<code class="code">pm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EBCDIC-output-encoding"><abbr class="acronym">EBCDIC</abbr> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-EBCDIC_002c-input-encoding"><abbr class="acronym">EBCDIC</abbr>, input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ejection_002c-page">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ejection_002c-page-1">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ejection_002c-page-2">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ejection_002c-page_002c-of-final-page">ejection, page, of final page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ejection_002c-page_002c-prevented-by-vpt">ejection, page, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-el-request_002c-and-warnings"><code class="code">el</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">ellipse, filled, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ellipse_002c-outlined_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">ellipse, outlined, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ellipse_002c-solid_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">ellipse, solid, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">ellipse, stroked, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-em-glyph_002c-and-cflags"><code class="code">em</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-em-scaling-unit-_0028m_0029">em scaling unit (<code class="code">m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-embolding-of-special-fonts">embolding of special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-empty-line">empty line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-en-scaling-unit-_0028n_0029">en scaling unit (<code class="code">n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-enabling-vertical-position-traps-_0028vpt_0029">enabling vertical position traps (<code class="code">vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-code-page-1047">encoding, input, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-EBCDIC">encoding, input, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029">encoding, input, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029">encoding, input, <span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029">encoding, input, <span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029">encoding, input, <span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-ASCII">encoding, output, <abbr class="acronym">ASCII</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-code-page-1047">encoding, output, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-EBCDIC">encoding, output, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-ISO-646">encoding, output, ISO&nbsp;646</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029">encoding, output, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-encoding_002c-output_002c-UTF_002d8">encoding, output, <span class="w-nolinebreak-text">UTF-8</span></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end-of-conditional-block-_0028_005c_007d_0029">end of conditional block (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dinput-macro-_0028em_0029">end-of-input macro (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dinput-trap_002c-setting-_0028em_0029">end-of-input trap, setting (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dinput-traps">end-of-input traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dsentence-characters">end-of-sentence characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dsentence-characters-1">end-of-sentence characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-end_002dof_002dsentence-transparent-characters">end-of-sentence transparent characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ending-diversion-_0028di_002c-box_0029">ending diversion (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-endnotes">endnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Footnotes-and-Endnotes">Footnotes and Endnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment">environment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Deferring-Output">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment-availability-and-naming_002c-incompatibilities-with">environment availability and naming, incompatibilities with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment-number_002fname-register-_0028_002eev_0029">environment number/name register (<code class="code">.ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment-variables">environment variables</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment_002c-copying-_0028evc_0029">environment, copying (<code class="code">evc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment_002c-dimensions-of-last-glyph-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">environment, dimensions of last glyph (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment_002c-dummy_002c-used-by-_005cw-escape-sequence">environment, dummy, used by <code class="code">\w</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment_002c-previous-line-length-_0028_002en_0029">environment, previous line length (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environment_002c-switching-_0028ev_0029">environment, switching (<code class="code">ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environments">environments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-environments_002c-dumping-_0028pev_0029">environments, dumping (<code class="code">pev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-equality-operator">equality operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-equation-example-_005bms_005d">equation example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-equations-_005bms_005d">equations <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-character_002c-changing-_0028ec_0029">escape character, changing (<code class="code">ec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-character_002c-formatting-_0028_005ce_0029">escape character, formatting (<code class="code">\e</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-character_002c-while-defining-glyph">escape character, while defining glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-sequence">escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Formatter-Instructions">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-sequence-argument-delimiters">escape sequence argument delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-sequences">escape sequences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escape-sequences_002c-brace-_0028_005c_007b_002c-_005c_007d_0029">escape sequences, brace (<code class="code">\{</code>, <code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-escaping-newline-characters_002c-in-strings">escaping newline characters, in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ex-request_002c-use-in-debugging"><code class="code">ex</code> request, use in debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ex-request_002c-used-with-nx-and-rd"><code class="code">ex</code> request, used with <code class="code">nx</code> and <code class="code">rd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-example-markup_002c-bulleted-list-_005bms_005d">example markup, bulleted list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-example-markup_002c-cover-page-in-_005bms_005d">example markup, cover page in <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-example-markup_002c-glossary_002dstyle-list-_005bms_005d">example markup, glossary-style list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-example-markup_002c-numbered-list-_005bms_005d">example markup, numbered list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-examples-of-invocation">examples of invocation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invocation-Examples">Invocation Examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-exiting-_0028ex_0029">exiting (<code class="code">ex</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expansion-of-strings-_0028_005c_002a_0029">expansion of strings (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-explicit-hyphen-_0028_005c_0025_0029">explicit hyphen (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-explicit-hyphenation">explicit hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expression_002c-limitation-of-logical-not-in">expression, limitation of logical not in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expression_002c-order-of-evaluation">expression, order of evaluation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expressions_002c-and-register-format">expressions, and register format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expressions_002c-and-space-characters">expressions, and space characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expressions_002c-conditional">expressions, conditional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-expressions_002c-numeric">expressions, numeric</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-post_002dvertical-line-space-_0028_005cx_0029">extra post-vertical line space (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-post_002dvertical-line-space-register-_0028_002ea_0029">extra post-vertical line space register (<code class="code">.a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-pre_002dvertical-line-space-_0028_005cx_0029">extra pre-vertical line space (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extra-spaces-between-words">extra spaces between words</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Adjustment">Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extreme-values-representable-with-Roman-numerals">extreme values representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-extremum-operators-_0028_003e_003f_002c-_003c_003f_0029">extremum operators (<code class="code">&gt;?</code>, <code class="code">&lt;?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-f-scaling-unit"><code class="code">f</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-factor_002c-zoom_002c-of-a-font-_0028fzoom_0029">factor, zoom, of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-character_002c-defining-_0028fchar_002c-fschar_002c-schar_0029">fallback character, defining (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fallback-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029">fallback glyph, removing definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fam-request_002c-and-changing-fonts"><code class="code">fam</code> request, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-families_002c-font">families, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-family_002c-font">family, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-features_002c-common">features, common</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Common-Features">Common Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fi-request_002c-causing-implicit-break"><code class="code">fi</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-field-delimiting-character-_0028fc_0029">field delimiting character (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-field-padding-character-_0028fc_0029">field padding character (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fields">fields</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fields_002c-and-tabs">fields, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-figure-space-_0028_005c0_0029">figure space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-figures-_005bms_005d">figures <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file-formats">file formats</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#File-Formats">File Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file-names_002c-breaking-_0028_005c_003a_0029">file names, breaking (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-appending-to-_0028opena_0029">file, appending to (<code class="code">opena</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-closing-_0028close_0029">file, closing (<code class="code">close</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-font-description">file, font description</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-inclusion-_0028so_0029">file, inclusion (<code class="code">so</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-macro_002c-search-path">file, macro, search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-opening-_0028open_0029">file, opening (<code class="code">open</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-processing-next-_0028nx_0029">file, processing next (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-file_002c-writing-to-_0028write_002c-writec_0029">file, writing to (<code class="code">write</code>, <code class="code">writec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-files_002c-font">files, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Device-and-Font-Description-Files">Device and Font Description Files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fill-color">fill color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fill-color-name-register-_0028_002eM_0029">fill color name register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fill-mode-_0028fi_0029_002c-enabling">fill mode (<code class="code">fi</code>), enabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fill-mode_002c-and-_005cc">fill mode, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fill-mode_002c-disabling">fill mode, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filled-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">filled circle, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filled-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">filled ellipse, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filled-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">filled polygon, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling">filling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Filling">Filling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling-and-adjustment_002c-manipulating">filling and adjustment, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling-of-output_002c-disabling-_0028nf_0029">filling of output, disabling (<code class="code">nf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling-of-output_002c-enabling-_0028fi_0029">filling of output, enabling (<code class="code">fi</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling_002c-and-break-warnings">filling, and <code class="code">break</code> warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-filling_002c-and-inter_002dsentence-space">filling, and inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-final-newline_002c-stripping-in-diversions">final newline, stripping in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fl-request_002c-causing-implicit-break"><code class="code">fl</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-floating-keep">floating keep</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Displays-and-Keeps">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-flush-output-_0028fl_0029">flush output (<code class="code">fl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font">font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-aliasing-with-third-argument-to-fp-request">font aliasing with third argument to <code class="code">fp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-description-file">font description file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-description-file-format">font description file format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-description-file_002c-format">font description file, format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-description-files_002c-comments">font description files, comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-directories">font directories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-families">font families</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-family">font family</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-family_002c-changing-_0028fam_002c-_005cF_0029">font family, changing (<code class="code">fam</code>, <code class="code">\F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-file_002c-format">font file, format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-files">font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Device-and-Font-Description-Files">Device and Font Description Files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-for-underlining-_0028uf_0029">font for underlining (<code class="code">uf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-height_002c-changing-_0028_005cH_0029">font height, changing (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-metrics">font metrics</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-mounting_002c-automatic">font mounting, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-path">font path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-position-register-_0028_002ef_0029">font position register (<code class="code">.f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-positions">font positions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-slant_002c-changing-_0028_005cS_0029">font slant, changing (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-style">font style</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-style_002c-abstract">font style, abstract</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-style_002c-abstract_002c-setting-up-_0028sty_0029">font style, abstract, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-styles">font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font-translation-_0028ftr_0029">font translation (<code class="code">ftr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-magnification-_0028fzoom_0029">font, magnification (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-mounting-_0028fp_0029">font, mounting (<code class="code">fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-optical-size">font, optical size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-previous_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029">font, previous, selecting (<code class="code">\f</code>, <code class="code">\fP</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-previous_002c-slecting-_0028ft_0029">font, previous, slecting (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-selection">font, selection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-special">font, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-text">font, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-unstyled">font, unstyled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-font_002c-zoom-factor-_0028fzoom_0029">font, zoom factor (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-artificial">fonts, artificial</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-changing-_0028ft_002c-_005cf_0029">fonts, changing (<code class="code">ft</code>, <code class="code">\f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-searching">fonts, searching</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fonts_002c-special">fonts, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footers">footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footers-1">footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footers-_005bms_005d">footers <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footnote-marker-_005bms_005d">footnote marker <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footnotes">footnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Footnotes-and-Endnotes">Footnotes and Endnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footnotes-_005bms_005d">footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footnotes_002c-and-displays-_005bms_005d">footnotes, and displays <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-footnotes_002c-and-keeps-_005bms_005d">footnotes, and keeps <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-form-letters">form letters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-format-of-font-description-file">format of font description file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-format-of-font-description-files">format of font description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-format-of-font-files">format of font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-format-of-register-_0028_005cg_0029">format of register (<code class="code">\g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-format_002c-paper">format, paper</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formats_002c-file">formats, file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#File-Formats">File Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formatter-instructions">formatter instructions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Formatter-Instructions">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formatting-a-backslash-glyph-_0028_005c_005brs_005d_0029">formatting a backslash glyph (<code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formatting-a-title-line-_0028tl_0029">formatting a title line (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formatting-the-escape-character-_0028_005ce_0029">formatting the escape character (<code class="code">\e</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-formatting-the-time">formatting the time</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fp-request_002c-and-font-translations"><code class="code">fp</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fp-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">fp</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fractional-point-sizes">fractional point sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fractional-point-sizes-1">fractional point sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fractional-type-sizes">fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fractional-type-sizes-1">fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fractional-type-sizes-in-ms-macros">fractional type sizes in <samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Differences-from-AT_0026T-ms">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-French-spacing">French spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fspecial-request_002c-and-font-styles"><code class="code">fspecial</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fspecial-request_002c-and-font-translations"><code class="code">fspecial</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fspecial-request_002c-and-glyph-search-order"><code class="code">fspecial</code> request, and glyph search order</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-fspecial-request_002c-and-imitating-bold"><code class="code">fspecial</code> request, and imitating bold</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ft-request_002c-and-font-translations"><code class="code">ft</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-full_002dservice-macro-package">full-service macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-geometry_002c-page">geometry, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GGL-_0028groff-glyph-list_0029">GGL (<code class="code">groff</code> glyph list)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GGL-_0028groff-glyph-list_0029-1">GGL (<code class="code">groff</code> glyph list)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glossary_002dstyle-list_002c-example-markup-_005bms_005d">glossary-style list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph">glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-for-line-drawing">glyph for line drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-names_002c-composite">glyph names, composite</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-pile-_0028_005cb_0029">glyph pile (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph-properties-_0028cflags_0029">glyph properties (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-box-rule-_0028_005c_005bbr_005d_0029">glyph, box rule (<code class="code">\br</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-constant-space">glyph, constant space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-defining-_0028char_0029">glyph, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-distinguished-from-character">glyph, distinguished from character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-for-line-drawing">glyph, for line drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-for-margins-_0028mc_0029">glyph, for margins (<code class="code">mc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-last_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">glyph, last, dimensions (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-leader-repetition-_0028lc_0029">glyph, leader repetition (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-numbered-_0028_005cN_0029">glyph, numbered (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-numbered-_0028_005cN_0029-1">glyph, numbered (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029">glyph, removing definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-soft-hyphen-_0028hy_0029">glyph, soft hyphen (<code class="code">hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-tab-repetition-_0028tc_0029">glyph, tab repetition (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyph_002c-underscore-_0028_005c_005bru_005d_0029">glyph, underscore (<code class="code">\ru</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyphs_002c-available_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">glyphs, available, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyphs_002c-output_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff">glyphs, output, and input characters, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyphs_002c-overstriking-_0028_005co_0029">glyphs, overstriking (<code class="code">\o</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyphs_002c-unnamed">glyphs, unnamed</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-glyphs_002c-unnamed_002c-accessing-with-_005cN">glyphs, unnamed, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GNU-troff_002c-identification-register-_0028_002eg_0029">GNU <code class="code">troff</code>, identification register (<code class="code">.g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GNU-troff_002c-PID-register-_0028_0024_0024_0029">GNU <code class="code">troff</code>, PID register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GNU-troff_002c-process-ID-register-_0028_0024_0024_0029">GNU <code class="code">troff</code>, process ID register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GNU_002dspecific-register-_0028_002eg_0029">GNU-specific register (<code class="code">.g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-graphic-renditions">graphic renditions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-greater-than-_0028or-equal-to_0029-operator">greater than (or equal to) operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff-capabilities"><code class="code">groff</code> capabilities</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#groff-Capabilities"><code class="code">groff</code> Capabilities</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff-glyph-list-_0028GGL_0029"><code class="code">groff</code> glyph list (GGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff-glyph-list-_0028GGL_0029-1"><code class="code">groff</code> glyph list (GGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Classes">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff-invocation"><code class="code">groff</code> invocation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-groff">Invoking groff</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff_002c-and-pi-request"><code class="code">groff</code>, and <code class="code">pi</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-groff_002d_002d_002dwhat-is-it_003f"><code class="code">groff</code>&mdash;what is it?</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#What-Is-groff_003f">What Is <code class="code">groff</code>?</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fBIN_005fPATH_002c-environment-variable"><code>GROFF_BIN_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable"><code>GROFF_COMMAND_PREFIX<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fENCODING_002c-environment-variable"><code>GROFF_ENCODING<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fFONT_005fPATH_002c-environment-variable"><code>GROFF_FONT_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fFONT_005fPATH_002c-environment-variable-1"><code>GROFF_FONT_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fTMAC_005fPATH_002c-environment-variable"><code>GROFF_TMAC_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fTMAC_005fPATH_002c-environment-variable-1"><code>GROFF_TMAC_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fTMPDIR_002c-environment-variable"><code>GROFF_TMPDIR<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-GROFF_005fTYPESETTER_002c-environment-variable"><code>GROFF_TYPESETTER<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-grohtml_002c-the-program"><code class="code">grohtml</code>, the program</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gtroff_002c-interactive-use"><code class="code">gtroff</code>, interactive use</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gtroff_002c-output"><code class="code">gtroff</code>, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-gtroff_002c-reference"><code class="code">gtroff</code>, reference</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#GNU-troff-Reference">GNU troff Reference</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hair-space-_0028_005c_005e_0029">hair space (<code class="code">\^</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hcode-request_002c-and-glyph-definitions"><code class="code">hcode</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers">headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers-1">headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-headers-_005bms_005d">headers <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-height_002c-font_002c-changing-_0028_005cH_0029">height, font, changing (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-height_002c-of-last-glyph-_0028_002echt_0029">height, of last glyph (<code class="code">.cht</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-high_002dwater-mark-register-_0028_002eh_0029">high-water mark register (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-home-directory">home directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-discardable-space">horizontal discardable space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-input-line-position-register-_0028hp_0029">horizontal input line position register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-input-line-position_002c-saving-_0028_005ck_0029">horizontal input line position, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-line_002c-drawing-_0028_005cl_0029">horizontal line, drawing (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-motion-_0028_005ch_0029">horizontal motion (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-motion-quantum">horizontal motion quantum</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-motion-quantum-register-_0028_002eH_0029">horizontal motion quantum register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-output-line-position-register-_0028_002ek_0029">horizontal output line position register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-resolution">horizontal resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-resolution-register-_0028_002eH_0029">horizontal resolution register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-space-_0028_005ch_0029">horizontal space (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-space_002c-unformatting">horizontal space, unformatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-horizontal-tab-character">horizontal tab character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hours_002c-current-time-_0028hours_0029">hours, current time (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hpf-request_002c-and-hyphenation-language"><code class="code">hpf</code> request, and hyphenation language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hw-request_002c-and-hy-restrictions"><code class="code">hw</code> request, and <code class="code">hy</code> restrictions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hw-request_002c-and-hyphenation-language"><code class="code">hw</code> request, and hyphenation language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hy-glyph_002c-and-cflags"><code class="code">hy</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphen_002c-explicit-_0028_005c_0025_0029">hyphen, explicit (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenated-lines_002c-consecutive-_0028hlm_0029">hyphenated lines, consecutive (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenating-characters">hyphenating characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation">hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Hyphenation">Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-character-_0028_005c_0025_0029">hyphenation character (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-code-_0028hcode_0029">hyphenation code (<code class="code">hcode</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-consecutive-line-count-register-_0028_002ehlc_0029">hyphenation consecutive line count register (<code class="code">.hlc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-consecutive-line-limit-register-_0028_002ehlm_0029">hyphenation consecutive line limit register (<code class="code">.hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-exceptions">hyphenation exceptions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-language-register-_0028_002ehla_0029">hyphenation language register (<code class="code">.hla</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-margin-_0028hym_0029">hyphenation margin (<code class="code">hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-margin-register-_0028_002ehym_0029">hyphenation margin register (<code class="code">.hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-mode-register-_0028_002ehy_0029">hyphenation mode register (<code class="code">.hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-parameters_002c-automatic">hyphenation parameters, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-pattern-files">hyphenation pattern files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-patterns-_0028hpf_0029">hyphenation patterns (<code class="code">hpf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-space-_0028hys_0029">hyphenation space (<code class="code">hys</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-space-adjustment-threshold">hyphenation space adjustment threshold</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation-space-adjustment-threshold-register-_0028_002ehys_0029">hyphenation space adjustment threshold register (<code class="code">.hys</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-automatic">hyphenation, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-disabling-_0028_005c_0025_0029">hyphenation, disabling (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-explicit">hyphenation, explicit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-incompatibilities-with-AT_0026T-troff">hyphenation, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-manipulating">hyphenation, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-hyphenation_002c-manual">hyphenation, manual</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-i-scaling-unit"><code class="code">i</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-i_002fo">i/o</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-IBM-code-page-1047-input-encoding">IBM code page 1047 input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-IBM-code-page-1047-output-encoding">IBM code page 1047 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-identifiers">identifiers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-identifiers_002c-undefined">identifiers, undefined</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ie-request_002c-and-font-translations"><code class="code">ie</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ie-request_002c-and-warnings"><code class="code">ie</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ie-request_002c-operators-to-use-with"><code class="code">ie</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if-request_002c-and-font-translations"><code class="code">if</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if-request_002c-and-the-_0021-operator"><code class="code">if</code> request, and the &lsquo;<samp class="samp">!</samp>&rsquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if-request_002c-operators-to-use-with"><code class="code">if</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if_002delse">if-else</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002delse">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-if_002dthen">if-then</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#if_002dthen">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-imitating-boldface-_0028bd_0029">imitating boldface (<code class="code">bd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-implementation-differences">implementation differences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Implementation-Differences">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-implicit-line-break">implicit line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-implicit-trap">implicit trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-in-request_002c-causing-implicit-break"><code class="code">in</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-in-request_002c-using-_002b-and-_002d-with"><code class="code">in</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inch-scaling-unit-_0028i_0029">inch scaling unit (<code class="code">i</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-including-a-file-_0028so_0029">including a file (<code class="code">so</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-incompatibilities-with-AT_0026T-troff">incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Implementation-Differences">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-increment-value-without-changing-the-register">increment value without changing the register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-incrementation_002c-automatic_002c-of-a-register">incrementation, automatic, of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-indentation-_0028in_0029">indentation (<code class="code">in</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-indentation_002c-of-roff-source-code">indentation, of <code class="code">roff</code> source code</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-index_002c-in-macro-package">index, in macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indexing">Indexing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-indicator_002c-scaling">indicator, scaling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-indirect-assignments">indirect assignments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-and-output-requests">input and output requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-characters-and-output-glyphs_002c-compatibility-with-AT_0026T-troff">input characters and output glyphs, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-characters_002c-invalid">input characters, invalid</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-conventions">input conventions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Conventions">Input Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-code-page-1047">input encoding, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-EBCDIC">input encoding, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029">input encoding, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-Latin_002d2-_0028ISO-8859_002d2_0029">input encoding, <span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-Latin_002d5-_0028ISO-8859_002d9_0029">input encoding, <span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-encoding_002c-Latin_002d9-_0028ISO-8859_002d15_0029">input encoding, <span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-file-name_002c-current_002c-register-_0028_002eF_0029">input file name, current, register (<code class="code">.F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-level">input level</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-level-in-delimited-arguments">input level in delimited arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-continuation-_0028_005cRET_0029">input line continuation (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-number-register-_0028_002ec_002c-c_002e_0029">input line number register (<code class="code">.c</code>, <code class="code">c.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-number_002c-setting-_0028lf_0029">input line number, setting (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-position_002c-horizontal_002c-saving-_0028_005ck_0029">input line position, horizontal, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-trap_002c-clearing-_0028it_002c-itc_0029">input line trap, clearing (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-trap_002c-setting-_0028it_002c-itc_0029">input line trap, setting (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-traps">input line traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line-traps-and-interrupted-lines-_0028itc_0029">input line traps and interrupted lines (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line_002c-horizontal-position_002c-register-_0028hp_0029">input line, horizontal position, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-line_002c-productive">input line, productive</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-stack_002c-backtrace-_0028backtrace_0029">input stack, backtrace (<code class="code">backtrace</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-stack_002c-setting-limit">input stack, setting limit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input-token">input token</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input_002c-8_002dbit">input, 8-bit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-input_002c-standard_002c-reading-from-_0028rd_0029">input, standard, reading from (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inserting-horizontal-space-_0028_005ch_0029">inserting horizontal space (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-installation">installation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Installation">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-instructing-the-formatter">instructing the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Formatter-Instructions">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inter_002dsentence-space-size-register-_0028_002esss_0029">inter-sentence space size register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inter_002dsentence-space_002c-additional">inter-sentence space, additional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-inter_002dword-spacing_002c-minimal">inter-word spacing, minimal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interactive-use-of-gtroff">interactive use of <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-intercepting-requests">intercepting requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-intermediate-output">intermediate output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpolating-registers-_0028_005cn_0029">interpolating registers (<code class="code">\n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpolation">interpolation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpolation-depth">interpolation depth</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpolation-depth-in-delimited-arguments">interpolation depth in delimited arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpolation-of-strings-_0028_005c_002a_0029">interpolation of strings (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interpretation-mode">interpretation mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interrupted-line">interrupted line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interrupted-line-register-_0028_002eint_0029">interrupted line register (<code class="code">.int</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-interrupted-lines-and-input-line-traps-_0028itc_0029">interrupted lines and input line traps (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-introduction">introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Introduction">Introduction</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invalid-characters-for-trf-request">invalid characters for <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invalid-input-characters">invalid input characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invocation-examples">invocation examples</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invocation-Examples">Invocation Examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invoking-groff">invoking <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-groff">Invoking groff</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-invoking-requests">invoking requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-646-output-encoding">ISO&nbsp;646 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-8859_002d1-_0028Latin_002d1_0029-output-encoding">ISO <span class="w-nolinebreak-text">8859-1</span> (<span class="w-nolinebreak-text">Latin-1</span>) output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-8859_002d1-_0028Latin_002d1_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-1</span> (<span class="w-nolinebreak-text">Latin-1</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-8859_002d15-_0028Latin_002d9_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-15</span> (<span class="w-nolinebreak-text">Latin-9</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-8859_002d2-_0028Latin_002d2_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-2</span> (<span class="w-nolinebreak-text">Latin-2</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ISO-8859_002d9-_0028Latin_002d5_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-9</span> (<span class="w-nolinebreak-text">Latin-5</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-italic-correction-_0028_005c_002f_0029">italic correction (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-J">J</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-justifying-text">justifying text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-justifying-text-_0028rj_0029">justifying text (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-keep_002c-floating">keep, floating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Displays-and-Keeps">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-keeps-_0028introduction_0029">keeps (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Displays-and-Keeps">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-keeps-_005bms_005d">keeps <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-keeps_002c-and-footnotes-_005bms_005d">keeps, and footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning-and-ligatures">kerning and ligatures</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning-enabled-register-_0028_002ekern_0029">kerning enabled register (<code class="code">.kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning_002c-activating-_0028kern_0029">kerning, activating (<code class="code">kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-kerning_002c-track">kerning, track</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-landscape-page-orientation">landscape page orientation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-language-_005bms_005d">language <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last-glyph_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">last glyph, dimensions (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002drequested-point-size-registers-_0028_002epsr_002c-_002esr_0029">last-requested point size registers (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-last_002drequested-type-size-registers-_0028_002epsr_002c-_002esr_0029">last-requested type size registers (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Latin_002d1-_0028ISO-8859_002d1_0029-output-encoding"><span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>) output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Latin_002d1-_0028ISO-8859_002d1_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Latin_002d2-_0028ISO-8859_002d2_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Latin_002d5-_0028ISO-8859_002d9_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Latin_002d9-_0028ISO-8859_002d15_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Encodings">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-layout_002c-line">layout, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-layout_002c-page">layout, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lc-request_002c-and-glyph-definitions"><code class="code">lc</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leader-character">leader character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leader-character-1">leader character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leader-character_002c-and-translations">leader character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leader-character_002c-non_002dinterpreted-_0028_005ca_0029">leader character, non-interpreted (<code class="code">\a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leader-repetition-character-_0028lc_0029">leader repetition character (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leaders">leaders</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading">leading</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading-space-macro-_0028lsm_0029">leading space macro (<code class="code">lsm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading-space-traps">leading space traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading-spaces">leading spaces</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading-spaces-macro-_0028lsm_0029">leading spaces macro (<code class="code">lsm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-leading-spaces-with-ds">leading spaces with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-left-italic-correction-_0028_005c_002c_0029">left italic correction (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-left-margin-_0028po_0029">left margin (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-of-a-string-_0028length_0029">length of a string (<code class="code">length</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-of-line-_0028ll_0029">length of line (<code class="code">ll</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-of-previous-line-_0028_002en_0029">length of previous line (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-of-the-page_002c-configuring-_0028pl_0029">length of the page, configuring (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-of-title-line_002c-configuring-_0028lt_0029">length of title line, configuring (<code class="code">lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-length-request_002c-and-copy-mode"><code class="code">length</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-less-than-_0028or-equal-to_0029-operator">less than (or equal to) operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-letters_002c-form">letters, form</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-level_002c-input">level, input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-level_002c-suppression-nesting_002c-register">level, suppression nesting, register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lf-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">lf</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligature">ligature</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligatures-and-kerning">ligatures and kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligatures-enabled-register-_0028_002elg_0029">ligatures enabled register (<code class="code">.lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ligatures_002c-activating-_0028lg_0029">ligatures, activating (<code class="code">lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-limitations-of-_005cb-escape-sequence">limitations of <code class="code">\b</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-break">line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-break-_0028introduction_0029">line break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-break_002c-output">line break, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-control">line control</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-dimensions">line dimensions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-drawing-glyph">line drawing glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-drawing-glyph-1">line drawing glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-indentation-_0028in_0029">line indentation (<code class="code">in</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-layout">line layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-length-_0028ll_0029">line length (<code class="code">ll</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-length-register-_0028_002el_0029">line length register (<code class="code">.l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-length_002c-previous-_0028_002en_0029">line length, previous (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-number_002c-input_002c-register-_0028_002ec_002c-c_002e_0029">line number, input, register (<code class="code">.c</code>, <code class="code">c.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-number_002c-output_002c-register-_0028ln_0029">line number, output, register (<code class="code">ln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-numbers_002c-printing-_0028nm_0029">line numbers, printing (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-space_002c-extra-post_002dvertical-_0028_005cx_0029">line space, extra post-vertical (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-space_002c-extra-pre_002dvertical-_0028_005cx_0029">line space, extra pre-vertical (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-spacing-register-_0028_002eL_0029">line spacing register (<code class="code">.L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-spacing_002c-post_002dvertical-_0028pvs_0029">line spacing, post-vertical (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line-thickness-_0028_005cD_0027t-_2026_0027_0029">line thickness (&lsquo;<samp class="samp">\D't &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-blank">line, blank</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029">line, drawing (&lsquo;<samp class="samp">\D'l &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-horizontal_002c-drawing-_0028_005cl_0029">line, horizontal, drawing (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-input_002c-continuation-_0028_005cRET_0029">line, input, continuation (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-input_002c-horizontal-position_002c-register-_0028hp_0029">line, input, horizontal position, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-input_002c-horizontal-position_002c-saving-_0028_005ck_0029">line, input, horizontal position, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-interrupted">line, interrupted</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-output_002c-continuation-_0028_005cc_0029">line, output, continuation (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-output_002c-horizontal-position_002c-register-_0028_002ek_0029">line, output, horizontal position, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-productive-input">line, productive input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002c-vertical_002c-drawing-_0028_005cL_0029">line, vertical, drawing (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-line_002dtabs-mode">line-tabs mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-blank_002c-disabling">lines, blank, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-centering-_0028ce_0029">lines, centering (<code class="code">ce</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-centering-_0028introduction_0029">lines, centering (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-consecutive-hyphenated-_0028hlm_0029">lines, consecutive hyphenated (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-interrupted_002c-and-input-line-traps-_0028itc_0029">lines, interrupted, and input line traps (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-right_002daligning-_0028introduction_0029">lines, right-aligning (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lines_002c-right_002djustifying-_0028introduction_0029">lines, right-justifying (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-list-of-special-characters-_0028groff_005fchar_00287_0029-man-page_0029">list of special characters (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-listing-page-location-traps-_0028ptr_0029">listing page location traps (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lists">lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ll-request_002c-using-_002b-and-_002d-with"><code class="code">ll</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-localization">localization</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-localization-_005bms_005d">localization <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-locating-macro-files">locating macro files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-locating-macro-packages">locating macro packages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-location_002c-vertical_002c-page_002c-marking-_0028mk_0029">location, vertical, page, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-location_002c-vertical_002c-page_002c-returning-to-marked-_0028rt_0029">location, vertical, page, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-_0060_0060and_0027_0027-operator">logical &ldquo;and&rdquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-_0060_0060or_0027_0027-operator">logical &ldquo;or&rdquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-complementation-operator">logical complementation operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-conjunction-operator">logical conjunction operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-disjunction-operator">logical disjunction operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-not_002c-limitation-in-expression">logical not, limitation in expression</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-logical-operators">logical operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-long-names">long names</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-loops-and-conditionals">loops and conditionals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditionals-and-Loops">Conditionals and Loops</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lowercasing-a-string-_0028stringdown_0029">lowercasing a string (<code class="code">stringdown</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ls-request_002c-alternative-to-_0028pvs_0029"><code class="code">ls</code> request, alternative to (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-lt-request_002c-using-_002b-and-_002d-with"><code class="code">lt</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-m-scaling-unit"><code class="code">m</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-M-scaling-unit"><code class="code">M</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-machine-units">machine units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro">macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-arguments">macro arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-arguments_002c-and-compatibility-mode">macro arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-arguments_002c-and-tabs">macro arguments, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-directories">macro directories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-file-search-path">macro file search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-name-register-_0028_005c_00240_0029">macro name register (<code class="code">\$0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-names_002c-starting-with-_005b-or-_005d_002c-and-refer">macro names, starting with <code class="code"></code> or <code class="code"></code>, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package">macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Packages">Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package-search-path">macro package search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package-usage_002c-basics-of">macro package usage, basics of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-auxiliary">macro package, auxiliary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-full_002dservice">macro package, full-service</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-introduction">macro package, introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Package-Intro">Macro Package Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-major">macro package, major</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-minor">macro package, minor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro-package_002c-structuring-the-source-of">macro package, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-appending-to-_0028am_0029">macro, appending to (<code class="code">am</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-creating-alias-for-_0028als_0029">macro, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-end_002dof_002dinput-_0028em_0029">macro, end-of-input (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-parameters-_0028_005c_0024_0029">macro, parameters (<code class="code">\$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-removing-_0028rm_0029">macro, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-removing-alias-for-_0028rm_0029">macro, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macro_002c-renaming-_0028rn_0029">macro, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-recursive">macros, recursive</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-searching">macros, searching</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-shared-name-space-with-strings-and-diversions">macros, shared name space with strings and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-tutorial-for-users">macros, tutorial for users</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tutorial-for-Macro-Users">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-macros_002c-writing">macros, writing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-magnification-of-a-font-_0028fzoom_0029">magnification of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-major-macro-package">major macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-major-version-number-register-_0028_002ex_0029">major version number register (<code class="code">.x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man-macros_002c-custom-headers-and-footers"><code class="code">man</code> macros, custom headers and footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man-macros_002c-Ultrix_002dspecific"><code class="code">man</code> macros, Ultrix-specific</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-man-pages">man pages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#man">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manipulating-filling-and-adjustment">manipulating filling and adjustment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manipulating-hyphenation">manipulating hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manipulating-spacing">manipulating spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manipulating-type-size-and-vertical-spacing">manipulating type size and vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manual-hyphenation">manual hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-manual-pages">manual pages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#man">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin-for-hyphenation-_0028hym_0029">margin for hyphenation (<code class="code">hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin-glyph-_0028mc_0029">margin glyph (<code class="code">mc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin_002c-bottom">margin, bottom</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin_002c-left-_0028po_0029">margin, left (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin_002c-right">margin, right</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-margin_002c-top">margin, top</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mark_002c-high_002dwater_002c-register-_0028_002eh_0029">mark, high-water, register (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-marker_002c-footnote-_005bms_005d">marker, footnote <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-marking-vertical-page-location-_0028mk_0029">marking vertical page location (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-maximum-operator">maximum operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-maximum-value-representable-with-Roman-numerals">maximum value representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mdoc-macros"><code class="code">mdoc</code> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#mdoc">mdoc</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-me-macro-package"><code class="code">me</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#me">me</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-measurement-units">measurement units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-measurements">measurements</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-measurements_002c-specifying-safely">measurements, specifying safely</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Default-Units">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-metrics_002c-font">metrics, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minimal-inter_002dword-spacing">minimal inter-word spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minimum-operator">minimum operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minimum-value-representable-with-Roman-numerals">minimum value representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minor-macro-package">minor macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minor-version-number-register-_0028_002ey_0029">minor version number register (<code class="code">.y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-minutes_002c-current-time-_0028minutes_0029">minutes, current time (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mm-macro-package"><code class="code">mm</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#mm">mm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode-for-constant-glyph-space-_0028cs_0029">mode for constant glyph space (<code class="code">cs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-compatibility">mode, compatibility</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-compatibility_002c-and-parameters">mode, compatibility, and parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy">mode, copy</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy-1">mode, copy</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-cf-request">mode, copy, and <code class="code">cf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-device-request">mode, copy, and <code class="code">device</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-length-request">mode, copy, and <code class="code">length</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-macro-parameters">mode, copy, and macro parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-output-request">mode, copy, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-trf-request">mode, copy, and <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-write-request">mode, copy, and <code class="code">write</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-writec-request">mode, copy, and <code class="code">writec</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-writem-request">mode, copy, and <code class="code">writem</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005c_0021">mode, copy, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005c_003f">mode, copy, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005c_003f-1">mode, copy, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005ca">mode, copy, and <code class="code">\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005ct">mode, copy, and <code class="code">\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-copy_002c-and-_005cV">mode, copy, and <code class="code">\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-fill-_0028fi_0029_002c-enabling">mode, fill (<code class="code">fi</code>), enabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-fill_002c-and-break-warnings">mode, fill, and <code class="code">break</code> warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-fill_002c-and-inter_002dsentence-space">mode, fill, and inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-fill_002c-and-_005cc">mode, fill, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-fill_002c-disabling">mode, fill, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-interpretation">mode, interpretation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Copy-Mode">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-line_002dtabs">mode, line-tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-no_002dfill">mode, no-fill</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-no_002dfill_002c-and-_005cc">mode, no-fill, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-no_002dspace-_0028ns_0029">mode, no-space (<code class="code">ns</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-nroff">mode, <code class="code">nroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-1">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-2">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-3">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-4">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-5">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-6">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-safer-7">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Safer-Mode">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-troff">mode, <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-1">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-2">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-3">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-4">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-5">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mode_002c-unsafe-6">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-modifying-requests">modifying requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-modulus">modulus</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mom-macro-package"><code class="code">mom</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#mom">mom</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-month-of-the-year-register-_0028mo_0029">month of the year register (<code class="code">mo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion-operators">motion operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion-quanta">motion quanta</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion-quantum_002c-horizontal">motion quantum, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion-quantum_002c-horizontal_002c-register-_0028_002eH_0029">motion quantum, horizontal, register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion-quantum_002c-vertical">motion quantum, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion_002c-horizontal-_0028_005ch_0029">motion, horizontal (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motion_002c-vertical-_0028_005cv_0029">motion, vertical (<code class="code">\v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-motions_002c-page">motions, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mounting-a-font-_0028fp_0029">mounting a font (<code class="code">fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mounting-position">mounting position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mounting-position-1">mounting position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-mounting_002c-font_002c-automatic">mounting, font, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros"><samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms">ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-accent-marks"><samp class="file">ms</samp> macros, accent marks</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-body-text"><samp class="file">ms</samp> macros, body text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Body-Text">ms Body Text</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-creating-table-of-contents"><samp class="file">ms</samp> macros, creating table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-displays"><samp class="file">ms</samp> macros, displays</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-document-control-settings"><samp class="file">ms</samp> macros, document control settings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Control-Settings">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-document-description"><samp class="file">ms</samp> macros, document description</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Description-Macros">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-equations"><samp class="file">ms</samp> macros, equations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-figures"><samp class="file">ms</samp> macros, figures</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-footers"><samp class="file">ms</samp> macros, footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-footnotes"><samp class="file">ms</samp> macros, footnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Footnotes">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-fractional-type-sizes-in"><samp class="file">ms</samp> macros, fractional type sizes in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Differences-from-AT_0026T-ms">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-general-structure"><samp class="file">ms</samp> macros, general structure</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Document-Structure">ms Document Structure</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-groff-differences-from-AT_0026T"><samp class="file">ms</samp> macros, <code class="code">groff</code> differences from <abbr class="acronym">AT&amp;T</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Differences-from-AT_0026T-ms">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-headers"><samp class="file">ms</samp> macros, headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Headers-and-Footers">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-headings"><samp class="file">ms</samp> macros, headings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Headings-in-ms">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-keeps"><samp class="file">ms</samp> macros, keeps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-keeps-and-displays">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-language"><samp class="file">ms</samp> macros, language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-lists"><samp class="file">ms</samp> macros, lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-localization"><samp class="file">ms</samp> macros, localization</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-language-and-localization">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-margins"><samp class="file">ms</samp> macros, margins</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Margins">ms Margins</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-multiple-columns"><samp class="file">ms</samp> macros, multiple columns</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Multiple-Columns">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-naming-conventions"><samp class="file">ms</samp> macros, naming conventions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Naming-Conventions">ms Naming Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-nested-lists"><samp class="file">ms</samp> macros, nested lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indented-regions-in-ms">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-obtaining-typographical-symbols"><samp class="file">ms</samp> macros, obtaining typographical symbols</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Typographical-symbols-in-ms">Typographical symbols in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-page-layout"><samp class="file">ms</samp> macros, page layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Page-Layout">ms Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-paragraph-handling"><samp class="file">ms</samp> macros, paragraph handling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs-in-ms">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-references"><samp class="file">ms</samp> macros, references</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-special-characters"><samp class="file">ms</samp> macros, special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-strings"><samp class="file">ms</samp> macros, strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-tables"><samp class="file">ms</samp> macros, tables</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ms-macros_002c-text-settings"><samp class="file">ms</samp> macros, text settings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Text-settings-in-ms">Text settings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multi_002dfile-documents">multi-file documents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multi_002dline-strings">multi-line strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multi_002dpage-table-example-_005bms_005d">multi-page table example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multiple-columns-_005bms_005d">multiple columns <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Multiple-Columns">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-multiplication">multiplication</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-n-scaling-unit"><code class="code">n</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name-space_002c-common_002c-of-macros_002c-diversions_002c-and-strings">name space, common, of macros, diversions, and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name_002c-background-color_002c-register-_0028_002eM_0029">name, background color, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name_002c-fill-color_002c-register-_0028_002eM_0029">name, fill color, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-name_002c-stroke-color_002c-register-_0028_002em_0029">name, stroke color, register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-named-character-_0028_005cC_0029">named character (<code class="code">\C</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-names_002c-long">names, long</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Compatibility-Mode">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-naming-conventions_002c-ms-macros">naming conventions, <samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Naming-Conventions">ms Naming Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ne-request_002c-and-the-_002etrunc-register"><code class="code">ne</code> request, and the <code class="code">.trunc</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ne-request_002c-comparison-with-sv"><code class="code">ne</code> request, comparison with <code class="code">sv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-negating-register-values">negating register values</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-negation">negation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nested-assignments">nested assignments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nested-diversions">nested diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nested-lists-_005bms_005d">nested lists <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Indented-regions-in-ms">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nesting-level_002c-suppression_002c-register">nesting level, suppression, register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-new-page-_0028bp_0029">new page (<code class="code">bp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-newline-character_002c-and-translations">newline character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-newline-character_002c-in-strings_002c-escaping">newline character, in strings, escaping</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-newline_002c-as-delimiter">newline, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-newline_002c-final_002c-stripping-in-diversions">newline, final, stripping in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-next-file_002c-processing-_0028nx_0029">next file, processing (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-next-free-font-position-register-_0028_002efp_0029">next free font position register (<code class="code">.fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-next-page-number-register-_0028_002epn_0029">next page number register (<code class="code">.pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-next-page-number_002c-configuring-_0028pn_0029">next page number, configuring (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nf-request_002c-causing-implicit-break"><code class="code">nf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nl-register_002c-and-_002ed"><code class="code">nl</code> register, and <code class="code">.d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nl-register_002c-difference-from-_002eh"><code class="code">nl</code> register, difference from <code class="code">.h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nm-request_002c-using-_002b-and-_002d-with"><code class="code">nm</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no_002dbreak-control-character-_0028_0027_0029">no-break control character (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no_002dbreak-control-character_002c-changing-_0028c2_0029">no-break control character, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no_002dfill-mode">no-fill mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no_002dfill-mode_002c-and-_005cc">no-fill mode, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-no_002dspace-mode-_0028ns_0029">no-space mode (<code class="code">ns</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-node_002c-output">node, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-non_002dprinting-break-point-_0028_005c_003a_0029">non-printing break point (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr-request_002c-and-warnings"><code class="code">nr</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nr-request_002c-using-_002b-and-_002d-with"><code class="code">nr</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-nroff-mode"><code class="code">nroff</code> mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-number-formats_002c-assigning-to-register-_0028af_0029">number formats, assigning to register (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-number-of-registers-register-_0028_002eR_0029">number of registers register (<code class="code">.R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-number_002c-input-line_002c-setting-_0028lf_0029">number, input line, setting (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-number_002c-page_002c-next_002c-configuring-_0028pn_0029">number, page, next, configuring (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numbered-glyph-_0028_005cN_0029">numbered glyph (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numbered-glyph-_0028_005cN_0029-1">numbered glyph (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numbered-list_002c-example-markup-_005bms_005d">numbered list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Lists-in-ms">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numbers_002c-line_002c-printing-_0028nm_0029">numbers, line, printing (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numeral_002dwidth-space-_0028_005c0_0029">numeral-width space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numerals_002c-as-delimiters">numerals, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numerals_002c-Roman">numerals, Roman</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numeric-expression_002c-valid">numeric expression, valid</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-numeric-expressions">numeric expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-object-creation">object creation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-offset_002c-page">offset, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-offset_002c-page-_0028po_0029">offset, page (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-open-request_002c-and-safer-mode"><code class="code">open</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opena-request_002c-and-safer-mode"><code class="code">opena</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opening-brace-escape-sequence-_0028_005c_007d_0029">opening brace escape sequence (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Conditional-Blocks">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-opening-file-_0028open_0029">opening file (<code class="code">open</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operator_002c-scaling">operator, scaling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-arithmetic">operators, arithmetic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-as-delimiters">operators, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-comparison">operators, comparison</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-extremum-_0028_003e_003f_002c-_003c_003f_0029">operators, extremum (<code class="code">&gt;?</code>, <code class="code">&lt;?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-logical">operators, logical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-motion">operators, motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-operators_002c-unary-arithmetic">operators, unary arithmetic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-optical-size-of-a-font">optical size of a font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-options">options</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-order-of-evaluation-in-expressions">order of evaluation in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ordinary-character">ordinary character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-orientation_002c-landscape">orientation, landscape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-orphan">orphan</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-orphan-lines_002c-preventing-with-ne">orphan lines, preventing with <code class="code">ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-os-request_002c-and-no_002dspace-mode"><code class="code">os</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-outlined-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">outlined circle, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-outlined-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">outlined ellipse, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-outlined-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">outlined polygon, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-and-input-requests">output and input requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-comparison-operator">output comparison operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-device-name-string-_0028_002eT_0029">output device name string (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-device-name-string-_0028_002eT_0029-1">output device name string (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-device-name-string-_0028_002eT_0029_002c-in-other-implementations">output device name string (<code class="code">.T</code>), in other implementations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-device-usage-register-_0028_002eT_0029">output device usage register (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-device-usage-register-_0028_002eT_0029_002c-incompatibility-with-AT_0026T-troff">output device usage register (<code class="code">.T</code>), incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-devices">output devices</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Output-Device-Intro">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-ASCII">output encoding, <abbr class="acronym">ASCII</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-code-page-1047">output encoding, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-EBCDIC">output encoding, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-ISO-646">output encoding, ISO&nbsp;646</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029">output encoding, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-encoding_002c-UTF_002d8">output encoding, <span class="w-nolinebreak-text">UTF-8</span></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-glyphs_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff">output glyphs, and input characters, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-line-break">output line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-line-number-register-_0028ln_0029">output line number register (<code class="code">ln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-line-properties">output line properties</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-line_002c-continuation-_0028_005cc_0029">output line, continuation (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Continuation">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-line_002c-horizontal-position_002c-register-_0028_002ek_0029">output line, horizontal position, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-node">output node</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-request_002c-and-copy-mode"><code class="code">output</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output-request_002c-and-_005c_0021"><code class="code">output</code> request, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-filling_002c-disablement-of-_0028nf_0029">output, filling, disablement of (<code class="code">nf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-filling_002c-enablement-of-_0028fi_0029">output, filling, enablement of (<code class="code">fi</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-flush-_0028fl_0029">output, flush (<code class="code">fl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-gtroff">output, <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-intermediate">output, intermediate</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-suppressing-_0028_005cO_0029">output, suppressing (<code class="code">\O</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-transparent-_0028cf_002c-trf_0029">output, transparent (<code class="code">cf</code>, <code class="code">trf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-transparent-_0028_005c_0021_002c-_005c_003f_0029">output, transparent (<code class="code">\!</code>, <code class="code">\?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-transparent_002c-incompatibilities-with-AT_0026T-troff">output, transparent, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-output_002c-troff">output, <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-overlapping-characters">overlapping characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-overstriking-glyphs-_0028_005co_0029">overstriking glyphs (<code class="code">\o</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-p-scaling-unit"><code class="code">p</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-P-scaling-unit"><code class="code">P</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro">package, macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Packages">Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-auxiliary">package, macro, auxiliary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-full_002dservice">package, macro, full-service</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-introduction">package, macro, introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Package-Intro">Macro Package Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-major">package, macro, major</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-minor">package, macro, minor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Major-Macro-Packages">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-macro_002c-search-path">package, macro, search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-package_002c-package_002c-structuring-the-source-of">package, package, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-padding-character_002c-for-fields-_0028fc_0029">padding character, for fields (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Fields">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page">page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break-1">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break-2">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break-_0028introduction_0029">page break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break_002c-conditional-_0028ne_0029">page break, conditional (<code class="code">ne</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break_002c-final">page break, final</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-break_002c-prevented-by-vpt">page break, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-control">page control</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection-1">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection-2">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection-status-register-_0028_002epe_0029">page ejection status register (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection_002c-of-final-page">page ejection, of final page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-ejection_002c-prevented-by-vpt">page ejection, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-footers">page footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-headers">page headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-layout">page layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-layout-_005bms_005d">page layout <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Page-Layout">ms Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-length-register-_0028_002ep_0029">page length register (<code class="code">.p</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-length_002c-configuring-_0028pl_0029">page length, configuring (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-location-traps">page location traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-location-traps_002c-debugging">page location traps, debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-location_002c-vertical_002c-marking-_0028mk_0029">page location, vertical, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-location_002c-vertical_002c-returning-to-marked-_0028rt_0029">page location, vertical, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-motions">page motions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-number-character-_0028_0025_0029">page number character (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-number-character_002c-changing-_0028pc_0029">page number character, changing (<code class="code">pc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-number-register-_0028_0025_0029">page number register (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-number_002c-configuring-next-_0028pn_0029">page number, configuring next (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-number_002c-next_002c-register-_0028_002epn_0029">page number, next, register (<code class="code">.pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-offset">page offset</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-offset-_0028po_0029">page offset (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page-orientation_002c-landscape">page orientation, landscape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-geometry-of">page, geometry of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-page_002c-new-_0028bp_0029">page, new (<code class="code">bp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-format">paper format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paper-size">paper size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-paragraphs">paragraphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-parameter-count-register-_0028_002e_0024_0029">parameter count register (<code class="code">.$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-parameters">parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-parameters_002c-and-compatibility-mode">parameters, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-parameters_002c-macro-_0028_005c_0024_0029">parameters, macro (<code class="code">\$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Parameters">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-parentheses">parentheses</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-partially-collected-line">partially collected line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-path_002c-for-font-files">path, for font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-path_002c-for-tmac-files">path, for tmac files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pattern-files_002c-for-hyphenation">pattern files, for hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-patterns-for-hyphenation-_0028hpf_0029">patterns for hyphenation (<code class="code">hpf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pending-output-line">pending output line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pi-request_002c-and-groff"><code class="code">pi</code> request, and <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pi-request_002c-and-safer-mode"><code class="code">pi</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pi-request_002c-disabled-by-default"><code class="code">pi</code> request, disabled by default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Safer-Mode">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pica-scaling-unit-_0028P_0029">pica scaling unit (<code class="code">P</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PID-of-GNU-troff-register-_0028_0024_0024_0029">PID of GNU <code class="code">troff</code> register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pile_002c-glyph-_0028_005cb_0029">pile, glyph (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pl-request_002c-using-_002b-and-_002d-with"><code class="code">pl</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text-approximation-output-register-_0028_002eA_0029">plain text approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-plain-text-approximation-output-register-_0028_002eA_0029-1">plain text approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-planting-a-trap">planting a trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Traps">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-platform_002dspecific-directory">platform-specific directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pm-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">pm</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pn-request_002c-using-_002b-and-_002d-with"><code class="code">pn</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PNG-image-generation-from-PostScript">PNG image generation from PostScript</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-po-request_002c-using-_002b-and-_002d-with"><code class="code">po</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-scaling-unit-_0028p_0029">point scaling unit (<code class="code">p</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-size-registers-_0028_002es_002c-_002eps_0029">point size registers (<code class="code">.s</code>, <code class="code">.ps</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029">point size registers, last-requested (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-sizes_002c-changing-_0028ps_002c-_005cs_0029">point sizes, changing (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-sizes_002c-fractional">point sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-point-sizes_002c-fractional-1">point sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">polygon, filled, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-polygon_002c-outlined_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">polygon, outlined, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-polygon_002c-solid_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">polygon, solid, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">polygon, stroked, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position-of-lowest-text-line-_0028_002eh_0029">position of lowest text line (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-absolute-_0028sic_0029-operator-_0028_007c_0029">position, absolute <i class="slanted">(sic)</i> operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-drawing">position, drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-horizontal-input-line_002c-saving-_0028_005ck_0029">position, horizontal input line, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-horizontal_002c-in-input-line_002c-register-_0028hp_0029">position, horizontal, in input line, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-horizontal_002c-in-output-line_002c-register-_0028_002ek_0029">position, horizontal, in output line, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-mounting">position, mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-position_002c-vertical_002c-in-diversion_002c-register-_0028_002ed_0029">position, vertical, in diversion, register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-positions_002c-font">positions, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Positions">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-post_002dvertical-line-spacing">post-vertical line spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-post_002dvertical-line-spacing-register-_0028_002epvs_0029">post-vertical line spacing register (<code class="code">.pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-post_002dvertical-line-spacing_002c-changing-_0028pvs_0029">post-vertical line spacing, changing (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-postprocessor-access">postprocessor access</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Postprocessor-Access">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-postprocessors">postprocessors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Output-Device-Intro">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript_002c-bounding-box">PostScript, bounding box</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-PostScript_002c-PNG-image-generation">PostScript, PNG image generation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-prefix_002c-for-commands">prefix, for commands</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-preprocessors">preprocessors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Preprocessor-Intro">Preprocessor Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-previous-font_002c-selecting-_0028ft_0029">previous font, selecting (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-previous-font_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029">previous font, selecting (<code class="code">\f</code>, <code class="code">\fP</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-previous-line-length-_0028_002en_0029">previous line length (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-print-current-page-register-_0028_002eP_0029">print current page register (<code class="code">.P</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printing-backslash-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029">printing backslash (<code class="code">\\</code>, <code class="code">\e</code>, <code class="code">\E</code>, <code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printing-line-numbers-_0028nm_0029">printing line numbers (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printing-to-stderr-_0028tm_002c-tm1_002c-tmc_0029">printing to stderr (<code class="code">tm</code>, <code class="code">tm1</code>, <code class="code">tmc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029">printing, zero-width (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029-1">printing, zero-width (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-process-ID-of-GNU-troff-register-_0028_0024_0024_0029">process ID of GNU <code class="code">troff</code> register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-processing-next-file-_0028nx_0029">processing next file (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-productive-input-line">productive input line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-properties-of-characters-_0028cflags_0029">properties of characters (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-properties-of-glyphs-_0028cflags_0029">properties of glyphs (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-properties-of-output-lines">properties of output lines</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-request_002c-and-constant-glyph-space-mode"><code class="code">ps</code> request, and constant glyph space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ps</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-request_002c-using-_002b-and-_002d-with"><code class="code">ps</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ps-request_002c-with-fractional-type-sizes"><code class="code">ps</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pso-request_002c-and-safer-mode"><code class="code">pso</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-pvs-request_002c-using-_002b-and-_002d-with"><code class="code">pvs</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quanta_002c-motion">quanta, motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quantum_002c-horizontal-motion">quantum, horizontal motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-quantum_002c-vertical-motion">quantum, vertical motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-radicalex-glyph_002c-and-cflags"><code class="code">radicalex</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ragged_002dleft-text">ragged-left text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ragged_002dright-text">ragged-right text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rc-request_002c-and-glyph-definitions"><code class="code">rc</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-read_002donly-register-removal_002c-incompatibility-with-AT_0026T-troff">read-only register removal, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-read_002donly-register_002c-changing-format">read-only register, changing format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reading-from-standard-input-_0028rd_0029">reading from standard input (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-recursive-macros">recursive macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-refer_002c-and-macro-names-starting-with-_005b-or-_005d"><code class="code">refer</code>, and macro names starting with <code class="code"></code> or <code class="code"></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-reference_002c-gtroff">reference, <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#GNU-troff-Reference">GNU troff Reference</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-references-_005bms_005d">references <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register-format_002c-in-expressions">register format, in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-assigning-number-format-to-_0028af_0029">register, assigning number format to (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-built_002din_002c-removing">register, built-in, removing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-creating-alias-for-_0028aln_0029">register, creating alias for (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-format-_0028_005cg_0029">register, format (<code class="code">\g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-read_002donly_002c-removal_002c-incompatibility-with-AT_0026T-troff">register, read-only, removal, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-removing-_0028rr_0029">register, removing (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-removing-alias-for-_0028rr_0029">register, removing alias for (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-register_002c-renaming-_0028rnn_0029">register, renaming (<code class="code">rnn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers">registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Registers">Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers_002c-built_002din">registers, built-in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers_002c-dumping-_0028pnr_0029">registers, dumping (<code class="code">pnr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers_002c-interpolating-_0028_005cn_0029">registers, interpolating (<code class="code">\n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Interpolating-Registers">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers_002c-number-of_002c-register-_0028_002eR_0029">registers, number of, register (<code class="code">.R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-registers_002c-setting-_0028nr_002c-_005cR_0029">registers, setting (<code class="code">nr</code>, <code class="code">\R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removal-of-read_002donly-registers_002c-incompatibility-with-AT_0026T-troff">removal of read-only registers, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-a-built_002din-register">removing a built-in register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-a-register-_0028rr_0029">removing a register (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-alias-for-register-_0028rr_0029">removing alias for register (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-alias_002c-for-diversion-_0028rm_0029">removing alias, for diversion (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-alias_002c-for-macro-_0028rm_0029">removing alias, for macro (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-alias_002c-for-string-_0028rm_0029">removing alias, for string (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-diversion-_0028rm_0029">removing diversion (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-glyph-definition-_0028rchar_002c-rfschar_0029">removing glyph definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-macro-_0028rm_0029">removing macro (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-request-_0028rm_0029">removing request (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-removing-string-_0028rm_0029">removing string (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renaming-a-register-_0028rnn_0029">renaming a register (<code class="code">rnn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renaming-diversion-_0028rn_0029">renaming diversion (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renaming-macro-_0028rn_0029">renaming macro (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renaming-request-_0028rn_0029">renaming request (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renaming-string-_0028rn_0029">renaming string (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-renditions_002c-graphic">renditions, graphic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request">request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request-1">request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Formatter-Instructions">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request-arguments">request arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request-arguments_002c-and-compatibility-mode">request arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request-arguments_002c-and-tabs">request arguments, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request_002c-removing-_0028rm_0029">request, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request_002c-renaming-_0028rn_0029">request, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-request_002c-undefined">request, undefined</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-requests-for-drawing">requests for drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-requests-for-input-and-output">requests for input and output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-requests_002c-intercepting">requests, intercepting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-requests_002c-invoking">requests, invoking</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-requests_002c-modifying">requests, modifying</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Control-Characters">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-device">resolution, device</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-device-1">resolution, device</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-device_002c-obtaining-in-the-formatter">resolution, device, obtaining in the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-horizontal">resolution, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-horizontal_002c-register-_0028_002eH_0029">resolution, horizontal, register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Motion-Quanta">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-resolution_002c-vertical">resolution, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-returning-to-marked-vertical-page-location-_0028rt_0029">returning to marked vertical page location (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-revision-number-register-_0028_002eY_0029">revision number register (<code class="code">.Y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-right-margin">right margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Line-Layout">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-right_002daligning-lines-_0028introduction_0029">right-aligning lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-right_002djustifying-_0028rj_0029">right-justifying (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-right_002djustifying-lines-_0028introduction_0029">right-justifying lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rivers">rivers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rj-request_002c-causing-implicit-break"><code class="code">rj</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rn-glyph_002c-and-cflags"><code class="code">rn</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-roman-glyph_002c-correction-after-italic-glyph-_0028_005c_002f_0029">roman glyph, correction after italic glyph (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-roman-glyph_002c-correction-before-italic-glyph-_0028_005c_002c_0029">roman glyph, correction before italic glyph (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Roman-numerals">Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Roman-numerals_002c-extrema-_0028maximum-and-minimum_0029">Roman numerals, extrema (maximum and minimum)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Assigning-Register-Formats">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rq-glyph_002c-at-end-of-sentence"><code class="code">rq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rq-glyph_002c-at-end-of-sentence-1"><code class="code">rq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-rt-request_002c-using-_002b-and-_002d-with"><code class="code">rt</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ru-glyph_002c-and-cflags"><code class="code">ru</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-running-system-commands">running system commands</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-s-scaling-unit"><code class="code">s</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-1">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-2">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-3">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-4">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-5">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-6">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-safer-mode-7">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Safer-Mode">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-saving-horizontal-input-line-position-_0028_005ck_0029">saving horizontal input line position (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-indicator">scaling indicator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-operator">scaling operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-c">scaling unit <code class="code">c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-f">scaling unit <code class="code">f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-i">scaling unit <code class="code">i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-m">scaling unit <code class="code">m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-M">scaling unit <code class="code">M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-n">scaling unit <code class="code">n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-p">scaling unit <code class="code">p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-P">scaling unit <code class="code">P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-s">scaling unit <code class="code">s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-u">scaling unit <code class="code">u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-v">scaling unit <code class="code">v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-scaling-unit-z">scaling unit <code class="code">z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-searching-fonts">searching fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-searching-macros">searching macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-seconds_002c-current-time-_0028seconds_0029">seconds, current time (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-selecting-the-previous-font-_0028ft_0029">selecting the previous font (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sentence-space">sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sentence-space-size-register-_0028_002esss_0029">sentence space size register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sentences">sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sequence_002c-escape">sequence, escape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Formatter-Instructions">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-diversion-trap-_0028dt_0029">setting diversion trap (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-end_002dof_002dinput-trap-_0028em_0029">setting end-of-input trap (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-input-line-number-_0028lf_0029">setting input line number (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-input-line-trap-_0028it_002c-itc_0029">setting input line trap (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-registers-_0028nr_002c-_005cR_0029">setting registers (<code class="code">nr</code>, <code class="code">\R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Setting-Registers">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-the-page-length-_0028pl_0029">setting the page length (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-setting-up-an-abstract-font-style-_0028sty_0029">setting up an abstract font style (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-shc-request_002c-and-translations"><code class="code">shc</code> request, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-site_002dlocal-directory">site-local directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-site_002dlocal-directory-1">site-local directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Directories">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-size-of-sentence-space-register-_0028_002esss_0029">size of sentence space register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-size-of-word-space-register-_0028_002ess_0029">size of word space register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-size_002c-optical_002c-of-a-font">size, optical, of a font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-size_002c-paper">size, paper</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paper-Format">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-size_002c-size">size, size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sizes_002c-fractional">sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sizes_002c-fractional-type">sizes, fractional type</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-skew_002c-of-last-glyph-_0028_002ecsk_0029">skew, of last glyph (<code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-slant_002c-font_002c-changing-_0028_005cS_0029">slant, font, changing (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-soft-hyphen-character_002c-setting-_0028shc_0029">soft hyphen character, setting (<code class="code">shc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-soft-hyphen-glyph-_0028hy_0029">soft hyphen glyph (<code class="code">hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-solid-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">solid circle, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-solid-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">solid ellipse, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-solid-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">solid polygon, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable"><code>SOURCE_DATE_EPOCH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sp-request_002c-and-no_002dspace-mode"><code class="code">sp</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sp-request_002c-causing-implicit-break"><code class="code">sp</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space-between-sentences">space between sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space-between-sentences-register-_0028_002esss_0029">space between sentences register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space-between-words-register-_0028_002ess_0029">space between words register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space-character_002c-as-delimiter">space character, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space-characters_002c-in-expressions">space characters, in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-between-sentences">space, between sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-between-words">space, between words</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-discardable_002c-horizontal">space, discardable, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-hair-_0028_005c_005e_0029">space, hair (<code class="code">\^</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-horizontal-_0028_005ch_0029">space, horizontal (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-horizontal_002c-unformatting">space, horizontal, unformatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-thin-_0028_005c_007c_0029">space, thin (<code class="code">\|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-unbreakable-_0028_005c_007e_0029">space, unbreakable (<code class="code">\~</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-unbreakable-and-unadjustable-_0028_005cSP_0029">space, unbreakable and unadjustable (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-vertical_002c-unit-_0028v_0029">space, vertical, unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-space_002c-width-of-a-digit-_0028numeral_0029-_0028_005c0_0029">space, width of a digit (numeral) (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spaces-with-ds">spaces with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spaces_002c-in-a-macro-argument">spaces, in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Calling-Macros">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spaces_002c-leading-and-trailing">spaces, leading and trailing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacing-_0028introduction_0029">spacing (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacing_002c-manipulating">spacing, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Spacing">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacing_002c-vertical">spacing, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacing_002c-vertical-1">spacing, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spacing_002c-vertical-_0028introduction_0029">spacing, vertical (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-characters">special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Sentences">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-characters-1">special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-characters-_005bms_005d">special characters <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-characters_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">special characters, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-font">special font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-fonts">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-fonts-1">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Special-Fonts">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-fonts-2">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-fonts_002c-emboldening">special fonts, emboldening</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-request_002c-and-font-translations"><code class="code">special</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-special-request_002c-and-glyph-search-order"><code class="code">special</code> request, and glyph search order</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-spline_002c-drawing-_0028_005cD_0027_007e-_2026_0027_0029">spline, drawing (&lsquo;<samp class="samp">\D'~ &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-springing-a-trap">springing a trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Traps">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sqrtex-glyph_002c-and-cflags"><code class="code">sqrtex</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ss-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ss</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stack">stack</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stacking-glyphs-_0028_005cb_0029">stacking glyphs (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-standard-input_002c-reading-from-_0028rd_0029">standard input, reading from (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stderr_002c-printing-to-_0028tm_002c-tm1_002c-tmc_0029">stderr, printing to (<code class="code">tm</code>, <code class="code">tm1</code>, <code class="code">tmc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stops_002c-tab">stops, tab</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string-arguments">string arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string-comparison">string comparison</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string-expansion-_0028_005c_002a_0029">string expansion (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string-interpolation-_0028_005c_002a_0029">string interpolation (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-appending-_0028as_0029">string, appending (<code class="code">as</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-creating-alias-for-_0028als_0029">string, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-length-of-_0028length_0029">string, length of (<code class="code">length</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-removing-_0028rm_0029">string, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-removing-alias-for-_0028rm_0029">string, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-string_002c-renaming-_0028rn_0029">string, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-strings">strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-strings-_005bms_005d">strings <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Legacy-Features">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-strings_002c-multi_002dline">strings, multi-line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-strings_002c-shared-name-space-with-macros-and-diversions">strings, shared name space with macros and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stripping-final-newline-in-diversions">stripping final newline in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stroke-color">stroke color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stroke-color-name-register-_0028_002em_0029">stroke color name register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stroked-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">stroked circle, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stroked-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">stroked ellipse, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-stroked-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">stroked polygon, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-structuring-source-code-of-documents-or-macro-packages">structuring source code of documents or macro packages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sty-request_002c-and-changing-fonts"><code class="code">sty</code> request, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sty-request_002c-and-font-translations"><code class="code">sty</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-style_002c-font">style, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-style_002c-font_002c-abstract">style, font, abstract</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-style_002c-font_002c-abstract_002c-setting-up-_0028sty_0029">style, font, abstract, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-styles_002c-font">styles, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-substring-_0028substring_0029">substring (<code class="code">substring</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-subtraction">subtraction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-suppressing-output-_0028_005cO_0029">suppressing output (<code class="code">\O</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-suppression-nesting-level-register">suppression nesting level register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Suppressing-Output">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sv-request_002c-and-no_002dspace-mode"><code class="code">sv</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-switching-environments-_0028ev_0029">switching environments (<code class="code">ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sy-request_002c-and-safer-mode"><code class="code">sy</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-sy-request_002c-disabled-by-default"><code class="code">sy</code> request, disabled by default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Safer-Mode">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-symbol">symbol</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-symbol-table_002c-dumping-_0028pm_0029">symbol table, dumping (<code class="code">pm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-symbol_002c-defining-_0028char_0029">symbol, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-symbols_002c-using">symbols, using</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-system-commands_002c-running">system commands, running</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-system_0028_0029-return-value-register-_0028systat_0029"><code class="code">system()</code> return value register (<code class="code">systat</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-character">tab character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-character-encoding">tab character encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-character_002c-and-translations">tab character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-character_002c-as-delimiter">tab character, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Delimiters">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-character_002c-non_002dinterpreted-_0028_005ct_0029">tab character, non-interpreted (<code class="code">\t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-repetition-character-_0028tc_0029">tab repetition character (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-stop-settings-register-_0028_002etabs_0029">tab stop settings register (<code class="code">.tabs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-stops">tab stops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Leaders">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab-stops_002c-default">tab stops, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tab_002c-line_002dtabs-mode">tab, line-tabs mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-table-of-contents">table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Table-of-Contents">Table of Contents</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-table-of-contents-1">table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leaders">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-table-of-contents_002c-creating-_005bms_005d">table of contents, creating <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-TOC">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-table_002c-multi_002dpage_002c-example-_005bms_005d">table, multi-page, example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tables-_005bms_005d">tables <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#ms-Insertions">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tabs_002c-and-fields">tabs, and fields</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tabs-and-Fields">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tabs_002c-and-macro-arguments">tabs, and macro arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tabs_002c-and-request-arguments">tabs, and request arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Invoking-Requests">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tabs_002c-before-comments">tabs, before comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tagged-paragraphs">tagged paragraphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tags_002c-paragraph">tags, paragraph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Paragraphs">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-terminal_002c-conditional-output-for">terminal, conditional output for</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-baseline">text baseline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-baseline-1">text baseline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-font">text font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-line">text line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Requests-and-Macros">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text-line_002c-position-of-lowest-_0028_002eh_0029">text line, position of lowest (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text_002c-GNU-troff-processing">text, GNU <code class="code">troff</code> processing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Text">Text</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text_002c-justifying">text, justifying</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-text_002c-justifying-_0028rj_0029">text, justifying (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-thickness-of-lines-_0028_005cD_0027t-_2026_0027_0029">thickness of lines (&lsquo;<samp class="samp">\D't &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-thin-space-_0028_005c_007c_0029">thin space (<code class="code">\|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-three_002dpart-title-_0028tl_0029">three-part title (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ti-request_002c-causing-implicit-break"><code class="code">ti</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ti-request_002c-using-_002b-and-_002d-with"><code class="code">ti</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-time_002c-current_002c-hours-_0028hours_0029">time, current, hours (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-time_002c-current_002c-minutes-_0028minutes_0029">time, current, minutes (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-time_002c-current_002c-seconds-_0028seconds_0029">time, current, seconds (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-time_002c-formatting">time, formatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-title-length_002c-configuring-_0028lt_0029">title length, configuring (<code class="code">lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-title-line-length-register-_0028_002elt_0029">title line length register (<code class="code">.lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-title-line_002c-formatting-_0028tl_0029">title line, formatting (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-titles">titles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Layout">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tkf-request_002c-and-font-styles"><code class="code">tkf</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tkf-request_002c-and-font-translations"><code class="code">tkf</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tkf-request_002c-with-fractional-type-sizes"><code class="code">tkf</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tl-request_002c-and-mc"><code class="code">tl</code> request, and <code class="code">mc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Miscellaneous">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tmac_002c-directory">tmac, directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tmac_002c-path">tmac, path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TMPDIR_002c-environment-variable"><code>TMPDIR<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-token_002c-input">token, input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Gtroff-Internals">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-top-margin">top margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-top_002dlevel-diversion">top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-top_002dlevel-diversion_002c-and-bp">top-level diversion, and <code class="code">bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-top_002dlevel-diversion_002c-and-_005c_0021">top-level diversion, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-top_002dlevel-diversion_002c-and-_005c_003f">top-level diversion, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tr-request_002c-and-glyph-definitions"><code class="code">tr</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tr-request_002c-and-soft-hyphen-character"><code class="code">tr</code> request, and soft hyphen character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tr-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">tr</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-track-kerning">track kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-track-kerning_002c-activating-_0028tkf_0029">track kerning, activating (<code class="code">tkf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Ligatures-and-Kerning">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-double-quotes-in-strings">trailing double quotes in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-spaces-in-string-definitions-and-appendments">trailing spaces in string definitions and appendments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trailing-spaces-on-text-lines">trailing spaces on text lines</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Breaking">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-translations-of-characters">translations of characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Character-Translations">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-characters">transparent characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-dummy-character-_0028_005c_0029_0029">transparent dummy character (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Dummy-Characters">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-output-_0028cf_002c-trf_0029">transparent output (<code class="code">cf</code>, <code class="code">trf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-output-_0028_005c_0021_002c-_005c_003f_0029">transparent output (<code class="code">\!</code>, <code class="code">\?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-transparent-output_002c-incompatibilities-with-AT_0026T-troff">transparent output, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap">trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Deferring-Output">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-changing-location-_0028ch_0029">trap, changing location (<code class="code">ch</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-distance-to-next-vertical-position_002c-register-_0028_002et_0029">trap, distance to next vertical position, register (<code class="code">.t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-diversion_002c-setting-_0028dt_0029">trap, diversion, setting (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-end_002dof_002dinput_002c-setting-_0028em_0029">trap, end-of-input, setting (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-implicit">trap, implicit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#The-Implicit-Page-Trap">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-input-line_002c-clearing-_0028it_002c-itc_0029">trap, input line, clearing (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-input-line_002c-setting-_0028it_002c-itc_0029">trap, input line, setting (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-planting">trap, planting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Traps">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trap_002c-springing">trap, springing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Traps">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps">traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Traps">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-and-diversions">traps, and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-blank-line">traps, blank line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Blank-Line-Traps">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-diversion">traps, diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversion-Traps">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-end_002dof_002dinput">traps, end-of-input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#End_002dof_002dinput-Traps">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-input-line">traps, input line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-input-line_002c-and-interrupted-lines-_0028itc_0029">traps, input line, and interrupted lines (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Input-Line-Traps">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-leading-space">traps, leading space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Leading-Space-Traps">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-page-location">traps, page location</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-page-location_002c-dumping-_0028ptr_0029">traps, page location, dumping (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-page-location_002c-listing-_0028ptr_0029">traps, page location, listing (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-sprung-by-bp-request-_0028_002epe_0029">traps, sprung by <code class="code">bp</code> request (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-traps_002c-vertical-position">traps, vertical position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trf-request_002c-and-copy-mode"><code class="code">trf</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trf-request_002c-and-invalid-characters"><code class="code">trf</code> request, and invalid characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trf-request_002c-causing-implicit-break"><code class="code">trf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-trin-request_002c-and-asciify"><code class="code">trin</code> request, and <code class="code">asciify</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troff-mode"><code class="code">troff</code> mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#troff-and-nroff-Modes"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-troff-output"><code class="code">troff</code> output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#gtroff-Output">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-truncated-vertical-space-register-_0028_002etrunc_0029">truncated vertical space register (<code class="code">.trunc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Location-Traps">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-truncating-division">truncating division</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TTY_002c-conditional-output-for">TTY, conditional output for</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-tutorial-for-macro-users">tutorial for macro users</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tutorial-for-Macro-Users">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-size">type size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-size-registers-_0028_002es_002c-_002eps_0029">type size registers (<code class="code">.s</code>, <code class="code">.ps</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029">type size registers, last-requested (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-sizes_002c-changing-_0028ps_002c-_005cs_0029">type sizes, changing (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Type-Size">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-sizes_002c-fractional">type sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-type-sizes_002c-fractional-1">type sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Other-Differences">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-typeface">typeface</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-TZ_002c-environment-variable"><code>TZ<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-u-scaling-unit"><code class="code">u</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uf-request_002c-and-font-styles"><code class="code">uf</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Families">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ul-glyph_002c-and-cflags"><code class="code">ul</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-ul-request_002c-and-font-translations"><code class="code">ul</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Ultrix_002dspecific-man-macros">Ultrix-specific <code class="code">man</code> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Optional-man-extensions">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unadjustable-and-unbreakable-space-_0028_005cSP_0029">unadjustable and unbreakable space (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unary-arithmetic-operators">unary arithmetic operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unbreakable-and-unadjustable-space-_0028_005cSP_0029">unbreakable and unadjustable space (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unbreakable-space-_0028_005c_007e_0029">unbreakable space (<code class="code">\~</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-undefined-identifiers">undefined identifiers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-undefined-request">undefined request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Comments">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-underline-font-_0028uf_0029">underline font (<code class="code">uf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-underlining-_0028ul_0029">underlining (<code class="code">ul</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-underlining_002c-continuous-_0028cu_0029">underlining, continuous (<code class="code">cu</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Artificial-Fonts">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unformatting-diversions-_0028asciify_0029">unformatting diversions (<code class="code">asciify</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unformatting-horizontal-space">unformatting horizontal space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Punning-Names">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Unicode">Unicode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Identifiers">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-Unicode-1">Unicode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-c">unit, scaling, <code class="code">c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-f">unit, scaling, <code class="code">f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Colors">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-i">unit, scaling, <code class="code">i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-m">unit, scaling, <code class="code">m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-M">unit, scaling, <code class="code">M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-n">unit, scaling, <code class="code">n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-p">unit, scaling, <code class="code">p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-P">unit, scaling, <code class="code">P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-s">unit, scaling, <code class="code">s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-u">unit, scaling, <code class="code">u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-v">unit, scaling, <code class="code">v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unit_002c-scaling_002c-z">unit, scaling, <code class="code">z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-units-of-measurement">units of measurement</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-units_002c-basic">units, basic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-units_002c-basic_002c-conversion-to">units, basic, conversion to</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-units_002c-default">units, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Default-Units">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-units_002c-machine">units, machine</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unnamed-glyphs">unnamed glyphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unnamed-glyphs_002c-accessing-with-_005cN">unnamed glyphs, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Font-Description-File-Format">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-1">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Macro-Directories">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-2">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-3">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-4">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-5">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unsafe-mode-6">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-unstyled-font">unstyled font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fonts">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-up_002dcasing-a-string-_0028stringup_0029">up-casing a string (<code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-uppercasing-a-string-_0028stringup_0029">uppercasing a string (<code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Strings">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-upright-glyph_002c-correction-after-oblique-glyph-_0028_005c_002f_0029">upright glyph, correction after oblique glyph (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-upright-glyph_002c-correction-before-oblique-glyph-_0028_005c_002c_0029">upright glyph, correction before oblique glyph (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Italic-Corrections">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-URLs_002c-breaking-_0028_005c_003a_0029">URLs, breaking (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Hyphenation">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-user_0027s-macro-tutorial">user&rsquo;s macro tutorial</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tutorial-for-Macro-Users">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-user_0027s-tutorial-for-macros">user&rsquo;s tutorial for macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Tutorial-for-Macro-Users">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-using-escape-sequences">using escape sequences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Escape-Sequences">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-using-symbols">using symbols</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Symbols">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-UTF_002d8-output-encoding"><span class="w-nolinebreak-text">UTF-8</span> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Groff-Options">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-v-scaling-unit"><code class="code">v</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-valid-numeric-expression">valid numeric expression</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-value_002c-incrementing-without-changing-the-register">value, incrementing without changing the register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Auto_002dincrement">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-variables-in-environment">variables in environment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environment">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vee">vee</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vee-scaling-unit-_0028v_0029">vee scaling unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-version-number_002c-major_002c-register-_0028_002ex_0029">version number, major, register (<code class="code">.x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-version-number_002c-minor_002c-register-_0028_002ey_0029">version number, minor, register (<code class="code">.y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-drawing-position-_0028nl_0029">vertical drawing position (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-line-drawing-_0028_005cL_0029">vertical line drawing (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-line-spacing-register-_0028_002ev_0029">vertical line spacing register (<code class="code">.v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-line-spacing_002c-changing-_0028vs_0029">vertical line spacing, changing (<code class="code">vs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-line-spacing_002c-effective-value">vertical line spacing, effective value</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Changing-the-Vertical-Spacing">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-motion-_0028_005cv_0029">vertical motion (<code class="code">\v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-motion-quantum">vertical motion quantum</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-page-location_002c-marking-_0028mk_0029">vertical page location, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-page-location_002c-returning-to-marked-_0028rt_0029">vertical page location, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-position-in-diversion-register-_0028_002ed_0029">vertical position in diversion register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Diversions">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-position-trap-enable-register-_0028_002evpt_0029">vertical position trap enable register (<code class="code">.vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-position-traps">vertical position traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-position-traps_002c-enabling-_0028vpt_0029">vertical position traps, enabling (<code class="code">vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Vertical-Position-Traps">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-position_002c-drawing-_0028nl_0029">vertical position, drawing (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-resolution">vertical resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#DESC-File-Format">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-space-unit-_0028v_0029">vertical space unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Measurements">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-spacing">vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Geometry">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-spacing-1">vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Type-Size-and-Vertical-Spacing">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-vertical-spacing-_0028introduction_0029">vertical spacing (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Basics">Basics</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-W">W</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warning-categories">warning categories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warning-level-_0028warn_0029">warning level (<code class="code">warn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warnings">warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Debugging">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-warnings-1">warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Warnings">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-what-is-groff_003f">what is <code class="code">groff</code>?</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#What-Is-groff_003f">What Is <code class="code">groff</code>?</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while">while</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while-request_002c-and-font-translations"><code class="code">while</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while-request_002c-and-the-_0021-operator"><code class="code">while</code> request, and the &lsquo;<samp class="samp">!</samp>&rsquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Numeric-Expressions">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while-request_002c-confusing-with-br"><code class="code">while</code> request, confusing with <code class="code">br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#while">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-while-request_002c-operators-to-use-with"><code class="code">while</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Operators-in-Conditionals">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-widow">widow</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-widow-1">widow</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Control">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-width-escape-_0028_005cw_0029">width escape (<code class="code">\w</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-width_002c-of-last-glyph-_0028_002ew_0029">width, of last glyph (<code class="code">.w</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Environments">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-word-space-size-register-_0028_002ess_0029">word space size register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Manipulating-Filling-and-Adjustment">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-word_002c-definition-of">word, definition of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Filling">Filling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-write-request_002c-and-copy-mode"><code class="code">write</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writec-request_002c-and-copy-mode"><code class="code">writec</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writem-request_002c-and-copy-mode"><code class="code">writem</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writing-macros">writing macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Writing-Macros">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-writing-to-file-_0028write_002c-writec_0029">writing to file (<code class="code">write</code>, <code class="code">writec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#I_002fO">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Y">Y</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-year_002c-current_002c-register-_0028year_002c-yr_0029">year, current, register (<code class="code">year</code>, <code class="code">yr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Built_002din-Registers">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Z">Z</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-z-scaling-unit"><code class="code">z</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Using-Fractional-Type-Sizes">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029">zero-width printing (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029-1">zero-width printing (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Page-Motions">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="#index-zoom-factor-of-a-font-_0028fzoom_0029">zoom factor of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="#Selecting-Fonts">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="cp-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-1"><b>&quot;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-4"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-5"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-6"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-7"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-8"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-9"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-10"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-11"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-12"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-13"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-14"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-15"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-16"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-17"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-18"><b>\</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-19"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-20"><b>|</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+<hr>
+</div>
+</div>
+<div class="element-footnotes" id="SEC_Footnotes">
+<div class="nav-panel">
+<p>
+ &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<h4 class="footnotes-heading">Footnotes</h4>
+
+<h5 class="footnote-body-heading"><a id="FOOT1" href="#DOCF1">(1)</a></h5>
+<p>The &lsquo;<samp class="samp">g</samp>&rsquo; prefix is
+not used on all systems; see <a class="ref" href="#Invoking-groff">Invoking <code class="code">groff</code></a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT2" href="#DOCF2">(2)</a></h5>
+<p>Unix and related operating systems distinguish
+standard output and standard error streams <em class="emph">because</em> of
+<code class="code">troff</code>:
+<a class="uref" href="https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html">https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT3" href="#DOCF3">(3)</a></h5>
+<p>See <a class="xref" href="#Line-Layout">Line Layout</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT4" href="#DOCF4">(4)</a></h5>
+<p>Besides <code class="code">groff</code>, <code class="code">neatroff</code> is an
+exception.</p>
+<h5 class="footnote-body-heading"><a id="FOOT5" href="#DOCF5">(5)</a></h5>
+<p>The
+<code class="code">mso</code> request does not have these limitations.  See <a class="xref" href="#I_002fO">I/O</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT6" href="#DOCF6">(6)</a></h5>
+<p>The remainder of this chapter is based on
+<cite class="cite">Writing Papers with nroff using -me</cite> by Eric&nbsp;P. Allman,
+which is distributed with <code class="code">groff</code> as <samp class="file">meintro.me</samp>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT7" href="#DOCF7">(7)</a></h5>
+<p>While manual <em class="emph">pages</em> are older, early ones used
+macros supplanted by the <samp class="file">man</samp> package of Seventh Edition Unix
+(1979).  <samp class="file">ms</samp> shipped with Sixth Edition (1975) and was documented
+by Mike Lesk in a Bell Labs internal memorandum.</p>
+<h5 class="footnote-body-heading"><a id="FOOT8" href="#DOCF8">(8)</a></h5>
+<p>defined in <a class="ref" href="#ms-Footnotes">Footnotes</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT9" href="#DOCF9">(9)</a></h5>
+<p>Distinguish a
+document title from &ldquo;titles&rdquo;, which are what <code class="code">roff</code> systems call
+headers and footers collectively.</p>
+<h5 class="footnote-body-heading"><a id="FOOT10" href="#DOCF10">(10)</a></h5>
+<p>This idiosyncrasy arose through
+feature accretion; for example, the <code class="code">B</code> macro in Version&nbsp;6
+Unix <samp class="file">ms</samp> (1975) accepted only one argument, the text to be set in
+boldface.  By Version&nbsp;7 (1979) it recognized a second argument; in
+1990, <code class="code">groff</code> <samp class="file">ms</samp> added a &ldquo;pre&rdquo; argument, placing it third
+to avoid breaking support for older documents.</p>
+<h5 class="footnote-body-heading"><a id="FOOT11" href="#DOCF11">(11)</a></h5>
+<p>&ldquo;Portable Document Format Publishing with GNU
+Troff&rdquo;, <samp class="file">pdfmark.ms</samp> in the <code class="code">groff</code> distribution, uses this
+technique.</p>
+<h5 class="footnote-body-heading"><a id="FOOT12" href="#DOCF12">(12)</a></h5>
+<p>Unix Version&nbsp;7 <samp class="file">ms</samp>, its descendants, and GNU
+<samp class="file">ms</samp> prior to <code class="code">groff</code> version 1.23.0</p>
+<h5 class="footnote-body-heading"><a id="FOOT13" href="#DOCF13">(13)</a></h5>
+<p>You could reset it
+after each call to <code class="code">.1C</code>, <code class="code">.2C</code>, or <code class="code">.MC</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT14" href="#DOCF14">(14)</a></h5>
+<p><cite class="cite">Typing Documents on the UNIX System: Using the
+-ms Macros with Troff and Nroff</cite>, M.&nbsp;E. Lesk, Bell Laboratories,
+1978</p>
+<h5 class="footnote-body-heading"><a id="FOOT15" href="#DOCF15">(15)</a></h5>
+<p>Register values are converted to and stored as
+basic units.  See <a class="xref" href="#Measurements">Measurements</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT16" href="#DOCF16">(16)</a></h5>
+<p>If you redefine the <samp class="file">ms</samp> <code class="code">PT</code> macro
+and desire special treatment of certain page numbers (like &lsquo;<samp class="samp">1</samp>&rsquo;),
+you may need to handle a non-Arabic page number format, as <code class="code">groff</code>
+<samp class="file">ms</samp>&rsquo;s <code class="code">PT</code> does; see the macro package source.  <code class="code">groff</code>
+<samp class="file">ms</samp> aliases the <code class="code">PN</code> register to <code class="code">%</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT17" href="#DOCF17">(17)</a></h5>
+<p>The removal beforehand is necessary
+because <code class="code">groff</code> <samp class="file">ms</samp> aliases these macros to a diagnostic
+macro, and you want to redefine the aliased name, not its target.</p>
+<h5 class="footnote-body-heading"><a id="FOOT18" href="#DOCF18">(18)</a></h5>
+<p>See <a class="xref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT19" href="#DOCF19">(19)</a></h5>
+<p><i class="slanted">Tabs</i> and <i class="slanted">leaders</i> also separate
+words.  <i class="slanted">Escape sequences</i> can function as word characters, word
+separators, or neither&mdash;the last simply have no effect on GNU
+<code class="code">troff</code>&rsquo;s idea of whether an input character is within a word.
+We&rsquo;ll discuss all of these in due course.</p>
+<h5 class="footnote-body-heading"><a id="FOOT20" href="#DOCF20">(20)</a></h5>
+<p>A
+well-researched jeremiad appreciated by <code class="code">groff</code> contributors on
+both sides of the sentence-spacing debate can be found at
+<a class="uref" href="https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324">https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT21" href="#DOCF21">(21)</a></h5>
+<p>This statement oversimplifies; there are
+escape sequences whose purpose is precisely to produce glyphs on the
+output device, and input characters that <em class="emph">aren&rsquo;t</em> part of escape
+sequences can undergo a great deal of processing before getting to the
+output.</p>
+<h5 class="footnote-body-heading"><a id="FOOT22" href="#DOCF22">(22)</a></h5>
+<p>The mnemonics for the special
+characters shown here are &ldquo;dagger&rdquo;, &ldquo;double dagger&rdquo;, &ldquo;right
+(double) quote&rdquo;, and &ldquo;closing (single) quote&rdquo;.  See the
+<cite class="cite">groff_char<span class="r">(7)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT23" href="#DOCF23">(23)</a></h5>
+<p>&ldquo;Text lines&rdquo; are defined in <a class="ref" href="#Requests-and-Macros">Requests and Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT24" href="#DOCF24">(24)</a></h5>
+<p>&ldquo;Tab&rdquo;
+is short for &ldquo;tabulation&rdquo;, revealing the term&rsquo;s origin as a spacing
+mechanism for table arrangement.</p>
+<h5 class="footnote-body-heading"><a id="FOOT25" href="#DOCF25">(25)</a></h5>
+<p>The <code class="code">\<kbd class="key">RET</kbd></code> escape sequence can alter how an
+input line is classified; see <a class="ref" href="#Line-Continuation">Line Continuation</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT26" href="#DOCF26">(26)</a></h5>
+<p>Argument handling in
+macros is more flexible but also more complex.  See <a class="xref" href="#Calling-Macros">Calling Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT27" href="#DOCF27">(27)</a></h5>
+<p>Some escape sequences undergo
+interpolation as well.</p>
+<h5 class="footnote-body-heading"><a id="FOOT28" href="#DOCF28">(28)</a></h5>
+<p>GNU <code class="code">troff</code> offers additional ones.  See <a class="xref" href="#Writing-Macros">Writing Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT29" href="#DOCF29">(29)</a></h5>
+<p>Macro files and packages
+frequently define registers and strings as well.</p>
+<h5 class="footnote-body-heading"><a id="FOOT30" href="#DOCF30">(30)</a></h5>
+<p>The
+<em class="emph">semantics</em> of certain punctuation code points have gotten stricter
+with the successive standards, a cause of some frustration among man
+page writers; see the <cite class="cite">groff_char<span class="r">(7)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT31" href="#DOCF31">(31)</a></h5>
+<p>The
+DVI output device defaults to using the Computer Modern (CM) fonts;
+<samp class="file">ec.tmac</samp> loads the EC fonts instead, which provide Euro
+&lsquo;<samp class="samp">\Eu</samp>&rsquo; and per mille &lsquo;<samp class="samp">\%0</samp>&rsquo; glyphs.</p>
+<h5 class="footnote-body-heading"><a id="FOOT32" href="#DOCF32">(32)</a></h5>
+<p>Emacs: <code class="code">fill-column: 72</code>; Vim: <code class="code">textwidth=72</code></p>
+<h5 class="footnote-body-heading"><a id="FOOT33" href="#DOCF33">(33)</a></h5>
+<p><code class="code">groff</code> does not yet support right-to-left
+scripts.</p>
+<h5 class="footnote-body-heading"><a id="FOOT34" href="#DOCF34">(34)</a></h5>
+<p><code class="code">groff</code>&rsquo;s terminal output devices have page
+offsets of zero.</p>
+<h5 class="footnote-body-heading"><a id="FOOT35" href="#DOCF35">(35)</a></h5>
+<p>Provision is made for interpreting and
+reporting decimal fractions in certain cases.</p>
+<h5 class="footnote-body-heading"><a id="FOOT36" href="#DOCF36">(36)</a></h5>
+<p>If that&rsquo;s not enough, see the <cite class="cite">groff_tmac<span class="r">(5)</span></cite>
+man page for the <samp class="file">62bit.tmac</samp> macro package.</p>
+<h5 class="footnote-body-heading"><a id="FOOT37" href="#DOCF37">(37)</a></h5>
+<p>See <a class="xref" href="#Conditionals-and-Loops">Conditionals and Loops</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT38" href="#DOCF38">(38)</a></h5>
+<p>Control structure syntax
+creates an exception to this rule, but is designed to remain useful:
+recalling our example, &lsquo;<samp class="samp">.if 1 .Underline this</samp>&rsquo; would underline only
+&ldquo;this&rdquo;, precisely.  See <a class="xref" href="#Conditionals-and-Loops">Conditionals and Loops</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT39" href="#DOCF39">(39)</a></h5>
+<p>See <a class="xref" href="#Diversions">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT40" href="#DOCF40">(40)</a></h5>
+<p>Historically, control characters like
+ASCII STX, ETX, and BEL (<kbd class="key">Control+B</kbd>, <kbd class="key">Control+C</kbd>, and
+<kbd class="key">Control+G</kbd>) have been observed in <code class="code">roff</code> documents,
+particularly in macro packages employing them as delimiters with the
+output comparison operator to try to avoid collisions with the content
+of arbitrary user-supplied parameters (see <a class="pxref" href="#Operators-in-Conditionals">Operators in Conditionals</a>).  We discourage this expedient; in GNU <code class="code">troff</code> it is
+unnecessary (outside of compatibility mode) because delimited arguments
+are parsed at a different input level than the surrounding context.
+See <a class="xref" href="#Implementation-Differences">Implementation Differences</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT41" href="#DOCF41">(41)</a></h5>
+<p>Consider what happens when a C1 control
+<code class="code">0x80</code>&ndash;<code class="code">0x9F</code> is necessary as a continuation byte in a UTF-8
+sequence.</p>
+<h5 class="footnote-body-heading"><a id="FOOT42" href="#DOCF42">(42)</a></h5>
+<p>Recall <a class="ref" href="#Identifiers">Identifiers</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT43" href="#DOCF43">(43)</a></h5>
+<p>In compatibility
+mode, a space is not necessary after a request or macro name of two
+characters&rsquo; length.  Also, Plan&nbsp;9 <code class="code">troff</code> allows tabs to
+separate arguments.</p>
+<h5 class="footnote-body-heading"><a id="FOOT44" href="#DOCF44">(44)</a></h5>
+<p><code class="code">\~</code> is fairly
+portable; see <a class="ref" href="#Other-Differences">Other Differences</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT45" href="#DOCF45">(45)</a></h5>
+<p>Strictly, you can neglect to
+close the last quoted macro argument, relying on the end of the control
+line to do so.   We consider this lethargic practice poor style.</p>
+<h5 class="footnote-body-heading"><a id="FOOT46" href="#DOCF46">(46)</a></h5>
+<p>The omission of spaces before the comment
+escape sequences is necessary; see <a class="ref" href="#Strings">Strings</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT47" href="#DOCF47">(47)</a></h5>
+<p>TeX does have such a mechanism.</p>
+<h5 class="footnote-body-heading"><a id="FOOT48" href="#DOCF48">(48)</a></h5>
+<p>This claim may be more aspirational than descriptive.</p>
+<h5 class="footnote-body-heading"><a id="FOOT49" href="#DOCF49">(49)</a></h5>
+<p>See <a class="xref" href="#Conditional-Blocks">Conditional Blocks</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT50" href="#DOCF50">(50)</a></h5>
+<p>Exception: auto-incrementing registers defined outside
+the ignored region <em class="emph">will</em> be modified if interpolated with
+<code class="code">\n±</code> inside it.  See <a class="xref" href="#Auto_002dincrement">Auto-increment</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT51" href="#DOCF51">(51)</a></h5>
+<p>A negative auto-increment can be
+considered an &ldquo;auto-decrement&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT52" href="#DOCF52">(52)</a></h5>
+<p>GNU <code class="code">troff</code> dynamically allocates memory for
+as many registers as required.</p>
+<h5 class="footnote-body-heading"><a id="FOOT53" href="#DOCF53">(53)</a></h5>
+<p>unless diverted; see <a class="ref" href="#Diversions">Diversions</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT54" href="#DOCF54">(54)</a></h5>
+<p>See <a class="xref" href="#Line-Continuation">Line Continuation</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT55" href="#DOCF55">(55)</a></h5>
+<p>Recall <a class="ref" href="#Filling">Filling</a> and <a class="ref" href="#Sentences">Sentences</a> for the
+definitions of word and sentence boundaries, respectively.</p>
+<h5 class="footnote-body-heading"><a id="FOOT56" href="#DOCF56">(56)</a></h5>
+<p>Whether a perfect algorithm for this application is
+even possible is an unsolved problem in computer science:
+<a class="url" href="https://tug.org/docs/liang/liang-thesis.pdf">https://tug.org/docs/liang/liang-thesis.pdf</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT57" href="#DOCF57">(57)</a></h5>
+<p><code class="code">\%</code> itself stops marking
+hyphenation points but still produces no output glyph.</p>
+<h5 class="footnote-body-heading"><a id="FOOT58" href="#DOCF58">(58)</a></h5>
+<p>&ldquo;Soft&rdquo; because it appears in output
+only where a hyphenation break is performed; a &ldquo;hard&rdquo; hyphen, as in
+&ldquo;long-term&rdquo;, always appears.</p>
+<h5 class="footnote-body-heading"><a id="FOOT59" href="#DOCF59">(59)</a></h5>
+<p>The mode is a vector of Booleans encoded as an integer.
+To a programmer, this fact is easily deduced from the exclusive use of
+powers of two for the configuration parameters; they are computationally
+easy to &ldquo;mask off&rdquo; and compare to zero.  To almost everyone else, the
+arrangement seems recondite and unfriendly.</p>
+<h5 class="footnote-body-heading"><a id="FOOT60" href="#DOCF60">(60)</a></h5>
+<p>Hyphenation is
+prevented if the next page location trap is closer to the vertical
+drawing position than the next text baseline would be.  See <a class="xref" href="#Page-Location-Traps">Page Location Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT61" href="#DOCF61">(61)</a></h5>
+<p>For more on localization, see the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT62" href="#DOCF62">(62)</a></h5>
+<p>See <a class="xref" href="#Page-Location-Traps">Page Location Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT63" href="#DOCF63">(63)</a></h5>
+<p>See <a class="xref" href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT64" href="#DOCF64">(64)</a></h5>
+<p>or geometric objects; see <a class="ref" href="#Drawing-Geometric-Objects">Drawing Geometric Objects</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT65" href="#DOCF65">(65)</a></h5>
+<p>to the top-level diversion;
+see <a class="ref" href="#Diversions">Diversions</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT66" href="#DOCF66">(66)</a></h5>
+<p>Plan&nbsp;9 <code class="code">troff</code>
+uses the register <code class="code">.S</code> for this purpose.</p>
+<h5 class="footnote-body-heading"><a id="FOOT67" href="#DOCF67">(67)</a></h5>
+<p>This is pronounced to rhyme with &ldquo;feeder&rdquo;, and
+refers to how the glyphs &ldquo;lead&rdquo; the eye across the page to the
+corresponding page number or other datum.</p>
+<h5 class="footnote-body-heading"><a id="FOOT68" href="#DOCF68">(68)</a></h5>
+<p>A
+GNU <code class="command">nroff</code> program is available for convenience; it calls GNU
+<code class="code">troff</code> to perform the formatting.</p>
+<h5 class="footnote-body-heading"><a id="FOOT69" href="#DOCF69">(69)</a></h5>
+<p>Historically, the <code class="code">\c</code>
+escape sequence has proven challenging to characterize.  Some sources
+say it &ldquo;connects the next input text&rdquo; (to the input line on which it
+appears); others describe it as &ldquo;interrupting&rdquo; text, on the grounds
+that a text line is interrupted without breaking, perhaps to inject a
+request invocation or macro call.</p>
+<h5 class="footnote-body-heading"><a id="FOOT70" href="#DOCF70">(70)</a></h5>
+<p>See <a class="xref" href="#Traps">Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT71" href="#DOCF71">(71)</a></h5>
+<p>See <a class="xref" href="#Diversions">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT72" href="#DOCF72">(72)</a></h5>
+<p>Terminals and some output devices have fonts that render
+at only one or two sizes.  As examples of the latter, take the
+<code class="code">groff</code> <code class="code">lj4</code> device&rsquo;s Lineprinter, and <code class="code">lbp</code>&rsquo;s Courier
+and Elite faces.</p>
+<h5 class="footnote-body-heading"><a id="FOOT73" href="#DOCF73">(73)</a></h5>
+<p>Font designers prepare families such that the styles
+share esthetic properties.</p>
+<h5 class="footnote-body-heading"><a id="FOOT74" href="#DOCF74">(74)</a></h5>
+<p>Historically, the fonts
+<code class="code">troff</code>s dealt with were not Free Software or, as with the Graphic
+Systems C/A/T, did not even exist in the digital domain.</p>
+<h5 class="footnote-body-heading"><a id="FOOT75" href="#DOCF75">(75)</a></h5>
+<p>See <a class="xref" href="#Font-Description-File-Format">Font Description File Format</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT76" href="#DOCF76">(76)</a></h5>
+<p>See <a class="xref" href="#DESC-File-Format"><samp class="file">DESC</samp> File Format</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT77" href="#DOCF77">(77)</a></h5>
+<p>Not all versions of the <code class="code">man</code> program
+support the <samp class="option">-T</samp> option; use the subsequent example for an
+alternative.</p>
+<h5 class="footnote-body-heading"><a id="FOOT78" href="#DOCF78">(78)</a></h5>
+<p>This is &ldquo;Normalization Form D&rdquo;
+as documented in Unicode Standard Annex #15
+(<a class="uref" href="https://unicode.org/reports/tr15/">https://unicode.org/reports/tr15/</a>).</p>
+<h5 class="footnote-body-heading"><a id="FOOT79" href="#DOCF79">(79)</a></h5>
+<p>See <a class="xref" href="#Compatibility-Mode">Compatibility Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT80" href="#DOCF80">(80)</a></h5>
+<p>Output glyphs
+don&rsquo;t&mdash;to GNU <code class="code">troff</code>, a glyph is simply a box with an index into
+a font, a given height above and depth below the baseline, and a width.</p>
+<h5 class="footnote-body-heading"><a id="FOOT81" href="#DOCF81">(81)</a></h5>
+<p>Opinions of this escape sequence&rsquo;s name abound.
+&ldquo;Zero-width space&rdquo; is a popular misnomer: <code class="code">roff</code> formatters do
+not treat it like a space.  Ossanna called it a &ldquo;non-printing,
+zero-width character&rdquo;, but the character causes <em class="emph">output</em> even
+though it does not &ldquo;print&rdquo;.  If no output line is pending, the dummy
+character starts one.  Contrast an empty input document with one
+containing only <code class="code">\&amp;</code>.  The former produces no output; the latter, a
+blank page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT82" href="#DOCF82">(82)</a></h5>
+<p>In text fonts, the tallest glyphs are typically
+parentheses.  Unfortunately, in many cases the actual dimensions of the
+glyphs in a font do not closely match its declared type size!  For
+example, in the standard PostScript font families, 10-point Times sets
+better with 9-point Helvetica and 11-point Courier than if all three
+were used at 10&nbsp;points.</p>
+<h5 class="footnote-body-heading"><a id="FOOT83" href="#DOCF83">(83)</a></h5>
+<p>Rhyme with &ldquo;sledding&rdquo;; mechanical typography
+used lead metal (Latin <em class="emph">plumbum</em>).</p>
+<h5 class="footnote-body-heading"><a id="FOOT84" href="#DOCF84">(84)</a></h5>
+<p>The claim appears to have been true of Ossanna
+<code class="code">troff</code> for the C/A/T device; Kernighan made device-independent
+<code class="code">troff</code> more flexible.</p>
+<h5 class="footnote-body-heading"><a id="FOOT85" href="#DOCF85">(85)</a></h5>
+<p>See <a class="xref" href="#Device-and-Font-Description-Files">Device and Font Description Files</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT86" href="#DOCF86">(86)</a></h5>
+<p>also
+known vulgarly as &ldquo;ANSI colors&rdquo;</p>
+<h5 class="footnote-body-heading"><a id="FOOT87" href="#DOCF87">(87)</a></h5>
+<p>See <a class="xref" href="#Copy-Mode">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT88" href="#DOCF88">(88)</a></h5>
+<p>This refers to
+<code class="code">vtroff</code>, a translator that would convert the C/A/T output from
+early-vintage <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> to a form suitable for
+Versatec and Benson-Varian plotters.</p>
+<h5 class="footnote-body-heading"><a id="FOOT89" href="#DOCF89">(89)</a></h5>
+<p>Strictly, letters not otherwise recognized <em class="emph">are</em> treated
+as output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan&nbsp;9
+<code class="code">troff</code> uses &lsquo;<samp class="samp">h</samp>&rsquo; to test a mode it calls <code class="code">htmlroff</code>, and
+GNU <code class="code">troff</code> may provide additional operators in the future.</p>
+<h5 class="footnote-body-heading"><a id="FOOT90" href="#DOCF90">(90)</a></h5>
+<p>Because formatting of the comparands takes place
+in a dummy environment, vertical motions within them cannot spring
+traps.</p>
+<h5 class="footnote-body-heading"><a id="FOOT91" href="#DOCF91">(91)</a></h5>
+<p>All
+of this is to say that the lists of output nodes created by formatting
+<var class="var">xxx</var> and <var class="var">yyy</var> must be identical.  See <a class="xref" href="#Gtroff-Internals"><code class="code">gtroff</code> Internals</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT92" href="#DOCF92">(92)</a></h5>
+<p>This bizarre behavior maintains compatibility with
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT93" href="#DOCF93">(93)</a></h5>
+<p>See <a class="xref" href="#while">while</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT94" href="#DOCF94">(94)</a></h5>
+<p>See <a class="xref" href="#Copy-Mode">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT95" href="#DOCF95">(95)</a></h5>
+<p>unless you redefine it</p>
+<h5 class="footnote-body-heading"><a id="FOOT96" href="#DOCF96">(96)</a></h5>
+<p>&ldquo;somewhat less&rdquo; because
+things other than macro calls can be on the input stack</p>
+<h5 class="footnote-body-heading"><a id="FOOT97" href="#DOCF97">(97)</a></h5>
+<p>See <a class="xref" href="#Copy-Mode">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT98" href="#DOCF98">(98)</a></h5>
+<p>While it is possible to define and
+call a macro &lsquo;<samp class="samp">.</samp>&rsquo;, you can&rsquo;t use it as an end macro: during a macro
+definition, &lsquo;<samp class="samp">..</samp>&rsquo; is never handled as calling &lsquo;<samp class="samp">.</samp>&rsquo;, even if
+&lsquo;<samp class="samp">.de <var class="var">name</var> .</samp>&rsquo; explicitly precedes it.</p>
+<h5 class="footnote-body-heading"><a id="FOOT99" href="#DOCF99">(99)</a></h5>
+<p>Its structure is
+adapted from, and isomorphic to, part of a solution by Tadziu Hoffman to
+the problem of reflowing text multiple times to find an optimal
+configuration for it.
+<a class="uref" href="https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html">https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT100" href="#DOCF100">(100)</a></h5>
+<p>If they were not,
+parameter interpolations would be similar to command-line
+parameters&mdash;fixed for the entire duration of a <code class="code">roff</code> program&rsquo;s
+run.  The advantage of interpolating <code class="code">\$</code> escape sequences even in
+copy mode is that they can interpolate different contents from one call
+to the next, like function parameters in a procedural language.  The
+additional escape character is the price of this power.</p>
+<h5 class="footnote-body-heading"><a id="FOOT101" href="#DOCF101">(101)</a></h5>
+<p>Compare this to the <code class="code">\def</code> and <code class="code">\edef</code>
+commands in TeX.</p>
+<h5 class="footnote-body-heading"><a id="FOOT102" href="#DOCF102">(102)</a></h5>
+<p>These are lightly adapted from the <code class="code">groff</code>
+implementation of the <samp class="file">ms</samp> macros.</p>
+<h5 class="footnote-body-heading"><a id="FOOT103" href="#DOCF103">(103)</a></h5>
+<p>At the
+<code class="code">grops</code> defaults of 10-point type on 12-point vertical spacing, the
+difference between half a vee and half an em can be subtle: large
+spacings like &lsquo;<samp class="samp">.vs .5i</samp>&rsquo; make it obvious.</p>
+<h5 class="footnote-body-heading"><a id="FOOT104" href="#DOCF104">(104)</a></h5>
+<p>See <a class="xref" href="#Strings">Strings</a>, for an explanation of the trailing
+&lsquo;<samp class="samp">\&quot;</samp>&rsquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT105" href="#DOCF105">(105)</a></h5>
+<p>(<var class="var">hc</var>, <var class="var">vc</var>) is adjusted to the point nearest
+the perpendicular bisector of the arc&rsquo;s chord.</p>
+<h5 class="footnote-body-heading"><a id="FOOT106" href="#DOCF106">(106)</a></h5>
+<p>See <a class="xref" href="#The-Implicit-Page-Trap">The Implicit Page Trap</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT107" href="#DOCF107">(107)</a></h5>
+<p>A trap planted at &lsquo;<samp class="samp">20i</samp>&rsquo; or
+&lsquo;<samp class="samp">-30i</samp>&rsquo; will not be sprung on a page of length &lsquo;<samp class="samp">11i</samp>&rsquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT108" href="#DOCF108">(108)</a></h5>
+<p>It may help to think of each trap location as
+maintaining a queue; <code class="code">wh</code> operates on the head of the queue, and
+<code class="code">ch</code> operates on its tail.  Only the trap at the head of the queue
+is visible.</p>
+<h5 class="footnote-body-heading"><a id="FOOT109" href="#DOCF109">(109)</a></h5>
+<p>See <a class="xref" href="#Debugging">Debugging</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT110" href="#DOCF110">(110)</a></h5>
+<p>See <a class="xref" href="#Diversions">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT111" href="#DOCF111">(111)</a></h5>
+<p>While processing an
+end-of-input macro, the formatter assumes that the next page break must
+be the last; it goes into &ldquo;sudden death overtime&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT112" href="#DOCF112">(112)</a></h5>
+<p>Another, taken by the <code class="code">groff</code> <code class="code">man</code> macros, is
+to intercept <code class="code">ne</code> requests and wrap <code class="code">bp</code> ones.</p>
+<h5 class="footnote-body-heading"><a id="FOOT113" href="#DOCF113">(113)</a></h5>
+<p>Thus, the &ldquo;water&rdquo;
+gets &ldquo;higher&rdquo; proceeding <em class="emph">down</em> the page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT114" href="#DOCF114">(114)</a></h5>
+<p>The backslash is doubled.  See <a class="xref" href="#Copy-Mode">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT115" href="#DOCF115">(115)</a></h5>
+<p>that is, ISO&nbsp;646:1991-IRV or,
+popularly, &ldquo;US-ASCII&rdquo;</p>
+<h5 class="footnote-body-heading"><a id="FOOT116" href="#DOCF116">(116)</a></h5>
+<p>They are bypassed because these parameters are not
+rendered as glyphs in the output; instead, they remain abstract
+characters&mdash;in a PDF bookmark or a URL, for example.</p>
+<h5 class="footnote-body-heading"><a id="FOOT117" href="#DOCF117">(117)</a></h5>
+<p>Recall <a class="ref" href="#Line-Layout">Line Layout</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT118" href="#DOCF118">(118)</a></h5>
+<p>Historically,
+tools named <code class="command">nrchbar</code> and <code class="command">changebar</code> were developed for
+marking changes with margin characters and could be found in archives of
+the <code class="code">comp.sources.unix</code> <abbr class="acronym">USENET</abbr> group.  Some proprietary
+Unices also offer(ed) a <code class="command">diffmk</code> program.</p>
+<h5 class="footnote-body-heading"><a id="FOOT119" href="#DOCF119">(119)</a></h5>
+<p>Except the
+escape sequences <code class="code">\f</code>, <code class="code">\F</code>, <code class="code">\H</code>, <code class="code">\m</code>, <code class="code">\M</code>,
+<code class="code">\R</code>, <code class="code">\s</code>, and <code class="code">\S</code>, which are processed immediately if
+not in copy mode.</p>
+<h5 class="footnote-body-heading"><a id="FOOT120" href="#DOCF120">(120)</a></h5>
+<p>The
+Graphic Systems C/A/T phototypesetter (the original device target for
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>) supported only a few discrete type sizes
+in the range 6&ndash;36 points, so Ossanna contrived a special case in the
+parser to do what the user must have meant.  Kernighan warned of this in
+the 1992 revision of CSTR&nbsp;#54 (§2.3), and more recently, McIlroy
+referred to it as a &ldquo;living fossil&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT121" href="#DOCF121">(121)</a></h5>
+<p>DWB&nbsp;3.3, Solaris, Heirloom Doctools, and
+Plan&nbsp;9 <code class="code">troff</code> all support it.</p>
+<h5 class="footnote-body-heading"><a id="FOOT122" href="#DOCF122">(122)</a></h5>
+<p>Naturally, if you&rsquo;ve changed
+the escape character, you need to prefix the <code class="code">e</code> with whatever it
+is&mdash;and you&rsquo;ll likely get something other than a backslash in the
+output.</p>
+<h5 class="footnote-body-heading"><a id="FOOT123" href="#DOCF123">(123)</a></h5>
+<p>The <code class="code">rs</code> special character identifier was not
+defined in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>&rsquo;s font description files, but is
+in those of its lineal descendant, Heirloom Doctools <code class="code">troff</code>, as of
+the latter&rsquo;s 060716 release (July 2006).</p>
+<h5 class="footnote-body-heading"><a id="FOOT124" href="#DOCF124">(124)</a></h5>
+<p>The parser
+and postprocessor for intermediate output can be found in the file<br>
+<samp class="file"><var class="var">groff-source-dir</var>/src/libs/libdriver/input.cpp</samp>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT125" href="#DOCF125">(125)</a></h5>
+<p>Plan&nbsp;9 <code class="code">troff</code> has also abandoned the binary
+format.</p>
+<h5 class="footnote-body-heading"><a id="FOOT126" href="#DOCF126">(126)</a></h5>
+<p>800-point type
+is not practical for most purposes, but using it enables the quantities
+in the font description files to be expressed as integers.</p>
+<h5 class="footnote-body-heading"><a id="FOOT127" href="#DOCF127">(127)</a></h5>
+<p><code class="code">groff</code> requests and escape sequences
+interpret non-negative font names as mounting positions instead.
+Further, a font named &lsquo;<samp class="samp">0</samp>&rsquo; cannot be automatically mounted by the
+<code class="code">fonts</code> directive of a <samp class="file">DESC</samp> file.</p>
+<h5 class="footnote-body-heading"><a id="FOOT128" href="#DOCF128">(128)</a></h5>
+<p>For typesetter devices, this directive is misnamed
+since it starts a list of glyphs, not characters.</p>
+<h5 class="footnote-body-heading"><a id="FOOT129" href="#DOCF129">(129)</a></h5>
+<p>that is, any integer parsable by the C
+standard library&rsquo;s <cite class="cite">strtol<span class="r">(3)</span></cite> function</p>
+</div>
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Adjustment.html Added

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Adjustment (The GNU Troff Manual)</title>
+
+<meta name="description" content="Adjustment (The GNU Troff Manual)">
+<meta name="keywords" content="Adjustment (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Tabs-and-Leaders.html" rel="next" title="Tabs and Leaders">
+<link href="Breaking.html" rel="prev" title="Breaking">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="Tabs-and-Leaders.html" accesskey="n" rel="next">Tabs and Leaders</a>, Previous: <a href="Breaking.html" accesskey="p" rel="prev">Breaking</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Adjustment-1">5.1.5 Adjustment</h4>
+
+<a class="index-entry-id" id="index-extra-spaces-between-words"></a>
+<p>After GNU <code class="code">troff</code> performs an automatic break, it may then
+<em class="dfn">adjust</em> the line, widening inter-word spaces until the text reaches
+the right margin.  Extra spaces between words are preserved.  Leading
+and trailing spaces are handled as noted above.  Text can be aligned to
+the left or right margin only, or centered; see <a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Argument-Units.html Added

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Argument Units (The GNU Troff Manual)</title>
+
+<meta name="description" content="Argument Units (The GNU Troff Manual)">
+<meta name="keywords" content="Argument Units (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Language-Concepts.html" rel="up" title="Language Concepts">
+<link href="Document-Parts.html" rel="next" title="Document Parts">
+<link href="Separation.html" rel="prev" title="Separation">
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Argument-Units">
+<div class="nav-panel">
+<p>
+Next: <a href="Document-Parts.html" accesskey="n" rel="next">Document Parts</a>, Previous: <a href="Separation.html" accesskey="p" rel="prev">Separation</a>, Up: <a href="Language-Concepts.html" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Argument-Units-1">6.1.1.2 Argument Units</h4>
+
+<p>Some commands take integer arguments that are assumed to represent
+values in a measurement unit, but the letter for the corresponding
+scaling unit is not written with the output command arguments.  Most
+commands assume the scaling unit &lsquo;<samp class="samp">u</samp>&rsquo;, the basic unit of the device,
+some use &lsquo;<samp class="samp">z</samp>&rsquo;, the scaled point unit of the device, while others,
+such as the color commands, expect plain integers.
+</p>
+<p>Single characters can have the eighth bit set, as can the names of
+fonts and special characters.  The names of characters and fonts can be
+of arbitrary length.  A character that is to be printed is always in
+the current font.
+</p>
+<p>A string argument is always terminated by the next whitespace character
+(space, tab, or newline); an embedded &lsquo;<samp class="samp">#</samp>&rsquo; character is regarded as
+part of the argument, not as the beginning of a comment command.  An
+integer argument is already terminated by the next non-digit character,
+which then is regarded as the first character of the next argument or
+command.
+</p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Artificial-Fonts.html Added

@@ -0,0 +1,252 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Artificial Fonts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Artificial Fonts (The GNU Troff Manual)">
+<meta name="keywords" content="Artificial Fonts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Ligatures-and-Kerning.html" rel="next" title="Ligatures and Kerning">
+<link href="Special-Fonts.html" rel="prev" title="Special Fonts">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Artificial-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="Ligatures-and-Kerning.html" accesskey="n" rel="next">Ligatures and Kerning</a>, Previous: <a href="Special-Fonts.html" accesskey="p" rel="prev">Special Fonts</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Artificial-Fonts-1">5.19.7 Artificial Fonts</h4>
+<a class="index-entry-id" id="index-artificial-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-artificial"></a>
+
+<p>There are a number of requests and escape sequences for artificially
+creating fonts.  These are largely vestiges of the days when output
+devices did not have a wide variety of fonts, and when <code class="code">nroff</code> and
+<code class="code">troff</code> were separate programs.  Most of them are no longer
+necessary in GNU <code class="code">troff</code>.  Nevertheless, they are supported.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cH_0027height_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted">height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027height_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cH"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cH_0027_002bheight_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted"><code class="t">+</code>height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027_002bheight_0027'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cH_0027_002dheight_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\H<code class="code">'</code></code><span class="r"><i class="slanted"><code class="t">-</code>height</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cH_0027_002dheight_0027'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eheight_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.height</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eheight_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eheight"></a>
+<a class="index-entry-id" id="index-changing-the-font-height-_0028_005cH_0029"></a>
+<a class="index-entry-id" id="index-font-height_002c-changing-_0028_005cH_0029"></a>
+<a class="index-entry-id" id="index-height_002c-font_002c-changing-_0028_005cH_0029"></a>
+<p>Change (increment, decrement) the height of the current font, but not
+the width.  If <var class="var">height</var> is zero, restore the original height.
+Default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p>
+<p>The read-only register <code class="code">.height</code> contains the font height as set by
+<code class="code">\H</code>.
+</p>
+<p>Currently, only the <samp class="option">-Tps</samp> and <samp class="option">-Tpdf</samp> devices support
+this feature.
+</p>
+<p><code class="code">\H</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \H'+5z'x\H'0'
+</pre></div></div>
+
+<p>In compatibility mode, <code class="code">gtroff</code> behaves differently: If an
+increment or decrement is used, it is always taken relative to the
+current type size and not relative to the previously selected font
+height.  Thus,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1
+\H'+5'test \H'+5'test
+</pre></div></div>
+
+<p>prints the word &lsquo;<samp class="samp">test</samp>&rsquo; twice with the same font height (five points
+larger than the current font size).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cS_0027slant_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\S<code class="code">'</code></code><span class="r"><i class="slanted">slant</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cS_0027slant_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cS"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eslant_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.slant</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eslant_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eslant"></a>
+<a class="index-entry-id" id="index-changing-the-font-slant-_0028_005cS_0029"></a>
+<a class="index-entry-id" id="index-font-slant_002c-changing-_0028_005cS_0029"></a>
+<a class="index-entry-id" id="index-slant_002c-font_002c-changing-_0028_005cS_0029"></a>
+<p>Slant the current font by <var class="var">slant</var> degrees.  Positive values slant to
+the right.  Only integer values are possible.
+</p>
+<p>The read-only register <code class="code">.slant</code> contains the font slant as set by
+<code class="code">\S</code>.
+</p>
+<p>Currently, only the <samp class="option">-Tps</samp> and <samp class="option">-Tpdf</samp> devices support
+this feature.
+</p>
+<p><code class="code">\S</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \S'20'x\S'0'
+</pre></div></div>
+
+<a class="index-entry-id" id="index-CSTR-_002354-errata-3"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-_005cS-escape"></a>
+<p>This escape is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual; the slant is always set to an absolute value.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eul"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ul</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">lines</i></span></var><a class="copiable-link" href='#index-_002eul'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ul"></a>
+<a class="index-entry-id" id="index-underlining-_0028ul_0029"></a>
+<p>The <code class="code">ul</code> request normally underlines subsequent lines if a TTY
+output device is used.  Otherwise, the lines are printed in italics
+(only the term &lsquo;underlined&rsquo; is used in the following).  The single
+argument is the quantity of input lines to be underlined; with no
+argument, the next line is underlined.  If <var class="var">lines</var> is zero or
+negative, stop the effects of <code class="code">ul</code> (if it was active).  Requests
+and empty lines do not count for computing the number of underlined
+input lines, even if they produce some output like <code class="code">tl</code>.  Lines
+inserted by macros (e.g., invoked by a trap) do count.
+</p>
+<p>At the beginning of <code class="code">ul</code>, the current font is stored and the
+underline font is activated.  Within the span of a <code class="code">ul</code> request, it
+is possible to change fonts, but after the last line affected by
+<code class="code">ul</code> the saved font is restored.
+</p>
+<p>This number of lines still to be underlined is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).  The underline font can be changed
+with the <code class="code">uf</code> request.
+</p>
+
+
+<p>The <code class="code">ul</code> request does not underline spaces.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecu"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cu</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">lines</i></span></var><a class="copiable-link" href='#index-_002ecu'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cu"></a>
+<a class="index-entry-id" id="index-continuous-underlining-_0028cu_0029"></a>
+<a class="index-entry-id" id="index-underlining_002c-continuous-_0028cu_0029"></a>
+<p>The <code class="code">cu</code> request is similar to <code class="code">ul</code> but underlines spaces as
+well (if a TTY output device is used).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002euf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.uf</code></strong> <var class="def-var-arguments">font</var><a class="copiable-link" href='#index-_002euf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-uf"></a>
+<a class="index-entry-id" id="index-underline-font-_0028uf_0029"></a>
+<a class="index-entry-id" id="index-font-for-underlining-_0028uf_0029"></a>
+<p>Set the underline font (globally) used by <code class="code">ul</code> and <code class="code">cu</code>.  By
+default, this is the font at position&nbsp;2.  <var class="var">font</var> can be either
+a non-negative font position or the name of a font.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebd"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bd</code></strong> <var class="def-var-arguments">font <span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002ebd'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-bd"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ebd-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bd</code></strong> <var class="def-var-arguments">font1 font2 <span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002ebd-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.b</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eb"></a>
+<a class="index-entry-id" id="index-imitating-boldface-_0028bd_0029"></a>
+<a class="index-entry-id" id="index-boldface_002c-imitating-_0028bd_0029"></a>
+<p>Embolden <var class="var">font</var> by overstriking its glyphs offset by <var class="var">offset</var>
+units minus one.
+</p>
+<p>Two syntax forms are available.
+</p>
+<ul class="itemize mark-bullet">
+<li>Imitate a bold font unconditionally.  The first argument specifies the
+font to embolden, and the second is the number of basic units, minus
+one, by which the two glyphs are offset.  If the second argument is
+missing, emboldening is turned off.
+
+<p><var class="var">font</var> can be either a non-negative font position or the name of a
+font.
+</p>
+<p><var class="var">offset</var> is available in the <code class="code">.b</code> read-only register if a
+special font is active; in the <code class="code">bd</code> request, its default unit is
+&lsquo;<samp class="samp">u</samp>&rsquo;.
+</p>
+</li><li><a class="index-entry-id" id="index-fspecial-request_002c-and-imitating-bold"></a>
+<a class="index-entry-id" id="index-special"></a>
+<a class="index-entry-id" id="index-embolding-of-special-fonts"></a>
+<a class="index-entry-id" id="index-special-fonts_002c-emboldening"></a>
+Imitate a bold form conditionally.  Embolden <var class="var">font1</var> by <var class="var">offset</var>
+only if font <var class="var">font2</var> is the current font.  This request can be
+issued repeatedly to set up different emboldening values for different
+current fonts.  If the second argument is missing, emboldening is turned
+off for this particular current font.
+
+<p>This affects special fonts only (either set up with the <code class="code">special</code>
+command in font files or with the <code class="code">fspecial</code> request).
+</p></li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cs</code></strong> <var class="def-var-arguments">font <span class="r"><i class="slanted">width</i></span> <span class="r"><i class="slanted">em-size</i></span></var><a class="copiable-link" href='#index-_002ecs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cs"></a>
+<a class="index-entry-id" id="index-constant-glyph-space-mode-_0028cs_0029"></a>
+<a class="index-entry-id" id="index-mode-for-constant-glyph-space-_0028cs_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-constant-space"></a>
+<a class="index-entry-id" id="index-ps-request_002c-and-constant-glyph-space-mode"></a>
+<p>Switch to and from <em class="dfn">constant glyph space mode</em>.  If activated, the
+width of every glyph is <em class="math"><var class="var">width</var>/36</em> ems.  The em size is given
+absolutely by <var class="var">em-size</var>; if this argument is missing, the em value
+is taken from the current font size (as set with the <code class="code">ps</code> request)
+when the font is effectively in use.  Without second and third argument,
+constant glyph space mode is deactivated.
+</p>
+<p>Default scaling unit for <var class="var">em-size</var> is &lsquo;<samp class="samp">z</samp>&rsquo;; <var class="var">width</var> is an
+integer.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a>, Previous: <a href="Special-Fonts.html">Special Fonts</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Assigning-Register-Formats.html Added

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Assigning Register Formats (The GNU Troff Manual)</title>
+
+<meta name="description" content="Assigning Register Formats (The GNU Troff Manual)">
+<meta name="keywords" content="Assigning Register Formats (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Registers.html" rel="up" title="Registers">
+<link href="Built_002din-Registers.html" rel="next" title="Built-in Registers">
+<link href="Auto_002dincrement.html" rel="prev" title="Auto-increment">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Assigning-Register-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="Built_002din-Registers.html" accesskey="n" rel="next">Built-in Registers</a>, Previous: <a href="Auto_002dincrement.html" accesskey="p" rel="prev">Auto-increment</a>, Up: <a href="Registers.html" accesskey="u" rel="up">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Assigning-Register-Formats-1">5.8.4 Assigning Register Formats</h4>
+<a class="index-entry-id" id="index-assign-number-format-to-register-_0028af_0029"></a>
+<a class="index-entry-id" id="index-number-formats_002c-assigning-to-register-_0028af_0029"></a>
+<a class="index-entry-id" id="index-register_002c-assigning-number-format-to-_0028af_0029"></a>
+
+<p>A writable register&rsquo;s value can be interpolated in several number
+formats.  By default, conventional Arabic numerals are used.
+Other formats see use in sectioning and outlining schemes and
+alternative page numbering arrangements.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eaf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.af</code></strong> <var class="def-var-arguments">reg fmt</var><a class="copiable-link" href='#index-_002eaf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-af"></a>
+<p>Use number format <var class="var">fmt</var> when interpolating register <var class="var">reg</var>.
+Valid number formats are as follows.
+</p>
+<dl class="table">
+<dt><code class="code">0<span class="r">&hellip;</span></code></dt>
+<dd><p>Arabic numerals 0, 1, 2, and so on.
+Any decimal digit is equivalent to &lsquo;<samp class="samp">0</samp>&rsquo;; the formatter merely counts
+the digits specified.  Multiple Arabic numerals in <var class="var">fmt</var> cause
+interpolations to be zero-padded on the left if necessary to at least as
+many digits as specified (interpolations never truncate a register
+value).  A register with format &lsquo;<samp class="samp">00</samp>&rsquo; interpolates values 1, 2, 3 as
+&lsquo;<samp class="samp">01</samp>&rsquo;, &lsquo;<samp class="samp">02</samp>&rsquo;, &lsquo;<samp class="samp">03</samp>&rsquo;.  The default format for all writable
+registers is &lsquo;<samp class="samp">0</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-Roman-numerals'><span><code class="code">I</code><a class="copiable-link" href='#index-Roman-numerals'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-numerals_002c-Roman"></a>
+<p>Uppercase Roman numerals: 0, I, II, III, IV,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">i</code></dt>
+<dd><p>Lowercase Roman numerals: 0, i, ii, iii, iv,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">A</code></dt>
+<dd><p>Uppercase letters: 0, A, B, C, &hellip;,&nbsp;Z, AA, AB,&nbsp;<small class="enddots">...</small>
+</p>
+</dd>
+<dt><code class="code">a</code></dt>
+<dd><p>Lowercase letters: 0, a, b, c, &hellip;,&nbsp;z, aa, ab,&nbsp;<small class="enddots">...</small>
+</p></dd>
+</dl>
+
+<p>Omitting <var class="var">fmt</var> causes a warning in category &lsquo;<samp class="samp">missing</samp>&rsquo;.
+See <a class="xref" href="Warnings.html">Warnings</a>, for information about the enablement and suppression of
+warnings.  Specifying an unrecognized format is an error.
+</p>
+<p>Zero values are interpolated as &lsquo;<samp class="samp">0</samp>&rsquo; in non-Arabic formats.
+Negative quantities are prefixed with &lsquo;<samp class="samp">-</samp>&rsquo; irrespective of format.
+In Arabic formats, the sign supplements the field width.  If <var class="var">reg</var>
+doesn&rsquo;t exist, it is created with a zero value.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 10
+.af a 0           \&quot; the default format
+\na,
+.af a I
+\na,
+.af a 321
+.nr a (-\na)
+\na,
+.af a a
+\na
+    &rArr; 10, X, -010, -j
+</pre></div></div>
+
+<a class="index-entry-id" id="index-Roman-numerals_002c-extrema-_0028maximum-and-minimum_0029"></a>
+<a class="index-entry-id" id="index-extreme-values-representable-with-Roman-numerals"></a>
+<a class="index-entry-id" id="index-maximum-value-representable-with-Roman-numerals"></a>
+<a class="index-entry-id" id="index-minimum-value-representable-with-Roman-numerals"></a>
+<p>The representable extrema in the &lsquo;<samp class="samp">i</samp>&rsquo; and &lsquo;<samp class="samp">I</samp>&rsquo; formats
+correspond to Arabic ±39,999.  GNU <code class="code">troff</code> uses &lsquo;<samp class="samp">w</samp>&rsquo; and
+&lsquo;<samp class="samp">z</samp>&rsquo; to represent 5,000 and 10,000 in Roman numerals, respectively,
+following the convention of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>&mdash;currently, the
+correct glyphs for Roman numerals five thousand (<code class="code">U+2181</code>) and ten
+thousand (<code class="code">U+2182</code>) are not used.
+</p>
+<a class="index-entry-id" id="index-read_002donly-register_002c-changing-format"></a>
+<a class="index-entry-id" id="index-changing-format_002c-and-read_002donly-registers"></a>
+<p>Assigning the format of a read-only register is an error.  Instead, copy
+the read-only register&rsquo;s value to, and assign the format of, a writable
+register.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cgr"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g</code><span class="r"><i class="slanted">r</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cgr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cg"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cg_0028rg"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g(</code><span class="r"><i class="slanted">rg</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cg_0028rg'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cg_005breg_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\g</code><span class="r"><i class="slanted">reg</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cg_005breg_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-format-of-register-_0028_005cg_0029"></a>
+<a class="index-entry-id" id="index-register_002c-format-_0028_005cg_0029"></a>
+<p>Interpolate the format of the register <var class="var">reg</var> (one-character
+name&nbsp;<var class="var">r</var>, two-character name <var class="var">rg</var>).  Zeroes represent
+Arabic formats.  If <var class="var">reg</var> is not defined, <var class="var">reg</var> is not created
+and nothing is interpolated.  <code class="code">\g</code> is interpreted even in copy mode
+(see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-register-format_002c-in-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-and-register-format"></a>
+<p>GNU <code class="code">troff</code> interprets only Arabic numerals.  The Roman numeral or
+alphabetic formats cannot be used as operands to arithmetic operators in
+expressions (see <a class="pxref" href="Numeric-Expressions.html">Numeric Expressions</a>).  For instance, it may be
+desirable to test the page number independently of its format.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.af % i \&quot; front matter
+.de header-trap
+.  \&quot; To test the page number, we need it in Arabic.
+.  ds saved-page-number-format \\g%\&quot;
+.  af % 0
+.  nr page-number-in-decimal \\n%
+.  af % \\*saved-page-number-format
+.  ie \\npage-number-in-decimal=1 .do-first-page-stuff
+.  el \{\
+.    ie o .do-odd-numbered-page-stuff
+.    el   .do-even-numbered-page-stuff
+.  \}
+.  rm saved-page-number-format
+..
+.wh 0 header-trap
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Built_002din-Registers.html">Built-in Registers</a>, Previous: <a href="Auto_002dincrement.html">Auto-increment</a>, Up: <a href="Registers.html">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Auto_002dincrement.html Added

@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Auto-increment (The GNU Troff Manual)</title>
+
+<meta name="description" content="Auto-increment (The GNU Troff Manual)">
+<meta name="keywords" content="Auto-increment (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Registers.html" rel="up" title="Registers">
+<link href="Assigning-Register-Formats.html" rel="next" title="Assigning Register Formats">
+<link href="Interpolating-Registers.html" rel="prev" title="Interpolating Registers">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Auto_002dincrement">
+<div class="nav-panel">
+<p>
+Next: <a href="Assigning-Register-Formats.html" accesskey="n" rel="next">Assigning Register Formats</a>, Previous: <a href="Interpolating-Registers.html" accesskey="p" rel="prev">Interpolating Registers</a>, Up: <a href="Registers.html" accesskey="u" rel="up">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Auto_002dincrement-1">5.8.3 Auto-increment</h4>
+<a class="index-entry-id" id="index-auto_002dincrementation-of-a-register"></a>
+<a class="index-entry-id" id="index-incrementation_002c-automatic_002c-of-a-register"></a>
+<a class="index-entry-id" id="index-decrementation_002c-automatic_002c-of-a-register"></a>
+
+<p>Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.  The value of the increment is
+specified with a third argument to the <code class="code">nr</code> request, and a special
+interpolation syntax is used to alter and then retrieve the register&rsquo;s
+value.  Together, these features are called
+<em class="dfn">auto-increment</em>.<a class="footnote" id="DOCF51" href="groff.html_fot.html#FOOT51"><sup>51</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr-4"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">ident value incr</var><a class="copiable-link" href='#index-_002enr-4'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr-3"></a>
+<a class="index-entry-id" id="index-_005cR_002c-difference-from-nr"></a>
+<p>Set register <var class="var">ident</var> to <var class="var">value</var> and its auto-incrementation
+amount to to <var class="var">incr</var>.  The <code class="code">\R</code> escape sequence doesn&rsquo;t support
+an <var class="var">incr</var> argument.
+</p></dd></dl>
+
+<p>Auto-incrementation is not <em class="emph">completely</em> automatic; the <code class="code">\n</code>
+escape sequence in its basic form never alters the value of a register.
+To apply auto-incrementation to a register, interpolate it with
+&lsquo;<samp class="samp">\n±</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_002bi"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002bi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cn-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_002di"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002di'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002b_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002b_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002d_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002d_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002b_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n+</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002b_005bident_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_002d_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n-</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_002d_005bident_005d'> &para;</a></span></dt>
+<dd><p>Increment or decrement <var class="var">ident</var> (one-character
+name&nbsp;<var class="var">i</var>, two-character name <var class="var">id</var>) by the register&rsquo;s
+auto-incrementation value and then interpolate the new register value.
+If <var class="var">ident</var> has no auto-incrementation value, interpolate as with
+<code class="code">\n</code>.
+</p></dd></dl>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0 1
+.nr xx 0 5
+.nr foo 0 -2
+\n+a, \n+a, \n+a, \n+a, \n+a
+.br
+\n-(xx, \n-(xx, \n-(xx, \n-(xx, \n-(xx
+.br
+\n+foo, \n+foo, \n+foo, \n+foo, \n+foo
+    &rArr; 1, 2, 3, 4, 5
+    &rArr; -5, -10, -15, -20, -25
+    &rArr; -2, -4, -6, -8, -10
+</pre></div></div>
+
+<a class="index-entry-id" id="index-increment-value-without-changing-the-register"></a>
+<a class="index-entry-id" id="index-value_002c-incrementing-without-changing-the-register"></a>
+<p>To change the increment value without changing the value of a register,
+assign the register&rsquo;s value to itself by interpolating it, and specify
+the desired increment normally.  Apply an increment of &lsquo;<samp class="samp">0</samp>&rsquo; to
+disable auto-incrementation of the register.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Assigning-Register-Formats.html">Assigning Register Formats</a>, Previous: <a href="Interpolating-Registers.html">Interpolating Registers</a>, Up: <a href="Registers.html">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Background.html Added

@@ -0,0 +1,96 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Background (The GNU Troff Manual)</title>
+
+<meta name="description" content="Background (The GNU Troff Manual)">
+<meta name="keywords" content="Background (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="What-Is-groff_003f.html" rel="next" title="What Is groff?">
+<link href="Introduction.html" rel="prev" title="Introduction">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Background">
+<div class="nav-panel">
+<p>
+Next: <a href="What-Is-groff_003f.html" accesskey="n" rel="next">What Is <code class="code">groff</code>?</a>, Previous: <a href="Introduction.html" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Background-1">1.1 Background</h3>
+<a class="index-entry-id" id="index-background"></a>
+
+<p>M. Douglas McIlroy, formerly of AT&amp;T Bell Laboratories and present at
+the creation of the Unix operating system, offers an authoritative
+historical summary.
+</p>
+<blockquote class="quotation">
+<p>The prime reason for Unix was the desire of Ken Thompson, Dennis
+Ritchie, and Joe Ossanna to have a pleasant environment for software
+development.  The fig leaf that got the nod from &hellip;
+management was that an early use would be to develop a &ldquo;stand-alone&rdquo;
+word-processing system for use in typing pools and secretarial offices.
+Perhaps they had in mind &ldquo;dedicated&rdquo;, as distinct from
+&ldquo;stand-alone&rdquo;; that&rsquo;s what eventuated in various cases, most notably
+in the legal/patent department and in the AT&amp;T CEO&rsquo;s office.
+</p>
+<p>Both those systems were targets of opportunity, not foreseen from the
+start.  When Unix was up and running on the PDP-11, Joe got wind of
+the legal department having installed a commercial word processor.
+He went to pitch Unix as an alternative and clinched a trial by
+promising to make <code class="code">roff</code> able to number lines by tomorrow in order
+to fulfill a patent-office requirement that the commercial system did
+not support.
+</p>
+<p>Modems were installed so legal-department secretaries could try the
+Research machine.  They liked it and Joe&rsquo;s superb customer service.
+Soon the legal department got a system of their own.  Joe went on to
+create <code class="code">nroff</code> and <code class="code">troff</code>.  Document preparation became a
+widespread use of Unix, but no stand-alone word-processing system was
+ever undertaken.
+</p></blockquote>
+
+<p>A history relating <code class="code">groff</code> to its predecessors <code class="code">roff</code>,
+<code class="code">nroff</code>, and <code class="code">troff</code> is available in the <cite class="cite">roff<span class="r">(7)</span></cite>
+man page.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="What-Is-groff_003f.html">What Is <code class="code">groff</code>?</a>, Previous: <a href="Introduction.html">Introduction</a>, Up: <a href="Introduction.html">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Basics.html Added

@@ -0,0 +1,232 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Basics (The GNU Troff Manual)</title>
+
+<meta name="description" content="Basics (The GNU Troff Manual)">
+<meta name="keywords" content="Basics (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Tutorial-for-Macro-Users.html" rel="up" title="Tutorial for Macro Users">
+<link href="Common-Features.html" rel="next" title="Common Features">
+<link href="Tutorial-for-Macro-Users.html" rel="prev" title="Tutorial for Macro Users">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Basics">
+<div class="nav-panel">
+<p>
+Next: <a href="Common-Features.html" accesskey="n" rel="next">Common Features</a>, Previous: <a href="Tutorial-for-Macro-Users.html" accesskey="p" rel="prev">Tutorial for Macro Users</a>, Up: <a href="Tutorial-for-Macro-Users.html" accesskey="u" rel="up">Tutorial for Macro Users</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Basics-1">3.1 Basics</h3>
+<a class="index-entry-id" id="index-basics-of-macro-package-usage"></a>
+<a class="index-entry-id" id="index-macro-package-usage_002c-basics-of"></a>
+
+<p>Let us first survey some basic concepts necessary to use a macro package
+fruitfully.<a class="footnote" id="DOCF6" href="groff.html_fot.html#FOOT6"><sup>6</sup></a>
+References are made throughout to more detailed information.
+</p>
+<p>GNU <code class="code">troff</code> reads an input file prepared by the user and outputs a
+formatted document suitable for publication or framing.  The input
+consists of text, or words to be printed, and embedded commands
+(<i class="slanted">requests</i> and <i class="slanted">escape sequences</i>), which tell GNU
+<code class="code">troff</code> how to format the output.  See <a class="xref" href="Formatter-Instructions.html">Formatter Instructions</a>.
+</p>
+<p>The word <i class="slanted">argument</i> is used in this chapter to mean a word or
+number that appears on the same line as a request, and which modifies
+the meaning of that request.  For example, the request
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp
+</pre></div></div>
+
+<p>spaces one line, but
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp 4
+</pre></div></div>
+
+<p>spaces four lines.  The number&nbsp;4 is an argument to the <code class="code">sp</code>
+request, which says to space four lines instead of one.  Arguments are
+separated from the request and from each other by spaces (<em class="emph">not</em>
+tabs).  See <a class="xref" href="Invoking-Requests.html">Invoking Requests</a>.
+</p>
+<p>The primary function of GNU <code class="code">troff</code> is to collect words from input
+lines, fill output lines with those words, adjust the line to the
+right-hand margin by widening spaces, and output the result.  For
+example, the input:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Now is the time
+for all good men
+to come to the aid
+of their party.
+Four score and seven
+years ago, etc.
+</pre></div></div>
+
+<p>is read, packed onto output lines, and justified to produce:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; Now is the time for all good men to come to the aid of
+  &rArr; their party.  Four score and seven years ago, etc.
+</pre></div></div>
+
+<p>Sometimes a new output line should be started even though the current
+line is not yet full&mdash;for example, at the end of a paragraph.  To do
+this it is possible to force a <i class="slanted">break</i>, starting a new output
+line.  Some requests cause a break automatically, as do (normally) blank
+input lines and input lines beginning with a space or tab.
+</p>
+<p>Not all input lines are <i class="slanted">text lines</i>&mdash;words to be formatted.
+Some are <i class="slanted">control lines</i> that tell a macro package (or GNU
+<code class="code">troff</code> directly) how to format the text.  Control lines start with
+a dot (&lsquo;<samp class="samp">.</samp>&rsquo;) or an apostrophe (&lsquo;<samp class="samp">'</samp>&rsquo;) as the first character, and
+can be followed by a <i class="slanted">macro call</i>.
+</p>
+<p>The formatter also does more complex things, such as automatically
+numbering pages, skipping over page boundaries, putting footnotes in the
+correct place, and so forth.
+</p>
+<p>Here are a few hints for preparing text for input to GNU <code class="code">troff</code>.
+</p>
+<ul class="itemize mark-bullet">
+<li>First, keep the input lines short.  Short input lines are easier to
+edit, and GNU <code class="code">troff</code> packs words onto longer lines anyhow.
+
+</li><li>In keeping with this, it is helpful to begin a new line after every
+comma or phrase, since common corrections are to add or delete sentences
+or phrases.
+
+</li><li>End each sentence with two spaces&mdash;or better, start each sentence on a
+new line.  GNU <code class="code">troff</code> recognizes characters that usually end a
+sentence, and inserts inter-sentence space accordingly.
+
+</li><li>Do not hyphenate words at the end of lines&mdash;GNU <code class="code">troff</code> is smart
+enough to hyphenate words as needed, but is not smart enough to take
+hyphens out and join a word back together.  Also, words such as
+&ldquo;mother-in-law&rdquo; should not be broken over a line, since then a space
+can occur where not wanted, such as &ldquo;<span class="w-nolinebreak-text">mother-</span>&nbsp;in-law&rdquo;.
+</li></ul>
+
+<p>We offer further advice in <a class="ref" href="Input-Conventions.html">Input Conventions</a>.
+</p>
+<a class="index-entry-id" id="index-vertical-spacing-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical-_0028introduction_0029"></a>
+<p>GNU <code class="code">troff</code> permits alteration of the distance between lines of
+text.  This is termed <i class="slanted">vertical spacing</i> and is expressed in the
+same units as the type size&mdash;the point.  The default is 10-point type
+on 12-point spacing.  To get <i class="slanted">double-spaced</i> text you would set
+the vertical spacing to 24 points.  Some, but not all, macro packages
+expose a macro or register to configure the vertical spacing.
+</p>
+<p>A number of requests allow you to change the way the output is arranged
+on the page, sometimes called the <i class="slanted">layout</i> of the output page.
+Most macro packages don&rsquo;t supply macros for performing these (at least
+not without performing other actions besides), as they are such basic
+operations.  The macro packages for writing man pages, <samp class="file">man</samp> and
+<samp class="file">mdoc</samp>, don&rsquo;t encourage explicit use of these requests at all.
+</p>
+<a class="index-entry-id" id="index-spacing-_0028introduction_0029"></a>
+<p>The request &lsquo;<samp class="samp">.sp&nbsp;<var class="var">N</var></samp>&rsquo; leaves <var class="var">N</var>&nbsp;lines of blank
+space.  <var class="var">N</var>&nbsp;can be omitted (skipping a single line) or can
+be of the form <var class="var">N</var>i (for <var class="var">N</var>&nbsp;inches) or <var class="var">N</var>c (for
+<var class="var">N</var>&nbsp;centimeters).  For example, the input:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sp 1.5i
+My thoughts on the subject
+.sp
+</pre></div></div>
+
+<p>leaves one and a half inches of space, followed by the line &ldquo;My
+thoughts on the subject&rdquo;, followed by a single blank line (more
+measurement units are available; see <a class="ref" href="Measurements.html">Measurements</a>).
+</p>
+<p>If you seek precision in spacing, be advised when using a macro package
+that it might not honor <code class="code">sp</code> requests as you expect; it can use a
+formatter feature called <i class="slanted">no-space mode</i> to prevent excess space
+from accumulating.  Macro packages typically offer registers to control
+spacing between paragraphs, before section headings, and around displays
+(discussed below); use these facilities preferentially.
+See <a class="xref" href="Manipulating-Spacing.html">Manipulating Spacing</a>.
+</p>
+<a class="index-entry-id" id="index-centering-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-centering-_0028introduction_0029"></a>
+<p>Text lines can be centered by using the <code class="code">ce</code> request.  The line
+after <code class="code">ce</code> is centered (horizontally) on the page.  To center more
+than one line, use &lsquo;<samp class="samp">.ce&nbsp;<var class="var">N</var></samp>&rsquo; (where <var class="var">N</var> is the number
+of lines to center), followed by the <var class="var">N</var>&nbsp;lines.  To center many
+lines without counting them, type:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ce 1000
+lines to center
+.ce 0
+</pre></div></div>
+
+<p>The &lsquo;<samp class="samp">.ce&nbsp;0</samp>&rsquo; request tells GNU <code class="code">troff</code> to center zero more
+lines, in other words, stop centering.
+</p>
+<a class="index-entry-id" id="index-right_002daligning-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-right_002daligning-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-right_002djustifying-lines-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-right_002djustifying-_0028introduction_0029"></a>
+<p>GNU <code class="code">troff</code> also offers the <code class="code">rj</code> request for right-aligning
+text.  It works analogously to <code class="code">ce</code> and is convenient for setting
+epigraphs.
+</p>
+<a class="index-entry-id" id="index-page-break-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-break_002c-page-_0028introduction_0029"></a>
+<p>The <code class="code">bp</code> request starts a new page; this necessarily implies an
+ordinary (line) break.
+</p>
+<a class="index-entry-id" id="index-break-_0028introduction_0029"></a>
+<a class="index-entry-id" id="index-line-break-_0028introduction_0029"></a>
+<p>All of these requests cause a break; that is, they always start a new
+line.  To start a new line without performing any other action, use
+<code class="code">br</code>.  If you invoke them with the apostrophe &lsquo;<samp class="samp">'</samp>&rsquo;, the
+<i class="slanted">no-break control character</i>, the (initial) break they normally
+perform is suppressed.  &lsquo;<samp class="samp">'br</samp>&rsquo; does nothing.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Common-Features.html">Common Features</a>, Previous: <a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a>, Up: <a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Blank-Line-Traps.html Added

@@ -0,0 +1,71 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Blank Line Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Blank Line Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Blank Line Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Traps.html" rel="up" title="Traps">
+<link href="Leading-Space-Traps.html" rel="next" title="Leading Space Traps">
+<link href="Input-Line-Traps.html" rel="prev" title="Input Line Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Blank-Line-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="Leading-Space-Traps.html" accesskey="n" rel="next">Leading Space Traps</a>, Previous: <a href="Input-Line-Traps.html" accesskey="p" rel="prev">Input Line Traps</a>, Up: <a href="Traps.html" accesskey="u" rel="up">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Blank-Line-Traps-1">5.28.3 Blank Line Traps</h4>
+<a class="index-entry-id" id="index-blank-line-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-blank-line"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eblm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.blm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eblm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-blm"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029-2"></a>
+<p>Set a blank line trap, calling the macro <var class="var">name</var> when GNU
+<code class="code">troff</code> encounters a blank line in an input file, instead of the
+usual behavior (see <a class="pxref" href="Breaking.html">Breaking</a>).  A line consisting only of spaces is
+also treated as blank and subject to this trap.  If no argument is
+supplied, the default blank line behavior is (re-)established.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Breaking.html Added

@@ -0,0 +1,119 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Breaking (The GNU Troff Manual)</title>
+
+<meta name="description" content="Breaking (The GNU Troff Manual)">
+<meta name="keywords" content="Breaking (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Adjustment.html" rel="next" title="Adjustment">
+<link href="Hyphenation.html" rel="prev" title="Hyphenation">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Breaking">
+<div class="nav-panel">
+<p>
+Next: <a href="Adjustment.html" accesskey="n" rel="next">Adjustment</a>, Previous: <a href="Hyphenation.html" accesskey="p" rel="prev">Hyphenation</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Breaking-1">5.1.4 Breaking</h4>
+<a class="index-entry-id" id="index-break"></a>
+<a class="index-entry-id" id="index-implicit-line-break"></a>
+<a class="index-entry-id" id="index-line-break_002c-output"></a>
+<a class="index-entry-id" id="index-output-line-break"></a>
+
+<p>Once an output line is full, the next word (or remainder of a hyphenated
+one) is placed on a different output line; this is called a <em class="dfn">break</em>.
+In this manual and in <code class="code">roff</code> discussions generally, a &ldquo;break&rdquo; if
+not further qualified always refers to the termination of an output
+line.  When the formatter is filling text, it introduces breaks
+automatically to keep output lines from exceeding the configured line
+length.  After an automatic break, GNU <code class="code">troff</code> adjusts the line if
+applicable (see below), and then resumes collecting and filling text on
+the next output line.
+</p>
+<p>Sometimes, a line cannot be broken automatically.  This usually does
+not happen with natural language text unless the output line length has
+been manipulated to be extremely short, but it can with specialized
+text like program source code.  We can use <code class="code">perl</code> at the shell
+prompt to contrive an example of failure to break the line.  We also
+employ the <samp class="option">-z</samp> option to suppress normal output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ perl -e 'print &quot;#&quot; x 80, &quot;\n&quot;;' | nroff -z
+    error&rarr; warning: cannot break line
+</pre></div></div>
+
+<p>The remedy for these cases is to tell GNU <code class="code">troff</code> where the line
+may be broken without hyphens.  This is done with the non-printing break
+point escape sequence &lsquo;<samp class="samp">\:</samp>&rsquo;; see <a class="ref" href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a>.
+</p>
+<a class="index-entry-id" id="index-blank-line"></a>
+<a class="index-entry-id" id="index-empty-line"></a>
+<a class="index-entry-id" id="index-line_002c-blank"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029"></a>
+<p>What if the document author wants to stop filling lines temporarily, for
+instance to start a new paragraph?  There are several solutions.  A
+blank input line not only causes a break, but by default it also outputs
+a one-line vertical space (effectively a blank output line).  This
+behavior can be modified; see <a class="ref" href="Blank-Line-Traps.html">Blank Line Traps</a>.  Macro packages
+may discourage or disable the blank line method of paragraphing in favor
+of their own macros.
+</p>
+<a class="index-entry-id" id="index-leading-spaces"></a>
+<a class="index-entry-id" id="index-spaces_002c-leading-and-trailing"></a>
+<a class="index-entry-id" id="index-trailing-spaces-on-text-lines"></a>
+<a class="index-entry-id" id="index-leading-space-macro-_0028lsm_0029"></a>
+<p>A line that begins with one or more spaces causes a break.  The spaces
+are output at the beginning of the next line without being
+<em class="emph">adjusted</em> (see below); however, this behavior can be modified
+(see <a class="pxref" href="Leading-Space-Traps.html">Leading Space Traps</a>).  Again, macro packages may provide other
+methods of producing indented paragraphs.  Trailing spaces on text lines
+are discarded.<a class="footnote" id="DOCF23" href="groff.html_fot.html#FOOT23"><sup>23</sup></a>
+</p>
+<p>What if the file ends before enough words have been collected to fill an
+output line?  Or the output line is exactly full but not yet broken, and
+there is no more input?  GNU <code class="code">troff</code> interprets the end of input as
+a break.  Certain requests also cause breaks, implicitly or explicitly.
+This is discussed in <a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Adjustment.html">Adjustment</a>, Previous: <a href="Hyphenation.html">Hyphenation</a>, Up: <a href="Text.html">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Built_002din-Registers.html Added

@@ -0,0 +1,253 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Built-in Registers (The GNU Troff Manual)</title>
+
+<meta name="description" content="Built-in Registers (The GNU Troff Manual)">
+<meta name="keywords" content="Built-in Registers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Registers.html" rel="up" title="Registers">
+<link href="Assigning-Register-Formats.html" rel="prev" title="Assigning Register Formats">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Built_002din-Registers">
+<div class="nav-panel">
+<p>
+Previous: <a href="Assigning-Register-Formats.html" accesskey="p" rel="prev">Assigning Register Formats</a>, Up: <a href="Registers.html" accesskey="u" rel="up">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Built_002din-Registers-1">5.8.5 Built-in Registers</h4>
+<a class="index-entry-id" id="index-built_002din-registers"></a>
+<a class="index-entry-id" id="index-registers_002c-built_002din"></a>
+
+<p>Predefined registers whose identifiers start with a dot are read-only.
+Many are Boolean-valued, interpolating a true or false value testable
+with the <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code> requests.  Some read-only
+registers are string-valued, meaning that they interpolate text.
+</p>
+<a class="index-entry-id" id="index-removing-a-built_002din-register"></a>
+<a class="index-entry-id" id="index-register_002c-built_002din_002c-removing"></a>
+<a class="index-entry-id" id="index-built_002din-register_002c-removing"></a>
+<p><strong class="strong">Caution:</strong> Built-in registers are subject to removal like
+others; once removed, they can be recreated only as normal writable
+registers and will not reflect formatter state.
+</p>
+<p>A register name (without the dot) is often associated with a request of
+the same name.  A complete listing of all built-in registers can be
+found in <a class="ref" href="Register-Index.html">Register Index</a>.
+</p>
+<p>We present here a few built-in registers that are not described
+elsewhere in this manual; they have to do with invariant properties of
+GNU <code class="code">troff</code>, or obtain information about the formatter&rsquo;s
+command-line options, processing progress, or the operating environment.
+</p>
+<dl class="table">
+<dt id='index-_002eA'><span><code class="code">\n.A</code><a class="copiable-link" href='#index-_002eA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-approximation-output-register-_0028_002eA_0029"></a>
+<a class="index-entry-id" id="index-plain-text-approximation-output-register-_0028_002eA_0029-1"></a>
+<p>Approximate output is being formatted (Boolean-valued); see
+<code class="command">groff</code> <samp class="option">-a</samp> option (<a class="ref" href="Groff-Options.html">Options</a>).
+</p>
+</dd>
+<dt id='index-c_002e'><span><code class="code">\n.c</code><a class="copiable-link" href='#index-c_002e'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ec"></a>
+</dd>
+<dt><code class="code">\nc.</code></dt>
+<dd><a class="index-entry-id" id="index-input-line-number-register-_0028_002ec_002c-c_002e_0029"></a>
+<a class="index-entry-id" id="index-line-number_002c-input_002c-register-_0028_002ec_002c-c_002e_0029"></a>
+<p>Input line number.  &lsquo;<samp class="samp">c.</samp>&rsquo; is a writable synonym,
+affecting subsequent interpolations of both &lsquo;<samp class="samp">.c</samp>&rsquo; and &lsquo;<samp class="samp">c.</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-current-input-file-name-register-_0028_002eF_0029'><span><code class="code">\n.F</code><a class="copiable-link" href='#index-current-input-file-name-register-_0028_002eF_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-input-file-name_002c-current_002c-register-_0028_002eF_0029"></a>
+<a class="index-entry-id" id="index-_002eF"></a>
+<p>Name of input file (string-valued).
+</p>
+</dd>
+<dt id='index-_002eg'><span><code class="code">\n.g</code><a class="copiable-link" href='#index-_002eg'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GNU-troff_002c-identification-register-_0028_002eg_0029"></a>
+<a class="index-entry-id" id="index-GNU_002dspecific-register-_0028_002eg_0029"></a>
+<p>Always true in GNU <code class="code">troff</code> (Boolean-valued).  Documents can use
+this to ask the formatter if it claims <code class="code">groff</code> compatibility.
+</p>
+</dd>
+<dt id='index-_002eP'><span><code class="code">\n.P</code><a class="copiable-link" href='#index-_002eP'> &para;</a></span></dt>
+<dd><p>Output page selection status (Boolean-valued); see <code class="command">groff</code>
+<samp class="option">-o</samp> option (<a class="ref" href="Groff-Options.html">Options</a>).
+</p>
+</dd>
+<dt id='index-number-of-registers-register-_0028_002eR_0029'><span><code class="code">\n.R</code><a class="copiable-link" href='#index-number-of-registers-register-_0028_002eR_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-registers_002c-number-of_002c-register-_0028_002eR_0029"></a>
+<a class="index-entry-id" id="index-_002eR-2"></a>
+<p>Count of available unused registers; always 10,000 in GNU
+<code class="code">troff</code>.<a class="footnote" id="DOCF52" href="groff.html_fot.html#FOOT52"><sup>52</sup></a>
+</p>
+</dd>
+<dt id='index-_002eT-2'><span><code class="code">\n.T</code><a class="copiable-link" href='#index-_002eT-2'> &para;</a></span></dt>
+<dd><p>Indicator of output device selection (Boolean-valued); see
+<code class="command">groff</code> <samp class="option">-T</samp> option (<a class="ref" href="Groff-Options.html">Options</a>).
+</p>
+</dd>
+<dt id='index-safer-mode-2'><span><code class="code">\n.U</code><a class="copiable-link" href='#index-safer-mode-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mode_002c-safer-2"></a>
+<a class="index-entry-id" id="index-unsafe-mode-2"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-2"></a>
+<a class="index-entry-id" id="index-_002eU"></a>
+<p>Unsafe mode enablement status (Boolean-valued); see <code class="command">groff</code>
+<samp class="option">-U</samp> option (<a class="ref" href="Groff-Options.html">Options</a>).
+</p>
+</dd>
+<dt id='index-_002ex'><span><code class="code">\n.x</code><a class="copiable-link" href='#index-_002ex'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-major-version-number-register-_0028_002ex_0029"></a>
+<a class="index-entry-id" id="index-version-number_002c-major_002c-register-_0028_002ex_0029"></a>
+<p>Major version number of the running GNU <code class="code">troff</code> formatter.  For
+example, if the version number is 1.23.0, then <code class="code">.x</code>
+contains&nbsp;&lsquo;<samp class="samp">1</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_002ey'><span><code class="code">\n.y</code><a class="copiable-link" href='#index-_002ey'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-minor-version-number-register-_0028_002ey_0029"></a>
+<a class="index-entry-id" id="index-version-number_002c-minor_002c-register-_0028_002ey_0029"></a>
+<p>Minor version number of the running GNU <code class="code">troff</code> formatter.  For
+example, if the version number is 1.23.0, then <code class="code">.y</code>
+contains&nbsp;&lsquo;<samp class="samp">23</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_002eY'><span><code class="code">\n.Y</code><a class="copiable-link" href='#index-_002eY'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-revision-number-register-_0028_002eY_0029"></a>
+<p>Revision number of the running GNU <code class="code">troff</code> formatter.  For example,
+if the version number is 1.23.0, then <code class="code">.Y</code> contains&nbsp;&lsquo;<samp class="samp">0</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-_0024_0024'><span><code class="code">\n$$</code><a class="copiable-link" href='#index-_0024_0024'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-process-ID-of-GNU-troff-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-PID-of-GNU-troff-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-GNU-troff_002c-process-ID-register-_0028_0024_0024_0029"></a>
+<a class="index-entry-id" id="index-GNU-troff_002c-PID-register-_0028_0024_0024_0029"></a>
+<p>Process identifier (PID) of the GNU <code class="code">troff</code> program in its
+operating environment.
+</p></dd>
+</dl>
+
+<p>Date- and time-related registers are set per the local time as
+determined by <cite class="cite">localtime<span class="r">(3)</span></cite> when the formatter launches.  This
+initialization can be overridden by <code class="env">SOURCE_DATE_EPOCH</code> and
+<code class="env">TZ</code>; see <a class="ref" href="Environment.html">Environment</a>.
+</p>
+<dl class="table">
+<dt id='index-seconds_002c-current-time-_0028seconds_0029'><span><code class="code">\nseconds</code><a class="copiable-link" href='#index-seconds_002c-current-time-_0028seconds_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-seconds-_0028seconds_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-seconds-_0028seconds_0029"></a>
+<a class="index-entry-id" id="index-seconds"></a>
+<p>Count of seconds elapsed in the minute (0&ndash;60). </p>
+</dd>
+<dt id='index-minutes_002c-current-time-_0028minutes_0029'><span><code class="code">\nminutes</code><a class="copiable-link" href='#index-minutes_002c-current-time-_0028minutes_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-minutes-_0028minutes_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-minutes-_0028minutes_0029"></a>
+<a class="index-entry-id" id="index-minutes"></a>
+<p>Count of minutes elapsed in the hour (0&ndash;59).
+</p>
+</dd>
+<dt id='index-hours_002c-current-time-_0028hours_0029'><span><code class="code">\nhours</code><a class="copiable-link" href='#index-hours_002c-current-time-_0028hours_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-time_002c-current_002c-hours-_0028hours_0029"></a>
+<a class="index-entry-id" id="index-current-time_002c-hours-_0028hours_0029"></a>
+<a class="index-entry-id" id="index-hours"></a>
+<p>Count of hours elapsed since midnight (0&ndash;23).
+</p>
+</dd>
+<dt id='index-day-of-the-week-register-_0028dw_0029'><span><code class="code">\ndw</code><a class="copiable-link" href='#index-day-of-the-week-register-_0028dw_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-day-of-the-week-register-_0028dw_0029"></a>
+<a class="index-entry-id" id="index-dw"></a>
+<p>Day of the week (1&ndash;7; 1 is Sunday).
+</p>
+</dd>
+<dt id='index-day-of-the-month-register-_0028dy_0029'><span><code class="code">\ndy</code><a class="copiable-link" href='#index-day-of-the-month-register-_0028dy_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-day-of-the-month-register-_0028dy_0029"></a>
+<a class="index-entry-id" id="index-dy"></a>
+<p>Day of the month (1&ndash;31).
+</p>
+</dd>
+<dt id='index-month-of-the-year-register-_0028mo_0029'><span><code class="code">\nmo</code><a class="copiable-link" href='#index-month-of-the-year-register-_0028mo_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-date_002c-month-of-the-year-register-_0028mo_0029"></a>
+<a class="index-entry-id" id="index-mo"></a>
+<p>Month of the year (1&ndash;12).
+</p>
+</dd>
+<dt id='index-date_002c-year-register-_0028year_002c-yr_0029'><span><code class="code">\nyear</code><a class="copiable-link" href='#index-date_002c-year-register-_0028year_002c-yr_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-year_002c-current_002c-register-_0028year_002c-yr_0029"></a>
+<a class="index-entry-id" id="index-year"></a>
+<p>Gregorian year.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-yr-register"></a>
+</dd>
+<dt id='index-yr'><span><code class="code">\nyr</code><a class="copiable-link" href='#index-yr'> &para;</a></span></dt>
+<dd><p>Gregorian year minus&nbsp;1900.  This register is incorrectly documented
+in the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual as storing the last two digits
+of the current year.  That claim stopped being true in 2000.  Old
+<code class="code">troff</code> input that looks like:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">'\&quot; The year number is a surprise after 1999.
+This document was formatted in 19\n(yr.
+</pre></div></div>
+
+<p>can be corrected to:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This document was formatted in \nyear.
+</pre></div></div>
+
+<p>or, for portability across many <code class="code">roff</code> programs, to the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr y4 1900+\n(yr
+This document was formatted in \n(y4.
+</pre></div></div>
+</dd>
+</dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Assigning-Register-Formats.html">Assigning Register Formats</a>, Up: <a href="Registers.html">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Calling-Macros.html Added

@@ -0,0 +1,164 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Calling Macros (The GNU Troff Manual)</title>
+
+<meta name="description" content="Calling Macros (The GNU Troff Manual)">
+<meta name="keywords" content="Calling Macros (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Formatter-Instructions.html" rel="up" title="Formatter Instructions">
+<link href="Using-Escape-Sequences.html" rel="next" title="Using Escape Sequences">
+<link href="Invoking-Requests.html" rel="prev" title="Invoking Requests">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Calling-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Escape-Sequences.html" accesskey="n" rel="next">Using Escape Sequences</a>, Previous: <a href="Invoking-Requests.html" accesskey="p" rel="prev">Invoking Requests</a>, Up: <a href="Formatter-Instructions.html" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Calling-Macros-1">5.6.3 Calling Macros</h4>
+<a class="index-entry-id" id="index-calling-macros"></a>
+<a class="index-entry-id" id="index-macro-arguments"></a>
+<a class="index-entry-id" id="index-arguments-to-macros"></a>
+
+<p>If a macro of the desired name does not exist when called, it is
+created, assigned an empty definition, and a warning in category
+&lsquo;<samp class="samp">mac</samp>&rsquo; is emitted.  Calling an undefined macro <em class="emph">does</em> end a
+macro definition naming it as its end macro (see <a class="pxref" href="Writing-Macros.html">Writing Macros</a>).
+</p>
+<a class="index-entry-id" id="index-spaces_002c-in-a-macro-argument"></a>
+<p>To embed spaces <em class="emph">within</em> a macro argument, enclose the argument in
+neutral double quotes <code class="code">&quot;</code>.  Horizontal motion escape sequences are
+sometimes a better choice for arguments to be formatted as text.
+</p>
+<p>Consider calls to a hypothetical section heading macro &lsquo;<samp class="samp">uh</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.uh The Mouse Problem
+.uh &quot;The Mouse Problem&quot;
+.uh The\~Mouse\~Problem
+.uh The\ Mouse\ Problem
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_007e_002c-difference-from-_005cSP"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-difference-from-_005c_007e"></a>
+<p>The first line calls <code class="code">uh</code> with three arguments: &lsquo;<samp class="samp">The</samp>&rsquo;,
+&lsquo;<samp class="samp">Mouse</samp>&rsquo;, and &lsquo;<samp class="samp">Problem</samp>&rsquo;.  The remainder call the <code class="code">uh</code>
+macro with one argument, &lsquo;<samp class="samp">The Mouse Problem</samp>&rsquo;.  The last solution,
+using escaped spaces, can be found in documents prepared for
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  It can cause surprise when text is
+adjusted, because <code class="code">\<kbd class="key">SP</kbd></code> inserts a <em class="emph">fixed-width</em>,
+non-breaking space.  GNU <code class="code">troff</code>&rsquo;s <code class="code">\~</code> escape sequence
+inserts an adjustable, non-breaking space.<a class="footnote" id="DOCF44" href="groff.html_fot.html#FOOT44"><sup>44</sup></a>
+</p>
+<a class="index-entry-id" id="index-_0022_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-double-quote_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-_005c_002c-embedding-in-a-macro-argument"></a>
+<a class="index-entry-id" id="index-backslash_002c-embedding-in-a-macro-argument"></a>
+<p>The foregoing raises the question of how to embed neutral double quotes
+or backslashes in macro arguments when <em class="emph">those</em> characters are
+desired as literals.  In GNU <code class="code">troff</code>, the special character escape
+sequence <code class="code">\rs</code> produces a backslash and <code class="code">\dq</code> a neutral
+double quote.
+</p>
+<p>In GNU <code class="code">troff</code>&rsquo;s <abbr class="acronym">AT&amp;T</abbr> compatibility mode, these
+characters remain available as <code class="code">\(rs</code> and <code class="code">\(dq</code>,
+respectively.  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> did not consistently define
+these special characters,
+but its descendants can be made to support them.  See <a class="xref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.
+</p>
+<p>If even that is not feasible, options remain.  To obtain a literal
+escape character in a macro argument, you can simply type it if you
+change or disable the escape character first.  See <a class="xref" href="Using-Escape-Sequences.html">Using Escape Sequences</a>.  Otherwise, you must escape the escape character repeatedly
+to a context-dependent extent.  See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.
+</p>
+<p>For the (neutral) double quote, you have recourse to an obscure
+syntactical feature of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  Because a double
+quote can begin a macro argument, the formatter keeps track of whether
+the current argument was started thus, and doesn&rsquo;t require a space after
+the double quote that ends it.<a class="footnote" id="DOCF45" href="groff.html_fot.html#FOOT45"><sup>45</sup></a>  In
+the argument list to a macro, a double quote that <em class="emph">isn&rsquo;t</em> preceded
+by a space <em class="emph">doesn&rsquo;t</em> start a macro argument.  If not preceded by a
+double quote that began an argument, this double quote becomes part of
+the argument.  Furthermore, within a quoted argument, a pair of adjacent
+double quotes becomes a literal double quote.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+.. \&quot; 4 backslashes on the next line
+.eq a&quot; &quot;b c&quot; &quot;de&quot;f\\\\g&quot; h&quot;&quot;i &quot;j&quot;&quot;k&quot;
+    error&rarr; arg1:a&quot; arg2:b c arg3:de
+    error&rarr; arg4:f\g&quot; arg5:h&quot;&quot;i arg6:j&quot;k
+</pre></div></div>
+
+<p>Apart from the complexity of the rules, this traditional solution has
+the disadvantage that double quotes don&rsquo;t survive repeated argument
+expansion in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> or GNU <code class="code">troff</code>&rsquo;s
+compatibility mode.  This can frustrate efforts to pass such arguments
+intact through multiple macro calls.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1
+.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+..
+.de xe
+.  eq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6
+.. \&quot; 8 backslashes on the next line
+.xe a&quot; &quot;b c&quot; &quot;de&quot;f\\\\\\\\g&quot; h&quot;&quot;i &quot;j&quot;&quot;k&quot;
+    error&rarr; arg1:a&quot; arg2:b arg3:c
+    error&rarr; arg4:de arg5:f\g&quot; arg6:h&quot;&quot;i
+</pre></div></div>
+
+<a class="index-entry-id" id="index-input-level"></a>
+<a class="index-entry-id" id="index-level_002c-input"></a>
+<a class="index-entry-id" id="index-interpolation-depth"></a>
+<a class="index-entry-id" id="index-depth_002c-interpolation"></a>
+<p>Outside of compatibility mode, GNU <code class="code">troff</code> doesn&rsquo;t exhibit this
+problem because it tracks the nesting depth of interpolations.
+See <a class="xref" href="Implementation-Differences.html">Implementation Differences</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Escape-Sequences.html">Using Escape Sequences</a>, Previous: <a href="Invoking-Requests.html">Invoking Requests</a>, Up: <a href="Formatter-Instructions.html">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Changing-the-Type-Size.html Added

@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Changing the Type Size (The GNU Troff Manual)</title>
+
+<meta name="description" content="Changing the Type Size (The GNU Troff Manual)">
+<meta name="keywords" content="Changing the Type Size (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="up" title="Manipulating Type Size and Vertical Spacing">
+<link href="Changing-the-Vertical-Spacing.html" rel="next" title="Changing the Vertical Spacing">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="prev" title="Manipulating Type Size and Vertical Spacing">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Changing-the-Type-Size">
+<div class="nav-panel">
+<p>
+Next: <a href="Changing-the-Vertical-Spacing.html" accesskey="n" rel="next">Changing the Vertical Spacing</a>, Previous: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="p" rel="prev">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Changing-the-Type-Size-1">5.20.1 Changing the Type Size</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eps"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ps"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eps-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002eps-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ps</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">size</i></span></var><a class="copiable-link" href='#index-_002eps-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cssize"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\s</code><span class="r"><i class="slanted">size</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cssize'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002es_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.s</code></strong><a class="copiable-link" href='#index-_005cn_005b_002es_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002es"></a>
+<a class="index-entry-id" id="index-changing-type-sizes-_0028ps_002c-_005cs_0029"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-changing-_0028ps_002c-_005cs_0029"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-changing-_0028ps_002c-_005cs_0029"></a>
+<p>Use the <code class="code">ps</code> request or the <code class="code">\s</code> escape sequence to change
+(increase, decrease) the type size (in scaled points).  Specify
+<var class="var">size</var> as either an absolute type size, or as a relative change from
+the current size.  <code class="code">ps</code> with no argument restores the previous
+size.  The <code class="code">ps</code> request&rsquo;s default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;.  The
+requested size is rounded to the nearest valid size (with ties rounding
+down) within the limits supported by the device.  If the requested size
+is non-positive, it is treated as 1<span class="dmn">u</span>.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-4"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-ps-request"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-_005cs-escape-sequence"></a>
+<p>Type size alteration is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual, which claims &ldquo;if the requested size is invalid,
+the next larger valid size will result, with a maximum of
+36&rdquo;.<a class="footnote" id="DOCF84" href="groff.html_fot.html#FOOT84"><sup>84</sup></a>
+</p>
+<a class="index-entry-id" id="index-type-size-registers-_0028_002es_002c-_002eps_0029"></a>
+<a class="index-entry-id" id="index-point-size-registers-_0028_002es_002c-_002eps_0029"></a>
+<p>The read-only string-valued register <code class="code">.s</code> interpolates the type
+size in points as a decimal fraction; it is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).  To obtain the type size in scaled
+points, interpolate the <code class="code">.ps</code> register instead (see <a class="pxref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>).
+</p>
+<p>The <code class="code">\s</code> escape sequence supports a variety of syntax forms.
+</p>
+<dl class="table">
+<dt><code class="code">\s<var class="var">n</var></code></dt>
+<dd><p>Set the type size to <var class="var">n</var>&nbsp;points.  <var class="var">n</var>&nbsp;must be a single
+digit.  If <var class="var">n</var>&nbsp;is 0, restore the previous size.
+</p>
+</dd>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dd><p>Increase or decrease the type size by <var class="var">n</var>&nbsp;points.
+<var class="var">n</var>&nbsp;must be exactly one digit.
+</p>
+</dd>
+<dt><code class="code">\s(<var class="var">nn</var></code></dt>
+<dd><p>Set the type size to <var class="var">nn</var>&nbsp;points.  <var class="var">nn</var> must be exactly two
+digits.
+</p>
+</dd>
+<dt><code class="code">\s+(<var class="var">nn</var></code></dt>
+<dt><code class="code">\s-(<var class="var">nn</var></code></dt>
+<dt><code class="code">\s(+<var class="var">nn</var></code></dt>
+<dt><code class="code">\s(-<var class="var">nn</var></code></dt>
+<dd><p>Alter the type size in points by the two-digit value <var class="var">nn</var>.
+</p></dd>
+</dl>
+
+<p>See <a class="xref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>, for further syntactical forms of the
+<code class="code">\s</code> escape sequence that additionally accept decimal fractions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">snap, snap,
+.ps +2
+grin, grin,
+.ps +2
+wink, wink, \s+2nudge, nudge,\s+8 say no more!
+.ps 10
+</pre></div></div>
+</dd></dl>
+
+<p>The <code class="code">\s</code> escape sequence affects the environment immediately and
+doesn&rsquo;t produce an input token.  Consequently, it can be used in
+requests like <code class="code">mc</code>, which expects a single character as an
+argument, to change the type size on the fly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \s20x\s0
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esizes"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sizes</code></strong> <var class="def-var-arguments">s1 s2 &hellip; sn <code class="t">0</code></var><a class="copiable-link" href='#index-_002esizes'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sizes-1"></a>
+<p>The <samp class="file">DESC</samp> file specifies which type sizes are allowed by the
+output device; see <a class="ref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>.  Use the <code class="code">sizes</code> request
+to change this set of permissible sizes.  Arguments are in scaled
+points; see <a class="ref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>.  Each can be a single
+type size (such as &lsquo;<samp class="samp">12000</samp>&rsquo;), or a range of sizes (such as
+&lsquo;<samp class="samp">4000-72000</samp>&rsquo;).  You can optionally end the list with a &lsquo;<samp class="samp">0</samp>&rsquo;.
+</p></dd></dl>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a>, Previous: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Changing-the-Vertical-Spacing.html Added

@@ -0,0 +1,146 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Changing the Vertical Spacing (The GNU Troff Manual)</title>
+
+<meta name="description" content="Changing the Vertical Spacing (The GNU Troff Manual)">
+<meta name="keywords" content="Changing the Vertical Spacing (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="up" title="Manipulating Type Size and Vertical Spacing">
+<link href="Using-Fractional-Type-Sizes.html" rel="next" title="Using Fractional Type Sizes">
+<link href="Changing-the-Type-Size.html" rel="prev" title="Changing the Type Size">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Changing-the-Vertical-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Fractional-Type-Sizes.html" accesskey="n" rel="next">Using Fractional Type Sizes</a>, Previous: <a href="Changing-the-Type-Size.html" accesskey="p" rel="prev">Changing the Type Size</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Changing-the-Vertical-Spacing-1">5.20.2 Changing the Vertical Spacing</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002evs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002evs-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002evs-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vs</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002evs-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ev_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.v</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ev_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ev"></a>
+<a class="index-entry-id" id="index-changing-vertical-line-spacing-_0028vs_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-spacing_002c-changing-_0028vs_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-spacing-register-_0028_002ev_0029"></a>
+<p>Set the vertical spacing to, or alter it by, <var class="var">space</var>.  The default
+scaling unit is &lsquo;<samp class="samp">p</samp>&rsquo;.  If <code class="code">vs</code> is called without an argument,
+the vertical spacing is reset to the previous value before the last call
+to <code class="code">vs</code>.
+<a class="index-entry-id" id="index-_002eV-register_002c-and-vs"></a>
+GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; if <var class="var">space</var>
+is negative; the vertical spacing is then set to the smallest possible
+positive value, the vertical motion quantum (as found in the <code class="code">.V</code>
+register).
+</p>
+<p>&lsquo;<samp class="samp">.vs&nbsp;0</samp>&rsquo; isn&rsquo;t saved in a diversion since it doesn&rsquo;t result in
+a vertical motion.  You must explicitly issue this request before
+interpolating the diversion.
+</p>
+<p>The read-only register <code class="code">.v</code> contains the vertical spacing; it is
+associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-vertical-line-spacing_002c-effective-value"></a>
+<p>When a break occurs, GNU <code class="code">troff</code> performs the following procedure.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-extra-pre_002dvertical-line-space-_0028_005cx_0029"></a>
+<a class="index-entry-id" id="index-line-space_002c-extra-pre_002dvertical-_0028_005cx_0029"></a>
+Move the drawing position vertically by the <em class="dfn">extra pre-vertical line
+space</em>, the minimum of all negative <code class="code">\x</code> escape sequence arguments
+in the pending output line.
+
+</li><li>Move the drawing position vertically by the vertical line spacing.
+
+</li><li>Write out the pending output line.
+
+</li><li><a class="index-entry-id" id="index-extra-post_002dvertical-line-space-_0028_005cx_0029"></a>
+<a class="index-entry-id" id="index-line-space_002c-extra-post_002dvertical-_0028_005cx_0029"></a>
+Move the drawing position vertically by the <em class="dfn">extra post-vertical line
+space</em>, the maximum of all positive <code class="code">\x</code> escape sequence arguments
+in the line that has just been output.
+
+</li><li><a class="index-entry-id" id="index-post_002dvertical-line-spacing"></a>
+<a class="index-entry-id" id="index-line-spacing_002c-post_002dvertical-_0028pvs_0029"></a>
+Move the drawing position vertically by the <em class="dfn">post-vertical line
+spacing</em> (see below).
+</li></ul>
+
+<a class="index-entry-id" id="index-double_002dspacing-_0028vs_002c-pvs_0029"></a>
+<p>Prefer <code class="code">vs</code> or <code class="code">pvs</code> over <code class="code">ls</code> to produce double-spaced
+documents.  <code class="code">vs</code> and <code class="code">pvs</code> have finer granularity than
+<code class="code">ls</code>; moreover, some preprocessors assume single spacing.
+See <a class="xref" href="Manipulating-Spacing.html">Manipulating Spacing</a>, regarding the <code class="code">\x</code> escape sequence and
+the <code class="code">ls</code> request.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epvs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pvs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epvs-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epvs-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pvs</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002epvs-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002epvs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pvs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epvs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epvs-3"></a>
+<a class="index-entry-id" id="index-ls-request_002c-alternative-to-_0028pvs_0029"></a>
+<a class="index-entry-id" id="index-post_002dvertical-line-spacing_002c-changing-_0028pvs_0029"></a>
+<a class="index-entry-id" id="index-post_002dvertical-line-spacing-register-_0028_002epvs_0029"></a>
+<p>Set the post-vertical spacing to, or alter it by, <var class="var">space</var>.  The
+default scaling unit is &lsquo;<samp class="samp">p</samp>&rsquo;.  If <code class="code">pvs</code> is called without an
+argument, the post-vertical spacing is reset to the previous value
+before the last call to <code class="code">pvs</code>.  GNU <code class="code">troff</code> emits a warning in
+category &lsquo;<samp class="samp">range</samp>&rsquo; if <var class="var">space</var> is negative; the post-vertical
+spacing is then set to zero.
+</p>
+<p>The read-only register <code class="code">.pvs</code> contains the post-vertical spacing;
+it is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>, Previous: <a href="Changing-the-Type-Size.html">Changing the Type Size</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Character-Classes.html Added

@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Character Classes (The GNU Troff Manual)</title>
+
+<meta name="description" content="Character Classes (The GNU Troff Manual)">
+<meta name="keywords" content="Character Classes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Special-Fonts.html" rel="next" title="Special Fonts">
+<link href="Using-Symbols.html" rel="prev" title="Using Symbols">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Character-Classes">
+<div class="nav-panel">
+<p>
+Next: <a href="Special-Fonts.html" accesskey="n" rel="next">Special Fonts</a>, Previous: <a href="Using-Symbols.html" accesskey="p" rel="prev">Using Symbols</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Character-Classes-1">5.19.5 Character Classes</h4>
+<a class="index-entry-id" id="index-character-classes"></a>
+<a class="index-entry-id" id="index-classes_002c-character"></a>
+
+<p>Classes are particularly useful for East Asian languages such as
+Chinese, Japanese, and Korean, where the number of needed characters is
+much larger than in European languages, and where large sets of
+characters share the same properties.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eclass"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.class</code></strong> <var class="def-var-arguments">name c1 c2 &hellip;</var><a class="copiable-link" href='#index-_002eclass'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-class"></a>
+<a class="index-entry-id" id="index-character-class-_0028class_0029"></a>
+<a class="index-entry-id" id="index-defining-character-class-_0028class_0029"></a>
+<a class="index-entry-id" id="index-class-of-characters-_0028class_0029"></a>
+<p>Define a character class (or simply &ldquo;class&rdquo;) <var class="var">name</var> comprising
+the characters <var class="var">c1</var>, <var class="var">c2</var>, and so on.
+</p>
+<p>A class thus defined can then be referred to in lieu of listing all the
+characters within it.  Currently, only the <code class="code">cflags</code> request can
+handle references to character classes.
+</p>
+<p>In the request&rsquo;s simplest form, each <var class="var">cn</var> is a character (or special
+character).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.class quotes ' \aq \dq \oq \cq \lq \rq
+</pre></div></div>
+
+<p>Since class and glyph names share the same name space, it is recommended
+to start and end the class name with <code class="code"></code> and <code class="code"></code>,
+respectively, to avoid collisions with existing character names defined
+by GNU <code class="code">troff</code> or the user (with <code class="code">char</code> and related requests).
+This practice applies the presence of <code class="code"></code> in the class name to
+prevent the use of the special character escape form
+<code class="code">\<span class="r">&hellip;</span></code>, thus you must use the <code class="code">\C</code> escape to access
+a class with such a name.
+</p>
+<a class="index-entry-id" id="index-GGL-_0028groff-glyph-list_0029-1"></a>
+<a class="index-entry-id" id="index-groff-glyph-list-_0028GGL_0029-1"></a>
+<p>You can also use a character range notation consisting of a
+start character followed by &lsquo;<samp class="samp">-</samp>&rsquo; and then an end character.
+Internally, GNU <code class="code">troff</code> converts these two symbol names to
+Unicode code points (according to the <code class="code">groff</code> glyph list GGL),
+which then give the start and end value of the range.  If that fails,
+the class definition is skipped.
+</p>
+<p>Furthermore, classes can be nested.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.class prepunct , : ; &gt; }
+.class prepunctx \C'prepunct' \u2013-\u2016
+</pre></div></div>
+
+<p>The class &lsquo;<samp class="samp">prepunctx</samp>&rsquo; thus contains the contents of the class
+<code class="code">prepunct</code> as defined above (the set &lsquo;<samp class="samp">, : ; &gt; }</samp>&rsquo;), and
+characters in the range between <code class="code">U+2013</code> and <code class="code">U+2016</code>.
+</p>
+<p>If you want to include &lsquo;<samp class="samp">-</samp>&rsquo; in a class, it must be the first
+character value in the argument list, otherwise it gets misinterpreted
+as part of the range syntax.
+</p>
+<p>It is not possible to use class names as end points of range
+definitions.
+</p>
+<p>A typical use of the <code class="code">class</code> request is to control line-breaking
+and hyphenation rules as defined by the <code class="code">cflags</code> request.  For
+example, to inhibit line breaks before the characters belonging to the
+<code class="code">prepunctx</code> class defined in the previous example, you can write
+the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cflags 2 \C'prepunctx'
+</pre></div></div>
+
+<p>See the <code class="code">cflags</code> request in <a class="ref" href="Using-Symbols.html">Using Symbols</a>, for more details.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Special-Fonts.html">Special Fonts</a>, Previous: <a href="Using-Symbols.html">Using Symbols</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Character-Translations.html Added

@@ -0,0 +1,200 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Character Translations (The GNU Troff Manual)</title>
+
+<meta name="description" content="Character Translations (The GNU Troff Manual)">
+<meta name="keywords" content="Character Translations (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="troff-and-nroff-Modes.html" rel="next" title="troff and nroff Modes">
+<link href="Tabs-and-Fields.html" rel="prev" title="Tabs and Fields">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Character-Translations">
+<div class="nav-panel">
+<p>
+Next: <a href="troff-and-nroff-Modes.html" accesskey="n" rel="next"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Previous: <a href="Tabs-and-Fields.html" accesskey="p" rel="prev">Tabs and Fields</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Character-Translations-1">5.13 Character Translations</h3>
+<a class="index-entry-id" id="index-character-translations"></a>
+<a class="index-entry-id" id="index-translations-of-characters"></a>
+
+<p>A <em class="dfn">translation</em> is a mapping of an input character to an output
+glyph.  The mapping occurs at output time, i.e., the input character
+gets assigned the metric information of the mapped output character
+right before input tokens are converted to nodes (see <a class="pxref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>, for more on this process).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tr</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etrin"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trin</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etrin'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trin"></a>
+<p>Translate character <var class="var">a</var> to glyph&nbsp;<var class="var">b</var>, character <var class="var">c</var> to
+glyph&nbsp;<var class="var">d</var>, and so on.  If there is an odd number of characters
+in the argument, the last one is translated to a fixed-width space (the
+same one obtained by the <code class="code">\<kbd class="key">SP</kbd></code> escape sequence).
+</p>
+<p>The <code class="code">trin</code> request is identical to <code class="code">tr</code>, but when you unformat
+a diversion with <code class="code">asciify</code> it ignores the translation.
+See <a class="xref" href="Diversions.html">Diversions</a>, for details about the <code class="code">asciify</code> request.
+</p>
+<p>Some notes:
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-_005c_0028_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_005b_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005cC_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005cN_002c-and-translations"></a>
+<a class="index-entry-id" id="index-char-request_002c-and-translations"></a>
+<a class="index-entry-id" id="index-special-characters-1"></a>
+<a class="index-entry-id" id="index-character_002c-special"></a>
+<a class="index-entry-id" id="index-numbered-glyph-_0028_005cN_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-numbered-_0028_005cN_0029"></a>
+Special characters (<code class="code">\(<var class="var">xx</var></code>, <code class="code">\<var class="var">xxx</var></code>,
+<code class="code">\C'<var class="var">xxx</var>'</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>),
+glyphs defined with the <code class="code">char</code> request, and numbered glyphs
+(<code class="code">\N'<var class="var">xxx</var>'</code>) can be translated also.
+
+</li><li><a class="index-entry-id" id="index-_005ce_002c-and-translations"></a>
+The <code class="code">\e</code> escape can be translated also.
+
+</li><li><a class="index-entry-id" id="index-_005c_0025_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005c_007e_002c-and-translations"></a>
+Characters can be mapped onto the <code class="code">\%</code> and <code class="code">\~</code> escape
+sequences (but <code class="code">\%</code> and <code class="code">\~</code> can&rsquo;t be mapped onto another
+glyph).
+
+</li><li><a class="index-entry-id" id="index-backspace-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-backspace_002c-and-translations"></a>
+<a class="index-entry-id" id="index-leader-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-leader_002c-and-translations"></a>
+<a class="index-entry-id" id="index-newline-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-newline_002c-and-translations"></a>
+<a class="index-entry-id" id="index-tab-character_002c-and-translations"></a>
+<a class="index-entry-id" id="index-character_002c-tab_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005ca_002c-and-translations"></a>
+<a class="index-entry-id" id="index-_005ct_002c-and-translations"></a>
+The following characters can&rsquo;t be translated: space (with one exception,
+see below), backspace, newline, leader (and <code class="code">\a</code>), tab (and
+<code class="code">\t</code>).
+
+</li><li><a class="index-entry-id" id="index-shc-request_002c-and-translations"></a>
+Translations are not considered for finding the soft hyphen character
+set with the <code class="code">shc</code> request.
+
+</li><li><a class="index-entry-id" id="index-_005c_0026_002c-and-translations"></a>
+The pair &lsquo;<samp class="samp"><var class="var">c</var>\&amp;</samp>&rsquo; (an arbitrary character&nbsp;<var class="var">c</var> followed
+by the dummy character) maps this character to &ldquo;nothing&rdquo;.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr a\&amp;
+foo bar
+    &rArr; foo br
+</pre></div></div>
+
+<p>Even the space character can be mapped to the dummy character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr aa \&amp;
+foo bar
+    &rArr; foobar
+</pre></div></div>
+
+<p>As shown in the example, the space character can&rsquo;t be the first
+character/glyph pair as an argument of <code class="code">tr</code>.  Additionally, it is
+not possible to map the space character to any other glyph; requests
+like &lsquo;<samp class="samp">.tr&nbsp;aa&nbsp;x</samp>&rsquo; undo &lsquo;<samp class="samp">.tr&nbsp;aa&nbsp;\&amp;</samp>&rsquo; instead.
+</p>
+<p>If justification is active, lines are justified in spite of the &lsquo;empty&rsquo;
+space character (but there is no minimal distance, i.e., the space
+character, between words).
+</p>
+</li><li>After an output glyph has been constructed (this happens at the moment
+immediately before the glyph is appended to an output glyph list, either
+by direct output, in a macro, diversion, or string), it is no longer
+affected by <code class="code">tr</code>.
+
+</li><li>Translating character to glyphs where one of them or both are undefined
+is possible also; <code class="code">tr</code> does not check whether the elements of its
+argument exist.
+
+<p>See <a class="xref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>.
+</p>
+</li><li>Without an argument, the <code class="code">tr</code> request is ignored.
+</li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etrnt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trnt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">a</i></span><span class="r"><i class="slanted">b</i></span><span class="r"><i class="slanted">c</i></span><span class="r"><i class="slanted">d</i></span>&hellip;</var><a class="copiable-link" href='#index-_002etrnt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trnt"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-and-trnt"></a>
+<p><code class="code">trnt</code> is the same as the <code class="code">tr</code> request except that the
+translations do not apply to text that is transparently throughput into
+a diversion with <code class="code">\!</code>.  See <a class="xref" href="Diversions.html">Diversions</a>.
+</p>
+<p>For example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr ab
+.di x
+\!.tm a
+.di
+.x
+</pre></div></div>
+
+<p>prints &lsquo;<samp class="samp">b</samp>&rsquo; to the standard error stream; if <code class="code">trnt</code> is used
+instead of <code class="code">tr</code> it prints &lsquo;<samp class="samp">a</samp>&rsquo;.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Previous: <a href="Tabs-and-Fields.html">Tabs and Fields</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Colors.html Added

@@ -0,0 +1,208 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Colors (The GNU Troff Manual)</title>
+
+<meta name="description" content="Colors (The GNU Troff Manual)">
+<meta name="keywords" content="Colors (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Strings.html" rel="next" title="Strings">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="prev" title="Manipulating Type Size and Vertical Spacing">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Colors">
+<div class="nav-panel">
+<p>
+Next: <a href="Strings.html" accesskey="n" rel="next">Strings</a>, Previous: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="p" rel="prev">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Colors-1">5.21 Colors</h3>
+<a class="index-entry-id" id="index-colors"></a>
+
+<a class="index-entry-id" id="index-stroke-color"></a>
+<a class="index-entry-id" id="index-color_002c-stroke"></a>
+<a class="index-entry-id" id="index-fill-color"></a>
+<a class="index-entry-id" id="index-color_002c-fill"></a>
+<p>GNU <code class="code">troff</code> supports color output with a variety of color spaces
+and up to 16 bits per channel.  Some devices, particularly terminals,
+may be more limited.  When color support is enabled, two colors are
+current at any given time: the <em class="dfn">stroke color</em>, with which glyphs,
+rules (lines), and geometric objects like circles and polygons are
+drawn, and the <em class="dfn">fill color</em>, which can be used to paint the interior
+of a closed geometric figure.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.color</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ecolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-color"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecolor_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.color</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecolor_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecolor-1"></a>
+<p>If <var class="var">n</var> is missing or non-zero, enable the output of color-related
+device-independent output commands (this is the default); otherwise,
+disable them.  This request sets a global flag; it does not produce an
+input token (see <a class="pxref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>).
+</p>
+<p>The read-only register <code class="code">.color</code> is&nbsp;1 if colors are enabled,
+0&nbsp;otherwise.
+</p>
+<p>Color can also be disabled with the <samp class="option">-c</samp> command-line option.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edefcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.defcolor</code></strong> <var class="def-var-arguments">ident scheme color-component &hellip;</var><a class="copiable-link" href='#index-_002edefcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-defcolor"></a>
+<p>Define a color named <var class="var">ident</var>.  <var class="var">scheme</var> selects a color space
+and determines the quantity of required <var class="var">color-component</var>s; it must
+be one of &lsquo;<samp class="samp">rgb</samp>&rsquo; (three components), &lsquo;<samp class="samp">cmy</samp>&rsquo; (three), &lsquo;<samp class="samp">cmyk</samp>&rsquo;
+(four), or &lsquo;<samp class="samp">gray</samp>&rsquo; (one).  &lsquo;<samp class="samp">grey</samp>&rsquo; is accepted as a synonym of
+&lsquo;<samp class="samp">gray</samp>&rsquo;.  The color components can be encoded as a single
+hexadecimal value starting with &lsquo;<samp class="samp">#</samp>&rsquo; or &lsquo;<samp class="samp">##</samp>&rsquo;.  The former
+indicates that each component is in the range 0&ndash;255 (0&ndash;FF), the latter
+the range 0&ndash;65,535 (0&ndash;FFFF).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.defcolor half gray #7f
+.defcolor pink rgb #FFC0CB
+.defcolor magenta rgb  ##ffff0000ffff
+</pre></div></div>
+
+<a class="index-entry-id" id="index-f-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-f"></a>
+<a class="index-entry-id" id="index-scaling-unit-f"></a>
+<p>Alternatively, each color component can be specified as a decimal
+fraction in the range 0&ndash;1, interpreted using a default scaling
+unit of&nbsp;<code class="code">f</code>, which multiplies its value by 65,536 (but
+clamps it at 65,535).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.defcolor gray50 rgb 0.5 0.5 0.5
+.defcolor darkgreen rgb 0.1f 0.5f 0.2f
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-default-color"></a>
+<a class="index-entry-id" id="index-color_002c-default"></a>
+<p>Each output device has a color named &lsquo;<samp class="samp">default</samp>&rsquo;, which cannot be
+redefined.  A device&rsquo;s default stroke and fill colors are not
+necessarily the same.  For the <code class="code">dvi</code>, <code class="code">html</code>, <code class="code">pdf</code>,
+<code class="code">ps</code>, and <code class="code">xhtml</code> output devices, GNU <code class="code">troff</code>
+automatically loads a macro file defining many color names at startup.
+By the same mechanism, the devices supported by <code class="code">grotty</code> recognize
+the eight standard ISO&nbsp;6429/EMCA-48 color names.<a class="footnote" id="DOCF86" href="groff.html_fot.html#FOOT86"><sup>86</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002egcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.gcolor</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">color</i></span></var><a class="copiable-link" href='#index-_002egcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-gcolor"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cmc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cmc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cm_0028co"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m(</code><span class="r"><i class="slanted">co</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cm_0028co'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cm_005bcolor_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\m</code><span class="r"><i class="slanted">color</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cm_005bcolor_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002em_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.m</code></strong><a class="copiable-link" href='#index-_005cn_005b_002em_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002em"></a>
+<p>Set the stroke color to <var class="var">color</var>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.gcolor red
+The next words
+.gcolor
+\mredare in red\m
+and these words are in the previous color.
+</pre></div></div>
+
+<p>The escape sequence <code class="code">\m</code> restores the previous stroke color, as
+does a <code class="code">gcolor</code> request without an argument.
+</p>
+<a class="index-entry-id" id="index-stroke-color-name-register-_0028_002em_0029"></a>
+<a class="index-entry-id" id="index-name_002c-stroke-color_002c-register-_0028_002em_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-stroke_002c-register-_0028_002em_0029"></a>
+<p>The name of the current stroke color is available in the read-only
+string-valued register &lsquo;<samp class="samp">.m</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).  It interpolates nothing when the stroke color
+is the default.
+</p>
+<p><code class="code">\m</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>
+(see <a class="pxref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>).  It therefore can be used in requests like
+<code class="code">mc</code> (which expects a single character as an argument) to change
+the color on the fly:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \mredx\m
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efcolor"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fcolor</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">color</i></span></var><a class="copiable-link" href='#index-_002efcolor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fcolor"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cMc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cMc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cM"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cM_0028co"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M(</code><span class="r"><i class="slanted">co</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cM_0028co'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cM_005bcolor_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\M</code><span class="r"><i class="slanted">color</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cM_005bcolor_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.M</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eM"></a>
+<p>Set the fill color for objects drawn with <code class="code">\D'&hellip;'</code> escape
+sequences.  The escape sequence <code class="code">\M</code> restores the previous fill
+color, as does an <code class="code">fcolor</code> request without an argument.
+</p>
+<a class="index-entry-id" id="index-background-color-name-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-name_002c-background-color_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-background_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-fill-color-name-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-name_002c-fill-color_002c-register-_0028_002eM_0029"></a>
+<a class="index-entry-id" id="index-color-name_002c-fill_002c-register-_0028_002eM_0029"></a>
+<p>The name of the current fill color is available in the read-only
+string-valued register &lsquo;<samp class="samp">.M</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).  It interpolates nothing when the fill color
+is the default.  <code class="code">\M</code> doesn&rsquo;t produce an input token in GNU
+<code class="code">troff</code>.
+</p>
+<p>Create an ellipse with a red interior as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\Mred\h'0.5i'\D'E 2i 1i'\M
+</pre></div></div>
+</dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Strings.html">Strings</a>, Previous: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Columnation.html Added

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Columnation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Columnation (The GNU Troff Manual)">
+<meta name="keywords" content="Columnation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Font-and-Size-Changes.html" rel="next" title="Font and Size Changes">
+<link href="Document-Formats.html" rel="prev" title="Document Formats">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Columnation">
+<div class="nav-panel">
+<p>
+Next: <a href="Font-and-Size-Changes.html" accesskey="n" rel="next">Font and Size Changes</a>, Previous: <a href="Document-Formats.html" accesskey="p" rel="prev">Document Formats</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Columnation-1">3.2.10 Columnation</h4>
+
+<p>Macro packages apart from <samp class="file">man</samp> and <samp class="file">mdoc</samp> for man page
+formatting offer a facility for setting multiple columns on the page.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Command-Reference.html Added

@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Command Reference (The GNU Troff Manual)</title>
+
+<meta name="description" content="Command Reference (The GNU Troff Manual)">
+<meta name="keywords" content="Command Reference (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="gtroff-Output.html" rel="up" title="gtroff Output">
+<link href="Intermediate-Output-Examples.html" rel="next" title="Intermediate Output Examples">
+<link href="Language-Concepts.html" rel="prev" title="Language Concepts">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Command-Reference">
+<div class="nav-panel">
+<p>
+Next: <a href="Intermediate-Output-Examples.html" accesskey="n" rel="next">Intermediate Output Examples</a>, Previous: <a href="Language-Concepts.html" accesskey="p" rel="prev">Language Concepts</a>, Up: <a href="gtroff-Output.html" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Command-Reference-1">6.1.2 Command Reference</h4>
+
+<p>This section describes all intermediate output commands, both from
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> as well as the <code class="code">gtroff</code> extensions.
+</p>
+
+<ul class="mini-toc">
+<li><a href="Comment-Command.html" accesskey="1">Comment Command</a></li>
+<li><a href="Simple-Commands.html" accesskey="2">Simple Commands</a></li>
+<li><a href="Graphics-Commands.html" accesskey="3">Graphics Commands</a></li>
+<li><a href="Device-Control-Commands.html" accesskey="4">Device Control Commands</a></li>
+<li><a href="Obsolete-Command.html" accesskey="5">Obsolete Command</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Comment-Command.html Added

@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Comment Command (The GNU Troff Manual)</title>
+
+<meta name="description" content="Comment Command (The GNU Troff Manual)">
+<meta name="keywords" content="Comment Command (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Command-Reference.html" rel="up" title="Command Reference">
+<link href="Simple-Commands.html" rel="next" title="Simple Commands">
+<link href="Command-Reference.html" rel="prev" title="Command Reference">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Comment-Command">
+<div class="nav-panel">
+<p>
+Next: <a href="Simple-Commands.html" accesskey="n" rel="next">Simple Commands</a>, Previous: <a href="Command-Reference.html" accesskey="p" rel="prev">Command Reference</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Comment-Command-1">6.1.2.1 Comment Command</h4>
+
+<dl class="table">
+<dt><code class="code">#<var class="var">anything</var>&lsaquo;<span class="r">end of line</span>&rsaquo;</code></dt>
+<dd><p>A comment.  Ignore any characters from the &lsquo;<samp class="samp">#</samp>&rsquo; character up to the
+next newline character.
+</p>
+<p>This command is the only possibility for commenting in the intermediate
+output.  Each comment can be preceded by arbitrary syntactical space;
+every command can be terminated by a comment.
+</p></dd>
+</dl>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Comments.html Added

@@ -0,0 +1,157 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Comments (The GNU Troff Manual)</title>
+
+<meta name="description" content="Comments (The GNU Troff Manual)">
+<meta name="keywords" content="Comments (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Registers.html" rel="next" title="Registers">
+<link href="Formatter-Instructions.html" rel="prev" title="Formatter Instructions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Comments">
+<div class="nav-panel">
+<p>
+Next: <a href="Registers.html" accesskey="n" rel="next">Registers</a>, Previous: <a href="Formatter-Instructions.html" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Comments-1">5.7 Comments</h3>
+<a class="index-entry-id" id="index-comments"></a>
+
+<p>One of the most common forms of escape sequence is the
+comment.<a class="footnote" id="DOCF48" href="groff.html_fot.html#FOOT48"><sup>48</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0022-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\&quot;</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0022-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0022"></a>
+<p>Start a comment.  Everything up to the next newline is ignored.
+</p>
+<p>This may sound simple, but it can be tricky to keep the comments from
+interfering with the appearance of the output.
+<a class="index-entry-id" id="index-ds_002c-ds1-requests_002c-and-comments"></a>
+<a class="index-entry-id" id="index-as_002c-as1-requests_002c-and-comments"></a>
+If the escape sequence is to the right of some text or a request, that
+portion of the line is ignored, but spaces preceding it are processed
+normally by GNU <code class="code">troff</code>.  This affects only the <code class="code">ds</code> and
+<code class="code">as</code> requests and their variants.
+</p>
+<a class="index-entry-id" id="index-tabs_002c-before-comments"></a>
+<a class="index-entry-id" id="index-comments_002c-lining-up-with-tabs"></a>
+<p>One possibly irritating idiosyncrasy is that tabs should not be used to
+vertically align comments in the source document.  Tab characters are
+not treated as separators between a request name and its first argument,
+nor between arguments.
+</p>
+<a class="index-entry-id" id="index-undefined-request"></a>
+<a class="index-entry-id" id="index-request_002c-undefined"></a>
+<p>A comment on a line by itself is treated as a blank line, because after
+eliminating the comment, that is all that remains.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test
+\&quot; comment
+Test
+    &rArr; Test
+    &rArr;
+    &rArr; Test
+</pre></div></div>
+
+<p>To avoid this, it is common to combine the empty request with the
+comment escape sequence as &lsquo;<samp class="samp">.\&quot;</samp>&rsquo;, causing the input line to be
+ignored.
+</p>
+<a class="index-entry-id" id="index-_0027_002c-as-a-comment"></a>
+<p>Another commenting scheme sometimes seen is three consecutive single
+quotes (<code class="code">'''</code>) at the beginning of a line.  This works, but GNU
+<code class="code">troff</code> emits a warning diagnostic (if enabled) about an undefined
+macro (namely &lsquo;<samp class="samp">''</samp>&rsquo;).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0023-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\#</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0023-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0023"></a>
+<p>Start a comment; everything up to and including the next newline is
+ignored.  This <code class="code">groff</code> extension was introduced to avoid the
+problems described above.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test
+\# comment
+Test
+    &rArr; Test Test
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eig"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ig</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eig'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ig"></a>
+<p>Ignore input until, in the current conditional block (if
+any),<a class="footnote" id="DOCF49" href="groff.html_fot.html#FOOT49"><sup>49</sup></a> the macro <var class="var">end</var> is called
+at the start of a control line, or the control line &lsquo;<samp class="samp">..</samp>&rsquo; is
+encountered if <var class="var">end</var> is not specified.  <code class="code">ig</code> is parsed as if it
+were a macro definition, but its contents are discarded, not
+stored.<a class="footnote" id="DOCF50" href="groff.html_fot.html#FOOT50"><sup>50</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">hand\c
+.de TX
+fasting
+..
+.ig TX
+This is part of a large block of input that has been
+temporarily(?) commented out.
+We can restore it simply by removing the .ig request and
+the call of its end macro.
+.TX
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; handfasting
+</pre></div></div>
+</dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Registers.html">Registers</a>, Previous: <a href="Formatter-Instructions.html">Formatter Instructions</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Common-Features.html Added

@@ -0,0 +1,89 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Common Features (The GNU Troff Manual)</title>
+
+<meta name="description" content="Common Features (The GNU Troff Manual)">
+<meta name="keywords" content="Common Features (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Tutorial-for-Macro-Users.html" rel="up" title="Tutorial for Macro Users">
+<link href="Basics.html" rel="prev" title="Basics">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Common-Features">
+<div class="nav-panel">
+<p>
+Previous: <a href="Basics.html" accesskey="p" rel="prev">Basics</a>, Up: <a href="Tutorial-for-Macro-Users.html" accesskey="u" rel="up">Tutorial for Macro Users</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Common-Features-1">3.2 Common Features</h3>
+<a class="index-entry-id" id="index-common-features"></a>
+<a class="index-entry-id" id="index-features_002c-common"></a>
+
+<p>GNU <code class="code">troff</code> provides low-level operations for formatting a
+document.  Many routine operations are undertaken in nearly all
+documents that require a series of such primitive operations to be
+performed.  These common tasks are grouped into <i class="slanted">macros</i>, which
+are then collected into a <i class="slanted">macro package</i>.
+</p>
+<p>Macro packages come in two varieties: &ldquo;major&rdquo; or &ldquo;full-service&rdquo;
+ones that manage page layout, and &ldquo;minor&rdquo; or &ldquo;auxiliary&rdquo; ones that
+do not, instead fulfilling narrow, specific tasks.  Find a list in the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.  Type &lsquo;<samp class="samp">man groff_tmac</samp>&rsquo; at the
+command line to view it.
+</p>
+<p>We survey several capabilities of full-service macro package below.
+Each package employs its own macros to exercise them.  For details,
+consult its man page or, for <samp class="file">ms</samp>, see <a class="ref" href="ms.html"><samp class="file">ms</samp></a>.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Paragraphs.html" accesskey="1">Paragraphs</a></li>
+<li><a href="Sections-and-Chapters.html" accesskey="2">Sections and Chapters</a></li>
+<li><a href="Headers-and-Footers.html" accesskey="3">Headers and Footers</a></li>
+<li><a href="Page-Layout-Adjustment.html" accesskey="4">Page Layout</a></li>
+<li><a href="Displays-and-Keeps.html" accesskey="5">Displays and Keeps</a></li>
+<li><a href="Footnotes-and-Endnotes.html" accesskey="6">Footnotes and Endnotes</a></li>
+<li><a href="Table-of-Contents.html" accesskey="7">Table of Contents</a></li>
+<li><a href="Indexing.html" accesskey="8">Indexing</a></li>
+<li><a href="Document-Formats.html" accesskey="9">Document Formats</a></li>
+<li><a href="Columnation.html">Columnation</a></li>
+<li><a href="Font-and-Size-Changes.html">Font and Size Changes</a></li>
+<li><a href="Predefined-Text.html">Predefined Text</a></li>
+<li><a href="Preprocessor-Support.html">Preprocessor Support</a></li>
+<li><a href="Configuration-and-Customization.html">Configuration and Customization</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Compatibility-Mode.html Added

@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Compatibility Mode (The GNU Troff Manual)</title>
+
+<meta name="description" content="Compatibility Mode (The GNU Troff Manual)">
+<meta name="keywords" content="Compatibility Mode (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Implementation-Differences.html" rel="up" title="Implementation Differences">
+<link href="Safer-Mode.html" rel="next" title="Safer Mode">
+<link href="Other-Differences.html" rel="prev" title="Other Differences">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Compatibility-Mode">
+<div class="nav-panel">
+<p>
+Next: <a href="Safer-Mode.html" accesskey="n" rel="next">Safer Mode</a>, Previous: <a href="Other-Differences.html" accesskey="p" rel="prev">Other Differences</a>, Up: <a href="Implementation-Differences.html" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Compatibility-Mode-1">5.38.2 Compatibility Mode</h4>
+<a class="index-entry-id" id="index-compatibility-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-compatibility"></a>
+
+<a class="index-entry-id" id="index-long-names"></a>
+<a class="index-entry-id" id="index-names_002c-long"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cn_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Long identifier names may be GNU <code class="code">troff</code>&rsquo;s most obvious innovation.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> interprets &lsquo;<samp class="samp">.dsabcd</samp>&rsquo; as defining a
+string &lsquo;<samp class="samp">ab</samp>&rsquo; with contents &lsquo;<samp class="samp">cd</samp>&rsquo;.  Normally, GNU <code class="code">troff</code>
+interprets this as a call of a macro named <code class="code">dsabcd</code>.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> also interprets &lsquo;<samp class="samp">\*</samp>&rsquo; and &lsquo;<samp class="samp">\n</samp>&rsquo; as
+an interpolation of a string or register, respectively, named &lsquo;<samp class="samp"></samp>&rsquo;.
+In GNU <code class="code">troff</code>, however, the &lsquo;<samp class="samp"></samp>&rsquo; is normally interpreted as
+delimiting a long name.  In compatibility mode, GNU <code class="code">troff</code>
+interprets names in the traditional way; they thus can be two characters
+long at most.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ecp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eC_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.C</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eC"></a>
+<p>If <var class="var">n</var> is missing or non-zero, turn on compatibility mode;
+otherwise, turn it off.
+</p>
+<p>The read-only register <code class="code">.C</code> is&nbsp;1 if compatibility mode is on,
+0&nbsp;otherwise.
+</p>
+<p>Compatibility mode can be also turned on with the <samp class="option">-C</samp>
+command-line option.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.do</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002edo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-do"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecp-1"></a>
+<p>The <code class="code">do</code> request interprets the string, request, diversion, or
+macro <var class="var">name</var> (along with any further arguments) with compatibility
+mode disabled.  Compatibility mode is restored (only if it was active)
+when the <em class="emph">expansion</em> of <var class="var">name</var> is interpreted; that is, the
+restored compatibility state applies to the contents of the macro,
+string, or diversion <var class="var">name</var> as well as data read from files or pipes
+if <var class="var">name</var> is any of the <code class="code">so</code>, <code class="code">soquiet</code>, <code class="code">mso</code>,
+<code class="code">msoquiet</code>, or <code class="code">pso</code> requests.
+</p>
+<p>The following example illustrates several aspects of <code class="code">do</code> behavior.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de mac1
+FOO
+..
+.de1 mac2
+groff
+.mac1
+..
+.de mac3
+compatibility
+.mac1
+..
+.de ma
+\\$1
+..
+.cp 1
+.do mac1
+.do mac2 \&quot; mac2, defined with .de1, calls &quot;mac1&quot;
+.do mac3 \&quot; mac3 calls &quot;ma&quot; with argument &quot;c1&quot;
+.do mac3 \ti \&quot; groff syntax accepted in .do arguments
+    &rArr; FOO groff FOO compatibility c1 ~
+</pre></div></div>
+
+<p>The read-only register <code class="code">.cp</code>, meaningful only when dereferenced
+from a <code class="code">do</code> request, is&nbsp;1 if compatibility mode was on when
+the <code class="code">do</code> request was encountered, and 0&nbsp;if it was not.  This
+register is specialized and may require a statement of rationale.
+</p>
+<p>When writing macro packages or documents that use GNU <code class="code">troff</code>
+features and which may be mixed with other packages or documents that do
+not&mdash;common scenarios include serial processing of man pages or use of
+the <code class="code">so</code> or <code class="code">mso</code> requests&mdash;you may desire correct operation
+regardless of compatibility mode enablement in the surrounding context.
+It may occur to you to save the existing value of &lsquo;<samp class="samp">\n(.C</samp>&rsquo; into a
+register, say, &lsquo;<samp class="samp">_C</samp>&rsquo;, at the beginning of your file, turn
+compatibility mode off with &lsquo;<samp class="samp">.cp 0</samp>&rsquo;, then restore it from that
+register at the end with &lsquo;<samp class="samp">.cp \n(_C</samp>&rsquo;.  At the same time, a modular
+design of a document or macro package may lead you to multiple layers of
+inclusion.  You cannot use the same register name everywhere lest you
+&ldquo;clobber&rdquo; the value from a preceding or enclosing context.  The
+two-character register name space of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> is
+confining and mnemonically challenging; you may wish to use the more
+capacious name space of GNU <code class="code">troff</code>.  However, attempting &lsquo;<samp class="samp">.nr
+_my_saved_C \n(.C</samp>&rsquo; will not work in compatibility mode; the register
+name is too long.  &ldquo;This is exactly what <code class="code">do</code> is for,&rdquo; you think,
+&lsquo;<samp class="samp">.do nr _my_saved_C \n(.C</samp>&rsquo;.  The foregoing will always save zero to
+your register, because <code class="code">do</code> turns compatibility mode <em class="emph">off</em>
+while it interprets its argument list.
+</p>
+<p>To robustly save compatibility mode before switching it off, use
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.do nr _my_saved_C \n.cp
+.cp 0
+</pre></div></div>
+
+<p>at the beginning of your file, followed by
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp \n_my_saved_C
+.do rr _my_saved_C
+</pre></div></div>
+
+<p>at the end.  As in the C language, we all have to share one big
+name space, so choose a register name that is unlikely to collide with
+other uses.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-input-level-in-delimited-arguments"></a>
+<a class="index-entry-id" id="index-interpolation-depth-in-delimited-arguments"></a>
+<a class="index-entry-id" id="index-delimited-arguments_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Normally, GNU <code class="code">troff</code> preserves the interpolation depth in
+delimited arguments, but not in compatibility mode.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xx '
+\w'abc\*(xxdef'
+    &rArr; 168 <span class="r">(normal mode on a terminal device)</span>
+    &rArr; 72def' <span class="r">(compatibility mode on a terminal device)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005cf_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cH_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cs_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cS_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Furthermore, the escape sequences <code class="code">\f</code>, <code class="code">\H</code>, <code class="code">\m</code>,
+<code class="code">\M</code>, <code class="code">\R</code>, <code class="code">\s</code>, and <code class="code">\S</code> are transparent for the
+purpose of recognizing a control character at the beginning of a line
+only in compatibility mode.  For example, this code produces bold output
+in both cases, but the text differs.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xx
+Hello!
+..
+\fB.xx\fP
+    &rArr; .xx <span class="r">(normal mode)</span>
+    &rArr; Hello! <span class="r">(compatibility mode)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005cs_002c-incompatibilities-with-AT_0026T-troff-1"></a>
+<p>Normally, the syntax form <code class="code">\s</code><var class="var">n</var> accepts only a single
+character (a digit) for <var class="var">n</var>, consistently with other forms that
+originated in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, like <code class="code">\*</code>, <code class="code">\$</code>,
+<code class="code">\f</code>, <code class="code">\g</code>, <code class="code">\k</code>, <code class="code">\n</code>, and <code class="code">\z</code>.  In
+compatibility mode only, a non-zero&nbsp;<var class="var">n</var> must be in the range
+4&ndash;39.  Legacy documents relying upon this quirk of parsing<a class="footnote" id="DOCF120" href="groff.html_fot.html#FOOT120"><sup>120</sup></a> should be migrated to another
+<code class="code">\s</code> form.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Safer-Mode.html">Safer Mode</a>, Previous: <a href="Other-Differences.html">Other Differences</a>, Up: <a href="Implementation-Differences.html">Implementation Differences</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Concept-Index.html Added

@@ -0,0 +1,2359 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Concept Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Concept Index (The GNU Troff Manual)">
+<meta name="keywords" content="Concept Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Program-and-File-Index.html" rel="prev" title="Program and File Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Concept-Index">
+<div class="nav-panel">
+<p>
+Previous: <a href="Program-and-File-Index.html" accesskey="p" rel="prev">Program and File Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Concept-Index-1">Appendix J Concept Index</h2>
+
+<div class="printindex cp-printindex">
+<table class="cp-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-1"><b>&quot;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-4"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-5"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-6"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-7"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-8"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-9"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-10"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-11"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-12"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-13"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-14"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-15"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-16"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-17"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-18"><b>\</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-19"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-20"><b>|</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="cp-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-1">&quot;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0022_002c-as-delimiter"><code class="code">&quot;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_0022_002c-at-end-of-sentence"><code class="code">&quot;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_0022_002c-at-end-of-sentence-1"><code class="code">&quot;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-_0022_002c-embedding-in-a-macro-argument"><code class="code">&quot;</code>, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0025_002c-as-delimiter"><code class="code">%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-3">&amp;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0026_002c-as-delimiter"><code class="code">&amp;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-4">'</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-_0027_002c-as-a-comment"><code class="code">'</code>, as a comment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0027_002c-as-delimiter"><code class="code">'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_0027_002c-at-end-of-sentence"><code class="code">'</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_0027_002c-at-end-of-sentence-1"><code class="code">'</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-5">(</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0028_002c-as-delimiter"><code class="code">(</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-6">)</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_0029_002c-as-delimiter"><code class="code">)</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_0029_002c-at-end-of-sentence"><code class="code">)</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_0029_002c-at-end-of-sentence-1"><code class="code">)</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-7">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_002a_002c-as-delimiter"><code class="code">*</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_002a_002c-at-end-of-sentence"><code class="code">*</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_002a_002c-at-end-of-sentence-1"><code class="code">*</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-8">+</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002b_002c-and-page-motion"><code class="code">+</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_002b_002c-as-delimiter"><code class="code">+</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-9">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002d_002c-and-page-motion"><code class="code">-</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_002d_002c-as-delimiter"><code class="code">-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-10">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_002e_002c-as-delimiter"><code class="code">.</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_002eh-register_002c-difference-from-nl"><code class="code">.h</code> register, difference from <code class="code">nl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_002eps-register_002c-in-comparison-with-_002epsr"><code class="code">.ps</code> register, in comparison with <code class="code">.psr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_002es-register_002c-in-comparison-with-_002esr"><code class="code">.s</code> register, in comparison with <code class="code">.sr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_002eS-register_002c-Plan-9-alias-for-_002etabs"><code class="code">.S</code> register, Plan&nbsp;9 alias for <code class="code">.tabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-_002et-register_002c-and-diversions"><code class="code">.t</code> register, and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_002etabs-register_002c-Plan-9-alias-_0028_002eS_0029"><code class="code">.tabs</code> register, Plan&nbsp;9 alias (<code class="code">.S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-_002eV-register_002c-and-vs"><code class="code">.V</code> register, and <code class="code">vs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-11">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_002f_002c-as-delimiter"><code class="code">/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-12">8</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-8_002dbit-input">8-bit input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-13">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_003a_002c-as-delimiter"><code class="code">:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-14">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_003c_002c-as-delimiter"><code class="code">&lt;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-15">=</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_003d_002c-as-delimiter"><code class="code">=</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-16">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_003e_002c-as-delimiter"><code class="code">&gt;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-17"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-_005b_002c-macro-names-starting-with_002c-and-refer"><code class="code"></code>, macro names starting with, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-18">\</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_0021_002c-and-copy-mode"><code class="code">\!</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_0021_002c-and-output-request"><code class="code">\!</code>, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0021_002c-and-trnt"><code class="code">\!</code>, and <code class="code">trnt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0021_002c-as-delimiter"><code class="code">\!</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0021_002c-as-delimiter-1"><code class="code">\!</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_0021_002c-in-top_002dlevel-diversion"><code class="code">\!</code>, in top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\!</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff-1"><code class="code">\!</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005c_0024_002c-when-reading-text-for-a-macro"><code class="code">\$</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0025_002c-and-translations"><code class="code">\%</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0025_002c-as-delimiter"><code class="code">\%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0025_002c-as-delimiter-1"><code class="code">\%</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_005c_0025_002c-following-_005cX-or-_005cY"><code class="code">\%</code>, following <code class="code">\X</code> or <code class="code">\Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005c_0025_002c-in-_005cX"><code class="code">\%</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0025_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\%</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_0026_002c-and-glyph-definitions"><code class="code">\&amp;</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0026_002c-and-translations"><code class="code">\&amp;</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0026_002c-as-delimiter"><code class="code">\&amp;</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_005c_0026_002c-at-end-of-sentence"><code class="code">\&amp;</code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005c_0026_002c-in-_005cX"><code class="code">\&amp;</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0026_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\&amp;</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0027_002c-and-translations"><code class="code">\'</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0027_002c-as-delimiter"><code class="code">\'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0027_002c-as-delimiter-1"><code class="code">\'</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0027_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\'</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0028_002c-and-translations"><code class="code">$</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0029_002c-as-delimiter"><code class="code">$</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005c_0029_002c-in-_005cX"><code class="code">\)</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-_005c_002a_002c-and-warnings"><code class="code">\*</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005c_002a_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\*</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005c_002a_002c-when-reading-text-for-a-macro"><code class="code">\*</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-_005c_002c-disabling-_0028eo_0029"><code class="code">\</code>, disabling (<code class="code">eo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-_005c_002c-embedding-in-a-macro-argument"><code class="code">\</code>, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_002c_002c-as-delimiter"><code class="code">\,</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_002d-glyph_002c-and-cflags"><code class="code">\-</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_002d_002c-and-translations"><code class="code">\-</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_002d_002c-as-delimiter"><code class="code">\-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_002d_002c-as-delimiter-1"><code class="code">\-</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_002d_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\-</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_002f_002c-as-delimiter"><code class="code">\/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_002f_002c-as-delimiter-1"><code class="code">\/</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c0_002c-as-delimiter"><code class="code">\0</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_003a_002c-as-delimiter"><code class="code">\:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_003a_002c-as-delimiter-1"><code class="code">\:</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005c_003a_002c-in-_005cX"><code class="code">\:</code>, in <code class="code">\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-_005c_003f_002c-and-copy-mode"><code class="code">\?</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_003f_002c-and-copy-mode-1"><code class="code">\?</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_003f_002c-as-delimiter"><code class="code">\?</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_003f_002c-in-top_002dlevel-diversion"><code class="code">\?</code>, in top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_003f_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\?</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-_005ca_002c-and-copy-mode"><code class="code">\a</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005ca_002c-and-translations"><code class="code">\a</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005ca_002c-as-delimiter"><code class="code">\a</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cA_002c-delimiters-allowed-by"><code class="code">\A</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005cA_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\A</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cb_002c-delimiters-allowed-by"><code class="code">\b</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-_005cb_002c-limitations-of"><code class="code">\b</code>, limitations of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005cC_002c-and-translations"><code class="code">\C</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cc_002c-as-delimiter"><code class="code">\c</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cc_002c-as-delimiter-1"><code class="code">\c</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005cc_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\c</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cc_002c-when-filling-disabled"><code class="code">\c</code>, when filling disabled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cc_002c-when-filling-enabled"><code class="code">\c</code>, when filling enabled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cd_002c-as-delimiter"><code class="code">\d</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cD_002c-delimiters-allowed-by"><code class="code">\D</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005ce_002c-and-glyph-definitions"><code class="code">\e</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005ce_002c-and-translations"><code class="code">\e</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005ce_002c-as-delimiter"><code class="code">\e</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cE_002c-as-delimiter"><code class="code">\E</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005ce_002c-as-delimiter-1"><code class="code">\e</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005ce_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\e</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-_005cF_002c-and-changing-fonts"><code class="code">\F</code>, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-_005cf_002c-and-font-translations"><code class="code">\f</code>, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cf_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\f</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005ch_002c-delimiters-allowed-by"><code class="code">\h</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cH_002c-delimiters-allowed-by"><code class="code">\H</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cH_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\H</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_005cH_002c-using-_002b-and-_002d-with"><code class="code">\H</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_005cH_002c-with-fractional-type-sizes"><code class="code">\H</code>, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005cl_002c-and-glyph-definitions"><code class="code">\l</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005cL_002c-and-glyph-definitions"><code class="code">\L</code>, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cl_002c-delimiters-allowed-by"><code class="code">\l</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cL_002c-delimiters-allowed-by"><code class="code">\L</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005cN_002c-and-translations"><code class="code">\N</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-_005cn_002c-and-warnings"><code class="code">\n</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cN_002c-delimiters-allowed-by"><code class="code">\N</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cn_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\n</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005cn_002c-when-reading-text-for-a-macro"><code class="code">\n</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005co_002c-delimiters-allowed-by"><code class="code">\o</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cp_002c-as-delimiter"><code class="code">\p</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cp_002c-as-delimiter-1"><code class="code">\p</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cR_002c-after-_005cc"><code class="code">\R</code>, after <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-_005cR_002c-and-warnings"><code class="code">\R</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cr_002c-as-delimiter"><code class="code">\r</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cR_002c-delimiters-allowed-by"><code class="code">\R</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-_005cR_002c-difference-from-nr"><code class="code">\R</code>, difference from <code class="code">nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_005cR_002c-using-_002b-and-_002d-with"><code class="code">\R</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005cRET_002c-when-reading-text-for-a-macro">\<kbd class="key">RET</kbd>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cs_002c-delimiters-allowed-by"><code class="code">\s</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cS_002c-delimiters-allowed-by"><code class="code">\S</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cs_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\s</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cS_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\S</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_005cs_002c-incompatibilities-with-AT_0026T-troff-1"><code class="code">\s</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_005cs_002c-using-_002b-and-_002d-with"><code class="code">\s</code>, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_005cs_002c-with-fractional-type-sizes"><code class="code">\s</code>, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cSP_002c-as-delimiter"><code class="code">\<kbd class="key">SP</kbd></code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-_005cSP_002c-difference-from-_005c_007e"><code class="code">\<kbd class="key">SP</kbd></code>, difference from <code class="code">\~</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005cSP_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\<kbd class="key">SP</kbd></code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_005ct_002c-and-copy-mode"><code class="code">\t</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005ct_002c-and-translations"><code class="code">\t</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-_005ct_002c-and-warnings"><code class="code">\t</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005ct_002c-as-delimiter"><code class="code">\t</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cu_002c-as-delimiter"><code class="code">\u</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-_005cV_002c-and-copy-mode"><code class="code">\V</code>, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cv_002c-delimiters-allowed-by"><code class="code">\v</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-_005cv_002c-internal-representation"><code class="code">\v</code>, internal representation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cw_002c-delimiters-allowed-by"><code class="code">\w</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005cX_002c-and-special-characters"><code class="code">\X</code>, and special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cX_002c-delimiters-allowed-by"><code class="code">\X</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cx_002c-delimiters-allowed-by"><code class="code">\x</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_005cX_002c-followed-by-_005c_0025"><code class="code">\X</code>, followed by <code class="code">\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_005cY_002c-followed-by-_005c_0025"><code class="code">\Y</code>, followed by <code class="code">\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005cZ_002c-delimiters-allowed-by"><code class="code">\Z</code>, delimiters allowed by</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_005b_002c-and-translations"><code class="code">\</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005c_005c_002c-when-reading-text-for-a-macro"><code class="code">\\</code>, when reading text for a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_005e_002c-as-delimiter"><code class="code">\^</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_005e_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\^</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_005f_002c-and-translations"><code class="code">\_</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_005f_002c-as-delimiter"><code class="code">\_</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_005f_002c-as-delimiter-1"><code class="code">\_</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_005f_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\_</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_0060_002c-and-translations"><code class="code">\`</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0060_002c-as-delimiter"><code class="code">\`</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_0060_002c-as-delimiter-1"><code class="code">\`</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_0060_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\`</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007b_002c-as-delimiter"><code class="code">\{</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007b_002c-as-delimiter-1"><code class="code">\{</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_007b_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\{</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007c_002c-as-delimiter"><code class="code">\|</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_007c_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\|</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-_005c_007d_002c-and-warnings"><code class="code">\}</code>, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007d_002c-as-delimiter"><code class="code">\}</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007d_002c-as-delimiter-1"><code class="code">\}</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_007d_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\}</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-_005c_007e_002c-and-translations"><code class="code">\~</code>, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-_005c_007e_002c-as-delimiter"><code class="code">\~</code>, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-_005c_007e_002c-difference-from-_005cSP"><code class="code">\~</code>, difference from <code class="code">\<kbd class="key">SP</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-_005c_007e_002c-incompatibilities-with-AT_0026T-troff"><code class="code">\~</code>, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-19"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-_005d_002c-as-part-of-an-identifier"><code class="code"></code>, as part of an identifier</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-_005d_002c-at-end-of-sentence"><code class="code"></code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005d_002c-at-end-of-sentence-1"><code class="code"></code>, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-_005d_002c-macro-names-starting-with_002c-and-refer"><code class="code"></code>, macro names starting with, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_symbol-20">|</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_007c_002c-and-page-motion"><code class="code">|</code>, and page motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-ab-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ab</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-aborting-_0028ab_0029">aborting (<code class="code">ab</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-absolute-_0028sic_0029-position-operator-_0028_007c_0029">absolute <i class="slanted">(sic)</i> position operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-abstract-font-style">abstract font style</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-abstract-font-style_002c-setting-up-_0028sty_0029">abstract font style, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-accent-marks-_005bms_005d">accent marks <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-access-to-postprocessor">access to postprocessor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-accessing-unnamed-glyphs-with-_005cN">accessing unnamed glyphs with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-activating-kerning-_0028kern_0029">activating kerning (<code class="code">kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-activating-ligatures-_0028lg_0029">activating ligatures (<code class="code">lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-activating-track-kerning-_0028tkf_0029">activating track kerning (<code class="code">tkf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-ad-request_002c-and-hyphenation-margin"><code class="code">ad</code> request, and hyphenation margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-ad-request_002c-and-hyphenation-space"><code class="code">ad</code> request, and hyphenation space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-addition">addition</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-additional-inter_002dsentence-space">additional inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-adjustment-and-filling_002c-manipulating">adjustment and filling, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-adjustment-mode-register-_0028_002ej_0029">adjustment mode register (<code class="code">.j</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-adjustment-to-both-margins_002c-difference-from-AT_0026T-troff">adjustment to both margins, difference from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-Adobe-Glyph-List-_0028AGL_0029">Adobe Glyph List (AGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-diversion_002c-creating-_0028als_0029">alias, diversion, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-diversion_002c-removing-_0028rm_0029">alias, diversion, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-macro_002c-creating-_0028als_0029">alias, macro, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-macro_002c-removing-_0028rm_0029">alias, macro, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-alias_002c-register_002c-creating-_0028aln_0029">alias, register, creating (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-alias_002c-register_002c-removing-_0028rr_0029">alias, register, removing (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-string_002c-creating-_0028als_0029">alias, string, creating (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-alias_002c-string_002c-removing-_0028rm_0029">alias, string, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-aliasing-fonts-with-third-argument-to-fp-request">aliasing fonts with third argument to <code class="code">fp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-als-request_002c-and-_005c_00240"><code class="code">als</code> request, and <code class="code">\$0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-am_002c-am1_002c-ami-requests_002c-and-warnings"><code class="code">am</code>, <code class="code">am1</code>, <code class="code">ami</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-appending-to-a-diversion-_0028da_002c-boxa_0029">appending to a diversion (<code class="code">da</code>, <code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-appending-to-a-file-_0028opena_0029">appending to a file (<code class="code">opena</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-appending-to-a-macro-_0028am_0029">appending to a macro (<code class="code">am</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-appending-to-a-string-_0028as_0029">appending to a string (<code class="code">as</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-approximation-output-register-_0028_002eA_0029">approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029">arc, drawing (&lsquo;<samp class="samp">\D'a &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-argument">argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-arguments-to-macros">arguments to macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-arguments-to-macros_002c-and-tabs">arguments to macros, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-arguments-to-requests">arguments to requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-arguments-to-requests_002c-and-tabs">arguments to requests, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-arguments_002c-and-compatibility-mode">arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-arguments_002c-to-escape-sequences_002c-delimiting">arguments, to escape sequences, delimiting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-arguments_002c-to-strings">arguments, to strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-arithmetic-operators">arithmetic operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-artificial-fonts">artificial fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-as_002c-as1-requests_002c-and-comments"><code class="code">as</code>, <code class="code">as1</code> requests, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-as_002c-as1-requests_002c-and-warnings"><code class="code">as</code>, <code class="code">as1</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-ASCII-output-encoding"><abbr class="acronym">ASCII</abbr> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-asciify-request_002c-and-writem"><code class="code">asciify</code> request, and <code class="code">writem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-assertion-_0028arithmetic-operator_0029">assertion (arithmetic operator)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-assign-number-format-to-register-_0028af_0029">assign number format to register (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-assignments_002c-indirect">assignments, indirect</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-assignments_002c-nested">assignments, nested</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Differences-from-AT_0026T-ms.html#index-AT_0026T-ms_002c-macro-package-differences"><abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>, macro package differences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Differences-from-AT_0026T-ms.html">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-attributes_002c-character-cell">attributes, character cell</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-auto_002dincrementation-of-a-register">auto-incrementation of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-automatic-font-mounting">automatic font mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-automatic-hyphenation">automatic hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-automatic-hyphenation-parameters">automatic hyphenation parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-auxiliary-macro-package">auxiliary macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-available-glyphs_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">available glyphs, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Background.html#index-background">background</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Background.html">Background</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-background-color-name-register-_0028_002eM_0029">background color name register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-backslash-glyph_002c-formatting-_0028_005c_005brs_005d_0029">backslash glyph, formatting (<code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-backslash_002c-embedding-in-a-macro-argument">backslash, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-backslash_002c-printing-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029">backslash, printing (<code class="code">\\</code>, <code class="code">\e</code>, <code class="code">\E</code>, <code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-backspace-character_002c-and-translations">backspace character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-backtrace-of-input-stack-_0028backtrace_0029">backtrace of input stack (<code class="code">backtrace</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-baseline-rule-special-character_0028_005c_005bru_005d_0029">baseline rule special character(<code class="code">\ru</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-baseline_002c-text">baseline, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-baseline_002c-text-1">baseline, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-basic-scaling-unit-_0028u_0029">basic scaling unit (<code class="code">u</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-basic-units">basic units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-basic-units_002c-conversion-to">basic units, conversion to</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-basics-of-macro-package-usage">basics of macro package usage</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-bd-request_002c-and-font-styles"><code class="code">bd</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-bd-request_002c-and-font-translations"><code class="code">bd</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-bd-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">bd</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-beginning-diversion-_0028di_002c-box_0029">beginning diversion (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-beginning-of-conditional-block-_0028_005c_007b_0029">beginning of conditional block (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-blank-line">blank line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-blank-line-macro-_0028blm_0029">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-blank-line-macro-_0028blm_0029-1">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Blank-Line-Traps.html#index-blank-line-macro-_0028blm_0029-2">blank line macro (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Blank-Line-Traps.html">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-blank-line-trap-_0028blm_0029">blank line trap (<code class="code">blm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Blank-Line-Traps.html#index-blank-line-traps">blank line traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Blank-Line-Traps.html">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-blank-lines_002c-disabling">blank lines, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-block_002c-conditional_002c-beginning-_0028_005c_007b_0029">block, conditional, beginning (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-block_002c-conditional_002c-end-_0028_005c_007d_0029">block, conditional, end (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-blocks_002c-conditional">blocks, conditional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-body_002c-of-a-while-request">body, of a while request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-boldface_002c-imitating-_0028bd_0029">boldface, imitating (<code class="code">bd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-bottom-margin">bottom margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-boundary_002drelative-motion-operator-_0028_007c_0029">boundary-relative motion operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-bounding-box">bounding box</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-box-_0028diversion-operation_0029">box (diversion operation)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-box-request_002c-and-warnings"><code class="code">box</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-box-rule-glyph-_0028_005c_005bbr_005d_0029">box rule glyph (<code class="code">\br</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-box_002c-boxa-requests_002c-and-warnings"><code class="code">box</code>, <code class="code">boxa</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-boxa-request_002c-and-dn-_0028dl_0029"><code class="code">boxa</code> request, and <code class="code">dn</code> (<code class="code">dl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-boxa-request_002c-and-warnings"><code class="code">boxa</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-boxes-_005bms_005d">boxes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-bp-request_002c-and-top_002dlevel-diversion"><code class="code">bp</code> request, and top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-bp-request_002c-and-traps-_0028_002epe_0029"><code class="code">bp</code> request, and traps (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-bp-request_002c-causing-implicit-break"><code class="code">bp</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-bp-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">bp</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-bp-request_002c-using-_002b-and-_002d-with"><code class="code">bp</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-br-glyph_002c-and-cflags"><code class="code">br</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-brace-escape-sequence_002c-closing-_0028_005c_007d_0029">brace escape sequence, closing (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-brace-escape-sequence_002c-opening-_0028_005c_007d_0029">brace escape sequence, opening (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-brace-escape-sequences-_0028_005c_007b_002c-_005c_007d_0029">brace escape sequences (<code class="code">\{</code>, <code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-break">break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-break-1">break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-break-_0028introduction_0029">break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-break-request_002c-in-a-while-loop"><code class="code">break</code> request, in a <code class="code">while</code> loop</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-break_002c-page">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-break_002c-page-1">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-break_002c-page-2">break, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-break_002c-page-_0028introduction_0029">break, page (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-break_002c-page_002c-final">break, page, final</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-break_002c-page_002c-prevented-by-vpt">break, page, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-breaking-file-names-_0028_005c_003a_0029">breaking file names (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-breaking-URLs-_0028_005c_003a_0029">breaking URLs (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-breaking-without-hyphens-_0028_005c_003a_0029">breaking without hyphens (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-built_002din-register_002c-removing">built-in register, removing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-built_002din-registers">built-in registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-bulleted-list_002c-example-markup-_005bms_005d">bulleted list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-c-scaling-unit"><code class="code">c</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-calling-a-macro">calling a macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-calling-macros">calling macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="groff-Capabilities.html#index-capabilities-of-groff">capabilities of <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="groff-Capabilities.html"><code class="code">groff</code> Capabilities</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-case_002dtransforming-a-string-_0028stringdown_002c-stringup_0029">case-transforming a string (<code class="code">stringdown</code>, <code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-categories_002c-warning">categories, warning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-CCSID-1047-output-encoding-_0028EBCDIC_0029">CCSID 1047 output encoding (EBCDIC)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ce-request_002c-causing-implicit-break"><code class="code">ce</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ce-request_002c-difference-from-_002ead-c"><code class="code">ce</code> request, difference from &lsquo;<samp class="samp">.ad&nbsp;c</samp>&rsquo;</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-cell_002c-character_002c-attributes">cell, character, attributes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-centered-text-_0028filled_0029">centered text (filled)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-centered-text-_0028unfilled_0029">centered text (unfilled)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-centering-lines-_0028ce_0029">centering lines (<code class="code">ce</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-centering-lines-_0028introduction_0029">centering lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-centimeter-scaling-unit-_0028c_0029">centimeter scaling unit (<code class="code">c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-cf-request_002c-and-copy-mode"><code class="code">cf</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-cf-request_002c-causing-implicit-break"><code class="code">cf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-changing-control-characters">changing control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-changing-font-family-_0028fam_002c-_005cF_0029">changing font family (<code class="code">fam</code>, <code class="code">\F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-changing-fonts-_0028ft_002c-_005cf_0029">changing fonts (<code class="code">ft</code>, <code class="code">\f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-changing-format_002c-and-read_002donly-registers">changing format, and read-only registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-changing-the-font-height-_0028_005cH_0029">changing the font height (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-changing-the-font-slant-_0028_005cS_0029">changing the font slant (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-changing-the-page-number-character-_0028pc_0029">changing the page number character (<code class="code">pc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-changing-trap-location-_0028ch_0029">changing trap location (<code class="code">ch</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-changing-type-sizes-_0028ps_002c-_005cs_0029">changing type sizes (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-changing-vertical-line-spacing-_0028vs_0029">changing vertical line spacing (<code class="code">vs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-char-request_002c-and-soft-hyphen-character"><code class="code">char</code> request, and soft hyphen character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-char-request_002c-and-translations"><code class="code">char</code> request, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-char-request_002c-used-with-_005cN"><code class="code">char</code> request, used with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character">character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-character-cell-attributes">character cell attributes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-character-class-_0028class_0029">character class (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-character-classes">character classes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character-properties-_0028cflags_0029">character properties (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character-translations">character translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character_002c-backspace_002c-and-translations">character, backspace, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-character_002c-control-_0028_002e_0029">character, control (<code class="code">.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-character_002c-control_002c-changing-_0028cc_0029">character, control, changing (<code class="code">cc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-defining-_0028char_0029">character, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-defining-fallback-_0028fchar_002c-fschar_002c-schar_0029">character, defining fallback (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-distinguished-from-glyph">character, distinguished from glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-character_002c-dummy-_0028_005c_0026_0029">character, dummy (<code class="code">\&amp;</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-character_002c-dummy-_0028_005c_0026_0029_002c-as-control-character-suppressor">character, dummy (<code class="code">\&amp;</code>), as control character suppressor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-kerning">character, dummy (<code class="code">\&amp;</code>), effect on kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence">character, dummy (<code class="code">\&amp;</code>), effect on <code class="code">\l</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-character_002c-escape_002c-changing-_0028ec_0029">character, escape, changing (<code class="code">ec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-escape_002c-while-defining-glyph">character, escape, while defining glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-character_002c-field-delimiting-_0028fc_0029">character, field delimiting (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-character_002c-field-padding-_0028fc_0029">character, field padding (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-character_002c-horizontal-tab">character, horizontal tab</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-character_002c-hyphenation-_0028_005c_0025_0029">character, hyphenation (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-character_002c-leader">character, leader</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-character_002c-leader-repetition-_0028lc_0029">character, leader repetition (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character_002c-leader_002c-and-translations">character, leader, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-character_002c-leader_002c-non_002dinterpreted-_0028_005ca_0029">character, leader, non-interpreted (<code class="code">\a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-named-_0028_005cC_0029">character, named (<code class="code">\C</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character_002c-newline_002c-and-translations">character, newline, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-character_002c-no_002dbreak-control-_0028_0027_0029">character, no-break control (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-character_002c-no_002dbreak-control_002c-changing-_0028c2_0029">character, no-break control, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-character_002c-ordinary">character, ordinary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-character_002c-soft-hyphen_002c-setting-_0028shc_0029">character, soft hyphen, setting (<code class="code">shc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character_002c-special">character, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-character_002c-tab-repetition-_0028tc_0029">character, tab repetition (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-character_002c-tab_002c-and-translations">character, tab, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-character_002c-tab_002c-non_002dinterpreted-_0028_005ct_0029">character, tab, non-interpreted (<code class="code">\t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-character_002c-transparent">character, transparent</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-character_002c-transparent-dummy-_0028_005c_0029_0029">character, transparent dummy (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-characters_002c-end_002dof_002dsentence">characters, end-of-sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-characters_002c-end_002dof_002dsentence-transparent">characters, end-of-sentence transparent</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-characters_002c-hyphenation">characters, hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-characters_002c-input_002c-and-output-glyphs_002c-compatibility-with-AT_0026T-troff">characters, input, and output glyphs, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-characters_002c-invalid-for-trf-request">characters, invalid for <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-characters_002c-invalid-input">characters, invalid input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-characters_002c-overlapping">characters, overlapping</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-characters_002c-special">characters, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-characters_002c-special_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">characters, special, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-characters_002c-unnamed_002c-accessing-with-_005cN">characters, unnamed, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">circle, filled, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-circle_002c-outlined_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">circle, outlined, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-circle_002c-solid_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">circle, solid, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">circle, stroked, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-class-of-characters-_0028class_0029">class of characters (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-classes_002c-character">classes, character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-clearing-input-line-trap-_0028it_002c-itc_0029">clearing input line trap (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-closing-brace-escape-sequence-_0028_005c_007d_0029">closing brace escape sequence (<code class="code">\})</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-closing-file-_0028close_0029">closing file (<code class="code">close</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-code-page-1047-output-encoding">code page 1047 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-code-page-1047_002c-input-encoding">code page 1047, input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-code_002c-hyphenation-_0028hcode_0029">code, hyphenation (<code class="code">hcode</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color-name_002c-background_002c-register-_0028_002eM_0029">color name, background, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color-name_002c-fill_002c-register-_0028_002eM_0029">color name, fill, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color-name_002c-stroke_002c-register-_0028_002em_0029">color name, stroke, register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color_002c-default">color, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color_002c-fill">color, fill</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color_002c-stroke">color, stroke</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-colors">colors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-command-prefix">command prefix</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-command_002dline-options">command-line options</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-comments">comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-comments-in-device-description-files">comments in device description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-comments-in-font-description-files">comments in font description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-comments_002c-lining-up-with-tabs">comments, lining up with tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-comments_002c-with-ds">comments, with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Common-Features.html#index-common-features">common features</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Common-Features.html">Common Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-common-name-space-of-macros_002c-diversions_002c-and-strings">common name space of macros, diversions, and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-comparison-of-strings">comparison of strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-comparison-operators">comparison operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-compatibility-mode">compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-compatibility-mode-1">compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-compatibility-mode_002c-and-parameters">compatibility mode, and parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-complementation_002c-logical">complementation, logical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-composite-glyph-names">composite glyph names</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-conditional-block_002c-beginning-_0028_005c_007b_0029">conditional block, beginning (<code class="code">\{</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-conditional-block_002c-end-_0028_005c_007d_0029">conditional block, end (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-conditional-blocks">conditional blocks</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-conditional-expressions">conditional expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-conditional-output-for-terminal-_0028TTY_0029">conditional output for terminal (TTY)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-conditional-page-break-_0028ne_0029">conditional page break (<code class="code">ne</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditionals-and-Loops.html#index-conditionals-and-loops">conditionals and loops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditionals-and-Loops.html">Conditionals and Loops</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-configuring-control-characters">configuring control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-configuring-the-page-length-_0028pl_0029">configuring the page length (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-consecutive-hyphenated-lines-_0028hlm_0029">consecutive hyphenated lines (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-constant-glyph-space-mode-_0028cs_0029">constant glyph space mode (<code class="code">cs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Table-of-Contents.html#index-contents_002c-table-of">contents, table of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Table-of-Contents.html">Table of Contents</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-contents_002c-table-of-1">contents, table of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-continuation_002c-input-line-_0028_005cRET_0029">continuation, input line (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-continuation_002c-output-line-_0028_005cc_0029">continuation, output line (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-continue-request_002c-in-a-while-loop"><code class="code">continue</code> request, in a <code class="code">while</code> loop</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-continued-output-line-register-_0028_002eint_0029">continued output line register (<code class="code">.int</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-continuous-underlining-_0028cu_0029">continuous underlining (<code class="code">cu</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-control-character-_0028_002e_0029">control character (<code class="code">.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-control-character_002c-changing-_0028cc_0029">control character, changing (<code class="code">cc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-control-character_002c-no_002dbreak-_0028_0027_0029">control character, no-break (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-control-character_002c-no_002dbreak_002c-changing-_0028c2_0029">control character, no-break, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-control-characters">control characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-control-line">control line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-control_002c-line">control, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-control_002c-page">control, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Conventions.html#index-conventions-for-input">conventions for input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Conventions.html">Input Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-conversion-to-basic-units">conversion to basic units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-copy-mode">copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-copy-mode-1">copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-cf-request">copy mode, and <code class="code">cf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-copy-mode_002c-and-device-request">copy mode, and <code class="code">device</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-copy-mode_002c-and-length-request">copy mode, and <code class="code">length</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-copy-mode_002c-and-macro-parameters">copy mode, and macro parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-copy-mode_002c-and-output-request">copy mode, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-trf-request">copy mode, and <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-write-request">copy mode, and <code class="code">write</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-writec-request">copy mode, and <code class="code">writec</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-writem-request">copy mode, and <code class="code">writem</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-copy-mode_002c-and-_005c_0021">copy mode, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-copy-mode_002c-and-_005c_003f">copy mode, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-copy-mode_002c-and-_005c_003f-1">copy mode, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-copy-mode_002c-and-_005ca">copy mode, and <code class="code">\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-copy-mode_002c-and-_005ct">copy mode, and <code class="code">\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-copy-mode_002c-and-_005cV">copy mode, and <code class="code">\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-copying-environment-_0028evc_0029">copying environment (<code class="code">evc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-correction-between-oblique-and-upright-glyph-_0028_005c_002f_002c-_005c_002c_0029">correction between oblique and upright glyph (<code class="code">\/</code>, <code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-correction-between-upright-and-oblique-glyph-_0028_005c_002f_002c-_005c_002c_0029">correction between upright and oblique glyph (<code class="code">\/</code>, <code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-correction_002c-italic-_0028_005c_002f_0029">correction, italic (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-correction_002c-left-italic-_0028_005c_002c_0029">correction, left italic (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-cover-page-in-_005bms_005d_002c-example-markup">cover page in <samp class="file">ms</samp>, example markup</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-cp-request_002c-and-glyph-definitions"><code class="code">cp</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-cq-glyph_002c-at-end-of-sentence"><code class="code">cq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-cq-glyph_002c-at-end-of-sentence-1"><code class="code">cq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-creating-alias-for-register-_0028aln_0029">creating alias for register (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-creating-alias_002c-for-diversion-_0028als_0029">creating alias, for diversion (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-creating-alias_002c-for-macro-_0028als_0029">creating alias, for macro (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-creating-alias_002c-for-string-_0028als_0029">creating alias, for string (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-creating-new-characters-_0028char_0029">creating new characters (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Credits.html#index-credits">credits</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Credits.html">Credits</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-cs-request_002c-and-font-styles"><code class="code">cs</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-cs-request_002c-and-font-translations"><code class="code">cs</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-cs-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">cs</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-cs-request_002c-with-fractional-type-sizes"><code class="code">cs</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-CSTR-_002354-errata">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-CSTR-_002354-errata-1">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-CSTR-_002354-errata-2">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-CSTR-_002354-errata-3">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-CSTR-_002354-errata-4">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-CSTR-_002354-errata-5">CSTR&nbsp;#54 errata</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-CSTR-_002354-erratum_002c-bp-request">CSTR&nbsp;#54 erratum, <code class="code">bp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-CSTR-_002354-erratum_002c-po-request">CSTR&nbsp;#54 erratum, <code class="code">po</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-CSTR-_002354-erratum_002c-ps-request">CSTR&nbsp;#54 erratum, <code class="code">ps</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-CSTR-_002354-erratum_002c-sb-register">CSTR&nbsp;#54 erratum, <code class="code">sb</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-CSTR-_002354-erratum_002c-st-register">CSTR&nbsp;#54 erratum, <code class="code">st</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-CSTR-_002354-erratum_002c-yr-register">CSTR&nbsp;#54 erratum, <code class="code">yr</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-CSTR-_002354-erratum_002c-_005cS-escape">CSTR&nbsp;#54 erratum, <code class="code">\S</code> escape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-CSTR-_002354-erratum_002c-_005cs-escape-sequence">CSTR&nbsp;#54 erratum, <code class="code">\s</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-current-directory">current directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-current-input-file-name-register-_0028_002eF_0029">current input file name register (<code class="code">.F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-current-page-number-_0028_0025_0029">current page number (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-current-time_002c-hours-_0028hours_0029">current time, hours (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-current-time_002c-minutes-_0028minutes_0029">current time, minutes (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-current-time_002c-seconds-_0028seconds_0029">current time, seconds (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-da-request_002c-and-dn-_0028dl_0029"><code class="code">da</code> request, and <code class="code">dn</code> (<code class="code">dl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-da-request_002c-and-warnings"><code class="code">da</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-da-request_002c-and-warnings-1"><code class="code">da</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-date_002c-day-of-the-month-register-_0028dy_0029">date, day of the month register (<code class="code">dy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-date_002c-day-of-the-week-register-_0028dw_0029">date, day of the week register (<code class="code">dw</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-date_002c-month-of-the-year-register-_0028mo_0029">date, month of the year register (<code class="code">mo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-date_002c-year-register-_0028year_002c-yr_0029">date, year register (<code class="code">year</code>, <code class="code">yr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-day-of-the-month-register-_0028dy_0029">day of the month register (<code class="code">dy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-day-of-the-week-register-_0028dw_0029">day of the week register (<code class="code">dw</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-dd-glyph_002c-at-end-of-sentence"><code class="code">dd</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-dd-glyph_002c-at-end-of-sentence-1"><code class="code">dd</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-de-request_002c-and-while"><code class="code">de</code> request, and <code class="code">while</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-de_002c-de1_002c-dei-requests_002c-and-warnings"><code class="code">de</code>, <code class="code">de1</code>, <code class="code">dei</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-debugging">debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-debugging-page-location-traps">debugging page location traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-decimal-point_002c-as-delimiter">decimal point, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-decrementation_002c-automatic_002c-of-a-register">decrementation, automatic, of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-default-color">default color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-default-tab-stops">default tab stops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Default-Units.html#index-default-units">default units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Default-Units.html">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Deferring-Output.html#index-deferred-output">deferred output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Deferring-Output.html">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-defining-character-_0028char_0029">defining character (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-defining-character-class-_0028class_0029">defining character class (<code class="code">class</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-defining-fallback-character-_0028fchar_002c-fschar_002c-schar_0029">defining fallback character (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-defining-glyph-_0028char_0029">defining glyph (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-defining-symbol-_0028char_0029">defining symbol (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-delimited-arguments_002c-incompatibilities-with-AT_0026T-troff">delimited arguments, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-delimiters_002c-for-escape-sequence-arguments">delimiters, for escape sequence arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-delimiting-character_002c-for-fields-_0028fc_0029">delimiting character, for fields (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-delimiting-escape-sequence-arguments">delimiting escape sequence arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-depth_002c-interpolation">depth, interpolation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-depth_002c-of-last-glyph-_0028_002ecdp_0029">depth, of last glyph (<code class="code">.cdp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-DESC-file-format"><samp class="file">DESC</samp> file format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-DESC-file_002c-and-font-mounting"><samp class="file">DESC</samp> file, and font mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-DESC-file_002c-and-use_005fcharnames_005fin_005fspecial-keyword"><samp class="file">DESC</samp> file, and <code class="code">use_charnames_in_special</code> keyword</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-description-file_002c-font">description file, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-device-description-files_002c-comments">device description files, comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-device-request_002c-and-copy-mode"><code class="code">device</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-device-resolution">device resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-device-resolution-1">device resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-device-resolution_002c-obtaining-in-the-formatter">device resolution, obtaining in the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Output-Device-Intro.html#index-devices-for-output">devices for output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Output-Device-Intro.html">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-dg-glyph_002c-at-end-of-sentence"><code class="code">dg</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-dg-glyph_002c-at-end-of-sentence-1"><code class="code">dg</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-di-request_002c-and-warnings"><code class="code">di</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-di-request_002c-and-warnings-1"><code class="code">di</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Implementation-Differences.html#index-differences-in-implementation">differences in implementation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Implementation-Differences.html">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-digit_002dwidth-space-_0028_005c0_0029">digit-width space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-digits_002c-as-delimiters">digits, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-dimensions_002c-line">dimensions, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-directories-for-fonts">directories for fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directories-for-macros">directories for macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directory_002c-current">directory, current</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directory_002c-for-tmac-files">directory, for tmac files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directory_002c-home">directory, home</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directory_002c-platform_002dspecific">directory, platform-specific</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-directory_002c-site_002dlocal">directory, site-local</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-directory_002c-site_002dlocal-1">directory, site-local</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-disabling-hyphenation-_0028_005c_0025_0029">disabling hyphenation (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-disabling-_005c-_0028eo_0029">disabling <code class="code">\</code> (<code class="code">eo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-discardable-horizontal-space">discardable horizontal space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Displays-and-Keeps.html#index-displays">displays</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Displays-and-Keeps.html">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-displays-_005bms_005d">displays <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-displays_002c-and-footnotes-_005bms_005d">displays, and footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-distance-to-next-vertical-position-trap-register-_0028_002et_0029">distance to next vertical position trap register (<code class="code">.t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Deferring-Output.html#index-diversion">diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Deferring-Output.html">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion-name-register-_0028_002ez_0029">diversion name register (<code class="code">.z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-diversion-trap_002c-setting-_0028dt_0029">diversion trap, setting (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-diversion-traps">diversion traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-appending-to-_0028da_002c-boxa_0029">diversion, appending to (<code class="code">da</code>, <code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-beginning-_0028di_002c-box_0029">diversion, beginning (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-diversion_002c-creating-alias-for-_0028als_0029">diversion, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-ending-_0028di_002c-box_0029">diversion, ending (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-nested">diversion, nested</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-diversion_002c-removing-_0028rm_0029">diversion, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-diversion_002c-removing-alias-for-_0028rm_0029">diversion, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-diversion_002c-renaming-_0028rn_0029">diversion, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-diversion_002c-stripping-final-newline">diversion, stripping final newline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-top_002dlevel">diversion, top-level</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-diversion_002c-top_002dlevel_002c-and-bp">diversion, top-level, and <code class="code">bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-top_002dlevel_002c-and-_005c_0021">diversion, top-level, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-top_002dlevel_002c-and-_005c_003f">diversion, top-level, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-unformatting-_0028asciify_0029">diversion, unformatting (<code class="code">asciify</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversion_002c-vertical-position-in_002c-register-_0028_002ed_0029">diversion, vertical position in, register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-diversions">diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-diversions-1">diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-diversions_002c-and-traps">diversions, and traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-diversions_002c-shared-name-space-with-macros-and-strings">diversions, shared name space with macros and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-division_002c-truncating">division, truncating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-dl-register_002c-and-da-_0028boxa_0029"><code class="code">dl</code> register, and <code class="code">da</code> (<code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-dn-register_002c-and-da-_0028boxa_0029"><code class="code">dn</code> register, and <code class="code">da</code> (<code class="code">boxa</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-document-description-macros_002c-_005bms_005d">document description macros, <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Document-Formats.html#index-document-formats">document formats</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Document-Formats.html">Document Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-documents_002c-multi_002dfile">documents, multi-file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-documents_002c-structuring-the-source-of">documents, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-dot_002c-as-delimiter">dot, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-double-quote_002c-embedding-in-a-macro-argument">double quote, embedding in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-double-quotes_002c-trailing_002c-in-strings">double quotes, trailing, in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-double_002dspacing-_0028ls_0029">double-spacing (<code class="code">ls</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-double_002dspacing-_0028vs_002c-pvs_0029">double-spacing (<code class="code">vs</code>, <code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-down_002dcasing-a-string-_0028stringdown_0029">down-casing a string (<code class="code">stringdown</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-filled-circle-_0028_005cD_0027C-_2026_0027_0029">drawing a filled circle (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-filled-ellipse-_0028_005cD_0027E-_2026_0027_0029">drawing a filled ellipse (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-filled-polygon-_0028_005cD_0027P-_2026_0027_0029">drawing a filled polygon (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-line-_0028_005cD_0027l-_2026_0027_0029">drawing a line (&lsquo;<samp class="samp">\D'l &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-solid-circle-_0028_005cD_0027C-_2026_0027_0029">drawing a solid circle (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-solid-ellipse-_0028_005cD_0027E-_2026_0027_0029">drawing a solid ellipse (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-solid-polygon-_0028_005cD_0027P-_2026_0027_0029">drawing a solid polygon (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029">drawing a spline (&lsquo;<samp class="samp">\D'~ &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-stroked-circle-_0028_005cD_0027c-_2026_0027_0029">drawing a stroked circle (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-stroked-ellipse-_0028_005cD_0027e-_2026_0027_0029">drawing a stroked ellipse (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-a-stroked-polygon-_0028_005cD_0027p-_2026_0027_0029">drawing a stroked polygon (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-an-arc-_0028_005cD_0027a-_2026_0027_0029">drawing an arc (&lsquo;<samp class="samp">\D'a &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-an-outlined-circle-_0028_005cD_0027c-_2026_0027_0029">drawing an outlined circle (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-an-outlined-ellipse-_0028_005cD_0027e-_2026_0027_0029">drawing an outlined ellipse (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-an-outlined-polygon-_0028_005cD_0027p-_2026_0027_0029">drawing an outlined polygon (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-horizontal-lines-_0028_005cl_0029">drawing horizontal lines (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-drawing-position">drawing position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-drawing-position_002c-vertical-_0028nl_0029">drawing position, vertical (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-requests">drawing requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-drawing-vertical-lines-_0028_005cL_0029">drawing vertical lines (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-ds-request_002c-and-comments"><code class="code">ds</code> request, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-ds-request_002c-and-double-quotes"><code class="code">ds</code> request, and double quotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-ds-request_002c-and-leading-spaces"><code class="code">ds</code> request, and leading spaces</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-ds_002c-ds1-requests_002c-and-comments"><code class="code">ds</code>, <code class="code">ds1</code> requests, and comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-ds_002c-ds1-requests_002c-and-warnings"><code class="code">ds</code>, <code class="code">ds1</code> requests, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-dummy-character-_0028_005c_0026_0029">dummy character (<code class="code">\&amp;</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-dummy-character-_0028_005c_0026_0029_002c-as-control-character-suppressor">dummy character (<code class="code">\&amp;</code>), as control character suppressor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-dummy-character-_0028_005c_0026_0029_002c-effect-on-kerning">dummy character (<code class="code">\&amp;</code>), effect on kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-dummy-character-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence">dummy character (<code class="code">\&amp;</code>), effect on <code class="code">\l</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-dummy-character_002c-transparent-_0028_005c_0029_0029">dummy character, transparent (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-dummy-environment_002c-used-by-_005cw-escape-sequence">dummy environment, used by <code class="code">\w</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-dumping-environments-_0028pev_0029">dumping environments (<code class="code">pev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-dumping-page-location-traps-_0028ptr_0029">dumping page location traps (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-dumping-registers-_0028pnr_0029">dumping registers (<code class="code">pnr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-dumping-symbol-table-_0028pm_0029">dumping symbol table (<code class="code">pm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-EBCDIC-output-encoding"><abbr class="acronym">EBCDIC</abbr> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-EBCDIC_002c-input-encoding"><abbr class="acronym">EBCDIC</abbr>, input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-ejection_002c-page">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-ejection_002c-page-1">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-ejection_002c-page-2">ejection, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-ejection_002c-page_002c-of-final-page">ejection, page, of final page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-ejection_002c-page_002c-prevented-by-vpt">ejection, page, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-el-request_002c-and-warnings"><code class="code">el</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">ellipse, filled, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-ellipse_002c-outlined_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">ellipse, outlined, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-ellipse_002c-solid_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">ellipse, solid, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">ellipse, stroked, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-em-glyph_002c-and-cflags"><code class="code">em</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-em-scaling-unit-_0028m_0029">em scaling unit (<code class="code">m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-embolding-of-special-fonts">embolding of special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-empty-line">empty line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-en-scaling-unit-_0028n_0029">en scaling unit (<code class="code">n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-enabling-vertical-position-traps-_0028vpt_0029">enabling vertical position traps (<code class="code">vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-code-page-1047">encoding, input, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-EBCDIC">encoding, input, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029">encoding, input, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029">encoding, input, <span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029">encoding, input, <span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029">encoding, input, <span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-ASCII">encoding, output, <abbr class="acronym">ASCII</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-code-page-1047">encoding, output, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-EBCDIC">encoding, output, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-ISO-646">encoding, output, ISO&nbsp;646</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029">encoding, output, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-encoding_002c-output_002c-UTF_002d8">encoding, output, <span class="w-nolinebreak-text">UTF-8</span></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-end-of-conditional-block-_0028_005c_007d_0029">end of conditional block (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-end_002dof_002dinput-macro-_0028em_0029">end-of-input macro (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-end_002dof_002dinput-trap_002c-setting-_0028em_0029">end-of-input trap, setting (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-end_002dof_002dinput-traps">end-of-input traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-end_002dof_002dsentence-characters">end-of-sentence characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-end_002dof_002dsentence-characters-1">end-of-sentence characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-end_002dof_002dsentence-transparent-characters">end-of-sentence transparent characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-ending-diversion-_0028di_002c-box_0029">ending diversion (<code class="code">di</code>, <code class="code">box</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Footnotes-and-Endnotes.html#index-endnotes">endnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Footnotes-and-Endnotes.html">Footnotes and Endnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Deferring-Output.html#index-environment">environment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Deferring-Output.html">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-environment-availability-and-naming_002c-incompatibilities-with">environment availability and naming, incompatibilities with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environment-number_002fname-register-_0028_002eev_0029">environment number/name register (<code class="code">.ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-environment-variables">environment variables</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environment_002c-copying-_0028evc_0029">environment, copying (<code class="code">evc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environment_002c-dimensions-of-last-glyph-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">environment, dimensions of last glyph (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-environment_002c-dummy_002c-used-by-_005cw-escape-sequence">environment, dummy, used by <code class="code">\w</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environment_002c-previous-line-length-_0028_002en_0029">environment, previous line length (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environment_002c-switching-_0028ev_0029">environment, switching (<code class="code">ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-environments">environments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-environments_002c-dumping-_0028pev_0029">environments, dumping (<code class="code">pev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-equality-operator">equality operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-equation-example-_005bms_005d">equation example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-equations-_005bms_005d">equations <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-escape-character_002c-changing-_0028ec_0029">escape character, changing (<code class="code">ec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-escape-character_002c-formatting-_0028_005ce_0029">escape character, formatting (<code class="code">\e</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-escape-character_002c-while-defining-glyph">escape character, while defining glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Formatter-Instructions.html#index-escape-sequence">escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Formatter-Instructions.html">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-escape-sequence-argument-delimiters">escape sequence argument delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-escape-sequences">escape sequences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-escape-sequences_002c-brace-_0028_005c_007b_002c-_005c_007d_0029">escape sequences, brace (<code class="code">\{</code>, <code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-escaping-newline-characters_002c-in-strings">escaping newline characters, in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-ex-request_002c-use-in-debugging"><code class="code">ex</code> request, use in debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-ex-request_002c-used-with-nx-and-rd"><code class="code">ex</code> request, used with <code class="code">nx</code> and <code class="code">rd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-example-markup_002c-bulleted-list-_005bms_005d">example markup, bulleted list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-example-markup_002c-cover-page-in-_005bms_005d">example markup, cover page in <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-example-markup_002c-glossary_002dstyle-list-_005bms_005d">example markup, glossary-style list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-example-markup_002c-numbered-list-_005bms_005d">example markup, numbered list <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invocation-Examples.html#index-examples-of-invocation">examples of invocation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invocation-Examples.html">Invocation Examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-exiting-_0028ex_0029">exiting (<code class="code">ex</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-expansion-of-strings-_0028_005c_002a_0029">expansion of strings (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-explicit-hyphen-_0028_005c_0025_0029">explicit hyphen (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-explicit-hyphenation">explicit hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-expression_002c-limitation-of-logical-not-in">expression, limitation of logical not in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-expression_002c-order-of-evaluation">expression, order of evaluation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-expressions_002c-and-register-format">expressions, and register format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-expressions_002c-and-space-characters">expressions, and space characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-expressions_002c-conditional">expressions, conditional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-expressions_002c-numeric">expressions, numeric</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-extra-post_002dvertical-line-space-_0028_005cx_0029">extra post-vertical line space (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-extra-post_002dvertical-line-space-register-_0028_002ea_0029">extra post-vertical line space register (<code class="code">.a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-extra-pre_002dvertical-line-space-_0028_005cx_0029">extra pre-vertical line space (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Adjustment.html#index-extra-spaces-between-words">extra spaces between words</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Adjustment.html">Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-extreme-values-representable-with-Roman-numerals">extreme values representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-extremum-operators-_0028_003e_003f_002c-_003c_003f_0029">extremum operators (<code class="code">&gt;?</code>, <code class="code">&lt;?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-f-scaling-unit"><code class="code">f</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-factor_002c-zoom_002c-of-a-font-_0028fzoom_0029">factor, zoom, of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fallback-character_002c-defining-_0028fchar_002c-fschar_002c-schar_0029">fallback character, defining (<code class="code">fchar</code>, <code class="code">fschar</code>, <code class="code">schar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fallback-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029">fallback glyph, removing definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-fam-request_002c-and-changing-fonts"><code class="code">fam</code> request, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-families_002c-font">families, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-family_002c-font">family, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Common-Features.html#index-features_002c-common">features, common</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Common-Features.html">Common Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-fi-request_002c-causing-implicit-break"><code class="code">fi</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-field-delimiting-character-_0028fc_0029">field delimiting character (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-field-padding-character-_0028fc_0029">field padding character (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-fields">fields</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-fields_002c-and-tabs">fields, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-figure-space-_0028_005c0_0029">figure space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-figures-_005bms_005d">figures <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="File-Formats.html#index-file-formats">file formats</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="File-Formats.html">File Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-file-names_002c-breaking-_0028_005c_003a_0029">file names, breaking (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-appending-to-_0028opena_0029">file, appending to (<code class="code">opena</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-closing-_0028close_0029">file, closing (<code class="code">close</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-file_002c-font-description">file, font description</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-inclusion-_0028so_0029">file, inclusion (<code class="code">so</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-file_002c-macro_002c-search-path">file, macro, search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-opening-_0028open_0029">file, opening (<code class="code">open</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-processing-next-_0028nx_0029">file, processing next (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-file_002c-writing-to-_0028write_002c-writec_0029">file, writing to (<code class="code">write</code>, <code class="code">writec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Device-and-Font-Description-Files.html#index-files_002c-font">files, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-fill-color">fill color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-fill-color-name-register-_0028_002eM_0029">fill color name register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-fill-mode-_0028fi_0029_002c-enabling">fill mode (<code class="code">fi</code>), enabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-fill-mode_002c-and-_005cc">fill mode, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-fill-mode_002c-disabling">fill mode, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-filled-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">filled circle, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-filled-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">filled ellipse, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-filled-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">filled polygon, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Filling.html#index-filling">filling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Filling.html">Filling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-filling-and-adjustment_002c-manipulating">filling and adjustment, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-filling-of-output_002c-disabling-_0028nf_0029">filling of output, disabling (<code class="code">nf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-filling-of-output_002c-enabling-_0028fi_0029">filling of output, enabling (<code class="code">fi</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-filling_002c-and-break-warnings">filling, and <code class="code">break</code> warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-filling_002c-and-inter_002dsentence-space">filling, and inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-final-newline_002c-stripping-in-diversions">final newline, stripping in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-fl-request_002c-causing-implicit-break"><code class="code">fl</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Displays-and-Keeps.html#index-floating-keep">floating keep</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Displays-and-Keeps.html">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-flush-output-_0028fl_0029">flush output (<code class="code">fl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font">font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-font-aliasing-with-third-argument-to-fp-request">font aliasing with third argument to <code class="code">fp</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font-description-file">font description file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-font-description-file-format">font description file format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-font-description-file_002c-format">font description file, format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-font-description-files_002c-comments">font description files, comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-font-directories">font directories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-font-families">font families</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font-family">font family</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-font-family_002c-changing-_0028fam_002c-_005cF_0029">font family, changing (<code class="code">fam</code>, <code class="code">\F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-font-file_002c-format">font file, format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Device-and-Font-Description-Files.html#index-font-files">font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-font-for-underlining-_0028uf_0029">font for underlining (<code class="code">uf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-font-height_002c-changing-_0028_005cH_0029">font height, changing (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font-metrics">font metrics</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font-mounting_002c-automatic">font mounting, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-font-path">font path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-font-position-register-_0028_002ef_0029">font position register (<code class="code">.f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-font-positions">font positions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-font-slant_002c-changing-_0028_005cS_0029">font slant, changing (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font-style">font style</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font-style_002c-abstract">font style, abstract</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-font-style_002c-abstract_002c-setting-up-_0028sty_0029">font style, abstract, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-font-styles">font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font-translation-_0028ftr_0029">font translation (<code class="code">ftr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-magnification-_0028fzoom_0029">font, magnification (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-font_002c-mounting-_0028fp_0029">font, mounting (<code class="code">fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-optical-size">font, optical size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-previous_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029">font, previous, selecting (<code class="code">\f</code>, <code class="code">\fP</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-previous_002c-slecting-_0028ft_0029">font, previous, slecting (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-selection">font, selection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font_002c-special">font, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font_002c-text">font, text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-font_002c-unstyled">font, unstyled</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-font_002c-zoom-factor-_0028fzoom_0029">font, zoom factor (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-fonts_002c-artificial">fonts, artificial</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-fonts_002c-changing-_0028ft_002c-_005cf_0029">fonts, changing (<code class="code">ft</code>, <code class="code">\f</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-fonts_002c-searching">fonts, searching</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-fonts_002c-special">fonts, special</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-footers">footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-footers-1">footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-footers-_005bms_005d">footers <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-footnote-marker-_005bms_005d">footnote marker <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Footnotes-and-Endnotes.html#index-footnotes">footnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Footnotes-and-Endnotes.html">Footnotes and Endnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-footnotes-_005bms_005d">footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-footnotes_002c-and-displays-_005bms_005d">footnotes, and displays <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-footnotes_002c-and-keeps-_005bms_005d">footnotes, and keeps <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-form-letters">form letters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-format-of-font-description-file">format of font description file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-format-of-font-description-files">format of font description files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-format-of-font-files">format of font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-format-of-register-_0028_005cg_0029">format of register (<code class="code">\g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-format_002c-paper">format, paper</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="File-Formats.html#index-formats_002c-file">formats, file</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="File-Formats.html">File Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Formatter-Instructions.html#index-formatter-instructions">formatter instructions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Formatter-Instructions.html">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-formatting-a-backslash-glyph-_0028_005c_005brs_005d_0029">formatting a backslash glyph (<code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-formatting-a-title-line-_0028tl_0029">formatting a title line (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-formatting-the-escape-character-_0028_005ce_0029">formatting the escape character (<code class="code">\e</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-formatting-the-time">formatting the time</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-fp-request_002c-and-font-translations"><code class="code">fp</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-fp-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">fp</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-fractional-point-sizes">fractional point sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-fractional-point-sizes-1">fractional point sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-fractional-type-sizes">fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-fractional-type-sizes-1">fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Differences-from-AT_0026T-ms.html#index-fractional-type-sizes-in-ms-macros">fractional type sizes in <samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Differences-from-AT_0026T-ms.html">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-French-spacing">French spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-fspecial-request_002c-and-font-styles"><code class="code">fspecial</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-fspecial-request_002c-and-font-translations"><code class="code">fspecial</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fspecial-request_002c-and-glyph-search-order"><code class="code">fspecial</code> request, and glyph search order</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-fspecial-request_002c-and-imitating-bold"><code class="code">fspecial</code> request, and imitating bold</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-ft-request_002c-and-font-translations"><code class="code">ft</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-full_002dservice-macro-package">full-service macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-geometry_002c-page">geometry, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-GGL-_0028groff-glyph-list_0029">GGL (<code class="code">groff</code> glyph list)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-GGL-_0028groff-glyph-list_0029-1">GGL (<code class="code">groff</code> glyph list)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-glossary_002dstyle-list_002c-example-markup-_005bms_005d">glossary-style list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph">glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-glyph-for-line-drawing">glyph for line drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph-names_002c-composite">glyph names, composite</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-glyph-pile-_0028_005cb_0029">glyph pile (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph-properties-_0028cflags_0029">glyph properties (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-glyph_002c-box-rule-_0028_005c_005bbr_005d_0029">glyph, box rule (<code class="code">\br</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-glyph_002c-constant-space">glyph, constant space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph_002c-defining-_0028char_0029">glyph, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph_002c-distinguished-from-character">glyph, distinguished from character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-glyph_002c-for-line-drawing">glyph, for line drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-glyph_002c-for-margins-_0028mc_0029">glyph, for margins (<code class="code">mc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-glyph_002c-last_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">glyph, last, dimensions (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-glyph_002c-leader-repetition-_0028lc_0029">glyph, leader repetition (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-glyph_002c-numbered-_0028_005cN_0029">glyph, numbered (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph_002c-numbered-_0028_005cN_0029-1">glyph, numbered (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029">glyph, removing definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-glyph_002c-soft-hyphen-_0028hy_0029">glyph, soft hyphen (<code class="code">hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-glyph_002c-tab-repetition-_0028tc_0029">glyph, tab repetition (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-glyph_002c-underscore-_0028_005c_005bru_005d_0029">glyph, underscore (<code class="code">\ru</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyphs_002c-available_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">glyphs, available, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-glyphs_002c-output_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff">glyphs, output, and input characters, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-glyphs_002c-overstriking-_0028_005co_0029">glyphs, overstriking (<code class="code">\o</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-glyphs_002c-unnamed">glyphs, unnamed</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-glyphs_002c-unnamed_002c-accessing-with-_005cN">glyphs, unnamed, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-GNU-troff_002c-identification-register-_0028_002eg_0029">GNU <code class="code">troff</code>, identification register (<code class="code">.g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-GNU-troff_002c-PID-register-_0028_0024_0024_0029">GNU <code class="code">troff</code>, PID register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-GNU-troff_002c-process-ID-register-_0028_0024_0024_0029">GNU <code class="code">troff</code>, process ID register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-GNU_002dspecific-register-_0028_002eg_0029">GNU-specific register (<code class="code">.g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-graphic-renditions">graphic renditions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-greater-than-_0028or-equal-to_0029-operator">greater than (or equal to) operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="groff-Capabilities.html#index-groff-capabilities"><code class="code">groff</code> capabilities</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="groff-Capabilities.html"><code class="code">groff</code> Capabilities</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-groff-glyph-list-_0028GGL_0029"><code class="code">groff</code> glyph list (GGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-groff-glyph-list-_0028GGL_0029-1"><code class="code">groff</code> glyph list (GGL)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-groff.html#index-groff-invocation"><code class="code">groff</code> invocation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-groff.html">Invoking groff</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-groff_002c-and-pi-request"><code class="code">groff</code>, and <code class="code">pi</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="What-Is-groff_003f.html#index-groff_002d_002d_002dwhat-is-it_003f"><code class="code">groff</code>&mdash;what is it?</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="What-Is-groff_003f.html">What Is <code class="code">groff</code>?</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fBIN_005fPATH_002c-environment-variable"><code>GROFF_BIN_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable"><code>GROFF_COMMAND_PREFIX<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fENCODING_002c-environment-variable"><code>GROFF_ENCODING<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fFONT_005fPATH_002c-environment-variable"><code>GROFF_FONT_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-GROFF_005fFONT_005fPATH_002c-environment-variable-1"><code>GROFF_FONT_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fTMAC_005fPATH_002c-environment-variable"><code>GROFF_TMAC_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-GROFF_005fTMAC_005fPATH_002c-environment-variable-1"><code>GROFF_TMAC_PATH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fTMPDIR_002c-environment-variable"><code>GROFF_TMPDIR<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-GROFF_005fTYPESETTER_002c-environment-variable"><code>GROFF_TYPESETTER<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-grohtml_002c-the-program"><code class="code">grohtml</code>, the program</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-gtroff_002c-interactive-use"><code class="code">gtroff</code>, interactive use</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-gtroff_002c-output"><code class="code">gtroff</code>, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="GNU-troff-Reference.html#index-gtroff_002c-reference"><code class="code">gtroff</code>, reference</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="GNU-troff-Reference.html">GNU troff Reference</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-hair-space-_0028_005c_005e_0029">hair space (<code class="code">\^</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-hcode-request_002c-and-glyph-definitions"><code class="code">hcode</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-headers">headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-headers-1">headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-headers-_005bms_005d">headers <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-height_002c-font_002c-changing-_0028_005cH_0029">height, font, changing (<code class="code">\H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-height_002c-of-last-glyph-_0028_002echt_0029">height, of last glyph (<code class="code">.cht</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-high_002dwater-mark-register-_0028_002eh_0029">high-water mark register (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-home-directory">home directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-horizontal-discardable-space">horizontal discardable space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-horizontal-input-line-position-register-_0028hp_0029">horizontal input line position register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-horizontal-input-line-position_002c-saving-_0028_005ck_0029">horizontal input line position, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-horizontal-line_002c-drawing-_0028_005cl_0029">horizontal line, drawing (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-horizontal-motion-_0028_005ch_0029">horizontal motion (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-horizontal-motion-quantum">horizontal motion quantum</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-horizontal-motion-quantum-register-_0028_002eH_0029">horizontal motion quantum register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-horizontal-output-line-position-register-_0028_002ek_0029">horizontal output line position register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-horizontal-resolution">horizontal resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-horizontal-resolution-register-_0028_002eH_0029">horizontal resolution register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-horizontal-space-_0028_005ch_0029">horizontal space (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-horizontal-space_002c-unformatting">horizontal space, unformatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-horizontal-tab-character">horizontal tab character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-hours_002c-current-time-_0028hours_0029">hours, current time (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hpf-request_002c-and-hyphenation-language"><code class="code">hpf</code> request, and hyphenation language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hw-request_002c-and-hy-restrictions"><code class="code">hw</code> request, and <code class="code">hy</code> restrictions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hw-request_002c-and-hyphenation-language"><code class="code">hw</code> request, and hyphenation language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-hy-glyph_002c-and-cflags"><code class="code">hy</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphen_002c-explicit-_0028_005c_0025_0029">hyphen, explicit (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenated-lines_002c-consecutive-_0028hlm_0029">hyphenated lines, consecutive (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-hyphenating-characters">hyphenating characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Hyphenation.html#index-hyphenation">hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Hyphenation.html">Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-character-_0028_005c_0025_0029">hyphenation character (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-code-_0028hcode_0029">hyphenation code (<code class="code">hcode</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-consecutive-line-count-register-_0028_002ehlc_0029">hyphenation consecutive line count register (<code class="code">.hlc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-consecutive-line-limit-register-_0028_002ehlm_0029">hyphenation consecutive line limit register (<code class="code">.hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-exceptions">hyphenation exceptions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-language-register-_0028_002ehla_0029">hyphenation language register (<code class="code">.hla</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-margin-_0028hym_0029">hyphenation margin (<code class="code">hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-margin-register-_0028_002ehym_0029">hyphenation margin register (<code class="code">.hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-mode-register-_0028_002ehy_0029">hyphenation mode register (<code class="code">.hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-parameters_002c-automatic">hyphenation parameters, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-pattern-files">hyphenation pattern files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-patterns-_0028hpf_0029">hyphenation patterns (<code class="code">hpf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-space-_0028hys_0029">hyphenation space (<code class="code">hys</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-space-adjustment-threshold">hyphenation space adjustment threshold</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation-space-adjustment-threshold-register-_0028_002ehys_0029">hyphenation space adjustment threshold register (<code class="code">.hys</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation_002c-automatic">hyphenation, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation_002c-disabling-_0028_005c_0025_0029">hyphenation, disabling (<code class="code">\%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation_002c-explicit">hyphenation, explicit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-hyphenation_002c-incompatibilities-with-AT_0026T-troff">hyphenation, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation_002c-manipulating">hyphenation, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hyphenation_002c-manual">hyphenation, manual</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-i-scaling-unit"><code class="code">i</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-i_002fo">i/o</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-IBM-code-page-1047-input-encoding">IBM code page 1047 input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-IBM-code-page-1047-output-encoding">IBM code page 1047 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-identifiers">identifiers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-identifiers_002c-undefined">identifiers, undefined</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-ie-request_002c-and-font-translations"><code class="code">ie</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-ie-request_002c-and-warnings"><code class="code">ie</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-ie-request_002c-operators-to-use-with"><code class="code">ie</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-if-request_002c-and-font-translations"><code class="code">if</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-if-request_002c-and-the-_0021-operator"><code class="code">if</code> request, and the &lsquo;<samp class="samp">!</samp>&rsquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-if-request_002c-operators-to-use-with"><code class="code">if</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002delse.html#index-if_002delse">if-else</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002delse.html">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002dthen.html#index-if_002dthen">if-then</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002dthen.html">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-imitating-boldface-_0028bd_0029">imitating boldface (<code class="code">bd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Implementation-Differences.html#index-implementation-differences">implementation differences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Implementation-Differences.html">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-implicit-line-break">implicit line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-implicit-trap">implicit trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-in-request_002c-causing-implicit-break"><code class="code">in</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-in-request_002c-using-_002b-and-_002d-with"><code class="code">in</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-inch-scaling-unit-_0028i_0029">inch scaling unit (<code class="code">i</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-including-a-file-_0028so_0029">including a file (<code class="code">so</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Implementation-Differences.html#index-incompatibilities-with-AT_0026T-troff">incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Implementation-Differences.html">Implementation Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-increment-value-without-changing-the-register">increment value without changing the register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-incrementation_002c-automatic_002c-of-a-register">incrementation, automatic, of a register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-indentation-_0028in_0029">indentation (<code class="code">in</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-indentation_002c-of-roff-source-code">indentation, of <code class="code">roff</code> source code</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indexing.html#index-index_002c-in-macro-package">index, in macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indexing.html">Indexing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-indicator_002c-scaling">indicator, scaling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-indirect-assignments">indirect assignments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-input-and-output-requests">input and output requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-input-characters-and-output-glyphs_002c-compatibility-with-AT_0026T-troff">input characters and output glyphs, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-input-characters_002c-invalid">input characters, invalid</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Conventions.html#index-input-conventions">input conventions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Conventions.html">Input Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-code-page-1047">input encoding, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-EBCDIC">input encoding, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029">input encoding, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-Latin_002d2-_0028ISO-8859_002d2_0029">input encoding, <span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-Latin_002d5-_0028ISO-8859_002d9_0029">input encoding, <span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-input-encoding_002c-Latin_002d9-_0028ISO-8859_002d15_0029">input encoding, <span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-input-file-name_002c-current_002c-register-_0028_002eF_0029">input file name, current, register (<code class="code">.F</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-input-level">input level</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-input-level-in-delimited-arguments">input level in delimited arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-input-line-continuation-_0028_005cRET_0029">input line continuation (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-input-line-number-register-_0028_002ec_002c-c_002e_0029">input line number register (<code class="code">.c</code>, <code class="code">c.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-input-line-number_002c-setting-_0028lf_0029">input line number, setting (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-input-line-position_002c-horizontal_002c-saving-_0028_005ck_0029">input line position, horizontal, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-input-line-trap_002c-clearing-_0028it_002c-itc_0029">input line trap, clearing (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-input-line-trap_002c-setting-_0028it_002c-itc_0029">input line trap, setting (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-input-line-traps">input line traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-input-line-traps-and-interrupted-lines-_0028itc_0029">input line traps and interrupted lines (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-input-line_002c-horizontal-position_002c-register-_0028hp_0029">input line, horizontal position, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-input-line_002c-productive">input line, productive</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-input-stack_002c-backtrace-_0028backtrace_0029">input stack, backtrace (<code class="code">backtrace</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-input-stack_002c-setting-limit">input stack, setting limit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-input-token">input token</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-input_002c-8_002dbit">input, 8-bit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-input_002c-standard_002c-reading-from-_0028rd_0029">input, standard, reading from (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-inserting-horizontal-space-_0028_005ch_0029">inserting horizontal space (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Installation.html#index-installation">installation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Installation.html">Installation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Formatter-Instructions.html#index-instructing-the-formatter">instructing the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Formatter-Instructions.html">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-inter_002dsentence-space-size-register-_0028_002esss_0029">inter-sentence space size register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-inter_002dsentence-space_002c-additional">inter-sentence space, additional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-inter_002dword-spacing_002c-minimal">inter-word spacing, minimal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-interactive-use-of-gtroff">interactive use of <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-intercepting-requests">intercepting requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-intermediate-output">intermediate output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-interpolating-registers-_0028_005cn_0029">interpolating registers (<code class="code">\n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-interpolation">interpolation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-interpolation-depth">interpolation depth</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-interpolation-depth-in-delimited-arguments">interpolation depth in delimited arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-interpolation-of-strings-_0028_005c_002a_0029">interpolation of strings (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-interpretation-mode">interpretation mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-interrupted-line">interrupted line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-interrupted-line-register-_0028_002eint_0029">interrupted line register (<code class="code">.int</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-interrupted-lines-and-input-line-traps-_0028itc_0029">interrupted lines and input line traps (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Introduction.html#index-introduction">introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Introduction.html">Introduction</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-invalid-characters-for-trf-request">invalid characters for <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-invalid-input-characters">invalid input characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invocation-Examples.html#index-invocation-examples">invocation examples</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invocation-Examples.html">Invocation Examples</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-groff.html#index-invoking-groff">invoking <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-groff.html">Invoking groff</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-invoking-requests">invoking requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-ISO-646-output-encoding">ISO&nbsp;646 output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-ISO-8859_002d1-_0028Latin_002d1_0029-output-encoding">ISO <span class="w-nolinebreak-text">8859-1</span> (<span class="w-nolinebreak-text">Latin-1</span>) output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-ISO-8859_002d1-_0028Latin_002d1_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-1</span> (<span class="w-nolinebreak-text">Latin-1</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-ISO-8859_002d15-_0028Latin_002d9_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-15</span> (<span class="w-nolinebreak-text">Latin-9</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-ISO-8859_002d2-_0028Latin_002d2_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-2</span> (<span class="w-nolinebreak-text">Latin-2</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-ISO-8859_002d9-_0028Latin_002d5_0029_002c-input-encoding">ISO <span class="w-nolinebreak-text">8859-9</span> (<span class="w-nolinebreak-text">Latin-5</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-italic-correction-_0028_005c_002f_0029">italic correction (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-J">J</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-justifying-text">justifying text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-justifying-text-_0028rj_0029">justifying text (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Displays-and-Keeps.html#index-keep_002c-floating">keep, floating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Displays-and-Keeps.html">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Displays-and-Keeps.html#index-keeps-_0028introduction_0029">keeps (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Displays-and-Keeps.html">Displays and Keeps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-keeps-_005bms_005d">keeps <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-keeps_002c-and-footnotes-_005bms_005d">keeps, and footnotes <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-kerning-and-ligatures">kerning and ligatures</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-kerning-enabled-register-_0028_002ekern_0029">kerning enabled register (<code class="code">.kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-kerning_002c-activating-_0028kern_0029">kerning, activating (<code class="code">kern</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-kerning_002c-track">kerning, track</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-landscape-page-orientation">landscape page orientation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-language-_005bms_005d">language <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-last-glyph_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029">last glyph, dimensions (<code class="code">.w</code>, <code class="code">.cht</code>, <code class="code">.cdp</code>, <code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-last_002drequested-point-size-registers-_0028_002epsr_002c-_002esr_0029">last-requested point size registers (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-last_002drequested-type-size-registers-_0028_002epsr_002c-_002esr_0029">last-requested type size registers (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-Latin_002d1-_0028ISO-8859_002d1_0029-output-encoding"><span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>) output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-Latin_002d1-_0028ISO-8859_002d1_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-Latin_002d2-_0028ISO-8859_002d2_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-2</span> (ISO <span class="w-nolinebreak-text">8859-2</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-Latin_002d5-_0028ISO-8859_002d9_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-5</span> (ISO <span class="w-nolinebreak-text">8859-9</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-Latin_002d9-_0028ISO-8859_002d15_0029_002c-input-encoding"><span class="w-nolinebreak-text">Latin-9</span> (ISO <span class="w-nolinebreak-text">8859-15</span>), input encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-layout_002c-line">layout, line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-layout_002c-page">layout, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-lc-request_002c-and-glyph-definitions"><code class="code">lc</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-leader-character">leader character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-leader-character-1">leader character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-leader-character_002c-and-translations">leader character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-leader-character_002c-non_002dinterpreted-_0028_005ca_0029">leader character, non-interpreted (<code class="code">\a</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-leader-repetition-character-_0028lc_0029">leader repetition character (<code class="code">lc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-leaders">leaders</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-leading">leading</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-leading-space-macro-_0028lsm_0029">leading space macro (<code class="code">lsm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-leading-space-traps">leading space traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-leading-spaces">leading spaces</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-leading-spaces-macro-_0028lsm_0029">leading spaces macro (<code class="code">lsm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-leading-spaces-with-ds">leading spaces with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-left-italic-correction-_0028_005c_002c_0029">left italic correction (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-left-margin-_0028po_0029">left margin (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-length-of-a-string-_0028length_0029">length of a string (<code class="code">length</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-length-of-line-_0028ll_0029">length of line (<code class="code">ll</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-length-of-previous-line-_0028_002en_0029">length of previous line (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-length-of-the-page_002c-configuring-_0028pl_0029">length of the page, configuring (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-length-of-title-line_002c-configuring-_0028lt_0029">length of title line, configuring (<code class="code">lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-length-request_002c-and-copy-mode"><code class="code">length</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-less-than-_0028or-equal-to_0029-operator">less than (or equal to) operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-letters_002c-form">letters, form</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-level_002c-input">level, input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-level_002c-suppression-nesting_002c-register">level, suppression nesting, register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-lf-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">lf</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-ligature">ligature</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-ligatures-and-kerning">ligatures and kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-ligatures-enabled-register-_0028_002elg_0029">ligatures enabled register (<code class="code">.lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-ligatures_002c-activating-_0028lg_0029">ligatures, activating (<code class="code">lg</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-limitations-of-_005cb-escape-sequence">limitations of <code class="code">\b</code> escape sequence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-line-break">line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-line-break-_0028introduction_0029">line break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-line-break_002c-output">line break, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-line-control">line control</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-line-dimensions">line dimensions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line-drawing-glyph">line drawing glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line-drawing-glyph-1">line drawing glyph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-line-indentation-_0028in_0029">line indentation (<code class="code">in</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-line-layout">line layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-line-length-_0028ll_0029">line length (<code class="code">ll</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-line-length-register-_0028_002el_0029">line length register (<code class="code">.l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-line-length_002c-previous-_0028_002en_0029">line length, previous (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-line-number_002c-input_002c-register-_0028_002ec_002c-c_002e_0029">line number, input, register (<code class="code">.c</code>, <code class="code">c.</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-line-number_002c-output_002c-register-_0028ln_0029">line number, output, register (<code class="code">ln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-line-numbers_002c-printing-_0028nm_0029">line numbers, printing (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-line-space_002c-extra-post_002dvertical-_0028_005cx_0029">line space, extra post-vertical (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-line-space_002c-extra-pre_002dvertical-_0028_005cx_0029">line space, extra pre-vertical (<code class="code">\x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-line-spacing-register-_0028_002eL_0029">line spacing register (<code class="code">.L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-line-spacing_002c-post_002dvertical-_0028pvs_0029">line spacing, post-vertical (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line-thickness-_0028_005cD_0027t-_2026_0027_0029">line thickness (&lsquo;<samp class="samp">\D't &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-line_002c-blank">line, blank</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029">line, drawing (&lsquo;<samp class="samp">\D'l &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line_002c-horizontal_002c-drawing-_0028_005cl_0029">line, horizontal, drawing (<code class="code">\l</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-line_002c-input_002c-continuation-_0028_005cRET_0029">line, input, continuation (<code class="code">\<kbd class="key">RET</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-line_002c-input_002c-horizontal-position_002c-register-_0028hp_0029">line, input, horizontal position, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-line_002c-input_002c-horizontal-position_002c-saving-_0028_005ck_0029">line, input, horizontal position, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-line_002c-interrupted">line, interrupted</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-line_002c-output_002c-continuation-_0028_005cc_0029">line, output, continuation (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-line_002c-output_002c-horizontal-position_002c-register-_0028_002ek_0029">line, output, horizontal position, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-line_002c-productive-input">line, productive input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-line_002c-vertical_002c-drawing-_0028_005cL_0029">line, vertical, drawing (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-line_002dtabs-mode">line-tabs mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-lines_002c-blank_002c-disabling">lines, blank, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-lines_002c-centering-_0028ce_0029">lines, centering (<code class="code">ce</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-lines_002c-centering-_0028introduction_0029">lines, centering (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-lines_002c-consecutive-hyphenated-_0028hlm_0029">lines, consecutive hyphenated (<code class="code">hlm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-lines_002c-interrupted_002c-and-input-line-traps-_0028itc_0029">lines, interrupted, and input line traps (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-lines_002c-right_002daligning-_0028introduction_0029">lines, right-aligning (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-lines_002c-right_002djustifying-_0028introduction_0029">lines, right-justifying (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-list-of-special-characters-_0028groff_005fchar_00287_0029-man-page_0029">list of special characters (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-listing-page-location-traps-_0028ptr_0029">listing page location traps (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs.html#index-lists">lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs.html">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-ll-request_002c-using-_002b-and-_002d-with"><code class="code">ll</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-localization">localization</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-localization-_005bms_005d">localization <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-locating-macro-files">locating macro files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-locating-macro-packages">locating macro packages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-location_002c-vertical_002c-page_002c-marking-_0028mk_0029">location, vertical, page, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-location_002c-vertical_002c-page_002c-returning-to-marked-_0028rt_0029">location, vertical, page, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-_0060_0060and_0027_0027-operator">logical &ldquo;and&rdquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-_0060_0060or_0027_0027-operator">logical &ldquo;or&rdquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-complementation-operator">logical complementation operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-conjunction-operator">logical conjunction operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-disjunction-operator">logical disjunction operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-not_002c-limitation-in-expression">logical not, limitation in expression</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-logical-operators">logical operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-long-names">long names</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditionals-and-Loops.html#index-loops-and-conditionals">loops and conditionals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditionals-and-Loops.html">Conditionals and Loops</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-lowercasing-a-string-_0028stringdown_0029">lowercasing a string (<code class="code">stringdown</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-ls-request_002c-alternative-to-_0028pvs_0029"><code class="code">ls</code> request, alternative to (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-lt-request_002c-using-_002b-and-_002d-with"><code class="code">lt</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-m-scaling-unit"><code class="code">m</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-M-scaling-unit"><code class="code">M</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-machine-units">machine units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-macro">macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-macro-arguments">macro arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-macro-arguments_002c-and-compatibility-mode">macro arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-macro-arguments_002c-and-tabs">macro arguments, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-macro-directories">macro directories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-macro-file-search-path">macro file search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-macro-name-register-_0028_005c_00240_0029">macro name register (<code class="code">\$0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-macro-names_002c-starting-with-_005b-or-_005d_002c-and-refer">macro names, starting with <code class="code"></code> or <code class="code"></code>, and <code class="code">refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Packages.html#index-macro-package">macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Packages.html">Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-macro-package-search-path">macro package search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-macro-package-usage_002c-basics-of">macro package usage, basics of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-macro-package_002c-auxiliary">macro package, auxiliary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-macro-package_002c-full_002dservice">macro package, full-service</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Package-Intro.html#index-macro-package_002c-introduction">macro package, introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Package-Intro.html">Macro Package Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-macro-package_002c-major">macro package, major</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-macro-package_002c-minor">macro package, minor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-macro-package_002c-structuring-the-source-of">macro package, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-macro_002c-appending-to-_0028am_0029">macro, appending to (<code class="code">am</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-macro_002c-creating-alias-for-_0028als_0029">macro, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-macro_002c-end_002dof_002dinput-_0028em_0029">macro, end-of-input (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-macro_002c-parameters-_0028_005c_0024_0029">macro, parameters (<code class="code">\$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-macro_002c-removing-_0028rm_0029">macro, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-macro_002c-removing-alias-for-_0028rm_0029">macro, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-macro_002c-renaming-_0028rn_0029">macro, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-macros_002c-recursive">macros, recursive</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-macros_002c-searching">macros, searching</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-macros_002c-shared-name-space-with-strings-and-diversions">macros, shared name space with strings and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tutorial-for-Macro-Users.html#index-macros_002c-tutorial-for-users">macros, tutorial for users</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-macros_002c-writing">macros, writing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-magnification-of-a-font-_0028fzoom_0029">magnification of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-major-macro-package">major macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-major-version-number-register-_0028_002ex_0029">major version number register (<code class="code">.x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-man-macros_002c-custom-headers-and-footers"><code class="code">man</code> macros, custom headers and footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-man-macros_002c-Ultrix_002dspecific"><code class="code">man</code> macros, Ultrix-specific</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="man.html#index-man-pages">man pages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="man.html">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-manipulating-filling-and-adjustment">manipulating filling and adjustment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-manipulating-hyphenation">manipulating hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-manipulating-spacing">manipulating spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-manipulating-type-size-and-vertical-spacing">manipulating type size and vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-manual-hyphenation">manual hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="man.html#index-manual-pages">manual pages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="man.html">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-margin-for-hyphenation-_0028hym_0029">margin for hyphenation (<code class="code">hym</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-margin-glyph-_0028mc_0029">margin glyph (<code class="code">mc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-margin_002c-bottom">margin, bottom</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-margin_002c-left-_0028po_0029">margin, left (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-margin_002c-right">margin, right</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-margin_002c-top">margin, top</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-mark_002c-high_002dwater_002c-register-_0028_002eh_0029">mark, high-water, register (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-marker_002c-footnote-_005bms_005d">marker, footnote <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-marking-vertical-page-location-_0028mk_0029">marking vertical page location (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-maximum-operator">maximum operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-maximum-value-representable-with-Roman-numerals">maximum value representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="mdoc.html#index-mdoc-macros"><code class="code">mdoc</code> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="mdoc.html">mdoc</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="me.html#index-me-macro-package"><code class="code">me</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="me.html">me</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-measurement-units">measurement units</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-measurements">measurements</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Default-Units.html#index-measurements_002c-specifying-safely">measurements, specifying safely</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Default-Units.html">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-metrics_002c-font">metrics, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-minimal-inter_002dword-spacing">minimal inter-word spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-minimum-operator">minimum operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-minimum-value-representable-with-Roman-numerals">minimum value representable with Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-minor-macro-package">minor macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-minor-version-number-register-_0028_002ey_0029">minor version number register (<code class="code">.y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-minutes_002c-current-time-_0028minutes_0029">minutes, current time (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="mm.html#index-mm-macro-package"><code class="code">mm</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="mm.html">mm</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-mode-for-constant-glyph-space-_0028cs_0029">mode for constant glyph space (<code class="code">cs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-mode_002c-compatibility">mode, compatibility</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-mode_002c-compatibility_002c-and-parameters">mode, compatibility, and parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-mode_002c-copy">mode, copy</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-mode_002c-copy-1">mode, copy</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-cf-request">mode, copy, and <code class="code">cf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-mode_002c-copy_002c-and-device-request">mode, copy, and <code class="code">device</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-mode_002c-copy_002c-and-length-request">mode, copy, and <code class="code">length</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-mode_002c-copy_002c-and-macro-parameters">mode, copy, and macro parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-mode_002c-copy_002c-and-output-request">mode, copy, and <code class="code">output</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-trf-request">mode, copy, and <code class="code">trf</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-write-request">mode, copy, and <code class="code">write</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-writec-request">mode, copy, and <code class="code">writec</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-writem-request">mode, copy, and <code class="code">writem</code> request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-mode_002c-copy_002c-and-_005c_0021">mode, copy, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-mode_002c-copy_002c-and-_005c_003f">mode, copy, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-mode_002c-copy_002c-and-_005c_003f-1">mode, copy, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-mode_002c-copy_002c-and-_005ca">mode, copy, and <code class="code">\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-mode_002c-copy_002c-and-_005ct">mode, copy, and <code class="code">\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-copy_002c-and-_005cV">mode, copy, and <code class="code">\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-mode_002c-fill-_0028fi_0029_002c-enabling">mode, fill (<code class="code">fi</code>), enabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-mode_002c-fill_002c-and-break-warnings">mode, fill, and <code class="code">break</code> warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-mode_002c-fill_002c-and-inter_002dsentence-space">mode, fill, and inter-sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-mode_002c-fill_002c-and-_005cc">mode, fill, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-mode_002c-fill_002c-disabling">mode, fill, disabling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-mode_002c-interpretation">mode, interpretation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-mode_002c-line_002dtabs">mode, line-tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-mode_002c-no_002dfill">mode, no-fill</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-mode_002c-no_002dfill_002c-and-_005cc">mode, no-fill, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-mode_002c-no_002dspace-_0028ns_0029">mode, no-space (<code class="code">ns</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-mode_002c-nroff">mode, <code class="code">nroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-mode_002c-safer">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-mode_002c-safer-1">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-mode_002c-safer-2">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-safer-3">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-safer-4">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-safer-5">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-safer-6">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Safer-Mode.html#index-mode_002c-safer-7">mode, safer</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Safer-Mode.html">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-mode_002c-troff">mode, <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-mode_002c-unsafe">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-mode_002c-unsafe-1">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-mode_002c-unsafe-2">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-unsafe-3">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-unsafe-4">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-unsafe-5">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mode_002c-unsafe-6">mode, unsafe</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-modifying-requests">modifying requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-modulus">modulus</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="mom.html#index-mom-macro-package"><code class="code">mom</code> macro package</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="mom.html">mom</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-month-of-the-year-register-_0028mo_0029">month of the year register (<code class="code">mo</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-motion-operators">motion operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-motion-quanta">motion quanta</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-motion-quantum_002c-horizontal">motion quantum, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-motion-quantum_002c-horizontal_002c-register-_0028_002eH_0029">motion quantum, horizontal, register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-motion-quantum_002c-vertical">motion quantum, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-motion_002c-horizontal-_0028_005ch_0029">motion, horizontal (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-motion_002c-vertical-_0028_005cv_0029">motion, vertical (<code class="code">\v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-motions_002c-page">motions, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-mounting-a-font-_0028fp_0029">mounting a font (<code class="code">fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-mounting-position">mounting position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-mounting-position-1">mounting position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-mounting_002c-font_002c-automatic">mounting, font, automatic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms.html#index-ms-macros"><samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms.html">ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-ms-macros_002c-accent-marks"><samp class="file">ms</samp> macros, accent marks</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Body-Text.html#index-ms-macros_002c-body-text"><samp class="file">ms</samp> macros, body text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Body-Text.html">ms Body Text</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-ms-macros_002c-creating-table-of-contents"><samp class="file">ms</samp> macros, creating table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-ms-macros_002c-displays"><samp class="file">ms</samp> macros, displays</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-ms-macros_002c-document-control-settings"><samp class="file">ms</samp> macros, document control settings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-ms-macros_002c-document-description"><samp class="file">ms</samp> macros, document description</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-ms-macros_002c-equations"><samp class="file">ms</samp> macros, equations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-ms-macros_002c-figures"><samp class="file">ms</samp> macros, figures</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-ms-macros_002c-footers"><samp class="file">ms</samp> macros, footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-ms-macros_002c-footnotes"><samp class="file">ms</samp> macros, footnotes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Differences-from-AT_0026T-ms.html#index-ms-macros_002c-fractional-type-sizes-in"><samp class="file">ms</samp> macros, fractional type sizes in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Differences-from-AT_0026T-ms.html">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Structure.html#index-ms-macros_002c-general-structure"><samp class="file">ms</samp> macros, general structure</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Structure.html">ms Document Structure</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Differences-from-AT_0026T-ms.html#index-ms-macros_002c-groff-differences-from-AT_0026T"><samp class="file">ms</samp> macros, <code class="code">groff</code> differences from <abbr class="acronym">AT&amp;T</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Differences-from-AT_0026T-ms.html">Differences from AT&amp;T ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-ms-macros_002c-headers"><samp class="file">ms</samp> macros, headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-ms-macros_002c-headings"><samp class="file">ms</samp> macros, headings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-ms-macros_002c-keeps"><samp class="file">ms</samp> macros, keeps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-ms-macros_002c-language"><samp class="file">ms</samp> macros, language</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-ms-macros_002c-lists"><samp class="file">ms</samp> macros, lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-ms-macros_002c-localization"><samp class="file">ms</samp> macros, localization</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Margins.html#index-ms-macros_002c-margins"><samp class="file">ms</samp> macros, margins</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Margins.html">ms Margins</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Multiple-Columns.html#index-ms-macros_002c-multiple-columns"><samp class="file">ms</samp> macros, multiple columns</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Multiple-Columns.html">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Naming-Conventions.html#index-ms-macros_002c-naming-conventions"><samp class="file">ms</samp> macros, naming conventions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Naming-Conventions.html">ms Naming Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indented-regions-in-ms.html#index-ms-macros_002c-nested-lists"><samp class="file">ms</samp> macros, nested lists</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indented-regions-in-ms.html">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typographical-symbols-in-ms.html#index-ms-macros_002c-obtaining-typographical-symbols"><samp class="file">ms</samp> macros, obtaining typographical symbols</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typographical-symbols-in-ms.html">Typographical symbols in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Page-Layout.html#index-ms-macros_002c-page-layout"><samp class="file">ms</samp> macros, page layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Page-Layout.html">ms Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-ms-macros_002c-paragraph-handling"><samp class="file">ms</samp> macros, paragraph handling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-ms-macros_002c-references"><samp class="file">ms</samp> macros, references</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-ms-macros_002c-special-characters"><samp class="file">ms</samp> macros, special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-ms-macros_002c-strings"><samp class="file">ms</samp> macros, strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-ms-macros_002c-tables"><samp class="file">ms</samp> macros, tables</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Text-settings-in-ms.html#index-ms-macros_002c-text-settings"><samp class="file">ms</samp> macros, text settings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Text-settings-in-ms.html">Text settings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-multi_002dfile-documents">multi-file documents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-multi_002dline-strings">multi-line strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-multi_002dpage-table-example-_005bms_005d">multi-page table example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Multiple-Columns.html#index-multiple-columns-_005bms_005d">multiple columns <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Multiple-Columns.html">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-multiplication">multiplication</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-n-scaling-unit"><code class="code">n</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-name-space_002c-common_002c-of-macros_002c-diversions_002c-and-strings">name space, common, of macros, diversions, and strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-name_002c-background-color_002c-register-_0028_002eM_0029">name, background color, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-name_002c-fill-color_002c-register-_0028_002eM_0029">name, fill color, register (<code class="code">.M</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-name_002c-stroke-color_002c-register-_0028_002em_0029">name, stroke color, register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-named-character-_0028_005cC_0029">named character (<code class="code">\C</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-names_002c-long">names, long</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Naming-Conventions.html#index-naming-conventions_002c-ms-macros">naming conventions, <samp class="file">ms</samp> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Naming-Conventions.html">ms Naming Conventions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-ne-request_002c-and-the-_002etrunc-register"><code class="code">ne</code> request, and the <code class="code">.trunc</code> register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-ne-request_002c-comparison-with-sv"><code class="code">ne</code> request, comparison with <code class="code">sv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-negating-register-values">negating register values</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-negation">negation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-nested-assignments">nested assignments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-nested-diversions">nested diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indented-regions-in-ms.html#index-nested-lists-_005bms_005d">nested lists <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indented-regions-in-ms.html">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-nesting-level_002c-suppression_002c-register">nesting level, suppression, register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-new-page-_0028bp_0029">new page (<code class="code">bp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-newline-character_002c-and-translations">newline character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-newline-character_002c-in-strings_002c-escaping">newline character, in strings, escaping</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-newline_002c-as-delimiter">newline, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-newline_002c-final_002c-stripping-in-diversions">newline, final, stripping in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-next-file_002c-processing-_0028nx_0029">next file, processing (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-next-free-font-position-register-_0028_002efp_0029">next free font position register (<code class="code">.fp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-next-page-number-register-_0028_002epn_0029">next page number register (<code class="code">.pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-next-page-number_002c-configuring-_0028pn_0029">next page number, configuring (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-nf-request_002c-causing-implicit-break"><code class="code">nf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-nl-register_002c-and-_002ed"><code class="code">nl</code> register, and <code class="code">.d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-nl-register_002c-difference-from-_002eh"><code class="code">nl</code> register, difference from <code class="code">.h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-nm-request_002c-using-_002b-and-_002d-with"><code class="code">nm</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-no_002dbreak-control-character-_0028_0027_0029">no-break control character (<code class="code">'</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-no_002dbreak-control-character_002c-changing-_0028c2_0029">no-break control character, changing (<code class="code">c2</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-no_002dfill-mode">no-fill mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-no_002dfill-mode_002c-and-_005cc">no-fill mode, and <code class="code">\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-no_002dspace-mode-_0028ns_0029">no-space mode (<code class="code">ns</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-node_002c-output">node, output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-non_002dprinting-break-point-_0028_005c_003a_0029">non-printing break point (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-nr-request_002c-and-warnings"><code class="code">nr</code> request, and warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-nr-request_002c-using-_002b-and-_002d-with"><code class="code">nr</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-nroff-mode"><code class="code">nroff</code> mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-number-formats_002c-assigning-to-register-_0028af_0029">number formats, assigning to register (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-number-of-registers-register-_0028_002eR_0029">number of registers register (<code class="code">.R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-number_002c-input-line_002c-setting-_0028lf_0029">number, input line, setting (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-number_002c-page_002c-next_002c-configuring-_0028pn_0029">number, page, next, configuring (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-numbered-glyph-_0028_005cN_0029">numbered glyph (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-numbered-glyph-_0028_005cN_0029-1">numbered glyph (<code class="code">\N</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Lists-in-ms.html#index-numbered-list_002c-example-markup-_005bms_005d">numbered list, example markup <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Lists-in-ms.html">Lists in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-numbers_002c-line_002c-printing-_0028nm_0029">numbers, line, printing (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-numeral_002dwidth-space-_0028_005c0_0029">numeral-width space (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-numerals_002c-as-delimiters">numerals, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-numerals_002c-Roman">numerals, Roman</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-numeric-expression_002c-valid">numeric expression, valid</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-numeric-expressions">numeric expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-object-creation">object creation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-offset_002c-page">offset, page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-offset_002c-page-_0028po_0029">offset, page (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-open-request_002c-and-safer-mode"><code class="code">open</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-opena-request_002c-and-safer-mode"><code class="code">opena</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-opening-brace-escape-sequence-_0028_005c_007d_0029">opening brace escape sequence (<code class="code">\}</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-opening-file-_0028open_0029">opening file (<code class="code">open</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operator_002c-scaling">operator, scaling</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-arithmetic">operators, arithmetic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-operators_002c-as-delimiters">operators, as delimiters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-comparison">operators, comparison</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-extremum-_0028_003e_003f_002c-_003c_003f_0029">operators, extremum (<code class="code">&gt;?</code>, <code class="code">&lt;?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-logical">operators, logical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-motion">operators, motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-operators_002c-unary-arithmetic">operators, unary arithmetic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-optical-size-of-a-font">optical size of a font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-options">options</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-order-of-evaluation-in-expressions">order of evaluation in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-ordinary-character">ordinary character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-orientation_002c-landscape">orientation, landscape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-orphan">orphan</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-orphan-lines_002c-preventing-with-ne">orphan lines, preventing with <code class="code">ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-os-request_002c-and-no_002dspace-mode"><code class="code">os</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-outlined-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">outlined circle, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-outlined-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">outlined ellipse, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-outlined-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">outlined polygon, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-output-and-input-requests">output and input requests</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-output-comparison-operator">output comparison operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-device-name-string-_0028_002eT_0029">output device name string (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-output-device-name-string-_0028_002eT_0029-1">output device name string (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-output-device-name-string-_0028_002eT_0029_002c-in-other-implementations">output device name string (<code class="code">.T</code>), in other implementations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-device-usage-register-_0028_002eT_0029">output device usage register (<code class="code">.T</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-output-device-usage-register-_0028_002eT_0029_002c-incompatibility-with-AT_0026T-troff">output device usage register (<code class="code">.T</code>), incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Output-Device-Intro.html#index-output-devices">output devices</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Output-Device-Intro.html">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-ASCII">output encoding, <abbr class="acronym">ASCII</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-code-page-1047">output encoding, code page 1047</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-EBCDIC">output encoding, <abbr class="acronym">EBCDIC</abbr></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-ISO-646">output encoding, ISO&nbsp;646</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029">output encoding, <span class="w-nolinebreak-text">Latin-1</span> (ISO <span class="w-nolinebreak-text">8859-1</span>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-output-encoding_002c-UTF_002d8">output encoding, <span class="w-nolinebreak-text">UTF-8</span></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-output-glyphs_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff">output glyphs, and input characters, compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-output-line-break">output line break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-output-line-number-register-_0028ln_0029">output line number register (<code class="code">ln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-output-line-properties">output line properties</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-output-line_002c-continuation-_0028_005cc_0029">output line, continuation (<code class="code">\c</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-output-line_002c-horizontal-position_002c-register-_0028_002ek_0029">output line, horizontal position, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-output-node">output node</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-output-request_002c-and-copy-mode"><code class="code">output</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-output-request_002c-and-_005c_0021"><code class="code">output</code> request, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-output_002c-filling_002c-disablement-of-_0028nf_0029">output, filling, disablement of (<code class="code">nf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-output_002c-filling_002c-enablement-of-_0028fi_0029">output, filling, enablement of (<code class="code">fi</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-output_002c-flush-_0028fl_0029">output, flush (<code class="code">fl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-output_002c-gtroff">output, <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-output_002c-intermediate">output, intermediate</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-output_002c-suppressing-_0028_005cO_0029">output, suppressing (<code class="code">\O</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-output_002c-transparent-_0028cf_002c-trf_0029">output, transparent (<code class="code">cf</code>, <code class="code">trf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-output_002c-transparent-_0028_005c_0021_002c-_005c_003f_0029">output, transparent (<code class="code">\!</code>, <code class="code">\?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-output_002c-transparent_002c-incompatibilities-with-AT_0026T-troff">output, transparent, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-output_002c-troff">output, <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-overlapping-characters">overlapping characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-overstriking-glyphs-_0028_005co_0029">overstriking glyphs (<code class="code">\o</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-p-scaling-unit"><code class="code">p</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-P-scaling-unit"><code class="code">P</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Packages.html#index-package_002c-macro">package, macro</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Packages.html">Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-package_002c-macro_002c-auxiliary">package, macro, auxiliary</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-package_002c-macro_002c-full_002dservice">package, macro, full-service</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Package-Intro.html#index-package_002c-macro_002c-introduction">package, macro, introduction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Package-Intro.html">Macro Package Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-package_002c-macro_002c-major">package, macro, major</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Major-Macro-Packages.html#index-package_002c-macro_002c-minor">package, macro, minor</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Major-Macro-Packages.html">Major Macro Packages</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-package_002c-macro_002c-search-path">package, macro, search path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-package_002c-package_002c-structuring-the-source-of">package, package, structuring the source of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-padding-character_002c-for-fields-_0028fc_0029">padding character, for fields (<code class="code">fc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-page">page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-page-break">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page-break-1">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-page-break-2">page break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-page-break-_0028introduction_0029">page break (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page-break_002c-conditional-_0028ne_0029">page break, conditional (<code class="code">ne</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-page-break_002c-final">page break, final</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-page-break_002c-prevented-by-vpt">page break, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page-control">page control</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-page-ejection">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page-ejection-1">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-page-ejection-2">page ejection</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-page-ejection-status-register-_0028_002epe_0029">page ejection status register (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-page-ejection_002c-of-final-page">page ejection, of final page</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-page-ejection_002c-prevented-by-vpt">page ejection, prevented by <code class="code">vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-page-footers">page footers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-page-headers">page headers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-layout">page layout</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Page-Layout.html#index-page-layout-_005bms_005d">page layout <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Page-Layout.html">ms Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-length-register-_0028_002ep_0029">page length register (<code class="code">.p</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-length_002c-configuring-_0028pl_0029">page length, configuring (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-page-location-traps">page location traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-page-location-traps_002c-debugging">page location traps, debugging</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-page-location_002c-vertical_002c-marking-_0028mk_0029">page location, vertical, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-page-location_002c-vertical_002c-returning-to-marked-_0028rt_0029">page location, vertical, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-page-motions">page motions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-number-character-_0028_0025_0029">page number character (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-number-character_002c-changing-_0028pc_0029">page number character, changing (<code class="code">pc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page-number-register-_0028_0025_0029">page number register (<code class="code">%</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-number_002c-configuring-next-_0028pn_0029">page number, configuring next (<code class="code">pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-page-number_002c-next_002c-register-_0028_002epn_0029">page number, next, register (<code class="code">.pn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-page-offset">page offset</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-page-offset-_0028po_0029">page offset (<code class="code">po</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-page-orientation_002c-landscape">page orientation, landscape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-page_002c-geometry-of">page, geometry of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-page_002c-new-_0028bp_0029">page, new (<code class="code">bp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-paper-format">paper format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-paper-size">paper size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs.html#index-paragraphs">paragraphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs.html">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-parameter-count-register-_0028_002e_0024_0029">parameter count register (<code class="code">.$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-parameters">parameters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-parameters_002c-and-compatibility-mode">parameters, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-parameters_002c-macro-_0028_005c_0024_0029">parameters, macro (<code class="code">\$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-parentheses">parentheses</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-partially-collected-line">partially collected line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-path_002c-for-font-files">path, for font files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-path_002c-for-tmac-files">path, for tmac files</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-pattern-files_002c-for-hyphenation">pattern files, for hyphenation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-patterns-for-hyphenation-_0028hpf_0029">patterns for hyphenation (<code class="code">hpf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-pending-output-line">pending output line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-pi-request_002c-and-groff"><code class="code">pi</code> request, and <code class="code">groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-pi-request_002c-and-safer-mode"><code class="code">pi</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Safer-Mode.html#index-pi-request_002c-disabled-by-default"><code class="code">pi</code> request, disabled by default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Safer-Mode.html">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-pica-scaling-unit-_0028P_0029">pica scaling unit (<code class="code">P</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-PID-of-GNU-troff-register-_0028_0024_0024_0029">PID of GNU <code class="code">troff</code> register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-pile_002c-glyph-_0028_005cb_0029">pile, glyph (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-pl-request_002c-using-_002b-and-_002d-with"><code class="code">pl</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-plain-text-approximation-output-register-_0028_002eA_0029">plain text approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-plain-text-approximation-output-register-_0028_002eA_0029-1">plain text approximation output register (<code class="code">.A</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Traps.html#index-planting-a-trap">planting a trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Traps.html">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-platform_002dspecific-directory">platform-specific directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-pm-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">pm</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-pn-request_002c-using-_002b-and-_002d-with"><code class="code">pn</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-PNG-image-generation-from-PostScript">PNG image generation from PostScript</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-po-request_002c-using-_002b-and-_002d-with"><code class="code">po</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-point-scaling-unit-_0028p_0029">point scaling unit (<code class="code">p</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-point-size-registers-_0028_002es_002c-_002eps_0029">point size registers (<code class="code">.s</code>, <code class="code">.ps</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-point-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029">point size registers, last-requested (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-point-sizes_002c-changing-_0028ps_002c-_005cs_0029">point sizes, changing (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-point-sizes_002c-fractional">point sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-point-sizes_002c-fractional-1">point sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">polygon, filled, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-polygon_002c-outlined_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">polygon, outlined, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-polygon_002c-solid_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">polygon, solid, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">polygon, stroked, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-position-of-lowest-text-line-_0028_002eh_0029">position of lowest text line (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-position_002c-absolute-_0028sic_0029-operator-_0028_007c_0029">position, absolute <i class="slanted">(sic)</i> operator (<code class="code">|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-position_002c-drawing">position, drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-position_002c-horizontal-input-line_002c-saving-_0028_005ck_0029">position, horizontal input line, saving (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-position_002c-horizontal_002c-in-input-line_002c-register-_0028hp_0029">position, horizontal, in input line, register (<code class="code">hp</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-position_002c-horizontal_002c-in-output-line_002c-register-_0028_002ek_0029">position, horizontal, in output line, register (<code class="code">.k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-position_002c-mounting">position, mounting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-position_002c-vertical_002c-in-diversion_002c-register-_0028_002ed_0029">position, vertical, in diversion, register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-positions_002c-font">positions, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-post_002dvertical-line-spacing">post-vertical line spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-post_002dvertical-line-spacing-register-_0028_002epvs_0029">post-vertical line spacing register (<code class="code">.pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-post_002dvertical-line-spacing_002c-changing-_0028pvs_0029">post-vertical line spacing, changing (<code class="code">pvs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-postprocessor-access">postprocessor access</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Output-Device-Intro.html#index-postprocessors">postprocessors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Output-Device-Intro.html">Output Device Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-PostScript_002c-bounding-box">PostScript, bounding box</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-PostScript_002c-PNG-image-generation">PostScript, PNG image generation</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-prefix_002c-for-commands">prefix, for commands</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Preprocessor-Intro.html#index-preprocessors">preprocessors</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Preprocessor-Intro.html">Preprocessor Intro</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-previous-font_002c-selecting-_0028ft_0029">previous font, selecting (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-previous-font_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029">previous font, selecting (<code class="code">\f</code>, <code class="code">\fP</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-previous-line-length-_0028_002en_0029">previous line length (<code class="code">.n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-print-current-page-register-_0028_002eP_0029">print current page register (<code class="code">.P</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-printing-backslash-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029">printing backslash (<code class="code">\\</code>, <code class="code">\e</code>, <code class="code">\E</code>, <code class="code">\rs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-printing-line-numbers-_0028nm_0029">printing line numbers (<code class="code">nm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-printing-to-stderr-_0028tm_002c-tm1_002c-tmc_0029">printing to stderr (<code class="code">tm</code>, <code class="code">tm1</code>, <code class="code">tmc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029">printing, zero-width (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029-1">printing, zero-width (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-process-ID-of-GNU-troff-register-_0028_0024_0024_0029">process ID of GNU <code class="code">troff</code> register (<code class="code">$$</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-processing-next-file-_0028nx_0029">processing next file (<code class="code">nx</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-productive-input-line">productive input line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-properties-of-characters-_0028cflags_0029">properties of characters (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-properties-of-glyphs-_0028cflags_0029">properties of glyphs (<code class="code">cflags</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-properties-of-output-lines">properties of output lines</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-ps-request_002c-and-constant-glyph-space-mode"><code class="code">ps</code> request, and constant glyph space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-ps-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ps</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-ps-request_002c-using-_002b-and-_002d-with"><code class="code">ps</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-ps-request_002c-with-fractional-type-sizes"><code class="code">ps</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-pso-request_002c-and-safer-mode"><code class="code">pso</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-pvs-request_002c-using-_002b-and-_002d-with"><code class="code">pvs</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-quanta_002c-motion">quanta, motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-quantum_002c-horizontal-motion">quantum, horizontal motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-quantum_002c-vertical-motion">quantum, vertical motion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-radicalex-glyph_002c-and-cflags"><code class="code">radicalex</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ragged_002dleft-text">ragged-left text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ragged_002dright-text">ragged-right text</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-rc-request_002c-and-glyph-definitions"><code class="code">rc</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-read_002donly-register-removal_002c-incompatibility-with-AT_0026T-troff">read-only register removal, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-read_002donly-register_002c-changing-format">read-only register, changing format</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-reading-from-standard-input-_0028rd_0029">reading from standard input (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-recursive-macros">recursive macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-refer_002c-and-macro-names-starting-with-_005b-or-_005d"><code class="code">refer</code>, and macro names starting with <code class="code"></code> or <code class="code"></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="GNU-troff-Reference.html#index-reference_002c-gtroff">reference, <code class="code">gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="GNU-troff-Reference.html">GNU troff Reference</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-references-_005bms_005d">references <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-register-format_002c-in-expressions">register format, in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-register_002c-assigning-number-format-to-_0028af_0029">register, assigning number format to (<code class="code">af</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-register_002c-built_002din_002c-removing">register, built-in, removing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-register_002c-creating-alias-for-_0028aln_0029">register, creating alias for (<code class="code">aln</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-register_002c-format-_0028_005cg_0029">register, format (<code class="code">\g</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-register_002c-read_002donly_002c-removal_002c-incompatibility-with-AT_0026T-troff">register, read-only, removal, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-register_002c-removing-_0028rr_0029">register, removing (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-register_002c-removing-alias-for-_0028rr_0029">register, removing alias for (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-register_002c-renaming-_0028rnn_0029">register, renaming (<code class="code">rnn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Registers.html#index-registers">registers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Registers.html">Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-registers_002c-built_002din">registers, built-in</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-registers_002c-dumping-_0028pnr_0029">registers, dumping (<code class="code">pnr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-registers_002c-interpolating-_0028_005cn_0029">registers, interpolating (<code class="code">\n</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-registers_002c-number-of_002c-register-_0028_002eR_0029">registers, number of, register (<code class="code">.R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-registers_002c-setting-_0028nr_002c-_005cR_0029">registers, setting (<code class="code">nr</code>, <code class="code">\R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-removal-of-read_002donly-registers_002c-incompatibility-with-AT_0026T-troff">removal of read-only registers, incompatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-removing-a-built_002din-register">removing a built-in register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-removing-a-register-_0028rr_0029">removing a register (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-removing-alias-for-register-_0028rr_0029">removing alias for register (<code class="code">rr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-alias_002c-for-diversion-_0028rm_0029">removing alias, for diversion (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-alias_002c-for-macro-_0028rm_0029">removing alias, for macro (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-alias_002c-for-string-_0028rm_0029">removing alias, for string (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-diversion-_0028rm_0029">removing diversion (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-removing-glyph-definition-_0028rchar_002c-rfschar_0029">removing glyph definition (<code class="code">rchar</code>, <code class="code">rfschar</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-macro-_0028rm_0029">removing macro (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-request-_0028rm_0029">removing request (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-removing-string-_0028rm_0029">removing string (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-renaming-a-register-_0028rnn_0029">renaming a register (<code class="code">rnn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-renaming-diversion-_0028rn_0029">renaming diversion (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-renaming-macro-_0028rn_0029">renaming macro (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-renaming-request-_0028rn_0029">renaming request (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-renaming-string-_0028rn_0029">renaming string (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-renditions_002c-graphic">renditions, graphic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-request">request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Formatter-Instructions.html#index-request-1">request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Formatter-Instructions.html">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-request-arguments">request arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-request-arguments_002c-and-compatibility-mode">request arguments, and compatibility mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-request-arguments_002c-and-tabs">request arguments, and tabs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-request_002c-removing-_0028rm_0029">request, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-request_002c-renaming-_0028rn_0029">request, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-request_002c-undefined">request, undefined</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-requests-for-drawing">requests for drawing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-requests-for-input-and-output">requests for input and output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-requests_002c-intercepting">requests, intercepting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-requests_002c-invoking">requests, invoking</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-requests_002c-modifying">requests, modifying</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-resolution_002c-device">resolution, device</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-resolution_002c-device-1">resolution, device</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-resolution_002c-device_002c-obtaining-in-the-formatter">resolution, device, obtaining in the formatter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-resolution_002c-horizontal">resolution, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-resolution_002c-horizontal_002c-register-_0028_002eH_0029">resolution, horizontal, register (<code class="code">.H</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-resolution_002c-vertical">resolution, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-returning-to-marked-vertical-page-location-_0028rt_0029">returning to marked vertical page location (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-revision-number-register-_0028_002eY_0029">revision number register (<code class="code">.Y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-right-margin">right margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-right_002daligning-lines-_0028introduction_0029">right-aligning lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-right_002djustifying-_0028rj_0029">right-justifying (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-right_002djustifying-lines-_0028introduction_0029">right-justifying lines (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-rivers">rivers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-rj-request_002c-causing-implicit-break"><code class="code">rj</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-rn-glyph_002c-and-cflags"><code class="code">rn</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-roman-glyph_002c-correction-after-italic-glyph-_0028_005c_002f_0029">roman glyph, correction after italic glyph (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-roman-glyph_002c-correction-before-italic-glyph-_0028_005c_002c_0029">roman glyph, correction before italic glyph (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-Roman-numerals">Roman numerals</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-Roman-numerals_002c-extrema-_0028maximum-and-minimum_0029">Roman numerals, extrema (maximum and minimum)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-rq-glyph_002c-at-end-of-sentence"><code class="code">rq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-rq-glyph_002c-at-end-of-sentence-1"><code class="code">rq</code> glyph, at end of sentence</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-rt-request_002c-using-_002b-and-_002d-with"><code class="code">rt</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-ru-glyph_002c-and-cflags"><code class="code">ru</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-running-system-commands">running system commands</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-s-scaling-unit"><code class="code">s</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-safer-mode">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-safer-mode-1">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-safer-mode-2">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-safer-mode-3">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-safer-mode-4">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-safer-mode-5">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-safer-mode-6">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Safer-Mode.html#index-safer-mode-7">safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Safer-Mode.html">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-saving-horizontal-input-line-position-_0028_005ck_0029">saving horizontal input line position (<code class="code">\k</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-indicator">scaling indicator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-scaling-operator">scaling operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-c">scaling unit <code class="code">c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-scaling-unit-f">scaling unit <code class="code">f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-i">scaling unit <code class="code">i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-m">scaling unit <code class="code">m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-M">scaling unit <code class="code">M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-n">scaling unit <code class="code">n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-p">scaling unit <code class="code">p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-P">scaling unit <code class="code">P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-scaling-unit-s">scaling unit <code class="code">s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-u">scaling unit <code class="code">u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-scaling-unit-v">scaling unit <code class="code">v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-scaling-unit-z">scaling unit <code class="code">z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-searching-fonts">searching fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-searching-macros">searching macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-seconds_002c-current-time-_0028seconds_0029">seconds, current time (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-selecting-the-previous-font-_0028ft_0029">selecting the previous font (<code class="code">ft</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-sentence-space">sentence space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-sentence-space-size-register-_0028_002esss_0029">sentence space size register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-sentences">sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Formatter-Instructions.html#index-sequence_002c-escape">sequence, escape</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Formatter-Instructions.html">Formatter Instructions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-setting-diversion-trap-_0028dt_0029">setting diversion trap (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-setting-end_002dof_002dinput-trap-_0028em_0029">setting end-of-input trap (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-setting-input-line-number-_0028lf_0029">setting input line number (<code class="code">lf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-setting-input-line-trap-_0028it_002c-itc_0029">setting input line trap (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-setting-registers-_0028nr_002c-_005cR_0029">setting registers (<code class="code">nr</code>, <code class="code">\R</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-setting-the-page-length-_0028pl_0029">setting the page length (<code class="code">pl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-setting-up-an-abstract-font-style-_0028sty_0029">setting up an abstract font style (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-shc-request_002c-and-translations"><code class="code">shc</code> request, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-site_002dlocal-directory">site-local directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Directories.html#index-site_002dlocal-directory-1">site-local directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Directories.html">Font Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-size-of-sentence-space-register-_0028_002esss_0029">size of sentence space register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-size-of-word-space-register-_0028_002ess_0029">size of word space register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-size_002c-optical_002c-of-a-font">size, optical, of a font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-size_002c-paper">size, paper</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-size_002c-size">size, size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-sizes_002c-fractional">sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-sizes_002c-fractional-type">sizes, fractional type</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-skew_002c-of-last-glyph-_0028_002ecsk_0029">skew, of last glyph (<code class="code">.csk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-slant_002c-font_002c-changing-_0028_005cS_0029">slant, font, changing (<code class="code">\S</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-soft-hyphen-character_002c-setting-_0028shc_0029">soft hyphen character, setting (<code class="code">shc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-soft-hyphen-glyph-_0028hy_0029">soft hyphen glyph (<code class="code">hy</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-solid-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029">solid circle, drawing (&lsquo;<samp class="samp">\D'C &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-solid-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029">solid ellipse, drawing (&lsquo;<samp class="samp">\D'E &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-solid-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029">solid polygon, drawing (&lsquo;<samp class="samp">\D'P &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable"><code>SOURCE_DATE_EPOCH<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-sp-request_002c-and-no_002dspace-mode"><code class="code">sp</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-sp-request_002c-causing-implicit-break"><code class="code">sp</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-space-between-sentences">space between sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space-between-sentences-register-_0028_002esss_0029">space between sentences register (<code class="code">.sss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space-between-words-register-_0028_002ess_0029">space between words register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-space-character_002c-as-delimiter">space character, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-space-characters_002c-in-expressions">space characters, in expressions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space_002c-between-sentences">space, between sentences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space_002c-between-words">space, between words</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space_002c-discardable_002c-horizontal">space, discardable, horizontal</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-space_002c-hair-_0028_005c_005e_0029">space, hair (<code class="code">\^</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-space_002c-horizontal-_0028_005ch_0029">space, horizontal (<code class="code">\h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-space_002c-horizontal_002c-unformatting">space, horizontal, unformatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-space_002c-thin-_0028_005c_007c_0029">space, thin (<code class="code">\|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-space_002c-unbreakable-_0028_005c_007e_0029">space, unbreakable (<code class="code">\~</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-space_002c-unbreakable-and-unadjustable-_0028_005cSP_0029">space, unbreakable and unadjustable (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-space_002c-vertical_002c-unit-_0028v_0029">space, vertical, unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-space_002c-width-of-a-digit-_0028numeral_0029-_0028_005c0_0029">space, width of a digit (numeral) (<code class="code">\0</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-spaces-with-ds">spaces with <code class="code">ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Calling-Macros.html#index-spaces_002c-in-a-macro-argument">spaces, in a macro argument</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Calling-Macros.html">Calling Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-spaces_002c-leading-and-trailing">spaces, leading and trailing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-spacing-_0028introduction_0029">spacing (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-spacing_002c-manipulating">spacing, manipulating</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-spacing_002c-vertical">spacing, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-spacing_002c-vertical-1">spacing, vertical</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-spacing_002c-vertical-_0028introduction_0029">spacing, vertical (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Sentences.html#index-special-characters">special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Sentences.html">Sentences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-special-characters-1">special characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-special-characters-_005bms_005d">special characters <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-special-characters_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029">special characters, list of (<cite class="cite">groff_char<span class="r">(7)</span></cite> man page)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-special-font">special font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-special-fonts">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-special-fonts-1">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-special-fonts-2">special fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-special-fonts_002c-emboldening">special fonts, emboldening</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-special-request_002c-and-font-translations"><code class="code">special</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-special-request_002c-and-glyph-search-order"><code class="code">special</code> request, and glyph search order</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-spline_002c-drawing-_0028_005cD_0027_007e-_2026_0027_0029">spline, drawing (&lsquo;<samp class="samp">\D'~ &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Traps.html#index-springing-a-trap">springing a trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Traps.html">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-sqrtex-glyph_002c-and-cflags"><code class="code">sqrtex</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-ss-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">ss</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-stack">stack</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-stacking-glyphs-_0028_005cb_0029">stacking glyphs (<code class="code">\b</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-standard-input_002c-reading-from-_0028rd_0029">standard input, reading from (<code class="code">rd</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-stderr_002c-printing-to-_0028tm_002c-tm1_002c-tmc_0029">stderr, printing to (<code class="code">tm</code>, <code class="code">tm1</code>, <code class="code">tmc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-stops_002c-tab">stops, tab</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string-arguments">string arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-string-comparison">string comparison</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string-expansion-_0028_005c_002a_0029">string expansion (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string-interpolation-_0028_005c_002a_0029">string interpolation (<code class="code">\*</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-appending-_0028as_0029">string, appending (<code class="code">as</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-creating-alias-for-_0028als_0029">string, creating alias for (<code class="code">als</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-length-of-_0028length_0029">string, length of (<code class="code">length</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-removing-_0028rm_0029">string, removing (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-removing-alias-for-_0028rm_0029">string, removing alias for (<code class="code">rm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-string_002c-renaming-_0028rn_0029">string, renaming (<code class="code">rn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-strings">strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-strings-_005bms_005d">strings <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-strings_002c-multi_002dline">strings, multi-line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-strings_002c-shared-name-space-with-macros-and-diversions">strings, shared name space with macros and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-stripping-final-newline-in-diversions">stripping final newline in diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-stroke-color">stroke color</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-stroke-color-name-register-_0028_002em_0029">stroke color name register (<code class="code">.m</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-stroked-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029">stroked circle, drawing (&lsquo;<samp class="samp">\D'c &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-stroked-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029">stroked ellipse, drawing (&lsquo;<samp class="samp">\D'e &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-stroked-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029">stroked polygon, drawing (&lsquo;<samp class="samp">\D'p &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-structuring-source-code-of-documents-or-macro-packages">structuring source code of documents or macro packages</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-sty-request_002c-and-changing-fonts"><code class="code">sty</code> request, and changing fonts</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-sty-request_002c-and-font-translations"><code class="code">sty</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-style_002c-font">style, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-style_002c-font_002c-abstract">style, font, abstract</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-style_002c-font_002c-abstract_002c-setting-up-_0028sty_0029">style, font, abstract, setting up (<code class="code">sty</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-styles_002c-font">styles, font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-substring-_0028substring_0029">substring (<code class="code">substring</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-subtraction">subtraction</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-suppressing-output-_0028_005cO_0029">suppressing output (<code class="code">\O</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-suppression-nesting-level-register">suppression nesting level register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-sv-request_002c-and-no_002dspace-mode"><code class="code">sv</code> request, and no-space mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-switching-environments-_0028ev_0029">switching environments (<code class="code">ev</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-sy-request_002c-and-safer-mode"><code class="code">sy</code> request, and safer mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Safer-Mode.html#index-sy-request_002c-disabled-by-default"><code class="code">sy</code> request, disabled by default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Safer-Mode.html">Safer Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-symbol">symbol</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-symbol-table_002c-dumping-_0028pm_0029">symbol table, dumping (<code class="code">pm</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-symbol_002c-defining-_0028char_0029">symbol, defining (<code class="code">char</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-symbols_002c-using">symbols, using</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-system-commands_002c-running">system commands, running</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-system_0028_0029-return-value-register-_0028systat_0029"><code class="code">system()</code> return value register (<code class="code">systat</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-tab-character">tab character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab-character-encoding">tab character encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-tab-character_002c-and-translations">tab character, and translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Delimiters.html#index-tab-character_002c-as-delimiter">tab character, as delimiter</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Delimiters.html">Delimiters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab-character_002c-non_002dinterpreted-_0028_005ct_0029">tab character, non-interpreted (<code class="code">\t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab-repetition-character-_0028tc_0029">tab repetition character (<code class="code">tc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab-stop-settings-register-_0028_002etabs_0029">tab stop settings register (<code class="code">.tabs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Leaders.html#index-tab-stops">tab stops</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Leaders.html">Tabs and Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab-stops_002c-default">tab stops, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tab_002c-line_002dtabs-mode">tab, line-tabs mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Table-of-Contents.html#index-table-of-contents">table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Table-of-Contents.html">Table of Contents</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-table-of-contents-1">table of contents</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-table-of-contents_002c-creating-_005bms_005d">table of contents, creating <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-table_002c-multi_002dpage_002c-example-_005bms_005d">table, multi-page, example <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-tables-_005bms_005d">tables <samp class="file">ms</samp></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tabs_002c-and-fields">tabs, and fields</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-tabs_002c-and-macro-arguments">tabs, and macro arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Invoking-Requests.html#index-tabs_002c-and-request-arguments">tabs, and request arguments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Invoking-Requests.html">Invoking Requests</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-tabs_002c-before-comments">tabs, before comments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs.html#index-tagged-paragraphs">tagged paragraphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs.html">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs.html#index-tags_002c-paragraph">tags, paragraph</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs.html">Paragraphs</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-terminal_002c-conditional-output-for">terminal, conditional output for</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-text-baseline">text baseline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-text-baseline-1">text baseline</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-text-font">text font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Requests-and-Macros.html#index-text-line">text line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Requests-and-Macros.html">Requests and Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-text-line_002c-position-of-lowest-_0028_002eh_0029">text line, position of lowest (<code class="code">.h</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Text.html#index-text_002c-GNU-troff-processing">text, GNU <code class="code">troff</code> processing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Text.html">Text</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-text_002c-justifying">text, justifying</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-text_002c-justifying-_0028rj_0029">text, justifying (<code class="code">rj</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-thickness-of-lines-_0028_005cD_0027t-_2026_0027_0029">thickness of lines (&lsquo;<samp class="samp">\D't &hellip;'</samp>&rsquo;)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-thin-space-_0028_005c_007c_0029">thin space (<code class="code">\|</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-three_002dpart-title-_0028tl_0029">three-part title (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ti-request_002c-causing-implicit-break"><code class="code">ti</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-ti-request_002c-using-_002b-and-_002d-with"><code class="code">ti</code> request, using <code class="code">+</code> and&nbsp;<code class="code">-</code> with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-time_002c-current_002c-hours-_0028hours_0029">time, current, hours (<code class="code">hours</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-time_002c-current_002c-minutes-_0028minutes_0029">time, current, minutes (<code class="code">minutes</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-time_002c-current_002c-seconds-_0028seconds_0029">time, current, seconds (<code class="code">seconds</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-time_002c-formatting">time, formatting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-title-length_002c-configuring-_0028lt_0029">title length, configuring (<code class="code">lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-title-line-length-register-_0028_002elt_0029">title line length register (<code class="code">.lt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-title-line_002c-formatting-_0028tl_0029">title line, formatting (<code class="code">tl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-titles">titles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-tkf-request_002c-and-font-styles"><code class="code">tkf</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-tkf-request_002c-and-font-translations"><code class="code">tkf</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-tkf-request_002c-with-fractional-type-sizes"><code class="code">tkf</code> request, with fractional type sizes</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-tl-request_002c-and-mc"><code class="code">tl</code> request, and <code class="code">mc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-tmac_002c-directory">tmac, directory</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-tmac_002c-path">tmac, path</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-TMPDIR_002c-environment-variable"><code>TMPDIR<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Gtroff-Internals.html#index-token_002c-input">token, input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Gtroff-Internals.html">Gtroff Internals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-top-margin">top margin</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-top_002dlevel-diversion">top-level diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-top_002dlevel-diversion_002c-and-bp">top-level diversion, and <code class="code">bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-top_002dlevel-diversion_002c-and-_005c_0021">top-level diversion, and <code class="code">\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-top_002dlevel-diversion_002c-and-_005c_003f">top-level diversion, and <code class="code">\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-tr-request_002c-and-glyph-definitions"><code class="code">tr</code> request, and glyph definitions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-tr-request_002c-and-soft-hyphen-character"><code class="code">tr</code> request, and soft hyphen character</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-tr-request_002c-incompatibilities-with-AT_0026T-troff"><code class="code">tr</code> request, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-track-kerning">track kerning</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-track-kerning_002c-activating-_0028tkf_0029">track kerning, activating (<code class="code">tkf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-trailing-double-quotes-in-strings">trailing double quotes in strings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-trailing-spaces-in-string-definitions-and-appendments">trailing spaces in string definitions and appendments</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Breaking.html#index-trailing-spaces-on-text-lines">trailing spaces on text lines</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Breaking.html">Breaking</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-translations-of-characters">translations of characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-transparent-characters">transparent characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-transparent-dummy-character-_0028_005c_0029_0029">transparent dummy character (<code class="code">\)</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-transparent-output-_0028cf_002c-trf_0029">transparent output (<code class="code">cf</code>, <code class="code">trf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-transparent-output-_0028_005c_0021_002c-_005c_003f_0029">transparent output (<code class="code">\!</code>, <code class="code">\?</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-transparent-output_002c-incompatibilities-with-AT_0026T-troff">transparent output, incompatibilities with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Deferring-Output.html#index-trap">trap</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Deferring-Output.html">Deferring Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-trap_002c-changing-location-_0028ch_0029">trap, changing location (<code class="code">ch</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-trap_002c-distance-to-next-vertical-position_002c-register-_0028_002et_0029">trap, distance to next vertical position, register (<code class="code">.t</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-trap_002c-diversion_002c-setting-_0028dt_0029">trap, diversion, setting (<code class="code">dt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-trap_002c-end_002dof_002dinput_002c-setting-_0028em_0029">trap, end-of-input, setting (<code class="code">em</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="The-Implicit-Page-Trap.html#index-trap_002c-implicit">trap, implicit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-trap_002c-input-line_002c-clearing-_0028it_002c-itc_0029">trap, input line, clearing (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-trap_002c-input-line_002c-setting-_0028it_002c-itc_0029">trap, input line, setting (<code class="code">it</code>, <code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Traps.html#index-trap_002c-planting">trap, planting</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Traps.html">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Traps.html#index-trap_002c-springing">trap, springing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Traps.html">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Traps.html#index-traps">traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Traps.html">Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-traps_002c-and-diversions">traps, and diversions</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Blank-Line-Traps.html#index-traps_002c-blank-line">traps, blank line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Blank-Line-Traps.html">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-traps_002c-diversion">traps, diversion</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-traps_002c-end_002dof_002dinput">traps, end-of-input</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-traps_002c-input-line">traps, input line</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-traps_002c-input-line_002c-and-interrupted-lines-_0028itc_0029">traps, input line, and interrupted lines (<code class="code">itc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-traps_002c-leading-space">traps, leading space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-traps_002c-page-location">traps, page location</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-traps_002c-page-location_002c-dumping-_0028ptr_0029">traps, page location, dumping (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-traps_002c-page-location_002c-listing-_0028ptr_0029">traps, page location, listing (<code class="code">ptr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-traps_002c-sprung-by-bp-request-_0028_002epe_0029">traps, sprung by <code class="code">bp</code> request (<code class="code">.pe</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-traps_002c-vertical-position">traps, vertical position</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-trf-request_002c-and-copy-mode"><code class="code">trf</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-trf-request_002c-and-invalid-characters"><code class="code">trf</code> request, and invalid characters</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-trf-request_002c-causing-implicit-break"><code class="code">trf</code> request, causing implicit break</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-trin-request_002c-and-asciify"><code class="code">trin</code> request, and <code class="code">asciify</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-troff-mode"><code class="code">troff</code> mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="gtroff-Output.html#index-troff-output"><code class="code">troff</code> output</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="gtroff-Output.html">gtroff Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-truncated-vertical-space-register-_0028_002etrunc_0029">truncated vertical space register (<code class="code">.trunc</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-truncating-division">truncating division</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-TTY_002c-conditional-output-for">TTY, conditional output for</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tutorial-for-Macro-Users.html#index-tutorial-for-macro-users">tutorial for macro users</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-type-size">type size</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-type-size-registers-_0028_002es_002c-_002eps_0029">type size registers (<code class="code">.s</code>, <code class="code">.ps</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-type-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029">type size registers, last-requested (<code class="code">.psr</code>, <code class="code">.sr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-type-sizes_002c-changing-_0028ps_002c-_005cs_0029">type sizes, changing (<code class="code">ps</code>, <code class="code">\s</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-type-sizes_002c-fractional">type sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Other-Differences.html#index-type-sizes_002c-fractional-1">type sizes, fractional</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Other-Differences.html">Other Differences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-typeface">typeface</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-TZ_002c-environment-variable"><code>TZ<span class="r">, environment variable</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-u-scaling-unit"><code class="code">u</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-uf-request_002c-and-font-styles"><code class="code">uf</code> request, and font styles</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-ul-glyph_002c-and-cflags"><code class="code">ul</code> glyph, and <code class="code">cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-ul-request_002c-and-font-translations"><code class="code">ul</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-Ultrix_002dspecific-man-macros">Ultrix-specific <code class="code">man</code> macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-unadjustable-and-unbreakable-space-_0028_005cSP_0029">unadjustable and unbreakable space (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-unary-arithmetic-operators">unary arithmetic operators</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-unbreakable-and-unadjustable-space-_0028_005cSP_0029">unbreakable and unadjustable space (<code class="code">\<kbd class="key">SP</kbd></code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-unbreakable-space-_0028_005c_007e_0029">unbreakable space (<code class="code">\~</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-undefined-identifiers">undefined identifiers</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-undefined-request">undefined request</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-underline-font-_0028uf_0029">underline font (<code class="code">uf</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-underlining-_0028ul_0029">underlining (<code class="code">ul</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-underlining_002c-continuous-_0028cu_0029">underlining, continuous (<code class="code">cu</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-unformatting-diversions-_0028asciify_0029">unformatting diversions (<code class="code">asciify</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Punning-Names.html#index-unformatting-horizontal-space">unformatting horizontal space</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Punning-Names.html">Punning Names</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-Unicode">Unicode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-Unicode-1">Unicode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-c">unit, scaling, <code class="code">c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-unit_002c-scaling_002c-f">unit, scaling, <code class="code">f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-i">unit, scaling, <code class="code">i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-m">unit, scaling, <code class="code">m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-M">unit, scaling, <code class="code">M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-n">unit, scaling, <code class="code">n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-p">unit, scaling, <code class="code">p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-P">unit, scaling, <code class="code">P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-unit_002c-scaling_002c-s">unit, scaling, <code class="code">s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-u">unit, scaling, <code class="code">u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-unit_002c-scaling_002c-v">unit, scaling, <code class="code">v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-unit_002c-scaling_002c-z">unit, scaling, <code class="code">z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-units-of-measurement">units of measurement</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-units_002c-basic">units, basic</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-units_002c-basic_002c-conversion-to">units, basic, conversion to</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Default-Units.html#index-units_002c-default">units, default</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Default-Units.html">Default Units</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-units_002c-machine">units, machine</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-unnamed-glyphs">unnamed glyphs</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-unnamed-glyphs_002c-accessing-with-_005cN">unnamed glyphs, accessing with <code class="code">\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-unsafe-mode">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Macro-Directories.html#index-unsafe-mode-1">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Macro-Directories.html">Macro Directories</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-unsafe-mode-2">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-unsafe-mode-3">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-unsafe-mode-4">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-unsafe-mode-5">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-unsafe-mode-6">unsafe mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fonts.html#index-unstyled-font">unstyled font</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fonts.html">Using Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-up_002dcasing-a-string-_0028stringup_0029">up-casing a string (<code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-uppercasing-a-string-_0028stringup_0029">uppercasing a string (<code class="code">stringup</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-upright-glyph_002c-correction-after-oblique-glyph-_0028_005c_002f_0029">upright glyph, correction after oblique glyph (<code class="code">\/</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-upright-glyph_002c-correction-before-oblique-glyph-_0028_005c_002c_0029">upright glyph, correction before oblique glyph (<code class="code">\,</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-URLs_002c-breaking-_0028_005c_003a_0029">URLs, breaking (<code class="code">\:</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tutorial-for-Macro-Users.html#index-user_0027s-macro-tutorial">user&rsquo;s macro tutorial</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tutorial-for-Macro-Users.html#index-user_0027s-tutorial-for-macros">user&rsquo;s tutorial for macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tutorial-for-Macro-Users.html">Tutorial for Macro Users</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-using-escape-sequences">using escape sequences</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-using-symbols">using symbols</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-UTF_002d8-output-encoding"><span class="w-nolinebreak-text">UTF-8</span> output encoding</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-v-scaling-unit"><code class="code">v</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-valid-numeric-expression">valid numeric expression</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-value_002c-incrementing-without-changing-the-register">value, incrementing without changing the register</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environment.html#index-variables-in-environment">variables in environment</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environment.html">Environment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-vee">vee</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-vee-scaling-unit-_0028v_0029">vee scaling unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-version-number_002c-major_002c-register-_0028_002ex_0029">version number, major, register (<code class="code">.x</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-version-number_002c-minor_002c-register-_0028_002ey_0029">version number, minor, register (<code class="code">.y</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-vertical-drawing-position-_0028nl_0029">vertical drawing position (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-vertical-line-drawing-_0028_005cL_0029">vertical line drawing (<code class="code">\L</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-vertical-line-spacing-register-_0028_002ev_0029">vertical line spacing register (<code class="code">.v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-vertical-line-spacing_002c-changing-_0028vs_0029">vertical line spacing, changing (<code class="code">vs</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-vertical-line-spacing_002c-effective-value">vertical line spacing, effective value</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-vertical-motion-_0028_005cv_0029">vertical motion (<code class="code">\v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-vertical-motion-quantum">vertical motion quantum</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-vertical-page-location_002c-marking-_0028mk_0029">vertical page location, marking (<code class="code">mk</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-vertical-page-location_002c-returning-to-marked-_0028rt_0029">vertical page location, returning to marked (<code class="code">rt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-vertical-position-in-diversion-register-_0028_002ed_0029">vertical position in diversion register (<code class="code">.d</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-vertical-position-trap-enable-register-_0028_002evpt_0029">vertical position trap enable register (<code class="code">.vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-vertical-position-traps">vertical position traps</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-vertical-position-traps_002c-enabling-_0028vpt_0029">vertical position traps, enabling (<code class="code">vpt</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-vertical-position_002c-drawing-_0028nl_0029">vertical position, drawing (<code class="code">nl</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-vertical-resolution">vertical resolution</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Measurements.html#index-vertical-space-unit-_0028v_0029">vertical space unit (<code class="code">v</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Measurements.html">Measurements</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Geometry.html#index-vertical-spacing">vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Geometry.html">Page Geometry</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html#index-vertical-spacing-1">vertical spacing</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Basics.html#index-vertical-spacing-_0028introduction_0029">vertical spacing (introduction)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Basics.html">Basics</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-W">W</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-warning-categories">warning categories</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-warning-level-_0028warn_0029">warning level (<code class="code">warn</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-warnings">warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Warnings.html#index-warnings-1">warnings</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Warnings.html">Warnings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="What-Is-groff_003f.html#index-what-is-groff_003f">what is <code class="code">groff</code>?</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="What-Is-groff_003f.html">What Is <code class="code">groff</code>?</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-while">while</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-while-request_002c-and-font-translations"><code class="code">while</code> request, and font translations</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-while-request_002c-and-the-_0021-operator"><code class="code">while</code> request, and the &lsquo;<samp class="samp">!</samp>&rsquo; operator</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-while-request_002c-confusing-with-br"><code class="code">while</code> request, confusing with <code class="code">br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-while-request_002c-operators-to-use-with"><code class="code">while</code> request, operators to use with</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-widow">widow</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-widow-1">widow</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-width-escape-_0028_005cw_0029">width escape (<code class="code">\w</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-width_002c-of-last-glyph-_0028_002ew_0029">width, of last glyph (<code class="code">.w</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-word-space-size-register-_0028_002ess_0029">word space size register (<code class="code">.ss</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Filling.html#index-word_002c-definition-of">word, definition of</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Filling.html">Filling</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-write-request_002c-and-copy-mode"><code class="code">write</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-writec-request_002c-and-copy-mode"><code class="code">writec</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-writem-request_002c-and-copy-mode"><code class="code">writem</code> request, and copy mode</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-writing-macros">writing macros</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-writing-to-file-_0028write_002c-writec_0029">writing to file (<code class="code">write</code>, <code class="code">writec</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Y">Y</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-year_002c-current_002c-register-_0028year_002c-yr_0029">year, current, register (<code class="code">year</code>, <code class="code">yr</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Concept-Index_cp_letter-Z">Z</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-z-scaling-unit"><code class="code">z</code> scaling unit</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029">zero-width printing (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029-1">zero-width printing (<code class="code">\z</code>, <code class="code">\Z</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-zoom-factor-of-a-font-_0028fzoom_0029">zoom factor of a font (<code class="code">fzoom</code>)</a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="cp-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-1"><b>&quot;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-4"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-5"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-6"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-7"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-8"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-9"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-10"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-11"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-12"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-13"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-14"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-15"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-16"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-17"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-18"><b>\</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-19"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_symbol-20"><b>|</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-W"><b>W</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Program-and-File-Index.html">Program and File Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Conditional-Blocks.html Added

@@ -0,0 +1,174 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Conditional Blocks (The GNU Troff Manual)</title>
+
+<meta name="description" content="Conditional Blocks (The GNU Troff Manual)">
+<meta name="keywords" content="Conditional Blocks (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Conditionals-and-Loops.html" rel="up" title="Conditionals and Loops">
+<link href="while.html" rel="next" title="while">
+<link href="Operators-in-Conditionals.html" rel="prev" title="Operators in Conditionals">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Conditional-Blocks">
+<div class="nav-panel">
+<p>
+Next: <a href="while.html" accesskey="n" rel="next">while</a>, Previous: <a href="Operators-in-Conditionals.html" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="Conditionals-and-Loops.html" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Conditional-Blocks-1">5.23.4 Conditional Blocks</h4>
+<a class="index-entry-id" id="index-conditional-blocks"></a>
+<a class="index-entry-id" id="index-blocks_002c-conditional"></a>
+
+<p>It is frequently desirable for a control structure to govern more than
+one request, macro call, text line, or a combination of the foregoing.
+The opening and closing brace escape sequences <code class="code">\{</code> and <code class="code">\}</code>
+define such groups.  These <em class="dfn">conditional blocks</em> can furthermore be
+nested.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007b-2"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\{</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007b-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007b"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_007d-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\}</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007b-1"></a>
+<a class="index-entry-id" id="index-_005c_007d"></a>
+<a class="index-entry-id" id="index-beginning-of-conditional-block-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-end-of-conditional-block-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-conditional-block_002c-beginning-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-conditional-block_002c-end-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-block_002c-conditional_002c-beginning-_0028_005c_007b_0029"></a>
+<a class="index-entry-id" id="index-block_002c-conditional_002c-end-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequences-_0028_005c_007b_002c-_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-escape-sequences_002c-brace-_0028_005c_007b_002c-_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-opening-brace-escape-sequence-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-closing-brace-escape-sequence-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequence_002c-opening-_0028_005c_007d_0029"></a>
+<a class="index-entry-id" id="index-brace-escape-sequence_002c-closing-_0028_005c_007d_0029"></a>
+<p><code class="code">\{</code> begins a conditional block; it must appear (after optional
+spaces and tabs) immediately subsequent to the conditional expression of
+an <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code>
+request,<a class="footnote" id="DOCF93" href="groff.html_fot.html#FOOT93"><sup>93</sup></a> or as the argument to an <code class="code">el</code>
+request.
+</p>
+<p><code class="code">\}</code> ends a condition block and should appear on a line with other
+occurrences of itself as necessary to match <code class="code">\{</code> sequences.  It
+can be preceded by a control character, spaces, and tabs.  Input after
+any quantity of <code class="code">\}</code> sequences on the same line is processed only
+if all of the preceding conditions to which they correspond are true.
+Furthermore, a <code class="code">\}</code> closing the body of a <code class="code">while</code> request
+must be the last such escape sequence on an input line.
+</p>
+<p>Brace escape sequences outside of control structures have no meaning and
+produce no output.
+</p>
+<p><strong class="strong">Caution:</strong> Input lines using <code class="code">\{</code> often end with
+<code class="code">\RET</code>, especially in macros that consist primarily of control
+lines.  Forgetting to use <code class="code">\RET</code> on an input line after <code class="code">\{</code>
+is a common source of error.
+</p></dd></dl>
+
+<p>We might write the following in a page header macro.  If we delete
+<code class="code">\RET</code>, the header will carry an unwanted extra empty line (except
+on page&nbsp;1).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if (\\n% != 1) \{\
+.  ie ((\\n% % 2) = 0) .tl \\*even-numbered-page-title
+.  el                    .tl \\*odd-numbered-page-title
+.\}
+</pre></div></div>
+
+<p>Let us take a closer look at how conditional blocks nest.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A
+.if 0 \{ B
+C
+D
+\}E
+F
+    &rArr; A F
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">N
+.if 1 \{ O
+.  if 0 \{ P
+Q
+R\} S\} T
+U
+    &rArr; N O U
+</pre></div></div>
+
+<p>The above behavior may challenge the intuition; it was implemented to
+retain compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  For clarity, it
+is idiomatic to end input lines with <code class="code">\{</code> (followed by
+<code class="code">\<kbd class="key">RET</kbd></code> if appropriate), and to precede <code class="code">\}</code> on an input
+line with nothing more than a control character, spaces, tabs, and other
+instances of itself.
+</p>
+<p>We can use <code class="code">ie</code>, <code class="code">el</code>, and conditional blocks to simulate the
+multi-way &ldquo;switch&rdquo; or &ldquo;case&rdquo; control structures of other languages.
+The following example is adapted from the <code class="code">groff</code> <samp class="file">man</samp>
+package.  Indentation is used to clarify the logic.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Simulate switch/case in roff.
+.      ie '\\$2'1' .ds title General Commands\&quot;
+.el \{.ie '\\$2'2' .ds title System Calls\&quot;
+.el \{.ie '\\$2'3' .ds title Library Functions\&quot;
+.el \{.ie '\\$2'4' .ds title Kernel Interfaces\&quot;
+.el \{.ie '\\$2'5' .ds title File Formats\&quot;
+.el \{.ie '\\$2'6' .ds title Games\&quot;
+.el \{.ie '\\$2'7' .ds title Miscellaneous Information\&quot;
+.el \{.ie '\\$2'8' .ds title System Management\&quot;
+.el \{.ie '\\$2'9' .ds title Kernel Development\&quot;
+.el                .ds title \&quot; empty
+.\}\}\}\}\}\}\}\}
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="while.html">while</a>, Previous: <a href="Operators-in-Conditionals.html">Operators in Conditionals</a>, Up: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Conditionals-and-Loops.html Added

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Conditionals and Loops (The GNU Troff Manual)</title>
+
+<meta name="description" content="Conditionals and Loops (The GNU Troff Manual)">
+<meta name="keywords" content="Conditionals and Loops (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Writing-Macros.html" rel="next" title="Writing Macros">
+<link href="Strings.html" rel="prev" title="Strings">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Conditionals-and-Loops">
+<div class="nav-panel">
+<p>
+Next: <a href="Writing-Macros.html" accesskey="n" rel="next">Writing Macros</a>, Previous: <a href="Strings.html" accesskey="p" rel="prev">Strings</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Conditionals-and-Loops-1">5.23 Conditionals and Loops</h3>
+<a class="index-entry-id" id="index-conditionals-and-loops"></a>
+<a class="index-entry-id" id="index-loops-and-conditionals"></a>
+
+<p><code class="code">groff</code> has <code class="code">if</code> and <code class="code">while</code> control structures like
+other languages.  However, the syntax for grouping multiple input lines
+in the branches or bodies of these structures is unusual.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Operators-in-Conditionals.html" accesskey="1">Operators in Conditionals</a></li>
+<li><a href="if_002dthen.html" accesskey="2">if-then</a></li>
+<li><a href="if_002delse.html" accesskey="3">if-else</a></li>
+<li><a href="Conditional-Blocks.html" accesskey="4">Conditional Blocks</a></li>
+<li><a href="while.html" accesskey="5">while</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Configuration-and-Customization.html Added

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Configuration and Customization (The GNU Troff Manual)</title>
+
+<meta name="description" content="Configuration and Customization (The GNU Troff Manual)">
+<meta name="keywords" content="Configuration and Customization (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Preprocessor-Support.html" rel="prev" title="Preprocessor Support">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Configuration-and-Customization">
+<div class="nav-panel">
+<p>
+Previous: <a href="Preprocessor-Support.html" accesskey="p" rel="prev">Preprocessor Support</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Configuration-and-Customization-1">3.2.14 Configuration and Customization</h4>
+
+<p>Packages provide means of customizing many of the details of how the
+package behaves.  These range from setting the default type size to
+changing the appearance of section headers.
+</p>
+
+
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Control-Characters.html Added

@@ -0,0 +1,137 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Control Characters (The GNU Troff Manual)</title>
+
+<meta name="description" content="Control Characters (The GNU Troff Manual)">
+<meta name="keywords" content="Control Characters (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Formatter-Instructions.html" rel="up" title="Formatter Instructions">
+<link href="Invoking-Requests.html" rel="next" title="Invoking Requests">
+<link href="Formatter-Instructions.html" rel="prev" title="Formatter Instructions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Control-Characters">
+<div class="nav-panel">
+<p>
+Next: <a href="Invoking-Requests.html" accesskey="n" rel="next">Invoking Requests</a>, Previous: <a href="Formatter-Instructions.html" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="Formatter-Instructions.html" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Control-Characters-1">5.6.1 Control Characters</h4>
+<a class="index-entry-id" id="index-control-characters"></a>
+<a class="index-entry-id" id="index-configuring-control-characters"></a>
+<a class="index-entry-id" id="index-changing-control-characters"></a>
+
+<p>The mechanism of using <code class="code">roff</code>&rsquo;s control characters to invoke
+requests and call macros was introduced in <a class="ref" href="Requests-and-Macros.html">Requests and Macros</a>.
+Control characters are recognized only at the beginning of an input
+line, or at the beginning of the branch of a control structure request;
+see <a class="ref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>.
+</p>
+<p>A few requests cause a break implicitly; use the no-break control
+character to prevent the break.  Break suppression is its sole
+behavioral distinction.  Employing the no-break control character to
+invoke requests that don&rsquo;t cause breaks is harmless but poor style.
+See <a class="xref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+<a class="index-entry-id" id="index-control-character_002c-changing-_0028cc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-control_002c-changing-_0028cc_0029"></a>
+<a class="index-entry-id" id="index-no_002dbreak-control-character_002c-changing-_0028c2_0029"></a>
+<a class="index-entry-id" id="index-character_002c-no_002dbreak-control_002c-changing-_0028c2_0029"></a>
+<a class="index-entry-id" id="index-control-character_002c-no_002dbreak_002c-changing-_0028c2_0029"></a>
+<p>The control &lsquo;<samp class="samp">.</samp>&rsquo; and no-break control &lsquo;<samp class="samp">'</samp>&rsquo; characters can each
+be changed to any ordinary character<a class="footnote" id="DOCF42" href="groff.html_fot.html#FOOT42"><sup>42</sup></a>
+with the <code class="code">cc</code> and <code class="code">c2</code> requests, respectively.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002ecc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cc"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the control character.
+If&nbsp;<var class="var">o</var> is absent or invalid, the default control character
+&lsquo;<samp class="samp">.</samp>&rsquo; is selected.  The identity of the control character is
+associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ec2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.c2</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002ec2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-c2"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the no-break control
+character.  If&nbsp;<var class="var">o</var> is absent or invalid, the default no-break
+control character &lsquo;<samp class="samp">'</samp>&rsquo; is selected.  The identity of the no-break
+control character is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<p>When writing a macro, you might wish to know which control character was
+used to call it.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ebr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.br</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ebr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ebr-1"></a>
+<p>This read-only register interpolates&nbsp;1 if the currently executing
+macro was called using the normal control character and&nbsp;0
+otherwise.  If a macro is interpolated as a string, the <code class="code">.br</code>
+register&rsquo;s value is inherited from the context of the string
+interpolation.  See <a class="xref" href="Strings.html">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-intercepting-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-intercepting"></a>
+<a class="index-entry-id" id="index-modifying-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-modifying"></a>
+<p>Use this register to reliably intercept requests that imply breaks.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als bp*orig bp
+.de bp
+.  ie \\n.br .bp*orig
+.  el          'bp*orig
+..
+</pre></div></div>
+
+<p>Testing the <code class="code">.br</code> register outside of a macro definition makes no
+sense.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Invoking-Requests.html">Invoking Requests</a>, Previous: <a href="Formatter-Instructions.html">Formatter Instructions</a>, Up: <a href="Formatter-Instructions.html">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Conventions-Used-in-This-Manual.html Added

@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Conventions Used in This Manual (The GNU Troff Manual)</title>
+
+<meta name="description" content="Conventions Used in This Manual (The GNU Troff Manual)">
+<meta name="keywords" content="Conventions Used in This Manual (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Credits.html" rel="next" title="Credits">
+<link href="Installation.html" rel="prev" title="Installation">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Conventions-Used-in-This-Manual">
+<div class="nav-panel">
+<p>
+Next: <a href="Credits.html" accesskey="n" rel="next">Credits</a>, Previous: <a href="Installation.html" accesskey="p" rel="prev">Installation</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Conventions-Used-in-This-Manual-1">1.8 Conventions Used in This Manual</h3>
+
+<p>We apply the term &ldquo;groff&rdquo; to the language documented here, the GNU
+implementation of the overall system, the project that develops that
+system, and the command of that name.  In the first sense, <code class="code">groff</code>
+is an extended dialect of the <code class="code">roff</code> language, for which many
+similar implementations exist.
+</p>
+<p>The <code class="code">roff</code> language features several major categories for which
+many items are predefined.  Presentations of these items feature the
+form in which the item is most commonly used on the left, and, aligned
+to the right margin, the name of the category in brackets.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bexample_005d"><span class="category-def">Register: </span><span><strong class="def-name">\nexample</strong><a class="copiable-link" href='#index-_005cn_005bexample_005d'> &para;</a></span></dt>
+<dd><p>The register &lsquo;<samp class="samp">example</samp>&rsquo; is one that that <code class="code">groff</code> <em class="emph">doesn&rsquo;t</em>
+predefine.  You can create it yourself, though; see <a class="ref" href="Setting-Registers.html">Setting Registers</a>.
+</p></dd></dl>
+
+<p>To make this document useful as a reference and not merely amiable
+bedtime reading, we tend to present these syntax items in exhaustive
+detail when they arise.  References to topics discussed later in the
+text are frequent; skip material you don&rsquo;t understand yet.
+</p>
+<p>We use Texinfo&rsquo;s &ldquo;result&rdquo; (&rArr;) and error&rarr; notations to
+present output written to the standard output and standard error
+streams, respectively.  Diagnostic messages from the GNU <code class="code">troff</code>
+formatter and other programs are examples of the latter, but the
+formatter can also be directed to write user-specified messages to the
+standard error stream.  The notation then serves to identify the
+output stream and does not necessarily mean that an error has
+occurred.<a class="footnote" id="DOCF2" href="groff.html_fot.html#FOOT2"><sup>2</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ echo &quot;Twelve o'clock and&quot; | groff -Tascii | sed '/^$/d'
+    &rArr; Twelve o'clock and
+$ echo '.tm all is well.' | groff &gt; /dev/null
+    error&rarr; all is well.
+</pre></div></div>
+
+<p>Sometimes we use &rArr; somewhat abstractly to represent formatted
+text that you will need to use a PostScript or PDF viewer program (or a
+printer) to observe.  While arguably an abuse of notation, we think this
+preferable to requiring the reader to understand the syntax of these
+page description languages.
+</p>
+<p>We also present diagnostic messages in an abbreviated form, often
+omitting the name of the program issuing them, the input file name, and
+line number or other positional information when such data do not serve
+to illuminate the topic under discussion.
+</p>
+<p>Most examples are of <code class="code">roff</code> language input that would be placed in
+a text file.  Occasionally, we start an example with a &lsquo;<samp class="samp">$</samp>&rsquo;
+character to indicate a shell prompt, as seen above.
+</p>
+<p>You are encouraged to try the examples yourself, and to alter them to
+better learn <code class="code">groff</code>&rsquo;s behavior.  Our examples frequently need to
+direct the formatter to set a line length (with &lsquo;<samp class="samp">.ll</samp>&rsquo;) that will
+fit within the page margins of this manual.  We mention this so that you
+know why it is there before we discuss the <code class="code">ll</code> request
+formally.<a class="footnote" id="DOCF3" href="groff.html_fot.html#FOOT3"><sup>3</sup></a>
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Credits.html">Credits</a>, Previous: <a href="Installation.html">Installation</a>, Up: <a href="Introduction.html">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Copy-Mode.html Added

@@ -0,0 +1,256 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Copy Mode (The GNU Troff Manual)</title>
+
+<meta name="description" content="Copy Mode (The GNU Troff Manual)">
+<meta name="keywords" content="Copy Mode (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Writing-Macros.html" rel="up" title="Writing Macros">
+<link href="Parameters.html" rel="prev" title="Parameters">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Copy-Mode">
+<div class="nav-panel">
+<p>
+Previous: <a href="Parameters.html" accesskey="p" rel="prev">Parameters</a>, Up: <a href="Writing-Macros.html" accesskey="u" rel="up">Writing Macros</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Copy-Mode-1">5.24.2 Copy Mode</h4>
+<a class="index-entry-id" id="index-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-copy"></a>
+<a class="index-entry-id" id="index-mode_002c-copy-1"></a>
+
+<a class="index-entry-id" id="index-_005cn_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005c_0024_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-when-reading-text-for-a-macro"></a>
+<a class="index-entry-id" id="index-_005cRET_002c-when-reading-text-for-a-macro"></a>
+<p>When GNU <code class="code">troff</code> processes certain requests, most importantly those
+which define or append to a macro or string, it does so in <em class="dfn">copy
+mode</em>: it copies the characters of the definition into a dedicated
+storage region, interpolating the escape sequences <code class="code">\n</code>, <code class="code">\g</code>,
+<code class="code">\$</code>, <code class="code">\*</code>, <code class="code">\V</code>, and <code class="code">\?</code> normally; interpreting
+<code class="code">\<kbd class="key">RET</kbd></code> immediately; discarding comments <code class="code">\&quot;</code> and
+<code class="code">\#</code>; interpolating the current leader, escape, or tab character
+with <code class="code">\a</code>, <code class="code">\e</code>, and <code class="code">\t</code>, respectively; and storing all
+other escape sequences in an encoded form.
+</p>
+<a class="index-entry-id" id="index-interpretation-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-interpretation"></a>
+<p>The complement of copy mode&mdash;a <code class="code">roff</code> formatter&rsquo;s behavior when
+not defining or appending to a macro, string, or diversion&mdash;where all
+macros are interpolated, requests invoked, and valid escape sequences
+processed immediately upon recognition, can be termed
+<em class="dfn">interpretation mode</em>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\\</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005c"></a>
+<p>The escape character, <code class="code">\</code> by default, can escape itself.  This
+enables you to control whether a given <code class="code">\n</code>, <code class="code">\g</code>, <code class="code">\$</code>,
+<code class="code">\*</code>, <code class="code">\V</code>, or <code class="code">\?</code> escape sequence is interpreted at the
+time the macro containing it is defined, or later when the macro is
+called.<a class="footnote" id="DOCF101" href="groff.html_fot.html#FOOT101"><sup>101</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 20
+.de y
+.nr x 10
+\&amp;\nx
+\&amp;\\nx
+..
+.y
+    &rArr; 20 10
+</pre></div></div>
+
+<p>You can think of <code class="code">\\</code> as a &ldquo;delayed&rdquo; backslash; it is the escape
+character followed by a backslash from which the escape character has
+removed its special meaning.  Consequently, &lsquo;<samp class="samp">\\</samp>&rsquo; is not an escape
+sequence in the usual sense.  In any escape sequence &lsquo;<samp class="samp">\<var class="var">X</var></samp>&rsquo;
+that GNU <code class="code">troff</code> does not recognize, the escape character is
+ignored and <var class="var">X</var> is output.  An unrecognized escape sequence causes
+a warning in category &lsquo;<samp class="samp">escape</samp>&rsquo;, with two exceptions&mdash;&lsquo;<samp class="samp">\\</samp>&rsquo; is
+the first.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-_005c_005c_002c-when-reading-text-for-a-macro"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\.</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002e"></a>
+<p><code class="code">\.</code> escapes the control character.  It is similar to <code class="code">\\</code> in
+that it isn&rsquo;t a true escape sequence.  It is used to permit nested macro
+definitions to end without a named macro call to conclude them.  Without
+a syntax for escaping the control character, this would not be possible.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de m1
+foo
+.
+.  de m2
+bar
+\\..
+.
+..
+.m1
+.m2
+    &rArr; foo bar
+</pre></div></div>
+
+<p>The first backslash is consumed while the macro is read, and the second
+is interpreted when macro <code class="code">m1</code> is called.
+</p></dd></dl>
+
+<p><code class="code">roff</code> documents should not use the <code class="code">\\</code> or <code class="code">\.</code>
+character sequences outside of copy mode; they serve only to obfuscate
+the input.  Use <code class="code">\e</code> to represent the escape character,
+<code class="code">\rs</code> to obtain a backslash glyph, and <code class="code">\&amp;</code> before &lsquo;<samp class="samp">.</samp>&rsquo;
+and &lsquo;<samp class="samp">'</samp>&rsquo; where GNU <code class="code">troff</code> expects them as control characters
+if you mean to use them literally (recall <a class="ref" href="Requests-and-Macros.html">Requests and Macros</a>).
+</p>
+<p>Macro definitions can be nested to arbitrary depth.  The mechanics of
+parsing the escape character have significant consequences for this
+practice.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de M1
+\\$1
+.  de M2
+\\\\$1
+.    de M3
+\\\\\\\\$1
+\\\\..
+.    M3 hand.
+\\..
+.  M2 of
+..
+This understeer is getting
+.M1 out
+    &rArr; This understeer is getting out of hand.
+</pre></div></div>
+
+<p>Each escape character is interpreted twice&mdash;once in copy mode, when the
+macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of
+<code class="code">\n</code>, <code class="code">\g</code>, <code class="code">\$</code>, <code class="code">\*</code>, <code class="code">\V</code>, and <code class="code">\?</code> at
+each nesting level, which can be daunting.  GNU <code class="code">troff</code> offers a
+solution.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cE-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\E</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cE-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cE"></a>
+<p><code class="code">\E</code> represents an escape character that is not interpreted in copy
+mode.  You can use it to ease the writing of nested macro definitions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de M1
+.  nop \E$1
+.  de M2
+.    nop \E$1
+.    de M3
+.      nop \E$1
+\\\\..
+.    M3 better.
+\\..
+.  M2 bit
+..
+This vehicle handles
+.M1 a
+    &rArr; This vehicle handles a bit better.
+</pre></div></div>
+
+<p>Observe that because <code class="code">\.</code> is not a true escape sequence, we can&rsquo;t
+use <code class="code">\E</code> to keep &lsquo;<samp class="samp">..</samp>&rsquo; from ending a macro definition
+prematurely.  If the multiplicity of backslashes complicates
+maintenance, use end macros.
+</p>
+<p><code class="code">\E</code> is also convenient to define strings containing escape
+sequences that need to work when used in copy mode (for example, as
+macro arguments), or which will be interpolated at varying macro nesting
+depths.  We might define strings to begin and end superscripting
+as follows.<a class="footnote" id="DOCF102" href="groff.html_fot.html#FOOT102"><sup>102</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds { \v'-.9m\s'\En.s*7u/10u'+.7m'
+.ds } \v'-.7m\s0+.9m'
+</pre></div></div>
+
+<p>When the <code class="code">ec</code> request is used to redefine the escape character,
+<code class="code">\E</code> also makes it easier to distinguish the semantics of an escape
+character from the other meaning(s) its character might have.  Consider
+the use of an unusual escape character, &lsquo;<samp class="samp">-</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.ec -
+.de xx
+--na
+..
+.xx
+    &rArr; -na
+</pre></div></div>
+
+<p>This result may surprise you; some people expect &lsquo;<samp class="samp">1</samp>&rsquo; to be output
+since register &lsquo;<samp class="samp">a</samp>&rsquo; has clearly been defined with that value.  What
+has happened?  The robotic replacement of &lsquo;<samp class="samp">\</samp>&rsquo; with &lsquo;<samp class="samp">-</samp>&rsquo; has led
+us astray.  You might recognize the sequence &lsquo;<samp class="samp">--</samp>&rsquo; more readily with
+the default escape character as &lsquo;<samp class="samp">\-</samp>&rsquo;, the special character escape
+sequence for the minus sign glyph.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.ec -
+.de xx
+-Ena
+..
+.xx
+    &rArr; 1
+</pre></div></div>
+</dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Parameters.html">Parameters</a>, Up: <a href="Writing-Macros.html">Writing Macros</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Copying-This-Manual.html Added

@@ -0,0 +1,534 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Copying This Manual (The GNU Troff Manual)</title>
+
+<meta name="description" content="Copying This Manual (The GNU Troff Manual)">
+<meta name="keywords" content="Copying This Manual (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Request-Index.html" rel="next" title="Request Index">
+<link href="Font-Description-File-Format.html" rel="prev" title="Font Description File Format">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Copying-This-Manual">
+<div class="nav-panel">
+<p>
+Next: <a href="Request-Index.html" accesskey="n" rel="next">Request Index</a>, Previous: <a href="Font-Description-File-Format.html" accesskey="p" rel="prev">Font Description File Format</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Copying-This-Manual-1">Appendix A Copying This Manual</h2>
+
+<div class="center">Version 1.3, 3 November 2008
+</div>
+
+<div class="display">
+<pre class="display-preformatted">Copyright &copy; 2000-2018 Free Software Foundation, Inc.
+<a class="uref" href="http://fsf.org/">http://fsf.org/</a>
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+</pre></div>
+
+<ol class="enumerate" start="0">
+<li> PREAMBLE
+
+<p>The purpose of this License is to make a manual, textbook, or other
+functional and useful document <em class="dfn">free</em> in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
+</p>
+<p>This License is a kind of &ldquo;copyleft&rdquo;, which means that derivative
+works of the document must themselves be free in the same sense.  It
+complements the GNU General Public License, which is a copyleft
+license designed for free software.
+</p>
+<p>We have designed this License in order to use it for manuals for free
+software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does.  But this License is not limited to software manuals;
+it can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book.  We recommend this License
+principally for works whose purpose is instruction or reference.
+</p>
+</li><li> APPLICABILITY AND DEFINITIONS
+
+<p>This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License.  Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein.  The &ldquo;Document&rdquo;, below,
+refers to any such manual or work.  Any member of the public is a
+licensee, and is addressed as &ldquo;you&rdquo;.  You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
+</p>
+<p>A &ldquo;Modified Version&rdquo; of the Document means any work containing the
+Document or a portion of it, either copied verbatim, or with
+modifications and/or translated into another language.
+</p>
+<p>A &ldquo;Secondary Section&rdquo; is a named appendix or a front-matter section
+of the Document that deals exclusively with the relationship of the
+publishers or authors of the Document to the Document&rsquo;s overall
+subject (or to related matters) and contains nothing that could fall
+directly within that overall subject.  (Thus, if the Document is in
+part a textbook of mathematics, a Secondary Section may not explain
+any mathematics.)  The relationship could be a matter of historical
+connection with the subject or with related matters, or of legal,
+commercial, philosophical, ethical or political position regarding
+them.
+</p>
+<p>The &ldquo;Invariant Sections&rdquo; are certain Secondary Sections whose titles
+are designated, as being those of Invariant Sections, in the notice
+that says that the Document is released under this License.  If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant.  The Document may contain zero
+Invariant Sections.  If the Document does not identify any Invariant
+Sections then there are none.
+</p>
+<p>The &ldquo;Cover Texts&rdquo; are certain short passages of text that are listed,
+as Front-Cover Texts or Back-Cover Texts, in the notice that says that
+the Document is released under this License.  A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
+</p>
+<p>A &ldquo;Transparent&rdquo; copy of the Document means a machine-readable copy,
+represented in a format whose specification is available to the
+general public, that is suitable for revising the document
+straightforwardly with generic text editors or (for images composed of
+pixels) generic paint programs or (for drawings) some widely available
+drawing editor, and that is suitable for input to text formatters or
+for automatic translation to a variety of formats suitable for input
+to text formatters.  A copy made in an otherwise Transparent file
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text.  A copy that is not &ldquo;Transparent&rdquo; is called &ldquo;Opaque&rdquo;.
+</p>
+<p>Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input
+format, SGML or XML using a publicly available
+DTD, and standard-conforming simple HTML,
+PostScript or PDF designed for human modification.  Examples
+of transparent image formats include PNG, XCF and
+JPG.  Opaque formats include proprietary formats that can be
+read and edited only by proprietary word processors, SGML or
+XML for which the DTD and/or processing tools are
+not generally available, and the machine-generated HTML,
+PostScript or PDF produced by some word processors for
+output purposes only.
+</p>
+<p>The &ldquo;Title Page&rdquo; means, for a printed book, the title page itself,
+plus such following pages as are needed to hold, legibly, the material
+this License requires to appear in the title page.  For works in
+formats which do not have any title page as such, &ldquo;Title Page&rdquo; means
+the text near the most prominent appearance of the work&rsquo;s title,
+preceding the beginning of the body of the text.
+</p>
+<p>The &ldquo;publisher&rdquo; means any person or entity that distributes copies
+of the Document to the public.
+</p>
+<p>A section &ldquo;Entitled XYZ&rdquo; means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language.  (Here XYZ stands for a
+specific section name mentioned below, such as &ldquo;Acknowledgements&rdquo;,
+&ldquo;Dedications&rdquo;, &ldquo;Endorsements&rdquo;, or &ldquo;History&rdquo;.)  To &ldquo;Preserve the Title&rdquo;
+of such a section when you modify the Document means that it remains a
+section &ldquo;Entitled XYZ&rdquo; according to this definition.
+</p>
+<p>The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document.  These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+</p>
+</li><li> VERBATIM COPYING
+
+<p>You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies
+to the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License.  You may not use
+technical measures to obstruct or control the reading or further
+copying of the copies you make or distribute.  However, you may accept
+compensation in exchange for copies.  If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+</p>
+<p>You may also lend copies, under the same conditions stated above, and
+you may publicly display copies.
+</p>
+</li><li> COPYING IN QUANTITY
+
+<p>If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document&rsquo;s license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
+Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
+the back cover.  Both covers must also clearly and legibly identify
+you as the publisher of these copies.  The front cover must present
+the full title with all words of the title equally prominent and
+visible.  You may add other material on the covers in addition.
+Copying with changes limited to the covers, as long as they preserve
+the title of the Document and satisfy these conditions, can be treated
+as verbatim copying in other respects.
+</p>
+<p>If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+</p>
+<p>If you publish or distribute Opaque copies of the Document numbering
+more than 100, you must either include a machine-readable Transparent
+copy along with each Opaque copy, or state in or with each Opaque copy
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
+</p>
+<p>It is requested, but not required, that you contact the authors of the
+Document well before redistributing any large number of copies, to give
+them a chance to provide you with an updated version of the Document.
+</p>
+</li><li> MODIFICATIONS
+
+<p>You may copy and distribute a Modified Version of the Document under
+the conditions of sections 2 and 3 above, provided that you release
+the Modified Version under precisely this License, with the Modified
+Version filling the role of the Document, thus licensing distribution
+and modification of the Modified Version to whoever possesses a copy
+of it.  In addition, you must do these things in the Modified Version:
+</p>
+<ol class="enumerate" type="A" start="1">
+<li> Use in the Title Page (and on the covers, if any) a title distinct
+from that of the Document, and from those of previous versions
+(which should, if there were any, be listed in the History section
+of the Document).  You may use the same title as a previous version
+if the original publisher of that version gives permission.
+
+</li><li> List on the Title Page, as authors, one or more persons or entities
+responsible for authorship of the modifications in the Modified
+Version, together with at least five of the principal authors of the
+Document (all of its principal authors, if it has fewer than five),
+unless they release you from this requirement.
+
+</li><li> State on the Title page the name of the publisher of the
+Modified Version, as the publisher.
+
+</li><li> Preserve all the copyright notices of the Document.
+
+</li><li> Add an appropriate copyright notice for your modifications
+adjacent to the other copyright notices.
+
+</li><li> Include, immediately after the copyright notices, a license notice
+giving the public permission to use the Modified Version under the
+terms of this License, in the form shown in the Addendum below.
+
+</li><li> Preserve in that license notice the full lists of Invariant Sections
+and required Cover Texts given in the Document&rsquo;s license notice.
+
+</li><li> Include an unaltered copy of this License.
+
+</li><li> Preserve the section Entitled &ldquo;History&rdquo;, Preserve its Title, and add
+to it an item stating at least the title, year, new authors, and
+publisher of the Modified Version as given on the Title Page.  If
+there is no section Entitled &ldquo;History&rdquo; in the Document, create one
+stating the title, year, authors, and publisher of the Document as
+given on its Title Page, then add an item describing the Modified
+Version as stated in the previous sentence.
+
+</li><li> Preserve the network location, if any, given in the Document for
+public access to a Transparent copy of the Document, and likewise
+the network locations given in the Document for previous versions
+it was based on.  These may be placed in the &ldquo;History&rdquo; section.
+You may omit a network location for a work that was published at
+least four years before the Document itself, or if the original
+publisher of the version it refers to gives permission.
+
+</li><li> For any section Entitled &ldquo;Acknowledgements&rdquo; or &ldquo;Dedications&rdquo;, Preserve
+the Title of the section, and preserve in the section all the
+substance and tone of each of the contributor acknowledgements and/or
+dedications given therein.
+
+</li><li> Preserve all the Invariant Sections of the Document,
+unaltered in their text and in their titles.  Section numbers
+or the equivalent are not considered part of the section titles.
+
+</li><li> Delete any section Entitled &ldquo;Endorsements&rdquo;.  Such a section
+may not be included in the Modified Version.
+
+</li><li> Do not retitle any existing section to be Entitled &ldquo;Endorsements&rdquo; or
+to conflict in title with any Invariant Section.
+
+</li><li> Preserve any Warranty Disclaimers.
+</li></ol>
+
+<p>If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant.  To do this, add their titles to the
+list of Invariant Sections in the Modified Version&rsquo;s license notice.
+These titles must be distinct from any other section titles.
+</p>
+<p>You may add a section Entitled &ldquo;Endorsements&rdquo;, provided it contains
+nothing but endorsements of your Modified Version by various
+parties&mdash;for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+</p>
+<p>You may add a passage of up to five words as a Front-Cover Text, and a
+passage of up to 25 words as a Back-Cover Text, to the end of the list
+of Cover Texts in the Modified Version.  Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or
+through arrangements made by) any one entity.  If the Document already
+includes a cover text for the same cover, previously added by you or
+by arrangement made by the same entity you are acting on behalf of,
+you may not add another; but you may replace the old one, on explicit
+permission from the previous publisher that added the old one.
+</p>
+<p>The author(s) and publisher(s) of the Document do not by this License
+give permission to use their names for publicity for or to assert or
+imply endorsement of any Modified Version.
+</p>
+</li><li> COMBINING DOCUMENTS
+
+<p>You may combine the Document with other documents released under this
+License, under the terms defined in section 4 above for modified
+versions, provided that you include in the combination all of the
+Invariant Sections of all of the original documents, unmodified, and
+list them all as Invariant Sections of your combined work in its
+license notice, and that you preserve all their Warranty Disclaimers.
+</p>
+<p>The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy.  If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by
+adding at the end of it, in parentheses, the name of the original
+author or publisher of that section if known, or else a unique number.
+Make the same adjustment to the section titles in the list of
+Invariant Sections in the license notice of the combined work.
+</p>
+<p>In the combination, you must combine any sections Entitled &ldquo;History&rdquo;
+in the various original documents, forming one section Entitled
+&ldquo;History&rdquo;; likewise combine any sections Entitled &ldquo;Acknowledgements&rdquo;,
+and any sections Entitled &ldquo;Dedications&rdquo;.  You must delete all
+sections Entitled &ldquo;Endorsements.&rdquo;
+</p>
+</li><li> COLLECTIONS OF DOCUMENTS
+
+<p>You may make a collection consisting of the Document and other documents
+released under this License, and replace the individual copies of this
+License in the various documents with a single copy that is included in
+the collection, provided that you follow the rules of this License for
+verbatim copying of each of the documents in all other respects.
+</p>
+<p>You may extract a single document from such a collection, and distribute
+it individually under this License, provided you insert a copy of this
+License into the extracted document, and follow this License in all
+other respects regarding verbatim copying of that document.
+</p>
+</li><li> AGGREGATION WITH INDEPENDENT WORKS
+
+<p>A compilation of the Document or its derivatives with other separate
+and independent documents or works, in or on a volume of a storage or
+distribution medium, is called an &ldquo;aggregate&rdquo; if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation&rsquo;s users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+</p>
+<p>If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document&rsquo;s Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
+</p>
+</li><li> TRANSLATION
+
+<p>Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections.  You may include a
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers.  In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+</p>
+<p>If a section in the Document is Entitled &ldquo;Acknowledgements&rdquo;,
+&ldquo;Dedications&rdquo;, or &ldquo;History&rdquo;, the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
+</p>
+</li><li> TERMINATION
+
+<p>You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense, or distribute it is void, and
+will automatically terminate your rights under this License.
+</p>
+<p>However, if you cease all violation of this License, then your license
+from a particular copyright holder is reinstated (a) provisionally,
+unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder
+fails to notify you of the violation by some reasonable means prior to
+60 days after the cessation.
+</p>
+<p>Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+</p>
+<p>Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, receipt of a copy of some or all of the same material does
+not give you any rights to use it.
+</p>
+</li><li> FUTURE REVISIONS OF THIS LICENSE
+
+<p>The Free Software Foundation may publish new, revised versions
+of the GNU Free Documentation License from time to time.  Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.  See
+<a class="uref" href="http://www.gnu.org/copyleft/">http://www.gnu.org/copyleft/</a>.
+</p>
+<p>Each version of the License is given a distinguishing version number.
+If the Document specifies that a particular numbered version of this
+License &ldquo;or any later version&rdquo; applies to it, you have the option of
+following the terms and conditions either of that specified version or
+of any later version that has been published (not as a draft) by the
+Free Software Foundation.  If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.  If the Document
+specifies that a proxy can decide which future versions of this
+License can be used, that proxy&rsquo;s public statement of acceptance of a
+version permanently authorizes you to choose that version for the
+Document.
+</p>
+</li><li> RELICENSING
+
+<p>&ldquo;Massive Multiauthor Collaboration Site&rdquo; (or &ldquo;MMC Site&rdquo;) means any
+World Wide Web server that publishes copyrightable works and also
+provides prominent facilities for anybody to edit those works.  A
+public wiki that anybody can edit is an example of such a server.  A
+&ldquo;Massive Multiauthor Collaboration&rdquo; (or &ldquo;MMC&rdquo;) contained in the
+site means any set of copyrightable works thus published on the MMC
+site.
+</p>
+<p>&ldquo;CC-BY-SA&rdquo; means the Creative Commons Attribution-Share Alike 3.0
+license published by Creative Commons Corporation, a not-for-profit
+corporation with a principal place of business in San Francisco,
+California, as well as future copyleft versions of that license
+published by that same organization.
+</p>
+<p>&ldquo;Incorporate&rdquo; means to publish or republish a Document, in whole or
+in part, as part of another Document.
+</p>
+<p>An MMC is &ldquo;eligible for relicensing&rdquo; if it is licensed under this
+License, and if all works that were first published under this License
+somewhere other than this MMC, and subsequently incorporated in whole
+or in part into the MMC, (1) had no cover texts or invariant sections,
+and (2) were thus incorporated prior to November 1, 2008.
+</p>
+<p>The operator of an MMC Site may republish an MMC contained in the site
+under CC-BY-SA on the same site at any time before August 1, 2009,
+provided the MMC is eligible for relicensing.
+</p>
+</li></ol>
+
+<h3 class="heading" id="ADDENDUM_003a-How-to-use-this-License-for-your-documents">ADDENDUM: How to use this License for your documents</h3>
+
+<p>To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and
+license notices just after the title page:
+</p>
+<div class="example smallexample">
+<div class="group"><pre class="example-preformatted">  Copyright (C)  <var class="var">year</var>  <var class="var">your name</var>.
+  Permission is granted to copy, distribute and/or modify this document
+  under the terms of the GNU Free Documentation License, Version 1.3
+  or any later version published by the Free Software Foundation;
+  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+  Texts.  A copy of the license is included in the section entitled ``GNU
+  Free Documentation License''.
+</pre></div></div>
+
+<p>If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+replace the &ldquo;with&hellip;Texts.&rdquo; line with this:
+</p>
+<div class="example smallexample">
+<div class="group"><pre class="example-preformatted">    with the Invariant Sections being <var class="var">list their titles</var>, with
+    the Front-Cover Texts being <var class="var">list</var>, and with the Back-Cover Texts
+    being <var class="var">list</var>.
+</pre></div></div>
+
+<p>If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+</p>
+<p>If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of
+free software license, such as the GNU General Public License,
+to permit their use in free software.
+</p>
+
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Request-Index.html">Request Index</a>, Previous: <a href="Font-Description-File-Format.html">Font Description File Format</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Credits.html Added

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Credits (The GNU Troff Manual)</title>
+
+<meta name="description" content="Credits (The GNU Troff Manual)">
+<meta name="keywords" content="Credits (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Conventions-Used-in-This-Manual.html" rel="prev" title="Conventions Used in This Manual">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Credits">
+<div class="nav-panel">
+<p>
+Previous: <a href="Conventions-Used-in-This-Manual.html" accesskey="p" rel="prev">Conventions Used in This Manual</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Credits-1">1.9 Credits</h3>
+<a class="index-entry-id" id="index-credits"></a>
+
+<p>We adapted portions of this manual from existing documents.  James
+Clark&rsquo;s man pages were an essential resource; we have updated them in
+parallel with the development of this manual.  We based the tutorial for
+macro users on Eric Allman&rsquo;s introduction to his <samp class="file">me</samp> macro package
+(which we also provide, little altered from 4.4BSD).  Larry Kollar
+contributed much of the material on the <samp class="file">ms</samp> macro package.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/DESC-File-Format.html Added

@@ -0,0 +1,258 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>DESC File Format (The GNU Troff Manual)</title>
+
+<meta name="description" content="DESC File Format (The GNU Troff Manual)">
+<meta name="keywords" content="DESC File Format (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Device-and-Font-Description-Files.html" rel="up" title="Device and Font Description Files">
+<link href="Font-Description-File-Format.html" rel="next" title="Font Description File Format">
+<link href="Device-and-Font-Description-Files.html" rel="prev" title="Device and Font Description Files">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="DESC-File-Format">
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Description-File-Format.html" accesskey="n" rel="next">Font Description File Format</a>, Previous: <a href="Device-and-Font-Description-Files.html" accesskey="p" rel="prev">Device and Font Description Files</a>, Up: <a href="Device-and-Font-Description-Files.html" accesskey="u" rel="up">Device and Font Description Files</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="DESC-File-Format-1">6.2.1 <samp class="file">DESC</samp> File Format</h4>
+<a class="index-entry-id" id="index-DESC-file-format"></a>
+<a class="index-entry-id" id="index-font-description-file-format"></a>
+<a class="index-entry-id" id="index-format-of-font-description-file"></a>
+
+<p>The <samp class="file">DESC</samp> file contains a series of directives; each begins a
+line.  Their order is not important, with two exceptions: (1) the
+<code class="code">res</code> directive must precede any <code class="code">papersize</code> directive; and
+(2) the <code class="code">charset</code> directive must come last (if at all).  If a
+directive name is repeated, later entries in the file override previous
+ones (except that the paper dimensions are computed based on the
+<code class="code">res</code> directive last seen when <code class="code">papersize</code> is encountered).
+Spaces and/or tabs separate words and are ignored at line boundaries.
+<a class="index-entry-id" id="index-comments-in-device-description-files"></a>
+<a class="index-entry-id" id="index-device-description-files_002c-comments"></a>
+<a class="index-entry-id" id="index-_0023"></a>
+Comments start with the &lsquo;<samp class="samp">#</samp>&rsquo; character and extend to the end of a
+line.  Empty lines are ignored.
+</p>
+<dl class="table">
+<dt id='index-family-1'><span><code class="code">family <var class="var">fam</var></code><a class="copiable-link" href='#index-family-1'> &para;</a></span></dt>
+<dd><p>The default font family is <var class="var">fam</var>.
+</p>
+</dd>
+<dt id='index-fonts-2'><span><code class="code">fonts <var class="var">n</var> <var class="var">F1</var> <span class="r">&hellip;</span> <var class="var">Fn</var></code><a class="copiable-link" href='#index-fonts-2'> &para;</a></span></dt>
+<dd><p>Fonts <var class="var">F1</var>, &hellip;, <var class="var">Fn</var> are mounted at font positions
+<var class="var">m</var>+1, &hellip;, <var class="var">m</var>+<var class="var">n</var> where <var class="var">m</var> is the number of
+<code class="code">styles</code> (see below).  This directive may extend over more than one
+line.  A font name of&nbsp;<code class="code">0</code> causes no font to be mounted at the
+corresponding position.
+</p>
+</dd>
+<dt id='index-hor'><span><code class="code">hor <var class="var">n</var></code><a class="copiable-link" href='#index-hor'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-horizontal-motion-quantum"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-horizontal"></a>
+<a class="index-entry-id" id="index-quantum_002c-horizontal-motion"></a>
+<a class="index-entry-id" id="index-horizontal-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-horizontal"></a>
+<p>The horizontal motion quantum is <var class="var">n</var>&nbsp;basic units.  All
+horizontal quantities are rounded to multiples of&nbsp;<var class="var">n</var>.
+</p>
+</dd>
+<dt id='index-image_005fgenerator'><span><code class="code">image_generator <var class="var">program</var></code><a class="copiable-link" href='#index-image_005fgenerator'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PostScript_002c-PNG-image-generation"></a>
+<a class="index-entry-id" id="index-PNG-image-generation-from-PostScript"></a>
+<p>Use <var class="var">program</var> to generate PNG images from PostScript input.  Under
+GNU/Linux, this is usually <code class="code">gs</code>, but under other systems (notably
+Cygwin) it might be set to another name.  The <code class="code">grohtml</code> driver uses
+this directive.
+</p>
+</dd>
+<dt id='index-paperlength'><span><code class="code">paperlength <var class="var">n</var></code><a class="copiable-link" href='#index-paperlength'> &para;</a></span></dt>
+<dd><p>The vertical dimension of the output medium is <var class="var">n</var>&nbsp;basic units
+(deprecated: use <code class="code">papersize</code> instead).
+</p>
+</dd>
+<dt id='index-papersize'><span><code class="code">papersize <var class="var">format-or-dimension-pair-or-file-name</var> <span class="r">&hellip;</span></code><a class="copiable-link" href='#index-papersize'> &para;</a></span></dt>
+<dd><p>The dimensions of the output medium are as according to the
+argument, which is either a standard paper format, a pair of dimensions,
+or the name of a plain text file containing either of the foregoing.
+</p>
+<p>Recognized paper formats are the ISO and DIN formats
+<code class="code">A0</code>&ndash;<code class="code">A7</code>, <code class="code">B0</code>&ndash;<code class="code">B7</code>, <code class="code">C0</code>&ndash;<code class="code">C7</code>,
+<code class="code">D0</code>&ndash;<code class="code">D7</code>; the U.S. paper types <code class="code">letter</code>,
+<code class="code">legal</code>, <code class="code">tabloid</code>, <code class="code">ledger</code>, <code class="code">statement</code>, and
+<code class="code">executive</code>; and the envelope formats <code class="code">com10</code>, <code class="code">monarch</code>,
+and <code class="code">DL</code>.  Matching is performed without regard for lettercase.
+</p>
+<p>Alternatively, the argument can be a custom paper format in the format
+<code class="code"><var class="var">length</var>,<var class="var">width</var></code> (with no spaces before or after the
+comma).  Both <var class="var">length</var> and <var class="var">width</var> must have a unit appended;
+valid units are &lsquo;<samp class="samp">i</samp>&rsquo; for inches, &lsquo;<samp class="samp">c</samp>&rsquo; for centimeters, &lsquo;<samp class="samp">p</samp>&rsquo;
+for points, and &lsquo;<samp class="samp">P</samp>&rsquo; for picas.  Example: &lsquo;<samp class="samp">12c,235p</samp>&rsquo;.  An
+argument that starts with a digit is always treated as a custom paper
+format.
+</p>
+<p>Finally, the argument can be a file name (e.g., <samp class="file">/etc/papersize</samp>);
+if the file can be opened, the first line is read and a match attempted
+against each of the other forms.  No comment syntax is supported.
+</p>
+<p>More than one argument can be specified;
+each is scanned in turn and the first valid paper specification used.
+</p>
+</dd>
+<dt id='index-paperwidth'><span><code class="code">paperwidth <var class="var">n</var></code><a class="copiable-link" href='#index-paperwidth'> &para;</a></span></dt>
+<dd><p>The horizontal dimension of the output medium is <var class="var">n</var>&nbsp;basic
+units (deprecated: use <code class="code">papersize</code> instead).
+</p>
+</dd>
+<dt id='index-pass_005ffilenames'><span><code class="code">pass_filenames</code><a class="copiable-link" href='#index-pass_005ffilenames'> &para;</a></span></dt>
+<dd><p>Direct GNU <code class="code">troff</code> to emit the name of the source file being
+processed.  This is achieved with the intermediate output command
+&lsquo;<samp class="samp">x F</samp>&rsquo;, which <code class="code">grohtml</code> interprets.
+</p>
+</dd>
+<dt id='index-postpro'><span><code class="code">postpro <var class="var">program</var></code><a class="copiable-link" href='#index-postpro'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as the postprocessor.
+</p>
+</dd>
+<dt id='index-prepro'><span><code class="code">prepro <var class="var">program</var></code><a class="copiable-link" href='#index-prepro'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as a preprocessor.  The <code class="code">html</code> and <code class="code">xhtml</code>
+output devices use this directive.
+</p>
+</dd>
+<dt id='index-print'><span><code class="code">print <var class="var">program</var></code><a class="copiable-link" href='#index-print'> &para;</a></span></dt>
+<dd><p>Use <var class="var">program</var> as a spooler program for printing.  If omitted, the
+<samp class="option">-l</samp> and <samp class="option">-L</samp> options of <code class="code">groff</code> are ignored.
+</p>
+</dd>
+<dt id='index-res'><span><code class="code">res <var class="var">n</var></code><a class="copiable-link" href='#index-res'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-device-resolution-1"></a>
+<a class="index-entry-id" id="index-resolution_002c-device-1"></a>
+<p>The device resolution is <var class="var">n</var>&nbsp;basic units per inch.
+</p>
+</dd>
+<dt id='index-sizes'><span><code class="code">sizes <var class="var">s1</var> <span class="r">&hellip;</span> <var class="var">sn</var> 0</code><a class="copiable-link" href='#index-sizes'> &para;</a></span></dt>
+<dd><p>The device has fonts at <var class="var">s1</var>, &hellip;, <var class="var">sn</var> scaled points (see
+below).  The list of sizes must be terminated by&nbsp;<code class="code">0</code>.  Each
+<var class="var">si</var> can also be a range of sizes <var class="var">m</var>&ndash;<var class="var">n</var>.  The list can
+extend over more than one line.
+</p>
+</dd>
+<dt id='index-sizescale'><span><code class="code">sizescale <var class="var">n</var></code><a class="copiable-link" href='#index-sizescale'> &para;</a></span></dt>
+<dd><p>A typographical point is subdivided into <var class="var">n</var>&nbsp;scaled points.
+The default is&nbsp;<code class="code">1</code>.  See <a class="xref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>.
+</p>
+</dd>
+<dt id='index-styles-2'><span><code class="code">styles <var class="var">S1</var> <span class="r">&hellip;</span> <var class="var">Sm</var></code><a class="copiable-link" href='#index-styles-2'> &para;</a></span></dt>
+<dd><p>The first&nbsp;<var class="var">m</var> mounting positions are associated with styles
+<var class="var">S1</var>, &hellip;, <var class="var">Sm</var>.
+</p>
+</dd>
+<dt id='index-tcommand'><span><code class="code">tcommand</code><a class="copiable-link" href='#index-tcommand'> &para;</a></span></dt>
+<dd><p>The postprocessor can handle the &lsquo;<samp class="samp">t</samp>&rsquo; and &lsquo;<samp class="samp">u</samp>&rsquo; intermediate
+output commands.
+</p>
+</dd>
+<dt id='index-unicode'><span><code class="code">unicode</code><a class="copiable-link" href='#index-unicode'> &para;</a></span></dt>
+<dd><p>The output device supports the complete Unicode repertoire.  This
+directive is useful only for devices that produce character entities
+instead of glyphs.
+</p>
+<p>If <code class="code">unicode</code> is present, no <code class="code">charset</code> section is required in
+the font description files since the Unicode handling built into
+<code class="code">groff</code> is used.  However, if there are entries in a font
+description file&rsquo;s <code class="code">charset</code> section, they either override the
+default mappings for those particular characters or add new mappings
+(normally for composite characters).
+</p>
+<p>The <code class="code">utf8</code>, <code class="code">html</code>, and <code class="code">xhtml</code> output devices use this
+directive.
+</p>
+</dd>
+<dt id='index-unitwidth'><span><code class="code">unitwidth <var class="var">n</var></code><a class="copiable-link" href='#index-unitwidth'> &para;</a></span></dt>
+<dd><p>Quantities in the font description files are in basic units for fonts
+whose type size is <var class="var">n</var>&nbsp;scaled points.
+</p>
+</dd>
+<dt id='index-unscaled_005fcharwidths'><span><code class="code">unscaled_charwidths</code><a class="copiable-link" href='#index-unscaled_005fcharwidths'> &para;</a></span></dt>
+<dd><p>Make the font handling module always return unscaled character widths.
+The <code class="code">grohtml</code> driver uses this directive.
+</p>
+</dd>
+<dt id='index-use_005fcharnames_005fin_005fspecial-1'><span><code class="code">use_charnames_in_special</code><a class="copiable-link" href='#index-use_005fcharnames_005fin_005fspecial-1'> &para;</a></span></dt>
+<dd><p>GNU <code class="code">troff</code> should encode special characters inside device control
+commands; see <a class="ref" href="Postprocessor-Access.html">Postprocessor Access</a>.  The <code class="code">grohtml</code> driver
+uses this directive.
+</p>
+</dd>
+<dt id='index-vert'><span><code class="code">vert <var class="var">n</var></code><a class="copiable-link" href='#index-vert'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vertical-motion-quantum"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-vertical"></a>
+<a class="index-entry-id" id="index-quantum_002c-vertical-motion"></a>
+<a class="index-entry-id" id="index-vertical-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-vertical"></a>
+<p>The vertical motion quantum is <var class="var">n</var>&nbsp;basic units.  All vertical
+quantities are rounded to multiples of&nbsp;<var class="var">n</var>.
+</p>
+</dd>
+<dt id='index-charset'><span><code class="code">charset</code><a class="copiable-link" href='#index-charset'> &para;</a></span></dt>
+<dd><p>This line and everything following it in the file are ignored.  It is
+recognized for compatibility with other <code class="code">troff</code> implementations.
+In GNU <code class="code">troff</code>, character set repertoire is described on a
+per-font basis.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-spare1"></a>
+<a class="index-entry-id" id="index-spare2"></a>
+<a class="index-entry-id" id="index-biggestfont"></a>
+<p>GNU <code class="code">troff</code> recognizes but ignores the directives <code class="code">spare1</code>,
+<code class="code">spare2</code>, and <code class="code">biggestfont</code>.
+</p>
+<p>The <code class="code">res</code>, <code class="code">unitwidth</code>, <code class="code">fonts</code>, and <code class="code">sizes</code> lines
+are mandatory.  Directives not listed above are ignored by GNU
+<code class="code">troff</code> but may be used by postprocessors to obtain further
+information about the device.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Description-File-Format.html">Font Description File Format</a>, Previous: <a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>, Up: <a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Debugging.html Added

@@ -0,0 +1,317 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Debugging (The GNU Troff Manual)</title>
+
+<meta name="description" content="Debugging (The GNU Troff Manual)">
+<meta name="keywords" content="Debugging (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Implementation-Differences.html" rel="next" title="Implementation Differences">
+<link href="Gtroff-Internals.html" rel="prev" title="Gtroff Internals">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Debugging">
+<div class="nav-panel">
+<p>
+Next: <a href="Implementation-Differences.html" accesskey="n" rel="next">Implementation Differences</a>, Previous: <a href="Gtroff-Internals.html" accesskey="p" rel="prev"><code class="code">gtroff</code> Internals</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Debugging-1">5.37 Debugging</h3>
+<a class="index-entry-id" id="index-debugging"></a>
+
+<div class="flushright"><p class="flushright-paragraph"><i class="slanted">Standard troff voodoo, just put a power of two backslashes in
+front of it until it works and if you still have problems add a \c.</i>
+&mdash; Ron Natalie
+</p></div>
+<p>GNU <code class="code">troff</code> is not the easiest language to debug, in part thanks to
+its design features of recursive interpolation and the use of
+multi-stage pipeline processing in the surrounding system.  Nevertheless
+there exist several features useful for troubleshooting.
+</p>
+<p>Preprocessors use the <code class="code">lf</code> request to preserve the identity of the
+line numbers and names of input files.  GNU <code class="code">troff</code> emits a variety
+of error diagnostics and supports several categories of warning; the
+output of these can be selectively suppressed.  A trace of the
+formatter&rsquo;s input processing stack can be emitted when errors or
+warnings occur by means of GNU <code class="code">troff</code>&rsquo;s <samp class="option">-b</samp> option, or
+produced on demand with the <code class="code">backtrace</code> request.  The <code class="code">tm</code>
+and related requests can be used to emit customized diagnostic messages
+or for instrumentation while troubleshooting.  The <code class="code">ex</code> and
+<code class="code">ab</code> requests cause early termination with successful and error
+exit codes respectively, to halt further processing when continuing
+would be fruitless.  Examine the state of the formatter with requests
+that write lists of defined names (macros, strings, and diversions),
+environments, registers, and page location traps to the standard error
+stream.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lf</code></strong> <var class="def-var-arguments">line <span class="r"><i class="slanted">file</i></span></var><a class="copiable-link" href='#index-_002elf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lf"></a>
+<a class="index-entry-id" id="index-soelim"></a>
+<a class="index-entry-id" id="index-multi_002dfile-documents"></a>
+<a class="index-entry-id" id="index-documents_002c-multi_002dfile"></a>
+<a class="index-entry-id" id="index-setting-input-line-number-_0028lf_0029"></a>
+<a class="index-entry-id" id="index-input-line-number_002c-setting-_0028lf_0029"></a>
+<a class="index-entry-id" id="index-number_002c-input-line_002c-setting-_0028lf_0029"></a>
+<p>Set the input line number (and, optionally, the file name) GNU
+<code class="code">troff</code> shall use for error and warning messages.  <var class="var">line</var> is
+the input line number of the <em class="emph">next</em> line.  Without an argument, the
+request is ignored.
+</p>
+<p><code class="code">lf</code>&rsquo;s primary purpose is to aid the debugging of documents that
+undergo preprocessing.  Programs like <code class="command">tbl</code> that transform input
+in their own languages into <code class="code">roff</code> requests use it so that any
+diagnostic messages emitted by <code class="code">troff</code> correspond to the source
+document.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tm</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etm1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tm1</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etm1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tm1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etmc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tmc</code></strong> <var class="def-var-arguments">message</var><a class="copiable-link" href='#index-_002etmc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tmc"></a>
+<a class="index-entry-id" id="index-printing-to-stderr-_0028tm_002c-tm1_002c-tmc_0029"></a>
+<a class="index-entry-id" id="index-stderr_002c-printing-to-_0028tm_002c-tm1_002c-tmc_0029"></a>
+<p>Send <var class="var">message</var>, which consumes the remainder of the input line and
+cannot contain special characters, to the standard error stream,
+followed by a newline.  Leading spaces in <var class="var">message</var> are ignored.
+</p>
+<p><code class="code">tm1</code> is similar, but recognizes and strips a leading neutral
+double quote from <var class="var">message</var> to allow the embedding of leading
+spaces.
+</p>
+<p><code class="code">tmc</code> works as <code class="code">tm1</code>, but does not append a newline.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eab"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ab</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">message</i></span></var><a class="copiable-link" href='#index-_002eab'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ab"></a>
+<a class="index-entry-id" id="index-aborting-_0028ab_0029"></a>
+<p>Write any <var class="var">message</var> to the standard error stream (like <code class="code">tm</code>)
+and then abort GNU <code class="code">troff</code>; that is, stop processing and terminate
+with a failure status.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eex"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ex</code></strong><a class="copiable-link" href='#index-_002eex'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ex"></a>
+<a class="index-entry-id" id="index-ex-request_002c-use-in-debugging"></a>
+<a class="index-entry-id" id="index-exiting-_0028ex_0029"></a>
+<p>Exit GNU <code class="code">troff</code>; that is, stop processing and terminate with a
+successful status.  To stop processing only the current file, use the
+<code class="code">nx</code> request; see <a class="ref" href="I_002fO.html">I/O</a>.
+</p></dd></dl>
+
+<p>When doing something involved, it is useful to leave the debugging
+statements in the code and have them turned on by a command-line flag.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if \nDB .tm debugging output
+</pre></div></div>
+
+<p>To activate such statements, use the <samp class="option">-r</samp> option to set the
+register.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -rDB=1 <i class="slanted">file</i>
+</pre></div></div>
+
+<p>If it is known in advance that there are many errors and no useful
+output, GNU <code class="code">troff</code> can be forced to suppress formatted output with
+the <samp class="option">-z</samp> option.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epev"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pev</code></strong><a class="copiable-link" href='#index-_002epev'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pev"></a>
+<a class="index-entry-id" id="index-dumping-environments-_0028pev_0029"></a>
+<a class="index-entry-id" id="index-environments_002c-dumping-_0028pev_0029"></a>
+<p>Report the state of the current environment followed by that of all
+other environments to the standard error stream.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pm</code></strong><a class="copiable-link" href='#index-_002epm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pm"></a>
+<a class="index-entry-id" id="index-dumping-symbol-table-_0028pm_0029"></a>
+<a class="index-entry-id" id="index-symbol-table_002c-dumping-_0028pm_0029"></a>
+<p>Report, to the standard error stream, the names of all defined macros,
+strings, and diversions with their sizes in bytes.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epnr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pnr</code></strong><a class="copiable-link" href='#index-_002epnr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pnr"></a>
+<a class="index-entry-id" id="index-dumping-registers-_0028pnr_0029"></a>
+<a class="index-entry-id" id="index-registers_002c-dumping-_0028pnr_0029"></a>
+<p>Report the names and contents of all currently defined registers to the
+standard error stream.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eptr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ptr</code></strong><a class="copiable-link" href='#index-_002eptr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ptr"></a>
+<a class="index-entry-id" id="index-dumping-page-location-traps-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-listing-page-location-traps-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location_002c-dumping-_0028ptr_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location_002c-listing-_0028ptr_0029"></a>
+<p>Report the names and positions of all page location traps to the
+standard error stream.  Empty slots in the list, where a trap has been
+planted but subsequently (re)moved, are printed as well.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fl</code></strong><a class="copiable-link" href='#index-_002efl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fl"></a>
+<a class="index-entry-id" id="index-flush-output-_0028fl_0029"></a>
+<a class="index-entry-id" id="index-output_002c-flush-_0028fl_0029"></a>
+<a class="index-entry-id" id="index-interactive-use-of-gtroff"></a>
+<a class="index-entry-id" id="index-gtroff_002c-interactive-use"></a>
+<p>Instruct <code class="code">gtroff</code> to flush its output immediately.  The intent is
+for interactive use, but this behaviour is currently not implemented in
+<code class="code">gtroff</code>.  Contrary to Unix <code class="code">troff</code>, TTY output is sent to a
+device driver also (<code class="code">grotty</code>), making it non-trivial to communicate
+interactively.
+</p>
+<p>This request causes a line break.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebacktrace"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.backtrace</code></strong><a class="copiable-link" href='#index-_002ebacktrace'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-backtrace"></a>
+<a class="index-entry-id" id="index-backtrace-of-input-stack-_0028backtrace_0029"></a>
+<a class="index-entry-id" id="index-input-stack_002c-backtrace-_0028backtrace_0029"></a>
+<p>Write the state of the input stack to the standard error stream.
+</p>
+<p>Consider the following in a file <samp class="file">test</samp>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  backtrace
+..
+.de yyy
+.  xxx
+..
+.
+.yyy
+    error&rarr; troff: backtrace: 'test':2: macro 'xxx'
+    error&rarr; troff: backtrace: 'test':5: macro 'yyy'
+    error&rarr; troff: backtrace: file 'test':8
+</pre></div></div>
+
+<p>The <samp class="option">-b</samp> option of GNU <code class="code">troff</code> causes a backtrace to be
+generated on each error or warning.  Some warnings have to be enabled;
+See <a class="xref" href="Warnings.html">Warnings</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bslimit_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nslimit</code></strong><a class="copiable-link" href='#index-_005cn_005bslimit_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-slimit"></a>
+<a class="index-entry-id" id="index-input-stack_002c-setting-limit"></a>
+<p>If greater than&nbsp;0, sets the maximum quantity of objects on GNU
+<code class="code">troff</code>&rsquo;s internal input stack.  If less than or equal to&nbsp;0,
+there is no limit: recursion can continue until program memory is
+exhausted.  The default is 1,000.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewarnscale"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.warnscale</code></strong> <var class="def-var-arguments">su</var><a class="copiable-link" href='#index-_002ewarnscale'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-warnscale"></a>
+<p>Set the scaling unit used in certain warnings to <var class="var">su</var>, which can take the values &lsquo;<samp class="samp">u</samp>&rsquo;, &lsquo;<samp class="samp">i</samp>&rsquo;, &lsquo;<samp class="samp">c</samp>&rsquo;,
+&lsquo;<samp class="samp">p</samp>&rsquo;, and &lsquo;<samp class="samp">P</samp>&rsquo;.  The default is &lsquo;<samp class="samp">i</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002espreadwarn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.spreadwarn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">limit</i></span></var><a class="copiable-link" href='#index-_002espreadwarn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-spreadwarn"></a>
+<p>Emit a <code class="code">break</code> warning if the additional space inserted for each
+space between words in an output line adjusted to both margins with
+&lsquo;<samp class="samp">.ad&nbsp;b</samp>&rsquo; is larger than or equal to <var class="var">limit</var>.  A negative
+value is treated as zero; an absent argument toggles the warning on and
+off without changing <var class="var">limit</var>.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+At startup, <code class="code">spreadwarn</code> is inactive and <var class="var">limit</var> is 3<span class="dmn">m</span>.
+</p>
+<p>For example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.spreadwarn 0.2m
+</pre></div></div>
+
+<p>causes a warning if <code class="code">break</code> warnings are not suppressed and
+<code class="code">gtroff</code> must add 0.2<span class="dmn">m</span> or more for each inter-word space in a
+line.  See <a class="xref" href="Warnings.html">Warnings</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-warnings"></a>
+<p>GNU <code class="code">troff</code> has command-line options for reporting warnings
+(<samp class="option">-w</samp>) and backtraces (<samp class="option">-b</samp>) when a warning or an error
+occurs.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewarn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.warn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ewarn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-warn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ewarn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.warn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ewarn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ewarn-1"></a>
+<a class="index-entry-id" id="index-warning-level-_0028warn_0029"></a>
+<p>Select the categories, or &ldquo;types&rdquo;, of reported warnings.
+<var class="var">n</var>&nbsp;is the sum of the numeric codes associated with each
+warning category that is to be enabled; all other categories are
+disabled.  The categories and their associated codes are listed in
+<a class="ref" href="Warnings.html">Warnings</a>.  For example, &lsquo;<samp class="samp">.warn 0</samp>&rsquo; disables all warnings, and
+&lsquo;<samp class="samp">.warn 1</samp>&rsquo; disables all warnings except those about missing glyphs.
+If no argument is given, all warning categories are enabled.
+</p>
+<p>The read-only register <code class="code">.warn</code> contains the sum of the numeric
+codes of enabled warning categories.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Warnings.html" accesskey="1">Warnings</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Implementation-Differences.html">Implementation Differences</a>, Previous: <a href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Default-Units.html Added

@@ -0,0 +1,87 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Default Units (The GNU Troff Manual)</title>
+
+<meta name="description" content="Default Units (The GNU Troff Manual)">
+<meta name="keywords" content="Default Units (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Measurements.html" rel="up" title="Measurements">
+<link href="Motion-Quanta.html" rel="prev" title="Motion Quanta">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Default-Units">
+<div class="nav-panel">
+<p>
+Previous: <a href="Motion-Quanta.html" accesskey="p" rel="prev">Motion Quanta</a>, Up: <a href="Measurements.html" accesskey="u" rel="up">Measurements</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Default-Units-1">5.3.2 Default Units</h4>
+<a class="index-entry-id" id="index-default-units"></a>
+<a class="index-entry-id" id="index-units_002c-default"></a>
+
+<p>A general-purpose register (one created or updated with the <code class="code">nr</code>
+request; see see <a class="pxref" href="Registers.html">Registers</a>) is implicitly dimensionless, or reckoned
+in basic units if interpreted in a measurement context.  But it is
+convenient for many requests and escape sequences to infer a scaling
+unit for an argument if none is specified.  An explicit scaling unit
+(not after a closing parenthesis) can override an undesirable default.
+Effectively, the default unit is suffixed to the expression if a scaling
+unit is not already present.  GNU <code class="code">troff</code>&rsquo;s use of integer
+arithmetic should also be kept in mind (see <a class="pxref" href="Numeric-Expressions.html">Numeric Expressions</a>).
+</p>
+<p>The <code class="code">ll</code> request interprets its argument in ems by default.
+Consider several attempts to set a line length of 3.5&nbsp;inches when
+the type size is 10&nbsp;points on a terminal device with a resolution
+of 240 basic units and horizontal motion quantum of 24.  Some
+expressions become zero; the request clamps them to that quantum.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 3.5i      \&quot; 3.5i (= 840u)
+.ll 7/2       \&quot; 7u/2u -&gt; 3u -&gt; 3m -&gt; 0, clamped to 24u
+.ll (7 / 2)u  \&quot; 7u/2u -&gt; as above
+.ll 7/2i      \&quot; 7u/2i -&gt; 7u/480u -&gt; 0 -&gt; as above
+.ll 7i/2      \&quot; 7i/2u -&gt; 1680u/2m -&gt; 1680u/24u -&gt; 35u
+.ll 7i/2u     \&quot; 3.5i (= 840u)
+</pre></div></div>
+
+<a class="index-entry-id" id="index-measurements_002c-specifying-safely"></a>
+<p>The safest way to specify measurements is to attach a scaling unit.  To
+multiply or divide by a dimensionless quantity, use &lsquo;<samp class="samp">u</samp>&rsquo; as its
+scaling unit.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Deferring-Output.html Added

@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Deferring Output (The GNU Troff Manual)</title>
+
+<meta name="description" content="Deferring Output (The GNU Troff Manual)">
+<meta name="keywords" content="Deferring Output (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Traps.html" rel="next" title="Traps">
+<link href="Drawing-Geometric-Objects.html" rel="prev" title="Drawing Geometric Objects">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Deferring-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="Traps.html" accesskey="n" rel="next">Traps</a>, Previous: <a href="Drawing-Geometric-Objects.html" accesskey="p" rel="prev">Drawing Geometric Objects</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Deferring-Output-1">5.27 Deferring Output</h3>
+<a class="index-entry-id" id="index-deferred-output"></a>
+
+<a class="index-entry-id" id="index-environment"></a>
+<a class="index-entry-id" id="index-diversion"></a>
+<a class="index-entry-id" id="index-trap"></a>
+<p>A few <code class="code">roff</code> language elements are generally not used in simple
+documents, but arise as page layouts become more sophisticated and
+demanding.  <em class="dfn">Environments</em> collect formatting parameters like line
+length and typeface.  A <em class="dfn">diversion</em> stores formatted output for
+later use.  A <em class="dfn">trap</em> is a condition on the input or output, tested
+automatically by the formatter, that is associated with a macro, causing
+it to be called when that condition is fulfilled.
+</p>
+<p>Footnote support often exercises all three of the foregoing features.  A
+simple implementation might work as follows.  A pair of macros is
+defined: one starts a footnote and the other ends it.  The author calls
+the first macro where a footnote marker is desired.  The macro
+establishes a diversion so that the footnote text is collected at the
+place in the body text where its corresponding marker appears.  An
+environment is created for the footnote so that it is set at a smaller
+typeface.  The footnote text is formatted in the diversion using that
+environment, but it does not yet appear in the output.  The document
+author calls the footnote end macro, which returns to the previous
+environment and ends the diversion.  Later, after much more body text in
+the document, a trap, set a small distance above the page bottom, is
+sprung.  The macro called by the trap draws a line across the page and
+emits the stored diversion.  Thus, the footnote is rendered.
+</p>
+<p>Diversions and traps make the text formatting process non-linear.  Let
+us imagine a set of text lines or paragraphs labelled &lsquo;<samp class="samp">A</samp>&rsquo;,
+&lsquo;<samp class="samp">B</samp>&rsquo;, and so on.  If we set up a trap that produces text &lsquo;<samp class="samp">T</samp>&rsquo;
+(as a page footer, say), and we also use a diversion to store the
+formatted text &lsquo;<samp class="samp">D</samp>&rsquo;, then a document with input text in the order
+&lsquo;<samp class="samp">A B C D E F</samp>&rsquo; might render as &lsquo;<samp class="samp">A B C E T F</samp>&rsquo;.  The diversion
+&lsquo;<samp class="samp">D</samp>&rsquo; will never be output if we do not call for it.
+</p>
+<p>Environments of themselves are not a source of non-linearity in document
+formatting: environment switches have immediate effect.  One could
+always write a macro to change as many formatting parameters as desired
+with a single convenient call.  But because diversions can be nested and
+macros called by traps that are sprung by other trap-called macros, they
+may be called upon in varying contexts.  For example, consider a page
+header that is always to be set in Helvetica.  A document that uses
+Times for most of its body text, but Courier for displayed code
+examples, poses a challenge if a page break occurs in the middle of a
+code display; if the header trap assumes that the &ldquo;previous font&rdquo; is
+always Times, the rest of the example will be formatted in the wrong
+typeface.  One could carefully save all formatting parameters upon
+entering the trap and restore them upon leaving it, but this is verbose,
+error-prone, and not future-proof as the <code class="code">groff</code> language develops.
+Environments save us considerable effort.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Traps.html">Traps</a>, Previous: <a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Delimiters.html Added

@@ -0,0 +1,233 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Delimiters (The GNU Troff Manual)</title>
+
+<meta name="description" content="Delimiters (The GNU Troff Manual)">
+<meta name="keywords" content="Delimiters (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Formatter-Instructions.html" rel="up" title="Formatter Instructions">
+<link href="Using-Escape-Sequences.html" rel="prev" title="Using Escape Sequences">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Delimiters">
+<div class="nav-panel">
+<p>
+Previous: <a href="Using-Escape-Sequences.html" accesskey="p" rel="prev">Using Escape Sequences</a>, Up: <a href="Formatter-Instructions.html" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Delimiters-1">5.6.5 Delimiters</h4>
+<a class="index-entry-id" id="index-delimiting-escape-sequence-arguments"></a>
+<a class="index-entry-id" id="index-escape-sequence-argument-delimiters"></a>
+<a class="index-entry-id" id="index-delimiters_002c-for-escape-sequence-arguments"></a>
+<a class="index-entry-id" id="index-arguments_002c-to-escape-sequences_002c-delimiting"></a>
+
+<a class="index-entry-id" id="index-_0027_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0022_002c-as-delimiter"></a>
+<p>Some escape sequences that require parameters use delimiters.  The
+neutral apostrophe <code class="code">'</code> is a popular choice and shown in this
+document.  The neutral double quote <code class="code">&quot;</code> is also commonly seen.
+Letters, numerals, and leaders can be used.  Punctuation characters
+are likely better choices, except for those defined as infix operators
+in numeric expressions; see below.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\l'1.5i\bu' \&quot; draw 1.5 inches of bullet glyphs
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_0025_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_005e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_003f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0029_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_002c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c_007e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005c0_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ca_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cc_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cd_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ce_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cE_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cp_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cr_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005ct_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_005cu_002c-as-delimiter"></a>
+<p>The following escape sequences don&rsquo;t take arguments and thus are allowed
+as delimiters:
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\%</code>, <code class="code">\|</code>, <code class="code">\^</code>, <code class="code">\{</code>,
+<code class="code">\}</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\?</code>, <code class="code">\)</code>, <code class="code">\/</code>, <code class="code">\,</code>, <code class="code">\&amp;</code>, <code class="code">\:</code>,
+<code class="code">\~</code>, <code class="code">\0</code>, <code class="code">\a</code>, <code class="code">\c</code>, <code class="code">\d</code>, <code class="code">\e</code>,
+<code class="code">\E</code>, <code class="code">\p</code>, <code class="code">\r</code>, <code class="code">\t</code>, and <code class="code">\u</code>.  However,
+using them this way is discouraged; they can make the input confusing to
+read.
+</p>
+<a class="index-entry-id" id="index-_005cA_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cb_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005co_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cw_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cX_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cZ_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-newline_002c-as-delimiter"></a>
+<p>A few escape sequences,
+<code class="code">\A</code>,
+<code class="code">\b</code>,
+<code class="code">\o</code>,
+<code class="code">\w</code>,
+<code class="code">\X</code>,
+and <code class="code">\Z</code>, accept a newline as a delimiter.  Newlines that serve
+as delimiters continue to be recognized as input line terminators.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A caf\o
+e\(aa
+in Paris
+    &rArr; A café in Paris
+</pre></div></div>
+
+<p>Use of newlines as delimiters in escape sequences is also discouraged.
+</p>
+<a class="index-entry-id" id="index-_005cD_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005ch_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cH_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cl_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cL_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cN_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cR_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cs_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cS_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cv_002c-delimiters-allowed-by"></a>
+<a class="index-entry-id" id="index-_005cx_002c-delimiters-allowed-by"></a>
+<p>Finally, the escape sequences <code class="code">\D</code>, <code class="code">\h</code>, <code class="code">\H</code>,
+<code class="code">\l</code>, <code class="code">\L</code>, <code class="code">\N</code>, <code class="code">\R</code>, <code class="code">\s</code>, <code class="code">\S</code>,
+<code class="code">\v</code>, and <code class="code">\x</code> prohibit many delimiters.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-numerals_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-digits_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-_002e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-decimal-point_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-dot_002c-as-delimiter"></a>
+the numerals <code class="code">0</code>-<code class="code">9</code> and the decimal point <code class="code">.</code>
+
+</li><li><a class="index-entry-id" id="index-operators_002c-as-delimiters"></a>
+<a class="index-entry-id" id="index-_002b_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002f_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_002a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0025_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003c_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003e_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003d_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0026_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_003a_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0028_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-_0029_002c-as-delimiter"></a>
+the (single-character) operators &lsquo;<samp class="samp">+-/*%&lt;&gt;=&amp;:()</samp>&rsquo;
+
+</li><li><a class="index-entry-id" id="index-space-character_002c-as-delimiter"></a>
+<a class="index-entry-id" id="index-tab-character_002c-as-delimiter"></a>
+the space and tab characters
+
+</li><li><a class="index-entry-id" id="index-_005c_0025_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005c_002f_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005cc_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005ce_002c-as-delimiter-1"></a>
+<a class="index-entry-id" id="index-_005cp_002c-as-delimiter-1"></a>
+any escape sequences other than <code class="code">\%</code>, <code class="code">\:</code>, <code class="code">\{</code>,
+<code class="code">\}</code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\/</code>, <code class="code">\c</code>, <code class="code">\e</code>, and <code class="code">\p</code>
+</li></ul>
+
+<p>Delimiter syntax is complex and flexible primarily for historical
+reasons; the foregoing restrictions need be kept in mind mainly when
+using <code class="code">groff</code> in <abbr class="acronym">AT&amp;T</abbr> compatibility mode.  GNU
+<code class="code">troff</code> keeps track of the nesting depth of escape sequence
+interpolations, so the only characters you need to avoid using as
+delimiters are those that appear in the arguments you input, not any
+that result from interpolation. Typically, <code class="code">'</code> works fine.
+See <a class="xref" href="Implementation-Differences.html">Implementation Differences</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tps
+.de Mw
+.  nr wd \w'\\$1'
+.  tm &quot;\\$1&quot; is \\n(wd units wide.
+..
+.Mw Wet'suwet'en
+.Mw Wet+200i
+.cp 1 \&quot; turn on compatibility mode
+.Mw Wet'suwet'en
+.Mw Wet'
+.Mw Wet+200i
+    error&rarr; &quot;Wet'suwet'en&quot; is 54740 units wide.
+    error&rarr; &quot;Wet'+200i&quot; is 42610 units wide.
+    error&rarr; &quot;Wet'suwet'en&quot; is 15860 units wide.
+    error&rarr; &quot;Wet'&quot; is 15860 units wide.
+    error&rarr; &quot;Wet'+200i&quot; is 14415860 units wide.
+</pre></div></div>
+
+<p>We see here that in compatibility mode, the part of the argument after
+the <code class="code">'</code> delimiter escapes from its context and, if nefariously
+crafted, influences the computation of the <var class="var">wd</var> register&rsquo;s value in
+a surprising way.
+</p>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Using-Escape-Sequences.html">Using Escape Sequences</a>, Up: <a href="Formatter-Instructions.html">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Device-Control-Commands.html Added

@@ -0,0 +1,185 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Device Control Commands (The GNU Troff Manual)</title>
+
+<meta name="description" content="Device Control Commands (The GNU Troff Manual)">
+<meta name="keywords" content="Device Control Commands (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Command-Reference.html" rel="up" title="Command Reference">
+<link href="Obsolete-Command.html" rel="next" title="Obsolete Command">
+<link href="Graphics-Commands.html" rel="prev" title="Graphics Commands">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Device-Control-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="Obsolete-Command.html" accesskey="n" rel="next">Obsolete Command</a>, Previous: <a href="Graphics-Commands.html" accesskey="p" rel="prev">Graphics Commands</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Device-Control-Commands-1">6.1.2.4 Device Control Commands</h4>
+
+<p>Each device control command starts with the letter &lsquo;<samp class="samp">x</samp>&rsquo;, followed by
+a space character (optional or arbitrary space or tab in <code class="code">gtroff</code>)
+and a subcommand letter or word; each argument (if any) must be preceded
+by a syntactical space.  All &lsquo;<samp class="samp">x</samp>&rsquo; commands are terminated by a
+syntactical line break; no device control command can be followed by
+another command on the same line (except a comment).
+</p>
+<p>The subcommand is basically a single letter, but to increase
+readability, it can be written as a word, i.e., an arbitrary sequence of
+characters terminated by the next tab, space, or newline character.  All
+characters of the subcommand word but the first are simply ignored.  For
+example, <code class="code">gtroff</code> outputs the initialization command &lsquo;<samp class="samp">x&nbsp;i</samp>&rsquo;
+as &lsquo;<samp class="samp">x&nbsp;init</samp>&rsquo; and the resolution command &lsquo;<samp class="samp">x&nbsp;r</samp>&rsquo; as
+&lsquo;<samp class="samp">x&nbsp;res</samp>&rsquo;.
+</p>
+<p>In the following, the syntax element &lsaquo;<span class="r">line break</span>&rsaquo; means a
+syntactical line break (see <a class="pxref" href="Separation.html">Separation</a>).
+</p>
+<dl class="table">
+<dt><code class="code">xF <var class="var">name</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">F</samp>&rsquo; stands for <var class="var">Filename</var>.
+</p>
+<p>Use <var class="var">name</var> as the intended name for the current file in error
+reports.  This is useful for remembering the original file name when
+<code class="code">gtroff</code> uses an internal piping mechanism.  The input file is not
+changed by this command.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">xf <var class="var">n</var> <var class="var">s</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">f</samp>&rsquo; stands for <var class="var">font</var>.
+</p>
+<p>Mount font position&nbsp;<var class="var">n</var> (a non-negative integer) with font
+named&nbsp;<var class="var">s</var> (a text word).  See <a class="xref" href="Font-Positions.html">Font Positions</a>.
+</p>
+</dd>
+<dt><code class="code">xH <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">H</samp>&rsquo; stands for <var class="var">Height</var>.
+</p>
+<p>Set glyph height to&nbsp;<var class="var">n</var> (a positive integer in scaled points
+&lsquo;<samp class="samp">z</samp>&rsquo;).  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> uses the unit points (&lsquo;<samp class="samp">p</samp>&rsquo;)
+instead.  See <a class="xref" href="Output-Language-Compatibility.html">Output Language Compatibility</a>.
+</p>
+</dd>
+<dt><code class="code">xi&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">i</samp>&rsquo; stands for <var class="var">init</var>.
+</p>
+<p>Initialize device.  This is the third command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xp&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">p</samp>&rsquo; stands for <var class="var">pause</var>.
+</p>
+<p>Parsed but ignored.  The <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual documents
+this command as
+</p>
+<div class="display">
+<pre class="display-preformatted">pause device, can be restarted
+</pre></div>
+
+<p>but GNU <code class="code">troff</code> output drivers do nothing with this command.
+</p>
+</dd>
+<dt><code class="code">xr <var class="var">n</var> <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">r</samp>&rsquo; stands for <var class="var">resolution</var>.
+</p>
+<p>Resolution is&nbsp;<var class="var">n</var>, while <var class="var">h</var> is the minimal horizontal
+motion, and <var class="var">v</var> the minimal vertical motion possible with this
+device; all arguments are positive integers in basic units &lsquo;<samp class="samp">u</samp>&rsquo; per
+inch.  This is the second command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xS <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">S</samp>&rsquo; stands for <var class="var">Slant</var>.
+</p>
+<p>Set slant to&nbsp;<var class="var">n</var> (an integer in basic units &lsquo;<samp class="samp">u</samp>&rsquo;).
+</p>
+</dd>
+<dt><code class="code">xs&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">s</samp>&rsquo; stands for <var class="var">stop</var>.
+</p>
+<p>Terminates the processing of the current file; issued as the last
+command of any intermediate <code class="code">troff</code> output.
+</p>
+</dd>
+<dt><code class="code">xt&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">t</samp>&rsquo; stands for <var class="var">trailer</var>.
+</p>
+<p>Generate trailer information, if any.  In GNU <code class="code">troff</code>, this is
+ignored.
+</p>
+</dd>
+<dt><code class="code">xT <var class="var">xxx</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">T</samp>&rsquo; stands for <var class="var">Typesetter</var>.
+</p>
+<p>Set the name of the output driver to <var class="var">xxx</var>, a sequence of
+non-whitespace characters terminated by whitespace.  The possible names
+correspond to those of <code class="code">groff</code>&rsquo;s <samp class="option">-T</samp> option.  This is the
+first command of the prologue.
+</p>
+</dd>
+<dt><code class="code">xu <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">u</samp>&rsquo; stands for <var class="var">underline</var>.
+</p>
+<p>Configure underlining of spaces.  If <var class="var">n</var> is&nbsp;1, start
+underlining of spaces; if <var class="var">n</var> is&nbsp;0, stop underlining of spaces.
+This is needed for the <code class="code">cu</code> request in <code class="code">nroff</code> mode and is
+ignored otherwise.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">xX <var class="var">anything</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The &lsquo;<samp class="samp">x</samp>&rsquo; stands for <var class="var">X-escape</var>.
+</p>
+<p>Send string <var class="var">anything</var> uninterpreted to the device.  If the line
+following this command starts with a &lsquo;<samp class="samp">+</samp>&rsquo; character this line is
+interpreted as a continuation line in the following sense.  The &lsquo;<samp class="samp">+</samp>&rsquo;
+is ignored, but a newline character is sent instead to the device, the
+rest of the line is sent uninterpreted.  The same applies to all
+following lines until the first character of a line is not a &lsquo;<samp class="samp">+</samp>&rsquo;
+character.  This command is generated by the <code class="code">gtroff</code> escape
+sequence <code class="code">\X</code>.  The line-continuing feature is a <code class="code">gtroff</code>
+extension.
+</p></dd>
+</dl>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Obsolete-Command.html">Obsolete Command</a>, Previous: <a href="Graphics-Commands.html">Graphics Commands</a>, Up: <a href="Command-Reference.html">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Device-and-Font-Description-Files.html Added

@@ -0,0 +1,77 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Device and Font Description Files (The GNU Troff Manual)</title>
+
+<meta name="description" content="Device and Font Description Files (The GNU Troff Manual)">
+<meta name="keywords" content="Device and Font Description Files (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="File-Formats.html" rel="up" title="File Formats">
+<link href="gtroff-Output.html" rel="prev" title="gtroff Output">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Device-and-Font-Description-Files">
+<div class="nav-panel">
+<p>
+Previous: <a href="gtroff-Output.html" accesskey="p" rel="prev"><code class="code">gtroff</code> Output</a>, Up: <a href="File-Formats.html" accesskey="u" rel="up">File Formats</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Device-and-Font-Description-Files-1">6.2 Device and Font Description Files</h3>
+<a class="index-entry-id" id="index-font-files"></a>
+<a class="index-entry-id" id="index-files_002c-font"></a>
+
+<p>The <code class="code">groff</code> font and output device description formats are slight
+extensions of those used by <abbr class="acronym">AT&amp;T</abbr> device-independent
+<code class="code">troff</code>.  In distinction to the <abbr class="acronym">AT&amp;T</abbr> implementation,
+<code class="code">groff</code> lacks a binary format; all files are text
+files.<a class="footnote" id="DOCF125" href="groff.html_fot.html#FOOT125"><sup>125</sup></a>  The device and font description files for a device <var class="var">name</var>
+are stored in a <samp class="file">dev<var class="var">name</var></samp> directory.  The device description
+file is called <samp class="file">DESC</samp>, and, for each font supported by the device,
+a font description file is called&nbsp;<samp class="file"><var class="var">f</var></samp>, where
+<var class="var">f</var>&nbsp;is usually an abbreviation of a font&rsquo;s name and/or style.
+For example, the <code class="code">ps</code> (PostScript) device has <code class="code">groff</code> font
+description files for Times roman (<samp class="file">TR</samp>) and Zapf Chancery Medium
+italic (<samp class="file">ZCMI</samp>), among many others, while the <code class="code">utf8</code> device
+(for terminal emulators) has only font descriptions for the roman,
+italic, bold, and bold-italic styles (<samp class="file">R</samp>, <samp class="file">I</samp>, <samp class="file">B</samp>, and
+<samp class="file">BI</samp>, respectively).
+</p>
+<p>Device and font description files are read both by the formatter, GNU
+<code class="code">troff</code>, and by output drivers.  The programs delegate these files&rsquo;
+processing to an internal library, <samp class="file">libgroff</samp>, ensuring their
+consistent interpretation.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="DESC-File-Format.html" accesskey="1"><samp class="file">DESC</samp> File Format</a></li>
+<li><a href="Font-Description-File-Format.html" accesskey="2">Font Description File Format</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Differences-from-AT_0026T-ms.html Added

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Differences from AT&amp;T ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Differences from AT&amp;T ms (The GNU Troff Manual)">
+<meta name="keywords" content="Differences from AT&amp;T ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Naming-Conventions.html" rel="next" title="ms Naming Conventions">
+<link href="ms-Page-Layout.html" rel="prev" title="ms Page Layout">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Differences-from-AT_0026T-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Naming-Conventions.html" accesskey="n" rel="next">Naming Conventions</a>, Previous: <a href="ms-Page-Layout.html" accesskey="p" rel="prev">Page layout</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Differences-from-AT_0026T-ms-1">4.6.7 Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></h4>
+<a class="index-entry-id" id="index-ms-macros_002c-groff-differences-from-AT_0026T"></a>
+<a class="index-entry-id" id="index-AT_0026T-ms_002c-macro-package-differences"></a>
+
+<p>The <code class="code">groff</code> <samp class="file">ms</samp> macros are an independent reimplementation,
+using no <abbr class="acronym">AT&amp;T</abbr> code.  Since they take advantage of the extended
+features of <code class="code">groff</code>, they cannot be used with <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>.  <code class="code">groff</code> <samp class="file">ms</samp> supports features described above
+as Berkeley and Tenth Edition Research Unix extensions, and adds several
+of its own.
+</p>
+<ul class="itemize mark-bullet">
+<li>The internals of <code class="code">groff</code> <samp class="file">ms</samp> differ from the internals of
+<abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>.  Documents that depend upon implementation
+details of <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> may not format properly with
+<code class="code">groff</code> <samp class="file">ms</samp>.  Such details include macros whose function was
+not documented in the <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>
+manual.<a class="footnote" id="DOCF14" href="groff.html_fot.html#FOOT14"><sup>14</sup></a>
+
+</li><li>The error-handling policy of <code class="code">groff</code> <samp class="file">ms</samp> is to detect and
+report errors, rather than to ignore them silently.
+
+</li><li>Tenth Edition Research Unix supported <code class="code">P1</code>/<code class="code">P2</code> macros to bracket code
+examples; <code class="code">groff</code> <samp class="file">ms</samp> does not.
+
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> does not work in GNU <code class="code">troff</code>&rsquo;s
+<abbr class="acronym">AT&amp;T</abbr> compatibility mode.  If loaded when that mode is enabled,
+it aborts processing with a diagnostic message.
+
+</li><li>Multiple line spacing is not supported.  Use a larger vertical spacing
+instead.
+
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> uses the same header and footer defaults in both
+<code class="code">nroff</code> and <code class="code">troff</code> modes as <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> does in
+<code class="code">troff</code> mode; <abbr class="acronym">AT&amp;T</abbr>&rsquo;s default in <code class="code">nroff</code> mode is to
+put the date, in U.S. traditional format (e.g., &ldquo;January 1, 2021&rdquo;),
+in the center footer (the <code class="code">CF</code> string).
+
+</li><li>Many <code class="code">groff</code> <samp class="file">ms</samp> macros, including those for paragraphs,
+headings, and displays, cause a reset of paragraph rendering parameters,
+and may change the indentation; they do so not by incrementing or
+decrementing it, but by setting it absolutely.  This can cause problems
+for documents that define additional macros of their own that try to
+manipulate indentation.  Use the <samp class="file">ms</samp> <code class="code">RS</code> and <code class="code">RE</code>
+macros instead of the <code class="code">in</code> request.
+
+</li><li><a class="index-entry-id" id="index-fractional-type-sizes-in-ms-macros"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-fractional-type-sizes-in"></a>
+<abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> interpreted the values of the registers
+<code class="code">PS</code> and <code class="code">VS</code> in points, and did not support the use of
+scaling units with them.  <code class="code">groff</code> <samp class="file">ms</samp> interprets values of
+the registers <code class="code">PS</code>, <code class="code">VS</code>, <code class="code">FPS</code>, and <code class="code">FVS</code> equal to
+or larger than&nbsp;1,000 (one thousand) as decimal fractions multiplied
+by&nbsp;1,000.<a class="footnote" id="DOCF15" href="groff.html_fot.html#FOOT15"><sup>15</sup></a>  This threshold makes use of a
+scaling unit with these parameters practical for high-resolution
+devices while preserving backward compatibility.  It also permits
+expression of non-integral type sizes.  For example, &lsquo;<samp class="samp">groff
+-rPS=10.5p</samp>&rsquo; at the shell prompt is equivalent to placing &lsquo;<samp class="samp">.nr PS
+10.5p</samp>&rsquo; at the beginning of the document.
+
+</li><li><abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>&rsquo;s <code class="code">AU</code> macro supported arguments used with
+some document types; <code class="code">groff</code> <samp class="file">ms</samp> does not.
+
+</li><li>Right-aligned displays are available.  The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp>
+manual observes that &ldquo;it is tempting to assume that &lsquo;<samp class="samp">.DS R</samp>&rsquo; will
+right adjust lines, but it doesn&rsquo;t work&rdquo;.  In <code class="code">groff</code> <samp class="file">ms</samp>,
+it does.
+
+</li><li>To make <code class="code">groff</code> <samp class="file">ms</samp> use the default page offset (which also
+specifies the left margin), the <code class="code">PO</code> register must stay undefined
+until the first <samp class="file">ms</samp> macro is called.
+
+<p>This implies that &lsquo;<samp class="samp">\nPO</samp>&rsquo; should not be used early in the
+document, unless it is changed also: accessing an undefined register
+automatically defines it.
+</p>
+</li><li><code class="code">groff</code> <samp class="file">ms</samp> supports the <code class="code">PN</code> register, but it is not
+necessary; you can access the page number via the usual <code class="code">%</code>
+register and invoke the <code class="code">af</code> request to assign a different format
+to it if desired.<a class="footnote" id="DOCF16" href="groff.html_fot.html#FOOT16"><sup>16</sup></a>
+
+</li><li>The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> manual documents registers <code class="code">CW</code> and
+<code class="code">GW</code> as setting the default column width and &ldquo;intercolumn gap&rdquo;,
+respectively, and which applied when <code class="code">MC</code> was called with fewer
+than two arguments.  <code class="code">groff</code> <samp class="file">ms</samp> instead treats <code class="code">MC</code>
+without arguments as synonymous with <code class="code">2C</code>; there is thus no
+occasion for a default column width register.  Further, the <code class="code">MINGW</code>
+register and the second argument to <code class="code">MC</code> specify a <em class="emph">minimum</em>
+space between columns, not the fixed gutter width of <abbr class="acronym">AT&amp;T</abbr>
+<samp class="file">ms</samp>.
+
+</li><li>The <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> manual did not document the <code class="code">QI</code>
+register; Berkeley and <code class="code">groff</code> <samp class="file">ms</samp> do.
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bGS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nGS</code></strong><a class="copiable-link" href='#index-_005cn_005bGS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GS-_005bms_005d"></a>
+<p>The register <code class="code">GS</code> is set to&nbsp;1 by the <code class="code">groff</code> <samp class="file">ms</samp>
+macros, but is not used by the <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp> package.
+Documents that need to determine whether they are being formatted with
+<code class="code">groff</code> <samp class="file">ms</samp> or another implementation should test this
+register.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Missing-Unix-Version-7-ms-Macros.html" accesskey="1">Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Naming-Conventions.html">Naming Conventions</a>, Previous: <a href="ms-Page-Layout.html">Page layout</a>, Up: <a href="ms.html"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Displays-and-Keeps.html Added

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Displays and Keeps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Displays and Keeps (The GNU Troff Manual)">
+<meta name="keywords" content="Displays and Keeps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Footnotes-and-Endnotes.html" rel="next" title="Footnotes and Endnotes">
+<link href="Page-Layout-Adjustment.html" rel="prev" title="Page Layout Adjustment">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Displays-and-Keeps">
+<div class="nav-panel">
+<p>
+Next: <a href="Footnotes-and-Endnotes.html" accesskey="n" rel="next">Footnotes and Endnotes</a>, Previous: <a href="Page-Layout-Adjustment.html" accesskey="p" rel="prev">Page Layout</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Displays-and-Keeps-1">3.2.5 Displays and Keeps</h4>
+<a class="index-entry-id" id="index-displays"></a>
+
+<p><i class="slanted">Displays</i> are sections of text set off from the surrounding
+material (typically paragraphs), often differing in indentation, and/or
+spacing.  Tables, block quotations, and figures are displayed.
+Equations and code examples, when not much shorter than an output line,
+often are.  Lists may or may not be.  Packages for setting man pages
+support example displays but not keeps.
+</p>
+<a class="index-entry-id" id="index-keeps-_0028introduction_0029"></a>
+<p>A <i class="slanted">keep</i> is a group of output lines, often a display, that is
+formatted on a single page if possible; it causes a page break to happen
+early so as to not interrupt the kept material.
+</p>
+<a class="index-entry-id" id="index-keep_002c-floating"></a>
+<a class="index-entry-id" id="index-floating-keep"></a>
+<p><i class="slanted">Floating keeps</i> can move, or &ldquo;float&rdquo;, relative to the text
+around them in the input.  They are useful for displays that are
+captioned and referred to by name, as with &ldquo;See figure&nbsp;3&rdquo;.
+Depending on the package, a floating keep appears at the bottom of the
+current page if it fits, and at the top of the next otherwise.
+Alternatively, floating keeps might be deferred to the end of a section.
+Using a floating keep can avoid the large vertical spaces that may
+precede a tall keep of the ordinary sort when it won&rsquo;t fit on the page.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Diversion-Traps.html Added

@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Diversion Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Diversion Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Diversion Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Vertical-Position-Traps.html" rel="up" title="Vertical Position Traps">
+<link href="Input-Line-Traps.html" rel="next" title="Input Line Traps">
+<link href="The-Implicit-Page-Trap.html" rel="prev" title="The Implicit Page Trap">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Diversion-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="Input-Line-Traps.html" accesskey="n" rel="next">Input Line Traps</a>, Previous: <a href="The-Implicit-Page-Trap.html" accesskey="p" rel="prev">The Implicit Page Trap</a>, Up: <a href="Vertical-Position-Traps.html" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Diversion-Traps-1">5.28.1.3 Diversion Traps</h4>
+<a class="index-entry-id" id="index-diversion-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-diversion"></a>
+
+<p>A diversion is not formatted in the context of a page, so it lacks page
+location traps; instead it can have a <em class="dfn">diversion trap</em>.  There can
+exist at most one such vertical position trap per diversion.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">dist</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002edt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dt"></a>
+<a class="index-entry-id" id="index-_002et-register_002c-and-diversions"></a>
+<a class="index-entry-id" id="index-setting-diversion-trap-_0028dt_0029"></a>
+<a class="index-entry-id" id="index-diversion-trap_002c-setting-_0028dt_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-diversion_002c-setting-_0028dt_0029"></a>
+<p>Set a trap <em class="emph">within</em> a diversion at location <var class="var">dist</var>, which is
+interpreted relative to diversion rather than page boundaries.  If invoked with
+fewer than two arguments, any diversion trap in the current diversion is
+removed.  The register <code class="code">.t</code> works within diversions.  It is an
+error to invoke <code class="code">dt</code> in the top-level diversion.
+See <a class="xref" href="Diversions.html">Diversions</a>.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Diversions.html Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Document-Formats.html Added

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Document Formats (The GNU Troff Manual)</title>
+
+<meta name="description" content="Document Formats (The GNU Troff Manual)">
+<meta name="keywords" content="Document Formats (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Columnation.html" rel="next" title="Columnation">
+<link href="Indexing.html" rel="prev" title="Indexing">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Document-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="Columnation.html" accesskey="n" rel="next">Columnation</a>, Previous: <a href="Indexing.html" accesskey="p" rel="prev">Indexing</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Document-Formats-1">3.2.9 Document Formats</h4>
+<a class="index-entry-id" id="index-document-formats"></a>
+
+<p>Some macro packages supply stock configurations of certain documents,
+like business letters and memoranda.  These often also have provision
+for a <i class="slanted">cover sheet</i>, which may be rigid in its format.  With
+these features, it is even more important to use the package&rsquo;s macros in
+preference to the formatter requests presented earlier, where possible.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Document-Parts.html Added

@@ -0,0 +1,84 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Document Parts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Document Parts (The GNU Troff Manual)">
+<meta name="keywords" content="Document Parts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Language-Concepts.html" rel="up" title="Language Concepts">
+<link href="Argument-Units.html" rel="prev" title="Argument Units">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Document-Parts">
+<div class="nav-panel">
+<p>
+Previous: <a href="Argument-Units.html" accesskey="p" rel="prev">Argument Units</a>, Up: <a href="Language-Concepts.html" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Document-Parts-1">6.1.1.3 Document Parts</h4>
+
+<p>A correct intermediate output document consists of two parts, the
+<em class="dfn">prologue</em> and the <em class="dfn">body</em>.
+</p>
+<p>The task of the prologue is to set the general device parameters using
+three exactly specified commands.  <code class="code">gtroff</code>&rsquo;s prologue is
+guaranteed to consist of the following three lines (in that order):
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">x T <var class="var">device</var>
+x res <var class="var">n</var> <var class="var">h</var> <var class="var">v</var>
+x init
+</pre></div></div>
+
+<p>with the arguments set as outlined in <a class="ref" href="Device-Control-Commands.html">Device Control Commands</a>.
+The parser for the intermediate output format is able to interpret
+additional whitespace and comments as well even in the prologue.
+</p>
+<p>The body is the main section for processing the document data.
+Syntactically, it is a sequence of any commands different from the ones
+used in the prologue.  Processing is terminated as soon as the first
+&lsquo;<samp class="samp">x&nbsp;stop</samp>&rsquo; command is encountered; the last line of any
+<code class="code">gtroff</code> intermediate output always contains such a command.
+</p>
+<p>Semantically, the body is page oriented.  A new page is started by a
+&lsquo;<samp class="samp">p</samp>&rsquo; command.  Positioning, writing, and drawing commands are always
+done within the current page, so they cannot occur before the first
+&lsquo;<samp class="samp">p</samp>&rsquo; command.  Absolute positioning (by the &lsquo;<samp class="samp">H</samp>&rsquo; and &lsquo;<samp class="samp">V</samp>&rsquo;
+commands) is done relative to the current page; all other positioning is
+done relative to the current location within this page.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Drawing-Geometric-Objects.html Added

@@ -0,0 +1,361 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Drawing Geometric Objects (The GNU Troff Manual)</title>
+
+<meta name="description" content="Drawing Geometric Objects (The GNU Troff Manual)">
+<meta name="keywords" content="Drawing Geometric Objects (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Traps.html" rel="next" title="Traps">
+<link href="Page-Motions.html" rel="prev" title="Page Motions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Drawing-Geometric-Objects">
+<div class="nav-panel">
+<p>
+Next: <a href="Traps.html" accesskey="n" rel="next">Traps</a>, Previous: <a href="Page-Motions.html" accesskey="p" rel="prev">Page Motions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Drawing-Geometric-Objects-1">5.26 Drawing Geometric Objects</h3>
+<a class="index-entry-id" id="index-drawing-requests"></a>
+<a class="index-entry-id" id="index-requests-for-drawing"></a>
+
+<p>A few of the formatter&rsquo;s escape sequences draw lines and other geometric
+objects.  Combined with each other and with page motion commands
+(see <a class="pxref" href="Page-Motions.html">Page Motions</a>), a wide variety of figures is possible.  For
+complex drawings, these operations can be cumbersome; the preprocessors
+<code class="code">gpic</code> or <code class="code">ggrn</code> are typically used instead.
+</p>
+<p>The <code class="code">\l</code> and <code class="code">\L</code> escape sequences draw horizontal and
+vertical sequences of glyphs, respectively.  Even the simplest of
+output devices supports them.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cl_0027l_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\l<code class="code">'</code></code><span class="r"><i class="slanted">l</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cl_0027l_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cl"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cl_0027lc_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\l<code class="code">'</code></code><span class="r"><i class="slanted">lc</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cl_0027lc_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-horizontal-lines-_0028_005cl_0029"></a>
+<a class="index-entry-id" id="index-horizontal-line_002c-drawing-_0028_005cl_0029"></a>
+<a class="index-entry-id" id="index-line_002c-horizontal_002c-drawing-_0028_005cl_0029"></a>
+<p>Draw a horizontal line of length <var class="var">l</var> from the drawing position.
+Rightward motion is positive.  Afterward, the drawing position is at the
+right end of the line.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-baseline-rule-special-character_0028_005c_005bru_005d_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-underscore-_0028_005c_005bru_005d_0029"></a>
+<a class="index-entry-id" id="index-line-drawing-glyph"></a>
+<a class="index-entry-id" id="index-glyph_002c-for-line-drawing"></a>
+<p>The optional second parameter&nbsp;<var class="var">c</var> is a character with which to
+draw the line.  The default is the baseline rule special character,
+<code class="code">\ru</code>.
+</p>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-_005cl-escape-sequence"></a>
+<p>If <var class="var">c</var> is a valid scaling unit, put <code class="code">\&amp;</code> after <var class="var">l</var> to
+disambiguate the input.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de textbox
+\br\\$*\br\l'|0\rn'\l'|0\ul'
+..
+</pre></div></div>
+
+<p>The foregoing outputs a box rule (a vertical line), the text
+argument(s), and another box rule.  We employ the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  Finally, the line-drawing escape sequences
+draw a radical extender (a form of overline) and an underline from the
+drawing position to the position coresponding to beginning of the
+<em class="emph">input</em> line.  The drawing position returns to just after the
+right-hand box rule because the lengths of the drawn lines are negative,
+as noted above.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cL_0027l_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\L<code class="code">'</code></code><span class="r"><i class="slanted">l</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cL_0027l_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cL"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cL_0027lc_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\L<code class="code">'</code></code><span class="r"><i class="slanted">lc</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cL_0027lc_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-vertical-lines-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-vertical-line-drawing-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-line_002c-vertical_002c-drawing-_0028_005cL_0029"></a>
+<a class="index-entry-id" id="index-line-drawing-glyph-1"></a>
+<a class="index-entry-id" id="index-glyph-for-line-drawing"></a>
+<a class="index-entry-id" id="index-box-rule-glyph-_0028_005c_005bbr_005d_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-box-rule-_0028_005c_005bbr_005d_0029"></a>
+<p>Draw a vertical line of length <var class="var">l</var> from the drawing position.
+Downward motion is positive.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  The
+default character is the box rule, <code class="code">\br</code>.  As with vertical
+motion escape sequences, text processing continues where the line ends.
+<code class="code">\L</code> is otherwise similar to <code class="code">\l</code>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ nroff &lt;&lt;EOF
+This is a \L'3v'test.
+EOF
+    &rArr; This is a
+    &rArr;           |
+    &rArr;           |
+    &rArr;           |test.
+</pre></div></div>
+
+<p>When writing text, the drawing position is at the text baseline; recall
+<a class="ref" href="Page-Geometry.html">Page Geometry</a>.
+</p></dd></dl>
+
+<p>The <code class="code">\D</code> escape sequence provides <em class="dfn">drawing commands</em> that
+direct the output device to render geometrical objects rather than
+glyphs.  Specific devices may support only a subset, or may feature
+additional ones; consult the man page for the output driver in use.
+Terminal devices in particular implement almost none.  See <a class="xref" href="Graphics-Commands.html">Graphics Commands</a>.
+</p>
+<p>Rendering starts at the drawing position; when finished, the drawing
+position is left at the rightmost point of the object, even for closed
+figures, except where noted.  GNU <code class="code">troff</code> draws stroked (outlined)
+objects with the stroke color, and shades filled ones with the fill
+color.  See <a class="xref" href="Colors.html">Colors</a>.  Coordinates <var class="var">h</var> and <var class="var">v</var> are horizontal
+and vertical motions relative to the drawing position or previous point
+in the command.  The default scaling unit for horizontal measurements
+(and diameters of circles) is &lsquo;<samp class="samp">m</samp>&rsquo;; for vertical ones, &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<p>Circles, ellipses, and polygons can be drawn filled or stroked.  These
+are independent properties; if you want a filled, stroked figure, you
+must draw the same figure twice using each drawing command.  A filled
+figure is always smaller than an outlined one because the former is
+drawn only within its defined area, whereas strokes have a line
+thickness (set with &lsquo;<samp class="samp">\D't'</samp>&rsquo;).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\h'1i'\v'1i'\
+\# increase line thickness
+\Z'\D't 5p''\
+\# draw stroked (unfilled) polygon
+\Z'\D'p 3 3 -6 0''\
+\# draw filled (solid) polygon
+\Z'\D'P 3 3 -6 0''
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cD_0027command-argument-_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\D<code class="code">'</code></code><span class="r"><i class="slanted">command argument &hellip;</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cD_0027command-argument-_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cD"></a>
+<p>Drawing command escape sequence parameters begin with an ordinary
+character, <var class="var">command</var>, selecting the type of object to be drawn,
+followed by <var class="var">argument</var>s whose meaning is determined by
+<var class="var">command</var>.
+</p>
+<dl class="table">
+<dt id='index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029'><span><code class="code">\D'~ <var class="var">h1</var> <var class="var">v1</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>'</code><a class="copiable-link" href='#index-drawing-a-spline-_0028_005cD_0027_007e-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-spline_002c-drawing-_0028_005cD_0027_007e-_2026_0027_0029"></a>
+<p>Draw a B-spline to each point in sequence, leaving the drawing position
+at (<var class="var">hn</var>, <var class="var">vn</var>).
+</p>
+</dd>
+<dt id='index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029'><span><code class="code">\D'a <var class="var">hc</var> <var class="var">vc</var> <var class="var">h</var> <var class="var">v</var>'</code><a class="copiable-link" href='#index-arc_002c-drawing-_0028_005cD_0027a-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-an-arc-_0028_005cD_0027a-_2026_0027_0029"></a>
+<p>Draw a circular arc centered at (<var class="var">hc</var>, <var class="var">vc</var>) counterclockwise
+from the drawing position to a point (<var class="var">h</var>, <var class="var">v</var>) relative to the
+center.  <a class="footnote" id="DOCF105" href="groff.html_fot.html#FOOT105"><sup>105</sup></a>
+</p>
+</dd>
+<dt id='index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029'><span><code class="code">\D'c <var class="var">d</var>'</code><a class="copiable-link" href='#index-circle_002c-stroked_002c-drawing-_0028_005cD_0027c-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-circle-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-circle_002c-outlined_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-circle-_0028_005cD_0027c-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-circle_002c-drawing-_0028_005cD_0027c-_2026_0027_0029"></a>
+<p>Draw a circle of diameter <var class="var">d</var> with its leftmost point at the drawing
+position.
+</p>
+</dd>
+<dt id='index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029'><span><code class="code">\D'C <var class="var">d</var>'</code><a class="copiable-link" href='#index-circle_002c-filled_002c-drawing-_0028_005cD_0027C-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-circle-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-circle_002c-solid_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-circle-_0028_005cD_0027C-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-circle_002c-drawing-_0028_005cD_0027C-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'C <span class="r">&hellip;</span>'</samp>&rsquo;, but the circle is filled.
+</p>
+</dd>
+<dt id='index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029'><span><code class="code">\D'e <var class="var">h</var> <var class="var">v</var>'</code><a class="copiable-link" href='#index-ellipse_002c-stroked_002c-drawing-_0028_005cD_0027e-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-ellipse-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-ellipse_002c-outlined_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-ellipse-_0028_005cD_0027e-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-ellipse_002c-drawing-_0028_005cD_0027e-_2026_0027_0029"></a>
+<p>Draw an ellipse of width <var class="var">h</var> and height <var class="var">v</var> with its leftmost
+point at the drawing position.
+</p>
+</dd>
+<dt id='index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029'><span><code class="code">\D'E <var class="var">x</var> <var class="var">y</var>'</code><a class="copiable-link" href='#index-ellipse_002c-filled_002c-drawing-_0028_005cD_0027E-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-ellipse-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-ellipse_002c-solid_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-ellipse-_0028_005cD_0027E-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-ellipse_002c-drawing-_0028_005cD_0027E-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'e <span class="r">&hellip;</span>'</samp>&rsquo;, but the ellipse is filled.
+</p>
+</dd>
+<dt id='index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029'><span><code class="code">\D'l <var class="var">dx</var> <var class="var">dy</var>'</code><a class="copiable-link" href='#index-line_002c-drawing-_0028_005cD_0027l-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-line-_0028_005cD_0027l-_2026_0027_0029"></a>
+<p>Draw line from the drawing position to (<var class="var">h</var>, <var class="var">v</var>).
+</p>
+<p>The following is a macro for drawing a box around a text argument; for
+simplicity, the box margin is a fixed at 0.2<span class="dmn">m</span>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de TEXTBOX
+.  nr @wd \w'\\$1'
+\h'.2m'\
+\h'-.2m'\v'(.2m - \\nrsbu)'\
+\D'l 0 -(\\nrstu - \\nrsbu + .4m)'\
+\D'l (\\n@wdu + .4m) 0'\
+\D'l 0 (\\nrstu - \\nrsbu + .4m)'\
+\D'l -(\\n@wdu + .4m) 0'\
+\h'.2m'\v'-(.2m - \\nrsbu)'\
+\\$1\
+\h'.2m'
+..
+</pre></div></div>
+
+<p>The argument is measured with the <code class="code">\w</code> escape sequence.  Its width
+is stored in register <code class="code">@wd</code>.  <code class="code">\w</code> also sets the registers
+<code class="code">rst</code> and <code class="code">rsb</code>; these contain its maximum vertical extents of
+the argument.  Then, four lines are drawn to form a box, offset by the
+box margin.
+</p>
+</dd>
+<dt id='index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029'><span><code class="code">\D'p <var class="var">h1</var> <var class="var">v1</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>'</code><a class="copiable-link" href='#index-polygon_002c-stroked_002c-drawing-_0028_005cD_0027p-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-stroked-polygon-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-stroked-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-polygon_002c-outlined_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-an-outlined-polygon-_0028_005cD_0027p-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-outlined-polygon_002c-drawing-_0028_005cD_0027p-_2026_0027_0029"></a>
+<p>Draw polygon with vertices at drawing position and each point in
+sequence.  GNU <code class="code">troff</code> closes the polygon by drawing a line from
+(<var class="var">hn</var>, <var class="var">vn</var>) back to the initial drawing position.
+Afterward, the drawing position is left at (<var class="var">hn</var>, <var class="var">vn</var>).
+</p>
+</dd>
+<dt id='index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029'><span><code class="code">\D'P <var class="var">dx1</var> <var class="var">dy1</var> <var class="var">dx2</var> <var class="var">dy2</var> &hellip;'</code><a class="copiable-link" href='#index-polygon_002c-filled_002c-drawing-_0028_005cD_0027P-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-drawing-a-filled-polygon-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-filled-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-polygon_002c-solid_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-drawing-a-solid-polygon-_0028_005cD_0027P-_2026_0027_0029"></a>
+<a class="index-entry-id" id="index-solid-polygon_002c-drawing-_0028_005cD_0027P-_2026_0027_0029"></a>
+<p>As &lsquo;<samp class="samp">\D'P <span class="r">&hellip;</span>'</samp>&rsquo;, but the polygon is filled.
+</p>
+<p>The following macro is like the &lsquo;<samp class="samp">\D'l'</samp>&rsquo; example, but shades the
+box.  We draw the box before writing the text because colors in GNU
+<code class="code">troff</code> have no transparency; in othe opposite order, the filled
+polygon would occlude the text.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de TEXTBOX
+.  nr @wd \w'\\$1'
+\h'.2m'\
+\h'-.2m'\v'(.2m - \\nrsbu)'\
+\Mlightcyan\
+\D'P 0 -(\\nrstu - \\nrsbu + .4m) \
+     (\\n@wdu + .4m) 0 \
+     0 (\\nrstu - \\nrsbu + .4m) \
+     -(\\n@wdu + .4m) 0'\
+\h'.2m'\v'-(.2m - \\nrsbu)'\
+\M\
+\\$1\
+\h'.2m'
+..
+</pre></div></div>
+
+</dd>
+<dt id='index-line-thickness-_0028_005cD_0027t-_2026_0027_0029'><span><code class="code">\D't <var class="var">n</var>'</code><a class="copiable-link" href='#index-line-thickness-_0028_005cD_0027t-_2026_0027_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-thickness-of-lines-_0028_005cD_0027t-_2026_0027_0029"></a>
+<p>Set the stroke thickness of geometric objects to <var class="var">n</var> basic units.  A
+zero <var class="var">n</var> selects the minimal supported thickness.  A negative
+<var class="var">n</var> selects a thickness proportional to the type size; this is the
+default.
+</p></dd>
+</dl>
+</dd></dl>
+
+<p>In a hazy penumbra between text rendering and drawing commands we locate
+the bracket-building escape sequence, <code class="code">\b</code>.  It can assemble
+apparently large glyphs by vertically stacking ordinary ones.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cb_0027contents_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\b<code class="code">'</code></code><span class="r"><i class="slanted">contents</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cb_0027contents_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cb"></a>
+<a class="index-entry-id" id="index-pile_002c-glyph-_0028_005cb_0029"></a>
+<a class="index-entry-id" id="index-glyph-pile-_0028_005cb_0029"></a>
+<a class="index-entry-id" id="index-stacking-glyphs-_0028_005cb_0029"></a>
+<p>Pile and center a sequence of glyphs vertically on the output line.
+<em class="dfn">Piling</em> stacks glyphs corresponding to each character in
+<var class="var">contents</var>, read from left to right, and placed from top to bottom.
+GNU <code class="code">troff</code> separates the glyphs vertically by 1<span class="dmn">m</span>, and the
+pile itself is centered 0.5<span class="dmn">m</span> above the text baseline.  The
+horizontal drawing position is then advanced by the width of the widest
+glyph in the pile.
+</p>
+<a class="index-entry-id" id="index-_005cb_002c-limitations-of"></a>
+<a class="index-entry-id" id="index-limitations-of-_005cb-escape-sequence"></a>
+<p>This rather inflexible positioning algorithm doesn&rsquo;t work with the
+<code class="code">dvi</code> output device since its bracket pieces vary in height.
+Instead, use the <code class="code">geqn</code> preprocessor.
+</p>
+<p><a class="ref" href="Manipulating-Spacing.html">Manipulating Spacing</a> describes how to adjust the vertical spacing
+of the output line with the <code class="code">\x</code> escape sequence.
+</p>
+<p>The application of <code class="code">\b</code> that lends its name is construction of
+brackets, braces, and parentheses when typesetting mathematics.  We
+might construct a large opening (left) brace as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\b'\lt\bv\lk\bv\lb'
+</pre></div></div>
+
+<p>See <cite class="cite">groff_char<span class="r">(7)</span></cite> for a list of special character
+identifiers.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Traps.html">Traps</a>, Previous: <a href="Page-Motions.html">Page Motions</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Dummy-Characters.html Added

@@ -0,0 +1,166 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Dummy Characters (The GNU Troff Manual)</title>
+
+<meta name="description" content="Dummy Characters (The GNU Troff Manual)">
+<meta name="keywords" content="Dummy Characters (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Italic-Corrections.html" rel="prev" title="Italic Corrections">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Dummy-Characters">
+<div class="nav-panel">
+<p>
+Previous: <a href="Italic-Corrections.html" accesskey="p" rel="prev">Italic Corrections</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Dummy-Characters-1">5.19.10 Dummy Characters</h4>
+
+<p>As discussed in <a class="ref" href="Requests-and-Macros.html">Requests and Macros</a>, the first character on an
+input line is treated specially.  Further, formatting a glyph has many
+consequences on formatter state (see <a class="pxref" href="Environments.html">Environments</a>).  Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0026-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\&amp;</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0026-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0026"></a>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029"></a>
+<p>Interpolate a dummy character, which is constitutive of output but
+invisible.<a class="footnote" id="DOCF81" href="groff.html_fot.html#FOOT81"><sup>81</sup></a>  Its presence alters the interpretation context of a
+subsequent input character, and enjoys several applications.
+</p>
+<ul class="itemize mark-bullet">
+<li>Prevent insertion of extra space after an end-of-sentence character.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">Test.
+Test.
+    &rArr; Test.  Test.
+Test.\&amp;
+Test.
+    &rArr; Test. Test.
+</pre></div></div>
+
+</li><li>Prevent recognition of a control character.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.Test
+    error&rarr; warning: macro 'Test' not defined
+\&amp;.Test
+    &rArr; .Test
+</pre></div></div>
+
+</li><li>Prevent kerning between two glyphs.
+
+
+</li><li>Translate a character to &ldquo;nothing&rdquo;.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr JIjiK\&amp;k\&amp;UVuv
+Post universitum, alea jacta est, OK?
+    &rArr; Post vniversitvm, alea iacta est, O?
+</pre></div></div>
+</li></ul>
+
+<p>The dummy character escape sequence sees use in macro definitions as a
+means of ensuring that arguments are treated as text even if they begin
+with spaces or control characters.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de HD \&quot; typeset a simple bold heading
+.  sp
+.  ft B
+\&amp;\\$1 \&quot; exercise: remove the \&amp;
+.  ft
+.  sp
+..
+.HD .\|.\|.\|surprised?
+</pre></div></div>
+</dd></dl>
+
+<p>One way to think about the dummy character is to imagine placing the
+symbol &lsquo;<samp class="samp">&amp;</samp>&rsquo; in the input at a certain location; if doing so has all
+the side effects on formatting that you desire except for sticking an
+ugly ampersand in the midst of your text, the dummy character is what
+you want in its place.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0029-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\)</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0029-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0029"></a>
+<a class="index-entry-id" id="index-transparent-dummy-character-_0028_005c_0029_0029"></a>
+<a class="index-entry-id" id="index-character_002c-transparent-dummy-_0028_005c_0029_0029"></a>
+<a class="index-entry-id" id="index-dummy-character_002c-transparent-_0028_005c_0029_0029"></a>
+<p>Interpolate a <i class="slanted">transparent</i> dummy character&mdash;one that is
+transparent to end-of-sentence detection.  It behaves as <code class="code">\&amp;</code>,
+except that <code class="code">\&amp;</code> is treated as letters and numerals normally are
+after &lsquo;<samp class="samp">.</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo; and &lsquo;<samp class="samp">!</samp>&rsquo;; <code class="code">\&amp;</code> cancels end-of-sentence
+detection, and <code class="code">\)</code> does not.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Suffix-&amp;
+.  nop \&amp;\\$1
+..
+.
+.de Suffix-)
+.  nop \)\\$1
+..
+.
+Here's a sentence.\c
+.Suffix-&amp; '
+Another one.\c
+.Suffix-) '
+And a third.
+    &rArr; Here's a sentence.' Another one.'  And a third.
+</pre></div></div>
+</dd></dl>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Italic-Corrections.html">Italic Corrections</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/End_002dof_002dinput-Traps.html Added

@@ -0,0 +1,187 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>End-of-input Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="End-of-input Traps (The GNU Troff Manual)">
+<meta name="keywords" content="End-of-input Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Traps.html" rel="up" title="Traps">
+<link href="Leading-Space-Traps.html" rel="prev" title="Leading Space Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="End_002dof_002dinput-Traps">
+<div class="nav-panel">
+<p>
+Previous: <a href="Leading-Space-Traps.html" accesskey="p" rel="prev">Leading Space Traps</a>, Up: <a href="Traps.html" accesskey="u" rel="up">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="End_002dof_002dinput-Traps-1">5.28.5 End-of-input Traps</h4>
+<a class="index-entry-id" id="index-end_002dof_002dinput-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-end_002dof_002dinput"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.em</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-em"></a>
+<a class="index-entry-id" id="index-setting-end_002dof_002dinput-trap-_0028em_0029"></a>
+<a class="index-entry-id" id="index-end_002dof_002dinput-trap_002c-setting-_0028em_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-end_002dof_002dinput_002c-setting-_0028em_0029"></a>
+<a class="index-entry-id" id="index-end_002dof_002dinput-macro-_0028em_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-end_002dof_002dinput-_0028em_0029"></a>
+<p>Set a trap at the end of input, calling macro <var class="var">name</var> after the last
+line of the last input file has been processed.  If no argument is
+given, any existing end-of-input trap is removed.
+</p>
+<p>For example, if the document had to have a section at the bottom of the
+last page for someone to approve it, the <code class="code">em</code> request could be
+used.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de approval
+\c
+.  ne 3v
+.  sp (\\n.tu - 3v)
+.  in +4i
+.  lc _
+.  br
+Approved:\t\a
+.  sp
+Date:\t\t\a
+..
+.
+.em approval
+</pre></div></div>
+
+<p>The <code class="code">\c</code> in the above example needs explanation.  For historical
+reasons (compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>), the
+end-of-input macro exits as soon as it causes a page break if no
+partially collected line remains.<a class="footnote" id="DOCF111" href="groff.html_fot.html#FOOT111"><sup>111</sup></a>
+</p>
+<a class="index-entry-id" id="index-page-break_002c-final"></a>
+<a class="index-entry-id" id="index-break_002c-page_002c-final"></a>
+<a class="index-entry-id" id="index-page-ejection_002c-of-final-page"></a>
+<a class="index-entry-id" id="index-ejection_002c-page_002c-of-final-page"></a>
+<p>Let us assume that there is no <code class="code">\c</code> in the above <code class="code">approval</code>
+macro, that the page is full, and last output line has been broken with,
+say, a <code class="code">br</code> request.  Because there is no more room, a <code class="code">ne</code>
+request at this point causes a page ejection, which in turn makes
+<code class="code">troff</code> exit immediately as just described.  In most situations,
+this is not desired; people generally want to format the input after
+<code class="code">ne</code>.
+</p>
+<p>To force processing of the whole end-of-input macro independently of
+this behavior, it is thus advisable to (invisibly) ensure the existence
+of a partially collected line (<code class="code">\c</code>) whenever there is a chance
+that a page break can happen.  In the above example, invoking the
+<code class="code">ne</code> request ensures that there is room for the subsequent
+formatted output on the same page, so we need insert <code class="code">\c</code> only
+once.
+</p>
+<p>The next example shows how to append three lines, then start a new page
+unconditionally.  Since &lsquo;<samp class="samp">.ne&nbsp;1</samp>&rsquo; doesn&rsquo;t give the desired
+effect&mdash;there is always one line available or we are already at the
+beginning of the next page&mdash;we temporarily increase the page length by
+one line so that we can use &lsquo;<samp class="samp">.ne&nbsp;2</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de EM
+.pl +1v
+\c
+.ne 2
+line one
+.br
+\c
+.ne 2
+line two
+.br
+\c
+.ne 2
+line three
+.br
+.pl -1v
+\c
+'bp
+..
+.em EM
+</pre></div></div>
+
+<p>This specific feature affects only the first potential page break caused
+by the end-of-input macro; further page breaks emitted by the macro are
+handled normally.
+</p>
+<p>Another possible use of the <code class="code">em</code> request is to make GNU
+<code class="code">troff</code> emit a single large page instead of multiple pages.  For
+example, one may want to produce a long plain text file for reading
+in a terminal or emulator without page footers and headers interrupting
+the body of the document.  One approach is to set the page length at the
+beginning of the document to a very large value to hold all the
+text,<a class="footnote" id="DOCF112" href="groff.html_fot.html#FOOT112"><sup>112</sup></a> and
+automatically adjust it to the exact height of the document after the
+text has been output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de adjust-page-length
+.  br
+.  pl \\nnlu \&quot; \nnl: current vertical position
+..
+.
+.de single-page-mode
+.  pl 99999
+.  em adjust-page-length
+..
+.
+.\&quot; Activate the above code if configured.
+.if \ndo-continuous-rendering \
+.  single-page-mode
+</pre></div></div>
+
+<p>Since only one end-of-input trap exists and another macro package may
+already use it, care must be taken not to break the mechanism.  A simple
+solution would be to append the above macro to the macro package&rsquo;s
+end-of-input macro using the <code class="code">am</code> request.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Leading-Space-Traps.html">Leading Space Traps</a>, Up: <a href="Traps.html">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Environment.html Added

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Environment (The GNU Troff Manual)</title>
+
+<meta name="description" content="Environment (The GNU Troff Manual)">
+<meta name="keywords" content="Environment (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Macro-Directories.html" rel="next" title="Macro Directories">
+<link href="Groff-Options.html" rel="prev" title="Groff Options">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Environment">
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Directories.html" accesskey="n" rel="next">Macro Directories</a>, Previous: <a href="Groff-Options.html" accesskey="p" rel="prev">Options</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Environment-1">2.2 Environment</h3>
+<a class="index-entry-id" id="index-environment-variables"></a>
+<a class="index-entry-id" id="index-variables-in-environment"></a>
+
+<p>There are also several environment variables (of the operating system,
+not within <code class="code">gtroff</code>) that can modify the behavior of <code class="code">groff</code>.
+</p>
+<dl class="table">
+<dt id='index-GROFF_005fBIN_005fPATH_002c-environment-variable'><span><code class="code">GROFF_BIN_PATH</code><a class="copiable-link" href='#index-GROFF_005fBIN_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>This search path, followed by <code class="code">PATH</code>, is used for commands executed
+by <code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable'><span><code class="code">GROFF_COMMAND_PREFIX</code><a class="copiable-link" href='#index-GROFF_005fCOMMAND_005fPREFIX_002c-environment-variable'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-command-prefix"></a>
+<a class="index-entry-id" id="index-prefix_002c-for-commands"></a>
+<p>If this is set to&nbsp;<var class="var">X</var>, then <code class="command">groff</code> runs
+<code class="command"><var class="var">X</var>troff</code> instead of <code class="command">gtroff</code>.  This also applies
+to <code class="command">tbl</code>, <code class="command">pic</code>, <code class="command">eqn</code>, <code class="command">grn</code>,
+<code class="command">chem</code>, <code class="command">refer</code>, and <code class="command">soelim</code>.  It does not
+apply to <code class="command">grops</code>, <code class="command">grodvi</code>, <code class="command">grotty</code>,
+<code class="command">pre-grohtml</code>, <code class="command">post-grohtml</code>, <code class="command">preconv</code>,
+<code class="command">grolj4</code>, <code class="command">gropdf</code>, and <code class="command">gxditview</code>.
+</p>
+<p>The default command prefix is determined during the installation
+process.  If a non-GNU <code class="code">troff</code> system is found, prefix &lsquo;<samp class="samp">g</samp>&rsquo; is
+used, none otherwise.
+</p>
+</dd>
+<dt id='index-GROFF_005fENCODING_002c-environment-variable'><span><code class="code">GROFF_ENCODING</code><a class="copiable-link" href='#index-GROFF_005fENCODING_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>The value of this variable is passed to the <code class="code">preconv</code>
+preprocessor&rsquo;s <samp class="option">-e</samp> option to select the character encoding of
+input files.  This variable&rsquo;s existence implies the <code class="code">groff</code> option
+<samp class="option">-k</samp>.  If set but empty, <code class="code">groff</code> calls <code class="code">preconv</code>
+without an <samp class="option">-e</samp> option.  <code class="code">groff</code>&rsquo;s <samp class="option">-K</samp> option
+overrides <code class="env">GROFF_ENCODING</code>.  See the <cite class="cite">preconv<span class="r">(7)</span></cite> man page;
+type &lsquo;<samp class="samp">man preconv</samp>&rsquo; at the command line to view it.
+</p>
+</dd>
+<dt id='index-GROFF_005fFONT_005fPATH_002c-environment-variable'><span><code class="code">GROFF_FONT_PATH</code><a class="copiable-link" href='#index-GROFF_005fFONT_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A list of directories in which to seek the selected output device&rsquo;s
+directory of device and font description files.  GNU <code class="code">troff</code>
+will search directories given as arguments to any specified <samp class="option">-F</samp>
+options before these, and a built-in list of directories after them.
+See <a class="xref" href="Font-Directories.html">Font Directories</a> and the <cite class="cite">troff<span class="r">(1)</span></cite> or
+<cite class="cite">gtroff<span class="r">(1)</span></cite> man pages.
+</p>
+</dd>
+<dt id='index-GROFF_005fTMAC_005fPATH_002c-environment-variable'><span><code class="code">GROFF_TMAC_PATH</code><a class="copiable-link" href='#index-GROFF_005fTMAC_005fPATH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A list of directories in which to seek macro files.  GNU <code class="code">troff</code>
+will search directories given as arguments to any specified <samp class="option">-M</samp>
+options before these, and a built-in list of directories after them.
+See <a class="xref" href="Macro-Directories.html">Macro Directories</a> and the <cite class="cite">troff<span class="r">(1)</span></cite> or
+<cite class="cite">gtroff<span class="r">(1)</span></cite> man pages.
+</p>
+</dd>
+<dt id='index-GROFF_005fTMPDIR_002c-environment-variable'><span><code class="code">GROFF_TMPDIR</code><a class="copiable-link" href='#index-GROFF_005fTMPDIR_002c-environment-variable'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TMPDIR_002c-environment-variable"></a>
+<p>The directory in which <code class="code">groff</code> creates temporary files.  If this is
+not set and <code class="env">TMPDIR</code> is set, temporary files are created in that
+directory.  Otherwise temporary files are created in a system-dependent
+default directory (on Unix and GNU/Linux systems, this is usually
+<samp class="file">/tmp</samp>).  <code class="code">grops</code>, <code class="code">grefer</code>, <code class="code">pre-grohtml</code>, and
+<code class="code">post-grohtml</code> can create temporary files in this directory.
+</p>
+</dd>
+<dt id='index-GROFF_005fTYPESETTER_002c-environment-variable'><span><code class="code">GROFF_TYPESETTER</code><a class="copiable-link" href='#index-GROFF_005fTYPESETTER_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>Sets the default output device.  If empty or not set, a build-time
+default (often <code class="code">ps</code>) is used.  The <samp class="option">-T<var class="var">dev</var></samp> option
+overrides <code class="env">GROFF_TYPESETTER</code>.
+</p>
+</dd>
+<dt id='index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable'><span><code class="code">SOURCE_DATE_EPOCH</code><a class="copiable-link" href='#index-SOURCE_005fDATE_005fEPOCH_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>A timestamp (expressed as seconds since the Unix epoch) to use as the
+output creation timestamp in place of the current time.  The time is
+converted to human-readable form using <cite class="cite">localtime<span class="r">(3)</span></cite> when the
+formatter starts up and stored in registers usable by documents and
+macro packages (see <a class="pxref" href="Built_002din-Registers.html">Built-in Registers</a>).
+</p>
+</dd>
+<dt id='index-TZ_002c-environment-variable'><span><code class="code">TZ</code><a class="copiable-link" href='#index-TZ_002c-environment-variable'> &para;</a></span></dt>
+<dd><p>The time zone to use when converting the current time (or value of
+<code class="env">SOURCE_DATE_EPOCH</code>) to human-readable form; see
+<cite class="cite">tzset<span class="r">(3)</span></cite>.
+</p></dd>
+</dl>
+
+<p>MS-DOS and MS-Windows ports of <code class="code">groff</code> use semicolons, rather than
+colons, to separate the directories in the lists described above.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Directories.html">Macro Directories</a>, Previous: <a href="Groff-Options.html">Options</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Environments.html Added

@@ -0,0 +1,250 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Environments (The GNU Troff Manual)</title>
+
+<meta name="description" content="Environments (The GNU Troff Manual)">
+<meta name="keywords" content="Environments (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Suppressing-Output.html" rel="next" title="Suppressing Output">
+<link href="Diversions.html" rel="prev" title="Diversions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Environments">
+<div class="nav-panel">
+<p>
+Next: <a href="Suppressing-Output.html" accesskey="n" rel="next">Suppressing Output</a>, Previous: <a href="Diversions.html" accesskey="p" rel="prev">Diversions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Environments-1">5.31 Environments</h3>
+<a class="index-entry-id" id="index-environments"></a>
+
+<p>As discussed in <a class="ref" href="Deferring-Output.html">Deferring Output</a>, environments store most of the
+parameters that determine the appearance of text.  A default environment
+named &lsquo;<samp class="samp">0</samp>&rsquo; exists when GNU <code class="code">troff</code> starts up; it is modified by
+formatting-related requests and escape sequences.
+</p>
+<a class="index-entry-id" id="index-stack"></a>
+<p>You can create new environments and switch among them.  Only one is
+current at any given time.  Active environments are managed using a
+<em class="dfn">stack</em>, a data structure supporting &ldquo;push&rdquo; and &ldquo;pop&rdquo;
+operations.  The current environment is at the top of the stack.
+The same environment name can be pushed onto the stack multiple times,
+possibly interleaved with others.  Popping the environment stack does
+not destroy the current environment; it remains accessible by name and
+can be made current again by pushing it at any time.  Environments
+cannot be renamed or deleted, and can only be modified when current.  To
+inspect the environment stack, use the <code class="code">pev</code> request; see
+<a class="ref" href="Debugging.html">Debugging</a>.
+</p>
+<p>Environments store the following information.
+</p>
+<ul class="itemize mark-bullet">
+<li>a partially collected line, if any
+
+</li><li>data about the most recently output glyph and line (registers
+<code class="code">.cdp</code>, <code class="code">.cht</code>, <code class="code">.csk</code>, <code class="code">.n</code>, <code class="code">.w</code>)
+
+</li><li>typeface parameters (size, family, style, height and slant, inter-word
+and inter-sentence space sizes)
+
+</li><li>page parameters (line length, title length, vertical spacing, line
+spacing, indentation, line numbering, centering, right-alignment,
+underlining, hyphenation parameters)
+
+</li><li>filling enablement; adjustment enablement and mode
+
+</li><li>tab stops; tab, leader, escape, control, no-break control, hyphenation,
+and margin characters
+
+</li><li>input line traps
+
+</li><li>stroke and fill colors
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eev"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ev</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">ident</i></span></var><a class="copiable-link" href='#index-_002eev'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ev"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eev_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ev</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eev_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eev-1"></a>
+<a class="index-entry-id" id="index-switching-environments-_0028ev_0029"></a>
+<a class="index-entry-id" id="index-environment_002c-switching-_0028ev_0029"></a>
+<a class="index-entry-id" id="index-environment-number_002fname-register-_0028_002eev_0029"></a>
+<p>Enter the environment <var class="var">ident</var>, which is created if it does not
+already exist, using the same parameters as for the default environment
+used at startup.  With no argument, GNU <code class="code">troff</code> switches to the
+previous environment.
+</p>
+<p>Invoking <code class="code">ev</code> with an argument puts environment <var class="var">ident</var> onto
+the top of the environment stack.  (If it isn&rsquo;t already present in the
+stack, this is a proper push.)  Without an argument, <code class="code">ev</code> pops the
+environment stack, making the previous environment current.  It is an
+error to pop the environment stack with no previous environment
+available.  The read-only string-valued register <code class="code">.ev</code> contains the
+name of the current environment&mdash;the one at the top of the stack.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ev footnote-env
+.fam N
+.ps 6
+.vs 8
+.ll -.5i
+.ev
+
+<span class="r">&hellip;</span>
+
+.ev footnote-env
+\dg Observe the smaller text and vertical spacing.
+.ev
+</pre></div></div>
+
+<p>We can familiarize ourselves with stack behavior by wrapping the
+<code class="code">ev</code> request with a macro that reports the contents of the
+<code class="code">.ev</code> register to the standard error stream.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de EV
+.  ev \\$1
+.  tm environment is now \\n.ev
+..
+.
+.EV foo
+.EV bar
+.EV
+.EV baz
+.EV
+.EV
+.EV
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">    error&rarr; environment is now foo
+    error&rarr; environment is now bar
+    error&rarr; environment is now foo
+    error&rarr; environment is now baz
+    error&rarr; environment is now foo
+    error&rarr; environment is now 0
+    error&rarr; error: environment stack underflow
+    error&rarr; environment is now 0
+</pre></div></div>
+
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eevc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.evc</code></strong> <var class="def-var-arguments">environment</var><a class="copiable-link" href='#index-_002eevc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-evc"></a>
+<a class="index-entry-id" id="index-copying-environment-_0028evc_0029"></a>
+<a class="index-entry-id" id="index-environment_002c-copying-_0028evc_0029"></a>
+<p>Copy the contents of <var class="var">environment</var> to the current environment.
+</p>
+<p>The following environment data are not copied.
+</p>
+<ul class="itemize mark-bullet">
+<li>a partially collected line, if present;
+
+</li><li>the interruption status of the previous input line (due to use of the
+<code class="code">\c</code> escape sequence);
+
+</li><li>the count of remaining lines to center, to right-justify, or to
+underline (with or without underlined spaces)&mdash;these are set to zero;
+
+</li><li>the activation status of temporary indentation;
+
+</li><li>input line traps and their associated data;
+
+</li><li>the activation status of line numbering (which can be reactivated with
+&lsquo;<samp class="samp">.nm&nbsp;+0</samp>&rsquo;); and
+
+</li><li>the count of consecutive hyphenated lines (set to zero).
+</li></ul>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ew_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.w</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ew_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ew"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002echt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cht</code></strong><a class="copiable-link" href='#index-_005cn_005b_002echt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002echt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecdp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.cdp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecdp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecdp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ecsk_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.csk</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ecsk_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ecsk"></a>
+<a class="index-entry-id" id="index-environment_002c-dimensions-of-last-glyph-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-width_002c-of-last-glyph-_0028_002ew_0029"></a>
+<a class="index-entry-id" id="index-height_002c-of-last-glyph-_0028_002echt_0029"></a>
+<a class="index-entry-id" id="index-depth_002c-of-last-glyph-_0028_002ecdp_0029"></a>
+<a class="index-entry-id" id="index-skew_002c-of-last-glyph-_0028_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-last-glyph_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-last_002c-dimensions-_0028_002ew_002c-_002echt_002c-_002ecdp_002c-_002ecsk_0029"></a>
+<p>The <code class="code">\n.w</code> register contains the width of the last glyph
+formatted in the environment.
+</p>
+<p>The <code class="code">\n.cht</code> register contains the height of the last glyph
+formatted in the environment.
+</p>
+<p>The <code class="code">\n.cdp</code> register contains the depth of the last glyph
+formatted in the environment.  It is positive for glyphs extending below
+the baseline.
+</p>
+<p>The <code class="code">\n.csk</code> register contains the <em class="dfn">skew</em> (how far to the
+right of the glyph&rsquo;s center that GNU <code class="code">troff</code> should place an
+accent) of the last glyph formatted in the environment.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002en_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.n</code></strong><a class="copiable-link" href='#index-_005cn_005b_002en_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002en"></a>
+<a class="index-entry-id" id="index-environment_002c-previous-line-length-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-line-length_002c-previous-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-length-of-previous-line-_0028_002en_0029"></a>
+<a class="index-entry-id" id="index-previous-line-length-_0028_002en_0029"></a>
+<p>The <code class="code">\n.n</code> register contains the length of the previous output
+line emitted in the environment.
+</p></dd></dl>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Suppressing-Output.html">Suppressing Output</a>, Previous: <a href="Diversions.html">Diversions</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Escape-Sequence-Index.html Added

@@ -0,0 +1,162 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Escape Sequence Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Escape Sequence Index (The GNU Troff Manual)">
+<meta name="keywords" content="Escape Sequence Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Operator-Index.html" rel="next" title="Operator Index">
+<link href="Request-Index.html" rel="prev" title="Request Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Escape-Sequence-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Operator-Index.html" accesskey="n" rel="next">Operator Index</a>, Previous: <a href="Request-Index.html" accesskey="p" rel="prev">Request Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Escape-Sequence-Index-1">Appendix C Escape Sequence Index</h2>
+
+<p>The escape character, <code class="code">\</code> by default, is always followed by at
+least one more input character, making an escape <em class="emph">sequence</em>.  Any
+input token <code class="code">\<var class="var">X</var></code> with <var class="var">X</var> not in the list below emits a
+warning and interpolates glyph <var class="var">X</var>.  Note the entries for <code class="code">\.</code>,
+which may be obscured by the leader dots, and for <code class="code">\<kbd class="key">RET</kbd></code> and
+<code class="code">\<kbd class="key">SP</kbd></code>, which are sorted alphabetically, not by code point
+order.
+</p>
+<div class="printindex es-printindex">
+<table class="es-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Escape-Sequence-Index_es_symbol-1">\</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-_005c"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c-1"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_0021"><code>\!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-_005c_0022"><code>\&quot;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-_005c_0023"><code>\#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_005c_0024"><code>\$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_005c_0024_002a"><code>\$*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_005c_00240"><code>\$0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_005c_0024_0040"><code>\$@</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_005c_0024_005e"><code>\$^</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_005c_0025"><code>\%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-_005c_0026"><code>\&amp;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_0027"><code>\<code class="code">'</code></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_0028"><code>$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Dummy-Characters.html#index-_005c_0029"><code>$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Dummy-Characters.html">Dummy Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-_005c_002a"><code>\*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-_005c_002c"><code>\,</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_002d"><code>\-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005c_002e"><code>\.</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Italic-Corrections.html#index-_005c_002f"><code>\/</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Italic-Corrections.html">Italic Corrections</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005c0"><code>\0</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_005c_003a"><code>\:</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_005c_003f"><code>\?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Identifiers.html#index-_005cA"><code>\A</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Identifiers.html">Identifiers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-_005ca"><code>\a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_005cB"><code>\B</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-_005cb"><code>\b</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cc"><code>\c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005cC"><code>\C</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cd"><code>\d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-_005cD"><code>\D</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-_005ce"><code>\e</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005cE"><code>\E</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-_005cf"><code>\f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-_005cF"><code>\F</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-_005cg"><code>\g</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-_005cH"><code>\H</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005ch"><code>\h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005ck"><code>\k</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-_005cl"><code>\l</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Drawing-Geometric-Objects.html#index-_005cL"><code>\L</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-_005cm"><code>\m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-_005cM"><code>\M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Interpolating-Registers.html#index-_005cn"><code>\n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Interpolating-Registers.html">Interpolating Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-_005cn-1"><code>\n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005cN"><code>\N</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cnewline"><code>\<i class="slanted">newline</i></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005co"><code>\o</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-_005cO"><code>\O</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_005cp"><code>\p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-_005cR"><code>\R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-_005cR-1"><code>\R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cr"><code>\r</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_005cRET"><code>\<kbd class="key">RET</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-_005cS"><code>\S</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-_005cs"><code>\s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cSP"><code>\<kbd class="key">SP</kbd></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cspace"><code>\<i class="slanted">space</i></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_005ct"><code>\t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cu"><code>\u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cv"><code>\v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-_005cV"><code>\V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cw"><code>\w</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-_005cx"><code>\x</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005cX"><code>\X</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-_005cY"><code>\Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cz"><code>\z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005cZ"><code>\Z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_005b"><code>\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Copy-Mode.html#index-_005c_005c"><code>\\</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Copy-Mode.html">Copy Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005c_005e"><code>\^</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_005f"><code>\_</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-_005c_0060"><code>\<code class="code">`</code></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-_005c_007b"><code>\{</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-_005c_007b-1"><code>\{</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_005c_007c"><code>\|</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Conditional-Blocks.html#index-_005c_007d"><code>\}</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Conditional-Blocks.html">Conditional Blocks</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_005c_007e"><code>\~</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Operator-Index.html">Operator Index</a>, Previous: <a href="Request-Index.html">Request Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Fields.html Added

@@ -0,0 +1,98 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Fields (The GNU Troff Manual)</title>
+
+<meta name="description" content="Fields (The GNU Troff Manual)">
+<meta name="keywords" content="Fields (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Tabs-and-Fields.html" rel="up" title="Tabs and Fields">
+<link href="Leaders.html" rel="prev" title="Leaders">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Fields">
+<div class="nav-panel">
+<p>
+Previous: <a href="Leaders.html" accesskey="p" rel="prev">Leaders</a>, Up: <a href="Tabs-and-Fields.html" accesskey="u" rel="up">Tabs and Fields</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Fields-1">5.12.2 Fields</h4>
+<a class="index-entry-id" id="index-fields"></a>
+
+<a class="index-entry-id" id="index-field-delimiting-character-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-delimiting-character_002c-for-fields-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-field-delimiting-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-field-padding-character-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-padding-character_002c-for-fields-_0028fc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-field-padding-_0028fc_0029"></a>
+<p><em class="dfn">Fields</em> are a more general way of laying out tabular data.  A field
+is defined as the data between a pair of <em class="dfn">delimiting characters</em>.
+It contains substrings that are separated by <em class="dfn">padding characters</em>.
+The width of a field is the distance on the <em class="emph">input</em> line from the
+position where the field starts to the next tab stop.  A padding
+character inserts an adjustable space similar to TeX&rsquo;s <code class="code">\hss</code>
+command (thus it can even be negative) to make the sum of all substring
+lengths plus the adjustable space equal to the field width.  If more
+than one padding character is inserted, the available space is evenly
+distributed among them.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">delim-char</i></span> <span class="r"><i class="slanted">padding-char</i></span></var><a class="copiable-link" href='#index-_002efc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fc"></a>
+<p>Define a delimiting and a padding character for fields.  If the latter
+is missing, the padding character defaults to a space character.  If
+there is no argument at all, the field mechanism is disabled (which is
+the default).  In contrast to, e.g., the tab repetition character,
+delimiting and padding characters are <em class="emph">not</em> associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fc # ^
+.ta T 3i
+#foo^bar^smurf#
+.br
+#foo^^bar^smurf#
+    &rArr; foo         bar          smurf
+    &rArr; foo            bar       smurf
+</pre></div></div>
+</dd></dl>
+
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/File-Formats.html Added

@@ -0,0 +1,62 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>File Formats (The GNU Troff Manual)</title>
+
+<meta name="description" content="File Formats (The GNU Troff Manual)">
+<meta name="keywords" content="File Formats (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Copying-This-Manual.html" rel="next" title="Copying This Manual">
+<link href="GNU-troff-Reference.html" rel="prev" title="GNU troff Reference">
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="File-Formats">
+<div class="nav-panel">
+<p>
+Next: <a href="Copying-This-Manual.html" accesskey="n" rel="next">Copying This Manual</a>, Previous: <a href="GNU-troff-Reference.html" accesskey="p" rel="prev">GNU <code class="code">troff</code> Reference</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="File-Formats-1">6 File Formats</h2>
+<a class="index-entry-id" id="index-file-formats"></a>
+<a class="index-entry-id" id="index-formats_002c-file"></a>
+
+<p>All files read and written by <code class="code">gtroff</code> are text files.  The
+following two sections describe their format.
+</p>
+
+
+
+
+<ul class="mini-toc">
+<li><a href="gtroff-Output.html" accesskey="1"><code class="code">gtroff</code> Output</a></li>
+<li><a href="Device-and-Font-Description-Files.html" accesskey="2">Device and Font Description Files</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/File-Keyword-Index.html Added

@@ -0,0 +1,215 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>File Keyword Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="File Keyword Index (The GNU Troff Manual)">
+<meta name="keywords" content="File Keyword Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Program-and-File-Index.html" rel="next" title="Program and File Index">
+<link href="String-Index.html" rel="prev" title="String Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="File-Keyword-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Program-and-File-Index.html" accesskey="n" rel="next">Program and File Index</a>, Previous: <a href="String-Index.html" accesskey="p" rel="prev">String Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="File-Keyword-Index-1">Appendix H File Keyword Index</h2>
+
+<div class="printindex ky-printindex">
+<table class="ky-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-1"><b>#</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-2"><b>-</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="ky-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_symbol-1">#</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-_0023"><code>#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-_0023-1"><code>#</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_symbol-2">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-_002d_002d_002d"><code>---</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-biggestfont"><code>biggestfont</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-charset"><code>charset</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-charset-1"><code>charset</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-family"><code>family</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-family-1"><code>family</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fonts"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-fonts-1"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-fonts-2"><code>fonts</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-hor"><code>hor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-image_005fgenerator"><code>image_generator</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-kernpairs"><code>kernpairs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-ligatures"><code>ligatures</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-name"><code>name</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-paperlength"><code>paperlength</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-papersize"><code>papersize</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-paperwidth"><code>paperwidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-pass_005ffilenames"><code>pass_filenames</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-postpro"><code>postpro</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-prepro"><code>prepro</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-print"><code>print</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-res"><code>res</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-sizes"><code>sizes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-sizescale"><code>sizescale</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-slant"><code>slant</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-spacewidth"><code>spacewidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-spare1"><code>spare1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-spare2"><code>spare2</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-special"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Description-File-Format.html#index-special-1"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Description-File-Format.html">Font Description File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-styles"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-styles-1"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-styles-2"><code>styles</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-tcommand"><code>tcommand</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-unicode"><code>unicode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-unitwidth"><code>unitwidth</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-unscaled_005fcharwidths"><code>unscaled_charwidths</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-use_005fcharnames_005fin_005fspecial"><code>use_charnames_in_special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-use_005fcharnames_005fin_005fspecial-1"><code>use_charnames_in_special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="File-Keyword-Index_ky_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="DESC-File-Format.html#index-vert"><code>vert</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="DESC-File-Format.html">DESC File Format</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="ky-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-1"><b>#</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_symbol-2"><b>-</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#File-Keyword-Index_ky_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Program-and-File-Index.html">Program and File Index</a>, Previous: <a href="String-Index.html">String Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Filling.html Added

@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Filling (The GNU Troff Manual)</title>
+
+<meta name="description" content="Filling (The GNU Troff Manual)">
+<meta name="keywords" content="Filling (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Sentences.html" rel="next" title="Sentences">
+<link href="Text.html" rel="prev" title="Text">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Filling">
+<div class="nav-panel">
+<p>
+Next: <a href="Sentences.html" accesskey="n" rel="next">Sentences</a>, Previous: <a href="Text.html" accesskey="p" rel="prev">Text</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Filling-1">5.1.1 Filling</h4>
+
+<p>When GNU <code class="code">troff</code> starts up, it obtains information about the device
+for which it is preparing output.<a class="footnote" id="DOCF18" href="groff.html_fot.html#FOOT18"><sup>18</sup></a>  An essential property is the length of the output
+line, such as &ldquo;6.5 inches&rdquo;.
+</p>
+<a class="index-entry-id" id="index-word_002c-definition-of"></a>
+<a class="index-entry-id" id="index-filling"></a>
+<p>GNU <code class="code">troff</code> interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can&mdash;this is known as <em class="dfn">filling</em>.  To GNU
+<code class="code">troff</code>, a <em class="dfn">word</em> is any sequence of one or more characters
+that aren&rsquo;t spaces or newlines.  The exceptions separate
+words.<a class="footnote" id="DOCF19" href="groff.html_fot.html#FOOT19"><sup>19</sup></a>  To disable filling, see
+<a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">It is a truth universally acknowledged
+that a single man in possession of a
+good fortune must be in want of a wife.
+    &rArr; It is a truth universally acknowledged that a
+    &rArr; single man in possession of a good fortune must
+    &rArr; be in want of a wife.
+</pre></div></div>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Font-Description-File-Format.html Added

@@ -0,0 +1,280 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Font Description File Format (The GNU Troff Manual)</title>
+
+<meta name="description" content="Font Description File Format (The GNU Troff Manual)">
+<meta name="keywords" content="Font Description File Format (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Device-and-Font-Description-Files.html" rel="up" title="Device and Font Description Files">
+<link href="DESC-File-Format.html" rel="prev" title="DESC File Format">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Font-Description-File-Format">
+<div class="nav-panel">
+<p>
+Previous: <a href="DESC-File-Format.html" accesskey="p" rel="prev"><samp class="file">DESC</samp> File Format</a>, Up: <a href="Device-and-Font-Description-Files.html" accesskey="u" rel="up">Device and Font Description Files</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Font-Description-File-Format-1">6.2.2 Font Description File Format</h4>
+<a class="index-entry-id" id="index-font-file_002c-format"></a>
+<a class="index-entry-id" id="index-font-description-file_002c-format"></a>
+<a class="index-entry-id" id="index-format-of-font-files"></a>
+<a class="index-entry-id" id="index-format-of-font-description-files"></a>
+
+<p>On typesetting output devices, each font is typically available at
+multiple sizes.  While paper measurements in the device description file
+are in absolute units, measurements applicable to fonts must be
+proportional to the type size.  <code class="code">groff</code> achieves this using the
+precedent set by <abbr class="acronym">AT&amp;T</abbr> device-independent <code class="code">troff</code>: one
+font size is chosen as a norm, and all others are scaled linearly
+relative to that basis.  The &ldquo;unit width&rdquo; is the number of basic units
+per point when the font is rendered at this nominal size.
+</p>
+<p>For instance, <code class="code">groff</code>&rsquo;s <code class="code">lbp</code> device uses a <code class="code">unitwidth</code>
+of&nbsp;800.  Its Times roman font &lsquo;<samp class="samp">TR</samp>&rsquo; has a <code class="code">spacewidth</code>
+of&nbsp;833; this is also the width of its comma, period, centered
+period, and mathematical asterisk, while its &lsquo;<samp class="samp">M</samp>&rsquo; is 2,963 basic
+units.  Thus, an &lsquo;<samp class="samp">M</samp>&rsquo; on the <code class="code">lbp</code> device is 2,963 basic units
+wide at a notional type size of 800&nbsp;points.<a class="footnote" id="DOCF126" href="groff.html_fot.html#FOOT126"><sup>126</sup></a>
+</p>
+<p>A font description file has two sections.  The first is a sequence of
+directives, and is parsed similarly to the <samp class="file">DESC</samp> file described
+above.  Except for the directive names that begin the second section,
+their ordering is immaterial.  Later directives of the same name
+override earlier ones, spaces and tabs are handled in the same way,
+<a class="index-entry-id" id="index-comments-in-font-description-files"></a>
+<a class="index-entry-id" id="index-font-description-files_002c-comments"></a>
+<a class="index-entry-id" id="index-_0023-1"></a>
+and the same comment syntax is supported.  Empty lines are ignored
+throughout.
+</p>
+<dl class="table">
+<dt id='index-name'><span><code class="code">name <var class="var">f</var></code><a class="copiable-link" href='#index-name'> &para;</a></span></dt>
+<dd><p>The name of the font is&nbsp;<var class="var">f</var>.  &lsquo;<samp class="samp">DESC</samp>&rsquo; is an invalid font
+name.  Simple integers are valid, but their use is
+discouraged.<a class="footnote" id="DOCF127" href="groff.html_fot.html#FOOT127"><sup>127</sup></a>
+</p>
+</dd>
+<dt id='index-spacewidth'><span><code class="code">spacewidth <var class="var">n</var></code><a class="copiable-link" href='#index-spacewidth'> &para;</a></span></dt>
+<dd><p>The width of an unadjusted inter-word space is <var class="var">n</var>&nbsp;basic units.
+</p></dd>
+</dl>
+
+<p>The directives above must appear in the first section; those below are
+optional.
+</p>
+<dl class="table">
+<dt id='index-slant'><span><code class="code">slant <var class="var">n</var></code><a class="copiable-link" href='#index-slant'> &para;</a></span></dt>
+<dd><p>The font&rsquo;s glyphs have a slant of <var class="var">n</var>&nbsp;degrees; a positive
+<var class="var">n</var> slants in the direction of text flow.
+</p>
+</dd>
+<dt id='index-ligatures'><span><code class="code">ligatures <var class="var">lig1</var> <span class="r">&hellip;</span> <var class="var">lign</var> <span class="r"></span>0<span class="r"></span></code><a class="copiable-link" href='#index-ligatures'> &para;</a></span></dt>
+<dd><p>Glyphs <var class="var">lig1</var>, &hellip;, <var class="var">lign</var> are ligatures; possible ligatures
+are &lsquo;<samp class="samp">ff</samp>&rsquo;, &lsquo;<samp class="samp">fi</samp>&rsquo;, &lsquo;<samp class="samp">fl</samp>&rsquo;, &lsquo;<samp class="samp">ffi</samp>&rsquo; and &lsquo;<samp class="samp">ffl</samp>&rsquo;.  For
+compatibility with other <code class="code">troff</code> implementations, the list of
+ligatures may be terminated with a&nbsp;<code class="code">0</code>.  The list of ligatures
+must not extend over more than one line.
+</p>
+</dd>
+<dt id='index-special-fonts-2'><span><code class="code">special</code><a class="copiable-link" href='#index-special-fonts-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-special-1"></a>
+<p>The font is <em class="dfn">special</em>: when a glyph is requested that is not present
+in the current font, it is sought in any mounted fonts that bear this
+property.
+</p></dd>
+</dl>
+
+<p>Other directives in this section are ignored by GNU <code class="code">troff</code>, but
+may be used by postprocessors to obtain further information about the
+font.
+</p>
+<p>The second section contains one or two subsections.  These can appear in
+either order; the first one encountered commences the second section.
+Each starts with a directive on a line by itself.  A <code class="code">charset</code>
+subsection is mandatory unless the associated <samp class="file">DESC</samp> file contains
+the <code class="code">unicode</code> directive.  Another subsection, <code class="code">kernpairs</code>,
+is optional.
+</p>
+<a class="index-entry-id" id="index-charset-1"></a>
+<p>The directive <code class="code">charset</code> starts the character set
+subsection.<a class="footnote" id="DOCF128" href="groff.html_fot.html#FOOT128"><sup>128</sup></a>  It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
+</p>
+<blockquote class="quotation">
+<p><var class="var">name</var> <var class="var">metrics</var> <var class="var">type</var> <var class="var">code</var> <var class="var">entity-name</var>
+<code class="code">--</code> <var class="var">comment</var>
+</p></blockquote>
+
+<a class="index-entry-id" id="index-8_002dbit-input"></a>
+<a class="index-entry-id" id="index-input_002c-8_002dbit"></a>
+<a class="index-entry-id" id="index-accessing-unnamed-glyphs-with-_005cN"></a>
+<a class="index-entry-id" id="index-unnamed-glyphs_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-characters_002c-unnamed_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-glyphs_002c-unnamed_002c-accessing-with-_005cN"></a>
+<a class="index-entry-id" id="index-_002d_002d_002d"></a>
+<p><var class="var">name</var> identifies the glyph:
+if <var class="var">name</var> is a printable character&nbsp;<var class="var">c</var>, it corresponds to
+the <code class="code">troff</code> ordinary character&nbsp;<var class="var">c</var>.  If <var class="var">name</var> is a
+multi-character sequence not beginning with <code class="code">\</code>, it corresponds to
+the GNU <code class="code">troff</code> special character escape sequence
+&lsquo;<samp class="samp">\<var class="var">name</var></samp>&rsquo;.  A name consisting of three minus signs,
+&lsquo;<samp class="samp">---</samp>&rsquo;, is special and indicates that the glyph is unnamed: such
+glyphs can be accessed only by the <code class="code">\N</code> escape sequence in
+<code class="code">troff</code>.  A special character named &lsquo;<samp class="samp">---</samp>&rsquo; can still be defined
+using <code class="code">char</code> and similar requests.  The <var class="var">name</var> &lsquo;<samp class="samp">\-</samp>&rsquo;
+defines the minus sign glyph.  Finally, <var class="var">name</var> can be the
+unbreakable one-sixth and one-twelfth space escape sequences, <code class="code">\|</code>
+and <code class="code">\^</code> (&ldquo;thin&rdquo; and &ldquo;hair&rdquo; spaces, respectively), in which
+case only the width metric described below is interpreted; a font can
+thus customize the widths of these spaces.
+</p>
+<p>The form of the <var class="var">metrics</var> field is as follows.
+</p>
+<div class="display">
+<div class="group"><pre class="display-preformatted"><var class="var">width</var><code class="code">,</code><var class="var">height</var><code class="code">,</code><var class="var">depth</var><code class="code">,</code><var class="var">italic-correction</var>
+  <code class="code">,</code><var class="var">left-italic-correction</var><code class="code">,</code><var class="var">subscript-correction</var>
+</pre></div></div>
+
+<p>There must not be any spaces, tabs, or newlines between these
+<em class="dfn">subfields</em> (which have been split here into two lines only for
+better legibility).  The subfields are in basic units expressed as
+decimal integers.  Unspecified subfields default to&nbsp;<code class="code">0</code>.
+Since there is no associated binary format, these values are not
+required to fit into the C language data type &lsquo;<samp class="samp">char</samp>&rsquo; as they are in
+<abbr class="acronym">AT&amp;T</abbr> device-independent <code class="code">troff</code>.
+</p>
+<p>The <var class="var">width</var> subfield gives the width of the glyph.  The <var class="var">height</var>
+subfield gives the height of the glyph (upward is positive); if a glyph
+does not extend above the baseline, it should be given a zero height,
+rather than a negative height.  The <var class="var">depth</var> subfield gives the depth
+of the glyph, that is, the distance below the baseline to which the
+glyph extends (downward is positive); if a glyph does not extend below
+the baseline, it should be given a zero depth, rather than a negative
+depth.  Italic corrections are relevant to glyphs in italic or oblique
+styles.  The <var class="var">italic-correction</var> is the amount of space that should
+be added after an oblique glyph to be followed immediately by an upright
+glyph.  The <var class="var">left-italic-correction</var> is the amount of space that
+should be added before an oblique glyph to be preceded immediately by an
+upright glyph.  The <var class="var">subscript-correction</var> is the amount of space
+that should be added after an oblique glyph to be followed by a
+subscript; it should be less than the italic correction.
+</p>
+<p>For fonts used with typesetting devices, the <var class="var">type</var> field gives a
+featural description of the glyph: it is a bit mask recording whether
+the glyph is an ascender, descender, both, or neither.  When a <code class="code">\w</code>
+escape sequence is interpolated, these values are bitwise or-ed
+together for each glyph and stored in the <code class="code">nr</code> register.  In font
+descriptions for terminal devices, all glyphs might have a type of zero,
+regardless of their appearance.
+</p>
+<dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>means the glyph lies entirely between the baseline and a horizontal line
+at the &ldquo;x-height&rdquo; of the font; typical examples are &lsquo;<samp class="samp">a</samp>&rsquo;,
+&lsquo;<samp class="samp">c</samp>&rsquo;, and &lsquo;<samp class="samp">x</samp>&rsquo;;
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>means the glyph descends below the baseline, like &lsquo;<samp class="samp">p</samp>&rsquo;;
+</p>
+</dd>
+<dt><code class="code">2</code></dt>
+<dd><p>means the glyph ascends above the font&rsquo;s x-height, like &lsquo;<samp class="samp">A</samp>&rsquo; or
+&lsquo;<samp class="samp">b</samp>&rsquo;; and
+</p>
+</dd>
+<dt><code class="code">3</code></dt>
+<dd><p>means the glyph is both an ascender and a descender&mdash;this is true of
+parentheses in some fonts.
+</p></dd>
+</dl>
+
+<p>The <var class="var">code</var> field gives a numeric identifier that the postprocessor
+uses to render the glyph.  The glyph can be specified to <code class="code">troff</code>
+using this code by means of the <code class="code">\N</code> escape sequence.  <var class="var">code</var>
+can be any integer.<a class="footnote" id="DOCF129" href="groff.html_fot.html#FOOT129"><sup>129</sup></a>
+</p>
+<p>The <var class="var">entity-name</var> field defines an identifier for the glyph that the
+postprocessor uses to print the GNU <code class="code">troff</code> glyph <var class="var">name</var>.  This
+field is optional; it was introduced so that the <code class="code">grohtml</code> output
+driver could encode its character set.  For example, the glyph
+&lsquo;<samp class="samp">\Po</samp>&rsquo; is represented by &lsquo;<samp class="samp">&amp;pound;</samp>&rsquo; in <abbr class="acronym">HTML</abbr> 4.0.
+For efficiency, these data are now compiled directly into
+<code class="code">grohtml</code>.  <code class="code">grops</code> uses the field to build sub-encoding
+arrays for PostScript fonts containing more than 256 glyphs.  Anything
+on the line after the <var class="var">entity-name</var> field or &lsquo;<samp class="samp">--</samp>&rsquo; is ignored.
+</p>
+<p>A line in the <code class="code">charset</code> section can also have the form
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><var class="var">name</var> &quot;
+</pre></div></div>
+
+<p>identifying <var class="var">name</var> as another name for the glyph mentioned in the
+preceding line.  Such aliases can be chained.
+</p>
+<a class="index-entry-id" id="index-kernpairs"></a>
+<p>The directive <code class="code">kernpairs</code> starts a list of kerning adjustments to
+be made to adjacent glyph pairs from this font.  It contains a sequence
+of lines formatted as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><var class="var">g1</var> <var class="var">g2</var> <var class="var">n</var>
+</pre></div></div>
+
+<p>The foregoing means that when glyph <var class="var">g1</var> is typeset immediately
+before <var class="var">g2</var>, the space between them should be increased
+by&nbsp;<var class="var">n</var>.  Most kerning pairs should have a negative value
+for&nbsp;<var class="var">n</var>.
+</p>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>, Up: <a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Font-Directories.html Added

@@ -0,0 +1,113 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Font Directories (The GNU Troff Manual)</title>
+
+<meta name="description" content="Font Directories (The GNU Troff Manual)">
+<meta name="keywords" content="Font Directories (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Paper-Format.html" rel="next" title="Paper Format">
+<link href="Macro-Directories.html" rel="prev" title="Macro Directories">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Font-Directories">
+<div class="nav-panel">
+<p>
+Next: <a href="Paper-Format.html" accesskey="n" rel="next">Paper Format</a>, Previous: <a href="Macro-Directories.html" accesskey="p" rel="prev">Macro Directories</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Font-Directories-1">2.4 Font Directories</h3>
+<a class="index-entry-id" id="index-font-directories"></a>
+<a class="index-entry-id" id="index-directories-for-fonts"></a>
+<a class="index-entry-id" id="index-searching-fonts"></a>
+<a class="index-entry-id" id="index-fonts_002c-searching"></a>
+
+<p><code class="code">groff</code> enforces few restrictions on how font description files are
+named.  For its family/style mechanism to work (see <a class="pxref" href="Font-Families.html">Font Families</a>),
+the names of fonts within a family should start with the family name,
+followed by the style.  For example, the Times family uses &lsquo;<samp class="samp">T</samp>&rsquo; for
+the family name and &lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, &lsquo;<samp class="samp">I</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo; to
+indicate the styles &lsquo;roman&rsquo;, &lsquo;bold&rsquo;, &lsquo;italic&rsquo;, and &lsquo;bold italic&rsquo;,
+respectively.  Thus the final font names are &lsquo;<samp class="samp">TR</samp>&rsquo;, &lsquo;<samp class="samp">TB</samp>&rsquo;,
+&lsquo;<samp class="samp">TI</samp>&rsquo;, and &lsquo;<samp class="samp">TBI</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-font-path"></a>
+<a class="index-entry-id" id="index-path_002c-for-font-files"></a>
+<p>Font description files are kept in <em class="dfn">font directories</em>, which
+together constitute the <em class="dfn">font path</em>.  The search procedure
+always appends the directory <code class="code">dev</code><var class="var">name</var>, where <var class="var">name</var> is
+the name of the output device.  Assuming TeX DVI output, and
+<samp class="file">/foo/bar</samp> as a font directory, the font description files for
+<code class="command">grodvi</code> must be in <samp class="file">/foo/bar/devdvi</samp>.
+Each directory in the font path is searched in the following order until
+the desired font description file is found or the list is exhausted.
+</p>
+<ul class="itemize mark-bullet">
+<li>Directories specified with GNU <code class="code">troff</code>&rsquo;s or <code class="code">groff</code>&rsquo;s
+<samp class="option">-f</samp> command-line option.  All output drivers (and some
+preprocessors) support this option as well, because they require
+information about the glyphs to be rendered in the document.
+
+</li><li><a class="index-entry-id" id="index-GROFF_005fFONT_005fPATH_002c-environment-variable-1"></a>
+Directories listed in the <code class="env">GROFF_FONT_PATH</code> environment variable.
+
+</li><li><a class="index-entry-id" id="index-site_002dlocal-directory-1"></a>
+<a class="index-entry-id" id="index-directory_002c-site_002dlocal-1"></a>
+A site-local directory and the main font description directory.
+The locations corresponding to your installation are listed in section
+&ldquo;Environment&rdquo; of <cite class="cite">gtroff<span class="r">(1)</span></cite>.  If not otherwise configured,
+they are as follows.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">/usr/local/share/groff/site-font
+/usr/local/share/groff/1.23.0/font
+</pre></div></div>
+
+<p>The foregoing assumes that the version of <code class="code">groff</code> is 1.23.0, and
+that the installation prefix was <samp class="file">/usr/local</samp>.  It is possible to
+fine-tune these locations during the source configuration process.
+</p></li></ul>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Paper-Format.html">Paper Format</a>, Previous: <a href="Macro-Directories.html">Macro Directories</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Font-Families.html Added

@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Font Families (The GNU Troff Manual)</title>
+
+<meta name="description" content="Font Families (The GNU Troff Manual)">
+<meta name="keywords" content="Font Families (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Font-Positions.html" rel="next" title="Font Positions">
+<link href="Selecting-Fonts.html" rel="prev" title="Selecting Fonts">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Font-Families">
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Positions.html" accesskey="n" rel="next">Font Positions</a>, Previous: <a href="Selecting-Fonts.html" accesskey="p" rel="prev">Selecting Fonts</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Font-Families-1">5.19.2 Font Families</h4>
+<a class="index-entry-id" id="index-font-families"></a>
+<a class="index-entry-id" id="index-families_002c-font"></a>
+<a class="index-entry-id" id="index-font-styles"></a>
+<a class="index-entry-id" id="index-styles_002c-font"></a>
+
+<p>To accommodate the wide variety of fonts available, GNU <code class="code">troff</code>
+distinguishes <em class="dfn">font families</em> and <em class="dfn">font styles</em>.  A resolved
+font name is the catenation of a font family and a style.  Selecting an
+abstract style causes GNU <code class="code">troff</code> to combine it with the default
+font family.
+</p>
+<p>You can thus compose a document using abstract styles exclusively for
+its body or running text, selecting a specific family only for titles or
+examples, for instance, and change the default family on the command
+line (recall <a class="ref" href="Groff-Options.html">Options</a>).
+</p>
+<p>Fonts for the devices <code class="code">ps</code>, <code class="code">pdf</code>, <code class="code">dvi</code>, <code class="code">lj4</code>,
+<code class="code">lbp</code>, and the X11 devices support this mechanism.  By default,
+GNU <code class="code">troff</code> uses the Times family with the four styles &lsquo;<samp class="samp">R</samp>&rsquo;,
+&lsquo;<samp class="samp">I</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efam"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fam</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">family</i></span></var><a class="copiable-link" href='#index-_002efam'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fam"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efam_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fam</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efam_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efam-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cFf"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F</code><span class="r"><i class="slanted">f</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cFf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cF"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cF_0028fm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F(</code><span class="r"><i class="slanted">fm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cF_0028fm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cF_005bfamily_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\F</code><span class="r"><i class="slanted">family</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cF_005bfamily_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-changing-font-family-_0028fam_002c-_005cF_0029"></a>
+<a class="index-entry-id" id="index-font-family_002c-changing-_0028fam_002c-_005cF_0029"></a>
+<p>Set the default font family, used in combination with abstract styles to
+construct a resolved font name, to <var class="var">family</var> (one-character
+name&nbsp;<var class="var">f</var>, two-character name <var class="var">fm</var>).  If no argument is
+given, GNU <code class="code">troff</code> selects the previous font family; if there none,
+is it falls back to the device&rsquo;s default<a class="footnote" id="DOCF76" href="groff.html_fot.html#FOOT76"><sup>76</sup></a> or its own (&lsquo;<samp class="samp">T</samp>&rsquo;).
+</p>
+<p>The <code class="code">\F</code> escape sequence works similarly.  In disanalogy to
+<code class="code">\f</code>, &lsquo;<samp class="samp">\FP</samp>&rsquo; makes &lsquo;<samp class="samp">P</samp>&rsquo; the default family.  Use
+&lsquo;<samp class="samp">\F</samp>&rsquo; to select the previous default family.  The default font
+family is available in the read-only string-valued register <code class="code">.fam</code>;
+it is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">spam,     \&quot; startup defaults are T (Times) R (roman)
+.fam H    \&quot; make Helvetica the default family
+spam,     \&quot; family H + style R = HR
+.ft B     \&quot; family H + style B = HB
+spam,
+.ft CR    \&quot; Courier roman (default family not changed)
+spam,
+.ft       \&quot; back to Helvetica bold
+spam,
+.fam T    \&quot; make Times the default family
+spam,     \&quot; family T + style B = TB
+.ft AR    \&quot; font AR (not a style)
+baked beans,
+.ft R     \&quot; family T + style R = TR
+and spam.
+</pre></div></div>
+
+<p><code class="code">\F</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>.  As a
+consequence, it can be used in requests like <code class="code">mc</code> (which expects
+a single character as an argument) to change the font family on the fly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \FPx\F
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esty"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sty</code></strong> <var class="def-var-arguments">n style</var><a class="copiable-link" href='#index-_002esty'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sty"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esty_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sty</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esty_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esty-1"></a>
+<a class="index-entry-id" id="index-setting-up-an-abstract-font-style-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-abstract-font-style_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-font-style_002c-abstract_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-style_002c-font_002c-abstract_002c-setting-up-_0028sty_0029"></a>
+<a class="index-entry-id" id="index-cs-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-bd-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-uf-request_002c-and-font-styles"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-font-styles"></a>
+<p>Associate an abstract style <var class="var">style</var> with mounting
+position&nbsp;<var class="var">n</var>, which must be a non-negative integer.  If the
+requests <code class="code">cs</code>, <code class="code">bd</code>, <code class="code">tkf</code>, <code class="code">uf</code>, or <code class="code">fspecial</code>
+are applied to an abstract style, they are instead applied to the member
+of the current family corresponding to that style.
+</p>
+<a class="index-entry-id" id="index-DESC-1"></a>
+<a class="index-entry-id" id="index-styles-1"></a>
+<p>The default family can be set with the <samp class="option">-f</samp> option (see <a class="pxref" href="Groff-Options.html">Options</a>).  The <code class="code">styles</code> command in the <samp class="file">DESC</samp> file controls
+which font positions (if any) are initially associated with abstract
+styles rather than fonts.
+</p>
+<p><strong class="strong">Caution:</strong> The <var class="var">style</var> argument is not validated.
+Errors may occur later, when the formatter attempts to construct a
+resolved font name, or format a character for output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr BarPos \n.fp
+.sty \n.fp Bar
+.fam Foo
+.ft \nBarPos
+.tm .f=\n.f
+A
+    error&rarr; error: no font family named 'Foo' exists
+    error&rarr; .f=41
+    error&rarr; error: cannot format glyph: no current font
+</pre></div></div>
+
+<p>When an abstract style has been selected, the read-only string-valued
+register &lsquo;<samp class="samp">.sty</samp>&rsquo; interpolates its name; this datum is associated
+with the environment (see <a class="pxref" href="Environments.html">Environments</a>).  Otherwise, &lsquo;<samp class="samp">.sty</samp>&rsquo;
+interpolates nothing.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Positions.html">Font Positions</a>, Previous: <a href="Selecting-Fonts.html">Selecting Fonts</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Font-Positions.html Added

@@ -0,0 +1,138 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Font Positions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Font Positions (The GNU Troff Manual)">
+<meta name="keywords" content="Font Positions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Using-Symbols.html" rel="next" title="Using Symbols">
+<link href="Font-Families.html" rel="prev" title="Font Families">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Font-Positions">
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Symbols.html" accesskey="n" rel="next">Using Symbols</a>, Previous: <a href="Font-Families.html" accesskey="p" rel="prev">Font Families</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Font-Positions-1">5.19.3 Font Positions</h4>
+<a class="index-entry-id" id="index-font-positions"></a>
+<a class="index-entry-id" id="index-positions_002c-font"></a>
+
+<p>To support typeface indirection through abstract styles, and for
+compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, the formatter maintains
+a list of font <em class="dfn">positions</em> at which fonts required by a document are
+<em class="dfn">mounted</em>.  An output device&rsquo;s description file <samp class="file">DESC</samp>
+typically configures a set of pre-mounted fonts; see <a class="ref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.  A font need not be explicitly mounted before
+it is selected; GNU <code class="code">troff</code> will search <code class="env">GROFF_FONT_PATH</code> for
+it by name and mount it at the first free mounting position on demand.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fp</code></strong> <var class="def-var-arguments">pos id <span class="r"><i class="slanted">font-description-file-name</i></span></var><a class="copiable-link" href='#index-_002efp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ef_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.f</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ef_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ef"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fp</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efp-1"></a>
+<a class="index-entry-id" id="index-mounting-a-font-_0028fp_0029"></a>
+<a class="index-entry-id" id="index-font_002c-mounting-_0028fp_0029"></a>
+<p>Mount a font under the name <var class="var">id</var> at mounting position <var class="var">pos</var>, a
+non-negative integer.  When the formatter starts up, it reads the output
+device&rsquo;s description to mount an initial set of faces, and selects font
+position&nbsp;1.  Position&nbsp;0 is unused by default.  Unless the
+<var class="var">font-description-file-name</var> argument is given, <var class="var">id</var> should be
+the name of a font description file stored in a directory corresponding
+to the selected output device.  GNU <code class="code">troff</code> does not traverse
+directories to locate the font description file.
+</p>
+<a class="index-entry-id" id="index-font-aliasing-with-third-argument-to-fp-request"></a>
+<a class="index-entry-id" id="index-aliasing-fonts-with-third-argument-to-fp-request"></a>
+<p>The optional third argument enables font names to be aliased, which can
+be necessary in compatibility mode since AT&amp;T <code class="code">troff</code> syntax
+affords no means of identifying fonts with names longer than two
+characters, like &lsquo;<samp class="samp">TBI</samp>&rsquo; or &lsquo;<samp class="samp">ZCMI</samp>&rsquo;, in a font selection escape
+sequence.  See <a class="xref" href="Compatibility-Mode.html">Compatibility Mode</a>.  You can also alias fonts on
+mounting for convenience or abstraction.  (See below regarding the
+<code class="code">.fp</code> register.)
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fp \n.fp SC ZCMI
+Send a \f(SChand-written\fP thank-you note.
+.fp \n.fp Emph TI
+.fp \n.fp Strong TB
+Are \fEmphthese names\f \fStrongcomfortable\f?
+</pre></div></div>
+
+<p>&lsquo;<samp class="samp">DESC</samp>&rsquo;, &lsquo;<samp class="samp">P</samp>&rsquo;, and non-negative integers are not usable as font
+identifiers.
+</p>
+<a class="index-entry-id" id="index-font-position-register-_0028_002ef_0029"></a>
+<p>The position of the currently selected font (or abstract style) is
+available in the read-only register &lsquo;<samp class="samp">.f</samp>&rsquo;.  It is associated with
+the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>You can copy the value of <code class="code">.f</code> to another register to save it for
+later use.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr saved-font \n.f
+<span class="r">&hellip; <i class="i">text involving many font changes</i> &hellip;</span>
+.ft \nsaved-font
+</pre></div></div>
+
+<a class="index-entry-id" id="index-next-free-font-position-register-_0028_002efp_0029"></a>
+<p>The index of the next (non-zero) free font position is available in the
+read-only register &lsquo;<samp class="samp">.fp</samp>&rsquo;.
+<a class="index-entry-id" id="index-DESC-file_002c-and-font-mounting"></a>
+Fonts not listed in the <samp class="file">DESC</samp> file are automatically mounted at
+position &lsquo;<samp class="samp">\n.fp</samp>&rsquo; when selected with the <code class="code">ft</code> request or
+<code class="code">\f</code> escape sequence.  When mounting a font at a position
+explicitly with the <code class="code">fp</code> request, this same practice should be
+followed, although GNU <code class="code">troff</code> does not enforce this strictly.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Symbols.html">Using Symbols</a>, Previous: <a href="Font-Families.html">Font Families</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Font-and-Size-Changes.html Added

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Font and Size Changes (The GNU Troff Manual)</title>
+
+<meta name="description" content="Font and Size Changes (The GNU Troff Manual)">
+<meta name="keywords" content="Font and Size Changes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Predefined-Text.html" rel="next" title="Predefined Text">
+<link href="Columnation.html" rel="prev" title="Columnation">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Font-and-Size-Changes">
+<div class="nav-panel">
+<p>
+Next: <a href="Predefined-Text.html" accesskey="n" rel="next">Predefined Text</a>, Previous: <a href="Columnation.html" accesskey="p" rel="prev">Columnation</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Font-and-Size-Changes-1">3.2.11 Font and Size Changes</h4>
+
+<p>The formatter&rsquo;s requests and escape sequences for setting the typeface
+and size are not always intuitive, so all macro packages provide macros
+to make these operations simpler.  They also make it more convenient to
+change typefaces in the middle of a word and can handle italic
+corrections automatically.  See <a class="xref" href="Italic-Corrections.html">Italic Corrections</a>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Footnotes-and-Endnotes.html Added

@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Footnotes and Endnotes (The GNU Troff Manual)</title>
+
+<meta name="description" content="Footnotes and Endnotes (The GNU Troff Manual)">
+<meta name="keywords" content="Footnotes and Endnotes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Table-of-Contents.html" rel="next" title="Table of Contents">
+<link href="Displays-and-Keeps.html" rel="prev" title="Displays and Keeps">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Footnotes-and-Endnotes">
+<div class="nav-panel">
+<p>
+Next: <a href="Table-of-Contents.html" accesskey="n" rel="next">Table of Contents</a>, Previous: <a href="Displays-and-Keeps.html" accesskey="p" rel="prev">Displays and Keeps</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Footnotes-and-Endnotes-1">3.2.6 Footnotes and Endnotes</h4>
+<a class="index-entry-id" id="index-footnotes"></a>
+<a class="index-entry-id" id="index-endnotes"></a>
+
+<p><i class="slanted">Footnotes</i> and <i class="slanted">endnotes</i> are forms of delayed
+formatting.  They are recorded at their points of relevance in
+the input, but not formatted there.  Instead, a <i class="slanted">mark</i> cues the
+reader to check the &ldquo;foot&rdquo;, or bottom, of the current page, or in the
+case of endnotes, an annotation list later in the document.  Macro
+packages that support these features also supply a means of
+automatically numbering either type of annotation.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Formatter-Instructions.html Added

@@ -0,0 +1,83 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Formatter Instructions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Formatter Instructions (The GNU Troff Manual)">
+<meta name="keywords" content="Formatter Instructions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Registers.html" rel="next" title="Registers">
+<link href="Identifiers.html" rel="prev" title="Identifiers">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Formatter-Instructions">
+<div class="nav-panel">
+<p>
+Next: <a href="Registers.html" accesskey="n" rel="next">Registers</a>, Previous: <a href="Identifiers.html" accesskey="p" rel="prev">Identifiers</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Formatter-Instructions-1">5.6 Formatter Instructions</h3>
+<a class="index-entry-id" id="index-formatter-instructions"></a>
+<a class="index-entry-id" id="index-instructing-the-formatter"></a>
+
+<p>To support documents that require more than filling, automatic line
+breaking and hyphenation, adjustment, and supplemental inter-sentence
+space, the <code class="code">roff</code> language offers two means of embedding
+instructions to the formatter.
+</p>
+<a class="index-entry-id" id="index-request-1"></a>
+<p>One is a <em class="dfn">request</em>, which begins with a control character and takes
+up the remainder of the input line.  Requests often perform relatively
+large-scale operations such as setting the page length, breaking the
+line, or starting a new page.  They also conduct internal operations
+like defining macros.
+</p>
+<a class="index-entry-id" id="index-escape-sequence"></a>
+<a class="index-entry-id" id="index-sequence_002c-escape"></a>
+<p>The other is an <em class="dfn">escape sequence</em>, which begins with the escape
+character and can be embedded anywhere in the input, even in arguments
+to requests and other escape sequences.  Escape sequences interpolate
+special characters, strings, or registers, and handle comparatively
+minor formatting tasks like sub- and superscripting.
+</p>
+<p>Some operations, such as font selection and type size alteration, are
+available via both requests and escape sequences.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Control-Characters.html" accesskey="1">Control Characters</a></li>
+<li><a href="Invoking-Requests.html" accesskey="2">Invoking Requests</a></li>
+<li><a href="Calling-Macros.html" accesskey="3">Calling Macros</a></li>
+<li><a href="Using-Escape-Sequences.html" accesskey="4">Using Escape Sequences</a></li>
+<li><a href="Delimiters.html" accesskey="5">Delimiters</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/GNU-troff-Reference.html Added

@@ -0,0 +1,99 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>GNU troff Reference (The GNU Troff Manual)</title>
+
+<meta name="description" content="GNU troff Reference (The GNU Troff Manual)">
+<meta name="keywords" content="GNU troff Reference (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="File-Formats.html" rel="next" title="File Formats">
+<link href="Major-Macro-Packages.html" rel="prev" title="Major Macro Packages">
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="GNU-troff-Reference">
+<div class="nav-panel">
+<p>
+Next: <a href="File-Formats.html" accesskey="n" rel="next">File Formats</a>, Previous: <a href="Major-Macro-Packages.html" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="GNU-troff-Reference-1">5 GNU <code class="code">troff</code> Reference</h2>
+<a class="index-entry-id" id="index-reference_002c-gtroff"></a>
+<a class="index-entry-id" id="index-gtroff_002c-reference"></a>
+
+<p>This chapter covers <em class="emph">all</em> of the facilities of the GNU
+<code class="code">troff</code> formatting engine.  Users of macro packages may skip it if
+not interested in details.
+</p>
+
+
+
+
+<ul class="mini-toc">
+<li><a href="Text.html" accesskey="1">Text</a></li>
+<li><a href="Page-Geometry.html" accesskey="2">Page Geometry</a></li>
+<li><a href="Measurements.html" accesskey="3">Measurements</a></li>
+<li><a href="Numeric-Expressions.html" accesskey="4">Numeric Expressions</a></li>
+<li><a href="Identifiers.html" accesskey="5">Identifiers</a></li>
+<li><a href="Formatter-Instructions.html" accesskey="6">Formatter Instructions</a></li>
+<li><a href="Comments.html" accesskey="7">Comments</a></li>
+<li><a href="Registers.html" accesskey="8">Registers</a></li>
+<li><a href="Manipulating-Filling-and-Adjustment.html" accesskey="9">Manipulating Filling and Adjustment</a></li>
+<li><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></li>
+<li><a href="Manipulating-Spacing.html">Manipulating Spacing</a></li>
+<li><a href="Tabs-and-Fields.html">Tabs and Fields</a></li>
+<li><a href="Character-Translations.html">Character Translations</a></li>
+<li><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></li>
+<li><a href="Line-Layout.html">Line Layout</a></li>
+<li><a href="Line-Continuation.html">Line Continuation</a></li>
+<li><a href="Page-Layout.html">Page Layout</a></li>
+<li><a href="Page-Control.html">Page Control</a></li>
+<li><a href="Using-Fonts.html">Using Fonts</a></li>
+<li><a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a></li>
+<li><a href="Colors.html">Colors</a></li>
+<li><a href="Strings.html">Strings</a></li>
+<li><a href="Conditionals-and-Loops.html">Conditionals and Loops</a></li>
+<li><a href="Writing-Macros.html">Writing Macros</a></li>
+<li><a href="Page-Motions.html">Page Motions</a></li>
+<li><a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></li>
+<li><a href="Deferring-Output.html">Deferring Output</a></li>
+<li><a href="Traps.html">Traps</a></li>
+<li><a href="Diversions.html">Diversions</a></li>
+<li><a href="Punning-Names.html">Punning Names</a></li>
+<li><a href="Environments.html">Environments</a></li>
+<li><a href="Suppressing-Output.html">Suppressing Output</a></li>
+<li><a href="I_002fO.html">I/O</a></li>
+<li><a href="Postprocessor-Access.html">Postprocessor Access</a></li>
+<li><a href="Miscellaneous.html">Miscellaneous</a></li>
+<li><a href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a></li>
+<li><a href="Debugging.html">Debugging</a></li>
+<li><a href="Implementation-Differences.html">Implementation Differences</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Graphics-Commands.html Added

@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Graphics Commands (The GNU Troff Manual)</title>
+
+<meta name="description" content="Graphics Commands (The GNU Troff Manual)">
+<meta name="keywords" content="Graphics Commands (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Command-Reference.html" rel="up" title="Command Reference">
+<link href="Device-Control-Commands.html" rel="next" title="Device Control Commands">
+<link href="Simple-Commands.html" rel="prev" title="Simple Commands">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Graphics-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="Device-Control-Commands.html" accesskey="n" rel="next">Device Control Commands</a>, Previous: <a href="Simple-Commands.html" accesskey="p" rel="prev">Simple Commands</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Graphics-Commands-1">6.1.2.3 Graphics Commands</h4>
+
+<p>Each graphics or drawing command in the intermediate output starts with
+the letter &lsquo;<samp class="samp">D</samp>&rsquo;, followed by one or two characters that specify a
+subcommand; this is followed by a fixed or variable number of integer
+arguments that are separated by a single space character.  A &lsquo;<samp class="samp">D</samp>&rsquo;
+command may not be followed by another command on the same line (apart
+from a comment), so each &lsquo;<samp class="samp">D</samp>&rsquo; command is terminated by a syntactical
+line break.
+</p>
+<p><code class="code">gtroff</code> output follows the classical spacing rules (no space
+between command and subcommand, all arguments are preceded by a single
+space character), but the parser allows optional space between the
+command letters and makes the space before the first argument optional.
+As usual, each space can be any sequence of tab and space characters.
+</p>
+<p>Some graphics commands can take a variable number of arguments.  In this
+case, they are integers representing a size measured in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;.  The arguments called <var class="var">h1</var>, <var class="var">h2</var>, &hellip;, <var class="var">hn</var>
+stand for horizontal distances where positive means right, negative
+left.  The arguments called <var class="var">v1</var>, <var class="var">v2</var>, &hellip;, <var class="var">vn</var> stand
+for vertical distances where positive means down, negative up.  All
+these distances are offsets relative to the current location.
+</p>
+<p>Each graphics command directly corresponds to a similar <code class="code">gtroff</code>
+<code class="code">\D</code> escape sequence.  See <a class="xref" href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>.
+</p>
+<p>Unknown &lsquo;<samp class="samp">D</samp>&rsquo; commands are assumed to be device-specific.  Its
+arguments are parsed as strings; the whole information is then sent to
+the postprocessor.
+</p>
+<p>In the following command reference, the syntax element &lsaquo;<span class="r">line
+break</span>&rsaquo; means a syntactical line break as defined above.
+</p>
+<dl class="table">
+<dt><code class="code">D~ <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw B-spline from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>), then
+to offset (<var class="var">h2</var>,<var class="var">v2</var>), if given, etc., up to
+(<var class="var">hn</var>,<var class="var">vn</var>).  This command takes a variable number of argument
+pairs; the current position is moved to the terminal point of the drawn
+curve.
+</p>
+</dd>
+<dt><code class="code">Da <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw arc from current position to
+(<var class="var">h1</var>,<var class="var">v1</var>)<em class="math">+</em>(<var class="var">h2</var>,<var class="var">v2</var>) with center at
+(<var class="var">h1</var>,<var class="var">v1</var>); then move the current position to the final point
+of the arc.
+</p>
+</dd>
+<dt><code class="code">DC <var class="var">d</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dt><code class="code">DC <var class="var">d</var> <var class="var">dummy-arg</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid circle using the current fill color with
+diameter&nbsp;<var class="var">d</var> (integer in basic units &lsquo;<samp class="samp">u</samp>&rsquo;) with leftmost
+point at the current position; then move the current position to the
+rightmost point of the circle.  An optional second integer argument is
+ignored (this allows the formatter to generate an even number of
+arguments).  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dc <var class="var">d</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw circle line with diameter&nbsp;<var class="var">d</var> (integer in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;) with leftmost point at the current position; then move the
+current position to the rightmost point of the circle.
+</p>
+</dd>
+<dt><code class="code">DE <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid ellipse in the current fill color with a horizontal
+diameter of&nbsp;<var class="var">h</var> and a vertical diameter of&nbsp;<var class="var">v</var> (both
+integers in basic units &lsquo;<samp class="samp">u</samp>&rsquo;) with the leftmost point at the current
+position; then move to the rightmost point of the ellipse.  This command
+is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">De <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw an outlined ellipse with a horizontal diameter of&nbsp;<var class="var">h</var> and
+a vertical diameter of&nbsp;<var class="var">v</var> (both integers in basic units
+&lsquo;<samp class="samp">u</samp>&rsquo;) with the leftmost point at current position; then move to the
+rightmost point of the ellipse.
+</p>
+</dd>
+<dt><code class="code">DF <var class="var">color-scheme</var> <span class="r"></span><var class="var">component</var> &hellip;<span class="r"></span>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using different color schemes;
+the analogous command for setting the color of text, line graphics, and
+the outline of graphic objects is &lsquo;<samp class="samp">m</samp>&rsquo;.  The color components are
+specified as integer arguments between 0 and 65535.  The number of color
+components and their meaning vary for the different color schemes.
+These commands are generated by <code class="code">gtroff</code>&rsquo;s escape sequences
+&lsquo;<samp class="samp">\D'F &hellip;'</samp>&rsquo; and <code class="code">\M</code> (with no other corresponding
+graphics commands).  No position changing.  This command is a
+<code class="code">gtroff</code> extension.
+</p>
+<dl class="table">
+<dt><code class="code">DFc <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the CMY color scheme,
+having the 3&nbsp;color components <var class="var">cyan</var>, <var class="var">magenta</var>, and
+<var class="var">yellow</var>.
+</p>
+</dd>
+<dt><code class="code">DFd&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects to the default fill color value
+(black in most cases).  No component arguments.
+</p>
+</dd>
+<dt><code class="code">DFg <var class="var">gray</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects to the shade of gray given by
+the argument, an integer between 0 (black) and 65535 (white).
+</p>
+</dd>
+<dt><code class="code">DFk <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var> <var class="var">black</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the CMYK color scheme,
+having the 4&nbsp;color components <var class="var">cyan</var>, <var class="var">magenta</var>,
+<var class="var">yellow</var>, and <var class="var">black</var>.
+</p>
+</dd>
+<dt><code class="code">DFr <var class="var">red</var> <var class="var">green</var> <var class="var">blue</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set fill color for solid drawing objects using the RGB color scheme,
+having the 3&nbsp;color components <var class="var">red</var>, <var class="var">green</var>, and
+<var class="var">blue</var>.
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">Df <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>The argument&nbsp;<var class="var">n</var> must be an integer in the range <em class="math">-32767</em>
+to 32767.
+</p>
+<dl class="table">
+<dt><em class="math">0 &le; <var class="var">n</var> &le; 1000</em></dt>
+<dd><p>Set the color for filling solid drawing objects to a shade of gray,
+where 0 corresponds to solid white, 1000 (the default) to solid black,
+and values in between to intermediate shades of gray; this is obsoleted
+by command &lsquo;<samp class="samp">DFg</samp>&rsquo;.
+</p>
+</dd>
+<dt><em class="math"><var class="var">n</var> &lt; 0</em> or <em class="math"><var class="var">n</var> &gt; 1000</em></dt>
+<dd><p>Set the filling color to the color that is currently being used for the
+text and the outline, see command &lsquo;<samp class="samp">m</samp>&rsquo;.  For example, the command
+sequence
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">mg 0 0 65535
+Df -1
+</pre></div></div>
+
+<p>sets all colors to blue.
+</p></dd>
+</dl>
+
+<p>No position changing.  This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dl <var class="var">h</var> <var class="var">v</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw line from current position to offset (<var class="var">h</var>,<var class="var">v</var>) (integers in
+basic units &lsquo;<samp class="samp">u</samp>&rsquo;); then set current position to the end of the drawn
+line.
+</p>
+</dd>
+<dt><code class="code">Dp <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a polygon line from current position to offset (<var class="var">h1</var>,<var class="var">v1</var>),
+from there to offset (<var class="var">h2</var>,<var class="var">v2</var>), etc., up to offset
+(<var class="var">hn</var>,<var class="var">vn</var>), and from there back to the starting position.  For
+historical reasons, the position is changed by adding the sum of all
+arguments with odd index to the actual horizontal position and the even
+ones to the vertical position.  Although this doesn&rsquo;t make sense it is
+kept for compatibility.
+This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">DP <var class="var">h1</var> <var class="var">v1</var> <var class="var">h2</var> <var class="var">v2</var> &hellip; <var class="var">hn</var> <var class="var">vn</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Draw a solid polygon in the current fill color rather than an outlined
+polygon, using the same arguments and positioning as the corresponding
+&lsquo;<samp class="samp">Dp</samp>&rsquo; command.
+This command is a <code class="code">gtroff</code> extension.
+</p>
+</dd>
+<dt><code class="code">Dt <var class="var">n</var>&lsaquo;<span class="r">line break</span>&rsaquo;</code></dt>
+<dd><p>Set the current line thickness to&nbsp;<var class="var">n</var> (an integer in basic
+units &lsquo;<samp class="samp">u</samp>&rsquo;) if <em class="math"><var class="var">n</var>&gt;0</em>; if <em class="math"><var class="var">n</var>=0</em> select the
+smallest available line thickness; if <em class="math"><var class="var">n</var>&lt;0</em> set the line
+thickness proportional to the type size (this is the default before the
+first &lsquo;<samp class="samp">Dt</samp>&rsquo; command was specified).  For historical reasons, the
+horizontal position is changed by adding the argument to the actual
+horizontal position, while the vertical position is not changed.
+Although this doesn&rsquo;t make sense it is kept for compatibility.
+This command is a <code class="code">gtroff</code> extension.
+</p></dd>
+</dl>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Device-Control-Commands.html">Device Control Commands</a>, Previous: <a href="Simple-Commands.html">Simple Commands</a>, Up: <a href="Command-Reference.html">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Groff-Options.html Added

@@ -0,0 +1,536 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Groff Options (The GNU Troff Manual)</title>
+
+<meta name="description" content="Groff Options (The GNU Troff Manual)">
+<meta name="keywords" content="Groff Options (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Environment.html" rel="next" title="Environment">
+<link href="Invoking-groff.html" rel="prev" title="Invoking groff">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Groff-Options">
+<div class="nav-panel">
+<p>
+Next: <a href="Environment.html" accesskey="n" rel="next">Environment</a>, Previous: <a href="Invoking-groff.html" accesskey="p" rel="prev">Invoking <code class="code">groff</code></a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Options">2.1 Options</h3>
+<a class="index-entry-id" id="index-options"></a>
+
+<a class="index-entry-id" id="index-groff"></a>
+<a class="index-entry-id" id="index-gtroff"></a>
+<a class="index-entry-id" id="index-gpic"></a>
+<a class="index-entry-id" id="index-geqn"></a>
+<a class="index-entry-id" id="index-ggrn"></a>
+<a class="index-entry-id" id="index-grap"></a>
+<a class="index-entry-id" id="index-gtbl"></a>
+<a class="index-entry-id" id="index-gchem"></a>
+<a class="index-entry-id" id="index-grefer"></a>
+<a class="index-entry-id" id="index-gsoelim"></a>
+<a class="index-entry-id" id="index-preconv"></a>
+<p><code class="code">groff</code> normally runs the <code class="code">gtroff</code> program and a
+postprocessor appropriate for the selected device.  The default device
+is &lsquo;<samp class="samp">ps</samp>&rsquo; (but it can be changed when <code class="code">groff</code> is configured and
+built).  It can optionally preprocess with any of <code class="code">gpic</code>,
+<code class="code">geqn</code>, <code class="code">gtbl</code>, <code class="code">ggrn</code>, <code class="code">grap</code>, <code class="code">gchem</code>,
+<code class="code">grefer</code>, <code class="code">gsoelim</code>, or <code class="code">preconv</code>.
+</p>
+<p>This section documents only options to the <code class="code">groff</code> front end.  Many
+of the arguments to <code class="code">groff</code> are passed on to <code class="code">gtroff</code>;
+therefore, those are also included.  Arguments to preprocessors and
+output drivers can be found in the man pages <cite class="cite">gpic<span class="r">(1)</span></cite>,
+<cite class="cite">geqn<span class="r">(1)</span></cite>, <cite class="cite">gtbl<span class="r">(1)</span></cite>, <cite class="cite">ggrn<span class="r">(1)</span></cite>,
+<cite class="cite">grefer<span class="r">(1)</span></cite>, <cite class="cite">gchem<span class="r">(1)</span></cite>, <cite class="cite">gsoelim<span class="r">(1)</span></cite>,
+<cite class="cite">preconv<span class="r">(1)</span></cite>, <cite class="cite">grotty<span class="r">(1)</span></cite>, <cite class="cite">grops<span class="r">(1)</span></cite>,
+<cite class="cite">gropdf<span class="r">(1)</span></cite>, <cite class="cite">grohtml<span class="r">(1)</span></cite>, <cite class="cite">grodvi<span class="r">(1)</span></cite>,
+<cite class="cite">grolj4<span class="r">(1)</span></cite>, <cite class="cite">grolbp<span class="r">(1)</span></cite>, and <cite class="cite">gxditview<span class="r">(1)</span></cite>.
+</p>
+<p>The command-line format for <code class="code">groff</code> is:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff  -abceghijklpstvzCEGNRSUVXZ   -d<var class="var">cs</var>   -D<var class="var">arg</var> 
+       -f<var class="var">fam</var>   -F<var class="var">dir</var>   -I<var class="var">dir</var>   -K<var class="var">arg</var> 
+       -L<var class="var">arg</var>   -m<var class="var">name</var>   -M<var class="var">dir</var>   -n<var class="var">num</var> 
+       -o<var class="var">list</var>   -P<var class="var">arg</var>   -r<var class="var">cn</var>   -T<var class="var">dev</var> 
+       -w<var class="var">name</var>   -W<var class="var">name</var>   <var class="var">files</var>&hellip; 
+</pre></div></div>
+
+<p>The command-line format for <code class="code">gtroff</code> is as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">gtroff  -abcivzCERU   -d<var class="var">cs</var>   -f<var class="var">fam</var>   -F<var class="var">dir</var> 
+        -m<var class="var">name</var>   -M<var class="var">dir</var>   -n<var class="var">num</var>   -o<var class="var">list</var> 
+        -r<var class="var">cn</var>   -T<var class="var">name</var>   -w<var class="var">name</var>   -W<var class="var">name</var> 
+        <var class="var">files</var>&hellip; 
+</pre></div></div>
+
+<p>Obviously, many of the options to <code class="code">groff</code> are actually passed on to
+<code class="code">gtroff</code>.
+</p>
+<p>Options without an argument can be grouped behind a
+single&nbsp;<samp class="option">-</samp>.  A filename of&nbsp;<samp class="file">-</samp> denotes the
+standard input.  Whitespace is permitted between an option and its
+argument.
+</p>
+<p>The <code class="code">grog</code> command can be used to guess the correct <code class="code">groff</code>
+command to format a file.  See its man page <cite class="cite">grog<span class="r">(1)</span></cite>; type
+&lsquo;<samp class="samp">man grog</samp>&rsquo; at the command line to view it.
+</p>
+<p><code class="command">groff</code>&rsquo;s command-line options are as follows.
+</p>
+<a class="index-entry-id" id="index-command_002dline-options"></a>
+<dl class="table">
+<dt id='index-plain-text-approximation-output-register-_0028_002eA_0029'><span>&lsquo;<samp class="samp">-a</samp>&rsquo;<a class="copiable-link" href='#index-plain-text-approximation-output-register-_0028_002eA_0029'> &para;</a></span></dt>
+<dd><p>Generate a plain text approximation of the typeset output.  The
+read-only register <code class="code">.A</code> is set to&nbsp;1.  See <a class="xref" href="Built_002din-Registers.html">Built-in Registers</a>.  This option produces a sort of abstract preview of the
+formatted output.
+</p>
+<ul class="itemize mark-bullet">
+<li>Page breaks are marked by a phrase in angle brackets; for example,
+&lsquo;<samp class="samp">&lt;beginning of page&gt;</samp>&rsquo;.
+
+</li><li>Lines are broken where they would be in the formatted output.
+
+</li><li>A horizontal motion of any size is represented as one space.  Adjacent
+horizontal motions are not combined.  Inter-sentence space nodes (those
+arising from the second argument to the <code class="code">ss</code> request) are not
+represented.
+
+</li><li>Vertical motions are not represented.
+
+</li><li>Special characters are rendered in angle brackets; for example, the
+default soft hyphen character appears as &lsquo;<samp class="samp">&lt;hy&gt;</samp>&rsquo;.
+</li></ul>
+
+<p>The above description should not be considered a specification; the
+details of <samp class="option">-a</samp> output are subject to change.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-b</samp>&rsquo;</dt>
+<dd><p>Write a backtrace reporting the state of <code class="command">gtroff</code>&rsquo;s input parser
+to the standard error stream with each diagnostic message.  The line
+numbers given in the backtrace might not always be correct, because
+<code class="command">gtroff</code>&rsquo;s idea of line numbers can be confused by requests that
+append to
+macros.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-c</samp>&rsquo;</dt>
+<dd><p>Start with color output disabled.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-C</samp>&rsquo;</dt>
+<dd><p>Enable AT&amp;T <code class="command">troff</code> compatibility mode; implies <samp class="option">-c</samp>.
+See <a class="xref" href="Implementation-Differences.html">Implementation Differences</a>, for the list of incompatibilities
+between <code class="command">groff</code> and <abbr class="acronym">AT&amp;T</abbr> <code class="command">troff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-d<var class="var">c</var><var class="var">text</var></samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">-d<var class="var">string</var>=<var class="var">text</var></samp>&rsquo;</dt>
+<dd><p>Define <code class="code">roff</code> string <var class="var">c</var> or <var class="var">string</var> as&nbsp;<var class="var">t</var> or
+<var class="var">text</var>.  <var class="var">c</var>&nbsp;must be one character; <var class="var">string</var> can be
+of arbitrary length.  Such string assignments happen before any macro
+file is loaded, including the startup file.  Due to <code class="code">getopt_long</code>
+limitations, <var class="var">c</var>&nbsp;cannot be, and <var class="var">string</var> cannot contain, an
+equals sign, even though that is a valid character in a <code class="code">roff</code>
+identifier.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-D<var class="var">enc</var></samp>&rsquo;</dt>
+<dd><p>Set fallback input encoding used by <code class="command">preconv</code> to <var class="var">enc</var>;
+implies <samp class="option">-k</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-e</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">geqn</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-E</samp>&rsquo;</dt>
+<dd><p>Inhibit <code class="command">gtroff</code> error messages.  This option does <em class="emph">not</em>
+suppress messages sent to the standard error stream by documents or
+macro packages using <code class="code">tm</code> or related requests.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-f<var class="var">fam</var></samp>&rsquo;</dt>
+<dd><p>Use <var class="var">fam</var> as the default font family.  See <a class="xref" href="Font-Families.html">Font Families</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-F<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search in directory <samp class="file"><var class="var">dir</var></samp> for the selected output device&rsquo;s
+directory of device and font description files.  See the description of
+<code class="env">GROFF_FONT_PATH</code> in <a class="ref" href="Environment.html">Environment</a> below for the default search
+locations and ordering.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-g</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">ggrn</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-G</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">grap</code> preprocessor; implies <samp class="option">-p</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-h</samp>&rsquo;</dt>
+<dd><p>Display a usage message and exit.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-i</samp>&rsquo;</dt>
+<dd><p>Read the standard input after all the named input files have been
+processed.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-I<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search the directory <var class="var">dir</var> for files named in several contexts;
+implies <samp class="option">-g</samp> and <samp class="option">-s</samp>.
+</p>
+<ul class="itemize mark-bullet">
+<li><code class="command">gsoelim</code> replaces <code class="code">so</code> requests with the contents of their
+file name arguments.
+
+</li><li><code class="command">gtroff</code> searches for files named as operands in its command
+line and as arguments to <code class="code">psbb</code>, <code class="code">so</code>, and <code class="code">soquiet</code>
+requests.
+
+</li><li>Output drivers may search for files; for instance, <code class="command">grops</code> looks
+for files named in &lsquo;<samp class="samp">\X'ps: import <span class="r">&hellip;</span>'</samp>&rsquo;, &lsquo;<samp class="samp">\X'ps: file
+<span class="r">&hellip;</span>'</samp>&rsquo;, and &lsquo;<samp class="samp">\X'pdf: pdfpic <span class="r">&hellip;</span>'</samp>&rsquo; device control
+escape sequences.
+</li></ul>
+
+<p>This option may be specified more than once; the directories are
+searched in the order specified.  If you want to search the current
+directory before others, add &lsquo;<samp class="samp">-I .</samp>&rsquo; at the desired place.  The
+current working directory is otherwise searched last.  <samp class="option">-I</samp> works
+similarly to, and is named for, the &ldquo;include&rdquo; option of Unix C
+compilers.
+</p>
+<p><samp class="option">-I</samp> options are passed to <code class="command">gsoelim</code>, <code class="command">gtroff</code>,
+and output drivers; with the flag letter changed to <samp class="option">-M</samp>, they
+are also passed to <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-j</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gchem</code> preprocessor.  Implies <samp class="option">-p</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-k</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">preconv</code> preprocessor.  Refer to its man page for its
+behavior if neither of <code class="command">groff</code>&rsquo;s <samp class="option">-K</samp> or <samp class="option">-D</samp>
+options is also specified.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-K<var class="var">enc</var></samp>&rsquo;</dt>
+<dd><p>Set input encoding used by <code class="command">preconv</code> to <var class="var">enc</var>; implies
+<samp class="option">-k</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-l</samp>&rsquo;</dt>
+<dd><p>Send the output to a spooler for printing.  The <code class="code">print</code> directive
+in the device description file specifies the default command to be used;
+see <a class="ref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.
+See options <samp class="option">-L</samp> and <samp class="option">-X</samp>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-L<var class="var">arg</var></samp>&rsquo;</dt>
+<dd><p>Pass <var class="var">arg</var> to the print spooler program.  If multiple <var class="var">arg</var>s are
+required, pass each with a separate <samp class="option">-L</samp> option.  <code class="command">groff</code>
+does not prefix an option dash to <var class="var">arg</var> before passing it to the
+spooler program.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-m<var class="var">name</var></samp>&rsquo;</dt>
+<dd><p>Process the file <samp class="file"><var class="var">name</var>.tmac</samp> prior to any input files.
+If not found, <samp class="file">tmac.<var class="var">name</var></samp> is attempted.  <var class="var">name</var>
+(in both arrangements) is presumed to be a macro file; see the
+description of <code class="env">GROFF_TMAC_PATH</code> in <a class="ref" href="Environment.html">Environment</a> below for the
+default search locations and ordering.  This option and its argument are
+also passed to <code class="command">geqn</code>, <code class="command">grap</code>, and <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-M<var class="var">dir</var></samp>&rsquo;</dt>
+<dd><p>Search directory <samp class="file"><var class="var">dir</var></samp> for macro files;  see the description
+of <code class="env">GROFF_TMAC_PATH</code> in <a class="ref" href="Environment.html">Environment</a> below for the default
+search locations and ordering.  This option and its argument are also
+passed to <code class="command">geqn</code>, <code class="command">grap</code>, and <code class="command">ggrn</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-n<var class="var">num</var></samp>&rsquo;</dt>
+<dd><p>Number the first page <var class="var">num</var>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-N</samp>&rsquo;</dt>
+<dd><p>Prohibit newlines between <code class="code">eqn</code> delimiters: pass <samp class="option">-N</samp> to
+<code class="command">geqn</code>.
+</p>
+</dd>
+<dt id='index-print-current-page-register-_0028_002eP_0029'><span>&lsquo;<samp class="samp">-o<var class="var">list</var></samp>&rsquo;<a class="copiable-link" href='#index-print-current-page-register-_0028_002eP_0029'> &para;</a></span></dt>
+<dd><p>Output only pages in <var class="var">list</var>, which is a comma-separated list of page
+ranges; &lsquo;<samp class="samp"><var class="var">n</var></samp>&rsquo; means page&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp"><var class="var">m</var>-<var class="var">n</var></samp>&rsquo;
+means every page between <var class="var">m</var> and&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp">-<var class="var">n</var></samp>&rsquo; means
+every page up to&nbsp;<var class="var">n</var>, &lsquo;<samp class="samp"><var class="var">n</var>-</samp>&rsquo; means every page from
+<var class="var">n</var>&nbsp;on.  <code class="command">gtroff</code> stops processing and exits after
+formatting the last page enumerated in <var class="var">list</var>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-p</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gpic</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-P<var class="var">arg</var></samp>&rsquo;</dt>
+<dd><p>Pass <var class="var">arg</var> to the postprocessor.  If multiple <var class="var">arg</var>s are
+required, pass each with a separate <samp class="option">-P</samp> option.  <code class="command">groff</code>
+does not prefix an option dash to <var class="var">arg</var> before passing it to the
+postprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-r<var class="var">c</var><var class="var">numeric-expression</var></samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">-r<var class="var">register</var>=<var class="var">expr</var></samp>&rsquo;</dt>
+<dd><p>Set <code class="code">roff</code> register&nbsp;<var class="var">c</var> or <var class="var">register</var> to the value
+<var class="var">numeric-expression</var> (see <a class="pxref" href="Numeric-Expressions.html">Numeric Expressions</a>).
+<var class="var">c</var>&nbsp;must be one character; <var class="var">register</var> can be of arbitrary
+length.  Such register assignments happen before any macro file is
+loaded, including the startup file.  Due to <code class="code">getopt_long</code>
+limitations, <var class="var">c</var>&nbsp;cannot be, and <var class="var">register</var> cannot contain,
+an equals sign, even though that is a valid character in a <code class="code">roff</code>
+identifier.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-R</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">grefer</code> preprocessor.  No mechanism is provided for passing
+arguments to <code class="command">grefer</code> because most <code class="command">grefer</code> options have
+equivalent language elements that can be specified within the document.
+</p>
+<a class="index-entry-id" id="index-troffrc"></a>
+<a class="index-entry-id" id="index-troffrc_002dend"></a>
+<p><code class="command">gtroff</code> also accepts a <samp class="option">-R</samp> option, which is not
+accessible via <code class="command">groff</code>.  This option prevents the loading of the
+<samp class="file">troffrc</samp> and <samp class="file">troffrc-end</samp> files.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-s</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gsoelim</code> preprocessor.
+</p>
+</dd>
+<dt id='index-open-request_002c-and-safer-mode'><span>&lsquo;<samp class="samp">-S</samp>&rsquo;<a class="copiable-link" href='#index-open-request_002c-and-safer-mode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-opena-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-pso-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-sy-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-pi-request_002c-and-safer-mode"></a>
+<a class="index-entry-id" id="index-safer-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-safer"></a>
+<p>Operate in &ldquo;safer&rdquo; mode; see <samp class="option">-U</samp> below for its opposite.  For
+security reasons, safer mode is enabled by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-t</samp>&rsquo;</dt>
+<dd><p>Run <code class="command">gtbl</code> preprocessor.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-T<var class="var">dev</var></samp>&rsquo;</dt>
+<dd><p>Direct <code class="command">gtroff</code> to format the input for the output device
+<var class="var">dev</var>.  <code class="command">groff</code> then calls an output driver to convert
+<code class="command">gtroff</code>&rsquo;s output to a form appropriate for <var class="var">dev</var>.  The
+following output devices are available.
+</p>
+<dl class="table">
+<dt><code class="code">ps</code></dt>
+<dd><p>For PostScript printers and previewers.
+</p>
+</dd>
+<dt><code class="code">pdf</code></dt>
+<dd><p>For <abbr class="acronym">PDF</abbr> viewers or printers.
+</p>
+</dd>
+<dt><code class="code">dvi</code></dt>
+<dd><p>For TeX DVI format.
+</p>
+</dd>
+<dt><code class="code">X75</code></dt>
+<dd><p>For a 75<span class="dmn">dpi</span> X11 previewer.
+</p>
+</dd>
+<dt><code class="code">X75-12</code></dt>
+<dd><p>For a 75<span class="dmn">dpi</span> X11 previewer with a 12-point base font in the
+document.
+</p>
+</dd>
+<dt><code class="code">X100</code></dt>
+<dd><p>For a 100<span class="dmn">dpi</span> X11 previewer.
+</p>
+</dd>
+<dt><code class="code">X100-12</code></dt>
+<dd><p>For a 100<span class="dmn">dpi</span> X11 previewer with a 12-point base font in the
+document.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-ASCII'><span><code class="code">ascii</code><a class="copiable-link" href='#index-encoding_002c-output_002c-ASCII'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-encoding_002c-output_002c-ISO-646"></a>
+<a class="index-entry-id" id="index-ASCII-output-encoding"></a>
+<a class="index-entry-id" id="index-ISO-646-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-ASCII"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-ISO-646"></a>
+<p>For typewriter-like devices using the (7-bit) <abbr class="acronym">ASCII</abbr>
+(ISO&nbsp;646) character set.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029'><span><code class="code">latin1</code><a class="copiable-link" href='#index-encoding_002c-output_002c-Latin_002d1-_0028ISO-8859_002d1_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d1-_0028ISO-8859_002d1_0029-output-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d1-_0028Latin_002d1_0029-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029"></a>
+<p>For typewriter-like devices that support the <span class="w-nolinebreak-text">Latin-1</span>
+(ISO&nbsp;<span class="w-nolinebreak-text">8859-1</span>) character set.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-UTF_002d8'><span><code class="code">utf8</code><a class="copiable-link" href='#index-encoding_002c-output_002c-UTF_002d8'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-UTF_002d8-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-UTF_002d8"></a>
+<p>For typewriter-like devices that use the Unicode (ISO&nbsp;10646)
+character set with <span class="w-nolinebreak-text">UTF-8</span> encoding.
+</p>
+</dd>
+<dt id='index-encoding_002c-output_002c-EBCDIC'><span><code class="code">cp1047</code><a class="copiable-link" href='#index-encoding_002c-output_002c-EBCDIC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EBCDIC-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-EBCDIC"></a>
+<a class="index-entry-id" id="index-encoding_002c-output_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-code-page-1047-output-encoding"></a>
+<a class="index-entry-id" id="index-output-encoding_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-IBM-code-page-1047-output-encoding"></a>
+<a class="index-entry-id" id="index-CCSID-1047-output-encoding-_0028EBCDIC_0029"></a>
+<p>For typewriter-like devices that use the <abbr class="acronym">EBCDIC</abbr> encoding IBM
+code page 1047.
+</p>
+</dd>
+<dt><code class="code">lj4</code></dt>
+<dd><p>For HP LaserJet4-compatible (or other PCL5-compatible) printers.
+</p>
+</dd>
+<dt><code class="code">lbp</code></dt>
+<dd><p>For Canon <abbr class="acronym">CaPSL</abbr> printers (<span class="w-nolinebreak-text">LBP-4</span> and <span class="w-nolinebreak-text">LBP-8</span> series laser
+printers).
+</p>
+<a class="index-entry-id" id="index-pre_002dgrohtml"></a>
+<a class="index-entry-id" id="index-post_002dgrohtml"></a>
+<a class="index-entry-id" id="index-grohtml_002c-the-program"></a>
+</dd>
+<dt><code class="code">html</code></dt>
+<dt><code class="code">xhtml</code></dt>
+<dd><p>To produce <abbr class="acronym">HTML</abbr> and <abbr class="acronym">XHTML</abbr> output, respectively.
+This driver consists of two parts, a preprocessor
+(<code class="command">pre-grohtml</code>) and a postprocessor (<code class="command">post-grohtml</code>).
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029"></a>
+<a class="index-entry-id" id="index-output-device-usage-register-_0028_002eT_0029"></a>
+<p>The predefined GNU <code class="code">troff</code> string <code class="code">.T</code> contains the name of
+the output device; the read-only register <code class="code">.T</code> is set to&nbsp;1 if
+this option is used (which is always true if <code class="command">groff</code> is used to
+call GNU <code class="command">troff</code>).  See <a class="xref" href="Built_002din-Registers.html">Built-in Registers</a>.
+</p>
+<p>The postprocessor to be used for a device is specified by the
+<code class="code">postpro</code> command in the device description file.  (See <a class="xref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.)  This can be overridden with the
+<samp class="option">-X</samp> option.
+</p>
+</dd>
+<dt id='index-mode_002c-unsafe'><span>&lsquo;<samp class="samp">-U</samp>&rsquo;<a class="copiable-link" href='#index-mode_002c-unsafe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-unsafe-mode"></a>
+<p>Operate in <em class="dfn">unsafe mode</em>, which enables the <code class="code">open</code>,
+<code class="code">opena</code>, <code class="code">pi</code>, <code class="code">pso</code>, and <code class="code">sy</code> requests.  These
+requests are disabled by default because they allow an untrusted input
+document to write to arbitrary file names and run arbitrary commands.
+This option also adds the current directory to the macro package search
+path; see the <samp class="option">-m</samp> option above.  <samp class="option">-U</samp> is passed to
+<code class="command">gpic</code> and <code class="command">gtroff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-v</samp>&rsquo;</dt>
+<dd><p>Write version information for <code class="command">groff</code> and all programs run by it
+to the standard output stream; that is, the given command line is
+processed in the usual way, passing <samp class="option">-v</samp> to the formatter and any
+pre- or postprocessors invoked.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-V</samp>&rsquo;</dt>
+<dd><p>Output the pipeline that would be run by <code class="command">groff</code>
+(as a wrapper program) to the standard output stream, but do not execute
+it.  If given more than once, the pipeline is both written to the
+standard error stream and run.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-w<var class="var">category</var></samp>&rsquo;</dt>
+<dd><p>Enable warnings in <var class="var">category</var>.  Categories are listed in
+<a class="ref" href="Warnings.html">Warnings</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-W<var class="var">category</var></samp>&rsquo;</dt>
+<dd><p>Inhibit warnings in <var class="var">category</var>.  Categories are listed in
+<a class="ref" href="Warnings.html">Warnings</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-X</samp>&rsquo;</dt>
+<dd><p>Use <code class="command">gxditview</code> instead of the usual postprocessor to (pre)view
+a document on an X11 display.  Combining this option with
+<samp class="option">-Tps</samp> uses the font metrics of the PostScript device, whereas
+the <samp class="option">-TX75</samp> and <samp class="option">-TX100</samp> options use the metrics of X11
+fonts.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-z</samp>&rsquo;</dt>
+<dd><p>Suppress formatted output from <code class="command">gtroff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">-Z</samp>&rsquo;</dt>
+<dd><p>Disable postprocessing.  <code class="command">gtroff</code> output will appear on the
+standard output stream (unless suppressed with <samp class="option">-z</samp>; see
+<a class="ref" href="gtroff-Output.html"><code class="code">gtroff</code> Output</a> for a description of this format.
+</p></dd>
+</dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Environment.html">Environment</a>, Previous: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Gtroff-Internals.html Added

@@ -0,0 +1,187 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Gtroff Internals (The GNU Troff Manual)</title>
+
+<meta name="description" content="Gtroff Internals (The GNU Troff Manual)">
+<meta name="keywords" content="Gtroff Internals (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Debugging.html" rel="next" title="Debugging">
+<link href="Miscellaneous.html" rel="prev" title="Miscellaneous">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Gtroff-Internals">
+<div class="nav-panel">
+<p>
+Next: <a href="Debugging.html" accesskey="n" rel="next">Debugging</a>, Previous: <a href="Miscellaneous.html" accesskey="p" rel="prev">Miscellaneous</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="gtroff-Internals">5.36 <code class="code">gtroff</code> Internals</h3>
+
+<a class="index-entry-id" id="index-input-token"></a>
+<a class="index-entry-id" id="index-token_002c-input"></a>
+<a class="index-entry-id" id="index-output-node"></a>
+<a class="index-entry-id" id="index-node_002c-output"></a>
+<p><code class="code">gtroff</code> processes input in three steps.  One or more input
+characters are converted to an <em class="dfn">input token</em>.<a class="footnote" id="DOCF119" href="groff.html_fot.html#FOOT119"><sup>119</sup></a>  Then, one or more input tokens are converted to
+an <em class="dfn">output node</em>.  Finally, output nodes are converted to the
+intermediate output language understood by all output devices.
+</p>
+<p>Actually, before step one happens, <code class="code">gtroff</code> converts certain escape
+sequences into reserved input characters (not accessible by the user);
+such reserved characters are used for other internal processing also &ndash;
+this is the very reason why not all characters are valid input.
+See <a class="xref" href="Identifiers.html">Identifiers</a>, for more on this topic.
+</p>
+<p>For example, the input string &lsquo;<samp class="samp">fi\:u</samp>&rsquo; is converted into a
+character token &lsquo;<samp class="samp">f</samp>&rsquo;, a character token &lsquo;<samp class="samp">i</samp>&rsquo;, and a special
+token &lsquo;<samp class="samp">:u</samp>&rsquo; (representing u&nbsp;umlaut).  Later on, the character
+tokens &lsquo;<samp class="samp">f</samp>&rsquo; and &lsquo;<samp class="samp">i</samp>&rsquo; are merged to a single output node
+representing the ligature glyph &lsquo;<samp class="samp">fi</samp>&rsquo; (provided the current font has
+a glyph for this ligature); the same happens with &lsquo;<samp class="samp">:u</samp>&rsquo;.  All output
+glyph nodes are &lsquo;processed&rsquo;, which means that they are invariably
+associated with a given font, font size, advance width, etc.  During the
+formatting process, <code class="code">gtroff</code> itself adds various nodes to control
+the data flow.
+</p>
+<p>Macros, diversions, and strings collect elements in two chained lists: a
+list of input tokens that have been passed unprocessed, and a list of
+output nodes.  Consider the following diversion.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xxx
+a
+\!b
+c
+.br
+.di
+</pre></div></div>
+
+<p>It contains these elements.
+</p>
+<table class="multitable">
+<tbody><tr><td>node list</td><td>token list</td><td>element number</td></tr>
+<tr><td><i class="i">line start node</i></td><td>&mdash;</td><td>1</td></tr>
+<tr><td><i class="i">glyph node <code class="code">a</code></i></td><td>&mdash;</td><td>2</td></tr>
+<tr><td><i class="i">word space node</i></td><td>&mdash;</td><td>3</td></tr>
+<tr><td>&mdash;</td><td><code class="code">b</code></td><td>4</td></tr>
+<tr><td>&mdash;</td><td><code class="code">\n</code></td><td>5</td></tr>
+<tr><td><i class="i">glyph node <code class="code">c</code></i></td><td>&mdash;</td><td>6</td></tr>
+<tr><td><i class="i">vertical size node</i></td><td>&mdash;</td><td>7</td></tr>
+<tr><td><i class="i">vertical size node</i></td><td>&mdash;</td><td>8</td></tr>
+<tr><td>&mdash;</td><td><code class="code">\n</code></td><td>9</td></tr>
+</tbody>
+</table>
+
+<a class="index-entry-id" id="index-_005cv_002c-internal-representation"></a>
+<p>Elements 1, 7, and&nbsp;8 are inserted by <code class="code">gtroff</code>; the latter two
+(which are always present) specify the vertical extent of the last line,
+possibly modified by <code class="code">\x</code>.  The <code class="code">br</code> request finishes the
+pending output line, inserting a newline input token, which is
+subsequently converted to a space when the diversion is reread.  Note
+that the word space node has a fixed width that isn&rsquo;t adjustable
+anymore.  To convert horizontal space nodes back to input tokens, use
+the <code class="code">unformat</code> request.
+</p>
+<p>Macros only contain elements in the token list (and the node list is
+empty); diversions and strings can contain elements in both lists.
+</p>
+<p>The <code class="code">chop</code> request simply reduces the number of elements in a
+macro, string, or diversion by one.  Exceptions are <em class="dfn">compatibility
+save</em> and <em class="dfn">compatibility ignore</em> input tokens, which are ignored.
+The <code class="code">substring</code> request also ignores those input tokens.
+</p>
+<p>Some requests like <code class="code">tr</code> or <code class="code">cflags</code> work on glyph identifiers
+only; this means that the associated glyph can be changed without
+destroying this association.  This can be very helpful for substituting
+glyphs.  In the following example, we assume that glyph &lsquo;<samp class="samp">foo</samp>&rsquo; isn&rsquo;t
+available by default, so we provide a substitution using the
+<code class="code">fchar</code> request and map it to input character &lsquo;<samp class="samp">x</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fchar \foo foo
+.tr x \foo
+</pre></div></div>
+
+<p>Now let us assume that we install an additional special font &lsquo;<samp class="samp">bar</samp>&rsquo;
+that has glyph &lsquo;<samp class="samp">foo</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.special bar
+.rchar \foo
+</pre></div></div>
+
+<p>Since glyphs defined with <code class="code">fchar</code> are searched before glyphs in
+special fonts, we must call <code class="code">rchar</code> to remove the definition of the
+fallback glyph.  Anyway, the translation is still active; &lsquo;<samp class="samp">x</samp>&rsquo; now
+maps to the real glyph &lsquo;<samp class="samp">foo</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-compatibility-mode_002c-and-parameters"></a>
+<a class="index-entry-id" id="index-mode_002c-compatibility_002c-and-parameters"></a>
+<a class="index-entry-id" id="index-arguments_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-parameters_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-macro-arguments_002c-and-compatibility-mode"></a>
+<a class="index-entry-id" id="index-request-arguments_002c-and-compatibility-mode"></a>
+<p>Macro and request arguments preserve compatibility mode enablement.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cp 1     \&quot; switch to compatibility mode
+.de xx
+\\$1
+..
+.cp 0     \&quot; switch compatibility mode off
+.xx caf\'e
+    &rArr; café
+</pre></div></div>
+
+<p>Since compatibility mode is enabled while <code class="code">de</code> is invoked, the
+macro <code class="code">xx</code> enables compatibility mode when it is called.  Argument
+<code class="code">$1</code> can still be handled properly because it inherits the
+compatibility mode enablement status that was active at the point where
+<code class="code">xx</code> was called.
+</p>
+<p>After interpolation of the parameters, the compatibility save and
+restore tokens are removed.
+</p>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Debugging.html">Debugging</a>, Previous: <a href="Miscellaneous.html">Miscellaneous</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Headers-and-Footers.html Added

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Headers and Footers (The GNU Troff Manual)</title>
+
+<meta name="description" content="Headers and Footers (The GNU Troff Manual)">
+<meta name="keywords" content="Headers and Footers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Page-Layout-Adjustment.html" rel="next" title="Page Layout Adjustment">
+<link href="Sections-and-Chapters.html" rel="prev" title="Sections and Chapters">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Headers-and-Footers">
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Layout-Adjustment.html" accesskey="n" rel="next">Page Layout</a>, Previous: <a href="Sections-and-Chapters.html" accesskey="p" rel="prev">Sections and Chapters</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Headers-and-Footers-1">3.2.3 Headers and Footers</h4>
+
+<p><i class="slanted">Headers</i> and <i class="slanted">footers</i> occupy the top and bottom of
+each page, respectively, and contain data like the page number and the
+article or chapter title.  Their appearance is not affected by the
+running text.  Some packages allow for different titles on even- and
+odd-numbered pages (for printed, bound material).
+</p>
+<p>Headers and footers are together called <i class="slanted">titles</i>, and comprise
+three parts: left-aligned, centered, and right-aligned.  A &lsquo;<samp class="samp">%</samp>&rsquo;
+character appearing anywhere in a title is automatically replaced by the
+page number.  See <a class="xref" href="Page-Layout.html">Page Layout</a>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Headings-in-ms.html Added

@@ -0,0 +1,214 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Headings in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Headings in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Headings in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Typeface-and-decoration.html" rel="next" title="Typeface and decoration">
+<link href="Paragraphs-in-ms.html" rel="prev" title="Paragraphs in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Headings-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="Typeface-and-decoration.html" accesskey="n" rel="next">Typeface and decoration</a>, Previous: <a href="Paragraphs-in-ms.html" accesskey="p" rel="prev">Paragraphs</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Headings">4.6.5.4 Headings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-headings"></a>
+
+<p>Use headings to create a sequential or hierarchical structure for your
+document.  The <samp class="file">ms</samp> macros print headings in <strong class="strong">bold</strong> using
+the same font family and, by default, type size as the body text.
+Headings are available with and without automatic numbering.  Text on
+input lines following the macro call becomes the heading&rsquo;s title.  Call
+a paragraphing macro to end the heading text and start the section&rsquo;s
+content.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span></var><a class="copiable-link" href='#index-_002eNH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eNH-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NH</code></strong> <var class="def-var-arguments"><code class="t">S</code> <span class="r"><i class="slanted">heading-depth-index</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eNH-1'> &para;</a></span></dt>
+<dd><p>Set an automatically numbered heading.
+</p>
+<p><samp class="file">ms</samp> produces a numbered heading the form <var class="var">a.b.c&hellip;</var>, to
+any depth desired, with the numbering of each depth increasing
+automatically and being reset to zero when a more significant level is
+increased.  &ldquo;1&rdquo;&nbsp;is the most significant or coarsest division of
+the document.  Only non-zero values are output.  If <var class="var">depth</var> is
+omitted, it is taken to be &lsquo;<samp class="samp">1</samp>&rsquo;.
+</p>
+<p>If you specify <var class="var">depth</var> such that an ascending gap occurs relative to
+the previous <code class="code">NH</code> call&mdash;that is, you &ldquo;skip a depth&rdquo;, as by
+&lsquo;<samp class="samp">.NH 1</samp>&rsquo; and then &lsquo;<samp class="samp">.NH 3</samp>&rsquo;&mdash;<code class="code">groff</code> <samp class="file">ms</samp> emits a
+warning on the standard error stream.
+</p>
+<p>Alternatively, you can give <code class="code">NH</code> a first argument of&nbsp;<code class="code">S</code>,
+followed by integers to number the heading depths explicitly.  Further
+automatic numbering, if used, resumes using the specified indices as
+their predecessors.
+This feature is a Berkeley extension.
+</p></dd></dl>
+
+<p>An example may be illustrative.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+Animalia
+.NH 2
+Arthropoda
+.NH 3
+Crustacea
+.NH 2
+Chordata
+.NH S 6 6 6
+Daimonia
+.NH 1
+Plantae
+</pre></div>
+</td></tr></table>
+
+<p>The above results in numbering as follows; the vertical space that
+normally precedes each heading is omitted.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">1.  Animalia
+1.1.  Arthropoda
+1.1.1.  Crustacea
+1.2.  Chordata
+6.6.6.  Daimonia
+7.  Plantae
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bSN_002dSTYLE_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-STYLE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dSTYLE_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dSTYLE-_005bms_005d-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_002dDOT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-DOT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dDOT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dDOT-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_002dNO_002dDOT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-NO-DOT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dNO_002dDOT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dNO_002dDOT-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bSN_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN-_005bms_005d"></a>
+<p>After <code class="code">NH</code> is called, the assigned number is made available in the
+strings <code class="code">SN-DOT</code> (as it appears in a printed heading with default
+formatting, followed by a terminating period) and <code class="code">SN-NO-DOT</code> (with
+the terminating period omitted).  These are GNU extensions.
+</p>
+<p>You can control the style used to print numbered headings by defining an
+appropriate alias for the string <code class="code">SN-STYLE</code>.  By default,
+<code class="code">SN-STYLE</code> is aliased to <code class="code">SN-DOT</code>.  If you prefer to omit the
+terminating period from numbers appearing in numbered headings, you may
+define the alias as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als SN-STYLE SN-NO-DOT
+</pre></div></div>
+
+<p>Any such change in numbering style becomes effective from the next use
+of <code class="code">NH</code> following redefinition of the alias for <code class="code">SN-STYLE</code>.
+The formatted number of the current heading is available in the
+<code class="code">SN</code> string (a feature first documented by Berkeley), which
+facilitates its inclusion in, for example, table captions, equation
+labels, and <code class="code">XS</code>/<code class="code">XA</code>/<code class="code">XE</code> table of contents entries.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eSH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.SH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span></var><a class="copiable-link" href='#index-_002eSH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SH-_005bms_005d"></a>
+<p>Set an unnumbered heading.
+</p>
+<p>The optional <var class="var">depth</var> argument is a GNU extension indicating the
+heading depth corresponding to the <var class="var">depth</var> argument of <code class="code">NH</code>.
+It matches the type size at which the heading is set to that of a
+numbered heading at the same depth when the <code class="code">GROWPS</code> and
+<code class="code">PSINCR</code> heading size adjustment mechanism is in effect.
+</p></dd></dl>
+
+<p>If the <code class="code">GROWPS</code> register is set to a value greater than the
+<var class="var">level</var> argument to <code class="code">NH</code> or <code class="code">SH</code>, the type size of a
+heading produced by these macros increases by <code class="code">PSINCR</code> units over
+the size specified by <code class="code">PS</code> multiplied by the difference of
+<code class="code">GROWPS</code> and <var class="var">level</var>.  The value stored in <code class="code">PSINCR</code> is
+interpreted in <code class="code">groff</code> basic units; the <code class="code">p</code> scaling unit
+should be employed when assigning a value specified in points.  For
+example, the sequence
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PS 10
+.nr GROWPS 3
+.nr PSINCR 1.5p
+.NH 1
+Carnivora
+.NH 2
+Felinae
+.NH 3
+Felis catus
+.SH 2
+Machairodontinae
+</pre></div>
+</td></tr></table>
+
+<p>will cause &ldquo;1. Carnivora&rdquo; to be printed in 13-point text, followed by
+&ldquo;1.1. Felinae&rdquo; in 11.5-point text, while &ldquo;1.1.1. Felis catus&rdquo; and
+all more deeply nested heading levels will remain in the 10-point text
+specified by the <code class="code">PS</code> register.  &ldquo;Machairodontinae&rdquo; is printed at
+11.5 points, since it corresponds to heading level&nbsp;2.
+</p>
+<p>The <code class="code">HORPHANS</code> register operates in conjunction with the <code class="code">NH</code>
+and <code class="code">SH</code> macros to inhibit the printing of isolated headings at the
+bottom of a page; it specifies the minimum number of lines of an
+immediately subsequent paragraph that must be kept on the same page as
+the heading.  If insufficient space remains on the current page to
+accommodate the heading and this number of lines of paragraph text, a
+page break is forced before the heading is printed.  Any display macro
+call or <code class="code">tbl</code>, <code class="code">pic</code>, or <code class="code">eqn</code> region between the heading
+and the subsequent paragraph suppresses this grouping.  See <a class="xref" href="ms-keeps-and-displays.html">Keeps, boxed keeps, and displays</a> and <a class="ref" href="ms-Insertions.html">Tables, figures, equations, and references</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Typeface-and-decoration.html">Typeface and decoration</a>, Previous: <a href="Paragraphs-in-ms.html">Paragraphs</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Hyphenation.html Added

@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Hyphenation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Hyphenation (The GNU Troff Manual)">
+<meta name="keywords" content="Hyphenation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Breaking.html" rel="next" title="Breaking">
+<link href="Sentences.html" rel="prev" title="Sentences">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Hyphenation">
+<div class="nav-panel">
+<p>
+Next: <a href="Breaking.html" accesskey="n" rel="next">Breaking</a>, Previous: <a href="Sentences.html" accesskey="p" rel="prev">Sentences</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Hyphenation-1">5.1.3 Hyphenation</h4>
+<a class="index-entry-id" id="index-hyphenation"></a>
+
+<p>When an output line is nearly full, it is uncommon for the next word
+collected from the input to exactly fill it&mdash;typically, there is room
+left over only for part of the next word.  The process of splitting a
+word so that it appears partially on one line (with a hyphen to indicate
+to the reader that the word has been broken) with its remainder on the
+next is <em class="dfn">hyphenation</em>.  Hyphenation points can be manually
+specified; GNU <code class="code">troff</code> also uses a hyphenation algorithm and
+language-specific pattern files (based on those used in TeX) to
+decide which words can be hyphenated and where.
+</p>
+<p>Hyphenation does not always occur even when the hyphenation rules for a
+word allow it; it can be disabled, and when not disabled there are
+several parameters that can prevent it in certain circumstances.
+See <a class="xref" href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/I_002fO.html Added

@@ -0,0 +1,457 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>I/O (The GNU Troff Manual)</title>
+
+<meta name="description" content="I/O (The GNU Troff Manual)">
+<meta name="keywords" content="I/O (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Postprocessor-Access.html" rel="next" title="Postprocessor Access">
+<link href="Suppressing-Output.html" rel="prev" title="Suppressing Output">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="I_002fO">
+<div class="nav-panel">
+<p>
+Next: <a href="Postprocessor-Access.html" accesskey="n" rel="next">Postprocessor Access</a>, Previous: <a href="Suppressing-Output.html" accesskey="p" rel="prev">Suppressing Output</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="I_002fO-1">5.33 I/O</h3>
+<a class="index-entry-id" id="index-i_002fo"></a>
+<a class="index-entry-id" id="index-input-and-output-requests"></a>
+<a class="index-entry-id" id="index-requests-for-input-and-output"></a>
+<a class="index-entry-id" id="index-output-and-input-requests"></a>
+
+<p><code class="code">gtroff</code> has several requests for including files:
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.so</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002eso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-so"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002esoquiet"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.soquiet</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002esoquiet'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-soquiet"></a>
+<a class="index-entry-id" id="index-including-a-file-_0028so_0029"></a>
+<a class="index-entry-id" id="index-file_002c-inclusion-_0028so_0029"></a>
+<p>Replace the <code class="code">so</code> request&rsquo;s control line with the contents of the
+file named by the argument, &ldquo;sourcing&rdquo; it.  <var class="var">file</var> is sought in
+the directories specified by <samp class="option">-I</samp> command-line option.  If
+<var class="var">file</var> does not exist, a warning in category &lsquo;<samp class="samp">file</samp>&rsquo; is produced
+and the request has no further effect.  See <a class="xref" href="Warnings.html">Warnings</a>, for
+information about the enablement and suppression of warnings.
+</p>
+<p><code class="code">so</code> can be useful for large documents; e.g., allowing each chapter
+of a book to be kept in a separate file.  However, files interpolated
+with <code class="code">so</code> are not preprocessed; to overcome this limitation, see
+the <cite class="cite">gsoelim<span class="r">(1)</span></cite> man page.
+</p>
+<p>Since GNU <code class="code">troff</code> replaces the entire control line with the
+contents of a file, it matters whether <code class="code">file</code> is terminated with a
+newline or not.  Assume that file <samp class="file">xxx</samp> contains only the word
+&lsquo;<samp class="samp">foo</samp>&rsquo; without a trailing newline.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ printf 'foo' &gt; xxx
+
+The situation is
+.so xxx
+bar.
+    &rArr; The situation is foobar.
+</pre></div></div>
+
+<p><code class="code">soquiet</code> works the same way, except that no warning diagnostic is
+issued if <var class="var">file</var> does not exist.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pso</code></strong> <var class="def-var-arguments">command</var><a class="copiable-link" href='#index-_002epso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pso"></a>
+<p>Read the standard output from the specified <var class="var">command</var> and include
+it in place of the <code class="code">pso</code> request.
+</p>
+<a class="index-entry-id" id="index-safer-mode-3"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-3"></a>
+<a class="index-entry-id" id="index-unsafe-mode-3"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-3"></a>
+<p>It is an error to use this request in safer mode, which is the
+default.  Invoke GNU <code class="code">troff</code> or a front end with the <samp class="option">-U</samp>
+option to enable unsafe mode.
+</p>
+<p>The comment regarding a final newline for the <code class="code">so</code> request is valid
+for <code class="code">pso</code> also.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emso"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mso</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002emso'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mso"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002emsoquiet"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.msoquiet</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002emsoquiet'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-msoquiet"></a>
+<p>Identical to the <code class="code">so</code> and <code class="code">soquiet</code> requests, respectively,
+except that <code class="code">gtroff</code> searches for the specified <var class="var">file</var> in the
+same directories as macro files for the <samp class="option">-m</samp> command-line option.
+If the file name to be included has the form <samp class="file"><var class="var">name</var>.tmac</samp> and
+it isn&rsquo;t found, these requests try to include <samp class="file">tmac.<var class="var">name</var></samp> and
+vice versa.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etrf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.trf</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002etrf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-trf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ecf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cf</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002ecf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cf"></a>
+<a class="index-entry-id" id="index-transparent-output-_0028cf_002c-trf_0029"></a>
+<a class="index-entry-id" id="index-output_002c-transparent-_0028cf_002c-trf_0029"></a>
+<a class="index-entry-id" id="index-cf-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-cf-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-cf-request"></a>
+<a class="index-entry-id" id="index-trf-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-trf-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-trf-request"></a>
+<p>Transparently output the contents of <var class="var">file</var>.  Each line is output as
+if it were preceded by <code class="code">\!</code>; however, the lines are <em class="emph">not</em>
+subject to copy mode interpretation.  If the file does not end with a
+newline, <code class="code">trf</code> adds one.  Both requests cause a break.
+</p>
+<p>When used in a diversion, these requests embed a node (see <a class="pxref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>) in it that, when reread, causes the contents of <var class="var">file</var>
+to be transparently copied to the output.  In <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, the contents of <var class="var">file</var> are immediately copied to the
+output regardless of whether there is a current diversion; this
+behaviour is so anomalous that it must be considered a bug.
+</p>
+<a class="index-entry-id" id="index-trf-request_002c-and-invalid-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-invalid-for-trf-request"></a>
+<a class="index-entry-id" id="index-invalid-characters-for-trf-request"></a>
+<p>While <code class="code">cf</code> copies the contents of <var class="var">file</var> completely
+unprocessed, <code class="code">trf</code> disallows characters such as NUL that are not
+valid <code class="code">gtroff</code> input characters (see <a class="pxref" href="Identifiers.html">Identifiers</a>).
+</p>
+<p>For <code class="code">cf</code>, within a diversion, &ldquo;completely unprocessed&rdquo; means that
+each line of a file to be inserted is handled as if it were preceded by
+<code class="code">\!\\!</code>.
+</p>
+<p>To define a macro&nbsp;<code class="code">x</code> containing the contents of
+file&nbsp;<samp class="file">f</samp>, use
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ev 1
+.di x
+.trf f
+.di
+.ev
+</pre></div></div>
+
+<p>The calls to <code class="code">ev</code> prevent the partially collected output line
+from becoming part of the diversion (see <a class="pxref" href="Diversions.html">Diversions</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enx"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nx</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">file</i></span></var><a class="copiable-link" href='#index-_002enx'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nx"></a>
+<a class="index-entry-id" id="index-processing-next-file-_0028nx_0029"></a>
+<a class="index-entry-id" id="index-file_002c-processing-next-_0028nx_0029"></a>
+<a class="index-entry-id" id="index-next-file_002c-processing-_0028nx_0029"></a>
+<p>Force <code class="code">gtroff</code> to continue processing of the file specified as an
+argument.  If no argument is given, immediately jump to the end of file.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erd"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rd</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">prompt</i></span> <span class="r"><i class="slanted">arg1</i></span> <span class="r"><i class="slanted">arg2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002erd'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rd"></a>
+<a class="index-entry-id" id="index-reading-from-standard-input-_0028rd_0029"></a>
+<a class="index-entry-id" id="index-standard-input_002c-reading-from-_0028rd_0029"></a>
+<a class="index-entry-id" id="index-input_002c-standard_002c-reading-from-_0028rd_0029"></a>
+<p>Read from standard input, and include what is read as though it were
+part of the input file.  Text is read until a blank line is encountered.
+</p>
+<p>If standard input is a TTY input device (keyboard), write <var class="var">prompt</var>
+to standard error, followed by a colon (or send BEL for a beep if no
+argument is given).
+</p>
+<p>Arguments after <var class="var">prompt</var> are available for the input.  For example,
+the line
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.rd data foo bar
+</pre></div></div>
+
+<p>with the input &lsquo;<samp class="samp">This&nbsp;is&nbsp;\$2.</samp>&rsquo; prints
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This is bar.
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-form-letters"></a>
+<a class="index-entry-id" id="index-letters_002c-form"></a>
+<p>Using the <code class="code">nx</code> and <code class="code">rd</code> requests, it is easy to set up form
+letters.  The form letter template is constructed like this, putting the
+following lines into a file called <samp class="file">repeat.let</samp>:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ce
+\*(td
+.sp 2
+.nf
+.rd
+.sp
+.rd
+.fi
+Body of letter.
+.bp
+.nx repeat.let
+</pre></div></div>
+
+<a class="index-entry-id" id="index-ex-request_002c-used-with-nx-and-rd"></a>
+<p>When this is run, a file containing the following lines should be
+redirected in.  Requests included in this file are executed as though
+they were part of the form letter.  The last block of input is the
+<code class="code">ex</code> request, which tells GNU <code class="code">troff</code> to stop processing.  If
+this were not there, <code class="code">troff</code> would not know when to stop.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Trent A. Fisher
+708 NW 19th Av., #202
+Portland, OR  97209
+
+Dear Trent,
+
+Len Adollar
+4315 Sierra Vista
+San Diego, CA  92103
+
+Dear Mr. Adollar,
+
+.ex
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epi"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pi</code></strong> <var class="def-var-arguments">pipe</var><a class="copiable-link" href='#index-_002epi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pi"></a>
+<p>Pipe the output of <code class="code">gtroff</code> to the shell command(s) specified by
+<var class="var">pipe</var>.  This request must occur before <code class="code">gtroff</code> has a chance
+to print anything.
+</p>
+<a class="index-entry-id" id="index-safer-mode-4"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-4"></a>
+<a class="index-entry-id" id="index-unsafe-mode-4"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-4"></a>
+<p>It is an error to use this request in safer mode, which is the
+default.  Invoke GNU <code class="code">troff</code> or a front end with the <samp class="option">-U</samp>
+option to enable unsafe mode.
+</p>
+<p>Multiple calls to <code class="code">pi</code> are allowed, acting as a chain.  For
+example,
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pi foo
+.pi bar
+...
+</pre></div></div>
+
+<p>is the same as &lsquo;<samp class="samp">.pi&nbsp;foo&nbsp;|&nbsp;bar</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-groff_002c-and-pi-request"></a>
+<a class="index-entry-id" id="index-pi-request_002c-and-groff"></a>
+<p>The intermediate output format of GNU <code class="code">troff</code> is piped to the
+specified commands.  Consequently, calling <code class="code">groff</code> without the
+<samp class="option">-Z</samp> option normally causes a fatal error.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-system-commands_002c-running"></a>
+<a class="index-entry-id" id="index-running-system-commands"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esy"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sy</code></strong> <var class="def-var-arguments">cmds</var><a class="copiable-link" href='#index-_002esy'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sy"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bsystat_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nsystat</code></strong><a class="copiable-link" href='#index-_005cn_005bsystat_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-systat"></a>
+<p>Execute the shell command(s) specified by <var class="var">cmds</var>.  The output is not
+saved anywhere, so it is up to the user to do so.
+</p>
+<a class="index-entry-id" id="index-safer-mode-5"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-5"></a>
+<a class="index-entry-id" id="index-unsafe-mode-5"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-5"></a>
+<p>It is an error to use this request in safer mode; this is the default.
+Give GNU <code class="code">troff</code> or a front end program the <samp class="option">-U</samp> option to
+enable unsafe mode.
+</p>
+<p>The following code fragment introduces the current time into a document.
+</p>
+<a class="index-entry-id" id="index-perl"></a>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.sy perl -e 'printf &quot;.nr H %d\\n.nr M %d\\n.nr S %d\\n&quot;,\
+             (localtime(time))2,1,0' &gt; /tmp/x\n$$
+.so /tmp/x\n$$
+.sy rm /tmp/x\n$$
+\nH:\nM:\nS
+</pre></div></div>
+
+<p>This works by having the Perl script (run by <code class="code">sy</code>) write
+<code class="code">nr</code> requests that set the registers <code class="code">H</code>, <code class="code">M</code>, and
+<code class="code">S</code> to a temporary file.  The <code class="code">roff</code> document then reads the
+temporary file using the <code class="code">so</code> request.
+</p>
+<a class="index-entry-id" id="index-time_002c-formatting"></a>
+<a class="index-entry-id" id="index-formatting-the-time"></a>
+<p>The registers <code class="code">seconds</code>, <code class="code">minutes</code>, and <code class="code">hours</code>,
+initialized at startup of GNU <code class="code">troff</code>, should satisfy most
+requirements.  Use the <code class="code">af</code> request to format their values for
+output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.af hours 00
+.af minutes 00
+.af seconds 00
+\nhours:\nminutes:\nseconds
+    &rArr; 02:17:54
+</pre></div></div>
+
+<a class="index-entry-id" id="index-system_0028_0029-return-value-register-_0028systat_0029"></a>
+<p>The writable register <code class="code">systat</code> contains the return value of the
+<code class="code">system()</code> function executed by the last <code class="code">sy</code> request.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eopen"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.open</code></strong> <var class="def-var-arguments">stream file</var><a class="copiable-link" href='#index-_002eopen'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-open"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eopena"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.opena</code></strong> <var class="def-var-arguments">stream file</var><a class="copiable-link" href='#index-_002eopena'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-opena"></a>
+<a class="index-entry-id" id="index-opening-file-_0028open_0029"></a>
+<a class="index-entry-id" id="index-file_002c-opening-_0028open_0029"></a>
+<a class="index-entry-id" id="index-appending-to-a-file-_0028opena_0029"></a>
+<a class="index-entry-id" id="index-file_002c-appending-to-_0028opena_0029"></a>
+<p>Open the specified <var class="var">file</var> for writing and associates the specified
+<var class="var">stream</var> with it.
+</p>
+<p>The <code class="code">opena</code> request is like <code class="code">open</code>, but if the file exists,
+append to it instead of truncating it.
+</p>
+<a class="index-entry-id" id="index-safer-mode-6"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-6"></a>
+<a class="index-entry-id" id="index-unsafe-mode-6"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-6"></a>
+<p>It is an error to use these requests in safer mode; this is the default.
+Give GNU <code class="code">troff</code> or a front end program the <samp class="option">-U</samp> option to
+enable unsafe mode.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewrite"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.write</code></strong> <var class="def-var-arguments">stream data</var><a class="copiable-link" href='#index-_002ewrite'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-write"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ewritec"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.writec</code></strong> <var class="def-var-arguments">stream data</var><a class="copiable-link" href='#index-_002ewritec'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-writec"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-write-request"></a>
+<a class="index-entry-id" id="index-write-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-write-request"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-writec-request"></a>
+<a class="index-entry-id" id="index-writec-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-writec-request"></a>
+<a class="index-entry-id" id="index-writing-to-file-_0028write_002c-writec_0029"></a>
+<a class="index-entry-id" id="index-file_002c-writing-to-_0028write_002c-writec_0029"></a>
+<p>Write to the file associated with the specified <var class="var">stream</var>.  The
+stream must previously have been the subject of an open request.  The
+remainder of the line is interpreted as the <code class="code">ds</code> request reads its
+second argument: an initial neutral double quote in <var class="var">contents</var> is
+stripped to allow embedding of leading spaces, and it is read in copy
+mode.
+</p>
+<p>The <code class="code">writec</code> request is like <code class="code">write</code>, but only <code class="code">write</code>
+appends a newline to the data.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewritem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.writem</code></strong> <var class="def-var-arguments">stream xx</var><a class="copiable-link" href='#index-_002ewritem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-writem"></a>
+<a class="index-entry-id" id="index-asciify-request_002c-and-writem"></a>
+<p>Write the contents of the macro or string <var class="var">xx</var> to the file
+associated with the specified <var class="var">stream</var>.
+</p>
+<a class="index-entry-id" id="index-writem-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-writem-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-writem-request"></a>
+<p><var class="var">xx</var> is read in copy mode, i.e., already formatted elements are
+ignored.  Consequently, diversions must be unformatted with the
+<code class="code">asciify</code> request before calling <code class="code">writem</code>.  Usually, this
+means a loss of information.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eclose"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.close</code></strong> <var class="def-var-arguments">stream</var><a class="copiable-link" href='#index-_002eclose'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-close"></a>
+<a class="index-entry-id" id="index-closing-file-_0028close_0029"></a>
+<a class="index-entry-id" id="index-file_002c-closing-_0028close_0029"></a>
+<p>Close the specified <var class="var">stream</var>; the stream is no longer an acceptable
+argument to the <code class="code">write</code> request.
+</p>
+<p>Here a simple macro to write an index entry.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.open idx test.idx
+.
+.de IX
+.  write idx \\n% \\$*
+..
+.
+.IX test entry
+.
+.close idx
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cVe"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V</code><span class="r"><i class="slanted">e</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cVe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cV"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cV_0028ev"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V(</code><span class="r"><i class="slanted">ev</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cV_0028ev'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cV_005benv_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\V</code><span class="r"><i class="slanted">env</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cV_005benv_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cV_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005cV"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005cV"></a>
+<p>Interpolate the contents of the specified environment variable <var class="var">env</var>
+(one-character name&nbsp;<var class="var">e</var>, two-character name <var class="var">ev</var>) as
+returned by the function <cite class="cite">getenv<span class="r">(3)</span></cite>.  <code class="code">\V</code> is interpreted
+even in copy mode (see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Postprocessor-Access.html">Postprocessor Access</a>, Previous: <a href="Suppressing-Output.html">Suppressing Output</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Identifiers.html Added

@@ -0,0 +1,210 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Identifiers (The GNU Troff Manual)</title>
+
+<meta name="description" content="Identifiers (The GNU Troff Manual)">
+<meta name="keywords" content="Identifiers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Formatter-Instructions.html" rel="next" title="Formatter Instructions">
+<link href="Numeric-Expressions.html" rel="prev" title="Numeric Expressions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Identifiers">
+<div class="nav-panel">
+<p>
+Next: <a href="Formatter-Instructions.html" accesskey="n" rel="next">Formatter Instructions</a>, Previous: <a href="Numeric-Expressions.html" accesskey="p" rel="prev">Numeric Expressions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Identifiers-1">5.5 Identifiers</h3>
+<a class="index-entry-id" id="index-identifiers"></a>
+
+<p>An <em class="dfn">identifier</em> labels a GNU <code class="code">troff</code> datum such as a register,
+name (macro, string, or diversion), typeface, color, special character,
+character class, environment, or stream.  Valid identifiers consist of
+one or more ordinary characters.
+<a class="index-entry-id" id="index-ordinary-character"></a>
+<a class="index-entry-id" id="index-character_002c-ordinary"></a>
+An <i class="slanted">ordinary character</i> is an input character that is not the
+escape character, a leader, tab, newline, or invalid as GNU <code class="code">troff</code>
+input.
+</p>
+<a class="index-entry-id" id="index-invalid-input-characters"></a>
+<a class="index-entry-id" id="index-input-characters_002c-invalid"></a>
+<a class="index-entry-id" id="index-characters_002c-invalid-input"></a>
+<a class="index-entry-id" id="index-Unicode"></a>
+<p>Invalid input characters are a subset of control characters (from the
+sets &ldquo;C0 Controls&rdquo; and &ldquo;C1 Controls&rdquo; as Unicode describes them).
+When GNU <code class="code">troff</code> encounters one in an identifier, it produces a
+warning in category &lsquo;<samp class="samp">input</samp>&rsquo; (see <a class="pxref" href="Warnings.html">Warnings</a>).  They are removed
+during interpretation: an identifier &lsquo;<samp class="samp">foo</samp>&rsquo;, followed by an invalid
+character and then &lsquo;<samp class="samp">bar</samp>&rsquo;, is processed as &lsquo;<samp class="samp">foobar</samp>&rsquo;.
+</p>
+<p>On a machine using the ISO 646, 8859, or 10646 character encodings,
+invalid input characters are <code class="code">0x00</code>, <code class="code">0x08</code>, <code class="code">0x0B</code>,
+<code class="code">0x0D</code>&ndash;<code class="code">0x1F</code>, and <code class="code">0x80</code>&ndash;<code class="code">0x9F</code>.  On an
+<abbr class="acronym">EBCDIC</abbr> host, they are <code class="code">0x00</code>&ndash;<code class="code">0x01</code>, <code class="code">0x08</code>,
+<code class="code">0x09</code>, <code class="code">0x0B</code>, <code class="code">0x0D</code>&ndash;<code class="code">0x14</code>,
+<code class="code">0x17</code>&ndash;<code class="code">0x1F</code>, and
+<code class="code">0x30</code>&ndash;<code class="code">0x3F</code>.<a class="footnote" id="DOCF40" href="groff.html_fot.html#FOOT40"><sup>40</sup></a>  Some of these code points are used
+by GNU <code class="code">troff</code> internally, making it non-trivial to extend the
+program to accept UTF-8 or other encodings that use characters from
+these ranges.<a class="footnote" id="DOCF41" href="groff.html_fot.html#FOOT41"><sup>41</sup></a>
+</p>
+<p>Thus, the identifiers &lsquo;<samp class="samp">br</samp>&rsquo;, &lsquo;<samp class="samp">PP</samp>&rsquo;, &lsquo;<samp class="samp">end-list</samp>&rsquo;,
+&lsquo;<samp class="samp">ref*normal-print</samp>&rsquo;, &lsquo;<samp class="samp">|</samp>&rsquo;, &lsquo;<samp class="samp">@_</samp>&rsquo;, and &lsquo;<samp class="samp">!&quot;#$%'()*+,-./</samp>&rsquo;
+are all valid.  Discretion should be exercised to prevent confusion.
+Identifiers starting with &lsquo;<samp class="samp">(</samp>&rsquo; or &lsquo;<samp class="samp"></samp>&rsquo; require care.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 9
+.nr y 1
+.nr (x 2
+.nr y 3
+.nr sum1 (\n(x + \ny)
+    error&rarr; a space character is not allowed in an escape
+    error&rarr;   sequence parameter
+A:2+3=\nsum1
+.nr sum2 (\n((x + \ny)
+B:2+3=\nsum2
+.nr sum3 (\n(x + \n(y)
+C:2+3=\nsum3
+    &rArr; A:2+3=1 B:2+3=5 C:2+3=5
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005d_002c-as-part-of-an-identifier"></a>
+<p>An identifier with a closing bracket (&lsquo;<samp class="samp"></samp>&rsquo;) in its name can&rsquo;t be
+accessed with bracket-form escape sequences that expect an identifier as
+a parameter.  For example, &lsquo;<samp class="samp">\foo</samp>&rsquo; accesses the glyph &lsquo;<samp class="samp">foo</samp>&rsquo;,
+followed by &lsquo;<samp class="samp"></samp>&rsquo; in whatever the surrounding context is, whereas
+&lsquo;<samp class="samp">\C'foo'</samp>&rsquo; formats a glyph named &lsquo;<samp class="samp">foo</samp>&rsquo;.  Similarly, the
+identifier &lsquo;<samp class="samp">(</samp>&rsquo; can&rsquo;t be interpolated <em class="emph">except</em> with bracket
+forms.
+</p>
+<a class="index-entry-id" id="index-refer_002c-and-macro-names-starting-with-_005b-or-_005d"></a>
+<a class="index-entry-id" id="index-_005b_002c-macro-names-starting-with_002c-and-refer"></a>
+<a class="index-entry-id" id="index-_005d_002c-macro-names-starting-with_002c-and-refer"></a>
+<a class="index-entry-id" id="index-macro-names_002c-starting-with-_005b-or-_005d_002c-and-refer"></a>
+<p>If you begin a macro, string, or diversion name with either of the
+characters &lsquo;<samp class="samp"></samp>&rsquo; or &lsquo;<samp class="samp"></samp>&rsquo;, you foreclose use of the <code class="code">grefer</code>
+preprocessor, which recognizes &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">.</samp>&rsquo; as bibliographic
+reference delimiters.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cA_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\A<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cA_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cA"></a>
+<p>Interpolate&nbsp;1 if <var class="var">anything</var> is a valid identifier, and&nbsp;0
+otherwise.  The delimiter need not be a neutral apostrophe; see
+<a class="ref" href="Delimiters.html">Delimiters</a>.  Because invalid input characters are removed (see
+above), invalid identifiers are empty or contain spaces, tabs, or
+newlines.
+</p>
+<p>You can employ <code class="code">\A</code> to validate a macro argument before using it to
+construct another escape sequence or identifier.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; usage: .init-coordinate-pair name val1 val2
+.\&quot; Create a coordinate pair where name!x=val1 and
+.\&quot; name!y=val2.
+.de init-coordinate-pair
+.  if \A'\\$1' \{\
+.    if \B'\\$2' .nr \\$1!x \\$2
+.    if \B'\\$3' .nr \\$1!y \\$3
+.  \}
+..
+.init-coordinate-pair center 5 10
+The center is at (\ncenter!x, \ncenter!y).
+.init-coordinate-pair &quot;poi&rarr;nt&quot; trash garbage \&quot; ignored
+.init-coordinate-pair point trash garbage \&quot; ignored
+    &rArr; The center is at (5, 10).
+</pre></div></div>
+
+<p>In this example, we also validated the numeric arguments; the registers
+&lsquo;<samp class="samp">point!x</samp>&rsquo; and &lsquo;<samp class="samp">point!y</samp>&rsquo; remain undefined.  See <a class="xref" href="Numeric-Expressions.html">Numeric Expressions</a> for the <code class="code">\B</code> escape sequence.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-undefined-identifiers"></a>
+<a class="index-entry-id" id="index-identifiers_002c-undefined"></a>
+<p>How GNU <code class="code">troff</code> handles the interpretation of an undefined
+identifier depends on the context.  There is no way to invoke an
+undefined request; such syntax is interpreted as a macro call instead.
+If the identifier is interpreted as a string, macro, or diversion, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">mac</samp>&rsquo;, defines it as
+empty, and interpolates nothing.  If the identifier is interpreted as a
+register, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">reg</samp>&rsquo;,
+initializes it to zero, and interpolates that value.  See <a class="xref" href="Warnings.html">Warnings</a>,
+<a class="ref" href="Interpolating-Registers.html">Interpolating Registers</a>, and <a class="ref" href="Strings.html">Strings</a>.  Attempting to use an
+undefined typeface, special character, color, character class,
+environment, or stream generally provokes an error diagnostic.
+</p>
+<a class="index-entry-id" id="index-name-space_002c-common_002c-of-macros_002c-diversions_002c-and-strings"></a>
+<a class="index-entry-id" id="index-common-name-space-of-macros_002c-diversions_002c-and-strings"></a>
+<a class="index-entry-id" id="index-macros_002c-shared-name-space-with-strings-and-diversions"></a>
+<a class="index-entry-id" id="index-strings_002c-shared-name-space-with-macros-and-diversions"></a>
+<a class="index-entry-id" id="index-diversions_002c-shared-name-space-with-macros-and-strings"></a>
+<p>Identifiers for requests, macros, strings, and diversions share one name
+space; special characters and character classes another.  No other
+object types do.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  nop foo
+..
+.di xxx
+bar
+.br
+.di
+.
+.xxx
+    &rArr; bar
+</pre></div></div>
+
+<p>The foregoing example shows that GNU <code class="code">troff</code> reuses the identifier
+&lsquo;<samp class="samp">xxx</samp>&rsquo;, changing it from a macro to a diversion.  No warning is
+emitted, and the previous contents of &lsquo;<samp class="samp">xxx</samp>&rsquo; are lost.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Formatter-Instructions.html">Formatter Instructions</a>, Previous: <a href="Numeric-Expressions.html">Numeric Expressions</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Implementation-Differences.html Added

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Implementation Differences (The GNU Troff Manual)</title>
+
+<meta name="description" content="Implementation Differences (The GNU Troff Manual)">
+<meta name="keywords" content="Implementation Differences (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Safer-Mode.html" rel="next" title="Safer Mode">
+<link href="Debugging.html" rel="prev" title="Debugging">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Implementation-Differences">
+<div class="nav-panel">
+<p>
+Next: <a href="Safer-Mode.html" accesskey="n" rel="next">Safer Mode</a>, Previous: <a href="Debugging.html" accesskey="p" rel="prev">Debugging</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Implementation-Differences-1">5.38 Implementation Differences</h3>
+<a class="index-entry-id" id="index-implementation-differences"></a>
+<a class="index-entry-id" id="index-differences-in-implementation"></a>
+<a class="index-entry-id" id="index-incompatibilities-with-AT_0026T-troff"></a>
+
+<p>GNU <code class="code">troff</code> has a number of features that cause incompatibilities
+with documents written for other versions of <code class="code">troff</code>.  Some GNU
+extensions to <code class="code">troff</code> have become supported by other
+implementations.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Safer-Mode.html" accesskey="1">Safer Mode</a></li>
+<li><a href="Compatibility-Mode.html" accesskey="2">Compatibility Mode</a></li>
+<li><a href="Other-Differences.html" accesskey="3">Other Differences</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Indented-regions-in-ms.html Added

@@ -0,0 +1,112 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Indented regions in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Indented regions in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Indented regions in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="ms-keeps-and-displays.html" rel="next" title="ms keeps and displays">
+<link href="Lists-in-ms.html" rel="prev" title="Lists in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Indented-regions-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-keeps-and-displays.html" accesskey="n" rel="next">Keeps, boxed keeps, and displays</a>, Previous: <a href="Lists-in-ms.html" accesskey="p" rel="prev">Lists</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Indented-regions">4.6.5.7 Indented regions</h4>
+
+<p>You may need to indent a region of text while otherwise formatting it
+normally.  Indented regions can be nested; you can change <code class="code">\nPI</code>
+before each call to vary the amount of inset.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RS</code></strong><a class="copiable-link" href='#index-_002eRS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RS-_005bms_005d"></a>
+<p>Begin a region where headings, paragraphs, and displays are indented
+(further) by the amount stored in the <code class="code">PI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RE</code></strong><a class="copiable-link" href='#index-_002eRE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RE-_005bms_005d"></a>
+<p>End the (next) most recent indented region.
+</p></dd></dl>
+
+<p>This feature enables you to easily line up text under hanging and
+indented paragraphs.
+<a class="index-entry-id" id="index-ms-macros_002c-nested-lists"></a>
+<a class="index-entry-id" id="index-nested-lists-_005bms_005d"></a>
+For example, you may wish to structure lists hierarchically.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP \bu 2
+Lawyers:
+.RS
+.IP \bu
+Dewey,
+.IP \bu
+Cheatham,
+and
+.IP \bu
+and Howe.
+.RE
+.IP \bu
+Guns
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">&bull; Lawyers:
+
+  &bull;  Dewey,
+
+  &bull;  Cheatham, and
+
+  &bull;  Howe.
+
+&bull; Guns
+</pre></div></div>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Indexing.html Added

@@ -0,0 +1,58 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Indexing (The GNU Troff Manual)</title>
+
+<meta name="description" content="Indexing (The GNU Troff Manual)">
+<meta name="keywords" content="Indexing (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Document-Formats.html" rel="next" title="Document Formats">
+<link href="Table-of-Contents.html" rel="prev" title="Table of Contents">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Indexing">
+<div class="nav-panel">
+<p>
+Next: <a href="Document-Formats.html" accesskey="n" rel="next">Document Formats</a>, Previous: <a href="Table-of-Contents.html" accesskey="p" rel="prev">Table of Contents</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Indexing-1">3.2.8 Indexing</h4>
+<a class="index-entry-id" id="index-index_002c-in-macro-package"></a>
+
+<a class="index-entry-id" id="index-makeindex"></a>
+<p>An index is similar to a table of contents, in that entry labels and
+locations must be collected, but poses a greater challenge because it
+needs to be sorted before it is output.  Here, processing the document
+in multiple passes is inescapable, and tools like the <code class="code">makeindex</code>
+program are necessary.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Input-Conventions.html Added

@@ -0,0 +1,171 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Input Conventions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Input Conventions (The GNU Troff Manual)">
+<meta name="keywords" content="Input Conventions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Input-Encodings.html" rel="prev" title="Input Encodings">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Input-Conventions">
+<div class="nav-panel">
+<p>
+Previous: <a href="Input-Encodings.html" accesskey="p" rel="prev">Input Encodings</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Input-Conventions-1">5.1.10 Input Conventions</h4>
+<a class="index-entry-id" id="index-input-conventions"></a>
+<a class="index-entry-id" id="index-conventions-for-input"></a>
+
+<p>Since GNU <code class="code">troff</code> fills text automatically, it is common practice
+in the <code class="code">roff</code> language to avoid visual composition of text in input
+files: the esthetic appeal of the formatted output is what matters.
+Therefore, <code class="code">roff</code> input should be arranged such that it is easy for
+authors and maintainers to compose and develop the document, understand
+the syntax of <code class="code">roff</code> requests, macro calls, and preprocessor
+languages used, and predict the behavior of the formatter.  Several
+traditions have accrued in service of these goals.
+</p>
+<ul class="itemize mark-bullet">
+<li>Follow sentence endings in the input with newlines to ease their
+recognition (see <a class="pxref" href="Sentences.html">Sentences</a>).  It is frequently convenient to end
+text lines after colons and semicolons as well, as these typically
+precede independent clauses.  Consider doing so after commas; they often
+occur in lists that become easy to scan when itemized by line, or
+constitute supplements to the sentence that are added, deleted, or
+updated to clarify it.  Parenthetical and quoted phrases are also good
+candidates for placement on text lines by themselves.
+
+</li><li>Set your text editor&rsquo;s line length to 72 characters or
+fewer.<a class="footnote" id="DOCF32" href="groff.html_fot.html#FOOT32"><sup>32</sup></a>
+This limit, combined with the previous item of advice, makes it less
+common that an input line will wrap in your text editor, and thus will
+help you perceive excessively long constructions in your text.  Recall
+that natural languages originate in speech, not writing, and that
+punctuation is correlated with pauses for breathing and changes in
+prosody.
+
+</li><li>Use <code class="code">\&amp;</code> after &lsquo;<samp class="samp">!</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;, and &lsquo;<samp class="samp">.</samp>&rsquo; if they are
+followed by space, tab, or newline characters and don&rsquo;t end a sentence.
+
+</li><li>In filled text lines, use <code class="code">\&amp;</code> before &lsquo;<samp class="samp">.</samp>&rsquo; and &lsquo;<samp class="samp">'</samp>&rsquo; if they
+are preceded by space, so that reflowing the input doesn&rsquo;t turn them
+into control lines.
+
+</li><li>Do not use spaces to perform indentation or align columns of a table.
+Leading spaces are reliable when text is not being filled.
+
+</li><li>Comment your document.  It is never too soon to apply comments to
+record information of use to future document maintainers (including your
+future self).  We thus introduce another escape sequence, <code class="code">\&quot;</code>,
+which causes GNU <code class="code">troff</code> to ignore the remainder of the input line.
+
+</li><li>Use the empty request&mdash;a control character followed immediately by a
+newline&mdash;to visually manage separation of material in input files.
+Many of the <code class="code">groff</code> project&rsquo;s own documents use an empty request
+between sentences, after macro definitions, and where a break is
+expected, and two empty requests between paragraphs or other requests or
+macro calls that will introduce vertical space into the document.
+
+<p>You can combine the empty request with the comment escape sequence to
+include whole-line comments in your document, and even &ldquo;comment out&rdquo;
+sections of it.
+</p></li></ul>
+
+<p>We conclude this section with an example sufficiently long to illustrate
+most of the above suggestions in practice.  For the purpose of fitting
+the example between the margins of this manual with the font used for
+its typeset version, we have shortened the input line length to 56
+columns.  As before, an arrow &rarr; indicates a tab character.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.\&quot;   nroff this_file.roff | less
+.\&quot;   groff -T ps this_file.roff &gt; this_file.ps
+&rarr;The theory of relativity is intimately connected with
+the theory of space and time.
+.
+I shall therefore begin with a brief investigation of
+the origin of our ideas of space and time,
+although in doing so I know that I introduce a
+controversial subject.  \&quot; remainder of paragraph elided
+.
+.
+
+&rarr;The experiences of an individual appear to us arranged
+in a series of events;
+in this series the single events which we remember
+appear to be ordered according to the criterion of
+\lqearlier\rq and \lqlater\rq, \&quot; punct swapped
+which cannot be analysed further.
+.
+There exists,
+therefore,
+for the individual,
+an I-time,
+or subjective time.
+.
+This itself is not measurable.
+.
+I can,
+indeed,
+associate numbers with the events,
+in such a way that the greater number is associated with
+the later event than with an earlier one;
+but the nature of this association may be quite
+arbitrary.
+.
+This association I can define by means of a clock by
+comparing the order of events furnished by the clock
+with the order of a given series of events.
+.
+We understand by a clock something which provides a
+series of events which can be counted,
+and which has other properties of which we shall speak
+later.
+.\&quot; Albert Einstein, _The Meaning of Relativity_, 1922
+</pre></div>
+</td></tr></table>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Input-Encodings.html">Input Encodings</a>, Up: <a href="Text.html">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Input-Encodings.html Added

@@ -0,0 +1,154 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Input Encodings (The GNU Troff Manual)</title>
+
+<meta name="description" content="Input Encodings (The GNU Troff Manual)">
+<meta name="keywords" content="Input Encodings (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Input-Conventions.html" rel="next" title="Input Conventions">
+<link href="Macro-Packages.html" rel="prev" title="Macro Packages">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Input-Encodings">
+<div class="nav-panel">
+<p>
+Next: <a href="Input-Conventions.html" accesskey="n" rel="next">Input Conventions</a>, Previous: <a href="Macro-Packages.html" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Input-Encodings-1">5.1.9 Input Encodings</h4>
+
+<p>The <code class="command">groff</code> command&rsquo;s <samp class="option">-k</samp> option calls the
+<code class="command">preconv</code> preprocessor to perform input character encoding
+conversions.  Input to the GNU <code class="code">troff</code> formatter itself, on the
+other hand, must be in one of two encodings it can recognize.
+</p>
+<dl class="table">
+<dt id='index-encoding_002c-input_002c-EBCDIC'><span><code class="code">cp1047</code><a class="copiable-link" href='#index-encoding_002c-input_002c-EBCDIC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EBCDIC_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-EBCDIC"></a>
+<a class="index-entry-id" id="index-encoding_002c-input_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-code-page-1047_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-code-page-1047"></a>
+<a class="index-entry-id" id="index-IBM-code-page-1047-input-encoding"></a>
+<a class="index-entry-id" id="index-cp1047_002etmac"></a>
+<p>The code page 1047 input encoding works only on <abbr class="acronym">EBCDIC</abbr>
+platforms (and conversely, the other input encodings don&rsquo;t work with
+<abbr class="acronym">EBCDIC</abbr>); the file <samp class="file">cp1047.tmac</samp> is loaded at startup.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029'><span><code class="code">latin1</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d1-_0028ISO-8859_002d1_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d1-_0028ISO-8859_002d1_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d1-_0028Latin_002d1_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d1-_0028ISO-8859_002d1_0029"></a>
+<a class="index-entry-id" id="index-latin1_002etmac"></a>
+<p>ISO <span class="w-nolinebreak-text">Latin-1</span>, an encoding for Western European languages, is the
+default input encoding on non-<abbr class="acronym">EBCDIC</abbr> platforms; the file
+<samp class="file">latin1.tmac</samp> is loaded at startup.
+</p></dd>
+</dl>
+
+<p>Any document that is encoded in ISO 646:1991 (a descendant of USAS
+<span class="w-nolinebreak-text">X3.4-1968</span> or &ldquo;US-ASCII&rdquo;), or, equivalently, uses only code points
+from the &ldquo;C0 Controls&rdquo; and &ldquo;Basic Latin&rdquo; parts of the Unicode
+character set is also a valid ISO <span class="w-nolinebreak-text">Latin-1</span> document; the standards
+are interchangeable in their first 128 code points.<a class="footnote" id="DOCF30" href="groff.html_fot.html#FOOT30"><sup>30</sup></a>
+</p>
+<p>Other encodings are supported by means of macro packages.
+</p>
+<dl class="table">
+<dt id='index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029'><span><code class="code">latin2</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d2-_0028ISO-8859_002d2_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d2-_0028ISO-8859_002d2_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d2-_0028Latin_002d2_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d2-_0028ISO-8859_002d2_0029"></a>
+<a class="index-entry-id" id="index-latin2_002etmac"></a>
+<p>To use ISO <span class="w-nolinebreak-text">Latin-2</span>, an encoding for Central and Eastern European
+languages, invoke &lsquo;<samp class="samp">.mso&nbsp;latin2.tmac</samp>&rsquo; at the beginning of your
+document or supply &lsquo;<samp class="samp">-mlatin2</samp>&rsquo; as a command-line argument to
+<code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029'><span><code class="code">latin5</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d5-_0028ISO-8859_002d9_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d5-_0028ISO-8859_002d9_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d9-_0028Latin_002d5_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d5-_0028ISO-8859_002d9_0029"></a>
+<a class="index-entry-id" id="index-latin5_002etmac"></a>
+<p>To use ISO <span class="w-nolinebreak-text">Latin-5</span>, an encoding for the Turkish language, invoke
+&lsquo;<samp class="samp">.mso&nbsp;latin5.tmac</samp>&rsquo; at the beginning of your document or
+supply &lsquo;<samp class="samp">-mlatin5</samp>&rsquo; as a command-line argument to <code class="code">groff</code>.
+</p>
+</dd>
+<dt id='index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029'><span><code class="code">latin9</code><a class="copiable-link" href='#index-encoding_002c-input_002c-Latin_002d9-_0028ISO-8859_002d15_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Latin_002d9-_0028ISO-8859_002d15_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-ISO-8859_002d15-_0028Latin_002d9_0029_002c-input-encoding"></a>
+<a class="index-entry-id" id="index-input-encoding_002c-Latin_002d9-_0028ISO-8859_002d15_0029"></a>
+<a class="index-entry-id" id="index-latin9_002etmac"></a>
+<p>ISO <span class="w-nolinebreak-text">Latin-9</span> succeeds <span class="w-nolinebreak-text">Latin-1</span>; it includes a Euro sign and better
+glyph coverage for French.  To use this encoding, invoke &lsquo;<samp class="samp">.mso&nbsp;latin9.tmac</samp>&rsquo; at the beginning of your document or supply
+&lsquo;<samp class="samp">-mlatin9</samp>&rsquo; as a command-line argument to <code class="code">groff</code>.
+</p></dd>
+</dl>
+
+<p>Some characters from an input encoding may not be available with a
+particular output driver, or their glyphs may not have representation in
+the font used.  For terminal devices, fallbacks are defined, like
+&lsquo;<samp class="samp">EUR</samp>&rsquo; for the Euro sign and &lsquo;<samp class="samp">(C)</samp>&rsquo; for the copyright sign.  For
+typesetter devices, you may need to &ldquo;mount&rdquo; fonts that support glyphs
+required by the document.  See <a class="xref" href="Font-Positions.html">Font Positions</a>.
+</p>
+<a class="index-entry-id" id="index-freeeuro_002epfa"></a>
+<a class="index-entry-id" id="index-ec_002etmac"></a>
+<p>Because a Euro glyph was not historically defined in PostScript fonts,
+<code class="code">groff</code> comes with a font called <samp class="file">freeeuro.pfa</samp> that provides
+the Euro in several styles.  Standard PostScript fonts contain the
+glyphs from <span class="w-nolinebreak-text">Latin-5</span> and <span class="w-nolinebreak-text">Latin-9</span> that <span class="w-nolinebreak-text">Latin-1</span> lacks, so these
+encodings are supported for the <samp class="option">ps</samp> and <samp class="option">pdf</samp> output
+devices as <code class="code">groff</code> ships, while <span class="w-nolinebreak-text">Latin-2</span> is not.
+</p>
+<p>Unicode supports characters from all other input encodings; the
+<samp class="option">utf8</samp> output driver for terminals therefore does as well.  The
+DVI output driver supports the <span class="w-nolinebreak-text">Latin-2</span> and <span class="w-nolinebreak-text">Latin-9</span> encodings if
+the command-line option <samp class="option">-mec</samp> is used as well.  <a class="footnote" id="DOCF31" href="groff.html_fot.html#FOOT31"><sup>31</sup></a>
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Input-Conventions.html">Input Conventions</a>, Previous: <a href="Macro-Packages.html">Macro Packages</a>, Up: <a href="Text.html">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Input-Line-Traps.html Added

@@ -0,0 +1,185 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Input Line Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Input Line Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Input Line Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Traps.html" rel="up" title="Traps">
+<link href="Blank-Line-Traps.html" rel="next" title="Blank Line Traps">
+<link href="Diversion-Traps.html" rel="prev" title="Diversion Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Input-Line-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="Blank-Line-Traps.html" accesskey="n" rel="next">Blank Line Traps</a>, Previous: <a href="Diversion-Traps.html" accesskey="p" rel="prev">Diversion Traps</a>, Up: <a href="Traps.html" accesskey="u" rel="up">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Input-Line-Traps-1">5.28.2 Input Line Traps</h4>
+<a class="index-entry-id" id="index-input-line-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-input-line"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eit"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.it</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eit'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-it"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eitc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.itc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span> <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002eitc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-itc"></a>
+<a class="index-entry-id" id="index-setting-input-line-trap-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-input-line-trap_002c-setting-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-input-line_002c-setting-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-clearing-input-line-trap-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-input-line-trap_002c-clearing-_0028it_002c-itc_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-input-line_002c-clearing-_0028it_002c-itc_0029"></a>
+<p>Set an input line trap, calling macro <var class="var">name</var> after processing the
+next <var class="var">n</var>&nbsp;productive input lines (recall <a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>).  Any existing input line trap in the
+environment is replaced.  Without arguments, <code class="code">it</code> and <code class="code">itc</code>
+clear any input line trap that has not yet sprung.
+</p>
+<p>Consider a macro &lsquo;<samp class="samp">.ST <var class="var">s n</var></samp>&rsquo; which sets the next
+<var class="var">n</var>&nbsp;input lines in the font style&nbsp;<var class="var">s</var>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de ST \&quot; Use style $1 for next $2 text lines.
+.  it \\$2 ES
+.  ft \\$1
+..
+.de ES \&quot; end ST
+.  ft R
+..
+.ST I 1
+oblique
+face
+.ST I 1
+oblique\c
+face
+    &rArr; <i class="i">oblique</i> face <i class="i">oblique</i>face &nbsp;<span class="r">(second &ldquo;face&rdquo; upright)</span>
+</pre></div></div>
+
+<a class="index-entry-id" id="index-input-line-traps-and-interrupted-lines-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-interrupted-lines-and-input-line-traps-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-input-line_002c-and-interrupted-lines-_0028itc_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-interrupted_002c-and-input-line-traps-_0028itc_0029"></a>
+<p>Unlike the <code class="code">ce</code> and <code class="code">rj</code> requests, <code class="code">it</code> counts lines
+interrupted with the <code class="code">\c</code> escape sequence separately (see <a class="pxref" href="Line-Continuation.html">Line Continuation</a>); <code class="code">itc</code> does not.  To see the difference, let&rsquo;s
+change the previous example to use <code class="code">itc</code> instead.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted"><span class="r">&hellip;</span>
+.  itc \\$2 ES
+<span class="r">&hellip;</span>
+    &rArr; <i class="i">oblique</i> face <i class="i">obliqueface</i> &nbsp;<span class="r">(second &ldquo;face&rdquo; oblique)</span>
+</pre></div></div>
+
+<p>You can think of the <code class="code">ce</code> and <code class="code">rj</code> requests as implicitly
+creating an input line trap with <code class="code">itc</code> that schedules a break when
+the trap is sprung.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de BR
+.  br
+.  <i class="slanted">internal: disable centering-without-filling</i>
+..
+.
+.de ce
+.  if \\n.br .br
+.  itc \\$1 BR
+.  <i class="slanted">internal: enable centering-without-filling</i>
+..
+</pre></div></div>
+
+<p>Let us consider in more detail the sorts of input lines that are or are
+not &ldquo;productive&rdquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Trap
+TRAP SPRUNG
+..
+.de Mac
+.if r a \l'5n'
+..
+.it 2 Trap
+.
+foo
+.Mac
+bar
+baz
+.it 1 Trap
+.sp \&quot; moves, but does not write or draw
+qux
+.itc 1 Trap
+\h'5n'\c \&quot; moves, but does not write or draw
+jat
+</pre></div></div>
+
+<p>When &lsquo;<samp class="samp">Trap</samp>&rsquo; gets called depends on whether the &lsquo;<samp class="samp">a</samp>&rsquo; register is
+defined; the control line with the <code class="code">if</code> request may or may not
+produce written output.  We also see that the spacing request <code class="code">sp</code>,
+while certainly affecting the output, does not spring the input line
+trap.  Similarly, the horizontal motion escape sequence <code class="code">\h</code> also
+affected the output, but was not &ldquo;written&rdquo;.  Observe that we had to
+follow it with <code class="code">\c</code> and use <code class="code">itc</code> to prevent the newline at
+the end of the text line from causing a word break, which, like an
+ordinary space character, counts as written output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tascii input-trap-example.groff
+    &rArr; foo bar TRAP SPRUNG baz
+    &rArr;
+    &rArr; qux TRAP SPRUNG      jat TRAP SPRUNG
+$ groff -Tascii -ra1 input-trap-example.groff
+    &rArr; foo _____ TRAP SPRUNG bar baz
+    &rArr;
+    &rArr; qux TRAP SPRUNG      jat TRAP SPRUNG
+</pre></div></div>
+</dd></dl>
+
+<p>Input line traps are associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>); switching to another environment suspends the
+current input line trap, and going back resumes it, restoring the count
+of qualifying lines enumerated in that environment.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Blank-Line-Traps.html">Blank Line Traps</a>, Previous: <a href="Diversion-Traps.html">Diversion Traps</a>, Up: <a href="Traps.html">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Installation.html Added

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Installation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Installation (The GNU Troff Manual)">
+<meta name="keywords" content="Installation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Conventions-Used-in-This-Manual.html" rel="next" title="Conventions Used in This Manual">
+<link href="Output-Device-Intro.html" rel="prev" title="Output Device Intro">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Installation">
+<div class="nav-panel">
+<p>
+Next: <a href="Conventions-Used-in-This-Manual.html" accesskey="n" rel="next">Conventions Used in This Manual</a>, Previous: <a href="Output-Device-Intro.html" accesskey="p" rel="prev">Output Devices</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Installation-1">1.7 Installation</h3>
+<a class="index-entry-id" id="index-installation"></a>
+
+<p>Locate installation instructions in the files <samp class="file">INSTALL</samp>,
+<samp class="file">INSTALL.extra</samp>, and <samp class="file">INSTALL.REPO</samp> in the <code class="code">groff</code> source
+distribution.  Being a GNU project, <code class="code">groff</code> supports the familiar
+&lsquo;<samp class="samp">./configure &amp;&amp; make</samp>&rsquo; command sequence.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Intermediate-Output-Examples.html Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Interpolating-Registers.html Added

@@ -0,0 +1,99 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Interpolating Registers (The GNU Troff Manual)</title>
+
+<meta name="description" content="Interpolating Registers (The GNU Troff Manual)">
+<meta name="keywords" content="Interpolating Registers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Registers.html" rel="up" title="Registers">
+<link href="Auto_002dincrement.html" rel="next" title="Auto-increment">
+<link href="Setting-Registers.html" rel="prev" title="Setting Registers">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Interpolating-Registers">
+<div class="nav-panel">
+<p>
+Next: <a href="Auto_002dincrement.html" accesskey="n" rel="next">Auto-increment</a>, Previous: <a href="Setting-Registers.html" accesskey="p" rel="prev">Setting Registers</a>, Up: <a href="Registers.html" accesskey="u" rel="up">Registers</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Interpolating-Registers-1">5.8.2 Interpolating Registers</h4>
+<a class="index-entry-id" id="index-interpolating-registers-_0028_005cn_0029"></a>
+<a class="index-entry-id" id="index-registers_002c-interpolating-_0028_005cn_0029"></a>
+
+<p>Register contents are interpolated with the <code class="code">\n</code> escape sequence.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cni"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n</code><span class="r"><i class="slanted">i</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cni'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_0028id"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n(</code><span class="r"><i class="slanted">id</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_0028id'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005bident_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\n</code><span class="r"><i class="slanted">ident</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cn_005bident_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nested-assignments"></a>
+<a class="index-entry-id" id="index-assignments_002c-nested"></a>
+<a class="index-entry-id" id="index-indirect-assignments"></a>
+<a class="index-entry-id" id="index-assignments_002c-indirect"></a>
+<p>Interpolate register with name <var class="var">ident</var> (one-character
+name&nbsp;<var class="var">i</var>, two-character name <var class="var">id</var>).  <code class="code">\n</code> is
+interpreted even in copy mode (see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).  If the register is
+undefined, it is created and assigned a value of&nbsp;&lsquo;<samp class="samp">0</samp>&rsquo;, that
+value is interpolated, and a warning in category &lsquo;<samp class="samp">reg</samp>&rsquo; is emitted.
+See <a class="xref" href="Warnings.html">Warnings</a>, for information about the enablement and suppression of
+warnings.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 5
+.nr as \na+\na
+\n(as
+    &rArr; 10
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a1 5
+.nr ab 6
+.ds str b
+.ds num 1
+\na\nnum
+    &rArr; 5
+\na\*str
+    &rArr; 6
+</pre></div></div>
+</dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Introduction.html Added

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Introduction (The GNU Troff Manual)</title>
+
+<meta name="description" content="Introduction (The GNU Troff Manual)">
+<meta name="keywords" content="Introduction (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Invoking-groff.html" rel="next" title="Invoking groff">
+<link href="index.html" rel="prev" title="Top">
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="Introduction">
+<div class="nav-panel">
+<p>
+Next: <a href="Invoking-groff.html" accesskey="n" rel="next">Invoking <code class="code">groff</code></a>, Previous: <a href="index.html" accesskey="p" rel="prev">GNU <code class="code">troff</code></a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="Introduction-1">1 Introduction</h2>
+<a class="index-entry-id" id="index-introduction"></a>
+
+<p>GNU <code class="code">roff</code> (or <code class="code">groff</code>) is a programming system for
+typesetting documents.  It is highly flexible and has been used
+extensively for over thirty years.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="Background.html" accesskey="1">Background</a></li>
+<li><a href="What-Is-groff_003f.html" accesskey="2">What Is <code class="code">groff</code>?</a></li>
+<li><a href="groff-Capabilities.html" accesskey="3"><code class="code">groff</code> Capabilities</a></li>
+<li><a href="Macro-Package-Intro.html" accesskey="4">Macro Packages</a></li>
+<li><a href="Preprocessor-Intro.html" accesskey="5">Preprocessors</a></li>
+<li><a href="Output-Device-Intro.html" accesskey="6">Output Devices</a></li>
+<li><a href="Installation.html" accesskey="7">Installation</a></li>
+<li><a href="Conventions-Used-in-This-Manual.html" accesskey="8">Conventions Used in This Manual</a></li>
+<li><a href="Credits.html" accesskey="9">Credits</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Invocation-Examples.html Added

@@ -0,0 +1,120 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Invocation Examples (The GNU Troff Manual)</title>
+
+<meta name="description" content="Invocation Examples (The GNU Troff Manual)">
+<meta name="keywords" content="Invocation Examples (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Paper-Format.html" rel="prev" title="Paper Format">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Invocation-Examples">
+<div class="nav-panel">
+<p>
+Previous: <a href="Paper-Format.html" accesskey="p" rel="prev">Paper Format</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Invocation-Examples-1">2.6 Invocation Examples</h3>
+<a class="index-entry-id" id="index-invocation-examples"></a>
+<a class="index-entry-id" id="index-examples-of-invocation"></a>
+
+<p><code class="code">roff</code> systems are best known for formatting man pages.  Once a
+<code class="command">man</code> librarian program has located a man page, it may execute
+a <code class="code">groff</code> command much like the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -t -man -Tutf8 /usr/share/man/man1/groff.1
+</pre></div></div>
+
+<p>The librarian will also pipe the output through a pager, which might not
+interpret the SGR terminal escape sequences <code class="command">groff</code> emits for
+boldface, underlining, or italics; see the <cite class="cite">grotty<span class="r">(1)</span></cite> man page
+for a discussion.
+</p>
+<p>To process a <code class="code">roff</code> input file using the preprocessors
+<code class="command">gtbl</code> and <code class="command">gpic</code> and the <samp class="file">me</samp> macro package in the
+way to which AT&amp;T <code class="code">troff</code> users were accustomed, one would type (or
+script) a pipeline.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">gpic foo.me | gtbl | gtroff -me -Tutf8 | grotty
+</pre></div></div>
+
+<p>Using <code class="command">groff</code>, this pipe can be shortened to an equivalent
+command.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -p -t -me -T utf8 foo.me
+</pre></div></div>
+
+<p>An even easier way to do this is to use <code class="command">grog</code> to guess the
+preprocessor and macro options and execute the result by using the
+command substitution feature of the shell.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$(grog -Tutf8 foo.me)
+</pre></div></div>
+
+<p>Each command-line option to a postprocessor must be specified with any
+required leading dashes &lsquo;<samp class="samp">-</samp>&rsquo;
+because <code class="command">groff</code> passes the arguments as-is to the postprocessor;
+this permits arbitrary arguments to be transmitted.  For example, to
+pass a title to the <code class="command">gxditview</code> postprocessor,
+the shell commands
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -X -P -title -P 'trial run' mydoc.t
+</pre></div></div>
+
+<p>and
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -X -Z mydoc.t | gxditview -title 'trial run' -
+</pre></div></div>
+
+<p>are equivalent.
+</p>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Paper-Format.html">Paper Format</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Invoking-Requests.html Added

@@ -0,0 +1,143 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Invoking Requests (The GNU Troff Manual)</title>
+
+<meta name="description" content="Invoking Requests (The GNU Troff Manual)">
+<meta name="keywords" content="Invoking Requests (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Formatter-Instructions.html" rel="up" title="Formatter Instructions">
+<link href="Calling-Macros.html" rel="next" title="Calling Macros">
+<link href="Control-Characters.html" rel="prev" title="Control Characters">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Invoking-Requests">
+<div class="nav-panel">
+<p>
+Next: <a href="Calling-Macros.html" accesskey="n" rel="next">Calling Macros</a>, Previous: <a href="Control-Characters.html" accesskey="p" rel="prev">Control Characters</a>, Up: <a href="Formatter-Instructions.html" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Invoking-Requests-1">5.6.2 Invoking Requests</h4>
+<a class="index-entry-id" id="index-invoking-requests"></a>
+<a class="index-entry-id" id="index-requests_002c-invoking"></a>
+
+<p>A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.  The invocation of an
+unrecognized request is interpreted as a macro call.  Defining a macro
+with the same name as a request replaces the request.  Deleting a
+request name with the <code class="code">rm</code> request makes it unavailable.  The
+<code class="code">als</code> request can alias requests, permitting them to be wrapped or
+non-destructively replaced.  See <a class="xref" href="Strings.html">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-request-arguments"></a>
+<a class="index-entry-id" id="index-arguments-to-requests"></a>
+<a class="index-entry-id" id="index-tabs_002c-and-macro-arguments"></a>
+<a class="index-entry-id" id="index-macro-arguments_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-arguments-to-macros_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-tabs_002c-and-request-arguments"></a>
+<a class="index-entry-id" id="index-request-arguments_002c-and-tabs"></a>
+<a class="index-entry-id" id="index-arguments-to-requests_002c-and-tabs"></a>
+<p>There is no inherent limit on argument length or quantity.  Most
+requests take one or more arguments, and ignore any they do not expect.
+A request may be separated from its arguments by tabs or spaces, but
+only spaces can separate an argument from its successor.  Only one
+between arguments is necessary; any excess is ignored.  GNU <code class="code">troff</code>
+does not allow tabs for argument separation.<a class="footnote" id="DOCF43" href="groff.html_fot.html#FOOT43"><sup>43</sup></a>
+</p>
+<p>Generally, a space <em class="emph">within</em> a request argument is not relevant, not
+meaningful, or is supported by bespoke provisions, as with the <code class="code">tl</code>
+request&rsquo;s delimiters (see <a class="pxref" href="Page-Layout.html">Page Layout</a>).  Some requests, like
+<code class="code">ds</code>, interpret the remainder of the control line as a single
+argument.  See <a class="xref" href="Strings.html">Strings</a>.
+</p>
+<a class="index-entry-id" id="index-structuring-source-code-of-documents-or-macro-packages"></a>
+<a class="index-entry-id" id="index-documents_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-macro-package_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-package_002c-package_002c-structuring-the-source-of"></a>
+<a class="index-entry-id" id="index-indentation_002c-of-roff-source-code"></a>
+<p>Spaces and tabs immediately after a control character are ignored.
+Commonly, authors structure the source of documents or macro files with
+them.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
+.
+.
+.de right-align
+.&rarr;if \\n.br \
+.&rarr;&rarr;br
+.&rarr;rj \\$1
+..
+</pre></div></div>
+
+<a class="index-entry-id" id="index-blank-line-trap-_0028blm_0029"></a>
+<a class="index-entry-id" id="index-blank-line-macro-_0028blm_0029-1"></a>
+<p>If you assign an empty blank line trap, you can separate macro
+definitions (or any input lines) with blank lines.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de do-nothing
+..
+.blm do-nothing  \&quot; activate blank line trap
+
+.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
+
+
+.de right-align
+.&rarr;if \\n.br \
+.&rarr;&rarr;br
+.&rarr;rj \\$1
+..
+
+.blm             \&quot; deactivate blank line trap
+</pre></div></div>
+
+<p>See <a class="xref" href="Blank-Line-Traps.html">Blank Line Traps</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Calling-Macros.html">Calling Macros</a>, Previous: <a href="Control-Characters.html">Control Characters</a>, Up: <a href="Formatter-Instructions.html">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Invoking-groff.html Added

@@ -0,0 +1,82 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Invoking groff (The GNU Troff Manual)</title>
+
+<meta name="description" content="Invoking groff (The GNU Troff Manual)">
+<meta name="keywords" content="Invoking groff (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Tutorial-for-Macro-Users.html" rel="next" title="Tutorial for Macro Users">
+<link href="Introduction.html" rel="prev" title="Introduction">
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="Invoking-groff">
+<div class="nav-panel">
+<p>
+Next: <a href="Tutorial-for-Macro-Users.html" accesskey="n" rel="next">Tutorial for Macro Users</a>, Previous: <a href="Introduction.html" accesskey="p" rel="prev">Introduction</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="Invoking-groff-1">2 Invoking <code class="code">groff</code></h2>
+<a class="index-entry-id" id="index-invoking-groff"></a>
+<a class="index-entry-id" id="index-groff-invocation"></a>
+
+<p>This chapter focuses on how to invoke the <code class="code">groff</code> front end.  This
+front end takes care of the details of constructing the pipeline among
+the preprocessors, <code class="code">gtroff</code> and the postprocessor.
+</p>
+<p>It has become a tradition that GNU programs get the prefix &lsquo;<samp class="samp">g</samp>&rsquo; to
+distinguish them from their original counterparts provided by the host
+(see <a class="pxref" href="Environment.html">Environment</a>).  Thus, for example, <code class="code">geqn</code> is GNU
+<code class="code">eqn</code>.  On operating systems like GNU/Linux or the Hurd, which
+don&rsquo;t contain proprietary versions of <code class="code">troff</code>, and on
+MS-DOS/MS-Windows, where <code class="code">troff</code> and associated programs are not
+available at all, this prefix is omitted since GNU <code class="code">troff</code> is the
+only incarnation of <code class="code">troff</code> used.  Exception: &lsquo;<samp class="samp">groff</samp>&rsquo; is never
+replaced by &lsquo;<samp class="samp">roff</samp>&rsquo;.
+</p>
+<p>In this document, we consequently say &lsquo;<samp class="samp">gtroff</samp>&rsquo; when talking about
+the GNU <code class="code">troff</code> program.  All other implementations of <code class="code">troff</code> are called <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, which is the common origin of almost all <code class="code">troff</code>
+implementations<a class="footnote" id="DOCF4" href="groff.html_fot.html#FOOT4"><sup>4</sup></a> (with more or less compatible changes).  Similarly, we say
+&lsquo;<samp class="samp">gpic</samp>&rsquo;, &lsquo;<samp class="samp">geqn</samp>&rsquo;, and so on.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="Groff-Options.html" accesskey="1">Options</a></li>
+<li><a href="Environment.html" accesskey="2">Environment</a></li>
+<li><a href="Macro-Directories.html" accesskey="3">Macro Directories</a></li>
+<li><a href="Font-Directories.html" accesskey="4">Font Directories</a></li>
+<li><a href="Paper-Format.html" accesskey="5">Paper Format</a></li>
+<li><a href="Invocation-Examples.html" accesskey="6">Invocation Examples</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Italic-Corrections.html Added

@@ -0,0 +1,96 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Italic Corrections (The GNU Troff Manual)</title>
+
+<meta name="description" content="Italic Corrections (The GNU Troff Manual)">
+<meta name="keywords" content="Italic Corrections (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Dummy-Characters.html" rel="next" title="Dummy Characters">
+<link href="Ligatures-and-Kerning.html" rel="prev" title="Ligatures and Kerning">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Italic-Corrections">
+<div class="nav-panel">
+<p>
+Next: <a href="Dummy-Characters.html" accesskey="n" rel="next">Dummy Characters</a>, Previous: <a href="Ligatures-and-Kerning.html" accesskey="p" rel="prev">Ligatures and Kerning</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Italic-Corrections-1">5.19.9 Italic Corrections</h4>
+
+<p>When typesetting adjacent glyphs from typefaces of different slants, the
+space between them may require adjustment.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002f-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\/</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002f-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002f"></a>
+<a class="index-entry-id" id="index-italic-correction-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-correction_002c-italic-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-correction-between-oblique-and-upright-glyph-_0028_005c_002f_002c-_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-roman-glyph_002c-correction-after-italic-glyph-_0028_005c_002f_0029"></a>
+<a class="index-entry-id" id="index-upright-glyph_002c-correction-after-oblique-glyph-_0028_005c_002f_0029"></a>
+<p>Apply an <em class="dfn">italic correction</em>: modify the spacing of the preceding
+glyph so that the distance between it and the following glyph is correct
+if the latter is of upright shape.  For example, if an
+italic&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; is followed immediately by a roman right
+parenthesis, then in many fonts the top right portion of
+the&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; overlaps the top left of the right parenthesis, which
+is ugly.  Use this escape sequence whenever an oblique glyph is
+immediately followed by an upright glyph without any intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\,</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002c"></a>
+<a class="index-entry-id" id="index-left-italic-correction-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-correction_002c-left-italic-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-correction-between-upright-and-oblique-glyph-_0028_005c_002f_002c-_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-roman-glyph_002c-correction-before-italic-glyph-_0028_005c_002c_0029"></a>
+<a class="index-entry-id" id="index-upright-glyph_002c-correction-before-oblique-glyph-_0028_005c_002c_0029"></a>
+<p>Apply a <em class="dfn">left italic correction</em>: modify the spacing of the
+following glyph so that the distance between it and the preceding
+glyph is correct if the latter is of upright shape.  For example,
+if a roman left parenthesis is immediately followed by an
+italic&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo;, then in many fonts the bottom left portion of
+the&nbsp;&lsquo;<samp class="samp">f</samp>&rsquo; overlaps the bottom of the left parenthesis, which is
+ugly.  Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
+</p></dd></dl>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Language-Concepts.html Added

@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Language Concepts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Language Concepts (The GNU Troff Manual)">
+<meta name="keywords" content="Language Concepts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="gtroff-Output.html" rel="up" title="gtroff Output">
+<link href="Command-Reference.html" rel="next" title="Command Reference">
+<link href="gtroff-Output.html" rel="prev" title="gtroff Output">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Language-Concepts">
+<div class="nav-panel">
+<p>
+Next: <a href="Command-Reference.html" accesskey="n" rel="next">Command Reference</a>, Previous: <a href="gtroff-Output.html" accesskey="p" rel="prev"><code class="code">gtroff</code> Output</a>, Up: <a href="gtroff-Output.html" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Language-Concepts-1">6.1.1 Language Concepts</h4>
+
+<p>The fundamental operation of the GNU <code class="code">troff</code> formatter is the
+translation of the <code class="code">groff</code> input language into a device-independent
+form primarily concerned with what has to be written or drawn at
+specific positions on the output device.  This language is simple and
+imperative.  In the following discussion, the term <em class="dfn">command</em> always
+refers to this intermediate output language, and never to the
+<code class="code">groff</code> language intended for direct use by document authors.
+Intermediate output commands comprise several categories: glyph output;
+font, color, and text size selection; motion of the printing position;
+page advancement; drawing of geometric objects; and device control
+commands, a catch-all for operations not easily classified as any of the
+foregoing, such as directives to start and stop output, identify the
+intended output device, or place URL hyperlinks in supported output
+formats.
+</p>
+
+<ul class="mini-toc">
+<li><a href="Separation.html" accesskey="1">Separation</a></li>
+<li><a href="Argument-Units.html" accesskey="2">Argument Units</a></li>
+<li><a href="Document-Parts.html" accesskey="3">Document Parts</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Leaders.html Added

@@ -0,0 +1,126 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Leaders (The GNU Troff Manual)</title>
+
+<meta name="description" content="Leaders (The GNU Troff Manual)">
+<meta name="keywords" content="Leaders (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Tabs-and-Fields.html" rel="up" title="Tabs and Fields">
+<link href="Fields.html" rel="next" title="Fields">
+<link href="Tabs-and-Fields.html" rel="prev" title="Tabs and Fields">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Leaders">
+<div class="nav-panel">
+<p>
+Next: <a href="Fields.html" accesskey="n" rel="next">Fields</a>, Previous: <a href="Tabs-and-Fields.html" accesskey="p" rel="prev">Tabs and Fields</a>, Up: <a href="Tabs-and-Fields.html" accesskey="u" rel="up">Tabs and Fields</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Leaders-1">5.12.1 Leaders</h4>
+<a class="index-entry-id" id="index-leaders"></a>
+
+<p>Sometimes it is desirable to fill a tab stop with a given glyph,
+but also use tab stops normally on the same output line.  An example is
+a table of contents entry that uses dots to bridge the entry name with
+its page number, which is itself aligned between tab stops.  The
+<code class="code">roff</code> language provides <em class="dfn">leaders</em> for this
+purpose.<a class="footnote" id="DOCF67" href="groff.html_fot.html#FOOT67"><sup>67</sup></a>
+</p>
+<a class="index-entry-id" id="index-leader-character-1"></a>
+<p>A leader character (<abbr class="acronym">ISO</abbr> and <abbr class="acronym">EBCDIC</abbr> code
+point&nbsp;1, also known as <abbr class="acronym">SOH</abbr> or &ldquo;start of heading&rdquo;),
+behaves similarly to a tab character: it moves to the next tab stop.
+The difference is that for this movement, the default fill character is
+a period &lsquo;<samp class="samp">.</samp>&rsquo;.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ca-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\a</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ca-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ca"></a>
+<a class="index-entry-id" id="index-leader-character_002c-non_002dinterpreted-_0028_005ca_0029"></a>
+<a class="index-entry-id" id="index-character_002c-leader_002c-non_002dinterpreted-_0028_005ca_0029"></a>
+<a class="index-entry-id" id="index-_005ca_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005ca"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005ca"></a>
+<p>Interpolate a leader in copy mode; see <a class="ref" href="Copy-Mode.html">Copy Mode</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002elc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lc"></a>
+<a class="index-entry-id" id="index-leader-repetition-character-_0028lc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-leader-repetition-_0028lc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-leader-repetition-_0028lc_0029"></a>
+<p>Set the leader repetition character to the ordinary or special character
+<var class="var">c</var>.  Recall <a class="ref" href="Tabs-and-Leaders.html">Tabs and Leaders</a>: when encountering a leader
+character in the input, the formatter writes as many dots &lsquo;<samp class="samp">.</samp>&rsquo; as
+are necessary until
+reaching the next tab stop; this is the <em class="dfn">leader definition
+character</em>.  Omitting <var class="var">c</var> unsets the leader
+character.  With no argument, GNU <code class="code">troff</code> treats leaders the same
+as tabs.  The leader repetition character is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).  Only a single <var class="var">c</var> is
+recognized; any excess is ignored.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-table-of-contents-1"></a>
+<a class="index-entry-id" id="index-contents_002c-table-of-1"></a>
+<p>A table of contents, for example, may define tab stops after a section
+number, a title, and a gap to be filled with leader dots.  The page
+number follows the leader, after a right-aligned final tab stop wide
+enough to house the largest page number occurring in the document.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds entry1 19.\tThe Prophet\a\t98
+.ds entry2 20.\tAll Astir\a\t101
+.ta .5i 4.5i +.5iR
+.nf
+\*entry1
+\*entry2
+    &rArr; 19.  The Prophet.............................   98
+    &rArr; 20.  All Astir...............................  101
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Fields.html">Fields</a>, Previous: <a href="Tabs-and-Fields.html">Tabs and Fields</a>, Up: <a href="Tabs-and-Fields.html">Tabs and Fields</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Leading-Space-Traps.html Added

@@ -0,0 +1,82 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Leading Space Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Leading Space Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Leading Space Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Traps.html" rel="up" title="Traps">
+<link href="End_002dof_002dinput-Traps.html" rel="next" title="End-of-input Traps">
+<link href="Blank-Line-Traps.html" rel="prev" title="Blank Line Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Leading-Space-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="End_002dof_002dinput-Traps.html" accesskey="n" rel="next">End-of-input Traps</a>, Previous: <a href="Blank-Line-Traps.html" accesskey="p" rel="prev">Blank Line Traps</a>, Up: <a href="Traps.html" accesskey="u" rel="up">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Leading-Space-Traps-1">5.28.4 Leading Space Traps</h4>
+<a class="index-entry-id" id="index-leading-space-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-leading-space"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elsm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lsm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002elsm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lsm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blsn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlsn</code></strong><a class="copiable-link" href='#index-_005cn_005blsn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lsn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blss_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlss</code></strong><a class="copiable-link" href='#index-_005cn_005blss_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lss"></a>
+<a class="index-entry-id" id="index-leading-spaces-macro-_0028lsm_0029"></a>
+<p>Set a leading space trap, calling the macro <var class="var">name</var> when GNU
+<code class="code">troff</code> encounters leading spaces in an input line; the implicit
+line break that normally happens in this case is suppressed.  If no
+argument is supplied, the default leading space behavior is
+(re-)established (see <a class="pxref" href="Breaking.html">Breaking</a>).
+</p>
+<p>The count of leading spaces on an input line is stored in register
+<code class="code">lsn</code>, and the amount of corresponding horizontal motion in
+register <code class="code">lss</code>, irrespective of whether a leading space trap is
+set.  When it is, the leading spaces are removed from the input line,
+and no motion is produced before calling <var class="var">name</var>.
+</p>
+</dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Ligatures-and-Kerning.html Added

@@ -0,0 +1,157 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Ligatures and Kerning (The GNU Troff Manual)</title>
+
+<meta name="description" content="Ligatures and Kerning (The GNU Troff Manual)">
+<meta name="keywords" content="Ligatures and Kerning (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Dummy-Characters.html" rel="next" title="Dummy Characters">
+<link href="Artificial-Fonts.html" rel="prev" title="Artificial Fonts">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Ligatures-and-Kerning">
+<div class="nav-panel">
+<p>
+Next: <a href="Dummy-Characters.html" accesskey="n" rel="next">Dummy Characters</a>, Previous: <a href="Artificial-Fonts.html" accesskey="p" rel="prev">Artificial Fonts</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Ligatures-and-Kerning-1">5.19.8 Ligatures and Kerning</h4>
+<a class="index-entry-id" id="index-ligatures-and-kerning"></a>
+<a class="index-entry-id" id="index-kerning-and-ligatures"></a>
+
+<p>Ligatures are groups of characters that are run together, i.e, producing
+a single glyph.  For example, the letters &lsquo;f&rsquo; and &lsquo;i&rsquo; can form a
+ligature &lsquo;fi&rsquo; as in the word &lsquo;file&rsquo;.  This produces a cleaner look
+(albeit subtle) to the printed output.  Usually, ligatures are not
+available in fonts for TTY output devices.
+</p>
+<p>Most PostScript fonts support the fi and fl ligatures.  The C/A/T
+typesetter that was the target of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> also
+supported &lsquo;ff&rsquo;, &lsquo;ffi&rsquo;, and &lsquo;ffl&rsquo; ligatures.  Advanced typesetters or
+&lsquo;expert&rsquo; fonts may include ligatures for &lsquo;ft&rsquo; and &lsquo;ct&rsquo;, although GNU
+<code class="code">troff</code> does not support these (yet).
+</p>
+<p>Only the current font is checked for ligatures and kerns; neither
+special fonts nor special charcters defined with the <code class="code">char</code> request
+(and its siblings) are taken into account.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elg"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lg</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002elg'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lg"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elg_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.lg</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elg_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elg-1"></a>
+<a class="index-entry-id" id="index-activating-ligatures-_0028lg_0029"></a>
+<a class="index-entry-id" id="index-ligatures_002c-activating-_0028lg_0029"></a>
+<a class="index-entry-id" id="index-ligatures-enabled-register-_0028_002elg_0029"></a>
+<p>Switch the ligature mechanism on or off; if the parameter is non-zero or
+missing, ligatures are enabled, otherwise disabled.  Default is on.  The
+current ligature mode can be found in the read-only register <code class="code">.lg</code>
+(set to 1 or&nbsp;2 if ligatures are enabled, 0&nbsp;otherwise).
+</p>
+<p>Setting the ligature mode to&nbsp;2 enables the two-character ligatures
+(fi, fl, and ff) and disables the three-character ligatures (ffi and
+ffl).
+</p></dd></dl>
+
+<p><em class="dfn">Pairwise kerning</em> is another subtle typesetting mechanism that
+modifies the distance between a glyph pair to improve readability.  In
+most cases (but not always) the distance is decreased.
+Typewriter-like fonts and fonts for terminals where all glyphs have the
+same width don&rsquo;t use kerning.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ekern"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.kern</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002ekern'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-kern"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ekern_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.kern</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ekern_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ekern-1"></a>
+<a class="index-entry-id" id="index-activating-kerning-_0028kern_0029"></a>
+<a class="index-entry-id" id="index-kerning_002c-activating-_0028kern_0029"></a>
+<a class="index-entry-id" id="index-kerning-enabled-register-_0028_002ekern_0029"></a>
+<p>Switch kerning on or off.  If the parameter is non-zero or missing,
+enable pairwise kerning, otherwise disable it.  The read-only register
+<code class="code">.kern</code> is set to&nbsp;1 if pairwise kerning is enabled,
+0&nbsp;otherwise.
+</p>
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-effect-on-kerning"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-effect-on-kerning"></a>
+<p>If the font description file contains pairwise kerning information,
+glyphs from that font are kerned.  Kerning between two glyphs can be
+inhibited by placing <code class="code">\&amp;</code> between them: &lsquo;<samp class="samp">V\&amp;A</samp>&rsquo;.
+</p>
+<p>See <a class="xref" href="Font-Description-File-Format.html">Font Description File Format</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-track-kerning"></a>
+<a class="index-entry-id" id="index-kerning_002c-track"></a>
+<p><em class="dfn">Track kerning</em> expands or reduces the space between glyphs.  This
+can be handy, for example, if you need to squeeze a long word onto a
+single line or spread some text to fill a narrow column.  It must be
+used with great care since it is usually considered bad typography if
+the reader notices the effect.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etkf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tkf</code></strong> <var class="def-var-arguments">f s1 n1 s2 n2</var><a class="copiable-link" href='#index-_002etkf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tkf"></a>
+<a class="index-entry-id" id="index-activating-track-kerning-_0028tkf_0029"></a>
+<a class="index-entry-id" id="index-track-kerning_002c-activating-_0028tkf_0029"></a>
+<p>Enable track kerning for font&nbsp;<var class="var">f</var>.  If the current font
+is&nbsp;<var class="var">f</var> the width of every glyph is increased by an amount
+between <var class="var">n1</var> and <var class="var">n2</var> (<var class="var">n1</var>, <var class="var">n2</var> can be negative); if
+the current type size is less than or equal to <var class="var">s1</var> the width is
+increased by <var class="var">n1</var>; if it is greater than or equal to <var class="var">s2</var> the
+width is increased by <var class="var">n2</var>; if the type size is greater than or
+equal to <var class="var">s1</var> and less than or equal to <var class="var">s2</var> the increase in
+width is a linear function of the type size.
+</p>
+<p>The default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo; for <var class="var">s1</var> and <var class="var">s2</var>, &lsquo;<samp class="samp">p</samp>&rsquo;
+for <var class="var">n1</var> and <var class="var">n2</var>.
+</p>
+<p>The track kerning amount is added even to the rightmost glyph in a line;
+for large values it is thus recommended to increase the line length by
+the same amount to compensate.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Dummy-Characters.html">Dummy Characters</a>, Previous: <a href="Artificial-Fonts.html">Artificial Fonts</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Line-Continuation.html Added

@@ -0,0 +1,166 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Line Continuation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Line Continuation (The GNU Troff Manual)">
+<meta name="keywords" content="Line Continuation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Page-Layout.html" rel="next" title="Page Layout">
+<link href="Line-Layout.html" rel="prev" title="Line Layout">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Line-Continuation">
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Layout.html" accesskey="n" rel="next">Page Layout</a>, Previous: <a href="Line-Layout.html" accesskey="p" rel="prev">Line Layout</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Line-Continuation-1">5.16 Line Continuation</h3>
+<a class="index-entry-id" id="index-line-control"></a>
+<a class="index-entry-id" id="index-control_002c-line"></a>
+
+<p>When filling is enabled, input and output line breaks generally do not
+correspond.  The <code class="code">roff</code> language therefore distinguishes input and
+output line continuation.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cRET-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<kbd class="key">RET</kbd></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cRET-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cRET"></a>
+<a class="index-entry-id" id="index-input-line-continuation-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-continuation-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-continuation_002c-input-line-_0028_005cRET_0029"></a>
+<a class="index-entry-id" id="index-_005cnewline"></a>
+<p><code class="code">\<kbd class="key">RET</kbd></code> (a backslash immediately followed by a newline)
+suppresses the effects of that newline in the input.  The next input
+line thus retains the classification of its predecessor as a control or
+text line.  <code class="code">\<kbd class="key">RET</kbd></code> is useful for managing line lengths in the
+input during document maintenance; you can break an input line in the
+middle of a request invocation, macro call, or escape sequence.  Input
+line continuation is invisible to the formatter, with two exceptions:
+the <code class="code">|</code> operator recognizes the new input line
+(see <a class="pxref" href="Numeric-Expressions.html">Numeric Expressions</a>), and the input line counter register
+<code class="code">.c</code> is incremented.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 50n
+.de I
+.  ft I
+.  nop \\$*
+.  ft
+..
+Our film class watched
+.I The Effect of Gamma Rays on Man-in-the-Moon
+Marigolds. \&quot; whoops, the input line wrapped
+.br
+.I My own opus begins on line \n.c \
+and ends on line \n.c.
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; Our film class watched <i class="i">The Effect of Gamma Rays on</i>
+    &rArr; <i class="i">Man-in-the-Moon</i> Marigolds.
+    &rArr; <i class="i">My own opus begins on line 11 and ends on line 12.</i>
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cc-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\c</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cc-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cc"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eint_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.int</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eint_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eint"></a>
+<a class="index-entry-id" id="index-output-line_002c-continuation-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-line_002c-output_002c-continuation-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-continuation_002c-output-line-_0028_005cc_0029"></a>
+<a class="index-entry-id" id="index-interrupted-line"></a>
+<a class="index-entry-id" id="index-line_002c-interrupted"></a>
+<a class="index-entry-id" id="index-_005cR_002c-after-_005cc"></a>
+<p><code class="code">\c</code> continues an output line.  Nothing after it on the input line
+is formatted.  In contrast to <code class="code">\<kbd class="key">RET</kbd></code>, a line after <code class="code">\c</code>
+remains a new input line, so a control character is recognized at its
+beginning.  The visual results depend on whether filling is enabled; see
+<a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+<ul class="itemize mark-bullet">
+<li><a class="index-entry-id" id="index-_005cc_002c-when-filling-enabled"></a>
+<a class="index-entry-id" id="index-fill-mode_002c-and-_005cc"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-and-_005cc"></a>
+If filling is enabled, a word interrupted with <code class="code">\c</code> is continued
+with the text on the next input text line, without an intervening space.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">This is a te\c
+st.
+    &rArr; This is a test.
+</pre></div></div>
+
+</li><li><a class="index-entry-id" id="index-_005cc_002c-when-filling-disabled"></a>
+<a class="index-entry-id" id="index-no_002dfill-mode_002c-and-_005cc"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dfill_002c-and-_005cc"></a>
+If filling is disabled, the next input text line after <code class="code">\c</code> is
+handled as a continuation of the same input text line.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+This is a \c
+test.
+    &rArr; This is a test.
+</pre></div></div>
+</li></ul>
+
+<p>An intervening control line that causes a break overrides <code class="code">\c</code>,
+flushing out the pending output line in the usual way.
+</p>
+<a class="index-entry-id" id="index-interrupted-line-register-_0028_002eint_0029"></a>
+<a class="index-entry-id" id="index-continued-output-line-register-_0028_002eint_0029"></a>
+<p>The <code class="code">.int</code> register contains a positive value if the last output
+line was continued with <code class="code">\c</code>; this datum is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).<a class="footnote" id="DOCF69" href="groff.html_fot.html#FOOT69"><sup>69</sup></a>
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Layout.html">Page Layout</a>, Previous: <a href="Line-Layout.html">Line Layout</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Line-Layout.html Added

@@ -0,0 +1,267 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Line Layout (The GNU Troff Manual)</title>
+
+<meta name="description" content="Line Layout (The GNU Troff Manual)">
+<meta name="keywords" content="Line Layout (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Line-Continuation.html" rel="next" title="Line Continuation">
+<link href="troff-and-nroff-Modes.html" rel="prev" title="troff and nroff Modes">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Line-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="Line-Continuation.html" accesskey="n" rel="next">Line Continuation</a>, Previous: <a href="troff-and-nroff-Modes.html" accesskey="p" rel="prev"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Line-Layout-1">5.15 Line Layout</h3>
+<a class="index-entry-id" id="index-line-layout"></a>
+<a class="index-entry-id" id="index-layout_002c-line"></a>
+
+<a class="index-entry-id" id="index-dimensions_002c-line"></a>
+<a class="index-entry-id" id="index-line-dimensions"></a>
+<p>The following drawing shows the dimensions that <code class="code">gtroff</code> uses for
+placing a line of output onto the page.  They are labeled with the
+request that manipulates each dimension.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">     --&gt;| in |&lt;--
+        |&lt;-----------ll------------&gt;|
+   +----+----+----------------------+----+
+   |    :    :                      :    |
+   +----+----+----------------------+----+
+--&gt;| po |&lt;--
+   |&lt;--------paper width----------------&gt;|
+</pre></div></div>
+
+<p>These dimensions are:
+</p>
+<dl class="ftable">
+<dt id='index-po'><span><code class="code">po</code><a class="copiable-link" href='#index-po'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-left-margin-_0028po_0029"></a>
+<a class="index-entry-id" id="index-margin_002c-left-_0028po_0029"></a>
+<a class="index-entry-id" id="index-page-offset-_0028po_0029"></a>
+<a class="index-entry-id" id="index-offset_002c-page-_0028po_0029"></a>
+<p><em class="dfn">Page offset</em>&mdash;this is the leftmost position of text on the final
+output, defining the <em class="dfn">left margin</em>.
+</p>
+</dd>
+<dt id='index-in'><span><code class="code">in</code><a class="copiable-link" href='#index-in'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-indentation-_0028in_0029"></a>
+<a class="index-entry-id" id="index-line-indentation-_0028in_0029"></a>
+<p><em class="dfn">Indentation</em>&mdash;this is the distance from the left margin where
+text is printed.
+</p>
+</dd>
+<dt id='index-ll'><span><code class="code">ll</code><a class="copiable-link" href='#index-ll'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-line-length-_0028ll_0029"></a>
+<a class="index-entry-id" id="index-length-of-line-_0028ll_0029"></a>
+<p><em class="dfn">Line length</em>&mdash;this is the distance from the left margin to right
+margin.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-margin_002c-right"></a>
+<a class="index-entry-id" id="index-right-margin"></a>
+<p>The right margin is not explicitly configured; the combination of page
+offset and line length provides the information necessary to derive it.
+</p>
+<p>A simple demonstration:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 3i
+This is text without indentation.
+The line length has been set to 3\~inches.
+.in +.5i
+.ll -.5i
+Now the left and right margins are both increased.
+.in
+.ll
+Calling .in and .ll without parameters restores
+the previous values.
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; This  is text without indenta-
+    &rArr; tion.   The  line  length  has
+    &rArr; been set to 3 inches.
+    &rArr;      Now   the  left  and
+    &rArr;      right  margins   are
+    &rArr;      both increased.
+    &rArr; Calling  .in  and  .ll without
+    &rArr; parameters restores the previ-
+    &rArr; ous values.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-po-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epo-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epo-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.po</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002epo-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eo_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.o</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eo_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eo"></a>
+<a class="index-entry-id" id="index-tty_002etmac-1"></a>
+<p>Set page offset to <var class="var">offset</var> (or increment or decrement its current
+value by <var class="var">offset</var>).  If invoked without an argument, the page offset
+is restored to the value before the previous <code class="code">po</code> request.
+This request does not cause a break; the page offset in effect when an
+output line is broken prevails (see <a class="pxref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>).  The initial value is 1<span class="dmn">i</span> and the default scaling
+unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  On terminal devices, the page offset is set to zero
+by a driver-specific macro file, <samp class="file">tty.tmac</samp>.  The current page
+offset can be found in the read-only register &lsquo;<samp class="samp">.o</samp>&rsquo;.
+<a class="index-entry-id" id="index-CSTR-_002354-errata-1"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-po-request"></a>
+This request is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as using a default scaling unit of &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.po 3i
+\n.o
+    &rArr; 720
+.po -1i
+\n.o
+    &rArr; 480
+.po
+\n.o
+    &rArr; 720
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ein"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-in-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ein-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ein-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.in</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002ein-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ei_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.i</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ei_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ei"></a>
+<p>Set indentation to <var class="var">indent</var> (or increment or decrement the current
+value by <var class="var">indent</var>).  This request causes a break.  Initially, there
+is no indentation.
+</p>
+<p>If <code class="code">in</code> is called without an argument, the indentation is reset to
+the previous value before the last call to <code class="code">in</code>.  The default
+scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<p>If a negative indentation value is specified (which is not allowed),
+<code class="code">gtroff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the
+indentation to zero.
+</p>
+<p>The effect of <code class="code">in</code> is delayed until a partially collected line (if
+it exists) is output.  A temporary indentation value is reset to zero
+also.
+</p>
+<p>The current indentation (as set by <code class="code">in</code>) can be found in the
+read-only register &lsquo;<samp class="samp">.i</samp>&rsquo;.  The indentation is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eti"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments">offset</var><a class="copiable-link" href='#index-_002eti'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ti"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eti-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002eti-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002eti-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ti</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">offset</i></span></var><a class="copiable-link" href='#index-_002eti-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ein_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.in</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ein_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ein-3"></a>
+<p>Temporarily indent the next output line by <var class="var">offset</var>.  If an
+increment or decrement value is specified, adjust the temporary
+indentation relative to the value set by the <code class="code">in</code> request.
+</p>
+<p>This request causes a break; its value is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).  The default scaling unit is
+&lsquo;<samp class="samp">m</samp>&rsquo;.  A call of <code class="code">ti</code> without an argument is ignored.
+</p>
+<p>If the total indentation value is negative (which is not allowed),
+<code class="code">gtroff</code> emits a warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the
+temporary indentation to zero.  &lsquo;Total indentation&rsquo; is either
+<var class="var">offset</var> if specified as an absolute value, or the temporary plus
+normal indentation, if <var class="var">offset</var> is given as a relative value.
+</p>
+<p>The effect of <code class="code">ti</code> is delayed until a partially collected line (if
+it exists) is output.
+</p>
+<p>The read-only register <code class="code">.in</code> is the indentation that applies to the
+current output line.
+</p>
+<p>The difference between <code class="code">.i</code> and <code class="code">.in</code> is that the latter takes
+into account whether a partially collected line still uses the old
+indentation value or a temporary indentation value is active.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ell"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ll-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ell-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ell-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ll</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ell-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002el_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.l</code></strong><a class="copiable-link" href='#index-_005cn_005b_002el_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002el"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ell_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ll</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ell_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ell-3"></a>
+<p>Set the line length to <var class="var">length</var> (or increment or decrement the
+current value by <var class="var">length</var>).  Initially, the line length is set to
+6.5<span class="dmn">i</span>.  The effect of <code class="code">ll</code> is delayed until a partially
+collected line (if it exists) is output.  The default scaling unit is
+&lsquo;<samp class="samp">m</samp>&rsquo;.
+</p>
+<p>If <code class="code">ll</code> is called without an argument, the line length is reset to
+the previous value before the last call to <code class="code">ll</code>.  If a negative
+line length is specified (which is not allowed), <code class="code">gtroff</code> emits a
+warning in category &lsquo;<samp class="samp">range</samp>&rsquo; and sets the line length to zero.  The
+line length is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-line-length-register-_0028_002el_0029"></a>
+<p>The current line length (as set by <code class="code">ll</code>) can be found in the
+read-only register &lsquo;<samp class="samp">.l</samp>&rsquo;.  The read-only register <code class="code">.ll</code> is the
+line length that applies to the current output line.
+</p>
+<p>Similar to <code class="code">.i</code> and <code class="code">.in</code>, the difference between <code class="code">.l</code>
+and <code class="code">.ll</code> is that the latter takes into account whether a partially
+collected line still uses the old line length value.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Line-Continuation.html">Line Continuation</a>, Previous: <a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Lists-in-ms.html Added

@@ -0,0 +1,216 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Lists in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Lists in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Lists in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Indented-regions-in-ms.html" rel="next" title="Indented regions in ms">
+<link href="Typeface-and-decoration.html" rel="prev" title="Typeface and decoration">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Lists-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="Indented-regions-in-ms.html" accesskey="n" rel="next">Indented regions</a>, Previous: <a href="Typeface-and-decoration.html" accesskey="p" rel="prev">Typeface and decoration</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Lists">4.6.5.6 Lists</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-lists"></a>
+
+<p>The <var class="var">marker</var> argument to the <code class="code">IP</code> macro can be employed to
+present a variety of lists; for instance, you can use a bullet glyph
+(<code class="code">\bu</code>) for unordered lists, a number (or auto-incrementing
+register) for numbered lists, or a word or phrase for glossary-style or
+definition lists.  If you set the paragraph indentation register
+<code class="code">PI</code> before calling <code class="code">IP</code>, you can later reorder the items in
+the list without having to ensure that a <var class="var">width</var> argument remains
+affixed to the first call.
+</p>
+<p>The following is an example of a bulleted list.
+<a class="index-entry-id" id="index-example-markup_002c-bulleted-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-bulleted-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PI 2n
+A bulleted list:
+.IP \bu
+lawyers
+.IP \bu
+guns
+.IP \bu
+money
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A bulleted list:
+
+&bull; lawyers
+
+&bull; guns
+
+&bull; money
+</pre></div></div>
+
+<p>The following is an example of a numbered list.
+<a class="index-entry-id" id="index-example-markup_002c-numbered-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-numbered-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr step 0 1
+.nr PI 3n
+A numbered list:
+.IP \n+step
+lawyers
+.IP \n+step
+guns
+.IP \n+step
+money
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A numbered list:
+
+1. lawyers
+
+2. guns
+
+3. money
+</pre></div></div>
+
+<p>Here we have employed the <code class="code">nr</code> request to create a register of our
+own, &lsquo;<samp class="samp">step</samp>&rsquo;.  We initialized it to zero and assigned it an
+auto-increment of 1.  Each time we use the escape sequence
+&lsquo;<samp class="samp">\n+PI</samp>&rsquo; (note the plus sign), the formatter applies the increment
+just before interpolating the register&rsquo;s value.  Preparing the <code class="code">PI</code>
+register as well enables us to rearrange the list without the tedium of
+updating macro calls.
+</p>
+<p>The next example illustrates a glossary-style list.
+<a class="index-entry-id" id="index-example-markup_002c-glossary_002dstyle-list-_005bms_005d"></a>
+<a class="index-entry-id" id="index-glossary_002dstyle-list_002c-example-markup-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">A glossary-style list:
+.IP lawyers 0.4i
+Two or more attorneys.
+.IP guns
+Firearms,
+preferably large-caliber.
+.IP money
+Gotta pay for those
+lawyers and guns!
+</pre></div>
+</td></tr></table>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">A glossary-style list:
+
+lawyers
+      Two or more attorneys.
+
+guns  Firearms, preferably large-caliber.
+
+money
+      Gotta pay for those lawyers and guns!
+</pre></div></div>
+
+<p>In the previous example, observe how the <code class="code">IP</code> macro places the
+definition on the same line as the term if it has enough space.  If this
+is not what you want, there are a few workarounds we will illustrate by
+modifying the example.  First, you can use a <code class="code">br</code> request to force
+a break after printing the term or label.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns
+.br
+Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>Second, you could apply the <code class="code">\p</code> escape sequence to force a break.
+The space following the escape sequence is important; if you omit it,
+<code class="code">groff</code> prints the first word of the paragraph text on the same
+line as the term or label (if it fits) <em class="emph">then</em> breaks the line.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns
+\p Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>Finally, you may append a horizontal motion to the marker with the
+<code class="code">\h</code> escape sequence; using the same amount as the indentation will
+ensure that the marker is too wide for <code class="code">groff</code> to treat it as
+&ldquo;fitting&rdquo; on the same line as the paragraph text.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.IP guns\h'0.4i'
+Firearms,
+</pre></div>
+</td></tr></table>
+
+<p>In each case, the result is the same.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A glossary-style list:
+
+lawyers
+      Two or more attorneys.
+
+guns
+      Firearms, preferably large-caliber.
+
+money
+      Gotta pay for those lawyers and guns!
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Indented-regions-in-ms.html">Indented regions</a>, Previous: <a href="Typeface-and-decoration.html">Typeface and decoration</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Macro-Directories.html Added

@@ -0,0 +1,125 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Macro Directories (The GNU Troff Manual)</title>
+
+<meta name="description" content="Macro Directories (The GNU Troff Manual)">
+<meta name="keywords" content="Macro Directories (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Font-Directories.html" rel="next" title="Font Directories">
+<link href="Environment.html" rel="prev" title="Environment">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Macro-Directories">
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Directories.html" accesskey="n" rel="next">Font Directories</a>, Previous: <a href="Environment.html" accesskey="p" rel="prev">Environment</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Macro-Directories-1">2.3 Macro Directories</h3>
+<a class="index-entry-id" id="index-macro-directories"></a>
+<a class="index-entry-id" id="index-directories-for-macros"></a>
+<a class="index-entry-id" id="index-searching-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-searching"></a>
+
+<p>A macro file must have a name in the form <code class="code"><var class="var">name</var>.tmac</code> or
+<code class="code">tmac.<var class="var">name</var></code> and be placed in a <em class="dfn">tmac directory</em> to be
+found by the <samp class="option">-m<var class="var">name</var></samp> command-line option.<a class="footnote" id="DOCF5" href="groff.html_fot.html#FOOT5"><sup>5</sup></a>
+<a class="index-entry-id" id="index-tmac_002c-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-for-tmac-files"></a>
+<a class="index-entry-id" id="index-tmac_002c-path"></a>
+<a class="index-entry-id" id="index-path_002c-for-tmac-files"></a>
+<a class="index-entry-id" id="index-locating-macro-files"></a>
+<a class="index-entry-id" id="index-macro-file-search-path"></a>
+<a class="index-entry-id" id="index-file_002c-macro_002c-search-path"></a>
+<a class="index-entry-id" id="index-locating-macro-packages"></a>
+<a class="index-entry-id" id="index-macro-package-search-path"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-search-path"></a>
+Together, these directories constitute the <em class="dfn">tmac path</em>.  Each
+directory is searched in the following order until the desired macro
+file is found or the list is exhausted.
+</p>
+<ul class="itemize mark-bullet">
+<li>Directories specified with GNU <code class="code">troff</code>&rsquo;s or <code class="code">groff</code>&rsquo;s
+<samp class="option">-M</samp> command-line option.
+
+</li><li><a class="index-entry-id" id="index-GROFF_005fTMAC_005fPATH_002c-environment-variable-1"></a>
+Directories listed in the <code class="env">GROFF_TMAC_PATH</code> environment variable.
+
+</li><li><a class="index-entry-id" id="index-safer-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-1"></a>
+<a class="index-entry-id" id="index-unsafe-mode-1"></a>
+<a class="index-entry-id" id="index-mode_002c-unsafe-1"></a>
+<a class="index-entry-id" id="index-current-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-current"></a>
+The current working directory (only if in unsafe mode using the
+<samp class="option">-U</samp> command-line option).
+
+</li><li><a class="index-entry-id" id="index-home-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-home"></a>
+The user&rsquo;s home directory, <code class="env">HOME</code>.
+
+</li><li><a class="index-entry-id" id="index-site_002dlocal-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-site_002dlocal"></a>
+<a class="index-entry-id" id="index-platform_002dspecific-directory"></a>
+<a class="index-entry-id" id="index-directory_002c-platform_002dspecific"></a>
+A platform-dependent directory, a site-local (platform-independent)
+directory, and the main <i class="slanted">tmac</i> directory.  The locations
+corresponding to your installation are listed in section &ldquo;Environment&rdquo;
+of <cite class="cite">gtroff<span class="r">(1)</span></cite>.  If not otherwise configured, they are as
+follows.
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">/usr/local/lib/groff/site-tmac
+/usr/local/share/groff/site-tmac
+/usr/local/share/groff/1.23.0/tmac
+</pre></div></div>
+
+<p>The foregoing assumes that the version of <code class="code">groff</code> is 1.23.0, and
+that the installation prefix was <samp class="file">/usr/local</samp>.  It is possible to
+fine-tune these locations during the source configuration process.
+</p></li></ul>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Directories.html">Font Directories</a>, Previous: <a href="Environment.html">Environment</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Macro-Index.html Added

@@ -0,0 +1,335 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Macro Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Macro Index (The GNU Troff Manual)">
+<meta name="keywords" content="Macro Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="String-Index.html" rel="next" title="String Index">
+<link href="Register-Index.html" rel="prev" title="Register Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Macro-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="String-Index.html" accesskey="n" rel="next">String Index</a>, Previous: <a href="Register-Index.html" accesskey="p" rel="prev">Register Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Macro-Index-1">Appendix F Macro Index</h2>
+
+<p>The macro package a specific macro belongs to is appended in brackets.
+They appear without the leading control character (normally &lsquo;<samp class="samp">.</samp>&rsquo;).
+</p>
+<div class="printindex ma-printindex">
+<table class="ma-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-1"><b>1</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-2"><b>2</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-3"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-4"><b></b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-X"><b>X</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="ma-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-1">1</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Multiple-Columns.html#index-1C-_005bms_005d"><code>1C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Multiple-Columns.html">ms Multiple Columns</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-2">2</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Multiple-Columns.html#index-2C-_005bms_005d"><code>2C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Multiple-Columns.html">ms Multiple Columns</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-3"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-_005b-_005bms_005d"><code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_symbol-4"></th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-_005d-_005bms_005d"><code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-AB-_005bms_005d"><code>AB <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-AE-_005bms_005d"><code>AE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-AI-_005bms_005d"><code>AI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-AM-_005bms_005d"><code>AM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-AU-_005bms_005d"><code>AU <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-B-_005bms_005d"><code>B <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-B1-_005bms_005d"><code>B1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-B2-_005bms_005d"><code>B2 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-BD-_005bms_005d"><code>BD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-BI-_005bms_005d"><code>BI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-BT-_005bman_005d"><code>BT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-BX-_005bms_005d"><code>BX <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-CD-_005bms_005d"><code>CD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-CT-_005bman_005d"><code>CT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-CW-_005bman_005d"><code>CW <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-CW-_005bms_005d"><code>CW <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-DA-_005bms_005d"><code>DA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-De-_005bman_005d"><code>De <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DE-_005bms_005d"><code>DE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-Ds-_005bman_005d"><code>Ds <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DS-_005bms_005d"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DS-_005bms_005d-1"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DS-_005bms_005d-2"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DS-_005bms_005d-3"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-DS-_005bms_005d-4"><code>DS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-EE-_005bman_005d"><code>EE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-EF-_005bms_005d"><code>EF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-EH-_005bms_005d"><code>EH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-EN-_005bms_005d"><code>EN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-EQ-_005bms_005d"><code>EQ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-EX-_005bman_005d"><code>EX <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-FE-_005bms_005d"><code>FE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-FS-_005bms_005d"><code>FS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-G-_005bman_005d"><code>G <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-GL-_005bman_005d"><code>GL <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-HB-_005bman_005d"><code>HB <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-I-_005bms_005d"><code>I <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-ID-_005bms_005d"><code>ID <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-IP-_005bms_005d"><code>IP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-KE-_005bms_005d"><code>KE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-KF-_005bms_005d"><code>KF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-KS-_005bms_005d"><code>KS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-LD-_005bms_005d"><code>LD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-LG-_005bms_005d"><code>LG <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-LP-_005bms_005d"><code>LP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Multiple-Columns.html#index-MC-_005bms_005d"><code>MC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Multiple-Columns.html">ms Multiple Columns</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-MS-_005bman_005d"><code>MS <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-ND-_005bms_005d"><code>ND <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-NE-_005bman_005d"><code>NE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-NH-_005bms_005d"><code>NH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-NL-_005bms_005d"><code>NL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-NT-_005bman_005d"><code>NT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-OF-_005bms_005d"><code>OF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-OH-_005bms_005d"><code>OH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Headers-and-Footers.html#index-P1-_005bms_005d"><code>P1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Headers-and-Footers.html">ms Headers and Footers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-PE-_005bms_005d"><code>PE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-PF-_005bms_005d"><code>PF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-PN-_005bman_005d"><code>PN <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-Pn-_005bman_005d"><code>Pn <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-PP-_005bms_005d"><code>PP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-PS-_005bms_005d"><code>PS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-PT-_005bman_005d"><code>PT <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-PX-_005bms_005d"><code>PX <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-QE-_005bms_005d"><code>QE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-QP-_005bms_005d"><code>QP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-QS-_005bms_005d"><code>QS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-R-_005bman_005d"><code>R <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-R-_005bms_005d"><code>R <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-keeps-and-displays.html#index-RD-_005bms_005d"><code>RD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-keeps-and-displays.html">ms keeps and displays</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indented-regions-in-ms.html#index-RE-_005bms_005d"><code>RE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indented-regions-in-ms.html">Indented regions in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-RN-_005bman_005d"><code>RN <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-RP-_005bms_005d"><code>RP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indented-regions-in-ms.html#index-RS-_005bms_005d"><code>RS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indented-regions-in-ms.html">Indented regions in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-SH-_005bms_005d"><code>SH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-SM-_005bms_005d"><code>SM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tab-Stops-in-ms.html#index-TA-_005bms_005d"><code>TA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tab-Stops-in-ms.html">Tab Stops in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-TB-_005bman_005d"><code>TB <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-TC-_005bms_005d"><code>TC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-TE-_005bms_005d"><code>TE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Description-Macros.html#index-TL-_005bms_005d"><code>TL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Description-Macros.html">ms Document Description Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-TS-_005bms_005d"><code>TS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-UL-_005bms_005d"><code>UL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-VE-_005bman_005d"><code>VE <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-VS-_005bman_005d"><code>VS <span class="r"></span>man<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Macro-Index_ma_letter-X">X</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XA-_005bms_005d"><code>XA <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XE-_005bms_005d"><code>XE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XH-_005bms_005d"><code>XH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XH_002dREPLACEMENT-_005bms_005d"><code>XH-REPLACEMENT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XH_002dUPDATE_002dTOC-_005bms_005d"><code>XH-UPDATE-TOC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XN-_005bms_005d"><code>XN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XN_002dINIT-_005bms_005d"><code>XN-INIT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XN_002dREPLACEMENT-_005bms_005d"><code>XN-REPLACEMENT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paragraphs-in-ms.html#index-XP-_005bms_005d"><code>XP <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paragraphs-in-ms.html">Paragraphs in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-TOC.html#index-XS-_005bms_005d"><code>XS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-TOC.html">ms TOC</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="ma-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-1"><b>1</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-2"><b>2</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-3"><b></b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_symbol-4"><b></b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Macro-Index_ma_letter-X"><b>X</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="String-Index.html">String Index</a>, Previous: <a href="Register-Index.html">Register Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Macro-Package-Intro.html Added

@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Macro Package Intro (The GNU Troff Manual)</title>
+
+<meta name="description" content="Macro Package Intro (The GNU Troff Manual)">
+<meta name="keywords" content="Macro Package Intro (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Preprocessor-Intro.html" rel="next" title="Preprocessor Intro">
+<link href="groff-Capabilities.html" rel="prev" title="groff Capabilities">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Macro-Package-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="Preprocessor-Intro.html" accesskey="n" rel="next">Preprocessors</a>, Previous: <a href="groff-Capabilities.html" accesskey="p" rel="prev"><code class="code">groff</code> Capabilities</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Macro-Packages-1">1.4 Macro Packages</h3>
+<a class="index-entry-id" id="index-macro-package_002c-introduction"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-introduction"></a>
+
+<p>Elemental typesetting functions can be be challenging to use directly
+with complex documents.  A <em class="dfn">macro</em> facility specifies how certain
+routine operations, such as starting paragraphs, or printing headers and
+footers, should be performed in terms of those low-level instructions.
+Macros can be specific to one document or collected together into a
+<em class="dfn">macro package</em> for use by many.  Several macro packages available;
+the most widely used are provided with <code class="code">groff</code>.  They are
+<samp class="file">man</samp>, <samp class="file">mdoc</samp>, <samp class="file">me</samp>, <samp class="file">mm</samp>, <samp class="file">mom</samp>, and
+<samp class="file">ms</samp>.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Macro-Packages.html Added

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Macro Packages (The GNU Troff Manual)</title>
+
+<meta name="description" content="Macro Packages (The GNU Troff Manual)">
+<meta name="keywords" content="Macro Packages (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Input-Encodings.html" rel="next" title="Input Encodings">
+<link href="Requests-and-Macros.html" rel="prev" title="Requests and Macros">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Macro-Packages">
+<div class="nav-panel">
+<p>
+Next: <a href="Input-Encodings.html" accesskey="n" rel="next">Input Encodings</a>, Previous: <a href="Requests-and-Macros.html" accesskey="p" rel="prev">Requests and Macros</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Macro-Packages-3">5.1.8 Macro Packages</h4>
+<a class="index-entry-id" id="index-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro"></a>
+
+<p>Macro definitions can be collected into <em class="dfn">macro files</em>, <code class="code">roff</code>
+input files designed to produce no output themselves but instead ease
+the preparation of other <code class="code">roff</code> documents.  There is no syntactical
+difference between a macro file and any other <code class="code">roff</code> document; only
+its purpose distinguishes it.  When a macro file is installed at a
+standard location and suitable for use by a general audience, it is
+often termed a <em class="dfn">macro package</em>.<a class="footnote" id="DOCF29" href="groff.html_fot.html#FOOT29"><sup>29</sup></a>  Macro packages can be
+loaded by supplying the <samp class="option">-m</samp> option to GNU <code class="command">troff</code> or a
+<code class="code">groff</code> front end.  Alternatively, a document requiring a macro
+package can load it with the <code class="code">mso</code> (&ldquo;macro source&rdquo;) request.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Major-Macro-Packages.html Added

@@ -0,0 +1,103 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Major Macro Packages (The GNU Troff Manual)</title>
+
+<meta name="description" content="Major Macro Packages (The GNU Troff Manual)">
+<meta name="keywords" content="Major Macro Packages (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="GNU-troff-Reference.html" rel="next" title="GNU troff Reference">
+<link href="Tutorial-for-Macro-Users.html" rel="prev" title="Tutorial for Macro Users">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="Major-Macro-Packages">
+<div class="nav-panel">
+<p>
+Next: <a href="GNU-troff-Reference.html" accesskey="n" rel="next">GNU <code class="code">troff</code> Reference</a>, Previous: <a href="Tutorial-for-Macro-Users.html" accesskey="p" rel="prev">Tutorial for Macro Users</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="Macro-Packages-2">4 Macro Packages</h2>
+<a class="index-entry-id" id="index-major-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-major"></a>
+<a class="index-entry-id" id="index-macro-package_002c-major"></a>
+
+<p>This chapter surveys the &ldquo;major&rdquo; macro packages that come with
+<code class="code">groff</code>.  One, <samp class="file">ms</samp>, is presented in detail.
+</p>
+<a class="index-entry-id" id="index-full_002dservice-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-full_002dservice"></a>
+<a class="index-entry-id" id="index-macro-package_002c-full_002dservice"></a>
+<p>Major macro packages are also sometimes described as <em class="dfn">full-service</em>
+due to the breadth of features they provide and because more than one
+cannot be used by the same document; for example
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -m man foo.man -m ms bar.doc
+</pre></div></div>
+
+<p>doesn&rsquo;t work.  Option arguments are processed before non-option
+arguments; the above (failing) sample is thus reordered to
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -m man -m ms foo.man bar.doc
+</pre></div></div>
+
+<a class="index-entry-id" id="index-minor-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-minor"></a>
+<a class="index-entry-id" id="index-macro-package_002c-minor"></a>
+<a class="index-entry-id" id="index-auxiliary-macro-package"></a>
+<a class="index-entry-id" id="index-package_002c-macro_002c-auxiliary"></a>
+<a class="index-entry-id" id="index-macro-package_002c-auxiliary"></a>
+<p>Many auxiliary, or &ldquo;minor&rdquo;, macro packages are also available.  They
+may in general be used with any full-service macro package and handle a
+variety of tasks from character encoding selection, to language
+localization, to inlining of raster images.  See the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page for a list.  Type &lsquo;<samp class="samp">man
+groff_tmac</samp>&rsquo; at the command line to view it.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="man.html" accesskey="1"><samp class="file">man</samp></a></li>
+<li><a href="mdoc.html" accesskey="2"><samp class="file">mdoc</samp></a></li>
+<li><a href="me.html" accesskey="3"><samp class="file">me</samp></a></li>
+<li><a href="mm.html" accesskey="4"><samp class="file">mm</samp></a></li>
+<li><a href="mom.html" accesskey="5"><samp class="file">mom</samp></a></li>
+<li><a href="ms.html" accesskey="6"><samp class="file">ms</samp></a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Manipulating-Filling-and-Adjustment.html Added

@@ -0,0 +1,501 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Manipulating Filling and Adjustment (The GNU Troff Manual)</title>
+
+<meta name="description" content="Manipulating Filling and Adjustment (The GNU Troff Manual)">
+<meta name="keywords" content="Manipulating Filling and Adjustment (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Manipulating-Hyphenation.html" rel="next" title="Manipulating Hyphenation">
+<link href="Registers.html" rel="prev" title="Registers">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Manipulating-Filling-and-Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Hyphenation.html" accesskey="n" rel="next">Manipulating Hyphenation</a>, Previous: <a href="Registers.html" accesskey="p" rel="prev">Registers</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Manipulating-Filling-and-Adjustment-1">5.9 Manipulating Filling and Adjustment</h3>
+<a class="index-entry-id" id="index-manipulating-filling-and-adjustment"></a>
+<a class="index-entry-id" id="index-filling-and-adjustment_002c-manipulating"></a>
+<a class="index-entry-id" id="index-adjustment-and-filling_002c-manipulating"></a>
+<a class="index-entry-id" id="index-justifying-text"></a>
+<a class="index-entry-id" id="index-text_002c-justifying"></a>
+
+<a class="index-entry-id" id="index-break-1"></a>
+<a class="index-entry-id" id="index-line-break"></a>
+<a class="index-entry-id" id="index-bp-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-ce-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-cf-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-fi-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-fl-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-in-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-nf-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-rj-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-sp-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-ti-request_002c-causing-implicit-break"></a>
+<a class="index-entry-id" id="index-trf-request_002c-causing-implicit-break"></a>
+<p>When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in <a class="ref" href="Breaking.html">Breaking</a>.
+The <code class="code">br</code> request likewise causes a break.  Several other requests
+imply breaks: <code class="code">bp</code>, <code class="code">ce</code>, <code class="code">cf</code>, <code class="code">fi</code>, <code class="code">fl</code>,
+<code class="code">in</code>, <code class="code">nf</code>, <code class="code">rj</code>, <code class="code">sp</code>, <code class="code">ti</code>, and <code class="code">trf</code>.
+If the no-break control character is used with any of these requests,
+GNU <code class="code">troff</code> suppresses the break; instead the requested operation
+takes effect at the next break.  &lsquo;<samp class="samp">'br</samp>&rsquo; does nothing.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 55n
+This line is normally filled and adjusted.
+.br
+A line's alignment is decided
+'ce \&quot; Center the next input line (no break).
+when it is output.
+This line returns to normal filling and adjustment.
+    &rArr; This line is normally filled and adjusted.
+    &rArr;    A line's alignment is decided when it is output.
+    &rArr; This line returns to normal filling and adjustment.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-pending-output-line"></a>
+<a class="index-entry-id" id="index-partially-collected-line"></a>
+<a class="index-entry-id" id="index-output-line-properties"></a>
+<a class="index-entry-id" id="index-properties-of-output-lines"></a>
+<p>Output line properties like page offset, indentation, adjustment, and
+even the location of its text baseline, are not determined until the
+line has been broken.  An output line is said to be <em class="dfn">pending</em> if
+some input has been collected but an output line corresponding to it has
+not yet been written; such an output line is also termed <em class="dfn">partially
+collected</em>.  If no output line is pending, it is as if a break has
+already happened; additional breaks, whether explicit or implicit, have
+no effect.  If the vertical drawing position is negative&mdash;as it is when
+the formatter starts up&mdash;a break starts a new page (even if no output
+line is pending) unless an end-of-input macro is being interpreted.
+See <a class="xref" href="End_002dof_002dinput-Traps.html">End-of-input Traps</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.br</code></strong><a class="copiable-link" href='#index-_002ebr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-br"></a>
+<p>Break the line: emit any pending output line without adjustment.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">foo bar
+.br
+baz
+'br
+qux
+    &rArr; foo bar
+    &rArr; baz qux
+</pre></div></div>
+</dd></dl>
+
+<p>Sometimes you want to prevent a break within a phrase or between a
+quantity and its units.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\~</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007e"></a>
+<a class="index-entry-id" id="index-unbreakable-space-_0028_005c_007e_0029"></a>
+<a class="index-entry-id" id="index-space_002c-unbreakable-_0028_005c_007e_0029"></a>
+<p>Insert an unbreakable space that is adjustable like an ordinary space.
+It is discarded from the end of an output line if a break is forced.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Set the output speed to\~1.
+There are 1,024\~bytes in 1\~KiB.
+J.\~F.\~Ossanna wrote the original CSTR\~#54.
+</pre></div></div>
+</dd></dl>
+
+<p>By default, GNU <code class="code">troff</code> fills text and adjusts it to reach the
+output line length.  The <code class="code">nf</code> request disables filling; the
+<code class="code">fi</code> request reënables it.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efi"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fi</code></strong><a class="copiable-link" href='#index-_002efi'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fi"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eu_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.u</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eu_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eu"></a>
+<a class="index-entry-id" id="index-filling-of-output_002c-enabling-_0028fi_0029"></a>
+<a class="index-entry-id" id="index-output_002c-filling_002c-enablement-of-_0028fi_0029"></a>
+<a class="index-entry-id" id="index-fill-mode-_0028fi_0029_002c-enabling"></a>
+<a class="index-entry-id" id="index-mode_002c-fill-_0028fi_0029_002c-enabling"></a>
+<p>Enable filling of output lines; a pending output line is broken.  The
+read-only register <code class="code">.u</code> is set to&nbsp;1.  The filling enablement
+status, sometimes called <em class="dfn">fill mode</em>, is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).  See <a class="xref" href="Line-Continuation.html">Line Continuation</a>, for
+interaction with the <code class="code">\c</code> escape sequence.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nf</code></strong><a class="copiable-link" href='#index-_002enf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nf"></a>
+<a class="index-entry-id" id="index-filling-of-output_002c-disabling-_0028nf_0029"></a>
+<a class="index-entry-id" id="index-output_002c-filling_002c-disablement-of-_0028nf_0029"></a>
+<a class="index-entry-id" id="index-no_002dfill-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dfill"></a>
+<a class="index-entry-id" id="index-fill-mode_002c-disabling"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-disabling"></a>
+<p>Disable filling of output lines: the output line length (see <a class="pxref" href="Line-Layout.html">Line Layout</a>) is ignored and output lines are broken where the input lines
+are.  A pending output line is broken and adjustment is suppressed.  The
+read-only register <code class="code">.u</code> is set to&nbsp;0.  The filling enablement
+status is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).  See
+<a class="ref" href="Line-Continuation.html">Line Continuation</a>, for interaction with the <code class="code">\c</code> escape
+sequence.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ead"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ad</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">mode</i></span></var><a class="copiable-link" href='#index-_002ead'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ad"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ej_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.j</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ej_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ej"></a>
+<p>Enable output line adjustment in <var class="var">mode</var>, taking effect when the
+pending (or next) output line is broken.  Adjustment is suppressed when
+filling is.  <var class="var">mode</var> can have one of the following values.
+</p>
+<dl class="table">
+<dt><code class="code">b</code></dt>
+<dt><code class="code">n</code></dt>
+<dd><p>Adjust &ldquo;normally&rdquo;: if the output line does not consume the distance
+between the indentation and the configured output line length, GNU
+<code class="code">troff</code> stretches adjustable spaces within the line until that
+length is reached.  When the indentation is zero, this mode spreads the
+line to both the left and right margins.  This is the GNU <code class="code">troff</code>
+default.
+</p>
+</dd>
+<dt id='index-centered-text-_0028filled_0029'><span><code class="code">c</code><a class="copiable-link" href='#index-centered-text-_0028filled_0029'> &para;</a></span></dt>
+<dd><p>Center filled text.  Contrast with the <code class="code">ce</code> request, which centers
+text <em class="emph">without</em> filling it.
+</p>
+</dd>
+<dt id='index-ragged_002dright-text'><span><code class="code">l</code><a class="copiable-link" href='#index-ragged_002dright-text'> &para;</a></span></dt>
+<dd><p>Align text to the left without adjusting it.
+</p>
+</dd>
+<dt id='index-ragged_002dleft-text'><span><code class="code">r</code><a class="copiable-link" href='#index-ragged_002dleft-text'> &para;</a></span></dt>
+<dd><p>Align text to the right without adjusting it.
+</p></dd>
+</dl>
+
+<p><var class="var">mode</var> can also be a value previously stored in the <code class="code">.j</code>
+register.  Using <code class="code">ad</code> without an argument is the same as &lsquo;<samp class="samp">.ad
+\n.j</samp>&rsquo;; unless filling is disabled, GNU <code class="code">troff</code> resumes adjusting
+lines in the same way it did before adjustment was disabled by
+invocation of the <code class="code">na</code> request.
+</p>
+<a class="index-entry-id" id="index-adjustment-mode-register-_0028_002ej_0029"></a>
+<p>The adjustment mode and enablement status are encoded in the read-only
+register <code class="code">.j</code>.  These parameters are associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>The value of <code class="code">.j</code> for any adjustment mode is an implementation
+detail and should not be relied upon as a programmer&rsquo;s interface.  Do
+not write logic to interpret or perform arithmetic on it.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 48n
+.de AD
+.  br
+.  ad \\$1
+..
+.de NA
+.  br
+.  na
+..
+left
+.AD r
+.nr ad \n(.j
+right
+.AD c
+center
+.NA
+left
+.AD
+center
+.AD \n(ad
+right
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; left
+    &rArr;                                            right
+    &rArr;                      center
+    &rArr; left
+    &rArr;                      center
+    &rArr;                                            right
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ena"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.na</code></strong><a class="copiable-link" href='#index-_002ena'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-na"></a>
+<p>Disable output line adjustment.  This produces the same output as
+left-alignment, but the value of the adjustment mode register <code class="code">.j</code>
+is altered differently.  The adjustment mode and enablement status are
+associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebrp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.brp</code></strong><a class="copiable-link" href='#index-_002ebrp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-brp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cp-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\p</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cp-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cp"></a>
+<p>Break, adjusting the line per the current adjustment mode.  <code class="code">\p</code>
+schedules a break with adjustment at the next word boundary.  The escape
+sequence is itself neither a break nor a space of any kind; it can thus
+be placed in the middle of a word to cause a break at the end of that
+word.
+</p>
+<p>Breaking with immediate adjustment can produce ugly results since GNU
+<code class="code">troff</code> doesn&rsquo;t have a sophisticated paragraph-building algorithm,
+as TeX has, for example.  Instead, GNU <code class="code">troff</code> fills and adjusts
+a paragraph line by line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 4.5i
+This is an uninteresting sentence.
+This is an uninteresting sentence.\p
+This is an uninteresting sentence.
+</pre></div></div>
+
+<p>is formatted as follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">This  is  an uninteresting sentence.  This is
+an          uninteresting           sentence.
+This is an uninteresting sentence.
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-productive-input-line"></a>
+<a class="index-entry-id" id="index-input-line_002c-productive"></a>
+<a class="index-entry-id" id="index-line_002c-productive-input"></a>
+<p>To clearly present the next couple of requests, we must introduce the
+concept of &ldquo;productive&rdquo; input lines.  A <em class="dfn">productive input line</em> is
+one that directly produces formatted output.  Text lines produce
+output,<a class="footnote" id="DOCF53" href="groff.html_fot.html#FOOT53"><sup>53</sup></a> as do control
+lines containing requests like <code class="code">tl</code> or escape sequences like
+<code class="code">\D</code>.  Macro calls are not <em class="emph">directly</em> productive, and thus not
+counted, but their interpolated contents can be.  Empty requests, and
+requests and escape sequences that define registers or strings or alter
+the formatting environment (as with changes to the size, face, height,
+slant, or color of the type) are not productive.  We will also preview
+the output line continuation escape sequence, <code class="code">\c</code>, which
+&ldquo;connects&rdquo; two input lines that would otherwise be counted separately.
+<a class="footnote" id="DOCF54" href="groff.html_fot.html#FOOT54"><sup>54</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de hello
+Hello, world!
+..
+.ce \&quot; center output of next productive input line
+.
+.nr junk-reg 1
+.ft I
+Chorus: \c
+.ft
+.hello
+Went the day well?
+  &rArr;                  <i class="slanted">Chorus:</i> Hello, world!
+  &rArr; Went the day well?
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ece"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ce</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ece'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ce"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ece_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ce</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ece_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ece-1"></a>
+<a class="index-entry-id" id="index-centered-text-_0028unfilled_0029"></a>
+<a class="index-entry-id" id="index-centering-lines-_0028ce_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-centering-_0028ce_0029"></a>
+<p>Break (unless the no-break control character is used), center the output
+of the next <var class="var">n</var> productive input lines with respect to the line
+length and indentation without filling, then break again regardless of
+the invoking control character.
+If the argument is not positive, centering is disabled.  Omitting the
+argument implies an <var class="var">n</var> of &lsquo;<samp class="samp">1</samp>&rsquo;.  The count of lines remaining
+to be centered is stored in the read-only register <code class="code">.ce</code> and is
+associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-ce-request_002c-difference-from-_002ead-c"></a>
+<p>While the &lsquo;<samp class="samp">.ad&nbsp;c</samp>&rsquo; request also centers text, it fills the text
+as well.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de FR
+This is a small text fragment that shows the differences
+between the `.ce' and the `.ad c' requests.
+..
+.ll 4i
+.ce 1000
+.FR
+.ce 0
+
+.ad c
+.FR
+    &rArr; This is a small text fragment that shows
+    &rArr;              the differences
+    &rArr; between the &lsquo;.ce&rsquo; and the &lsquo;.ad c&rsquo; requests.
+    &rArr;
+    &rArr; This is a small text fragment that shows
+    &rArr;  the differences between the &lsquo;.ce&rsquo; and
+    &rArr;         the &lsquo;.ad c&rsquo; requests.
+</pre></div></div>
+
+<p>The previous example illustrates a common idiom of turning centering on
+for a quantity of lines far in excess of what is required, and off again
+after the text to be centered.  This technique relieves humans of
+counting lines for requests that take a count of input lines as an
+argument.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erj"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rj</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002erj'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rj"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002erj_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.rj</code></strong><a class="copiable-link" href='#index-_005cn_005b_002erj_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002erj-1"></a>
+<a class="index-entry-id" id="index-justifying-text-_0028rj_0029"></a>
+<a class="index-entry-id" id="index-text_002c-justifying-_0028rj_0029"></a>
+<a class="index-entry-id" id="index-right_002djustifying-_0028rj_0029"></a>
+<p>Break (unless the no-break control character is used), align the output
+of the next <var class="var">n</var> productive input lines to the right margin without
+filling, then break again regardless of the control character.
+If the argument is not positive, right-alignment is disabled.  Omitting
+the argument implies an <var class="var">n</var> of &lsquo;<samp class="samp">1</samp>&rsquo;.  The count of lines
+remaining to be right-aligned is stored in the read-only register
+<code class="code">.rj</code> and is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 49n
+.rj 3
+At first I hoped that such a technically unsound
+project would collapse but I soon realized it was
+doomed to success. \em C. A. R. Hoare
+    &rArr;  At first I hoped that such a technically unsound
+    &rArr; project would collapse but I soon realized it was
+    &rArr;              doomed to success. -- C. A. R. Hoare
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ess"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ss</code></strong> <var class="def-var-arguments">word-space-size <span class="r"><i class="slanted">additional-sentence-space-size</i></span></var><a class="copiable-link" href='#index-_002ess'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ss"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ess_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ss</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ess_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ess-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esss_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sss</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esss_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esss"></a>
+<a class="index-entry-id" id="index-word-space-size-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-size-of-word-space-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-space-between-words-register-_0028_002ess_0029"></a>
+<a class="index-entry-id" id="index-inter_002dsentence-space-size-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-sentence-space-size-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-size-of-sentence-space-register-_0028_002esss_0029"></a>
+<a class="index-entry-id" id="index-space-between-sentences-register-_0028_002esss_0029"></a>
+<p>Set the sizes of spaces between words and
+sentences<a class="footnote" id="DOCF55" href="groff.html_fot.html#FOOT55"><sup>55</sup></a> in twelfths
+of font&rsquo;s space width (typically one-fourth to one-third em for Western
+scripts).  The default for both parameters is&nbsp;12.  Negative values
+are erroneous.
+<a class="index-entry-id" id="index-inter_002dword-spacing_002c-minimal"></a>
+<a class="index-entry-id" id="index-minimal-inter_002dword-spacing"></a>
+<a class="index-entry-id" id="index-space_002c-between-words"></a>
+The first argument is a minimum; if an output line undergoes adjustment,
+such spaces may increase in width.
+<a class="index-entry-id" id="index-inter_002dsentence-space_002c-additional"></a>
+<a class="index-entry-id" id="index-additional-inter_002dsentence-space"></a>
+<a class="index-entry-id" id="index-space_002c-between-sentences"></a>
+The optional second argument sets the amount of additional space
+separating sentences on the same output line.  If omitted, this amount
+is set to <var class="var">word-space-size</var>.  The request is ignored if there are no
+parameters.
+</p>
+<a class="index-entry-id" id="index-filling_002c-and-inter_002dsentence-space"></a>
+<a class="index-entry-id" id="index-mode_002c-fill_002c-and-inter_002dsentence-space"></a>
+<p>Additional inter-sentence space is used only if the output line is not
+full when the end of a sentence occurs in the input.  If a sentence ends
+at the end of an input line, then both an inter-word space and an
+inter-sentence space are added to the output; if two spaces follow the
+end of a sentence in the middle of an input line, then the second space
+becomes an inter-sentence space in the output.  Additional
+inter-sentence space is not adjusted, but the inter-word space that
+always precedes it may be.  Further input spaces after the second, if
+present, are adjusted as normal.
+</p>
+<p>The read-only registers <code class="code">.ss</code> and <code class="code">.sss</code> hold the minimal
+inter-word space and additional inter-sentence space amounts,
+respectively.  These parameters are part of the environment
+(see <a class="pxref" href="Environments.html">Environments</a>), and rounded down to the nearest multiple
+of&nbsp;12 on terminals.
+</p>
+<a class="index-entry-id" id="index-discardable-horizontal-space"></a>
+<a class="index-entry-id" id="index-space_002c-discardable_002c-horizontal"></a>
+<a class="index-entry-id" id="index-horizontal-discardable-space"></a>
+<p>The <code class="code">ss</code> request can insert discardable horizontal space; that is,
+space that is discarded at a break.  For example, some footnote styles
+collect the notes into a single paragraph with large gaps between
+each note.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 48n
+1.\~J. Fict. Ch. Soc. 6 (2020), 3\en14.
+.ss 12 48 \&quot; applies to next sentence ending
+Reprints no longer available through FCS.
+.ss 12 \&quot; go back to normal
+2.\~Better known for other work.
+    &rArr; 1.  J.  Fict. Ch. Soc. 6 (2020), 3-14.  Reprints
+    &rArr; no longer available through FCS.      2.  Better
+    &rArr; known for other work.
+</pre></div></div>
+
+<p>If <em class="emph">undiscardable</em> space is required, use the <code class="code">\h</code> escape
+sequence.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a>, Previous: <a href="Registers.html">Registers</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Manipulating-Hyphenation.html Added

@@ -0,0 +1,580 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Manipulating Hyphenation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Manipulating Hyphenation (The GNU Troff Manual)">
+<meta name="keywords" content="Manipulating Hyphenation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Manipulating-Spacing.html" rel="next" title="Manipulating Spacing">
+<link href="Manipulating-Filling-and-Adjustment.html" rel="prev" title="Manipulating Filling and Adjustment">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Manipulating-Hyphenation">
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Spacing.html" accesskey="n" rel="next">Manipulating Spacing</a>, Previous: <a href="Manipulating-Filling-and-Adjustment.html" accesskey="p" rel="prev">Manipulating Filling and Adjustment</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Manipulating-Hyphenation-1">5.10 Manipulating Hyphenation</h3>
+<a class="index-entry-id" id="index-manipulating-hyphenation"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-manipulating"></a>
+
+<a class="index-entry-id" id="index-hyphenation_002c-automatic"></a>
+<a class="index-entry-id" id="index-automatic-hyphenation"></a>
+<p>When filling, GNU <code class="code">troff</code> hyphenates words as needed at
+user-specified and automatically determined hyphenation points.  The
+machine-driven determination of hyphenation points in words requires
+algorithms and data, and is susceptible to conventions and preferences.
+Before tackling such <em class="dfn">automatic hyphenation</em>, let us consider how
+hyphenation points can be set explicitly.
+</p>
+<a class="index-entry-id" id="index-hyphenation_002c-explicit"></a>
+<a class="index-entry-id" id="index-explicit-hyphenation"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-manual"></a>
+<a class="index-entry-id" id="index-manual-hyphenation"></a>
+<p>Explicitly hyphenated words such as &ldquo;mother-in-law&rdquo; are eligible for
+breaking after each of their hyphens.  Relatively few words in a
+language offer such obvious break points, however, and automatic
+detection of syllabic (or phonetic) boundaries for hyphenation is not
+perfect,<a class="footnote" id="DOCF56" href="groff.html_fot.html#FOOT56"><sup>56</sup></a> particularly for
+unusual words found in technical literature.  We can instruct GNU
+<code class="code">troff</code> how to hyphenate specific words if the need arises.
+</p>
+<a class="index-entry-id" id="index-hyphenation-exceptions"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehw"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hw</code></strong> <var class="def-var-arguments">word &hellip;</var><a class="copiable-link" href='#index-_002ehw'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hw"></a>
+<p>Define each <em class="dfn">hyphenation exception</em> <var class="var">word</var> with each hyphen &lsquo;-&rsquo;
+in the word indicating a hyphenation point.  For example, the request
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.hw in-sa-lub-rious alpha
+</pre></div></div>
+
+<p>marks potential hyphenation points in &ldquo;insalubrious&rdquo;, and prevents
+&ldquo;alpha&rdquo; from being hyphenated at all.
+</p>
+<p>Besides the space character, any character whose hyphenation code is
+zero can be used to separate the arguments of <code class="code">hw</code> (see the
+<code class="code">hcode</code> request below).  In addition, this request can be used more
+than once.
+</p>
+<a class="index-entry-id" id="index-hw-request_002c-and-hy-restrictions"></a>
+<p>Hyphenation points specified with <code class="code">hw</code> are not subject to the
+within-word placement restrictions imposed by the <code class="code">hy</code> request (see
+below).
+</p>
+<p>Hyphenation exceptions specified with the <code class="code">hw</code> request are
+associated with the hyphenation language (see the <code class="code">hla</code> request
+below) and environment (see <a class="pxref" href="Environments.html">Environments</a>); invoking the <code class="code">hw</code>
+request in the absence of a hyphenation language is an error.
+</p>
+<p>The request is ignored if there are no parameters.
+</p></dd></dl>
+
+<p>These are known as hyphenation <i class="slanted">exceptions</i> in the expectation
+that most users will avail themselves of automatic hyphenation; these
+exceptions override any rules that would normally apply to a word
+matching a hyphenation exception defined with <code class="code">hw</code>.
+</p>
+<p>Situations also arise when only a specific occurrence of a word needs
+its hyphenation altered or suppressed, or when a URL or similar string
+needs to be breakable in sensible places without hyphenation.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0025-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\%</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0025-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0025"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_003a-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\:</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_003a-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_003a"></a>
+<a class="index-entry-id" id="index-hyphenation-character-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-character_002c-hyphenation-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-disabling-hyphenation-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-hyphenation_002c-disabling-_0028_005c_0025_0029"></a>
+<p>To tell GNU <code class="code">troff</code> how to hyphenate words as they occur in input,
+use the <code class="code">\%</code> escape sequence; it is the default <em class="dfn">hyphenation
+character</em>.  Each instance within a word indicates to GNU <code class="code">troff</code>
+that the word may be hyphenated at that point, while prefixing a word
+with this escape sequence prevents it from being otherwise hyphenated.
+This mechanism affects only that occurrence of the word; to change the
+hyphenation of a word for the remainder of input processing, use the
+<code class="code">hw</code> request.
+</p>
+<a class="index-entry-id" id="index-_005cX_002c-followed-by-_005c_0025"></a>
+<a class="index-entry-id" id="index-_005cY_002c-followed-by-_005c_0025"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-following-_005cX-or-_005cY"></a>
+<p>GNU <code class="code">troff</code> regards the escape sequences <code class="code">\X</code> and <code class="code">\Y</code> as
+starting a word; that is, the <code class="code">\%</code> escape sequence in, say,
+&lsquo;<samp class="samp">\X'...'\%foobar</samp>&rsquo; or &lsquo;<samp class="samp">\Y'...'\%foobar</samp>&rsquo; no longer
+prevents hyphenation of &lsquo;<samp class="samp">foobar</samp>&rsquo; but inserts a hyphenation point
+just prior to it; most likely this isn&rsquo;t what you want.
+See <a class="xref" href="Postprocessor-Access.html">Postprocessor Access</a>.
+</p>
+<a class="index-entry-id" id="index-non_002dprinting-break-point-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-without-hyphens-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-file-names_002c-breaking-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-file-names-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-URLs_002c-breaking-_0028_005c_003a_0029"></a>
+<a class="index-entry-id" id="index-breaking-URLs-_0028_005c_003a_0029"></a>
+<p><code class="code">\:</code> inserts a non-printing break point; that is, a word can break
+there, but the soft hyphen glyph (see below) is not written to the
+output if it does.  This escape sequence is an input word boundary, so
+the remainder of the word is subject to hyphenation as normal.
+</p>
+<p>You can combine <code class="code">\:</code> and <code class="code">\%</code> to control breaking of a file
+name or URL, or to permit hyphenation only after certain explicit
+hyphens within a word.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">The \%Lethbridge-Stewart-\:\%Sackville-Baggins divorce
+was, in retrospect, inevitable once the contents of
+\%/var/log/\:\%httpd/\:\%access_log on the family web
+server came to light, revealing visitors from Hogwarts.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">char</i></span></var><a class="copiable-link" href='#index-_002ehc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hc"></a>
+<p>Change the hyphenation character to <var class="var">char</var>.  This character then
+works as the <code class="code">\%</code> escape sequence normally does, and thus no longer
+appears in the output.<a class="footnote" id="DOCF57" href="groff.html_fot.html#FOOT57"><sup>57</sup></a>  Without an
+argument, <code class="code">hc</code> resets the hyphenation character to <code class="code">\%</code> (the
+default).  The hyphenation character is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eshc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.shc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002eshc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-shc"></a>
+<a class="index-entry-id" id="index-soft-hyphen-character_002c-setting-_0028shc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-soft-hyphen_002c-setting-_0028shc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-soft-hyphen-_0028hy_0029"></a>
+<a class="index-entry-id" id="index-soft-hyphen-glyph-_0028hy_0029"></a>
+<a class="index-entry-id" id="index-char-request_002c-and-soft-hyphen-character"></a>
+<a class="index-entry-id" id="index-tr-request_002c-and-soft-hyphen-character"></a>
+<p>Set the <em class="dfn">soft hyphen character</em>, inserted when a word is hyphenated
+automatically or at a hyphenation character, to the ordinary or special
+character&nbsp;<var class="var">c</var>.<a class="footnote" id="DOCF58" href="groff.html_fot.html#FOOT58"><sup>58</sup></a>  If the argument is omitted, the soft
+hyphen character is set to the default, <code class="code">\hy</code>.  If no glyph for
+<var class="var">c</var> exists in the font in use at a potential hyphenation point, then
+the line is not broken there.  Neither character definitions (specified
+with the <code class="code">char</code> and similar requests) nor translations (specified
+with the <code class="code">tr</code> request) are applied to <var class="var">c</var>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-hyphenation-parameters_002c-automatic"></a>
+<a class="index-entry-id" id="index-automatic-hyphenation-parameters"></a>
+<p>Several requests influence automatic hyphenation.  Because conventions
+vary, a variety of hyphenation modes is available to the <code class="code">hy</code>
+request; these determine whether hyphenation will apply to a
+word prior to breaking a line at the end of a page (more or less; see
+below for details), and at which positions within that word
+automatically determined hyphenation points are permissible.  The places
+within a word that are eligible for hyphenation are determined by
+language-specific data and lettercase relationships.  Furthermore,
+hyphenation of a word might be suppressed due to a limit on
+consecutive hyphenated lines (<code class="code">hlm</code>), a minimum line length
+threshold (<code class="code">hym</code>), or because the line can instead be adjusted with
+additional inter-word space (<code class="code">hys</code>).
+</p>
+<a class="index-entry-id" id="index-hyphenation-mode-register-_0028_002ehy_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehy"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hy</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">mode</i></span></var><a class="copiable-link" href='#index-_002ehy'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hy"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehy_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hy</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehy_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehy-1"></a>
+<p>Set automatic hyphenation mode to <var class="var">mode</var>, an integer encoding
+conditions for hyphenation; if omitted, &lsquo;<samp class="samp">1</samp>&rsquo; is implied.  The
+hyphenation mode is available in the read-only register &lsquo;<samp class="samp">.hy</samp>&rsquo;; it
+is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).  The default
+hyphenation mode depends on the localization file loaded when GNU
+<code class="code">troff</code> starts up; see the <code class="code">hpf</code> request below.
+</p>
+<p>Typesetting practice generally does not avail itself of every
+opportunity for hyphenation, but the details differ by language and site
+mandates.  The hyphenation modes of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> were
+implemented with English-language publishing practices of the 1970s in
+mind, not a scrupulous enumeration of conceivable parameters.  GNU
+<code class="code">troff</code> extends those modes such that finer-grained control is
+possible, favoring compatibility with older implementations over a more
+intuitive arrangement.  The means of hyphenation mode control is a set
+of numbers that can be added up to encode the behavior
+sought.<a class="footnote" id="DOCF59" href="groff.html_fot.html#FOOT59"><sup>59</sup></a>  The entries in the
+following table are termed <em class="dfn">values</em>; the sum of the desired
+values is the <em class="dfn">mode</em>.
+</p>
+<dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>disables hyphenation.
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>enables hyphenation except after the first and before the last character
+of a word.
+</p></dd>
+</dl>
+
+<p>The remaining values &ldquo;imply&rdquo; 1; that is, they enable hyphenation
+under the same conditions as &lsquo;<samp class="samp">.hy 1</samp>&rsquo;, and then apply or lift
+restrictions relative to that basis.
+</p>
+<dl class="table">
+<dt><code class="code">2</code></dt>
+<dd><p>disables hyphenation of the last word on a page,<a class="footnote" id="DOCF60" href="groff.html_fot.html#FOOT60"><sup>60</sup></a> even for explicitly hyphenated words.
+</p>
+</dd>
+<dt><code class="code">4</code></dt>
+<dd><p>disables hyphenation before the last two characters of a word.
+</p>
+</dd>
+<dt><code class="code">8</code></dt>
+<dd><p>disables hyphenation after the first two characters of a word.
+</p>
+</dd>
+<dt><code class="code">16</code></dt>
+<dd><p>enables hyphenation before the last character of a word.
+</p>
+</dd>
+<dt><code class="code">32</code></dt>
+<dd><p>enables hyphenation after the first character of a word.
+</p></dd>
+</dl>
+
+<p>Apart from value&nbsp;2, restrictions imposed by the hyphenation mode
+are <em class="emph">not</em> respected for words whose hyphenations have been
+specified with the hyphenation character (&lsquo;<samp class="samp">\%</samp>&rsquo; by default) or the
+<code class="code">hw</code> request.
+</p>
+<p>Nonzero values in the previous table are additive.  For example,
+mode&nbsp;12 causes GNU <code class="code">troff</code> to hyphenate neither the last two
+nor the first two characters of a word.  Some values cannot be used
+together because they contradict; for instance, values 4 and&nbsp;16,
+and values 8 and&nbsp;32.  As noted, it is superfluous to add 1 to any
+non-zero even mode.
+</p>
+<a class="index-entry-id" id="index-hyphenation-pattern-files"></a>
+<a class="index-entry-id" id="index-pattern-files_002c-for-hyphenation"></a>
+<p>The automatic placement of hyphens in words is determined by
+<em class="dfn">pattern files</em>, which are derived from TeX and available for
+several languages.  The number of characters at the beginning of a word
+after which the first hyphenation point should be inserted is determined
+by the patterns themselves; it can&rsquo;t be reduced further without
+introducing additional, invalid hyphenation points (unfortunately, this
+information is not part of a pattern file&mdash;you have to know it in
+advance).  The same is true for the number of characters at the end of
+a word before the last hyphenation point should be inserted.  For
+example, you can supply the following input to &lsquo;<samp class="samp">echo $(nroff)</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 1
+.hy 48
+splitting
+</pre></div></div>
+
+<p>You will get
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">s- plit- t- in- g
+</pre></div></div>
+
+<p>instead of the correct &lsquo;split- ting&rsquo;.  English patterns as distributed
+with GNU <code class="code">troff</code> need two characters at the beginning and three
+characters at the end; this means that value&nbsp;4 of <code class="code">hy</code> is
+mandatory.  Value&nbsp;8 is possible as an additional restriction, but
+values&nbsp;16 and&nbsp;32 should be avoided, as should mode&nbsp;1.
+Modes&nbsp;4 and&nbsp;6 are typical.
+</p>
+<p>A table of left and right minimum character counts for hyphenation as
+needed by the patterns distributed with GNU <code class="code">troff</code> follows; see
+the <cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page for more information on GNU
+<code class="code">troff</code>&rsquo;s language macro files.
+</p>
+<table class="multitable">
+<thead><tr><th>language</th><th>pattern name</th><th>left min</th><th>right min</th></tr></thead>
+<tbody><tr><td>Czech</td><td>cs</td><td>2</td><td>2</td></tr>
+<tr><td>English</td><td>en</td><td>2</td><td>3</td></tr>
+<tr><td>French</td><td>fr</td><td>2</td><td>3</td></tr>
+<tr><td>German traditional</td><td>det</td><td>2</td><td>2</td></tr>
+<tr><td>German reformed</td><td>den</td><td>2</td><td>2</td></tr>
+<tr><td>Italian</td><td>it</td><td>2</td><td>2</td></tr>
+<tr><td>Swedish</td><td>sv</td><td>1</td><td>2</td></tr>
+</tbody>
+</table>
+
+<p>Hyphenation exceptions within pattern files (i.e., the words within a
+TeX <code class="code">\hyphenation</code> group) obey the hyphenation restrictions
+given by <code class="code">hy</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enh"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nh</code></strong><a class="copiable-link" href='#index-_002enh'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nh"></a>
+<p>Disable automatic hyphenation; i.e., set the hyphenation mode to&nbsp;0
+(see above).  The hyphenation mode of the last call to <code class="code">hy</code> is not
+remembered.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehpf"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpf</code></strong> <var class="def-var-arguments">pattern-file</var><a class="copiable-link" href='#index-_002ehpf'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ehpfa"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpfa</code></strong> <var class="def-var-arguments">pattern-file</var><a class="copiable-link" href='#index-_002ehpfa'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpfa"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ehpfcode"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hpfcode</code></strong> <var class="def-var-arguments">a b c d &hellip;</var><a class="copiable-link" href='#index-_002ehpfcode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hpfcode"></a>
+<a class="index-entry-id" id="index-hyphenation-patterns-_0028hpf_0029"></a>
+<a class="index-entry-id" id="index-patterns-for-hyphenation-_0028hpf_0029"></a>
+<p>Read hyphenation patterns from <var class="var">pattern-file</var>, which is sought
+in the same way that macro files are with the <code class="code">mso</code> request or the
+<samp class="option">-m<var class="var">name</var></samp> command-line option to <code class="code">groff</code>.  The
+<var class="var">pattern-file</var> should have the same format as (simple) TeX
+pattern files.  More specifically, the following scanning rules are
+implemented.
+</p>
+<ul class="itemize mark-bullet">
+<li>A percent sign starts a comment (up to the end of the line) even if
+preceded by a backslash.
+
+</li><li>&ldquo;Digraphs&rdquo; like <code class="code">\$</code> are not supported.
+
+</li><li><code class="code">^^<var class="var">xx</var></code> (where each <var class="var">x</var> is 0&ndash;9 or a&ndash;f) and
+<code class="code">^^<var class="var">c</var></code> (character <var class="var">c</var> in the code point range 0&ndash;127
+decimal) are recognized; other uses of <code class="code">^</code> cause an error.
+
+</li><li>No macro expansion is performed.
+
+</li><li><code class="code">hpf</code> checks for the expression <code class="code">\patterns{&hellip;}</code>
+(possibly with whitespace before or after the braces).  Everything
+between the braces is taken as hyphenation patterns.  Consequently,
+<code class="code">{</code> and <code class="code">}</code> are not allowed in patterns.
+
+</li><li>Similarly, <code class="code">\hyphenation{&hellip;}</code> gives a list of hyphenation
+exceptions.
+
+</li><li><code class="code">\endinput</code> is recognized also.
+
+</li><li>For backward compatibility, if <code class="code">\patterns</code> is missing, the whole
+file is treated as a list of hyphenation patterns (except that the
+<code class="code">%</code> character is recognized as the start of a comment).
+</li></ul>
+
+<p>The <code class="code">hpfa</code> request appends a file of patterns to the current list.
+</p>
+<p>The <code class="code">hpfcode</code> request defines mapping values for character codes in
+pattern files.  It is an older mechanism no longer used by GNU
+<code class="code">troff</code>&rsquo;s own macro files; for its successor, see <code class="code">hcode</code>
+below.  <code class="code">hpf</code> or <code class="code">hpfa</code> apply the mapping after reading the
+patterns but before replacing or appending to the active list of
+patterns.  Its arguments are pairs of character codes&mdash;integers from 0
+to&nbsp;255.  The request maps character code&nbsp;<var class="var">a</var> to
+code&nbsp;<var class="var">b</var>, code&nbsp;<var class="var">c</var> to code&nbsp;<var class="var">d</var>, and so on.
+Character codes that would otherwise be invalid in GNU <code class="code">troff</code> can
+be used.  By default, every code maps to itself except those for letters
+&lsquo;A&rsquo; to &lsquo;Z&rsquo;, which map to those for &lsquo;a&rsquo; to &lsquo;z&rsquo;.
+</p>
+<a class="index-entry-id" id="index-localization"></a>
+<a class="index-entry-id" id="index-troffrc-2"></a>
+<a class="index-entry-id" id="index-cs_002etmac"></a>
+<a class="index-entry-id" id="index-de_002etmac"></a>
+<a class="index-entry-id" id="index-en_002etmac"></a>
+<a class="index-entry-id" id="index-fr_002etmac"></a>
+<a class="index-entry-id" id="index-it_002etmac"></a>
+<a class="index-entry-id" id="index-ja_002etmac"></a>
+<a class="index-entry-id" id="index-sv_002etmac"></a>
+<a class="index-entry-id" id="index-zh_002etmac"></a>
+<p>The set of hyphenation patterns is associated with the language set by
+the <code class="code">hla</code> request (see below).  The <code class="code">hpf</code> request is usually
+invoked by a localization file loaded by the <samp class="file">troffrc</samp>
+file.<a class="footnote" id="DOCF61" href="groff.html_fot.html#FOOT61"><sup>61</sup></a>
+</p>
+<p>A second call to <code class="code">hpf</code> (for the same language) replaces the
+hyphenation patterns with the new ones.  Invoking <code class="code">hpf</code> or
+<code class="code">hpfa</code> causes an error if there is no hyphenation language.  If no
+<code class="code">hpf</code> request is specified (either in the document, in a file
+loaded at startup, or in a macro package), GNU <code class="code">troff</code> won&rsquo;t
+automatically hyphenate at all.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehcode"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hcode</code></strong> <var class="def-var-arguments">c1 code1 c2 code2 &hellip;</var><a class="copiable-link" href='#index-_002ehcode'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hcode"></a>
+<a class="index-entry-id" id="index-hyphenation-code-_0028hcode_0029"></a>
+<a class="index-entry-id" id="index-code_002c-hyphenation-_0028hcode_0029"></a>
+<p>Set the hyphenation code of character <var class="var">c1</var> to <var class="var">code1</var>, that of
+<var class="var">c2</var> to <var class="var">code2</var>, and so on.  A hyphenation code must be an
+ordinary character (not a special character escape sequence) other than
+a digit or a space.  The request is ignored if given no arguments.
+</p>
+<p>For hyphenation to work, hyphenation codes must be set up.  At
+startup, GNU <code class="code">troff</code> assigns hyphenation codes to the letters
+&lsquo;<samp class="samp">a</samp>&rsquo;&ndash;&lsquo;<samp class="samp">z</samp>&rsquo; (mapped to themselves), to the letters
+&lsquo;<samp class="samp">A</samp>&rsquo;&ndash;&lsquo;<samp class="samp">Z</samp>&rsquo; (mapped to &lsquo;<samp class="samp">a</samp>&rsquo;&ndash;&lsquo;<samp class="samp">z</samp>&rsquo;), and zero to all other
+characters.  Normally, hyphenation patterns contain only lowercase
+letters which should be applied regardless of case.  In other words,
+they assume that the words &lsquo;FOO&rsquo; and &lsquo;Foo&rsquo; should be hyphenated exactly
+as &lsquo;foo&rsquo; is.  The <code class="code">hcode</code> request extends this principle to letters
+outside the Unicode basic Latin alphabet; without it, words containing
+such letters won&rsquo;t be hyphenated properly even if the corresponding
+hyphenation patterns contain them.
+</p>
+<p>For example, the following <code class="code">hcode</code> requests are necessary to assign
+hyphenation codes to the letters &lsquo;<samp class="samp">ÄäÖöÜüß</samp>&rsquo;, needed for German.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.hcode ä ä  Ä ä
+.hcode ö ö  Ö ö
+.hcode ü ü  Ü ü
+.hcode ß ß
+</pre></div></div>
+
+<p>Without these assignments, GNU <code class="code">troff</code> treats the German word
+&lsquo;Kindergärten&rsquo; (the plural form of &lsquo;kindergarten&rsquo;) as two words
+&lsquo;kinderg&rsquo; and &lsquo;rten&rsquo; because the hyphenation code of the
+umlaut&nbsp;a is zero by default, just like a space.  There is a German
+hyphenation pattern that covers &lsquo;kinder&rsquo;, so GNU <code class="code">troff</code> finds
+the hyphenation &lsquo;kin-der&rsquo;.  The other two hyphenation points
+(&lsquo;kin-der-gär-ten&rsquo;) are missed.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehla"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hla</code></strong> <var class="def-var-arguments">lang</var><a class="copiable-link" href='#index-_002ehla'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hla"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehla_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hla</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehla_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehla-1"></a>
+<a class="index-entry-id" id="index-hpf-request_002c-and-hyphenation-language"></a>
+<a class="index-entry-id" id="index-hw-request_002c-and-hyphenation-language"></a>
+<a class="index-entry-id" id="index-troffrc-3"></a>
+<a class="index-entry-id" id="index-troffrc_002dend-1"></a>
+<p>Set the hyphenation language to <var class="var">lang</var>.  Hyphenation exceptions
+specified with the <code class="code">hw</code> request and hyphenation patterns and
+exceptions specified with the <code class="code">hpf</code> and <code class="code">hpfa</code> requests are
+associated with the hyphenation language.  The <code class="code">hla</code> request is
+usually invoked by a localization file, which is turn loaded by the
+<samp class="file">troffrc</samp> or <samp class="file">troffrc-end</samp> file; see the <code class="code">hpf</code> request
+above.
+</p>
+<a class="index-entry-id" id="index-hyphenation-language-register-_0028_002ehla_0029"></a>
+<p>The hyphenation language is available in the read-only string-valued
+register &lsquo;<samp class="samp">.hla</samp>&rsquo;; it is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehlm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hlm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002ehlm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hlm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehlm_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hlm</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehlm_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehlm-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehlc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hlc</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehlc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehlc"></a>
+<a class="index-entry-id" id="index-explicit-hyphen-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-hyphen_002c-explicit-_0028_005c_0025_0029"></a>
+<a class="index-entry-id" id="index-consecutive-hyphenated-lines-_0028hlm_0029"></a>
+<a class="index-entry-id" id="index-lines_002c-consecutive-hyphenated-_0028hlm_0029"></a>
+<a class="index-entry-id" id="index-hyphenated-lines_002c-consecutive-_0028hlm_0029"></a>
+<p>Set the maximum quantity of consecutive hyphenated lines to <var class="var">n</var>.  If
+<var class="var">n</var> is negative, there is no maximum.  If omitted, <var class="var">n</var>
+is&nbsp;&minus;1.  This value is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).  Only lines output from a given environment
+count toward the maximum associated with that environment.  Hyphens
+resulting from <code class="code">\%</code> are counted; explicit hyphens are not.
+</p>
+<a class="index-entry-id" id="index-hyphenation-consecutive-line-limit-register-_0028_002ehlm_0029"></a>
+<a class="index-entry-id" id="index-hyphenation-consecutive-line-count-register-_0028_002ehlc_0029"></a>
+<p>The <code class="code">.hlm</code> read-only register stores this maximum.  The count of
+immediately preceding consecutive hyphenated lines is available in the
+read-only register <code class="code">.hlc</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehym"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hym</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002ehym'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hym"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehym_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hym</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehym_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehym-1"></a>
+<a class="index-entry-id" id="index-hyphenation-margin-_0028hym_0029"></a>
+<a class="index-entry-id" id="index-margin-for-hyphenation-_0028hym_0029"></a>
+<a class="index-entry-id" id="index-ad-request_002c-and-hyphenation-margin"></a>
+<p>Set the (right) hyphenation margin to <var class="var">length</var>.  If the adjustment
+mode is not &lsquo;<samp class="samp">b</samp>&rsquo; or &lsquo;<samp class="samp">n</samp>&rsquo;, the line is not hyphenated if it is
+shorter than <var class="var">length</var>.  Without an argument, the hyphenation margin
+is reset to its default value, 0.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+The hyphenation margin is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>A negative argument resets the hyphenation margin to zero, emitting a
+warning in category &lsquo;<samp class="samp">range</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-hyphenation-margin-register-_0028_002ehym_0029"></a>
+<p>The hyphenation margin is available in the <code class="code">.hym</code> read-only
+register.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ehys"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.hys</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">hyphenation-space</i></span></var><a class="copiable-link" href='#index-_002ehys'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hys"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ehys_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.hys</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ehys_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ehys-1"></a>
+<a class="index-entry-id" id="index-hyphenation-space-_0028hys_0029"></a>
+<a class="index-entry-id" id="index-hyphenation-space-adjustment-threshold"></a>
+<a class="index-entry-id" id="index-ad-request_002c-and-hyphenation-space"></a>
+<p>Suppress hyphenation of the line in adjustment modes &lsquo;<samp class="samp">b</samp>&rsquo; or
+&lsquo;<samp class="samp">n</samp>&rsquo; if it can be justified by adding no more than
+<var class="var">hyphenation-space</var> extra space to each inter-word space.  Without
+an argument, the hyphenation space adjustment threshold is set to its
+default value, 0.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  The
+hyphenation space adjustment threshold is associated with the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>A negative argument resets the hyphenation space adjustment threshold to
+zero, emitting a warning in category &lsquo;<samp class="samp">range</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-hyphenation-space-adjustment-threshold-register-_0028_002ehys_0029"></a>
+<p>The hyphenation space adjustment threshold is available in the
+<code class="code">.hys</code> read-only register.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Spacing.html">Manipulating Spacing</a>, Previous: <a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Manipulating-Spacing.html Added

@@ -0,0 +1,220 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Manipulating Spacing (The GNU Troff Manual)</title>
+
+<meta name="description" content="Manipulating Spacing (The GNU Troff Manual)">
+<meta name="keywords" content="Manipulating Spacing (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Tabs-and-Fields.html" rel="next" title="Tabs and Fields">
+<link href="Manipulating-Hyphenation.html" rel="prev" title="Manipulating Hyphenation">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Manipulating-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="Tabs-and-Fields.html" accesskey="n" rel="next">Tabs and Fields</a>, Previous: <a href="Manipulating-Hyphenation.html" accesskey="p" rel="prev">Manipulating Hyphenation</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Manipulating-Spacing-1">5.11 Manipulating Spacing</h3>
+<a class="index-entry-id" id="index-manipulating-spacing"></a>
+<a class="index-entry-id" id="index-spacing_002c-manipulating"></a>
+
+<p>A break causes the formatter to update the vertical drawing position at
+which the new text baseline is aligned.  You can alter this location.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">distance</i></span></var><a class="copiable-link" href='#index-_002esp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sp"></a>
+<p>Break and move the next text baseline down by <var class="var">distance</var>, or until
+springing a page location trap.<a class="footnote" id="DOCF62" href="groff.html_fot.html#FOOT62"><sup>62</sup></a>
+If invoked with the no-break control character, <code class="code">sp</code> moves the
+pending output line&rsquo;s text baseline by <var class="var">distance</var>.  A negative
+<var class="var">distance</var> will not reduce the position of the text baseline below
+zero.  Inside a diversion, any <var class="var">distance</var> argument is ignored.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">distance</var> is not specified,
+&lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 5v \&quot; Set page length to 5 vees.
+.de xx
+\-\-\-
+.  br
+..
+.wh 0 xx \&quot; Set a trap at the top of the page.
+foo on page \n%
+.sp 2v
+bar on page \n%
+.sp 50v \&quot; This will cause a page break.
+baz on page \n%
+.pl \n(nlu \&quot; Truncate page to current position.
+    &rArr; ---
+    &rArr; foo on page 1
+    &rArr;
+    &rArr;
+    &rArr; bar on page 1
+    &rArr; ---
+    &rArr; baz on page 2
+</pre></div></div>
+
+<p>You might use the following macros to set the baseline of the next
+output text at a given distance from the top or the bottom of the page.
+We subtract one line height (<code class="code">\n.v</code>) because the <code class="code">|</code>
+operator moves to one vee below the page top (recall <a class="ref" href="Numeric-Expressions.html">Numeric Expressions</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de y-from-top-down
+.  sp |\\$1-\\n.vu
+..
+.
+.de y-from-bot-up
+.  sp |\\n.pu-\\$1-\\n.vu
+..
+</pre></div></div>
+
+<p>A call to &lsquo;<samp class="samp">.y-from-bot-up 10c</samp>&rsquo; means that the next text baseline
+will be 10&nbsp;cm from the bottom edge of the paper.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002els"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ls</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">count</i></span></var><a class="copiable-link" href='#index-_002els'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ls"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eL_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.L</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eL_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eL"></a>
+<a class="index-entry-id" id="index-double_002dspacing-_0028ls_0029"></a>
+<p>Set the line spacing; add <var class="var">count</var>&minus;1 blank lines after each
+line of text.  With no argument, GNU <code class="code">troff</code> uses the previous
+value before the last <code class="code">ls</code> call.  The default is <code class="code">1</code>.
+</p>
+
+<a class="index-entry-id" id="index-line-spacing-register-_0028_002eL_0029"></a>
+<p>The read-only register <code class="code">.L</code> contains the current line spacing; it
+is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<p>The <code class="code">ls</code> request is a coarse mechanism.  See <a class="xref" href="Changing-the-Type-Size.html">Changing the Type Size</a>, for the requests <code class="code">vs</code> and <code class="code">pvs</code> as alternatives to
+<code class="code">ls</code>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cx_0027spacing_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\x<code class="code">'</code></code><span class="r"><i class="slanted">spacing</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cx_0027spacing_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ea_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.a</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ea_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ea"></a>
+<p>Sometimes, an output line requires additional vertical spacing, for
+instance to allow room for a tall construct like an inline equation with
+exponents or subscripts (particularly if they are iterated).  The
+<code class="code">\x</code> escape sequence takes a delimited measurement (like
+&lsquo;<samp class="samp">\x'3p'</samp>&rsquo;) to increase the vertical spacing of the pending output
+line.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  If the measurement is
+positive, extra vertical space is inserted below the current line; a
+negative measurement adds space above.  If <code class="code">\x</code> is applied to the
+pending output line multiple times, the maxima of the positive and
+negative adjustments are separately applied.  The delimiter need not be
+a neutral apostrophe; see <a class="ref" href="Delimiters.html">Delimiters</a>.
+</p>
+<a class="index-entry-id" id="index-extra-post_002dvertical-line-space-register-_0028_002ea_0029"></a>
+<p>The <code class="code">.a</code> read-only register contains the extra vertical spacing
+<em class="emph">after</em> the text baseline of the most recently emitted output line.
+(In other words, it is the largest positive argument to <code class="code">\x</code>
+encountered on that line.)  This quantity is exposed via a register
+because if an output line requires this &ldquo;extra post-vertical line
+spacing&rdquo;, and the subsequent output line requires &ldquo;extra pre-vertical
+line spacing&rdquo; (a negative argument to <code class="code">\x</code>), then applying both
+can lead to excessive spacing between the output lines.  Text that is
+piling high on line <var class="var">n</var> might not require (as much) extra
+pre-vertical line spacing if line <var class="var">n</var>&minus;1 carries extra
+post-vertical line spacing.
+</p>
+<p>Use of <code class="code">\x</code> can be necessary in combination with the
+bracket-building escape sequence <code class="code">\b</code>,<a class="footnote" id="DOCF63" href="groff.html_fot.html#FOOT63"><sup>63</sup></a> as the following example shows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+This is a test of \rsb (1).
+This is a test of \rsb (2).
+This is a test of \b'xyz'\x'-1m'\x'1m' (3).
+This is a test of \rsb (4).
+This is a test of \rsb (5).
+    &rArr; This is a test of \b (1).
+    &rArr; This is a test of \b (2).
+    &rArr;                   x
+    &rArr; This is a test of y (3).
+    &rArr;                   z
+    &rArr; This is a test of \b (4).
+    &rArr; This is a test of \b (5).
+</pre></div></div>
+</dd></dl>
+
+<p>Without <code class="code">\x</code>, the backslashes on the lines marked &lsquo;<samp class="samp">(2)</samp>&rsquo; and
+&lsquo;<samp class="samp">(4)</samp>&rsquo; would be overprinted.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ens"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ns</code></strong><a class="copiable-link" href='#index-_002ens'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ns"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ers"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rs</code></strong><a class="copiable-link" href='#index-_002ers'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ens_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ns</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ens_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ens-1"></a>
+<a class="index-entry-id" id="index-sp-request_002c-and-no_002dspace-mode"></a>
+<a class="index-entry-id" id="index-no_002dspace-mode-_0028ns_0029"></a>
+<a class="index-entry-id" id="index-mode_002c-no_002dspace-_0028ns_0029"></a>
+<a class="index-entry-id" id="index-blank-lines_002c-disabling"></a>
+<a class="index-entry-id" id="index-lines_002c-blank_002c-disabling"></a>
+<p>Enable <em class="dfn">no-space mode</em>.  Vertical spacing, whether by <code class="code">sp</code>
+requests or blank input lines, is disabled.  The <code class="code">bp</code> request to
+advance to the next page is also disabled, unless it is accompanied by a
+page number (see <a class="pxref" href="Page-Control.html">Page Control</a>).  No-space mode ends automatically
+when text<a class="footnote" id="DOCF64" href="groff.html_fot.html#FOOT64"><sup>64</sup></a> is formatted for output <a class="footnote" id="DOCF65" href="groff.html_fot.html#FOOT65"><sup>65</sup></a> or the <code class="code">rs</code> request is invoked, which ends
+no-space mode.  The read-only register <code class="code">.ns</code> interpolates a Boolean
+value indicating the enablement of no-space mode.
+</p>
+<p>A paragraphing macro might ordinarily insert vertical space to separate
+paragraphs.  A section heading macro could invoke <code class="code">ns</code> to suppress
+this spacing for the first paragraph in a section.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Tabs-and-Fields.html">Tabs and Fields</a>, Previous: <a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Manipulating-Type-Size-and-Vertical-Spacing.html Added

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Manipulating Type Size and Vertical Spacing (The GNU Troff Manual)</title>
+
+<meta name="description" content="Manipulating Type Size and Vertical Spacing (The GNU Troff Manual)">
+<meta name="keywords" content="Manipulating Type Size and Vertical Spacing (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Colors.html" rel="next" title="Colors">
+<link href="Using-Fonts.html" rel="prev" title="Using Fonts">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Manipulating-Type-Size-and-Vertical-Spacing">
+<div class="nav-panel">
+<p>
+Next: <a href="Colors.html" accesskey="n" rel="next">Colors</a>, Previous: <a href="Using-Fonts.html" accesskey="p" rel="prev">Using Fonts</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Manipulating-Type-Size-and-Vertical-Spacing-1">5.20 Manipulating Type Size and Vertical Spacing</h3>
+<a class="index-entry-id" id="index-manipulating-type-size-and-vertical-spacing"></a>
+
+<a class="index-entry-id" id="index-text-baseline-1"></a>
+<a class="index-entry-id" id="index-baseline_002c-text-1"></a>
+<a class="index-entry-id" id="index-type-size"></a>
+<a class="index-entry-id" id="index-size_002c-size"></a>
+<a class="index-entry-id" id="index-vertical-spacing-1"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical-1"></a>
+<p>These concepts were introduced in <a class="ref" href="Page-Geometry.html">Page Geometry</a>.  The height of a
+font&rsquo;s tallest glyph is one em, which is equal to the type size in
+points.<a class="footnote" id="DOCF82" href="groff.html_fot.html#FOOT82"><sup>82</sup></a>  A vertical spacing of less than 120% of
+the type size can make a document hard to read.  Larger proportions can
+be useful to spread the text for annotations or proofreader&rsquo;s marks.  By
+default, GNU <code class="code">troff</code> uses 10&nbsp;point type on 12&nbsp;point
+spacing.
+<a class="index-entry-id" id="index-leading"></a>
+Typographers call the difference between type size and vertical spacing
+<em class="dfn">leading</em>.<a class="footnote" id="DOCF83" href="groff.html_fot.html#FOOT83"><sup>83</sup></a>
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Changing-the-Type-Size.html" accesskey="1">Changing the Type Size</a></li>
+<li><a href="Changing-the-Vertical-Spacing.html" accesskey="2">Changing the Vertical Spacing</a></li>
+<li><a href="Using-Fractional-Type-Sizes.html" accesskey="3">Using Fractional Type Sizes</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Measurements.html Added

@@ -0,0 +1,177 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Measurements (The GNU Troff Manual)</title>
+
+<meta name="description" content="Measurements (The GNU Troff Manual)">
+<meta name="keywords" content="Measurements (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Numeric-Expressions.html" rel="next" title="Numeric Expressions">
+<link href="Text.html" rel="prev" title="Text">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Measurements">
+<div class="nav-panel">
+<p>
+Next: <a href="Numeric-Expressions.html" accesskey="n" rel="next">Numeric Expressions</a>, Previous: <a href="Text.html" accesskey="p" rel="prev">Text</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Measurements-1">5.3 Measurements</h3>
+<a class="index-entry-id" id="index-measurements"></a>
+<a class="index-entry-id" id="index-scaling-indicator"></a>
+<a class="index-entry-id" id="index-indicator_002c-scaling"></a>
+
+<a class="index-entry-id" id="index-units-of-measurement"></a>
+<a class="index-entry-id" id="index-measurement-units"></a>
+<p>The formatter sometimes requires the input of numeric parameters to
+specify measurements.  These are specified as integers or decimal
+fractions with an optional <em class="dfn">scaling unit</em> suffixed.  A scaling unit
+is a letter that immediately follows the last digit of a number.  Digits
+after the decimal point are optional.  Measurement expressions include
+&lsquo;<samp class="samp">10.5p</samp>&rsquo;, &lsquo;<samp class="samp">11i</samp>&rsquo;, and &lsquo;<samp class="samp">3.c</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-basic-units_002c-conversion-to"></a>
+<a class="index-entry-id" id="index-units_002c-basic_002c-conversion-to"></a>
+<a class="index-entry-id" id="index-conversion-to-basic-units"></a>
+<p>Measurements are scaled by the scaling unit and stored internally (with
+any fractional part discarded) in basic units.
+<a class="index-entry-id" id="index-device-resolution_002c-obtaining-in-the-formatter"></a>
+<a class="index-entry-id" id="index-resolution_002c-device_002c-obtaining-in-the-formatter"></a>
+The device resolution can therefore be obtained by storing a value of
+&lsquo;<samp class="samp">1i</samp>&rsquo; to a register.  The only constraint on the basic unit is that
+it is at least as small as any other unit.
+</p>
+<dl class="table">
+<dd><a class="index-entry-id" id="index-basic-scaling-unit-_0028u_0029"></a>
+<a class="index-entry-id" id="index-u-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-u"></a>
+<a class="index-entry-id" id="index-scaling-unit-u"></a>
+</dd>
+<dt><code class="code">u</code></dt>
+<dd><p>Basic unit.
+</p>
+</dd>
+<dt id='index-inch-scaling-unit-_0028i_0029'><span><code class="code">i</code><a class="copiable-link" href='#index-inch-scaling-unit-_0028i_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-i-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-i"></a>
+<a class="index-entry-id" id="index-scaling-unit-i"></a>
+<p>Inch; defined as 2.54&nbsp;centimeters.
+</p>
+</dd>
+<dt id='index-centimeter-scaling-unit-_0028c_0029'><span><code class="code">c</code><a class="copiable-link" href='#index-centimeter-scaling-unit-_0028c_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-c-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-c"></a>
+<a class="index-entry-id" id="index-scaling-unit-c"></a>
+<p>Centimeter; a centimeter is about 0.3937&nbsp;inches.
+</p>
+</dd>
+<dt id='index-point-scaling-unit-_0028p_0029'><span><code class="code">p</code><a class="copiable-link" href='#index-point-scaling-unit-_0028p_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-p-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-p"></a>
+<a class="index-entry-id" id="index-scaling-unit-p"></a>
+<p>Point; a typesetter&rsquo;s unit used for measuring type size.
+There are 72&nbsp;points to an inch.
+</p>
+</dd>
+<dt id='index-pica-scaling-unit-_0028P_0029'><span><code class="code">P</code><a class="copiable-link" href='#index-pica-scaling-unit-_0028P_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-P-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-P"></a>
+<a class="index-entry-id" id="index-scaling-unit-P"></a>
+<p>Pica; another typesetter&rsquo;s unit.  There are 6&nbsp;picas to an inch and
+12&nbsp;points to a pica.
+</p>
+</dd>
+<dt><code class="code">s</code></dt>
+<dt><code class="code">z</code></dt>
+<dd><p>See <a class="xref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>, for a discussion of these units.
+</p>
+</dd>
+<dt><code class="code">f</code></dt>
+<dd><p>GNU <code class="code">troff</code> defines this unit to scale decimal fractions in the
+interval 0, 1 to 16-bit unsigned integers.  It multiplies a quantity
+by 65,536.  See <a class="xref" href="Colors.html">Colors</a>, for usage.
+</p></dd>
+</dl>
+
+<p>The magnitudes of other scaling units depend on the text formatting
+parameters in effect.  These are useful when specifying measurements
+that need to scale with the typeface or vertical spacing.
+</p>
+<dl class="table">
+<dt id='index-em-scaling-unit-_0028m_0029'><span><code class="code">m</code><a class="copiable-link" href='#index-em-scaling-unit-_0028m_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-m-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-m"></a>
+<a class="index-entry-id" id="index-scaling-unit-m"></a>
+<p>Em; an em is equal to the current type size in points.  It is named thus
+because it is approximately the width of the letter&nbsp;&lsquo;<samp class="samp">M</samp>&rsquo;.
+</p>
+</dd>
+<dt id='index-en-scaling-unit-_0028n_0029'><span><code class="code">n</code><a class="copiable-link" href='#index-en-scaling-unit-_0028n_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-n-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-n"></a>
+<a class="index-entry-id" id="index-scaling-unit-n"></a>
+<p>En; an en is one-half em.
+</p>
+</dd>
+<dt id='index-vertical-space-unit-_0028v_0029'><span><code class="code">v</code><a class="copiable-link" href='#index-vertical-space-unit-_0028v_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-space_002c-vertical_002c-unit-_0028v_0029"></a>
+<a class="index-entry-id" id="index-vee-scaling-unit-_0028v_0029"></a>
+<a class="index-entry-id" id="index-v-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-v"></a>
+<a class="index-entry-id" id="index-scaling-unit-v"></a>
+<p>Vee; recall <a class="ref" href="Page-Geometry.html">Page Geometry</a>.
+</p>
+</dd>
+<dt id='index-M-scaling-unit'><span><code class="code">M</code><a class="copiable-link" href='#index-M-scaling-unit'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-unit_002c-scaling_002c-M"></a>
+<a class="index-entry-id" id="index-scaling-unit-M"></a>
+<p>Hundredth of an em.
+</p></dd>
+</dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Motion-Quanta.html" accesskey="1">Motion Quanta</a></li>
+<li><a href="Default-Units.html" accesskey="2">Default Units</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Numeric-Expressions.html">Numeric Expressions</a>, Previous: <a href="Text.html">Text</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Miscellaneous.html Added

@@ -0,0 +1,275 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Miscellaneous (The GNU Troff Manual)</title>
+
+<meta name="description" content="Miscellaneous (The GNU Troff Manual)">
+<meta name="keywords" content="Miscellaneous (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Gtroff-Internals.html" rel="next" title="Gtroff Internals">
+<link href="Postprocessor-Access.html" rel="prev" title="Postprocessor Access">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Miscellaneous">
+<div class="nav-panel">
+<p>
+Next: <a href="Gtroff-Internals.html" accesskey="n" rel="next"><code class="code">gtroff</code> Internals</a>, Previous: <a href="Postprocessor-Access.html" accesskey="p" rel="prev">Postprocessor Access</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Miscellaneous-1">5.35 Miscellaneous</h3>
+
+<p>We document here GNU <code class="code">troff</code> features that fit poorly elsewhere.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nm</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">start</i></span> <span class="r"><i class="slanted">increment</i></span> <span class="r"><i class="slanted">space</i></span> <span class="r"><i class="slanted">indentation</i></span></var><a class="copiable-link" href='#index-_002enm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nm"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bln_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nln</code></strong><a class="copiable-link" href='#index-_005cn_005bln_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ln"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002enm_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.nm</code></strong><a class="copiable-link" href='#index-_005cn_005b_002enm_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002enm-1"></a>
+<a class="index-entry-id" id="index-printing-line-numbers-_0028nm_0029"></a>
+<a class="index-entry-id" id="index-line-numbers_002c-printing-_0028nm_0029"></a>
+<a class="index-entry-id" id="index-numbers_002c-line_002c-printing-_0028nm_0029"></a>
+<p>Begin (or, with no arguments, cease) numbering output lines.
+<var class="var">start</var> assigns the number of the <em class="emph">next</em> output line.  Only
+line numbers divisible by <var class="var">increment</var> are marked (default:
+&lsquo;<samp class="samp">1</samp>&rsquo;).  <var class="var">space</var> configures the horizontal spacing between the
+number and the text (default: &lsquo;<samp class="samp">1</samp>&rsquo;).  Any given <var class="var">indentation</var> is
+applied to the numbers (default: &lsquo;<samp class="samp">0</samp>&rsquo;).  The third and fourth
+arguments are reckoned in numeral widths (<code class="code">\0</code>).  <var class="var">start</var> must
+be non-negative and <var class="var">increment</var> positive.
+</p>
+<p>The formatter aligns the number to the right in a width of three numeral
+spaces plus <var class="var">indentation</var>, then catenates <var class="var">space</var> and the output
+line.  The line length is <em class="emph">not</em> reduced.  Depending on the value of
+the page offset,<a class="footnote" id="DOCF117" href="groff.html_fot.html#FOOT117"><sup>117</sup></a> numbers wider than
+the allocated space protrude into the left margin, or shift the output
+line to the right.
+</p>
+<p>Line numbering parameters corresponding to missing arguments are not
+altered.  After numbering is disabled, &lsquo;<samp class="samp">.nm +0</samp>&rsquo; resumes it using
+the previously active parameters.
+</p>
+<p>The parameters of <code class="code">nm</code> are associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-output-line-number-register-_0028ln_0029"></a>
+<a class="index-entry-id" id="index-line-number_002c-output_002c-register-_0028ln_0029"></a>
+<p>While numbering is enabled, the output line number register <code class="code">ln</code> is
+updated as each line is output, even if no line number is formatted with
+it because it is being skipped (it is not a multiple of <var class="var">increment</var>)
+or because numbering is suppressed (see the <code class="code">nn</code> request below).
+</p>
+<p>The <code class="code">.nm</code> register tracks the enablement status of numbering.
+Temporary suspension of numbering with the <code class="code">nn</code> request does
+<em class="emph">not</em> alter its value.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.po 5n
+.ll 44n
+Programming,
+when stripped of all its circumstantial irrelevancies,
+.nm 999 1 1 -4
+boils down to no more and no less than
+.nm +0 3
+very effective thinking so as to avoid unmastered
+.nn 2
+complexity,
+to very vigorous separation of your many
+different concerns.
+.br
+\(em Edsger Dijkstra
+.sp
+.nm 1 1 1
+This guy's arrogance takes your breath away.
+.br
+\(em John Backus
+    &rArr;      Programming,  when  stripped of all its cir-
+    &rArr;  999 cumstantial irrelevancies, boils down to  no
+    &rArr;      more  and no less than very effective think-
+    &rArr;      ing so as to avoid unmastered complexity, to
+    &rArr;      very vigorous separation of your  many  dif-
+    &rArr;      ferent concerns.
+    &rArr; 1002 -- Edsger Dijkstra
+    &rArr;
+    &rArr;    1 This guy&rsquo;s arrogance takes your breath away.
+    &rArr;    2 -- John Backus
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">skip</i></span></var><a class="copiable-link" href='#index-_002enn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002enn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.nn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002enn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002enn-1"></a>
+<p>Suppress numbering of the next <var class="var">skip</var> output lines that would
+otherwise be numbered.  The default is&nbsp;1.  <code class="code">nn</code> can be invoked
+when line numbering is not active; suppression of numbering will take
+effect for <var class="var">skip</var> lines once <code class="code">nm</code> enables it.
+</p>
+<p>The <code class="code">.nn</code> register stores the count of output lines still to have
+their numbering suppressed.
+</p>
+<p>This count is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<p>To test whether the current output line will be numbered, you must check
+both the <code class="code">.nm</code> and <code class="code">.nn</code> registers.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  .de is-numbered
+  .  nop This line
+  .  ie (\\n.nm &amp; (1-\\n.nn)) IS
+  .  el                           ISN'T
+  .  nop numbered.
+  .  br
+  ..
+  Test line numbering.
+  .is-numbered
+  .nm 1
+  .nn 1
+  .is-numbered
+  .is-numbered
+  .nm
+  .is-numbered
+    &rArr; Test line numbering.  This line ISN&rsquo;T numbered.
+    &rArr; This line ISN&rsquo;T numbered.
+    &rArr;   1 This line IS numbered.
+    &rArr; This line ISN&rsquo;T numbered.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">margin-character</i></span> <span class="r"><i class="slanted">distance</i></span></var><a class="copiable-link" href='#index-_002emc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mc"></a>
+<a class="index-entry-id" id="index-margin-glyph-_0028mc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-for-margins-_0028mc_0029"></a>
+<p>Begin (or, with no arguments, cease) writing a <em class="dfn">margin-character</em> to
+the right of each output line.  The <var class="var">distance</var> argument separates
+<var class="var">margin-character</var> from the right margin.  If absent, the most
+recent value is used; the default is 10&nbsp;points.  If an output line
+exceeds the line length, the margin character is appended to it.
+<a class="index-entry-id" id="index-tl-request_002c-and-mc"></a>
+No margin character is written on lines produced by the <code class="code">tl</code>
+request.
+</p>
+<p>The margin character is a property of the output line; the margin
+character last configured when the line is output controls.  If the
+margin character is disabled before an output line breaks, none is
+output (but see below).
+</p>
+<p>The margin character is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 5i
+.nf
+.mc \br
+This paragraph is marked with a margin character.
+.sp
+As seen above, vertical space isn't thus marked.
+\&amp;
+An output line that is present, but empty, is.
+    &rArr; This paragraph is marked with a margin character.  |
+    &rArr;
+    &rArr; As seen above, vertical space isn&rsquo;t thus marked.   |
+    &rArr;                                                    |
+    &rArr; An output line that is present, but empty, is.     |
+</pre></div></div>
+</dd></dl>
+
+<p>For compatibility with <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, a call to <code class="code">mc</code>
+to set the margin character can&rsquo;t be undone immediately; at least one
+line gets a margin character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 10n
+.nf
+.mc |
+.mc *
+.mc
+foo
+bar
+    &rArr; foo        *
+    &rArr; bar
+</pre></div></div>
+
+<a class="index-entry-id" id="index-gdiffmk"></a>
+<a class="index-entry-id" id="index-nrchbar"></a>
+<a class="index-entry-id" id="index-changebar"></a>
+<a class="index-entry-id" id="index-diffmk"></a>
+<p>The margin character mechanism is commonly used to annotate changes in
+documents.  The <code class="code">groff</code> distribution ships a program,
+<code class="command">gdiffmk</code>, to assist with this task.<a class="footnote" id="DOCF118" href="groff.html_fot.html#FOOT118"><sup>118</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epsbb"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.psbb</code></strong> <var class="def-var-arguments">file</var><a class="copiable-link" href='#index-_002epsbb'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-psbb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bllx_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nllx</code></strong><a class="copiable-link" href='#index-_005cn_005bllx_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-llx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005blly_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nlly</code></strong><a class="copiable-link" href='#index-_005cn_005blly_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lly"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005burx_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nurx</code></strong><a class="copiable-link" href='#index-_005cn_005burx_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-urx"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bury_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nury</code></strong><a class="copiable-link" href='#index-_005cn_005bury_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ury"></a>
+<a class="index-entry-id" id="index-PostScript_002c-bounding-box"></a>
+<a class="index-entry-id" id="index-bounding-box"></a>
+<p>Retrieve the bounding box of the PostScript image found in <var class="var">file</var>,
+which must conform to Adobe&rsquo;s <em class="dfn">Document Structuring Conventions</em>
+(DSC), locate a <code class="code">%%BoundingBox</code> comment, and store the (upper-,
+lower-, <span class="w-nolinebreak-text">-left</span>, <span class="w-nolinebreak-text">-right</span>) values into the registers <code class="code">llx</code>,
+<code class="code">lly</code>, <code class="code">urx</code>, and <code class="code">ury</code>.  If an error occurs (for
+example, if no <code class="code">%%BoundingBox</code> comment is present), the formatter
+sets these registers to&nbsp;0.
+</p>
+<p>The search path for <var class="var">file</var> can be controlled with the <samp class="option">-I</samp>
+command-line option.
+</p></dd></dl>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>, Previous: <a href="Postprocessor-Access.html">Postprocessor Access</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Missing-Unix-Version-7-ms-Macros.html Added

@@ -0,0 +1,78 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Missing Unix Version 7 ms Macros (The GNU Troff Manual)</title>
+
+<meta name="description" content="Missing Unix Version 7 ms Macros (The GNU Troff Manual)">
+<meta name="keywords" content="Missing Unix Version 7 ms Macros (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Differences-from-AT_0026T-ms.html" rel="up" title="Differences from AT&amp;T ms">
+<link href="Differences-from-AT_0026T-ms.html" rel="prev" title="Differences from AT&amp;T ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Missing-Unix-Version-7-ms-Macros">
+<div class="nav-panel">
+<p>
+Previous: <a href="Differences-from-AT_0026T-ms.html" accesskey="p" rel="prev">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Up: <a href="Differences-from-AT_0026T-ms.html" accesskey="u" rel="up">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Unix-Version-7-ms-macros-not-implemented-by-groff-ms">4.6.7.1 Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></h4>
+
+<p>Several macros described in the Unix Version&nbsp;7 <samp class="file">ms</samp>
+documentation are unimplemented by <code class="code">groff</code> <samp class="file">ms</samp> because they
+are specific to the requirements of documents produced internally by
+Bell Laboratories, some of which also require a glyph for the Bell
+System logo that <code class="code">groff</code> does not support.  These macros
+implemented several document type formats
+(<code class="code">EG</code>, <code class="code">IM</code>, <code class="code">MF</code>, <code class="code">MR</code>, <code class="code">TM</code>, <code class="code">TR</code>), were meaningful only in conjunction with the use of certain document
+types
+(<code class="code">AT</code>, <code class="code">CS</code>, <code class="code">CT</code>, <code class="code">OK</code>, <code class="code">SG</code>), stored the postal addresses of Bell Labs sites
+(<code class="code">HO</code>, <code class="code">IH</code>, <code class="code">MH</code>, <code class="code">PY</code>, <code class="code">WH</code>), or lacked a stable definition over time
+(<code class="code">UX</code>). To compatibly render historical <samp class="file">ms</samp> documents using these macros,
+we advise your documents to invoke the <code class="code">rm</code> request to remove any
+such macros it uses and then define replacements with an authentically
+typeset original at hand.<a class="footnote" id="DOCF17" href="groff.html_fot.html#FOOT17"><sup>17</sup></a>  For
+informal purposes, a simple definition of <code class="code">UX</code> should maintain the
+readability of the document&rsquo;s substance.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.rm UX
+.ds UX Unix\&quot;
+</pre></div>
+</td></tr></table>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Motion-Quanta.html Added

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Motion Quanta (The GNU Troff Manual)</title>
+
+<meta name="description" content="Motion Quanta (The GNU Troff Manual)">
+<meta name="keywords" content="Motion Quanta (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Measurements.html" rel="up" title="Measurements">
+<link href="Default-Units.html" rel="next" title="Default Units">
+<link href="Measurements.html" rel="prev" title="Measurements">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Motion-Quanta">
+<div class="nav-panel">
+<p>
+Next: <a href="Default-Units.html" accesskey="n" rel="next">Default Units</a>, Previous: <a href="Measurements.html" accesskey="p" rel="prev">Measurements</a>, Up: <a href="Measurements.html" accesskey="u" rel="up">Measurements</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Motion-Quanta-1">5.3.1 Motion Quanta</h4>
+<a class="index-entry-id" id="index-motion-quanta"></a>
+<a class="index-entry-id" id="index-quanta_002c-motion"></a>
+
+<p>An output device&rsquo;s basic unit <code class="code">u</code> is not necessarily its smallest
+addressable length; <code class="code">u</code> can be smaller to avoid problems with
+integer roundoff.  The minimum distances that a device can work with in
+the horizontal and vertical directions are termed its <em class="dfn">motion
+quanta</em>.  Measurements are rounded to applicable motion quanta.
+Half-quantum fractions round toward zero.
+</p>
+<a class="index-entry-id" id="index-horizontal-motion-quantum-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-motion-quantum_002c-horizontal_002c-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-horizontal-resolution-register-_0028_002eH_0029"></a>
+<a class="index-entry-id" id="index-resolution_002c-horizontal_002c-register-_0028_002eH_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eH_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.H</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eH"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002eV_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.V</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eV_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eV"></a>
+<p>These read-only registers interpolate the horizontal and vertical motion
+quanta, respectively, of the output device in basic units.
+</p></dd></dl>
+
+<p>For example, we might draw short baseline rules on a terminal device as
+follows.  See <a class="xref" href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tm \n.H
+    error&rarr; 24
+.nf
+\l'36u' 36u
+\l'37u' 37u
+    &rArr; _ 36u
+    &rArr; __ 37u
+</pre></div></div>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Numeric-Expressions.html Added

@@ -0,0 +1,395 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Numeric Expressions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Numeric Expressions (The GNU Troff Manual)">
+<meta name="keywords" content="Numeric Expressions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Identifiers.html" rel="next" title="Identifiers">
+<link href="Measurements.html" rel="prev" title="Measurements">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Numeric-Expressions">
+<div class="nav-panel">
+<p>
+Next: <a href="Identifiers.html" accesskey="n" rel="next">Identifiers</a>, Previous: <a href="Measurements.html" accesskey="p" rel="prev">Measurements</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Numeric-Expressions-1">5.4 Numeric Expressions</h3>
+<a class="index-entry-id" id="index-numeric-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-numeric"></a>
+
+<p>A <em class="dfn">numeric expression</em> evaluates to an integer: it can be as
+simple as a literal &lsquo;<samp class="samp">0</samp>&rsquo; or it can be a complex sequence of register
+and string interpolations interleaved with measurements and operators.
+</p>
+<p>GNU <code class="code">troff</code> provides a set of mathematical and logical operators
+familiar to programmers&mdash;as well as some unusual ones&mdash;but supports
+only integer arithmetic.<a class="footnote" id="DOCF35" href="groff.html_fot.html#FOOT35"><sup>35</sup></a>  The internal data type
+used for computing results is usually a 32-bit signed integer, which
+suffices to represent magnitudes within a range of ±2
+billion.<a class="footnote" id="DOCF36" href="groff.html_fot.html#FOOT36"><sup>36</sup></a>
+</p>
+<a class="index-entry-id" id="index-arithmetic-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-arithmetic"></a>
+<a class="index-entry-id" id="index-truncating-division"></a>
+<a class="index-entry-id" id="index-addition"></a>
+<a class="index-entry-id" id="index-subtraction"></a>
+<a class="index-entry-id" id="index-multiplication"></a>
+<a class="index-entry-id" id="index-division_002c-truncating"></a>
+<a class="index-entry-id" id="index-modulus"></a>
+<a class="index-entry-id" id="index-_002b"></a>
+<a class="index-entry-id" id="index-_002d"></a>
+<a class="index-entry-id" id="index-_002a"></a>
+<a class="index-entry-id" id="index-_002f"></a>
+<a class="index-entry-id" id="index-_0025"></a>
+<p>Arithmetic infix operators perform a function on the numeric expressions
+to their left and right; they are <code class="code">+</code> (addition), <code class="code">-</code>
+(subtraction), <code class="code">*</code> (multiplication), <code class="code">/</code> (truncating
+division), and <code class="code">%</code> (modulus).  <em class="dfn">Truncating division</em> rounds to
+the integer nearer to zero, no matter how large the fractional portion.
+Overflow and division (or modulus) by zero are errors and abort
+evaluation of a numeric expression.
+<a class="index-entry-id" id="index-unary-arithmetic-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-unary-arithmetic"></a>
+<a class="index-entry-id" id="index-negation"></a>
+<a class="index-entry-id" id="index-assertion-_0028arithmetic-operator_0029"></a>
+<a class="index-entry-id" id="index-_002d-1"></a>
+<a class="index-entry-id" id="index-_002b-1"></a>
+<a class="index-entry-id" id="index-if-request_002c-and-the-_0021-operator"></a>
+<a class="index-entry-id" id="index-while-request_002c-and-the-_0021-operator"></a>
+</p>
+<p>Arithmetic unary operators operate on the numeric expression to their
+right; they are <code class="code">-</code> (negation) and <code class="code">+</code> (assertion&mdash;for
+completeness; it does nothing).  The unary minus must often be used
+with parentheses to avoid confusion with the decrementation operator,
+discussed below.
+</p>
+<p>Observe the rounding behavior and effect of negative operands on the
+modulus and truncating division operators.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr T 199/100
+.nr U 5/2
+.nr V (-5)/2
+.nr W 5/-2
+.nr X 5%2
+.nr Y (-5)%2
+.nr Z 5%-2
+T=\nT U=\nU V=\nV W=\nW X=\nX Y=\nY Z=\nZ
+    &rArr; T=1 U=2 V=-2 W=-2 X=1 Y=-1 Z=1
+</pre></div></div>
+
+<p>The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.  Division and modulus operators satisfy the following
+property: given a dividend&nbsp;<var class="var">a</var> and a divisor&nbsp;<var class="var">b</var>, a
+quotient&nbsp;<var class="var">q</var> formed by &lsquo;<samp class="samp">(a / b)</samp>&rsquo; and a
+remainder&nbsp;<var class="var">r</var> by &lsquo;<samp class="samp">(a % b)</samp>&rsquo;, then <em class="math">qb + r = a</em>.
+</p>
+<a class="index-entry-id" id="index-scaling-operator"></a>
+<a class="index-entry-id" id="index-operator_002c-scaling"></a>
+<a class="index-entry-id" id="index-_003b"></a>
+<p>GNU <code class="code">troff</code>&rsquo;s scaling operator, used with parentheses as
+<code class="code">(<var class="var">c</var>;<var class="var">e</var>)</code>, evaluates a numeric expression&nbsp;<var class="var">e</var>
+using&nbsp;<var class="var">c</var> as the default scaling unit.  If <var class="var">c</var> is omitted,
+scaling units are ignored in the evaluation of&nbsp;<var class="var">e</var>.  This
+operator can save typing by avoiding the attachment of scaling units to
+every operand out of caution.  Your macros can select a sensible default
+unit in case the user neglects to supply one.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Indent by amount given in first argument; assume ens.
+.de Indent
+.  in (n;\\$1)
+..
+</pre></div></div>
+
+<p>Without the scaling operator, the foregoing macro would, if called with
+a unitless argument, cause indentation by the <code class="code">in</code> request&rsquo;s
+default scaling unit (ems).  The result would be twice as much
+indentation as expected.
+</p>
+<a class="index-entry-id" id="index-extremum-operators-_0028_003e_003f_002c-_003c_003f_0029"></a>
+<a class="index-entry-id" id="index-operators_002c-extremum-_0028_003e_003f_002c-_003c_003f_0029"></a>
+<a class="index-entry-id" id="index-maximum-operator"></a>
+<a class="index-entry-id" id="index-minimum-operator"></a>
+<a class="index-entry-id" id="index-_003e_003f"></a>
+<a class="index-entry-id" id="index-_003c_003f"></a>
+<p>GNU <code class="code">troff</code> also provides a pair of operators to compute the
+extrema of two operands: <code class="code">&gt;?</code> (maximum) and <code class="code">&lt;?</code> (minimum).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr slots 5
+.nr candidates 3
+.nr salaries (\nslots &lt;? \ncandidates)
+Looks like we'll end up paying \nsalaries salaries.
+    &rArr; Looks like we'll end up paying 3 salaries.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-comparison-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-comparison"></a>
+<a class="index-entry-id" id="index-greater-than-_0028or-equal-to_0029-operator"></a>
+<a class="index-entry-id" id="index-less-than-_0028or-equal-to_0029-operator"></a>
+<a class="index-entry-id" id="index-equality-operator"></a>
+<a class="index-entry-id" id="index-_003c"></a>
+<a class="index-entry-id" id="index-_003e"></a>
+<a class="index-entry-id" id="index-_003e_003d"></a>
+<a class="index-entry-id" id="index-_003c_003d"></a>
+<a class="index-entry-id" id="index-_003d"></a>
+<a class="index-entry-id" id="index-_003d_003d"></a>
+<p>Comparison operators comprise <code class="code">&lt;</code> (less than), <code class="code">&gt;</code> (greater
+than), <code class="code">&lt;=</code> (less than or equal), <code class="code">&gt;=</code> (greater than or
+equal), and <code class="code">=</code> (equal).  <code class="code">==</code> is a synonym for <code class="code">=</code>.
+When evaluated, a comparison is replaced with &lsquo;<samp class="samp">0</samp>&rsquo; if it is false
+and &lsquo;<samp class="samp">1</samp>&rsquo; if true.  In the <code class="code">roff</code> language, positive values are
+true, others false.
+</p>
+<a class="index-entry-id" id="index-logical-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-logical"></a>
+<a class="index-entry-id" id="index-logical-_0060_0060and_0027_0027-operator"></a>
+<a class="index-entry-id" id="index-logical-conjunction-operator"></a>
+<a class="index-entry-id" id="index-logical-_0060_0060or_0027_0027-operator"></a>
+<a class="index-entry-id" id="index-logical-disjunction-operator"></a>
+<a class="index-entry-id" id="index-_0026"></a>
+<a class="index-entry-id" id="index-_003a"></a>
+<p>We can operate on truth values with the logical operators <code class="code">&amp;</code>
+(logical conjunction or &ldquo;and&rdquo;) and <code class="code">:</code> (logical disjunction or
+&ldquo;or&rdquo;).  They evaluate as comparison operators do.
+</p>
+<a class="index-entry-id" id="index-_0021"></a>
+<a class="index-entry-id" id="index-complementation_002c-logical"></a>
+<a class="index-entry-id" id="index-logical-complementation-operator"></a>
+<a class="index-entry-id" id="index-logical-not_002c-limitation-in-expression"></a>
+<a class="index-entry-id" id="index-expression_002c-limitation-of-logical-not-in"></a>
+<p>A logical complementation (&ldquo;not&rdquo;) operator, <code class="code">!</code>, works only
+within <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> requests.
+Furthermore, <code class="code">!</code> is recognized only at the beginning of a numeric
+expression not contained by another numeric expression.  In other words,
+it must be the &ldquo;outermost&rdquo; operator.  Including it elsewhere in the
+expression produces a warning in the &lsquo;<samp class="samp">number</samp>&rsquo; category
+(see <a class="pxref" href="Warnings.html">Warnings</a>), and its expression evaluates false.  This
+unfortunate limitation maintains compatibility with <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>.  Test a numeric expression for falsity by
+comparing it to a false value.<a class="footnote" id="DOCF37" href="groff.html_fot.html#FOOT37"><sup>37</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr X 1
+.nr Y 0
+.\&quot; This does not work as expected.
+.if (\nX)&amp;(!\nY) .nop A: X is true, Y is false
+.
+.\&quot; Use this construct instead.
+.if (\nX)&amp;(\nY&lt;=0) .nop B: X is true, Y is false
+    error&rarr; warning: expected numeric expression, got '!'
+    &rArr; B: X is true, Y is false
+</pre></div></div>
+
+<a class="index-entry-id" id="index-parentheses"></a>
+<a class="index-entry-id" id="index-order-of-evaluation-in-expressions"></a>
+<a class="index-entry-id" id="index-expression_002c-order-of-evaluation"></a>
+<a class="index-entry-id" id="index-_0028"></a>
+<a class="index-entry-id" id="index-_0029"></a>
+<p>The <code class="code">roff</code> language has no operator precedence: expressions are
+evaluated strictly from left to right, in contrast to schoolhouse
+arithmetic.  Use parentheses <code class="code">(</code> <code class="code">)</code> to impose a desired
+precedence upon subexpressions.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr X 3+5*4
+.nr Y (3+5)*4
+.nr Z 3+(5*4)
+X=\nX Y=\nY Z=\nZ
+    &rArr; X=32 Y=32 Z=23
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_002b_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-_002d_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-motion-operators"></a>
+<a class="index-entry-id" id="index-operators_002c-motion"></a>
+<a class="index-entry-id" id="index-_002b-_0028unary_0029"></a>
+<a class="index-entry-id" id="index-_002d-_0028unary_0029"></a>
+<p>For many requests and escape sequences that cause motion on the page,
+the unary operators <code class="code">+</code> and <code class="code">-</code> work differently when leading
+a numeric expression.  They then indicate a motion relative to the
+drawing position: positive is down in vertical contexts, right in
+horizontal ones.
+</p>
+<a class="index-entry-id" id="index-bp-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-in-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ll-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-lt-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-nm-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-nr-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pl-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pn-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-po-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ps-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-pvs-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-rt-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-ti-request_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cH_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cR_002c-using-_002b-and-_002d-with"></a>
+<a class="index-entry-id" id="index-_005cs_002c-using-_002b-and-_002d-with"></a>
+<p><code class="code">+</code> and <code class="code">-</code> are also treated differently by the following
+requests and escape sequences: <code class="code">bp</code>, <code class="code">in</code>, <code class="code">ll</code>,
+<code class="code">lt</code>, <code class="code">nm</code>, <code class="code">nr</code>, <code class="code">pl</code>, <code class="code">pn</code>, <code class="code">po</code>,
+<code class="code">ps</code>, <code class="code">pvs</code>, <code class="code">rt</code>, <code class="code">ti</code>, <code class="code">\H</code>, <code class="code">\R</code>, and
+<code class="code">\s</code>.  Here, leading plus and minus signs serve as incrementation
+and decrementation operators, respectively.  To negate an expression,
+subtract it from zero or include the unary minus in parentheses with its
+argument.  See <a class="xref" href="Setting-Registers.html">Setting Registers</a>, for examples.
+</p>
+<a class="index-entry-id" id="index-_007c"></a>
+<a class="index-entry-id" id="index-_007c_002c-and-page-motion"></a>
+<a class="index-entry-id" id="index-absolute-_0028sic_0029-position-operator-_0028_007c_0029"></a>
+<a class="index-entry-id" id="index-position_002c-absolute-_0028sic_0029-operator-_0028_007c_0029"></a>
+<a class="index-entry-id" id="index-boundary_002drelative-motion-operator-_0028_007c_0029"></a>
+<p>A leading <code class="code">|</code> operator indicates a motion relative not to the
+drawing position but to a boundary.  For horizontal motions, the
+measurement specifies a distance relative to a drawing position
+corresponding to the beginning of the <em class="emph">input</em> line.  By default,
+tab stops reckon movements in this way.  Most escape sequences do not;
+<code class="code">|</code> tells them to do so.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Mind the \h'1.2i'gap.
+.br
+Mind the \h'|1.2i'gap.
+.br
+Mind the
+\h'|1.2i'gap.
+    &rArr; Mind the             gap.
+    &rArr; Mind the    gap.
+    &rArr; Mind the             gap.
+</pre></div></div>
+
+<p>One use of this feature is to define macros whose scope is limited to
+the output they format.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; underline word $1 with trailing punctuation $2
+.de Underline
+.  nop \\$1\l'|0\ul'\\$2
+..
+Typographical emphasis is best used
+.Underline sparingly .
+</pre></div></div>
+
+<p>In the above example, &lsquo;<samp class="samp">|0</samp>&rsquo; specifies a negative motion from the
+current position (at the end of the argument just emitted, <code class="code">\$1</code>)
+to the beginning of the input line.  Thus, the <code class="code">\l</code> escape sequence
+in this case draws a line from right to left.  A macro call occurs at
+the beginning of an input line;<a class="footnote" id="DOCF38" href="groff.html_fot.html#FOOT38"><sup>38</sup></a> if the <code class="code">|</code>
+operator were omitted, then the underline would be drawn at zero
+distance from the current position, producing device-dependent, and
+likely undesirable, results.  On the &lsquo;<samp class="samp">ps</samp>&rsquo; output device, it
+underlines the period.
+</p>
+<p>For vertical motions, the <code class="code">|</code> operator specifies a distance from
+the first text baseline on the page or in the current
+diversion,<a class="footnote" id="DOCF39" href="groff.html_fot.html#FOOT39"><sup>39</sup></a>  using the current vertical
+spacing.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">A
+.br
+B \Z'C'\v'|0'D
+    &rArr; A D
+    &rArr; B C
+</pre></div></div>
+
+<p>In the foregoing example, we&rsquo;ve used the <code class="code">\Z</code> escape sequence
+(see <a class="pxref" href="Page-Motions.html">Page Motions</a>) to restore the drawing position after formatting
+&lsquo;<samp class="samp">C</samp>&rsquo;, then moved vertically to the first text baseline on the page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cB_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\B<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cB_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cB"></a>
+<a class="index-entry-id" id="index-numeric-expression_002c-valid"></a>
+<a class="index-entry-id" id="index-valid-numeric-expression"></a>
+<p>Interpolate&nbsp;1 if <var class="var">anything</var> is a valid numeric expression,
+and&nbsp;0 otherwise.  The delimiter need not be a neutral apostrophe;
+see <a class="ref" href="Delimiters.html">Delimiters</a>.
+</p></dd></dl>
+
+<p>You might use <code class="code">\B</code> along with the <code class="code">if</code> request to filter out
+invalid macro or string arguments.  See <a class="xref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Indent by amount given in first argument; assume ens.
+.de Indent
+.  if \B'\\$1' .in (n;\\$1)
+..
+</pre></div></div>
+
+<p>A register interpolated as an operand in a numeric expression must have
+an Arabic format; luckily, this is the default.  See <a class="xref" href="Assigning-Register-Formats.html">Assigning Register Formats</a>.
+</p>
+<a class="index-entry-id" id="index-space-characters_002c-in-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-and-space-characters"></a>
+<p>Because spaces separate arguments to requests, spaces are not allowed in
+numeric expressions unless the (sub)expression containing them is
+surrounded by parentheses.  See <a class="xref" href="Invoking-Requests.html">Invoking Requests</a>, and
+<a class="ref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nf
+.nr a 1+2 + 2+1
+\na
+    error&rarr; expected numeric expression, got a space
+    &rArr; 3
+.nr a 1+(2 + 2)+1
+\na
+    &rArr; 6
+</pre></div></div>
+
+<p>The <code class="code">nr</code> request (see <a class="pxref" href="Setting-Registers.html">Setting Registers</a>) expects its second and
+optional third arguments to be numeric expressions; a bare <code class="code">+</code> does
+not qualify, so our first attempt got a warning.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Identifiers.html">Identifiers</a>, Previous: <a href="Measurements.html">Measurements</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Obsolete-Command.html Added

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Obsolete Command (The GNU Troff Manual)</title>
+
+<meta name="description" content="Obsolete Command (The GNU Troff Manual)">
+<meta name="keywords" content="Obsolete Command (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Command-Reference.html" rel="up" title="Command Reference">
+<link href="Device-Control-Commands.html" rel="prev" title="Device Control Commands">
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Obsolete-Command">
+<div class="nav-panel">
+<p>
+Previous: <a href="Device-Control-Commands.html" accesskey="p" rel="prev">Device Control Commands</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Obsolete-Command-1">6.1.2.5 Obsolete Command</h4>
+<p>In <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output, the writing of a single glyph is
+mostly done by a very strange command that combines a horizontal move
+and a single character giving the glyph name.  It doesn&rsquo;t have a command
+code, but is represented by a 3-character argument consisting of exactly
+2&nbsp;digits and a character.
+</p>
+<dl class="table">
+<dt><var class="var">dd</var><var class="var">g</var></dt>
+<dd><p>Move right <var class="var">dd</var> (exactly two decimal digits) basic units &lsquo;<samp class="samp">u</samp>&rsquo;,
+then print glyph&nbsp;<var class="var">g</var> (represented as a single character).
+</p>
+<p>In GNU <code class="code">troff</code>, arbitrary syntactical space around and within this
+command is allowed.  Only when a preceding command on the same line ends
+with an argument of variable length is a separating space obligatory.
+In <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, large clusters of these and other
+commands are used, mostly without spaces; this made such output almost
+unreadable.
+</p></dd>
+</dl>
+
+<p>For modern high-resolution devices, this command does not make sense
+because the width of the glyphs can become much larger than two decimal
+digits.  In <code class="code">gtroff</code>, this is only used for the devices <code class="code">X75</code>,
+<code class="code">X75-12</code>, <code class="code">X100</code>, and <code class="code">X100-12</code>.  For other devices, the
+commands &lsquo;<samp class="samp">t</samp>&rsquo; and &lsquo;<samp class="samp">u</samp>&rsquo; provide a better functionality.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Operator-Index.html Added

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Operator Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Operator Index (The GNU Troff Manual)">
+<meta name="keywords" content="Operator Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Register-Index.html" rel="next" title="Register Index">
+<link href="Escape-Sequence-Index.html" rel="prev" title="Escape Sequence Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Operator-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Register-Index.html" accesskey="n" rel="next">Register Index</a>, Previous: <a href="Escape-Sequence-Index.html" accesskey="p" rel="prev">Escape Sequence Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Operator-Index-1">Appendix D Operator Index</h2>
+
+<div class="printindex op-printindex">
+<table class="op-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Operator-Index_op_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-4"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-5"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-6"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-7"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-8"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-9"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-11"><b>;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-12"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-13"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-14"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-15"><b>|</b></a>
+</td></tr></table>
+<table class="op-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-1">!</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_0021"><code>!</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_0025"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-3">&amp;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_0026"><code>&amp;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-4">(</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_0028"><code>(</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-5">)</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_0029"><code>)</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-6">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002a"><code>*</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-7">+</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002b"><code>+</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002b-1"><code>+</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002b-_0028unary_0029"><code>+ <span class="r">(unary)</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-8">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002d"><code>-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002d-1"><code>-</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002d-_0028unary_0029"><code>- <span class="r">(unary)</span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-9">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_002f"><code>/</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-10">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003a"><code>:</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-11">;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003b"><code>;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-12">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003c"><code>&lt;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003c_003d"><code>&lt;=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003c_003f"><code>&lt;?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-13">=</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003d"><code>=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003d_003d"><code>==</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-14">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003e"><code>&gt;</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003e_003d"><code>&gt;=</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_003e_003f"><code>&gt;?</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Operator-Index_op_symbol-15">|</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Numeric-Expressions.html#index-_007c"><code>|</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Numeric-Expressions.html">Numeric Expressions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="op-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Operator-Index_op_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-3"><b>&amp;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-4"><b>(</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-5"><b>)</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-6"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-7"><b>+</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-8"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-9"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-11"><b>;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-12"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-13"><b>=</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-14"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Operator-Index_op_symbol-15"><b>|</b></a>
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Register-Index.html">Register Index</a>, Previous: <a href="Escape-Sequence-Index.html">Escape Sequence Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Operators-in-Conditionals.html Added

@@ -0,0 +1,222 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Operators in Conditionals (The GNU Troff Manual)</title>
+
+<meta name="description" content="Operators in Conditionals (The GNU Troff Manual)">
+<meta name="keywords" content="Operators in Conditionals (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Conditionals-and-Loops.html" rel="up" title="Conditionals and Loops">
+<link href="if_002dthen.html" rel="next" title="if-then">
+<link href="Conditionals-and-Loops.html" rel="prev" title="Conditionals and Loops">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Operators-in-Conditionals">
+<div class="nav-panel">
+<p>
+Next: <a href="if_002dthen.html" accesskey="n" rel="next">if-then</a>, Previous: <a href="Conditionals-and-Loops.html" accesskey="p" rel="prev">Conditionals and Loops</a>, Up: <a href="Conditionals-and-Loops.html" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Operators-in-Conditionals-1">5.23.1 Operators in Conditionals</h4>
+
+<a class="index-entry-id" id="index-if-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-ie-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-while-request_002c-operators-to-use-with"></a>
+<a class="index-entry-id" id="index-conditional-expressions"></a>
+<a class="index-entry-id" id="index-expressions_002c-conditional"></a>
+<p>In <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> requests, in addition to the
+numeric expressions described in <a class="ref" href="Numeric-Expressions.html">Numeric Expressions</a>, several
+Boolean operators are available; the members of this expanded class are
+termed <em class="dfn">conditional expressions</em>.
+</p>
+<dl class="table">
+<dt><code class="code">c <var class="var">glyph</var></code></dt>
+<dd><p>True if <var class="var">glyph</var> is available, where <var class="var">glyph</var> is an ordinary
+character, a special character &lsquo;<samp class="samp">\(<var class="var">xx</var></samp>&rsquo; or &lsquo;<samp class="samp">\<var class="var">xxx</var></samp>&rsquo;,
+&lsquo;<samp class="samp">\N'<var class="var">xxx</var>'</samp>&rsquo;, or has been defined by any of the <code class="code">char</code>,
+<code class="code">fchar</code>, <code class="code">fschar</code>, or <code class="code">schar</code> requests.
+</p>
+</dd>
+<dt><code class="code">d <var class="var">name</var></code></dt>
+<dd><p>True if a string, macro, diversion, or request called <var class="var">name</var> exists.
+</p>
+</dd>
+<dt><code class="code">e</code></dt>
+<dd><p>True if the current page is even-numbered.
+</p>
+</dd>
+<dt><code class="code">F <var class="var">font</var></code></dt>
+<dd><p>True if <var class="var">font</var> exists.  <var class="var">font</var> is handled as if it were opened
+with the <code class="code">ft</code> request (that is, font translation and styles are
+applied), without actually mounting it.
+</p>
+</dd>
+<dt><code class="code">m <var class="var">color</var></code></dt>
+<dd><p>True if <var class="var">color</var> is defined.
+</p>
+</dd>
+<dt id='index-conditional-output-for-terminal-_0028TTY_0029'><span><code class="code">n</code><a class="copiable-link" href='#index-conditional-output-for-terminal-_0028TTY_0029'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TTY_002c-conditional-output-for"></a>
+<a class="index-entry-id" id="index-terminal_002c-conditional-output-for"></a>
+<p>True if the document is being processed in <code class="code">nroff</code> mode.
+See <a class="xref" href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>.
+</p>
+</dd>
+<dt><code class="code">o</code></dt>
+<dd><p>True if the current page is odd-numbered.
+</p>
+</dd>
+<dt><code class="code">r <var class="var">register</var></code></dt>
+<dd><p>True if <var class="var">register</var> exists.
+</p>
+</dd>
+<dt><code class="code">S <var class="var">style</var></code></dt>
+<dd><p>True if <var class="var">style</var> is available for the current font family.  Font
+translation is applied.
+</p>
+</dd>
+<dt><code class="code">t</code></dt>
+<dd><p>True if the document is being processed in <code class="code">troff</code> mode.
+See <a class="xref" href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a>.
+</p>
+<a class="index-entry-id" id="index-vtroff"></a>
+</dd>
+<dt><code class="code">v</code></dt>
+<dd><p>Always false.  This condition is recognized only for compatibility with
+certain other <code class="code">troff</code> implementations.<a class="footnote" id="DOCF88" href="groff.html_fot.html#FOOT88"><sup>88</sup></a>
+</p></dd>
+</dl>
+
+<p>If the first argument to an <code class="code">if</code>, <code class="code">ie</code>, or <code class="code">while</code>
+request begins with a non-alphanumeric character apart from <code class="code">!</code>
+(see below); it performs an <i class="slanted">output comparison test</i>.
+<a class="footnote" id="DOCF89" href="groff.html_fot.html#FOOT89"><sup>89</sup></a>
+</p>
+<a class="index-entry-id" id="index-output-comparison-operator"></a>
+<dl class="table">
+<dt><code class="code"><code class="code">'</code><var class="var">xxx</var><code class="code">'</code><var class="var">yyy</var><code class="code">'</code></code></dt>
+<dd><p>True if formatting the comparands <var class="var">xxx</var> and <var class="var">yyy</var> produces the
+same output commands.  The delimiter need not be a neutral apostrophe:
+the output comparison operator accepts the same delimiters as most
+escape sequences; see <a class="ref" href="Delimiters.html">Delimiters</a>.  This <em class="dfn">output comparison
+operator</em> formats <var class="var">xxx</var> and <var class="var">yyy</var> in separate environments;
+after the comparison, the resulting data are discarded.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ie &quot;|&quot;\fR|\fP&quot; true
+.el false
+    &rArr; true
+</pre></div></div>
+
+<p>The resulting glyph properties, including font family, style, size, and
+slant, must match, but not necessarily the requests and/or escape
+sequences used to obtain them.  In the previous example, &lsquo;<samp class="samp">|</samp>&rsquo; and
+&lsquo;<samp class="samp">\fR|\fP</samp>&rsquo; result in &lsquo;<samp class="samp">|</samp>&rsquo; glyphs in the same typefaces at the
+same positions, so the comparands are equal.  If &lsquo;<samp class="samp">.ft&nbsp;I</samp>&rsquo; had
+been added before the &lsquo;<samp class="samp">.ie</samp>&rsquo;, they would differ: the first &lsquo;<samp class="samp">|</samp>&rsquo;
+would produce an italic &lsquo;<samp class="samp">|</samp>&rsquo;, not a roman one.  Motions must match
+in orientation and magnitude to within the applicable horizontal and
+vertical motion quanta of the device, after rounding.  &lsquo;<samp class="samp">.if
+&quot;\u\d&quot;\v'0'&quot;</samp>&rsquo; is false even though both comparands result in zero net
+motion, because motions are not interpreted or optimized but sent as-is
+to the output.<a class="footnote" id="DOCF90" href="groff.html_fot.html#FOOT90"><sup>90</sup></a>  On the other hand, &lsquo;<samp class="samp">.if &quot;\d&quot;\v'0.5m'&quot;</samp>&rsquo; is true, because
+<code class="code">\d</code> is defined as a downward motion of one-half em.<a class="footnote" id="DOCF91" href="groff.html_fot.html#FOOT91"><sup>91</sup></a>
+</p>
+<a class="index-entry-id" id="index-string-comparison"></a>
+<a class="index-entry-id" id="index-comparison-of-strings"></a>
+<p>Surround the comparands with <code class="code">\?</code> to avoid formatting them; this
+causes them to be compared character by character, as with string
+comparisons in other programming languages.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ie &quot;\?|\?&quot;\?\fR|\fP\?&quot; true
+.el false
+    &rArr; false
+</pre></div></div>
+
+<a class="index-entry-id" id="index-_005c_003f_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005c_003f"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005c_003f"></a>
+<p>Since comparands protected with <code class="code">\?</code> are read in copy mode
+(see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>), they need not even be valid <code class="code">groff</code> syntax.
+The escape character is still lexically recognized, however, and
+consumes the next character.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds a \
+.ds b \
+.if '\?\*a\?'\?\*b\?' a and b equivalent
+.if '\?\\?'\?\\?' backslashes equivalent
+    &rArr; a and b equivalent
+</pre></div></div>
+</dd>
+</dl>
+
+<p>The above operators can&rsquo;t be combined with most others, but a leading
+&lsquo;<samp class="samp">!</samp>&rsquo;, not followed immediately by spaces or tabs, complements an
+expression.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 1
+.ie !r x register x is not defined
+.el      register x is defined
+    &rArr; register x is defined
+</pre></div></div>
+
+<p>Spaces and tabs are optional immediately after the &lsquo;<samp class="samp">c</samp>&rsquo;, &lsquo;<samp class="samp">d</samp>&rsquo;,
+&lsquo;<samp class="samp">F</samp>&rsquo;, &lsquo;<samp class="samp">m</samp>&rsquo;, &lsquo;<samp class="samp">r</samp>&rsquo;, and &lsquo;<samp class="samp">S</samp>&rsquo; operators, but right after
+&lsquo;<samp class="samp">!</samp>&rsquo;, they end the predicate and the conditional evaluates
+true.<a class="footnote" id="DOCF92" href="groff.html_fot.html#FOOT92"><sup>92</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr x 1
+.ie ! r x register x is not defined
+.el       register x is defined
+    &rArr; r x register x is not defined
+</pre></div></div>
+
+<p>The unexpected &lsquo;<samp class="samp">r x</samp>&rsquo; in the output is a clue that our conditional
+was not interpreted as we planned, but matters may not always be so
+obvious.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="if_002dthen.html">if-then</a>, Previous: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a>, Up: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Optional-man-extensions.html Added

@@ -0,0 +1,264 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Optional man extensions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Optional man extensions (The GNU Troff Manual)">
+<meta name="keywords" content="Optional man extensions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="man.html" rel="up" title="man">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Optional-man-extensions">
+<div class="nav-panel">
+<p>
+Up: <a href="man.html" accesskey="u" rel="up"><samp class="file">man</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Optional-man-extensions-1">4.1.1 Optional <samp class="file">man</samp> extensions</h4>
+
+<a class="index-entry-id" id="index-man_002elocal"></a>
+<p>Use the file <samp class="file">man.local</samp> for local extensions to the <code class="code">man</code>
+macros or for style changes.
+</p>
+<ul class="mini-toc">
+<li><a href="#Custom-headers-and-footers" accesskey="1">Custom headers and footers</a></li>
+<li><a href="#Ultrix_002dspecific-man-macros" accesskey="2">Ultrix-specific man macros</a></li>
+<li><a href="#Simple-example" accesskey="3">Simple example</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="Custom-headers-and-footers">
+<h4 class="unnumberedsubsubsec">Custom headers and footers</h4>
+<a class="index-entry-id" id="index-man-macros_002c-custom-headers-and-footers"></a>
+
+<p>In <code class="code">groff</code> versions 1.18.2 and later, you can specify custom
+headers and footers by redefining the following macros in
+<samp class="file">man.local</samp>.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PT</code></strong><a class="copiable-link" href='#index-_002ePT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PT-_005bman_005d"></a>
+<p>Control the content of the headers.  Normally, the header prints the
+command name and section number on either side, and the optional fifth
+argument to <code class="code">TH</code> in the center.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BT</code></strong><a class="copiable-link" href='#index-_002eBT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BT-_005bman_005d"></a>
+<p>Control the content of the footers.  Normally, the footer prints the
+page number and the third and fourth arguments to <code class="code">TH</code>.
+</p>
+<p>Use the <code class="code">FT</code> register to specify the footer position.  The default
+is &minus;0.5<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Ultrix_002dspecific-man-macros">
+<h4 class="unnumberedsubsubsec">Ultrix-specific man macros</h4>
+<a class="index-entry-id" id="index-Ultrix_002dspecific-man-macros"></a>
+<a class="index-entry-id" id="index-man-macros_002c-Ultrix_002dspecific"></a>
+
+<a class="index-entry-id" id="index-man_002eultrix"></a>
+<p>The <code class="code">groff</code> source distribution includes a file named
+<samp class="file">man.ultrix</samp>, containing macros compatible with the Ultrix variant
+of <code class="code">man</code>.  Copy this file into <samp class="file">man.local</samp> (or use the
+<code class="code">mso</code> request to load it) to enable the following macros.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">key</i></span></var><a class="copiable-link" href='#index-_002eCT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CT-_005bman_005d"></a>
+<p>Print &lsquo;<samp class="samp">&lt;CTRL/<var class="var">key</var>&gt;</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCW"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CW</code></strong><a class="copiable-link" href='#index-_002eCW'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CW-_005bman_005d"></a>
+<p>Print subsequent text using a &ldquo;constant-width&rdquo; (monospaced) typeface
+(Courier roman).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDs"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.Ds</code></strong><a class="copiable-link" href='#index-_002eDs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Ds-_005bman_005d"></a>
+<p>Begin a non-filled display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDe"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.De</code></strong><a class="copiable-link" href='#index-_002eDe'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-De-_005bman_005d"></a>
+<p>End a non-filled display started with <code class="code">Ds</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EX</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eEX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EX-_005bman_005d"></a>
+<p>Begin a non-filled display using a monospaced typeface (Courier roman).
+Use the optional <var class="var">indent</var> argument to indent the display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EE</code></strong><a class="copiable-link" href='#index-_002eEE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EE-_005bman_005d"></a>
+<p>End a non-filled display started with <code class="code">EX</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eG"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.G</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eG'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-G-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica.  If no text is present on the line where
+the macro is called, then the text of the next line appears in
+Helvetica.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eGL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.GL</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eGL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GL-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica oblique.  If no text is present on the line
+where the macro is called, then the text of the next line appears in
+Helvetica Oblique.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eHB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.HB</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eHB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HB-_005bman_005d"></a>
+<p>Set <var class="var">text</var> in Helvetica bold.  If no text is present on the line
+where the macro is called, then all text up to the next <code class="code">HB</code>
+appears in Helvetica bold.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TB</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eTB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TB-_005bman_005d"></a>
+<p>Identical to <code class="code">HB</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eMS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.MS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">title</i></span> <span class="r"><i class="slanted">sect</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002eMS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MS-_005bman_005d"></a>
+<p>Set a man page reference in Ultrix format.  The <var class="var">title</var> is in
+Courier instead of italic.  Optional punctuation follows the section
+number without an intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NT</code></strong> <var class="def-var-arguments"><code class="code">C</code> <span class="r"><i class="slanted">title</i></span></var><a class="copiable-link" href='#index-_002eNT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NT-_005bman_005d"></a>
+<p>Begin a note.  Print the optional <span class="r"><i class="slanted">title</i></span>, or the word &ldquo;Note&rdquo;,
+centered on the page.  Text following the macro makes up the body of the
+note, and is indented on both sides.  If the first argument is <code class="code">C</code>,
+the body of the note is printed centered (the second argument replaces
+the word &ldquo;Note&rdquo; if specified).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NE</code></strong><a class="copiable-link" href='#index-_002eNE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NE-_005bman_005d"></a>
+<p>End a note begun with <code class="code">NT</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PN</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">path</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002ePN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PN-_005bman_005d"></a>
+<p>Set the path name in a monospaced typeface (Courier roman), followed by
+optional punctuation.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePn"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.Pn</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">punct</i></span> <span class="r"><i class="slanted">path</i></span> <span class="r"><i class="slanted">punct</i></span></var><a class="copiable-link" href='#index-_002ePn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Pn-_005bman_005d"></a>
+<p>If called with two arguments, identical to <code class="code">PN</code>.  If called with
+three arguments, set the second argument in a monospaced typeface
+(Courier roman), bracketed by the first and third arguments in the
+current font.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eR"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.R</code></strong><a class="copiable-link" href='#index-_002eR'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-R-_005bman_005d"></a>
+<p>Switch to roman font and turn off any underlining in effect.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RN</code></strong><a class="copiable-link" href='#index-_002eRN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RN-_005bman_005d"></a>
+<p>Print the string &lsquo;<samp class="samp">&lt;RETURN&gt;</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eVS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.VS</code></strong> <var class="def-var-arguments"><code class="code">4</code></var><a class="copiable-link" href='#index-_002eVS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VS-_005bman_005d"></a>
+<p>Start printing a change bar in the margin if the number&nbsp;<code class="code">4</code> is
+specified.  Otherwise, this macro does nothing.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eVE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.VE</code></strong><a class="copiable-link" href='#index-_002eVE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VE-_005bman_005d"></a>
+<p>End printing the change bar begun by <code class="code">VS</code>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Simple-example">
+<h4 class="unnumberedsubsubsec">Simple example</h4>
+
+<p>The following example <samp class="file">man.local</samp> file alters the <code class="code">SH</code> macro
+to add some extra vertical space before printing the heading.  Headings
+are printed in Helvetica bold.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; Make the heading fonts Helvetica
+.ds HF HB
+.
+.\&quot; Put more space in front of headings.
+.rn SH SH-orig
+.de SH
+.  if t .sp (u;\\nPD*2)
+.  SH-orig \\$*
+..
+</pre></div></div>
+
+
+
+</div>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Up: <a href="man.html"><samp class="file">man</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Other-Differences.html Added

@@ -0,0 +1,248 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Other Differences (The GNU Troff Manual)</title>
+
+<meta name="description" content="Other Differences (The GNU Troff Manual)">
+<meta name="keywords" content="Other Differences (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Implementation-Differences.html" rel="up" title="Implementation Differences">
+<link href="Compatibility-Mode.html" rel="prev" title="Compatibility Mode">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Other-Differences">
+<div class="nav-panel">
+<p>
+Previous: <a href="Compatibility-Mode.html" accesskey="p" rel="prev">Compatibility Mode</a>, Up: <a href="Implementation-Differences.html" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Other-Differences-1">5.38.3 Other Differences</h4>
+
+<p><code class="code">groff</code> request names unrecognized by other <code class="code">troff</code>
+implementations will likely be ignored by them; escape sequences that
+are <code class="code">groff</code> extensions are liable to be interpreted as if the
+escape character were not present.
+<a class="index-entry-id" id="index-_005c_007e_002c-incompatibilities-with-AT_0026T-troff"></a>
+For example, the adjustable, non-breaking escape sequence <code class="code">\~</code>
+is also supported by Heirloom Doctools <code class="code">troff</code> 050915 (September
+2005), <code class="code">mandoc</code> 1.9.5 (2009-09-21), <code class="code">neatroff</code> (commit
+1c6ab0f6e, 2016-09-13), and Plan&nbsp;9 from User Space <code class="code">troff</code>
+(commit 93f8143600, 2022-08-12), but not by Solaris or Documenter&rsquo;s
+Workbench <code class="code">troff</code>s.
+See <a class="xref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+<a class="index-entry-id" id="index-_005cA_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007c_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_005e_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007b_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_007d_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cSP_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0027_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0060_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_002d_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_005f_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005cc_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>GNU <code class="code">troff</code> does not allow the use of the escape sequences
+<code class="code">\|</code>, <code class="code">\^</code>, <code class="code">\&amp;</code>, <code class="code">\{</code>, <code class="code">\}</code>,
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\'</code>, <code class="code">\`</code>, <code class="code">\-</code>, <code class="code">\_</code>, <code class="code">\!</code>,
+<code class="code">\%</code>, and <code class="code">\c</code> in identifiers; <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>
+does.  The <code class="code">\A</code> escape sequence (see <a class="pxref" href="Identifiers.html">Identifiers</a>) may be
+helpful in avoiding use of these escape sequences in names.
+</p>
+<a class="index-entry-id" id="index-adjustment-to-both-margins_002c-difference-from-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-rivers"></a>
+<p>When adjusting to both margins, <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> at first
+adjusts spaces starting from the right; GNU <code class="code">troff</code> begins from
+the left.  Both implementations adjust spaces from opposite ends on
+alternating output lines in this adjustment mode to prevent &ldquo;rivers&rdquo;
+in the text.
+</p>
+<a class="index-entry-id" id="index-hyphenation_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>GNU <code class="code">troff</code> does not always hyphenate words as <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> does.  The <abbr class="acronym">AT&amp;T</abbr> implementation uses a set of
+hard-coded rules specific to English, while GNU <code class="code">troff</code> uses
+language-specific hyphenation pattern files derived from TeX.
+Furthermore, in old versions of <code class="code">troff</code> there was a limited amount
+of space to store hyphenation exceptions (arguments to the <code class="code">hw</code>
+request); GNU <code class="code">troff</code> has no such restriction.
+</p>
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029_002c-in-other-implementations"></a>
+<p>GNU <code class="code">troff</code> predefines a string <code class="code">.T</code> containing the argument
+given to the <samp class="option">-T</samp> command-line option, namely the current output
+device (for example, &lsquo;<samp class="samp">pdf</samp>&rsquo; or &lsquo;<samp class="samp">utf8</samp>&rsquo;).  The existence of this
+string is a common feature of post-CSTR&nbsp;#54
+<code class="code">troff</code>s<a class="footnote" id="DOCF121" href="groff.html_fot.html#FOOT121"><sup>121</sup></a> but valid values are specific
+to each implementation.
+</p>
+<a class="index-entry-id" id="index-removal-of-read_002donly-registers_002c-incompatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-register_002c-read_002donly_002c-removal_002c-incompatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-read_002donly-register-removal_002c-incompatibility-with-AT_0026T-troff"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> ignored attempts to remove read-only
+registers; GNU <code class="code">troff</code> honors such requests.  See <a class="xref" href="Built_002din-Registers.html">Built-in Registers</a>.
+</p>
+<a class="index-entry-id" id="index-output-device-usage-register-_0028_002eT_0029_002c-incompatibility-with-AT_0026T-troff"></a>
+<p>The (read-only) register <code class="code">.T</code> interpolates&nbsp;1 if GNU
+<code class="code">troff</code> is called with the <samp class="option">-T</samp> command-line option, and
+0&nbsp;otherwise.  This behavior differs from AT&amp;T <code class="code">troff</code>, which
+interpolated&nbsp;1 only if <code class="code">nroff</code> was the formatter and was
+called with <samp class="option">-T</samp>.
+</p>
+<a class="index-entry-id" id="index-lf-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> and other implementations handle the
+<code class="code">lf</code> request differently.  For them, its <var class="var">line</var> argument
+changes the line number of the <em class="emph">current</em> line.
+</p>
+<a class="index-entry-id" id="index-environment-availability-and-naming_002c-incompatibilities-with"></a>
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> had only environments named &lsquo;<samp class="samp">0</samp>&rsquo;,
+&lsquo;<samp class="samp">1</samp>&rsquo;, and &lsquo;<samp class="samp">2</samp>&rsquo;.  In GNU <code class="code">troff</code>, any number of environments
+may exist, using any valid identifiers for their names
+(see <a class="pxref" href="Identifiers.html">Identifiers</a>.)
+</p>
+<a class="index-entry-id" id="index-fractional-point-sizes-1"></a>
+<a class="index-entry-id" id="index-fractional-type-sizes-1"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-fractional-1"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-fractional-1"></a>
+<a class="index-entry-id" id="index-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-ps-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Fractional type sizes cause one noteworthy incompatibility.  In
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> the <code class="code">ps</code> request ignores scaling units
+and thus &lsquo;<samp class="samp">.ps 10u</samp>&rsquo; sets the type size to 10&nbsp;points, whereas in
+GNU <code class="code">troff</code> it sets the type size to 10&nbsp;<em class="emph">scaled</em> points.
+See <a class="xref" href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a>.
+</p>
+<a class="index-entry-id" id="index-ab-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">ab</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> writes no message to the standard error stream if no
+arguments are given, and it exits with a failure status instead of a
+successful one.
+</p>
+<a class="index-entry-id" id="index-bp-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">bp</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> does not accept a scaling unit on the argument, a page
+number; the former (somewhat uselessly) does.
+</p>
+<a class="index-entry-id" id="index-pm-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>The <code class="code">pm</code> request differs from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>:
+GNU <code class="code">troff</code> reports the sizes of macros, strings, and diversions in
+bytes and ignores an argument to report only the sum of the sizes.
+</p>
+<a class="index-entry-id" id="index-ss-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>Unlike <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, GNU <code class="code">troff</code> does not ignore the
+<code class="code">ss</code> request if the output is a terminal device; instead, the
+values of minimal inter-word and additional inter-sentence space are
+each rounded down to the nearest multiple of&nbsp;12.
+</p>
+<a class="index-entry-id" id="index-bd-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-cs-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-tr-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-fp-request_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-input-characters-and-output-glyphs_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-output-glyphs_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-characters_002c-input_002c-and-output-glyphs_002c-compatibility-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-glyphs_002c-output_002c-and-input-characters_002c-compatibility-with-AT_0026T-troff"></a>
+<p>In GNU <code class="code">troff</code> there is a fundamental difference between
+(unformatted) characters and (formatted) glyphs.  Everything that
+affects how a glyph is output is stored with the glyph node; once a
+glyph node has been constructed, it is unaffected by any subsequent
+requests that are executed, including <code class="code">bd</code>, <code class="code">cs</code>, <code class="code">tkf</code>,
+<code class="code">tr</code>, or <code class="code">fp</code> requests.  Normally, glyphs are constructed from
+characters immediately before the glyph is added to an output line.
+Macros, diversions, and strings are all, in fact, the same type of
+object; they contain a sequence of intermixed character and glyph nodes.
+Special characters transform from one to the other: before being added
+to the output, they behave as characters; afterward, they are glyphs.  A
+glyph node does not behave like a character node when it is processed by
+a macro: it does not inherit any of the special properties that the
+character from which it was constructed might have had.  For example,
+the input
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di x
+\\\\
+.br
+.di
+.x
+</pre></div></div>
+
+<p>produces &lsquo;<samp class="samp">\\</samp>&rsquo; in GNU <code class="code">troff</code>.  Each pair of backslashes
+becomes one backslash <em class="emph">glyph</em>; the resulting backslashes are thus
+not interpreted as escape <em class="emph">characters</em> when they are reread as the
+diversion is output.  <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> <em class="emph">would</em> interpret
+them as escape characters when rereading them and end up printing one
+&lsquo;<samp class="samp">\</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-printing-backslash-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-backslash_002c-printing-_0028_005c_005c_002c-_005ce_002c-_005cE_002c-_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-_005ce_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-_005c_0021_002c-incompatibilities-with-AT_0026T-troff-1"></a>
+<a class="index-entry-id" id="index-_005c_003f_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-transparent-output_002c-incompatibilities-with-AT_0026T-troff"></a>
+<a class="index-entry-id" id="index-output_002c-transparent_002c-incompatibilities-with-AT_0026T-troff"></a>
+<p>One correct way to obtain a printable backslash in most documents is to
+use the <code class="code">\e</code> escape sequence; this always prints a single instance
+of the current escape character,<a class="footnote" id="DOCF122" href="groff.html_fot.html#FOOT122"><sup>122</sup></a> regardless of whether or not it is used in a diversion; it
+also works in both GNU <code class="code">troff</code> and <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.
+</p>
+<p>The other correct way, appropriate in contexts independent of the
+backslash&rsquo;s common use as a <code class="code">troff</code> escape character&mdash;perhaps in
+discussion of character sets or other programming languages&mdash;is
+the character escape <code class="code">\(rs</code> or <code class="code">\rs</code>, for &ldquo;reverse
+solidus&rdquo;, from its name in the <abbr class="acronym">ECMA-6</abbr> (<abbr class="acronym">ISO/IEC</abbr> 646)
+standard.<a class="footnote" id="DOCF123" href="groff.html_fot.html#FOOT123"><sup>123</sup></a>
+</p>
+<p>To store an escape sequence in a diversion that is interpreted when the
+diversion is reread, either use the traditional <code class="code">\!</code> transparent
+output facility, or, if this is unsuitable, the new <code class="code">\?</code> escape
+sequence.  See <a class="xref" href="Diversions.html">Diversions</a> and <a class="ref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>.
+</p>
+<p>In the somewhat pathological case where a diversion exists containing a
+partially collected line and a partially collected line at the top-level
+diversion has never existed, <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> will output the
+partially collected line at the end of input; GNU <code class="code">troff</code> will not.
+</p>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Compatibility-Mode.html">Compatibility Mode</a>, Up: <a href="Implementation-Differences.html">Implementation Differences</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Output-Device-Intro.html Added

@@ -0,0 +1,63 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Output Device Intro (The GNU Troff Manual)</title>
+
+<meta name="description" content="Output Device Intro (The GNU Troff Manual)">
+<meta name="keywords" content="Output Device Intro (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Installation.html" rel="next" title="Installation">
+<link href="Preprocessor-Intro.html" rel="prev" title="Preprocessor Intro">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Output-Device-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="Installation.html" accesskey="n" rel="next">Installation</a>, Previous: <a href="Preprocessor-Intro.html" accesskey="p" rel="prev">Preprocessors</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Output-Devices">1.6 Output Devices</h3>
+<a class="index-entry-id" id="index-postprocessors"></a>
+<a class="index-entry-id" id="index-output-devices"></a>
+<a class="index-entry-id" id="index-devices-for-output"></a>
+
+<p>GNU <code class="code">troff</code>&rsquo;s output is in a device-independent page description
+language, which is then read by an <em class="dfn">output driver</em> that translates
+this language into a file format or byte stream that a piece of
+(possibly emulated) hardware understands.  <code class="code">groff</code> features output
+drivers for PostScript devices, terminal emulators (and other simple
+typewriter-like machines), X11 (for previewing), TeX DVI, HP
+LaserJet&nbsp;4/PCL5 and Canon LBP printers (which use <abbr class="acronym">CaPSL</abbr>),
+<abbr class="acronym">HTML</abbr>, <abbr class="acronym">XHTML</abbr>, and <abbr class="acronym">PDF</abbr>.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Output-Language-Compatibility.html Added

@@ -0,0 +1,103 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Output Language Compatibility (The GNU Troff Manual)</title>
+
+<meta name="description" content="Output Language Compatibility (The GNU Troff Manual)">
+<meta name="keywords" content="Output Language Compatibility (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="gtroff-Output.html" rel="up" title="gtroff Output">
+<link href="Intermediate-Output-Examples.html" rel="prev" title="Intermediate Output Examples">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Output-Language-Compatibility">
+<div class="nav-panel">
+<p>
+Previous: <a href="Intermediate-Output-Examples.html" accesskey="p" rel="prev">Intermediate Output Examples</a>, Up: <a href="gtroff-Output.html" accesskey="u" rel="up"><code class="code">gtroff</code> Output</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Output-Language-Compatibility-1">6.1.4 Output Language Compatibility</h4>
+
+<p>The intermediate output language of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> was
+first documented in <cite class="cite">A Typesetter-independent TROFF</cite>, by Brian
+Kernighan, and by 1992 the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> manual was
+updated to incorprate a description of it.
+</p>
+<p>The GNU <code class="code">troff</code> intermediate output format is compatible with this
+specification except for the following features.
+</p>
+<ul class="itemize mark-bullet">
+<li>The classical quasi-device independence is not yet implemented.
+
+</li><li>The old hardware was very different from what we use today.  So the
+<code class="code">groff</code> devices are also fundamentally different from the ones
+in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.  For example, the <abbr class="acronym">AT&amp;T</abbr>
+PostScript device is called <code class="code">post</code> and has a resolution of only 720
+units per inch, suitable for printers 20 years ago, while <code class="code">groff</code>&rsquo;s
+<code class="code">ps</code> device has a resolution of 72000 units per inch.  Maybe, by
+implementing some rescaling mechanism similar to the classical
+quasi-device independence, <code class="code">groff</code> could emulate <abbr class="acronym">AT&amp;T</abbr>&rsquo;s
+<code class="code">post</code> device.
+
+</li><li>The B-spline command &lsquo;<samp class="samp">D~</samp>&rsquo; is correctly handled by the intermediate
+output parser, but the drawing routines aren&rsquo;t implemented in some of
+the postprocessor programs.
+
+</li><li>The argument of the commands &lsquo;<samp class="samp">s</samp>&rsquo; and &lsquo;<samp class="samp">x&nbsp;H</samp>&rsquo; has the
+implicit unit scaled point &lsquo;<samp class="samp">z</samp>&rsquo; in <code class="code">gtroff</code>, while
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> has point (&lsquo;<samp class="samp">p</samp>&rsquo;).  This isn&rsquo;t an
+incompatibility but a compatible extension, for both units coincide for
+all devices without a <code class="code">sizescale</code> parameter in the <samp class="file">DESC</samp>
+file, including all postprocessors from <abbr class="acronym">AT&amp;T</abbr> and
+<code class="code">groff</code>&rsquo;s text devices.  The few <code class="code">groff</code> devices with a
+<code class="code">sizescale</code> parameter either do not exist for <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, have a different name, or seem to have a different
+resolution.  So conflicts are very unlikely.
+
+</li><li>The position changing after the commands &lsquo;<samp class="samp">Dp</samp>&rsquo;, &lsquo;<samp class="samp">DP</samp>&rsquo;, and
+&lsquo;<samp class="samp">Dt</samp>&rsquo; is illogical, but as old versions of <code class="code">gtroff</code> used this
+feature it is kept for compatibility reasons.
+
+
+</li></ul>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Intermediate-Output-Examples.html">Intermediate Output Examples</a>, Up: <a href="gtroff-Output.html"><code class="code">gtroff</code> Output</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Control.html Added

@@ -0,0 +1,218 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Control (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Control (The GNU Troff Manual)">
+<meta name="keywords" content="Page Control (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Using-Fonts.html" rel="next" title="Using Fonts">
+<link href="Page-Layout.html" rel="prev" title="Page Layout">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Page-Control">
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Fonts.html" accesskey="n" rel="next">Using Fonts</a>, Previous: <a href="Page-Layout.html" accesskey="p" rel="prev">Page Layout</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Page-Control-1">5.18 Page Control</h3>
+<a class="index-entry-id" id="index-page-control"></a>
+<a class="index-entry-id" id="index-control_002c-page"></a>
+
+<a class="index-entry-id" id="index-page-break-1"></a>
+<a class="index-entry-id" id="index-break_002c-page-1"></a>
+<a class="index-entry-id" id="index-page-ejection-1"></a>
+<a class="index-entry-id" id="index-ejection_002c-page-1"></a>
+<p>Discretionary page breaks can prevent the unwanted separation of
+content.  A new page number takes effect during page ejection; see
+<a class="ref" href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebp"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-bp"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ebp-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002ebp-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.bp</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002ebp-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_0025_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n%</code></strong><a class="copiable-link" href='#index-_005cn_005b_0025_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0025-2"></a>
+<a class="index-entry-id" id="index-new-page-_0028bp_0029"></a>
+<a class="index-entry-id" id="index-page_002c-new-_0028bp_0029"></a>
+<p>Break the page and change (increase or decrease) the next page number
+per the numeric expression <var class="var">page-number</var>.  If <var class="var">page-number</var> is
+invalid, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and
+ignores the argument.  This request causes a break.  A page break
+advances the vertical drawing position to the bottom of the page,
+springing traps.  See <a class="xref" href="Page-Location-Traps.html">Page Location Traps</a>.
+<a class="index-entry-id" id="index-bp-request_002c-and-top_002dlevel-diversion"></a>
+<a class="index-entry-id" id="index-top_002dlevel-diversion_002c-and-bp"></a>
+<a class="index-entry-id" id="index-diversion_002c-top_002dlevel_002c-and-bp"></a>
+<code class="code">bp</code> has effect only if invoked within the top-level
+diversion.<a class="footnote" id="DOCF71" href="groff.html_fot.html#FOOT71"><sup>71</sup></a>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-2"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-bp-request"></a>
+This request is incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as having a default scaling unit of &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-page-number-register-_0028_0025_0029"></a>
+<a class="index-entry-id" id="index-current-page-number-_0028_0025_0029"></a>
+<p>The register <code class="code">%</code> interpolates the current page number.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de BP
+'  bp \&quot; schedule page break once current line is output
+..
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ene"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ne</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002ene'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ne"></a>
+<a class="index-entry-id" id="index-orphan-lines_002c-preventing-with-ne"></a>
+<a class="index-entry-id" id="index-conditional-page-break-_0028ne_0029"></a>
+<a class="index-entry-id" id="index-page-break_002c-conditional-_0028ne_0029"></a>
+<p>Force a page break if insufficient vertical space is available (assert
+&ldquo;needed&rdquo; space).  <code class="code">ne</code> tests the distance to the next page
+location trap; see <a class="ref" href="Page-Location-Traps.html">Page Location Traps</a>, and breaks the page if
+that amount is less than <var class="var">space</var>.  The default scaling unit is
+&lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">space</var> is invalid, GNU <code class="code">troff</code> emits a warning
+in category &lsquo;<samp class="samp">number</samp>&rsquo; and ignores the argument.  If <var class="var">space</var> is
+not specified, &lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p>
+<a class="index-entry-id" id="index-widow"></a>
+<p>We can require space for at least the first two output lines of a
+paragraph, preventing its first line from being <i class="slanted">widowed</i> at the
+page bottom.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ne 2v
+Considering how common illness is,
+how tremendous the spiritual change that it brings,
+how astonishing,
+when the lights of health go down,
+the undiscovered countries that are then disclosed,
+what wastes and deserts of the soul a slight attack
+of influenza brings to view,
+</pre></div></div>
+
+<p>This method is reliable only if no output line is pending when <code class="code">ne</code>
+is invoked.  When macro packages are used, this is often not the case:
+their paragraphing macros perform the break.  You may need to experiment
+with placing the <code class="code">ne</code> after the paragraphing macro, or <code class="code">br</code>
+and <code class="code">ne</code> before it.
+</p>
+<a class="index-entry-id" id="index-orphan"></a>
+<a class="index-entry-id" id="index-widow-1"></a>
+<p><code class="code">ne</code> is also useful to force grouping of section headings with
+their subsequent paragraphs, or tables with their captions and/or
+explanations.  Macro packages often use <code class="code">ne</code> with diversions to
+implement keeps and displays; see <a class="ref" href="Diversions.html">Diversions</a>.  They may also offer
+parameters for widow and orphan management.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esv"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.sv</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">space</i></span></var><a class="copiable-link" href='#index-_002esv'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sv"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eos"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.os</code></strong><a class="copiable-link" href='#index-_002eos'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-os"></a>
+<a class="index-entry-id" id="index-ne-request_002c-comparison-with-sv"></a>
+<p>Require vertical space as <code class="code">ne</code> does, but also <i class="slanted">save</i> it for
+later output by the <code class="code">os</code> request.  If <var class="var">space</var> is available
+before the next page location trap, it is output immediately.  Both
+requests ignore a partially collected line, taking effect at the next
+break.
+<a class="index-entry-id" id="index-sv-request_002c-and-no_002dspace-mode"></a>
+<a class="index-entry-id" id="index-os-request_002c-and-no_002dspace-mode"></a>
+<code class="code">sv</code> and <code class="code">os</code> ignore no-space mode (recall <a class="ref" href="Manipulating-Spacing.html">Manipulating Spacing</a>).  While the <code class="code">sv</code> request allows negative values for
+<var class="var">space</var>, <code class="code">os</code> ignores them.  The default scaling unit is
+&lsquo;<samp class="samp">v</samp>&rsquo;.  If <var class="var">space</var> is not specified, &lsquo;<samp class="samp">1v</samp>&rsquo; is assumed.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bnl_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nnl</code></strong><a class="copiable-link" href='#index-_005cn_005bnl_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nl"></a>
+<a class="index-entry-id" id="index-vertical-drawing-position-_0028nl_0029"></a>
+<a class="index-entry-id" id="index-vertical-position_002c-drawing-_0028nl_0029"></a>
+<a class="index-entry-id" id="index-drawing-position_002c-vertical-_0028nl_0029"></a>
+<p><code class="code">nl</code> interpolates or sets the vertical drawing position.  When the
+formatter starts, the first page transition hasn&rsquo;t happened yet, and
+<code class="code">nl</code> is negative.  If a header trap has been planted on the page
+(typically at vertical position <code class="code">0</code>), you can assign a negative
+value to <code class="code">nl</code> to spring it if that page has already started
+(see <a class="pxref" href="Page-Location-Traps.html">Page Location Traps</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de HD
+.  sp
+.  tl ''Goldbach Solution''
+.  sp
+..
+.
+First page.
+.bp
+.wh 0 HD \&quot; plant header trap at top of page
+.nr nl (-1)
+Second page.
+    &rArr; First page.
+    &rArr;
+    &rArr; <span class="r"><i class="i">(blank lines elided)</i></span>
+    &rArr;
+    &rArr;                         Goldbach Solution
+    &rArr;
+    &rArr; <span class="r"><i class="i">(blank lines elided)</i></span>
+    &rArr;
+    &rArr; Second page.
+</pre></div></div>
+
+<p>Without resetting <code class="code">nl</code> to a negative value, the trap just planted
+would be active beginning with the <em class="emph">next</em> page, not the current
+one.
+</p>
+<p>See <a class="xref" href="Diversions.html">Diversions</a>, for a comparison of <code class="code">nl</code> with the <code class="code">.h</code> and
+<code class="code">.d</code> registers.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Using-Fonts.html">Using Fonts</a>, Previous: <a href="Page-Layout.html">Page Layout</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Geometry.html Added

@@ -0,0 +1,140 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Geometry (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Geometry (The GNU Troff Manual)">
+<meta name="keywords" content="Page Geometry (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Measurements.html" rel="next" title="Measurements">
+<link href="Text.html" rel="prev" title="Text">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Page-Geometry">
+<div class="nav-panel">
+<p>
+Next: <a href="Measurements.html" accesskey="n" rel="next">Measurements</a>, Previous: <a href="Text.html" accesskey="p" rel="prev">Text</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Page-Geometry-1">5.2 Page Geometry</h3>
+<a class="index-entry-id" id="index-page_002c-geometry-of"></a>
+<a class="index-entry-id" id="index-geometry_002c-page"></a>
+
+<p><code class="code">roff</code> systems format text under certain assumptions about the size
+of the output medium, or page.  For the formatter to correctly break a
+line it is filling, it must know the line length, which it derives from
+the page width (see <a class="pxref" href="Line-Layout.html">Line Layout</a>).  For it to decide whether to write
+an output line to the current page or wait until the next one, it must
+know the page length (see <a class="pxref" href="Page-Layout.html">Page Layout</a>).
+</p>
+<a class="index-entry-id" id="index-device-resolution"></a>
+<a class="index-entry-id" id="index-resolution_002c-device"></a>
+<a class="index-entry-id" id="index-basic-units"></a>
+<a class="index-entry-id" id="index-units_002c-basic"></a>
+<a class="index-entry-id" id="index-machine-units"></a>
+<a class="index-entry-id" id="index-units_002c-machine"></a>
+<p>A device&rsquo;s <em class="dfn">resolution</em> converts practical units like inches or
+centimeters to <em class="dfn">basic units</em>, a convenient length measure for the
+output device or file format.  The formatter and output driver use basic
+units to reckon page measurements.  The device description file defines
+its resolution and page dimensions (see <a class="pxref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>).
+</p>
+<a class="index-entry-id" id="index-page"></a>
+<p>A <em class="dfn">page</em> is a two-dimensional structure upon which a <code class="code">roff</code>
+system imposes a rectangular coordinate system with its upper left
+corner as the origin.  Coordinate values are in basic units and increase
+down and to the right.  Useful ones are therefore always positive and
+within numeric ranges corresponding to the page boundaries.
+</p>
+<a class="index-entry-id" id="index-drawing-position"></a>
+<a class="index-entry-id" id="index-position_002c-drawing"></a>
+<p>While the formatter (and, later, output driver) is processing a page, it
+keeps track of its <em class="dfn">drawing position</em>, which is the location at
+which the next glyph will be written, from which the next motion will be
+measured, or where a geometric object will commence rendering.
+<a class="index-entry-id" id="index-text-baseline"></a>
+<a class="index-entry-id" id="index-baseline_002c-text"></a>
+Notionally, glyphs are drawn from the text baseline upward and to the
+right.<a class="footnote" id="DOCF33" href="groff.html_fot.html#FOOT33"><sup>33</sup></a>  The <em class="dfn">text baseline</em> is a (usually invisible) line upon
+which the glyphs of a typeface are aligned.  A glyph therefore
+&ldquo;starts&rdquo; at its bottom-left corner.  If drawn at the origin, a typical
+letter glyph would lie partially or wholly off the page, depending on
+whether, like &ldquo;g&rdquo;, it features a descender below the baseline.
+</p>
+<a class="index-entry-id" id="index-page-offset"></a>
+<a class="index-entry-id" id="index-offset_002c-page"></a>
+<p>Such a situation is nearly always undesirable.  It is furthermore
+conventional not to write or draw at the extreme edges of the page.
+Therefore the initial drawing position of a <code class="code">roff</code> formatter is not
+at the origin, but below and to the right of it.  This rightward shift
+from the left edge is known as the <em class="dfn">page
+offset</em>.<a class="footnote" id="DOCF34" href="groff.html_fot.html#FOOT34"><sup>34</sup></a>  The downward shift leaves room for a text output
+line.
+</p>
+<p>Text is arranged on a one-dimensional lattice of text baselines from the
+top to the bottom of the page.
+<a class="index-entry-id" id="index-vertical-spacing"></a>
+<a class="index-entry-id" id="index-spacing_002c-vertical"></a>
+<a class="index-entry-id" id="index-vee"></a>
+<em class="dfn">Vertical spacing</em> is the distance between adjacent text baselines.
+Typographic tradition sets this quantity to 120% of the type size.  The
+initial drawing position is one unit of vertical spacing below the page
+top.  Typographers term this unit a <i class="slanted">vee</i>.
+</p>
+<a class="index-entry-id" id="index-page-break"></a>
+<a class="index-entry-id" id="index-break_002c-page"></a>
+<a class="index-entry-id" id="index-page-ejection"></a>
+<a class="index-entry-id" id="index-ejection_002c-page"></a>
+<p>Vertical spacing has an impact on page-breaking decisions.  Generally,
+when a break occurs, the formatter moves the drawing position to the
+next text baseline automatically.  If the formatter were already writing
+to the last line that would fit on the page, advancing by one vee would
+place the next text baseline off the page.  Rather than let that happen,
+<code class="code">roff</code> formatters instruct the output driver to eject the page,
+start a new one, and again set the drawing position to one vee below the
+page top; this is a <em class="dfn">page break</em>.
+</p>
+<p>When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one.  Macro packages keep
+users from having to confront this difficulty by setting &ldquo;traps&rdquo;
+(see <a class="pxref" href="Traps.html">Traps</a>); moreover, all but the simplest page layouts tend to
+have headers and footers, or at least bear vertical margins larger than
+one vee.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Measurements.html">Measurements</a>, Previous: <a href="Text.html">Text</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Layout-Adjustment.html Added

@@ -0,0 +1,57 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Layout Adjustment (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Layout Adjustment (The GNU Troff Manual)">
+<meta name="keywords" content="Page Layout Adjustment (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Displays-and-Keeps.html" rel="next" title="Displays and Keeps">
+<link href="Headers-and-Footers.html" rel="prev" title="Headers and Footers">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Page-Layout-Adjustment">
+<div class="nav-panel">
+<p>
+Next: <a href="Displays-and-Keeps.html" accesskey="n" rel="next">Displays and Keeps</a>, Previous: <a href="Headers-and-Footers.html" accesskey="p" rel="prev">Headers and Footers</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Page-Layout-1">3.2.4 Page Layout</h4>
+
+<p>Most macro packages let the user specify the size of the page margins.
+The top and bottom margins are typically handled differently than the
+left and right margins; the latter two are derived from the
+<i class="slanted">page offset</i>, <i class="slanted">indentation</i>, and <i class="slanted">line length</i>.
+See <a class="xref" href="Line-Layout.html">Line Layout</a>.  Commonly, packages support registers to tune these
+values.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Layout.html Added

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Layout (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Layout (The GNU Troff Manual)">
+<meta name="keywords" content="Page Layout (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Page-Control.html" rel="next" title="Page Control">
+<link href="Line-Continuation.html" rel="prev" title="Line Continuation">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Page-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Control.html" accesskey="n" rel="next">Page Control</a>, Previous: <a href="Line-Continuation.html" accesskey="p" rel="prev">Line Continuation</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Page-Layout-2">5.17 Page Layout</h3>
+<a class="index-entry-id" id="index-page-layout"></a>
+<a class="index-entry-id" id="index-layout_002c-page"></a>
+
+<p>The formatter permits configuration of the page length and page number.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pl"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epl-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epl-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pl</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002epl-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ep_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.p</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ep_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ep"></a>
+<a class="index-entry-id" id="index-page-length_002c-configuring-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-length-of-the-page_002c-configuring-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-configuring-the-page-length-_0028pl_0029"></a>
+<a class="index-entry-id" id="index-setting-the-page-length-_0028pl_0029"></a>
+<p>Change (increase or decrease) the page length per the numeric expression
+<var class="var">length</var>.  The default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  A negative
+<var class="var">length</var> is valid, but an uncommon application: it prevents page
+location traps from being sprung,<a class="footnote" id="DOCF70" href="groff.html_fot.html#FOOT70"><sup>70</sup></a> and each
+output line is placed on a new page.  If <var class="var">length</var> is invalid, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo;.  If <var class="var">length</var>
+is absent or invalid, &lsquo;<samp class="samp">11i</samp>&rsquo; is assumed.
+</p>
+<a class="index-entry-id" id="index-page-length-register-_0028_002ep_0029"></a>
+<p>The read-only register &lsquo;<samp class="samp">.p</samp>&rsquo; interpolates the current page length.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments">num</var><a class="copiable-link" href='#index-_002epn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pn"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002epn-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">num</i></span></var><a class="copiable-link" href='#index-_002epn-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002epn-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pn</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">num</i></span></var><a class="copiable-link" href='#index-_002epn-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002epn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epn-3"></a>
+<a class="index-entry-id" id="index-page-number_002c-configuring-next-_0028pn_0029"></a>
+<a class="index-entry-id" id="index-next-page-number_002c-configuring-_0028pn_0029"></a>
+<a class="index-entry-id" id="index-number_002c-page_002c-next_002c-configuring-_0028pn_0029"></a>
+<p>Change (increase or decrease) the page number of the <em class="emph">next</em> page
+per the numeric expression <var class="var">num</var>.  If <var class="var">num</var> is invalid, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and ignores the
+request.  Without an argument, <code class="code">pn</code> is ignored.
+</p>
+<a class="index-entry-id" id="index-next-page-number-register-_0028_002epn_0029"></a>
+<a class="index-entry-id" id="index-page-number_002c-next_002c-register-_0028_002epn_0029"></a>
+<p>The read-only register <code class="code">.pn</code> interpolates <var class="var">num</var> if set by
+<code class="code">pn</code> on the current page, or the current page number plus&nbsp;1.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-headers"></a>
+<a class="index-entry-id" id="index-footers"></a>
+<a class="index-entry-id" id="index-titles"></a>
+<p>The formatter offers special support for typesetting headers and
+footers, collectively termed <em class="dfn">titles</em>.  Titles have an independent
+line length, and their placement on the page is not restricted.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etl"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tl</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002etl'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tl"></a>
+<a class="index-entry-id" id="index-title-line_002c-formatting-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-formatting-a-title-line-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-three_002dpart-title-_0028tl_0029"></a>
+<a class="index-entry-id" id="index-page-number-character-_0028_0025_0029"></a>
+<p>Format an output line as a title consisting of <var class="var">left</var>, <var class="var">center</var>,
+and <var class="var">right</var>, each aligned accordingly.  The delimiter need not be a
+neutral apostrophe: <code class="code">tl</code> accepts the same delimiters as most escape
+sequences; see <a class="ref" href="Delimiters.html">Delimiters</a>.  If not used as the delimiter, any
+<em class="dfn">page number character</em> character is replaced with the current page
+number; the default is &lsquo;<samp class="samp">%</samp>&rsquo;; see the the <code class="code">pc</code> request below.
+Without an argument, <code class="code">tl</code> is ignored.  <code class="code">tl</code> writes the title
+line immediately, ignoring any partially collected line.
+</p>
+<p>It is not an error to omit delimiters after the first.  For example,
+&lsquo;<samp class="samp">.tl&nbsp;/Thesis</samp>&rsquo; is interpreted as &lsquo;<samp class="samp">.tl&nbsp;/Thesis///</samp>&rsquo;: it
+sets a title line comprising only the left-aligned word &lsquo;<samp class="samp">Thesis</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-lt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002elt-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><code class="t">+</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt-1'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_002elt-2"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.lt</code></strong> <var class="def-var-arguments"><code class="t">-</code><span class="r"><i class="slanted">length</i></span></var><a class="copiable-link" href='#index-_002elt-2'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.lt</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elt-3"></a>
+<a class="index-entry-id" id="index-length-of-title-line_002c-configuring-_0028lt_0029"></a>
+<a class="index-entry-id" id="index-title-length_002c-configuring-_0028lt_0029"></a>
+<p>Change (increase or decrease) the line length used by titles per the
+numeric expression <var class="var">length</var>.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.
+If <var class="var">length</var> is negative, GNU emits a warning in category
+&lsquo;<samp class="samp">range</samp>&rsquo; and treats <var class="var">length</var> as &lsquo;<samp class="samp">0</samp>&rsquo;.  If <var class="var">length</var> is
+invalid, GNU <code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">number</samp>&rsquo; and
+ignores the request.  The formatter&rsquo;s default title length is
+&lsquo;<samp class="samp">6.5i</samp>&rsquo;.  With no argument, the title length is restored to the
+previous value.  The title length is is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-title-line-length-register-_0028_002elt_0029"></a>
+<p>The read-only register &lsquo;<samp class="samp">.lt</samp>&rsquo; interpolates the title line length.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002epc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.pc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">char</i></span></var><a class="copiable-link" href='#index-_002epc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-pc"></a>
+<a class="index-entry-id" id="index-changing-the-page-number-character-_0028pc_0029"></a>
+<a class="index-entry-id" id="index-page-number-character_002c-changing-_0028pc_0029"></a>
+<a class="index-entry-id" id="index-_0025-1"></a>
+<p>Set the page number character to <var class="var">char</var>.  With no argument, the page
+number character is disabled.  <code class="code">pc</code> does not affect the
+register&nbsp;<code class="code">%</code>.
+</p></dd></dl>
+
+<p>The following example exercises title features.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.lt 50n
+This is my partially collected
+.tl 'Isomers 2023'%'Dextrose Edition'
+line.
+    &rArr; Isomers 2023             1        Dextrose Edition
+    &rArr; This is my partially collected line.
+</pre></div></div>
+
+<p>We most often see titles used in page header and footer traps.
+See <a class="xref" href="Traps.html">Traps</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Control.html">Page Control</a>, Previous: <a href="Line-Continuation.html">Line Continuation</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Location-Traps.html Added

@@ -0,0 +1,326 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Location Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Location Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Page Location Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Vertical-Position-Traps.html" rel="up" title="Vertical Position Traps">
+<link href="The-Implicit-Page-Trap.html" rel="next" title="The Implicit Page Trap">
+<link href="Vertical-Position-Traps.html" rel="prev" title="Vertical Position Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Page-Location-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="The-Implicit-Page-Trap.html" accesskey="n" rel="next">The Implicit Page Trap</a>, Previous: <a href="Vertical-Position-Traps.html" accesskey="p" rel="prev">Vertical Position Traps</a>, Up: <a href="Vertical-Position-Traps.html" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Page-Location-Traps-1">5.28.1.1 Page Location Traps</h4>
+<a class="index-entry-id" id="index-page-location-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-page-location"></a>
+
+<p>A <em class="dfn">page location trap</em> is a vertical position trap that applies to
+the page; that is, to undiverted output.  Many can be present; manage
+them with the <code class="code">wh</code> and <code class="code">ch</code> requests.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewh"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.wh</code></strong> <var class="def-var-arguments">dist <span class="r"><i class="slanted">name</i></span></var><a class="copiable-link" href='#index-_002ewh'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-wh"></a>
+<p>Plant macro <var class="var">name</var> as page location trap at <var class="var">dist</var>.  The default
+scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  Non-negative values for <var class="var">dist</var> set the
+trap relative to the top of the page; negative values set the trap
+relative to the bottom of the page.  It is not possible to plant a trap
+less than one basic unit from the page bottom: a <var class="var">dist</var> of <code class="code">-0</code>
+is interpreted as <code class="code">0</code>, the top of the page.<a class="footnote" id="DOCF106" href="groff.html_fot.html#FOOT106"><sup>106</sup></a>  An existing <em class="emph">visible</em> trap (see below) at
+<var class="var">dist</var> is removed; this is <code class="code">wh</code>&rsquo;s sole function if <var class="var">name</var>
+is missing.
+</p>
+<p>A trap is sprung only if it is <em class="dfn">visible</em>, meaning that its location
+is reachable on the page<a class="footnote" id="DOCF107" href="groff.html_fot.html#FOOT107"><sup>107</sup></a> and it
+is not hidden by another trap at the same location already planted
+there.
+</p>
+<a class="index-entry-id" id="index-page-headers"></a>
+<a class="index-entry-id" id="index-page-footers"></a>
+<a class="index-entry-id" id="index-headers-1"></a>
+<a class="index-entry-id" id="index-footers-1"></a>
+<a class="index-entry-id" id="index-top-margin"></a>
+<a class="index-entry-id" id="index-margin_002c-top"></a>
+<a class="index-entry-id" id="index-bottom-margin"></a>
+<a class="index-entry-id" id="index-margin_002c-bottom"></a>
+<p>A macro package might set headers and footers as follows; this example
+configures vertical margins of one inch to the body text, and one
+half-inch to the titles.  Observe the use of the no-break control
+character with <code class="code">sp</code> request to position our text baselines,
+and the page number character &lsquo;<samp class="samp">%</samp>&rsquo; used with the <code class="code">tl</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; hdfo.roff
+.de hd                  \&quot; page header
+'  sp .5i
+'  tl '\\*(Ti''\\*(Da'  \&quot; title and date strings
+'  sp .5i
+..
+.de fo                  \&quot; page footer
+'  sp .5i
+.  tl ''%''
+.  bp
+..
+.wh 0   hd             \&quot; trap at top of the page
+.wh -1i fo             \&quot; trap 1 inch from bottom
+</pre></div></div>
+
+<p>To use these traps, copy the above (or load it from a file with the
+<code class="code">so</code> or <code class="code">mso</code> requests), then set up the strings it uses.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.so hdfo.roff
+.ds Ti Final Report\&quot;
+.ds Da 21 May 2023\&quot;
+.ti
+On 5 August of last year,
+this committee tasked me with the investigation of the
+CFIT (controlled flight into terrain) incident of
+.\&quot; <i class="i">...and so on...</i>
+</pre></div></div>
+
+<p>A trap above the top or at or below the bottom of the page can be made
+visible by either moving it into the page area or increasing the page
+length so that the trap is on the page.  Negative trap values always use
+the <em class="emph">current</em> page length; they are not converted to an absolute
+vertical position.
+<a class="index-entry-id" id="index-page-location-traps_002c-debugging"></a>
+<a class="index-entry-id" id="index-debugging-page-location-traps"></a>
+We can use the <code class="code">ptr</code> request to dump our page location traps to the
+standard error stream (see <a class="pxref" href="Debugging.html">Debugging</a>).  Their positions are reported
+in basic units; an <code class="code">nroff</code> device example follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 5i
+.wh -1i xx
+.ptr
+    error&rarr; xx      -240
+.pl 100i
+.ptr
+    error&rarr; xx      -240
+</pre></div></div>
+
+<p>It is possible to have more than one trap at the same location (although
+only one at a time can be visible); to achieve this, the traps must be
+defined at different locations, then moved to the same place with the
+<code class="code">ch</code> request.  In the following example, the many empty lines
+caused by the <code class="code">bp</code> request are not shown in the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de a
+.  nop a
+..
+.de b
+.  nop b
+..
+.de c
+.  nop c
+..
+.
+.wh 1i a
+.wh 2i b
+.wh 3i c
+.bp
+    &rArr; a b c
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ch b 1i
+.ch c 1i
+.bp
+    &rArr; a
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ch a 0.5i
+.bp
+    &rArr; a b
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002et_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.t</code></strong><a class="copiable-link" href='#index-_005cn_005b_002et_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002et"></a>
+<a class="index-entry-id" id="index-distance-to-next-vertical-position-trap-register-_0028_002et_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-distance-to-next-vertical-position_002c-register-_0028_002et_0029"></a>
+<p>The read-only register <code class="code">.t</code> holds the distance to the next vertical
+position trap.  If there are no traps between the current position and
+the bottom of the page, it contains the distance to the page bottom.
+Within a diversion, in the absence of a diversion trap, this distance is
+the largest representable integer in basic units&mdash;effectively infinite.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ech"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ch</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">dist</i></span></var><a class="copiable-link" href='#index-_002ech'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ch"></a>
+<a class="index-entry-id" id="index-changing-trap-location-_0028ch_0029"></a>
+<a class="index-entry-id" id="index-trap_002c-changing-location-_0028ch_0029"></a>
+<p>Change the location of a trap by moving macro <var class="var">name</var> to new location
+<var class="var">dist</var>, or by unplanting it altogether if <var class="var">dist</var> is absent.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  Parameters to <code class="code">ch</code> are specified
+in the opposite order from <code class="code">wh</code>.  If <var class="var">name</var> is the earliest
+planted macro of multiple traps at the same location, (re)moving it from
+that location exposes the macro next least recently planted at the same
+place.<a class="footnote" id="DOCF108" href="groff.html_fot.html#FOOT108"><sup>108</sup></a>
+</p>
+<p>Changing a trap&rsquo;s location is useful for building up footnotes in a
+diversion to allow more space at the bottom of the page for them.
+</p>
+
+</dd></dl>
+
+<p>The same macro can be installed simultaneously at multiple locations;
+however, only the earliest-planted instance&mdash;that has not yet been
+deleted with <code class="code">wh</code>&mdash;will be moved by <code class="code">ch</code>.  The following
+example (using an <code class="code">nroff</code> device) illustrates this behavior.  Blank
+lines have been elided from the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de T
+Trap sprung at \\n(nlu.
+.br
+..
+.wh 1i T
+.wh 2i T
+foo
+.sp 11i
+.bp
+.ch T 4i
+bar
+.sp 11i
+.bp
+.ch T 5i
+baz
+.sp 11i
+.bp
+.wh 5i
+.ch T 6i
+qux
+.sp 11i
+</pre></div></div>
+<div class="example">
+<div class="group"><pre class="example-preformatted">    &rArr; foo
+    &rArr; Trap sprung at 240u.
+    &rArr; Trap sprung at 480u.
+    &rArr; bar
+    &rArr; Trap sprung at 480u.
+    &rArr; Trap sprung at 960u.
+    &rArr; baz
+    &rArr; Trap sprung at 480u.
+    &rArr; Trap sprung at 1200u.
+    &rArr; qux
+    &rArr; Trap sprung at 1440u.
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ene_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ne</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ene_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ene-1"></a>
+<p>The read-only register <code class="code">.ne</code> contains the amount of space that was
+needed in the last <code class="code">ne</code> request that caused a trap to be sprung;
+it is useful in conjunction with the <code class="code">.trunc</code> register.  See <a class="xref" href="Page-Control.html">Page Control</a>.  Since the <code class="code">.ne</code> register is set only by traps, it
+doesn&rsquo;t make sense to interpolate it outside of macros called by traps.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002etrunc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.trunc</code></strong><a class="copiable-link" href='#index-_005cn_005b_002etrunc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002etrunc"></a>
+<a class="index-entry-id" id="index-ne-request_002c-and-the-_002etrunc-register"></a>
+<a class="index-entry-id" id="index-truncated-vertical-space-register-_0028_002etrunc_0029"></a>
+<p>A read-only register containing the amount of vertical space truncated
+from an <code class="code">sp</code> request by the most recently sprung vertical
+position trap, or, if the trap was sprung by an <code class="code">ne</code> request,
+minus the amount of vertical motion produced by the <code class="code">ne</code>
+request.  In other words, at the point a trap is sprung, it
+represents the difference of what the vertical position would have
+been but for the trap, and what the vertical position actually is.
+Since the <code class="code">.trunc</code> register is set only by traps, it doesn&rsquo;t make
+sense to interpolate it outside of macros called by traps.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002epe_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.pe</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epe"></a>
+<a class="index-entry-id" id="index-bp-request_002c-and-traps-_0028_002epe_0029"></a>
+<a class="index-entry-id" id="index-traps_002c-sprung-by-bp-request-_0028_002epe_0029"></a>
+<a class="index-entry-id" id="index-page-ejection-status-register-_0028_002epe_0029"></a>
+<p>This Boolean-valued, read-only register interpolates&nbsp;1 while a page
+is being ejected, and 0&nbsp;otherwise.
+</p>
+<p>In the following example, we plant the same trap at the top and the
+bottom of the page.  We also make the trap report its name and the
+vertical drawing position.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de T
+.tm \\$0: page \\n%, nl=\\nnl .pe=\\n.pe
+..
+.ll 46n
+.wh 0 T
+.wh -1v T
+Those who can make you believe absurdities can make you
+commit atrocities. \em Voltaire
+    error&rarr; T: page 1, nl=0 .pe=0
+    error&rarr; T: page 1, nl=2600 .pe=1
+    &rArr; Those who can make you believe absurdities can
+    &rArr; make you commit atrocities. -- Voltaire
+</pre></div></div>
+</dd></dl>
+
+<a class="index-entry-id" id="index-diversions_002c-and-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-and-diversions"></a>
+<p>When designing macros, keep in mind that diversions and traps do
+normally interact.  For example, if a trap calls a header macro (while
+outputting a diversion) that tries to change the font on the current
+page, the effect is not visible before the diversion has completely been
+printed (except for input protected with <code class="code">\!</code> or <code class="code">\?</code>) since
+the data in the diversion is already formatted.  In most cases, this is
+not the expected behaviour.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a>, Previous: <a href="Vertical-Position-Traps.html">Vertical Position Traps</a>, Up: <a href="Vertical-Position-Traps.html">Vertical Position Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Page-Motions.html Added

@@ -0,0 +1,454 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Page Motions (The GNU Troff Manual)</title>
+
+<meta name="description" content="Page Motions (The GNU Troff Manual)">
+<meta name="keywords" content="Page Motions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Drawing-Geometric-Objects.html" rel="next" title="Drawing Geometric Objects">
+<link href="Writing-Macros.html" rel="prev" title="Writing Macros">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Page-Motions">
+<div class="nav-panel">
+<p>
+Next: <a href="Drawing-Geometric-Objects.html" accesskey="n" rel="next">Drawing Geometric Objects</a>, Previous: <a href="Writing-Macros.html" accesskey="p" rel="prev">Writing Macros</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Page-Motions-1">5.25 Page Motions</h3>
+<a class="index-entry-id" id="index-page-motions"></a>
+<a class="index-entry-id" id="index-motions_002c-page"></a>
+
+<p>See <a class="xref" href="Manipulating-Spacing.html">Manipulating Spacing</a>, for a discussion of the most commonly used
+request for vertical motion, <code class="code">sp</code>, which spaces downward by one
+vee.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002emk"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.mk</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">reg</i></span></var><a class="copiable-link" href='#index-_002emk'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-mk"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002ert"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">dist</i></span></var><a class="copiable-link" href='#index-_002ert'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rt"></a>
+<a class="index-entry-id" id="index-marking-vertical-page-location-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-page-location_002c-vertical_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-location_002c-vertical_002c-page_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-vertical-page-location_002c-marking-_0028mk_0029"></a>
+<a class="index-entry-id" id="index-returning-to-marked-vertical-page-location-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-page-location_002c-vertical_002c-returning-to-marked-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-location_002c-vertical_002c-page_002c-returning-to-marked-_0028rt_0029"></a>
+<a class="index-entry-id" id="index-vertical-page-location_002c-returning-to-marked-_0028rt_0029"></a>
+<p>You can <em class="dfn">mark</em> a location on a page for subsequent <em class="dfn">return</em>.
+<code class="code">mk</code> takes an argument, a register name in which to store the
+current page location.  If given no argument, it stores the location in
+an internal register.  This location can be used later by the <code class="code">rt</code>
+or the <code class="code">sp</code> requests (or the <code class="code">\v</code> escape).
+</p>
+<p>The <code class="code">rt</code> request returns <em class="emph">upward</em> to the location marked with
+the last <code class="code">mk</code> request.  If used with an argument, it returns to a
+vertical position&nbsp;<var class="var">dist</var> from the top of the page (no previous
+call to <code class="code">mk</code> is necessary in this case).  The default scaling
+unit is &lsquo;<samp class="samp">v</samp>&rsquo;.
+</p>
+<p>If a page break occurs between a <code class="code">mk</code> request and its matching
+<code class="code">rt</code> request, the <code class="code">rt</code> request is silently ignored.
+</p>
+<p>A simple implementation of a macro to set text in two columns follows.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr column-length 1.5i
+.nr column-gap 4m
+.nr bottom-margin 1m
+.
+.de 2c
+.  br
+.  mk
+.  ll \\ncolumn-lengthu
+.  wh -\\nbottom-marginu 2c-trap
+.  nr right-side 0
+..
+.
+.de 2c-trap
+.  ie \\nright-side \{\
+.    nr right-side 0
+.    po -(\\ncolumn-lengthu + \\ncolumn-gapu)
+.    \&quot; remove trap
+.    wh -\\nbottom-marginu
+.  \}
+.  el \{\
+.    \&quot; switch to right side
+.    nr right-side 1
+.    po +(\\ncolumn-lengthu + \\ncolumn-gapu)
+.    rt
+.  \}
+..
+</pre></div></div>
+
+<p>Now let us apply our two-column macro.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.pl 1.5i
+.ll 4i
+This is a small test that shows how the
+rt request works in combination with mk.
+
+.2c
+Starting here, text is typeset in two columns.
+Note that this implementation isn't robust
+and thus not suited for a real two-column
+macro.
+    &rArr; This is a small test that shows how the
+    &rArr; rt request works in combination with mk.
+    &rArr;
+    &rArr; Starting  here,    isn't    robust
+    &rArr; text is typeset    and   thus  not
+    &rArr; in two columns.    suited  for   a
+    &rArr; Note that  this    real two-column
+    &rArr; implementation     macro.
+</pre></div></div>
+</dd></dl>
+
+<p>Several escape sequences enable fine control of movement about the page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cv_0027expr_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\v<code class="code">'</code></code><span class="r"><i class="slanted">expr</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cv_0027expr_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cv"></a>
+<a class="index-entry-id" id="index-vertical-motion-_0028_005cv_0029"></a>
+<a class="index-entry-id" id="index-motion_002c-vertical-_0028_005cv_0029"></a>
+<p>Vertically move the drawing position.  <var class="var">expr</var> indicates the
+magnitude of motion: positive is downward and and negative upward.  The
+default scaling unit is &lsquo;<samp class="samp">v</samp>&rsquo;.  The motion is relative to the current
+drawing position unless <var class="var">expr</var> begins with the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  See <a class="xref" href="Numeric-Expressions.html">Numeric Expressions</a>.
+</p>
+<p>Text processing continues at the new drawing position; usually, vertical
+motions should be in balanced pairs to avoid a confusing page layout.
+</p>
+<p><code class="code">\v</code> will not spring a vertical position trap.  This can be useful;
+for example, consider a page bottom trap macro that prints a marker in
+the margin to indicate continuation of a footnote.  See <a class="xref" href="Traps.html">Traps</a>.
+</p></dd></dl>
+
+<p>A few escape sequences that produce vertical motion are unusual.  They
+are thought to originate early in AT&amp;T <code class="code">nroff</code> history to achieve
+super- and subscripting by half-line motions on line printers and
+teletypewriters before the phototypesetter made more precise positioning
+available.  They are reckoned in ems&mdash;not vees&mdash;to maintain continuity
+with their original purpose of moving relative to the size of the type
+rather than the distance between text baselines (vees).<a class="footnote" id="DOCF103" href="groff.html_fot.html#FOOT103"><sup>103</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cr-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\r</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cr-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cu-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\u</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cu-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cu"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cd-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\d</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cd-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cd"></a>
+<p>Move upward&nbsp;1<span class="dmn">m</span>, upward&nbsp;.5<span class="dmn">m</span>, and
+downward&nbsp;.5<span class="dmn">m</span>, respectively.
+</p></dd></dl>
+
+<p>Let us see these escape sequences in use.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Obtain 100 cm\u3\d of \ka\d\092\h'|\nau'\r233\dU.
+</pre></div></div>
+
+<p>In the foregoing we have paired <code class="code">\u</code> and <code class="code">\d</code> to typeset a
+superscript, and later a full em negative (&ldquo;reverse&rdquo;) motion to place
+a superscript above a subscript.  A numeral-width horizontal motion
+escape sequence aligns the proton and nucleon numbers, while <code class="code">\k</code>
+marks a horizontal position to which <code class="code">\h</code> returns so that we could
+stack them.  (We shall discuss these horizontal motion escape sequences
+presently.)  In serious applications, we often want to alter the type
+size of the -scripts and to fine-tune the vertical motions, as the
+<code class="code">groff</code> <samp class="file">ms</samp> package does with its super- and subscripting
+string definitions.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ch_0027expr_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\h<code class="code">'</code></code><span class="r"><i class="slanted">expr</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005ch_0027expr_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ch"></a>
+<a class="index-entry-id" id="index-inserting-horizontal-space-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-horizontal-space-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-space_002c-horizontal-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-horizontal-motion-_0028_005ch_0029"></a>
+<a class="index-entry-id" id="index-motion_002c-horizontal-_0028_005ch_0029"></a>
+<p>Horizontally move the drawing position.  <var class="var">expr</var> indicates the
+magnitude of motion: positive is rightward and negative leftward.  The
+default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  The motion is relative to the current
+drawing position unless <var class="var">expr</var> begins with the boundary-relative
+motion operator &lsquo;<samp class="samp">|</samp>&rsquo;.  See <a class="xref" href="Numeric-Expressions.html">Numeric Expressions</a>.
+</p></dd></dl>
+
+<p>The following string definition sets the TeX
+logo.<a class="footnote" id="DOCF104" href="groff.html_fot.html#FOOT104"><sup>104</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\&quot;
+</pre></div></div>
+
+<p>There are a number of special-case escape sequences for horizontal
+motion.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cSP-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<kbd class="key">SP</kbd></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cSP-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cSP"></a>
+<a class="index-entry-id" id="index-space_002c-unbreakable-and-unadjustable-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-unbreakable-and-unadjustable-space-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-unadjustable-and-unbreakable-space-_0028_005cSP_0029"></a>
+<a class="index-entry-id" id="index-_005cspace"></a>
+<p>Move right one word space.  (The input is a backslash followed by a
+space.)  This escape sequence can be thought of as a non-adjustable,
+unbreakable space.  Usually you want <code class="code">\~</code> instead; see
+<a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-thin-space-_0028_005c_007c_0029"></a>
+<a class="index-entry-id" id="index-space_002c-thin-_0028_005c_007c_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_007c-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\|</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_007c-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_007c"></a>
+<p>Move one-sixth <span class="dmn">em</span> to the right on typesetting output devices.  If
+a glyph named &lsquo;<samp class="samp">\|</samp>&rsquo; is defined in the current font, its width is
+used instead, even on terminal output devices.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-hair-space-_0028_005c_005e_0029"></a>
+<a class="index-entry-id" id="index-space_002c-hair-_0028_005c_005e_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\^</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005e"></a>
+<p>Move one-twelfth <span class="dmn">em</span> to the right on typesetting output devices.
+If a glyph named &lsquo;<samp class="samp">\^</samp>&rsquo; is defined in the current font, its width is
+used instead, even on terminal output devices.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c0-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\0</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c0-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c0"></a>
+<a class="index-entry-id" id="index-space_002c-width-of-a-digit-_0028numeral_0029-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-digit_002dwidth-space-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-figure-space-_0028_005c0_0029"></a>
+<a class="index-entry-id" id="index-numeral_002dwidth-space-_0028_005c0_0029"></a>
+<p>Move right by the width of a numeral in the current font.
+</p></dd></dl>
+
+<p>Horizontal motions are not discarded at the end of an output line as
+word spaces are.  See <a class="xref" href="Breaking.html">Breaking</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cw_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\w<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cw_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cw"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bst_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nst</code></strong><a class="copiable-link" href='#index-_005cn_005bst_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-st"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bsb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nsb</code></strong><a class="copiable-link" href='#index-_005cn_005bsb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-sb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005brst_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nrst</code></strong><a class="copiable-link" href='#index-_005cn_005brst_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rst"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005brsb_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nrsb</code></strong><a class="copiable-link" href='#index-_005cn_005brsb_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rsb"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bct_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nct</code></strong><a class="copiable-link" href='#index-_005cn_005bct_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ct"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bssc_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nssc</code></strong><a class="copiable-link" href='#index-_005cn_005bssc_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ssc"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005bskw_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nskw</code></strong><a class="copiable-link" href='#index-_005cn_005bskw_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-skw"></a>
+<a class="index-entry-id" id="index-width-escape-_0028_005cw_0029"></a>
+<p>Interpolate the width of <var class="var">anything</var> in basic units.  This escape
+sequence allows several properties of formatted output to be measured
+without writing it out.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">The length of the string 'abc' is \w'abc'u.
+    &rArr; The length of the string 'abc' is 72u.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-dummy-environment_002c-used-by-_005cw-escape-sequence"></a>
+<a class="index-entry-id" id="index-environment_002c-dummy_002c-used-by-_005cw-escape-sequence"></a>
+<p><var class="var">anything</var> is processed in a dummy environment: this means that
+font and type size changes, for example, may occur within it without
+affecting subsequent output.
+</p>
+<p>After each use, <code class="code">\w</code> sets several registers.
+</p>
+<a class="index-entry-id" id="index-CSTR-_002354-errata-5"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-sb-register"></a>
+<a class="index-entry-id" id="index-CSTR-_002354-erratum_002c-st-register"></a>
+<dl class="table">
+<dt><code class="code">st</code></dt>
+<dt><code class="code">sb</code></dt>
+<dd><p>The maximum vertical displacements of the text baseline above and below,
+respectively.  The sign convention is opposite that of relative vertical
+motions; that is, depth below the (original) baseline is negative.
+These registers are incorrectly documented in the <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> manual as &ldquo;the highest and lowest extent of the argument
+to <code class="code">\w</code> relative to the baseline&rdquo;.
+</p>
+</dd>
+<dt><code class="code">rst</code></dt>
+<dt><code class="code">rsb</code></dt>
+<dd><p>Like <code class="code">st</code> and <code class="code">sb</code>, but taking account of the heights and
+depths of glyphs.  In other words, these registers store the highest and
+lowest vertical positions attained by <var class="var">anything</var>, doing what
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> documented <code class="code">st</code> and <code class="code">sb</code> as doing.
+</p>
+</dd>
+<dt><code class="code">ct</code></dt>
+<dd><p>Characterizes the geometry of glyphs occurring in <var class="var">anything</var>.
+</p>
+<dl class="table">
+<dt>0</dt>
+<dd><p>only short glyphs, no descenders or tall glyphs
+</p>
+</dd>
+<dt>1</dt>
+<dd><p>at least one descender
+</p>
+</dd>
+<dt>2</dt>
+<dd><p>at least one tall glyph
+</p>
+</dd>
+<dt>3</dt>
+<dd><p>at least one each of a descender and a tall glyph
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">ssc</code></dt>
+<dd><p>The amount of horizontal space (possibly negative) that should be added
+to the last glyph before a subscript.
+</p>
+</dd>
+<dt><code class="code">skw</code></dt>
+<dd><p>How far to right of the center of the last glyph in the <code class="code">\w</code>
+argument, the center of an accent from a roman font should be placed
+over that glyph.
+</p></dd>
+</dl>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ckp"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k</code><span class="r"><i class="slanted">p</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ckp'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ck"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005ck_0028ps"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k(</code><span class="r"><i class="slanted">ps</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ck_0028ps'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005ck_005bposition_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\k</code><span class="r"><i class="slanted">position</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ck_005bposition_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-saving-horizontal-input-line-position-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-horizontal-input-line-position_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-input-line-position_002c-horizontal_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal-input-line_002c-saving-_0028_005ck_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-horizontal-position_002c-saving-_0028_005ck_0029"></a>
+<p>Store the current horizontal position in the <em class="emph">input</em> line in a
+register with the name <var class="var">position</var> (one-character name&nbsp;<var class="var">p</var>,
+two-character name <var class="var">ps</var>).  Use this, for example, to return to the
+beginning of a string for highlighting or other decoration.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bhp_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nhp</code></strong><a class="copiable-link" href='#index-_005cn_005bhp_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hp"></a>
+<a class="index-entry-id" id="index-horizontal-input-line-position-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-input-line_002c-horizontal-position_002c-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal_002c-in-input-line_002c-register-_0028hp_0029"></a>
+<a class="index-entry-id" id="index-line_002c-input_002c-horizontal-position_002c-register-_0028hp_0029"></a>
+<p>The current horizontal position at the input line.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002ek_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.k</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ek_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ek"></a>
+<a class="index-entry-id" id="index-horizontal-output-line-position-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-output-line_002c-horizontal-position_002c-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-position_002c-horizontal_002c-in-output-line_002c-register-_0028_002ek_0029"></a>
+<a class="index-entry-id" id="index-line_002c-output_002c-horizontal-position_002c-register-_0028_002ek_0029"></a>
+<p>A read-only register containing the current horizontal output position
+(relative to the current indentation).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005co_0027abc_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\o<code class="code">'</code></code><span class="r"><i class="slanted">abc&hellip;</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005co_0027abc_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005co"></a>
+<a class="index-entry-id" id="index-overstriking-glyphs-_0028_005co_0029"></a>
+<a class="index-entry-id" id="index-glyphs_002c-overstriking-_0028_005co_0029"></a>
+<p>Overstrike the glyphs of characters <var class="var">a</var>, <var class="var">b</var>, <var class="var">c</var>, &hellip;;
+the glyphs are centered, written, and the drawing position advanced by
+the widest of the glyphs.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005czc"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\z</code><span class="r"><i class="slanted">c</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005czc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cz"></a>
+<a class="index-entry-id" id="index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029"></a>
+<a class="index-entry-id" id="index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029"></a>
+<p>Format the character <var class="var">c</var> with zero width; that is, without advancing
+the drawing position.  Use <code class="code">\z</code> to overstrike glyphs aligned to
+their left edges, in contrast to <code class="code">\o</code>&rsquo;s centering.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cZ_0027anything_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Z<code class="code">'</code></code><span class="r"><i class="slanted">anything</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cZ_0027anything_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cZ"></a>
+<a class="index-entry-id" id="index-zero_002dwidth-printing-_0028_005cz_002c-_005cZ_0029-1"></a>
+<a class="index-entry-id" id="index-printing_002c-zero_002dwidth-_0028_005cz_002c-_005cZ_0029-1"></a>
+<p>Save the drawing position, format <var class="var">anything</var>, then restore it.  Tabs
+and leaders in the argument are ignored with an error diagnostic.
+</p>
+<p>We might implement a strike-through macro thus.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de ST
+.nr width \w'\\$1'
+\Z@\v'-.25m'\l'\\nwidthu'@\\$1
+..
+.
+This is
+.ST &quot;a test&quot;
+an actual emergency!
+</pre></div></div>
+</dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>, Previous: <a href="Writing-Macros.html">Writing Macros</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Paper-Format.html Added

@@ -0,0 +1,101 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Paper Format (The GNU Troff Manual)</title>
+
+<meta name="description" content="Paper Format (The GNU Troff Manual)">
+<meta name="keywords" content="Paper Format (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Invoking-groff.html" rel="up" title="Invoking groff">
+<link href="Invocation-Examples.html" rel="next" title="Invocation Examples">
+<link href="Font-Directories.html" rel="prev" title="Font Directories">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Paper-Format">
+<div class="nav-panel">
+<p>
+Next: <a href="Invocation-Examples.html" accesskey="n" rel="next">Invocation Examples</a>, Previous: <a href="Font-Directories.html" accesskey="p" rel="prev">Font Directories</a>, Up: <a href="Invoking-groff.html" accesskey="u" rel="up">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Paper-Format-1">2.5 Paper Format</h3>
+<a class="index-entry-id" id="index-paper-format"></a>
+<a class="index-entry-id" id="index-format_002c-paper"></a>
+<a class="index-entry-id" id="index-paper-size"></a>
+<a class="index-entry-id" id="index-size_002c-paper"></a>
+<a class="index-entry-id" id="index-landscape-page-orientation"></a>
+<a class="index-entry-id" id="index-orientation_002c-landscape"></a>
+<a class="index-entry-id" id="index-page-orientation_002c-landscape"></a>
+
+<p>In <code class="code">groff</code>, the page dimensions for the formatter GNU <code class="code">troff</code>
+and for output devices are handled separately.  See <a class="xref" href="Page-Layout.html">Page Layout</a>, for
+vertical manipulation of the page size, and See <a class="xref" href="Line-Layout.html">Line Layout</a>, for
+horizontal changes.
+<a class="index-entry-id" id="index-papersize_002etmac"></a>
+<a class="index-entry-id" id="index-troffrc-1"></a>
+The <samp class="file">papersize</samp> macro package, normally loaded by <samp class="file">troffrc</samp> at
+startup, provides an interface for configuring page dimensions by
+convenient names, like &lsquo;<samp class="samp">letter</samp>&rsquo; or &lsquo;<samp class="samp">a4</samp>&rsquo;; see
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite>.  The default used by the formatter depends on
+its build configuration, but is usually one of the foregoing, as
+geographically appropriate.
+</p>
+<p>It is up to each macro package to respect the page dimensions configured
+in this way.
+</p>
+<p>For each output device, the size of the output medium can be set in its
+<samp class="file">DESC</samp> file.  Most output drivers also recognize a command-line
+option <samp class="option">-p</samp> to override the default dimensions and an option
+<samp class="option">-l</samp> to use landscape orientation.  See <a class="xref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>, for
+a description of the <code class="code">papersize</code> keyword, which takes an argument
+of the same form as <samp class="option">-p</samp>.  The output driver&rsquo;s man page, such as
+<cite class="cite">grops<span class="r">(1)</span></cite>, may also be helpful.
+</p>
+<p><code class="code">groff</code> uses the command-line option <samp class="option">-P</samp> to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms &gt; foo.ps
+</pre></div></div>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Invocation-Examples.html">Invocation Examples</a>, Previous: <a href="Font-Directories.html">Font Directories</a>, Up: <a href="Invoking-groff.html">Invoking <code class="code">groff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Paragraphs-in-ms.html Added

@@ -0,0 +1,160 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Paragraphs in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Paragraphs in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Paragraphs in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Headings-in-ms.html" rel="next" title="Headings in ms">
+<link href="Typographical-symbols-in-ms.html" rel="prev" title="Typographical symbols in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Paragraphs-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="Headings-in-ms.html" accesskey="n" rel="next">Headings</a>, Previous: <a href="Typographical-symbols-in-ms.html" accesskey="p" rel="prev">Typographical symbols</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Paragraphs-2">4.6.5.3 Paragraphs</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-paragraph-handling"></a>
+
+<p>Paragraphing macros <em class="dfn">break</em>, or terminate, any pending output line
+so that a new paragraph can begin.  Several paragraph types are
+available, differing in how indentation applies to them: to left, right,
+or both margins; to the first output line of the paragraph, all output
+lines, or all but the first.  All paragraphing macro calls cause the
+insertion of vertical space in the amount stored in the <code class="code">PD</code>
+register, except at page or column breaks.  Alternatively, a blank input
+line breaks the output line and vertically spaces by one vee.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eLP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LP</code></strong><a class="copiable-link" href='#index-_002eLP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LP-_005bms_005d"></a>
+<p>Set a paragraph without any (additional) indentation.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PP</code></strong><a class="copiable-link" href='#index-_002ePP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PP-_005bms_005d"></a>
+<p>Set a paragraph with a first-line left indentation in the amount stored
+in the <code class="code">PI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eIP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.IP</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">marker</i></span> <span class="r"><i class="slanted">width</i></span></var><a class="copiable-link" href='#index-_002eIP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-IP-_005bms_005d"></a>
+<p>Set a paragraph with a left indentation.  The optional <var class="var">marker</var> is
+not indented and is empty by default.  It has several applications;
+see <a class="ref" href="Lists-in-ms.html">Lists</a>.  <var class="var">width</var> overrides the indentation amount
+stored in the <code class="code">PI</code> register; its default unit is &lsquo;<samp class="samp">n</samp>&rsquo;.  Once
+specified, <var class="var">width</var> applies to further <code class="code">IP</code> calls until
+specified again or a heading or different paragraphing macro is called.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eQP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QP</code></strong><a class="copiable-link" href='#index-_002eQP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QP-_005bms_005d"></a>
+<p>Set a paragraph indented from both left and right margins by the amount
+stored in the <code class="code">QI</code> register.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eQS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QS</code></strong><a class="copiable-link" href='#index-_002eQS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eQE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.QE</code></strong><a class="copiable-link" href='#index-_002eQE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QE-_005bms_005d"></a>
+<p>Begin (<code class="code">QS</code>) and end (<code class="code">QE</code>) a region where each paragraph is
+indented from both margins by the amount stored in the <code class="code">QI</code>
+register.  The text between <code class="code">QS</code> and <code class="code">QE</code> can be structured
+further by use of other paragraphing macros.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XP</code></strong><a class="copiable-link" href='#index-_002eXP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XP-_005bms_005d"></a>
+<p>Set an &ldquo;exdented&rdquo; paragraph&mdash;one with a left indentation in the
+amount stored in the <code class="code">PI</code> register on every line <em class="emph">except</em> the
+first (also known as a hanging indent).  This is a Berkeley extension.
+</p></dd></dl>
+
+<p>The following example illustrates the use of paragraphing macros.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 2
+Cases used in the 2001 study
+.LP
+Two software releases were considered for this report.
+.PP
+The first is commercial software;
+the second is free.
+.IP \bu
+Microsoft Word for Windows,
+starting with version 1.0 through the current version
+(Word 2000).
+.IP \bu
+GNU Emacs,
+from its first appearance as a standalone editor through
+the current version (v20).
+See Bloggs 2002 for details.
+.QP
+Franklin's Law applied to software:
+software expands to outgrow both RAM and disk space over
+time.
+.SH
+Bibliography
+.XP
+Bloggs, Joseph R.,
+.I &quot;Everyone's a Critic&quot; ,
+Underground Press, March 2002.
+A definitive work that answers all questions and
+criticisms about the quality and usability of free
+software.
+</pre></div>
+</td></tr></table>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Headings-in-ms.html">Headings</a>, Previous: <a href="Typographical-symbols-in-ms.html">Typographical symbols</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Paragraphs.html Added

@@ -0,0 +1,109 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Paragraphs (The GNU Troff Manual)</title>
+
+<meta name="description" content="Paragraphs (The GNU Troff Manual)">
+<meta name="keywords" content="Paragraphs (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Sections-and-Chapters.html" rel="next" title="Sections and Chapters">
+<link href="Common-Features.html" rel="prev" title="Common Features">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Paragraphs">
+<div class="nav-panel">
+<p>
+Next: <a href="Sections-and-Chapters.html" accesskey="n" rel="next">Sections and Chapters</a>, Previous: <a href="Common-Features.html" accesskey="p" rel="prev">Common Features</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Paragraphs-1">3.2.1 Paragraphs</h4>
+<a class="index-entry-id" id="index-paragraphs"></a>
+
+<p>Paragraphs can be separated and indented in various ways.  Some start
+with a blank line and have a first-line indentation, like most of the
+ones in this manual.  Block paragraphs omit the indentation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; Some  men  look  at constitutions with sanctimonious
+  &rArr; reverence,  and  deem  them  like  the  ark  of  the
+  &rArr; covenant, too sacred to be touched.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-tags_002c-paragraph"></a>
+<a class="index-entry-id" id="index-tagged-paragraphs"></a>
+<a class="index-entry-id" id="index-lists"></a>
+<p>We also frequently encounter <i class="slanted">tagged</i> paragraphs, which begin
+with a tag or label at the left margin and indent the remaining text.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; one  This  is the first paragraph.  Notice how the
+  &rArr;      first line of the resulting  paragraph  lines
+  &rArr;      up with the other lines in the paragraph.
+</pre></div></div>
+
+<p>If the tag is too wide for the indentation, the line is broken.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; longlabel
+  &rArr;      The  label does not align with the subsequent
+  &rArr;      lines, but they align with each other.
+</pre></div></div>
+
+<p>A variation of the tagged paragraph is the itemized or enumerated
+paragraph, which might use punctuation or a digit for a tag,
+respectively.  These are frequently used to construct lists.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; o    This  list  item  starts with a bullet.  When
+  &rArr;      producing output for a device using the ASCII
+  &rArr;      character set, an 'o' is formatted instead.
+</pre></div></div>
+
+<p>Often, use of the same macro without a tag continues such a discussion.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">  &rArr; -xyz  This option is recognized but ignored.
+  &rArr;
+  &rArr;       It had a security hole that we don't discuss.
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Sections-and-Chapters.html">Sections and Chapters</a>, Previous: <a href="Common-Features.html">Common Features</a>, Up: <a href="Common-Features.html">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Parameters.html Added

@@ -0,0 +1,195 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Parameters (The GNU Troff Manual)</title>
+
+<meta name="description" content="Parameters (The GNU Troff Manual)">
+<meta name="keywords" content="Parameters (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Writing-Macros.html" rel="up" title="Writing Macros">
+<link href="Copy-Mode.html" rel="next" title="Copy Mode">
+<link href="Writing-Macros.html" rel="prev" title="Writing Macros">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Parameters">
+<div class="nav-panel">
+<p>
+Next: <a href="Copy-Mode.html" accesskey="n" rel="next">Copy Mode</a>, Previous: <a href="Writing-Macros.html" accesskey="p" rel="prev">Writing Macros</a>, Up: <a href="Writing-Macros.html" accesskey="u" rel="up">Writing Macros</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Parameters-1">5.24.1 Parameters</h4>
+<a class="index-entry-id" id="index-parameters"></a>
+
+<p>Macro calls and string interpolations optionally accept a list of
+arguments; recall <a class="ref" href="Calling-Macros.html">Calling Macros</a>.  At the time such an
+interpolation takes place, these <em class="dfn">parameters</em> can be examined using
+a register and a variety of escape sequences starting with &lsquo;<samp class="samp">\$</samp>&rsquo;.
+All such escape sequences are interpreted even in copy mode, a fact we
+shall motivate and explain below (see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002e_0024_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.$</code></strong><a class="copiable-link" href='#index-_005cn_005b_002e_0024_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002e_0024"></a>
+<a class="index-entry-id" id="index-parameter-count-register-_0028_002e_0024_0029"></a>
+<p>The count of parameters available to a macro or string is kept in this
+read-only register.  The <code class="code">shift</code> request can change its value.
+</p></dd></dl>
+
+<p>Any individual parameter can be accessed by its position in the list of
+arguments to the macro call, numbered from left to right starting at 1,
+with one of the following escape sequences.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0024n"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024n'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_0028nn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$(</code><span class="r"><i class="slanted">nn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_0028nn'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_0024_005bnnn_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$</code><span class="r"><i class="slanted">nnn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_005bnnn_005d'> &para;</a></span></dt>
+<dd><p>Interpolate the <var class="var">n</var>th, <var class="var">nn</var>th, or <var class="var">nnn</var>th parameter.  The
+first form expects only a single digit (1&le;<var class="var">n</var>&le;9)), the
+second two digits (01&le;<var class="var">nn</var>&le;99)), and the third any
+positive integer <var class="var">nnn</var>.  Macros and strings accept an unlimited
+number of parameters.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eshift"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.shift</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n</i></span></var><a class="copiable-link" href='#index-_002eshift'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-shift"></a>
+<p>Shift the parameters <var class="var">n</var> places (1&nbsp;by default).  This is a
+&ldquo;left shift&rdquo;: what was parameter&nbsp;<var class="var">i</var> becomes parameter
+<em class="math"><var class="var">i</var>-<var class="var">n</var></em>.  The parameters formerly in positions 1
+to&nbsp;<var class="var">n</var> are no longer available.  Shifting by a non-positive
+amount performs no operation.  The register <code class="code">.$</code> is adjusted
+accordingly.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-copy-mode_002c-and-macro-parameters"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-macro-parameters"></a>
+<a class="index-entry-id" id="index-macro_002c-parameters-_0028_005c_0024_0029"></a>
+<a class="index-entry-id" id="index-parameters_002c-macro-_0028_005c_0024_0029"></a>
+<p>In practice, parameter interpolations are usually seen prefixed with an
+extra escape character.  This is because the <code class="code">\$</code> family of escape
+sequences is interpreted even in copy mode.<a class="footnote" id="DOCF100" href="groff.html_fot.html#FOOT100"><sup>100</sup></a>
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0024_002a-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$*</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_002a-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_002a"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_0040-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$@</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_0040-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_0040"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_0024_005e-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$^</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0024_005e-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0024_005e"></a>
+<p>In some cases it is convenient to interpolate all of the parameters at
+once (to pass them to a request, for instance).  The <code class="code">\$*</code> escape
+concatenates the parameters, separating them with spaces.  <code class="code">\$@</code>
+is similar, concatenating the parameters, surrounding each with double
+quotes and separating them with spaces.  If not in compatibility mode,
+the interpolation depth of double quotes is preserved (see <a class="pxref" href="Calling-Macros.html">Calling Macros</a>).  <code class="code">\$^</code> interpolates all parameters as if they were
+arguments to the <code class="code">ds</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+. tm $1='\\$1'
+. tm $2='\\$2'
+. tm $*='\\$*'
+. tm $@='\\$@'
+. tm $^='\\$^'
+..
+.foo &quot; This is a &quot;test&quot;
+    error&rarr; $1=' This is a '
+    error&rarr; $2='test&quot;'
+    error&rarr; $*=' This is a  test&quot;'
+    error&rarr; $@='&quot; This is a &quot; &quot;test&quot;&quot;'
+    error&rarr; $^='&quot; This is a &quot;test&quot;'
+</pre></div></div>
+
+<p><code class="code">\$*</code> is useful when writing a macro that doesn&rsquo;t need to
+distinguish its arguments, or even to not interpret them; examples
+include macros that produce diagnostic messages by wrapping the
+<code class="code">tm</code> or <code class="code">ab</code> requests.  Use <code class="code">\$@</code> when writing a macro
+that may need to shift its parameters and/or wrap a macro or request
+that finds the count significant.  If in doubt, prefer <code class="code">\$@</code> to
+<code class="code">\$*</code>.  An application of <code class="code">\$^</code> is seen in <samp class="file">trace.tmac</samp>,
+which redefines some requests and macros for debugging purposes.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_00240-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\$0</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_00240-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_00240"></a>
+<a class="index-entry-id" id="index-macro-name-register-_0028_005c_00240_0029"></a>
+<a class="index-entry-id" id="index-als-request_002c-and-_005c_00240"></a>
+<p>Interpolate the name by which the macro being interpreted was called.
+The <code class="code">als</code> request can cause a macro to have more than one name.
+Applying string interpolation to a macro does not change this name.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+.  tm \\$0
+..
+.als bar foo
+.
+.de aaa
+.  foo
+..
+.de bbb
+.  bar
+..
+.de ccc
+\\*foo\\
+..
+.de ddd
+\\*bar\\
+..
+.
+.aaa
+    error&rarr; foo
+.bbb
+    error&rarr; bar
+.ccc
+    error&rarr; ccc
+.ddd
+    error&rarr; ddd
+</pre></div></div>
+</dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Copy-Mode.html">Copy Mode</a>, Previous: <a href="Writing-Macros.html">Writing Macros</a>, Up: <a href="Writing-Macros.html">Writing Macros</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Postprocessor-Access.html Added

@@ -0,0 +1,144 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Postprocessor Access (The GNU Troff Manual)</title>
+
+<meta name="description" content="Postprocessor Access (The GNU Troff Manual)">
+<meta name="keywords" content="Postprocessor Access (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Miscellaneous.html" rel="next" title="Miscellaneous">
+<link href="I_002fO.html" rel="prev" title="I/O">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Postprocessor-Access">
+<div class="nav-panel">
+<p>
+Next: <a href="Miscellaneous.html" accesskey="n" rel="next">Miscellaneous</a>, Previous: <a href="I_002fO.html" accesskey="p" rel="prev">I/O</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Postprocessor-Access-1">5.34 Postprocessor Access</h3>
+<a class="index-entry-id" id="index-postprocessor-access"></a>
+<a class="index-entry-id" id="index-access-to-postprocessor"></a>
+
+<p>Two escape sequences and two requests enable documents to pass
+information directly to a postprocessor.  These are useful for
+exercising device-specific capabilities that the <code class="code">groff</code> language
+does not abstract or generalize; examples include the embedding of
+hyperlinks and image files.  Device-specific functions are documented in
+each output driver&rsquo;s man page, such as <cite class="cite">gropdf<span class="r">(1)</span></cite>,
+<cite class="cite">grops<span class="r">(1)</span></cite>, or <cite class="cite">grotty<span class="r">(1)</span></cite>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edevice"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.device</code></strong> <var class="def-var-arguments">xxx <span class="r">&hellip;</span></var><a class="copiable-link" href='#index-_002edevice'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-device"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cX_0027xxx-_2026_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\X<code class="code">'</code></code><span class="r"><i class="slanted">xxx <span class="r">&hellip;</span></i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cX_0027xxx-_2026_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cX"></a>
+<p>Embed all <var class="var">xxx</var> arguments into GNU <code class="code">troff</code> output as parameters
+to a device control command &lsquo;<samp class="samp">x&nbsp;X</samp>&rsquo;.  The meaning and
+interpretation of such parameters is determined by the output driver or
+other postprocessor.
+</p>
+<a class="index-entry-id" id="index-device-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-device-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-device-request"></a>
+<p>The <code class="code">device</code> request processes its arguments in copy mode
+(see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).  An initial neutral double quote in <var class="var">contents</var>
+is stripped to allow embedding of leading spaces.
+<a class="index-entry-id" id="index-_005c_0026_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_0029_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_0025_002c-in-_005cX"></a>
+<a class="index-entry-id" id="index-_005c_003a_002c-in-_005cX"></a>
+By contrast, within <code class="code">\X</code> arguments, the escape sequences <code class="code">\&amp;</code>,
+<code class="code">\)</code>, <code class="code">\%</code>, and <code class="code">\:</code> are ignored; <code class="code">\<kbd class="key">SP</kbd></code> and
+<code class="code">\~</code> are converted to single space characters; and <code class="code">\\</code> has
+its escape character stripped.  So that the basic Latin subset of the
+Unicode character set<a class="footnote" id="DOCF115" href="groff.html_fot.html#FOOT115"><sup>115</sup></a> can be reliably encoded in device control
+commands, seven special character escape sequences (&lsquo;<samp class="samp">\-</samp>&rsquo;,
+&lsquo;<samp class="samp">\aq</samp>&rsquo;, &lsquo;<samp class="samp">\dq</samp>&rsquo;, &lsquo;<samp class="samp">\ga</samp>&rsquo;, &lsquo;<samp class="samp">\ha</samp>&rsquo;, &lsquo;<samp class="samp">\rs</samp>&rsquo;,
+and &lsquo;<samp class="samp">\ti</samp>&rsquo;,) are mapped to basic Latin characters; see the
+<cite class="cite">groff_char<span class="r">(7)</span></cite> man page.  For this transformation, character
+translations and special character definitions are
+ignored.<a class="footnote" id="DOCF116" href="groff.html_fot.html#FOOT116"><sup>116</sup></a> The use of any
+other escape sequence in <code class="code">\X</code> parameters is normally an error.
+</p>
+<a class="index-entry-id" id="index-use_005fcharnames_005fin_005fspecial"></a>
+<a class="index-entry-id" id="index-DESC-file_002c-and-use_005fcharnames_005fin_005fspecial-keyword"></a>
+<a class="index-entry-id" id="index-_005cX_002c-and-special-characters"></a>
+<p>If the <code class="code">use_charnames_in_special</code> directive appears in the output
+device&rsquo;s <samp class="file">DESC</samp> file, the use of special character escape sequences
+is <em class="emph">not</em> an error; they are simply output verbatim (with the
+exception of the seven mapped to Unicode basic Latin characters,
+discussed above).  <code class="code">use_charnames_in_special</code> is currently employed
+only by <code class="code">grohtml</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edevicem"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.devicem</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002edevicem'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-devicem"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cYn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cYn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cY"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cY_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cY_0028nm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cY_005bname_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\Y</code><span class="r"><i class="slanted">name</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cY_005bname_005d'> &para;</a></span></dt>
+<dd><p>This is approximately equivalent to &lsquo;<samp class="samp">\X'\*<var class="var">name</var>'</samp>&rsquo;
+(one-character name&nbsp;<var class="var">n</var>, two-character name <var class="var">nm</var>).
+However, the contents of the string or macro <var class="var">name</var> are not
+interpreted; also it is permitted for <var class="var">name</var> to have been defined as
+a macro and thus contain newlines (it is not permitted for the argument
+to <code class="code">\X</code> to contain newlines).  The inclusion of newlines requires
+an extension to the <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output format, and
+confuses drivers that do not know about this extension (see <a class="pxref" href="Device-Control-Commands.html">Device Control Commands</a>).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etag"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tag</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002etag'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tag"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002etaga"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.taga</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002etaga'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-taga"></a>
+<p>Reserved for internal use.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Miscellaneous.html">Miscellaneous</a>, Previous: <a href="I_002fO.html">I/O</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Predefined-Text.html Added

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Predefined Text (The GNU Troff Manual)</title>
+
+<meta name="description" content="Predefined Text (The GNU Troff Manual)">
+<meta name="keywords" content="Predefined Text (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Preprocessor-Support.html" rel="next" title="Preprocessor Support">
+<link href="Font-and-Size-Changes.html" rel="prev" title="Font and Size Changes">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Predefined-Text">
+<div class="nav-panel">
+<p>
+Next: <a href="Preprocessor-Support.html" accesskey="n" rel="next">Preprocessor Support</a>, Previous: <a href="Font-and-Size-Changes.html" accesskey="p" rel="prev">Font and Size Changes</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Predefined-Text-1">3.2.12 Predefined Text</h4>
+
+<p>Most macro packages supply predefined strings to set prepared text like
+the date, or to perform operations like super- and subscripting.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Preprocessor-Intro.html Added

@@ -0,0 +1,78 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Preprocessor Intro (The GNU Troff Manual)</title>
+
+<meta name="description" content="Preprocessor Intro (The GNU Troff Manual)">
+<meta name="keywords" content="Preprocessor Intro (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Output-Device-Intro.html" rel="next" title="Output Device Intro">
+<link href="Macro-Package-Intro.html" rel="prev" title="Macro Package Intro">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Preprocessor-Intro">
+<div class="nav-panel">
+<p>
+Next: <a href="Output-Device-Intro.html" accesskey="n" rel="next">Output Devices</a>, Previous: <a href="Macro-Package-Intro.html" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Preprocessors">1.5 Preprocessors</h3>
+<a class="index-entry-id" id="index-preprocessors"></a>
+
+<p>An alternative approach to complexity management, particularly when
+constructing tables, setting mathematics, or drawing diagrams, lies in
+preprocessing.  A <em class="dfn">preprocessor</em> employs a domian-specific language
+to ease the generation of tables, equations, and so forth in terms that
+are convenient for human entry.  Each preprocessor reads a document and
+translates the parts of it that apply to it into GNU <code class="code">troff</code> input.
+Command-line options to <code class="command">groff</code> tell it which preprocessors to
+use.
+</p>
+<p><code class="code">groff</code> provides preprocessors for laying out tables
+(<code class="command">gtbl</code>), typesetting equations (<code class="command">geqn</code>), drawing
+diagrams (<code class="command">gpic</code> and <code class="command">ggrn</code>), inserting bibliographic
+references (<code class="command">grefer</code>), and drawing chemical structures
+(<code class="command">gchem</code>).  An associated program that is useful when dealing
+with preprocessors is <code class="command">gsoelim</code>.<a class="footnote" id="DOCF1" href="groff.html_fot.html#FOOT1"><sup>1</sup></a>
+</p>
+<p><code class="code">groff</code> also supports <code class="code">grap</code>, a preprocessor for drawing
+graphs.  A free implementation of it can be obtained separately.
+</p>
+<p>Unique to <code class="code">groff</code> is the <code class="code">preconv</code> preprocessor that enables
+<code class="code">groff</code> to handle documents in a variety of input encodings.
+</p>
+<p>Other preprocessors exist, but no free implementations
+are known.  An example is <code class="command">ideal</code>, which draws diagrams using a
+mathematical constraint language.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Preprocessor-Support.html Added

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Preprocessor Support (The GNU Troff Manual)</title>
+
+<meta name="description" content="Preprocessor Support (The GNU Troff Manual)">
+<meta name="keywords" content="Preprocessor Support (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Configuration-and-Customization.html" rel="next" title="Configuration and Customization">
+<link href="Predefined-Text.html" rel="prev" title="Predefined Text">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Preprocessor-Support">
+<div class="nav-panel">
+<p>
+Next: <a href="Configuration-and-Customization.html" accesskey="n" rel="next">Configuration and Customization</a>, Previous: <a href="Predefined-Text.html" accesskey="p" rel="prev">Predefined Text</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Preprocessor-Support-1">3.2.13 Preprocessor Support</h4>
+
+<p>All macro packages provide support for various preprocessors and may
+extend their functionality by defining macros to set their contents in
+displays.  Examples include <code class="code">TS</code> and <code class="code">TE</code> for <code class="command">gtbl</code>,
+<code class="code">EQ</code> and <code class="code">EN</code> for <code class="command">geqn</code>, and <code class="code">PS</code> and <code class="code">PE</code>
+for <code class="command">gpic</code>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Program-and-File-Index.html Added

@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Program and File Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Program and File Index (The GNU Troff Manual)">
+<meta name="keywords" content="Program and File Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Concept-Index.html" rel="next" title="Concept Index">
+<link href="File-Keyword-Index.html" rel="prev" title="File Keyword Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Program-and-File-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Concept-Index.html" accesskey="n" rel="next">Concept Index</a>, Previous: <a href="File-Keyword-Index.html" accesskey="p" rel="prev">File Keyword Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Program-and-File-Index-1">Appendix I Program and File Index</h2>
+
+<div class="printindex pg-printindex">
+<table class="pg-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="pg-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="man.html#index-an_002etmac"><code>an.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="man.html">man</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-changebar"><code>changebar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-composite_002etmac"><code>composite.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-cp1047_002etmac"><code>cp1047.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-cs_002etmac"><code>cs.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-de_002etmac"><code>de.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-DESC"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-DESC-1"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-DESC-2"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-DESC-3"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-DESC-4"><code>DESC</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-diffmk"><code>diffmk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-ec_002etmac"><code>ec.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-en_002etmac"><code>en.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-eqn"><code>eqn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-fr_002etmac"><code>fr.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-freeeuro_002epfa"><code>freeeuro.pfa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-gchem"><code>gchem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-gdiffmk"><code>gdiffmk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-geqn"><code>geqn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-ggrn"><code>ggrn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-gpic"><code>gpic</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-grap"><code>grap</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-grefer"><code>grefer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-groff"><code>groff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-gsoelim"><code>gsoelim</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-gtbl"><code>gtbl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-gtroff"><code>gtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-it_002etmac"><code>it.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-J">J</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-ja_002etmac"><code>ja.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-latin1_002etmac"><code>latin1.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-latin2_002etmac"><code>latin2.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-latin5_002etmac"><code>latin5.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Encodings.html#index-latin9_002etmac"><code>latin9.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Encodings.html">Input Encodings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Indexing.html#index-makeindex"><code>makeindex</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Indexing.html">Indexing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-man_002elocal"><code>man.local</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="man.html#index-man_002etmac"><code>man.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="man.html">man</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Optional-man-extensions.html#index-man_002eultrix"><code>man.ultrix</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Optional-man-extensions.html">Optional man extensions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-nrchbar"><code>nrchbar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-papersize_002etmac"><code>papersize.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-perl"><code>perl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-pic"><code>pic</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-post_002dgrohtml"><code>post-grohtml</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-pre_002dgrohtml"><code>pre-grohtml</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-preconv"><code>preconv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-refer"><code>refer</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-soelim"><code>soelim</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-sv_002etmac"><code>sv.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Insertions.html#index-tbl"><code>tbl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Insertions.html">ms Insertions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-trace_002etmac"><code>trace.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-troffrc"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Paper-Format.html#index-troffrc-1"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Paper-Format.html">Paper Format</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-troffrc-2"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-troffrc-3"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-troffrc-4"><code>troffrc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Groff-Options.html#index-troffrc_002dend"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Groff-Options.html">Groff Options</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-troffrc_002dend-1"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-troffrc_002dend-2"><code>troffrc-end</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-tty_002etmac"><code>tty.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-tty_002etmac-1"><code>tty.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Operators-in-Conditionals.html#index-vtroff"><code>vtroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Operators-in-Conditionals.html">Operators in Conditionals</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Program-and-File-Index_pg_letter-Z">Z</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-zh_002etmac"><code>zh.tmac</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="pg-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-J"><b>J</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Program-and-File-Index_pg_letter-Z"><b>Z</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Concept-Index.html">Concept Index</a>, Previous: <a href="File-Keyword-Index.html">File Keyword Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Punning-Names.html Added

@@ -0,0 +1,190 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Punning Names (The GNU Troff Manual)</title>
+
+<meta name="description" content="Punning Names (The GNU Troff Manual)">
+<meta name="keywords" content="Punning Names (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Environments.html" rel="next" title="Environments">
+<link href="Diversions.html" rel="prev" title="Diversions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Punning-Names">
+<div class="nav-panel">
+<p>
+Next: <a href="Environments.html" accesskey="n" rel="next">Environments</a>, Previous: <a href="Diversions.html" accesskey="p" rel="prev">Diversions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Punning-Names-1">5.30 Punning Names</h3>
+<a class="index-entry-id" id="index-diversions-1"></a>
+
+<p>Macros, strings, and diversions share a name space; recall
+<a class="ref" href="Identifiers.html">Identifiers</a>.  Internally, the same mechanism is used to store
+them.  You can thus call a macro with string interpolation syntax and
+vice versa.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de subject
+Typesetting
+..
+.de predicate
+rewards attention to detail
+..
+\*subject \*predicate.
+Truly.
+    &rArr; Typesetting
+    &rArr;  rewards attention to detail Truly.
+</pre></div></div>
+
+<p>What went wrong?  Strings don&rsquo;t contain newlines, but macros do.  String
+interpolation placed a newline at the end of &lsquo;<samp class="samp">\*subject</samp>&rsquo;, and the
+next thing on the input was a space.  Then when &lsquo;<samp class="samp">\*predicate</samp>&rsquo; was
+interpolated, it was followed by the empty request &lsquo;<samp class="samp">.</samp>&rsquo; on a line by
+itself.  If we want to use macros as strings, we must take interpolation
+behavior into account.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de subject
+Typesetting\\
+..
+.de predicate
+rewards attention to detail\\
+..
+\*subject \*predicate.
+Truly.
+    &rArr; Typesetting rewards attention to detail.  Truly.
+</pre></div></div>
+
+<p>By ending each text line of the macros with an escaped
+<code class="code">\<kbd class="key">RET</kbd></code>, we get the desired effect (see <a class="pxref" href="Line-Continuation.html">Line Continuation</a>).<a class="footnote" id="DOCF114" href="groff.html_fot.html#FOOT114"><sup>114</sup></a>
+What would have happened if we had used only one backslash at a time
+instead?
+</p>
+<p>Interpolating a string does not hide existing macro arguments.  We can
+also place the escaped newline outside the string interpolation instead
+of within the string definition.  Thus, in a macro, a more efficient way
+of doing
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.xx \\$@
+</pre></div></div>
+
+<p>is
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\\*xx\\
+</pre></div></div>
+
+<p>The latter calling syntax doesn&rsquo;t change the value of <code class="code">\$0</code>, which
+is then inherited from the calling macro (see <a class="pxref" href="Parameters.html">Parameters</a>).
+</p>
+<p>Diversions can be also called with string syntax.  It is sometimes
+convenient to copy one-line diversions to a string.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xx
+the
+.ft I
+interpolation system
+.ft
+.br
+.di
+.ds yy This is a test of \*(xx\c
+\*(yy.
+    &rArr; This is a test of the <i class="i">interpolation system</i>.
+</pre></div></div>
+
+<p>As the previous example shows, it is possible to store formatted output
+in strings.  The <code class="code">\c</code> escape sequence prevents the subsequent
+newline from being interpreted as a break (again,
+see <a class="pxref" href="Line-Continuation.html">Line Continuation</a>).
+</p>
+<p>Copying multi-output line diversions produces unexpected results.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.di xxx
+a funny
+.br
+test
+.br
+.di
+.ds yyy This is \*xxx\c
+\*yyy.
+    &rArr; test This is a funny.
+</pre></div></div>
+
+<p>Usually, it is not predictable whether a diversion contains one or more
+output lines, so this mechanism should be avoided.  With <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code>, this was the only solution to strip off a final newline
+from a diversion.  Another disadvantage is that the spaces in the copied
+string are already formatted, preventing their adjustment.  This can
+cause ugly results.
+</p>
+<a class="index-entry-id" id="index-stripping-final-newline-in-diversions"></a>
+<a class="index-entry-id" id="index-diversion_002c-stripping-final-newline"></a>
+<a class="index-entry-id" id="index-final-newline_002c-stripping-in-diversions"></a>
+<a class="index-entry-id" id="index-newline_002c-final_002c-stripping-in-diversions"></a>
+<a class="index-entry-id" id="index-horizontal-space_002c-unformatting"></a>
+<a class="index-entry-id" id="index-space_002c-horizontal_002c-unformatting"></a>
+<a class="index-entry-id" id="index-unformatting-horizontal-space"></a>
+<p>A clean solution to this problem is available in GNU <code class="code">troff</code>, using
+the requests <code class="code">chop</code> to remove the final newline of a diversion, and
+<code class="code">unformat</code> to make the horizontal spaces adjustable again.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.box xxx
+a funny
+.br
+test
+.br
+.box
+.chop xxx
+.unformat xxx
+This is \*xxx.
+    &rArr; This is a funny test.
+</pre></div></div>
+
+<p>See <a class="xref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Environments.html">Environments</a>, Previous: <a href="Diversions.html">Diversions</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Register-Index.html Added

@@ -0,0 +1,349 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Register Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Register Index (The GNU Troff Manual)">
+<meta name="keywords" content="Register Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Macro-Index.html" rel="next" title="Macro Index">
+<link href="Operator-Index.html" rel="prev" title="Operator Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Register-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Index.html" accesskey="n" rel="next">Macro Index</a>, Previous: <a href="Operator-Index.html" accesskey="p" rel="prev">Operator Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Register-Index-1">Appendix E Register Index</h2>
+
+<p>The macro package or program a specific register belongs to is appended
+in brackets.
+</p>
+<p>A register name&nbsp;<code class="code">x</code> consisting of exactly one character can be
+accessed as &lsquo;<samp class="samp">\nx</samp>&rsquo;.  A register name <code class="code">xx</code> consisting of exactly
+two characters can be accessed as &lsquo;<samp class="samp">\n(xx</samp>&rsquo;.  Register names
+<code class="code">xxx</code> of any length can be accessed as &lsquo;<samp class="samp">\nxxx</samp>&rsquo;.
+</p>
+<div class="printindex vr-printindex">
+<table class="vr-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Register-Index_vr_symbol-1"><b>$</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-3"><b>.</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Y"><b>Y</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="vr-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-1">$</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_0024_0024"><code>$$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-2">%</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-_0025-1"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-_0025-2"><code>%</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_symbol-3">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-_002e_0024"><code>.$</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eA"><code>.A</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-_002ea"><code>.a</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-_002eb"><code>.b</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-_002ebr-1"><code>.br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002ec"><code>.c</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_002eC"><code>.C</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002ecdp"><code>.cdp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002ece-1"><code>.ce</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002echt"><code>.cht</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-_002ecolor-1"><code>.color</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-_002ecp-1"><code>.cp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002ecsk"><code>.csk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_002ed"><code>.d</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002eev-1"><code>.ev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eF"><code>.F</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-_002ef"><code>.f</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-_002efam-1"><code>.fam</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-_002efn"><code>.fn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-_002efp-1"><code>.fp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eg"><code>.g</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-_002eH"><code>.H</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_002eh"><code>.h</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-_002eheight"><code>.height</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehla-1"><code>.hla</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehlc"><code>.hlc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehlm-1"><code>.hlm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehy-1"><code>.hy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehym-1"><code>.hym</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-_002ehys-1"><code>.hys</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-_002ei"><code>.i</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-_002ein-3"><code>.in</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Continuation.html#index-_002eint"><code>.int</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Continuation.html">Line Continuation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002ej"><code>.j</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-_002ek"><code>.k</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-_002ekern-1"><code>.kern</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-_002eL"><code>.L</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-_002el"><code>.l</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-_002elg-1"><code>.lg</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_002elinetabs-1"><code>.linetabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-_002ell-3"><code>.ll</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-_002elt-3"><code>.lt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-_002em"><code>.m</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-_002eM"><code>.M</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002en"><code>.n</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-_002ene-1"><code>.ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-_002enm-1"><code>.nm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-_002enn-1"><code>.nn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-_002ens-1"><code>.ns</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-_002eo"><code>.o</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-_002eO"><code>.O</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eP"><code>.P</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-_002ep"><code>.p</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-_002epe"><code>.pe</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-_002epn-3"><code>.pn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_002eps-3"><code>.ps</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_002epsr"><code>.psr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-_002epvs-3"><code>.pvs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eR-2"><code>.R</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002erj-1"><code>.rj</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-_002es"><code>.s</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-_002eslant"><code>.slant</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Fractional-Type-Sizes.html#index-_002esr"><code>.sr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Fractional-Type-Sizes.html">Using Fractional Type Sizes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002ess-1"><code>.ss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002esss"><code>.sss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-_002esty-1"><code>.sty</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eT-2"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-_002et"><code>.t</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-_002etabs"><code>.tabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-_002etrunc"><code>.trunc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eU"><code>.U</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-_002eu"><code>.u</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Motion-Quanta.html#index-_002eV"><code>.V</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Motion-Quanta.html">Motion Quanta</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-_002ev"><code>.v</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-_002evpt-1"><code>.vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-_002ew"><code>.w</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-_002ewarn-1"><code>.warn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002ex"><code>.x</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002ey"><code>.y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-_002eY"><code>.Y</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-_002ez"><code>.z</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-_002ezoom"><code>.zoom</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-c_002e"><code>c.</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-ct"><code>ct</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-DD-_005bms_005d"><code>DD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-DI-_005bms_005d"><code>DI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-dl"><code>dl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-dn"><code>dn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-dw"><code>dw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-dy"><code>dy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FF-_005bms_005d"><code>FF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FI-_005bms_005d"><code>FI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FM-_005bms_005d"><code>FM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FPD-_005bms_005d"><code>FPD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FPS-_005bms_005d"><code>FPS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FVS-_005bms_005d"><code>FVS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-GROWPS-_005bms_005d"><code>GROWPS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Differences-from-AT_0026T-ms.html#index-GS-_005bms_005d"><code>GS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Differences-from-AT_0026T-ms.html">Differences from AT&amp;T ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-HM-_005bms_005d"><code>HM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-HORPHANS-_005bms_005d"><code>HORPHANS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-hours"><code>hours</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-hp"><code>hp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-HY-_005bms_005d"><code>HY <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-LL-_005bms_005d"><code>LL <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-llx"><code>llx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-lly"><code>lly</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-ln"><code>ln</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-lsn"><code>lsn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-lss"><code>lss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-LT-_005bms_005d"><code>LT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-MINGW-_005bms_005d"><code>MINGW <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-minutes"><code>minutes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-mo"><code>mo</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-nl"><code>nl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-opmaxx"><code>opmaxx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-opmaxy"><code>opmaxy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-opminx"><code>opminx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Suppressing-Output.html#index-opminy"><code>opminy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Suppressing-Output.html">Suppressing Output</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PD-_005bms_005d"><code>PD <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PI-_005bms_005d"><code>PI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PO-_005bms_005d"><code>PO <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PORPHANS-_005bms_005d"><code>PORPHANS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PS-_005bms_005d-1"><code>PS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-PSINCR-_005bms_005d"><code>PSINCR <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-QI-_005bms_005d"><code>QI <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-rsb"><code>rsb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-rst"><code>rst</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-sb"><code>sb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-seconds"><code>seconds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-skw"><code>skw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-slimit"><code>slimit</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-ssc"><code>ssc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-st"><code>st</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-systat"><code>systat</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-TC_002dMARGIN-_005bms_005d"><code>TC-MARGIN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-urx"><code>urx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-ury"><code>ury</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-VS-_005bms_005d"><code>VS <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Register-Index_vr_letter-Y">Y</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-year"><code>year</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Built_002din-Registers.html#index-yr"><code>yr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Built_002din-Registers.html">Built-in Registers</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="vr-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Register-Index_vr_symbol-1"><b>$</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-2"><b>%</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_symbol-3"><b>.</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Register-Index_vr_letter-Y"><b>Y</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Index.html">Macro Index</a>, Previous: <a href="Operator-Index.html">Operator Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Registers.html Added

@@ -0,0 +1,65 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Registers (The GNU Troff Manual)</title>
+
+<meta name="description" content="Registers (The GNU Troff Manual)">
+<meta name="keywords" content="Registers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Manipulating-Filling-and-Adjustment.html" rel="next" title="Manipulating Filling and Adjustment">
+<link href="Formatter-Instructions.html" rel="prev" title="Formatter Instructions">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Registers">
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Filling-and-Adjustment.html" accesskey="n" rel="next">Manipulating Filling and Adjustment</a>, Previous: <a href="Formatter-Instructions.html" accesskey="p" rel="prev">Formatter Instructions</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Registers-1">5.8 Registers</h3>
+<a class="index-entry-id" id="index-registers"></a>
+
+<p>In the <code class="code">roff</code> language, numbers can be stored in <em class="dfn">registers</em>.
+Many built-in registers exist, supplying anything from the date to
+details of formatting parameters.  You can also define your own.
+See <a class="xref" href="Identifiers.html">Identifiers</a>, for information on constructing a valid name for a
+register.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Setting-Registers.html" accesskey="1">Setting Registers</a></li>
+<li><a href="Interpolating-Registers.html" accesskey="2">Interpolating Registers</a></li>
+<li><a href="Auto_002dincrement.html" accesskey="3">Auto-increment</a></li>
+<li><a href="Assigning-Register-Formats.html" accesskey="4">Assigning Register Formats</a></li>
+<li><a href="Built_002din-Registers.html" accesskey="5">Built-in Registers</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Request-Index.html Added

@@ -0,0 +1,394 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Request Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="Request Index (The GNU Troff Manual)">
+<meta name="keywords" content="Request Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="#Request-Index" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Escape-Sequence-Index.html" rel="next" title="Escape Sequence Index">
+<link href="Copying-This-Manual.html" rel="prev" title="Copying This Manual">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="Request-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="Escape-Sequence-Index.html" accesskey="n" rel="next">Escape Sequence Index</a>, Previous: <a href="Copying-This-Manual.html" accesskey="p" rel="prev">Copying This Manual</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="Request-Index-1">Appendix B Request Index</h2>
+
+<p>Request names appear without a leading control character; the defaults
+are <code class="code">.</code> for the regular control character and <code class="code">'</code> for the
+no-break control character.
+</p>
+<div class="printindex rq-printindex">
+<table class="rq-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Request-Index_rq_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-W"><b>W</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="rq-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-ab"><code>ab</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ad"><code>ad</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Assigning-Register-Formats.html#index-af"><code>af</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Assigning-Register-Formats.html">Assigning Register Formats</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-aln"><code>aln</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-als"><code>als</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-am"><code>am</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-am1"><code>am1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-ami"><code>ami</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-ami1"><code>ami1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-as"><code>as</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-as1"><code>as1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-asciify"><code>asciify</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-B">B</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-backtrace"><code>backtrace</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-bd"><code>bd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Blank-Line-Traps.html#index-blm"><code>blm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Blank-Line-Traps.html">Blank Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-box"><code>box</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-boxa"><code>boxa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-bp"><code>bp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-br"><code>br</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-break-2"><code>break</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-brp"><code>brp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-c2"><code>c2</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Control-Characters.html#index-cc"><code>cc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Control-Characters.html">Control Characters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ce"><code>ce</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-cf"><code>cf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-cflags"><code>cflags</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-ch"><code>ch</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-char"><code>char</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-chop"><code>chop</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Classes.html#index-class"><code>class</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Classes.html">Character Classes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-close"><code>close</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-color"><code>color</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-composite"><code>composite</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-continue"><code>continue</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-cp"><code>cp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-cs"><code>cs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-cu"><code>cu</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-da"><code>da</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-de"><code>de</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-de1"><code>de1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-defcolor"><code>defcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-dei"><code>dei</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-dei1"><code>dei1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-device"><code>device</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-devicem"><code>devicem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-di"><code>di</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Compatibility-Mode.html#index-do"><code>do</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Compatibility-Mode.html">Compatibility Mode</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-ds"><code>ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-ds-1"><code>ds</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-ds1"><code>ds1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversion-Traps.html#index-dt"><code>dt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversion-Traps.html">Diversion Traps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-E">E</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-ec"><code>ec</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-ecr"><code>ecr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-ecs"><code>ecs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002delse.html#index-el"><code>el</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002delse.html">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="End_002dof_002dinput-Traps.html#index-em"><code>em</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="End_002dof_002dinput-Traps.html">End-of-input Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Escape-Sequences.html#index-eo"><code>eo</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Escape-Sequences.html">Using Escape Sequences</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-ev"><code>ev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Environments.html#index-evc"><code>evc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Environments.html">Environments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-ex"><code>ex</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-fam"><code>fam</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Fields.html#index-fc"><code>fc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Fields.html">Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fchar"><code>fchar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-fcolor"><code>fcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-fi"><code>fi</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-fl"><code>fl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Positions.html#index-fp"><code>fp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Positions.html">Font Positions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-fschar"><code>fschar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-fspecial"><code>fspecial</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-ft"><code>ft</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-ftr"><code>ftr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Selecting-Fonts.html#index-fzoom"><code>fzoom</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Selecting-Fonts.html">Selecting Fonts</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-G">G</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Colors.html#index-gcolor"><code>gcolor</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Colors.html">Colors</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-H">H</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hc"><code>hc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hcode"><code>hcode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hla"><code>hla</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hlm"><code>hlm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hpf"><code>hpf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hpfa"><code>hpfa</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hpfcode"><code>hpfcode</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hw"><code>hw</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hy"><code>hy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hym"><code>hym</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-hys"><code>hys</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-I">I</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002delse.html#index-ie"><code>ie</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002delse.html">if-else</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002dthen.html#index-if"><code>if</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002dthen.html">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Comments.html#index-ig"><code>ig</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Comments.html">Comments</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-in-1"><code>in</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-it"><code>it</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Input-Line-Traps.html#index-itc"><code>itc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Input-Line-Traps.html">Input Line Traps</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-K">K</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-kern"><code>kern</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leaders.html#index-lc"><code>lc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leaders.html">Leaders</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-length"><code>length</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-lf"><code>lf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-lg"><code>lg</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-linetabs"><code>linetabs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-ll-1"><code>ll</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-ls"><code>ls</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Leading-Space-Traps.html#index-lsm"><code>lsm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Leading-Space-Traps.html">Leading Space Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-lt"><code>lt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-mc"><code>mc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-mk"><code>mk</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-mso"><code>mso</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-msoquiet"><code>msoquiet</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-N">N</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-na"><code>na</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-ne"><code>ne</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-nf"><code>nf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-nh"><code>nh</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-nm"><code>nm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-nn"><code>nn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="if_002dthen.html#index-nop"><code>nop</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="if_002dthen.html">if-then</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-nr"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-nr-1"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-nr-2"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Auto_002dincrement.html#index-nr-3"><code>nr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Auto_002dincrement.html">Auto-increment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-nroff"><code>nroff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-ns"><code>ns</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-nx"><code>nx</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-open"><code>open</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-opena"><code>opena</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-os"><code>os</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-output"><code>output</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-P">P</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-pc"><code>pc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-pev"><code>pev</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-pi"><code>pi</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-pl"><code>pl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-pm"><code>pm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-pn"><code>pn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-pnr"><code>pnr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-po-1"><code>po</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-ps"><code>ps</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Miscellaneous.html#index-psbb"><code>psbb</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Miscellaneous.html">Miscellaneous</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-pso"><code>pso</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-ptr"><code>ptr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-pvs"><code>pvs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-rchar"><code>rchar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-rd"><code>rd</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Writing-Macros.html#index-return"><code>return</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Writing-Macros.html">Writing Macros</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-rfschar"><code>rfschar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-rj"><code>rj</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-rm"><code>rm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-rn"><code>rn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-rnn"><code>rnn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Setting-Registers.html#index-rr"><code>rr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Setting-Registers.html">Setting Registers</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-rs"><code>rs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Motions.html#index-rt"><code>rt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Motions.html">Page Motions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Using-Symbols.html#index-schar"><code>schar</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Using-Symbols.html">Using Symbols</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Hyphenation.html#index-shc"><code>shc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Hyphenation.html">Manipulating Hyphenation</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Parameters.html#index-shift"><code>shift</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Parameters.html">Parameters</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Type-Size.html#index-sizes-1"><code>sizes</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Type-Size.html">Changing the Type Size</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-so"><code>so</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-soquiet"><code>soquiet</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Spacing.html#index-sp"><code>sp</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Spacing.html">Manipulating Spacing</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Special-Fonts.html#index-special-2"><code>special</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Special-Fonts.html">Special Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-spreadwarn"><code>spreadwarn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Manipulating-Filling-and-Adjustment.html#index-ss"><code>ss</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-stringdown"><code>stringdown</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-stringup"><code>stringup</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Font-Families.html#index-sty"><code>sty</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Font-Families.html">Font Families</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-substring"><code>substring</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Control.html#index-sv"><code>sv</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Control.html">Page Control</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-sy"><code>sy</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-ta"><code>ta</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-tag"><code>tag</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Postprocessor-Access.html#index-taga"><code>taga</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Postprocessor-Access.html">Postprocessor Access</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Tabs-and-Fields.html#index-tc"><code>tc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Tabs-and-Fields.html">Tabs and Fields</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Line-Layout.html#index-ti"><code>ti</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Line-Layout.html">Line Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Ligatures-and-Kerning.html#index-tkf"><code>tkf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Ligatures-and-Kerning.html">Ligatures and Kerning</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Layout.html#index-tl"><code>tl</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Layout.html">Page Layout</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-tm"><code>tm</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-tm1"><code>tm1</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-tmc"><code>tmc</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-tr"><code>tr</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-trf"><code>trf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-trin"><code>trin</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Character-Translations.html#index-trnt"><code>trnt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Character-Translations.html">Character Translations</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="troff-and-nroff-Modes.html#index-troff"><code>troff</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="troff-and-nroff-Modes.html"><code class="code">troff</code> and <code class="code">nroff</code> Modes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-uf"><code>uf</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Artificial-Fonts.html#index-ul"><code>ul</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Artificial-Fonts.html">Artificial Fonts</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Diversions.html#index-unformat"><code>unformat</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Diversions.html">Diversions</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Vertical-Position-Traps.html#index-vpt"><code>vpt</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Vertical-Position-Traps.html">Vertical Position Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Changing-the-Vertical-Spacing.html#index-vs"><code>vs</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Changing-the-Vertical-Spacing.html">Changing the Vertical Spacing</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="Request-Index_rq_letter-W">W</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-warn"><code>warn</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Debugging.html#index-warnscale"><code>warnscale</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Debugging.html">Debugging</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Page-Location-Traps.html#index-wh"><code>wh</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Page-Location-Traps.html">Page Location Traps</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="while.html#index-while-1"><code>while</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="while.html">while</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-write"><code>write</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-writec"><code>writec</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="I_002fO.html#index-writem"><code>writem</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="I_002fO.html">I/O</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="rq-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#Request-Index_rq_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-B"><b>B</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-E"><b>E</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-G"><b>G</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-H"><b>H</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-I"><b>I</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-K"><b>K</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-N"><b>N</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-P"><b>P</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-V"><b>V</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#Request-Index_rq_letter-W"><b>W</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Escape-Sequence-Index.html">Escape Sequence Index</a>, Previous: <a href="Copying-This-Manual.html">Copying This Manual</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="#Request-Index" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Requests-and-Macros.html Added

@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Requests and Macros (The GNU Troff Manual)</title>
+
+<meta name="description" content="Requests and Macros (The GNU Troff Manual)">
+<meta name="keywords" content="Requests and Macros (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Macro-Packages.html" rel="next" title="Macro Packages">
+<link href="Tabs-and-Leaders.html" rel="prev" title="Tabs and Leaders">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Requests-and-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Packages.html" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="Tabs-and-Leaders.html" accesskey="p" rel="prev">Tabs and Leaders</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Requests-and-Macros-1">5.1.7 Requests and Macros</h4>
+
+<p>We have now encountered almost all of the syntax there is in the
+<code class="code">roff</code> language, with an exception already noted in passing.
+<a class="index-entry-id" id="index-request"></a>
+<a class="index-entry-id" id="index-control-character-_0028_002e_0029"></a>
+<a class="index-entry-id" id="index-character_002c-control-_0028_002e_0029"></a>
+<a class="index-entry-id" id="index-no_002dbreak-control-character-_0028_0027_0029"></a>
+<a class="index-entry-id" id="index-character_002c-no_002dbreak-control-_0028_0027_0029"></a>
+<a class="index-entry-id" id="index-control-character_002c-no_002dbreak-_0028_0027_0029"></a>
+A <em class="dfn">request</em> is an instruction to the formatter that occurs after a
+<em class="dfn">control character</em>, which is recognized at the beginning of an
+input line.  The regular control character is a dot (<code class="code">.</code>).  Its
+counterpart, the <em class="dfn">no-break control character</em>, a neutral apostrophe
+(<code class="code">'</code>), suppresses the break that is implied by some requests.
+These characters were chosen because it is uncommon for lines of text in
+natural languages to begin with them.
+<a class="index-entry-id" id="index-dummy-character-_0028_005c_0026_0029_002c-as-control-character-suppressor"></a>
+<a class="index-entry-id" id="index-character_002c-dummy-_0028_005c_0026_0029_002c-as-control-character-suppressor"></a>
+If you require a formatted period or apostrophe (closing single
+quotation mark) where GNU <code class="code">troff</code> is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence, &lsquo;<samp class="samp">\&amp;</samp>&rsquo;.
+</p>
+<a class="index-entry-id" id="index-control-line"></a>
+<p>An input line beginning with a control character is called a
+<em class="dfn">control line</em>.
+<a class="index-entry-id" id="index-text-line"></a>
+Every line of input that is not a control line is a <em class="dfn">text
+line</em>.<a class="footnote" id="DOCF25" href="groff.html_fot.html#FOOT25"><sup>25</sup></a>
+</p>
+<a class="index-entry-id" id="index-argument"></a>
+<p>Requests often take <em class="dfn">arguments</em>, words (separated from the request
+name and each other by spaces) that specify details of the action GNU
+<code class="code">troff</code> is expected to perform.  If a request is meaningless
+without arguments, it is typically ignored.
+</p>
+<p>GNU <code class="code">troff</code>&rsquo;s requests and escape sequences comprise the control
+language of the formatter.  Of key importance are the requests that
+define macros.  Macros are invoked like requests, enabling the request
+repertoire to be extended or overridden.<a class="footnote" id="DOCF26" href="groff.html_fot.html#FOOT26"><sup>26</sup></a>
+</p>
+<a class="index-entry-id" id="index-macro"></a>
+<a class="index-entry-id" id="index-calling-a-macro"></a>
+<a class="index-entry-id" id="index-interpolation"></a>
+<p>A <em class="dfn">macro</em> can be thought of as an abbreviation you can define for a
+collection of control and text lines.  When the macro is <em class="dfn">called</em> by
+giving its name after a control character, it is replaced with what it
+stands for.  The process of textual replacement is known as
+<em class="dfn">interpolation</em>.<a class="footnote" id="DOCF27" href="groff.html_fot.html#FOOT27"><sup>27</sup></a>  Interpolations are handled as soon as they are
+recognized, and once performed, a <code class="code">roff</code> formatter scans the
+replacement for further requests, macro calls, and escape sequences.
+</p>
+<p>In <code class="code">roff</code> systems, the <code class="code">de</code> request defines a
+macro.<a class="footnote" id="DOCF28" href="groff.html_fot.html#FOOT28"><sup>28</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de DATE
+2020-11-14
+..
+</pre></div></div>
+
+<p>The foregoing input produces no output by itself; all we have done is
+store some information.  Observe the pair of dots that ends the macro
+definition.  This is a default; you can specify your own terminator for
+the macro definition as the second argument to the <code class="code">de</code> request.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de NAME ENDNAME
+Heywood Jabuzzoff
+.ENDNAME
+</pre></div></div>
+
+<p>In fact, the ending marker is itself the name of a macro to be
+called, or a request to be invoked, if it is defined at the time its
+control line is read.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de END
+Big Rip
+..
+.de START END
+Big Bang
+.END
+.START
+    &rArr; Big Rip Big Bang
+</pre></div></div>
+
+<p>In the foregoing example, &ldquo;Big Rip&rdquo; printed before &ldquo;Big Bang&rdquo;
+because its macro was <em class="emph">called</em> first.  Consider what would happen
+if we dropped <code class="code">END</code> from the &lsquo;<samp class="samp">.de START</samp>&rsquo; line and added
+<code class="code">..</code> after <code class="code">.END</code>.  Would the order change?
+</p>
+<p>Let us consider a more elaborate example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de DATE
+2020-10-05
+..
+.
+.de BOSS
+D.\&amp; Kruger,
+J.\&amp; Peterman
+..
+.
+.de NOTICE
+Approved:
+.DATE
+by
+.BOSS
+..
+.
+Insert tedious regulatory compliance paragraph here.
+
+.NOTICE
+
+Insert tedious liability disclaimer paragraph here.
+
+.NOTICE
+    &rArr; Insert tedious regulatory compliance paragraph here.
+    &rArr;
+    &rArr; Approved: 2020-10-05 by D. Kruger, J. Peterman
+    &rArr;
+    &rArr; Insert tedious liability disclaimer paragraph here.
+    &rArr;
+    &rArr; Approved: 2020-10-05 by D. Kruger, J. Peterman
+</pre></div></div>
+
+<p>The above document started with a series of control lines.  Three macros
+were defined, with a <code class="code">de</code> request declaring each macro&rsquo;s name, and
+the &ldquo;body&rdquo; of the macro starting on the next line and continuing until
+a line with two dots &lsquo;<samp class="samp"><code class="code">..</code></samp>&rsquo; marked its end.  The text proper
+began only after the macros were defined; this is a common pattern.
+Only the <code class="code">NOTICE</code> macro was called &ldquo;directly&rdquo; by the document;
+<code class="code">DATE</code> and <code class="code">BOSS</code> were called only by <code class="code">NOTICE</code> itself.
+Escape sequences were used in <code class="code">BOSS</code>, two levels of macro
+interpolation deep.
+</p>
+<p>The advantage in typing and maintenance economy may not be obvious from
+such a short example, but imagine a much longer document with dozens of
+such paragraphs, each requiring a notice of managerial approval.
+Consider what must happen if you are in charge of generating a new
+version of such a document with a different date, for a different boss.
+With well-chosen macros, you only have to change each datum in one
+place.
+</p>
+<p>In practice, we would probably use strings (see <a class="pxref" href="Strings.html">Strings</a>) instead of
+macros for such simple interpolations; what is important here is to
+glimpse the potential of macros and the power of recursive
+interpolation.
+</p>
+<p>We could have defined <code class="code">DATE</code> and <code class="code">BOSS</code> in the opposite order;
+perhaps less obviously, we could also have defined them <em class="emph">after</em>
+<code class="code">NOTICE</code>.  &ldquo;Forward references&rdquo; like this are acceptable because
+the body of a macro definition is not (completely) interpreted, but
+stored instead (see <a class="pxref" href="Copy-Mode.html">Copy Mode</a>).  While a macro is being defined (or
+appended to), requests are not interpreted and macros not interpolated,
+whereas some commonly used escape sequences <em class="emph">are</em> interpreted.
+<code class="code">roff</code> systems also support recursive macro calls, as long as you
+have a way to break the recursion (see <a class="pxref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>).
+Maintainable <code class="code">roff</code> documents tend to arrange macro definitions to
+minimize forward references.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Packages.html">Macro Packages</a>, Previous: <a href="Tabs-and-Leaders.html">Tabs and Leaders</a>, Up: <a href="Text.html">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Safer-Mode.html Added

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Safer Mode (The GNU Troff Manual)</title>
+
+<meta name="description" content="Safer Mode (The GNU Troff Manual)">
+<meta name="keywords" content="Safer Mode (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Implementation-Differences.html" rel="up" title="Implementation Differences">
+<link href="Compatibility-Mode.html" rel="next" title="Compatibility Mode">
+<link href="Implementation-Differences.html" rel="prev" title="Implementation Differences">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Safer-Mode">
+<div class="nav-panel">
+<p>
+Next: <a href="Compatibility-Mode.html" accesskey="n" rel="next">Compatibility Mode</a>, Previous: <a href="Implementation-Differences.html" accesskey="p" rel="prev">Implementation Differences</a>, Up: <a href="Implementation-Differences.html" accesskey="u" rel="up">Implementation Differences</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Safer-Mode-1">5.38.1 Safer Mode</h4>
+<a class="index-entry-id" id="index-safer-mode-7"></a>
+<a class="index-entry-id" id="index-mode_002c-safer-7"></a>
+
+<a class="index-entry-id" id="index-pi-request_002c-disabled-by-default"></a>
+<a class="index-entry-id" id="index-sy-request_002c-disabled-by-default"></a>
+<p>The formatter operates in &ldquo;safer&rdquo; mode by default; to mitigate risks
+from untrusted input documents, the <code class="code">pi</code> and <code class="code">sy</code> requests are
+disabled.  GNU <code class="code">troff</code>&rsquo;s <samp class="option">-U</samp> option enables &ldquo;unsafe
+mode&rdquo;, restoring their function and enabling additional <code class="code">groff</code>
+extension requests, <code class="code">open</code>, <code class="code">opena</code>, and <code class="code">pso</code>.
+See <a class="xref" href="I_002fO.html">I/O</a>.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Sections-and-Chapters.html Added

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Sections and Chapters (The GNU Troff Manual)</title>
+
+<meta name="description" content="Sections and Chapters (The GNU Troff Manual)">
+<meta name="keywords" content="Sections and Chapters (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Headers-and-Footers.html" rel="next" title="Headers and Footers">
+<link href="Paragraphs.html" rel="prev" title="Paragraphs">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Sections-and-Chapters">
+<div class="nav-panel">
+<p>
+Next: <a href="Headers-and-Footers.html" accesskey="n" rel="next">Headers and Footers</a>, Previous: <a href="Paragraphs.html" accesskey="p" rel="prev">Paragraphs</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Sections-and-Chapters-1">3.2.2 Sections and Chapters</h4>
+
+<p>The simplest kind of section heading is unnumbered, set in a bold or
+italic style, and occupies a line by itself.  Others possess
+automatically numbered multi-level headings and/or different typeface
+styles or sizes at different levels.  More sophisticated macro packages
+supply macros for designating chapters and appendices.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Selecting-Fonts.html Added

@@ -0,0 +1,227 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Selecting Fonts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Selecting Fonts (The GNU Troff Manual)">
+<meta name="keywords" content="Selecting Fonts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Font-Families.html" rel="next" title="Font Families">
+<link href="Using-Fonts.html" rel="prev" title="Using Fonts">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Selecting-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Families.html" accesskey="n" rel="next">Font Families</a>, Previous: <a href="Using-Fonts.html" accesskey="p" rel="prev">Using Fonts</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Selecting-Fonts-1">5.19.1 Selecting Fonts</h4>
+<a class="index-entry-id" id="index-font_002c-selection"></a>
+
+<p>We use <em class="dfn">font</em> to refer to any of several means of identifying a
+font: by mounting position (&lsquo;<samp class="samp">3</samp>&rsquo;), by abstract style (&lsquo;<samp class="samp">B</samp>&rsquo;), or
+by its identifier (&lsquo;<samp class="samp">TB</samp>&rsquo;).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eft"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ft</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">font</i></span></var><a class="copiable-link" href='#index-_002eft'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ft"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cff"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f</code><span class="r"><i class="slanted">f</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cf"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cf_0028fn"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f(</code><span class="r"><i class="slanted">fn</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cf_0028fn'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cf_005bfont_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\f</code><span class="r"><i class="slanted">font</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cf_005bfont_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002efn_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.fn</code></strong><a class="copiable-link" href='#index-_005cn_005b_002efn_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002efn"></a>
+<a class="index-entry-id" id="index-changing-fonts-_0028ft_002c-_005cf_0029"></a>
+<a class="index-entry-id" id="index-fonts_002c-changing-_0028ft_002c-_005cf_0029"></a>
+<a class="index-entry-id" id="index-sty-request_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-fam-request_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-_005cF_002c-and-changing-fonts"></a>
+<a class="index-entry-id" id="index-styles"></a>
+<a class="index-entry-id" id="index-family"></a>
+<a class="index-entry-id" id="index-DESC"></a>
+<a class="index-entry-id" id="index-selecting-the-previous-font-_0028ft_0029"></a>
+<a class="index-entry-id" id="index-previous-font_002c-selecting-_0028ft_0029"></a>
+<a class="index-entry-id" id="index-font_002c-previous_002c-slecting-_0028ft_0029"></a>
+<p>The <code class="code">ft</code> request selects the typeface <var class="var">font</var>.  If the argument
+is absent or &lsquo;<samp class="samp">P</samp>&rsquo;, it selects the previously chosen font.  If
+<var class="var">font</var> is a non-negative integer, it is interpreted as mounting
+position; the font mounted there is selected.  If that position refers
+to an abstract style, it is combined with the default family (see
+<code class="code">fam</code> and <code class="code">\F</code> below) to make a resolved font name.  If the
+mounting position is not a style and no font is mounted there, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">font</samp>&rsquo; and ignores the
+request.
+</p>
+<p>If <var class="var">font</var> matches a style name, it is combined with the current
+family to make a resolved font name.  Otherwise, <var class="var">font</var> is assumed
+to already be a resolved font name.
+</p>
+<a class="index-entry-id" id="index-automatic-font-mounting"></a>
+<a class="index-entry-id" id="index-font-mounting_002c-automatic"></a>
+<a class="index-entry-id" id="index-mounting_002c-font_002c-automatic"></a>
+<p>The resolved font name is subject to translation (see request <code class="code">ftr</code>
+below).  Next, the (possibly translated) font name&rsquo;s mounting position
+is looked up; if not mounted, <var class="var">font</var> is sought on the file system as
+a font description file and, if located, automatically mounted at the
+next available position (see register <code class="code">.fp</code> below).  If the font
+was mounted using an identifier different from its font description file
+name (see request <code class="code">fp</code> below), that file name is then looked up.
+If a font description file for the resolved font name is not found, GNU
+<code class="code">troff</code> emits a warning in category &lsquo;<samp class="samp">font</samp>&rsquo; and ignores the
+request.
+</p>
+<p>The <code class="code">\f</code> escape sequence is similar, using one-character name (or
+mounting position) <var class="var">f</var>, two-character name <var class="var">fn</var>, or a name
+<var class="var">font</var> of arbitrary length.
+<a class="index-entry-id" id="index-previous-font_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029"></a>
+<a class="index-entry-id" id="index-font_002c-previous_002c-selecting-_0028_005cf_005b_005d_002c-_005cfP_0029"></a>
+&lsquo;<samp class="samp">\f</samp>&rsquo; selects the previous font.  The syntax form &lsquo;<samp class="samp">\fP</samp>&rsquo; is
+supported for backward compatibility, and &lsquo;<samp class="samp">\fP</samp>&rsquo; for consistency.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">eggs, bacon,
+.ft I
+spam,
+.ft
+and sausage.
+.br
+eggs, bacon, \fIspam,\fP and sausage.
+    &rArr; eggs, bacon, <i class="slanted">spam,</i> and sausage
+    &rArr; eggs, bacon, <i class="slanted">spam,</i> and sausage
+</pre></div></div>
+
+<p>The current and previously selected fonts are properties of the
+environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>The read-only string-valued register <code class="code">.fn</code> contains the resolved
+font name of the selected font.
+</p>
+<p><code class="code">\f</code> doesn&rsquo;t produce an input token in GNU <code class="code">troff</code>; it thus
+can be used in requests that expect a single-character argument.  We can
+assign a font to a margin character as follows (see <a class="pxref" href="Miscellaneous.html">Miscellaneous</a>).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.mc \fIx\f
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eftr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ftr</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">g</i></span></var><a class="copiable-link" href='#index-_002eftr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ftr"></a>
+<a class="index-entry-id" id="index-font-translation-_0028ftr_0029"></a>
+<a class="index-entry-id" id="index-ft-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-ul-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-bd-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-_005cf_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-cs-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-special-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-fp-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-sty-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-if-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-ie-request_002c-and-font-translations"></a>
+<a class="index-entry-id" id="index-while-request_002c-and-font-translations"></a>
+<p>Translate font&nbsp;<var class="var">f</var> to font&nbsp;<var class="var">g</var>.  Whenever a font
+named&nbsp;<var class="var">f</var> is referred to in a <code class="code">\f</code> escape sequence, in the
+<code class="code">F</code> and <code class="code">S</code> conditional operators, or in the <code class="code">ft</code>,
+<code class="code">ul</code>, <code class="code">bd</code>, <code class="code">cs</code>, <code class="code">tkf</code>, <code class="code">special</code>,
+<code class="code">fspecial</code>, <code class="code">fp</code>, or <code class="code">sty</code> requests, font&nbsp;<var class="var">g</var> is
+used.  If <var class="var">g</var> is missing or equal to&nbsp;<var class="var">f</var> the translation is
+undone.
+</p>
+<p>Font translations cannot be chained.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ftr XXX TR
+.ftr XXX YYY
+.ft XXX
+    error&rarr; warning: can't find font 'XXX'
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002efzoom"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fzoom</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">zoom</i></span></var><a class="copiable-link" href='#index-_002efzoom'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fzoom"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002ezoom_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.zoom</code></strong><a class="copiable-link" href='#index-_005cn_005b_002ezoom_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002ezoom"></a>
+<a class="index-entry-id" id="index-magnification-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-font_002c-magnification-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-zoom-factor-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-factor_002c-zoom_002c-of-a-font-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-font_002c-zoom-factor-_0028fzoom_0029"></a>
+<a class="index-entry-id" id="index-optical-size-of-a-font"></a>
+<a class="index-entry-id" id="index-font_002c-optical-size"></a>
+<a class="index-entry-id" id="index-size_002c-optical_002c-of-a-font"></a>
+<p>Set magnification of font&nbsp;<var class="var">f</var> to factor <var class="var">zoom</var>, which must
+be a non-negative integer multiple of 1/1000th.  This request is useful
+to adjust the optical size of a font in relation to the others.  In the
+example below, font <code class="code">CR</code> is magnified by 10% (the zoom factor is
+thus 1.1).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fam P
+.fzoom CR 1100
+.ps 12
+Palatino and \fCRCourier\f
+</pre></div></div>
+
+<p>A missing or zero value of <var class="var">zoom</var> is the same as a value of 1000,
+which means no magnification.  <var class="var">f</var>&nbsp;must be a resolved font
+name, not an abstract style.
+</p>
+<p>The magnification of a font is completely transparent to GNU
+<code class="code">troff</code>; a change of the zoom factor doesn&rsquo;t cause any effect
+except that the dimensions of glyphs, (word) spaces, kerns, etc., of the
+affected font are adjusted accordingly.
+</p>
+<p>The zoom factor of the current font is available in the read-only
+register &lsquo;<samp class="samp">.zoom</samp>&rsquo;, in multiples of 1/1000th.  It returns zero if
+there is no magnification.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Font-Families.html">Font Families</a>, Previous: <a href="Using-Fonts.html">Using Fonts</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Sentences.html Added

@@ -0,0 +1,174 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Sentences (The GNU Troff Manual)</title>
+
+<meta name="description" content="Sentences (The GNU Troff Manual)">
+<meta name="keywords" content="Sentences (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Hyphenation.html" rel="next" title="Hyphenation">
+<link href="Filling.html" rel="prev" title="Filling">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Sentences">
+<div class="nav-panel">
+<p>
+Next: <a href="Hyphenation.html" accesskey="n" rel="next">Hyphenation</a>, Previous: <a href="Filling.html" accesskey="p" rel="prev">Filling</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Sentences-1">5.1.2 Sentences</h4>
+<a class="index-entry-id" id="index-sentences"></a>
+
+<p>A passionate debate has raged for decades among writers of the English
+language over whether more space should appear between adjacent
+sentences than between words within a sentence, and if so, how much, and
+what other circumstances should influence this spacing.<a class="footnote" id="DOCF20" href="groff.html_fot.html#FOOT20"><sup>20</sup></a>
+GNU <code class="code">troff</code> follows the example of <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>;
+it attempts to detect the boundaries between sentences, and supplies
+additional inter-sentence space between them.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">Hello, world!
+Welcome to groff.
+    &rArr; Hello, world!  Welcome to groff.
+</pre></div></div>
+
+<a class="index-entry-id" id="index-end_002dof_002dsentence-characters"></a>
+<a class="index-entry-id" id="index-sentence-space"></a>
+<a class="index-entry-id" id="index-space-between-sentences"></a>
+<a class="index-entry-id" id="index-French-spacing"></a>
+<p>GNU <code class="code">troff</code> flags certain characters (normally &lsquo;<samp class="samp">!</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;,
+and &lsquo;<samp class="samp">.</samp>&rsquo;) as potentially ending a sentence.  When GNU <code class="code">troff</code>
+encounters one of these <em class="dfn">end-of-sentence characters</em> at the end of
+an input line, or one of them is followed by two (unescaped) spaces on
+the same input line, it appends an inter-word space followed by an
+inter-sentence space in the output.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">R. Harper subscribes to a maxim of P. T. Barnum.
+    &rArr; R. Harper subscribes to a maxim of P. T. Barnum.
+</pre></div></div>
+
+<p>In the above example, inter-sentence space is not added after &lsquo;<samp class="samp">P.</samp>&rsquo;
+or &lsquo;<samp class="samp">T.</samp>&rsquo; because the periods do not occur at the end of an input
+line, nor are they followed by two or more spaces.  Let&rsquo;s imagine that
+we&rsquo;ve heard something about defamation from Mr. Harper&rsquo;s attorney,
+recast the sentence, and reflowed it in our text editor.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">I submit that R. Harper subscribes to a maxim of P. T.
+Barnum.
+    &rArr; I submit that R. Harper subscribes to a maxim of
+    &rArr; P. T.  Barnum.
+</pre></div></div>
+
+<p>&ldquo;Barnum&rdquo; doesn&rsquo;t begin a sentence!  What to do?  Let us meet our first
+<em class="dfn">escape sequence</em>, a series of input characters that give
+instructions to GNU <code class="code">troff</code> instead of being used to construct
+output device glyphs.<a class="footnote" id="DOCF21" href="groff.html_fot.html#FOOT21"><sup>21</sup></a> An escape sequence begins with the backslash character <code class="code">\</code>
+by default, an uncommon character in natural language text, and is
+<em class="emph">always</em> followed by at least one other character, hence the term
+&ldquo;sequence&rdquo;.
+</p>
+<a class="index-entry-id" id="index-_005c_0026_002c-at-end-of-sentence"></a>
+<p>The dummy character escape sequence <code class="code">\&amp;</code> can be used after an
+end-of-sentence character to defeat end-of-sentence detection on a
+per-instance basis.  We can therefore rewrite our input more
+defensively.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">I submit that R.\&amp; Harper subscribes to a maxim of P.\&amp;
+T.\&amp; Barnum.
+    &rArr; I submit that R. Harper subscribes to a maxim of
+    &rArr; P. T. Barnum.
+</pre></div></div>
+
+<p>Adding text caused our input to wrap; now, we don&rsquo;t need <code class="code">\&amp;</code> after
+&lsquo;<samp class="samp">T.</samp>&rsquo; but we do after &lsquo;<samp class="samp">P.</samp>&rsquo;.  Consistent use of the escape
+sequence ensures that potential sentence boundaries are robust to
+editing activities.  Further advice along these lines will follow in
+<a class="ref" href="Input-Conventions.html">Input Conventions</a>.
+</p>
+<a class="index-entry-id" id="index-end_002dof_002dsentence-transparent-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-end_002dof_002dsentence-transparent"></a>
+<a class="index-entry-id" id="index-dg-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-dd-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-rq-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-cq-glyph_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0022_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0027_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_0029_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_005d_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-_002a_002c-at-end-of-sentence"></a>
+<a class="index-entry-id" id="index-special-characters"></a>
+<a class="index-entry-id" id="index-characters_002c-special"></a>
+<p>Normally, the occurrence of a visible non-end-of-sentence character (as
+opposed to a space or tab) immediately after an end-of-sentence
+character cancels detection of the end of a sentence.  For example, it
+would be incorrect for GNU <code class="code">troff</code> to infer the end of a sentence
+after the dot in &lsquo;<samp class="samp">3.14159</samp>&rsquo;.  However, several characters are
+treated <em class="emph">transparently</em> after the occurrence of an end-of-sentence
+character.  That is, GNU <code class="code">troff</code> does not cancel end-of-sentence
+detection when it processes them.  This is because such characters are
+often used as footnote markers or to close quotations and
+parentheticals.  The default set is &lsquo;<samp class="samp">&quot;</samp>&rsquo;, &lsquo;<samp class="samp">'</samp>&rsquo;, &lsquo;<samp class="samp">)</samp>&rsquo;,
+&lsquo;<samp class="samp"></samp>&rsquo;, &lsquo;<samp class="samp">*</samp>&rsquo;, <code class="code">\dg</code>, <code class="code">\dd</code>, <code class="code">\rq</code>, and
+<code class="code">\cq</code>.  The last four are examples of <em class="dfn">special characters</em>,
+escape sequences whose purpose is to obtain glyphs that are not easily
+typed at the keyboard, or which have special meaning to GNU <code class="code">troff</code>
+(like <code class="code">\</code> itself).<a class="footnote" id="DOCF22" href="groff.html_fot.html#FOOT22"><sup>22</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">\lqThe idea that the poor should have leisure has always
+been shocking to the rich.\rq
+(Bertrand Russell, 1935)
+    &rArr; &quot;The idea that the poor should have
+    &rArr; leisure has always been shocking to
+    &rArr; the rich.&quot;  (Bertrand Russell, 1935)
+</pre></div></div>
+
+<p>The sets of characters that potentially end sentences or are transparent
+to sentence endings are configurable.  See the <code class="code">cflags</code> request in
+<a class="ref" href="Using-Symbols.html">Using Symbols</a>.  To change the additional inter-sentence space
+amount&mdash;even to remove it entirely&mdash;see <a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Hyphenation.html">Hyphenation</a>, Previous: <a href="Filling.html">Filling</a>, Up: <a href="Text.html">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Separation.html Added

@@ -0,0 +1,94 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Separation (The GNU Troff Manual)</title>
+
+<meta name="description" content="Separation (The GNU Troff Manual)">
+<meta name="keywords" content="Separation (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Language-Concepts.html" rel="up" title="Language Concepts">
+<link href="Argument-Units.html" rel="next" title="Argument Units">
+<link href="Language-Concepts.html" rel="prev" title="Language Concepts">
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Separation">
+<div class="nav-panel">
+<p>
+Next: <a href="Argument-Units.html" accesskey="n" rel="next">Argument Units</a>, Previous: <a href="Language-Concepts.html" accesskey="p" rel="prev">Language Concepts</a>, Up: <a href="Language-Concepts.html" accesskey="u" rel="up">Language Concepts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Separation-1">6.1.1.1 Separation</h4>
+
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> output has strange requirements regarding
+whitespace.  The <code class="code">gtroff</code> output parser, however, is more tolerant,
+making whitespace maximally optional.  Such characters, i.e., the tab,
+space, and newline, always have a syntactical meaning.  They are never
+printable because spacing within the output is always done by
+positioning commands.
+</p>
+<p>Any sequence of space or tab characters is treated as a single
+<em class="dfn">syntactical space</em>.  It separates commands and arguments, but is
+only required when there would occur a clashing between the command code
+and the arguments without the space.  Most often, this happens when
+variable-length command names, arguments, argument lists, or command
+clusters meet.  Commands and arguments with a known, fixed length need
+not be separated by syntactical space.
+</p>
+<p>A line break is a syntactical element, too.  Every command argument can
+be followed by whitespace, a comment, or a newline character.  Thus a
+<em class="dfn">syntactical line break</em> is defined to consist of optional
+syntactical space that is optionally followed by a comment, and a
+newline character.
+</p>
+<p>The normal commands, those for positioning and text, consist of a single
+letter taking a fixed number of arguments.  For historical reasons, the
+parser allows stacking of such commands on the same line, but
+fortunately, in <code class="code">gtroff</code>&rsquo;s intermediate output, every command with
+at least one argument is followed by a line break, thus providing
+excellent readability.
+</p>
+<p>The other commands&mdash;those for drawing and device controlling&mdash;have a
+more complicated structure; some recognize long command names, and some
+take a variable number of arguments.  So all &lsquo;<samp class="samp">D</samp>&rsquo; and &lsquo;<samp class="samp">x</samp>&rsquo;
+commands were designed to request a syntactical line break after their
+last argument.  Only one command, &lsquo;<samp class="samp">x&nbsp;X</samp>&rsquo;, has an argument that
+can span several input lines; all other commands must have all of
+their arguments on the same line as the command, i.e., the arguments may
+not be split by a line break.
+</p>
+<p>Empty lines (these are lines containing only space and/or a comment),
+can occur everywhere.  They are just ignored.
+</p>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Argument-Units.html">Argument Units</a>, Previous: <a href="Language-Concepts.html">Language Concepts</a>, Up: <a href="Language-Concepts.html">Language Concepts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Setting-Registers.html Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Simple-Commands.html Added

@@ -0,0 +1,207 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Simple Commands (The GNU Troff Manual)</title>
+
+<meta name="description" content="Simple Commands (The GNU Troff Manual)">
+<meta name="keywords" content="Simple Commands (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Command-Reference.html" rel="up" title="Command Reference">
+<link href="Graphics-Commands.html" rel="next" title="Graphics Commands">
+<link href="Comment-Command.html" rel="prev" title="Comment Command">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Simple-Commands">
+<div class="nav-panel">
+<p>
+Next: <a href="Graphics-Commands.html" accesskey="n" rel="next">Graphics Commands</a>, Previous: <a href="Comment-Command.html" accesskey="p" rel="prev">Comment Command</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Simple-Commands-1">6.1.2.2 Simple Commands</h4>
+
+<p>The commands in this subsection have a command code consisting of a
+single character, taking a fixed number of arguments.  Most of them are
+commands for positioning and text writing.  These commands are tolerant
+of whitespace.  Optionally, syntactical space can be inserted before,
+after, and between the command letter and its arguments.  All of these
+commands are stackable; i.e., they can be preceded by other simple
+commands or followed by arbitrary other commands on the same line.  A
+separating syntactical space is necessary only when two integer
+arguments would clash or if the preceding argument ends with a string
+argument.
+</p>
+<dl class="table">
+<dt><code class="code">C <var class="var">id</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset the glyph of the special character <var class="var">id</var>.  Trailing
+syntactical space is necessary to allow special character names of
+arbitrary length.  The drawing position is not advanced.
+</p>
+</dd>
+<dt><code class="code">c <var class="var">g</var></code></dt>
+<dd><p>Typeset the glyph of the ordinary character&nbsp;<var class="var">c</var>.  The drawing
+position is not advanced.
+</p>
+</dd>
+<dt><code class="code">f <var class="var">n</var></code></dt>
+<dd><p>Select the font mounted at position&nbsp;<var class="var">n</var>.  <var class="var">n</var>&nbsp;cannot
+be negative.
+</p>
+</dd>
+<dt><code class="code">H <var class="var">n</var></code></dt>
+<dd><p>Horizontally move the drawing position to <var class="var">n</var>&nbsp;basic units from
+the left edge of the page.  <var class="var">n</var>&nbsp;cannot be negative.
+</p>
+</dd>
+<dt><code class="code">h <var class="var">n</var></code></dt>
+<dd><p>Move the drawing position right <var class="var">n</var> basic units.  <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> allowed negative <var class="var">n</var>; GNU <code class="code">troff</code> does not produce
+such values, but <code class="code">groff</code>&rsquo;s output driver library handles them.
+</p>
+</dd>
+<dt><code class="code">m <var class="var">color-scheme</var> <span class="r"></span><var class="var">component</var> &hellip;<span class="r"></span></code></dt>
+<dd><p>Select the stroke color using the <var class="var">component</var>s in the color space
+<var class="var">scheme</var>.  Each <var class="var">component</var> is an integer between 0 and 65535.
+The quantity of components and their meanings vary with each
+<var class="var">scheme</var>.  This command is a <code class="code">groff</code> extension.
+</p>
+<dl class="table">
+<dt><code class="code">mc <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var></code></dt>
+<dd><p>Use the CMY color scheme with components cyan, magenta, and yellow.
+</p>
+</dd>
+<dt><code class="code">md</code></dt>
+<dd><p>Use the default color (no components; black in most cases).
+</p>
+</dd>
+<dt><code class="code">mg <var class="var">gray</var></code></dt>
+<dd><p>Use a grayscale color scheme with a component ranging between 0 (black)
+and 65535 (white).
+</p>
+</dd>
+<dt><code class="code">mk <var class="var">cyan</var> <var class="var">magenta</var> <var class="var">yellow</var> <var class="var">black</var></code></dt>
+<dd><p>Use the CMYK color scheme with components cyan, magenta, yellow, and
+black.
+</p>
+</dd>
+<dt><code class="code">mr <var class="var">red</var> <var class="var">green</var> <var class="var">blue</var></code></dt>
+<dd><p>Use the RGB color scheme with components red, green, and blue.
+</p></dd>
+</dl>
+
+</dd>
+<dt><code class="code">N <var class="var">n</var></code></dt>
+<dd><p>Typeset the glyph with index&nbsp;<var class="var">n</var> in the current font.
+<var class="var">n</var>&nbsp;is normally a non-negative integer.  The drawing position
+is not advanced.  The <code class="code">html</code> and <code class="code">xhtml</code> devices use this
+command with negative&nbsp;<var class="var">n</var> to produce unbreakable space; the
+absolute value of <var class="var">n</var> is taken and interpreted in basic units.
+</p>
+</dd>
+<dt><code class="code">n <var class="var">b</var> <var class="var">a</var></code></dt>
+<dd><p>Indicate a break.  No action is performed; the command is present to
+make the output more easily parsed.  The integers <var class="var">b</var>
+and&nbsp;<var class="var">a</var> describe the vertical space amounts before and after
+the break, respectively.  GNU <code class="code">troff</code> issues this command but
+<code class="code">groff</code>&rsquo;s output driver library ignores it.  See <code class="code">v</code> and
+<code class="code">V</code> below.
+</p>
+</dd>
+<dt><code class="code">p <var class="var">n</var></code></dt>
+<dd><p>Begin a new page, setting its number to&nbsp;<var class="var">n</var>.  Each page is
+independent, even from those using the same number.  The vertical
+drawing position is set to&nbsp;0.  All positioning, writing, and
+drawing commands are interpreted in the context of a page, so a
+<code class="code">p</code>&nbsp;command must precede them.
+</p>
+</dd>
+<dt><code class="code">s <var class="var">n</var></code></dt>
+<dd><p>Set type size to <var class="var">n</var> scaled points (unit&nbsp;<code class="code">z</code> in GNU
+<code class="code">troff</code>.
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> used unscaled points <code class="code">p</code> instead;
+see <a class="ref" href="Output-Language-Compatibility.html">Output Language Compatibility</a>.
+</p>
+</dd>
+<dt><code class="code">t <var class="var">xyz</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dt><code class="code">t <var class="var">xyz</var> <var class="var">dummy-arg</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset a word <var class="var">xyz</var>; that is, set a sequence of ordinary glyphs
+named <var class="var">x</var>, <var class="var">y</var>, <var class="var">z</var>, &hellip;, terminated by a space
+character or a line break; an optional second integer argument is
+ignored (this allows the formatter to generate an even number of
+arguments). Each glyph is set at the current drawing position, and the position is
+then advanced horizontally by the glyph&rsquo;s width.  A glyph&rsquo;s width is
+read from its metrics in the font description file, scaled to the
+current type size, and rounded to a multiple of the horizontal motion
+quantum.  Use the <code class="code">C</code> command to emplace glyphs of special
+characters.  The <code class="code">t</code>&nbsp;command is a <code class="code">groff</code> extension and
+is output only for devices whose <samp class="file">DESC</samp> file contains the
+<code class="code">tcommand</code> directive; see <a class="ref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>.
+</p>
+</dd>
+<dt><code class="code">u <var class="var">n</var> <var class="var">xyz</var>&lsaquo;<span class="r">whitespace</span>&rsaquo;</code></dt>
+<dd><p>Typeset word <var class="var">xyz</var> with track kerning.  As <code class="code">t</code>, but after
+placing each glyph, the drawing position is further advanced
+horizontally by&nbsp;<var class="var">n</var> basic units (<code class="code">u</code>).  The
+<code class="code">u</code>&nbsp;command is a <code class="code">groff</code> extension and is output only for
+devices whose <samp class="file">DESC</samp> file contains the <code class="code">tcommand</code> directive;
+see <a class="ref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>.
+</p>
+</dd>
+<dt><code class="code">V <var class="var">n</var></code></dt>
+<dd><p>Vertically move the drawing position to <var class="var">n</var>&nbsp;basic units from
+the top edge of the page.  <var class="var">n</var>&nbsp;cannot be negative.
+</p>
+</dd>
+<dt><code class="code">v <var class="var">n</var></code></dt>
+<dd><p>Move the drawing position down <var class="var">n</var> basic units.  <abbr class="acronym">AT&amp;T</abbr>
+<code class="code">troff</code> allowed negative <var class="var">n</var>; GNU <code class="code">troff</code> does not produce
+such values, but <code class="code">groff</code>&rsquo;s output driver library handles them.
+</p>
+</dd>
+<dt><code class="code">w</code></dt>
+<dd><p>Indicate an inter-word space.  No action is performed; the command is
+present to make the output more easily parsed.  Only adjustable,
+breakable inter-word spaces are thus described; those resulting from
+<code class="code">\~</code> or horizontal motion escape sequences are not.  GNU
+<code class="code">troff</code> issues this command but <code class="code">groff</code>&rsquo;s output driver
+library ignores it.  See <code class="code">h</code> and <code class="code">H</code> above.
+</p></dd>
+</dl>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Graphics-Commands.html">Graphics Commands</a>, Previous: <a href="Comment-Command.html">Comment Command</a>, Up: <a href="Command-Reference.html">Command Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Special-Fonts.html Added

@@ -0,0 +1,93 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Special Fonts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Special Fonts (The GNU Troff Manual)">
+<meta name="keywords" content="Special Fonts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Artificial-Fonts.html" rel="next" title="Artificial Fonts">
+<link href="Character-Classes.html" rel="prev" title="Character Classes">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Special-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="Artificial-Fonts.html" accesskey="n" rel="next">Artificial Fonts</a>, Previous: <a href="Character-Classes.html" accesskey="p" rel="prev">Character Classes</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Special-Fonts-1">5.19.6 Special Fonts</h4>
+<a class="index-entry-id" id="index-special-fonts-1"></a>
+<a class="index-entry-id" id="index-fonts_002c-special"></a>
+
+<p>Special fonts are those that <code class="code">gtroff</code> searches when it cannot find
+the requested glyph in the current font.  The Symbol font is usually a
+special font.
+</p>
+<p><code class="code">gtroff</code> provides the following two requests to add more special
+fonts.  See <a class="xref" href="Using-Symbols.html">Using Symbols</a>, for a detailed description of the glyph
+searching mechanism in <code class="code">gtroff</code>.
+</p>
+<p>Usually, only non-TTY devices have special fonts.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002especial"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.special</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">s1</i></span> <span class="r"><i class="slanted">s2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002especial'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-special-2"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efspecial"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fspecial</code></strong> <var class="def-var-arguments">f <span class="r"><i class="slanted">s1</i></span> <span class="r"><i class="slanted">s2</i></span> &hellip;</var><a class="copiable-link" href='#index-_002efspecial'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fspecial"></a>
+<a class="index-entry-id" id="index-fonts-1"></a>
+<a class="index-entry-id" id="index-DESC-4"></a>
+<p>Use the <code class="code">special</code> request to define special fonts.  Initially, this
+list is empty.
+</p>
+<p>Use the <code class="code">fspecial</code> request to designate special fonts only when
+font&nbsp;<var class="var">f</var> is active.  Initially, this list is empty.
+</p>
+<p>Previous calls to <code class="code">special</code> or <code class="code">fspecial</code> are overwritten;
+without arguments, the particular list of special fonts is set to empty.
+Special fonts are searched in the order they appear as arguments.
+</p>
+<p>All fonts that appear in a call to <code class="code">special</code> or <code class="code">fspecial</code>
+are loaded.
+</p>
+<p>See <a class="xref" href="Using-Symbols.html">Using Symbols</a>, for the exact search order of glyphs.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/String-Index.html Added

@@ -0,0 +1,344 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>String Index (The GNU Troff Manual)</title>
+
+<meta name="description" content="String Index (The GNU Troff Manual)">
+<meta name="keywords" content="String Index (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="File-Keyword-Index.html" rel="next" title="File Keyword Index">
+<link href="Macro-Index.html" rel="prev" title="Macro Index">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="appendix-level-extent" id="String-Index">
+<div class="nav-panel">
+<p>
+Next: <a href="File-Keyword-Index.html" accesskey="n" rel="next">File Keyword Index</a>, Previous: <a href="Macro-Index.html" accesskey="p" rel="prev">Macro Index</a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="appendix" id="String-Index-1">Appendix G String Index</h2>
+
+<p>The macro package or program a that defines or uses each string is
+appended in brackets. (Only one string, <code class="code">.T</code>, is defined by the
+<code class="code">troff</code> formatter itself.)  See <a class="xref" href="Strings.html">Strings</a>.
+</p>
+
+<div class="printindex st-printindex">
+<table class="st-letters-header-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#String-Index_st_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-2"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-3"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-4"><b>,</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-5"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-6"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-7"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-8"><b>3</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-9"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-11"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-12"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-13"><b>?</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-14"><b>^</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-15"><b>_</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-16"><b>`</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-17"><b>{</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-18"><b>}</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-19"><b>~</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#String-Index_st_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+<table class="st-entries-printindex" border="0">
+<tr><td></td><th class="entries-header-printindex">Index Entry</th><td>&nbsp;</td><th class="sections-header-printindex"> Section</th></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-1">!</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_0021-_005bms_005d"><code>! <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-2">'</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_0027-_005bms_005d"><code><code class="code">'</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_0027-_005bms_005d-1"><code><code class="code">'</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-3">*</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Footnotes.html#index-_002a-_005bms_005d"><code>* <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Footnotes.html">ms Footnotes</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-4">,</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_002c-_005bms_005d"><code>, <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_002c-_005bms_005d-1"><code>, <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-5">-</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typographical-symbols-in-ms.html#index-_002d-_005bms_005d"><code>- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typographical-symbols-in-ms.html">Typographical symbols in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-6">.</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_002e-_005bms_005d"><code>. <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-_002eT"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Strings.html#index-_002eT-1"><code>.T</code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Strings.html">Strings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-7">/</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_002f-_005bms_005d"><code>/ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-8">3</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-3-_005bms_005d"><code>3 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-9">8</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-8-_005bms_005d"><code>8 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-10">:</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_003a-_005bms_005d"><code>: <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_003a-_005bms_005d-1"><code>: <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-11">&lt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-_003c-_005bms_005d"><code>&lt; <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-12">&gt;</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-_003e-_005bms_005d"><code>&gt; <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-13">?</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_003f-_005bms_005d"><code>? <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-14">^</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_005e-_005bms_005d"><code>^ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_005e-_005bms_005d-1"><code>^ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-15">_</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_005f-_005bms_005d"><code>_ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-16">`</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_0060-_005bms_005d"><code><code class="code">`</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_0060-_005bms_005d-1"><code><code class="code">`</code> <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-17">{</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-_007b-_005bms_005d"><code>{ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-18">}</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typeface-and-decoration.html#index-_007d-_005bms_005d"><code>} <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typeface-and-decoration.html">Typeface and decoration</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_symbol-19">~</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_007e-_005bms_005d"><code>~ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-_007e-_005bms_005d-1"><code>~ <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-A">A</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-ABSTRACT-_005bms_005d"><code>ABSTRACT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-ae-_005bms_005d"><code>ae <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-Ae-_005bms_005d"><code>Ae <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-C">C</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-C-_005bms_005d"><code>C <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-CF-_005bms_005d"><code>CF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-CH-_005bms_005d"><code>CH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-D">D</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-d_002d-_005bms_005d"><code>d- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-D_002d-_005bms_005d"><code>D- <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-F">F</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FAM-_005bms_005d"><code>FAM <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-FR-_005bms_005d"><code>FR <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-L">L</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-LF-_005bms_005d"><code>LF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-LH-_005bms_005d"><code>LH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-M">M</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH1-_005bms_005d"><code>MONTH1 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH10-_005bms_005d"><code>MONTH10 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH11-_005bms_005d"><code>MONTH11 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH12-_005bms_005d"><code>MONTH12 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH2-_005bms_005d"><code>MONTH2 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH3-_005bms_005d"><code>MONTH3 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH4-_005bms_005d"><code>MONTH4 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH5-_005bms_005d"><code>MONTH5 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH6-_005bms_005d"><code>MONTH6 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH7-_005bms_005d"><code>MONTH7 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH8-_005bms_005d"><code>MONTH8 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-MONTH9-_005bms_005d"><code>MONTH9 <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-O">O</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-o-_005bms_005d"><code>o <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-oe-_005bms_005d"><code>oe <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-OE-_005bms_005d"><code>OE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-Q">Q</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typographical-symbols-in-ms.html#index-Q-_005bms_005d"><code>Q <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typographical-symbols-in-ms.html">Typographical symbols in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-q-_005bms_005d"><code>q <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-R">R</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-REFERENCES-_005bms_005d"><code>REFERENCES <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-RF-_005bms_005d"><code>RF <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-RH-_005bms_005d"><code>RH <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-S">S</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-SN-_005bms_005d"><code>SN <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-SN_002dDOT-_005bms_005d"><code>SN-DOT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-SN_002dNO_002dDOT-_005bms_005d"><code>SN-NO-DOT <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Document-Control-Settings.html#index-SN_002dSTYLE-_005bms_005d"><code>SN-STYLE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Document-Control-Settings.html">ms Document Control Settings</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Headings-in-ms.html#index-SN_002dSTYLE-_005bms_005d-1"><code>SN-STYLE <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Headings-in-ms.html">Headings in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-T">T</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-th-_005bms_005d"><code>th <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-Th-_005bms_005d"><code>Th <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-language-and-localization.html#index-TOC-_005bms_005d"><code>TOC <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-language-and-localization.html">ms language and localization</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-U">U</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="Typographical-symbols-in-ms.html#index-U-_005bms_005d"><code>U <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="Typographical-symbols-in-ms.html">Typographical symbols in ms</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+<tr><th id="String-Index_st_letter-V">V</th><td></td><td></td></tr>
+<tr><td></td><td class="printindex-index-entry"><a href="ms-Legacy-Features.html#index-v-_005bms_005d"><code>v <span class="r"></span>ms<span class="r"></span></code></a>:</td><td>&nbsp;</td><td class="printindex-index-section"><a href="ms-Legacy-Features.html">ms Legacy Features</a></td></tr>
+<tr><td colspan="4"> <hr></td></tr>
+</table>
+<table class="st-letters-footer-printindex"><tr><th>Jump to: &nbsp; </th><td><a class="summary-letter-printindex" href="#String-Index_st_symbol-1"><b>!</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-2"><b>'</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-3"><b>*</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-4"><b>,</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-5"><b>-</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-6"><b>.</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-7"><b>/</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-8"><b>3</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-9"><b>8</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-10"><b>:</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-11"><b>&lt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-12"><b>&gt;</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-13"><b>?</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-14"><b>^</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-15"><b>_</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-16"><b>`</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-17"><b>{</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-18"><b>}</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_symbol-19"><b>~</b></a>
+ &nbsp; 
+<br>
+<a class="summary-letter-printindex" href="#String-Index_st_letter-A"><b>A</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-C"><b>C</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-D"><b>D</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-F"><b>F</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-L"><b>L</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-M"><b>M</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-O"><b>O</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-Q"><b>Q</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-R"><b>R</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-S"><b>S</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-T"><b>T</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-U"><b>U</b></a>
+ &nbsp; 
+<a class="summary-letter-printindex" href="#String-Index_st_letter-V"><b>V</b></a>
+ &nbsp; 
+</td></tr></table>
+</div>
+
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="File-Keyword-Index.html">File Keyword Index</a>, Previous: <a href="Macro-Index.html">Macro Index</a>, Up: <a href="index.html">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Strings.html Added

@@ -0,0 +1,429 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Strings (The GNU Troff Manual)</title>
+
+<meta name="description" content="Strings (The GNU Troff Manual)">
+<meta name="keywords" content="Strings (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Conditionals-and-Loops.html" rel="next" title="Conditionals and Loops">
+<link href="Colors.html" rel="prev" title="Colors">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Strings">
+<div class="nav-panel">
+<p>
+Next: <a href="Conditionals-and-Loops.html" accesskey="n" rel="next">Conditionals and Loops</a>, Previous: <a href="Colors.html" accesskey="p" rel="prev">Colors</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Strings-1">5.22 Strings</h3>
+<a class="index-entry-id" id="index-strings"></a>
+
+<p>GNU <code class="code">troff</code> supports strings primarily for user convenience.
+Conventionally, if one would define a macro only to interpolate a small
+amount of text, without invoking requests or calling any other macros,
+one defines a string instead.  Only one string is predefined by the
+language.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002eT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*.T</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002eT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eT"></a>
+<a class="index-entry-id" id="index-_002eT-1"></a>
+<a class="index-entry-id" id="index-output-device-name-string-_0028_002eT_0029-1"></a>
+<p>Contains the name of the output device (for example, &lsquo;<samp class="samp">utf8</samp>&rsquo; or
+&lsquo;<samp class="samp">pdf</samp>&rsquo;).
+</p></dd></dl>
+
+<p>The <code class="code">ds</code> request creates a string with a specified name and
+contents and the <code class="code">\*</code> escape sequence dereferences its name,
+interpolating its contents.  If the string named by the <code class="code">\*</code> escape
+sequence does not exist, it is defined as empty, nothing is
+interpolated, and a warning in category &lsquo;<samp class="samp">mac</samp>&rsquo; is emitted.
+See <a class="xref" href="Warnings.html">Warnings</a>, for information about the enablement and suppression of
+warnings.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eds-1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eds-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eds1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eds1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002an"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*</code><span class="r"><i class="slanted">n</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002an'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002a"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002a_0028nm'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bname-_005barg1-arg2-_2026_005d_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\*</code><span class="r"><i class="slanted">name <span class="sansserif"></span>arg1 arg2 &hellip;<span class="sansserif"></span></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002a_005bname-_005barg1-arg2-_2026_005d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-string-interpolation-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-string-expansion-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-interpolation-of-strings-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-expansion-of-strings-_0028_005c_002a_0029"></a>
+<a class="index-entry-id" id="index-string-arguments"></a>
+<a class="index-entry-id" id="index-arguments_002c-to-strings"></a>
+<p>Define a string called <var class="var">name</var> with contents <var class="var">contents</var>.  If
+<var class="var">name</var> already exists as an alias, the target of the alias is
+redefined; see <code class="code">als</code> and <code class="code">rm</code> below.  If <code class="code">ds</code> is called
+with only one argument, <var class="var">name</var> is defined as an empty string.
+Otherwise, GNU <code class="code">troff</code> stores <var class="var">contents</var> in copy
+mode.<a class="footnote" id="DOCF87" href="groff.html_fot.html#FOOT87"><sup>87</sup></a>
+</p>
+<p>The <code class="code">\*</code> escape sequence interpolates a previously defined string
+variable <var class="var">name</var> (one-character name&nbsp;<var class="var">n</var>, two-character name
+<var class="var">nm</var>).  The bracketed interpolation form accepts arguments that are
+handled as macro arguments are; recall <a class="ref" href="Calling-Macros.html">Calling Macros</a>.  In
+contrast to macro calls, however, if a closing bracket &lsquo;<samp class="samp"></samp>&rsquo; occurs
+in a string argument, that argument must be enclosed in double quotes.
+<code class="code">\*</code> is interpreted even in copy mode.  When defining strings,
+argument interpolations must be escaped if they are to reference
+parameters from the calling context; See <a class="xref" href="Parameters.html">Parameters</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds cite (\\$1, \\$2)
+Gray codes are explored in \*cite Morgan 1998.
+    &rArr; Gray codes are explored in (Morgan, 1998).
+</pre></div></div>
+
+
+<a class="index-entry-id" id="index-trailing-spaces-in-string-definitions-and-appendments"></a>
+<a class="index-entry-id" id="index-comments_002c-with-ds"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-comments"></a>
+<p><strong class="strong">Caution:</strong> Unlike other requests, the second argument to the
+<code class="code">ds</code> request consumes the remainder of the input line, including
+trailing spaces.  This means that comments on a line with such a request
+can introduce unwanted space into a string when they are set off from
+the material they annotate, as is conventional.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \&quot; water
+</pre></div></div>
+
+<p>Instead, place the comment on another line or put the comment escape
+sequence immediately adjacent to the last character of the string.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\&quot; water
+</pre></div></div>
+
+<p>Ending string definitions (and appendments) with a comment, even an
+empty one, prevents unwanted space from creeping into them during source
+document maintenance.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds author Alice Pleasance Liddell\&quot;
+.ds empty \&quot; might be appended to later with .as
+</pre></div></div>
+
+<a class="index-entry-id" id="index-trailing-double-quotes-in-strings"></a>
+<a class="index-entry-id" id="index-double-quotes_002c-trailing_002c-in-strings"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-double-quotes"></a>
+<a class="index-entry-id" id="index-leading-spaces-with-ds"></a>
+<a class="index-entry-id" id="index-spaces-with-ds"></a>
+<a class="index-entry-id" id="index-ds-request_002c-and-leading-spaces"></a>
+<p>An initial neutral double quote <code class="code">&quot;</code> in <var class="var">contents</var> is stripped
+to allow embedding of leading spaces.  Any other <code class="code">&quot;</code> is interpreted
+literally, but it is wise to use the special character escape sequence
+<code class="code">\dq</code> instead if the string might be interpolated as part of a
+macro argument; see <a class="ref" href="Calling-Macros.html">Calling Macros</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds salutation &quot;         Yours in a white wine sauce,\&quot;
+.ds c-var-defn &quot;  char mydate=\dq2020-07-29\dq;\&quot;
+</pre></div></div>
+
+<a class="index-entry-id" id="index-multi_002dline-strings"></a>
+<a class="index-entry-id" id="index-strings_002c-multi_002dline"></a>
+<a class="index-entry-id" id="index-newline-character_002c-in-strings_002c-escaping"></a>
+<a class="index-entry-id" id="index-escaping-newline-characters_002c-in-strings"></a>
+<p>Strings are not limited to a single input line of text.
+<code class="code">\<kbd class="key">RET</kbd></code> works just as it does elsewhere.  The resulting string
+is stored <em class="emph">without</em> the newlines.  Care is therefore required when
+interpolating strings while filling is disabled.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds foo This string contains \
+text on multiple lines \
+of input.
+</pre></div></div>
+
+<p>It is not possible to embed a newline in a string that will be
+interpreted as such when the string is interpolated.  To achieve that
+effect, use <code class="code">\*</code> to interpolate a macro instead; see <a class="ref" href="Punning-Names.html">Punning Names</a>.
+</p>
+<p>Because strings are similar to macros, they too can be defined so as to
+suppress AT&amp;T <code class="code">troff</code> compatibility mode when used; see
+<a class="ref" href="Writing-Macros.html">Writing Macros</a> and <a class="ref" href="Compatibility-Mode.html">Compatibility Mode</a>.  The <code class="code">ds1</code>
+request defines a string such that compatibility mode is off when the
+string is later interpolated.  To be more precise, a <em class="dfn">compatibility
+save</em> input token is inserted at the beginning of the string, and a
+<em class="dfn">compatibility restore</em> input token at the end.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr xxx 12345
+.ds aa The value of xxx is \\nxxx.
+.ds1 bb The value of xxx is \\nxxx.
+.
+.cp 1
+.
+\*(aa
+    error&rarr; warning: register '' not defined
+    &rArr; The value of xxx is 0xxx.
+\*(bb
+    &rArr; The value of xxx is 12345.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eas"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.as</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eas'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-as"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eas1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.as1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eas1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-as1"></a>
+<a class="index-entry-id" id="index-appending-to-a-string-_0028as_0029"></a>
+<a class="index-entry-id" id="index-string_002c-appending-_0028as_0029"></a>
+<p>The <code class="code">as</code> request is similar to <code class="code">ds</code> but appends <var class="var">contents</var>
+to the string stored as <var class="var">name</var> instead of redefining it.  If
+<var class="var">name</var> doesn&rsquo;t exist yet, it is created.  If <code class="code">as</code> is called
+with only one argument, no operation is performed (beyond dereferencing
+the string).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.as salutation &quot; with shallots, onions and garlic,\&quot;
+</pre></div></div>
+
+<p>The <code class="code">as1</code> request is similar to <code class="code">as</code>, but compatibility mode
+is switched off when the appended portion of the string is later
+interpolated.  To be more precise, a <em class="dfn">compatibility save</em> input
+token is inserted at the beginning of the appended string, and a
+<em class="dfn">compatibility restore</em> input token at the end.
+</p></dd></dl>
+
+<p>Several requests exist to perform rudimentary string operations.
+Strings can be queried (<code class="code">length</code>) and modified (<code class="code">chop</code>,
+<code class="code">substring</code>, <code class="code">stringup</code>, <code class="code">stringdown</code>), and their names
+can be manipulated through renaming, removal, and aliasing (<code class="code">rn</code>,
+<code class="code">rm</code>, <code class="code">als</code>).
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elength"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.length</code></strong> <var class="def-var-arguments">reg anything</var><a class="copiable-link" href='#index-_002elength'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-length"></a>
+<a class="index-entry-id" id="index-length-of-a-string-_0028length_0029"></a>
+<a class="index-entry-id" id="index-string_002c-length-of-_0028length_0029"></a>
+<a class="index-entry-id" id="index-length-request_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-length-request"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-length-request"></a>
+<p>Compute the number of characters of <var class="var">anything</var> and store the count
+in the register <var class="var">reg</var>.  If <var class="var">reg</var> doesn&rsquo;t exist, it is created.
+<var class="var">anything</var> is read in copy mode.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xxx abcd\h'3i'efgh
+.length yyy \*xxx
+\nyyy
+    &rArr; 14
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002echop"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.chop</code></strong> <var class="def-var-arguments">object</var><a class="copiable-link" href='#index-_002echop'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-chop"></a>
+<p>Remove the last character from the macro, string, or diversion named
+<var class="var">object</var>.  This is useful for removing the newline from the end of a
+diversion that is to be interpolated as a string.  This request can be
+used repeatedly on the same <var class="var">object</var>; see <a class="ref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>,
+for details on nodes inserted additionally by GNU <code class="code">troff</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002esubstring"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.substring</code></strong> <var class="def-var-arguments">str start <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002esubstring'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-substring"></a>
+<a class="index-entry-id" id="index-substring-_0028substring_0029"></a>
+<p>Replace the string named <var class="var">str</var> with its substring bounded by the
+indices <var class="var">start</var> and <var class="var">end</var>, inclusively.  The first character in
+the string has index&nbsp;0.  If <var class="var">end</var> is omitted, it is implicitly
+set to the largest valid value (the string length minus one).  Negative
+indices count backward from the end of the string: the last character
+has index&nbsp;&minus;1, the character before the last has
+index&nbsp;&minus;2, and so on.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xxx abcdefgh
+.substring xxx 1 -4
+\*xxx
+    &rArr; bcde
+.substring xxx 2
+\*xxx
+    &rArr; de
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002estringdown"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.stringdown</code></strong> <var class="def-var-arguments">str</var><a class="copiable-link" href='#index-_002estringdown'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-stringdown"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002estringup"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.stringup</code></strong> <var class="def-var-arguments">str</var><a class="copiable-link" href='#index-_002estringup'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-stringup"></a>
+<a class="index-entry-id" id="index-case_002dtransforming-a-string-_0028stringdown_002c-stringup_0029"></a>
+<a class="index-entry-id" id="index-uppercasing-a-string-_0028stringup_0029"></a>
+<a class="index-entry-id" id="index-lowercasing-a-string-_0028stringdown_0029"></a>
+<a class="index-entry-id" id="index-up_002dcasing-a-string-_0028stringup_0029"></a>
+<a class="index-entry-id" id="index-down_002dcasing-a-string-_0028stringdown_0029"></a>
+<p>Alter the string named <var class="var">str</var> by replacing each of its bytes with its
+lowercase (<code class="code">stringdown</code>) or uppercase (<code class="code">stringup</code>) version (if
+one exists).  Special characters in the string will often transform in
+the expected way due to the regular naming convention for accented
+characters.  When they do not, use substrings and/or catenation.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds resume R\'esum\'e
+\*resume
+.stringdown resume
+\*resume
+.stringup resume
+\*resume
+    &rArr; Résumé résumé RÉSUMÉ
+</pre></div></div>
+</dd></dl>
+
+<p>(In practice, we would end the <code class="code">ds</code> request with a comment escape
+<code class="code">\&quot;</code> to prevent space from creeping into the definition during
+source document maintenance.)
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ern"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rn</code></strong> <var class="def-var-arguments">old new</var><a class="copiable-link" href='#index-_002ern'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rn"></a>
+<a class="index-entry-id" id="index-renaming-request-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-request_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-macro-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-string-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-string_002c-renaming-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-renaming-diversion-_0028rn_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-renaming-_0028rn_0029"></a>
+<p>Rename the request, macro, diversion, or string <var class="var">old</var> to <var class="var">new</var>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erm"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rm</code></strong> <var class="def-var-arguments">name</var><a class="copiable-link" href='#index-_002erm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rm"></a>
+<a class="index-entry-id" id="index-removing-request-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-request_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-macro-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-string-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-string_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-diversion-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-removing-_0028rm_0029"></a>
+<p>Remove the request, macro, diversion, or string <var class="var">name</var>.  GNU
+<code class="code">troff</code> treats subsequent invocations as if the name had never
+been defined.
+</p></dd></dl>
+
+<a class="anchor" id="als"></a><dl class="first-deffn">
+<dt class="deffn" id="index-_002eals"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.als</code></strong> <var class="def-var-arguments">new old</var><a class="copiable-link" href='#index-_002eals'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-als"></a>
+<a class="index-entry-id" id="index-alias_002c-string_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-macro_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-diversion_002c-creating-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-string-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-macro-_0028als_0029"></a>
+<a class="index-entry-id" id="index-creating-alias_002c-for-diversion-_0028als_0029"></a>
+<a class="index-entry-id" id="index-string_002c-creating-alias-for-_0028als_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-creating-alias-for-_0028als_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-creating-alias-for-_0028als_0029"></a>
+<p>Create an alias <var class="var">new</var> for the existing request, string, macro, or
+diversion object named <var class="var">old</var>, causing the names to refer to the same
+stored object.  If <var class="var">old</var> is undefined, a warning in category
+&lsquo;<samp class="samp">mac</samp>&rsquo; is produced, and the request is ignored.  See <a class="xref" href="Warnings.html">Warnings</a>,
+for information about the enablement and suppression of warnings.
+</p>
+<p>To understand how the <code class="code">als</code> request works, consider two different
+storage pools: one for objects (macros, strings, etc.), and another
+for names.  As soon as an object is defined, GNU <code class="code">troff</code> adds it to
+the object pool, adds its name to the name pool, and creates a link
+between them.  When <code class="code">als</code> creates an alias, it adds a new name to
+the name pool that gets linked to the same object as the old name.
+</p>
+<p>Now consider this example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de foo
+..
+.
+.als bar foo
+.
+.de bar
+.  foo
+..
+.
+.bar
+    error&rarr; input stack limit exceeded (probable infinite
+    error&rarr; loop)
+</pre></div></div>
+
+<p>In the above, <code class="code">bar</code> remains an <em class="emph">alias</em>&mdash;another name
+for&mdash;the object referred to by <code class="code">foo</code>, which the second <code class="code">de</code>
+request replaces.  Alternatively, imagine that the <code class="code">de</code> request
+<em class="emph">dereferences</em> its argument before replacing it.  Either way, the
+result of calling <code class="code">bar</code> is a recursive loop that finally leads to
+an error.  See <a class="xref" href="Writing-Macros.html">Writing Macros</a>.
+</p>
+<a class="index-entry-id" id="index-alias_002c-string_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-macro_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-alias_002c-diversion_002c-removing-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-string-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-macro-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-removing-alias_002c-for-diversion-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-string_002c-removing-alias-for-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-removing-alias-for-_0028rm_0029"></a>
+<a class="index-entry-id" id="index-diversion_002c-removing-alias-for-_0028rm_0029"></a>
+<p>To remove an alias, call <code class="code">rm</code> on its name.  The object itself is
+not destroyed until it has no more names.
+</p>
+<p>When a request, macro, string, or diversion is aliased, redefinitions
+and appendments &ldquo;write through&rdquo; alias names.  To replace an alias with
+a separately defined object, you must use the <code class="code">rm</code> request on its
+name first.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a>, Previous: <a href="Colors.html">Colors</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Suppressing-Output.html Added

@@ -0,0 +1,147 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Suppressing Output (The GNU Troff Manual)</title>
+
+<meta name="description" content="Suppressing Output (The GNU Troff Manual)">
+<meta name="keywords" content="Suppressing Output (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Colors.html" rel="next" title="Colors">
+<link href="Environments.html" rel="prev" title="Environments">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Suppressing-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="Colors.html" accesskey="n" rel="next">Colors</a>, Previous: <a href="Environments.html" accesskey="p" rel="prev">Environments</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Suppressing-Output-1">5.32 Suppressing Output</h3>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cO_005bnum_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\O</code><span class="r"><i class="slanted">num</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005cO_005bnum_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cO"></a>
+<a class="index-entry-id" id="index-suppressing-output-_0028_005cO_0029"></a>
+<a class="index-entry-id" id="index-output_002c-suppressing-_0028_005cO_0029"></a>
+<p>Suppress GNU <code class="code">troff</code> output of glyphs and geometric objects.  The
+sequences <code class="code">\O2</code>, <code class="code">\O3</code>, <code class="code">\O4</code>, and <code class="code">\O5</code> are
+intended for internal use by <code class="code">grohtml</code>.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O0</samp>&rsquo;</dt>
+<dd><p>Disable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
+level (see <code class="code">\O3</code> and <code class="code">\04</code> below).  Horizontal motions
+corresponding to non-overstruck glyph widths still occur.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O1</samp>&rsquo;</dt>
+<dd><p>Enable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
+level.
+</p></dd>
+</dl>
+
+<a class="index-entry-id" id="index-opminx"></a>
+<a class="index-entry-id" id="index-opminy"></a>
+<a class="index-entry-id" id="index-opmaxx"></a>
+<a class="index-entry-id" id="index-opmaxy"></a>
+<p><code class="code">\O0</code> and <code class="code">\O1</code> also reset the four registers <code class="code">opminx</code>,
+<code class="code">opminy</code>, <code class="code">opmaxx</code>, and <code class="code">opmaxy</code> to &minus;1.  These
+four registers mark the top left and bottom right hand corners of a box
+encompassing all written or drawn output.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O2</samp>&rsquo;</dt>
+<dd><p>At the outermost suppression level, enable emission of glyphs and
+geometric objects, and write to the standard error stream the page
+number and values of the four aforementioned registers encompassing
+glyphs written since the last interpolation of a <code class="code">\O</code> sequence, as
+well as the page offset, line length, image file name (if any),
+horizontal and vertical device motion quanta, and input file name.
+Numeric values are in basic units.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O3</samp>&rsquo;</dt>
+<dd><p>Begin a nested suppression level.  <code class="command">grohtml</code> uses this mechanism
+to create images of output preprocessed with <code class="command">gpic</code>,
+<code class="command">geqn</code>, and <code class="command">gtbl</code>.  At startup, GNU <code class="code">troff</code> is at
+the outermost suppression level.  <code class="command">pre-grohtml</code> generates these
+sequences when processing the document, using GNU <code class="command">troff</code> with
+the <code class="code">ps</code> output device, Ghostscript, and the PNM tools to produce
+images in PNG format.  They start a new page if the device is not
+<code class="code">html</code> or <code class="code">xhtml</code>, to reduce the number of images crossing a
+page boundary.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">\O4</samp>&rsquo;</dt>
+<dd><p>End a nested suppression level.
+</p></dd>
+</dl>
+
+<dl class="table">
+<dt>&lsquo;<samp class="samp">\O5<var class="var">P</var><var class="var">file</var></samp>&rsquo;</dt>
+<dd><p>At the outermost suppression level, write the name <code class="code">file</code> to the
+standard error stream at position <var class="var">P</var>, which must be one of
+<code class="code">l</code>, <code class="code">r</code>, <code class="code">c</code>, or&nbsp;<code class="code">i</code>, corresponding to left,
+right, centered, and inline alignments within the document,
+respectively.  <var class="var">file</var> is a name associated with the production of
+the next image.
+</p></dd>
+</dl>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eO_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.O</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eO_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eO"></a>
+<a class="index-entry-id" id="index-suppression-nesting-level-register"></a>
+<a class="index-entry-id" id="index-nesting-level_002c-suppression_002c-register"></a>
+<a class="index-entry-id" id="index-level_002c-suppression-nesting_002c-register"></a>
+<p>Output suppression nesting level applied by <code class="code">\O3</code> and <code class="code">\O4</code>
+escape sequences.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Colors.html">Colors</a>, Previous: <a href="Environments.html">Environments</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Tab-Stops-in-ms.html Added

@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Tab Stops in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Tab Stops in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Tab Stops in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Page-Layout.html" rel="up" title="ms Page Layout">
+<link href="ms-Margins.html" rel="next" title="ms Margins">
+<link href="ms-Headers-and-Footers.html" rel="prev" title="ms Headers and Footers">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Tab-Stops-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Margins.html" accesskey="n" rel="next">Margins</a>, Previous: <a href="ms-Headers-and-Footers.html" accesskey="p" rel="prev">Headers and footers</a>, Up: <a href="ms-Page-Layout.html" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Tab-stops">4.6.6.2 Tab stops</h4>
+
+<p>Use the <code class="code">ta</code> request to define tab stops as needed.  See <a class="xref" href="Tabs-and-Fields.html">Tabs and Fields</a>.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TA</code></strong><a class="copiable-link" href='#index-_002eTA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TA-_005bms_005d"></a>
+<p>Reset the tab stops to the <samp class="file">ms</samp> default (every 5 ens).
+Redefine this macro to create a different set of default tab stops.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Table-of-Contents.html Added

@@ -0,0 +1,71 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Table of Contents (The GNU Troff Manual)</title>
+
+<meta name="description" content="Table of Contents (The GNU Troff Manual)">
+<meta name="keywords" content="Table of Contents (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Common-Features.html" rel="up" title="Common Features">
+<link href="Indexing.html" rel="next" title="Indexing">
+<link href="Footnotes-and-Endnotes.html" rel="prev" title="Footnotes and Endnotes">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Table-of-Contents">
+<div class="nav-panel">
+<p>
+Next: <a href="Indexing.html" accesskey="n" rel="next">Indexing</a>, Previous: <a href="Footnotes-and-Endnotes.html" accesskey="p" rel="prev">Footnotes and Endnotes</a>, Up: <a href="Common-Features.html" accesskey="u" rel="up">Common Features</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Table-of-Contents-1">3.2.7 Table of Contents</h4>
+<a class="index-entry-id" id="index-table-of-contents"></a>
+<a class="index-entry-id" id="index-contents_002c-table-of"></a>
+
+<p>A package may handle a <i class="slanted">table of contents</i> by directing section
+heading macros to save section heading text and the page number where it
+occurs for use in a later <i class="slanted">entry</i> for a table of contents.  It
+writes the collected entries at the end of the document, once all are
+known, upon request.  A row of dots (a <i class="slanted">leader</i>) bridges the
+text on the left with its location on the right.  Other collections
+might work in this manner, providing lists of figures or tables.
+</p>
+<p>A table of contents is often found at the end of a GNU <code class="code">troff</code>
+document because the formatter processes the document in a single pass.
+The <code class="command">gropdf</code> output driver supports a PDF feature that relocates
+pages at the time the document is rendered; see the <cite class="cite">gropdf<span class="r">(1)</span></cite>
+man page.  Type &lsquo;<samp class="samp">man gropdf</samp>&rsquo; at the command line to view it.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Tabs-and-Fields.html Added

@@ -0,0 +1,276 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Tabs and Fields (The GNU Troff Manual)</title>
+
+<meta name="description" content="Tabs and Fields (The GNU Troff Manual)">
+<meta name="keywords" content="Tabs and Fields (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Character-Translations.html" rel="next" title="Character Translations">
+<link href="Manipulating-Spacing.html" rel="prev" title="Manipulating Spacing">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Tabs-and-Fields">
+<div class="nav-panel">
+<p>
+Next: <a href="Character-Translations.html" accesskey="n" rel="next">Character Translations</a>, Previous: <a href="Manipulating-Spacing.html" accesskey="p" rel="prev">Manipulating Spacing</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Tabs-and-Fields-1">5.12 Tabs and Fields</h3>
+<a class="index-entry-id" id="index-tabs_002c-and-fields"></a>
+<a class="index-entry-id" id="index-fields_002c-and-tabs"></a>
+
+<a class="index-entry-id" id="index-tab-character-encoding"></a>
+<p>A tab character (<abbr class="acronym">ISO</abbr> code point&nbsp;9, <abbr class="acronym">EBCDIC</abbr>
+code point&nbsp;5) causes a horizontal movement to the next tab stop, if
+any.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ct-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\t</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ct-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ct"></a>
+<a class="index-entry-id" id="index-tab-character_002c-non_002dinterpreted-_0028_005ct_0029"></a>
+<a class="index-entry-id" id="index-character_002c-tab_002c-non_002dinterpreted-_0028_005ct_0029"></a>
+<a class="index-entry-id" id="index-_005ct_002c-and-copy-mode"></a>
+<a class="index-entry-id" id="index-copy-mode_002c-and-_005ct"></a>
+<a class="index-entry-id" id="index-mode_002c-copy_002c-and-_005ct"></a>
+<p>Interpolate a tab in copy mode; see <a class="ref" href="Copy-Mode.html">Copy Mode</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eta"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ta</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">n1</i></span> <span class="r"><i class="slanted">n2</i></span> &hellip; <span class="r"><i class="slanted">nn</i></span> <code class="t">T</code> <span class="r"><i class="slanted">r1</i></span>  <span class="r"><i class="slanted">r2</i></span> &hellip; <span class="r"><i class="slanted">rn</i></span></var><a class="copiable-link" href='#index-_002eta'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ta"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002etabs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.tabs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002etabs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002etabs"></a>
+<p>Change tab stop positions.  This request takes a series of tab
+specifiers as arguments (optionally divided into two groups with the
+letter &lsquo;<samp class="samp">T</samp>&rsquo;) that indicate where each tab stop is to be, overriding
+any previous settings.  The default scaling unit is &lsquo;<samp class="samp">m</samp>&rsquo;.  Invoking
+<code class="code">ta</code> without an argument removes all tab stops.
+<a class="index-entry-id" id="index-default-tab-stops"></a>
+<a class="index-entry-id" id="index-tab-stops_002c-default"></a>
+GNU <code class="code">troff</code>&rsquo;s startup value is &lsquo;<samp class="samp">T&nbsp;0.5i</samp>&rsquo;.
+</p>
+<p>Tab stops can be specified absolutely&mdash;as distances from the left
+margin.  The following example sets six tab stops, one every inch.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i 2i 3i 4i 5i 6i
+</pre></div></div>
+
+<p>Tab stops can also be specified using a leading &lsquo;<samp class="samp">+</samp>&rsquo;, which means
+that the specified tab stop is set relative to the previous tab stop.
+For example, the following is equivalent to the previous example.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i +1i +1i +1i +1i +1i
+</pre></div></div>
+
+<p>GNU <code class="code">troff</code> supports an extended syntax to specify repeating tab
+stops.  These stops appear after a &lsquo;<samp class="samp">T</samp>&rsquo; argument.  Their values are
+always taken as distances relative to the previous tab stop.  This is
+the idiomatic way to specify tab stops at equal intervals in
+<code class="code">groff</code>.  The following is, yet again, the same as the previous
+examples.  It does more, in fact, since it defines an infinite number of
+tab stops at one-inch intervals.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta T 1i
+</pre></div></div>
+
+<p>Now we are ready to interpret the full syntax given above.  The
+<code class="code">ta</code> request sets tabs at positions <var class="var">n1</var>, <var class="var">n2</var>, &hellip;,
+<var class="var">nn</var>, then at <var class="var">nn</var>+<var class="var">r1</var>, <var class="var">nn</var>+<var class="var">r2</var>, &hellip;,
+<var class="var">nn</var>+<var class="var">rn</var>, then at <var class="var">nn</var>+<var class="var">rn</var>+<var class="var">r1</var>,
+<var class="var">nn</var>+<var class="var">rn</var>+<var class="var">r2</var>, &hellip;, <var class="var">nn</var>+<var class="var">rn</var>+<var class="var">rn</var>, and so
+on.
+</p>
+<p>For example, &lsquo;<samp class="samp">4c +6c T 3c 5c 2c</samp>&rsquo; is equivalent to &lsquo;<samp class="samp">4c 10c 13c
+18c 20c 23c 28c 30c &hellip;</samp>&rsquo;.
+</p>
+<p>Text written to a tab column (i.e., between two tab stops, or between a
+tab stop and an output line boundary) may be aligned to the right or
+left, or centered in the column.  This alignment is determined by
+appending &lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">L</samp>&rsquo;, or &lsquo;<samp class="samp">C</samp>&rsquo; to the tab specifier.  The
+default is &lsquo;<samp class="samp">L</samp>&rsquo;.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ta 1i 2iC 3iR
+</pre></div></div>
+
+<p>The beginning of an output line is not a tab stop; the text that begins
+an output line is placed according to the configured alignment and
+indentation; see <a class="ref" href="Manipulating-Filling-and-Adjustment.html">Manipulating Filling and Adjustment</a> and <a class="ref" href="Line-Layout.html">Line Layout</a>.
+</p>
+<p>A tab stop is converted into a non-breakable horizontal movement that
+cannot be adjusted.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 2i
+.ds foo a\tb\tc
+.ta T 1i
+\*foo
+    error&rarr; warning: cannot break line
+    &rArr; a         b         c
+</pre></div></div>
+
+<p>The above creates a single output line that is a bit longer than two
+inches (we use a string to show exactly where the tab stops are).
+Now consider the following.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ll 2i
+.ds bar a\tb c\td
+.ta T 1i
+\*bar
+    error&rarr; warning: cannot adjust line
+    &rArr; a         b
+    &rArr; c       d
+</pre></div></div>
+
+<p>GNU <code class="code">troff</code> first converts the line&rsquo;s tab stops into unbreakable
+horizontal movements, then breaks after &lsquo;<samp class="samp">b</samp>&rsquo;.  This usually isn&rsquo;t
+what you want.
+</p>
+<p>Superfluous tab characters&mdash;those that do not correspond to a tab
+stop&mdash;are ignored except for the first, which delimits the characters
+belonging to the last tab stop for right-alignment or centering.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds Z   foo\tbar\tbaz
+.ds ZZ  foo\tbar\tbazqux
+.ds ZZZ foo\tbar\tbaz\tqux
+.ta 2i 4iR
+\*Z
+.br
+\*ZZ
+.br
+\*ZZZ
+.br
+    &rArr; foo                 bar              baz
+    &rArr; foo                 bar           bazqux
+    &rArr; foo                 bar              bazqux
+</pre></div></div>
+
+<p>The first line right-aligns &ldquo;baz&rdquo; within the second tab stop.  The
+second line right-aligns &ldquo;bazqux&rdquo; within it.  The third line
+right-aligns only &ldquo;baz&rdquo; because of the additional tab character, which
+marks the end of the text occupying the last tab stop defined.
+</p>
+<p>Tab stops are associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<a class="index-entry-id" id="index-tab-stop-settings-register-_0028_002etabs_0029"></a>
+<a class="index-entry-id" id="index-_002eS-register_002c-Plan-9-alias-for-_002etabs"></a>
+<a class="index-entry-id" id="index-_002etabs-register_002c-Plan-9-alias-_0028_002eS_0029"></a>
+<p>The read-only register <code class="code">.tabs</code> contains a string
+representation of the current tab settings suitable for use as an
+argument to the <code class="code">ta</code> request.<a class="footnote" id="DOCF66" href="groff.html_fot.html#FOOT66"><sup>66</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds tab-string \n.tabs
+\*tab-string
+    &rArr; T120u
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etc"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.tc</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">c</i></span></var><a class="copiable-link" href='#index-_002etc'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-tc"></a>
+<a class="index-entry-id" id="index-tab-repetition-character-_0028tc_0029"></a>
+<a class="index-entry-id" id="index-character_002c-tab-repetition-_0028tc_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-tab-repetition-_0028tc_0029"></a>
+<p>Set the tab repetition character to the ordinary or special character
+<var class="var">c</var>; normally, no glyph is written when moving to a tab stop (and
+some output devices may output space characters to achieve this motion).
+A <em class="dfn">tab repetition character</em> causes the formatter to write as many
+instances of <var class="var">c</var> as are necessary to occupy the interval from the
+horizontal drawing position to the next tab stop.  With no argument, GNU
+<code class="code">troff</code> reverts to the default behavior.  The tab repetition
+character is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+Only a single character of <var class="var">c</var> is recognized; any excess is ignored.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002elinetabs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.linetabs</code></strong> <var class="def-var-arguments">n</var><a class="copiable-link" href='#index-_002elinetabs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-linetabs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002elinetabs_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.linetabs</code></strong><a class="copiable-link" href='#index-_005cn_005b_002elinetabs_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002elinetabs-1"></a>
+<a class="index-entry-id" id="index-tab_002c-line_002dtabs-mode"></a>
+<a class="index-entry-id" id="index-line_002dtabs-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-line_002dtabs"></a>
+<p>If <var class="var">n</var> is missing or non-zero, activate <em class="dfn">line-tabs</em>; deactivate
+it otherwise (the default).  Active line-tabs cause GNU <code class="code">troff</code>
+to compute tab distances relative to the start of the output line
+instead of the input line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de Tabs
+.  ds x a\t\c
+.  ds y b\t\c
+.  ds z c
+.  ta 1i 3i
+\\*x
+\\*y
+\\*z
+..
+.Tabs
+.br
+.linetabs
+.Tabs
+    &rArr; a         b         c
+    &rArr; a         b                   c
+</pre></div></div>
+
+<p>Line-tabs activation is associated with the environment
+(see <a class="pxref" href="Environments.html">Environments</a>).  The read-only register <code class="code">.linetabs</code>
+interpolates&nbsp;1 if line-tabs are active, and 0 otherwise.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Leaders.html" accesskey="1">Leaders</a></li>
+<li><a href="Fields.html" accesskey="2">Fields</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Character-Translations.html">Character Translations</a>, Previous: <a href="Manipulating-Spacing.html">Manipulating Spacing</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Tabs-and-Leaders.html Added

@@ -0,0 +1,87 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Tabs and Leaders (The GNU Troff Manual)</title>
+
+<meta name="description" content="Tabs and Leaders (The GNU Troff Manual)">
+<meta name="keywords" content="Tabs and Leaders (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Text.html" rel="up" title="Text">
+<link href="Input-Conventions.html" rel="next" title="Input Conventions">
+<link href="Adjustment.html" rel="prev" title="Adjustment">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Tabs-and-Leaders">
+<div class="nav-panel">
+<p>
+Next: <a href="Input-Conventions.html" accesskey="n" rel="next">Input Conventions</a>, Previous: <a href="Adjustment.html" accesskey="p" rel="prev">Adjustment</a>, Up: <a href="Text.html" accesskey="u" rel="up">Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Tabs-and-Leaders-1">5.1.6 Tabs and Leaders</h4>
+
+<a class="index-entry-id" id="index-horizontal-tab-character"></a>
+<a class="index-entry-id" id="index-tab-character"></a>
+<a class="index-entry-id" id="index-character_002c-horizontal-tab"></a>
+<a class="index-entry-id" id="index-leader-character"></a>
+<a class="index-entry-id" id="index-character_002c-leader"></a>
+<a class="index-entry-id" id="index-tab-stops"></a>
+<a class="index-entry-id" id="index-stops_002c-tab"></a>
+<p>GNU <code class="code">troff</code> translates input horizontal tab characters (&ldquo;tabs&rdquo;)
+and <kbd class="key">Control+A</kbd> characters (&ldquo;leaders&rdquo;) into movements to the next
+tab stop.  Tabs simply move to the next tab stop; leaders place enough
+periods to fill the space.  Tab stops are by default located every half
+inch measured from the drawing position corresponding to the beginning
+of the input line; see <a class="ref" href="Page-Geometry.html">Page Geometry</a>.   Tabs and leaders do not
+cause breaks and therefore do not interrupt filling.  Below, we use
+arrows &rarr; and bullets &bull; to indicate input tabs and
+leaders, respectively.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">1
+&rarr; 2 &rarr; 3 &bull; 4
+&rarr; &bull; 5
+&rArr; 1         2       3.......4         ........5
+</pre></div></div>
+
+<p>Tabs and leaders lend themselves to table construction.<a class="footnote" id="DOCF24" href="groff.html_fot.html#FOOT24"><sup>24</sup></a> The tab and leader glyphs can be
+configured, and further facilities for sophisticated table composition
+are available; see <a class="ref" href="Tabs-and-Fields.html">Tabs and Fields</a>.  There are many details to
+track when using such low-level features, so most users turn to the
+<cite class="cite">tbl<span class="r">(1)</span></cite> preprocessor to lay out tables.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Text-settings-in-ms.html Added

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Text settings in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Text settings in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Text settings in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Typographical-symbols-in-ms.html" rel="next" title="Typographical symbols in ms">
+<link href="ms-Body-Text.html" rel="prev" title="ms Body Text">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Text-settings-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="Typographical-symbols-in-ms.html" accesskey="n" rel="next">Typographical symbols</a>, Previous: <a href="ms-Body-Text.html" accesskey="p" rel="prev">Body Text</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Text-settings-1">4.6.5.1 Text settings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-text-settings"></a>
+
+<p>The <code class="code">FAM</code> string, a GNU extension, sets the font family for body
+text; the default is &lsquo;<samp class="samp">T</samp>&rsquo;.  The <code class="code">PS</code> and <code class="code">VS</code> registers
+set the type size and vertical spacing (distance between text
+baselines), respectively.  The font family and type size are ignored on
+terminal devices.  Setting these parameters before the first call of a
+heading, paragraphing, or (non-date) document description macro also
+applies them to headers, footers, and (for <code class="code">FAM</code>) footnotes.
+</p>
+<p>Which font families are available depends on the output device; as a
+convention, <code class="code">T</code> selects a serif family (&ldquo;Times&rdquo;), <code class="code">H</code> a
+sans-serif family (&ldquo;Helvetica&rdquo;), and <code class="code">C</code> a monospaced family
+(&ldquo;Courier&rdquo;).  The man page for the output driver documents its font
+repertoire.  Consult the <cite class="cite">groff<span class="r">(1)</span></cite> man page for lists of
+available output devices and their drivers.
+</p>
+<p>The hyphenation mode (as used by the <code class="code">hy</code> request) is set from the
+<code class="code">HY</code> register.  Setting <code class="code">HY</code> to &lsquo;<samp class="samp">0</samp>&rsquo; is equivalent to
+using the <code class="code">nh</code> request.  This is a Tenth Edition Research Unix
+extension.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Text.html Added

@@ -0,0 +1,81 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Text (The GNU Troff Manual)</title>
+
+<meta name="description" content="Text (The GNU Troff Manual)">
+<meta name="keywords" content="Text (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Measurements.html" rel="next" title="Measurements">
+<link href="GNU-troff-Reference.html" rel="prev" title="GNU troff Reference">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Text">
+<div class="nav-panel">
+<p>
+Next: <a href="Measurements.html" accesskey="n" rel="next">Measurements</a>, Previous: <a href="GNU-troff-Reference.html" accesskey="p" rel="prev">GNU <code class="code">troff</code> Reference</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Text-1">5.1 Text</h3>
+<a class="index-entry-id" id="index-text_002c-GNU-troff-processing"></a>
+
+<p><abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> was designed to take input as it would be
+composed on a typewriter, including the teletypewriters used as early
+computer terminals, and relieve the user drafting a document of concern
+with details like line length, hyphenation breaking, and the achievement
+of straight margins.  Early in its development, the program gained the
+ability to prepare output for a phototypesetter; a document could then
+be prepared for output to either a teletypewriter, a phototypesetter, or
+both.  GNU <code class="code">troff</code> continues this tradition of permitting an author
+to compose a single master version of a document which can then be
+rendered for a variety of output formats or devices.
+</p>
+<p><code class="code">roff</code> input files contain text interspersed with instructions to
+control the formatter.  Even in the absence of such instructions, GNU
+<code class="code">troff</code> still processes its input in several ways, by filling,
+hyphenating, breaking, and adjusting it, and supplementing it with
+inter-sentence space.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Filling.html" accesskey="1">Filling</a></li>
+<li><a href="Sentences.html" accesskey="2">Sentences</a></li>
+<li><a href="Hyphenation.html" accesskey="3">Hyphenation</a></li>
+<li><a href="Breaking.html" accesskey="4">Breaking</a></li>
+<li><a href="Adjustment.html" accesskey="5">Adjustment</a></li>
+<li><a href="Tabs-and-Leaders.html" accesskey="6">Tabs and Leaders</a></li>
+<li><a href="Requests-and-Macros.html" accesskey="7">Requests and Macros</a></li>
+<li><a href="Macro-Packages.html" accesskey="8">Macro Packages</a></li>
+<li><a href="Input-Encodings.html" accesskey="9">Input Encodings</a></li>
+<li><a href="Input-Conventions.html">Input Conventions</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/The-Implicit-Page-Trap.html Added

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>The Implicit Page Trap (The GNU Troff Manual)</title>
+
+<meta name="description" content="The Implicit Page Trap (The GNU Troff Manual)">
+<meta name="keywords" content="The Implicit Page Trap (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Vertical-Position-Traps.html" rel="up" title="Vertical Position Traps">
+<link href="Diversion-Traps.html" rel="next" title="Diversion Traps">
+<link href="Page-Location-Traps.html" rel="prev" title="Page Location Traps">
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="The-Implicit-Page-Trap">
+<div class="nav-panel">
+<p>
+Next: <a href="Diversion-Traps.html" accesskey="n" rel="next">Diversion Traps</a>, Previous: <a href="Page-Location-Traps.html" accesskey="p" rel="prev">Page Location Traps</a>, Up: <a href="Vertical-Position-Traps.html" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="The-Implicit-Page-Trap-1">5.28.1.2 The Implicit Page Trap</h4>
+<a class="index-entry-id" id="index-implicit-trap"></a>
+<a class="index-entry-id" id="index-trap_002c-implicit"></a>
+
+<a class="index-entry-id" id="index-page-break-2"></a>
+<a class="index-entry-id" id="index-break_002c-page-2"></a>
+<a class="index-entry-id" id="index-page-ejection-2"></a>
+<a class="index-entry-id" id="index-ejection_002c-page-2"></a>
+<p>If, after starting GNU <code class="code">troff</code> without loading a macro package, you
+use the <code class="code">ptr</code> request to dump a list of the active traps to the
+standard error stream,<a class="footnote" id="DOCF109" href="groff.html_fot.html#FOOT109"><sup>109</sup></a>  nothing is reported.
+Yet the <code class="code">.t</code> register will report a steadily decreasing value with
+every output line your document produces, and once the value of
+<code class="code">.t</code> gets to within <code class="code">.V</code> of zero, you will notice that
+something trap-like happens&mdash;the page is ejected, a new one begins, and
+the value of <code class="code">.t</code> becomes large once more.
+</p>
+<p>This <em class="dfn">implicit page trap</em> always exists in the top-level
+diversion;<a class="footnote" id="DOCF110" href="groff.html_fot.html#FOOT110"><sup>110</sup></a> it works like a trap in some
+ways but not others.  Its purpose is to eject the current page and start
+the next one.  It has no name, so it cannot be moved or deleted with
+<code class="code">wh</code> or <code class="code">ch</code> requests.  You cannot hide it by placing another
+trap at its location, and can move it only by redefining the page length
+with <code class="code">pl</code>.  Its operation is suppressed when vertical page traps
+are disabled with GNU <code class="code">troff</code>&rsquo;s <code class="code">vpt</code> request.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Traps.html Added

@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Diversions.html" rel="next" title="Diversions">
+<link href="Deferring-Output.html" rel="prev" title="Deferring Output">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="Diversions.html" accesskey="n" rel="next">Diversions</a>, Previous: <a href="Deferring-Output.html" accesskey="p" rel="prev">Deferring Output</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Traps-1">5.28 Traps</h3>
+<a class="index-entry-id" id="index-traps"></a>
+
+<p><em class="dfn">Traps</em> are locations in the output or conditions on the input that,
+when reached or fulfilled, call a specified macro.  These traps can
+occur at a given location on the page, at a given location in the
+current diversion (together, these are known as <i class="slanted">vertical
+position traps</i>), at a blank line, at a line with leading space
+characters, after a quantity of input lines, or at the end of input.
+Macros called by traps are passed no arguments.
+<a class="index-entry-id" id="index-planting-a-trap"></a>
+<a class="index-entry-id" id="index-trap_002c-planting"></a>
+Setting a trap is also called <em class="dfn">planting</em> one.
+<a class="index-entry-id" id="index-trap_002c-springing"></a>
+<a class="index-entry-id" id="index-springing-a-trap"></a>
+It is said that a trap is <em class="dfn">sprung</em> if its condition is fulfilled.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Vertical-Position-Traps.html" accesskey="1">Vertical Position Traps</a></li>
+<li><a href="Input-Line-Traps.html" accesskey="2">Input Line Traps</a></li>
+<li><a href="Blank-Line-Traps.html" accesskey="3">Blank Line Traps</a></li>
+<li><a href="Leading-Space-Traps.html" accesskey="4">Leading Space Traps</a></li>
+<li><a href="End_002dof_002dinput-Traps.html" accesskey="5">End-of-input Traps</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Tutorial-for-Macro-Users.html Added

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Tutorial for Macro Users (The GNU Troff Manual)</title>
+
+<meta name="description" content="Tutorial for Macro Users (The GNU Troff Manual)">
+<meta name="keywords" content="Tutorial for Macro Users (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="index.html" rel="up" title="Top">
+<link href="Major-Macro-Packages.html" rel="next" title="Major Macro Packages">
+<link href="Invoking-groff.html" rel="prev" title="Invoking groff">
+
+
+</head>
+
+<body lang="en">
+<div class="chapter-level-extent" id="Tutorial-for-Macro-Users">
+<div class="nav-panel">
+<p>
+Next: <a href="Major-Macro-Packages.html" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="Invoking-groff.html" accesskey="p" rel="prev">Invoking <code class="code">groff</code></a>, Up: <a href="index.html" accesskey="u" rel="up">GNU <code class="code">troff</code></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h2 class="chapter" id="Tutorial-for-Macro-Users-1">3 Tutorial for Macro Users</h2>
+<a class="index-entry-id" id="index-tutorial-for-macro-users"></a>
+<a class="index-entry-id" id="index-macros_002c-tutorial-for-users"></a>
+<a class="index-entry-id" id="index-user_0027s-tutorial-for-macros"></a>
+<a class="index-entry-id" id="index-user_0027s-macro-tutorial"></a>
+
+<p>Most users of the <code class="code">roff</code> language employ a macro package to format
+their documents.  Successful macro packages ease the composition
+process; their users need not have mastered the full formatting
+language, nor understand features like diversions, traps, and
+environments.  This chapter aims to familiarize you with basic concepts
+and mechanisms common to many macro packages (like &ldquo;displays&rdquo;).  If
+you prefer a meticulous and comprehensive presentation, try <a class="ref" href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> instead.
+</p>
+
+
+
+<ul class="mini-toc">
+<li><a href="Basics.html" accesskey="1">Basics</a></li>
+<li><a href="Common-Features.html" accesskey="2">Common Features</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Typeface-and-decoration.html Added

@@ -0,0 +1,212 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Typeface and decoration (The GNU Troff Manual)</title>
+
+<meta name="description" content="Typeface and decoration (The GNU Troff Manual)">
+<meta name="keywords" content="Typeface and decoration (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Lists-in-ms.html" rel="next" title="Lists in ms">
+<link href="Headings-in-ms.html" rel="prev" title="Headings in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Typeface-and-decoration">
+<div class="nav-panel">
+<p>
+Next: <a href="Lists-in-ms.html" accesskey="n" rel="next">Lists</a>, Previous: <a href="Headings-in-ms.html" accesskey="p" rel="prev">Headings</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Typeface-and-decoration-1">4.6.5.5 Typeface and decoration</h4>
+
+<p>The <samp class="file">ms</samp> macros provide a variety of ways to style text.
+Attend closely to the ordering of arguments labeled <var class="var">pre</var> and
+<var class="var">post</var>, which is not intuitive.  Support for <var class="var">pre</var>
+arguments is a GNU extension.<a class="footnote" id="DOCF10" href="groff.html_fot.html#FOOT10"><sup>10</sup></a>
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B-_005bms_005d"></a>
+<p>Style <var class="var">text</var> in <b class="b">bold</b>, followed by <var class="var">post</var> in the previous
+font style without intervening space, and preceded by <var class="var">pre</var>
+similarly.  Without arguments, <samp class="file">ms</samp> styles subsequent text in bold
+until the next paragraphing, heading, or no-argument typeface macro
+call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eR-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.R</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eR-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-R-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use the roman style (upright text of normal weight)
+instead of bold.  Argument recognition is a GNU extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.I</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-I-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use an <i class="i">italic</i> or oblique style instead of bold.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BI</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eBI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BI-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use a bold italic or bold oblique style instead of
+upright bold.  This is a Tenth Edition Research Unix extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eCW-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CW</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span> <span class="r"><i class="slanted">pre</i></span></var><a class="copiable-link" href='#index-_002eCW-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CW-_005bms_005d"></a>
+<p>As <code class="code">B</code>, but use a <code class="t">constant-width</code> (monospaced) roman typeface
+instead of bold.  This is a Tenth Edition Research Unix extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eBX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BX</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span></var><a class="copiable-link" href='#index-_002eBX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BX-_005bms_005d"></a>
+<p>Typeset <var class="var">text</var> and draw a box around it.  On terminal devices,
+reverse video is used instead.  If you want <var class="var">text</var> to contain space,
+use unbreakable space or horizontal motion escape sequences (<code class="code">\~</code>,
+<code class="code">\<kbd class="key">SP</kbd></code>, <code class="code">\^</code>, <code class="code">\|</code>, <code class="code">\0</code> or <code class="code">\h</code>).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eUL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.UL</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">text</i></span> <span class="r"><i class="slanted">post</i></span></var><a class="copiable-link" href='#index-_002eUL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-UL-_005bms_005d"></a>
+<p>Typeset <var class="var">text</var> with an underline.  <var class="var">post</var>, if present, is set
+after <var class="var">text</var> with no intervening space.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eLG"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LG</code></strong><a class="copiable-link" href='#index-_002eLG'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LG-_005bms_005d"></a>
+<p>Set subsequent text in larger type (two points larger than the
+current size) until the next type size, paragraphing, or heading macro
+call.  You can specify this macro multiple times to enlarge the type
+size as needed.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eSM"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.SM</code></strong><a class="copiable-link" href='#index-_002eSM'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SM-_005bms_005d"></a>
+<p>Set subsequent text in smaller type (two points smaller than the current
+size) until the next type size, paragraphing, or heading macro call.
+You can specify this macro multiple times to reduce the type size as
+needed.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eNL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.NL</code></strong><a class="copiable-link" href='#index-_002eNL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-NL-_005bms_005d"></a>
+<p>Set subsequent text at the normal type size (the amount in the <code class="code">PS</code>
+register).
+</p></dd></dl>
+
+<p><var class="var">pre</var> and <var class="var">post</var> arguments are typically used to simplify the
+attachment of punctuation to styled words.  When <var class="var">pre</var> is used,
+a hyphenation control escape sequence <code class="code">\%</code> that would ordinarily
+start <var class="var">text</var> must start <var class="var">pre</var> instead to have the desired
+effect.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">The CS course's students found one C language keyword
+.CW static ) \%(
+most troublesome.
+</pre></div>
+</td></tr></table>
+
+<p>The foregoing example produces output as follows.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted"><span class="r">The CS course&rsquo;s students found one C language keyword (<code class="t">static</code>)
+most troublesome.</span>
+</pre></div>
+</td></tr></table>
+
+<p>You can use the output line continuation escape sequence <code class="code">\c</code> to
+achieve the same result (see <a class="pxref" href="Line-Continuation.html">Line Continuation</a>).  It is also
+portable to older <samp class="file">ms</samp> implementations.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">The CS course's students found one C language keyword
+\%(\c
+.CW \%static )
+most troublesome.
+</pre></div>
+</td></tr></table>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> also offers strings to begin and end super- and
+subscripting.  These are GNU extensions.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007b_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*{</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007b_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007b-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005b_007d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*}</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007d-_005bms_005d"></a>
+<p>Begin and end superscripting, respectively.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003c_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*&lt;</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003c_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003c-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005b_003e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*&gt;</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003e-_005bms_005d"></a>
+<p>Begin and end subscripting, respectively.
+</p></dd></dl>
+
+<p>Rather than calling the <code class="code">CW</code> macro, in <code class="code">groff</code> <samp class="file">ms</samp> you
+might prefer to change the font family to Courier by setting the
+<code class="code">FAM</code> string to &lsquo;<samp class="samp">C</samp>&rsquo;.  You can then use all four style macros
+above, returning to the default family (Times) with &lsquo;<samp class="samp">.ds FAM T</samp>&rsquo;.
+Because changes to <code class="code">FAM</code> take effect only at the next paragraph,
+<code class="code">CW</code> remains useful to &ldquo;inline&rdquo; a change to the font family,
+similarly to the practice of this document in noting syntactical
+elements of <samp class="file">ms</samp> and <code class="code">groff</code>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Lists-in-ms.html">Lists</a>, Previous: <a href="Headings-in-ms.html">Headings</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Typographical-symbols-in-ms.html Added

@@ -0,0 +1,80 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Typographical symbols in ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="Typographical symbols in ms (The GNU Troff Manual)">
+<meta name="keywords" content="Typographical symbols in ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="Paragraphs-in-ms.html" rel="next" title="Paragraphs in ms">
+<link href="Text-settings-in-ms.html" rel="prev" title="Text settings in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="Typographical-symbols-in-ms">
+<div class="nav-panel">
+<p>
+Next: <a href="Paragraphs-in-ms.html" accesskey="n" rel="next">Paragraphs</a>, Previous: <a href="Text-settings-in-ms.html" accesskey="p" rel="prev">Text settings</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Typographical-symbols">4.6.5.2 Typographical symbols</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-obtaining-typographical-symbols"></a>
+
+<p><samp class="file">ms</samp> provides a few strings to obtain typographical symbols not
+easily entered with the keyboard.  These and many others are available
+as special character escape sequences&mdash;see the <cite class="cite">groff_char<span class="r">(7)</span></cite>
+man page.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*-</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002d-_005bms_005d"></a>
+<p>Interpolate an em dash.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bQ_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Q</code></strong><a class="copiable-link" href='#index-_005c_002a_005bQ_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Q-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bU_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*U</code></strong><a class="copiable-link" href='#index-_005c_002a_005bU_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-U-_005bms_005d"></a>
+<p>Interpolate typographer&rsquo;s quotation marks where available, and neutral
+double quotes otherwise.  <code class="code">\*Q</code> is the left quote and <code class="code">\*U</code>
+the right.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Using-Escape-Sequences.html Added

@@ -0,0 +1,206 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Using Escape Sequences (The GNU Troff Manual)</title>
+
+<meta name="description" content="Using Escape Sequences (The GNU Troff Manual)">
+<meta name="keywords" content="Using Escape Sequences (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Formatter-Instructions.html" rel="up" title="Formatter Instructions">
+<link href="Delimiters.html" rel="next" title="Delimiters">
+<link href="Calling-Macros.html" rel="prev" title="Calling Macros">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Using-Escape-Sequences">
+<div class="nav-panel">
+<p>
+Next: <a href="Delimiters.html" accesskey="n" rel="next">Delimiters</a>, Previous: <a href="Calling-Macros.html" accesskey="p" rel="prev">Calling Macros</a>, Up: <a href="Formatter-Instructions.html" accesskey="u" rel="up">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Using-Escape-Sequences-1">5.6.4 Using Escape Sequences</h4>
+<a class="index-entry-id" id="index-using-escape-sequences"></a>
+<a class="index-entry-id" id="index-escape-sequences"></a>
+
+<p>Whereas requests must occur on control lines, escape sequences can occur
+intermixed with text and may appear in arguments to requests, macros,
+and other escape sequences.
+<a class="index-entry-id" id="index-_005c"></a>
+An escape sequence is introduced by the escape character, a backslash
+<code class="code">\</code> (but see the <code class="code">ec</code> request below).  The next character
+selects the escape&rsquo;s function.
+</p>
+<p>Escape sequences vary in length.  Some take an argument, and of those,
+some have different syntactical forms for a one-character,
+two-character, or arbitrary-length argument.  Others accept <em class="emph">only</em>
+an arbitrary-length argument.  In the former scheme, a one-character
+argument follows the function character immediately, an opening
+parenthesis &lsquo;<samp class="samp">(</samp>&rsquo; introduces a two-character argument (no closing
+parenthesis is used), and an argument of arbitrary length is enclosed in
+brackets &lsquo;<samp class="samp"></samp>&rsquo;.  In the latter scheme, the user selects a delimiter
+character.  A few escape sequences are idiosyncratic, and support both
+of the foregoing conventions (<code class="code">\s</code>), designate their own
+termination sequence (<code class="code">\?</code>), consume input until the next newline
+(<code class="code">\!</code>, <code class="code">\&quot;</code>, <code class="code">\#</code>), or support an additional modifier
+character (<code class="code">\s</code> again, and <code class="code">\n</code>).  As with requests, use of
+some escape sequences in source documents may interact poorly with a
+macro package you use; consult its documentation to learn of &ldquo;safe&rdquo;
+sequences or alternative facilities it provides to achieve the desired
+result.
+</p>
+<p>If an escape character is followed by a character that does not
+identify a defined operation, the escape character is ignored (producing
+a diagnostic of the &lsquo;<samp class="samp">escape</samp>&rsquo; warning category, which is not enabled
+by default) and the following character is processed normally.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">$ groff -Tps -ww
+.nr N 12
+.ds co white
+.ds animal elephant
+I have \fI\nN \*(co \*animals,\f
+said \P.\&amp;\~Pseudo Pachyderm.
+    error&rarr; warning: escape character ignored before 'P'
+    &rArr; I have <i class="slanted">12 white elephants,</i> said P. Pseudo Pachyderm.
+</pre></div></div>
+
+<p>Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.  This rule affords flexibility in
+using escape sequences to construct parameters to other escape
+sequences.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds family C\&quot; Courier
+.ds style I\&quot; oblique
+Choice a typeface \f(\*family\*stylewisely.
+    &rArr; Choose a typeface <i class="slanted">wisely.</i>
+</pre></div></div>
+
+<p>In the above, the syntax form &lsquo;<samp class="samp">\f(</samp>&rsquo; accepts only two characters for
+an argument; the example works because the subsequent escape sequences
+are interpolated before the selection escape sequence argument is
+processed, and strings <code class="code">family</code> and <code class="code">style</code> interpolate one
+character each.<a class="footnote" id="DOCF46" href="groff.html_fot.html#FOOT46"><sup>46</sup></a>
+</p>
+<p>The escape character is nearly always interpreted when encountered; it
+is therefore desirable to have a way to interpolate it, disable it, or
+change it.
+</p>
+<a class="index-entry-id" id="index-formatting-the-escape-character-_0028_005ce_0029"></a>
+<a class="index-entry-id" id="index-escape-character_002c-formatting-_0028_005ce_0029"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005ce-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\e</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005ce-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005ce"></a>
+<p>Interpolate the escape character.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-formatting-a-backslash-glyph-_0028_005c_005brs_005d_0029"></a>
+<a class="index-entry-id" id="index-backslash-glyph_002c-formatting-_0028_005c_005brs_005d_0029"></a>
+<p>The <code class="code">\rs</code> special character escape sequence formats a backslash
+glyph.  In macro and string definitions, the input sequences <code class="code">\\</code>
+and <code class="code">\E</code> defer interpretation of escape sequences.  See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eeo"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.eo</code></strong><a class="copiable-link" href='#index-_002eeo'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-eo"></a>
+<a class="index-entry-id" id="index-disabling-_005c-_0028eo_0029"></a>
+<a class="index-entry-id" id="index-_005c_002c-disabling-_0028eo_0029"></a>
+<p>Disable the escape mechanism except in copy mode.  Once this request is
+invoked, no input character is recognized as starting an escape
+sequence in interpretation mode.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eec"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ec</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">o</i></span></var><a class="copiable-link" href='#index-_002eec'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ec"></a>
+<a class="index-entry-id" id="index-escape-character_002c-changing-_0028ec_0029"></a>
+<a class="index-entry-id" id="index-character_002c-escape_002c-changing-_0028ec_0029"></a>
+<p>Recognize the ordinary character&nbsp;<var class="var">o</var> as the escape character.
+If&nbsp;<var class="var">o</var> is absent or invalid, the default escape character
+&lsquo;<samp class="samp">\</samp>&rsquo; is selected.
+</p></dd></dl>
+
+<p>Switching escape sequence interpretation off to define a macro and back
+on afterward can obviate the need to double the escape character within
+the definition.  See <a class="xref" href="Writing-Macros.html">Writing Macros</a>.  This technique is not available
+if your macro needs to interpolate values at the time it is
+<em class="emph">defined</em>&mdash;but many do not.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.\&quot; simplified `BR` macro from the man(7) macro package
+.eo
+.de BR
+.  ds result \&amp;
+.  while (\n.$ &gt;= 2) \{\
+.    as result \fB\$1\fR\$2\&quot;
+.    shift 2
+.  \}
+.  if \n.$ .as result \fB\$1\&quot;
+\*result
+.  rm result
+.  ft R
+..
+.ec
+</pre></div></div>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eecs"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ecs</code></strong><a class="copiable-link" href='#index-_002eecs'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ecs"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eecr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ecr</code></strong><a class="copiable-link" href='#index-_002eecr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ecr"></a>
+<p>The <code class="code">ecs</code> request stores the escape character for recall with
+<code class="code">ecr</code>.  <code class="code">ecr</code> sets the escape character to &lsquo;<samp class="samp">\</samp>&rsquo; if none
+has been saved.
+</p>
+<p>Use these requests together to temporarily change the escape character.
+</p></dd></dl>
+
+<p>Using a different escape character, or disabling it, when calling macros
+not under your control will likely cause errors, since GNU <code class="code">troff</code>
+has no mechanism to &ldquo;intern&rdquo; macros&mdash;that is, to convert a macro
+definition into a form independent of its
+representation.<a class="footnote" id="DOCF47" href="groff.html_fot.html#FOOT47"><sup>47</sup></a>  When a
+macro is called, its contents are interpreted literally.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Delimiters.html">Delimiters</a>, Previous: <a href="Calling-Macros.html">Calling Macros</a>, Up: <a href="Formatter-Instructions.html">Formatter Instructions</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Using-Fonts.html Added

@@ -0,0 +1,148 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Using Fonts (The GNU Troff Manual)</title>
+
+<meta name="description" content="Using Fonts (The GNU Troff Manual)">
+<meta name="keywords" content="Using Fonts (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="next" title="Manipulating Type Size and Vertical Spacing">
+<link href="Page-Control.html" rel="prev" title="Page Control">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Using-Fonts">
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="n" rel="next">Manipulating Type Size and Vertical Spacing</a>, Previous: <a href="Page-Control.html" accesskey="p" rel="prev">Page Control</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Using-Fonts-1">5.19 Using Fonts</h3>
+<a class="index-entry-id" id="index-font"></a>
+
+<a class="index-entry-id" id="index-typeface"></a>
+<a class="index-entry-id" id="index-font-family"></a>
+<a class="index-entry-id" id="index-font-style"></a>
+<a class="index-entry-id" id="index-style_002c-font"></a>
+<a class="index-entry-id" id="index-family_002c-font"></a>
+<a class="index-entry-id" id="index-text-font"></a>
+<a class="index-entry-id" id="index-special-font"></a>
+<a class="index-entry-id" id="index-unstyled-font"></a>
+<a class="index-entry-id" id="index-font_002c-text"></a>
+<a class="index-entry-id" id="index-font_002c-special"></a>
+<a class="index-entry-id" id="index-font_002c-unstyled"></a>
+<p>In digital typography, a <em class="dfn">font</em> is a collection of characters in a
+specific typeface that a device can render as glyphs at a desired
+size.<a class="footnote" id="DOCF72" href="groff.html_fot.html#FOOT72"><sup>72</sup></a>  A <code class="code">roff</code> formatter can change typefaces at any
+point in the text.  The basic faces are a set of <em class="dfn">styles</em> combining
+upright and slanted shapes with normal and heavy stroke weights:
+&lsquo;<samp class="samp">R</samp>&rsquo;, &lsquo;<samp class="samp">I</samp>&rsquo;, &lsquo;<samp class="samp">B</samp>&rsquo;, and &lsquo;<samp class="samp">BI</samp>&rsquo;&mdash;these stand for
+<i class="slanted">roman</i>, <i class="slanted">italic</i>, <i class="slanted">bold</i>, and
+<i class="slanted">bold-italic</i>.  For linguistic text, GNU <code class="code">troff</code> groups
+typefaces into <em class="dfn">families</em> containing each of these
+styles.<a class="footnote" id="DOCF73" href="groff.html_fot.html#FOOT73"><sup>73</sup></a>  A <em class="dfn">text font</em> is thus often a family
+combined with a style, but it need not be: consider the <code class="code">ps</code> and
+<code class="code">pdf</code> devices&rsquo; <code class="code">ZCMI</code> (Zapf Chancery Medium italic)&mdash;often,
+no other style of Zapf Chancery Medium is provided.  On typesetting
+devices, at least one <em class="dfn">special font</em> is available, comprising
+<em class="dfn">unstyled</em> glyphs for mathematical operators and other purposes.
+</p>
+<a class="index-entry-id" id="index-font-description-file"></a>
+<a class="index-entry-id" id="index-description-file_002c-font"></a>
+<a class="index-entry-id" id="index-file_002c-font-description"></a>
+<a class="index-entry-id" id="index-font-metrics"></a>
+<a class="index-entry-id" id="index-metrics_002c-font"></a>
+<a class="index-entry-id" id="index-mounting-position"></a>
+<a class="index-entry-id" id="index-mounting-position-1"></a>
+<a class="index-entry-id" id="index-position_002c-mounting"></a>
+<p>Like <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, GNU <code class="code">troff</code> does not itself load
+or manipulate a digital font file;<a class="footnote" id="DOCF74" href="groff.html_fot.html#FOOT74"><sup>74</sup></a> instead it
+works with a <em class="dfn">font description file</em> that characterizes it,
+including its glyph repertoire and the <em class="dfn">metrics</em> (dimensions) of
+each glyph.<a class="footnote" id="DOCF75" href="groff.html_fot.html#FOOT75"><sup>75</sup></a>  This
+information permits the formatter to accurately place glyphs with
+respect to each other.  Before using a font description, the formatter
+associates it with a <em class="dfn">mounting position</em>, a place in an ordered list
+of available typefaces.
+<a class="index-entry-id" id="index-abstract-font-style"></a>
+<a class="index-entry-id" id="index-font-style_002c-abstract"></a>
+<a class="index-entry-id" id="index-style_002c-font_002c-abstract"></a>
+So that a document need not be strongly coupled to a specific font
+family, in GNU <code class="code">troff</code> an output device can associate a style in
+the abstract sense with a mounting position.  Thus the default family
+can be combined with a style dynamically, producing a <em class="dfn">resolved font
+name</em>.
+</p>
+<p>Fonts often have trademarked names, and even Free Software fonts can
+require renaming upon modification.  <code class="code">groff</code> maintains a
+convention that a device&rsquo;s serif font family is given the name &lsquo;<samp class="samp">T</samp>&rsquo;
+(&ldquo;Times&rdquo;), its sans-serif family &lsquo;<samp class="samp">H</samp>&rsquo; (&ldquo;Helvetica&rdquo;), and its
+monospaced family &lsquo;<samp class="samp">C</samp>&rsquo; (&ldquo;Courier&rdquo;).  Historical inertia has driven
+<code class="code">groff</code>&rsquo;s font identifiers to short uppercase abbreviations of font
+names, as with &lsquo;<samp class="samp">TR</samp>&rsquo;, &lsquo;<samp class="samp">TI</samp>&rsquo;, &lsquo;<samp class="samp">TB</samp>&rsquo;, &lsquo;<samp class="samp">TBI</samp>&rsquo;, and a
+special font &lsquo;<samp class="samp">S</samp>&rsquo;.
+</p>
+<p>The default family used with abstract styles can be changed at any time;
+initially, it is &lsquo;<samp class="samp">T</samp>&rsquo;.  Typically, abstract styles are arranged in
+the first four mounting positions in the order shown above.  The default
+mounting position, and therefore style, is always &lsquo;<samp class="samp">1</samp>&rsquo; (&lsquo;<samp class="samp">R</samp>&rsquo;).
+By issuing appropriate formatter instructions, you can override these
+defaults before your document writes its first glyph.
+</p>
+<a class="index-entry-id" id="index-graphic-renditions"></a>
+<a class="index-entry-id" id="index-renditions_002c-graphic"></a>
+<a class="index-entry-id" id="index-character-cell-attributes"></a>
+<a class="index-entry-id" id="index-attributes_002c-character-cell"></a>
+<a class="index-entry-id" id="index-cell_002c-character_002c-attributes"></a>
+<p>Terminal output devices cannot change font families and lack special
+fonts.  They support style changes by overstriking, or by altering
+ISO&nbsp;6429/ECMA-48 <em class="dfn">graphic renditions</em> (character cell
+attributes).
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Selecting-Fonts.html" accesskey="1">Selecting Fonts</a></li>
+<li><a href="Font-Families.html" accesskey="2">Font Families</a></li>
+<li><a href="Font-Positions.html" accesskey="3">Font Positions</a></li>
+<li><a href="Using-Symbols.html" accesskey="4">Using Symbols</a></li>
+<li><a href="Character-Classes.html" accesskey="5">Character Classes</a></li>
+<li><a href="Special-Fonts.html" accesskey="6">Special Fonts</a></li>
+<li><a href="Artificial-Fonts.html" accesskey="7">Artificial Fonts</a></li>
+<li><a href="Ligatures-and-Kerning.html" accesskey="8">Ligatures and Kerning</a></li>
+<li><a href="Italic-Corrections.html" accesskey="9">Italic Corrections</a></li>
+<li><a href="Dummy-Characters.html">Dummy Characters</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a>, Previous: <a href="Page-Control.html">Page Control</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Using-Fractional-Type-Sizes.html Added

@@ -0,0 +1,172 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Using Fractional Type Sizes (The GNU Troff Manual)</title>
+
+<meta name="description" content="Using Fractional Type Sizes (The GNU Troff Manual)">
+<meta name="keywords" content="Using Fractional Type Sizes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Manipulating-Type-Size-and-Vertical-Spacing.html" rel="up" title="Manipulating Type Size and Vertical Spacing">
+<link href="Changing-the-Type-Size.html" rel="prev" title="Changing the Type Size">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Using-Fractional-Type-Sizes">
+<div class="nav-panel">
+<p>
+Previous: <a href="Changing-the-Type-Size.html" accesskey="p" rel="prev">Changing the Type Size</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html" accesskey="u" rel="up">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Using-Fractional-Type-Sizes-1">5.20.3 Using Fractional Type Sizes</h4>
+<a class="index-entry-id" id="index-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-fractional-point-sizes"></a>
+<a class="index-entry-id" id="index-type-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-point-sizes_002c-fractional"></a>
+<a class="index-entry-id" id="index-sizes_002c-fractional-type"></a>
+
+<p>AT&amp;T <code class="code">troff</code> interpreted all type size measurements in points.
+Combined with integer arithmetic, this design choice made it impossible
+to support, for instance, ten and a half-point type.  In GNU
+<code class="code">troff</code>, an output device can select a scaling factor that
+subdivides a point into &ldquo;scaled points&rdquo;.  A type size expressed in
+scaled points can thus represent a non-integral type size.
+</p>
+<a class="index-entry-id" id="index-s-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-s"></a>
+<a class="index-entry-id" id="index-scaling-unit-s"></a>
+<a class="index-entry-id" id="index-z-scaling-unit"></a>
+<a class="index-entry-id" id="index-unit_002c-scaling_002c-z"></a>
+<a class="index-entry-id" id="index-scaling-unit-z"></a>
+<a class="index-entry-id" id="index-ps-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-cs-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-tkf-request_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-_005cH_002c-with-fractional-type-sizes"></a>
+<a class="index-entry-id" id="index-_005cs_002c-with-fractional-type-sizes"></a>
+<p>A <em class="dfn">scaled point</em> is equal to <em class="math">1/<var class="var">sizescale</var></em> points, where
+<var class="var">sizescale</var> is specified in the device description file <samp class="file">DESC</samp>,
+and defaults to&nbsp;1.<a class="footnote" id="DOCF85" href="groff.html_fot.html#FOOT85"><sup>85</sup></a>  Requests and escape sequences in GNU <code class="code">troff</code> interpret
+arguments that represent a type size in scaled points, which the
+formatter multiplies by <var class="var">sizescale</var> and converts to an integer.
+Arguments treated in this way comprise those to the escape sequences
+<code class="code">\H</code> and <code class="code">\s</code>, to the request <code class="code">ps</code>, the third argument to
+the <code class="code">cs</code> request, and the second and fourth arguments to the
+<code class="code">tkf</code> request.  Scaled points may be specified explicitly with the
+<code class="code">z</code> scaling unit.
+</p>
+<p>For example, if <var class="var">sizescale</var> is&nbsp;1000, then a scaled point is one
+thousandth of a point.  The request &lsquo;<samp class="samp">.ps 10.5</samp>&rsquo; is synonymous with
+&lsquo;<samp class="samp">.ps 10.5z</samp>&rsquo; and sets the type size to 10,500&nbsp;scaled points, or
+10.5&nbsp;points.  Consequently, in GNU <code class="code">troff</code>, the register
+<code class="code">.s</code> can interpolate a non-integral type size.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002eps_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.ps</code></strong><a class="copiable-link" href='#index-_005cn_005b_002eps_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002eps-3"></a>
+<p>This read-only register interpolates the type size in scaled points; it
+is associated with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p></dd></dl>
+
+<p>It makes no sense to use the &lsquo;<samp class="samp">z</samp>&rsquo; scaling unit in a numeric
+expression whose default scaling unit is neither &lsquo;<samp class="samp">u</samp>&rsquo; nor &lsquo;<samp class="samp">z</samp>&rsquo;,
+so GNU <code class="code">troff</code> disallows this.  Similarly, it is nonsensical to use
+a scaling unit other than &lsquo;<samp class="samp">z</samp>&rsquo; or &lsquo;<samp class="samp">u</samp>&rsquo; in a numeric expression
+whose default scaling unit is &lsquo;<samp class="samp">z</samp>&rsquo;, and so GNU <code class="code">troff</code>
+disallows this as well.
+</p>
+<p>Another GNU <code class="code">troff</code> scaling unit, &lsquo;<samp class="samp">s</samp>&rsquo;, multiplies by the
+number of basic units in a scaled point.  Thus, &lsquo;<samp class="samp">\n.pss</samp>&rsquo; is equal
+to &lsquo;<samp class="samp">1m</samp>&rsquo; by definition.  Do not confuse the &lsquo;<samp class="samp">s</samp>&rsquo; and &lsquo;<samp class="samp">z</samp>&rsquo;
+scaling units.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005b_002epsr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.psr</code></strong><a class="copiable-link" href='#index-_005cn_005b_002epsr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002epsr"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002esr_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.sr</code></strong><a class="copiable-link" href='#index-_005cn_005b_002esr_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002esr"></a>
+<a class="index-entry-id" id="index-last_002drequested-type-size-registers-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-type-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-last_002drequested-point-size-registers-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-point-size-registers_002c-last_002drequested-_0028_002epsr_002c-_002esr_0029"></a>
+<a class="index-entry-id" id="index-_002eps-register_002c-in-comparison-with-_002epsr"></a>
+<a class="index-entry-id" id="index-_002es-register_002c-in-comparison-with-_002esr"></a>
+<p>Output devices may be limited in the type sizes they can employ.  The
+<code class="code">.s</code> and <code class="code">.ps</code> registers represent the type size selected by
+the output driver as it understands a device&rsquo;s capability.  The last
+<em class="emph">requested</em> type size is interpolated in scaled points by the
+read-only register <code class="code">.psr</code> and in points as a decimal fraction by
+the read-only string-valued register <code class="code">.sr</code>.  Both are associated
+with the environment (see <a class="pxref" href="Environments.html">Environments</a>).
+</p>
+<p>For example, if a type size of 10.95 points is requested, and the
+nearest size permitted by a <code class="code">sizes</code> request (or by the <code class="code">sizes</code>
+or <code class="code">sizescale</code> directives in the device&rsquo;s <samp class="file">DESC</samp> file) is 11
+points, the output driver uses the latter value.
+</p></dd></dl>
+
+<p>The <code class="code">\s</code> escape sequence offers the following syntax forms that
+work with fractional type sizes and accept scaling units.  You may of
+course give them integral arguments.  The delimited forms need not use
+the neutral apostrophe; see <a class="ref" href="Delimiters.html">Delimiters</a>.
+</p>
+<dl class="table">
+<dt><code class="code">\s<var class="var">n</var></code></dt>
+<dt><code class="code">\s'<var class="var">n</var>'</code></dt>
+<dd><p>Set the type size to <var class="var">n</var>&nbsp;scaled points; <var class="var">n</var>&nbsp;is a
+numeric expression with a default scaling unit of &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p>
+</dd>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dt><code class="code">\s+<var class="var">n</var></code></dt>
+<dt><code class="code">\s-<var class="var">n</var></code></dt>
+<dt><code class="code">\s'+<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s'-<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s+'<var class="var">n</var>'</code></dt>
+<dt><code class="code">\s-'<var class="var">n</var>'</code></dt>
+<dd><p>Increase or decrease the type size by <var class="var">n</var>&nbsp;scaled points;
+<var class="var">n</var>&nbsp;is a numeric expression (which may start with a minus sign)
+with a default scaling unit of &lsquo;<samp class="samp">z</samp>&rsquo;.
+</p></dd>
+</dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Changing-the-Type-Size.html">Changing the Type Size</a>, Up: <a href="Manipulating-Type-Size-and-Vertical-Spacing.html">Manipulating Type Size and Vertical Spacing</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Using-Symbols.html Added

@@ -0,0 +1,632 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Using Symbols (The GNU Troff Manual)</title>
+
+<meta name="description" content="Using Symbols (The GNU Troff Manual)">
+<meta name="keywords" content="Using Symbols (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Using-Fonts.html" rel="up" title="Using Fonts">
+<link href="Character-Classes.html" rel="next" title="Character Classes">
+<link href="Font-Positions.html" rel="prev" title="Font Positions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Using-Symbols">
+<div class="nav-panel">
+<p>
+Next: <a href="Character-Classes.html" accesskey="n" rel="next">Character Classes</a>, Previous: <a href="Font-Positions.html" accesskey="p" rel="prev">Font Positions</a>, Up: <a href="Using-Fonts.html" accesskey="u" rel="up">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Using-Symbols-1">5.19.4 Using Symbols</h4>
+<a class="index-entry-id" id="index-using-symbols"></a>
+<a class="index-entry-id" id="index-symbols_002c-using"></a>
+
+<a class="index-entry-id" id="index-glyph"></a>
+<a class="index-entry-id" id="index-character"></a>
+<a class="index-entry-id" id="index-glyph_002c-distinguished-from-character"></a>
+<a class="index-entry-id" id="index-character_002c-distinguished-from-glyph"></a>
+<a class="index-entry-id" id="index-ligature"></a>
+<p>A <em class="dfn">glyph</em> is a graphical representation of a <em class="dfn">character</em>.  While
+a character is an abstraction of semantic information, a glyph is
+something that can be seen on screen or paper.  A character has many
+possible representation forms (for example, the character &lsquo;A&rsquo; can be
+written in an upright or slanted typeface, producing distinct
+glyphs).  Sometimes, a sequence of characters map to a single glyph:
+this is a <em class="dfn">ligature</em>&mdash;the most common is &lsquo;fi&rsquo;.
+</p>
+<p>Space characters never become glyphs in GNU <code class="code">troff</code>.  If not
+discarded (as when trailing on text lines), they are represented by
+horizontal motions in the output.
+</p>
+<a class="index-entry-id" id="index-symbol"></a>
+<a class="index-entry-id" id="index-special-fonts"></a>
+<a class="index-entry-id" id="index-fonts"></a>
+<a class="index-entry-id" id="index-DESC-2"></a>
+<a class="index-entry-id" id="index-special-request_002c-and-glyph-search-order"></a>
+<a class="index-entry-id" id="index-fspecial-request_002c-and-glyph-search-order"></a>
+<p>A <em class="dfn">symbol</em> is simply a named glyph.  Within <code class="code">gtroff</code>, all glyph
+names of a particular font are defined in its font file.  If the user
+requests a glyph not available in this font, <code class="code">gtroff</code> looks up an
+ordered list of <em class="dfn">special fonts</em>.  By default, the PostScript output
+device supports the two special fonts &lsquo;<samp class="samp">SS</samp>&rsquo; (slanted symbols) and
+&lsquo;<samp class="samp">S</samp>&rsquo; (symbols) (the former is looked up before the latter).  Other
+output devices use different names for special fonts.  Fonts mounted
+with the <code class="code">fonts</code> keyword in the <samp class="file">DESC</samp> file are globally
+available.  To install additional special fonts locally (i.e., for a
+particular font), use the <code class="code">fspecial</code> request.
+</p>
+<p>Here are the exact rules how <code class="code">gtroff</code> searches a given symbol:
+</p>
+<ul class="itemize mark-bullet">
+<li>If the symbol has been defined with the <code class="code">char</code> request, use it.
+This hides a symbol with the same name in the current font.
+
+</li><li>Check the current font.
+
+</li><li>If the symbol has been defined with the <code class="code">fchar</code> request, use it.
+
+</li><li>Check whether the current font has a font-specific list of special
+fonts; test all fonts in the order of appearance in the last
+<code class="code">fspecial</code> call if appropriate.
+
+</li><li>If the symbol has been defined with the <code class="code">fschar</code> request for the
+current font, use it.
+
+</li><li>Check all fonts in the order of appearance in the last <code class="code">special</code>
+call.
+
+</li><li>If the symbol has been defined with the <code class="code">schar</code> request, use it.
+
+</li><li>As a last resort, consult all fonts loaded up to now for special fonts
+and check them, starting with the lowest font number.  This can
+sometimes lead to surprising results since the <code class="code">fonts</code> line in
+the <samp class="file">DESC</samp> file often contains empty positions, which are filled
+later on.  For example, consider the following:
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">fonts 3 0 0 FOO
+</pre></div></div>
+
+<p>This mounts font <code class="code">foo</code> at font position&nbsp;3.  We assume that
+<code class="code">FOO</code> is a special font, containing glyph <code class="code">foo</code>, and that no
+font has been loaded yet.  The line
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.fspecial BAR BAZ
+</pre></div></div>
+
+<p>makes font <code class="code">BAZ</code> special only if font <code class="code">BAR</code> is active.  We
+further assume that <code class="code">BAZ</code> is really a special font, i.e., the font
+description file contains the <code class="code">special</code> keyword, and that it also
+contains glyph <code class="code">foo</code> with a special shape fitting to font
+<code class="code">BAR</code>.  After executing <code class="code">fspecial</code>, font <code class="code">BAR</code> is loaded
+at font position&nbsp;1, and <code class="code">BAZ</code> at position&nbsp;2.
+</p>
+<p>We now switch to a new font <code class="code">XXX</code>, trying to access glyph
+<code class="code">foo</code> that is assumed to be missing.  There are neither
+font-specific special fonts for <code class="code">XXX</code> nor any other fonts made
+special with the <code class="code">special</code> request, so <code class="code">gtroff</code> starts the
+search for special fonts in the list of already mounted fonts, with
+increasing font positions.  Consequently, it finds <code class="code">BAZ</code> before
+<code class="code">FOO</code> even for <code class="code">XXX</code>, which is not the intended behaviour.
+</p></li></ul>
+
+<p>See <a class="xref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>, and <a class="ref" href="Special-Fonts.html">Special Fonts</a>, for
+more details.
+</p>
+<a class="index-entry-id" id="index-list-of-special-characters-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-special-characters_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-characters_002c-special_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-available-glyphs_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<a class="index-entry-id" id="index-glyphs_002c-available_002c-list-of-_0028groff_005fchar_00287_0029-man-page_0029"></a>
+<p>The <cite class="cite">groff_char<span class="r">(7)</span></cite> man page houses a complete list of
+predefined special character names, but the availability of any as a
+glyph is device- and font-dependent.  For example, say
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">man -Tdvi groff_char &gt; groff_char.dvi
+</pre></div></div>
+
+<p>to obtain those available with the DVI device and default font
+configuration.<a class="footnote" id="DOCF77" href="groff.html_fot.html#FOOT77"><sup>77</sup></a>  If you want to use an additional macro package to change
+the fonts used, <code class="code">groff</code> (or <code class="code">gtroff</code>) must be run directly.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">groff -Tdvi -mec -man groff_char.7 &gt; groff_char.dvi
+</pre></div></div>
+
+<a class="index-entry-id" id="index-composite-glyph-names"></a>
+<a class="index-entry-id" id="index-glyph-names_002c-composite"></a>
+<a class="index-entry-id" id="index-groff-glyph-list-_0028GGL_0029"></a>
+<a class="index-entry-id" id="index-GGL-_0028groff-glyph-list_0029"></a>
+<a class="index-entry-id" id="index-Adobe-Glyph-List-_0028AGL_0029"></a>
+<p>Special character names not listed in <cite class="cite">groff_char<span class="r">(7)</span></cite> are
+derived algorithmically, using a simplified version of the Adobe Glyph
+List (AGL) algorithm, which is described in
+<a class="uref" href="https://github.com/adobe-type-tools/agl-aglfn">https://github.com/adobe-type-tools/agl-aglfn</a>.  The (frozen)
+set of names that can&rsquo;t be derived algorithmically is called the
+<em class="dfn"><code class="code">groff</code> glyph list (GGL)</em>.
+</p>
+<ul class="itemize mark-bullet">
+<li>A glyph for Unicode character U+<var class="var">XXXX</var><var class="var">X</var><var class="var">X</var>, which is
+not a composite character is named
+<code class="code">u<var class="var">XXXX</var><span class="r"></span><var class="var">X</var><span class="r"></span><var class="var">X</var><span class="r"></span></code>.  <var class="var">X</var> must be an
+uppercase hexadecimal digit.  Examples: <code class="code">u1234</code>, <code class="code">u008E</code>,
+<code class="code">u12DB8</code>.  The largest Unicode value is 0x10FFFF.  There must be at
+least four <code class="code">X</code> digits; if necessary, add leading zeroes (after the
+&lsquo;<samp class="samp">u</samp>&rsquo;).  No zero padding is allowed for character codes greater than
+0xFFFF.  Surrogates (i.e., Unicode values greater than 0xFFFF
+represented with character codes from the surrogate area U+D800-U+DFFF)
+are not allowed either.
+
+</li><li>A glyph representing more than a single input character is named
+
+<div class="display">
+<pre class="display-preformatted">&lsquo;<samp class="samp">u</samp>&rsquo; <var class="var">component1</var> &lsquo;<samp class="samp">_</samp>&rsquo; <var class="var">component2</var> &lsquo;<samp class="samp">_</samp>&rsquo; <var class="var">component3</var> &hellip;
+</pre></div>
+
+<p>Example: <code class="code">u0045_0302_0301</code>.
+</p>
+<p>For simplicity, all Unicode characters that are composites must be
+maximally decomposed to NFD;<a class="footnote" id="DOCF78" href="groff.html_fot.html#FOOT78"><sup>78</sup></a> for example,
+<code class="code">u00CA_0301</code> is not a valid glyph name since U+00CA (<small class="sc">LATIN
+CAPITAL LETTER E WITH CIRCUMFLEX</small>) can be further decomposed into U+0045
+(<small class="sc">LATIN CAPITAL LETTER E</small>) and U+0302 (<small class="sc">COMBINING CIRCUMFLEX
+ACCENT</small>).  <code class="code">u0045_0302_0301</code> is thus the glyph name for U+1EBE,
+<small class="sc">LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND ACUTE</small>.
+</p>
+</li><li>groff maintains a table to decompose all algorithmically derived glyph
+names that are composites itself.  For example, <code class="code">u0100</code> (<small class="sc">LATIN
+LETTER A WITH MACRON</small>) is automatically decomposed into
+<code class="code">u0041_0304</code>.  Additionally, a glyph name of the GGL is preferred
+to an algorithmically derived glyph name; <code class="code">groff</code> also
+automatically does the mapping.  Example: The glyph <code class="code">u0045_0302</code> is
+mapped to <code class="code">^E</code>.
+
+</li><li>glyph names of the GGL can&rsquo;t be used in composite glyph names; for
+example, <code class="code">^E_u0301</code> is invalid.
+</li></ul>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0028nm"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\(</code><span class="r"><i class="slanted">nm</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0028nm'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c-1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_005bname_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\</code><span class="r"><i class="slanted">name</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005bname_005d'> &para;</a></span></dt>
+<dt class="deffnx def-cmd-deffn" id="index-_005c_005bbase_002dglyph-combining_002dcomponent-_2026_005d"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\</code><span class="r"><i class="slanted">base-glyph combining-component &hellip;</i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005bbase_002dglyph-combining_002dcomponent-_2026_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0028"></a>
+<a class="index-entry-id" id="index-_005c_005b"></a>
+<p>Typeset a special character <var class="var">name</var> (two-character name <var class="var">nm</var>) or
+a composite glyph consisting of <var class="var">base-glyph</var> overlaid with one or
+more <var class="var">combining-component</var>s.  For example, &lsquo;<samp class="samp">\A ho</samp>&rsquo; is a
+capital letter &ldquo;A&rdquo; with a &ldquo;hook accent&rdquo; (ogonek).
+</p>
+<p>There is no special syntax for one-character names&mdash;the analogous form
+&lsquo;<samp class="samp">\<var class="var">n</var></samp>&rsquo; would collide with other escape sequences.  However, the
+four escape sequences <code class="code">\'</code>, <code class="code">\-</code>, <code class="code">\_</code>, and <code class="code">\`</code>,
+are translated on input to the special character escape sequences
+<code class="code">\aa</code>, <code class="code">\-</code>, <code class="code">\ul</code>, and <code class="code">\ga</code>, respectively.
+</p>
+<p>A special character name of length one is not the same thing as an
+ordinary character: that is, the character <code class="code">a</code> is not the same as
+<code class="code">\a</code>.
+</p>
+<p>If <var class="var">name</var> is undefined, a warning in category &lsquo;<samp class="samp">char</samp>&rsquo; is
+produced and the escape is ignored.  See <a class="xref" href="Warnings.html">Warnings</a>, for information
+about the enablement and suppression of warnings.
+</p>
+<p>GNU <code class="code">troff</code> resolves <code class="code">\<span class="r">&hellip;</span></code> with more than a single
+component as follows:
+</p>
+<ul class="itemize mark-bullet">
+<li>Any component that is found in the GGL is converted to the
+<code class="code">u<var class="var">XXXX</var></code> form.
+
+</li><li>Any component <code class="code">u<var class="var">XXXX</var></code> that is found in the list of
+decomposable glyphs is decomposed.
+
+</li><li>The resulting elements are then concatenated with &lsquo;<samp class="samp">_</samp>&rsquo; in between,
+dropping the leading &lsquo;<samp class="samp">u</samp>&rsquo; in all elements but the first.
+</li></ul>
+
+<p>No check for the existence of any component (similar to <code class="code">tr</code>
+request) is done.
+</p>
+<p>Examples:
+</p>
+<dl class="table">
+<dt><code class="code">\A ho</code></dt>
+<dd><p>&lsquo;<samp class="samp">A</samp>&rsquo; maps to <code class="code">u0041</code>, &lsquo;<samp class="samp">ho</samp>&rsquo; maps to <code class="code">u02DB</code>, thus the
+final glyph name would be <code class="code">u0041_02DB</code>.  This is not the expected
+result: the ogonek glyph &lsquo;<samp class="samp">ho</samp>&rsquo; is a spacing ogonek, but for a
+proper composite a non-spacing ogonek (U+0328) is necessary.  Looking
+into the file <samp class="file">composite.tmac</samp>, one can find &lsquo;<samp class="samp">.composite&nbsp;ho&nbsp;u0328</samp>&rsquo;, which changes the mapping of &lsquo;<samp class="samp">ho</samp>&rsquo; while a composite glyph
+name is constructed, causing the final glyph name to be
+<code class="code">u0041_0328</code>.
+</p>
+</dd>
+<dt><code class="code">\^E u0301</code></dt>
+<dt><code class="code">\^E aa</code></dt>
+<dt><code class="code">\E a^ aa</code></dt>
+<dt><code class="code">\E ^ <code class="code">'</code></code></dt>
+<dd><p>&lsquo;<samp class="samp">^E</samp>&rsquo; maps to <code class="code">u0045_0302</code>, thus the final glyph name is
+<code class="code">u0045_0302_0301</code> in all forms (assuming proper calls of the
+<code class="code">composite</code> request).
+</p></dd>
+</dl>
+
+<p>It is not possible to define glyphs with names like &lsquo;<samp class="samp">A&nbsp;ho</samp>&rsquo;
+within a <code class="code">groff</code> font file.  This is not really a limitation;
+instead, you have to define <code class="code">u0041_0328</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cC_0027xxx_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\C<code class="code">'</code></code><span class="r"><i class="slanted">xxx</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cC_0027xxx_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cC"></a>
+<a class="index-entry-id" id="index-named-character-_0028_005cC_0029"></a>
+<a class="index-entry-id" id="index-character_002c-named-_0028_005cC_0029"></a>
+<p>Typeset the glyph of the special character <var class="var">xxx</var>.  Normally, it is
+more convenient to use <code class="code">\<var class="var">xxx</var></code>, but <code class="code">\C</code> has some
+advantages: it is compatible with <abbr class="acronym">AT&amp;T</abbr> device-independent
+<code class="code">troff</code> (and therefore available in compatibility
+mode<a class="footnote" id="DOCF79" href="groff.html_fot.html#FOOT79"><sup>79</sup></a>) and can interpolate special
+characters with &lsquo;<samp class="samp"></samp>&rsquo; in their names.  The delimiter need not be
+a neutral apostrophe; see <a class="ref" href="Delimiters.html">Delimiters</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecomposite"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.composite</code></strong> <var class="def-var-arguments">id1 id2</var><a class="copiable-link" href='#index-_002ecomposite'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-composite"></a>
+<a class="index-entry-id" id="index-composite_002etmac"></a>
+<p>Map special character name <var class="var">id1</var> to <var class="var">id2</var> if <var class="var">id1</var> is used
+in <code class="code">\...</code> with more than one component.  See above for examples.
+This is a strict rewriting of the special character name; no check is
+performed for the existence of a glyph for either.  A set of default
+mappings for many accents can be found in the file
+<samp class="file">composite.tmac</samp>, loaded by the default <samp class="file">troffrc</samp> at startup.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cN_0027n_0027"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\N<code class="code">'</code></code><span class="r"><i class="slanted">n</i></span><code class="t"><code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005cN_0027n_0027'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005cN"></a>
+<a class="index-entry-id" id="index-numbered-glyph-_0028_005cN_0029-1"></a>
+<a class="index-entry-id" id="index-glyph_002c-numbered-_0028_005cN_0029-1"></a>
+<a class="index-entry-id" id="index-char-request_002c-used-with-_005cN"></a>
+<a class="index-entry-id" id="index-Unicode-1"></a>
+<p>Typeset the glyph with code&nbsp;<var class="var">n</var> in the current font
+(<code class="code">n</code>&nbsp;is <em class="emph">not</em> the input character code).  The number
+<var class="var">n</var>&nbsp;can be any non-negative decimal integer.  Most devices only
+have glyphs with codes between 0 and&nbsp;255; the Unicode output device
+uses codes in the range 0&ndash;65535.  If the current font does not contain
+a glyph with that code, special fonts are <em class="emph">not</em> searched.  The
+<code class="code">\N</code> escape sequence can be conveniently used in conjunction with
+the <code class="code">char</code> request:
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.char \phone \fZD\N'37'
+</pre></div></div>
+
+<a class="index-entry-id" id="index-DESC-3"></a>
+<a class="index-entry-id" id="index-unnamed-glyphs"></a>
+<a class="index-entry-id" id="index-glyphs_002c-unnamed"></a>
+<p>The code of each glyph is given in the fourth column in the font
+description file after the <code class="code">charset</code> command.  It is possible to
+include unnamed glyphs in the font description file by using a name of
+&lsquo;<samp class="samp">---</samp>&rsquo;; the <code class="code">\N</code> escape sequence is the only way to use these.
+</p>
+<p>No kerning is applied to glyphs accessed with <code class="code">\N</code>.  The delimiter
+need not be a neutral apostrophe; see <a class="ref" href="Delimiters.html">Delimiters</a>.
+</p></dd></dl>
+
+<p>A few escape sequences are also special characters.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0027-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<code class="code">'</code></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0027-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0027"></a>
+<p>An escaped neutral apostrophe is a synonym for <code class="code">\aa</code> (acute
+accent).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_0060-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\<code class="code">`</code></code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_0060-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_0060"></a>
+<p>An escaped grave accent is a synonym for <code class="code">\ga</code> (grave accent).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002d-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\-</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_002d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_002d"></a>
+<p>An escaped hyphen-minus is a synonym for <code class="code">\-</code> (minus sign).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_005f-1"><span class="category-def">Escape&nbsp;sequence: </span><span><strong class="def-name"><code class="t">\_</code><span class="r"><i class="slanted"></i></span><code class="t"></code></strong><a class="copiable-link" href='#index-_005c_005f-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005c_005f"></a>
+<p>An escaped underscore (&ldquo;low line&rdquo;) is a synonym for <code class="code">\ul</code>
+(underrule).  On typesetting devices, the underrule is font-invariant
+and drawn lower than the underscore &lsquo;<samp class="samp">_</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ecflags"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.cflags</code></strong> <var class="def-var-arguments">n c1 c2 &hellip;</var><a class="copiable-link" href='#index-_002ecflags'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-cflags"></a>
+<a class="index-entry-id" id="index-glyph-properties-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-character-properties-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-properties-of-glyphs-_0028cflags_0029"></a>
+<a class="index-entry-id" id="index-properties-of-characters-_0028cflags_0029"></a>
+<p>Assign properties encoded by the number <var class="var">n</var> to characters <var class="var">c1</var>,
+<var class="var">c2</var>, and so on.
+</p>
+<p>Input characters, including special characters introduced by an escape,
+have certain properties associated with them.<a class="footnote" id="DOCF80" href="groff.html_fot.html#FOOT80"><sup>80</sup></a>
+These properties can be modified with this request.  The first argument
+is the sum of the desired flags and the remaining arguments are the
+characters to be assigned those properties.  Spaces between the <var class="var">cn</var>
+arguments are optional.  Any argument <var class="var">cn</var> can be a character class
+defined with the <code class="code">class</code> request rather than an individual
+character.  See <a class="xref" href="Character-Classes.html">Character Classes</a>.
+</p>
+<p>The non-negative integer <var class="var">n</var> is the sum of any of the following.
+Some combinations are nonsensical, such as &lsquo;<samp class="samp">33</samp>&rsquo; (1 + 32).
+</p>
+<dl class="table">
+<dt id='index-end_002dof_002dsentence-characters-1'><span><code class="code">1</code><a class="copiable-link" href='#index-end_002dof_002dsentence-characters-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-end_002dof_002dsentence"></a>
+<p>Recognize the character as ending a sentence if followed by a newline
+or two spaces.  Initially, characters &lsquo;<samp class="samp">.?!</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-hyphenating-characters'><span><code class="code">2</code><a class="copiable-link" href='#index-hyphenating-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-hyphenation"></a>
+<p>Enable breaks before the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, no characters have this property.
+</p>
+</dd>
+<dt id='index-_005c_002d-glyph_002c-and-cflags'><span><code class="code">4</code><a class="copiable-link" href='#index-_005c_002d-glyph_002c-and-cflags'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-hy-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-em-glyph_002c-and-cflags"></a>
+<p>Enable breaks after the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, characters &lsquo;<samp class="samp">\-\hy\em</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-overlapping-characters'><span><code class="code">8</code><a class="copiable-link" href='#index-overlapping-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-characters_002c-overlapping"></a>
+<a class="index-entry-id" id="index-ul-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-rn-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-ru-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-radicalex-glyph_002c-and-cflags"></a>
+<a class="index-entry-id" id="index-sqrtex-glyph_002c-and-cflags"></a>
+<p>Mark the glyph associated with this character as overlapping other
+instances of itself horizontally.  Initially, characters
+&lsquo;<samp class="samp">\ul\rn\ru\radicalex\sqrtex</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt id='index-br-glyph_002c-and-cflags'><span><code class="code">16</code><a class="copiable-link" href='#index-br-glyph_002c-and-cflags'> &para;</a></span></dt>
+<dd><p>Mark the glyph associated with this character as overlapping other
+instances of itself vertically.  Initially, the character &lsquo;<samp class="samp">\br</samp>&rsquo;
+has this property.
+</p>
+</dd>
+<dt id='index-transparent-characters'><span><code class="code">32</code><a class="copiable-link" href='#index-transparent-characters'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-character_002c-transparent"></a>
+<a class="index-entry-id" id="index-_0022_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_0027_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_0029_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_005d_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-_002a_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-dg-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-dd-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-rq-glyph_002c-at-end-of-sentence-1"></a>
+<a class="index-entry-id" id="index-cq-glyph_002c-at-end-of-sentence-1"></a>
+<p>Mark the character as transparent for the purpose of end-of-sentence
+recognition.  In other words, an end-of-sentence character followed by
+any number of characters with this property is treated as the end of a
+sentence if followed by a newline or two spaces.  This is the same as
+having a zero space factor in TeX.  Initially, characters
+&lsquo;<samp class="samp">&quot;')*\dg\dd\rq\cq</samp>&rsquo; have this property.
+</p>
+</dd>
+<dt><code class="code">64</code></dt>
+<dd><p>Ignore hyphenation codes of the surrounding characters.  Use this in
+combination with values 2 and&nbsp;4 (initially, no characters have this
+property).
+</p>
+<p>For example, if you need an automatic break point after the en-dash in
+numeric ranges like &ldquo;3000&ndash;5000&rdquo;, insert
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.cflags 68 \en
+</pre></div></div>
+
+<p>into your document.  However, this practice can lead to bad layout if
+done thoughtlessly; in most situations, a better solution instead of
+changing the <code class="code">cflags</code> value is to insert <code class="code">\:</code> right after the
+hyphen at the places that really need a break point.
+</p></dd>
+</dl>
+
+<p>The remaining values were implemented for East Asian language support;
+those who use alphabetic scripts exclusively can disregard them.
+</p>
+<dl class="table">
+<dt><code class="code">128</code></dt>
+<dd><p>Prohibit a line break before the character, but allow a line break after
+the character.  This works only in combination with flags 256 and 512
+and has no effect otherwise.  Initially, no characters have this
+property.
+</p>
+</dd>
+<dt><code class="code">256</code></dt>
+<dd><p>Prohibit a line break after the character, but allow a line break before
+the character.  This works only in combination with flags 128 and 512
+and has no effect otherwise.  Initially, no characters have this
+property.
+</p>
+</dd>
+<dt><code class="code">512</code></dt>
+<dd><p>Allow line break before or after the character.  This works only in
+combination with flags 128 and 256 and has no effect otherwise.
+Initially, no characters have this property.
+</p></dd>
+</dl>
+
+<p>In contrast to values 2 and&nbsp;4, the values 128, 256, and 512 work
+pairwise.  If, for example, the left character has value 512, and the
+right character 128, no break will be automatically inserted between
+them.  If we use value&nbsp;6 instead for the left character, a break
+after the character can&rsquo;t be suppressed since the neighboring character
+on the right doesn&rsquo;t get examined.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002echar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.char</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002echar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-char"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efchar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fchar</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002efchar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fchar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002efschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.fschar</code></strong> <var class="def-var-arguments">f c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002efschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-fschar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.schar</code></strong> <var class="def-var-arguments">c <span class="r"><i class="slanted">contents</i></span></var><a class="copiable-link" href='#index-_002eschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-schar"></a>
+<a class="index-entry-id" id="index-defining-character-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-fallback-character-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-character_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-character_002c-defining-fallback-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-fallback-character_002c-defining-_0028fchar_002c-fschar_002c-schar_0029"></a>
+<a class="index-entry-id" id="index-creating-new-characters-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-symbol-_0028char_0029"></a>
+<a class="index-entry-id" id="index-symbol_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-defining-glyph-_0028char_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-defining-_0028char_0029"></a>
+<a class="index-entry-id" id="index-escape-character_002c-while-defining-glyph"></a>
+<a class="index-entry-id" id="index-character_002c-escape_002c-while-defining-glyph"></a>
+<a class="index-entry-id" id="index-tr-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-cp-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-rc-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-lc-request_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005cl_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005cL_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005c_0026_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-_005ce_002c-and-glyph-definitions"></a>
+<a class="index-entry-id" id="index-hcode-request_002c-and-glyph-definitions"></a>
+<p>Define a new character or glyph&nbsp;<var class="var">c</var> to be <var class="var">contents</var>, which
+can be empty.  More precisely, <code class="code">char</code> defines a <code class="code">groff</code> object
+(or redefines an existing one) that is accessed with the
+name&nbsp;<var class="var">c</var> on input, and produces <var class="var">contents</var> on output.
+Every time glyph&nbsp;<var class="var">c</var> needs to be printed, <var class="var">contents</var> is
+processed in a temporary environment and the result is wrapped up into a
+single object.  Compatibility mode is turned off and the escape
+character is set to&nbsp;<code class="code">\</code> while <var class="var">contents</var> is processed.
+Any emboldening, constant spacing, or track kerning is applied to this
+object rather than to individual glyphs in <var class="var">contents</var>.
+</p>
+<p>An object defined by these requests can be used just like a normal glyph
+provided by the output device.  In particular, other characters can be
+translated to it with the <code class="code">tr</code> or <code class="code">trin</code> requests; it can be
+made the leader character with the <code class="code">lc</code> request; repeated patterns
+can be drawn with it using the <code class="code">\l</code> and <code class="code">\L</code> escape sequences;
+and words containing&nbsp;<var class="var">c</var> can be hyphenated correctly if the
+<code class="code">hcode</code> request is used to give the object a hyphenation code.
+</p>
+<p>There is a special anti-recursion feature: use of the object within its
+own definition is handled like a normal character (not
+defined with <code class="code">char</code>).
+</p>
+<p>The <code class="code">tr</code> and <code class="code">trin</code> requests take precedence if <code class="code">char</code>
+accesses the same symbol.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.tr XY
+X
+    &rArr; Y
+.char X Z
+X
+    &rArr; Y
+.tr XX
+X
+    &rArr; Z
+</pre></div></div>
+
+<p>The <code class="code">fchar</code> request defines a fallback glyph: <code class="code">gtroff</code> only
+checks for glyphs defined with <code class="code">fchar</code> if it cannot find the glyph
+in the current font.  <code class="code">gtroff</code> carries out this test before
+checking special fonts.
+</p>
+<p><code class="code">fschar</code> defines a fallback glyph for font&nbsp;<var class="var">f</var>:
+<code class="code">gtroff</code> checks for glyphs defined with <code class="code">fschar</code> after the
+list of fonts declared as font-specific special fonts with the
+<code class="code">fspecial</code> request, but before the list of fonts declared as global
+special fonts with the <code class="code">special</code> request.
+</p>
+<p>Finally, the <code class="code">schar</code> request defines a global fallback glyph:
+<code class="code">gtroff</code> checks for glyphs defined with <code class="code">schar</code> after the list
+of fonts declared as global special fonts with the <code class="code">special</code>
+request, but before the already mounted special fonts.
+</p>
+<p>See <a class="xref" href="Character-Classes.html">Character Classes</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002erchar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rchar</code></strong> <var class="def-var-arguments">c &hellip;</var><a class="copiable-link" href='#index-_002erchar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rchar"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002erfschar"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.rfschar</code></strong> <var class="def-var-arguments">f c &hellip;</var><a class="copiable-link" href='#index-_002erfschar'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-rfschar"></a>
+<a class="index-entry-id" id="index-removing-glyph-definition-_0028rchar_002c-rfschar_0029"></a>
+<a class="index-entry-id" id="index-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029"></a>
+<a class="index-entry-id" id="index-fallback-glyph_002c-removing-definition-_0028rchar_002c-rfschar_0029"></a>
+<p>Remove definition of each ordinary or special character <var class="var">c</var>,
+undoing the effect of a <code class="code">char</code>, <code class="code">fchar</code>, or <code class="code">schar</code>
+request.  Those supplied by font description files cannot be removed.
+Spaces and tabs may separate <var class="var">c</var>&nbsp;arguments.
+</p>
+<p>The request <code class="code">rfschar</code> removes glyph definitions defined with
+<code class="code">fschar</code> for font&nbsp;<var class="var">f</var>.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Character-Classes.html">Character Classes</a>, Previous: <a href="Font-Positions.html">Font Positions</a>, Up: <a href="Using-Fonts.html">Using Fonts</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Vertical-Position-Traps.html Added

@@ -0,0 +1,94 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Vertical Position Traps (The GNU Troff Manual)</title>
+
+<meta name="description" content="Vertical Position Traps (The GNU Troff Manual)">
+<meta name="keywords" content="Vertical Position Traps (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Traps.html" rel="up" title="Traps">
+<link href="Page-Location-Traps.html" rel="next" title="Page Location Traps">
+<link href="Traps.html" rel="prev" title="Traps">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Vertical-Position-Traps">
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Location-Traps.html" accesskey="n" rel="next">Page Location Traps</a>, Previous: <a href="Traps.html" accesskey="p" rel="prev">Traps</a>, Up: <a href="Traps.html" accesskey="u" rel="up">Traps</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Vertical-Position-Traps-1">5.28.1 Vertical Position Traps</h4>
+<a class="index-entry-id" id="index-vertical-position-traps"></a>
+<a class="index-entry-id" id="index-traps_002c-vertical-position"></a>
+
+<p>A <em class="dfn">vertical position trap</em> calls a macro when the formatter&rsquo;s
+vertical drawing position reaches or passes, in the downward direction,
+a certain location on the output page or in a diversion.  Its
+applications include setting page headers and footers, body text in
+multiple columns, and footnotes.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002evpt"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.vpt</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">flag</i></span></var><a class="copiable-link" href='#index-_002evpt'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-vpt"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005cn_005b_002evpt_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\n.vpt</code></strong><a class="copiable-link" href='#index-_005cn_005b_002evpt_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002evpt-1"></a>
+<a class="index-entry-id" id="index-enabling-vertical-position-traps-_0028vpt_0029"></a>
+<a class="index-entry-id" id="index-vertical-position-traps_002c-enabling-_0028vpt_0029"></a>
+<a class="index-entry-id" id="index-vertical-position-trap-enable-register-_0028_002evpt_0029"></a>
+<p>Enable vertical position traps if <var class="var">flag</var> is non-zero or absent;
+disable them otherwise.  Vertical position traps are those set by the
+<code class="code">wh</code> request or by <code class="code">dt</code> within a diversion.  The parameter
+that controls whether vertical position traps are enabled is global.
+Initially, vertical position traps are enabled.  The current value is
+stored in the <code class="code">.vpt</code> read-only register.
+</p>
+<a class="index-entry-id" id="index-page-break_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-break_002c-page_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-page-ejection_002c-prevented-by-vpt"></a>
+<a class="index-entry-id" id="index-ejection_002c-page_002c-prevented-by-vpt"></a>
+<p>A page can&rsquo;t be ejected if <code class="code">vpt</code> is set to zero; see <a class="ref" href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a>.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Page-Location-Traps.html" accesskey="1">Page Location Traps</a></li>
+<li><a href="The-Implicit-Page-Trap.html" accesskey="2">The Implicit Page Trap</a></li>
+<li><a href="Diversion-Traps.html" accesskey="3">Diversion Traps</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Warnings.html Added

@@ -0,0 +1,246 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Warnings (The GNU Troff Manual)</title>
+
+<meta name="description" content="Warnings (The GNU Troff Manual)">
+<meta name="keywords" content="Warnings (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Debugging.html" rel="up" title="Debugging">
+<link href="Debugging.html" rel="prev" title="Debugging">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="Warnings">
+<div class="nav-panel">
+<p>
+Previous: <a href="Debugging.html" accesskey="p" rel="prev">Debugging</a>, Up: <a href="Debugging.html" accesskey="u" rel="up">Debugging</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Warnings-1">5.37.1 Warnings</h4>
+<a class="index-entry-id" id="index-warnings-1"></a>
+
+<p>Warning diagnostics emitted by GNU <code class="code">troff</code> are divided into named,
+numbered categories.  The name associated with each warning category is
+used by the <samp class="option">-w</samp> and <samp class="option">-W</samp> options.  Each category is also
+assigned a power of two; the sum of enabled category values is used by
+the <code class="code">warn</code> request and the <code class="code">.warn</code> register.
+</p>
+<p>Warnings of each category are produced under the following
+circumstances.
+</p>
+<a class="index-entry-id" id="index-categories_002c-warning"></a>
+<a class="index-entry-id" id="index-warning-categories"></a>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">char</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">1</samp>&rsquo;</dt>
+<dd><p>No mounted font defines a glyph for the requested character.  This
+category is enabled by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">number</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">2</samp>&rsquo;</dt>
+<dd><p>An invalid numeric expression was encountered.  This category is enabled
+by default.
+See <a class="xref" href="Numeric-Expressions.html">Numeric Expressions</a>.
+</p>
+</dd>
+<dt id='index-filling_002c-and-break-warnings'><span>&lsquo;<samp class="samp">break</samp>&rsquo;<a class="copiable-link" href='#index-filling_002c-and-break-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">4</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-mode_002c-fill_002c-and-break-warnings"></a>
+<p>A filled output line could not be broken such that its length was less
+than the output line length &lsquo;<samp class="samp">\n.l</samp>&rsquo;.  This category is enabled by
+default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">delim</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">8</samp>&rsquo;</dt>
+<dd><p>The closing delimiter in an escape sequence was missing or mismatched.
+</p>
+</dd>
+<dt id='index-ie-request_002c-and-warnings'><span>&lsquo;<samp class="samp">el</samp>&rsquo;<a class="copiable-link" href='#index-ie-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">16</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-el-request_002c-and-warnings"></a>
+<p>The <code class="code">el</code> request was encountered with no prior corresponding
+<code class="code">ie</code> request.  See <a class="xref" href="if_002delse.html">if-else</a>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">scale</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">32</samp>&rsquo;</dt>
+<dd><p>A scaling unit inappropriate to its context was used in a numeric
+expression.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">range</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">64</samp>&rsquo;</dt>
+<dd><p>A numeric expression was out of range for its context.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">syntax</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">128</samp>&rsquo;</dt>
+<dd><p>A self-contradictory hyphenation mode was requested; an empty or
+incomplete numeric expression was encountered; an operand to a numeric
+operator was missing; an attempt was made to define a recursive, empty,
+or nonsensical character class; or a <code class="code">groff</code> extension conditional
+expression operator was used while in compatibility mode.
+</p>
+</dd>
+<dt id='index-di-request_002c-and-warnings'><span>&lsquo;<samp class="samp">di</samp>&rsquo;<a class="copiable-link" href='#index-di-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">256</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-da-request_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-box-request_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-boxa-request_002c-and-warnings"></a>
+<p>A <code class="code">di</code>, <code class="code">da</code>, <code class="code">box</code>, or <code class="code">boxa</code> request was invoked
+without an argument when there was no current diversion.
+</p>
+</dd>
+<dt id='index-de_002c-de1_002c-dei-requests_002c-and-warnings'><span>&lsquo;<samp class="samp">mac</samp>&rsquo;<a class="copiable-link" href='#index-de_002c-de1_002c-dei-requests_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">512</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-am_002c-am1_002c-ami-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-ds_002c-ds1-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-as_002c-as1-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-di-request_002c-and-warnings-1"></a>
+<a class="index-entry-id" id="index-da-request_002c-and-warnings-1"></a>
+<a class="index-entry-id" id="index-box_002c-boxa-requests_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-_005c_002a_002c-and-warnings"></a>
+<p>An undefined string, macro, or diversion was used.  When such an object
+is dereferenced, an empty one of that name is automatically created.
+So, unless it is later deleted, at most one warning is given for each.
+</p>
+<p>This warning is also emitted upon an attempt to move an unplanted trap
+macro (see <a class="pxref" href="Page-Location-Traps.html">Page Location Traps</a>).  In such cases, the unplanted macro
+is <em class="emph">not</em> dereferenced, so it is not created if it does not exist.
+</p>
+</dd>
+<dt id='index-nr-request_002c-and-warnings'><span>&lsquo;<samp class="samp">reg</samp>&rsquo;<a class="copiable-link" href='#index-nr-request_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">1024</samp>&rsquo;</dt>
+<dd><a class="index-entry-id" id="index-_005cR_002c-and-warnings"></a>
+<a class="index-entry-id" id="index-_005cn_002c-and-warnings"></a>
+<p>An undefined register was used.  When an undefined register is
+dereferenced, it is automatically defined with a value of&nbsp;0.  So,
+unless it is later deleted, at most one warning is given for each.
+</p>
+</dd>
+<dt id='index-_005ct_002c-and-warnings'><span>&lsquo;<samp class="samp">tab</samp>&rsquo;<a class="copiable-link" href='#index-_005ct_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">2048</samp>&rsquo;</dt>
+<dd><p>A tab character was encountered where a number was expected, or appeared
+in an unquoted macro argument.
+</p>
+</dd>
+<dt id='index-_005c_007d_002c-and-warnings'><span>&lsquo;<samp class="samp">right-brace</samp>&rsquo;<a class="copiable-link" href='#index-_005c_007d_002c-and-warnings'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">4096</samp>&rsquo;</dt>
+<dd><p>A right brace escape sequence <code class="code">\}</code> was encountered where a number
+was expected.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">missing</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">8192</samp>&rsquo;</dt>
+<dd><p>A request was invoked with a mandatory argument absent.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">input</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">16384</samp>&rsquo;</dt>
+<dd><p>An invalid character occurred on the input stream.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">escape</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">32768</samp>&rsquo;</dt>
+<dd><p>An unsupported escape sequence was encountered.
+</p>
+</dd>
+<dt id='index-compatibility-mode'><span>&lsquo;<samp class="samp">space</samp>&rsquo;<a class="copiable-link" href='#index-compatibility-mode'> &para;</a></span></dt>
+<dt>&lsquo;<samp class="samp">65536</samp>&rsquo;</dt>
+<dd><p>A space was missing between a request or macro and its argument.  This
+warning is produced when an undefined name longer than two characters is
+encountered and the first two characters of the name constitute a
+defined name.  No request is invoked, no macro called, and an empty
+macro is not defined.  This category is enabled by default.  It never
+occurs in compatibility mode.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">font</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">131072</samp>&rsquo;</dt>
+<dd><p>A non-existent font was selected, or the selection was ignored because a
+font selection escape sequence was used after the output line
+continuation escape sequence on an input line.  This category is enabled
+by default.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">ig</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">262144</samp>&rsquo;</dt>
+<dd><p>An invalid escape sequence occurred in input ignored using the <code class="code">ig</code>
+request.  This warning category diagnoses a condition that is an error
+when it occurs in non-ignored input.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">color</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">524288</samp>&rsquo;</dt>
+<dd><p>An undefined color was selected, an attempt was made to define a color
+using an unrecognized color space, an invalid component in a color
+definition was encountered, or an attempt was made to redefine a default
+color.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">file</samp>&rsquo;</dt>
+<dt>&lsquo;<samp class="samp">1048576</samp>&rsquo;</dt>
+<dd><p>An attempt was made to load a file that does not exist.  This category
+is enabled by default.
+</p></dd>
+</dl>
+
+<p>Two warning names group other warning categories for convenience.
+</p>
+<dl class="table">
+<dt>&lsquo;<samp class="samp">all</samp>&rsquo;</dt>
+<dd><p>All warning categories except &lsquo;<samp class="samp">di</samp>&rsquo;, &lsquo;<samp class="samp">mac</samp>&rsquo; and &lsquo;<samp class="samp">reg</samp>&rsquo;.
+This shorthand is intended to produce all warnings that are useful with
+macro packages written for <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> and its
+descendants, which have less fastidious diagnostics than GNU
+<code class="code">troff</code>.
+</p>
+</dd>
+<dt>&lsquo;<samp class="samp">w</samp>&rsquo;</dt>
+<dd><p>All warning categories.  Authors of documents and macro packages
+targeting <code class="code">groff</code> are encouraged to use this setting.
+</p></dd>
+</dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="Debugging.html">Debugging</a>, Up: <a href="Debugging.html">Debugging</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/What-Is-groff_003f.html Added

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>What Is groff? (The GNU Troff Manual)</title>
+
+<meta name="description" content="What Is groff? (The GNU Troff Manual)">
+<meta name="keywords" content="What Is groff? (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="groff-Capabilities.html" rel="next" title="groff Capabilities">
+<link href="Introduction.html" rel="prev" title="Introduction">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="What-Is-groff_003f">
+<div class="nav-panel">
+<p>
+Next: <a href="groff-Capabilities.html" accesskey="n" rel="next"><code class="code">groff</code> Capabilities</a>, Previous: <a href="Introduction.html" accesskey="p" rel="prev">Introduction</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="What-Is-groff_003f-1">1.2 What Is <code class="code">groff</code>?</h3>
+<a class="index-entry-id" id="index-what-is-groff_003f"></a>
+<a class="index-entry-id" id="index-groff_002d_002d_002dwhat-is-it_003f"></a>
+
+<p><code class="code">groff</code> (GNU <code class="code">roff</code>) is a typesetting system that reads plain
+text input files that include formatting commands to produce output in
+PostScript, PDF, HTML, DVI, or other formats, or for display to a
+terminal.  Formatting commands can be low-level typesetting primitives,
+macros from a supplied package, or user-defined macros.  All three
+approaches can be combined.
+</p>
+<p>A reimplementation and extension of the typesetter from <abbr class="acronym">AT&amp;T</abbr>
+Unix, <code class="code">groff</code> is present on most <abbr class="acronym">POSIX</abbr> systems owing to
+its long association with Unix manuals (including man pages).  It and
+its predecessor are notable for their production of several best-selling
+software engineering texts.  <code class="code">groff</code> is capable of producing
+typographically sophisticated documents while consuming minimal system
+resources.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/Writing-Macros.html Added

@@ -0,0 +1,267 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Writing Macros (The GNU Troff Manual)</title>
+
+<meta name="description" content="Writing Macros (The GNU Troff Manual)">
+<meta name="keywords" content="Writing Macros (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Page-Motions.html" rel="next" title="Page Motions">
+<link href="Conditionals-and-Loops.html" rel="prev" title="Conditionals and Loops">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="Writing-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Motions.html" accesskey="n" rel="next">Page Motions</a>, Previous: <a href="Conditionals-and-Loops.html" accesskey="p" rel="prev">Conditionals and Loops</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="Writing-Macros-1">5.24 Writing Macros</h3>
+<a class="index-entry-id" id="index-writing-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-writing"></a>
+
+<p>A <em class="dfn">macro</em> is a stored collection of text and control lines that can
+be interpolated multiple times.  Use macros to define common operations.
+Macros are called in the same way that requests are invoked.  While
+requests exist for the purpose of creating macros, simply calling an
+undefined macro, or interpolating it as a string, will cause it to be
+defined as empty.  See <a class="xref" href="Identifiers.html">Identifiers</a>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ede"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.de</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002ede'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-de"></a>
+<p>Define a macro <var class="var">name</var>, replacing the definition of any existing
+request, macro, string, or diversion called <var class="var">name</var>.  If
+<var class="var">name</var> already exists as an alias, the target of the alias is
+redefined; recall <a class="ref" href="Strings.html">Strings</a>.  GNU <code class="code">troff</code> enters copy
+mode,<a class="footnote" id="DOCF97" href="groff.html_fot.html#FOOT97"><sup>97</sup></a> storing subsequent input lines as the
+macro definition.  If the optional second argument is not specified, the
+definition ends with the control line &lsquo;<samp class="samp">..</samp>&rsquo; (two dots).
+Alternatively, <var class="var">end</var> identifies a macro whose call syntax at the
+start of a control line ends the definition of <var class="var">name</var>; <var class="var">end</var> is
+then called normally.  A macro definition must end in the same
+conditional block (if any) in which it began (see <a class="pxref" href="Conditional-Blocks.html">Conditional Blocks</a>).  Spaces or tabs are permitted after the control character in
+the line containing this ending token (either &lsquo;<samp class="samp">.</samp>&rsquo; or
+&lsquo;<samp class="samp"><var class="var">end</var></samp>&rsquo;), but a tab immediately after the token prevents its
+recognition as the end of a macro definition.  The macro <var class="var">end</var> can
+be called with arguments.<a class="footnote" id="DOCF98" href="groff.html_fot.html#FOOT98"><sup>98</sup></a>
+</p>
+<p>Here is a small example macro called &lsquo;<samp class="samp">P</samp>&rsquo; that causes a break and
+inserts some vertical space.  It could be used to separate paragraphs.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de P
+.  br
+.  sp .8v
+..
+</pre></div></div>
+
+<p>We can define one macro within another.  Attempting to nest &lsquo;<samp class="samp">..</samp>&rsquo;
+naïvely will end the outer definition because the inner definition
+isn&rsquo;t interpreted as such until the outer macro is later interpolated.
+We can use an end macro instead.  Each level of nesting should use a
+unique end macro.
+</p>
+<p>An end macro need not be defined until it is called.  This fact enables
+a nested macro definition to begin inside one macro and end inside
+another.  Consider the following example.<a class="footnote" id="DOCF99" href="groff.html_fot.html#FOOT99"><sup>99</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de m1
+.  de m2 m3
+you
+..
+.de m3
+Hello,
+Joe.
+..
+.de m4
+do
+..
+.m1
+know?
+.  m3
+What
+.m4
+.m2
+    &rArr; Hello, Joe.  What do you know?
+</pre></div></div>
+
+<p>A nested macro definition <em class="emph">can</em> be terminated with &lsquo;<samp class="samp">..</samp>&rsquo; and
+nested macros <em class="emph">can</em> reuse end macros, but these control lines must
+be escaped multiple times for each level of nesting.  The necessity of
+this escaping and the utility of nested macro definitions will become
+clearer when we employ macro parameters and consider the behavior of
+copy mode in detail.
+</p></dd></dl>
+
+<p><code class="code">de</code> defines a macro that inherits the compatibility mode
+enablement status of its context (see <a class="pxref" href="Implementation-Differences.html">Implementation Differences</a>).
+Often it is desirable to make a macro that uses <code class="code">groff</code> features
+callable from contexts where compatibility mode is on; for instance,
+when writing extensions to a historical macro package.  To achieve this,
+compatibility mode needs to be switched off while such a macro is
+interpreted&mdash;without disturbing that state when it is finished.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ede1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.de1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002ede1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-de1"></a>
+<p>The <code class="code">de1</code> request defines a macro to be interpreted with
+compatibility mode disabled.  When <var class="var">name</var> is called, compatibility
+mode enablement status is saved; it is restored when the call completes.
+Observe the extra backlash before the interpolation of register
+&lsquo;<samp class="samp">xxx</samp>&rsquo;; we&rsquo;ll explore this subject in <a class="ref" href="Copy-Mode.html">Copy Mode</a>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr xxx 12345
+.de aa
+The value of xxx is \\nxxx.
+.  br
+..
+.de1 bb
+The value of xxx is \\nxxx.
+..
+.cp 1
+.aa
+    error&rarr; warning: register '' not defined
+    &rArr; The value of xxx is 0xxx.
+.bb
+    &rArr; The value of xxx is 12345.
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002edei"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dei</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002edei'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dei"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002edei1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.dei1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002edei1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-dei1"></a>
+<p>The <code class="code">dei</code> request defines a macro with its name and end
+macro indirected through strings.  That is, it interpolates strings
+named <var class="var">name</var> and <var class="var">end</var> before performing the definition.
+</p>
+<p>The following examples are equivalent.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds xx aa
+.ds yy bb
+.dei xx yy
+</pre></div></div>
+
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de aa bb
+</pre></div></div>
+
+<p>The <code class="code">dei1</code> request bears the same relationship to <code class="code">dei</code> as
+<code class="code">de1</code> does to <code class="code">de</code>; it temporarily turns compatibility mode
+off when <var class="var">name</var> is called.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eam"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.am</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eam'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-am"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eam1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.am1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eam1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-am1"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eami"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ami</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eami'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ami"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eami1"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ami1</code></strong> <var class="def-var-arguments">name <span class="r"><i class="slanted">end</i></span></var><a class="copiable-link" href='#index-_002eami1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ami1"></a>
+<a class="index-entry-id" id="index-appending-to-a-macro-_0028am_0029"></a>
+<a class="index-entry-id" id="index-macro_002c-appending-to-_0028am_0029"></a>
+<p><code class="code">am</code> appends subsequent input lines to macro <var class="var">name</var>, extending
+its definition, and otherwise working as <code class="code">de</code> does.
+</p>
+<p>To make the previously defined &lsquo;<samp class="samp">P</samp>&rsquo; macro set indented instead of
+block paragraphs, add the necessary code to the existing macro.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.am P
+.ti +5n
+..
+</pre></div></div>
+
+<p>The other requests are analogous to their &lsquo;<samp class="samp">de</samp>&rsquo; counterparts.  The
+<code class="code">am1</code> request turns off compatibility mode during interpretation of
+the appendment.  The <code class="code">ami</code> request appends indirectly, meaning that
+strings <var class="var">name</var> and <var class="var">end</var> are interpolated with the resulting
+names used before appending.  The <code class="code">ami1</code> request is similar to
+<code class="code">ami</code>, disabling compatibility mode during interpretation of the
+appended lines.
+</p></dd></dl>
+
+<a class="index-entry-id" id="index-trace_002etmac"></a>
+<p>Using <samp class="file">trace.tmac</samp>, you can trace calls to <code class="code">de</code>,
+<code class="code">de1</code>, <code class="code">am</code>, and <code class="code">am1</code>.  You can also use the
+<code class="code">backtrace</code> request at any point desired to troubleshoot tricky
+spots (see <a class="pxref" href="Debugging.html">Debugging</a>).
+</p>
+<p>See <a class="xref" href="Strings.html">Strings</a>, for the <code class="code">als</code>, <code class="code">rm</code>, and <code class="code">rn</code> requests to
+create an alias of, remove, and rename a macro, respectively.
+</p>
+<a class="index-entry-id" id="index-object-creation"></a>
+<p>Macro identifiers share their name space with requests, strings, and
+diversions; see <a class="ref" href="Identifiers.html">Identifiers</a>.  The <code class="code">am</code>, <code class="code">as</code>, <code class="code">da</code>,
+<code class="code">de</code>, <code class="code">di</code>, and <code class="code">ds</code> requests (together with their
+variants) create a new object only if the name of the macro, diversion,
+or string is currently undefined or if it is defined as a request;
+normally, they modify the value of an existing object.  See <a class="xref" href="Strings.html#als">the
+description of the <code class="code">als</code> request</a>, for pitfalls when redefining a
+macro that is aliased.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ereturn"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.return</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">anything</i></span></var><a class="copiable-link" href='#index-_002ereturn'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-return"></a>
+<p>Exit a macro, immediately returning to the caller.  If called with an
+argument <var class="var">anything</var>, exit twice&mdash;the current macro and the macro
+one level higher.  This is used to define a wrapper macro for
+<code class="code">return</code> in <samp class="file">trace.tmac</samp>.
+</p></dd></dl>
+
+
+
+<ul class="mini-toc">
+<li><a href="Parameters.html" accesskey="1">Parameters</a></li>
+<li><a href="Copy-Mode.html" accesskey="2">Copy Mode</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Page-Motions.html">Page Motions</a>, Previous: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/als.html Added

@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html>
+
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>als (The GNU Troff Manual)</title>
+
+<meta name="description" content="als (The GNU Troff Manual)">
+<meta name="keywords" content="als (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+
+<meta http-equiv="Refresh" content="0; url=Strings.html#als">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+</head>
+
+<body lang="en">
+
+<p>The node you are looking for is at <a href="Strings.html#als">als</a>.</p>
+</body>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/groff-Capabilities.html Added

@@ -0,0 +1,91 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>groff Capabilities (The GNU Troff Manual)</title>
+
+<meta name="description" content="groff Capabilities (The GNU Troff Manual)">
+<meta name="keywords" content="groff Capabilities (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Introduction.html" rel="up" title="Introduction">
+<link href="Macro-Package-Intro.html" rel="next" title="Macro Package Intro">
+<link href="What-Is-groff_003f.html" rel="prev" title="What Is groff?">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="groff-Capabilities">
+<div class="nav-panel">
+<p>
+Next: <a href="Macro-Package-Intro.html" accesskey="n" rel="next">Macro Packages</a>, Previous: <a href="What-Is-groff_003f.html" accesskey="p" rel="prev">What Is <code class="code">groff</code>?</a>, Up: <a href="Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="groff-Capabilities-1">1.3 <code class="code">groff</code> Capabilities</h3>
+<a class="index-entry-id" id="index-groff-capabilities"></a>
+<a class="index-entry-id" id="index-capabilities-of-groff"></a>
+
+<p>GNU <code class="code">troff</code> is a typesetting document formatter; it provides a wide
+range of low-level text and page operations within the framework of a
+programming language.  These operations compose to generate footnotes,
+tables of contents, mathematical equations, diagrams, multi-column text,
+and other elements of typeset works.  Here is a survey of formatter
+features; all are under precise user control.
+</p>
+<ul class="itemize mark-bullet">
+<li>text filling, breaking, alignment to the left or right margin; centering
+
+</li><li>adjustment of inter-word space size to justify text, and of
+inter-sentence space size to suit local style conventions
+
+</li><li>automatic and manual determination of hyphenation break points
+
+</li><li>pagination
+
+</li><li>selection of any font available to the output device
+
+</li><li>adjustment of type size and vertical spacing (or &ldquo;leading&rdquo;)
+
+</li><li>configuration of line length and indentation amounts; columnation
+
+</li><li>drawing of geometric primitives (lines, arcs, polygons, circles,
+&hellip;)
+
+</li><li>setup of stroke and fill colors (where supported by the output
+device)
+
+</li><li>embedding of hyperlinks, images, document metadata, and other inclusions
+(where supported by the output device)
+</li></ul>
+
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/groff.html_fot.html Added

@@ -0,0 +1,525 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Footnotes (The GNU Troff Manual)</title>
+
+<meta name="description" content="Footnotes (The GNU Troff Manual)">
+<meta name="keywords" content="Footnotes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="element-footnotes" id="SEC_Footnotes">
+<div class="nav-panel">
+<p>
+ &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="footnotes-heading">Footnotes</h4>
+
+<h5 class="footnote-body-heading"><a id="FOOT1" href="Preprocessor-Intro.html#DOCF1">(1)</a></h5>
+<p>The &lsquo;<samp class="samp">g</samp>&rsquo; prefix is
+not used on all systems; see <a class="ref" href="Invoking-groff.html">Invoking <code class="code">groff</code></a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT2" href="Conventions-Used-in-This-Manual.html#DOCF2">(2)</a></h5>
+<p>Unix and related operating systems distinguish
+standard output and standard error streams <em class="emph">because</em> of
+<code class="code">troff</code>:
+<a class="uref" href="https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html">https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT3" href="Conventions-Used-in-This-Manual.html#DOCF3">(3)</a></h5>
+<p>See <a class="xref" href="Line-Layout.html">Line Layout</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT4" href="Invoking-groff.html#DOCF4">(4)</a></h5>
+<p>Besides <code class="code">groff</code>, <code class="code">neatroff</code> is an
+exception.</p>
+<h5 class="footnote-body-heading"><a id="FOOT5" href="Macro-Directories.html#DOCF5">(5)</a></h5>
+<p>The
+<code class="code">mso</code> request does not have these limitations.  See <a class="xref" href="I_002fO.html">I/O</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT6" href="Basics.html#DOCF6">(6)</a></h5>
+<p>The remainder of this chapter is based on
+<cite class="cite">Writing Papers with nroff using -me</cite> by Eric&nbsp;P. Allman,
+which is distributed with <code class="code">groff</code> as <samp class="file">meintro.me</samp>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT7" href="ms-Introduction.html#DOCF7">(7)</a></h5>
+<p>While manual <em class="emph">pages</em> are older, early ones used
+macros supplanted by the <samp class="file">man</samp> package of Seventh Edition Unix
+(1979).  <samp class="file">ms</samp> shipped with Sixth Edition (1975) and was documented
+by Mike Lesk in a Bell Labs internal memorandum.</p>
+<h5 class="footnote-body-heading"><a id="FOOT8" href="ms-Document-Control-Settings.html#DOCF8">(8)</a></h5>
+<p>defined in <a class="ref" href="ms-Footnotes.html">Footnotes</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT9" href="ms-Document-Description-Macros.html#DOCF9">(9)</a></h5>
+<p>Distinguish a
+document title from &ldquo;titles&rdquo;, which are what <code class="code">roff</code> systems call
+headers and footers collectively.</p>
+<h5 class="footnote-body-heading"><a id="FOOT10" href="Typeface-and-decoration.html#DOCF10">(10)</a></h5>
+<p>This idiosyncrasy arose through
+feature accretion; for example, the <code class="code">B</code> macro in Version&nbsp;6
+Unix <samp class="file">ms</samp> (1975) accepted only one argument, the text to be set in
+boldface.  By Version&nbsp;7 (1979) it recognized a second argument; in
+1990, <code class="code">groff</code> <samp class="file">ms</samp> added a &ldquo;pre&rdquo; argument, placing it third
+to avoid breaking support for older documents.</p>
+<h5 class="footnote-body-heading"><a id="FOOT11" href="ms-Footnotes.html#DOCF11">(11)</a></h5>
+<p>&ldquo;Portable Document Format Publishing with GNU
+Troff&rdquo;, <samp class="file">pdfmark.ms</samp> in the <code class="code">groff</code> distribution, uses this
+technique.</p>
+<h5 class="footnote-body-heading"><a id="FOOT12" href="ms-Footnotes.html#DOCF12">(12)</a></h5>
+<p>Unix Version&nbsp;7 <samp class="file">ms</samp>, its descendants, and GNU
+<samp class="file">ms</samp> prior to <code class="code">groff</code> version 1.23.0</p>
+<h5 class="footnote-body-heading"><a id="FOOT13" href="ms-Footnotes.html#DOCF13">(13)</a></h5>
+<p>You could reset it
+after each call to <code class="code">.1C</code>, <code class="code">.2C</code>, or <code class="code">.MC</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT14" href="Differences-from-AT_0026T-ms.html#DOCF14">(14)</a></h5>
+<p><cite class="cite">Typing Documents on the UNIX System: Using the
+-ms Macros with Troff and Nroff</cite>, M.&nbsp;E. Lesk, Bell Laboratories,
+1978</p>
+<h5 class="footnote-body-heading"><a id="FOOT15" href="Differences-from-AT_0026T-ms.html#DOCF15">(15)</a></h5>
+<p>Register values are converted to and stored as
+basic units.  See <a class="xref" href="Measurements.html">Measurements</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT16" href="Differences-from-AT_0026T-ms.html#DOCF16">(16)</a></h5>
+<p>If you redefine the <samp class="file">ms</samp> <code class="code">PT</code> macro
+and desire special treatment of certain page numbers (like &lsquo;<samp class="samp">1</samp>&rsquo;),
+you may need to handle a non-Arabic page number format, as <code class="code">groff</code>
+<samp class="file">ms</samp>&rsquo;s <code class="code">PT</code> does; see the macro package source.  <code class="code">groff</code>
+<samp class="file">ms</samp> aliases the <code class="code">PN</code> register to <code class="code">%</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT17" href="Missing-Unix-Version-7-ms-Macros.html#DOCF17">(17)</a></h5>
+<p>The removal beforehand is necessary
+because <code class="code">groff</code> <samp class="file">ms</samp> aliases these macros to a diagnostic
+macro, and you want to redefine the aliased name, not its target.</p>
+<h5 class="footnote-body-heading"><a id="FOOT18" href="Filling.html#DOCF18">(18)</a></h5>
+<p>See <a class="xref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT19" href="Filling.html#DOCF19">(19)</a></h5>
+<p><i class="slanted">Tabs</i> and <i class="slanted">leaders</i> also separate
+words.  <i class="slanted">Escape sequences</i> can function as word characters, word
+separators, or neither&mdash;the last simply have no effect on GNU
+<code class="code">troff</code>&rsquo;s idea of whether an input character is within a word.
+We&rsquo;ll discuss all of these in due course.</p>
+<h5 class="footnote-body-heading"><a id="FOOT20" href="Sentences.html#DOCF20">(20)</a></h5>
+<p>A
+well-researched jeremiad appreciated by <code class="code">groff</code> contributors on
+both sides of the sentence-spacing debate can be found at
+<a class="uref" href="https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324">https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT21" href="Sentences.html#DOCF21">(21)</a></h5>
+<p>This statement oversimplifies; there are
+escape sequences whose purpose is precisely to produce glyphs on the
+output device, and input characters that <em class="emph">aren&rsquo;t</em> part of escape
+sequences can undergo a great deal of processing before getting to the
+output.</p>
+<h5 class="footnote-body-heading"><a id="FOOT22" href="Sentences.html#DOCF22">(22)</a></h5>
+<p>The mnemonics for the special
+characters shown here are &ldquo;dagger&rdquo;, &ldquo;double dagger&rdquo;, &ldquo;right
+(double) quote&rdquo;, and &ldquo;closing (single) quote&rdquo;.  See the
+<cite class="cite">groff_char<span class="r">(7)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT23" href="Breaking.html#DOCF23">(23)</a></h5>
+<p>&ldquo;Text lines&rdquo; are defined in <a class="ref" href="Requests-and-Macros.html">Requests and Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT24" href="Tabs-and-Leaders.html#DOCF24">(24)</a></h5>
+<p>&ldquo;Tab&rdquo;
+is short for &ldquo;tabulation&rdquo;, revealing the term&rsquo;s origin as a spacing
+mechanism for table arrangement.</p>
+<h5 class="footnote-body-heading"><a id="FOOT25" href="Requests-and-Macros.html#DOCF25">(25)</a></h5>
+<p>The <code class="code">\<kbd class="key">RET</kbd></code> escape sequence can alter how an
+input line is classified; see <a class="ref" href="Line-Continuation.html">Line Continuation</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT26" href="Requests-and-Macros.html#DOCF26">(26)</a></h5>
+<p>Argument handling in
+macros is more flexible but also more complex.  See <a class="xref" href="Calling-Macros.html">Calling Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT27" href="Requests-and-Macros.html#DOCF27">(27)</a></h5>
+<p>Some escape sequences undergo
+interpolation as well.</p>
+<h5 class="footnote-body-heading"><a id="FOOT28" href="Requests-and-Macros.html#DOCF28">(28)</a></h5>
+<p>GNU <code class="code">troff</code> offers additional ones.  See <a class="xref" href="Writing-Macros.html">Writing Macros</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT29" href="Macro-Packages.html#DOCF29">(29)</a></h5>
+<p>Macro files and packages
+frequently define registers and strings as well.</p>
+<h5 class="footnote-body-heading"><a id="FOOT30" href="Input-Encodings.html#DOCF30">(30)</a></h5>
+<p>The
+<em class="emph">semantics</em> of certain punctuation code points have gotten stricter
+with the successive standards, a cause of some frustration among man
+page writers; see the <cite class="cite">groff_char<span class="r">(7)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT31" href="Input-Encodings.html#DOCF31">(31)</a></h5>
+<p>The
+DVI output device defaults to using the Computer Modern (CM) fonts;
+<samp class="file">ec.tmac</samp> loads the EC fonts instead, which provide Euro
+&lsquo;<samp class="samp">\Eu</samp>&rsquo; and per mille &lsquo;<samp class="samp">\%0</samp>&rsquo; glyphs.</p>
+<h5 class="footnote-body-heading"><a id="FOOT32" href="Input-Conventions.html#DOCF32">(32)</a></h5>
+<p>Emacs: <code class="code">fill-column: 72</code>; Vim: <code class="code">textwidth=72</code></p>
+<h5 class="footnote-body-heading"><a id="FOOT33" href="Page-Geometry.html#DOCF33">(33)</a></h5>
+<p><code class="code">groff</code> does not yet support right-to-left
+scripts.</p>
+<h5 class="footnote-body-heading"><a id="FOOT34" href="Page-Geometry.html#DOCF34">(34)</a></h5>
+<p><code class="code">groff</code>&rsquo;s terminal output devices have page
+offsets of zero.</p>
+<h5 class="footnote-body-heading"><a id="FOOT35" href="Numeric-Expressions.html#DOCF35">(35)</a></h5>
+<p>Provision is made for interpreting and
+reporting decimal fractions in certain cases.</p>
+<h5 class="footnote-body-heading"><a id="FOOT36" href="Numeric-Expressions.html#DOCF36">(36)</a></h5>
+<p>If that&rsquo;s not enough, see the <cite class="cite">groff_tmac<span class="r">(5)</span></cite>
+man page for the <samp class="file">62bit.tmac</samp> macro package.</p>
+<h5 class="footnote-body-heading"><a id="FOOT37" href="Numeric-Expressions.html#DOCF37">(37)</a></h5>
+<p>See <a class="xref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT38" href="Numeric-Expressions.html#DOCF38">(38)</a></h5>
+<p>Control structure syntax
+creates an exception to this rule, but is designed to remain useful:
+recalling our example, &lsquo;<samp class="samp">.if 1 .Underline this</samp>&rsquo; would underline only
+&ldquo;this&rdquo;, precisely.  See <a class="xref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT39" href="Numeric-Expressions.html#DOCF39">(39)</a></h5>
+<p>See <a class="xref" href="Diversions.html">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT40" href="Identifiers.html#DOCF40">(40)</a></h5>
+<p>Historically, control characters like
+ASCII STX, ETX, and BEL (<kbd class="key">Control+B</kbd>, <kbd class="key">Control+C</kbd>, and
+<kbd class="key">Control+G</kbd>) have been observed in <code class="code">roff</code> documents,
+particularly in macro packages employing them as delimiters with the
+output comparison operator to try to avoid collisions with the content
+of arbitrary user-supplied parameters (see <a class="pxref" href="Operators-in-Conditionals.html">Operators in Conditionals</a>).  We discourage this expedient; in GNU <code class="code">troff</code> it is
+unnecessary (outside of compatibility mode) because delimited arguments
+are parsed at a different input level than the surrounding context.
+See <a class="xref" href="Implementation-Differences.html">Implementation Differences</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT41" href="Identifiers.html#DOCF41">(41)</a></h5>
+<p>Consider what happens when a C1 control
+<code class="code">0x80</code>&ndash;<code class="code">0x9F</code> is necessary as a continuation byte in a UTF-8
+sequence.</p>
+<h5 class="footnote-body-heading"><a id="FOOT42" href="Control-Characters.html#DOCF42">(42)</a></h5>
+<p>Recall <a class="ref" href="Identifiers.html">Identifiers</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT43" href="Invoking-Requests.html#DOCF43">(43)</a></h5>
+<p>In compatibility
+mode, a space is not necessary after a request or macro name of two
+characters&rsquo; length.  Also, Plan&nbsp;9 <code class="code">troff</code> allows tabs to
+separate arguments.</p>
+<h5 class="footnote-body-heading"><a id="FOOT44" href="Calling-Macros.html#DOCF44">(44)</a></h5>
+<p><code class="code">\~</code> is fairly
+portable; see <a class="ref" href="Other-Differences.html">Other Differences</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT45" href="Calling-Macros.html#DOCF45">(45)</a></h5>
+<p>Strictly, you can neglect to
+close the last quoted macro argument, relying on the end of the control
+line to do so.   We consider this lethargic practice poor style.</p>
+<h5 class="footnote-body-heading"><a id="FOOT46" href="Using-Escape-Sequences.html#DOCF46">(46)</a></h5>
+<p>The omission of spaces before the comment
+escape sequences is necessary; see <a class="ref" href="Strings.html">Strings</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT47" href="Using-Escape-Sequences.html#DOCF47">(47)</a></h5>
+<p>TeX does have such a mechanism.</p>
+<h5 class="footnote-body-heading"><a id="FOOT48" href="Comments.html#DOCF48">(48)</a></h5>
+<p>This claim may be more aspirational than descriptive.</p>
+<h5 class="footnote-body-heading"><a id="FOOT49" href="Comments.html#DOCF49">(49)</a></h5>
+<p>See <a class="xref" href="Conditional-Blocks.html">Conditional Blocks</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT50" href="Comments.html#DOCF50">(50)</a></h5>
+<p>Exception: auto-incrementing registers defined outside
+the ignored region <em class="emph">will</em> be modified if interpolated with
+<code class="code">\n±</code> inside it.  See <a class="xref" href="Auto_002dincrement.html">Auto-increment</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT51" href="Auto_002dincrement.html#DOCF51">(51)</a></h5>
+<p>A negative auto-increment can be
+considered an &ldquo;auto-decrement&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT52" href="Built_002din-Registers.html#DOCF52">(52)</a></h5>
+<p>GNU <code class="code">troff</code> dynamically allocates memory for
+as many registers as required.</p>
+<h5 class="footnote-body-heading"><a id="FOOT53" href="Manipulating-Filling-and-Adjustment.html#DOCF53">(53)</a></h5>
+<p>unless diverted; see <a class="ref" href="Diversions.html">Diversions</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT54" href="Manipulating-Filling-and-Adjustment.html#DOCF54">(54)</a></h5>
+<p>See <a class="xref" href="Line-Continuation.html">Line Continuation</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT55" href="Manipulating-Filling-and-Adjustment.html#DOCF55">(55)</a></h5>
+<p>Recall <a class="ref" href="Filling.html">Filling</a> and <a class="ref" href="Sentences.html">Sentences</a> for the
+definitions of word and sentence boundaries, respectively.</p>
+<h5 class="footnote-body-heading"><a id="FOOT56" href="Manipulating-Hyphenation.html#DOCF56">(56)</a></h5>
+<p>Whether a perfect algorithm for this application is
+even possible is an unsolved problem in computer science:
+<a class="url" href="https://tug.org/docs/liang/liang-thesis.pdf">https://tug.org/docs/liang/liang-thesis.pdf</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT57" href="Manipulating-Hyphenation.html#DOCF57">(57)</a></h5>
+<p><code class="code">\%</code> itself stops marking
+hyphenation points but still produces no output glyph.</p>
+<h5 class="footnote-body-heading"><a id="FOOT58" href="Manipulating-Hyphenation.html#DOCF58">(58)</a></h5>
+<p>&ldquo;Soft&rdquo; because it appears in output
+only where a hyphenation break is performed; a &ldquo;hard&rdquo; hyphen, as in
+&ldquo;long-term&rdquo;, always appears.</p>
+<h5 class="footnote-body-heading"><a id="FOOT59" href="Manipulating-Hyphenation.html#DOCF59">(59)</a></h5>
+<p>The mode is a vector of Booleans encoded as an integer.
+To a programmer, this fact is easily deduced from the exclusive use of
+powers of two for the configuration parameters; they are computationally
+easy to &ldquo;mask off&rdquo; and compare to zero.  To almost everyone else, the
+arrangement seems recondite and unfriendly.</p>
+<h5 class="footnote-body-heading"><a id="FOOT60" href="Manipulating-Hyphenation.html#DOCF60">(60)</a></h5>
+<p>Hyphenation is
+prevented if the next page location trap is closer to the vertical
+drawing position than the next text baseline would be.  See <a class="xref" href="Page-Location-Traps.html">Page Location Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT61" href="Manipulating-Hyphenation.html#DOCF61">(61)</a></h5>
+<p>For more on localization, see the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT62" href="Manipulating-Spacing.html#DOCF62">(62)</a></h5>
+<p>See <a class="xref" href="Page-Location-Traps.html">Page Location Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT63" href="Manipulating-Spacing.html#DOCF63">(63)</a></h5>
+<p>See <a class="xref" href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT64" href="Manipulating-Spacing.html#DOCF64">(64)</a></h5>
+<p>or geometric objects; see <a class="ref" href="Drawing-Geometric-Objects.html">Drawing Geometric Objects</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT65" href="Manipulating-Spacing.html#DOCF65">(65)</a></h5>
+<p>to the top-level diversion;
+see <a class="ref" href="Diversions.html">Diversions</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT66" href="Tabs-and-Fields.html#DOCF66">(66)</a></h5>
+<p>Plan&nbsp;9 <code class="code">troff</code>
+uses the register <code class="code">.S</code> for this purpose.</p>
+<h5 class="footnote-body-heading"><a id="FOOT67" href="Leaders.html#DOCF67">(67)</a></h5>
+<p>This is pronounced to rhyme with &ldquo;feeder&rdquo;, and
+refers to how the glyphs &ldquo;lead&rdquo; the eye across the page to the
+corresponding page number or other datum.</p>
+<h5 class="footnote-body-heading"><a id="FOOT68" href="troff-and-nroff-Modes.html#DOCF68">(68)</a></h5>
+<p>A
+GNU <code class="command">nroff</code> program is available for convenience; it calls GNU
+<code class="code">troff</code> to perform the formatting.</p>
+<h5 class="footnote-body-heading"><a id="FOOT69" href="Line-Continuation.html#DOCF69">(69)</a></h5>
+<p>Historically, the <code class="code">\c</code>
+escape sequence has proven challenging to characterize.  Some sources
+say it &ldquo;connects the next input text&rdquo; (to the input line on which it
+appears); others describe it as &ldquo;interrupting&rdquo; text, on the grounds
+that a text line is interrupted without breaking, perhaps to inject a
+request invocation or macro call.</p>
+<h5 class="footnote-body-heading"><a id="FOOT70" href="Page-Layout.html#DOCF70">(70)</a></h5>
+<p>See <a class="xref" href="Traps.html">Traps</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT71" href="Page-Control.html#DOCF71">(71)</a></h5>
+<p>See <a class="xref" href="Diversions.html">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT72" href="Using-Fonts.html#DOCF72">(72)</a></h5>
+<p>Terminals and some output devices have fonts that render
+at only one or two sizes.  As examples of the latter, take the
+<code class="code">groff</code> <code class="code">lj4</code> device&rsquo;s Lineprinter, and <code class="code">lbp</code>&rsquo;s Courier
+and Elite faces.</p>
+<h5 class="footnote-body-heading"><a id="FOOT73" href="Using-Fonts.html#DOCF73">(73)</a></h5>
+<p>Font designers prepare families such that the styles
+share esthetic properties.</p>
+<h5 class="footnote-body-heading"><a id="FOOT74" href="Using-Fonts.html#DOCF74">(74)</a></h5>
+<p>Historically, the fonts
+<code class="code">troff</code>s dealt with were not Free Software or, as with the Graphic
+Systems C/A/T, did not even exist in the digital domain.</p>
+<h5 class="footnote-body-heading"><a id="FOOT75" href="Using-Fonts.html#DOCF75">(75)</a></h5>
+<p>See <a class="xref" href="Font-Description-File-Format.html">Font Description File Format</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT76" href="Font-Families.html#DOCF76">(76)</a></h5>
+<p>See <a class="xref" href="DESC-File-Format.html"><samp class="file">DESC</samp> File Format</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT77" href="Using-Symbols.html#DOCF77">(77)</a></h5>
+<p>Not all versions of the <code class="code">man</code> program
+support the <samp class="option">-T</samp> option; use the subsequent example for an
+alternative.</p>
+<h5 class="footnote-body-heading"><a id="FOOT78" href="Using-Symbols.html#DOCF78">(78)</a></h5>
+<p>This is &ldquo;Normalization Form D&rdquo;
+as documented in Unicode Standard Annex #15
+(<a class="uref" href="https://unicode.org/reports/tr15/">https://unicode.org/reports/tr15/</a>).</p>
+<h5 class="footnote-body-heading"><a id="FOOT79" href="Using-Symbols.html#DOCF79">(79)</a></h5>
+<p>See <a class="xref" href="Compatibility-Mode.html">Compatibility Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT80" href="Using-Symbols.html#DOCF80">(80)</a></h5>
+<p>Output glyphs
+don&rsquo;t&mdash;to GNU <code class="code">troff</code>, a glyph is simply a box with an index into
+a font, a given height above and depth below the baseline, and a width.</p>
+<h5 class="footnote-body-heading"><a id="FOOT81" href="Dummy-Characters.html#DOCF81">(81)</a></h5>
+<p>Opinions of this escape sequence&rsquo;s name abound.
+&ldquo;Zero-width space&rdquo; is a popular misnomer: <code class="code">roff</code> formatters do
+not treat it like a space.  Ossanna called it a &ldquo;non-printing,
+zero-width character&rdquo;, but the character causes <em class="emph">output</em> even
+though it does not &ldquo;print&rdquo;.  If no output line is pending, the dummy
+character starts one.  Contrast an empty input document with one
+containing only <code class="code">\&amp;</code>.  The former produces no output; the latter, a
+blank page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT82" href="Manipulating-Type-Size-and-Vertical-Spacing.html#DOCF82">(82)</a></h5>
+<p>In text fonts, the tallest glyphs are typically
+parentheses.  Unfortunately, in many cases the actual dimensions of the
+glyphs in a font do not closely match its declared type size!  For
+example, in the standard PostScript font families, 10-point Times sets
+better with 9-point Helvetica and 11-point Courier than if all three
+were used at 10&nbsp;points.</p>
+<h5 class="footnote-body-heading"><a id="FOOT83" href="Manipulating-Type-Size-and-Vertical-Spacing.html#DOCF83">(83)</a></h5>
+<p>Rhyme with &ldquo;sledding&rdquo;; mechanical typography
+used lead metal (Latin <em class="emph">plumbum</em>).</p>
+<h5 class="footnote-body-heading"><a id="FOOT84" href="Changing-the-Type-Size.html#DOCF84">(84)</a></h5>
+<p>The claim appears to have been true of Ossanna
+<code class="code">troff</code> for the C/A/T device; Kernighan made device-independent
+<code class="code">troff</code> more flexible.</p>
+<h5 class="footnote-body-heading"><a id="FOOT85" href="Using-Fractional-Type-Sizes.html#DOCF85">(85)</a></h5>
+<p>See <a class="xref" href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT86" href="Colors.html#DOCF86">(86)</a></h5>
+<p>also
+known vulgarly as &ldquo;ANSI colors&rdquo;</p>
+<h5 class="footnote-body-heading"><a id="FOOT87" href="Strings.html#DOCF87">(87)</a></h5>
+<p>See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT88" href="Operators-in-Conditionals.html#DOCF88">(88)</a></h5>
+<p>This refers to
+<code class="code">vtroff</code>, a translator that would convert the C/A/T output from
+early-vintage <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> to a form suitable for
+Versatec and Benson-Varian plotters.</p>
+<h5 class="footnote-body-heading"><a id="FOOT89" href="Operators-in-Conditionals.html#DOCF89">(89)</a></h5>
+<p>Strictly, letters not otherwise recognized <em class="emph">are</em> treated
+as output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan&nbsp;9
+<code class="code">troff</code> uses &lsquo;<samp class="samp">h</samp>&rsquo; to test a mode it calls <code class="code">htmlroff</code>, and
+GNU <code class="code">troff</code> may provide additional operators in the future.</p>
+<h5 class="footnote-body-heading"><a id="FOOT90" href="Operators-in-Conditionals.html#DOCF90">(90)</a></h5>
+<p>Because formatting of the comparands takes place
+in a dummy environment, vertical motions within them cannot spring
+traps.</p>
+<h5 class="footnote-body-heading"><a id="FOOT91" href="Operators-in-Conditionals.html#DOCF91">(91)</a></h5>
+<p>All
+of this is to say that the lists of output nodes created by formatting
+<var class="var">xxx</var> and <var class="var">yyy</var> must be identical.  See <a class="xref" href="Gtroff-Internals.html"><code class="code">gtroff</code> Internals</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT92" href="Operators-in-Conditionals.html#DOCF92">(92)</a></h5>
+<p>This bizarre behavior maintains compatibility with
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT93" href="Conditional-Blocks.html#DOCF93">(93)</a></h5>
+<p>See <a class="xref" href="while.html">while</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT94" href="while.html#DOCF94">(94)</a></h5>
+<p>See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT95" href="while.html#DOCF95">(95)</a></h5>
+<p>unless you redefine it</p>
+<h5 class="footnote-body-heading"><a id="FOOT96" href="while.html#DOCF96">(96)</a></h5>
+<p>&ldquo;somewhat less&rdquo; because
+things other than macro calls can be on the input stack</p>
+<h5 class="footnote-body-heading"><a id="FOOT97" href="Writing-Macros.html#DOCF97">(97)</a></h5>
+<p>See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT98" href="Writing-Macros.html#DOCF98">(98)</a></h5>
+<p>While it is possible to define and
+call a macro &lsquo;<samp class="samp">.</samp>&rsquo;, you can&rsquo;t use it as an end macro: during a macro
+definition, &lsquo;<samp class="samp">..</samp>&rsquo; is never handled as calling &lsquo;<samp class="samp">.</samp>&rsquo;, even if
+&lsquo;<samp class="samp">.de <var class="var">name</var> .</samp>&rsquo; explicitly precedes it.</p>
+<h5 class="footnote-body-heading"><a id="FOOT99" href="Writing-Macros.html#DOCF99">(99)</a></h5>
+<p>Its structure is
+adapted from, and isomorphic to, part of a solution by Tadziu Hoffman to
+the problem of reflowing text multiple times to find an optimal
+configuration for it.
+<a class="uref" href="https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html">https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html</a></p>
+<h5 class="footnote-body-heading"><a id="FOOT100" href="Parameters.html#DOCF100">(100)</a></h5>
+<p>If they were not,
+parameter interpolations would be similar to command-line
+parameters&mdash;fixed for the entire duration of a <code class="code">roff</code> program&rsquo;s
+run.  The advantage of interpolating <code class="code">\$</code> escape sequences even in
+copy mode is that they can interpolate different contents from one call
+to the next, like function parameters in a procedural language.  The
+additional escape character is the price of this power.</p>
+<h5 class="footnote-body-heading"><a id="FOOT101" href="Copy-Mode.html#DOCF101">(101)</a></h5>
+<p>Compare this to the <code class="code">\def</code> and <code class="code">\edef</code>
+commands in TeX.</p>
+<h5 class="footnote-body-heading"><a id="FOOT102" href="Copy-Mode.html#DOCF102">(102)</a></h5>
+<p>These are lightly adapted from the <code class="code">groff</code>
+implementation of the <samp class="file">ms</samp> macros.</p>
+<h5 class="footnote-body-heading"><a id="FOOT103" href="Page-Motions.html#DOCF103">(103)</a></h5>
+<p>At the
+<code class="code">grops</code> defaults of 10-point type on 12-point vertical spacing, the
+difference between half a vee and half an em can be subtle: large
+spacings like &lsquo;<samp class="samp">.vs .5i</samp>&rsquo; make it obvious.</p>
+<h5 class="footnote-body-heading"><a id="FOOT104" href="Page-Motions.html#DOCF104">(104)</a></h5>
+<p>See <a class="xref" href="Strings.html">Strings</a>, for an explanation of the trailing
+&lsquo;<samp class="samp">\&quot;</samp>&rsquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT105" href="Drawing-Geometric-Objects.html#DOCF105">(105)</a></h5>
+<p>(<var class="var">hc</var>, <var class="var">vc</var>) is adjusted to the point nearest
+the perpendicular bisector of the arc&rsquo;s chord.</p>
+<h5 class="footnote-body-heading"><a id="FOOT106" href="Page-Location-Traps.html#DOCF106">(106)</a></h5>
+<p>See <a class="xref" href="The-Implicit-Page-Trap.html">The Implicit Page Trap</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT107" href="Page-Location-Traps.html#DOCF107">(107)</a></h5>
+<p>A trap planted at &lsquo;<samp class="samp">20i</samp>&rsquo; or
+&lsquo;<samp class="samp">-30i</samp>&rsquo; will not be sprung on a page of length &lsquo;<samp class="samp">11i</samp>&rsquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT108" href="Page-Location-Traps.html#DOCF108">(108)</a></h5>
+<p>It may help to think of each trap location as
+maintaining a queue; <code class="code">wh</code> operates on the head of the queue, and
+<code class="code">ch</code> operates on its tail.  Only the trap at the head of the queue
+is visible.</p>
+<h5 class="footnote-body-heading"><a id="FOOT109" href="The-Implicit-Page-Trap.html#DOCF109">(109)</a></h5>
+<p>See <a class="xref" href="Debugging.html">Debugging</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT110" href="The-Implicit-Page-Trap.html#DOCF110">(110)</a></h5>
+<p>See <a class="xref" href="Diversions.html">Diversions</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT111" href="End_002dof_002dinput-Traps.html#DOCF111">(111)</a></h5>
+<p>While processing an
+end-of-input macro, the formatter assumes that the next page break must
+be the last; it goes into &ldquo;sudden death overtime&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT112" href="End_002dof_002dinput-Traps.html#DOCF112">(112)</a></h5>
+<p>Another, taken by the <code class="code">groff</code> <code class="code">man</code> macros, is
+to intercept <code class="code">ne</code> requests and wrap <code class="code">bp</code> ones.</p>
+<h5 class="footnote-body-heading"><a id="FOOT113" href="Diversions.html#DOCF113">(113)</a></h5>
+<p>Thus, the &ldquo;water&rdquo;
+gets &ldquo;higher&rdquo; proceeding <em class="emph">down</em> the page.</p>
+<h5 class="footnote-body-heading"><a id="FOOT114" href="Punning-Names.html#DOCF114">(114)</a></h5>
+<p>The backslash is doubled.  See <a class="xref" href="Copy-Mode.html">Copy Mode</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT115" href="Postprocessor-Access.html#DOCF115">(115)</a></h5>
+<p>that is, ISO&nbsp;646:1991-IRV or,
+popularly, &ldquo;US-ASCII&rdquo;</p>
+<h5 class="footnote-body-heading"><a id="FOOT116" href="Postprocessor-Access.html#DOCF116">(116)</a></h5>
+<p>They are bypassed because these parameters are not
+rendered as glyphs in the output; instead, they remain abstract
+characters&mdash;in a PDF bookmark or a URL, for example.</p>
+<h5 class="footnote-body-heading"><a id="FOOT117" href="Miscellaneous.html#DOCF117">(117)</a></h5>
+<p>Recall <a class="ref" href="Line-Layout.html">Line Layout</a>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT118" href="Miscellaneous.html#DOCF118">(118)</a></h5>
+<p>Historically,
+tools named <code class="command">nrchbar</code> and <code class="command">changebar</code> were developed for
+marking changes with margin characters and could be found in archives of
+the <code class="code">comp.sources.unix</code> <abbr class="acronym">USENET</abbr> group.  Some proprietary
+Unices also offer(ed) a <code class="command">diffmk</code> program.</p>
+<h5 class="footnote-body-heading"><a id="FOOT119" href="Gtroff-Internals.html#DOCF119">(119)</a></h5>
+<p>Except the
+escape sequences <code class="code">\f</code>, <code class="code">\F</code>, <code class="code">\H</code>, <code class="code">\m</code>, <code class="code">\M</code>,
+<code class="code">\R</code>, <code class="code">\s</code>, and <code class="code">\S</code>, which are processed immediately if
+not in copy mode.</p>
+<h5 class="footnote-body-heading"><a id="FOOT120" href="Compatibility-Mode.html#DOCF120">(120)</a></h5>
+<p>The
+Graphic Systems C/A/T phototypesetter (the original device target for
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>) supported only a few discrete type sizes
+in the range 6&ndash;36 points, so Ossanna contrived a special case in the
+parser to do what the user must have meant.  Kernighan warned of this in
+the 1992 revision of CSTR&nbsp;#54 (§2.3), and more recently, McIlroy
+referred to it as a &ldquo;living fossil&rdquo;.</p>
+<h5 class="footnote-body-heading"><a id="FOOT121" href="Other-Differences.html#DOCF121">(121)</a></h5>
+<p>DWB&nbsp;3.3, Solaris, Heirloom Doctools, and
+Plan&nbsp;9 <code class="code">troff</code> all support it.</p>
+<h5 class="footnote-body-heading"><a id="FOOT122" href="Other-Differences.html#DOCF122">(122)</a></h5>
+<p>Naturally, if you&rsquo;ve changed
+the escape character, you need to prefix the <code class="code">e</code> with whatever it
+is&mdash;and you&rsquo;ll likely get something other than a backslash in the
+output.</p>
+<h5 class="footnote-body-heading"><a id="FOOT123" href="Other-Differences.html#DOCF123">(123)</a></h5>
+<p>The <code class="code">rs</code> special character identifier was not
+defined in <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>&rsquo;s font description files, but is
+in those of its lineal descendant, Heirloom Doctools <code class="code">troff</code>, as of
+the latter&rsquo;s 060716 release (July 2006).</p>
+<h5 class="footnote-body-heading"><a id="FOOT124" href="gtroff-Output.html#DOCF124">(124)</a></h5>
+<p>The parser
+and postprocessor for intermediate output can be found in the file<br>
+<samp class="file"><var class="var">groff-source-dir</var>/src/libs/libdriver/input.cpp</samp>.</p>
+<h5 class="footnote-body-heading"><a id="FOOT125" href="Device-and-Font-Description-Files.html#DOCF125">(125)</a></h5>
+<p>Plan&nbsp;9 <code class="code">troff</code> has also abandoned the binary
+format.</p>
+<h5 class="footnote-body-heading"><a id="FOOT126" href="Font-Description-File-Format.html#DOCF126">(126)</a></h5>
+<p>800-point type
+is not practical for most purposes, but using it enables the quantities
+in the font description files to be expressed as integers.</p>
+<h5 class="footnote-body-heading"><a id="FOOT127" href="Font-Description-File-Format.html#DOCF127">(127)</a></h5>
+<p><code class="code">groff</code> requests and escape sequences
+interpret non-negative font names as mounting positions instead.
+Further, a font named &lsquo;<samp class="samp">0</samp>&rsquo; cannot be automatically mounted by the
+<code class="code">fonts</code> directive of a <samp class="file">DESC</samp> file.</p>
+<h5 class="footnote-body-heading"><a id="FOOT128" href="Font-Description-File-Format.html#DOCF128">(128)</a></h5>
+<p>For typesetter devices, this directive is misnamed
+since it starts a list of glyphs, not characters.</p>
+<h5 class="footnote-body-heading"><a id="FOOT129" href="Font-Description-File-Format.html#DOCF129">(129)</a></h5>
+<p>that is, any integer parsable by the C
+standard library&rsquo;s <cite class="cite">strtol<span class="r">(3)</span></cite> function</p>
+</div><hr>
+<div class="nav-panel">
+<p>
+ &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/gtroff-Output.html Added

@@ -0,0 +1,100 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>gtroff Output (The GNU Troff Manual)</title>
+
+<meta name="description" content="gtroff Output (The GNU Troff Manual)">
+<meta name="keywords" content="gtroff Output (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="File-Formats.html" rel="up" title="File Formats">
+<link href="Device-and-Font-Description-Files.html" rel="next" title="Device and Font Description Files">
+<link href="File-Formats.html" rel="prev" title="File Formats">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="gtroff-Output">
+<div class="nav-panel">
+<p>
+Next: <a href="Device-and-Font-Description-Files.html" accesskey="n" rel="next">Device and Font Description Files</a>, Previous: <a href="File-Formats.html" accesskey="p" rel="prev">File Formats</a>, Up: <a href="File-Formats.html" accesskey="u" rel="up">File Formats</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="gtroff-Output-1">6.1 <code class="code">gtroff</code> Output</h3>
+<a class="index-entry-id" id="index-gtroff_002c-output"></a>
+<a class="index-entry-id" id="index-output_002c-gtroff"></a>
+
+<p>This section describes the <code class="code">groff</code> intermediate output format
+produced by GNU <code class="code">troff</code>.
+</p>
+<p>As <code class="code">groff</code> is a wrapper program around GNU <code class="code">troff</code> and
+automatically calls an output driver (or &ldquo;postprocessor&rdquo;), this output
+does not show up normally.  This is why it is called
+<em class="emph">intermediate</em>.  <code class="code">groff</code> provides the option <samp class="option">-Z</samp> to
+inhibit postprocessing such that the produced intermediate output is
+sent to standard output just as it is when calling GNU <code class="code">troff</code>
+directly.
+</p>
+<a class="index-entry-id" id="index-troff-output"></a>
+<a class="index-entry-id" id="index-output_002c-troff"></a>
+<a class="index-entry-id" id="index-intermediate-output"></a>
+<a class="index-entry-id" id="index-output_002c-intermediate"></a>
+<p>Here, the term <em class="dfn">troff output</em> describes what is output by
+GNU <code class="code">troff</code>, while <em class="dfn">intermediate output</em> refers to the language
+that is accepted by the parser that prepares this output for the output
+drivers.  This parser handles whitespace more flexibly than
+<abbr class="acronym">AT&amp;T</abbr>&rsquo;s implementation and implements obsolete elements for
+compatibility; otherwise, both formats are the same.<a class="footnote" id="DOCF124" href="groff.html_fot.html#FOOT124"><sup>124</sup></a>
+</p>
+<p>The main purpose of the intermediate output concept is to facilitate the
+development of postprocessors by providing a common programming
+interface for all devices.  It has a language of its own that is
+completely different from the <code class="code">gtroff</code> language.  While the
+<code class="code">gtroff</code> language is a high-level programming language for text
+processing, the intermediate output language is a kind of low-level
+assembler language by specifying all positions on the page for writing
+and drawing.
+</p>
+<p>The intermediate output produced by <code class="code">gtroff</code> is fairly readable,
+while output from <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> is rather hard to
+understand because of strange habits that are still supported, but not
+used any longer by <code class="code">gtroff</code>.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Language-Concepts.html" accesskey="1">Language Concepts</a></li>
+<li><a href="Command-Reference.html" accesskey="2">Command Reference</a></li>
+<li><a href="Intermediate-Output-Examples.html" accesskey="3">Intermediate Output Examples</a></li>
+<li><a href="Output-Language-Compatibility.html" accesskey="4">Output Language Compatibility</a></li>
+</ul>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Device-and-Font-Description-Files.html">Device and Font Description Files</a>, Previous: <a href="File-Formats.html">File Formats</a>, Up: <a href="File-Formats.html">File Formats</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/if_002delse.html Added

@@ -0,0 +1,97 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>if-else (The GNU Troff Manual)</title>
+
+<meta name="description" content="if-else (The GNU Troff Manual)">
+<meta name="keywords" content="if-else (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Conditionals-and-Loops.html" rel="up" title="Conditionals and Loops">
+<link href="while.html" rel="next" title="while">
+<link href="Operators-in-Conditionals.html" rel="prev" title="Operators in Conditionals">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="if_002delse">
+<div class="nav-panel">
+<p>
+Next: <a href="while.html" accesskey="n" rel="next">while</a>, Previous: <a href="Operators-in-Conditionals.html" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="Conditionals-and-Loops.html" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="if_002delse-1">5.23.3 if-else</h4>
+<a class="index-entry-id" id="index-if_002delse"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eie"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ie</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002eie'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ie"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_002eel"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.el</code></strong> <var class="def-var-arguments">anything</var><a class="copiable-link" href='#index-_002eel'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-el"></a>
+<p>Use the <code class="code">ie</code> and <code class="code">el</code> requests to write an if-then-else.  The
+first request is the &ldquo;if&rdquo; part and the latter is the &ldquo;else&rdquo; part.
+Unusually among programming languages, any number of non-conditional
+requests may be interposed between the <code class="code">ie</code> branch and the
+<code class="code">el</code> branch.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0
+.ie \na a is non-zero.
+.nr a +1
+.el a was not positive but is now \na.
+    &rArr; a was not positive but is now 1.
+</pre></div></div>
+
+<p>Another way in which <code class="code">el</code> is an ordinary request is that it does
+not lexically &ldquo;bind&rdquo; more tightly to its <code class="code">ie</code> counterpart than it
+does to any other request.  This fact can surprise C programmers.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 1
+.nr z 0
+.ie \nz \
+.  ie \na a is true
+.  el     a is false
+.el z is false
+    error&rarr; warning: unbalanced 'el' request
+    &rArr; a is false
+</pre></div></div>
+
+<p>To conveniently nest conditionals, keep reading.
+</p>
+</dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/if_002dthen.html Added

@@ -0,0 +1,111 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>if-then (The GNU Troff Manual)</title>
+
+<meta name="description" content="if-then (The GNU Troff Manual)">
+<meta name="keywords" content="if-then (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Conditionals-and-Loops.html" rel="up" title="Conditionals and Loops">
+<link href="if_002delse.html" rel="next" title="if-else">
+<link href="Operators-in-Conditionals.html" rel="prev" title="Operators in Conditionals">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="if_002dthen">
+<div class="nav-panel">
+<p>
+Next: <a href="if_002delse.html" accesskey="n" rel="next">if-else</a>, Previous: <a href="Operators-in-Conditionals.html" accesskey="p" rel="prev">Operators in Conditionals</a>, Up: <a href="Conditionals-and-Loops.html" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="if_002dthen-1">5.23.2 if-then</h4>
+<a class="index-entry-id" id="index-if_002dthen"></a>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eif"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.if</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002eif'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-if"></a>
+<p>Evaluate the conditional expression <var class="var">cond-expr</var>, and if it evaluates
+true (or to a positive value), interpret the remainder of the line
+<var class="var">anything</var> as if it were an input line.  Recall from <a class="ref" href="Invoking-Requests.html">Invoking Requests</a> that any quantity of spaces between arguments to requests
+serves only to separate them; leading spaces in <var class="var">anything</var> are thus
+not seen.  <var class="var">anything</var> effectively <em class="emph">cannot</em> be omitted; if
+<var class="var">cond-expr</var> is true and <var class="var">anything</var> is empty, the newline at the
+end of the control line is interpreted as a blank input line (and
+therefore a blank text line).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">super\c
+tanker
+.nr force-word-break 1
+super\c
+.if ((\nforce-word-break = 1) &amp; \n.int)
+tanker
+    &rArr; supertanker super tanker
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enop"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nop</code></strong> <var class="def-var-arguments">anything</var><a class="copiable-link" href='#index-_002enop'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nop"></a>
+<p>Interpret <var class="var">anything</var> as if it were an input line.  This is similar
+to &lsquo;<samp class="samp">.if&nbsp;1</samp>&rsquo;.  <code class="code">nop</code> is not really &ldquo;no operation&rdquo;; its
+argument <em class="emph">is</em> processed&mdash;unconditionally.  It can be used to cause
+text lines to share indentation with surrounding control lines.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.als real-MAC MAC
+.de wrapped-MAC
+.  tm MAC: called with arguments \\$@
+.  nop \\*real-MAC\\
+..
+.als MAC wrapped-MAC
+\# Later...
+.als MAC real-MAC
+</pre></div></div>
+
+<p>In the above, we&rsquo;ve used aliasing, <code class="code">nop</code>, and the interpolation of
+a macro as a string to interpose a wrapper around the macro &lsquo;<samp class="samp">MAC</samp>&rsquo;
+(perhaps to debug it).
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="if_002delse.html">if-else</a>, Previous: <a href="Operators-in-Conditionals.html">Operators in Conditionals</a>, Up: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/index.html Added

@@ -0,0 +1,453 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>Top (The GNU Troff Manual)</title>
+
+<meta name="description" content="Top (The GNU Troff Manual)">
+<meta name="keywords" content="Top (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="#Top" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="../dir_html/index.html" rel="up" title="(dir)">
+<link href="Introduction.html" rel="next" title="Introduction">
+<link href="../dir_html/index.html" rel="prev" title="(dir)">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div class="top-level-extent" id="Top">
+<div class="nav-panel">
+<p>
+Next: <a href="Introduction.html" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir_html/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir_html/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h1 class="top" id="GNU-troff">GNU <code class="code">troff</code></h1>
+
+
+<p>This manual documents GNU <code class="code">troff</code> version 1.23.0.
+</p>
+<p>Copyright &copy; 1994&ndash;2023 Free Software Foundation, Inc.
+</p>
+<blockquote class="quotation">
+<p>Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.3 or
+any later version published by the Free Software Foundation; with no
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
+copy of the license is included in the section entitled &ldquo;GNU Free
+Documentation License&rdquo;.
+</p></blockquote>
+
+
+
+
+
+<div class="element-contents" id="SEC_Contents">
+<h2 class="contents-heading">Table of Contents</h2>
+
+<div class="contents">
+
+<ul class="toc-numbered-mark">
+  <li><a id="toc-Introduction-1" href="Introduction.html">1 Introduction</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Background-1" href="Background.html">1.1 Background</a></li>
+    <li><a id="toc-What-Is-groff_003f-1" href="What-Is-groff_003f.html">1.2 What Is <code class="code">groff</code>?</a></li>
+    <li><a id="toc-groff-Capabilities-1" href="groff-Capabilities.html">1.3 <code class="code">groff</code> Capabilities</a></li>
+    <li><a id="toc-Macro-Packages-1" href="Macro-Package-Intro.html">1.4 Macro Packages</a></li>
+    <li><a id="toc-Preprocessors" href="Preprocessor-Intro.html">1.5 Preprocessors</a></li>
+    <li><a id="toc-Output-Devices" href="Output-Device-Intro.html">1.6 Output Devices</a></li>
+    <li><a id="toc-Installation-1" href="Installation.html">1.7 Installation</a></li>
+    <li><a id="toc-Conventions-Used-in-This-Manual-1" href="Conventions-Used-in-This-Manual.html">1.8 Conventions Used in This Manual</a></li>
+    <li><a id="toc-Credits-1" href="Credits.html">1.9 Credits</a></li>
+  </ul></li>
+  <li><a id="toc-Invoking-groff-1" href="Invoking-groff.html">2 Invoking <code class="code">groff</code></a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Options" href="Groff-Options.html">2.1 Options</a></li>
+    <li><a id="toc-Environment-1" href="Environment.html">2.2 Environment</a></li>
+    <li><a id="toc-Macro-Directories-1" href="Macro-Directories.html">2.3 Macro Directories</a></li>
+    <li><a id="toc-Font-Directories-1" href="Font-Directories.html">2.4 Font Directories</a></li>
+    <li><a id="toc-Paper-Format-1" href="Paper-Format.html">2.5 Paper Format</a></li>
+    <li><a id="toc-Invocation-Examples-1" href="Invocation-Examples.html">2.6 Invocation Examples</a></li>
+  </ul></li>
+  <li><a id="toc-Tutorial-for-Macro-Users-1" href="Tutorial-for-Macro-Users.html">3 Tutorial for Macro Users</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Basics-1" href="Basics.html">3.1 Basics</a></li>
+    <li><a id="toc-Common-Features-1" href="Common-Features.html">3.2 Common Features</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Paragraphs-1" href="Paragraphs.html">3.2.1 Paragraphs</a></li>
+      <li><a id="toc-Sections-and-Chapters-1" href="Sections-and-Chapters.html">3.2.2 Sections and Chapters</a></li>
+      <li><a id="toc-Headers-and-Footers-1" href="Headers-and-Footers.html">3.2.3 Headers and Footers</a></li>
+      <li><a id="toc-Page-Layout-1" href="Page-Layout-Adjustment.html">3.2.4 Page Layout</a></li>
+      <li><a id="toc-Displays-and-Keeps-1" href="Displays-and-Keeps.html">3.2.5 Displays and Keeps</a></li>
+      <li><a id="toc-Footnotes-and-Endnotes-1" href="Footnotes-and-Endnotes.html">3.2.6 Footnotes and Endnotes</a></li>
+      <li><a id="toc-Table-of-Contents-1" href="Table-of-Contents.html">3.2.7 Table of Contents</a></li>
+      <li><a id="toc-Indexing-1" href="Indexing.html">3.2.8 Indexing</a></li>
+      <li><a id="toc-Document-Formats-1" href="Document-Formats.html">3.2.9 Document Formats</a></li>
+      <li><a id="toc-Columnation-1" href="Columnation.html">3.2.10 Columnation</a></li>
+      <li><a id="toc-Font-and-Size-Changes-1" href="Font-and-Size-Changes.html">3.2.11 Font and Size Changes</a></li>
+      <li><a id="toc-Predefined-Text-1" href="Predefined-Text.html">3.2.12 Predefined Text</a></li>
+      <li><a id="toc-Preprocessor-Support-1" href="Preprocessor-Support.html">3.2.13 Preprocessor Support</a></li>
+      <li><a id="toc-Configuration-and-Customization-1" href="Configuration-and-Customization.html">3.2.14 Configuration and Customization</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-Macro-Packages-2" href="Major-Macro-Packages.html">4 Macro Packages</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-man-1" href="man.html">4.1 <samp class="file">man</samp></a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Optional-man-extensions-1" href="Optional-man-extensions.html">4.1.1 Optional <samp class="file">man</samp> extensions</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Custom-headers-and-footers" href="Optional-man-extensions.html#Custom-headers-and-footers">Custom headers and footers</a></li>
+        <li><a id="toc-Ultrix_002dspecific-man-macros" href="Optional-man-extensions.html#Ultrix_002dspecific-man-macros">Ultrix-specific man macros</a></li>
+        <li><a id="toc-Simple-example" href="Optional-man-extensions.html#Simple-example">Simple example</a></li>
+      </ul></li>
+    </ul></li>
+    <li><a id="toc-mdoc-1" href="mdoc.html">4.2 <samp class="file">mdoc</samp></a></li>
+    <li><a id="toc-me-1" href="me.html">4.3 <samp class="file">me</samp></a></li>
+    <li><a id="toc-mm-1" href="mm.html">4.4 <samp class="file">mm</samp></a></li>
+    <li><a id="toc-mom-1" href="mom.html">4.5 <samp class="file">mom</samp></a></li>
+    <li><a id="toc-ms-1" href="ms.html">4.6 <samp class="file">ms</samp></a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Introduction-2" href="ms-Introduction.html">4.6.1 Introduction</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Basic-information" href="ms-basic-information.html">4.6.1.1 Basic information</a></li>
+      </ul></li>
+      <li><a id="toc-Document-Structure" href="ms-Document-Structure.html">4.6.2 Document Structure</a></li>
+      <li><a id="toc-Document-Control-Settings" href="ms-Document-Control-Settings.html">4.6.3 Document Control Settings</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Margin-settings" href="ms-Document-Control-Settings.html#Margin-settings">Margin settings</a></li>
+        <li><a id="toc-Titles-_0028headers_002c-footers_0029" href="ms-Document-Control-Settings.html#Titles-_0028headers_002c-footers_0029">Titles (headers, footers)</a></li>
+        <li><a id="toc-Text-settings" href="ms-Document-Control-Settings.html#Text-settings">Text settings</a></li>
+        <li><a id="toc-Paragraph-settings" href="ms-Document-Control-Settings.html#Paragraph-settings">Paragraph settings</a></li>
+        <li><a id="toc-Heading-settings" href="ms-Document-Control-Settings.html#Heading-settings">Heading settings</a></li>
+        <li><a id="toc-Footnote-settings" href="ms-Document-Control-Settings.html#Footnote-settings">Footnote settings</a></li>
+        <li><a id="toc-Display-settings" href="ms-Document-Control-Settings.html#Display-settings">Display settings</a></li>
+        <li><a id="toc-Other-settings" href="ms-Document-Control-Settings.html#Other-settings">Other settings</a></li>
+      </ul></li>
+      <li><a id="toc-Document-Description-Macros" href="ms-Document-Description-Macros.html">4.6.4 Document Description Macros</a></li>
+      <li><a id="toc-Body-Text" href="ms-Body-Text.html">4.6.5 Body Text</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Text-settings-1" href="Text-settings-in-ms.html">4.6.5.1 Text settings</a></li>
+        <li><a id="toc-Typographical-symbols" href="Typographical-symbols-in-ms.html">4.6.5.2 Typographical symbols</a></li>
+        <li><a id="toc-Paragraphs-2" href="Paragraphs-in-ms.html">4.6.5.3 Paragraphs</a></li>
+        <li><a id="toc-Headings" href="Headings-in-ms.html">4.6.5.4 Headings</a></li>
+        <li><a id="toc-Typeface-and-decoration-1" href="Typeface-and-decoration.html">4.6.5.5 Typeface and decoration</a></li>
+        <li><a id="toc-Lists" href="Lists-in-ms.html">4.6.5.6 Lists</a></li>
+        <li><a id="toc-Indented-regions" href="Indented-regions-in-ms.html">4.6.5.7 Indented regions</a></li>
+        <li><a id="toc-Keeps_002c-boxed-keeps_002c-and-displays" href="ms-keeps-and-displays.html">4.6.5.8 Keeps, boxed keeps, and displays</a></li>
+        <li><a id="toc-Tables_002c-figures_002c-equations_002c-and-references" href="ms-Insertions.html">4.6.5.9 Tables, figures, equations, and references</a></li>
+        <li><a id="toc-Footnotes" href="ms-Footnotes.html">4.6.5.10 Footnotes</a></li>
+        <li><a id="toc-Language-and-localization" href="ms-language-and-localization.html">4.6.5.11 Language and localization</a></li>
+      </ul></li>
+      <li><a id="toc-Page-layout" href="ms-Page-Layout.html">4.6.6 Page layout</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Headers-and-footers" href="ms-Headers-and-Footers.html">4.6.6.1 Headers and footers</a></li>
+        <li><a id="toc-Tab-stops" href="Tab-Stops-in-ms.html">4.6.6.2 Tab stops</a></li>
+        <li><a id="toc-Margins" href="ms-Margins.html">4.6.6.3 Margins</a></li>
+        <li><a id="toc-Multiple-columns" href="ms-Multiple-Columns.html">4.6.6.4 Multiple columns</a></li>
+        <li><a id="toc-Creating-a-table-of-contents" href="ms-TOC.html">4.6.6.5 Creating a table of contents</a></li>
+      </ul></li>
+      <li><a id="toc-Differences-from-AT_0026T-ms-1" href="Differences-from-AT_0026T-ms.html">4.6.7 Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Unix-Version-7-ms-macros-not-implemented-by-groff-ms" href="Missing-Unix-Version-7-ms-Macros.html">4.6.7.1 Unix Version 7 <samp class="file">ms</samp> macros not implemented by <code class="code">groff</code> <samp class="file">ms</samp></a></li>
+      </ul></li>
+      <li><a id="toc-Legacy-Features" href="ms-Legacy-Features.html">4.6.8 Legacy Features</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-AT_0026T-accent-mark-strings" href="ms-Legacy-Features.html#AT_0026T-accent-mark-strings">AT&amp;T accent mark strings</a></li>
+        <li><a id="toc-Berkeley-accent-mark-and-glyph-strings" href="ms-Legacy-Features.html#Berkeley-accent-mark-and-glyph-strings">Berkeley accent mark and glyph strings</a></li>
+      </ul></li>
+      <li><a id="toc-Naming-Conventions" href="ms-Naming-Conventions.html">4.6.9 Naming Conventions</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-GNU-troff-Reference-1" href="GNU-troff-Reference.html">5 GNU <code class="code">troff</code> Reference</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-Text-1" href="Text.html">5.1 Text</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Filling-1" href="Filling.html">5.1.1 Filling</a></li>
+      <li><a id="toc-Sentences-1" href="Sentences.html">5.1.2 Sentences</a></li>
+      <li><a id="toc-Hyphenation-1" href="Hyphenation.html">5.1.3 Hyphenation</a></li>
+      <li><a id="toc-Breaking-1" href="Breaking.html">5.1.4 Breaking</a></li>
+      <li><a id="toc-Adjustment-1" href="Adjustment.html">5.1.5 Adjustment</a></li>
+      <li><a id="toc-Tabs-and-Leaders-1" href="Tabs-and-Leaders.html">5.1.6 Tabs and Leaders</a></li>
+      <li><a id="toc-Requests-and-Macros-1" href="Requests-and-Macros.html">5.1.7 Requests and Macros</a></li>
+      <li><a id="toc-Macro-Packages-3" href="Macro-Packages.html">5.1.8 Macro Packages</a></li>
+      <li><a id="toc-Input-Encodings-1" href="Input-Encodings.html">5.1.9 Input Encodings</a></li>
+      <li><a id="toc-Input-Conventions-1" href="Input-Conventions.html">5.1.10 Input Conventions</a></li>
+    </ul></li>
+    <li><a id="toc-Page-Geometry-1" href="Page-Geometry.html">5.2 Page Geometry</a></li>
+    <li><a id="toc-Measurements-1" href="Measurements.html">5.3 Measurements</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Motion-Quanta-1" href="Motion-Quanta.html">5.3.1 Motion Quanta</a></li>
+      <li><a id="toc-Default-Units-1" href="Default-Units.html">5.3.2 Default Units</a></li>
+    </ul></li>
+    <li><a id="toc-Numeric-Expressions-1" href="Numeric-Expressions.html">5.4 Numeric Expressions</a></li>
+    <li><a id="toc-Identifiers-1" href="Identifiers.html">5.5 Identifiers</a></li>
+    <li><a id="toc-Formatter-Instructions-1" href="Formatter-Instructions.html">5.6 Formatter Instructions</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Control-Characters-1" href="Control-Characters.html">5.6.1 Control Characters</a></li>
+      <li><a id="toc-Invoking-Requests-1" href="Invoking-Requests.html">5.6.2 Invoking Requests</a></li>
+      <li><a id="toc-Calling-Macros-1" href="Calling-Macros.html">5.6.3 Calling Macros</a></li>
+      <li><a id="toc-Using-Escape-Sequences-1" href="Using-Escape-Sequences.html">5.6.4 Using Escape Sequences</a></li>
+      <li><a id="toc-Delimiters-1" href="Delimiters.html">5.6.5 Delimiters</a></li>
+    </ul></li>
+    <li><a id="toc-Comments-1" href="Comments.html">5.7 Comments</a></li>
+    <li><a id="toc-Registers-1" href="Registers.html">5.8 Registers</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Setting-Registers-1" href="Setting-Registers.html">5.8.1 Setting Registers</a></li>
+      <li><a id="toc-Interpolating-Registers-1" href="Interpolating-Registers.html">5.8.2 Interpolating Registers</a></li>
+      <li><a id="toc-Auto_002dincrement-1" href="Auto_002dincrement.html">5.8.3 Auto-increment</a></li>
+      <li><a id="toc-Assigning-Register-Formats-1" href="Assigning-Register-Formats.html">5.8.4 Assigning Register Formats</a></li>
+      <li><a id="toc-Built_002din-Registers-1" href="Built_002din-Registers.html">5.8.5 Built-in Registers</a></li>
+    </ul></li>
+    <li><a id="toc-Manipulating-Filling-and-Adjustment-1" href="Manipulating-Filling-and-Adjustment.html">5.9 Manipulating Filling and Adjustment</a></li>
+    <li><a id="toc-Manipulating-Hyphenation-1" href="Manipulating-Hyphenation.html">5.10 Manipulating Hyphenation</a></li>
+    <li><a id="toc-Manipulating-Spacing-1" href="Manipulating-Spacing.html">5.11 Manipulating Spacing</a></li>
+    <li><a id="toc-Tabs-and-Fields-1" href="Tabs-and-Fields.html">5.12 Tabs and Fields</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Leaders-1" href="Leaders.html">5.12.1 Leaders</a></li>
+      <li><a id="toc-Fields-1" href="Fields.html">5.12.2 Fields</a></li>
+    </ul></li>
+    <li><a id="toc-Character-Translations-1" href="Character-Translations.html">5.13 Character Translations</a></li>
+    <li><a id="toc-troff-and-nroff-Modes-1" href="troff-and-nroff-Modes.html">5.14 <code class="code">troff</code> and <code class="code">nroff</code> Modes</a></li>
+    <li><a id="toc-Line-Layout-1" href="Line-Layout.html">5.15 Line Layout</a></li>
+    <li><a id="toc-Line-Continuation-1" href="Line-Continuation.html">5.16 Line Continuation</a></li>
+    <li><a id="toc-Page-Layout-2" href="Page-Layout.html">5.17 Page Layout</a></li>
+    <li><a id="toc-Page-Control-1" href="Page-Control.html">5.18 Page Control</a></li>
+    <li><a id="toc-Using-Fonts-1" href="Using-Fonts.html">5.19 Using Fonts</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Selecting-Fonts-1" href="Selecting-Fonts.html">5.19.1 Selecting Fonts</a></li>
+      <li><a id="toc-Font-Families-1" href="Font-Families.html">5.19.2 Font Families</a></li>
+      <li><a id="toc-Font-Positions-1" href="Font-Positions.html">5.19.3 Font Positions</a></li>
+      <li><a id="toc-Using-Symbols-1" href="Using-Symbols.html">5.19.4 Using Symbols</a></li>
+      <li><a id="toc-Character-Classes-1" href="Character-Classes.html">5.19.5 Character Classes</a></li>
+      <li><a id="toc-Special-Fonts-1" href="Special-Fonts.html">5.19.6 Special Fonts</a></li>
+      <li><a id="toc-Artificial-Fonts-1" href="Artificial-Fonts.html">5.19.7 Artificial Fonts</a></li>
+      <li><a id="toc-Ligatures-and-Kerning-1" href="Ligatures-and-Kerning.html">5.19.8 Ligatures and Kerning</a></li>
+      <li><a id="toc-Italic-Corrections-1" href="Italic-Corrections.html">5.19.9 Italic Corrections</a></li>
+      <li><a id="toc-Dummy-Characters-1" href="Dummy-Characters.html">5.19.10 Dummy Characters</a></li>
+    </ul></li>
+    <li><a id="toc-Manipulating-Type-Size-and-Vertical-Spacing-1" href="Manipulating-Type-Size-and-Vertical-Spacing.html">5.20 Manipulating Type Size and Vertical Spacing</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Changing-the-Type-Size-1" href="Changing-the-Type-Size.html">5.20.1 Changing the Type Size</a></li>
+      <li><a id="toc-Changing-the-Vertical-Spacing-1" href="Changing-the-Vertical-Spacing.html">5.20.2 Changing the Vertical Spacing</a></li>
+      <li><a id="toc-Using-Fractional-Type-Sizes-1" href="Using-Fractional-Type-Sizes.html">5.20.3 Using Fractional Type Sizes</a></li>
+    </ul></li>
+    <li><a id="toc-Colors-1" href="Colors.html">5.21 Colors</a></li>
+    <li><a id="toc-Strings-1" href="Strings.html">5.22 Strings</a></li>
+    <li><a id="toc-Conditionals-and-Loops-1" href="Conditionals-and-Loops.html">5.23 Conditionals and Loops</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Operators-in-Conditionals-1" href="Operators-in-Conditionals.html">5.23.1 Operators in Conditionals</a></li>
+      <li><a id="toc-if_002dthen-1" href="if_002dthen.html">5.23.2 if-then</a></li>
+      <li><a id="toc-if_002delse-1" href="if_002delse.html">5.23.3 if-else</a></li>
+      <li><a id="toc-Conditional-Blocks-1" href="Conditional-Blocks.html">5.23.4 Conditional Blocks</a></li>
+      <li><a id="toc-while-1" href="while.html">5.23.5 while</a></li>
+    </ul></li>
+    <li><a id="toc-Writing-Macros-1" href="Writing-Macros.html">5.24 Writing Macros</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Parameters-1" href="Parameters.html">5.24.1 Parameters</a></li>
+      <li><a id="toc-Copy-Mode-1" href="Copy-Mode.html">5.24.2 Copy Mode</a></li>
+    </ul></li>
+    <li><a id="toc-Page-Motions-1" href="Page-Motions.html">5.25 Page Motions</a></li>
+    <li><a id="toc-Drawing-Geometric-Objects-1" href="Drawing-Geometric-Objects.html">5.26 Drawing Geometric Objects</a></li>
+    <li><a id="toc-Deferring-Output-1" href="Deferring-Output.html">5.27 Deferring Output</a></li>
+    <li><a id="toc-Traps-1" href="Traps.html">5.28 Traps</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Vertical-Position-Traps-1" href="Vertical-Position-Traps.html">5.28.1 Vertical Position Traps</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Page-Location-Traps-1" href="Page-Location-Traps.html">5.28.1.1 Page Location Traps</a></li>
+        <li><a id="toc-The-Implicit-Page-Trap-1" href="The-Implicit-Page-Trap.html">5.28.1.2 The Implicit Page Trap</a></li>
+        <li><a id="toc-Diversion-Traps-1" href="Diversion-Traps.html">5.28.1.3 Diversion Traps</a></li>
+      </ul></li>
+      <li><a id="toc-Input-Line-Traps-1" href="Input-Line-Traps.html">5.28.2 Input Line Traps</a></li>
+      <li><a id="toc-Blank-Line-Traps-1" href="Blank-Line-Traps.html">5.28.3 Blank Line Traps</a></li>
+      <li><a id="toc-Leading-Space-Traps-1" href="Leading-Space-Traps.html">5.28.4 Leading Space Traps</a></li>
+      <li><a id="toc-End_002dof_002dinput-Traps-1" href="End_002dof_002dinput-Traps.html">5.28.5 End-of-input Traps</a></li>
+    </ul></li>
+    <li><a id="toc-Diversions-1" href="Diversions.html">5.29 Diversions</a></li>
+    <li><a id="toc-Punning-Names-1" href="Punning-Names.html">5.30 Punning Names</a></li>
+    <li><a id="toc-Environments-1" href="Environments.html">5.31 Environments</a></li>
+    <li><a id="toc-Suppressing-Output-1" href="Suppressing-Output.html">5.32 Suppressing Output</a></li>
+    <li><a id="toc-I_002fO-1" href="I_002fO.html">5.33 I/O</a></li>
+    <li><a id="toc-Postprocessor-Access-1" href="Postprocessor-Access.html">5.34 Postprocessor Access</a></li>
+    <li><a id="toc-Miscellaneous-1" href="Miscellaneous.html">5.35 Miscellaneous</a></li>
+    <li><a id="toc-gtroff-Internals" href="Gtroff-Internals.html">5.36 <code class="code">gtroff</code> Internals</a></li>
+    <li><a id="toc-Debugging-1" href="Debugging.html">5.37 Debugging</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Warnings-1" href="Warnings.html">5.37.1 Warnings</a></li>
+    </ul></li>
+    <li><a id="toc-Implementation-Differences-1" href="Implementation-Differences.html">5.38 Implementation Differences</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Safer-Mode-1" href="Safer-Mode.html">5.38.1 Safer Mode</a></li>
+      <li><a id="toc-Compatibility-Mode-1" href="Compatibility-Mode.html">5.38.2 Compatibility Mode</a></li>
+      <li><a id="toc-Other-Differences-1" href="Other-Differences.html">5.38.3 Other Differences</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-File-Formats-1" href="File-Formats.html">6 File Formats</a>
+  <ul class="toc-numbered-mark">
+    <li><a id="toc-gtroff-Output-1" href="gtroff-Output.html">6.1 <code class="code">gtroff</code> Output</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-Language-Concepts-1" href="Language-Concepts.html">6.1.1 Language Concepts</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Separation-1" href="Separation.html">6.1.1.1 Separation</a></li>
+        <li><a id="toc-Argument-Units-1" href="Argument-Units.html">6.1.1.2 Argument Units</a></li>
+        <li><a id="toc-Document-Parts-1" href="Document-Parts.html">6.1.1.3 Document Parts</a></li>
+      </ul></li>
+      <li><a id="toc-Command-Reference-1" href="Command-Reference.html">6.1.2 Command Reference</a>
+      <ul class="toc-numbered-mark">
+        <li><a id="toc-Comment-Command-1" href="Comment-Command.html">6.1.2.1 Comment Command</a></li>
+        <li><a id="toc-Simple-Commands-1" href="Simple-Commands.html">6.1.2.2 Simple Commands</a></li>
+        <li><a id="toc-Graphics-Commands-1" href="Graphics-Commands.html">6.1.2.3 Graphics Commands</a></li>
+        <li><a id="toc-Device-Control-Commands-1" href="Device-Control-Commands.html">6.1.2.4 Device Control Commands</a></li>
+        <li><a id="toc-Obsolete-Command-1" href="Obsolete-Command.html">6.1.2.5 Obsolete Command</a></li>
+      </ul></li>
+      <li><a id="toc-Intermediate-Output-Examples-1" href="Intermediate-Output-Examples.html">6.1.3 Intermediate Output Examples</a></li>
+      <li><a id="toc-Output-Language-Compatibility-1" href="Output-Language-Compatibility.html">6.1.4 Output Language Compatibility</a></li>
+    </ul></li>
+    <li><a id="toc-Device-and-Font-Description-Files-1" href="Device-and-Font-Description-Files.html">6.2 Device and Font Description Files</a>
+    <ul class="toc-numbered-mark">
+      <li><a id="toc-DESC-File-Format-1" href="DESC-File-Format.html">6.2.1 <samp class="file">DESC</samp> File Format</a></li>
+      <li><a id="toc-Font-Description-File-Format-1" href="Font-Description-File-Format.html">6.2.2 Font Description File Format</a></li>
+    </ul></li>
+  </ul></li>
+  <li><a id="toc-Copying-This-Manual-1" href="Copying-This-Manual.html">Appendix A Copying This Manual</a></li>
+  <li><a id="toc-Request-Index-1" href="Request-Index.html" rel="index">Appendix B Request Index</a></li>
+  <li><a id="toc-Escape-Sequence-Index-1" href="Escape-Sequence-Index.html" rel="index">Appendix C Escape Sequence Index</a></li>
+  <li><a id="toc-Operator-Index-1" href="Operator-Index.html" rel="index">Appendix D Operator Index</a></li>
+  <li><a id="toc-Register-Index-1" href="Register-Index.html" rel="index">Appendix E Register Index</a></li>
+  <li><a id="toc-Macro-Index-1" href="Macro-Index.html" rel="index">Appendix F Macro Index</a></li>
+  <li><a id="toc-String-Index-1" href="String-Index.html" rel="index">Appendix G String Index</a></li>
+  <li><a id="toc-File-Keyword-Index-1" href="File-Keyword-Index.html" rel="index">Appendix H File Keyword Index</a></li>
+  <li><a id="toc-Program-and-File-Index-1" href="Program-and-File-Index.html" rel="index">Appendix I Program and File Index</a></li>
+  <li><a id="toc-Concept-Index-1" href="Concept-Index.html" rel="index">Appendix J Concept Index</a></li>
+</ul>
+</div>
+</div>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Introduction.html" accesskey="n" rel="next">Introduction</a>, Previous: <a href="../dir_html/index.html" accesskey="p" rel="prev">(dir)</a>, Up: <a href="../dir_html/index.html" accesskey="u" rel="up">(dir)</a> &nbsp; <a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/man.html Added

@@ -0,0 +1,71 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>man (The GNU Troff Manual)</title>
+
+<meta name="description" content="man (The GNU Troff Manual)">
+<meta name="keywords" content="man (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="mdoc.html" rel="next" title="mdoc">
+<link href="Major-Macro-Packages.html" rel="prev" title="Major Macro Packages">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="man">
+<div class="nav-panel">
+<p>
+Next: <a href="mdoc.html" accesskey="n" rel="next"><samp class="file">mdoc</samp></a>, Previous: <a href="Major-Macro-Packages.html" accesskey="p" rel="prev">Macro Packages</a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="man-1">4.1 <samp class="file">man</samp></h3>
+<a class="index-entry-id" id="index-manual-pages"></a>
+<a class="index-entry-id" id="index-man-pages"></a>
+<a class="index-entry-id" id="index-an_002etmac"></a>
+<a class="index-entry-id" id="index-man_002etmac"></a>
+
+<p>The <code class="code">man</code> macro package is the most widely used and probably the
+most important ever developed for <code class="code">troff</code>.  It is easy to use, and
+a vast majority of manual pages (&ldquo;man pages&rdquo;) are written in it.
+</p>
+<p><code class="code">groff</code>&rsquo;s implementation is documented in the
+<cite class="cite">groff_man<span class="r">(7)</span></cite> man page.  Type &lsquo;<samp class="samp">man groff_man</samp>&rsquo; at the
+command line to view it.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Optional-man-extensions.html" accesskey="1">Optional <samp class="file">man</samp> extensions</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/mdoc.html Added

@@ -0,0 +1,61 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>mdoc (The GNU Troff Manual)</title>
+
+<meta name="description" content="mdoc (The GNU Troff Manual)">
+<meta name="keywords" content="mdoc (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="me.html" rel="next" title="me">
+<link href="man.html" rel="prev" title="man">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="mdoc">
+<div class="nav-panel">
+<p>
+Next: <a href="me.html" accesskey="n" rel="next"><samp class="file">me</samp></a>, Previous: <a href="man.html" accesskey="p" rel="prev"><samp class="file">man</samp></a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="mdoc-1">4.2 <samp class="file">mdoc</samp></h3>
+<a class="index-entry-id" id="index-mdoc-macros"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the BSD <samp class="file">doc</samp> package for man
+pages is documented in the <cite class="cite">groff_mdoc<span class="r">(7)</span></cite> man page.  Type
+&lsquo;<samp class="samp">man groff_mdoc</samp>&rsquo; at the command line to view it.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/me.html Added

@@ -0,0 +1,67 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>me (The GNU Troff Manual)</title>
+
+<meta name="description" content="me (The GNU Troff Manual)">
+<meta name="keywords" content="me (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="mm.html" rel="next" title="mm">
+<link href="mdoc.html" rel="prev" title="mdoc">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="me">
+<div class="nav-panel">
+<p>
+Next: <a href="mm.html" accesskey="n" rel="next"><samp class="file">mm</samp></a>, Previous: <a href="mdoc.html" accesskey="p" rel="prev"><samp class="file">mdoc</samp></a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="me-1">4.3 <samp class="file">me</samp></h3>
+<a class="index-entry-id" id="index-me-macro-package"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the BSD <samp class="file">me</samp> macro package is
+documented using itself.  A tutorial, <samp class="file">meintro.me</samp>, and reference,
+<samp class="file">meref.me</samp>, are available in <code class="code">groff</code>&rsquo;s documentation
+directory.  A <cite class="cite">groff_me<span class="r">(7)</span></cite> man page is also available and
+identifies the installation path for these documents.  Type &lsquo;<samp class="samp">man
+groff_me</samp>&rsquo; at the command line to view it.
+</p>
+<p>A French translation of the tutorial is available as
+<samp class="file">meintro_fr.me</samp> and installed parallel to the English version.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/mm.html Added

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>mm (The GNU Troff Manual)</title>
+
+<meta name="description" content="mm (The GNU Troff Manual)">
+<meta name="keywords" content="mm (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="mom.html" rel="next" title="mom">
+<link href="me.html" rel="prev" title="me">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="mm">
+<div class="nav-panel">
+<p>
+Next: <a href="mom.html" accesskey="n" rel="next"><samp class="file">mom</samp></a>, Previous: <a href="me.html" accesskey="p" rel="prev"><samp class="file">me</samp></a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="mm-1">4.4 <samp class="file">mm</samp></h3>
+<a class="index-entry-id" id="index-mm-macro-package"></a>
+
+<p><code class="code">groff</code>&rsquo;s implementation of the <abbr class="acronym">AT&amp;T</abbr> memorandum macro
+package is documented in the <cite class="cite">groff_mm<span class="r">(7)</span></cite> man page.  Type
+&lsquo;<samp class="samp">man groff_mm</samp>&rsquo; at the command line) to view it.
+</p>
+<p>A Swedish localization of <samp class="file">mm</samp> is also available; see
+<cite class="cite">groff_mmse<span class="r">(7)</span></cite>.
+</p>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/mom.html Added

@@ -0,0 +1,85 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>mom (The GNU Troff Manual)</title>
+
+<meta name="description" content="mom (The GNU Troff Manual)">
+<meta name="keywords" content="mom (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="ms.html" rel="next" title="ms">
+<link href="mm.html" rel="prev" title="mm">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="mom">
+<div class="nav-panel">
+<p>
+Next: <a href="ms.html" accesskey="n" rel="next"><samp class="file">ms</samp></a>, Previous: <a href="mm.html" accesskey="p" rel="prev"><samp class="file">mm</samp></a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="mom-1">4.5 <samp class="file">mom</samp></h3>
+<a class="index-entry-id" id="index-mom-macro-package"></a>
+
+<p>The main documentation files for the <samp class="file">mom</samp> macros are in
+<abbr class="acronym">HTML</abbr> format.  Additional, useful documentation is in
+<abbr class="acronym">PDF</abbr> format.  See the <cite class="cite">groff<span class="r">(1)</span></cite> man page, section
+&ldquo;Installation Directories&rdquo;, for their location.
+</p>
+<ul class="itemize mark-bullet">
+<li><samp class="file">toc.html</samp>
+Entry point to the full mom manual.
+
+</li><li><samp class="file">macrolist.html</samp>
+Hyperlinked index of macros with brief descriptions, arranged by
+category.
+
+</li><li><samp class="file">mom-pdf.pdf</samp>
+<abbr class="acronym">PDF</abbr> features and usage.
+</li></ul>
+
+<p>The mom macros are in active development between <code class="code">groff</code> releases.
+The most recent version, along with up-to-date documentation, is
+available at <a class="uref" href="http://www.schaffter.ca/mom/mom-05.html">http://www.schaffter.ca/mom/mom-05.html</a>.
+</p>
+<p>The <cite class="cite">groff_mom<span class="r">(7)</span></cite> man page (type &lsquo;<samp class="samp">man groff_mom</samp>&rsquo; at
+the command line) contains a partial list of available macros, however
+their usage is best understood by consulting the <abbr class="acronym">HTML</abbr>
+documentation.
+</p>
+
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Body-Text.html Added

@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Body Text (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Body Text (The GNU Troff Manual)">
+<meta name="keywords" content="ms Body Text (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Page-Layout.html" rel="next" title="ms Page Layout">
+<link href="ms-Document-Description-Macros.html" rel="prev" title="ms Document Description Macros">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Body-Text">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Page-Layout.html" accesskey="n" rel="next">Page layout</a>, Previous: <a href="ms-Document-Description-Macros.html" accesskey="p" rel="prev">Document Description Macros</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Body-Text">4.6.5 Body Text</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-body-text"></a>
+
+<p>A variety of macros, registers, and strings can be used to structure and
+style the body of your document.  They organize your text into
+paragraphs, headings, footnotes, and inclusions of material such as
+tables and figures.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="Text-settings-in-ms.html" accesskey="1">Text settings</a></li>
+<li><a href="Typographical-symbols-in-ms.html" accesskey="2">Typographical symbols</a></li>
+<li><a href="Paragraphs-in-ms.html" accesskey="3">Paragraphs</a></li>
+<li><a href="Headings-in-ms.html" accesskey="4">Headings</a></li>
+<li><a href="Typeface-and-decoration.html" accesskey="5">Typeface and decoration</a></li>
+<li><a href="Lists-in-ms.html" accesskey="6">Lists</a></li>
+<li><a href="Indented-regions-in-ms.html" accesskey="7">Indented regions</a></li>
+<li><a href="ms-keeps-and-displays.html" accesskey="8">Keeps, boxed keeps, and displays</a></li>
+<li><a href="ms-Insertions.html" accesskey="9">Tables, figures, equations, and references</a></li>
+<li><a href="ms-Footnotes.html">Footnotes</a></li>
+<li><a href="ms-language-and-localization.html">Language and localization</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Document-Control-Settings.html Added

@@ -0,0 +1,524 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Document Control Settings (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Document Control Settings (The GNU Troff Manual)">
+<meta name="keywords" content="ms Document Control Settings (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Document-Description-Macros.html" rel="next" title="ms Document Description Macros">
+<link href="ms-Document-Structure.html" rel="prev" title="ms Document Structure">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Document-Control-Settings">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Description-Macros.html" accesskey="n" rel="next">Document Description Macros</a>, Previous: <a href="ms-Document-Structure.html" accesskey="p" rel="prev">Document Structure</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Document-Control-Settings">4.6.3 Document Control Settings</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-document-control-settings"></a>
+
+<p><samp class="file">ms</samp> exposes many aspects of document layout to user control via
+<code class="code">groff</code> requests.  To use them, you must understand how to define
+registers and strings.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enr"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nr</code></strong> <var class="def-var-arguments">reg value</var><a class="copiable-link" href='#index-_002enr'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nr"></a>
+<p>Set register <var class="var">reg</var> to <var class="var">value</var>.  If <var class="var">reg</var> doesn&rsquo;t exist, GNU
+<code class="code">troff</code> creates it.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002eds"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.ds</code></strong> <var class="def-var-arguments">name contents</var><a class="copiable-link" href='#index-_002eds'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ds"></a>
+<p>Set string <var class="var">name</var> to <var class="var">contents</var>.
+</p></dd></dl>
+
+<p>A list of document control registers and strings follows.  For any
+parameter whose default is unsatisfactory, define its register or string
+before calling any <samp class="file">ms</samp> macro other than <code class="code">RP</code>.
+</p>
+<ul class="mini-toc">
+<li><a href="#Margin-settings" accesskey="1">Margin settings</a></li>
+<li><a href="#Titles-_0028headers_002c-footers_0029" accesskey="2">Titles (headers, footers)</a></li>
+<li><a href="#Text-settings" accesskey="3">Text settings</a></li>
+<li><a href="#Paragraph-settings" accesskey="4">Paragraph settings</a></li>
+<li><a href="#Heading-settings" accesskey="5">Heading settings</a></li>
+<li><a href="#Footnote-settings" accesskey="6">Footnote settings</a></li>
+<li><a href="#Display-settings" accesskey="7">Display settings</a></li>
+<li><a href="#Other-settings" accesskey="8">Other settings</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="Margin-settings">
+<h4 class="unnumberedsubsubsec">Margin settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPO_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPO</code></strong><a class="copiable-link" href='#index-_005cn_005bPO_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PO-_005bms_005d"></a>
+<p>Defines the page offset (i.e., the left margin).
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: Varies by output device and paper format; 1<span class="dmn">i</span> is used for
+typesetters using U.S. letter paper, and zero for terminals.
+See <a class="xref" href="Paper-Format.html">Paper Format</a>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bLL_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nLL</code></strong><a class="copiable-link" href='#index-_005cn_005bLL_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LL-_005bms_005d"></a>
+<p>Defines the line length (i.e., the width of the body text).
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: Varies by output device and paper format; 6.5<span class="dmn">i</span> is used
+for typesetters using U.S. letter paper (see <a class="pxref" href="Paper-Format.html">Paper Format</a>) and
+65<span class="dmn">n</span> on terminals.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bLT_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nLT</code></strong><a class="copiable-link" href='#index-_005cn_005bLT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LT-_005bms_005d"></a>
+<p>Defines the title line length (i.e., the header and footer width).  This
+is usually the same as <code class="code">LL</code>, but need not be.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: Varies by output device and paper format; 6.5<span class="dmn">i</span> is used
+for typesetters using U.S. letter paper (see <a class="pxref" href="Paper-Format.html">Paper Format</a>) and
+65<span class="dmn">n</span> on terminals.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHM</code></strong><a class="copiable-link" href='#index-_005cn_005bHM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HM-_005bms_005d"></a>
+<p>Defines the header margin height at the top of the page.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 1<span class="dmn">i</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFM_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFM</code></strong><a class="copiable-link" href='#index-_005cn_005bFM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FM-_005bms_005d"></a>
+<p>Defines the footer margin height at the bottom of the page.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 1<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Titles-_0028headers_002c-footers_0029">
+<h4 class="unnumberedsubsubsec">Titles (headers, footers)</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bLH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*LH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bLH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LH-_005bms_005d"></a>
+<p>Defines the text displayed in the left header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bCH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*CH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bCH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CH-_005bms_005d"></a>
+<p>Defines the text displayed in the center header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: &lsquo;<samp class="samp">-\n%-</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bRH_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*RH</code></strong><a class="copiable-link" href='#index-_005c_002a_005bRH_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RH-_005bms_005d"></a>
+<p>Defines the text displayed in the right header position.
+</p>
+<p>Effective: next header.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bLF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*LF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bLF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LF-_005bms_005d"></a>
+<p>Defines the text displayed in the left footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bCF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*CF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bCF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CF-_005bms_005d"></a>
+<p>Defines the text displayed in the center footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bRF_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*RF</code></strong><a class="copiable-link" href='#index-_005c_002a_005bRF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RF-_005bms_005d"></a>
+<p>Defines the text displayed in the right footer position.
+</p>
+<p>Effective: next footer.
+</p>
+<p>Default: empty.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Text-settings">
+<h4 class="unnumberedsubsubsec">Text settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPS</code></strong><a class="copiable-link" href='#index-_005cn_005bPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PS-_005bms_005d-1"></a>
+<p>Defines the type size of the body text.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 10<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bVS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nVS</code></strong><a class="copiable-link" href='#index-_005cn_005bVS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-VS-_005bms_005d"></a>
+<p>Defines the vertical spacing (type size plus leading).
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 12<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHY_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHY</code></strong><a class="copiable-link" href='#index-_005cn_005bHY_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HY-_005bms_005d"></a>
+<p>Defines the automatic hyphenation mode used with the <code class="code">hy</code> request.
+Setting <code class="code">HY</code> to&nbsp;0 is equivalent to using the <code class="code">nh</code>
+request.  This is a Tenth Edition Research Unix extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 6.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bFAM_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*FAM</code></strong><a class="copiable-link" href='#index-_005c_002a_005bFAM_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FAM-_005bms_005d"></a>
+<p>Defines the font family used to typeset the document.  This is a GNU
+extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: defined by the output device; often &lsquo;<samp class="samp">T</samp>&rsquo; (see <a class="pxref" href="ms-Body-Text.html">Body Text</a>)
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Paragraph-settings">
+<h4 class="unnumberedsubsubsec">Paragraph settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPI</code></strong><a class="copiable-link" href='#index-_005cn_005bPI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PI-_005bms_005d"></a>
+<p>Defines the indentation amount used by the <code class="code">PP</code>, <code class="code">IP</code> (unless
+overridden by an optional argument), <code class="code">XP</code>, and <code class="code">RS</code> macros.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 5<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPD</code></strong><a class="copiable-link" href='#index-_005cn_005bPD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PD-_005bms_005d"></a>
+<p>Defines the space between paragraphs.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 0.3<span class="dmn">v</span> (1<span class="dmn">v</span> on low-resolution devices).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bQI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nQI</code></strong><a class="copiable-link" href='#index-_005cn_005bQI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-QI-_005bms_005d"></a>
+<p>Defines the indentation amount used on both sides of a paragraph set
+with the <code class="code">QP</code> or between the <code class="code">QS</code> and <code class="code">QE</code> macros.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 5<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPORPHANS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPORPHANS</code></strong><a class="copiable-link" href='#index-_005cn_005bPORPHANS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PORPHANS-_005bms_005d"></a>
+<p>Defines the minimum number of initial lines of any paragraph that must
+be kept together to avoid isolated lines at the bottom of a page.  If a
+new paragraph is started close to the bottom of a page, and there is
+insufficient space to accommodate <code class="code">PORPHANS</code> lines before an
+automatic page break, then a page break is forced before the start of
+the paragraph.  This is a GNU extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 1.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Heading-settings">
+<h4 class="unnumberedsubsubsec">Heading settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bPSINCR_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nPSINCR</code></strong><a class="copiable-link" href='#index-_005cn_005bPSINCR_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PSINCR-_005bms_005d"></a>
+<p>Defines an increment in type size to be applied to a heading at a
+lesser depth than that specified in <code class="code">GROWPS</code>.  The value of
+<code class="code">PSINCR</code> should be specified in points with the <span class="dmn">p</span> scaling
+unit and may include a fractional component; for example, &lsquo;<samp class="samp">.nr&nbsp;PSINCR&nbsp;1.5p</samp>&rsquo; sets a type size increment of 1.5<span class="dmn">p</span>.  This is a GNU
+extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: 1<span class="dmn">p</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bGROWPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nGROWPS</code></strong><a class="copiable-link" href='#index-_005cn_005bGROWPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-GROWPS-_005bms_005d"></a>
+<p>Defines the heading depth above which the type size increment set by
+<code class="code">PSINCR</code> becomes effective.  For each heading depth less than the
+value of <code class="code">GROWPS</code>, the type size is increased by <code class="code">PSINCR</code>.
+Setting <code class="code">GROWPS</code> to any value less than&nbsp;2 disables the
+incremental heading size feature.  This is a GNU extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: 0.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bHORPHANS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nHORPHANS</code></strong><a class="copiable-link" href='#index-_005cn_005bHORPHANS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-HORPHANS-_005bms_005d"></a>
+<p>Defines the minimum number of lines of an immediately succeeding
+paragraph that should be kept together with any heading introduced by
+the <code class="code">NH</code> or <code class="code">SH</code> macros.  If a heading is placed close to the
+bottom of a page, and there is insufficient space to accommodate both
+the heading and at least <code class="code">HORPHANS</code> lines of the following
+paragraph, before an automatic page break, then the page break is forced
+before the heading.  This is a GNU extension.
+</p>
+<p>Effective: next paragraph.
+</p>
+<p>Default: 1.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bSN_002dSTYLE_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*SN-STYLE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bSN_002dSTYLE_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-SN_002dSTYLE-_005bms_005d"></a>
+<p>Defines the style used to print numbered headings.  See <a class="xref" href="Headings-in-ms.html">Headings</a>.  This is a GNU extension.
+</p>
+<p>Effective: next heading.
+</p>
+<p>Default: alias of <code class="code">SN-DOT</code>
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Footnote-settings">
+<h4 class="unnumberedsubsubsec">Footnote settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFI</code></strong><a class="copiable-link" href='#index-_005cn_005bFI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FI-_005bms_005d"></a>
+<p>Defines the footnote indentation.  This is a Berkeley extension.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: 2<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFF_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFF</code></strong><a class="copiable-link" href='#index-_005cn_005bFF_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FF-_005bms_005d"></a>
+<p>Defines the format of automatically numbered footnotes,
+and those for which the <code class="code">FS</code> request is given a marker argument, at
+the bottom of a column or page.  This is a Berkeley extension.
+</p><dl class="table">
+<dt><code class="code">0</code></dt>
+<dd><p>Set an automatic number<a class="footnote" id="DOCF8" href="groff.html_fot.html#FOOT8"><sup>8</sup></a> as a
+superscript (on typesetter devices) or surrounded by square brackets (on
+terminals).  The footnote paragraph is indented as with <code class="code">PP</code> if
+there is an <code class="code">FS</code> argument or an automatic number, and as with
+<code class="code">LP</code> otherwise.  This is the default.
+</p>
+</dd>
+<dt><code class="code">1</code></dt>
+<dd><p>As <code class="code">0</code>, but set the marker as regular text and follow an
+automatic number with a period.
+</p>
+</dd>
+<dt><code class="code">2</code></dt>
+<dd><p>As <code class="code">1</code>, but without indentation (like <code class="code">LP</code>).
+</p>
+</dd>
+<dt><code class="code">3</code></dt>
+<dd><p>As <code class="code">1</code>, but set the footnote paragraph with the marker hanging
+(like <code class="code">IP</code>).
+</p></dd>
+</dl>
+
+<p>Effective: next footnote.
+</p>
+<p>Default: 0.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFPS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFPS</code></strong><a class="copiable-link" href='#index-_005cn_005bFPS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FPS-_005bms_005d"></a>
+<p>Defines the footnote type size.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nPS - 2p</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFVS_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFVS</code></strong><a class="copiable-link" href='#index-_005cn_005bFVS_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FVS-_005bms_005d"></a>
+<p>Defines the footnote vertical spacing.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nFPS + 2p</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bFPD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nFPD</code></strong><a class="copiable-link" href='#index-_005cn_005bFPD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FPD-_005bms_005d"></a>
+<p>Defines the footnote paragraph spacing.  This is a GNU extension.
+</p>
+<p>Effective: next footnote.
+</p>
+<p>Default: <code class="code">\nPD / 2</code>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bFR_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*FR</code></strong><a class="copiable-link" href='#index-_005c_002a_005bFR_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FR-_005bms_005d"></a>
+<p>Defines the ratio of the footnote line length to the current line
+length.  This is a GNU extension.
+</p>
+<p>Effective: next footnote in single-column arrangements, next page
+otherwise.
+</p>
+<p>Default: <code class="code">11/12</code>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Display-settings">
+<h4 class="unnumberedsubsubsec">Display settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bDD_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nDD</code></strong><a class="copiable-link" href='#index-_005cn_005bDD_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DD-_005bms_005d"></a>
+<p>Sets the display distance&mdash;the vertical spacing before and after a
+display, a <code class="code">tbl</code> table, an <code class="code">eqn</code> equation, or a <code class="code">pic</code>
+image.  This is a Berkeley extension.
+</p>
+<p>Effective: next display boundary.
+</p>
+<p>Default: 0.5<span class="dmn">v</span> (1<span class="dmn">v</span> on low-resolution devices).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bDI_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nDI</code></strong><a class="copiable-link" href='#index-_005cn_005bDI_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DI-_005bms_005d"></a>
+<p>Sets the default amount by which to indent a display started with
+<code class="code">DS</code> and <code class="code">ID</code> without arguments, to &lsquo;<samp class="samp">.DS&nbsp;I</samp>&rsquo; without
+an indentation argument, and to equations set with &lsquo;<samp class="samp">.EQ&nbsp;I</samp>&rsquo;.
+This is a GNU extension.
+</p>
+<p>Effective: next indented display.
+</p>
+<p>Default: 0.5<span class="dmn">i</span>.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Other-settings">
+<h4 class="unnumberedsubsubsec">Other settings</h4>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bMINGW_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nMINGW</code></strong><a class="copiable-link" href='#index-_005cn_005bMINGW_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MINGW-_005bms_005d"></a>
+<p>Defines the default minimum width between columns in a multi-column
+document.  This is a GNU extension.
+</p>
+<p>Effective: next page.
+</p>
+<p>Default: 2<span class="dmn">n</span>.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005cn_005bTC_002dMARGIN_005d"><span class="category-def">Register: </span><span><strong class="def-name"><code class="t">\nTC-MARGIN</code></strong><a class="copiable-link" href='#index-_005cn_005bTC_002dMARGIN_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TC_002dMARGIN-_005bms_005d"></a>
+<p>Defines the width of the field in which page numbers are set in a table
+of contents entry; the right margin thus moves inboard by this amount.
+This is a GNU extension.
+</p>
+<p>Effective: next <code class="code">PX</code> call.
+</p>
+<p>Default: <code class="code">\w'000'</code>
+</p></dd></dl>
+
+
+
+</div>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Description-Macros.html">Document Description Macros</a>, Previous: <a href="ms-Document-Structure.html">Document Structure</a>, Up: <a href="ms.html"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Document-Description-Macros.html Added

@@ -0,0 +1,189 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Document Description Macros (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Document Description Macros (The GNU Troff Manual)">
+<meta name="keywords" content="ms Document Description Macros (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Body-Text.html" rel="next" title="ms Body Text">
+<link href="ms-Document-Control-Settings.html" rel="prev" title="ms Document Control Settings">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Document-Description-Macros">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Body-Text.html" accesskey="n" rel="next">Body Text</a>, Previous: <a href="ms-Document-Control-Settings.html" accesskey="p" rel="prev">Document Control Settings</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Document-Description-Macros">4.6.4 Document Description Macros</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-document-description"></a>
+<a class="index-entry-id" id="index-document-description-macros_002c-_005bms_005d"></a>
+
+<p>Only the simplest document lacks a title.<a class="footnote" id="DOCF9" href="groff.html_fot.html#FOOT9"><sup>9</sup></a>  As its level of sophistication (or
+complexity) increases, it tends to acquire a date of revision,
+explicitly identified authors, sponsoring institutions for authors, and,
+at the rarefied heights, an abstract of its content.  Define these
+data by calling the macros below in the order shown; <code class="code">DA</code> or
+<code class="code">ND</code> can be called to set the document date (or other identifier)
+at any time before (a) the abstract, if present, or (b) its information
+is required in a header or footer.  Use of these macros is optional,
+except that <code class="code">TL</code> is mandatory if any of <code class="code">RP</code>, <code class="code">AU</code>,
+<code class="code">AI</code>, or <code class="code">AB</code> is called, and <code class="code">AE</code> is mandatory if
+<code class="code">AB</code> is called.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eRP"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RP</code></strong> <var class="def-var-arguments"><code class="code">no-repeat-info</code> <code class="code">no-renumber</code></var><a class="copiable-link" href='#index-_002eRP'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RP-_005bms_005d"></a>
+<p>Use the &ldquo;report&rdquo; (<abbr class="acronym">AT&amp;T</abbr>: &ldquo;released paper&rdquo;) format for your
+document, creating a separate cover page.  The default arrangement is to
+place most of the document description (title, author names and
+institutions, and abstract, but not the date) at the top of the first
+page.  If the optional <code class="code">no-repeat-info</code> argument is given,
+<samp class="file">ms</samp> produces a cover page but does not repeat any of its
+information subsequently (but see the <code class="code">DA</code> macro below regarding
+the date).  Normally, <code class="code">RP</code> sets the page number following the cover
+page to&nbsp;1.  Specifying the optional <code class="code">no-renumber</code> argument
+suppresses this alteration.  Optional arguments can occur in any order.
+<code class="code">no</code> is recognized as a synonym of <code class="code">no-repeat-info</code> for
+<code class="code">AT&amp;T</code> compatibility.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTL"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TL</code></strong><a class="copiable-link" href='#index-_002eTL'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TL-_005bms_005d"></a>
+<p>Specify the document title.  <samp class="file">ms</samp> collects text on input lines
+following this call into the title until reaching <code class="code">AU</code>, <code class="code">AB</code>,
+or a heading or paragraphing macro call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAU"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AU</code></strong><a class="copiable-link" href='#index-_002eAU'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AU-_005bms_005d"></a>
+<p>Specify an author&rsquo;s name.  <samp class="file">ms</samp> collects text on input lines
+following this call into the author&rsquo;s name until reaching <code class="code">AI</code>,
+<code class="code">AB</code>, another <code class="code">AU</code>, or a heading or paragraphing macro call.
+Call it repeatedly to specify multiple authors.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAI"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AI</code></strong><a class="copiable-link" href='#index-_002eAI'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AI-_005bms_005d"></a>
+<p>Specify the preceding author&rsquo;s institution.  An <code class="code">AU</code> call is
+usefully followed by at most one <code class="code">AI</code> call; if there are more, the
+last <code class="code">AI</code> call controls.  <samp class="file">ms</samp> collects text on input lines
+following this call into the author&rsquo;s institution until reaching
+<code class="code">AU</code>, <code class="code">AB</code>, or a heading or paragraphing macro call.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DA</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">x</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eDA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DA-_005bms_005d"></a>
+<p>Typeset the current date, or any arguments <var class="var">x</var>, in the center
+footer, and, if <code class="code">RP</code> is also called, left-aligned at the end of the
+description information on the cover page.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eND"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.ND</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">x</i></span> &hellip;</var><a class="copiable-link" href='#index-_002eND'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ND-_005bms_005d"></a>
+<p>Typeset the current date, or any arguments <var class="var">x</var>, if <code class="code">RP</code> is also
+called, left-aligned at the end of the document description on the cover
+page.  This is <code class="code">groff</code> <samp class="file">ms</samp>&rsquo;s default.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAB"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AB</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002eAB'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AB-_005bms_005d"></a>
+<p>Begin the abstract.  <samp class="file">ms</samp> collects text on input lines following
+this call into the abstract until reaching an <code class="code">AE</code> call.  By
+default, <samp class="file">ms</samp> places the word &ldquo;ABSTRACT&rdquo; centered and in italics
+above the text of the abstract.  The optional argument <code class="code">no</code>
+suppresses this heading.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AE</code></strong><a class="copiable-link" href='#index-_002eAE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AE-_005bms_005d"></a>
+<p>End the abstract.
+</p></dd></dl>
+
+<p>An example document description, using a cover page, follows.
+<a class="index-entry-id" id="index-cover-page-in-_005bms_005d_002c-example-markup"></a>
+<a class="index-entry-id" id="index-example-markup_002c-cover-page-in-_005bms_005d"></a>
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.RP
+.TL
+The Inevitability of Code Bloat
+in Commercial and Free Software
+.AU
+J.\&amp; Random Luser
+.AI
+University of West Bumblefuzz
+.AB
+This report examines the long-term growth of the code
+bases in two large,
+popular software packages;
+the free Emacs and the commercial Microsoft Word.
+While differences appear in the type or order of
+features added,
+due to the different methodologies used,
+the results are the same in the end.
+.PP
+The free software approach is shown to be superior in
+that while free software can become as bloated as
+commercial offerings,
+free software tends to have fewer serious bugs and the
+added features are more in line with user demand.
+.AE
+
+<span class="r">&hellip;the rest of the paper&hellip;</span>
+</pre></div>
+</td></tr></table>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Body-Text.html">Body Text</a>, Previous: <a href="ms-Document-Control-Settings.html">Document Control Settings</a>, Up: <a href="ms.html"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Document-Structure.html Added

@@ -0,0 +1,106 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Document Structure (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Document Structure (The GNU Troff Manual)">
+<meta name="keywords" content="ms Document Structure (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Document-Control-Settings.html" rel="next" title="ms Document Control Settings">
+<link href="ms-Introduction.html" rel="prev" title="ms Introduction">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Document-Structure">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Control-Settings.html" accesskey="n" rel="next">Document Control Settings</a>, Previous: <a href="ms-Introduction.html" accesskey="p" rel="prev">Introduction</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Document-Structure">4.6.2 Document Structure</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-general-structure"></a>
+
+<p>The <samp class="file">ms</samp> macro package expects a certain amount of structure:
+a well-formed document contains at least one paragraphing or heading
+macro call.  Longer documents have a structure as follows.
+</p>
+<dl class="table">
+<dt><strong class="strong">Document type</strong></dt>
+<dd><p>Calling the <code class="code">RP</code> macro at the beginning of your document puts the
+document description (see below) on a cover page.  Otherwise, <samp class="file">ms</samp>
+places the information (if any) on the first page, followed immediately
+by the body text.  Some document types found in other <samp class="file">ms</samp>
+implementations are specific to <abbr class="acronym">AT&amp;T</abbr> or Berkeley, and are not
+supported by <code class="code">groff</code> <samp class="file">ms</samp>.
+</p>
+</dd>
+<dt><strong class="strong">Format and layout</strong></dt>
+<dd><p>By setting registers and strings, you can configure your document&rsquo;s
+typeface, margins, spacing, headers and footers, and footnote
+arrangement.  See <a class="xref" href="ms-Document-Control-Settings.html">Document Control Settings</a>.
+</p>
+</dd>
+<dt><strong class="strong">Document description</strong></dt>
+<dd><p>A document description consists of any of: a title, one or more authors&rsquo;
+names and affiliated institutions, an abstract, and a date or other
+identifier.  See <a class="xref" href="ms-Document-Description-Macros.html">Document Description Macros</a>.
+</p>
+</dd>
+<dt><strong class="strong">Body text</strong></dt>
+<dd><p>The main matter of your document follows its description (if any).
+<samp class="file">ms</samp> supports highly structured text consisting of paragraphs
+interspersed with multi-level headings (chapters, sections, subsections,
+and so forth) and augmented by lists, footnotes, tables, diagrams, and
+similar material.  See <a class="xref" href="ms-Body-Text.html">Body Text</a>.
+</p>
+</dd>
+<dt><strong class="strong">Tables of contents</strong></dt>
+<dd><p>Macros enable the collection of entries for a table of contents (or
+index) as the material they discuss appears in the document.  You then
+call a macro to emit the table of contents at the end of your document.
+The table of contents must necessarily follow the rest of the text since
+GNU <code class="code">troff</code> is a single-pass formatter; it thus cannot determine
+the page number of a division of the text until it has been set and
+output.  Since <samp class="file">ms</samp> was designed for the production of hard copy,
+the traditional procedure was to manually relocate the pages containing
+the table of contents between the cover page and the body text.  Today,
+page resequencing is more often done in the digital domain.  An index
+works similarly, but because it typically needs to be sorted after
+collection, its preparation requires separate processing.
+</p></dd>
+</dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Control-Settings.html">Document Control Settings</a>, Previous: <a href="ms-Introduction.html">Introduction</a>, Up: <a href="ms.html"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Footnotes.html Added

@@ -0,0 +1,155 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Footnotes (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Footnotes (The GNU Troff Manual)">
+<meta name="keywords" content="ms Footnotes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="ms-Insertions.html" rel="prev" title="ms Insertions">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-Footnotes">
+<div class="nav-panel">
+<p>
+Previous: <a href="ms-Insertions.html" accesskey="p" rel="prev">Tables, figures, equations, and references</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Footnotes">4.6.5.10 Footnotes</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-footnotes"></a>
+<a class="index-entry-id" id="index-footnotes-_005bms_005d"></a>
+
+<a class="index-entry-id" id="index-footnote-marker-_005bms_005d"></a>
+<a class="index-entry-id" id="index-marker_002c-footnote-_005bms_005d"></a>
+<p>A footnote is typically anchored to a place in the text with a
+<em class="dfn">marker</em>, which is a small integer, a symbol such as a dagger, or
+arbitrary user-specified text.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002a_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\**</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002a_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002a-_005bms_005d"></a>
+<p>Place an <em class="dfn">automatic number</em>, an automatically generated numeric
+footnote marker, in the text.  Each time this string is interpolated,
+the number it produces increments by one.  Automatic numbers start at 1.
+This is a Berkeley extension.
+</p></dd></dl>
+
+<p>Enclose the footnote text in <code class="code">FS</code> and <code class="code">FE</code> macro calls to set
+it at the nearest available &ldquo;foot&rdquo;, or bottom, of a text column or
+page.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eFS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.FS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">marker</i></span></var><a class="copiable-link" href='#index-_002eFS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eFE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.FE</code></strong><a class="copiable-link" href='#index-_002eFE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-FE-_005bms_005d"></a>
+<p>Begin (<code class="code">FS</code>) and end (<code class="code">FE</code>) a footnote.  <code class="code">FS</code> calls
+<code class="code">FS-MARK</code> with any supplied <var class="var">marker</var> argument, which is then
+also placed at the beginning of the footnote text.  If <var class="var">marker</var> is
+omitted, the next pending automatic footnote number enqueued by
+interpolation of the <code class="code">*</code> string is used, and if none exists,
+nothing is prefixed.
+</p></dd></dl>
+
+<p>You may not desire automatically numbered footnotes in spite of their
+convenience.  You can indicate a footnote with a symbol or other text by
+specifying its marker at the appropriate place (for example, by using
+<code class="code">\dg</code> for the dagger glyph) <em class="emph">and</em> as an argument to the
+<code class="code">FS</code> macro.  Such manual marks should be repeated as arguments to
+<code class="code">FS</code> or as part of the footnote text to disambiguate their
+correspondence.  You may wish to use <code class="code">\*{</code> and <code class="code">\*}</code> to
+superscript the marker at the anchor point, in the footnote text, or
+both.
+</p>
+<p><code class="code">groff</code> <samp class="file">ms</samp> provides a hook macro, <code class="code">FS-MARK</code>, for
+user-determined operations to be performed when the <code class="code">FS</code> macro is
+called.  It is passed the same arguments as <code class="code">FS</code> itself.  An
+application of <code class="code">FS-MARK</code> is anchor placement for a hyperlink
+reference, so that a footnote can link back to its referential
+context.<a class="footnote" id="DOCF11" href="groff.html_fot.html#FOOT11"><sup>11</sup></a>  By default, this macro has an empty definition.
+<code class="code">FS-MARK</code> is a GNU extension.
+</p>
+<a class="index-entry-id" id="index-footnotes_002c-and-keeps-_005bms_005d"></a>
+<a class="index-entry-id" id="index-keeps_002c-and-footnotes-_005bms_005d"></a>
+<a class="index-entry-id" id="index-footnotes_002c-and-displays-_005bms_005d"></a>
+<a class="index-entry-id" id="index-displays_002c-and-footnotes-_005bms_005d"></a>
+<p>Footnotes can be safely used within keeps and displays, but you should
+avoid using automatically numbered footnotes within floating keeps.  You
+can place a second <code class="code">\**</code> interpolation between a <code class="code">\**</code> and its
+corresponding <code class="code">FS</code> call as long as each <code class="code">FS</code> call occurs
+<em class="emph">after</em> the corresponding <code class="code">\**</code> and occurrences of <code class="code">FS</code>
+are in the same order as corresponding occurrences of <code class="code">\**</code>.
+</p>
+<p>Footnote text is formatted as paragraphs are, using analogous
+parameters.  The registers <code class="code">FI</code>, <code class="code">FPD</code>, <code class="code">FPS</code>, and
+<code class="code">FVS</code> correspond to <code class="code">PI</code>, <code class="code">PD</code>, <code class="code">PS</code>, and <code class="code">CS</code>,
+respectively; <code class="code">FPD</code>, <code class="code">FPS</code>, and <code class="code">FVS</code> are GNU extensions.
+</p>
+<p>The <code class="code">FF</code> register controls the formatting of automatically numbered
+footnote paragraphs and those for which <code class="code">FS</code> is given a marker
+argument.  See <a class="xref" href="ms-Document-Control-Settings.html">Document Control Settings</a>.
+</p>
+<p>The default footnote line length is 11/12ths of the normal line length
+for compatibility with the expectations of historical <samp class="file">ms</samp>
+documents; you may wish to set the <code class="code">FR</code> string to &lsquo;<samp class="samp">1</samp>&rsquo; to align
+with contemporary typesetting practices.  In the
+past,<a class="footnote" id="DOCF12" href="groff.html_fot.html#FOOT12"><sup>12</sup></a> an <code class="code">FL</code> register
+was used for the line length in footnotes; however, setting this
+register at document initialization time had no effect on the footnote
+line length in multi-column arrangements.<a class="footnote" id="DOCF13" href="groff.html_fot.html#FOOT13"><sup>13</sup></a>
+</p>
+<p><code class="code">FR</code> should be used in preference to the old <code class="code">FL</code> register in
+contemporary documents.  The footnote line length is effectively
+computed as &lsquo;<samp class="samp"><i class="slanted">column-width</i> * \*FR</samp>&rsquo;.  If an absolute
+footnote line length is required, recall that arithmetic expressions in
+<code class="code">roff</code> input are evaluated strictly from left to right, with no
+operator precedence (parentheses are honored).
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.ds FR 0+3i \&quot; Set footnote line length to 3 inches.
+</pre></div></div>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="ms-Insertions.html">Tables, figures, equations, and references</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Headers-and-Footers.html Added

@@ -0,0 +1,122 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Headers and Footers (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Headers and Footers (The GNU Troff Manual)">
+<meta name="keywords" content="ms Headers and Footers (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Page-Layout.html" rel="up" title="ms Page Layout">
+<link href="Tab-Stops-in-ms.html" rel="next" title="Tab Stops in ms">
+<link href="ms-Page-Layout.html" rel="prev" title="ms Page Layout">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-Headers-and-Footers">
+<div class="nav-panel">
+<p>
+Next: <a href="Tab-Stops-in-ms.html" accesskey="n" rel="next">Tab stops</a>, Previous: <a href="ms-Page-Layout.html" accesskey="p" rel="prev">Page layout</a>, Up: <a href="ms-Page-Layout.html" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Headers-and-footers">4.6.6.1 Headers and footers</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-headers"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-footers"></a>
+<a class="index-entry-id" id="index-headers-_005bms_005d"></a>
+<a class="index-entry-id" id="index-footers-_005bms_005d"></a>
+
+<p>There are multiple ways to produce headers and footers.  One is to
+define the strings <code class="code">LH</code>, <code class="code">CH</code>, and <code class="code">RH</code> to set the left,
+center, and right headers, respectively; and <code class="code">LF</code>, <code class="code">CF</code>, and
+<code class="code">RF</code> to set the left, center, and right footers.  This approach
+suffices for documents that do not distinguish odd- and even-numbered
+pages.
+</p>
+<p>Another method is to call macros that set headers or footers for odd- or
+even-numbered pages.  Each such macro takes a delimited argument
+separating the left, center, and right header or footer texts from each
+other.  You can replace the neutral apostrophes (<code class="code">'</code>) shown below
+with any character not appearing in the header or footer text.  These
+macros are Berkeley extensions.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eOH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.OH</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eOH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EH</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eEH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EH-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eOF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.OF</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eOF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OF-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EF</code></strong> <var class="def-var-arguments"><code class="code">'</code><span class="r"><i class="slanted">left</i></span><code class="code">'</code><span class="r"><i class="slanted">center</i></span><code class="code">'</code><span class="r"><i class="slanted">right</i></span><code class="code">'</code></var><a class="copiable-link" href='#index-_002eEF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EF-_005bms_005d"></a>
+<p>The <code class="code">OH</code> and <code class="code">EH</code> macros define headers for odd- (recto)
+and even-numbered (verso) pages, respectively; the <code class="code">OF</code> and
+<code class="code">EF</code> macros define footers for them.
+</p></dd></dl>
+
+<p>With either method, a percent sign <code class="code">%</code> in header or footer text is
+replaced by the current page number.  By default, <samp class="file">ms</samp> places no
+header on a page numbered &ldquo;1&rdquo; (regardless of its number format).
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eP1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.P1</code></strong><a class="copiable-link" href='#index-_002eP1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-P1-_005bms_005d"></a>
+<p>Typeset the header even on page&nbsp;1.  To be effective, this macro
+must be called before the header trap is sprung on any page numbered
+&ldquo;1&rdquo;; in practice, unless your page numbering is unusual, this means
+that you should call it early, before <code class="code">TL</code> or any heading or
+paragraphing macro.  This is a Berkeley extension.
+</p></dd></dl>
+
+<p>For even greater flexibility, <samp class="file">ms</samp> is designed to permit the
+redefinition of the macros that are called when the <code class="code">groff</code> traps
+that ordinarily cause the headers and footers to be output are sprung.
+<code class="code">PT</code> (&ldquo;page trap&rdquo;) is called by <samp class="file">ms</samp> when the header is to
+be written, and <code class="code">BT</code> (&ldquo;bottom trap&rdquo;) when the footer is to be.
+The <code class="code">groff</code> page location trap that <samp class="file">ms</samp> sets up to format the
+header also calls the (normally undefined) <code class="code">HD</code> macro after
+<code class="code">PT</code>; you can define <code class="code">HD</code> if you need additional processing
+after setting the header (for example, to draw a line below it).
+The <code class="code">HD</code> hook is a Berkeley extension.  Any such macros you
+(re)define must implement any desired specialization for odd-, even-, or
+first numbered pages.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Tab-Stops-in-ms.html">Tab stops</a>, Previous: <a href="ms-Page-Layout.html">Page layout</a>, Up: <a href="ms-Page-Layout.html">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Insertions.html Added

@@ -0,0 +1,181 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Insertions (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Insertions (The GNU Troff Manual)">
+<meta name="keywords" content="ms Insertions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="ms-Footnotes.html" rel="next" title="ms Footnotes">
+<link href="ms-keeps-and-displays.html" rel="prev" title="ms keeps and displays">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-Insertions">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Footnotes.html" accesskey="n" rel="next">Footnotes</a>, Previous: <a href="ms-keeps-and-displays.html" accesskey="p" rel="prev">Keeps, boxed keeps, and displays</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Tables_002c-figures_002c-equations_002c-and-references">4.6.5.9 Tables, figures, equations, and references</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-tables"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-figures"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-equations"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-references"></a>
+<a class="index-entry-id" id="index-tables-_005bms_005d"></a>
+<a class="index-entry-id" id="index-figures-_005bms_005d"></a>
+<a class="index-entry-id" id="index-equations-_005bms_005d"></a>
+<a class="index-entry-id" id="index-references-_005bms_005d"></a>
+
+<p>The <samp class="file">ms</samp> package is often used with the <code class="code">tbl</code>, <code class="code">pic</code>,
+<code class="code">eqn</code>, and <code class="code">refer</code> preprocessors.
+<a class="index-entry-id" id="index-tbl"></a>
+<a class="index-entry-id" id="index-pic"></a>
+<a class="index-entry-id" id="index-eqn"></a>
+<a class="index-entry-id" id="index-refer"></a>
+Mark text meant for preprocessors by enclosing it in pairs of tokens
+as follows, with nothing between the dot and the macro name.  The
+preprocessors match these tokens only at the start of an input line.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TS</code></strong> <var class="def-var-arguments"><code class="code">H</code></var><a class="copiable-link" href='#index-_002eTS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eTE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TE</code></strong><a class="copiable-link" href='#index-_002eTE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TE-_005bms_005d"></a>
+<p>Demarcate a table to be processed by the <code class="code">tbl</code> preprocessor.  The
+optional argument&nbsp;<code class="code">H</code> to <code class="code">TS</code> instructs <samp class="file">ms</samp> to
+repeat table rows (often column headings) at the top of each new page
+the table spans, if applicable; calling the <code class="code">TH</code> macro marks the
+end of such rows.  The GNU <cite class="cite">tbl<span class="r">(1)</span></cite> man page provides a
+comprehensive reference to the preprocessor and offers examples of its
+use.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PS</code></strong><a class="copiable-link" href='#index-_002ePS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002ePE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PE</code></strong><a class="copiable-link" href='#index-_002ePE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PE-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002ePF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PF</code></strong><a class="copiable-link" href='#index-_002ePF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PF-_005bms_005d"></a>
+<p><code class="code">PS</code> begins a picture to be processed by the <code class="command">gpic</code>
+preprocessor; either of <code class="code">PE</code> or <code class="code">PF</code> ends it, the latter with
+&ldquo;flyback&rdquo; to the vertical position at its top.  You can create
+<code class="code">pic</code> input manually or with a program such as <code class="code">xfig</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eEQ"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EQ</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">align</i></span> <span class="r"><i class="slanted">label</i></span></var><a class="copiable-link" href='#index-_002eEQ'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EQ-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eEN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.EN</code></strong><a class="copiable-link" href='#index-_002eEN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-EN-_005bms_005d"></a>
+<p>Demarcate an equation to be processed by the <code class="code">eqn</code> preprocessor.
+The equation is centered by default; <var class="var">align</var> can be &lsquo;<samp class="samp">C</samp>&rsquo;,
+&lsquo;<samp class="samp">L</samp>&rsquo;, or &lsquo;<samp class="samp">I</samp>&rsquo; to (explicitly) center, left-align, or indent it
+by the amount stored in the <code class="code">DI</code> register, respectively.  If
+specified, <var class="var">label</var> is set right-aligned.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e_005b"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.</code></strong><a class="copiable-link" href='#index-_002e_005b'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005b-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002e_005d"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.</code></strong><a class="copiable-link" href='#index-_002e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005d-_005bms_005d"></a>
+<p>Demarcate a bibliographic citation to be processed by the <code class="code">refer</code>
+preprocessor.  The GNU <cite class="cite">refer<span class="r">(1)</span></cite> man page provides a
+comprehensive reference to the preprocessor and the format of its
+bibliographic database.  Type &lsquo;<samp class="samp">man refer</samp>&rsquo; at the command line to
+view it.
+</p></dd></dl>
+
+<p>When <code class="code">refer</code> emits collected references (as might be done on a
+&ldquo;Works Cited&rdquo; page), it interpolates the <code class="code">REFERENCES</code> string as
+an unnumbered heading (<code class="code">SH</code>).
+</p>
+<a class="index-entry-id" id="index-table_002c-multi_002dpage_002c-example-_005bms_005d"></a>
+<a class="index-entry-id" id="index-multi_002dpage-table-example-_005bms_005d"></a>
+<p>The following is an example of how to set up a table that may print
+across two or more pages.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.TS H
+allbox;
+Cb | Cb .
+Part&rarr;Description
+_
+.TH
+.T&amp;
+GH-1978&rarr;Fribulating gonkulator
+<span class="r">&hellip;the rest of the table follows&hellip;</span>
+.TE
+</pre></div>
+</td></tr></table>
+
+<p>Attempting to place a multi-page table inside a keep can lead to
+unpleasant results, particularly if the <code class="code">tbl</code> <code class="code">allbox</code> option
+is used.
+</p>
+<a class="index-entry-id" id="index-equation-example-_005bms_005d"></a>
+<p>Mathematics can be typeset using the language of the <code class="code">eqn</code>
+preprocessor.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.EQ C (\*SN-NO-DOTa)
+p ~ = ~ q sqrt { ( 1 + ~ ( x / q sup 2 ) }
+.EN
+</pre></div>
+</td></tr></table>
+
+<p>This input formats a labelled equation.  We used the <code class="code">SN-NO-DOT</code>
+string to base the equation label on the current heading number, giving
+us more flexibility to reorganize the document.
+</p>
+<p>Use <code class="command">groff</code> options to run preprocessors on the input:
+<samp class="option">-e</samp> for <code class="command">geqn</code>, <samp class="option">-p</samp> for <code class="command">gpic</code>,
+<samp class="option">-R</samp> for <code class="command">grefer</code>, and <samp class="option">-t</samp> for <code class="command">gtbl</code>.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Footnotes.html">Footnotes</a>, Previous: <a href="ms-keeps-and-displays.html">Keeps, boxed keeps, and displays</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Introduction.html Added

@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Introduction (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Introduction (The GNU Troff Manual)">
+<meta name="keywords" content="ms Introduction (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Document-Structure.html" rel="next" title="ms Document Structure">
+<link href="ms.html" rel="prev" title="ms">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Introduction">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Structure.html" accesskey="n" rel="next">Document Structure</a>, Previous: <a href="ms.html" accesskey="p" rel="prev"><samp class="file">ms</samp></a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Introduction-2">4.6.1 Introduction</h4>
+
+<p>The <samp class="file">ms</samp> macros are the oldest surviving package for <code class="code">roff</code>
+systems.<a class="footnote" id="DOCF7" href="groff.html_fot.html#FOOT7"><sup>7</sup></a>  While the <samp class="file">man</samp>
+package was designed for brief reference documents, the <samp class="file">ms</samp> macros
+are also suitable for longer works intended for printing and possible
+publication.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="ms-basic-information.html" accesskey="1">Basic information</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Legacy-Features.html Added

@@ -0,0 +1,285 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Legacy Features (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Legacy Features (The GNU Troff Manual)">
+<meta name="keywords" content="ms Legacy Features (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Naming-Conventions.html" rel="next" title="ms Naming Conventions">
+<link href="Differences-from-AT_0026T-ms.html" rel="prev" title="Differences from AT&amp;T ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Legacy-Features">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Naming-Conventions.html" accesskey="n" rel="next">Naming Conventions</a>, Previous: <a href="Differences-from-AT_0026T-ms.html" accesskey="p" rel="prev">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Legacy-Features">4.6.8 Legacy Features</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-strings"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-special-characters"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-accent-marks"></a>
+<a class="index-entry-id" id="index-accent-marks-_005bms_005d"></a>
+<a class="index-entry-id" id="index-special-characters-_005bms_005d"></a>
+<a class="index-entry-id" id="index-strings-_005bms_005d"></a>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> retains some legacy features solely to support
+formatting of historical documents; contemporary ones should not use
+them because they can render poorly.  See the <cite class="cite">groff_char<span class="r">(7)</span></cite>
+man page.
+</p>
+<ul class="mini-toc">
+<li><a href="#AT_0026T-accent-mark-strings" accesskey="1">AT&amp;T accent mark strings</a></li>
+<li><a href="#Berkeley-accent-mark-and-glyph-strings" accesskey="2">Berkeley accent mark and glyph strings</a></li>
+</ul>
+<div class="unnumberedsubsubsec-level-extent" id="AT_0026T-accent-mark-strings">
+<h4 class="unnumberedsubsubsec">AT&amp;T accent mark strings</h4>
+
+<p>AT&amp;T <samp class="file">ms</samp> defined accent mark strings as follows.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0027_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0027_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0027-_005bms_005d"></a>
+<p>Apply acute accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0060_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">`</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0060_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0060-_005bms_005d"></a>
+<p>Apply grave accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003a_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*:</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003a_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003a-_005bms_005d"></a>
+<p>Apply dieresis (umlaut) to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*^</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005e-_005bms_005d"></a>
+<p>Apply circumflex accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*~</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007e-_005bms_005d"></a>
+<p>Apply tilde accent to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bC_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*C</code></strong><a class="copiable-link" href='#index-_005c_002a_005bC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-C-_005bms_005d"></a>
+<p>Apply caron to subsequent glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002c_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*,</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002c_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002c-_005bms_005d"></a>
+<p>Apply cedilla to subsequent glyph.
+</p></dd></dl>
+
+</div>
+<div class="unnumberedsubsubsec-level-extent" id="Berkeley-accent-mark-and-glyph-strings">
+<h4 class="unnumberedsubsubsec">Berkeley accent mark and glyph strings</h4>
+
+<p>Berkeley <samp class="file">ms</samp> offered an <code class="code">AM</code> macro; calling it redefined the
+AT&amp;T accent mark strings (except for &lsquo;<samp class="samp">\*C</samp>&rsquo;), applied them to the
+<em class="emph">preceding</em> glyph, and defined additional strings, some for spacing
+glyphs.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eAM"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.AM</code></strong><a class="copiable-link" href='#index-_002eAM'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-AM-_005bms_005d"></a>
+<p>Enable alternative accent mark and glyph-producing strings.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0027_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">'</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0027_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0027-_005bms_005d-1"></a>
+<p>Apply acute accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0060_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*<code class="code">`</code></code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0060_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0060-_005bms_005d-1"></a>
+<p>Apply grave accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003a_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*:</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003a_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003a-_005bms_005d-1"></a>
+<p>Apply dieresis (umlaut) to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005e_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*^</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005e_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005e-_005bms_005d-1"></a>
+<p>Apply circumflex accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_007e_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*~</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_007e_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_007e-_005bms_005d-1"></a>
+<p>Apply tilde accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002c_005d-1"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*,</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002c_005d-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002c-_005bms_005d-1"></a>
+<p>Apply cedilla to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*/</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002f-_005bms_005d"></a>
+<p>Apply stroke (slash) to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bv_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*v</code></strong><a class="copiable-link" href='#index-_005c_002a_005bv_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-v-_005bms_005d"></a>
+<p>Apply caron to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_005f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*_</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_005f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_005f-_005bms_005d"></a>
+<p>Apply macron to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_002e_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*.</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_002e_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_002e-_005bms_005d"></a>
+<p>Apply underdot to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bo_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*o</code></strong><a class="copiable-link" href='#index-_005c_002a_005bo_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-o-_005bms_005d"></a>
+<p>Apply ring accent to preceding glyph.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_003f_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*?</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_003f_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_003f-_005bms_005d"></a>
+<p>Interpolate inverted question mark.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b_0021_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*!</code></strong><a class="copiable-link" href='#index-_005c_002a_005b_0021_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-_0021-_005bms_005d"></a>
+<p>Interpolate inverted exclamation mark.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b8_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*8</code></strong><a class="copiable-link" href='#index-_005c_002a_005b8_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-8-_005bms_005d"></a>
+<p>Interpolate small letter sharp s.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bq_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*q</code></strong><a class="copiable-link" href='#index-_005c_002a_005bq_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-q-_005bms_005d"></a>
+<p>Interpolate small letter o with hook accent (ogonek).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005b3_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*3</code></strong><a class="copiable-link" href='#index-_005c_002a_005b3_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-3-_005bms_005d"></a>
+<p>Interpolate small letter yogh.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bd_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*d-</code></strong><a class="copiable-link" href='#index-_005c_002a_005bd_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-d_002d-_005bms_005d"></a>
+<p>Interpolate small letter eth.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bD_002d_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*D-</code></strong><a class="copiable-link" href='#index-_005c_002a_005bD_002d_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-D_002d-_005bms_005d"></a>
+<p>Interpolate capital letter eth.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bth_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*th</code></strong><a class="copiable-link" href='#index-_005c_002a_005bth_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-th-_005bms_005d"></a>
+<p>Interpolate small letter thorn.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bTh_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Th</code></strong><a class="copiable-link" href='#index-_005c_002a_005bTh_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Th-_005bms_005d"></a>
+<p>Interpolate capital letter thorn.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bae_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*ae</code></strong><a class="copiable-link" href='#index-_005c_002a_005bae_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ae-_005bms_005d"></a>
+<p>Interpolate small æ ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bAe_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*Ae</code></strong><a class="copiable-link" href='#index-_005c_002a_005bAe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-Ae-_005bms_005d"></a>
+<p>Interpolate capital Æ ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005boe_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*oe</code></strong><a class="copiable-link" href='#index-_005c_002a_005boe_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-oe-_005bms_005d"></a>
+<p>Interpolate small oe ligature.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bOE_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*OE</code></strong><a class="copiable-link" href='#index-_005c_002a_005bOE_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-OE-_005bms_005d"></a>
+<p>Interpolate capital OE ligature.
+</p></dd></dl>
+
+
+</div>
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Naming-Conventions.html">Naming Conventions</a>, Previous: <a href="Differences-from-AT_0026T-ms.html">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Up: <a href="ms.html"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Margins.html Added

@@ -0,0 +1,56 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Margins (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Margins (The GNU Troff Manual)">
+<meta name="keywords" content="ms Margins (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Page-Layout.html" rel="up" title="ms Page Layout">
+<link href="ms-Multiple-Columns.html" rel="next" title="ms Multiple Columns">
+<link href="Tab-Stops-in-ms.html" rel="prev" title="Tab Stops in ms">
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-Margins">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Multiple-Columns.html" accesskey="n" rel="next">Multiple columns</a>, Previous: <a href="Tab-Stops-in-ms.html" accesskey="p" rel="prev">Tab stops</a>, Up: <a href="ms-Page-Layout.html" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Margins">4.6.6.3 Margins</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-margins"></a>
+
+<p>Control margins using the registers summarized in &ldquo;Margin settings&rdquo; in
+<a class="ref" href="ms-Document-Control-Settings.html">Document Control Settings</a> above.  There is no setting for the
+right margin; the combination of page offset <code class="code">\nPO</code> and line
+length <code class="code">\nLL</code> determines it.
+</p>
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Multiple-Columns.html Added

@@ -0,0 +1,88 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Multiple Columns (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Multiple Columns (The GNU Troff Manual)">
+<meta name="keywords" content="ms Multiple Columns (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Page-Layout.html" rel="up" title="ms Page Layout">
+<link href="ms-TOC.html" rel="next" title="ms TOC">
+<link href="ms-Margins.html" rel="prev" title="ms Margins">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-Multiple-Columns">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-TOC.html" accesskey="n" rel="next">Creating a table of contents</a>, Previous: <a href="ms-Margins.html" accesskey="p" rel="prev">Margins</a>, Up: <a href="ms-Page-Layout.html" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Multiple-columns">4.6.6.4 Multiple columns</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-multiple-columns"></a>
+<a class="index-entry-id" id="index-multiple-columns-_005bms_005d"></a>
+
+<p><samp class="file">ms</samp> can set text in as many columns as reasonably fit on the page.
+The following macros force a page break if a multi-column layout is
+active when they are called.  The <code class="code">MINGW</code> register stores the
+default minimum gutter width; it is a GNU extension.  When multiple
+columns are in use, keeps and the <code class="code">HORPHANS</code> and <code class="code">PORPHANS</code>
+registers work with respect to column breaks instead of page breaks.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e1C"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.1C</code></strong><a class="copiable-link" href='#index-_002e1C'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-1C-_005bms_005d"></a>
+<p>Arrange page text in a single column (the default).
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002e2C"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.2C</code></strong><a class="copiable-link" href='#index-_002e2C'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-2C-_005bms_005d"></a>
+<p>Arrange page text in two columns.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eMC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.MC</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">column-width</i></span> <span class="r"><i class="slanted">gutter-width</i></span></var><a class="copiable-link" href='#index-_002eMC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MC-_005bms_005d"></a>
+<p>Arrange page text in multiple columns.  If you specify no arguments, it
+is equivalent to the <code class="code">2C</code> macro.  Otherwise, <var class="var">column-width</var> is
+the width of each column and <var class="var">gutter-width</var> is the minimum distance
+between columns.
+</p></dd></dl>
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Naming-Conventions.html Added

@@ -0,0 +1,89 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Naming Conventions (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Naming Conventions (The GNU Troff Manual)">
+<meta name="keywords" content="ms Naming Conventions (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="ms-Legacy-Features.html" rel="prev" title="ms Legacy Features">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Naming-Conventions">
+<div class="nav-panel">
+<p>
+Previous: <a href="ms-Legacy-Features.html" accesskey="p" rel="prev">Legacy Features</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Naming-Conventions">4.6.9 Naming Conventions</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-naming-conventions"></a>
+<a class="index-entry-id" id="index-naming-conventions_002c-ms-macros"></a>
+
+<p>The following conventions are used for names of macros, strings, and
+registers.  External names available to documents that use the
+<code class="code">groff</code> <samp class="file">ms</samp> macros contain only uppercase letters and digits.
+</p>
+<p>Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
+</p>
+<ul class="itemize mark-bullet">
+<li>Names used only within one module are of the form
+<var class="var">module</var><code class="code">*</code><var class="var">name</var>.
+
+</li><li>Names used outside the module in which they are defined are of the form
+<var class="var">module</var><code class="code">@</code><var class="var">name</var>.
+
+</li><li>Names associated with a particular environment are of the form
+<var class="var">environment</var><code class="code">:</code><var class="var">name</var>; these are used only within the
+<code class="code">par</code> module.
+
+</li><li><var class="var">name</var> does not have a module prefix.
+
+</li><li>Constructed names used to implement arrays are of the form
+<var class="var">array</var><code class="code">!</code><var class="var">index</var>.
+</li></ul>
+
+<p>Thus the <code class="code">groff</code> <samp class="file">ms</samp> macros reserve the following names.
+</p>
+<ul class="itemize mark-bullet">
+<li>Names containing the characters <code class="code">*</code>, <code class="code">@</code>, and&nbsp;<code class="code">:</code>.
+
+</li><li>Names containing only uppercase letters and digits.
+</li></ul>
+
+
+
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-Page-Layout.html Added

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms Page Layout (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms Page Layout (The GNU Troff Manual)">
+<meta name="keywords" content="ms Page Layout (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms.html" rel="up" title="ms">
+<link href="Differences-from-AT_0026T-ms.html" rel="next" title="Differences from AT&amp;T ms">
+<link href="ms-Body-Text.html" rel="prev" title="ms Body Text">
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="ms-Page-Layout">
+<div class="nav-panel">
+<p>
+Next: <a href="Differences-from-AT_0026T-ms.html" accesskey="n" rel="next">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Previous: <a href="ms-Body-Text.html" accesskey="p" rel="prev">Body Text</a>, Up: <a href="ms.html" accesskey="u" rel="up"><samp class="file">ms</samp></a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="Page-layout">4.6.6 Page layout</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-page-layout"></a>
+<a class="index-entry-id" id="index-page-layout-_005bms_005d"></a>
+
+<p><samp class="file">ms</samp>&rsquo;s default page layout arranges text in a single column with
+the page number between hyphens centered in a header on each page except
+the first, and produces no footers.  You can customize this arrangement.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="ms-Headers-and-Footers.html" accesskey="1">Headers and footers</a></li>
+<li><a href="Tab-Stops-in-ms.html" accesskey="2">Tab stops</a></li>
+<li><a href="ms-Margins.html" accesskey="3">Margins</a></li>
+<li><a href="ms-Multiple-Columns.html" accesskey="4">Multiple columns</a></li>
+<li><a href="ms-TOC.html" accesskey="5">Creating a table of contents</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-TOC.html Added

@@ -0,0 +1,242 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms TOC (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms TOC (The GNU Troff Manual)">
+<meta name="keywords" content="ms TOC (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Page-Layout.html" rel="up" title="ms Page Layout">
+<link href="Differences-from-AT_0026T-ms.html" rel="next" title="Differences from AT&amp;T ms">
+<link href="ms-Multiple-Columns.html" rel="prev" title="ms Multiple Columns">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-TOC">
+<div class="nav-panel">
+<p>
+Next: <a href="Differences-from-AT_0026T-ms.html" accesskey="n" rel="next">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Previous: <a href="ms-Multiple-Columns.html" accesskey="p" rel="prev">Multiple columns</a>, Up: <a href="ms-Page-Layout.html" accesskey="u" rel="up">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Creating-a-table-of-contents">4.6.6.5 Creating a table of contents</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-creating-table-of-contents"></a>
+<a class="index-entry-id" id="index-table-of-contents_002c-creating-_005bms_005d"></a>
+
+<p>Because <code class="code">roff</code> formatters process their input in a single pass,
+material on page 50, for example, cannot influence what appears on
+page&nbsp;1&mdash;this poses a challenge for a table of contents at its
+traditional location in front matter, if you wish to avoid manually
+maintaining it.  <samp class="file">ms</samp> enables the collection of material to be
+presented in the table of contents as it appears, saving its page number
+along with it, and then emitting the collected contents on demand toward
+the end of the document.  The table of contents can then be resequenced
+to its desired location by physically rearranging the pages of a printed
+document, or as part of post-processing&mdash;with a <cite class="cite">sed<span class="r">(1)</span></cite>
+script to reorder the pages in <code class="command">troff</code>&rsquo;s output, with
+<cite class="cite">pdfjam<span class="r">(1)</span></cite>, or with <cite class="cite">gropdf<span class="r">(1)</span></cite>&rsquo;s
+&lsquo;<samp class="samp">.pdfswitchtopage</samp>&rsquo; feature, for example.
+</p>
+<p>Define an entry to appear in the table of contents by bracketing its
+text between calls to the <code class="code">XS</code> and <code class="code">XE</code> macros.  A typical
+application is to call them immediately after <code class="code">NH</code> or <code class="code">SH</code> and
+repeat the heading text within them.  The <code class="code">XA</code> macro, used within
+&lsquo;<samp class="samp">.XS</samp>&rsquo;/&lsquo;<samp class="samp">.XE</samp>&rsquo; pairs, supplements an entry&mdash;for instance, when
+it requires multiple output lines, whether because a heading is too long
+to fit or because style dictates that page numbers not be repeated.  You
+may wish to indent the text thus wrapped to correspond to its heading
+depth; this can be done in the entry text by prefixing it with tabs or
+horizontal motion escape sequences, or by providing a second argument to
+the <code class="code">XA</code> macro.  <code class="code">XS</code> and <code class="code">XA</code> automatically associate
+the page number where they are called with the text following them, but
+they accept arguments to override this behavior.  At the end of the
+document, call <code class="code">TC</code> or <code class="code">PX</code> to emit the table of contents;
+<code class="code">TC</code> resets the page number to &lsquo;<samp class="samp">i</samp>&rsquo; (Roman numeral one), and
+then calls <code class="code">PX</code>.  All of these macros are Berkeley extensions.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XS</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span></var><a class="copiable-link" href='#index-_002eXS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXA"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XA</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">page-number</i></span> <span class="r"><i class="slanted">indentation</i></span></var><a class="copiable-link" href='#index-_002eXA'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XA-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XE</code></strong><a class="copiable-link" href='#index-_002eXE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XE-_005bms_005d"></a>
+<p>Begin, supplement, and end a table of contents entry.  Each entry is
+associated with <var class="var">page-number</var> (otherwise the current page number); a
+<var class="var">page-number</var> of &lsquo;<samp class="samp">no</samp>&rsquo; prevents a leader and page number from
+being emitted for that entry.  Use of <code class="code">XA</code> within
+<code class="code">XS</code>/<code class="code">XE</code> is optional; it can be repeated.  If
+<var class="var">indentation</var> is present, a supplemental entry is indented by that
+amount; ens are assumed if no unit is indicated.  Text on input lines
+between <code class="code">XS</code> and <code class="code">XE</code> is stored for later recall by <code class="code">PX</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002ePX"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.PX</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002ePX'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-PX-_005bms_005d"></a>
+<p>Switch to single-column layout.  Unless <code class="code">no</code> is specified, center
+and interpolate the <code class="code">TOC</code> string in bold and two points larger than
+the body text.  Emit the table of contents entries.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eTC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.TC</code></strong> <var class="def-var-arguments"><code class="code">no</code></var><a class="copiable-link" href='#index-_002eTC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TC-_005bms_005d"></a>
+<p>Set the page number to&nbsp;1, the page number format to lowercase Roman
+numerals, and call <code class="code">PX</code> (with a <code class="code">no</code> argument, if present).
+</p></dd></dl>
+
+<p>Here&rsquo;s an example of typical <samp class="file">ms</samp> table of contents preparation.
+We employ horizontal escape sequences <code class="code">\h</code> to indent the entries by
+sectioning depth.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+Introduction
+.XS
+Introduction
+.XE
+<span class="r">&hellip;</span>
+.NH 2
+Methodology
+.XS
+\h'2n'Methodology
+.XA
+\h'4n'Fassbinder's Approach
+\h'4n'Kahiu's Approach
+.XE
+<span class="r">&hellip;</span>
+.NH 1
+Findings
+.XS
+Findings
+.XE
+<span class="r">&hellip;</span>
+.TC
+</pre></div>
+</td></tr></table>
+
+<p>The remaining features in this subsubsection are GNU extensions.
+<code class="code">groff</code> <samp class="file">ms</samp> obviates the need to repeat heading text after
+<code class="code">XS</code> calls.  Call <code class="code">XN</code> and <code class="code">XH</code> after <code class="code">NH</code> and
+<code class="code">SH</code>, respectively.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXN'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH-_005bms_005d"></a>
+<p>Format <var class="var">heading-text</var> and create a corresponding table of contents
+entry.  <code class="code">XN</code> computes the indentation from the depth of the
+preceding <code class="code">NH</code> call; <code class="code">XH</code> requires a <var class="var">depth</var> argument to
+do so.
+</p></dd></dl>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> encourages customization of table of contents
+entry production.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN_002dREPLACEMENT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN-REPLACEMENT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXN_002dREPLACEMENT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN_002dREPLACEMENT-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH_002dREPLACEMENT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH-REPLACEMENT</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH_002dREPLACEMENT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH_002dREPLACEMENT-_005bms_005d"></a>
+<p>These hook macros implement <code class="code">XN</code> and <code class="code">XH</code>, respectively.
+They call <code class="code">XN-INIT</code> and pass their <var class="var">heading-text</var> arguments to
+<code class="code">XH-UPDATE-TOC</code>.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eXN_002dINIT"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XN-INIT</code></strong><a class="copiable-link" href='#index-_002eXN_002dINIT'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XN_002dINIT-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eXH_002dUPDATE_002dTOC"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.XH-UPDATE-TOC</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">depth</i></span> <span class="r"><i class="slanted">heading-text</i></span></var><a class="copiable-link" href='#index-_002eXH_002dUPDATE_002dTOC'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-XH_002dUPDATE_002dTOC-_005bms_005d"></a>
+<p>The <code class="code">XN-INIT</code> hook macro does nothing by default.
+<code class="code">XH-UPDATE-TOC</code> brackets <var class="var">heading-text</var> with <code class="code">XS</code> and
+<code class="code">XE</code> calls, indenting it by 2 ens per level of <var class="var">depth</var> beyond
+the first.
+</p></dd></dl>
+
+<p>We could therefore produce a table of contents similar to that in the
+previous example with fewer macro calls.  (The difference is that this
+input follows the &ldquo;Approach&rdquo; entries with leaders and page numbers.)
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.NH 1
+.XN Introduction
+<span class="r">&hellip;</span>
+.NH 2
+.XN Methodology
+.XH 3 &quot;Fassbinder's Approach&quot;
+.XH 3 &quot;Kahiu's Approach&quot;
+<span class="r">&hellip;</span>
+.NH 1
+.XN Findings
+<span class="r">&hellip;</span>
+</pre></div>
+</td></tr></table>
+
+<p>To get the section number of the numbered headings into the table of
+contents entries, we might define <code class="code">XN-REPLACEMENT</code> as follows.
+(We obtain the heading depth from <code class="code">groff</code> <samp class="file">ms</samp>&rsquo;s internal
+register <code class="code">nh*hl</code>.)
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.de XN-REPLACEMENT
+.XN-INIT
+.XH-UPDATE-TOC \\nnh*hl \\$@
+\&amp;\\*SN \\$*
+..
+</pre></div>
+</td></tr></table>
+
+<p>You can change the style of the leader that bridges each table of
+contents entry with its page number; define the <code class="code">TC-LEADER</code> special
+character by using the <code class="code">char</code> request.  A typical leader combines
+the dot glyph &lsquo;<samp class="samp">.</samp>&rsquo; with a horizontal motion escape sequence to
+spread the dots.  The width of the page number field is stored in the
+<code class="code">TC-MARGIN</code> register.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Differences-from-AT_0026T-ms.html">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a>, Previous: <a href="ms-Multiple-Columns.html">Multiple columns</a>, Up: <a href="ms-Page-Layout.html">Page layout</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-basic-information.html Added

@@ -0,0 +1,211 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms basic information (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms basic information (The GNU Troff Manual)">
+<meta name="keywords" content="ms basic information (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Introduction.html" rel="up" title="ms Introduction">
+<link href="ms-Document-Structure.html" rel="next" title="ms Document Structure">
+<link href="ms-Introduction.html" rel="prev" title="ms Introduction">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-basic-information">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Structure.html" accesskey="n" rel="next">Document Structure</a>, Previous: <a href="ms-Introduction.html" accesskey="p" rel="prev">Introduction</a>, Up: <a href="ms-Introduction.html" accesskey="u" rel="up">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Basic-information">4.6.1.1 Basic information</h4>
+
+<p><samp class="file">ms</samp> documents are plain text files; prepare them with your
+preferred text editor.  If you&rsquo;re in a hurry to start, know that
+<samp class="file">ms</samp> needs one of its macros called at the beginning of a document
+so that it can initialize.  A <em class="dfn">macro</em> is a formatting instruction to
+<samp class="file">ms</samp>.  Put a macro call on a line by itself.  Use &lsquo;<samp class="samp">.PP</samp>&rsquo; if you
+want your paragraph&rsquo;s first line to be indented, or &lsquo;<samp class="samp">.LP</samp>&rsquo; if you
+don&rsquo;t.
+</p>
+<p>After that, start typing normally.  It is a good practice to start each
+sentence on a new line, or to put two spaces after sentence-ending
+punctuation, so that the formatter knows where the sentence boundaries
+are.  You can separate paragraphs with further paragraphing macros, or
+with blank lines, and you can indent with tabs.  When you need one of
+the features mentioned earlier (see <a class="pxref" href="ms.html"><samp class="file">ms</samp></a>), return to this part of the
+manual.
+</p>
+<p>Format the document with the <code class="command">groff</code> command.  <code class="command">nroff</code>
+can be useful for previewing.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">$ editor radical.ms
+$ nroff -ww -z -ms radical.ms # check for errors
+$ nroff -ms radical.ms | less -R
+$ groff -T ps -ms radical.ms &gt; radical.ps
+$ see radical.ps
+</pre></div>
+</td></tr></table>
+
+<p>Our <samp class="file">radical.ms</samp> document might look like this.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.LP
+Radical novelties are so disturbing that they tend to be
+suppressed or ignored, to the extent that even the
+possibility of their existence in general is more often
+denied than admitted.
+
+&rarr;That's what Dijkstra said, anyway.
+</pre></div>
+</td></tr></table>
+
+<p><samp class="file">ms</samp> exposes many aspects of document layout to user control via
+<code class="code">groff</code>&rsquo;s <em class="dfn">registers</em> and <em class="dfn">strings</em>, which store numbers
+and text, respectively.  Measurements in <code class="code">groff</code> are expressed with
+a suffix called a <em class="dfn">scaling unit</em>.
+</p>
+<dl class="table">
+<dt><code class="code">i</code></dt>
+<dd><p>inches
+</p>
+</dd>
+<dt><code class="code">c</code></dt>
+<dd><p>centimeters
+</p>
+</dd>
+<dt><code class="code">p</code></dt>
+<dd><p>points (1/72 inch)
+</p>
+</dd>
+<dt><code class="code">P</code></dt>
+<dd><p>picas (1/6 inch)
+</p>
+</dd>
+<dt><code class="code">v</code></dt>
+<dd><p>vees; current vertical spacing
+</p>
+</dd>
+<dt><code class="code">m</code></dt>
+<dd><p>ems; width of an &ldquo;M&rdquo; in the current font
+</p>
+</dd>
+<dt><code class="code">n</code></dt>
+<dd><p>ens; one-half em
+</p></dd>
+</dl>
+
+<p>Set registers with the <code class="code">nr</code> request and strings with the <code class="code">ds</code>
+request.  <em class="dfn">Requests</em> are like macro calls; they go on lines by
+themselves and start with the <em class="dfn">control character</em>, a dot (<code class="code">.</code>).
+The difference is that they directly instruct the formatter program,
+rather than the macro package.  We&rsquo;ll discuss a few as applicable.  It
+is wise to specify a scaling unit when setting any register that
+represents a length, size, or distance.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.nr PS 10.5p \&quot; Use 10.5-point type.
+.ds FAM P    \&quot; Use Palatino font family.
+</pre></div>
+</td></tr></table>
+
+<p>In the foregoing, we see that <code class="code">\&quot;</code> begins a comment.  This is an
+example of an <em class="dfn">escape sequence</em>, the other kind of formatting
+instruction.  Escape sequences can appear anywhere.  They begin with the
+escape character (<code class="code">\</code>) and are followed by at least one more
+character.  <samp class="file">ms</samp> documents
+tend to use only a few of <code class="code">groff</code>&rsquo;s many requests and escape
+sequences; see <a class="ref" href="Request-Index.html">Request Index</a> and <a class="ref" href="Escape-Sequence-Index.html">Escape Sequence Index</a> or
+the <cite class="cite">groff<span class="r">(7)</span></cite> man page for complete lists.
+</p>
+<dl class="table">
+<dt><code class="code">\&quot;</code></dt>
+<dd><p>Begin comment; ignore remainder of line.
+</p>
+</dd>
+<dt><code class="code">\n<var class="var">reg</var></code></dt>
+<dd><p>Interpolate value of register <var class="var">reg</var>.
+</p>
+</dd>
+<dt><code class="code">\*<var class="var">str</var></code></dt>
+<dd><p>Interpolate contents of string <var class="var">str</var>.
+</p>
+</dd>
+<dt><code class="code">\*<var class="var">s</var></code></dt>
+<dd><p>abbreviation of <code class="code">\*<var class="var">s</var></code>; the name <var class="var">s</var> must be only one
+character
+</p>
+</dd>
+<dt><code class="code">\<var class="var">char</var></code></dt>
+<dd><p>Interpolate glyph of special character named <var class="var">char</var>.
+</p>
+</dd>
+<dt><code class="code">\&amp;</code></dt>
+<dd><p>dummy character
+</p>
+</dd>
+<dt><code class="code">\~</code></dt>
+<dd><p>Insert an unbreakable space that is adjustable like a normal space.
+</p>
+</dd>
+<dt><code class="code">\|</code></dt>
+<dd><p>Move horizontally by one-sixth em (&ldquo;thin space&rdquo;).
+</p></dd>
+</dl>
+
+<p>Prefix any words that start with a dot &lsquo;<samp class="samp">.</samp>&rsquo; or neutral apostrophe
+&lsquo;<samp class="samp">'</samp>&rsquo; with <code class="code">\&amp;</code> if they are at the beginning of an input line
+(or might become that way in editing) to prevent them from being
+interpreted as macro calls or requests.  Suffix &lsquo;<samp class="samp">.</samp>&rsquo;, &lsquo;<samp class="samp">?</samp>&rsquo;, and
+&lsquo;<samp class="samp">!</samp>&rsquo; with <code class="code">\&amp;</code> when needed to cancel end-of-sentence detection.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">My exposure was \&amp;.5 to \&amp;.6 Sv of neutrons, said Dr.\&amp;
+Wallace after the criticality incident.
+</pre></div>
+</td></tr></table>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Document-Structure.html">Document Structure</a>, Previous: <a href="ms-Introduction.html">Introduction</a>, Up: <a href="ms-Introduction.html">Introduction</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-keeps-and-displays.html Added

@@ -0,0 +1,207 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms keeps and displays (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms keeps and displays (The GNU Troff Manual)">
+<meta name="keywords" content="ms keeps and displays (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="ms-Insertions.html" rel="next" title="ms Insertions">
+<link href="Indented-regions-in-ms.html" rel="prev" title="Indented regions in ms">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-keeps-and-displays">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Insertions.html" accesskey="n" rel="next">Tables, figures, equations, and references</a>, Previous: <a href="Indented-regions-in-ms.html" accesskey="p" rel="prev">Indented regions</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Keeps_002c-boxed-keeps_002c-and-displays">4.6.5.8 Keeps, boxed keeps, and displays</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-displays"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-keeps"></a>
+<a class="index-entry-id" id="index-keeps-_005bms_005d"></a>
+
+<p>On occasion, you may want to <em class="dfn">keep</em> several lines of text, or a
+region of a document, together on a single page, preventing an automatic
+page break within certain boundaries.  This can cause a page break to
+occur earlier than it normally would.  For example, you may want to keep
+two paragraphs together, or a paragraph that refers to a table, list, or
+figure adjacent to the item it discusses.  <samp class="file">ms</samp> provides the
+<code class="code">KS</code> and <code class="code">KE</code> macros for this purpose.
+</p>
+<p>You can alternatively specify a <em class="dfn">floating keep</em>: if a keep cannot
+fit on the current page, <samp class="file">ms</samp> holds its contents and
+allows material following the keep (in the source document) to fill the
+remainder of the current page.  When the page breaks, whether by
+reaching the end or <code class="code">bp</code> request, <samp class="file">ms</samp> puts the floating keep
+at the beginning of the next page.  This is useful for placing large
+graphics or tables that do not need to appear exactly where they occur
+in the source document.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eKS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KS</code></strong><a class="copiable-link" href='#index-_002eKS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eKF"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KF</code></strong><a class="copiable-link" href='#index-_002eKF'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KF-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eKE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.KE</code></strong><a class="copiable-link" href='#index-_002eKE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-KE-_005bms_005d"></a>
+<p><code class="code">KS</code> begins a keep, <code class="code">KF</code> a floating keep, and <code class="code">KE</code> ends a
+keep of either kind.
+</p></dd></dl>
+
+<p>As an alternative to the keep mechanism, the <code class="code">ne</code> request forces a
+page break if there is not at least the amount of vertical space
+specified in its argument remaining on the page (see <a class="pxref" href="Page-Control.html">Page Control</a>).
+One application of <code class="code">ne</code> is to reserve space on the page for a
+figure or illustration to be included later.
+</p>
+<a class="index-entry-id" id="index-boxes-_005bms_005d"></a>
+<p>A <em class="dfn">boxed keep</em> has a frame drawn around it.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eB1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B1</code></strong><a class="copiable-link" href='#index-_002eB1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B1-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eB2"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.B2</code></strong><a class="copiable-link" href='#index-_002eB2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-B2-_005bms_005d"></a>
+<p><code class="code">B1</code> begins a keep with a box drawn around it.  <code class="code">B2</code> ends a
+boxed keep.
+</p></dd></dl>
+
+<p>Boxed keep macros cause breaks; if you need to box a word or phrase
+within a line, see the <code class="code">BX</code> macro in <a class="ref" href="Typeface-and-decoration.html">Typeface and decoration</a>.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.  If you wish to box one or more
+paragraphs, you may improve the appearance by calling <code class="code">B1</code> after
+the first paragraphing macro, and by adding a small amount of vertical
+space before calling <code class="code">B2</code>.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">.LP
+.B1
+.I Warning:
+Happy Fun Ball may suddenly accelerate to dangerous
+speeds.
+.sp \nPD/2 \&quot; space by half the inter-paragraph distance
+.B2
+</pre></div>
+</td></tr></table>
+
+<p>If you want a boxed keep to float, you will need to enclose the
+<code class="code">B1</code> and <code class="code">B2</code> calls within a pair of <code class="code">KF</code> and <code class="code">KE</code>
+calls.
+</p>
+<a class="index-entry-id" id="index-displays-_005bms_005d"></a>
+<p><em class="dfn">Displays</em> turn off filling; lines of verse or program code are
+shown with their lines broken as in the source document without
+requiring <code class="code">br</code> requests between lines.  Displays can be kept on a
+single page or allowed to break across pages.  The <code class="code">DS</code> macro
+begins a kept display of the layout specified in its first argument;
+non-kept displays are begun with dedicated macros corresponding to their
+layout.
+</p>
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">L</code></var><a class="copiable-link" href='#index-_002eDS'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eLD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.LD</code></strong><a class="copiable-link" href='#index-_002eLD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-LD-_005bms_005d"></a>
+<p>Begin (<code class="code">DS</code>: kept) left-aligned display.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-1"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">I</code> <span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eDS-1'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-1"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eID"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.ID</code></strong> <var class="def-var-arguments"><span class="r"><i class="slanted">indent</i></span></var><a class="copiable-link" href='#index-_002eID'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ID-_005bms_005d"></a>
+<p>Begin (<code class="code">DS</code>: kept) display indented by <var class="var">indent</var> if specified,
+and by the amount of the <code class="code">DI</code> register otherwise.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-2"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">B</code></var><a class="copiable-link" href='#index-_002eDS-2'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-2"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eBD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.BD</code></strong><a class="copiable-link" href='#index-_002eBD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-BD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) a block display: the entire display is
+left-aligned, but indented such that the longest line in the display
+is centered on the page.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-3"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">C</code></var><a class="copiable-link" href='#index-_002eDS-3'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-3"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eCD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.CD</code></strong><a class="copiable-link" href='#index-_002eCD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-CD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) centered display: each line in the display
+is centered.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDS-4"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DS</code></strong> <var class="def-var-arguments"><code class="t">R</code></var><a class="copiable-link" href='#index-_002eDS-4'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DS-_005bms_005d-4"></a>
+</dd><dt class="deffnx defmacx-alias-deffnx def-cmd-deffn" id="index-_002eRD"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.RD</code></strong><a class="copiable-link" href='#index-_002eRD'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-RD-_005bms_005d"></a>
+<p>Begin a (<code class="code">DS</code>: kept) right-aligned display.  This is a GNU
+extension.
+</p></dd></dl>
+
+<dl class="first-deffn first-defmac-alias-first-deffn">
+<dt class="deffn defmac-alias-deffn" id="index-_002eDE"><span class="category-def">Macro: </span><span><strong class="def-name"><code class="t">.DE</code></strong><a class="copiable-link" href='#index-_002eDE'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-DE-_005bms_005d"></a>
+<p>End any display.
+</p></dd></dl>
+
+<p>The distance stored in the <code class="code">DD</code> register is inserted before and
+after each pair of display macros; this is a Berkeley extension.  In
+<code class="code">groff</code> <samp class="file">ms</samp>, this distance replaces any adjacent
+inter-paragraph distance or subsequent spacing prior to a section
+heading.  The <code class="code">DI</code> register is a GNU extension; its value is an
+indentation applied to displays created with &lsquo;<samp class="samp">.DS</samp>&rsquo; and &lsquo;<samp class="samp">.ID</samp>&rsquo;
+without arguments, to &lsquo;<samp class="samp">.DS I</samp>&rsquo; without an indentation argument, and
+to indented equations set with &lsquo;<samp class="samp">.EQ</samp>&rsquo;.  Changes to either register
+take effect at the next display boundary.
+</p>
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Insertions.html">Tables, figures, equations, and references</a>, Previous: <a href="Indented-regions-in-ms.html">Indented regions</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms-language-and-localization.html Added

@@ -0,0 +1,135 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms language and localization (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms language and localization (The GNU Troff Manual)">
+<meta name="keywords" content="ms language and localization (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="ms-Body-Text.html" rel="up" title="ms Body Text">
+<link href="ms-Page-Layout.html" rel="next" title="ms Page Layout">
+<link href="ms-Footnotes.html" rel="prev" title="ms Footnotes">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsubsection-level-extent" id="ms-language-and-localization">
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Page-Layout.html" accesskey="n" rel="next">Page layout</a>, Previous: <a href="ms-Footnotes.html" accesskey="p" rel="prev">Footnotes</a>, Up: <a href="ms-Body-Text.html" accesskey="u" rel="up">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsubsection" id="Language-and-localization">4.6.5.11 Language and localization</h4>
+<a class="index-entry-id" id="index-ms-macros_002c-language"></a>
+<a class="index-entry-id" id="index-ms-macros_002c-localization"></a>
+<a class="index-entry-id" id="index-language-_005bms_005d"></a>
+<a class="index-entry-id" id="index-localization-_005bms_005d"></a>
+
+<p><code class="code">groff</code> <samp class="file">ms</samp> provides several strings that you can customize
+for your own purposes, or redefine to adapt the macro package to
+languages other than English.  It is already localized for
+Czech, German, French, Italian, and Swedish.  Load the desired
+localization macro package after <samp class="file">ms</samp>; see the
+<cite class="cite">groff_tmac<span class="r">(5)</span></cite> man page.
+</p>
+<table class="cartouche" border="1"><tr><td>
+<div class="example">
+<pre class="example-preformatted">$ groff -ms -mfr bienvenue.ms
+</pre></div>
+</td></tr></table>
+
+<p>The following strings are available.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bREFERENCES_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*REFERENCES</code></strong><a class="copiable-link" href='#index-_005c_002a_005bREFERENCES_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-REFERENCES-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of a references
+(bibliography) page produced with GNU <cite class="cite">refer<span class="r">(1)</span></cite>.  The default
+is &lsquo;<samp class="samp">References</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bABSTRACT_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*ABSTRACT</code></strong><a class="copiable-link" href='#index-_005c_002a_005bABSTRACT_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-ABSTRACT-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of the abstract.  The
+default is &lsquo;<samp class="samp">\fIABSTRACT\f</samp>&rsquo;; it includes font selection escape
+sequences to set the word in italics.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bTOC_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*TOC</code></strong><a class="copiable-link" href='#index-_005c_002a_005bTOC_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-TOC-_005bms_005d"></a>
+<p>Contains the string printed at the beginning of the table of contents.
+The default is &lsquo;<samp class="samp">Table of Contents</samp>&rsquo;.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_005c_002a_005bMONTH1_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH1</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH1_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH1-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH2_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH2</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH2_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH2-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH3_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH3</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH3_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH3-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH4_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH4</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH4_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH4-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH5_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH5</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH5_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH5-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH6_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH6</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH6_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH6-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH7_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH7</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH7_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH7-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH8_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH8</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH8_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH8-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH9_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH9</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH9_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH9-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH10_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH10</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH10_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH10-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH11_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH11</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH11_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH11-_005bms_005d"></a>
+</dd><dt class="deffnx def-cmd-deffn" id="index-_005c_002a_005bMONTH12_005d"><span class="category-def">String: </span><span><strong class="def-name"><code class="t">\*MONTH12</code></strong><a class="copiable-link" href='#index-_005c_002a_005bMONTH12_005d'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-MONTH12-_005bms_005d"></a>
+<p>Contain the full names of the calendar months.  The defaults are in
+English: &lsquo;<samp class="samp">January</samp>&rsquo;, &lsquo;<samp class="samp">February</samp>&rsquo;, and so on.
+</p></dd></dl>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="ms-Page-Layout.html">Page layout</a>, Previous: <a href="ms-Footnotes.html">Footnotes</a>, Up: <a href="ms-Body-Text.html">Body Text</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/ms.html Added

@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>ms (The GNU Troff Manual)</title>
+
+<meta name="description" content="ms (The GNU Troff Manual)">
+<meta name="keywords" content="ms (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Major-Macro-Packages.html" rel="up" title="Major Macro Packages">
+<link href="mom.html" rel="prev" title="mom">
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="ms">
+<div class="nav-panel">
+<p>
+Previous: <a href="mom.html" accesskey="p" rel="prev"><samp class="file">mom</samp></a>, Up: <a href="Major-Macro-Packages.html" accesskey="u" rel="up">Macro Packages</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="ms-1">4.6 <samp class="file">ms</samp></h3>
+<a class="index-entry-id" id="index-ms-macros"></a>
+
+<p>The <samp class="file">ms</samp> (&ldquo;manuscript&rdquo;) package is suitable for the preparation
+of letters, memoranda, reports, and books.  These <code class="code">groff</code>
+macros feature cover page and table of contents generation,
+automatically numbered headings, several paragraph styles, a variety of
+text styling options, footnotes, and multi-column page layouts.
+<samp class="file">ms</samp> supports the <code class="command">tbl</code>, <code class="command">eqn</code>, <code class="command">pic</code>, and
+<code class="command">refer</code> preprocessors for inclusion of tables, mathematical
+equations, diagrams, and standardized bibliographic citations.  This
+implementation is mostly compatible with the documented interface and
+behavior of AT&amp;T Unix Version&nbsp;7 <samp class="file">ms</samp>.  Many extensions from
+4.2BSD (Berkeley)
+and Tenth Edition Research Unix have been recreated.
+</p>
+
+
+<ul class="mini-toc">
+<li><a href="ms-Introduction.html" accesskey="1">Introduction</a></li>
+<li><a href="ms-Document-Structure.html" accesskey="2">Document Structure</a></li>
+<li><a href="ms-Document-Control-Settings.html" accesskey="3">Document Control Settings</a></li>
+<li><a href="ms-Document-Description-Macros.html" accesskey="4">Document Description Macros</a></li>
+<li><a href="ms-Body-Text.html" accesskey="5">Body Text</a></li>
+<li><a href="ms-Page-Layout.html" accesskey="6">Page layout</a></li>
+<li><a href="Differences-from-AT_0026T-ms.html" accesskey="7">Differences from <abbr class="acronym">AT&amp;T</abbr> <samp class="file">ms</samp></a></li>
+<li><a href="ms-Legacy-Features.html" accesskey="8">Legacy Features</a></li>
+<li><a href="ms-Naming-Conventions.html" accesskey="9">Naming Conventions</a></li>
+</ul>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/troff-and-nroff-Modes.html Added

@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>troff and nroff Modes (The GNU Troff Manual)</title>
+
+<meta name="description" content="troff and nroff Modes (The GNU Troff Manual)">
+<meta name="keywords" content="troff and nroff Modes (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="GNU-troff-Reference.html" rel="up" title="GNU troff Reference">
+<link href="Line-Layout.html" rel="next" title="Line Layout">
+<link href="Character-Translations.html" rel="prev" title="Character Translations">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="section-level-extent" id="troff-and-nroff-Modes">
+<div class="nav-panel">
+<p>
+Next: <a href="Line-Layout.html" accesskey="n" rel="next">Line Layout</a>, Previous: <a href="Character-Translations.html" accesskey="p" rel="prev">Character Translations</a>, Up: <a href="GNU-troff-Reference.html" accesskey="u" rel="up">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h3 class="section" id="troff-and-nroff-Modes-1">5.14 <code class="code">troff</code> and <code class="code">nroff</code> Modes</h3>
+<a class="index-entry-id" id="index-troff-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-troff"></a>
+<a class="index-entry-id" id="index-nroff-mode"></a>
+<a class="index-entry-id" id="index-mode_002c-nroff"></a>
+
+<p>Historically, <code class="code">nroff</code> and <code class="code">troff</code> were two separate programs;
+the former for terminal output, the latter for typesetters.  GNU
+<code class="code">troff</code> merges both functions into one executable<a class="footnote" id="DOCF68" href="groff.html_fot.html#FOOT68"><sup>68</sup></a> that sends its output to a
+device driver (<code class="code">grotty</code> for terminal devices, <code class="code">grops</code> for
+PostScript, and so on) which interprets this intermediate output format.
+When discussing <abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code>, it makes sense to talk
+about <em class="dfn"><code class="code">nroff</code> mode</em> and <em class="dfn"><code class="code">troff</code> mode</em> since the
+differences are hard-coded.  GNU <code class="code">troff</code> takes information from
+device and font description files without handling requests specially if
+a terminal output device is used, so such a strong distinction is
+unnecessary.
+</p>
+<p>Usually, a macro package can be used with all output devices.
+Nevertheless, it is sometimes necessary to make a distinction between
+terminal and non-terminal devices: GNU <code class="code">troff</code> provides two
+built-in conditions &lsquo;<samp class="samp">n</samp>&rsquo; and &lsquo;<samp class="samp">t</samp>&rsquo; for the <code class="code">if</code>, <code class="code">ie</code>,
+and <code class="code">while</code> requests to decide whether GNU <code class="code">troff</code> shall
+behave like <code class="code">nroff</code> or like <code class="code">troff</code>.
+</p>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002etroff"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.troff</code></strong><a class="copiable-link" href='#index-_002etroff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-troff"></a>
+<a class="index-entry-id" id="index-troffrc-4"></a>
+<a class="index-entry-id" id="index-troffrc_002dend-2"></a>
+<p>Make the &lsquo;<samp class="samp">t</samp>&rsquo; built-in condition true (and the &lsquo;<samp class="samp">n</samp>&rsquo; built-in
+condition false) for <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> conditional
+requests.  This is the default if GNU <code class="code">troff</code> (<em class="emph">not</em>
+<code class="code">groff</code>) is started with the <samp class="option">-R</samp> switch to avoid loading of
+the startup files <samp class="file">troffrc</samp> and <samp class="file">troffrc-end</samp>.  Without
+<samp class="option">-R</samp>, GNU <code class="code">troff</code> stays in <code class="code">troff</code> mode if the output
+device is not a terminal (e.g., &lsquo;ps&rsquo;).
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002enroff"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.nroff</code></strong><a class="copiable-link" href='#index-_002enroff'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-nroff"></a>
+<a class="index-entry-id" id="index-tty_002etmac"></a>
+<p>Make the &lsquo;<samp class="samp">n</samp>&rsquo; built-in condition true (and the &lsquo;<samp class="samp">t</samp>&rsquo; built-in
+condition false) for <code class="code">if</code>, <code class="code">ie</code>, and <code class="code">while</code> conditional
+requests.  This is the default if GNU <code class="code">troff</code> uses a terminal
+output device; the code for switching to <code class="code">nroff</code> mode is in the
+file <samp class="file">tty.tmac</samp>, which is loaded by the startup file
+<code class="code">troffrc</code>.
+</p></dd></dl>
+
+<p>See <a class="xref" href="Conditionals-and-Loops.html">Conditionals and Loops</a>, for more details on built-in conditions.
+</p>
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Next: <a href="Line-Layout.html">Line Layout</a>, Previous: <a href="Character-Translations.html">Character Translations</a>, Up: <a href="GNU-troff-Reference.html">GNU <code class="code">troff</code> Reference</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.html.node/while.html Added

@@ -0,0 +1,161 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+<title>while (The GNU Troff Manual)</title>
+
+<meta name="description" content="while (The GNU Troff Manual)">
+<meta name="keywords" content="while (The GNU Troff Manual)">
+<meta name="resource-type" content="document">
+<meta name="distribution" content="global">
+<meta name="Generator" content="makeinfo">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+
+<link href="index.html" rel="start" title="Top">
+<link href="Request-Index.html" rel="index" title="Request Index">
+<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
+<link href="Conditionals-and-Loops.html" rel="up" title="Conditionals and Loops">
+<link href="if_002delse.html" rel="prev" title="if-else">
+<style type="text/css">
+
+</style>
+
+
+</head>
+
+<body lang="en">
+<div class="subsection-level-extent" id="while">
+<div class="nav-panel">
+<p>
+Previous: <a href="if_002delse.html" accesskey="p" rel="prev">if-else</a>, Up: <a href="Conditionals-and-Loops.html" accesskey="u" rel="up">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+<hr>
+<h4 class="subsection" id="while-1">5.23.5 while</h4>
+<a class="index-entry-id" id="index-while"></a>
+
+<p><code class="code">groff</code> provides a looping construct: the <code class="code">while</code> request.
+Its syntax matches the <code class="code">if</code> request.
+</p>
+<a class="index-entry-id" id="index-body_002c-of-a-while-request"></a>
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ewhile"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.while</code></strong> <var class="def-var-arguments">cond-expr anything</var><a class="copiable-link" href='#index-_002ewhile'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-while-1"></a>
+<p>Evaluate the conditional expression <var class="var">cond-expr</var>, and repeatedly
+execute <var class="var">anything</var> unless and until <var class="var">cond-expr</var> evaluates false.
+<var class="var">anything</var>, which is often a conditional block, is referred to as
+the <code class="code">while</code> request&rsquo;s <em class="dfn">body</em>.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.nr a 0 1
+.while (\na &lt; 9) \{\
+\n+a,
+.\}
+\n+a
+    &rArr; 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
+</pre></div></div>
+
+<a class="index-entry-id" id="index-de-request_002c-and-while"></a>
+<p>GNU <code class="code">troff</code> treats the body of a <code class="code">while</code> request similarly to
+that of a <code class="code">de</code> request (albeit one not read in copy
+mode<a class="footnote" id="DOCF94" href="groff.html_fot.html#FOOT94"><sup>94</sup></a>), but stores it under an internal name
+and deletes it when the loop finishes.  The operation of a macro
+containing a <code class="code">while</code> request can slow significantly if the
+<code class="code">while</code> body is large.  Each time the macro is executed, the
+<code class="code">while</code> body is parsed and stored again.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de xxx
+.  nr num 10
+.  while (\\nnum &gt; 0) \{\
+.    \&quot; many lines of code
+.    nr num -1
+.  \}
+..
+</pre></div></div>
+
+<a class="index-entry-id" id="index-recursive-macros"></a>
+<a class="index-entry-id" id="index-macros_002c-recursive"></a>
+<p>An often better solution&mdash;and one that is more portable, since
+<abbr class="acronym">AT&amp;T</abbr> <code class="code">troff</code> lacked the <code class="code">while</code> request&mdash;is to
+instead write a recursive macro.  It will be parsed only
+once.<a class="footnote" id="DOCF95" href="groff.html_fot.html#FOOT95"><sup>95</sup></a>
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.de yyy
+.  if (\\nnum &gt; 0) \{\
+.    \&quot; many lines of code
+.    nr num -1
+.    yyy
+.  \}
+..
+.
+.de xxx
+.  nr num 10
+.  yyy
+..
+</pre></div></div>
+
+<p>To prevent infinite loops, the default number of available recursion
+levels is 1,000 or somewhat less.<a class="footnote" id="DOCF96" href="groff.html_fot.html#FOOT96"><sup>96</sup></a>  You can
+disable this protective measure, or raise the limit, by setting the
+<code class="code">slimit</code> register.  See <a class="xref" href="Debugging.html">Debugging</a>.
+</p>
+<p>As noted above, if a <code class="code">while</code> body begins with a conditional block,
+its closing brace must end an input line.
+</p>
+<div class="example">
+<div class="group"><pre class="example-preformatted">.if 1 \{\
+.  nr a 0 1
+.  while (\na &lt; 10) \{\
+.    nop \n+a
+.\}\}
+    error&rarr; unbalanced brace escape sequences
+</pre></div></div>
+</dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002ebreak"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.break</code></strong><a class="copiable-link" href='#index-_002ebreak'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-break-2"></a>
+<a class="index-entry-id" id="index-while-request_002c-confusing-with-br"></a>
+<a class="index-entry-id" id="index-break-request_002c-in-a-while-loop"></a>
+<a class="index-entry-id" id="index-continue-request_002c-in-a-while-loop"></a>
+<p>Exit a <code class="code">while</code> loop.  Do not confuse this request with a
+typographical break or the <code class="code">br</code> request.
+</p></dd></dl>
+
+<dl class="first-deffn">
+<dt class="deffn" id="index-_002econtinue"><span class="category-def">Request: </span><span><strong class="def-name"><code class="t">.continue</code></strong><a class="copiable-link" href='#index-_002econtinue'> &para;</a></span></dt>
+<dd><a class="index-entry-id" id="index-continue"></a>
+<p>Skip the remainder of a <code class="code">while</code> loop&rsquo;s body, immediately starting
+the next iteration.
+</p></dd></dl>
+
+
+
+</div>
+<hr>
+<div class="nav-panel">
+<p>
+Previous: <a href="if_002delse.html">if-else</a>, Up: <a href="Conditionals-and-Loops.html">Conditionals and Loops</a> &nbsp; <a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a><a href="Request-Index.html" title="Index" rel="index">Index</a></p>
+</div>
+
+
+
+</body>
+</html>

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.info Added

@@ -0,0 +1,423 @@
+This is groff.info, produced by makeinfo version 7.0.3 from groff.texi.
+
+This manual documents GNU 'troff' version 1.23.0.
+
+   Copyright © 1994-2023 Free Software Foundation, Inc.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.3 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     no Back-Cover Texts.  A copy of the license is included in the
+     section entitled "GNU Free Documentation License".
+INFO-DIR-SECTION Typesetting
+START-INFO-DIR-ENTRY
+* Groff: (groff).               The GNU roff document formatting system.
+END-INFO-DIR-ENTRY
+
+&#x1f;
+Indirect:
+groff.info-1: 723
+groff.info-2: 303755
+groff.info-3: 616581
+&#x1f;
+Tag Table:
+(Indirect)
+Node: Top&#x7f;723
+Node: Introduction&#x7f;1683
+Node: Background&#x7f;2155
+Node: What Is groff?&#x7f;3968
+Node: groff Capabilities&#x7f;4894
+Node: Macro Package Intro&#x7f;6241
+Node: Preprocessor Intro&#x7f;6920
+Node: Preprocessor Intro-Footnotes&#x7f;8331
+Ref: Preprocessor Intro-Footnote-1&#x7f;8413
+Node: Output Device Intro&#x7f;8492
+Node: Installation&#x7f;9120
+Node: Conventions Used in This Manual&#x7f;9504
+Node: Conventions Used in This Manual-Footnotes&#x7f;12548
+Ref: Conventions Used in This Manual-Footnote-1&#x7f;12656
+Ref: Conventions Used in This Manual-Footnote-2&#x7f;12844
+Node: Credits&#x7f;12873
+Node: Invoking groff&#x7f;13398
+Node: Invoking groff-Footnotes&#x7f;14739
+Ref: Invoking groff-Footnote-1&#x7f;14813
+Node: Groff Options&#x7f;14866
+Node: Environment&#x7f;27526
+Node: Macro Directories&#x7f;30791
+Node: Macro Directories-Footnotes&#x7f;32254
+Ref: Macro Directories-Footnote-1&#x7f;32334
+Node: Font Directories&#x7f;32407
+Node: Paper Format&#x7f;34380
+Node: Invocation Examples&#x7f;35840
+Node: Tutorial for Macro Users&#x7f;37422
+Node: Basics&#x7f;38129
+Node: Basics-Footnotes&#x7f;44199
+Ref: Basics-Footnote-1&#x7f;44257
+Node: Common Features&#x7f;44415
+Node: Paragraphs&#x7f;45648
+Node: Sections and Chapters&#x7f;47257
+Node: Headers and Footers&#x7f;47761
+Node: Page Layout Adjustment&#x7f;48487
+Node: Displays and Keeps&#x7f;48979
+Node: Footnotes and Endnotes&#x7f;50257
+Node: Table of Contents&#x7f;50860
+Node: Indexing&#x7f;51812
+Node: Document Formats&#x7f;52253
+Node: Columnation&#x7f;52749
+Node: Font and Size Changes&#x7f;53032
+Node: Predefined Text&#x7f;53542
+Node: Preprocessor Support&#x7f;53852
+Node: Configuration and Customization&#x7f;54295
+Node: Major Macro Packages&#x7f;54667
+Node: man&#x7f;55737
+Node: Optional man extensions&#x7f;56224
+Node: mdoc&#x7f;60222
+Node: me&#x7f;60495
+Node: mm&#x7f;61061
+Node: mom&#x7f;61398
+Node: ms&#x7f;62297
+Node: ms Introduction&#x7f;63317
+Node: ms Introduction-Footnotes&#x7f;63762
+Ref: ms Introduction-Footnote-1&#x7f;63838
+Node: ms basic information&#x7f;64073
+Node: ms Document Structure&#x7f;67998
+Node: ms Document Control Settings&#x7f;70473
+Node: ms Document Control Settings-Footnotes&#x7f;79653
+Ref: ms Document Control Settings-Footnote-1&#x7f;79755
+Node: ms Document Description Macros&#x7f;79795
+Node: ms Document Description Macros-Footnotes&#x7f;84030
+Ref: ms Document Description Macros-Footnote-1&#x7f;84136
+Node: ms Body Text&#x7f;84257
+Node: Text settings in ms&#x7f;84898
+Node: Typographical symbols in ms&#x7f;86081
+Node: Paragraphs in ms&#x7f;86721
+Node: Headings in ms&#x7f;89617
+Node: Typeface and decoration&#x7f;94721
+Node: Typeface and decoration-Footnotes&#x7f;98631
+Ref: Typeface and decoration-Footnote-1&#x7f;98723
+Node: Lists in ms&#x7f;99063
+Node: Indented regions in ms&#x7f;102246
+Node: ms keeps and displays&#x7f;103228
+Node: ms Insertions&#x7f;107422
+Node: ms Footnotes&#x7f;110390
+Node: ms Footnotes-Footnotes&#x7f;114176
+Ref: ms Footnotes-Footnote-1&#x7f;114246
+Ref: ms Footnotes-Footnote-2&#x7f;114371
+Ref: ms Footnotes-Footnote-3&#x7f;114462
+Node: ms language and localization&#x7f;114532
+Node: ms Page Layout&#x7f;116058
+Node: ms Headers and Footers&#x7f;116520
+Node: Tab Stops in ms&#x7f;119000
+Node: ms Margins&#x7f;119381
+Node: ms Multiple Columns&#x7f;119765
+Node: ms TOC&#x7f;120726
+Node: Differences from AT&T ms&#x7f;126332
+Node: Differences from AT&T ms-Footnotes&#x7f;131038
+Ref: Differences from AT&T ms-Footnote-1&#x7f;131132
+Ref: Differences from AT&T ms-Footnote-2&#x7f;131258
+Ref: Differences from AT&T ms-Footnote-3&#x7f;131348
+Node: Missing Unix Version 7 ms Macros&#x7f;131620
+Node: Missing Unix Version 7 ms Macros-Footnotes&#x7f;132934
+Ref: Missing Unix Version 7 ms Macros-Footnote-1&#x7f;133044
+Node: ms Legacy Features&#x7f;133212
+Node: ms Naming Conventions&#x7f;135940
+Node: GNU troff Reference&#x7f;136988
+Node: Text&#x7f;138082
+Node: Filling&#x7f;139361
+Node: Filling-Footnotes&#x7f;140444
+Ref: Filling-Footnote-1&#x7f;140504
+Ref: Filling-Footnote-2&#x7f;140555
+Node: Sentences&#x7f;140825
+Node: Sentences-Footnotes&#x7f;145108
+Ref: Sentences-Footnote-1&#x7f;145172
+Ref: Sentences-Footnote-2&#x7f;145389
+Ref: Sentences-Footnote-3&#x7f;145651
+Node: Hyphenation&#x7f;145830
+Node: Breaking&#x7f;146782
+Node: Breaking-Footnotes&#x7f;149367
+Ref: Breaking-Footnote-1&#x7f;149429
+Node: Adjustment&#x7f;149494
+Node: Tabs and Leaders&#x7f;149985
+Node: Tabs and Leaders-Footnotes&#x7f;151169
+Ref: Tabs and Leaders-Footnote-1&#x7f;151247
+Node: Requests and Macros&#x7f;151362
+Node: Requests and Macros-Footnotes&#x7f;157082
+Ref: Requests and Macros-Footnote-1&#x7f;157166
+Ref: Requests and Macros-Footnote-2&#x7f;157277
+Ref: Requests and Macros-Footnote-3&#x7f;157378
+Ref: Requests and Macros-Footnote-4&#x7f;157439
+Node: Macro Packages&#x7f;157508
+Node: Macro Packages-Footnotes&#x7f;158336
+Ref: Macro Packages-Footnote-1&#x7f;158410
+Node: Input Encodings&#x7f;158492
+Node: Input Encodings-Footnotes&#x7f;161415
+Ref: Input Encodings-Footnote-1&#x7f;161491
+Ref: Input Encodings-Footnote-2&#x7f;161688
+Node: Input Conventions&#x7f;161863
+Node: Input Conventions-Footnotes&#x7f;166824
+Ref: Input Conventions-Footnote-1&#x7f;166904
+Node: Page Geometry&#x7f;166958
+Node: Page Geometry-Footnotes&#x7f;170630
+Ref: Page Geometry-Footnote-1&#x7f;170702
+Ref: Page Geometry-Footnote-2&#x7f;170762
+Node: Measurements&#x7f;170831
+Node: Motion Quanta&#x7f;172770
+Node: Default Units&#x7f;173707
+Node: Numeric Expressions&#x7f;175213
+Node: Numeric Expressions-Footnotes&#x7f;183975
+Ref: Numeric Expressions-Footnote-1&#x7f;184059
+Ref: Numeric Expressions-Footnote-2&#x7f;184152
+Ref: Numeric Expressions-Footnote-3&#x7f;184251
+Ref: Numeric Expressions-Footnote-4&#x7f;184291
+Ref: Numeric Expressions-Footnote-5&#x7f;184513
+Node: Identifiers&#x7f;184541
+Node: Identifiers-Footnotes&#x7f;189589
+Ref: Identifiers-Footnote-1&#x7f;189657
+Ref: Identifiers-Footnote-2&#x7f;190254
+Node: Formatter Instructions&#x7f;190373
+Node: Control Characters&#x7f;191643
+Node: Control Characters-Footnotes&#x7f;193934
+Ref: Control Characters-Footnote-1&#x7f;194016
+Node: Invoking Requests&#x7f;194052
+Node: Invoking Requests-Footnotes&#x7f;196161
+Ref: Invoking Requests-Footnote-1&#x7f;196241
+Node: Calling Macros&#x7f;196411
+Node: Calling Macros-Footnotes&#x7f;200319
+Ref: Calling Macros-Footnote-1&#x7f;200393
+Ref: Calling Macros-Footnote-2&#x7f;200457
+Node: Using Escape Sequences&#x7f;200630
+Node: Using Escape Sequences-Footnotes&#x7f;205504
+Ref: Using Escape Sequences-Footnote-1&#x7f;205594
+Ref: Using Escape Sequences-Footnote-2&#x7f;205696
+Node: Delimiters&#x7f;205736
+Node: Comments&#x7f;208561
+Node: Comments-Footnotes&#x7f;211181
+Ref: Comments-Footnote-1&#x7f;211243
+Ref: Comments-Footnote-2&#x7f;211305
+Ref: Comments-Footnote-3&#x7f;211341
+Node: Registers&#x7f;211504
+Node: Setting Registers&#x7f;212084
+Node: Interpolating Registers&#x7f;216559
+Node: Auto-increment&#x7f;217536
+Node: Auto-increment-Footnotes&#x7f;219451
+Ref: Auto-increment-Footnote-1&#x7f;219525
+Node: Assigning Register Formats&#x7f;219598
+Node: Built-in Registers&#x7f;223328
+Node: Built-in Registers-Footnotes&#x7f;227032
+Ref: Built-in Registers-Footnote-1&#x7f;227114
+Node: Manipulating Filling and Adjustment&#x7f;227198
+Node: Manipulating Filling and Adjustment-Footnotes&#x7f;240315
+Ref: Manipulating Filling and Adjustment-Footnote-1&#x7f;240431
+Ref: Manipulating Filling and Adjustment-Footnote-2&#x7f;240479
+Ref: Manipulating Filling and Adjustment-Footnote-3&#x7f;240514
+Node: Manipulating Hyphenation&#x7f;240634
+Node: Manipulating Hyphenation-Footnotes&#x7f;258827
+Ref: Manipulating Hyphenation-Footnote-1&#x7f;258921
+Ref: Manipulating Hyphenation-Footnote-2&#x7f;259086
+Ref: Manipulating Hyphenation-Footnote-3&#x7f;259175
+Ref: Manipulating Hyphenation-Footnote-4&#x7f;259316
+Ref: Manipulating Hyphenation-Footnote-5&#x7f;259639
+Ref: Manipulating Hyphenation-Footnote-6&#x7f;259813
+Node: Manipulating Spacing&#x7f;259881
+Node: Manipulating Spacing-Footnotes&#x7f;265594
+Ref: Manipulating Spacing-Footnote-1&#x7f;265680
+Ref: Manipulating Spacing-Footnote-2&#x7f;265717
+Ref: Manipulating Spacing-Footnote-3&#x7f;265760
+Ref: Manipulating Spacing-Footnote-4&#x7f;265828
+Node: Tabs and Fields&#x7f;265887
+Node: Tabs and Fields-Footnotes&#x7f;272139
+Ref: Tabs and Fields-Footnote-1&#x7f;272215
+Node: Leaders&#x7f;272279
+Node: Leaders-Footnotes&#x7f;274266
+Ref: Leaders-Footnote-1&#x7f;274326
+Node: Fields&#x7f;274486
+Node: Character Translations&#x7f;275876
+Node: troff and nroff Modes&#x7f;279395
+Node: troff and nroff Modes-Footnotes&#x7f;281486
+Ref: troff and nroff Modes-Footnote-1&#x7f;281574
+Node: Line Layout&#x7f;281682
+Node: Line Continuation&#x7f;287718
+Node: Line Continuation-Footnotes&#x7f;290503
+Ref: Line Continuation-Footnote-1&#x7f;290583
+Node: Page Layout&#x7f;290925
+Node: Page Layout-Footnotes&#x7f;294492
+Ref: Page Layout-Footnote-1&#x7f;294560
+Node: Page Control&#x7f;294583
+Node: Page Control-Footnotes&#x7f;299166
+Ref: Page Control-Footnote-1&#x7f;299236
+Node: Using Fonts&#x7f;299264
+Node: Using Fonts-Footnotes&#x7f;302473
+Ref: Using Fonts-Footnote-1&#x7f;302541
+Ref: Using Fonts-Footnote-2&#x7f;302742
+Ref: Using Fonts-Footnote-3&#x7f;302830
+Ref: Using Fonts-Footnote-4&#x7f;302986
+Node: Selecting Fonts&#x7f;303755
+Node: Font Families&#x7f;308177
+Node: Font Families-Footnotes&#x7f;312061
+Ref: Font Families-Footnote-1&#x7f;312133
+Node: Font Positions&#x7f;312167
+Node: Using Symbols&#x7f;315056
+Node: Using Symbols-Footnotes&#x7f;333721
+Ref: Using Symbols-Footnote-1&#x7f;333793
+Ref: Using Symbols-Footnote-2&#x7f;333911
+Ref: Using Symbols-Footnote-3&#x7f;334033
+Ref: Using Symbols-Footnote-4&#x7f;334069
+Node: Character Classes&#x7f;334229
+Node: Special Fonts&#x7f;337008
+Node: Artificial Fonts&#x7f;338195
+Node: Ligatures and Kerning&#x7f;343712
+Node: Italic Corrections&#x7f;347081
+Node: Dummy Characters&#x7f;348505
+Node: Dummy Characters-Footnotes&#x7f;351282
+Ref: Dummy Characters-Footnote-1&#x7f;351360
+Node: Manipulating Type Size and Vertical Spacing&#x7f;351819
+Node: Manipulating Type Size and Vertical Spacing-Footnotes&#x7f;352771
+Ref: Manipulating Type Size and Vertical Spacing-Footnote-1&#x7f;352903
+Ref: Manipulating Type Size and Vertical Spacing-Footnote-2&#x7f;353261
+Node: Changing the Type Size&#x7f;353349
+Node: Changing the Type Size-Footnotes&#x7f;356390
+Ref: Changing the Type Size-Footnote-1&#x7f;356480
+Node: Changing the Vertical Spacing&#x7f;356622
+Node: Using Fractional Type Sizes&#x7f;359239
+Node: Using Fractional Type Sizes-Footnotes&#x7f;362878
+Ref: Using Fractional Type Sizes-Footnote-1&#x7f;362978
+Node: Colors&#x7f;363029
+Node: Colors-Footnotes&#x7f;367195
+Ref: Colors-Footnote-1&#x7f;367253
+Node: Strings&#x7f;367298
+Ref: als&#x7f;375644
+Node: Strings-Footnotes&#x7f;377468
+Ref: Strings-Footnote-1&#x7f;377528
+Node: Conditionals and Loops&#x7f;377555
+Node: Operators in Conditionals&#x7f;378008
+Node: Operators in Conditionals-Footnotes&#x7f;382841
+Ref: Operators in Conditionals-Footnote-1&#x7f;382937
+Ref: Operators in Conditionals-Footnote-2&#x7f;383111
+Ref: Operators in Conditionals-Footnote-3&#x7f;383421
+Ref: Operators in Conditionals-Footnote-4&#x7f;383552
+Ref: Operators in Conditionals-Footnote-5&#x7f;383693
+Node: if-then&#x7f;383766
+Node: if-else&#x7f;385440
+Node: Conditional Blocks&#x7f;386605
+Node: Conditional Blocks-Footnotes&#x7f;389892
+Ref: Conditional Blocks-Footnote-1&#x7f;389974
+Node: while&#x7f;389997
+Node: while-Footnotes&#x7f;392531
+Ref: while-Footnote-1&#x7f;392587
+Ref: while-Footnote-2&#x7f;392614
+Ref: while-Footnote-3&#x7f;392645
+Node: Writing Macros&#x7f;392733
+Node: Writing Macros-Footnotes&#x7f;399609
+Ref: Writing Macros-Footnote-1&#x7f;399683
+Ref: Writing Macros-Footnote-2&#x7f;399710
+Ref: Writing Macros-Footnote-3&#x7f;399915
+Node: Parameters&#x7f;400164
+Node: Parameters-Footnotes&#x7f;404230
+Ref: Parameters-Footnote-1&#x7f;404296
+Node: Copy Mode&#x7f;404707
+Node: Copy Mode-Footnotes&#x7f;410433
+Ref: Copy Mode-Footnote-1&#x7f;410497
+Ref: Copy Mode-Footnote-2&#x7f;410561
+Node: Page Motions&#x7f;410647
+Node: Page Motions-Footnotes&#x7f;420569
+Ref: Page Motions-Footnote-1&#x7f;420639
+Ref: Page Motions-Footnote-2&#x7f;420829
+Node: Drawing Geometric Objects&#x7f;420895
+Node: Drawing Geometric Objects-Footnotes&#x7f;429469
+Ref: Drawing Geometric Objects-Footnote-1&#x7f;429565
+Node: Deferring Output&#x7f;429662
+Node: Traps&#x7f;432701
+Node: Vertical Position Traps&#x7f;433531
+Node: Page Location Traps&#x7f;434625
+Node: Page Location Traps-Footnotes&#x7f;442638
+Ref: Page Location Traps-Footnote-1&#x7f;442722
+Ref: Page Location Traps-Footnote-2&#x7f;442762
+Ref: Page Location Traps-Footnote-3&#x7f;442850
+Node: The Implicit Page Trap&#x7f;443048
+Node: The Implicit Page Trap-Footnotes&#x7f;444309
+Ref: The Implicit Page Trap-Footnote-1&#x7f;444399
+Ref: The Implicit Page Trap-Footnote-2&#x7f;444426
+Node: Diversion Traps&#x7f;444454
+Node: Input Line Traps&#x7f;445241
+Node: Blank Line Traps&#x7f;448690
+Node: Leading Space Traps&#x7f;449222
+Node: End-of-input Traps&#x7f;450106
+Node: End-of-input Traps-Footnotes&#x7f;454067
+Ref: End-of-input Traps-Footnote-1&#x7f;454149
+Ref: End-of-input Traps-Footnote-2&#x7f;454300
+Node: Diversions&#x7f;454402
+Node: Diversions-Footnotes&#x7f;463874
+Ref: Diversions-Footnote-1&#x7f;463940
+Node: Punning Names&#x7f;464008
+Node: Punning Names-Footnotes&#x7f;467295
+Ref: Punning Names-Footnote-1&#x7f;467367
+Node: Environments&#x7f;467421
+Node: Suppressing Output&#x7f;472573
+Node: I/O&#x7f;475340
+Node: Postprocessor Access&#x7f;484470
+Node: Postprocessor Access-Footnotes&#x7f;487454
+Ref: Postprocessor Access-Footnote-1&#x7f;487540
+Ref: Postprocessor Access-Footnote-2&#x7f;487600
+Node: Miscellaneous&#x7f;487776
+Node: Miscellaneous-Footnotes&#x7f;494416
+Ref: Miscellaneous-Footnote-1&#x7f;494488
+Ref: Miscellaneous-Footnote-2&#x7f;494524
+Node: Gtroff Internals&#x7f;494774
+Node: Gtroff Internals-Footnotes&#x7f;499136
+Ref: Gtroff Internals-Footnote-1&#x7f;499214
+Node: Debugging&#x7f;499355
+Node: Warnings&#x7f;506281
+Node: Implementation Differences&#x7f;511010
+Node: Safer Mode&#x7f;511464
+Node: Compatibility Mode&#x7f;511946
+Node: Compatibility Mode-Footnotes&#x7f;517233
+Ref: Compatibility Mode-Footnote-1&#x7f;517315
+Node: Other Differences&#x7f;517696
+Node: Other Differences-Footnotes&#x7f;524092
+Ref: Other Differences-Footnote-1&#x7f;524172
+Ref: Other Differences-Footnote-2&#x7f;524252
+Ref: Other Differences-Footnote-3&#x7f;524429
+Node: File Formats&#x7f;524649
+Node: gtroff Output&#x7f;524960
+Node: gtroff Output-Footnotes&#x7f;526820
+Ref: gtroff Output-Footnote-1&#x7f;526892
+Node: Language Concepts&#x7f;527027
+Node: Separation&#x7f;528140
+Node: Argument Units&#x7f;530374
+Node: Document Parts&#x7f;531511
+Node: Command Reference&#x7f;532909
+Node: Comment Command&#x7f;533325
+Node: Simple Commands&#x7f;533823
+Node: Graphics Commands&#x7f;539265
+Node: Device Control Commands&#x7f;546605
+Node: Obsolete Command&#x7f;550738
+Node: Intermediate Output Examples&#x7f;552015
+Node: Output Language Compatibility&#x7f;554799
+Node: Device and Font Description Files&#x7f;556878
+Node: Device and Font Description Files-Footnotes&#x7f;558261
+Ref: Device and Font Description Files-Footnote-1&#x7f;558373
+Node: DESC File Format&#x7f;558434
+Node: Font Description File Format&#x7f;564511
+Node: Font Description File Format-Footnotes&#x7f;572537
+Ref: Font Description File Format-Footnote-1&#x7f;572639
+Ref: Font Description File Format-Footnote-2&#x7f;572793
+Ref: Font Description File Format-Footnote-3&#x7f;573006
+Ref: Font Description File Format-Footnote-4&#x7f;573115
+Node: Copying This Manual&#x7f;573202
+Node: Request Index&#x7f;598317
+Node: Escape Sequence Index&#x7f;616581
+Node: Operator Index&#x7f;623925
+Node: Register Index&#x7f;625858
+Node: Macro Index&#x7f;640236
+Node: String Index&#x7f;651800
+Node: File Keyword Index&#x7f;659362
+Node: Program and File Index&#x7f;663322
+Node: Concept Index&#x7f;669178
+&#x1f;
+End Tag Table
+
+&#x1f;
+Local Variables:
+coding: iso-8859-1
+End:

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.info-1 Added

@@ -0,0 +1,7824 @@
+This is groff.info, produced by makeinfo version 7.0.3 from groff.texi.
+
+This manual documents GNU 'troff' version 1.23.0.
+
+   Copyright © 1994-2023 Free Software Foundation, Inc.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.3 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     no Back-Cover Texts.  A copy of the license is included in the
+     section entitled "GNU Free Documentation License".
+INFO-DIR-SECTION Typesetting
+START-INFO-DIR-ENTRY
+* Groff: (groff).               The GNU roff document formatting system.
+END-INFO-DIR-ENTRY
+
+&#x1f;
+File: groff.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
+
+GNU 'troff'
+***********
+
+* Menu:
+
+* Introduction::
+* Invoking groff::
+* Tutorial for Macro Users::
+* Major Macro Packages::
+* GNU troff Reference::
+* File Formats::
+* Copying This Manual::
+* Request Index::
+* Escape Sequence Index::
+* Operator Index::
+* Register Index::
+* Macro Index::
+* String Index::
+* File Keyword Index::
+* Program and File Index::
+* Concept Index::
+
+This manual documents GNU 'troff' version 1.23.0.
+
+   Copyright © 1994-2023 Free Software Foundation, Inc.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.3 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     no Back-Cover Texts.  A copy of the license is included in the
+     section entitled "GNU Free Documentation License".
+
+&#x1f;
+File: groff.info,  Node: Introduction,  Next: Invoking groff,  Prev: Top,  Up: Top
+
+1 Introduction
+**************
+
+GNU 'roff' (or 'groff') is a programming system for typesetting
+documents.  It is highly flexible and has been used extensively for over
+thirty years.
+
+* Menu:
+
+* Background::
+* What Is groff?::
+* groff Capabilities::
+* Macro Package Intro::
+* Preprocessor Intro::
+* Output Device Intro::
+* Conventions Used in This Manual::
+* Installation::
+* Credits::
+
+&#x1f;
+File: groff.info,  Node: Background,  Next: What Is groff?,  Prev: Introduction,  Up: Introduction
+
+1.1 Background
+==============
+
+M. Douglas McIlroy, formerly of AT&T Bell Laboratories and present at
+the creation of the Unix operating system, offers an authoritative
+historical summary.
+
+     The prime reason for Unix was the desire of Ken Thompson, Dennis
+     Ritchie, and Joe Ossanna to have a pleasant environment for
+     software development.  The fig leaf that got the nod from ...
+     management was that an early use would be to develop a
+     "stand-alone" word-processing system for use in typing pools and
+     secretarial offices.  Perhaps they had in mind "dedicated", as
+     distinct from "stand-alone"; that's what eventuated in various
+     cases, most notably in the legal/patent department and in the AT&T
+     CEO's office.
+
+     Both those systems were targets of opportunity, not foreseen from
+     the start.  When Unix was up and running on the PDP-11, Joe got
+     wind of the legal department having installed a commercial word
+     processor.  He went to pitch Unix as an alternative and clinched a
+     trial by promising to make 'roff' able to number lines by tomorrow
+     in order to fulfill a patent-office requirement that the commercial
+     system did not support.
+
+     Modems were installed so legal-department secretaries could try the
+     Research machine.  They liked it and Joe's superb customer service.
+     Soon the legal department got a system of their own.  Joe went on
+     to create 'nroff' and 'troff'.  Document preparation became a
+     widespread use of Unix, but no stand-alone word-processing system
+     was ever undertaken.
+
+   A history relating 'groff' to its predecessors 'roff', 'nroff', and
+'troff' is available in the 'roff(7)' man page.
+
+&#x1f;
+File: groff.info,  Node: What Is groff?,  Next: groff Capabilities,  Prev: Introduction,  Up: Introduction
+
+1.2 What Is 'groff'?
+====================
+
+'groff' (GNU 'roff') is a typesetting system that reads plain text input
+files that include formatting commands to produce output in PostScript,
+PDF, HTML, DVI, or other formats, or for display to a terminal.
+Formatting commands can be low-level typesetting primitives, macros from
+a supplied package, or user-defined macros.  All three approaches can be
+combined.
+
+   A reimplementation and extension of the typesetter from AT&T Unix,
+'groff' is present on most POSIX systems owing to its long association
+with Unix manuals (including man pages).  It and its predecessor are
+notable for their production of several best-selling software
+engineering texts.  'groff' is capable of producing typographically
+sophisticated documents while consuming minimal system resources.
+
+&#x1f;
+File: groff.info,  Node: groff Capabilities,  Next: Macro Package Intro,  Prev: What Is groff?,  Up: Introduction
+
+1.3 'groff' Capabilities
+========================
+
+GNU 'troff' is a typesetting document formatter; it provides a wide
+range of low-level text and page operations within the framework of a
+programming language.  These operations compose to generate footnotes,
+tables of contents, mathematical equations, diagrams, multi-column text,
+and other elements of typeset works.  Here is a survey of formatter
+features; all are under precise user control.
+
+   * text filling, breaking, alignment to the left or right margin;
+     centering
+
+   * adjustment of inter-word space size to justify text, and of
+     inter-sentence space size to suit local style conventions
+
+   * automatic and manual determination of hyphenation break points
+
+   * pagination
+
+   * selection of any font available to the output device
+
+   * adjustment of type size and vertical spacing (or "leading")
+
+   * configuration of line length and indentation amounts; columnation
+
+   * drawing of geometric primitives (lines, arcs, polygons, circles,
+     ...)
+
+   * setup of stroke and fill colors (where supported by the output
+     device)
+
+   * embedding of hyperlinks, images, document metadata, and other
+     inclusions (where supported by the output device)
+
+&#x1f;
+File: groff.info,  Node: Macro Package Intro,  Next: Preprocessor Intro,  Prev: groff Capabilities,  Up: Introduction
+
+1.4 Macro Packages
+==================
+
+Elemental typesetting functions can be be challenging to use directly
+with complex documents.  A "macro" facility specifies how certain
+routine operations, such as starting paragraphs, or printing headers and
+footers, should be performed in terms of those low-level instructions.
+Macros can be specific to one document or collected together into a
+"macro package" for use by many.  Several macro packages available; the
+most widely used are provided with 'groff'.  They are 'man', 'mdoc',
+'me', 'mm', 'mom', and 'ms'.
+
+&#x1f;
+File: groff.info,  Node: Preprocessor Intro,  Next: Output Device Intro,  Prev: Macro Package Intro,  Up: Introduction
+
+1.5 Preprocessors
+=================
+
+An alternative approach to complexity management, particularly when
+constructing tables, setting mathematics, or drawing diagrams, lies in
+preprocessing.  A "preprocessor" employs a domian-specific language to
+ease the generation of tables, equations, and so forth in terms that are
+convenient for human entry.  Each preprocessor reads a document and
+translates the parts of it that apply to it into GNU 'troff' input.
+Command-line options to 'groff' tell it which preprocessors to use.
+
+   'groff' provides preprocessors for laying out tables ('gtbl'),
+typesetting equations ('geqn'), drawing diagrams ('gpic' and 'ggrn'),
+inserting bibliographic references ('grefer'), and drawing chemical
+structures ('gchem').  An associated program that is useful when dealing
+with preprocessors is 'gsoelim'.(1)  (*note Preprocessor
+Intro-Footnote-1::)
+
+   'groff' also supports 'grap', a preprocessor for drawing graphs.  A
+free implementation of it can be obtained separately.
+
+   Unique to 'groff' is the 'preconv' preprocessor that enables 'groff'
+to handle documents in a variety of input encodings.
+
+   Other preprocessors exist, but no free implementations are known.  An
+example is 'ideal', which draws diagrams using a mathematical constraint
+language.
+
+&#x1f;
+File: groff.info,  Node: Preprocessor Intro-Footnotes,  Up: Preprocessor Intro
+
+   (1) The 'g' prefix is not used on all systems; see *note Invoking
+groff::.
+
+&#x1f;
+File: groff.info,  Node: Output Device Intro,  Next: Installation,  Prev: Preprocessor Intro,  Up: Introduction
+
+1.6 Output Devices
+==================
+
+GNU 'troff''s output is in a device-independent page description
+language, which is then read by an "output driver" that translates this
+language into a file format or byte stream that a piece of (possibly
+emulated) hardware understands.  'groff' features output drivers for
+PostScript devices, terminal emulators (and other simple typewriter-like
+machines), X11 (for previewing), TeX DVI, HP LaserJet 4/PCL5 and Canon
+LBP printers (which use CaPSL), HTML, XHTML, and PDF.
+
+&#x1f;
+File: groff.info,  Node: Installation,  Next: Conventions Used in This Manual,  Prev: Output Device Intro,  Up: Introduction
+
+1.7 Installation
+================
+
+Locate installation instructions in the files 'INSTALL',
+'INSTALL.extra', and 'INSTALL.REPO' in the 'groff' source distribution.
+Being a GNU project, 'groff' supports the familiar './configure && make'
+command sequence.
+
+&#x1f;
+File: groff.info,  Node: Conventions Used in This Manual,  Next: Credits,  Prev: Installation,  Up: Introduction
+
+1.8 Conventions Used in This Manual
+===================================
+
+We apply the term "groff" to the language documented here, the GNU
+implementation of the overall system, the project that develops that
+system, and the command of that name.  In the first sense, 'groff' is an
+extended dialect of the 'roff' language, for which many similar
+implementations exist.
+
+   The 'roff' language features several major categories for which many
+items are predefined.  Presentations of these items feature the form in
+which the item is most commonly used on the left, and, aligned to the
+right margin, the name of the category in brackets.
+
+ -- Register: \nexample
+     The register 'example' is one that that 'groff' _doesn't_
+     predefine.  You can create it yourself, though; see *note Setting
+     Registers::.
+
+   To make this document useful as a reference and not merely amiable
+bedtime reading, we tend to present these syntax items in exhaustive
+detail when they arise.  References to topics discussed later in the
+text are frequent; skip material you don't understand yet.
+
+   We use Texinfo's "result" (=>) and error-> notations to present
+output written to the standard output and standard error streams,
+respectively.  Diagnostic messages from the GNU 'troff' formatter and
+other programs are examples of the latter, but the formatter can also be
+directed to write user-specified messages to the standard error stream.
+The notation then serves to identify the output stream and does not
+necessarily mean that an error has occurred.(1)  (*note Conventions Used
+in This Manual-Footnote-1::)
+
+     $ echo "Twelve o'clock and" | groff -Tascii | sed '/^$/d'
+         => Twelve o'clock and
+     $ echo '.tm all is well.' | groff > /dev/null
+         error-> all is well.
+
+   Sometimes we use => somewhat abstractly to represent formatted text
+that you will need to use a PostScript or PDF viewer program (or a
+printer) to observe.  While arguably an abuse of notation, we think this
+preferable to requiring the reader to understand the syntax of these
+page description languages.
+
+   We also present diagnostic messages in an abbreviated form, often
+omitting the name of the program issuing them, the input file name, and
+line number or other positional information when such data do not serve
+to illuminate the topic under discussion.
+
+   Most examples are of 'roff' language input that would be placed in a
+text file.  Occasionally, we start an example with a '$' character to
+indicate a shell prompt, as seen above.
+
+   You are encouraged to try the examples yourself, and to alter them to
+better learn 'groff''s behavior.  Our examples frequently need to direct
+the formatter to set a line length (with '.ll') that will fit within the
+page margins of this manual.  We mention this so that you know why it is
+there before we discuss the 'll' request formally.(2)  (*note
+Conventions Used in This Manual-Footnote-2::)
+
+&#x1f;
+File: groff.info,  Node: Conventions Used in This Manual-Footnotes,  Up: Conventions Used in This Manual
+
+   (1) Unix and related operating systems distinguish standard output
+and standard error streams _because_ of 'troff':
+<https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html>.
+
+   (2) *Note Line Layout::.
+
+&#x1f;
+File: groff.info,  Node: Credits,  Prev: Conventions Used in This Manual,  Up: Introduction
+
+1.9 Credits
+===========
+
+We adapted portions of this manual from existing documents.  James
+Clark's man pages were an essential resource; we have updated them in
+parallel with the development of this manual.  We based the tutorial for
+macro users on Eric Allman's introduction to his 'me' macro package
+(which we also provide, little altered from 4.4BSD). Larry Kollar
+contributed much of the material on the 'ms' macro package.
+
+&#x1f;
+File: groff.info,  Node: Invoking groff,  Next: Tutorial for Macro Users,  Prev: Introduction,  Up: Top
+
+2 Invoking 'groff'
+******************
+
+This chapter focuses on how to invoke the 'groff' front end.  This front
+end takes care of the details of constructing the pipeline among the
+preprocessors, 'gtroff' and the postprocessor.
+
+   It has become a tradition that GNU programs get the prefix 'g' to
+distinguish them from their original counterparts provided by the host
+(*note Environment::).  Thus, for example, 'geqn' is GNU 'eqn'.  On
+operating systems like GNU/Linux or the Hurd, which don't contain
+proprietary versions of 'troff', and on MS-DOS/MS-Windows, where 'troff'
+and associated programs are not available at all, this prefix is omitted
+since GNU 'troff' is the only incarnation of 'troff' used.  Exception:
+'groff' is never replaced by 'roff'.
+
+   In this document, we consequently say 'gtroff' when talking about the
+GNU 'troff' program.  All other implementations of 'troff' are called
+AT&T 'troff', which is the common origin of almost all 'troff'
+implementations(1) (*note Invoking groff-Footnote-1::) (with more or
+less compatible changes).  Similarly, we say 'gpic', 'geqn', and so on.
+
+* Menu:
+
+* Groff Options::
+* Environment::
+* Macro Directories::
+* Font Directories::
+* Paper Format::
+* Invocation Examples::
+
+&#x1f;
+File: groff.info,  Node: Invoking groff-Footnotes,  Up: Invoking groff
+
+   (1) Besides 'groff', 'neatroff' is an exception.
+
+&#x1f;
+File: groff.info,  Node: Groff Options,  Next: Environment,  Prev: Invoking groff,  Up: Invoking groff
+
+2.1 Options
+===========
+
+'groff' normally runs the 'gtroff' program and a postprocessor
+appropriate for the selected device.  The default device is 'ps' (but it
+can be changed when 'groff' is configured and built).  It can optionally
+preprocess with any of 'gpic', 'geqn', 'gtbl', 'ggrn', 'grap', 'gchem',
+'grefer', 'gsoelim', or 'preconv'.
+
+   This section documents only options to the 'groff' front end.  Many
+of the arguments to 'groff' are passed on to 'gtroff'; therefore, those
+are also included.  Arguments to preprocessors and output drivers can be
+found in the man pages 'gpic(1)', 'geqn(1)', 'gtbl(1)', 'ggrn(1)',
+'grefer(1)', 'gchem(1)', 'gsoelim(1)', 'preconv(1)', 'grotty(1)',
+'grops(1)', 'gropdf(1)', 'grohtml(1)', 'grodvi(1)', 'grolj4(1)',
+'grolbp(1)', and 'gxditview(1)'.
+
+   The command-line format for 'groff' is:
+
+     groff  -abceghijklpstvzCEGNRSUVXZ   -dCS   -DARG 
+            -fFAM   -FDIR   -IDIR   -KARG 
+            -LARG   -mNAME   -MDIR   -nNUM 
+            -oLIST   -PARG   -rCN   -TDEV 
+            -wNAME   -WNAME   FILES... 
+
+   The command-line format for 'gtroff' is as follows.
+
+     gtroff  -abcivzCERU   -dCS   -fFAM   -FDIR 
+             -mNAME   -MDIR   -nNUM   -oLIST 
+             -rCN   -TNAME   -wNAME   -WNAME 
+             FILES... 
+
+Obviously, many of the options to 'groff' are actually passed on to
+'gtroff'.
+
+   Options without an argument can be grouped behind a single '-'.  A
+filename of '-' denotes the standard input.  Whitespace is permitted
+between an option and its argument.
+
+   The 'grog' command can be used to guess the correct 'groff' command
+to format a file.  See its man page 'grog(1)'; type 'man grog' at the
+command line to view it.
+
+   'groff''s command-line options are as follows.
+
+'-a'
+     Generate a plain text approximation of the typeset output.  The
+     read-only register '.A' is set to 1.  *Note Built-in Registers::.
+     This option produces a sort of abstract preview of the formatted
+     output.
+
+        * Page breaks are marked by a phrase in angle brackets; for
+          example, '<beginning of page>'.
+
+        * Lines are broken where they would be in the formatted output.
+
+        * A horizontal motion of any size is represented as one space.
+          Adjacent horizontal motions are not combined.  Inter-sentence
+          space nodes (those arising from the second argument to the
+          'ss' request) are not represented.
+
+        * Vertical motions are not represented.
+
+        * Special characters are rendered in angle brackets; for
+          example, the default soft hyphen character appears as '<hy>'.
+
+     The above description should not be considered a specification; the
+     details of '-a' output are subject to change.
+
+'-b'
+     Write a backtrace reporting the state of 'gtroff''s input parser to
+     the standard error stream with each diagnostic message.  The line
+     numbers given in the backtrace might not always be correct, because
+     'gtroff''s idea of line numbers can be confused by requests that
+     append to macros.
+
+'-c'
+     Start with color output disabled.
+
+'-C'
+     Enable AT&T 'troff' compatibility mode; implies '-c'.  *Note
+     Implementation Differences::, for the list of incompatibilities
+     between 'groff' and AT&T 'troff'.
+
+'-dCTEXT'
+'-dSTRING=TEXT'
+     Define 'roff' string C or STRING as T or TEXT.  C must be one
+     character; STRING can be of arbitrary length.  Such string
+     assignments happen before any macro file is loaded, including the
+     startup file.  Due to 'getopt_long' limitations, C cannot be, and
+     STRING cannot contain, an equals sign, even though that is a valid
+     character in a 'roff' identifier.
+
+'-DENC'
+     Set fallback input encoding used by 'preconv' to ENC; implies '-k'.
+
+'-e'
+     Run 'geqn' preprocessor.
+
+'-E'
+     Inhibit 'gtroff' error messages.  This option does _not_ suppress
+     messages sent to the standard error stream by documents or macro
+     packages using 'tm' or related requests.
+
+'-fFAM'
+     Use FAM as the default font family.  *Note Font Families::.
+
+'-FDIR'
+     Search in directory 'DIR' for the selected output device's
+     directory of device and font description files.  See the
+     description of 'GROFF_FONT_PATH' in *note Environment:: below for
+     the default search locations and ordering.
+
+'-g'
+     Run 'ggrn' preprocessor.
+
+'-G'
+     Run 'grap' preprocessor; implies '-p'.
+
+'-h'
+     Display a usage message and exit.
+
+'-i'
+     Read the standard input after all the named input files have been
+     processed.
+
+'-IDIR'
+     Search the directory DIR for files named in several contexts;
+     implies '-g' and '-s'.
+
+        * 'gsoelim' replaces 'so' requests with the contents of their
+          file name arguments.
+
+        * 'gtroff' searches for files named as operands in its command
+          line and as arguments to 'psbb', 'so', and 'soquiet' requests.
+
+        * Output drivers may search for files; for instance, 'grops'
+          looks for files named in '\X'ps: import ...'', '\X'ps: file
+          ...'', and '\X'pdf: pdfpic ...'' device control escape
+          sequences.
+
+     This option may be specified more than once; the directories are
+     searched in the order specified.  If you want to search the current
+     directory before others, add '-I .' at the desired place.  The
+     current working directory is otherwise searched last.  '-I' works
+     similarly to, and is named for, the "include" option of Unix C
+     compilers.
+
+     '-I' options are passed to 'gsoelim', 'gtroff', and output drivers;
+     with the flag letter changed to '-M', they are also passed to
+     'ggrn'.
+
+'-j'
+     Run 'gchem' preprocessor.  Implies '-p'.
+
+'-k'
+     Run 'preconv' preprocessor.  Refer to its man page for its behavior
+     if neither of 'groff''s '-K' or '-D' options is also specified.
+
+'-KENC'
+     Set input encoding used by 'preconv' to ENC; implies '-k'.
+
+'-l'
+     Send the output to a spooler for printing.  The 'print' directive
+     in the device description file specifies the default command to be
+     used; see *note Device and Font Description Files::.  See options
+     '-L' and '-X'.
+
+'-LARG'
+     Pass ARG to the print spooler program.  If multiple ARGs are
+     required, pass each with a separate '-L' option.  'groff' does not
+     prefix an option dash to ARG before passing it to the spooler
+     program.
+
+'-mNAME'
+     Process the file 'NAME.tmac' prior to any input files.  If not
+     found, 'tmac.NAME' is attempted.  NAME (in both arrangements) is
+     presumed to be a macro file; see the description of
+     'GROFF_TMAC_PATH' in *note Environment:: below for the default
+     search locations and ordering.  This option and its argument are
+     also passed to 'geqn', 'grap', and 'ggrn'.
+
+'-MDIR'
+     Search directory 'DIR' for macro files; see the description of
+     'GROFF_TMAC_PATH' in *note Environment:: below for the default
+     search locations and ordering.  This option and its argument are
+     also passed to 'geqn', 'grap', and 'ggrn'.
+
+'-nNUM'
+     Number the first page NUM.
+
+'-N'
+     Prohibit newlines between 'eqn' delimiters: pass '-N' to 'geqn'.
+
+'-oLIST'
+     Output only pages in LIST, which is a comma-separated list of page
+     ranges; 'N' means page N, 'M-N' means every page between M and N,
+     '-N' means every page up to N, 'N-' means every page from N on.
+     'gtroff' stops processing and exits after formatting the last page
+     enumerated in LIST.
+
+'-p'
+     Run 'gpic' preprocessor.
+
+'-PARG'
+     Pass ARG to the postprocessor.  If multiple ARGs are required, pass
+     each with a separate '-P' option.  'groff' does not prefix an
+     option dash to ARG before passing it to the postprocessor.
+
+'-rCNUMERIC-EXPRESSION'
+'-rREGISTER=EXPR'
+     Set 'roff' register C or REGISTER to the value NUMERIC-EXPRESSION
+     (*note Numeric Expressions::).  C must be one character; REGISTER
+     can be of arbitrary length.  Such register assignments happen
+     before any macro file is loaded, including the startup file.  Due
+     to 'getopt_long' limitations, C cannot be, and REGISTER cannot
+     contain, an equals sign, even though that is a valid character in a
+     'roff' identifier.
+
+'-R'
+     Run 'grefer' preprocessor.  No mechanism is provided for passing
+     arguments to 'grefer' because most 'grefer' options have equivalent
+     language elements that can be specified within the document.
+
+     'gtroff' also accepts a '-R' option, which is not accessible via
+     'groff'.  This option prevents the loading of the 'troffrc' and
+     'troffrc-end' files.
+
+'-s'
+     Run 'gsoelim' preprocessor.
+
+'-S'
+     Operate in "safer" mode; see '-U' below for its opposite.  For
+     security reasons, safer mode is enabled by default.
+
+'-t'
+     Run 'gtbl' preprocessor.
+
+'-TDEV'
+     Direct 'gtroff' to format the input for the output device DEV.
+     'groff' then calls an output driver to convert 'gtroff''s output to
+     a form appropriate for DEV.  The following output devices are
+     available.
+
+     'ps'
+          For PostScript printers and previewers.
+
+     'pdf'
+          For PDF viewers or printers.
+
+     'dvi'
+          For TeX DVI format.
+
+     'X75'
+          For a 75dpi X11 previewer.
+
+     'X75-12'
+          For a 75dpi X11 previewer with a 12-point base font in the
+          document.
+
+     'X100'
+          For a 100dpi X11 previewer.
+
+     'X100-12'
+          For a 100dpi X11 previewer with a 12-point base font in the
+          document.
+
+     'ascii'
+          For typewriter-like devices using the (7-bit) ASCII (ISO 646)
+          character set.
+
+     'latin1'
+          For typewriter-like devices that support the Latin-1
+          (ISO 8859-1) character set.
+
+     'utf8'
+          For typewriter-like devices that use the Unicode (ISO 10646)
+          character set with UTF-8 encoding.
+
+     'cp1047'
+          For typewriter-like devices that use the EBCDIC encoding IBM
+          code page 1047.
+
+     'lj4'
+          For HP LaserJet4-compatible (or other PCL5-compatible)
+          printers.
+
+     'lbp'
+          For Canon CaPSL printers (LBP-4 and LBP-8 series laser
+          printers).
+
+     'html'
+     'xhtml'
+          To produce HTML and XHTML output, respectively.  This driver
+          consists of two parts, a preprocessor ('pre-grohtml') and a
+          postprocessor ('post-grohtml').
+
+     The predefined GNU 'troff' string '.T' contains the name of the
+     output device; the read-only register '.T' is set to 1 if this
+     option is used (which is always true if 'groff' is used to call GNU
+     'troff').  *Note Built-in Registers::.
+
+     The postprocessor to be used for a device is specified by the
+     'postpro' command in the device description file.  (*Note Device
+     and Font Description Files::.)  This can be overridden with the
+     '-X' option.
+
+'-U'
+     Operate in "unsafe mode", which enables the 'open', 'opena', 'pi',
+     'pso', and 'sy' requests.  These requests are disabled by default
+     because they allow an untrusted input document to write to
+     arbitrary file names and run arbitrary commands.  This option also
+     adds the current directory to the macro package search path; see
+     the '-m' option above.  '-U' is passed to 'gpic' and 'gtroff'.
+
+'-v'
+     Write version information for 'groff' and all programs run by it to
+     the standard output stream; that is, the given command line is
+     processed in the usual way, passing '-v' to the formatter and any
+     pre- or postprocessors invoked.
+
+'-V'
+     Output the pipeline that would be run by 'groff' (as a wrapper
+     program) to the standard output stream, but do not execute it.  If
+     given more than once, the pipeline is both written to the standard
+     error stream and run.
+
+'-wCATEGORY'
+     Enable warnings in CATEGORY.  Categories are listed in *note
+     Warnings::.
+
+'-WCATEGORY'
+     Inhibit warnings in CATEGORY.  Categories are listed in *note
+     Warnings::.
+
+'-X'
+     Use 'gxditview' instead of the usual postprocessor to (pre)view a
+     document on an X11 display.  Combining this option with '-Tps' uses
+     the font metrics of the PostScript device, whereas the '-TX75' and
+     '-TX100' options use the metrics of X11 fonts.
+
+'-z'
+     Suppress formatted output from 'gtroff'.
+
+'-Z'
+     Disable postprocessing.  'gtroff' output will appear on the
+     standard output stream (unless suppressed with '-z'; see *note
+     gtroff Output:: for a description of this format.
+
+&#x1f;
+File: groff.info,  Node: Environment,  Next: Macro Directories,  Prev: Groff Options,  Up: Invoking groff
+
+2.2 Environment
+===============
+
+There are also several environment variables (of the operating system,
+not within 'gtroff') that can modify the behavior of 'groff'.
+
+'GROFF_BIN_PATH'
+     This search path, followed by 'PATH', is used for commands executed
+     by 'groff'.
+
+'GROFF_COMMAND_PREFIX'
+     If this is set to X, then 'groff' runs 'Xtroff' instead of
+     'gtroff'.  This also applies to 'tbl', 'pic', 'eqn', 'grn', 'chem',
+     'refer', and 'soelim'.  It does not apply to 'grops', 'grodvi',
+     'grotty', 'pre-grohtml', 'post-grohtml', 'preconv', 'grolj4',
+     'gropdf', and 'gxditview'.
+
+     The default command prefix is determined during the installation
+     process.  If a non-GNU 'troff' system is found, prefix 'g' is used,
+     none otherwise.
+
+'GROFF_ENCODING'
+     The value of this variable is passed to the 'preconv'
+     preprocessor's '-e' option to select the character encoding of
+     input files.  This variable's existence implies the 'groff' option
+     '-k'.  If set but empty, 'groff' calls 'preconv' without an '-e'
+     option.  'groff''s '-K' option overrides 'GROFF_ENCODING'.  See the
+     'preconv(7)' man page; type 'man preconv' at the command line to
+     view it.
+
+'GROFF_FONT_PATH'
+     A list of directories in which to seek the selected output device's
+     directory of device and font description files.  GNU 'troff' will
+     search directories given as arguments to any specified '-F' options
+     before these, and a built-in list of directories after them.  *Note
+     Font Directories:: and the 'troff(1)' or 'gtroff(1)' man pages.
+
+'GROFF_TMAC_PATH'
+     A list of directories in which to seek macro files.  GNU 'troff'
+     will search directories given as arguments to any specified '-M'
+     options before these, and a built-in list of directories after
+     them.  *Note Macro Directories:: and the 'troff(1)' or 'gtroff(1)'
+     man pages.
+
+'GROFF_TMPDIR'
+     The directory in which 'groff' creates temporary files.  If this is
+     not set and 'TMPDIR' is set, temporary files are created in that
+     directory.  Otherwise temporary files are created in a
+     system-dependent default directory (on Unix and GNU/Linux systems,
+     this is usually '/tmp').  'grops', 'grefer', 'pre-grohtml', and
+     'post-grohtml' can create temporary files in this directory.
+
+'GROFF_TYPESETTER'
+     Sets the default output device.  If empty or not set, a build-time
+     default (often 'ps') is used.  The '-TDEV' option overrides
+     'GROFF_TYPESETTER'.
+
+'SOURCE_DATE_EPOCH'
+     A timestamp (expressed as seconds since the Unix epoch) to use as
+     the output creation timestamp in place of the current time.  The
+     time is converted to human-readable form using 'localtime(3)' when
+     the formatter starts up and stored in registers usable by documents
+     and macro packages (*note Built-in Registers::).
+
+'TZ'
+     The time zone to use when converting the current time (or value of
+     'SOURCE_DATE_EPOCH') to human-readable form; see 'tzset(3)'.
+
+   MS-DOS and MS-Windows ports of 'groff' use semicolons, rather than
+colons, to separate the directories in the lists described above.
+
+&#x1f;
+File: groff.info,  Node: Macro Directories,  Next: Font Directories,  Prev: Environment,  Up: Invoking groff
+
+2.3 Macro Directories
+=====================
+
+A macro file must have a name in the form 'NAME.tmac' or 'tmac.NAME' and
+be placed in a "tmac directory" to be found by the '-mNAME' command-line
+option.(1)  (*note Macro Directories-Footnote-1::) Together, these
+directories constitute the "tmac path".  Each directory is searched in
+the following order until the desired macro file is found or the list is
+exhausted.
+
+   * Directories specified with GNU 'troff''s or 'groff''s '-M'
+     command-line option.
+
+   * Directories listed in the 'GROFF_TMAC_PATH' environment variable.
+
+   * The current working directory (only if in unsafe mode using the
+     '-U' command-line option).
+
+   * The user's home directory, 'HOME'.
+
+   * A platform-dependent directory, a site-local (platform-independent)
+     directory, and the main tmac directory.  The locations
+     corresponding to your installation are listed in section
+     "Environment" of 'gtroff(1)'.  If not otherwise configured, they
+     are as follows.
+
+          /usr/local/lib/groff/site-tmac
+          /usr/local/share/groff/site-tmac
+          /usr/local/share/groff/1.23.0/tmac
+
+     The foregoing assumes that the version of 'groff' is 1.23.0, and
+     that the installation prefix was '/usr/local'.  It is possible to
+     fine-tune these locations during the source configuration process.
+
+&#x1f;
+File: groff.info,  Node: Macro Directories-Footnotes,  Up: Macro Directories
+
+   (1) The 'mso' request does not have these limitations.  *Note I/O::.
+
+&#x1f;
+File: groff.info,  Node: Font Directories,  Next: Paper Format,  Prev: Macro Directories,  Up: Invoking groff
+
+2.4 Font Directories
+====================
+
+'groff' enforces few restrictions on how font description files are
+named.  For its family/style mechanism to work (*note Font Families::),
+the names of fonts within a family should start with the family name,
+followed by the style.  For example, the Times family uses 'T' for the
+family name and 'R', 'B', 'I', and 'BI' to indicate the styles 'roman',
+'bold', 'italic', and 'bold italic', respectively.  Thus the final font
+names are 'TR', 'TB', 'TI', and 'TBI'.
+
+   Font description files are kept in "font directories", which together
+constitute the "font path".  The search procedure always appends the
+directory 'dev'NAME, where NAME is the name of the output device.
+Assuming TeX DVI output, and '/foo/bar' as a font directory, the font
+description files for 'grodvi' must be in '/foo/bar/devdvi'.  Each
+directory in the font path is searched in the following order until the
+desired font description file is found or the list is exhausted.
+
+   * Directories specified with GNU 'troff''s or 'groff''s '-f'
+     command-line option.  All output drivers (and some preprocessors)
+     support this option as well, because they require information about
+     the glyphs to be rendered in the document.
+
+   * Directories listed in the 'GROFF_FONT_PATH' environment variable.
+
+   * A site-local directory and the main font description directory.
+     The locations corresponding to your installation are listed in
+     section "Environment" of 'gtroff(1)'.  If not otherwise configured,
+     they are as follows.
+
+          /usr/local/share/groff/site-font
+          /usr/local/share/groff/1.23.0/font
+
+     The foregoing assumes that the version of 'groff' is 1.23.0, and
+     that the installation prefix was '/usr/local'.  It is possible to
+     fine-tune these locations during the source configuration process.
+
+&#x1f;
+File: groff.info,  Node: Paper Format,  Next: Invocation Examples,  Prev: Font Directories,  Up: Invoking groff
+
+2.5 Paper Format
+================
+
+In 'groff', the page dimensions for the formatter GNU 'troff' and for
+output devices are handled separately.  *Note Page Layout::, for
+vertical manipulation of the page size, and *Note Line Layout::, for
+horizontal changes.  The 'papersize' macro package, normally loaded by
+'troffrc' at startup, provides an interface for configuring page
+dimensions by convenient names, like 'letter' or 'a4'; see
+'groff_tmac(5)'.  The default used by the formatter depends on its build
+configuration, but is usually one of the foregoing, as geographically
+appropriate.
+
+   It is up to each macro package to respect the page dimensions
+configured in this way.
+
+   For each output device, the size of the output medium can be set in
+its 'DESC' file.  Most output drivers also recognize a command-line
+option '-p' to override the default dimensions and an option '-l' to use
+landscape orientation.  *Note DESC File Format::, for a description of
+the 'papersize' keyword, which takes an argument of the same form as
+'-p'.  The output driver's man page, such as 'grops(1)', may also be
+helpful.
+
+   'groff' uses the command-line option '-P' to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
+
+     groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+
+&#x1f;
+File: groff.info,  Node: Invocation Examples,  Prev: Paper Format,  Up: Invoking groff
+
+2.6 Invocation Examples
+=======================
+
+'roff' systems are best known for formatting man pages.  Once a 'man'
+librarian program has located a man page, it may execute a 'groff'
+command much like the following.
+
+     groff -t -man -Tutf8 /usr/share/man/man1/groff.1
+
+   The librarian will also pipe the output through a pager, which might
+not interpret the SGR terminal escape sequences 'groff' emits for
+boldface, underlining, or italics; see the 'grotty(1)' man page for a
+discussion.
+
+   To process a 'roff' input file using the preprocessors 'gtbl' and
+'gpic' and the 'me' macro package in the way to which AT&T 'troff' users
+were accustomed, one would type (or script) a pipeline.
+
+     gpic foo.me | gtbl | gtroff -me -Tutf8 | grotty
+
+   Using 'groff', this pipe can be shortened to an equivalent command.
+
+     groff -p -t -me -T utf8 foo.me
+
+   An even easier way to do this is to use 'grog' to guess the
+preprocessor and macro options and execute the result by using the
+command substitution feature of the shell.
+
+     $(grog -Tutf8 foo.me)
+
+   Each command-line option to a postprocessor must be specified with
+any required leading dashes '-' because 'groff' passes the arguments
+as-is to the postprocessor; this permits arbitrary arguments to be
+transmitted.  For example, to pass a title to the 'gxditview'
+postprocessor, the shell commands
+
+     groff -X -P -title -P 'trial run' mydoc.t
+
+and
+
+     groff -X -Z mydoc.t | gxditview -title 'trial run' -
+
+are equivalent.
+
+&#x1f;
+File: groff.info,  Node: Tutorial for Macro Users,  Next: Major Macro Packages,  Prev: Invoking groff,  Up: Top
+
+3 Tutorial for Macro Users
+**************************
+
+Most users of the 'roff' language employ a macro package to format their
+documents.  Successful macro packages ease the composition process;
+their users need not have mastered the full formatting language, nor
+understand features like diversions, traps, and environments.  This
+chapter aims to familiarize you with basic concepts and mechanisms
+common to many macro packages (like "displays").  If you prefer a
+meticulous and comprehensive presentation, try *note GNU troff
+Reference:: instead.
+
+* Menu:
+
+* Basics::
+* Common Features::
+
+&#x1f;
+File: groff.info,  Node: Basics,  Next: Common Features,  Prev: Tutorial for Macro Users,  Up: Tutorial for Macro Users
+
+3.1 Basics
+==========
+
+Let us first survey some basic concepts necessary to use a macro package
+fruitfully.(1)  (*note Basics-Footnote-1::) References are made
+throughout to more detailed information.
+
+   GNU 'troff' reads an input file prepared by the user and outputs a
+formatted document suitable for publication or framing.  The input
+consists of text, or words to be printed, and embedded commands
+(requests and escape sequences), which tell GNU 'troff' how to format
+the output.  *Note Formatter Instructions::.
+
+   The word argument is used in this chapter to mean a word or number
+that appears on the same line as a request, and which modifies the
+meaning of that request.  For example, the request
+
+     .sp
+
+spaces one line, but
+
+     .sp 4
+
+spaces four lines.  The number 4 is an argument to the 'sp' request,
+which says to space four lines instead of one.  Arguments are separated
+from the request and from each other by spaces (_not_ tabs).  *Note
+Invoking Requests::.
+
+   The primary function of GNU 'troff' is to collect words from input
+lines, fill output lines with those words, adjust the line to the
+right-hand margin by widening spaces, and output the result.  For
+example, the input:
+
+     Now is the time
+     for all good men
+     to come to the aid
+     of their party.
+     Four score and seven
+     years ago, etc.
+
+is read, packed onto output lines, and justified to produce:
+
+       => Now is the time for all good men to come to the aid of
+       => their party.  Four score and seven years ago, etc.
+
+   Sometimes a new output line should be started even though the current
+line is not yet full--for example, at the end of a paragraph.  To do
+this it is possible to force a break, starting a new output line.  Some
+requests cause a break automatically, as do (normally) blank input lines
+and input lines beginning with a space or tab.
+
+   Not all input lines are text lines--words to be formatted.  Some are
+control lines that tell a macro package (or GNU 'troff' directly) how to
+format the text.  Control lines start with a dot ('.') or an apostrophe
+(''') as the first character, and can be followed by a macro call.
+
+   The formatter also does more complex things, such as automatically
+numbering pages, skipping over page boundaries, putting footnotes in the
+correct place, and so forth.
+
+   Here are a few hints for preparing text for input to GNU 'troff'.
+
+   * First, keep the input lines short.  Short input lines are easier to
+     edit, and GNU 'troff' packs words onto longer lines anyhow.
+
+   * In keeping with this, it is helpful to begin a new line after every
+     comma or phrase, since common corrections are to add or delete
+     sentences or phrases.
+
+   * End each sentence with two spaces--or better, start each sentence
+     on a new line.  GNU 'troff' recognizes characters that usually end
+     a sentence, and inserts inter-sentence space accordingly.
+
+   * Do not hyphenate words at the end of lines--GNU 'troff' is smart
+     enough to hyphenate words as needed, but is not smart enough to
+     take hyphens out and join a word back together.  Also, words such
+     as "mother-in-law" should not be broken over a line, since then a
+     space can occur where not wanted, such as "mother- in-law".
+
+   We offer further advice in *note Input Conventions::.
+
+   GNU 'troff' permits alteration of the distance between lines of text.
+This is termed vertical spacing and is expressed in the same units as
+the type size--the point.  The default is 10-point type on 12-point
+spacing.  To get double-spaced text you would set the vertical spacing
+to 24 points.  Some, but not all, macro packages expose a macro or
+register to configure the vertical spacing.
+
+   A number of requests allow you to change the way the output is
+arranged on the page, sometimes called the layout of the output page.
+Most macro packages don't supply macros for performing these (at least
+not without performing other actions besides), as they are such basic
+operations.  The macro packages for writing man pages, 'man' and 'mdoc',
+don't encourage explicit use of these requests at all.
+
+   The request '.sp N' leaves N lines of blank space.  N can be omitted
+(skipping a single line) or can be of the form Ni (for N inches) or Nc
+(for N centimeters).  For example, the input:
+
+     .sp 1.5i
+     My thoughts on the subject
+     .sp
+
+leaves one and a half inches of space, followed by the line "My thoughts
+on the subject", followed by a single blank line (more measurement units
+are available; see *note Measurements::).
+
+   If you seek precision in spacing, be advised when using a macro
+package that it might not honor 'sp' requests as you expect; it can use
+a formatter feature called no-space mode to prevent excess space from
+accumulating.  Macro packages typically offer registers to control
+spacing between paragraphs, before section headings, and around displays
+(discussed below); use these facilities preferentially.  *Note
+Manipulating Spacing::.
+
+   Text lines can be centered by using the 'ce' request.  The line after
+'ce' is centered (horizontally) on the page.  To center more than one
+line, use '.ce N' (where N is the number of lines to center), followed
+by the N lines.  To center many lines without counting them, type:
+
+     .ce 1000
+     lines to center
+     .ce 0
+
+The '.ce 0' request tells GNU 'troff' to center zero more lines, in
+other words, stop centering.
+
+   GNU 'troff' also offers the 'rj' request for right-aligning text.  It
+works analogously to 'ce' and is convenient for setting epigraphs.
+
+   The 'bp' request starts a new page; this necessarily implies an
+ordinary (line) break.
+
+   All of these requests cause a break; that is, they always start a new
+line.  To start a new line without performing any other action, use
+'br'.  If you invoke them with the apostrophe ''', the no-break control
+character, the (initial) break they normally perform is suppressed.
+''br' does nothing.
+
+&#x1f;
+File: groff.info,  Node: Basics-Footnotes,  Up: Basics
+
+   (1) The remainder of this chapter is based on 'Writing Papers with
+nroff using -me' by Eric P. Allman, which is distributed with 'groff' as
+'meintro.me'.
+
+&#x1f;
+File: groff.info,  Node: Common Features,  Prev: Basics,  Up: Tutorial for Macro Users
+
+3.2 Common Features
+===================
+
+GNU 'troff' provides low-level operations for formatting a document.
+Many routine operations are undertaken in nearly all documents that
+require a series of such primitive operations to be performed.  These
+common tasks are grouped into macros, which are then collected into a
+macro package.
+
+   Macro packages come in two varieties: "major" or "full-service" ones
+that manage page layout, and "minor" or "auxiliary" ones that do not,
+instead fulfilling narrow, specific tasks.  Find a list in the
+'groff_tmac(5)' man page.  Type 'man groff_tmac' at the command line to
+view it.
+
+   We survey several capabilities of full-service macro package below.
+Each package employs its own macros to exercise them.  For details,
+consult its man page or, for 'ms', see *note ms::.
+
+* Menu:
+
+* Paragraphs::
+* Sections and Chapters::
+* Headers and Footers::
+* Page Layout Adjustment::
+* Displays and Keeps::
+* Footnotes and Endnotes::
+* Table of Contents::
+* Indexing::
+* Document Formats::
+* Columnation::
+* Font and Size Changes::
+* Predefined Text::
+* Preprocessor Support::
+* Configuration and Customization::
+
+&#x1f;
+File: groff.info,  Node: Paragraphs,  Next: Sections and Chapters,  Prev: Common Features,  Up: Common Features
+
+3.2.1 Paragraphs
+----------------
+
+Paragraphs can be separated and indented in various ways.  Some start
+with a blank line and have a first-line indentation, like most of the
+ones in this manual.  Block paragraphs omit the indentation.
+
+       => Some  men  look  at constitutions with sanctimonious
+       => reverence,  and  deem  them  like  the  ark  of  the
+       => covenant, too sacred to be touched.
+
+We also frequently encounter tagged paragraphs, which begin with a tag
+or label at the left margin and indent the remaining text.
+
+       => one  This  is the first paragraph.  Notice how the
+       =>      first line of the resulting  paragraph  lines
+       =>      up with the other lines in the paragraph.
+
+If the tag is too wide for the indentation, the line is broken.
+
+       => longlabel
+       =>      The  label does not align with the subsequent
+       =>      lines, but they align with each other.
+
+A variation of the tagged paragraph is the itemized or enumerated
+paragraph, which might use punctuation or a digit for a tag,
+respectively.  These are frequently used to construct lists.
+
+       => o    This  list  item  starts with a bullet.  When
+       =>      producing output for a device using the ASCII
+       =>      character set, an 'o' is formatted instead.
+
+Often, use of the same macro without a tag continues such a discussion.
+
+       => -xyz  This option is recognized but ignored.
+       =>
+       =>       It had a security hole that we don't discuss.
+
+&#x1f;
+File: groff.info,  Node: Sections and Chapters,  Next: Headers and Footers,  Prev: Paragraphs,  Up: Common Features
+
+3.2.2 Sections and Chapters
+---------------------------
+
+The simplest kind of section heading is unnumbered, set in a bold or
+italic style, and occupies a line by itself.  Others possess
+automatically numbered multi-level headings and/or different typeface
+styles or sizes at different levels.  More sophisticated macro packages
+supply macros for designating chapters and appendices.
+
+&#x1f;
+File: groff.info,  Node: Headers and Footers,  Next: Page Layout Adjustment,  Prev: Sections and Chapters,  Up: Common Features
+
+3.2.3 Headers and Footers
+-------------------------
+
+Headers and footers occupy the top and bottom of each page,
+respectively, and contain data like the page number and the article or
+chapter title.  Their appearance is not affected by the running text.
+Some packages allow for different titles on even- and odd-numbered pages
+(for printed, bound material).
+
+   Headers and footers are together called titles, and comprise three
+parts: left-aligned, centered, and right-aligned.  A '%' character
+appearing anywhere in a title is automatically replaced by the page
+number.  *Note Page Layout::.
+
+&#x1f;
+File: groff.info,  Node: Page Layout Adjustment,  Next: Displays and Keeps,  Prev: Headers and Footers,  Up: Common Features
+
+3.2.4 Page Layout
+-----------------
+
+Most macro packages let the user specify the size of the page margins.
+The top and bottom margins are typically handled differently than the
+left and right margins; the latter two are derived from the page offset,
+indentation, and line length.  *Note Line Layout::.  Commonly, packages
+support registers to tune these values.
+
+&#x1f;
+File: groff.info,  Node: Displays and Keeps,  Next: Footnotes and Endnotes,  Prev: Page Layout Adjustment,  Up: Common Features
+
+3.2.5 Displays and Keeps
+------------------------
+
+Displays are sections of text set off from the surrounding material
+(typically paragraphs), often differing in indentation, and/or spacing.
+Tables, block quotations, and figures are displayed.  Equations and code
+examples, when not much shorter than an output line, often are.  Lists
+may or may not be.  Packages for setting man pages support example
+displays but not keeps.
+
+   A keep is a group of output lines, often a display, that is formatted
+on a single page if possible; it causes a page break to happen early so
+as to not interrupt the kept material.
+
+   Floating keeps can move, or "float", relative to the text around them
+in the input.  They are useful for displays that are captioned and
+referred to by name, as with "See figure 3".  Depending on the package,
+a floating keep appears at the bottom of the current page if it fits,
+and at the top of the next otherwise.  Alternatively, floating keeps
+might be deferred to the end of a section.  Using a floating keep can
+avoid the large vertical spaces that may precede a tall keep of the
+ordinary sort when it won't fit on the page.
+
+&#x1f;
+File: groff.info,  Node: Footnotes and Endnotes,  Next: Table of Contents,  Prev: Displays and Keeps,  Up: Common Features
+
+3.2.6 Footnotes and Endnotes
+----------------------------
+
+Footnotes and endnotes are forms of delayed formatting.  They are
+recorded at their points of relevance in the input, but not formatted
+there.  Instead, a mark cues the reader to check the "foot", or bottom,
+of the current page, or in the case of endnotes, an annotation list
+later in the document.  Macro packages that support these features also
+supply a means of automatically numbering either type of annotation.
+
+&#x1f;
+File: groff.info,  Node: Table of Contents,  Next: Indexing,  Prev: Footnotes and Endnotes,  Up: Common Features
+
+3.2.7 Table of Contents
+-----------------------
+
+A package may handle a table of contents by directing section heading
+macros to save section heading text and the page number where it occurs
+for use in a later entry for a table of contents.  It writes the
+collected entries at the end of the document, once all are known, upon
+request.  A row of dots (a leader) bridges the text on the left with its
+location on the right.  Other collections might work in this manner,
+providing lists of figures or tables.
+
+   A table of contents is often found at the end of a GNU 'troff'
+document because the formatter processes the document in a single pass.
+The 'gropdf' output driver supports a PDF feature that relocates pages
+at the time the document is rendered; see the 'gropdf(1)' man page.
+Type 'man gropdf' at the command line to view it.
+
+&#x1f;
+File: groff.info,  Node: Indexing,  Next: Document Formats,  Prev: Table of Contents,  Up: Common Features
+
+3.2.8 Indexing
+--------------
+
+An index is similar to a table of contents, in that entry labels and
+locations must be collected, but poses a greater challenge because it
+needs to be sorted before it is output.  Here, processing the document
+in multiple passes is inescapable, and tools like the 'makeindex'
+program are necessary.
+
+&#x1f;
+File: groff.info,  Node: Document Formats,  Next: Columnation,  Prev: Indexing,  Up: Common Features
+
+3.2.9 Document Formats
+----------------------
+
+Some macro packages supply stock configurations of certain documents,
+like business letters and memoranda.  These often also have provision
+for a cover sheet, which may be rigid in its format.  With these
+features, it is even more important to use the package's macros in
+preference to the formatter requests presented earlier, where possible.
+
+&#x1f;
+File: groff.info,  Node: Columnation,  Next: Font and Size Changes,  Prev: Document Formats,  Up: Common Features
+
+3.2.10 Columnation
+------------------
+
+Macro packages apart from 'man' and 'mdoc' for man page formatting offer
+a facility for setting multiple columns on the page.
+
+&#x1f;
+File: groff.info,  Node: Font and Size Changes,  Next: Predefined Text,  Prev: Columnation,  Up: Common Features
+
+3.2.11 Font and Size Changes
+----------------------------
+
+The formatter's requests and escape sequences for setting the typeface
+and size are not always intuitive, so all macro packages provide macros
+to make these operations simpler.  They also make it more convenient to
+change typefaces in the middle of a word and can handle italic
+corrections automatically.  *Note Italic Corrections::.
+
+&#x1f;
+File: groff.info,  Node: Predefined Text,  Next: Preprocessor Support,  Prev: Font and Size Changes,  Up: Common Features
+
+3.2.12 Predefined Text
+----------------------
+
+Most macro packages supply predefined strings to set prepared text like
+the date, or to perform operations like super- and subscripting.
+
+&#x1f;
+File: groff.info,  Node: Preprocessor Support,  Next: Configuration and Customization,  Prev: Predefined Text,  Up: Common Features
+
+3.2.13 Preprocessor Support
+---------------------------
+
+All macro packages provide support for various preprocessors and may
+extend their functionality by defining macros to set their contents in
+displays.  Examples include 'TS' and 'TE' for 'gtbl', 'EQ' and 'EN' for
+'geqn', and 'PS' and 'PE' for 'gpic'.
+
+&#x1f;
+File: groff.info,  Node: Configuration and Customization,  Prev: Preprocessor Support,  Up: Common Features
+
+3.2.14 Configuration and Customization
+--------------------------------------
+
+Packages provide means of customizing many of the details of how the
+package behaves.  These range from setting the default type size to
+changing the appearance of section headers.
+
+&#x1f;
+File: groff.info,  Node: Major Macro Packages,  Next: GNU troff Reference,  Prev: Tutorial for Macro Users,  Up: Top
+
+4 Macro Packages
+****************
+
+This chapter surveys the "major" macro packages that come with 'groff'.
+One, 'ms', is presented in detail.
+
+   Major macro packages are also sometimes described as "full-service"
+due to the breadth of features they provide and because more than one
+cannot be used by the same document; for example
+
+     groff -m man foo.man -m ms bar.doc
+
+doesn't work.  Option arguments are processed before non-option
+arguments; the above (failing) sample is thus reordered to
+
+     groff -m man -m ms foo.man bar.doc
+
+   Many auxiliary, or "minor", macro packages are also available.  They
+may in general be used with any full-service macro package and handle a
+variety of tasks from character encoding selection, to language
+localization, to inlining of raster images.  See the 'groff_tmac(5)' man
+page for a list.  Type 'man groff_tmac' at the command line to view it.
+
+* Menu:
+
+* man::
+* mdoc::
+* me::
+* mm::
+* mom::
+* ms::
+
+&#x1f;
+File: groff.info,  Node: man,  Next: mdoc,  Prev: Major Macro Packages,  Up: Major Macro Packages
+
+4.1 'man'
+=========
+
+The 'man' macro package is the most widely used and probably the most
+important ever developed for 'troff'.  It is easy to use, and a vast
+majority of manual pages ("man pages") are written in it.
+
+   'groff''s implementation is documented in the 'groff_man(7)' man
+page.  Type 'man groff_man' at the command line to view it.
+
+* Menu:
+
+* Optional man extensions::
+
+&#x1f;
+File: groff.info,  Node: Optional man extensions,  Up: man
+
+4.1.1 Optional 'man' extensions
+-------------------------------
+
+Use the file 'man.local' for local extensions to the 'man' macros or for
+style changes.
+
+Custom headers and footers
+..........................
+
+In 'groff' versions 1.18.2 and later, you can specify custom headers and
+footers by redefining the following macros in 'man.local'.
+
+ -- Macro: .PT
+     Control the content of the headers.  Normally, the header prints
+     the command name and section number on either side, and the
+     optional fifth argument to 'TH' in the center.
+
+ -- Macro: .BT
+     Control the content of the footers.  Normally, the footer prints
+     the page number and the third and fourth arguments to 'TH'.
+
+     Use the 'FT' register to specify the footer position.  The default
+     is -0.5i.
+
+Ultrix-specific man macros
+..........................
+
+The 'groff' source distribution includes a file named 'man.ultrix',
+containing macros compatible with the Ultrix variant of 'man'.  Copy
+this file into 'man.local' (or use the 'mso' request to load it) to
+enable the following macros.
+
+ -- Macro: .CT key
+     Print '<CTRL/KEY>'.
+
+ -- Macro: .CW
+     Print subsequent text using a "constant-width" (monospaced)
+     typeface (Courier roman).
+
+ -- Macro: .Ds
+     Begin a non-filled display.
+
+ -- Macro: .De
+     End a non-filled display started with 'Ds'.
+
+ -- Macro: .EX indent
+     Begin a non-filled display using a monospaced typeface (Courier
+     roman).  Use the optional INDENT argument to indent the display.
+
+ -- Macro: .EE
+     End a non-filled display started with 'EX'.
+
+ -- Macro: .G text
+     Set TEXT in Helvetica.  If no text is present on the line where the
+     macro is called, then the text of the next line appears in
+     Helvetica.
+
+ -- Macro: .GL text
+     Set TEXT in Helvetica oblique.  If no text is present on the line
+     where the macro is called, then the text of the next line appears
+     in Helvetica Oblique.
+
+ -- Macro: .HB text
+     Set TEXT in Helvetica bold.  If no text is present on the line
+     where the macro is called, then all text up to the next 'HB'
+     appears in Helvetica bold.
+
+ -- Macro: .TB text
+     Identical to 'HB'.
+
+ -- Macro: .MS title sect punct
+     Set a man page reference in Ultrix format.  The TITLE is in Courier
+     instead of italic.  Optional punctuation follows the section number
+     without an intervening space.
+
+ -- Macro: .NT C title
+     Begin a note.  Print the optional title, or the word "Note",
+     centered on the page.  Text following the macro makes up the body
+     of the note, and is indented on both sides.  If the first argument
+     is 'C', the body of the note is printed centered (the second
+     argument replaces the word "Note" if specified).
+
+ -- Macro: .NE
+     End a note begun with 'NT'.
+
+ -- Macro: .PN path punct
+     Set the path name in a monospaced typeface (Courier roman),
+     followed by optional punctuation.
+
+ -- Macro: .Pn punct path punct
+     If called with two arguments, identical to 'PN'.  If called with
+     three arguments, set the second argument in a monospaced typeface
+     (Courier roman), bracketed by the first and third arguments in the
+     current font.
+
+ -- Macro: .R
+     Switch to roman font and turn off any underlining in effect.
+
+ -- Macro: .RN
+     Print the string '<RETURN>'.
+
+ -- Macro: .VS 4
+     Start printing a change bar in the margin if the number '4' is
+     specified.  Otherwise, this macro does nothing.
+
+ -- Macro: .VE
+     End printing the change bar begun by 'VS'.
+
+Simple example
+..............
+
+The following example 'man.local' file alters the 'SH' macro to add some
+extra vertical space before printing the heading.  Headings are printed
+in Helvetica bold.
+
+     .\" Make the heading fonts Helvetica
+     .ds HF HB
+     .
+     .\" Put more space in front of headings.
+     .rn SH SH-orig
+     .de SH
+     .  if t .sp (u;\\nPD*2)
+     .  SH-orig \\$*
+     ..
+
+&#x1f;
+File: groff.info,  Node: mdoc,  Next: me,  Prev: man,  Up: Major Macro Packages
+
+4.2 'mdoc'
+==========
+
+'groff''s implementation of the BSD 'doc' package for man pages is
+documented in the 'groff_mdoc(7)' man page.  Type 'man groff_mdoc' at
+the command line to view it.
+
+&#x1f;
+File: groff.info,  Node: me,  Next: mm,  Prev: mdoc,  Up: Major Macro Packages
+
+4.3 'me'
+========
+
+'groff''s implementation of the BSD 'me' macro package is documented
+using itself.  A tutorial, 'meintro.me', and reference, 'meref.me', are
+available in 'groff''s documentation directory.  A 'groff_me(7)' man
+page is also available and identifies the installation path for these
+documents.  Type 'man groff_me' at the command line to view it.
+
+   A French translation of the tutorial is available as 'meintro_fr.me'
+and installed parallel to the English version.
+
+&#x1f;
+File: groff.info,  Node: mm,  Next: mom,  Prev: me,  Up: Major Macro Packages
+
+4.4 'mm'
+========
+
+'groff''s implementation of the AT&T memorandum macro package is
+documented in the 'groff_mm(7)' man page.  Type 'man groff_mm' at the
+command line) to view it.
+
+   A Swedish localization of 'mm' is also available; see
+'groff_mmse(7)'.
+
+&#x1f;
+File: groff.info,  Node: mom,  Next: ms,  Prev: mm,  Up: Major Macro Packages
+
+4.5 'mom'
+=========
+
+The main documentation files for the 'mom' macros are in HTML format.
+Additional, useful documentation is in PDF format.  See the 'groff(1)'
+man page, section "Installation Directories", for their location.
+
+   * 'toc.html' Entry point to the full mom manual.
+
+   * 'macrolist.html' Hyperlinked index of macros with brief
+     descriptions, arranged by category.
+
+   * 'mom-pdf.pdf' PDF features and usage.
+
+   The mom macros are in active development between 'groff' releases.
+The most recent version, along with up-to-date documentation, is
+available at <http://www.schaffter.ca/mom/mom-05.html>.
+
+   The 'groff_mom(7)' man page (type 'man groff_mom' at the command
+line) contains a partial list of available macros, however their usage
+is best understood by consulting the HTML documentation.
+
+&#x1f;
+File: groff.info,  Node: ms,  Prev: mom,  Up: Major Macro Packages
+
+4.6 'ms'
+========
+
+The 'ms' ("manuscript") package is suitable for the preparation of
+letters, memoranda, reports, and books.  These 'groff' macros feature
+cover page and table of contents generation, automatically numbered
+headings, several paragraph styles, a variety of text styling options,
+footnotes, and multi-column page layouts.  'ms' supports the 'tbl',
+'eqn', 'pic', and 'refer' preprocessors for inclusion of tables,
+mathematical equations, diagrams, and standardized bibliographic
+citations.  This implementation is mostly compatible with the documented
+interface and behavior of AT&T Unix Version 7 'ms'.  Many extensions
+from 4.2BSD (Berkeley) and Tenth Edition Research Unix have been
+recreated.
+
+* Menu:
+
+* ms Introduction::
+* ms Document Structure::
+* ms Document Control Settings::
+* ms Document Description Macros::
+* ms Body Text::
+* ms Page Layout::
+* Differences from AT&T ms::
+* ms Legacy Features::
+* ms Naming Conventions::
+
+&#x1f;
+File: groff.info,  Node: ms Introduction,  Next: ms Document Structure,  Prev: ms,  Up: ms
+
+4.6.1 Introduction
+------------------
+
+The 'ms' macros are the oldest surviving package for 'roff' systems.(1)
+(*note ms Introduction-Footnote-1::) While the 'man' package was
+designed for brief reference documents, the 'ms' macros are also
+suitable for longer works intended for printing and possible
+publication.
+
+* Menu:
+
+* ms basic information::
+
+&#x1f;
+File: groff.info,  Node: ms Introduction-Footnotes,  Up: ms Introduction
+
+   (1) While manual _pages_ are older, early ones used macros supplanted
+by the 'man' package of Seventh Edition Unix (1979).  'ms' shipped with
+Sixth Edition (1975) and was documented by Mike Lesk in a Bell Labs
+internal memorandum.
+
+&#x1f;
+File: groff.info,  Node: ms basic information,  Next: ms Document Structure,  Prev: ms Introduction,  Up: ms Introduction
+
+4.6.1.1 Basic information
+.........................
+
+'ms' documents are plain text files; prepare them with your preferred
+text editor.  If you're in a hurry to start, know that 'ms' needs one of
+its macros called at the beginning of a document so that it can
+initialize.  A "macro" is a formatting instruction to 'ms'.  Put a macro
+call on a line by itself.  Use '.PP' if you want your paragraph's first
+line to be indented, or '.LP' if you don't.
+
+   After that, start typing normally.  It is a good practice to start
+each sentence on a new line, or to put two spaces after sentence-ending
+punctuation, so that the formatter knows where the sentence boundaries
+are.  You can separate paragraphs with further paragraphing macros, or
+with blank lines, and you can indent with tabs.  When you need one of
+the features mentioned earlier (*note ms::), return to this part of the
+manual.
+
+   Format the document with the 'groff' command.  'nroff' can be useful
+for previewing.
+
+     $ editor radical.ms
+     $ nroff -ww -z -ms radical.ms # check for errors
+     $ nroff -ms radical.ms | less -R
+     $ groff -T ps -ms radical.ms > radical.ps
+     $ see radical.ps
+
+   Our 'radical.ms' document might look like this.
+
+     .LP
+     Radical novelties are so disturbing that they tend to be
+     suppressed or ignored, to the extent that even the
+     possibility of their existence in general is more often
+     denied than admitted.
+
+     ->That's what Dijkstra said, anyway.
+
+   'ms' exposes many aspects of document layout to user control via
+'groff''s "registers" and "strings", which store numbers and text,
+respectively.  Measurements in 'groff' are expressed with a suffix
+called a "scaling unit".
+
+'i'
+     inches
+
+'c'
+     centimeters
+
+'p'
+     points (1/72 inch)
+
+'P'
+     picas (1/6 inch)
+
+'v'
+     vees; current vertical spacing
+
+'m'
+     ems; width of an "M" in the current font
+
+'n'
+     ens; one-half em
+
+   Set registers with the 'nr' request and strings with the 'ds'
+request.  "Requests" are like macro calls; they go on lines by
+themselves and start with the "control character", a dot ('.').  The
+difference is that they directly instruct the formatter program, rather
+than the macro package.  We'll discuss a few as applicable.  It is wise
+to specify a scaling unit when setting any register that represents a
+length, size, or distance.
+
+     .nr PS 10.5p \" Use 10.5-point type.
+     .ds FAM P    \" Use Palatino font family.
+
+In the foregoing, we see that '\"' begins a comment.  This is an example
+of an "escape sequence", the other kind of formatting instruction.
+Escape sequences can appear anywhere.  They begin with the escape
+character ('\') and are followed by at least one more character.  'ms'
+documents tend to use only a few of 'groff''s many requests and escape
+sequences; see *note Request Index:: and *note Escape Sequence Index::
+or the 'groff(7)' man page for complete lists.
+
+'\"'
+     Begin comment; ignore remainder of line.
+
+'\nREG'
+     Interpolate value of register REG.
+
+'\*STR'
+     Interpolate contents of string STR.
+
+'\*S'
+     abbreviation of '\*S'; the name S must be only one character
+
+'\CHAR'
+     Interpolate glyph of special character named CHAR.
+
+'\&'
+     dummy character
+
+'\~'
+     Insert an unbreakable space that is adjustable like a normal space.
+
+'\|'
+     Move horizontally by one-sixth em ("thin space").
+
+   Prefix any words that start with a dot '.' or neutral apostrophe '''
+with '\&' if they are at the beginning of an input line (or might become
+that way in editing) to prevent them from being interpreted as macro
+calls or requests.  Suffix '.', '?', and '!' with '\&' when needed to
+cancel end-of-sentence detection.
+
+     My exposure was \&.5 to \&.6 Sv of neutrons, said Dr.\&
+     Wallace after the criticality incident.
+
+&#x1f;
+File: groff.info,  Node: ms Document Structure,  Next: ms Document Control Settings,  Prev: ms Introduction,  Up: ms
+
+4.6.2 Document Structure
+------------------------
+
+The 'ms' macro package expects a certain amount of structure: a
+well-formed document contains at least one paragraphing or heading macro
+call.  Longer documents have a structure as follows.
+
+*Document type*
+     Calling the 'RP' macro at the beginning of your document puts the
+     document description (see below) on a cover page.  Otherwise, 'ms'
+     places the information (if any) on the first page, followed
+     immediately by the body text.  Some document types found in other
+     'ms' implementations are specific to AT&T or Berkeley, and are not
+     supported by 'groff' 'ms'.
+
+*Format and layout*
+     By setting registers and strings, you can configure your document's
+     typeface, margins, spacing, headers and footers, and footnote
+     arrangement.  *Note ms Document Control Settings::.
+
+*Document description*
+     A document description consists of any of: a title, one or more
+     authors' names and affiliated institutions, an abstract, and a date
+     or other identifier.  *Note ms Document Description Macros::.
+
+*Body text*
+     The main matter of your document follows its description (if any).
+     'ms' supports highly structured text consisting of paragraphs
+     interspersed with multi-level headings (chapters, sections,
+     subsections, and so forth) and augmented by lists, footnotes,
+     tables, diagrams, and similar material.  *Note ms Body Text::.
+
+*Tables of contents*
+     Macros enable the collection of entries for a table of contents (or
+     index) as the material they discuss appears in the document.  You
+     then call a macro to emit the table of contents at the end of your
+     document.  The table of contents must necessarily follow the rest
+     of the text since GNU 'troff' is a single-pass formatter; it thus
+     cannot determine the page number of a division of the text until it
+     has been set and output.  Since 'ms' was designed for the
+     production of hard copy, the traditional procedure was to manually
+     relocate the pages containing the table of contents between the
+     cover page and the body text.  Today, page resequencing is more
+     often done in the digital domain.  An index works similarly, but
+     because it typically needs to be sorted after collection, its
+     preparation requires separate processing.
+
+&#x1f;
+File: groff.info,  Node: ms Document Control Settings,  Next: ms Document Description Macros,  Prev: ms Document Structure,  Up: ms
+
+4.6.3 Document Control Settings
+-------------------------------
+
+'ms' exposes many aspects of document layout to user control via 'groff'
+requests.  To use them, you must understand how to define registers and
+strings.
+
+ -- Request: .nr reg value
+     Set register REG to VALUE.  If REG doesn't exist, GNU 'troff'
+     creates it.
+
+ -- Request: .ds name contents
+     Set string NAME to CONTENTS.
+
+   A list of document control registers and strings follows.  For any
+parameter whose default is unsatisfactory, define its register or string
+before calling any 'ms' macro other than 'RP'.
+
+Margin settings
+...............
+
+ -- Register: \nPO
+     Defines the page offset (i.e., the left margin).
+
+     Effective: next page.
+
+     Default: Varies by output device and paper format; 1i is used for
+     typesetters using U.S. letter paper, and zero for terminals.  *Note
+     Paper Format::.
+
+ -- Register: \nLL
+     Defines the line length (i.e., the width of the body text).
+
+     Effective: next paragraph.
+
+     Default: Varies by output device and paper format; 6.5i is used for
+     typesetters using U.S. letter paper (*note Paper Format::) and 65n
+     on terminals.
+
+ -- Register: \nLT
+     Defines the title line length (i.e., the header and footer width).
+     This is usually the same as 'LL', but need not be.
+
+     Effective: next paragraph.
+
+     Default: Varies by output device and paper format; 6.5i is used for
+     typesetters using U.S. letter paper (*note Paper Format::) and 65n
+     on terminals.
+
+ -- Register: \nHM
+     Defines the header margin height at the top of the page.
+
+     Effective: next page.
+
+     Default: 1i.
+
+ -- Register: \nFM
+     Defines the footer margin height at the bottom of the page.
+
+     Effective: next page.
+
+     Default: 1i.
+
+Titles (headers, footers)
+.........................
+
+ -- String: \*LH
+     Defines the text displayed in the left header position.
+
+     Effective: next header.
+
+     Default: empty.
+
+ -- String: \*CH
+     Defines the text displayed in the center header position.
+
+     Effective: next header.
+
+     Default: '-\n%-'.
+
+ -- String: \*RH
+     Defines the text displayed in the right header position.
+
+     Effective: next header.
+
+     Default: empty.
+
+ -- String: \*LF
+     Defines the text displayed in the left footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+ -- String: \*CF
+     Defines the text displayed in the center footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+ -- String: \*RF
+     Defines the text displayed in the right footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+Text settings
+.............
+
+ -- Register: \nPS
+     Defines the type size of the body text.
+
+     Effective: next paragraph.
+
+     Default: 10p.
+
+ -- Register: \nVS
+     Defines the vertical spacing (type size plus leading).
+
+     Effective: next paragraph.
+
+     Default: 12p.
+
+ -- Register: \nHY
+     Defines the automatic hyphenation mode used with the 'hy' request.
+     Setting 'HY' to 0 is equivalent to using the 'nh' request.  This is
+     a Tenth Edition Research Unix extension.
+
+     Effective: next paragraph.
+
+     Default: 6.
+
+ -- String: \*FAM
+     Defines the font family used to typeset the document.  This is a
+     GNU extension.
+
+     Effective: next paragraph.
+
+     Default: defined by the output device; often 'T' (*note ms Body
+     Text::)
+
+Paragraph settings
+..................
+
+ -- Register: \nPI
+     Defines the indentation amount used by the 'PP', 'IP' (unless
+     overridden by an optional argument), 'XP', and 'RS' macros.
+
+     Effective: next paragraph.
+
+     Default: 5n.
+
+ -- Register: \nPD
+     Defines the space between paragraphs.
+
+     Effective: next paragraph.
+
+     Default: 0.3v (1v on low-resolution devices).
+
+ -- Register: \nQI
+     Defines the indentation amount used on both sides of a paragraph
+     set with the 'QP' or between the 'QS' and 'QE' macros.
+
+     Effective: next paragraph.
+
+     Default: 5n.
+
+ -- Register: \nPORPHANS
+     Defines the minimum number of initial lines of any paragraph that
+     must be kept together to avoid isolated lines at the bottom of a
+     page.  If a new paragraph is started close to the bottom of a page,
+     and there is insufficient space to accommodate 'PORPHANS' lines
+     before an automatic page break, then a page break is forced before
+     the start of the paragraph.  This is a GNU extension.
+
+     Effective: next paragraph.
+
+     Default: 1.
+
+Heading settings
+................
+
+ -- Register: \nPSINCR
+     Defines an increment in type size to be applied to a heading at a
+     lesser depth than that specified in 'GROWPS'.  The value of
+     'PSINCR' should be specified in points with the p scaling unit and
+     may include a fractional component; for example, '.nr PSINCR 1.5p'
+     sets a type size increment of 1.5p.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: 1p.
+
+ -- Register: \nGROWPS
+     Defines the heading depth above which the type size increment set
+     by 'PSINCR' becomes effective.  For each heading depth less than
+     the value of 'GROWPS', the type size is increased by 'PSINCR'.
+     Setting 'GROWPS' to any value less than 2 disables the incremental
+     heading size feature.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: 0.
+
+ -- Register: \nHORPHANS
+     Defines the minimum number of lines of an immediately succeeding
+     paragraph that should be kept together with any heading introduced
+     by the 'NH' or 'SH' macros.  If a heading is placed close to the
+     bottom of a page, and there is insufficient space to accommodate
+     both the heading and at least 'HORPHANS' lines of the following
+     paragraph, before an automatic page break, then the page break is
+     forced before the heading.  This is a GNU extension.
+
+     Effective: next paragraph.
+
+     Default: 1.
+
+ -- String: \*SN-STYLE
+     Defines the style used to print numbered headings.  *Note Headings
+     in ms::.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: alias of 'SN-DOT'
+
+Footnote settings
+.................
+
+ -- Register: \nFI
+     Defines the footnote indentation.  This is a Berkeley extension.
+
+     Effective: next footnote.
+
+     Default: 2n.
+
+ -- Register: \nFF
+     Defines the format of automatically numbered footnotes, and those
+     for which the 'FS' request is given a marker argument, at the
+     bottom of a column or page.  This is a Berkeley extension.
+     '0'
+          Set an automatic number(1) (*note ms Document Control
+          Settings-Footnote-1::) as a superscript (on typesetter
+          devices) or surrounded by square brackets (on terminals).  The
+          footnote paragraph is indented as with 'PP' if there is an
+          'FS' argument or an automatic number, and as with 'LP'
+          otherwise.  This is the default.
+
+     '1'
+          As '0', but set the marker as regular text and follow an
+          automatic number with a period.
+
+     '2'
+          As '1', but without indentation (like 'LP').
+
+     '3'
+          As '1', but set the footnote paragraph with the marker hanging
+          (like 'IP').
+
+     Effective: next footnote.
+
+     Default: 0.
+
+ -- Register: \nFPS
+     Defines the footnote type size.
+
+     Effective: next footnote.
+
+     Default: '\nPS - 2p'.
+
+ -- Register: \nFVS
+     Defines the footnote vertical spacing.
+
+     Effective: next footnote.
+
+     Default: '\nFPS + 2p'.
+
+ -- Register: \nFPD
+     Defines the footnote paragraph spacing.  This is a GNU extension.
+
+     Effective: next footnote.
+
+     Default: '\nPD / 2'.
+
+ -- String: \*FR
+     Defines the ratio of the footnote line length to the current line
+     length.  This is a GNU extension.
+
+     Effective: next footnote in single-column arrangements, next page
+     otherwise.
+
+     Default: '11/12'.
+
+Display settings
+................
+
+ -- Register: \nDD
+     Sets the display distance--the vertical spacing before and after a
+     display, a 'tbl' table, an 'eqn' equation, or a 'pic' image.  This
+     is a Berkeley extension.
+
+     Effective: next display boundary.
+
+     Default: 0.5v (1v on low-resolution devices).
+
+ -- Register: \nDI
+     Sets the default amount by which to indent a display started with
+     'DS' and 'ID' without arguments, to '.DS I' without an indentation
+     argument, and to equations set with '.EQ I'.  This is a GNU
+     extension.
+
+     Effective: next indented display.
+
+     Default: 0.5i.
+
+Other settings
+..............
+
+ -- Register: \nMINGW
+     Defines the default minimum width between columns in a multi-column
+     document.  This is a GNU extension.
+
+     Effective: next page.
+
+     Default: 2n.
+
+ -- Register: \nTC-MARGIN
+     Defines the width of the field in which page numbers are set in a
+     table of contents entry; the right margin thus moves inboard by
+     this amount.  This is a GNU extension.
+
+     Effective: next 'PX' call.
+
+     Default: '\w'000''
+
+&#x1f;
+File: groff.info,  Node: ms Document Control Settings-Footnotes,  Up: ms Document Control Settings
+
+   (1) defined in *note ms Footnotes::
+
+&#x1f;
+File: groff.info,  Node: ms Document Description Macros,  Next: ms Body Text,  Prev: ms Document Control Settings,  Up: ms
+
+4.6.4 Document Description Macros
+---------------------------------
+
+Only the simplest document lacks a title.(1)  (*note ms Document
+Description Macros-Footnote-1::) As its level of sophistication (or
+complexity) increases, it tends to acquire a date of revision,
+explicitly identified authors, sponsoring institutions for authors, and,
+at the rarefied heights, an abstract of its content.  Define these data
+by calling the macros below in the order shown; 'DA' or 'ND' can be
+called to set the document date (or other identifier) at any time before
+(a) the abstract, if present, or (b) its information is required in a
+header or footer.  Use of these macros is optional, except that 'TL' is
+mandatory if any of 'RP', 'AU', 'AI', or 'AB' is called, and 'AE' is
+mandatory if 'AB' is called.
+
+ -- Macro: .RP no-repeat-info no-renumber
+     Use the "report" (AT&T: "released paper") format for your document,
+     creating a separate cover page.  The default arrangement is to
+     place most of the document description (title, author names and
+     institutions, and abstract, but not the date) at the top of the
+     first page.  If the optional 'no-repeat-info' argument is given,
+     'ms' produces a cover page but does not repeat any of its
+     information subsequently (but see the 'DA' macro below regarding
+     the date).  Normally, 'RP' sets the page number following the cover
+     page to 1.  Specifying the optional 'no-renumber' argument
+     suppresses this alteration.  Optional arguments can occur in any
+     order.  'no' is recognized as a synonym of 'no-repeat-info' for
+     'AT&T' compatibility.
+
+ -- Macro: .TL
+     Specify the document title.  'ms' collects text on input lines
+     following this call into the title until reaching 'AU', 'AB', or a
+     heading or paragraphing macro call.
+
+ -- Macro: .AU
+     Specify an author's name.  'ms' collects text on input lines
+     following this call into the author's name until reaching 'AI',
+     'AB', another 'AU', or a heading or paragraphing macro call.  Call
+     it repeatedly to specify multiple authors.
+
+ -- Macro: .AI
+     Specify the preceding author's institution.  An 'AU' call is
+     usefully followed by at most one 'AI' call; if there are more, the
+     last 'AI' call controls.  'ms' collects text on input lines
+     following this call into the author's institution until reaching
+     'AU', 'AB', or a heading or paragraphing macro call.
+
+ -- Macro: .DA x ...
+     Typeset the current date, or any arguments X, in the center footer,
+     and, if 'RP' is also called, left-aligned at the end of the
+     description information on the cover page.
+
+ -- Macro: .ND x ...
+     Typeset the current date, or any arguments X, if 'RP' is also
+     called, left-aligned at the end of the document description on the
+     cover page.  This is 'groff' 'ms''s default.
+
+ -- Macro: .AB no
+     Begin the abstract.  'ms' collects text on input lines following
+     this call into the abstract until reaching an 'AE' call.  By
+     default, 'ms' places the word "ABSTRACT" centered and in italics
+     above the text of the abstract.  The optional argument 'no'
+     suppresses this heading.
+
+ -- Macro: .AE
+     End the abstract.
+
+   An example document description, using a cover page, follows.
+
+     .RP
+     .TL
+     The Inevitability of Code Bloat
+     in Commercial and Free Software
+     .AU
+     J.\& Random Luser
+     .AI
+     University of West Bumblefuzz
+     .AB
+     This report examines the long-term growth of the code
+     bases in two large,
+     popular software packages;
+     the free Emacs and the commercial Microsoft Word.
+     While differences appear in the type or order of
+     features added,
+     due to the different methodologies used,
+     the results are the same in the end.
+     .PP
+     The free software approach is shown to be superior in
+     that while free software can become as bloated as
+     commercial offerings,
+     free software tends to have fewer serious bugs and the
+     added features are more in line with user demand.
+     .AE
+
+     ...the rest of the paper...
+
+&#x1f;
+File: groff.info,  Node: ms Document Description Macros-Footnotes,  Up: ms Document Description Macros
+
+   (1) Distinguish a document title from "titles", which are what 'roff'
+systems call headers and footers collectively.
+
+&#x1f;
+File: groff.info,  Node: ms Body Text,  Next: ms Page Layout,  Prev: ms Document Description Macros,  Up: ms
+
+4.6.5 Body Text
+---------------
+
+A variety of macros, registers, and strings can be used to structure and
+style the body of your document.  They organize your text into
+paragraphs, headings, footnotes, and inclusions of material such as
+tables and figures.
+
+* Menu:
+
+* Text settings in ms::
+* Typographical symbols in ms::
+* Paragraphs in ms::
+* Headings in ms::
+* Typeface and decoration::
+* Lists in ms::
+* Indented regions in ms::
+* ms keeps and displays::
+* ms Insertions::
+* ms Footnotes::
+* ms language and localization::
+
+&#x1f;
+File: groff.info,  Node: Text settings in ms,  Next: Typographical symbols in ms,  Prev: ms Body Text,  Up: ms Body Text
+
+4.6.5.1 Text settings
+.....................
+
+The 'FAM' string, a GNU extension, sets the font family for body text;
+the default is 'T'.  The 'PS' and 'VS' registers set the type size and
+vertical spacing (distance between text baselines), respectively.  The
+font family and type size are ignored on terminal devices.  Setting
+these parameters before the first call of a heading, paragraphing, or
+(non-date) document description macro also applies them to headers,
+footers, and (for 'FAM') footnotes.
+
+   Which font families are available depends on the output device; as a
+convention, 'T' selects a serif family ("Times"), 'H' a sans-serif
+family ("Helvetica"), and 'C' a monospaced family ("Courier").  The man
+page for the output driver documents its font repertoire.  Consult the
+'groff(1)' man page for lists of available output devices and their
+drivers.
+
+   The hyphenation mode (as used by the 'hy' request) is set from the
+'HY' register.  Setting 'HY' to '0' is equivalent to using the 'nh'
+request.  This is a Tenth Edition Research Unix extension.
+
+&#x1f;
+File: groff.info,  Node: Typographical symbols in ms,  Next: Paragraphs in ms,  Prev: Text settings in ms,  Up: ms Body Text
+
+4.6.5.2 Typographical symbols
+.............................
+
+'ms' provides a few strings to obtain typographical symbols not easily
+entered with the keyboard.  These and many others are available as
+special character escape sequences--see the 'groff_char(7)' man page.
+
+ -- String: \*-
+     Interpolate an em dash.
+
+ -- String: \*Q
+ -- String: \*U
+     Interpolate typographer's quotation marks where available, and
+     neutral double quotes otherwise.  '\*Q' is the left quote and '\*U'
+     the right.
+
+&#x1f;
+File: groff.info,  Node: Paragraphs in ms,  Next: Headings in ms,  Prev: Typographical symbols in ms,  Up: ms Body Text
+
+4.6.5.3 Paragraphs
+..................
+
+Paragraphing macros "break", or terminate, any pending output line so
+that a new paragraph can begin.  Several paragraph types are available,
+differing in how indentation applies to them: to left, right, or both
+margins; to the first output line of the paragraph, all output lines, or
+all but the first.  All paragraphing macro calls cause the insertion of
+vertical space in the amount stored in the 'PD' register, except at page
+or column breaks.  Alternatively, a blank input line breaks the output
+line and vertically spaces by one vee.
+
+ -- Macro: .LP
+     Set a paragraph without any (additional) indentation.
+
+ -- Macro: .PP
+     Set a paragraph with a first-line left indentation in the amount
+     stored in the 'PI' register.
+
+ -- Macro: .IP marker width
+     Set a paragraph with a left indentation.  The optional MARKER is
+     not indented and is empty by default.  It has several applications;
+     see *note Lists in ms::.  WIDTH overrides the indentation amount
+     stored in the 'PI' register; its default unit is 'n'.  Once
+     specified, WIDTH applies to further 'IP' calls until specified
+     again or a heading or different paragraphing macro is called.
+
+ -- Macro: .QP
+     Set a paragraph indented from both left and right margins by the
+     amount stored in the 'QI' register.
+
+ -- Macro: .QS
+ -- Macro: .QE
+     Begin ('QS') and end ('QE') a region where each paragraph is
+     indented from both margins by the amount stored in the 'QI'
+     register.  The text between 'QS' and 'QE' can be structured further
+     by use of other paragraphing macros.
+
+ -- Macro: .XP
+     Set an "exdented" paragraph--one with a left indentation in the
+     amount stored in the 'PI' register on every line _except_ the first
+     (also known as a hanging indent).  This is a Berkeley extension.
+
+   The following example illustrates the use of paragraphing macros.
+
+     .NH 2
+     Cases used in the 2001 study
+     .LP
+     Two software releases were considered for this report.
+     .PP
+     The first is commercial software;
+     the second is free.
+     .IP \bu
+     Microsoft Word for Windows,
+     starting with version 1.0 through the current version
+     (Word 2000).
+     .IP \bu
+     GNU Emacs,
+     from its first appearance as a standalone editor through
+     the current version (v20).
+     See Bloggs 2002 for details.
+     .QP
+     Franklin's Law applied to software:
+     software expands to outgrow both RAM and disk space over
+     time.
+     .SH
+     Bibliography
+     .XP
+     Bloggs, Joseph R.,
+     .I "Everyone's a Critic" ,
+     Underground Press, March 2002.
+     A definitive work that answers all questions and
+     criticisms about the quality and usability of free
+     software.
+
+&#x1f;
+File: groff.info,  Node: Headings in ms,  Next: Typeface and decoration,  Prev: Paragraphs in ms,  Up: ms Body Text
+
+4.6.5.4 Headings
+................
+
+Use headings to create a sequential or hierarchical structure for your
+document.  The 'ms' macros print headings in *bold* using the same font
+family and, by default, type size as the body text.  Headings are
+available with and without automatic numbering.  Text on input lines
+following the macro call becomes the heading's title.  Call a
+paragraphing macro to end the heading text and start the section's
+content.
+
+ -- Macro: .NH depth
+ -- Macro: .NH S heading-depth-index ...
+     Set an automatically numbered heading.
+
+     'ms' produces a numbered heading the form A.B.C..., to any depth
+     desired, with the numbering of each depth increasing automatically
+     and being reset to zero when a more significant level is increased.
+     "1" is the most significant or coarsest division of the document.
+     Only non-zero values are output.  If DEPTH is omitted, it is taken
+     to be '1'.
+
+     If you specify DEPTH such that an ascending gap occurs relative to
+     the previous 'NH' call--that is, you "skip a depth", as by '.NH 1'
+     and then '.NH 3'--'groff' 'ms' emits a warning on the standard
+     error stream.
+
+     Alternatively, you can give 'NH' a first argument of 'S', followed
+     by integers to number the heading depths explicitly.  Further
+     automatic numbering, if used, resumes using the specified indices
+     as their predecessors.  This feature is a Berkeley extension.
+
+   An example may be illustrative.
+
+     .NH 1
+     Animalia
+     .NH 2
+     Arthropoda
+     .NH 3
+     Crustacea
+     .NH 2
+     Chordata
+     .NH S 6 6 6
+     Daimonia
+     .NH 1
+     Plantae
+
+   The above results in numbering as follows; the vertical space that
+normally precedes each heading is omitted.
+
+     1.  Animalia
+     1.1.  Arthropoda
+     1.1.1.  Crustacea
+     1.2.  Chordata
+     6.6.6.  Daimonia
+     7.  Plantae
+
+ -- String: \*SN-STYLE
+ -- String: \*SN-DOT
+ -- String: \*SN-NO-DOT
+ -- String: \*SN
+     After 'NH' is called, the assigned number is made available in the
+     strings 'SN-DOT' (as it appears in a printed heading with default
+     formatting, followed by a terminating period) and 'SN-NO-DOT' (with
+     the terminating period omitted).  These are GNU extensions.
+
+     You can control the style used to print numbered headings by
+     defining an appropriate alias for the string 'SN-STYLE'.  By
+     default, 'SN-STYLE' is aliased to 'SN-DOT'.  If you prefer to omit
+     the terminating period from numbers appearing in numbered headings,
+     you may define the alias as follows.
+
+          .als SN-STYLE SN-NO-DOT
+
+     Any such change in numbering style becomes effective from the next
+     use of 'NH' following redefinition of the alias for 'SN-STYLE'.
+     The formatted number of the current heading is available in the
+     'SN' string (a feature first documented by Berkeley), which
+     facilitates its inclusion in, for example, table captions, equation
+     labels, and 'XS'/'XA'/'XE' table of contents entries.
+
+ -- Macro: .SH depth
+     Set an unnumbered heading.
+
+     The optional DEPTH argument is a GNU extension indicating the
+     heading depth corresponding to the DEPTH argument of 'NH'.  It
+     matches the type size at which the heading is set to that of a
+     numbered heading at the same depth when the 'GROWPS' and 'PSINCR'
+     heading size adjustment mechanism is in effect.
+
+   If the 'GROWPS' register is set to a value greater than the LEVEL
+argument to 'NH' or 'SH', the type size of a heading produced by these
+macros increases by 'PSINCR' units over the size specified by 'PS'
+multiplied by the difference of 'GROWPS' and LEVEL.  The value stored in
+'PSINCR' is interpreted in 'groff' basic units; the 'p' scaling unit
+should be employed when assigning a value specified in points.  For
+example, the sequence
+
+     .nr PS 10
+     .nr GROWPS 3
+     .nr PSINCR 1.5p
+     .NH 1
+     Carnivora
+     .NH 2
+     Felinae
+     .NH 3
+     Felis catus
+     .SH 2
+     Machairodontinae
+
+will cause "1.  Carnivora" to be printed in 13-point text, followed by
+"1.1.  Felinae" in 11.5-point text, while "1.1.1.  Felis catus" and all
+more deeply nested heading levels will remain in the 10-point text
+specified by the 'PS' register.  "Machairodontinae" is printed at 11.5
+points, since it corresponds to heading level 2.
+
+   The 'HORPHANS' register operates in conjunction with the 'NH' and
+'SH' macros to inhibit the printing of isolated headings at the bottom
+of a page; it specifies the minimum number of lines of an immediately
+subsequent paragraph that must be kept on the same page as the heading.
+If insufficient space remains on the current page to accommodate the
+heading and this number of lines of paragraph text, a page break is
+forced before the heading is printed.  Any display macro call or 'tbl',
+'pic', or 'eqn' region between the heading and the subsequent paragraph
+suppresses this grouping.  *Note ms keeps and displays:: and *note ms
+Insertions::.
+
+&#x1f;
+File: groff.info,  Node: Typeface and decoration,  Next: Lists in ms,  Prev: Headings in ms,  Up: ms Body Text
+
+4.6.5.5 Typeface and decoration
+...............................
+
+The 'ms' macros provide a variety of ways to style text.  Attend closely
+to the ordering of arguments labeled PRE and POST, which is not
+intuitive.  Support for PRE arguments is a GNU extension.(1)  (*note
+Typeface and decoration-Footnote-1::)
+
+ -- Macro: .B text post pre
+     Style TEXT in bold, followed by POST in the previous font style
+     without intervening space, and preceded by PRE similarly.  Without
+     arguments, 'ms' styles subsequent text in bold until the next
+     paragraphing, heading, or no-argument typeface macro call.
+
+ -- Macro: .R text post pre
+     As 'B', but use the roman style (upright text of normal weight)
+     instead of bold.  Argument recognition is a GNU extension.
+
+ -- Macro: .I text post pre
+     As 'B', but use an italic or oblique style instead of bold.
+
+ -- Macro: .BI text post pre
+     As 'B', but use a bold italic or bold oblique style instead of
+     upright bold.  This is a Tenth Edition Research Unix extension.
+
+ -- Macro: .CW text post pre
+     As 'B', but use a constant-width (monospaced) roman typeface
+     instead of bold.  This is a Tenth Edition Research Unix extension.
+
+ -- Macro: .BX text
+     Typeset TEXT and draw a box around it.  On terminal devices,
+     reverse video is used instead.  If you want TEXT to contain space,
+     use unbreakable space or horizontal motion escape sequences ('\~',
+     '\<SP>', '\^', '\|', '\0' or '\h').
+
+ -- Macro: .UL text post
+     Typeset TEXT with an underline.  POST, if present, is set after
+     TEXT with no intervening space.
+
+ -- Macro: .LG
+     Set subsequent text in larger type (two points larger than the
+     current size) until the next type size, paragraphing, or heading
+     macro call.  You can specify this macro multiple times to enlarge
+     the type size as needed.
+
+ -- Macro: .SM
+     Set subsequent text in smaller type (two points smaller than the
+     current size) until the next type size, paragraphing, or heading
+     macro call.  You can specify this macro multiple times to reduce
+     the type size as needed.
+
+ -- Macro: .NL
+     Set subsequent text at the normal type size (the amount in the 'PS'
+     register).
+
+   PRE and POST arguments are typically used to simplify the attachment
+of punctuation to styled words.  When PRE is used, a hyphenation control
+escape sequence '\%' that would ordinarily start TEXT must start PRE
+instead to have the desired effect.
+
+     The CS course's students found one C language keyword
+     .CW static ) \%(
+     most troublesome.
+
+   The foregoing example produces output as follows.
+
+     The CS course's students found one C language keyword (static)
+     most troublesome.
+
+   You can use the output line continuation escape sequence '\c' to
+achieve the same result (*note Line Continuation::).  It is also
+portable to older 'ms' implementations.
+
+     The CS course's students found one C language keyword
+     \%(\c
+     .CW \%static )
+     most troublesome.
+
+   'groff' 'ms' also offers strings to begin and end super- and
+subscripting.  These are GNU extensions.
+
+ -- String: \*{
+ -- String: \*}
+     Begin and end superscripting, respectively.
+
+ -- String: \*<
+ -- String: \*>
+     Begin and end subscripting, respectively.
+
+   Rather than calling the 'CW' macro, in 'groff' 'ms' you might prefer
+to change the font family to Courier by setting the 'FAM' string to 'C'.
+You can then use all four style macros above, returning to the default
+family (Times) with '.ds FAM T'.  Because changes to 'FAM' take effect
+only at the next paragraph, 'CW' remains useful to "inline" a change to
+the font family, similarly to the practice of this document in noting
+syntactical elements of 'ms' and 'groff'.
+
+&#x1f;
+File: groff.info,  Node: Typeface and decoration-Footnotes,  Up: Typeface and decoration
+
+   (1) This idiosyncrasy arose through feature accretion; for example,
+the 'B' macro in Version 6 Unix 'ms' (1975) accepted only one argument,
+the text to be set in boldface.  By Version 7 (1979) it recognized a
+second argument; in 1990, 'groff' 'ms' added a "pre" argument, placing
+it third to avoid breaking support for older documents.
+
+&#x1f;
+File: groff.info,  Node: Lists in ms,  Next: Indented regions in ms,  Prev: Typeface and decoration,  Up: ms Body Text
+
+4.6.5.6 Lists
+.............
+
+The MARKER argument to the 'IP' macro can be employed to present a
+variety of lists; for instance, you can use a bullet glyph ('\bu') for
+unordered lists, a number (or auto-incrementing register) for numbered
+lists, or a word or phrase for glossary-style or definition lists.  If
+you set the paragraph indentation register 'PI' before calling 'IP', you
+can later reorder the items in the list without having to ensure that a
+WIDTH argument remains affixed to the first call.
+
+   The following is an example of a bulleted list.
+
+     .nr PI 2n
+     A bulleted list:
+     .IP \bu
+     lawyers
+     .IP \bu
+     guns
+     .IP \bu
+     money
+
+     A bulleted list:
+
+     * lawyers
+
+     * guns
+
+     * money
+
+   The following is an example of a numbered list.
+
+     .nr step 0 1
+     .nr PI 3n
+     A numbered list:
+     .IP \n+step
+     lawyers
+     .IP \n+step
+     guns
+     .IP \n+step
+     money
+
+     A numbered list:
+
+     1. lawyers
+
+     2. guns
+
+     3. money
+
+   Here we have employed the 'nr' request to create a register of our
+own, 'step'.  We initialized it to zero and assigned it an
+auto-increment of 1.  Each time we use the escape sequence '\n+PI'
+(note the plus sign), the formatter applies the increment just before
+interpolating the register's value.  Preparing the 'PI' register as well
+enables us to rearrange the list without the tedium of updating macro
+calls.
+
+   The next example illustrates a glossary-style list.
+
+     A glossary-style list:
+     .IP lawyers 0.4i
+     Two or more attorneys.
+     .IP guns
+     Firearms,
+     preferably large-caliber.
+     .IP money
+     Gotta pay for those
+     lawyers and guns!
+
+     A glossary-style list:
+
+     lawyers
+           Two or more attorneys.
+
+     guns  Firearms, preferably large-caliber.
+
+     money
+           Gotta pay for those lawyers and guns!
+
+   In the previous example, observe how the 'IP' macro places the
+definition on the same line as the term if it has enough space.  If this
+is not what you want, there are a few workarounds we will illustrate by
+modifying the example.  First, you can use a 'br' request to force a
+break after printing the term or label.
+
+     .IP guns
+     .br
+     Firearms,
+
+   Second, you could apply the '\p' escape sequence to force a break.
+The space following the escape sequence is important; if you omit it,
+'groff' prints the first word of the paragraph text on the same line as
+the term or label (if it fits) _then_ breaks the line.
+
+     .IP guns
+     \p Firearms,
+
+   Finally, you may append a horizontal motion to the marker with the
+'\h' escape sequence; using the same amount as the indentation will
+ensure that the marker is too wide for 'groff' to treat it as "fitting"
+on the same line as the paragraph text.
+
+     .IP guns\h'0.4i'
+     Firearms,
+
+   In each case, the result is the same.
+
+     A glossary-style list:
+
+     lawyers
+           Two or more attorneys.
+
+     guns
+           Firearms, preferably large-caliber.
+
+     money
+           Gotta pay for those lawyers and guns!
+
+&#x1f;
+File: groff.info,  Node: Indented regions in ms,  Next: ms keeps and displays,  Prev: Lists in ms,  Up: ms Body Text
+
+4.6.5.7 Indented regions
+........................
+
+You may need to indent a region of text while otherwise formatting it
+normally.  Indented regions can be nested; you can change '\nPI'
+before each call to vary the amount of inset.
+
+ -- Macro: .RS
+     Begin a region where headings, paragraphs, and displays are
+     indented (further) by the amount stored in the 'PI' register.
+
+ -- Macro: .RE
+     End the (next) most recent indented region.
+
+   This feature enables you to easily line up text under hanging and
+indented paragraphs.  For example, you may wish to structure lists
+hierarchically.
+
+     .IP \bu 2
+     Lawyers:
+     .RS
+     .IP \bu
+     Dewey,
+     .IP \bu
+     Cheatham,
+     and
+     .IP \bu
+     and Howe.
+     .RE
+     .IP \bu
+     Guns
+
+     * Lawyers:
+
+       *  Dewey,
+
+       *  Cheatham, and
+
+       *  Howe.
+
+     * Guns
+
+&#x1f;
+File: groff.info,  Node: ms keeps and displays,  Next: ms Insertions,  Prev: Indented regions in ms,  Up: ms Body Text
+
+4.6.5.8 Keeps, boxed keeps, and displays
+........................................
+
+On occasion, you may want to "keep" several lines of text, or a region
+of a document, together on a single page, preventing an automatic page
+break within certain boundaries.  This can cause a page break to occur
+earlier than it normally would.  For example, you may want to keep two
+paragraphs together, or a paragraph that refers to a table, list, or
+figure adjacent to the item it discusses.  'ms' provides the 'KS' and
+'KE' macros for this purpose.
+
+   You can alternatively specify a "floating keep": if a keep cannot fit
+on the current page, 'ms' holds its contents and allows material
+following the keep (in the source document) to fill the remainder of the
+current page.  When the page breaks, whether by reaching the end or 'bp'
+request, 'ms' puts the floating keep at the beginning of the next page.
+This is useful for placing large graphics or tables that do not need to
+appear exactly where they occur in the source document.
+
+ -- Macro: .KS
+ -- Macro: .KF
+ -- Macro: .KE
+     'KS' begins a keep, 'KF' a floating keep, and 'KE' ends a keep of
+     either kind.
+
+   As an alternative to the keep mechanism, the 'ne' request forces a
+page break if there is not at least the amount of vertical space
+specified in its argument remaining on the page (*note Page Control::).
+One application of 'ne' is to reserve space on the page for a figure or
+illustration to be included later.
+
+   A "boxed keep" has a frame drawn around it.
+
+ -- Macro: .B1
+ -- Macro: .B2
+     'B1' begins a keep with a box drawn around it.  'B2' ends a boxed
+     keep.
+
+   Boxed keep macros cause breaks; if you need to box a word or phrase
+within a line, see the 'BX' macro in *note Typeface and decoration::.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.  If you wish to box one or more
+paragraphs, you may improve the appearance by calling 'B1' after the
+first paragraphing macro, and by adding a small amount of vertical space
+before calling 'B2'.
+
+     .LP
+     .B1
+     .I Warning:
+     Happy Fun Ball may suddenly accelerate to dangerous
+     speeds.
+     .sp \nPD/2 \" space by half the inter-paragraph distance
+     .B2
+
+   If you want a boxed keep to float, you will need to enclose the 'B1'
+and 'B2' calls within a pair of 'KF' and 'KE' calls.
+
+   "Displays" turn off filling; lines of verse or program code are shown
+with their lines broken as in the source document without requiring 'br'
+requests between lines.  Displays can be kept on a single page or
+allowed to break across pages.  The 'DS' macro begins a kept display of
+the layout specified in its first argument; non-kept displays are begun
+with dedicated macros corresponding to their layout.
+
+ -- Macro: .DS L
+ -- Macro: .LD
+     Begin ('DS': kept) left-aligned display.
+
+ -- Macro: .DS I indent
+ -- Macro: .ID indent
+     Begin ('DS': kept) display indented by INDENT if specified, and by
+     the amount of the 'DI' register otherwise.
+
+ -- Macro: .DS B
+ -- Macro: .BD
+     Begin a ('DS': kept) a block display: the entire display is
+     left-aligned, but indented such that the longest line in the
+     display is centered on the page.
+
+ -- Macro: .DS C
+ -- Macro: .CD
+     Begin a ('DS': kept) centered display: each line in the display is
+     centered.
+
+ -- Macro: .DS R
+ -- Macro: .RD
+     Begin a ('DS': kept) right-aligned display.  This is a GNU
+     extension.
+
+ -- Macro: .DE
+     End any display.
+
+   The distance stored in the 'DD' register is inserted before and after
+each pair of display macros; this is a Berkeley extension.  In 'groff'
+'ms', this distance replaces any adjacent inter-paragraph distance or
+subsequent spacing prior to a section heading.  The 'DI' register is a
+GNU extension; its value is an indentation applied to displays created
+with '.DS' and '.ID' without arguments, to '.DS I' without an
+indentation argument, and to indented equations set with '.EQ'.  Changes
+to either register take effect at the next display boundary.
+
+&#x1f;
+File: groff.info,  Node: ms Insertions,  Next: ms Footnotes,  Prev: ms keeps and displays,  Up: ms Body Text
+
+4.6.5.9 Tables, figures, equations, and references
+..................................................
+
+The 'ms' package is often used with the 'tbl', 'pic', 'eqn', and 'refer'
+preprocessors.  Mark text meant for preprocessors by enclosing it in
+pairs of tokens as follows, with nothing between the dot and the macro
+name.  The preprocessors match these tokens only at the start of an
+input line.
+
+ -- Macro: .TS H
+ -- Macro: .TE
+     Demarcate a table to be processed by the 'tbl' preprocessor.  The
+     optional argument 'H' to 'TS' instructs 'ms' to repeat table rows
+     (often column headings) at the top of each new page the table
+     spans, if applicable; calling the 'TH' macro marks the end of such
+     rows.  The GNU 'tbl(1)' man page provides a comprehensive reference
+     to the preprocessor and offers examples of its use.
+
+ -- Macro: .PS
+ -- Macro: .PE
+ -- Macro: .PF
+     'PS' begins a picture to be processed by the 'gpic' preprocessor;
+     either of 'PE' or 'PF' ends it, the latter with "flyback" to the
+     vertical position at its top.  You can create 'pic' input manually
+     or with a program such as 'xfig'.
+
+ -- Macro: .EQ align label
+ -- Macro: .EN
+     Demarcate an equation to be processed by the 'eqn' preprocessor.
+     The equation is centered by default; ALIGN can be 'C', 'L', or 'I'
+     to (explicitly) center, left-align, or indent it by the amount
+     stored in the 'DI' register, respectively.  If specified, LABEL is
+     set right-aligned.
+
+ -- Macro: .
+ -- Macro: .
+     Demarcate a bibliographic citation to be processed by the 'refer'
+     preprocessor.  The GNU 'refer(1)' man page provides a comprehensive
+     reference to the preprocessor and the format of its bibliographic
+     database.  Type 'man refer' at the command line to view it.
+
+   When 'refer' emits collected references (as might be done on a "Works
+Cited" page), it interpolates the 'REFERENCES' string as an unnumbered
+heading ('SH').
+
+   The following is an example of how to set up a table that may print
+across two or more pages.
+
+     .TS H
+     allbox;
+     Cb | Cb .
+     Part->Description
+     _
+     .TH
+     .T&
+     GH-1978->Fribulating gonkulator
+     ...the rest of the table follows...
+     .TE
+
+Attempting to place a multi-page table inside a keep can lead to
+unpleasant results, particularly if the 'tbl' 'allbox' option is used.
+
+   Mathematics can be typeset using the language of the 'eqn'
+preprocessor.
+
+     .EQ C (\*SN-NO-DOTa)
+     p ~ = ~ q sqrt { ( 1 + ~ ( x / q sup 2 ) }
+     .EN
+
+This input formats a labelled equation.  We used the 'SN-NO-DOT' string
+to base the equation label on the current heading number, giving us more
+flexibility to reorganize the document.
+
+   Use 'groff' options to run preprocessors on the input: '-e' for
+'geqn', '-p' for 'gpic', '-R' for 'grefer', and '-t' for 'gtbl'.
+
+&#x1f;
+File: groff.info,  Node: ms Footnotes,  Prev: ms Insertions,  Up: ms Body Text
+
+4.6.5.10 Footnotes
+..................
+
+A footnote is typically anchored to a place in the text with a "marker",
+which is a small integer, a symbol such as a dagger, or arbitrary
+user-specified text.
+
+ -- String: \**
+     Place an "automatic number", an automatically generated numeric
+     footnote marker, in the text.  Each time this string is
+     interpolated, the number it produces increments by one.  Automatic
+     numbers start at 1.  This is a Berkeley extension.
+
+   Enclose the footnote text in 'FS' and 'FE' macro calls to set it at
+the nearest available "foot", or bottom, of a text column or page.
+
+ -- Macro: .FS marker
+ -- Macro: .FE
+     Begin ('FS') and end ('FE') a footnote.  'FS' calls 'FS-MARK' with
+     any supplied MARKER argument, which is then also placed at the
+     beginning of the footnote text.  If MARKER is omitted, the next
+     pending automatic footnote number enqueued by interpolation of the
+     '*' string is used, and if none exists, nothing is prefixed.
+
+   You may not desire automatically numbered footnotes in spite of their
+convenience.  You can indicate a footnote with a symbol or other text by
+specifying its marker at the appropriate place (for example, by using
+'\dg' for the dagger glyph) _and_ as an argument to the 'FS' macro.
+Such manual marks should be repeated as arguments to 'FS' or as part of
+the footnote text to disambiguate their correspondence.  You may wish to
+use '\*{' and '\*}' to superscript the marker at the anchor point, in
+the footnote text, or both.
+
+   'groff' 'ms' provides a hook macro, 'FS-MARK', for user-determined
+operations to be performed when the 'FS' macro is called.  It is passed
+the same arguments as 'FS' itself.  An application of 'FS-MARK' is
+anchor placement for a hyperlink reference, so that a footnote can link
+back to its referential context.(1)  (*note ms Footnotes-Footnote-1::)
+By default, this macro has an empty definition.  'FS-MARK' is a GNU
+extension.
+
+   Footnotes can be safely used within keeps and displays, but you
+should avoid using automatically numbered footnotes within floating
+keeps.  You can place a second '\**' interpolation between a '\**' and
+its corresponding 'FS' call as long as each 'FS' call occurs _after_ the
+corresponding '\**' and occurrences of 'FS' are in the same order as
+corresponding occurrences of '\**'.
+
+   Footnote text is formatted as paragraphs are, using analogous
+parameters.  The registers 'FI', 'FPD', 'FPS', and 'FVS' correspond to
+'PI', 'PD', 'PS', and 'CS', respectively; 'FPD', 'FPS', and 'FVS' are
+GNU extensions.
+
+   The 'FF' register controls the formatting of automatically numbered
+footnote paragraphs and those for which 'FS' is given a marker argument.
+*Note ms Document Control Settings::.
+
+   The default footnote line length is 11/12ths of the normal line
+length for compatibility with the expectations of historical 'ms'
+documents; you may wish to set the 'FR' string to '1' to align with
+contemporary typesetting practices.  In the past,(2) (*note ms
+Footnotes-Footnote-2::) an 'FL' register was used for the line length in
+footnotes; however, setting this register at document initialization
+time had no effect on the footnote line length in multi-column
+arrangements.(3)  (*note ms Footnotes-Footnote-3::)
+
+   'FR' should be used in preference to the old 'FL' register in
+contemporary documents.  The footnote line length is effectively
+computed as 'column-width * \*FR'.  If an absolute footnote line
+length is required, recall that arithmetic expressions in 'roff' input
+are evaluated strictly from left to right, with no operator precedence
+(parentheses are honored).
+
+     .ds FR 0+3i \" Set footnote line length to 3 inches.
+
+&#x1f;
+File: groff.info,  Node: ms Footnotes-Footnotes,  Up: ms Footnotes
+
+   (1) "Portable Document Format Publishing with GNU Troff",
+'pdfmark.ms' in the 'groff' distribution, uses this technique.
+
+   (2) Unix Version 7 'ms', its descendants, and GNU 'ms' prior to
+'groff' version 1.23.0
+
+   (3) You could reset it after each call to '.1C', '.2C', or '.MC'.
+
+&#x1f;
+File: groff.info,  Node: ms language and localization,  Next: ms Page Layout,  Prev: ms Footnotes,  Up: ms Body Text
+
+4.6.5.11 Language and localization
+..................................
+
+'groff' 'ms' provides several strings that you can customize for your
+own purposes, or redefine to adapt the macro package to languages other
+than English.  It is already localized for Czech, German, French,
+Italian, and Swedish.  Load the desired localization macro package after
+'ms'; see the 'groff_tmac(5)' man page.
+
+     $ groff -ms -mfr bienvenue.ms
+
+   The following strings are available.
+
+ -- String: \*REFERENCES
+     Contains the string printed at the beginning of a references
+     (bibliography) page produced with GNU 'refer(1)'.  The default is
+     'References'.
+
+ -- String: \*ABSTRACT
+     Contains the string printed at the beginning of the abstract.  The
+     default is '\fIABSTRACT\f'; it includes font selection escape
+     sequences to set the word in italics.
+
+ -- String: \*TOC
+     Contains the string printed at the beginning of the table of
+     contents.  The default is 'Table of Contents'.
+
+ -- String: \*MONTH1
+ -- String: \*MONTH2
+ -- String: \*MONTH3
+ -- String: \*MONTH4
+ -- String: \*MONTH5
+ -- String: \*MONTH6
+ -- String: \*MONTH7
+ -- String: \*MONTH8
+ -- String: \*MONTH9
+ -- String: \*MONTH10
+ -- String: \*MONTH11
+ -- String: \*MONTH12
+     Contain the full names of the calendar months.  The defaults are in
+     English: 'January', 'February', and so on.
+
+&#x1f;
+File: groff.info,  Node: ms Page Layout,  Next: Differences from AT&T ms,  Prev: ms Body Text,  Up: ms
+
+4.6.6 Page layout
+-----------------
+
+'ms''s default page layout arranges text in a single column with the
+page number between hyphens centered in a header on each page except the
+first, and produces no footers.  You can customize this arrangement.
+
+* Menu:
+
+* ms Headers and Footers::
+* Tab Stops in ms::
+* ms Margins::
+* ms Multiple Columns::
+* ms TOC::
+
+&#x1f;
+File: groff.info,  Node: ms Headers and Footers,  Next: Tab Stops in ms,  Prev: ms Page Layout,  Up: ms Page Layout
+
+4.6.6.1 Headers and footers
+...........................
+
+There are multiple ways to produce headers and footers.  One is to
+define the strings 'LH', 'CH', and 'RH' to set the left, center, and
+right headers, respectively; and 'LF', 'CF', and 'RF' to set the left,
+center, and right footers.  This approach suffices for documents that do
+not distinguish odd- and even-numbered pages.
+
+   Another method is to call macros that set headers or footers for odd-
+or even-numbered pages.  Each such macro takes a delimited argument
+separating the left, center, and right header or footer texts from each
+other.  You can replace the neutral apostrophes (''') shown below with
+any character not appearing in the header or footer text.  These macros
+are Berkeley extensions.
+
+ -- Macro: .OH 'left'center'right'
+ -- Macro: .EH 'left'center'right'
+ -- Macro: .OF 'left'center'right'
+ -- Macro: .EF 'left'center'right'
+     The 'OH' and 'EH' macros define headers for odd- (recto) and
+     even-numbered (verso) pages, respectively; the 'OF' and 'EF' macros
+     define footers for them.
+
+   With either method, a percent sign '%' in header or footer text is
+replaced by the current page number.  By default, 'ms' places no header
+on a page numbered "1" (regardless of its number format).
+
+ -- Macro: .P1
+     Typeset the header even on page 1.  To be effective, this macro
+     must be called before the header trap is sprung on any page
+     numbered "1"; in practice, unless your page numbering is unusual,
+     this means that you should call it early, before 'TL' or any
+     heading or paragraphing macro.  This is a Berkeley extension.
+
+   For even greater flexibility, 'ms' is designed to permit the
+redefinition of the macros that are called when the 'groff' traps that
+ordinarily cause the headers and footers to be output are sprung.  'PT'
+("page trap") is called by 'ms' when the header is to be written, and
+'BT' ("bottom trap") when the footer is to be.  The 'groff' page
+location trap that 'ms' sets up to format the header also calls the
+(normally undefined) 'HD' macro after 'PT'; you can define 'HD' if you
+need additional processing after setting the header (for example, to
+draw a line below it).  The 'HD' hook is a Berkeley extension.  Any such
+macros you (re)define must implement any desired specialization for
+odd-, even-, or first numbered pages.
+
+&#x1f;
+File: groff.info,  Node: Tab Stops in ms,  Next: ms Margins,  Prev: ms Headers and Footers,  Up: ms Page Layout
+
+4.6.6.2 Tab stops
+.................
+
+Use the 'ta' request to define tab stops as needed.  *Note Tabs and
+Fields::.
+
+ -- Macro: .TA
+     Reset the tab stops to the 'ms' default (every 5 ens).  Redefine
+     this macro to create a different set of default tab stops.
+
+&#x1f;
+File: groff.info,  Node: ms Margins,  Next: ms Multiple Columns,  Prev: Tab Stops in ms,  Up: ms Page Layout
+
+4.6.6.3 Margins
+...............
+
+Control margins using the registers summarized in "Margin settings" in
+*note ms Document Control Settings:: above.  There is no setting for the
+right margin; the combination of page offset '\nPO' and line length
+'\nLL' determines it.
+
+&#x1f;
+File: groff.info,  Node: ms Multiple Columns,  Next: ms TOC,  Prev: ms Margins,  Up: ms Page Layout
+
+4.6.6.4 Multiple columns
+........................
+
+'ms' can set text in as many columns as reasonably fit on the page.  The
+following macros force a page break if a multi-column layout is active
+when they are called.  The 'MINGW' register stores the default minimum
+gutter width; it is a GNU extension.  When multiple columns are in use,
+keeps and the 'HORPHANS' and 'PORPHANS' registers work with respect to
+column breaks instead of page breaks.
+
+ -- Macro: .1C
+     Arrange page text in a single column (the default).
+
+ -- Macro: .2C
+     Arrange page text in two columns.
+
+ -- Macro: .MC column-width gutter-width
+     Arrange page text in multiple columns.  If you specify no
+     arguments, it is equivalent to the '2C' macro.  Otherwise,
+     COLUMN-WIDTH is the width of each column and GUTTER-WIDTH is the
+     minimum distance between columns.
+
+&#x1f;
+File: groff.info,  Node: ms TOC,  Next: Differences from AT&T ms,  Prev: ms Multiple Columns,  Up: ms Page Layout
+
+4.6.6.5 Creating a table of contents
+....................................
+
+Because 'roff' formatters process their input in a single pass, material
+on page 50, for example, cannot influence what appears on page 1--this
+poses a challenge for a table of contents at its traditional location in
+front matter, if you wish to avoid manually maintaining it.  'ms'
+enables the collection of material to be presented in the table of
+contents as it appears, saving its page number along with it, and then
+emitting the collected contents on demand toward the end of the
+document.  The table of contents can then be resequenced to its desired
+location by physically rearranging the pages of a printed document, or
+as part of post-processing--with a 'sed(1)' script to reorder the pages
+in 'troff''s output, with 'pdfjam(1)', or with 'gropdf(1)''s
+'.pdfswitchtopage' feature, for example.
+
+   Define an entry to appear in the table of contents by bracketing its
+text between calls to the 'XS' and 'XE' macros.  A typical application
+is to call them immediately after 'NH' or 'SH' and repeat the heading
+text within them.  The 'XA' macro, used within '.XS'/'.XE' pairs,
+supplements an entry--for instance, when it requires multiple output
+lines, whether because a heading is too long to fit or because style
+dictates that page numbers not be repeated.  You may wish to indent the
+text thus wrapped to correspond to its heading depth; this can be done
+in the entry text by prefixing it with tabs or horizontal motion escape
+sequences, or by providing a second argument to the 'XA' macro.  'XS'
+and 'XA' automatically associate the page number where they are called
+with the text following them, but they accept arguments to override this
+behavior.  At the end of the document, call 'TC' or 'PX' to emit the
+table of contents; 'TC' resets the page number to 'i' (Roman numeral
+one), and then calls 'PX'.  All of these macros are Berkeley extensions.
+
+ -- Macro: .XS page-number
+ -- Macro: .XA page-number indentation
+ -- Macro: .XE
+     Begin, supplement, and end a table of contents entry.  Each entry
+     is associated with PAGE-NUMBER (otherwise the current page number);
+     a PAGE-NUMBER of 'no' prevents a leader and page number from being
+     emitted for that entry.  Use of 'XA' within 'XS'/'XE' is optional;
+     it can be repeated.  If INDENTATION is present, a supplemental
+     entry is indented by that amount; ens are assumed if no unit is
+     indicated.  Text on input lines between 'XS' and 'XE' is stored for
+     later recall by 'PX'.
+
+ -- Macro: .PX no
+     Switch to single-column layout.  Unless 'no' is specified, center
+     and interpolate the 'TOC' string in bold and two points larger than
+     the body text.  Emit the table of contents entries.
+
+ -- Macro: .TC no
+     Set the page number to 1, the page number format to lowercase Roman
+     numerals, and call 'PX' (with a 'no' argument, if present).
+
+   Here's an example of typical 'ms' table of contents preparation.  We
+employ horizontal escape sequences '\h' to indent the entries by
+sectioning depth.
+
+     .NH 1
+     Introduction
+     .XS
+     Introduction
+     .XE
+     ...
+     .NH 2
+     Methodology
+     .XS
+     \h'2n'Methodology
+     .XA
+     \h'4n'Fassbinder's Approach
+     \h'4n'Kahiu's Approach
+     .XE
+     ...
+     .NH 1
+     Findings
+     .XS
+     Findings
+     .XE
+     ...
+     .TC
+
+   The remaining features in this subsubsection are GNU extensions.
+'groff' 'ms' obviates the need to repeat heading text after 'XS' calls.
+Call 'XN' and 'XH' after 'NH' and 'SH', respectively.
+
+ -- Macro: .XN heading-text
+ -- Macro: .XH depth heading-text
+     Format HEADING-TEXT and create a corresponding table of contents
+     entry.  'XN' computes the indentation from the depth of the
+     preceding 'NH' call; 'XH' requires a DEPTH argument to do so.
+
+   'groff' 'ms' encourages customization of table of contents entry
+production.
+
+ -- Macro: .XN-REPLACEMENT heading-text
+ -- Macro: .XH-REPLACEMENT depth heading-text
+     These hook macros implement 'XN' and 'XH', respectively.  They call
+     'XN-INIT' and pass their HEADING-TEXT arguments to 'XH-UPDATE-TOC'.
+
+ -- Macro: .XN-INIT
+ -- Macro: .XH-UPDATE-TOC depth heading-text
+     The 'XN-INIT' hook macro does nothing by default.  'XH-UPDATE-TOC'
+     brackets HEADING-TEXT with 'XS' and 'XE' calls, indenting it by 2
+     ens per level of DEPTH beyond the first.
+
+   We could therefore produce a table of contents similar to that in the
+previous example with fewer macro calls.  (The difference is that this
+input follows the "Approach" entries with leaders and page numbers.)
+
+     .NH 1
+     .XN Introduction
+     ...
+     .NH 2
+     .XN Methodology
+     .XH 3 "Fassbinder's Approach"
+     .XH 3 "Kahiu's Approach"
+     ...
+     .NH 1
+     .XN Findings
+     ...
+
+   To get the section number of the numbered headings into the table of
+contents entries, we might define 'XN-REPLACEMENT' as follows.  (We
+obtain the heading depth from 'groff' 'ms''s internal register 'nh*hl'.)
+
+     .de XN-REPLACEMENT
+     .XN-INIT
+     .XH-UPDATE-TOC \\nnh*hl \\$@
+     \&\\*SN \\$*
+     ..
+
+   You can change the style of the leader that bridges each table of
+contents entry with its page number; define the 'TC-LEADER' special
+character by using the 'char' request.  A typical leader combines the
+dot glyph '.' with a horizontal motion escape sequence to spread the
+dots.  The width of the page number field is stored in the 'TC-MARGIN'
+register.
+
+&#x1f;
+File: groff.info,  Node: Differences from AT&T ms,  Next: ms Naming Conventions,  Prev: ms Page Layout,  Up: ms
+
+4.6.7 Differences from AT&T 'ms'
+--------------------------------
+
+The 'groff' 'ms' macros are an independent reimplementation, using no
+AT&T code.  Since they take advantage of the extended features of
+'groff', they cannot be used with AT&T 'troff'.  'groff' 'ms' supports
+features described above as Berkeley and Tenth Edition Research Unix
+extensions, and adds several of its own.
+
+   * The internals of 'groff' 'ms' differ from the internals of AT&T
+     'ms'.  Documents that depend upon implementation details of AT&T
+     'ms' may not format properly with 'groff' 'ms'.  Such details
+     include macros whose function was not documented in the AT&T 'ms'
+     manual.(1)  (*note Differences from AT&T ms-Footnote-1::)
+
+   * The error-handling policy of 'groff' 'ms' is to detect and report
+     errors, rather than to ignore them silently.
+
+   * Tenth Edition Research Unix supported 'P1'/'P2' macros to bracket
+     code examples; 'groff' 'ms' does not.
+
+   * 'groff' 'ms' does not work in GNU 'troff''s AT&T compatibility
+     mode.  If loaded when that mode is enabled, it aborts processing
+     with a diagnostic message.
+
+   * Multiple line spacing is not supported.  Use a larger vertical
+     spacing instead.
+
+   * 'groff' 'ms' uses the same header and footer defaults in both
+     'nroff' and 'troff' modes as AT&T 'ms' does in 'troff' mode; AT&T's
+     default in 'nroff' mode is to put the date, in U.S. traditional
+     format (e.g., "January 1, 2021"), in the center footer (the 'CF'
+     string).
+
+   * Many 'groff' 'ms' macros, including those for paragraphs, headings,
+     and displays, cause a reset of paragraph rendering parameters, and
+     may change the indentation; they do so not by incrementing or
+     decrementing it, but by setting it absolutely.  This can cause
+     problems for documents that define additional macros of their own
+     that try to manipulate indentation.  Use the 'ms' 'RS' and 'RE'
+     macros instead of the 'in' request.
+
+   * AT&T 'ms' interpreted the values of the registers 'PS' and 'VS' in
+     points, and did not support the use of scaling units with them.
+     'groff' 'ms' interprets values of the registers 'PS', 'VS', 'FPS',
+     and 'FVS' equal to or larger than 1,000 (one thousand) as decimal
+     fractions multiplied by 1,000.(2)  (*note Differences from AT&T
+     ms-Footnote-2::) This threshold makes use of a scaling unit with
+     these parameters practical for high-resolution devices while
+     preserving backward compatibility.  It also permits expression of
+     non-integral type sizes.  For example, 'groff -rPS=10.5p' at the
+     shell prompt is equivalent to placing '.nr PS 10.5p' at the
+     beginning of the document.
+
+   * AT&T 'ms''s 'AU' macro supported arguments used with some document
+     types; 'groff' 'ms' does not.
+
+   * Right-aligned displays are available.  The AT&T 'ms' manual
+     observes that "it is tempting to assume that '.DS R' will right
+     adjust lines, but it doesn't work".  In 'groff' 'ms', it does.
+
+   * To make 'groff' 'ms' use the default page offset (which also
+     specifies the left margin), the 'PO' register must stay undefined
+     until the first 'ms' macro is called.
+
+     This implies that '\nPO' should not be used early in the
+     document, unless it is changed also: accessing an undefined
+     register automatically defines it.
+
+   * 'groff' 'ms' supports the 'PN' register, but it is not necessary;
+     you can access the page number via the usual '%' register and
+     invoke the 'af' request to assign a different format to it if
+     desired.(3)  (*note Differences from AT&T ms-Footnote-3::)
+
+   * The AT&T 'ms' manual documents registers 'CW' and 'GW' as setting
+     the default column width and "intercolumn gap", respectively, and
+     which applied when 'MC' was called with fewer than two arguments.
+     'groff' 'ms' instead treats 'MC' without arguments as synonymous
+     with '2C'; there is thus no occasion for a default column width
+     register.  Further, the 'MINGW' register and the second argument to
+     'MC' specify a _minimum_ space between columns, not the fixed
+     gutter width of AT&T 'ms'.
+
+   * The AT&T 'ms' manual did not document the 'QI' register; Berkeley
+     and 'groff' 'ms' do.
+
+ -- Register: \nGS
+     The register 'GS' is set to 1 by the 'groff' 'ms' macros, but is
+     not used by the AT&T 'ms' package.  Documents that need to
+     determine whether they are being formatted with 'groff' 'ms' or
+     another implementation should test this register.
+
+* Menu:
+
+* Missing Unix Version 7 ms Macros::
+
+&#x1f;
+File: groff.info,  Node: Differences from AT&T ms-Footnotes,  Up: Differences from AT&T ms
+
+   (1) 'Typing Documents on the UNIX System: Using the -ms Macros with
+Troff and Nroff', M. E. Lesk, Bell Laboratories, 1978
+
+   (2) Register values are converted to and stored as basic units.
+*Note Measurements::.
+
+   (3) If you redefine the 'ms' 'PT' macro and desire special treatment
+of certain page numbers (like '1'), you may need to handle a non-Arabic
+page number format, as 'groff' 'ms''s 'PT' does; see the macro package
+source.  'groff' 'ms' aliases the 'PN' register to '%'.
+
+&#x1f;
+File: groff.info,  Node: Missing Unix Version 7 ms Macros,  Prev: Differences from AT&T ms,  Up: Differences from AT&T ms
+
+4.6.7.1 Unix Version 7 'ms' macros not implemented by 'groff' 'ms'
+..................................................................
+
+Several macros described in the Unix Version 7 'ms' documentation are
+unimplemented by 'groff' 'ms' because they are specific to the
+requirements of documents produced internally by Bell Laboratories, some
+of which also require a glyph for the Bell System logo that 'groff' does
+not support.  These macros implemented several document type formats
+('EG', 'IM', 'MF', 'MR', 'TM', 'TR'), were meaningful only in
+conjunction with the use of certain document types ('AT', 'CS', 'CT',
+'OK', 'SG'), stored the postal addresses of Bell Labs sites ('HO', 'IH',
+'MH', 'PY', 'WH'), or lacked a stable definition over time ('UX').  To
+compatibly render historical 'ms' documents using these macros, we
+advise your documents to invoke the 'rm' request to remove any such
+macros it uses and then define replacements with an authentically
+typeset original at hand.(1)  (*note Missing Unix Version 7 ms
+Macros-Footnote-1::) For informal purposes, a simple definition of 'UX'
+should maintain the readability of the document's substance.
+
+     .rm UX
+     .ds UX Unix\"
+
+&#x1f;
+File: groff.info,  Node: Missing Unix Version 7 ms Macros-Footnotes,  Up: Missing Unix Version 7 ms Macros
+
+   (1) The removal beforehand is necessary because 'groff' 'ms' aliases
+these macros to a diagnostic macro, and you want to redefine the aliased
+name, not its target.
+
+&#x1f;
+File: groff.info,  Node: ms Legacy Features,  Next: ms Naming Conventions,  Prev: Differences from AT&T ms,  Up: ms
+
+4.6.8 Legacy Features
+---------------------
+
+'groff' 'ms' retains some legacy features solely to support formatting
+of historical documents; contemporary ones should not use them because
+they can render poorly.  See the 'groff_char(7)' man page.
+
+AT&T accent mark strings
+........................
+
+AT&T 'ms' defined accent mark strings as follows.
+
+ -- String: \*'
+     Apply acute accent to subsequent glyph.
+
+ -- String: \*`
+     Apply grave accent to subsequent glyph.
+
+ -- String: \*:
+     Apply dieresis (umlaut) to subsequent glyph.
+
+ -- String: \*^
+     Apply circumflex accent to subsequent glyph.
+
+ -- String: \*~
+     Apply tilde accent to subsequent glyph.
+
+ -- String: \*C
+     Apply caron to subsequent glyph.
+
+ -- String: \*,
+     Apply cedilla to subsequent glyph.
+
+Berkeley accent mark and glyph strings
+......................................
+
+Berkeley 'ms' offered an 'AM' macro; calling it redefined the AT&T
+accent mark strings (except for '\*C'), applied them to the _preceding_
+glyph, and defined additional strings, some for spacing glyphs.
+
+ -- Macro: .AM
+     Enable alternative accent mark and glyph-producing strings.
+
+ -- String: \*'
+     Apply acute accent to preceding glyph.
+
+ -- String: \*`
+     Apply grave accent to preceding glyph.
+
+ -- String: \*:
+     Apply dieresis (umlaut) to preceding glyph.
+
+ -- String: \*^
+     Apply circumflex accent to preceding glyph.
+
+ -- String: \*~
+     Apply tilde accent to preceding glyph.
+
+ -- String: \*,
+     Apply cedilla to preceding glyph.
+
+ -- String: \*/
+     Apply stroke (slash) to preceding glyph.
+
+ -- String: \*v
+     Apply caron to preceding glyph.
+
+ -- String: \*_
+     Apply macron to preceding glyph.
+
+ -- String: \*.
+     Apply underdot to preceding glyph.
+
+ -- String: \*o
+     Apply ring accent to preceding glyph.
+
+ -- String: \*?
+     Interpolate inverted question mark.
+
+ -- String: \*!
+     Interpolate inverted exclamation mark.
+
+ -- String: \*8
+     Interpolate small letter sharp s.
+
+ -- String: \*q
+     Interpolate small letter o with hook accent (ogonek).
+
+ -- String: \*3
+     Interpolate small letter yogh.
+
+ -- String: \*d-
+     Interpolate small letter eth.
+
+ -- String: \*D-
+     Interpolate capital letter eth.
+
+ -- String: \*th
+     Interpolate small letter thorn.
+
+ -- String: \*Th
+     Interpolate capital letter thorn.
+
+ -- String: \*ae
+     Interpolate small æ ligature.
+
+ -- String: \*Ae
+     Interpolate capital Æ ligature.
+
+ -- String: \*oe
+     Interpolate small oe ligature.
+
+ -- String: \*OE
+     Interpolate capital OE ligature.
+
+&#x1f;
+File: groff.info,  Node: ms Naming Conventions,  Prev: ms Legacy Features,  Up: ms
+
+4.6.9 Naming Conventions
+------------------------
+
+The following conventions are used for names of macros, strings, and
+registers.  External names available to documents that use the 'groff'
+'ms' macros contain only uppercase letters and digits.
+
+   Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
+
+   * Names used only within one module are of the form MODULE'*'NAME.
+
+   * Names used outside the module in which they are defined are of the
+     form MODULE'@'NAME.
+
+   * Names associated with a particular environment are of the form
+     ENVIRONMENT':'NAME; these are used only within the 'par' module.
+
+   * NAME does not have a module prefix.
+
+   * Constructed names used to implement arrays are of the form
+     ARRAY'!'INDEX.
+
+   Thus the 'groff' 'ms' macros reserve the following names.
+
+   * Names containing the characters '*', '@', and ':'.
+
+   * Names containing only uppercase letters and digits.
+
+&#x1f;
+File: groff.info,  Node: GNU troff Reference,  Next: File Formats,  Prev: Major Macro Packages,  Up: Top
+
+5 GNU 'troff' Reference
+***********************
+
+This chapter covers _all_ of the facilities of the GNU 'troff'
+formatting engine.  Users of macro packages may skip it if not
+interested in details.
+
+* Menu:
+
+* Text::
+* Page Geometry::
+* Measurements::
+* Numeric Expressions::
+* Identifiers::
+* Formatter Instructions::
+* Comments::
+* Registers::
+* Manipulating Filling and Adjustment::
+* Manipulating Hyphenation::
+* Manipulating Spacing::
+* Tabs and Fields::
+* Character Translations::
+* troff and nroff Modes::
+* Line Layout::
+* Line Continuation::
+* Page Layout::
+* Page Control::
+* Using Fonts::
+* Manipulating Type Size and Vertical Spacing::
+* Colors::
+* Strings::
+* Conditionals and Loops::
+* Writing Macros::
+* Page Motions::
+* Drawing Geometric Objects::
+* Deferring Output::
+* Traps::
+* Diversions::
+* Punning Names::
+* Environments::
+* Suppressing Output::
+* I/O::
+* Postprocessor Access::
+* Miscellaneous::
+* Gtroff Internals::
+* Debugging::
+* Implementation Differences::
+
+&#x1f;
+File: groff.info,  Node: Text,  Next: Measurements,  Prev: GNU troff Reference,  Up: GNU troff Reference
+
+5.1 Text
+========
+
+AT&T 'troff' was designed to take input as it would be composed on a
+typewriter, including the teletypewriters used as early computer
+terminals, and relieve the user drafting a document of concern with
+details like line length, hyphenation breaking, and the achievement of
+straight margins.  Early in its development, the program gained the
+ability to prepare output for a phototypesetter; a document could then
+be prepared for output to either a teletypewriter, a phototypesetter, or
+both.  GNU 'troff' continues this tradition of permitting an author to
+compose a single master version of a document which can then be rendered
+for a variety of output formats or devices.
+
+   'roff' input files contain text interspersed with instructions to
+control the formatter.  Even in the absence of such instructions, GNU
+'troff' still processes its input in several ways, by filling,
+hyphenating, breaking, and adjusting it, and supplementing it with
+inter-sentence space.
+
+* Menu:
+
+* Filling::
+* Hyphenation::
+* Sentences::
+* Breaking::
+* Adjustment::
+* Tabs and Leaders::
+* Requests and Macros::
+* Macro Packages::
+* Input Encodings::
+* Input Conventions::
+
+&#x1f;
+File: groff.info,  Node: Filling,  Next: Sentences,  Prev: Text,  Up: Text
+
+5.1.1 Filling
+-------------
+
+When GNU 'troff' starts up, it obtains information about the device for
+which it is preparing output.(1)  (*note Filling-Footnote-1::) An
+essential property is the length of the output line, such as "6.5
+inches".
+
+   GNU 'troff' interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can--this is known as "filling".  To GNU 'troff', a
+"word" is any sequence of one or more characters that aren't spaces or
+newlines.  The exceptions separate words.(2)  (*note
+Filling-Footnote-2::) To disable filling, see *note Manipulating Filling
+and Adjustment::.
+
+     It is a truth universally acknowledged
+     that a single man in possession of a
+     good fortune must be in want of a wife.
+         => It is a truth universally acknowledged that a
+         => single man in possession of a good fortune must
+         => be in want of a wife.
+
+&#x1f;
+File: groff.info,  Node: Filling-Footnotes,  Up: Filling
+
+   (1) *Note Device and Font Description Files::.
+
+   (2) Tabs and leaders also separate words.  Escape sequences can
+function as word characters, word separators, or neither--the last
+simply have no effect on GNU 'troff''s idea of whether an input
+character is within a word.  We'll discuss all of these in due course.
+
+&#x1f;
+File: groff.info,  Node: Sentences,  Next: Hyphenation,  Prev: Filling,  Up: Text
+
+5.1.2 Sentences
+---------------
+
+A passionate debate has raged for decades among writers of the English
+language over whether more space should appear between adjacent
+sentences than between words within a sentence, and if so, how much, and
+what other circumstances should influence this spacing.(1)  (*note
+Sentences-Footnote-1::) GNU 'troff' follows the example of AT&T 'troff';
+it attempts to detect the boundaries between sentences, and supplies
+additional inter-sentence space between them.
+
+     Hello, world!
+     Welcome to groff.
+         => Hello, world!  Welcome to groff.
+
+   GNU 'troff' flags certain characters (normally '!', '?', and '.') as
+potentially ending a sentence.  When GNU 'troff' encounters one of these
+"end-of-sentence characters" at the end of an input line, or one of them
+is followed by two (unescaped) spaces on the same input line, it appends
+an inter-word space followed by an inter-sentence space in the output.
+
+     R. Harper subscribes to a maxim of P. T. Barnum.
+         => R. Harper subscribes to a maxim of P. T. Barnum.
+
+   In the above example, inter-sentence space is not added after 'P.' or
+'T.' because the periods do not occur at the end of an input line, nor
+are they followed by two or more spaces.  Let's imagine that we've heard
+something about defamation from Mr. Harper's attorney, recast the
+sentence, and reflowed it in our text editor.
+
+     I submit that R. Harper subscribes to a maxim of P. T.
+     Barnum.
+         => I submit that R. Harper subscribes to a maxim of
+         => P. T.  Barnum.
+
+   "Barnum" doesn't begin a sentence!  What to do?  Let us meet our
+first "escape sequence", a series of input characters that give
+instructions to GNU 'troff' instead of being used to construct output
+device glyphs.(2)  (*note Sentences-Footnote-2::) An escape sequence
+begins with the backslash character '\' by default, an uncommon
+character in natural language text, and is _always_ followed by at least
+one other character, hence the term "sequence".
+
+   The dummy character escape sequence '\&' can be used after an
+end-of-sentence character to defeat end-of-sentence detection on a
+per-instance basis.  We can therefore rewrite our input more
+defensively.
+
+     I submit that R.\& Harper subscribes to a maxim of P.\&
+     T.\& Barnum.
+         => I submit that R. Harper subscribes to a maxim of
+         => P. T. Barnum.
+
+   Adding text caused our input to wrap; now, we don't need '\&' after
+'T.' but we do after 'P.'.  Consistent use of the escape sequence
+ensures that potential sentence boundaries are robust to editing
+activities.  Further advice along these lines will follow in *note Input
+Conventions::.
+
+   Normally, the occurrence of a visible non-end-of-sentence character
+(as opposed to a space or tab) immediately after an end-of-sentence
+character cancels detection of the end of a sentence.  For example, it
+would be incorrect for GNU 'troff' to infer the end of a sentence after
+the dot in '3.14159'.  However, several characters are treated
+_transparently_ after the occurrence of an end-of-sentence character.
+That is, GNU 'troff' does not cancel end-of-sentence detection when it
+processes them.  This is because such characters are often used as
+footnote markers or to close quotations and parentheticals.  The default
+set is '"', ''', ')', '', '*', '\dg', '\dd', '\rq', and '\cq'.
+The last four are examples of "special characters", escape sequences
+whose purpose is to obtain glyphs that are not easily typed at the
+keyboard, or which have special meaning to GNU 'troff' (like '\'
+itself).(3)  (*note Sentences-Footnote-3::)
+
+     \lqThe idea that the poor should have leisure has always
+     been shocking to the rich.\rq
+     (Bertrand Russell, 1935)
+         => "The idea that the poor should have
+         => leisure has always been shocking to
+         => the rich."  (Bertrand Russell, 1935)
+
+   The sets of characters that potentially end sentences or are
+transparent to sentence endings are configurable.  See the 'cflags'
+request in *note Using Symbols::.  To change the additional
+inter-sentence space amount--even to remove it entirely--see *note
+Manipulating Filling and Adjustment::.
+
+&#x1f;
+File: groff.info,  Node: Sentences-Footnotes,  Up: Sentences
+
+   (1) A well-researched jeremiad appreciated by 'groff' contributors on
+both sides of the sentence-spacing debate can be found at
+<https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324>.
+
+   (2) This statement oversimplifies; there are escape sequences whose
+purpose is precisely to produce glyphs on the output device, and input
+characters that _aren't_ part of escape sequences can undergo a great
+deal of processing before getting to the output.
+
+   (3) The mnemonics for the special characters shown here are "dagger",
+"double dagger", "right (double) quote", and "closing (single) quote".
+See the 'groff_char(7)' man page.
+
+&#x1f;
+File: groff.info,  Node: Hyphenation,  Next: Breaking,  Prev: Sentences,  Up: Text
+
+5.1.3 Hyphenation
+-----------------
+
+When an output line is nearly full, it is uncommon for the next word
+collected from the input to exactly fill it--typically, there is room
+left over only for part of the next word.  The process of splitting a
+word so that it appears partially on one line (with a hyphen to indicate
+to the reader that the word has been broken) with its remainder on the
+next is "hyphenation".  Hyphenation points can be manually specified;
+GNU 'troff' also uses a hyphenation algorithm and language-specific
+pattern files (based on those used in TeX) to decide which words can be
+hyphenated and where.
+
+   Hyphenation does not always occur even when the hyphenation rules for
+a word allow it; it can be disabled, and when not disabled there are
+several parameters that can prevent it in certain circumstances.  *Note
+Manipulating Hyphenation::.
+
+&#x1f;
+File: groff.info,  Node: Breaking,  Next: Adjustment,  Prev: Hyphenation,  Up: Text
+
+5.1.4 Breaking
+--------------
+
+Once an output line is full, the next word (or remainder of a hyphenated
+one) is placed on a different output line; this is called a "break".  In
+this manual and in 'roff' discussions generally, a "break" if not
+further qualified always refers to the termination of an output line.
+When the formatter is filling text, it introduces breaks automatically
+to keep output lines from exceeding the configured line length.  After
+an automatic break, GNU 'troff' adjusts the line if applicable (see
+below), and then resumes collecting and filling text on the next output
+line.
+
+   Sometimes, a line cannot be broken automatically.  This usually does
+not happen with natural language text unless the output line length has
+been manipulated to be extremely short, but it can with specialized text
+like program source code.  We can use 'perl' at the shell prompt to
+contrive an example of failure to break the line.  We also employ the
+'-z' option to suppress normal output.
+
+     $ perl -e 'print "#" x 80, "\n";' | nroff -z
+         error-> warning: cannot break line
+
+   The remedy for these cases is to tell GNU 'troff' where the line may
+be broken without hyphens.  This is done with the non-printing break
+point escape sequence '\:'; see *note Manipulating Hyphenation::.
+
+   What if the document author wants to stop filling lines temporarily,
+for instance to start a new paragraph?  There are several solutions.  A
+blank input line not only causes a break, but by default it also outputs
+a one-line vertical space (effectively a blank output line).  This
+behavior can be modified; see *note Blank Line Traps::.  Macro packages
+may discourage or disable the blank line method of paragraphing in favor
+of their own macros.
+
+   A line that begins with one or more spaces causes a break.  The
+spaces are output at the beginning of the next line without being
+_adjusted_ (see below); however, this behavior can be modified (*note
+Leading Space Traps::).  Again, macro packages may provide other methods
+of producing indented paragraphs.  Trailing spaces on text lines are
+discarded.(1)  (*note Breaking-Footnote-1::)
+
+   What if the file ends before enough words have been collected to fill
+an output line?  Or the output line is exactly full but not yet broken,
+and there is no more input?  GNU 'troff' interprets the end of input as
+a break.  Certain requests also cause breaks, implicitly or explicitly.
+This is discussed in *note Manipulating Filling and Adjustment::.
+
+&#x1f;
+File: groff.info,  Node: Breaking-Footnotes,  Up: Breaking
+
+   (1) "Text lines" are defined in *note Requests and Macros::.
+
+&#x1f;
+File: groff.info,  Node: Adjustment,  Next: Tabs and Leaders,  Prev: Breaking,  Up: Text
+
+5.1.5 Adjustment
+----------------
+
+After GNU 'troff' performs an automatic break, it may then "adjust" the
+line, widening inter-word spaces until the text reaches the right
+margin.  Extra spaces between words are preserved.  Leading and trailing
+spaces are handled as noted above.  Text can be aligned to the left or
+right margin only, or centered; see *note Manipulating Filling and
+Adjustment::.
+
+&#x1f;
+File: groff.info,  Node: Tabs and Leaders,  Next: Input Conventions,  Prev: Adjustment,  Up: Text
+
+5.1.6 Tabs and Leaders
+----------------------
+
+GNU 'troff' translates input horizontal tab characters ("tabs") and
+<Control+A> characters ("leaders") into movements to the next tab stop.
+Tabs simply move to the next tab stop; leaders place enough periods to
+fill the space.  Tab stops are by default located every half inch
+measured from the drawing position corresponding to the beginning of the
+input line; see *note Page Geometry::.  Tabs and leaders do not cause
+breaks and therefore do not interrupt filling.  Below, we use arrows ->
+and bullets * to indicate input tabs and leaders, respectively.
+
+     1
+     -> 2 -> 3 * 4
+     -> * 5
+     => 1         2       3.......4         ........5
+
+   Tabs and leaders lend themselves to table construction.(1)  (*note
+Tabs and Leaders-Footnote-1::) The tab and leader glyphs can be
+configured, and further facilities for sophisticated table composition
+are available; see *note Tabs and Fields::.  There are many details to
+track when using such low-level features, so most users turn to the
+'tbl(1)' preprocessor to lay out tables.
+
+&#x1f;
+File: groff.info,  Node: Tabs and Leaders-Footnotes,  Up: Tabs and Leaders
+
+   (1) "Tab" is short for "tabulation", revealing the term's origin as a
+spacing mechanism for table arrangement.
+
+&#x1f;
+File: groff.info,  Node: Requests and Macros,  Next: Macro Packages,  Prev: Tabs and Leaders,  Up: Text
+
+5.1.7 Requests and Macros
+-------------------------
+
+We have now encountered almost all of the syntax there is in the 'roff'
+language, with an exception already noted in passing.  A "request" is an
+instruction to the formatter that occurs after a "control character",
+which is recognized at the beginning of an input line.  The regular
+control character is a dot ('.').  Its counterpart, the "no-break
+control character", a neutral apostrophe ('''), suppresses the break
+that is implied by some requests.  These characters were chosen because
+it is uncommon for lines of text in natural languages to begin with
+them.  If you require a formatted period or apostrophe (closing single
+quotation mark) where GNU 'troff' is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence, '\&'.
+
+   An input line beginning with a control character is called a "control
+line".  Every line of input that is not a control line is a "text
+line".(1)  (*note Requests and Macros-Footnote-1::)
+
+   Requests often take "arguments", words (separated from the request
+name and each other by spaces) that specify details of the action GNU
+'troff' is expected to perform.  If a request is meaningless without
+arguments, it is typically ignored.
+
+   GNU 'troff''s requests and escape sequences comprise the control
+language of the formatter.  Of key importance are the requests that
+define macros.  Macros are invoked like requests, enabling the request
+repertoire to be extended or overridden.(2)  (*note Requests and
+Macros-Footnote-2::)
+
+   A "macro" can be thought of as an abbreviation you can define for a
+collection of control and text lines.  When the macro is "called" by
+giving its name after a control character, it is replaced with what it
+stands for.  The process of textual replacement is known as
+"interpolation".(3)  (*note Requests and Macros-Footnote-3::)
+Interpolations are handled as soon as they are recognized, and once
+performed, a 'roff' formatter scans the replacement for further
+requests, macro calls, and escape sequences.
+
+   In 'roff' systems, the 'de' request defines a macro.(4)  (*note
+Requests and Macros-Footnote-4::)
+
+     .de DATE
+     2020-11-14
+     ..
+
+The foregoing input produces no output by itself; all we have done is
+store some information.  Observe the pair of dots that ends the macro
+definition.  This is a default; you can specify your own terminator for
+the macro definition as the second argument to the 'de' request.
+
+     .de NAME ENDNAME
+     Heywood Jabuzzoff
+     .ENDNAME
+
+   In fact, the ending marker is itself the name of a macro to be
+called, or a request to be invoked, if it is defined at the time its
+control line is read.
+
+     .de END
+     Big Rip
+     ..
+     .de START END
+     Big Bang
+     .END
+     .START
+         => Big Rip Big Bang
+
+In the foregoing example, "Big Rip" printed before "Big Bang" because
+its macro was _called_ first.  Consider what would happen if we dropped
+'END' from the '.de START' line and added '..' after '.END'.  Would the
+order change?
+
+   Let us consider a more elaborate example.
+
+     .de DATE
+     2020-10-05
+     ..
+     .
+     .de BOSS
+     D.\& Kruger,
+     J.\& Peterman
+     ..
+     .
+     .de NOTICE
+     Approved:
+     .DATE
+     by
+     .BOSS
+     ..
+     .
+     Insert tedious regulatory compliance paragraph here.
+
+     .NOTICE
+
+     Insert tedious liability disclaimer paragraph here.
+
+     .NOTICE
+         => Insert tedious regulatory compliance paragraph here.
+         =>
+         => Approved: 2020-10-05 by D. Kruger, J. Peterman
+         =>
+         => Insert tedious liability disclaimer paragraph here.
+         =>
+         => Approved: 2020-10-05 by D. Kruger, J. Peterman
+
+The above document started with a series of control lines.  Three macros
+were defined, with a 'de' request declaring each macro's name, and the
+"body" of the macro starting on the next line and continuing until a
+line with two dots ''..'' marked its end.  The text proper began only
+after the macros were defined; this is a common pattern.  Only the
+'NOTICE' macro was called "directly" by the document; 'DATE' and 'BOSS'
+were called only by 'NOTICE' itself.  Escape sequences were used in
+'BOSS', two levels of macro interpolation deep.
+
+   The advantage in typing and maintenance economy may not be obvious
+from such a short example, but imagine a much longer document with
+dozens of such paragraphs, each requiring a notice of managerial
+approval.  Consider what must happen if you are in charge of generating
+a new version of such a document with a different date, for a different
+boss.  With well-chosen macros, you only have to change each datum in
+one place.
+
+   In practice, we would probably use strings (*note Strings::) instead
+of macros for such simple interpolations; what is important here is to
+glimpse the potential of macros and the power of recursive
+interpolation.
+
+   We could have defined 'DATE' and 'BOSS' in the opposite order;
+perhaps less obviously, we could also have defined them _after_
+'NOTICE'.  "Forward references" like this are acceptable because the
+body of a macro definition is not (completely) interpreted, but stored
+instead (*note Copy Mode::).  While a macro is being defined (or
+appended to), requests are not interpreted and macros not interpolated,
+whereas some commonly used escape sequences _are_ interpreted.  'roff'
+systems also support recursive macro calls, as long as you have a way to
+break the recursion (*note Conditionals and Loops::).  Maintainable
+'roff' documents tend to arrange macro definitions to minimize forward
+references.
+
+&#x1f;
+File: groff.info,  Node: Requests and Macros-Footnotes,  Up: Requests and Macros
+
+   (1) The '\<RET>' escape sequence can alter how an input line is
+classified; see *note Line Continuation::.
+
+   (2) Argument handling in macros is more flexible but also more
+complex.  *Note Calling Macros::.
+
+   (3) Some escape sequences undergo interpolation as well.
+
+   (4) GNU 'troff' offers additional ones.  *Note Writing Macros::.
+
+&#x1f;
+File: groff.info,  Node: Macro Packages,  Next: Input Encodings,  Prev: Requests and Macros,  Up: Text
+
+5.1.8 Macro Packages
+--------------------
+
+Macro definitions can be collected into "macro files", 'roff' input
+files designed to produce no output themselves but instead ease the
+preparation of other 'roff' documents.  There is no syntactical
+difference between a macro file and any other 'roff' document; only its
+purpose distinguishes it.  When a macro file is installed at a standard
+location and suitable for use by a general audience, it is often termed
+a "macro package".(1)  (*note Macro Packages-Footnote-1::) Macro
+packages can be loaded by supplying the '-m' option to GNU 'troff' or a
+'groff' front end.  Alternatively, a document requiring a macro package
+can load it with the 'mso' ("macro source") request.
+
+&#x1f;
+File: groff.info,  Node: Macro Packages-Footnotes,  Up: Macro Packages
+
+   (1) Macro files and packages frequently define registers and strings
+as well.
+
+&#x1f;
+File: groff.info,  Node: Input Encodings,  Next: Input Conventions,  Prev: Macro Packages,  Up: Text
+
+5.1.9 Input Encodings
+---------------------
+
+The 'groff' command's '-k' option calls the 'preconv' preprocessor to
+perform input character encoding conversions.  Input to the GNU 'troff'
+formatter itself, on the other hand, must be in one of two encodings it
+can recognize.
+
+'cp1047'
+     The code page 1047 input encoding works only on EBCDIC platforms
+     (and conversely, the other input encodings don't work with EBCDIC);
+     the file 'cp1047.tmac' is loaded at startup.
+
+'latin1'
+     ISO Latin-1, an encoding for Western European languages, is the
+     default input encoding on non-EBCDIC platforms; the file
+     'latin1.tmac' is loaded at startup.
+
+Any document that is encoded in ISO 646:1991 (a descendant of USAS
+X3.4-1968 or "US-ASCII"), or, equivalently, uses only code points from
+the "C0 Controls" and "Basic Latin" parts of the Unicode character set
+is also a valid ISO Latin-1 document; the standards are interchangeable
+in their first 128 code points.(1)  (*note Input Encodings-Footnote-1::)
+
+   Other encodings are supported by means of macro packages.
+
+'latin2'
+     To use ISO Latin-2, an encoding for Central and Eastern European
+     languages, invoke '.mso latin2.tmac' at the beginning of your
+     document or supply '-mlatin2' as a command-line argument to
+     'groff'.
+
+'latin5'
+     To use ISO Latin-5, an encoding for the Turkish language, invoke
+     '.mso latin5.tmac' at the beginning of your document or supply
+     '-mlatin5' as a command-line argument to 'groff'.
+
+'latin9'
+     ISO Latin-9 succeeds Latin-1; it includes a Euro sign and better
+     glyph coverage for French.  To use this encoding, invoke
+     '.mso latin9.tmac' at the beginning of your document or supply
+     '-mlatin9' as a command-line argument to 'groff'.
+
+   Some characters from an input encoding may not be available with a
+particular output driver, or their glyphs may not have representation in
+the font used.  For terminal devices, fallbacks are defined, like 'EUR'
+for the Euro sign and '(C)' for the copyright sign.  For typesetter
+devices, you may need to "mount" fonts that support glyphs required by
+the document.  *Note Font Positions::.
+
+   Because a Euro glyph was not historically defined in PostScript
+fonts, 'groff' comes with a font called 'freeeuro.pfa' that provides the
+Euro in several styles.  Standard PostScript fonts contain the glyphs
+from Latin-5 and Latin-9 that Latin-1 lacks, so these encodings are
+supported for the 'ps' and 'pdf' output devices as 'groff' ships, while
+Latin-2 is not.
+
+   Unicode supports characters from all other input encodings; the
+'utf8' output driver for terminals therefore does as well.  The DVI
+output driver supports the Latin-2 and Latin-9 encodings if the
+command-line option '-mec' is used as well.  (2)  (*note Input
+Encodings-Footnote-2::)
+
+&#x1f;
+File: groff.info,  Node: Input Encodings-Footnotes,  Up: Input Encodings
+
+   (1) The _semantics_ of certain punctuation code points have gotten
+stricter with the successive standards, a cause of some frustration
+among man page writers; see the 'groff_char(7)' man page.
+
+   (2) The DVI output device defaults to using the Computer Modern (CM)
+fonts; 'ec.tmac' loads the EC fonts instead, which provide Euro '\Eu'
+and per mille '\%0' glyphs.
+
+&#x1f;
+File: groff.info,  Node: Input Conventions,  Prev: Input Encodings,  Up: Text
+
+5.1.10 Input Conventions
+------------------------
+
+Since GNU 'troff' fills text automatically, it is common practice in the
+'roff' language to avoid visual composition of text in input files: the
+esthetic appeal of the formatted output is what matters.  Therefore,
+'roff' input should be arranged such that it is easy for authors and
+maintainers to compose and develop the document, understand the syntax
+of 'roff' requests, macro calls, and preprocessor languages used, and
+predict the behavior of the formatter.  Several traditions have accrued
+in service of these goals.
+
+   * Follow sentence endings in the input with newlines to ease their
+     recognition (*note Sentences::).  It is frequently convenient to
+     end text lines after colons and semicolons as well, as these
+     typically precede independent clauses.  Consider doing so after
+     commas; they often occur in lists that become easy to scan when
+     itemized by line, or constitute supplements to the sentence that
+     are added, deleted, or updated to clarify it.  Parenthetical and
+     quoted phrases are also good candidates for placement on text lines
+     by themselves.
+
+   * Set your text editor's line length to 72 characters or fewer.(1)
+     (*note Input Conventions-Footnote-1::) This limit, combined with
+     the previous item of advice, makes it less common that an input
+     line will wrap in your text editor, and thus will help you perceive
+     excessively long constructions in your text.  Recall that natural
+     languages originate in speech, not writing, and that punctuation is
+     correlated with pauses for breathing and changes in prosody.
+
+   * Use '\&' after '!', '?', and '.' if they are followed by space,
+     tab, or newline characters and don't end a sentence.
+
+   * In filled text lines, use '\&' before '.' and ''' if they are
+     preceded by space, so that reflowing the input doesn't turn them
+     into control lines.
+
+   * Do not use spaces to perform indentation or align columns of a
+     table.  Leading spaces are reliable when text is not being filled.
+
+   * Comment your document.  It is never too soon to apply comments to
+     record information of use to future document maintainers (including
+     your future self).  We thus introduce another escape sequence,
+     '\"', which causes GNU 'troff' to ignore the remainder of the input
+     line.
+
+   * Use the empty request--a control character followed immediately by
+     a newline--to visually manage separation of material in input
+     files.  Many of the 'groff' project's own documents use an empty
+     request between sentences, after macro definitions, and where a
+     break is expected, and two empty requests between paragraphs or
+     other requests or macro calls that will introduce vertical space
+     into the document.
+
+     You can combine the empty request with the comment escape sequence
+     to include whole-line comments in your document, and even "comment
+     out" sections of it.
+
+   We conclude this section with an example sufficiently long to
+illustrate most of the above suggestions in practice.  For the purpose
+of fitting the example between the margins of this manual with the font
+used for its typeset version, we have shortened the input line length to
+56 columns.  As before, an arrow -> indicates a tab character.
+
+     .\"   nroff this_file.roff | less
+     .\"   groff -T ps this_file.roff > this_file.ps
+     ->The theory of relativity is intimately connected with
+     the theory of space and time.
+     .
+     I shall therefore begin with a brief investigation of
+     the origin of our ideas of space and time,
+     although in doing so I know that I introduce a
+     controversial subject.  \" remainder of paragraph elided
+     .
+     .
+
+     ->The experiences of an individual appear to us arranged
+     in a series of events;
+     in this series the single events which we remember
+     appear to be ordered according to the criterion of
+     \lqearlier\rq and \lqlater\rq, \" punct swapped
+     which cannot be analysed further.
+     .
+     There exists,
+     therefore,
+     for the individual,
+     an I-time,
+     or subjective time.
+     .
+     This itself is not measurable.
+     .
+     I can,
+     indeed,
+     associate numbers with the events,
+     in such a way that the greater number is associated with
+     the later event than with an earlier one;
+     but the nature of this association may be quite
+     arbitrary.
+     .
+     This association I can define by means of a clock by
+     comparing the order of events furnished by the clock
+     with the order of a given series of events.
+     .
+     We understand by a clock something which provides a
+     series of events which can be counted,
+     and which has other properties of which we shall speak
+     later.
+     .\" Albert Einstein, _The Meaning of Relativity_, 1922
+
+&#x1f;
+File: groff.info,  Node: Input Conventions-Footnotes,  Up: Input Conventions
+
+   (1) Emacs: 'fill-column: 72'; Vim: 'textwidth=72'
+
+&#x1f;
+File: groff.info,  Node: Page Geometry,  Next: Measurements,  Prev: Text,  Up: GNU troff Reference
+
+5.2 Page Geometry
+=================
+
+'roff' systems format text under certain assumptions about the size of
+the output medium, or page.  For the formatter to correctly break a line
+it is filling, it must know the line length, which it derives from the
+page width (*note Line Layout::).  For it to decide whether to write an
+output line to the current page or wait until the next one, it must know
+the page length (*note Page Layout::).
+
+   A device's "resolution" converts practical units like inches or
+centimeters to "basic units", a convenient length measure for the output
+device or file format.  The formatter and output driver use basic units
+to reckon page measurements.  The device description file defines its
+resolution and page dimensions (*note DESC File Format::).
+
+   A "page" is a two-dimensional structure upon which a 'roff' system
+imposes a rectangular coordinate system with its upper left corner as
+the origin.  Coordinate values are in basic units and increase down and
+to the right.  Useful ones are therefore always positive and within
+numeric ranges corresponding to the page boundaries.
+
+   While the formatter (and, later, output driver) is processing a page,
+it keeps track of its "drawing position", which is the location at which
+the next glyph will be written, from which the next motion will be
+measured, or where a geometric object will commence rendering.
+Notionally, glyphs are drawn from the text baseline upward and to the
+right.(1)  (*note Page Geometry-Footnote-1::) The "text baseline" is a
+(usually invisible) line upon which the glyphs of a typeface are
+aligned.  A glyph therefore "starts" at its bottom-left corner.  If
+drawn at the origin, a typical letter glyph would lie partially or
+wholly off the page, depending on whether, like "g", it features a
+descender below the baseline.
+
+   Such a situation is nearly always undesirable.  It is furthermore
+conventional not to write or draw at the extreme edges of the page.
+Therefore the initial drawing position of a 'roff' formatter is not at
+the origin, but below and to the right of it.  This rightward shift from
+the left edge is known as the "page offset".(2)  (*note Page
+Geometry-Footnote-2::) The downward shift leaves room for a text output
+line.
+
+   Text is arranged on a one-dimensional lattice of text baselines from
+the top to the bottom of the page.  "Vertical spacing" is the distance
+between adjacent text baselines.  Typographic tradition sets this
+quantity to 120% of the type size.  The initial drawing position is one
+unit of vertical spacing below the page top.  Typographers term this
+unit a vee.
+
+   Vertical spacing has an impact on page-breaking decisions.
+Generally, when a break occurs, the formatter moves the drawing position
+to the next text baseline automatically.  If the formatter were already
+writing to the last line that would fit on the page, advancing by one
+vee would place the next text baseline off the page.  Rather than let
+that happen, 'roff' formatters instruct the output driver to eject the
+page, start a new one, and again set the drawing position to one vee
+below the page top; this is a "page break".
+
+   When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one.  Macro packages keep
+users from having to confront this difficulty by setting "traps" (*note
+Traps::); moreover, all but the simplest page layouts tend to have
+headers and footers, or at least bear vertical margins larger than one
+vee.
+
+&#x1f;
+File: groff.info,  Node: Page Geometry-Footnotes,  Up: Page Geometry
+
+   (1) 'groff' does not yet support right-to-left scripts.
+
+   (2) 'groff''s terminal output devices have page offsets of zero.
+
+&#x1f;
+File: groff.info,  Node: Measurements,  Next: Numeric Expressions,  Prev: Text,  Up: GNU troff Reference
+
+5.3 Measurements
+================
+
+The formatter sometimes requires the input of numeric parameters to
+specify measurements.  These are specified as integers or decimal
+fractions with an optional "scaling unit" suffixed.  A scaling unit is a
+letter that immediately follows the last digit of a number.  Digits
+after the decimal point are optional.  Measurement expressions include
+'10.5p', '11i', and '3.c'.
+
+   Measurements are scaled by the scaling unit and stored internally
+(with any fractional part discarded) in basic units.  The device
+resolution can therefore be obtained by storing a value of '1i' to a
+register.  The only constraint on the basic unit is that it is at least
+as small as any other unit.
+
+'u'
+     Basic unit.
+
+'i'
+     Inch; defined as 2.54 centimeters.
+
+'c'
+     Centimeter; a centimeter is about 0.3937 inches.
+
+'p'
+     Point; a typesetter's unit used for measuring type size.  There are
+     72 points to an inch.
+
+'P'
+     Pica; another typesetter's unit.  There are 6 picas to an inch and
+     12 points to a pica.
+
+'s'
+'z'
+     *Note Using Fractional Type Sizes::, for a discussion of these
+     units.
+
+'f'
+     GNU 'troff' defines this unit to scale decimal fractions in the
+     interval 0, 1 to 16-bit unsigned integers.  It multiplies a
+     quantity by 65,536.  *Note Colors::, for usage.
+
+   The magnitudes of other scaling units depend on the text formatting
+parameters in effect.  These are useful when specifying measurements
+that need to scale with the typeface or vertical spacing.
+
+'m'
+     Em; an em is equal to the current type size in points.  It is named
+     thus because it is approximately the width of the letter 'M'.
+
+'n'
+     En; an en is one-half em.
+
+'v'
+     Vee; recall *note Page Geometry::.
+
+'M'
+     Hundredth of an em.
+
+* Menu:
+
+* Motion Quanta::
+* Default Units::
+
+&#x1f;
+File: groff.info,  Node: Motion Quanta,  Next: Default Units,  Prev: Measurements,  Up: Measurements
+
+5.3.1 Motion Quanta
+-------------------
+
+An output device's basic unit 'u' is not necessarily its smallest
+addressable length; 'u' can be smaller to avoid problems with integer
+roundoff.  The minimum distances that a device can work with in the
+horizontal and vertical directions are termed its "motion quanta".
+Measurements are rounded to applicable motion quanta.  Half-quantum
+fractions round toward zero.
+
+ -- Register: \n.H
+ -- Register: \n.V
+     These read-only registers interpolate the horizontal and vertical
+     motion quanta, respectively, of the output device in basic units.
+
+   For example, we might draw short baseline rules on a terminal device
+as follows.  *Note Drawing Geometric Objects::.
+
+     .tm \n.H
+         error-> 24
+     .nf
+     \l'36u' 36u
+     \l'37u' 37u
+         => _ 36u
+         => __ 37u
+
+&#x1f;
+File: groff.info,  Node: Default Units,  Prev: Motion Quanta,  Up: Measurements
+
+5.3.2 Default Units
+-------------------
+
+A general-purpose register (one created or updated with the 'nr'
+request; see *note Registers::) is implicitly dimensionless, or reckoned
+in basic units if interpreted in a measurement context.  But it is
+convenient for many requests and escape sequences to infer a scaling
+unit for an argument if none is specified.  An explicit scaling unit
+(not after a closing parenthesis) can override an undesirable default.
+Effectively, the default unit is suffixed to the expression if a scaling
+unit is not already present.  GNU 'troff''s use of integer arithmetic
+should also be kept in mind (*note Numeric Expressions::).
+
+   The 'll' request interprets its argument in ems by default.  Consider
+several attempts to set a line length of 3.5 inches when the type size
+is 10 points on a terminal device with a resolution of 240 basic units
+and horizontal motion quantum of 24.  Some expressions become zero; the
+request clamps them to that quantum.
+
+     .ll 3.5i      \" 3.5i (= 840u)
+     .ll 7/2       \" 7u/2u -> 3u -> 3m -> 0, clamped to 24u
+     .ll (7 / 2)u  \" 7u/2u -> as above
+     .ll 7/2i      \" 7u/2i -> 7u/480u -> 0 -> as above
+     .ll 7i/2      \" 7i/2u -> 1680u/2m -> 1680u/24u -> 35u
+     .ll 7i/2u     \" 3.5i (= 840u)
+
+The safest way to specify measurements is to attach a scaling unit.  To
+multiply or divide by a dimensionless quantity, use 'u' as its scaling
+unit.
+
+&#x1f;
+File: groff.info,  Node: Numeric Expressions,  Next: Identifiers,  Prev: Measurements,  Up: GNU troff Reference
+
+5.4 Numeric Expressions
+=======================
+
+A "numeric expression" evaluates to an integer: it can be as simple as a
+literal '0' or it can be a complex sequence of register and string
+interpolations interleaved with measurements and operators.
+
+   GNU 'troff' provides a set of mathematical and logical operators
+familiar to programmers--as well as some unusual ones--but supports only
+integer arithmetic.(1)  (*note Numeric Expressions-Footnote-1::) The
+internal data type used for computing results is usually a 32-bit signed
+integer, which suffices to represent magnitudes within a range of ±2
+billion.(2)  (*note Numeric Expressions-Footnote-2::)
+
+   Arithmetic infix operators perform a function on the numeric
+expressions to their left and right; they are '+' (addition), '-'
+(subtraction), '*' (multiplication), '/' (truncating division), and '%'
+(modulus).  "Truncating division" rounds to the integer nearer to zero,
+no matter how large the fractional portion.  Overflow and division (or
+modulus) by zero are errors and abort evaluation of a numeric
+expression.
+
+   Arithmetic unary operators operate on the numeric expression to their
+right; they are '-' (negation) and '+' (assertion--for completeness; it
+does nothing).  The unary minus must often be used with parentheses to
+avoid confusion with the decrementation operator, discussed below.
+
+   Observe the rounding behavior and effect of negative operands on the
+modulus and truncating division operators.
+
+     .nr T 199/100
+     .nr U 5/2
+     .nr V (-5)/2
+     .nr W 5/-2
+     .nr X 5%2
+     .nr Y (-5)%2
+     .nr Z 5%-2
+     T=\nT U=\nU V=\nV W=\nW X=\nX Y=\nY Z=\nZ
+         => T=1 U=2 V=-2 W=-2 X=1 Y=-1 Z=1
+
+The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.  Division and modulus operators satisfy the following
+property: given a dividend A and a divisor B, a quotient Q formed by '(a
+/ b)' and a remainder R by '(a % b)', then qb + r = a.
+
+   GNU 'troff''s scaling operator, used with parentheses as '(C;E)',
+evaluates a numeric expression E using C as the default scaling unit.
+If C is omitted, scaling units are ignored in the evaluation of E.  This
+operator can save typing by avoiding the attachment of scaling units to
+every operand out of caution.  Your macros can select a sensible default
+unit in case the user neglects to supply one.
+
+     .\" Indent by amount given in first argument; assume ens.
+     .de Indent
+     .  in (n;\\$1)
+     ..
+
+Without the scaling operator, the foregoing macro would, if called with
+a unitless argument, cause indentation by the 'in' request's default
+scaling unit (ems).  The result would be twice as much indentation as
+expected.
+
+   GNU 'troff' also provides a pair of operators to compute the extrema
+of two operands: '>?' (maximum) and '<?' (minimum).
+
+     .nr slots 5
+     .nr candidates 3
+     .nr salaries (\nslots <? \ncandidates)
+     Looks like we'll end up paying \nsalaries salaries.
+         => Looks like we'll end up paying 3 salaries.
+
+   Comparison operators comprise '<' (less than), '>' (greater than),
+'<=' (less than or equal), '>=' (greater than or equal), and '='
+(equal).  '==' is a synonym for '='.  When evaluated, a comparison is
+replaced with '0' if it is false and '1' if true.  In the 'roff'
+language, positive values are true, others false.
+
+   We can operate on truth values with the logical operators '&'
+(logical conjunction or "and") and ':' (logical disjunction or "or").
+They evaluate as comparison operators do.
+
+   A logical complementation ("not") operator, '!', works only within
+'if', 'ie', and 'while' requests.  Furthermore, '!' is recognized only
+at the beginning of a numeric expression not contained by another
+numeric expression.  In other words, it must be the "outermost"
+operator.  Including it elsewhere in the expression produces a warning
+in the 'number' category (*note Warnings::), and its expression
+evaluates false.  This unfortunate limitation maintains compatibility
+with AT&T 'troff'.  Test a numeric expression for falsity by comparing
+it to a false value.(3)  (*note Numeric Expressions-Footnote-3::)
+
+     .nr X 1
+     .nr Y 0
+     .\" This does not work as expected.
+     .if (\nX)&(!\nY) .nop A: X is true, Y is false
+     .
+     .\" Use this construct instead.
+     .if (\nX)&(\nY<=0) .nop B: X is true, Y is false
+         error-> warning: expected numeric expression, got '!'
+         => B: X is true, Y is false
+
+   The 'roff' language has no operator precedence: expressions are
+evaluated strictly from left to right, in contrast to schoolhouse
+arithmetic.  Use parentheses '(' ')' to impose a desired precedence upon
+subexpressions.
+
+     .nr X 3+5*4
+     .nr Y (3+5)*4
+     .nr Z 3+(5*4)
+     X=\nX Y=\nY Z=\nZ
+         => X=32 Y=32 Z=23
+
+   For many requests and escape sequences that cause motion on the page,
+the unary operators '+' and '-' work differently when leading a numeric
+expression.  They then indicate a motion relative to the drawing
+position: positive is down in vertical contexts, right in horizontal
+ones.
+
+   '+' and '-' are also treated differently by the following requests
+and escape sequences: 'bp', 'in', 'll', 'lt', 'nm', 'nr', 'pl', 'pn',
+'po', 'ps', 'pvs', 'rt', 'ti', '\H', '\R', and '\s'.  Here, leading plus
+and minus signs serve as incrementation and decrementation operators,
+respectively.  To negate an expression, subtract it from zero or include
+the unary minus in parentheses with its argument.  *Note Setting
+Registers::, for examples.
+
+   A leading '|' operator indicates a motion relative not to the drawing
+position but to a boundary.  For horizontal motions, the measurement
+specifies a distance relative to a drawing position corresponding to the
+beginning of the _input_ line.  By default, tab stops reckon movements
+in this way.  Most escape sequences do not; '|' tells them to do so.
+
+     Mind the \h'1.2i'gap.
+     .br
+     Mind the \h'|1.2i'gap.
+     .br
+     Mind the
+     \h'|1.2i'gap.
+         => Mind the             gap.
+         => Mind the    gap.
+         => Mind the             gap.
+
+   One use of this feature is to define macros whose scope is limited to
+the output they format.
+
+     .\" underline word $1 with trailing punctuation $2
+     .de Underline
+     .  nop \\$1\l'|0\ul'\\$2
+     ..
+     Typographical emphasis is best used
+     .Underline sparingly .
+
+In the above example, '|0' specifies a negative motion from the current
+position (at the end of the argument just emitted, '\$1') to the
+beginning of the input line.  Thus, the '\l' escape sequence in this
+case draws a line from right to left.  A macro call occurs at the
+beginning of an input line;(4) (*note Numeric Expressions-Footnote-4::)
+if the '|' operator were omitted, then the underline would be drawn at
+zero distance from the current position, producing device-dependent, and
+likely undesirable, results.  On the 'ps' output device, it underlines
+the period.
+
+   For vertical motions, the '|' operator specifies a distance from the
+first text baseline on the page or in the current diversion,(5) (*note
+Numeric Expressions-Footnote-5::) using the current vertical spacing.
+
+     A
+     .br
+     B \Z'C'\v'|0'D
+         => A D
+         => B C
+
+   In the foregoing example, we've used the '\Z' escape sequence (*note
+Page Motions::) to restore the drawing position after formatting 'C',
+then moved vertically to the first text baseline on the page.
+
+ -- Escape sequence: \B'anything'
+     Interpolate 1 if ANYTHING is a valid numeric expression, and 0
+     otherwise.  The delimiter need not be a neutral apostrophe; see
+     *note Delimiters::.
+
+   You might use '\B' along with the 'if' request to filter out invalid
+macro or string arguments.  *Note Conditionals and Loops::.
+
+     .\" Indent by amount given in first argument; assume ens.
+     .de Indent
+     .  if \B'\\$1' .in (n;\\$1)
+     ..
+
+   A register interpolated as an operand in a numeric expression must
+have an Arabic format; luckily, this is the default.  *Note Assigning
+Register Formats::.
+
+   Because spaces separate arguments to requests, spaces are not allowed
+in numeric expressions unless the (sub)expression containing them is
+surrounded by parentheses.  *Note Invoking Requests::, and *note
+Conditionals and Loops::.
+
+     .nf
+     .nr a 1+2 + 2+1
+     \na
+         error-> expected numeric expression, got a space
+         => 3
+     .nr a 1+(2 + 2)+1
+     \na
+         => 6
+
+   The 'nr' request (*note Setting Registers::) expects its second and
+optional third arguments to be numeric expressions; a bare '+' does not
+qualify, so our first attempt got a warning.
+
+&#x1f;
+File: groff.info,  Node: Numeric Expressions-Footnotes,  Up: Numeric Expressions
+
+   (1) Provision is made for interpreting and reporting decimal
+fractions in certain cases.
+
+   (2) If that's not enough, see the 'groff_tmac(5)' man page for the
+'62bit.tmac' macro package.
+
+   (3) *Note Conditionals and Loops::.
+
+   (4) Control structure syntax creates an exception to this rule, but
+is designed to remain useful: recalling our example, '.if 1 .Underline
+this' would underline only "this", precisely.  *Note Conditionals and
+Loops::.
+
+   (5) *Note Diversions::.
+
+&#x1f;
+File: groff.info,  Node: Identifiers,  Next: Formatter Instructions,  Prev: Numeric Expressions,  Up: GNU troff Reference
+
+5.5 Identifiers
+===============
+
+An "identifier" labels a GNU 'troff' datum such as a register, name
+(macro, string, or diversion), typeface, color, special character,
+character class, environment, or stream.  Valid identifiers consist of
+one or more ordinary characters.  An ordinary character is an input
+character that is not the escape character, a leader, tab, newline, or
+invalid as GNU 'troff' input.
+
+   Invalid input characters are a subset of control characters (from the
+sets "C0 Controls" and "C1 Controls" as Unicode describes them).  When
+GNU 'troff' encounters one in an identifier, it produces a warning in
+category 'input' (*note Warnings::).  They are removed during
+interpretation: an identifier 'foo', followed by an invalid character
+and then 'bar', is processed as 'foobar'.
+
+   On a machine using the ISO 646, 8859, or 10646 character encodings,
+invalid input characters are '0x00', '0x08', '0x0B', '0x0D'-'0x1F', and
+'0x80'-'0x9F'.  On an EBCDIC host, they are '0x00'-'0x01', '0x08',
+'0x09', '0x0B', '0x0D'-'0x14', '0x17'-'0x1F', and '0x30'-'0x3F'.(1)
+(*note Identifiers-Footnote-1::) Some of these code points are used by
+GNU 'troff' internally, making it non-trivial to extend the program to
+accept UTF-8 or other encodings that use characters from these
+ranges.(2)  (*note Identifiers-Footnote-2::)
+
+   Thus, the identifiers 'br', 'PP', 'end-list', 'ref*normal-print',
+'|', '@_', and '!"#$%'()*+,-./' are all valid.  Discretion should be
+exercised to prevent confusion.  Identifiers starting with '(' or ''
+require care.
+
+     .nr x 9
+     .nr y 1
+     .nr (x 2
+     .nr y 3
+     .nr sum1 (\n(x + \ny)
+         error-> a space character is not allowed in an escape
+         error->   sequence parameter
+     A:2+3=\nsum1
+     .nr sum2 (\n((x + \ny)
+     B:2+3=\nsum2
+     .nr sum3 (\n(x + \n(y)
+     C:2+3=\nsum3
+         => A:2+3=1 B:2+3=5 C:2+3=5
+
+An identifier with a closing bracket ('') in its name can't be accessed
+with bracket-form escape sequences that expect an identifier as a
+parameter.  For example, '\foo' accesses the glyph 'foo', followed by
+'' in whatever the surrounding context is, whereas '\C'foo'' formats a
+glyph named 'foo'.  Similarly, the identifier '(' can't be interpolated
+_except_ with bracket forms.
+
+   If you begin a macro, string, or diversion name with either of the
+characters '' or '', you foreclose use of the 'grefer' preprocessor,
+which recognizes '.' and '.' as bibliographic reference delimiters.
+
+ -- Escape sequence: \A'anything'
+     Interpolate 1 if ANYTHING is a valid identifier, and 0 otherwise.
+     The delimiter need not be a neutral apostrophe; see *note
+     Delimiters::.  Because invalid input characters are removed (see
+     above), invalid identifiers are empty or contain spaces, tabs, or
+     newlines.
+
+     You can employ '\A' to validate a macro argument before using it to
+     construct another escape sequence or identifier.
+
+          .\" usage: .init-coordinate-pair name val1 val2
+          .\" Create a coordinate pair where name!x=val1 and
+          .\" name!y=val2.
+          .de init-coordinate-pair
+          .  if \A'\\$1' \{\
+          .    if \B'\\$2' .nr \\$1!x \\$2
+          .    if \B'\\$3' .nr \\$1!y \\$3
+          .  \}
+          ..
+          .init-coordinate-pair center 5 10
+          The center is at (\ncenter!x, \ncenter!y).
+          .init-coordinate-pair "poi->nt" trash garbage \" ignored
+          .init-coordinate-pair point trash garbage \" ignored
+              => The center is at (5, 10).
+
+     In this example, we also validated the numeric arguments; the
+     registers 'point!x' and 'point!y' remain undefined.  *Note Numeric
+     Expressions:: for the '\B' escape sequence.
+
+   How GNU 'troff' handles the interpretation of an undefined identifier
+depends on the context.  There is no way to invoke an undefined request;
+such syntax is interpreted as a macro call instead.  If the identifier
+is interpreted as a string, macro, or diversion, GNU 'troff' emits a
+warning in category 'mac', defines it as empty, and interpolates
+nothing.  If the identifier is interpreted as a register, GNU 'troff'
+emits a warning in category 'reg', initializes it to zero, and
+interpolates that value.  *Note Warnings::, *note Interpolating
+Registers::, and *note Strings::.  Attempting to use an undefined
+typeface, special character, color, character class, environment, or
+stream generally provokes an error diagnostic.
+
+   Identifiers for requests, macros, strings, and diversions share one
+name space; special characters and character classes another.  No other
+object types do.
+
+     .de xxx
+     .  nop foo
+     ..
+     .di xxx
+     bar
+     .br
+     .di
+     .
+     .xxx
+         => bar
+
+The foregoing example shows that GNU 'troff' reuses the identifier
+'xxx', changing it from a macro to a diversion.  No warning is emitted,
+and the previous contents of 'xxx' are lost.
+
+&#x1f;
+File: groff.info,  Node: Identifiers-Footnotes,  Up: Identifiers
+
+   (1) Historically, control characters like ASCII STX, ETX, and BEL
+(<Control+B>, <Control+C>, and <Control+G>) have been observed in 'roff'
+documents, particularly in macro packages employing them as delimiters
+with the output comparison operator to try to avoid collisions with the
+content of arbitrary user-supplied parameters (*note Operators in
+Conditionals::).  We discourage this expedient; in GNU 'troff' it is
+unnecessary (outside of compatibility mode) because delimited arguments
+are parsed at a different input level than the surrounding context.
+*Note Implementation Differences::.
+
+   (2) Consider what happens when a C1 control '0x80'-'0x9F' is
+necessary as a continuation byte in a UTF-8 sequence.
+
+&#x1f;
+File: groff.info,  Node: Formatter Instructions,  Next: Registers,  Prev: Identifiers,  Up: GNU troff Reference
+
+5.6 Formatter Instructions
+==========================
+
+To support documents that require more than filling, automatic line
+breaking and hyphenation, adjustment, and supplemental inter-sentence
+space, the 'roff' language offers two means of embedding instructions to
+the formatter.
+
+   One is a "request", which begins with a control character and takes
+up the remainder of the input line.  Requests often perform relatively
+large-scale operations such as setting the page length, breaking the
+line, or starting a new page.  They also conduct internal operations
+like defining macros.
+
+   The other is an "escape sequence", which begins with the escape
+character and can be embedded anywhere in the input, even in arguments
+to requests and other escape sequences.  Escape sequences interpolate
+special characters, strings, or registers, and handle comparatively
+minor formatting tasks like sub- and superscripting.
+
+   Some operations, such as font selection and type size alteration, are
+available via both requests and escape sequences.
+
+* Menu:
+
+* Control Characters::
+* Invoking Requests::
+* Calling Macros::
+* Using Escape Sequences::
+* Delimiters::
+
+&#x1f;
+File: groff.info,  Node: Control Characters,  Next: Invoking Requests,  Prev: Formatter Instructions,  Up: Formatter Instructions
+
+5.6.1 Control Characters
+------------------------
+
+The mechanism of using 'roff''s control characters to invoke requests
+and call macros was introduced in *note Requests and Macros::.  Control
+characters are recognized only at the beginning of an input line, or at
+the beginning of the branch of a control structure request; see *note
+Conditionals and Loops::.
+
+   A few requests cause a break implicitly; use the no-break control
+character to prevent the break.  Break suppression is its sole
+behavioral distinction.  Employing the no-break control character to
+invoke requests that don't cause breaks is harmless but poor style.
+*Note Manipulating Filling and Adjustment::.
+
+   The control '.' and no-break control ''' characters can each be
+changed to any ordinary character(1) (*note Control
+Characters-Footnote-1::) with the 'cc' and 'c2' requests, respectively.
+
+ -- Request: .cc o
+     Recognize the ordinary character O as the control character.  If O
+     is absent or invalid, the default control character '.' is
+     selected.  The identity of the control character is associated with
+     the environment (*note Environments::).
+
+ -- Request: .c2 o
+     Recognize the ordinary character O as the no-break control
+     character.  If O is absent or invalid, the default no-break control
+     character ''' is selected.  The identity of the no-break control
+     character is associated with the environment (*note
+     Environments::).
+
+   When writing a macro, you might wish to know which control character
+was used to call it.
+
+ -- Register: \n.br
+     This read-only register interpolates 1 if the currently executing
+     macro was called using the normal control character and 0
+     otherwise.  If a macro is interpolated as a string, the '.br'
+     register's value is inherited from the context of the string
+     interpolation.  *Note Strings::.
+
+     Use this register to reliably intercept requests that imply breaks.
+
+          .als bp*orig bp
+          .de bp
+          .  ie \\n.br .bp*orig
+          .  el          'bp*orig
+          ..
+
+     Testing the '.br' register outside of a macro definition makes no
+     sense.
+
+&#x1f;
+File: groff.info,  Node: Control Characters-Footnotes,  Up: Control Characters
+
+   (1) Recall *note Identifiers::.
+
+&#x1f;
+File: groff.info,  Node: Invoking Requests,  Next: Calling Macros,  Prev: Control Characters,  Up: Formatter Instructions
+
+5.6.2 Invoking Requests
+-----------------------
+
+A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.  The invocation of an
+unrecognized request is interpreted as a macro call.  Defining a macro
+with the same name as a request replaces the request.  Deleting a
+request name with the 'rm' request makes it unavailable.  The 'als'
+request can alias requests, permitting them to be wrapped or
+non-destructively replaced.  *Note Strings::.
+
+   There is no inherent limit on argument length or quantity.  Most
+requests take one or more arguments, and ignore any they do not expect.
+A request may be separated from its arguments by tabs or spaces, but
+only spaces can separate an argument from its successor.  Only one
+between arguments is necessary; any excess is ignored.  GNU 'troff' does
+not allow tabs for argument separation.(1)  (*note Invoking
+Requests-Footnote-1::)
+
+   Generally, a space _within_ a request argument is not relevant, not
+meaningful, or is supported by bespoke provisions, as with the 'tl'
+request's delimiters (*note Page Layout::).  Some requests, like 'ds',
+interpret the remainder of the control line as a single argument.  *Note
+Strings::.
+
+   Spaces and tabs immediately after a control character are ignored.
+Commonly, authors structure the source of documents or macro files with
+them.
+
+     .de center
+     .  if \\n.br \
+     .    br
+     .  ce \\$1
+     ..
+     .
+     .
+     .de right-align
+     .->if \\n.br \
+     .->->br
+     .->rj \\$1
+     ..
+
+   If you assign an empty blank line trap, you can separate macro
+definitions (or any input lines) with blank lines.
+
+     .de do-nothing
+     ..
+     .blm do-nothing  \" activate blank line trap
+
+     .de center
+     .  if \\n.br \
+     .    br
+     .  ce \\$1
+     ..
+
+
+     .de right-align
+     .->if \\n.br \
+     .->->br
+     .->rj \\$1
+     ..
+
+     .blm             \" deactivate blank line trap
+
+   *Note Blank Line Traps::.
+
+&#x1f;
+File: groff.info,  Node: Invoking Requests-Footnotes,  Up: Invoking Requests
+
+   (1) In compatibility mode, a space is not necessary after a request
+or macro name of two characters' length.  Also, Plan 9 'troff' allows
+tabs to separate arguments.
+
+&#x1f;
+File: groff.info,  Node: Calling Macros,  Next: Using Escape Sequences,  Prev: Invoking Requests,  Up: Formatter Instructions
+
+5.6.3 Calling Macros
+--------------------
+
+If a macro of the desired name does not exist when called, it is
+created, assigned an empty definition, and a warning in category 'mac'
+is emitted.  Calling an undefined macro _does_ end a macro definition
+naming it as its end macro (*note Writing Macros::).
+
+   To embed spaces _within_ a macro argument, enclose the argument in
+neutral double quotes '"'.  Horizontal motion escape sequences are
+sometimes a better choice for arguments to be formatted as text.
+
+   Consider calls to a hypothetical section heading macro 'uh'.
+
+     .uh The Mouse Problem
+     .uh "The Mouse Problem"
+     .uh The\~Mouse\~Problem
+     .uh The\ Mouse\ Problem
+
+The first line calls 'uh' with three arguments: 'The', 'Mouse', and
+'Problem'.  The remainder call the 'uh' macro with one argument, 'The
+Mouse Problem'.  The last solution, using escaped spaces, can be found
+in documents prepared for AT&T 'troff'.  It can cause surprise when text
+is adjusted, because '\<SP>' inserts a _fixed-width_, non-breaking
+space.  GNU 'troff''s '\~' escape sequence inserts an adjustable,
+non-breaking space.(1)  (*note Calling Macros-Footnote-1::)
+
+   The foregoing raises the question of how to embed neutral double
+quotes or backslashes in macro arguments when _those_ characters are
+desired as literals.  In GNU 'troff', the special character escape
+sequence '\rs' produces a backslash and '\dq' a neutral double
+quote.
+
+   In GNU 'troff''s AT&T compatibility mode, these characters remain
+available as '\(rs' and '\(dq', respectively.  AT&T 'troff' did not
+consistently define these special characters, but its descendants can be
+made to support them.  *Note Device and Font Description Files::.
+
+   If even that is not feasible, options remain.  To obtain a literal
+escape character in a macro argument, you can simply type it if you
+change or disable the escape character first.  *Note Using Escape
+Sequences::.  Otherwise, you must escape the escape character repeatedly
+to a context-dependent extent.  *Note Copy Mode::.
+
+   For the (neutral) double quote, you have recourse to an obscure
+syntactical feature of AT&T 'troff'.  Because a double quote can begin a
+macro argument, the formatter keeps track of whether the current
+argument was started thus, and doesn't require a space after the double
+quote that ends it.(2)  (*note Calling Macros-Footnote-2::) In the
+argument list to a macro, a double quote that _isn't_ preceded by a
+space _doesn't_ start a macro argument.  If not preceded by a double
+quote that began an argument, this double quote becomes part of the
+argument.  Furthermore, within a quoted argument, a pair of adjacent
+double quotes becomes a literal double quote.
+
+     .de eq
+     .  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+     .  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+     .. \" 4 backslashes on the next line
+     .eq a" "b c" "de"f\\\\g" h""i "j""k"
+         error-> arg1:a" arg2:b c arg3:de
+         error-> arg4:f\g" arg5:h""i arg6:j"k
+
+   Apart from the complexity of the rules, this traditional solution has
+the disadvantage that double quotes don't survive repeated argument
+expansion in AT&T 'troff' or GNU 'troff''s compatibility mode.  This can
+frustrate efforts to pass such arguments intact through multiple macro
+calls.
+
+     .cp 1
+     .de eq
+     .  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+     .  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+     ..
+     .de xe
+     .  eq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6
+     .. \" 8 backslashes on the next line
+     .xe a" "b c" "de"f\\\\\\\\g" h""i "j""k"
+         error-> arg1:a" arg2:b arg3:c
+         error-> arg4:de arg5:f\g" arg6:h""i
+
+   Outside of compatibility mode, GNU 'troff' doesn't exhibit this
+problem because it tracks the nesting depth of interpolations.  *Note
+Implementation Differences::.
+
+&#x1f;
+File: groff.info,  Node: Calling Macros-Footnotes,  Up: Calling Macros
+
+   (1) '\~' is fairly portable; see *note Other Differences::.
+
+   (2) Strictly, you can neglect to close the last quoted macro
+argument, relying on the end of the control line to do so.  We consider
+this lethargic practice poor style.
+
+&#x1f;
+File: groff.info,  Node: Using Escape Sequences,  Next: Delimiters,  Prev: Calling Macros,  Up: Formatter Instructions
+
+5.6.4 Using Escape Sequences
+----------------------------
+
+Whereas requests must occur on control lines, escape sequences can occur
+intermixed with text and may appear in arguments to requests, macros,
+and other escape sequences.  An escape sequence is introduced by the
+escape character, a backslash '\' (but see the 'ec' request below).  The
+next character selects the escape's function.
+
+   Escape sequences vary in length.  Some take an argument, and of
+those, some have different syntactical forms for a one-character,
+two-character, or arbitrary-length argument.  Others accept _only_ an
+arbitrary-length argument.  In the former scheme, a one-character
+argument follows the function character immediately, an opening
+parenthesis '(' introduces a two-character argument (no closing
+parenthesis is used), and an argument of arbitrary length is enclosed in
+brackets ''.  In the latter scheme, the user selects a delimiter
+character.  A few escape sequences are idiosyncratic, and support both
+of the foregoing conventions ('\s'), designate their own termination
+sequence ('\?'), consume input until the next newline ('\!', '\"',
+'\#'), or support an additional modifier character ('\s' again, and
+'\n').  As with requests, use of some escape sequences in source
+documents may interact poorly with a macro package you use; consult its
+documentation to learn of "safe" sequences or alternative facilities it
+provides to achieve the desired result.
+
+   If an escape character is followed by a character that does not
+identify a defined operation, the escape character is ignored (producing
+a diagnostic of the 'escape' warning category, which is not enabled by
+default) and the following character is processed normally.
+
+     $ groff -Tps -ww
+     .nr N 12
+     .ds co white
+     .ds animal elephant
+     I have \fI\nN \*(co \*animals,\f
+     said \P.\&\~Pseudo Pachyderm.
+         error-> warning: escape character ignored before 'P'
+         => I have 12 white elephants, said P. Pseudo Pachyderm.
+
+   Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.  This rule affords flexibility in
+using escape sequences to construct parameters to other escape
+sequences.
+
+     .ds family C\" Courier
+     .ds style I\" oblique
+     Choice a typeface \f(\*family\*stylewisely.
+         => Choose a typeface wisely.
+
+In the above, the syntax form '\f(' accepts only two characters for an
+argument; the example works because the subsequent escape sequences are
+interpolated before the selection escape sequence argument is processed,
+and strings 'family' and 'style' interpolate one character each.(1)
+(*note Using Escape Sequences-Footnote-1::)
+
+   The escape character is nearly always interpreted when encountered;
+it is therefore desirable to have a way to interpolate it, disable it,
+or change it.
+
+ -- Escape sequence: \e
+     Interpolate the escape character.
+
+   The '\rs' special character escape sequence formats a backslash
+glyph.  In macro and string definitions, the input sequences '\\' and
+'\E' defer interpretation of escape sequences.  *Note Copy Mode::.
+
+ -- Request: .eo
+     Disable the escape mechanism except in copy mode.  Once this
+     request is invoked, no input character is recognized as starting an
+     escape sequence in interpretation mode.
+
+ -- Request: .ec o
+     Recognize the ordinary character O as the escape character.  If O
+     is absent or invalid, the default escape character '\' is selected.
+
+   Switching escape sequence interpretation off to define a macro and
+back on afterward can obviate the need to double the escape character
+within the definition.  *Note Writing Macros::.  This technique is not
+available if your macro needs to interpolate values at the time it is
+_defined_--but many do not.
+
+     .\" simplified `BR` macro from the man(7) macro package
+     .eo
+     .de BR
+     .  ds result \&
+     .  while (\n.$ >= 2) \{\
+     .    as result \fB\$1\fR\$2\"
+     .    shift 2
+     .  \}
+     .  if \n.$ .as result \fB\$1\"
+     \*result
+     .  rm result
+     .  ft R
+     ..
+     .ec
+
+ -- Request: .ecs
+ -- Request: .ecr
+     The 'ecs' request stores the escape character for recall with
+     'ecr'.  'ecr' sets the escape character to '\' if none has been
+     saved.
+
+     Use these requests together to temporarily change the escape
+     character.
+
+   Using a different escape character, or disabling it, when calling
+macros not under your control will likely cause errors, since GNU
+'troff' has no mechanism to "intern" macros--that is, to convert a macro
+definition into a form independent of its representation.(2)  (*note
+Using Escape Sequences-Footnote-2::) When a macro is called, its
+contents are interpreted literally.
+
+&#x1f;
+File: groff.info,  Node: Using Escape Sequences-Footnotes,  Up: Using Escape Sequences
+
+   (1) The omission of spaces before the comment escape sequences is
+necessary; see *note Strings::.
+
+   (2) TeX does have such a mechanism.
+
+&#x1f;
+File: groff.info,  Node: Delimiters,  Prev: Using Escape Sequences,  Up: Formatter Instructions
+
+5.6.5 Delimiters
+----------------
+
+Some escape sequences that require parameters use delimiters.  The
+neutral apostrophe ''' is a popular choice and shown in this document.
+The neutral double quote '"' is also commonly seen.  Letters, numerals,
+and leaders can be used.  Punctuation characters are likely better
+choices, except for those defined as infix operators in numeric
+expressions; see below.
+
+     \l'1.5i\bu' \" draw 1.5 inches of bullet glyphs
+
+   The following escape sequences don't take arguments and thus are
+allowed as delimiters: '\<SP>', '\%', '\|', '\^', '\{', '\}', '\'',
+'\`', '\-', '\_', '\!', '\?', '\)', '\/', '\,', '\&', '\:', '\~', '\0',
+'\a', '\c', '\d', '\e', '\E', '\p', '\r', '\t', and '\u'.  However,
+using them this way is discouraged; they can make the input confusing to
+read.
+
+   A few escape sequences, '\A', '\b', '\o', '\w', '\X', and '\Z',
+accept a newline as a delimiter.  Newlines that serve as delimiters
+continue to be recognized as input line terminators.
+
+     A caf\o
+     e\(aa
+     in Paris
+         => A café in Paris
+
+Use of newlines as delimiters in escape sequences is also discouraged.
+
+   Finally, the escape sequences '\D', '\h', '\H', '\l', '\L', '\N',
+'\R', '\s', '\S', '\v', and '\x' prohibit many delimiters.
+
+   * the numerals '0'-'9' and the decimal point '.'
+
+   * the (single-character) operators '+-/*%<>=&:()'
+
+   * the space and tab characters
+
+   * any escape sequences other than '\%', '\:', '\{', '\}', '\'', '\`',
+     '\-', '\_', '\!', '\/', '\c', '\e', and '\p'
+
+   Delimiter syntax is complex and flexible primarily for historical
+reasons; the foregoing restrictions need be kept in mind mainly when
+using 'groff' in AT&T compatibility mode.  GNU 'troff' keeps track of
+the nesting depth of escape sequence interpolations, so the only
+characters you need to avoid using as delimiters are those that appear
+in the arguments you input, not any that result from interpolation.
+Typically, ''' works fine.  *Note Implementation Differences::.
+
+     $ groff -Tps
+     .de Mw
+     .  nr wd \w'\\$1'
+     .  tm "\\$1" is \\n(wd units wide.
+     ..
+     .Mw Wet'suwet'en
+     .Mw Wet+200i
+     .cp 1 \" turn on compatibility mode
+     .Mw Wet'suwet'en
+     .Mw Wet'
+     .Mw Wet+200i
+         error-> "Wet'suwet'en" is 54740 units wide.
+         error-> "Wet'+200i" is 42610 units wide.
+         error-> "Wet'suwet'en" is 15860 units wide.
+         error-> "Wet'" is 15860 units wide.
+         error-> "Wet'+200i" is 14415860 units wide.
+
+   We see here that in compatibility mode, the part of the argument
+after the ''' delimiter escapes from its context and, if nefariously
+crafted, influences the computation of the WD register's value in a
+surprising way.
+
+&#x1f;
+File: groff.info,  Node: Comments,  Next: Registers,  Prev: Formatter Instructions,  Up: GNU troff Reference
+
+5.7 Comments
+============
+
+One of the most common forms of escape sequence is the comment.(1)
+(*note Comments-Footnote-1::)
+
+ -- Escape sequence: \"
+     Start a comment.  Everything up to the next newline is ignored.
+
+     This may sound simple, but it can be tricky to keep the comments
+     from interfering with the appearance of the output.  If the escape
+     sequence is to the right of some text or a request, that portion of
+     the line is ignored, but spaces preceding it are processed normally
+     by GNU 'troff'.  This affects only the 'ds' and 'as' requests and
+     their variants.
+
+     One possibly irritating idiosyncrasy is that tabs should not be
+     used to vertically align comments in the source document.  Tab
+     characters are not treated as separators between a request name and
+     its first argument, nor between arguments.
+
+     A comment on a line by itself is treated as a blank line, because
+     after eliminating the comment, that is all that remains.
+
+          Test
+          \" comment
+          Test
+              => Test
+              =>
+              => Test
+
+     To avoid this, it is common to combine the empty request with the
+     comment escape sequence as '.\"', causing the input line to be
+     ignored.
+
+     Another commenting scheme sometimes seen is three consecutive
+     single quotes (''''') at the beginning of a line.  This works, but
+     GNU 'troff' emits a warning diagnostic (if enabled) about an
+     undefined macro (namely '''').
+
+ -- Escape sequence: \#
+     Start a comment; everything up to and including the next newline is
+     ignored.  This 'groff' extension was introduced to avoid the
+     problems described above.
+
+          Test
+          \# comment
+          Test
+              => Test Test
+
+ -- Request: .ig end
+     Ignore input until, in the current conditional block (if any),(2)
+     (*note Comments-Footnote-2::) the macro END is called at the start
+     of a control line, or the control line '..' is encountered if END
+     is not specified.  'ig' is parsed as if it were a macro definition,
+     but its contents are discarded, not stored.(3)  (*note
+     Comments-Footnote-3::)
+
+          hand\c
+          .de TX
+          fasting
+          ..
+          .ig TX
+          This is part of a large block of input that has been
+          temporarily(?) commented out.
+          We can restore it simply by removing the .ig request and
+          the call of its end macro.
+          .TX
+              => handfasting
+
+&#x1f;
+File: groff.info,  Node: Comments-Footnotes,  Up: Comments
+
+   (1) This claim may be more aspirational than descriptive.
+
+   (2) *Note Conditional Blocks::.
+
+   (3) Exception: auto-incrementing registers defined outside the
+ignored region _will_ be modified if interpolated with '\n±' inside it.
+*Note Auto-increment::.
+
+&#x1f;
+File: groff.info,  Node: Registers,  Next: Manipulating Filling and Adjustment,  Prev: Formatter Instructions,  Up: GNU troff Reference
+
+5.8 Registers
+=============
+
+In the 'roff' language, numbers can be stored in "registers".  Many
+built-in registers exist, supplying anything from the date to details of
+formatting parameters.  You can also define your own.  *Note
+Identifiers::, for information on constructing a valid name for a
+register.
+
+* Menu:
+
+* Setting Registers::
+* Interpolating Registers::
+* Auto-increment::
+* Assigning Register Formats::
+* Built-in Registers::
+
+&#x1f;
+File: groff.info,  Node: Setting Registers,  Next: Interpolating Registers,  Prev: Registers,  Up: Registers
+
+5.8.1 Setting Registers
+-----------------------
+
+Define registers and update their values with the 'nr' request or the
+'\R' escape sequence.
+
+ -- Request: .nr ident value
+ -- Escape sequence: \R'ident value'
+     Set register IDENT to VALUE.  If IDENT doesn't exist, GNU 'troff'
+     creates it.  In the '\R' escape sequence, the delimiter need not be
+     a neutral apostrophe; see *note Delimiters::.  It also does not
+     produce an input token in GNU 'troff'.  *Note Gtroff Internals::.
+
+          .nr a (((17 + (3 * 4))) % 4)
+          \na
+          .\R'a (((17 + (3 * 4))) % 4)'
+          \na
+              => 1 1
+
+     (Later, we will discuss additional forms of 'nr' and '\R' that can
+     change a register's value after it is dereferenced but before it is
+     interpolated.  *Note Auto-increment::.)
+
+     The complete transparency of '\R' can cause surprising effects if
+     you use registers like '.k', which get evaluated at the time they
+     are accessed.
+
+          .ll 1.6i
+          .
+          aaa bbb ccc ddd eee fff ggg hhh\R':k \n.k'
+          .tm :k == \n:k
+              => :k == 126950
+          .
+          .br
+          .
+          aaa bbb ccc ddd eee fff ggg hhh\h'0'\R':k \n.k'
+          .tm :k == \n:k
+              => :k == 15000
+
+     If you process this with the PostScript device ('-Tps'), there will
+     be a line break eventually after 'ggg' in both input lines.
+     However, after processing the space after 'ggg', the partially
+     collected line is not overfull yet, so GNU 'troff' continues to
+     collect input until it sees the space (or in this case, the
+     newline) after 'hhh'.  At this point, the line is longer than the
+     line length, and the line gets broken.
+
+     In the first input line, since the '\R' escape sequence leaves no
+     traces, the check for the overfull line hasn't been done yet at the
+     point where '\R' gets handled, and you get a value for the '.k'
+     register that is even greater than the current line length.
+
+     In the second input line, the insertion of '\h'0'' to cause a
+     zero-width motion forces GNU 'troff' to check the line length,
+     which in turn causes the start of a new output line.  Now '.k'
+     returns the expected value.
+
+   'nr' and '\R' each have two additional special forms to increment or
+decrement a register.
+
+ -- Request: .nr ident +value
+ -- Request: .nr ident -value
+ -- Escape sequence: \R'ident +value'
+ -- Escape sequence: \R'ident -value'
+     Increment (decrement) register IDENT by VALUE.  In the '\R' escape
+     sequence, the delimiter need not be a neutral apostrophe; see *note
+     Delimiters::.
+
+          .nr a 1
+          .nr a +1
+          \na
+              => 2
+
+     A leading minus sign in VALUE is always interpreted as a
+     decrementation operator, not an algebraic sign.  To assign a
+     register a negative value or the negated value of another register,
+     you can force GNU 'troff' to interpret '-' as a negation or minus,
+     rather than decrementation, operator: enclose it with its operand
+     in parentheses or subtract it from zero.
+
+          .nr a 7
+          .nr b 3
+          .nr a -\nb
+          \na
+              => 4
+          .nr a (-\nb)
+          \na
+              => -3
+          .nr a 0-\nb
+          \na
+              => -3
+
+     If a register's prior value does not exist (the register was
+     undefined), an increment or decrement is applied as if to 0.
+
+ -- Request: .rr ident
+     Remove register IDENT.  If IDENT doesn't exist, the request is
+     ignored.  Technically, only the name is removed; the register's
+     contents are still accessible under aliases created with 'aln', if
+     any.
+
+ -- Request: .rnn ident1 ident2
+     Rename register IDENT1 to IDENT2.  If IDENT1 doesn't exist, the
+     request is ignored.  Renaming a built-in register does not
+     otherwise alter its properties.
+
+ -- Request: .aln new old
+     Create an alias NEW for an existing register OLD, causing the names
+     to refer to the same stored object.  If OLD is undefined, a warning
+     in category 'reg' is produced and the request is ignored.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.
+
+     To remove a register alias, invoke 'rr' on its name.  A register's
+     contents do not become inaccessible until it has no more names.
+
+&#x1f;
+File: groff.info,  Node: Interpolating Registers,  Next: Auto-increment,  Prev: Setting Registers,  Up: Registers
+
+5.8.2 Interpolating Registers
+-----------------------------
+
+Register contents are interpolated with the '\n' escape sequence.
+
+ -- Escape sequence: \ni
+ -- Escape sequence: \n(id
+ -- Escape sequence: \nident
+     Interpolate register with name IDENT (one-character name I,
+     two-character name ID).  '\n' is interpreted even in copy mode
+     (*note Copy Mode::).  If the register is undefined, it is created
+     and assigned a value of '0', that value is interpolated, and a
+     warning in category 'reg' is emitted.  *Note Warnings::, for
+     information about the enablement and suppression of warnings.
+
+          .nr a 5
+          .nr as \na+\na
+          \n(as
+              => 10
+
+          .nr a1 5
+          .nr ab 6
+          .ds str b
+          .ds num 1
+          \na\nnum
+              => 5
+          \na\*str
+              => 6
+
+&#x1f;
+File: groff.info,  Node: Auto-increment,  Next: Assigning Register Formats,  Prev: Interpolating Registers,  Up: Registers
+
+5.8.3 Auto-increment
+--------------------
+
+Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.  The value of the increment is
+specified with a third argument to the 'nr' request, and a special
+interpolation syntax is used to alter and then retrieve the register's
+value.  Together, these features are called "auto-increment".(1)  (*note
+Auto-increment-Footnote-1::)
+
+ -- Request: .nr ident value incr
+     Set register IDENT to VALUE and its auto-incrementation amount to
+     to INCR.  The '\R' escape sequence doesn't support an INCR
+     argument.
+
+   Auto-incrementation is not _completely_ automatic; the '\n' escape
+sequence in its basic form never alters the value of a register.  To
+apply auto-incrementation to a register, interpolate it with '\n±'.
+
+ -- Escape sequence: \n+i
+ -- Escape sequence: \n-i
+ -- Escape sequence: \n+(id
+ -- Escape sequence: \n-(id
+ -- Escape sequence: \n+ident
+ -- Escape sequence: \n-ident
+     Increment or decrement IDENT (one-character name I, two-character
+     name ID) by the register's auto-incrementation value and then
+     interpolate the new register value.  If IDENT has no
+     auto-incrementation value, interpolate as with '\n'.
+
+     .nr a 0 1
+     .nr xx 0 5
+     .nr foo 0 -2
+     \n+a, \n+a, \n+a, \n+a, \n+a
+     .br
+     \n-(xx, \n-(xx, \n-(xx, \n-(xx, \n-(xx
+     .br
+     \n+foo, \n+foo, \n+foo, \n+foo, \n+foo
+         => 1, 2, 3, 4, 5
+         => -5, -10, -15, -20, -25
+         => -2, -4, -6, -8, -10
+
+   To change the increment value without changing the value of a
+register, assign the register's value to itself by interpolating it, and
+specify the desired increment normally.  Apply an increment of '0' to
+disable auto-incrementation of the register.
+
+&#x1f;
+File: groff.info,  Node: Auto-increment-Footnotes,  Up: Auto-increment
+
+   (1) A negative auto-increment can be considered an "auto-decrement".
+
+&#x1f;
+File: groff.info,  Node: Assigning Register Formats,  Next: Built-in Registers,  Prev: Auto-increment,  Up: Registers
+
+5.8.4 Assigning Register Formats
+--------------------------------
+
+A writable register's value can be interpolated in several number
+formats.  By default, conventional Arabic numerals are used.  Other
+formats see use in sectioning and outlining schemes and alternative page
+numbering arrangements.
+
+ -- Request: .af reg fmt
+     Use number format FMT when interpolating register REG.  Valid
+     number formats are as follows.
+
+     '0...'
+          Arabic numerals 0, 1, 2, and so on.  Any decimal digit is
+          equivalent to '0'; the formatter merely counts the digits
+          specified.  Multiple Arabic numerals in FMT cause
+          interpolations to be zero-padded on the left if necessary to
+          at least as many digits as specified (interpolations never
+          truncate a register value).  A register with format '00'
+          interpolates values 1, 2, 3 as '01', '02', '03'.  The default
+          format for all writable registers is '0'.
+
+     'I'
+          Uppercase Roman numerals: 0, I, II, III, IV, ...
+
+     'i'
+          Lowercase Roman numerals: 0, i, ii, iii, iv, ...
+
+     'A'
+          Uppercase letters: 0, A, B, C, ..., Z, AA, AB, ...
+
+     'a'
+          Lowercase letters: 0, a, b, c, ..., z, aa, ab, ...
+
+     Omitting FMT causes a warning in category 'missing'.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.  Specifying an unrecognized format is an error.
+
+     Zero values are interpolated as '0' in non-Arabic formats.
+     Negative quantities are prefixed with '-' irrespective of format.
+     In Arabic formats, the sign supplements the field width.  If REG
+     doesn't exist, it is created with a zero value.
+
+          .nr a 10
+          .af a 0           \" the default format
+          \na,
+          .af a I
+          \na,
+          .af a 321
+          .nr a (-\na)
+          \na,
+          .af a a
+          \na
+              => 10, X, -010, -j
+
+     The representable extrema in the 'i' and 'I' formats correspond to
+     Arabic ±39,999.  GNU 'troff' uses 'w' and 'z' to represent 5,000
+     and 10,000 in Roman numerals, respectively, following the
+     convention of AT&T 'troff'--currently, the correct glyphs for Roman
+     numerals five thousand ('U+2181') and ten thousand ('U+2182') are
+     not used.
+
+     Assigning the format of a read-only register is an error.  Instead,
+     copy the read-only register's value to, and assign the format of, a
+     writable register.
+
+ -- Escape sequence: \gr
+ -- Escape sequence: \g(rg
+ -- Escape sequence: \greg
+     Interpolate the format of the register REG (one-character name R,
+     two-character name RG).  Zeroes represent Arabic formats.  If REG
+     is not defined, REG is not created and nothing is interpolated.
+     '\g' is interpreted even in copy mode (*note Copy Mode::).
+
+   GNU 'troff' interprets only Arabic numerals.  The Roman numeral or
+alphabetic formats cannot be used as operands to arithmetic operators in
+expressions (*note Numeric Expressions::).  For instance, it may be
+desirable to test the page number independently of its format.
+
+     .af % i \" front matter
+     .de header-trap
+     .  \" To test the page number, we need it in Arabic.
+     .  ds saved-page-number-format \\g%\"
+     .  af % 0
+     .  nr page-number-in-decimal \\n%
+     .  af % \\*saved-page-number-format
+     .  ie \\npage-number-in-decimal=1 .do-first-page-stuff
+     .  el \{\
+     .    ie o .do-odd-numbered-page-stuff
+     .    el   .do-even-numbered-page-stuff
+     .  \}
+     .  rm saved-page-number-format
+     ..
+     .wh 0 header-trap
+
+&#x1f;
+File: groff.info,  Node: Built-in Registers,  Prev: Assigning Register Formats,  Up: Registers
+
+5.8.5 Built-in Registers
+------------------------
+
+Predefined registers whose identifiers start with a dot are read-only.
+Many are Boolean-valued, interpolating a true or false value testable
+with the 'if', 'ie', or 'while' requests.  Some read-only registers are
+string-valued, meaning that they interpolate text.
+
+   *Caution:* Built-in registers are subject to removal like others;
+once removed, they can be recreated only as normal writable registers
+and will not reflect formatter state.
+
+   A register name (without the dot) is often associated with a request
+of the same name.  A complete listing of all built-in registers can be
+found in *note Register Index::.
+
+   We present here a few built-in registers that are not described
+elsewhere in this manual; they have to do with invariant properties of
+GNU 'troff', or obtain information about the formatter's command-line
+options, processing progress, or the operating environment.
+
+'\n.A'
+     Approximate output is being formatted (Boolean-valued); see 'groff'
+     '-a' option (*note Groff Options::).
+
+'\n.c'
+'\nc.'
+     Input line number.  'c.' is a writable synonym, affecting
+     subsequent interpolations of both '.c' and 'c.'.
+
+'\n.F'
+     Name of input file (string-valued).
+
+'\n.g'
+     Always true in GNU 'troff' (Boolean-valued).  Documents can use
+     this to ask the formatter if it claims 'groff' compatibility.
+
+'\n.P'
+     Output page selection status (Boolean-valued); see 'groff' '-o'
+     option (*note Groff Options::).
+
+'\n.R'
+     Count of available unused registers; always 10,000 in GNU
+     'troff'.(1)  (*note Built-in Registers-Footnote-1::)
+
+'\n.T'
+     Indicator of output device selection (Boolean-valued); see 'groff'
+     '-T' option (*note Groff Options::).
+
+'\n.U'
+     Unsafe mode enablement status (Boolean-valued); see 'groff' '-U'
+     option (*note Groff Options::).
+
+'\n.x'
+     Major version number of the running GNU 'troff' formatter.  For
+     example, if the version number is 1.23.0, then '.x' contains '1'.
+
+'\n.y'
+     Minor version number of the running GNU 'troff' formatter.  For
+     example, if the version number is 1.23.0, then '.y' contains '23'.
+
+'\n.Y'
+     Revision number of the running GNU 'troff' formatter.  For example,
+     if the version number is 1.23.0, then '.Y' contains '0'.
+
+'\n$$'
+     Process identifier (PID) of the GNU 'troff' program in its
+     operating environment.
+
+   Date- and time-related registers are set per the local time as
+determined by 'localtime(3)' when the formatter launches.  This
+initialization can be overridden by 'SOURCE_DATE_EPOCH' and 'TZ'; see
+*note Environment::.
+
+'\nseconds'
+     Count of seconds elapsed in the minute (0-60).
+
+'\nminutes'
+     Count of minutes elapsed in the hour (0-59).
+
+'\nhours'
+     Count of hours elapsed since midnight (0-23).
+
+'\ndw'
+     Day of the week (1-7; 1 is Sunday).
+
+'\ndy'
+     Day of the month (1-31).
+
+'\nmo'
+     Month of the year (1-12).
+
+'\nyear'
+     Gregorian year.
+
+'\nyr'
+     Gregorian year minus 1900.  This register is incorrectly documented
+     in the AT&T 'troff' manual as storing the last two digits of the
+     current year.  That claim stopped being true in 2000.  Old 'troff'
+     input that looks like:
+
+          '\" The year number is a surprise after 1999.
+          This document was formatted in 19\n(yr.
+
+     can be corrected to:
+
+          This document was formatted in \nyear.
+
+     or, for portability across many 'roff' programs, to the following.
+
+          .nr y4 1900+\n(yr
+          This document was formatted in \n(y4.
+
+&#x1f;
+File: groff.info,  Node: Built-in Registers-Footnotes,  Up: Built-in Registers
+
+   (1) GNU 'troff' dynamically allocates memory for as many registers as
+required.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Filling and Adjustment,  Next: Manipulating Hyphenation,  Prev: Registers,  Up: GNU troff Reference
+
+5.9 Manipulating Filling and Adjustment
+=======================================
+
+When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in *note Breaking::.
+The 'br' request likewise causes a break.  Several other requests imply
+breaks: 'bp', 'ce', 'cf', 'fi', 'fl', 'in', 'nf', 'rj', 'sp', 'ti', and
+'trf'.  If the no-break control character is used with any of these
+requests, GNU 'troff' suppresses the break; instead the requested
+operation takes effect at the next break.  ''br' does nothing.
+
+     .ll 55n
+     This line is normally filled and adjusted.
+     .br
+     A line's alignment is decided
+     'ce \" Center the next input line (no break).
+     when it is output.
+     This line returns to normal filling and adjustment.
+         => This line is normally filled and adjusted.
+         =>    A line's alignment is decided when it is output.
+         => This line returns to normal filling and adjustment.
+
+Output line properties like page offset, indentation, adjustment, and
+even the location of its text baseline, are not determined until the
+line has been broken.  An output line is said to be "pending" if some
+input has been collected but an output line corresponding to it has not
+yet been written; such an output line is also termed "partially
+collected".  If no output line is pending, it is as if a break has
+already happened; additional breaks, whether explicit or implicit, have
+no effect.  If the vertical drawing position is negative--as it is when
+the formatter starts up--a break starts a new page (even if no output
+line is pending) unless an end-of-input macro is being interpreted.
+*Note End-of-input Traps::.
+
+ -- Request: .br
+     Break the line: emit any pending output line without adjustment.
+
+          foo bar
+          .br
+          baz
+          'br
+          qux
+              => foo bar
+              => baz qux
+
+   Sometimes you want to prevent a break within a phrase or between a
+quantity and its units.
+
+ -- Escape sequence: \~
+     Insert an unbreakable space that is adjustable like an ordinary
+     space.  It is discarded from the end of an output line if a break
+     is forced.
+
+          Set the output speed to\~1.
+          There are 1,024\~bytes in 1\~KiB.
+          J.\~F.\~Ossanna wrote the original CSTR\~#54.
+
+   By default, GNU 'troff' fills text and adjusts it to reach the output
+line length.  The 'nf' request disables filling; the 'fi' request
+reënables it.
+
+ -- Request: .fi
+ -- Register: \n.u
+     Enable filling of output lines; a pending output line is broken.
+     The read-only register '.u' is set to 1.  The filling enablement
+     status, sometimes called "fill mode", is associated with the
+     environment (*note Environments::).  *Note Line Continuation::, for
+     interaction with the '\c' escape sequence.
+
+ -- Request: .nf
+     Disable filling of output lines: the output line length (*note Line
+     Layout::) is ignored and output lines are broken where the input
+     lines are.  A pending output line is broken and adjustment is
+     suppressed.  The read-only register '.u' is set to 0.  The filling
+     enablement status is associated with the environment (*note
+     Environments::).  See *note Line Continuation::, for interaction
+     with the '\c' escape sequence.
+
+ -- Request: .ad mode
+ -- Register: \n.j
+     Enable output line adjustment in MODE, taking effect when the
+     pending (or next) output line is broken.  Adjustment is suppressed
+     when filling is.  MODE can have one of the following values.
+
+     'b'
+     'n'
+          Adjust "normally": if the output line does not consume the
+          distance between the indentation and the configured output
+          line length, GNU 'troff' stretches adjustable spaces within
+          the line until that length is reached.  When the indentation
+          is zero, this mode spreads the line to both the left and right
+          margins.  This is the GNU 'troff' default.
+
+     'c'
+          Center filled text.  Contrast with the 'ce' request, which
+          centers text _without_ filling it.
+
+     'l'
+          Align text to the left without adjusting it.
+
+     'r'
+          Align text to the right without adjusting it.
+
+     MODE can also be a value previously stored in the '.j' register.
+     Using 'ad' without an argument is the same as '.ad \n.j'; unless
+     filling is disabled, GNU 'troff' resumes adjusting lines in the
+     same way it did before adjustment was disabled by invocation of the
+     'na' request.
+
+     The adjustment mode and enablement status are encoded in the
+     read-only register '.j'.  These parameters are associated with the
+     environment (*note Environments::).
+
+     The value of '.j' for any adjustment mode is an implementation
+     detail and should not be relied upon as a programmer's interface.
+     Do not write logic to interpret or perform arithmetic on it.
+
+          .ll 48n
+          .de AD
+          .  br
+          .  ad \\$1
+          ..
+          .de NA
+          .  br
+          .  na
+          ..
+          left
+          .AD r
+          .nr ad \n(.j
+          right
+          .AD c
+          center
+          .NA
+          left
+          .AD
+          center
+          .AD \n(ad
+          right
+              => left
+              =>                                            right
+              =>                      center
+              => left
+              =>                      center
+              =>                                            right
+
+ -- Request: .na
+     Disable output line adjustment.  This produces the same output as
+     left-alignment, but the value of the adjustment mode register '.j'
+     is altered differently.  The adjustment mode and enablement status
+     are associated with the environment (*note Environments::).
+
+ -- Request: .brp
+ -- Escape sequence: \p
+     Break, adjusting the line per the current adjustment mode.  '\p'
+     schedules a break with adjustment at the next word boundary.  The
+     escape sequence is itself neither a break nor a space of any kind;
+     it can thus be placed in the middle of a word to cause a break at
+     the end of that word.
+
+     Breaking with immediate adjustment can produce ugly results since
+     GNU 'troff' doesn't have a sophisticated paragraph-building
+     algorithm, as TeX has, for example.  Instead, GNU 'troff' fills and
+     adjusts a paragraph line by line.
+
+          .ll 4.5i
+          This is an uninteresting sentence.
+          This is an uninteresting sentence.\p
+          This is an uninteresting sentence.
+
+     is formatted as follows.
+
+          This  is  an uninteresting sentence.  This is
+          an          uninteresting           sentence.
+          This is an uninteresting sentence.
+
+   To clearly present the next couple of requests, we must introduce the
+concept of "productive" input lines.  A "productive input line" is one
+that directly produces formatted output.  Text lines produce output,(1)
+(*note Manipulating Filling and Adjustment-Footnote-1::) as do control
+lines containing requests like 'tl' or escape sequences like '\D'.
+Macro calls are not _directly_ productive, and thus not counted, but
+their interpolated contents can be.  Empty requests, and requests and
+escape sequences that define registers or strings or alter the
+formatting environment (as with changes to the size, face, height,
+slant, or color of the type) are not productive.  We will also preview
+the output line continuation escape sequence, '\c', which "connects" two
+input lines that would otherwise be counted separately.  (2)  (*note
+Manipulating Filling and Adjustment-Footnote-2::)
+
+     .de hello
+     Hello, world!
+     ..
+     .ce \" center output of next productive input line
+     .
+     .nr junk-reg 1
+     .ft I
+     Chorus: \c
+     .ft
+     .hello
+     Went the day well?
+       =>                  Chorus: Hello, world!
+       => Went the day well?
+
+ -- Request: .ce n
+ -- Register: \n.ce
+     Break (unless the no-break control character is used), center the
+     output of the next N productive input lines with respect to the
+     line length and indentation without filling, then break again
+     regardless of the invoking control character.  If the argument is
+     not positive, centering is disabled.  Omitting the argument implies
+     an N of '1'.  The count of lines remaining to be centered is stored
+     in the read-only register '.ce' and is associated with the
+     environment (*note Environments::).
+
+     While the '.ad c' request also centers text, it fills the text as
+     well.
+
+          .de FR
+          This is a small text fragment that shows the differences
+          between the `.ce' and the `.ad c' requests.
+          ..
+          .ll 4i
+          .ce 1000
+          .FR
+          .ce 0
+
+          .ad c
+          .FR
+              => This is a small text fragment that shows
+              =>              the differences
+              => between the `.ce' and the `.ad c' requests.
+              =>
+              => This is a small text fragment that shows
+              =>  the differences between the `.ce' and
+              =>         the `.ad c' requests.
+
+     The previous example illustrates a common idiom of turning
+     centering on for a quantity of lines far in excess of what is
+     required, and off again after the text to be centered.  This
+     technique relieves humans of counting lines for requests that take
+     a count of input lines as an argument.
+
+ -- Request: .rj n
+ -- Register: \n.rj
+     Break (unless the no-break control character is used), align the
+     output of the next N productive input lines to the right margin
+     without filling, then break again regardless of the control
+     character.  If the argument is not positive, right-alignment is
+     disabled.  Omitting the argument implies an N of '1'.  The count of
+     lines remaining to be right-aligned is stored in the read-only
+     register '.rj' and is associated with the environment (*note
+     Environments::).
+
+          .ll 49n
+          .rj 3
+          At first I hoped that such a technically unsound
+          project would collapse but I soon realized it was
+          doomed to success. \em C. A. R. Hoare
+              =>  At first I hoped that such a technically unsound
+              => project would collapse but I soon realized it was
+              =>              doomed to success. -- C. A. R. Hoare
+
+ -- Request: .ss word-space-size additional-sentence-space-size
+ -- Register: \n.ss
+ -- Register: \n.sss
+     Set the sizes of spaces between words and sentences(3) (*note
+     Manipulating Filling and Adjustment-Footnote-3::) in twelfths of
+     font's space width (typically one-fourth to one-third em for
+     Western scripts).  The default for both parameters is 12.  Negative
+     values are erroneous.  The first argument is a minimum; if an
+     output line undergoes adjustment, such spaces may increase in
+     width.  The optional second argument sets the amount of additional
+     space separating sentences on the same output line.  If omitted,
+     this amount is set to WORD-SPACE-SIZE.  The request is ignored if
+     there are no parameters.
+
+     Additional inter-sentence space is used only if the output line is
+     not full when the end of a sentence occurs in the input.  If a
+     sentence ends at the end of an input line, then both an inter-word
+     space and an inter-sentence space are added to the output; if two
+     spaces follow the end of a sentence in the middle of an input line,
+     then the second space becomes an inter-sentence space in the
+     output.  Additional inter-sentence space is not adjusted, but the
+     inter-word space that always precedes it may be.  Further input
+     spaces after the second, if present, are adjusted as normal.
+
+     The read-only registers '.ss' and '.sss' hold the minimal
+     inter-word space and additional inter-sentence space amounts,
+     respectively.  These parameters are part of the environment (*note
+     Environments::), and rounded down to the nearest multiple of 12 on
+     terminals.
+
+     The 'ss' request can insert discardable horizontal space; that is,
+     space that is discarded at a break.  For example, some footnote
+     styles collect the notes into a single paragraph with large gaps
+     between each note.
+
+          .ll 48n
+          1.\~J. Fict. Ch. Soc. 6 (2020), 3\en14.
+          .ss 12 48 \" applies to next sentence ending
+          Reprints no longer available through FCS.
+          .ss 12 \" go back to normal
+          2.\~Better known for other work.
+              => 1.  J.  Fict. Ch. Soc. 6 (2020), 3-14.  Reprints
+              => no longer available through FCS.      2.  Better
+              => known for other work.
+
+     If _undiscardable_ space is required, use the '\h' escape sequence.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Filling and Adjustment-Footnotes,  Up: Manipulating Filling and Adjustment
+
+   (1) unless diverted; see *note Diversions::
+
+   (2) *Note Line Continuation::.
+
+   (3) Recall *note Filling:: and *note Sentences:: for the definitions
+of word and sentence boundaries, respectively.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Hyphenation,  Next: Manipulating Spacing,  Prev: Manipulating Filling and Adjustment,  Up: GNU troff Reference
+
+5.10 Manipulating Hyphenation
+=============================
+
+When filling, GNU 'troff' hyphenates words as needed at user-specified
+and automatically determined hyphenation points.  The machine-driven
+determination of hyphenation points in words requires algorithms and
+data, and is susceptible to conventions and preferences.  Before
+tackling such "automatic hyphenation", let us consider how hyphenation
+points can be set explicitly.
+
+   Explicitly hyphenated words such as "mother-in-law" are eligible for
+breaking after each of their hyphens.  Relatively few words in a
+language offer such obvious break points, however, and automatic
+detection of syllabic (or phonetic) boundaries for hyphenation is not
+perfect,(1) (*note Manipulating Hyphenation-Footnote-1::) particularly
+for unusual words found in technical literature.  We can instruct GNU
+'troff' how to hyphenate specific words if the need arises.
+
+ -- Request: .hw word ...
+     Define each "hyphenation exception" WORD with each hyphen '-' in
+     the word indicating a hyphenation point.  For example, the request
+
+          .hw in-sa-lub-rious alpha
+
+     marks potential hyphenation points in "insalubrious", and prevents
+     "alpha" from being hyphenated at all.
+
+     Besides the space character, any character whose hyphenation code
+     is zero can be used to separate the arguments of 'hw' (see the
+     'hcode' request below).  In addition, this request can be used more
+     than once.
+
+     Hyphenation points specified with 'hw' are not subject to the
+     within-word placement restrictions imposed by the 'hy' request (see
+     below).
+
+     Hyphenation exceptions specified with the 'hw' request are
+     associated with the hyphenation language (see the 'hla' request
+     below) and environment (*note Environments::); invoking the 'hw'
+     request in the absence of a hyphenation language is an error.
+
+     The request is ignored if there are no parameters.
+
+   These are known as hyphenation exceptions in the expectation that
+most users will avail themselves of automatic hyphenation; these
+exceptions override any rules that would normally apply to a word
+matching a hyphenation exception defined with 'hw'.
+
+   Situations also arise when only a specific occurrence of a word needs
+its hyphenation altered or suppressed, or when a URL or similar string
+needs to be breakable in sensible places without hyphenation.
+
+ -- Escape sequence: \%
+ -- Escape sequence: \:
+     To tell GNU 'troff' how to hyphenate words as they occur in input,
+     use the '\%' escape sequence; it is the default "hyphenation
+     character".  Each instance within a word indicates to GNU 'troff'
+     that the word may be hyphenated at that point, while prefixing a
+     word with this escape sequence prevents it from being otherwise
+     hyphenated.  This mechanism affects only that occurrence of the
+     word; to change the hyphenation of a word for the remainder of
+     input processing, use the 'hw' request.
+
+     GNU 'troff' regards the escape sequences '\X' and '\Y' as starting
+     a word; that is, the '\%' escape sequence in, say,
+     '\X'...'\%foobar' or '\Y'...'\%foobar' no longer prevents
+     hyphenation of 'foobar' but inserts a hyphenation point just prior
+     to it; most likely this isn't what you want.  *Note Postprocessor
+     Access::.
+
+     '\:' inserts a non-printing break point; that is, a word can break
+     there, but the soft hyphen glyph (see below) is not written to the
+     output if it does.  This escape sequence is an input word boundary,
+     so the remainder of the word is subject to hyphenation as normal.
+
+     You can combine '\:' and '\%' to control breaking of a file name or
+     URL, or to permit hyphenation only after certain explicit hyphens
+     within a word.
+
+          The \%Lethbridge-Stewart-\:\%Sackville-Baggins divorce
+          was, in retrospect, inevitable once the contents of
+          \%/var/log/\:\%httpd/\:\%access_log on the family web
+          server came to light, revealing visitors from Hogwarts.
+
+ -- Request: .hc char
+     Change the hyphenation character to CHAR.  This character then
+     works as the '\%' escape sequence normally does, and thus no longer
+     appears in the output.(2)  (*note Manipulating
+     Hyphenation-Footnote-2::) Without an argument, 'hc' resets the
+     hyphenation character to '\%' (the default).  The hyphenation
+     character is associated with the environment (*note
+     Environments::).
+
+ -- Request: .shc c
+     Set the "soft hyphen character", inserted when a word is hyphenated
+     automatically or at a hyphenation character, to the ordinary or
+     special character C.(3)  (*note Manipulating
+     Hyphenation-Footnote-3::) If the argument is omitted, the soft
+     hyphen character is set to the default, '\hy'.  If no glyph for C
+     exists in the font in use at a potential hyphenation point, then
+     the line is not broken there.  Neither character definitions
+     (specified with the 'char' and similar requests) nor translations
+     (specified with the 'tr' request) are applied to C.
+
+   Several requests influence automatic hyphenation.  Because
+conventions vary, a variety of hyphenation modes is available to the
+'hy' request; these determine whether hyphenation will apply to a word
+prior to breaking a line at the end of a page (more or less; see below
+for details), and at which positions within that word automatically
+determined hyphenation points are permissible.  The places within a word
+that are eligible for hyphenation are determined by language-specific
+data and lettercase relationships.  Furthermore, hyphenation of a word
+might be suppressed due to a limit on consecutive hyphenated lines
+('hlm'), a minimum line length threshold ('hym'), or because the line
+can instead be adjusted with additional inter-word space ('hys').
+
+ -- Request: .hy mode
+ -- Register: \n.hy
+     Set automatic hyphenation mode to MODE, an integer encoding
+     conditions for hyphenation; if omitted, '1' is implied.  The
+     hyphenation mode is available in the read-only register '.hy'; it
+     is associated with the environment (*note Environments::).  The
+     default hyphenation mode depends on the localization file loaded
+     when GNU 'troff' starts up; see the 'hpf' request below.
+
+     Typesetting practice generally does not avail itself of every
+     opportunity for hyphenation, but the details differ by language and
+     site mandates.  The hyphenation modes of AT&T 'troff' were
+     implemented with English-language publishing practices of the 1970s
+     in mind, not a scrupulous enumeration of conceivable parameters.
+     GNU 'troff' extends those modes such that finer-grained control is
+     possible, favoring compatibility with older implementations over a
+     more intuitive arrangement.  The means of hyphenation mode control
+     is a set of numbers that can be added up to encode the behavior
+     sought.(4)  (*note Manipulating Hyphenation-Footnote-4::) The
+     entries in the following table are termed "values"; the sum of the
+     desired values is the "mode".
+
+     '0'
+          disables hyphenation.
+
+     '1'
+          enables hyphenation except after the first and before the last
+          character of a word.
+
+     The remaining values "imply" 1; that is, they enable hyphenation
+     under the same conditions as '.hy 1', and then apply or lift
+     restrictions relative to that basis.
+
+     '2'
+          disables hyphenation of the last word on a page,(5) (*note
+          Manipulating Hyphenation-Footnote-5::) even for explicitly
+          hyphenated words.
+
+     '4'
+          disables hyphenation before the last two characters of a word.
+
+     '8'
+          disables hyphenation after the first two characters of a word.
+
+     '16'
+          enables hyphenation before the last character of a word.
+
+     '32'
+          enables hyphenation after the first character of a word.
+
+     Apart from value 2, restrictions imposed by the hyphenation mode
+     are _not_ respected for words whose hyphenations have been
+     specified with the hyphenation character ('\%' by default) or the
+     'hw' request.
+
+     Nonzero values in the previous table are additive.  For example,
+     mode 12 causes GNU 'troff' to hyphenate neither the last two nor
+     the first two characters of a word.  Some values cannot be used
+     together because they contradict; for instance, values 4 and 16,
+     and values 8 and 32.  As noted, it is superfluous to add 1 to any
+     non-zero even mode.
+
+     The automatic placement of hyphens in words is determined by
+     "pattern files", which are derived from TeX and available for
+     several languages.  The number of characters at the beginning of a
+     word after which the first hyphenation point should be inserted is
+     determined by the patterns themselves; it can't be reduced further
+     without introducing additional, invalid hyphenation points
+     (unfortunately, this information is not part of a pattern file--you
+     have to know it in advance).  The same is true for the number of
+     characters at the end of a word before the last hyphenation point
+     should be inserted.  For example, you can supply the following
+     input to 'echo $(nroff)'.
+
+          .ll 1
+          .hy 48
+          splitting
+
+     You will get
+
+          s- plit- t- in- g
+
+     instead of the correct 'split- ting'.  English patterns as
+     distributed with GNU 'troff' need two characters at the beginning
+     and three characters at the end; this means that value 4 of 'hy' is
+     mandatory.  Value 8 is possible as an additional restriction, but
+     values 16 and 32 should be avoided, as should mode 1.  Modes 4
+     and 6 are typical.
+
+     A table of left and right minimum character counts for hyphenation
+     as needed by the patterns distributed with GNU 'troff' follows; see
+     the 'groff_tmac(5)' man page for more information on GNU 'troff''s
+     language macro files.
+
+     language             pattern name   left min   right min
+     -----------------------------------------------------------
+     Czech                cs             2          2
+     English              en             2          3
+     French               fr             2          3
+     German traditional   det            2          2
+     German reformed      den            2          2
+     Italian              it             2          2
+     Swedish              sv             1          2
+
+     Hyphenation exceptions within pattern files (i.e., the words within
+     a TeX '\hyphenation' group) obey the hyphenation restrictions given
+     by 'hy'.
+
+ -- Request: .nh
+     Disable automatic hyphenation; i.e., set the hyphenation mode to 0
+     (see above).  The hyphenation mode of the last call to 'hy' is not
+     remembered.
+
+ -- Request: .hpf pattern-file
+ -- Request: .hpfa pattern-file
+ -- Request: .hpfcode a b c d ...
+     Read hyphenation patterns from PATTERN-FILE, which is sought in the
+     same way that macro files are with the 'mso' request or the
+     '-mNAME' command-line option to 'groff'.  The PATTERN-FILE should
+     have the same format as (simple) TeX pattern files.  More
+     specifically, the following scanning rules are implemented.
+
+        * A percent sign starts a comment (up to the end of the line)
+          even if preceded by a backslash.
+
+        * "Digraphs" like '\$' are not supported.
+
+        * '^^XX' (where each X is 0-9 or a-f) and '^^C' (character C in
+          the code point range 0-127 decimal) are recognized; other uses
+          of '^' cause an error.
+
+        * No macro expansion is performed.
+
+        * 'hpf' checks for the expression '\patterns{...}' (possibly
+          with whitespace before or after the braces).  Everything
+          between the braces is taken as hyphenation patterns.
+          Consequently, '{' and '}' are not allowed in patterns.
+
+        * Similarly, '\hyphenation{...}' gives a list of hyphenation
+          exceptions.
+
+        * '\endinput' is recognized also.
+
+        * For backward compatibility, if '\patterns' is missing, the
+          whole file is treated as a list of hyphenation patterns
+          (except that the '%' character is recognized as the start of a
+          comment).
+
+     The 'hpfa' request appends a file of patterns to the current list.
+
+     The 'hpfcode' request defines mapping values for character codes in
+     pattern files.  It is an older mechanism no longer used by GNU
+     'troff''s own macro files; for its successor, see 'hcode' below.
+     'hpf' or 'hpfa' apply the mapping after reading the patterns but
+     before replacing or appending to the active list of patterns.  Its
+     arguments are pairs of character codes--integers from 0 to 255.
+     The request maps character code A to code B, code C to code D, and
+     so on.  Character codes that would otherwise be invalid in GNU
+     'troff' can be used.  By default, every code maps to itself except
+     those for letters 'A' to 'Z', which map to those for 'a' to 'z'.
+
+     The set of hyphenation patterns is associated with the language set
+     by the 'hla' request (see below).  The 'hpf' request is usually
+     invoked by a localization file loaded by the 'troffrc' file.(6)
+     (*note Manipulating Hyphenation-Footnote-6::)
+
+     A second call to 'hpf' (for the same language) replaces the
+     hyphenation patterns with the new ones.  Invoking 'hpf' or 'hpfa'
+     causes an error if there is no hyphenation language.  If no 'hpf'
+     request is specified (either in the document, in a file loaded at
+     startup, or in a macro package), GNU 'troff' won't automatically
+     hyphenate at all.
+
+ -- Request: .hcode c1 code1 c2 code2 ...
+     Set the hyphenation code of character C1 to CODE1, that of C2 to
+     CODE2, and so on.  A hyphenation code must be an ordinary character
+     (not a special character escape sequence) other than a digit or a
+     space.  The request is ignored if given no arguments.
+
+     For hyphenation to work, hyphenation codes must be set up.  At
+     startup, GNU 'troff' assigns hyphenation codes to the letters
+     'a'-'z' (mapped to themselves), to the letters 'A'-'Z' (mapped to
+     'a'-'z'), and zero to all other characters.  Normally, hyphenation
+     patterns contain only lowercase letters which should be applied
+     regardless of case.  In other words, they assume that the words
+     'FOO' and 'Foo' should be hyphenated exactly as 'foo' is.  The
+     'hcode' request extends this principle to letters outside the
+     Unicode basic Latin alphabet; without it, words containing such
+     letters won't be hyphenated properly even if the corresponding
+     hyphenation patterns contain them.
+
+     For example, the following 'hcode' requests are necessary to assign
+     hyphenation codes to the letters 'ÄäÖöÜüß', needed for German.
+
+          .hcode ä ä  Ä ä
+          .hcode ö ö  Ö ö
+          .hcode ü ü  Ü ü
+          .hcode ß ß
+
+     Without these assignments, GNU 'troff' treats the German word
+     'Kindergärten' (the plural form of 'kindergarten') as two words
+     'kinderg' and 'rten' because the hyphenation code of the umlaut a
+     is zero by default, just like a space.  There is a German
+     hyphenation pattern that covers 'kinder', so GNU 'troff' finds the
+     hyphenation 'kin-der'.  The other two hyphenation points
+     ('kin-der-gär-ten') are missed.
+
+ -- Request: .hla lang
+ -- Register: \n.hla
+     Set the hyphenation language to LANG.  Hyphenation exceptions
+     specified with the 'hw' request and hyphenation patterns and
+     exceptions specified with the 'hpf' and 'hpfa' requests are
+     associated with the hyphenation language.  The 'hla' request is
+     usually invoked by a localization file, which is turn loaded by the
+     'troffrc' or 'troffrc-end' file; see the 'hpf' request above.
+
+     The hyphenation language is available in the read-only
+     string-valued register '.hla'; it is associated with the
+     environment (*note Environments::).
+
+ -- Request: .hlm n
+ -- Register: \n.hlm
+ -- Register: \n.hlc
+     Set the maximum quantity of consecutive hyphenated lines to N.  If
+     N is negative, there is no maximum.  If omitted, N is -1.  This
+     value is associated with the environment (*note Environments::).
+     Only lines output from a given environment count toward the maximum
+     associated with that environment.  Hyphens resulting from '\%' are
+     counted; explicit hyphens are not.
+
+     The '.hlm' read-only register stores this maximum.  The count of
+     immediately preceding consecutive hyphenated lines is available in
+     the read-only register '.hlc'.
+
+ -- Request: .hym length
+ -- Register: \n.hym
+     Set the (right) hyphenation margin to LENGTH.  If the adjustment
+     mode is not 'b' or 'n', the line is not hyphenated if it is shorter
+     than LENGTH.  Without an argument, the hyphenation margin is reset
+     to its default value, 0.  The default scaling unit is 'm'.  The
+     hyphenation margin is associated with the environment (*note
+     Environments::).
+
+     A negative argument resets the hyphenation margin to zero, emitting
+     a warning in category 'range'.
+
+     The hyphenation margin is available in the '.hym' read-only
+     register.
+
+ -- Request: .hys hyphenation-space
+ -- Register: \n.hys
+     Suppress hyphenation of the line in adjustment modes 'b' or 'n' if
+     it can be justified by adding no more than HYPHENATION-SPACE extra
+     space to each inter-word space.  Without an argument, the
+     hyphenation space adjustment threshold is set to its default value,
+     0.  The default scaling unit is 'm'.  The hyphenation space
+     adjustment threshold is associated with the environment (*note
+     Environments::).
+
+     A negative argument resets the hyphenation space adjustment
+     threshold to zero, emitting a warning in category 'range'.
+
+     The hyphenation space adjustment threshold is available in the
+     '.hys' read-only register.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Hyphenation-Footnotes,  Up: Manipulating Hyphenation
+
+   (1) Whether a perfect algorithm for this application is even possible
+is an unsolved problem in computer science:
+<https://tug.org/docs/liang/liang-thesis.pdf>.
+
+   (2) '\%' itself stops marking hyphenation points but still produces
+no output glyph.
+
+   (3) "Soft" because it appears in output only where a hyphenation
+break is performed; a "hard" hyphen, as in "long-term", always appears.
+
+   (4) The mode is a vector of Booleans encoded as an integer.  To a
+programmer, this fact is easily deduced from the exclusive use of powers
+of two for the configuration parameters; they are computationally easy
+to "mask off" and compare to zero.  To almost everyone else, the
+arrangement seems recondite and unfriendly.
+
+   (5) Hyphenation is prevented if the next page location trap is closer
+to the vertical drawing position than the next text baseline would be.
+*Note Page Location Traps::.
+
+   (6) For more on localization, see the 'groff_tmac(5)' man page.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Spacing,  Next: Tabs and Fields,  Prev: Manipulating Hyphenation,  Up: GNU troff Reference
+
+5.11 Manipulating Spacing
+=========================
+
+A break causes the formatter to update the vertical drawing position at
+which the new text baseline is aligned.  You can alter this location.
+
+ -- Request: .sp distance
+     Break and move the next text baseline down by DISTANCE, or until
+     springing a page location trap.(1)  (*note Manipulating
+     Spacing-Footnote-1::) If invoked with the no-break control
+     character, 'sp' moves the pending output line's text baseline by
+     DISTANCE.  A negative DISTANCE will not reduce the position of the
+     text baseline below zero.  Inside a diversion, any DISTANCE
+     argument is ignored.  The default scaling unit is 'v'.  If DISTANCE
+     is not specified, '1v' is assumed.
+
+          .pl 5v \" Set page length to 5 vees.
+          .de xx
+          \-\-\-
+          .  br
+          ..
+          .wh 0 xx \" Set a trap at the top of the page.
+          foo on page \n%
+          .sp 2v
+          bar on page \n%
+          .sp 50v \" This will cause a page break.
+          baz on page \n%
+          .pl \n(nlu \" Truncate page to current position.
+              => ---
+              => foo on page 1
+              =>
+              =>
+              => bar on page 1
+              => ---
+              => baz on page 2
+
+     You might use the following macros to set the baseline of the next
+     output text at a given distance from the top or the bottom of the
+     page.  We subtract one line height ('\n.v') because the '|'
+     operator moves to one vee below the page top (recall *note Numeric
+     Expressions::).
+
+          .de y-from-top-down
+          .  sp |\\$1-\\n.vu
+          ..
+          .
+          .de y-from-bot-up
+          .  sp |\\n.pu-\\$1-\\n.vu
+          ..
+
+     A call to '.y-from-bot-up 10c' means that the next text baseline
+     will be 10 cm from the bottom edge of the paper.
+
+ -- Request: .ls count
+ -- Register: \n.L
+     Set the line spacing; add COUNT-1 blank lines after each line of
+     text.  With no argument, GNU 'troff' uses the previous value before
+     the last 'ls' call.  The default is '1'.
+
+     The read-only register '.L' contains the current line spacing; it
+     is associated with the environment (*note Environments::).
+
+   The 'ls' request is a coarse mechanism.  *Note Changing the Type
+Size::, for the requests 'vs' and 'pvs' as alternatives to 'ls'.
+
+ -- Escape sequence: \x'spacing'
+ -- Register: \n.a
+     Sometimes, an output line requires additional vertical spacing, for
+     instance to allow room for a tall construct like an inline equation
+     with exponents or subscripts (particularly if they are iterated).
+     The '\x' escape sequence takes a delimited measurement (like
+     '\x'3p'') to increase the vertical spacing of the pending output
+     line.  The default scaling unit is 'v'.  If the measurement is
+     positive, extra vertical space is inserted below the current line;
+     a negative measurement adds space above.  If '\x' is applied to the
+     pending output line multiple times, the maxima of the positive and
+     negative adjustments are separately applied.  The delimiter need
+     not be a neutral apostrophe; see *note Delimiters::.
+
+     The '.a' read-only register contains the extra vertical spacing
+     _after_ the text baseline of the most recently emitted output line.
+     (In other words, it is the largest positive argument to '\x'
+     encountered on that line.)  This quantity is exposed via a register
+     because if an output line requires this "extra post-vertical line
+     spacing", and the subsequent output line requires "extra
+     pre-vertical line spacing" (a negative argument to '\x'), then
+     applying both can lead to excessive spacing between the output
+     lines.  Text that is piling high on line N might not require (as
+     much) extra pre-vertical line spacing if line N-1 carries extra
+     post-vertical line spacing.
+
+     Use of '\x' can be necessary in combination with the
+     bracket-building escape sequence '\b',(2) (*note Manipulating
+     Spacing-Footnote-2::) as the following example shows.
+
+          .nf
+          This is a test of \rsb (1).
+          This is a test of \rsb (2).
+          This is a test of \b'xyz'\x'-1m'\x'1m' (3).
+          This is a test of \rsb (4).
+          This is a test of \rsb (5).
+              => This is a test of \b (1).
+              => This is a test of \b (2).
+              =>                   x
+              => This is a test of y (3).
+              =>                   z
+              => This is a test of \b (4).
+              => This is a test of \b (5).
+
+Without '\x', the backslashes on the lines marked '(2)' and '(4)' would
+be overprinted.
+
+ -- Request: .ns
+ -- Request: .rs
+ -- Register: \n.ns
+     Enable "no-space mode".  Vertical spacing, whether by 'sp' requests
+     or blank input lines, is disabled.  The 'bp' request to advance to
+     the next page is also disabled, unless it is accompanied by a page
+     number (*note Page Control::).  No-space mode ends automatically
+     when text(3) (*note Manipulating Spacing-Footnote-3::) is formatted
+     for output (4) (*note Manipulating Spacing-Footnote-4::) or the
+     'rs' request is invoked, which ends no-space mode.  The read-only
+     register '.ns' interpolates a Boolean value indicating the
+     enablement of no-space mode.
+
+     A paragraphing macro might ordinarily insert vertical space to
+     separate paragraphs.  A section heading macro could invoke 'ns' to
+     suppress this spacing for the first paragraph in a section.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Spacing-Footnotes,  Up: Manipulating Spacing
+
+   (1) *Note Page Location Traps::.
+
+   (2) *Note Drawing Geometric Objects::.
+
+   (3) or geometric objects; see *note Drawing Geometric Objects::
+
+   (4) to the top-level diversion; see *note Diversions::
+
+&#x1f;
+File: groff.info,  Node: Tabs and Fields,  Next: Character Translations,  Prev: Manipulating Spacing,  Up: GNU troff Reference
+
+5.12 Tabs and Fields
+====================
+
+A tab character (ISO code point 9, EBCDIC code point 5) causes a
+horizontal movement to the next tab stop, if any.
+
+ -- Escape sequence: \t
+     Interpolate a tab in copy mode; see *note Copy Mode::.
+
+ -- Request: .ta n1 n2 ... nn T r1 r2 ... rn
+ -- Register: \n.tabs
+     Change tab stop positions.  This request takes a series of tab
+     specifiers as arguments (optionally divided into two groups with
+     the letter 'T') that indicate where each tab stop is to be,
+     overriding any previous settings.  The default scaling unit is 'm'.
+     Invoking 'ta' without an argument removes all tab stops.  GNU
+     'troff''s startup value is 'T 0.5i'.
+
+     Tab stops can be specified absolutely--as distances from the left
+     margin.  The following example sets six tab stops, one every inch.
+
+          .ta 1i 2i 3i 4i 5i 6i
+
+     Tab stops can also be specified using a leading '+', which means
+     that the specified tab stop is set relative to the previous tab
+     stop.  For example, the following is equivalent to the previous
+     example.
+
+          .ta 1i +1i +1i +1i +1i +1i
+
+     GNU 'troff' supports an extended syntax to specify repeating tab
+     stops.  These stops appear after a 'T' argument.  Their values are
+     always taken as distances relative to the previous tab stop.  This
+     is the idiomatic way to specify tab stops at equal intervals in
+     'groff'.  The following is, yet again, the same as the previous
+     examples.  It does more, in fact, since it defines an infinite
+     number of tab stops at one-inch intervals.
+
+          .ta T 1i
+
+     Now we are ready to interpret the full syntax given above.  The
+     'ta' request sets tabs at positions N1, N2, ..., NN, then at NN+R1,
+     NN+R2, ..., NN+RN, then at NN+RN+R1, NN+RN+R2, ..., NN+RN+RN, and
+     so on.
+
+     For example, '4c +6c T 3c 5c 2c' is equivalent to '4c 10c 13c 18c
+     20c 23c 28c 30c ...'.
+
+     Text written to a tab column (i.e., between two tab stops, or
+     between a tab stop and an output line boundary) may be aligned to
+     the right or left, or centered in the column.  This alignment is
+     determined by appending 'R', 'L', or 'C' to the tab specifier.  The
+     default is 'L'.
+
+          .ta 1i 2iC 3iR
+
+     The beginning of an output line is not a tab stop; the text that
+     begins an output line is placed according to the configured
+     alignment and indentation; see *note Manipulating Filling and
+     Adjustment:: and *note Line Layout::.
+
+     A tab stop is converted into a non-breakable horizontal movement
+     that cannot be adjusted.
+
+          .ll 2i
+          .ds foo a\tb\tc
+          .ta T 1i
+          \*foo
+              error-> warning: cannot break line
+              => a         b         c
+
+     The above creates a single output line that is a bit longer than
+     two inches (we use a string to show exactly where the tab stops
+     are).  Now consider the following.
+
+          .ll 2i
+          .ds bar a\tb c\td
+          .ta T 1i
+          \*bar
+              error-> warning: cannot adjust line
+              => a         b
+              => c       d
+
+     GNU 'troff' first converts the line's tab stops into unbreakable
+     horizontal movements, then breaks after 'b'.  This usually isn't
+     what you want.
+
+     Superfluous tab characters--those that do not correspond to a tab
+     stop--are ignored except for the first, which delimits the
+     characters belonging to the last tab stop for right-alignment or
+     centering.
+
+          .ds Z   foo\tbar\tbaz
+          .ds ZZ  foo\tbar\tbazqux
+          .ds ZZZ foo\tbar\tbaz\tqux
+          .ta 2i 4iR
+          \*Z
+          .br
+          \*ZZ
+          .br
+          \*ZZZ
+          .br
+              => foo                 bar              baz
+              => foo                 bar           bazqux
+              => foo                 bar              bazqux
+
+     The first line right-aligns "baz" within the second tab stop.  The
+     second line right-aligns "bazqux" within it.  The third line
+     right-aligns only "baz" because of the additional tab character,
+     which marks the end of the text occupying the last tab stop
+     defined.
+
+     Tab stops are associated with the environment (*note
+     Environments::).
+
+     The read-only register '.tabs' contains a string representation of
+     the current tab settings suitable for use as an argument to the
+     'ta' request.(1)  (*note Tabs and Fields-Footnote-1::)
+
+          .ds tab-string \n.tabs
+          \*tab-string
+              => T120u
+
+ -- Request: .tc c
+     Set the tab repetition character to the ordinary or special
+     character C; normally, no glyph is written when moving to a tab
+     stop (and some output devices may output space characters to
+     achieve this motion).  A "tab repetition character" causes the
+     formatter to write as many instances of C as are necessary to
+     occupy the interval from the horizontal drawing position to the
+     next tab stop.  With no argument, GNU 'troff' reverts to the
+     default behavior.  The tab repetition character is associated with
+     the environment (*note Environments::).  Only a single character of
+     C is recognized; any excess is ignored.
+
+ -- Request: .linetabs n
+ -- Register: \n.linetabs
+     If N is missing or non-zero, activate "line-tabs"; deactivate it
+     otherwise (the default).  Active line-tabs cause GNU 'troff' to
+     compute tab distances relative to the start of the output line
+     instead of the input line.
+
+          .de Tabs
+          .  ds x a\t\c
+          .  ds y b\t\c
+          .  ds z c
+          .  ta 1i 3i
+          \\*x
+          \\*y
+          \\*z
+          ..
+          .Tabs
+          .br
+          .linetabs
+          .Tabs
+              => a         b         c
+              => a         b                   c
+
+     Line-tabs activation is associated with the environment (*note
+     Environments::).  The read-only register '.linetabs' interpolates 1
+     if line-tabs are active, and 0 otherwise.
+
+* Menu:
+
+* Leaders::
+* Fields::
+
+&#x1f;
+File: groff.info,  Node: Tabs and Fields-Footnotes,  Up: Tabs and Fields
+
+   (1) Plan 9 'troff' uses the register '.S' for this purpose.
+
+&#x1f;
+File: groff.info,  Node: Leaders,  Next: Fields,  Prev: Tabs and Fields,  Up: Tabs and Fields
+
+5.12.1 Leaders
+--------------
+
+Sometimes it is desirable to fill a tab stop with a given glyph, but
+also use tab stops normally on the same output line.  An example is a
+table of contents entry that uses dots to bridge the entry name with its
+page number, which is itself aligned between tab stops.  The 'roff'
+language provides "leaders" for this purpose.(1)  (*note
+Leaders-Footnote-1::)
+
+   A leader character (ISO and EBCDIC code point 1, also known as SOH or
+"start of heading"), behaves similarly to a tab character: it moves to
+the next tab stop.  The difference is that for this movement, the
+default fill character is a period '.'.
+
+ -- Escape sequence: \a
+     Interpolate a leader in copy mode; see *note Copy Mode::.
+
+ -- Request: .lc c
+     Set the leader repetition character to the ordinary or special
+     character C.  Recall *note Tabs and Leaders::: when encountering a
+     leader character in the input, the formatter writes as many dots
+     '.' as are necessary until reaching the next tab stop; this is the
+     "leader definition character".  Omitting C unsets the leader
+     character.  With no argument, GNU 'troff' treats leaders the same
+     as tabs.  The leader repetition character is associated with the
+     environment (*note Environments::).  Only a single C is recognized;
+     any excess is ignored.
+
+   A table of contents, for example, may define tab stops after a
+section number, a title, and a gap to be filled with leader dots.  The
+page number follows the leader, after a right-aligned final tab stop
+wide enough to house the largest page number occurring in the document.
+
+     .ds entry1 19.\tThe Prophet\a\t98
+     .ds entry2 20.\tAll Astir\a\t101
+     .ta .5i 4.5i +.5iR
+     .nf
+     \*entry1
+     \*entry2
+         => 19.  The Prophet.............................   98
+         => 20.  All Astir...............................  101
+
+&#x1f;
+File: groff.info,  Node: Leaders-Footnotes,  Up: Leaders
+
+   (1) This is pronounced to rhyme with "feeder", and refers to how the
+glyphs "lead" the eye across the page to the corresponding page number
+or other datum.
+
+&#x1f;
+File: groff.info,  Node: Fields,  Prev: Leaders,  Up: Tabs and Fields
+
+5.12.2 Fields
+-------------
+
+"Fields" are a more general way of laying out tabular data.  A field is
+defined as the data between a pair of "delimiting characters".  It
+contains substrings that are separated by "padding characters".  The
+width of a field is the distance on the _input_ line from the position
+where the field starts to the next tab stop.  A padding character
+inserts an adjustable space similar to TeX's '\hss' command (thus it can
+even be negative) to make the sum of all substring lengths plus the
+adjustable space equal to the field width.  If more than one padding
+character is inserted, the available space is evenly distributed among
+them.
+
+ -- Request: .fc delim-char padding-char
+     Define a delimiting and a padding character for fields.  If the
+     latter is missing, the padding character defaults to a space
+     character.  If there is no argument at all, the field mechanism is
+     disabled (which is the default).  In contrast to, e.g., the tab
+     repetition character, delimiting and padding characters are _not_
+     associated with the environment (*note Environments::).
+
+          .fc # ^
+          .ta T 3i
+          #foo^bar^smurf#
+          .br
+          #foo^^bar^smurf#
+              => foo         bar          smurf
+              => foo            bar       smurf
+
+&#x1f;
+File: groff.info,  Node: Character Translations,  Next: troff and nroff Modes,  Prev: Tabs and Fields,  Up: GNU troff Reference
+
+5.13 Character Translations
+===========================
+
+A "translation" is a mapping of an input character to an output glyph.
+The mapping occurs at output time, i.e., the input character gets
+assigned the metric information of the mapped output character right
+before input tokens are converted to nodes (*note Gtroff Internals::,
+for more on this process).
+
+ -- Request: .tr abcd...
+ -- Request: .trin abcd...
+     Translate character A to glyph B, character C to glyph D, and so
+     on.  If there is an odd number of characters in the argument, the
+     last one is translated to a fixed-width space (the same one
+     obtained by the '\<SP>' escape sequence).
+
+     The 'trin' request is identical to 'tr', but when you unformat a
+     diversion with 'asciify' it ignores the translation.  *Note
+     Diversions::, for details about the 'asciify' request.
+
+     Some notes:
+
+        * Special characters ('\(XX', '\XXX', '\C'XXX'', '\'', '\`',
+          '\-', '\_'), glyphs defined with the 'char' request, and
+          numbered glyphs ('\N'XXX'') can be translated also.
+
+        * The '\e' escape can be translated also.
+
+        * Characters can be mapped onto the '\%' and '\~' escape
+          sequences (but '\%' and '\~' can't be mapped onto another
+          glyph).
+
+        * The following characters can't be translated: space (with one
+          exception, see below), backspace, newline, leader (and '\a'),
+          tab (and '\t').
+
+        * Translations are not considered for finding the soft hyphen
+          character set with the 'shc' request.
+
+        * The pair 'C\&' (an arbitrary character C followed by the dummy
+          character) maps this character to "nothing".
+
+               .tr a\&
+               foo bar
+                   => foo br
+
+          Even the space character can be mapped to the dummy character.
+
+               .tr aa \&
+               foo bar
+                   => foobar
+
+          As shown in the example, the space character can't be the
+          first character/glyph pair as an argument of 'tr'.
+          Additionally, it is not possible to map the space character to
+          any other glyph; requests like '.tr aa x' undo '.tr aa \&'
+          instead.
+
+          If justification is active, lines are justified in spite of
+          the 'empty' space character (but there is no minimal distance,
+          i.e., the space character, between words).
+
+        * After an output glyph has been constructed (this happens at
+          the moment immediately before the glyph is appended to an
+          output glyph list, either by direct output, in a macro,
+          diversion, or string), it is no longer affected by 'tr'.
+
+        * Translating character to glyphs where one of them or both are
+          undefined is possible also; 'tr' does not check whether the
+          elements of its argument exist.
+
+          *Note Gtroff Internals::.
+
+        * Without an argument, the 'tr' request is ignored.
+
+ -- Request: .trnt abcd...
+     'trnt' is the same as the 'tr' request except that the translations
+     do not apply to text that is transparently throughput into a
+     diversion with '\!'.  *Note Diversions::.
+
+     For example,
+
+          .tr ab
+          .di x
+          \!.tm a
+          .di
+          .x
+
+     prints 'b' to the standard error stream; if 'trnt' is used instead
+     of 'tr' it prints 'a'.
+
+&#x1f;
+File: groff.info,  Node: troff and nroff Modes,  Next: Line Layout,  Prev: Character Translations,  Up: GNU troff Reference
+
+5.14 'troff' and 'nroff' Modes
+==============================
+
+Historically, 'nroff' and 'troff' were two separate programs; the former
+for terminal output, the latter for typesetters.  GNU 'troff' merges
+both functions into one executable(1) (*note troff and nroff
+Modes-Footnote-1::) that sends its output to a device driver ('grotty'
+for terminal devices, 'grops' for PostScript, and so on) which
+interprets this intermediate output format.  When discussing AT&T
+'troff', it makes sense to talk about "'nroff' mode" and "'troff' mode"
+since the differences are hard-coded.  GNU 'troff' takes information
+from device and font description files without handling requests
+specially if a terminal output device is used, so such a strong
+distinction is unnecessary.
+
+   Usually, a macro package can be used with all output devices.
+Nevertheless, it is sometimes necessary to make a distinction between
+terminal and non-terminal devices: GNU 'troff' provides two built-in
+conditions 'n' and 't' for the 'if', 'ie', and 'while' requests to
+decide whether GNU 'troff' shall behave like 'nroff' or like 'troff'.
+
+ -- Request: .troff
+     Make the 't' built-in condition true (and the 'n' built-in
+     condition false) for 'if', 'ie', and 'while' conditional requests.
+     This is the default if GNU 'troff' (_not_ 'groff') is started with
+     the '-R' switch to avoid loading of the startup files 'troffrc' and
+     'troffrc-end'.  Without '-R', GNU 'troff' stays in 'troff' mode if
+     the output device is not a terminal (e.g., 'ps').
+
+ -- Request: .nroff
+     Make the 'n' built-in condition true (and the 't' built-in
+     condition false) for 'if', 'ie', and 'while' conditional requests.
+     This is the default if GNU 'troff' uses a terminal output device;
+     the code for switching to 'nroff' mode is in the file 'tty.tmac',
+     which is loaded by the startup file 'troffrc'.
+
+   *Note Conditionals and Loops::, for more details on built-in
+conditions.
+
+&#x1f;
+File: groff.info,  Node: troff and nroff Modes-Footnotes,  Up: troff and nroff Modes
+
+   (1) A GNU 'nroff' program is available for convenience; it calls GNU
+'troff' to perform the formatting.
+
+&#x1f;
+File: groff.info,  Node: Line Layout,  Next: Line Continuation,  Prev: troff and nroff Modes,  Up: GNU troff Reference
+
+5.15 Line Layout
+================
+
+The following drawing shows the dimensions that 'gtroff' uses for
+placing a line of output onto the page.  They are labeled with the
+request that manipulates each dimension.
+
+          -->| in |<--
+             |<-----------ll------------>|
+        +----+----+----------------------+----+
+        |    :    :                      :    |
+        +----+----+----------------------+----+
+     -->| po |<--
+        |<--------paper width---------------->|
+
+These dimensions are:
+
+'po'
+     "Page offset"--this is the leftmost position of text on the final
+     output, defining the "left margin".
+
+'in'
+     "Indentation"--this is the distance from the left margin where text
+     is printed.
+
+'ll'
+     "Line length"--this is the distance from the left margin to right
+     margin.
+
+   The right margin is not explicitly configured; the combination of
+page offset and line length provides the information necessary to derive
+it.
+
+   A simple demonstration:
+
+     .ll 3i
+     This is text without indentation.
+     The line length has been set to 3\~inches.
+     .in +.5i
+     .ll -.5i
+     Now the left and right margins are both increased.
+     .in
+     .ll
+     Calling .in and .ll without parameters restores
+     the previous values.
+
+         => This  is text without indenta-
+         => tion.   The  line  length  has
+         => been set to 3 inches.
+         =>      Now   the  left  and
+         =>      right  margins   are
+         =>      both increased.
+         => Calling  .in  and  .ll without
+         => parameters restores the previ-
+         => ous values.
+
+ -- Request: .po offset
+ -- Request: .po +offset
+ -- Request: .po -offset
+ -- Register: \n.o
+     Set page offset to OFFSET (or increment or decrement its current
+     value by OFFSET).  If invoked without an argument, the page offset
+     is restored to the value before the previous 'po' request.  This
+     request does not cause a break; the page offset in effect when an
+     output line is broken prevails (*note Manipulating Filling and
+     Adjustment::).  The initial value is 1i and the default scaling
+     unit is 'm'.  On terminal devices, the page offset is set to zero
+     by a driver-specific macro file, 'tty.tmac'.  The current page
+     offset can be found in the read-only register '.o'.  This request
+     is incorrectly documented in the AT&T 'troff' manual as using a
+     default scaling unit of 'v'.
+
+          .po 3i
+          \n.o
+              => 720
+          .po -1i
+          \n.o
+              => 480
+          .po
+          \n.o
+              => 720
+
+ -- Request: .in indent
+ -- Request: .in +indent
+ -- Request: .in -indent
+ -- Register: \n.i
+     Set indentation to INDENT (or increment or decrement the current
+     value by INDENT).  This request causes a break.  Initially, there
+     is no indentation.
+
+     If 'in' is called without an argument, the indentation is reset to
+     the previous value before the last call to 'in'.  The default
+     scaling unit is 'm'.
+
+     If a negative indentation value is specified (which is not
+     allowed), 'gtroff' emits a warning in category 'range' and sets the
+     indentation to zero.
+
+     The effect of 'in' is delayed until a partially collected line (if
+     it exists) is output.  A temporary indentation value is reset to
+     zero also.
+
+     The current indentation (as set by 'in') can be found in the
+     read-only register '.i'.  The indentation is associated with the
+     environment (*note Environments::).
+
+ -- Request: .ti offset
+ -- Request: .ti +offset
+ -- Request: .ti -offset
+ -- Register: \n.in
+     Temporarily indent the next output line by OFFSET.  If an increment
+     or decrement value is specified, adjust the temporary indentation
+     relative to the value set by the 'in' request.
+
+     This request causes a break; its value is associated with the
+     environment (*note Environments::).  The default scaling unit is
+     'm'.  A call of 'ti' without an argument is ignored.
+
+     If the total indentation value is negative (which is not allowed),
+     'gtroff' emits a warning in category 'range' and sets the temporary
+     indentation to zero.  'Total indentation' is either OFFSET if
+     specified as an absolute value, or the temporary plus normal
+     indentation, if OFFSET is given as a relative value.
+
+     The effect of 'ti' is delayed until a partially collected line (if
+     it exists) is output.
+
+     The read-only register '.in' is the indentation that applies to the
+     current output line.
+
+     The difference between '.i' and '.in' is that the latter takes into
+     account whether a partially collected line still uses the old
+     indentation value or a temporary indentation value is active.
+
+ -- Request: .ll length
+ -- Request: .ll +length
+ -- Request: .ll -length
+ -- Register: \n.l
+ -- Register: \n.ll
+     Set the line length to LENGTH (or increment or decrement the
+     current value by LENGTH).  Initially, the line length is set to
+     6.5i.  The effect of 'll' is delayed until a partially collected
+     line (if it exists) is output.  The default scaling unit is 'm'.
+
+     If 'll' is called without an argument, the line length is reset to
+     the previous value before the last call to 'll'.  If a negative
+     line length is specified (which is not allowed), 'gtroff' emits a
+     warning in category 'range' and sets the line length to zero.  The
+     line length is associated with the environment (*note
+     Environments::).
+
+     The current line length (as set by 'll') can be found in the
+     read-only register '.l'.  The read-only register '.ll' is the line
+     length that applies to the current output line.
+
+     Similar to '.i' and '.in', the difference between '.l' and '.ll' is
+     that the latter takes into account whether a partially collected
+     line still uses the old line length value.
+
+&#x1f;
+File: groff.info,  Node: Line Continuation,  Next: Page Layout,  Prev: Line Layout,  Up: GNU troff Reference
+
+5.16 Line Continuation
+======================
+
+When filling is enabled, input and output line breaks generally do not
+correspond.  The 'roff' language therefore distinguishes input and
+output line continuation.
+
+ -- Escape sequence: \<RET>
+     '\<RET>' (a backslash immediately followed by a newline) suppresses
+     the effects of that newline in the input.  The next input line thus
+     retains the classification of its predecessor as a control or text
+     line.  '\<RET>' is useful for managing line lengths in the input
+     during document maintenance; you can break an input line in the
+     middle of a request invocation, macro call, or escape sequence.
+     Input line continuation is invisible to the formatter, with two
+     exceptions: the '|' operator recognizes the new input line (*note
+     Numeric Expressions::), and the input line counter register '.c' is
+     incremented.
+
+          .ll 50n
+          .de I
+          .  ft I
+          .  nop \\$*
+          .  ft
+          ..
+          Our film class watched
+          .I The Effect of Gamma Rays on Man-in-the-Moon
+          Marigolds. \" whoops, the input line wrapped
+          .br
+          .I My own opus begins on line \n.c \
+          and ends on line \n.c.
+              => Our film class watched The Effect of Gamma Rays on
+              => Man-in-the-Moon Marigolds.
+              => My own opus begins on line 11 and ends on line 12.
+
+ -- Escape sequence: \c
+ -- Register: \n.int
+     '\c' continues an output line.  Nothing after it on the input line
+     is formatted.  In contrast to '\<RET>', a line after '\c' remains a
+     new input line, so a control character is recognized at its
+     beginning.  The visual results depend on whether filling is
+     enabled; see *note Manipulating Filling and Adjustment::.
+
+        * If filling is enabled, a word interrupted with '\c' is
+          continued with the text on the next input text line, without
+          an intervening space.
+
+               This is a te\c
+               st.
+                   => This is a test.
+
+        * If filling is disabled, the next input text line after '\c' is
+          handled as a continuation of the same input text line.
+
+               .nf
+               This is a \c
+               test.
+                   => This is a test.
+
+     An intervening control line that causes a break overrides '\c',
+     flushing out the pending output line in the usual way.
+
+     The '.int' register contains a positive value if the last output
+     line was continued with '\c'; this datum is associated with the
+     environment (*note Environments::).(1)  (*note Line
+     Continuation-Footnote-1::)
+
+&#x1f;
+File: groff.info,  Node: Line Continuation-Footnotes,  Up: Line Continuation
+
+   (1) Historically, the '\c' escape sequence has proven challenging to
+characterize.  Some sources say it "connects the next input text" (to
+the input line on which it appears); others describe it as
+"interrupting" text, on the grounds that a text line is interrupted
+without breaking, perhaps to inject a request invocation or macro call.
+
+&#x1f;
+File: groff.info,  Node: Page Layout,  Next: Page Control,  Prev: Line Continuation,  Up: GNU troff Reference
+
+5.17 Page Layout
+================
+
+The formatter permits configuration of the page length and page number.
+
+ -- Request: .pl length
+ -- Request: .pl +length
+ -- Request: .pl -length
+ -- Register: \n.p
+     Change (increase or decrease) the page length per the numeric
+     expression LENGTH.  The default scaling unit is 'v'.  A negative
+     LENGTH is valid, but an uncommon application: it prevents page
+     location traps from being sprung,(1) (*note Page
+     Layout-Footnote-1::) and each output line is placed on a new page.
+     If LENGTH is invalid, GNU 'troff' emits a warning in category
+     'number'.  If LENGTH is absent or invalid, '11i' is assumed.
+
+     The read-only register '.p' interpolates the current page length.
+
+ -- Request: .pn num
+ -- Request: .pn +num
+ -- Request: .pn -num
+ -- Register: \n.pn
+     Change (increase or decrease) the page number of the _next_ page
+     per the numeric expression NUM.  If NUM is invalid, GNU 'troff'
+     emits a warning in category 'number' and ignores the request.
+     Without an argument, 'pn' is ignored.
+
+     The read-only register '.pn' interpolates NUM if set by 'pn' on the
+     current page, or the current page number plus 1.
+
+   The formatter offers special support for typesetting headers and
+footers, collectively termed "titles".  Titles have an independent line
+length, and their placement on the page is not restricted.
+
+ -- Request: .tl 'left'center'right'
+     Format an output line as a title consisting of LEFT, CENTER, and
+     RIGHT, each aligned accordingly.  The delimiter need not be a
+     neutral apostrophe: 'tl' accepts the same delimiters as most escape
+     sequences; see *note Delimiters::.  If not used as the delimiter,
+     any "page number character" character is replaced with the current
+     page number; the default is '%'; see the the 'pc' request below.
+     Without an argument, 'tl' is ignored.  'tl' writes the title line
+     immediately, ignoring any partially collected line.
+
+     It is not an error to omit delimiters after the first.  For
+     example, '.tl /Thesis' is interpreted as '.tl /Thesis///': it sets
+     a title line comprising only the left-aligned word 'Thesis'.
+
+ -- Request: .lt length
+ -- Request: .lt +length
+ -- Request: .lt -length
+ -- Register: \n.lt
+     Change (increase or decrease) the line length used by titles per
+     the numeric expression LENGTH.  The default scaling unit is 'm'.
+     If LENGTH is negative, GNU emits a warning in category 'range' and
+     treats LENGTH as '0'.  If LENGTH is invalid, GNU 'troff' emits a
+     warning in category 'number' and ignores the request.  The
+     formatter's default title length is '6.5i'.  With no argument, the
+     title length is restored to the previous value.  The title length
+     is is associated with the environment (*note Environments::).
+
+     The read-only register '.lt' interpolates the title line length.
+
+ -- Request: .pc char
+     Set the page number character to CHAR.  With no argument, the page
+     number character is disabled.  'pc' does not affect the
+     register '%'.
+
+   The following example exercises title features.
+
+     .lt 50n
+     This is my partially collected
+     .tl 'Isomers 2023'%'Dextrose Edition'
+     line.
+         => Isomers 2023             1        Dextrose Edition
+         => This is my partially collected line.
+
+   We most often see titles used in page header and footer traps.  *Note
+Traps::.
+
+&#x1f;
+File: groff.info,  Node: Page Layout-Footnotes,  Up: Page Layout
+
+   (1) *Note Traps::.
+
+&#x1f;
+File: groff.info,  Node: Page Control,  Next: Using Fonts,  Prev: Page Layout,  Up: GNU troff Reference
+
+5.18 Page Control
+=================
+
+Discretionary page breaks can prevent the unwanted separation of
+content.  A new page number takes effect during page ejection; see *note
+The Implicit Page Trap::.
+
+ -- Request: .bp page-number
+ -- Request: .bp +page-number
+ -- Request: .bp -page-number
+ -- Register: \n%
+     Break the page and change (increase or decrease) the next page
+     number per the numeric expression PAGE-NUMBER.  If PAGE-NUMBER is
+     invalid, GNU 'troff' emits a warning in category 'number' and
+     ignores the argument.  This request causes a break.  A page break
+     advances the vertical drawing position to the bottom of the page,
+     springing traps.  *Note Page Location Traps::.  'bp' has effect
+     only if invoked within the top-level diversion.(1)  (*note Page
+     Control-Footnote-1::) This request is incorrectly documented in the
+     AT&T 'troff' manual as having a default scaling unit of 'v'.
+
+     The register '%' interpolates the current page number.
+
+          .de BP
+          '  bp \" schedule page break once current line is output
+          ..
+
+ -- Request: .ne space
+     Force a page break if insufficient vertical space is available
+     (assert "needed" space).  'ne' tests the distance to the next page
+     location trap; see *note Page Location Traps::, and breaks the page
+     if that amount is less than SPACE.  The default scaling unit is
+     'v'.  If SPACE is invalid, GNU 'troff' emits a warning in category
+     'number' and ignores the argument.  If SPACE is not specified, '1v'
+     is assumed.
+
+     We can require space for at least the first two output lines of a
+     paragraph, preventing its first line from being widowed at the page
+     bottom.
+
+          .ne 2v
+          Considering how common illness is,
+          how tremendous the spiritual change that it brings,
+          how astonishing,
+          when the lights of health go down,
+          the undiscovered countries that are then disclosed,
+          what wastes and deserts of the soul a slight attack
+          of influenza brings to view,
+
+     This method is reliable only if no output line is pending when 'ne'
+     is invoked.  When macro packages are used, this is often not the
+     case: their paragraphing macros perform the break.  You may need to
+     experiment with placing the 'ne' after the paragraphing macro, or
+     'br' and 'ne' before it.
+
+     'ne' is also useful to force grouping of section headings with
+     their subsequent paragraphs, or tables with their captions and/or
+     explanations.  Macro packages often use 'ne' with diversions to
+     implement keeps and displays; see *note Diversions::.  They may
+     also offer parameters for widow and orphan management.
+
+ -- Request: .sv space
+ -- Request: .os
+     Require vertical space as 'ne' does, but also save it for later
+     output by the 'os' request.  If SPACE is available before the next
+     page location trap, it is output immediately.  Both requests ignore
+     a partially collected line, taking effect at the next break.  'sv'
+     and 'os' ignore no-space mode (recall *note Manipulating
+     Spacing::).  While the 'sv' request allows negative values for
+     SPACE, 'os' ignores them.  The default scaling unit is 'v'.  If
+     SPACE is not specified, '1v' is assumed.
+
+ -- Register: \nnl
+     'nl' interpolates or sets the vertical drawing position.  When the
+     formatter starts, the first page transition hasn't happened yet,
+     and 'nl' is negative.  If a header trap has been planted on the
+     page (typically at vertical position '0'), you can assign a
+     negative value to 'nl' to spring it if that page has already
+     started (*note Page Location Traps::).
+
+          .de HD
+          .  sp
+          .  tl ''Goldbach Solution''
+          .  sp
+          ..
+          .
+          First page.
+          .bp
+          .wh 0 HD \" plant header trap at top of page
+          .nr nl (-1)
+          Second page.
+              => First page.
+              =>
+              => (blank lines elided)
+              =>
+              =>                         Goldbach Solution
+              =>
+              => (blank lines elided)
+              =>
+              => Second page.
+
+     Without resetting 'nl' to a negative value, the trap just planted
+     would be active beginning with the _next_ page, not the current
+     one.
+
+     *Note Diversions::, for a comparison of 'nl' with the '.h' and '.d'
+     registers.
+
+&#x1f;
+File: groff.info,  Node: Page Control-Footnotes,  Up: Page Control
+
+   (1) *Note Diversions::.
+
+&#x1f;
+File: groff.info,  Node: Using Fonts,  Next: Manipulating Type Size and Vertical Spacing,  Prev: Page Control,  Up: GNU troff Reference
+
+5.19 Using Fonts
+================
+
+In digital typography, a "font" is a collection of characters in a
+specific typeface that a device can render as glyphs at a desired
+size.(1)  (*note Using Fonts-Footnote-1::) A 'roff' formatter can change
+typefaces at any point in the text.  The basic faces are a set of
+"styles" combining upright and slanted shapes with normal and heavy
+stroke weights: 'R', 'I', 'B', and 'BI'--these stand for roman, italic,
+bold, and bold-italic.  For linguistic text, GNU 'troff' groups
+typefaces into "families" containing each of these styles.(2)  (*note
+Using Fonts-Footnote-2::) A "text font" is thus often a family combined
+with a style, but it need not be: consider the 'ps' and 'pdf' devices'
+'ZCMI' (Zapf Chancery Medium italic)--often, no other style of Zapf
+Chancery Medium is provided.  On typesetting devices, at least one
+"special font" is available, comprising "unstyled" glyphs for
+mathematical operators and other purposes.
+
+   Like AT&T 'troff', GNU 'troff' does not itself load or manipulate a
+digital font file;(3) (*note Using Fonts-Footnote-3::) instead it works
+with a "font description file" that characterizes it, including its
+glyph repertoire and the "metrics" (dimensions) of each glyph.(4)
+(*note Using Fonts-Footnote-4::) This information permits the formatter
+to accurately place glyphs with respect to each other.  Before using a
+font description, the formatter associates it with a "mounting
+position", a place in an ordered list of available typefaces.  So that a
+document need not be strongly coupled to a specific font family, in GNU
+'troff' an output device can associate a style in the abstract sense
+with a mounting position.  Thus the default family can be combined with
+a style dynamically, producing a "resolved font name".
+
+   Fonts often have trademarked names, and even Free Software fonts can
+require renaming upon modification.  'groff' maintains a convention that
+a device's serif font family is given the name 'T' ("Times"), its
+sans-serif family 'H' ("Helvetica"), and its monospaced family 'C'
+("Courier").  Historical inertia has driven 'groff''s font identifiers
+to short uppercase abbreviations of font names, as with 'TR', 'TI',
+'TB', 'TBI', and a special font 'S'.
+
+   The default family used with abstract styles can be changed at any
+time; initially, it is 'T'.  Typically, abstract styles are arranged in
+the first four mounting positions in the order shown above.  The default
+mounting position, and therefore style, is always '1' ('R').  By issuing
+appropriate formatter instructions, you can override these defaults
+before your document writes its first glyph.
+
+   Terminal output devices cannot change font families and lack special
+fonts.  They support style changes by overstriking, or by altering
+ISO 6429/ECMA-48 "graphic renditions" (character cell attributes).
+
+* Menu:
+
+* Selecting Fonts::
+* Font Families::
+* Font Positions::
+* Using Symbols::
+* Character Classes::
+* Special Fonts::
+* Artificial Fonts::
+* Ligatures and Kerning::
+* Italic Corrections::
+* Dummy Characters::
+
+&#x1f;
+File: groff.info,  Node: Using Fonts-Footnotes,  Up: Using Fonts
+
+   (1) Terminals and some output devices have fonts that render at only
+one or two sizes.  As examples of the latter, take the 'groff' 'lj4'
+device's Lineprinter, and 'lbp''s Courier and Elite faces.
+
+   (2) Font designers prepare families such that the styles share
+esthetic properties.
+
+   (3) Historically, the fonts 'troff's dealt with were not Free
+Software or, as with the Graphic Systems C/A/T, did not even exist in
+the digital domain.
+
+   (4) *Note Font Description File Format::.
+

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.info-2 Added

@@ -0,0 +1,7529 @@
+This is groff.info, produced by makeinfo version 7.0.3 from groff.texi.
+
+This manual documents GNU 'troff' version 1.23.0.
+
+   Copyright © 1994-2023 Free Software Foundation, Inc.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.3 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     no Back-Cover Texts.  A copy of the license is included in the
+     section entitled "GNU Free Documentation License".
+INFO-DIR-SECTION Typesetting
+START-INFO-DIR-ENTRY
+* Groff: (groff).               The GNU roff document formatting system.
+END-INFO-DIR-ENTRY
+
+&#x1f;
+File: groff.info,  Node: Selecting Fonts,  Next: Font Families,  Prev: Using Fonts,  Up: Using Fonts
+
+5.19.1 Selecting Fonts
+----------------------
+
+We use "font" to refer to any of several means of identifying a font: by
+mounting position ('3'), by abstract style ('B'), or by its identifier
+('TB').
+
+ -- Request: .ft font
+ -- Escape sequence: \ff
+ -- Escape sequence: \f(fn
+ -- Escape sequence: \ffont
+ -- Register: \n.fn
+     The 'ft' request selects the typeface FONT.  If the argument is
+     absent or 'P', it selects the previously chosen font.  If FONT is a
+     non-negative integer, it is interpreted as mounting position; the
+     font mounted there is selected.  If that position refers to an
+     abstract style, it is combined with the default family (see 'fam'
+     and '\F' below) to make a resolved font name.  If the mounting
+     position is not a style and no font is mounted there, GNU 'troff'
+     emits a warning in category 'font' and ignores the request.
+
+     If FONT matches a style name, it is combined with the current
+     family to make a resolved font name.  Otherwise, FONT is assumed to
+     already be a resolved font name.
+
+     The resolved font name is subject to translation (see request 'ftr'
+     below).  Next, the (possibly translated) font name's mounting
+     position is looked up; if not mounted, FONT is sought on the file
+     system as a font description file and, if located, automatically
+     mounted at the next available position (see register '.fp' below).
+     If the font was mounted using an identifier different from its font
+     description file name (see request 'fp' below), that file name is
+     then looked up.  If a font description file for the resolved font
+     name is not found, GNU 'troff' emits a warning in category 'font'
+     and ignores the request.
+
+     The '\f' escape sequence is similar, using one-character name (or
+     mounting position) F, two-character name FN, or a name FONT of
+     arbitrary length.  '\f' selects the previous font.  The syntax
+     form '\fP' is supported for backward compatibility, and '\fP' for
+     consistency.
+
+          eggs, bacon,
+          .ft I
+          spam,
+          .ft
+          and sausage.
+          .br
+          eggs, bacon, \fIspam,\fP and sausage.
+              => eggs, bacon, spam, and sausage
+              => eggs, bacon, spam, and sausage
+
+     The current and previously selected fonts are properties of the
+     environment (*note Environments::).
+
+     The read-only string-valued register '.fn' contains the resolved
+     font name of the selected font.
+
+     '\f' doesn't produce an input token in GNU 'troff'; it thus can be
+     used in requests that expect a single-character argument.  We can
+     assign a font to a margin character as follows (*note
+     Miscellaneous::).
+
+          .mc \fIx\f
+
+ -- Request: .ftr f g
+     Translate font F to font G.  Whenever a font named F is referred to
+     in a '\f' escape sequence, in the 'F' and 'S' conditional
+     operators, or in the 'ft', 'ul', 'bd', 'cs', 'tkf', 'special',
+     'fspecial', 'fp', or 'sty' requests, font G is used.  If G is
+     missing or equal to F the translation is undone.
+
+     Font translations cannot be chained.
+
+          .ftr XXX TR
+          .ftr XXX YYY
+          .ft XXX
+              error-> warning: can't find font 'XXX'
+
+ -- Request: .fzoom f zoom
+ -- Register: \n.zoom
+     Set magnification of font F to factor ZOOM, which must be a
+     non-negative integer multiple of 1/1000th.  This request is useful
+     to adjust the optical size of a font in relation to the others.  In
+     the example below, font 'CR' is magnified by 10% (the zoom factor
+     is thus 1.1).
+
+          .fam P
+          .fzoom CR 1100
+          .ps 12
+          Palatino and \fCRCourier\f
+
+     A missing or zero value of ZOOM is the same as a value of 1000,
+     which means no magnification.  F must be a resolved font name, not
+     an abstract style.
+
+     The magnification of a font is completely transparent to GNU
+     'troff'; a change of the zoom factor doesn't cause any effect
+     except that the dimensions of glyphs, (word) spaces, kerns, etc.,
+     of the affected font are adjusted accordingly.
+
+     The zoom factor of the current font is available in the read-only
+     register '.zoom', in multiples of 1/1000th.  It returns zero if
+     there is no magnification.
+
+&#x1f;
+File: groff.info,  Node: Font Families,  Next: Font Positions,  Prev: Selecting Fonts,  Up: Using Fonts
+
+5.19.2 Font Families
+--------------------
+
+To accommodate the wide variety of fonts available, GNU 'troff'
+distinguishes "font families" and "font styles".  A resolved font name
+is the catenation of a font family and a style.  Selecting an abstract
+style causes GNU 'troff' to combine it with the default font family.
+
+   You can thus compose a document using abstract styles exclusively for
+its body or running text, selecting a specific family only for titles or
+examples, for instance, and change the default family on the command
+line (recall *note Groff Options::).
+
+   Fonts for the devices 'ps', 'pdf', 'dvi', 'lj4', 'lbp', and the X11
+devices support this mechanism.  By default, GNU 'troff' uses the Times
+family with the four styles 'R', 'I', 'B', and 'BI'.
+
+ -- Request: .fam family
+ -- Register: \n.fam
+ -- Escape sequence: \Ff
+ -- Escape sequence: \F(fm
+ -- Escape sequence: \Ffamily
+     Set the default font family, used in combination with abstract
+     styles to construct a resolved font name, to FAMILY (one-character
+     name F, two-character name FM).  If no argument is given, GNU
+     'troff' selects the previous font family; if there none, is it
+     falls back to the device's default(1) (*note Font
+     Families-Footnote-1::) or its own ('T').
+
+     The '\F' escape sequence works similarly.  In disanalogy to '\f',
+     '\FP' makes 'P' the default family.  Use '\F' to select the
+     previous default family.  The default font family is available in
+     the read-only string-valued register '.fam'; it is associated with
+     the environment (*note Environments::).
+
+          spam,     \" startup defaults are T (Times) R (roman)
+          .fam H    \" make Helvetica the default family
+          spam,     \" family H + style R = HR
+          .ft B     \" family H + style B = HB
+          spam,
+          .ft CR    \" Courier roman (default family not changed)
+          spam,
+          .ft       \" back to Helvetica bold
+          spam,
+          .fam T    \" make Times the default family
+          spam,     \" family T + style B = TB
+          .ft AR    \" font AR (not a style)
+          baked beans,
+          .ft R     \" family T + style R = TR
+          and spam.
+
+     '\F' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font family on the
+     fly.
+
+          .mc \FPx\F
+
+ -- Request: .sty n style
+ -- Register: \n.sty
+     Associate an abstract style STYLE with mounting position N, which
+     must be a non-negative integer.  If the requests 'cs', 'bd', 'tkf',
+     'uf', or 'fspecial' are applied to an abstract style, they are
+     instead applied to the member of the current family corresponding
+     to that style.
+
+     The default family can be set with the '-f' option (*note Groff
+     Options::).  The 'styles' command in the 'DESC' file controls which
+     font positions (if any) are initially associated with abstract
+     styles rather than fonts.
+
+     *Caution:* The STYLE argument is not validated.  Errors may occur
+     later, when the formatter attempts to construct a resolved font
+     name, or format a character for output.
+
+          .nr BarPos \n.fp
+          .sty \n.fp Bar
+          .fam Foo
+          .ft \nBarPos
+          .tm .f=\n.f
+          A
+              error-> error: no font family named 'Foo' exists
+              error-> .f=41
+              error-> error: cannot format glyph: no current font
+
+     When an abstract style has been selected, the read-only
+     string-valued register '.sty' interpolates its name; this datum is
+     associated with the environment (*note Environments::).  Otherwise,
+     '.sty' interpolates nothing.
+
+&#x1f;
+File: groff.info,  Node: Font Families-Footnotes,  Up: Font Families
+
+   (1) *Note DESC File Format::.
+
+&#x1f;
+File: groff.info,  Node: Font Positions,  Next: Using Symbols,  Prev: Font Families,  Up: Using Fonts
+
+5.19.3 Font Positions
+---------------------
+
+To support typeface indirection through abstract styles, and for
+compatibility with AT&T 'troff', the formatter maintains a list of font
+"positions" at which fonts required by a document are "mounted".  An
+output device's description file 'DESC' typically configures a set of
+pre-mounted fonts; see *note Device and Font Description Files::.  A
+font need not be explicitly mounted before it is selected; GNU 'troff'
+will search 'GROFF_FONT_PATH' for it by name and mount it at the first
+free mounting position on demand.
+
+ -- Request: .fp pos id font-description-file-name
+ -- Register: \n.f
+ -- Register: \n.fp
+     Mount a font under the name ID at mounting position POS, a
+     non-negative integer.  When the formatter starts up, it reads the
+     output device's description to mount an initial set of faces, and
+     selects font position 1.  Position 0 is unused by default.  Unless
+     the FONT-DESCRIPTION-FILE-NAME argument is given, ID should be the
+     name of a font description file stored in a directory corresponding
+     to the selected output device.  GNU 'troff' does not traverse
+     directories to locate the font description file.
+
+     The optional third argument enables font names to be aliased, which
+     can be necessary in compatibility mode since AT&T 'troff' syntax
+     affords no means of identifying fonts with names longer than two
+     characters, like 'TBI' or 'ZCMI', in a font selection escape
+     sequence.  *Note Compatibility Mode::.  You can also alias fonts on
+     mounting for convenience or abstraction.  (See below regarding the
+     '.fp' register.)
+
+          .fp \n.fp SC ZCMI
+          Send a \f(SChand-written\fP thank-you note.
+          .fp \n.fp Emph TI
+          .fp \n.fp Strong TB
+          Are \fEmphthese names\f \fStrongcomfortable\f?
+
+     'DESC', 'P', and non-negative integers are not usable as font
+     identifiers.
+
+     The position of the currently selected font (or abstract style) is
+     available in the read-only register '.f'.  It is associated with
+     the environment (*note Environments::).
+
+     You can copy the value of '.f' to another register to save it for
+     later use.
+
+          .nr saved-font \n.f
+          ... text involving many font changes ...
+          .ft \nsaved-font
+
+     The index of the next (non-zero) free font position is available in
+     the read-only register '.fp'.  Fonts not listed in the 'DESC' file
+     are automatically mounted at position '\n.fp' when selected with
+     the 'ft' request or '\f' escape sequence.  When mounting a font at
+     a position explicitly with the 'fp' request, this same practice
+     should be followed, although GNU 'troff' does not enforce this
+     strictly.
+
+&#x1f;
+File: groff.info,  Node: Using Symbols,  Next: Character Classes,  Prev: Font Positions,  Up: Using Fonts
+
+5.19.4 Using Symbols
+--------------------
+
+A "glyph" is a graphical representation of a "character".  While a
+character is an abstraction of semantic information, a glyph is
+something that can be seen on screen or paper.  A character has many
+possible representation forms (for example, the character 'A' can be
+written in an upright or slanted typeface, producing distinct glyphs).
+Sometimes, a sequence of characters map to a single glyph: this is a
+"ligature"--the most common is 'fi'.
+
+   Space characters never become glyphs in GNU 'troff'.  If not
+discarded (as when trailing on text lines), they are represented by
+horizontal motions in the output.
+
+   A "symbol" is simply a named glyph.  Within 'gtroff', all glyph names
+of a particular font are defined in its font file.  If the user requests
+a glyph not available in this font, 'gtroff' looks up an ordered list of
+"special fonts".  By default, the PostScript output device supports the
+two special fonts 'SS' (slanted symbols) and 'S' (symbols) (the former
+is looked up before the latter).  Other output devices use different
+names for special fonts.  Fonts mounted with the 'fonts' keyword in the
+'DESC' file are globally available.  To install additional special fonts
+locally (i.e., for a particular font), use the 'fspecial' request.
+
+   Here are the exact rules how 'gtroff' searches a given symbol:
+
+   * If the symbol has been defined with the 'char' request, use it.
+     This hides a symbol with the same name in the current font.
+
+   * Check the current font.
+
+   * If the symbol has been defined with the 'fchar' request, use it.
+
+   * Check whether the current font has a font-specific list of special
+     fonts; test all fonts in the order of appearance in the last
+     'fspecial' call if appropriate.
+
+   * If the symbol has been defined with the 'fschar' request for the
+     current font, use it.
+
+   * Check all fonts in the order of appearance in the last 'special'
+     call.
+
+   * If the symbol has been defined with the 'schar' request, use it.
+
+   * As a last resort, consult all fonts loaded up to now for special
+     fonts and check them, starting with the lowest font number.  This
+     can sometimes lead to surprising results since the 'fonts' line in
+     the 'DESC' file often contains empty positions, which are filled
+     later on.  For example, consider the following:
+
+          fonts 3 0 0 FOO
+
+     This mounts font 'foo' at font position 3.  We assume that 'FOO' is
+     a special font, containing glyph 'foo', and that no font has been
+     loaded yet.  The line
+
+          .fspecial BAR BAZ
+
+     makes font 'BAZ' special only if font 'BAR' is active.  We further
+     assume that 'BAZ' is really a special font, i.e., the font
+     description file contains the 'special' keyword, and that it also
+     contains glyph 'foo' with a special shape fitting to font 'BAR'.
+     After executing 'fspecial', font 'BAR' is loaded at font
+     position 1, and 'BAZ' at position 2.
+
+     We now switch to a new font 'XXX', trying to access glyph 'foo'
+     that is assumed to be missing.  There are neither font-specific
+     special fonts for 'XXX' nor any other fonts made special with the
+     'special' request, so 'gtroff' starts the search for special fonts
+     in the list of already mounted fonts, with increasing font
+     positions.  Consequently, it finds 'BAZ' before 'FOO' even for
+     'XXX', which is not the intended behaviour.
+
+   *Note Device and Font Description Files::, and *note Special Fonts::,
+for more details.
+
+   The 'groff_char(7)' man page houses a complete list of predefined
+special character names, but the availability of any as a glyph is
+device- and font-dependent.  For example, say
+
+     man -Tdvi groff_char > groff_char.dvi
+
+to obtain those available with the DVI device and default font
+configuration.(1)  (*note Using Symbols-Footnote-1::) If you want to use
+an additional macro package to change the fonts used, 'groff' (or
+'gtroff') must be run directly.
+
+     groff -Tdvi -mec -man groff_char.7 > groff_char.dvi
+
+   Special character names not listed in 'groff_char(7)' are derived
+algorithmically, using a simplified version of the Adobe Glyph List
+(AGL) algorithm, which is described in
+<https://github.com/adobe-type-tools/agl-aglfn>.  The (frozen) set of
+names that can't be derived algorithmically is called the "'groff' glyph
+list (GGL)".
+
+   * A glyph for Unicode character U+XXXXXX, which is not a
+     composite character is named 'uXXXXXX'.  X must be an uppercase
+     hexadecimal digit.  Examples: 'u1234', 'u008E', 'u12DB8'.  The
+     largest Unicode value is 0x10FFFF. There must be at least four 'X'
+     digits; if necessary, add leading zeroes (after the 'u').  No zero
+     padding is allowed for character codes greater than 0xFFFF.
+     Surrogates (i.e., Unicode values greater than 0xFFFF represented
+     with character codes from the surrogate area U+D800-U+DFFF) are not
+     allowed either.
+
+   * A glyph representing more than a single input character is named
+
+          'u' COMPONENT1 '_' COMPONENT2 '_' COMPONENT3 ...
+
+     Example: 'u0045_0302_0301'.
+
+     For simplicity, all Unicode characters that are composites must be
+     maximally decomposed to NFD;(2) (*note Using Symbols-Footnote-2::)
+     for example, 'u00CA_0301' is not a valid glyph name since U+00CA
+     (LATIN CAPITAL LETTER E WITH CIRCUMFLEX) can be further decomposed
+     into U+0045 (LATIN CAPITAL LETTER E) and U+0302 (COMBINING
+     CIRCUMFLEX ACCENT).  'u0045_0302_0301' is thus the glyph name for
+     U+1EBE, LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND ACUTE.
+
+   * groff maintains a table to decompose all algorithmically derived
+     glyph names that are composites itself.  For example, 'u0100'
+     (LATIN LETTER A WITH MACRON) is automatically decomposed into
+     'u0041_0304'.  Additionally, a glyph name of the GGL is preferred
+     to an algorithmically derived glyph name; 'groff' also
+     automatically does the mapping.  Example: The glyph 'u0045_0302' is
+     mapped to '^E'.
+
+   * glyph names of the GGL can't be used in composite glyph names; for
+     example, '^E_u0301' is invalid.
+
+ -- Escape sequence: \(nm
+ -- Escape sequence: \name
+ -- Escape sequence: \base-glyph combining-component ...
+     Typeset a special character NAME (two-character name NM) or a
+     composite glyph consisting of BASE-GLYPH overlaid with one or more
+     COMBINING-COMPONENTs.  For example, '\A ho' is a capital letter
+     "A" with a "hook accent" (ogonek).
+
+     There is no special syntax for one-character names--the analogous
+     form '\N' would collide with other escape sequences.  However, the
+     four escape sequences '\'', '\-', '\_', and '\`', are translated on
+     input to the special character escape sequences '\aa', '\-',
+     '\ul', and '\ga', respectively.
+
+     A special character name of length one is not the same thing as an
+     ordinary character: that is, the character 'a' is not the same as
+     '\a'.
+
+     If NAME is undefined, a warning in category 'char' is produced and
+     the escape is ignored.  *Note Warnings::, for information about the
+     enablement and suppression of warnings.
+
+     GNU 'troff' resolves '\...' with more than a single component as
+     follows:
+
+        * Any component that is found in the GGL is converted to the
+          'uXXXX' form.
+
+        * Any component 'uXXXX' that is found in the list of
+          decomposable glyphs is decomposed.
+
+        * The resulting elements are then concatenated with '_' in
+          between, dropping the leading 'u' in all elements but the
+          first.
+
+     No check for the existence of any component (similar to 'tr'
+     request) is done.
+
+     Examples:
+
+     '\A ho'
+          'A' maps to 'u0041', 'ho' maps to 'u02DB', thus the final
+          glyph name would be 'u0041_02DB'.  This is not the expected
+          result: the ogonek glyph 'ho' is a spacing ogonek, but for a
+          proper composite a non-spacing ogonek (U+0328) is necessary.
+          Looking into the file 'composite.tmac', one can find
+          '.composite ho u0328', which changes the mapping of 'ho' while
+          a composite glyph name is constructed, causing the final glyph
+          name to be 'u0041_0328'.
+
+     '\^E u0301'
+     '\^E aa'
+     '\E a^ aa'
+     '\E ^ ''
+          '^E' maps to 'u0045_0302', thus the final glyph name is
+          'u0045_0302_0301' in all forms (assuming proper calls of the
+          'composite' request).
+
+     It is not possible to define glyphs with names like 'A ho' within a
+     'groff' font file.  This is not really a limitation; instead, you
+     have to define 'u0041_0328'.
+
+ -- Escape sequence: \C'xxx'
+     Typeset the glyph of the special character XXX.  Normally, it is
+     more convenient to use '\XXX', but '\C' has some advantages: it
+     is compatible with AT&T device-independent 'troff' (and therefore
+     available in compatibility mode(3) (*note Using
+     Symbols-Footnote-3::)) and can interpolate special characters with
+     '' in their names.  The delimiter need not be a neutral
+     apostrophe; see *note Delimiters::.
+
+ -- Request: .composite id1 id2
+     Map special character name ID1 to ID2 if ID1 is used in '\...'
+     with more than one component.  See above for examples.  This is a
+     strict rewriting of the special character name; no check is
+     performed for the existence of a glyph for either.  A set of
+     default mappings for many accents can be found in the file
+     'composite.tmac', loaded by the default 'troffrc' at startup.
+
+ -- Escape sequence: \N'n'
+     Typeset the glyph with code N in the current font ('n' is _not_ the
+     input character code).  The number N can be any non-negative
+     decimal integer.  Most devices only have glyphs with codes between
+     0 and 255; the Unicode output device uses codes in the range
+     0-65535.  If the current font does not contain a glyph with that
+     code, special fonts are _not_ searched.  The '\N' escape sequence
+     can be conveniently used in conjunction with the 'char' request:
+
+          .char \phone \fZD\N'37'
+
+     The code of each glyph is given in the fourth column in the font
+     description file after the 'charset' command.  It is possible to
+     include unnamed glyphs in the font description file by using a name
+     of '---'; the '\N' escape sequence is the only way to use these.
+
+     No kerning is applied to glyphs accessed with '\N'.  The delimiter
+     need not be a neutral apostrophe; see *note Delimiters::.
+
+   A few escape sequences are also special characters.
+
+ -- Escape sequence: \'
+     An escaped neutral apostrophe is a synonym for '\aa' (acute
+     accent).
+
+ -- Escape sequence: \`
+     An escaped grave accent is a synonym for '\ga' (grave accent).
+
+ -- Escape sequence: \-
+     An escaped hyphen-minus is a synonym for '\-' (minus sign).
+
+ -- Escape sequence: \_
+     An escaped underscore ("low line") is a synonym for '\ul'
+     (underrule).  On typesetting devices, the underrule is
+     font-invariant and drawn lower than the underscore '_'.
+
+ -- Request: .cflags n c1 c2 ...
+     Assign properties encoded by the number N to characters C1, C2, and
+     so on.
+
+     Input characters, including special characters introduced by an
+     escape, have certain properties associated with them.(4)  (*note
+     Using Symbols-Footnote-4::) These properties can be modified with
+     this request.  The first argument is the sum of the desired flags
+     and the remaining arguments are the characters to be assigned those
+     properties.  Spaces between the CN arguments are optional.  Any
+     argument CN can be a character class defined with the 'class'
+     request rather than an individual character.  *Note Character
+     Classes::.
+
+     The non-negative integer N is the sum of any of the following.
+     Some combinations are nonsensical, such as '33' (1 + 32).
+
+     '1'
+          Recognize the character as ending a sentence if followed by a
+          newline or two spaces.  Initially, characters '.?!' have this
+          property.
+
+     '2'
+          Enable breaks before the character.  A line is not broken at a
+          character with this property unless the characters on each
+          side both have non-zero hyphenation codes.  This exception can
+          be overridden by adding 64.  Initially, no characters have
+          this property.
+
+     '4'
+          Enable breaks after the character.  A line is not broken at a
+          character with this property unless the characters on each
+          side both have non-zero hyphenation codes.  This exception can
+          be overridden by adding 64.  Initially, characters
+          '\-\hy\em' have this property.
+
+     '8'
+          Mark the glyph associated with this character as overlapping
+          other instances of itself horizontally.  Initially, characters
+          '\ul\rn\ru\radicalex\sqrtex' have this property.
+
+     '16'
+          Mark the glyph associated with this character as overlapping
+          other instances of itself vertically.  Initially, the
+          character '\br' has this property.
+
+     '32'
+          Mark the character as transparent for the purpose of
+          end-of-sentence recognition.  In other words, an
+          end-of-sentence character followed by any number of characters
+          with this property is treated as the end of a sentence if
+          followed by a newline or two spaces.  This is the same as
+          having a zero space factor in TeX.  Initially, characters
+          '"')*\dg\dd\rq\cq' have this property.
+
+     '64'
+          Ignore hyphenation codes of the surrounding characters.  Use
+          this in combination with values 2 and 4 (initially, no
+          characters have this property).
+
+          For example, if you need an automatic break point after the
+          en-dash in numeric ranges like "3000-5000", insert
+
+               .cflags 68 \en
+
+          into your document.  However, this practice can lead to bad
+          layout if done thoughtlessly; in most situations, a better
+          solution instead of changing the 'cflags' value is to insert
+          '\:' right after the hyphen at the places that really need a
+          break point.
+
+     The remaining values were implemented for East Asian language
+     support; those who use alphabetic scripts exclusively can disregard
+     them.
+
+     '128'
+          Prohibit a line break before the character, but allow a line
+          break after the character.  This works only in combination
+          with flags 256 and 512 and has no effect otherwise.
+          Initially, no characters have this property.
+
+     '256'
+          Prohibit a line break after the character, but allow a line
+          break before the character.  This works only in combination
+          with flags 128 and 512 and has no effect otherwise.
+          Initially, no characters have this property.
+
+     '512'
+          Allow line break before or after the character.  This works
+          only in combination with flags 128 and 256 and has no effect
+          otherwise.  Initially, no characters have this property.
+
+     In contrast to values 2 and 4, the values 128, 256, and 512 work
+     pairwise.  If, for example, the left character has value 512, and
+     the right character 128, no break will be automatically inserted
+     between them.  If we use value 6 instead for the left character, a
+     break after the character can't be suppressed since the neighboring
+     character on the right doesn't get examined.
+
+ -- Request: .char c contents
+ -- Request: .fchar c contents
+ -- Request: .fschar f c contents
+ -- Request: .schar c contents
+     Define a new character or glyph C to be CONTENTS, which can be
+     empty.  More precisely, 'char' defines a 'groff' object (or
+     redefines an existing one) that is accessed with the name C on
+     input, and produces CONTENTS on output.  Every time glyph C needs
+     to be printed, CONTENTS is processed in a temporary environment and
+     the result is wrapped up into a single object.  Compatibility mode
+     is turned off and the escape character is set to '\' while CONTENTS
+     is processed.  Any emboldening, constant spacing, or track kerning
+     is applied to this object rather than to individual glyphs in
+     CONTENTS.
+
+     An object defined by these requests can be used just like a normal
+     glyph provided by the output device.  In particular, other
+     characters can be translated to it with the 'tr' or 'trin'
+     requests; it can be made the leader character with the 'lc'
+     request; repeated patterns can be drawn with it using the '\l' and
+     '\L' escape sequences; and words containing C can be hyphenated
+     correctly if the 'hcode' request is used to give the object a
+     hyphenation code.
+
+     There is a special anti-recursion feature: use of the object within
+     its own definition is handled like a normal character (not defined
+     with 'char').
+
+     The 'tr' and 'trin' requests take precedence if 'char' accesses the
+     same symbol.
+
+          .tr XY
+          X
+              => Y
+          .char X Z
+          X
+              => Y
+          .tr XX
+          X
+              => Z
+
+     The 'fchar' request defines a fallback glyph: 'gtroff' only checks
+     for glyphs defined with 'fchar' if it cannot find the glyph in the
+     current font.  'gtroff' carries out this test before checking
+     special fonts.
+
+     'fschar' defines a fallback glyph for font F: 'gtroff' checks for
+     glyphs defined with 'fschar' after the list of fonts declared as
+     font-specific special fonts with the 'fspecial' request, but before
+     the list of fonts declared as global special fonts with the
+     'special' request.
+
+     Finally, the 'schar' request defines a global fallback glyph:
+     'gtroff' checks for glyphs defined with 'schar' after the list of
+     fonts declared as global special fonts with the 'special' request,
+     but before the already mounted special fonts.
+
+     *Note Character Classes::.
+
+ -- Request: .rchar c ...
+ -- Request: .rfschar f c ...
+     Remove definition of each ordinary or special character C, undoing
+     the effect of a 'char', 'fchar', or 'schar' request.  Those
+     supplied by font description files cannot be removed.  Spaces and
+     tabs may separate C arguments.
+
+     The request 'rfschar' removes glyph definitions defined with
+     'fschar' for font F.
+
+&#x1f;
+File: groff.info,  Node: Using Symbols-Footnotes,  Up: Using Symbols
+
+   (1) Not all versions of the 'man' program support the '-T' option;
+use the subsequent example for an alternative.
+
+   (2) This is "Normalization Form D" as documented in Unicode Standard
+Annex #15 (<https://unicode.org/reports/tr15/>).
+
+   (3) *Note Compatibility Mode::.
+
+   (4) Output glyphs don't--to GNU 'troff', a glyph is simply a box with
+an index into a font, a given height above and depth below the baseline,
+and a width.
+
+&#x1f;
+File: groff.info,  Node: Character Classes,  Next: Special Fonts,  Prev: Using Symbols,  Up: Using Fonts
+
+5.19.5 Character Classes
+------------------------
+
+Classes are particularly useful for East Asian languages such as
+Chinese, Japanese, and Korean, where the number of needed characters is
+much larger than in European languages, and where large sets of
+characters share the same properties.
+
+ -- Request: .class name c1 c2 ...
+     Define a character class (or simply "class") NAME comprising the
+     characters C1, C2, and so on.
+
+     A class thus defined can then be referred to in lieu of listing all
+     the characters within it.  Currently, only the 'cflags' request can
+     handle references to character classes.
+
+     In the request's simplest form, each CN is a character (or special
+     character).
+
+          .class quotes ' \aq \dq \oq \cq \lq \rq
+
+     Since class and glyph names share the same name space, it is
+     recommended to start and end the class name with '' and '',
+     respectively, to avoid collisions with existing character names
+     defined by GNU 'troff' or the user (with 'char' and related
+     requests).  This practice applies the presence of '' in the class
+     name to prevent the use of the special character escape form
+     '\...', thus you must use the '\C' escape to access a class with
+     such a name.
+
+     You can also use a character range notation consisting of a start
+     character followed by '-' and then an end character.  Internally,
+     GNU 'troff' converts these two symbol names to Unicode code points
+     (according to the 'groff' glyph list GGL), which then give the
+     start and end value of the range.  If that fails, the class
+     definition is skipped.
+
+     Furthermore, classes can be nested.
+
+          .class prepunct , : ; > }
+          .class prepunctx \C'prepunct' \u2013-\u2016
+
+     The class 'prepunctx' thus contains the contents of the class
+     'prepunct' as defined above (the set ', : ; > }'), and characters
+     in the range between 'U+2013' and 'U+2016'.
+
+     If you want to include '-' in a class, it must be the first
+     character value in the argument list, otherwise it gets
+     misinterpreted as part of the range syntax.
+
+     It is not possible to use class names as end points of range
+     definitions.
+
+     A typical use of the 'class' request is to control line-breaking
+     and hyphenation rules as defined by the 'cflags' request.  For
+     example, to inhibit line breaks before the characters belonging to
+     the 'prepunctx' class defined in the previous example, you can
+     write the following.
+
+          .cflags 2 \C'prepunctx'
+
+     See the 'cflags' request in *note Using Symbols::, for more
+     details.
+
+&#x1f;
+File: groff.info,  Node: Special Fonts,  Next: Artificial Fonts,  Prev: Character Classes,  Up: Using Fonts
+
+5.19.6 Special Fonts
+--------------------
+
+Special fonts are those that 'gtroff' searches when it cannot find the
+requested glyph in the current font.  The Symbol font is usually a
+special font.
+
+   'gtroff' provides the following two requests to add more special
+fonts.  *Note Using Symbols::, for a detailed description of the glyph
+searching mechanism in 'gtroff'.
+
+   Usually, only non-TTY devices have special fonts.
+
+ -- Request: .special s1 s2 ...
+ -- Request: .fspecial f s1 s2 ...
+     Use the 'special' request to define special fonts.  Initially, this
+     list is empty.
+
+     Use the 'fspecial' request to designate special fonts only when
+     font F is active.  Initially, this list is empty.
+
+     Previous calls to 'special' or 'fspecial' are overwritten; without
+     arguments, the particular list of special fonts is set to empty.
+     Special fonts are searched in the order they appear as arguments.
+
+     All fonts that appear in a call to 'special' or 'fspecial' are
+     loaded.
+
+     *Note Using Symbols::, for the exact search order of glyphs.
+
+&#x1f;
+File: groff.info,  Node: Artificial Fonts,  Next: Ligatures and Kerning,  Prev: Special Fonts,  Up: Using Fonts
+
+5.19.7 Artificial Fonts
+-----------------------
+
+There are a number of requests and escape sequences for artificially
+creating fonts.  These are largely vestiges of the days when output
+devices did not have a wide variety of fonts, and when 'nroff' and
+'troff' were separate programs.  Most of them are no longer necessary in
+GNU 'troff'.  Nevertheless, they are supported.
+
+ -- Escape sequence: \H'height'
+ -- Escape sequence: \H'+height'
+ -- Escape sequence: \H'-height'
+ -- Register: \n.height
+     Change (increment, decrement) the height of the current font, but
+     not the width.  If HEIGHT is zero, restore the original height.
+     Default scaling unit is 'z'.
+
+     The read-only register '.height' contains the font height as set by
+     '\H'.
+
+     Currently, only the '-Tps' and '-Tpdf' devices support this
+     feature.
+
+     '\H' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font on the fly:
+
+          .mc \H'+5z'x\H'0'
+
+     In compatibility mode, 'gtroff' behaves differently: If an
+     increment or decrement is used, it is always taken relative to the
+     current type size and not relative to the previously selected font
+     height.  Thus,
+
+          .cp 1
+          \H'+5'test \H'+5'test
+
+     prints the word 'test' twice with the same font height (five points
+     larger than the current font size).
+
+ -- Escape sequence: \S'slant'
+ -- Register: \n.slant
+     Slant the current font by SLANT degrees.  Positive values slant to
+     the right.  Only integer values are possible.
+
+     The read-only register '.slant' contains the font slant as set by
+     '\S'.
+
+     Currently, only the '-Tps' and '-Tpdf' devices support this
+     feature.
+
+     '\S' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font on the fly:
+
+          .mc \S'20'x\S'0'
+
+     This escape is incorrectly documented in the AT&T 'troff' manual;
+     the slant is always set to an absolute value.
+
+ -- Request: .ul lines
+     The 'ul' request normally underlines subsequent lines if a TTY
+     output device is used.  Otherwise, the lines are printed in italics
+     (only the term 'underlined' is used in the following).  The single
+     argument is the quantity of input lines to be underlined; with no
+     argument, the next line is underlined.  If LINES is zero or
+     negative, stop the effects of 'ul' (if it was active).  Requests
+     and empty lines do not count for computing the number of underlined
+     input lines, even if they produce some output like 'tl'.  Lines
+     inserted by macros (e.g., invoked by a trap) do count.
+
+     At the beginning of 'ul', the current font is stored and the
+     underline font is activated.  Within the span of a 'ul' request, it
+     is possible to change fonts, but after the last line affected by
+     'ul' the saved font is restored.
+
+     This number of lines still to be underlined is associated with the
+     environment (*note Environments::).  The underline font can be
+     changed with the 'uf' request.
+
+     The 'ul' request does not underline spaces.
+
+ -- Request: .cu lines
+     The 'cu' request is similar to 'ul' but underlines spaces as well
+     (if a TTY output device is used).
+
+ -- Request: .uf font
+     Set the underline font (globally) used by 'ul' and 'cu'.  By
+     default, this is the font at position 2.  FONT can be either a
+     non-negative font position or the name of a font.
+
+ -- Request: .bd font offset
+ -- Request: .bd font1 font2 offset
+ -- Register: \n.b
+     Embolden FONT by overstriking its glyphs offset by OFFSET units
+     minus one.
+
+     Two syntax forms are available.
+
+        * Imitate a bold font unconditionally.  The first argument
+          specifies the font to embolden, and the second is the number
+          of basic units, minus one, by which the two glyphs are offset.
+          If the second argument is missing, emboldening is turned off.
+
+          FONT can be either a non-negative font position or the name of
+          a font.
+
+          OFFSET is available in the '.b' read-only register if a
+          special font is active; in the 'bd' request, its default unit
+          is 'u'.
+
+        * Imitate a bold form conditionally.  Embolden FONT1 by OFFSET
+          only if font FONT2 is the current font.  This request can be
+          issued repeatedly to set up different emboldening values for
+          different current fonts.  If the second argument is missing,
+          emboldening is turned off for this particular current font.
+
+          This affects special fonts only (either set up with the
+          'special' command in font files or with the 'fspecial'
+          request).
+
+ -- Request: .cs font width em-size
+     Switch to and from "constant glyph space mode".  If activated, the
+     width of every glyph is WIDTH/36 ems.  The em size is given
+     absolutely by EM-SIZE; if this argument is missing, the em value is
+     taken from the current font size (as set with the 'ps' request)
+     when the font is effectively in use.  Without second and third
+     argument, constant glyph space mode is deactivated.
+
+     Default scaling unit for EM-SIZE is 'z'; WIDTH is an integer.
+
+&#x1f;
+File: groff.info,  Node: Ligatures and Kerning,  Next: Dummy Characters,  Prev: Artificial Fonts,  Up: Using Fonts
+
+5.19.8 Ligatures and Kerning
+----------------------------
+
+Ligatures are groups of characters that are run together, i.e, producing
+a single glyph.  For example, the letters 'f' and 'i' can form a
+ligature 'fi' as in the word 'file'.  This produces a cleaner look
+(albeit subtle) to the printed output.  Usually, ligatures are not
+available in fonts for TTY output devices.
+
+   Most PostScript fonts support the fi and fl ligatures.  The C/A/T
+typesetter that was the target of AT&T 'troff' also supported 'ff',
+'ffi', and 'ffl' ligatures.  Advanced typesetters or 'expert' fonts may
+include ligatures for 'ft' and 'ct', although GNU 'troff' does not
+support these (yet).
+
+   Only the current font is checked for ligatures and kerns; neither
+special fonts nor special charcters defined with the 'char' request (and
+its siblings) are taken into account.
+
+ -- Request: .lg flag
+ -- Register: \n.lg
+     Switch the ligature mechanism on or off; if the parameter is
+     non-zero or missing, ligatures are enabled, otherwise disabled.
+     Default is on.  The current ligature mode can be found in the
+     read-only register '.lg' (set to 1 or 2 if ligatures are enabled,
+     0 otherwise).
+
+     Setting the ligature mode to 2 enables the two-character ligatures
+     (fi, fl, and ff) and disables the three-character ligatures (ffi
+     and ffl).
+
+   "Pairwise kerning" is another subtle typesetting mechanism that
+modifies the distance between a glyph pair to improve readability.  In
+most cases (but not always) the distance is decreased.  Typewriter-like
+fonts and fonts for terminals where all glyphs have the same width don't
+use kerning.
+
+ -- Request: .kern flag
+ -- Register: \n.kern
+     Switch kerning on or off.  If the parameter is non-zero or missing,
+     enable pairwise kerning, otherwise disable it.  The read-only
+     register '.kern' is set to 1 if pairwise kerning is enabled,
+     0 otherwise.
+
+     If the font description file contains pairwise kerning information,
+     glyphs from that font are kerned.  Kerning between two glyphs can
+     be inhibited by placing '\&' between them: 'V\&A'.
+
+     *Note Font Description File Format::.
+
+   "Track kerning" expands or reduces the space between glyphs.  This
+can be handy, for example, if you need to squeeze a long word onto a
+single line or spread some text to fill a narrow column.  It must be
+used with great care since it is usually considered bad typography if
+the reader notices the effect.
+
+ -- Request: .tkf f s1 n1 s2 n2
+     Enable track kerning for font F.  If the current font is F the
+     width of every glyph is increased by an amount between N1 and N2
+     (N1, N2 can be negative); if the current type size is less than or
+     equal to S1 the width is increased by N1; if it is greater than or
+     equal to S2 the width is increased by N2; if the type size is
+     greater than or equal to S1 and less than or equal to S2 the
+     increase in width is a linear function of the type size.
+
+     The default scaling unit is 'z' for S1 and S2, 'p' for N1 and N2.
+
+     The track kerning amount is added even to the rightmost glyph in a
+     line; for large values it is thus recommended to increase the line
+     length by the same amount to compensate.
+
+&#x1f;
+File: groff.info,  Node: Italic Corrections,  Next: Dummy Characters,  Prev: Ligatures and Kerning,  Up: Using Fonts
+
+5.19.9 Italic Corrections
+-------------------------
+
+When typesetting adjacent glyphs from typefaces of different slants, the
+space between them may require adjustment.
+
+ -- Escape sequence: \/
+     Apply an "italic correction": modify the spacing of the preceding
+     glyph so that the distance between it and the following glyph is
+     correct if the latter is of upright shape.  For example, if an
+     italic 'f' is followed immediately by a roman right parenthesis,
+     then in many fonts the top right portion of the 'f' overlaps the
+     top left of the right parenthesis, which is ugly.  Use this escape
+     sequence whenever an oblique glyph is immediately followed by an
+     upright glyph without any intervening space.
+
+ -- Escape sequence: \,
+     Apply a "left italic correction": modify the spacing of the
+     following glyph so that the distance between it and the preceding
+     glyph is correct if the latter is of upright shape.  For example,
+     if a roman left parenthesis is immediately followed by an
+     italic 'f', then in many fonts the bottom left portion of the 'f'
+     overlaps the bottom of the left parenthesis, which is ugly.  Use
+     this escape sequence whenever an upright glyph is followed
+     immediately by an oblique glyph without any intervening space.
+
+&#x1f;
+File: groff.info,  Node: Dummy Characters,  Prev: Italic Corrections,  Up: Using Fonts
+
+5.19.10 Dummy Characters
+------------------------
+
+As discussed in *note Requests and Macros::, the first character on an
+input line is treated specially.  Further, formatting a glyph has many
+consequences on formatter state (*note Environments::).  Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
+
+ -- Escape sequence: \&
+     Interpolate a dummy character, which is constitutive of output but
+     invisible.(1)  (*note Dummy Characters-Footnote-1::) Its presence
+     alters the interpretation context of a subsequent input character,
+     and enjoys several applications.
+
+        * Prevent insertion of extra space after an end-of-sentence
+          character.
+
+               Test.
+               Test.
+                   => Test.  Test.
+               Test.\&
+               Test.
+                   => Test. Test.
+
+        * Prevent recognition of a control character.
+
+               .Test
+                   error-> warning: macro 'Test' not defined
+               \&.Test
+                   => .Test
+
+        * Prevent kerning between two glyphs.
+
+        * Translate a character to "nothing".
+
+               .tr JIjiK\&k\&UVuv
+               Post universitum, alea jacta est, OK?
+                   => Post vniversitvm, alea iacta est, O?
+
+     The dummy character escape sequence sees use in macro definitions
+     as a means of ensuring that arguments are treated as text even if
+     they begin with spaces or control characters.
+
+          .de HD \" typeset a simple bold heading
+          .  sp
+          .  ft B
+          \&\\$1 \" exercise: remove the \&
+          .  ft
+          .  sp
+          ..
+          .HD .\|.\|.\|surprised?
+
+   One way to think about the dummy character is to imagine placing the
+symbol '&' in the input at a certain location; if doing so has all the
+side effects on formatting that you desire except for sticking an ugly
+ampersand in the midst of your text, the dummy character is what you
+want in its place.
+
+ -- Escape sequence: \)
+     Interpolate a transparent dummy character--one that is transparent
+     to end-of-sentence detection.  It behaves as '\&', except that '\&'
+     is treated as letters and numerals normally are after '.', '?' and
+     '!'; '\&' cancels end-of-sentence detection, and '\)' does not.
+
+          .de Suffix-&
+          .  nop \&\\$1
+          ..
+          .
+          .de Suffix-)
+          .  nop \)\\$1
+          ..
+          .
+          Here's a sentence.\c
+          .Suffix-& '
+          Another one.\c
+          .Suffix-) '
+          And a third.
+              => Here's a sentence.' Another one.'  And a third.
+
+&#x1f;
+File: groff.info,  Node: Dummy Characters-Footnotes,  Up: Dummy Characters
+
+   (1) Opinions of this escape sequence's name abound.  "Zero-width
+space" is a popular misnomer: 'roff' formatters do not treat it like a
+space.  Ossanna called it a "non-printing, zero-width character", but
+the character causes _output_ even though it does not "print".  If no
+output line is pending, the dummy character starts one.  Contrast an
+empty input document with one containing only '\&'.  The former produces
+no output; the latter, a blank page.
+
+&#x1f;
+File: groff.info,  Node: Manipulating Type Size and Vertical Spacing,  Next: Colors,  Prev: Using Fonts,  Up: GNU troff Reference
+
+5.20 Manipulating Type Size and Vertical Spacing
+================================================
+
+These concepts were introduced in *note Page Geometry::.  The height of
+a font's tallest glyph is one em, which is equal to the type size in
+points.(1)  (*note Manipulating Type Size and Vertical
+Spacing-Footnote-1::) A vertical spacing of less than 120% of the type
+size can make a document hard to read.  Larger proportions can be useful
+to spread the text for annotations or proofreader's marks.  By default,
+GNU 'troff' uses 10 point type on 12 point spacing.  Typographers call
+the difference between type size and vertical spacing "leading".(2)
+(*note Manipulating Type Size and Vertical Spacing-Footnote-2::)
+
+* Menu:
+
+* Changing the Type Size::
+* Changing the Vertical Spacing::
+* Using Fractional Type Sizes::
+
+&#x1f;
+File: groff.info,  Node: Manipulating Type Size and Vertical Spacing-Footnotes,  Up: Manipulating Type Size and Vertical Spacing
+
+   (1) In text fonts, the tallest glyphs are typically parentheses.
+Unfortunately, in many cases the actual dimensions of the glyphs in a
+font do not closely match its declared type size!  For example, in the
+standard PostScript font families, 10-point Times sets better with
+9-point Helvetica and 11-point Courier than if all three were used at
+10 points.
+
+   (2) Rhyme with "sledding"; mechanical typography used lead metal
+(Latin _plumbum_).
+
+&#x1f;
+File: groff.info,  Node: Changing the Type Size,  Next: Changing the Vertical Spacing,  Prev: Manipulating Type Size and Vertical Spacing,  Up: Manipulating Type Size and Vertical Spacing
+
+5.20.1 Changing the Type Size
+-----------------------------
+
+ -- Request: .ps size
+ -- Request: .ps +size
+ -- Request: .ps -size
+ -- Escape sequence: \ssize
+ -- Register: \n.s
+     Use the 'ps' request or the '\s' escape sequence to change
+     (increase, decrease) the type size (in scaled points).  Specify
+     SIZE as either an absolute type size, or as a relative change from
+     the current size.  'ps' with no argument restores the previous
+     size.  The 'ps' request's default scaling unit is 'z'.  The
+     requested size is rounded to the nearest valid size (with ties
+     rounding down) within the limits supported by the device.  If the
+     requested size is non-positive, it is treated as 1u.
+
+     Type size alteration is incorrectly documented in the AT&T 'troff'
+     manual, which claims "if the requested size is invalid, the next
+     larger valid size will result, with a maximum of 36".(1)  (*note
+     Changing the Type Size-Footnote-1::)
+
+     The read-only string-valued register '.s' interpolates the type
+     size in points as a decimal fraction; it is associated with the
+     environment (*note Environments::).  To obtain the type size in
+     scaled points, interpolate the '.ps' register instead (*note Using
+     Fractional Type Sizes::).
+
+     The '\s' escape sequence supports a variety of syntax forms.
+
+     '\sN'
+          Set the type size to N points.  N must be a single digit.  If
+          N is 0, restore the previous size.
+
+     '\s+N'
+     '\s-N'
+          Increase or decrease the type size by N points.  N must be
+          exactly one digit.
+
+     '\s(NN'
+          Set the type size to NN points.  NN must be exactly two
+          digits.
+
+     '\s+(NN'
+     '\s-(NN'
+     '\s(+NN'
+     '\s(-NN'
+          Alter the type size in points by the two-digit value NN.
+
+     *Note Using Fractional Type Sizes::, for further syntactical forms
+     of the '\s' escape sequence that additionally accept decimal
+     fractions.
+
+          snap, snap,
+          .ps +2
+          grin, grin,
+          .ps +2
+          wink, wink, \s+2nudge, nudge,\s+8 say no more!
+          .ps 10
+
+   The '\s' escape sequence affects the environment immediately and
+doesn't produce an input token.  Consequently, it can be used in
+requests like 'mc', which expects a single character as an argument, to
+change the type size on the fly.
+
+     .mc \s20x\s0
+
+ -- Request: .sizes s1 s2 ... sn 0
+     The 'DESC' file specifies which type sizes are allowed by the
+     output device; see *note DESC File Format::.  Use the 'sizes'
+     request to change this set of permissible sizes.  Arguments are in
+     scaled points; see *note Using Fractional Type Sizes::.  Each can
+     be a single type size (such as '12000'), or a range of sizes (such
+     as '4000-72000').  You can optionally end the list with a '0'.
+
+&#x1f;
+File: groff.info,  Node: Changing the Type Size-Footnotes,  Up: Changing the Type Size
+
+   (1) The claim appears to have been true of Ossanna 'troff' for the
+C/A/T device; Kernighan made device-independent 'troff' more flexible.
+
+&#x1f;
+File: groff.info,  Node: Changing the Vertical Spacing,  Next: Using Fractional Type Sizes,  Prev: Changing the Type Size,  Up: Manipulating Type Size and Vertical Spacing
+
+5.20.2 Changing the Vertical Spacing
+------------------------------------
+
+ -- Request: .vs space
+ -- Request: .vs +space
+ -- Request: .vs -space
+ -- Register: \n.v
+     Set the vertical spacing to, or alter it by, SPACE.  The default
+     scaling unit is 'p'.  If 'vs' is called without an argument, the
+     vertical spacing is reset to the previous value before the last
+     call to 'vs'.  GNU 'troff' emits a warning in category 'range' if
+     SPACE is negative; the vertical spacing is then set to the smallest
+     possible positive value, the vertical motion quantum (as found in
+     the '.V' register).
+
+     '.vs 0' isn't saved in a diversion since it doesn't result in a
+     vertical motion.  You must explicitly issue this request before
+     interpolating the diversion.
+
+     The read-only register '.v' contains the vertical spacing; it is
+     associated with the environment (*note Environments::).
+
+When a break occurs, GNU 'troff' performs the following procedure.
+
+   * Move the drawing position vertically by the "extra pre-vertical
+     line space", the minimum of all negative '\x' escape sequence
+     arguments in the pending output line.
+
+   * Move the drawing position vertically by the vertical line spacing.
+
+   * Write out the pending output line.
+
+   * Move the drawing position vertically by the "extra post-vertical
+     line space", the maximum of all positive '\x' escape sequence
+     arguments in the line that has just been output.
+
+   * Move the drawing position vertically by the "post-vertical line
+     spacing" (see below).
+
+   Prefer 'vs' or 'pvs' over 'ls' to produce double-spaced documents.
+'vs' and 'pvs' have finer granularity than 'ls'; moreover, some
+preprocessors assume single spacing.  *Note Manipulating Spacing::,
+regarding the '\x' escape sequence and the 'ls' request.
+
+ -- Request: .pvs space
+ -- Request: .pvs +space
+ -- Request: .pvs -space
+ -- Register: \n.pvs
+     Set the post-vertical spacing to, or alter it by, SPACE.  The
+     default scaling unit is 'p'.  If 'pvs' is called without an
+     argument, the post-vertical spacing is reset to the previous value
+     before the last call to 'pvs'.  GNU 'troff' emits a warning in
+     category 'range' if SPACE is negative; the post-vertical spacing is
+     then set to zero.
+
+     The read-only register '.pvs' contains the post-vertical spacing;
+     it is associated with the environment (*note Environments::).
+
+&#x1f;
+File: groff.info,  Node: Using Fractional Type Sizes,  Prev: Changing the Type Size,  Up: Manipulating Type Size and Vertical Spacing
+
+5.20.3 Using Fractional Type Sizes
+----------------------------------
+
+AT&T 'troff' interpreted all type size measurements in points.  Combined
+with integer arithmetic, this design choice made it impossible to
+support, for instance, ten and a half-point type.  In GNU 'troff', an
+output device can select a scaling factor that subdivides a point into
+"scaled points".  A type size expressed in scaled points can thus
+represent a non-integral type size.
+
+   A "scaled point" is equal to 1/SIZESCALE points, where SIZESCALE is
+specified in the device description file 'DESC', and defaults to 1.(1)
+(*note Using Fractional Type Sizes-Footnote-1::) Requests and escape
+sequences in GNU 'troff' interpret arguments that represent a type size
+in scaled points, which the formatter multiplies by SIZESCALE and
+converts to an integer.  Arguments treated in this way comprise those to
+the escape sequences '\H' and '\s', to the request 'ps', the third
+argument to the 'cs' request, and the second and fourth arguments to the
+'tkf' request.  Scaled points may be specified explicitly with the 'z'
+scaling unit.
+
+   For example, if SIZESCALE is 1000, then a scaled point is one
+thousandth of a point.  The request '.ps 10.5' is synonymous with '.ps
+10.5z' and sets the type size to 10,500 scaled points, or 10.5 points.
+Consequently, in GNU 'troff', the register '.s' can interpolate a
+non-integral type size.
+
+ -- Register: \n.ps
+     This read-only register interpolates the type size in scaled
+     points; it is associated with the environment (*note
+     Environments::).
+
+   It makes no sense to use the 'z' scaling unit in a numeric expression
+whose default scaling unit is neither 'u' nor 'z', so GNU 'troff'
+disallows this.  Similarly, it is nonsensical to use a scaling unit
+other than 'z' or 'u' in a numeric expression whose default scaling unit
+is 'z', and so GNU 'troff' disallows this as well.
+
+   Another GNU 'troff' scaling unit, 's', multiplies by the number of
+basic units in a scaled point.  Thus, '\n.pss' is equal to '1m' by
+definition.  Do not confuse the 's' and 'z' scaling units.
+
+ -- Register: \n.psr
+ -- Register: \n.sr
+     Output devices may be limited in the type sizes they can employ.
+     The '.s' and '.ps' registers represent the type size selected by
+     the output driver as it understands a device's capability.  The
+     last _requested_ type size is interpolated in scaled points by the
+     read-only register '.psr' and in points as a decimal fraction by
+     the read-only string-valued register '.sr'.  Both are associated
+     with the environment (*note Environments::).
+
+     For example, if a type size of 10.95 points is requested, and the
+     nearest size permitted by a 'sizes' request (or by the 'sizes' or
+     'sizescale' directives in the device's 'DESC' file) is 11 points,
+     the output driver uses the latter value.
+
+   The '\s' escape sequence offers the following syntax forms that work
+with fractional type sizes and accept scaling units.  You may of course
+give them integral arguments.  The delimited forms need not use the
+neutral apostrophe; see *note Delimiters::.
+
+'\sN'
+'\s'N''
+     Set the type size to N scaled points; N is a numeric expression
+     with a default scaling unit of 'z'.
+
+'\s+N'
+'\s-N'
+'\s+N'
+'\s-N'
+'\s'+N''
+'\s'-N''
+'\s+'N''
+'\s-'N''
+     Increase or decrease the type size by N scaled points; N is a
+     numeric expression (which may start with a minus sign) with a
+     default scaling unit of 'z'.
+
+&#x1f;
+File: groff.info,  Node: Using Fractional Type Sizes-Footnotes,  Up: Using Fractional Type Sizes
+
+   (1) *Note Device and Font Description Files::.
+
+&#x1f;
+File: groff.info,  Node: Colors,  Next: Strings,  Prev: Manipulating Type Size and Vertical Spacing,  Up: GNU troff Reference
+
+5.21 Colors
+===========
+
+GNU 'troff' supports color output with a variety of color spaces and up
+to 16 bits per channel.  Some devices, particularly terminals, may be
+more limited.  When color support is enabled, two colors are current at
+any given time: the "stroke color", with which glyphs, rules (lines),
+and geometric objects like circles and polygons are drawn, and the "fill
+color", which can be used to paint the interior of a closed geometric
+figure.
+
+ -- Request: .color n
+ -- Register: \n.color
+     If N is missing or non-zero, enable the output of color-related
+     device-independent output commands (this is the default);
+     otherwise, disable them.  This request sets a global flag; it does
+     not produce an input token (*note Gtroff Internals::).
+
+     The read-only register '.color' is 1 if colors are enabled,
+     0 otherwise.
+
+     Color can also be disabled with the '-c' command-line option.
+
+ -- Request: .defcolor ident scheme color-component ...
+     Define a color named IDENT.  SCHEME selects a color space and
+     determines the quantity of required COLOR-COMPONENTs; it must be
+     one of 'rgb' (three components), 'cmy' (three), 'cmyk' (four), or
+     'gray' (one).  'grey' is accepted as a synonym of 'gray'.  The
+     color components can be encoded as a single hexadecimal value
+     starting with '#' or '##'.  The former indicates that each
+     component is in the range 0-255 (0-FF), the latter the range
+     0-65,535 (0-FFFF).
+
+          .defcolor half gray #7f
+          .defcolor pink rgb #FFC0CB
+          .defcolor magenta rgb  ##ffff0000ffff
+
+     Alternatively, each color component can be specified as a decimal
+     fraction in the range 0-1, interpreted using a default scaling unit
+     of 'f', which multiplies its value by 65,536 (but clamps it at
+     65,535).
+
+          .defcolor gray50 rgb 0.5 0.5 0.5
+          .defcolor darkgreen rgb 0.1f 0.5f 0.2f
+
+   Each output device has a color named 'default', which cannot be
+redefined.  A device's default stroke and fill colors are not
+necessarily the same.  For the 'dvi', 'html', 'pdf', 'ps', and 'xhtml'
+output devices, GNU 'troff' automatically loads a macro file defining
+many color names at startup.  By the same mechanism, the devices
+supported by 'grotty' recognize the eight standard ISO 6429/EMCA-48
+color names.(1)  (*note Colors-Footnote-1::)
+
+ -- Request: .gcolor color
+ -- Escape sequence: \mc
+ -- Escape sequence: \m(co
+ -- Escape sequence: \mcolor
+ -- Register: \n.m
+     Set the stroke color to COLOR.
+
+          .gcolor red
+          The next words
+          .gcolor
+          \mredare in red\m
+          and these words are in the previous color.
+
+     The escape sequence '\m' restores the previous stroke color, as
+     does a 'gcolor' request without an argument.
+
+     The name of the current stroke color is available in the read-only
+     string-valued register '.m'; it is associated with the environment
+     (*note Environments::).  It interpolates nothing when the stroke
+     color is the default.
+
+     '\m' doesn't produce an input token in GNU 'troff' (*note Gtroff
+     Internals::).  It therefore can be used in requests like 'mc'
+     (which expects a single character as an argument) to change the
+     color on the fly:
+
+          .mc \mredx\m
+
+ -- Request: .fcolor color
+ -- Escape sequence: \Mc
+ -- Escape sequence: \M(co
+ -- Escape sequence: \Mcolor
+ -- Register: \n.M
+     Set the fill color for objects drawn with '\D'...'' escape
+     sequences.  The escape sequence '\M' restores the previous fill
+     color, as does an 'fcolor' request without an argument.
+
+     The name of the current fill color is available in the read-only
+     string-valued register '.M'; it is associated with the environment
+     (*note Environments::).  It interpolates nothing when the fill
+     color is the default.  '\M' doesn't produce an input token in GNU
+     'troff'.
+
+     Create an ellipse with a red interior as follows.
+
+          \Mred\h'0.5i'\D'E 2i 1i'\M
+
+&#x1f;
+File: groff.info,  Node: Colors-Footnotes,  Up: Colors
+
+   (1) also known vulgarly as "ANSI colors"
+
+&#x1f;
+File: groff.info,  Node: Strings,  Next: Conditionals and Loops,  Prev: Colors,  Up: GNU troff Reference
+
+5.22 Strings
+============
+
+GNU 'troff' supports strings primarily for user convenience.
+Conventionally, if one would define a macro only to interpolate a small
+amount of text, without invoking requests or calling any other macros,
+one defines a string instead.  Only one string is predefined by the
+language.
+
+ -- String: \*.T
+     Contains the name of the output device (for example, 'utf8' or
+     'pdf').
+
+   The 'ds' request creates a string with a specified name and contents
+and the '\*' escape sequence dereferences its name, interpolating its
+contents.  If the string named by the '\*' escape sequence does not
+exist, it is defined as empty, nothing is interpolated, and a warning in
+category 'mac' is emitted.  *Note Warnings::, for information about the
+enablement and suppression of warnings.
+
+ -- Request: .ds name contents
+ -- Request: .ds1 name contents
+ -- Escape sequence: \*n
+ -- Escape sequence: \*(nm
+ -- Escape sequence: \*name arg1 arg2 ...
+     Define a string called NAME with contents CONTENTS.  If NAME
+     already exists as an alias, the target of the alias is redefined;
+     see 'als' and 'rm' below.  If 'ds' is called with only one
+     argument, NAME is defined as an empty string.  Otherwise, GNU
+     'troff' stores CONTENTS in copy mode.(1)  (*note
+     Strings-Footnote-1::)
+
+     The '\*' escape sequence interpolates a previously defined string
+     variable NAME (one-character name N, two-character name NM).  The
+     bracketed interpolation form accepts arguments that are handled as
+     macro arguments are; recall *note Calling Macros::.  In contrast to
+     macro calls, however, if a closing bracket '' occurs in a string
+     argument, that argument must be enclosed in double quotes.  '\*' is
+     interpreted even in copy mode.  When defining strings, argument
+     interpolations must be escaped if they are to reference parameters
+     from the calling context; *Note Parameters::.
+
+          .ds cite (\\$1, \\$2)
+          Gray codes are explored in \*cite Morgan 1998.
+              => Gray codes are explored in (Morgan, 1998).
+
+     *Caution:* Unlike other requests, the second argument to the 'ds'
+     request consumes the remainder of the input line, including
+     trailing spaces.  This means that comments on a line with such a
+     request can introduce unwanted space into a string when they are
+     set off from the material they annotate, as is conventional.
+
+          .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \" water
+
+     Instead, place the comment on another line or put the comment
+     escape sequence immediately adjacent to the last character of the
+     string.
+
+          .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\" water
+
+     Ending string definitions (and appendments) with a comment, even an
+     empty one, prevents unwanted space from creeping into them during
+     source document maintenance.
+
+          .ds author Alice Pleasance Liddell\"
+          .ds empty \" might be appended to later with .as
+
+     An initial neutral double quote '"' in CONTENTS is stripped to
+     allow embedding of leading spaces.  Any other '"' is interpreted
+     literally, but it is wise to use the special character escape
+     sequence '\dq' instead if the string might be interpolated as
+     part of a macro argument; see *note Calling Macros::.
+
+          .ds salutation "         Yours in a white wine sauce,\"
+          .ds c-var-defn "  char mydate=\dq2020-07-29\dq;\"
+
+     Strings are not limited to a single input line of text.  '\<RET>'
+     works just as it does elsewhere.  The resulting string is stored
+     _without_ the newlines.  Care is therefore required when
+     interpolating strings while filling is disabled.
+
+          .ds foo This string contains \
+          text on multiple lines \
+          of input.
+
+     It is not possible to embed a newline in a string that will be
+     interpreted as such when the string is interpolated.  To achieve
+     that effect, use '\*' to interpolate a macro instead; see *note
+     Punning Names::.
+
+     Because strings are similar to macros, they too can be defined so
+     as to suppress AT&T 'troff' compatibility mode when used; see *note
+     Writing Macros:: and *note Compatibility Mode::.  The 'ds1' request
+     defines a string such that compatibility mode is off when the
+     string is later interpolated.  To be more precise, a "compatibility
+     save" input token is inserted at the beginning of the string, and a
+     "compatibility restore" input token at the end.
+
+          .nr xxx 12345
+          .ds aa The value of xxx is \\nxxx.
+          .ds1 bb The value of xxx is \\nxxx.
+          .
+          .cp 1
+          .
+          \*(aa
+              error-> warning: register '' not defined
+              => The value of xxx is 0xxx.
+          \*(bb
+              => The value of xxx is 12345.
+
+ -- Request: .as name contents
+ -- Request: .as1 name contents
+     The 'as' request is similar to 'ds' but appends CONTENTS to the
+     string stored as NAME instead of redefining it.  If NAME doesn't
+     exist yet, it is created.  If 'as' is called with only one
+     argument, no operation is performed (beyond dereferencing the
+     string).
+
+          .as salutation " with shallots, onions and garlic,\"
+
+     The 'as1' request is similar to 'as', but compatibility mode is
+     switched off when the appended portion of the string is later
+     interpolated.  To be more precise, a "compatibility save" input
+     token is inserted at the beginning of the appended string, and a
+     "compatibility restore" input token at the end.
+
+   Several requests exist to perform rudimentary string operations.
+Strings can be queried ('length') and modified ('chop', 'substring',
+'stringup', 'stringdown'), and their names can be manipulated through
+renaming, removal, and aliasing ('rn', 'rm', 'als').
+
+ -- Request: .length reg anything
+     Compute the number of characters of ANYTHING and store the count in
+     the register REG.  If REG doesn't exist, it is created.  ANYTHING
+     is read in copy mode.
+
+          .ds xxx abcd\h'3i'efgh
+          .length yyy \*xxx
+          \nyyy
+              => 14
+
+ -- Request: .chop object
+     Remove the last character from the macro, string, or diversion
+     named OBJECT.  This is useful for removing the newline from the end
+     of a diversion that is to be interpolated as a string.  This
+     request can be used repeatedly on the same OBJECT; see *note Gtroff
+     Internals::, for details on nodes inserted additionally by GNU
+     'troff'.
+
+ -- Request: .substring str start end
+     Replace the string named STR with its substring bounded by the
+     indices START and END, inclusively.  The first character in the
+     string has index 0.  If END is omitted, it is implicitly set to the
+     largest valid value (the string length minus one).  Negative
+     indices count backward from the end of the string: the last
+     character has index -1, the character before the last has index -2,
+     and so on.
+
+          .ds xxx abcdefgh
+          .substring xxx 1 -4
+          \*xxx
+              => bcde
+          .substring xxx 2
+          \*xxx
+              => de
+
+ -- Request: .stringdown str
+ -- Request: .stringup str
+     Alter the string named STR by replacing each of its bytes with its
+     lowercase ('stringdown') or uppercase ('stringup') version (if one
+     exists).  Special characters in the string will often transform in
+     the expected way due to the regular naming convention for accented
+     characters.  When they do not, use substrings and/or catenation.
+
+          .ds resume R\'esum\'e
+          \*resume
+          .stringdown resume
+          \*resume
+          .stringup resume
+          \*resume
+              => Résumé résumé RÉSUMÉ
+
+   (In practice, we would end the 'ds' request with a comment escape
+'\"' to prevent space from creeping into the definition during source
+document maintenance.)
+
+ -- Request: .rn old new
+     Rename the request, macro, diversion, or string OLD to NEW.
+
+ -- Request: .rm name
+     Remove the request, macro, diversion, or string NAME.  GNU 'troff'
+     treats subsequent invocations as if the name had never been
+     defined.
+
+ -- Request: .als new old
+     Create an alias NEW for the existing request, string, macro, or
+     diversion object named OLD, causing the names to refer to the same
+     stored object.  If OLD is undefined, a warning in category 'mac' is
+     produced, and the request is ignored.  *Note Warnings::, for
+     information about the enablement and suppression of warnings.
+
+     To understand how the 'als' request works, consider two different
+     storage pools: one for objects (macros, strings, etc.), and another
+     for names.  As soon as an object is defined, GNU 'troff' adds it to
+     the object pool, adds its name to the name pool, and creates a link
+     between them.  When 'als' creates an alias, it adds a new name to
+     the name pool that gets linked to the same object as the old name.
+
+     Now consider this example.
+
+          .de foo
+          ..
+          .
+          .als bar foo
+          .
+          .de bar
+          .  foo
+          ..
+          .
+          .bar
+              error-> input stack limit exceeded (probable infinite
+              error-> loop)
+
+     In the above, 'bar' remains an _alias_--another name for--the
+     object referred to by 'foo', which the second 'de' request
+     replaces.  Alternatively, imagine that the 'de' request
+     _dereferences_ its argument before replacing it.  Either way, the
+     result of calling 'bar' is a recursive loop that finally leads to
+     an error.  *Note Writing Macros::.
+
+     To remove an alias, call 'rm' on its name.  The object itself is
+     not destroyed until it has no more names.
+
+     When a request, macro, string, or diversion is aliased,
+     redefinitions and appendments "write through" alias names.  To
+     replace an alias with a separately defined object, you must use the
+     'rm' request on its name first.
+
+&#x1f;
+File: groff.info,  Node: Strings-Footnotes,  Up: Strings
+
+   (1) *Note Copy Mode::.
+
+&#x1f;
+File: groff.info,  Node: Conditionals and Loops,  Next: Writing Macros,  Prev: Strings,  Up: GNU troff Reference
+
+5.23 Conditionals and Loops
+===========================
+
+'groff' has 'if' and 'while' control structures like other languages.
+However, the syntax for grouping multiple input lines in the branches or
+bodies of these structures is unusual.
+
+* Menu:
+
+* Operators in Conditionals::
+* if-then::
+* if-else::
+* Conditional Blocks::
+* while::
+
+&#x1f;
+File: groff.info,  Node: Operators in Conditionals,  Next: if-then,  Prev: Conditionals and Loops,  Up: Conditionals and Loops
+
+5.23.1 Operators in Conditionals
+--------------------------------
+
+In 'if', 'ie', and 'while' requests, in addition to the numeric
+expressions described in *note Numeric Expressions::, several Boolean
+operators are available; the members of this expanded class are termed
+"conditional expressions".
+
+'c GLYPH'
+     True if GLYPH is available, where GLYPH is an ordinary character, a
+     special character '\(XX' or '\XXX', '\N'XXX'', or has been
+     defined by any of the 'char', 'fchar', 'fschar', or 'schar'
+     requests.
+
+'d NAME'
+     True if a string, macro, diversion, or request called NAME exists.
+
+'e'
+     True if the current page is even-numbered.
+
+'F FONT'
+     True if FONT exists.  FONT is handled as if it were opened with the
+     'ft' request (that is, font translation and styles are applied),
+     without actually mounting it.
+
+'m COLOR'
+     True if COLOR is defined.
+
+'n'
+     True if the document is being processed in 'nroff' mode.  *Note
+     troff and nroff Modes::.
+
+'o'
+     True if the current page is odd-numbered.
+
+'r REGISTER'
+     True if REGISTER exists.
+
+'S STYLE'
+     True if STYLE is available for the current font family.  Font
+     translation is applied.
+
+'t'
+     True if the document is being processed in 'troff' mode.  *Note
+     troff and nroff Modes::.
+
+'v'
+     Always false.  This condition is recognized only for compatibility
+     with certain other 'troff' implementations.(1)  (*note Operators in
+     Conditionals-Footnote-1::)
+
+   If the first argument to an 'if', 'ie', or 'while' request begins
+with a non-alphanumeric character apart from '!' (see below); it
+performs an output comparison test.  (2)  (*note Operators in
+Conditionals-Footnote-2::)
+
+''XXX'YYY''
+     True if formatting the comparands XXX and YYY produces the same
+     output commands.  The delimiter need not be a neutral apostrophe:
+     the output comparison operator accepts the same delimiters as most
+     escape sequences; see *note Delimiters::.  This "output comparison
+     operator" formats XXX and YYY in separate environments; after the
+     comparison, the resulting data are discarded.
+
+          .ie "|"\fR|\fP" true
+          .el false
+              => true
+
+     The resulting glyph properties, including font family, style, size,
+     and slant, must match, but not necessarily the requests and/or
+     escape sequences used to obtain them.  In the previous example, '|'
+     and '\fR|\fP' result in '|' glyphs in the same typefaces at the
+     same positions, so the comparands are equal.  If '.ft I' had been
+     added before the '.ie', they would differ: the first '|' would
+     produce an italic '|', not a roman one.  Motions must match in
+     orientation and magnitude to within the applicable horizontal and
+     vertical motion quanta of the device, after rounding.  '.if
+     "\u\d"\v'0'"' is false even though both comparands result in zero
+     net motion, because motions are not interpreted or optimized but
+     sent as-is to the output.(3)  (*note Operators in
+     Conditionals-Footnote-3::) On the other hand, '.if "\d"\v'0.5m'"'
+     is true, because '\d' is defined as a downward motion of one-half
+     em.(4)  (*note Operators in Conditionals-Footnote-4::)
+
+     Surround the comparands with '\?' to avoid formatting them; this
+     causes them to be compared character by character, as with string
+     comparisons in other programming languages.
+
+          .ie "\?|\?"\?\fR|\fP\?" true
+          .el false
+              => false
+
+     Since comparands protected with '\?' are read in copy mode (*note
+     Copy Mode::), they need not even be valid 'groff' syntax.  The
+     escape character is still lexically recognized, however, and
+     consumes the next character.
+
+          .ds a \
+          .ds b \
+          .if '\?\*a\?'\?\*b\?' a and b equivalent
+          .if '\?\\?'\?\\?' backslashes equivalent
+              => a and b equivalent
+
+   The above operators can't be combined with most others, but a leading
+'!', not followed immediately by spaces or tabs, complements an
+expression.
+
+     .nr x 1
+     .ie !r x register x is not defined
+     .el      register x is defined
+         => register x is defined
+
+   Spaces and tabs are optional immediately after the 'c', 'd', 'F',
+'m', 'r', and 'S' operators, but right after '!', they end the predicate
+and the conditional evaluates true.(5)  (*note Operators in
+Conditionals-Footnote-5::)
+
+     .nr x 1
+     .ie ! r x register x is not defined
+     .el       register x is defined
+         => r x register x is not defined
+
+The unexpected 'r x' in the output is a clue that our conditional was
+not interpreted as we planned, but matters may not always be so obvious.
+
+&#x1f;
+File: groff.info,  Node: Operators in Conditionals-Footnotes,  Up: Operators in Conditionals
+
+   (1) This refers to 'vtroff', a translator that would convert the
+C/A/T output from early-vintage AT&T 'troff' to a form suitable for
+Versatec and Benson-Varian plotters.
+
+   (2) Strictly, letters not otherwise recognized _are_ treated as
+output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan 9 'troff' uses
+'h' to test a mode it calls 'htmlroff', and GNU 'troff' may provide
+additional operators in the future.
+
+   (3) Because formatting of the comparands takes place in a dummy
+environment, vertical motions within them cannot spring traps.
+
+   (4) All of this is to say that the lists of output nodes created by
+formatting XXX and YYY must be identical.  *Note Gtroff Internals::.
+
+   (5) This bizarre behavior maintains compatibility with AT&T 'troff'.
+
+&#x1f;
+File: groff.info,  Node: if-then,  Next: if-else,  Prev: Operators in Conditionals,  Up: Conditionals and Loops
+
+5.23.2 if-then
+--------------
+
+ -- Request: .if cond-expr anything
+     Evaluate the conditional expression COND-EXPR, and if it evaluates
+     true (or to a positive value), interpret the remainder of the line
+     ANYTHING as if it were an input line.  Recall from *note Invoking
+     Requests:: that any quantity of spaces between arguments to
+     requests serves only to separate them; leading spaces in ANYTHING
+     are thus not seen.  ANYTHING effectively _cannot_ be omitted; if
+     COND-EXPR is true and ANYTHING is empty, the newline at the end of
+     the control line is interpreted as a blank input line (and
+     therefore a blank text line).
+
+          super\c
+          tanker
+          .nr force-word-break 1
+          super\c
+          .if ((\nforce-word-break = 1) & \n.int)
+          tanker
+              => supertanker super tanker
+
+ -- Request: .nop anything
+     Interpret ANYTHING as if it were an input line.  This is similar to
+     '.if 1'.  'nop' is not really "no operation"; its argument _is_
+     processed--unconditionally.  It can be used to cause text lines to
+     share indentation with surrounding control lines.
+
+          .als real-MAC MAC
+          .de wrapped-MAC
+          .  tm MAC: called with arguments \\$@
+          .  nop \\*real-MAC\\
+          ..
+          .als MAC wrapped-MAC
+          \# Later...
+          .als MAC real-MAC
+
+     In the above, we've used aliasing, 'nop', and the interpolation of
+     a macro as a string to interpose a wrapper around the macro 'MAC'
+     (perhaps to debug it).
+
+&#x1f;
+File: groff.info,  Node: if-else,  Next: while,  Prev: Operators in Conditionals,  Up: Conditionals and Loops
+
+5.23.3 if-else
+--------------
+
+ -- Request: .ie cond-expr anything
+ -- Request: .el anything
+     Use the 'ie' and 'el' requests to write an if-then-else.  The first
+     request is the "if" part and the latter is the "else" part.
+     Unusually among programming languages, any number of
+     non-conditional requests may be interposed between the 'ie' branch
+     and the 'el' branch.
+
+          .nr a 0
+          .ie \na a is non-zero.
+          .nr a +1
+          .el a was not positive but is now \na.
+              => a was not positive but is now 1.
+
+     Another way in which 'el' is an ordinary request is that it does
+     not lexically "bind" more tightly to its 'ie' counterpart than it
+     does to any other request.  This fact can surprise C programmers.
+
+          .nr a 1
+          .nr z 0
+          .ie \nz \
+          .  ie \na a is true
+          .  el     a is false
+          .el z is false
+              error-> warning: unbalanced 'el' request
+              => a is false
+
+     To conveniently nest conditionals, keep reading.
+
+&#x1f;
+File: groff.info,  Node: Conditional Blocks,  Next: while,  Prev: Operators in Conditionals,  Up: Conditionals and Loops
+
+5.23.4 Conditional Blocks
+-------------------------
+
+It is frequently desirable for a control structure to govern more than
+one request, macro call, text line, or a combination of the foregoing.
+The opening and closing brace escape sequences '\{' and '\}' define such
+groups.  These "conditional blocks" can furthermore be nested.
+
+ -- Escape sequence: \{
+ -- Escape sequence: \}
+     '\{' begins a conditional block; it must appear (after optional
+     spaces and tabs) immediately subsequent to the conditional
+     expression of an 'if', 'ie', or 'while' request,(1) (*note
+     Conditional Blocks-Footnote-1::) or as the argument to an 'el'
+     request.
+
+     '\}' ends a condition block and should appear on a line with other
+     occurrences of itself as necessary to match '\{' sequences.  It can
+     be preceded by a control character, spaces, and tabs.  Input after
+     any quantity of '\}' sequences on the same line is processed only
+     if all of the preceding conditions to which they correspond are
+     true.  Furthermore, a '\}' closing the body of a 'while' request
+     must be the last such escape sequence on an input line.
+
+     Brace escape sequences outside of control structures have no
+     meaning and produce no output.
+
+     *Caution:* Input lines using '\{' often end with '\RET', especially
+     in macros that consist primarily of control lines.  Forgetting to
+     use '\RET' on an input line after '\{' is a common source of error.
+
+   We might write the following in a page header macro.  If we delete
+'\RET', the header will carry an unwanted extra empty line (except on
+page 1).
+
+     .if (\\n% != 1) \{\
+     .  ie ((\\n% % 2) = 0) .tl \\*even-numbered-page-title
+     .  el                    .tl \\*odd-numbered-page-title
+     .\}
+
+   Let us take a closer look at how conditional blocks nest.
+
+     A
+     .if 0 \{ B
+     C
+     D
+     \}E
+     F
+         => A F
+
+     N
+     .if 1 \{ O
+     .  if 0 \{ P
+     Q
+     R\} S\} T
+     U
+         => N O U
+
+   The above behavior may challenge the intuition; it was implemented to
+retain compatibility with AT&T 'troff'.  For clarity, it is idiomatic to
+end input lines with '\{' (followed by '\<RET>' if appropriate), and to
+precede '\}' on an input line with nothing more than a control
+character, spaces, tabs, and other instances of itself.
+
+   We can use 'ie', 'el', and conditional blocks to simulate the
+multi-way "switch" or "case" control structures of other languages.  The
+following example is adapted from the 'groff' 'man' package.
+Indentation is used to clarify the logic.
+
+     .\" Simulate switch/case in roff.
+     .      ie '\\$2'1' .ds title General Commands\"
+     .el \{.ie '\\$2'2' .ds title System Calls\"
+     .el \{.ie '\\$2'3' .ds title Library Functions\"
+     .el \{.ie '\\$2'4' .ds title Kernel Interfaces\"
+     .el \{.ie '\\$2'5' .ds title File Formats\"
+     .el \{.ie '\\$2'6' .ds title Games\"
+     .el \{.ie '\\$2'7' .ds title Miscellaneous Information\"
+     .el \{.ie '\\$2'8' .ds title System Management\"
+     .el \{.ie '\\$2'9' .ds title Kernel Development\"
+     .el                .ds title \" empty
+     .\}\}\}\}\}\}\}\}
+
+&#x1f;
+File: groff.info,  Node: Conditional Blocks-Footnotes,  Up: Conditional Blocks
+
+   (1) *Note while::.
+
+&#x1f;
+File: groff.info,  Node: while,  Prev: if-else,  Up: Conditionals and Loops
+
+5.23.5 while
+------------
+
+'groff' provides a looping construct: the 'while' request.  Its syntax
+matches the 'if' request.
+
+ -- Request: .while cond-expr anything
+     Evaluate the conditional expression COND-EXPR, and repeatedly
+     execute ANYTHING unless and until COND-EXPR evaluates false.
+     ANYTHING, which is often a conditional block, is referred to as the
+     'while' request's "body".
+
+          .nr a 0 1
+          .while (\na < 9) \{\
+          \n+a,
+          .\}
+          \n+a
+              => 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
+
+     GNU 'troff' treats the body of a 'while' request similarly to that
+     of a 'de' request (albeit one not read in copy mode(1) (*note
+     while-Footnote-1::)), but stores it under an internal name and
+     deletes it when the loop finishes.  The operation of a macro
+     containing a 'while' request can slow significantly if the 'while'
+     body is large.  Each time the macro is executed, the 'while' body
+     is parsed and stored again.
+
+          .de xxx
+          .  nr num 10
+          .  while (\\nnum > 0) \{\
+          .    \" many lines of code
+          .    nr num -1
+          .  \}
+          ..
+
+     An often better solution--and one that is more portable, since AT&T
+     'troff' lacked the 'while' request--is to instead write a recursive
+     macro.  It will be parsed only once.(2)  (*note while-Footnote-2::)
+
+          .de yyy
+          .  if (\\nnum > 0) \{\
+          .    \" many lines of code
+          .    nr num -1
+          .    yyy
+          .  \}
+          ..
+          .
+          .de xxx
+          .  nr num 10
+          .  yyy
+          ..
+
+     To prevent infinite loops, the default number of available
+     recursion levels is 1,000 or somewhat less.(3)  (*note
+     while-Footnote-3::) You can disable this protective measure, or
+     raise the limit, by setting the 'slimit' register.  *Note
+     Debugging::.
+
+     As noted above, if a 'while' body begins with a conditional block,
+     its closing brace must end an input line.
+
+          .if 1 \{\
+          .  nr a 0 1
+          .  while (\na < 10) \{\
+          .    nop \n+a
+          .\}\}
+              error-> unbalanced brace escape sequences
+
+ -- Request: .break
+     Exit a 'while' loop.  Do not confuse this request with a
+     typographical break or the 'br' request.
+
+ -- Request: .continue
+     Skip the remainder of a 'while' loop's body, immediately starting
+     the next iteration.
+
+&#x1f;
+File: groff.info,  Node: while-Footnotes,  Up: while
+
+   (1) *Note Copy Mode::.
+
+   (2) unless you redefine it
+
+   (3) "somewhat less" because things other than macro calls can be on
+the input stack
+
+&#x1f;
+File: groff.info,  Node: Writing Macros,  Next: Page Motions,  Prev: Conditionals and Loops,  Up: GNU troff Reference
+
+5.24 Writing Macros
+===================
+
+A "macro" is a stored collection of text and control lines that can be
+interpolated multiple times.  Use macros to define common operations.
+Macros are called in the same way that requests are invoked.  While
+requests exist for the purpose of creating macros, simply calling an
+undefined macro, or interpolating it as a string, will cause it to be
+defined as empty.  *Note Identifiers::.
+
+ -- Request: .de name end
+     Define a macro NAME, replacing the definition of any existing
+     request, macro, string, or diversion called NAME.  If NAME already
+     exists as an alias, the target of the alias is redefined; recall
+     *note Strings::.  GNU 'troff' enters copy mode,(1) (*note Writing
+     Macros-Footnote-1::) storing subsequent input lines as the macro
+     definition.  If the optional second argument is not specified, the
+     definition ends with the control line '..' (two dots).
+     Alternatively, END identifies a macro whose call syntax at the
+     start of a control line ends the definition of NAME; END is then
+     called normally.  A macro definition must end in the same
+     conditional block (if any) in which it began (*note Conditional
+     Blocks::).  Spaces or tabs are permitted after the control
+     character in the line containing this ending token (either '.' or
+     'END'), but a tab immediately after the token prevents its
+     recognition as the end of a macro definition.  The macro END can be
+     called with arguments.(2)  (*note Writing Macros-Footnote-2::)
+
+     Here is a small example macro called 'P' that causes a break and
+     inserts some vertical space.  It could be used to separate
+     paragraphs.
+
+          .de P
+          .  br
+          .  sp .8v
+          ..
+
+     We can define one macro within another.  Attempting to nest '..'
+     naïvely will end the outer definition because the inner definition
+     isn't interpreted as such until the outer macro is later
+     interpolated.  We can use an end macro instead.  Each level of
+     nesting should use a unique end macro.
+
+     An end macro need not be defined until it is called.  This fact
+     enables a nested macro definition to begin inside one macro and end
+     inside another.  Consider the following example.(3)  (*note Writing
+     Macros-Footnote-3::)
+
+          .de m1
+          .  de m2 m3
+          you
+          ..
+          .de m3
+          Hello,
+          Joe.
+          ..
+          .de m4
+          do
+          ..
+          .m1
+          know?
+          .  m3
+          What
+          .m4
+          .m2
+              => Hello, Joe.  What do you know?
+
+     A nested macro definition _can_ be terminated with '..' and nested
+     macros _can_ reuse end macros, but these control lines must be
+     escaped multiple times for each level of nesting.  The necessity of
+     this escaping and the utility of nested macro definitions will
+     become clearer when we employ macro parameters and consider the
+     behavior of copy mode in detail.
+
+   'de' defines a macro that inherits the compatibility mode enablement
+status of its context (*note Implementation Differences::).  Often it is
+desirable to make a macro that uses 'groff' features callable from
+contexts where compatibility mode is on; for instance, when writing
+extensions to a historical macro package.  To achieve this,
+compatibility mode needs to be switched off while such a macro is
+interpreted--without disturbing that state when it is finished.
+
+ -- Request: .de1 name end
+     The 'de1' request defines a macro to be interpreted with
+     compatibility mode disabled.  When NAME is called, compatibility
+     mode enablement status is saved; it is restored when the call
+     completes.  Observe the extra backlash before the interpolation of
+     register 'xxx'; we'll explore this subject in *note Copy Mode::.
+
+          .nr xxx 12345
+          .de aa
+          The value of xxx is \\nxxx.
+          .  br
+          ..
+          .de1 bb
+          The value of xxx is \\nxxx.
+          ..
+          .cp 1
+          .aa
+              error-> warning: register '' not defined
+              => The value of xxx is 0xxx.
+          .bb
+              => The value of xxx is 12345.
+
+ -- Request: .dei name end
+ -- Request: .dei1 name end
+     The 'dei' request defines a macro with its name and end macro
+     indirected through strings.  That is, it interpolates strings named
+     NAME and END before performing the definition.
+
+     The following examples are equivalent.
+
+          .ds xx aa
+          .ds yy bb
+          .dei xx yy
+
+          .de aa bb
+
+     The 'dei1' request bears the same relationship to 'dei' as 'de1'
+     does to 'de'; it temporarily turns compatibility mode off when NAME
+     is called.
+
+ -- Request: .am name end
+ -- Request: .am1 name end
+ -- Request: .ami name end
+ -- Request: .ami1 name end
+     'am' appends subsequent input lines to macro NAME, extending its
+     definition, and otherwise working as 'de' does.
+
+     To make the previously defined 'P' macro set indented instead of
+     block paragraphs, add the necessary code to the existing macro.
+
+          .am P
+          .ti +5n
+          ..
+
+     The other requests are analogous to their 'de' counterparts.  The
+     'am1' request turns off compatibility mode during interpretation of
+     the appendment.  The 'ami' request appends indirectly, meaning that
+     strings NAME and END are interpolated with the resulting names used
+     before appending.  The 'ami1' request is similar to 'ami',
+     disabling compatibility mode during interpretation of the appended
+     lines.
+
+   Using 'trace.tmac', you can trace calls to 'de', 'de1', 'am', and
+'am1'.  You can also use the 'backtrace' request at any point desired to
+troubleshoot tricky spots (*note Debugging::).
+
+   *Note Strings::, for the 'als', 'rm', and 'rn' requests to create an
+alias of, remove, and rename a macro, respectively.
+
+   Macro identifiers share their name space with requests, strings, and
+diversions; see *note Identifiers::.  The 'am', 'as', 'da', 'de', 'di',
+and 'ds' requests (together with their variants) create a new object
+only if the name of the macro, diversion, or string is currently
+undefined or if it is defined as a request; normally, they modify the
+value of an existing object.  *Note the description of the 'als'
+request: als, for pitfalls when redefining a macro that is aliased.
+
+ -- Request: .return anything
+     Exit a macro, immediately returning to the caller.  If called with
+     an argument ANYTHING, exit twice--the current macro and the macro
+     one level higher.  This is used to define a wrapper macro for
+     'return' in 'trace.tmac'.
+
+* Menu:
+
+* Parameters::
+* Copy Mode::
+
+&#x1f;
+File: groff.info,  Node: Writing Macros-Footnotes,  Up: Writing Macros
+
+   (1) *Note Copy Mode::.
+
+   (2) While it is possible to define and call a macro '.', you can't
+use it as an end macro: during a macro definition, '..' is never handled
+as calling '.', even if '.de NAME .' explicitly precedes it.
+
+   (3) Its structure is adapted from, and isomorphic to, part of a
+solution by Tadziu Hoffman to the problem of reflowing text multiple
+times to find an optimal configuration for it.
+<https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html>
+
+&#x1f;
+File: groff.info,  Node: Parameters,  Next: Copy Mode,  Prev: Writing Macros,  Up: Writing Macros
+
+5.24.1 Parameters
+-----------------
+
+Macro calls and string interpolations optionally accept a list of
+arguments; recall *note Calling Macros::.  At the time such an
+interpolation takes place, these "parameters" can be examined using a
+register and a variety of escape sequences starting with '\$'.  All such
+escape sequences are interpreted even in copy mode, a fact we shall
+motivate and explain below (*note Copy Mode::).
+
+ -- Register: \n.$
+     The count of parameters available to a macro or string is kept in
+     this read-only register.  The 'shift' request can change its value.
+
+   Any individual parameter can be accessed by its position in the list
+of arguments to the macro call, numbered from left to right starting at
+1, with one of the following escape sequences.
+
+ -- Escape sequence: \$n
+ -- Escape sequence: \$(nn
+ -- Escape sequence: \$nnn
+     Interpolate the Nth, NNth, or NNNth parameter.  The first form
+     expects only a single digit (1<=N<=9)), the second two digits
+     (01<=NN<=99)), and the third any positive integer NNN.  Macros and
+     strings accept an unlimited number of parameters.
+
+ -- Request: .shift n
+     Shift the parameters N places (1 by default).  This is a "left
+     shift": what was parameter I becomes parameter I-N.  The parameters
+     formerly in positions 1 to N are no longer available.  Shifting by
+     a non-positive amount performs no operation.  The register '.$' is
+     adjusted accordingly.
+
+   In practice, parameter interpolations are usually seen prefixed with
+an extra escape character.  This is because the '\$' family of escape
+sequences is interpreted even in copy mode.(1)  (*note
+Parameters-Footnote-1::)
+
+ -- Escape sequence: \$*
+ -- Escape sequence: \$@
+ -- Escape sequence: \$^
+     In some cases it is convenient to interpolate all of the parameters
+     at once (to pass them to a request, for instance).  The '\$*'
+     escape concatenates the parameters, separating them with spaces.
+     '\$@' is similar, concatenating the parameters, surrounding each
+     with double quotes and separating them with spaces.  If not in
+     compatibility mode, the interpolation depth of double quotes is
+     preserved (*note Calling Macros::).  '\$^' interpolates all
+     parameters as if they were arguments to the 'ds' request.
+
+          .de foo
+          . tm $1='\\$1'
+          . tm $2='\\$2'
+          . tm $*='\\$*'
+          . tm $@='\\$@'
+          . tm $^='\\$^'
+          ..
+          .foo " This is a "test"
+              error-> $1=' This is a '
+              error-> $2='test"'
+              error-> $*=' This is a  test"'
+              error-> $@='" This is a " "test""'
+              error-> $^='" This is a "test"'
+
+     '\$*' is useful when writing a macro that doesn't need to
+     distinguish its arguments, or even to not interpret them; examples
+     include macros that produce diagnostic messages by wrapping the
+     'tm' or 'ab' requests.  Use '\$@' when writing a macro that may
+     need to shift its parameters and/or wrap a macro or request that
+     finds the count significant.  If in doubt, prefer '\$@' to '\$*'.
+     An application of '\$^' is seen in 'trace.tmac', which redefines
+     some requests and macros for debugging purposes.
+
+ -- Escape sequence: \$0
+     Interpolate the name by which the macro being interpreted was
+     called.  The 'als' request can cause a macro to have more than one
+     name.  Applying string interpolation to a macro does not change
+     this name.
+
+          .de foo
+          .  tm \\$0
+          ..
+          .als bar foo
+          .
+          .de aaa
+          .  foo
+          ..
+          .de bbb
+          .  bar
+          ..
+          .de ccc
+          \\*foo\\
+          ..
+          .de ddd
+          \\*bar\\
+          ..
+          .
+          .aaa
+              error-> foo
+          .bbb
+              error-> bar
+          .ccc
+              error-> ccc
+          .ddd
+              error-> ddd
+
+&#x1f;
+File: groff.info,  Node: Parameters-Footnotes,  Up: Parameters
+
+   (1) If they were not, parameter interpolations would be similar to
+command-line parameters--fixed for the entire duration of a 'roff'
+program's run.  The advantage of interpolating '\$' escape sequences
+even in copy mode is that they can interpolate different contents from
+one call to the next, like function parameters in a procedural language.
+The additional escape character is the price of this power.
+
+&#x1f;
+File: groff.info,  Node: Copy Mode,  Prev: Parameters,  Up: Writing Macros
+
+5.24.2 Copy Mode
+----------------
+
+When GNU 'troff' processes certain requests, most importantly those
+which define or append to a macro or string, it does so in "copy mode":
+it copies the characters of the definition into a dedicated storage
+region, interpolating the escape sequences '\n', '\g', '\$', '\*', '\V',
+and '\?' normally; interpreting '\<RET>' immediately; discarding
+comments '\"' and '\#'; interpolating the current leader, escape, or tab
+character with '\a', '\e', and '\t', respectively; and storing all other
+escape sequences in an encoded form.
+
+   The complement of copy mode--a 'roff' formatter's behavior when not
+defining or appending to a macro, string, or diversion--where all macros
+are interpolated, requests invoked, and valid escape sequences processed
+immediately upon recognition, can be termed "interpretation mode".
+
+ -- Escape sequence: \\
+     The escape character, '\' by default, can escape itself.  This
+     enables you to control whether a given '\n', '\g', '\$', '\*',
+     '\V', or '\?' escape sequence is interpreted at the time the macro
+     containing it is defined, or later when the macro is called.(1)
+     (*note Copy Mode-Footnote-1::)
+
+          .nr x 20
+          .de y
+          .nr x 10
+          \&\nx
+          \&\\nx
+          ..
+          .y
+              => 20 10
+
+     You can think of '\\' as a "delayed" backslash; it is the escape
+     character followed by a backslash from which the escape character
+     has removed its special meaning.  Consequently, '\\' is not an
+     escape sequence in the usual sense.  In any escape sequence '\X'
+     that GNU 'troff' does not recognize, the escape character is
+     ignored and X is output.  An unrecognized escape sequence causes a
+     warning in category 'escape', with two exceptions--'\\' is the
+     first.
+
+ -- Escape sequence: \.
+     '\.' escapes the control character.  It is similar to '\\' in that
+     it isn't a true escape sequence.  It is used to permit nested macro
+     definitions to end without a named macro call to conclude them.
+     Without a syntax for escaping the control character, this would not
+     be possible.
+
+          .de m1
+          foo
+          .
+          .  de m2
+          bar
+          \\..
+          .
+          ..
+          .m1
+          .m2
+              => foo bar
+
+     The first backslash is consumed while the macro is read, and the
+     second is interpreted when macro 'm1' is called.
+
+   'roff' documents should not use the '\\' or '\.' character sequences
+outside of copy mode; they serve only to obfuscate the input.  Use '\e'
+to represent the escape character, '\rs' to obtain a backslash glyph,
+and '\&' before '.' and ''' where GNU 'troff' expects them as control
+characters if you mean to use them literally (recall *note Requests and
+Macros::).
+
+   Macro definitions can be nested to arbitrary depth.  The mechanics of
+parsing the escape character have significant consequences for this
+practice.
+
+     .de M1
+     \\$1
+     .  de M2
+     \\\\$1
+     .    de M3
+     \\\\\\\\$1
+     \\\\..
+     .    M3 hand.
+     \\..
+     .  M2 of
+     ..
+     This understeer is getting
+     .M1 out
+         => This understeer is getting out of hand.
+
+   Each escape character is interpreted twice--once in copy mode, when
+the macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of '\n',
+'\g', '\$', '\*', '\V', and '\?' at each nesting level, which can be
+daunting.  GNU 'troff' offers a solution.
+
+ -- Escape sequence: \E
+     '\E' represents an escape character that is not interpreted in copy
+     mode.  You can use it to ease the writing of nested macro
+     definitions.
+
+          .de M1
+          .  nop \E$1
+          .  de M2
+          .    nop \E$1
+          .    de M3
+          .      nop \E$1
+          \\\\..
+          .    M3 better.
+          \\..
+          .  M2 bit
+          ..
+          This vehicle handles
+          .M1 a
+              => This vehicle handles a bit better.
+
+     Observe that because '\.' is not a true escape sequence, we can't
+     use '\E' to keep '..' from ending a macro definition prematurely.
+     If the multiplicity of backslashes complicates maintenance, use end
+     macros.
+
+     '\E' is also convenient to define strings containing escape
+     sequences that need to work when used in copy mode (for example, as
+     macro arguments), or which will be interpolated at varying macro
+     nesting depths.  We might define strings to begin and end
+     superscripting as follows.(2)  (*note Copy Mode-Footnote-2::)
+
+          .ds { \v'-.9m\s'\En.s*7u/10u'+.7m'
+          .ds } \v'-.7m\s0+.9m'
+
+     When the 'ec' request is used to redefine the escape character,
+     '\E' also makes it easier to distinguish the semantics of an escape
+     character from the other meaning(s) its character might have.
+     Consider the use of an unusual escape character, '-'.
+
+          .nr a 1
+          .ec -
+          .de xx
+          --na
+          ..
+          .xx
+              => -na
+
+     This result may surprise you; some people expect '1' to be output
+     since register 'a' has clearly been defined with that value.  What
+     has happened?  The robotic replacement of '\' with '-' has led us
+     astray.  You might recognize the sequence '--' more readily with
+     the default escape character as '\-', the special character escape
+     sequence for the minus sign glyph.
+
+          .nr a 1
+          .ec -
+          .de xx
+          -Ena
+          ..
+          .xx
+              => 1
+
+&#x1f;
+File: groff.info,  Node: Copy Mode-Footnotes,  Up: Copy Mode
+
+   (1) Compare this to the '\def' and '\edef' commands in TeX.
+
+   (2) These are lightly adapted from the 'groff' implementation of the
+'ms' macros.
+
+&#x1f;
+File: groff.info,  Node: Page Motions,  Next: Drawing Geometric Objects,  Prev: Writing Macros,  Up: GNU troff Reference
+
+5.25 Page Motions
+=================
+
+*Note Manipulating Spacing::, for a discussion of the most commonly used
+request for vertical motion, 'sp', which spaces downward by one vee.
+
+ -- Request: .mk reg
+ -- Request: .rt dist
+     You can "mark" a location on a page for subsequent "return".  'mk'
+     takes an argument, a register name in which to store the current
+     page location.  If given no argument, it stores the location in an
+     internal register.  This location can be used later by the 'rt' or
+     the 'sp' requests (or the '\v' escape).
+
+     The 'rt' request returns _upward_ to the location marked with the
+     last 'mk' request.  If used with an argument, it returns to a
+     vertical position DIST from the top of the page (no previous call
+     to 'mk' is necessary in this case).  The default scaling unit is
+     'v'.
+
+     If a page break occurs between a 'mk' request and its matching 'rt'
+     request, the 'rt' request is silently ignored.
+
+     A simple implementation of a macro to set text in two columns
+     follows.
+
+          .nr column-length 1.5i
+          .nr column-gap 4m
+          .nr bottom-margin 1m
+          .
+          .de 2c
+          .  br
+          .  mk
+          .  ll \\ncolumn-lengthu
+          .  wh -\\nbottom-marginu 2c-trap
+          .  nr right-side 0
+          ..
+          .
+          .de 2c-trap
+          .  ie \\nright-side \{\
+          .    nr right-side 0
+          .    po -(\\ncolumn-lengthu + \\ncolumn-gapu)
+          .    \" remove trap
+          .    wh -\\nbottom-marginu
+          .  \}
+          .  el \{\
+          .    \" switch to right side
+          .    nr right-side 1
+          .    po +(\\ncolumn-lengthu + \\ncolumn-gapu)
+          .    rt
+          .  \}
+          ..
+
+     Now let us apply our two-column macro.
+
+          .pl 1.5i
+          .ll 4i
+          This is a small test that shows how the
+          rt request works in combination with mk.
+
+          .2c
+          Starting here, text is typeset in two columns.
+          Note that this implementation isn't robust
+          and thus not suited for a real two-column
+          macro.
+              => This is a small test that shows how the
+              => rt request works in combination with mk.
+              =>
+              => Starting  here,    isn't    robust
+              => text is typeset    and   thus  not
+              => in two columns.    suited  for   a
+              => Note that  this    real two-column
+              => implementation     macro.
+
+   Several escape sequences enable fine control of movement about the
+page.
+
+ -- Escape sequence: \v'expr'
+     Vertically move the drawing position.  EXPR indicates the magnitude
+     of motion: positive is downward and and negative upward.  The
+     default scaling unit is 'v'.  The motion is relative to the current
+     drawing position unless EXPR begins with the boundary-relative
+     motion operator '|'.  *Note Numeric Expressions::.
+
+     Text processing continues at the new drawing position; usually,
+     vertical motions should be in balanced pairs to avoid a confusing
+     page layout.
+
+     '\v' will not spring a vertical position trap.  This can be useful;
+     for example, consider a page bottom trap macro that prints a marker
+     in the margin to indicate continuation of a footnote.  *Note
+     Traps::.
+
+   A few escape sequences that produce vertical motion are unusual.
+They are thought to originate early in AT&T 'nroff' history to achieve
+super- and subscripting by half-line motions on line printers and
+teletypewriters before the phototypesetter made more precise positioning
+available.  They are reckoned in ems--not vees--to maintain continuity
+with their original purpose of moving relative to the size of the type
+rather than the distance between text baselines (vees).(1)  (*note Page
+Motions-Footnote-1::)
+
+ -- Escape sequence: \r
+ -- Escape sequence: \u
+ -- Escape sequence: \d
+     Move upward 1m, upward .5m, and downward .5m, respectively.
+
+Let us see these escape sequences in use.
+
+     Obtain 100 cm\u3\d of \ka\d\092\h'|\nau'\r233\dU.
+
+   In the foregoing we have paired '\u' and '\d' to typeset a
+superscript, and later a full em negative ("reverse") motion to place a
+superscript above a subscript.  A numeral-width horizontal motion escape
+sequence aligns the proton and nucleon numbers, while '\k' marks a
+horizontal position to which '\h' returns so that we could stack them.
+(We shall discuss these horizontal motion escape sequences presently.)
+In serious applications, we often want to alter the type size of the
+-scripts and to fine-tune the vertical motions, as the 'groff' 'ms'
+package does with its super- and subscripting string definitions.
+
+ -- Escape sequence: \h'expr'
+     Horizontally move the drawing position.  EXPR indicates the
+     magnitude of motion: positive is rightward and negative leftward.
+     The default scaling unit is 'm'.  The motion is relative to the
+     current drawing position unless EXPR begins with the
+     boundary-relative motion operator '|'.  *Note Numeric
+     Expressions::.
+
+   The following string definition sets the TeX logo.(2)  (*note Page
+Motions-Footnote-2::)
+
+     .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\"
+
+   There are a number of special-case escape sequences for horizontal
+motion.
+
+ -- Escape sequence: \<SP>
+     Move right one word space.  (The input is a backslash followed by a
+     space.)  This escape sequence can be thought of as a
+     non-adjustable, unbreakable space.  Usually you want '\~' instead;
+     see *note Manipulating Filling and Adjustment::.
+
+ -- Escape sequence: \|
+     Move one-sixth em to the right on typesetting output devices.  If a
+     glyph named '\|' is defined in the current font, its width is used
+     instead, even on terminal output devices.
+
+ -- Escape sequence: \^
+     Move one-twelfth em to the right on typesetting output devices.  If
+     a glyph named '\^' is defined in the current font, its width is
+     used instead, even on terminal output devices.
+
+ -- Escape sequence: \0
+     Move right by the width of a numeral in the current font.
+
+   Horizontal motions are not discarded at the end of an output line as
+word spaces are.  *Note Breaking::.
+
+ -- Escape sequence: \w'anything'
+ -- Register: \nst
+ -- Register: \nsb
+ -- Register: \nrst
+ -- Register: \nrsb
+ -- Register: \nct
+ -- Register: \nssc
+ -- Register: \nskw
+     Interpolate the width of ANYTHING in basic units.  This escape
+     sequence allows several properties of formatted output to be
+     measured without writing it out.
+
+          The length of the string 'abc' is \w'abc'u.
+              => The length of the string 'abc' is 72u.
+
+     ANYTHING is processed in a dummy environment: this means that font
+     and type size changes, for example, may occur within it without
+     affecting subsequent output.
+
+     After each use, '\w' sets several registers.
+
+     'st'
+     'sb'
+          The maximum vertical displacements of the text baseline above
+          and below, respectively.  The sign convention is opposite that
+          of relative vertical motions; that is, depth below the
+          (original) baseline is negative.  These registers are
+          incorrectly documented in the AT&T 'troff' manual as "the
+          highest and lowest extent of the argument to '\w' relative
+          to the baseline".
+
+     'rst'
+     'rsb'
+          Like 'st' and 'sb', but taking account of the heights and
+          depths of glyphs.  In other words, these registers store the
+          highest and lowest vertical positions attained by ANYTHING,
+          doing what AT&T 'troff' documented 'st' and 'sb' as doing.
+
+     'ct'
+          Characterizes the geometry of glyphs occurring in ANYTHING.
+
+          0
+               only short glyphs, no descenders or tall glyphs
+
+          1
+               at least one descender
+
+          2
+               at least one tall glyph
+
+          3
+               at least one each of a descender and a tall glyph
+
+     'ssc'
+          The amount of horizontal space (possibly negative) that should
+          be added to the last glyph before a subscript.
+
+     'skw'
+          How far to right of the center of the last glyph in the '\w'
+          argument, the center of an accent from a roman font should be
+          placed over that glyph.
+
+ -- Escape sequence: \kp
+ -- Escape sequence: \k(ps
+ -- Escape sequence: \kposition
+     Store the current horizontal position in the _input_ line in a
+     register with the name POSITION (one-character name P,
+     two-character name PS).  Use this, for example, to return to the
+     beginning of a string for highlighting or other decoration.
+
+ -- Register: \nhp
+     The current horizontal position at the input line.
+
+ -- Register: \n.k
+     A read-only register containing the current horizontal output
+     position (relative to the current indentation).
+
+ -- Escape sequence: \o'abc...'
+     Overstrike the glyphs of characters A, B, C, ...; the glyphs are
+     centered, written, and the drawing position advanced by the widest
+     of the glyphs.
+
+ -- Escape sequence: \zc
+     Format the character C with zero width; that is, without advancing
+     the drawing position.  Use '\z' to overstrike glyphs aligned to
+     their left edges, in contrast to '\o''s centering.
+
+ -- Escape sequence: \Z'anything'
+     Save the drawing position, format ANYTHING, then restore it.  Tabs
+     and leaders in the argument are ignored with an error diagnostic.
+
+     We might implement a strike-through macro thus.
+
+          .de ST
+          .nr width \w'\\$1'
+          \Z@\v'-.25m'\l'\\nwidthu'@\\$1
+          ..
+          .
+          This is
+          .ST "a test"
+          an actual emergency!
+
+&#x1f;
+File: groff.info,  Node: Page Motions-Footnotes,  Up: Page Motions
+
+   (1) At the 'grops' defaults of 10-point type on 12-point vertical
+spacing, the difference between half a vee and half an em can be subtle:
+large spacings like '.vs .5i' make it obvious.
+
+   (2) *Note Strings::, for an explanation of the trailing '\"'.
+
+&#x1f;
+File: groff.info,  Node: Drawing Geometric Objects,  Next: Traps,  Prev: Page Motions,  Up: GNU troff Reference
+
+5.26 Drawing Geometric Objects
+==============================
+
+A few of the formatter's escape sequences draw lines and other geometric
+objects.  Combined with each other and with page motion commands (*note
+Page Motions::), a wide variety of figures is possible.  For complex
+drawings, these operations can be cumbersome; the preprocessors 'gpic'
+or 'ggrn' are typically used instead.
+
+   The '\l' and '\L' escape sequences draw horizontal and vertical
+sequences of glyphs, respectively.  Even the simplest of output devices
+supports them.
+
+ -- Escape sequence: \l'l'
+ -- Escape sequence: \l'lc'
+     Draw a horizontal line of length L from the drawing position.
+     Rightward motion is positive.  Afterward, the drawing position is
+     at the right end of the line.  The default scaling unit is 'm'.
+
+     The optional second parameter C is a character with which to draw
+     the line.  The default is the baseline rule special character,
+     '\ru'.
+
+     If C is a valid scaling unit, put '\&' after L to disambiguate the
+     input.
+
+          .de textbox
+          \br\\$*\br\l'|0\rn'\l'|0\ul'
+          ..
+
+     The foregoing outputs a box rule (a vertical line), the text
+     argument(s), and another box rule.  We employ the boundary-relative
+     motion operator '|'.  Finally, the line-drawing escape sequences
+     draw a radical extender (a form of overline) and an underline from
+     the drawing position to the position coresponding to beginning of
+     the _input_ line.  The drawing position returns to just after the
+     right-hand box rule because the lengths of the drawn lines are
+     negative, as noted above.
+
+ -- Escape sequence: \L'l'
+ -- Escape sequence: \L'lc'
+     Draw a vertical line of length L from the drawing position.
+     Downward motion is positive.  The default scaling unit is 'v'.  The
+     default character is the box rule, '\br'.  As with vertical
+     motion escape sequences, text processing continues where the line
+     ends.  '\L' is otherwise similar to '\l'.
+
+          $ nroff <<EOF
+          This is a \L'3v'test.
+          EOF
+              => This is a
+              =>           |
+              =>           |
+              =>           |test.
+
+     When writing text, the drawing position is at the text baseline;
+     recall *note Page Geometry::.
+
+   The '\D' escape sequence provides "drawing commands" that direct the
+output device to render geometrical objects rather than glyphs.
+Specific devices may support only a subset, or may feature additional
+ones; consult the man page for the output driver in use.  Terminal
+devices in particular implement almost none.  *Note Graphics Commands::.
+
+   Rendering starts at the drawing position; when finished, the drawing
+position is left at the rightmost point of the object, even for closed
+figures, except where noted.  GNU 'troff' draws stroked (outlined)
+objects with the stroke color, and shades filled ones with the fill
+color.  *Note Colors::.  Coordinates H and V are horizontal and vertical
+motions relative to the drawing position or previous point in the
+command.  The default scaling unit for horizontal measurements (and
+diameters of circles) is 'm'; for vertical ones, 'v'.
+
+   Circles, ellipses, and polygons can be drawn filled or stroked.
+These are independent properties; if you want a filled, stroked figure,
+you must draw the same figure twice using each drawing command.  A
+filled figure is always smaller than an outlined one because the former
+is drawn only within its defined area, whereas strokes have a line
+thickness (set with '\D't'').
+
+     \h'1i'\v'1i'\
+     \# increase line thickness
+     \Z'\D't 5p''\
+     \# draw stroked (unfilled) polygon
+     \Z'\D'p 3 3 -6 0''\
+     \# draw filled (solid) polygon
+     \Z'\D'P 3 3 -6 0''
+
+ -- Escape sequence: \D'command argument ...'
+     Drawing command escape sequence parameters begin with an ordinary
+     character, COMMAND, selecting the type of object to be drawn,
+     followed by ARGUMENTs whose meaning is determined by COMMAND.
+
+     '\D'~ H1 V1 ... HN VN''
+          Draw a B-spline to each point in sequence, leaving the drawing
+          position at (HN, VN).
+
+     '\D'a HC VC H V''
+          Draw a circular arc centered at (HC, VC) counterclockwise from
+          the drawing position to a point (H, V) relative to the center.
+          (1)  (*note Drawing Geometric Objects-Footnote-1::)
+
+     '\D'c D''
+          Draw a circle of diameter D with its leftmost point at the
+          drawing position.
+
+     '\D'C D''
+          As '\D'C ...'', but the circle is filled.
+
+     '\D'e H V''
+          Draw an ellipse of width H and height V with its leftmost
+          point at the drawing position.
+
+     '\D'E X Y''
+          As '\D'e ...'', but the ellipse is filled.
+
+     '\D'l DX DY''
+          Draw line from the drawing position to (H, V).
+
+          The following is a macro for drawing a box around a text
+          argument; for simplicity, the box margin is a fixed at 0.2m.
+
+               .de TEXTBOX
+               .  nr @wd \w'\\$1'
+               \h'.2m'\
+               \h'-.2m'\v'(.2m - \\nrsbu)'\
+               \D'l 0 -(\\nrstu - \\nrsbu + .4m)'\
+               \D'l (\\n@wdu + .4m) 0'\
+               \D'l 0 (\\nrstu - \\nrsbu + .4m)'\
+               \D'l -(\\n@wdu + .4m) 0'\
+               \h'.2m'\v'-(.2m - \\nrsbu)'\
+               \\$1\
+               \h'.2m'
+               ..
+
+          The argument is measured with the '\w' escape sequence.  Its
+          width is stored in register '@wd'.  '\w' also sets the
+          registers 'rst' and 'rsb'; these contain its maximum vertical
+          extents of the argument.  Then, four lines are drawn to form a
+          box, offset by the box margin.
+
+     '\D'p H1 V1 ... HN VN''
+          Draw polygon with vertices at drawing position and each point
+          in sequence.  GNU 'troff' closes the polygon by drawing a line
+          from (HN, VN) back to the initial drawing position.
+          Afterward, the drawing position is left at (HN, VN).
+
+     '\D'P DX1 DY1 DX2 DY2 ...''
+          As '\D'P ...'', but the polygon is filled.
+
+          The following macro is like the '\D'l'' example, but shades
+          the box.  We draw the box before writing the text because
+          colors in GNU 'troff' have no transparency; in othe opposite
+          order, the filled polygon would occlude the text.
+
+               .de TEXTBOX
+               .  nr @wd \w'\\$1'
+               \h'.2m'\
+               \h'-.2m'\v'(.2m - \\nrsbu)'\
+               \Mlightcyan\
+               \D'P 0 -(\\nrstu - \\nrsbu + .4m) \
+                    (\\n@wdu + .4m) 0 \
+                    0 (\\nrstu - \\nrsbu + .4m) \
+                    -(\\n@wdu + .4m) 0'\
+               \h'.2m'\v'-(.2m - \\nrsbu)'\
+               \M\
+               \\$1\
+               \h'.2m'
+               ..
+
+     '\D't N''
+          Set the stroke thickness of geometric objects to N basic
+          units.  A zero N selects the minimal supported thickness.  A
+          negative N selects a thickness proportional to the type size;
+          this is the default.
+
+   In a hazy penumbra between text rendering and drawing commands we
+locate the bracket-building escape sequence, '\b'.  It can assemble
+apparently large glyphs by vertically stacking ordinary ones.
+
+ -- Escape sequence: \b'contents'
+     Pile and center a sequence of glyphs vertically on the output line.
+     "Piling" stacks glyphs corresponding to each character in CONTENTS,
+     read from left to right, and placed from top to bottom.  GNU
+     'troff' separates the glyphs vertically by 1m, and the pile itself
+     is centered 0.5m above the text baseline.  The horizontal drawing
+     position is then advanced by the width of the widest glyph in the
+     pile.
+
+     This rather inflexible positioning algorithm doesn't work with the
+     'dvi' output device since its bracket pieces vary in height.
+     Instead, use the 'geqn' preprocessor.
+
+     *note Manipulating Spacing:: describes how to adjust the vertical
+     spacing of the output line with the '\x' escape sequence.
+
+     The application of '\b' that lends its name is construction of
+     brackets, braces, and parentheses when typesetting mathematics.  We
+     might construct a large opening (left) brace as follows.
+
+          \b'\lt\bv\lk\bv\lb'
+
+     See 'groff_char(7)' for a list of special character identifiers.
+
+&#x1f;
+File: groff.info,  Node: Drawing Geometric Objects-Footnotes,  Up: Drawing Geometric Objects
+
+   (1) (HC, VC) is adjusted to the point nearest the perpendicular
+bisector of the arc's chord.
+
+&#x1f;
+File: groff.info,  Node: Deferring Output,  Next: Traps,  Prev: Drawing Geometric Objects,  Up: GNU troff Reference
+
+5.27 Deferring Output
+=====================
+
+A few 'roff' language elements are generally not used in simple
+documents, but arise as page layouts become more sophisticated and
+demanding.  "Environments" collect formatting parameters like line
+length and typeface.  A "diversion" stores formatted output for later
+use.  A "trap" is a condition on the input or output, tested
+automatically by the formatter, that is associated with a macro, causing
+it to be called when that condition is fulfilled.
+
+   Footnote support often exercises all three of the foregoing features.
+A simple implementation might work as follows.  A pair of macros is
+defined: one starts a footnote and the other ends it.  The author calls
+the first macro where a footnote marker is desired.  The macro
+establishes a diversion so that the footnote text is collected at the
+place in the body text where its corresponding marker appears.  An
+environment is created for the footnote so that it is set at a smaller
+typeface.  The footnote text is formatted in the diversion using that
+environment, but it does not yet appear in the output.  The document
+author calls the footnote end macro, which returns to the previous
+environment and ends the diversion.  Later, after much more body text in
+the document, a trap, set a small distance above the page bottom, is
+sprung.  The macro called by the trap draws a line across the page and
+emits the stored diversion.  Thus, the footnote is rendered.
+
+   Diversions and traps make the text formatting process non-linear.
+Let us imagine a set of text lines or paragraphs labelled 'A', 'B', and
+so on.  If we set up a trap that produces text 'T' (as a page footer,
+say), and we also use a diversion to store the formatted text 'D', then
+a document with input text in the order 'A B C D E F' might render as 'A
+B C E T F'.  The diversion 'D' will never be output if we do not call
+for it.
+
+   Environments of themselves are not a source of non-linearity in
+document formatting: environment switches have immediate effect.  One
+could always write a macro to change as many formatting parameters as
+desired with a single convenient call.  But because diversions can be
+nested and macros called by traps that are sprung by other trap-called
+macros, they may be called upon in varying contexts.  For example,
+consider a page header that is always to be set in Helvetica.  A
+document that uses Times for most of its body text, but Courier for
+displayed code examples, poses a challenge if a page break occurs in the
+middle of a code display; if the header trap assumes that the "previous
+font" is always Times, the rest of the example will be formatted in the
+wrong typeface.  One could carefully save all formatting parameters upon
+entering the trap and restore them upon leaving it, but this is verbose,
+error-prone, and not future-proof as the 'groff' language develops.
+Environments save us considerable effort.
+
+&#x1f;
+File: groff.info,  Node: Traps,  Next: Diversions,  Prev: Deferring Output,  Up: GNU troff Reference
+
+5.28 Traps
+==========
+
+"Traps" are locations in the output or conditions on the input that,
+when reached or fulfilled, call a specified macro.  These traps can
+occur at a given location on the page, at a given location in the
+current diversion (together, these are known as vertical position
+traps), at a blank line, at a line with leading space characters, after
+a quantity of input lines, or at the end of input.  Macros called by
+traps are passed no arguments.  Setting a trap is also called "planting"
+one.  It is said that a trap is "sprung" if its condition is fulfilled.
+
+* Menu:
+
+* Vertical Position Traps::
+* Diversion Traps::
+* Input Line Traps::
+* Blank Line Traps::
+* Leading Space Traps::
+* End-of-input Traps::
+
+&#x1f;
+File: groff.info,  Node: Vertical Position Traps,  Next: Page Location Traps,  Prev: Traps,  Up: Traps
+
+5.28.1 Vertical Position Traps
+------------------------------
+
+A "vertical position trap" calls a macro when the formatter's vertical
+drawing position reaches or passes, in the downward direction, a certain
+location on the output page or in a diversion.  Its applications include
+setting page headers and footers, body text in multiple columns, and
+footnotes.
+
+ -- Request: .vpt flag
+ -- Register: \n.vpt
+     Enable vertical position traps if FLAG is non-zero or absent;
+     disable them otherwise.  Vertical position traps are those set by
+     the 'wh' request or by 'dt' within a diversion.  The parameter that
+     controls whether vertical position traps are enabled is global.
+     Initially, vertical position traps are enabled.  The current value
+     is stored in the '.vpt' read-only register.
+
+     A page can't be ejected if 'vpt' is set to zero; see *note The
+     Implicit Page Trap::.
+
+* Menu:
+
+* Page Location Traps::
+* The Implicit Page Trap::
+* Diversion Traps::
+
+&#x1f;
+File: groff.info,  Node: Page Location Traps,  Next: The Implicit Page Trap,  Prev: Vertical Position Traps,  Up: Vertical Position Traps
+
+5.28.1.1 Page Location Traps
+............................
+
+A "page location trap" is a vertical position trap that applies to the
+page; that is, to undiverted output.  Many can be present; manage them
+with the 'wh' and 'ch' requests.
+
+ -- Request: .wh dist name
+     Plant macro NAME as page location trap at DIST.  The default
+     scaling unit is 'v'.  Non-negative values for DIST set the trap
+     relative to the top of the page; negative values set the trap
+     relative to the bottom of the page.  It is not possible to plant a
+     trap less than one basic unit from the page bottom: a DIST of '-0'
+     is interpreted as '0', the top of the page.(1)  (*note Page
+     Location Traps-Footnote-1::) An existing _visible_ trap (see below)
+     at DIST is removed; this is 'wh''s sole function if NAME is
+     missing.
+
+     A trap is sprung only if it is "visible", meaning that its location
+     is reachable on the page(2) (*note Page Location
+     Traps-Footnote-2::) and it is not hidden by another trap at the
+     same location already planted there.
+
+     A macro package might set headers and footers as follows; this
+     example configures vertical margins of one inch to the body text,
+     and one half-inch to the titles.  Observe the use of the no-break
+     control character with 'sp' request to position our text baselines,
+     and the page number character '%' used with the 'tl' request.
+
+          .\" hdfo.roff
+          .de hd                  \" page header
+          '  sp .5i
+          '  tl '\\*(Ti''\\*(Da'  \" title and date strings
+          '  sp .5i
+          ..
+          .de fo                  \" page footer
+          '  sp .5i
+          .  tl ''%''
+          .  bp
+          ..
+          .wh 0   hd             \" trap at top of the page
+          .wh -1i fo             \" trap 1 inch from bottom
+
+     To use these traps, copy the above (or load it from a file with the
+     'so' or 'mso' requests), then set up the strings it uses.
+
+          .so hdfo.roff
+          .ds Ti Final Report\"
+          .ds Da 21 May 2023\"
+          .ti
+          On 5 August of last year,
+          this committee tasked me with the investigation of the
+          CFIT (controlled flight into terrain) incident of
+          .\" ...and so on...
+
+     A trap above the top or at or below the bottom of the page can be
+     made visible by either moving it into the page area or increasing
+     the page length so that the trap is on the page.  Negative trap
+     values always use the _current_ page length; they are not converted
+     to an absolute vertical position.  We can use the 'ptr' request to
+     dump our page location traps to the standard error stream (*note
+     Debugging::).  Their positions are reported in basic units; an
+     'nroff' device example follows.
+
+          .pl 5i
+          .wh -1i xx
+          .ptr
+              error-> xx      -240
+          .pl 100i
+          .ptr
+              error-> xx      -240
+
+     It is possible to have more than one trap at the same location
+     (although only one at a time can be visible); to achieve this, the
+     traps must be defined at different locations, then moved to the
+     same place with the 'ch' request.  In the following example, the
+     many empty lines caused by the 'bp' request are not shown in the
+     output.
+
+          .de a
+          .  nop a
+          ..
+          .de b
+          .  nop b
+          ..
+          .de c
+          .  nop c
+          ..
+          .
+          .wh 1i a
+          .wh 2i b
+          .wh 3i c
+          .bp
+              => a b c
+          .ch b 1i
+          .ch c 1i
+          .bp
+              => a
+          .ch a 0.5i
+          .bp
+              => a b
+
+ -- Register: \n.t
+     The read-only register '.t' holds the distance to the next vertical
+     position trap.  If there are no traps between the current position
+     and the bottom of the page, it contains the distance to the page
+     bottom.  Within a diversion, in the absence of a diversion trap,
+     this distance is the largest representable integer in basic
+     units--effectively infinite.
+
+ -- Request: .ch name dist
+     Change the location of a trap by moving macro NAME to new location
+     DIST, or by unplanting it altogether if DIST is absent.  The
+     default scaling unit is 'v'.  Parameters to 'ch' are specified in
+     the opposite order from 'wh'.  If NAME is the earliest planted
+     macro of multiple traps at the same location, (re)moving it from
+     that location exposes the macro next least recently planted at the
+     same place.(3)  (*note Page Location Traps-Footnote-3::)
+
+     Changing a trap's location is useful for building up footnotes in a
+     diversion to allow more space at the bottom of the page for them.
+
+   The same macro can be installed simultaneously at multiple locations;
+however, only the earliest-planted instance--that has not yet been
+deleted with 'wh'--will be moved by 'ch'.  The following example (using
+an 'nroff' device) illustrates this behavior.  Blank lines have been
+elided from the output.
+
+     .de T
+     Trap sprung at \\n(nlu.
+     .br
+     ..
+     .wh 1i T
+     .wh 2i T
+     foo
+     .sp 11i
+     .bp
+     .ch T 4i
+     bar
+     .sp 11i
+     .bp
+     .ch T 5i
+     baz
+     .sp 11i
+     .bp
+     .wh 5i
+     .ch T 6i
+     qux
+     .sp 11i
+         => foo
+         => Trap sprung at 240u.
+         => Trap sprung at 480u.
+         => bar
+         => Trap sprung at 480u.
+         => Trap sprung at 960u.
+         => baz
+         => Trap sprung at 480u.
+         => Trap sprung at 1200u.
+         => qux
+         => Trap sprung at 1440u.
+
+ -- Register: \n.ne
+     The read-only register '.ne' contains the amount of space that was
+     needed in the last 'ne' request that caused a trap to be sprung; it
+     is useful in conjunction with the '.trunc' register.  *Note Page
+     Control::.  Since the '.ne' register is set only by traps, it
+     doesn't make sense to interpolate it outside of macros called by
+     traps.
+
+ -- Register: \n.trunc
+     A read-only register containing the amount of vertical space
+     truncated from an 'sp' request by the most recently sprung vertical
+     position trap, or, if the trap was sprung by an 'ne' request, minus
+     the amount of vertical motion produced by the 'ne' request.  In
+     other words, at the point a trap is sprung, it represents the
+     difference of what the vertical position would have been but for
+     the trap, and what the vertical position actually is.  Since the
+     '.trunc' register is set only by traps, it doesn't make sense to
+     interpolate it outside of macros called by traps.
+
+ -- Register: \n.pe
+     This Boolean-valued, read-only register interpolates 1 while a page
+     is being ejected, and 0 otherwise.
+
+     In the following example, we plant the same trap at the top and the
+     bottom of the page.  We also make the trap report its name and the
+     vertical drawing position.
+
+          .de T
+          .tm \\$0: page \\n%, nl=\\nnl .pe=\\n.pe
+          ..
+          .ll 46n
+          .wh 0 T
+          .wh -1v T
+          Those who can make you believe absurdities can make you
+          commit atrocities. \em Voltaire
+              error-> T: page 1, nl=0 .pe=0
+              error-> T: page 1, nl=2600 .pe=1
+              => Those who can make you believe absurdities can
+              => make you commit atrocities. -- Voltaire
+
+   When designing macros, keep in mind that diversions and traps do
+normally interact.  For example, if a trap calls a header macro (while
+outputting a diversion) that tries to change the font on the current
+page, the effect is not visible before the diversion has completely been
+printed (except for input protected with '\!' or '\?') since the data in
+the diversion is already formatted.  In most cases, this is not the
+expected behaviour.
+
+&#x1f;
+File: groff.info,  Node: Page Location Traps-Footnotes,  Up: Page Location Traps
+
+   (1) *Note The Implicit Page Trap::.
+
+   (2) A trap planted at '20i' or '-30i' will not be sprung on a page of
+length '11i'.
+
+   (3) It may help to think of each trap location as maintaining a
+queue; 'wh' operates on the head of the queue, and 'ch' operates on its
+tail.  Only the trap at the head of the queue is visible.
+
+&#x1f;
+File: groff.info,  Node: The Implicit Page Trap,  Next: Diversion Traps,  Prev: Page Location Traps,  Up: Vertical Position Traps
+
+5.28.1.2 The Implicit Page Trap
+...............................
+
+If, after starting GNU 'troff' without loading a macro package, you use
+the 'ptr' request to dump a list of the active traps to the standard
+error stream,(1) (*note The Implicit Page Trap-Footnote-1::) nothing is
+reported.  Yet the '.t' register will report a steadily decreasing value
+with every output line your document produces, and once the value of
+'.t' gets to within '.V' of zero, you will notice that something
+trap-like happens--the page is ejected, a new one begins, and the value
+of '.t' becomes large once more.
+
+   This "implicit page trap" always exists in the top-level
+diversion;(2) (*note The Implicit Page Trap-Footnote-2::) it works like
+a trap in some ways but not others.  Its purpose is to eject the current
+page and start the next one.  It has no name, so it cannot be moved or
+deleted with 'wh' or 'ch' requests.  You cannot hide it by placing
+another trap at its location, and can move it only by redefining the
+page length with 'pl'.  Its operation is suppressed when vertical page
+traps are disabled with GNU 'troff''s 'vpt' request.
+
+&#x1f;
+File: groff.info,  Node: The Implicit Page Trap-Footnotes,  Up: The Implicit Page Trap
+
+   (1) *Note Debugging::.
+
+   (2) *Note Diversions::.
+
+&#x1f;
+File: groff.info,  Node: Diversion Traps,  Next: Input Line Traps,  Prev: The Implicit Page Trap,  Up: Vertical Position Traps
+
+5.28.1.3 Diversion Traps
+........................
+
+A diversion is not formatted in the context of a page, so it lacks page
+location traps; instead it can have a "diversion trap".  There can exist
+at most one such vertical position trap per diversion.
+
+ -- Request: .dt dist name
+     Set a trap _within_ a diversion at location DIST, which is
+     interpreted relative to diversion rather than page boundaries.  If
+     invoked with fewer than two arguments, any diversion trap in the
+     current diversion is removed.  The register '.t' works within
+     diversions.  It is an error to invoke 'dt' in the top-level
+     diversion.  *Note Diversions::.
+
+&#x1f;
+File: groff.info,  Node: Input Line Traps,  Next: Blank Line Traps,  Prev: Diversion Traps,  Up: Traps
+
+5.28.2 Input Line Traps
+-----------------------
+
+ -- Request: .it n name
+ -- Request: .itc n name
+     Set an input line trap, calling macro NAME after processing the
+     next N productive input lines (recall *note Manipulating Filling
+     and Adjustment::).  Any existing input line trap in the environment
+     is replaced.  Without arguments, 'it' and 'itc' clear any input
+     line trap that has not yet sprung.
+
+     Consider a macro '.ST S N' which sets the next N input lines in the
+     font style S.
+
+          .de ST \" Use style $1 for next $2 text lines.
+          .  it \\$2 ES
+          .  ft \\$1
+          ..
+          .de ES \" end ST
+          .  ft R
+          ..
+          .ST I 1
+          oblique
+          face
+          .ST I 1
+          oblique\c
+          face
+              => oblique face obliqueface  (second "face" upright)
+
+     Unlike the 'ce' and 'rj' requests, 'it' counts lines interrupted
+     with the '\c' escape sequence separately (*note Line
+     Continuation::); 'itc' does not.  To see the difference, let's
+     change the previous example to use 'itc' instead.
+
+          ...
+          .  itc \\$2 ES
+          ...
+              => oblique face obliqueface  (second "face" oblique)
+
+     You can think of the 'ce' and 'rj' requests as implicitly creating
+     an input line trap with 'itc' that schedules a break when the trap
+     is sprung.
+
+          .de BR
+          .  br
+          .  internal: disable centering-without-filling
+          ..
+          .
+          .de ce
+          .  if \\n.br .br
+          .  itc \\$1 BR
+          .  internal: enable centering-without-filling
+          ..
+
+     Let us consider in more detail the sorts of input lines that are or
+     are not "productive".
+
+          .de Trap
+          TRAP SPRUNG
+          ..
+          .de Mac
+          .if r a \l'5n'
+          ..
+          .it 2 Trap
+          .
+          foo
+          .Mac
+          bar
+          baz
+          .it 1 Trap
+          .sp \" moves, but does not write or draw
+          qux
+          .itc 1 Trap
+          \h'5n'\c \" moves, but does not write or draw
+          jat
+
+     When 'Trap' gets called depends on whether the 'a' register is
+     defined; the control line with the 'if' request may or may not
+     produce written output.  We also see that the spacing request 'sp',
+     while certainly affecting the output, does not spring the input
+     line trap.  Similarly, the horizontal motion escape sequence '\h'
+     also affected the output, but was not "written".  Observe that we
+     had to follow it with '\c' and use 'itc' to prevent the newline at
+     the end of the text line from causing a word break, which, like an
+     ordinary space character, counts as written output.
+
+          $ groff -Tascii input-trap-example.groff
+              => foo bar TRAP SPRUNG baz
+              =>
+              => qux TRAP SPRUNG      jat TRAP SPRUNG
+          $ groff -Tascii -ra1 input-trap-example.groff
+              => foo _____ TRAP SPRUNG bar baz
+              =>
+              => qux TRAP SPRUNG      jat TRAP SPRUNG
+
+   Input line traps are associated with the environment (*note
+Environments::); switching to another environment suspends the current
+input line trap, and going back resumes it, restoring the count of
+qualifying lines enumerated in that environment.
+
+&#x1f;
+File: groff.info,  Node: Blank Line Traps,  Next: Leading Space Traps,  Prev: Input Line Traps,  Up: Traps
+
+5.28.3 Blank Line Traps
+-----------------------
+
+ -- Request: .blm name
+     Set a blank line trap, calling the macro NAME when GNU 'troff'
+     encounters a blank line in an input file, instead of the usual
+     behavior (*note Breaking::).  A line consisting only of spaces is
+     also treated as blank and subject to this trap.  If no argument is
+     supplied, the default blank line behavior is (re-)established.
+
+&#x1f;
+File: groff.info,  Node: Leading Space Traps,  Next: End-of-input Traps,  Prev: Blank Line Traps,  Up: Traps
+
+5.28.4 Leading Space Traps
+--------------------------
+
+ -- Request: .lsm name
+ -- Register: \nlsn
+ -- Register: \nlss
+     Set a leading space trap, calling the macro NAME when GNU 'troff'
+     encounters leading spaces in an input line; the implicit line break
+     that normally happens in this case is suppressed.  If no argument
+     is supplied, the default leading space behavior is (re-)established
+     (*note Breaking::).
+
+     The count of leading spaces on an input line is stored in register
+     'lsn', and the amount of corresponding horizontal motion in
+     register 'lss', irrespective of whether a leading space trap is
+     set.  When it is, the leading spaces are removed from the input
+     line, and no motion is produced before calling NAME.
+
+&#x1f;
+File: groff.info,  Node: End-of-input Traps,  Prev: Leading Space Traps,  Up: Traps
+
+5.28.5 End-of-input Traps
+-------------------------
+
+ -- Request: .em name
+     Set a trap at the end of input, calling macro NAME after the last
+     line of the last input file has been processed.  If no argument is
+     given, any existing end-of-input trap is removed.
+
+     For example, if the document had to have a section at the bottom of
+     the last page for someone to approve it, the 'em' request could be
+     used.
+
+          .de approval
+          \c
+          .  ne 3v
+          .  sp (\\n.tu - 3v)
+          .  in +4i
+          .  lc _
+          .  br
+          Approved:\t\a
+          .  sp
+          Date:\t\t\a
+          ..
+          .
+          .em approval
+
+     The '\c' in the above example needs explanation.  For historical
+     reasons (compatibility with AT&T 'troff'), the end-of-input macro
+     exits as soon as it causes a page break if no partially collected
+     line remains.(1)  (*note End-of-input Traps-Footnote-1::)
+
+     Let us assume that there is no '\c' in the above 'approval' macro,
+     that the page is full, and last output line has been broken with,
+     say, a 'br' request.  Because there is no more room, a 'ne' request
+     at this point causes a page ejection, which in turn makes 'troff'
+     exit immediately as just described.  In most situations, this is
+     not desired; people generally want to format the input after 'ne'.
+
+     To force processing of the whole end-of-input macro independently
+     of this behavior, it is thus advisable to (invisibly) ensure the
+     existence of a partially collected line ('\c') whenever there is a
+     chance that a page break can happen.  In the above example,
+     invoking the 'ne' request ensures that there is room for the
+     subsequent formatted output on the same page, so we need insert
+     '\c' only once.
+
+     The next example shows how to append three lines, then start a new
+     page unconditionally.  Since '.ne 1' doesn't give the desired
+     effect--there is always one line available or we are already at the
+     beginning of the next page--we temporarily increase the page length
+     by one line so that we can use '.ne 2'.
+
+          .de EM
+          .pl +1v
+          \c
+          .ne 2
+          line one
+          .br
+          \c
+          .ne 2
+          line two
+          .br
+          \c
+          .ne 2
+          line three
+          .br
+          .pl -1v
+          \c
+          'bp
+          ..
+          .em EM
+
+     This specific feature affects only the first potential page break
+     caused by the end-of-input macro; further page breaks emitted by
+     the macro are handled normally.
+
+     Another possible use of the 'em' request is to make GNU 'troff'
+     emit a single large page instead of multiple pages.  For example,
+     one may want to produce a long plain text file for reading in a
+     terminal or emulator without page footers and headers interrupting
+     the body of the document.  One approach is to set the page length
+     at the beginning of the document to a very large value to hold all
+     the text,(2) (*note End-of-input Traps-Footnote-2::) and
+     automatically adjust it to the exact height of the document after
+     the text has been output.
+
+          .de adjust-page-length
+          .  br
+          .  pl \\nnlu \" \nnl: current vertical position
+          ..
+          .
+          .de single-page-mode
+          .  pl 99999
+          .  em adjust-page-length
+          ..
+          .
+          .\" Activate the above code if configured.
+          .if \ndo-continuous-rendering \
+          .  single-page-mode
+
+     Since only one end-of-input trap exists and another macro package
+     may already use it, care must be taken not to break the mechanism.
+     A simple solution would be to append the above macro to the macro
+     package's end-of-input macro using the 'am' request.
+
+&#x1f;
+File: groff.info,  Node: End-of-input Traps-Footnotes,  Up: End-of-input Traps
+
+   (1) While processing an end-of-input macro, the formatter assumes
+that the next page break must be the last; it goes into "sudden death
+overtime".
+
+   (2) Another, taken by the 'groff' 'man' macros, is to intercept 'ne'
+requests and wrap 'bp' ones.
+
+&#x1f;
+File: groff.info,  Node: Diversions,  Next: Punning Names,  Prev: Traps,  Up: GNU troff Reference
+
+5.29 Diversions
+===============
+
+In 'roff' systems it is possible to format text as if for output, but
+instead of writing it immediately, one can "divert" the formatted text
+into a named storage area.  It is retrieved later by specifying its name
+after a control character.  The same name space is used for such
+diversions as for strings and macros; see *note Identifiers::.  Such
+text is sometimes said to be "stored in a macro", but this coinage
+obscures the important distinction between macros and strings on one
+hand and diversions on the other; the former store _unformatted_ input
+text, and the latter capture _formatted_ output.  Diversions also do not
+interpret arguments.  Applications of diversions include "keeps"
+(preventing a page break from occurring at an inconvenient place by
+forcing a set of output lines to be set as a group), footnotes, tables
+of contents, and indices.  For orthogonality it is said that GNU 'troff'
+is in the "top-level diversion" if no diversion is active (that is,
+formatted output is being "diverted" immediately to the output device).
+
+   Dereferencing an undefined diversion will create an empty one of that
+name and cause a warning in category 'mac' to be emitted.  *Note
+Warnings::, for information about the enablement and suppression of
+warnings.  A diversion does not exist for the purpose of testing with
+the 'd' conditional operator until its initial definition ends (*note
+Operators in Conditionals::).  The following requests are used to create
+and alter diversions.
+
+ -- Request: .di name
+ -- Request: .da name
+     Start collecting formatted output in a diversion called NAME.  The
+     'da' request appends to a diversion called NAME, creating it if
+     necessary.  If NAME already exists as an alias, the target of the
+     alias is replaced or appended to; recall *note Strings::.  The
+     pending output line is diverted as well.  Switching to another
+     environment (with the 'ev' request) before invoking 'di' or 'da'
+     avoids including any pending output line in the diversion; see
+     *note Environments::.
+
+     Invoking 'di' or 'da' without an argument stops diverting output to
+     the diversion named by the most recent corresponding request.  If
+     'di' or 'da' is called without an argument when there is no current
+     diversion, a warning in category 'di' is produced.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.
+
+          Before the diversion.
+          .di yyy
+          In the diversion.
+          .br
+          .di
+          After the diversion.
+          .br
+              => After the diversion.
+          .yyy
+              => Before the diversion.  In the diversion.
+
+   GNU 'troff' supports "box" requests to exclude a partially collected
+line from a diversion, as this is often desirable.
+
+ -- Request: .box name
+ -- Request: .boxa name
+     Divert (or append) output to NAME, similarly to the 'di' and 'da'
+     requests, respectively.  Any pending output line is _not_ included
+     in the diversion.  Without an argument, stop diverting output; any
+     pending output line inside the diversion is discarded.
+
+          Before the box.
+          .box xxx
+          In the box.
+          .br
+          Hidden treasure.
+          .box
+          After the box.
+          .br
+              => Before the box.  After the box.
+          .xxx
+              => In the box.
+
+   Apart from pending output line inclusion and the request names that
+populate them, boxes are handled exactly as diversions are.  All of the
+following 'groff' language elements can be used with them
+interchangeably.
+
+ -- Register: \n.z
+ -- Register: \n.d
+     Diversions may be nested.  The read-only string-valued register
+     '.z' contains the name of the current diversion.  The read-only
+     register '.d' contains the current vertical place in the diversion.
+     If the input text is not being diverted, '.d' reports the same
+     location as the register 'nl'.
+
+ -- Register: \n.h
+     The read-only register '.h' stores the "high-water mark" on the
+     current page or in the current diversion.  It corresponds to the
+     text baseline of the lowest line on the page.(1)  (*note
+     Diversions-Footnote-1::)
+
+          .tm .h==\n.h, nl==\nnl
+              => .h==0, nl==-1
+          This is a test.
+          .br
+          .sp 2
+          .tm .h==\n.h, nl==\nnl
+              => .h==40, nl==120
+
+     As implied by the example, vertical motion does not produce text
+     baselines and thus does not increase the value interpolated by
+     '\n.h'.
+
+ -- Register: \ndn
+ -- Register: \ndl
+     After completing a diversion, the writable registers 'dn' and 'dl'
+     contain its vertical and horizontal sizes.  Only the lines just
+     processed are counted: for the computation of 'dn' and 'dl', the
+     requests 'da' and 'boxa' are handled as if 'di' and 'box' had been
+     used, respectively--lines that have been already stored in the
+     diversion (box) are not taken into account.
+
+          .\" Center text both horizontally and vertically.
+          .\" Macro .(c starts centering mode; .)c terminates it.
+          .
+          .\" Disable the escape character with .eo so that we
+          .\" don't have to double backslashes on the "\n"s.
+          .eo
+          .de (c
+          .  br
+          .  ev (c
+          .  evc 0
+          .  in 0
+          .  nf
+          .  di @c
+          ..
+          .de )c
+          .  br
+          .  ev
+          .  di
+          .  nr @s (((\n.tu - \ndnu) / 2u) - 1v)
+          .  sp \n@su
+          .  ce 1000
+          .  @c
+          .  ce 0
+          .  sp \n@su
+          .  br
+          .  fi
+          .  rr @s
+          .  rm @c
+          ..
+          .ec
+
+ -- Escape sequence: \!anything
+ -- Escape sequence: \?anything\?
+     "Transparently" embed ANYTHING into the current diversion,
+     preventing requests, macro calls, and escape sequences from being
+     interpreted when read into a diversion.  This is useful for
+     preventing them from taking effect until the diverted text is
+     actually output.  The '\!' escape sequence transparently embeds
+     input up to and including the end of the line.  The '\?' escape
+     sequence transparently embeds input until its own next occurrence.
+
+     ANYTHING may not contain newlines; use '\!' by itself to embed
+     newlines in a diversion.  The escape sequence '\?' is also
+     recognized in copy mode and turned into a single internal code; it
+     is this code that terminates ANYTHING.  Thus the following example
+     prints 4.
+
+          .nr x 1
+          .nf
+          .di d
+          \?\\?\\\\?\\\\\\\\nx\\\\?\\?\?
+          .di
+          .nr x 2
+          .di e
+          .d
+          .di
+          .nr x 3
+          .di f
+          .e
+          .di
+          .nr x 4
+          .f
+
+     Both escape sequences read the data in copy mode.
+
+     If '\!' is used in the top-level diversion, its argument is
+     directly embedded into GNU 'troff''s intermediate output.  This can
+     be used, for example, to control a postprocessor that processes the
+     data before it is sent to an output driver.
+
+     The '\?' escape used in the top-level diversion produces no output
+     at all; its argument is simply ignored.
+
+ -- Request: .output contents
+     Emit CONTENTS directly to GNU 'troff''s intermediate output
+     (subject to copy mode interpretation); this is similar to '\!' used
+     at the top level.  An initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces.
+
+     This request can't be used before the first page has started--if
+     you get an error, simply insert '.br' before the 'output' request.
+
+     Use with caution!  It is normally only needed for mark-up used by a
+     postprocessor that does something with the output before sending it
+     to the output device, filtering out CONTENTS again.
+
+ -- Request: .asciify div
+     "Unformat" the diversion DIV in a way such that Unicode basic Latin
+     (ASCII) characters, characters translated with the 'trin' request,
+     space characters, and some escape sequences, that were formatted
+     and diverted into DIV are treated like ordinary input characters
+     when DIV is reread.  Doing so can be useful in conjunction with the
+     'writem' request.  'asciify' can be also used for gross hacks; for
+     example, the following sets register 'n' to 1.
+
+          .tr @.
+          .di x
+          @nr n 1
+          .br
+          .di
+          .tr @@
+          .asciify x
+          .x
+
+     'asciify' cannot return all items in a diversion to their source
+     equivalent: nodes such as those produced by the '\N' escape
+     sequence will remain nodes, so the result cannot be guaranteed to
+     be a pure string.  *Note Copy Mode::.  Glyph parameters such as the
+     type face and size are not preserved; use 'unformat' to achieve
+     that.
+
+ -- Request: .unformat div
+     Like 'asciify', unformat the diversion DIV.  However, 'unformat'
+     handles only tabs and spaces between words, the latter usually
+     arising from spaces or newlines in the input.  Tabs are treated as
+     input tokens, and spaces become adjustable again.  The vertical
+     sizes of lines are not preserved, but glyph information (font, type
+     size, space width, and so on) is retained.
+
+&#x1f;
+File: groff.info,  Node: Diversions-Footnotes,  Up: Diversions
+
+   (1) Thus, the "water" gets "higher" proceeding _down_ the page.
+
+&#x1f;
+File: groff.info,  Node: Punning Names,  Next: Environments,  Prev: Diversions,  Up: GNU troff Reference
+
+5.30 Punning Names
+==================
+
+Macros, strings, and diversions share a name space; recall *note
+Identifiers::.  Internally, the same mechanism is used to store them.
+You can thus call a macro with string interpolation syntax and vice
+versa.
+
+     .de subject
+     Typesetting
+     ..
+     .de predicate
+     rewards attention to detail
+     ..
+     \*subject \*predicate.
+     Truly.
+         => Typesetting
+         =>  rewards attention to detail Truly.
+
+What went wrong?  Strings don't contain newlines, but macros do.  String
+interpolation placed a newline at the end of '\*subject', and the next
+thing on the input was a space.  Then when '\*predicate' was
+interpolated, it was followed by the empty request '.' on a line by
+itself.  If we want to use macros as strings, we must take interpolation
+behavior into account.
+
+     .de subject
+     Typesetting\\
+     ..
+     .de predicate
+     rewards attention to detail\\
+     ..
+     \*subject \*predicate.
+     Truly.
+         => Typesetting rewards attention to detail.  Truly.
+
+By ending each text line of the macros with an escaped '\<RET>', we get
+the desired effect (*note Line Continuation::).(1)  (*note Punning
+Names-Footnote-1::) What would have happened if we had used only one
+backslash at a time instead?
+
+   Interpolating a string does not hide existing macro arguments.  We
+can also place the escaped newline outside the string interpolation
+instead of within the string definition.  Thus, in a macro, a more
+efficient way of doing
+
+     .xx \\$@
+
+is
+
+     \\*xx\\
+
+The latter calling syntax doesn't change the value of '\$0', which is
+then inherited from the calling macro (*note Parameters::).
+
+   Diversions can be also called with string syntax.  It is sometimes
+convenient to copy one-line diversions to a string.
+
+     .di xx
+     the
+     .ft I
+     interpolation system
+     .ft
+     .br
+     .di
+     .ds yy This is a test of \*(xx\c
+     \*(yy.
+         => This is a test of the interpolation system.
+
+As the previous example shows, it is possible to store formatted output
+in strings.  The '\c' escape sequence prevents the subsequent newline
+from being interpreted as a break (again, *note Line Continuation::).
+
+   Copying multi-output line diversions produces unexpected results.
+
+     .di xxx
+     a funny
+     .br
+     test
+     .br
+     .di
+     .ds yyy This is \*xxx\c
+     \*yyy.
+         => test This is a funny.
+
+   Usually, it is not predictable whether a diversion contains one or
+more output lines, so this mechanism should be avoided.  With AT&T
+'troff', this was the only solution to strip off a final newline from a
+diversion.  Another disadvantage is that the spaces in the copied string
+are already formatted, preventing their adjustment.  This can cause ugly
+results.
+
+   A clean solution to this problem is available in GNU 'troff', using
+the requests 'chop' to remove the final newline of a diversion, and
+'unformat' to make the horizontal spaces adjustable again.
+
+     .box xxx
+     a funny
+     .br
+     test
+     .br
+     .box
+     .chop xxx
+     .unformat xxx
+     This is \*xxx.
+         => This is a funny test.
+
+   *Note Gtroff Internals::.
+
+&#x1f;
+File: groff.info,  Node: Punning Names-Footnotes,  Up: Punning Names
+
+   (1) The backslash is doubled.  *Note Copy Mode::.
+
+&#x1f;
+File: groff.info,  Node: Environments,  Next: Suppressing Output,  Prev: Diversions,  Up: GNU troff Reference
+
+5.31 Environments
+=================
+
+As discussed in *note Deferring Output::, environments store most of the
+parameters that determine the appearance of text.  A default environment
+named '0' exists when GNU 'troff' starts up; it is modified by
+formatting-related requests and escape sequences.
+
+   You can create new environments and switch among them.  Only one is
+current at any given time.  Active environments are managed using a
+"stack", a data structure supporting "push" and "pop" operations.  The
+current environment is at the top of the stack.  The same environment
+name can be pushed onto the stack multiple times, possibly interleaved
+with others.  Popping the environment stack does not destroy the current
+environment; it remains accessible by name and can be made current again
+by pushing it at any time.  Environments cannot be renamed or deleted,
+and can only be modified when current.  To inspect the environment
+stack, use the 'pev' request; see *note Debugging::.
+
+   Environments store the following information.
+
+   * a partially collected line, if any
+
+   * data about the most recently output glyph and line (registers
+     '.cdp', '.cht', '.csk', '.n', '.w')
+
+   * typeface parameters (size, family, style, height and slant,
+     inter-word and inter-sentence space sizes)
+
+   * page parameters (line length, title length, vertical spacing, line
+     spacing, indentation, line numbering, centering, right-alignment,
+     underlining, hyphenation parameters)
+
+   * filling enablement; adjustment enablement and mode
+
+   * tab stops; tab, leader, escape, control, no-break control,
+     hyphenation, and margin characters
+
+   * input line traps
+
+   * stroke and fill colors
+
+ -- Request: .ev ident
+ -- Register: \n.ev
+     Enter the environment IDENT, which is created if it does not
+     already exist, using the same parameters as for the default
+     environment used at startup.  With no argument, GNU 'troff'
+     switches to the previous environment.
+
+     Invoking 'ev' with an argument puts environment IDENT onto the top
+     of the environment stack.  (If it isn't already present in the
+     stack, this is a proper push.)  Without an argument, 'ev' pops the
+     environment stack, making the previous environment current.  It is
+     an error to pop the environment stack with no previous environment
+     available.  The read-only string-valued register '.ev' contains the
+     name of the current environment--the one at the top of the stack.
+
+          .ev footnote-env
+          .fam N
+          .ps 6
+          .vs 8
+          .ll -.5i
+          .ev
+
+          ...
+
+          .ev footnote-env
+          \dg Observe the smaller text and vertical spacing.
+          .ev
+
+     We can familiarize ourselves with stack behavior by wrapping the
+     'ev' request with a macro that reports the contents of the '.ev'
+     register to the standard error stream.
+
+          .de EV
+          .  ev \\$1
+          .  tm environment is now \\n.ev
+          ..
+          .
+          .EV foo
+          .EV bar
+          .EV
+          .EV baz
+          .EV
+          .EV
+          .EV
+
+              error-> environment is now foo
+              error-> environment is now bar
+              error-> environment is now foo
+              error-> environment is now baz
+              error-> environment is now foo
+              error-> environment is now 0
+              error-> error: environment stack underflow
+              error-> environment is now 0
+
+ -- Request: .evc environment
+     Copy the contents of ENVIRONMENT to the current environment.
+
+     The following environment data are not copied.
+
+        * a partially collected line, if present;
+
+        * the interruption status of the previous input line (due to use
+          of the '\c' escape sequence);
+
+        * the count of remaining lines to center, to right-justify, or
+          to underline (with or without underlined spaces)--these are
+          set to zero;
+
+        * the activation status of temporary indentation;
+
+        * input line traps and their associated data;
+
+        * the activation status of line numbering (which can be
+          reactivated with '.nm +0'); and
+
+        * the count of consecutive hyphenated lines (set to zero).
+
+ -- Register: \n.w
+ -- Register: \n.cht
+ -- Register: \n.cdp
+ -- Register: \n.csk
+     The '\n.w' register contains the width of the last glyph
+     formatted in the environment.
+
+     The '\n.cht' register contains the height of the last glyph
+     formatted in the environment.
+
+     The '\n.cdp' register contains the depth of the last glyph
+     formatted in the environment.  It is positive for glyphs extending
+     below the baseline.
+
+     The '\n.csk' register contains the "skew" (how far to the right
+     of the glyph's center that GNU 'troff' should place an accent) of
+     the last glyph formatted in the environment.
+
+ -- Register: \n.n
+     The '\n.n' register contains the length of the previous output
+     line emitted in the environment.
+
+&#x1f;
+File: groff.info,  Node: Suppressing Output,  Next: Colors,  Prev: Environments,  Up: GNU troff Reference
+
+5.32 Suppressing Output
+=======================
+
+ -- Escape sequence: \Onum
+     Suppress GNU 'troff' output of glyphs and geometric objects.  The
+     sequences '\O2', '\O3', '\O4', and '\O5' are intended for internal
+     use by 'grohtml'.
+
+     '\O0'
+          Disable the emission of glyphs and geometric objects to the
+          output driver, provided that this sequence occurs at the
+          outermost suppression level (see '\O3' and '\04' below).
+          Horizontal motions corresponding to non-overstruck glyph
+          widths still occur.
+
+     '\O1'
+          Enable the emission of glyphs and geometric objects to the
+          output driver, provided that this sequence occurs at the
+          outermost suppression level.
+
+     '\O0' and '\O1' also reset the four registers 'opminx', 'opminy',
+     'opmaxx', and 'opmaxy' to -1.  These four registers mark the top
+     left and bottom right hand corners of a box encompassing all
+     written or drawn output.
+
+     '\O2'
+          At the outermost suppression level, enable emission of glyphs
+          and geometric objects, and write to the standard error stream
+          the page number and values of the four aforementioned
+          registers encompassing glyphs written since the last
+          interpolation of a '\O' sequence, as well as the page offset,
+          line length, image file name (if any), horizontal and vertical
+          device motion quanta, and input file name.  Numeric values are
+          in basic units.
+
+     '\O3'
+          Begin a nested suppression level.  'grohtml' uses this
+          mechanism to create images of output preprocessed with 'gpic',
+          'geqn', and 'gtbl'.  At startup, GNU 'troff' is at the
+          outermost suppression level.  'pre-grohtml' generates these
+          sequences when processing the document, using GNU 'troff' with
+          the 'ps' output device, Ghostscript, and the PNM tools to
+          produce images in PNG format.  They start a new page if the
+          device is not 'html' or 'xhtml', to reduce the number of
+          images crossing a page boundary.
+
+     '\O4'
+          End a nested suppression level.
+
+     '\O5PFILE'
+          At the outermost suppression level, write the name 'file' to
+          the standard error stream at position P, which must be one of
+          'l', 'r', 'c', or 'i', corresponding to left, right, centered,
+          and inline alignments within the document, respectively.  FILE
+          is a name associated with the production of the next image.
+
+ -- Register: \n.O
+     Output suppression nesting level applied by '\O3' and '\O4' escape
+     sequences.
+
+&#x1f;
+File: groff.info,  Node: I/O,  Next: Postprocessor Access,  Prev: Suppressing Output,  Up: GNU troff Reference
+
+5.33 I/O
+========
+
+'gtroff' has several requests for including files:
+
+ -- Request: .so file
+ -- Request: .soquiet file
+     Replace the 'so' request's control line with the contents of the
+     file named by the argument, "sourcing" it.  FILE is sought in the
+     directories specified by '-I' command-line option.  If FILE does
+     not exist, a warning in category 'file' is produced and the request
+     has no further effect.  *Note Warnings::, for information about the
+     enablement and suppression of warnings.
+
+     'so' can be useful for large documents; e.g., allowing each chapter
+     of a book to be kept in a separate file.  However, files
+     interpolated with 'so' are not preprocessed; to overcome this
+     limitation, see the 'gsoelim(1)' man page.
+
+     Since GNU 'troff' replaces the entire control line with the
+     contents of a file, it matters whether 'file' is terminated with a
+     newline or not.  Assume that file 'xxx' contains only the word
+     'foo' without a trailing newline.
+
+          $ printf 'foo' > xxx
+
+          The situation is
+          .so xxx
+          bar.
+              => The situation is foobar.
+
+     'soquiet' works the same way, except that no warning diagnostic is
+     issued if FILE does not exist.
+
+ -- Request: .pso command
+     Read the standard output from the specified COMMAND and include it
+     in place of the 'pso' request.
+
+     It is an error to use this request in safer mode, which is the
+     default.  Invoke GNU 'troff' or a front end with the '-U' option to
+     enable unsafe mode.
+
+     The comment regarding a final newline for the 'so' request is valid
+     for 'pso' also.
+
+ -- Request: .mso file
+ -- Request: .msoquiet file
+     Identical to the 'so' and 'soquiet' requests, respectively, except
+     that 'gtroff' searches for the specified FILE in the same
+     directories as macro files for the '-m' command-line option.  If
+     the file name to be included has the form 'NAME.tmac' and it isn't
+     found, these requests try to include 'tmac.NAME' and vice versa.
+
+ -- Request: .trf file
+ -- Request: .cf file
+     Transparently output the contents of FILE.  Each line is output as
+     if it were preceded by '\!'; however, the lines are _not_ subject
+     to copy mode interpretation.  If the file does not end with a
+     newline, 'trf' adds one.  Both requests cause a break.
+
+     When used in a diversion, these requests embed a node (*note Gtroff
+     Internals::) in it that, when reread, causes the contents of FILE
+     to be transparently copied to the output.  In AT&T 'troff', the
+     contents of FILE are immediately copied to the output regardless of
+     whether there is a current diversion; this behaviour is so
+     anomalous that it must be considered a bug.
+
+     While 'cf' copies the contents of FILE completely unprocessed,
+     'trf' disallows characters such as NUL that are not valid 'gtroff'
+     input characters (*note Identifiers::).
+
+     For 'cf', within a diversion, "completely unprocessed" means that
+     each line of a file to be inserted is handled as if it were
+     preceded by '\!\\!'.
+
+     To define a macro 'x' containing the contents of file 'f', use
+
+          .ev 1
+          .di x
+          .trf f
+          .di
+          .ev
+
+     The calls to 'ev' prevent the partially collected output line from
+     becoming part of the diversion (*note Diversions::).
+
+ -- Request: .nx file
+     Force 'gtroff' to continue processing of the file specified as an
+     argument.  If no argument is given, immediately jump to the end of
+     file.
+
+ -- Request: .rd prompt arg1 arg2 ...
+     Read from standard input, and include what is read as though it
+     were part of the input file.  Text is read until a blank line is
+     encountered.
+
+     If standard input is a TTY input device (keyboard), write PROMPT to
+     standard error, followed by a colon (or send BEL for a beep if no
+     argument is given).
+
+     Arguments after PROMPT are available for the input.  For example,
+     the line
+
+          .rd data foo bar
+
+     with the input 'This is \$2.' prints
+
+          This is bar.
+
+   Using the 'nx' and 'rd' requests, it is easy to set up form letters.
+The form letter template is constructed like this, putting the following
+lines into a file called 'repeat.let':
+
+     .ce
+     \*(td
+     .sp 2
+     .nf
+     .rd
+     .sp
+     .rd
+     .fi
+     Body of letter.
+     .bp
+     .nx repeat.let
+
+When this is run, a file containing the following lines should be
+redirected in.  Requests included in this file are executed as though
+they were part of the form letter.  The last block of input is the 'ex'
+request, which tells GNU 'troff' to stop processing.  If this were not
+there, 'troff' would not know when to stop.
+
+     Trent A. Fisher
+     708 NW 19th Av., #202
+     Portland, OR  97209
+
+     Dear Trent,
+
+     Len Adollar
+     4315 Sierra Vista
+     San Diego, CA  92103
+
+     Dear Mr. Adollar,
+
+     .ex
+
+ -- Request: .pi pipe
+     Pipe the output of 'gtroff' to the shell command(s) specified by
+     PIPE.  This request must occur before 'gtroff' has a chance to
+     print anything.
+
+     It is an error to use this request in safer mode, which is the
+     default.  Invoke GNU 'troff' or a front end with the '-U' option to
+     enable unsafe mode.
+
+     Multiple calls to 'pi' are allowed, acting as a chain.  For
+     example,
+
+          .pi foo
+          .pi bar
+          ...
+
+     is the same as '.pi foo | bar'.
+
+     The intermediate output format of GNU 'troff' is piped to the
+     specified commands.  Consequently, calling 'groff' without the '-Z'
+     option normally causes a fatal error.
+
+ -- Request: .sy cmds
+ -- Register: \nsystat
+     Execute the shell command(s) specified by CMDS.  The output is not
+     saved anywhere, so it is up to the user to do so.
+
+     It is an error to use this request in safer mode; this is the
+     default.  Give GNU 'troff' or a front end program the '-U' option
+     to enable unsafe mode.
+
+     The following code fragment introduces the current time into a
+     document.
+
+          .sy perl -e 'printf ".nr H %d\\n.nr M %d\\n.nr S %d\\n",\
+                       (localtime(time))2,1,0' > /tmp/x\n$$
+          .so /tmp/x\n$$
+          .sy rm /tmp/x\n$$
+          \nH:\nM:\nS
+
+     This works by having the Perl script (run by 'sy') write 'nr'
+     requests that set the registers 'H', 'M', and 'S' to a temporary
+     file.  The 'roff' document then reads the temporary file using the
+     'so' request.
+
+     The registers 'seconds', 'minutes', and 'hours', initialized at
+     startup of GNU 'troff', should satisfy most requirements.  Use the
+     'af' request to format their values for output.
+
+          .af hours 00
+          .af minutes 00
+          .af seconds 00
+          \nhours:\nminutes:\nseconds
+              => 02:17:54
+
+     The writable register 'systat' contains the return value of the
+     'system()' function executed by the last 'sy' request.
+
+ -- Request: .open stream file
+ -- Request: .opena stream file
+     Open the specified FILE for writing and associates the specified
+     STREAM with it.
+
+     The 'opena' request is like 'open', but if the file exists, append
+     to it instead of truncating it.
+
+     It is an error to use these requests in safer mode; this is the
+     default.  Give GNU 'troff' or a front end program the '-U' option
+     to enable unsafe mode.
+
+ -- Request: .write stream data
+ -- Request: .writec stream data
+     Write to the file associated with the specified STREAM.  The stream
+     must previously have been the subject of an open request.  The
+     remainder of the line is interpreted as the 'ds' request reads its
+     second argument: an initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces, and it is read in
+     copy mode.
+
+     The 'writec' request is like 'write', but only 'write' appends a
+     newline to the data.
+
+ -- Request: .writem stream xx
+     Write the contents of the macro or string XX to the file associated
+     with the specified STREAM.
+
+     XX is read in copy mode, i.e., already formatted elements are
+     ignored.  Consequently, diversions must be unformatted with the
+     'asciify' request before calling 'writem'.  Usually, this means a
+     loss of information.
+
+ -- Request: .close stream
+     Close the specified STREAM; the stream is no longer an acceptable
+     argument to the 'write' request.
+
+     Here a simple macro to write an index entry.
+
+          .open idx test.idx
+          .
+          .de IX
+          .  write idx \\n% \\$*
+          ..
+          .
+          .IX test entry
+          .
+          .close idx
+
+ -- Escape sequence: \Ve
+ -- Escape sequence: \V(ev
+ -- Escape sequence: \Venv
+     Interpolate the contents of the specified environment variable ENV
+     (one-character name E, two-character name EV) as returned by the
+     function 'getenv(3)'.  '\V' is interpreted even in copy mode (*note
+     Copy Mode::).
+
+&#x1f;
+File: groff.info,  Node: Postprocessor Access,  Next: Miscellaneous,  Prev: I/O,  Up: GNU troff Reference
+
+5.34 Postprocessor Access
+=========================
+
+Two escape sequences and two requests enable documents to pass
+information directly to a postprocessor.  These are useful for
+exercising device-specific capabilities that the 'groff' language does
+not abstract or generalize; examples include the embedding of hyperlinks
+and image files.  Device-specific functions are documented in each
+output driver's man page, such as 'gropdf(1)', 'grops(1)', or
+'grotty(1)'.
+
+ -- Request: .device xxx ...
+ -- Escape sequence: \X'xxx ...'
+     Embed all XXX arguments into GNU 'troff' output as parameters to a
+     device control command 'x X'.  The meaning and interpretation of
+     such parameters is determined by the output driver or other
+     postprocessor.
+
+     The 'device' request processes its arguments in copy mode (*note
+     Copy Mode::).  An initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces.  By contrast, within
+     '\X' arguments, the escape sequences '\&', '\)', '\%', and '\:' are
+     ignored; '\<SP>' and '\~' are converted to single space characters;
+     and '\\' has its escape character stripped.  So that the basic
+     Latin subset of the Unicode character set(1) (*note Postprocessor
+     Access-Footnote-1::) can be reliably encoded in device control
+     commands, seven special character escape sequences ('\-', '\aq',
+     '\dq', '\ga', '\ha', '\rs', and '\ti',) are mapped to
+     basic Latin characters; see the 'groff_char(7)' man page.  For this
+     transformation, character translations and special character
+     definitions are ignored.(2)  (*note Postprocessor
+     Access-Footnote-2::) The use of any other escape sequence in '\X'
+     parameters is normally an error.
+
+     If the 'use_charnames_in_special' directive appears in the output
+     device's 'DESC' file, the use of special character escape sequences
+     is _not_ an error; they are simply output verbatim (with the
+     exception of the seven mapped to Unicode basic Latin characters,
+     discussed above).  'use_charnames_in_special' is currently employed
+     only by 'grohtml'.
+
+ -- Request: .devicem name
+ -- Escape sequence: \Yn
+ -- Escape sequence: \Y(nm
+ -- Escape sequence: \Yname
+     This is approximately equivalent to '\X'\*NAME'' (one-character
+     name N, two-character name NM).  However, the contents of the
+     string or macro NAME are not interpreted; also it is permitted for
+     NAME to have been defined as a macro and thus contain newlines (it
+     is not permitted for the argument to '\X' to contain newlines).
+     The inclusion of newlines requires an extension to the AT&T 'troff'
+     output format, and confuses drivers that do not know about this
+     extension (*note Device Control Commands::).
+
+ -- Request: .tag name
+ -- Request: .taga name
+     Reserved for internal use.
+
+&#x1f;
+File: groff.info,  Node: Postprocessor Access-Footnotes,  Up: Postprocessor Access
+
+   (1) that is, ISO 646:1991-IRV or, popularly, "US-ASCII"
+
+   (2) They are bypassed because these parameters are not rendered as
+glyphs in the output; instead, they remain abstract characters--in a PDF
+bookmark or a URL, for example.
+
+&#x1f;
+File: groff.info,  Node: Miscellaneous,  Next: Gtroff Internals,  Prev: Postprocessor Access,  Up: GNU troff Reference
+
+5.35 Miscellaneous
+==================
+
+We document here GNU 'troff' features that fit poorly elsewhere.
+
+ -- Request: .nm start increment space indentation
+ -- Register: \nln
+ -- Register: \n.nm
+     Begin (or, with no arguments, cease) numbering output lines.  START
+     assigns the number of the _next_ output line.  Only line numbers
+     divisible by INCREMENT are marked (default: '1').  SPACE configures
+     the horizontal spacing between the number and the text (default:
+     '1').  Any given INDENTATION is applied to the numbers (default:
+     '0').  The third and fourth arguments are reckoned in numeral
+     widths ('\0').  START must be non-negative and INCREMENT positive.
+
+     The formatter aligns the number to the right in a width of three
+     numeral spaces plus INDENTATION, then catenates SPACE and the
+     output line.  The line length is _not_ reduced.  Depending on the
+     value of the page offset,(1) (*note Miscellaneous-Footnote-1::)
+     numbers wider than the allocated space protrude into the left
+     margin, or shift the output line to the right.
+
+     Line numbering parameters corresponding to missing arguments are
+     not altered.  After numbering is disabled, '.nm +0' resumes it
+     using the previously active parameters.
+
+     The parameters of 'nm' are associated with the environment (*note
+     Environments::).
+
+     While numbering is enabled, the output line number register 'ln' is
+     updated as each line is output, even if no line number is formatted
+     with it because it is being skipped (it is not a multiple of
+     INCREMENT) or because numbering is suppressed (see the 'nn' request
+     below).
+
+     The '.nm' register tracks the enablement status of numbering.
+     Temporary suspension of numbering with the 'nn' request does _not_
+     alter its value.
+
+          .po 5n
+          .ll 44n
+          Programming,
+          when stripped of all its circumstantial irrelevancies,
+          .nm 999 1 1 -4
+          boils down to no more and no less than
+          .nm +0 3
+          very effective thinking so as to avoid unmastered
+          .nn 2
+          complexity,
+          to very vigorous separation of your many
+          different concerns.
+          .br
+          \(em Edsger Dijkstra
+          .sp
+          .nm 1 1 1
+          This guy's arrogance takes your breath away.
+          .br
+          \(em John Backus
+              =>      Programming,  when  stripped of all its cir-
+              =>  999 cumstantial irrelevancies, boils down to  no
+              =>      more  and no less than very effective think-
+              =>      ing so as to avoid unmastered complexity, to
+              =>      very vigorous separation of your  many  dif-
+              =>      ferent concerns.
+              => 1002 -- Edsger Dijkstra
+              =>
+              =>    1 This guy's arrogance takes your breath away.
+              =>    2 -- John Backus
+
+ -- Request: .nn skip
+ -- Register: \n.nn
+     Suppress numbering of the next SKIP output lines that would
+     otherwise be numbered.  The default is 1.  'nn' can be invoked when
+     line numbering is not active; suppression of numbering will take
+     effect for SKIP lines once 'nm' enables it.
+
+     The '.nn' register stores the count of output lines still to have
+     their numbering suppressed.
+
+     This count is associated with the environment (*note
+     Environments::).
+
+   To test whether the current output line will be numbered, you must
+check both the '.nm' and '.nn' registers.
+
+       .de is-numbered
+       .  nop This line
+       .  ie (\\n.nm & (1-\\n.nn)) IS
+       .  el                           ISN'T
+       .  nop numbered.
+       .  br
+       ..
+       Test line numbering.
+       .is-numbered
+       .nm 1
+       .nn 1
+       .is-numbered
+       .is-numbered
+       .nm
+       .is-numbered
+         => Test line numbering.  This line ISN'T numbered.
+         => This line ISN'T numbered.
+         =>   1 This line IS numbered.
+         => This line ISN'T numbered.
+
+ -- Request: .mc margin-character distance
+     Begin (or, with no arguments, cease) writing a "margin-character"
+     to the right of each output line.  The DISTANCE argument separates
+     MARGIN-CHARACTER from the right margin.  If absent, the most recent
+     value is used; the default is 10 points.  If an output line exceeds
+     the line length, the margin character is appended to it.  No margin
+     character is written on lines produced by the 'tl' request.
+
+     The margin character is a property of the output line; the margin
+     character last configured when the line is output controls.  If the
+     margin character is disabled before an output line breaks, none is
+     output (but see below).
+
+     The margin character is associated with the environment (*note
+     Environments::).
+
+          .ll 5i
+          .nf
+          .mc \br
+          This paragraph is marked with a margin character.
+          .sp
+          As seen above, vertical space isn't thus marked.
+          \&
+          An output line that is present, but empty, is.
+              => This paragraph is marked with a margin character.  |
+              =>
+              => As seen above, vertical space isn't thus marked.   |
+              =>                                                    |
+              => An output line that is present, but empty, is.     |
+
+   For compatibility with AT&T 'troff', a call to 'mc' to set the margin
+character can't be undone immediately; at least one line gets a margin
+character.
+
+     .ll 10n
+     .nf
+     .mc |
+     .mc *
+     .mc
+     foo
+     bar
+         => foo        *
+         => bar
+
+   The margin character mechanism is commonly used to annotate changes
+in documents.  The 'groff' distribution ships a program, 'gdiffmk', to
+assist with this task.(2)  (*note Miscellaneous-Footnote-2::)
+
+ -- Request: .psbb file
+ -- Register: \nllx
+ -- Register: \nlly
+ -- Register: \nurx
+ -- Register: \nury
+     Retrieve the bounding box of the PostScript image found in FILE,
+     which must conform to Adobe's "Document Structuring Conventions"
+     (DSC), locate a '%%BoundingBox' comment, and store the (upper-,
+     lower-, -left, -right) values into the registers 'llx', 'lly',
+     'urx', and 'ury'.  If an error occurs (for example, if no
+     '%%BoundingBox' comment is present), the formatter sets these
+     registers to 0.
+
+     The search path for FILE can be controlled with the '-I'
+     command-line option.
+
+&#x1f;
+File: groff.info,  Node: Miscellaneous-Footnotes,  Up: Miscellaneous
+
+   (1) Recall *note Line Layout::.
+
+   (2) Historically, tools named 'nrchbar' and 'changebar' were
+developed for marking changes with margin characters and could be found
+in archives of the 'comp.sources.unix' USENET group.  Some proprietary
+Unices also offer(ed) a 'diffmk' program.
+
+&#x1f;
+File: groff.info,  Node: Gtroff Internals,  Next: Debugging,  Prev: Miscellaneous,  Up: GNU troff Reference
+
+5.36 'gtroff' Internals
+=======================
+
+'gtroff' processes input in three steps.  One or more input characters
+are converted to an "input token".(1)  (*note Gtroff
+Internals-Footnote-1::) Then, one or more input tokens are converted to
+an "output node".  Finally, output nodes are converted to the
+intermediate output language understood by all output devices.
+
+   Actually, before step one happens, 'gtroff' converts certain escape
+sequences into reserved input characters (not accessible by the user);
+such reserved characters are used for other internal processing also -
+this is the very reason why not all characters are valid input.  *Note
+Identifiers::, for more on this topic.
+
+   For example, the input string 'fi\:u' is converted into a character
+token 'f', a character token 'i', and a special token ':u' (representing
+u umlaut).  Later on, the character tokens 'f' and 'i' are merged to a
+single output node representing the ligature glyph 'fi' (provided the
+current font has a glyph for this ligature); the same happens with ':u'.
+All output glyph nodes are 'processed', which means that they are
+invariably associated with a given font, font size, advance width, etc.
+During the formatting process, 'gtroff' itself adds various nodes to
+control the data flow.
+
+   Macros, diversions, and strings collect elements in two chained
+lists: a list of input tokens that have been passed unprocessed, and a
+list of output nodes.  Consider the following diversion.
+
+     .di xxx
+     a
+     \!b
+     c
+     .br
+     .di
+
+It contains these elements.
+
+node list            token list   element number
+                                  
+line start node      --           1
+glyph node 'a'       --           2
+word space node      --           3
+--                   'b'          4
+--                   '\n'         5
+glyph node 'c'       --           6
+vertical size node   --           7
+vertical size node   --           8
+--                   '\n'         9
+
+Elements 1, 7, and 8 are inserted by 'gtroff'; the latter two (which are
+always present) specify the vertical extent of the last line, possibly
+modified by '\x'.  The 'br' request finishes the pending output line,
+inserting a newline input token, which is subsequently converted to a
+space when the diversion is reread.  Note that the word space node has a
+fixed width that isn't adjustable anymore.  To convert horizontal space
+nodes back to input tokens, use the 'unformat' request.
+
+   Macros only contain elements in the token list (and the node list is
+empty); diversions and strings can contain elements in both lists.
+
+   The 'chop' request simply reduces the number of elements in a macro,
+string, or diversion by one.  Exceptions are "compatibility save" and
+"compatibility ignore" input tokens, which are ignored.  The 'substring'
+request also ignores those input tokens.
+
+   Some requests like 'tr' or 'cflags' work on glyph identifiers only;
+this means that the associated glyph can be changed without destroying
+this association.  This can be very helpful for substituting glyphs.  In
+the following example, we assume that glyph 'foo' isn't available by
+default, so we provide a substitution using the 'fchar' request and map
+it to input character 'x'.
+
+     .fchar \foo foo
+     .tr x \foo
+
+Now let us assume that we install an additional special font 'bar' that
+has glyph 'foo'.
+
+     .special bar
+     .rchar \foo
+
+Since glyphs defined with 'fchar' are searched before glyphs in special
+fonts, we must call 'rchar' to remove the definition of the fallback
+glyph.  Anyway, the translation is still active; 'x' now maps to the
+real glyph 'foo'.
+
+   Macro and request arguments preserve compatibility mode enablement.
+
+     .cp 1     \" switch to compatibility mode
+     .de xx
+     \\$1
+     ..
+     .cp 0     \" switch compatibility mode off
+     .xx caf\'e
+         => café
+
+Since compatibility mode is enabled while 'de' is invoked, the macro
+'xx' enables compatibility mode when it is called.  Argument '$1' can
+still be handled properly because it inherits the compatibility mode
+enablement status that was active at the point where 'xx' was called.
+
+   After interpolation of the parameters, the compatibility save and
+restore tokens are removed.
+
+&#x1f;
+File: groff.info,  Node: Gtroff Internals-Footnotes,  Up: Gtroff Internals
+
+   (1) Except the escape sequences '\f', '\F', '\H', '\m', '\M', '\R',
+'\s', and '\S', which are processed immediately if not in copy mode.
+
+&#x1f;
+File: groff.info,  Node: Debugging,  Next: Implementation Differences,  Prev: Gtroff Internals,  Up: GNU troff Reference
+
+5.37 Debugging
+==============
+
+          Standard troff voodoo, just put a power of two backslashes in
+    front of it until it works and if you still have problems add a \c.
+                                                         -- Ron Natalie
+
+   GNU 'troff' is not the easiest language to debug, in part thanks to
+its design features of recursive interpolation and the use of
+multi-stage pipeline processing in the surrounding system.  Nevertheless
+there exist several features useful for troubleshooting.
+
+   Preprocessors use the 'lf' request to preserve the identity of the
+line numbers and names of input files.  GNU 'troff' emits a variety of
+error diagnostics and supports several categories of warning; the output
+of these can be selectively suppressed.  A trace of the formatter's
+input processing stack can be emitted when errors or warnings occur by
+means of GNU 'troff''s '-b' option, or produced on demand with the
+'backtrace' request.  The 'tm' and related requests can be used to emit
+customized diagnostic messages or for instrumentation while
+troubleshooting.  The 'ex' and 'ab' requests cause early termination
+with successful and error exit codes respectively, to halt further
+processing when continuing would be fruitless.  Examine the state of the
+formatter with requests that write lists of defined names (macros,
+strings, and diversions), environments, registers, and page location
+traps to the standard error stream.
+
+ -- Request: .lf line file
+     Set the input line number (and, optionally, the file name) GNU
+     'troff' shall use for error and warning messages.  LINE is the
+     input line number of the _next_ line.  Without an argument, the
+     request is ignored.
+
+     'lf''s primary purpose is to aid the debugging of documents that
+     undergo preprocessing.  Programs like 'tbl' that transform input in
+     their own languages into 'roff' requests use it so that any
+     diagnostic messages emitted by 'troff' correspond to the source
+     document.
+
+ -- Request: .tm message
+ -- Request: .tm1 message
+ -- Request: .tmc message
+     Send MESSAGE, which consumes the remainder of the input line and
+     cannot contain special characters, to the standard error stream,
+     followed by a newline.  Leading spaces in MESSAGE are ignored.
+
+     'tm1' is similar, but recognizes and strips a leading neutral
+     double quote from MESSAGE to allow the embedding of leading spaces.
+
+     'tmc' works as 'tm1', but does not append a newline.
+
+ -- Request: .ab message
+     Write any MESSAGE to the standard error stream (like 'tm') and then
+     abort GNU 'troff'; that is, stop processing and terminate with a
+     failure status.
+
+ -- Request: .ex
+     Exit GNU 'troff'; that is, stop processing and terminate with a
+     successful status.  To stop processing only the current file, use
+     the 'nx' request; see *note I/O::.
+
+   When doing something involved, it is useful to leave the debugging
+statements in the code and have them turned on by a command-line flag.
+
+     .if \nDB .tm debugging output
+
+To activate such statements, use the '-r' option to set the register.
+
+     groff -rDB=1 file
+
+   If it is known in advance that there are many errors and no useful
+output, GNU 'troff' can be forced to suppress formatted output with the
+'-z' option.
+
+ -- Request: .pev
+     Report the state of the current environment followed by that of all
+     other environments to the standard error stream.
+
+ -- Request: .pm
+     Report, to the standard error stream, the names of all defined
+     macros, strings, and diversions with their sizes in bytes.
+
+ -- Request: .pnr
+     Report the names and contents of all currently defined registers to
+     the standard error stream.
+
+ -- Request: .ptr
+     Report the names and positions of all page location traps to the
+     standard error stream.  Empty slots in the list, where a trap has
+     been planted but subsequently (re)moved, are printed as well.
+
+ -- Request: .fl
+     Instruct 'gtroff' to flush its output immediately.  The intent is
+     for interactive use, but this behaviour is currently not
+     implemented in 'gtroff'.  Contrary to Unix 'troff', TTY output is
+     sent to a device driver also ('grotty'), making it non-trivial to
+     communicate interactively.
+
+     This request causes a line break.
+
+ -- Request: .backtrace
+     Write the state of the input stack to the standard error stream.
+
+     Consider the following in a file 'test'.
+
+          .de xxx
+          .  backtrace
+          ..
+          .de yyy
+          .  xxx
+          ..
+          .
+          .yyy
+              error-> troff: backtrace: 'test':2: macro 'xxx'
+              error-> troff: backtrace: 'test':5: macro 'yyy'
+              error-> troff: backtrace: file 'test':8
+
+     The '-b' option of GNU 'troff' causes a backtrace to be generated
+     on each error or warning.  Some warnings have to be enabled; *Note
+     Warnings::.
+
+ -- Register: \nslimit
+     If greater than 0, sets the maximum quantity of objects on GNU
+     'troff''s internal input stack.  If less than or equal to 0, there
+     is no limit: recursion can continue until program memory is
+     exhausted.  The default is 1,000.
+
+ -- Request: .warnscale su
+     Set the scaling unit used in certain warnings to SU, which can take
+     the values 'u', 'i', 'c', 'p', and 'P'.  The default is 'i'.
+
+ -- Request: .spreadwarn limit
+     Emit a 'break' warning if the additional space inserted for each
+     space between words in an output line adjusted to both margins with
+     '.ad b' is larger than or equal to LIMIT.  A negative value is
+     treated as zero; an absent argument toggles the warning on and off
+     without changing LIMIT.  The default scaling unit is 'm'.  At
+     startup, 'spreadwarn' is inactive and LIMIT is 3m.
+
+     For example,
+
+          .spreadwarn 0.2m
+
+     causes a warning if 'break' warnings are not suppressed and
+     'gtroff' must add 0.2m or more for each inter-word space in a line.
+     *Note Warnings::.
+
+   GNU 'troff' has command-line options for reporting warnings ('-w')
+and backtraces ('-b') when a warning or an error occurs.
+
+ -- Request: .warn n
+ -- Register: \n.warn
+     Select the categories, or "types", of reported warnings.  N is the
+     sum of the numeric codes associated with each warning category that
+     is to be enabled; all other categories are disabled.  The
+     categories and their associated codes are listed in *note
+     Warnings::.  For example, '.warn 0' disables all warnings, and
+     '.warn 1' disables all warnings except those about missing glyphs.
+     If no argument is given, all warning categories are enabled.
+
+     The read-only register '.warn' contains the sum of the numeric
+     codes of enabled warning categories.
+
+* Menu:
+
+* Warnings::
+
+&#x1f;
+File: groff.info,  Node: Warnings,  Prev: Debugging,  Up: Debugging
+
+5.37.1 Warnings
+---------------
+
+Warning diagnostics emitted by GNU 'troff' are divided into named,
+numbered categories.  The name associated with each warning category is
+used by the '-w' and '-W' options.  Each category is also assigned a
+power of two; the sum of enabled category values is used by the 'warn'
+request and the '.warn' register.
+
+   Warnings of each category are produced under the following
+circumstances.
+
+'char'
+'1'
+     No mounted font defines a glyph for the requested character.  This
+     category is enabled by default.
+
+'number'
+'2'
+     An invalid numeric expression was encountered.  This category is
+     enabled by default.  *Note Numeric Expressions::.
+
+'break'
+'4'
+     A filled output line could not be broken such that its length was
+     less than the output line length '\n.l'.  This category is
+     enabled by default.
+
+'delim'
+'8'
+     The closing delimiter in an escape sequence was missing or
+     mismatched.
+
+'el'
+'16'
+     The 'el' request was encountered with no prior corresponding 'ie'
+     request.  *Note if-else::.
+
+'scale'
+'32'
+     A scaling unit inappropriate to its context was used in a numeric
+     expression.
+
+'range'
+'64'
+     A numeric expression was out of range for its context.
+
+'syntax'
+'128'
+     A self-contradictory hyphenation mode was requested; an empty or
+     incomplete numeric expression was encountered; an operand to a
+     numeric operator was missing; an attempt was made to define a
+     recursive, empty, or nonsensical character class; or a 'groff'
+     extension conditional expression operator was used while in
+     compatibility mode.
+
+'di'
+'256'
+     A 'di', 'da', 'box', or 'boxa' request was invoked without an
+     argument when there was no current diversion.
+
+'mac'
+'512'
+     An undefined string, macro, or diversion was used.  When such an
+     object is dereferenced, an empty one of that name is automatically
+     created.  So, unless it is later deleted, at most one warning is
+     given for each.
+
+     This warning is also emitted upon an attempt to move an unplanted
+     trap macro (*note Page Location Traps::).  In such cases, the
+     unplanted macro is _not_ dereferenced, so it is not created if it
+     does not exist.
+
+'reg'
+'1024'
+     An undefined register was used.  When an undefined register is
+     dereferenced, it is automatically defined with a value of 0.  So,
+     unless it is later deleted, at most one warning is given for each.
+
+'tab'
+'2048'
+     A tab character was encountered where a number was expected, or
+     appeared in an unquoted macro argument.
+
+'right-brace'
+'4096'
+     A right brace escape sequence '\}' was encountered where a number
+     was expected.
+
+'missing'
+'8192'
+     A request was invoked with a mandatory argument absent.
+
+'input'
+'16384'
+     An invalid character occurred on the input stream.
+
+'escape'
+'32768'
+     An unsupported escape sequence was encountered.
+
+'space'
+'65536'
+     A space was missing between a request or macro and its argument.
+     This warning is produced when an undefined name longer than two
+     characters is encountered and the first two characters of the name
+     constitute a defined name.  No request is invoked, no macro called,
+     and an empty macro is not defined.  This category is enabled by
+     default.  It never occurs in compatibility mode.
+
+'font'
+'131072'
+     A non-existent font was selected, or the selection was ignored
+     because a font selection escape sequence was used after the output
+     line continuation escape sequence on an input line.  This category
+     is enabled by default.
+
+'ig'
+'262144'
+     An invalid escape sequence occurred in input ignored using the 'ig'
+     request.  This warning category diagnoses a condition that is an
+     error when it occurs in non-ignored input.
+
+'color'
+'524288'
+     An undefined color was selected, an attempt was made to define a
+     color using an unrecognized color space, an invalid component in a
+     color definition was encountered, or an attempt was made to
+     redefine a default color.
+
+'file'
+'1048576'
+     An attempt was made to load a file that does not exist.  This
+     category is enabled by default.
+
+   Two warning names group other warning categories for convenience.
+
+'all'
+     All warning categories except 'di', 'mac' and 'reg'.  This
+     shorthand is intended to produce all warnings that are useful with
+     macro packages written for AT&T 'troff' and its descendants, which
+     have less fastidious diagnostics than GNU 'troff'.
+
+'w'
+     All warning categories.  Authors of documents and macro packages
+     targeting 'groff' are encouraged to use this setting.
+
+&#x1f;
+File: groff.info,  Node: Implementation Differences,  Next: Safer Mode,  Prev: Debugging,  Up: GNU troff Reference
+
+5.38 Implementation Differences
+===============================
+
+GNU 'troff' has a number of features that cause incompatibilities with
+documents written for other versions of 'troff'.  Some GNU extensions to
+'troff' have become supported by other implementations.
+
+* Menu:
+
+* Safer Mode::
+* Compatibility Mode::
+* Other Differences::
+
+&#x1f;
+File: groff.info,  Node: Safer Mode,  Next: Compatibility Mode,  Prev: Implementation Differences,  Up: Implementation Differences
+
+5.38.1 Safer Mode
+-----------------
+
+The formatter operates in "safer" mode by default; to mitigate risks
+from untrusted input documents, the 'pi' and 'sy' requests are disabled.
+GNU 'troff''s '-U' option enables "unsafe mode", restoring their
+function and enabling additional 'groff' extension requests, 'open',
+'opena', and 'pso'.  *Note I/O::.
+
+&#x1f;
+File: groff.info,  Node: Compatibility Mode,  Next: Safer Mode,  Prev: Other Differences,  Up: Implementation Differences
+
+5.38.2 Compatibility Mode
+-------------------------
+
+Long identifier names may be GNU 'troff''s most obvious innovation.
+AT&T 'troff' interprets '.dsabcd' as defining a string 'ab' with
+contents 'cd'.  Normally, GNU 'troff' interprets this as a call of a
+macro named 'dsabcd'.  AT&T 'troff' also interprets '\*' and '\n' as
+an interpolation of a string or register, respectively, named ''.  In
+GNU 'troff', however, the '' is normally interpreted as delimiting a
+long name.  In compatibility mode, GNU 'troff' interprets names in the
+traditional way; they thus can be two characters long at most.
+
+ -- Request: .cp n
+ -- Register: \n.C
+     If N is missing or non-zero, turn on compatibility mode; otherwise,
+     turn it off.
+
+     The read-only register '.C' is 1 if compatibility mode is on,
+     0 otherwise.
+
+     Compatibility mode can be also turned on with the '-C' command-line
+     option.
+
+ -- Request: .do name
+ -- Register: \n.cp
+     The 'do' request interprets the string, request, diversion, or
+     macro NAME (along with any further arguments) with compatibility
+     mode disabled.  Compatibility mode is restored (only if it was
+     active) when the _expansion_ of NAME is interpreted; that is, the
+     restored compatibility state applies to the contents of the macro,
+     string, or diversion NAME as well as data read from files or pipes
+     if NAME is any of the 'so', 'soquiet', 'mso', 'msoquiet', or 'pso'
+     requests.
+
+     The following example illustrates several aspects of 'do' behavior.
+
+          .de mac1
+          FOO
+          ..
+          .de1 mac2
+          groff
+          .mac1
+          ..
+          .de mac3
+          compatibility
+          .mac1
+          ..
+          .de ma
+          \\$1
+          ..
+          .cp 1
+          .do mac1
+          .do mac2 \" mac2, defined with .de1, calls "mac1"
+          .do mac3 \" mac3 calls "ma" with argument "c1"
+          .do mac3 \ti \" groff syntax accepted in .do arguments
+              => FOO groff FOO compatibility c1 ~
+
+     The read-only register '.cp', meaningful only when dereferenced
+     from a 'do' request, is 1 if compatibility mode was on when the
+     'do' request was encountered, and 0 if it was not.  This register
+     is specialized and may require a statement of rationale.
+
+     When writing macro packages or documents that use GNU 'troff'
+     features and which may be mixed with other packages or documents
+     that do not--common scenarios include serial processing of man
+     pages or use of the 'so' or 'mso' requests--you may desire correct
+     operation regardless of compatibility mode enablement in the
+     surrounding context.  It may occur to you to save the existing
+     value of '\n(.C' into a register, say, '_C', at the beginning of
+     your file, turn compatibility mode off with '.cp 0', then restore
+     it from that register at the end with '.cp \n(_C'.  At the same
+     time, a modular design of a document or macro package may lead you
+     to multiple layers of inclusion.  You cannot use the same register
+     name everywhere lest you "clobber" the value from a preceding or
+     enclosing context.  The two-character register name space of AT&T
+     'troff' is confining and mnemonically challenging; you may wish to
+     use the more capacious name space of GNU 'troff'.  However,
+     attempting '.nr _my_saved_C \n(.C' will not work in compatibility
+     mode; the register name is too long.  "This is exactly what 'do' is
+     for," you think, '.do nr _my_saved_C \n(.C'.  The foregoing will
+     always save zero to your register, because 'do' turns compatibility
+     mode _off_ while it interprets its argument list.
+
+     To robustly save compatibility mode before switching it off, use
+
+          .do nr _my_saved_C \n.cp
+          .cp 0
+
+     at the beginning of your file, followed by
+
+          .cp \n_my_saved_C
+          .do rr _my_saved_C
+
+     at the end.  As in the C language, we all have to share one big
+     name space, so choose a register name that is unlikely to collide
+     with other uses.
+
+   Normally, GNU 'troff' preserves the interpolation depth in delimited
+arguments, but not in compatibility mode.
+
+     .ds xx '
+     \w'abc\*(xxdef'
+         => 168 (normal mode on a terminal device)
+         => 72def' (compatibility mode on a terminal device)
+
+   Furthermore, the escape sequences '\f', '\H', '\m', '\M', '\R', '\s',
+and '\S' are transparent for the purpose of recognizing a control
+character at the beginning of a line only in compatibility mode.  For
+example, this code produces bold output in both cases, but the text
+differs.
+
+     .de xx
+     Hello!
+     ..
+     \fB.xx\fP
+         => .xx (normal mode)
+         => Hello! (compatibility mode)
+
+   Normally, the syntax form '\s'N accepts only a single character (a
+digit) for N, consistently with other forms that originated in AT&T
+'troff', like '\*', '\$', '\f', '\g', '\k', '\n', and '\z'.  In
+compatibility mode only, a non-zero N must be in the range 4-39.  Legacy
+documents relying upon this quirk of parsing(1) (*note Compatibility
+Mode-Footnote-1::) should be migrated to another '\s' form.
+
+&#x1f;
+File: groff.info,  Node: Compatibility Mode-Footnotes,  Up: Compatibility Mode
+
+   (1) The Graphic Systems C/A/T phototypesetter (the original device
+target for AT&T 'troff') supported only a few discrete type sizes in the
+range 6-36 points, so Ossanna contrived a special case in the parser to
+do what the user must have meant.  Kernighan warned of this in the 1992
+revision of CSTR #54 (§2.3), and more recently, McIlroy referred to it
+as a "living fossil".
+
+&#x1f;
+File: groff.info,  Node: Other Differences,  Prev: Compatibility Mode,  Up: Implementation Differences
+
+5.38.3 Other Differences
+------------------------
+
+'groff' request names unrecognized by other 'troff' implementations will
+likely be ignored by them; escape sequences that are 'groff' extensions
+are liable to be interpreted as if the escape character were not
+present.  For example, the adjustable, non-breaking escape sequence '\~'
+is also supported by Heirloom Doctools 'troff' 050915 (September 2005),
+'mandoc' 1.9.5 (2009-09-21), 'neatroff' (commit 1c6ab0f6e, 2016-09-13),
+and Plan 9 from User Space 'troff' (commit 93f8143600, 2022-08-12), but
+not by Solaris or Documenter's Workbench 'troff's.  *Note Manipulating
+Filling and Adjustment::.
+
+   GNU 'troff' does not allow the use of the escape sequences '\|',
+'\^', '\&', '\{', '\}', '\<SP>', '\'', '\`', '\-', '\_', '\!', '\%', and
+'\c' in identifiers; AT&T 'troff' does.  The '\A' escape sequence (*note
+Identifiers::) may be helpful in avoiding use of these escape sequences
+in names.
+
+   When adjusting to both margins, AT&T 'troff' at first adjusts spaces
+starting from the right; GNU 'troff' begins from the left.  Both
+implementations adjust spaces from opposite ends on alternating output
+lines in this adjustment mode to prevent "rivers" in the text.
+
+   GNU 'troff' does not always hyphenate words as AT&T 'troff' does.
+The AT&T implementation uses a set of hard-coded rules specific to
+English, while GNU 'troff' uses language-specific hyphenation pattern
+files derived from TeX.  Furthermore, in old versions of 'troff' there
+was a limited amount of space to store hyphenation exceptions (arguments
+to the 'hw' request); GNU 'troff' has no such restriction.
+
+   GNU 'troff' predefines a string '.T' containing the argument given to
+the '-T' command-line option, namely the current output device (for
+example, 'pdf' or 'utf8').  The existence of this string is a common
+feature of post-CSTR #54 'troff's(1) (*note Other
+Differences-Footnote-1::) but valid values are specific to each
+implementation.
+
+   AT&T 'troff' ignored attempts to remove read-only registers; GNU
+'troff' honors such requests.  *Note Built-in Registers::.
+
+   The (read-only) register '.T' interpolates 1 if GNU 'troff' is called
+with the '-T' command-line option, and 0 otherwise.  This behavior
+differs from AT&T 'troff', which interpolated 1 only if 'nroff' was the
+formatter and was called with '-T'.
+
+   AT&T 'troff' and other implementations handle the 'lf' request
+differently.  For them, its LINE argument changes the line number of the
+_current_ line.
+
+   AT&T 'troff' had only environments named '0', '1', and '2'.  In GNU
+'troff', any number of environments may exist, using any valid
+identifiers for their names (*note Identifiers::.)
+
+   Fractional type sizes cause one noteworthy incompatibility.  In AT&T
+'troff' the 'ps' request ignores scaling units and thus '.ps 10u' sets
+the type size to 10 points, whereas in GNU 'troff' it sets the type size
+to 10 _scaled_ points.  *Note Using Fractional Type Sizes::.
+
+   The 'ab' request differs from AT&T 'troff': GNU 'troff' writes no
+message to the standard error stream if no arguments are given, and it
+exits with a failure status instead of a successful one.
+
+   The 'bp' request differs from AT&T 'troff': GNU 'troff' does not
+accept a scaling unit on the argument, a page number; the former
+(somewhat uselessly) does.
+
+   The 'pm' request differs from AT&T 'troff': GNU 'troff' reports the
+sizes of macros, strings, and diversions in bytes and ignores an
+argument to report only the sum of the sizes.
+
+   Unlike AT&T 'troff', GNU 'troff' does not ignore the 'ss' request if
+the output is a terminal device; instead, the values of minimal
+inter-word and additional inter-sentence space are each rounded down to
+the nearest multiple of 12.
+
+   In GNU 'troff' there is a fundamental difference between
+(unformatted) characters and (formatted) glyphs.  Everything that
+affects how a glyph is output is stored with the glyph node; once a
+glyph node has been constructed, it is unaffected by any subsequent
+requests that are executed, including 'bd', 'cs', 'tkf', 'tr', or 'fp'
+requests.  Normally, glyphs are constructed from characters immediately
+before the glyph is added to an output line.  Macros, diversions, and
+strings are all, in fact, the same type of object; they contain a
+sequence of intermixed character and glyph nodes.  Special characters
+transform from one to the other: before being added to the output, they
+behave as characters; afterward, they are glyphs.  A glyph node does not
+behave like a character node when it is processed by a macro: it does
+not inherit any of the special properties that the character from which
+it was constructed might have had.  For example, the input
+
+     .di x
+     \\\\
+     .br
+     .di
+     .x
+
+produces '\\' in GNU 'troff'.  Each pair of backslashes becomes one
+backslash _glyph_; the resulting backslashes are thus not interpreted as
+escape _characters_ when they are reread as the diversion is output.
+AT&T 'troff' _would_ interpret them as escape characters when rereading
+them and end up printing one '\'.
+
+   One correct way to obtain a printable backslash in most documents is
+to use the '\e' escape sequence; this always prints a single instance of
+the current escape character,(2) (*note Other Differences-Footnote-2::)
+regardless of whether or not it is used in a diversion; it also works in
+both GNU 'troff' and AT&T 'troff'.
+
+   The other correct way, appropriate in contexts independent of the
+backslash's common use as a 'troff' escape character--perhaps in
+discussion of character sets or other programming languages--is the
+character escape '\(rs' or '\rs', for "reverse solidus", from its name
+in the ECMA-6 (ISO/IEC 646) standard.(3)  (*note Other
+Differences-Footnote-3::)
+
+   To store an escape sequence in a diversion that is interpreted when
+the diversion is reread, either use the traditional '\!' transparent
+output facility, or, if this is unsuitable, the new '\?' escape
+sequence.  *Note Diversions:: and *note Gtroff Internals::.
+
+   In the somewhat pathological case where a diversion exists containing
+a partially collected line and a partially collected line at the
+top-level diversion has never existed, AT&T 'troff' will output the
+partially collected line at the end of input; GNU 'troff' will not.
+
+&#x1f;
+File: groff.info,  Node: Other Differences-Footnotes,  Up: Other Differences
+
+   (1) DWB 3.3, Solaris, Heirloom Doctools, and Plan 9 'troff' all
+support it.
+
+   (2) Naturally, if you've changed the escape character, you need to
+prefix the 'e' with whatever it is--and you'll likely get something
+other than a backslash in the output.
+
+   (3) The 'rs' special character identifier was not defined in AT&T
+'troff''s font description files, but is in those of its lineal
+descendant, Heirloom Doctools 'troff', as of the latter's 060716 release
+(July 2006).
+
+&#x1f;
+File: groff.info,  Node: File Formats,  Next: Copying This Manual,  Prev: GNU troff Reference,  Up: Top
+
+6 File Formats
+**************
+
+All files read and written by 'gtroff' are text files.  The following
+two sections describe their format.
+
+* Menu:
+
+* gtroff Output::
+* Device and Font Description Files::
+
+&#x1f;
+File: groff.info,  Node: gtroff Output,  Next: Device and Font Description Files,  Prev: File Formats,  Up: File Formats
+
+6.1 'gtroff' Output
+===================
+
+This section describes the 'groff' intermediate output format produced
+by GNU 'troff'.
+
+   As 'groff' is a wrapper program around GNU 'troff' and automatically
+calls an output driver (or "postprocessor"), this output does not show
+up normally.  This is why it is called _intermediate_.  'groff' provides
+the option '-Z' to inhibit postprocessing such that the produced
+intermediate output is sent to standard output just as it is when
+calling GNU 'troff' directly.
+
+   Here, the term "troff output" describes what is output by GNU
+'troff', while "intermediate output" refers to the language that is
+accepted by the parser that prepares this output for the output drivers.
+This parser handles whitespace more flexibly than AT&T's implementation
+and implements obsolete elements for compatibility; otherwise, both
+formats are the same.(1)  (*note gtroff Output-Footnote-1::)
+
+   The main purpose of the intermediate output concept is to facilitate
+the development of postprocessors by providing a common programming
+interface for all devices.  It has a language of its own that is
+completely different from the 'gtroff' language.  While the 'gtroff'
+language is a high-level programming language for text processing, the
+intermediate output language is a kind of low-level assembler language
+by specifying all positions on the page for writing and drawing.
+
+   The intermediate output produced by 'gtroff' is fairly readable,
+while output from AT&T 'troff' is rather hard to understand because of
+strange habits that are still supported, but not used any longer by
+'gtroff'.
+
+* Menu:
+
+* Language Concepts::
+* Command Reference::
+* Intermediate Output Examples::
+* Output Language Compatibility::
+
+&#x1f;
+File: groff.info,  Node: gtroff Output-Footnotes,  Up: gtroff Output
+
+   (1) The parser and postprocessor for intermediate output can be found
+in the file
+'GROFF-SOURCE-DIR/src/libs/libdriver/input.cpp'.
+
+&#x1f;
+File: groff.info,  Node: Language Concepts,  Next: Command Reference,  Prev: gtroff Output,  Up: gtroff Output
+
+6.1.1 Language Concepts
+-----------------------
+
+The fundamental operation of the GNU 'troff' formatter is the
+translation of the 'groff' input language into a device-independent form
+primarily concerned with what has to be written or drawn at specific
+positions on the output device.  This language is simple and imperative.
+In the following discussion, the term "command" always refers to this
+intermediate output language, and never to the 'groff' language intended
+for direct use by document authors.  Intermediate output commands
+comprise several categories: glyph output; font, color, and text size
+selection; motion of the printing position; page advancement; drawing of
+geometric objects; and device control commands, a catch-all for
+operations not easily classified as any of the foregoing, such as
+directives to start and stop output, identify the intended output
+device, or place URL hyperlinks in supported output formats.
+
+* Menu:
+
+* Separation::
+* Argument Units::
+* Document Parts::
+
+&#x1f;
+File: groff.info,  Node: Separation,  Next: Argument Units,  Prev: Language Concepts,  Up: Language Concepts
+
+6.1.1.1 Separation
+..................
+
+AT&T 'troff' output has strange requirements regarding whitespace.  The
+'gtroff' output parser, however, is more tolerant, making whitespace
+maximally optional.  Such characters, i.e., the tab, space, and newline,
+always have a syntactical meaning.  They are never printable because
+spacing within the output is always done by positioning commands.
+
+   Any sequence of space or tab characters is treated as a single
+"syntactical space".  It separates commands and arguments, but is only
+required when there would occur a clashing between the command code and
+the arguments without the space.  Most often, this happens when
+variable-length command names, arguments, argument lists, or command
+clusters meet.  Commands and arguments with a known, fixed length need
+not be separated by syntactical space.
+
+   A line break is a syntactical element, too.  Every command argument
+can be followed by whitespace, a comment, or a newline character.  Thus
+a "syntactical line break" is defined to consist of optional syntactical
+space that is optionally followed by a comment, and a newline character.
+
+   The normal commands, those for positioning and text, consist of a
+single letter taking a fixed number of arguments.  For historical
+reasons, the parser allows stacking of such commands on the same line,
+but fortunately, in 'gtroff''s intermediate output, every command with
+at least one argument is followed by a line break, thus providing
+excellent readability.
+
+   The other commands--those for drawing and device controlling--have a
+more complicated structure; some recognize long command names, and some
+take a variable number of arguments.  So all 'D' and 'x' commands were
+designed to request a syntactical line break after their last argument.
+Only one command, 'x X', has an argument that can span several input
+lines; all other commands must have all of their arguments on the same
+line as the command, i.e., the arguments may not be split by a line
+break.
+
+   Empty lines (these are lines containing only space and/or a comment),
+can occur everywhere.  They are just ignored.
+
+&#x1f;
+File: groff.info,  Node: Argument Units,  Next: Document Parts,  Prev: Separation,  Up: Language Concepts
+
+6.1.1.2 Argument Units
+......................
+
+Some commands take integer arguments that are assumed to represent
+values in a measurement unit, but the letter for the corresponding
+scaling unit is not written with the output command arguments.  Most
+commands assume the scaling unit 'u', the basic unit of the device, some
+use 'z', the scaled point unit of the device, while others, such as the
+color commands, expect plain integers.
+
+   Single characters can have the eighth bit set, as can the names of
+fonts and special characters.  The names of characters and fonts can be
+of arbitrary length.  A character that is to be printed is always in the
+current font.
+
+   A string argument is always terminated by the next whitespace
+character (space, tab, or newline); an embedded '#' character is
+regarded as part of the argument, not as the beginning of a comment
+command.  An integer argument is already terminated by the next
+non-digit character, which then is regarded as the first character of
+the next argument or command.
+
+&#x1f;
+File: groff.info,  Node: Document Parts,  Prev: Argument Units,  Up: Language Concepts
+
+6.1.1.3 Document Parts
+......................
+
+A correct intermediate output document consists of two parts, the
+"prologue" and the "body".
+
+   The task of the prologue is to set the general device parameters
+using three exactly specified commands.  'gtroff''s prologue is
+guaranteed to consist of the following three lines (in that order):
+
+     x T DEVICE
+     x res N H V
+     x init
+
+with the arguments set as outlined in *note Device Control Commands::.
+The parser for the intermediate output format is able to interpret
+additional whitespace and comments as well even in the prologue.
+
+   The body is the main section for processing the document data.
+Syntactically, it is a sequence of any commands different from the ones
+used in the prologue.  Processing is terminated as soon as the first
+'x stop' command is encountered; the last line of any 'gtroff'
+intermediate output always contains such a command.
+
+   Semantically, the body is page oriented.  A new page is started by a
+'p' command.  Positioning, writing, and drawing commands are always done
+within the current page, so they cannot occur before the first 'p'
+command.  Absolute positioning (by the 'H' and 'V' commands) is done
+relative to the current page; all other positioning is done relative to
+the current location within this page.
+
+&#x1f;
+File: groff.info,  Node: Command Reference,  Next: Intermediate Output Examples,  Prev: Language Concepts,  Up: gtroff Output
+
+6.1.2 Command Reference
+-----------------------
+
+This section describes all intermediate output commands, both from AT&T
+'troff' as well as the 'gtroff' extensions.
+
+* Menu:
+
+* Comment Command::
+* Simple Commands::
+* Graphics Commands::
+* Device Control Commands::
+* Obsolete Command::
+
+&#x1f;
+File: groff.info,  Node: Comment Command,  Next: Simple Commands,  Prev: Command Reference,  Up: Command Reference
+
+6.1.2.1 Comment Command
+.......................
+
+'#ANYTHING<end of line>'
+     A comment.  Ignore any characters from the '#' character up to the
+     next newline character.
+
+     This command is the only possibility for commenting in the
+     intermediate output.  Each comment can be preceded by arbitrary
+     syntactical space; every command can be terminated by a comment.
+
+&#x1f;
+File: groff.info,  Node: Simple Commands,  Next: Graphics Commands,  Prev: Comment Command,  Up: Command Reference
+
+6.1.2.2 Simple Commands
+.......................
+
+The commands in this subsection have a command code consisting of a
+single character, taking a fixed number of arguments.  Most of them are
+commands for positioning and text writing.  These commands are tolerant
+of whitespace.  Optionally, syntactical space can be inserted before,
+after, and between the command letter and its arguments.  All of these
+commands are stackable; i.e., they can be preceded by other simple
+commands or followed by arbitrary other commands on the same line.  A
+separating syntactical space is necessary only when two integer
+arguments would clash or if the preceding argument ends with a string
+argument.
+
+'C ID<whitespace>'
+     Typeset the glyph of the special character ID.  Trailing
+     syntactical space is necessary to allow special character names of
+     arbitrary length.  The drawing position is not advanced.
+
+'c G'
+     Typeset the glyph of the ordinary character C.  The drawing
+     position is not advanced.
+
+'f N'
+     Select the font mounted at position N.  N cannot be negative.
+
+'H N'
+     Horizontally move the drawing position to N basic units from the
+     left edge of the page.  N cannot be negative.
+
+'h N'
+     Move the drawing position right N basic units.  AT&T 'troff'
+     allowed negative N; GNU 'troff' does not produce such values, but
+     'groff''s output driver library handles them.
+
+'m COLOR-SCHEME COMPONENT ...'
+     Select the stroke color using the COMPONENTs in the color space
+     SCHEME.  Each COMPONENT is an integer between 0 and 65535.  The
+     quantity of components and their meanings vary with each SCHEME.
+     This command is a 'groff' extension.
+
+     'mc CYAN MAGENTA YELLOW'
+          Use the CMY color scheme with components cyan, magenta, and
+          yellow.
+
+     'md'
+          Use the default color (no components; black in most cases).
+
+     'mg GRAY'
+          Use a grayscale color scheme with a component ranging between
+          0 (black) and 65535 (white).
+
+     'mk CYAN MAGENTA YELLOW BLACK'
+          Use the CMYK color scheme with components cyan, magenta,
+          yellow, and black.
+
+     'mr RED GREEN BLUE'
+          Use the RGB color scheme with components red, green, and blue.
+
+'N N'
+     Typeset the glyph with index N in the current font.  N is normally
+     a non-negative integer.  The drawing position is not advanced.  The
+     'html' and 'xhtml' devices use this command with negative N to
+     produce unbreakable space; the absolute value of N is taken and
+     interpreted in basic units.
+
+'n B A'
+     Indicate a break.  No action is performed; the command is present
+     to make the output more easily parsed.  The integers B and A
+     describe the vertical space amounts before and after the break,
+     respectively.  GNU 'troff' issues this command but 'groff''s output
+     driver library ignores it.  See 'v' and 'V' below.
+
+'p N'
+     Begin a new page, setting its number to N.  Each page is
+     independent, even from those using the same number.  The vertical
+     drawing position is set to 0.  All positioning, writing, and
+     drawing commands are interpreted in the context of a page, so a
+     'p' command must precede them.
+
+'s N'
+     Set type size to N scaled points (unit 'z' in GNU 'troff'.  AT&T
+     'troff' used unscaled points 'p' instead; see *note Output Language
+     Compatibility::.
+
+'t XYZ<whitespace>'
+'t XYZ DUMMY-ARG<whitespace>'
+     Typeset a word XYZ; that is, set a sequence of ordinary glyphs
+     named X, Y, Z, ..., terminated by a space character or a line
+     break; an optional second integer argument is ignored (this allows
+     the formatter to generate an even number of arguments).  Each glyph
+     is set at the current drawing position, and the position is then
+     advanced horizontally by the glyph's width.  A glyph's width is
+     read from its metrics in the font description file, scaled to the
+     current type size, and rounded to a multiple of the horizontal
+     motion quantum.  Use the 'C' command to emplace glyphs of special
+     characters.  The 't' command is a 'groff' extension and is output
+     only for devices whose 'DESC' file contains the 'tcommand'
+     directive; see *note DESC File Format::.
+
+'u N XYZ<whitespace>'
+     Typeset word XYZ with track kerning.  As 't', but after placing
+     each glyph, the drawing position is further advanced horizontally
+     by N basic units ('u').  The 'u' command is a 'groff' extension and
+     is output only for devices whose 'DESC' file contains the
+     'tcommand' directive; see *note DESC File Format::.
+
+'V N'
+     Vertically move the drawing position to N basic units from the top
+     edge of the page.  N cannot be negative.
+
+'v N'
+     Move the drawing position down N basic units.  AT&T 'troff' allowed
+     negative N; GNU 'troff' does not produce such values, but 'groff''s
+     output driver library handles them.
+
+'w'
+     Indicate an inter-word space.  No action is performed; the command
+     is present to make the output more easily parsed.  Only adjustable,
+     breakable inter-word spaces are thus described; those resulting
+     from '\~' or horizontal motion escape sequences are not.  GNU
+     'troff' issues this command but 'groff''s output driver library
+     ignores it.  See 'h' and 'H' above.
+
+&#x1f;
+File: groff.info,  Node: Graphics Commands,  Next: Device Control Commands,  Prev: Simple Commands,  Up: Command Reference
+
+6.1.2.3 Graphics Commands
+.........................
+
+Each graphics or drawing command in the intermediate output starts with
+the letter 'D', followed by one or two characters that specify a
+subcommand; this is followed by a fixed or variable number of integer
+arguments that are separated by a single space character.  A 'D' command
+may not be followed by another command on the same line (apart from a
+comment), so each 'D' command is terminated by a syntactical line break.
+
+   'gtroff' output follows the classical spacing rules (no space between
+command and subcommand, all arguments are preceded by a single space
+character), but the parser allows optional space between the command
+letters and makes the space before the first argument optional.  As
+usual, each space can be any sequence of tab and space characters.
+
+   Some graphics commands can take a variable number of arguments.  In
+this case, they are integers representing a size measured in basic units
+'u'.  The arguments called H1, H2, ..., HN stand for horizontal
+distances where positive means right, negative left.  The arguments
+called V1, V2, ..., VN stand for vertical distances where positive means
+down, negative up.  All these distances are offsets relative to the
+current location.
+
+   Each graphics command directly corresponds to a similar 'gtroff' '\D'
+escape sequence.  *Note Drawing Geometric Objects::.
+
+   Unknown 'D' commands are assumed to be device-specific.  Its
+arguments are parsed as strings; the whole information is then sent to
+the postprocessor.
+
+   In the following command reference, the syntax element <line break>
+means a syntactical line break as defined above.
+
+'D~ H1 V1 H2 V2 ... HN VN<line break>'
+     Draw B-spline from current position to offset (H1,V1), then to
+     offset (H2,V2), if given, etc., up to (HN,VN).  This command takes
+     a variable number of argument pairs; the current position is moved
+     to the terminal point of the drawn curve.
+
+'Da H1 V1 H2 V2<line break>'
+     Draw arc from current position to (H1,V1)+(H2,V2) with center at
+     (H1,V1); then move the current position to the final point of the
+     arc.
+
+'DC D<line break>'
+'DC D DUMMY-ARG<line break>'
+     Draw a solid circle using the current fill color with diameter D
+     (integer in basic units 'u') with leftmost point at the current
+     position; then move the current position to the rightmost point of
+     the circle.  An optional second integer argument is ignored (this
+     allows the formatter to generate an even number of arguments).
+     This command is a 'gtroff' extension.
+
+'Dc D<line break>'
+     Draw circle line with diameter D (integer in basic units 'u') with
+     leftmost point at the current position; then move the current
+     position to the rightmost point of the circle.
+
+'DE H V<line break>'
+     Draw a solid ellipse in the current fill color with a horizontal
+     diameter of H and a vertical diameter of V (both integers in basic
+     units 'u') with the leftmost point at the current position; then
+     move to the rightmost point of the ellipse.  This command is a
+     'gtroff' extension.
+
+'De H V<line break>'
+     Draw an outlined ellipse with a horizontal diameter of H and a
+     vertical diameter of V (both integers in basic units 'u') with the
+     leftmost point at current position; then move to the rightmost
+     point of the ellipse.
+
+'DF COLOR-SCHEME COMPONENT ...<line break>'
+     Set fill color for solid drawing objects using different color
+     schemes; the analogous command for setting the color of text, line
+     graphics, and the outline of graphic objects is 'm'.  The color
+     components are specified as integer arguments between 0 and 65535.
+     The number of color components and their meaning vary for the
+     different color schemes.  These commands are generated by
+     'gtroff''s escape sequences '\D'F ...'' and '\M' (with no other
+     corresponding graphics commands).  No position changing.  This
+     command is a 'gtroff' extension.
+
+     'DFc CYAN MAGENTA YELLOW<line break>'
+          Set fill color for solid drawing objects using the CMY color
+          scheme, having the 3 color components CYAN, MAGENTA, and
+          YELLOW.
+
+     'DFd<line break>'
+          Set fill color for solid drawing objects to the default fill
+          color value (black in most cases).  No component arguments.
+
+     'DFg GRAY<line break>'
+          Set fill color for solid drawing objects to the shade of gray
+          given by the argument, an integer between 0 (black) and 65535
+          (white).
+
+     'DFk CYAN MAGENTA YELLOW BLACK<line break>'
+          Set fill color for solid drawing objects using the CMYK color
+          scheme, having the 4 color components CYAN, MAGENTA, YELLOW,
+          and BLACK.
+
+     'DFr RED GREEN BLUE<line break>'
+          Set fill color for solid drawing objects using the RGB color
+          scheme, having the 3 color components RED, GREEN, and BLUE.
+
+'Df N<line break>'
+     The argument N must be an integer in the range -32767 to 32767.
+
+     0 <= N <= 1000
+          Set the color for filling solid drawing objects to a shade of
+          gray, where 0 corresponds to solid white, 1000 (the default)
+          to solid black, and values in between to intermediate shades
+          of gray; this is obsoleted by command 'DFg'.
+
+     N < 0 or N > 1000
+          Set the filling color to the color that is currently being
+          used for the text and the outline, see command 'm'.  For
+          example, the command sequence
+
+               mg 0 0 65535
+               Df -1
+
+          sets all colors to blue.
+
+     No position changing.  This command is a 'gtroff' extension.
+
+'Dl H V<line break>'
+     Draw line from current position to offset (H,V) (integers in basic
+     units 'u'); then set current position to the end of the drawn line.
+
+'Dp H1 V1 H2 V2 ... HN VN<line break>'
+     Draw a polygon line from current position to offset (H1,V1), from
+     there to offset (H2,V2), etc., up to offset (HN,VN), and from there
+     back to the starting position.  For historical reasons, the
+     position is changed by adding the sum of all arguments with odd
+     index to the actual horizontal position and the even ones to the
+     vertical position.  Although this doesn't make sense it is kept for
+     compatibility.  This command is a 'gtroff' extension.
+
+'DP H1 V1 H2 V2 ... HN VN<line break>'
+     Draw a solid polygon in the current fill color rather than an
+     outlined polygon, using the same arguments and positioning as the
+     corresponding 'Dp' command.  This command is a 'gtroff' extension.
+
+'Dt N<line break>'
+     Set the current line thickness to N (an integer in basic units 'u')
+     if N>0; if N=0 select the smallest available line thickness; if N<0
+     set the line thickness proportional to the type size (this is the
+     default before the first 'Dt' command was specified).  For
+     historical reasons, the horizontal position is changed by adding
+     the argument to the actual horizontal position, while the vertical
+     position is not changed.  Although this doesn't make sense it is
+     kept for compatibility.  This command is a 'gtroff' extension.
+
+&#x1f;
+File: groff.info,  Node: Device Control Commands,  Next: Obsolete Command,  Prev: Graphics Commands,  Up: Command Reference
+
+6.1.2.4 Device Control Commands
+...............................
+
+Each device control command starts with the letter 'x', followed by a
+space character (optional or arbitrary space or tab in 'gtroff') and a
+subcommand letter or word; each argument (if any) must be preceded by a
+syntactical space.  All 'x' commands are terminated by a syntactical
+line break; no device control command can be followed by another command
+on the same line (except a comment).
+
+   The subcommand is basically a single letter, but to increase
+readability, it can be written as a word, i.e., an arbitrary sequence of
+characters terminated by the next tab, space, or newline character.  All
+characters of the subcommand word but the first are simply ignored.  For
+example, 'gtroff' outputs the initialization command 'x i' as 'x init'
+and the resolution command 'x r' as 'x res'.
+
+   In the following, the syntax element <line break> means a syntactical
+line break (*note Separation::).
+
+'xF NAME<line break>'
+     The 'F' stands for FILENAME.
+
+     Use NAME as the intended name for the current file in error
+     reports.  This is useful for remembering the original file name
+     when 'gtroff' uses an internal piping mechanism.  The input file is
+     not changed by this command.  This command is a 'gtroff' extension.
+
+'xf N S<line break>'
+     The 'f' stands for FONT.
+
+     Mount font position N (a non-negative integer) with font named S (a
+     text word).  *Note Font Positions::.
+
+'xH N<line break>'
+     The 'H' stands for HEIGHT.
+
+     Set glyph height to N (a positive integer in scaled points 'z').
+     AT&T 'troff' uses the unit points ('p') instead.  *Note Output
+     Language Compatibility::.
+
+'xi<line break>'
+     The 'i' stands for INIT.
+
+     Initialize device.  This is the third command of the prologue.
+
+'xp<line break>'
+     The 'p' stands for PAUSE.
+
+     Parsed but ignored.  The AT&T 'troff' manual documents this command
+     as
+
+          pause device, can be restarted
+
+     but GNU 'troff' output drivers do nothing with this command.
+
+'xr N H V<line break>'
+     The 'r' stands for RESOLUTION.
+
+     Resolution is N, while H is the minimal horizontal motion, and V
+     the minimal vertical motion possible with this device; all
+     arguments are positive integers in basic units 'u' per inch.  This
+     is the second command of the prologue.
+
+'xS N<line break>'
+     The 'S' stands for SLANT.
+
+     Set slant to N (an integer in basic units 'u').
+
+'xs<line break>'
+     The 's' stands for STOP.
+
+     Terminates the processing of the current file; issued as the last
+     command of any intermediate 'troff' output.
+
+'xt<line break>'
+     The 't' stands for TRAILER.
+
+     Generate trailer information, if any.  In GNU 'troff', this is
+     ignored.
+
+'xT XXX<line break>'
+     The 'T' stands for TYPESETTER.
+
+     Set the name of the output driver to XXX, a sequence of
+     non-whitespace characters terminated by whitespace.  The possible
+     names correspond to those of 'groff''s '-T' option.  This is the
+     first command of the prologue.
+
+'xu N<line break>'
+     The 'u' stands for UNDERLINE.
+
+     Configure underlining of spaces.  If N is 1, start underlining of
+     spaces; if N is 0, stop underlining of spaces.  This is needed for
+     the 'cu' request in 'nroff' mode and is ignored otherwise.  This
+     command is a 'gtroff' extension.
+
+'xX ANYTHING<line break>'
+     The 'x' stands for X-ESCAPE.
+
+     Send string ANYTHING uninterpreted to the device.  If the line
+     following this command starts with a '+' character this line is
+     interpreted as a continuation line in the following sense.  The '+'
+     is ignored, but a newline character is sent instead to the device,
+     the rest of the line is sent uninterpreted.  The same applies to
+     all following lines until the first character of a line is not a
+     '+' character.  This command is generated by the 'gtroff' escape
+     sequence '\X'.  The line-continuing feature is a 'gtroff'
+     extension.
+
+&#x1f;
+File: groff.info,  Node: Obsolete Command,  Prev: Device Control Commands,  Up: Command Reference
+
+6.1.2.5 Obsolete Command
+........................
+
+In AT&T 'troff' output, the writing of a single glyph is mostly done by
+a very strange command that combines a horizontal move and a single
+character giving the glyph name.  It doesn't have a command code, but is
+represented by a 3-character argument consisting of exactly 2 digits and
+a character.
+
+DDG
+     Move right DD (exactly two decimal digits) basic units 'u', then
+     print glyph G (represented as a single character).
+
+     In GNU 'troff', arbitrary syntactical space around and within this
+     command is allowed.  Only when a preceding command on the same line
+     ends with an argument of variable length is a separating space
+     obligatory.  In AT&T 'troff', large clusters of these and other
+     commands are used, mostly without spaces; this made such output
+     almost unreadable.
+
+   For modern high-resolution devices, this command does not make sense
+because the width of the glyphs can become much larger than two decimal
+digits.  In 'gtroff', this is only used for the devices 'X75', 'X75-12',
+'X100', and 'X100-12'.  For other devices, the commands 't' and 'u'
+provide a better functionality.
+
+&#x1f;
+File: groff.info,  Node: Intermediate Output Examples,  Next: Output Language Compatibility,  Prev: Command Reference,  Up: gtroff Output
+
+6.1.3 Intermediate Output Examples
+----------------------------------
+
+This section presents the intermediate output generated from the same
+input for three different devices.  The input is the sentence 'hell
+world' fed into 'gtroff' on the command line.
+
+High-resolution device 'ps'
+
+     This is the standard output of 'gtroff' if no '-T' option is given.
+
+          shell> echo "hell world" | groff -Z -T ps
+
+          x T ps
+          x res 72000 1 1
+          x init
+          p1
+          x font 5 TR
+          f5
+          s10000
+          V12000
+          H72000
+          thell
+          wh2500
+          tw
+          H96620
+          torld
+          n12000 0
+          x trailer
+          V792000
+          x stop
+
+     This output can be fed into 'grops' to get its representation as a
+     PostScript file.
+
+Low-resolution device 'latin1'
+
+     This is similar to the high-resolution device except that the
+     positioning is done at a minor scale.  Some comments (lines
+     starting with '#') were added for clarification; they were not
+     generated by the formatter.
+
+          shell> echo "hell world" | groff -Z -T latin1
+
+          # prologue
+          x T latin1
+          x res 240 24 40
+          x init
+          # begin a new page
+          p1
+          # font setup
+          x font 1 R
+          f1
+          s10
+          # initial positioning on the page
+          V40
+          H0
+          # write text 'hell'
+          thell
+          # inform about space, and issue a horizontal jump
+          wh24
+          # write text 'world'
+          tworld
+          # announce line break, but do nothing because...
+          n40 0
+          # ...the end of the document has been reached
+          x trailer
+          V2640
+          x stop
+
+     This output can be fed into 'grotty' to get a formatted text
+     document.
+
+AT&T 'troff' output
+     Since a computer monitor has a much lower resolution than modern
+     printers, the intermediate output for X11 devices can use the
+     jump-and-write command with its 2-digit displacements.
+
+          shell> echo "hell world" | groff -Z -T X100
+
+          x T X100
+          x res 100 1 1
+          x init
+          p1
+          x font 5 TR
+          f5
+          s10
+          V16
+          H100
+          # write text with jump-and-write commands
+          ch07e07l03lw06w11o07r05l03dh7
+          n16 0
+          x trailer
+          V1100
+          x stop
+
+     This output can be fed into 'xditview' or 'gxditview' for
+     displaying in X.
+
+     Due to the obsolete jump-and-write command, the text clusters in
+     the AT&T 'troff' output are almost unreadable.
+
+&#x1f;
+File: groff.info,  Node: Output Language Compatibility,  Prev: Intermediate Output Examples,  Up: gtroff Output
+
+6.1.4 Output Language Compatibility
+-----------------------------------
+
+The intermediate output language of AT&T 'troff' was first documented in
+'A Typesetter-independent TROFF', by Brian Kernighan, and by 1992 the
+AT&T 'troff' manual was updated to incorprate a description of it.
+
+   The GNU 'troff' intermediate output format is compatible with this
+specification except for the following features.
+
+   * The classical quasi-device independence is not yet implemented.
+
+   * The old hardware was very different from what we use today.  So the
+     'groff' devices are also fundamentally different from the ones in
+     AT&T 'troff'.  For example, the AT&T PostScript device is called
+     'post' and has a resolution of only 720 units per inch, suitable
+     for printers 20 years ago, while 'groff''s 'ps' device has a
+     resolution of 72000 units per inch.  Maybe, by implementing some
+     rescaling mechanism similar to the classical quasi-device
+     independence, 'groff' could emulate AT&T's 'post' device.
+
+   * The B-spline command 'D~' is correctly handled by the intermediate
+     output parser, but the drawing routines aren't implemented in some
+     of the postprocessor programs.
+
+   * The argument of the commands 's' and 'x H' has the implicit unit
+     scaled point 'z' in 'gtroff', while AT&T 'troff' has point ('p').
+     This isn't an incompatibility but a compatible extension, for both
+     units coincide for all devices without a 'sizescale' parameter in
+     the 'DESC' file, including all postprocessors from AT&T and
+     'groff''s text devices.  The few 'groff' devices with a 'sizescale'
+     parameter either do not exist for AT&T 'troff', have a different
+     name, or seem to have a different resolution.  So conflicts are
+     very unlikely.
+
+   * The position changing after the commands 'Dp', 'DP', and 'Dt' is
+     illogical, but as old versions of 'gtroff' used this feature it is
+     kept for compatibility reasons.
+
+&#x1f;
+File: groff.info,  Node: Device and Font Description Files,  Prev: gtroff Output,  Up: File Formats
+
+6.2 Device and Font Description Files
+=====================================
+
+The 'groff' font and output device description formats are slight
+extensions of those used by AT&T device-independent 'troff'.  In
+distinction to the AT&T implementation, 'groff' lacks a binary format;
+all files are text files.(1)  (*note Device and Font Description
+Files-Footnote-1::) The device and font description files for a device
+NAME are stored in a 'devNAME' directory.  The device description file
+is called 'DESC', and, for each font supported by the device, a font
+description file is called 'F', where F is usually an abbreviation of a
+font's name and/or style.  For example, the 'ps' (PostScript) device has
+'groff' font description files for Times roman ('TR') and Zapf Chancery
+Medium italic ('ZCMI'), among many others, while the 'utf8' device (for
+terminal emulators) has only font descriptions for the roman, italic,
+bold, and bold-italic styles ('R', 'I', 'B', and 'BI', respectively).
+
+   Device and font description files are read both by the formatter, GNU
+'troff', and by output drivers.  The programs delegate these files'
+processing to an internal library, 'libgroff', ensuring their consistent
+interpretation.
+
+* Menu:
+
+* DESC File Format::
+* Font Description File Format::
+
+&#x1f;
+File: groff.info,  Node: Device and Font Description Files-Footnotes,  Up: Device and Font Description Files
+
+   (1) Plan 9 'troff' has also abandoned the binary format.
+
+&#x1f;
+File: groff.info,  Node: DESC File Format,  Next: Font Description File Format,  Prev: Device and Font Description Files,  Up: Device and Font Description Files
+
+6.2.1 'DESC' File Format
+------------------------
+
+The 'DESC' file contains a series of directives; each begins a line.
+Their order is not important, with two exceptions: (1) the 'res'
+directive must precede any 'papersize' directive; and (2) the 'charset'
+directive must come last (if at all).  If a directive name is repeated,
+later entries in the file override previous ones (except that the paper
+dimensions are computed based on the 'res' directive last seen when
+'papersize' is encountered).  Spaces and/or tabs separate words and are
+ignored at line boundaries.  Comments start with the '#' character and
+extend to the end of a line.  Empty lines are ignored.
+
+'family FAM'
+     The default font family is FAM.
+
+'fonts N F1 ... FN'
+     Fonts F1, ..., FN are mounted at font positions M+1, ..., M+N where
+     M is the number of 'styles' (see below).  This directive may extend
+     over more than one line.  A font name of '0' causes no font to be
+     mounted at the corresponding position.
+
+'hor N'
+     The horizontal motion quantum is N basic units.  All horizontal
+     quantities are rounded to multiples of N.
+
+'image_generator PROGRAM'
+     Use PROGRAM to generate PNG images from PostScript input.  Under
+     GNU/Linux, this is usually 'gs', but under other systems (notably
+     Cygwin) it might be set to another name.  The 'grohtml' driver uses
+     this directive.
+
+'paperlength N'
+     The vertical dimension of the output medium is N basic units
+     (deprecated: use 'papersize' instead).
+
+'papersize FORMAT-OR-DIMENSION-PAIR-OR-FILE-NAME ...'
+     The dimensions of the output medium are as according to the
+     argument, which is either a standard paper format, a pair of
+     dimensions, or the name of a plain text file containing either of
+     the foregoing.
+
+     Recognized paper formats are the ISO and DIN formats 'A0'-'A7',
+     'B0'-'B7', 'C0'-'C7', 'D0'-'D7'; the U.S. paper types 'letter',
+     'legal', 'tabloid', 'ledger', 'statement', and 'executive'; and the
+     envelope formats 'com10', 'monarch', and 'DL'.  Matching is
+     performed without regard for lettercase.
+
+     Alternatively, the argument can be a custom paper format in the
+     format 'LENGTH,WIDTH' (with no spaces before or after the comma).
+     Both LENGTH and WIDTH must have a unit appended; valid units are
+     'i' for inches, 'c' for centimeters, 'p' for points, and 'P' for
+     picas.  Example: '12c,235p'.  An argument that starts with a digit
+     is always treated as a custom paper format.
+
+     Finally, the argument can be a file name (e.g., '/etc/papersize');
+     if the file can be opened, the first line is read and a match
+     attempted against each of the other forms.  No comment syntax is
+     supported.
+
+     More than one argument can be specified; each is scanned in turn
+     and the first valid paper specification used.
+
+'paperwidth N'
+     The horizontal dimension of the output medium is N basic units
+     (deprecated: use 'papersize' instead).
+
+'pass_filenames'
+     Direct GNU 'troff' to emit the name of the source file being
+     processed.  This is achieved with the intermediate output command
+     'x F', which 'grohtml' interprets.
+
+'postpro PROGRAM'
+     Use PROGRAM as the postprocessor.
+
+'prepro PROGRAM'
+     Use PROGRAM as a preprocessor.  The 'html' and 'xhtml' output
+     devices use this directive.
+
+'print PROGRAM'
+     Use PROGRAM as a spooler program for printing.  If omitted, the
+     '-l' and '-L' options of 'groff' are ignored.
+
+'res N'
+     The device resolution is N basic units per inch.
+
+'sizes S1 ... SN 0'
+     The device has fonts at S1, ..., SN scaled points (see below).  The
+     list of sizes must be terminated by '0'.  Each SI can also be a
+     range of sizes M-N.  The list can extend over more than one line.
+
+'sizescale N'
+     A typographical point is subdivided into N scaled points.  The
+     default is '1'.  *Note Using Fractional Type Sizes::.
+
+'styles S1 ... SM'
+     The first M mounting positions are associated with styles S1, ...,
+     SM.
+
+'tcommand'
+     The postprocessor can handle the 't' and 'u' intermediate output
+     commands.
+
+'unicode'
+     The output device supports the complete Unicode repertoire.  This
+     directive is useful only for devices that produce character
+     entities instead of glyphs.
+
+     If 'unicode' is present, no 'charset' section is required in the
+     font description files since the Unicode handling built into
+     'groff' is used.  However, if there are entries in a font
+     description file's 'charset' section, they either override the
+     default mappings for those particular characters or add new
+     mappings (normally for composite characters).
+
+     The 'utf8', 'html', and 'xhtml' output devices use this directive.
+
+'unitwidth N'
+     Quantities in the font description files are in basic units for
+     fonts whose type size is N scaled points.
+
+'unscaled_charwidths'
+     Make the font handling module always return unscaled character
+     widths.  The 'grohtml' driver uses this directive.
+
+'use_charnames_in_special'
+     GNU 'troff' should encode special characters inside device control
+     commands; see *note Postprocessor Access::.  The 'grohtml' driver
+     uses this directive.
+
+'vert N'
+     The vertical motion quantum is N basic units.  All vertical
+     quantities are rounded to multiples of N.
+
+'charset'
+     This line and everything following it in the file are ignored.  It
+     is recognized for compatibility with other 'troff' implementations.
+     In GNU 'troff', character set repertoire is described on a per-font
+     basis.
+
+   GNU 'troff' recognizes but ignores the directives 'spare1', 'spare2',
+and 'biggestfont'.
+
+   The 'res', 'unitwidth', 'fonts', and 'sizes' lines are mandatory.
+Directives not listed above are ignored by GNU 'troff' but may be used
+by postprocessors to obtain further information about the device.
+
+&#x1f;
+File: groff.info,  Node: Font Description File Format,  Prev: DESC File Format,  Up: Device and Font Description Files
+
+6.2.2 Font Description File Format
+----------------------------------
+
+On typesetting output devices, each font is typically available at
+multiple sizes.  While paper measurements in the device description file
+are in absolute units, measurements applicable to fonts must be
+proportional to the type size.  'groff' achieves this using the
+precedent set by AT&T device-independent 'troff': one font size is
+chosen as a norm, and all others are scaled linearly relative to that
+basis.  The "unit width" is the number of basic units per point when the
+font is rendered at this nominal size.
+
+   For instance, 'groff''s 'lbp' device uses a 'unitwidth' of 800.  Its
+Times roman font 'TR' has a 'spacewidth' of 833; this is also the width
+of its comma, period, centered period, and mathematical asterisk, while
+its 'M' is 2,963 basic units.  Thus, an 'M' on the 'lbp' device is 2,963
+basic units wide at a notional type size of 800 points.(1)  (*note Font
+Description File Format-Footnote-1::)
+
+   A font description file has two sections.  The first is a sequence of
+directives, and is parsed similarly to the 'DESC' file described above.
+Except for the directive names that begin the second section, their
+ordering is immaterial.  Later directives of the same name override
+earlier ones, spaces and tabs are handled in the same way, and the same
+comment syntax is supported.  Empty lines are ignored throughout.
+
+'name F'
+     The name of the font is F.  'DESC' is an invalid font name.  Simple
+     integers are valid, but their use is discouraged.(2)  (*note Font
+     Description File Format-Footnote-2::)
+
+'spacewidth N'
+     The width of an unadjusted inter-word space is N basic units.
+
+   The directives above must appear in the first section; those below
+are optional.
+
+'slant N'
+     The font's glyphs have a slant of N degrees; a positive N slants in
+     the direction of text flow.
+
+'ligatures LIG1 ... LIGN 0'
+     Glyphs LIG1, ..., LIGN are ligatures; possible ligatures are 'ff',
+     'fi', 'fl', 'ffi' and 'ffl'.  For compatibility with other 'troff'
+     implementations, the list of ligatures may be terminated with
+     a '0'.  The list of ligatures must not extend over more than one
+     line.
+
+'special'
+     The font is "special": when a glyph is requested that is not
+     present in the current font, it is sought in any mounted fonts that
+     bear this property.
+
+   Other directives in this section are ignored by GNU 'troff', but may
+be used by postprocessors to obtain further information about the font.
+
+   The second section contains one or two subsections.  These can appear
+in either order; the first one encountered commences the second section.
+Each starts with a directive on a line by itself.  A 'charset'
+subsection is mandatory unless the associated 'DESC' file contains the
+'unicode' directive.  Another subsection, 'kernpairs', is optional.
+
+   The directive 'charset' starts the character set subsection.(3)
+(*note Font Description File Format-Footnote-3::) It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
+
+     NAME METRICS TYPE CODE ENTITY-NAME '--' COMMENT
+
+NAME identifies the glyph: if NAME is a printable character C, it
+corresponds to the 'troff' ordinary character C.  If NAME is a
+multi-character sequence not beginning with '\', it corresponds to the
+GNU 'troff' special character escape sequence '\NAME'.  A name
+consisting of three minus signs, '---', is special and indicates that
+the glyph is unnamed: such glyphs can be accessed only by the '\N'
+escape sequence in 'troff'.  A special character named '---' can still
+be defined using 'char' and similar requests.  The NAME '\-' defines the
+minus sign glyph.  Finally, NAME can be the unbreakable one-sixth and
+one-twelfth space escape sequences, '\|' and '\^' ("thin" and "hair"
+spaces, respectively), in which case only the width metric described
+below is interpreted; a font can thus customize the widths of these
+spaces.
+
+   The form of the METRICS field is as follows.
+
+     WIDTH','HEIGHT','DEPTH','ITALIC-CORRECTION
+       ','LEFT-ITALIC-CORRECTION','SUBSCRIPT-CORRECTION
+
+There must not be any spaces, tabs, or newlines between these
+"subfields" (which have been split here into two lines only for better
+legibility).  The subfields are in basic units expressed as decimal
+integers.  Unspecified subfields default to '0'.  Since there is no
+associated binary format, these values are not required to fit into the
+C language data type 'char' as they are in AT&T device-independent
+'troff'.
+
+   The WIDTH subfield gives the width of the glyph.  The HEIGHT subfield
+gives the height of the glyph (upward is positive); if a glyph does not
+extend above the baseline, it should be given a zero height, rather than
+a negative height.  The DEPTH subfield gives the depth of the glyph,
+that is, the distance below the baseline to which the glyph extends
+(downward is positive); if a glyph does not extend below the baseline,
+it should be given a zero depth, rather than a negative depth.  Italic
+corrections are relevant to glyphs in italic or oblique styles.  The
+ITALIC-CORRECTION is the amount of space that should be added after an
+oblique glyph to be followed immediately by an upright glyph.  The
+LEFT-ITALIC-CORRECTION is the amount of space that should be added
+before an oblique glyph to be preceded immediately by an upright glyph.
+The SUBSCRIPT-CORRECTION is the amount of space that should be added
+after an oblique glyph to be followed by a subscript; it should be less
+than the italic correction.
+
+   For fonts used with typesetting devices, the TYPE field gives a
+featural description of the glyph: it is a bit mask recording whether
+the glyph is an ascender, descender, both, or neither.  When a '\w'
+escape sequence is interpolated, these values are bitwise or-ed together
+for each glyph and stored in the 'nr' register.  In font descriptions
+for terminal devices, all glyphs might have a type of zero, regardless
+of their appearance.
+
+'0'
+     means the glyph lies entirely between the baseline and a horizontal
+     line at the "x-height" of the font; typical examples are 'a', 'c',
+     and 'x';
+
+'1'
+     means the glyph descends below the baseline, like 'p';
+
+'2'
+     means the glyph ascends above the font's x-height, like 'A' or 'b';
+     and
+
+'3'
+     means the glyph is both an ascender and a descender--this is true
+     of parentheses in some fonts.
+
+   The CODE field gives a numeric identifier that the postprocessor uses
+to render the glyph.  The glyph can be specified to 'troff' using this
+code by means of the '\N' escape sequence.  CODE can be any integer.(4)
+(*note Font Description File Format-Footnote-4::)
+
+   The ENTITY-NAME field defines an identifier for the glyph that the
+postprocessor uses to print the GNU 'troff' glyph NAME.  This field is
+optional; it was introduced so that the 'grohtml' output driver could
+encode its character set.  For example, the glyph '\Po' is represented
+by '&pound;' in HTML 4.0.  For efficiency, these data are now compiled
+directly into 'grohtml'.  'grops' uses the field to build sub-encoding
+arrays for PostScript fonts containing more than 256 glyphs.  Anything
+on the line after the ENTITY-NAME field or '--' is ignored.
+
+   A line in the 'charset' section can also have the form
+
+     NAME "
+
+identifying NAME as another name for the glyph mentioned in the
+preceding line.  Such aliases can be chained.
+
+   The directive 'kernpairs' starts a list of kerning adjustments to be
+made to adjacent glyph pairs from this font.  It contains a sequence of
+lines formatted as follows.
+
+     G1 G2 N
+
+The foregoing means that when glyph G1 is typeset immediately before G2,
+the space between them should be increased by N.  Most kerning pairs
+should have a negative value for N.
+
+&#x1f;
+File: groff.info,  Node: Font Description File Format-Footnotes,  Up: Font Description File Format
+
+   (1) 800-point type is not practical for most purposes, but using it
+enables the quantities in the font description files to be expressed as
+integers.
+
+   (2) 'groff' requests and escape sequences interpret non-negative font
+names as mounting positions instead.  Further, a font named '0' cannot
+be automatically mounted by the 'fonts' directive of a 'DESC' file.
+
+   (3) For typesetter devices, this directive is misnamed since it
+starts a list of glyphs, not characters.
+
+   (4) that is, any integer parsable by the C standard library's
+'strtol(3)' function
+
+&#x1f;
+File: groff.info,  Node: Copying This Manual,  Next: Request Index,  Prev: Font Description File Format,  Up: Top
+
+Appendix A Copying This Manual
+******************************
+
+                     Version 1.3, 3 November 2008
+
+     Copyright © 2000-2018 Free Software Foundation, Inc.
+     <http://fsf.org/>
+
+     Everyone is permitted to copy and distribute verbatim copies
+     of this license document, but changing it is not allowed.
+
+  0. PREAMBLE
+
+     The purpose of this License is to make a manual, textbook, or other
+     functional and useful document "free" in the sense of freedom: to
+     assure everyone the effective freedom to copy and redistribute it,
+     with or without modifying it, either commercially or
+     noncommercially.  Secondarily, this License preserves for the
+     author and publisher a way to get credit for their work, while not
+     being considered responsible for modifications made by others.
+
+     This License is a kind of "copyleft", which means that derivative
+     works of the document must themselves be free in the same sense.
+     It complements the GNU General Public License, which is a copyleft
+     license designed for free software.
+
+     We have designed this License in order to use it for manuals for
+     free software, because free software needs free documentation: a
+     free program should come with manuals providing the same freedoms
+     that the software does.  But this License is not limited to
+     software manuals; it can be used for any textual work, regardless
+     of subject matter or whether it is published as a printed book.  We
+     recommend this License principally for works whose purpose is
+     instruction or reference.
+
+  1. APPLICABILITY AND DEFINITIONS
+
+     This License applies to any manual or other work, in any medium,
+     that contains a notice placed by the copyright holder saying it can
+     be distributed under the terms of this License.  Such a notice
+     grants a world-wide, royalty-free license, unlimited in duration,
+     to use that work under the conditions stated herein.  The
+     "Document", below, refers to any such manual or work.  Any member
+     of the public is a licensee, and is addressed as "you".  You accept
+     the license if you copy, modify or distribute the work in a way
+     requiring permission under copyright law.
+
+     A "Modified Version" of the Document means any work containing the
+     Document or a portion of it, either copied verbatim, or with
+     modifications and/or translated into another language.
+
+     A "Secondary Section" is a named appendix or a front-matter section
+     of the Document that deals exclusively with the relationship of the
+     publishers or authors of the Document to the Document's overall
+     subject (or to related matters) and contains nothing that could
+     fall directly within that overall subject.  (Thus, if the Document
+     is in part a textbook of mathematics, a Secondary Section may not
+     explain any mathematics.)  The relationship could be a matter of
+     historical connection with the subject or with related matters, or
+     of legal, commercial, philosophical, ethical or political position
+     regarding them.
+
+     The "Invariant Sections" are certain Secondary Sections whose
+     titles are designated, as being those of Invariant Sections, in the
+     notice that says that the Document is released under this License.
+     If a section does not fit the above definition of Secondary then it
+     is not allowed to be designated as Invariant.  The Document may
+     contain zero Invariant Sections.  If the Document does not identify
+     any Invariant Sections then there are none.
+
+     The "Cover Texts" are certain short passages of text that are
+     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
+     that says that the Document is released under this License.  A
+     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
+     be at most 25 words.
+
+     A "Transparent" copy of the Document means a machine-readable copy,
+     represented in a format whose specification is available to the
+     general public, that is suitable for revising the document
+     straightforwardly with generic text editors or (for images composed
+     of pixels) generic paint programs or (for drawings) some widely
+     available drawing editor, and that is suitable for input to text
+     formatters or for automatic translation to a variety of formats
+     suitable for input to text formatters.  A copy made in an otherwise
+     Transparent file format whose markup, or absence of markup, has
+     been arranged to thwart or discourage subsequent modification by
+     readers is not Transparent.  An image format is not Transparent if
+     used for any substantial amount of text.  A copy that is not
+     "Transparent" is called "Opaque".
+
+     Examples of suitable formats for Transparent copies include plain
+     ASCII without markup, Texinfo input format, LaTeX input format,
+     SGML or XML using a publicly available DTD, and standard-conforming
+     simple HTML, PostScript or PDF designed for human modification.
+     Examples of transparent image formats include PNG, XCF and JPG.
+     Opaque formats include proprietary formats that can be read and
+     edited only by proprietary word processors, SGML or XML for which
+     the DTD and/or processing tools are not generally available, and
+     the machine-generated HTML, PostScript or PDF produced by some word
+     processors for output purposes only.
+
+     The "Title Page" means, for a printed book, the title page itself,
+     plus such following pages as are needed to hold, legibly, the
+     material this License requires to appear in the title page.  For
+     works in formats which do not have any title page as such, "Title
+     Page" means the text near the most prominent appearance of the
+     work's title, preceding the beginning of the body of the text.
+
+     The "publisher" means any person or entity that distributes copies
+     of the Document to the public.
+
+     A section "Entitled XYZ" means a named subunit of the Document
+     whose title either is precisely XYZ or contains XYZ in parentheses
+     following text that translates XYZ in another language.  (Here XYZ
+     stands for a specific section name mentioned below, such as
+     "Acknowledgements", "Dedications", "Endorsements", or "History".)
+     To "Preserve the Title" of such a section when you modify the
+     Document means that it remains a section "Entitled XYZ" according
+     to this definition.
+
+     The Document may include Warranty Disclaimers next to the notice
+     which states that this License applies to the Document.  These
+     Warranty Disclaimers are considered to be included by reference in
+     this License, but only as regards disclaiming warranties: any other
+     implication that these Warranty Disclaimers may have is void and
+     has no effect on the meaning of this License.
+
+  2. VERBATIM COPYING
+
+     You may copy and distribute the Document in any medium, either
+     commercially or noncommercially, provided that this License, the
+     copyright notices, and the license notice saying this License
+     applies to the Document are reproduced in all copies, and that you
+     add no other conditions whatsoever to those of this License.  You
+     may not use technical measures to obstruct or control the reading
+     or further copying of the copies you make or distribute.  However,
+     you may accept compensation in exchange for copies.  If you
+     distribute a large enough number of copies you must also follow the
+     conditions in section 3.
+
+     You may also lend copies, under the same conditions stated above,
+     and you may publicly display copies.
+
+  3. COPYING IN QUANTITY
+
+     If you publish printed copies (or copies in media that commonly
+     have printed covers) of the Document, numbering more than 100, and
+     the Document's license notice requires Cover Texts, you must
+     enclose the copies in covers that carry, clearly and legibly, all
+     these Cover Texts: Front-Cover Texts on the front cover, and
+     Back-Cover Texts on the back cover.  Both covers must also clearly
+     and legibly identify you as the publisher of these copies.  The
+     front cover must present the full title with all words of the title
+     equally prominent and visible.  You may add other material on the
+     covers in addition.  Copying with changes limited to the covers, as
+     long as they preserve the title of the Document and satisfy these
+     conditions, can be treated as verbatim copying in other respects.
+
+     If the required texts for either cover are too voluminous to fit
+     legibly, you should put the first ones listed (as many as fit
+     reasonably) on the actual cover, and continue the rest onto
+     adjacent pages.
+
+     If you publish or distribute Opaque copies of the Document
+     numbering more than 100, you must either include a machine-readable
+     Transparent copy along with each Opaque copy, or state in or with
+     each Opaque copy a computer-network location from which the general
+     network-using public has access to download using public-standard
+     network protocols a complete Transparent copy of the Document, free
+     of added material.  If you use the latter option, you must take
+     reasonably prudent steps, when you begin distribution of Opaque
+     copies in quantity, to ensure that this Transparent copy will
+     remain thus accessible at the stated location until at least one
+     year after the last time you distribute an Opaque copy (directly or
+     through your agents or retailers) of that edition to the public.
+
+     It is requested, but not required, that you contact the authors of
+     the Document well before redistributing any large number of copies,
+     to give them a chance to provide you with an updated version of the
+     Document.
+
+  4. MODIFICATIONS
+
+     You may copy and distribute a Modified Version of the Document
+     under the conditions of sections 2 and 3 above, provided that you
+     release the Modified Version under precisely this License, with the
+     Modified Version filling the role of the Document, thus licensing
+     distribution and modification of the Modified Version to whoever
+     possesses a copy of it.  In addition, you must do these things in
+     the Modified Version:
+
+       A. Use in the Title Page (and on the covers, if any) a title
+          distinct from that of the Document, and from those of previous
+          versions (which should, if there were any, be listed in the
+          History section of the Document).  You may use the same title
+          as a previous version if the original publisher of that
+          version gives permission.
+
+       B. List on the Title Page, as authors, one or more persons or
+          entities responsible for authorship of the modifications in
+          the Modified Version, together with at least five of the
+          principal authors of the Document (all of its principal
+          authors, if it has fewer than five), unless they release you
+          from this requirement.
+
+       C. State on the Title page the name of the publisher of the
+          Modified Version, as the publisher.
+
+       D. Preserve all the copyright notices of the Document.
+
+       E. Add an appropriate copyright notice for your modifications
+          adjacent to the other copyright notices.
+
+       F. Include, immediately after the copyright notices, a license
+          notice giving the public permission to use the Modified
+          Version under the terms of this License, in the form shown in
+          the Addendum below.
+
+       G. Preserve in that license notice the full lists of Invariant
+          Sections and required Cover Texts given in the Document's
+          license notice.
+
+       H. Include an unaltered copy of this License.
+
+       I. Preserve the section Entitled "History", Preserve its Title,
+          and add to it an item stating at least the title, year, new
+          authors, and publisher of the Modified Version as given on the
+          Title Page.  If there is no section Entitled "History" in the
+          Document, create one stating the title, year, authors, and
+          publisher of the Document as given on its Title Page, then add
+          an item describing the Modified Version as stated in the
+          previous sentence.
+
+       J. Preserve the network location, if any, given in the Document
+          for public access to a Transparent copy of the Document, and
+          likewise the network locations given in the Document for
+          previous versions it was based on.  These may be placed in the
+          "History" section.  You may omit a network location for a work
+          that was published at least four years before the Document
+          itself, or if the original publisher of the version it refers
+          to gives permission.
+
+       K. For any section Entitled "Acknowledgements" or "Dedications",
+          Preserve the Title of the section, and preserve in the section
+          all the substance and tone of each of the contributor
+          acknowledgements and/or dedications given therein.
+
+       L. Preserve all the Invariant Sections of the Document, unaltered
+          in their text and in their titles.  Section numbers or the
+          equivalent are not considered part of the section titles.
+
+       M. Delete any section Entitled "Endorsements".  Such a section
+          may not be included in the Modified Version.
+
+       N. Do not retitle any existing section to be Entitled
+          "Endorsements" or to conflict in title with any Invariant
+          Section.
+
+       O. Preserve any Warranty Disclaimers.
+
+     If the Modified Version includes new front-matter sections or
+     appendices that qualify as Secondary Sections and contain no
+     material copied from the Document, you may at your option designate
+     some or all of these sections as invariant.  To do this, add their
+     titles to the list of Invariant Sections in the Modified Version's
+     license notice.  These titles must be distinct from any other
+     section titles.
+
+     You may add a section Entitled "Endorsements", provided it contains
+     nothing but endorsements of your Modified Version by various
+     parties--for example, statements of peer review or that the text
+     has been approved by an organization as the authoritative
+     definition of a standard.
+
+     You may add a passage of up to five words as a Front-Cover Text,
+     and a passage of up to 25 words as a Back-Cover Text, to the end of
+     the list of Cover Texts in the Modified Version.  Only one passage
+     of Front-Cover Text and one of Back-Cover Text may be added by (or
+     through arrangements made by) any one entity.  If the Document
+     already includes a cover text for the same cover, previously added
+     by you or by arrangement made by the same entity you are acting on
+     behalf of, you may not add another; but you may replace the old
+     one, on explicit permission from the previous publisher that added
+     the old one.
+
+     The author(s) and publisher(s) of the Document do not by this
+     License give permission to use their names for publicity for or to
+     assert or imply endorsement of any Modified Version.
+
+  5. COMBINING DOCUMENTS
+
+     You may combine the Document with other documents released under
+     this License, under the terms defined in section 4 above for
+     modified versions, provided that you include in the combination all
+     of the Invariant Sections of all of the original documents,
+     unmodified, and list them all as Invariant Sections of your
+     combined work in its license notice, and that you preserve all
+     their Warranty Disclaimers.
+
+     The combined work need only contain one copy of this License, and
+     multiple identical Invariant Sections may be replaced with a single
+     copy.  If there are multiple Invariant Sections with the same name
+     but different contents, make the title of each such section unique
+     by adding at the end of it, in parentheses, the name of the
+     original author or publisher of that section if known, or else a
+     unique number.  Make the same adjustment to the section titles in
+     the list of Invariant Sections in the license notice of the
+     combined work.
+
+     In the combination, you must combine any sections Entitled
+     "History" in the various original documents, forming one section
+     Entitled "History"; likewise combine any sections Entitled
+     "Acknowledgements", and any sections Entitled "Dedications".  You
+     must delete all sections Entitled "Endorsements."
+
+  6. COLLECTIONS OF DOCUMENTS
+
+     You may make a collection consisting of the Document and other
+     documents released under this License, and replace the individual
+     copies of this License in the various documents with a single copy
+     that is included in the collection, provided that you follow the
+     rules of this License for verbatim copying of each of the documents
+     in all other respects.
+
+     You may extract a single document from such a collection, and
+     distribute it individually under this License, provided you insert
+     a copy of this License into the extracted document, and follow this
+     License in all other respects regarding verbatim copying of that
+     document.
+
+  7. AGGREGATION WITH INDEPENDENT WORKS
+
+     A compilation of the Document or its derivatives with other
+     separate and independent documents or works, in or on a volume of a
+     storage or distribution medium, is called an "aggregate" if the
+     copyright resulting from the compilation is not used to limit the
+     legal rights of the compilation's users beyond what the individual
+     works permit.  When the Document is included in an aggregate, this
+     License does not apply to the other works in the aggregate which
+     are not themselves derivative works of the Document.
+
+     If the Cover Text requirement of section 3 is applicable to these
+     copies of the Document, then if the Document is less than one half
+     of the entire aggregate, the Document's Cover Texts may be placed
+     on covers that bracket the Document within the aggregate, or the
+     electronic equivalent of covers if the Document is in electronic
+     form.  Otherwise they must appear on printed covers that bracket
+     the whole aggregate.
+
+  8. TRANSLATION
+
+     Translation is considered a kind of modification, so you may
+     distribute translations of the Document under the terms of section
+     4.  Replacing Invariant Sections with translations requires special
+     permission from their copyright holders, but you may include
+     translations of some or all Invariant Sections in addition to the
+     original versions of these Invariant Sections.  You may include a
+     translation of this License, and all the license notices in the
+     Document, and any Warranty Disclaimers, provided that you also
+     include the original English version of this License and the
+     original versions of those notices and disclaimers.  In case of a
+     disagreement between the translation and the original version of
+     this License or a notice or disclaimer, the original version will
+     prevail.
+
+     If a section in the Document is Entitled "Acknowledgements",
+     "Dedications", or "History", the requirement (section 4) to
+     Preserve its Title (section 1) will typically require changing the
+     actual title.
+
+  9. TERMINATION
+
+     You may not copy, modify, sublicense, or distribute the Document
+     except as expressly provided under this License.  Any attempt
+     otherwise to copy, modify, sublicense, or distribute it is void,
+     and will automatically terminate your rights under this License.
+
+     However, if you cease all violation of this License, then your
+     license from a particular copyright holder is reinstated (a)
+     provisionally, unless and until the copyright holder explicitly and
+     finally terminates your license, and (b) permanently, if the
+     copyright holder fails to notify you of the violation by some
+     reasonable means prior to 60 days after the cessation.
+
+     Moreover, your license from a particular copyright holder is
+     reinstated permanently if the copyright holder notifies you of the
+     violation by some reasonable means, this is the first time you have
+     received notice of violation of this License (for any work) from
+     that copyright holder, and you cure the violation prior to 30 days
+     after your receipt of the notice.
+
+     Termination of your rights under this section does not terminate
+     the licenses of parties who have received copies or rights from you
+     under this License.  If your rights have been terminated and not
+     permanently reinstated, receipt of a copy of some or all of the
+     same material does not give you any rights to use it.
+
+  10. FUTURE REVISIONS OF THIS LICENSE
+
+     The Free Software Foundation may publish new, revised versions of
+     the GNU Free Documentation License from time to time.  Such new
+     versions will be similar in spirit to the present version, but may
+     differ in detail to address new problems or concerns.  See
+     <http://www.gnu.org/copyleft/>.
+
+     Each version of the License is given a distinguishing version
+     number.  If the Document specifies that a particular numbered
+     version of this License "or any later version" applies to it, you
+     have the option of following the terms and conditions either of
+     that specified version or of any later version that has been
+     published (not as a draft) by the Free Software Foundation.  If the
+     Document does not specify a version number of this License, you may
+     choose any version ever published (not as a draft) by the Free
+     Software Foundation.  If the Document specifies that a proxy can
+     decide which future versions of this License can be used, that
+     proxy's public statement of acceptance of a version permanently
+     authorizes you to choose that version for the Document.
+
+  11. RELICENSING
+
+     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
+     World Wide Web server that publishes copyrightable works and also
+     provides prominent facilities for anybody to edit those works.  A
+     public wiki that anybody can edit is an example of such a server.
+     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
+     site means any set of copyrightable works thus published on the MMC
+     site.
+
+     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
+     license published by Creative Commons Corporation, a not-for-profit
+     corporation with a principal place of business in San Francisco,
+     California, as well as future copyleft versions of that license
+     published by that same organization.
+
+     "Incorporate" means to publish or republish a Document, in whole or
+     in part, as part of another Document.
+
+     An MMC is "eligible for relicensing" if it is licensed under this
+     License, and if all works that were first published under this
+     License somewhere other than this MMC, and subsequently
+     incorporated in whole or in part into the MMC, (1) had no cover
+     texts or invariant sections, and (2) were thus incorporated prior
+     to November 1, 2008.
+
+     The operator of an MMC Site may republish an MMC contained in the
+     site under CC-BY-SA on the same site at any time before August 1,
+     2009, provided the MMC is eligible for relicensing.
+
+ADDENDUM: How to use this License for your documents
+====================================================
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and license
+notices just after the title page:
+
+       Copyright (C)  YEAR  YOUR NAME.
+       Permission is granted to copy, distribute and/or modify this document
+       under the terms of the GNU Free Documentation License, Version 1.3
+       or any later version published by the Free Software Foundation;
+       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+       Texts.  A copy of the license is included in the section entitled ``GNU
+       Free Documentation License''.
+
+   If you have Invariant Sections, Front-Cover Texts and Back-Cover
+Texts, replace the "with...Texts." line with this:
+
+         with the Invariant Sections being LIST THEIR TITLES, with
+         the Front-Cover Texts being LIST, and with the Back-Cover Texts
+         being LIST.
+
+   If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+
+   If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of free
+software license, such as the GNU General Public License, to permit
+their use in free software.
+
+&#x1f;
+File: groff.info,  Node: Request Index,  Next: Escape Sequence Index,  Prev: Copying This Manual,  Up: Top
+
+Appendix B Request Index
+************************
+
+Request names appear without a leading control character; the defaults
+are '.' for the regular control character and ''' for the no-break
+control character.
+
+&#x0;&#x8;index&#x0;&#x8;
+* Menu:
+
+* ab:                                    Debugging.           (line  55)
+* ad:                                    Manipulating Filling and Adjustment.
+                                                              (line  83)
+* af:                                    Assigning Register Formats.
+                                                              (line  12)
+* aln:                                   Setting Registers.   (line 110)
+* als:                                   Strings.             (line 198)
+* am:                                    Writing Macros.      (line 126)
+* am1:                                   Writing Macros.      (line 127)
+* ami:                                   Writing Macros.      (line 128)
+* ami1:                                  Writing Macros.      (line 129)
+* as:                                    Strings.             (line 114)
+* as1:                                   Strings.             (line 115)
+* asciify:                               Diversions.          (line 208)
+* backtrace:                             Debugging.           (line 104)
+* bd:                                    Artificial Fonts.    (line  95)
+* blm:                                   Blank Line Traps.    (line   7)
+* box:                                   Diversions.          (line  63)
+* boxa:                                  Diversions.          (line  64)
+* bp:                                    Page Control.        (line  11)
+* br:                                    Manipulating Filling and Adjustment.
+                                                              (line  39)
+* break:                                 while.               (line  72)
+* brp:                                   Manipulating Filling and Adjustment.
+                                                              (line 156)
+* c2:                                    Control Characters.  (line  29)
+* cc:                                    Control Characters.  (line  23)
+* ce:                                    Manipulating Filling and Adjustment.
+                                                              (line 208)
+* cf:                                    I/O.                 (line  58)
+* cflags:                                Using Symbols.       (line 252)
+* ch:                                    Page Location Traps. (line 114)
+* char:                                  Using Symbols.       (line 351)
+* chop:                                  Strings.             (line 145)
+* class:                                 Character Classes.   (line  12)
+* close:                                 I/O.                 (line 240)
+* color:                                 Colors.              (line  15)
+* composite:                             Using Symbols.       (line 208)
+* continue:                              while.               (line  76)
+* cp:                                    Compatibility Mode.  (line  16)
+* cs:                                    Artificial Fonts.    (line 125)
+* cu:                                    Artificial Fonts.    (line  86)
+* da:                                    Diversions.          (line  32)
+* de:                                    Writing Macros.      (line  14)
+* de1:                                   Writing Macros.      (line  86)
+* defcolor:                              Colors.              (line  27)
+* dei:                                   Writing Macros.      (line 108)
+* dei1:                                  Writing Macros.      (line 109)
+* device:                                Postprocessor Access.
+                                                              (line  15)
+* devicem:                               Postprocessor Access.
+                                                              (line  45)
+* di:                                    Diversions.          (line  31)
+* do:                                    Compatibility Mode.  (line  27)
+* ds:                                    ms Document Control Settings.
+                                                              (line  15)
+* ds <1>:                                Strings.             (line  24)
+* ds1:                                   Strings.             (line  25)
+* dt:                                    Diversion Traps.     (line  11)
+* ec:                                    Using Escape Sequences.
+                                                              (line  76)
+* ecr:                                   Using Escape Sequences.
+                                                              (line 102)
+* ecs:                                   Using Escape Sequences.
+                                                              (line 101)
+* el:                                    if-else.             (line   8)
+* em:                                    End-of-input Traps.  (line   7)
+* eo:                                    Using Escape Sequences.
+                                                              (line  71)
+* ev:                                    Environments.        (line  46)
+* evc:                                   Environments.        (line 100)
+* ex:                                    Debugging.           (line  60)
+* fam:                                   Font Families.       (line  21)
+* fc:                                    Fields.              (line  18)
+* fchar:                                 Using Symbols.       (line 352)
+* fcolor:                                Colors.              (line  85)
+* fi:                                    Manipulating Filling and Adjustment.
+                                                              (line  66)
+* fl:                                    Debugging.           (line  95)
+* fp:                                    Font Positions.      (line  16)
+* fschar:                                Using Symbols.       (line 353)
+* fspecial:                              Special Fonts.       (line  18)
+* ft:                                    Selecting Fonts.     (line  11)
+* ftr:                                   Selecting Fonts.     (line  69)
+* fzoom:                                 Selecting Fonts.     (line  83)
+* gcolor:                                Colors.              (line  57)
+* hc:                                    Manipulating Hyphenation.
+                                                              (line  88)
+* hcode:                                 Manipulating Hyphenation.
+                                                              (line 293)
+* hla:                                   Manipulating Hyphenation.
+                                                              (line 327)
+* hlm:                                   Manipulating Hyphenation.
+                                                              (line 340)
+* hpf:                                   Manipulating Hyphenation.
+                                                              (line 233)
+* hpfa:                                  Manipulating Hyphenation.
+                                                              (line 234)
+* hpfcode:                               Manipulating Hyphenation.
+                                                              (line 235)
+* hw:                                    Manipulating Hyphenation.
+                                                              (line  22)
+* hy:                                    Manipulating Hyphenation.
+                                                              (line 120)
+* hym:                                   Manipulating Hyphenation.
+                                                              (line 354)
+* hys:                                   Manipulating Hyphenation.
+                                                              (line 369)
+* ie:                                    if-else.             (line   7)
+* if:                                    if-then.             (line   7)
+* ig:                                    Comments.            (line  54)
+* in:                                    Line Layout.         (line  86)
+* it:                                    Input Line Traps.    (line   7)
+* itc:                                   Input Line Traps.    (line   8)
+* kern:                                  Ligatures and Kerning.
+                                                              (line  41)
+* lc:                                    Leaders.             (line  22)
+* length:                                Strings.             (line 135)
+* lf:                                    Debugging.           (line  31)
+* lg:                                    Ligatures and Kerning.
+                                                              (line  23)
+* linetabs:                              Tabs and Fields.     (line 139)
+* ll:                                    Line Layout.         (line 138)
+* ls:                                    Manipulating Spacing.
+                                                              (line  57)
+* lsm:                                   Leading Space Traps. (line   7)
+* lt:                                    Page Layout.         (line  53)
+* mc:                                    Miscellaneous.       (line 110)
+* mk:                                    Page Motions.        (line  10)
+* mso:                                   I/O.                 (line  49)
+* msoquiet:                              I/O.                 (line  50)
+* na:                                    Manipulating Filling and Adjustment.
+                                                              (line 150)
+* ne:                                    Page Control.        (line  31)
+* nf:                                    Manipulating Filling and Adjustment.
+                                                              (line  74)
+* nh:                                    Manipulating Hyphenation.
+                                                              (line 228)
+* nm:                                    Miscellaneous.       (line   9)
+* nn:                                    Miscellaneous.       (line  74)
+* nop:                                   if-then.             (line  26)
+* nr:                                    ms Document Control Settings.
+                                                              (line  11)
+* nr <1>:                                Setting Registers.   (line  10)
+* nr <2>:                                Setting Registers.   (line  64)
+* nr <3>:                                Auto-increment.      (line  14)
+* nroff:                                 troff and nroff Modes.
+                                                              (line  33)
+* ns:                                    Manipulating Spacing.
+                                                              (line 116)
+* nx:                                    I/O.                 (line  90)
+* open:                                  I/O.                 (line 207)
+* opena:                                 I/O.                 (line 208)
+* os:                                    Page Control.        (line  66)
+* output:                                Diversions.          (line 195)
+* pc:                                    Page Layout.         (line  68)
+* pev:                                   Debugging.           (line  78)
+* pi:                                    I/O.                 (line 149)
+* pl:                                    Page Layout.         (line   9)
+* pm:                                    Debugging.           (line  82)
+* pn:                                    Page Layout.         (line  23)
+* pnr:                                   Debugging.           (line  86)
+* po:                                    Line Layout.         (line  60)
+* ps:                                    Changing the Type Size.
+                                                              (line   7)
+* psbb:                                  Miscellaneous.       (line 158)
+* pso:                                   I/O.                 (line  38)
+* ptr:                                   Debugging.           (line  90)
+* pvs:                                   Changing the Vertical Spacing.
+                                                              (line  48)
+* rchar:                                 Using Symbols.       (line 410)
+* rd:                                    I/O.                 (line  95)
+* return:                                Writing Macros.      (line 163)
+* rfschar:                               Using Symbols.       (line 411)
+* rj:                                    Manipulating Filling and Adjustment.
+                                                              (line 247)
+* rm:                                    Strings.             (line 193)
+* rn:                                    Strings.             (line 190)
+* rnn:                                   Setting Registers.   (line 105)
+* rr:                                    Setting Registers.   (line  99)
+* rs:                                    Manipulating Spacing.
+                                                              (line 117)
+* rt:                                    Page Motions.        (line  11)
+* schar:                                 Using Symbols.       (line 354)
+* shc:                                   Manipulating Hyphenation.
+                                                              (line  97)
+* shift:                                 Parameters.          (line  30)
+* sizes:                                 Changing the Type Size.
+                                                              (line  71)
+* so:                                    I/O.                 (line   9)
+* soquiet:                               I/O.                 (line  10)
+* sp:                                    Manipulating Spacing.
+                                                              (line  10)
+* special:                               Special Fonts.       (line  17)
+* spreadwarn:                            Debugging.           (line 135)
+* ss:                                    Manipulating Filling and Adjustment.
+                                                              (line 267)
+* stringdown:                            Strings.             (line 170)
+* stringup:                              Strings.             (line 171)
+* sty:                                   Font Families.       (line  62)
+* substring:                             Strings.             (line 153)
+* sv:                                    Page Control.        (line  65)
+* sy:                                    I/O.                 (line 171)
+* ta:                                    Tabs and Fields.     (line  13)
+* tag:                                   Postprocessor Access.
+                                                              (line  58)
+* taga:                                  Postprocessor Access.
+                                                              (line  59)
+* tc:                                    Tabs and Fields.     (line 127)
+* ti:                                    Line Layout.         (line 110)
+* tkf:                                   Ligatures and Kerning.
+                                                              (line  60)
+* tl:                                    Page Layout.         (line  39)
+* tm:                                    Debugging.           (line  43)
+* tm1:                                   Debugging.           (line  44)
+* tmc:                                   Debugging.           (line  45)
+* tr:                                    Character Translations.
+                                                              (line  13)
+* trf:                                   I/O.                 (line  57)
+* trin:                                  Character Translations.
+                                                              (line  14)
+* trnt:                                  Character Translations.
+                                                              (line  79)
+* troff:                                 troff and nroff Modes.
+                                                              (line  25)
+* uf:                                    Artificial Fonts.    (line  90)
+* ul:                                    Artificial Fonts.    (line  64)
+* unformat:                              Diversions.          (line 233)
+* vpt:                                   Vertical Position Traps.
+                                                              (line  13)
+* vs:                                    Changing the Vertical Spacing.
+                                                              (line   7)
+* warn:                                  Debugging.           (line 154)
+* warnscale:                             Debugging.           (line 131)
+* wh:                                    Page Location Traps. (line  11)
+* while:                                 while.               (line  10)
+* write:                                 I/O.                 (line 219)
+* writec:                                I/O.                 (line 220)
+* writem:                                I/O.                 (line 231)
+

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.info-3 Added

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.pdf Added

_service:tar_scm:groff-1.22.4.tar.gz/doc/groff.texi -> _service:tar_scm:groff-1.23.0.tar.gz/doc/groff.texi Changed

@@ -4,7 +4,7 @@
 @c Please convert this manual with `texi2dvi -e groff.texi' due to
 @c problems in texinfo regarding expansion of user-defined macros.
 @c
-@c You need texinfo 4.8 or newer to format this document!
+@c You need texinfo 5.0 or newer to format this document!
 @c
 
 @c %**start of header (This is for running Texinfo on a region.)
@@ -24,21 +24,17 @@
 
 
 @copying
-This manual documents GNU @code{troff} version 1.22.4.
+This manual documents GNU @code{troff} version 1.23.0.
 
-Copyright @copyright{} 1994--2018 Free Software Foundation, Inc.
+Copyright @copyright{} 1994--2023 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3 or
 any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
-and with the Back-Cover Texts as in (a) below.  A copy of the license is
-included in the section entitled ``GNU Free Documentation License.''
-
-(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
-modify this GNU manual.  Buying copies from the FSF supports it in
-developing GNU and promoting software freedom.''
+Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
+copy of the license is included in the section entitled ``GNU Free
+Documentation License''.
 @end quotation
 @end copying
 
@@ -47,7 +43,7 @@
 @c
 @c   cindex: concepts
 @c   rqindex: requests
-@c   esindex: escapes
+@c   esindex: escape sequences
 @c   vindex: registers
 @c   kindex: commands in font files
 @c   pindex: programs and files
@@ -161,41 +157,41 @@
 @end macro
 
 
-@c definition of escapes
+@c definition of escape sequences
 
 @macro Defesc{name, delimI, arg, delimII}
-@deffn Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffn Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @esindex \name\
 @c
 @end macro
 
 @macro DefescList{name, delimI, arg, delimII}
-@deffn Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffn Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @defdummy
 @esindex \name\
 @c
 @end macro
 
 @macro DefescItem{name, delimI, arg, delimII}
-@deffnx Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffnx Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @defdummy
 @c
 @end macro
 
 @macro DefescItemx{name, delimI, arg, delimII}
-@deffnx Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffnx Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @defdummy
 @esindex \name\
 @c
 @end macro
 
 @macro DefescListEnd{name, delimI, arg, delimII}
-@deffnx Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffnx Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @c
 @end macro
 
 @macro DefescListEndx{name, delimI, arg, delimII}
-@deffnx Escape @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
+@deffnx Escape@tie{}sequence @t{\name\\delimI\}@Var{\arg\}@t{\delimII\}
 @esindex \name\
 @c
 @end macro
@@ -205,7 +201,7 @@
 @end macro
 
 
-@c definition of registers
+@c definition of registers (built in to GNU troff)
 
 @macro Defreg{name}
 @deffn Register @t{\\n\name\}
@@ -249,7 +245,51 @@
 @end macro
 
 
-@c definition of registers specific to macro packages, preprocessors, etc.
+@c string definitions (built in to GNU troff)
+
+@macro Defstr{name}
+@deffn String @t{\\*\name\}
+@stindex \name\
+@c
+@end macro
+
+@macro DefstrList{name}
+@deffn String @t{\\*\name\}
+@defdummy
+@stindex \name\
+@c
+@end macro
+
+@macro DefstrItem{name}
+@deffnx String @t{\\*\name\}
+@defdummy
+@c
+@end macro
+
+@macro DefstrItemx{name}
+@deffnx String @t{\\*\name\}
+@defdummy
+@stindex \name\
+@c
+@end macro
+
+@macro DefstrListEnd{name}
+@deffnx String @t{\\*\name\}
+@c
+@end macro
+
+@macro DefstrListEndx{name}
+@deffnx String @t{\\*\name\}
+@stindex \name\
+@c
+@end macro
+
+@macro endDefstr
+@end deffn
+@end macro
+
+
+@c register definitions specific to macro packages, preprocessors, ...
 
 @macro Defmpreg{name, package}
 @deffn Register @t{\\n\name\}
@@ -337,46 +377,46 @@
 @end macro
 
 
-@c definition of strings
+@c string definitions specific to macro packages, preprocessors, ...
 
-@macro Defstr{name, package}
+@macro Defmpstr{name, package}
 @deffn String @t{\\*\name\}
 @stindex \name\ @r{}\package\@r{}
 @c
 @end macro
 
-@macro DefstrList{name, package}
+@macro DefmpstrList{name, package}
 @deffn String @t{\\*\name\}
 @defdummy
 @stindex \name\ @r{}\package\@r{}
 @c
 @end macro
 
-@macro DefstrItem{name, package}
+@macro DefmpstrItem{name, package}
 @deffnx String @t{\\*\name\}
 @defdummy
 @c
 @end macro
 
-@macro DefstrItemx{name, package}
+@macro DefmpstrItemx{name, package}
 @deffnx String @t{\\*\name\}
 @defdummy
 @stindex \name\ @r{}\package\@r{}
 @c
 @end macro
 
-@macro DefstrListEnd{name, package}
+@macro DefmpstrListEnd{name, package}
 @deffnx String @t{\\*\name\}
 @c
 @end macro
 
-@macro DefstrListEndx{name, package}
+@macro DefmpstrListEndx{name, package}
 @deffnx String @t{\\*\name\}
 @stindex \name\ @r{}\package\@r{}
 @c
 @end macro
 
-@macro endDefstr
+@macro endDefmpstr
 @end deffn
 @end macro
 
@@ -404,150 +444,30 @@
 @end macro
 
 
-@c <text>
-
-@tex
-\gdef\Langlemacro{\angleleft}
-\gdef\Ranglemacro{\angleright}
-@end tex
-
-@iftex
-@set Langlemacro @Langlemacro
-@set Ranglemacro @Ranglemacro
-@end iftex
-
-@ifnottex
-@set Langlemacro <
-@set Ranglemacro >
-@end ifnottex
+@c Render text with angle brackets around it, as in <text>.
 
 @macro angles{text}
-@value{Langlemacro}@r{\text\}@value{Ranglemacro}
+@guilsinglleft{}@r{\text\}@guilsinglright{}
 @end macro
 
 
-@c a <= sign
-@c
-@c Since expansion of macros has changed between texinfo 4.x and 5.x,
-@c we can't define a macro but have to use @value directly.
-
-@tex
-\gdef\LE{\le}
-@end tex
-
-@iftex
-@set LE @LE
-@end iftex
-
-@ifnottex
-@set LE <=
-@end ifnottex
-
-
-@c Special care is required with parentheses, brackets, and braces:
-@c
-@c . Real parentheses in @deffn produce an error while compiling with
-@c   TeX.
-@c . Real brackets use the wrong font in @deffn, overriding @t{}.
-@c
-@c . @{ and @} fail with info if used in a macro.
-@c
-@c Since macros aren't expanded in @deffn during -E, the following
-@c definitions are for non-TeX only.
-@c
-@c This is true for texinfo 4.0 and above.
-
-@iftex
-@set Lparenmacro @lparen
-@set Rparenmacro @rparen
-@set Lbrackmacro @lbrack
-@set Rbrackmacro @rbrack
-@set Lbracemacro @{
-@set Rbracemacro @}
-@end iftex
-
-@ifnottex
-@set Lparenmacro (
-@set Rparenmacro )
-@set Lbrackmacro 
-@set Rbrackmacro 
-@set Lbracemacro @{
-@set Rbracemacro @}
-@end ifnottex
-
-@macro Lparen{}
-@value{Lparenmacro}
-@end macro
-@macro Rparen{}
-@value{Rparenmacro}
-@end macro
-@macro Lbrack{}
-@value{Lbrackmacro}
-@end macro
-@macro Rbrack{}
-@value{Rbrackmacro}
-@end macro
-@macro Lbrace{}
-@value{Lbracemacro}
-@end macro
-@macro Rbrace{}
-@value{Rbracemacro}
-@end macro
-
-
-@c This suppresses the word `Appendix' in the appendix headers.
-
-@tex
-\gdef\gobblefirst#1#2{#2}
-\gdef\putwordAppendix{\gobblefirst}
-@end tex
-
-
-@c We map some latin-1 characters to corresponding texinfo macros.
-@c Newer versions of texinfo.tex have similar code included already.
-
-@tex
-\global\catcode`^^e4\active % ä
-\gdef^^e4{\"a}
-\global\catcode`^^c4\active % Ä
-\gdef^^c4{\"A}
-\global\catcode`^^e9\active % é
-\gdef^^e9{\'e}
-\global\catcode`^^c9\active % É
-\gdef^^c9{\'E}
-\global\catcode`^^f6\active % ö
-\gdef^^f6{\"o}
-\global\catcode`^^d6\active % Ö
-\gdef^^d6{\"O}
-\global\catcode`^^fc\active % ü
-\gdef^^fc{\"u}
-\global\catcode`^^dc\active % Ü
-\gdef^^dc{\"U}
-\global\catcode`^^e6\active % æ
-\gdef^^e6{\ae}
-\global\catcode`^^c6\active % Æ
-\gdef^^c6{\AE}
-\global\catcode`^^df\active % ß
-\gdef^^df{\ss}
-@end tex
-
-
 @c Note: We say `Roman numerals' but `roman font'.
 
 
 @dircategory Typesetting
 @direntry
-* Groff: (groff).               The GNU troff document formatting system.
+* Groff: (groff).               The GNU roff document formatting system.
 @end direntry
 
 
 @titlepage
 @title groff
 @subtitle The GNU implementation of @code{troff}
-@subtitle Edition 1.22.4
-@subtitle Autumn 2018
-@author by Trent A.@tie{}Fisher
-@author and Werner Lemberg
+@subtitle Edition 1.23.0
+@subtitle June 2023
+@author Trent@tie{}A.@: Fisher
+@author Werner Lemberg
+@author G.@tie{}Branden Robinson
 
 @page
 @vskip 0pt plus 1filll
@@ -558,28 +478,24 @@
 
 @ifnottex
 @node Top, Introduction, (dir), (dir)
-@top GNU troff
+@top GNU @code{troff}
 @end ifnottex
 
 @menu
 * Introduction::
 * Invoking groff::
 * Tutorial for Macro Users::
-* Macro Packages::
-* gtroff Reference::
-* Preprocessors::
-* Output Devices::
-* File formats::
-* Installation::
+* Major Macro Packages::
+* GNU troff Reference::
+* File Formats::
 * Copying This Manual::
 * Request Index::
-* Escape Index::
+* Escape Sequence Index::
 * Operator Index::
 * Register Index::
 * Macro Index::
 * String Index::
-* Glyph Name Index::
-* Font File Keyword Index::
+* File Keyword Index::
 * Program and File Index::
 * Concept Index::
 @end menu
@@ -593,366 +509,315 @@
 @c =====================================================================
 @c =====================================================================
 
+@codequotebacktick on
+@codequoteundirected on
+
 @node Introduction, Invoking groff, Top, Top
 @chapter Introduction
 @cindex introduction
 
-GNU @code{troff} (or @code{groff}) is a system for typesetting
-documents.  @code{troff} is very flexible and has been used extensively
-for some thirty years.  It is well entrenched in the Unix community.
+GNU @code{roff} (or @code{groff}) is a programming system for
+typesetting documents.  It is highly flexible and has been used
+extensively for over thirty years.
 
 @menu
-* What Is groff?::
-* History::
-* groff Capabilities::
+* Background::
+* What Is @code{groff}?::
+* @code{groff} Capabilities::
 * Macro Package Intro::
 * Preprocessor Intro::
-* Output device intro::
+* Output Device Intro::
+* Conventions Used in This Manual::
+* Installation::
 * Credits::
 @end menu
 
 
 @c =====================================================================
 
-@node What Is groff?, History, Introduction, Introduction
-@section What Is @code{groff}?
-@cindex what is @code{groff}?
-@cindex @code{groff} -- what is it?
-
-@code{groff} belongs to an older generation of document preparation
-systems, which operate more like compilers than the more recent
-interactive @acronym{WYSIWYG}@footnote{What You See Is What You Get}
-systems.  @code{groff} and its contemporary counterpart, @TeX{}, both
-work using a @dfn{batch} paradigm: The input (or @dfn{source}) files are
-normal text files with embedded formatting commands.  These files can
-then be processed by @code{groff} to produce a typeset document on a
-variety of devices.
-
-@code{groff} should not be confused with a @dfn{word processor}, an
-integrated system of editor and text formatter.  Also, many word
-processors follow the @acronym{WYSIWYG} paradigm discussed earlier.
-
-Although @acronym{WYSIWYG} systems may be easier to use, they have a
-number of disadvantages compared to @code{troff}:
-
-@itemize @bullet
-@item
-They must be used on a graphics display to work on a document.
-
-@item
-Most of the @acronym{WYSIWYG} systems are either non-free or are not
-very portable.
-
-@item
-@code{troff} is firmly entrenched in all Unix systems.
-
-@item
-It is difficult to have a wide range of capabilities within the confines
-of a GUI/window system.
-
-@item
-It is more difficult to make global changes to a document.
-@end itemize
+@node Background, What Is @code{groff}?, Introduction, Introduction
+@section Background
+@cindex background
+
+M.@: Douglas McIlroy, formerly of AT&T Bell Laboratories and present at
+the creation of the Unix operating system, offers an authoritative
+historical summary.
 
 @quotation
-``GUIs normally make it simple to accomplish simple actions and
-impossible to accomplish complex actions.''  --Doug Gwyn (22/Jun/91 in
-@code{comp.unix.wizards})
+The prime reason for Unix was the desire of Ken Thompson, Dennis
+Ritchie, and Joe Ossanna to have a pleasant environment for software
+development.  The fig leaf that got the nod from @dots{}
+management was that an early use would be to develop a ``stand-alone''
+word-processing system for use in typing pools and secretarial offices.
+Perhaps they had in mind ``dedicated'', as distinct from
+``stand-alone''; that's what eventuated in various cases, most notably
+in the legal/patent department and in the AT&T CEO's office.
+
+Both those systems were targets of opportunity, not foreseen from the
+start.  When Unix was up and running on the PDP-11, Joe got wind of
+the legal department having installed a commercial word processor.
+He went to pitch Unix as an alternative and clinched a trial by
+promising to make @code{roff} able to number lines by tomorrow in order
+to fulfill a patent-office requirement that the commercial system did
+not support.
+
+Modems were installed so legal-department secretaries could try the
+Research machine.  They liked it and Joe's superb customer service.
+Soon the legal department got a system of their own.  Joe went on to
+create @code{nroff} and @code{troff}.  Document preparation became a
+widespread use of Unix, but no stand-alone word-processing system was
+ever undertaken.
 @end quotation
+@c https://minnie.tuhs.org/pipermail/tuhs/2022-March/025535.html
 
+A history relating @code{groff} to its predecessors @code{roff},
+@code{nroff}, and @code{troff} is available in the @cite{roff@r{(7)}}
+man page.
 
-@c =====================================================================
-
-@node History, groff Capabilities, What Is groff?, Introduction
-@section History
-@cindex history
-
-@cindex @code{RUNOFF}, the program
-@cindex @code{rf}, the program
-@code{troff} can trace its origins back to a formatting program called
-@code{RUNOFF}, written by Jerry Saltzer, which ran on the @acronym{CTSS}
-(@emph{Compatible Time Sharing System}, a project of MIT, the
-Massachusetts Institute of Technology) in the
-mid-sixties.@footnote{Jerome H.@: Saltzer, a grad student then, later a
-Professor of Electrical Engineering, now retired.  Saltzer's PhD thesis
-was the first application for @code{RUNOFF} and is available from the
-MIT Libraries.}  The name came from the use of the phrase ``run off a
-document'', meaning to print it out.
-@c
-@c Tom Van Vleck <thvv@multicians.org> writes about the following:
-@c
-@c I am not sure about this.. I think the BCPL runoff was the port to
-@c the 635 architecture, and that the order of events is
-@c 1. CTSS runoff
-@c 2. BCPL runoff on Multics
-@c 3. BCPL runoff on 635
-@c 4. rf on PDP-7
-@c
-Bob Morris ported it to the 635 architecture and called the program
-@code{roff} (an abbreviation of @code{runoff}).  It was rewritten as
-@code{rf} for the @w{PDP-7} (before having Unix), and at the
-same time (1969), Doug McIlroy rewrote an extended and simplified
-version of @code{roff} in the @acronym{BCPL} programming language.
-
-@cindex @code{roff}, the program
-In 1971, the Unix developers wanted to get a @w{PDP-11}, and to justify
-the cost, proposed the development of a document formatting system for
-the @acronym{AT&T} patents division.  This first formatting program was
-a reimplementation of McIlroy's @code{roff}, written by J.@tie{}F.@:
-Ossanna.
-
-@cindex @code{nroff}, the program
-When they needed a more flexible language, a new version of @code{roff}
-called @code{nroff} (``Newer @code{roff}'') was written.  It had a much
-more complicated syntax, but provided the basis for all future versions.
-When they got a Graphic Systems CAT Phototypesetter, Ossanna wrote a
-version of @code{nroff} that would drive it.  It was dubbed
-@code{troff}, for ``typesetter @code{roff}'', although many people have
-speculated that it actually means ``Times @code{roff}'' because of the
-use of the Times font family in @code{troff} by default.  As such, the
-name @code{troff} is pronounced `@w{t-roff}' rather than `trough'.
-
-With @code{troff} came @code{nroff} (they were actually the same program
-except for some @samp{#ifdef}s), which was for producing output for line
-printers and character terminals.  It understood everything @code{troff}
-did, and ignored the commands that were not applicable (e.g.@: font
-changes).
-
-Since there are several things that cannot be done easily in
-@code{troff}, work on several preprocessors began.  These programs would
-transform certain parts of a document into @code{troff}, which made a
-very natural use of pipes in Unix.
-
-The @code{eqn} preprocessor allowed mathematical formulae to be specified
-in a much simpler and more intuitive manner.  @code{tbl} is a
-preprocessor for formatting tables.  The @code{refer} preprocessor (and
-the similar program, @code{bib}) processes citations in a document
-according to a bibliographic database.
-
-Unfortunately, Ossanna's @code{troff} was written in @w{PDP-11} assembly
-language and produced output specifically for the CAT phototypesetter.
-He rewrote it in C, although it was now 7000@tie{}lines of uncommented
-code and still dependent on the CAT@.  As the CAT became less common, and
-was no longer supported by the manufacturer, the need to make it support
-other devices became a priority.  However, before this could be done,
-Ossanna died by a severe heart attack in a hospital while recovering
-from a previous one.
-
-@pindex ditroff
-@cindex @code{ditroff}, the program
-So, Brian Kernighan took on the task of rewriting @code{troff}.  The
-newly rewritten version produced device independent code that was very
-easy for postprocessors to read and translate to the appropriate printer
-codes.  Also, this new version of @code{troff} (called @code{ditroff}
-for ``device independent @code{troff}'') had several extensions, which
-included drawing functions.
-
-Due to the additional abilities of the new version of @code{troff},
-several new preprocessors appeared.  The @code{pic} preprocessor
-provides a wide range of drawing functions.  Likewise the @code{ideal}
-preprocessor did the same, although via a much different paradigm.  The
-@code{grap} preprocessor took specifications for graphs, but, unlike
-other preprocessors, produced @code{pic} code.
-
-James Clark began work on a GNU implementation of @code{ditroff} in
-early@tie{}1989.  The first version, @code{groff}@tie{}0.3.1, was
-released June@tie{}1990.  @code{groff} included:
-
-@itemize @bullet
-@item
-A replacement for @code{ditroff} with many extensions.
-
-@item
-The @code{soelim}, @code{pic}, @code{tbl}, and @code{eqn} preprocessors.
-
-@item
-Postprocessors for character devices, @sc{PostScript}, @TeX{} DVI, and
-X@tie{}Windows.  GNU @code{troff} also eliminated the need for a
-separate @code{nroff} program with a postprocessor that would produce
-@acronym{ASCII} output.
-
-@item
-A version of the @file{me} macros and an implementation of the
-@file{man} macros.
-@end itemize
-
-Also, a front-end was included that could construct the, sometimes
-painfully long, pipelines required for all the post- and preprocessors.
 
-Development of GNU @code{troff} progressed rapidly, and saw the
-additions of a replacement for @code{refer}, an implementation of the
-@file{ms} and @file{mm} macros, and a program to deduce how to format a
-document (@code{grog}).
+@c =====================================================================
 
-It was declared a stable (i.e.@: non-beta) package with the release of
-version@tie{}1.04 around November@tie{}1991.
+@node What Is @code{groff}?, @code{groff} Capabilities, Introduction, Introduction
+@section What Is @code{groff}?
+@cindex what is @code{groff}?
+@cindex @code{groff}---what is it?
 
-Beginning in@tie{}1999, @code{groff} has new maintainers (the package
-was an orphan for a few years).  As a result, new features and programs
-like @code{grn}, a preprocessor for gremlin images, and an output device
-to produce @acronym{HTML} and @acronym{XHTML} have been added.
+@c BEGIN Keep parallel with groff(1), section "Description" (after the
+@c first sentence).
+@c This language is slightly expanded from that in the "ANNOUNCE" file
+@c and on the groff home page.
+@code{groff} (GNU @code{roff}) is a typesetting system that reads plain
+text input files that include formatting commands to produce output in
+PostScript, PDF, HTML, DVI, or other formats, or for display to a
+terminal.  Formatting commands can be low-level typesetting primitives,
+macros from a supplied package, or user-defined macros.  All three
+approaches can be combined.
+
+A reimplementation and extension of the typesetter from @acronym{AT&T}
+Unix, @code{groff} is present on most @acronym{POSIX} systems owing to
+its long association with Unix manuals (including man pages).  It and
+its predecessor are notable for their production of several best-selling
+software engineering texts.  @code{groff} is capable of producing
+typographically sophisticated documents while consuming minimal system
+resources.
+@c END Keep parallel with groff(1), section "Description" (after the
+@c first sentence).
 
 
 @c =====================================================================
 
-@node groff Capabilities, Macro Package Intro, History, Introduction
+@node @code{groff} Capabilities, Macro Package Intro, What Is @code{groff}?, Introduction
 @section @code{groff} Capabilities
 @cindex @code{groff} capabilities
 @cindex capabilities of @code{groff}
 
-So what exactly is @code{groff} capable of doing?  @code{groff} provides
-a wide range of low-level text formatting operations.  Using these, it
-is possible to perform a wide range of formatting tasks, such as
-footnotes, table of contents, multiple columns, etc.  Here's a list of
-the most important operations supported by @code{groff}:
+GNU @code{troff} is a typesetting document formatter; it provides a wide
+range of low-level text and page operations within the framework of a
+programming language.  These operations compose to generate footnotes,
+tables of contents, mathematical equations, diagrams, multi-column text,
+and other elements of typeset works.  Here is a survey of formatter
+features; all are under precise user control.
 
 @itemize @bullet
 @item
-text filling, adjusting, and centering
-
-@item
-hyphenation
-
-@item
-page control
-
-@item
-font and glyph size control
-
-@item
-vertical spacing (e.g.@: double-spacing)
-
-@item
-line length and indenting
-
-@item
-macros, strings, diversions, and traps
-
-@item
-number registers
-
-@item
-tabs, leaders, and fields
-
-@item
-input and output conventions and character translation
+text filling, breaking, alignment to the left or right margin; centering
 
 @item
-overstrike, bracket, line drawing, and zero-width functions
+adjustment of inter-word space size to justify text, and of
+inter-sentence space size to suit local style conventions
 
 @item
-local horizontal and vertical motions and the width function
+automatic and manual determination of hyphenation break points
 
 @item
-three-part titles
+pagination
 
 @item
-output line numbering
+selection of any font available to the output device
 
 @item
-conditional acceptance of input
+adjustment of type size and vertical spacing (or ``leading'')
 
 @item
-environment switching
+configuration of line length and indentation amounts; columnation
 
 @item
-insertions from the standard input
+drawing of geometric primitives (lines, arcs, polygons, circles,
+@dots{})
 
 @item
-input/output file switching
+setup of stroke and fill colors (where supported by the output
+device)
 
 @item
-output and error messages
+embedding of hyperlinks, images, document metadata, and other inclusions
+(where supported by the output device)
 @end itemize
 
 
 @c =====================================================================
 
-@node Macro Package Intro, Preprocessor Intro, groff Capabilities, Introduction
+@node Macro Package Intro, Preprocessor Intro, @code{groff} Capabilities, Introduction
 @section Macro Packages
-@cindex macro packages
+@cindex macro package, introduction
+@cindex package, macro, introduction
 
-Since @code{groff} provides such low-level facilities, it can be quite
-difficult to use by itself.  However, @code{groff} provides a
-@dfn{macro} facility to specify how certain routine operations
-(e.g.@tie{}starting paragraphs, printing headers and footers, etc.)@:
-should be done.  These macros can be collected together into a
-@dfn{macro package}.  There are a number of macro packages available;
-the most common (and the ones described in this manual) are @file{man},
-@file{mdoc}, @file{me}, @file{ms}, and @file{mm}.
+Elemental typesetting functions can be be challenging to use directly
+with complex documents.  A @dfn{macro} facility specifies how certain
+routine operations, such as starting paragraphs, or printing headers and
+footers, should be performed in terms of those low-level instructions.
+Macros can be specific to one document or collected together into a
+@dfn{macro package} for use by many.  Several macro packages available;
+the most widely used are provided with @code{groff}.  They are
+@file{man}, @file{mdoc}, @file{me}, @file{mm}, @file{mom}, and
+@file{ms}.
 
 
 @c =====================================================================
 
-@node Preprocessor Intro, Output device intro, Macro Package Intro, Introduction
+@node Preprocessor Intro, Output Device Intro, Macro Package Intro, Introduction
 @section Preprocessors
 @cindex preprocessors
 
-Although @code{groff} provides most functions needed to format a
-document, some operations would be unwieldy (e.g.@: to draw pictures).
-Therefore, programs called @dfn{preprocessors} were written that
-understand their own language and produce the necessary @code{groff}
-operations.  These preprocessors are able to differentiate their own
-input from the rest of the document via markers.
-
-To use a preprocessor, Unix pipes are used to feed the output from the
-preprocessor into @code{groff}.  Any number of preprocessors may be used
-on a given document; in this case, the preprocessors are linked together
-into one pipeline.  However, with @code{groff}, the user does not need
-to construct the pipe, but only tell @code{groff} what preprocessors to
+An alternative approach to complexity management, particularly when
+constructing tables, setting mathematics, or drawing diagrams, lies in
+preprocessing.  A @dfn{preprocessor} employs a domian-specific language
+to ease the generation of tables, equations, and so forth in terms that
+are convenient for human entry.  Each preprocessor reads a document and
+translates the parts of it that apply to it into GNU @code{troff} input.
+Command-line options to @command{groff} tell it which preprocessors to
 use.
 
-@code{groff} currently has preprocessors for producing tables
-(@code{tbl}), typesetting equations (@code{eqn}), drawing pictures
-(@code{pic} and @code{grn}), processing bibliographies
-(@code{refer}), and drawing chemical structures (@code{chem}).  An
-associated program that is useful when dealing with preprocessors is
-@code{soelim}.
+@code{groff} provides preprocessors for laying out tables
+(@command{gtbl}), typesetting equations (@command{geqn}), drawing
+diagrams (@command{gpic} and @command{ggrn}), inserting bibliographic
+references (@command{grefer}), and drawing chemical structures
+(@command{gchem}).  An associated program that is useful when dealing
+with preprocessors is @command{gsoelim}.@footnote{The @samp{g} prefix is
+not used on all systems; see @ref{Invoking groff}.}
 
-A free implementation of @code{grap}, a preprocessor for drawing graphs,
-can be obtained as an extra package; @code{groff} can use @code{grap}
-also.
+@code{groff} also supports @code{grap}, a preprocessor for drawing
+graphs.  A free implementation of it can be obtained separately.
 
 Unique to @code{groff} is the @code{preconv} preprocessor that enables
-@code{groff} to handle documents in various input encodings.
+@code{groff} to handle documents in a variety of input encodings.
 
-There are other preprocessors in existence, but, unfortunately, no free
-implementations are available.  Among them is a preprocessor for drawing
-mathematical pictures (@code{ideal}).
+Other preprocessors exist, but no free implementations
+are known.  An example is @command{ideal}, which draws diagrams using a
+mathematical constraint language.
 
 
 @c =====================================================================
 
-@node Output device intro, Credits, Preprocessor Intro, Introduction
+@node Output Device Intro, Installation, Preprocessor Intro, Introduction
 @section Output Devices
 @cindex postprocessors
 @cindex output devices
 @cindex devices for output
 
-@code{groff} actually produces device independent code that may be fed
-into a postprocessor to produce output for a particular device.
-Currently, @code{groff} has postprocessors for @sc{PostScript} devices,
-character terminals, X@tie{}Windows (for previewing), @TeX{} DVI format,
-HP LaserJet@tie{}4 and Canon LBP printers (which use @acronym{CAPSL}),
-@acronym{HTML}, @acronym{XHTML}, and PDF.
+GNU @code{troff}'s output is in a device-independent page description
+language, which is then read by an @dfn{output driver} that translates
+this language into a file format or byte stream that a piece of
+(possibly emulated) hardware understands.  @code{groff} features output
+drivers for PostScript devices, terminal emulators (and other simple
+typewriter-like machines), X11 (for previewing), @TeX{} DVI, HP
+LaserJet@tie{}4/PCL5 and Canon LBP printers (which use @acronym{CaPSL}),
+@acronym{HTML}, @acronym{XHTML}, and @acronym{PDF}.
 
 
 @c =====================================================================
 
-@node Credits,  , Output device intro, Introduction
-@section Credits
-@cindex credits
+@node Installation, Conventions Used in This Manual, Output Device Intro, Introduction
+@section Installation
+@cindex installation
+
+Locate installation instructions in the files @file{INSTALL},
+@file{INSTALL.extra}, and @file{INSTALL.REPO} in the @code{groff} source
+distribution.  Being a GNU project, @code{groff} supports the familiar
+@samp{./configure && make} command sequence.
+
+
+@c =====================================================================
+
+@node Conventions Used in This Manual, Credits, Installation, Introduction
+@section Conventions Used in This Manual
+
+We apply the term ``groff'' to the language documented here, the GNU
+implementation of the overall system, the project that develops that
+system, and the command of that name.  In the first sense, @code{groff}
+is an extended dialect of the @code{roff} language, for which many
+similar implementations exist.
+
+The @code{roff} language features several major categories for which
+many items are predefined.  Presentations of these items feature the
+form in which the item is most commonly used on the left, and, aligned
+to the right margin, the name of the category in brackets.
+
+@deffn Register \nexample
+The register @samp{example} is one that that @code{groff} @emph{doesn't}
+predefine.  You can create it yourself, though; see @ref{Setting
+Registers}.
+@end deffn
+
+To make this document useful as a reference and not merely amiable
+bedtime reading, we tend to present these syntax items in exhaustive
+detail when they arise.  References to topics discussed later in the
+text are frequent; skip material you don't understand yet.
+
+We use Texinfo's ``result'' (@result{}) and @error{} notations to
+present output written to the standard output and standard error
+streams, respectively.  Diagnostic messages from the GNU @code{troff}
+formatter and other programs are examples of the latter, but the
+formatter can also be directed to write user-specified messages to the
+standard error stream.  The notation then serves to identify the
+output stream and does not necessarily mean that an error has
+occurred.@footnote{Unix and related operating systems distinguish
+standard output and standard error streams @emph{because} of
+@code{troff}:@:
+@uref{https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html}.}
+
+@Example
+$ echo "Twelve o'clock and" | groff -Tascii | sed '/^$/d'
+    @result{} Twelve o'clock and
+$ echo '.tm all is well.' | groff > /dev/null
+    @error{} all is well.
+@endExample
+
+Sometimes we use @result{} somewhat abstractly to represent formatted
+text that you will need to use a PostScript or PDF viewer program (or a
+printer) to observe.  While arguably an abuse of notation, we think this
+preferable to requiring the reader to understand the syntax of these
+page description languages.
+
+We also present diagnostic messages in an abbreviated form, often
+omitting the name of the program issuing them, the input file name, and
+line number or other positional information when such data do not serve
+to illuminate the topic under discussion.
+
+Most examples are of @code{roff} language input that would be placed in
+a text file.  Occasionally, we start an example with a @samp{$}
+character to indicate a shell prompt, as seen above.
+
+You are encouraged to try the examples yourself, and to alter them to
+better learn @code{groff}'s behavior.  Our examples frequently need to
+direct the formatter to set a line length (with @samp{.ll}) that will
+fit within the page margins of this manual.  We mention this so that you
+know why it is there before we discuss the @code{ll} request
+formally.@footnote{@xref{Line Layout}.}
 
-Large portions of this manual were taken from existing documents, most
-notably, the manual pages for the @code{groff} package by James Clark,
-and Eric Allman's papers on the @file{me} macro package.
-
-The section on the @file{man} macro package is partly based on
-Susan@tie{}G.@: Kleinmann's @file{groff_man} manual page written for the
-Debian GNU/Linux system.
 
-Larry Kollar contributed the section on the @file{ms} macro package.
+@c =====================================================================
+
+@node Credits,  , Conventions Used in This Manual, Introduction
+@section Credits
+@cindex credits
 
+We adapted portions of this manual from existing documents.  James
+Clark's man pages were an essential resource; we have updated them in
+parallel with the development of this manual.  We based the tutorial for
+macro users on Eric Allman's introduction to his @file{me} macro package
+(which we also provide, little altered from 4.4BSD).  Larry Kollar
+contributed much of the material on the @file{ms} macro package.
 
 
 @c =====================================================================
@@ -963,32 +828,34 @@
 @cindex invoking @code{groff}
 @cindex @code{groff} invocation
 
-This section focuses on how to invoke the @code{groff} front end.  This
+This chapter focuses on how to invoke the @code{groff} front end.  This
 front end takes care of the details of constructing the pipeline among
 the preprocessors, @code{gtroff} and the postprocessor.
 
 It has become a tradition that GNU programs get the prefix @samp{g} to
-distinguish it from its original counterparts provided by the host (see
-@ref{Environment}, for more details).  Thus, for example, @code{geqn} is
-GNU @code{eqn}.  On operating systems like GNU/Linux or the Hurd, which
+distinguish them from their original counterparts provided by the host
+(@pxref{Environment}).  Thus, for example, @code{geqn} is GNU
+@code{eqn}.  On operating systems like GNU/Linux or the Hurd, which
 don't contain proprietary versions of @code{troff}, and on
 MS-DOS/MS-Windows, where @code{troff} and associated programs are not
 available at all, this prefix is omitted since GNU @code{troff} is the
-only used incarnation of @code{troff}.  Exception: @samp{groff} is never
+only incarnation of @code{troff} used.  Exception: @samp{groff} is never
 replaced by @samp{roff}.
 
 In this document, we consequently say @samp{gtroff} when talking about
-the GNU @code{troff} program.  All other implementations of @code{troff}
-are called @acronym{AT&T} @code{troff}, which is the common origin of all
-@code{troff} derivates (with more or less compatible changes).
-Similarly, we say @samp{gpic}, @samp{geqn}, etc.
+the GNU @code{troff} program.  @c XXX: Not for much longer... -- GBR
+All other implementations of @code{troff} are called @acronym{AT&T}
+@code{troff}, which is the common origin of almost all @code{troff}
+implementations@footnote{Besides @code{groff}, @code{neatroff} is an
+exception.} (with more or less compatible changes).  Similarly, we say
+@samp{gpic}, @samp{geqn}, and so on.
 
 @menu
 * Groff Options::
 * Environment::
 * Macro Directories::
 * Font Directories::
-* Paper Size::
+* Paper Format::
 * Invocation Examples::
 @end menu
 
@@ -1017,15 +884,15 @@
 @code{geqn}, @code{gtbl}, @code{ggrn}, @code{grap}, @code{gchem},
 @code{grefer}, @code{gsoelim}, or @code{preconv}.
 
-This section only documents options to the @code{groff} front end.  Many
-of the arguments to @code{groff} are passed on to @code{gtroff},
-therefore those are also included.  Arguments to pre- or postprocessors
-can be found in @ref{Invoking gpic}, @ref{Invoking geqn}, @ref{Invoking
-gtbl}, @ref{Invoking ggrn}, @ref{Invoking grefer}, @ref{Invoking gchem},
-@ref{Invoking gsoelim}, @ref{Invoking preconv}, @ref{Invoking grotty},
-@ref{Invoking grops}, @ref{Invoking gropdf}, @ref{Invoking grohtml},
-@ref{Invoking grodvi}, @ref{Invoking grolj4}, @ref{Invoking grolbp}, and
-@ref{Invoking gxditview}.
+This section documents only options to the @code{groff} front end.  Many
+of the arguments to @code{groff} are passed on to @code{gtroff};
+therefore, those are also included.  Arguments to preprocessors and
+output drivers can be found in the man pages @cite{gpic@r{(1)}},
+@cite{geqn@r{(1)}}, @cite{gtbl@r{(1)}}, @cite{ggrn@r{(1)}},
+@cite{grefer@r{(1)}}, @cite{gchem@r{(1)}}, @cite{gsoelim@r{(1)}},
+@cite{preconv@r{(1)}}, @cite{grotty@r{(1)}}, @cite{grops@r{(1)}},
+@cite{gropdf@r{(1)}}, @cite{grohtml@r{(1)}}, @cite{grodvi@r{(1)}},
+@cite{grolj4@r{(1)}}, @cite{grolbp@r{(1)}}, and @cite{gxditview@r{(1)}}.
 
 The command-line format for @code{groff} is:
 
@@ -1052,195 +919,238 @@
 
 Options without an argument can be grouped behind a
 single@tie{}@option{-}.  A filename of@tie{}@file{-} denotes the
-standard input.  It is possible to have whitespace between an option and
-its parameter.
+standard input.  Whitespace is permitted between an option and its
+argument.
 
 The @code{grog} command can be used to guess the correct @code{groff}
-command to format a file.
+command to format a file.  See its man page @cite{grog@r{(1)}}; type
+@samp{man grog} at the command line to view it.
 
-Here's the description of the command-line options:
+@command{groff}'s command-line options are as follows.
 
 @cindex command-line options
 @table @samp
 @item -a
-@cindex @acronym{ASCII} approximation output register (@code{.A})
-Generate an @acronym{ASCII} approximation of the typeset output.  The
-read-only register @code{.A} is then set to@tie{}1.  @xref{Built-in
-Registers}.  A typical example is
+@cindex plain text approximation output register (@code{.A})
+Generate a plain text approximation of the typeset output.  The
+read-only register @code{.A} is set to@tie{}1.  @xref{Built-in
+Registers}.  This option produces a sort of abstract preview of the
+formatted output.
 
-@Example
-groff -a -man -Tdvi troff.man | less
-@endExample
+@itemize @bullet
+@item
+Page breaks are marked by a phrase in angle brackets; for example,
+@samp{<beginning of page>}.
 
-@noindent
-which shows how lines are broken for the DVI device.  Note that this
-option is rather useless today since graphic output devices are
-available virtually everywhere.
+@item
+Lines are broken where they would be in the formatted output.
+
+@item
+A horizontal motion of any size is represented as one space.  Adjacent
+horizontal motions are not combined.  Inter-sentence space nodes (those
+arising from the second argument to the @code{ss} request) are not
+represented.
+
+@item
+Vertical motions are not represented.
+
+@item
+Special characters are rendered in angle brackets; for example, the
+default soft hyphen character appears as @samp{<hy>}.
+@end itemize
+
+The above description should not be considered a specification; the
+details of @option{-a} output are subject to change.
 
 @item -b
-Print a backtrace with each warning or error message.  This backtrace
-should help track down the cause of the error.  The line numbers given
-in the backtrace may not always be correct: @code{gtroff} can get
-confused by @code{as} or @code{am} requests while counting line numbers.
+Write a backtrace reporting the state of @command{gtroff}'s input parser
+to the standard error stream with each diagnostic message.  The line
+numbers given in the backtrace might not always be correct, because
+@command{gtroff}'s idea of line numbers can be confused by requests that
+append to
+@c XXX: strings or (??? strings never contain newlines)
+macros.
 
 @item -c
-Suppress color output.
+Start with color output disabled.
 
 @item -C
-Enable compatibility mode.  @xref{Implementation Differences}, for the
-list of incompatibilities between @code{groff} and @acronym{AT&T}
-@code{troff}.
-
-@item -d@var{c}@var{s}
-@itemx -d@var{name}=@var{s}
-Define @var{c} or @var{name} to be a string@tie{}@var{s}.
-@var{c}@tie{}must be a one-letter name; @var{name} can be of arbitrary
-length.  All string assignments happen before loading any macro file
-(including the start-up file).
-
-@item -D@var{arg}
-Set default input encoding used by @code{preconv} to @var{arg}.  Implies
-@option{-k}.
+Enable AT&T @command{troff} compatibility mode; implies @option{-c}.
+@xref{Implementation Differences}, for the list of incompatibilities
+between @command{groff} and @acronym{AT&T} @command{troff}.
+
+@item -d@var{c}@var{text}
+@itemx -d@var{string}=@var{text}
+Define @code{roff} string @var{c} or @var{string} as@tie{}@var{t} or
+@var{text}.  @var{c}@tie{}must be one character; @var{string} can be
+of arbitrary length.  Such string assignments happen before any macro
+file is loaded, including the startup file.  Due to @code{getopt_long}
+limitations, @var{c}@tie{}cannot be, and @var{string} cannot contain, an
+equals sign, even though that is a valid character in a @code{roff}
+identifier.
+
+@item -D@var{enc}
+Set fallback input encoding used by @command{preconv} to @var{enc};
+implies @option{-k}.
 
 @item -e
-Preprocess with @code{geqn}.
+Run @command{geqn} preprocessor.
 
 @item -E
-Inhibit all error messages.
+Inhibit @command{gtroff} error messages.  This option does @emph{not}
+suppress messages sent to the standard error stream by documents or
+macro packages using @code{tm} or related requests.
 
 @item -f@var{fam}
 Use @var{fam} as the default font family.  @xref{Font Families}.
 
 @item -F@var{dir}
-Search @file{@var{dir}} for subdirectories @file{dev@var{name}}
-(@var{name} is the name of the device), for the @file{DESC} file, and
-for font files before looking in the standard directories (@pxref{Font
-Directories}).  This option is passed to all pre- and postprocessors
-using the @env{GROFF_FONT_PATH} environment variable.
+Search in directory @file{@var{dir}} for the selected output device's
+directory of device and font description files.  See the description of
+@env{GROFF_FONT_PATH} in @ref{Environment} below for the default search
+locations and ordering.
 
 @item -g
-Preprocess with @code{ggrn}.
+Run @command{ggrn} preprocessor.
 
 @item -G
-Preprocess with @code{grap}.  Implies @option{-p}.
+Run @command{grap} preprocessor; implies @option{-p}.
 
 @item -h
-Print a help message.
+Display a usage message and exit.
 
 @item -i
 Read the standard input after all the named input files have been
 processed.
 
 @item -I@var{dir}
-This option may be used to specify a directory to search for files.
-It is passed to the following programs:
+Search the directory @var{dir} for files named in several contexts;
+implies @option{-g} and @option{-s}.
 
 @itemize
 @item
-@code{gsoelim} (see @ref{gsoelim} for more details);
-it also implies @code{groff}'s @option{-s} option.
+@command{gsoelim} replaces @code{so} requests with the contents of their
+file name arguments.
 
 @item
-@code{gtroff}; it is used to search files named in the @code{psbb} and
-@code{so} requests.
+@command{gtroff} searches for files named as operands in its command
+line and as arguments to @code{psbb}, @code{so}, and @code{soquiet}
+requests.
 
 @item
-@code{grops}; it is used to search files named in the
-@w{@code{\X'ps: import}} and @w{@code{\X'ps: file}} escapes.
+Output drivers may search for files; for instance, @command{grops} looks
+for files named in @samp{\X'ps: import @r{@dots{}}'}, @samp{\X'ps: file
+@r{@dots{}}'}, and @samp{\X'pdf: pdfpic @r{@dots{}}'} device control
+escape sequences.
 @end itemize
 
-The current directory is always searched first.  This option may be
-specified more than once; the directories are searched in the order
-specified.  No directory search is performed for files specified using
-an absolute path.
+This option may be specified more than once; the directories are
+searched in the order specified.  If you want to search the current
+directory before others, add @samp{-I .} at the desired place.  The
+current working directory is otherwise searched last.  @option{-I} works
+similarly to, and is named for, the ``include'' option of Unix C
+compilers.
+
+@option{-I} options are passed to @command{gsoelim}, @command{gtroff},
+and output drivers; with the flag letter changed to @option{-M}, they
+are also passed to @command{ggrn}.
 
 @item -j
-Preprocess with @code{gchem}.  Implies @option{-p}.
+Run @command{gchem} preprocessor.  Implies @option{-p}.
 
 @item -k
-Preprocess with @code{preconv}.  This is run before any other
-preprocessor.  Please refer to @code{preconv}'s manual page for its
-behaviour if no @option{-K} (or @option{-D}) option is specified.
+Run @command{preconv} preprocessor.  Refer to its man page for its
+behavior if neither of @command{groff}'s @option{-K} or @option{-D}
+options is also specified.
 
-@item -K@var{arg}
-Set input encoding used by preconv to @var{arg}.  Implies @option{-k}.
+@item -K@var{enc}
+Set input encoding used by @command{preconv} to @var{enc}; implies
+@option{-k}.
 
 @item -l
-Send the output to a spooler for printing.  The command used for this is
-specified by the @code{print} command in the device description file
-(see @ref{Font Files}, for more info).  If not present, @option{-l} is
-ignored.
+Send the output to a spooler for printing.  The @code{print} directive
+in the device description file specifies the default command to be used;
+see @ref{Device and Font Description Files}.
+@c XXX: This document is not parameterized in configuration variables.
+@c If no such directive is present for the output device,
+@c .ie '@PSPRINT@'' \{\
+@c this option is ignored.
+@c .\}
+@c .el \{\
+@c output is piped to
+@c .MR @PSPRINT@ 1 .
+@c .\}
+See options @option{-L} and @option{-X}.
 
 @item -L@var{arg}
-Pass @var{arg} to the spooler.  Each argument should be passed with a
-separate @option{-L} option.  Note that @code{groff} does not prepend a
-@samp{-} to @var{arg} before passing it to the postprocessor.  If the
-@code{print} keyword in the device description file is missing,
-@option{-L} is ignored.
+Pass @var{arg} to the print spooler program.  If multiple @var{arg}s are
+required, pass each with a separate @option{-L} option.  @command{groff}
+does not prefix an option dash to @var{arg} before passing it to the
+spooler program.
 
 @item -m@var{name}
-Read in the file @file{@var{name}.tmac}.  Normally @code{groff} searches
-for this in its macro directories.  If it isn't found, it tries
-@file{tmac.@var{name}} (searching in the same directories).
+Process the file @file{@var{name}.tmac} prior to any input files.
+If not found, @file{tmac.@var{name}} is attempted.  @var{name}
+(in both arrangements) is presumed to be a macro file; see the
+description of @env{GROFF_TMAC_PATH} in @ref{Environment} below for the
+default search locations and ordering.  This option and its argument are
+also passed to @command{geqn}, @command{grap}, and @command{ggrn}.
 
 @item -M@var{dir}
-Search directory @file{@var{dir}} for macro files before the standard
-directories (@pxref{Macro Directories}).
+Search directory @file{@var{dir}} for macro files;  see the description
+of @env{GROFF_TMAC_PATH} in @ref{Environment} below for the default
+search locations and ordering.  This option and its argument are also
+passed to @command{geqn}, @command{grap}, and @command{ggrn}.
 
 @item -n@var{num}
 Number the first page @var{num}.
 
 @item -N
-Don't allow newlines with @code{eqn} delimiters.  This is the same as
-the @option{-N} option in @code{geqn}.
+Prohibit newlines between @code{eqn} delimiters:@: pass @option{-N} to
+@command{geqn}.
 
 @item -o@var{list}
 @cindex print current page register (@code{.P})
 Output only pages in @var{list}, which is a comma-separated list of page
-ranges; @samp{@var{n}} means print page@tie{}@var{n},
-@samp{@var{m}-@var{n}} means print every page between @var{m}
-and@tie{}@var{n}, @samp{-@var{n}} means print every page up
-to@tie{}@var{n}, @samp{@var{n}-} means print every page beginning
-with@tie{}@var{n}.  @code{gtroff} exits after printing the last page in
-the list.  All the ranges are inclusive on both ends.
-
-Within @code{gtroff}, this information can be extracted with the
-@samp{.P} register.  @xref{Built-in Registers}.
-
-If your document restarts page numbering at the beginning of each
-chapter, then @code{gtroff} prints the specified page range for each
-chapter.
+ranges; @samp{@var{n}} means page@tie{}@var{n}, @samp{@var{m}-@var{n}}
+means every page between @var{m} and@tie{}@var{n}, @samp{-@var{n}} means
+every page up to@tie{}@var{n}, @samp{@var{n}-} means every page from
+@var{n}@tie{}on.  @command{gtroff} stops processing and exits after
+formatting the last page enumerated in @var{list}.
 
 @item -p
-Preprocess with @code{gpic}.
+Run @command{gpic} preprocessor.
 
 @item -P@var{arg}
-Pass @var{arg} to the postprocessor.  Each argument should be passed
-with a separate @option{-P} option.  Note that @code{groff} does not
-prepend @samp{-} to @var{arg} before passing it to the postprocessor.
-
-@item -r@var{c}@var{n}
-@itemx -r@var{name}=@var{n}
-Set number register@tie{}@var{c} or @var{name} to the
-value@tie{}@var{n}.  @var{c}@tie{}must be a one-letter name; @var{name}
-can be of arbitrary length.  @var{n}@tie{}can be any @code{gtroff}
-numeric expression.  All register assignments happen before loading any
-macro file (including the start-up file).
+Pass @var{arg} to the postprocessor.  If multiple @var{arg}s are
+required, pass each with a separate @option{-P} option.  @command{groff}
+does not prefix an option dash to @var{arg} before passing it to the
+postprocessor.
+
+@item -r@var{c}@var{numeric-expression}
+@itemx -r@var{register}=@var{expr}
+Set @code{roff} register@tie{}@var{c} or @var{register} to the value
+@var{numeric-expression} (@pxref{Numeric Expressions}).
+@var{c}@tie{}must be one character; @var{register} can be of arbitrary
+length.  Such register assignments happen before any macro file is
+loaded, including the startup file.  Due to @code{getopt_long}
+limitations, @var{c}@tie{}cannot be, and @var{register} cannot contain,
+an equals sign, even though that is a valid character in a @code{roff}
+identifier.
 
 @item -R
-Preprocess with @code{grefer}.  No mechanism is provided for passing
-arguments to @code{grefer} because most @code{grefer} options have
-equivalent commands that can be included in the file.  @xref{grefer},
-for more details.
+Run @command{grefer} preprocessor.  No mechanism is provided for passing
+arguments to @command{grefer} because most @command{grefer} options have
+equivalent language elements that can be specified within the document.
 
 @pindex troffrc
 @pindex troffrc-end
-Note that @code{gtroff} also accepts a @option{-R} option, which is not
-accessible via @code{groff}.  This option prevents the loading of the
+@command{gtroff} also accepts a @option{-R} option, which is not
+accessible via @command{groff}.  This option prevents the loading of the
 @file{troffrc} and @file{troffrc-end} files.
 
 @item -s
-Preprocess with @code{gsoelim}.
+Run @command{gsoelim} preprocessor.
 
 @item -S
 @cindex @code{open} request, and safer mode
@@ -1250,24 +1160,24 @@
 @cindex @code{pi} request, and safer mode
 @cindex safer mode
 @cindex mode, safer
-Safer mode.  Pass the @option{-S} option to @code{gpic} and disable the
-@code{open}, @code{opena}, @code{pso}, @code{sy}, and @code{pi}
-requests.  For security reasons, this is enabled by default.
+Operate in ``safer'' mode; see @option{-U} below for its opposite.  For
+security reasons, safer mode is enabled by default.
 
 @item -t
-Preprocess with @code{gtbl}.
+Run @command{gtbl} preprocessor.
 
 @item -T@var{dev}
-Prepare output for device @var{dev}.  The default device is @samp{ps},
-unless changed when @code{groff} was configured and built.  The
-following are the output devices currently available:
+Direct @command{gtroff} to format the input for the output device
+@var{dev}.  @command{groff} then calls an output driver to convert
+@command{gtroff}'s output to a form appropriate for @var{dev}.  The
+following output devices are available.
 
 @table @code
 @item ps
-For @sc{PostScript} printers and previewers.
+For PostScript printers and previewers.
 
 @item pdf
-For PDF viewers or printers.
+For @acronym{PDF} viewers or printers.
 
 @item dvi
 For @TeX{} DVI format.
@@ -1276,54 +1186,58 @@
 For a 75@dmn{dpi} X11 previewer.
 
 @item X75-12
-For a 75@dmn{dpi} X11 previewer with a 12@dmn{pt} base font in the
+For a 75@dmn{dpi} X11 previewer with a 12-point base font in the
 document.
 
 @item X100
 For a 100@dmn{dpi} X11 previewer.
 
 @item X100-12
-For a 100@dmn{dpi} X11 previewer with a 12@dmn{pt} base font in the
+For a 100@dmn{dpi} X11 previewer with a 12-point base font in the
 document.
 
 @item ascii
 @cindex encoding, output, @acronym{ASCII}
-@cindex @acronym{ASCII}, output encoding
+@cindex encoding, output, ISO@tie{}646
+@cindex @acronym{ASCII} output encoding
+@cindex ISO@tie{}646 output encoding
 @cindex output encoding, @acronym{ASCII}
+@cindex output encoding, ISO@tie{}646
 For typewriter-like devices using the (7-bit) @acronym{ASCII}
-character set.
+(ISO@tie{}646) character set.
 
 @item latin1
-@cindex encoding, output, @w{latin-1} (ISO @w{8859-1})
-@cindex @w{latin-1} (ISO @w{8859-1}), output encoding
-@cindex ISO @w{8859-1} (@w{latin-1}), output encoding
-@cindex output encoding, @w{latin-1} (ISO @w{8859-1})
+@cindex encoding, output, @w{Latin-1} (ISO @w{8859-1})
+@cindex @w{Latin-1} (ISO @w{8859-1}) output encoding
+@cindex ISO @w{8859-1} (@w{Latin-1}) output encoding
+@cindex output encoding, @w{Latin-1} (ISO @w{8859-1})
 For typewriter-like devices that support the @w{Latin-1}
 (ISO@tie{}@w{8859-1}) character set.
 
 @item utf8
-@cindex encoding, output, @w{utf-8}
-@cindex @w{utf-8}, output encoding
-@cindex output encoding, @w{utf-8}
+@cindex encoding, output, @w{UTF-8}
+@cindex @w{UTF-8} output encoding
+@cindex output encoding, @w{UTF-8}
 For typewriter-like devices that use the Unicode (ISO@tie{}10646)
 character set with @w{UTF-8} encoding.
 
 @item cp1047
 @cindex encoding, output, @acronym{EBCDIC}
-@cindex @acronym{EBCDIC}, output encoding
+@cindex @acronym{EBCDIC} output encoding
 @cindex output encoding, @acronym{EBCDIC}
-@cindex encoding, output, cp1047
-@cindex cp1047, output encoding
-@cindex output encoding, cp1047
-@cindex IBM cp1047 output encoding
+@cindex encoding, output, code page 1047
+@cindex code page 1047 output encoding
+@cindex output encoding, code page 1047
+@cindex IBM code page 1047 output encoding
+@cindex CCSID 1047 output encoding (EBCDIC)
 For typewriter-like devices that use the @acronym{EBCDIC} encoding IBM
-cp1047.
+code page 1047.
 
 @item lj4
 For HP LaserJet4-compatible (or other PCL5-compatible) printers.
 
 @item lbp
-For Canon @acronym{CAPSL} printers (@w{LBP-4} and @w{LBP-8} series laser
+For Canon @acronym{CaPSL} printers (@w{LBP-4} and @w{LBP-8} series laser
 printers).
 
 @pindex pre-grohtml
@@ -1332,58 +1246,67 @@
 @item html
 @itemx xhtml
 To produce @acronym{HTML} and @acronym{XHTML} output, respectively.
-Note that this driver consists of two parts, a preprocessor
-(@code{pre-grohtml}) and a postprocessor (@code{post-grohtml}).
+This driver consists of two parts, a preprocessor
+(@command{pre-grohtml}) and a postprocessor (@command{post-grohtml}).
 @end table
 
-@cindex output device name string register (@code{.T})
-@cindex output device usage number register (@code{.T})
-The predefined @code{gtroff} string register @code{.T} contains the
-current output device; the read-only number register @code{.T} is set
-to@tie{}1 if this option is used (which is always true if @code{groff}
-is used to call @code{gtroff}).  @xref{Built-in Registers}.
+@cindex output device name string (@code{.T})
+@cindex output device usage register (@code{.T})
+The predefined GNU @code{troff} string @code{.T} contains the name of
+the output device; the read-only register @code{.T} is set to@tie{}1 if
+this option is used (which is always true if @command{groff} is used to
+call GNU @command{troff}).  @xref{Built-in Registers}.
 
 The postprocessor to be used for a device is specified by the
-@code{postpro} command in the device description file.  (@xref{Font
-Files}, for more info.)  This can be overridden with the @option{-X}
-option.
+@code{postpro} command in the device description file.  (@xref{Device
+and Font Description Files}.)  This can be overridden with the
+@option{-X} option.
 
 @item -U
 @cindex mode, unsafe
 @cindex unsafe mode
-Unsafe mode.  This enables the @code{open}, @code{opena}, @code{pso},
-@code{sy}, and @code{pi} requests.
-
-@item -w@var{name}
-Enable warning @var{name}.  Available warnings are described in
-@ref{Debugging}.  Multiple @option{-w} options are allowed.
-
-@item -W@var{name}
-Inhibit warning @var{name}.  Multiple @option{-W} options are allowed.
+Operate in @dfn{unsafe mode}, which enables the @code{open},
+@code{opena}, @code{pi}, @code{pso}, and @code{sy} requests.  These
+requests are disabled by default because they allow an untrusted input
+document to write to arbitrary file names and run arbitrary commands.
+This option also adds the current directory to the macro package search
+path; see the @option{-m} option above.  @option{-U} is passed to
+@command{gpic} and @command{gtroff}.
 
 @item -v
-Make programs run by @code{groff} print out their version number.
+Write version information for @command{groff} and all programs run by it
+to the standard output stream; that is, the given command line is
+processed in the usual way, passing @option{-v} to the formatter and any
+pre- or postprocessors invoked.
 
 @item -V
-Print the pipeline on @code{stdout} instead of executing it.  If
-specified more than once, print the pipeline on @code{stderr} and
-execute it.
+Output the pipeline that would be run by @command{groff}
+(as a wrapper program) to the standard output stream, but do not execute
+it.  If given more than once, the pipeline is both written to the
+standard error stream and run.
+
+@item -w@var{category}
+Enable warnings in @var{category}.  Categories are listed in
+@ref{Warnings}.
+
+@item -W@var{category}
+Inhibit warnings in @var{category}.  Categories are listed in
+@ref{Warnings}.
 
 @item -X
-Preview with @code{gxditview} instead of using the usual postprocessor.
-This is unlikely to produce good results except with @option{-Tps}.
-
-Note that this is not the same as using @option{-TX75} or
-@option{-TX100} to view a document with @code{gxditview}: The former
-uses the metrics of the specified device, whereas the latter uses
-X-specific fonts and metrics.
+Use @command{gxditview} instead of the usual postprocessor to (pre)view
+a document on an X11 display.  Combining this option with
+@option{-Tps} uses the font metrics of the PostScript device, whereas
+the @option{-TX75} and @option{-TX100} options use the metrics of X11
+fonts.
 
 @item -z
-Suppress output from @code{gtroff}.  Only error messages are printed.
+Suppress formatted output from @command{gtroff}.
 
 @item -Z
-Do not postprocess the output of @code{gtroff}.  Normally @code{groff}
-automatically runs the appropriate postprocessor.
+Disable postprocessing.  @command{gtroff} output will appear on the
+standard output stream (unless suppressed with @option{-z}; see
+@ref{gtroff Output} for a description of this format.
 @end table
 
 
@@ -1407,37 +1330,44 @@
 @tindex GROFF_COMMAND_PREFIX@r{, environment variable}
 @cindex command prefix
 @cindex prefix, for commands
-If this is set to@tie{}@var{X}, then @code{groff} runs
-@code{@var{X}troff} instead of @code{gtroff}.  This also applies to
-@code{tbl}, @code{pic}, @code{eqn}, @code{grn}, @code{chem},
-@code{refer}, and @code{soelim}.  It does not apply to @code{grops},
-@code{grodvi}, @code{grotty}, @code{pre-grohtml}, @code{post-grohtml},
-@code{preconv}, @code{grolj4}, @code{gropdf}, and @code{gxditview}.
+If this is set to@tie{}@var{X}, then @command{groff} runs
+@command{@var{X}troff} instead of @command{gtroff}.  This also applies
+to @command{tbl}, @command{pic}, @command{eqn}, @command{grn},
+@command{chem}, @command{refer}, and @command{soelim}.  It does not
+apply to @command{grops}, @command{grodvi}, @command{grotty},
+@command{pre-grohtml}, @command{post-grohtml}, @command{preconv},
+@command{grolj4}, @command{gropdf}, and @command{gxditview}.
 
 The default command prefix is determined during the installation
-process.  If a non-GNU troff system is found, prefix @samp{g} is used,
-none otherwise.
+process.  If a non-GNU @code{troff} system is found, prefix @samp{g} is
+used, none otherwise.
 
 @item GROFF_ENCODING
 @tindex GROFF_ENCODING@r{, environment variable}
-The value of this environment value is passed to the @code{preconv}
-preprocessor to select the encoding of input files.  Setting this option
-implies @code{groff}'s command-line option @option{-k} (that is,
-@code{groff} actually always calls @code{preconv}).  If set without a
-value, @code{groff} calls @code{preconv} without arguments.  An explicit
-@option{-K} command-line option overrides the value of
-@env{GROFF_ENCODING}.  See the manual page of @code{preconv} for details.
+The value of this variable is passed to the @code{preconv}
+preprocessor's @option{-e} option to select the character encoding of
+input files.  This variable's existence implies the @code{groff} option
+@option{-k}.  If set but empty, @code{groff} calls @code{preconv}
+without an @option{-e} option.  @code{groff}'s @option{-K} option
+overrides @env{GROFF_ENCODING}.  See the @cite{preconv@r{(7)}} man page;
+type @samp{man preconv} at the command line to view it.
 
 @item GROFF_FONT_PATH
 @tindex GROFF_FONT_PATH@r{, environment variable}
-A colon-separated list of directories in which to search for the
-@code{dev}@var{name} directory (before the default directories are
-tried).  @xref{Font Directories}.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.  GNU @code{troff}
+will search directories given as arguments to any specified @option{-F}
+options before these, and a built-in list of directories after them.
+@xref{Font Directories} and the @cite{troff@r{(1)}} or
+@cite{gtroff@r{(1)}} man pages.
 
 @item GROFF_TMAC_PATH
 @tindex GROFF_TMAC_PATH@r{, environment variable}
-A colon-separated list of directories in which to search for macro files
-(before the default directories are tried).  @xref{Macro Directories}.
+A list of directories in which to seek macro files.  GNU @code{troff}
+will search directories given as arguments to any specified @option{-M}
+options before these, and a built-in list of directories after them.
+@xref{Macro Directories} and the @cite{troff@r{(1)}} or
+@cite{gtroff@r{(1)}} man pages.
 
 @item GROFF_TMPDIR
 @tindex GROFF_TMPDIR@r{, environment variable}
@@ -1451,18 +1381,27 @@
 
 @item GROFF_TYPESETTER
 @tindex GROFF_TYPESETTER@r{, environment variable}
-The default output device.
+Sets the default output device.  If empty or not set, a build-time
+default (often @code{ps}) is used.  The @option{-T@var{dev}} option
+overrides @env{GROFF_TYPESETTER}.
 
 @item SOURCE_DATE_EPOCH
 @tindex SOURCE_DATE_EPOCH@r{, environment variable}
-A timestamp (expressed as seconds since the Unix epoch) to use in place of
-the current time when initializing time-based built-in registers such as
-@code{\nseconds}.
+A timestamp (expressed as seconds since the Unix epoch) to use as the
+output creation timestamp in place of the current time.  The time is
+converted to human-readable form using @cite{localtime@r{(3)}} when the
+formatter starts up and stored in registers usable by documents and
+macro packages (@pxref{Built-in Registers}).
+
+@item TZ
+@tindex TZ@r{, environment variable}
+The time zone to use when converting the current time (or value of
+@env{SOURCE_DATE_EPOCH}) to human-readable form; see
+@cite{tzset@r{(3)}}.
 @end table
 
-Note that MS-DOS and MS-Windows ports of @code{groff} use semi-colons,
-rather than colons, to separate the directories in the lists described
-above.
+MS-DOS and MS-Windows ports of @code{groff} use semicolons, rather than
+colons, to separate the directories in the lists described above.
 
 
 @c =====================================================================
@@ -1474,31 +1413,32 @@
 @cindex searching macros
 @cindex macros, searching
 
-All macro file names must be named @code{@var{name}.tmac} or
-@code{tmac.@var{name}} to make the @option{-m@var{name}} command-line
-option work.  The @code{mso} request doesn't have this restriction; any
-file name can be used, and @code{gtroff} won't try to append or prepend
-the @samp{tmac} string.
-
+A macro file must have a name in the form @code{@var{name}.tmac} or
+@code{tmac.@var{name}} and be placed in a @dfn{tmac directory} to be
+found by the @option{-m@var{name}} command-line option.@footnote{The
+@code{mso} request does not have these limitations.  @xref{I/O}.}
 @cindex tmac, directory
 @cindex directory, for tmac files
 @cindex tmac, path
 @cindex path, for tmac files
-@cindex searching macro files
-@cindex macro files, searching
-@cindex files, macro, searching
-Macro files are kept in the @dfn{tmac directories}, all of which
-constitute the @dfn{tmac path}.  The elements of the search path for
-macro files are (in that order):
+@cindex locating macro files
+@cindex macro file search path
+@cindex file, macro, search path
+@cindex locating macro packages
+@cindex macro package search path
+@cindex package, macro, search path
+Together, these directories constitute the @dfn{tmac path}.  Each
+directory is searched in the following order until the desired macro
+file is found or the list is exhausted.
 
 @itemize @bullet
 @item
-The directories specified with @code{gtroff}'s or @code{groff}'s
+Directories specified with GNU @code{troff}'s or @code{groff}'s
 @option{-M} command-line option.
 
 @item
 @tindex GROFF_TMAC_PATH@r{, environment variable}
-The directories given in the @env{GROFF_TMAC_PATH} environment variable.
+Directories listed in the @env{GROFF_TMAC_PATH} environment variable.
 
 @item
 @cindex safer mode
@@ -1507,251 +1447,235 @@
 @cindex mode, unsafe
 @cindex current directory
 @cindex directory, current
-The current directory (only if in unsafe mode using the @option{-U}
-command-line switch).
+The current working directory (only if in unsafe mode using the
+@option{-U} command-line option).
 
 @item
 @cindex home directory
 @cindex directory, home
-The home directory.
+The user's home directory, @env{HOME}.
 
 @item
-@cindex site-specific directory
-@cindex directory, site-specific
+@cindex site-local directory
+@cindex directory, site-local
 @cindex platform-specific directory
 @cindex directory, platform-specific
-A platform-dependent directory, a site-specific (platform-independent)
-directory, and the main tmac directory; the default locations are
+A platform-dependent directory, a site-local (platform-independent)
+directory, and the main @slanted{tmac} directory.  The locations
+corresponding to your installation are listed in section ``Environment''
+of @cite{gtroff@r{(1)}}.  If not otherwise configured, they are as
+follows.
 
 @Example
 /usr/local/lib/groff/site-tmac
 /usr/local/share/groff/site-tmac
-/usr/local/share/groff/1.22.3/tmac
+/usr/local/share/groff/1.23.0/tmac
 @endExample
 
 @noindent
-assuming that the version of @code{groff} is 1.22.3, and the
-installation prefix was @file{/usr/local}.  It is possible to fine-tune
-those directories during the installation process.
+The foregoing assumes that the version of @code{groff} is 1.23.0, and
+that the installation prefix was @file{/usr/local}.  It is possible to
+fine-tune these locations during the source configuration process.
 @end itemize
 
 
 @c =====================================================================
 
-@node Font Directories, Paper Size, Macro Directories, Invoking groff
+@node Font Directories, Paper Format, Macro Directories, Invoking groff
 @section Font Directories
 @cindex font directories
 @cindex directories for fonts
 @cindex searching fonts
 @cindex fonts, searching
 
-Basically, there is no restriction how font files for @code{groff} are
-named and how long font names are; however, to make the font family
-mechanism work (@pxref{Font Families}), fonts within a family should
-start with the family name, followed by the shape.  For example, the
-Times family uses @samp{T} for the family name and @samp{R}, @samp{B},
-@samp{I}, and @samp{BI} to indicate the shapes `roman', `bold',
-`italic', and `bold italic', respectively.  Thus the final font names
-are @samp{TR}, @samp{TB}, @samp{TI}, and @samp{TBI}.
+@code{groff} enforces few restrictions on how font description files are
+named.  For its family/style mechanism to work (@pxref{Font Families}),
+the names of fonts within a family should start with the family name,
+followed by the style.  For example, the Times family uses @samp{T} for
+the family name and @samp{R}, @samp{B}, @samp{I}, and @samp{BI} to
+indicate the styles `roman', `bold', `italic', and `bold italic',
+respectively.  Thus the final font names are @samp{TR}, @samp{TB},
+@samp{TI}, and @samp{TBI}.
 
 @cindex font path
 @cindex path, for font files
-All font files are kept in the @dfn{font directories}, which constitute
-the @dfn{font path}.  The file search functions always append the
-directory @code{dev}@var{name}, where @var{name} is the name of the
-output device.  Assuming, say, DVI output, and @file{/foo/bar} as a font
-directory, the font files for @code{grodvi} must be in
-@file{/foo/bar/devdvi}.
-
-The elements of the search path for font files are (in that order):
+Font description files are kept in @dfn{font directories}, which
+together constitute the @dfn{font path}.  The search procedure
+always appends the directory @code{dev}@var{name}, where @var{name} is
+the name of the output device.  Assuming @TeX{} DVI output, and
+@file{/foo/bar} as a font directory, the font description files for
+@command{grodvi} must be in @file{/foo/bar/devdvi}.
+Each directory in the font path is searched in the following order until
+the desired font description file is found or the list is exhausted.
 
 @itemize @bullet
 @item
-The directories specified with @code{gtroff}'s or @code{groff}'s
-@option{-F} command-line option.  All device drivers and some
-preprocessors also have this option.
+Directories specified with GNU @code{troff}'s or @code{groff}'s
+@option{-f} command-line option.  All output drivers (and some
+preprocessors) support this option as well, because they require
+information about the glyphs to be rendered in the document.
 
 @item
 @tindex GROFF_FONT_PATH@r{, environment variable}
-The directories given in the @env{GROFF_FONT_PATH} environment variable.
+Directories listed in the @env{GROFF_FONT_PATH} environment variable.
 
 @item
-@cindex site-specific directory
-@cindex directory, site-specific
-A site-specific directory and the main font directory; the default
-locations are
+@cindex site-local directory
+@cindex directory, site-local
+A site-local directory and the main font description directory.
+The locations corresponding to your installation are listed in section
+``Environment'' of @cite{gtroff@r{(1)}}.  If not otherwise configured,
+they are as follows.
 
 @Example
 /usr/local/share/groff/site-font
-/usr/local/share/groff/1.22.3/font
+/usr/local/share/groff/1.23.0/font
 @endExample
 
 @noindent
-assuming that the version of @code{groff} is 1.22.3, and the
-installation prefix was @file{/usr/local}.  It is possible to fine-tune
-those directories during the installation process.
+The foregoing assumes that the version of @code{groff} is 1.23.0, and
+that the installation prefix was @file{/usr/local}.  It is possible to
+fine-tune these locations during the source configuration process.
 @end itemize
 
 
 @c =====================================================================
 
-@node Paper Size, Invocation Examples, Font Directories, Invoking groff
-@section Paper Size
+@node Paper Format, Invocation Examples, Font Directories, Invoking groff
+@section Paper Format
+@cindex paper format
+@cindex format, paper
 @cindex paper size
 @cindex size, paper
 @cindex landscape page orientation
 @cindex orientation, landscape
 @cindex page orientation, landscape
 
-In groff, the page size for @code{gtroff} and for output devices are
-handled separately.  @xref{Page Layout}, for vertical manipulation of
-the page size.  @xref{Line Layout}, for horizontal changes.
-
-A default paper size can be set in the device's @file{DESC} file.  Most
-output devices also have a command-line option @option{-p} to override
-the default paper size and option @option{-l} to use landscape
-orientation.  @xref{DESC File Format}, for a description of the
-@code{papersize} keyword, which takes the same argument as @option{-p}.
-
+In @code{groff}, the page dimensions for the formatter GNU @code{troff}
+and for output devices are handled separately.  @xref{Page Layout}, for
+vertical manipulation of the page size, and @xref{Line Layout}, for
+horizontal changes.
 @pindex papersize.tmac
 @pindex troffrc
-A convenient shorthand to set a particular paper size for @code{gtroff}
-is command-line option @option{-dpaper=@var{size}}.  This defines string
-@code{paper}, which is processed in file @file{papersize.tmac} (loaded in
-the start-up file @file{troffrc} by default).  Possible values for
-@var{size} are the same as the predefined values for the
-@code{papersize} keyword (but only in lowercase) except
-@code{a7}--@code{d7}.  An appended @samp{l} (ell) character denotes
-landscape orientation.
-
-For example, use the following for PS output on A4 paper in landscape
-orientation:
+The @file{papersize} macro package, normally loaded by @file{troffrc} at
+startup, provides an interface for configuring page dimensions by
+convenient names, like @samp{letter} or @samp{a4}; see
+@cite{groff_tmac@r{(5)}}.  The default used by the formatter depends on
+its build configuration, but is usually one of the foregoing, as
+geographically appropriate.
+@c groff(1), being generated, says what the default is.
+
+It is up to each macro package to respect the page dimensions configured
+in this way.
+
+For each output device, the size of the output medium can be set in its
+@file{DESC} file.  Most output drivers also recognize a command-line
+option @option{-p} to override the default dimensions and an option
+@option{-l} to use landscape orientation.  @xref{DESC File Format}, for
+a description of the @code{papersize} keyword, which takes an argument
+of the same form as @option{-p}.  The output driver's man page, such as
+@cite{grops@r{(1)}}, may also be helpful.
+
+@code{groff} uses the command-line option @option{-P} to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
 
 @Example
 groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
 @endExample
 
-Note that it is up to the particular macro package to respect default
-page dimensions set in this way (most do).
-
 
 @c =====================================================================
 
-@node Invocation Examples,  , Paper Size, Invoking groff
+@c BEGIN Keep parallel with groff(1), section "Examples".
+@node Invocation Examples,  , Paper Format, Invoking groff
 @section Invocation Examples
 @cindex invocation examples
 @cindex examples of invocation
 
-This section lists several common uses of @code{groff} and the
-corresponding command lines.
+@code{roff} systems are best known for formatting man pages.  Once a
+@command{man} librarian program has located a man page, it may execute
+a @code{groff} command much like the following.
 
 @Example
-groff file
+groff -t -man -Tutf8 /usr/share/man/man1/groff.1
 @endExample
 
-@noindent
-This command processes @file{file} without a macro package or a
-preprocessor.  The output device is the default, @samp{ps}, and the
-output is sent to @code{stdout}.
+The librarian will also pipe the output through a pager, which might not
+interpret the SGR terminal escape sequences @command{groff} emits for
+boldface, underlining, or italics; see the @cite{grotty@r{(1)}} man page
+for a discussion.
+
+To process a @code{roff} input file using the preprocessors
+@command{gtbl} and @command{gpic} and the @file{me} macro package in the
+way to which AT&T @code{troff} users were accustomed, one would type (or
+script) a pipeline.
 
 @Example
-groff -t -mandoc -Tascii file | less
+gpic foo.me | gtbl | gtroff -me -Tutf8 | grotty
 @endExample
 
-@noindent
-This is basically what a call to the @code{man} program does.
-@code{gtroff} processes the manual page @file{file} with the
-@file{mandoc} macro file (which in turn either calls the @file{man} or
-the @file{mdoc} macro package), using the @code{tbl} preprocessor and
-the @acronym{ASCII} output device.  Finally, the @code{less} pager
-displays the result.
+Using @command{groff}, this pipe can be shortened to an equivalent
+command.
 
 @Example
-groff -X -m me file
+groff -p -t -me -T utf8 foo.me
 @endExample
 
-@noindent
-Preview @file{file} with @code{gxditview}, using the @file{me} macro
-package.  Since no @option{-T} option is specified, use the default
-device (@samp{ps}).  Note that you can either say @w{@samp{-m me}} or
-@w{@samp{-me}}; the latter is an anachronism from the early days of
-Unix.@footnote{The same is true for the other main macro packages that
-come with @code{groff}: @file{man}, @file{mdoc}, @file{ms}, @file{mm},
-and @file{mandoc}.  This won't work in general; for example, to load
-@file{trace.tmac}, either @samp{-mtrace} or @w{@samp{-m trace}} must be
-used.}
+An even easier way to do this is to use @command{grog} to guess the
+preprocessor and macro options and execute the result by using the
+command substitution feature of the shell.
 
 @Example
-groff -man -rD1 -z file
+$(grog -Tutf8 foo.me)
 @endExample
 
-@noindent
-Check @file{file} with the @file{man} macro package, forcing
-double-sided printing -- don't produce any output.
-
-@menu
-* grog::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node grog,  , Invocation Examples, Invocation Examples
-@subsection @code{grog}
-
-@pindex grog
-@code{grog} reads files, guesses which of the @code{groff} preprocessors
-and/or macro packages are required for formatting them, and prints the
-@code{groff} command including those options on the standard output.  It
-generates one or more of the options @option{-e}, @option{-man},
-@option{-me}, @option{-mm}, @option{-mom}, @option{-ms}, @option{-mdoc},
-@option{-mdoc-old}, @option{-p}, @option{-R}, @option{-g}, @option{-G},
-@option{-s}, and @option{-t}.
-
-A special file name@tie{}@file{-} refers to the standard input.
-Specifying no files also means to read the standard input.  Any
-specified options are included in the printed command.  No space is
-allowed between options and their arguments.  The only options
-recognized are @option{-C} (which is also passed on) to enable
-compatibility mode, and @option{-v} to print the version number and
-exit.
-
-For example,
+Each command-line option to a postprocessor must be specified with any
+required leading dashes @samp{-}
+@c No GNU roff postprocessor uses long options for anything except
+@c --help or --version.
+@c or @samp{--}
+@c XXX: grolbp does.
+because @command{groff} passes the arguments as-is to the postprocessor;
+this permits arbitrary arguments to be transmitted.  For example, to
+pass a title to the @command{gxditview} postprocessor,
+the shell commands
 
 @Example
-grog -Tdvi paper.ms
+groff -X -P -title -P 'trial run' mydoc.t
 @endExample
 
 @noindent
-guesses the appropriate command to print @file{paper.ms} and then prints
-it to the command line after adding the @option{-Tdvi} option.  For
-direct execution, enclose the call to @code{grog} in backquotes at the
-Unix shell prompt:
+and
 
 @Example
-`grog -Tdvi paper.ms` > paper.dvi
+groff -X -Z mydoc.t | gxditview -title 'trial run' -
 @endExample
 
 @noindent
-As seen in the example, it is still necessary to redirect the output to
-something meaningful (i.e.@: either a file or a pager program like
-@code{less}).
+are equivalent.
+@c END Keep parallel with groff(1), section "Examples".
 
 
 
 @c =====================================================================
 @c =====================================================================
 
-@node Tutorial for Macro Users, Macro Packages, Invoking groff, Top
+@node Tutorial for Macro Users, Major Macro Packages, Invoking groff, Top
 @chapter Tutorial for Macro Users
 @cindex tutorial for macro users
 @cindex macros, tutorial for users
 @cindex user's tutorial for macros
 @cindex user's macro tutorial
 
-Most users tend to use a macro package to format their papers.  This
-means that the whole breadth of @code{groff} is not necessary for most
-people.  This chapter covers the material needed to efficiently use a
-macro package.
+Most users of the @code{roff} language employ a macro package to format
+their documents.  Successful macro packages ease the composition
+process; their users need not have mastered the full formatting
+language, nor understand features like diversions, traps, and
+environments.  This chapter aims to familiarize you with basic concepts
+and mechanisms common to many macro packages (like ``displays'').  If
+you prefer a meticulous and comprehensive presentation, try @ref{GNU
+troff Reference} instead.
 
 @menu
 * Basics::
@@ -1763,24 +1687,24 @@
 
 @node Basics, Common Features, Tutorial for Macro Users, Tutorial for Macro Users
 @section Basics
-@cindex basics of macros
-@cindex macro basics
+@cindex basics of macro package usage
+@cindex macro package usage, basics of
 
-This section covers some of the basic concepts necessary to understand
-how to use a macro package.@footnote{This section is derived from
-@cite{Writing Papers with nroff using -me} by Eric P.@tie{}Allman.}
-References are made throughout to more detailed information, if desired.
+Let us first survey some basic concepts necessary to use a macro package
+fruitfully.@footnote{The remainder of this chapter is based on
+@cite{Writing Papers with nroff using -me} by Eric@tie{}P.@: Allman,
+which is distributed with @code{groff} as @file{meintro.me}.}
+References are made throughout to more detailed information.
 
-@code{gtroff} reads an input file prepared by the user and outputs a
+GNU @code{troff} reads an input file prepared by the user and outputs a
 formatted document suitable for publication or framing.  The input
 consists of text, or words to be printed, and embedded commands
-(@dfn{requests} and @dfn{escapes}), which tell @code{gtroff} how to
-format the output.  For more detail on this, see @ref{Embedded
-Commands}.
+(@slanted{requests} and @slanted{escape sequences}), which tell GNU
+@code{troff} how to format the output.  @xref{Formatter Instructions}.
 
-The word @dfn{argument} is used in this chapter to mean a word or number
-that appears on the same line as a request, and which modifies the
-meaning of that request.  For example, the request
+The word @slanted{argument} is used in this chapter to mean a word or
+number that appears on the same line as a request, and which modifies
+the meaning of that request.  For example, the request
 
 @Example
 .sp
@@ -1796,13 +1720,12 @@
 @noindent
 spaces four lines.  The number@tie{}4 is an argument to the @code{sp}
 request, which says to space four lines instead of one.  Arguments are
-separated from the request and from each other by spaces (@emph{no}
-tabs).  More details on this can be found in @ref{Request and Macro
-Arguments}.
-
-The primary function of @code{gtroff} is to collect words from input
-lines, fill output lines with those words, justify the right-hand margin
-by inserting extra spaces in the line, and output the result.  For
+separated from the request and from each other by spaces (@emph{not}
+tabs).  @xref{Invoking Requests}.
+
+The primary function of GNU @code{troff} is to collect words from input
+lines, fill output lines with those words, adjust the line to the
+right-hand margin by widening spaces, and output the result.  For
 example, the input:
 
 @Example
@@ -1817,34 +1740,33 @@
 @noindent
 is read, packed onto output lines, and justified to produce:
 
-@quotation
-Now is the time for all good men to come to the aid of their party.
-Four score and seven years ago, etc.
-@end quotation
+@Example
+  @result{} Now is the time for all good men to come to the aid of
+  @result{} their party.  Four score and seven years ago, etc.
+@endExample
 
-@cindex break
-@cindex line break
 Sometimes a new output line should be started even though the current
-line is not yet full; for example, at the end of a paragraph.  To do
-this it is possible to cause a @dfn{break}, which starts a new output
-line.  Some requests cause a break automatically, as normally do blank
-input lines and input lines beginning with a space.
-
-Not all input lines are text to be formatted.  Some input lines are
-requests that describe how to format the text.  Requests always have a
-period (@samp{.}) or an apostrophe (@samp{'}) as the first character of
-the input line.
+line is not yet full---for example, at the end of a paragraph.  To do
+this it is possible to force a @slanted{break}, starting a new output
+line.  Some requests cause a break automatically, as do (normally) blank
+input lines and input lines beginning with a space or tab.
+
+Not all input lines are @slanted{text lines}---words to be formatted.
+Some are @slanted{control lines} that tell a macro package (or GNU
+@code{troff} directly) how to format the text.  Control lines start with
+a dot (@samp{.}) or an apostrophe (@samp{'}) as the first character, and
+can be followed by a @slanted{macro call}.
 
-The text formatter also does more complex things, such as automatically
+The formatter also does more complex things, such as automatically
 numbering pages, skipping over page boundaries, putting footnotes in the
 correct place, and so forth.
 
-Here are a few hints for preparing text for input to @code{gtroff}.
+Here are a few hints for preparing text for input to GNU @code{troff}.
 
 @itemize @bullet
 @item
 First, keep the input lines short.  Short input lines are easier to
-edit, and @code{gtroff} packs words onto longer lines anyhow.
+edit, and GNU @code{troff} packs words onto longer lines anyhow.
 
 @item
 In keeping with this, it is helpful to begin a new line after every
@@ -1852,37 +1774,39 @@
 or phrases.
 
 @item
-End each sentence with two spaces -- or better, start each sentence on a
-new line.  @code{gtroff} recognizes characters that usually end a
-sentence, and inserts sentence space accordingly.
+End each sentence with two spaces---or better, start each sentence on a
+new line.  GNU @code{troff} recognizes characters that usually end a
+sentence, and inserts inter-sentence space accordingly.
 
 @item
-Do not hyphenate words at the end of lines -- @code{gtroff} is smart
+Do not hyphenate words at the end of lines---GNU @code{troff} is smart
 enough to hyphenate words as needed, but is not smart enough to take
 hyphens out and join a word back together.  Also, words such as
 ``mother-in-law'' should not be broken over a line, since then a space
 can occur where not wanted, such as ``@w{mother- in}-law''.
 @end itemize
 
-@cindex double-spacing (@code{ls})
-@cindex spacing
-@code{gtroff} double-spaces output text automatically if you use the
-request @w{@samp{.ls 2}}.  Reactivate single-spaced mode by typing
-@w{@samp{.ls 1}}.@footnote{If you need finer granularity of the vertical
-space, use the @code{pvs} request (@pxref{Changing Type Sizes}).}
-
-A number of requests allow to change the way the output looks, sometimes
-called the @dfn{layout} of the output page.  Most of these requests
-adjust the placing of @dfn{whitespace} (blank lines or spaces).
+We offer further advice in @ref{Input Conventions}.
 
-@cindex new page (@code{bp})
-The @code{bp} request starts a new page, causing a line break.
+@cindex vertical spacing (introduction)
+@cindex spacing, vertical (introduction)
+GNU @code{troff} permits alteration of the distance between lines of
+text.  This is termed @slanted{vertical spacing} and is expressed in the
+same units as the type size---the point.  The default is 10-point type
+on 12-point spacing.  To get @slanted{double-spaced} text you would set
+the vertical spacing to 24 points.  Some, but not all, macro packages
+expose a macro or register to configure the vertical spacing.
+
+A number of requests allow you to change the way the output is arranged
+on the page, sometimes called the @slanted{layout} of the output page.
+Most macro packages don't supply macros for performing these (at least
+not without performing other actions besides), as they are such basic
+operations.  The macro packages for writing man pages, @file{man} and
+@file{mdoc}, don't encourage explicit use of these requests at all.
 
-@cindex blank line (@code{sp})
-@cindex empty line (@code{sp})
-@cindex line, empty (@code{sp})
+@cindex spacing (introduction)
 The request @w{@samp{.sp @var{N}}} leaves @var{N}@tie{}lines of blank
-space.  @var{N}@tie{}can be omitted (meaning skip a single line) or can
+space.  @var{N}@tie{}can be omitted (skipping a single line) or can
 be of the form @var{N}i (for @var{N}@tie{}inches) or @var{N}c (for
 @var{N}@tie{}centimeters).  For example, the input:
 
@@ -1895,10 +1819,18 @@
 @noindent
 leaves one and a half inches of space, followed by the line ``My
 thoughts on the subject'', followed by a single blank line (more
-measurement units are available, see @ref{Measurements}).
+measurement units are available; see @ref{Measurements}).
 
-@cindex centering lines (@code{ce})
-@cindex lines, centering (@code{ce})
+If you seek precision in spacing, be advised when using a macro package
+that it might not honor @code{sp} requests as you expect; it can use a
+formatter feature called @slanted{no-space mode} to prevent excess space
+from accumulating.  Macro packages typically offer registers to control
+spacing between paragraphs, before section headings, and around displays
+(discussed below); use these facilities preferentially.
+@xref{Manipulating Spacing}.
+
+@cindex centering lines (introduction)
+@cindex lines, centering (introduction)
 Text lines can be centered by using the @code{ce} request.  The line
 after @code{ce} is centered (horizontally) on the page.  To center more
 than one line, use @w{@samp{.ce @var{N}}} (where @var{N} is the number
@@ -1912,14 +1844,29 @@
 @endExample
 
 @noindent
-The @w{@samp{.ce 0}} request tells @code{groff} to center zero more
+The @w{@samp{.ce 0}} request tells GNU @code{troff} to center zero more
 lines, in other words, stop centering.
 
-@cindex line break (@code{br})
-@cindex break (@code{br})
+@cindex right-aligning lines (introduction)
+@cindex lines, right-aligning (introduction)
+@cindex right-justifying lines (introduction)
+@cindex lines, right-justifying (introduction)
+GNU @code{troff} also offers the @code{rj} request for right-aligning
+text.  It works analogously to @code{ce} and is convenient for setting
+epigraphs.
+
+@cindex page break (introduction)
+@cindex break, page (introduction)
+The @code{bp} request starts a new page; this necessarily implies an
+ordinary (line) break.
+
+@cindex break (introduction)
+@cindex line break (introduction)
 All of these requests cause a break; that is, they always start a new
 line.  To start a new line without performing any other action, use
-@code{br}.
+@code{br}.  If you invoke them with the apostrophe @samp{'}, the
+@slanted{no-break control character}, the (initial) break they normally
+perform is suppressed.  @samp{'br} does nothing.
 
 
 @c =====================================================================
@@ -1929,27 +1876,35 @@
 @cindex common features
 @cindex features, common
 
-@code{gtroff} provides very low-level operations for formatting a
-document.  There are many common routine operations that are done in
-all documents.  These common operations are written into @dfn{macros}
-and collected into a @dfn{macro package}.
-
-All macro packages provide certain common capabilities that fall into
-the following categories.
+GNU @code{troff} provides low-level operations for formatting a
+document.  Many routine operations are undertaken in nearly all
+documents that require a series of such primitive operations to be
+performed.  These common tasks are grouped into @slanted{macros}, which
+are then collected into a @slanted{macro package}.
+
+Macro packages come in two varieties:@: ``major'' or ``full-service''
+ones that manage page layout, and ``minor'' or ``auxiliary'' ones that
+do not, instead fulfilling narrow, specific tasks.  Find a list in the
+@cite{groff_tmac@r{(5)}} man page.  Type @samp{man groff_tmac} at the
+command line to view it.
+
+We survey several capabilities of full-service macro package below.
+Each package employs its own macros to exercise them.  For details,
+consult its man page or, for @file{ms}, see @ref{ms}.
 
 @menu
 * Paragraphs::
 * Sections and Chapters::
 * Headers and Footers::
 * Page Layout Adjustment::
-* Displays::
-* Footnotes and Annotations::
+* Displays and Keeps::
+* Footnotes and Endnotes::
 * Table of Contents::
-* Indices::
-* Paper Formats::
-* Multiple Columns::
+* Indexing::
+* Document Formats::
+* Columnation::
 * Font and Size Changes::
-* Predefined Strings::
+* Predefined Text::
 * Preprocessor Support::
 * Configuration and Customization::
 @end menu
@@ -1960,44 +1915,56 @@
 @subsection Paragraphs
 @cindex paragraphs
 
-One of the most common and most used capability is starting a paragraph.
-There are a number of different types of paragraphs, any of which can be
-initiated with macros supplied by the macro package.  Normally,
-paragraphs start with a blank line and the first line indented, like the
-text in this manual.  There are also block style paragraphs, which omit
-the indentation:
+Paragraphs can be separated and indented in various ways.  Some start
+with a blank line and have a first-line indentation, like most of the
+ones in this manual.  Block paragraphs omit the indentation.
 
 @Example
-Some   men  look   at  constitutions   with  sanctimonious
-reverence, and deem them like the ark of the covenant, too
-sacred to be touched.
+  @result{} Some  men  look  at constitutions with sanctimonious
+  @result{} reverence,  and  deem  them  like  the  ark  of  the
+  @result{} covenant, too sacred to be touched.
 @endExample
 
+@cindex tags, paragraph
+@cindex tagged paragraphs
+@cindex lists
 @noindent
-And there are also indented paragraphs, which begin with a tag or label
-at the margin and the remaining text indented.
+We also frequently encounter @slanted{tagged} paragraphs, which begin
+with a tag or label at the left margin and indent the remaining text.
 
 @Example
-one   This is  the first paragraph.  Notice  how the first
-      line of  the resulting  paragraph lines up  with the
-      other lines in the paragraph.
+  @result{} one  This  is the first paragraph.  Notice how the
+  @result{}      first line of the resulting  paragraph  lines
+  @result{}      up with the other lines in the paragraph.
 @endExample
 
+@noindent
+If the tag is too wide for the indentation, the line is broken.
+
+@Example
+  @result{} longlabel
+  @result{}      The  label does not align with the subsequent
+  @result{}      lines, but they align with each other.
+@endExample
+
+@noindent
+A variation of the tagged paragraph is the itemized or enumerated
+paragraph, which might use punctuation or a digit for a tag,
+respectively.  These are frequently used to construct lists.
+
 @Example
-longlabel
-      This  paragraph   had  a  long   label.   The  first
-      character of text on the first line does not line up
-      with  the  text  on  second  and  subsequent  lines,
-      although they line up with each other.
+  @result{} o    This  list  item  starts with a bullet.  When
+  @result{}      producing output for a device using the ASCII
+  @result{}      character set, an 'o' is formatted instead.
 @endExample
 
-A variation of this is a bulleted list.
+@noindent
+Often, use of the same macro without a tag continues such a discussion.
 
 @Example
-.     Bulleted lists start with a bullet.   It is possible
-      to use other glyphs instead of the bullet.  In nroff
-      mode using the ASCII character set for output, a dot
-      is used instead of a real bullet.
+  @result{} -xyz  This option is recognized but ignored.
+  @result{}
+  @result{}       It had a security hole that we don't discuss.
 @endExample
 
 @c ---------------------------------------------------------------------
@@ -2005,700 +1972,261 @@
 @node Sections and Chapters, Headers and Footers, Paragraphs, Common Features
 @subsection Sections and Chapters
 
-Most macro packages supply some form of section headers.  The simplest
-kind is simply the heading on a line by itself in bold type.  Others
-supply automatically numbered section heading or different heading
-styles at different levels.  Some, more sophisticated, macro packages
-supply macros for starting chapters and appendices.
+The simplest kind of section heading is unnumbered, set in a bold or
+italic style, and occupies a line by itself.  Others possess
+automatically numbered multi-level headings and/or different typeface
+styles or sizes at different levels.  More sophisticated macro packages
+supply macros for designating chapters and appendices.
 
 @c ---------------------------------------------------------------------
 
 @node Headers and Footers, Page Layout Adjustment, Sections and Chapters, Common Features
 @subsection Headers and Footers
 
-Every macro package gives some way to manipulate the @dfn{headers} and
-@dfn{footers} (also called @dfn{titles}) on each page.  This is text put
-at the top and bottom of each page, respectively, which contain data
-like the current page number, the current chapter title, and so on.  Its
-appearance is not affected by the running text.  Some packages allow for
-different ones on the even and odd pages (for material printed in a book
-form).
-
-The titles are called @dfn{three-part titles}, that is, there is a
-left-justified part, a centered part, and a right-justified part.  An
-automatically generated page number may be put in any of these fields
-with the @samp{%} character (see @ref{Page Layout}, for more details).
+@slanted{Headers} and @slanted{footers} occupy the top and bottom of
+each page, respectively, and contain data like the page number and the
+article or chapter title.  Their appearance is not affected by the
+running text.  Some packages allow for different titles on even- and
+odd-numbered pages (for printed, bound material).
+
+Headers and footers are together called @slanted{titles}, and comprise
+three parts:@: left-aligned, centered, and right-aligned.  A @samp{%}
+character appearing anywhere in a title is automatically replaced by the
+page number.  @xref{Page Layout}.
 
 @c ---------------------------------------------------------------------
 
-@node Page Layout Adjustment, Displays, Headers and Footers, Common Features
+@node Page Layout Adjustment, Displays and Keeps, Headers and Footers, Common Features
 @subsection Page Layout
 
-Most macro packages let the user specify top and bottom margins and
-other details about the appearance of the printed pages.
+Most macro packages let the user specify the size of the page margins.
+The top and bottom margins are typically handled differently than the
+left and right margins; the latter two are derived from the
+@slanted{page offset}, @slanted{indentation}, and @slanted{line length}.
+@xref{Line Layout}.  Commonly, packages support registers to tune these
+values.
 
 @c ---------------------------------------------------------------------
 
-@node Displays, Footnotes and Annotations, Page Layout Adjustment, Common Features
-@subsection Displays
+@node Displays and Keeps, Footnotes and Endnotes, Page Layout Adjustment, Common Features
+@subsection Displays and Keeps
 @cindex displays
 
-@dfn{Displays} are sections of text to be set off from the body of the
-paper.  Major quotes, tables, and figures are types of displays, as are
-all the examples used in this document.
-
-@cindex quotes, major
-@cindex major quotes
-@dfn{Major quotes} are quotes that are several lines long, and hence
-are set in from the rest of the text without quote marks around them.
-
-@cindex list
-A @dfn{list} is an indented, single-spaced, unfilled display.  Lists
-should be used when the material to be printed should not be filled and
-justified like normal text, such as columns of figures or the examples
-used in this paper.
-
-@cindex keep
-A @dfn{keep} is a display of lines that are kept on a single page if
-possible.  An example for a keep might be a diagram.  Keeps differ from
-lists in that lists may be broken over a page boundary whereas keeps are
-not.
+@slanted{Displays} are sections of text set off from the surrounding
+material (typically paragraphs), often differing in indentation, and/or
+spacing.  Tables, block quotations, and figures are displayed.
+Equations and code examples, when not much shorter than an output line,
+often are.  Lists may or may not be.  Packages for setting man pages
+support example displays but not keeps.
+@c XXX: man, mdoc keep support planned
+
+@cindex keeps (introduction)
+A @slanted{keep} is a group of output lines, often a display, that is
+formatted on a single page if possible; it causes a page break to happen
+early so as to not interrupt the kept material.
 
 @cindex keep, floating
 @cindex floating keep
-@dfn{Floating keeps} move relative to the text.  Hence, they are good
-for things that are referred to by name, such as ``See figure@tie{}3''.
-A floating keep appears at the bottom of the current page if it fits;
-otherwise, it appears at the top of the next page.  Meanwhile, the
-surrounding text `flows' around the keep, thus leaving no blank areas.
+@slanted{Floating keeps} can move, or ``float'', relative to the text
+around them in the input.  They are useful for displays that are
+captioned and referred to by name, as with ``See figure@tie{}3''.
+Depending on the package, a floating keep appears at the bottom of the
+current page if it fits, and at the top of the next otherwise.
+Alternatively, floating keeps might be deferred to the end of a section.
+Using a floating keep can avoid the large vertical spaces that may
+precede a tall keep of the ordinary sort when it won't fit on the page.
 
 @c ---------------------------------------------------------------------
 
-@node Footnotes and Annotations, Table of Contents, Displays, Common Features
-@subsection Footnotes and Annotations
+@node Footnotes and Endnotes, Table of Contents, Displays and Keeps, Common Features
+@subsection Footnotes and Endnotes
 @cindex footnotes
-@cindex annotations
-
-There are a number of requests to save text for later printing.
-
-@dfn{Footnotes} are printed at the bottom of the current page.
+@cindex endnotes
 
-@cindex delayed text
-@dfn{Delayed text} is very similar to a footnote except that it is
-printed when called for explicitly.  This allows a list of references to
-appear (for example) at the end of each chapter, as is the convention in
-some disciplines.
-
-Most macro packages that supply this functionality also supply a means
-of automatically numbering either type of annotation.
+@slanted{Footnotes} and @slanted{endnotes} are forms of delayed
+formatting.  They are recorded at their points of relevance in
+the input, but not formatted there.  Instead, a @slanted{mark} cues the
+reader to check the ``foot'', or bottom, of the current page, or in the
+case of endnotes, an annotation list later in the document.  Macro
+packages that support these features also supply a means of
+automatically numbering either type of annotation.
 
 @c ---------------------------------------------------------------------
 
-@node Table of Contents, Indices, Footnotes and Annotations, Common Features
+@node Table of Contents, Indexing, Footnotes and Endnotes, Common Features
 @subsection Table of Contents
 @cindex table of contents
 @cindex contents, table of
 
-@dfn{Tables of contents} are a type of delayed text having a tag
-(usually the page number) attached to each entry after a row of dots.
-The table accumulates throughout the paper until printed, usually after
-the paper has ended.  Many macro packages provide the ability to have
-several tables of contents (e.g.@: a standard table of contents, a list
-of tables, etc).
+A package may handle a @slanted{table of contents} by directing section
+heading macros to save section heading text and the page number where it
+occurs for use in a later @slanted{entry} for a table of contents.  It
+writes the collected entries at the end of the document, once all are
+known, upon request.  A row of dots (a @slanted{leader}) bridges the
+text on the left with its location on the right.  Other collections
+might work in this manner, providing lists of figures or tables.
+
+A table of contents is often found at the end of a GNU @code{troff}
+document because the formatter processes the document in a single pass.
+The @command{gropdf} output driver supports a PDF feature that relocates
+pages at the time the document is rendered; see the @cite{gropdf@r{(1)}}
+man page.  Type @samp{man gropdf} at the command line to view it.
 
 @c ---------------------------------------------------------------------
 
-@node Indices, Paper Formats, Table of Contents, Common Features
-@subsection Indices
+@node Indexing, Document Formats, Table of Contents, Common Features
+@subsection Indexing
 @cindex index, in macro package
 
-While some macro packages use the term @dfn{index}, none actually
-provide that functionality.  The facilities they call indices are
-actually more appropriate for tables of contents.
-
 @pindex makeindex
-To produce a real index in a document, external tools like the
-@code{makeindex} program are necessary.
+An index is similar to a table of contents, in that entry labels and
+locations must be collected, but poses a greater challenge because it
+needs to be sorted before it is output.  Here, processing the document
+in multiple passes is inescapable, and tools like the @code{makeindex}
+program are necessary.
 
 @c ---------------------------------------------------------------------
 
-@node Paper Formats, Multiple Columns, Indices, Common Features
-@subsection Paper Formats
-@cindex paper formats
+@node Document Formats, Columnation, Indexing, Common Features
+@subsection Document Formats
+@cindex document formats
 
-Some macro packages provide stock formats for various kinds of
-documents.  Many of them provide a common format for the title and
-opening pages of a technical paper.  The @file{mm} macros in particular
-provide formats for letters and memoranda.
+Some macro packages supply stock configurations of certain documents,
+like business letters and memoranda.  These often also have provision
+for a @slanted{cover sheet}, which may be rigid in its format.  With
+these features, it is even more important to use the package's macros in
+preference to the formatter requests presented earlier, where possible.
 
 @c ---------------------------------------------------------------------
 
-@node Multiple Columns, Font and Size Changes, Paper Formats, Common Features
-@subsection Multiple Columns
+@node Columnation, Font and Size Changes, Document Formats, Common Features
+@subsection Columnation
 
-Some macro packages (but not @file{man}) provide the ability to have two
-or more columns on a page.
+Macro packages apart from @file{man} and @file{mdoc} for man page
+formatting offer a facility for setting multiple columns on the page.
 
 @c ---------------------------------------------------------------------
 
-@node Font and Size Changes, Predefined Strings, Multiple Columns, Common Features
+@node Font and Size Changes, Predefined Text, Columnation, Common Features
 @subsection Font and Size Changes
 
-The built-in font and size functions are not always intuitive, so all
-macro packages provide macros to make these operations simpler.
+The formatter's requests and escape sequences for setting the typeface
+and size are not always intuitive, so all macro packages provide macros
+to make these operations simpler.  They also make it more convenient to
+change typefaces in the middle of a word and can handle italic
+corrections automatically.  @xref{Italic Corrections}.
 
 @c ---------------------------------------------------------------------
 
-@node Predefined Strings, Preprocessor Support, Font and Size Changes, Common Features
-@subsection Predefined Strings
+@node Predefined Text, Preprocessor Support, Font and Size Changes, Common Features
+@subsection Predefined Text
 
-Most macro packages provide various predefined strings for a variety of
-uses; examples are sub- and superscripts, printable dates, quotes and
-various special characters.
+Most macro packages supply predefined strings to set prepared text like
+the date, or to perform operations like super- and subscripting.
 
 @c ---------------------------------------------------------------------
 
-@node Preprocessor Support, Configuration and Customization, Predefined Strings, Common Features
+@node Preprocessor Support, Configuration and Customization, Predefined Text, Common Features
 @subsection Preprocessor Support
 
 All macro packages provide support for various preprocessors and may
-extend their functionality.
-
-For example, all macro packages mark tables (which are processed with
-@code{gtbl}) by placing them between @code{TS} and @code{TE} macros.
-The @file{ms} macro package has an option, @samp{.TS@tie{}H}, that
-prints a caption at the top of a new page (when the table is too long to
-fit on a single page).
+extend their functionality by defining macros to set their contents in
+displays.  Examples include @code{TS} and @code{TE} for @command{gtbl},
+@code{EQ} and @code{EN} for @command{geqn}, and @code{PS} and @code{PE}
+for @command{gpic}.
 
 @c ---------------------------------------------------------------------
 
 @node Configuration and Customization,  , Preprocessor Support, Common Features
 @subsection Configuration and Customization
 
-Some macro packages provide means of customizing many of the details of
-how the package behaves.  This ranges from setting the default type size
-to changing the appearance of section headers.
+Packages provide means of customizing many of the details of how the
+package behaves.  These range from setting the default type size to
+changing the appearance of section headers.
+
+@codequotebacktick off
+@codequoteundirected off
 
 
 
 @c =====================================================================
 @c =====================================================================
 
-@node Macro Packages, gtroff Reference, Tutorial for Macro Users, Top
+@node Major Macro Packages, GNU troff Reference, Tutorial for Macro Users, Top
 @chapter Macro Packages
-@cindex macro packages
-@cindex packages, macros
-
-This chapter documents the main macro packages that come with
-@code{groff}.
-
-Different main macro packages can't be used at the same time; for
-example
+@cindex major macro package
+@cindex package, macro, major
+@cindex macro package, major
+
+This chapter surveys the ``major'' macro packages that come with
+@code{groff}.  One, @file{ms}, is presented in detail.
+
+@cindex full-service macro package
+@cindex package, macro, full-service
+@cindex macro package, full-service
+Major macro packages are also sometimes described as @dfn{full-service}
+due to the breadth of features they provide and because more than one
+cannot be used by the same document; for example
 
 @Example
 groff -m man foo.man -m ms bar.doc
 @endExample
 
 @noindent
-doesn't work.  Note that option arguments are processed before
-non-option arguments; the above (failing) sample is thus reordered to
+doesn't work.  Option arguments are processed before non-option
+arguments; the above (failing) sample is thus reordered to
 
 @Example
 groff -m man -m ms foo.man bar.doc
 @endExample
 
+@cindex minor macro package
+@cindex package, macro, minor
+@cindex macro package, minor
+@cindex auxiliary macro package
+@cindex package, macro, auxiliary
+@cindex macro package, auxiliary
+Many auxiliary, or ``minor'', macro packages are also available.  They
+may in general be used with any full-service macro package and handle a
+variety of tasks from character encoding selection, to language
+localization, to inlining of raster images.  See the
+@cite{groff_tmac@r{(5)}} man page for a list.  Type @samp{man
+groff_tmac} at the command line to view it.
+
 @menu
 * man::
 * mdoc::
-* ms::
 * me::
 * mm::
 * mom::
+* ms::
 @end menu
 
 
 @c =====================================================================
 
-@node man, mdoc, Macro Packages, Macro Packages
+@node man, mdoc, Major Macro Packages, Major Macro Packages
 @section @file{man}
 @cindex manual pages
 @cindex man pages
 @pindex an.tmac
 @pindex man.tmac
-@pindex man-old.tmac
 
-This is the most popular and probably the most important macro package
-of @code{groff}.  It is easy to use, and a vast majority of manual pages
-are based on it.
+The @code{man} macro package is the most widely used and probably the
+most important ever developed for @code{troff}.  It is easy to use, and
+a vast majority of manual pages (``man pages'') are written in it.
+
+@code{groff}'s implementation is documented in the
+@cite{groff_man@r{(7)}} man page.  Type @samp{man groff_man} at the
+command line to view it.
 
 @menu
-* Man options::
-* Man usage::
-* Man font macros::
-* Miscellaneous man macros::
-* Predefined man strings::
-* Preprocessors in man pages::
 * Optional man extensions::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Man options, Man usage, man, man
-@subsection Options
-
-The command-line format for using the @file{man} macros with
-@code{groff} is:
-
-@Example
-groff -m man  -rLL=@var{length}   -rLT=@var{length}   -rFT=@var{dist} 
-       -rcR=1   -rC1   -rD1  -rHY=@var{flags} 
-       -rP@var{nnn}   -rS@var{xx}   -rX@var{nnn} 
-       -rIN=@var{length}   -rSN=@var{length}   @var{files}@dots{} 
-@endExample
-
-@noindent
-It is possible to use @samp{-man} instead of @w{@samp{-m man}}.
-
-@table @code
-@item -rcR=1
-This option (the default if a TTY output device is used) creates a
-single, very long page instead of multiple pages.  Use @code{-rcR=0} to
-disable it.
-
-@item -rC1
-If more than one manual page is given on the command line, number the
-pages continuously, rather than starting each at@tie{}1.
-
-@item -rD1
-Double-sided printing.  Footers for even and odd pages are formatted
-differently.
-
-@item -rFT=@var{dist}
-Set the position of the footer text to @var{dist}.  If positive, the
-distance is measured relative to the top of the page, otherwise it is
-relative to the bottom.  The default is @minus{}0.5@dmn{i}.
-
-@item -rHY=@var{flags}
-Set hyphenation flags.  Possible values are 1@tie{}to hyphenate without
-restrictions, 2@tie{}to not hyphenate the last word on a page, 4@tie{}to
-not hyphenate the last two characters of a word, and 8@tie{}to not
-hyphenate the first two characters of a word.  These values are
-additive; the default is@tie{}8.
-
-@item -rIN=@var{length}
-Set the body text indentation to @var{length}.  If not specified, the
-indentation defaults to 7@dmn{n} (7@tie{}characters) in nroff mode and
-7.2@dmn{n} otherwise.  For nroff, this value should always be an integer
-multiple of unit @samp{n} to get consistent indentation.
-
-@item -rLL=@var{length}
-Set line length to @var{length}.  If not specified, the line length is
-set to respect any value set by a prior @samp{ll} request (which
-@emph{must} be in effect when the @samp{TH} macro is invoked), if this
-differs from the built-in default for the formatter; otherwise it
-defaults to 78@dmn{n} in nroff mode (this is 78 characters per line) and
-6.5@dmn{i} in troff mode.@footnote{Note that the use of a @samp{.ll
-@var{length}} request to initialize the line length, prior to use of the
-@samp{TH} macro, is supported for backward compatibility with some
-versions of the @code{man} program.  @emph{Always} use the
-@option{-rLL=@var{length}} option, or an equivalent @samp{.nr LL
-@var{length}} request, in preference to such a @samp{.ll @var{length}}
-request.  In particular, note that in nroff mode, the request @samp{.ll
-65n}, (with any @var{length} expression that evaluates equal to
-65@dmn{n}, i.e., the formatter's default line length in nroff mode),
-does @emph{not} set the line length to 65@dmn{n} (it is adjusted to the
-@code{man} macro package's default setting of 78@dmn{n}), whereas the
-use of the @option{-rLL=65n} option, or the @samp{.nr LL 65n} request
-@emph{does} establish a line length of 65@dmn{n}.}
-
-@item -rLT=@var{length}
-Set title length to @var{length}.  If not specified, the title length
-defaults to the line length.
-
-@item -rP@var{nnn}
-Page numbering starts with @var{nnn} rather than with@tie{}1.
-
-@item -rS@var{xx}
-Use @var{xx} (which can be 10, 11, or@tie{}12@dmn{pt}) as the base
-document font size instead of the default value of@tie{}10@dmn{pt}.
-
-@item -rSN=@var{length}
-Set the indentation for sub-subheadings to @var{length}.  If not
-specified, the indentation defaults to 3@dmn{n}.
-
-@item -rX@var{nnn}
-After page @var{nnn}, number pages as @var{nnn}a, @var{nnn}b,
-@var{nnn}c, etc.  For example, the option @option{-rX2} produces the
-following page numbers: 1, 2, 2a, 2b, 2c, etc.
-@end table
-
-@c ---------------------------------------------------------------------
-
-@node Man usage, Man font macros, Man options, man
-@subsection Usage
-@cindex @code{man} macros
-@cindex macros for manual pages @code{man}
-
-@pindex man.local
-This section describes the available macros for manual pages.  For
-further customization, put additional macros and requests into the file
-@file{man.local}, which is loaded immediately after the @file{man}
-package.
-
-@Defmac {TH, title section @Var{extra1} @Var{extra2} @Var{extra3}, man}
-Set the title of the man page to @var{title} and the section to
-@var{section}, which must have a value between 1 and@tie{}8.  The value
-of @var{section} may also have a string appended, e.g.@: @samp{.pm}, to
-indicate a specific subsection of the man pages.
-
-Both @var{title} and @var{section} are positioned at the left and right
-in the header line (with @var{section} in parentheses immediately
-appended to @var{title}.  @var{extra1} is positioned in the middle of
-the footer line.  @var{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).  @var{extra3} is centered in the
-header line.
-
-For @acronym{HTML} and @acronym{XHTML} output, headers and footers are
-completely suppressed.
-
-Additionally, this macro starts a new page; the new line number
-is@tie{}1 again (except if the @option{-rC1} option is given on the
-command line) -- this feature is intended only for formatting multiple
-man pages; a single man page should contain exactly one @code{TH} macro
-at the beginning of the file.
-@endDefmac
-
-@Defmac {SH, @Var{heading}, man}
-Set up an unnumbered section heading sticking out to the left.  Prints
-out all the text following @code{SH} up to the end of the line (or the
-text in the next line if there is no argument to @code{SH}) in bold face
-(or the font specified by the string @code{HF}), one size larger than
-the base document size.  Additionally, the left margin and the
-indentation for the following text is reset to its default value.
-@endDefmac
-
-@Defmac {SS, @Var{heading}, man}
-Set up an unnumbered (sub)section heading.  Prints out all the text
-following @code{SS} up to the end of the line (or the text in the next
-line if there is no argument to @code{SS}) in bold face (or the font
-specified by the string @code{HF}), at the same size as the base
-document size.  Additionally, the left margin and the indentation for
-the following text is reset to its default value.
-@endDefmac
-
-@Defmac {TP, @Var{nnn}, man}
-Set up an indented paragraph with label.  The indentation is set to
-@var{nnn} if that argument is supplied (the default unit is @samp{n} if
-omitted), otherwise it is set to the previous indentation value
-specified with @code{TP}, @code{IP}, or @code{HP} (or to the default
-value if none of them have been used yet).
-
-The first 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.
-@endDefmac
-
-@DefmacList {LP, , man}
-@DefmacItemx {PP, , man}
-@DefmacListEndx {P, , man}
-These macros are mutual aliases.  Any of them causes a line break at the
-current position, followed by a vertical space downwards by the amount
-specified by the @code{PD} macro.  The font size and shape are reset to
-the default value (10@dmn{pt} roman if no @option{-rS} option is given
-on the command line).  Finally, the current left margin and the
-indentation is restored.
-@endDefmac
-
-@Defmac {IP, @Var{designator} @Var{nnn}, man}
-Set up an indented paragraph, using @var{designator} as a tag to mark
-its beginning.  The indentation is set to @var{nnn} if that argument is
-supplied (default unit is @samp{n}), otherwise it is set to the previous
-indentation value specified with @code{TP}, @code{IP}, or @code{HP} (or
-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 their
-default values.
-
-To start an indented paragraph with a particular indentation but without
-a designator, use @samp{""} (two double quotes) as the first argument of
-@code{IP}.
-
-For example, to start a paragraph with bullets as the designator and
-4@tie{}en indentation, write
-
-@Example
-.IP \(bu 4
-@endExample
-@endDefmac
-
-@Defmac {HP, @Var{nnn}, man}
-@cindex hanging indentation @code{man}
-@cindex @code{man} macros, hanging indentation
-Set up a paragraph with hanging left indentation.  The indentation is
-set to @var{nnn} if that argument is supplied (default unit is
-@samp{n}), otherwise it is set to the previous indentation value
-specified with @code{TP}, @code{IP}, or @code{HP} (or the default value
-if non of them have been used yet).  Font size and face are reset to
-their default values.
-@endDefmac
-
-@Defmac {RS, @Var{nnn}, man}
-@cindex left margin, how to move @code{man}
-@cindex @code{man} macros, moving left margin
-Move the left margin to the right by the value @var{nnn} if specified
-(default unit is @samp{n}); otherwise it is set to the previous
-indentation value specified with @code{TP}, @code{IP}, or @code{HP} (or
-to the default value if none of them have been used yet).  The
-indentation value is then set to the default.
-
-Calls to the @code{RS} macro can be nested.
-@endDefmac
-
-@Defmac {RE, @Var{nnn}, man}
-Move the left margin back to level @var{nnn}, restoring the previous
-left margin.  If no argument is given, it moves one level back.  The
-first level (i.e., no call to @code{RS} yet) has number@tie{}1, and each
-call to @code{RS} increases the level by@tie{}1.
-@endDefmac
-
-@cindex line breaks, with vertical space @code{man}
-@cindex @code{man} macros, line breaks with vertical space
-To summarize, the following macros cause a line break with the insertion
-of vertical space (which amount can be changed with the @code{PD}
-macro): @code{SH}, @code{SS}, @code{TP}, @code{LP} (@code{PP},
-@code{P}), @code{IP}, and @code{HP}.
-
-@cindex line breaks, without vertical space @code{man}
-@cindex @code{man} macros, line breaks without vertical space
-The macros @code{RS} and @code{RE} also cause a break but do not insert
-vertical space.
-
-@cindex default indentation, resetting @code{man}
-@cindex indentation, resetting to default @code{man}
-@cindex @code{man} macros, resetting default indentation
-Finally, the macros @code{SH}, @code{SS}, @code{LP} (@code{PP},
-@code{P}), and @code{RS} reset the indentation to its default value.
-
-@c ---------------------------------------------------------------------
-
-@node Man font macros, Miscellaneous man macros, Man usage, man
-@subsection Macros to set fonts
-@cindex font selection @code{man}
-@cindex @code{man} macros, how to set fonts
-
-The standard font is roman; the default text size is 10@tie{}points.  If
-command-line option @option{-rS=@var{n}} is given, use
-@var{n}@tie{}points as the default text size.
-
-@Defmac {SM, @Var{text}, man}
-Set the text on the same line or the text on the next line in a font
-that is one point size smaller than the default font.
-@endDefmac
-
-@Defmac {SB, @Var{text}, man}
-@cindex bold face @code{man}
-@cindex @code{man} macros, bold face
-Set the text on the same line or the text on the next line in bold face
-font, one point size smaller than the default font.
-@endDefmac
-
-@Defmac {BI, text, man}
-Set its arguments alternately in bold face and italic, without a space
-between the arguments.  Thus,
-
-@Example
-.BI this "word and" that
-@endExample
-
-@noindent
-produces ``thisword andthat'' with ``this'' and ``that'' in bold face,
-and ``word and'' in italics.
-@endDefmac
-
-@Defmac {IB, text, man}
-Set its arguments alternately in italic and bold face, without a space
-between the arguments.
-@endDefmac
-
-@Defmac {RI, text, man}
-Set its arguments alternately in roman and italic, without a space
-between the arguments.
-@endDefmac
-
-@Defmac {IR, text, man}
-Set its arguments alternately in italic and roman, without a space
-between the arguments.
-@endDefmac
-
-@Defmac {BR, text, man}
-Set its arguments alternately in bold face and roman, without a space
-between the arguments.
-@endDefmac
-
-@Defmac {RB, text, man}
-Set its arguments alternately in roman and bold face, without a space
-between the arguments.
-@endDefmac
-
-@Defmac {B, @Var{text}, man}
-Set @var{text} in bold face.  If no text is present on the line where
-the macro is called, then the text of the next line appears in bold
-face.
-@endDefmac
-
-@Defmac {I, @Var{text}, man}
-@cindex italic fonts @code{man}
-@cindex @code{man} macros, italic fonts
-Set @var{text} in italic.  If no text is present on the line where the
-macro is called, then the text of the next line appears in italic.
-@endDefmac
-
-@c ---------------------------------------------------------------------
-
-@node Miscellaneous man macros, Predefined man strings, Man font macros, man
-@subsection Miscellaneous macros
-
-@pindex grohtml
-@cindex @code{man} macros, default indentation
-@cindex default indentation @code{man}
-The default indentation is 7.2@dmn{n} in troff mode and 7@dmn{n} in
-nroff mode except for @code{grohtml}, which ignores indentation.
-
-@Defmac {DT, , man}
-@cindex tab stops @code{man}
-@cindex @code{man} macros, tab stops
-Set tabs every 0.5@tie{}inches.  Since this macro is always executed
-during a call to the @code{TH} macro, it makes sense to call it only if
-the tab positions have been changed.
-@endDefmac
-
-@Defmac {PD, @Var{nnn}, man}
-@cindex empty space before a paragraph @code{man}
-@cindex @code{man} macros, empty space before a paragraph
-Adjust the empty space before a new paragraph (or section).  The
-optional argument gives the amount of space (default unit is @samp{v});
-without parameter, the value is reset to its default value (1@tie{}line
-in nroff mode, 0.4@dmn{v}@tie{}otherwise).
-
-This affects the macros @code{SH}, @code{SS}, @code{TP}, @code{LP} (as
-well as @code{PP} and @code{P}), @code{IP}, and @code{HP}.
-@endDefmac
-
-The following two macros are included for BSD compatibility.
-
-@Defmac {AT, @Var{system} @Var{release}, man}
-@cindex @code{man}macros, BSD compatibility
-Alter the footer for use with @acronym{AT&T} manpages.  This command
-exists only for compatibility; don't use it.  The first argument
-@var{system} can be:
-
-@table @code
-@item 3
-7th Edition (the default)
-
-@item 4
-System III
-
-@item 5
-System V
-@end table
-
-An optional second argument @var{release} to @code{AT} specifies the
-release number (such as ``System V Release 3'').
-@endDefmac
-
-@Defmac {UC, @Var{version}, man}
-@cindex @code{man}macros, BSD compatibility
-Alters the footer for use with BSD manpages.  This command exists only
-for compatibility; don't use it.  The argument can be:
-
-@table @code
-@item 3
-3rd Berkeley Distribution (the default)
-
-@item 4
-4th Berkeley Distribution
-
-@item 5
-4.2 Berkeley Distribution
-
-@item 6
-4.3 Berkeley Distribution
-
-@item 7
-4.4 Berkeley Distribution
-@end table
-@endDefmac
-
-@c ---------------------------------------------------------------------
-
-@node Predefined man strings, Preprocessors in man pages, Miscellaneous man macros, man
-@subsection Predefined strings
-
-The following strings are defined:
-
-@Defstr {S, man}
-Switch back to the default font size.
-@endDefstr
-
-@Defstr {HF, man}
-The typeface used for headings.
-The default is @samp{B}.
-@endDefstr
-
-@Defstr {R, man}
-The `registered' sign.
-@endDefstr
-
-@Defstr {Tm, man}
-The `trademark' sign.
-@endDefstr
-
-@DefstrList {lq, man}
-@DefstrListEndx {rq, man}
-@cindex @code{lq} glyph, and @code{lq} string @code{man}
-@cindex @code{rq} glyph, and @code{rq} string @code{man}
-Left and right quote.  This is equal to @code{\(lq} and @code{\(rq},
-respectively.
-@endDefstr
-
-@c ---------------------------------------------------------------------
-
-@node Preprocessors in man pages, Optional man extensions, Predefined man strings, man
-@subsection Preprocessors in @file{man} pages
-
-@cindex preprocessor, calling convention
-@cindex calling convention of preprocessors
-If a preprocessor like @code{gtbl} or @code{geqn} is needed, it has
-become common usage to make the first line of the man page look like
-this:
-
-@Example
-'\" @var{word}
-@endExample
-
-@pindex geqn@r{, invocation in manual pages}
-@pindex grefer@r{, invocation in manual pages}
-@pindex gtbl@r{, invocation in manual pages}
-@pindex man@r{, invocation of preprocessors}
-@noindent
-Note the single space character after the double quote.  @var{word}
-consists of letters for the needed preprocessors: @samp{e} for
-@code{geqn}, @samp{r} for @code{grefer}, @samp{t} for @code{gtbl}.
-Modern implementations of the @code{man} program read this first line
-and automatically call the right preprocessor(s).
-
-@c ---------------------------------------------------------------------
-
-@node Optional man extensions,  , Preprocessors in man pages, man
+@node Optional man extensions,  ,  , man
 @subsection Optional @file{man} extensions
 
 @pindex man.local
@@ -2708,8 +2236,9 @@
 @unnumberedsubsubsec Custom headers and footers
 @cindex @code{man} macros, custom headers and footers
 
-In groff versions 1.18.2 and later, you can specify custom headers and
-footers by redefining the following macros in @file{man.local}.
+In @code{groff} versions 1.18.2 and later, you can specify custom
+headers and footers by redefining the following macros in
+@file{man.local}.
 
 @Defmac {PT, , man}
 Control the content of the headers.  Normally, the header prints the
@@ -2721,8 +2250,8 @@
 Control the content of the footers.  Normally, the footer prints the
 page number and the third and fourth arguments to @code{TH}.
 
-Use the @code{FT} number register to specify the footer position.  The
-default is @minus{}0.5@dmn{i}.
+Use the @code{FT} register to specify the footer position.  The default
+is @minus{}0.5@dmn{i}.
 @endDefmac
 
 @unnumberedsubsubsec Ultrix-specific man macros
@@ -2740,7 +2269,8 @@
 @endDefmac
 
 @Defmac {CW, , man}
-Print subsequent text using the constant width (Courier) typeface.
+Print subsequent text using a ``constant-width'' (monospaced) typeface
+(Courier roman).
 @endDefmac
 
 @Defmac {Ds, , man}
@@ -2752,7 +2282,7 @@
 @endDefmac
 
 @Defmac {EX, @Var{indent}, man}
-Begin a non-filled display using the constant width (Courier) typeface.
+Begin a non-filled display using a monospaced typeface (Courier roman).
 Use the optional @var{indent} argument to indent the display.
 @endDefmac
 
@@ -2767,15 +2297,15 @@
 @endDefmac
 
 @Defmac {GL, @Var{text}, man}
-Set @var{text} in Helvetica Oblique.  If no text is present on the line
+Set @var{text} in Helvetica oblique.  If no text is present on the line
 where the macro is called, then the text of the next line appears in
 Helvetica Oblique.
 @endDefmac
 
 @Defmac {HB, @Var{text}, man}
-Set @var{text} in Helvetica Bold.  If no text is present on the line
+Set @var{text} in Helvetica bold.  If no text is present on the line
 where the macro is called, then all text up to the next @code{HB}
-appears in Helvetica Bold.
+appears in Helvetica bold.
 @endDefmac
 
 @Defmac {TB, @Var{text}, man}
@@ -2783,9 +2313,9 @@
 @endDefmac
 
 @Defmac {MS, @Var{title} @Var{sect} @Var{punct}, man}
-Set a manpage reference in Ultrix format.  The @var{title} is in Courier
-instead of italic.  Optional punctuation follows the section number
-without an intervening space.
+Set a man page reference in Ultrix format.  The @var{title} is in
+Courier instead of italic.  Optional punctuation follows the section
+number without an intervening space.
 @endDefmac
 
 @Defmac {NT, @code{C} @Var{title}, man}
@@ -2801,14 +2331,15 @@
 @endDefmac
 
 @Defmac {PN, @Var{path} @Var{punct}, man}
-Set the path name in constant width (Courier), followed by optional
-punctuation.
+Set the path name in a monospaced typeface (Courier roman), followed by
+optional punctuation.
 @endDefmac
 
 @Defmac {Pn, @Var{punct} @Var{path} @Var{punct}, man}
 If called with two arguments, identical to @code{PN}.  If called with
-three arguments, set the second argument in constant width (Courier),
-bracketed by the first and third arguments in the current font.
+three arguments, set the second argument in a monospaced typeface
+(Courier roman), bracketed by the first and third arguments in the
+current font.
 @endDefmac
 
 @Defmac {R, , man}
@@ -2832,13 +2363,13 @@
 
 The following example @file{man.local} file alters the @code{SH} macro
 to add some extra vertical space before printing the heading.  Headings
-are printed in Helvetica Bold.
+are printed in Helvetica bold.
 
 @Example
 .\" Make the heading fonts Helvetica
 .ds HF HB
 .
-.\" Put more whitespace in front of headings.
+.\" Put more space in front of headings.
 .rn SH SH-orig
 .de SH
 .  if t .sp (u;\\nPD*2)
@@ -2849,129 +2380,357 @@
 
 @c =====================================================================
 
-@node mdoc, ms, man, Macro Packages
+@node mdoc, me, man, Major Macro Packages
 @section @file{mdoc}
 @cindex @code{mdoc} macros
 
-@c XXX documentation
-@c XXX this is a placeholder until we get stuff knocked into shape
-See the @cite{groff_mdoc(7)} man page (type @command{man groff_mdoc}
-at the command line).
+@code{groff}'s implementation of the BSD @file{doc} package for man
+pages is documented in the @cite{groff_mdoc@r{(7)}} man page.  Type
+@samp{man groff_mdoc} at the command line to view it.
 
 
 @c =====================================================================
 
-@node ms, me, mdoc, Macro Packages
+@node me, mm, mdoc, Major Macro Packages
+@section @file{me}
+@cindex @code{me} macro package
+
+@code{groff}'s implementation of the BSD @file{me} macro package is
+documented using itself.  A tutorial, @file{meintro.me}, and reference,
+@file{meref.me}, are available in @code{groff}'s documentation
+directory.  A @cite{groff_me@r{(7)}} man page is also available and
+identifies the installation path for these documents.  Type @samp{man
+groff_me} at the command line to view it.
+
+A French translation of the tutorial is available as
+@file{meintro_fr.me} and installed parallel to the English version.
+
+
+@c =====================================================================
+
+@node mm, mom, me, Major Macro Packages
+@section @file{mm}
+@cindex @code{mm} macro package
+
+@code{groff}'s implementation of the @acronym{AT&T} memorandum macro
+package is documented in the @cite{groff_mm@r{(7)}} man page.  Type
+@samp{man groff_mm} at the command line) to view it.
+
+A Swedish localization of @file{mm} is also available; see
+@cite{groff_mmse@r{(7)}}.
+
+
+@c =====================================================================
+
+@node mom, ms, mm, Major Macro Packages
+@section @file{mom}
+@cindex @code{mom} macro package
+
+The main documentation files for the @file{mom} macros are in
+@acronym{HTML} format.  Additional, useful documentation is in
+@acronym{PDF} format.  See the @cite{groff@r{(1)}} man page, section
+``Installation Directories'', for their location.
+
+@itemize @bullet
+@item
+@file{toc.html}
+@noindent
+Entry point to the full mom manual.
+
+@item
+@file{macrolist.html}
+@noindent
+Hyperlinked index of macros with brief descriptions, arranged by
+category.
+
+@item
+@file{mom-pdf.pdf}
+@noindent
+@acronym{PDF} features and usage.
+@end itemize
+
+The mom macros are in active development between @code{groff} releases.
+The most recent version, along with up-to-date documentation, is
+available at @uref{http://www.schaffter.ca/mom/mom-05.html}.
+
+The @cite{groff_mom@r{(7)}} man page (type @samp{man groff_mom} at
+the command line) contains a partial list of available macros, however
+their usage is best understood by consulting the @acronym{HTML}
+documentation.
+
+
+@c =====================================================================
+
+@codequotebacktick on
+@codequoteundirected on
+
+@node ms,  , mom, Major Macro Packages
 @section @file{ms}
-@cindex @code{ms} macros
+@cindex @file{ms} macros
 
-The @file{-ms} macros are suitable for reports, letters, books, user
-manuals, and so forth.  The package provides macros for cover pages,
-section headings, paragraphs, lists, footnotes, pagination, and a table
-of contents.
+The @file{ms} (``manuscript'') package is suitable for the preparation
+of letters, memoranda, reports, and books.  These @code{groff}
+macros feature cover page and table of contents generation,
+automatically numbered headings, several paragraph styles, a variety of
+text styling options, footnotes, and multi-column page layouts.
+@file{ms} supports the @command{tbl}, @command{eqn}, @command{pic}, and
+@command{refer} preprocessors for inclusion of tables, mathematical
+equations, diagrams, and standardized bibliographic citations.  This
+implementation is mostly compatible with the documented interface and
+behavior of AT&T Unix Version@tie{}7 @file{ms}.  Many extensions from
+4.2BSD (Berkeley)
+@c Few changes were made in 4.3, Tahoe, Reno, or 4.4.
+and Tenth Edition Research Unix have been recreated.
 
 @menu
-* ms Intro::
-* General ms Structure::
-* ms Document Control Registers::
-* ms Cover Page Macros::
+* ms Introduction::
+* ms Document Structure::
+* ms Document Control Settings::
+* ms Document Description Macros::
 * ms Body Text::
 * ms Page Layout::
 * Differences from AT&T ms::
-* Naming Conventions::
+* ms Legacy Features::
+* ms Naming Conventions::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node ms Intro, General ms Structure, ms, ms
-@subsection Introduction to @file{ms}
+@node ms Introduction, ms Document Structure, ms, ms
+@subsection Introduction
 
-The original @file{-ms} macros were included with @acronym{AT&T}
-@code{troff} as well as the @file{man} macros.  While the @file{man}
-package is intended for brief documents that can be read on-line as well
-as printed, the @file{ms} macros are suitable for longer documents that
-are meant to be printed rather than read on-line.
+The @file{ms} macros are the oldest surviving package for @code{roff}
+systems.@footnote{While manual @emph{pages} are older, early ones used
+macros supplanted by the @file{man} package of Seventh Edition Unix
+(1979).  @file{ms} shipped with Sixth Edition (1975) and was documented
+by Mike Lesk in a Bell Labs internal memorandum.}  While the @file{man}
+package was designed for brief reference documents, the @file{ms} macros
+are also suitable for longer works intended for printing and possible
+publication.
 
-The @file{ms} macro package included with @code{groff} is a complete,
-bottom-up re-implementation.  Several macros (specific to @acronym{AT&T}
-or Berkeley) are not included, while several new commands are.
-@xref{Differences from AT&T ms}, for more information.
+@menu
+* ms basic information::
+@end menu
 
 @c ---------------------------------------------------------------------
 
-@node General ms Structure, ms Document Control Registers, ms Intro, ms
-@subsection General structure of an @file{ms} document
-@cindex @code{ms} macros, general structure
+@node ms basic information, ms Document Structure, ms Introduction, ms Introduction
+@subsubsection Basic information
+
+@file{ms} documents are plain text files; prepare them with your
+preferred text editor.  If you're in a hurry to start, know that
+@file{ms} needs one of its macros called at the beginning of a document
+so that it can initialize.  A @dfn{macro} is a formatting instruction to
+@file{ms}.  Put a macro call on a line by itself.  Use @samp{.PP} if you
+want your paragraph's first line to be indented, or @samp{.LP} if you
+don't.
+
+After that, start typing normally.  It is a good practice to start each
+sentence on a new line, or to put two spaces after sentence-ending
+punctuation, so that the formatter knows where the sentence boundaries
+are.  You can separate paragraphs with further paragraphing macros, or
+with blank lines, and you can indent with tabs.  When you need one of
+the features mentioned earlier (@pxref{ms}), return to this part of the
+manual.
+
+Format the document with the @command{groff} command.  @command{nroff}
+can be useful for previewing.
+
+@CartoucheExample
+$ editor radical.ms
+$ nroff -ww -z -ms radical.ms # check for errors
+$ nroff -ms radical.ms | less -R
+$ groff -T ps -ms radical.ms > radical.ps
+$ see radical.ps
+@endCartoucheExample
+
+Our @file{radical.ms} document might look like this.
+
+@CartoucheExample
+.LP
+Radical novelties are so disturbing that they tend to be
+suppressed or ignored, to the extent that even the
+possibility of their existence in general is more often
+denied than admitted.
+
+@arrow{}That's what Dijkstra said, anyway.
+@endCartoucheExample
+
+@file{ms} exposes many aspects of document layout to user control via
+@code{groff}'s @dfn{registers} and @dfn{strings}, which store numbers
+and text, respectively.  Measurements in @code{groff} are expressed with
+a suffix called a @dfn{scaling unit}.
+
+@table @code
+@item i
+inches
+
+@item c
+centimeters
+
+@item p
+points (1/72 inch)
+
+@item P
+picas (1/6 inch)
+
+@item v
+vees; current vertical spacing
+
+@item m
+ems; width of an ``M'' in the current font
+
+@item n
+ens; one-half em
+@end table
+
+Set registers with the @code{nr} request and strings with the @code{ds}
+request.  @dfn{Requests} are like macro calls; they go on lines by
+themselves and start with the @dfn{control character}, a dot (@code{.}).
+The difference is that they directly instruct the formatter program,
+rather than the macro package.  We'll discuss a few as applicable.  It
+is wise to specify a scaling unit when setting any register that
+represents a length, size, or distance.
+
+@CartoucheExample
+.nr PS 10.5p \" Use 10.5-point type.
+.ds FAM P    \" Use Palatino font family.
+@endCartoucheExample
+
+@noindent
+In the foregoing, we see that @code{\"} begins a comment.  This is an
+example of an @dfn{escape sequence}, the other kind of formatting
+instruction.  Escape sequences can appear anywhere.  They begin with the
+escape character (@code{\}) and are followed by at least one more
+character.  @file{ms} documents
+@c like this one
+tend to use only a few of @code{groff}'s many requests and escape
+sequences; see @ref{Request Index} and @ref{Escape Sequence Index} or
+the @cite{groff@r{(7)}} man page for complete lists.
+
+@table @code
+@item \"
+Begin comment; ignore remainder of line.
+
+@item \n@var{reg}
+Interpolate value of register @var{reg}.
+
+@item \*@var{str}
+Interpolate contents of string @var{str}.
 
-The @file{ms} macro package expects a certain amount of structure, but
-not as much as packages such as @file{man} or @file{mdoc}.
+@item \*@var{s}
+abbreviation of @code{\*@var{s}}; the name @var{s} must be only one
+character
 
-The simplest documents can begin with a paragraph macro (such as
-@code{LP} or @code{PP}), and consist of text separated by paragraph
-macros or even blank lines.  Longer documents have a structure as
-follows:
+@item \@var{char}
+Interpolate glyph of special character named @var{char}.
+
+@item \&
+dummy character
+
+@item \~
+Insert an unbreakable space that is adjustable like a normal space.
+
+@item \|
+Move horizontally by one-sixth em (``thin space'').
+@end table
+
+Prefix any words that start with a dot @samp{.} or neutral apostrophe
+@samp{'} with @code{\&} if they are at the beginning of an input line
+(or might become that way in editing) to prevent them from being
+interpreted as macro calls or requests.  Suffix @samp{.}, @samp{?}, and
+@samp{!} with @code{\&} when needed to cancel end-of-sentence detection.
+
+@CartoucheExample
+My exposure was \&.5 to \&.6 Sv of neutrons, said Dr.\&
+Wallace after the criticality incident.
+@endCartoucheExample
+
+@c ---------------------------------------------------------------------
+
+@node ms Document Structure, ms Document Control Settings, ms Introduction, ms
+@subsection Document Structure
+@cindex @file{ms} macros, general structure
+
+The @file{ms} macro package expects a certain amount of structure:
+a well-formed document contains at least one paragraphing or heading
+macro call.  Longer documents have a structure as follows.
 
 @table @strong
 @item Document type
-If you invoke the @code{RP} (report) macro on the first line of the
-document, @code{groff} prints the cover page information on its own
-page; otherwise it prints the information on the first page with your
-document text immediately following.  Other document formats found in
-@acronym{AT&T} @code{troff} are specific to @acronym{AT&T} or Berkeley,
-and are not supported in @code{groff}.
+Calling the @code{RP} macro at the beginning of your document puts the
+document description (see below) on a cover page.  Otherwise, @file{ms}
+places the information (if any) on the first page, followed immediately
+by the body text.  Some document types found in other @file{ms}
+implementations are specific to @acronym{AT&T} or Berkeley, and are not
+supported by @code{groff} @file{ms}.
 
 @item Format and layout
-By setting number registers, you can change your document's type (font
-and size), margins, spacing, headers and footers, and footnotes.
-@xref{ms Document Control Registers}, for more details.
-
-@item Cover page
-A cover page consists of a title, the author's name and institution, an
-abstract, and the date.@footnote{Actually, only the title is required.}
-@xref{ms Cover Page Macros}, for more details.
-
-@item Body
-Following the cover page is your document.  You can use the @file{ms}
-macros to write reports, letters, books, and so forth.  The package is
-designed for structured documents, consisting of paragraphs interspersed
-with headings and augmented by lists, footnotes, tables, and other
-common constructs.  @xref{ms Body Text}, for more details.
-
-@item Table of contents
-Longer documents usually include a table of contents, which you can
-invoke by placing the @code{TC} macro at the end of your document.  The
-@file{ms} macros have minimal indexing facilities, consisting of the
-@code{IX} macro, which prints an entry on standard error.  Printing the
-table of contents at the end is necessary since @code{groff} is a
-single-pass text formatter, thus it cannot determine the page number of
-each section until that section has actually been set and printed.
-Since @file{ms} output is intended for hardcopy, you can manually
-relocate the pages containing the table of contents between the cover
-page and the body text after printing.
+By setting registers and strings, you can configure your document's
+typeface, margins, spacing, headers and footers, and footnote
+arrangement.  @xref{ms Document Control Settings}.
+
+@item Document description
+A document description consists of any of: a title, one or more authors'
+names and affiliated institutions, an abstract, and a date or other
+identifier.  @xref{ms Document Description Macros}.
+
+@item Body text
+The main matter of your document follows its description (if any).
+@file{ms} supports highly structured text consisting of paragraphs
+interspersed with multi-level headings (chapters, sections, subsections,
+and so forth) and augmented by lists, footnotes, tables, diagrams, and
+similar material.  @xref{ms Body Text}.
+
+@item Tables of contents
+Macros enable the collection of entries for a table of contents (or
+index) as the material they discuss appears in the document.  You then
+call a macro to emit the table of contents at the end of your document.
+The table of contents must necessarily follow the rest of the text since
+GNU @code{troff} is a single-pass formatter; it thus cannot determine
+the page number of a division of the text until it has been set and
+output.  Since @file{ms} was designed for the production of hard copy,
+the traditional procedure was to manually relocate the pages containing
+the table of contents between the cover page and the body text.  Today,
+page resequencing is more often done in the digital domain.  An index
+works similarly, but because it typically needs to be sorted after
+collection, its preparation requires separate processing.
 @end table
 
 @c ---------------------------------------------------------------------
 
-@node ms Document Control Registers, ms Cover Page Macros, General ms Structure, ms
-@subsection Document control registers
-@cindex @code{ms} macros, document control registers
-
-The following is a list of document control number registers.  For the
-sake of consistency, set registers related to margins at the beginning
-of your document, or just after the @code{RP} macro.  You can set other
-registers later in your document, but you should keep them together at
-the beginning to make them easy to find and edit as necessary.
+@node ms Document Control Settings, ms Document Description Macros, ms Document Structure, ms
+@subsection Document Control Settings
+@cindex @file{ms} macros, document control settings
+
+@file{ms} exposes many aspects of document layout to user control via
+@code{groff} requests.  To use them, you must understand how to define
+registers and strings.
+
+@Defreq {nr, reg value}
+Set register @var{reg} to @var{value}.  If @var{reg} doesn't exist, GNU
+@code{troff} creates it.
+@endDefreq
+
+@Defreq {ds, name contents}
+Set string @var{name} to @var{contents}.
+@endDefreq
+
+A list of document control registers and strings follows.  For any
+parameter whose default is unsatisfactory, define its register or string
+before calling any @file{ms} macro other than @code{RP}.
 
-@unnumberedsubsubsec Margin Settings
+@unnumberedsubsubsec Margin settings
 
 @Defmpreg {PO, ms}
-Defines the page offset (i.e., the left margin).  There is no explicit
-right margin setting; the combination of the @code{PO} and @code{LL}
-registers implicitly define the right margin width.
+Defines the page offset (i.e., the left margin).
+@c not in V6
 
 Effective: next page.
 
-Default value: 1@dmn{i}.
+Default: Varies by output device and paper format; 1@dmn{i} is used for
+typesetters using U.S.@: letter paper, and zero for terminals.
+@xref{Paper Format}.
 @endDefmpreg
 
 @Defmpreg {LL, ms}
@@ -2979,20 +2738,25 @@
 
 Effective: next paragraph.
 
-Default: 6@dmn{i}.
+Default: Varies by output device and paper format; 6.5@dmn{i} is used
+for typesetters using U.S.@: letter paper (@pxref{Paper Format}) and
+65@dmn{n} on terminals.
 @endDefmpreg
 
 @Defmpreg {LT, ms}
-Defines the title length (i.e., the header and footer width).  This
-is usually the same as @code{LL}, but not necessarily.
+Defines the title line length (i.e., the header and footer width).  This
+is usually the same as @code{LL}, but need not be.
 
 Effective: next paragraph.
 
-Default: 6@dmn{i}.
+Default: Varies by output device and paper format; 6.5@dmn{i} is used
+for typesetters using U.S.@: letter paper (@pxref{Paper Format}) and
+65@dmn{n} on terminals.
 @endDefmpreg
 
 @Defmpreg {HM, ms}
 Defines the header margin height at the top of the page.
+@c not in V6
 
 Effective: next page.
 
@@ -3001,84 +2765,108 @@
 
 @Defmpreg {FM, ms}
 Defines the footer margin height at the bottom of the page.
+@c not in V6
 
 Effective: next page.
 
 Default: 1@dmn{i}.
 @endDefmpreg
 
-@unnumberedsubsubsec Text Settings
+@unnumberedsubsubsec Titles (headers, footers)
 
-@Defmpreg {PS, ms}
-Defines the point size of the body text.  If the value is larger than or
-equal to 1000, divide it by 1000 to get a fractional point size.  For
-example, @samp{.nr PS 10250} sets the document's point size to
-10.25@dmn{p}.
+@Defmpstr {LH, ms}
+Defines the text displayed in the left header position.
 
-Effective: next paragraph.
+Effective: next header.
 
-Default: 10@dmn{p}.
-@endDefmpreg
+Default: empty.
+@endDefmpstr
 
-@Defmpreg {VS, ms}
-Defines the space between lines (line height plus leading).  If the
-value is larger than or equal to 1000, divide it by 1000 to get a
-fractional point size.  Due to backwards compatibility, @code{VS} must
-be smaller than 40000 (this is 40.0@dmn{p}).
+@Defmpstr {CH, ms}
+Defines the text displayed in the center header position.
 
-Effective: next paragraph.
+Effective: next header.
 
-Default: 12@dmn{p}.
-@endDefmpreg
+Default: @samp{-\n%-}.
+@endDefmpstr
 
-@Defmpreg {PSINCR, ms}
-Defines an increment in point size, which is applied to section headings
-at nesting levels below the value specified in @code{GROWPS}.  The value
-of @code{PSINCR} should be specified in points, with the @dmn{p} scaling
-factor, and may include a fractional component; for example,
-@w{@samp{.nr PSINCR 1.5p}} sets a point size increment of 1.5@dmn{p}.
+@Defmpstr {RH, ms}
+Defines the text displayed in the right header position.
 
-Effective: next section heading.
+Effective: next header.
 
-Default: 1@dmn{p}.
+Default: empty.
+@endDefmpstr
+
+@Defmpstr {LF, ms}
+Defines the text displayed in the left footer position.
+
+Effective: next footer.
+
+Default: empty.
+@endDefmpstr
+
+@Defmpstr {CF, ms}
+Defines the text displayed in the center footer position.
+
+Effective: next footer.
+
+Default: empty.
+@endDefmpstr
+
+@Defmpstr {RF, ms}
+Defines the text displayed in the right footer position.
+
+Effective: next footer.
+
+Default: empty.
+@endDefmpstr
+
+@unnumberedsubsubsec Text settings
+
+@Defmpreg {PS, ms}
+Defines the type size of the body text.
+
+Effective: next paragraph.
+
+Default: 10@dmn{p}.
 @endDefmpreg
 
-@Defmpreg {GROWPS, ms}
-Defines the heading level below which the point size increment set by
-@code{PSINCR} becomes effective.  Section headings at and above the
-level specified by @code{GROWPS} are printed at the point size set by
-@code{PS}; for each level below the value of @code{GROWPS}, the point
-size is increased in steps equal to the value of @code{PSINCR}.  Setting
-@code{GROWPS} to any value less than@tie{}2 disables the incremental
-heading size feature.
+@Defmpreg {VS, ms}
+Defines the vertical spacing (type size plus leading).
 
-Effective: next section heading.
+Effective: next paragraph.
 
-Default: 0.
+Default: 12@dmn{p}.
 @endDefmpreg
 
 @Defmpreg {HY, ms}
-Defines the hyphenation level.  @code{HY} sets safely the value of the
-low-level @code{hy} register.  Setting the value of @code{HY} to@tie{}0
-is equivalent to using the @code{nh} request.
+Defines the automatic hyphenation mode used with the @code{hy} request.
+Setting @code{HY} to@tie{}0 is equivalent to using the @code{nh}
+request.  This is a Tenth Edition Research Unix extension.
+@c possibly 9th, but definitely not Berkeley
 
 Effective: next paragraph.
 
 Default: 6.
 @endDefmpreg
 
-@Defmpreg {FAM, ms}
-Defines the font family used to typeset the document.
+@Defmpstr {FAM, ms}
+Defines the font family used to typeset the document.  This is a GNU
+extension.
 
 Effective: next paragraph.
 
-Default: as defined in the output device.
-@endDefmpreg
+Default: defined by the output device; often @samp{T} (@pxref{ms Body
+Text})
+@endDefmpstr
 
-@unnumberedsubsubsec Paragraph Settings
+@unnumberedsubsubsec Paragraph settings
 
 @Defmpreg {PI, ms}
-Defines the initial indentation of a (@code{PP} macro) paragraph.
+Defines the indentation amount used by the @code{PP}, @code{IP} (unless
+overridden by an optional argument), @code{XP}, and @code{RS} macros.
+@c not in V6
 
 Effective: next paragraph.
 
@@ -3087,16 +2875,16 @@
 
 @Defmpreg {PD, ms}
 Defines the space between paragraphs.
+@c not in V6
 
 Effective: next paragraph.
 
-Default: 0.3@dmn{v}.
+Default: 0.3@dmn{v} (1@dmn{v} on low-resolution devices).
 @endDefmpreg
 
 @Defmpreg {QI, ms}
-Defines the indentation on both sides of a quoted (@code{QP},
-@code{QS}, and @code{QE} macros)
-paragraph.
+Defines the indentation amount used on both sides of a paragraph set
+with the @code{QP} or between the @code{QS} and @code{QE} macros.
 
 Effective: next paragraph.
 
@@ -3104,44 +2892,72 @@
 @endDefmpreg
 
 @Defmpreg {PORPHANS, ms}
-Defines the minimum number of initial lines of any paragraph that
-should be kept together, to avoid orphan lines at the bottom of a page.
-If a new paragraph is started close to the bottom of a page, and there
-is insufficient space to accommodate @code{PORPHANS} lines before an
-automatic page break, then the page break is forced, before the start of
-the paragraph.
+Defines the minimum number of initial lines of any paragraph that must
+be kept together to avoid isolated lines at the bottom of a page.  If a
+new paragraph is started close to the bottom of a page, and there is
+insufficient space to accommodate @code{PORPHANS} lines before an
+automatic page break, then a page break is forced before the start of
+the paragraph.  This is a GNU extension.
 
 Effective: next paragraph.
 
 Default: 1.
 @endDefmpreg
 
+@unnumberedsubsubsec Heading settings
+
+@Defmpreg {PSINCR, ms}
+Defines an increment in type size to be applied to a heading at a
+lesser depth than that specified in @code{GROWPS}.  The value of
+@code{PSINCR} should be specified in points with the @dmn{p} scaling
+unit and may include a fractional component; for example, @w{@samp{.nr
+PSINCR 1.5p}} sets a type size increment of 1.5@dmn{p}.  This is a GNU
+extension.
+
+Effective: next heading.
+
+Default: 1@dmn{p}.
+@endDefmpreg
+
+@Defmpreg {GROWPS, ms}
+Defines the heading depth above which the type size increment set by
+@code{PSINCR} becomes effective.  For each heading depth less than the
+value of @code{GROWPS}, the type size is increased by @code{PSINCR}.
+Setting @code{GROWPS} to any value less than@tie{}2 disables the
+incremental heading size feature.  This is a GNU extension.
+
+Effective: next heading.
+
+Default: 0.
+@endDefmpreg
+
 @Defmpreg {HORPHANS, ms}
-Defines the minimum number of lines of the following paragraph that
-should be kept together with any section heading introduced by the
-@code{NH} or @code{SH} macros.  If a section heading is placed close to
-the bottom of a page, and there is insufficient space to accommodate
-both the heading and at least @code{HORPHANS} lines of the following
+Defines the minimum number of lines of an immediately succeeding
+paragraph that should be kept together with any heading introduced by
+the @code{NH} or @code{SH} macros.  If a heading is placed close to the
+bottom of a page, and there is insufficient space to accommodate both
+the heading and at least @code{HORPHANS} lines of the following
 paragraph, before an automatic page break, then the page break is forced
-before the heading.
+before the heading.  This is a GNU extension.
 
 Effective: next paragraph.
 
 Default: 1.
 @endDefmpreg
 
-@unnumberedsubsubsec Footnote Settings
+@Defmpstr {SN-STYLE, ms}
+Defines the style used to print numbered headings.  @xref{Headings in
+ms}.  This is a GNU extension.
 
-@Defmpreg {FL, ms}
-Defines the length of a footnote.
+Effective: next heading.
 
-Effective: next footnote.
+Default: alias of @code{SN-DOT}
+@endDefmpstr
 
-Default: @math{@code{@\nLL} * 5 / 6}.
-@endDefmpreg
+@unnumberedsubsubsec Footnote settings
 
 @Defmpreg {FI, ms}
-Defines the footnote indentation.
+Defines the footnote indentation.  This is a Berkeley extension.
 
 Effective: next footnote.
 
@@ -3149,21 +2965,27 @@
 @endDefmpreg
 
 @Defmpreg {FF, ms}
-The footnote format:
+Defines the format of automatically numbered footnotes,
+and those for which the @code{FS} request is given a marker argument, at
+the bottom of a column or page.  This is a Berkeley extension.
 @table @code
 @item 0
-Print the footnote number as a superscript; indent the footnote
-(default).
+Set an automatic number@footnote{defined in @ref{ms Footnotes}} as a
+superscript (on typesetter devices) or surrounded by square brackets (on
+terminals).  The footnote paragraph is indented as with @code{PP} if
+there is an @code{FS} argument or an automatic number, and as with
+@code{LP} otherwise.  This is the default.
 
 @item 1
-Print the number followed by a period (like 1.@:) and indent the
-footnote.
+As @code{0}, but set the marker as regular text and follow an
+automatic number with a period.
 
 @item 2
-Like 1, without an indentation.
+As @code{1}, but without indentation (like @code{LP}).
 
 @item 3
-Like 1, but print the footnote number as a hanging paragraph.
+As @code{1}, but set the footnote paragraph with the marker hanging
+(like @code{IP}).
 @end table
 
 Effective: next footnote.
@@ -3172,131 +2994,173 @@
 @endDefmpreg
 
 @Defmpreg {FPS, ms}
-Defines the footnote point size.  If the value is larger than or equal
-to 1000, divide it by 1000 to get a fractional point size.
+Defines the footnote type size.
 
 Effective: next footnote.
 
-Default: @math{@code{@\nPS} - 2}.
+Default: @code{\nPS - 2p}.
 @endDefmpreg
 
 @Defmpreg {FVS, ms}
-Defines the footnote vertical spacing.  If the value is larger than or
-equal to 1000, divide it by 1000 to get a fractional point size.
+Defines the footnote vertical spacing.
 
 Effective: next footnote.
 
-Default: @math{@code{@\nFPS} + 2}.
+Default: @code{\nFPS + 2p}.
 @endDefmpreg
 
 @Defmpreg {FPD, ms}
-Defines the footnote paragraph spacing.
+Defines the footnote paragraph spacing.  This is a GNU extension.
 
 Effective: next footnote.
 
-Default: @math{@code{@\nPD} / 2}.
+Default: @code{\nPD / 2}.
 @endDefmpreg
 
-@unnumberedsubsubsec Miscellaneous Number Registers
+@Defmpstr {FR, ms}
+Defines the ratio of the footnote line length to the current line
+length.  This is a GNU extension.
+
+Effective: next footnote in single-column arrangements, next page
+otherwise.
+
+Default: @code{11/12}.
+@endDefmpstr
+
+@unnumberedsubsubsec Display settings
+
+@Defmpreg {DD, ms}
+Sets the display distance---the vertical spacing before and after a
+display, a @code{tbl} table, an @code{eqn} equation, or a @code{pic}
+image.  This is a Berkeley extension.
+
+Effective: next display boundary.
+
+Default: 0.5@dmn{v} (1@dmn{v} on low-resolution devices).
+@endDefmpreg
+
+@Defmpreg {DI, ms}
+Sets the default amount by which to indent a display started with
+@code{DS} and @code{ID} without arguments, to @samp{.DS@tie{}I} without
+an indentation argument, and to equations set with @samp{.EQ@tie{}I}.
+This is a GNU extension.
+
+Effective: next indented display.
+
+Default: 0.5@dmn{i}.
+@endDefmpreg
+
+@unnumberedsubsubsec Other settings
 
 @Defmpreg {MINGW, ms}
-Defines the minimum width between columns in a multi-column document.
+Defines the default minimum width between columns in a multi-column
+document.  This is a GNU extension.
 
 Effective: next page.
 
 Default: 2@dmn{n}.
 @endDefmpreg
 
-@Defmpreg {DD, ms}
-Sets the vertical spacing before and after a display, a @code{tbl} table, an
-@code{eqn} equation, or a @code{pic} image.
+@Defmpreg {TC-MARGIN, ms}
+Defines the width of the field in which page numbers are set in a table
+of contents entry; the right margin thus moves inboard by this amount.
+This is a GNU extension.
 
-Effective: next paragraph.
+Effective: next @code{PX} call.
 
-Default: 0.5@dmn{v}.
+Default: @code{\w'000'}
 @endDefmpreg
 
-@c ---------------------------------------------------------------------
+@c XXX: Normally we'd have an entry for TC-LEADER here, but it's a
+@c special character and we have no custom Texinfo macros for defining
+@c (and indexing) these.  There would be little point in an index for
+@c one item, and the plan is to drop this entire @section from this
+@c manual once doc/ms.ms is ready.  See Savannah #60061.
 
-@node ms Cover Page Macros, ms Body Text, ms Document Control Registers, ms
-@subsection Cover page macros
-@cindex @code{ms} macros, cover page
-@cindex cover page macros, @code{ms}
-
-Use the following macros to create a cover page for your document in the
-order shown.
-
-@Defmac {RP, @code{no}, ms}
-Specifies the report format for your document.  The report format
-creates a separate cover page.  The default action (no @code{RP} macro)
-is to print a subset of the cover page on page@tie{}1 of your document.
-
-If you use the word @code{no} as an optional argument, @code{groff}
-prints a title page but does not repeat any of the title page
-information (title, author, abstract, etc.@:) on page@tie{}1 of the
-document.
-@endDefmac
-
-@Defmac {P1, , ms}
-(P-one) Prints the header on page@tie{}1.  The default is to suppress
-the header.
-@endDefmac
-
-@Defmac {DA, @dots{}, ms}
-(optional) Prints the current date, or the arguments to the macro if
-any, on the title page (if specified) and in the footers.  This is the
-default for @code{nroff}.
-@endDefmac
+@c ---------------------------------------------------------------------
 
-@Defmac {ND, @dots{}, ms}
-(optional) Prints the current date, or the arguments to the macro if
-any, on the title page (if specified) but not in the footers.  This is
-the default for @code{troff}.
+@node ms Document Description Macros, ms Body Text, ms Document Control Settings, ms
+@subsection Document Description Macros
+@cindex @file{ms} macros, document description
+@cindex document description macros, @file{ms}
+
+Only the simplest document lacks a title.@footnote{Distinguish a
+document title from ``titles'', which are what @code{roff} systems call
+headers and footers collectively.}  As its level of sophistication (or
+complexity) increases, it tends to acquire a date of revision,
+explicitly identified authors, sponsoring institutions for authors, and,
+at the rarefied heights, an abstract of its content.  Define these
+data by calling the macros below in the order shown; @code{DA} or
+@code{ND} can be called to set the document date (or other identifier)
+at any time before (a) the abstract, if present, or (b) its information
+is required in a header or footer.  Use of these macros is optional,
+except that @code{TL} is mandatory if any of @code{RP}, @code{AU},
+@code{AI}, or @code{AB} is called, and @code{AE} is mandatory if
+@code{AB} is called.
+
+@Defmac {RP, @code{no-repeat-info} @code{no-renumber}, ms}
+Use the ``report'' (@acronym{AT&T}: ``released paper'') format for your
+document, creating a separate cover page.  The default arrangement is to
+place most of the document description (title, author names and
+institutions, and abstract, but not the date) at the top of the first
+page.  If the optional @code{no-repeat-info} argument is given,
+@file{ms} produces a cover page but does not repeat any of its
+information subsequently (but see the @code{DA} macro below regarding
+the date).  Normally, @code{RP} sets the page number following the cover
+page to@tie{}1.  Specifying the optional @code{no-renumber} argument
+suppresses this alteration.  Optional arguments can occur in any order.
+@code{no} is recognized as a synonym of @code{no-repeat-info} for
+@code{AT&T} compatibility.
 @endDefmac
 
 @Defmac {TL, , ms}
-Specifies the document title.  @code{groff} collects text following the
-@code{TL} macro into the title, until reaching the author name or
-abstract.
+Specify the document title.  @file{ms} collects text on input lines
+following this call into the title until reaching @code{AU}, @code{AB},
+or a heading or paragraphing macro call.
 @endDefmac
 
 @Defmac {AU, , ms}
-Specifies the author's name, which appears on the line (or lines)
-immediately following.  You can specify multiple authors as follows:
-
-@Example
-.AU
-John Doe
-.AI
-University of West Bumblefuzz
-.AU
-Martha Buck
-.AI
-Monolithic Corporation
-
-...
-@endExample
+Specify an author's name.  @file{ms} collects text on input lines
+following this call into the author's name until reaching @code{AI},
+@code{AB}, another @code{AU}, or a heading or paragraphing macro call.
+Call it repeatedly to specify multiple authors.
 @endDefmac
 
 @Defmac {AI, , ms}
-Specifies the author's institution.  You can specify multiple
-institutions in the same way that you specify multiple authors.
+Specify the preceding author's institution.  An @code{AU} call is
+usefully followed by at most one @code{AI} call; if there are more, the
+last @code{AI} call controls.  @file{ms} collects text on input lines
+following this call into the author's institution until reaching
+@code{AU}, @code{AB}, or a heading or paragraphing macro call.
+@endDefmac
+
+@Defmac {DA, @Var{x} @dots{}, ms}
+Typeset the current date, or any arguments @var{x}, in the center
+footer, and, if @code{RP} is also called, left-aligned at the end of the
+description information on the cover page.
+@endDefmac
+
+@Defmac {ND, @Var{x} @dots{}, ms}
+Typeset the current date, or any arguments @var{x}, if @code{RP} is also
+called, left-aligned at the end of the document description on the cover
+page.  This is @code{groff} @file{ms}'s default.
 @endDefmac
 
 @Defmac {AB, @code{no}, ms}
-Begins the abstract.  The default is to print the word
-@acronym{ABSTRACT}, centered and in italics, above the text of the
-abstract.  The word @code{no} as an optional argument suppresses this
-heading.
+Begin the abstract.  @file{ms} collects text on input lines following
+this call into the abstract until reaching an @code{AE} call.  By
+default, @file{ms} places the word ``ABSTRACT'' centered and in italics
+above the text of the abstract.  The optional argument @code{no}
+suppresses this heading.
 @endDefmac
 
 @Defmac {AE, , ms}
-Ends the abstract.
+End the abstract.
 @endDefmac
 
-The following is example mark-up for a title page.
-@cindex title page, example markup
-@cindex example markup, title page
+An example document description, using a cover page, follows.
+@cindex cover page in @file{ms}, example markup
+@cindex example markup, cover page in @file{ms}
 
 @CartoucheExample
 .RP
@@ -3304,362 +3168,516 @@
 The Inevitability of Code Bloat
 in Commercial and Free Software
 .AU
-J. Random Luser
+J.\& Random Luser
 .AI
 University of West Bumblefuzz
 .AB
-This report examines the long-term growth
-of the code bases in two large, popular software
-packages; the free Emacs and the commercial
-Microsoft Word.
-While differences appear in the type or order
-of features added, due to the different
-methodologies used, the results are the same
-in the end.
+This report examines the long-term growth of the code
+bases in two large,
+popular software packages;
+the free Emacs and the commercial Microsoft Word.
+While differences appear in the type or order of
+features added,
+due to the different methodologies used,
+the results are the same in the end.
 .PP
-The free software approach is shown to be
-superior in that while free software can
-become as bloated as commercial offerings,
-free software tends to have fewer serious
-bugs and the added features are in line with
-user demand.
+The free software approach is shown to be superior in
+that while free software can become as bloated as
+commercial offerings,
+free software tends to have fewer serious bugs and the
+added features are more in line with user demand.
 .AE
 
-... the rest of the paper follows ...
+@r{@dots{}the rest of the paper@dots{}}
 @endCartoucheExample
 
 @c ---------------------------------------------------------------------
 
-@node ms Body Text, ms Page Layout, ms Cover Page Macros, ms
-@subsection Body text
-@cindex @code{ms} macros, body text
-
-This section describes macros used to mark up the body of your document.
-Examples include paragraphs, sections, and other groups.
+@node ms Body Text, ms Page Layout, ms Document Description Macros, ms
+@subsection Body Text
+@cindex @file{ms} macros, body text
+
+A variety of macros, registers, and strings can be used to structure and
+style the body of your document.  They organize your text into
+paragraphs, headings, footnotes, and inclusions of material such as
+tables and figures.
 
 @menu
+* Text settings in ms::
+* Typographical symbols in ms::
 * Paragraphs in ms::
 * Headings in ms::
-* Highlighting in ms::
+* Typeface and decoration::
 * Lists in ms::
-* Indentation values in ms::
-* Tabstops in ms::
-* ms Displays and Keeps::
+* Indented regions in ms::
+* ms keeps and displays::
 * ms Insertions::
-* Example multi-page table::
 * ms Footnotes::
+* ms language and localization::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Paragraphs in ms, Headings in ms, ms Body Text, ms Body Text
+@node Text settings in ms, Typographical symbols in ms, ms Body Text, ms Body Text
+@subsubsection Text settings
+@cindex @file{ms} macros, text settings
+
+The @code{FAM} string, a GNU extension, sets the font family for body
+text; the default is @samp{T}.  The @code{PS} and @code{VS} registers
+set the type size and vertical spacing (distance between text
+baselines), respectively.  The font family and type size are ignored on
+terminal devices.  Setting these parameters before the first call of a
+heading, paragraphing, or (non-date) document description macro also
+applies them to headers, footers, and (for @code{FAM}) footnotes.
+
+Which font families are available depends on the output device; as a
+convention, @code{T} selects a serif family (``Times''), @code{H} a
+sans-serif family (``Helvetica''), and @code{C} a monospaced family
+(``Courier'').  The man page for the output driver documents its font
+repertoire.  Consult the @cite{groff@r{(1)}} man page for lists of
+available output devices and their drivers.
+
+The hyphenation mode (as used by the @code{hy} request) is set from the
+@code{HY} register.  Setting @code{HY} to @samp{0} is equivalent to
+using the @code{nh} request.  This is a Tenth Edition Research Unix
+extension.
+
+@c ---------------------------------------------------------------------
+
+@node Typographical symbols in ms, Paragraphs in ms, Text settings in ms, ms Body Text
+@subsubsection Typographical symbols
+@cindex @file{ms} macros, obtaining typographical symbols
+
+@file{ms} provides a few strings to obtain typographical symbols not
+easily entered with the keyboard.  These and many others are available
+as special character escape sequences---see the @cite{groff_char@r{(7)}}
+man page.
+
+@Defmpstr {-, ms}
+Interpolate an em dash.
+@endDefmpstr
+
+@DefmpstrList {Q, ms}
+@DefmpstrListEndx {U, ms}
+Interpolate typographer's quotation marks where available, and neutral
+double quotes otherwise.  @code{\*Q} is the left quote and @code{\*U}
+the right.
+@endDefmpstr
+
+@c ---------------------------------------------------------------------
+
+@node Paragraphs in ms, Headings in ms, Typographical symbols in ms, ms Body Text
 @subsubsection Paragraphs
-@cindex @code{ms} macros, paragraph handling
+@cindex @file{ms} macros, paragraph handling
 
-The following paragraph types are available.
+Paragraphing macros @dfn{break}, or terminate, any pending output line
+so that a new paragraph can begin.  Several paragraph types are
+available, differing in how indentation applies to them: to left, right,
+or both margins; to the first output line of the paragraph, all output
+lines, or all but the first.  All paragraphing macro calls cause the
+insertion of vertical space in the amount stored in the @code{PD}
+register, except at page or column breaks.  Alternatively, a blank input
+line breaks the output line and vertically spaces by one vee.
+
+@Defmac {LP, , ms}
+Set a paragraph without any (additional) indentation.
+@endDefmac
 
 @Defmac {PP, , ms}
-Sets a paragraph with an initial indentation.
+Set a paragraph with a first-line left indentation in the amount stored
+in the @code{PI} register.
 @endDefmac
 
-@Defmac {LP, , ms}
-Sets a paragraph without an initial indentation.
+@Defmac {IP, @Var{marker} @Var{width}, ms}
+Set a paragraph with a left indentation.  The optional @var{marker} is
+not indented and is empty by default.  It has several applications;
+see @ref{Lists in ms}.  @var{width} overrides the indentation amount
+stored in the @code{PI} register; its default unit is @samp{n}.  Once
+specified, @var{width} applies to further @code{IP} calls until
+specified again or a heading or different paragraphing macro is called.
 @endDefmac
 
 @Defmac {QP, , ms}
-Sets a paragraph that is indented at both left and right margins
-by the amount of the register @code{QI}.
-The effect is identical to the @acronym{HTML} @code{<BLOCKQUOTE>} element.
-The next paragraph or heading returns margins to normal.
-@code{QP} inserts vertical space of amount set by register @code{PD}
-before the paragraph.
+Set a paragraph indented from both left and right margins by the amount
+stored in the @code{QI} register.
 @endDefmac
 
 @DefmacList {QS, , ms}
 @DefmacListEndx {QE, , ms}
-These macros begin and end a quoted section.
-The @code{QI} register
-controls the amount of indentation.
-Both @code{QS} and @code{QE} insert inter-paragraph vertical space
-set by register @code{PD}.
-The text between @code{QS} and @code{QE} can be structured further
-by use of the macros @code{LP} or @code{PP}.
+Begin (@code{QS}) and end (@code{QE}) a region where each paragraph is
+indented from both margins by the amount stored in the @code{QI}
+register.  The text between @code{QS} and @code{QE} can be structured
+further by use of other paragraphing macros.
 @endDefmac
 
 @Defmac {XP, , ms}
-Sets a paragraph whose lines are indented, except for the first line.
-This is a Berkeley extension.
+Set an ``exdented'' paragraph---one with a left indentation in the
+amount stored in the @code{PI} register on every line @emph{except} the
+first (also known as a hanging indent).  This is a Berkeley extension.
 @endDefmac
 
-The following markup uses all four paragraph macros.
+The following example illustrates the use of paragraphing macros.
 
 @CartoucheExample
 .NH 2
-Cases used in the study
+Cases used in the 2001 study
 .LP
-The following software and versions were
-considered for this report.
+Two software releases were considered for this report.
 .PP
-For commercial software, we chose
-.B "Microsoft Word for Windows" ,
-starting with version 1.0 through the
-current version (Word 2000).
-.PP
-For free software, we chose
-.B Emacs ,
-from its first appearance as a standalone
-editor through the current version (v20).
+The first is commercial software;
+the second is free.
+.IP \bu
+Microsoft Word for Windows,
+starting with version 1.0 through the current version
+(Word 2000).
+.IP \bu
+GNU Emacs,
+from its first appearance as a standalone editor through
+the current version (v20).
 See Bloggs 2002 for details.
 .QP
 Franklin's Law applied to software:
-software expands to outgrow both
-RAM and disk space over time.
-.LP
-Bibliography:
+software expands to outgrow both RAM and disk space over
+time.
+.SH
+Bibliography
 .XP
 Bloggs, Joseph R.,
 .I "Everyone's a Critic" ,
 Underground Press, March 2002.
-A definitive work that answers all questions
-and criticisms about the quality and usability of
-free software.
+A definitive work that answers all questions and
+criticisms about the quality and usability of free
+software.
 @endCartoucheExample
 
-The @code{PORPHANS} register (@pxref{ms Document Control Registers})
-operates in conjunction with each of these macros, to inhibit the
-printing of orphan lines at the bottom of any page.
-
 @c ---------------------------------------------------------------------
 
-@node Headings in ms, Highlighting in ms, Paragraphs in ms, ms Body Text
+@node Headings in ms, Typeface and decoration, Paragraphs in ms, ms Body Text
 @subsubsection Headings
-@cindex @code{ms} macros, headings
+@cindex @file{ms} macros, headings
 
-Use headings to create a hierarchical structure for your document.  The
-@file{ms} macros print headings in @strong{bold}, using the same font
-family and point size as the body text.
-
-The following describes the heading macros:
-
-@DefmacList {NH, @Var{curr-level}, ms}
-@DefmacListEnd {NH, @t{S} @Var{level0} @dots{}, ms}
-Numbered heading.  The argument is either a numeric argument to indicate
-the level of the heading, or the letter@tie{}@code{S} followed by
-numeric arguments to set the heading level explicitly.
-
-If you specify heading levels out of sequence, such as invoking
-@samp{.NH 3} after @samp{.NH 1}, @code{groff} prints a warning on
-standard error.
+Use headings to create a sequential or hierarchical structure for your
+document.  The @file{ms} macros print headings in @strong{bold} using
+the same font family and, by default, type size as the body text.
+Headings are available with and without automatic numbering.  Text on
+input lines following the macro call becomes the heading's title.  Call
+a paragraphing macro to end the heading text and start the section's
+content.
+
+@DefmacList {NH, @Var{depth}, ms}
+@DefmacListEnd {NH, @t{S} @Var{heading-depth-index} @dots{}, ms}
+Set an automatically numbered heading.
+
+@file{ms} produces a numbered heading the form @var{a.b.c@dots{}}, to
+any depth desired, with the numbering of each depth increasing
+automatically and being reset to zero when a more significant level is
+increased.  ``1''@tie{}is the most significant or coarsest division of
+the document.  Only non-zero values are output.  If @var{depth} is
+omitted, it is taken to be @samp{1}.
+
+If you specify @var{depth} such that an ascending gap occurs relative to
+the previous @code{NH} call---that is, you ``skip a depth'', as by
+@samp{.NH 1} and then @samp{.NH 3}---@code{groff} @file{ms} emits a
+warning on the standard error stream.
+
+Alternatively, you can give @code{NH} a first argument of@tie{}@code{S},
+followed by integers to number the heading depths explicitly.  Further
+automatic numbering, if used, resumes using the specified indices as
+their predecessors.
+@c Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+This feature is a Berkeley extension.
 @endDefmac
 
-@DefstrList {SN, ms}
-@DefstrItemx {SN-DOT, ms}
-@DefstrListEndx {SN-NO-DOT, ms}
-After invocation of @code{NH}, the assigned section number is made
-available in the strings @code{SN-DOT} (as it appears in a printed
-section heading with default formatting, followed by a terminating
-period), and @code{SN-NO-DOT} (with the terminating period omitted).
-The string @code{SN} is also defined, as an alias for @code{SN-DOT}; if
-preferred, you may redefine it as an alias for @code{SN-NO-DOT}, by
-including the initialization
-@Example
-.als SN SN-NO-DOT
-@endExample
+An example may be illustrative.
 
-@noindent
-at any time @strong{before} you would like the change to take effect.
-@endDefstr
+@CartoucheExample
+.NH 1
+Animalia
+.NH 2
+Arthropoda
+.NH 3
+Crustacea
+.NH 2
+Chordata
+.NH S 6 6 6
+Daimonia
+.NH 1
+Plantae
+@endCartoucheExample
 
-@Defstr {SN-STYLE, ms}
-You may control the style used to print section numbers, within numbered
-section headings, by defining an appropriate alias for the string
-@code{SN-STYLE}.  The default style, in which the printed section number
-is followed by a terminating period, is obtained by defining the alias
+The above results in numbering as follows; the vertical space that
+normally precedes each heading is omitted.
 
 @Example
-.als SN-STYLE SN-DOT
-@endExample
-
-@noindent
-If you prefer to omit the terminating period, from section numbers
-appearing in numbered section headings, you may define the alias
+1.  Animalia
+1.1.  Arthropoda
+1.1.1.  Crustacea
+1.2.  Chordata
+6.6.6.  Daimonia
+7.  Plantae
+@endExample
+
+@DefmpstrList {SN-STYLE, ms}
+@DefmpstrItemx {SN-DOT, ms}
+@DefmpstrItemx {SN-NO-DOT, ms}
+@DefmpstrListEndx {SN, ms}
+After @code{NH} is called, the assigned number is made available in the
+strings @code{SN-DOT} (as it appears in a printed heading with default
+formatting, followed by a terminating period) and @code{SN-NO-DOT} (with
+the terminating period omitted).  These are GNU extensions.
+
+You can control the style used to print numbered headings by defining an
+appropriate alias for the string @code{SN-STYLE}.  By default,
+@code{SN-STYLE} is aliased to @code{SN-DOT}.  If you prefer to omit the
+terminating period from numbers appearing in numbered headings, you may
+define the alias as follows.
 
 @Example
 .als SN-STYLE SN-NO-DOT
 @endExample
 
 @noindent
-Any such change in section numbering style becomes effective from the
-next use of @code{.NH}, following redefinition of the alias for
-@code{SN-STYLE}.
-@endDefstr
-
-@Defmac {SH, @Var{match-level}, ms}
-Unnumbered subheading.
-
-The optional @var{match-level} argument is a GNU extension.  It is a
-number indicating the level of the heading, in a manner analogous to the
-@var{curr-level} argument to @code{.NH}.  Its purpose is to match the
-point size, at which the heading is printed, to the size of a numbered
-heading at the same level, when the @code{GROWPS} and @code{PSINCR}
-heading size adjustment mechanism is in effect.  @xref{ms Document
-Control Registers}.
-@endDefmac
-
-The @code{HORPHANS} register (@pxref{ms Document Control Registers})
-operates in conjunction with the @code{NH} and @code{SH} macros, to
-inhibit the printing of orphaned section headings at the bottom of any
-page.
-
-@c ---------------------------------------------------------------------
-
-@node Highlighting in ms, Lists in ms, Headings in ms, ms Body Text
-@subsubsection Highlighting
-@cindex @code{ms} macros, highlighting
+Any such change in numbering style becomes effective from the next use
+of @code{NH} following redefinition of the alias for @code{SN-STYLE}.
+The formatted number of the current heading is available in the
+@code{SN} string (a feature first documented by Berkeley), which
+facilitates its inclusion in, for example, table captions, equation
+labels, and @code{XS}/@code{XA}/@code{XE} table of contents entries.
+@endDefmpstr
+
+@Defmac {SH, @Var{depth}, ms}
+Set an unnumbered heading.
+
+The optional @var{depth} argument is a GNU extension indicating the
+heading depth corresponding to the @var{depth} argument of @code{NH}.
+It matches the type size at which the heading is set to that of a
+numbered heading at the same depth when the @code{GROWPS} and
+@code{PSINCR} heading size adjustment mechanism is in effect.
+@endDefmac
+
+If the @code{GROWPS} register is set to a value greater than the
+@var{level} argument to @code{NH} or @code{SH}, the type size of a
+heading produced by these macros increases by @code{PSINCR} units over
+the size specified by @code{PS} multiplied by the difference of
+@code{GROWPS} and @var{level}.  The value stored in @code{PSINCR} is
+interpreted in @code{groff} basic units; the @code{p} scaling unit
+should be employed when assigning a value specified in points.  For
+example, the sequence
 
-The @file{ms} macros provide a variety of methods to highlight or
-emphasize text:
-
-@Defmac {B, @Var{txt} @Var{post} @Var{pre}, ms}
-Sets its first argument in @strong{bold type}.  If you specify a second
-argument, @code{groff} prints it in the previous font after the bold
-text, with no intervening space (this allows you to set punctuation
-after the highlighted text without highlighting the punctuation).
-Similarly, it prints the third argument (if any) in the previous font
-@strong{before} the first argument.  For example,
+@CartoucheExample
+.nr PS 10
+.nr GROWPS 3
+.nr PSINCR 1.5p
+.NH 1
+Carnivora
+.NH 2
+Felinae
+.NH 3
+Felis catus
+.SH 2
+Machairodontinae
+@endCartoucheExample
 
-@Example
-.B foo ) (
-@endExample
+@noindent
+will cause ``1. Carnivora'' to be printed in 13-point text, followed by
+``1.1. Felinae'' in 11.5-point text, while ``1.1.1. Felis catus'' and
+all more deeply nested heading levels will remain in the 10-point text
+specified by the @code{PS} register.  ``Machairodontinae'' is printed at
+11.5 points, since it corresponds to heading level@tie{}2.
+
+The @code{HORPHANS} register operates in conjunction with the @code{NH}
+and @code{SH} macros to inhibit the printing of isolated headings at the
+bottom of a page; it specifies the minimum number of lines of an
+immediately subsequent paragraph that must be kept on the same page as
+the heading.  If insufficient space remains on the current page to
+accommodate the heading and this number of lines of paragraph text, a
+page break is forced before the heading is printed.  Any display macro
+call or @code{tbl}, @code{pic}, or @code{eqn} region between the heading
+and the subsequent paragraph suppresses this grouping.  @xref{ms keeps
+and displays} and @ref{ms Insertions}.
 
-prints (@strong{foo}).
+@c ---------------------------------------------------------------------
 
-If you give this macro no arguments, @code{groff} prints all text
-following in bold until the next highlighting, paragraph, or heading
-macro.
+@node Typeface and decoration, Lists in ms, Headings in ms, ms Body Text
+@subsubsection Typeface and decoration
+
+The @file{ms} macros provide a variety of ways to style text.
+Attend closely to the ordering of arguments labeled @var{pre} and
+@var{post}, which is not intuitive.  Support for @var{pre}
+arguments is a GNU extension.@footnote{This idiosyncrasy arose through
+feature accretion; for example, the @code{B} macro in Version@tie{}6
+Unix @file{ms} (1975) accepted only one argument, the text to be set in
+boldface.  By Version@tie{}7 (1979) it recognized a second argument; in
+1990, @code{groff} @file{ms} added a ``pre'' argument, placing it third
+to avoid breaking support for older documents.}
+
+@Defmac {B, @Var{text} @Var{post} @Var{pre}, ms}
+Style @var{text} in @b{bold}, followed by @var{post} in the previous
+font style without intervening space, and preceded by @var{pre}
+similarly.  Without arguments, @file{ms} styles subsequent text in bold
+until the next paragraphing, heading, or no-argument typeface macro
+call.
 @endDefmac
 
-@Defmac {R, @Var{txt} @Var{post} @Var{pre}, ms}
-Sets its first argument in roman (or regular) type.  It operates
-similarly to the @code{B}@tie{}macro otherwise.
+@Defmac {R, @Var{text} @Var{post} @Var{pre}, ms}
+As @code{B}, but use the roman style (upright text of normal weight)
+instead of bold.  Argument recognition is a GNU extension.
 @endDefmac
 
-@Defmac {I, @Var{txt} @Var{post} @Var{pre}, ms}
-Sets its first argument in @emph{italic type}.  It operates similarly
-to the @code{B}@tie{}macro otherwise.
+@Defmac {I, @Var{text} @Var{post} @Var{pre}, ms}
+As @code{B}, but use an @i{italic} or oblique style instead of bold.
 @endDefmac
 
-@Defmac {CW, @Var{txt} @Var{post} @Var{pre}, ms}
-Sets its first argument in a @code{constant width face}.  It operates
-similarly to the @code{B}@tie{}macro otherwise.
+@Defmac {BI, @Var{text} @Var{post} @Var{pre}, ms}
+As @code{B}, but use a bold italic or bold oblique style instead of
+upright bold.  This is a Tenth Edition Research Unix extension.
+@c possibly 9th, but definitely not Berkeley
 @endDefmac
 
-@Defmac {BI, @Var{txt} @Var{post} @Var{pre}, ms}
-Sets its first argument in bold italic type.  It operates similarly to
-the @code{B}@tie{}macro otherwise.
+@Defmac {CW, @Var{text} @Var{post} @Var{pre}, ms}
+As @code{B}, but use a @t{constant-width} (monospaced) roman typeface
+instead of bold.  This is a Tenth Edition Research Unix extension.
+@c possibly 9th, but definitely not Berkeley
 @endDefmac
 
-@Defmac {BX, @Var{txt}, ms}
-Prints its argument and draws a box around it.  If you want to box a
-string that contains spaces, use a digit-width space (@code{\0}).
+@Defmac {BX, @Var{text}, ms}
+Typeset @var{text} and draw a box around it.  On terminal devices,
+reverse video is used instead.  If you want @var{text} to contain space,
+use unbreakable space or horizontal motion escape sequences (@code{\~},
+@code{\@key{SP}}, @code{\^}, @code{\|}, @code{\0} or @code{\h}).
 @endDefmac
 
-@Defmac {UL, @Var{txt} @Var{post}, ms}
-Prints its first argument with an underline.  If you specify a second
-argument, @code{groff} prints it in the previous font after the
-underlined text, with no intervening space.
+@Defmac {UL, @Var{text} @Var{post}, ms}
+Typeset @var{text} with an underline.  @var{post}, if present, is set
+after @var{text} with no intervening space.
 @endDefmac
 
 @Defmac {LG, , ms}
-Prints all text following in larger type (two points larger than the
-current point size) until the next font size, highlighting, paragraph,
-or heading macro.  You can specify this macro multiple times to
-enlarge the point size as needed.
+Set subsequent text in larger type (two points larger than the
+current size) until the next type size, paragraphing, or heading macro
+call.  You can specify this macro multiple times to enlarge the type
+size as needed.
 @endDefmac
 
 @Defmac {SM, , ms}
-Prints all text following in smaller type (two points smaller than the
-current point size) until the next type size, highlighting, paragraph,
-or heading macro.  You can specify this macro multiple times to reduce
-the point size as needed.
+Set subsequent text in smaller type (two points smaller than the current
+size) until the next type size, paragraphing, or heading macro call.
+You can specify this macro multiple times to reduce the type size as
+needed.
 @endDefmac
 
 @Defmac {NL, , ms}
-Prints all text following in the normal point size (that is, the value
-of the @code{PS} register).
+Set subsequent text at the normal type size (the amount in the @code{PS}
+register).
 @endDefmac
 
-@DefstrList {@Lbrace{}, ms}
-@DefstrListEndx {@Rbrace{}, ms}
-Text enclosed with @code{\*@{} and @code{\*@}} is printed as a
-superscript.
-@endDefstr
+@var{pre} and @var{post} arguments are typically used to simplify the
+attachment of punctuation to styled words.  When @var{pre} is used,
+a hyphenation control escape sequence @code{\%} that would ordinarily
+start @var{text} must start @var{pre} instead to have the desired
+effect.
+
+@CartoucheExample
+The CS course's students found one C language keyword
+.CW static ) \%(
+most troublesome.
+@endCartoucheExample
+
+The foregoing example produces output as follows.
+
+@CartoucheExample
+@r{The CS course's students found one C language keyword (@t{static})
+most troublesome.}
+@endCartoucheExample
+
+You can use the output line continuation escape sequence @code{\c} to
+achieve the same result (@pxref{Line Continuation}).  It is also
+portable to older @file{ms} implementations.
+
+@CartoucheExample
+The CS course's students found one C language keyword
+\%(\c
+.CW \%static )
+most troublesome.
+@endCartoucheExample
+
+@code{groff} @file{ms} also offers strings to begin and end super- and
+subscripting.  These are GNU extensions.
+
+@DefmpstrList {@lbracechar{}, ms}
+@DefmpstrListEndx {@rbracechar{}, ms}
+Begin and end superscripting, respectively.
+@endDefmpstr
+
+@DefmpstrList {<, ms}
+@DefmpstrListEndx {>, ms}
+Begin and end subscripting, respectively.
+@endDefmpstr
+
+Rather than calling the @code{CW} macro, in @code{groff} @file{ms} you
+might prefer to change the font family to Courier by setting the
+@code{FAM} string to @samp{C}.  You can then use all four style macros
+above, returning to the default family (Times) with @samp{.ds FAM T}.
+Because changes to @code{FAM} take effect only at the next paragraph,
+@code{CW} remains useful to ``inline'' a change to the font family,
+similarly to the practice of this document in noting syntactical
+elements of @file{ms} and @code{groff}.
 
 @c ---------------------------------------------------------------------
 
-@node Lists in ms, Indentation values in ms, Highlighting in ms, ms Body Text
+@node Lists in ms, Indented regions in ms, Typeface and decoration, ms Body Text
 @subsubsection Lists
-@cindex @code{ms} macros, lists
-
-The @code{IP} macro handles duties for all lists.
+@cindex @file{ms} macros, lists
 
-@Defmac {IP, @Var{marker} @Var{width}, ms}
-The @var{marker} is usually a bullet glyph (@code{\bu}) for unordered
-lists, a number (or auto-incrementing number register) for numbered
-lists, or a word or phrase for indented (glossary-style) lists.
-
-The @var{width} specifies the indentation for the body of each list
-item; its default unit is @samp{n}.  Once specified, the indentation
-remains the same for all list items in the document until specified
-again.
-
-The @code{PORPHANS} register (@pxref{ms Document Control Registers})
-operates in conjunction with the @code{IP} macro, to inhibit the
-printing of orphaned list markers at the bottom of any page.
-@endDefmac
+The @var{marker} argument to the @code{IP} macro can be employed to
+present a variety of lists; for instance, you can use a bullet glyph
+(@code{\bu}) for unordered lists, a number (or auto-incrementing
+register) for numbered lists, or a word or phrase for glossary-style or
+definition lists.  If you set the paragraph indentation register
+@code{PI} before calling @code{IP}, you can later reorder the items in
+the list without having to ensure that a @var{width} argument remains
+affixed to the first call.
 
 The following is an example of a bulleted list.
-@cindex example markup, bulleted list @code{ms}
-@cindex bulleted list, example markup @code{ms}
+@cindex example markup, bulleted list @file{ms}
+@cindex bulleted list, example markup @file{ms}
 
-@Example
+@CartoucheExample
+.nr PI 2n
 A bulleted list:
-.IP \bu 2
+.IP \bu
 lawyers
 .IP \bu
 guns
 .IP \bu
 money
-@endExample
-
-Produces:
+@endCartoucheExample
 
 @Example
 A bulleted list:
 
-o lawyers
+@bullet{} lawyers
 
-o guns
+@bullet{} guns
 
-o money
+@bullet{} money
 @endExample
 
 The following is an example of a numbered list.
-@cindex example markup, numbered list @code{ms}
-@cindex numbered list, example markup @code{ms}
+@cindex example markup, numbered list @file{ms}
+@cindex numbered list, example markup @file{ms}
 
-@Example
-.nr step 1 1
+@CartoucheExample
+.nr step 0 1
+.nr PI 3n
 A numbered list:
-.IP \nstep 3
+.IP \n+step
 lawyers
 .IP \n+step
 guns
 .IP \n+step
 money
-@endExample
-
-Produces:
+@endCartoucheExample
 
 @Example
 A numbered list:
@@ -3671,25 +3689,29 @@
 3. money
 @endExample
 
-Note the use of the auto-incrementing number register in this example.
-
-The following is an example of a glossary-style list.
-@cindex example markup, glossary-style list @code{ms}
-@cindex glossary-style list, example markup @code{ms}
+Here we have employed the @code{nr} request to create a register of our
+own, @samp{step}.  We initialized it to zero and assigned it an
+auto-increment of 1.  Each time we use the escape sequence
+@samp{\n+PI} (note the plus sign), the formatter applies the increment
+just before interpolating the register's value.  Preparing the @code{PI}
+register as well enables us to rearrange the list without the tedium of
+updating macro calls.
+
+The next example illustrates a glossary-style list.
+@cindex example markup, glossary-style list @file{ms}
+@cindex glossary-style list, example markup @file{ms}
 
-@Example
+@CartoucheExample
 A glossary-style list:
 .IP lawyers 0.4i
 Two or more attorneys.
 .IP guns
-Firearms, preferably
-large-caliber.
+Firearms,
+preferably large-caliber.
 .IP money
 Gotta pay for those
 lawyers and guns!
-@endExample
-
-Produces:
+@endCartoucheExample
 
 @Example
 A glossary-style list:
@@ -3703,48 +3725,76 @@
       Gotta pay for those lawyers and guns!
 @endExample
 
-In the last example, the @code{IP} macro places the definition on the
-same line as the term if it has enough space; otherwise, it breaks to
-the next line and starts the definition below the term.  This may or may
-not be the effect you want, especially if some of the definitions break
-and some do not.  The following examples show two possible ways to force
-a break.
-
-The first workaround uses the @code{br} request to force a break after
-printing the term or label.
+In the previous example, observe how the @code{IP} macro places the
+definition on the same line as the term if it has enough space.  If this
+is not what you want, there are a few workarounds we will illustrate by
+modifying the example.  First, you can use a @code{br} request to force
+a break after printing the term or label.
 
 @CartoucheExample
-A glossary-style list:
-.IP lawyers 0.4i
-Two or more attorneys.
 .IP guns
 .br
-Firearms, preferably large-caliber.
-.IP money
-Gotta pay for those lawyers and guns!
+Firearms,
 @endCartoucheExample
 
-The second workaround uses the @code{\p} escape to force the break.
-Note the space following the escape; this is important.  If you omit the
-space, @code{groff} prints the first word on the same line as the term
-or label (if it fits) @strong{then} breaks the line.
+Second, you could apply the @code{\p} escape sequence to force a break.
+The space following the escape sequence is important; if you omit it,
+@code{groff} prints the first word of the paragraph text on the same
+line as the term or label (if it fits) @emph{then} breaks the line.
 
 @CartoucheExample
-A glossary-style list:
-.IP lawyers 0.4i
-Two or more attorneys.
 .IP guns
-\p Firearms, preferably large-caliber.
-.IP money
-Gotta pay for those lawyers and guns!
+\p Firearms,
 @endCartoucheExample
 
-To set nested lists, use the @code{RS} and @code{RE} macros.
-@xref{Indentation values in ms}, for more information.
-@cindex @code{ms} macros, nested lists
-@cindex nested lists @code{ms}
+Finally, you may append a horizontal motion to the marker with the
+@code{\h} escape sequence; using the same amount as the indentation will
+ensure that the marker is too wide for @code{groff} to treat it as
+``fitting'' on the same line as the paragraph text.
+
+@CartoucheExample
+.IP guns\h'0.4i'
+Firearms,
+@endCartoucheExample
+
+In each case, the result is the same.
+
+@Example
+A glossary-style list:
+
+lawyers
+      Two or more attorneys.
 
-For example:
+guns
+      Firearms, preferably large-caliber.
+
+money
+      Gotta pay for those lawyers and guns!
+@endExample
+
+@c ---------------------------------------------------------------------
+
+@node Indented regions in ms, ms keeps and displays, Lists in ms, ms Body Text
+@subsubsection Indented regions
+
+You may need to indent a region of text while otherwise formatting it
+normally.  Indented regions can be nested; you can change @code{\nPI}
+before each call to vary the amount of inset.
+
+@Defmac {RS, , ms}
+Begin a region where headings, paragraphs, and displays are indented
+(further) by the amount stored in the @code{PI} register.
+@endDefmac
+
+@Defmac {RE, , ms}
+End the (next) most recent indented region.
+@endDefmac
+
+This feature enables you to easily line up text under hanging and
+indented paragraphs.
+@cindex @file{ms} macros, nested lists
+@cindex nested lists @file{ms}
+For example, you may wish to structure lists hierarchically.
 
 @CartoucheExample
 .IP \bu 2
@@ -3754,6 +3804,7 @@
 Dewey,
 .IP \bu
 Cheatham,
+and
 .IP \bu
 and Howe.
 .RE
@@ -3761,416 +3812,596 @@
 Guns
 @endCartoucheExample
 
-Produces:
-
 @Example
-o Lawyers:
+@bullet{} Lawyers:
 
-  o  Dewey,
+  @bullet{}  Dewey,
 
-  o  Cheatham,
+  @bullet{}  Cheatham, and
 
-  o  and Howe.
+  @bullet{}  Howe.
 
-o Guns
+@bullet{} Guns
 @endExample
 
 @c ---------------------------------------------------------------------
 
-@node Indentation values in ms, Tabstops in ms, Lists in ms, ms Body Text
-@subsubsection Indentation values
-
-In many situations, you may need to indentation a section of text while
-still wrapping and filling.  @xref{Lists in ms}, for an example of
-nested lists.
+@node ms keeps and displays, ms Insertions, Indented regions in ms, ms Body Text
+@subsubsection Keeps, boxed keeps, and displays
+@cindex @file{ms} macros, displays
+@cindex @file{ms} macros, keeps
+@cindex keeps @file{ms}
 
-@DefmacList {RS, , ms}
-@DefmacListEndx {RE, , ms}
-These macros begin and end an indented section.  The @code{PI} register
-controls the amount of indentation, allowing the indented text to line
-up under hanging and indented paragraphs.
-@endDefmac
+On occasion, you may want to @dfn{keep} several lines of text, or a
+region of a document, together on a single page, preventing an automatic
+page break within certain boundaries.  This can cause a page break to
+occur earlier than it normally would.  For example, you may want to keep
+two paragraphs together, or a paragraph that refers to a table, list, or
+figure adjacent to the item it discusses.  @file{ms} provides the
+@code{KS} and @code{KE} macros for this purpose.
 
-@xref{ms Displays and Keeps}, for macros to indentation and turn off
-filling.
+You can alternatively specify a @dfn{floating keep}:@: if a keep cannot
+fit on the current page, @file{ms} holds its contents and
+allows material following the keep (in the source document) to fill the
+remainder of the current page.  When the page breaks, whether by
+reaching the end or @code{bp} request, @file{ms} puts the floating keep
+at the beginning of the next page.  This is useful for placing large
+graphics or tables that do not need to appear exactly where they occur
+in the source document.
 
-@c ---------------------------------------------------------------------
+@DefmacList {KS, , ms}
+@DefmacItemx {KF, , ms}
+@DefmacListEndx {KE, , ms}
+@code{KS} begins a keep, @code{KF} a floating keep, and @code{KE} ends a
+keep of either kind.
+@endDefmac
 
-@node Tabstops in ms, ms Displays and Keeps, Indentation values in ms, ms Body Text
-@subsubsection Tab Stops
+As an alternative to the keep mechanism, the @code{ne} request forces a
+page break if there is not at least the amount of vertical space
+specified in its argument remaining on the page (@pxref{Page Control}).
+One application of @code{ne} is to reserve space on the page for a
+figure or illustration to be included later.
 
-Use the @code{ta} request to define tab stops as needed.  @xref{Tabs and
-Fields}.
+@cindex boxes @file{ms}
+A @dfn{boxed keep} has a frame drawn around it.
 
-@Defmac {TA, , ms}
-Use this macro to reset the tab stops to the default for @file{ms}
-(every 5n).  You can redefine the @code{TA} macro to create a different
-set of default tab stops.
+@DefmacList {B1, , ms}
+@DefmacListEndx {B2, , ms}
+@code{B1} begins a keep with a box drawn around it.  @code{B2} ends a
+boxed keep.
 @endDefmac
 
-@c ---------------------------------------------------------------------
+Boxed keep macros cause breaks; if you need to box a word or phrase
+within a line, see the @code{BX} macro in @ref{Typeface and decoration}.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.  If you wish to box one or more
+paragraphs, you may improve the appearance by calling @code{B1} after
+the first paragraphing macro, and by adding a small amount of vertical
+space before calling @code{B2}.
+
+@c Wrap example at 58 columns.
+@CartoucheExample
+.LP
+.B1
+.I Warning:
+Happy Fun Ball may suddenly accelerate to dangerous
+speeds.
+.sp \nPD/2 \" space by half the inter-paragraph distance
+.B2
+@endCartoucheExample
 
-@node ms Displays and Keeps, ms Insertions, Tabstops in ms, ms Body Text
-@subsubsection Displays and keeps
-@cindex @code{ms} macros, displays
-@cindex @code{ms} macros, keeps
-@cindex keeps @code{ms}
-@cindex displays @code{ms}
-
-Use displays to show text-based examples or figures (such as code
-listings).
-
-Displays turn off filling, so lines of code are displayed as-is without
-inserting @code{br} requests in between each line.  Displays can be
-@dfn{kept} on a single page, or allowed to break across pages.
+If you want a boxed keep to float, you will need to enclose the
+@code{B1} and @code{B2} calls within a pair of @code{KF} and @code{KE}
+calls.
+
+@cindex displays @file{ms}
+@dfn{Displays} turn off filling; lines of verse or program code are
+shown with their lines broken as in the source document without
+requiring @code{br} requests between lines.  Displays can be kept on a
+single page or allowed to break across pages.  The @code{DS} macro
+begins a kept display of the layout specified in its first argument;
+non-kept displays are begun with dedicated macros corresponding to their
+layout.
 
 @DefmacList {DS, @t{L}, ms}
-@DefmacItemx {LD, , ms}
-@DefmacListEndx {DE, , ms}
-Left-justified display.  The @samp{.DS L} call generates a page break,
-if necessary, to keep the entire display on one page.  The @code{LD}
-macro allows the display to break across pages.  The @code{DE} macro
-ends the display.
+@DefmacListEndx {LD, , ms}
+Begin (@code{DS}:@: kept) left-aligned display.
 @endDefmac
 
-@DefmacList {DS, @t{I}, ms}
-@DefmacItemx {ID, , ms}
-@DefmacListEndx {DE, , ms}
-Indents the display as defined by the @code{DI} register.  The @samp{.DS
-I} call generates a page break, if necessary, to keep the entire display
-on one page.  The @code{ID} macro allows the display to break across
-pages.  The @code{DE} macro ends the display.
+@DefmacList {DS, @t{I} @Var{indent}, ms}
+@DefmacListEndx {ID, @Var{indent}, ms}
+Begin (@code{DS}:@: kept) display indented by @var{indent} if specified,
+and by the amount of the @code{DI} register otherwise.
 @endDefmac
 
 @DefmacList {DS, @t{B}, ms}
-@DefmacItemx {BD, , ms}
-@DefmacListEndx {DE, , ms}
-Sets a block-centered display: the entire display is left-justified, but
-indented so that the longest line in the display is centered on the
-page.  The @samp{.DS B} call generates a page break, if necessary, to
-keep the entire display on one page.  The @code{BD} macro allows the
-display to break across pages.  The @code{DE} macro ends the display.
+@DefmacListEndx {BD, , ms}
+Begin a (@code{DS}:@: kept) a block display:@: the entire display is
+left-aligned, but indented such that the longest line in the display
+is centered on the page.
 @endDefmac
 
 @DefmacList {DS, @t{C}, ms}
-@DefmacItemx {CD, , ms}
-@DefmacListEndx {DE, , ms}
-Sets a centered display: each line in the display is centered.  The
-@samp{.DS C} call generates a page break, if necessary, to keep the
-entire display on one page.  The @code{CD} macro allows the display to
-break across pages.  The @code{DE} macro ends the display.
+@DefmacListEndx {CD, , ms}
+Begin a (@code{DS}:@: kept) centered display:@: each line in the display
+is centered.
 @endDefmac
 
 @DefmacList {DS, @t{R}, ms}
-@DefmacItemx {RD, , ms}
-@DefmacListEndx {DE, , ms}
-Right-justifies each line in the display.  The @samp{.DS R} call
-generates a page break, if necessary, to keep the entire display on one
-page.  The @code{RD} macro allows the display to break across pages.
-The @code{DE} macro ends the display.
-@endDefmac
-
-@DefmacList {Ds, , ms}
-@DefmacListEndx {De, , ms}
-These two macros were formerly provided as aliases for @code{DS} and
-@code{DE}, respectively.  They have been removed, and should no longer
-be used.  The original implementations of @code{DS} and @code{DE} are
-retained, and should be used instead.  X11 documents that actually use
-@code{Ds} and @code{De} always load a specific macro file from the X11
-distribution (@file{macros.t}) that provides proper definitions for the
-two macros.
-@endDefmac
-
-On occasion, you may want to @dfn{keep} other text together on a page.
-For example, you may want to keep two paragraphs together, or a
-paragraph that refers to a table (or list, or other item) immediately
-following.  The @file{ms} macros provide the @code{KS} and @code{KE}
-macros for this purpose.
-
-@DefmacList {KS, , ms}
-@DefmacListEndx {KE, , ms}
-The @code{KS} macro begins a block of text to be kept on a single page,
-and the @code{KE} macro ends the block.
+@DefmacListEndx {RD, , ms}
+Begin a (@code{DS}:@: kept) right-aligned display.  This is a GNU
+extension.
 @endDefmac
 
-@DefmacList {KF, , ms}
-@DefmacListEndx {KE, , ms}
-Specifies a @dfn{floating keep}; if the keep cannot fit on the current
-page, @code{groff} holds the contents of the keep and allows text
-following the keep (in the source file) to fill in the remainder of the
-current page.  When the page breaks, whether by an explicit @code{bp}
-request or by reaching the end of the page, @code{groff} prints the
-floating keep at the top of the new page.  This is useful for printing
-large graphics or tables that do not need to appear exactly where
-specified.
+@Defmac {DE, , ms}
+End any display.
 @endDefmac
 
-You can also use the @code{ne} request to force a page break if there is
-not enough vertical space remaining on the page.
-
-Use the following macros to draw a box around a section of text (such as
-a display).
-
-@DefmacList {B1, , ms}
-@DefmacListEndx {B2, , ms}
-Marks the beginning and ending of text that is to have a box drawn
-around it.  The @code{B1} macro begins the box; the @code{B2} macro ends
-it.  Text in the box is automatically placed in a diversion (keep).
-@endDefmac
+The distance stored in the @code{DD} register is inserted before and
+after each pair of display macros; this is a Berkeley extension.  In
+@code{groff} @file{ms}, this distance replaces any adjacent
+inter-paragraph distance or subsequent spacing prior to a section
+heading.  The @code{DI} register is a GNU extension; its value is an
+indentation applied to displays created with @samp{.DS} and @samp{.ID}
+without arguments, to @samp{.DS I} without an indentation argument, and
+to indented equations set with @samp{.EQ}.  Changes to either register
+take effect at the next display boundary.
 
 @c ---------------------------------------------------------------------
 
-@node ms Insertions, Example multi-page table, ms Displays and Keeps, ms Body Text
+@node ms Insertions, ms Footnotes, ms keeps and displays, ms Body Text
 @subsubsection Tables, figures, equations, and references
-@cindex @code{ms} macros, tables
-@cindex @code{ms} macros, figures
-@cindex @code{ms} macros, equations
-@cindex @code{ms} macros, references
-@cindex tables @code{ms}
-@cindex figures @code{ms}
-@cindex equations @code{ms}
-@cindex references @code{ms}
+@cindex @file{ms} macros, tables
+@cindex @file{ms} macros, figures
+@cindex @file{ms} macros, equations
+@cindex @file{ms} macros, references
+@cindex tables @file{ms}
+@cindex figures @file{ms}
+@cindex equations @file{ms}
+@cindex references @file{ms}
 
-The @file{ms} macros support the standard @code{groff} preprocessors:
-@code{tbl}, @code{pic}, @code{eqn}, and @code{refer}.
+The @file{ms} package is often used with the @code{tbl}, @code{pic},
+@code{eqn}, and @code{refer} preprocessors.
 @pindex tbl
 @pindex pic
 @pindex eqn
 @pindex refer
-You mark text meant for preprocessors by enclosing it in pairs of tags
-as follows.
+Mark text meant for preprocessors by enclosing it in pairs of tokens
+as follows, with nothing between the dot and the macro name.  The
+preprocessors match these tokens only at the start of an input line.
 
 @DefmacList {TS, @code{H}, ms}
 @DefmacListEndx {TE, , ms}
-Denotes a table, to be processed by the @code{tbl} preprocessor.  The
-optional argument@tie{}@code{H} to @code{TS} instructs @code{groff} to
-create a running header with the information up to the @code{TH} macro.
-@code{groff} prints the header at the beginning of the table; if the
-table runs onto another page, @code{groff} prints the header on the next
-page as well.
+Demarcate a table to be processed by the @code{tbl} preprocessor.  The
+optional argument@tie{}@code{H} to @code{TS} instructs @file{ms} to
+repeat table rows (often column headings) at the top of each new page
+the table spans, if applicable; calling the @code{TH} macro marks the
+end of such rows.  The GNU @cite{tbl@r{(1)}} man page provides a
+comprehensive reference to the preprocessor and offers examples of its
+use.
 @endDefmac
 
 @DefmacList {PS, , ms}
-@DefmacListEndx {PE, , ms}
-Denotes a graphic, to be processed by the @code{pic} preprocessor.  You
-can create a @code{pic} file by hand, using the @acronym{AT&T}
-@code{pic} manual available on the Web as a reference, or by using a
-graphics program such as @code{xfig}.
+@DefmacItemx {PE, , ms}
+@DefmacListEndx {PF, , ms}
+@code{PS} begins a picture to be processed by the @command{gpic}
+preprocessor; either of @code{PE} or @code{PF} ends it, the latter with
+``flyback'' to the vertical position at its top.  You can create
+@code{pic} input manually or with a program such as @code{xfig}.
 @endDefmac
 
-@DefmacList {EQ, @Var{align}, ms}
+@DefmacList {EQ, @Var{align} @Var{label}, ms}
 @DefmacListEndx {EN, , ms}
-Denotes an equation, to be processed by the @code{eqn} preprocessor.
-The optional @var{align} argument can be @code{C}, @code{L},
-or@tie{}@code{I} to center (the default), left-justify, or indent the
-equation.
+Demarcate an equation to be processed by the @code{eqn} preprocessor.
+The equation is centered by default; @var{align} can be @samp{C},
+@samp{L}, or @samp{I} to (explicitly) center, left-align, or indent it
+by the amount stored in the @code{DI} register, respectively.  If
+specified, @var{label} is set right-aligned.
 @endDefmac
 
 @DefmacList {, , ms}
 @DefmacListEndx {, , ms}
-Denotes a reference, to be processed by the @code{refer} preprocessor.
-The GNU @cite{refer(1)} man page provides a comprehensive reference to
-the preprocessor and the format of the bibliographic database.
+Demarcate a bibliographic citation to be processed by the @code{refer}
+preprocessor.  The GNU @cite{refer@r{(1)}} man page provides a
+comprehensive reference to the preprocessor and the format of its
+bibliographic database.  Type @samp{man refer} at the command line to
+view it.
 @endDefmac
 
-@menu
-* Example multi-page table::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Example multi-page table, ms Footnotes, ms Insertions, ms Body Text
-@subsubsection An example multi-page table
-@cindex example markup, multi-page table @code{ms}
-@cindex multi-page table, example markup @code{ms}
+When @code{refer} emits collected references (as might be done on a
+``Works Cited'' page), it interpolates the @code{REFERENCES} string as
+an unnumbered heading (@code{SH}).
 
+@cindex table, multi-page, example @file{ms}
+@cindex multi-page table example @file{ms}
 The following is an example of how to set up a table that may print
 across two or more pages.
 
 @CartoucheExample
 .TS H
-allbox expand;
-cb | cb .
-Text      ...of heading...
+allbox;
+Cb | Cb .
+Part@arrow{}Description
 _
 .TH
 .T&
-l | l .
-... the rest of the table follows...
-.CW
+GH-1978@arrow{}Fribulating gonkulator
+@r{@dots{}the rest of the table follows@dots{}}
 .TE
 @endCartoucheExample
 
+@noindent
+Attempting to place a multi-page table inside a keep can lead to
+unpleasant results, particularly if the @code{tbl} @code{allbox} option
+is used.
+
+@cindex equation example @file{ms}
+Mathematics can be typeset using the language of the @code{eqn}
+preprocessor.
+
+@CartoucheExample
+.EQ C (\*SN-NO-DOTa)
+p ~ = ~ q sqrt @{ ( 1 + ~ ( x / q sup 2 ) @}
+.EN
+@endCartoucheExample
+
+@noindent
+This input formats a labelled equation.  We used the @code{SN-NO-DOT}
+string to base the equation label on the current heading number, giving
+us more flexibility to reorganize the document.
+
+Use @command{groff} options to run preprocessors on the input:@:
+@option{-e} for @command{geqn}, @option{-p} for @command{gpic},
+@option{-R} for @command{grefer}, and @option{-t} for @command{gtbl}.
+
 @c ---------------------------------------------------------------------
 
-@node ms Footnotes,  , Example multi-page table, ms Body Text
+@node ms Footnotes, , ms Insertions, ms Body Text
 @subsubsection Footnotes
-@cindex @code{ms} macros, footnotes
-@cindex footnotes @code{ms}
-
-The @file{ms} macro package has a flexible footnote system.  You can
-specify either numbered footnotes or symbolic footnotes (that is, using
-a marker such as a dagger symbol).
+@cindex @file{ms} macros, footnotes
+@cindex footnotes @file{ms}
 
-@Defstr {*, ms}
-Specifies the location of a numbered footnote marker in the text.
+@cindex footnote marker @file{ms}
+@cindex marker, footnote @file{ms}
+A footnote is typically anchored to a place in the text with a
+@dfn{marker}, which is a small integer, a symbol such as a dagger, or
+arbitrary user-specified text.
+
+@Defmpstr {*, ms}
+Place an @dfn{automatic number}, an automatically generated numeric
+footnote marker, in the text.  Each time this string is interpolated,
+the number it produces increments by one.  Automatic numbers start at 1.
+This is a Berkeley extension.
 @endDefesc
 
-@DefmacList {FS, , ms}
+Enclose the footnote text in @code{FS} and @code{FE} macro calls to set
+it at the nearest available ``foot'', or bottom, of a text column or
+page.
+
+@DefmacList {FS, @Var{marker}, ms}
 @DefmacListEndx {FE, , ms}
-Specifies the text of the footnote.  The default action is to create a
-numbered footnote; you can create a symbolic footnote by specifying a
-@dfn{mark} glyph (such as @code{\dg} for the dagger glyph) in the body
-text and as an argument to the @code{FS} macro, followed by the text of
-the footnote and the @code{FE} macro.
-@endDefmac
+Begin (@code{FS}) and end (@code{FE}) a footnote.  @code{FS} calls
+@code{FS-MARK} with any supplied @var{marker} argument, which is then
+also placed at the beginning of the footnote text.  If @var{marker} is
+omitted, the next pending automatic footnote number enqueued by
+interpolation of the @code{*} string is used, and if none exists,
+nothing is prefixed.
+@endDefmac
+
+You may not desire automatically numbered footnotes in spite of their
+convenience.  You can indicate a footnote with a symbol or other text by
+specifying its marker at the appropriate place (for example, by using
+@code{\dg} for the dagger glyph) @emph{and} as an argument to the
+@code{FS} macro.  Such manual marks should be repeated as arguments to
+@code{FS} or as part of the footnote text to disambiguate their
+correspondence.  You may wish to use @code{\*@{} and @code{\*@}} to
+superscript the marker at the anchor point, in the footnote text, or
+both.
+
+@code{groff} @file{ms} provides a hook macro, @code{FS-MARK}, for
+user-determined operations to be performed when the @code{FS} macro is
+called.  It is passed the same arguments as @code{FS} itself.  An
+application of @code{FS-MARK} is anchor placement for a hyperlink
+reference, so that a footnote can link back to its referential
+context.@footnote{``Portable Document Format Publishing with GNU
+Troff'', @file{pdfmark.ms} in the @code{groff} distribution, uses this
+technique.}  By default, this macro has an empty definition.
+@code{FS-MARK} is a GNU extension.
+
+@cindex footnotes, and keeps @file{ms}
+@cindex keeps, and footnotes @file{ms}
+@cindex footnotes, and displays @file{ms}
+@cindex displays, and footnotes @file{ms}
+Footnotes can be safely used within keeps and displays, but you should
+avoid using automatically numbered footnotes within floating keeps.  You
+can place a second @code{\**} interpolation between a @code{\**} and its
+corresponding @code{FS} call as long as each @code{FS} call occurs
+@emph{after} the corresponding @code{\**} and occurrences of @code{FS}
+are in the same order as corresponding occurrences of @code{\**}.
+
+Footnote text is formatted as paragraphs are, using analogous
+parameters.  The registers @code{FI}, @code{FPD}, @code{FPS}, and
+@code{FVS} correspond to @code{PI}, @code{PD}, @code{PS}, and @code{CS},
+respectively; @code{FPD}, @code{FPS}, and @code{FVS} are GNU extensions.
+
+The @code{FF} register controls the formatting of automatically numbered
+footnote paragraphs and those for which @code{FS} is given a marker
+argument.  @xref{ms Document Control Settings}.
+
+The default footnote line length is 11/12ths of the normal line length
+for compatibility with the expectations of historical @file{ms}
+documents; you may wish to set the @code{FR} string to @samp{1} to align
+with contemporary typesetting practices.  In the
+past,@footnote{Unix Version@tie{}7 @file{ms}, its descendants, and GNU
+@file{ms} prior to @code{groff} version 1.23.0} an @code{FL} register
+was used for the line length in footnotes; however, setting this
+register at document initialization time had no effect on the footnote
+line length in multi-column arrangements.@footnote{You could reset it
+after each call to @code{.1C}, @code{.2C}, or @code{.MC}.}
+
+@code{FR} should be used in preference to the old @code{FL} register in
+contemporary documents.  The footnote line length is effectively
+computed as @samp{@slanted{column-width} * \*FR}.  If an absolute
+footnote line length is required, recall that arithmetic expressions in
+@code{roff} input are evaluated strictly from left to right, with no
+operator precedence (parentheses are honored).
+
+@Example
+.ds FR 0+3i \" Set footnote line length to 3 inches.
+@endExample
 
-You can control how @code{groff} prints footnote numbers by changing the
-value of the @code{FF} register.  @xref{ms Document Control Registers}.
+@c ---------------------------------------------------------------------
 
-@cindex footnotes, and keeps @code{ms}
-@cindex keeps, and footnotes @code{ms}
-@cindex footnotes, and displays @code{ms}
-@cindex displays, and footnotes @code{ms}
-Footnotes can be safely used within keeps and displays, but you should
-avoid using numbered footnotes within floating keeps.  You can set a
-second @code{\**} marker between a @code{\**} and its corresponding
-@code{.FS} entry; as long as each @code{FS} macro occurs @emph{after}
-the corresponding @code{\**} and the occurrences of @code{.FS} are in
-the same order as the corresponding occurrences of @code{\**}.
+@node ms language and localization, ms Page Layout, ms Footnotes, ms Body Text
+@subsubsection Language and localization
+@cindex @file{ms} macros, language
+@cindex @file{ms} macros, localization
+@cindex language @file{ms}
+@cindex localization @file{ms}
+
+@code{groff} @file{ms} provides several strings that you can customize
+for your own purposes, or redefine to adapt the macro package to
+languages other than English.  It is already localized for
+@c cs, de, fr, it, sv
+Czech, German, French, Italian, and Swedish.  Load the desired
+localization macro package after @file{ms}; see the
+@cite{groff_tmac@r{(5)}} man page.
+
+@CartoucheExample
+$ groff -ms -mfr bienvenue.ms
+@endCartoucheExample
+
+The following strings are available.
+
+@Defmpstr {REFERENCES, ms}
+Contains the string printed at the beginning of a references
+(bibliography) page produced with GNU @cite{refer@r{(1)}}.  The default
+is @samp{References}.
+@c XXX: Use of refer(1) with ms is insufficiently documented.
+@endDefmpstr
+
+@Defmpstr {ABSTRACT, ms}
+Contains the string printed at the beginning of the abstract.  The
+default is @samp{\fIABSTRACT\f}; it includes font selection escape
+sequences to set the word in italics.
+@endDefmpstr
+
+@Defmpstr {TOC, ms}
+Contains the string printed at the beginning of the table of contents.
+The default is @samp{Table of Contents}.
+@endDefmpstr
+
+@DefmpstrList {MONTH1, ms}
+@DefmpstrItemx {MONTH2, ms}
+@DefmpstrItemx {MONTH3, ms}
+@DefmpstrItemx {MONTH4, ms}
+@DefmpstrItemx {MONTH5, ms}
+@DefmpstrItemx {MONTH6, ms}
+@DefmpstrItemx {MONTH7, ms}
+@DefmpstrItemx {MONTH8, ms}
+@DefmpstrItemx {MONTH9, ms}
+@DefmpstrItemx {MONTH10, ms}
+@DefmpstrItemx {MONTH11, ms}
+@DefmpstrListEndx {MONTH12, ms}
+Contain the full names of the calendar months.  The defaults are in
+English: @samp{January}, @samp{February}, and so on.
+@endDefmpstr
 
 @c ---------------------------------------------------------------------
 
 @node ms Page Layout, Differences from AT&T ms, ms Body Text, ms
 @subsection Page layout
-@cindex @code{ms} macros, page layout
-@cindex page layout @code{ms}
+@cindex @file{ms} macros, page layout
+@cindex page layout @file{ms}
 
-The default output from the @file{ms} macros provides a minimalist page
-layout: it prints a single column, with the page number centered at the
-top of each page.  It prints no footers.
-
-You can change the layout by setting the proper number registers and
-strings.
+@file{ms}'s default page layout arranges text in a single column with
+the page number between hyphens centered in a header on each page except
+the first, and produces no footers.  You can customize this arrangement.
 
 @menu
 * ms Headers and Footers::
+* Tab Stops in ms::
 * ms Margins::
 * ms Multiple Columns::
 * ms TOC::
-* ms Strings and Special Characters::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node ms Headers and Footers, ms Margins, ms Page Layout, ms Page Layout
+@node ms Headers and Footers, Tab Stops in ms, ms Page Layout, ms Page Layout
 @subsubsection Headers and footers
-@cindex @code{ms} macros, headers
-@cindex @code{ms} macros, footers
-@cindex headers @code{ms}
-@cindex footers @code{ms}
-
-For documents that do not distinguish between odd and even pages, set
-the following strings:
-
-@DefstrList {LH, ms}
-@DefstrItemx {CH, ms}
-@DefstrListEndx {RH, ms}
-Sets the left, center, and right headers.
-@endDefstr
-
-@DefstrList {LF, ms}
-@DefstrItemx {CF, ms}
-@DefstrListEndx {RF, ms}
-Sets the left, center, and right footers.
-@endDefstr
-
-For documents that need different information printed in the even and
-odd pages, use the following macros:
-
-@DefmacList {OH, @t{'}@Var{left}@t{'}@Var{center}@t{'}@Var{right}@t{'}, ms}
-@DefmacItemx {EH, @t{'}@Var{left}@t{'}@Var{center}@t{'}@Var{right}@t{'}, ms}
-@DefmacItemx {OF, @t{'}@Var{left}@t{'}@Var{center}@t{'}@Var{right}@t{'}, ms}
-@DefmacListEndx {EF, @t{'}@Var{left}@t{'}@Var{center}@t{'}@Var{right}@t{'}, ms}
-The @code{OH} and @code{EH} macros define headers for the odd and even
-pages; the @code{OF} and @code{EF} macros define footers for the odd and
-even pages.  This is more flexible than defining the individual strings.
+@cindex @file{ms} macros, headers
+@cindex @file{ms} macros, footers
+@cindex headers @file{ms}
+@cindex footers @file{ms}
+
+There are multiple ways to produce headers and footers.  One is to
+define the strings @code{LH}, @code{CH}, and @code{RH} to set the left,
+center, and right headers, respectively; and @code{LF}, @code{CF}, and
+@code{RF} to set the left, center, and right footers.  This approach
+suffices for documents that do not distinguish odd- and even-numbered
+pages.
+
+Another method is to call macros that set headers or footers for odd- or
+even-numbered pages.  Each such macro takes a delimited argument
+separating the left, center, and right header or footer texts from each
+other.  You can replace the neutral apostrophes (@code{'}) shown below
+with any character not appearing in the header or footer text.  These
+macros are Berkeley extensions.
+
+@DefmacList {OH, @code{'}@Var{left}@code{'}@Var{center}@code{'}@Var{right}@code{'}, ms}
+@DefmacItemx {EH, @code{'}@Var{left}@code{'}@Var{center}@code{'}@Var{right}@code{'}, ms}
+@DefmacItemx {OF, @code{'}@Var{left}@code{'}@Var{center}@code{'}@Var{right}@code{'}, ms}
+@DefmacListEndx {EF, @code{'}@Var{left}@code{'}@Var{center}@code{'}@Var{right}@code{'}, ms}
+The @code{OH} and @code{EH} macros define headers for odd- (recto)
+and even-numbered (verso) pages, respectively; the @code{OF} and
+@code{EF} macros define footers for them.
+@endDefmac
+
+With either method, a percent sign @code{%} in header or footer text is
+replaced by the current page number.  By default, @file{ms} places no
+header on a page numbered ``1'' (regardless of its number format).
 
-You can replace the quote (@code{'}) marks with any character not
-appearing in the header or footer text.
-@endDefmac
+@Defmac {P1, , ms}
+Typeset the header even on page@tie{}1.  To be effective, this macro
+must be called before the header trap is sprung on any page numbered
+``1''; in practice, unless your page numbering is unusual, this means
+that you should call it early, before @code{TL} or any heading or
+paragraphing macro.  This is a Berkeley extension.
+@endDefmac
+
+For even greater flexibility, @file{ms} is designed to permit the
+redefinition of the macros that are called when the @code{groff} traps
+that ordinarily cause the headers and footers to be output are sprung.
+@code{PT} (``page trap'') is called by @file{ms} when the header is to
+be written, and @code{BT} (``bottom trap'') when the footer is to be.
+The @code{groff} page location trap that @file{ms} sets up to format the
+header also calls the (normally undefined) @code{HD} macro after
+@code{PT}; you can define @code{HD} if you need additional processing
+after setting the header (for example, to draw a line below it).
+@c Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+The @code{HD} hook is a Berkeley extension.  Any such macros you
+(re)define must implement any desired specialization for odd-, even-, or
+first numbered pages.
 
-To specify custom header and footer processing, redefine the following
-macros:
+@c ---------------------------------------------------------------------
+
+@node Tab Stops in ms, ms Margins, ms Headers and Footers, ms Page Layout
+@subsubsection Tab stops
 
-@DefmacList {PT,, ms}
-@DefmacItemx {HD,, ms}
-@DefmacListEndx {BT,, ms}
-The @code{PT} macro defines a custom header; the @code{BT} macro defines
-a custom footer.  These macros must handle odd/even/first page
-differences if necessary.
+Use the @code{ta} request to define tab stops as needed.  @xref{Tabs and
+Fields}.
 
-The @code{HD} macro defines additional header processing to take place
-after executing the @code{PT} macro.
+@Defmac {TA, , ms}
+Reset the tab stops to the @file{ms} default (every 5 ens).
+Redefine this macro to create a different set of default tab stops.
 @endDefmac
 
 @c ---------------------------------------------------------------------
 
-@node ms Margins, ms Multiple Columns, ms Headers and Footers, ms Page Layout
+@node ms Margins, ms Multiple Columns, Tab Stops in ms, ms Page Layout
 @subsubsection Margins
-@cindex @code{ms} macros, margins
+@cindex @file{ms} macros, margins
 
-You control margins using a set of number registers.  @xref{ms Document
-Control Registers}, for details.
+Control margins using the registers summarized in ``Margin settings'' in
+@ref{ms Document Control Settings} above.  There is no setting for the
+right margin; the combination of page offset @code{\nPO} and line
+length @code{\nLL} determines it.
 
 @c ---------------------------------------------------------------------
 
 @node ms Multiple Columns, ms TOC, ms Margins, ms Page Layout
 @subsubsection Multiple columns
-@cindex @code{ms} macros, multiple columns
-@cindex multiple columns @code{ms}
+@cindex @file{ms} macros, multiple columns
+@cindex multiple columns @file{ms}
 
-The @file{ms} macros can set text in as many columns as do reasonably
-fit on the page.  The following macros are available; all of them force
-a page break if a multi-column mode is already set.  However, if the
-current mode is single-column, starting a multi-column mode does
-@emph{not} force a page break.
+@file{ms} can set text in as many columns as reasonably fit on the page.
+The following macros force a page break if a multi-column layout is
+active when they are called.  The @code{MINGW} register stores the
+default minimum gutter width; it is a GNU extension.  When multiple
+columns are in use, keeps and the @code{HORPHANS} and @code{PORPHANS}
+registers work with respect to column breaks instead of page breaks.
 
 @Defmac {1C, , ms}
-Single-column mode.
+Arrange page text in a single column (the default).
 @endDefmac
 
 @Defmac {2C, , ms}
-Two-column mode.
+Arrange page text in two columns.
 @endDefmac
 
-@Defmac {MC, @Var{width} @Var{gutter}, ms}
-Multi-column mode.  If you specify no arguments, it is equivalent to the
-@code{2C} macro.  Otherwise, @var{width} is the width of each column and
-@var{gutter} is the space between columns.  The @code{MINGW} number
-register controls the default gutter width.
+@Defmac {MC, @Var{column-width} @Var{gutter-width}, ms}
+Arrange page text in multiple columns.  If you specify no arguments, it
+is equivalent to the @code{2C} macro.  Otherwise, @var{column-width} is
+the width of each column and @var{gutter-width} is the minimum distance
+between columns.
 @endDefmac
 
 @c ---------------------------------------------------------------------
 
-@node ms TOC, ms Strings and Special Characters, ms Multiple Columns, ms Page Layout
+@node ms TOC, Differences from AT&T ms, ms Multiple Columns, ms Page Layout
 @subsubsection Creating a table of contents
-@cindex @code{ms} macros, creating table of contents
-@cindex table of contents, creating @code{ms}
+@cindex @file{ms} macros, creating table of contents
+@cindex table of contents, creating @file{ms}
 
-The facilities in the @file{ms} macro package for creating a table of
-contents are semi-automated at best.  Assuming that you want the table
-of contents to consist of the document's headings, you need to repeat
-those headings wrapped in @code{XS} and @code{XE} macros.
+Because @code{roff} formatters process their input in a single pass,
+material on page 50, for example, cannot influence what appears on
+page@tie{}1---this poses a challenge for a table of contents at its
+traditional location in front matter, if you wish to avoid manually
+maintaining it.  @file{ms} enables the collection of material to be
+presented in the table of contents as it appears, saving its page number
+along with it, and then emitting the collected contents on demand toward
+the end of the document.  The table of contents can then be resequenced
+to its desired location by physically rearranging the pages of a printed
+document, or as part of post-processing---with a @cite{sed@r{(1)}}
+script to reorder the pages in @command{troff}'s output, with
+@cite{pdfjam@r{(1)}}, or with @cite{gropdf@r{(1)}}'s
+@samp{.pdfswitchtopage} feature, for example.
+
+Define an entry to appear in the table of contents by bracketing its
+text between calls to the @code{XS} and @code{XE} macros.  A typical
+application is to call them immediately after @code{NH} or @code{SH} and
+repeat the heading text within them.  The @code{XA} macro, used within
+@samp{.XS}/@samp{.XE} pairs, supplements an entry---for instance, when
+it requires multiple output lines, whether because a heading is too long
+to fit or because style dictates that page numbers not be repeated.  You
+may wish to indent the text thus wrapped to correspond to its heading
+depth; this can be done in the entry text by prefixing it with tabs or
+horizontal motion escape sequences, or by providing a second argument to
+the @code{XA} macro.  @code{XS} and @code{XA} automatically associate
+the page number where they are called with the text following them, but
+they accept arguments to override this behavior.  At the end of the
+document, call @code{TC} or @code{PX} to emit the table of contents;
+@code{TC} resets the page number to @samp{i} (Roman numeral one), and
+then calls @code{PX}.  All of these macros are Berkeley extensions.
 
-@DefmacList {XS, @Var{page}, ms}
-@DefmacItemx {XA, @Var{page}, ms}
+@DefmacList {XS, @Var{page-number}, ms}
+@DefmacItemx {XA, @Var{page-number} @Var{indentation}, ms}
 @DefmacListEndx {XE, , ms}
-These macros define a table of contents or an individual entry in the
-table of contents, depending on their use.  The macros are very simple;
-they cannot indent a heading based on its level.  The easiest way to
-work around this is to add tabs to the table of contents string.  The
-following is an example:
+Begin, supplement, and end a table of contents entry.  Each entry is
+associated with @var{page-number} (otherwise the current page number); a
+@var{page-number} of @samp{no} prevents a leader and page number from
+being emitted for that entry.  Use of @code{XA} within
+@code{XS}/@code{XE} is optional; it can be repeated.  If
+@var{indentation} is present, a supplemental entry is indented by that
+amount; ens are assumed if no unit is indicated.  Text on input lines
+between @code{XS} and @code{XE} is stored for later recall by @code{PX}.
+@endDefmac
+
+@Defmac {PX, @code{no}, ms}
+Switch to single-column layout.  Unless @code{no} is specified, center
+and interpolate the @code{TOC} string in bold and two points larger than
+the body text.  Emit the table of contents entries.
+@endDefmac
+
+@Defmac {TC, @code{no}, ms}
+Set the page number to@tie{}1, the page number format to lowercase Roman
+numerals, and call @code{PX} (with a @code{no} argument, if present).
+@endDefmac
+
+Here's an example of typical @file{ms} table of contents preparation.
+We employ horizontal escape sequences @code{\h} to indent the entries by
+sectioning depth.
 
 @CartoucheExample
 .NH 1
@@ -4178,411 +4409,442 @@
 .XS
 Introduction
 .XE
-.LP
-...
-.CW
+@r{@dots{}}
 .NH 2
 Methodology
 .XS
-Methodology
+\h'2n'Methodology
+.XA
+\h'4n'Fassbinder's Approach
+\h'4n'Kahiu's Approach
 .XE
-.LP
-...
+@r{@dots{}}
+.NH 1
+Findings
+.XS
+Findings
+.XE
+@r{@dots{}}
+.TC
 @endCartoucheExample
 
-You can manually create a table of contents by beginning with the
-@code{XS} macro for the first entry, specifying the page number for that
-entry as the argument to @code{XS}.  Add subsequent entries using the
-@code{XA} macro, specifying the page number for that entry as the
-argument to @code{XA}.  The following is an example:
+The remaining features in this subsubsection are GNU extensions.
+@code{groff} @file{ms} obviates the need to repeat heading text after
+@code{XS} calls.  Call @code{XN} and @code{XH} after @code{NH} and
+@code{SH}, respectively.
+
+@DefmacList {XN, @Var{heading-text}, ms}
+@DefmacListEndx {XH, @Var{depth} @Var{heading-text}, ms}
+Format @var{heading-text} and create a corresponding table of contents
+entry.  @code{XN} computes the indentation from the depth of the
+preceding @code{NH} call; @code{XH} requires a @var{depth} argument to
+do so.
+@endDefmac
+
+@code{groff} @file{ms} encourages customization of table of contents
+entry production.
+
+@DefmacList {XN-REPLACEMENT, @Var{heading-text}, ms}
+@DefmacListEndx {XH-REPLACEMENT, @Var{depth} @Var{heading-text}, ms}
+These hook macros implement @code{XN} and @code{XH}, respectively.
+They call @code{XN-INIT} and pass their @var{heading-text} arguments to
+@code{XH-UPDATE-TOC}.
+@endDefmac
+
+@DefmacList {XN-INIT, , ms}
+@DefmacListEndx {XH-UPDATE-TOC, @Var{depth} @Var{heading-text}, ms}
+The @code{XN-INIT} hook macro does nothing by default.
+@code{XH-UPDATE-TOC} brackets @var{heading-text} with @code{XS} and
+@code{XE} calls, indenting it by 2 ens per level of @var{depth} beyond
+the first.
+@endDefmac
+
+We could therefore produce a table of contents similar to that in the
+previous example with fewer macro calls.  (The difference is that this
+input follows the ``Approach'' entries with leaders and page numbers.)
 
 @CartoucheExample
-.XS 1
-Introduction
-.XA 2
-A Brief History of the Universe
-.XA 729
-Details of Galactic Formation
-...
-.XE
+.NH 1
+.XN Introduction
+@r{@dots{}}
+.NH 2
+.XN Methodology
+.XH 3 "Fassbinder's Approach"
+.XH 3 "Kahiu's Approach"
+@r{@dots{}}
+.NH 1
+.XN Findings
+@r{@dots{}}
 @endCartoucheExample
-@endDefmac
 
-@Defmac {TC, @code{no}, ms}
-Prints the table of contents on a new page, setting the page number
-to@tie{}@strong{i} (Roman lowercase numeral one).  You should usually
-place this macro at the end of the file, since @code{groff} is a
-single-pass formatter and can only print what has been collected up to
-the point that the @code{TC} macro appears.
+To get the section number of the numbered headings into the table of
+contents entries, we might define @code{XN-REPLACEMENT} as follows.
+(We obtain the heading depth from @code{groff} @file{ms}'s internal
+register @code{nh*hl}.)
 
-The optional argument @code{no} suppresses printing the title specified
-by the string register @code{TOC}.
-@endDefmac
-
-@Defmac {PX, @code{no}, ms}
-Prints the table of contents on a new page, using the current page
-numbering sequence.  Use this macro to print a manually generated table
-of contents at the beginning of your document.
-
-The optional argument @code{no} suppresses printing the title specified
-by the string register @code{TOC}.
-@endDefmac
-
-The @cite{Groff and Friends HOWTO} includes a @code{sed} script that
-automatically inserts @code{XS} and @code{XE} macro entries after each
-heading in a document.
-
-Altering the @code{NH} macro to automatically build the table of
-contents is perhaps initially more difficult, but would save a great
-deal of time in the long run if you use @file{ms} regularly.
-
-@c ---------------------------------------------------------------------
-
-@node ms Strings and Special Characters,  , ms TOC, ms Page Layout
-@subsubsection Strings and Special Characters
-@cindex @code{ms} macros, strings
-@cindex @code{ms} macros, special characters
-@cindex @code{ms} macros, accent marks
-@cindex accent marks @code{ms}
-@cindex special characters @code{ms}
-@cindex strings @code{ms}
-
-The @file{ms} macros provide the following predefined strings.  You can
-change the string definitions to help in creating documents in languages
-other than English.
-
-@Defstr {REFERENCES, ms}
-Contains the string printed at the beginning of the references
-(bibliography) page.  The default is @samp{References}.
-@endDefstr
-
-@Defstr {ABSTRACT, ms}
-Contains the string printed at the beginning of the abstract.  The
-default is @samp{ABSTRACT}.
-@endDefstr
-
-@Defstr {TOC, ms}
-Contains the string printed at the beginning of the table of contents.
-@endDefstr
-
-@DefstrList {MONTH1, ms}
-@DefstrItemx {MONTH2, ms}
-@DefstrItemx {MONTH3, ms}
-@DefstrItemx {MONTH4, ms}
-@DefstrItemx {MONTH5, ms}
-@DefstrItemx {MONTH6, ms}
-@DefstrItemx {MONTH7, ms}
-@DefstrItemx {MONTH8, ms}
-@DefstrItemx {MONTH9, ms}
-@DefstrItemx {MONTH10, ms}
-@DefstrItemx {MONTH11, ms}
-@DefstrListEndx {MONTH12, ms}
-Prints the full name of the month in dates.  The default is
-@samp{January}, @samp{February}, etc.
-@endDefstr
-
-The following special characters are available@footnote{For an
-explanation what special characters are see @ref{Special Characters}.}:
-
-@Defstr {-, ms}
-Prints an em dash.
-@endDefstr
-
-@DefstrList {Q, ms}
-@DefstrListEndx {U, ms}
-Prints typographer's quotes in troff, and plain quotes in nroff.
-@code{\*Q} is the left quote and @code{\*U} is the right quote.
-@endDefstr
-
-Improved accent marks are available in the @file{ms} macros.
-
-@Defmac {AM, , ms}
-Specify this macro at the beginning of your document to enable extended
-accent marks and special characters.  This is a Berkeley extension.
-
-To use the accent marks, place them @strong{after} the character being
-accented.
-
-Note that groff's native support for accents is superior to the
-following definitions.
-@endDefmac
-
-The following accent marks are available after invoking the @code{AM}
-macro:
-
-@Defstr {', ms}
-Acute accent.
-@endDefstr
-
-@Defstr {`, ms}
-Grave accent.
-@endDefstr
-
-@Defstr {^, ms}
-Circumflex.
-@endDefstr
-
-@Defstr {\,, ms}
-Cedilla.
-@endDefstr
-
-@Defstr {~, ms}
-Tilde.
-@endDefstr
-
-@deffn String @t{\*:}
-@ifnotinfo
-@stindex : @r{}ms@r{}
-@end ifnotinfo
-@ifinfo
-@stindex \*@r{<colon>} @r{}ms@r{}
-@end ifinfo
-Umlaut.
-@end deffn
-
-@Defstr {v, ms}
-Hacek.
-@endDefstr
-
-@Defstr {_, ms}
-Macron (overbar).
-@endDefstr
-
-@Defstr {., ms}
-Underdot.
-@endDefstr
-
-@Defstr {o, ms}
-Ring above.
-@endDefstr
-
-The following are standalone characters available after invoking the
-@code{AM} macro:
-
-@Defstr {?, ms}
-Upside-down question mark.
-@endDefstr
-
-@Defstr {!, ms}
-Upside-down exclamation point.
-@endDefstr
-
-@Defstr {8, ms}
-German ß ligature.
-@endDefstr
-
-@Defstr {3, ms}
-Yogh.
-@endDefstr
-
-@Defstr {Th, ms}
-Uppercase thorn.
-@endDefstr
-
-@Defstr {th, ms}
-Lowercase thorn.
-@endDefstr
-
-@Defstr {D-, ms}
-Uppercase eth.
-@endDefstr
-
-@Defstr {d-, ms}
-Lowercase eth.
-@endDefstr
-
-@Defstr {q, ms}
-Hooked o.
-@endDefstr
-
-@Defstr {ae, ms}
-Lowercase æ ligature.
-@endDefstr
+@CartoucheExample
+.de XN-REPLACEMENT
+.XN-INIT
+.XH-UPDATE-TOC \\nnh*hl \\$@@
+\&\\*SN \\$*
+..
+@endCartoucheExample
 
-@Defstr {Ae, ms}
-Uppercase Æ ligature.
-@endDefstr
+You can change the style of the leader that bridges each table of
+contents entry with its page number; define the @code{TC-LEADER} special
+character by using the @code{char} request.  A typical leader combines
+the dot glyph @samp{.} with a horizontal motion escape sequence to
+spread the dots.  The width of the page number field is stored in the
+@code{TC-MARGIN} register.
 
 @c ---------------------------------------------------------------------
 
-@node Differences from AT&T ms, Naming Conventions, ms Page Layout, ms
+@node Differences from AT&T ms, ms Naming Conventions, ms Page Layout, ms
 @subsection Differences from @acronym{AT&T} @file{ms}
-@cindex @code{ms} macros, differences from @acronym{AT&T}
-@cindex @acronym{AT&T} @code{troff}, @code{ms} macro package differences
+@cindex @file{ms} macros, @code{groff} differences from @acronym{AT&T}
+@cindex @acronym{AT&T} @file{ms}, macro package differences
 
-This section lists the (minor) differences between the @code{groff -ms}
-macros and @acronym{AT&T} @code{troff -ms} macros.
+The @code{groff} @file{ms} macros are an independent reimplementation,
+using no @acronym{AT&T} code.  Since they take advantage of the extended
+features of @code{groff}, they cannot be used with @acronym{AT&T}
+@code{troff}.  @code{groff} @file{ms} supports features described above
+as Berkeley and Tenth Edition Research Unix extensions, and adds several
+of its own.
 
 @itemize @bullet
 @item
-The internals of @code{groff -ms} differ from the internals of
-@acronym{AT&T} @code{troff -ms}.  Documents that depend upon
-implementation details of @acronym{AT&T} @code{troff -ms} may not format
-properly with @code{groff -ms}.
+The internals of @code{groff} @file{ms} differ from the internals of
+@acronym{AT&T} @file{ms}.  Documents that depend upon implementation
+details of @acronym{AT&T} @file{ms} may not format properly with
+@code{groff} @file{ms}.  Such details include macros whose function was
+not documented in the @acronym{AT&T} @file{ms}
+manual.@footnote{@cite{Typing Documents on the UNIX System: Using the
+-ms Macros with Troff and Nroff}, M.@tie{}E.@: Lesk, Bell Laboratories,
+1978}
+@c XXX: We support RT anyway; maybe we should stop?
 
 @item
-The general error-handling policy of @code{groff -ms} is to detect and
-report errors, rather than silently to ignore them.
+The error-handling policy of @code{groff} @file{ms} is to detect and
+report errors, rather than to ignore them silently.
 
 @item
-@code{groff -ms} does not work in compatibility mode (that is, with the
-@option{-C} option).
+Tenth Edition @c possibly 9th
+Research Unix supported @code{P1}/@code{P2} macros to bracket code
+examples; @code{groff} @file{ms} does not.
 
 @item
-There is no special support for typewriter-like devices.
-
-@item
-@code{groff -ms} does not provide cut marks.
+@code{groff} @file{ms} does not work in GNU @code{troff}'s
+@acronym{AT&T} compatibility mode.  If loaded when that mode is enabled,
+it aborts processing with a diagnostic message.
 
 @item
 Multiple line spacing is not supported.  Use a larger vertical spacing
 instead.
 
 @item
-Some Unix @code{ms} documentation says that the @code{CW} and @code{GW}
-number registers can be used to control the column width and gutter
-width, respectively.  These number registers are not used in @code{groff
--ms}.
+@code{groff} @file{ms} uses the same header and footer defaults in both
+@code{nroff} and @code{troff} modes as @acronym{AT&T} @file{ms} does in
+@code{troff} mode; @acronym{AT&T}'s default in @code{nroff} mode is to
+put the date, in U.S.@: traditional format (e.g., ``January 1, 2021''),
+in the center footer (the @code{CF} string).
+
+@item
+Many @code{groff} @file{ms} macros, including those for paragraphs,
+headings, and displays, cause a reset of paragraph rendering parameters,
+and may change the indentation; they do so not by incrementing or
+decrementing it, but by setting it absolutely.  This can cause problems
+for documents that define additional macros of their own that try to
+manipulate indentation.  Use the @file{ms} @code{RS} and @code{RE}
+macros instead of the @code{in} request.
+
+@item
+@cindex fractional type sizes in @file{ms} macros
+@cindex @file{ms} macros, fractional type sizes in
+@acronym{AT&T} @file{ms} interpreted the values of the registers
+@code{PS} and @code{VS} in points, and did not support the use of
+scaling units with them.  @code{groff} @file{ms} interprets values of
+the registers @code{PS}, @code{VS}, @code{FPS}, and @code{FVS} equal to
+or larger than@tie{}1,000 (one thousand) as decimal fractions multiplied
+by@tie{}1,000.@footnote{Register values are converted to and stored as
+basic units.  @xref{Measurements}.}  This threshold makes use of a
+scaling unit with these parameters practical for high-resolution
+devices while preserving backward compatibility.  It also permits
+expression of non-integral type sizes.  For example, @samp{groff
+-rPS=10.5p} at the shell prompt is equivalent to placing @samp{.nr PS
+10.5p} at the beginning of the document.
+
+@item
+@acronym{AT&T} @file{ms}'s @code{AU} macro supported arguments used with
+some document types; @code{groff} @file{ms} does not.
+
+@item
+Right-aligned displays are available.  The @acronym{AT&T} @file{ms}
+manual observes that ``it is tempting to assume that @samp{.DS R} will
+right adjust lines, but it doesn't work''.  In @code{groff} @file{ms},
+it does.
 
 @item
-Macros that cause a reset (paragraphs, headings, etc.@:) may change the
-indentation.  Macros that change the indentation do not increment or
-decrement the indentation, but rather set it absolutely.  This can cause
-problems for documents that define additional macros of their own.  The
-solution is to use not the @code{in} request but instead the @code{RS}
-and @code{RE} macros.
+To make @code{groff} @file{ms} use the default page offset (which also
+specifies the left margin), the @code{PO} register must stay undefined
+until the first @file{ms} macro is called.
+
+This implies that @samp{\nPO} should not be used early in the
+document, unless it is changed also: accessing an undefined register
+automatically defines it.
+
+@item
+@code{groff} @file{ms} supports the @code{PN} register, but it is not
+necessary; you can access the page number via the usual @code{%}
+register and invoke the @code{af} request to assign a different format
+to it if desired.@footnote{If you redefine the @file{ms} @code{PT} macro
+@c I wouldn't mention that, but Lesk 1978 encourages doing so.  :-/
+and desire special treatment of certain page numbers (like @samp{1}),
+you may need to handle a non-Arabic page number format, as @code{groff}
+@file{ms}'s @code{PT} does; see the macro package source.  @code{groff}
+@file{ms} aliases the @code{PN} register to @code{%}.}
+
+@item
+The @acronym{AT&T} @file{ms} manual documents registers @code{CW} and
+@code{GW} as setting the default column width and ``intercolumn gap'',
+respectively, and which applied when @code{MC} was called with fewer
+than two arguments.  @code{groff} @file{ms} instead treats @code{MC}
+without arguments as synonymous with @code{2C}; there is thus no
+occasion for a default column width register.  Further, the @code{MINGW}
+register and the second argument to @code{MC} specify a @emph{minimum}
+space between columns, not the fixed gutter width of @acronym{AT&T}
+@file{ms}.
 
 @item
-To make @code{groff -ms} use the default page offset (which also
-specifies the left margin), the @code{PO} register must stay undefined
-until the first @file{-ms} macro is evaluated.  This implies that
-@code{PO} should not be used early in the document, unless it is changed
-also: Remember that accessing an undefined register automatically
-defines it.
+The @acronym{AT&T} @file{ms} manual did not document the @code{QI}
+register; Berkeley and @code{groff} @file{ms} do.
 @end itemize
 
 @Defmpreg {GS, ms}
-This number register is set to@tie{}1 by the @code{groff -ms} macros,
-but it is not used by the @code{AT&T} @code{troff -ms} macros.
+The register @code{GS} is set to@tie{}1 by the @code{groff} @file{ms}
+macros, but is not used by the @acronym{AT&T} @file{ms} package.
 Documents that need to determine whether they are being formatted with
-@code{AT&T} @code{troff -ms} or @code{groff -ms} should use this number
+@code{groff} @file{ms} or another implementation should test this
 register.
 @endDefmpreg
 
-Emulations of a few ancient Bell Labs macros can be re-enabled by
-calling the otherwise undocumented @code{SC} section-header macro.
-Calling @code{SC} enables @code{UC} for marking up a product or
-application name, and the pair @code{P1}/@code{P2} for surrounding code
-example displays.
-
-These are not enabled by default because (a)@tie{}they were not
-documented, in the original @code{ms} manual, and (b)@tie{}the @code{P1}
-and @code{UC} macros collide with different macros with the same names
-in the Berkeley version of @code{ms}.
-
-These @code{groff} emulations are sufficient to give back the 1976
-Kernighan@tie{}& Cherry paper @cite{Typesetting Mathematics -- User's
-Guide} its section headings, and restore some text that had gone missing
-as arguments of undefined macros.  No warranty express or implied is
-given as to how well the typographic details these produce match the
-original Bell Labs macros.
-
 @menu
-* Missing ms Macros::
-* Additional ms Macros::
+* Missing Unix Version 7 ms Macros::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Missing ms Macros, Additional ms Macros, Differences from AT&T ms, Differences from AT&T ms
-@subsubsection @code{troff} macros not appearing in @code{groff}
+@node Missing Unix Version 7 ms Macros, , Differences from AT&T ms, Differences from AT&T ms
+@subsubsection Unix Version 7 @file{ms} macros not implemented by @code{groff} @file{ms}
 
-Macros missing from @code{groff -ms} are cover page macros specific to
-Bell Labs and Berkeley.  The macros known to be missing are:
+Several macros described in the Unix Version@tie{}7 @file{ms}
+documentation are unimplemented by @code{groff} @file{ms} because they
+are specific to the requirements of documents produced internally by
+Bell Laboratories, some of which also require a glyph for the Bell
+System logo that @code{groff} does not support.  These macros
+implemented several document type formats
+(@code{EG}, @c engineer's notes
+@code{IM}, @c internal memorandum
+@code{MF}, @c memorandum for file
+@code{MR}, @c memorandum for record
+@code{TM}, @c technical memorandum
+@code{TR}), @c technical report
+were meaningful only in conjunction with the use of certain document
+types
+(@code{AT}, @c attachments
+@code{CS}, @c cover sheet info for `TM` documents
+@code{CT}, @c copies to
+@code{OK}, @c "other keywords" for `TM` documents
+@code{SG}), @c signatures for `TM` documents
+stored the postal addresses of Bell Labs sites
+(@code{HO}, @c Holmdel
+@code{IH}, @c Naperville
+@code{MH}, @c Murray Hill
+@code{PY}, @c Piscataway
+@code{WH}), @c Whippany
+or lacked a stable definition over time
+(@code{UX}). @c Unix; on 1st use, add footnote id'ing trademark owner
+To compatibly render historical @file{ms} documents using these macros,
+we advise your documents to invoke the @code{rm} request to remove any
+such macros it uses and then define replacements with an authentically
+typeset original at hand.@footnote{The removal beforehand is necessary
+because @code{groff} @file{ms} aliases these macros to a diagnostic
+macro, and you want to redefine the aliased name, not its target.}  For
+informal purposes, a simple definition of @code{UX} should maintain the
+readability of the document's substance.
 
-@table @code
-@item .TM
-Technical memorandum; a cover sheet style
+@CartoucheExample
+.rm UX
+.ds UX Unix\"
+@endCartoucheExample
 
-@item .IM
-Internal memorandum; a cover sheet style
+@c ---------------------------------------------------------------------
 
-@item .MR
-Memo for record; a cover sheet style
+@node ms Legacy Features, ms Naming Conventions, Differences from AT&T ms, ms
+@subsection Legacy Features
+@cindex @file{ms} macros, strings
+@cindex @file{ms} macros, special characters
+@cindex @file{ms} macros, accent marks
+@cindex accent marks @file{ms}
+@cindex special characters @file{ms}
+@cindex strings @file{ms}
+
+@code{groff} @file{ms} retains some legacy features solely to support
+formatting of historical documents; contemporary ones should not use
+them because they can render poorly.  See the @cite{groff_char@r{(7)}}
+man page.
+
+@unnumberedsubsubsec AT&T accent mark strings
+
+AT&T @file{ms} defined accent mark strings as follows.
+
+@Defmpstr {@code{'}, ms}
+Apply acute accent to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {@code{`}, ms}
+Apply grave accent to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {:, ms}
+Apply dieresis (umlaut) to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {^, ms}
+Apply circumflex accent to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {~, ms}
+Apply tilde accent to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {C, ms}
+Apply caron to subsequent glyph.
+@endDefmpstr
+
+@Defmpstr {\,, ms}
+Apply cedilla to subsequent glyph.
+@endDefmpstr
+
+@unnumberedsubsubsec Berkeley accent mark and glyph strings
+
+Berkeley @file{ms} offered an @code{AM} macro; calling it redefined the
+AT&T accent mark strings (except for @samp{\*C}), applied them to the
+@emph{preceding} glyph, and defined additional strings, some for spacing
+glyphs.
 
-@item .MF
-Memo for file; a cover sheet style
+@Defmac {AM, , ms}
+Enable alternative accent mark and glyph-producing strings.
+@endDefmac
 
-@item .EG
-Engineer's notes; a cover sheet style
+@Defmpstr {@code{'}, ms}
+Apply acute accent to preceding glyph.
+@endDefmpstr
 
-@item .TR
-Computing Science Tech Report; a cover sheet style
+@Defmpstr {@code{`}, ms}
+Apply grave accent to preceding glyph.
+@endDefmpstr
 
-@item .OK
-Other keywords
+@Defmpstr {:, ms}
+Apply dieresis (umlaut) to preceding glyph.
+@endDefmpstr
 
-@item .CS
-Cover sheet information
+@Defmpstr {^, ms}
+Apply circumflex accent to preceding glyph.
+@endDefmpstr
 
-@item .MH
-A cover sheet macro
-@end table
+@Defmpstr {~, ms}
+Apply tilde accent to preceding glyph.
+@endDefmpstr
 
-@c ---------------------------------------------------------------------
+@Defmpstr {\,, ms}
+Apply cedilla to preceding glyph.
+@endDefmpstr
 
-@node Additional ms Macros,  , Missing ms Macros, Differences from AT&T ms
-@subsubsection @code{groff} macros not appearing in @acronym{AT&T} @code{troff}
+@Defmpstr {/, ms}
+Apply stroke (slash) to preceding glyph.
+@endDefmpstr
 
-The @code{groff -ms} macros have a few minor extensions compared to the
-@acronym{AT&T} @code{troff -ms} macros.
+@Defmpstr {v, ms}
+Apply caron to preceding glyph.
+@endDefmpstr
 
-@Defmac {AM, , ms}
-Improved accent marks.  @xref{ms Strings and Special Characters}, for
-details.
-@endDefmac
+@Defmpstr {_, ms}
+Apply macron to preceding glyph.
+@endDefmpstr
 
-@Defmac {DS, @t{I}, ms}
-Indented display.  The default behavior of @acronym{AT&T} @code{troff
--ms} was to indent; the @code{groff} default prints displays flush left
-with the body text.
-@endDefmac
+@Defmpstr {., ms}
+Apply underdot to preceding glyph.
+@endDefmpstr
 
-@Defmac {CW, , ms}
-Print text in @code{constant width} (Courier) font.
-@endDefmac
+@Defmpstr {o, ms}
+Apply ring accent to preceding glyph.
+@endDefmpstr
 
-@Defmac {IX, , ms}
-Indexing term (printed on standard error).  You can write a script to
-capture and process an index generated in this manner.
-@endDefmac
+@Defmpstr {?, ms}
+Interpolate inverted question mark.
+@endDefmpstr
 
-The following additional number registers
-appear in @code{groff -ms}:
+@Defmpstr {!, ms}
+Interpolate inverted exclamation mark.
+@endDefmpstr
 
-@Defmpreg {MINGW, ms}
-Specifies a minimum space between columns (for multi-column output);
-this takes the place of the @code{GW} register that was documented but
-apparently not implemented in @acronym{AT&T} @code{troff}.
-@endDefmpreg
+@Defmpstr {8, ms}
+Interpolate small letter sharp s.
+@endDefmpstr
+
+@Defmpstr {q, ms}
+Interpolate small letter o with hook accent (ogonek).
+@endDefmpstr
+
+@Defmpstr {3, ms}
+Interpolate small letter yogh.
+@endDefmpstr
+
+@Defmpstr {d-, ms}
+Interpolate small letter eth.
+@endDefmpstr
+
+@Defmpstr {D-, ms}
+Interpolate capital letter eth.
+@endDefmpstr
 
-Several new string registers are available as well.  You can change
-these to handle (for example) the local language.  @xref{ms Strings and
-Special Characters}, for details.
+@Defmpstr {th, ms}
+Interpolate small letter thorn.
+@endDefmpstr
+
+@Defmpstr {Th, ms}
+Interpolate capital letter thorn.
+@endDefmpstr
+
+@Defmpstr {ae, ms}
+Interpolate small æ ligature.
+@endDefmpstr
+
+@Defmpstr {Ae, ms}
+Interpolate capital Æ ligature.
+@endDefmpstr
+
+@Defmpstr {oe, ms}
+Interpolate small oe ligature.
+@endDefmpstr
+
+@Defmpstr {OE, ms}
+Interpolate capital OE ligature.
+@endDefmpstr
 
 @c ---------------------------------------------------------------------
 
-@node Naming Conventions,  , Differences from AT&T ms, ms
+@node ms Naming Conventions,  , ms Legacy Features, ms
 @subsection Naming Conventions
-@cindex @code{ms} macros, naming conventions
-@cindex naming conventions, @code{ms} macros
+@cindex @file{ms} macros, naming conventions
+@cindex naming conventions, @file{ms} macros
 
-The following conventions are used for names of macros, strings and
-number registers.  External names available to documents that use the
-@code{groff -ms} macros contain only uppercase letters and digits.
+The following conventions are used for names of macros, strings, and
+registers.  External names available to documents that use the
+@code{groff} @file{ms} macros contain only uppercase letters and digits.
 
-Internally the macros are divided into modules; naming conventions are
-as follows:
+Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
 
 @itemize @bullet
 @item
@@ -4606,7 +4868,7 @@
 @var{array}@code{!}@var{index}.
 @end itemize
 
-Thus the groff ms macros reserve the following names:
+Thus the @code{groff} @file{ms} macros reserve the following names.
 
 @itemize @bullet
 @item
@@ -4618,109 +4880,51 @@
 
 
 @c =====================================================================
-
-@node me, mm, ms, Macro Packages
-@section @file{me}
-@cindex @code{me} macro package
-
-@c XXX documentation
-@c XXX this is a placeholder until we get stuff knocked into shape
-See the @file{meintro.me} and @file{meref.me} documents in groff's
-@file{doc} directory.
-
-
-@c =====================================================================
-
-@node mm, mom, me, Macro Packages
-@section @file{mm}
-@cindex @code{mm} macro package
-
-@c XXX documentation
-@c XXX this is a placeholder until we get stuff knocked into shape
-See the @cite{groff_mm(7)} man page (type @command{man groff_mm} at the
-command line).
-
-
-@c =====================================================================
-
-@node mom,  , mm, Macro Packages
-@section @file{mom}
-@cindex @code{mom} macro package
-
-@c XXX documentation
-@c XXX this is a placeholder until we get stuff knocked into shape
-The main documentation files for the @file{mom} macros are in
-@acronym{HTML} format.  Additional, useful documentation is in PDF
-format.  See the @cite{groff(1)} man page, section ``Installation
-Directories'', for their location.
-
-@itemize @bullet
-@item
-@file{toc.html}
-@noindent
-Entry point to the full mom manual.
-
-@item
-@file{macrolist.html}
-@noindent
-Hyperlinked index of macros with brief descriptions, arranged by
-category.
-
-@item
-@file{mom-pdf.pdf}
-@noindent
-PDF features and usage.
-@end itemize
-
-The mom macros are in active development between groff releases.
-The most recent version, along with up-to-date documentation, is
-available at @uref{http://www.schaffter.ca/mom/mom-05.html}.
-
-The @cite{groff_mom(7)} man page (type @command{man groff_mom} at the
-command line) contains a partial list of available macros, however their
-usage is best understood by consulting the @acronym{HTML} documentation.
-
-@c =====================================================================
 @c =====================================================================
 
-@node gtroff Reference, Preprocessors, Macro Packages, Top
-@chapter @code{gtroff} Reference
+@node GNU troff Reference, File Formats, Major Macro Packages, Top
+@chapter GNU @code{troff} Reference
 @cindex reference, @code{gtroff}
 @cindex @code{gtroff}, reference
 
-This chapter covers @strong{all} of the facilities of @code{gtroff}.
-Users of macro packages may skip it if not interested in details.
+This chapter covers @emph{all} of the facilities of the GNU
+@code{troff} formatting engine.  Users of macro packages may skip it if
+not interested in details.
 
 
 @menu
 * Text::
+* Page Geometry::
 * Measurements::
-* Expressions::
+* Numeric Expressions::
 * Identifiers::
-* Embedded Commands::
+* Formatter Instructions::
+* Comments::
 * Registers::
-* Manipulating Filling and Adjusting::
+* Manipulating Filling and Adjustment::
 * Manipulating Hyphenation::
 * Manipulating Spacing::
 * Tabs and Fields::
 * Character Translations::
-* Troff and Nroff Mode::
+* @code{troff} and @code{nroff} Modes::
 * Line Layout::
-* Line Control::
+* Line Continuation::
 * Page Layout::
 * Page Control::
-* Fonts and Symbols::
-* Sizes::
+* Using Fonts::
+* Manipulating Type Size and Vertical Spacing::
+* Colors::
 * Strings::
 * Conditionals and Loops::
 * Writing Macros::
 * Page Motions::
-* Drawing Requests::
+* Drawing Geometric Objects::
+* Deferring Output::
 * Traps::
 * Diversions::
+* Punning Names::
 * Environments::
-* Suppressing output::
-* Colors::
+* Suppressing Output::
 * I/O::
 * Postprocessor Access::
 * Miscellaneous::
@@ -4732,107 +4936,162 @@
 
 @c =====================================================================
 
-@node Text, Measurements, gtroff Reference, gtroff Reference
+@c BEGIN Keep roughly parallel with roff(7) section "Concepts".
+@node Text, Measurements, GNU troff Reference, GNU troff Reference
 @section Text
-@cindex text, @code{gtroff} processing
+@cindex text, GNU @code{troff} processing
 
-@code{gtroff} input files contain text with control commands
-interspersed throughout.  But, even without control codes, @code{gtroff}
-still does several things with the input text:
-
-@itemize @bullet
-@item
-filling and adjusting
-
-@item
-adding additional space after sentences
-
-@item
-hyphenating
-
-@item
-inserting implicit line breaks
-@end itemize
+@acronym{AT&T} @code{troff} was designed to take input as it would be
+composed on a typewriter, including the teletypewriters used as early
+computer terminals, and relieve the user drafting a document of concern
+with details like line length, hyphenation breaking, and the achievement
+of straight margins.  Early in its development, the program gained the
+ability to prepare output for a phototypesetter; a document could then
+be prepared for output to either a teletypewriter, a phototypesetter, or
+both.  GNU @code{troff} continues this tradition of permitting an author
+to compose a single master version of a document which can then be
+rendered for a variety of output formats or devices.
+
+@code{roff} input files contain text interspersed with instructions to
+control the formatter.  Even in the absence of such instructions, GNU
+@code{troff} still processes its input in several ways, by filling,
+hyphenating, breaking, and adjusting it, and supplementing it with
+inter-sentence space.
 
 @menu
-* Filling and Adjusting::
+* Filling::
 * Hyphenation::
 * Sentences::
-* Tab Stops::
-* Implicit Line Breaks::
-* Input Conventions::
+* Breaking::
+* Adjustment::
+* Tabs and Leaders::
+* Requests and Macros::
+* Macro Packages::
 * Input Encodings::
+* Input Conventions::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Filling and Adjusting, Hyphenation, Text, Text
-@subsection Filling and Adjusting
-@cindex filling
-@cindex adjusting
-
-When @code{gtroff} reads text, it collects words from the input and fits
-as many of them together on one output line as it can.  This is known as
-@dfn{filling}.
-
-@cindex leading spaces
-@cindex spaces, leading and trailing
-@cindex extra spaces
-@cindex trailing spaces
-Once @code{gtroff} has a @dfn{filled} line, it tries to @dfn{adjust} it.
-This means it widens the spacing between words until the text reaches
-the right margin (in the default adjustment mode).  Extra spaces between
-words are preserved, but spaces at the end of lines are ignored.  Spaces
-at the front of a line cause a @dfn{break} (breaks are explained in
-@ref{Implicit Line Breaks}).
+@node Filling, Sentences, Text, Text
+@subsection Filling
 
-@xref{Manipulating Filling and Adjusting}.
+When GNU @code{troff} starts up, it obtains information about the device
+for which it is preparing output.@footnote{@xref{Device and Font
+Description Files}.}  An essential property is the length of the output
+line, such as ``6.5 inches''.
 
-@c ---------------------------------------------------------------------
-
-@node Hyphenation, Sentences, Filling and Adjusting, Text
-@subsection Hyphenation
-@cindex hyphenation
-
-Since the odds are not great for finding a set of words, for every
-output line, which fit nicely on a line without inserting excessive
-amounts of space between words, @code{gtroff} hyphenates words so that
-it can justify lines without inserting too much space between words.  It
-uses an internal hyphenation algorithm (a simplified version of the
-algorithm used within @TeX{}) to indicate which words can be hyphenated
-and how to do so.  When a word is hyphenated, the first part of the word
-is added to the current filled line being output (with an attached
-hyphen), and the other portion is added to the next line to be filled.
-
-@xref{Manipulating Hyphenation}.
+@cindex word, definition of
+@cindex filling
+GNU @code{troff} interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can---this is known as @dfn{filling}.  To GNU
+@code{troff}, a @dfn{word} is any sequence of one or more characters
+that aren't spaces or newlines.  The exceptions separate
+words.@footnote{@slanted{Tabs} and @slanted{leaders} also separate
+words.  @slanted{Escape sequences} can function as word characters, word
+separators, or neither---the last simply have no effect on GNU
+@code{troff}'s idea of whether an input character is within a word.
+We'll discuss all of these in due course.}  To disable filling, see
+@ref{Manipulating Filling and Adjustment}.
+
+@Example
+It is a truth universally acknowledged
+that a single man in possession of a
+good fortune must be in want of a wife.
+    @result{} It is a truth universally acknowledged that a
+    @result{} single man in possession of a good fortune must
+    @result{} be in want of a wife.
+@endExample
 
 @c ---------------------------------------------------------------------
 
-@node Sentences, Tab Stops, Hyphenation, Text
+@node Sentences, Hyphenation, Filling, Text
 @subsection Sentences
 @cindex sentences
 
-Although it is often debated, some typesetting rules say there should be
-different amounts of space after various punctuation marks.  For
-example, the @cite{Chicago typesetting manual} says that a period at the
-end of a sentence should have twice as much space following it as would
-a comma or a period as part of an abbreviation.
+A passionate debate has raged for decades among writers of the English
+language over whether more space should appear between adjacent
+sentences than between words within a sentence, and if so, how much, and
+what other circumstances should influence this spacing.@footnote{A
+well-researched jeremiad appreciated by @code{groff} contributors on
+both sides of the sentence-spacing debate can be found at
+@uref{https://web.archive.org@//web@//20171217060354@//http://www.heracliteanriver.com@//?p=324}.}
+GNU @code{troff} follows the example of @acronym{AT&T} @code{troff};
+it attempts to detect the boundaries between sentences, and supplies
+additional inter-sentence space between them.
 
-@c XXX exact citation of Chicago manual
+@Example
+Hello, world!
+Welcome to groff.
+    @result{} Hello, world!  Welcome to groff.
+@endExample
 
+@cindex end-of-sentence characters
 @cindex sentence space
 @cindex space between sentences
-@cindex french-spacing
-@code{gtroff} does this by flagging certain characters (normally
-@samp{!}, @samp{?}, and @samp{.}) as @dfn{end-of-sentence} characters.
-When @code{gtroff} encounters one of these characters at the end of a
-line, it appends a normal space followed by a @dfn{sentence space} in
-the formatted output.  (This justifies one of the conventions mentioned
-in @ref{Input Conventions}.)
+@cindex French spacing
+GNU @code{troff} flags certain characters (normally @samp{!}, @samp{?},
+and @samp{.}) as potentially ending a sentence.  When GNU @code{troff}
+encounters one of these @dfn{end-of-sentence characters} at the end of
+an input line, or one of them is followed by two (unescaped) spaces on
+the same input line, it appends an inter-word space followed by an
+inter-sentence space in the output.
+
+@Example
+R. Harper subscribes to a maxim of P. T. Barnum.
+    @result{} R. Harper subscribes to a maxim of P. T. Barnum.
+@endExample
+
+In the above example, inter-sentence space is not added after @samp{P.}
+or @samp{T.} because the periods do not occur at the end of an input
+line, nor are they followed by two or more spaces.  Let's imagine that
+we've heard something about defamation from Mr.@: Harper's attorney,
+recast the sentence, and reflowed it in our text editor.
+
+@Example
+I submit that R. Harper subscribes to a maxim of P. T.
+Barnum.
+    @result{} I submit that R. Harper subscribes to a maxim of
+    @result{} P. T.  Barnum.
+@endExample
+
+``Barnum'' doesn't begin a sentence!  What to do?  Let us meet our first
+@dfn{escape sequence}, a series of input characters that give
+instructions to GNU @code{troff} instead of being used to construct
+output device glyphs.@footnote{This statement oversimplifies; there are
+escape sequences whose purpose is precisely to produce glyphs on the
+output device, and input characters that @emph{aren't} part of escape
+sequences can undergo a great deal of processing before getting to the
+output.} An escape sequence begins with the backslash character @code{\}
+by default, an uncommon character in natural language text, and is
+@emph{always} followed by at least one other character, hence the term
+``sequence''.
 
-@cindex transparent characters
-@cindex character, transparent
+@cindex @code{\&}, at end of sentence
+The dummy character escape sequence @code{\&} can be used after an
+end-of-sentence character to defeat end-of-sentence detection on a
+per-instance basis.  We can therefore rewrite our input more
+defensively.
+
+@Example
+I submit that R.\& Harper subscribes to a maxim of P.\&
+T.\& Barnum.
+    @result{} I submit that R. Harper subscribes to a maxim of
+    @result{} P. T. Barnum.
+@endExample
+
+Adding text caused our input to wrap; now, we don't need @code{\&} after
+@samp{T.} but we do after @samp{P.}.  Consistent use of the escape
+sequence ensures that potential sentence boundaries are robust to
+editing activities.  Further advice along these lines will follow in
+@ref{Input Conventions}.
+
+@cindex end-of-sentence transparent characters
+@cindex characters, end-of-sentence transparent
 @cindex @code{dg} glyph, at end of sentence
+@cindex @code{dd} glyph, at end of sentence
 @cindex @code{rq} glyph, at end of sentence
 @cindex @code{cq} glyph, at end of sentence
 @cindex @code{"}, at end of sentence
@@ -4840,405 +5099,1071 @@
 @cindex @code{)}, at end of sentence
 @cindex @code{}, at end of sentence
 @cindex @code{*}, at end of sentence
-In addition, the following characters and symbols are treated
-transparently while handling end-of-sentence characters: @samp{"},
-@samp{'}, @samp{)}, @samp{}, @samp{*}, @code{\dg}, @code{\rq}, and
-@code{\cq}.
-
-See the @code{cflags} request in @ref{Using Symbols}, for more details.
+@cindex special characters
+@cindex characters, special
+Normally, the occurrence of a visible non-end-of-sentence character (as
+opposed to a space or tab) immediately after an end-of-sentence
+character cancels detection of the end of a sentence.  For example, it
+would be incorrect for GNU @code{troff} to infer the end of a sentence
+after the dot in @samp{3.14159}.  However, several characters are
+treated @emph{transparently} after the occurrence of an end-of-sentence
+character.  That is, GNU @code{troff} does not cancel end-of-sentence
+detection when it processes them.  This is because such characters are
+often used as footnote markers or to close quotations and
+parentheticals.  The default set is @samp{"}, @samp{'}, @samp{)},
+@samp{}, @samp{*}, @code{\dg}, @code{\dd}, @code{\rq}, and
+@code{\cq}.  The last four are examples of @dfn{special characters},
+escape sequences whose purpose is to obtain glyphs that are not easily
+typed at the keyboard, or which have special meaning to GNU @code{troff}
+(like @code{\} itself).@footnote{The mnemonics for the special
+characters shown here are ``dagger'', ``double dagger'', ``right
+(double) quote'', and ``closing (single) quote''.  See the
+@cite{groff_char@r{(7)}} man page.}
+
+@Example
+\lqThe idea that the poor should have leisure has always
+been shocking to the rich.\rq
+(Bertrand Russell, 1935)
+@c XXX: @iftex puts a blank line on the output.  This seems like a bug.
+@c @newline works around it.  But we need a weird inverse indent.
+@iftex @
+  @result{} @quotedblleft{}The idea that the poor should have
+    @result{} leisure has always been shocking to
+    @result{} the rich.@quotedblright{}  (Bertrand Russell, 1935)
+@end iftex
+@ifnottex
+    @result{} "The idea that the poor should have
+    @result{} leisure has always been shocking to
+    @result{} the rich."  (Bertrand Russell, 1935)
+@end ifnottex
+@endExample
 
-@cindex @code{\&}, at end of sentence
-To prevent the insertion of extra space after an end-of-sentence
-character (at the end of a line), append @code{\&}.
+The sets of characters that potentially end sentences or are transparent
+to sentence endings are configurable.  See the @code{cflags} request in
+@ref{Using Symbols}.  To change the additional inter-sentence space
+amount---even to remove it entirely---see @ref{Manipulating Filling and
+Adjustment}.
 
 @c ---------------------------------------------------------------------
 
-@node Tab Stops, Implicit Line Breaks, Sentences, Text
-@subsection Tab Stops
-@cindex tab stops
-@cindex stops, tabulator
-@cindex tab character
-@cindex character, tabulator
-
-@cindex @acronym{EBCDIC} encoding
-@cindex encoding, @acronym{EBCDIC}
-@code{gtroff} translates @dfn{tabulator characters}, also called
-@dfn{tabs} (normally code point @acronym{ASCII} @code{0x09} or
-@acronym{EBCDIC} @code{0x05}), in the input into movements to the next
-tabulator stop.  These tab stops are initially located every half inch
-across the page.  Using this, simple tables can be made easily.
-However, it can often be deceptive as the appearance (and width) of the
-text on a terminal and the results from @code{gtroff} can vary greatly.
-
-Also, a possible sticking point is that lines beginning with tab
-characters are still filled, again producing unexpected results.  For
-example, the following input
-
-@multitable {12345678} {12345678} {12345678} {12345678}
-@item
-@tab 1 @tab 2 @tab 3
-@item
-@tab   @tab 4 @tab 5
-@end multitable
-
-@noindent
-produces
-
-@multitable {12345678} {12345678} {12345678} {12345678} {12345678} {12345678} {12345678}
-@item
-@tab 1 @tab 2 @tab 3 @tab   @tab 4 @tab 5
-@end multitable
+@node Hyphenation, Breaking, Sentences, Text
+@subsection Hyphenation
+@cindex hyphenation
 
-@xref{Tabs and Fields}.
+When an output line is nearly full, it is uncommon for the next word
+collected from the input to exactly fill it---typically, there is room
+left over only for part of the next word.  The process of splitting a
+word so that it appears partially on one line (with a hyphen to indicate
+to the reader that the word has been broken) with its remainder on the
+next is @dfn{hyphenation}.  Hyphenation points can be manually
+specified; GNU @code{troff} also uses a hyphenation algorithm and
+language-specific pattern files (based on those used in @TeX{}) to
+decide which words can be hyphenated and where.
+
+Hyphenation does not always occur even when the hyphenation rules for a
+word allow it; it can be disabled, and when not disabled there are
+several parameters that can prevent it in certain circumstances.
+@xref{Manipulating Hyphenation}.
 
 @c ---------------------------------------------------------------------
 
-@node Implicit Line Breaks, Input Conventions, Tab Stops, Text
-@subsection Implicit Line Breaks
-@cindex implicit line breaks
-@cindex implicit breaks of lines
-@cindex line, implicit breaks
-@cindex break, implicit
-@cindex line break
-
-An important concept in @code{gtroff} is the @dfn{break}.  When a break
-occurs, @code{gtroff} outputs the partially filled line (unjustified),
-and resumes collecting and filling text on the next output line.
+@node Breaking, Adjustment, Hyphenation, Text
+@subsection Breaking
+@cindex break
+@cindex implicit line break
+@cindex line break, output
+@cindex output line break
+
+Once an output line is full, the next word (or remainder of a hyphenated
+one) is placed on a different output line; this is called a @dfn{break}.
+In this manual and in @code{roff} discussions generally, a ``break'' if
+not further qualified always refers to the termination of an output
+line.  When the formatter is filling text, it introduces breaks
+automatically to keep output lines from exceeding the configured line
+length.  After an automatic break, GNU @code{troff} adjusts the line if
+applicable (see below), and then resumes collecting and filling text on
+the next output line.
+
+Sometimes, a line cannot be broken automatically.  This usually does
+not happen with natural language text unless the output line length has
+been manipulated to be extremely short, but it can with specialized
+text like program source code.  We can use @code{perl} at the shell
+prompt to contrive an example of failure to break the line.  We also
+employ the @option{-z} option to suppress normal output.
+
+@Example
+$ perl -e 'print "#" x 80, "\n";' | nroff -z
+    @error{} warning: cannot break line
+@endExample
+
+The remedy for these cases is to tell GNU @code{troff} where the line
+may be broken without hyphens.  This is done with the non-printing break
+point escape sequence @samp{\:}; see @ref{Manipulating Hyphenation}.
 
 @cindex blank line
 @cindex empty line
 @cindex line, blank
 @cindex blank line macro (@code{blm})
-There are several ways to cause a break in @code{gtroff}.  A blank line
-not only causes a break, but it also outputs a one-line vertical space
-(effectively a blank line).  Note that this behaviour can be modified
-with the blank line macro request @code{blm}.  @xref{Blank Line Traps}.
+What if the document author wants to stop filling lines temporarily, for
+instance to start a new paragraph?  There are several solutions.  A
+blank input line not only causes a break, but by default it also outputs
+a one-line vertical space (effectively a blank output line).  This
+behavior can be modified; see @ref{Blank Line Traps}.  Macro packages
+may discourage or disable the blank line method of paragraphing in favor
+of their own macros.
 
-@cindex fill mode
-@cindex mode, fill
-@cindex leading spaces macro (@code{lsm})
-A line that begins with a space causes a break and the space is output
-at the beginning of the next line.  Note that this space isn't adjusted,
-even in fill mode; however, the behaviour can be modified with the
-leading spaces macro request @code{lsm}.  @xref{Leading Spaces Traps}.
+@cindex leading spaces
+@cindex spaces, leading and trailing
+@cindex trailing spaces on text lines
+@cindex leading space macro (@code{lsm})
+A line that begins with one or more spaces causes a break.  The spaces
+are output at the beginning of the next line without being
+@emph{adjusted} (see below); however, this behavior can be modified
+(@pxref{Leading Space Traps}).  Again, macro packages may provide other
+methods of producing indented paragraphs.  Trailing spaces on text lines
+are discarded.@footnote{``Text lines'' are defined in @ref{Requests and
+Macros}.}
+
+What if the file ends before enough words have been collected to fill an
+output line?  Or the output line is exactly full but not yet broken, and
+there is no more input?  GNU @code{troff} interprets the end of input as
+a break.  Certain requests also cause breaks, implicitly or explicitly.
+This is discussed in @ref{Manipulating Filling and Adjustment}.
 
-The end of file also causes a break -- otherwise the last line of the
-document may vanish!
+@c ---------------------------------------------------------------------
 
-Certain requests also cause breaks, implicitly or explicitly.  This is
-discussed in @ref{Manipulating Filling and Adjusting}.
+@node Adjustment, Tabs and Leaders, Breaking, Text
+@subsection Adjustment
+
+@cindex extra spaces between words
+After GNU @code{troff} performs an automatic break, it may then
+@dfn{adjust} the line, widening inter-word spaces until the text reaches
+the right margin.  Extra spaces between words are preserved.  Leading
+and trailing spaces are handled as noted above.  Text can be aligned to
+the left or right margin only, or centered; see @ref{Manipulating
+Filling and Adjustment}.
+@c END Keep roughly parallel with roff(7) section "Concepts".
 
 @c ---------------------------------------------------------------------
 
-@node Input Conventions, Input Encodings, Implicit Line Breaks, Text
-@subsection Input Conventions
-@cindex input conventions
-@cindex conventions for input
+@node Tabs and Leaders, Input Conventions, Adjustment, Text
+@subsection Tabs and Leaders
 
-Since @code{gtroff} does filling automatically, it is traditional in
-@code{groff} not to try and type things in as nicely formatted
-paragraphs.  These are some conventions commonly used when typing
-@code{gtroff} text:
+@cindex horizontal tab character
+@cindex tab character
+@cindex character, horizontal tab
+@cindex leader character
+@cindex character, leader
+@cindex tab stops
+@cindex stops, tab
+GNU @code{troff} translates input horizontal tab characters (``tabs'')
+and @key{Control+A} characters (``leaders'') into movements to the next
+tab stop.  Tabs simply move to the next tab stop; leaders place enough
+periods to fill the space.  Tab stops are by default located every half
+inch measured from the drawing position corresponding to the beginning
+of the input line; see @ref{Page Geometry}.   Tabs and leaders do not
+cause breaks and therefore do not interrupt filling.  Below, we use
+arrows @arrow{} and bullets @bullet{} to indicate input tabs and
+leaders, respectively.
+
+@Example
+1
+@arrow{} 2 @arrow{} 3 @bullet{} 4
+@arrow{} @bullet{} 5
+@result{} 1         2       3.......4         ........5
+@endExample
+
+Tabs and leaders lend themselves to table construction.@footnote{``Tab''
+is short for ``tabulation'', revealing the term's origin as a spacing
+mechanism for table arrangement.} The tab and leader glyphs can be
+configured, and further facilities for sophisticated table composition
+are available; see @ref{Tabs and Fields}.  There are many details to
+track when using such low-level features, so most users turn to the
+@cite{tbl@r{(1)}} preprocessor to lay out tables.
 
-@itemize @bullet
-@item
-Break lines after punctuation, particularly at the end of a sentence and
-in other logical places.  Keep separate phrases on lines by themselves,
-as entire phrases are often added or deleted when editing.
+@c ---------------------------------------------------------------------
 
-@item
-Try to keep lines less than 40--60@tie{}characters, to allow space for
-inserting more text.
+@node Requests and Macros, Macro Packages, Tabs and Leaders, Text
+@subsection Requests and Macros
+
+We have now encountered almost all of the syntax there is in the
+@code{roff} language, with an exception already noted in passing.
+@cindex request
+@cindex control character (@code{.})
+@cindex character, control (@code{.})
+@cindex no-break control character (@code{'})
+@cindex character, no-break control (@code{'})
+@cindex control character, no-break (@code{'})
+A @dfn{request} is an instruction to the formatter that occurs after a
+@dfn{control character}, which is recognized at the beginning of an
+input line.  The regular control character is a dot (@code{.}).  Its
+counterpart, the @dfn{no-break control character}, a neutral apostrophe
+(@code{'}), suppresses the break that is implied by some requests.
+These characters were chosen because it is uncommon for lines of text in
+natural languages to begin with them.
+@cindex dummy character (@code{\&}), as control character suppressor
+@cindex character, dummy (@code{\&}), as control character suppressor
+If you require a formatted period or apostrophe (closing single
+quotation mark) where GNU @code{troff} is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence, @samp{\&}.
+
+@cindex control line
+An input line beginning with a control character is called a
+@dfn{control line}.
+@cindex text line
+Every line of input that is not a control line is a @dfn{text
+line}.@footnote{The @code{\@key{RET}} escape sequence can alter how an
+input line is classified; see @ref{Line Continuation}.}
+
+@cindex argument
+Requests often take @dfn{arguments}, words (separated from the request
+name and each other by spaces) that specify details of the action GNU
+@code{troff} is expected to perform.  If a request is meaningless
+without arguments, it is typically ignored.
+
+GNU @code{troff}'s requests and escape sequences comprise the control
+language of the formatter.  Of key importance are the requests that
+define macros.  Macros are invoked like requests, enabling the request
+repertoire to be extended or overridden.@footnote{Argument handling in
+macros is more flexible but also more complex.  @xref{Calling Macros}.}
+
+@cindex macro
+@cindex calling a macro
+@cindex interpolation
+A @dfn{macro} can be thought of as an abbreviation you can define for a
+collection of control and text lines.  When the macro is @dfn{called} by
+giving its name after a control character, it is replaced with what it
+stands for.  The process of textual replacement is known as
+@dfn{interpolation}.@footnote{Some escape sequences undergo
+interpolation as well.}  Interpolations are handled as soon as they are
+recognized, and once performed, a @code{roff} formatter scans the
+replacement for further requests, macro calls, and escape sequences.
+
+In @code{roff} systems, the @code{de} request defines a
+macro.@footnote{GNU @code{troff} offers additional ones.  @xref{Writing
+Macros}.}
 
-@item
-Do not try to do any formatting in a @acronym{WYSIWYG} manner (i.e.,
-don't try using spaces to get proper indentation).
-@end itemize
+@Example
+.de DATE
+2020-11-14
+..
+@endExample
 
-@c ---------------------------------------------------------------------
+@noindent
+The foregoing input produces no output by itself; all we have done is
+store some information.  Observe the pair of dots that ends the macro
+definition.  This is a default; you can specify your own terminator for
+the macro definition as the second argument to the @code{de} request.
+
+@Example
+.de NAME ENDNAME
+Heywood Jabuzzoff
+.ENDNAME
+@endExample
+
+In fact, the ending marker is itself the name of a macro to be
+called, or a request to be invoked, if it is defined at the time its
+control line is read.
+
+@Example
+.de END
+Big Rip
+..
+.de START END
+Big Bang
+.END
+.START
+    @result{} Big Rip Big Bang
+@endExample
+
+@noindent
+In the foregoing example, ``Big Rip'' printed before ``Big Bang''
+because its macro was @emph{called} first.  Consider what would happen
+if we dropped @code{END} from the @samp{.de START} line and added
+@code{..} after @code{.END}.  Would the order change?
+
+Let us consider a more elaborate example.
+
+@Example
+.de DATE
+2020-10-05
+..
+.
+.de BOSS
+D.\& Kruger,
+J.\& Peterman
+..
+.
+.de NOTICE
+Approved:
+.DATE
+by
+.BOSS
+..
+.
+Insert tedious regulatory compliance paragraph here.
+
+.NOTICE
 
-@node Input Encodings,  , Input Conventions, Text
+Insert tedious liability disclaimer paragraph here.
+
+.NOTICE
+    @result{} Insert tedious regulatory compliance paragraph here.
+    @result{}
+    @result{} Approved: 2020-10-05 by D. Kruger, J. Peterman
+    @result{}
+    @result{} Insert tedious liability disclaimer paragraph here.
+    @result{}
+    @result{} Approved: 2020-10-05 by D. Kruger, J. Peterman
+@endExample
+
+@noindent
+The above document started with a series of control lines.  Three macros
+were defined, with a @code{de} request declaring each macro's name, and
+the ``body'' of the macro starting on the next line and continuing until
+a line with two dots @samp{@code{..}} marked its end.  The text proper
+began only after the macros were defined; this is a common pattern.
+Only the @code{NOTICE} macro was called ``directly'' by the document;
+@code{DATE} and @code{BOSS} were called only by @code{NOTICE} itself.
+Escape sequences were used in @code{BOSS}, two levels of macro
+interpolation deep.
+
+The advantage in typing and maintenance economy may not be obvious from
+such a short example, but imagine a much longer document with dozens of
+such paragraphs, each requiring a notice of managerial approval.
+Consider what must happen if you are in charge of generating a new
+version of such a document with a different date, for a different boss.
+With well-chosen macros, you only have to change each datum in one
+place.
+
+In practice, we would probably use strings (@pxref{Strings}) instead of
+macros for such simple interpolations; what is important here is to
+glimpse the potential of macros and the power of recursive
+interpolation.
+
+We could have defined @code{DATE} and @code{BOSS} in the opposite order;
+perhaps less obviously, we could also have defined them @emph{after}
+@code{NOTICE}.  ``Forward references'' like this are acceptable because
+the body of a macro definition is not (completely) interpreted, but
+stored instead (@pxref{Copy Mode}).  While a macro is being defined (or
+appended to), requests are not interpreted and macros not interpolated,
+whereas some commonly used escape sequences @emph{are} interpreted.
+@code{roff} systems also support recursive macro calls, as long as you
+have a way to break the recursion (@pxref{Conditionals and Loops}).
+Maintainable @code{roff} documents tend to arrange macro definitions to
+minimize forward references.
+
+@c ---------------------------------------------------------------------
+
+@node Macro Packages, Input Encodings, Requests and Macros, Text
+@subsection Macro Packages
+@cindex macro package
+@cindex package, macro
+
+@c TODO: Consider parallelizing with groff_tmac(5) "Description".
+Macro definitions can be collected into @dfn{macro files}, @code{roff}
+input files designed to produce no output themselves but instead ease
+the preparation of other @code{roff} documents.  There is no syntactical
+difference between a macro file and any other @code{roff} document; only
+its purpose distinguishes it.  When a macro file is installed at a
+standard location and suitable for use by a general audience, it is
+often termed a @dfn{macro package}.@footnote{Macro files and packages
+frequently define registers and strings as well.}  Macro packages can be
+loaded by supplying the @option{-m} option to GNU @command{troff} or a
+@code{groff} front end.  Alternatively, a document requiring a macro
+package can load it with the @code{mso} (``macro source'') request.
+
+@c ---------------------------------------------------------------------
+
+@c TODO: Move a lot of this node to the "Invoking groff" chapter.  Some
+@c of the discussion is better placed in discussion of output drivers
+@c (e.g., what character encodings _they_ support for output and their
+@c responsibility for converting to them) as well.
+
+@node Input Encodings, Input Conventions, Macro Packages, Text
 @subsection Input Encodings
 
-Currently, the following input encodings are available.
+The @command{groff} command's @option{-k} option calls the
+@command{preconv} preprocessor to perform input character encoding
+conversions.  Input to the GNU @code{troff} formatter itself, on the
+other hand, must be in one of two encodings it can recognize.
 
-@table @asis
+@table @code
 @item cp1047
 @cindex encoding, input, @acronym{EBCDIC}
 @cindex @acronym{EBCDIC}, input encoding
 @cindex input encoding, @acronym{EBCDIC}
-@cindex encoding, input, cp1047
-@cindex cp1047, input encoding
-@cindex input encoding, cp1047
-@cindex IBM cp1047 input encoding
+@cindex encoding, input, code page 1047
+@cindex code page 1047, input encoding
+@cindex input encoding, code page 1047
+@cindex IBM code page 1047 input encoding
 @pindex cp1047.tmac
-This input encoding works only on @acronym{EBCDIC} platforms (and vice
-versa, the other input encodings don't work with @acronym{EBCDIC}); the
-file @file{cp1047.tmac} is by default loaded at start-up.
-
-@item latin-1
-@cindex encoding, input, @w{latin-1} (ISO @w{8859-1})
-@cindex @w{latin-1} (ISO @w{8859-1}), input encoding
-@cindex ISO @w{8859-1} (@w{latin-1}), input encoding
-@cindex input encoding, @w{latin-1} (ISO @w{8859-1})
+The code page 1047 input encoding works only on @acronym{EBCDIC}
+platforms (and conversely, the other input encodings don't work with
+@acronym{EBCDIC}); the file @file{cp1047.tmac} is loaded at startup.
+
+@item latin1
+@cindex encoding, input, @w{Latin-1} (ISO @w{8859-1})
+@cindex @w{Latin-1} (ISO @w{8859-1}), input encoding
+@cindex ISO @w{8859-1} (@w{Latin-1}), input encoding
+@cindex input encoding, @w{Latin-1} (ISO @w{8859-1})
 @pindex latin1.tmac
-This is the default input encoding on non-@acronym{EBCDIC} platforms;
-the file @file{latin1.tmac} is loaded at start-up.
+ISO @w{Latin-1}, an encoding for Western European languages, is the
+default input encoding on non-@acronym{EBCDIC} platforms; the file
+@file{latin1.tmac} is loaded at startup.
+@end table
 
-@item latin-2
-@cindex encoding, input, @w{latin-2} (ISO @w{8859-2})
-@cindex @w{latin-2} (ISO @w{8859-2}), input encoding
-@cindex ISO @w{8859-2} (@w{latin-2}), input encoding
-@cindex input encoding, @w{latin-2} (ISO @w{8859-2})
+@noindent
+Any document that is encoded in ISO 646:1991 (a descendant of USAS
+@w{X3.4-1968} or ``US-ASCII''), or, equivalently, uses only code points
+from the ``C0 Controls'' and ``Basic Latin'' parts of the Unicode
+character set is also a valid ISO @w{Latin-1} document; the standards
+are interchangeable in their first 128 code points.@footnote{The
+@emph{semantics} of certain punctuation code points have gotten stricter
+with the successive standards, a cause of some frustration among man
+page writers; see the @cite{groff_char@r{(7)}} man page.}
+
+Other encodings are supported by means of macro packages.
+
+@table @code
+@item latin2
+@cindex encoding, input, @w{Latin-2} (ISO @w{8859-2})
+@cindex @w{Latin-2} (ISO @w{8859-2}), input encoding
+@cindex ISO @w{8859-2} (@w{Latin-2}), input encoding
+@cindex input encoding, @w{Latin-2} (ISO @w{8859-2})
 @pindex latin2.tmac
-To use this encoding, either say @w{@samp{.mso latin2.tmac}} at the very
-beginning of your document or use @samp{-mlatin2} as a command-line
-argument for @code{groff}.
-
-@item latin-5
-@cindex encoding, input, @w{latin-5} (ISO @w{8859-9})
-@cindex @w{latin-5} (ISO @w{8859-9}), input encoding
-@cindex ISO @w{8859-9} (@w{latin-5}), input encoding
-@cindex input encoding, @w{latin-5} (ISO @w{8859-9})
+To use ISO @w{Latin-2}, an encoding for Central and Eastern European
+languages, invoke @w{@samp{.mso latin2.tmac}} at the beginning of your
+document or supply @samp{-mlatin2} as a command-line argument to
+@code{groff}.
+
+@item latin5
+@cindex encoding, input, @w{Latin-5} (ISO @w{8859-9})
+@cindex @w{Latin-5} (ISO @w{8859-9}), input encoding
+@cindex ISO @w{8859-9} (@w{Latin-5}), input encoding
+@cindex input encoding, @w{Latin-5} (ISO @w{8859-9})
 @pindex latin5.tmac
-For Turkish.  Either say @w{@samp{.mso latin5.tmac}} at the very
-beginning of your document or use @samp{-mlatin5} as a command-line
-argument for @code{groff}.
-
-@item latin-9 (latin-0)
-@cindex encoding, input, @w{latin-9} (@w{latin-0}, ISO @w{8859-15})
-@cindex @w{latin-9} (@w{latin-0}, ISO @w{8859-15}), input encoding
-@cindex ISO @w{8859-15} (@w{latin-9}, @w{latin-0}), input encoding
-@cindex input encoding, @w{latin-9} (@w{latin-9}, ISO @w{8859-15})
+To use ISO @w{Latin-5}, an encoding for the Turkish language, invoke
+@w{@samp{.mso latin5.tmac}} at the beginning of your document or
+supply @samp{-mlatin5} as a command-line argument to @code{groff}.
+
+@item latin9
+@cindex encoding, input, @w{Latin-9} (ISO @w{8859-15})
+@cindex @w{Latin-9} (ISO @w{8859-15}), input encoding
+@cindex ISO @w{8859-15} (@w{Latin-9}), input encoding
+@cindex input encoding, @w{Latin-9} (ISO @w{8859-15})
 @pindex latin9.tmac
-This encoding is intended (at least in Europe) to replace @w{latin-1}
-encoding.  The main difference to @w{latin-1} is that @w{latin-9}
-contains the Euro character.  To use this encoding, either say
-@w{@samp{.mso latin9.tmac}} at the very beginning of your document or
-use @samp{-mlatin9} as a command-line argument for @code{groff}.
+ISO @w{Latin-9} succeeds @w{Latin-1}; it includes a Euro sign and better
+glyph coverage for French.  To use this encoding, invoke @w{@samp{.mso
+latin9.tmac}} at the beginning of your document or supply
+@samp{-mlatin9} as a command-line argument to @code{groff}.
 @end table
 
-Note that it can happen that some input encoding characters are not
-available for a particular output device.  For example, saying
-
-@Example
-groff -Tlatin1 -mlatin9 ...
-@endExample
-
-@noindent
-fails if you use the Euro character in the input.  Usually, this
-limitation is present only for devices that have a limited set of
-output glyphs (e.g.@: @option{-Tascii} and @option{-Tlatin1}); for other
-devices it is usually sufficient to install proper fonts that contain
-the necessary glyphs.
+Some characters from an input encoding may not be available with a
+particular output driver, or their glyphs may not have representation in
+the font used.  For terminal devices, fallbacks are defined, like
+@samp{EUR} for the Euro sign and @samp{(C)} for the copyright sign.  For
+typesetter devices, you may need to ``mount'' fonts that support glyphs
+required by the document.  @xref{Font Positions}.
 
 @pindex freeeuro.pfa
 @pindex ec.tmac
-Due to the importance of the Euro glyph in Europe, the groff package now
-comes with a @sc{PostScript} font called @file{freeeuro.pfa}, which
-provides various glyph shapes for the Euro.  In other words,
-@w{latin-9} encoding is supported for the @option{-Tps} device out of
-the box (@w{latin-2} isn't).
+Because a Euro glyph was not historically defined in PostScript fonts,
+@code{groff} comes with a font called @file{freeeuro.pfa} that provides
+the Euro in several styles.  Standard PostScript fonts contain the
+glyphs from @w{Latin-5} and @w{Latin-9} that @w{Latin-1} lacks, so these
+encodings are supported for the @option{ps} and @option{pdf} output
+devices as @code{groff} ships, while @w{Latin-2} is not.
+
+Unicode supports characters from all other input encodings; the
+@option{utf8} output driver for terminals therefore does as well.  The
+DVI output driver supports the @w{Latin-2} and @w{Latin-9} encodings if
+the command-line option @option{-mec} is used as well.  @footnote{The
+DVI output device defaults to using the Computer Modern (CM) fonts;
+@file{ec.tmac} loads the EC fonts instead, which provide Euro
+@samp{\Eu} and per mille @samp{\%0} glyphs.}
+
+@c ---------------------------------------------------------------------
+
+@node Input Conventions, , Input Encodings, Text
+@subsection Input Conventions
+@cindex input conventions
+@cindex conventions for input
 
-By its very nature, @option{-Tutf8} supports all input encodings;
-@option{-Tdvi} has support for both @w{latin-2} and @w{latin-9} if the
-command-line @option{-mec} is used also to load the file @file{ec.tmac}
-(which flips to the EC fonts).
+Since GNU @code{troff} fills text automatically, it is common practice
+in the @code{roff} language to avoid visual composition of text in input
+files: the esthetic appeal of the formatted output is what matters.
+Therefore, @code{roff} input should be arranged such that it is easy for
+authors and maintainers to compose and develop the document, understand
+the syntax of @code{roff} requests, macro calls, and preprocessor
+languages used, and predict the behavior of the formatter.  Several
+traditions have accrued in service of these goals.
+
+@itemize @bullet
+@item
+Follow sentence endings in the input with newlines to ease their
+recognition (@pxref{Sentences}).  It is frequently convenient to end
+text lines after colons and semicolons as well, as these typically
+precede independent clauses.  Consider doing so after commas; they often
+occur in lists that become easy to scan when itemized by line, or
+constitute supplements to the sentence that are added, deleted, or
+updated to clarify it.  Parenthetical and quoted phrases are also good
+candidates for placement on text lines by themselves.
+
+@item
+Set your text editor's line length to 72 characters or
+fewer.@footnote{Emacs: @code{fill-column: 72}; Vim: @code{textwidth=72}}
+This limit, combined with the previous item of advice, makes it less
+common that an input line will wrap in your text editor, and thus will
+help you perceive excessively long constructions in your text.  Recall
+that natural languages originate in speech, not writing, and that
+punctuation is correlated with pauses for breathing and changes in
+prosody.
+
+@item
+Use @code{\&} after @samp{!}, @samp{?}, and @samp{.} if they are
+followed by space, tab, or newline characters and don't end a sentence.
+
+@item
+In filled text lines, use @code{\&} before @samp{.} and @samp{'} if they
+are preceded by space, so that reflowing the input doesn't turn them
+into control lines.
+
+@item
+Do not use spaces to perform indentation or align columns of a table.
+Leading spaces are reliable when text is not being filled.
+
+@item
+Comment your document.  It is never too soon to apply comments to
+record information of use to future document maintainers (including your
+future self).  We thus introduce another escape sequence, @code{\"},
+which causes GNU @code{troff} to ignore the remainder of the input line.
+
+@item
+Use the empty request---a control character followed immediately by a
+newline---to visually manage separation of material in input files.
+Many of the @code{groff} project's own documents use an empty request
+between sentences, after macro definitions, and where a break is
+expected, and two empty requests between paragraphs or other requests or
+macro calls that will introduce vertical space into the document.
+
+You can combine the empty request with the comment escape sequence to
+include whole-line comments in your document, and even ``comment out''
+sections of it.
+@end itemize
+
+We conclude this section with an example sufficiently long to illustrate
+most of the above suggestions in practice.  For the purpose of fitting
+the example between the margins of this manual with the font used for
+its typeset version, we have shortened the input line length to 56
+columns.  As before, an arrow @arrow{} indicates a tab character.
+
+@c Wrap example at 56 columns (not counting @arrow{}).
+@CartoucheExample
+.\"   nroff this_file.roff | less
+.\"   groff -T ps this_file.roff > this_file.ps
+@arrow{}The theory of relativity is intimately connected with
+the theory of space and time.
+.
+I shall therefore begin with a brief investigation of
+the origin of our ideas of space and time,
+although in doing so I know that I introduce a
+controversial subject.  \" remainder of paragraph elided
+.
+.
+
+@arrow{}The experiences of an individual appear to us arranged
+in a series of events;
+in this series the single events which we remember
+appear to be ordered according to the criterion of
+\lqearlier\rq and \lqlater\rq, \" punct swapped
+which cannot be analysed further.
+.
+There exists,
+therefore,
+for the individual,
+an I-time,
+or subjective time.
+.
+This itself is not measurable.
+.
+I can,
+indeed,
+associate numbers with the events,
+in such a way that the greater number is associated with
+the later event than with an earlier one;
+but the nature of this association may be quite
+arbitrary.
+.
+This association I can define by means of a clock by
+comparing the order of events furnished by the clock
+with the order of a given series of events.
+.
+We understand by a clock something which provides a
+series of events which can be counted,
+and which has other properties of which we shall speak
+later.
+.\" Albert Einstein, _The Meaning of Relativity_, 1922
+@endCartoucheExample
+
+@node Page Geometry, Measurements, Text, GNU troff Reference
+@section Page Geometry
+@cindex page, geometry of
+@cindex geometry, page
+
+@code{roff} systems format text under certain assumptions about the size
+of the output medium, or page.  For the formatter to correctly break a
+line it is filling, it must know the line length, which it derives from
+the page width (@pxref{Line Layout}).  For it to decide whether to write
+an output line to the current page or wait until the next one, it must
+know the page length (@pxref{Page Layout}).
+
+@cindex device resolution
+@cindex resolution, device
+@cindex basic units
+@cindex units, basic
+@cindex machine units
+@cindex units, machine
+A device's @dfn{resolution} converts practical units like inches or
+centimeters to @dfn{basic units}, a convenient length measure for the
+output device or file format.  The formatter and output driver use basic
+units to reckon page measurements.  The device description file defines
+its resolution and page dimensions (@pxref{DESC File Format}).
+
+@cindex page
+A @dfn{page} is a two-dimensional structure upon which a @code{roff}
+system imposes a rectangular coordinate system with its upper left
+corner as the origin.  Coordinate values are in basic units and increase
+down and to the right.  Useful ones are therefore always positive and
+within numeric ranges corresponding to the page boundaries.
+
+@cindex drawing position
+@cindex position, drawing
+While the formatter (and, later, output driver) is processing a page, it
+keeps track of its @dfn{drawing position}, which is the location at
+which the next glyph will be written, from which the next motion will be
+measured, or where a geometric object will commence rendering.
+@cindex text baseline
+@cindex baseline, text
+Notionally, glyphs are drawn from the text baseline upward and to the
+right.@footnote{@code{groff} does not yet support right-to-left
+scripts.}  The @dfn{text baseline} is a (usually invisible) line upon
+which the glyphs of a typeface are aligned.  A glyph therefore
+``starts'' at its bottom-left corner.  If drawn at the origin, a typical
+letter glyph would lie partially or wholly off the page, depending on
+whether, like ``g'', it features a descender below the baseline.
+
+@cindex page offset
+@cindex offset, page
+Such a situation is nearly always undesirable.  It is furthermore
+conventional not to write or draw at the extreme edges of the page.
+Therefore the initial drawing position of a @code{roff} formatter is not
+at the origin, but below and to the right of it.  This rightward shift
+from the left edge is known as the @dfn{page
+offset}.@footnote{@code{groff}'s terminal output devices have page
+offsets of zero.}  The downward shift leaves room for a text output
+line.
+
+Text is arranged on a one-dimensional lattice of text baselines from the
+top to the bottom of the page.
+@cindex vertical spacing
+@cindex spacing, vertical
+@cindex vee
+@dfn{Vertical spacing} is the distance between adjacent text baselines.
+Typographic tradition sets this quantity to 120% of the type size.  The
+initial drawing position is one unit of vertical spacing below the page
+top.  Typographers term this unit a @slanted{vee}.
+
+@cindex page break
+@cindex break, page
+@cindex page ejection
+@cindex ejection, page
+Vertical spacing has an impact on page-breaking decisions.  Generally,
+when a break occurs, the formatter moves the drawing position to the
+next text baseline automatically.  If the formatter were already writing
+to the last line that would fit on the page, advancing by one vee would
+place the next text baseline off the page.  Rather than let that happen,
+@code{roff} formatters instruct the output driver to eject the page,
+start a new one, and again set the drawing position to one vee below the
+page top; this is a @dfn{page break}.
+
+When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one.  Macro packages keep
+users from having to confront this difficulty by setting ``traps''
+(@pxref{Traps}); moreover, all but the simplest page layouts tend to
+have headers and footers, or at least bear vertical margins larger than
+one vee.
 
 
 @c =====================================================================
+@c TODO: Add a section here about interpolations and input processing.
+@c
+@c We need to level up the reader's macro brain from reasoning about
+@c interpolation at the scope of input lines to interpolations _within_
+@c lines.  It is also a good time to introduce the \n and \* escape
+@c sequences to avoid painful, "WTF"-producing forward references later.
+@c Some materal from groff_mm(7) might be adaptable to this purpose.
+@c
+@c Earlier material from @Defesc{\\n}:
+@c "This means that the value of the register is expanded in place while
+@c GNU @code{troff} is parsing the input line.  Nested assignments (also
+@c called indirect assignments) are possible."
+@c
+@c We can probably drop the term "indirect assignments"; there's nothing
+@c special about these--they are a consequence of *roffs' left-to-right
+@c parsing and they apply to escape sequences in general.
+@c =====================================================================
 
-@node Measurements, Expressions, Text, gtroff Reference
+@c BEGIN Keep (roughly) parallel with section "Measurements" of
+@c groff(7).
+@node Measurements, Numeric Expressions, Text, GNU troff Reference
 @section Measurements
 @cindex measurements
 @cindex scaling indicator
 @cindex indicator, scaling
 
 @cindex units of measurement
-@cindex basic unit (@code{u})
-@cindex machine unit (@code{u})
-@cindex measurement unit
-@cindex @code{u} unit
-@cindex unit, @code{u}
-@code{gtroff} (like many other programs) requires numeric parameters to
-specify various measurements.  Most numeric parameters@footnote{those
-that specify vertical or horizontal motion or a type size} may have a
-@dfn{measurement unit} attached.  These units are specified as a single
-character that immediately follows the number or expression.  Each of
-these units are understood, by @code{gtroff}, to be a multiple of its
-@dfn{basic unit}.  So, whenever a different measurement unit is
-specified @code{gtroff} converts this into its @dfn{basic units}.  This
-basic unit, represented by a @samp{u}, is a device dependent measurement,
-which is quite small, ranging from 1/75@dmn{th} to 1/72000@dmn{th} of an
-inch.  The values may be given as fractional numbers; however,
-fractional basic units are always rounded to integers.
-
-Some of the measurement units are completely independent of any of the
-current settings (e.g.@: type size) of @code{gtroff}.
-
-Although groff's basic unit is device-dependent, it may still be smaller
-than the smallest unit the device is capable of producing.  The register
-@code{.H} specifies how many groff basic units constitute the current
-device's basic unit horizontally, and the register @code{.V} specifies
-this value vertically.
+@cindex measurement units
+The formatter sometimes requires the input of numeric parameters to
+specify measurements.  These are specified as integers or decimal
+fractions with an optional @dfn{scaling unit} suffixed.  A scaling unit
+is a letter that immediately follows the last digit of a number.  Digits
+after the decimal point are optional.  Measurement expressions include
+@samp{10.5p}, @samp{11i}, and @samp{3.c}.
+
+@cindex basic units, conversion to
+@cindex units, basic, conversion to
+@cindex conversion to basic units
+Measurements are scaled by the scaling unit and stored internally (with
+any fractional part discarded) in basic units.
+@cindex device resolution, obtaining in the formatter
+@cindex resolution, device, obtaining in the formatter
+The device resolution can therefore be obtained by storing a value of
+@samp{1i} to a register.  The only constraint on the basic unit is that
+it is at least as small as any other unit.
+@c That's a fib.  A device resolution of around 2^31 would surely also
+@c cause problems.  But nobody does that.
 
 @table @code
+@cindex basic scaling unit (@code{u})
+@cindex @code{u} scaling unit
+@cindex unit, scaling, @code{u}
+@cindex scaling unit @code{u}
+@item u
+Basic unit.
+
 @item i
-@cindex inch unit (@code{i})
-@cindex @code{i} unit
-@cindex unit, @code{i}
-Inches.  An antiquated measurement unit still in use in certain
-backwards countries with incredibly low-cost computer equipment.  One
-inch is defined to be 2.54@tie{}cm (worldwide since 1964).
+@cindex inch scaling unit (@code{i})
+@cindex @code{i} scaling unit
+@cindex unit, scaling, @code{i}
+@cindex scaling unit @code{i}
+Inch; defined as 2.54@tie{}centimeters.
 
 @item c
-@cindex centimeter unit (@code{c})
-@cindex @code{c} unit
-@cindex unit, @code{c}
-Centimeters.  One centimeter is about 0.3937@tie{}in.
+@cindex centimeter scaling unit (@code{c})
+@cindex @code{c} scaling unit
+@cindex unit, scaling, @code{c}
+@cindex scaling unit @code{c}
+Centimeter; a centimeter is about 0.3937@tie{}inches.
 
 @item p
-@cindex point unit (@code{p})
-@cindex @code{p} unit
-@cindex unit, @code{p}
-Points.  This is a typesetter's measurement used for measure type size.
-It is 72@tie{}points to an inch.
+@cindex point scaling unit (@code{p})
+@cindex @code{p} scaling unit
+@cindex unit, scaling, @code{p}
+@cindex scaling unit @code{p}
+Point; a typesetter's unit used for measuring type size.
+There are 72@tie{}points to an inch.
 
 @item P
-@cindex pica unit (@code{P})
-@cindex @code{P} unit
-@cindex unit, @code{P}
-Pica.  Another typesetting measurement.  6@tie{}picas to an inch (and
-12@tie{}points to a pica).
+@cindex pica scaling unit (@code{P})
+@cindex @code{P} scaling unit
+@cindex unit, scaling, @code{P}
+@cindex scaling unit @code{P}
+Pica; another typesetter's unit.  There are 6@tie{}picas to an inch and
+12@tie{}points to a pica.
 
 @item s
 @itemx z
-@cindex @code{s} unit
-@cindex unit, @code{s}
-@cindex @code{z} unit
-@cindex unit, @code{z}
-@xref{Fractional Type Sizes}, for a discussion of these units.
+@xref{Using Fractional Type Sizes}, for a discussion of these units.
 
 @item f
-@cindex @code{f} unit
-@cindex unit, @code{f}
-Fractions.  Value is 65536.
-@xref{Colors}, for usage.
+GNU @code{troff} defines this unit to scale decimal fractions in the
+interval 0, 1 to 16-bit unsigned integers.  It multiplies a quantity
+by 65,536.  @xref{Colors}, for usage.
 @end table
 
-The other measurements understood by @code{gtroff} depend on settings
-currently in effect in @code{gtroff}.  These are very useful for
-specifying measurements that should look proper with any size of text.
+The magnitudes of other scaling units depend on the text formatting
+parameters in effect.  These are useful when specifying measurements
+that need to scale with the typeface or vertical spacing.
 
 @table @code
 @item m
-@cindex em unit (@code{m})
-@cindex @code{m} unit
-@cindex unit, @code{m}
-Ems.  This unit is equal to the current font size in points.  So called
-because it is @emph{approximately} the width of the letter@tie{}@samp{m}
-in the current font.
+@cindex em scaling unit (@code{m})
+@cindex @code{m} scaling unit
+@cindex unit, scaling, @code{m}
+@cindex scaling unit @code{m}
+Em; an em is equal to the current type size in points.  It is named thus
+because it is approximately the width of the letter@tie{}@samp{M}.
 
 @item n
-@cindex en unit (@code{n})
-@cindex @code{n} unit
-@cindex unit, @code{n}
-Ens.  In @code{groff}, this is half of an em.
+@cindex en scaling unit (@code{n})
+@cindex @code{n} scaling unit
+@cindex unit, scaling, @code{n}
+@cindex scaling unit @code{n}
+En; an en is one-half em.
 
 @item v
 @cindex vertical space unit (@code{v})
 @cindex space, vertical, unit (@code{v})
-@cindex @code{v} unit
-@cindex unit, @code{v}
-Vertical space.  This is equivalent to the current line spacing.
-@xref{Sizes}, for more information about this.
+@cindex vee scaling unit (@code{v})
+@cindex @code{v} scaling unit
+@cindex unit, scaling, @code{v}
+@cindex scaling unit @code{v}
+Vee; recall @ref{Page Geometry}.
 
 @item M
-@cindex @code{M} unit
-@cindex unit, @code{M}
-100ths of an em.
+@cindex @code{M} scaling unit
+@cindex unit, scaling, @code{M}
+@cindex scaling unit @code{M}
+Hundredth of an em.
 @end table
 
 @menu
+* Motion Quanta::
 * Default Units::
 @end menu
+@c END Keep (roughly) parallel with section "Measurements" of groff(7).
 
 @c ---------------------------------------------------------------------
 
-@node Default Units,  , Measurements, Measurements
+@node Motion Quanta, Default Units, Measurements, Measurements
+@subsection Motion Quanta
+@cindex motion quanta
+@cindex quanta, motion
+
+@c BEGIN Keep (roughly) parallel with subsection "Motion quanta" of
+@c groff(7).
+An output device's basic unit @code{u} is not necessarily its smallest
+addressable length; @code{u} can be smaller to avoid problems with
+integer roundoff.  The minimum distances that a device can work with in
+the horizontal and vertical directions are termed its @dfn{motion
+quanta}.  Measurements are rounded to applicable motion quanta.
+Half-quantum fractions round toward zero.
+
+@cindex horizontal motion quantum register (@code{.H})
+@cindex motion quantum, horizontal, register (@code{.H})
+@cindex horizontal resolution register (@code{.H})
+@cindex resolution, horizontal, register (@code{.H})
+@DefregList {.H}
+@DefregListEndx {.V}
+These read-only registers interpolate the horizontal and vertical motion
+quanta, respectively, of the output device in basic units.
+@endDefreg
+
+For example, we might draw short baseline rules on a terminal device as
+follows.  @xref{Drawing Geometric Objects}.
+
+@Example
+.tm \n.H
+    @error{} 24
+.nf
+\l'36u' 36u
+\l'37u' 37u
+    @result{} _ 36u
+    @result{} __ 37u
+@endExample
+@c END Keep (roughly) parallel with subsection "Motion quanta" of
+@c groff(7).
+
+@c ---------------------------------------------------------------------
+
+@node Default Units,  , Motion Quanta, Measurements
 @subsection Default Units
 @cindex default units
 @cindex units, default
 
-Many requests take a default unit.  While this can be helpful at times,
-it can cause strange errors in some expressions.  For example, the line
-length request expects em units.  Here are several attempts to get a
-line length of 3.5@tie{}inches and their results:
-
-@Example
-3.5i      @result{}   3.5i
-7/2       @result{}   0i
-7/2i      @result{}   0i
-(7 / 2)u  @result{}   0i
-7i/2      @result{}   0.1i
-7i/2u     @result{}   3.5i
+@c BEGIN Keep (roughly) parallel with subsection "Default units" of
+@c groff(7).
+A general-purpose register (one created or updated with the @code{nr}
+request; see @pxref{Registers}) is implicitly dimensionless, or reckoned
+in basic units if interpreted in a measurement context.  But it is
+convenient for many requests and escape sequences to infer a scaling
+unit for an argument if none is specified.  An explicit scaling unit
+(not after a closing parenthesis) can override an undesirable default.
+Effectively, the default unit is suffixed to the expression if a scaling
+unit is not already present.  GNU @code{troff}'s use of integer
+arithmetic should also be kept in mind (@pxref{Numeric Expressions}).
+
+The @code{ll} request interprets its argument in ems by default.
+Consider several attempts to set a line length of 3.5@tie{}inches when
+the type size is 10@tie{}points on a terminal device with a resolution
+of 240 basic units and horizontal motion quantum of 24.  Some
+expressions become zero; the request clamps them to that quantum.
+
+@Example
+.ll 3.5i      \" 3.5i (= 840u)
+.ll 7/2       \" 7u/2u -> 3u -> 3m -> 0, clamped to 24u
+.ll (7 / 2)u  \" 7u/2u -> as above
+.ll 7/2i      \" 7u/2i -> 7u/480u -> 0 -> as above
+.ll 7i/2      \" 7i/2u -> 1680u/2m -> 1680u/24u -> 35u
+.ll 7i/2u     \" 3.5i (= 840u)
 @endExample
 
 @noindent
-Everything is converted to basic units first.  In the above example it
-is assumed that 1@dmn{i} equals@tie{}240@dmn{u}, and 1@dmn{m}
-equals@tie{}10@dmn{p} (thus 1@dmn{m} equals@tie{}33@dmn{u}).  The value
-7@dmn{i}/2 is first handled as 7@dmn{i}/2@dmn{m}, then converted to
-1680@dmn{u}/66@dmn{u}, which is 25@dmn{u}, and this is approximately
-0.1@dmn{i}.  As can be seen, a scaling indicator after a closing
-parenthesis is simply ignored.
-
 @cindex measurements, specifying safely
-Thus, the safest way to specify measurements is to always attach a
-scaling indicator.  If you want to multiply or divide by a certain
-scalar value, use @samp{u} as the unit for that value.
+The safest way to specify measurements is to attach a scaling unit.  To
+multiply or divide by a dimensionless quantity, use @samp{u} as its
+scaling unit.
+@c END Keep (roughly) parallel with subsection "Default units" of
+@c groff(7).
 
 
 @c =====================================================================
 
-@node Expressions, Identifiers, Measurements, gtroff Reference
-@section Expressions
-@cindex expressions
-
-@code{gtroff} has most arithmetic operators common to other languages:
+@c BEGIN Keep (roughly) parallel with section "Numeric expressions" of
+@c groff(7).
+@node Numeric Expressions, Identifiers, Measurements, GNU troff Reference
+@section Numeric Expressions
+@cindex numeric expressions
+@cindex expressions, numeric
+
+A @dfn{numeric expression} evaluates to an integer:@: it can be as
+simple as a literal @samp{0} or it can be a complex sequence of register
+and string interpolations interleaved with measurements and operators.
+
+GNU @code{troff} provides a set of mathematical and logical operators
+familiar to programmers---as well as some unusual ones---but supports
+only integer arithmetic.@footnote{Provision is made for interpreting and
+reporting decimal fractions in certain cases.}  The internal data type
+used for computing results is usually a 32-bit signed integer, which
+suffices to represent magnitudes within a range of ±2
+billion.@footnote{If that's not enough, see the @cite{groff_tmac@r{(5)}}
+man page for the @file{62bit.tmac} macro package.}
 
-@itemize @bullet
-@item
 @cindex arithmetic operators
 @cindex operators, arithmetic
+@cindex truncating division
+@cindex addition
+@cindex subtraction
+@cindex multiplication
+@cindex division, truncating
+@cindex modulus
 @opindex +
 @opindex -
-@opindex /
 @opindex *
+@opindex /
 @opindex %
-Arithmetic: @samp{+} (addition), @samp{-} (subtraction), @samp{/}
-(division), @samp{*} (multiplication), @samp{%} (modulo).
+Arithmetic infix operators perform a function on the numeric expressions
+to their left and right; they are @code{+} (addition), @code{-}
+(subtraction), @code{*} (multiplication), @code{/} (truncating
+division), and @code{%} (modulus).  @dfn{Truncating division} rounds to
+the integer nearer to zero, no matter how large the fractional portion.
+Overflow and division (or modulus) by zero are errors and abort
+evaluation of a numeric expression.
+@cindex unary arithmetic operators
+@cindex operators, unary arithmetic
+@cindex negation
+@cindex assertion (arithmetic operator)
+@opindex -
+@opindex +
+@cindex @code{if} request, and the @samp{!} operator
+@cindex @code{while} request, and the @samp{!} operator
 
-@code{gtroff} only provides integer arithmetic.  The internal type used
-for computing results is @samp{int}, which is usually a 32-bit signed
-integer.
+Arithmetic unary operators operate on the numeric expression to their
+right; they are @code{-} (negation) and @code{+} (assertion---for
+completeness; it does nothing).  The unary minus must often be used
+with parentheses to avoid confusion with the decrementation operator,
+discussed below.
+
+Observe the rounding behavior and effect of negative operands on the
+modulus and truncating division operators.
+
+@Example
+.nr T 199/100
+.nr U 5/2
+.nr V (-5)/2
+.nr W 5/-2
+.nr X 5%2
+.nr Y (-5)%2
+.nr Z 5%-2
+T=\nT U=\nU V=\nV W=\nW X=\nX Y=\nY Z=\nZ
+    @result{} T=1 U=2 V=-2 W=-2 X=1 Y=-1 Z=1
+@endExample
+
+@noindent
+The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.  Division and modulus operators satisfy the following
+property:@: given a dividend@tie{}@var{a} and a divisor@tie{}@var{b}, a
+quotient@tie{}@var{q} formed by @samp{(a / b)} and a
+remainder@tie{}@var{r} by @samp{(a % b)}, then @math{qb + r = a}.
+
+@cindex scaling operator
+@cindex operator, scaling
+@opindex ;
+GNU @code{troff}'s scaling operator, used with parentheses as
+@code{(@var{c};@var{e})}, evaluates a numeric expression@tie{}@var{e}
+using@tie{}@var{c} as the default scaling unit.  If @var{c} is omitted,
+scaling units are ignored in the evaluation of@tie{}@var{e}.  This
+operator can save typing by avoiding the attachment of scaling units to
+every operand out of caution.  Your macros can select a sensible default
+unit in case the user neglects to supply one.
+
+@Example
+.\" Indent by amount given in first argument; assume ens.
+.de Indent
+.  in (n;\\$1)
+..
+@endExample
+
+@noindent
+Without the scaling operator, the foregoing macro would, if called with
+a unitless argument, cause indentation by the @code{in} request's
+default scaling unit (ems).  The result would be twice as much
+indentation as expected.
+
+@cindex extremum operators (@code{>?}, @code{<?})
+@cindex operators, extremum (@code{>?}, @code{<?})
+@cindex maximum operator
+@cindex minimum operator
+@opindex >?
+@opindex <?
+GNU @code{troff} also provides a pair of operators to compute the
+extrema of two operands: @code{>?} (maximum) and @code{<?} (minimum).
+
+@Example
+.nr slots 5
+.nr candidates 3
+.nr salaries (\nslots <? \ncandidates)
+Looks like we'll end up paying \nsalaries salaries.
+    @result{} Looks like we'll end up paying 3 salaries.
+@endExample
 
-@item
 @cindex comparison operators
 @cindex operators, comparison
+@cindex greater than (or equal to) operator
+@cindex less than (or equal to) operator
+@cindex equality operator
 @opindex <
 @opindex >
 @opindex >=
 @opindex <=
 @opindex =
 @opindex ==
-Comparison: @samp{<} (less than), @samp{>} (greater than), @samp{<=}
-(less than or equal), @samp{>=} (greater than or equal), @samp{=}
-(equal), @samp{==} (the same as @samp{=}).
+Comparison operators comprise @code{<} (less than), @code{>} (greater
+than), @code{<=} (less than or equal), @code{>=} (greater than or
+equal), and @code{=} (equal).  @code{==} is a synonym for @code{=}.
+When evaluated, a comparison is replaced with @samp{0} if it is false
+and @samp{1} if true.  In the @code{roff} language, positive values are
+true, others false.
 
-@item
 @cindex logical operators
 @cindex operators, logical
+@cindex logical ``and'' operator
+@cindex logical conjunction operator
+@cindex logical ``or'' operator
+@cindex logical disjunction operator
 @opindex &
 @ifnotinfo
 @opindex :
@@ -5246,282 +6171,368 @@
 @ifinfo
 @opindex @r{<colon>}
 @end ifinfo
-Logical: @samp{&} (logical and), @samp{:} (logical or).
+We can operate on truth values with the logical operators @code{&}
+(logical conjunction or ``and'') and @code{:} (logical disjunction or
+``or'').  They evaluate as comparison operators do.
 
-@item
-@cindex unary operators
-@cindex operators, unary
-@opindex -
-@opindex +
 @opindex !
-@cindex @code{if} request, and the @samp{!} operator
-@cindex @code{while} request, and the @samp{!} operator
-Unary operators: @samp{-} (negating, i.e.@: changing the sign), @samp{+}
-(just for completeness; does nothing in expressions), @samp{!} (logical
-not; this works only within @code{if} and @code{while}
-requests).@footnote{Note that, for example, @samp{!(-1)} evaluates to
-`true' because @code{gtroff} treats both negative numbers and zero as
-`false'.}  See below for the use of unary operators in motion requests.
-
+@cindex complementation, logical
+@cindex logical complementation operator
 @cindex logical not, limitation in expression
 @cindex expression, limitation of logical not in
-The logical not operator,
-as described above,
-works only within @code{if} and @code{while} requests.
-Furthermore, it may appear
-only at the beginning of an expression,
-and negates the entire expression.
-Attempting to insert the @samp{!} operator
-within the expression results in a
-@samp{numeric expression expected} warning.  This
-maintains compatibility
-with old versions of @code{troff}.
-
-Example:
+A logical complementation (``not'') operator, @code{!}, works only
+within @code{if}, @code{ie}, and @code{while} requests.
+@c This is worded to avoid implying that the operator doesn't apply
+@c to conditional expressions in general, albeit without mentioning them
+@c because they're out of scope.
+Furthermore, @code{!} is recognized only at the beginning of a numeric
+expression not contained by another numeric expression.  In other words,
+it must be the ``outermost'' operator.  Including it elsewhere in the
+expression produces a warning in the @samp{number} category
+(@pxref{Warnings}), and its expression evaluates false.  This
+unfortunate limitation maintains compatibility with @acronym{AT&T}
+@code{troff}.  Test a numeric expression for falsity by
+comparing it to a false value.@footnote{@xref{Conditionals and Loops}.}
 
 @Example
 .nr X 1
 .nr Y 0
-.\" This does not work as expected
-.if (\nX)&(!\nY) .nop X only
+.\" This does not work as expected.
+.if (\nX)&(!\nY) .nop A: X is true, Y is false
 .
-.\" Use this construct instead
-.if (\nX=1)&(\nY=0) .nop X only
-@endExample
-
-@item
-@cindex extremum operators (@code{>?}, @code{<?})
-@cindex operators, extremum (@code{>?}, @code{<?})
-@opindex >?
-@opindex <?
-Extrema: @samp{>?} (maximum), @samp{<?} (minimum).
-
-Example:
-
-@Example
-.nr x 5
-.nr y 3
-.nr z (\nx >? \ny)
+.\" Use this construct instead.
+.if (\nX)&(\nY<=0) .nop B: X is true, Y is false
+    @error{} warning: expected numeric expression, got '!'
+    @result{} B: X is true, Y is false
 @endExample
 
-@noindent
-The register@tie{}@code{z} now contains@tie{}5.
-
-@item
-@cindex scaling operator
-@cindex operator, scaling
-Scaling: @code{(@var{c};@var{e})}.  Evaluate@tie{}@var{e}
-using@tie{}@var{c} as the default scaling indicator.  If @var{c} is
-missing, ignore scaling indicators in the evaluation of@tie{}@var{e}.
-@end itemize
-
 @cindex parentheses
 @cindex order of evaluation in expressions
 @cindex expression, order of evaluation
 @opindex (
 @opindex )
-Parentheses may be used as in any other language.  However, in
-@code{gtroff} they are necessary to ensure order of evaluation.
-@code{gtroff} has no operator precedence; expressions are evaluated left
-to right.  This means that @code{gtroff} evaluates @samp{3+5*4} as if it
-were parenthesized like @samp{(3+5)*4}, not as @samp{3+(5*4)}, as might
-be expected.
+The @code{roff} language has no operator precedence:@: expressions are
+evaluated strictly from left to right, in contrast to schoolhouse
+arithmetic.  Use parentheses @code{(} @code{)} to impose a desired
+precedence upon subexpressions.
+
+@Example
+.nr X 3+5*4
+.nr Y (3+5)*4
+.nr Z 3+(5*4)
+X=\nX Y=\nY Z=\nZ
+    @result{} X=32 Y=32 Z=23
+@endExample
 
 @cindex @code{+}, and page motion
 @cindex @code{-}, and page motion
 @cindex motion operators
 @cindex operators, motion
-For many requests that cause a motion on the page, the unary operators
-@samp{+} and @samp{-} work differently if leading an expression.  They
-then indicate a motion relative to the current position (down or up,
-respectively).
+@opindex + @r{(unary)}
+@opindex - @r{(unary)}
+For many requests and escape sequences that cause motion on the page,
+the unary operators @code{+} and @code{-} work differently when leading
+a numeric expression.  They then indicate a motion relative to the
+drawing position:@: positive is down in vertical contexts, right in
+horizontal ones.
+
+@cindex @code{bp} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{in} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{ll} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{lt} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{nm} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{nr} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{pl} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{pn} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{po} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{ps} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{pvs} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{rt} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{ti} request, using @code{+} and@tie{}@code{-} with
+@cindex @code{\H}, using @code{+} and@tie{}@code{-} with
+@cindex @code{\R}, using @code{+} and@tie{}@code{-} with
+@cindex @code{\s}, using @code{+} and@tie{}@code{-} with
+@code{+} and @code{-} are also treated differently by the following
+requests and escape sequences:@: @code{bp}, @code{in}, @code{ll},
+@code{lt}, @code{nm}, @code{nr}, @code{pl}, @code{pn}, @code{po},
+@code{ps}, @code{pvs}, @code{rt}, @code{ti}, @code{\H}, @code{\R}, and
+@code{\s}.  Here, leading plus and minus signs serve as incrementation
+and decrementation operators, respectively.  To negate an expression,
+subtract it from zero or include the unary minus in parentheses with its
+argument.  @xref{Setting Registers}, for examples.
 
+@opindex |
 @cindex @code{|}, and page motion
-@cindex absolute position operator (@code{|})
-@cindex position, absolute, operator (@code{|})
-Similarly, a leading @samp{|} operator indicates an absolute position.
-For vertical movements, it specifies the distance from the top of the
-page; for horizontal movements, it gives the distance from the beginning
-of the @emph{input} line.
-
-@cindex @code{bp} request, using @code{+} and@tie{}@code{-}
-@cindex @code{in} request, using @code{+} and@tie{}@code{-}
-@cindex @code{ll} request, using @code{+} and@tie{}@code{-}
-@cindex @code{lt} request, using @code{+} and@tie{}@code{-}
-@cindex @code{nm} request, using @code{+} and@tie{}@code{-}
-@cindex @code{nr} request, using @code{+} and@tie{}@code{-}
-@cindex @code{pl} request, using @code{+} and@tie{}@code{-}
-@cindex @code{pn} request, using @code{+} and@tie{}@code{-}
-@cindex @code{po} request, using @code{+} and@tie{}@code{-}
-@cindex @code{ps} request, using @code{+} and@tie{}@code{-}
-@cindex @code{pvs} request, using @code{+} and@tie{}@code{-}
-@cindex @code{rt} request, using @code{+} and@tie{}@code{-}
-@cindex @code{ti} request, using @code{+} and@tie{}@code{-}
-@cindex @code{\H}, using @code{+} and@tie{}@code{-}
-@cindex @code{\R}, using @code{+} and@tie{}@code{-}
-@cindex @code{\s}, using @code{+} and@tie{}@code{-}
-@samp{+} and @samp{-} are also treated differently by the following
-requests and escapes: @code{bp}, @code{in}, @code{ll}, @code{lt},
-@code{nm}, @code{nr}, @code{pl}, @code{pn}, @code{po}, @code{ps},
-@code{pvs}, @code{rt}, @code{ti}, @code{\H}, @code{\R}, and @code{\s}.
-Here, leading plus and minus signs indicate increments and decrements.
+@cindex absolute @slanted{(sic)} position operator (@code{|})
+@cindex position, absolute @slanted{(sic)} operator (@code{|})
+@cindex boundary-relative motion operator (@code{|})
+@c "motion" and "operators" already indexed above
+A leading @code{|} operator indicates a motion relative not to the
+drawing position but to a boundary.  For horizontal motions, the
+measurement specifies a distance relative to a drawing position
+corresponding to the beginning of the @emph{input} line.  By default,
+tab stops reckon movements in this way.  Most escape sequences do not;
+@c XXX: Which ones do?
+@code{|} tells them to do so.
 
-@xref{Setting Registers}, for some examples.
+@Example
+Mind the \h'1.2i'gap.
+.br
+Mind the \h'|1.2i'gap.
+.br
+Mind the
+\h'|1.2i'gap.
+@c 13 spaces, 4 spaces, 13 spaces
+    @result{} Mind the             gap.
+    @result{} Mind the    gap.
+    @result{} Mind the             gap.
+@endExample
 
-@Defesc {\\B, ', anything, '}
+One use of this feature is to define macros whose scope is limited to
+the output they format.
+
+@Example
+.\" underline word $1 with trailing punctuation $2
+.de Underline
+.  nop \\$1\l'|0\ul'\\$2
+..
+Typographical emphasis is best used
+.Underline sparingly .
+@endExample
+
+@noindent
+In the above example, @samp{|0} specifies a negative motion from the
+current position (at the end of the argument just emitted, @code{\$1})
+to the beginning of the input line.  Thus, the @code{\l} escape sequence
+in this case draws a line from right to left.  A macro call occurs at
+the beginning of an input line;@footnote{Control structure syntax
+creates an exception to this rule, but is designed to remain useful:@:
+recalling our example, @samp{.if 1 .Underline this} would underline only
+``this'', precisely.  @xref{Conditionals and Loops}.} if the @code{|}
+operator were omitted, then the underline would be drawn at zero
+distance from the current position, producing device-dependent, and
+likely undesirable, results.  On the @samp{ps} output device, it
+underlines the period.
+
+For vertical motions, the @code{|} operator specifies a distance from
+the first text baseline on the page or in the current
+diversion,@footnote{@xref{Diversions}.}  using the current vertical
+spacing.
+
+@Example
+A
+.br
+B \Z'C'\v'|0'D
+    @result{} A D
+    @result{} B C
+@endExample
+
+In the foregoing example, we've used the @code{\Z} escape sequence
+(@pxref{Page Motions}) to restore the drawing position after formatting
+@samp{C}, then moved vertically to the first text baseline on the page.
+
+@Defesc {\\B, @code{'}, anything, @code{'}}
 @cindex numeric expression, valid
 @cindex valid numeric expression
-Return@tie{}1 if @var{anything} is a valid numeric expression; or@tie{}0
-if @var{anything} is empty or not a valid numeric expression.
+Interpolate@tie{}1 if @var{anything} is a valid numeric expression,
+and@tie{}0 otherwise.  The delimiter need not be a neutral apostrophe;
+see @ref{Delimiters}.
 @endDefesc
 
+You might use @code{\B} along with the @code{if} request to filter out
+invalid macro or string arguments.  @xref{Conditionals and Loops}.
+
+@Example
+.\" Indent by amount given in first argument; assume ens.
+.de Indent
+.  if \B'\\$1' .in (n;\\$1)
+..
+@endExample
+
+A register interpolated as an operand in a numeric expression must have
+an Arabic format; luckily, this is the default.  @xref{Assigning
+Register Formats}.
+
 @cindex space characters, in expressions
 @cindex expressions, and space characters
-Due to the way arguments are parsed, spaces are not allowed in
-expressions, unless the entire expression is surrounded by parentheses.
+Because spaces separate arguments to requests, spaces are not allowed in
+numeric expressions unless the (sub)expression containing them is
+surrounded by parentheses.  @xref{Invoking Requests}, and
+@ref{Conditionals and Loops}.
+
+@Example
+.nf
+.nr a 1+2 + 2+1
+\na
+    @error{} expected numeric expression, got a space
+    @result{} 3
+.nr a 1+(2 + 2)+1
+\na
+    @result{} 6
+@endExample
 
-@xref{Request and Macro Arguments}, and @ref{Conditionals and Loops}.
+The @code{nr} request (@pxref{Setting Registers}) expects its second and
+optional third arguments to be numeric expressions; a bare @code{+} does
+not qualify, so our first attempt got a warning.
+@c END Keep (roughly) parallel with section "Numeric expressions" of
+@c groff(7).
 
 
 @c =====================================================================
 
-@node Identifiers, Embedded Commands, Expressions, gtroff Reference
+@c BEGIN Keep (roughly) parallel with section "Identifiers" of groff(7).
+@node Identifiers, Formatter Instructions, Numeric Expressions, GNU troff Reference
 @section Identifiers
 @cindex identifiers
 
-Like any other language, @code{gtroff} has rules for properly formed
-@dfn{identifiers}.  In @code{gtroff}, an identifier can be made up of
-almost any printable character, with the exception of the following
-characters:
-
-@itemize @bullet
-@item
-@cindex whitespace characters
-@cindex newline character
-@cindex character, whitespace
-Whitespace characters (spaces, tabs, and newlines).
-
-@item
-@cindex character, backspace
-@cindex backspace character
-@cindex @acronym{EBCDIC} encoding of backspace
-Backspace (@acronym{ASCII}@tie{}@code{0x08} or
-@acronym{EBCDIC}@tie{}@code{0x16}) and character code @code{0x01}.
-
-@item
+An @dfn{identifier} labels a GNU @code{troff} datum such as a register,
+name (macro, string, or diversion), typeface, color, special character,
+character class, environment, or stream.  Valid identifiers consist of
+one or more ordinary characters.
+@cindex ordinary character
+@cindex character, ordinary
+An @slanted{ordinary character} is an input character that is not the
+escape character, a leader, tab, newline, or invalid as GNU @code{troff}
+input.
+
+@c XXX: We might move this discussion earlier since it is applicable to
+@c troff input in general, and include a reference to the `trin`
+@c request.
 @cindex invalid input characters
 @cindex input characters, invalid
 @cindex characters, invalid input
 @cindex Unicode
-The following input characters are invalid and are ignored if
-@code{groff} runs on a machine based on @acronym{ASCII}, causing a
-warning message of type @samp{input} (see @ref{Debugging}, for more
-details): @code{0x00}, @code{0x0B}, @code{0x0D}--@code{0x1F},
-@code{0x80}--@code{0x9F}.
-
-And here are the invalid input characters if @code{groff} runs on an
-@acronym{EBCDIC} host: @code{0x00}, @code{0x08}, @code{0x09},
-@code{0x0B}, @code{0x0D}--@code{0x14}, @code{0x17}--@code{0x1F},
-@code{0x30}--@code{0x3F}.
-
-Currently, some of these reserved codepoints are used internally, thus
-making it non-trivial to extend @code{gtroff} to cover Unicode or other
-character sets and encodings that use characters of these ranges.
-
-Note that invalid characters are removed before parsing; an identifier
-@code{foo}, followed by an invalid character, followed by @code{bar} is
-treated as @code{foobar}.
-@end itemize
-
-For example, any of the following is valid.
-
-@Example
-br
-PP
-(l
-end-list
-@@_
+Invalid input characters are a subset of control characters (from the
+sets ``C0 Controls'' and ``C1 Controls'' as Unicode describes them).
+When GNU @code{troff} encounters one in an identifier, it produces a
+warning in category @samp{input} (@pxref{Warnings}).  They are removed
+during interpretation: an identifier @samp{foo}, followed by an invalid
+character and then @samp{bar}, is processed as @samp{foobar}.
+
+On a machine using the ISO 646, 8859, or 10646 character encodings,
+invalid input characters are @code{0x00}, @code{0x08}, @code{0x0B},
+@code{0x0D}--@code{0x1F}, and @code{0x80}--@code{0x9F}.  On an
+@acronym{EBCDIC} host, they are @code{0x00}--@code{0x01}, @code{0x08},
+@code{0x09}, @code{0x0B}, @code{0x0D}--@code{0x14},
+@code{0x17}--@code{0x1F}, and
+@code{0x30}--@code{0x3F}.@footnote{Historically, control characters like
+ASCII STX, ETX, and BEL (@key{Control+B}, @key{Control+C}, and
+@key{Control+G}) have been observed in @code{roff} documents,
+particularly in macro packages employing them as delimiters with the
+output comparison operator to try to avoid collisions with the content
+of arbitrary user-supplied parameters (@pxref{Operators in
+Conditionals}).  We discourage this expedient; in GNU @code{troff} it is
+unnecessary (outside of compatibility mode) because delimited arguments
+are parsed at a different input level than the surrounding context.
+@xref{Implementation Differences}.}  Some of these code points are used
+by GNU @code{troff} internally, making it non-trivial to extend the
+program to accept UTF-8 or other encodings that use characters from
+these ranges.@footnote{Consider what happens when a C1 control
+@code{0x80}--@code{0x9F} is necessary as a continuation byte in a UTF-8
+sequence.}
+
+Thus, the identifiers @samp{br}, @samp{PP}, @samp{end-list},
+@samp{ref*normal-print}, @samp{|}, @samp{@@_}, and @samp{!"#$%'()*+,-./}
+are all valid.  Discretion should be exercised to prevent confusion.
+Identifiers starting with @samp{(} or @samp{} require care.
+
+@Example
+.nr x 9
+.nr y 1
+.nr (x 2
+.nr y 3
+.nr sum1 (\n(x + \ny)
+    @error{} a space character is not allowed in an escape
+    @error{}   sequence parameter
+A:2+3=\nsum1
+.nr sum2 (\n((x + \ny)
+B:2+3=\nsum2
+.nr sum3 (\n(x + \n(y)
+C:2+3=\nsum3
+    @result{} A:2+3=1 B:2+3=5 C:2+3=5
 @endExample
 
 @cindex @code{}, as part of an identifier
 @noindent
-Note that identifiers longer than two characters with a closing bracket
-(@samp{}) in its name can't be accessed with escape sequences that
-expect an identifier as a parameter.  For example, @samp{\foo}
-accesses the glyph @samp{foo}, followed by @samp{}, whereas
-@samp{\C'foo'} really asks for glyph @samp{foo}.
+An identifier with a closing bracket (@samp{}) in its name can't be
+accessed with bracket-form escape sequences that expect an identifier as
+a parameter.  For example, @samp{\foo} accesses the glyph @samp{foo},
+followed by @samp{} in whatever the surrounding context is, whereas
+@samp{\C'foo'} formats a glyph named @samp{foo}.  Similarly, the
+identifier @samp{(} can't be interpolated @emph{except} with bracket
+forms.
 
 @cindex @code{refer}, and macro names starting with @code{} or @code{}
 @cindex @code{}, macro names starting with, and @code{refer}
 @cindex @code{}, macro names starting with, and @code{refer}
 @cindex macro names, starting with @code{} or @code{}, and @code{refer}
-To avoid problems with the @code{refer} preprocessor, macro names should
-not start with @samp{} or @samp{}.  Due to backwards compatibility,
-everything after @samp{.} and @samp{.} is handled as a special
-argument to @code{refer}.  For example, @samp{.foo} makes @code{refer}
-to start a reference, using @samp{foo} as a parameter.
-
-@Defesc {\\A, ', ident, '}
-Test whether an identifier @var{ident} is valid in @code{gtroff}.  It
-expands to the character@tie{}1 or@tie{}0 according to whether its
-argument (usually delimited by quotes) is or is not acceptable as the
-name of a string, macro, diversion, number register, environment, or
-font.  It returns@tie{}0 if no argument is given.  This is useful for
-looking up user input in some sort of associative table.
-
-@Example
-\A'end-list'
-    @result{} 1
+If you begin a macro, string, or diversion name with either of the
+characters @samp{} or @samp{}, you foreclose use of the @code{grefer}
+preprocessor, which recognizes @samp{.} and @samp{.} as bibliographic
+reference delimiters.
+
+@Defesc {\\A, @code{'}, anything, @code{'}}
+Interpolate@tie{}1 if @var{anything} is a valid identifier, and@tie{}0
+otherwise.  The delimiter need not be a neutral apostrophe; see
+@ref{Delimiters}.  Because invalid input characters are removed (see
+above), invalid identifiers are empty or contain spaces, tabs, or
+newlines.
+
+You can employ @code{\A} to validate a macro argument before using it to
+construct another escape sequence or identifier.
+
+@Example
+.\" usage: .init-coordinate-pair name val1 val2
+.\" Create a coordinate pair where name!x=val1 and
+.\" name!y=val2.
+.de init-coordinate-pair
+.  if \A'\\$1' \@{\
+.    if \B'\\$2' .nr \\$1!x \\$2
+.    if \B'\\$3' .nr \\$1!y \\$3
+.  \@}
+..
+.init-coordinate-pair center 5 10
+The center is at (\ncenter!x, \ncenter!y).
+.init-coordinate-pair "poi@arrow{}nt" trash garbage \" ignored
+.init-coordinate-pair point trash garbage \" ignored
+    @result{} The center is at (5, 10).
 @endExample
-@endDefesc
-
-@xref{Escapes}, for details on parameter delimiting characters.
 
-Identifiers in @code{gtroff} can be any length, but, in some contexts,
-@code{gtroff} needs to be told where identifiers end and text begins
-(and in different ways depending on their length):
-
-@itemize @bullet
-@item
-Single character.
-
-@cindex @code{(}, starting a two-character identifier
-@item
-Two characters.  Must be prefixed with @samp{(} in some situations.
-
-@cindex @code{}, starting an identifier
-@cindex @code{}, ending an identifier
-@item
-Arbitrary length (@code{gtroff} only).  Must be bracketed with @samp{}
-and@tie{}@samp{} in some situations.  Any length identifier can be put
-in brackets.
-@end itemize
+@noindent
+In this example, we also validated the numeric arguments; the registers
+@samp{point!x} and @samp{point!y} remain undefined.  @xref{Numeric
+Expressions} for the @code{\B} escape sequence.
+@endDefesc
 
 @cindex undefined identifiers
 @cindex identifiers, undefined
-Unlike many other programming languages, undefined identifiers are
-silently ignored or expanded to nothing.  When @code{gtroff} finds an
-undefined identifier, it emits a warning, doing the following:
-
-@itemize @bullet
-@item
-If the identifier is a string, macro, or diversion, @code{gtroff}
-defines it as empty.
+How GNU @code{troff} handles the interpretation of an undefined
+identifier depends on the context.  There is no way to invoke an
+undefined request; such syntax is interpreted as a macro call instead.
+If the identifier is interpreted as a string, macro, or diversion, GNU
+@code{troff} emits a warning in category @samp{mac}, defines it as
+empty, and interpolates nothing.  If the identifier is interpreted as a
+register, GNU @code{troff} emits a warning in category @samp{reg},
+initializes it to zero, and interpolates that value.  @xref{Warnings},
+@ref{Interpolating Registers}, and @ref{Strings}.  Attempting to use an
+undefined typeface, special character, color, character class,
+environment, or stream generally provokes an error diagnostic.
 
-@item
-If the identifier is a number register, @code{gtroff} defines it with a
-value of@tie{}0.
-@end itemize
-
-@xref{Warnings}., @ref{Interpolating Registers}, and @ref{Strings}.
-
-Note that macros, strings, and diversions share the same name space.
+@need 1000
+@cindex name space, common, of macros, diversions, and strings
+@cindex common name space of macros, diversions, and strings
+@cindex macros, shared name space with strings and diversions
+@cindex strings, shared name space with macros and diversions
+@cindex diversions, shared name space with macros and strings
+Identifiers for requests, macros, strings, and diversions share one name
+space; special characters and character classes another.  No other
+object types do.
 
 @Example
 .de xxx
 .  nop foo
 ..
-.
+@c . slack line for pagination management
 .di xxx
 bar
 .br
@@ -5532,402 +6543,596 @@
 @endExample
 
 @noindent
-As can be seen in the previous example, @code{gtroff} reuses the
-identifier @samp{xxx}, changing it from a macro to a diversion.  No
-warning is emitted!  The contents of the first macro definition is lost.
-
-@xref{Interpolating Registers}, and @ref{Strings}.
+The foregoing example shows that GNU @code{troff} reuses the identifier
+@samp{xxx}, changing it from a macro to a diversion.  No warning is
+emitted, and the previous contents of @samp{xxx} are lost.
+@c END Keep (roughly) parallel with section "Identifiers" of groff(7).
 
 
 @c =====================================================================
 
-@node Embedded Commands, Registers, Identifiers, gtroff Reference
-@section Embedded Commands
-@cindex embedded commands
-@cindex commands, embedded
-
-Most documents need more functionality beyond filling, adjusting and
-implicit line breaking.  In order to gain further functionality,
-@code{gtroff} allows commands to be embedded into the text, in two ways.
+@node Formatter Instructions, Registers, Identifiers, GNU troff Reference
+@section Formatter Instructions
+@cindex formatter instructions
+@cindex instructing the formatter
+
+To support documents that require more than filling, automatic line
+breaking and hyphenation, adjustment, and supplemental inter-sentence
+space, the @code{roff} language offers two means of embedding
+instructions to the formatter.
+
+@cindex request
+One is a @dfn{request}, which begins with a control character and takes
+up the remainder of the input line.  Requests often perform relatively
+large-scale operations such as setting the page length, breaking the
+line, or starting a new page.  They also conduct internal operations
+like defining macros.
+
+@cindex escape sequence
+@cindex sequence, escape
+The other is an @dfn{escape sequence}, which begins with the escape
+character and can be embedded anywhere in the input, even in arguments
+to requests and other escape sequences.  Escape sequences interpolate
+special characters, strings, or registers, and handle comparatively
+minor formatting tasks like sub- and superscripting.
 
-The first is a @dfn{request} that takes up an entire line, and does
-some large-scale operation (e.g.@: break lines, start new pages).
-
-The other is an @dfn{escape} that can be usually embedded anywhere in
-the text; most requests can accept it even as an argument.  Escapes
-generally do more minor operations like sub- and superscripts, print a
-symbol, etc.
+Some operations, such as font selection and type size alteration, are
+available via both requests and escape sequences.
 
 @menu
-* Requests::
-* Macros::
-* Escapes::
+* Control Characters::
+* Invoking Requests::
+* Calling Macros::
+* Using Escape Sequences::
+* Delimiters::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Requests, Macros, Embedded Commands, Embedded Commands
-@subsection Requests
-@cindex requests
+@node Control Characters, Invoking Requests, Formatter Instructions, Formatter Instructions
+@subsection Control Characters
+@cindex control characters
+@cindex configuring control characters
+@cindex changing control characters
+
+The mechanism of using @code{roff}'s control characters to invoke
+requests and call macros was introduced in @ref{Requests and Macros}.
+Control characters are recognized only at the beginning of an input
+line, or at the beginning of the branch of a control structure request;
+see @ref{Conditionals and Loops}.
+
+A few requests cause a break implicitly; use the no-break control
+character to prevent the break.  Break suppression is its sole
+behavioral distinction.  Employing the no-break control character to
+invoke requests that don't cause breaks is harmless but poor style.
+@xref{Manipulating Filling and Adjustment}.
 
-@cindex control character (@code{.})
-@cindex character, control (@code{.})
-@cindex no-break control character (@code{'})
-@cindex character, no-break control (@code{'})
-@cindex control character, no-break (@code{'})
-A request line begins with a control character, which is either a single
-quote (@samp{'}, the @dfn{no-break control character}) or a period
-(@samp{.}, the normal @dfn{control character}).  These can be changed;
-see @ref{Character Translations}, for details.  After this there may be
-optional tabs or spaces followed by an identifier, which is the name of
-the request.  This may be followed by any number of space-separated
-arguments (@emph{no} tabs here).
-
-@cindex structuring source code of documents or macro packages
-@cindex documents, structuring the source code
-@cindex macro packages, structuring the source code
-Since a control character followed by whitespace only is ignored, it is
-common practice to use this feature for structuring the source code of
-documents or macro packages.
-
-@Example
-.de foo
-.  tm This is foo.
-..
-.
-.
-.de bar
-.  tm This is bar.
-..
-@endExample
-
-@cindex blank line
-@cindex blank line macro (@code{blm})
-Another possibility is to use the blank line macro request @code{blm} by
-assigning an empty macro to it.
-
-@Example
-.de do-nothing
-..
-.blm do-nothing  \" activate blank line macro
-
-.de foo
-.  tm This is foo.
-..
-
-
-.de bar
-.  tm This is bar.
-..
-
-.blm             \" deactivate blank line macro
-@endExample
-
-@xref{Blank Line Traps}.
+@cindex control character, changing (@code{cc})
+@cindex character, control, changing (@code{cc})
+@cindex no-break control character, changing (@code{c2})
+@cindex character, no-break control, changing (@code{c2})
+@cindex control character, no-break, changing (@code{c2})
+The control @samp{.} and no-break control @samp{'} characters can each
+be changed to any ordinary character@footnote{Recall @ref{Identifiers}.}
+with the @code{cc} and @code{c2} requests, respectively.
+
+@Defreq {cc, @Var{o}}
+Recognize the ordinary character@tie{}@var{o} as the control character.
+If@tie{}@var{o} is absent or invalid, the default control character
+@samp{.} is selected.  The identity of the control character is
+associated with the environment (@pxref{Environments}).
+@endDefreq
+
+@Defreq {c2, @Var{o}}
+Recognize the ordinary character@tie{}@var{o} as the no-break control
+character.  If@tie{}@var{o} is absent or invalid, the default no-break
+control character @samp{'} is selected.  The identity of the no-break
+control character is associated with the environment
+(@pxref{Environments}).
+@endDefreq
 
-@cindex zero width space character (@code{\&})
-@cindex character, zero width space (@code{\&})
-@cindex space character, zero width (@code{\&})
-@cindex @code{\&}, escaping control characters
-To begin a line with a control character without it being interpreted,
-precede it with @code{\&}.  This represents a zero width space, which
-means it does not affect the output.
-
-In most cases the period is used as a control character.  Several
-requests cause a break implicitly; using the single quote control
-character prevents this.
+When writing a macro, you might wish to know which control character was
+used to call it.
 
 @Defreg {.br}
-A read-only number register, which is set to@tie{}1 if a macro is called
-with the normal control character (as defined with the @code{cc}
-request), and set to@tie{}0 otherwise.
+This read-only register interpolates@tie{}1 if the currently executing
+macro was called using the normal control character and@tie{}0
+otherwise.  If a macro is interpolated as a string, the @code{.br}
+register's value is inherited from the context of the string
+interpolation.  @xref{Strings}.
 
+@cindex intercepting requests
+@cindex requests, intercepting
 @cindex modifying requests
 @cindex requests, modifying
-This allows reliable modification of requests.
+Use this register to reliably intercept requests that imply breaks.
 
 @Example
 .als bp*orig bp
 .de bp
-.  tm before bp
 .  ie \\n.br .bp*orig
-.  el 'bp*orig
-.  tm after bp
+.  el          'bp*orig
 ..
 @endExample
 
-Using this register outside of a macro makes no sense (it always returns
-zero in such cases).
-
-If a macro is called as a string (that is, using @code{\*}), the value
-of the @code{.br} register is inherited from the caller.
+Testing the @code{.br} register outside of a macro definition makes no
+sense.
 @endDefreg
 
-@menu
-* Request and Macro Arguments::
-@end menu
+@c ---------------------------------------------------------------------
 
-@node Request and Macro Arguments,  , Requests, Requests
-@subsubsection Request and Macro Arguments
-@cindex request arguments
-@cindex macro arguments
-@cindex arguments to requests and macros
+@c BEGIN Keep (roughly) parallel with section "Requests" of groff(7).
+@node Invoking Requests, Calling Macros, Control Characters, Formatter Instructions
+@subsection Invoking Requests
+@cindex invoking requests
+@cindex requests, invoking
+
+A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.  The invocation of an
+unrecognized request is interpreted as a macro call.  Defining a macro
+with the same name as a request replaces the request.  Deleting a
+request name with the @code{rm} request makes it unavailable.  The
+@code{als} request can alias requests, permitting them to be wrapped or
+non-destructively replaced.  @xref{Strings}.
 
+@cindex request arguments
+@cindex arguments to requests
 @cindex tabs, and macro arguments
 @cindex macro arguments, and tabs
 @cindex arguments to macros, and tabs
-Arguments to requests and macros are processed much like the shell:
-The line is split into arguments according to
-spaces.@footnote{Plan@tie{}9's @code{troff} implementation also allows
-tabs for argument separation -- @code{gtroff} intentionally doesn't
-support this.}
+@cindex tabs, and request arguments
+@cindex request arguments, and tabs
+@cindex arguments to requests, and tabs
+There is no inherent limit on argument length or quantity.  Most
+requests take one or more arguments, and ignore any they do not expect.
+A request may be separated from its arguments by tabs or spaces, but
+only spaces can separate an argument from its successor.  Only one
+between arguments is necessary; any excess is ignored.  GNU @code{troff}
+does not allow tabs for argument separation.@footnote{In compatibility
+mode, a space is not necessary after a request or macro name of two
+characters' length.  Also, Plan@tie{}9 @code{troff} allows tabs to
+separate arguments.}
+
+Generally, a space @emph{within} a request argument is not relevant, not
+meaningful, or is supported by bespoke provisions, as with the @code{tl}
+request's delimiters (@pxref{Page Layout}).  Some requests, like
+@code{ds}, interpret the remainder of the control line as a single
+argument.  @xref{Strings}.
 
-@cindex spaces, in a macro argument
-An argument to a macro that is intended to contain spaces can either be
-enclosed in double quotes, or have the spaces @dfn{escaped} with
-backslashes.  This is @emph{not} true for requests.
-
-Here are a few examples for a hypothetical macro @code{uh}:
+@need 1000
+@cindex structuring source code of documents or macro packages
+@cindex documents, structuring the source of
+@cindex macro package, structuring the source of
+@cindex package, package, structuring the source of
+@cindex indentation, of @code{roff} source code
+Spaces and tabs immediately after a control character are ignored.
+Commonly, authors structure the source of documents or macro files with
+them.
 
 @Example
-.uh The Mouse Problem
-.uh "The Mouse Problem"
-.uh The\ Mouse\ Problem
+.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
+.
+.
+.de right-align
+.@arrow{}if \\n.br \
+.@arrow{}@arrow{}br
+.@arrow{}rj \\$1
+..
 @endExample
 
-@cindex @code{\~}, difference to @code{\@key{SP}}
-@cindex @code{\@key{SP}}, difference to @code{\~}
-@noindent
-The first line is the @code{uh} macro being called with 3 arguments,
-@samp{The}, @samp{Mouse}, and @samp{Problem}.  The latter two have the
-same effect of calling the @code{uh} macro with one argument, @samp{The
-Mouse Problem}.@footnote{The last solution, i.e., using escaped spaces,
-is ``classical'' in the sense that it can be found in most @code{troff}
-documents.  Nevertheless, it is not optimal in all situations, since
-@w{@samp{\ }} inserts a fixed-width, non-breaking space character that
-can't stretch.  @code{gtroff} provides a different command @code{\~} to
-insert a stretchable, non-breaking space.}
-
-@cindex @code{"}, in a macro argument
-@cindex double quote, in a macro argument
-A double quote that isn't preceded by a space doesn't start a macro
-argument.  If not closing a string, it is printed literally.
-
-For example,
+@cindex blank line trap (@code{blm})
+@cindex blank line macro (@code{blm})
+If you assign an empty blank line trap, you can separate macro
+definitions (or any input lines) with blank lines.
 
 @Example
-.xxx a" "b c" "de"fg"
-@endExample
-
-@noindent
-has the arguments @samp{a"}, @w{@samp{b c}}, @samp{de}, and @samp{fg"}.
-Don't rely on this obscure behaviour!
+.de do-nothing
+..
+.blm do-nothing  \" activate blank line trap
 
-There are two possibilities to get a double quote reliably.
+.de center
+.  if \\n.br \
+.    br
+.  ce \\$1
+..
 
-@itemize @bullet
-@item
-Enclose the whole argument with double quotes and use two consecutive
-double quotes to represent a single one.  This traditional solution has
-the disadvantage that double quotes don't survive argument expansion
-again if called in compatibility mode (using the @option{-C} option of
-@code{groff}):
 
-@Example
-.de xx
-.  tm xx: `\\$1' `\\$2' `\\$3'
-.
-.  yy "\\$1" "\\$2" "\\$3"
+.de right-align
+.@arrow{}if \\n.br \
+.@arrow{}@arrow{}br
+.@arrow{}rj \\$1
 ..
-.de yy
-.  tm yy: `\\$1' `\\$2' `\\$3'
-..
-.xx A "test with ""quotes""" .
-    @result{} xx: `A' `test with "quotes"' `.'
-    @result{} yy: `A' `test with ' `quotes""'
-@endExample
-
-@noindent
-If not in compatibility mode, you get the expected result
 
-@Example
-xx: `A' `test with "quotes"' `.'
-yy: `A' `test with "quotes"' `.'
+.blm             \" deactivate blank line trap
 @endExample
 
-@noindent
-since @code{gtroff} preserves the input level.
-
-@item
-Use the double quote glyph @code{\(dq}.  This works with and without
-compatibility mode enabled since @code{gtroff} doesn't convert
-@code{\(dq} back to a double quote input character.
-
-Note that this method won't work with Unix @code{troff} in general since
-the glyph `dq' isn't defined normally.
-@end itemize
-
-@cindex @code{ds} request, and double quotes
-Double quotes in the @code{ds} request are handled differently.
-@xref{Strings}, for more details.
+@xref{Blank Line Traps}.
+@c END Keep (roughly) parallel with section "Requests" of groff(7).
 
 @c ---------------------------------------------------------------------
 
-@node Macros, Escapes, Requests, Embedded Commands
-@subsection Macros
-@cindex macros
+@need 1000
+@node Calling Macros, Using Escape Sequences, Invoking Requests, Formatter Instructions
+@subsection Calling Macros
+@cindex calling macros
+@cindex macro arguments
+@cindex arguments to macros
 
-@code{gtroff} has a @dfn{macro} facility for defining a series of lines
-that can be invoked by name.  They are called in the same manner as
-requests -- arguments also may be passed basically in the same manner.
+If a macro of the desired name does not exist when called, it is
+created, assigned an empty definition, and a warning in category
+@samp{mac} is emitted.  Calling an undefined macro @emph{does} end a
+macro definition naming it as its end macro (@pxref{Writing Macros}).
 
-@xref{Writing Macros}, and @ref{Request and Macro Arguments}.
+@cindex spaces, in a macro argument
+To embed spaces @emph{within} a macro argument, enclose the argument in
+neutral double quotes @code{"}.  Horizontal motion escape sequences are
+sometimes a better choice for arguments to be formatted as text.
 
-@c ---------------------------------------------------------------------
+Consider calls to a hypothetical section heading macro @samp{uh}.
 
-@node Escapes,  , Macros, Embedded Commands
-@subsection Escapes
-@cindex escapes
+@Example
+.uh The Mouse Problem
+.uh "The Mouse Problem"
+.uh The\~Mouse\~Problem
+.uh The\ Mouse\ Problem
+@endExample
 
-Escapes may occur anywhere in the input to @code{gtroff}.  They usually
-begin with a backslash and are followed by a single character, which
-indicates the function to be performed.  The escape character can be
-changed; see @ref{Character Translations}.
+@cindex @code{\~}, difference from @code{\@key{SP}}
+@cindex @code{\@key{SP}}, difference from @code{\~}
+@noindent
+The first line calls @code{uh} with three arguments: @samp{The},
+@samp{Mouse}, and @samp{Problem}.  The remainder call the @code{uh}
+macro with one argument, @samp{The Mouse Problem}.  The last solution,
+using escaped spaces, can be found in documents prepared for
+@acronym{AT&T} @code{troff}.  It can cause surprise when text is
+adjusted, because @code{\@key{SP}} inserts a @emph{fixed-width},
+non-breaking space.  GNU @code{troff}'s @code{\~} escape sequence
+inserts an adjustable, non-breaking space.@footnote{@code{\~} is fairly
+portable; see @ref{Other Differences}.}
+
+@cindex @code{"}, embedding in a macro argument
+@cindex double quote, embedding in a macro argument
+@cindex @code{\}, embedding in a macro argument
+@cindex backslash, embedding in a macro argument
+The foregoing raises the question of how to embed neutral double quotes
+or backslashes in macro arguments when @emph{those} characters are
+desired as literals.  In GNU @code{troff}, the special character escape
+sequence @code{\rs} produces a backslash and @code{\dq} a neutral
+double quote.
+
+In GNU @code{troff}'s @acronym{AT&T} compatibility mode, these
+characters remain available as @code{\(rs} and @code{\(dq},
+respectively.  @acronym{AT&T} @code{troff} did not consistently define
+these special characters,
+@c It seems that AT&T troff never recognized \(rs, though DWB 3.3
+@c defined \(bs as an alias of "\" on its "Latin1" device, in
+@c deliberate(?) collision with the Bell System logo identifier.  It
+@c also defined \(dq for several devices (pcl, Latin1, nroff, ...) along
+@c with \(aq.
+but its descendants can be made to support them.  @xref{Device and Font
+Description Files}.
+
+If even that is not feasible, options remain.  To obtain a literal
+escape character in a macro argument, you can simply type it if you
+change or disable the escape character first.  @xref{Using Escape
+Sequences}.  Otherwise, you must escape the escape character repeatedly
+to a context-dependent extent.  @xref{Copy Mode}.
+
+For the (neutral) double quote, you have recourse to an obscure
+syntactical feature of @acronym{AT&T} @code{troff}.  Because a double
+quote can begin a macro argument, the formatter keeps track of whether
+the current argument was started thus, and doesn't require a space after
+the double quote that ends it.@footnote{Strictly, you can neglect to
+close the last quoted macro argument, relying on the end of the control
+line to do so.   We consider this lethargic practice poor style.}  In
+the argument list to a macro, a double quote that @emph{isn't} preceded
+by a space @emph{doesn't} start a macro argument.  If not preceded by a
+double quote that began an argument, this double quote becomes part of
+the argument.  Furthermore, within a quoted argument, a pair of adjacent
+double quotes becomes a literal double quote.
+
+@Example
+.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+.. \" 4 backslashes on the next line
+.eq a" "b c" "de"f\\\\g" h""i "j""k"
+    @error{} arg1:a" arg2:b c arg3:de
+    @error{} arg4:f\g" arg5:h""i arg6:j"k
+@endExample
+
+Apart from the complexity of the rules, this traditional solution has
+the disadvantage that double quotes don't survive repeated argument
+expansion in @acronym{AT&T} @code{troff} or GNU @code{troff}'s
+compatibility mode.  This can frustrate efforts to pass such arguments
+intact through multiple macro calls.
 
-Escape sequences that require an identifier as a parameter accept three
-possible syntax forms.
+@Example
+.cp 1
+.de eq
+.  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+.  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+..
+.de xe
+.  eq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6
+.. \" 8 backslashes on the next line
+.xe a" "b c" "de"f\\\\\\\\g" h""i "j""k"
+    @error{} arg1:a" arg2:b arg3:c
+    @error{} arg4:de arg5:f\g" arg6:h""i
+@endExample
+
+@cindex input level
+@cindex level, input
+@cindex interpolation depth
+@cindex depth, interpolation
+Outside of compatibility mode, GNU @code{troff} doesn't exhibit this
+problem because it tracks the nesting depth of interpolations.
+@xref{Implementation Differences}.
 
-@itemize @bullet
-@item
-The next single character is the identifier.
+@c ---------------------------------------------------------------------
 
-@cindex @code{(}, starting a two-character identifier
-@item
-If this single character is an opening parenthesis, take the following
-two characters as the identifier.  Note that there is no closing
-parenthesis after the identifier.
+@c BEGIN Keep (roughly) parallel with section "Using escape sequences"
+@c of groff(7).
+@node Using Escape Sequences, Delimiters, Calling Macros, Formatter Instructions
+@subsection Using Escape Sequences
+@cindex using escape sequences
+@cindex escape sequences
+
+Whereas requests must occur on control lines, escape sequences can occur
+intermixed with text and may appear in arguments to requests, macros,
+and other escape sequences.
+@esindex \
+An escape sequence is introduced by the escape character, a backslash
+@code{\} (but see the @code{ec} request below).  The next character
+selects the escape's function.
+
+Escape sequences vary in length.  Some take an argument, and of those,
+some have different syntactical forms for a one-character,
+two-character, or arbitrary-length argument.  Others accept @emph{only}
+an arbitrary-length argument.  In the former scheme, a one-character
+argument follows the function character immediately, an opening
+parenthesis @samp{(} introduces a two-character argument (no closing
+parenthesis is used), and an argument of arbitrary length is enclosed in
+brackets @samp{}.  In the latter scheme, the user selects a delimiter
+character.  A few escape sequences are idiosyncratic, and support both
+of the foregoing conventions (@code{\s}), designate their own
+termination sequence (@code{\?}), consume input until the next newline
+(@code{\!}, @code{\"}, @code{\#}), or support an additional modifier
+character (@code{\s} again, and @code{\n}).  As with requests, use of
+some escape sequences in source documents may interact poorly with a
+macro package you use; consult its documentation to learn of ``safe''
+sequences or alternative facilities it provides to achieve the desired
+result.
 
-@cindex @code{}, starting an identifier
-@cindex @code{}, ending an identifier
-@item
-If this single character is an opening bracket, take all characters
-until a closing bracket as the identifier.
-@end itemize
+If an escape character is followed by a character that does not
+identify a defined operation, the escape character is ignored (producing
+a diagnostic of the @samp{escape} warning category, which is not enabled
+by default) and the following character is processed normally.
+
+@Example
+$ groff -Tps -ww
+.nr N 12
+.ds co white
+.ds animal elephant
+I have \fI\nN \*(co \*animals,\f
+said \P.\&\~Pseudo Pachyderm.
+    @error{} warning: escape character ignored before 'P'
+    @result{} I have @slanted{12 white elephants,} said P. Pseudo Pachyderm.
+@endExample
+
+Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.  This rule affords flexibility in
+using escape sequences to construct parameters to other escape
+sequences.
+@c END Keep (roughly) parallel with section "Escape sequences" of
+@c groff(7).
+
+@Example
+.ds family C\" Courier
+.ds style I\" oblique
+Choice a typeface \f(\*family\*stylewisely.
+    @result{} Choose a typeface @slanted{wisely.}
+@endExample
 
 @noindent
-Examples:
+In the above, the syntax form @samp{\f(} accepts only two characters for
+an argument; the example works because the subsequent escape sequences
+are interpolated before the selection escape sequence argument is
+processed, and strings @code{family} and @code{style} interpolate one
+character each.@footnote{The omission of spaces before the comment
+escape sequences is necessary; see @ref{Strings}.}
+
+@c @need 1000
+The escape character is nearly always interpreted when encountered; it
+is therefore desirable to have a way to interpolate it, disable it, or
+change it.
+
+@cindex formatting the escape character (@code{\e})
+@cindex escape character, formatting (@code{\e})
+@Defesc {\\e, , , }
+Interpolate the escape character.
+@endDefesc
 
-@Example
-\fB
-\n(XX
-\*TeX
-@endExample
+@cindex formatting a backslash glyph (@code{\rs})
+@cindex backslash glyph, formatting (@code{\rs})
+The @code{\rs} special character escape sequence formats a backslash
+glyph.  In macro and string definitions, the input sequences @code{\\}
+and @code{\E} defer interpretation of escape sequences.  @xref{Copy
+Mode}.
 
-@cindex @code{'}, delimiting arguments
-@cindex argument delimiting characters
-@cindex characters, argument delimiting
-@cindex delimiting characters for arguments
-Other escapes may require several arguments and/or some special format.
-In such cases the argument is traditionally enclosed in single quotes
-(and quotes are always used in this manual for the definitions of escape
-sequences).  The enclosed text is then processed according to what that
-escape expects.  Example:
+@Defreq {eo, }
+@cindex disabling @code{\} (@code{eo})
+@cindex @code{\}, disabling (@code{eo})
+Disable the escape mechanism except in copy mode.  Once this request is
+invoked, no input character is recognized as starting an escape
+sequence in interpretation mode.
+@endDefreq
 
-@Example
-\l'1.5i\(bu'
-@endExample
+@Defreq {ec, @Var{o}}
+@cindex escape character, changing (@code{ec})
+@cindex character, escape, changing (@code{ec})
+Recognize the ordinary character@tie{}@var{o} as the escape character.
+If@tie{}@var{o} is absent or invalid, the default escape character
+@samp{\} is selected.
+@endDefreq
 
-@cindex @code{\o}, possible quote characters
-@cindex @code{\b}, possible quote characters
-@cindex @code{\X}, possible quote characters
-Note that the quote character can be replaced with any other character
-that does not occur in the argument (even a newline or a space
-character) in the following escapes: @code{\o}, @code{\b}, and
-@code{\X}.  This makes e.g.
+Switching escape sequence interpretation off to define a macro and back
+on afterward can obviate the need to double the escape character within
+the definition.  @xref{Writing Macros}.  This technique is not available
+if your macro needs to interpolate values at the time it is
+@emph{defined}---but many do not.
 
 @Example
-A caf
-\o
-e\'
+.\" simplified `BR` macro from the man(7) macro package
+.eo
+.de BR
+.  ds result \&
+.  while (\n.$ >= 2) \@{\
+.    as result \fB\$1\fR\$2\"
+.    shift 2
+.  \@}
+.  if \n.$ .as result \fB\$1\"
+\*result
+.  rm result
+.  ft R
+..
+.ec
+@endExample
 
+@DefreqList {ecs, }
+@DefreqListEndx {ecr, }
+The @code{ecs} request stores the escape character for recall with
+@code{ecr}.  @code{ecr} sets the escape character to @samp{\} if none
+has been saved.
+
+Use these requests together to temporarily change the escape character.
+@endDefreq
+
+Using a different escape character, or disabling it, when calling macros
+not under your control will likely cause errors, since GNU @code{troff}
+has no mechanism to ``intern'' macros---that is, to convert a macro
+definition into a form independent of its
+representation.@footnote{@TeX{} does have such a mechanism.}  When a
+macro is called, its contents are interpreted literally.
+@c XXX: all that stuff mapped into the C0 and C1 controls seems pretty
+@c close to an interning mechanism to me, though... --GBR
+
+@c XXX: Motivation?  Why are we directing the reader to these?
+@c @xref{Diversions}, and @ref{Identifiers}.
+
+@c BEGIN Keep (roughly) parallel with subsection "Delimiters" of
+@c groff(7).
+@node Delimiters, , Using Escape Sequences, Formatter Instructions
+@subsection Delimiters
+@cindex delimiting escape sequence arguments
+@cindex escape sequence argument delimiters
+@cindex delimiters, for escape sequence arguments
+@cindex arguments, to escape sequences, delimiting
+
+@cindex @code{'}, as delimiter
+@cindex @code{"}, as delimiter
+Some escape sequences that require parameters use delimiters.  The
+neutral apostrophe @code{'} is a popular choice and shown in this
+document.  The neutral double quote @code{"} is also commonly seen.
+Letters, numerals, and leaders can be used.  Punctuation characters
+are likely better choices, except for those defined as infix operators
+in numeric expressions; see below.
+
+@Example
+\l'1.5i\bu' \" draw 1.5 inches of bullet glyphs
+@endExample
+
+@cindex @code{\%}, as delimiter
+@cindex @code{\@key{SP}}, as delimiter
+@cindex @code{\|}, as delimiter
+@cindex @code{\^}, as delimiter
+@cindex @code{\@{}, as delimiter
+@cindex @code{\@}}, as delimiter
+@cindex @code{\'}, as delimiter
+@cindex @code{\`}, as delimiter
+@cindex @code{\-}, as delimiter
+@cindex @code{\_}, as delimiter
+@cindex @code{\!}, as delimiter
+@cindex @code{\?}, as delimiter
+@cindex @code{\)}, as delimiter
+@cindex @code{\/}, as delimiter
+@cindex @code{\,}, as delimiter
+@cindex @code{\&}, as delimiter
+@cindex @code{\:}, as delimiter
+@cindex @code{\~}, as delimiter
+@cindex @code{\0}, as delimiter
+@cindex @code{\a}, as delimiter
+@cindex @code{\c}, as delimiter
+@cindex @code{\d}, as delimiter
+@cindex @code{\e}, as delimiter
+@cindex @code{\E}, as delimiter
+@cindex @code{\p}, as delimiter
+@cindex @code{\r}, as delimiter
+@cindex @code{\t}, as delimiter
+@cindex @code{\u}, as delimiter
+The following escape sequences don't take arguments and thus are allowed
+as delimiters:
+@code{\@key{SP}}, @code{\%}, @code{\|}, @code{\^}, @code{\@{},
+@code{\@}}, @code{\'}, @code{\`}, @code{\-}, @code{\_}, @code{\!},
+@code{\?}, @code{\)}, @code{\/}, @code{\,}, @code{\&}, @code{\:},
+@code{\~}, @code{\0}, @code{\a}, @code{\c}, @code{\d}, @code{\e},
+@code{\E}, @code{\p}, @code{\r}, @code{\t}, and @code{\u}.  However,
+using them this way is discouraged; they can make the input confusing to
+read.
+
+@cindex @code{\A}, delimiters allowed by
+@cindex @code{\b}, delimiters allowed by
+@cindex @code{\o}, delimiters allowed by
+@cindex @code{\w}, delimiters allowed by
+@cindex @code{\X}, delimiters allowed by
+@cindex @code{\Z}, delimiters allowed by
+@cindex newline, as delimiter
+A few escape sequences,
+@code{\A},
+@code{\b},
+@code{\o},
+@code{\w},
+@code{\X},
+and @code{\Z}, accept a newline as a delimiter.  Newlines that serve
+as delimiters continue to be recognized as input line terminators.
 
+@Example
+A caf\o
+e$aa
 in Paris
-  @result{} A café in Paris
+    @result{} A café in Paris
 @endExample
 
 @noindent
-possible, but it is better not to use this feature to avoid confusion.
+Use of newlines as delimiters in escape sequences is also discouraged.
 
-@cindex @code{\%}, used as delimiter
-@cindex @code{\@key{SP}}, used as delimiter
-@cindex @code{\|}, used as delimiter
-@cindex @code{\^}, used as delimiter
-@cindex @code{\@{}, used as delimiter
-@cindex @code{\@}}, used as delimiter
-@cindex @code{\'}, used as delimiter
-@cindex @code{\`}, used as delimiter
-@cindex @code{\-}, used as delimiter
-@cindex @code{\_}, used as delimiter
-@cindex @code{\!}, used as delimiter
-@cindex @code{\?}, used as delimiter
-@cindex @code{$}, used as delimiter
-@cindex @code{\/}, used as delimiter
-@cindex @code{\,}, used as delimiter
-@cindex @code{\&}, used as delimiter
-@ifnotinfo
-@cindex @code{\:}, used as delimiter
-@end ifnotinfo
-@ifinfo
-@cindex @code{\@r{<colon>}}, used as delimiter
-@end ifinfo
-@cindex @code{\~}, used as delimiter
-@cindex @code{\0}, used as delimiter
-@cindex @code{\a}, used as delimiter
-@cindex @code{\c}, used as delimiter
-@cindex @code{\d}, used as delimiter
-@cindex @code{\e}, used as delimiter
-@cindex @code{\E}, used as delimiter
-@cindex @code{\p}, used as delimiter
-@cindex @code{\r}, used as delimiter
-@cindex @code{\t}, used as delimiter
-@cindex @code{\u}, used as delimiter
-The following escape sequences (which are handled similarly to
-characters since they don't take a parameter) are also allowed as
-delimiters: @code{\%}, @w{@samp{\ }}, @code{\|}, @code{\^}, @code{\@{},
-@code{\@}}, @code{\'}, @code{\`}, @code{\-}, @code{\_}, @code{\!},
-@code{\?}, @code{\)}, @code{\/}, @code{\,}, @code{\&}, @code{\:},
-@code{\~}, @code{\0}, @code{\a}, @code{\c}, @code{\d}, @code{\e},
-@code{\E}, @code{\p}, @code{\r}, @code{\t}, and @code{\u}.  Again, don't
-use these if possible.
-
-@cindex @code{\A}, allowed delimiters
-@cindex @code{\B}, allowed delimiters
-@cindex @code{\Z}, allowed delimiters
-@cindex @code{\C}, allowed delimiters
-@cindex @code{\w}, allowed delimiters
-No newline characters as delimiters are allowed in the following
-escapes: @code{\A}, @code{\B}, @code{\Z}, @code{\C}, and @code{\w}.
-
-@cindex @code{\D}, allowed delimiters
-@cindex @code{\h}, allowed delimiters
-@cindex @code{\H}, allowed delimiters
-@cindex @code{\l}, allowed delimiters
-@cindex @code{\L}, allowed delimiters
-@cindex @code{\N}, allowed delimiters
-@cindex @code{\R}, allowed delimiters
-@cindex @code{\s}, allowed delimiters
-@cindex @code{\S}, allowed delimiters
-@cindex @code{\v}, allowed delimiters
-@cindex @code{\x}, allowed delimiters
-Finally, the escapes @code{\D}, @code{\h}, @code{\H}, @code{\l},
-@code{\L}, @code{\N}, @code{\R}, @code{\s}, @code{\S}, @code{\v}, and
-@code{\x} can't use the following characters as delimiters:
+@cindex @code{\D}, delimiters allowed by
+@cindex @code{\h}, delimiters allowed by
+@cindex @code{\H}, delimiters allowed by
+@cindex @code{\l}, delimiters allowed by
+@cindex @code{\L}, delimiters allowed by
+@cindex @code{\N}, delimiters allowed by
+@cindex @code{\R}, delimiters allowed by
+@cindex @code{\s}, delimiters allowed by
+@cindex @code{\S}, delimiters allowed by
+@cindex @code{\v}, delimiters allowed by
+@cindex @code{\x}, delimiters allowed by
+Finally, the escape sequences @code{\D}, @code{\h}, @code{\H},
+@code{\l}, @code{\L}, @code{\N}, @code{\R}, @code{\s}, @code{\S},
+@code{\v}, and @code{\x} prohibit many delimiters.
 
 @itemize @bullet
 @item
-@cindex numbers, and delimiters
-@cindex digits, and delimiters
-The digits @code{0}-@code{9}.
+@cindex numerals, as delimiters
+@cindex digits, as delimiters
+@cindex @code{.}, as delimiter
+@cindex decimal point, as delimiter
+@cindex dot, as delimiter
+the numerals @code{0}-@code{9} and the decimal point @code{.}
 
 @item
 @cindex operators, as delimiters
@@ -5948,193 +7153,179 @@
 @end ifinfo
 @cindex @code{(}, as delimiter
 @cindex @code{)}, as delimiter
-@cindex @code{.}, as delimiter
-The (single-character) operators @samp{+-/*%<>=&:().}.
-
-@item
-@cindex space character
-@cindex character, space
-@cindex tab character
-@cindex character, tab
-@cindex newline character
-@cindex character, newline
-The space, tab, and newline characters.
+the (single-character) operators @samp{+-/*%<>=&:()}
 
 @item
-@cindex @code{\%}, used as delimiter
-@ifnotinfo
-@cindex @code{\:}, used as delimiter
-@end ifnotinfo
-@ifinfo
-@cindex @code{\@r{<colon>}}, used as delimiter
-@end ifinfo
-@cindex @code{\@{}, used as delimiter
-@cindex @code{\@}}, used as delimiter
-@cindex @code{\'}, used as delimiter
-@cindex @code{\`}, used as delimiter
-@cindex @code{\-}, used as delimiter
-@cindex @code{\_}, used as delimiter
-@cindex @code{\!}, used as delimiter
-@cindex @code{\/}, used as delimiter
-@cindex @code{\c}, used as delimiter
-@cindex @code{\e}, used as delimiter
-@cindex @code{\p}, used as delimiter
-All escape sequences except @code{\%}, @code{\:}, @code{\@{},
+@cindex space character, as delimiter
+@cindex tab character, as delimiter
+the space and tab characters
+
+@item
+@cindex @code{\%}, as delimiter
+@cindex @code{\:}, as delimiter
+@cindex @code{\@{}, as delimiter
+@cindex @code{\@}}, as delimiter
+@cindex @code{\'}, as delimiter
+@cindex @code{\`}, as delimiter
+@cindex @code{\-}, as delimiter
+@cindex @code{\_}, as delimiter
+@cindex @code{\!}, as delimiter
+@cindex @code{\/}, as delimiter
+@cindex @code{\c}, as delimiter
+@cindex @code{\e}, as delimiter
+@cindex @code{\p}, as delimiter
+any escape sequences other than @code{\%}, @code{\:}, @code{\@{},
 @code{\@}}, @code{\'}, @code{\`}, @code{\-}, @code{\_}, @code{\!},
-@code{\/}, @code{\c}, @code{\e}, and @code{\p}.
+@code{\/}, @code{\c}, @code{\e}, and @code{\p}
 @end itemize
 
-@cindex printing backslash (@code{\\}, @code{\e}, @code{\E}, @code{\rs})
-@cindex backslash, printing (@code{\\}, @code{\e}, @code{\E}, @code{\rs})
-To have a backslash (actually, the current escape character) appear in
-the output several escapes are defined: @code{\\}, @code{\e} or
-@code{\E}.  These are very similar, and only differ with respect to
-being used in macros or diversions.  @xref{Character Translations}, for
-an exact description of those escapes.
-
-@xref{Implementation Differences}, @ref{Copy-in Mode}, and
-@ref{Diversions}, @ref{Identifiers}, for more information.
+Delimiter syntax is complex and flexible primarily for historical
+reasons; the foregoing restrictions need be kept in mind mainly when
+using @code{groff} in @acronym{AT&T} compatibility mode.  GNU
+@code{troff} keeps track of the nesting depth of escape sequence
+interpolations, so the only characters you need to avoid using as
+delimiters are those that appear in the arguments you input, not any
+that result from interpolation. Typically, @code{'} works fine.
+@xref{Implementation Differences}.
 
-@menu
-* Comments::
-@end menu
+@Example
+$ groff -Tps
+.de Mw
+.  nr wd \w'\\$1'
+.  tm "\\$1" is \\n(wd units wide.
+..
+.Mw Wet'suwet'en
+.Mw Wet+200i
+.cp 1 \" turn on compatibility mode
+.Mw Wet'suwet'en
+.Mw Wet'
+.Mw Wet+200i
+    @error{} "Wet'suwet'en" is 54740 units wide.
+    @error{} "Wet'+200i" is 42610 units wide.
+    @error{} "Wet'suwet'en" is 15860 units wide.
+    @error{} "Wet'" is 15860 units wide.
+    @error{} "Wet'+200i" is 14415860 units wide.
+@endExample
+
+We see here that in compatibility mode, the part of the argument after
+the @code{'} delimiter escapes from its context and, if nefariously
+crafted, influences the computation of the @var{wd} register's value in
+a surprising way.
+@c END Keep (roughly) parallel with subsection " Delimiters" of
+@c groff(7).
 
-@node Comments,  , Escapes, Escapes
-@subsubsection Comments
+@node Comments, Registers, Formatter Instructions, GNU troff Reference
+@section Comments
 @cindex comments
 
-Probably one of the most@footnote{Unfortunately, this is a lie.  But
-hopefully future @code{gtroff} hackers will believe it @code{:-)}}
-common forms of escapes is the comment.
+One of the most common forms of escape sequence is the
+comment.@footnote{This claim may be more aspirational than descriptive.}
 
 @Defesc {\\", , , }
-Start a comment.  Everything to the end of the input line is ignored.
+Start a comment.  Everything up to the next newline is ignored.
 
 This may sound simple, but it can be tricky to keep the comments from
-interfering with the appearance of the final output.
-
+interfering with the appearance of the output.
 @cindex @code{ds}, @code{ds1} requests, and comments
 @cindex @code{as}, @code{as1} requests, and comments
-If the escape is to the right of some text or a request, that portion of
-the line is ignored, but the space leading up to it is noticed by
-@code{gtroff}.  This only affects the @code{ds} and @code{as} request
-and its variants.
+If the escape sequence is to the right of some text or a request, that
+portion of the line is ignored, but spaces preceding it are processed
+normally by GNU @code{troff}.  This affects only the @code{ds} and
+@code{as} requests and their variants.
 
 @cindex tabs, before comments
 @cindex comments, lining up with tabs
-One possibly irritating idiosyncracy is that tabs must not be used to
-line up comments.  Tabs are not treated as whitespace between the
-request and macro arguments.
+One possibly irritating idiosyncrasy is that tabs should not be used to
+vertically align comments in the source document.  Tab characters are
+not treated as separators between a request name and its first argument,
+nor between arguments.
 
 @cindex undefined request
 @cindex request, undefined
 A comment on a line by itself is treated as a blank line, because after
-eliminating the comment, that is all that remains:
+eliminating the comment, that is all that remains.
 
 @Example
 Test
 \" comment
 Test
+    @result{} Test
+    @result{}
+    @result{} Test
 @endExample
 
-@noindent
-produces
-
-@Example
-Test
-
-Test
-@endExample
-
-To avoid this, it is common to start the line with @code{.\"}, which
-causes the line to be treated as an undefined request and thus ignored
-completely.
+To avoid this, it is common to combine the empty request with the
+comment escape sequence as @samp{.\"}, causing the input line to be
+ignored.
 
 @cindex @code{'}, as a comment
-Another commenting scheme seen sometimes is three consecutive single
-quotes (@code{'''}) at the beginning of a line.  This works, but
-@code{gtroff} gives a warning about an undefined macro (namely
-@code{''}), which is harmless, but irritating.
+Another commenting scheme sometimes seen is three consecutive single
+quotes (@code{'''}) at the beginning of a line.  This works, but GNU
+@code{troff} emits a warning diagnostic (if enabled) about an undefined
+macro (namely @samp{''}).
 @endDefesc
 
 @Defesc {\\#, , , }
-To avoid all this, @code{gtroff} has a new comment mechanism using the
-@code{\#} escape.  This escape works the same as @code{\"} except that
-the newline is also ignored:
+Start a comment; everything up to and including the next newline is
+ignored.  This @code{groff} extension was introduced to avoid the
+problems described above.
 
 @Example
 Test
 \# comment
 Test
+    @result{} Test Test
 @endExample
-
-@noindent
-produces
-
-@Example
-Test Test
-@endExample
-
-@noindent
-as expected.
 @endDefesc
 
 @Defreq {ig, @Var{end}}
-Ignore all input until @code{gtroff} encounters the macro named
-@code{.}@var{end} on a line by itself (or @code{..} if @var{end} is not
-specified).  This is useful for commenting out large blocks of text:
-
-@Example
-text text text...
-.ig
-This is part of a large block
-of text that has been
-temporarily(?) commented out.
-
-We can restore it simply by removing
-the .ig request and the ".." at the
-end of the block.
+Ignore input until, in the current conditional block (if
+any),@footnote{@xref{Conditional Blocks}.} the macro @var{end} is called
+at the start of a control line, or the control line @samp{..} is
+encountered if @var{end} is not specified.  @code{ig} is parsed as if it
+were a macro definition, but its contents are discarded, not
+stored.@footnote{Exception: auto-incrementing registers defined outside
+the ignored region @emph{will} be modified if interpolated with
+@code{\n±} inside it.  @xref{Auto-increment}.}
+
+@c Wrap example at 56 columns.
+@Example
+hand\c
+.de TX
+fasting
 ..
-More text text text...
+.ig TX
+This is part of a large block of input that has been
+temporarily(?) commented out.
+We can restore it simply by removing the .ig request and
+the call of its end macro.
+.TX
 @endExample
-
-@noindent
-produces
-
 @Example
-text text text@dots{}  More text text text@dots{}
+    @result{} handfasting
 @endExample
-
-@noindent
-Note that the commented-out block of text does not cause a break.
-
-@cindex @code{ig} request, and copy-in mode
-@cindex copy-in mode, and @code{ig} request
-@cindex mode, copy-in, and @code{ig} request
-@cindex @code{ig} request, and auto-increment
-@cindex auto-increment, and @code{ig} request
-The input is read in copy-mode; auto-incremented registers @emph{are}
-affected (@pxref{Auto-increment}).
 @endDefreq
 
 
 @c =====================================================================
 
-@node Registers, Manipulating Filling and Adjusting, Embedded Commands, gtroff Reference
+@c BEGIN Keep (roughly) parallel with subsection "Registers" of
+@c groff(7).
+@node Registers, Manipulating Filling and Adjustment, Formatter Instructions, GNU troff Reference
 @section Registers
 @cindex registers
 
-Numeric variables in @code{gtroff} are called @dfn{registers}.  There
-are a number of built-in registers, supplying anything from the date to
-details of formatting parameters.
-
-@xref{Identifiers}, for details on register identifiers.
+In the @code{roff} language, numbers can be stored in @dfn{registers}.
+Many built-in registers exist, supplying anything from the date to
+details of formatting parameters.  You can also define your own.
+@xref{Identifiers}, for information on constructing a valid name for a
+register.
 
 @menu
 * Setting Registers::
 * Interpolating Registers::
 * Auto-increment::
-* Assigning Formats::
+* Assigning Register Formats::
 * Built-in Registers::
 @end menu
 
@@ -6145,36 +7336,32 @@
 @cindex setting registers (@code{nr}, @code{\R})
 @cindex registers, setting (@code{nr}, @code{\R})
 
-Define or set registers using the @code{nr} request or the @code{\R}
-escape.
-
-Although the following requests and escapes can be used to create
-registers, simply using an undefined register will cause it to be
-set to zero.
+Define registers and update their values with the @code{nr} request or
+the @code{\R} escape sequence.
 
 @DefreqList {nr, ident value}
-@DefescListEndx {\\R, ', ident value, '}
-Set number register @var{ident} to @var{value}.  If @var{ident} doesn't
-exist, @code{gtroff} creates it.
-
-The argument to @code{\R} usually has to be enclosed in quotes.
-@xref{Escapes}, for details on parameter delimiting characters.
-
-The @code{\R} escape doesn't produce an input token in @code{gtroff};
-in other words, it vanishes completely after @code{gtroff} has
-processed it.
-
-For example, the following two lines are equivalent:
+@DefescListEndx {\\R, @code{'}, ident value, @code{'}}
+Set register @var{ident} to @var{value}.  If @var{ident} doesn't exist,
+GNU @code{troff} creates it.  In the @code{\R} escape sequence, the
+delimiter need not be a neutral apostrophe; see @ref{Delimiters}.  It
+also does not produce an input token in GNU @code{troff}.  @xref{Gtroff
+Internals}.
 
 @Example
 .nr a (((17 + (3 * 4))) % 4)
-\R'a (((17 + (3 * 4))) % 4)'
-    @result{} 1
+\na
+.\R'a (((17 + (3 * 4))) % 4)'
+\na
+    @result{} 1 1
 @endExample
 
-Note that the complete transparency of @code{\R} can cause surprising
-effects if you use number registers like @code{.k}, which get evaluated
-at the time they are accessed.
+(Later, we will discuss additional forms of @code{nr} and @code{\R} that
+can change a register's value after it is dereferenced but before it is
+interpolated.  @xref{Auto-increment}.)
+
+The complete transparency of @code{\R} can cause surprising effects if
+you use registers like @code{.k}, which get evaluated at the time they
+are accessed.
 
 @Example
 .ll 1.6i
@@ -6190,33 +7377,35 @@
     @result{} :k == 15000
 @endExample
 
-If you process this with the @sc{PostScript} device (@code{-Tps}),
-there will be a line break eventually after @code{ggg} in both input
-lines.  However, after processing the space after @code{ggg}, the
-partially collected line is not overfull yet, so @code{troff}
-continues to collect input until it sees the space (or in this case,
-the newline) after @code{hhh}.  At this point, the line is longer
-than the line length, and the line gets broken.
-
-In the first input line, since the @code{\R} escape leaves no traces,
-the check for the overfull line hasn't been done yet at the point where
-@code{\R} gets handled, and you get a value for the @code{.k} number
-register that is even greater than the current line length.
+If you process this with the PostScript device (@code{-Tps}), there will
+be a line break eventually after @code{ggg} in both input lines.
+However, after processing the space after @code{ggg}, the partially
+collected line is not overfull yet, so GNU @code{troff} continues to
+collect input until it sees the space (or in this case, the newline)
+after @code{hhh}.  At this point, the line is longer than the line
+length, and the line gets broken.
+
+In the first input line, since the @code{\R} escape sequence leaves no
+traces, the check for the overfull line hasn't been done yet at the
+point where @code{\R} gets handled, and you get a value for the
+@code{.k} register that is even greater than the current line length.
 
-In the second input line, the insertion of @code{\h'0'} to emit an
-invisible zero-width space forces @code{troff} to check the line length,
+In the second input line, the insertion of @code{\h'0'} to cause a
+zero-width motion forces GNU @code{troff} to check the line length,
 which in turn causes the start of a new output line.  Now @code{.k}
 returns the expected value.
 @endDefreq
 
-Both @code{nr} and @code{\R} have two additional special forms to
+@code{nr} and @code{\R} each have two additional special forms to
 increment or decrement a register.
 
 @DefreqList {nr, ident @t{+}@Var{value}}
 @DefreqItem {nr, ident @t{-}@Var{value}}
-@DefescItemx {\\R, ', ident @t{+}value, '}
-@DefescListEnd {\\R, ', ident @t{-}value, '}
-Increment (decrement) register @var{ident} by @var{value}.
+@DefescItemx {\\R, @code{'}, ident @t{+}value, @code{'}}
+@DefescListEnd {\\R, @code{'}, ident @t{-}value, @code{'}}
+Increment (decrement) register @var{ident} by @var{value}.  In the
+@code{\R} escape sequence, the delimiter need not be a neutral
+apostrophe; see @ref{Delimiters}.
 
 @Example
 .nr a 1
@@ -6226,8 +7415,12 @@
 @endExample
 
 @cindex negating register values
-To assign the negated value of a register to another register, some care
-must be taken to get the desired result:
+A leading minus sign in @var{value} is always interpreted as a
+decrementation operator, not an algebraic sign.  To assign a register a
+negative value or the negated value of another register, you can
+force GNU @code{troff} to interpret @samp{-} as a negation or minus,
+rather than decrementation, operator: enclose it with its operand in
+parentheses or subtract it from zero.
 
 @Example
 .nr a 7
@@ -6238,51 +7431,49 @@
 .nr a (-\nb)
 \na
     @result{} -3
-@endExample
-
-@noindent
-The surrounding parentheses prevent the interpretation of the minus sign
-as a decrementing operator.  An alternative is to start the assignment
-with a @samp{0}:
-
-@Example
-.nr a 7
-.nr b -3
-.nr a \nb
-\na
-    @result{} 4
-.nr a 0\nb
+.nr a 0-\nb
 \na
     @result{} -3
 @endExample
+
+If a register's prior value does not exist (the register was undefined),
+an increment or decrement is applied as if to@tie{}0.
 @endDefreq
 
 @Defreq {rr, ident}
-@cindex removing number register (@code{rr})
-@cindex number register, removing (@code{rr})
+@cindex removing a register (@code{rr})
 @cindex register, removing (@code{rr})
-Remove number register @var{ident}.  If @var{ident} doesn't exist, the
-request is ignored.
+Remove register @var{ident}.  If @var{ident} doesn't exist, the request
+is ignored.  Technically, only the name is removed; the register's
+contents are still accessible under aliases created with @code{aln}, if
+any.
 @endDefreq
 
 @Defreq {rnn, ident1 ident2}
-@cindex renaming number register (@code{rnn})
-@cindex number register, renaming (@code{rnn})
+@cindex renaming a register (@code{rnn})
 @cindex register, renaming (@code{rnn})
-Rename number register @var{ident1} to @var{ident2}.  If either
-@var{ident1} or @var{ident2} doesn't exist, the request is ignored.
-@endDefreq
-
-@Defreq {aln, ident1 ident2}
-@cindex alias, number register, creating (@code{aln})
-@cindex creating alias, for number register (@code{aln})
-@cindex number register, creating alias (@code{aln})
-@cindex register, creating alias (@code{aln})
-Create an alias @var{ident1} for a number register @var{ident2}.  The
-new name and the old name are exactly equivalent.  If @var{ident1} is
-undefined, a warning of type @samp{reg} is generated, and the request is
-ignored.  @xref{Debugging}, for information about warnings.
+Rename register @var{ident1} to @var{ident2}.  If @var{ident1} doesn't
+exist, the request is ignored.  Renaming a built-in register does not
+otherwise alter its properties.
+@endDefreq
+
+@Defreq {aln, new old}
+@cindex alias, register, creating (@code{aln})
+@cindex creating alias for register (@code{aln})
+@cindex register, creating alias for (@code{aln})
+Create an alias @var{new} for an existing register @var{old}, causing
+the names to refer to the same stored object.  If @var{old} is
+undefined, a warning in category @samp{reg} is produced and the request
+is ignored.  @xref{Warnings}, for information about the enablement and
+suppression of warnings.
+
+@cindex alias, register, removing (@code{rr})
+@cindex removing alias for register (@code{rr})
+@cindex register, removing alias for (@code{rr})
+To remove a register alias, invoke @code{rr} on its name.  A register's
+contents do not become inaccessible until it has no more names.
 @endDefreq
+@c END Keep (roughly) parallel with subsection "Registers" of groff(7).
 
 @c ---------------------------------------------------------------------
 
@@ -6291,20 +7482,22 @@
 @cindex interpolating registers (@code{\n})
 @cindex registers, interpolating (@code{\n})
 
-Numeric registers can be accessed via the @code{\n} escape.
+Register contents are interpolated with the @code{\n} escape sequence.
 
 @DefescList {\\n, , i, }
-@DefescItem {\\n, @Lparen{}, id, }
-@DefescListEnd {\\n, @Lbrack{}, ident, @Rbrack{}}
+@DefescItem {\\n, (, id, }
+@DefescListEnd {\\n, , ident, }
 @cindex nested assignments
 @cindex assignments, nested
 @cindex indirect assignments
 @cindex assignments, indirect
-Interpolate number register with name @var{ident} (one-character
-name@tie{}@var{i}, two-character name @var{id}).  This means that the
-value of the register is expanded in-place while @code{gtroff} is
-parsing the input line.  Nested assignments (also called indirect
-assignments) are possible.
+Interpolate register with name @var{ident} (one-character
+name@tie{}@var{i}, two-character name @var{id}).  @code{\n} is
+interpreted even in copy mode (@pxref{Copy Mode}).  If the register is
+undefined, it is created and assigned a value of@tie{}@samp{0}, that
+value is interpolated, and a warning in category @samp{reg} is emitted.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings.
 
 @Example
 .nr a 5
@@ -6327,40 +7520,46 @@
 
 @c ---------------------------------------------------------------------
 
-@node Auto-increment, Assigning Formats, Interpolating Registers, Registers
+@node Auto-increment, Assigning Register Formats, Interpolating Registers, Registers
 @subsection Auto-increment
-@cindex auto-increment
-@cindex increment, automatic
-
-Number registers can also be auto-incremented and auto-decremented.  The
-increment or decrement value can be specified with a third argument to
-the @code{nr} request or @code{\R} escape.
+@cindex auto-incrementation of a register
+@cindex incrementation, automatic, of a register
+@cindex decrementation, automatic, of a register
+
+Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.  The value of the increment is
+specified with a third argument to the @code{nr} request, and a special
+interpolation syntax is used to alter and then retrieve the register's
+value.  Together, these features are called
+@dfn{auto-increment}.@footnote{A negative auto-increment can be
+considered an ``auto-decrement''.}
 
 @Defreq {nr, ident value incr}
-@cindex @code{\R}, difference to @code{nr}
-Set number register @var{ident} to @var{value}; the increment for
-auto-incrementing is set to @var{incr}.  Note that the @code{\R} escape
-doesn't support this notation.
+@cindex @code{\R}, difference from @code{nr}
+Set register @var{ident} to @var{value} and its auto-incrementation
+amount to to @var{incr}.  The @code{\R} escape sequence doesn't support
+an @var{incr} argument.
 @endDefreq
 
-To activate auto-incrementing, the escape @code{\n} has a special syntax
-form.
+Auto-incrementation is not @emph{completely} automatic; the @code{\n}
+escape sequence in its basic form never alters the value of a register.
+To apply auto-incrementation to a register, interpolate it with
+@samp{\n±}.
 
 @DefescList {\\n, +, i, }
 @DefescItem {\\n, -, i, }
-@DefescItem {\\n, +@Lparen{}, id, }
-@DefescItem {\\n, -@Lparen{}, id, }
-@DefescItem {\\n, +@Lbrack{}, ident, @Rbrack{}}
-@DefescListEnd {\\n, -@Lbrack{}, ident, @Rbrack{}}
-Before interpolating, increment or decrement @var{ident} (one-character
-name@tie{}@var{i}, two-character name @var{id}) by the auto-increment
-value as specified with the @code{nr} request (or the @code{\R} escape).
-If no auto-increment value has been specified, these syntax forms are
-identical to @code{\n}.
+@DefescItem {\\n, +(, id, }
+@DefescItem {\\n, -(, id, }
+@DefescItem {\\n, +, ident, }
+@DefescListEnd {\\n, -, ident, }
+Increment or decrement @var{ident} (one-character
+name@tie{}@var{i}, two-character name @var{id}) by the register's
+auto-incrementation value and then interpolate the new register value.
+If @var{ident} has no auto-incrementation value, interpolate as with
+@code{\n}.
 @endDefesc
 
-For example,
-
+@need 1000
 @Example
 .nr a 0 1
 .nr xx 0 5
@@ -6370,154 +7569,215 @@
 \n-(xx, \n-(xx, \n-(xx, \n-(xx, \n-(xx
 .br
 \n+foo, \n+foo, \n+foo, \n+foo, \n+foo
-@endExample
-
-@noindent
-produces
-
-@Example
-1, 2, 3, 4, 5
--5, -10, -15, -20, -25
--2, -4, -6, -8, -10
+    @result{} 1, 2, 3, 4, 5
+    @result{} -5, -10, -15, -20, -25
+    @result{} -2, -4, -6, -8, -10
 @endExample
 
 @cindex increment value without changing the register
 @cindex value, incrementing without changing the register
-To change the increment value without changing the value of a register
-(@var{a} in the example), the following can be used:
-
-@Example
-.nr a \na 10
-@endExample
+To change the increment value without changing the value of a register,
+assign the register's value to itself by interpolating it, and specify
+the desired increment normally.  Apply an increment of @samp{0} to
+disable auto-incrementation of the register.
 
 @c ---------------------------------------------------------------------
 
-@node Assigning Formats, Built-in Registers, Auto-increment, Registers
-@subsection Assigning Formats
-@cindex assigning formats (@code{af})
-@cindex formats, assigning (@code{af})
-
-When a register is used, it is always textually replaced (or
-interpolated) with a representation of that number.  This output format
-can be changed to a variety of formats (numbers, Roman numerals, etc.).
-This is done using the @code{af} request.
-
-@Defreq {af, ident format}
-Change the output format of a number register.  The first argument
-@var{ident} is the name of the number register to be changed, and the
-second argument @var{format} is the output format.  The following output
-formats are available:
+@node Assigning Register Formats, Built-in Registers, Auto-increment, Registers
+@subsection Assigning Register Formats
+@cindex assign number format to register (@code{af})
+@cindex number formats, assigning to register (@code{af})
+@cindex register, assigning number format to (@code{af})
+
+A writable register's value can be interpolated in several number
+formats.  By default, conventional Arabic numerals are used.
+Other formats see use in sectioning and outlining schemes and
+alternative page numbering arrangements.
+
+@Defreq {af, reg fmt}
+Use number format @var{fmt} when interpolating register @var{reg}.
+Valid number formats are as follows.
 
 @table @code
-@item 1
-Decimal arabic numbers.  This is the default format: 0, 1, 2,
-3,@tie{}@enddots{}
-
-@item 0@dots{}0
-Decimal numbers with as many digits as specified.  So, @samp{00} would
-result in printing numbers as 01, 02, 03,@tie{}@enddots{}
-
-In fact, any digit instead of zero does work; @code{gtroff} only counts
-how many digits are specified.  As a consequence, @code{af}'s default
-format @samp{1} could be specified as @samp{0} also (and exactly this is
-returned by the @code{\g} escape, see below).
+@item 0@r{@dots{}}
+Arabic numerals 0, 1, 2, and so on.
+Any decimal digit is equivalent to @samp{0}; the formatter merely counts
+the digits specified.  Multiple Arabic numerals in @var{fmt} cause
+interpolations to be zero-padded on the left if necessary to at least as
+many digits as specified (interpolations never truncate a register
+value).  A register with format @samp{00} interpolates values 1, 2, 3 as
+@samp{01}, @samp{02}, @samp{03}.  The default format for all writable
+registers is @samp{0}.
 
 @item I
 @cindex Roman numerals
 @cindex numerals, Roman
-Upper-case Roman numerals: 0, I, II, III, IV,@tie{}@enddots{}
+Uppercase Roman numerals: 0, I, II, III, IV,@tie{}@enddots{}
 
 @item i
-Lower-case Roman numerals: 0, i, ii, iii, iv,@tie{}@enddots{}
+Lowercase Roman numerals: 0, i, ii, iii, iv,@tie{}@enddots{}
 
 @item A
-Upper-case letters: 0, A, B, C, @dots{},@tie{}Z, AA, AB,@tie{}@enddots{}
+Uppercase letters: 0, A, B, C, @dots{},@tie{}Z, AA, AB,@tie{}@enddots{}
 
 @item a
-Lower-case letters: 0, a, b, c, @dots{},@tie{}z, aa, ab,@tie{}@enddots{}
+Lowercase letters: 0, a, b, c, @dots{},@tie{}z, aa, ab,@tie{}@enddots{}
 @end table
 
-Omitting the number register format causes a warning of type
-@samp{missing}.  @xref{Debugging}, for more details.  Specifying a
-nonexistent format causes an error.
-
-The following example produces @samp{10, X, j, 010}:
+Omitting @var{fmt} causes a warning in category @samp{missing}.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings.  Specifying an unrecognized format is an error.
+
+Zero values are interpolated as @samp{0} in non-Arabic formats.
+Negative quantities are prefixed with @samp{-} irrespective of format.
+In Arabic formats, the sign supplements the field width.  If @var{reg}
+doesn't exist, it is created with a zero value.
 
 @Example
 .nr a 10
-.af a 1           \" the default format
+.af a 0           \" the default format
 \na,
 .af a I
 \na,
-.af a a
+.af a 321
+.nr a (-\na)
 \na,
-.af a 001
+.af a a
 \na
+    @result{} 10, X, -010, -j
 @endExample
 
-@cindex Roman numerals, maximum and minimum
-@cindex maximum values of Roman numerals
-@cindex minimum values of Roman numerals
-The largest number representable for the @samp{i} and @samp{I} formats
-is 39999 (or @minus{}39999); Unix @code{troff} uses @samp{z} and
-@samp{w} to represent 10000 and 5000 in Roman numerals, and so does
-@code{gtroff}.  Currently, the correct glyphs of Roman numeral five
-thousand and Roman numeral ten thousand (Unicode code points
-@code{U+2182} and @code{U+2181}, respectively) are not available.
-
-If @var{ident} doesn't exist, it is created.
+@cindex Roman numerals, extrema (maximum and minimum)
+@cindex extreme values representable with Roman numerals
+@cindex maximum value representable with Roman numerals
+@cindex minimum value representable with Roman numerals
+The representable extrema in the @samp{i} and @samp{I} formats
+correspond to Arabic ±39,999.  GNU @code{troff} uses @samp{w} and
+@samp{z} to represent 5,000 and 10,000 in Roman numerals, respectively,
+following the convention of @acronym{AT&T} @code{troff}---currently, the
+correct glyphs for Roman numerals five thousand (@code{U+2181}) and ten
+thousand (@code{U+2182}) are not used.
 
 @cindex read-only register, changing format
 @cindex changing format, and read-only registers
-Changing the output format of a read-only register causes an error.  It
-is necessary to first copy the register's value to a writeable register,
-then apply the @code{af} request to this other register.
+Assigning the format of a read-only register is an error.  Instead, copy
+the read-only register's value to, and assign the format of, a writable
+register.
 @endDefreq
 
-@DefescList {\\g, , i, }
-@DefescItem {\\g, @Lparen{}, id, }
-@DefescListEnd {\\g, @Lbrack{}, ident, @Rbrack{}}
+@DefescList {\\g, , r, }
+@DefescItem {\\g, (, rg, }
+@DefescListEnd {\\g, , reg, }
 @cindex format of register (@code{\g})
 @cindex register, format (@code{\g})
-Return the current format of the specified register @var{ident}
-(one-character name@tie{}@var{i}, two-character name @var{id}).  For
-example, @samp{\ga} after the previous example would produce the string
-@samp{000}.  If the register hasn't been defined yet, nothing is
-returned.
+Interpolate the format of the register @var{reg} (one-character
+name@tie{}@var{r}, two-character name @var{rg}).  Zeroes represent
+Arabic formats.  If @var{reg} is not defined, @var{reg} is not created
+and nothing is interpolated.  @code{\g} is interpreted even in copy mode
+(@pxref{Copy Mode}).
 @endDefesc
 
+@cindex register format, in expressions
+@cindex expressions, and register format
+GNU @code{troff} interprets only Arabic numerals.  The Roman numeral or
+alphabetic formats cannot be used as operands to arithmetic operators in
+expressions (@pxref{Numeric Expressions}).  For instance, it may be
+desirable to test the page number independently of its format.
+
+@Example
+.af % i \" front matter
+.de header-trap
+.  \" To test the page number, we need it in Arabic.
+.  ds saved-page-number-format \\g%\"
+.  af % 0
+.  nr page-number-in-decimal \\n%
+.  af % \\*saved-page-number-format
+.  ie \\npage-number-in-decimal=1 .do-first-page-stuff
+.  el \@{\
+.    ie o .do-odd-numbered-page-stuff
+.    el   .do-even-numbered-page-stuff
+.  \@}
+.  rm saved-page-number-format
+..
+.wh 0 header-trap
+@endExample
+
 @c ---------------------------------------------------------------------
 
-@node Built-in Registers,  , Assigning Formats, Registers
+@node Built-in Registers,  , Assigning Register Formats, Registers
 @subsection Built-in Registers
 @cindex built-in registers
 @cindex registers, built-in
 
-The following lists some built-in registers that are not described
-elsewhere in this manual.  Any register that begins with a @samp{.} is
-read-only.  A complete listing of all built-in registers can be found in
-@ref{Register Index}.
+Predefined registers whose identifiers start with a dot are read-only.
+Many are Boolean-valued, interpolating a true or false value testable
+with the @code{if}, @code{ie}, or @code{while} requests.  Some read-only
+registers are string-valued, meaning that they interpolate text.
+
+@cindex removing a built-in register
+@cindex register, built-in, removing
+@cindex built-in register, removing
+@strong{Caution:@:} Built-in registers are subject to removal like
+others; once removed, they can be recreated only as normal writable
+registers and will not reflect formatter state.
+
+A register name (without the dot) is often associated with a request of
+the same name.  A complete listing of all built-in registers can be
+found in @ref{Register Index}.
+
+We present here a few built-in registers that are not described
+elsewhere in this manual; they have to do with invariant properties of
+GNU @code{troff}, or obtain information about the formatter's
+command-line options, processing progress, or the operating environment.
 
 @table @code
+@item \n.A
+@vindex .A
+@cindex approximation output register (@code{.A})
+@cindex plain text approximation output register (@code{.A})
+Approximate output is being formatted (Boolean-valued); see
+@command{groff} @option{-a} option (@ref{Groff Options}).
+
+@item \n.c
+@vindex .c
+@itemx \nc.
+@vindex c.
+@cindex input line number register (@code{.c}, @code{c.})
+@cindex line number, input, register (@code{.c}, @code{c.})
+Input line number.  @samp{c.} is a writable synonym,
+@c introduced in AT&T device-independent troff (CSTR #54, 1981-01)
+affecting subsequent interpolations of both @samp{.c} and @samp{c.}.
+
 @item \n.F
 @cindex current input file name register (@code{.F})
 @cindex input file name, current, register (@code{.F})
 @vindex .F
-This string-valued register returns the current input file name.
+Name of input file (string-valued).
 
-@item \n.H
-@cindex horizontal resolution register (@code{.H})
-@cindex resolution, horizontal, register (@code{.H})
-@vindex .H
-Number of basic units per horizontal unit of output device resolution.
-@xref{Measurements}.
+@item \n.g
+@vindex .g
+@cindex GNU @code{troff}, identification register (@code{.g})
+@cindex GNU-specific register (@code{.g})
+Always true in GNU @code{troff} (Boolean-valued).  Documents can use
+this to ask the formatter if it claims @code{groff} compatibility.
+
+@item \n.P
+@vindex .P
+Output page selection status (Boolean-valued); see @command{groff}
+@option{-o} option (@ref{Groff Options}).
 
 @item \n.R
 @cindex number of registers register (@code{.R})
 @cindex registers, number of, register (@code{.R})
 @vindex .R
-The number of number registers available.  This is always 10000 in
-GNU@tie{}@code{troff}; it exists for backward compatibility.
+Count of available unused registers; always 10,000 in GNU
+@code{troff}.@footnote{GNU @code{troff} dynamically allocates memory for
+as many registers as required.}
+
+@item \n.T
+@vindex .T
+Indicator of output device selection (Boolean-valued); see
+@command{groff} @option{-T} option (@ref{Groff Options}).
 
 @item \n.U
 @cindex safer mode
@@ -6525,47 +7785,73 @@
 @cindex unsafe mode
 @cindex mode, unsafe
 @vindex .U
-If @code{gtroff} is called with the @option{-U} command-line option to
-activate unsafe mode, the number register @code{.U} is set to@tie{}1,
-and to zero otherwise.  @xref{Groff Options}.
-
-@item \n.V
-@cindex vertical resolution register (@code{.V})
-@cindex resolution, vertical, register (@code{.V})
-@vindex .V
-Number of basic units per vertical unit of output device resolution.
-@xref{Measurements}.
+Unsafe mode enablement status (Boolean-valued); see @command{groff}
+@option{-U} option (@ref{Groff Options}).
 
+@item \n.x
+@vindex .x
+@cindex major version number register (@code{.x})
+@cindex version number, major, register (@code{.x})
+Major version number of the running GNU @code{troff} formatter.  For
+example, if the version number is 1.23.0, then @code{.x}
+contains@tie{}@samp{1}.
+
+@item \n.y
+@vindex .y
+@cindex minor version number register (@code{.y})
+@cindex version number, minor, register (@code{.y})
+Minor version number of the running GNU @code{troff} formatter.  For
+example, if the version number is 1.23.0, then @code{.y}
+contains@tie{}@samp{23}.
+
+@item \n.Y
+@vindex .Y
+@cindex revision number register (@code{.Y})
+Revision number of the running GNU @code{troff} formatter.  For example,
+if the version number is 1.23.0, then @code{.Y} contains@tie{}@samp{0}.
+
+@item \n$$
+@vindex $$
+@cindex process ID of GNU @code{troff} register (@code{$$})
+@cindex PID of GNU @code{troff} register (@code{$$})
+@cindex GNU @code{troff}, process ID register (@code{$$})
+@cindex GNU @code{troff}, PID register (@code{$$})
+Process identifier (PID) of the GNU @code{troff} program in its
+operating environment.
+@end table
+
+Date- and time-related registers are set per the local time as
+determined by @cite{localtime@r{(3)}} when the formatter launches.  This
+initialization can be overridden by @env{SOURCE_DATE_EPOCH} and
+@env{TZ}; see @ref{Environment}.
+
+@table @code
 @item \nseconds
 @cindex seconds, current time (@code{seconds})
 @cindex time, current, seconds (@code{seconds})
 @cindex current time, seconds (@code{seconds})
 @vindex seconds
-The number of seconds after the minute, normally in the range@tie{}0
-to@tie{}59, but can be up to@tie{}61 to allow for leap seconds.
-Initialized at start-up of @code{gtroff}.
+Count of seconds elapsed in the minute (0--60). @c not 59; see POSIX
 
 @item \nminutes
 @cindex minutes, current time (@code{minutes})
 @cindex time, current, minutes (@code{minutes})
 @cindex current time, minutes (@code{minutes})
 @vindex minutes
-The number of minutes after the hour, in the range@tie{}0 to@tie{}59.
-Initialized at start-up of @code{gtroff}.
+Count of minutes elapsed in the hour (0--59).
 
 @item \nhours
 @cindex hours, current time (@code{hours})
 @cindex time, current, hours (@code{hours})
 @cindex current time, hours (@code{hours})
 @vindex hours
-The number of hours past midnight, in the range@tie{}0 to@tie{}23.
-Initialized at start-up of @code{gtroff}.
+Count of hours elapsed since midnight (0--23).
 
 @item \ndw
 @cindex day of the week register (@code{dw})
 @cindex date, day of the week register (@code{dw})
 @vindex dw
-Day of the week (1--7).
+Day of the week (1--7; 1 is Sunday).
 
 @item \ndy
 @cindex day of the month register (@code{dy})
@@ -6577,517 +7863,719 @@
 @cindex month of the year register (@code{mo})
 @cindex date, month of the year register (@code{mo})
 @vindex mo
-Current month (1--12).
+Month of the year (1--12).
 
 @item \nyear
 @cindex date, year register (@code{year}, @code{yr})
 @cindex year, current, register (@code{year}, @code{yr})
 @vindex year
-The current year.
+Gregorian year.
 
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{yr} register
 @item \nyr
 @vindex yr
-The current year minus@tie{}1900.  Unfortunately, the documentation of
-Unix Version@tie{}7's @code{troff} had a year@tie{}2000 bug: It
-incorrectly claimed that @code{yr} contains the last two digits of the
-year.  That claim has never been true of either @acronym{AT&T}
-@code{troff} or GNU @code{troff}.  Old @code{troff} input that looks
-like this:
+Gregorian year minus@tie{}1900.  This register is incorrectly documented
+in the @acronym{AT&T} @code{troff} manual as storing the last two digits
+of the current year.  That claim stopped being true in 2000.  Old
+@code{troff} input that looks like:
 
 @Example
-'\" The following line stopped working after 1999
+'\" The year number is a surprise after 1999.
 This document was formatted in 19\n(yr.
 @endExample
 
 @noindent
-can be corrected as follows:
+can be corrected to:
 
 @Example
 This document was formatted in \nyear.
 @endExample
 
 @noindent
-or, to be portable to older @code{troff} versions, as follows:
+or, for portability across many @code{roff} programs, to the following.
 
 @Example
 .nr y4 1900+\n(yr
 This document was formatted in \n(y4.
 @endExample
-
-@item \n.c
-@vindex .c
-@itemx \nc.
-@vindex c.
-@cindex input line number register (@code{.c}, @code{c.})
-@cindex line number, input, register (@code{.c}, @code{c.})
-The current @emph{input} line number.  Register @samp{.c} is read-only,
-whereas @samp{c.} (a @code{gtroff} extension) is writable also,
-affecting both @samp{.c} and @samp{c.}.
-
-@item \nln
-@vindex ln
-@cindex output line number register (@code{ln})
-@cindex line number, output, register (@code{ln})
-The current @emph{output} line number after a call to the @code{nm}
-request to activate line numbering.
-
-@xref{Miscellaneous}, for more information about line numbering.
-
-@item \n.x
-@vindex .x
-@cindex major version number register (@code{.x})
-@cindex version number, major, register (@code{.x})
-The major version number.  For example, if the version number is 1.03
-then @code{.x} contains@tie{}@samp{1}.
-
-@item \n.y
-@vindex .y
-@cindex minor version number register (@code{.y})
-@cindex version number, minor, register (@code{.y})
-The minor version number.  For example, if the version number is 1.03
-then @code{.y} contains@tie{}@samp{03}.
-
-@item \n.Y
-@vindex .Y
-@cindex revision number register (@code{.Y})
-The revision number of @code{groff}.
-
-@item \n$$
-@vindex $$
-@cindex process ID of @code{gtroff} register (@code{$$})
-@cindex @code{gtroff}, process ID register (@code{$$})
-The process ID of @code{gtroff}.
-
-@item \n.g
-@vindex .g
-@cindex @code{gtroff}, identification register (@code{.g})
-@cindex GNU-specific register (@code{.g})
-Always@tie{}1.  Macros should use this to determine whether they are
-running under GNU @code{troff}.
-
-@item \n.A
-@vindex .A
-@cindex @acronym{ASCII} approximation output register (@code{.A})
-If the command-line option @option{-a} is used to produce an
-@acronym{ASCII} approximation of the output, this is set to@tie{}1, zero
-otherwise.  @xref{Groff Options}.
-
-@item \n.O
-@vindex .O
-This read-only register is set to the suppression nesting level (see
-escapes @code{\O}).  @xref{Suppressing output}.
-
-@item \n.P
-@vindex .P
-This register is set to@tie{}1 (and to@tie{}0 otherwise) if the current
-page is actually being printed, i.e., if the @option{-o} option is being
-used to only print selected pages.  @xref{Groff Options}, for more
-information.
-
-@item \n.T
-@vindex .T
-If @code{gtroff} is called with the @option{-T} command-line option, the
-number register @code{.T} is set to@tie{}1, and zero otherwise.
-@xref{Groff Options}.
-
-@item \*.T
-@stindex .T
-@cindex output device name string register (@code{.T})
-A single read-write string register that contains the current output
-device (for example, @samp{latin1} or @samp{ps}).  This is the only
-string register defined by @code{gtroff}.
 @end table
 
 
 @c =====================================================================
 
-@node Manipulating Filling and Adjusting, Manipulating Hyphenation, Registers, gtroff Reference
-@section Manipulating Filling and Adjusting
-@cindex manipulating filling and adjusting
-@cindex filling and adjusting, manipulating
-@cindex adjusting and filling, manipulating
+@node Manipulating Filling and Adjustment, Manipulating Hyphenation, Registers, GNU troff Reference
+@section Manipulating Filling and Adjustment
+@cindex manipulating filling and adjustment
+@cindex filling and adjustment, manipulating
+@cindex adjustment and filling, manipulating
 @cindex justifying text
 @cindex text, justifying
 
 @cindex break
 @cindex line break
-@cindex @code{bp} request, causing implicit linebreak
-@cindex @code{ce} request, causing implicit linebreak
-@cindex @code{cf} request, causing implicit linebreak
-@cindex @code{fi} request, causing implicit linebreak
-@cindex @code{fl} request, causing implicit linebreak
-@cindex @code{in} request, causing implicit linebreak
-@cindex @code{nf} request, causing implicit linebreak
-@cindex @code{rj} request, causing implicit linebreak
-@cindex @code{sp} request, causing implicit linebreak
-@cindex @code{ti} request, causing implicit linebreak
-@cindex @code{trf} request, causing implicit linebreak
-Various ways of causing @dfn{breaks} were given in @ref{Implicit Line
-Breaks}.  The @code{br} request likewise causes a break.  Several other
-requests also cause breaks, but implicitly.  These are @code{bp},
-@code{ce}, @code{cf}, @code{fi}, @code{fl}, @code{in}, @code{nf},
-@code{rj}, @code{sp}, @code{ti}, and @code{trf}.
+@cindex @code{bp} request, causing implicit break
+@cindex @code{ce} request, causing implicit break
+@cindex @code{cf} request, causing implicit break
+@cindex @code{fi} request, causing implicit break
+@cindex @code{fl} request, causing implicit break
+@cindex @code{in} request, causing implicit break
+@cindex @code{nf} request, causing implicit break
+@cindex @code{rj} request, causing implicit break
+@cindex @code{sp} request, causing implicit break
+@cindex @code{ti} request, causing implicit break
+@cindex @code{trf} request, causing implicit break
+When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in @ref{Breaking}.
+The @code{br} request likewise causes a break.  Several other requests
+imply breaks:@: @code{bp}, @code{ce}, @code{cf}, @code{fi}, @code{fl},
+@code{in}, @code{nf}, @code{rj}, @code{sp}, @code{ti}, and @code{trf}.
+If the no-break control character is used with any of these requests,
+GNU @code{troff} suppresses the break; instead the requested operation
+takes effect at the next break.  @samp{'br} does nothing.
 
-@Defreq {br, }
-Break the current line, i.e., the input collected so far is emitted
-without adjustment.
+@Example
+.ll 55n
+This line is normally filled and adjusted.
+.br
+A line's alignment is decided
+'ce \" Center the next input line (no break).
+when it is output.
+This line returns to normal filling and adjustment.
+    @result{} This line is normally filled and adjusted.
+    @result{}    A line's alignment is decided when it is output.
+    @result{} This line returns to normal filling and adjustment.
+@endExample
 
-If the no-break control character is used, @code{gtroff} suppresses the
-break:
+@noindent
+@cindex pending output line
+@cindex partially collected line
+@cindex output line properties
+@cindex properties of output lines
+Output line properties like page offset, indentation, adjustment, and
+even the location of its text baseline, are not determined until the
+line has been broken.  An output line is said to be @dfn{pending} if
+some input has been collected but an output line corresponding to it has
+not yet been written; such an output line is also termed @dfn{partially
+collected}.  If no output line is pending, it is as if a break has
+already happened; additional breaks, whether explicit or implicit, have
+no effect.  If the vertical drawing position is negative---as it is when
+the formatter starts up---a break starts a new page (even if no output
+line is pending) unless an end-of-input macro is being interpreted.
+@xref{End-of-input Traps}.
+
+@Defreq {br, }
+Break the line: emit any pending output line without adjustment.
 
 @Example
-a
+foo bar
+.br
+baz
 'br
-b
-    @result{} a b
+qux
+    @result{} foo bar
+    @result{} baz qux
 @endExample
 @endDefreq
 
-Initially, @code{gtroff} fills and adjusts text to both margins.
-Filling can be disabled via the @code{nf} request and re-enabled with
-the @code{fi} request.
+Sometimes you want to prevent a break within a phrase or between a
+quantity and its units.
 
-@DefreqList {fi, }
-@DefregListEndx {.u}
-@cindex fill mode (@code{fi})
-@cindex mode, fill (@code{fi})
-Activate fill mode (which is the default).  This request implicitly
-enables adjusting; it also inserts a break in the text currently being
-filled.  The read-only number register @code{.u} is set to@tie{}1.
+@Defesc {\\~, , , }
+@cindex unbreakable space (@code{\~})
+@cindex space, unbreakable (@code{\~})
+Insert an unbreakable space that is adjustable like an ordinary space.
+It is discarded from the end of an output line if a break is forced.
 
-The fill mode status is associated with the current environment
-(@pxref{Environments}).
+@Example
+Set the output speed to\~1.
+There are 1,024\~bytes in 1\~KiB.
+J.\~F.\~Ossanna wrote the original CSTR\~#54.
+@endExample
+@endDefesc
+
+By default, GNU @code{troff} fills text and adjusts it to reach the
+output line length.  The @code{nf} request disables filling; the
+@code{fi} request reënables it.
 
-See @ref{Line Control}, for interaction with the @code{\c} escape.
+@DefreqList {fi, }
+@DefregListEndx {.u}
+@cindex filling of output, enabling (@code{fi})
+@cindex output, filling, enablement of (@code{fi})
+@cindex fill mode (@code{fi}), enabling
+@cindex mode, fill (@code{fi}), enabling
+Enable filling of output lines; a pending output line is broken.  The
+read-only register @code{.u} is set to@tie{}1.  The filling enablement
+status, sometimes called @dfn{fill mode}, is associated with the
+environment (@pxref{Environments}).  @xref{Line Continuation}, for
+interaction with the @code{\c} escape sequence.
 @endDefreq
 
 @Defreq {nf, }
-@cindex no-fill mode (@code{nf})
-@cindex mode, no-fill (@code{nf})
-Activate no-fill mode.  Input lines are output as-is, retaining line
-breaks and ignoring the current line length.  This command implicitly
-disables adjusting; it also causes a break.  The number register
-@code{.u} is set to@tie{}0.
-
-The fill mode status is associated with the current environment
-(@pxref{Environments}).
-
-See @ref{Line Control}, for interaction with the @code{\c} escape.
+@cindex filling of output, disabling (@code{nf})
+@cindex output, filling, disablement of (@code{nf})
+@cindex no-fill mode
+@cindex mode, no-fill
+@cindex fill mode, disabling
+@cindex mode, fill, disabling
+Disable filling of output lines: the output line length (@pxref{Line
+Layout}) is ignored and output lines are broken where the input lines
+are.  A pending output line is broken and adjustment is suppressed.  The
+read-only register @code{.u} is set to@tie{}0.  The filling enablement
+status is associated with the environment (@pxref{Environments}).  See
+@ref{Line Continuation}, for interaction with the @code{\c} escape
+sequence.
 @endDefreq
 
 @DefreqList {ad, @Var{mode}}
 @DefregListEndx {.j}
-Set adjusting mode.
+Enable output line adjustment in @var{mode}, taking effect when the
+pending (or next) output line is broken.  Adjustment is suppressed when
+filling is.  @var{mode} can have one of the following values.
 
-Activation and deactivation of adjusting is done implicitly with calls
-to the @code{fi} or @code{nf} requests.
+@table @code
+@item b
+@itemx n
+Adjust ``normally'':@: if the output line does not consume the distance
+between the indentation and the configured output line length, GNU
+@code{troff} stretches adjustable spaces within the line until that
+length is reached.  When the indentation is zero, this mode spreads the
+line to both the left and right margins.  This is the GNU @code{troff}
+default.
 
-@var{mode} can have one of the following values:
+@item c
+@cindex centered text (filled)
+Center filled text.  Contrast with the @code{ce} request, which centers
+text @emph{without} filling it.
 
-@table @code
 @item l
-@cindex ragged-right
-Adjust text to the left margin.  This produces what is traditionally
-called ragged-right text.
+@cindex ragged-right text
+Align text to the left without adjusting it.
 
 @item r
-@cindex ragged-left
-Adjust text to the right margin, producing ragged-left text.
-
-@item c
-@cindex centered text
-@cindex @code{ce} request, difference to @samp{.ad@tie{}c}
-Center filled text.  This is different to the @code{ce} request, which
-only centers text without filling.
-
-@item b
-@itemx n
-Justify to both margins.  This is the default used by @code{gtroff}.
+@cindex ragged-left text
+Align text to the right without adjusting it.
 @end table
 
-Finally, @var{mode} can be the numeric argument returned by the
-@code{.j} register.
+@var{mode} can also be a value previously stored in the @code{.j}
+register.  Using @code{ad} without an argument is the same as @samp{.ad
+\n.j}; unless filling is disabled, GNU @code{troff} resumes adjusting
+lines in the same way it did before adjustment was disabled by
+invocation of the @code{na} request.
+
+@cindex adjustment mode register (@code{.j})
+The adjustment mode and enablement status are encoded in the read-only
+register @code{.j}.  These parameters are associated with the
+environment (@pxref{Environments}).
 
-Using @code{ad} without argument is the same as saying
-@w{@code{.ad \.j}}.  In particular, @code{gtroff} adjusts lines
-in the same way it did before adjusting was deactivated (with a call
-to @code{na}, say).  For example, this input code
+The value of @code{.j} for any adjustment mode is an implementation
+detail and should not be relied upon as a programmer's interface.  Do
+not write logic to interpret or perform arithmetic on it.
 
 @Example
+.ll 48n
 .de AD
 .  br
 .  ad \\$1
 ..
-.
+@c . @c XXX: Restore this line when the page has room for it.
 .de NA
 .  br
 .  na
 ..
-.
-textA
+@c . @c XXX: Restore this line when the page has room for it.
+left
 .AD r
-.nr ad \n.j
-textB
+.nr ad \n(.j
+right
 .AD c
-textC
+center
 .NA
-textD
-.AD         \" back to centering
-textE
-.AD \nad  \" back to right justifying
-textF
+left
+.AD
+center
+.AD \n(ad
+right
 @endExample
-
-@noindent
-produces the following output:
-
 @Example
-textA
-                                                    textB
-                          textC
-textD
-                          textE
-                                                    textF
+    @result{} left
+    @result{}                                            right
+    @result{}                      center
+    @result{} left
+    @result{}                      center
+    @result{}                                            right
 @endExample
-
-@cindex adjustment mode register (@code{.j})
-As just demonstrated, the current adjustment mode is available in the
-read-only number register @code{.j}; it can be stored and
-subsequently used to set adjustment.
-
-The adjustment mode status is associated with the current environment
-(@pxref{Environments}).
 @endDefreq
 
 @Defreq {na, }
-Disable adjusting.  This request won't change the current adjustment
-mode: A subsequent call to @code{ad} uses the previous adjustment
-setting.
-
-The adjustment mode status is associated with the current environment
-(@pxref{Environments}).
+Disable output line adjustment.  This produces the same output as
+left-alignment, but the value of the adjustment mode register @code{.j}
+is altered differently.  The adjustment mode and enablement status are
+associated with the environment (@pxref{Environments}).
 @endDefreq
 
 @DefreqList {brp, }
 @DefescListEndx {\\p, , , }
-Break, adjusting the current line per the current adjustment mode.
-
-With @code{\p}, this break will happen at the next word boundary.  The
-@code{\p} itself is removed entirely, adding neither a break nor a space
-where it appears in input; it can thus be placed in the middle of a word
-to cause a break at the end of that word.
-
-In most cases this produces very ugly results since @code{gtroff}
-doesn't have a sophisticated paragraph building algorithm (as @TeX{}
-has, for example); instead, @code{gtroff} fills and adjusts a paragraph
-line by line:
+Break, adjusting the line per the current adjustment mode.  @code{\p}
+schedules a break with adjustment at the next word boundary.  The escape
+sequence is itself neither a break nor a space of any kind; it can thus
+be placed in the middle of a word to cause a break at the end of that
+word.
+
+Breaking with immediate adjustment can produce ugly results since GNU
+@code{troff} doesn't have a sophisticated paragraph-building algorithm,
+as @TeX{} has, for example.  Instead, GNU @code{troff} fills and adjusts
+a paragraph line by line.
 
 @Example
+.ll 4.5i
 This is an uninteresting sentence.
 This is an uninteresting sentence.\p
 This is an uninteresting sentence.
 @endExample
 
 @noindent
-is formatted as
+is formatted as follows.
 
 @Example
-This is  an uninteresting  sentence.   This  is an
-uninteresting                            sentence.
+This  is  an uninteresting sentence.  This is
+an          uninteresting           sentence.
 This is an uninteresting sentence.
 @endExample
 @endDefreq
 
-@DefreqList {ss, word_space_size @Var{sentence_space_size}}
+@cindex productive input line
+@cindex input line, productive
+@cindex line, productive input
+To clearly present the next couple of requests, we must introduce the
+concept of ``productive'' input lines.  A @dfn{productive input line} is
+one that directly produces formatted output.  Text lines produce
+output,@footnote{unless diverted; see @ref{Diversions}} as do control
+lines containing requests like @code{tl} or escape sequences like
+@code{\D}.  Macro calls are not @emph{directly} productive, and thus not
+counted, but their interpolated contents can be.  Empty requests, and
+requests and escape sequences that define registers or strings or alter
+the formatting environment (as with changes to the size, face, height,
+slant, or color of the type) are not productive.  We will also preview
+the output line continuation escape sequence, @code{\c}, which
+``connects'' two input lines that would otherwise be counted separately.
+@footnote{@xref{Line Continuation}.}
+
+@Example
+@c .ll 56n
+.de hello
+Hello, world!
+..
+.ce \" center output of next productive input line
+.
+.nr junk-reg 1
+.ft I
+Chorus: \c
+.ft
+.hello
+Went the day well?
+  @result{}                  @slanted{Chorus:} Hello, world!
+  @result{} Went the day well?
+@endExample
+
+@DefreqList {ce, @Var{n}}
+@DefregListEndx {.ce}
+@cindex centered text (unfilled)
+@cindex centering lines (@code{ce})
+@cindex lines, centering (@code{ce})
+Break (unless the no-break control character is used), center the output
+of the next @var{n} productive input lines with respect to the line
+length and indentation without filling, then break again regardless of
+the invoking control character.
+@c Temporary indentation is ignored.
+If the argument is not positive, centering is disabled.  Omitting the
+argument implies an @var{n} of @samp{1}.  The count of lines remaining
+to be centered is stored in the read-only register @code{.ce} and is
+associated with the environment (@pxref{Environments}).
+
+@cindex @code{ce} request, difference from @w{@samp{.ad c}}
+While the @w{@samp{.ad c}} request also centers text, it fills the text
+as well.
+
+@c Wrap example at 56 columns.
+@Example
+.de FR
+This is a small text fragment that shows the differences
+between the `.ce' and the `.ad c' requests.
+..
+.ll 4i
+.ce 1000
+.FR
+.ce 0
+
+.ad c
+.FR
+    @result{} This is a small text fragment that shows
+    @result{}              the differences
+    @result{} between the @quoteleft{}.ce@quoteright{} and the @quoteleft{}.ad c@quoteright{} requests.
+    @result{}
+    @result{} This is a small text fragment that shows
+    @result{}  the differences between the @quoteleft{}.ce@quoteright{} and
+    @result{}         the @quoteleft{}.ad c@quoteright{} requests.
+@endExample
+
+The previous example illustrates a common idiom of turning centering on
+for a quantity of lines far in excess of what is required, and off again
+after the text to be centered.  This technique relieves humans of
+counting lines for requests that take a count of input lines as an
+argument.
+@endDefreq
+
+@DefreqList {rj, @Var{n}}
+@DefregListEndx {.rj}
+@cindex justifying text (@code{rj})
+@cindex text, justifying (@code{rj})
+@cindex right-justifying (@code{rj})
+Break (unless the no-break control character is used), align the output
+of the next @var{n} productive input lines to the right margin without
+filling, then break again regardless of the control character.
+@c Temporary indentation is ignored.
+If the argument is not positive, right-alignment is disabled.  Omitting
+the argument implies an @var{n} of @samp{1}.  The count of lines
+remaining to be right-aligned is stored in the read-only register
+@code{.rj} and is associated with the environment
+(@pxref{Environments}).
+
+@Example
+.ll 49n
+.rj 3
+At first I hoped that such a technically unsound
+project would collapse but I soon realized it was
+doomed to success. \em C. A. R. Hoare
+    @result{}  At first I hoped that such a technically unsound
+    @result{} project would collapse but I soon realized it was
+    @result{}              doomed to success. -- C. A. R. Hoare
+@endExample
+@endDefreq
+
+@need 2000
+@DefreqList {ss, word-space-size @Var{additional-sentence-space-size}}
 @DefregItemx {.ss}
 @DefregListEndx {.sss}
 @cindex word space size register (@code{.ss})
 @cindex size of word space register (@code{.ss})
 @cindex space between words register (@code{.ss})
+@cindex inter-sentence space size register (@code{.sss})
 @cindex sentence space size register (@code{.sss})
 @cindex size of sentence space register (@code{.sss})
 @cindex space between sentences register (@code{.sss})
-Change the size of a space between words.  It takes its units as one
-twelfth of the space width parameter for the current font.  Initially
-both the @var{word_space_size} and @var{sentence_space_size}
-are@tie{}12.  In fill mode, the values specify the minimum distance.
-
-@cindex fill mode
-@cindex mode, fill
-If two arguments are given to the @code{ss} request, the second argument
-sets the sentence space size.  If the second argument is not given,
-sentence space size is set to @var{word_space_size}.  The sentence space
-size is used in two circumstances: If the end of a sentence occurs at
-the end of a line in fill mode, then both an inter-word space and a
-sentence space are added; if two spaces follow the end of a sentence in
-the middle of a line, then the second space is a sentence space.  If a
-second argument is never given to the @code{ss} request, the behaviour
-of Unix @code{troff} is the same as that exhibited by GNU @code{troff}.
-In GNU @code{troff}, as in Unix @code{troff}, a sentence should always
-be followed by either a newline or two spaces.
-
-The read-only number registers @code{.ss} and @code{.sss} hold the
-values of the parameters set by the first and second arguments of the
-@code{ss} request.
-
-The word space and sentence space values are associated with the current
-environment (@pxref{Environments}).
-
-Contrary to @acronym{AT&T} @code{troff}, this request is @emph{not}
-ignored if a TTY output device is used; the given values are then
-rounded down to a multiple of@tie{}12 (@pxref{Implementation
-Differences}).
-
-The request is ignored if there is no parameter.
+Set the sizes of spaces between words and
+sentences@footnote{Recall @ref{Filling} and @ref{Sentences} for the
+definitions of word and sentence boundaries, respectively.} in twelfths
+of font's space width (typically one-fourth to one-third em for Western
+scripts).  The default for both parameters is@tie{}12.  Negative values
+are erroneous.
+@cindex inter-word spacing, minimal
+@cindex minimal inter-word spacing
+@cindex space, between words
+The first argument is a minimum; if an output line undergoes adjustment,
+such spaces may increase in width.
+@cindex inter-sentence space, additional
+@cindex additional inter-sentence space
+@cindex space, between sentences
+The optional second argument sets the amount of additional space
+separating sentences on the same output line.  If omitted, this amount
+is set to @var{word-space-size}.  The request is ignored if there are no
+parameters.
+
+@cindex filling, and inter-sentence space
+@cindex mode, fill, and inter-sentence space
+Additional inter-sentence space is used only if the output line is not
+full when the end of a sentence occurs in the input.  If a sentence ends
+at the end of an input line, then both an inter-word space and an
+inter-sentence space are added to the output; if two spaces follow the
+end of a sentence in the middle of an input line, then the second space
+becomes an inter-sentence space in the output.  Additional
+inter-sentence space is not adjusted, but the inter-word space that
+always precedes it may be.  Further input spaces after the second, if
+present, are adjusted as normal.
+
+The read-only registers @code{.ss} and @code{.sss} hold the minimal
+inter-word space and additional inter-sentence space amounts,
+respectively.  These parameters are part of the environment
+(@pxref{Environments}), and rounded down to the nearest multiple
+of@tie{}12 on terminals.
 
 @cindex discardable horizontal space
 @cindex space, discardable, horizontal
 @cindex horizontal discardable space
-Another useful application of the @code{ss} request is to insert
-discardable horizontal space, i.e., space that is discarded at a line
-break.  For example, paragraph-style footnotes could be separated this
-way:
-
-@Example
-.ll 4.5i
-1.\ This is the first footnote.\c
-.ss 48
-.nop
-.ss 12
-2.\ This is the second footnote.
-@endExample
-
-@noindent
-The result:
+The @code{ss} request can insert discardable horizontal space; that is,
+space that is discarded at a break.  For example, some footnote styles
+collect the notes into a single paragraph with large gaps between
+each note.
 
 @Example
-1. This is the first footnote.        2. This
-is the second footnote.
+.ll 48n
+1.\~J. Fict. Ch. Soc. 6 (2020), 3\en14.
+.ss 12 48 \" applies to next sentence ending
+Reprints no longer available through FCS.
+.ss 12 \" go back to normal
+2.\~Better known for other work.
+    @result{} 1.  J.  Fict. Ch. Soc. 6 (2020), 3-14.  Reprints
+    @result{} no longer available through FCS.      2.  Better
+    @result{} known for other work.
 @endExample
 
 @noindent
-Note that the @code{\h} escape produces unbreakable space.
+If @emph{undiscardable} space is required, use the @code{\h} escape
+sequence.
 @endDefreq
 
-@DefreqList {ce, @Var{nnn}}
-@DefregListEndx {.ce}
-@cindex centering lines (@code{ce})
-@cindex lines, centering (@code{ce})
-Center text.  While the @w{@samp{.ad c}} request also centers text, it
-fills the text as well.  @code{ce} does not fill the text it affects.
-This request causes a break.  The number of lines still to be centered
-is associated with the current environment (@pxref{Environments}).
 
-The following example demonstrates the differences.  Here is the input:
+@c =====================================================================
 
-@Example
-.ll 4i
-.ce 1000
-This is a small text fragment that shows the differences
-between the `.ce' and the `.ad c' request.
-.ce 0
+@node Manipulating Hyphenation, Manipulating Spacing, Manipulating Filling and Adjustment, GNU troff Reference
+@section Manipulating Hyphenation
+@cindex manipulating hyphenation
+@cindex hyphenation, manipulating
 
-.ad c
-This is a small text fragment that shows the differences
-between the `.ce' and the `.ad c' request.
-@endExample
+@cindex hyphenation, automatic
+@cindex automatic hyphenation
+When filling, GNU @code{troff} hyphenates words as needed at
+user-specified and automatically determined hyphenation points.  The
+machine-driven determination of hyphenation points in words requires
+algorithms and data, and is susceptible to conventions and preferences.
+Before tackling such @dfn{automatic hyphenation}, let us consider how
+hyphenation points can be set explicitly.
+
+@cindex hyphenation, explicit
+@cindex explicit hyphenation
+@cindex hyphenation, manual
+@cindex manual hyphenation
+Explicitly hyphenated words such as ``mother-in-law'' are eligible for
+breaking after each of their hyphens.  Relatively few words in a
+language offer such obvious break points, however, and automatic
+detection of syllabic (or phonetic) boundaries for hyphenation is not
+perfect,@footnote{Whether a perfect algorithm for this application is
+even possible is an unsolved problem in computer science:@:
+@url{https://tug.org/docs/liang/liang-thesis.pdf}.} particularly for
+unusual words found in technical literature.  We can instruct GNU
+@code{troff} how to hyphenate specific words if the need arises.
+
+@cindex hyphenation exceptions
+@Defreq {hw, word @dots{}}
+Define each @dfn{hyphenation exception} @var{word} with each hyphen `-'
+in the word indicating a hyphenation point.  For example, the request
+
+@Example
+.hw in-sa-lub-rious alpha
+@endExample
+
+@c Serendipitously, in PDF output, the "alpha" below gets hyphenated.
+@c Try to preserve this felicity in future edits.
+marks potential hyphenation points in ``insalubrious'', and prevents
+``alpha'' from being hyphenated at all.
+
+Besides the space character, any character whose hyphenation code is
+zero can be used to separate the arguments of @code{hw} (see the
+@code{hcode} request below).  In addition, this request can be used more
+than once.
 
-@noindent
-And here the result:
+@cindex @code{hw} request, and @code{hy} restrictions
+Hyphenation points specified with @code{hw} are not subject to the
+within-word placement restrictions imposed by the @code{hy} request (see
+below).
 
-@Example
-  This is a small text fragment that
-         shows the differences
-between the `.ce' and the `.ad c' request.
+Hyphenation exceptions specified with the @code{hw} request are
+associated with the hyphenation language (see the @code{hla} request
+below) and environment (@pxref{Environments}); invoking the @code{hw}
+request in the absence of a hyphenation language is an error.
 
-  This is a small text fragment that
-shows the differences between the `.ce'
-        and the `.ad c' request.
-@endExample
+The request is ignored if there are no parameters.
+@endDefreq
 
-With no arguments, @code{ce} centers the next line of text.  @var{nnn}
-specifies the number of lines to be centered.  If the argument is zero
-or negative, centering is disabled.
+These are known as hyphenation @slanted{exceptions} in the expectation
+that most users will avail themselves of automatic hyphenation; these
+exceptions override any rules that would normally apply to a word
+matching a hyphenation exception defined with @code{hw}.
 
-The basic length for centering text is the line length (as set with the
-@code{ll} request) minus the indentation (as set with the @code{in}
-request).  Temporary indentation is ignored.
+Situations also arise when only a specific occurrence of a word needs
+its hyphenation altered or suppressed, or when a URL or similar string
+needs to be breakable in sensible places without hyphenation.
 
-As can be seen in the previous example, it is a common idiom to turn on
-centering for a large number of lines, and to turn off centering after
-text to be centered.  This is useful for any request that takes a
-number of lines as an argument.
+@DefescList {\\%, , , }
+@DefescListEndx {\:, , , }
+@cindex hyphenation character (@code{\%})
+@cindex character, hyphenation (@code{\%})
+@cindex disabling hyphenation (@code{\%})
+@cindex hyphenation, disabling (@code{\%})
+To tell GNU @code{troff} how to hyphenate words as they occur in input,
+use the @code{\%} escape sequence; it is the default @dfn{hyphenation
+character}.  Each instance within a word indicates to GNU @code{troff}
+that the word may be hyphenated at that point, while prefixing a word
+with this escape sequence prevents it from being otherwise hyphenated.
+This mechanism affects only that occurrence of the word; to change the
+hyphenation of a word for the remainder of input processing, use the
+@code{hw} request.
 
-The @code{.ce} read-only number register contains the number of lines
-remaining to be centered, as set by the @code{ce} request.
-@endDefreq
+@cindex @code{\X}, followed by @code{\%}
+@cindex @code{\Y}, followed by @code{\%}
+@cindex @code{\%}, following @code{\X} or @code{\Y}
+GNU @code{troff} regards the escape sequences @code{\X} and @code{\Y} as
+starting a word; that is, the @code{\%} escape sequence in, say,
+@w{@samp{\X'...'\%foobar}} or @w{@samp{\Y'...'\%foobar}} no longer
+prevents hyphenation of @samp{foobar} but inserts a hyphenation point
+just prior to it; most likely this isn't what you want.
+@xref{Postprocessor Access}.
+
+@cindex non-printing break point (@code{\:})
+@cindex breaking without hyphens (@code{\:})
+@cindex file names, breaking (@code{\:})
+@cindex breaking file names (@code{\:})
+@cindex URLs, breaking (@code{\:})
+@cindex breaking URLs (@code{\:})
+@code{\:} inserts a non-printing break point; that is, a word can break
+there, but the soft hyphen glyph (see below) is not written to the
+output if it does.  This escape sequence is an input word boundary, so
+the remainder of the word is subject to hyphenation as normal.
+
+You can combine @code{\:} and @code{\%} to control breaking of a file
+name or URL, or to permit hyphenation only after certain explicit
+hyphens within a word.
+
+@Example
+@c Wrap example at 56 columns.
+The \%Lethbridge-Stewart-\:\%Sackville-Baggins divorce
+was, in retrospect, inevitable once the contents of
+\%/var/log/\:\%httpd/\:\%access_log on the family web
+server came to light, revealing visitors from Hogwarts.
+@endExample
+@endDefesc
 
-@DefreqList {rj, @Var{nnn}}
-@DefregListEndx {.rj}
-@cindex justifying text (@code{rj})
-@cindex text, justifying (@code{rj})
-@cindex right-justifying (@code{rj})
-Justify unfilled text to the right margin.  Arguments are identical to
-the @code{ce} request.  The @code{.rj} read-only number register is the
-number of lines to be right-justified as set by the @code{rj} request.
-This request causes a break.  The number of lines still to be
-right-justified is associated with the current environment
+@Defreq {hc, @Var{char}}
+Change the hyphenation character to @var{char}.  This character then
+works as the @code{\%} escape sequence normally does, and thus no longer
+appears in the output.@footnote{@code{\%} itself stops marking
+hyphenation points but still produces no output glyph.}  Without an
+argument, @code{hc} resets the hyphenation character to @code{\%} (the
+default).  The hyphenation character is associated with the environment
 (@pxref{Environments}).
 @endDefreq
 
+@Defreq {shc, @Var{c}}
+@cindex soft hyphen character, setting (@code{shc})
+@cindex character, soft hyphen, setting (@code{shc})
+@cindex glyph, soft hyphen (@code{hy})
+@cindex soft hyphen glyph (@code{hy})
+@cindex @code{char} request, and soft hyphen character
+@cindex @code{tr} request, and soft hyphen character
+Set the @dfn{soft hyphen character}, inserted when a word is hyphenated
+automatically or at a hyphenation character, to the ordinary or special
+character@tie{}@var{c}.@footnote{``Soft'' because it appears in output
+only where a hyphenation break is performed; a ``hard'' hyphen, as in
+``long-term'', always appears.}  If the argument is omitted, the soft
+hyphen character is set to the default, @code{\hy}.  If no glyph for
+@var{c} exists in the font in use at a potential hyphenation point, then
+the line is not broken there.  Neither character definitions (specified
+with the @code{char} and similar requests) nor translations (specified
+with the @code{tr} request) are applied to @var{c}.
+@endDefreq
+
+@cindex hyphenation parameters, automatic
+@cindex automatic hyphenation parameters
+Several requests influence automatic hyphenation.  Because conventions
+vary, a variety of hyphenation modes is available to the @code{hy}
+request; these determine whether hyphenation will apply to a
+word prior to breaking a line at the end of a page (more or less; see
+below for details), and at which positions within that word
+automatically determined hyphenation points are permissible.  The places
+within a word that are eligible for hyphenation are determined by
+language-specific data and lettercase relationships.  Furthermore,
+hyphenation of a word might be suppressed due to a limit on
+consecutive hyphenated lines (@code{hlm}), a minimum line length
+threshold (@code{hym}), or because the line can instead be adjusted with
+additional inter-word space (@code{hys}).
 
-@c =====================================================================
-
-@node Manipulating Hyphenation, Manipulating Spacing, Manipulating Filling and Adjusting, gtroff Reference
-@section Manipulating Hyphenation
-@cindex manipulating hyphenation
-@cindex hyphenation, manipulating
-
-Here a description of requests that influence hyphenation.
-
+@cindex hyphenation mode register (@code{.hy})
 @DefreqList {hy, @Var{mode}}
 @DefregListEndx {.hy}
-Enable hyphenation.  The request has an optional numeric argument,
-@var{mode}, to restrict hyphenation if necessary:
+Set automatic hyphenation mode to @var{mode}, an integer encoding
+conditions for hyphenation; if omitted, @samp{1} is implied.  The
+hyphenation mode is available in the read-only register @samp{.hy}; it
+is associated with the environment (@pxref{Environments}).  The default
+hyphenation mode depends on the localization file loaded when GNU
+@code{troff} starts up; see the @code{hpf} request below.
+
+Typesetting practice generally does not avail itself of every
+opportunity for hyphenation, but the details differ by language and site
+mandates.  The hyphenation modes of @acronym{AT&T} @code{troff} were
+implemented with English-language publishing practices of the 1970s in
+mind, not a scrupulous enumeration of conceivable parameters.  GNU
+@code{troff} extends those modes such that finer-grained control is
+possible, favoring compatibility with older implementations over a more
+intuitive arrangement.  The means of hyphenation mode control is a set
+of numbers that can be added up to encode the behavior
+sought.@footnote{The mode is a vector of Booleans encoded as an integer.
+To a programmer, this fact is easily deduced from the exclusive use of
+powers of two for the configuration parameters; they are computationally
+easy to ``mask off'' and compare to zero.  To almost everyone else, the
+arrangement seems recondite and unfriendly.}  The entries in the
+following table are termed @dfn{values}; the sum of the desired
+values is the @dfn{mode}.
 
 @table @code
+@item 0
+disables hyphenation.
+
 @item 1
-The default argument if @var{mode} is omitted: hyphenation is enabled,
-and the first and the last characters of a word are not hyphenated.
-This is also the start-up value of @code{gtroff}.
+enables hyphenation except after the first and before the last character
+of a word.
+@end table
 
+The remaining values ``imply'' 1; that is, they enable hyphenation
+under the same conditions as @samp{.hy 1}, and then apply or lift
+restrictions relative to that basis.
+
+@table @code
 @item 2
-Do not hyphenate the last word on a page or column.
+disables hyphenation of the last word on a page,@footnote{Hyphenation is
+prevented if the next page location trap is closer to the vertical
+drawing position than the next text baseline would be.  @xref{Page
+Location Traps}.} even for explicitly hyphenated words.
 
 @item 4
-Do not hyphenate the last two characters of a word.
+disables hyphenation before the last two characters of a word.
 
 @item 8
-Do not hyphenate the first two characters of a word.
+disables hyphenation after the first two characters of a word.
 
 @item 16
-Allow hyphenation before the last character of a word.
+enables hyphenation before the last character of a word.
 
 @item 32
-Allow hyphenation after the first character of a word.
+enables hyphenation after the first character of a word.
 @end table
 
-The values in the previous table are additive.  For example,
-value@tie{}12 causes @code{gtroff} to neither hyphenate the last two nor
-the first two characters of a word.  Note that value@tie{}13 would do
-exactly the same; in other words, value@tie{}1 need not be added if the
-value is larger than@tie{}1.
-
-Some values cannot be used together because they contradict; for
-instance, values 4 and@tie{}16, and values 8 and@tie{}32.
-
-The number of characters at the beginning of a word after which the
-first hyphenation point should be inserted is determined by the patterns
-themselves; it can't be reduced further without introducing additional,
-invalid hyphenation points (unfortunately, this information is not part
-of a pattern file, you have to know it in advance).  The same is true
-for the number of characters at the end of word before the last
-hyphenation point should be inserted.  For example, the code
+Apart from value@tie{}2, restrictions imposed by the hyphenation mode
+are @emph{not} respected for words whose hyphenations have been
+specified with the hyphenation character (@samp{\%} by default) or the
+@code{hw} request.
+
+Nonzero values in the previous table are additive.  For example,
+mode@tie{}12 causes GNU @code{troff} to hyphenate neither the last two
+nor the first two characters of a word.  Some values cannot be used
+together because they contradict; for instance, values 4 and@tie{}16,
+and values 8 and@tie{}32.  As noted, it is superfluous to add 1 to any
+non-zero even mode.
+
+@cindex hyphenation pattern files
+@cindex pattern files, for hyphenation
+The automatic placement of hyphens in words is determined by
+@dfn{pattern files}, which are derived from @TeX{} and available for
+several languages.  The number of characters at the beginning of a word
+after which the first hyphenation point should be inserted is determined
+by the patterns themselves; it can't be reduced further without
+introducing additional, invalid hyphenation points (unfortunately, this
+information is not part of a pattern file---you have to know it in
+advance).  The same is true for the number of characters at the end of
+a word before the last hyphenation point should be inserted.  For
+example, you can supply the following input to @samp{echo $(nroff)}.
 
 @Example
 .ll 1
@@ -7095,168 +8583,60 @@
 splitting
 @endExample
 
-returns
+@noindent
+You will get
 
 @Example
-s-
-plit-
-t-
-in-
-g
-@endExample
-
-instead of the correct `split-ting'.  US-English patterns as distributed
-with groff need two characters at the beginning and three characters at
-the end; this means that value@tie{}4 of @code{hy} is mandatory.
-Value@tie{}8 is possible as an additional restriction, but values@tie{}1
-(the default!), 16, and@tie{}32 should be avoided.
-
-Here is a table of left and right minimum values for hyphenation as needed
-by the patterns distributed with groff; see the @cite{groff_tmac(5) man
-page} (type @command{man groff_tmac} at the command line) for more
-information on groff's language macro files.
+s- plit- t- in- g
+@endExample
+
+@noindent
+instead of the correct `split- ting'.  English patterns as distributed
+with GNU @code{troff} need two characters at the beginning and three
+characters at the end; this means that value@tie{}4 of @code{hy} is
+mandatory.  Value@tie{}8 is possible as an additional restriction, but
+values@tie{}16 and@tie{}32 should be avoided, as should mode@tie{}1.
+Modes@tie{}4 and@tie{}6 are typical.
+
+A table of left and right minimum character counts for hyphenation as
+needed by the patterns distributed with GNU @code{troff} follows; see
+the @cite{groff_tmac@r{(5)}} man page for more information on GNU
+@code{troff}'s language macro files.
 
 @multitable {German traditional}    {pattern name}    {left min}    {right min}
 @headitem    language           @tab pattern name @tab left min @tab right min
 @item        Czech              @tab cs           @tab 2        @tab 2
-@item        US English         @tab us           @tab 2        @tab 3
+@item        English            @tab en           @tab 2        @tab 3
 @item        French             @tab fr           @tab 2        @tab 3
 @item        German traditional @tab det          @tab 2        @tab 2
 @item        German reformed    @tab den          @tab 2        @tab 2
+@item        Italian            @tab it           @tab 2        @tab 2
 @item        Swedish            @tab sv           @tab 1        @tab 2
 @end multitable
 
 Hyphenation exceptions within pattern files (i.e., the words within a
-@code{\hyphenation} group) also obey the hyphenation restrictions given
-by @code{hy}.  However, exceptions specified with the @code{hw} do not.
-
-@cindex hyphenation restrictions register (@code{.hy})
-The current hyphenation restrictions can be found in the read-only
-number register @samp{.hy}.
-
-The hyphenation mode is associated with the current environment
-(@pxref{Environments}).
+@TeX{} @code{\hyphenation} group) obey the hyphenation restrictions
+given by @code{hy}.
 @endDefreq
 
 @Defreq {nh, }
-Disable hyphenation (i.e., set the hyphenation mode to zero).  Note that
-the hyphenation mode of the last call to @code{hy} is not remembered.
-
-The hyphenation mode is associated with the current environment
-(@pxref{Environments}).
-@endDefreq
-
-@DefreqList {hlm, @Var{nnn}}
-@DefregItemx {.hlm}
-@DefregListEndx {.hlc}
-@cindex explicit hyphen (@code{\%})
-@cindex hyphen, explicit (@code{\%})
-@cindex consecutive hyphenated lines (@code{hlm})
-@cindex lines, consecutive hyphenated (@code{hlm})
-@cindex hyphenated lines, consecutive (@code{hlm})
-Set the maximum number of consecutive hyphenated lines to @var{nnn}.  If
-this number is negative, there is no maximum.  The default value
-is@tie{}@minus{}1 if @var{nnn} is omitted.  This value is associated
-with the current environment (@pxref{Environments}).  Only lines output
-from a given environment count towards the maximum associated with that
-environment.  Hyphens resulting from @code{\%} are counted; explicit
-hyphens are not.
-
-The current setting of @code{hlm} is available in the @code{.hlm}
-read-only number register.  Also the number of immediately preceding
-consecutive hyphenated lines are available in the read-only number
-register @samp{.hlc}.
-@endDefreq
-
-@Defreq {hw, word1 word2 @dots{}}
-Define how @var{word1}, @var{word2}, etc.@: are to be hyphenated.  The
-words must be given with hyphens at the hyphenation points.  For
-example:
-
-@Example
-.hw in-sa-lub-rious
-@endExample
-
-@noindent
-Besides the space character, any character whose hyphenation code value
-is zero can be used to separate the arguments of @code{hw} (see the
-documentation for the @code{hcode} request below for more information).
-In addition, this request can be used more than once.
-
-@cindex @code{hw} request, and @code{hy} restrictions
-Hyphenation points specified with @code{hw} are not subject to the
-restrictions given by the @code{hy} request.
-
-Hyphenation exceptions specified with the @code{hw} request are
-associated with the current hyphenation language; it causes an error if
-there is no current hyphenation language.
-
-This request is ignored if there is no parameter.
-
-In old versions of @code{troff} there was a limited amount of space to
-store such information; fortunately, with @code{gtroff}, this is no
-longer a restriction.
+Disable automatic hyphenation; i.e., set the hyphenation mode to@tie{}0
+(see above).  The hyphenation mode of the last call to @code{hy} is not
+remembered.
 @endDefreq
 
-@DefescList {\\%, , , }
-@deffnx Escape @t{\:}
-@ifnotinfo
-@esindex \:
-@end ifnotinfo
-@ifinfo
-@esindex \@r{<colon>}
-@end ifinfo
-@cindex hyphenation character (@code{\%})
-@cindex character, hyphenation (@code{\%})
-@cindex disabling hyphenation (@code{\%})
-@cindex hyphenation, disabling (@code{\%})
-To tell @code{gtroff} how to hyphenate words on the fly, use the
-@code{\%} escape, also known as the @dfn{hyphenation character}.
-Preceding a word with this character prevents it from being
-hyphenated; putting it inside a word indicates to @code{gtroff} that
-the word may be hyphenated at that point.  Note that this mechanism
-only affects that one occurrence of the word; to change the
-hyphenation of a word for the entire document, use the @code{hw}
-request.
-
-The @code{\:} escape inserts a zero-width break point (that is, the word
-breaks but without adding a hyphen).
-
-@Example
-... check the /var/log/\:httpd/\:access_log file ...
-@endExample
-
-@cindex @code{\X}, followed by @code{\%}
-@cindex @code{\Y}, followed by @code{\%}
-@cindex @code{\%}, following @code{\X} or @code{\Y}
-Note that @code{\X} and @code{\Y} start a word, that is, the @code{\%}
-escape in (say) @w{@samp{\X'...'\%foobar}} and
-@w{@samp{\Y'...'\%foobar}} no longer prevents hyphenation but inserts a
-hyphenation point at the beginning of @samp{foobar}; most likely this
-isn't what you want to do.
-@endDefesc
-
-@Defreq {hc, @Var{char}}
-Change the hyphenation character to @var{char}.  This character then
-works the same as the @code{\%} escape, and thus, no longer appears in
-the output.  Without an argument, @code{hc} resets the hyphenation
-character to be @code{\%} (the default) only.
-
-The hyphenation character is associated with the current environment
-(@pxref{Environments}).
-@endDefreq
-
-@DefreqList {hpf, pattern_file}
-@DefreqItemx {hpfa, pattern_file}
-@DefreqListEndx {hpfcode, a b c d @dots{}}
+@need 200
+@DefreqList {hpf, pattern-file}
+@DefreqItemx {hpfa, pattern-file}
+@DefreqListEndx {hpfcode, a b c d @dots{}}
 @cindex hyphenation patterns (@code{hpf})
 @cindex patterns for hyphenation (@code{hpf})
-Read in a file of hyphenation patterns.  This file is searched for in
-the same way as @file{@var{name}.tmac} (or @file{tmac.@var{name}}) is
-searched for if the @option{-m@var{name}} option is specified.
-
-It should have the same format as (simple) @TeX{} patterns files.  More
-specifically, the following scanning rules are implemented.
+Read hyphenation patterns from @var{pattern-file}, which is sought
+in the same way that macro files are with the @code{mso} request or the
+@option{-m@var{name}} command-line option to @code{groff}.  The
+@var{pattern-file} should have the same format as (simple) @TeX{}
+pattern files.  More specifically, the following scanning rules are
+implemented.
 
 @itemize @bullet
 @item
@@ -7264,19 +8644,19 @@
 preceded by a backslash.
 
 @item
-No support for `digraphs' like @code{\$}.
+``Digraphs'' like @code{\$} are not supported.
 
 @item
-@code{^^@var{xx}} (@var{x} is 0--9 or a--f) and @code{^^@var{x}}
-(character code of @var{x} in the range 0--127) are recognized; other use
-of @code{^} causes an error.
+@code{^^@var{xx}} (where each @var{x} is 0--9 or a--f) and
+@code{^^@var{c}} (character @var{c} in the code point range 0--127
+decimal) are recognized; other uses of @code{^} cause an error.
 
 @item
-No macro expansion.
+No macro expansion is performed.
 
 @item
 @code{hpf} checks for the expression @code{\patterns@{@dots{}@}}
-(possibly with whitespace before and after the braces).  Everything
+(possibly with whitespace before or after the braces).  Everything
 between the braces is taken as hyphenation patterns.  Consequently,
 @code{@{} and @code{@}} are not allowed in patterns.
 
@@ -7288,64 +8668,71 @@
 @code{\endinput} is recognized also.
 
 @item
-For backwards compatibility, if @code{\patterns} is missing, the whole
-file is treated as a list of hyphenation patterns (only recognizing the
-@code{%} character as the start of a comment).
+For backward compatibility, if @code{\patterns} is missing, the whole
+file is treated as a list of hyphenation patterns (except that the
+@code{%} character is recognized as the start of a comment).
 @end itemize
 
-If no @code{hpf} request is specified (either in the document or in a
-macro package), @code{gtroff} won't hyphenate at all.
-
 The @code{hpfa} request appends a file of patterns to the current list.
 
 The @code{hpfcode} request defines mapping values for character codes in
-hyphenation patterns.  @code{hpf} or @code{hpfa} then apply the mapping
-(after reading the patterns) before replacing or appending them to the
-current list of patterns.  Its arguments are pairs of character codes --
-integers from 0 to@tie{}255.  The request maps character
-code@tie{}@var{a} to code@tie{}@var{b}, code@tie{}@var{c} to
-code@tie{}@var{d}, and so on.  You can use character codes that would
-be invalid otherwise.  By default, everything maps to itself except
-letters `A' to `Z', which map to `a' to `z'.
-
+pattern files.  It is an older mechanism no longer used by GNU
+@code{troff}'s own macro files; for its successor, see @code{hcode}
+below.  @code{hpf} or @code{hpfa} apply the mapping after reading the
+patterns but before replacing or appending to the active list of
+patterns.  Its arguments are pairs of character codes---integers from 0
+to@tie{}255.  The request maps character code@tie{}@var{a} to
+code@tie{}@var{b}, code@tie{}@var{c} to code@tie{}@var{d}, and so on.
+Character codes that would otherwise be invalid in GNU @code{troff} can
+be used.  By default, every code maps to itself except those for letters
+`A' to `Z', which map to those for `a' to `z'.
 
+@cindex localization
 @pindex troffrc
-@pindex troffrc-end
-@pindex hyphen.us
-@pindex hyphenex.us
-The set of hyphenation patterns is associated with the current language
-set by the @code{hla} request.  The @code{hpf} request is usually
-invoked by the @file{troffrc} or @file{troffrc-end} file; by default,
-@file{troffrc} loads hyphenation patterns and exceptions for American
-English (in files @file{hyphen.us} and @file{hyphenex.us}).
+@pindex cs.tmac
+@pindex de.tmac
+@pindex en.tmac
+@pindex fr.tmac
+@pindex it.tmac
+@pindex ja.tmac
+@pindex sv.tmac
+@pindex zh.tmac
+The set of hyphenation patterns is associated with the language set by
+the @code{hla} request (see below).  The @code{hpf} request is usually
+invoked by a localization file loaded by the @file{troffrc}
+file.@footnote{For more on localization, see the
+@cite{groff_tmac@r{(5)}} man page.}
 
 A second call to @code{hpf} (for the same language) replaces the
-hyphenation patterns with the new ones.
-
-Invoking @code{hpf} causes an error if there is no current hyphenation
-language.
+hyphenation patterns with the new ones.  Invoking @code{hpf} or
+@code{hpfa} causes an error if there is no hyphenation language.  If no
+@code{hpf} request is specified (either in the document, in a file
+loaded at startup, or in a macro package), GNU @code{troff} won't
+automatically hyphenate at all.
 @endDefreq
 
-@Defreq {hcode, c1 code1 c2 code2 @dots{}}
+@Defreq {hcode, c1 code1 c2 code2 @dots{}}
 @cindex hyphenation code (@code{hcode})
 @cindex code, hyphenation (@code{hcode})
 Set the hyphenation code of character @var{c1} to @var{code1}, that of
-@var{c2} to @var{code2}, etc.  A hyphenation code must be a single input
-character (not a special character) other than a digit or a space.
+@var{c2} to @var{code2}, and so on.  A hyphenation code must be an
+ordinary character (not a special character escape sequence) other than
+a digit or a space.  The request is ignored if given no arguments.
+
+For hyphenation to work, hyphenation codes must be set up.  At
+startup, GNU @code{troff} assigns hyphenation codes to the letters
+@samp{a}--@samp{z} (mapped to themselves), to the letters
+@samp{A}--@samp{Z} (mapped to @samp{a}--@samp{z}), and zero to all other
+characters.  Normally, hyphenation patterns contain only lowercase
+letters which should be applied regardless of case.  In other words,
+they assume that the words `FOO' and `Foo' should be hyphenated exactly
+as `foo' is.  The @code{hcode} request extends this principle to letters
+outside the Unicode basic Latin alphabet; without it, words containing
+such letters won't be hyphenated properly even if the corresponding
+hyphenation patterns contain them.
 
-To make hyphenation work, hyphenation codes must be set up.  At
-start-up, groff only assigns hyphenation codes to the letters
-@samp{a}--@samp{z} (mapped to themselves) and to the letters
-@samp{A}--@samp{Z} (mapped to @samp{a}--@samp{z}); all other hyphenation
-codes are set to zero.  Normally, hyphenation patterns contain only
-lowercase letters, which should be applied regardless of case.  In
-other words, the words `FOO' and `Foo' should be hyphenated exactly the
-same way as the word `foo' is hyphenated, and this is what @code{hcode}
-is good for.  Words that contain other letters won't be hyphenated
-properly if the corresponding hyphenation patterns actually do contain
-them.  For example, the following @code{hcode} requests are necessary to
-assign hyphenation codes to the letters @samp{ÄäÖöÜüß} (this is needed
-for German):
+For example, the following @code{hcode} requests are necessary to assign
+hyphenation codes to the letters @samp{ÄäÖöÜüß}, needed for German.
 
 @Example
 .hcode ä ä  Ä ä
@@ -7354,14 +8741,55 @@
 .hcode ß ß
 @endExample
 
-Without those assignments, groff treats German words like
-@w{`Kindergärten'} (the plural form of `kindergarten') as two substrings
+Without these assignments, GNU @code{troff} treats the German word
+@w{`Kindergärten'} (the plural form of `kindergarten') as two words
 @w{`kinderg'} and @w{`rten'} because the hyphenation code of the
-umlaut@tie{}a is zero by default.  There is a German hyphenation pattern
-that covers @w{`kinder'}, so groff finds the hyphenation `kin-der'.
-The other two hyphenation points (`kin-der-gär-ten') are missed.
+umlaut@tie{}a is zero by default, just like a space.  There is a German
+hyphenation pattern that covers @w{`kinder'}, so GNU @code{troff} finds
+the hyphenation `kin-der'.  The other two hyphenation points
+(`kin-der-gär-ten') are missed.
+@endDefreq
 
-This request is ignored if it has no parameter.
+@DefreqList {hla, lang}
+@DefregListEndx {.hla}
+@cindex @code{hpf} request, and hyphenation language
+@cindex @code{hw} request, and hyphenation language
+@pindex troffrc
+@pindex troffrc-end
+Set the hyphenation language to @var{lang}.  Hyphenation exceptions
+specified with the @code{hw} request and hyphenation patterns and
+exceptions specified with the @code{hpf} and @code{hpfa} requests are
+associated with the hyphenation language.  The @code{hla} request is
+usually invoked by a localization file, which is turn loaded by the
+@file{troffrc} or @file{troffrc-end} file; see the @code{hpf} request
+above.
+
+@cindex hyphenation language register (@code{.hla})
+The hyphenation language is available in the read-only string-valued
+register @samp{.hla}; it is associated with the environment
+(@pxref{Environments}).
+@endDefreq
+
+@DefreqList {hlm, @Var{n}}
+@DefregItemx {.hlm}
+@DefregListEndx {.hlc}
+@cindex explicit hyphen (@code{\%})
+@cindex hyphen, explicit (@code{\%})
+@cindex consecutive hyphenated lines (@code{hlm})
+@cindex lines, consecutive hyphenated (@code{hlm})
+@cindex hyphenated lines, consecutive (@code{hlm})
+Set the maximum quantity of consecutive hyphenated lines to @var{n}.  If
+@var{n} is negative, there is no maximum.  If omitted, @var{n}
+is@tie{}@minus{}1.  This value is associated with the environment
+(@pxref{Environments}).  Only lines output from a given environment
+count toward the maximum associated with that environment.  Hyphens
+resulting from @code{\%} are counted; explicit hyphens are not.
+
+@cindex hyphenation consecutive line limit register (@code{.hlm})
+@cindex hyphenation consecutive line count register (@code{.hlc})
+The @code{.hlm} read-only register stores this maximum.  The count of
+immediately preceding consecutive hyphenated lines is available in the
+read-only register @code{.hlc}.
 @endDefreq
 
 @DefreqList {hym, @Var{length}}
@@ -7369,107 +8797,90 @@
 @cindex hyphenation margin (@code{hym})
 @cindex margin for hyphenation (@code{hym})
 @cindex @code{ad} request, and hyphenation margin
-Set the (right) hyphenation margin to @var{length}.  If the current
-adjustment mode is not @samp{b} or @samp{n}, the line is not hyphenated
-if it is shorter than @var{length}.  Without an argument, the
-hyphenation margin is reset to its default value, which is@tie{}0.  The
-default scaling indicator for this request is @samp{m}.  The hyphenation
-margin is associated with the current environment
+Set the (right) hyphenation margin to @var{length}.  If the adjustment
+mode is not @samp{b} or @samp{n}, the line is not hyphenated if it is
+shorter than @var{length}.  Without an argument, the hyphenation margin
+is reset to its default value, 0.  The default scaling unit is @samp{m}.
+The hyphenation margin is associated with the environment
 (@pxref{Environments}).
 
 A negative argument resets the hyphenation margin to zero, emitting a
-warning of type @samp{range}.
+warning in category @samp{range}.
 
 @cindex hyphenation margin register (@code{.hym})
-The current hyphenation margin is available in the @code{.hym} read-only
-number register.
+The hyphenation margin is available in the @code{.hym} read-only
+register.
 @endDefreq
 
-@DefreqList {hys, @Var{hyphenation_space}}
+@DefreqList {hys, @Var{hyphenation-space}}
 @DefregListEndx {.hys}
 @cindex hyphenation space (@code{hys})
+@cindex hyphenation space adjustment threshold
 @cindex @code{ad} request, and hyphenation space
-Set the hyphenation space to @var{hyphenation_space}.  If the current
-adjustment mode is @samp{b} or @samp{n}, don't hyphenate the line if it
-can be justified by adding no more than @var{hyphenation_space} extra
-space to each word space.  Without argument, the hyphenation space is
-set to its default value, which is@tie{}0.  The default scaling
-indicator for this request is @samp{m}.  The hyphenation space is
-associated with the current environment (@pxref{Environments}).
-
-A negative argument resets the hyphenation space to zero, emitting a
-warning of type @samp{range}.
-
-@cindex hyphenation space register (@code{.hys})
-The current hyphenation space is available in the @code{.hys} read-only
-number register.
-@endDefreq
-
-@Defreq {shc, @Var{glyph}}
-@cindex soft hyphen character, setting (@code{shc})
-@cindex character, soft hyphen, setting (@code{shc})
-@cindex glyph, soft hyphen (@code{hy})
-@cindex soft hyphen glyph (@code{hy})
-@cindex @code{char} request, and soft hyphen character
-@cindex @code{tr} request, and soft hyphen character
-Set the @dfn{soft hyphen character} to @var{glyph}.@footnote{@dfn{Soft
-hyphen character} is a misnomer since it is an output glyph.}  If the
-argument is omitted, the soft hyphen character is set to the default
-glyph @code{\(hy} (this is the start-up value of @code{gtroff} also).
-The soft hyphen character is the glyph that is inserted when a word is
-hyphenated at a line break.  If the soft hyphen character does not exist
-in the font of the character immediately preceding a potential break
-point, then the line is not broken at that point.  Neither definitions
-(specified with the @code{char} request) nor translations (specified
-with the @code{tr} request) are considered when finding the soft hyphen
-character.
-@endDefreq
-
-@DefreqList {hla, language}
-@DefregListEndx {.hla}
-@cindex @code{hpf} request, and hyphenation language
-@cindex @code{hw} request, and hyphenation language
-@pindex troffrc
-@pindex troffrc-end
-Set the current hyphenation language to the string @var{language}.
-Hyphenation exceptions specified with the @code{hw} request and
-hyphenation patterns specified with the @code{hpf} and @code{hpfa}
-requests are both associated with the current hyphenation language.  The
-@code{hla} request is usually invoked by the @file{troffrc} or the
-@file{troffrc-end} files; @file{troffrc} sets the default language to
-@samp{us}.
+Suppress hyphenation of the line in adjustment modes @samp{b} or
+@samp{n} if it can be justified by adding no more than
+@var{hyphenation-space} extra space to each inter-word space.  Without
+an argument, the hyphenation space adjustment threshold is set to its
+default value, 0.  The default scaling unit is @samp{m}.  The
+hyphenation space adjustment threshold is associated with the
+environment (@pxref{Environments}).
 
-@cindex hyphenation language register (@code{.hla})
-The current hyphenation language is available as a string in the
-read-only number register @samp{.hla}.
+A negative argument resets the hyphenation space adjustment threshold to
+zero, emitting a warning in category @samp{range}.
 
-@Example
-.ds curr_language \n.hla
-\*curr_language
-    @result{} us
-@endExample
+@cindex hyphenation space adjustment threshold register (@code{.hys})
+The hyphenation space adjustment threshold is available in the
+@code{.hys} read-only register.
 @endDefreq
 
 
 @c =====================================================================
 
-@node Manipulating Spacing, Tabs and Fields, Manipulating Hyphenation, gtroff Reference
+@node Manipulating Spacing, Tabs and Fields, Manipulating Hyphenation, GNU troff Reference
 @section Manipulating Spacing
 @cindex manipulating spacing
 @cindex spacing, manipulating
 
+A break causes the formatter to update the vertical drawing position at
+which the new text baseline is aligned.  You can alter this location.
+
 @Defreq {sp, @Var{distance}}
-Space downwards @var{distance}.  With no argument it advances
-1@tie{}line.  A negative argument causes @code{gtroff} to move up the
-page the specified distance.  If the argument is preceded by a @samp{|}
-then @code{gtroff} moves that distance from the top of the page.  This
-request causes a line break, and that adds the current line spacing to
-the space you have just specified.  The default scaling indicator is
-@samp{v}.
-
-For convenience you may wish to use the following macros to set the
-height of the next line at a given distance from the top or the bottom
-of the page:
+Break and move the next text baseline down by @var{distance}, or until
+springing a page location trap.@footnote{@xref{Page Location Traps}.}
+If invoked with the no-break control character, @code{sp} moves the
+pending output line's text baseline by @var{distance}.  A negative
+@var{distance} will not reduce the position of the text baseline below
+zero.  Inside a diversion, any @var{distance} argument is ignored.  The
+default scaling unit is @samp{v}.  If @var{distance} is not specified,
+@samp{1v} is assumed.
+
+@Example
+.pl 5v \" Set page length to 5 vees.
+.de xx
+\-\-\-
+.  br
+..
+.wh 0 xx \" Set a trap at the top of the page.
+foo on page \n%
+.sp 2v
+bar on page \n%
+.sp 50v \" This will cause a page break.
+baz on page \n%
+.pl \n(nlu \" Truncate page to current position.
+    @result{} ---
+    @result{} foo on page 1
+    @result{}
+    @result{}
+    @result{} bar on page 1
+    @result{} ---
+    @result{} baz on page 2
+@endExample
+
+You might use the following macros to set the baseline of the next
+output text at a given distance from the top or the bottom of the page.
+We subtract one line height (@code{\n.v}) because the @code{|}
+operator moves to one vee below the page top (recall @ref{Numeric
+Expressions}).
 
 @Example
 .de y-from-top-down
@@ -7482,124 +8893,88 @@
 @endExample
 
 @noindent
-A call to @samp{.y-from-bot-up 10c} means that the bottom of the next
-line will be at 10@tie{}cm from the paper edge at the bottom.
-
-If a vertical trap is sprung during execution of @code{sp}, the amount
-of vertical space after the trap is discarded.  For example, this
-
-@Example
-.de xxx
-..
-.
-.wh 0 xxx
-.
-.pl 5v
-foo
-.sp 2
-bar
-.sp 50
-baz
-@endExample
-
-@noindent
-results in
-
-@Example
-foo
-
-
-bar
-
-baz
-@endExample
-
-@cindex @code{sp} request, and traps
-@cindex discarded space in traps
-@cindex space, discarded, in traps
-@cindex traps, and discarded space
-The amount of discarded space is available in the number register
-@code{.trunc}.
-
-To protect @code{sp} against vertical traps, use the @code{vpt} request:
-
-@Example
-.vpt 0
-.sp -3
-.vpt 1
-@endExample
+A call to @samp{.y-from-bot-up 10c} means that the next text baseline
+will be 10@tie{}cm from the bottom edge of the paper.
 @endDefreq
 
-@DefreqList {ls, @Var{nnn}}
+@DefreqList {ls, @Var{count}}
 @DefregListEndx {.L}
 @cindex double-spacing (@code{ls})
-Output @w{@var{nnn}@minus{}1} blank lines after each line of text.  With
-no argument, @code{gtroff} uses the previous value before the last
-@code{ls} call.
-
-@Example
-.ls 2    \" This causes double-spaced output
-.ls 3    \" This causes triple-spaced output
-.ls      \" Again double-spaced
-@endExample
-
-The line spacing is associated with the current environment
-(@pxref{Environments}).
+Set the line spacing; add @w{@var{count}@minus{}1} blank lines after each
+line of text.  With no argument, GNU @code{troff} uses the previous
+value before the last @code{ls} call.  The default is @code{1}.
+
+@c This example is fairly obvious, doesn't realistically reflect the
+@c fact that formatted text would occur between each of these requests,
+@c and doesn't fit well on the (PDF) page as of this writing.
+@c @Example
+@c .ls 2    \" begin double-spaced output
+@c .ls 3    \" begin triple-spaced output
+@c .ls      \" return to double-spaced output
+@c @endExample
 
 @cindex line spacing register (@code{.L})
-The read-only number register @code{.L} contains the current line
-spacing setting.
+The read-only register @code{.L} contains the current line spacing; it
+is associated with the environment (@pxref{Environments}).
 @endDefreq
 
-@xref{Changing Type Sizes}, for the requests @code{vs} and @code{pvs} as
-alternatives to @code{ls}.
+The @code{ls} request is a coarse mechanism.  @xref{Changing the Type
+Size}, for the requests @code{vs} and @code{pvs} as alternatives to
+@code{ls}.
 
-@DefescList {\\x, ', spacing, '}
+@DefescList {\\x, @code{'}, spacing, @code{'}}
 @DefregListEndx {.a}
-Sometimes, extra vertical spacing is only needed occasionally, e.g.@: to
-allow space for a tall construct (like an equation).  The @code{\x}
-escape does this.  The escape is given a numerical argument, usually
-enclosed in quotes (like @samp{\x'3p'}); the default scaling indicator
-is @samp{v}.  If this number is positive extra vertical space is
-inserted below the current line.  A negative number adds space above.
-If this escape is used multiple times on the same line, the maximum of
-the values is used.
-
-@xref{Escapes}, for details on parameter delimiting characters.
+Sometimes, an output line requires additional vertical spacing, for
+instance to allow room for a tall construct like an inline equation with
+exponents or subscripts (particularly if they are iterated).  The
+@code{\x} escape sequence takes a delimited measurement (like
+@samp{\x'3p'}) to increase the vertical spacing of the pending output
+line.  The default scaling unit is @samp{v}.  If the measurement is
+positive, extra vertical space is inserted below the current line; a
+negative measurement adds space above.  If @code{\x} is applied to the
+pending output line multiple times, the maxima of the positive and
+negative adjustments are separately applied.  The delimiter need not be
+a neutral apostrophe; see @ref{Delimiters}.
 
 @cindex extra post-vertical line space register (@code{.a})
-The @code{.a} read-only number register contains the most recent
-(non-negative) extra vertical line space.
-
-Using @code{\x} can be necessary in combination with the @code{\b}
-escape, as the following example shows.
+The @code{.a} read-only register contains the extra vertical spacing
+@emph{after} the text baseline of the most recently emitted output line.
+(In other words, it is the largest positive argument to @code{\x}
+encountered on that line.)  This quantity is exposed via a register
+because if an output line requires this ``extra post-vertical line
+spacing'', and the subsequent output line requires ``extra pre-vertical
+line spacing'' (a negative argument to @code{\x}), then applying both
+can lead to excessive spacing between the output lines.  Text that is
+piling high on line @var{n} might not require (as much) extra
+pre-vertical line spacing if line @var{n}@minus{}1 carries extra
+post-vertical line spacing.
+
+Use of @code{\x} can be necessary in combination with the
+bracket-building escape sequence @code{\b},@footnote{@xref{Drawing
+Geometric Objects}.} as the following example shows.
 
 @Example
-This is a test with the \rsb escape.
-.br
-This is a test with the \rsb escape.
-.br
-This is a test with \b'xyz'\x'-1m'\x'1m'.
-.br
-This is a test with the \rsb escape.
-.br
-This is a test with the \rsb escape.
+.nf
+This is a test of \rsb (1).
+This is a test of \rsb (2).
+This is a test of \b'xyz'\x'-1m'\x'1m' (3).
+This is a test of \rsb (4).
+This is a test of \rsb (5).
+    @result{} This is a test of \b (1).
+    @result{} This is a test of \b (2).
+    @result{}                   x
+    @result{} This is a test of y (3).
+    @result{}                   z
+    @result{} This is a test of \b (4).
+    @result{} This is a test of \b (5).
 @endExample
+@endDefesc
 
 @noindent
-produces
-
-@Example
-This is a test with the \b escape.
-This is a test with the \b escape.
-                    x
-This is a test with y.
-                    z
-This is a test with the \b escape.
-This is a test with the \b escape.
-@endExample
-@endDefesc
+Without @code{\x}, the backslashes on the lines marked @samp{(2)} and
+@samp{(4)} would be overprinted.
 
+@need 1000
 @DefreqList {ns, }
 @DefreqItemx {rs, }
 @DefregListEndx {.ns}
@@ -7608,53 +8983,57 @@
 @cindex mode, no-space (@code{ns})
 @cindex blank lines, disabling
 @cindex lines, blank, disabling
-Enable @dfn{no-space mode}.  In this mode, spacing (either via @code{sp}
-or via blank lines) is disabled.  The @code{bp} request to advance to
-the next page is also disabled, except if it is accompanied by a page
-number (see @ref{Page Control}, for more information).  This mode ends
-when actual text is output or the @code{rs} request is encountered, which
-ends no-space mode.  The read-only number register @code{.ns} is set
-to@tie{}1 as long as no-space mode is active.
+Enable @dfn{no-space mode}.  Vertical spacing, whether by @code{sp}
+requests or blank input lines, is disabled.  The @code{bp} request to
+advance to the next page is also disabled, unless it is accompanied by a
+page number (@pxref{Page Control}).  No-space mode ends automatically
+when text@footnote{or geometric objects; see @ref{Drawing Geometric
+Objects}} is formatted for output @footnote{to the top-level diversion;
+see @ref{Diversions}} or the @code{rs} request is invoked, which ends
+no-space mode.  The read-only register @code{.ns} interpolates a Boolean
+value indicating the enablement of no-space mode.
 
-This request is useful for macros that conditionally insert vertical
-space before the text starts (for example, a paragraph macro could
-insert some space except when it is the first paragraph after a section
-header).
+A paragraphing macro might ordinarily insert vertical space to separate
+paragraphs.  A section heading macro could invoke @code{ns} to suppress
+this spacing for the first paragraph in a section.
 @endDefreq
 
 
 @c =====================================================================
 
-@node Tabs and Fields, Character Translations, Manipulating Spacing, gtroff Reference
+@node Tabs and Fields, Character Translations, Manipulating Spacing, GNU troff Reference
 @section Tabs and Fields
 @cindex tabs, and fields
 @cindex fields, and tabs
 
-@cindex @acronym{EBCDIC} encoding of a tab
-A tab character (@acronym{ASCII} char@tie{}9, @acronym{EBCDIC}
-char@tie{}5) causes a horizontal movement to the next tab stop (much
-like it did on a typewriter).
+@cindex tab character encoding
+A tab character (@acronym{ISO} code point@tie{}9, @acronym{EBCDIC}
+code point@tie{}5) causes a horizontal movement to the next tab stop, if
+any.
 
 @Defesc {\\t, , , }
 @cindex tab character, non-interpreted (@code{\t})
 @cindex character, tab, non-interpreted (@code{\t})
-@cindex @code{\t}, and copy-in mode
-@cindex copy-in mode, and @code{\t}
-@cindex mode, copy-in, and @code{\t}
-This escape is a non-interpreted tab character.  In copy mode
-(@pxref{Copy-in Mode}), @code{\t} is the same as a real tab character.
+@cindex @code{\t}, and copy mode
+@cindex copy mode, and @code{\t}
+@cindex mode, copy, and @code{\t}
+Interpolate a tab in copy mode; see @ref{Copy Mode}.
 @endDefesc
 
-@DefreqList {ta, @Var{n1} @Var{n2} @dots{} @Var{nn} @t{T} @Var{r1} @Var{r2} @dots{} @Var{rn}}
+@DefreqList {ta, @Var{n1} @Var{n2} @dots{} @Var{nn} @t{T} @Var{r1} @
+ @Var{r2} @dots{} @Var{rn}}
 @DefregListEndx {.tabs}
 Change tab stop positions.  This request takes a series of tab
 specifiers as arguments (optionally divided into two groups with the
-letter @samp{T}) that indicate where each tab stop is to be (overriding
-any previous settings).
+letter @samp{T}) that indicate where each tab stop is to be, overriding
+any previous settings.  The default scaling unit is @samp{m}.  Invoking
+@code{ta} without an argument removes all tab stops.
+@cindex default tab stops
+@cindex tab stops, default
+GNU @code{troff}'s startup value is @w{@samp{T 0.5i}}.
 
-Tab stops can be specified absolutely, i.e., as the distance from the
-left margin.  For example, the following sets 6@tie{}tab stops every one
-inch.
+Tab stops can be specified absolutely---as distances from the left
+margin.  The following example sets six tab stops, one every inch.
 
 @Example
 .ta 1i 2i 3i 4i 5i 6i
@@ -7668,77 +9047,83 @@
 .ta 1i +1i +1i +1i +1i +1i
 @endExample
 
-@code{gtroff} supports an extended syntax to specify repeat values after
-the @samp{T} mark (these values are always taken as relative) -- this is
-the usual way to specify tabs set at equal intervals.  The following is,
-yet again, the same as the previous examples.  It does even more since
-it defines an infinite number of tab stops separated by one inch.
+GNU @code{troff} supports an extended syntax to specify repeating tab
+stops.  These stops appear after a @samp{T} argument.  Their values are
+always taken as distances relative to the previous tab stop.  This is
+the idiomatic way to specify tab stops at equal intervals in
+@code{groff}.  The following is, yet again, the same as the previous
+examples.  It does more, in fact, since it defines an infinite number of
+tab stops at one-inch intervals.
 
 @Example
 .ta T 1i
 @endExample
 
-Now we are ready to interpret the full syntax given at the beginning:
-Set tabs at positions @var{n1}, @var{n2}, @dots{}, @var{nn} and then set
-tabs at @var{nn}+@var{r1}, @var{nn}+@var{r2}, @dots{}, @var{nn}+@var{rn}
-and then at @var{nn}+@var{rn}+@var{r1}, @var{nn}+@var{rn}+@var{r2},
-@dots{}, @var{nn}+@var{rn}+@var{rn}, and so on.
-
-Example: @samp{4c +6c T 3c 5c 2c} is equivalent to @samp{4c 10c 13c 18c
-20c 23c 28c 30c @dots{}}.
-
-The material in each tab column (i.e., the column between two tab stops)
-may be justified to the right or left or centered in the column.  This
-is specified by appending @samp{R}, @samp{L}, or @samp{C} to the tab
-specifier.  The default justification is @samp{L}.  Example:
+Now we are ready to interpret the full syntax given above.  The
+@code{ta} request sets tabs at positions @var{n1}, @var{n2}, @dots{},
+@var{nn}, then at @var{nn}+@var{r1}, @var{nn}+@var{r2}, @dots{},
+@var{nn}+@var{rn}, then at @var{nn}+@var{rn}+@var{r1},
+@var{nn}+@var{rn}+@var{r2}, @dots{}, @var{nn}+@var{rn}+@var{rn}, and so
+on.
+
+For example, @samp{4c +6c T 3c 5c 2c} is equivalent to @samp{4c 10c 13c
+18c 20c 23c 28c 30c @dots{}}.
+
+Text written to a tab column (i.e., between two tab stops, or between a
+tab stop and an output line boundary) may be aligned to the right or
+left, or centered in the column.  This alignment is determined by
+appending @samp{R}, @samp{L}, or @samp{C} to the tab specifier.  The
+default is @samp{L}.
 
 @Example
 .ta 1i 2iC 3iR
 @endExample
 
-Some notes:
+The beginning of an output line is not a tab stop; the text that begins
+an output line is placed according to the configured alignment and
+indentation; see @ref{Manipulating Filling and Adjustment} and @ref{Line
+Layout}.
 
-@itemize @bullet
-@item
-The default unit of the @code{ta} request is @samp{m}.
-
-@item
 A tab stop is converted into a non-breakable horizontal movement that
-can be neither stretched nor squeezed.  For example,
+cannot be adjusted.
 
 @Example
+.ll 2i
 .ds foo a\tb\tc
-.ta T 5i
+.ta T 1i
 \*foo
+    @error{} warning: cannot break line
+    @result{} a         b         c
 @endExample
 
 @noindent
-creates a single line, which is a bit longer than 10@tie{}inches (a
-string is used to show exactly where the tab characters are).  Now
-consider the following:
+The above creates a single output line that is a bit longer than two
+inches (we use a string to show exactly where the tab stops are).
+Now consider the following.
 
 @Example
-.ds bar a\tb b\tc
-.ta T 5i
+.ll 2i
+.ds bar a\tb c\td
+.ta T 1i
 \*bar
+    @error{} warning: cannot adjust line
+    @result{} a         b
+    @result{} c       d
 @endExample
 
 @noindent
-@code{gtroff} first converts the tab stops of the line into unbreakable
-horizontal movements, then splits the line after the second @samp{b}
-(assuming a sufficiently short line length).  Usually, this isn't what
-the user wants.
+GNU @code{troff} first converts the line's tab stops into unbreakable
+horizontal movements, then breaks after @samp{b}.  This usually isn't
+what you want.
 
-@item
-Superfluous tabs (i.e., tab characters that do not correspond to a tab
-stop) are ignored except the first one, which delimits the characters
-belonging to the last tab stop for right-justifying or centering.
-Consider the following example
+Superfluous tab characters---those that do not correspond to a tab
+stop---are ignored except for the first, which delimits the characters
+belonging to the last tab stop for right-alignment or centering.
 
 @Example
-.ds Z   foo\tbar\tfoo
-.ds ZZ  foo\tbar\tfoobar
-.ds ZZZ foo\tbar\tfoo\tbar
+.ds Z   foo\tbar\tbaz
+.ds ZZ  foo\tbar\tbazqux
+.ds ZZZ foo\tbar\tbaz\tqux
 .ta 2i 4iR
 \*Z
 .br
@@ -7746,62 +9131,47 @@
 .br
 \*ZZZ
 .br
+    @result{} foo                 bar              baz
+    @result{} foo                 bar           bazqux
+    @result{} foo                 bar              bazqux
 @endExample
 
 @noindent
-which produces the following output:
-
-@Example
-foo                 bar              foo
-foo                 bar           foobar
-foo                 bar              foobar
-@endExample
-
-@noindent
-The first line right-justifies the second `foo' relative to the tab
-stop.  The second line right-justifies `foobar'.  The third line finally
-right-justifies only `foo' because of the additional tab character, which
-marks the end of the string belonging to the last defined tab stop.
+The first line right-aligns ``baz'' within the second tab stop.  The
+second line right-aligns ``bazqux'' within it.  The third line
+right-aligns only ``baz'' because of the additional tab character, which
+marks the end of the text occupying the last tab stop defined.
 
-@item
-Tab stops are associated with the current environment
-(@pxref{Environments}).
+Tab stops are associated with the environment (@pxref{Environments}).
 
-@item
-Calling @code{ta} without an argument removes all tab stops.
-
-@item
-@cindex tab stops, for TTY output devices
-The start-up value of @code{gtroff} is @w{@samp{T 0.5i}}.
-@end itemize
-
-@cindex tab settings register (@code{.tabs})
-The read-only number register @code{.tabs} contains a string
+@cindex tab stop settings register (@code{.tabs})
+@cindex @code{.S} register, Plan@tie{}9 alias for @code{.tabs}
+@cindex @code{.tabs} register, Plan@tie{}9 alias (@code{.S})
+The read-only register @code{.tabs} contains a string
 representation of the current tab settings suitable for use as an
-argument to the @code{ta} request.
+argument to the @code{ta} request.@footnote{Plan@tie{}9 @code{troff}
+uses the register @code{.S} for this purpose.}
 
 @Example
 .ds tab-string \n.tabs
 \*tab-string
     @result{} T120u
 @endExample
-
-@cindex @code{.S} register, Plan@tie{}9 alias for @code{.tabs}
-@cindex @code{.tabs} register, Plan@tie{}9 alias (@code{.S})
-The @code{troff} version of the Plan@tie{}9 operating system uses
-register @code{.S} for the same purpose.
 @endDefreq
 
-@Defreq {tc, @Var{fill-glyph}}
+@Defreq {tc, @Var{c}}
 @cindex tab repetition character (@code{tc})
 @cindex character, tab repetition (@code{tc})
 @cindex glyph, tab repetition (@code{tc})
-Normally @code{gtroff} fills the space to the next tab stop with
-whitespace.  This can be changed with the @code{tc} request.  With no
-argument @code{gtroff} reverts to using whitespace, which is the
-default.  The value of this @dfn{tab repetition character} is associated
-with the current environment (@pxref{Environments}).@footnote{@dfn{Tab
-repetition character} is a misnomer since it is an output glyph.}
+Set the tab repetition character to the ordinary or special character
+@var{c}; normally, no glyph is written when moving to a tab stop (and
+some output devices may output space characters to achieve this motion).
+A @dfn{tab repetition character} causes the formatter to write as many
+instances of @var{c} as are necessary to occupy the interval from the
+horizontal drawing position to the next tab stop.  With no argument, GNU
+@code{troff} reverts to the default behavior.  The tab repetition
+character is associated with the environment (@pxref{Environments}).
+Only a single character of @var{c} is recognized; any excess is ignored.
 @endDefreq
 
 @DefreqList {linetabs, n}
@@ -7809,40 +9179,32 @@
 @cindex tab, line-tabs mode
 @cindex line-tabs mode
 @cindex mode, line-tabs
-If @var{n} is missing or not zero, enable @dfn{line-tabs} mode, or
-disable it otherwise (the default).  In line-tabs mode, @code{gtroff}
-computes tab distances relative to the (current) output line instead of
-the input line.
-
-For example, the following code:
+If @var{n} is missing or non-zero, activate @dfn{line-tabs}; deactivate
+it otherwise (the default).  Active line-tabs cause GNU @code{troff}
+to compute tab distances relative to the start of the output line
+instead of the input line.
 
 @Example
-.ds x a\t\c
-.ds y b\t\c
-.ds z c
-.ta 1i 3i
-\*x
-\*y
-\*z
-@endExample
-
-@noindent
-in normal mode, results in the output
-
-@Example
-a         b         c
-@endExample
-
-@noindent
-in line-tabs mode, the same code outputs
-
-@Example
-a         b                   c
+.de Tabs
+.  ds x a\t\c
+.  ds y b\t\c
+.  ds z c
+.  ta 1i 3i
+\\*x
+\\*y
+\\*z
+..
+.Tabs
+.br
+.linetabs
+.Tabs
+    @result{} a         b         c
+    @result{} a         b                   c
 @endExample
 
-Line-tabs mode is associated with the current environment.  The
-read-only register @code{.linetabs} is set to@tie{}1 if in line-tabs
-mode, and 0 in normal mode.
+Line-tabs activation is associated with the environment
+(@pxref{Environments}).  The read-only register @code{.linetabs}
+interpolates@tie{}1 if line-tabs are active, and 0 otherwise.
 @endDefreq
 
 @menu
@@ -7856,60 +9218,63 @@
 @subsection Leaders
 @cindex leaders
 
-Sometimes it may be desirable to use the @code{tc} request to fill a
-particular tab stop with a given glyph (for example dots in a table of
-contents), but also normal tab stops on the rest of the line.
-For this @code{gtroff} provides an alternate tab mechanism, called
-@dfn{leaders}, which does just that.
+Sometimes it is desirable to fill a tab stop with a given glyph,
+but also use tab stops normally on the same output line.  An example is
+a table of contents entry that uses dots to bridge the entry name with
+its page number, which is itself aligned between tab stops.  The
+@code{roff} language provides @dfn{leaders} for this
+purpose.@footnote{This is pronounced to rhyme with ``feeder'', and
+refers to how the glyphs ``lead'' the eye across the page to the
+corresponding page number or other datum.}
 
 @cindex leader character
-A leader character (character code@tie{}1) behaves similarly to a tab
-character: It moves to the next tab stop.  The only difference is that
-for this movement, the fill glyph defaults to a period character and not
-to space.
+A leader character (@acronym{ISO} and @acronym{EBCDIC} code
+point@tie{}1, also known as @acronym{SOH} or ``start of heading''),
+behaves similarly to a tab character:@: it moves to the next tab stop.
+The difference is that for this movement, the default fill character is
+a period @samp{.}.
 
 @Defesc {\\a, , , }
 @cindex leader character, non-interpreted (@code{\a})
 @cindex character, leader, non-interpreted (@code{\a})
-@cindex @code{\a}, and copy-in mode
-@cindex copy-in mode, and @code{\a}
-@cindex mode, copy-in, and @code{\a}
-This escape is a non-interpreted leader character.  In copy mode
-(@pxref{Copy-in Mode}), @code{\a} is the same as a real leader
-character.
+@cindex @code{\a}, and copy mode
+@cindex copy mode, and @code{\a}
+@cindex mode, copy, and @code{\a}
+Interpolate a leader in copy mode; see @ref{Copy Mode}.
 @endDefesc
 
-@Defreq {lc, @Var{fill-glyph}}
+@Defreq {lc, @Var{c}}
 @cindex leader repetition character (@code{lc})
 @cindex character, leader repetition (@code{lc})
 @cindex glyph, leader repetition (@code{lc})
-Declare the @dfn{leader repetition character}.@footnote{@dfn{Leader
-repetition character} is a misnomer since it is an output glyph.}
-Without an argument, leaders act the same as tabs (i.e., using
-whitespace for filling).  @code{gtroff}'s start-up value is a dot
-(@samp{.}).  The value of the leader repetition character is associated
-with the current environment (@pxref{Environments}).
+Set the leader repetition character to the ordinary or special character
+@var{c}.  Recall @ref{Tabs and Leaders}:@: when encountering a leader
+character in the input, the formatter writes as many dots @samp{.} as
+are necessary until
+reaching the next tab stop; this is the @dfn{leader definition
+character}.  Omitting @var{c} unsets the leader
+character.  With no argument, GNU @code{troff} treats leaders the same
+as tabs.  The leader repetition character is associated with the
+environment (@pxref{Environments}).  Only a single @var{c} is
+recognized; any excess is ignored.
 @endDefreq
 
 @cindex table of contents
 @cindex contents, table of
-For a table of contents, to name an example, tab stops may be defined so
-that the section number is one tab stop, the title is the second with
-the remaining space being filled with a line of dots, and then the page
-number slightly separated from the dots.
-
-@Example
-.ds entry 1.1\tFoo\a\t12
-.lc .
-.ta 1i 5i +.25i
-\*entry
-@endExample
-
-@noindent
-This produces
+A table of contents, for example, may define tab stops after a section
+number, a title, and a gap to be filled with leader dots.  The page
+number follows the leader, after a right-aligned final tab stop wide
+enough to house the largest page number occurring in the document.
 
 @Example
-1.1  Foo..........................................  12
+.ds entry1 19.\tThe Prophet\a\t98
+.ds entry2 20.\tAll Astir\a\t101
+.ta .5i 4.5i +.5iR
+.nf
+\*entry1
+\*entry2
+    @result{} 19.  The Prophet.............................   98
+    @result{} 20.  All Astir...............................  101
 @endExample
 
 @c ---------------------------------------------------------------------
@@ -7929,9 +9294,9 @@
 It contains substrings that are separated by @dfn{padding characters}.
 The width of a field is the distance on the @emph{input} line from the
 position where the field starts to the next tab stop.  A padding
-character inserts stretchable space similar to @TeX{}'s @code{\hss}
+character inserts an adjustable space similar to @TeX{}'s @code{\hss}
 command (thus it can even be negative) to make the sum of all substring
-lengths plus the stretchable space equal to the field width.  If more
+lengths plus the adjustable space equal to the field width.  If more
 than one padding character is inserted, the available space is evenly
 distributed among them.
 
@@ -7939,11 +9304,9 @@
 Define a delimiting and a padding character for fields.  If the latter
 is missing, the padding character defaults to a space character.  If
 there is no argument at all, the field mechanism is disabled (which is
-the default).  Note that contrary to e.g.@: the tab repetition
-character, delimiting and padding characters are @emph{not} associated
-to the current environment (@pxref{Environments}).
-
-Example:
+the default).  In contrast to, e.g., the tab repetition character,
+delimiting and padding characters are @emph{not} associated with the
+environment (@pxref{Environments}).
 
 @Example
 .fc # ^
@@ -7951,190 +9314,19 @@
 #foo^bar^smurf#
 .br
 #foo^^bar^smurf#
-@endExample
-
-@noindent
-and here the result:
-
-@Example
-foo         bar          smurf
-foo            bar       smurf
+    @result{} foo         bar          smurf
+    @result{} foo            bar       smurf
 @endExample
 @endDefreq
 
 
 @c =====================================================================
 
-@node Character Translations, Troff and Nroff Mode, Tabs and Fields, gtroff Reference
+@node Character Translations, @code{troff} and @code{nroff} Modes, Tabs and Fields, GNU troff Reference
 @section Character Translations
 @cindex character translations
 @cindex translations of characters
 
-@cindex control character, changing (@code{cc})
-@cindex character, control, changing (@code{cc})
-@cindex no-break control character, changing (@code{c2})
-@cindex character, no-break control, changing (@code{c2})
-@cindex control character, no-break, changing (@code{c2})
-The control character (@samp{.}) and the no-break control character
-(@samp{'}) can be changed with the @code{cc} and @code{c2} requests,
-respectively.
-
-@Defreq {cc, @Var{c}}
-Set the control character to@tie{}@var{c}.  With no argument the default
-control character @samp{.} is restored.  The value of the control
-character is associated with the current environment
-(@pxref{Environments}).
-@endDefreq
-
-@Defreq {c2, @Var{c}}
-Set the no-break control character to@tie{}@var{c}.  With no argument
-the default control character @samp{'} is restored.  The value of the
-no-break control character is associated with the current environment
-(@pxref{Environments}).
-@endDefreq
-
-@xref{Requests}.
-
-@Defreq {eo, }
-@cindex disabling @code{\} (@code{eo})
-@cindex @code{\}, disabling (@code{eo})
-Disable the escape mechanism completely.  After executing this request,
-the backslash character @samp{\} no longer starts an escape sequence.
-
-This request can be very helpful in writing macros since it is not
-necessary then to double the escape character.  Here an example:
-
-@Example
-.\" This is a simplified version of the
-.\" .BR request from the man macro package
-.eo
-.de BR
-.  ds result \&
-.  while (\n.$ >= 2) \@{\
-.    as result \fB\$1\fR\$2
-.    shift 2
-.  \@}
-.  if \n.$ .as result \fB\$1
-\*result
-.  ft R
-..
-.ec
-@endExample
-@endDefreq
-
-@Defreq {ec, @Var{c}}
-@cindex escape character, changing (@code{ec})
-@cindex character, escape, changing (@code{ec})
-Set the escape character to@tie{}@var{c}.  With no argument the default
-escape character @samp{\} is restored.  It can be also used to re-enable
-the escape mechanism after an @code{eo} request.
-
-Note that changing the escape character globally likely breaks macro
-packages since @code{gtroff} has no mechanism to `intern' macros, i.e.,
-to convert a macro definition into an internal form that is independent
-of its representation (@TeX{} has this mechanism).  If a macro is
-called, it is executed literally.
-@endDefreq
-
-@DefreqList {ecs, }
-@DefreqListEndx {ecr, }
-The @code{ecs} request saves the current escape character in an internal
-register.  Use this request in combination with the @code{ec} request to
-temporarily change the escape character.
-
-The @code{ecr} request restores the escape character saved with
-@code{ecs}.  Without a previous call to @code{ecs}, this request sets
-the escape character to @code{\}.
-@endDefreq
-
-@DefescList {\\\\, , , }
-@DefescItemx {\\e, , , }
-@DefescListEndx {\\E, , , }
-Print the current escape character (which is the backslash character
-@samp{\} by default).
-
-@code{\\} is a `delayed' backslash; more precisely, it is the default
-escape character followed by a backslash, which no longer has special
-meaning due to the leading escape character.  It is @emph{not} an escape
-sequence in the usual sense!  In any unknown escape sequence
-@code{\@var{X}} the escape character is ignored and @var{X} is printed.
-But if @var{X} is equal to the current escape character, no warning is
-emitted.
-
-@cindex @code{\E}, and copy-in mode
-@cindex copy-in mode, and @code{\E}
-@cindex mode, copy-in, and @code{\E}
-As a consequence, only at top-level or in a diversion a backslash glyph
-is printed; in copy-in mode, it expands to a single backslash, which then
-combines with the following character to an escape sequence.
-
-The @code{\E} escape differs from @code{\e} by printing an escape
-character that is not interpreted in copy mode.  Use this to define
-strings with escapes that work when used in copy mode (for example, as a
-macro argument).  The following example defines strings to begin and end
-a superscript:
-
-@Example
-.ds @{ \v'-.3m'\s'\En.s*60/100'
-.ds @} \s0\v'.3m'
-@endExample
-
-Another example to demonstrate the differences between the various
-escape sequences, using a strange escape character, @samp{-}.
-
-@Example
-.ec -
-.de xxx
---A'foo'
-..
-.xxx
-    @result{} -A'foo'
-@endExample
-
-@noindent
-The result is surprising for most users, expecting @samp{1} since
-@samp{foo} is a valid identifier.  What has happened?  As mentioned
-above, the leading escape character makes the following character
-ordinary.  Written with the default escape character the sequence
-@samp{--} becomes @samp{\-} -- this is the minus sign.
-
-If the escape character followed by itself is a valid escape sequence,
-only @code{\E} yields the expected result:
-
-@Example
-.ec -
-.de xxx
--EA'foo'
-..
-.xxx
-    @result{} 1
-@endExample
-@endDefesc
-
-@Defesc {\\., , , }
-Similar to @code{\\}, the sequence @code{\.} isn't a real escape
-sequence.  As before, a warning message is suppressed if the escape
-character is followed by a dot, and the dot itself is printed.
-
-@Example
-.de foo
-.  nop foo
-.
-.  de bar
-.    nop bar
-\\..
-.
-..
-.foo
-.bar
-    @result{} foo bar
-@endExample
-
-@noindent
-The first backslash is consumed while the macro is read, and the second
-is swallowed while executing macro @code{foo}.
-@endDefesc
-
 A @dfn{translation} is a mapping of an input character to an output
 glyph.  The mapping occurs at output time, i.e., the input character
 gets assigned the metric information of the mapped output character
@@ -8144,8 +9336,9 @@
 @DefreqList {tr, @Var{a}@Var{b}@Var{c}@Var{d}@dots{}}
 @DefreqListEndx {trin, @Var{a}@Var{b}@Var{c}@Var{d}@dots{}}
 Translate character @var{a} to glyph@tie{}@var{b}, character @var{c} to
-glyph@tie{}@var{d}, etc.  If there is an odd number of arguments, the
-last one is translated to an unstretchable space (@w{@samp{\ }}).
+glyph@tie{}@var{d}, and so on.  If there is an odd number of characters
+in the argument, the last one is translated to a fixed-width space (the
+same one obtained by the @code{\@key{SP}} escape sequence).
 
 The @code{trin} request is identical to @code{tr}, but when you unformat
 a diversion with @code{asciify} it ignores the translation.
@@ -8180,8 +9373,9 @@
 @item
 @cindex @code{\%}, and translations
 @cindex @code{\~}, and translations
-Characters can be mapped onto the @code{\%} and @code{\~} escapes (but
-@code{\%} and @code{\~} can't be mapped onto another glyph).
+Characters can be mapped onto the @code{\%} and @code{\~} escape
+sequences (but @code{\%} and @code{\~} can't be mapped onto another
+glyph).
 
 @item
 @cindex backspace character, and translations
@@ -8205,9 +9399,8 @@
 
 @item
 @cindex @code{\&}, and translations
-The pair @samp{@var{c}\&} (this is an arbitrary character@tie{}@var{c}
-followed by the zero width space character) maps this character to
-nothing.
+The pair @samp{@var{c}\&} (an arbitrary character@tie{}@var{c} followed
+by the dummy character) maps this character to ``nothing''.
 
 @Example
 .tr a\&
@@ -8216,7 +9409,7 @@
 @endExample
 
 @noindent
-It is even possible to map the space character to nothing:
+Even the space character can be mapped to the dummy character.
 
 @Example
 .tr aa \&
@@ -8231,7 +9424,7 @@
 like @w{@samp{.tr aa x}} undo @w{@samp{.tr aa \&}} instead.
 
 If justification is active, lines are justified in spite of the `empty'
-space character (but there is no minimal distance, i.e.@: the space
+space character (but there is no minimal distance, i.e., the space
 character, between words).
 
 @item
@@ -8242,42 +9435,12 @@
 
 @item
 Translating character to glyphs where one of them or both are undefined
-is possible also; @code{tr} does not check whether the entities in its
-argument do exist.
+is possible also; @code{tr} does not check whether the elements of its
+argument exist.
 
 @xref{Gtroff Internals}.
 
 @item
-@code{troff} no longer has a hard-coded dependency on @w{Latin-1}; all
-@code{char@var{XXX}} entities have been removed from the font
-description files.  This has a notable consequence that shows up in
-warnings like @code{can't find character with input code @var{XXX}} if
-the @code{tr} request isn't handled properly.
-
-Consider the following translation:
-
-@Example
-.tr éÉ
-@endExample
-
-@noindent
-This maps input character @code{é} onto glyph @code{É}, which is
-identical to glyph @code{char201}.  But this glyph intentionally doesn't
-exist!  Instead, @code{\char201} is treated as an input character
-entity and is by default mapped onto @code{\'E}, and @code{gtroff}
-doesn't handle translations of translations.
-
-The right way to write the above translation is
-
-@Example
-.tr é\'E
-@endExample
-
-@noindent
-In other words, the first argument of @code{tr} should be an input
-character or entity, and the second one a glyph entity.
-
-@item
 Without an argument, the @code{tr} request is ignored.
 @end itemize
 @endDefreq
@@ -8286,7 +9449,7 @@
 @cindex @code{\!}, and @code{trnt}
 @code{trnt} is the same as the @code{tr} request except that the
 translations do not apply to text that is transparently throughput into
-a diversion with @code{\!}.  @xref{Diversions}, for more information.
+a diversion with @code{\!}.  @xref{Diversions}.
 
 For example,
 
@@ -8306,51 +9469,54 @@
 
 @c =====================================================================
 
-@node Troff and Nroff Mode, Line Layout, Character Translations, gtroff Reference
-@section Troff and Nroff Mode
-@cindex troff mode
-@cindex mode, troff
-@cindex nroff mode
-@cindex mode, nroff
-
-Originally, @code{nroff} and @code{troff} were two separate programs,
-the former for TTY output, the latter for everything else.  With GNU
-@code{troff}, both programs are merged into one executable, sending its
-output to a device driver (@code{grotty} for TTY devices, @code{grops}
-for @sc{PostScript}, etc.)@: which interprets the intermediate output of
-@code{gtroff}.  For Unix @code{troff} it makes sense to talk about
-@dfn{Nroff mode} and @dfn{Troff mode} since the differences are
-hardcoded.  For GNU @code{troff}, this distinction is not appropriate
-because @code{gtroff} simply takes the information given in the font
-files for a particular device without handling requests specially if a
-TTY output device is used.
+@node @code{troff} and @code{nroff} Modes, Line Layout, Character Translations, GNU troff Reference
+@section @code{troff} and @code{nroff} Modes
+@cindex @code{troff} mode
+@cindex mode, @code{troff}
+@cindex @code{nroff} mode
+@cindex mode, @code{nroff}
+
+Historically, @code{nroff} and @code{troff} were two separate programs;
+the former for terminal output, the latter for typesetters.  GNU
+@code{troff} merges both functions into one executable@footnote{A
+GNU @command{nroff} program is available for convenience; it calls GNU
+@code{troff} to perform the formatting.} that sends its output to a
+device driver (@code{grotty} for terminal devices, @code{grops} for
+PostScript, and so on) which interprets this intermediate output format.
+When discussing @acronym{AT&T} @code{troff}, it makes sense to talk
+about @dfn{@code{nroff} mode} and @dfn{@code{troff} mode} since the
+differences are hard-coded.  GNU @code{troff} takes information from
+device and font description files without handling requests specially if
+a terminal output device is used, so such a strong distinction is
+unnecessary.
 
 Usually, a macro package can be used with all output devices.
 Nevertheless, it is sometimes necessary to make a distinction between
-TTY and non-TTY devices: @code{gtroff} provides two built-in conditions
-@samp{n} and @samp{t} for the @code{if}, @code{ie}, and @code{while}
-requests to decide whether @code{gtroff} shall behave like @code{nroff}
-or like @code{troff}.
+terminal and non-terminal devices: GNU @code{troff} provides two
+built-in conditions @samp{n} and @samp{t} for the @code{if}, @code{ie},
+and @code{while} requests to decide whether GNU @code{troff} shall
+behave like @code{nroff} or like @code{troff}.
 
 @Defreq {troff, }
 @pindex troffrc
 @pindex troffrc-end
 Make the @samp{t} built-in condition true (and the @samp{n} built-in
 condition false) for @code{if}, @code{ie}, and @code{while} conditional
-requests.  This is the default if @code{gtroff} (@emph{not}
+requests.  This is the default if GNU @code{troff} (@emph{not}
 @code{groff}) is started with the @option{-R} switch to avoid loading of
-the start-up files @file{troffrc} and @file{troffrc-end}.  Without
-@option{-R}, @code{gtroff} stays in troff mode if the output device is
-not a TTY (e.g.@: `ps').
+the startup files @file{troffrc} and @file{troffrc-end}.  Without
+@option{-R}, GNU @code{troff} stays in @code{troff} mode if the output
+device is not a terminal (e.g., `ps').
 @endDefreq
 
 @Defreq {nroff, }
 @pindex tty.tmac
 Make the @samp{n} built-in condition true (and the @samp{t} built-in
 condition false) for @code{if}, @code{ie}, and @code{while} conditional
-requests.  This is the default if @code{gtroff} uses a TTY output
-device; the code for switching to nroff mode is in the file
-@file{tty.tmac}, which is loaded by the start-up file @code{troffrc}.
+requests.  This is the default if GNU @code{troff} uses a terminal
+output device; the code for switching to @code{nroff} mode is in the
+file @file{tty.tmac}, which is loaded by the startup file
+@code{troffrc}.
 @endDefreq
 
 @xref{Conditionals and Loops}, for more details on built-in conditions.
@@ -8358,7 +9524,7 @@
 
 @c =====================================================================
 
-@node Line Layout, Line Control, Troff and Nroff Mode, gtroff Reference
+@node Line Layout, Line Continuation, @code{troff} and @code{nroff} Modes, GNU troff Reference
 @section Line Layout
 @cindex line layout
 @cindex layout, line
@@ -8388,69 +9554,72 @@
 @cindex margin, left (@code{po})
 @cindex page offset (@code{po})
 @cindex offset, page (@code{po})
-@dfn{Page offset} -- this is the leftmost position of text on the final
+@dfn{Page offset}---this is the leftmost position of text on the final
 output, defining the @dfn{left margin}.
 
 @item in
 @cindex indentation (@code{in})
 @cindex line indentation (@code{in})
-@dfn{Indentation} -- this is the distance from the left margin where
+@dfn{Indentation}---this is the distance from the left margin where
 text is printed.
 
 @item ll
 @cindex line length (@code{ll})
 @cindex length of line (@code{ll})
-@dfn{Line length} -- this is the distance from the left margin to right
+@dfn{Line length}---this is the distance from the left margin to right
 margin.
 @end ftable
 
+@cindex margin, right
+@cindex right margin
+The right margin is not explicitly configured; the combination of page
+offset and line length provides the information necessary to derive it.
+
 A simple demonstration:
 
 @Example
 .ll 3i
 This is text without indentation.
-The line length has been set to 3\~inch.
+The line length has been set to 3\~inches.
 .in +.5i
 .ll -.5i
 Now the left and right margins are both increased.
 .in
 .ll
-Calling .in and .ll without parameters restore
+Calling .in and .ll without parameters restores
 the previous values.
 @endExample
 
-Result:
-
 @Example
-This  is text without indenta-
-tion.   The  line  length  has
-been set to 3 inch.
-     Now   the  left  and
-     right  margins   are
-     both increased.
-Calling  .in  and  .ll without
-parameters restore the  previ-
-ous values.
+    @result{} This  is text without indenta-
+    @result{} tion.   The  line  length  has
+    @result{} been set to 3 inches.
+    @result{}      Now   the  left  and
+    @result{}      right  margins   are
+    @result{}      both increased.
+    @result{} Calling  .in  and  .ll without
+    @result{} parameters restores the previ-
+    @result{} ous values.
 @endExample
 
 @DefreqList {po, @Var{offset}}
 @DefreqItem {po, @t{+}@Var{offset}}
 @DefreqItem {po, @t{-}@Var{offset}}
 @DefregListEndx {.o}
-@pindex troffrc
-Set horizontal page offset to @var{offset} (or increment or decrement
-the current value by @var{offset}).  Note that this request does not
-cause a break, so changing the page offset in the middle of text being
-filled may not yield the expected result.  The initial value is
-1@dmn{i}.  For TTY output devices, it is set to 0 in the startup file
-@file{troffrc}; the default scaling indicator is @samp{m} (and not
-@samp{v} as incorrectly documented in the original Unix troff manual).
-
-The current page offset can be found in the read-only number register
-@samp{.o}.
-
-If @code{po} is called without an argument, the page offset is reset to
-the previous value before the last call to @code{po}.
+@pindex tty.tmac
+Set page offset to @var{offset} (or increment or decrement its current
+value by @var{offset}).  If invoked without an argument, the page offset
+is restored to the value before the previous @code{po} request.
+This request does not cause a break; the page offset in effect when an
+output line is broken prevails (@pxref{Manipulating Filling and
+Adjustment}).  The initial value is 1@dmn{i} and the default scaling
+unit is @samp{m}.  On terminal devices, the page offset is set to zero
+by a driver-specific macro file, @file{tty.tmac}.  The current page
+offset can be found in the read-only register @samp{.o}.
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{po} request
+This request is incorrectly documented in the @acronym{AT&T}
+@code{troff} manual as using a default scaling unit of @samp{v}.
 
 @Example
 .po 3i
@@ -8475,13 +9644,10 @@
 
 If @code{in} is called without an argument, the indentation is reset to
 the previous value before the last call to @code{in}.  The default
-scaling indicator is @samp{m}.
-
-The indentation is associated with the current environment
-(@pxref{Environments}).
+scaling unit is @samp{m}.
 
 If a negative indentation value is specified (which is not allowed),
-@code{gtroff} emits a warning of type @samp{range} and sets the
+@code{gtroff} emits a warning in category @samp{range} and sets the
 indentation to zero.
 
 The effect of @code{in} is delayed until a partially collected line (if
@@ -8489,7 +9655,8 @@
 also.
 
 The current indentation (as set by @code{in}) can be found in the
-read-only number register @samp{.i}.
+read-only register @samp{.i}.  The indentation is associated with the
+environment (@pxref{Environments}).
 @endDefreq
 
 @DefreqList {ti, offset}
@@ -8500,12 +9667,12 @@
 increment or decrement value is specified, adjust the temporary
 indentation relative to the value set by the @code{in} request.
 
-This request causes a break; its value is associated with the current
-environment (@pxref{Environments}).  The default scaling indicator is
+This request causes a break; its value is associated with the
+environment (@pxref{Environments}).  The default scaling unit is
 @samp{m}.  A call of @code{ti} without an argument is ignored.
 
 If the total indentation value is negative (which is not allowed),
-@code{gtroff} emits a warning of type @samp{range} and sets the
+@code{gtroff} emits a warning in category @samp{range} and sets the
 temporary indentation to zero.  `Total indentation' is either
 @var{offset} if specified as an absolute value, or the temporary plus
 normal indentation, if @var{offset} is given as a relative value.
@@ -8513,8 +9680,8 @@
 The effect of @code{ti} is delayed until a partially collected line (if
 it exists) is output.
 
-The read-only number register @code{.in} is the indentation that applies
-to the current output line.
+The read-only register @code{.in} is the indentation that applies to the
+current output line.
 
 The difference between @code{.i} and @code{.in} is that the latter takes
 into account whether a partially collected line still uses the old
@@ -8529,21 +9696,19 @@
 Set the line length to @var{length} (or increment or decrement the
 current value by @var{length}).  Initially, the line length is set to
 6.5@dmn{i}.  The effect of @code{ll} is delayed until a partially
-collected line (if it exists) is output.  The default scaling indicator
-is @samp{m}.
+collected line (if it exists) is output.  The default scaling unit is
+@samp{m}.
 
 If @code{ll} is called without an argument, the line length is reset to
 the previous value before the last call to @code{ll}.  If a negative
 line length is specified (which is not allowed), @code{gtroff} emits a
-warning of type @samp{range} and sets the line length to zero.
-
-The line length is associated with the current environment
-(@pxref{Environments}).
+warning in category @samp{range} and sets the line length to zero.  The
+line length is associated with the environment (@pxref{Environments}).
 
 @cindex line length register (@code{.l})
 The current line length (as set by @code{ll}) can be found in the
-read-only number register @samp{.l}.  The read-only number register
-@code{.ll} is the line length that applies to the current output line.
+read-only register @samp{.l}.  The read-only register @code{.ll} is the
+line length that applies to the current output line.
 
 Similar to @code{.i} and @code{.in}, the difference between @code{.l}
 and @code{.ll} is that the latter takes into account whether a partially
@@ -8553,92 +9718,90 @@
 
 @c =====================================================================
 
-@node Line Control, Page Layout, Line Layout, gtroff Reference
-@section Line Control
+@node Line Continuation, Page Layout, Line Layout, GNU troff Reference
+@section Line Continuation
 @cindex line control
 @cindex control, line
 
-It is important to understand how @code{gtroff} handles input and output
-lines.
-
-Many escapes use positioning relative to the input line.  For example,
-this
-
-@Example
-This is a \h'|1.2i'test.
-
-This is a
-\h'|1.2i'test.
-@endExample
-
-@noindent
-produces
-
-@Example
-This is a   test.
-
-This is a             test.
+When filling is enabled, input and output line breaks generally do not
+correspond.  The @code{roff} language therefore distinguishes input and
+output line continuation.
+
+@Defesc {\\@key{RET}, , ,}
+@cindex input line continuation (@code{\@key{RET}})
+@cindex line, input, continuation (@code{\@key{RET}})
+@cindex continuation, input line (@code{\@key{RET}})
+@c We use the following notation in our man pages; Texinfo is bound to
+@c the GNU Emacs dialect.
+@esindex \@slanted{newline}
+@code{\@key{RET}} (a backslash immediately followed by a newline)
+suppresses the effects of that newline in the input.  The next input
+line thus retains the classification of its predecessor as a control or
+text line.  @code{\@key{RET}} is useful for managing line lengths in the
+input during document maintenance; you can break an input line in the
+middle of a request invocation, macro call, or escape sequence.  Input
+line continuation is invisible to the formatter, with two exceptions:
+the @code{|} operator recognizes the new input line
+(@pxref{Numeric Expressions}), and the input line counter register
+@code{.c} is incremented.
+
+@c Wrap example at 56 columns (on the _output_).  We use 50n in the
+@c groff input to avoid line adjustment.
+@Example
+.ll 50n
+.de I
+.  ft I
+.  nop \\$*
+.  ft
+..
+Our film class watched
+.I The Effect of Gamma Rays on Man-in-the-Moon
+Marigolds. \" whoops, the input line wrapped
+.br
+.I My own opus begins on line \n.c \
+and ends on line \n.c.
 @endExample
-
-The main usage of this feature is to define macros that act exactly at
-the place where called.
-
 @Example
-.\" A simple macro to underline a word
-.de underline
-.  nop \\$1\l'|0\ul'
-..
+    @result{} Our film class watched @i{The Effect of Gamma Rays on}
+    @result{} @i{Man-in-the-Moon} Marigolds.
+    @result{} @i{My own opus begins on line 11 and ends on line 12.}
 @endExample
+@endDefesc
 
-@noindent
-In the above example, @samp{|0} specifies a negative distance from the
-current position (at the end of the just emitted argument @code{\$1})
-back to the beginning of the input line.  Thus, the @samp{\l} escape
-draws a line from right to left.
-
-@cindex input line continuation (@code{\})
-@cindex line, input, continuation (@code{\})
-@cindex continuation, input line (@code{\})
+@DefescList {\\c, , ,}
+@DefregListEndx {.int}
 @cindex output line, continuation (@code{\c})
 @cindex line, output, continuation (@code{\c})
 @cindex continuation, output line (@code{\c})
 @cindex interrupted line
 @cindex line, interrupted
-@code{gtroff} makes a difference between input and output line
-continuation; the latter is also called @dfn{interrupting} a line.
+@cindex @code{\R}, after @code{\c}
+@code{\c} continues an output line.  Nothing after it on the input line
+is formatted.  In contrast to @code{\@key{RET}}, a line after @code{\c}
+remains a new input line, so a control character is recognized at its
+beginning.  The visual results depend on whether filling is enabled; see
+@ref{Manipulating Filling and Adjustment}.
 
-@DefescList {\\@key{RET}, , ,}
-@DefescItemx {\\c, , ,}
-@DefregListEndx {.int}
-Continue a line.  @code{\@key{RET}} (this is a backslash at the end of a
-line immediately followed by a newline) works on the input level,
-suppressing the effects of the following newline in the input.
+@itemize @bullet
+@item
+@cindex @code{\c}, when filling enabled
+@cindex fill mode, and @code{\c}
+@cindex mode, fill, and @code{\c}
+If filling is enabled, a word interrupted with @code{\c} is continued
+with the text on the next input text line, without an intervening space.
 
 @Example
-This is a \
-.test
-    @result{} This is a .test
+This is a te\c
+st.
+    @result{} This is a test.
 @endExample
 
-The @samp{|} operator is also affected.
-
-@cindex @code{\R}, after @code{\c}
-@code{\c} works on the output level.  Anything after this escape on the
-same line is ignored except @code{\R}, which works as usual.  Anything
-before @code{\c} on the same line is appended to the current partial
-output line.  The next non-command line after an interrupted line counts
-as a new input line.
-
-The visual results depend on whether no-fill mode is active.
-
-@itemize @bullet
 @item
-@cindex @code{\c}, and no-fill mode
+@cindex @code{\c}, when filling disabled
 @cindex no-fill mode, and @code{\c}
 @cindex mode, no-fill, and @code{\c}
-If no-fill mode is active (using the @code{nf} request), the next input
-text line after @code{\c} is handled as a continuation of the same input
-text line.
+If filling is disabled, the next input text line after @code{\c} is
+handled as a continuation of the same input text line.
 
 @Example
 .nf
@@ -8646,318 +9809,390 @@
 test.
     @result{} This is a test.
 @endExample
-
-@item
-@cindex @code{\c}, and fill mode
-@cindex fill mode, and @code{\c}
-@cindex mode, fill, and @code{\c}
-If fill mode is active (using the @code{fi} request), a word interrupted
-with @code{\c} is continued with the text on the next input text line,
-without an intervening space.
-
-@Example
-This is a te\c
-st.
-    @result{} This is a test.
-@endExample
 @end itemize
 
-Note that an intervening control line that causes a break is stronger
-than @code{\c}, flushing out the current partial line in the usual way.
+An intervening control line that causes a break overrides @code{\c},
+flushing out the pending output line in the usual way.
 
 @cindex interrupted line register (@code{.int})
+@cindex continued output line register (@code{.int})
 The @code{.int} register contains a positive value if the last output
-line was interrupted with @code{\c}; this is associated with the current
-environment (@pxref{Environments}).
+line was continued with @code{\c}; this datum is associated with the
+environment (@pxref{Environments}).@footnote{Historically, the @code{\c}
+escape sequence has proven challenging to characterize.  Some sources
+say it ``connects the next input text'' (to the input line on which it
+appears); others describe it as ``interrupting'' text, on the grounds
+that a text line is interrupted without breaking, perhaps to inject a
+request invocation or macro call.}
 @endDefesc
 
 
 @c =====================================================================
 
-@node Page Layout, Page Control, Line Control, gtroff Reference
+@node Page Layout, Page Control, Line Continuation, GNU troff Reference
 @section Page Layout
 @cindex page layout
 @cindex layout, page
 
-@code{gtroff} provides some very primitive operations for controlling
-page layout.
+The formatter permits configuration of the page length and page number.
 
 @DefreqList {pl, @Var{length}}
 @DefreqItem {pl, @t{+}@Var{length}}
 @DefreqItem {pl, @t{-}@Var{length}}
 @DefregListEndx {.p}
-@cindex page length (@code{pl})
-@cindex length of page (@code{pl})
-Set the @dfn{page length} to @var{length} (or increment or decrement the
-current value by @var{length}).  This is the length of the physical
-output page.  The default scaling indicator is @samp{v}.
+@cindex page length, configuring (@code{pl})
+@cindex length of the page, configuring (@code{pl})
+@cindex configuring the page length (@code{pl})
+@cindex setting the page length (@code{pl})
+Change (increase or decrease) the page length per the numeric expression
+@var{length}.  The default scaling unit is @samp{v}.  A negative
+@var{length} is valid, but an uncommon application:@: it prevents page
+location traps from being sprung,@footnote{@xref{Traps}.} and each
+output line is placed on a new page.  If @var{length} is invalid, GNU
+@code{troff} emits a warning in category @samp{number}.  If @var{length}
+is absent or invalid, @samp{11i} is assumed.
 
 @cindex page length register (@code{.p})
-The current setting can be found in the read-only number register
-@samp{.p}.
-
-@cindex top margin
-@cindex margin, top
-@cindex bottom margin
-@cindex margin, bottom
-Note that this only specifies the size of the page, not the top and
-bottom margins.  Those are not set by @code{gtroff} directly.
-@xref{Traps}, for further information on how to do this.
-
-Negative @code{pl} values are possible also, but not very useful: No
-trap is sprung, and each line is output on a single page (thus
-suppressing all vertical spacing).
+The read-only register @samp{.p} interpolates the current page length.
+@endDefreq
 
-If no argument or an invalid argument is given, @code{pl} sets the page
-length to 11@dmn{i}.
+@DefreqList {pn, num}
+@DefreqItem {pn, @t{+}@Var{num}}
+@DefreqItem {pn, @t{-}@Var{num}}
+@DefregListEndx {.pn}
+@cindex page number, configuring next (@code{pn})
+@cindex next page number, configuring (@code{pn})
+@cindex number, page, next, configuring (@code{pn})
+Change (increase or decrease) the page number of the @emph{next} page
+per the numeric expression @var{num}.  If @var{num} is invalid, GNU
+@code{troff} emits a warning in category @samp{number} and ignores the
+request.  Without an argument, @code{pn} is ignored.
+
+@cindex next page number register (@code{.pn})
+@cindex page number, next, register (@code{.pn})
+The read-only register @code{.pn} interpolates @var{num} if set by
+@code{pn} on the current page, or the current page number plus@tie{}1.
 @endDefreq
 
 @cindex headers
 @cindex footers
 @cindex titles
-@code{gtroff} provides several operations that help in setting up top
-and bottom titles (or headers and footers).
-
-@Defreq {tl, @t{'}@Var{left}@t{'}@Var{center}@t{'}@Var{right}@t{'}}
-@cindex title line (@code{tl})
+The formatter offers special support for typesetting headers and
+footers, collectively termed @dfn{titles}.  Titles have an independent
+line length, and their placement on the page is not restricted.
+
+@Defreq {tl, @code{'}@Var{left}@code{'}@Var{center}@code{'}@Var{right}@code{'}}
+@cindex title line, formatting (@code{tl})
+@cindex formatting a title line (@code{tl})
 @cindex three-part title (@code{tl})
 @cindex page number character (@code{%})
-Print a @dfn{title line}.  It consists of three parts: a left justified
-portion, a centered portion, and a right justified portion.  The
-argument separator @samp{'} can be replaced with any character not
-occurring in the title line.  The @samp{%} character is replaced with
-the current page number.  This character can be changed with the
-@code{pc} request (see below).
-
-Without argument, @code{tl} is ignored.
-
-Some notes:
-
-@itemize @bullet
-@item
-The line length set by the @code{ll} request is not honoured by
-@code{tl}; use the @code{lt} request (described below) instead, to
-control line length for text set by @code{tl}.
-
-@item
-A title line is not restricted to the top or bottom of a page.
-
-@item
-@code{tl} prints the title line immediately, ignoring a partially filled
-line (which stays untouched).
-
-@item
-It is not an error to omit closing delimiters.  For example,
-@w{@samp{.tl /foo}} is equivalent to @w{@samp{.tl /foo///}}: It prints a
-title line with the left justified word @samp{foo}; the centered and
-right justified parts are empty.
-
-@item
-@code{tl} accepts the same parameter delimiting characters as the
-@code{\A} escape; see @ref{Escapes}.
-@end itemize
+Format an output line as a title consisting of @var{left}, @var{center},
+and @var{right}, each aligned accordingly.  The delimiter need not be a
+neutral apostrophe: @code{tl} accepts the same delimiters as most escape
+sequences; see @ref{Delimiters}.  If not used as the delimiter, any
+@dfn{page number character} character is replaced with the current page
+number; the default is @samp{%}; see the the @code{pc} request below.
+Without an argument, @code{tl} is ignored.  @code{tl} writes the title
+line immediately, ignoring any partially collected line.
+
+It is not an error to omit delimiters after the first.  For example,
+@w{@samp{.tl /Thesis}} is interpreted as @w{@samp{.tl /Thesis///}}:@: it
+sets a title line comprising only the left-aligned word @samp{Thesis}.
 @endDefreq
 
 @DefreqList {lt, @Var{length}}
 @DefreqItem {lt, @t{+}@Var{length}}
 @DefreqItem {lt, @t{-}@Var{length}}
 @DefregListEndx {.lt}
-@cindex length of title line (@code{lt})
-@cindex title line, length (@code{lt})
-@cindex title line length register (@code{.lt})
-The title line is printed using its own line length, which is specified
-(or incremented or decremented) with the @code{lt} request.  Initially,
-the title line length is set to 6.5@dmn{i}.  If a negative line length
-is specified (which is not allowed), @code{gtroff} emits a warning of
-type @samp{range} and sets the title line length to zero.  The default
-scaling indicator is @samp{m}.  If @code{lt} is called without an
-argument, the title length is reset to the previous value before the
-last call to @code{lt}.
-
-The current setting of this is available in the @code{.lt} read-only
-number register; it is associated with the current environment
+@cindex length of title line, configuring (@code{lt})
+@cindex title length, configuring (@code{lt})
+Change (increase or decrease) the line length used by titles per the
+numeric expression @var{length}.  The default scaling unit is @samp{m}.
+If @var{length} is negative, GNU emits a warning in category
+@samp{range} and treats @var{length} as @samp{0}.  If @var{length} is
+invalid, GNU @code{troff} emits a warning in category @samp{number} and
+ignores the request.  The formatter's default title length is
+@samp{6.5i}.  With no argument, the title length is restored to the
+previous value.  The title length is is associated with the environment
 (@pxref{Environments}).
-@endDefreq
 
-@DefreqList {pn, page}
-@DefreqItem {pn, @t{+}@Var{page}}
-@DefreqItem {pn, @t{-}@Var{page}}
-@DefregListEndx {.pn}
-@cindex page number (@code{pn})
-@cindex number, page (@code{pn})
-Change (increase or decrease) the page number of the @emph{next} page.
-The only argument is the page number; the request is ignored without a
-parameter.
-
-The read-only number register @code{.pn} contains the number of the next
-page: either the value set by a @code{pn} request, or the number of the
-current page plus@tie{}1.
+@cindex title line length register (@code{.lt})
+The read-only register @samp{.lt} interpolates the title line length.
 @endDefreq
 
 @Defreq {pc, @Var{char}}
 @cindex changing the page number character (@code{pc})
 @cindex page number character, changing (@code{pc})
 @vindex %
-Change the page number character (used by the @code{tl} request) to a
-different character.  With no argument, this mechanism is disabled.
-Note that this doesn't affect the number register@tie{}@code{%}.
+Set the page number character to @var{char}.  With no argument, the page
+number character is disabled.  @code{pc} does not affect the
+register@tie{}@code{%}.
 @endDefreq
 
-@xref{Traps}.
+The following example exercises title features.
 
+@Example
+.lt 50n
+This is my partially collected
+.tl 'Isomers 2023'%'Dextrose Edition'
+line.
+    @result{} Isomers 2023             1        Dextrose Edition
+    @result{} This is my partially collected line.
+@endExample
+
+We most often see titles used in page header and footer traps.
+@xref{Traps}.
 
 @c =====================================================================
 
-@node Page Control, Fonts and Symbols, Page Layout, gtroff Reference
+@node Page Control, Using Fonts, Page Layout, GNU troff Reference
 @section Page Control
 @cindex page control
 @cindex control, page
 
-@DefreqList {bp, @Var{page}}
-@DefreqItem {bp, @t{+}@Var{page}}
-@DefreqItem {bp, @t{-}@Var{page}}
+@cindex page break
+@cindex break, page
+@cindex page ejection
+@cindex ejection, page
+Discretionary page breaks can prevent the unwanted separation of
+content.  A new page number takes effect during page ejection; see
+@ref{The Implicit Page Trap}.
+
+@DefreqList {bp, @Var{page-number}}
+@DefreqItem {bp, @t{+}@Var{page-number}}
+@DefreqItem {bp, @t{-}@Var{page-number}}
 @DefregListEndx {%}
 @cindex new page (@code{bp})
 @cindex page, new (@code{bp})
-Stop processing the current page and move to the next page.  This
-request causes a break.  It can also take an argument to set (increase,
-decrease) the page number of the next page (which actually becomes the
-current page after @code{bp} has finished).  The difference between
-@code{bp} and @code{pn} is that @code{pn} does not cause a break or
-actually eject a page.  @xref{Page Layout}.
-
-@Example
-.de newpage                         \" define macro
-'bp                                 \" begin page
-'sp .5i                             \" vertical space
-.tl 'left top'center top'right top' \" title
-'sp .3i                             \" vertical space
-..                                  \" end macro
-@endExample
-
+Break the page and change (increase or decrease) the next page number
+per the numeric expression @var{page-number}.  If @var{page-number} is
+invalid, GNU @code{troff} emits a warning in category @samp{number} and
+ignores the argument.  This request causes a break.  A page break
+advances the vertical drawing position to the bottom of the page,
+springing traps.  @xref{Page Location Traps}.
 @cindex @code{bp} request, and top-level diversion
 @cindex top-level diversion, and @code{bp}
 @cindex diversion, top-level, and @code{bp}
-@code{bp} has no effect if not called within the top-level diversion
-(@pxref{Diversions}).
+@code{bp} has effect only if invoked within the top-level
+diversion.@footnote{@xref{Diversions}.}
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{bp} request
+This request is incorrectly documented in the @acronym{AT&T}
+@code{troff} manual as having a default scaling unit of @samp{v}.
 
 @cindex page number register (@code{%})
 @cindex current page number (@code{%})
-The read-write register@tie{}@code{%} holds the current page number.
+The register @code{%} interpolates the current page number.
 
-The number register @code{.pe} is set to@tie{}1 while @code{bp} is
-active.  @xref{Page Location Traps}.
+@Example
+.de BP
+'  bp \" schedule page break once current line is output
+..
+@endExample
 @endDefreq
 
 @Defreq {ne, @Var{space}}
 @cindex orphan lines, preventing with @code{ne}
 @cindex conditional page break (@code{ne})
 @cindex page break, conditional (@code{ne})
-It is often necessary to force a certain amount of space before a new
-page occurs.  This is most useful to make sure that there is not a
-single @dfn{orphan} line left at the bottom of a page.  The @code{ne}
-request ensures that there is a certain distance, specified by the first
-argument, before the next page is triggered (see @ref{Traps}, for
-further information).  The default scaling indicator for @code{ne} is
-@samp{v}; the default value of @var{space} is@tie{}1@dmn{v} if no
-argument is given.
-
-For example, to make sure that no fewer than 2@tie{}lines get orphaned,
-do the following before each paragraph:
-
-@Example
-.ne 2
-text text text
-@endExample
-
-@code{ne} then automatically causes a page break if there is space for
-one line only.
+Force a page break if insufficient vertical space is available (assert
+``needed'' space).  @code{ne} tests the distance to the next page
+location trap; see @ref{Page Location Traps}, and breaks the page if
+that amount is less than @var{space}.  The default scaling unit is
+@samp{v}.  If @var{space} is invalid, GNU @code{troff} emits a warning
+in category @samp{number} and ignores the argument.  If @var{space} is
+not specified, @samp{1v} is assumed.
+
+@cindex widow
+We can require space for at least the first two output lines of a
+paragraph, preventing its first line from being @slanted{widowed} at the
+page bottom.
+
+@Example
+.ne 2v
+Considering how common illness is,
+how tremendous the spiritual change that it brings,
+how astonishing,
+when the lights of health go down,
+the undiscovered countries that are then disclosed,
+what wastes and deserts of the soul a slight attack
+of influenza brings to view,
+@c -- Virgina Woolf, "On Being Ill", 1926
+@endExample
+
+@c XXX: Some of this might be better placed in a revised Chapter 3.
+This method is reliable only if no output line is pending when @code{ne}
+is invoked.  When macro packages are used, this is often not the case:@:
+their paragraphing macros perform the break.  You may need to experiment
+with placing the @code{ne} after the paragraphing macro, or @code{br}
+and @code{ne} before it.
+
+@cindex orphan
+@cindex widow
+@code{ne} is also useful to force grouping of section headings with
+their subsequent paragraphs, or tables with their captions and/or
+explanations.  Macro packages often use @code{ne} with diversions to
+implement keeps and displays; see @ref{Diversions}.  They may also offer
+parameters for widow and orphan management.
 @endDefreq
 
 @DefreqList {sv, @Var{space}}
 @DefreqListEndx {os, }
 @cindex @code{ne} request, comparison with @code{sv}
-@code{sv} is similar to the @code{ne} request; it reserves the specified
-amount of vertical space.  If the desired amount of space exists before
-the next trap (or the bottom page boundary if no trap is set), the space
-is output immediately (ignoring a partially filled line, which stays
-untouched).  If there is not enough space, it is stored for later output
-via the @code{os} request.  The default value is@tie{}1@dmn{v} if no
-argument is given; the default scaling indicator is @samp{v}.
-
+Require vertical space as @code{ne} does, but also @slanted{save} it for
+later output by the @code{os} request.  If @var{space} is available
+before the next page location trap, it is output immediately.  Both
+requests ignore a partially collected line, taking effect at the next
+break.
 @cindex @code{sv} request, and no-space mode
 @cindex @code{os} request, and no-space mode
-Both @code{sv} and @code{os} ignore no-space mode.  While the @code{sv}
-request allows negative values for @var{space}, @code{os} ignores them.
+@code{sv} and @code{os} ignore no-space mode (recall @ref{Manipulating
+Spacing}).  While the @code{sv} request allows negative values for
+@var{space}, @code{os} ignores them.  The default scaling unit is
+@samp{v}.  If @var{space} is not specified, @samp{1v} is assumed.
 @endDefreq
 
 @Defreg {nl}
-@cindex current vertical position (@code{nl})
-@cindex vertical position, current (@code{nl})
-@cindex position, vertical, current (@code{nl})
-This register contains the current vertical position.  If the vertical
-position is zero and the top of page transition hasn't happened yet,
-@code{nl} is set to negative value.  @code{gtroff} itself does this at
-the very beginning of a document before anything has been printed, but
-the main usage is to plant a header trap on a page if this page has
-already started.
-
-Consider the following:
+@cindex vertical drawing position (@code{nl})
+@cindex vertical position, drawing (@code{nl})
+@cindex drawing position, vertical (@code{nl})
+@c TODO: We should talk somewhere prior to this point about how the
+@c formatter doesn't start a page until it has to.
+@code{nl} interpolates or sets the vertical drawing position.  When the
+formatter starts, the first page transition hasn't happened yet, and
+@code{nl} is negative.  If a header trap has been planted on the page
+(typically at vertical position @code{0}), you can assign a negative
+value to @code{nl} to spring it if that page has already started
+(@pxref{Page Location Traps}).
 
 @Example
-.de xxx
+.de HD
 .  sp
-.  tl ''Header''
+.  tl ''Goldbach Solution''
 .  sp
 ..
 .
 First page.
 .bp
-.wh 0 xxx
+.wh 0 HD \" plant header trap at top of page
 .nr nl (-1)
 Second page.
+    @result{} First page.
+    @result{}
+    @result{} @r{@i{(blank lines elided)}}
+    @result{}
+    @result{}                         Goldbach Solution
+    @result{}
+    @result{} @r{@i{(blank lines elided)}}
+    @result{}
+    @result{} Second page.
 @endExample
 
 @noindent
-Result:
-
-@Example
-First page.
-
-...
-
-                             Header
-
-Second page.
-
-...
-@endExample
-
-@noindent
-Without resetting @code{nl} to a negative value, the just planted trap
+Without resetting @code{nl} to a negative value, the trap just planted
 would be active beginning with the @emph{next} page, not the current
 one.
 
-@xref{Diversions}, for a comparison with the @code{.h} and @code{.d}
-registers.
+@xref{Diversions}, for a comparison of @code{nl} with the @code{.h} and
+@code{.d} registers.
 @endDefreg
 
 
 @c =====================================================================
 
-@node Fonts and Symbols, Sizes, Page Control, gtroff Reference
-@section Fonts and Symbols
-@cindex fonts
-
-@code{gtroff} can switch fonts at any point in the text.
-
-The basic set of fonts is @samp{R}, @samp{I}, @samp{B}, and @samp{BI}.
-These are Times Roman, Italic, Bold, and Bold Italic.  For non-TTY
-devices, there is also at least one symbol font that contains various
-special symbols (Greek, mathematics).
+@c BEGIN Keep (roughly) parallel with section "Using fonts" of groff(7).
+@node Using Fonts, Manipulating Type Size and Vertical Spacing, Page Control, GNU troff Reference
+@section Using Fonts
+@cindex font
+
+@cindex typeface
+@cindex font family
+@cindex font style
+@cindex style, font
+@cindex family, font
+@cindex text font
+@cindex special font
+@cindex unstyled font
+@cindex font, text
+@cindex font, special
+@cindex font, unstyled
+In digital typography, a @dfn{font} is a collection of characters in a
+specific typeface that a device can render as glyphs at a desired
+size.@footnote{Terminals and some output devices have fonts that render
+at only one or two sizes.  As examples of the latter, take the
+@code{groff} @code{lj4} device's Lineprinter, and @code{lbp}'s Courier
+and Elite faces.}  A @code{roff} formatter can change typefaces at any
+point in the text.  The basic faces are a set of @dfn{styles} combining
+upright and slanted shapes with normal and heavy stroke weights:
+@samp{R}, @samp{I}, @samp{B}, and @samp{BI}---these stand for
+@slanted{roman}, @slanted{italic}, @slanted{bold}, and
+@slanted{bold-italic}.  For linguistic text, GNU @code{troff} groups
+typefaces into @dfn{families} containing each of these
+styles.@footnote{Font designers prepare families such that the styles
+share esthetic properties.}  A @dfn{text font} is thus often a family
+combined with a style, but it need not be:@: consider the @code{ps} and
+@code{pdf} devices' @code{ZCMI} (Zapf Chancery Medium italic)---often,
+no other style of Zapf Chancery Medium is provided.  On typesetting
+devices, at least one @dfn{special font} is available, comprising
+@dfn{unstyled} glyphs for mathematical operators and other purposes.
+
+@cindex font description file
+@cindex description file, font
+@cindex file, font description
+@cindex font metrics
+@cindex metrics, font
+@cindex mounting position
+@cindex mounting position
+@cindex position, mounting
+Like @acronym{AT&T} @code{troff}, GNU @code{troff} does not itself load
+or manipulate a digital font file;@footnote{Historically, the fonts
+@code{troff}s dealt with were not Free Software or, as with the Graphic
+Systems C/A/T, did not even exist in the digital domain.} instead it
+works with a @dfn{font description file} that characterizes it,
+including its glyph repertoire and the @dfn{metrics} (dimensions) of
+each glyph.@footnote{@xref{Font Description File Format}.}  This
+information permits the formatter to accurately place glyphs with
+respect to each other.  Before using a font description, the formatter
+associates it with a @dfn{mounting position}, a place in an ordered list
+of available typefaces.
+@cindex abstract font style
+@cindex font style, abstract
+@cindex style, font, abstract
+So that a document need not be strongly coupled to a specific font
+family, in GNU @code{troff} an output device can associate a style in
+the abstract sense with a mounting position.  Thus the default family
+can be combined with a style dynamically, producing a @dfn{resolved font
+name}.
+
+Fonts often have trademarked names, and even Free Software fonts can
+require renaming upon modification.  @code{groff} maintains a
+convention that a device's serif font family is given the name @samp{T}
+(``Times''), its sans-serif family @samp{H} (``Helvetica''), and its
+monospaced family @samp{C} (``Courier'').  Historical inertia has driven
+@code{groff}'s font identifiers to short uppercase abbreviations of font
+names, as with @samp{TR}, @samp{TI}, @samp{TB}, @samp{TBI}, and a
+special font @samp{S}.
+
+The default family used with abstract styles can be changed at any time;
+initially, it is @samp{T}.  Typically, abstract styles are arranged in
+the first four mounting positions in the order shown above.  The default
+mounting position, and therefore style, is always @samp{1} (@samp{R}).
+By issuing appropriate formatter instructions, you can override these
+defaults before your document writes its first glyph.
+
+@cindex graphic renditions
+@cindex renditions, graphic
+@cindex character cell attributes
+@cindex attributes, character cell
+@cindex cell, character, attributes
+Terminal output devices cannot change font families and lack special
+fonts.  They support style changes by overstriking, or by altering
+ISO@tie{}6429/ECMA-48 @dfn{graphic renditions} (character cell
+attributes).
+@c END Keep (roughly) parallel with section "Using fonts" of groff(7).
 
 @menu
-* Changing Fonts::
+* Selecting Fonts::
 * Font Families::
 * Font Positions::
 * Using Symbols::
@@ -8965,19 +10200,25 @@
 * Special Fonts::
 * Artificial Fonts::
 * Ligatures and Kerning::
+* Italic Corrections::
+* Dummy Characters::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Changing Fonts, Font Families, Fonts and Symbols, Fonts and Symbols
-@subsection Changing Fonts
-@cindex fonts
+@node Selecting Fonts, Font Families, Using Fonts, Using Fonts
+@subsection Selecting Fonts
+@cindex font, selection
+
+We use @dfn{font} to refer to any of several means of identifying a
+font: by mounting position (@samp{3}), by abstract style (@samp{B}), or
+by its identifier (@samp{TB}).
 
 @DefreqList {ft, @Var{font}}
 @DefescItemx {\\f, , f, }
-@DefescItem {\\f, @Lparen{}, fn, }
-@DefescItem {\\f, @Lbrack{}, font, @Rbrack{}}
-@DefregListEndx {.sty}
+@DefescItem {\\f, (, fn, }
+@DefescItem {\\f, , font, }
+@DefregListEndx {.fn}
 @cindex changing fonts (@code{ft}, @code{\f})
 @cindex fonts, changing (@code{ft}, @code{\f})
 @cindex @code{sty} request, and changing fonts
@@ -8986,55 +10227,70 @@
 @kindex styles
 @kindex family
 @pindex DESC
-The @code{ft} request and the @code{\f} escape change the current font
-to @var{font} (one-character name@tie{}@var{f}, two-character name
-@var{fn}).
-
-If @var{font} is a style name (as set with the @code{sty} request or
-with the @code{styles} command in the @file{DESC} file), use it within
-the current font family (as set with the @code{fam} request, the
-@code{\F} escape, or the @code{family} command in the @file{DESC} file).
-
-It is not possible to switch to a font with the name @samp{DESC}
-(whereas this name could be used as a style name; however, this is not
-recommended).
-
-@cindex previous font (@code{ft}, @code{\f}, @code{\fP})
-@cindex font, previous (@code{ft}, @code{\f}, @code{\fP})
-With no argument or using @samp{P} as an argument, @code{.ft} switches
-to the previous font.  Use @code{\f} to do this with the escape.  The
-old syntax forms @code{\fP} or @code{\fP} are also supported.
-
-Fonts are generally specified as upper-case strings, which are usually
-1@tie{}to 4 characters representing an abbreviation or acronym of the
-font name.  This is no limitation, just a convention.
+@cindex selecting the previous font (@code{ft})
+@cindex previous font, selecting (@code{ft})
+@cindex font, previous, slecting (@code{ft})
+The @code{ft} request selects the typeface @var{font}.  If the argument
+is absent or @samp{P}, it selects the previously chosen font.  If
+@var{font} is a non-negative integer, it is interpreted as mounting
+position; the font mounted there is selected.  If that position refers
+to an abstract style, it is combined with the default family (see
+@code{fam} and @code{\F} below) to make a resolved font name.  If the
+mounting position is not a style and no font is mounted there, GNU
+@code{troff} emits a warning in category @samp{font} and ignores the
+request.
+
+If @var{font} matches a style name, it is combined with the current
+family to make a resolved font name.  Otherwise, @var{font} is assumed
+to already be a resolved font name.
+
+@cindex automatic font mounting
+@cindex font mounting, automatic
+@cindex mounting, font, automatic
+The resolved font name is subject to translation (see request @code{ftr}
+below).  Next, the (possibly translated) font name's mounting position
+is looked up; if not mounted, @var{font} is sought on the file system as
+a font description file and, if located, automatically mounted at the
+next available position (see register @code{.fp} below).  If the font
+was mounted using an identifier different from its font description file
+name (see request @code{fp} below), that file name is then looked up.
+If a font description file for the resolved font name is not found, GNU
+@code{troff} emits a warning in category @samp{font} and ignores the
+request.
 
-The example below produces two identical lines.
+The @code{\f} escape sequence is similar, using one-character name (or
+mounting position) @var{f}, two-character name @var{fn}, or a name
+@var{font} of arbitrary length.
+@cindex previous font, selecting (@code{\f}, @code{\fP})
+@cindex font, previous, selecting (@code{\f}, @code{\fP})
+@samp{\f} selects the previous font.  The syntax form @samp{\fP} is
+supported for backward compatibility, and @samp{\fP} for consistency.
 
 @Example
 eggs, bacon,
-.ft B
-spam
+.ft I
+spam,
 .ft
 and sausage.
-
-eggs, bacon, \fBspam\fP and sausage.
+.br
+eggs, bacon, \fIspam,\fP and sausage.
+    @result{} eggs, bacon, @slanted{spam,} and sausage
+    @result{} eggs, bacon, @slanted{spam,} and sausage
 @endExample
 
-Note that @code{\f} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
-a single character as an argument) to change the font on the fly:
+The current and previously selected fonts are properties of the
+environment (@pxref{Environments}).
+
+The read-only string-valued register @code{.fn} contains the resolved
+font name of the selected font.
+
+@code{\f} doesn't produce an input token in GNU @code{troff}; it thus
+can be used in requests that expect a single-character argument.  We can
+assign a font to a margin character as follows (@pxref{Miscellaneous}).
 
 @Example
 .mc \fIx\f
 @endExample
-
-The current style name is available in the read-only number register
-@samp{.sty} (this is a string-valued register); if the current font
-isn't a style, the empty string is returned.  It is associated with the
-current environment.
-
-@xref{Font Positions}, for an alternative syntax.
 @endDefreq
 
 @Defreq {ftr, f @Var{g}}
@@ -9059,14 +10315,16 @@
 @code{fspecial}, @code{fp}, or @code{sty} requests, font@tie{}@var{g} is
 used.  If @var{g} is missing or equal to@tie{}@var{f} the translation is
 undone.
+@c XXX: Do font translations work on mounting positions?  Abstract
+@c styles?
 
-Note that it is not possible to chain font translations.  Example:
+Font translations cannot be chained.
 
 @Example
 .ftr XXX TR
 .ftr XXX YYY
 .ft XXX
-    @result{} warning: can't find font `XXX'
+    @error{} warning: can't find font 'XXX'
 @endExample
 @endDefreq
 
@@ -9094,286 +10352,248 @@
 @endExample
 
 A missing or zero value of @var{zoom} is the same as a value of 1000,
-which means no magnification.  @var{f}@tie{}must be a real font name,
-not a style.
-
-Note that the magnification of a font is completely transparent to
-troff; a change of the zoom factor doesn't cause any effect except that
-the dimensions of glyphs, (word) spaces, kerns, etc., of the affected
-font are adjusted accordingly.
+which means no magnification.  @var{f}@tie{}must be a resolved font
+name, not an abstract style.
+@c XXX: What about a mounting position?  It's not rejected...
+
+The magnification of a font is completely transparent to GNU
+@code{troff}; a change of the zoom factor doesn't cause any effect
+except that the dimensions of glyphs, (word) spaces, kerns, etc., of the
+affected font are adjusted accordingly.
 
-The zoom factor of the current font is available in the read-only number
+The zoom factor of the current font is available in the read-only
 register @samp{.zoom}, in multiples of 1/1000th.  It returns zero if
 there is no magnification.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Font Families, Font Positions, Changing Fonts, Fonts and Symbols
+@node Font Families, Font Positions, Selecting Fonts, Using Fonts
 @subsection Font Families
 @cindex font families
 @cindex families, font
 @cindex font styles
 @cindex styles, font
 
-Due to the variety of fonts available, @code{gtroff} has added the
-concept of @dfn{font families} and @dfn{font styles}.  The fonts are
-specified as the concatenation of the font family and style.  Specifying
-a font without the family part causes @code{gtroff} to use that style of
-the current family.
-
-@cindex PostScript fonts
-@cindex fonts, PostScript
-Currently, fonts for the devices @option{-Tps}, @option{-Tpdf},
-@option{-Tdvi}, @option{-Tlj4}, @option{-Tlbp}, and the X11 fonts are
-set up to this mechanism.  By default, @code{gtroff} uses the Times
-family with the four styles @samp{R}, @samp{I}, @samp{B}, and @samp{BI}.
-
-This way, it is possible to use the basic four fonts and to select a
-different font family on the command line (@pxref{Groff Options}).
+To accommodate the wide variety of fonts available, GNU @code{troff}
+distinguishes @dfn{font families} and @dfn{font styles}.  A resolved
+font name is the catenation of a font family and a style.  Selecting an
+abstract style causes GNU @code{troff} to combine it with the default
+font family.
+
+You can thus compose a document using abstract styles exclusively for
+its body or running text, selecting a specific family only for titles or
+examples, for instance, and change the default family on the command
+line (recall @ref{Groff Options}).
+
+Fonts for the devices @code{ps}, @code{pdf}, @code{dvi}, @code{lj4},
+@code{lbp}, and the X11 devices support this mechanism.  By default,
+GNU @code{troff} uses the Times family with the four styles @samp{R},
+@samp{I}, @samp{B}, and @samp{BI}.
 
 @DefreqList {fam, @Var{family}}
 @DefregItemx {.fam}
 @DefescItemx {\\F, , f, }
-@DefescItem {\\F, @Lparen{}, fm, }
-@DefescItem {\\F, @Lbrack{}, family, @Rbrack{}}
-@DefregListEndx {.fn}
+@DefescItem {\\F, (, fm, }
+@DefescListEnd {\\F, , family, }
 @cindex changing font family (@code{fam}, @code{\F})
 @cindex font family, changing (@code{fam}, @code{\F})
-Switch font family to @var{family} (one-character name@tie{}@var{f},
-two-character name @var{fm}).  If no argument is given, switch back to
-the previous font family.  Use @code{\F} to do this with the escape.
-Note that @code{\FP} doesn't work; it selects font family @samp{P}
-instead.
-
-The value at start-up is @samp{T}.  The current font family is available
-in the read-only number register @samp{.fam} (this is a string-valued
-register); it is associated with the current environment.
-
-@Example
+Set the default font family, used in combination with abstract styles to
+construct a resolved font name, to @var{family} (one-character
+name@tie{}@var{f}, two-character name @var{fm}).  If no argument is
+given, GNU @code{troff} selects the previous font family; if there none,
+is it falls back to the device's default@footnote{@xref{DESC File
+Format}.} or its own (@samp{T}).
+
+The @code{\F} escape sequence works similarly.  In disanalogy to
+@code{\f}, @samp{\FP} makes @samp{P} the default family.  Use
+@samp{\F} to select the previous default family.  The default font
+family is available in the read-only string-valued register @code{.fam};
+it is associated with the environment (@pxref{Environments}).
+
+@Example
+spam,     \" startup defaults are T (Times) R (roman)
+.fam H    \" make Helvetica the default family
+spam,     \" family H + style R = HR
+.ft B     \" family H + style B = HB
 spam,
-.fam H    \" helvetica family
-spam,     \" used font is family H + style R = HR
-.ft B     \" family H + style B = font HB
+.ft CR    \" Courier roman (default family not changed)
 spam,
-.fam T    \" times family
-spam,     \" used font is family T + style B = TB
+.ft       \" back to Helvetica bold
+spam,
+.fam T    \" make Times the default family
+spam,     \" family T + style B = TB
 .ft AR    \" font AR (not a style)
 baked beans,
-.ft R     \" family T + style R = font TR
+.ft R     \" family T + style R = TR
 and spam.
 @endExample
 
-Note that @code{\F} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
-a single character as an argument) to change the font family on the fly:
+@code{\F} doesn't produce an input token in GNU @code{troff}.  As a
+consequence, it can be used in requests like @code{mc} (which expects
+a single character as an argument) to change the font family on the fly.
 
 @Example
 .mc \FPx\F
 @endExample
-
-The @samp{.fn} register contains the current @dfn{real font name} of the
-current font.  This is a string-valued register.  If the current font is
-a style, the value of @code{\n.fn} is the proper concatenation of
-family and style name.
 @endDefreq
 
-@Defreq {sty, n style}
-@cindex changing font style (@code{sty})
-@cindex font style, changing (@code{sty})
+@need 1000
+@DefreqList {sty, n style}
+@DefregListEndx {.sty}
+@cindex setting up an abstract font style (@code{sty})
+@cindex abstract font style, setting up (@code{sty})
+@cindex font style, abstract, setting up (@code{sty})
+@cindex style, font, abstract, setting up (@code{sty})
 @cindex @code{cs} request, and font styles
 @cindex @code{bd} request, and font styles
 @cindex @code{tkf} request, and font styles
 @cindex @code{uf} request, and font styles
 @cindex @code{fspecial} request, and font styles
-Associate @var{style} with font position@tie{}@var{n}.  A font position
-can be associated either with a font or with a style.  The current font
-is the index of a font position and so is also either a font or a style.
-If it is a style, the font that is actually used is the font which name
-is the concatenation of the name of the current family and the name of
-the current style.  For example, if the current font is@tie{}1 and font
-position@tie{}1 is associated with style @samp{R} and the current font
-family is @samp{T}, then font @samp{TR} is used.  If the current font is
-not a style, then the current family is ignored.  If the requests
-@code{cs}, @code{bd}, @code{tkf}, @code{uf}, or @code{fspecial} are
-applied to a style, they are instead applied to the member of the
-current family corresponding to that style.
-
-@var{n}@tie{}must be a non-negative integer value.
+Associate an abstract style @var{style} with mounting
+position@tie{}@var{n}, which must be a non-negative integer.  If the
+requests @code{cs}, @code{bd}, @code{tkf}, @code{uf}, or @code{fspecial}
+are applied to an abstract style, they are instead applied to the member
+of the current family corresponding to that style.
 
 @pindex DESC
 @kindex styles
 The default family can be set with the @option{-f} option (@pxref{Groff
 Options}).  The @code{styles} command in the @file{DESC} file controls
-which font positions (if any) are initially associated with styles
-rather than fonts.  For example, the default setting for @sc{PostScript}
-fonts
+which font positions (if any) are initially associated with abstract
+styles rather than fonts.
 
-@Example
-styles R I B BI
-@endExample
-
-@noindent
-is equivalent to
-
-@Example
-.sty 1 R
-.sty 2 I
-.sty 3 B
-.sty 4 BI
-@endExample
-
-@code{fam} and @code{\F} always check whether the current font position
-is valid; this can give surprising results if the current font position
-is associated with a style.
-
-In the following example, we want to access the @sc{PostScript} font
-@code{FooBar} from the font family @code{Foo}:
+@strong{Caution:@:} The @var{style} argument is not validated.
+@c XXX: This would be a really good thing to fix.
+Errors may occur later, when the formatter attempts to construct a
+resolved font name, or format a character for output.
 
 @Example
+.nr BarPos \n.fp
 .sty \n.fp Bar
 .fam Foo
-    @result{} warning: can't find font `FooR'
-@endExample
-
-@noindent
-The default font position at start-up is@tie{}1; for the @sc{PostScript}
-device, this is associated with style @samp{R}, so @code{gtroff} tries
-to open @code{FooR}.
-
-A solution to this problem is to use a dummy font like the following:
-
-@Example
-.fp 0 dummy TR    \" set up dummy font at position 0
-.sty \n.fp Bar  \" register style `Bar'
-.ft 0             \" switch to font at position 0
-.fam Foo          \" activate family `Foo'
-.ft Bar           \" switch to font `FooBar'
+.ft \nBarPos
+.tm .f=\n.f
+A
+    @error{} error: no font family named 'Foo' exists
+    @error{} .f=41
+    @error{} error: cannot format glyph: no current font
 @endExample
 
-@xref{Font Positions}.
+When an abstract style has been selected, the read-only string-valued
+register @samp{.sty} interpolates its name; this datum is associated
+with the environment (@pxref{Environments}).  Otherwise, @samp{.sty}
+interpolates nothing.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Font Positions, Using Symbols, Font Families, Fonts and Symbols
+@node Font Positions, Using Symbols, Font Families, Using Fonts
 @subsection Font Positions
 @cindex font positions
 @cindex positions, font
 
-For the sake of old phototypesetters and compatibility with old versions
-of @code{troff}, @code{gtroff} has the concept of font @dfn{positions},
-on which various fonts are mounted.
+To support typeface indirection through abstract styles, and for
+compatibility with @acronym{AT&T} @code{troff}, the formatter maintains
+a list of font @dfn{positions} at which fonts required by a document are
+@dfn{mounted}.  An output device's description file @file{DESC}
+typically configures a set of pre-mounted fonts; see @ref{Device and
+Font Description Files}.  A font need not be explicitly mounted before
+it is selected; GNU @code{troff} will search @env{GROFF_FONT_PATH} for
+it by name and mount it at the first free mounting position on demand.
 
-@DefreqList {fp, pos font @Var{external-name}}
+@need 500
+@DefreqList {fp, pos id @Var{font-description-file-name}}
 @DefregItemx {.f}
 @DefregListEndx {.fp}
-@cindex mounting font (@code{fp})
+@cindex mounting a font (@code{fp})
 @cindex font, mounting (@code{fp})
-Mount font @var{font} at position @var{pos} (which must be a
-non-negative integer).  This numeric position can then be referred to
-with font changing commands.  When @code{gtroff} starts it is using font
-position@tie{}1 (which must exist; position@tie{}0 is unused usually at
-start-up).
+Mount a font under the name @var{id} at mounting position @var{pos}, a
+non-negative integer.  When the formatter starts up, it reads the output
+device's description to mount an initial set of faces, and selects font
+position@tie{}1.  Position@tie{}0 is unused by default.  Unless the
+@var{font-description-file-name} argument is given, @var{id} should be
+the name of a font description file stored in a directory corresponding
+to the selected output device.  GNU @code{troff} does not traverse
+directories to locate the font description file.
+
+@c The third argument was a late revision to device-independent troff.
+@c It wasn't in the "Unix 4.0" version of CSTR #54 (January 1981), which
+@c featured Kernighan's device-independent rewrite, but appeared by the
+@c time of its 1992 revision.
+@cindex font aliasing with third argument to @code{fp} request
+@cindex aliasing fonts with third argument to @code{fp} request
+The optional third argument enables font names to be aliased, which can
+be necessary in compatibility mode since AT&T @code{troff} syntax
+affords no means of identifying fonts with names longer than two
+characters, like @samp{TBI} or @samp{ZCMI}, in a font selection escape
+sequence.  @xref{Compatibility Mode}.  You can also alias fonts on
+mounting for convenience or abstraction.  (See below regarding the
+@code{.fp} register.)
+
+@Example
+.fp \n.fp SC ZCMI
+Send a \f(SChand-written\fP thank-you note.
+.fp \n.fp Emph TI
+.fp \n.fp Strong TB
+Are \fEmphthese names\f \fStrongcomfortable\f?
+@endExample
+
+@samp{DESC}, @samp{P}, and non-negative integers are not usable as font
+identifiers.
+@c XXX: TODO: Catch the DESC case earlier and throw an error for it.
+@c XXX: This identifier could be used as a style name, but no one's
+@c exercised this freedom in 30+ years, and we should consider
+@c prohibiting it.  --GBR
 
 @cindex font position register (@code{.f})
-The current font in use, as a font position, is available in the
-read-only number register @samp{.f}.  This can be useful to remember the
-current font for later recall.  It is associated with the current
-environment (@pxref{Environments}).
+The position of the currently selected font (or abstract style) is
+available in the read-only register @samp{.f}.  It is associated with
+the environment (@pxref{Environments}).
+
+You can copy the value of @code{.f} to another register to save it for
+later use.
 
 @Example
-.nr save-font \n.f
-.ft B
-... text text text ...
-.ft \nsave-font
+.nr saved-font \n.f
+@r{@dots{} @i{text involving many font changes} @dots{}}
+.ft \nsaved-font
 @endExample
 
 @cindex next free font position register (@code{.fp})
-The number of the next free font position is available in the read-only
-number register @samp{.fp}.  This is useful when mounting a new font,
-like so:
-
-@Example
-.fp \n.fp NEATOFONT
-@endExample
-
-@pindex DESC@r{, and font mounting}
-Fonts not listed in the @file{DESC} file are automatically mounted on
-the next available font position when they are referenced.  If a font is
-to be mounted explicitly with the @code{fp} request on an unused font
-position, it should be mounted on the first unused font position, which
-can be found in the @code{.fp} register.  Although @code{gtroff} does
-not enforce this strictly, it is not allowed to mount a font at a
-position whose number is much greater (approx.@: 1000 positions) than
-that of any currently used position.
-
-The @code{fp} request has an optional third argument.  This argument
-gives the external name of the font, which is used for finding the font
-description file.  The second argument gives the internal name of the
-font, which is used to refer to the font in @code{gtroff} after it has
-been mounted.  If there is no third argument then the internal name is
-used as the external name.  This feature makes it possible to use fonts
-with long names in compatibility mode.
-@endDefreq
-
-Both the @code{ft} request and the @code{\f} escape have alternative
-syntax forms to access font positions.
-
-@DefreqList {ft, nnn}
-@DefescItemx {\\f, , n, }
-@DefescItem {\\f, @Lparen{}, nn, }
-@DefescListEnd {\\f, @Lbrack{}, nnn, @Rbrack{}}
-@cindex changing font position (@code{\f})
-@cindex font position, changing (@code{\f})
-@cindex @code{sty} request, and font positions
-@cindex @code{fam} request, and font positions
-@cindex @code{\F}, and font positions
-@kindex styles
-@kindex family
-@pindex DESC
-Change the current font position to @var{nnn} (one-digit
-position@tie{}@var{n}, two-digit position @var{nn}), which must be a
-non-negative integer.
-
-If @var{nnn} is associated with a style (as set with the @code{sty}
-request or with the @code{styles} command in the @file{DESC} file), use
-it within the current font family (as set with the @code{fam} request,
-the @code{\F} escape, or the @code{family} command in the
-@file{DESC} file).
-
-@Example
-this is font 1
-.ft 2
-this is font 2
-.ft                   \" switch back to font 1
-.ft 3
-this is font 3
-.ft
-this is font 1 again
-@endExample
-
-@xref{Changing Fonts}, for the standard syntax form.
+The index of the next (non-zero) free font position is available in the
+read-only register @samp{.fp}.
+@cindex @file{DESC} file, and font mounting
+Fonts not listed in the @file{DESC} file are automatically mounted at
+position @samp{\n.fp} when selected with the @code{ft} request or
+@code{\f} escape sequence.  When mounting a font at a position
+explicitly with the @code{fp} request, this same practice should be
+followed, although GNU @code{troff} does not enforce this strictly.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Using Symbols, Character Classes, Font Positions, Fonts and Symbols
+@node Using Symbols, Character Classes, Font Positions, Using Fonts
 @subsection Using Symbols
 @cindex using symbols
 @cindex symbols, using
 
 @cindex glyph
 @cindex character
+@cindex glyph, distinguished from character
+@cindex character, distinguished from glyph
 @cindex ligature
 A @dfn{glyph} is a graphical representation of a @dfn{character}.  While
-a character is an abstract entity containing semantic information, a
-glyph is something that can be actually seen on screen or paper.  It is
-possible that a character has multiple glyph representation forms (for
-example, the character `A' can be either written in a roman or an italic
-font, yielding two different glyphs); sometimes more than one character
-maps to a single glyph (this is a @dfn{ligature} -- the most common is
-`fi').
+a character is an abstraction of semantic information, a glyph is
+something that can be seen on screen or paper.  A character has many
+possible representation forms (for example, the character `A' can be
+written in an upright or slanted typeface, producing distinct
+glyphs).  Sometimes, a sequence of characters map to a single glyph:@:
+this is a @dfn{ligature}---the most common is `fi'.
+
+Space characters never become glyphs in GNU @code{troff}.  If not
+discarded (as when trailing on text lines), they are represented by
+horizontal motions in the output.
 
 @cindex symbol
 @cindex special fonts
@@ -9384,13 +10604,13 @@
 A @dfn{symbol} is simply a named glyph.  Within @code{gtroff}, all glyph
 names of a particular font are defined in its font file.  If the user
 requests a glyph not available in this font, @code{gtroff} looks up an
-ordered list of @dfn{special fonts}.  By default, the @sc{PostScript}
-output device supports the two special fonts @samp{SS} (slanted symbols)
-and @samp{S} (symbols) (the former is looked up before the latter).
-Other output devices use different names for special fonts.  Fonts
-mounted with the @code{fonts} keyword in the @file{DESC} file are
-globally available.  To install additional special fonts locally (i.e.@:
-for a particular font), use the @code{fspecial} request.
+ordered list of @dfn{special fonts}.  By default, the PostScript output
+device supports the two special fonts @samp{SS} (slanted symbols) and
+@samp{S} (symbols) (the former is looked up before the latter).  Other
+output devices use different names for special fonts.  Fonts mounted
+with the @code{fonts} keyword in the @file{DESC} file are globally
+available.  To install additional special fonts locally (i.e., for a
+particular font), use the @code{fspecial} request.
 
 Here are the exact rules how @code{gtroff} searches a given symbol:
 
@@ -9423,8 +10643,8 @@
 
 @item
 As a last resort, consult all fonts loaded up to now for special fonts
-and check them, starting with the lowest font number.  Note that this
-can sometimes lead to surprising results since the @code{fonts} line in
+and check them, starting with the lowest font number.  This can
+sometimes lead to surprising results since the @code{fonts} line in
 the @file{DESC} file often contains empty positions, which are filled
 later on.  For example, consider the following:
 
@@ -9458,24 +10678,28 @@
 @code{FOO} even for @code{XXX}, which is not the intended behaviour.
 @end itemize
 
-@xref{Font Files}, and @ref{Special Fonts}, for more details.
+@xref{Device and Font Description Files}, and @ref{Special Fonts}, for
+more details.
 
-@cindex list of available glyphs (@cite{groff_char(7)} man page)
-@cindex available glyphs, list (@cite{groff_char(7)} man page)
-@cindex glyphs, available, list (@cite{groff_char(7)} man page)
-The list of available symbols is device dependent; see the
-@cite{groff_char(7)} man page for a complete list of all glyphs.  For
-example, say
+@cindex list of special characters (@cite{groff_char@r{(7)}} man page)
+@cindex special characters, list of (@cite{groff_char@r{(7)}} man page)
+@cindex characters, special, list of (@cite{groff_char@r{(7)}} man page)
+@cindex available glyphs, list of (@cite{groff_char@r{(7)}} man page)
+@cindex glyphs, available, list of (@cite{groff_char@r{(7)}} man page)
+The @cite{groff_char@r{(7)}} man page houses a complete list of
+predefined special character names, but the availability of any as a
+glyph is device- and font-dependent.  For example, say
 
 @Example
 man -Tdvi groff_char > groff_char.dvi
 @endExample
 
 @noindent
-for a list using the default DVI fonts (not all versions of the
-@code{man} program support the @option{-T} option).  If you want to use
-an additional macro package to change the used fonts, @code{groff} must
-be called directly:
+to obtain those available with the DVI device and default font
+configuration.@footnote{Not all versions of the @code{man} program
+support the @option{-T} option; use the subsequent example for an
+alternative.}  If you want to use an additional macro package to change
+the fonts used, @code{groff} (or @code{gtroff}) must be run directly.
 
 @Example
 groff -Tdvi -mec -man groff_char.7 > groff_char.dvi
@@ -9483,15 +10707,15 @@
 
 @cindex composite glyph names
 @cindex glyph names, composite
-@cindex groff glyph list (GGL)
-@cindex GGL (groff glyph list)
-@cindex adobe glyph list (AGL)
-@cindex AGL (adobe glyph list)
-Glyph names not listed in groff_char(7) are derived algorithmically,
-using a simplified version of the Adobe Glyph List (AGL) algorithm, which
-is described in @uref{https://github.com@//adobe-type-tools@//agl-aglfn}.
-The (frozen) set of glyph names that can't be derived algorithmically
-is called @dfn{groff glyph list (GGL)}.
+@cindex @code{groff} glyph list (GGL)
+@cindex GGL (@code{groff} glyph list)
+@cindex Adobe Glyph List (AGL)
+Special character names not listed in @cite{groff_char@r{(7)}} are
+derived algorithmically, using a simplified version of the Adobe Glyph
+List (AGL) algorithm, which is described in
+@uref{https://github.com@//adobe-type-tools@//agl-aglfn}.  The (frozen)
+set of names that can't be derived algorithmically is called the
+@dfn{@code{groff} glyph list (GGL)}.
 
 @itemize @bullet
 @item
@@ -9504,7 +10728,7 @@
 @samp{u}).  No zero padding is allowed for character codes greater than
 0xFFFF.  Surrogates (i.e., Unicode values greater than 0xFFFF
 represented with character codes from the surrogate area U+D800-U+DFFF)
-are not allowed too.
+are not allowed either.
 
 @item
 A glyph representing more than a single input character is named
@@ -9517,50 +10741,55 @@
 Example: @code{u0045_0302_0301}.
 
 For simplicity, all Unicode characters that are composites must be
-decomposed maximally (this is normalization form@tie{}D in the Unicode
-standard); for example, @code{u00CA_0301} is not a valid glyph name
-since U+00CA (@sc{latin capital letter e with circumflex}) can be
-further decomposed into U+0045 (@sc{latin capital letter e}) and U+0302
-(@sc{combining circumflex accent}).  @code{u0045_0302_0301} is thus the
-glyph name for U+1EBE, @sc{latin capital letter e with circumflex and
-acute}.
+maximally decomposed to NFD;@footnote{This is ``Normalization Form D''
+as documented in Unicode Standard Annex #15
+(@uref{https://unicode.org@//reports@//tr15/}).} for example,
+@code{u00CA_0301} is not a valid glyph name since U+00CA (@sc{latin
+capital letter e with circumflex}) can be further decomposed into U+0045
+(@sc{latin capital letter e}) and U+0302 (@sc{combining circumflex
+accent}).  @code{u0045_0302_0301} is thus the glyph name for U+1EBE,
+@sc{latin capital letter e with circumflex and acute}.
 
 @item
 groff maintains a table to decompose all algorithmically derived glyph
 names that are composites itself.  For example, @code{u0100} (@sc{latin
 letter a with macron}) is automatically decomposed into
 @code{u0041_0304}.  Additionally, a glyph name of the GGL is preferred
-to an algorithmically derived glyph name; groff also automatically does
-the mapping.  Example: The glyph @code{u0045_0302} is mapped to
-@code{^E}.
+to an algorithmically derived glyph name; @code{groff} also
+automatically does the mapping.  Example: The glyph @code{u0045_0302} is
+mapped to @code{^E}.
 
 @item
 glyph names of the GGL can't be used in composite glyph names; for
 example, @code{^E_u0301} is invalid.
 @end itemize
 
-@DefescList {\\, @Lparen{}, nm, }
-@DefescItem {\\, @Lbrack{}, name, @Rbrack{}}
-@DefescListEnd {\\, @Lbrack{}, component1 component2 @dots{}, @Rbrack{}}
-Insert a symbol @var{name} (two-character name @var{nm}) or a composite
-glyph with component glyphs @var{component1}, @var{component2},
-@enddots{} There is no special syntax for one-character names -- the
-natural form @samp{\@var{n}} would collide with escapes.@footnote{Note
-that a one-character symbol is not the same as an input character, i.e.,
-the character @code{a} is not the same as @code{\a}.  By default,
-@code{groff} defines only a single one-character symbol, @code{\-}; it
-is usually accessed as @code{\-}.  On the other hand, @code{gtroff} has
-the special feature that @code{\char@var{XXX}} is the same as the
-input character with character code @var{XXX}.  For example,
-@code{\char97} is identical to the letter @code{a} if @acronym{ASCII}
-encoding is active.}
+@DefescList {\\, (, nm, }
+@DefescItem {\\, , name, }
+@DefescListEnd {\\, , base-glyph combining-component @dots{}, }
+@esindex \(
+@esindex \
+Typeset a special character @var{name} (two-character name @var{nm}) or
+a composite glyph consisting of @var{base-glyph} overlaid with one or
+more @var{combining-component}s.  For example, @samp{\A ho} is a
+capital letter ``A'' with a ``hook accent'' (ogonek).
+
+There is no special syntax for one-character names---the analogous form
+@samp{\@var{n}} would collide with other escape sequences.  However, the
+four escape sequences @code{\'}, @code{\-}, @code{\_}, and @code{\`},
+are translated on input to the special character escape sequences
+@code{\aa}, @code{\-}, @code{\ul}, and @code{\ga}, respectively.
+
+A special character name of length one is not the same thing as an
+ordinary character: that is, the character @code{a} is not the same as
+@code{\a}.
+
+If @var{name} is undefined, a warning in category @samp{char} is
+produced and the escape is ignored.  @xref{Warnings}, for information
+about the enablement and suppression of warnings.
 
-If @var{name} is undefined, a warning of type @samp{char} is generated,
-and the escape is ignored.  @xref{Debugging}, for information about
-warnings.
-
-groff resolves @code{\...} with more than a single component as
-follows:
+GNU @code{troff} resolves @code{\@r{@dots{}}} with more than a single
+component as follows:
 
 @itemize @bullet
 @item
@@ -9584,10 +10813,10 @@
 @table @code
 @item \A ho
 @samp{A} maps to @code{u0041}, @samp{ho} maps to @code{u02DB}, thus the
-final glyph name would be @code{u0041_02DB}.  Note this is not the
-expected result: The ogonek glyph @samp{ho} is a spacing ogonek, but for
-a proper composite a non-spacing ogonek (U+0328) is necessary.  Looking
-into the file @file{composite.tmac} one can find @w{@samp{.composite ho
+final glyph name would be @code{u0041_02DB}.  This is not the expected
+result:@: the ogonek glyph @samp{ho} is a spacing ogonek, but for a
+proper composite a non-spacing ogonek (U+0328) is necessary.  Looking
+into the file @file{composite.tmac}, one can find @w{@samp{.composite ho
 u0328}}, which changes the mapping of @samp{ho} while a composite glyph
 name is constructed, causing the final glyph name to be
 @code{u0041_0328}.
@@ -9595,46 +10824,46 @@
 @item \^E u0301
 @itemx \^E aa
 @itemx \E a^ aa
-@itemx \E ^ '
+@itemx \E ^ @code{'}
 @samp{^E} maps to @code{u0045_0302}, thus the final glyph name is
 @code{u0045_0302_0301} in all forms (assuming proper calls of the
 @code{composite} request).
 @end table
 
 It is not possible to define glyphs with names like @w{@samp{A ho}}
-within a groff font file.  This is not really a limitation; instead, you
-have to define @code{u0041_0328}.
+within a @code{groff} font file.  This is not really a limitation;
+instead, you have to define @code{u0041_0328}.
 @endDefesc
 
-@Defesc {\\C, ', xxx, '}
+@Defesc {\\C, @code{'}, xxx, @code{'}}
 @cindex named character (@code{\C})
 @cindex character, named (@code{\C})
-Typeset the glyph named @var{xxx}.@footnote{@code{\C} is actually a
-misnomer since it accesses an output glyph.}  Normally it is more
-convenient to use @code{\@var{xxx}}, but @code{\C} has the advantage
-that it is compatible with newer versions of @acronym{AT&T} @code{troff}
-and is available in compatibility mode.
+Typeset the glyph of the special character @var{xxx}.  Normally, it is
+more convenient to use @code{\@var{xxx}}, but @code{\C} has some
+advantages: it is compatible with @acronym{AT&T} device-independent
+@code{troff} (and therefore available in compatibility
+mode@footnote{@xref{Compatibility Mode}.}) and can interpolate special
+characters with @samp{} in their names.  The delimiter need not be
+a neutral apostrophe; see @ref{Delimiters}.
 @endDefesc
 
-@Defreq {composite, from to}
+@Defreq {composite, id1 id2}
 @pindex composite.tmac
-Map glyph name @var{from} to glyph name @var{to} if it is used in
-@code{\...} with more than one component.  See above for examples.
-
-This mapping is based on glyph names only; no check for the existence of
-either glyph is done.
-
-A set of default mappings for many accents can be found in the file
-@file{composite.tmac}, which is loaded at start-up.
+Map special character name @var{id1} to @var{id2} if @var{id1} is used
+in @code{\...} with more than one component.  See above for examples.
+This is a strict rewriting of the special character name; no check is
+performed for the existence of a glyph for either.  A set of default
+mappings for many accents can be found in the file
+@file{composite.tmac}, loaded by the default @file{troffrc} at startup.
 @endDefreq
 
-@Defesc {\\N, ', n, '}
+@Defesc {\\N, @code{'}, n, @code{'}}
 @cindex numbered glyph (@code{\N})
 @cindex glyph, numbered (@code{\N})
 @cindex @code{char} request, used with @code{\N}
 @cindex Unicode
 Typeset the glyph with code@tie{}@var{n} in the current font
-(@code{n}@tie{}is @strong{not} the input character code).  The number
+(@code{n}@tie{}is @emph{not} the input character code).  The number
 @var{n}@tie{}can be any non-negative decimal integer.  Most devices only
 have glyphs with codes between 0 and@tie{}255; the Unicode output device
 uses codes in the range 0--65535.  If the current font does not contain
@@ -9655,29 +10884,29 @@
 include unnamed glyphs in the font description file by using a name of
 @samp{---}; the @code{\N} escape sequence is the only way to use these.
 
-No kerning is applied to glyphs accessed with @code{\N}.
+No kerning is applied to glyphs accessed with @code{\N}.  The delimiter
+need not be a neutral apostrophe; see @ref{Delimiters}.
 @endDefesc
 
-Some escape sequences directly map onto special glyphs.
+A few escape sequences are also special characters.
 
-@Defesc {\\', , , }
-This is a backslash followed by the apostrophe character,
-@acronym{ASCII} character @code{0x27} (@acronym{EBCDIC} character
-@code{0x7D}).  The same as @code{\aa}, the acute accent.
+@Defesc {\@code{'}, , , }
+An escaped neutral apostrophe is a synonym for @code{\aa} (acute
+accent).
 @endDefesc
 
-@Defesc {\\`, , , }
-This is a backslash followed by @acronym{ASCII} character @code{0x60}
-(@acronym{EBCDIC} character @code{0x79} usually).  The same as
-@code{\ga}, the grave accent.
+@Defesc {\@code{`}, , , }
+An escaped grave accent is a synonym for @code{\ga} (grave accent).
 @endDefesc
 
 @Defesc {\\-, , , }
-This is the same as @code{\-}, the minus sign in the current font.
+An escaped hyphen-minus is a synonym for @code{\-} (minus sign).
 @endDefesc
 
 @Defesc {\\_, , , }
-This is the same as @code{\ul}, the underline character.
+An escaped underscore (``low line'') is a synonym for @code{\ul}
+(underrule).  On typesetting devices, the underrule is font-invariant
+and drawn lower than the underscore @samp{_}.
 @endDefesc
 
 @Defreq {cflags, n c1 c2 @dots{}}
@@ -9685,41 +10914,46 @@
 @cindex character properties (@code{cflags})
 @cindex properties of glyphs (@code{cflags})
 @cindex properties of characters (@code{cflags})
-Input characters and symbols have certain properties associated with
-it.@footnote{Note that the output glyphs themselves don't have such
-properties.  For @code{gtroff}, a glyph is a numbered box with a given
-width, depth, and height, nothing else.  All manipulations with the
-@code{cflags} request work on the input level.}  These properties can be
-modified with the @code{cflags} request.  The first argument is the sum
-of the desired flags and the remaining arguments are the characters or
-symbols to have those properties.  It is possible to omit the spaces
-between the characters or symbols.  Instead of single characters or
-symbols you can also use character classes (see @ref{Character Classes}
-for more details).
+Assign properties encoded by the number @var{n} to characters @var{c1},
+@var{c2}, and so on.
+
+Input characters, including special characters introduced by an escape,
+have certain properties associated with them.@footnote{Output glyphs
+don't---to GNU @code{troff}, a glyph is simply a box with an index into
+a font, a given height above and depth below the baseline, and a width.}
+These properties can be modified with this request.  The first argument
+is the sum of the desired flags and the remaining arguments are the
+characters to be assigned those properties.  Spaces between the @var{cn}
+arguments are optional.  Any argument @var{cn} can be a character class
+defined with the @code{class} request rather than an individual
+character.  @xref{Character Classes}.
+
+The non-negative integer @var{n} is the sum of any of the following.
+Some combinations are nonsensical, such as @samp{33} (1 + 32).
 
 @table @code
 @item 1
 @cindex end-of-sentence characters
 @cindex characters, end-of-sentence
-The character ends sentences (initially characters @samp{.?!} have this
-property).
+Recognize the character as ending a sentence if followed by a newline
+or two spaces.  Initially, characters @samp{.?!} have this property.
 
 @item 2
 @cindex hyphenating characters
 @cindex characters, hyphenation
-Lines can be broken before the character (initially no characters have
-this property).  This only works if both the characters before and after
-have non-zero hyphenation codes (as set with the @code{hcode} request).
-Use value@tie{}64 to override this behaviour.
+Enable breaks before the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, no characters have this property.
 
 @item 4
+@cindex @code{\-} glyph, and @code{cflags}
 @cindex @code{hy} glyph, and @code{cflags}
 @cindex @code{em} glyph, and @code{cflags}
-Lines can be broken after the character (initially the character
-@samp{-} and the symbols @samp{\hy} and @samp{\em} have this
-property).  This only works if both the characters before and after have
-non-zero hyphenation codes (as set with the @code{hcode} request).  Use
-value@tie{}64 to override this behaviour.
+Enable breaks after the character.  A line is not broken at a character
+with this property unless the characters on each side both have non-zero
+hyphenation codes.  This exception can be overridden by adding 64.
+Initially, characters @samp{\-\hy\em} have this property.
 
 @item 8
 @cindex overlapping characters
@@ -9729,15 +10963,15 @@
 @cindex @code{ru} glyph, and @code{cflags}
 @cindex @code{radicalex} glyph, and @code{cflags}
 @cindex @code{sqrtex} glyph, and @code{cflags}
-The character overlaps horizontally if used as a horizontal line
-building element.  Initially the symbols @samp{\ul}, @samp{\rn},
-@samp{\ru}, @samp{\radicalex}, and @samp{\sqrtex} have this
-property.
+Mark the glyph associated with this character as overlapping other
+instances of itself horizontally.  Initially, characters
+@samp{\ul\rn\ru\radicalex\sqrtex} have this property.
 
 @item 16
 @cindex @code{br} glyph, and @code{cflags}
-The character overlaps vertically if used as vertical line building
-element.  Initially symbol @samp{\br} has this property.
+Mark the glyph associated with this character as overlapping other
+instances of itself vertically.  Initially, the character @samp{\br}
+has this property.
 
 @item 32
 @cindex transparent characters
@@ -9748,59 +10982,69 @@
 @cindex @code{}, at end of sentence
 @cindex @code{*}, at end of sentence
 @cindex @code{dg} glyph, at end of sentence
+@cindex @code{dd} glyph, at end of sentence
 @cindex @code{rq} glyph, at end of sentence
 @cindex @code{cq} glyph, at end of sentence
-An end-of-sentence character followed by any number of characters with
-this property is treated as the end of a sentence if followed by a
-newline or two spaces; in other words the character is @dfn{transparent}
-for the purposes of end-of-sentence recognition -- this is the same as
-having a zero space factor in @TeX{} (initially characters @samp{"')*}
-and the symbols @samp{\dg}, @samp{\rq}, and @samp{\cq} have this
-property).
+Mark the character as transparent for the purpose of end-of-sentence
+recognition.  In other words, an end-of-sentence character followed by
+any number of characters with this property is treated as the end of a
+sentence if followed by a newline or two spaces.  This is the same as
+having a zero space factor in @TeX{}.  Initially, characters
+@samp{"')*\dg\dd\rq\cq} have this property.
 
 @item 64
-Ignore hyphenation code values of the surrounding characters.  Use this
-in combination with values 2 and@tie{}4 (initially no characters have
-this property).  For example, if you need an automatic break point after
-the en-dash in number ranges like `3000--5000', insert
+Ignore hyphenation codes of the surrounding characters.  Use this in
+combination with values 2 and@tie{}4 (initially, no characters have this
+property).
+
+For example, if you need an automatic break point after the en-dash in
+numeric ranges like ``3000--5000'', insert
 
 @Example
-.cflags 68 \(en
+.cflags 68 \en
 @endExample
 
 @noindent
-into your document.  Note, however, that this can lead to bad layout if
-done without thinking; in most situations, a better solution instead of
+into your document.  However, this practice can lead to bad layout if
+done thoughtlessly; in most situations, a better solution instead of
 changing the @code{cflags} value is to insert @code{\:} right after the
 hyphen at the places that really need a break point.
+@end table
+
+The remaining values were implemented for East Asian language support;
+those who use alphabetic scripts exclusively can disregard them.
 
+@table @code
 @item 128
 Prohibit a line break before the character, but allow a line break after
 the character.  This works only in combination with flags 256 and 512
-(see below) and has no effect otherwise.
+and has no effect otherwise.  Initially, no characters have this
+property.
 
 @item 256
 Prohibit a line break after the character, but allow a line break before
 the character.  This works only in combination with flags 128 and 512
-(see below) and has no effect otherwise.
+and has no effect otherwise.  Initially, no characters have this
+property.
 
 @item 512
 Allow line break before or after the character.  This works only in
 combination with flags 128 and 256 and has no effect otherwise.
+Initially, no characters have this property.
+@end table
 
-Contrary to flag values 2 and@tie{}4, the flags 128, 256, and 512 work
+In contrast to values 2 and@tie{}4, the values 128, 256, and 512 work
 pairwise.  If, for example, the left character has value 512, and the
-right character 128, no line break gets inserted.  If we use
-value@tie{}6 instead for the left character, a line break after the
-character can't be suppressed since the right neighbour character
-doesn't get examined.
-@end table
+right character 128, no break will be automatically inserted between
+them.  If we use value@tie{}6 instead for the left character, a break
+after the character can't be suppressed since the neighboring character
+on the right doesn't get examined.
 @endDefreq
 
-@DefreqList {char, g @Var{string}}
-@DefreqItemx {fchar, g @Var{string}}
-@DefreqItemx {fschar, f g @Var{string}}
-@DefreqListEndx {schar, g @Var{string}}
+@DefreqList {char, c @Var{contents}}
+@DefreqItemx {fchar, c @Var{contents}}
+@DefreqItemx {fschar, f c @Var{contents}}
+@DefreqListEndx {schar, c @Var{contents}}
 @cindex defining character (@code{char})
 @cindex defining fallback character (@code{fchar}, @code{fschar}, @code{schar})
 @cindex character, defining (@code{char})
@@ -9822,31 +11066,31 @@
 @cindex @code{\&}, and glyph definitions
 @cindex @code{\e}, and glyph definitions
 @cindex @code{hcode} request, and glyph definitions
-Define a new glyph@tie{}@var{g} to be @var{string} (which can be
-empty).@footnote{@code{char} is a misnomer since an output glyph is
-defined.}  Every time glyph@tie{}@var{g} needs to be printed,
-@var{string} is processed in a temporary environment and the result is
-wrapped up into a single object.  Compatibility mode is turned off and
-the escape character is set to @samp{\} while @var{string} is being
-processed.  Any emboldening, constant spacing or track kerning is
-applied to this object rather than to individual characters in
-@var{string}.
+Define a new character or glyph@tie{}@var{c} to be @var{contents}, which
+can be empty.  More precisely, @code{char} defines a @code{groff} object
+(or redefines an existing one) that is accessed with the
+name@tie{}@var{c} on input, and produces @var{contents} on output.
+Every time glyph@tie{}@var{c} needs to be printed, @var{contents} is
+processed in a temporary environment and the result is wrapped up into a
+single object.  Compatibility mode is turned off and the escape
+character is set to@tie{}@code{\} while @var{contents} is processed.
+Any emboldening, constant spacing, or track kerning is applied to this
+object rather than to individual glyphs in @var{contents}.
 
-A glyph defined by these requests can be used just like a normal glyph
+An object defined by these requests can be used just like a normal glyph
 provided by the output device.  In particular, other characters can be
 translated to it with the @code{tr} or @code{trin} requests; it can be
-made the leader character by the @code{lc} request; repeated patterns
-can be drawn with the glyph using the @code{\l} and @code{\L} escape
-sequences; words containing the glyph can be hyphenated correctly if the
-@code{hcode} request is used to give the glyph's symbol a hyphenation
-code.
-
-There is a special anti-recursion feature: Use of @code{g} within the
-glyph's definition is handled like normal characters and symbols not
-defined with @code{char}.
+made the leader character with the @code{lc} request; repeated patterns
+can be drawn with it using the @code{\l} and @code{\L} escape sequences;
+and words containing@tie{}@var{c} can be hyphenated correctly if the
+@code{hcode} request is used to give the object a hyphenation code.
+
+There is a special anti-recursion feature: use of the object within its
+own definition is handled like a normal character (not
+defined with @code{char}).
 
-Note that the @code{tr} and @code{trin} requests take precedence if
-@code{char} accesses the same symbol.
+The @code{tr} and @code{trin} requests take precedence if @code{char}
+accesses the same symbol.
 
 @Example
 .tr XY
@@ -9876,30 +11120,26 @@
 of fonts declared as global special fonts with the @code{special}
 request, but before the already mounted special fonts.
 
-@xref{Using Symbols}, for a detailed description of the glyph searching
-mechanism in @code{gtroff}.
+@xref{Character Classes}.
 @endDefreq
 
-@DefreqList {rchar, c1 c2 @dots{}}
-@DefreqListEndx {rfschar, f c1 c2 @dots{}}
+@DefreqList {rchar, c @dots{}}
+@DefreqListEndx {rfschar, f c @dots{}}
 @cindex removing glyph definition (@code{rchar}, @code{rfschar})
 @cindex glyph, removing definition (@code{rchar}, @code{rfschar})
 @cindex fallback glyph, removing definition (@code{rchar}, @code{rfschar})
-Remove the definitions of glyphs @var{c1}, @var{c2},@tie{}@enddots{}
-This undoes the effect of a @code{char}, @code{fchar}, or @code{schar}
-request.
-
-It is possible to omit the whitespace between arguments.
+Remove definition of each ordinary or special character @var{c},
+undoing the effect of a @code{char}, @code{fchar}, or @code{schar}
+request.  Those supplied by font description files cannot be removed.
+Spaces and tabs may separate @var{c}@tie{}arguments.
 
 The request @code{rfschar} removes glyph definitions defined with
-@code{fschar} for glyph@tie{}f.
+@code{fschar} for font@tie{}@var{f}.
 @endDefreq
 
-@xref{Special Characters}.
-
 @c ---------------------------------------------------------------------
 
-@node Character Classes, Special Fonts, Using Symbols, Fonts and Symbols
+@node Character Classes, Special Fonts, Using Symbols, Using Fonts
 @subsection Character Classes
 @cindex character classes
 @cindex classes, character
@@ -9909,73 +11149,78 @@
 much larger than in European languages, and where large sets of
 characters share the same properties.
 
-@Defreq {class, n c1 c2 @dots{}}
+@Defreq {class, name c1 c2 @dots{}}
 @cindex character class (@code{class})
 @cindex defining character class (@code{class})
 @cindex class of characters (@code{class})
-In @code{groff}, a @dfn{character class} (or simply ``class'') is a set
-of characters, grouped by some user aspect.  The @code{class} request
-defines such classes so that other requests can refer to all characters
-belonging to this set with a single class name.  Currently, only the
-@code{cflags} request can handle character classes.
+Define a character class (or simply ``class'') @var{name} comprising
+the characters @var{c1}, @var{c2}, and so on.
+
+A class thus defined can then be referred to in lieu of listing all the
+characters within it.  Currently, only the @code{cflags} request can
+handle references to character classes.
 
-A @code{class} request takes a class name followed by a list of
-entities.  In its simplest form, the entities are characters or symbols:
+In the request's simplest form, each @var{cn} is a character (or special
+character).
 
 @Example
-.class prepunct , : ; > @}
+.class quotes ' \aq \dq \oq \cq \lq \rq
 @endExample
 
-Since class and glyph names share the same namespace, it is recommended
+Since class and glyph names share the same name space, it is recommended
 to start and end the class name with @code{} and @code{},
-respectively, to avoid collisions with normal @code{groff} symbols (and
-symbols defined by the user).  In particular, the presence of @code{}
-in the symbol name intentionally prevents the usage of @code{\...},
-thus you must use the @code{\C} escape to access a class with such a
-name.
-
-@cindex GGL (groff glyph list)
-@cindex groff glyph list (GGL)
-You can also use a special character range notation, consisting of a
-start character or symbol, followed by @samp{-}, and an end character or
-symbol.  Internally, @code{gtroff} converts these two symbol names to
-Unicode values (according to the groff glyph gist), which then give the
-start and end value of the range.  If that fails, the class definition
-is skipped.
-
-Finally, classes can be nested, too.
+respectively, to avoid collisions with existing character names defined
+by GNU @code{troff} or the user (with @code{char} and related requests).
+This practice applies the presence of @code{} in the class name to
+prevent the use of the special character escape form
+@code{\@r{@dots{}}}, thus you must use the @code{\C} escape to access
+a class with such a name.
+
+@cindex GGL (@code{groff} glyph list)
+@cindex @code{groff} glyph list (GGL)
+You can also use a character range notation consisting of a
+start character followed by @samp{-} and then an end character.
+Internally, GNU @code{troff} converts these two symbol names to
+Unicode code points (according to the @code{groff} glyph list GGL),
+which then give the start and end value of the range.  If that fails,
+the class definition is skipped.
 
-Here is a more complex example:
+Furthermore, classes can be nested.
 
 @Example
+.class prepunct , : ; > @}
 .class prepunctx \C'prepunct' \u2013-\u2016
 @endExample
 
-The class @samp{prepunctx} now contains the contents of the class
-@code{prepunct} as defined above (the set @samp{, : ; > @}}), and
+@noindent
+The class @samp{prepunctx} thus contains the contents of the class
+@code{prepunct} as defined above (the set @samp{, : ; > @}}), and
 characters in the range between @code{U+2013} and @code{U+2016}.
 
-If you want to add @samp{-} to a class, it must be the first character
-value in the argument list, otherwise it gets misinterpreted as a range.
+If you want to include @samp{-} in a class, it must be the first
+character value in the argument list, otherwise it gets misinterpreted
+as part of the range syntax.
 
-Note that it is not possible to use class names within range
+It is not possible to use class names as end points of range
 definitions.
 
-Typical use of the @code{class} request is to control line-breaking and
-hyphenation rules as defined by the @code{cflags} request.  For example,
-to inhibit line breaks before the characters belonging to the
-@code{prepunctx} class, you can write:
+A typical use of the @code{class} request is to control line-breaking
+and hyphenation rules as defined by the @code{cflags} request.  For
+example, to inhibit line breaks before the characters belonging to the
+@code{prepunctx} class defined in the previous example, you can write
+the following.
 
 @Example
 .cflags 2 \C'prepunctx'
 @endExample
 
+@noindent
 See the @code{cflags} request in @ref{Using Symbols}, for more details.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Special Fonts, Artificial Fonts, Character Classes, Fonts and Symbols
+@node Special Fonts, Artificial Fonts, Character Classes, Using Fonts
 @subsection Special Fonts
 @cindex special fonts
 @cindex fonts, special
@@ -10012,36 +11257,36 @@
 
 @c ---------------------------------------------------------------------
 
-@node Artificial Fonts, Ligatures and Kerning, Special Fonts, Fonts and Symbols
+@node Artificial Fonts, Ligatures and Kerning, Special Fonts, Using Fonts
 @subsection Artificial Fonts
 @cindex artificial fonts
 @cindex fonts, artificial
 
-There are a number of requests and escapes for artificially creating
-fonts.  These are largely vestiges of the days when output devices did
-not have a wide variety of fonts, and when @code{nroff} and @code{troff}
-were separate programs.  Most of them are no longer necessary in GNU
-@code{troff}.  Nevertheless, they are supported.
-
-@DefescList {\\H, ', height, '}
-@DefescItem {\\H, ', @t{+}height, '}
-@DefescItem {\\H, ', @t{-}height, '}
+There are a number of requests and escape sequences for artificially
+creating fonts.  These are largely vestiges of the days when output
+devices did not have a wide variety of fonts, and when @code{nroff} and
+@code{troff} were separate programs.  Most of them are no longer
+necessary in GNU @code{troff}.  Nevertheless, they are supported.
+
+@DefescList {\\H, @code{'}, height, @code{'}}
+@DefescItem {\\H, @code{'}, @t{+}height, @code{'}}
+@DefescItem {\\H, @code{'}, @t{-}height, @code{'}}
 @DefregListEndx {.height}
 @cindex changing the font height (@code{\H})
 @cindex font height, changing (@code{\H})
 @cindex height, font, changing (@code{\H})
 Change (increment, decrement) the height of the current font, but not
 the width.  If @var{height} is zero, restore the original height.
-Default scaling indicator is @samp{z}.
+Default scaling unit is @samp{z}.
 
-The read-only number register @code{.height} contains the font height as
-set by @code{\H}.
+The read-only register @code{.height} contains the font height as set by
+@code{\H}.
 
 Currently, only the @option{-Tps} and @option{-Tpdf} devices support
 this feature.
 
-Note that @code{\H} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
+@code{\H} doesn't produce an input token in GNU @code{troff}.  As a
+consequence, it can be used in requests like @code{mc} (which expects
 a single character as an argument) to change the font on the fly:
 
 @Example
@@ -10050,7 +11295,7 @@
 
 In compatibility mode, @code{gtroff} behaves differently: If an
 increment or decrement is used, it is always taken relative to the
-current point size and not relative to the previously selected font
+current type size and not relative to the previously selected font
 height.  Thus,
 
 @Example
@@ -10063,7 +11308,7 @@
 larger than the current font size).
 @endDefesc
 
-@DefescList {\\S, ', slant, '}
+@DefescList {\\S, @code{'}, slant, @code{'}}
 @DefregListEndx {.slant}
 @cindex changing the font slant (@code{\S})
 @cindex font slant, changing (@code{\S})
@@ -10071,22 +11316,24 @@
 Slant the current font by @var{slant} degrees.  Positive values slant to
 the right.  Only integer values are possible.
 
-The read-only number register @code{.slant} contains the font slant as
-set by @code{\S}.
+The read-only register @code{.slant} contains the font slant as set by
+@code{\S}.
 
 Currently, only the @option{-Tps} and @option{-Tpdf} devices support
 this feature.
 
-Note that @code{\S} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
+@code{\S} doesn't produce an input token in GNU @code{troff}.  As a
+consequence, it can be used in requests like @code{mc} (which expects
 a single character as an argument) to change the font on the fly:
 
 @Example
 .mc \S'20'x\S'0'
 @endExample
 
-This request is incorrectly documented in the original Unix troff
-manual; the slant is always set to an absolute value.
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{\S} escape
+This escape is incorrectly documented in the @acronym{AT&T}
+@code{troff} manual; the slant is always set to an absolute value.
 @endDefesc
 
 @Defreq {ul, @Var{lines}}
@@ -10094,12 +11341,12 @@
 The @code{ul} request normally underlines subsequent lines if a TTY
 output device is used.  Otherwise, the lines are printed in italics
 (only the term `underlined' is used in the following).  The single
-argument is the number of input lines to be underlined; with no
+argument is the quantity of input lines to be underlined; with no
 argument, the next line is underlined.  If @var{lines} is zero or
 negative, stop the effects of @code{ul} (if it was active).  Requests
 and empty lines do not count for computing the number of underlined
 input lines, even if they produce some output like @code{tl}.  Lines
-inserted by macros (e.g.@: invoked by a trap) do count.
+inserted by macros (e.g., invoked by a trap) do count.
 
 At the beginning of @code{ul}, the current font is stored and the
 underline font is activated.  Within the span of a @code{ul} request, it
@@ -10107,13 +11354,14 @@
 @code{ul} the saved font is restored.
 
 This number of lines still to be underlined is associated with the
-current environment (@pxref{Environments}).  The underline font can be
-changed with the @code{uf} request.
+environment (@pxref{Environments}).  The underline font can be changed
+with the @code{uf} request.
 
 @c XXX @xref should be changed to grotty
 
-@c @xref{Troff and Nroff Mode}, for a discussion how underlining is
-@c implemented in for TTY output devices, and which problems can arise.
+@c @xref{@code{troff} and @code{nroff} Modes}, for a discussion of how
+@c underlining is implemented for terminal output devices, and what
+@c problems can arise.
 
 The @code{ul} request does not underline spaces.
 @endDefreq
@@ -10136,10 +11384,10 @@
 @DefreqList {bd, font @Var{offset}}
 @DefreqItem {bd, font1 font2 @Var{offset}}
 @DefregListEndx {.b}
-@cindex imitating bold face (@code{bd})
-@cindex bold face, imitating (@code{bd})
-Artificially create a bold font by printing each glyph twice, slightly
-offset.
+@cindex imitating boldface (@code{bd})
+@cindex boldface, imitating (@code{bd})
+Embolden @var{font} by overstriking its glyphs offset by @var{offset}
+units minus one.
 
 Two syntax forms are available.
 
@@ -10163,7 +11411,7 @@
 @cindex special fonts, emboldening
 @item
 Imitate a bold form conditionally.  Embolden @var{font1} by @var{offset}
-only if font @var{font2} is the current font.  This command can be
+only if font @var{font2} is the current font.  This request can be
 issued repeatedly to set up different emboldening values for different
 current fonts.  If the second argument is missing, emboldening is turned
 off for this particular current font.
@@ -10185,13 +11433,13 @@
 when the font is effectively in use.  Without second and third argument,
 constant glyph space mode is deactivated.
 
-Default scaling indicator for @var{em-size} is @samp{z}; @var{width} is
-an integer.
+Default scaling unit for @var{em-size} is @samp{z}; @var{width} is an
+integer.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Ligatures and Kerning,  , Artificial Fonts, Fonts and Symbols
+@node Ligatures and Kerning, Dummy Characters, Artificial Fonts, Using Fonts
 @subsection Ligatures and Kerning
 @cindex ligatures and kerning
 @cindex kerning and ligatures
@@ -10202,15 +11450,15 @@
 (albeit subtle) to the printed output.  Usually, ligatures are not
 available in fonts for TTY output devices.
 
-Most @sc{PostScript} fonts support the fi and fl ligatures.  The C/A/T
+Most PostScript fonts support the fi and fl ligatures.  The C/A/T
 typesetter that was the target of @acronym{AT&T} @code{troff} also
 supported `ff', `ffi', and `ffl' ligatures.  Advanced typesetters or
 `expert' fonts may include ligatures for `ft' and `ct', although GNU
 @code{troff} does not support these (yet).
 
 Only the current font is checked for ligatures and kerns; neither
-special fonts nor entities defined with the @code{char} request (and its
-siblings) are taken into account.
+special fonts nor special charcters defined with the @code{char} request
+(and its siblings) are taken into account.
 
 @DefreqList {lg, @Var{flag}}
 @DefregListEndx {.lg}
@@ -10219,9 +11467,8 @@
 @cindex ligatures enabled register (@code{.lg})
 Switch the ligature mechanism on or off; if the parameter is non-zero or
 missing, ligatures are enabled, otherwise disabled.  Default is on.  The
-current ligature mode can be found in the read-only number register
-@code{.lg} (set to 1 or@tie{}2 if ligatures are enabled,
-0@tie{}otherwise).
+current ligature mode can be found in the read-only register @code{.lg}
+(set to 1 or@tie{}2 if ligatures are enabled, 0@tie{}otherwise).
 
 Setting the ligature mode to@tie{}2 enables the two-character ligatures
 (fi, fl, and ff) and disables the three-character ligatures (ffi and
@@ -10244,18 +11491,17 @@
 @cindex kerning, activating (@code{kern})
 @cindex kerning enabled register (@code{.kern})
 Switch kerning on or off.  If the parameter is non-zero or missing,
-enable pairwise kerning, otherwise disable it.  The read-only number
-register @code{.kern} is set to@tie{}1 if pairwise kerning is enabled,
+enable pairwise kerning, otherwise disable it.  The read-only register
+@code{.kern} is set to@tie{}1 if pairwise kerning is enabled,
 0@tie{}otherwise.
 
-@cindex zero width space character (@code{\&})
-@cindex character, zero width space (@code{\&})
-@cindex space character, zero width (@code{\&})
+@cindex dummy character (@code{\&}), effect on kerning
+@cindex character, dummy (@code{\&}), effect on kerning
 If the font description file contains pairwise kerning information,
 glyphs from that font are kerned.  Kerning between two glyphs can be
 inhibited by placing @code{\&} between them: @samp{V\&A}.
 
-@xref{Font File Format}.
+@xref{Font Description File Format}.
 @endDefreq
 
 @cindex track kerning
@@ -10272,87 +11518,89 @@
 Enable track kerning for font@tie{}@var{f}.  If the current font
 is@tie{}@var{f} the width of every glyph is increased by an amount
 between @var{n1} and @var{n2} (@var{n1}, @var{n2} can be negative); if
-the current point size is less than or equal to @var{s1} the width is
+the current type size is less than or equal to @var{s1} the width is
 increased by @var{n1}; if it is greater than or equal to @var{s2} the
-width is increased by @var{n2}; if the point size is greater than or
+width is increased by @var{n2}; if the type size is greater than or
 equal to @var{s1} and less than or equal to @var{s2} the increase in
-width is a linear function of the point size.
+width is a linear function of the type size.
 
-The default scaling indicator is @samp{z} for @var{s1} and @var{s2},
-@samp{p} for @var{n1} and @var{n2}.
+The default scaling unit is @samp{z} for @var{s1} and @var{s2}, @samp{p}
+for @var{n1} and @var{n2}.
 
-Note that the track kerning amount is added even to the rightmost glyph
-in a line; for large values it is thus recommended to increase the line
-length by the same amount to compensate it.
+The track kerning amount is added even to the rightmost glyph in a line;
+for large values it is thus recommended to increase the line length by
+the same amount to compensate.
 @endDefreq
 
-Sometimes, when typesetting letters of different fonts, more or less
-space at such boundaries is needed.  There are two escapes to help with
-this.
+@c ---------------------------------------------------------------------
+
+@node Italic Corrections, Dummy Characters, Ligatures and Kerning, Using Fonts
+@subsection Italic Corrections
+
+When typesetting adjacent glyphs from typefaces of different slants, the
+space between them may require adjustment.
 
 @Defesc {\\/, , , }
 @cindex italic correction (@code{\/})
 @cindex correction, italic (@code{\/})
-@cindex correction between italic and roman glyph (@code{\/}, @code{\,})
+@cindex correction between oblique and upright glyph (@code{\/}, @code{\,})
 @cindex roman glyph, correction after italic glyph (@code{\/})
-@cindex italic glyph, correction before roman glyph (@code{\/})
-@cindex glyph, italic correction (@code{\/})
-Increase the width of the preceding glyph so that the spacing between
-that glyph and the following glyph is correct if the following glyph is
-a roman glyph.  For example, if an italic@tie{}@code{f} is immediately
-followed by a roman right parenthesis, then in many fonts the top right
-portion of the@tie{}@code{f} overlaps the top left of the right
-parenthesis.  Use this escape sequence whenever an italic glyph is
-immediately followed by a roman glyph without any intervening space.
-This small amount of space is also called @dfn{italic correction}.
-
-@iftex
-@c can't use @Example...@endExample here
-@example
-@group
-\fIf\fR)
-    @result{} {@it f}@r{)}
-\fIf\/\fR)
-    @result{} @i{f}@r{)}
-@end group
-@end example
-@end iftex
+@cindex upright glyph, correction after oblique glyph (@code{\/})
+Apply an @dfn{italic correction}:@: modify the spacing of the preceding
+glyph so that the distance between it and the following glyph is correct
+if the latter is of upright shape.  For example, if an
+italic@tie{}@samp{f} is followed immediately by a roman right
+parenthesis, then in many fonts the top right portion of
+the@tie{}@samp{f} overlaps the top left of the right parenthesis, which
+is ugly.  Use this escape sequence whenever an oblique glyph is
+immediately followed by an upright glyph without any intervening space.
 @endDefesc
 
 @Defesc {\\\,, , , }
 @cindex left italic correction (@code{\,})
 @cindex correction, left italic (@code{\,})
-@cindex glyph, left italic correction (@code{\,})
+@cindex correction between upright and oblique glyph (@code{\/}, @code{\,})
 @cindex roman glyph, correction before italic glyph (@code{\,})
-@cindex italic glyph, correction after roman glyph (@code{\,})
-Modify the spacing of the following glyph so that the spacing between
-that glyph and the preceding glyph is correct if the preceding glyph is
-a roman glyph.  Use this escape sequence whenever a roman glyph is
-immediately followed by an italic glyph without any intervening space.
-In analogy to above, this space could be called @dfn{left italic
-correction}, but this term isn't used widely.
-
-@iftex
-@c can't use @Example...@endExample here
-@example
-@group
-q\fIf
-    @result{} @r{q}@i{f}
-q\,\fIf
-    @result{} @r{q}@math{@ptexcomma}@i{f}
-@end group
-@end example
-@end iftex
+@cindex upright glyph, correction before oblique glyph (@code{\,})
+Apply a @dfn{left italic correction}:@: modify the spacing of the
+following glyph so that the distance between it and the preceding
+glyph is correct if the latter is of upright shape.  For example,
+if a roman left parenthesis is immediately followed by an
+italic@tie{}@samp{f}, then in many fonts the bottom left portion of
+the@tie{}@samp{f} overlaps the bottom of the left parenthesis, which is
+ugly.  Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
 @endDefesc
 
+@c XXX: Can we move this node earlier in the text?  Should it come
+@c before some of the dummy character's multifarious effects?
+@need 1000
+@node Dummy Characters,  , Italic Corrections, Using Fonts
+@subsection Dummy Characters
+
+As discussed in @ref{Requests and Macros}, the first character on an
+input line is treated specially.  Further, formatting a glyph has many
+consequences on formatter state (@pxref{Environments}).  Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
+
 @Defesc {\\&, , , }
-Insert a zero-width character, which is invisible.  Its intended use is
-to stop interaction of a character with its surroundings.
+@cindex dummy character (@code{\&})
+@cindex character, dummy (@code{\&})
+Interpolate a dummy character, which is constitutive of output but
+invisible.@footnote{Opinions of this escape sequence's name abound.
+``Zero-width space'' is a popular misnomer:@: @code{roff} formatters do
+not treat it like a space.  Ossanna called it a ``non-printing,
+zero-width character'', but the character causes @emph{output} even
+though it does not ``print''.  If no output line is pending, the dummy
+character starts one.  Contrast an empty input document with one
+containing only @code{\&}.  The former produces no output; the latter, a
+blank page.}  Its presence alters the interpretation context of a
+subsequent input character, and enjoys several applications.
 
 @itemize @bullet
 @item
-It prevents the insertion of extra space after an end-of-sentence
-character.
+Prevent insertion of extra space after an end-of-sentence character.
 
 @Example
 Test.
@@ -10364,18 +11612,17 @@
 @endExample
 
 @item
-It prevents interpretation of a control character at the beginning of an
-input line.
+Prevent recognition of a control character.
 
 @Example
 .Test
-    @result{} warning: `Test' not defined
+    @error{} warning: macro 'Test' not defined
 \&.Test
     @result{} .Test
 @endExample
 
 @item
-It prevents kerning between two glyphs.
+Prevent kerning between two glyphs.
 
 @iftex
 @c can't use @Example...@endExample here
@@ -10390,77 +11637,120 @@
 @end iftex
 
 @item
-It is needed to map an arbitrary character to nothing in the @code{tr}
-request (@pxref{Character Translations}).
+Translate a character to ``nothing''.
+
+@Example
+.tr JIjiK\&k\&UVuv
+@c XXX: I might have the wrong noun declension in "university" here.
+Post universitum, alea jacta est, OK?
+    @result{} Post vniversitvm, alea iacta est, O?
+@endExample
 @end itemize
+
+The dummy character escape sequence sees use in macro definitions as a
+means of ensuring that arguments are treated as text even if they begin
+with spaces or control characters.
+
+@Example
+.de HD \" typeset a simple bold heading
+.  sp
+.  ft B
+\&\\$1 \" exercise: remove the \&
+.  ft
+.  sp
+..
+.HD .\|.\|.\|surprised?
+@endExample
 @endDefesc
 
+One way to think about the dummy character is to imagine placing the
+symbol @samp{&} in the input at a certain location; if doing so has all
+the side effects on formatting that you desire except for sticking an
+ugly ampersand in the midst of your text, the dummy character is what
+you want in its place.
+
+@c XXX: This feature seems nearly impossible to motivate.  The _only_
+@c use of it in the groff source tree is for the mdoc package, for which
+@c it seems to be special pleading for that package's unique approach to
+@c macro argument reprocessing, which also involves an idiosyncratic
+@c approach to punctuation characters in macro argument lists.
 @Defesc {\\), , , }
-This escape is similar to @code{\&} except that it behaves like a
-character declared with the @code{cflags} request to be transparent for
-the purposes of an end-of-sentence character.
-
-Its main usage is in macro definitions to protect against arguments
-starting with a control character.
+@cindex transparent dummy character (@code{\)})
+@cindex character, transparent dummy (@code{\)})
+@cindex dummy character, transparent (@code{\)})
+Interpolate a @slanted{transparent} dummy character---one that is
+transparent to end-of-sentence detection.  It behaves as @code{\&},
+except that @code{\&} is treated as letters and numerals normally are
+after @samp{.}, @samp{?} and @samp{!}; @code{\&} cancels end-of-sentence
+detection, and @code{\)} does not.
+@c This feature seems too weak to me; see Savannah #60571.  -- GBR
 
 @Example
-.de xxx
-\)\\$1
+.de Suffix-&
+.  nop \&\\$1
 ..
-.de yyy
-\&\\$1
+.
+.de Suffix-)
+.  nop \)\\$1
 ..
-This is a test.\c
-.xxx '
-This is a test.
-    @result{}This is a test.'  This is a test.
-This is a test.\c
-.yyy '
-This is a test.
-    @result{}This is a test.' This is a test.
+.
+Here's a sentence.\c
+.Suffix-& '
+Another one.\c
+.Suffix-) '
+And a third.
+    @result{} Here's a sentence.' Another one.'  And a third.
 @endExample
 @endDefesc
 
 
 @c =====================================================================
 
-@node Sizes, Strings, Fonts and Symbols, gtroff Reference
-@section Sizes
-@cindex sizes
+@c TODO: Move the troff and nroff mode stuff here.  Try to keep stuff
+@c that isn't ignored in nroff above this point, and stuff for
+@c typesetters below, until we hit the programming/advanced concepts.
+@c XXX: Thorny issue: nroff/terminal devices ignore type size but
+@c _honor_ vertical spacing (to within their crude vertical motion
+@c quanta).
+
+@need 2000
+@node Manipulating Type Size and Vertical Spacing, Colors, Using Fonts, GNU troff Reference
+@section Manipulating Type Size and Vertical Spacing
+@cindex manipulating type size and vertical spacing
 
-@cindex baseline
+@cindex text baseline
+@cindex baseline, text
 @cindex type size
-@cindex size of type
+@cindex size, size
 @cindex vertical spacing
 @cindex spacing, vertical
-@code{gtroff} uses two dimensions with each line of text, type size and
-vertical spacing.  The @dfn{type size} is approximately the height of
-the tallest glyph.@footnote{This is usually the parenthesis.  Note that
-in most cases the real dimensions of the glyphs in a font are @emph{not}
-related to its type size!  For example, the standard @sc{PostScript}
-font families `Times Roman', `Helvetica', and `Courier' can't be used
-together at 10@dmn{pt}; to get acceptable output, the size of
-`Helvetica' has to be reduced by one point, and the size of `Courier'
-must be increased by one point.}  @dfn{Vertical spacing} is the amount
-of space @code{gtroff} allows for a line of text; normally, this is
-about 20%@tie{}larger than the current type size.  Ratios smaller than
-this can result in hard-to-read text; larger than this, it spreads the
-text out more vertically (useful for term papers).  By default,
-@code{gtroff} uses 10@tie{}point type on 12@tie{}point spacing.
-
+These concepts were introduced in @ref{Page Geometry}.  The height of a
+font's tallest glyph is one em, which is equal to the type size in
+points.@footnote{In text fonts, the tallest glyphs are typically
+parentheses.  Unfortunately, in many cases the actual dimensions of the
+glyphs in a font do not closely match its declared type size!  For
+example, in the standard PostScript font families, 10-point Times sets
+better with 9-point Helvetica and 11-point Courier than if all three
+were used at 10@tie{}points.}  A vertical spacing of less than 120% of
+the type size can make a document hard to read.  Larger proportions can
+be useful to spread the text for annotations or proofreader's marks.  By
+default, GNU @code{troff} uses 10@tie{}point type on 12@tie{}point
+spacing.
 @cindex leading
-The difference between type size and vertical spacing is known, by
-typesetters, as @dfn{leading} (this is pronounced `ledding').
+Typographers call the difference between type size and vertical spacing
+@dfn{leading}.@footnote{Rhyme with ``sledding''; mechanical typography
+used lead metal (Latin @emph{plumbum}).}
 
 @menu
-* Changing Type Sizes::
-* Fractional Type Sizes::
+* Changing the Type Size::
+* Changing the Vertical Spacing::
+* Using Fractional Type Sizes::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Changing Type Sizes, Fractional Type Sizes, Sizes, Sizes
-@subsection Changing Type Sizes
+@node Changing the Type Size, Changing the Vertical Spacing, Manipulating Type Size and Vertical Spacing, Manipulating Type Size and Vertical Spacing
+@subsection Changing the Type Size
 
 @DefreqList {ps, @Var{size}}
 @DefreqItem {ps, @t{+}@Var{size}}
@@ -10470,86 +11760,90 @@
 @cindex changing type sizes (@code{ps}, @code{\s})
 @cindex type sizes, changing (@code{ps}, @code{\s})
 @cindex point sizes, changing (@code{ps}, @code{\s})
-Use the @code{ps} request or the @code{\s} escape to change (increase,
-decrease) the type size (in points).  Specify @var{size} as either an
-absolute point size, or as a relative change from the current size.  The
-size@tie{}0 (for both @code{.ps} and @code{\s}), or no argument (for
-@code{.ps} only), goes back to the previous size.
-
-Default scaling indicator of @code{size} is @samp{z}.  If @code{size} is
-negative, it is set to 1@dmn{u}.
+Use the @code{ps} request or the @code{\s} escape sequence to change
+(increase, decrease) the type size (in scaled points).  Specify
+@var{size} as either an absolute type size, or as a relative change from
+the current size.  @code{ps} with no argument restores the previous
+size.  The @code{ps} request's default scaling unit is @samp{z}.  The
+requested size is rounded to the nearest valid size (with ties rounding
+down) within the limits supported by the device.  If the requested size
+is non-positive, it is treated as 1@dmn{u}.
+
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{ps} request
+@cindex CSTR@tie{}#54 erratum, @code{\s} escape sequence
+Type size alteration is incorrectly documented in the @acronym{AT&T}
+@code{troff} manual, which claims ``if the requested size is invalid,
+the next larger valid size will result, with a maximum of
+36''.@footnote{The claim appears to have been true of Ossanna
+@code{troff} for the C/A/T device; Kernighan made device-independent
+@code{troff} more flexible.}
 
 @cindex type size registers (@code{.s}, @code{.ps})
 @cindex point size registers (@code{.s}, @code{.ps})
-The read-only number register @code{.s} returns the point size in points
-as a decimal fraction.  This is a string.  To get the point size in
-scaled points, use the @code{.ps} register instead.
+The read-only string-valued register @code{.s} interpolates the type
+size in points as a decimal fraction; it is associated with the
+environment (@pxref{Environments}).  To obtain the type size in scaled
+points, interpolate the @code{.ps} register instead (@pxref{Using
+Fractional Type Sizes}).
 
-@code{.s} is associated with the current environment
-(@pxref{Environments}).
-
-@Example
-snap, snap,
-.ps +2
-grin, grin,
-.ps +2
-wink, wink, \s+2nudge, nudge,\s+8 say no more!
-.ps 10
-@endExample
-
-The @code{\s} escape may be called in a variety of ways.  Much like
-other escapes there must be a way to determine where the argument ends
-and the text begins.  Any of the following forms are valid:
+The @code{\s} escape sequence supports a variety of syntax forms.
 
 @table @code
 @item \s@var{n}
-Set the point size to @var{n}@tie{}points.  @var{n}@tie{}must be either
-0 or in the range 4 to@tie{}39.
+Set the type size to @var{n}@tie{}points.  @var{n}@tie{}must be a single
+digit.  If @var{n}@tie{}is 0, restore the previous size.
 
 @item \s+@var{n}
 @itemx \s-@var{n}
-Increase or decrease the point size by @var{n}@tie{}points.
+Increase or decrease the type size by @var{n}@tie{}points.
 @var{n}@tie{}must be exactly one digit.
 
 @item \s(@var{nn}
-Set the point size to @var{nn}@tie{}points.  @var{nn} must be exactly
-two digits.
+Set the type size to @var{nn}@tie{}points.  @var{nn} must be exactly two
+digits.
 
 @item \s+(@var{nn}
 @itemx \s-(@var{nn}
 @itemx \s(+@var{nn}
 @itemx \s(-@var{nn}
-Increase or decrease the point size by @var{nn}@tie{}points.  @var{nn}
-must be exactly two digits.
+Alter the type size in points by the two-digit value @var{nn}.
 @end table
 
-Note that @code{\s} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
-a single character as an argument) to change the font on the fly:
+@xref{Using Fractional Type Sizes}, for further syntactical forms of the
+@code{\s} escape sequence that additionally accept decimal fractions.
+
+@Example
+snap, snap,
+.ps +2
+grin, grin,
+.ps +2
+wink, wink, \s+2nudge, nudge,\s+8 say no more!
+.ps 10
+@endExample
+@endDefreq
+
+The @code{\s} escape sequence affects the environment immediately and
+doesn't produce an input token.  Consequently, it can be used in
+requests like @code{mc}, which expects a single character as an
+argument, to change the type size on the fly.
 
 @Example
 .mc \s20x\s0
 @endExample
 
-@xref{Fractional Type Sizes}, for yet another syntactical form of using
-the @code{\s} escape.
+@Defreq {sizes, s1 s2 @dots{} sn @t{0}}
+The @file{DESC} file specifies which type sizes are allowed by the
+output device; see @ref{DESC File Format}.  Use the @code{sizes} request
+to change this set of permissible sizes.  Arguments are in scaled
+points; see @ref{Using Fractional Type Sizes}.  Each can be a single
+type size (such as @samp{12000}), or a range of sizes (such as
+@samp{4000-72000}).  You can optionally end the list with a @samp{0}.
 @endDefreq
 
-@Defreq {sizes, s1 s2 @dots{} sn 0}
-Some devices may only have certain permissible sizes, in which case
-@code{gtroff} rounds to the nearest permissible size.  The @file{DESC}
-file specifies which sizes are permissible for the device.
-
-Use the @code{sizes} request to change the permissible sizes for the
-current output device.  Arguments are in scaled points; the
-@code{sizescale} line in the @file{DESC} file for the output device
-provides the scaling factor.  For example, if the scaling factor is
-1000, then the value 12000 is 12@tie{}points.
-
-Each argument can be a single point size (such as @samp{12000}), or a
-range of sizes (such as @samp{4000-72000}).  You can optionally end the
-list with a zero.
-@endDefreq
+@need 1000
+@node Changing the Vertical Spacing, Using Fractional Type Sizes, Changing the Type Size, Manipulating Type Size and Vertical Spacing
+@subsection Changing the Vertical Spacing
 
 @DefreqList {vs, @Var{space}}
 @DefreqItem {vs, @t{+}@Var{space}}
@@ -10558,67 +11852,62 @@
 @cindex changing vertical line spacing (@code{vs})
 @cindex vertical line spacing, changing (@code{vs})
 @cindex vertical line spacing register (@code{.v})
-Change (increase, decrease) the vertical spacing by @var{space}.  The
-default scaling indicator is @samp{p}.
-
-If @code{vs} is called without an argument, the vertical spacing is
-reset to the previous value before the last call to @code{vs}.
-
+Set the vertical spacing to, or alter it by, @var{space}.  The default
+scaling unit is @samp{p}.  If @code{vs} is called without an argument,
+the vertical spacing is reset to the previous value before the last call
+to @code{vs}.
 @cindex @code{.V} register, and @code{vs}
-@code{gtroff} creates a warning of type @samp{range} if @var{space} is
-negative; the vertical spacing is then set to smallest positive value,
-the vertical resolution (as given in the @code{.V} register).
-
-Note that @w{@samp{.vs 0}} isn't saved in a diversion since it doesn't
-result in a vertical motion.  You explicitly have to repeat this command
-before inserting the diversion.
+GNU @code{troff} emits a warning in category @samp{range} if @var{space}
+is negative; the vertical spacing is then set to the smallest possible
+positive value, the vertical motion quantum (as found in the @code{.V}
+register).
+
+@w{@samp{.vs 0}} isn't saved in a diversion since it doesn't result in
+a vertical motion.  You must explicitly issue this request before
+interpolating the diversion.
 
-The read-only number register @code{.v} contains the current vertical
-spacing; it is associated with the current environment
-(@pxref{Environments}).
+The read-only register @code{.v} contains the vertical spacing; it is
+associated with the environment (@pxref{Environments}).
 @endDefreq
 
 @cindex vertical line spacing, effective value
-The effective vertical line spacing consists of four components.
-Breaking a line causes the following actions (in the given order).
+@noindent
+When a break occurs, GNU @code{troff} performs the following procedure.
 
 @itemize @bullet
 @item
 @cindex extra pre-vertical line space (@code{\x})
 @cindex line space, extra pre-vertical (@code{\x})
-Move the current point vertically by the @dfn{extra pre-vertical line
-space}.  This is the minimum value of all @code{\x} escapes with a
-negative argument in the current output line.
+Move the drawing position vertically by the @dfn{extra pre-vertical line
+space}, the minimum of all negative @code{\x} escape sequence arguments
+in the pending output line.
 
 @item
-Move the current point vertically by the vertical line spacing as set
-with the @code{vs} request.
+Move the drawing position vertically by the vertical line spacing.
 
 @item
-Output the current line.
+Write out the pending output line.
 
 @item
 @cindex extra post-vertical line space (@code{\x})
 @cindex line space, extra post-vertical (@code{\x})
-Move the current point vertically by the @dfn{extra post-vertical line
-space}.  This is the maximum value of all @code{\x} escapes with a
-positive argument in the line that has just been output.
+Move the drawing position vertically by the @dfn{extra post-vertical line
+space}, the maximum of all positive @code{\x} escape sequence arguments
+in the line that has just been output.
 
 @item
 @cindex post-vertical line spacing
 @cindex line spacing, post-vertical (@code{pvs})
-Move the current point vertically by the @dfn{post-vertical line
-spacing} as set with the @code{pvs} request.
+Move the drawing position vertically by the @dfn{post-vertical line
+spacing} (see below).
 @end itemize
 
 @cindex double-spacing (@code{vs}, @code{pvs})
-It is usually better to use @code{vs} or @code{pvs} instead of @code{ls}
-to produce double-spaced documents: @code{vs} and @code{pvs} have a
-finer granularity for the inserted vertical space compared to @code{ls};
-furthermore, certain preprocessors assume single-spacing.
-
-@xref{Manipulating Spacing}, for more details on the @code{\x} escape
-and the @code{ls} request.
+Prefer @code{vs} or @code{pvs} over @code{ls} to produce double-spaced
+documents.  @code{vs} and @code{pvs} have finer granularity than
+@code{ls}; moreover, some preprocessors assume single spacing.
+@xref{Manipulating Spacing}, regarding the @code{\x} escape sequence and
+the @code{ls} request.
 
 @DefreqList {pvs, @Var{space}}
 @DefreqItem {pvs, @t{+}@Var{space}}
@@ -10627,105 +11916,116 @@
 @cindex @code{ls} request, alternative to (@code{pvs})
 @cindex post-vertical line spacing, changing (@code{pvs})
 @cindex post-vertical line spacing register (@code{.pvs})
-Change (increase, decrease) the post-vertical spacing by @var{space}.
-The default scaling indicator is @samp{p}.
-
-If @code{pvs} is called without an argument, the post-vertical spacing
-is reset to the previous value before the last call to @code{pvs}.
+Set the post-vertical spacing to, or alter it by, @var{space}.  The
+default scaling unit is @samp{p}.  If @code{pvs} is called without an
+argument, the post-vertical spacing is reset to the previous value
+before the last call to @code{pvs}.  GNU @code{troff} emits a warning in
+category @samp{range} if @var{space} is negative; the post-vertical
+spacing is then set to zero.
 
-@code{gtroff} creates a warning of type @samp{range} if @var{space} is
-zero or negative; the vertical spacing is then set to zero.
-
-The read-only number register @code{.pvs} contains the current
-post-vertical spacing; it is associated with the current environment
-(@pxref{Environments}).
+The read-only register @code{.pvs} contains the post-vertical spacing;
+it is associated with the environment (@pxref{Environments}).
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Fractional Type Sizes,  , Changing Type Sizes, Sizes
-@subsection Fractional Type Sizes
+@c BEGIN Keep (roughly) parallel with subsection "Fractional type sizes
+@c and new scaling units" of groff_diff(7).
+@node Using Fractional Type Sizes,  , Changing the Type Size, Manipulating Type Size and Vertical Spacing
+@subsection Using Fractional Type Sizes
 @cindex fractional type sizes
 @cindex fractional point sizes
 @cindex type sizes, fractional
 @cindex point sizes, fractional
-@cindex sizes, fractional
+@cindex sizes, fractional type
 
-@cindex @code{s} unit
-@cindex unit, @code{s}
-@cindex @code{z} unit
-@cindex unit, @code{z}
+AT&T @code{troff} interpreted all type size measurements in points.
+Combined with integer arithmetic, this design choice made it impossible
+to support, for instance, ten and a half-point type.  In GNU
+@code{troff}, an output device can select a scaling factor that
+subdivides a point into ``scaled points''.  A type size expressed in
+scaled points can thus represent a non-integral type size.
+
+@cindex @code{s} scaling unit
+@cindex unit, scaling, @code{s}
+@cindex scaling unit @code{s}
+@cindex @code{z} scaling unit
+@cindex unit, scaling, @code{z}
+@cindex scaling unit @code{z}
 @cindex @code{ps} request, with fractional type sizes
 @cindex @code{cs} request, with fractional type sizes
 @cindex @code{tkf} request, with fractional type sizes
 @cindex @code{\H}, with fractional type sizes
 @cindex @code{\s}, with fractional type sizes
 A @dfn{scaled point} is equal to @math{1/@var{sizescale}} points, where
-@var{sizescale} is specified in the @file{DESC} file (1@tie{}by
-default).  There is a new scale indicator @samp{z}, which has the effect
-of multiplying by @var{sizescale}.  Requests and escape sequences in
-@code{gtroff} interpret arguments that represent a point size as being
-in units of scaled points, but they evaluate each such argument using a
-default scale indicator of @samp{z}.  Arguments treated in this way are
-the argument to the @code{ps} request, the third argument to the
-@code{cs} request, the second and fourth arguments to the @code{tkf}
-request, the argument to the @code{\H} escape sequence, and those
-variants of the @code{\s} escape sequence that take a numeric expression
-as their argument (see below).
-
-For example, suppose @var{sizescale} is@tie{}1000; then a scaled point
-is equivalent to a millipoint; the request @w{@samp{.ps 10.25}} is
-equivalent to @w{@samp{.ps 10.25z}} and thus sets the point size to
-10250@tie{}scaled points, which is equal to 10.25@tie{}points.
-
-@code{gtroff} disallows the use of the @samp{z} scale indicator in
-instances where it would make no sense, such as a numeric expression
-whose default scale indicator was neither @samp{u} nor @samp{z}.
-Similarly it would make no sense to use a scaling indicator other than
-@samp{z} or @samp{u} in a numeric expression whose default scale
-indicator was @samp{z}, and so @code{gtroff} disallows this as well.
-
-There is also new scale indicator @samp{s}, which multiplies by the
-number of units in a scaled point.  So, for example, @samp{\n.pss} is
-equal to @samp{1m}.  Be sure not to confuse the @samp{s} and @samp{z}
-scale indicators.
+@var{sizescale} is specified in the device description file @file{DESC},
+and defaults to@tie{}1.@footnote{@xref{Device and Font Description
+Files}.}  Requests and escape sequences in GNU @code{troff} interpret
+arguments that represent a type size in scaled points, which the
+formatter multiplies by @var{sizescale} and converts to an integer.
+Arguments treated in this way comprise those to the escape sequences
+@code{\H} and @code{\s}, to the request @code{ps}, the third argument to
+the @code{cs} request, and the second and fourth arguments to the
+@code{tkf} request.  Scaled points may be specified explicitly with the
+@code{z} scaling unit.
+
+For example, if @var{sizescale} is@tie{}1000, then a scaled point is one
+thousandth of a point.  The request @samp{.ps 10.5} is synonymous with
+@samp{.ps 10.5z} and sets the type size to 10,500@tie{}scaled points, or
+10.5@tie{}points.  Consequently, in GNU @code{troff}, the register
+@code{.s} can interpolate a non-integral type size.
 
 @Defreg {.ps}
-A read-only number register returning the point size in scaled points.
-
-@code{.ps} is associated with the current environment
-(@pxref{Environments}).
+This read-only register interpolates the type size in scaled points; it
+is associated with the environment (@pxref{Environments}).
 @endDefreg
 
+It makes no sense to use the @samp{z} scaling unit in a numeric
+expression whose default scaling unit is neither @samp{u} nor @samp{z},
+so GNU @code{troff} disallows this.  Similarly, it is nonsensical to use
+a scaling unit other than @samp{z} or @samp{u} in a numeric expression
+whose default scaling unit is @samp{z}, and so GNU @code{troff}
+disallows this as well.
+
+Another GNU @code{troff} scaling unit, @samp{s}, multiplies by the
+number of basic units in a scaled point.  Thus, @samp{\n.pss} is equal
+to @samp{1m} by definition.  Do not confuse the @samp{s} and @samp{z}
+scaling units.
+@c END Keep (roughly) parallel with subsection "Fractional type sizes
+@c and new scaling units" of groff_diff(7).
+
 @DefregList {.psr}
 @DefregListEndx {.sr}
+@cindex last-requested type size registers (@code{.psr}, @code{.sr})
+@cindex type size registers, last-requested (@code{.psr}, @code{.sr})
 @cindex last-requested point size registers (@code{.psr}, @code{.sr})
 @cindex point size registers, last-requested (@code{.psr}, @code{.sr})
 @cindex @code{.ps} register, in comparison with @code{.psr}
 @cindex @code{.s} register, in comparison with @code{.sr}
-The last-requested point size in scaled points is contained in the
-@code{.psr} read-only number register.  The last requested point size in
-points as a decimal fraction can be found in @code{.sr}.  This is a
-string-valued read-only number register.
-
-Note that the requested point sizes are device-independent, whereas the
-values returned by the @code{.ps} and @code{.s} registers are not.  For
-example, if a point size of 11@dmn{pt} is requested, and a @code{sizes}
-request (or a @code{sizescale} line in a @file{DESC} file) specifies
-10.95@dmn{pt} instead, this value is actually used.
-
-Both registers are associated with the current environment
-(@pxref{Environments}).
+Output devices may be limited in the type sizes they can employ.  The
+@code{.s} and @code{.ps} registers represent the type size selected by
+the output driver as it understands a device's capability.  The last
+@emph{requested} type size is interpolated in scaled points by the
+read-only register @code{.psr} and in points as a decimal fraction by
+the read-only string-valued register @code{.sr}.  Both are associated
+with the environment (@pxref{Environments}).
+
+For example, if a type size of 10.95 points is requested, and the
+nearest size permitted by a @code{sizes} request (or by the @code{sizes}
+or @code{sizescale} directives in the device's @file{DESC} file) is 11
+points, the output driver uses the latter value.
 @endDefreg
 
-The @code{\s} escape has the following syntax for working with
-fractional type sizes:
+The @code{\s} escape sequence offers the following syntax forms that
+work with fractional type sizes and accept scaling units.  You may of
+course give them integral arguments.  The delimited forms need not use
+the neutral apostrophe; see @ref{Delimiters}.
 
 @table @code
 @item \s@var{n}
 @itemx \s'@var{n}'
-Set the point size to @var{n}@tie{}scaled points; @var{n}@tie{}is a
-numeric expression with a default scale indicator of @samp{z}.
+Set the type size to @var{n}@tie{}scaled points; @var{n}@tie{}is a
+numeric expression with a default scaling unit of @samp{z}.
 
 @item \s+@var{n}
 @itemx \s-@var{n}
@@ -10735,276 +12035,383 @@
 @itemx \s'-@var{n}'
 @itemx \s+'@var{n}'
 @itemx \s-'@var{n}'
-Increase or decrease the point size by @var{n}@tie{}scaled points;
+Increase or decrease the type size by @var{n}@tie{}scaled points;
 @var{n}@tie{}is a numeric expression (which may start with a minus sign)
-with a default scale indicator of @samp{z}.
+with a default scaling unit of @samp{z}.
 @end table
 
-@xref{Font Files}.
-
 
 @c =====================================================================
 
-@node Strings, Conditionals and Loops, Sizes, gtroff Reference
-@section Strings
-@cindex strings
-
-@code{gtroff} has string variables, which are entirely for user
-convenience (i.e.@: there are no built-in strings except @code{.T}, but
-even this is a read-write string variable).
-
-Although the following requests can be used to create strings,
-simply using an undefined string will cause it to be defined as empty.
-@xref{Identifiers}.
+@c BEGIN Keep (roughly) parallel with section "Colors" of groff(7).
+@node Colors, Strings, Manipulating Type Size and Vertical Spacing, GNU troff Reference
+@section Colors
+@cindex colors
 
-@DefreqList {ds, name @Var{string}}
-@DefreqItemx {ds1, name @Var{string}}
-@DefescItemx {\\*, , n, }
-@DefescItem {\\*, @Lparen{}, nm, }
-@DefescListEnd {\\*, @Lbrack{}, name arg1 arg2 @dots{}, @Rbrack{}}
-@cindex string interpolation (@code{\*})
-@cindex string expansion (@code{\*})
-@cindex interpolation of strings (@code{\*})
-@cindex expansion of strings (@code{\*})
-@cindex string arguments
-@cindex arguments, of strings
-Define and access a string variable @var{name} (one-character
-name@tie{}@var{n}, two-character name @var{nm}).  If @var{name} already
-exists, @code{ds} overwrites the previous definition.  Only the syntax
-form using brackets can take arguments that are handled identically to
-macro arguments; the single exception is that a closing bracket as an
-argument must be enclosed in double quotes.  @xref{Request and Macro
-Arguments}, and @ref{Parameters}.
+@cindex stroke color
+@cindex color, stroke
+@cindex fill color
+@cindex color, fill
+GNU @code{troff} supports color output with a variety of color spaces
+and up to 16 bits per channel.  Some devices, particularly terminals,
+may be more limited.  When color support is enabled, two colors are
+current at any given time: the @dfn{stroke color}, with which glyphs,
+rules (lines), and geometric objects like circles and polygons are
+drawn, and the @dfn{fill color}, which can be used to paint the interior
+of a closed geometric figure.
 
-Example:
+@DefreqList {color, @Var{n}}
+@DefregListEndx {.color}
+If @var{n} is missing or non-zero, enable the output of color-related
+device-independent output commands (this is the default); otherwise,
+disable them.  This request sets a global flag; it does not produce an
+input token (@pxref{Gtroff Internals}).
 
-@Example
-.ds foo a \\$1 test
-.
-This is \*foo nice.
-    @result{} This is a nice test.
-@endExample
+The read-only register @code{.color} is@tie{}1 if colors are enabled,
+0@tie{}otherwise.
 
-The @code{\*} escape @dfn{interpolates} (expands in-place) a
-previously defined string variable.  To be more precise, the stored
-string is pushed onto the input stack, which is then parsed by
-@code{gtroff}.  Similar to number registers, it is possible to nest
-strings, i.e., string variables can be called within string variables.
-
-If the string named by the @code{\*} escape does not exist, it is
-defined as empty, and a warning of type @samp{mac} is emitted (see
-@ref{Debugging}, for more details).
+Color can also be disabled with the @option{-c} command-line option.
+@endDefreq
 
-@cindex comments, with @code{ds}
-@cindex @code{ds} request, and comments
-@strong{Caution:} Unlike other requests, the second argument to the
-@code{ds} request takes up the entire line including trailing spaces.
-This means that comments on a line with such a request can introduce
-unwanted space into a string.
+@Defreq {defcolor, ident scheme color-component @dots{}}
+Define a color named @var{ident}.  @var{scheme} selects a color space
+and determines the quantity of required @var{color-component}s; it must
+be one of @samp{rgb} (three components), @samp{cmy} (three), @samp{cmyk}
+(four), or @samp{gray} (one).  @samp{grey} is accepted as a synonym of
+@samp{gray}.  The color components can be encoded as a single
+hexadecimal value starting with @samp{#} or @samp{##}.  The former
+indicates that each component is in the range 0--255 (0--FF), the latter
+the range 0--65,535 (0--FFFF).
 
 @Example
-.ds TeX T\h'-.2m'\v'.2m'E\v'-.2m'\h'-.1m'X \" Knuth's TeX
+.defcolor half gray #7f
+.defcolor pink rgb #FFC0CB
+.defcolor magenta rgb  ##ffff0000ffff
 @endExample
 
-@noindent
-Instead the comment should be put on another line or have the comment
-escape adjacent with the end of the string.
+@cindex @code{f} scaling unit
+@cindex unit, scaling, @code{f}
+@cindex scaling unit @code{f}
+Alternatively, each color component can be specified as a decimal
+fraction in the range 0--1, interpreted using a default scaling
+unit of@tie{}@code{f}, which multiplies its value by 65,536 (but
+clamps it at 65,535).
 
 @Example
-.ds TeX T\h'-.2m'\v'.2m'E\v'-.2m'\h'-.1m'X\" Knuth's TeX
+.defcolor gray50 rgb 0.5 0.5 0.5
+.defcolor darkgreen rgb 0.1f 0.5f 0.2f
 @endExample
+@endDefreq
 
-@cindex trailing quotes
-@cindex quotes, trailing
-@cindex leading spaces with @code{ds}
-@cindex spaces with @code{ds}
-@cindex @code{ds} request, and leading spaces
-To produce leading space the string can be started with a double quote.
-No trailing quote is needed; in fact, any trailing quote is included in
-your string.
+@cindex default color
+@cindex color, default
+Each output device has a color named @samp{default}, which cannot be
+redefined.  A device's default stroke and fill colors are not
+necessarily the same.  For the @code{dvi}, @code{html}, @code{pdf},
+@code{ps}, and @code{xhtml} output devices, GNU @code{troff}
+automatically loads a macro file defining many color names at startup.
+By the same mechanism, the devices supported by @code{grotty} recognize
+the eight standard ISO@tie{}6429/EMCA-48 color names.@footnote{also
+known vulgarly as ``ANSI colors''}
+
+@DefreqList {gcolor, @Var{color}}
+@DefescItemx {\\m, , c, }
+@DefescItem {\\m, (, co, }
+@DefescItem {\\m, , color, }
+@DefregListEndx {.m}
+Set the stroke color to @var{color}.
 
 @Example
-.ds sign "           Yours in a white wine sauce,
+.gcolor red
+The next words
+.gcolor
+\mredare in red\m
+and these words are in the previous color.
 @endExample
 
-@cindex multi-line strings
-@cindex strings, multi-line
-@cindex newline character, in strings, escaping
-@cindex escaping newline characters, in strings
-Strings are not limited to a single line of text.  A string can span
-several lines by escaping the newlines with a backslash.  The resulting
-string is stored @emph{without} the newlines.
+The escape sequence @code{\m} restores the previous stroke color, as
+does a @code{gcolor} request without an argument.
+
+@cindex stroke color name register (@code{.m})
+@cindex name, stroke color, register (@code{.m})
+@cindex color name, stroke, register (@code{.m})
+The name of the current stroke color is available in the read-only
+string-valued register @samp{.m}; it is associated with the environment
+(@pxref{Environments}).  It interpolates nothing when the stroke color
+is the default.
+
+@code{\m} doesn't produce an input token in GNU @code{troff}
+(@pxref{Gtroff Internals}).  It therefore can be used in requests like
+@code{mc} (which expects a single character as an argument) to change
+the color on the fly:
 
 @Example
-.ds foo lots and lots \
-of text are on these \
-next several lines
+.mc \mredx\m
 @endExample
+@endDefesc
 
-It is not possible to have real newlines in a string.  To put a single
-double quote character into a string, use two consecutive double quote
-characters.
+@DefreqList {fcolor, @Var{color}}
+@DefescItemx {\\M, , c, }
+@DefescItem {\\M, (, co, }
+@DefescItem {\\M, , color, }
+@DefregListEndx {.M}
+Set the fill color for objects drawn with @code{\D'@dots{}'} escape
+sequences.  The escape sequence @code{\M} restores the previous fill
+color, as does an @code{fcolor} request without an argument.
+
+@cindex background color name register (@code{.M})
+@cindex name, background color, register (@code{.M})
+@cindex color name, background, register (@code{.M})
+@cindex fill color name register (@code{.M})
+@cindex name, fill color, register (@code{.M})
+@cindex color name, fill, register (@code{.M})
+The name of the current fill color is available in the read-only
+string-valued register @samp{.M}; it is associated with the environment
+(@pxref{Environments}).  It interpolates nothing when the fill color
+is the default.  @code{\M} doesn't produce an input token in GNU
+@code{troff}.
 
-The @code{ds1} request turns off compatibility mode while interpreting a
-string.  To be more precise, a @dfn{compatibility save} input token is
-inserted at the beginning of the string, and a @dfn{compatibility
-restore} input token at the end.
+Create an ellipse with a red interior as follows.
 
 @Example
-.nr xxx 12345
-.ds aa The value of xxx is \\nxxx.
-.ds1 bb The value of xxx is \\nxxx.
-.
-.cp 1
-.
-\*(aa
-    @result{} warning: number register `' not defined
-    @result{} The value of xxx is 0xxx.
-\*(bb
-    @result{} The value of xxx is 12345.
+\Mred\h'0.5i'\D'E 2i 1i'\M
 @endExample
+@endDefesc
+@c END Keep (roughly) parallel with section "Colors" of groff(7).
 
-@cindex name space, common, of macros, diversions, and strings
-@cindex common name space of macros, diversions, and strings
-@cindex macros, shared name space with strings and diversions
-@cindex strings, shared name space with macros and diversions
-@cindex diversions, shared name space with macros and strings
-Strings, macros, and diversions (and boxes) share the same name space.
-Internally, even the same mechanism is used to store them.  This has
-some interesting consequences.  For example, it is possible to call a
-macro with string syntax and vice versa.
 
-@Example
-.de xxx
-a funny test.
-..
-This is \*xxx
-    @result{} This is a funny test.
+@c =====================================================================
 
-.ds yyy a funny test
-This is
-.yyy
-    @result{} This is a funny test.
-@endExample
+@c BEGIN Keep (roughly) parallel with section "Strings" of groff(7).
+@node Strings, Conditionals and Loops, Colors, GNU troff Reference
+@section Strings
+@cindex strings
 
-In particular, interpolating a string does not hide existing macro
-arguments.  Thus in a macro, a more efficient way of doing
+GNU @code{troff} supports strings primarily for user convenience.
+Conventionally, if one would define a macro only to interpolate a small
+amount of text, without invoking requests or calling any other macros,
+one defines a string instead.  Only one string is predefined by the
+language.
 
-@Example
-.xx \\$@@
-@endExample
+@Defstr {.T}
+@stindex .T
+@cindex output device name string (@code{.T})
+Contains the name of the output device (for example, @samp{utf8} or
+@samp{pdf}).
+@endDefmpstr
+
+The @code{ds} request creates a string with a specified name and
+contents and the @code{\*} escape sequence dereferences its name,
+interpolating its contents.  If the string named by the @code{\*} escape
+sequence does not exist, it is defined as empty, nothing is
+interpolated, and a warning in category @samp{mac} is emitted.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings.
 
-@noindent
-is
+@DefreqList {ds, name @Var{contents}}
+@DefreqItemx {ds1, name @Var{contents}}
+@DefescItemx {\\*, , n, }
+@DefescItem {\\*, (, nm, }
+@c XXX: Can't mark the parameters with @Var because @Var gets called
+@c recursively if we do.
+@c @DefescListEnd {\\*, , name @Var{arg1} @Var{arg2} @dots{}, }
+@DefescListEnd {\\*, , name @sansserif{}arg1 arg2 @dots{}@sansserif{}, }
+@cindex string interpolation (@code{\*})
+@cindex string expansion (@code{\*})
+@cindex interpolation of strings (@code{\*})
+@cindex expansion of strings (@code{\*})
+@cindex string arguments
+@cindex arguments, to strings
+Define a string called @var{name} with contents @var{contents}.  If
+@var{name} already exists as an alias, the target of the alias is
+redefined; see @code{als} and @code{rm} below.  If @code{ds} is called
+with only one argument, @var{name} is defined as an empty string.
+Otherwise, GNU @code{troff} stores @var{contents} in copy
+mode.@footnote{@xref{Copy Mode}.}
+
+The @code{\*} escape sequence interpolates a previously defined string
+variable @var{name} (one-character name@tie{}@var{n}, two-character name
+@var{nm}).  The bracketed interpolation form accepts arguments that are
+handled as macro arguments are; recall @ref{Calling Macros}.  In
+contrast to macro calls, however, if a closing bracket @samp{} occurs
+in a string argument, that argument must be enclosed in double quotes.
+@code{\*} is interpreted even in copy mode.  When defining strings,
+argument interpolations must be escaped if they are to reference
+parameters from the calling context; @xref{Parameters}.
+
+@Example
+.ds cite (\\$1, \\$2)
+Gray codes are explored in \*cite Morgan 1998.
+    @result{} Gray codes are explored in (Morgan, 1998).
+@endExample
+
+@c TODO: Consider examples of recursive string calls, particularly where
+@c one interpolation is constructed from the argument of an enclosing
+@c macro, to illustrate ".ds a \$1 \\$1".
+@c
+@c @Example
+@c .ds a \\$1 wildebeest
+@c .ds b big, \*a hairy
+@c I see a \*b.
+@c     @result{} I see a big, hairy wildebeest.
+@c @endExample
+
+@cindex trailing spaces in string definitions and appendments
+@cindex comments, with @code{ds}
+@cindex @code{ds} request, and comments
+@strong{Caution:@:} Unlike other requests, the second argument to the
+@code{ds} request consumes the remainder of the input line, including
+trailing spaces.  This means that comments on a line with such a request
+can introduce unwanted space into a string when they are set off from
+the material they annotate, as is conventional.
 
 @Example
-\\*xx\\
+.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \" water
 @endExample
 
 @noindent
-Note that the latter calling syntax doesn't change the value of
-@code{\$0}, which is then inherited from the calling macro.
-
-Diversions and boxes can be also called with string syntax.
-
-Another consequence is that you can copy one-line diversions or boxes to
-a string.
+Instead, place the comment on another line or put the comment escape
+sequence immediately adjacent to the last character of the string.
 
 @Example
-.di xxx
-a \fItest\fR
-.br
-.di
-.ds yyy This is \*xxx\c
-\*yyy.
-    @result{} @r{This is a }@i{test}.
+.ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\" water
 @endExample
 
-@noindent
-As the previous example shows, it is possible to store formatted output
-in strings.  The @code{\c} escape prevents the insertion of an
-additional blank line in the output.
-
-Copying diversions longer than a single output line produces unexpected
-results.
+Ending string definitions (and appendments) with a comment, even an
+empty one, prevents unwanted space from creeping into them during source
+document maintenance.
 
 @Example
-.di xxx
-a funny
-.br
-test
-.br
-.di
-.ds yyy This is \*xxx\c
-\*yyy.
-    @result{} test This is a funny.
+.ds author Alice Pleasance Liddell\"
+.ds empty \" might be appended to later with .as
 @endExample
 
-Usually, it is not predictable whether a diversion contains one or more
-output lines, so this mechanism should be avoided.  With Unix
-@code{troff}, this was the only solution to strip off a final newline
-from a diversion.  Another disadvantage is that the spaces in the copied
-string are already formatted, making them unstretchable.  This can cause
-ugly results.
+@cindex trailing double quotes in strings
+@cindex double quotes, trailing, in strings
+@cindex @code{ds} request, and double quotes
+@cindex leading spaces with @code{ds}
+@cindex spaces with @code{ds}
+@cindex @code{ds} request, and leading spaces
+An initial neutral double quote @code{"} in @var{contents} is stripped
+to allow embedding of leading spaces.  Any other @code{"} is interpreted
+literally, but it is wise to use the special character escape sequence
+@code{\dq} instead if the string might be interpolated as part of a
+macro argument; see @ref{Calling Macros}.
+
+@c Examples should be more accessible than Unix nerd stuff like this,
+@c but in general document authors shouldn't want to use "straight"
+@c double quotes for ordinary prose anyway.  Also, 56 chars is as fat
+@c as these examples can get and not overrun the right margin in PDF.
+@Example
+.ds salutation "         Yours in a white wine sauce,\"
+.ds c-var-defn "  char mydate=\dq2020-07-29\dq;\"
+@endExample
 
-@cindex stripping final newline in diversions
-@cindex diversion, stripping final newline
-@cindex final newline, stripping in diversions
-@cindex newline, final, stripping in diversions
-@cindex horizontal space, unformatting
-@cindex space, horizontal, unformatting
-@cindex unformatting horizontal space
-A clean solution to this problem is available in GNU @code{troff}, using
-the requests @code{chop} to remove the final newline of a diversion, and
-@code{unformat} to make the horizontal spaces stretchable again.
+@cindex multi-line strings
+@cindex strings, multi-line
+@cindex newline character, in strings, escaping
+@cindex escaping newline characters, in strings
+Strings are not limited to a single input line of text.
+@code{\@key{RET}} works just as it does elsewhere.  The resulting string
+is stored @emph{without} the newlines.  Care is therefore required when
+interpolating strings while filling is disabled.
+
+@Example
+.ds foo This string contains \
+text on multiple lines \
+of input.
+@endExample
+
+It is not possible to embed a newline in a string that will be
+interpreted as such when the string is interpolated.  To achieve that
+effect, use @code{\*} to interpolate a macro instead; see @ref{Punning
+Names}.
+
+Because strings are similar to macros, they too can be defined so as to
+suppress AT&T @code{troff} compatibility mode when used; see
+@ref{Writing Macros} and @ref{Compatibility Mode}.  The @code{ds1}
+request defines a string such that compatibility mode is off when the
+string is later interpolated.  To be more precise, a @dfn{compatibility
+save} input token is inserted at the beginning of the string, and a
+@dfn{compatibility restore} input token at the end.
 
 @Example
-.box xxx
-a funny
-.br
-test
-.br
-.box
-.chop xxx
-.unformat xxx
-This is \*xxx.
-    @result{} This is a funny test.
+.nr xxx 12345
+.ds aa The value of xxx is \\nxxx.
+.ds1 bb The value of xxx is \\nxxx.
+.
+.cp 1
+.
+\*(aa
+    @error{} warning: register '' not defined
+    @result{} The value of xxx is 0xxx.
+\*(bb
+    @result{} The value of xxx is 12345.
 @endExample
-
-@xref{Gtroff Internals}, for more information.
 @endDefreq
 
-@DefreqList {as, name @Var{string}}
-@DefreqListEndx {as1, name @Var{string}}
+@DefreqList {as, name @Var{contents}}
+@DefreqListEndx {as1, name @Var{contents}}
 @cindex appending to a string (@code{as})
 @cindex string, appending (@code{as})
-The @code{as} request is similar to @code{ds} but appends @var{string}
+The @code{as} request is similar to @code{ds} but appends @var{contents}
 to the string stored as @var{name} instead of redefining it.  If
-@var{name} doesn't exist yet, it is created.
+@var{name} doesn't exist yet, it is created.  If @code{as} is called
+with only one argument, no operation is performed (beyond dereferencing
+the string).
 
 @Example
-.as sign " with shallots, onions and garlic,
+.as salutation " with shallots, onions and garlic,\"
 @endExample
 
 The @code{as1} request is similar to @code{as}, but compatibility mode
-is switched off while the appended string is interpreted.  To be more
-precise, a @dfn{compatibility save} input token is inserted at the
-beginning of the appended string, and a @dfn{compatibility restore}
-input token at the end.
+is switched off when the appended portion of the string is later
+interpolated.  To be more precise, a @dfn{compatibility save} input
+token is inserted at the beginning of the appended string, and a
+@dfn{compatibility restore} input token at the end.
 @endDefreq
 
-Rudimentary string manipulation routines are given with the next two
-requests.
+Several requests exist to perform rudimentary string operations.
+Strings can be queried (@code{length}) and modified (@code{chop},
+@code{substring}, @code{stringup}, @code{stringdown}), and their names
+can be manipulated through renaming, removal, and aliasing (@code{rn},
+@code{rm}, @code{als}).
+
+@Defreq {length, reg anything}
+@cindex length of a string (@code{length})
+@cindex string, length of (@code{length})
+@cindex @code{length} request, and copy mode
+@cindex copy mode, and @code{length} request
+@cindex mode, copy, and @code{length} request
+Compute the number of characters of @var{anything} and store the count
+in the register @var{reg}.  If @var{reg} doesn't exist, it is created.
+@var{anything} is read in copy mode.
+
+@Example
+.ds xxx abcd\h'3i'efgh
+.length yyy \*xxx
+\nyyy
+    @result{} 14
+@endExample
+@endDefreq
 
-@Defreq {substring, str n1 @Var{n2}}
+@Defreq {chop, object}
+Remove the last character from the macro, string, or diversion named
+@var{object}.  This is useful for removing the newline from the end of a
+diversion that is to be interpolated as a string.  This request can be
+used repeatedly on the same @var{object}; see @ref{Gtroff Internals},
+for details on nodes inserted additionally by GNU @code{troff}.
+@endDefreq
+
+@Defreq {substring, str start @Var{end}}
 @cindex substring (@code{substring})
-Replace the string named @var{str} with the substring defined by the
-indices @var{n1} and @var{n2}.  The first character in the string has
-index@tie{}0.  If @var{n2} is omitted, it is implicitly set to the
-largest valid value (the string length minus one).  If the index value
-@var{n1} or @var{n2} is negative, it is counted from the end of the
-string, going backwards: The last character has index@tie{}@minus{}1,
-the character before the last character has index@tie{}@minus{}2, etc.
+Replace the string named @var{str} with its substring bounded by the
+indices @var{start} and @var{end}, inclusively.  The first character in
+the string has index@tie{}0.  If @var{end} is omitted, it is implicitly
+set to the largest valid value (the string length minus one).  Negative
+indices count backward from the end of the string:@: the last character
+has index@tie{}@minus{}1, the character before the last has
+index@tie{}@minus{}2, and so on.
 
 @Example
 .ds xxx abcdefgh
@@ -11017,25 +12424,35 @@
 @endExample
 @endDefreq
 
-@Defreq {length, reg str}
-@cindex length of a string (@code{length})
-@cindex string, length of (@code{length})
-@cindex @code{length} request, and copy-in mode
-@cindex copy-in mode, and @code{length} request
-@cindex mode, copy-in, and @code{length} request
-Compute the number of characters of @var{str} and return it in the
-number register @var{reg}.  If @var{reg} doesn't exist, it is created.
-@code{str} is read in copy mode.
-
-@Example
-.ds xxx abcd\h'3i'efgh
-.length yyy \*xxx
-\nyyy
-    @result{} 14
+@DefreqList {stringdown, str}
+@DefreqListEndx {stringup, str}
+@cindex case-transforming a string (@code{stringdown}, @code{stringup})
+@cindex uppercasing a string (@code{stringup})
+@cindex lowercasing a string (@code{stringdown})
+@cindex up-casing a string (@code{stringup})
+@cindex down-casing a string (@code{stringdown})
+Alter the string named @var{str} by replacing each of its bytes with its
+lowercase (@code{stringdown}) or uppercase (@code{stringup}) version (if
+one exists).  Special characters in the string will often transform in
+the expected way due to the regular naming convention for accented
+characters.  When they do not, use substrings and/or catenation.
+
+@Example
+.ds resume R\'esum\'e
+\*resume
+.stringdown resume
+\*resume
+.stringup resume
+\*resume
+    @result{} Résumé résumé RÉSUMÉ
 @endExample
 @endDefreq
 
-@Defreq {rn, xx yy}
+(In practice, we would end the @code{ds} request with a comment escape
+@code{\"} to prevent space from creeping into the definition during
+source document maintenance.)
+
+@Defreq {rn, old new}
 @cindex renaming request (@code{rn})
 @cindex request, renaming (@code{rn})
 @cindex renaming macro (@code{rn})
@@ -11044,10 +12461,10 @@
 @cindex string, renaming (@code{rn})
 @cindex renaming diversion (@code{rn})
 @cindex diversion, renaming (@code{rn})
-Rename the request, macro, diversion, or string @var{xx} to @var{yy}.
+Rename the request, macro, diversion, or string @var{old} to @var{new}.
 @endDefreq
 
-@Defreq {rm, xx}
+@Defreq {rm, name}
 @cindex removing request (@code{rm})
 @cindex request, removing (@code{rm})
 @cindex removing macro (@code{rm})
@@ -11056,8 +12473,9 @@
 @cindex string, removing (@code{rm})
 @cindex removing diversion (@code{rm})
 @cindex diversion, removing (@code{rm})
-Remove the request, macro, diversion, or string @var{xx}.  @code{gtroff}
-treats subsequent invocations as if the object had never been defined.
+Remove the request, macro, diversion, or string @var{name}.  GNU
+@code{troff} treats subsequent invocations as if the name had never
+been defined.
 @endDefreq
 
 @anchor{als}
@@ -11068,22 +12486,21 @@
 @cindex creating alias, for string (@code{als})
 @cindex creating alias, for macro (@code{als})
 @cindex creating alias, for diversion (@code{als})
-@cindex string, creating alias (@code{als})
-@cindex macro, creating alias (@code{als})
-@cindex diversion, creating alias (@code{als})
-Create an alias named @var{new} for the request, string, macro, or
-diversion object named @var{old}.  The new name and the old name are
-exactly equivalent (it is similar to a hard rather than a soft link).  If
-@var{old} is undefined, @code{gtroff} generates a warning of type
-@samp{mac} and ignores the request.
-
-To understand how the @code{als} request works it is probably best to
-think of two different pools: one pool for objects (macros, strings,
-etc.), and another one for names.  As soon as an object is defined,
-@code{gtroff} adds it to the object pool, adds its name to the name
-pool, and creates a link between them.  When @code{als} creates an
-alias, it adds a new name to the name pool that gets linked to the same
-object as the old name.
+@cindex string, creating alias for (@code{als})
+@cindex macro, creating alias for (@code{als})
+@cindex diversion, creating alias for (@code{als})
+Create an alias @var{new} for the existing request, string, macro, or
+diversion object named @var{old}, causing the names to refer to the same
+stored object.  If @var{old} is undefined, a warning in category
+@samp{mac} is produced, and the request is ignored.  @xref{Warnings},
+for information about the enablement and suppression of warnings.
+
+To understand how the @code{als} request works, consider two different
+storage pools:@: one for objects (macros, strings, etc.), and another
+for names.  As soon as an object is defined, GNU @code{troff} adds it to
+the object pool, adds its name to the name pool, and creates a link
+between them.  When @code{als} creates an alias, it adds a new name to
+the name pool that gets linked to the same object as the old name.
 
 Now consider this example.
 
@@ -11098,15 +12515,17 @@
 ..
 .
 .bar
-    @result{} input stack limit exceeded
+    @error{} input stack limit exceeded (probable infinite
+    @error{} loop)
 @endExample
 
 @noindent
-The definition of macro @code{bar} replaces the old object this name is
-linked to.  However, the alias to @code{foo} is still active!  In
-other words, @code{foo} is still linked to the same object as
-@code{bar}, and the result of calling @code{bar} is an infinite,
-recursive loop that finally leads to an error.
+In the above, @code{bar} remains an @emph{alias}---another name
+for---the object referred to by @code{foo}, which the second @code{de}
+request replaces.  Alternatively, imagine that the @code{de} request
+@emph{dereferences} its argument before replacing it.  Either way, the
+result of calling @code{bar} is a recursive loop that finally leads to
+an error.  @xref{Writing Macros}.
 
 @cindex alias, string, removing (@code{rm})
 @cindex alias, macro, removing (@code{rm})
@@ -11114,184 +12533,264 @@
 @cindex removing alias, for string (@code{rm})
 @cindex removing alias, for macro (@code{rm})
 @cindex removing alias, for diversion (@code{rm})
-@cindex string, removing alias (@code{rm})
-@cindex macro, removing alias (@code{rm})
-@cindex diversion, removing alias (@code{rm})
-To undo an alias, simply call @code{rm} on the aliased name.  The object
-itself is not destroyed until there are no more aliases.
-@endDefreq
+@cindex string, removing alias for (@code{rm})
+@cindex macro, removing alias for (@code{rm})
+@cindex diversion, removing alias for (@code{rm})
+To remove an alias, call @code{rm} on its name.  The object itself is
+not destroyed until it has no more names.
 
-@Defreq {chop, xx}
-Remove (chop) the last character from the macro, string, or diversion
-named @var{xx}.  This is useful for removing the newline from the end of
-diversions that are to be interpolated as strings.  This command can be
-used repeatedly; see @ref{Gtroff Internals}, for details on nodes
-inserted additionally by @code{gtroff}.
+When a request, macro, string, or diversion is aliased, redefinitions
+and appendments ``write through'' alias names.  To replace an alias with
+a separately defined object, you must use the @code{rm} request on its
+name first.
 @endDefreq
-
-@xref{Identifiers}, and @ref{Comments}.
+@c END Keep (roughly) parallel with section "Strings" of groff(7).
 
 
 @c =====================================================================
 
-@node Conditionals and Loops, Writing Macros, Strings, gtroff Reference
+@node Conditionals and Loops, Writing Macros, Strings, GNU troff Reference
 @section Conditionals and Loops
 @cindex conditionals and loops
 @cindex loops and conditionals
 
+@code{groff} has @code{if} and @code{while} control structures like
+other languages.  However, the syntax for grouping multiple input lines
+in the branches or bodies of these structures is unusual.
+
 @menu
 * Operators in Conditionals::
+* if-then::
 * if-else::
+* Conditional Blocks::
 * while::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Operators in Conditionals, if-else, Conditionals and Loops, Conditionals and Loops
+@c BEGIN Keep (roughly) parallel with subsection "Conditional
+@c expressions" of groff(7).
+@node Operators in Conditionals, if-then, Conditionals and Loops, Conditionals and Loops
 @subsection Operators in Conditionals
 
 @cindex @code{if} request, operators to use with
 @cindex @code{ie} request, operators to use with
 @cindex @code{while} request, operators to use with
-In @code{if}, @code{ie}, and @code{while} requests, in addition to ordinary
-@ref{Expressions}, there are several more operators available:
+@cindex conditional expressions
+@cindex expressions, conditional
+In @code{if}, @code{ie}, and @code{while} requests, in addition to the
+numeric expressions described in @ref{Numeric Expressions}, several
+Boolean operators are available; the members of this expanded class are
+termed @dfn{conditional expressions}.
 
 @table @code
+@item c @var{glyph}
+True if @var{glyph} is available, where @var{glyph} is an ordinary
+character, a special character @samp{\(@var{xx}} or @samp{\@var{xxx}},
+@samp{\N'@var{xxx}'}, or has been defined by any of the @code{char},
+@code{fchar}, @code{fschar}, or @code{schar} requests.
+
+@item d @var{name}
+True if a string, macro, diversion, or request called @var{name} exists.
+
 @item e
-@itemx o
-True if the current page is even or odd numbered (respectively).
+True if the current page is even-numbered.
+
+@item F @var{font}
+True if @var{font} exists.  @var{font} is handled as if it were opened
+with the @code{ft} request (that is, font translation and styles are
+applied), without actually mounting it.
+
+@item m @var{color}
+True if @var{color} is defined.
 
 @item n
 @cindex conditional output for terminal (TTY)
 @cindex TTY, conditional output for
 @cindex terminal, conditional output for
-True if the document is being processed in nroff mode (i.e., the
-@code{.nroff} command has been issued).  @xref{Troff and Nroff Mode}.
+True if the document is being processed in @code{nroff} mode.
+@xref{@code{troff} and @code{nroff} Modes}.
+
+@item o
+True if the current page is odd-numbered.
+
+@item r @var{register}
+True if @var{register} exists.
+
+@item S @var{style}
+True if @var{style} is available for the current font family.  Font
+translation is applied.
 
 @item t
-True if the document is being processed in troff mode (i.e., the
-@code{.troff} command has been issued).  @xref{Troff and Nroff Mode}.
+True if the document is being processed in @code{troff} mode.
+@xref{@code{troff} and @code{nroff} Modes}.
 
+@pindex vtroff
 @item v
-Always false.  This condition is for compatibility with other
-@code{troff} versions only (identifying a @code{-Tversatec} device).
+Always false.  This condition is recognized only for compatibility with
+certain other @code{troff} implementations.@footnote{This refers to
+@code{vtroff}, a translator that would convert the C/A/T output from
+early-vintage @acronym{AT&T} @code{troff} to a form suitable for
+Versatec and Benson-Varian plotters.}
+@end table
 
-@item '@var{xxx}'@var{yyy}'
-True if the output produced by @var{xxx} is equal to the output produced
-by @var{yyy}.  Other characters can be used in place of the single
-quotes; the same set of delimiters as for the @code{\D} escape is used
-(@pxref{Escapes}).  @code{gtroff} formats @var{xxx} and @var{yyy} in
-separate environments; after the comparison the resulting data is
-discarded.
-
-@Example
-.ie "|"\fR|\fP" \
-true
-.el \
-false
+If the first argument to an @code{if}, @code{ie}, or @code{while}
+request begins with a non-alphanumeric character apart from @code{!}
+(see below); it performs an @slanted{output comparison test}.
+@footnote{Strictly, letters not otherwise recognized @emph{are} treated
+as output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan@tie{}9
+@code{troff} uses @samp{h} to test a mode it calls @code{htmlroff}, and
+GNU @code{troff} may provide additional operators in the future.}
+
+@cindex output comparison operator
+@table @code
+@item @code{'}@var{xxx}@code{'}@var{yyy}@code{'}
+True if formatting the comparands @var{xxx} and @var{yyy} produces the
+same output commands.  The delimiter need not be a neutral apostrophe:
+the output comparison operator accepts the same delimiters as most
+escape sequences; see @ref{Delimiters}.  This @dfn{output comparison
+operator} formats @var{xxx} and @var{yyy} in separate environments;
+after the comparison, the resulting data are discarded.
+
+@Example
+.ie "|"\fR|\fP" true
+.el false
     @result{} true
 @endExample
 
 @noindent
-The resulting motions, glyph sizes, and fonts have to
-match,@footnote{The created output nodes must be identical.
-@xref{Gtroff Internals}.} and not the individual motion, size, and font
-requests.  In the previous example, @samp{|} and @samp{\fR|\fP} both
-result in a roman @samp{|} glyph with the same point size and at the
-same location on the page, so the strings are equal.  If
-@samp{.ft@tie{}I} had been added before the @samp{.ie}, the result would
-be ``false'' because (the first) @samp{|} produces an italic @samp{|}
-rather than a roman one.
+The resulting glyph properties, including font family, style, size, and
+slant, must match, but not necessarily the requests and/or escape
+sequences used to obtain them.  In the previous example, @samp{|} and
+@samp{\fR|\fP} result in @samp{|} glyphs in the same typefaces at the
+same positions, so the comparands are equal.  If @samp{.ft@tie{}I} had
+been added before the @samp{.ie}, they would differ: the first @samp{|}
+would produce an italic @samp{|}, not a roman one.  Motions must match
+in orientation and magnitude to within the applicable horizontal and
+vertical motion quanta of the device, after rounding.  @samp{.if
+"\u\d"\v'0'"} is false even though both comparands result in zero net
+motion, because motions are not interpreted or optimized but sent as-is
+to the output.@footnote{Because formatting of the comparands takes place
+in a dummy environment, vertical motions within them cannot spring
+traps.}  On the other hand, @samp{.if "\d"\v'0.5m'"} is true, because
+@code{\d} is defined as a downward motion of one-half em.@footnote{All
+of this is to say that the lists of output nodes created by formatting
+@var{xxx} and @var{yyy} must be identical.  @xref{Gtroff Internals}.}
 
 @cindex string comparison
 @cindex comparison of strings
-To compare strings without processing, surround the data with @code{\?}.
+Surround the comparands with @code{\?} to avoid formatting them; this
+causes them to be compared character by character, as with string
+comparisons in other programming languages.
 
 @Example
-.ie "\?|\?"\?\fR|\fP\?" \
-true
-.el \
-false
+.ie "\?|\?"\?\fR|\fP\?" true
+.el false
     @result{} false
 @endExample
 
-@cindex @code{\?}, and copy-in mode
-@cindex copy-in mode, and @code{\?}
-@cindex mode, copy-in, and @code{\?}
-@noindent
-Since data protected with @code{\?} is read in copy-in mode it is even
-possible to use incomplete input without causing an error.
+@cindex @code{\?}, and copy mode
+@cindex copy mode, and @code{\?}
+@cindex mode, copy, and @code{\?}
+@noindent
+Since comparands protected with @code{\?} are read in copy mode
+(@pxref{Copy Mode}), they need not even be valid @code{groff} syntax.
+The escape character is still lexically recognized, however, and
+consumes the next character.
 
 @Example
 .ds a \
 .ds b \
-.ie '\?\*a\?'\?\*b\?' \
-true
-.el \
-false
-    @result{} true
+.if '\?\*a\?'\?\*b\?' a and b equivalent
+.if '\?\\?'\?\\?' backslashes equivalent
+    @result{} a and b equivalent
+@c slack lines for pagination control
+@c    @error{} warning: missing closing delimiter in
+@c    @error{} conditional expression (got newline)
 @endExample
+@end table
 
-@item r @var{xxx}
-True if there is a number register named @var{xxx}.
-
-@item d @var{xxx}
-True if there is a string, macro, diversion, or request named @var{xxx}.
-
-@item m @var{xxx}
-True if there is a color named @var{xxx}.
+The above operators can't be combined with most others, but a leading
+@samp{!}, not followed immediately by spaces or tabs, complements an
+expression.
 
-@item c @var{g}
-True if there is a glyph @var{g} available@footnote{The name of this
-conditional operator is a misnomer since it tests names of output
-glyphs.}; @var{g} is either an @acronym{ASCII} character or a special
-character (@code{\N'@var{xxx}'}, @code{\(@var{gg}} or
-@code{\@var{ggg}}); the condition is also true if @var{g} has been
-defined by the @code{char} request.
+@Example
+.nr x 1
+.ie !r x register x is not defined
+.el      register x is defined
+    @result{} register x is defined
+@endExample
 
-@item F @var{font}
-True if a font named @var{font} exists.  @var{font} is handled as if it
-was opened with the @code{ft} request (that is, font translation and
-styles are applied), without actually mounting it.
+Spaces and tabs are optional immediately after the @samp{c}, @samp{d},
+@samp{F}, @samp{m}, @samp{r}, and @samp{S} operators, but right after
+@samp{!}, they end the predicate and the conditional evaluates
+true.@footnote{This bizarre behavior maintains compatibility with
+@acronym{AT&T} @code{troff}.}
 
-This test doesn't load the complete font but only its header to verify
-its validity.
+@Example
+.nr x 1
+.ie ! r x register x is not defined
+.el       register x is defined
+    @result{} r x register x is not defined
+@endExample
 
-@item S @var{style}
-True if style @var{style} has been registered.  Font translation is
-applied.
-@end table
+@noindent
+The unexpected @samp{r x} in the output is a clue that our conditional
+was not interpreted as we planned, but matters may not always be so
+obvious.
+@c END Keep (roughly) parallel with subsection "Conditional expressions"
+@c of groff(7).
 
-Note that these operators can't be combined with other operators like
-@samp{:} or @samp{&}; only a leading @samp{!} (without whitespace
-between the exclamation mark and the operator) can be used to negate the
-result.
+@c ---------------------------------------------------------------------
 
-@Example
-.nr xxx 1
-.ie !r xxx \
-true
-.el \
-false
-    @result{} false
+@node if-then, if-else, Operators in Conditionals, Conditionals and Loops
+@subsection if-then
+@cindex if-then
+
+@Defreq {if, cond-expr anything}
+Evaluate the conditional expression @var{cond-expr}, and if it evaluates
+true (or to a positive value), interpret the remainder of the line
+@var{anything} as if it were an input line.  Recall from @ref{Invoking
+Requests} that any quantity of spaces between arguments to requests
+serves only to separate them; leading spaces in @var{anything} are thus
+not seen.  @var{anything} effectively @emph{cannot} be omitted; if
+@var{cond-expr} is true and @var{anything} is empty, the newline at the
+end of the control line is interpreted as a blank input line (and
+therefore a blank text line).
+
+@Example
+super\c
+tanker
+.nr force-word-break 1
+super\c
+.if ((\nforce-word-break = 1) & \n.int)
+tanker
+    @result{} supertanker super tanker
 @endExample
+@endDefreq
 
-A whitespace after @samp{!} always evaluates to zero (this bizarre
-behaviour is due to compatibility with Unix @code{troff}).
+@Defreq {nop, anything}
+Interpret @var{anything} as if it were an input line.  This is similar
+to @samp{.if@tie{}1}.  @code{nop} is not really ``no operation''; its
+argument @emph{is} processed---unconditionally.  It can be used to cause
+text lines to share indentation with surrounding control lines.
 
 @Example
-.nr xxx 1
-.ie ! r xxx \
-true
-.el \
-false
-    @result{} r xxx true
+.als real-MAC MAC
+.de wrapped-MAC
+.  tm MAC: called with arguments \\$@@
+.  nop \\*real-MAC\\
+..
+.als MAC wrapped-MAC
+\# Later...
+.als MAC real-MAC
 @endExample
 
-It is possible to omit the whitespace before the argument to the
-@samp{r}, @samp{d}, and @samp{c} operators.
-
-@xref{Expressions}.
+In the above, we've used aliasing, @code{nop}, and the interpolation of
+a macro as a string to interpose a wrapper around the macro @samp{MAC}
+(perhaps to debug it).
+@endDefreq
 
 @c ---------------------------------------------------------------------
 
@@ -11299,75 +12798,155 @@
 @subsection if-else
 @cindex if-else
 
-@code{gtroff} has if-then-else constructs like other languages, although
-the formatting can be painful.
+@DefreqList {ie, cond-expr anything}
+@DefreqListEndx {el, anything}
+Use the @code{ie} and @code{el} requests to write an if-then-else.  The
+first request is the ``if'' part and the latter is the ``else'' part.
+Unusually among programming languages, any number of non-conditional
+requests may be interposed between the @code{ie} branch and the
+@code{el} branch.
 
-@Defreq {if, expr anything}
+@Example
+.nr a 0
+.ie \na a is non-zero.
+.nr a +1
+.el a was not positive but is now \na.
+    @result{} a was not positive but is now 1.
+@endExample
 
-Evaluate the expression @var{expr}, and executes @var{anything} (the
-remainder of the line) if @var{expr} evaluates to a value greater than
-zero (true).  @var{anything} is interpreted as though it was on a line
-by itself (except that leading spaces are swallowed).
-@xref{Operators in Conditionals}, for more info.
+Another way in which @code{el} is an ordinary request is that it does
+not lexically ``bind'' more tightly to its @code{ie} counterpart than it
+does to any other request.  This fact can surprise C programmers.
 
 @Example
-.nr xxx 1
-.nr yyy 2
-.if ((\nxxx == 1) & (\nyyy == 2)) true
-    @result{} true
+.nr a 1
+.nr z 0
+.ie \nz \
+.  ie \na a is true
+.  el     a is false
+.el z is false
+    @error{} warning: unbalanced 'el' request
+    @result{} a is false
 @endExample
-@endDefreq
 
-@Defreq {nop, anything}
-Executes @var{anything}.  This is similar to @code{.if@tie{}1}.
+@c Turn the following into a proper @{x,}ref if the conditional blocks
+@c node is relocated elsewhere--but consider if it is wise to do so.
+To conveniently nest conditionals, keep reading.
+
 @endDefreq
 
-@DefreqList {ie, expr anything}
-@DefreqListEndx {el, anything}
-Use the @code{ie} and @code{el} requests to write an if-then-else.  The
-first request is the `if' part and the latter is the `else' part.
+@c ---------------------------------------------------------------------
 
-@Example
-.ie n .ls 2 \" double-spacing in nroff
-.el   .ls 1 \" single-spacing in troff
-@endExample
-@endDefreq
+@node Conditional Blocks, while, Operators in Conditionals, Conditionals and Loops
+@subsection Conditional Blocks
+@cindex conditional blocks
+@cindex blocks, conditional
 
-@c there is a bug in makeinfo <= 4.1a: you can't have `@{' as an argument
-@c to @deffn
-@c
-@c and in 4.2 you still can't use @{ in macros.
+It is frequently desirable for a control structure to govern more than
+one request, macro call, text line, or a combination of the foregoing.
+The opening and closing brace escape sequences @code{\@{} and @code{\@}}
+define such groups.  These @dfn{conditional blocks} can furthermore be
+nested.
 
-@c @DefescList {\@{, , , }
-@c @DefescListEnd {\@}, , , }
-@deffn Escape @t{\@{}
-@deffnx Escape @t{\@}}
+@DefescList {\@\{, , , }
+@DefescListEnd {\@\}, , , }
 @esindex \@{
 @esindex \@}
-@cindex begin of conditional block (@code{\@{})
+@cindex beginning of conditional block (@code{\@{})
 @cindex end of conditional block (@code{\@}})
-@cindex conditional block, begin (@code{\@{})
+@cindex conditional block, beginning (@code{\@{})
 @cindex conditional block, end (@code{\@}})
-@cindex block, conditional, begin (@code{\@{})
+@cindex block, conditional, beginning (@code{\@{})
 @cindex block, conditional, end (@code{\@}})
-In many cases, an if (or if-else) construct needs to execute more than
-one request.  This can be done using the escapes @code{\@{} (which must
-start the first line) and @code{\@}} (which must end the last line).
+@cindex brace escape sequences (@code{\@{}, @code{\@}})
+@cindex escape sequences, brace (@code{\@{}, @code{\@}})
+@cindex opening brace escape sequence (@code{\@}})
+@cindex closing brace escape sequence (@code{\@})}
+@cindex brace escape sequence, opening (@code{\@})}
+@cindex brace escape sequence, closing (@code{\@})}
+@code{\@{} begins a conditional block; it must appear (after optional
+spaces and tabs) immediately subsequent to the conditional expression of
+an @code{if}, @code{ie}, or @code{while}
+request,@footnote{@xref{while}.} or as the argument to an @code{el}
+request.
+
+@code{\@}} ends a condition block and should appear on a line with other
+occurrences of itself as necessary to match @code{\@{} sequences.  It
+can be preceded by a control character, spaces, and tabs.  Input after
+any quantity of @code{\@}} sequences on the same line is processed only
+if all of the preceding conditions to which they correspond are true.
+Furthermore, a @code{\@}} closing the body of a @code{while} request
+must be the last such escape sequence on an input line.
+
+Brace escape sequences outside of control structures have no meaning and
+produce no output.
+
+@strong{Caution:@:} Input lines using @code{\@{} often end with
+@code{\RET}, especially in macros that consist primarily of control
+lines.  Forgetting to use @code{\RET} on an input line after @code{\@{}
+is a common source of error.
+@endDefesc
+
+@need 1000
+We might write the following in a page header macro.  If we delete
+@code{\RET}, the header will carry an unwanted extra empty line (except
+on page@tie{}1).
 
 @Example
-.ie t \@{\
-.    ds lq ``
-.    ds rq ''
-.\@}
-.el \@{\
-.    ds lq ""
-.    ds rq ""
+.if (\\n% != 1) \@{\
+.  ie ((\\n% % 2) = 0) .tl \\*even-numbered-page-title
+.  el                    .tl \\*odd-numbered-page-title
 .\@}
 @endExample
-@c @endDefesc
-@end deffn
 
-@xref{Expressions}.
+Let us take a closer look at how conditional blocks nest.
+
+@Example
+A
+.if 0 \@{ B
+C
+D
+\@}E
+F
+    @result{} A F
+@endExample
+
+@Example
+N
+.if 1 \@{ O
+.  if 0 \@{ P
+Q
+R\@} S\@} T
+U
+    @result{} N O U
+@endExample
+
+The above behavior may challenge the intuition; it was implemented to
+retain compatibility with @acronym{AT&T} @code{troff}.  For clarity, it
+is idiomatic to end input lines with @code{\@{} (followed by
+@code{\@key{RET}} if appropriate), and to precede @code{\@}} on an input
+line with nothing more than a control character, spaces, tabs, and other
+instances of itself.
+
+We can use @code{ie}, @code{el}, and conditional blocks to simulate the
+multi-way ``switch'' or ``case'' control structures of other languages.
+The following example is adapted from the @code{groff} @file{man}
+package.  Indentation is used to clarify the logic.
+
+@Example
+.\" Simulate switch/case in roff.
+.      ie '\\$2'1' .ds title General Commands\"
+.el \@{.ie '\\$2'2' .ds title System Calls\"
+.el \@{.ie '\\$2'3' .ds title Library Functions\"
+.el \@{.ie '\\$2'4' .ds title Kernel Interfaces\"
+.el \@{.ie '\\$2'5' .ds title File Formats\"
+.el \@{.ie '\\$2'6' .ds title Games\"
+.el \@{.ie '\\$2'7' .ds title Miscellaneous Information\"
+.el \@{.ie '\\$2'8' .ds title System Management\"
+.el \@{.ie '\\$2'9' .ds title Kernel Development\"
+.el                .ds title \" empty
+.\@}\@}\@}\@}\@}\@}\@}\@}
+@endExample
 
 @c ---------------------------------------------------------------------
 
@@ -11375,13 +12954,15 @@
 @subsection while
 @cindex while
 
-@code{gtroff} provides a looping construct using the @code{while}
-request, which is used much like the @code{if} (and related) requests.
+@code{groff} provides a looping construct:@: the @code{while} request.
+Its syntax matches the @code{if} request.
 
-@Defreq {while, expr anything}
-Evaluate the expression @var{expr}, and repeatedly execute
-@var{anything} (the remainder of the line) until @var{expr} evaluates
-to@tie{}0.
+@cindex body, of a while request
+@Defreq {while, cond-expr anything}
+Evaluate the conditional expression @var{cond-expr}, and repeatedly
+execute @var{anything} unless and until @var{cond-expr} evaluates false.
+@var{anything}, which is often a conditional block, is referred to as
+the @code{while} request's @dfn{body}.
 
 @Example
 .nr a 0 1
@@ -11392,17 +12973,14 @@
     @result{} 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
 @endExample
 
-Some remarks.
-
 @cindex @code{de} request, and @code{while}
-@itemize @bullet
-@item
-The body of a @code{while} request is treated like the body of a
-@code{de} request: @code{gtroff} temporarily stores it in a macro that
-is deleted after the loop has been exited.  It can considerably slow
-down a macro if the body of the @code{while} request (within the macro)
-is large.  Each time the macro is executed, the @code{while} body is
-parsed and stored again as a temporary macro.
+GNU @code{troff} treats the body of a @code{while} request similarly to
+that of a @code{de} request (albeit one not read in copy
+mode@footnote{@xref{Copy Mode}.}), but stores it under an internal name
+and deletes it when the loop finishes.  The operation of a macro
+containing a @code{while} request can slow significantly if the
+@code{while} body is large.  Each time the macro is executed, the
+@code{while} body is parsed and stored again.
 
 @Example
 .de xxx
@@ -11417,9 +12995,10 @@
 @cindex recursive macros
 @cindex macros, recursive
 @noindent
-The traditional and often better solution (Unix @code{troff} doesn't
-have the @code{while} request) is to use a recursive macro instead that
-is parsed only once during its definition.
+An often better solution---and one that is more portable, since
+@acronym{AT&T} @code{troff} lacked the @code{while} request---is to
+instead write a recursive macro.  It will be parsed only
+once.@footnote{unless you redefine it}
 
 @Example
 .de yyy
@@ -11437,11 +13016,14 @@
 @endExample
 
 @noindent
-Note that the number of available recursion levels is set to@tie{}1000
-(this is a compile-time constant value of @code{gtroff}).
+To prevent infinite loops, the default number of available recursion
+levels is 1,000 or somewhat less.@footnote{``somewhat less'' because
+things other than macro calls can be on the input stack}  You can
+disable this protective measure, or raise the limit, by setting the
+@code{slimit} register.  @xref{Debugging}.
 
-@item
-The closing brace of a @code{while} body must end a line.
+As noted above, if a @code{while} body begins with a conditional block,
+its closing brace must end an input line.
 
 @Example
 .if 1 \@{\
@@ -11449,72 +13031,73 @@
 .  while (\na < 10) \@{\
 .    nop \n+a
 .\@}\@}
-    @result{} unbalanced \@{ \@}
+    @error{} unbalanced brace escape sequences
 @endExample
-@end itemize
 @endDefreq
 
 @Defreq {break, }
 @cindex @code{while} request, confusing with @code{br}
 @cindex @code{break} request, in a @code{while} loop
 @cindex @code{continue} request, in a @code{while} loop
-Break out of a @code{while} loop.  Be sure not to confuse this with the
-@code{br} request (causing a line break).
+Exit a @code{while} loop.  Do not confuse this request with a
+typographical break or the @code{br} request.
 @endDefreq
 
 @Defreq {continue, }
-Finish the current iteration of a @code{while} loop, immediately
-restarting the next iteration.
+Skip the remainder of a @code{while} loop's body, immediately starting
+the next iteration.
 @endDefreq
 
-@xref{Expressions}.
-
 
 @c =====================================================================
 
-@node Writing Macros, Page Motions, Conditionals and Loops, gtroff Reference
+@node Writing Macros, Page Motions, Conditionals and Loops, GNU troff Reference
 @section Writing Macros
 @cindex writing macros
 @cindex macros, writing
 
-A @dfn{macro} is a collection of text and embedded commands that can be
-invoked multiple times.  Use macros to define common operations.
-@xref{Strings}, for a (limited) alternative syntax to call macros.
-
-Although the following requests can be used to create macros,
-simply using an undefined macro will cause it to be defined as empty.
-@xref{Identifiers}.
-
-@DefreqList {de, name @Var{end}}
-@DefreqItemx {de1, name @Var{end}}
-@DefreqItemx {dei, name @Var{end}}
-@DefreqListEndx {dei1, name @Var{end}}
-Define a new macro named @var{name}.  @code{gtroff} copies subsequent
-lines (starting with the next one) into an internal buffer until it
-encounters the line @samp{..} (two dots).  If the optional second
-argument to @code{de} is present it is used as the macro closure
-request instead of @samp{..}.
-
-There can be whitespace after the first dot in the line containing the
-ending token (either @samp{.} or macro @samp{@var{end}}).  Don't insert
-a tab character immediately after the @samp{..}, otherwise it isn't
-recognized as the end-of-macro symbol.@footnote{While it is possible to
-define and call a macro @samp{.} with
-
-@Example
-.de .
-.  tm foo
-..
-.
-..    \" This calls macro `.'!
-@endExample
-
-@noindent
-you can't use this as the end-of-macro macro: during a macro definition,
-@samp{..} is never handled as a call to @samp{.}, even if you say
-@samp{.de foo .} explicitly.}
+A @dfn{macro} is a stored collection of text and control lines that can
+be interpolated multiple times.  Use macros to define common operations.
+Macros are called in the same way that requests are invoked.  While
+requests exist for the purpose of creating macros, simply calling an
+undefined macro, or interpolating it as a string, will cause it to be
+defined as empty.  @xref{Identifiers}.
+
+@Defreq {de, name @Var{end}}
+Define a macro @var{name}, replacing the definition of any existing
+request, macro, string, or diversion called @var{name}.  If
+@var{name} already exists as an alias, the target of the alias is
+redefined; recall @ref{Strings}.  GNU @code{troff} enters copy
+mode,@footnote{@xref{Copy Mode}.} storing subsequent input lines as the
+macro definition.  If the optional second argument is not specified, the
+definition ends with the control line @samp{..} (two dots).
+Alternatively, @var{end} identifies a macro whose call syntax at the
+start of a control line ends the definition of @var{name}; @var{end} is
+then called normally.  A macro definition must end in the same
+conditional block (if any) in which it began (@pxref{Conditional
+Blocks}).  Spaces or tabs are permitted after the control character in
+the line containing this ending token (either @samp{.} or
+@samp{@var{end}}), but a tab immediately after the token prevents its
+recognition as the end of a macro definition.  The macro @var{end} can
+be called with arguments.@footnote{While it is possible to define and
+call a macro @samp{.}, you can't use it as an end macro: during a macro
+definition, @samp{..} is never handled as calling @samp{.}, even if
+@samp{.de @var{name} .} explicitly precedes it.}
+@c
+@c @Example
+@c .de .
+@c (dot macro)
+@c ..
+@c .
+@c ..    \" This calls macro '.'!
+@c .de m1 .
+@c (m1 macro)
+@c ..    \" This does not.
+@c .m1
+@c     @result{} (dot macro) (m1 macro)
+@c @endExample
 
-Here a small example macro called @samp{P} that causes a break and
+Here is a small example macro called @samp{P} that causes a break and
 inserts some vertical space.  It could be used to separate paragraphs.
 
 @Example
@@ -11524,59 +13107,90 @@
 ..
 @endExample
 
-The following example defines a macro within another.  Remember that
-expansion must be protected twice; once for reading the macro and once
-for executing.
-
-@Example
-\# a dummy macro to avoid a warning
-.de end
+We can define one macro within another.  Attempting to nest @samp{..}
+naïvely will end the outer definition because the inner definition
+isn't interpreted as such until the outer macro is later interpolated.
+We can use an end macro instead.  Each level of nesting should use a
+unique end macro.
+
+An end macro need not be defined until it is called.  This fact enables
+a nested macro definition to begin inside one macro and end inside
+another.  Consider the following example.@footnote{Its structure is
+adapted from, and isomorphic to, part of a solution by Tadziu Hoffman to
+the problem of reflowing text multiple times to find an optimal
+configuration for it.
+@uref{https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html}}
+
+@Example
+.de m1
+.  de m2 m3
+you
 ..
-.
-.de foo
-.  de bar end
-.    nop \fBHello \\\\$1!\f
-.  end
+.de m3
+Hello,
+Joe.
 ..
-.
-.foo
-.bar Joe
-    @result{} @b{Hello Joe!}
+.de m4
+do
+..
+.m1
+know?
+.  m3
+What
+.m4
+.m2
+    @result{} Hello, Joe.  What do you know?
 @endExample
 
 @noindent
-Since @code{\f} has no expansion, it isn't necessary to protect its
-backslash.  Had we defined another macro within @code{bar} that takes a
-parameter, eight backslashes would be necessary before @samp{$1}.
-
-The @code{de1} request turns off compatibility mode while executing the
-macro.  On entry, the current compatibility mode is saved and restored
-at exit.
+A nested macro definition @emph{can} be terminated with @samp{..} and
+nested macros @emph{can} reuse end macros, but these control lines must
+be escaped multiple times for each level of nesting.  The necessity of
+this escaping and the utility of nested macro definitions will become
+clearer when we employ macro parameters and consider the behavior of
+copy mode in detail.
+@endDefreq
+
+@code{de} defines a macro that inherits the compatibility mode
+enablement status of its context (@pxref{Implementation Differences}).
+Often it is desirable to make a macro that uses @code{groff} features
+callable from contexts where compatibility mode is on; for instance,
+when writing extensions to a historical macro package.  To achieve this,
+compatibility mode needs to be switched off while such a macro is
+interpreted---without disturbing that state when it is finished.
+
+@Defreq {de1, name @Var{end}}
+The @code{de1} request defines a macro to be interpreted with
+compatibility mode disabled.  When @var{name} is called, compatibility
+mode enablement status is saved; it is restored when the call completes.
+Observe the extra backlash before the interpolation of register
+@samp{xxx}; we'll explore this subject in @ref{Copy Mode}.
 
 @Example
 .nr xxx 12345
-.
 .de aa
 The value of xxx is \\nxxx.
+.  br
 ..
 .de1 bb
 The value of xxx is \\nxxx.
 ..
-.
 .cp 1
-.
 .aa
-    @result{} warning: number register `' not defined
+    @error{} warning: register '' not defined
     @result{} The value of xxx is 0xxx.
 .bb
     @result{} The value of xxx is 12345.
 @endExample
+@endDefreq
 
-The @code{dei} request defines a macro indirectly.  That is, it expands
-strings whose names are @var{name} or @var{end} before performing the
-append.
+@DefreqList {dei, name @Var{end}}
+@DefreqListEndx {dei1, name @Var{end}}
+The @code{dei} request defines a macro with its name and end
+macro indirected through strings.  That is, it interpolates strings
+named @var{name} and @var{end} before performing the definition.
 
-This:
+The following examples are equivalent.
 
 @Example
 .ds xx aa
@@ -11584,32 +13198,13 @@
 .dei xx yy
 @endExample
 
-@noindent
-is equivalent to:
-
 @Example
 .de aa bb
 @endExample
 
-The @code{dei1} request is similar to @code{dei} but with compatibility
-mode switched off during execution of the defined macro.
-
-If compatibility mode is on, @code{de} (and @code{dei}) behave similar
-to @code{de1} (and @code{dei1}): A `compatibility save' token is
-inserted at the beginning, and a `compatibility restore' token at the
-end, with compatibility mode switched on during execution.  @xref{Gtroff
-Internals}, for more information on switching compatibility mode on and
-off in a single document.
-
-@pindex trace.tmac
-Using @file{trace.tmac}, you can trace calls to @code{de} and
-@code{de1}.
-
-Note that macro identifiers are shared with identifiers for strings and
-diversions.
-
-@xref{als,,the description of the @code{als} request}, for possible
-pitfalls if redefining a macro that has been aliased.
+The @code{dei1} request bears the same relationship to @code{dei} as
+@code{de1} does to @code{de}; it temporarily turns compatibility mode
+off when @var{name} is called.
 @endDefreq
 
 @DefreqList {am, name @Var{end}}
@@ -11617,11 +13212,12 @@
 @DefreqItemx {ami, name @Var{end}}
 @DefreqListEndx {ami1, name @Var{end}}
 @cindex appending to a macro (@code{am})
-@cindex macro, appending (@code{am})
-Works similarly to @code{de} except it appends onto the macro named
-@var{name}.  So, to make the previously defined @samp{P} macro actually
-do indented instead of block paragraphs, add the necessary code to the
-existing macro like this:
+@cindex macro, appending to (@code{am})
+@code{am} appends subsequent input lines to macro @var{name}, extending
+its definition, and otherwise working as @code{de} does.
+
+To make the previously defined @samp{P} macro set indented instead of
+block paragraphs, add the necessary code to the existing macro.
 
 @Example
 .am P
@@ -11629,182 +13225,153 @@
 ..
 @endExample
 
-The @code{am1} request turns off compatibility mode while executing the
-appended macro piece.  To be more precise, a @dfn{compatibility save}
-input token is inserted at the beginning of the appended code, and a
-@dfn{compatibility restore} input token at the end.
-
-The @code{ami} request appends indirectly, meaning that @code{gtroff}
-expands strings whose names are @var{name} or @var{end} before
-performing the append.
-
-The @code{ami1} request is similar to @code{ami} but compatibility mode
-is switched off during execution of the defined macro.
-
-@pindex trace.tmac
-Using @file{trace.tmac}, you can trace calls to @code{am} and
-@code{am1}.
+The other requests are analogous to their @samp{de} counterparts.  The
+@code{am1} request turns off compatibility mode during interpretation of
+the appendment.  The @code{ami} request appends indirectly, meaning that
+strings @var{name} and @var{end} are interpolated with the resulting
+names used before appending.  The @code{ami1} request is similar to
+@code{ami}, disabling compatibility mode during interpretation of the
+appended lines.
 @endDefreq
 
-@xref{Strings}, for the @code{als} and @code{rn} request to create an
-alias and rename a macro, respectively.
-
-The @code{de}, @code{am}, @code{di}, @code{da}, @code{ds}, and @code{as}
-requests (together with their variants) only create a new object if the
-name of the macro, diversion or string is currently undefined
-or if it is defined to be a request; normally they modify the value of
-an existing object.
+@pindex trace.tmac
+Using @file{trace.tmac}, you can trace calls to @code{de},
+@code{de1}, @code{am}, and @code{am1}.  You can also use the
+@code{backtrace} request at any point desired to troubleshoot tricky
+spots (@pxref{Debugging}).
+
+@xref{Strings}, for the @code{als}, @code{rm}, and @code{rn} requests to
+create an alias of, remove, and rename a macro, respectively.
+
+@cindex object creation
+Macro identifiers share their name space with requests, strings, and
+diversions; see @ref{Identifiers}.  The @code{am}, @code{as}, @code{da},
+@code{de}, @code{di}, and @code{ds} requests (together with their
+variants) create a new object only if the name of the macro, diversion,
+or string is currently undefined or if it is defined as a request;
+normally, they modify the value of an existing object.  @xref{als,,the
+description of the @code{als} request}, for pitfalls when redefining a
+macro that is aliased.
 
 @Defreq {return, @Var{anything}}
-Exit a macro, immediately returning to the caller.
-
-If called with an argument, exit twice, namely the current macro and the
-macro one level higher.  This is used to define a wrapper macro for
+Exit a macro, immediately returning to the caller.  If called with an
+argument @var{anything}, exit twice---the current macro and the macro
+one level higher.  This is used to define a wrapper macro for
 @code{return} in @file{trace.tmac}.
 @endDefreq
 
 @menu
-* Copy-in Mode::
 * Parameters::
+* Copy Mode::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Copy-in Mode, Parameters, Writing Macros, Writing Macros
-@subsection Copy-in Mode
-@cindex copy mode
-@cindex copy-in mode
-@cindex mode, copy
-@cindex mode, copy-in
-
-@cindex @code{\n}, when reading text for a macro
-@cindex @code{\$}, when reading text for a macro
-@cindex @code{\*}, when reading text for a macro
-@cindex @code{\\}, when reading text for a macro
-@cindex \@key{RET}, when reading text for a macro
-When @code{gtroff} reads in the text for a macro, string, or diversion,
-it copies the text (including request lines, but excluding escapes) into
-an internal buffer.
-Escapes are converted into an internal form, except for @code{\n},
-@code{\$}, @code{\*}, @code{\\} and @code{\@key{RET}}, which are evaluated
-and inserted into the text where the escape was located.
-This is known as @dfn{copy-in} mode or @dfn{copy} mode.
-
-What this means is that you can specify when these escapes are to be
-evaluated (either at copy-in time or at the time of use) by insulating
-the escapes with an extra backslash.  Compare this to the @code{\def}
-and @code{\edef} commands in @TeX{}.
-
-The following example prints the numbers 20 and@tie{}10:
-
-@Example
-.nr x 20
-.de y
-.nr x 10
-\&\nx
-\&\\nx
-..
-.y
-@endExample
-
-@c ---------------------------------------------------------------------
-
-@node Parameters,  , Copy-in Mode, Writing Macros
+@node Parameters, Copy Mode, Writing Macros, Writing Macros
 @subsection Parameters
 @cindex parameters
 
-The arguments to a macro or string can be examined using a variety of
-escapes.
+Macro calls and string interpolations optionally accept a list of
+arguments; recall @ref{Calling Macros}.  At the time such an
+interpolation takes place, these @dfn{parameters} can be examined using
+a register and a variety of escape sequences starting with @samp{\$}.
+All such escape sequences are interpreted even in copy mode, a fact we
+shall motivate and explain below (@pxref{Copy Mode}).
 
 @Defreg {.$}
-@cindex number of arguments register (@code{.$})
-The number of arguments passed to a macro or string.  This is a
-read-only number register.
-
-Note that the @code{shift} request can change its value.
+@cindex parameter count register (@code{.$})
+The count of parameters available to a macro or string is kept in this
+read-only register.  The @code{shift} request can change its value.
 @endDefreg
 
-Any individual argument can be retrieved with one of the following
-escapes:
+Any individual parameter can be accessed by its position in the list of
+arguments to the macro call, numbered from left to right starting at 1,
+with one of the following escape sequences.
 
 @DefescList {\\$, , n, }
-@DefescItem {\\$, @Lparen{}, nn, }
-@DefescListEnd {\\$, @Lbrack{}, nnn, @Rbrack{}}
-@cindex copy-in mode, and macro arguments
-@cindex mode, copy-in, and macro arguments
-@cindex macro, arguments (@code{\$})
-@cindex arguments, macro (@code{\$})
-Retrieve the @var{n}@dmn{th}, @var{nn}@dmn{th} or @var{nnn}@dmn{th}
-argument.  As usual, the first form only accepts a single number (larger
-than zero), the second a two-digit number (larger or equal to@tie{}10),
-and the third any positive integer value (larger than zero).  Macros and
-strings can have an unlimited number of arguments.  Note that due to
-copy-in mode, use two backslashes on these in actual use to prevent
-interpolation until the macro is actually invoked.
+@DefescItem {\\$, (, nn, }
+@DefescListEnd {\\$, , nnn, }
+Interpolate the @var{n}th, @var{nn}th, or @var{nnn}th parameter.  The
+first form expects only a single digit (1@leq{}@var{n}@leq{}9)), the
+second two digits (01@leq{}@var{nn}@leq{}99)), and the third any
+positive integer @var{nnn}.  Macros and strings accept an unlimited
+number of parameters.
 @endDefesc
 
 @Defreq {shift, @Var{n}}
-Shift the arguments 1@tie{}position, or as many positions as specified
-by its argument.  After executing this request, argument@tie{}@var{i}
-becomes argument @math{@var{i}-@var{n}}; arguments 1 to@tie{}@var{n} are
-no longer available.  Shifting by negative amounts is currently
-undefined.
-
-The register @code{.$} is adjusted accordingly.
-@endDefreq
+Shift the parameters @var{n} places (1@tie{}by default).  This is a
+``left shift'': what was parameter@tie{}@var{i} becomes parameter
+@math{@var{i}-@var{n}}.  The parameters formerly in positions 1
+to@tie{}@var{n} are no longer available.  Shifting by a non-positive
+amount performs no operation.  The register @code{.$} is adjusted
+accordingly.
+@endDefreq
+
+@cindex copy mode, and macro parameters
+@cindex mode, copy, and macro parameters
+@cindex macro, parameters (@code{\$})
+@cindex parameters, macro (@code{\$})
+In practice, parameter interpolations are usually seen prefixed with an
+extra escape character.  This is because the @code{\$} family of escape
+sequences is interpreted even in copy mode.@footnote{If they were not,
+parameter interpolations would be similar to command-line
+parameters---fixed for the entire duration of a @code{roff} program's
+run.  The advantage of interpolating @code{\$} escape sequences even in
+copy mode is that they can interpolate different contents from one call
+to the next, like function parameters in a procedural language.  The
+additional escape character is the price of this power.}
 
 @DefescList {\\$*, , , }
-@DefescListEndx {\\$@@, , , }
-In some cases it is convenient to use all of the arguments at once (for
-example, to pass the arguments along to another macro).  The @code{\$*}
-escape concatenates all the arguments separated by spaces.  A similar
-escape is @code{\$@@}, which concatenates all the arguments with each
-surrounded by double quotes, and separated by spaces.  If not in
-compatibility mode, the input level of double quotes is preserved (see
-@ref{Request and Macro Arguments}).
-@endDefesc
-
-@Defesc {\\$^, , , }
-Handle the parameters of a macro as if they were an argument to the
-@code{ds} or similar requests.
+@DefescItemx {\\$@@, , , }
+@DefescListEndx {\\$^, , , }
+In some cases it is convenient to interpolate all of the parameters at
+once (to pass them to a request, for instance).  The @code{\$*} escape
+concatenates the parameters, separating them with spaces.  @code{\$@@}
+is similar, concatenating the parameters, surrounding each with double
+quotes and separating them with spaces.  If not in compatibility mode,
+the interpolation depth of double quotes is preserved (@pxref{Calling
+Macros}).  @code{\$^} interpolates all parameters as if they were
+arguments to the @code{ds} request.
 
 @Example
 .de foo
-.  tm $1=`\\$1'
-.  tm $2=`\\$2'
-.  tm $*=`\\$*'
-.  tm $@@=`\\$@@'
-.  tm $^=`\\$^'
+. tm $1='\\$1'
+. tm $2='\\$2'
+. tm $*='\\$*'
+. tm $@@='\\$@@'
+. tm $^='\\$^'
 ..
 .foo " This is a "test"
-    @result{} $1=` This is a '
-    @result{} $2=`test"'
-    @result{} $*=` This is a  test"'
-    @result{} $@@=`" This is a " "test""'
-    @result{} $^=`" This is a "test"'
+    @error{} $1=' This is a '
+    @error{} $2='test"'
+    @error{} $*=' This is a  test"'
+    @error{} $@@='" This is a " "test""'
+    @error{} $^='" This is a "test"'
 @endExample
 
-This escape is useful mainly for macro packages like @file{trace.tmac},
+@code{\$*} is useful when writing a macro that doesn't need to
+distinguish its arguments, or even to not interpret them; examples
+include macros that produce diagnostic messages by wrapping the
+@code{tm} or @code{ab} requests.  Use @code{\$@@} when writing a macro
+that may need to shift its parameters and/or wrap a macro or request
+that finds the count significant.  If in doubt, prefer @code{\$@@} to
+@code{\$*}.  An application of @code{\$^} is seen in @file{trace.tmac},
 which redefines some requests and macros for debugging purposes.
 @endDefesc
 
 @Defesc {\\$0, , , }
 @cindex macro name register (@code{\$0})
 @cindex @code{als} request, and @code{\$0}
-The name used to invoke the current macro.  The @code{als} request can
-make a macro have more than one name.
-
-If a macro is called as a string (within another macro), the value of
-@code{\$0} isn't changed.
+Interpolate the name by which the macro being interpreted was called.
+The @code{als} request can cause a macro to have more than one name.
+Applying string interpolation to a macro does not change this name.
 
 @Example
 .de foo
 .  tm \\$0
 ..
-.als foo bar
+.als bar foo
 .
-@endExample
-@Example
 .de aaa
 .  foo
 ..
@@ -11818,31 +13385,222 @@
 \\*bar\\
 ..
 .
-@endExample
-@Example
 .aaa
-    @result{} foo
+    @error{} foo
 .bbb
-    @result{} bar
+    @error{} bar
 .ccc
-    @result{} ccc
+    @error{} ccc
 .ddd
-    @result{} ddd
+    @error{} ddd
 @endExample
 @endDefesc
 
-@xref{Request and Macro Arguments}.
+@c ---------------------------------------------------------------------
+
+@node Copy Mode, , Parameters, Writing Macros
+@subsection Copy Mode
+@cindex copy mode
+@cindex copy mode
+@cindex mode, copy
+@cindex mode, copy
+
+@cindex @code{\n}, when reading text for a macro
+@cindex @code{\$}, when reading text for a macro
+@cindex @code{\*}, when reading text for a macro
+@cindex \@key{RET}, when reading text for a macro
+When GNU @code{troff} processes certain requests, most importantly those
+which define or append to a macro or string, it does so in @dfn{copy
+mode}: it copies the characters of the definition into a dedicated
+storage region, interpolating the escape sequences @code{\n}, @code{\g},
+@code{\$}, @code{\*}, @code{\V}, and @code{\?} normally; interpreting
+@code{\@key{RET}} immediately; discarding comments @code{\"} and
+@code{\#}; interpolating the current leader, escape, or tab character
+with @code{\a}, @code{\e}, and @code{\t}, respectively; and storing all
+other escape sequences in an encoded form.
+
+@cindex interpretation mode
+@cindex mode, interpretation
+The complement of copy mode---a @code{roff} formatter's behavior when
+not defining or appending to a macro, string, or diversion---where all
+macros are interpolated, requests invoked, and valid escape sequences
+processed immediately upon recognition, can be termed
+@dfn{interpretation mode}.
+
+@Defesc {\\\\, , , }
+The escape character, @code{\} by default, can escape itself.  This
+enables you to control whether a given @code{\n}, @code{\g}, @code{\$},
+@code{\*}, @code{\V}, or @code{\?} escape sequence is interpreted at the
+time the macro containing it is defined, or later when the macro is
+called.@footnote{Compare this to the @code{\def} and @code{\edef}
+commands in @TeX{}.}
+
+@Example
+.nr x 20
+.de y
+.nr x 10
+\&\nx
+\&\\nx
+..
+.y
+    @result{} 20 10
+@endExample
+
+You can think of @code{\\} as a ``delayed'' backslash; it is the escape
+character followed by a backslash from which the escape character has
+removed its special meaning.  Consequently, @samp{\\} is not an escape
+sequence in the usual sense.  In any escape sequence @samp{\@var{X}}
+that GNU @code{troff} does not recognize, the escape character is
+ignored and @var{X} is output.  An unrecognized escape sequence causes
+a warning in category @samp{escape}, with two exceptions---@samp{\\} is
+the first.
+@endDefesc
+
+@cindex @code{\\}, when reading text for a macro
+@Defesc {\\., , , }
+@code{\.} escapes the control character.  It is similar to @code{\\} in
+that it isn't a true escape sequence.  It is used to permit nested macro
+definitions to end without a named macro call to conclude them.  Without
+a syntax for escaping the control character, this would not be possible.
+
+@Example
+.de m1
+foo
+.
+.  de m2
+bar
+\\..
+.
+..
+.m1
+.m2
+    @result{} foo bar
+@endExample
+
+@noindent
+The first backslash is consumed while the macro is read, and the second
+is interpreted when macro @code{m1} is called.
+@endDefesc
+
+@code{roff} documents should not use the @code{\\} or @code{\.}
+character sequences outside of copy mode; they serve only to obfuscate
+the input.  Use @code{\e} to represent the escape character,
+@code{\rs} to obtain a backslash glyph, and @code{\&} before @samp{.}
+and @samp{'} where GNU @code{troff} expects them as control characters
+if you mean to use them literally (recall @ref{Requests and Macros}).
+
+Macro definitions can be nested to arbitrary depth.  The mechanics of
+parsing the escape character have significant consequences for this
+practice.
+
+@Example
+.de M1
+\\$1
+.  de M2
+\\\\$1
+.    de M3
+\\\\\\\\$1
+\\\\..
+.    M3 hand.
+\\..
+.  M2 of
+..
+This understeer is getting
+.M1 out
+    @result{} This understeer is getting out of hand.
+@endExample
+
+Each escape character is interpreted twice---once in copy mode, when the
+macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of
+@code{\n}, @code{\g}, @code{\$}, @code{\*}, @code{\V}, and @code{\?} at
+each nesting level, which can be daunting.  GNU @code{troff} offers a
+solution.
+
+@Defesc {\\E, , , }
+@code{\E} represents an escape character that is not interpreted in copy
+mode.  You can use it to ease the writing of nested macro definitions.
+
+@Example
+.de M1
+.  nop \E$1
+.  de M2
+.    nop \E$1
+.    de M3
+.      nop \E$1
+\\\\..
+.    M3 better.
+\\..
+.  M2 bit
+..
+This vehicle handles
+.M1 a
+    @result{} This vehicle handles a bit better.
+@endExample
+
+Observe that because @code{\.} is not a true escape sequence, we can't
+use @code{\E} to keep @samp{..} from ending a macro definition
+prematurely.  If the multiplicity of backslashes complicates
+maintenance, use end macros.
+
+@code{\E} is also convenient to define strings containing escape
+sequences that need to work when used in copy mode (for example, as
+macro arguments), or which will be interpolated at varying macro nesting
+depths.  We might define strings to begin and end superscripting
+as follows.@footnote{These are lightly adapted from the @code{groff}
+implementation of the @file{ms} macros.}
+
+@Example
+.ds @{ \v'-.9m\s'\En.s*7u/10u'+.7m'
+.ds @} \v'-.7m\s0+.9m'
+@endExample
+
+When the @code{ec} request is used to redefine the escape character,
+@code{\E} also makes it easier to distinguish the semantics of an escape
+character from the other meaning(s) its character might have.  Consider
+the use of an unusual escape character, @samp{-}.
+
+@Example
+.nr a 1
+.ec -
+.de xx
+--na
+..
+.xx
+    @result{} -na
+@endExample
+
+@noindent
+This result may surprise you; some people expect @samp{1} to be output
+since register @samp{a} has clearly been defined with that value.  What
+has happened?  The robotic replacement of @samp{\} with @samp{-} has led
+us astray.  You might recognize the sequence @samp{--} more readily with
+the default escape character as @samp{\-}, the special character escape
+sequence for the minus sign glyph.
+
+@Example
+.nr a 1
+.ec -
+.de xx
+-Ena
+..
+.xx
+    @result{} 1
+@endExample
+@endDefesc
 
 
 @c =====================================================================
 
-@node Page Motions, Drawing Requests, Writing Macros, gtroff Reference
+@node Page Motions, Drawing Geometric Objects, Writing Macros, GNU troff Reference
 @section Page Motions
 @cindex page motions
 @cindex motions, page
 
-@xref{Manipulating Spacing}, for a discussion of the main request for
-vertical motion, @code{sp}.
+@xref{Manipulating Spacing}, for a discussion of the most commonly used
+request for vertical motion, @code{sp}, which spaces downward by one
+vee.
 
 @DefreqList {mk, @Var{reg}}
 @DefreqListEndx {rt, @Var{dist}}
@@ -11854,31 +13612,28 @@
 @cindex page location, vertical, returning to marked (@code{rt})
 @cindex location, vertical, page, returning to marked (@code{rt})
 @cindex vertical page location, returning to marked (@code{rt})
-The request @code{mk} can be used to mark a location on a page, for
-movement to later.  This request takes a register name as an argument in
-which to store the current page location.  With no argument it stores
-the location in an internal register.  The results of this can be used
-later by the @code{rt} or the @code{sp} request (or the @code{\v}
-escape).
-
-The @code{rt} request returns @emph{upwards} to the location marked with
-the last @code{mk} request.  If used with an argument, return to a
-position which distance from the top of the page is @var{dist} (no
-previous call to @code{mk} is necessary in this case).  Default scaling
-indicator is @samp{v}.
+You can @dfn{mark} a location on a page for subsequent @dfn{return}.
+@code{mk} takes an argument, a register name in which to store the
+current page location.  If given no argument, it stores the location in
+an internal register.  This location can be used later by the @code{rt}
+or the @code{sp} requests (or the @code{\v} escape).
+
+The @code{rt} request returns @emph{upward} to the location marked with
+the last @code{mk} request.  If used with an argument, it returns to a
+vertical position@tie{}@var{dist} from the top of the page (no previous
+call to @code{mk} is necessary in this case).  The default scaling
+unit is @samp{v}.
 
-If a page break occurs between a @code{mk} request and its
-matching @code{rt} request, the @code{rt} is silently ignored.
+If a page break occurs between a @code{mk} request and its matching
+@code{rt} request, the @code{rt} request is silently ignored.
 
-Here a primitive solution for a two-column macro.
+A simple implementation of a macro to set text in two columns follows.
 
 @Example
 .nr column-length 1.5i
 .nr column-gap 4m
 .nr bottom-margin 1m
 .
-@endExample
-@Example
 .de 2c
 .  br
 .  mk
@@ -11887,8 +13642,6 @@
 .  nr right-side 0
 ..
 .
-@endExample
-@Example
 .de 2c-trap
 .  ie \\nright-side \@{\
 .    nr right-side 0
@@ -11903,8 +13656,10 @@
 .    rt
 .  \@}
 ..
-.
 @endExample
+
+Now let us apply our two-column macro.
+
 @Example
 .pl 1.5i
 .ll 4i
@@ -11916,114 +13671,137 @@
 Note that this implementation isn't robust
 and thus not suited for a real two-column
 macro.
-@endExample
-
-Result:
-
-@Example
-This is a small test that shows how the
-rt request works in combination with mk.
-
-Starting  here,    isn't    robust
-text is typeset    and   thus  not
-in two columns.    suited  for   a
-Note that  this    real two-column
-implementation     macro.
+    @result{} This is a small test that shows how the
+    @result{} rt request works in combination with mk.
+    @result{}
+    @result{} Starting  here,    isn't    robust
+    @result{} text is typeset    and   thus  not
+    @result{} in two columns.    suited  for   a
+    @result{} Note that  this    real two-column
+    @result{} implementation     macro.
 @endExample
 @endDefreq
 
-The following escapes give fine control of movements about the page.
+Several escape sequences enable fine control of movement about the page.
 
-@Defesc {\\v, ', e, '}
+@Defesc {\\v, @code{'}, expr, @code{'}}
 @cindex vertical motion (@code{\v})
 @cindex motion, vertical (@code{\v})
-Move vertically, usually from the current location on the page (if no
-absolute position operator @samp{|} is used).  The argument@tie{}@var{e}
-specifies the distance to move; positive is downwards and negative
-upwards.  The default scaling indicator for this escape is @samp{v}.
-Beware, however, that @code{gtroff} continues text processing at the
-point where the motion ends, so you should always balance motions to
-avoid interference with text processing.
-
-@code{\v} doesn't trigger a trap.  This can be quite useful; for
-example, consider a page bottom trap macro that prints a marker in the
-margin to indicate continuation of a footnote or something similar.
+Vertically move the drawing position.  @var{expr} indicates the
+magnitude of motion: positive is downward and and negative upward.  The
+default scaling unit is @samp{v}.  The motion is relative to the current
+drawing position unless @var{expr} begins with the boundary-relative
+motion operator @samp{|}.  @xref{Numeric Expressions}.
+
+Text processing continues at the new drawing position; usually, vertical
+motions should be in balanced pairs to avoid a confusing page layout.
+
+@code{\v} will not spring a vertical position trap.  This can be useful;
+for example, consider a page bottom trap macro that prints a marker in
+the margin to indicate continuation of a footnote.  @xref{Traps}.
 @endDefesc
 
-There are some special-case escapes for vertical motion.
-
-@Defesc {\\r, , , }
-Move upwards@tie{}1@dmn{v}.
+A few escape sequences that produce vertical motion are unusual.  They
+are thought to originate early in AT&T @code{nroff} history to achieve
+super- and subscripting by half-line motions on line printers and
+teletypewriters before the phototypesetter made more precise positioning
+available.  They are reckoned in ems---not vees---to maintain continuity
+with their original purpose of moving relative to the size of the type
+rather than the distance between text baselines (vees).@footnote{At the
+@code{grops} defaults of 10-point type on 12-point vertical spacing, the
+difference between half a vee and half an em can be subtle:@: large
+spacings like @samp{.vs .5i} make it obvious.}
+
+@DefescList {\\r, , , }
+@DefescItemx {\\u, , , }
+@DefescListEndx {\\d, , , }
+Move upward@tie{}1@dmn{m}, upward@tie{}.5@dmn{m}, and
+downward@tie{}.5@dmn{m}, respectively.
 @endDefesc
 
-@Defesc {\\u, , , }
-Move upwards@tie{}.5@dmn{v}.
-@endDefesc
+@noindent
+Let us see these escape sequences in use.
 
-@Defesc {\\d, , , }
-Move down@tie{}.5@dmn{v}.
-@endDefesc
+@Example
+Obtain 100 cm\u3\d of \ka\d\092\h'|\nau'\r233\dU.
+@endExample
+
+In the foregoing we have paired @code{\u} and @code{\d} to typeset a
+superscript, and later a full em negative (``reverse'') motion to place
+a superscript above a subscript.  A numeral-width horizontal motion
+escape sequence aligns the proton and nucleon numbers, while @code{\k}
+marks a horizontal position to which @code{\h} returns so that we could
+stack them.  (We shall discuss these horizontal motion escape sequences
+presently.)  In serious applications, we often want to alter the type
+size of the -scripts and to fine-tune the vertical motions, as the
+@code{groff} @file{ms} package does with its super- and subscripting
+string definitions.
 
-@Defesc {\\h, ', e, '}
+@Defesc {\\h, @code{'}, expr, @code{'}}
 @cindex inserting horizontal space (@code{\h})
 @cindex horizontal space (@code{\h})
 @cindex space, horizontal (@code{\h})
 @cindex horizontal motion (@code{\h})
 @cindex motion, horizontal (@code{\h})
-Move horizontally, usually from the current location (if no absolute
-position operator @samp{|} is used).  The expression@tie{}@var{e}
-indicates how far to move: positive is rightwards and negative
-leftwards.  The default scaling indicator for this escape is @samp{m}.
-
-This horizontal space is not discarded at the end of a line.  To insert
-discardable space of a certain length use the @code{ss} request.
+Horizontally move the drawing position.  @var{expr} indicates the
+magnitude of motion: positive is rightward and negative leftward.  The
+default scaling unit is @samp{m}.  The motion is relative to the current
+drawing position unless @var{expr} begins with the boundary-relative
+motion operator @samp{|}.  @xref{Numeric Expressions}.
 @endDefesc
 
-There are a number of special-case escapes for horizontal motion.
+The following string definition sets the @TeX{}
+logo.@footnote{@xref{Strings}, for an explanation of the trailing
+@samp{\"}.}
 
-@Defesc {\\@key{SP}, , , }
-@cindex space, unbreakable
-@cindex unbreakable space
-An unbreakable and unpaddable (i.e.@: not expanded during filling)
-space.  (Note: This is a backslash followed by a space.)
-@endDefesc
+@Example
+.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\"
+@endExample
 
-@Defesc {\\~, , , }
-An unbreakable space that stretches like a normal inter-word space when
-a line is adjusted.
+There are a number of special-case escape sequences for horizontal
+motion.
+
+@Defesc {\\@key{SP}, , , }
+@cindex space, unbreakable and unadjustable (@code{\@key{SP}})
+@cindex unbreakable and unadjustable space (@code{\@key{SP}})
+@cindex unadjustable and unbreakable space (@code{\@key{SP}})
+@c We use the following notation in our man pages; Texinfo is bound to
+@c the GNU Emacs dialect.
+@esindex \@slanted{space}
+Move right one word space.  (The input is a backslash followed by a
+space.)  This escape sequence can be thought of as a non-adjustable,
+unbreakable space.  Usually you want @code{\~} instead; see
+@ref{Manipulating Filling and Adjustment}.
 @endDefesc
 
+@cindex thin space (@code{\|})
+@cindex space, thin (@code{\|})
 @Defesc {\\|, , , }
-A 1/6@dmn{th} em space.  Ignored for TTY output devices (rounded to
-zero).
-
-However, if there is a glyph defined in the current font file with name
-@code{\|} (note the leading backslash), the width of this glyph is used
-instead (even for TTYs).
+Move one-sixth @dmn{em} to the right on typesetting output devices.  If
+a glyph named @samp{\|} is defined in the current font, its width is
+used instead, even on terminal output devices.
 @endDefesc
 
+@cindex hair space (@code{\^})
+@cindex space, hair (@code{\^})
 @Defesc {\\^, , , }
-A 1/12@dmn{th} em space.  Ignored for TTY output devices (rounded to
-zero).
-
-However, if there is a glyph defined in the current font file with name
-@code{\^} (note the leading backslash), the width of this glyph is used
-instead (even for TTYs).
+Move one-twelfth @dmn{em} to the right on typesetting output devices.
+If a glyph named @samp{\^} is defined in the current font, its width is
+used instead, even on terminal output devices.
 @endDefesc
 
 @Defesc {\\0, , , }
-@cindex space, width of a digit (@code{\0})
-@cindex digit width space (@code{\0})
-A space the size of a digit.
+@cindex space, width of a digit (numeral) (@code{\0})
+@cindex digit-width space (@code{\0})
+@cindex figure space (@code{\0})
+@cindex numeral-width space (@code{\0})
+Move right by the width of a numeral in the current font.
 @endDefesc
 
-The following string sets the @TeX{} logo:
+Horizontal motions are not discarded at the end of an output line as
+word spaces are.  @xref{Breaking}.
 
-@Example
-.ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
-@endExample
-
-@DefescList {\\w, ', text, '}
+@DefescList {\\w, @code{'}, anything, @code{'}}
 @DefregItemx {st}
 @DefregItemx {sb}
 @DefregItemx {rst}
@@ -12032,47 +13810,59 @@
 @DefregItemx {ssc}
 @DefregListEndx {skw}
 @cindex width escape (@code{\w})
-Return the width of the specified @var{text} in basic units.  This
-allows horizontal movement based on the width of some arbitrary text
-(e.g.@: given as an argument to a macro).
+Interpolate the width of @var{anything} in basic units.  This escape
+sequence allows several properties of formatted output to be measured
+without writing it out.
 
 @Example
-The length of the string `abc' is \w'abc'u.
-    @result{} The length of the string `abc' is 72u.
+The length of the string 'abc' is \w'abc'u.
+    @result{} The length of the string 'abc' is 72u.
 @endExample
 
-Font changes may occur in @var{text}, which don't affect current
-settings.
+@cindex dummy environment, used by @code{\w} escape sequence
+@cindex environment, dummy, used by @code{\w} escape sequence
+@var{anything} is processed in a dummy environment:@: this means that
+font and type size changes, for example, may occur within it without
+affecting subsequent output.
 
-After use, @code{\w} sets several registers:
+@need 500
+After each use, @code{\w} sets several registers.
 
+@cindex CSTR@tie{}#54 errata
+@cindex CSTR@tie{}#54 erratum, @code{sb} register
+@cindex CSTR@tie{}#54 erratum, @code{st} register
 @table @code
 @item st
 @itemx sb
-The highest and lowest point of the baseline, respectively, in
-@var{text}.
+The maximum vertical displacements of the text baseline above and below,
+respectively.  The sign convention is opposite that of relative vertical
+motions; that is, depth below the (original) baseline is negative.
+These registers are incorrectly documented in the @acronym{AT&T}
+@code{troff} manual as ``the highest and lowest extent of the argument
+to @code{\w} relative to the baseline''.
 
 @item rst
 @itemx rsb
-Like the @code{st} and @code{sb} registers, but takes account of the
-heights and depths of glyphs.  In other words, this gives the highest
-and lowest point of @var{text}.  Values below the baseline are negative.
+Like @code{st} and @code{sb}, but taking account of the heights and
+depths of glyphs.  In other words, these registers store the highest and
+lowest vertical positions attained by @var{anything}, doing what
+@acronym{AT&T} @code{troff} documented @code{st} and @code{sb} as doing.
 
 @item ct
-Defines the kinds of glyphs occurring in @var{text}:
+Characterizes the geometry of glyphs occurring in @var{anything}.
 
 @table @asis
 @item 0
-only short glyphs, no descenders or tall glyphs.
+only short glyphs, no descenders or tall glyphs
 
 @item 1
-at least one descender.
+at least one descender
 
 @item 2
-at least one tall glyph.
+at least one tall glyph
 
 @item 3
-at least one each of a descender and a tall glyph.
+at least one each of a descender and a tall glyph
 @end table
 
 @item ssc
@@ -12087,15 +13877,15 @@
 @endDefesc
 
 @DefescList {\\k, , p, }
-@DefescItem {\\k, @Lparen{}, ps, }
-@DefescListEnd {\\k, @Lbrack{}, position, @Rbrack{}}
+@DefescItem {\\k, (, ps, }
+@DefescListEnd {\\k, , position, }
 @cindex saving horizontal input line position (@code{\k})
 @cindex horizontal input line position, saving (@code{\k})
 @cindex input line position, horizontal, saving (@code{\k})
 @cindex position, horizontal input line, saving (@code{\k})
 @cindex line, input, horizontal position, saving (@code{\k})
-Store the current horizontal position in the @emph{input} line in number
-register with name @var{position} (one-character name@tie{}@var{p},
+Store the current horizontal position in the @emph{input} line in a
+register with the name @var{position} (one-character name@tie{}@var{p},
 two-character name @var{ps}).  Use this, for example, to return to the
 beginning of a string for highlighting or other decoration.
 @endDefesc
@@ -12113,37 +13903,38 @@
 @cindex output line, horizontal position, register (@code{.k})
 @cindex position, horizontal, in output line, register (@code{.k})
 @cindex line, output, horizontal position, register (@code{.k})
-A read-only number register containing the current horizontal output
-position (relative to the current indentation).
+A read-only register containing the current horizontal output position
+(relative to the current indentation).
 @endDefreg
 
-@Defesc {\\o, ', abc, '}
+@Defesc {\\o, @code{'}, abc@dots{}, @code{'}}
 @cindex overstriking glyphs (@code{\o})
 @cindex glyphs, overstriking (@code{\o})
-Overstrike glyphs @var{a}, @var{b}, @var{c}, @dots{}; the glyphs are
-centered, and the resulting spacing is the largest width of the affected
-glyphs.
+Overstrike the glyphs of characters @var{a}, @var{b}, @var{c}, @dots{};
+the glyphs are centered, written, and the drawing position advanced by
+the widest of the glyphs.
 @endDefesc
 
-@Defesc {\\z, , g, }
+@Defesc {\\z, , c, }
 @cindex zero-width printing (@code{\z}, @code{\Z})
 @cindex printing, zero-width (@code{\z}, @code{\Z})
-Print glyph @var{g} with zero width, i.e., without spacing.  Use this to
-overstrike glyphs left-aligned.
+Format the character @var{c} with zero width; that is, without advancing
+the drawing position.  Use @code{\z} to overstrike glyphs aligned to
+their left edges, in contrast to @code{\o}'s centering.
 @endDefesc
 
-@Defesc {\\Z, ', anything, '}
+@Defesc {\\Z, @code{'}, anything, @code{'}}
 @cindex zero-width printing (@code{\z}, @code{\Z})
 @cindex printing, zero-width (@code{\z}, @code{\Z})
-Print @var{anything}, then restore the horizontal and vertical position.
-The argument may not contain tabs or leaders.
+Save the drawing position, format @var{anything}, then restore it.  Tabs
+and leaders in the argument are ignored with an error diagnostic.
 
-The following is an example of a strike-through macro:
+We might implement a strike-through macro thus.
 
 @Example
 .de ST
-.nr ww \w'\\$1'
-\Z@@\v'-.25m'\l'\\nwwu'@@\\$1
+.nr width \w'\\$1'
+\Z@@\v'-.25m'\l'\\nwidthu'@@\\$1
 ..
 .
 This is
@@ -12155,69 +13946,62 @@
 
 @c =====================================================================
 
-@node Drawing Requests, Traps, Page Motions, gtroff Reference
-@section Drawing Requests
+@node Drawing Geometric Objects, Traps, Page Motions, GNU troff Reference
+@section Drawing Geometric Objects
 @cindex drawing requests
 @cindex requests for drawing
 
-@code{gtroff} provides a number of ways to draw lines and other figures
-on the page.  Used in combination with the page motion commands (see
-@ref{Page Motions}, for more info), a wide variety of figures can be
-drawn.  However, for complex drawings these operations can be quite
-cumbersome, and it may be wise to use graphic preprocessors like
-@code{gpic} or @code{ggrn}.  @xref{gpic}, and @ref{ggrn}, for more
-information.
+A few of the formatter's escape sequences draw lines and other geometric
+objects.  Combined with each other and with page motion commands
+(@pxref{Page Motions}), a wide variety of figures is possible.  For
+complex drawings, these operations can be cumbersome; the preprocessors
+@code{gpic} or @code{ggrn} are typically used instead.
+
+The @code{\l} and @code{\L} escape sequences draw horizontal and
+vertical sequences of glyphs, respectively.  Even the simplest of
+output devices supports them.
 
-All drawing is done via escapes.
-
-@DefescList {\\l, ', l, '}
-@DefescListEnd {\\l, ', lg, '}
+@DefescList {\\l, @code{'}, l, @code{'}}
+@DefescListEnd {\\l, @code{'}, lc, @code{'}}
 @cindex drawing horizontal lines (@code{\l})
 @cindex horizontal line, drawing (@code{\l})
 @cindex line, horizontal, drawing (@code{\l})
-Draw a line horizontally.  @var{l} is the length of the line to be
-drawn.  If it is positive, start the line at the current location and
-draw to the right; its end point is the new current location.  Negative
-values are handled differently: The line starts at the current location
-and draws to the left, but the current location doesn't move.
-
-@var{l} can also be specified absolutely (i.e.@: with a leading
-@samp{|}), which draws back to the beginning of the input line.  Default
-scaling indicator is @samp{m}.
+Draw a horizontal line of length @var{l} from the drawing position.
+Rightward motion is positive.  Afterward, the drawing position is at the
+right end of the line.  The default scaling unit is @samp{m}.
 
-@cindex underscore glyph (@code{\ru})
+@cindex baseline rule special character(@code{\ru})
 @cindex glyph, underscore (@code{\ru})
 @cindex line drawing glyph
 @cindex glyph, for line drawing
-The optional second parameter@tie{}@var{g} is a glyph to draw the line
-with.  If this second argument is not specified, @code{gtroff} uses the
-underscore glyph, @code{\ru}.
-
-@cindex zero width space character (@code{\&})
-@cindex character, zero width space (@code{\&})
-@cindex space character, zero width (@code{\&})
-To separate the two arguments (to prevent @code{gtroff} from
-interpreting a drawing glyph as a scaling indicator if the glyph is
-represented by a single character) use @code{\&}.
+The optional second parameter@tie{}@var{c} is a character with which to
+draw the line.  The default is the baseline rule special character,
+@code{\ru}.
 
-Here a small useful example:
+@cindex dummy character (@code{\&}), effect on @code{\l} escape sequence
+@cindex character, dummy (@code{\&}), effect on @code{\l} escape sequence
+If @var{c} is a valid scaling unit, put @code{\&} after @var{l} to
+disambiguate the input.
 
 @Example
-.de box
+.de textbox
 \br\\$*\br\l'|0\rn'\l'|0\ul'
 ..
 @endExample
 
 @noindent
-Note that this works by outputting a box rule (a vertical line), then
-the text given as an argument and then another box rule.  Finally, the
-line drawing escapes both draw from the current location to the
-beginning of the @emph{input} line -- this works because the line length
-is negative, not moving the current point.
+The foregoing outputs a box rule (a vertical line), the text
+argument(s), and another box rule.  We employ the boundary-relative
+motion operator @samp{|}.  Finally, the line-drawing escape sequences
+draw a radical extender (a form of overline) and an underline from the
+drawing position to the position coresponding to beginning of the
+@emph{input} line.  The drawing position returns to just after the
+right-hand box rule because the lengths of the drawn lines are negative,
+as noted above.
 @endDefesc
 
-@DefescList {\\L, ', l, '}
-@DefescListEnd {\\L, ', lg, '}
+@DefescList {\\L, @code{'}, l, @code{'}}
+@DefescListEnd {\\L, @code{'}, lc, @code{'}}
 @cindex drawing vertical lines (@code{\L})
 @cindex vertical line drawing (@code{\L})
 @cindex line, vertical, drawing (@code{\L})
@@ -12225,54 +14009,132 @@
 @cindex glyph for line drawing
 @cindex box rule glyph (@code{\br})
 @cindex glyph, box rule (@code{\br})
-Draw vertical lines.  Its parameters are similar to the @code{\l}
-escape, except that the default scaling indicator is @samp{v}.  The
-movement is downwards for positive values, and upwards for negative
-values.  The default glyph is the box rule glyph, @code{\br}.  As with
-the vertical motion escapes, text processing blindly continues where the
-line ends.
+Draw a vertical line of length @var{l} from the drawing position.
+Downward motion is positive.  The default scaling unit is @samp{v}.  The
+default character is the box rule, @code{\br}.  As with vertical
+motion escape sequences, text processing continues where the line ends.
+@code{\L} is otherwise similar to @code{\l}.
 
 @Example
+$ nroff <<EOF
 This is a \L'3v'test.
+EOF
+    @result{} This is a
+    @result{}           |
+    @result{}           |
+    @result{}           |test.
 @endExample
 
 @noindent
-Here is the result, produced with @code{grotty}.
+When writing text, the drawing position is at the text baseline; recall
+@ref{Page Geometry}.
+@endDefesc
+
+@c BEGIN Keep (roughly) parallel with subsection "Drawing commands" of
+@c groff(7).
+The @code{\D} escape sequence provides @dfn{drawing commands} that
+direct the output device to render geometrical objects rather than
+glyphs.  Specific devices may support only a subset, or may feature
+additional ones; consult the man page for the output driver in use.
+Terminal devices in particular implement almost none.  @xref{Graphics
+Commands}.
+
+Rendering starts at the drawing position; when finished, the drawing
+position is left at the rightmost point of the object, even for closed
+figures, except where noted.  GNU @code{troff} draws stroked (outlined)
+objects with the stroke color, and shades filled ones with the fill
+color.  @xref{Colors}.  Coordinates @var{h} and @var{v} are horizontal
+and vertical motions relative to the drawing position or previous point
+in the command.  The default scaling unit for horizontal measurements
+(and diameters of circles) is @samp{m}; for vertical ones, @samp{v}.
+
+Circles, ellipses, and polygons can be drawn filled or stroked.  These
+are independent properties; if you want a filled, stroked figure, you
+must draw the same figure twice using each drawing command.  A filled
+figure is always smaller than an outlined one because the former is
+drawn only within its defined area, whereas strokes have a line
+thickness (set with @samp{\D't'}).
 
 @Example
-This is a
-          |
-          |
-          |test.
+\h'1i'\v'1i'\
+\# increase line thickness
+\Z'\D't 5p''\
+\# draw stroked (unfilled) polygon
+\Z'\D'p 3 3 -6 0''\
+\# draw filled (solid) polygon
+\Z'\D'P 3 3 -6 0''
 @endExample
-@endDefesc
 
-@Defesc {\\D, ', command arg @dots{}, '}
-The @code{\D} escape provides a variety of drawing functions.  Note that
-on character devices, only vertical and horizontal lines are supported
-within @code{grotty}; other devices may only support a subset of the
-available drawing functions.
-
-The default scaling indicator for all subcommands of @code{\D} is
-@samp{m} for horizontal distances and @samp{v} for vertical ones.
-Exceptions are @w{@code{\D'f @dots{}'}} and @w{@code{\D't @dots{}'}},
-which use @code{u} as the default, and @w{@code{\D'F@var{x} @dots{}'}},
-which arguments are treated similar to the @code{defcolor} request.
+@need 500
+@Defesc {\\D, @code{'}, command argument @dots{}, @code{'}}
+Drawing command escape sequence parameters begin with an ordinary
+character, @var{command}, selecting the type of object to be drawn,
+followed by @var{argument}s whose meaning is determined by
+@var{command}.
 
 @table @code
+@item \D'~ @var{h1} @var{v1} @dots{} @var{hn} @var{vn}'
+@cindex drawing a spline (@samp{\D'~ @dots{}'})
+@cindex spline, drawing (@samp{\D'~ @dots{}'})
+Draw a B-spline to each point in sequence, leaving the drawing position
+at (@var{hn}, @var{vn}).
+
+@item \D'a @var{hc} @var{vc} @var{h} @var{v}'
+@cindex arc, drawing (@samp{\D'a @dots{}'})
+@cindex drawing an arc (@samp{\D'a @dots{}'})
+Draw a circular arc centered at (@var{hc}, @var{vc}) counterclockwise
+from the drawing position to a point (@var{h}, @var{v}) relative to the
+center.  @footnote{(@var{hc}, @var{vc}) is adjusted to the point nearest
+the perpendicular bisector of the arc's chord.}
+
+@item \D'c @var{d}'
+@cindex circle, stroked, drawing (@samp{\D'c @dots{}'})
+@cindex drawing a stroked circle (@samp{\D'c @dots{}'})
+@cindex stroked circle, drawing (@samp{\D'c @dots{}'})
+@cindex circle, outlined, drawing (@samp{\D'c @dots{}'})
+@cindex drawing an outlined circle (@samp{\D'c @dots{}'})
+@cindex outlined circle, drawing (@samp{\D'c @dots{}'})
+Draw a circle of diameter @var{d} with its leftmost point at the drawing
+position.
+
+@item \D'C @var{d}'
+@cindex circle, filled, drawing (@samp{\D'C @dots{}'})
+@cindex drawing a filled circle (@samp{\D'C @dots{}'})
+@cindex filled circle, drawing (@samp{\D'C @dots{}'})
+@cindex circle, solid, drawing (@samp{\D'C @dots{}'})
+@cindex drawing a solid circle (@samp{\D'C @dots{}'})
+@cindex solid circle, drawing (@samp{\D'C @dots{}'})
+As @samp{\D'C @r{@dots{}}'}, but the circle is filled.
+
+@item \D'e @var{h} @var{v}'
+@cindex ellipse, stroked, drawing (@samp{\D'e @dots{}'})
+@cindex drawing a stroked ellipse (@samp{\D'e @dots{}'})
+@cindex stroked ellipse, drawing (@samp{\D'e @dots{}'})
+@cindex ellipse, outlined, drawing (@samp{\D'e @dots{}'})
+@cindex drawing an outlined ellipse (@samp{\D'e @dots{}'})
+@cindex outlined ellipse, drawing (@samp{\D'e @dots{}'})
+Draw an ellipse of width @var{h} and height @var{v} with its leftmost
+point at the drawing position.
+
+@item \D'E @var{x} @var{y}'
+@cindex ellipse, filled, drawing (@samp{\D'E @dots{}'})
+@cindex drawing a filled ellipse (@samp{\D'E @dots{}'})
+@cindex filled ellipse, drawing (@samp{\D'E @dots{}'})
+@cindex ellipse, solid, drawing (@samp{\D'E @dots{}'})
+@cindex drawing a solid ellipse (@samp{\D'E @dots{}'})
+@cindex solid ellipse, drawing (@samp{\D'E @dots{}'})
+As @samp{\D'e @r{@dots{}}'}, but the ellipse is filled.
+
 @item \D'l @var{dx} @var{dy}'
-@cindex line, drawing (@w{@code{\D'l @dots{}'}})
-@cindex drawing a line (@w{@code{\D'l @dots{}'}})
-Draw a line from the current location to the relative point specified by
-(@var{dx},@var{dy}), where positive values mean right and down,
-respectively.  The end point of the line is the new current location.
-
-The following example is a macro for creating a box around a text
-string; for simplicity, the box margin is taken as a fixed value,
-0.2@dmn{m}.
+@cindex line, drawing (@samp{\D'l @dots{}'})
+@cindex drawing a line (@samp{\D'l @dots{}'})
+Draw line from the drawing position to (@var{h}, @var{v}).
+
+The following is a macro for drawing a box around a text argument; for
+simplicity, the box margin is a fixed at 0.2@dmn{m}.
 
 @Example
-.de BOX
+.de TEXTBOX
 .  nr @@wd \w'\\$1'
 \h'.2m'\
 \h'-.2m'\v'(.2m - \\nrsbu)'\
@@ -12287,100 +14149,44 @@
 @endExample
 
 @noindent
-First, the width of the string is stored in register @code{@@wd}.  Then,
-four lines are drawn to form a box, properly offset by the box margin.
-The registers @code{rst} and @code{rsb} are set by the @code{\w} escape,
-containing the largest height and depth of the whole string.
-
-@item \D'c @var{d}'
-@cindex circle, drawing (@w{@code{\D'c @dots{}'}})
-@cindex drawing a circle (@w{@code{\D'c @dots{}'}})
-Draw a circle with a diameter of@tie{}@var{d} with the leftmost point at
-the current position.  After drawing, the current location is positioned
-at the rightmost point of the circle.
-
-@item \D'C @var{d}'
-@cindex circle, solid, drawing (@w{@code{\D'C @dots{}'}})
-@cindex drawing a solid circle (@w{@code{\D'C @dots{}'}})
-@cindex solid circle, drawing (@w{@code{\D'C @dots{}'}})
-Draw a solid circle with the same parameters and behaviour as an
-outlined circle.  No outline is drawn.
-
-@item \D'e @var{x} @var{y}'
-@cindex drawing an ellipse (@w{@code{\D'e @dots{}'}})
-@cindex ellipse, drawing (@w{@code{\D'e @dots{}'}})
-Draw an ellipse with a horizontal diameter of @var{x} and a vertical
-diameter of @var{y} with the leftmost point at the current position.
-After drawing, the current location is positioned at the rightmost point
-of the ellipse.
-
-@item \D'E @var{x} @var{y}'
-@cindex ellipse, solid, drawing (@w{@code{\D'E @dots{}'}})
-@cindex drawing a solid ellipse (@w{@code{\D'E @dots{}'}})
-@cindex solid ellipse, drawing (@w{@code{\D'E @dots{}'}})
-Draw a solid ellipse with the same parameters and behaviour as an
-outlined ellipse.  No outline is drawn.
-
-@item \D'a @var{dx1} @var{dy1} @var{dx2} @var{dy2}'
-@cindex arc, drawing (@w{@code{\D'a @dots{}'}})
-@cindex drawing an arc (@w{@code{\D'a @dots{}'}})
-Draw an arc clockwise from the current location through the two
-specified relative locations (@var{dx1},@var{dy1}) and
-(@var{dx2},@var{dy2}).  The coordinates of the first point are relative
-to the current position, and the coordinates of the second point are
-relative to the first point.  After drawing, the current position is
-moved to the final point of the arc.
-
-@item \D'~ @var{dx1} @var{dy1} @var{dx2} @var{dy2} @dots{}'
-@cindex drawing a spline (@w{@code{\D'~ @dots{}'}})
-@cindex spline, drawing (@w{@code{\D'~ @dots{}'}})
-Draw a spline from the current location to the relative point
-(@var{dx1},@var{dy1}) and then to (@var{dx2},@var{dy2}), and so on.  The
-current position is moved to the terminal point of the drawn curve.
-
-@item \D'f @var{n}'
-@cindex gray shading (@w{@code{\D'f @dots{}'}})
-@cindex shading filled objects (@w{@code{\D'f @dots{}'}})
-Set the shade of gray to be used for filling solid objects
-to@tie{}@var{n}; @var{n}@tie{}must be an integer between 0
-and@tie{}1000, where 0 corresponds solid white and 1000 to solid black,
-and values in between correspond to intermediate shades of gray.  This
-applies only to solid circles, solid ellipses, and solid polygons.  By
-default, a level of 1000 is used.
-
-Despite of being silly, the current point is moved horizontally to the
-right by@tie{}@var{n}.
-
-@cindex @w{@code{\D'f @dots{}'}} and horizontal resolution
-Don't use this command!  It has the serious drawback that it is always
-rounded to the next integer multiple of the horizontal resolution (the
-value of the @code{hor} keyword in the @file{DESC} file).  Use @code{\M}
-(@pxref{Colors}) or @w{@code{\D'Fg @dots{}'}} instead.
-
-@item \D'p @var{dx1} @var{dy1} @var{dx2} @var{dy2} @dots{}'
-@cindex drawing a polygon (@w{@code{\D'p @dots{}'}})
-@cindex polygon, drawing (@w{@code{\D'p @dots{}'}})
-Draw a polygon from the current location to the relative position
-(@var{dx1},@var{dy1}) and then to (@var{dx2},@var{dy2}) and so on.  When
-the specified data points are exhausted, a line is drawn back to the
-starting point.  The current position is changed by adding the sum of
-all arguments with odd index to the actual horizontal position and the
-even ones to the vertical position.
+The argument is measured with the @code{\w} escape sequence.  Its width
+is stored in register @code{@@wd}.  @code{\w} also sets the registers
+@code{rst} and @code{rsb}; these contain its maximum vertical extents of
+the argument.  Then, four lines are drawn to form a box, offset by the
+box margin.
+
+@item \D'p @var{h1} @var{v1} @dots{} @var{hn} @var{vn}'
+@cindex polygon, stroked, drawing (@samp{\D'p @dots{}'})
+@cindex drawing a stroked polygon (@samp{\D'p @dots{}'})
+@cindex stroked polygon, drawing (@samp{\D'p @dots{}'})
+@cindex polygon, outlined, drawing (@samp{\D'p @dots{}'})
+@cindex drawing an outlined polygon (@samp{\D'p @dots{}'})
+@cindex outlined polygon, drawing (@samp{\D'p @dots{}'})
+Draw polygon with vertices at drawing position and each point in
+sequence.  GNU @code{troff} closes the polygon by drawing a line from
+(@var{hn}, @var{vn}) back to the initial drawing position.
+@c XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
+@c src/libs/libdriver/input.cpp.  It is neither the rightmost point
+@c of the figure nor the initial drawing position that GNU troff
+@c automatically returned to to close the figure.
+Afterward, the drawing position is left at (@var{hn}, @var{vn}).
 
 @item \D'P @var{dx1} @var{dy1} @var{dx2} @var{dy2} @dots{}'
-@cindex polygon, solid, drawing (@w{@code{\D'P @dots{}'}})
-@cindex drawing a solid polygon (@w{@code{\D'P @dots{}'}})
-@cindex solid polygon, drawing (@w{@code{\D'P @dots{}'}})
-Draw a solid polygon with the same parameters and behaviour as an
-outlined polygon.  No outline is drawn.
-
-Here a better variant of the box macro to fill the box with some color.
-Note that the box must be drawn before the text since colors in
-@code{gtroff} are not transparent; the filled polygon would hide the
-text completely.
+@cindex polygon, filled, drawing (@samp{\D'P @dots{}'})
+@cindex drawing a filled polygon (@samp{\D'P @dots{}'})
+@cindex filled polygon, drawing (@samp{\D'P @dots{}'})
+@cindex polygon, solid, drawing (@samp{\D'P @dots{}'})
+@cindex drawing a solid polygon (@samp{\D'P @dots{}'})
+@cindex solid polygon, drawing (@samp{\D'P @dots{}'})
+As @samp{\D'P @r{@dots{}}'}, but the polygon is filled.
+
+The following macro is like the @samp{\D'l'} example, but shades the
+box.  We draw the box before writing the text because colors in GNU
+@code{troff} have no transparency; in othe opposite order, the filled
+polygon would occlude the text.
 
 @Example
-.de BOX
+.de TEXTBOX
 .  nr @@wd \w'\\$1'
 \h'.2m'\
 \h'-.2m'\v'(.2m - \\nrsbu)'\
@@ -12396,208 +14202,282 @@
 ..
 @endExample
 
-If you want a filled polygon that has exactly the same size as an
-unfilled one, you must draw both an unfilled and a filled polygon.  A
-filled polygon is always smaller than an unfilled one because the latter
-uses straight lines with a given line thickness to connect the polygon's
-corners, while the former simply fills the area defined by the
-coordinates.
-
-@Example
-\h'1i'\v'1i'\
-\# increase line thickness
-\Z'\D't 5p''\
-\# draw unfilled polygon
-\Z'\D'p 3 3 -6 0''\
-\# draw filled polygon
-\Z'\D'P 3 3 -6 0''
-@endExample
-
 @item \D't @var{n}'
-@cindex line thickness (@w{@code{\D't @dots{}'}})
-@cindex thickness of lines (@w{@code{\D't @dots{}'}})
-Set the current line thickness to @var{n}@tie{}machine units.  A value
-of zero selects the smallest available line thickness.  A negative value
-makes the line thickness proportional to the current point size (this is
-the default behaviour of @acronym{AT&T} @code{troff}).
-
-Despite of being silly, the current point is moved horizontally to the
-right by@tie{}@var{n}.
-
-@item \D'F@var{scheme} @var{color_components}'
-@cindex unnamed fill colors (@code{\D'F@dots{}'})
-@cindex fill colors, unnamed (@code{\D'F@dots{}'})
-@cindex colors, fill, unnamed (@code{\D'F@dots{}'})
-Change current fill color.  @var{scheme} is a single letter denoting the
-color scheme: @samp{r} (rgb), @samp{c} (cmy), @samp{k} (cmyk), @samp{g}
-(gray), or @samp{d} (default color).  The color components use exactly
-the same syntax as in the @code{defcolor} request (@pxref{Colors}); the
-command @code{\D'Fd'} doesn't take an argument.
-
-@emph{No} position changing!
-
-Examples:
-
-@Example
-\D'Fg .3'      \" same gray as \D'f 700'
-\D'Fr #0000ff' \" blue
-@endExample
+@cindex line thickness (@samp{\D't @dots{}'})
+@cindex thickness of lines (@samp{\D't @dots{}'})
+Set the stroke thickness of geometric objects to @var{n} basic units.  A
+zero @var{n} selects the minimal supported thickness.  A negative
+@var{n} selects a thickness proportional to the type size; this is the
+default.
 @end table
 @endDefesc
+@c END Keep (roughly) parallel with subsection "Drawing commands" of
+@c groff(7).
 
-@xref{Graphics Commands}.
+In a hazy penumbra between text rendering and drawing commands we locate
+the bracket-building escape sequence, @code{\b}.  It can assemble
+apparently large glyphs by vertically stacking ordinary ones.
 
-@Defesc {\\b, ', string, '}
+@Defesc {\\b, @code{'}, contents, @code{'}}
 @cindex pile, glyph (@code{\b})
 @cindex glyph pile (@code{\b})
 @cindex stacking glyphs (@code{\b})
-@dfn{Pile} a sequence of glyphs vertically, and center it vertically on
-the current line.  Use it to build large brackets and braces.
-
-Here an example how to create a large opening brace:
+Pile and center a sequence of glyphs vertically on the output line.
+@dfn{Piling} stacks glyphs corresponding to each character in
+@var{contents}, read from left to right, and placed from top to bottom.
+GNU @code{troff} separates the glyphs vertically by 1@dmn{m}, and the
+pile itself is centered 0.5@dmn{m} above the text baseline.  The
+horizontal drawing position is then advanced by the width of the widest
+glyph in the pile.
+
+@cindex @code{\b}, limitations of
+@cindex limitations of @code{\b} escape sequence
+This rather inflexible positioning algorithm doesn't work with the
+@code{dvi} output device since its bracket pieces vary in height.
+Instead, use the @code{geqn} preprocessor.
+
+@ref{Manipulating Spacing} describes how to adjust the vertical spacing
+of the output line with the @code{\x} escape sequence.
+
+The application of @code{\b} that lends its name is construction of
+brackets, braces, and parentheses when typesetting mathematics.  We
+might construct a large opening (left) brace as follows.
 
 @Example
 \b'\lt\bv\lk\bv\lb'
 @endExample
 
-@cindex @code{\b}, limitations
-@cindex limitations of @code{\b} escape
-The first glyph is on the top, the last glyph in @var{string} is at the
-bottom.  Note that @code{gtroff} separates the glyphs vertically by
-1@dmn{m}, and the whole object is centered 0.5@dmn{m} above the current
-baseline; the largest glyph width is used as the width for the whole
-object.  This rather unflexible positioning algorithm doesn't work with
-@option{-Tdvi} since the bracket pieces vary in height for this device.
-Instead, use the @code{eqn} preprocessor.
-
-@xref{Manipulating Spacing}, how to adjust the vertical spacing with the
-@code{\x} escape.
+See @cite{groff_char@r{(7)}} for a list of special character
+identifiers.
 @endDefesc
 
 
 @c =====================================================================
 
-@node Traps, Diversions, Drawing Requests, gtroff Reference
+@node Deferring Output, Traps, Drawing Geometric Objects, GNU troff Reference
+@section Deferring Output
+@cindex deferred output
+
+@cindex environment
+@cindex diversion
+@cindex trap
+A few @code{roff} language elements are generally not used in simple
+documents, but arise as page layouts become more sophisticated and
+demanding.  @dfn{Environments} collect formatting parameters like line
+length and typeface.  A @dfn{diversion} stores formatted output for
+later use.  A @dfn{trap} is a condition on the input or output, tested
+automatically by the formatter, that is associated with a macro, causing
+it to be called when that condition is fulfilled.
+
+Footnote support often exercises all three of the foregoing features.  A
+simple implementation might work as follows.  A pair of macros is
+defined: one starts a footnote and the other ends it.  The author calls
+the first macro where a footnote marker is desired.  The macro
+establishes a diversion so that the footnote text is collected at the
+place in the body text where its corresponding marker appears.  An
+environment is created for the footnote so that it is set at a smaller
+typeface.  The footnote text is formatted in the diversion using that
+environment, but it does not yet appear in the output.  The document
+author calls the footnote end macro, which returns to the previous
+environment and ends the diversion.  Later, after much more body text in
+the document, a trap, set a small distance above the page bottom, is
+sprung.  The macro called by the trap draws a line across the page and
+emits the stored diversion.  Thus, the footnote is rendered.
+
+Diversions and traps make the text formatting process non-linear.  Let
+us imagine a set of text lines or paragraphs labelled @samp{A},
+@samp{B}, and so on.  If we set up a trap that produces text @samp{T}
+(as a page footer, say), and we also use a diversion to store the
+formatted text @samp{D}, then a document with input text in the order
+@samp{A B C D E F} might render as @samp{A B C E T F}.  The diversion
+@samp{D} will never be output if we do not call for it.
+
+Environments of themselves are not a source of non-linearity in document
+formatting:@: environment switches have immediate effect.  One could
+always write a macro to change as many formatting parameters as desired
+with a single convenient call.  But because diversions can be nested and
+macros called by traps that are sprung by other trap-called macros, they
+may be called upon in varying contexts.  For example, consider a page
+header that is always to be set in Helvetica.  A document that uses
+Times for most of its body text, but Courier for displayed code
+examples, poses a challenge if a page break occurs in the middle of a
+code display; if the header trap assumes that the ``previous font'' is
+always Times, the rest of the example will be formatted in the wrong
+typeface.  One could carefully save all formatting parameters upon
+entering the trap and restore them upon leaving it, but this is verbose,
+error-prone, and not future-proof as the @code{groff} language develops.
+Environments save us considerable effort.
+
+@c =====================================================================
+
+@need 1000
+@c BEGIN Keep (roughly) parallel with subsection "Traps" of groff(7).
+@node Traps, Diversions, Deferring Output, GNU troff Reference
 @section Traps
 @cindex traps
 
-@dfn{Traps} are locations that, when reached, call a specified macro.
-These traps can occur at a given location on the page, at a given
-location in the current diversion, at a blank line, after a certain
-number of input lines, or at the end of input.
-
+@dfn{Traps} are locations in the output or conditions on the input that,
+when reached or fulfilled, call a specified macro.  These traps can
+occur at a given location on the page, at a given location in the
+current diversion (together, these are known as @slanted{vertical
+position traps}), at a blank line, at a line with leading space
+characters, after a quantity of input lines, or at the end of input.
+Macros called by traps are passed no arguments.
 @cindex planting a trap
 @cindex trap, planting
-Setting a trap is also called @dfn{planting}.
+Setting a trap is also called @dfn{planting} one.
 @cindex trap, springing
 @cindex springing a trap
-It is also said that a trap is @dfn{sprung} if the associated macro is
-executed.
+It is said that a trap is @dfn{sprung} if its condition is fulfilled.
+@c END Keep (roughly) parallel with subsection "Traps" of groff(7).
 
 @menu
-* Page Location Traps::
+* Vertical Position Traps::
 * Diversion Traps::
 * Input Line Traps::
 * Blank Line Traps::
-* Leading Spaces Traps::
+* Leading Space Traps::
 * End-of-input Traps::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node Page Location Traps, Diversion Traps, Traps, Traps
-@subsection Page Location Traps
-@cindex page location traps
-@cindex traps, page location
-
-@dfn{Page location traps} perform an action when @code{gtroff} reaches
-or passes a certain vertical location on the page.  Page location traps
-have a variety of purposes, including:
-
-@itemize
-@item
-setting headers and footers
-
-@item
-setting body text in multiple columns
+@node Vertical Position Traps, Page Location Traps, Traps, Traps
+@subsection Vertical Position Traps
+@cindex vertical position traps
+@cindex traps, vertical position
+
+A @dfn{vertical position trap} calls a macro when the formatter's
+vertical drawing position reaches or passes, in the downward direction,
+a certain location on the output page or in a diversion.  Its
+applications include setting page headers and footers, body text in
+multiple columns, and footnotes.
 
-@item
-setting footnotes
-@end itemize
-
-@DefreqList {vpt, flag}
+@DefreqList {vpt, @Var{flag}}
 @DefregListEndx {.vpt}
 @cindex enabling vertical position traps (@code{vpt})
 @cindex vertical position traps, enabling (@code{vpt})
 @cindex vertical position trap enable register (@code{.vpt})
-Enable vertical position traps if @var{flag} is non-zero, or disables
-them otherwise.  Vertical position traps are traps set by the @code{wh}
-or @code{dt} requests.  Traps set by the @code{it} request are not
-vertical position traps.  The parameter that controls whether vertical
-position traps are enabled is global.  Initially vertical position traps
-are enabled.  The current setting of this is available in the
-@code{.vpt} read-only number register.
-
-Note that a page can't be ejected if @code{vpt} is set to zero.
+Enable vertical position traps if @var{flag} is non-zero or absent;
+disable them otherwise.  Vertical position traps are those set by the
+@code{wh} request or by @code{dt} within a diversion.  The parameter
+that controls whether vertical position traps are enabled is global.
+Initially, vertical position traps are enabled.  The current value is
+stored in the @code{.vpt} read-only register.
+
+@cindex page break, prevented by @code{vpt}
+@cindex break, page, prevented by @code{vpt}
+@cindex page ejection, prevented by @code{vpt}
+@cindex ejection, page, prevented by @code{vpt}
+A page can't be ejected if @code{vpt} is set to zero; see @ref{The
+Implicit Page Trap}.
 @endDefreq
 
-@Defreq {wh, dist @Var{macro}}
-Set a page location trap.  Non-negative values for @var{dist} set the
-trap relative to the top of the page; negative values set the trap
-relative to the bottom of the page.  Default scaling indicator is
-@samp{v}; values of @var{dist} are always rounded to be multiples of the
-vertical resolution (as given in register @code{.V}).
+@menu
+* Page Location Traps::
+* The Implicit Page Trap::
+* Diversion Traps::
+@end menu
+
+@c ---------------------------------------------------------------------
 
-@var{macro} is the name of the macro to execute when the trap is sprung.
-If @var{macro} is missing, remove the first trap (if any) at @var{dist}.
+@node Page Location Traps, The Implicit Page Trap, Vertical Position Traps, Vertical Position Traps
+@subsubsection Page Location Traps
+@cindex page location traps
+@cindex traps, page location
+
+A @dfn{page location trap} is a vertical position trap that applies to
+the page; that is, to undiverted output.  Many can be present; manage
+them with the @code{wh} and @code{ch} requests.
+
+@Defreq {wh, dist @Var{name}}
+Plant macro @var{name} as page location trap at @var{dist}.  The default
+scaling unit is @samp{v}.  Non-negative values for @var{dist} set the
+trap relative to the top of the page; negative values set the trap
+relative to the bottom of the page.  It is not possible to plant a trap
+less than one basic unit from the page bottom: a @var{dist} of @code{-0}
+is interpreted as @code{0}, the top of the page.@footnote{@xref{The
+Implicit Page Trap}.}  An existing @emph{visible} trap (see below) at
+@var{dist} is removed; this is @code{wh}'s sole function if @var{name}
+is missing.
+
+A trap is sprung only if it is @dfn{visible}, meaning that its location
+is reachable on the page@footnote{A trap planted at @samp{20i} or
+@samp{-30i} will not be sprung on a page of length @samp{11i}.} and it
+is not hidden by another trap at the same location already planted
+there.
 
+@need 1000
 @cindex page headers
 @cindex page footers
 @cindex headers
 @cindex footers
-The following is a simple example of how many macro packages set headers
-and footers.
+@cindex top margin
+@cindex margin, top
+@cindex bottom margin
+@cindex margin, bottom
+A macro package might set headers and footers as follows; this example
+configures vertical margins of one inch to the body text, and one
+half-inch to the titles.  Observe the use of the no-break control
+character with @code{sp} request to position our text baselines,
+and the page number character @samp{%} used with the @code{tl} request.
 
 @Example
-.de hd                \" Page header
+.\" hdfo.roff
+.de hd                  \" page header
+'  sp .5i
+'  tl '\\*(Ti''\\*(Da'  \" title and date strings
 '  sp .5i
-.  tl 'Title''date'
-'  sp .3i
 ..
-.
-.de fo                \" Page footer
-'  sp 1v
+.de fo                  \" page footer
+'  sp .5i
 .  tl ''%''
-'  bp
+.  bp
 ..
-.
-.wh 0   hd            \" trap at top of the page
-.wh -1i fo            \" trap one inch from bottom
+.wh 0   hd             \" trap at top of the page
+.wh -1i fo             \" trap 1 inch from bottom
 @endExample
 
-A trap at or below the bottom of the page is ignored; it can be made
-active by either moving it up or increasing the page length so that the
-trap is on the page.
+To use these traps, copy the above (or load it from a file with the
+@code{so} or @code{mso} requests), then set up the strings it uses.
 
-Negative trap values always use the @emph{current} page length; they are
-not converted to an absolute vertical position:
+@Example
+.so hdfo.roff
+.ds Ti Final Report\"
+.ds Da 21 May 2023\"
+.ti
+On 5 August of last year,
+this committee tasked me with the investigation of the
+CFIT (controlled flight into terrain) incident of
+.\" @i{...and so on...}
+@endExample
+
+A trap above the top or at or below the bottom of the page can be made
+visible by either moving it into the page area or increasing the page
+length so that the trap is on the page.  Negative trap values always use
+the @emph{current} page length; they are not converted to an absolute
+vertical position.
+@cindex page location traps, debugging
+@cindex debugging page location traps
+We can use the @code{ptr} request to dump our page location traps to the
+standard error stream (@pxref{Debugging}).  Their positions are reported
+in basic units; an @code{nroff} device example follows.
 
 @Example
 .pl 5i
 .wh -1i xx
 .ptr
-    @result{} xx      -240
+    @error{} xx      -240
 .pl 100i
 .ptr
-    @result{} xx      -240
+    @error{} xx      -240
 @endExample
 
-It is possible to have more than one trap at the same location; to do
-so, the traps must be defined at different locations, then moved
-together with the @code{ch} request; otherwise the second trap would
-replace the first one.  Earlier defined traps hide later defined traps
-if moved to the same position (the many empty lines caused by the
-@code{bp} request are omitted in the following example):
+It is possible to have more than one trap at the same location (although
+only one at a time can be visible); to achieve this, the traps must be
+defined at different locations, then moved to the same place with the
+@code{ch} request.  In the following example, the many empty lines
+caused by the @code{bp} request are not shown in the output.
 
 @Example
 .de a
@@ -12630,29 +14510,31 @@
 @endDefreq
 
 @Defreg {.t}
-@cindex distance to next trap register (@code{.t})
-@cindex trap, distance, register (@code{.t})
-A read-only number register holding the distance to the next trap.
-
-If there are no traps between the current position and the bottom of the
-page, it contains the distance to the page bottom.  In a diversion, the
-distance to the page bottom is infinite (the returned value is the
-biggest integer that can be represented in @code{groff}) if there are
-no diversion traps.
+@cindex distance to next vertical position trap register (@code{.t})
+@cindex trap, distance to next vertical position, register (@code{.t})
+The read-only register @code{.t} holds the distance to the next vertical
+position trap.  If there are no traps between the current position and
+the bottom of the page, it contains the distance to the page bottom.
+Within a diversion, in the absence of a diversion trap, this distance is
+the largest representable integer in basic units---effectively infinite.
 @endDefreg
 
-@Defreq {ch, macro @Var{dist}}
+@Defreq {ch, name @Var{dist}}
 @cindex changing trap location (@code{ch})
 @cindex trap, changing location (@code{ch})
-Change the location of a trap.  The first argument is the name of the
-macro to be invoked at the trap, and the second argument is the new
-location for the trap (note that the parameters are specified in
-opposite order as in the @code{wh} request).  This is useful for
-building up footnotes in a diversion to allow more space at the bottom
-of the page for them.
+Change the location of a trap by moving macro @var{name} to new location
+@var{dist}, or by unplanting it altogether if @var{dist} is absent.  The
+default scaling unit is @samp{v}.  Parameters to @code{ch} are specified
+in the opposite order from @code{wh}.  If @var{name} is the earliest
+planted macro of multiple traps at the same location, (re)moving it from
+that location exposes the macro next least recently planted at the same
+place.@footnote{It may help to think of each trap location as
+maintaining a queue; @code{wh} operates on the head of the queue, and
+@code{ch} operates on its tail.  Only the trap at the head of the queue
+is visible.}
 
-Default scaling indicator for @var{dist} is @samp{v}.  If @var{dist} is
-missing, the trap is removed.
+Changing a trap's location is useful for building up footnotes in a
+diversion to allow more space at the bottom of the page for them.
 
 @c XXX
 
@@ -12663,14 +14545,55 @@
 @end ignore
 @endDefreq
 
-@Defreg {.ne}
-The read-only number register @code{.ne} contains the amount of space
-that was needed in the last @code{ne} request that caused a trap to be
-sprung.  Useful in conjunction with the @code{.trunc} register.
-@xref{Page Control}, for more information.
+The same macro can be installed simultaneously at multiple locations;
+however, only the earliest-planted instance---that has not yet been
+deleted with @code{wh}---will be moved by @code{ch}.  The following
+example (using an @code{nroff} device) illustrates this behavior.  Blank
+lines have been elided from the output.
 
-Since the @code{.ne} register is only set by traps it doesn't make much
-sense to use it outside of trap macros.
+@Example
+.de T
+Trap sprung at \\n(nlu.
+.br
+..
+.wh 1i T
+.wh 2i T
+foo
+.sp 11i
+.bp
+.ch T 4i
+bar
+.sp 11i
+.bp
+.ch T 5i
+baz
+.sp 11i
+.bp
+.wh 5i
+.ch T 6i
+qux
+.sp 11i
+@endExample
+@Example
+    @result{} foo
+    @result{} Trap sprung at 240u.
+    @result{} Trap sprung at 480u.
+    @result{} bar
+    @result{} Trap sprung at 480u.
+    @result{} Trap sprung at 960u.
+    @result{} baz
+    @result{} Trap sprung at 480u.
+    @result{} Trap sprung at 1200u.
+    @result{} qux
+    @result{} Trap sprung at 1440u.
+@endExample
+
+@Defreg {.ne}
+The read-only register @code{.ne} contains the amount of space that was
+needed in the last @code{ne} request that caused a trap to be sprung;
+it is useful in conjunction with the @code{.trunc} register.  @xref{Page
+Control}.  Since the @code{.ne} register is set only by traps, it
+doesn't make sense to interpolate it outside of macros called by traps.
 @endDefreg
 
 @Defreg {.trunc}
@@ -12683,71 +14606,102 @@
 request.  In other words, at the point a trap is sprung, it
 represents the difference of what the vertical position would have
 been but for the trap, and what the vertical position actually is.
-
-Since the @code{.trunc} register is only set by traps it doesn't make
-much sense to use it outside of trap macros.
+Since the @code{.trunc} register is set only by traps, it doesn't make
+sense to interpolate it outside of macros called by traps.
 @endDefreg
 
 @Defreg {.pe}
 @cindex @code{bp} request, and traps (@code{.pe})
 @cindex traps, sprung by @code{bp} request (@code{.pe})
-@cindex page ejecting register (@code{.pe})
-A read-only register that is set to@tie{}1 while a page is ejected with
-the @code{bp} request (or by the end of input).
+@cindex page ejection status register (@code{.pe})
+This Boolean-valued, read-only register interpolates@tie{}1 while a page
+is being ejected, and 0@tie{}otherwise.
 
-Outside of traps this register is always zero.  In the following
-example, only the second call to@tie{}@code{x} is caused by @code{bp}.
+In the following example, we plant the same trap at the top and the
+bottom of the page.  We also make the trap report its name and the
+vertical drawing position.
 
 @Example
-.de x
-\&.pe=\\n.pe
-.br
+.de T
+.tm \\$0: page \\n%, nl=\\nnl .pe=\\n.pe
 ..
-.wh 1v x
-.wh 4v x
-A line.
-.br
-Another line.
-.br
-    @result{} A line.
-       .pe=0
-       Another line.
-
-       .pe=1
+.ll 46n
+.wh 0 T
+.wh -1v T
+Those who can make you believe absurdities can make you
+commit atrocities. \em Voltaire
+    @error{} T: page 1, nl=0 .pe=0
+    @error{} T: page 1, nl=2600 .pe=1
+    @result{} Those who can make you believe absurdities can
+    @result{} make you commit atrocities. -- Voltaire
 @endExample
 @endDefreg
 
 @cindex diversions, and traps
 @cindex traps, and diversions
-An important fact to consider while designing macros is that diversions
-and traps do not interact normally.  For example, if a trap invokes a
-header macro (while outputting a diversion) that tries to change the
-font on the current page, the effect is not visible before the diversion
-has completely been printed (except for input protected with @code{\!}
-or @code{\?}) since the data in the diversion is already formatted.  In
-most cases, this is not the expected behaviour.
+When designing macros, keep in mind that diversions and traps do
+normally interact.  For example, if a trap calls a header macro (while
+outputting a diversion) that tries to change the font on the current
+page, the effect is not visible before the diversion has completely been
+printed (except for input protected with @code{\!} or @code{\?}) since
+the data in the diversion is already formatted.  In most cases, this is
+not the expected behaviour.
+
+@c ---------------------------------------------------------------------
+
+@c BEGIN Keep (roughly) parallel with subsection "The implicit page
+@c trap" of groff(7).
+@node The Implicit Page Trap, Diversion Traps, Page Location Traps, Vertical Position Traps
+@subsubsection The Implicit Page Trap
+@cindex implicit trap
+@cindex trap, implicit
+
+@cindex page break
+@cindex break, page
+@cindex page ejection
+@cindex ejection, page
+If, after starting GNU @code{troff} without loading a macro package, you
+use the @code{ptr} request to dump a list of the active traps to the
+standard error stream,@footnote{@xref{Debugging}.}  nothing is reported.
+Yet the @code{.t} register will report a steadily decreasing value with
+every output line your document produces, and once the value of
+@code{.t} gets to within @code{.V} of zero, you will notice that
+something trap-like happens---the page is ejected, a new one begins, and
+the value of @code{.t} becomes large once more.
+
+This @dfn{implicit page trap} always exists in the top-level
+diversion;@footnote{@xref{Diversions}.} it works like a trap in some
+ways but not others.  Its purpose is to eject the current page and start
+the next one.  It has no name, so it cannot be moved or deleted with
+@code{wh} or @code{ch} requests.  You cannot hide it by placing another
+trap at its location, and can move it only by redefining the page length
+with @code{pl}.  Its operation is suppressed when vertical page traps
+are disabled with GNU @code{troff}'s @code{vpt} request.
+@c END Keep (roughly) parallel with subsection "The implicit trap" of
+@c groff(7).
 
 @c ---------------------------------------------------------------------
 
-@node Diversion Traps, Input Line Traps, Page Location Traps, Traps
-@subsection Diversion Traps
+@node Diversion Traps, Input Line Traps, The Implicit Page Trap, Vertical Position Traps
+@subsubsection Diversion Traps
 @cindex diversion traps
 @cindex traps, diversion
 
-@Defreq {dt, @Var{dist} @Var{macro}}
+A diversion is not formatted in the context of a page, so it lacks page
+location traps; instead it can have a @dfn{diversion trap}.  There can
+exist at most one such vertical position trap per diversion.
+
+@Defreq {dt, @Var{dist} @Var{name}}
 @cindex @code{.t} register, and diversions
 @cindex setting diversion trap (@code{dt})
 @cindex diversion trap, setting (@code{dt})
 @cindex trap, diversion, setting (@code{dt})
-Set a trap @emph{within} a diversion.  @var{dist} is the location of the
-trap (identical to the @code{wh} request; default scaling indicator is
-@samp{v}) and @var{macro} is the name of the macro to be invoked.  If
-called without arguments, the diversion trap is removed.
-
-Note that there exists only a single diversion trap.
-
-The number register @code{.t} still works within diversions.
-@xref{Diversions}, for more information.
+Set a trap @emph{within} a diversion at location @var{dist}, which is
+interpreted relative to diversion rather than page boundaries.  If invoked with
+fewer than two arguments, any diversion trap in the current diversion is
+removed.  The register @code{.t} works within diversions.  It is an
+error to invoke @code{dt} in the top-level diversion.
+@xref{Diversions}.
 @endDefreq
 
 @c ---------------------------------------------------------------------
@@ -12757,105 +14711,200 @@
 @cindex input line traps
 @cindex traps, input line
 
-@DefreqList {it, n macro}
-@DefreqListEndx {itc, n macro}
-@cindex setting input line trap (@code{it})
-@cindex input line trap, setting (@code{it})
-@cindex trap, input line, setting (@code{it})
-Set an input line trap.  @var{n}@tie{}is the number of lines of input
-that may be read before springing the trap, @var{macro} is the macro to
-be invoked.  Request lines are not counted as input lines.
-
-For example, one possible use is to have a macro that prints the next
-@var{n}@tie{}lines in a bold font.
-
-@Example
-.de B
-.  it \\$1 B-end
-.  ft B
+@DefreqList {it, @Var{n} @Var{name}}
+@DefreqListEndx {itc, @Var{n} @Var{name}}
+@cindex setting input line trap (@code{it}, @code{itc})
+@cindex input line trap, setting (@code{it}, @code{itc})
+@cindex trap, input line, setting (@code{it}, @code{itc})
+@cindex clearing input line trap (@code{it}, @code{itc})
+@cindex input line trap, clearing (@code{it}, @code{itc})
+@cindex trap, input line, clearing (@code{it}, @code{itc})
+Set an input line trap, calling macro @var{name} after processing the
+next @var{n}@tie{}productive input lines (recall @ref{Manipulating
+Filling and Adjustment}).  Any existing input line trap in the
+environment is replaced.  Without arguments, @code{it} and @code{itc}
+clear any input line trap that has not yet sprung.
+
+Consider a macro @samp{.ST @var{s n}} which sets the next
+@var{n}@tie{}input lines in the font style@tie{}@var{s}.
+
+@Example
+.de ST \" Use style $1 for next $2 text lines.
+.  it \\$2 ES
+.  ft \\$1
 ..
-.
-.de B-end
+.de ES \" end ST
 .  ft R
 ..
+.ST I 1
+oblique
+face
+.ST I 1
+oblique\c
+face
+    @result{} @i{oblique} face @i{oblique}face @
+@r{(second ``face'' upright)}
 @endExample
 
 @cindex input line traps and interrupted lines (@code{itc})
 @cindex interrupted lines and input line traps (@code{itc})
 @cindex traps, input line, and interrupted lines (@code{itc})
 @cindex lines, interrupted, and input line traps (@code{itc})
-The @code{itc} request is identical except that an interrupted text line
-(ending with @code{\c}) is not counted as a separate line.
+Unlike the @code{ce} and @code{rj} requests, @code{it} counts lines
+interrupted with the @code{\c} escape sequence separately (@pxref{Line
+Continuation}); @code{itc} does not.  To see the difference, let's
+change the previous example to use @code{itc} instead.
+
+@Example
+@r{@dots{}}
+.  itc \\$2 ES
+@r{@dots{}}
+    @result{} @i{oblique} face @i{obliqueface} @
+@r{(second ``face'' oblique)}
+@endExample
+
+You can think of the @code{ce} and @code{rj} requests as implicitly
+creating an input line trap with @code{itc} that schedules a break when
+the trap is sprung.
 
-Both requests are associated with the current environment
-(@pxref{Environments}); switching to another environment disables the
-current input trap, and going back reactivates it, restoring the number
-of already processed lines.
+@Example
+.de BR
+.  br
+.  @slanted{internal: disable centering-without-filling}
+..
+.
+.de ce
+.  if \\n.br .br
+.  itc \\$1 BR
+.  @slanted{internal: enable centering-without-filling}
+..
+@endExample
+
+@need 500
+Let us consider in more detail the sorts of input lines that are or are
+not ``productive''.
+
+@Example
+.de Trap
+TRAP SPRUNG
+..
+.de Mac
+.if r a \l'5n'
+..
+.it 2 Trap
+.
+foo
+.Mac
+bar
+baz
+.it 1 Trap
+.sp \" moves, but does not write or draw
+qux
+.itc 1 Trap
+\h'5n'\c \" moves, but does not write or draw
+jat
+@endExample
+
+@noindent
+When @samp{Trap} gets called depends on whether the @samp{a} register is
+defined; the control line with the @code{if} request may or may not
+produce written output.  We also see that the spacing request @code{sp},
+while certainly affecting the output, does not spring the input line
+trap.  Similarly, the horizontal motion escape sequence @code{\h} also
+affected the output, but was not ``written''.  Observe that we had to
+follow it with @code{\c} and use @code{itc} to prevent the newline at
+the end of the text line from causing a word break, which, like an
+ordinary space character, counts as written output.
+
+@Example
+$ groff -Tascii input-trap-example.groff
+    @result{} foo bar TRAP SPRUNG baz
+    @result{}
+    @result{} qux TRAP SPRUNG      jat TRAP SPRUNG
+$ groff -Tascii -ra1 input-trap-example.groff
+    @result{} foo _____ TRAP SPRUNG bar baz
+    @result{}
+    @result{} qux TRAP SPRUNG      jat TRAP SPRUNG
+@endExample
 @endDefreq
 
+Input line traps are associated with the environment
+(@pxref{Environments}); switching to another environment suspends the
+current input line trap, and going back resumes it, restoring the count
+of qualifying lines enumerated in that environment.
+
 @c ---------------------------------------------------------------------
 
-@node Blank Line Traps, Leading Spaces Traps, Input Line Traps, Traps
+@node Blank Line Traps, Leading Space Traps, Input Line Traps, Traps
 @subsection Blank Line Traps
 @cindex blank line traps
 @cindex traps, blank line
 
-@Defreq {blm, macro}
+@Defreq {blm, @Var{name}}
 @cindex blank line macro (@code{blm})
-Set a blank line trap.  @code{gtroff} executes @var{macro} when it
-encounters a blank line in the input file.
+Set a blank line trap, calling the macro @var{name} when GNU
+@code{troff} encounters a blank line in an input file, instead of the
+usual behavior (@pxref{Breaking}).  A line consisting only of spaces is
+also treated as blank and subject to this trap.  If no argument is
+supplied, the default blank line behavior is (re-)established.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node Leading Spaces Traps, End-of-input Traps, Blank Line Traps, Traps
-@subsection Leading Spaces Traps
-@cindex leading spaces traps
-@cindex traps, leading spaces
+@node Leading Space Traps, End-of-input Traps, Blank Line Traps, Traps
+@subsection Leading Space Traps
+@cindex leading space traps
+@cindex traps, leading space
 
-@DefreqList {lsm, macro}
+@DefreqList {lsm, @Var{name}}
 @DefregItemx {lsn}
 @DefregListEndx {lss}
 @cindex leading spaces macro (@code{lsm})
-Set a leading spaces trap.  @code{gtroff} executes @var{macro} when it
-encounters leading spaces in an input line; the implicit line break
-that normally happens in this case is suppressed.  A line consisting
-of spaces only, however, is treated as an empty line, possibly subject
-to an empty line macro set with the @code{blm} request.
-
-Leading spaces are removed from the input line before calling the
-leading spaces macro.  The number of removed spaces is stored in
-register @code{lsn}; the horizontal space that would be emitted if
-there was no leading space macro is stored in register @code{lss}.
-Note that @code{lsn} and @code{lss} are available even if no leading
-space macro has been set.
-
-The first thing a leading space macro sees is a token.  However, some
-escapes like @code{\f} or @code{\m} are handled on the fly (see
-@ref{Gtroff Internals}, for a complete list) without creating a token
-at all.  Consider that a line starts with two spaces followed by
-@code{\fIfoo}.  While skipping the spaces @code{\fI} is handled too so
-that groff's current font is properly set to @samp{I}, but the leading
-space macro only sees @code{foo}, without the preceding @code{\fI}.
-If the macro should see the font escape you have to `protect' it with
-something that creates a token, for example with @code{\&\fIfoo}.
+Set a leading space trap, calling the macro @var{name} when GNU
+@code{troff} encounters leading spaces in an input line; the implicit
+line break that normally happens in this case is suppressed.  If no
+argument is supplied, the default leading space behavior is
+(re-)established (@pxref{Breaking}).
+
+The count of leading spaces on an input line is stored in register
+@code{lsn}, and the amount of corresponding horizontal motion in
+register @code{lss}, irrespective of whether a leading space trap is
+set.  When it is, the leading spaces are removed from the input line,
+and no motion is produced before calling @var{name}.
+
+@c XXX The following discussion does not seem to be correct; leading
+@c space traps don't "see" _any_ input tokens.  Nothing on the line is
+@c passed to it as arguments, and tokens after leading spaces are
+@c processed normally after the designated macro is interpolated. XXX
+@c
+@c The first thing a leading space macro sees is a token.  However, some
+@c escape sequences, like @code{\f} and @code{\m}, are handled on the
+@c fly (@pxref{Gtroff Internals} for a complete list) without creating a
+@c token at all.  Consider a line that starts with two spaces followed
+@c by @samp{\fIfoo}.  After skipping the spaces, @samp{\fI} is handled
+@c as well such that @code{groff}'s current font is set to @code{I}, but
+@c the leading space macro sees only @samp{foo} without the preceding
+@c @samp{\fI}.  If the macro should see the font escape, you have to
+@c ``protect'' it with something that creates a token, like the
+@c dummy character; for example, @samp{\&\fIfoo}.
 @endDefreq
 
 @c ---------------------------------------------------------------------
 
-@node End-of-input Traps,  , Leading Spaces Traps, Traps
+@node End-of-input Traps,  , Leading Space Traps, Traps
 @subsection End-of-input Traps
 @cindex end-of-input traps
 @cindex traps, end-of-input
 
-@Defreq {em, macro}
+@Defreq {em, @Var{name}}
 @cindex setting end-of-input trap (@code{em})
 @cindex end-of-input trap, setting (@code{em})
 @cindex trap, end-of-input, setting (@code{em})
 @cindex end-of-input macro (@code{em})
 @cindex macro, end-of-input (@code{em})
-Set a trap at the end of input.  @var{macro} is executed after the last
-line of the input file has been processed.
+Set a trap at the end of input, calling macro @var{name} after the last
+line of the last input file has been processed.  If no argument is
+given, any existing end-of-input trap is removed.
 
 For example, if the document had to have a section at the bottom of the
 last page for someone to approve it, the @code{em} request could be
@@ -12878,28 +14927,37 @@
 @endExample
 
 The @code{\c} in the above example needs explanation.  For historical
-reasons (and for compatibility with @acronym{AT&T} @code{troff}), the
-end macro exits as soon as it causes a page break and no remaining
-data is in the partially collected line.
-
+reasons (compatibility with @acronym{AT&T} @code{troff}), the
+end-of-input macro exits as soon as it causes a page break if no
+partially collected line remains.@footnote{While processing an
+end-of-input macro, the formatter assumes that the next page break must
+be the last; it goes into ``sudden death overtime''.}
+
+@cindex page break, final
+@cindex break, page, final
+@cindex page ejection, of final page
+@cindex ejection, page, of final page
 Let us assume that there is no @code{\c} in the above @code{approval}
-macro, and that the page is full and has been ended with, say, a
-@code{br} request.  The @code{ne} request now causes the start of a new
-page, which in turn makes @code{troff} exit immediately for the reasons
-just described.  In most situations this is not intended.
-
-To always force processing the whole end macro independently of this
-behaviour it is thus advisable to insert something that starts an
-empty partially filled line (@code{\c}) whenever there is a chance that
-a page break can happen.  In the above example, the call of the
-@code{ne} request assures that the remaining code stays on the same
-page, so we have to insert @code{\c} only once.
-
-The next example shows how to append three lines, then starting a new
-page unconditionally.  Since @w{@samp{.ne 1}} doesn't give the desired
-effect -- there is always one line available or we are already at the
-beginning of the next page -- we temporarily increase the page length
-by one line so that we can use @w{@samp{.ne 2}}.
+macro, that the page is full, and last output line has been broken with,
+say, a @code{br} request.  Because there is no more room, a @code{ne}
+request at this point causes a page ejection, which in turn makes
+@code{troff} exit immediately as just described.  In most situations,
+this is not desired; people generally want to format the input after
+@code{ne}.
+
+To force processing of the whole end-of-input macro independently of
+this behavior, it is thus advisable to (invisibly) ensure the existence
+of a partially collected line (@code{\c}) whenever there is a chance
+that a page break can happen.  In the above example, invoking the
+@code{ne} request ensures that there is room for the subsequent
+formatted output on the same page, so we need insert @code{\c} only
+once.
+
+The next example shows how to append three lines, then start a new page
+unconditionally.  Since @w{@samp{.ne 1}} doesn't give the desired
+effect---there is always one line available or we are already at the
+beginning of the next page---we temporarily increase the page length by
+one line so that we can use @w{@samp{.ne 2}}.
 
 @Example
 .de EM
@@ -12923,21 +14981,25 @@
 .em EM
 @endExample
 
-Note that this specific feature affects only the first potential page
-break caused by the end macro; further page breaks emitted by the end
-macro are handled normally.
-
-Another possible use of the @code{em} request is to make @code{gtroff}
-emit a single large page instead of multiple pages.  For example, one
-may want to produce a long plain-text file for reading on-screen.  The
-idea is to set the page length at the beginning of the document to a
-very large value to hold all the text, and automatically adjust it to
-the exact height of the document after the text has been output.
+This specific feature affects only the first potential page break caused
+by the end-of-input macro; further page breaks emitted by the macro are
+handled normally.
+
+Another possible use of the @code{em} request is to make GNU
+@code{troff} emit a single large page instead of multiple pages.  For
+example, one may want to produce a long plain text file for reading
+in a terminal or emulator without page footers and headers interrupting
+the body of the document.  One approach is to set the page length at the
+beginning of the document to a very large value to hold all the
+text,@footnote{Another, taken by the @code{groff} @code{man} macros, is
+to intercept @code{ne} requests and wrap @code{bp} ones.} and
+automatically adjust it to the exact height of the document after the
+text has been output.
 
 @Example
 .de adjust-page-length
 .  br
-.  pl \\nnlu \" \nnl holds the current vert. position
+.  pl \\nnlu \" \nnl: current vertical position
 ..
 .
 .de single-page-mode
@@ -12945,82 +15007,77 @@
 .  em adjust-page-length
 ..
 .
-.\" activate the above code
-.single-page-mode
+.\" Activate the above code if configured.
+.if \ndo-continuous-rendering \
+.  single-page-mode
 @endExample
 
-Since only one end-of-input trap does exist and other macro packages
-may already use it, care must be taken not to break the mechanism.  A
-simple solution would be to append the above macro to the macro
-package's end-of-input macro using the @code{.am} request.
+Since only one end-of-input trap exists and another macro package may
+already use it, care must be taken not to break the mechanism.  A simple
+solution would be to append the above macro to the macro package's
+end-of-input macro using the @code{am} request.
 @endDefreq
 
 
 @c =====================================================================
 
-@node Diversions, Environments, Traps, gtroff Reference
+@c BEGIN Keep (roughly) parallel with subsection "Diversions" of
+@c groff(7).
+@node Diversions, Punning Names, Traps, GNU troff Reference
 @section Diversions
 @cindex diversions
 
-In @code{gtroff} it is possible to @dfn{divert} text into a named
-storage area.  Due to the similarity to defining macros it is sometimes
-said to be stored in a macro.  This is used for saving text for output
-at a later time, which is useful for keeping blocks of text on the same
-page, footnotes, tables of contents, and indices.
-
+In @code{roff} systems it is possible to format text as if for output,
+but instead of writing it immediately, one can @dfn{divert} the
+formatted text into a named storage area.  It is retrieved later by
+specifying its name after a control character.   The same name space is
+used for such @slanted{diversions} as for strings and macros; see
+@ref{Identifiers}.  Such text is sometimes said to be ``stored in a
+macro'', but this coinage obscures the important distinction between
+macros and strings on one hand and diversions on the other; the former
+store @emph{unformatted} input text, and the latter capture
+@emph{formatted} output.  Diversions also do not interpret arguments.
+Applications of diversions include ``keeps'' (preventing a page break
+from occurring at an inconvenient place by forcing a set of output lines
+to be set as a group), footnotes, tables of contents, and indices.
 @cindex top-level diversion
 @cindex diversion, top-level
-For orthogonality it is said that @code{gtroff} is in the @dfn{top-level
-diversion} if no diversion is active (i.e., the data is diverted to the
-output device).
-
-Although the following requests can be used to create diversions,
-simply using an undefined diversion will cause it to be defined as empty.
-@xref{Identifiers}.
-
-@DefreqList {di, macro}
-@DefreqListEndx {da, macro}
-@cindex beginning diversion (@code{di})
-@cindex diversion, beginning (@code{di})
-@cindex ending diversion (@code{di})
-@cindex diversion, ending (@code{di})
-@cindex appending to a diversion (@code{da})
-@cindex diversion, appending (@code{da})
-Begin a diversion.  Like the @code{de} request, it takes an argument of
-a macro name to divert subsequent text into.  The @code{da} macro
-appends to an existing diversion.
-
-@code{di} or @code{da} without an argument ends the diversion.
-
-The current partially filled line is included into the diversion.  See
-the @code{box} request below for an example.  Note that switching to
-another (empty) environment (with the @code{ev} request) avoids the
-inclusion of the current partially filled line.
-@endDefreq
-
-@DefreqList {box, macro}
-@DefreqListEndx {boxa, macro}
-Begin (or append to) a diversion like the @code{di} and @code{da}
-requests.  The difference is that @code{box} and @code{boxa} do not
-include a partially filled line in the diversion.
-
-Compare this:
-
-@Example
-Before the box.
-.box xxx
-In the box.
-.br
-.box
-After the box.
-.br
-    @result{} Before the box.  After the box.
-.xxx
-    @result{} In the box.
-@endExample
-
-@noindent
-with this:
+For orthogonality it is said that GNU @code{troff} is in the
+@dfn{top-level diversion} if no diversion is active (that is, formatted
+output is being ``diverted'' immediately to the output device).
+
+Dereferencing an undefined diversion will create an empty one of that
+name and cause a warning in category @samp{mac} to be emitted.
+@xref{Warnings}, for information about the enablement and suppression of
+warnings.  A diversion does not exist for the purpose of testing with
+the @code{d} conditional operator until its initial definition ends
+(@pxref{Operators in Conditionals}).  The following requests are used to
+create and alter diversions.
+@c END Keep (roughly) parallel with subsection "Diversions" of groff(7).
+
+@DefreqList {di, @Var{name}}
+@DefreqListEndx {da, @Var{name}}
+@cindex beginning diversion (@code{di}, @code{box})
+@cindex diversion, beginning (@code{di}, @code{box})
+@cindex ending diversion (@code{di}, @code{box})
+@cindex diversion, ending (@code{di}, @code{box})
+@cindex appending to a diversion (@code{da}, @code{boxa})
+@cindex diversion, appending to (@code{da}, @code{boxa})
+Start collecting formatted output in a diversion called @var{name}.  The
+@code{da} request appends to a diversion called @var{name}, creating it
+if necessary.  If @var{name} already exists as an alias, the target of
+the alias is replaced or appended to; recall @ref{Strings}.  The pending
+output line is diverted as well.  Switching to another environment (with
+the @code{ev} request) before invoking @code{di} or @code{da} avoids
+including any pending output line in the diversion; see
+@ref{Environments}.
+
+Invoking @code{di} or @code{da} without an argument stops diverting
+output to the diversion named by the most recent corresponding request.
+If @code{di} or @code{da} is called without an argument when there is no
+current diversion, a warning in category @samp{di} is produced.
+@xref{Warnings}, for information about the enablement and suppression
+of warnings.
 
 @Example
 Before the diversion.
@@ -13034,10 +15091,39 @@
 .yyy
     @result{} Before the diversion.  In the diversion.
 @endExample
+@endDefreq
 
-@code{box} or @code{boxa} without an argument ends the diversion.
+@cindex box (diversion operation)
+GNU @code{troff} supports @dfn{box} requests to exclude a partially
+collected line from a diversion, as this is often desirable.
+
+@DefreqList {box, @Var{name}}
+@DefreqListEndx {boxa, @Var{name}}
+Divert (or append) output to @var{name}, similarly to the @code{di} and
+@code{da} requests, respectively.  Any pending output line is @emph{not}
+included in the diversion.  Without an argument, stop diverting output;
+any pending output line inside the diversion is discarded.
+
+@Example
+Before the box.
+.box xxx
+In the box.
+.br
+Hidden treasure.
+.box
+After the box.
+.br
+    @result{} Before the box.  After the box.
+.xxx
+    @result{} In the box.
+@endExample
 @endDefreq
 
+Apart from pending output line inclusion and the request names that
+populate them, boxes are handled exactly as diversions are.  All of the
+following @code{groff} language elements can be used with them
+interchangeably.
+
 @DefregList {.z}
 @DefregListEndx {.d}
 @cindex @code{nl} register, and @code{.d}
@@ -13047,11 +15133,11 @@
 @cindex vertical position in diversion register (@code{.d})
 @cindex position, vertical, in diversion, register (@code{.d})
 @cindex diversion, vertical position in, register (@code{.d})
-Diversions may be nested.  The read-only number register @code{.z}
-contains the name of the current diversion (this is a string-valued
-register).  The read-only number register @code{.d} contains the current
-vertical place in the diversion.  If not in a diversion it is the same
-as register @code{nl}.
+Diversions may be nested.  The read-only string-valued register
+@code{.z} contains the name of the current diversion.  The read-only
+register @code{.d} contains the current vertical place in the diversion.
+If the input text is not being diverted, @code{.d} reports the same
+location as the register @code{nl}.
 @endDefreg
 
 @Defreg {.h}
@@ -13059,9 +15145,10 @@
 @cindex mark, high-water, register (@code{.h})
 @cindex position of lowest text line (@code{.h})
 @cindex text line, position of lowest (@code{.h})
-The @dfn{high-water mark} on the current page or in the current
-diversion.  It corresponds to the text baseline of the lowest line
-on the page.  This is a read-only register.
+The read-only register @code{.h} stores the @dfn{high-water mark} on the
+current page or in the current diversion.  It corresponds to the text
+baseline of the lowest line on the page.@footnote{Thus, the ``water''
+gets ``higher'' proceeding @emph{down} the page.}
 
 @Example
 .tm .h==\n.h, nl==\nnl
@@ -13073,11 +15160,12 @@
     @result{} .h==40, nl==120
 @endExample
 
-@cindex @code{.h} register, difference to @code{nl}
-@cindex @code{nl} register, difference to @code{.h}
+@cindex @code{.h} register, difference from @code{nl}
+@cindex @code{nl} register, difference from @code{.h}
 @noindent
-As can be seen in the previous example, empty lines are not considered
-in the return value of the @code{.h} register.
+As implied by the example, vertical motion does not produce text
+baselines and thus does not increase the value interpolated by
+@samp{\n.h}.
 @endDefreg
 
 @DefregList {dn}
@@ -13086,20 +15174,20 @@
 @cindex @code{dl} register, and @code{da} (@code{boxa})
 @cindex @code{da} request, and @code{dn} (@code{dl})
 @cindex @code{boxa} request, and @code{dn} (@code{dl})
-After completing a diversion, the read-write number registers @code{dn}
-and @code{dl} contain the vertical and horizontal size of the diversion.
-Note that only the just processed lines are counted: For the computation
-of @code{dn} and @code{dl}, the requests @code{da} and @code{boxa} are
-handled as if @code{di} and @code{box} had been used -- lines that have
-been already stored in a macro are not taken into account.
+After completing a diversion, the writable registers @code{dn} and
+@code{dl} contain its vertical and horizontal sizes.  Only the lines
+just processed are counted: for the computation of @code{dn} and
+@code{dl}, the requests @code{da} and @code{boxa} are handled as if
+@code{di} and @code{box} had been used, respectively---lines that have
+been already stored in the diversion (box) are not taken into account.
 
 @Example
-.\" Center text both horizontally & vertically
+.\" Center text both horizontally and vertically.
+.\" Macro .(c starts centering mode; .)c terminates it.
 .
-.\" Enclose macro definitions in .eo and .ec
-.\" to avoid the doubling of the backslash
+.\" Disable the escape character with .eo so that we
+.\" don't have to double backslashes on the "\n"s.
 .eo
-.\" macro .(c starts centering mode
 .de (c
 .  br
 .  ev (c
@@ -13110,7 +15198,6 @@
 ..
 @endExample
 @Example
-.\" macro .)c terminates centering mode
 .de )c
 .  br
 .  ev
@@ -13126,38 +15213,31 @@
 .  rr @@s
 .  rm @@c
 ..
-.\" End of macro definitions, restore escape mechanism
 .ec
 @endExample
 @endDefreg
 
-@DefescList {\\!, , , }
+@DefescList {\\!, , anything, }
 @DefescListEndx {\\?, , anything, \\?}
 @cindex transparent output (@code{\!}, @code{\?})
 @cindex output, transparent (@code{\!}, @code{\?})
-Prevent requests, macros, and escapes from being interpreted when read
-into a diversion.  Both escapes take the given text and
-@dfn{transparently} embed it into the diversion.  This is useful for
-macros that shouldn't be invoked until the diverted text is actually
-output.
-
-The @code{\!} escape transparently embeds text up to and including the
-end of the line.  The @code{\?} escape transparently embeds text until
-the next occurrence of the @code{\?} escape.  Example:
-
-@Example
-\?@var{anything}\?
-@endExample
-
-@cindex @code{\?}, and copy-in mode
-@cindex copy-in mode, and @code{\?}
-@cindex mode, copy-in, and @code{\?}
-@cindex @code{\!}, and copy-in mode
-@cindex copy-in mode, and @code{\!}
-@cindex mode, copy-in, and @code{\!}
+@dfn{Transparently} embed @var{anything} into the current diversion,
+preventing requests, macro calls, and escape sequences from being
+interpreted when read into a diversion.  This is useful for preventing
+them from taking effect until the diverted text is actually output.  The
+@code{\!} escape sequence transparently embeds input up to and including
+the end of the line.  The @code{\?} escape sequence transparently embeds
+input until its own next occurrence.
+
+@cindex @code{\?}, and copy mode
+@cindex copy mode, and @code{\?}
+@cindex mode, copy, and @code{\?}
+@cindex @code{\!}, and copy mode
+@cindex copy mode, and @code{\!}
+@cindex mode, copy, and @code{\!}
 @noindent
-@var{anything} may not contain newlines; use @code{\!}  to embed
-newlines in a diversion.  The escape sequence @code{\?} is also
+@var{anything} may not contain newlines; use @code{\!} by itself to
+embed newlines in a diversion.  The escape sequence @code{\?} is also
 recognized in copy mode and turned into a single internal code; it is
 this code that terminates @var{anything}.  Thus the following example
 prints@tie{}4.
@@ -13180,15 +15260,15 @@
 .f
 @endExample
 
-Both escapes read the data in copy mode.
+Both escape sequences read the data in copy mode.
 
 @cindex @code{\!}, in top-level diversion
 @cindex top-level diversion, and @code{\!}
 @cindex diversion, top-level, and @code{\!}
 If @code{\!} is used in the top-level diversion, its argument is
-directly embedded into the @code{gtroff} intermediate output.  This can
-be used for example to control a postprocessor that processes the data
-before it is sent to the device driver.
+directly embedded into GNU @code{troff}'s intermediate output.  This can
+be used, for example, to control a postprocessor that processes the data
+before it is sent to an output driver.
 
 @cindex @code{\?}, in top-level diversion
 @cindex top-level diversion, and @code{\?}
@@ -13199,35 +15279,35 @@
 
 @cindex @code{\!}, and @code{output} request
 @cindex @code{output} request, and @code{\!}
-@cindex @code{output} request, and copy-in mode
-@cindex copy-in mode, and @code{output} request
-@cindex mode, copy-in, and @code{output} request
-@Defreq {output, string}
-Emit @var{string} directly to the @code{gtroff} intermediate output
+@cindex @code{output} request, and copy mode
+@cindex copy mode, and @code{output} request
+@cindex mode, copy, and @code{output} request
+@Defreq {output, contents}
+Emit @var{contents} directly to GNU @code{troff}'s intermediate output
 (subject to copy mode interpretation); this is similar to @code{\!} used
-at the top level.  An initial double quote in @var{string} is stripped
-off to allow initial blanks.
+at the top level.  An initial neutral double quote in @var{contents} is
+stripped to allow embedding of leading spaces.
 
-This request can't be used before the first page has started -- if you
+This request can't be used before the first page has started---if you
 get an error, simply insert @code{.br} before the @code{output} request.
 
-Without argument, @code{output} is ignored.
-
 Use with caution!  It is normally only needed for mark-up used by a
 postprocessor that does something with the output before sending it to
-the output device, filtering out @var{string} again.
+the output device, filtering out @var{contents} again.
 @endDefreq
 
 @Defreq {asciify, div}
 @cindex unformatting diversions (@code{asciify})
 @cindex diversion, unformatting (@code{asciify})
 @cindex @code{trin} request, and @code{asciify}
-@dfn{Unformat} the diversion specified by @var{div} in such a way that
-@acronym{ASCII} characters, characters translated with the @code{trin}
-request, space characters, and some escape sequences that were formatted
-and diverted are treated like ordinary input characters when the
-diversion is reread.  It can be also used for gross hacks; for example,
-the following sets register@tie{}@code{n} to@tie{}1.
+@dfn{Unformat} the diversion @var{div} in a way such that Unicode basic
+Latin (@acronym{ASCII}) characters, characters translated with the
+@code{trin} request, space characters, and some escape sequences, that
+were formatted and diverted into @var{div} are treated like ordinary
+input characters when @var{div} is reread.  Doing so can be useful in
+conjunction with the @code{writem} request.  @code{asciify} can be also
+used for gross hacks; for example, the following sets
+register@tie{}@code{n} to@tie{}1.
 
 @Example
 .tr @@.
@@ -13240,90 +15320,239 @@
 .x
 @endExample
 
-Note that @code{asciify} cannot return all items in a diversion back
-to their source equivalent, nodes such as @code{\N...} will still
-remain as nodes, so the result cannot be guaranteed to be a pure string.
-
-@xref{Copy-in Mode}.
+@code{asciify} cannot return all items in a diversion to their source
+equivalent: nodes such as those produced by the @code{\N} escape
+sequence will remain nodes, so the result cannot be guaranteed to be a
+pure string.  @xref{Copy Mode}.  Glyph parameters such as the type face
+and size are not preserved; use @code{unformat} to achieve that.
 @endDefreq
 
 @Defreq {unformat, div}
-Like @code{asciify}, unformat the specified diversion.  However,
-@code{unformat} only unformats spaces and tabs between words.
-Unformatted tabs are treated as input tokens, and spaces are stretchable
-again.
-
-The vertical size of lines is not preserved; glyph information (font,
-font size, space width, etc.)@: is retained.
+Like @code{asciify}, unformat the diversion @var{div}.  However,
+@code{unformat} handles only tabs and spaces between words, the latter
+usually arising from spaces or newlines in the input.  Tabs are treated
+as input tokens, and spaces become adjustable again.  The vertical sizes
+of lines are not preserved, but glyph information (font, type size,
+space width, and so on) is retained.
 @endDefreq
 
 
 @c =====================================================================
 
-@node Environments, Suppressing output, Diversions, gtroff Reference
+@node Punning Names, Environments, Diversions, GNU troff Reference
+@section Punning Names
+@cindex diversions
+
+Macros, strings, and diversions share a name space; recall
+@ref{Identifiers}.  Internally, the same mechanism is used to store
+them.  You can thus call a macro with string interpolation syntax and
+vice versa.
+
+@Example
+.de subject
+Typesetting
+..
+.de predicate
+rewards attention to detail
+..
+\*subject \*predicate.
+Truly.
+    @result{} Typesetting
+    @result{}  rewards attention to detail Truly.
+@endExample
+
+@noindent
+What went wrong?  Strings don't contain newlines, but macros do.  String
+interpolation placed a newline at the end of @samp{\*subject}, and the
+next thing on the input was a space.  Then when @samp{\*predicate} was
+interpolated, it was followed by the empty request @samp{.} on a line by
+itself.  If we want to use macros as strings, we must take interpolation
+behavior into account.
+
+@Example
+.de subject
+Typesetting\\
+..
+.de predicate
+rewards attention to detail\\
+..
+\*subject \*predicate.
+Truly.
+    @result{} Typesetting rewards attention to detail.  Truly.
+@endExample
+
+@noindent
+By ending each text line of the macros with an escaped
+@code{\@key{RET}}, we get the desired effect (@pxref{Line
+Continuation}).@footnote{The backslash is doubled.  @xref{Copy Mode}.}
+What would have happened if we had used only one backslash at a time
+instead?
+
+Interpolating a string does not hide existing macro arguments.  We can
+also place the escaped newline outside the string interpolation instead
+of within the string definition.  Thus, in a macro, a more efficient way
+of doing
+
+@Example
+.xx \\$@@
+@endExample
+
+@noindent
+is
+
+@Example
+\\*xx\\
+@endExample
+
+@noindent
+The latter calling syntax doesn't change the value of @code{\$0}, which
+is then inherited from the calling macro (@pxref{Parameters}).
+
+Diversions can be also called with string syntax.  It is sometimes
+convenient to copy one-line diversions to a string.
+
+@Example
+.di xx
+the
+.ft I
+interpolation system
+.ft
+.br
+.di
+.ds yy This is a test of \*(xx\c
+\*(yy.
+    @result{} This is a test of the @i{interpolation system}.
+@endExample
+
+@noindent
+As the previous example shows, it is possible to store formatted output
+in strings.  The @code{\c} escape sequence prevents the subsequent
+newline from being interpreted as a break (again,
+@pxref{Line Continuation}).
+
+Copying multi-output line diversions produces unexpected results.
+
+@Example
+.di xxx
+a funny
+.br
+test
+.br
+.di
+.ds yyy This is \*xxx\c
+\*yyy.
+    @result{} test This is a funny.
+@endExample
+
+Usually, it is not predictable whether a diversion contains one or more
+output lines, so this mechanism should be avoided.  With @acronym{AT&T}
+@code{troff}, this was the only solution to strip off a final newline
+from a diversion.  Another disadvantage is that the spaces in the copied
+string are already formatted, preventing their adjustment.  This can
+cause ugly results.
+
+@cindex stripping final newline in diversions
+@cindex diversion, stripping final newline
+@cindex final newline, stripping in diversions
+@cindex newline, final, stripping in diversions
+@cindex horizontal space, unformatting
+@cindex space, horizontal, unformatting
+@cindex unformatting horizontal space
+A clean solution to this problem is available in GNU @code{troff}, using
+the requests @code{chop} to remove the final newline of a diversion, and
+@code{unformat} to make the horizontal spaces adjustable again.
+
+@Example
+.box xxx
+a funny
+.br
+test
+.br
+.box
+.chop xxx
+.unformat xxx
+This is \*xxx.
+    @result{} This is a funny test.
+@endExample
+
+@xref{Gtroff Internals}.
+
+@c =====================================================================
+
+@c BEGIN Keep parallel with section "Environments" of groff(7).
+@node Environments, Suppressing Output, Diversions, GNU troff Reference
 @section Environments
 @cindex environments
 
-It happens frequently that some text should be printed in a certain
-format regardless of what may be in effect at the time, for example, in
-a trap invoked macro to print headers and footers.  To solve this
-@code{gtroff} processes text in @dfn{environments}.  An environment
-contains most of the parameters that control text processing.  It is
-possible to switch amongst these environments; by default @code{gtroff}
-processes text in environment@tie{}0.  The following is the information
-kept in an environment.
+As discussed in @ref{Deferring Output}, environments store most of the
+parameters that determine the appearance of text.  A default environment
+named @samp{0} exists when GNU @code{troff} starts up; it is modified by
+formatting-related requests and escape sequences.
+
+@cindex stack
+You can create new environments and switch among them.  Only one is
+current at any given time.  Active environments are managed using a
+@dfn{stack}, a data structure supporting ``push'' and ``pop''
+operations.  The current environment is at the top of the stack.
+The same environment name can be pushed onto the stack multiple times,
+possibly interleaved with others.  Popping the environment stack does
+not destroy the current environment; it remains accessible by name and
+can be made current again by pushing it at any time.  Environments
+cannot be renamed or deleted, and can only be modified when current.  To
+inspect the environment stack, use the @code{pev} request; see
+@ref{Debugging}.
+
+Environments store the following information.
 
 @itemize @bullet
 @item
-font parameters (size, family, style, glyph height and slant, space and
-sentence space size)
+a partially collected line, if any
 
 @item
-page parameters (line length, title length, vertical spacing, line
-spacing, indentation, line numbering, centering, right-justifying,
-underlining, hyphenation data)
+data about the most recently output glyph and line (registers
+@code{.cdp}, @code{.cht}, @code{.csk}, @code{.n}, @code{.w})
 
 @item
-fill and adjust mode
+typeface parameters (size, family, style, height and slant, inter-word
+and inter-sentence space sizes)
 
 @item
-tab stops, tab and leader characters, escape character, no-break and
-hyphen indicators, margin character data
+page parameters (line length, title length, vertical spacing, line
+spacing, indentation, line numbering, centering, right-alignment,
+underlining, hyphenation parameters)
 
 @item
-partially collected lines
+filling enablement; adjustment enablement and mode
 
 @item
-input traps
+tab stops; tab, leader, escape, control, no-break control, hyphenation,
+and margin characters
 
 @item
-drawing and fill colours
-@end itemize
+input line traps
 
-These environments may be given arbitrary names (see @ref{Identifiers},
-for more info).  Old versions of @code{troff} only had environments
-named @samp{0}, @samp{1}, and @samp{2}.
+@item
+stroke and fill colors
+@end itemize
+@c END Keep parallel with section "Environments" of groff(7).
 
-@DefreqList {ev, @Var{env}}
+@DefreqList {ev, @Var{ident}}
 @DefregListEndx {.ev}
 @cindex switching environments (@code{ev})
 @cindex environment, switching (@code{ev})
 @cindex environment number/name register (@code{.ev})
-Switch to another environment.  The argument @var{env} is the name of
-the environment to switch to.  With no argument, @code{gtroff} switches
-back to the previous environment.  There is no limit on the number of
-named environments; they are created the first time that they are
-referenced.  The @code{.ev} read-only register contains the name or
-number of the current environment.  This is a string-valued register.
-
-Note that a call to @code{ev} (with argument) pushes the previously
-active environment onto a stack.  If, say, environments @samp{foo},
-@samp{bar}, and @samp{zap} are called (in that order), the first
-@code{ev} request without parameter switches back to environment
-@samp{bar} (which is popped off the stack), and a second call switches
-back to environment @samp{foo}.
-
-Here is an example:
+Enter the environment @var{ident}, which is created if it does not
+already exist, using the same parameters as for the default environment
+used at startup.  With no argument, GNU @code{troff} switches to the
+previous environment.
+
+Invoking @code{ev} with an argument puts environment @var{ident} onto
+the top of the environment stack.  (If it isn't already present in the
+stack, this is a proper push.)  Without an argument, @code{ev} pops the
+environment stack, making the previous environment current.  It is an
+error to pop the environment stack with no previous environment
+available.  The read-only string-valued register @code{.ev} contains the
+name of the current environment---the one at the top of the stack.
 
 @Example
 .ev footnote-env
@@ -13333,44 +15562,76 @@
 .ll -.5i
 .ev
 
-...
+@r{@dots{}}
 
 .ev footnote-env
-\(dg Note the large, friendly letters.
+\dg Observe the smaller text and vertical spacing.
 .ev
 @endExample
+
+We can familiarize ourselves with stack behavior by wrapping the
+@code{ev} request with a macro that reports the contents of the
+@code{.ev} register to the standard error stream.
+
+@Example
+.de EV
+.  ev \\$1
+.  tm environment is now \\n.ev
+..
+.
+.EV foo
+.EV bar
+.EV
+.EV baz
+.EV
+.EV
+.EV
+@endExample
+
+@Example
+    @error{} environment is now foo
+    @error{} environment is now bar
+    @error{} environment is now foo
+    @error{} environment is now baz
+    @error{} environment is now foo
+    @error{} environment is now 0
+    @error{} error: environment stack underflow
+    @error{} environment is now 0
+@endExample
+
 @endDefreq
 
-@Defreq {evc, env}
+@Defreq {evc, environment}
 @cindex copying environment (@code{evc})
 @cindex environment, copying (@code{evc})
-Copy the environment @var{env} into the current environment.
+Copy the contents of @var{environment} to the current environment.
 
-The following environment data is not copied:
+The following environment data are not copied.
 
 @itemize @bullet
 @item
-Partially filled lines.
+a partially collected line, if present;
 
 @item
-The status whether the previous line was interrupted.
+the interruption status of the previous input line (due to use of the
+@code{\c} escape sequence);
 
 @item
-The number of lines still to center, or to right-justify, or to
-underline (with or without underlined spaces); they are set to zero.
+the count of remaining lines to center, to right-justify, or to
+underline (with or without underlined spaces)---these are set to zero;
 
 @item
-The status whether a temporary indentation is active.
+the activation status of temporary indentation;
 
 @item
-Input traps and its associated data.
+input line traps and their associated data;
 
 @item
-Line numbering mode is disabled; it can be reactivated with @w{@samp{.nm
-+0}}.
+the activation status of line numbering (which can be reactivated with
+@w{@samp{.nm +0}}); and
 
 @item
-The number of consecutive hyphenated lines (set to zero).
+the count of consecutive hyphenated lines (set to zero).
 @end itemize
 @endDefreq
 
@@ -13385,19 +15646,19 @@
 @cindex skew, of last glyph (@code{.csk})
 @cindex last glyph, dimensions (@code{.w}, @code{.cht}, @code{.cdp}, @code{.csk})
 @cindex glyph, last, dimensions (@code{.w}, @code{.cht}, @code{.cdp}, @code{.csk})
-The @code{\n.w} register contains the width of the last glyph added to
-the current environment.
+The @code{\n.w} register contains the width of the last glyph
+formatted in the environment.
 
-The @code{\n.cht} register contains the height of the last glyph added
-to the current environment.
+The @code{\n.cht} register contains the height of the last glyph
+formatted in the environment.
 
-The @code{\n.cdp} register contains the depth of the last glyph added
-to the current environment.  It is positive for glyphs extending below
+The @code{\n.cdp} register contains the depth of the last glyph
+formatted in the environment.  It is positive for glyphs extending below
 the baseline.
 
 The @code{\n.csk} register contains the @dfn{skew} (how far to the
-right of the glyph's center that @code{gtroff} should place an accent)
-of the last glyph added to the current environment.
+right of the glyph's center that GNU @code{troff} should place an
+accent) of the last glyph formatted in the environment.
 @endDefreg
 
 @Defreg {.n}
@@ -13406,29 +15667,35 @@
 @cindex length of previous line (@code{.n})
 @cindex previous line length (@code{.n})
 The @code{\n.n} register contains the length of the previous output
-line in the current environment.
+line emitted in the environment.
 @endDefreg
 
+@codequotebacktick off
+@codequoteundirected off
+
 
 @c =====================================================================
 
-@node Suppressing output, Colors, Environments, gtroff Reference
-@section Suppressing output
+@node Suppressing Output, Colors, Environments, GNU troff Reference
+@section Suppressing Output
 
-@Defesc {\\O, , num, }
+@Defesc {\\O, , num, }
 @cindex suppressing output (@code{\O})
 @cindex output, suppressing (@code{\O})
-Disable or enable output depending on the value of @var{num}:
+Suppress GNU @code{troff} output of glyphs and geometric objects.  The
+sequences @code{\O2}, @code{\O3}, @code{\O4}, and @code{\O5} are
+intended for internal use by @code{grohtml}.
 
 @table @samp
 @item \O0
-Disable any glyphs from being emitted to the device driver, provided
-that the escape occurs at the outer level (see @code{\O3} and
-@code{\O4}).  Motion is not suppressed so effectively @code{\O0}
-means @emph{pen up}.
+Disable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
+level (see @code{\O3} and @code{\04} below).  Horizontal motions
+corresponding to non-overstruck glyph widths still occur.
 
 @item \O1
-Enable output of glyphs, provided that the escape occurs at the outer
+Enable the emission of glyphs and geometric objects to the output
+driver, provided that this sequence occurs at the outermost suppression
 level.
 @end table
 
@@ -13436,185 +15703,63 @@
 @vindex opminy
 @vindex opmaxx
 @vindex opmaxy
-@code{\O0} and @code{\O1} also reset the four registers @samp{opminx},
-@samp{opminy}, @samp{opmaxx}, and @samp{opmaxy} to @minus{}1.
-@xref{Register Index}.  These four registers mark the top left and
-bottom right hand corners of a box that encompasses all written glyphs.
-
-For example the input text:
-
-@Example
-Hello \O0world \O1this is a test.
-@endExample
-
-@noindent
-produces the following output:
-
-@Example
-Hello       this is a test.
-@endExample
+@code{\O0} and @code{\O1} also reset the four registers @code{opminx},
+@code{opminy}, @code{opmaxx}, and @code{opmaxy} to @minus{}1.  These
+four registers mark the top left and bottom right hand corners of a box
+encompassing all written or drawn output.
 
 @table @samp
 @item \O2
-Provided that the escape occurs at the outer level, enable output of
-glyphs and also write out to @code{stderr} the page number and four
-registers encompassing the glyphs previously written since the last call
-to @code{\O}.
+At the outermost suppression level, enable emission of glyphs and
+geometric objects, and write to the standard error stream the page
+number and values of the four aforementioned registers encompassing
+glyphs written since the last interpolation of a @code{\O} sequence, as
+well as the page offset, line length, image file name (if any),
+horizontal and vertical device motion quanta, and input file name.
+Numeric values are in basic units.
 
 @item \O3
-Begin a nesting level.  At start-up, @code{gtroff} is at outer level.
-The current level is contained within the read-only register @code{.O}.
-@xref{Built-in Registers}.
+Begin a nested suppression level.  @command{grohtml} uses this mechanism
+to create images of output preprocessed with @command{gpic},
+@command{geqn}, and @command{gtbl}.  At startup, GNU @code{troff} is at
+the outermost suppression level.  @command{pre-grohtml} generates these
+sequences when processing the document, using GNU @command{troff} with
+the @code{ps} output device, Ghostscript, and the PNM tools to produce
+images in PNG format.  They start a new page if the device is not
+@code{html} or @code{xhtml}, to reduce the number of images crossing a
+page boundary.
 
 @item \O4
-End a nesting level.  The current level is contained within the
-read-only register @code{.O}.  @xref{Built-in Registers}.
+End a nested suppression level.
+@end table
 
-@item \O5@var{P}@var{filename}
-This escape is @code{grohtml} specific.  Provided that this escape
-occurs at the outer nesting level write the @code{filename} to
-@code{stderr}.  The position of the image, @var{P}, must be specified
-and must be one of @code{l}, @code{r}, @code{c}, or@tie{}@code{i} (left,
-right, centered, inline).  @var{filename} is associated with the
-production of the next inline image.
+@table @samp
+@item \O5@var{P}@var{file}
+At the outermost suppression level, write the name @code{file} to the
+standard error stream at position @var{P}, which must be one of
+@code{l}, @code{r}, @code{c}, or@tie{}@code{i}, corresponding to left,
+right, centered, and inline alignments within the document,
+respectively.  @var{file} is a name associated with the production of
+the next image.
 @end table
 @endDefesc
 
+@Defreg {.O}
+@cindex suppression nesting level register
+@cindex nesting level, suppression, register
+@cindex level, suppression nesting, register
+Output suppression nesting level applied by @code{\O3} and @code{\O4}
+escape sequences.
+@endDefreg
 
 @c =====================================================================
 
-@node Colors, I/O, Suppressing output, gtroff Reference
-@section Colors
-@cindex colors
-
-@DefreqList {color, @Var{n}}
-@DefregListEndx {.color}
-If @var{n} is missing or non-zero, activate colors (this is the
-default); otherwise, turn it off.
-
-The read-only number register @code{.color} is@tie{}1 if colors are
-active, 0@tie{}otherwise.
-
-Internally, @code{color} sets a global flag; it does not produce a
-token.  Similar to the @code{cp} request, you should use it at the
-beginning of your document to control color output.
-
-Colors can be also turned off with the @option{-c} command-line option.
-@endDefreq
-
-@Defreq {defcolor, ident scheme color_components}
-Define color with name @var{ident}.  @var{scheme} can be one of the
-following values: @code{rgb} (three components), @code{cmy} (three
-components), @code{cmyk} (four components), and @code{gray} or
-@code{grey} (one component).
-
-@cindex default color
-@cindex color, default
-Color components can be given either as a hexadecimal string or as
-positive decimal integers in the range 0--65535.  A hexadecimal string
-contains all color components concatenated.  It must start with either
-@code{#} or @code{##}; the former specifies hex values in the range
-0--255 (which are internally multiplied by@tie{}257), the latter in the
-range 0--65535.  Examples: @code{#FFC0CB} (pink), @code{##ffff0000ffff}
-(magenta).  The default color name @c{default} can't be redefined; its
-value is device-specific (usually black).  It is possible that the
-default color for @code{\m} and @code{\M} is not identical.
-
-@cindex @code{f} unit, and colors
-@cindex unit, @code{f}, and colors
-A new scaling indicator@tie{}@code{f} has been introduced, which
-multiplies its value by 65536; this makes it convenient to specify color
-components as fractions in the range 0 to@tie{}1 (1f equals 65536u).
-Example:
-
-@Example
-.defcolor darkgreen rgb 0.1f 0.5f 0.2f
-@endExample
-
-Note that @code{f} is the default scaling indicator for the
-@code{defcolor} request, thus the above statement is equivalent to
-
-@Example
-.defcolor darkgreen rgb 0.1 0.5 0.2
-@endExample
-@endDefreq
-
-@DefreqList {gcolor, @Var{color}}
-@DefescItemx {\\m, , c, }
-@DefescItem {\\m, @Lparen{}, co, }
-@DefescItem {\\m, @Lbrack{}, color, @Rbrack{}}
-@DefregListEndx {.m}
-Set (glyph) drawing color.  The following examples show how to turn the
-next four words red.
-
-@Example
-.gcolor red
-these are in red
-.gcolor
-and these words are in black.
-@endExample
-
-@Example
-\mredthese are in red\m and these words are in black.
-@endExample
-
-The escape @code{\m} returns to the previous color, as does a call to
-@code{gcolor} without an argument.
-
-@cindex drawing color name register (@code{.m})
-@cindex name, drawing color, register (@code{.m})
-@cindex color name, drawing, register (@code{.m})
-The name of the current drawing color is available in the read-only,
-string-valued number register @samp{.m}.
-
-The drawing color is associated with the current environment
-(@pxref{Environments}).
-
-Note that @code{\m} doesn't produce an input token in @code{gtroff}.  As
-a consequence, it can be used in requests like @code{mc} (which expects
-a single character as an argument) to change the color on the fly:
-
-@Example
-.mc \mredx\m
-@endExample
-@endDefesc
-
-@DefreqList {fcolor, @Var{color}}
-@DefescItemx {\\M, , c, }
-@DefescItem {\\M, @Lparen{}, co, }
-@DefescItem {\\M, @Lbrack{}, color, @Rbrack{}}
-@DefregListEndx {.M}
-Set fill (background) color for filled objects drawn with the
-@code{\D'@dots{}'} commands.
-
-A red ellipse can be created with the following code:
-
-@Example
-\Mred\h'0.5i'\D'E 2i 1i'\M
-@endExample
+@codequotebacktick on
+@codequoteundirected on
 
-The escape @code{\M} returns to the previous fill color, as does a
-call to @code{fcolor} without an argument.
-
-@cindex background color name register (@code{.M})
-@cindex name, background color, register (@code{.M})
-@cindex color name, background, register (@code{.M})
-@cindex fill color name register (@code{.M})
-@cindex name, fill color, register (@code{.M})
-@cindex color name, fill, register (@code{.M})
-The name of the current fill (background) color is available in the
-read-only, string-valued number register @samp{.M}.
-
-The fill color is associated with the current environment
-(@pxref{Environments}).
-
-Note that @code{\M} doesn't produce an input token in @code{gtroff}.
-@endDefesc
-
-
-@c =====================================================================
-
-@node I/O, Postprocessor Access, Colors, gtroff Reference
+@c TODO: Rename this node to "Operating Environment Access" or similar,
+@c and move the date/time, process ID, etc., read-only registers here.
+@node I/O, Postprocessor Access, Suppressing Output, GNU troff Reference
 @section I/O
 @cindex i/o
 @cindex input and output requests
@@ -13623,109 +15768,113 @@
 
 @code{gtroff} has several requests for including files:
 
-@Defreq {so, file}
+@DefreqList {so, file}
+@DefreqListEndx {soquiet, file}
 @cindex including a file (@code{so})
 @cindex file, inclusion (@code{so})
-Read in the specified @var{file} and includes it in place of the
-@code{so} request.  This is quite useful for large documents, e.g.@:
-keeping each chapter in a separate file.  @xref{gsoelim}, for more
-information.
-
-Since @code{gtroff} replaces the @code{so} request with the contents of
-@code{file}, it makes a difference whether the data is terminated with a
-newline or not: Assuming that file @file{xxx} contains the word
-@samp{foo} without a final newline, this
+Replace the @code{so} request's control line with the contents of the
+file named by the argument, ``sourcing'' it.  @var{file} is sought in
+the directories specified by @option{-I} command-line option.  If
+@var{file} does not exist, a warning in category @samp{file} is produced
+and the request has no further effect.  @xref{Warnings}, for
+information about the enablement and suppression of warnings.
+
+@code{so} can be useful for large documents; e.g., allowing each chapter
+of a book to be kept in a separate file.  However, files interpolated
+with @code{so} are not preprocessed; to overcome this limitation, see
+the @cite{gsoelim@r{(1)}} man page.
+
+Since GNU @code{troff} replaces the entire control line with the
+contents of a file, it matters whether @code{file} is terminated with a
+newline or not.  Assume that file @file{xxx} contains only the word
+@samp{foo} without a trailing newline.
 
 @Example
-This is
+$ printf 'foo' > xxx
+
+The situation is
 .so xxx
-bar
+bar.
+    @result{} The situation is foobar.
 @endExample
 
-@noindent
-yields @samp{This is foobar}.
-
-The search path for @var{file} can be controlled with the @option{-I}
-command-line option.
+@code{soquiet} works the same way, except that no warning diagnostic is
+issued if @var{file} does not exist.
 @endDefreq
 
 @Defreq {pso, command}
-Read the standard output from the specified @var{command} and includes
+Read the standard output from the specified @var{command} and include
 it in place of the @code{pso} request.
 
 @cindex safer mode
 @cindex mode, safer
 @cindex unsafe mode
 @cindex mode, unsafe
-This request causes an error if used in safer mode (which is the
-default).  Use @code{groff}'s or @code{troff}'s @option{-U} option to
-activate unsafe mode.
+It is an error to use this request in safer mode, which is the
+default.  Invoke GNU @code{troff} or a front end with the @option{-U}
+option to enable unsafe mode.
 
 The comment regarding a final newline for the @code{so} request is valid
 for @code{pso} also.
 @endDefreq
 
-@Defreq {mso, file}
-Identical to the @code{so} request except that @code{gtroff} searches
-for the specified @var{file} in the same directories as macro files for
-the @option{-m} command-line option.
-If the file name to be included has the form @file{@var{name}.tmac} and it
-isn't found, @code{mso} tries to include @file{tmac.@var{name}} and vice
-versa.
-If the file does not exist, a warning of type @samp{file} is emitted.
-@xref{Debugging}, for information about warnings.
+@DefreqList {mso, file}
+@DefreqListEndx {msoquiet, file}
+Identical to the @code{so} and @code{soquiet} requests, respectively,
+except that @code{gtroff} searches for the specified @var{file} in the
+same directories as macro files for the @option{-m} command-line option.
+If the file name to be included has the form @file{@var{name}.tmac} and
+it isn't found, these requests try to include @file{tmac.@var{name}} and
+vice versa.
 @endDefreq
 
 @DefreqList {trf, file}
 @DefreqListEndx {cf, file}
 @cindex transparent output (@code{cf}, @code{trf})
 @cindex output, transparent (@code{cf}, @code{trf})
-@cindex @code{cf} request, and copy-in mode
-@cindex copy-in mode, and @code{cf} request
-@cindex mode, copy-in, and @code{cf} request
-@cindex @code{trf} request, and copy-in mode
-@cindex copy-in mode, and @code{trf} request
-@cindex mode, copy-in, and @code{trf} request
+@cindex @code{cf} request, and copy mode
+@cindex copy mode, and @code{cf} request
+@cindex mode, copy, and @code{cf} request
+@cindex @code{trf} request, and copy mode
+@cindex copy mode, and @code{trf} request
+@cindex mode, copy, and @code{trf} request
 Transparently output the contents of @var{file}.  Each line is output as
 if it were preceded by @code{\!}; however, the lines are @emph{not}
 subject to copy mode interpretation.  If the file does not end with a
-newline, then a newline is added (@code{trf} only).  For example, to
-define a macro@tie{}@code{x} containing the contents of
-file@tie{}@file{f}, use
+newline, @code{trf} adds one.  Both requests cause a break.
 
-@Example
-.ev 1
-.di x
-.trf f
-.di
-.ev
-@endExample
-
-@noindent
-The calls to @code{ev} prevent that the current partial input line
-becomes part of the diversion.
-
-Both @code{trf} and @code{cf}, when used in a diversion, embeds an
-object in the diversion which, when reread, causes the contents of
-@var{file} to be transparently copied through to the output.  In
-Unix @code{troff}, the contents of @var{file} is immediately copied
-through to the output regardless of whether there is a current
-diversion; this behaviour is so anomalous that it must be considered a
-bug.
+When used in a diversion, these requests embed a node (@pxref{Gtroff
+Internals}) in it that, when reread, causes the contents of @var{file}
+to be transparently copied to the output.  In @acronym{AT&T}
+@code{troff}, the contents of @var{file} are immediately copied to the
+output regardless of whether there is a current diversion; this
+behaviour is so anomalous that it must be considered a bug.
 
 @cindex @code{trf} request, and invalid characters
 @cindex characters, invalid for @code{trf} request
 @cindex invalid characters for @code{trf} request
-
 While @code{cf} copies the contents of @var{file} completely
 unprocessed, @code{trf} disallows characters such as NUL that are not
 valid @code{gtroff} input characters (@pxref{Identifiers}).
 
-For @code{cf}, within a diversion, `completely unprocessed' means that
+For @code{cf}, within a diversion, ``completely unprocessed'' means that
 each line of a file to be inserted is handled as if it were preceded by
 @code{\!\\!}.
 
-Both requests cause a line break.
+To define a macro@tie{}@code{x} containing the contents of
+file@tie{}@file{f}, use
+
+@Example
+.ev 1
+.di x
+.trf f
+.di
+.ev
+@endExample
+
+@noindent
+The calls to @code{ev} prevent the partially collected output line
+from becoming part of the diversion (@pxref{Diversions}).
 @endDefreq
 
 @Defreq {nx, @Var{file}}
@@ -13784,10 +15933,10 @@
 @cindex @code{ex} request, used with @code{nx} and @code{rd}
 @noindent
 When this is run, a file containing the following lines should be
-redirected in.  Note that requests included in this file are executed as
-though they were part of the form letter.  The last block of input is
-the @code{ex} request, which tells @code{groff} to stop processing.  If
-this was not there, @code{groff} would not know when to stop.
+redirected in.  Requests included in this file are executed as though
+they were part of the form letter.  The last block of input is the
+@code{ex} request, which tells GNU @code{troff} to stop processing.  If
+this were not there, @code{troff} would not know when to stop.
 
 @Example
 Trent A. Fisher
@@ -13814,9 +15963,9 @@
 @cindex mode, safer
 @cindex unsafe mode
 @cindex mode, unsafe
-@code{pi} causes an error if used in safer mode (which is the default).
-Use @code{groff}'s or @code{troff}'s @option{-U} option to activate
-unsafe mode.
+It is an error to use this request in safer mode, which is the
+default.  Invoke GNU @code{troff} or a front end with the @option{-U}
+option to enable unsafe mode.
 
 Multiple calls to @code{pi} are allowed, acting as a chain.  For
 example,
@@ -13831,29 +15980,28 @@
 
 @cindex @code{groff}, and @code{pi} request
 @cindex @code{pi} request, and @code{groff}
-Note that the intermediate output format of @code{gtroff} is piped to
-the specified commands.  Consequently, calling @code{groff} without the
+The intermediate output format of GNU @code{troff} is piped to the
+specified commands.  Consequently, calling @code{groff} without the
 @option{-Z} option normally causes a fatal error.
 @endDefreq
 
+@cindex system commands, running
+@cindex running system commands
 @DefreqList {sy, cmds}
 @DefregListEndx {systat}
 Execute the shell command(s) specified by @var{cmds}.  The output is not
-saved anyplace, so it is up to the user to do so.
+saved anywhere, so it is up to the user to do so.
 
 @cindex safer mode
 @cindex mode, safer
 @cindex unsafe mode
 @cindex mode, unsafe
-This request causes an error if used in safer mode (which is the
-default).  Use @code{groff}'s or @code{troff}'s @option{-U} option to
-activate unsafe mode.
+It is an error to use this request in safer mode; this is the default.
+Give GNU @code{troff} or a front end program the @option{-U} option to
+enable unsafe mode.
 
-For example, the following code fragment introduces the current time
-into a document:
+The following code fragment introduces the current time into a document.
 
-@cindex time, current
-@cindex current time
 @pindex perl
 @Example
 .sy perl -e 'printf ".nr H %d\\n.nr M %d\\n.nr S %d\\n",\
@@ -13864,26 +16012,29 @@
 @endExample
 
 @noindent
-Note that this works by having the @code{perl} script (run by @code{sy})
-print out the @code{nr} requests that set the number registers
-@code{H}, @code{M}, and @code{S}, and then reads those commands in with
-the @code{so} request.
-
-For most practical purposes, the number registers @code{seconds},
-@code{minutes}, and @code{hours}, which are initialized at start-up of
-@code{gtroff}, should be sufficient.  Use the @code{af} request to get a
-formatted output:
+This works by having the Perl script (run by @code{sy}) write
+@code{nr} requests that set the registers @code{H}, @code{M}, and
+@code{S} to a temporary file.  The @code{roff} document then reads the
+temporary file using the @code{so} request.
+
+@cindex time, formatting
+@cindex formatting the time
+The registers @code{seconds}, @code{minutes}, and @code{hours},
+initialized at startup of GNU @code{troff}, should satisfy most
+requirements.  Use the @code{af} request to format their values for
+output.
 
 @Example
 .af hours 00
 .af minutes 00
 .af seconds 00
 \nhours:\nminutes:\nseconds
+    @result{} 02:17:54
 @endExample
 
 @cindex @code{system()} return value register (@code{systat})
-The @code{systat} read-write number register contains the return value
-of the @code{system()} function executed by the last @code{sy} request.
+The writable register @code{systat} contains the return value of the
+@code{system()} function executed by the last @code{sy} request.
 @endDefreq
 
 @DefreqList {open, stream file}
@@ -13902,26 +16053,27 @@
 @cindex mode, safer
 @cindex unsafe mode
 @cindex mode, unsafe
-Both @code{open} and @code{opena} cause an error if used in safer mode
-(which is the default).  Use @code{groff}'s or @code{troff}'s
-@option{-U} option to activate unsafe mode.
+It is an error to use these requests in safer mode; this is the default.
+Give GNU @code{troff} or a front end program the @option{-U} option to
+enable unsafe mode.
 @endDefreq
 
 @DefreqList {write, stream data}
 @DefreqListEndx {writec, stream data}
-@cindex copy-in mode, and @code{write} request
-@cindex @code{write} request, and copy-in mode
-@cindex mode, copy-in, and @code{write} request
-@cindex copy-in mode, and @code{writec} request
-@cindex @code{writec} request, and copy-in mode
-@cindex mode, copy-in, and @code{writec} request
+@cindex copy mode, and @code{write} request
+@cindex @code{write} request, and copy mode
+@cindex mode, copy, and @code{write} request
+@cindex copy mode, and @code{writec} request
+@cindex @code{writec} request, and copy mode
+@cindex mode, copy, and @code{writec} request
 @cindex writing to file (@code{write}, @code{writec})
 @cindex file, writing to (@code{write}, @code{writec})
 Write to the file associated with the specified @var{stream}.  The
 stream must previously have been the subject of an open request.  The
 remainder of the line is interpreted as the @code{ds} request reads its
-second argument: A leading @samp{"} is stripped, and it is read in
-copy-in mode.
+second argument: an initial neutral double quote in @var{contents} is
+stripped to allow embedding of leading spaces, and it is read in copy
+mode.
 
 The @code{writec} request is like @code{write}, but only @code{write}
 appends a newline to the data.
@@ -13932,9 +16084,9 @@
 Write the contents of the macro or string @var{xx} to the file
 associated with the specified @var{stream}.
 
-@cindex @code{writem} request, and copy-in mode
-@cindex copy-in mode, and @code{writem} request
-@cindex mode, copy-in, and @code{writem} request
+@cindex @code{writem} request, and copy mode
+@cindex copy mode, and @code{writem} request
+@cindex mode, copy, and @code{writem} request
 @var{xx} is read in copy mode, i.e., already formatted elements are
 ignored.  Consequently, diversions must be unformatted with the
 @code{asciify} request before calling @code{writem}.  Usually, this
@@ -13963,34 +16115,46 @@
 @endDefreq
 
 @DefescList {\\V, , e, }
-@DefescItem {\\V, @Lparen{}, ev, }
-@DefescListEnd {\\V, @Lbrack{}, env, @Rbrack{}}
-@cindex @code{\V}, and copy-in mode
-@cindex copy-in mode, and @code{\V}
-@cindex mode, copy-in, and @code{\V}
+@DefescItem {\\V, (, ev, }
+@DefescListEnd {\\V, , env, }
+@cindex @code{\V}, and copy mode
+@cindex copy mode, and @code{\V}
+@cindex mode, copy, and @code{\V}
 Interpolate the contents of the specified environment variable @var{env}
 (one-character name@tie{}@var{e}, two-character name @var{ev}) as
-returned by the function @code{getenv}.  @code{\V} is interpreted in
-copy-in mode.
+returned by the function @cite{getenv@r{(3)}}.  @code{\V} is interpreted
+even in copy mode (@pxref{Copy Mode}).
 @endDefesc
 
 
 @c =====================================================================
 
-@node Postprocessor Access, Miscellaneous, I/O, gtroff Reference
+@node Postprocessor Access, Miscellaneous, I/O, GNU troff Reference
 @section Postprocessor Access
 @cindex postprocessor access
-@cindex access of postprocessor
-
-There are two escapes that give information directly to the
-postprocessor.  This is particularly useful for embedding
-@sc{PostScript} into the final document.
-
-@DefreqList {device, xxx}
-@DefescListEndx {\\X, ', xxx, '}
-Embeds its argument into the @code{gtroff} output preceded with
-@w{@samp{x X}}.
+@cindex access to postprocessor
 
+Two escape sequences and two requests enable documents to pass
+information directly to a postprocessor.  These are useful for
+exercising device-specific capabilities that the @code{groff} language
+does not abstract or generalize; examples include the embedding of
+hyperlinks and image files.  Device-specific functions are documented in
+each output driver's man page, such as @cite{gropdf@r{(1)}},
+@cite{grops@r{(1)}}, or @cite{grotty@r{(1)}}.
+
+@DefreqList {device, xxx @r{@dots{}}}
+@DefescListEndx {\\X, @code{'}, xxx @r{@dots{}}, @code{'}}
+Embed all @var{xxx} arguments into GNU @code{troff} output as parameters
+to a device control command @w{@samp{x X}}.  The meaning and
+interpretation of such parameters is determined by the output driver or
+other postprocessor.
+
+@cindex @code{device} request, and copy mode
+@cindex copy mode, and @code{device} request
+@cindex mode, copy, and @code{device} request
+The @code{device} request processes its arguments in copy mode
+(@pxref{Copy Mode}).  An initial neutral double quote in @var{contents}
+is stripped to allow embedding of leading spaces.
 @cindex @code{\&}, in @code{\X}
 @cindex @code{\)}, in @code{\X}
 @cindex @code{\%}, in @code{\X}
@@ -14000,227 +16164,265 @@
 @ifinfo
 @cindex @code{\@r{<colon>}}, in @code{\X}
 @end ifinfo
-The escapes @code{\&}, @code{\)}, @code{\%}, and @code{\:} are ignored
-within @code{\X}, @w{@samp{\ }} and @code{\~} are converted to single
-space characters.  All other escapes (except @code{\\}, which produces a
-backslash) cause an error.
-
-@cindex @code{device} request, and copy-in mode
-@cindex copy-in mode, and @code{device} request
-@cindex mode, copy-in, and @code{device} request
-Contrary to @code{\X}, the @code{device} request simply processes its
-argument in copy mode (@pxref{Copy-in Mode}).
+By contrast, within @code{\X} arguments, the escape sequences @code{\&},
+@code{\)}, @code{\%}, and @code{\:} are ignored; @code{\@key{SP}} and
+@code{\~} are converted to single space characters; and @code{\\} has
+its escape character stripped.  So that the basic Latin subset of the
+Unicode character set@footnote{that is, ISO@tie{}646:1991-IRV or,
+popularly, ``US-ASCII''} can be reliably encoded in device control
+commands, seven special character escape sequences (@samp{\-},
+@samp{\aq}, @samp{\dq}, @samp{\ga}, @samp{\ha}, @samp{\rs},
+and @samp{\ti},) are mapped to basic Latin characters; see the
+@cite{groff_char@r{(7)}} man page.  For this transformation, character
+translations and special character definitions are
+ignored.@footnote{They are bypassed because these parameters are not
+rendered as glyphs in the output; instead, they remain abstract
+characters---in a PDF bookmark or a URL, for example.} The use of any
+other escape sequence in @code{\X} parameters is normally an error.
 
 @kindex use_charnames_in_special
-@pindex DESC@r{, and @code{use_charnames_in_special}}
+@cindex @file{DESC} file, and @code{use_charnames_in_special} keyword
 @cindex @code{\X}, and special characters
-If the @samp{use_charnames_in_special} keyword is set in the @file{DESC}
-file, special characters no longer cause an error; they are simply
-output verbatim.  Additionally, the backslash is represented as
-@code{\\}.
-
-@samp{use_charnames_in_special} is currently used by @code{grohtml}
-only.
+If the @code{use_charnames_in_special} directive appears in the output
+device's @file{DESC} file, the use of special character escape sequences
+is @emph{not} an error; they are simply output verbatim (with the
+exception of the seven mapped to Unicode basic Latin characters,
+discussed above).  @code{use_charnames_in_special} is currently employed
+only by @code{grohtml}.
 @endDefesc
 
-@DefreqList {devicem, xx}
+@DefreqList {devicem, name}
 @DefescItemx {\\Y, , n, }
-@DefescItem {\\Y, @Lparen{}, nm, }
-@DefescListEnd {\\Y, @Lbrack{}, name, @Rbrack{}}
+@DefescItem {\\Y, (, nm, }
+@DefescListEnd {\\Y, , name, }
 This is approximately equivalent to @samp{\X'\*@var{name}'}
 (one-character name@tie{}@var{n}, two-character name @var{nm}).
 However, the contents of the string or macro @var{name} are not
 interpreted; also it is permitted for @var{name} to have been defined as
 a macro and thus contain newlines (it is not permitted for the argument
 to @code{\X} to contain newlines).  The inclusion of newlines requires
-an extension to the Unix @code{troff} output format, and confuses
-drivers that do not know about this extension (@pxref{Device Control
-Commands}).
+an extension to the @acronym{AT&T} @code{troff} output format, and
+confuses drivers that do not know about this extension (@pxref{Device
+Control Commands}).
 @endDefesc
 
-@xref{Output Devices}.
+@DefreqList {tag, name}
+@DefreqListEndx {taga, name}
+Reserved for internal use.
+@endDefreq
 
 
 @c =====================================================================
 
-@node Miscellaneous, Gtroff Internals, Postprocessor Access, gtroff Reference
+@node Miscellaneous, Gtroff Internals, Postprocessor Access, GNU troff Reference
 @section Miscellaneous
 
-This section documents parts of @code{gtroff} that cannot (yet) be
-categorized elsewhere in this manual.
+We document here GNU @code{troff} features that fit poorly elsewhere.
 
-@Defreq {nm, @Var{start} @Var{inc} @Var{space} @Var{indent}}
+@DefreqList {nm, @Var{start} @Var{increment} @Var{space} @Var{indentation}}
+@DefregItemx {ln}
+@DefregListEndx {.nm}
 @cindex printing line numbers (@code{nm})
 @cindex line numbers, printing (@code{nm})
 @cindex numbers, line, printing (@code{nm})
-Print line numbers.  @var{start} is the line number of the @emph{next}
-output line.  @var{inc} indicates which line numbers are printed.  For
-example, the value@tie{}5 means to emit only line numbers that are
-multiples of@tie{}5; this defaults to@tie{}1.  @var{space} is the space
-to be left between the number and the text; this defaults to one digit
-space.  The fourth argument is the indentation of the line numbers,
-defaulting to zero.  Both @var{space} and @var{indent} are given as
-multiples of digit spaces; they can be negative also.  Without any
-arguments, line numbers are turned off.
-
-@code{gtroff} reserves three digit spaces for the line number (which is
-printed right-justified) plus the amount given by @var{indent}; the
-output lines are concatenated to the line numbers, separated by
-@var{space}, and @emph{without} reducing the line length.  Depending on
-the value of the horizontal page offset (as set with the @code{po}
-request), line numbers that are longer than the reserved space stick
-out to the left, or the whole line is moved to the right.
-
-Parameters corresponding to missing arguments are not changed; any
-non-digit argument (to be more precise, any argument starting with a
-character valid as a delimiter for identifiers) is also treated as
-missing.
-
-If line numbering has been disabled with a call to @code{nm} without an
-argument, it can be reactivated with @samp{.nm +0}, using the previously
-active line numbering parameters.
-
-The parameters of @code{nm} are associated with the current environment
-(@pxref{Environments}).  The current output line number is available in
-the number register @code{ln}.
-
-@Example
-.po 1m
-.ll 2i
-This test shows how line numbering works with groff.
-.nm 999
-This test shows how line numbering works with groff.
-.br
-.nm xxx 3 2
-.ll -\w'0'u
-This test shows how line numbering works with groff.
-.nn 2
-This test shows how line numbering works with groff.
-@endExample
+Begin (or, with no arguments, cease) numbering output lines.
+@var{start} assigns the number of the @emph{next} output line.  Only
+line numbers divisible by @var{increment} are marked (default:
+@samp{1}).  @var{space} configures the horizontal spacing between the
+number and the text (default: @samp{1}).  Any given @var{indentation} is
+applied to the numbers (default: @samp{0}).  The third and fourth
+arguments are reckoned in numeral widths (@code{\0}).  @var{start} must
+be non-negative and @var{increment} positive.
+
+The formatter aligns the number to the right in a width of three numeral
+spaces plus @var{indentation}, then catenates @var{space} and the output
+line.  The line length is @emph{not} reduced.  Depending on the value of
+the page offset,@footnote{Recall @ref{Line Layout}.} numbers wider than
+the allocated space protrude into the left margin, or shift the output
+line to the right.
+
+Line numbering parameters corresponding to missing arguments are not
+altered.  After numbering is disabled, @samp{.nm +0} resumes it using
+the previously active parameters.
 
-@noindent
-And here the result:
+The parameters of @code{nm} are associated with the environment
+(@pxref{Environments}).
 
-@Example
- This  test shows how
- line numbering works
- 999 with   groff.   This
-1000 test shows how  line
-1001 numbering works with
-1002 groff.
-      This test shows how
-      line      numbering
- works  with  groff.
- This test shows how
-1005  line      numbering
-      works with groff.
+@cindex output line number register (@code{ln})
+@cindex line number, output, register (@code{ln})
+While numbering is enabled, the output line number register @code{ln} is
+updated as each line is output, even if no line number is formatted with
+it because it is being skipped (it is not a multiple of @var{increment})
+or because numbering is suppressed (see the @code{nn} request below).
+
+The @code{.nm} register tracks the enablement status of numbering.
+Temporary suspension of numbering with the @code{nn} request does
+@emph{not} alter its value.
+
+@Example
+.po 5n
+.ll 44n
+Programming,
+when stripped of all its circumstantial irrelevancies,
+.nm 999 1 1 -4
+boils down to no more and no less than
+.nm +0 3
+very effective thinking so as to avoid unmastered
+.nn 2
+complexity,
+to very vigorous separation of your many
+different concerns.
+.br
+\(em Edsger Dijkstra
+.sp
+.nm 1 1 1
+This guy's arrogance takes your breath away.
+.br
+\(em John Backus
+    @result{}      Programming,  when  stripped of all its cir-
+    @result{}  999 cumstantial irrelevancies, boils down to  no
+    @result{}      more  and no less than very effective think-
+    @result{}      ing so as to avoid unmastered complexity, to
+    @result{}      very vigorous separation of your  many  dif-
+    @result{}      ferent concerns.
+    @result{} 1002 -- Edsger Dijkstra
+    @result{}
+    @result{}    1 This guy@quoteright{}s arrogance takes your breath away.
+    @result{}    2 -- John Backus
 @endExample
 @endDefreq
 
-@Defreq {nn, @Var{skip}}
-Temporarily turn off line numbering.  The argument is the number of
-lines not to be numbered; this defaults to@tie{}1.
-@endDefreq
+@DefreqList {nn, @Var{skip}}
+@DefregListEndx {.nn}
+Suppress numbering of the next @var{skip} output lines that would
+otherwise be numbered.  The default is@tie{}1.  @code{nn} can be invoked
+when line numbering is not active; suppression of numbering will take
+effect for @var{skip} lines once @code{nm} enables it.
+
+The @code{.nn} register stores the count of output lines still to have
+their numbering suppressed.
+
+This count is associated with the environment (@pxref{Environments}).
+@endDefreq
+
+@need 1000
+To test whether the current output line will be numbered, you must check
+both the @code{.nm} and @code{.nn} registers.
+
+@Example
+  .de is-numbered
+  .  nop This line
+  .  ie (\\n.nm & (1-\\n.nn)) IS
+  .  el                           ISN'T
+  .  nop numbered.
+  .  br
+  ..
+  Test line numbering.
+  .is-numbered
+  .nm 1
+  .nn 1
+  .is-numbered
+  .is-numbered
+  .nm
+  .is-numbered
+    @result{} Test line numbering.  This line ISN@quoteright{}T numbered.
+    @result{} This line ISN@quoteright{}T numbered.
+    @result{}   1 This line IS numbered.
+    @result{} This line ISN@quoteright{}T numbered.
+@endExample
 
-@Defreq {mc, glyph @Var{dist}}
+@Defreq {mc, @Var{margin-character} @Var{distance}}
 @cindex margin glyph (@code{mc})
 @cindex glyph, for margins (@code{mc})
-Print a @dfn{margin character} to the right of the
-text.@footnote{@dfn{Margin character} is a misnomer since it is an
-output glyph.}  The first argument is the glyph to be printed.  The
-second argument is the distance away from the right margin.  If missing,
-the previously set value is used; default is 10@dmn{pt}).  For text
-lines that are too long (that is, longer than the text length plus
-@var{dist}), the margin character is directly appended to the lines.
+Begin (or, with no arguments, cease) writing a @dfn{margin-character} to
+the right of each output line.  The @var{distance} argument separates
+@var{margin-character} from the right margin.  If absent, the most
+recent value is used; the default is 10@tie{}points.  If an output line
+exceeds the line length, the margin character is appended to it.
+@cindex @code{tl} request, and @code{mc}
+No margin character is written on lines produced by the @code{tl}
+request.
 
-With no arguments the margin character is turned off.  If this occurs
-before a break, no margin character is printed.
+The margin character is a property of the output line; the margin
+character last configured when the line is output controls.  If the
+margin character is disabled before an output line breaks, none is
+output (but see below).
 
-For compatibility with @acronym{AT&T} @code{troff}, a call to @code{mc}
-to set the margin character can't be undone immediately; at least one
-line gets a margin character.  Thus
+The margin character is associated with the environment
+(@pxref{Environments}).
 
 @Example
-.ll 1i
+.ll 5i
+.nf
 .mc \br
-.mc
-xxx
-.br
-xxx
+This paragraph is marked with a margin character.
+.sp
+As seen above, vertical space isn't thus marked.
+\&
+An output line that is present, but empty, is.
+@c We deliberately overset these lines to mimic `mc`'s behavior.
+    @result{} This paragraph is marked with a margin character.  |
+    @result{}
+    @result{} As seen above, vertical space isn@quoteright{}t thus marked.   |
+    @result{}                                                    |
+    @result{} An output line that is present, but empty, is.     |
 @endExample
+@endDefreq
 
-@noindent
-produces
+For compatibility with @acronym{AT&T} @code{troff}, a call to @code{mc}
+to set the margin character can't be undone immediately; at least one
+line gets a margin character.
 
 @Example
-xxx        |
-xxx
+.ll 10n
+.nf
+.mc |
+.mc *
+.mc
+foo
+bar
+    @result{} foo        *
+    @result{} bar
 @endExample
 
-@cindex @code{tl} request, and @code{mc}
-For empty lines and lines produced by the @code{tl} request no margin
-character is emitted.
-
-The margin character is associated with the current environment
-(@pxref{Environments}).
-
+@pindex gdiffmk
 @pindex nrchbar
 @pindex changebar
-This is quite useful for indicating text that has changed, and, in fact,
-there are programs available for doing this (they are called
-@code{nrchbar} and @code{changebar} and can be found in any
-@samp{comp.sources.unix} archive).
-
-@Example
-.ll 3i
-.mc |
-This paragraph is highlighted with a margin
-character.
-.sp
-Note that vertical space isn't marked.
-.br
-\&
-.br
-But we can fake it with `\&'.
-@endExample
-
-Result:
+@pindex diffmk
+The margin character mechanism is commonly used to annotate changes in
+documents.  The @code{groff} distribution ships a program,
+@command{gdiffmk}, to assist with this task.@footnote{Historically,
+tools named @command{nrchbar} and @command{changebar} were developed for
+marking changes with margin characters and could be found in archives of
+the @code{comp.sources.unix} @acronym{USENET} group.  Some proprietary
+Unices also offer(ed) a @command{diffmk} program.}
 
-@Example
-This  paragraph is highlighted |
-with a margin character.       |
-
-Note that vertical space isn't |
-marked.                        |
-                               |
-But we can fake it with `\&'.  |
-@endExample
-@endDefreq
-
-@DefreqList {psbb, filename}
+@DefreqList {psbb, file}
 @DefregItemx {llx}
 @DefregItemx {lly}
 @DefregItemx {urx}
 @DefregListEndx {ury}
 @cindex PostScript, bounding box
 @cindex bounding box
-Retrieve the bounding box of the @sc{PostScript} image found in
-@var{filename}.  The file must conform to Adobe's @dfn{Document
-Structuring Conventions} (DSC); the command searches for a
-@code{%%BoundingBox} comment and extracts the bounding box values into
-the number registers @code{llx}, @code{lly}, @code{urx}, and @code{ury}.
-If an error occurs (for example, @code{psbb} cannot find the
-@code{%%BoundingBox} comment), it sets the four number registers to
-zero.
+Retrieve the bounding box of the PostScript image found in @var{file},
+which must conform to Adobe's @dfn{Document Structuring Conventions}
+(DSC), locate a @code{%%BoundingBox} comment, and store the (upper-,
+lower-, @w{-left}, @w{-right}) values into the registers @code{llx},
+@code{lly}, @code{urx}, and @code{ury}.  If an error occurs (for
+example, if no @code{%%BoundingBox} comment is present), the formatter
+sets these registers to@tie{}0.
 
-The search path for @var{filename} can be controlled with the
-@option{-I} command-line option.
+The search path for @var{file} can be controlled with the @option{-I}
+command-line option.
 @endDefreq
 
+@codequotebacktick off
+@codequoteundirected off
+
 
 @c =====================================================================
 
-@node Gtroff Internals, Debugging, Miscellaneous, gtroff Reference
+@node Gtroff Internals, Debugging, Miscellaneous, GNU troff Reference
 @section @code{gtroff} Internals
 
 @cindex input token
@@ -14229,9 +16431,9 @@
 @cindex node, output
 @code{gtroff} processes input in three steps.  One or more input
 characters are converted to an @dfn{input token}.@footnote{Except the
-escapes @code{\f}, @code{\F}, @code{\H}, @code{\m}, @code{\M},
+escape sequences @code{\f}, @code{\F}, @code{\H}, @code{\m}, @code{\M},
 @code{\R}, @code{\s}, and @code{\S}, which are processed immediately if
-not in copy-in mode.}  Then, one or more input tokens are converted to
+not in copy mode.}  Then, one or more input tokens are converted to
 an @dfn{output node}.  Finally, output nodes are converted to the
 intermediate output language understood by all output devices.
 
@@ -14254,7 +16456,7 @@
 
 Macros, diversions, and strings collect elements in two chained lists: a
 list of input tokens that have been passed unprocessed, and a list of
-output nodes.  Consider the following the diversion.
+output nodes.  Consider the following diversion.
 
 @Example
 .di xxx
@@ -14287,20 +16489,19 @@
 Elements 1, 7, and@tie{}8 are inserted by @code{gtroff}; the latter two
 (which are always present) specify the vertical extent of the last line,
 possibly modified by @code{\x}.  The @code{br} request finishes the
-current partial line, inserting a newline input token, which is
+pending output line, inserting a newline input token, which is
 subsequently converted to a space when the diversion is reread.  Note
-that the word space node has a fixed width that isn't stretchable
+that the word space node has a fixed width that isn't adjustable
 anymore.  To convert horizontal space nodes back to input tokens, use
 the @code{unformat} request.
 
 Macros only contain elements in the token list (and the node list is
 empty); diversions and strings can contain elements in both lists.
 
-Note that the @code{chop} request simply reduces the number of elements
-in a macro, string, or diversion by one.  Exceptions are
-@dfn{compatibility save} and @dfn{compatibility ignore} input tokens,
-which are ignored.  The @code{substring} request also ignores those
-input tokens.
+The @code{chop} request simply reduces the number of elements in a
+macro, string, or diversion by one.  Exceptions are @dfn{compatibility
+save} and @dfn{compatibility ignore} input tokens, which are ignored.
+The @code{substring} request also ignores those input tokens.
 
 Some requests like @code{tr} or @code{cflags} work on glyph identifiers
 only; this means that the associated glyph can be changed without
@@ -14335,7 +16536,7 @@
 @cindex parameters, and compatibility mode
 @cindex macro arguments, and compatibility mode
 @cindex request arguments, and compatibility mode
-Macro and request arguments preserve the compatibility mode:
+Macro and request arguments preserve compatibility mode enablement.
 
 @Example
 .cp 1     \" switch to compatibility mode
@@ -14348,141 +16549,160 @@
 @endExample
 
 @noindent
-Since compatibility mode is on while @code{de} is called, the macro
-@code{xx} activates compatibility mode while executing.  Argument
+Since compatibility mode is enabled while @code{de} is invoked, the
+macro @code{xx} enables compatibility mode when it is called.  Argument
 @code{$1} can still be handled properly because it inherits the
-compatibility mode status which was active at the point where @code{xx}
-is called.
+compatibility mode enablement status that was active at the point where
+@code{xx} was called.
 
-After expansion of the parameters, the compatibility save and restore
-tokens are removed.
+After interpolation of the parameters, the compatibility save and
+restore tokens are removed.
 
 
 @c =====================================================================
 
-@node Debugging, Implementation Differences, Gtroff Internals, gtroff Reference
+@codequotebacktick on
+@codequoteundirected on
+
+@need 1000
+@c BEGIN Keep parallel with section "Debugging" of groff(7).
+@node Debugging, Implementation Differences, Gtroff Internals, GNU troff Reference
 @section Debugging
 @cindex debugging
 
-@code{gtroff} is not easy to debug, but there are some useful features
-and strategies for debugging.
+@flushright
+@slanted{Standard troff voodoo, just put a power of two backslashes in
+front of it until it works and if you still have problems add a \c.}
+--- Ron Natalie
+@c https://minnie.tuhs.org/pipermail/tuhs/2021-February/023137.html
+@end flushright
+
+GNU @code{troff} is not the easiest language to debug, in part thanks to
+its design features of recursive interpolation and the use of
+multi-stage pipeline processing in the surrounding system.  Nevertheless
+there exist several features useful for troubleshooting.
+
+Preprocessors use the @code{lf} request to preserve the identity of the
+line numbers and names of input files.  GNU @code{troff} emits a variety
+of error diagnostics and supports several categories of warning; the
+output of these can be selectively suppressed.  A trace of the
+formatter's input processing stack can be emitted when errors or
+warnings occur by means of GNU @code{troff}'s @option{-b} option, or
+produced on demand with the @code{backtrace} request.  The @code{tm}
+and related requests can be used to emit customized diagnostic messages
+or for instrumentation while troubleshooting.  The @code{ex} and
+@code{ab} requests cause early termination with successful and error
+exit codes respectively, to halt further processing when continuing
+would be fruitless.  Examine the state of the formatter with requests
+that write lists of defined names (macros, strings, and diversions),
+environments, registers, and page location traps to the standard error
+stream.
+@c END Keep parallel with section "Debugging" of groff(7).
 
-@Defreq {lf, line @Var{filename}}
+@Defreq {lf, line @Var{file}}
 @pindex soelim
 @cindex multi-file documents
 @cindex documents, multi-file
 @cindex setting input line number (@code{lf})
 @cindex input line number, setting (@code{lf})
 @cindex number, input line, setting (@code{lf})
-Change the line number and optionally the file name @code{gtroff} shall
-use for error and warning messages.  @var{line} is the input line number
-of the @emph{next} line.
-
-Without argument, the request is ignored.
-
-This is a debugging aid for documents that are split into many files,
-then put together with @code{soelim} and other preprocessors.  Usually,
-it isn't invoked manually.
+Set the input line number (and, optionally, the file name) GNU
+@code{troff} shall use for error and warning messages.  @var{line} is
+the input line number of the @emph{next} line.  Without an argument, the
+request is ignored.
 
-Note that other @code{troff} implementations (including the original
-@acronym{AT&T} version) handle @code{lf} differently.  For them,
-@var{line} changes the line number of the @emph{current} line.
+@code{lf}'s primary purpose is to aid the debugging of documents that
+undergo preprocessing.  Programs like @command{tbl} that transform input
+in their own languages into @code{roff} requests use it so that any
+diagnostic messages emitted by @code{troff} correspond to the source
+document.
 @endDefreq
 
-@DefreqList {tm, string}
-@DefreqItemx {tm1, string}
-@DefreqListEndx {tmc, string}
+@DefreqList {tm, message}
+@DefreqItemx {tm1, message}
+@DefreqListEndx {tmc, message}
 @cindex printing to stderr (@code{tm}, @code{tm1}, @code{tmc})
 @cindex stderr, printing to (@code{tm}, @code{tm1}, @code{tmc})
-Send @var{string} to the standard error output; this is very useful for
-printing debugging messages among other things.
+Send @var{message}, which consumes the remainder of the input line and
+cannot contain special characters, to the standard error stream,
+followed by a newline.  Leading spaces in @var{message} are ignored.
 
-@cindex @code{tm} request, and copy-in mode
-@cindex copy-in mode, and @code{tm} request
-@cindex mode, copy-in, and @code{tm} request
-@cindex @code{tm1} request, and copy-in mode
-@cindex copy-in mode, and @code{tm1} request
-@cindex mode, copy-in, and @code{tm1} request
-@cindex @code{tmc} request, and copy-in mode
-@cindex copy-in mode, and @code{tmc} request
-@cindex mode, copy-in, and @code{tmc} request
-@var{string} is read in copy mode.
-
-The @code{tm} request ignores leading spaces of @var{string}; @code{tm1}
-handles its argument similar to the @code{ds} request: a leading double
-quote in @var{string} is stripped to allow initial blanks.
+@code{tm1} is similar, but recognizes and strips a leading neutral
+double quote from @var{message} to allow the embedding of leading
+spaces.
 
-The @code{tmc} request is similar to @code{tm1} but does not append a
-newline (as is done in @code{tm} and @code{tm1}).
+@code{tmc} works as @code{tm1}, but does not append a newline.
 @endDefreq
 
-@Defreq {ab, @Var{string}}
+@Defreq {ab, @Var{message}}
 @cindex aborting (@code{ab})
-Similar to the @code{tm} request, except that it causes @code{gtroff} to
-stop processing.  With no argument it prints @samp{User Abort.} to
-standard error.
+Write any @var{message} to the standard error stream (like @code{tm})
+and then abort GNU @code{troff}; that is, stop processing and terminate
+with a failure status.
 @endDefreq
 
 @Defreq {ex, }
 @cindex @code{ex} request, use in debugging
 @cindex exiting (@code{ex})
-The @code{ex} request also causes @code{gtroff} to stop processing; see
-also @ref{I/O}.
+Exit GNU @code{troff}; that is, stop processing and terminate with a
+successful status.  To stop processing only the current file, use the
+@code{nx} request; see @ref{I/O}.
 @endDefreq
 
-When doing something involved it is useful to leave the debugging
+When doing something involved, it is useful to leave the debugging
 statements in the code and have them turned on by a command-line flag.
 
 @Example
-.if \n(DB .tm debugging output
+.if \nDB .tm debugging output
 @endExample
 
 @noindent
-To activate these statements say
+To activate such statements, use the @option{-r} option to set the
+register.
 
 @Example
-groff -rDB=1 file
+groff -rDB=1 @slanted{file}
 @endExample
 
 If it is known in advance that there are many errors and no useful
-output, @code{gtroff} can be forced to suppress formatted output with
-the @option{-z} flag.
+output, GNU @code{troff} can be forced to suppress formatted output with
+the @option{-z} option.
 
 @Defreq {pev, }
 @cindex dumping environments (@code{pev})
 @cindex environments, dumping (@code{pev})
-Print the contents of the current environment and all the currently
-defined environments (both named and numbered) on @code{stderr}.
+Report the state of the current environment followed by that of all
+other environments to the standard error stream.
 @endDefreq
 
 @Defreq {pm, }
 @cindex dumping symbol table (@code{pm})
 @cindex symbol table, dumping (@code{pm})
-Print the entire symbol table on @code{stderr}.  Names of all defined
-macros, strings, and diversions are print together with their size in
-bytes.  Since @code{gtroff} sometimes adds nodes by itself, the returned
-size can be larger than expected.
-
-This request differs from Unix @code{troff}: @code{gtroff} reports the
-sizes of diversions, ignores an additional argument to print only the
-total of the sizes, and the size isn't returned in blocks of 128
-characters.
+Report, to the standard error stream, the names of all defined macros,
+strings, and diversions with their sizes in bytes.
 @endDefreq
 
 @Defreq {pnr, }
-@cindex dumping number registers (@code{pnr})
-@cindex number registers, dumping (@code{pnr})
-Print the names and contents of all currently defined number registers
-on @code{stderr}.
+@cindex dumping registers (@code{pnr})
+@cindex registers, dumping (@code{pnr})
+Report the names and contents of all currently defined registers to the
+standard error stream.
 @endDefreq
 
 @Defreq {ptr, }
-@cindex dumping traps (@code{ptr})
-@cindex traps, dumping (@code{ptr})
-Print the names and positions of all traps (not including input line
-traps and diversion traps) on @code{stderr}.  Empty slots in the page
-trap list are printed as well, because they can affect the priority of
-subsequently planted traps.
+@cindex dumping page location traps (@code{ptr})
+@cindex listing page location traps (@code{ptr})
+@cindex traps, page location, dumping (@code{ptr})
+@cindex traps, page location, listing (@code{ptr})
+Report the names and positions of all page location traps to the
+standard error stream.  Empty slots in the list, where a trap has been
+planted but subsequently (re)moved, are printed as well.
+@c "because they can affect the priority of subsequently planted traps."
+@c XXX Is that right?  It's useful to print the empty slots, I think,
+@c but a trap planted in an "empty" slot with .wh will become active.
+@c The slot seems to act as an immobile dummy list head, but does not
+@c change the basic list semantics.  .wh plants a trap at the head of
+@c the trap list at a location, and .ch plants a trap at the tail.
 @endDefreq
 
 @Defreq {fl, }
@@ -14502,9 +16722,9 @@
 @Defreq {backtrace, }
 @cindex backtrace of input stack (@code{backtrace})
 @cindex input stack, backtrace (@code{backtrace})
-Print a backtrace of the input stack to the standard error stream.
+Write the state of the input stack to the standard error stream.
 
-Consider the following in file @file{test}:
+Consider the following in a file @file{test}.
 
 @Example
 .de xxx
@@ -14515,44 +16735,37 @@
 ..
 .
 .yyy
+    @error{} troff: backtrace: 'test':2: macro 'xxx'
+    @error{} troff: backtrace: 'test':5: macro 'yyy'
+    @error{} troff: backtrace: file 'test':8
 @endExample
 
-@noindent
-On execution, @code{gtroff} prints the following:
-
-@Example
-test:2: backtrace: macro `xxx'
-test:5: backtrace: macro `yyy'
-test:8: backtrace: file `test'
-@endExample
-
-The option @option{-b} of @code{gtroff} internally calls a variant of
-this request on each error and warning.
+The @option{-b} option of GNU @code{troff} causes a backtrace to be
+generated on each error or warning.  Some warnings have to be enabled;
+@xref{Warnings}.
 @endDefreq
 
 @Defreg {slimit}
 @cindex input stack, setting limit
-Use the @code{slimit} number register to set the maximum number of
-objects on the input stack.  If @code{slimit} is less than or equal
-to@tie{}0, there is no limit set.  With no limit, a buggy recursive
-macro can exhaust virtual memory.
-
-The default value is 1000; this is a compile-time constant.
+If greater than@tie{}0, sets the maximum quantity of objects on GNU
+@code{troff}'s internal input stack.  If less than or equal to@tie{}0,
+there is no limit: recursion can continue until program memory is
+exhausted.  The default is 1,000.
 @endDefreg
 
-@Defreq {warnscale, si}
-Set the scaling indicator used in warnings to @var{si}.  Valid values
-for @var{si} are @samp{u}, @samp{i}, @samp{c}, @samp{p}, and @samp{P}.
-At startup, it is set to @samp{i}.
+@Defreq {warnscale, su}
+Set the scaling unit used in certain warnings @c `output_warning()`
+to @var{su}, which can take the values @samp{u}, @samp{i}, @samp{c},
+@samp{p}, and @samp{P}.  The default is @samp{i}.
 @endDefreq
 
 @Defreq {spreadwarn, @Var{limit}}
-Make @code{gtroff} emit a warning if the additional space inserted for
-each space between words in an output line is larger or equal to
-@var{limit}.  A negative value is changed to zero; no argument toggles
-the warning on and off without changing @var{limit}.  The default
-scaling indicator is @samp{m}.  At startup, @code{spreadwarn} is
-deactivated, and @var{limit} is set to 3@dmn{m}.
+Emit a @code{break} warning if the additional space inserted for each
+space between words in an output line adjusted to both margins with
+@w{@samp{.ad b}} is larger than or equal to @var{limit}.  A negative
+value is treated as zero; an absent argument toggles the warning on and
+off without changing @var{limit}.  The default scaling unit is @samp{m}.
+At startup, @code{spreadwarn} is inactive and @var{limit} is 3@dmn{m}.
 
 For example,
 
@@ -14561,31 +16774,29 @@
 @endExample
 
 @noindent
-causes a warning if @code{gtroff} must add 0.2@dmn{m} or more for each
-interword space in a line.
-
-This request is active only if text is justified to both margins (using
-@w{@samp{.ad b}}).
+causes a warning if @code{break} warnings are not suppressed and
+@code{gtroff} must add 0.2@dmn{m} or more for each inter-word space in a
+line.  @xref{Warnings}.
 @endDefreq
 
 @cindex warnings
-@code{gtroff} has command-line options for printing out more warnings
-(@option{-w}) and for printing backtraces (@option{-b}) when a warning
-or an error occurs.  The most verbose level of warnings is @option{-ww}.
+GNU @code{troff} has command-line options for reporting warnings
+(@option{-w}) and backtraces (@option{-b}) when a warning or an error
+occurs.
 
-@DefreqList {warn, @Var{flags}}
+@DefreqList {warn, @Var{n}}
 @DefregListEndx {.warn}
-@cindex level of warnings (@code{warn})
-@cindex warnings, level (@code{warn})
-Control the level of warnings checked for.  The @var{flags} are the sum
-of the numbers associated with each warning that is to be enabled; all
-other warnings are disabled.  The number associated with each warning is
-listed below.  For example, @w{@code{.warn 0}} disables all warnings,
-and @w{@code{.warn 1}} disables all warnings except that about missing
-glyphs.  If no argument is given, all warnings are enabled.
+@cindex warning level (@code{warn})
+Select the categories, or ``types'', of reported warnings.
+@var{n}@tie{}is the sum of the numeric codes associated with each
+warning category that is to be enabled; all other categories are
+disabled.  The categories and their associated codes are listed in
+@ref{Warnings}.  For example, @samp{.warn 0} disables all warnings, and
+@samp{.warn 1} disables all warnings except those about missing glyphs.
+If no argument is given, all warning categories are enabled.
 
-The read-only number register @code{.warn} contains the current warning
-level.
+The read-only register @code{.warn} contains the sum of the numeric
+codes of enabled warning categories.
 @endDefreq
 
 @menu
@@ -14594,63 +16805,79 @@
 
 @c ---------------------------------------------------------------------
 
+@c BEGIN Keep parallel with section "Warnings" of troff(1).
+@c Caveat: the man page sorts them by name, not number.
 @node Warnings,  , Debugging, Debugging
 @subsection Warnings
 @cindex warnings
 
-The warnings that can be given to @code{gtroff} are divided into the
-following categories.  The name associated with each warning is used by
-the @option{-w} and @option{-W} options; the number is used by the
-@code{warn} request and by the @code{.warn} register.
+Warning diagnostics emitted by GNU @code{troff} are divided into named,
+numbered categories.  The name associated with each warning category is
+used by the @option{-w} and @option{-W} options.  Each category is also
+assigned a power of two; the sum of enabled category values is used by
+the @code{warn} request and the @code{.warn} register.
+
+Warnings of each category are produced under the following
+circumstances.
 
+@cindex categories, warning
+@cindex warning categories
 @table @samp
 @item char
 @itemx 1
-Non-existent glyphs.@footnote{@code{char} is a misnomer since it reports
-missing glyphs -- there aren't missing input characters, only invalid
-ones.}  This is enabled by default.
+No mounted font defines a glyph for the requested character.  This
+category is enabled by default.
 
 @item number
 @itemx 2
-Invalid numeric expressions.  This is enabled by default.
-@xref{Expressions}.
+An invalid numeric expression was encountered.  This category is enabled
+by default.
+@xref{Numeric Expressions}.
 
 @item break
 @itemx 4
-@cindex fill mode
-@cindex mode, fill
-In fill mode, lines that could not be broken so that their length was
-less than the line length.  This is enabled by default.
+@cindex filling, and @code{break} warnings
+@cindex mode, fill, and @code{break} warnings
+A filled output line could not be broken such that its length was less
+than the output line length @samp{\n.l}.  This category is enabled by
+default.
 
 @item delim
 @itemx 8
-Missing or mismatched closing delimiters.
+The closing delimiter in an escape sequence was missing or mismatched.
 
 @item el
 @itemx 16
 @cindex @code{ie} request, and warnings
 @cindex @code{el} request, and warnings
-Use of the @code{el} request with no matching @code{ie} request.
-@xref{if-else}.
+The @code{el} request was encountered with no prior corresponding
+@code{ie} request.  @xref{if-else}.
 
 @item scale
 @itemx 32
-Meaningless scaling indicators.
+A scaling unit inappropriate to its context was used in a numeric
+expression.
 
 @item range
 @itemx 64
-Out of range arguments.
+A numeric expression was out of range for its context.
 
 @item syntax
 @itemx 128
-Dubious syntax in numeric expressions.
+A self-contradictory hyphenation mode was requested; an empty or
+incomplete numeric expression was encountered; an operand to a numeric
+operator was missing; an attempt was made to define a recursive, empty,
+or nonsensical character class; or a @code{groff} extension conditional
+expression operator was used while in compatibility mode.
 
 @item di
 @itemx 256
 @cindex @code{di} request, and warnings
 @cindex @code{da} request, and warnings
-Use of @code{di} or @code{da} without an argument when there is no
-current diversion.
+@cindex @code{box} request, and warnings
+@cindex @code{boxa} request, and warnings
+A @code{di}, @code{da}, @code{box}, or @code{boxa} request was invoked
+without an argument when there was no current diversion.
 
 @item mac
 @itemx 512
@@ -14662,179 +16889,317 @@
 @cindex @code{da} request, and warnings
 @cindex @code{box}, @code{boxa} requests, and warnings
 @cindex @code{\*}, and warnings
-Use of undefined strings, macros and diversions.  When an undefined
-string, macro, or diversion is used, that string is automatically
-defined as empty.  So, in most cases, at most one warning is given for
-each name.
+An undefined string, macro, or diversion was used.  When such an object
+is dereferenced, an empty one of that name is automatically created.
+So, unless it is later deleted, at most one warning is given for each.
+
+This warning is also emitted upon an attempt to move an unplanted trap
+macro (@pxref{Page Location Traps}).  In such cases, the unplanted macro
+is @emph{not} dereferenced, so it is not created if it does not exist.
 
 @item reg
 @itemx 1024
 @cindex @code{nr} request, and warnings
 @cindex @code{\R}, and warnings
 @cindex @code{\n}, and warnings
-Use of undefined number registers.  When an undefined number register is
-used, that register is automatically defined to have a value of@tie{}0.
-So, in most cases, at most one warning is given for use of a particular
-name.
+An undefined register was used.  When an undefined register is
+dereferenced, it is automatically defined with a value of@tie{}0.  So,
+unless it is later deleted, at most one warning is given for each.
 
 @item tab
 @itemx 2048
 @cindex @code{\t}, and warnings
-Use of a tab character where a number was expected.
+A tab character was encountered where a number was expected, or appeared
+in an unquoted macro argument.
 
 @item right-brace
 @itemx 4096
 @cindex @code{\@}}, and warnings
-Use of @code{\@}} where a number was expected.
+A right brace escape sequence @code{\@}} was encountered where a number
+was expected.
 
 @item missing
 @itemx 8192
-Requests that are missing non-optional arguments.
+A request was invoked with a mandatory argument absent.
 
 @item input
 @itemx 16384
-Invalid input characters.
+An invalid character occurred on the input stream.
 
 @item escape
 @itemx 32768
-Unrecognized escape sequences.  When an unrecognized escape sequence
-@code{\@var{X}} is encountered, the escape character is ignored, and
-@var{X} is printed.
+An unsupported escape sequence was encountered.
 
 @item space
 @itemx 65536
 @cindex compatibility mode
-Missing space between a request or macro and its argument.  This warning
-is given when an undefined name longer than two characters is
-encountered, and the first two characters of the name make a defined
-name.  The request or macro is not invoked.  When this warning is given,
-no macro is automatically defined.  This is enabled by default.  This
-warning never occurs in compatibility mode.
+A space was missing between a request or macro and its argument.  This
+warning is produced when an undefined name longer than two characters is
+encountered and the first two characters of the name constitute a
+defined name.  No request is invoked, no macro called, and an empty
+macro is not defined.  This category is enabled by default.  It never
+occurs in compatibility mode.
 
 @item font
 @itemx 131072
-Non-existent fonts.  This is enabled by default.
+A non-existent font was selected, or the selection was ignored because a
+font selection escape sequence was used after the output line
+continuation escape sequence on an input line.  This category is enabled
+by default.
 
 @item ig
 @itemx 262144
-Invalid escapes in text ignored with the @code{ig} request.  These are
-conditions that are errors when they do not occur in ignored text.
+An invalid escape sequence occurred in input ignored using the @code{ig}
+request.  This warning category diagnoses a condition that is an error
+when it occurs in non-ignored input.
 
 @item color
 @itemx 524288
-Color related warnings.
+An undefined color was selected, an attempt was made to define a color
+using an unrecognized color space, an invalid component in a color
+definition was encountered, or an attempt was made to redefine a default
+color.
 
 @item file
 @itemx 1048576
-Missing files.  The @code{mso} request gives this warning when the
-requested macro file does not exist.  This is enabled by default.
+An attempt was made to load a file that does not exist.  This category
+is enabled by default.
+@end table
+
+Two warning names group other warning categories for convenience.
 
+@table @samp
 @item all
-All warnings except @samp{di}, @samp{mac} and @samp{reg}.  It is
-intended that this covers all warnings that are useful with traditional
-macro packages.
+All warning categories except @samp{di}, @samp{mac} and @samp{reg}.
+This shorthand is intended to produce all warnings that are useful with
+macro packages written for @acronym{AT&T} @code{troff} and its
+descendants, which have less fastidious diagnostics than GNU
+@code{troff}.
 
 @item w
-All warnings.
+All warning categories.  Authors of documents and macro packages
+targeting @code{groff} are encouraged to use this setting.
 @end table
-
+@c END Keep parallel with section "Warnings" of troff(1).
 
 @c =====================================================================
 
-@node Implementation Differences,  , Debugging, gtroff Reference
+@node Implementation Differences, Safer Mode, Debugging, GNU troff Reference
 @section Implementation Differences
 @cindex implementation differences
 @cindex differences in implementation
 @cindex incompatibilities with @acronym{AT&T} @code{troff}
-@cindex compatibility mode
-@cindex mode, compatibility
 
 GNU @code{troff} has a number of features that cause incompatibilities
-with documents written with old versions of @code{troff}.
+with documents written for other versions of @code{troff}.  Some GNU
+extensions to @code{troff} have become supported by other
+implementations.
 
-@cindex long names
-@cindex names, long
-Long names cause some incompatibilities.  Unix @code{troff} interprets
+@menu
+* Safer Mode::
+* Compatibility Mode::
+* Other Differences::
+@end menu
 
-@Example
-.dsabcd
-@endExample
+@c ---------------------------------------------------------------------
+
+@node Safer Mode, Compatibility Mode, Implementation Differences, Implementation Differences
+@subsection Safer Mode
+@cindex safer mode
+@cindex mode, safer
+
+@cindex @code{pi} request, disabled by default
+@cindex @code{sy} request, disabled by default
+The formatter operates in ``safer'' mode by default; to mitigate risks
+from untrusted input documents, the @code{pi} and @code{sy} requests are
+disabled.  GNU @code{troff}'s @option{-U} option enables ``unsafe
+mode'', restoring their function and enabling additional @code{groff}
+extension requests, @code{open}, @code{opena}, and @code{pso}.
+@xref{I/O}.
+
+@c ---------------------------------------------------------------------
 
+@node Compatibility Mode, Safer Mode, Other Differences, Implementation Differences
+@subsection Compatibility Mode
+@cindex compatibility mode
+@cindex mode, compatibility
+
+@cindex long names
+@cindex names, long
 @cindex @code{\*}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\n}, incompatibilities with @acronym{AT&T} @code{troff}
-@noindent
-as defining a string @samp{ab} with contents @samp{cd}.  Normally, GNU
-@code{troff} interprets this as a call of a macro named @code{dsabcd}.
-Also Unix @code{troff} interprets @code{\*} or @code{\n} as references
-to a string or number register called @samp{}.  In GNU @code{troff},
-however, this is normally interpreted as the start of a long name.  In
-compatibility mode GNU @code{troff} interprets long names in the
-traditional way (which means that they are not recognized as names).
+Long identifier names may be GNU @code{troff}'s most obvious innovation.
+@acronym{AT&T} @code{troff} interprets @samp{.dsabcd} as defining a
+string @samp{ab} with contents @samp{cd}.  Normally, GNU @code{troff}
+interprets this as a call of a macro named @code{dsabcd}.
+@acronym{AT&T} @code{troff} also interprets @samp{\*} and @samp{\n} as
+an interpolation of a string or register, respectively, named @samp{}.
+In GNU @code{troff}, however, the @samp{} is normally interpreted as
+delimiting a long name.  In compatibility mode, GNU @code{troff}
+interprets names in the traditional way; they thus can be two characters
+long at most.
 
 @DefreqList {cp, @Var{n}}
-@DefreqItemx {do, cmd}
 @DefregListEndx {.C}
 If @var{n} is missing or non-zero, turn on compatibility mode;
 otherwise, turn it off.
 
-The read-only number register @code{.C} is@tie{}1 if compatibility mode
-is on, 0@tie{}otherwise.
+The read-only register @code{.C} is@tie{}1 if compatibility mode is on,
+0@tie{}otherwise.
 
 Compatibility mode can be also turned on with the @option{-C}
 command-line option.
+@endDefreq
 
-The @code{do} request turns off compatibility mode while executing its
-arguments as a @code{gtroff} command.  However, it does not turn off
-compatibility mode while processing the macro itself.  To do that, use
-the @code{de1} request (or manipulate the @code{.C} register manually).
-@xref{Writing Macros}.
+@DefreqList {do, name}
+@DefregListEndx {.cp}
+The @code{do} request interprets the string, request, diversion, or
+macro @var{name} (along with any further arguments) with compatibility
+mode disabled.  Compatibility mode is restored (only if it was active)
+when the @emph{expansion} of @var{name} is interpreted; that is, the
+restored compatibility state applies to the contents of the macro,
+string, or diversion @var{name} as well as data read from files or pipes
+if @var{name} is any of the @code{so}, @code{soquiet}, @code{mso},
+@code{msoquiet}, or @code{pso} requests.
 
-@Example
-.do fam T
-@endExample
+The following example illustrates several aspects of @code{do} behavior.
 
-@noindent
-executes the @code{fam} request when compatibility mode is enabled.
-
-@code{gtroff} restores the previous compatibility setting before
-interpreting any files sourced by the @var{cmd}.
+@Example
+.de mac1
+FOO
+..
+.de1 mac2
+groff
+.mac1
+..
+.de mac3
+compatibility
+.mac1
+..
+.de ma
+\\$1
+..
+.cp 1
+.do mac1
+.do mac2 \" mac2, defined with .de1, calls "mac1"
+.do mac3 \" mac3 calls "ma" with argument "c1"
+.do mac3 \ti \" groff syntax accepted in .do arguments
+    @result{} FOO groff FOO compatibility c1 ~
+@endExample
+
+The read-only register @code{.cp}, meaningful only when dereferenced
+from a @code{do} request, is@tie{}1 if compatibility mode was on when
+the @code{do} request was encountered, and 0@tie{}if it was not.  This
+register is specialized and may require a statement of rationale.
+
+When writing macro packages or documents that use GNU @code{troff}
+features and which may be mixed with other packages or documents that do
+not---common scenarios include serial processing of man pages or use of
+the @code{so} or @code{mso} requests---you may desire correct operation
+regardless of compatibility mode enablement in the surrounding context.
+It may occur to you to save the existing value of @samp{\n(.C} into a
+register, say, @samp{_C}, at the beginning of your file, turn
+compatibility mode off with @samp{.cp 0}, then restore it from that
+register at the end with @samp{.cp \n(_C}.  At the same time, a modular
+design of a document or macro package may lead you to multiple layers of
+inclusion.  You cannot use the same register name everywhere lest you
+``clobber'' the value from a preceding or enclosing context.  The
+two-character register name space of @acronym{AT&T} @code{troff} is
+confining and mnemonically challenging; you may wish to use the more
+capacious name space of GNU @code{troff}.  However, attempting @samp{.nr
+_my_saved_C \n(.C} will not work in compatibility mode; the register
+name is too long.  ``This is exactly what @code{do} is for,'' you think,
+@samp{.do nr _my_saved_C \n(.C}.  The foregoing will always save zero to
+your register, because @code{do} turns compatibility mode @emph{off}
+while it interprets its argument list.
+
+@need 375 @c 250 < x < 500
+To robustly save compatibility mode before switching it off, use
+
+@Example
+.do nr _my_saved_C \n.cp
+.cp 0
+@endExample
+
+at the beginning of your file, followed by
+
+@Example
+.cp \n_my_saved_C
+.do rr _my_saved_C
+@endExample
+
+at the end.  As in the C language, we all have to share one big
+name space, so choose a register name that is unlikely to collide with
+other uses.
 @endDefreq
 
 @cindex input level in delimited arguments
+@cindex interpolation depth in delimited arguments
 @cindex delimited arguments, incompatibilities with @acronym{AT&T} @code{troff}
-Two other features are controlled by @option{-C}.  If not in
-compatibility mode, GNU @code{troff} preserves the input level in
-delimited arguments:
+Normally, GNU @code{troff} preserves the interpolation depth in
+delimited arguments, but not in compatibility mode.
 
 @Example
 .ds xx '
 \w'abc\*(xxdef'
+    @result{} 168 @r{(normal mode on a terminal device)}
+    @result{} 72def' @r{(compatibility mode on a terminal device)}
 @endExample
 
-@noindent
-In compatibility mode, the string @samp{72def'} is returned; without
-@option{-C} the resulting string is @samp{168} (assuming a TTY output
-device).
-
 @cindex @code{\f}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\H}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\s}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\S}, incompatibilities with @acronym{AT&T} @code{troff}
-Finally, the escapes @code{\f}, @code{\H}, @code{\m}, @code{\M},
-@code{\R}, @code{\s}, and @code{\S} are transparent for recognizing the
-beginning of a line only in compatibility mode (this is a rather obscure
-feature).  For example, the code
+Furthermore, the escape sequences @code{\f}, @code{\H}, @code{\m},
+@code{\M}, @code{\R}, @code{\s}, and @code{\S} are transparent for the
+purpose of recognizing a control character at the beginning of a line
+only in compatibility mode.  For example, this code produces bold output
+in both cases, but the text differs.
 
 @Example
 .de xx
 Hello!
 ..
 \fB.xx\fP
+    @result{} .xx @r{(normal mode)}
+    @result{} Hello! @r{(compatibility mode)}
 @endExample
 
-@noindent
-prints @samp{Hello!} in bold face if in compatibility mode, and
-@samp{.xx} in bold face otherwise.
+@cindex @code{\s}, incompatibilities with @acronym{AT&T} @code{troff}
+Normally, the syntax form @code{\s}@var{n} accepts only a single
+character (a digit) for @var{n}, consistently with other forms that
+originated in @acronym{AT&T} @code{troff}, like @code{\*}, @code{\$},
+@code{\f}, @code{\g}, @code{\k}, @code{\n}, and @code{\z}.  In
+compatibility mode only, a non-zero@tie{}@var{n} must be in the range
+4--39.  Legacy documents relying upon this quirk of parsing@footnote{The
+Graphic Systems C/A/T phototypesetter (the original device target for
+@acronym{AT&T} @code{troff}) supported only a few discrete type sizes
+in the range 6--36 points, so Ossanna contrived a special case in the
+parser to do what the user must have meant.  Kernighan warned of this in
+the 1992 revision of CSTR@tie{}#54 (§2.3), and more recently, McIlroy
+referred to it as a ``living fossil''.} should be migrated to another
+@code{\s} form.
+
+@c ---------------------------------------------------------------------
+
+@node Other Differences, , Compatibility Mode, Implementation Differences
+@subsection Other Differences
+
+@code{groff} request names unrecognized by other @code{troff}
+implementations will likely be ignored by them; escape sequences that
+are @code{groff} extensions are liable to be interpreted as if the
+escape character were not present.
+@cindex @code{\~}, incompatibilities with @acronym{AT&T} @code{troff}
+For example, the adjustable, non-breaking escape sequence @code{\~}
+@c BEGIN Keep in sync with groff_diff(7) and groff_man_style(7).
+is also supported by Heirloom Doctools @code{troff} 050915 (September
+2005), @code{mandoc} 1.9.5 (2009-09-21), @code{neatroff} (commit
+1c6ab0f6e, 2016-09-13), and Plan@tie{}9 from User Space @code{troff}
+(commit 93f8143600, 2022-08-12), but not by Solaris or Documenter's
+Workbench @code{troff}s.
+@c as of this writing, 2022-08-13
+@c END Keep in sync with groff_diff(7) and groff_man_style(7).
+@xref{Manipulating Filling and Adjustment}.
 
 @cindex @code{\A}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{\|}, incompatibilities with @acronym{AT&T} @code{troff}
@@ -14853,10 +17218,60 @@
 GNU @code{troff} does not allow the use of the escape sequences
 @code{\|}, @code{\^}, @code{\&}, @code{\@{}, @code{\@}},
 @code{\@key{SP}}, @code{\'}, @code{\`}, @code{\-}, @code{\_}, @code{\!},
-@code{\%}, and @code{\c} in names of strings, macros, diversions, number
-registers, fonts or environments; Unix @code{troff} does.  The @code{\A}
-escape sequence (@pxref{Identifiers}) may be helpful in avoiding use of
-these escape sequences in names.
+@code{\%}, and @code{\c} in identifiers; @acronym{AT&T} @code{troff}
+does.  The @code{\A} escape sequence (@pxref{Identifiers}) may be
+helpful in avoiding use of these escape sequences in names.
+
+@cindex adjustment to both margins, difference from @acronym{AT&T} @code{troff}
+@cindex rivers
+When adjusting to both margins, @acronym{AT&T} @code{troff} at first
+adjusts spaces starting from the right; GNU @code{troff} begins from
+the left.  Both implementations adjust spaces from opposite ends on
+alternating output lines in this adjustment mode to prevent ``rivers''
+in the text.
+
+@cindex hyphenation, incompatibilities with @acronym{AT&T} @code{troff}
+GNU @code{troff} does not always hyphenate words as @acronym{AT&T}
+@code{troff} does.  The @acronym{AT&T} implementation uses a set of
+hard-coded rules specific to English, while GNU @code{troff} uses
+language-specific hyphenation pattern files derived from @TeX{}.
+Furthermore, in old versions of @code{troff} there was a limited amount
+of space to store hyphenation exceptions (arguments to the @code{hw}
+request); GNU @code{troff} has no such restriction.
+
+@cindex output device name string (@code{.T}), in other implementations
+GNU @code{troff} predefines a string @code{.T} containing the argument
+given to the @option{-T} command-line option, namely the current output
+device (for example, @samp{pdf} or @samp{utf8}).  The existence of this
+string is a common feature of post-CSTR@tie{}#54
+@code{troff}s@footnote{DWB@tie{}3.3, Solaris, Heirloom Doctools, and
+Plan@tie{}9 @code{troff} all support it.} but valid values are specific
+to each implementation.
+
+@cindex removal of read-only registers, incompatibility with @acronym{AT&T} @code{troff}
+@cindex register, read-only, removal, incompatibility with @acronym{AT&T} @code{troff}
+@cindex read-only register removal, incompatibility with @acronym{AT&T} @code{troff}
+@acronym{AT&T} @code{troff} ignored attempts to remove read-only
+registers; GNU @code{troff} honors such requests.  @xref{Built-in
+Registers}.
+
+@cindex output device usage register (@code{.T}), incompatibility with @acronym{AT&T} @code{troff}
+The (read-only) register @code{.T} interpolates@tie{}1 if GNU
+@code{troff} is called with the @option{-T} command-line option, and
+0@tie{}otherwise.  This behavior differs from AT&T @code{troff}, which
+interpolated@tie{}1 only if @code{nroff} was the formatter and was
+called with @option{-T}.
+
+@cindex @code{lf} request, incompatibilities with @acronym{AT&T} @code{troff}
+@acronym{AT&T} @code{troff} and other implementations handle the
+@code{lf} request differently.  For them, its @var{line} argument
+changes the line number of the @emph{current} line.
+
+@cindex environment availability and naming, incompatibilities with
+@acronym{AT&T} @code{troff} had only environments named @samp{0},
+@samp{1}, and @samp{2}.  In GNU @code{troff}, any number of environments
+may exist, using any valid identifiers for their names
+(@pxref{Identifiers}.)
 
 @cindex fractional point sizes
 @cindex fractional type sizes
@@ -14864,40 +17279,57 @@
 @cindex type sizes, fractional
 @cindex sizes, fractional
 @cindex @code{ps} request, incompatibilities with @acronym{AT&T} @code{troff}
-Fractional point sizes cause one noteworthy incompatibility.  In
-Unix @code{troff} the @code{ps} request ignores scale indicators and
-thus
-
-@Example
-.ps 10u
-@endExample
-
-@noindent
-sets the point size to 10@tie{}points, whereas in GNU @code{troff} it
-sets the point size to 10@tie{}scaled points.  @xref{Fractional Type
-Sizes}, for more information.
+Fractional type sizes cause one noteworthy incompatibility.  In
+@acronym{AT&T} @code{troff} the @code{ps} request ignores scaling units
+and thus @samp{.ps 10u} sets the type size to 10@tie{}points, whereas in
+GNU @code{troff} it sets the type size to 10@tie{}@emph{scaled} points.
+@xref{Using Fractional Type Sizes}.
+
+@cindex @code{ab} request, incompatibilities with @acronym{AT&T} @code{troff}
+The @code{ab} request differs from @acronym{AT&T} @code{troff}:
+GNU @code{troff} writes no message to the standard error stream if no
+arguments are given, and it exits with a failure status instead of a
+successful one.
+
+@cindex @code{bp} request, incompatibilities with @acronym{AT&T} @code{troff}
+The @code{bp} request differs from @acronym{AT&T} @code{troff}:
+GNU @code{troff} does not accept a scaling unit on the argument, a page
+number; the former (somewhat uselessly) does.
+
+@cindex @code{pm} request, incompatibilities with @acronym{AT&T} @code{troff}
+The @code{pm} request differs from @acronym{AT&T} @code{troff}:
+GNU @code{troff} reports the sizes of macros, strings, and diversions in
+bytes and ignores an argument to report only the sum of the sizes.
+
+@cindex @code{ss} request, incompatibilities with @acronym{AT&T} @code{troff}
+Unlike @acronym{AT&T} @code{troff}, GNU @code{troff} does not ignore the
+@code{ss} request if the output is a terminal device; instead, the
+values of minimal inter-word and additional inter-sentence space are
+each rounded down to the nearest multiple of@tie{}12.
 
 @cindex @code{bd} request, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{cs} request, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{tr} request, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex @code{fp} request, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex input characters and output glyphs, compatibility with @acronym{AT&T} @code{troff}
-@cindex output glyphs, and input characters,compatibility with @acronym{AT&T} @code{troff}
+@cindex output glyphs, and input characters, compatibility with @acronym{AT&T} @code{troff}
 @cindex characters, input, and output glyphs, compatibility with @acronym{AT&T} @code{troff}
 @cindex glyphs, output, and input characters, compatibility with @acronym{AT&T} @code{troff}
 In GNU @code{troff} there is a fundamental difference between
-(unformatted) input characters and (formatted) output glyphs.
-Everything that affects how a glyph is output is stored with the glyph
-node; once a glyph node has been constructed it is unaffected by any
-subsequent requests that are executed, including @code{bd}, @code{cs},
-@code{tkf}, @code{tr}, or @code{fp} requests.  Normally glyphs are
-constructed from input characters at the moment immediately before the
-glyph is added to the current output line.  Macros, diversions and
-strings are all, in fact, the same type of object; they contain lists of
-input characters and glyph nodes in any combination.  A glyph node does
-not behave like an input character for the purposes of macro processing;
-it does not inherit any of the special properties that the input
+(unformatted) characters and (formatted) glyphs.  Everything that
+affects how a glyph is output is stored with the glyph node; once a
+glyph node has been constructed, it is unaffected by any subsequent
+requests that are executed, including @code{bd}, @code{cs}, @code{tkf},
+@code{tr}, or @code{fp} requests.  Normally, glyphs are constructed from
+characters immediately before the glyph is added to an output line.
+Macros, diversions, and strings are all, in fact, the same type of
+object; they contain a sequence of intermixed character and glyph nodes.
+Special characters transform from one to the other:@: before being added
+to the output, they behave as characters; afterward, they are glyphs.  A
+glyph node does not behave like a character node when it is processed by
+a macro:@: it does not inherit any of the special properties that the
 character from which it was constructed might have had.  For example,
+the input
 
 @Example
 .di x
@@ -14907,6 +17339,14 @@
 .x
 @endExample
 
+@noindent
+produces @samp{\\} in GNU @code{troff}.  Each pair of backslashes
+becomes one backslash @emph{glyph}; the resulting backslashes are thus
+not interpreted as escape @emph{characters} when they are reread as the
+diversion is output.  @acronym{AT&T} @code{troff} @emph{would} interpret
+them as escape characters when rereading them and end up printing one
+@samp{\}.
+
 @cindex printing backslash (@code{\\}, @code{\e}, @code{\E}, @code{\rs})
 @cindex backslash, printing (@code{\\}, @code{\e}, @code{\E}, @code{\rs})
 @cindex @code{\e}, incompatibilities with @acronym{AT&T} @code{troff}
@@ -14914,916 +17354,44 @@
 @cindex @code{\?}, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex transparent output, incompatibilities with @acronym{AT&T} @code{troff}
 @cindex output, transparent, incompatibilities with @acronym{AT&T} @code{troff}
-@noindent
-prints @samp{\\} in GNU @code{troff}; each pair of input backslashes is
-turned into one output backslash and the resulting output backslashes
-are not interpreted as escape characters when they are reread.
-Unix @code{troff} would interpret them as escape characters when they
-were reread and would end up printing one @samp{\}.  The correct way to
-obtain a printable backslash is to use the @code{\e} escape sequence:
-This always prints a single instance of the current escape character,
-regardless of whether or not it is used in a diversion; it also works in
-both GNU @code{troff} and Unix @code{troff}.@footnote{To be completely
-independent of the current escape character, use @code{\(rs}, which
-represents a reverse solidus (backslash) glyph.}  To store, for some
-reason, an escape sequence in a diversion that is interpreted when the
+One correct way to obtain a printable backslash in most documents is to
+use the @code{\e} escape sequence; this always prints a single instance
+of the current escape character,@footnote{Naturally, if you've changed
+the escape character, you need to prefix the @code{e} with whatever it
+is---and you'll likely get something other than a backslash in the
+output.} regardless of whether or not it is used in a diversion; it
+also works in both GNU @code{troff} and @acronym{AT&T} @code{troff}.
+
+The other correct way, appropriate in contexts independent of the
+backslash's common use as a @code{troff} escape character---perhaps in
+discussion of character sets or other programming languages---is
+the character escape @code{\(rs} or @code{\rs}, for ``reverse
+solidus'', from its name in the @acronym{ECMA-6} (@acronym{ISO/IEC} 646)
+standard.@footnote{The @code{rs} special character identifier was not
+defined in @acronym{AT&T} @code{troff}'s font description files, but is
+in those of its lineal descendant, Heirloom Doctools @code{troff}, as of
+the latter's 060716 release (July 2006).}
+
+To store an escape sequence in a diversion that is interpreted when the
 diversion is reread, either use the traditional @code{\!} transparent
 output facility, or, if this is unsuitable, the new @code{\?} escape
-sequence.
-
-@xref{Diversions}, and @ref{Gtroff Internals}, for more information.
-
-
-
-@c =====================================================================
-@c =====================================================================
+sequence.  @xref{Diversions} and @ref{Gtroff Internals}.
 
-@node Preprocessors, Output Devices, gtroff Reference, Top
-@chapter Preprocessors
-@cindex preprocessors
-
-This chapter describes all preprocessors that come with @code{groff} or
-which are freely available.
-
-@menu
-* geqn::
-* gtbl::
-* gpic::
-* ggrn::
-* grap::
-* gchem::
-* grefer::
-* gsoelim::
-* preconv::
-@end menu
-
-
-@c =====================================================================
-
-@node geqn, gtbl, Preprocessors, Preprocessors
-@section @code{geqn}
-@cindex @code{eqn}, the program
-@cindex @code{geqn}, the program
-
-@c XXX
-
-@menu
-* Invoking geqn::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking geqn,  , geqn, geqn
-@subsection Invoking @code{geqn}
-@cindex invoking @code{geqn}
-@cindex @code{geqn}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node gtbl, gpic, geqn, Preprocessors
-@section @code{gtbl}
-@cindex @code{tbl}, the program
-@cindex @code{gtbl}, the program
-
-@c XXX
-
-@menu
-* Invoking gtbl::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gtbl,  , gtbl, gtbl
-@subsection Invoking @code{gtbl}
-@cindex invoking @code{gtbl}
-@cindex @code{gtbl}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node gpic, ggrn, gtbl, Preprocessors
-@section @code{gpic}
-@cindex @code{pic}, the program
-@cindex @code{gpic}, the program
-
-@c XXX
-
-@menu
-* Invoking gpic::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gpic,  , gpic, gpic
-@subsection Invoking @code{gpic}
-@cindex invoking @code{gpic}
-@cindex @code{gpic}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node ggrn, grap, gpic, Preprocessors
-@section @code{ggrn}
-@cindex @code{grn}, the program
-@cindex @code{ggrn}, the program
-
-@c XXX
-
-@menu
-* Invoking ggrn::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking ggrn,  , ggrn, ggrn
-@subsection Invoking @code{ggrn}
-@cindex invoking @code{ggrn}
-@cindex @code{ggrn}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node grap, gchem, ggrn, Preprocessors
-@section @code{grap}
-@cindex @code{grap}, the program
-
-A free implementation of @code{grap}, written by Ted Faber,
-is available as an extra package from the following address:
-
-@display
-@uref{http://www.lunabase.org/~faber/Vault/software/grap/}
-@end display
-
-
-@c =====================================================================
-
-@node gchem, grefer, grap, Preprocessors
-@section @code{gchem}
-@cindex @code{chem}, the program
-@cindex @code{gchem}, the program
-
-@c XXX
-
-@menu
-* Invoking gchem::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gchem,  , gchem, gchem
-@subsection Invoking @code{gchem}
-@cindex invoking @code{gchem}
-@cindex @code{gchem}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node grefer, gsoelim, gchem, Preprocessors
-@section @code{grefer}
-@cindex @code{refer}, the program
-@cindex @code{grefer}, the program
-
-@c XXX
-
-@menu
-* Invoking grefer::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grefer,  , grefer, grefer
-@subsection Invoking @code{grefer}
-@cindex invoking @code{grefer}
-@cindex @code{grefer}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node gsoelim, preconv, grefer, Preprocessors
-@section @code{gsoelim}
-@cindex @code{soelim}, the program
-@cindex @code{gsoelim}, the program
-
-@c XXX
-
-@menu
-* Invoking gsoelim::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gsoelim,  , gsoelim, gsoelim
-@subsection Invoking @code{gsoelim}
-@cindex invoking @code{gsoelim}
-@cindex @code{gsoelim}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-
-@node preconv,  , gsoelim, Preprocessors
-@section @code{preconv}
-@cindex @code{preconv}, the program
-
-@c XXX
-
-@menu
-* Invoking preconv::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking preconv,  , preconv, preconv
-@subsection Invoking @code{preconv}
-@cindex invoking @code{preconv}
-@cindex @code{preconv}, invoking
-
-@c XXX
-
-
-@c =====================================================================
-@c =====================================================================
-
-@node Output Devices, File formats, Preprocessors, Top
-@chapter Output Devices
-@cindex output devices
-@cindex devices for output
-
-@c XXX
-
-@menu
-* Special Characters::
-* grotty::
-* grops::
-* gropdf::
-* grodvi::
-* grolj4::
-* grolbp::
-* grohtml::
-* gxditview::
-@end menu
-
-
-@c =====================================================================
-
-@node Special Characters, grotty, Output Devices, Output Devices
-@section Special Characters
-@cindex special characters
-@cindex characters, special
-
-@c XXX
-
-@xref{Font Files}.
-
-
-@c =====================================================================
-
-@node grotty, grops, Special Characters, Output Devices
-@section @code{grotty}
-@cindex @code{grotty}, the program
-
-The postprocessor @code{grotty} translates the output from GNU
-@code{troff} into a form suitable for typewriter-like devices.  It is
-fully documented on its manual page, @cite{grotty(1)}.
-
-@menu
-* Invoking grotty::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grotty,  , grotty, grotty
-@subsection Invoking @code{grotty}
-@cindex invoking @code{grotty}
-@cindex @code{grotty}, invoking
-
-The postprocessor @command{grotty} accepts the following command-line
-options:
-
-@table @option
-@item -b
-Do not overstrike bold glyphs.  Ignored if @option{-c} isn't used.
-
-@item -B
-Do not underline bold-italic glyphs.  Ignored if @option{-c} isn't
-used.
-
-@item -c
-Use overprint and disable colours for printing on legacy Teletype
-printers (see below).
-
-@item -d
-Do not render lines (that is, ignore all @code{\D} escapes).
-
-@item -f
-Use form feed control characters in the output.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font and device description files, given the
-target device @var{name}.
-
-@item -h
-Use horizontal tabs for sequences of 8 space characters.
-
-@item -i
-Request italic glyphs from the terminal.  Ignored if @option{-c} is
-active.
-
-@item -o
-Do not overstrike.
-
-@item -r
-Highlight italic glyphs.  Ignored if @option{-c} is active.
-
-@item -u
-Do not underline italic glyphs.  Ignored if @option{-c} isn't used.
-
-@item -U
-Do not overstrike bold-italic glyphs.  Ignored if @option{-c} isn't
-used.
-
-@item -v
-Print the version number.
-@end table
-
-@pindex less
-@cindex Teletype
-@cindex ISO 6249 SGR
-@cindex terminal control sequences
-@cindex control sequences, for terminals
-The @option{-c} mode for TTY output devices means that underlining is
-done by emitting sequences of @samp{_} and @samp{^H} (the backspace
-character) before the actual character.  Literally, this is printing
-an underline character, then moving the caret back one character
-position, and printing the actual character at the same position as
-the underline character (similar to a typewriter).  Usually, a modern
-terminal can't interpret this (and the original Teletype machines for
-which this sequence was appropriate are no longer in use).  You need
-a pager program like @code{less} that translates this into
-ISO@tie{}6429 SGR sequences to control terminals.
-
-
-@c =====================================================================
-
-@node grops, gropdf, grotty, Output Devices
-@section @code{grops}
-@cindex @code{grops}, the program
-
-The postprocessor @command{grops} translates the output from GNU
-@command{troff} into a form suitable for Adobe @sc{PostScript}
-devices.  It is fully documented on its manual page, @cite{grops(1)}.
-
-
-@menu
-* Invoking grops::
-* Embedding PostScript::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grops, Embedding PostScript, grops, grops
-@subsection Invoking @code{grops}
-@cindex invoking @code{grops}
-@cindex @code{grops}, invoking
-
-The postprocessor @code{grops} accepts the following command-line
-options:
-
-@table @option
-@item -b@var{flags}
-Use backward compatibility settings given by @var{flags} as
-documented in the @cite{grops(1)} manual page.  Overrides the command
-@option{broken} in the @file{DESC} file.
-
-@item -c@var{n}
-Print @var{n} copies of each page.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font, prologue and device description files,
-given the target device @var{name}, usually @strong{ps}.
-
-@item -g
-Tell the printer to guess the page length.  Useful for printing
-vertically centered pages when the paper dimensions are determined at
-print time.
-
-@item -I@var{path} @dots{}
-Consider the directory @file{@var{path}} for searching included files
-specified with relative paths.  The current directory is searched as
-fallback.
-
-@item -l
-Use landscape orientation.
-
-@item -m
-Use manual feed.
-
-@item -p@var{papersize}
-Set the page dimensions.  Overrides the commands @option{papersize},
-@option{paperlength}, and @option{paperwidth} in the @file{DESC}
-file.  See the @cite{groff_font(5)} manual page for details.
-
-@item -P@var{prologue}
-Use the @var{prologue} in the font path as the prologue instead of
-the default @file{prologue}.  Overrides the environment variable
-@env{GROPS_PROLOGUE}.
-
-@item -w@var{n}
-Set the line thickness to @var{n}/1000@dmn{em}.  Overrides the
-default value @var{n} = 40.
-
-@item -v
-Print the version number.
-@end table
-
-@c ---------------------------------------------------------------------
-
-@node Embedding PostScript,  , Invoking grops, grops
-@subsection Embedding @sc{PostScript}
-@cindex embedding PostScript
-@cindex PostScript, embedding
-
-The escape sequence
-
-@code{\X'ps: import @var{file} @var{llx} @var{lly} @var{urx} @var{ury}
-  @var{width} @var{height}'}
-
-@noindent
-places a rectangle of the specified @var{width} containing the
-@sc{PostScript} drawing from file @var{file} bound by the box from
-@var{llx} @var{lly} to @var{urx} @var{ury} (in @sc{PostScript}
-coordinates) at the insertion point.  If @var{height} is not
-specified, the embedded drawing is scaled proportionally.
-
-@xref{Miscellaneous}, for the @code{psbb} request, which automatically
-generates the bounding box.
-
-This escape sequence is used internally by the macro @code{PSPIC}
-(see the @cite{groff_tmac(5)} manual page).
-
-
-@c =====================================================================
-
-@node gropdf, grodvi, grops, Output Devices
-@section @code{gropdf}
-@cindex @code{gropdf}, the program
-
-The postprocessor @command{gropdf} translates the output from GNU
-@command{troff} into a form suitable for Adobe PDF devices.  It is fully
-documented on its manual page, @cite{gropdf(1)}.
-
-@menu
-* Invoking gropdf::
-* Embedding PDF::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gropdf, Embedding PDF, gropdf, gropdf
-@subsection Invoking @code{gropdf}
-@cindex invoking @code{gropdf}
-@cindex @code{gropdf}, invoking
-
-The postprocessor @code{gropdf} accepts the following command-line
-options:
-
-@table @option
-@item -d
-Produce uncompressed PDFs that include debugging comments.
-
-@item -e
-This forces @code{gropdf} to embed all used fonts in the PDF,
-even if they are one of the 14 base Adobe fonts.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font, prologue and device description files,
-given the target device @var{name}, usually @strong{pdf}.
+In the somewhat pathological case where a diversion exists containing a
+partially collected line and a partially collected line at the top-level
+diversion has never existed, @acronym{AT&T} @code{troff} will output the
+partially collected line at the end of input; GNU @code{troff} will not.
 
-@item -y@var{foundry}
-This forces the use of a different font foundry.
+@codequotebacktick off
+@codequoteundirected off
 
-@item -l
-Use landscape orientation.
-
-@item -p@var{papersize}
-Set the page dimensions.  Overrides the commands @option{papersize},
-@option{paperlength}, and @option{paperwidth} in the @file{DESC}
-file.  See the @cite{groff_font(5)} manual page for details.
-
-@item -v
-Print the version number.
-
-@item -s
-Append a comment line to end of PDF showing statistics, i.e. number of
-pages in document.  Ghostscript's @cite{ps2pdf(1)} complains about this
-line if it is included, but works anyway.
-
-@item -u@var{filename}
-@code{gropdf} normally includes a ToUnicode CMap with any font created
-using @file{text.enc} as the encoding file, this makes it easier to
-search for words that contain ligatures.  You can include your own CMap
-by specifying a @var{filename} or have no CMap at all by omitting the
-@var{filename}.
-@end table
-
-@c ---------------------------------------------------------------------
-
-@node Embedding PDF,  , Invoking gropdf, gropdf
-@subsection Embedding PDF
-@cindex embedding PDF
-@cindex PDF, embedding
-
-The escape sequence
-
-@code{\X'pdf: pdfpic @var{file} @var{alignment} @var{width} @var{height}
-  @var{linelength}'}
-
-@noindent
-places a rectangle of the specified @var{width} containing the PDF
-drawing from file @var{file} of desired @var{width} and @var{height} (if
-@var{height} is missing or zero then it is scaled proportionally).  If
-@var{alignment} is @code{-L} the drawing is left aligned.  If it is
-@code{-C} or @code{-R} a @var{linelength} greater than the width of the
-drawing is required as well.  If @var{width} is specified as zero then
-the width is scaled in proportion to the height.
-
-
-@c =====================================================================
-
-@node grodvi, grolj4, gropdf, Output Devices
-@section @code{grodvi}
-@cindex @code{grodvi}, the program
-
-The postprocessor @command{grodvi} translates the output from GNU
-@command{troff} into the @strong{DVI} output format compatible with
-the @strong{@TeX{}} document preparation system.  It is fully
-documented on its manual page, @cite{grodvi(1)}.
-
-@menu
-* Invoking grodvi::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grodvi,  , grodvi, grodvi
-@subsection Invoking @code{grodvi}
-@cindex invoking @code{grodvi}
-@cindex @code{grodvi}, invoking
-
-The postprocessor @code{grodvi} accepts the following command-line
-options:
-
-@table @option
-@item -d
-Do not use @strong{tpic} specials to implement drawing commands.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font and device description files, given the
-target device @var{name}, usually @strong{dvi}.
-
-@item -l
-Use landscape orientation.
-
-@item -p@var{papersize}
-Set the page dimensions.  Overrides the commands @option{papersize},
-@option{paperlength}, and @option{paperwidth} in the @file{DESC}
-file.  See @cite{groff_font(5)} manual page for details.
-
-@item -v
-Print the version number.
-
-@item -w@var{n}
-Set the line thickness to @var{n}/1000@dmn{em}.  Overrides the
-default value @var{n} = 40.
-@end table
 
 
 @c =====================================================================
-
-@node grolj4, grolbp, grodvi, Output Devices
-@section @code{grolj4}
-@cindex @code{grolj4}, the program
-
-The postprocessor @command{grolj4} translates the output from GNU
-@command{troff} into the @strong{PCL5} output format suitable for
-printing on a @strong{HP LaserJet@tie{}4} printer.  It is fully
-documented on its manual page, @cite{grolj4(1)}.
-
-@menu
-* Invoking grolj4::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grolj4,  , grolj4, grolj4
-@subsection Invoking @code{grolj4}
-@cindex invoking @code{grolj4}
-@cindex @code{grolj4}, invoking
-
-The postprocessor @code{grolj4} accepts the following command-line
-options:
-
-@table @option
-@item -c@var{n}
-Print @var{n} copies of each page.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font and device description files, given the
-target device @var{name}, usually @strong{lj4}.
-
-@item -l
-Use landscape orientation.
-
-@item -p@var{size}
-Set the page dimensions.  Valid values for @var{size} are:
-@code{letter}, @code{legal}, @code{executive}, @code{a4},
-@code{com10}, @code{monarch}, @code{c5}, @code{b5}, @code{d1}.
-
-@item -v
-Print the version number.
-
-@item -w@var{n}
-Set the line thickness to @var{n}/1000@dmn{em}.  Overrides the
-default value @var{n} = 40.
-@end table
-
-The special drawing command @code{\D'R @var{dh} @var{dv}'} draws a
-horizontal rectangle from the current position to the position at
-offset (@var{dh},@var{dv}).
-
-
 @c =====================================================================
 
-@node grolbp, grohtml, grolj4, Output Devices
-@section @code{grolbp}
-@cindex @code{grolbp}, the program
-
-The postprocessor @command{grolbp} translates the output from GNU
-@command{troff} into the @strong{LBP} output format suitable for
-printing on @strong{Canon CAPSL} printers.  It is fully documented on
-its manual page, @cite{grolbp(1)}.
-
-@menu
-* Invoking grolbp::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grolbp,  , grolbp, grolbp
-@subsection Invoking @code{grolbp}
-@cindex invoking @code{grolbp}
-@cindex @code{grolbp}, invoking
-
-The postprocessor @code{grolbp} accepts the following command-line
-options:
-
-@table @option
-@item -c@var{n}
-Print @var{n} copies of each page.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font, prologue and device description files,
-given the target device @var{name}, usually @strong{lbp}.
-
-@item -l
-Use landscape orientation.
-
-@item -o@var{orientation}
-Use the @var{orientation} specified: @code{portrait} or
-@code{landscape}.
-
-@item -p@var{papersize}
-Set the page dimensions.  See @cite{groff_font(5)} manual page for
-details.
-
-@item -w@var{n}
-Set the line thickness to @var{n}/1000@dmn{em}.  Overrides the
-default value @var{n} = 40.
-
-@item -v
-Print the version number.
-
-@item -h
-Print command-line help.
-@end table
-
-
-@c =====================================================================
-
-@node grohtml, gxditview, grolbp, Output Devices
-@section @code{grohtml}
-@cindex @code{grohtml}, the program
-
-The @code{grohtml} front end (which consists of a preprocessor,
-@code{pre-grohtml}, and a device driver, @code{post-grohtml}) translates
-the output of GNU @code{troff} to @acronym{HTML}.  Users should always
-invoke @code{grohtml} via the @code{groff} command with a @code{\-Thtml}
-option.  If no files are given, @code{grohtml} will read the standard
-input.  A filename of @code{-} will also cause @code{grohtml} to read
-the standard input.  @acronym{HTML} output is written to the standard
-output.  When @code{grohtml} is run by @code{groff}, options can be
-passed to @code{grohtml} using @code{groff}'s @option{-P} option.
-
-@code{grohtml} invokes @code{groff} twice.  In the first pass, pictures,
-equations, and tables are rendered using the @code{ps} device, and in
-the second pass @acronym{HTML} output is generated by the @code{html}
-device.
-
-@code{grohtml} always writes output in @code{UTF-8} encoding and has
-built-in entities for all non-composite unicode characters.  In spite of
-this, @code{groff} may issue warnings about unknown special characters
-if they can't be found during the first pass.  Such warnings can be
-safely ignored unless the special characters appear inside a table or
-equation, in which case glyphs for these characters must be defined for
-the @code{ps} device as well.
-
-This output device is fully documented on its manual page,
-@cite{grohtml(1)}.
-
-@menu
-* Invoking grohtml::
-* grohtml specific registers and strings::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking grohtml, grohtml specific registers and strings, grohtml, grohtml
-@subsection Invoking @code{grohtml}
-@cindex invoking @code{grohtml}
-@cindex @code{grohtml}, invoking
-
-The postprocessor @code{grohtml} accepts the following command-line
-options:
-
-@table @option
-@item -a@var{bits}
-Use this number of @var{bits} (= 1, 2 or 4) for text antialiasing.
-Default: @var{bits} = 4.
-
-@item -a0
-Do not use text antialiasing.
-
-@item -b
-Use white background.
-
-@item -D@var{dir}
-Store rendered images in the directory @file{@var{dir}}.
-
-@item -F@var{dir}
-Put the directory @file{@var{dir}/dev@var{name}} in front of the
-search path for the font, prologue and device description files,
-given the target device @var{name}, usually @strong{html}.
-
-@item -g@var{bits}
-Use this number of @var{bits} (= 1, 2 or 4) for antialiasing of
-drawings.  Default: @var{bits} = 4.
-
-@item -g0
-Do not use antialiasing for drawings.
-
-@item -h
-Use the @code{B} element for section headings.
-
-@item -i@var{resolution}
-Use the @var{resolution} for rendered images.  Default:
-@var{resolution} = 100@dmn{dpi}.
-
-@item -I@var{stem}
-Set the images' @var{stem name}.  Default: @var{stem} =
-@file{grohtml-@var{XXX}} (@var{XXX} is the process ID).
-
-@item -j@var{stem}
-Place each section in a separate file called
-@file{@var{stem}-@var{n}.html} (where @var{n} is a generated section
-number).
-
-@item -l
-Do not generate the table of contents.
-
-@item -n
-Generate simple fragment identifiers.
-
-@item -o@var{offset}
-Use vertical padding @var{offset} for images.
-
-@item -p
-Display the page rendering progress to @code{stderr}.
-
-@item -r
-Do not use horizontal rules to separate headers and footers.
-
-@item -s@var{size}
-Set the base font size, to be modified using the elements @code{BIG}
-and @code{SMALL}.
-
-@item -S@var{level}
-Generate separate files for sections at level @var{level}.
-
-@item -v
-Print the version number.
-
-@item -V
-Generate a validator button at the bottom.
-
-@item -y
-Generate a signature of groff after the validator button, if any.
-@end table
-
-
-@c ---------------------------------------------------------------------
-
-@node grohtml specific registers and strings,  , Invoking grohtml, grohtml
-@subsection @code{grohtml} specific registers and strings
-@cindex registers specific to @code{grohtml}
-@cindex strings specific to @code{grohtml}
-@cindex @code{grohtml}, registers and strings
-
-@DefmpregList {ps4html, grohtml}
-@DefstrListEndx {www-image-template, grohtml}
-The registers @code{ps4html} and @code{www-image-template} are defined
-by the @code{pre-grohtml} preprocessor.  @code{pre-grohtml} reads in the
-@code{troff} input, marks up the inline equations and passes the result
-firstly to
-
-@Example
-troff -Tps -rps4html=1 -dwww-image-template=@var{template}
-@endExample
-
-@noindent
-and secondly to
-
-@Example
-troff -Thtml
-@endExample
-
-@noindent
-or
-
-@Example
-troff -Txhtml
-@endExample
-
-@cindex MathML
-The @sc{PostScript} device is used to create all the image files (for
-@option{-Thtml}; if @option{-Txhtml} is used, all equations are passed
-to @code{geqn} to produce @acronym{MathML}, and the register
-@code{ps4html} enables the macro sets to ignore floating keeps, footers,
-and headings.
-
-The register @code{www-image-template} is set to the user specified
-template name or the default name.
-@endDefmpreg
-
-
-@c =====================================================================
-
-@node gxditview,  , grohtml, Output Devices
-@section @code{gxditview}
-@cindex @code{gxditview}, the program
-
-@c XXX
-
-@menu
-* Invoking gxditview::
-@end menu
-
-@c ---------------------------------------------------------------------
-
-@node Invoking gxditview,  , gxditview, gxditview
-@subsection Invoking @code{gxditview}
-@cindex invoking @code{gxditview}
-@cindex @code{gxditview}, invoking
-
-@c XXX
-@c X11's xditview
-
-
-
-@c =====================================================================
-@c =====================================================================
-
-@node File formats, Installation, Output Devices, Top
-@chapter File formats
+@node File Formats, Copying This Manual, GNU troff Reference, Top
+@chapter File Formats
 @cindex file formats
 @cindex formats, file
 
@@ -15832,39 +17400,43 @@
 
 @menu
 * gtroff Output::
-* Font Files::
+* Device and Font Description Files::
 @end menu
 
 
 @c =====================================================================
 
-@node gtroff Output, Font Files, File formats, File formats
+@codequotebacktick on
+@codequoteundirected on
+
+@c BEGIN TODO: Make parallel with groff_out(5).
+@node gtroff Output, Device and Font Description Files, File Formats, File Formats
 @section @code{gtroff} Output
 @cindex @code{gtroff}, output
 @cindex output, @code{gtroff}
 
-This section describes the intermediate output format of GNU
-@code{troff}.  This output is produced by a run of @code{gtroff} before
-it is fed into a device postprocessor program.
-
-As @code{groff} is a wrapper program around @code{gtroff} that
-automatically calls a postprocessor, this output does not show up
-normally.  This is why it is called @dfn{intermediate}.  @code{groff}
-provides the option @option{-Z} to inhibit postprocessing, such that the
-produced intermediate output is sent to standard output just like
-calling @code{gtroff} manually.
+This section describes the @code{groff} intermediate output format
+produced by GNU @code{troff}.
+
+As @code{groff} is a wrapper program around GNU @code{troff} and
+automatically calls an output driver (or ``postprocessor''), this output
+does not show up normally.  This is why it is called
+@emph{intermediate}.  @code{groff} provides the option @option{-Z} to
+inhibit postprocessing such that the produced intermediate output is
+sent to standard output just as it is when calling GNU @code{troff}
+directly.
 
-@cindex troff output
-@cindex output, troff
+@cindex @code{troff} output
+@cindex output, @code{troff}
 @cindex intermediate output
 @cindex output, intermediate
 Here, the term @dfn{troff output} describes what is output by
-@code{gtroff}, while @dfn{intermediate output} refers to the language
-that is accepted by the parser that prepares this output for the
-postprocessors.  This parser is smarter on whitespace and implements
-obsolete elements for compatibility, otherwise both formats are the
-same.@footnote{The parser and postprocessor for intermediate output can
-be found in the file@*
+GNU @code{troff}, while @dfn{intermediate output} refers to the language
+that is accepted by the parser that prepares this output for the output
+drivers.  This parser handles whitespace more flexibly than
+@acronym{AT&T}'s implementation and implements obsolete elements for
+compatibility; otherwise, both formats are the same.@footnote{The parser
+and postprocessor for intermediate output can be found in the file@*
 @file{@var{groff-source-dir}/src/libs/libdriver/input.cpp}.}
 
 The main purpose of the intermediate output concept is to facilitate the
@@ -15893,14 +17465,20 @@
 @node Language Concepts, Command Reference, gtroff Output, gtroff Output
 @subsection Language Concepts
 
-During the run of @code{gtroff}, the input data is cracked down to the
-information on what has to be printed at what position on the intended
-device.  So the language of the intermediate output format can be quite
-small.  Its only elements are commands with and without arguments.  In
-this section, the term @dfn{command} always refers to the intermediate
-output language, and never to the @code{gtroff} language used for
-document formatting.  There are commands for positioning and text
-writing, for drawing, and for device controlling.
+The fundamental operation of the GNU @code{troff} formatter is the
+translation of the @code{groff} input language into a device-independent
+form primarily concerned with what has to be written or drawn at
+specific positions on the output device.  This language is simple and
+imperative.  In the following discussion, the term @dfn{command} always
+refers to this intermediate output language, and never to the
+@code{groff} language intended for direct use by document authors.
+Intermediate output commands comprise several categories: glyph output;
+font, color, and text size selection; motion of the printing position;
+page advancement; drawing of geometric objects; and device control
+commands, a catch-all for operations not easily classified as any of the
+foregoing, such as directives to start and stop output, identify the
+intended output device, or place URL hyperlinks in supported output
+formats.
 
 @menu
 * Separation::
@@ -15911,12 +17489,12 @@
 @node Separation, Argument Units, Language Concepts, Language Concepts
 @subsubsection Separation
 
-@acronym{AT&T} @code{troff} output has strange requirements on
-whitespace.  The @code{gtroff} output parser, however, is smart about
-whitespace by making it maximally optional.  The whitespace characters,
-i.e., the tab, space, and newline characters, always have a syntactical
-meaning.  They are never printable because spacing within the output is
-always done by positioning commands.
+@acronym{AT&T} @code{troff} output has strange requirements regarding
+whitespace.  The @code{gtroff} output parser, however, is more tolerant,
+making whitespace maximally optional.  Such characters, i.e., the tab,
+space, and newline, always have a syntactical meaning.  They are never
+printable because spacing within the output is always done by
+positioning commands.
 
 Any sequence of space or tab characters is treated as a single
 @dfn{syntactical space}.  It separates commands and arguments, but is
@@ -15939,12 +17517,12 @@
 at least one argument is followed by a line break, thus providing
 excellent readability.
 
-The other commands -- those for drawing and device controlling -- have a
+The other commands---those for drawing and device controlling---have a
 more complicated structure; some recognize long command names, and some
 take a variable number of arguments.  So all @samp{D} and @samp{x}
 commands were designed to request a syntactical line break after their
 last argument.  Only one command, @w{@samp{x X}}, has an argument that
-can stretch over several lines; all other commands must have all of
+can span several input lines; all other commands must have all of
 their arguments on the same line as the command, i.e., the arguments may
 not be split by a line break.
 
@@ -15955,16 +17533,16 @@
 @subsubsection Argument Units
 
 Some commands take integer arguments that are assumed to represent
-values in a measurement unit, but the letter for the corresponding scale
-indicator is not written with the output command arguments.  Most
-commands assume the scale indicator @samp{u}, the basic unit of the
-device, some use @samp{z}, the scaled point unit of the device, while
-others, such as the color commands, expect plain integers.
-
-Note that single characters can have the eighth bit set, as can the
-names of fonts and special characters.  The names of characters and
-fonts can be of arbitrary length.  A character that is to be printed is
-always in the current font.
+values in a measurement unit, but the letter for the corresponding
+scaling unit is not written with the output command arguments.  Most
+commands assume the scaling unit @samp{u}, the basic unit of the device,
+some use @samp{z}, the scaled point unit of the device, while others,
+such as the color commands, expect plain integers.
+
+Single characters can have the eighth bit set, as can the names of
+fonts and special characters.  The names of characters and fonts can be
+of arbitrary length.  A character that is to be printed is always in
+the current font.
 
 A string argument is always terminated by the next whitespace character
 (space, tab, or newline); an embedded @samp{#} character is regarded as
@@ -15991,8 +17569,8 @@
 
 @noindent
 with the arguments set as outlined in @ref{Device Control Commands}.
-Note that the parser for the intermediate output format is able to
-swallow additional whitespace and comments as well even in the prologue.
+The parser for the intermediate output format is able to interpret
+additional whitespace and comments as well even in the prologue.
 
 The body is the main section for processing the document data.
 Syntactically, it is a sequence of any commands different from the ones
@@ -16041,12 +17619,12 @@
 
 The commands in this subsection have a command code consisting of a
 single character, taking a fixed number of arguments.  Most of them are
-commands for positioning and text writing.  These commands are smart
-about whitespace.  Optionally, syntactical space can be inserted before,
+commands for positioning and text writing.  These commands are tolerant
+of whitespace.  Optionally, syntactical space can be inserted before,
 after, and between the command letter and its arguments.  All of these
-commands are stackable, i.e., they can be preceded by other simple
+commands are stackable; i.e., they can be preceded by other simple
 commands or followed by arbitrary other commands on the same line.  A
-separating syntactical space is only necessary when two integer
+separating syntactical space is necessary only when two integer
 arguments would clash or if the preceding argument ends with a string
 argument.
 
@@ -16070,124 +17648,121 @@
 \}              \" endif @USE_ENV_STACK
 @end ignore
 
-@item C @var{xxx}@angles{whitespace}
-Print a special character named @var{xxx}.  The trailing syntactical
-space or line break is necessary to allow glyph names of arbitrary
-length.  The glyph is printed at the current print position; the glyph's
-size is read from the font file.  The print position is not changed.
+@item C @var{id}@angles{whitespace}
+Typeset the glyph of the special character @var{id}.  Trailing
+syntactical space is necessary to allow special character names of
+arbitrary length.  The drawing position is not advanced.
 
 @item c @var{g}
-Print glyph@tie{}@var{g} at the current print
-position;@footnote{@samp{c} is actually a misnomer since it outputs a
-glyph.} the glyph's size is read from the font file.  The print position
-is not changed.
+Typeset the glyph of the ordinary character@tie{}@var{c}.  The drawing
+position is not advanced.
 
 @item f @var{n}
-Set font to font number@tie{}@var{n} (a non-negative integer).
+Select the font mounted at position@tie{}@var{n}.  @var{n}@tie{}cannot
+be negative.
 
 @item H @var{n}
-Move right to the absolute vertical position@tie{}@var{n} (a
-non-negative integer in basic units @samp{u} relative to left edge of
-current page.
+Horizontally move the drawing position to @var{n}@tie{}basic units from
+the left edge of the page.  @var{n}@tie{}cannot be negative.
 
 @item h @var{n}
-Move @var{n} (a non-negative integer) basic units @samp{u} horizontally
-to the right.  The original Unix troff manual allows negative
-values for @var{n} also, but @code{gtroff} doesn't use this.
+Move the drawing position right @var{n} basic units.  @acronym{AT&T}
+@code{troff} allowed negative @var{n}; GNU @code{troff} does not produce
+such values, but @code{groff}'s output driver library handles them.
 
 @item m @var{color-scheme} @r{}@var{component} @dots{}@r{}
-Set the color for text (glyphs), line drawing, and the outline of
-graphic objects using different color schemes; the analogous command
-for the filling color of graphic objects is @samp{DF}.  The color
-components are specified as integer arguments between 0 and 65536.  The
-number of color components and their meaning vary for the different
-color schemes.  These commands are generated by @code{gtroff}'s escape
-sequence @code{\m}.  No position changing.  These commands are a
-@code{gtroff} extension.
+Select the stroke color using the @var{component}s in the color space
+@var{scheme}.  Each @var{component} is an integer between 0 and 65535.
+The quantity of components and their meanings vary with each
+@var{scheme}.  This command is a @code{groff} extension.
 
 @table @code
 @item mc @var{cyan} @var{magenta} @var{yellow}
-Set color using the CMY color scheme, having the 3@tie{}color components
-@var{cyan}, @var{magenta}, and @var{yellow}.
+Use the CMY color scheme with components cyan, magenta, and yellow.
 
 @item md
-Set color to the default color value (black in most cases).  No
-component arguments.
+Use the default color (no components; black in most cases).
 
 @item mg @var{gray}
-Set color to the shade of gray given by the argument, an integer between
-0 (black) and 65536 (white).
+Use a grayscale color scheme with a component ranging between 0 (black)
+and 65535 (white).
 
 @item mk @var{cyan} @var{magenta} @var{yellow} @var{black}
-Set color using the CMYK color scheme, having the 4@tie{}color
-components @var{cyan}, @var{magenta}, @var{yellow}, and @var{black}.
+Use the CMYK color scheme with components cyan, magenta, yellow, and
+black.
 
 @item mr @var{red} @var{green} @var{blue}
-Set color using the RGB color scheme, having the 3@tie{}color components
-@var{red}, @var{green}, and @var{blue}.
+Use the RGB color scheme with components red, green, and blue.
 @end table
 
 @item N @var{n}
-Print glyph with index@tie{}@var{n} (a non-negative integer) of the
-current font.  This command is a @code{gtroff} extension.
+Typeset the glyph with index@tie{}@var{n} in the current font.
+@var{n}@tie{}is normally a non-negative integer.  The drawing position
+is not advanced.  The @code{html} and @code{xhtml} devices use this
+command with negative@tie{}@var{n} to produce unbreakable space; the
+absolute value of @var{n} is taken and interpreted in basic units.
 
 @item n @var{b} @var{a}
-Inform the device about a line break, but no positioning is done by this
-command.  In @acronym{AT&T} @code{troff}, the integer arguments @var{b}
-and@tie{}@var{a} informed about the space before and after the current
-line to make the intermediate output more human readable without
-performing any action.  In @code{groff}, they are just ignored, but they
-must be provided for compatibility reasons.
+Indicate a break.  No action is performed; the command is present to
+make the output more easily parsed.  The integers @var{b}
+and@tie{}@var{a} describe the vertical space amounts before and after
+the break, respectively.  GNU @code{troff} issues this command but
+@code{groff}'s output driver library ignores it.  See @code{v} and
+@code{V} below.
 
 @item p @var{n}
-Begin a new page in the outprint.  The page number is set
-to@tie{}@var{n}.  This page is completely independent of pages formerly
-processed even if those have the same page number.  The vertical
-position on the outprint is automatically set to@tie{}0.  All
-positioning, writing, and drawing is always done relative to a page, so
-a @samp{p} command must be issued before any of these commands.
+Begin a new page, setting its number to@tie{}@var{n}.  Each page is
+independent, even from those using the same number.  The vertical
+drawing position is set to@tie{}0.  All positioning, writing, and
+drawing commands are interpreted in the context of a page, so a
+@code{p}@tie{}command must precede them.
 
 @item s @var{n}
-Set point size to @var{n}@tie{}scaled points (this is unit @samp{z}).
-@acronym{AT&T} @code{troff} used the unit points (@samp{p}) instead.
-@xref{Output Language Compatibility}.
-
-@item t @var{xxx}@angles{whitespace}
-@itemx t @var{xxx} @var{dummy-arg}@angles{whitespace}
-Print a word, i.e., a sequence of characters @var{xxx} representing
-output glyphs which names are single characters, terminated by a space
+Set type size to @var{n} scaled points (unit@tie{}@code{z} in GNU
+@code{troff}.
+@acronym{AT&T} @code{troff} used unscaled points @code{p} instead;
+see @ref{Output Language Compatibility}.
+
+@item t @var{xyz}@angles{whitespace}
+@itemx t @var{xyz} @var{dummy-arg}@angles{whitespace}
+Typeset a word @var{xyz}; that is, set a sequence of ordinary glyphs
+named @var{x}, @var{y}, @var{z}, @dots{}, terminated by a space
 character or a line break; an optional second integer argument is
 ignored (this allows the formatter to generate an even number of
-arguments).  The first glyph should be printed at the current position,
-the current horizontal position should then be increased by the width of
-the first glyph, and so on for each glyph.  The widths of the glyphs are
-read from the font file, scaled for the current point size, and rounded
-to a multiple of the horizontal resolution.  Special characters cannot
-be printed using this command (use the @samp{C} command for special
-characters).  This command is a @code{gtroff} extension; it is only used
-for devices whose @file{DESC} file contains the @code{tcommand} keyword
-(@pxref{DESC File Format}).
-
-@item u @var{n} @var{xxx}@angles{whitespace}
-Print word with track kerning.  This is the same as the @samp{t} command
-except that after printing each glyph, the current horizontal position
-is increased by the sum of the width of that glyph and@tie{}@var{n} (an
-integer in basic units @samp{u}).  This command is a @code{gtroff}
-extension; it is only used for devices whose @file{DESC} file contains
-the @code{tcommand} keyword (@pxref{DESC File Format}).
+arguments). @c XXX: Why?
+Each glyph is set at the current drawing position, and the position is
+then advanced horizontally by the glyph's width.  A glyph's width is
+read from its metrics in the font description file, scaled to the
+current type size, and rounded to a multiple of the horizontal motion
+quantum.  Use the @code{C} command to emplace glyphs of special
+characters.  The @code{t}@tie{}command is a @code{groff} extension and
+is output only for devices whose @file{DESC} file contains the
+@code{tcommand} directive; see @ref{DESC File Format}.
+
+@item u @var{n} @var{xyz}@angles{whitespace}
+Typeset word @var{xyz} with track kerning.  As @code{t}, but after
+placing each glyph, the drawing position is further advanced
+horizontally by@tie{}@var{n} basic units (@code{u}).  The
+@code{u}@tie{}command is a @code{groff} extension and is output only for
+devices whose @file{DESC} file contains the @code{tcommand} directive;
+see @ref{DESC File Format}.
 
 @item V @var{n}
-Move down to the absolute vertical position@tie{}@var{n} (a non-negative
-integer in basic units @samp{u}) relative to upper edge of current page.
+Vertically move the drawing position to @var{n}@tie{}basic units from
+the top edge of the page.  @var{n}@tie{}cannot be negative.
 
 @item v @var{n}
-Move @var{n}@tie{}basic units @samp{u} down (@var{n} is a non-negative
-integer).  The original Unix troff manual allows negative values for
-@var{n} also, but @code{gtroff} doesn't use this.
+Move the drawing position down @var{n} basic units.  @acronym{AT&T}
+@code{troff} allowed negative @var{n}; GNU @code{troff} does not produce
+such values, but @code{groff}'s output driver library handles them.
 
 @item w
-Informs about a paddable white space to increase readability.  The
-spacing itself must be performed explicitly by a move command.
+Indicate an inter-word space.  No action is performed; the command is
+present to make the output more easily parsed.  Only adjustable,
+breakable inter-word spaces are thus described; those resulting from
+@code{\~} or horizontal motion escape sequences are not.  GNU
+@code{troff} issues this command but @code{groff}'s output driver
+library ignores it.  See @code{h} and @code{H} above.
 @end table
 
 @node Graphics Commands, Device Control Commands, Simple Commands, Command Reference
@@ -16216,7 +17791,7 @@
 these distances are offsets relative to the current location.
 
 Each graphics command directly corresponds to a similar @code{gtroff}
-@code{\D} escape sequence.  @xref{Drawing Requests}.
+@code{\D} escape sequence.  @xref{Drawing Geometric Objects}.
 
 Unknown @samp{D} commands are assumed to be device-specific.  Its
 arguments are parsed as strings; the whole information is then sent to
@@ -16228,7 +17803,7 @@
 @table @code
 @item D~ @var{h1} @var{v1} @var{h2} @var{v2} @dots{} @var{hn} @var{vn}@angles{line break}
 Draw B-spline from current position to offset (@var{h1},@var{v1}), then
-to offset (@var{h2},@var{v2}), if given, etc.@: up to
+to offset (@var{h2},@var{v2}), if given, etc., up to
 (@var{hn},@var{vn}).  This command takes a variable number of argument
 pairs; the current position is moved to the terminal point of the drawn
 curve.
@@ -16270,10 +17845,10 @@
 Set fill color for solid drawing objects using different color schemes;
 the analogous command for setting the color of text, line graphics, and
 the outline of graphic objects is @samp{m}.  The color components are
-specified as integer arguments between 0 and 65536.  The number of color
+specified as integer arguments between 0 and 65535.  The number of color
 components and their meaning vary for the different color schemes.
 These commands are generated by @code{gtroff}'s escape sequences
-@w{@code{\D'F @dots{}'}} and @code{\M} (with no other corresponding
+@samp{\D'F @dots{}'} and @code{\M} (with no other corresponding
 graphics commands).  No position changing.  This command is a
 @code{gtroff} extension.
 
@@ -16289,7 +17864,7 @@
 
 @item DFg @var{gray}@angles{line break}
 Set fill color for solid drawing objects to the shade of gray given by
-the argument, an integer between 0 (black) and 65536 (white).
+the argument, an integer between 0 (black) and 65535 (white).
 
 @item DFk @var{cyan} @var{magenta} @var{yellow} @var{black}@angles{line break}
 Set fill color for solid drawing objects using the CMYK color scheme,
@@ -16307,7 +17882,7 @@
 to 32767.
 
 @table @asis
-@item @math{0 @value{LE} @var{n} @value{LE} 1000}
+@item @math{0 @leq{} @var{n} @leq{} 1000}
 Set the color for filling solid drawing objects to a shade of gray,
 where 0 corresponds to solid white, 1000 (the default) to solid black,
 and values in between to intermediate shades of gray; this is obsoleted
@@ -16319,7 +17894,7 @@
 sequence
 
 @Example
-mg 0 0 65536
+mg 0 0 65535
 Df -1
 @endExample
 
@@ -16337,7 +17912,7 @@
 
 @item Dp @var{h1} @var{v1} @var{h2} @var{v2} @dots{} @var{hn} @var{vn}@angles{line break}
 Draw a polygon line from current position to offset (@var{h1},@var{v1}),
-from there to offset (@var{h2},@var{v2}), etc.@: up to offset
+from there to offset (@var{h2},@var{v2}), etc., up to offset
 (@var{hn},@var{vn}), and from there back to the starting position.  For
 historical reasons, the position is changed by adding the sum of all
 arguments with odd index to the actual horizontal position and the even
@@ -16362,7 +17937,7 @@
 Set the current line thickness to@tie{}@var{n} (an integer in basic
 units @samp{u}) if @math{@var{n}>0}; if @math{@var{n}=0} select the
 smallest available line thickness; if @math{@var{n}<0} set the line
-thickness proportional to the point size (this is the default before the
+thickness proportional to the type size (this is the default before the
 first @samp{Dt} command was specified).  For historical reasons, the
 horizontal position is changed by adding the argument to the actual
 horizontal position, while the vertical position is not changed.
@@ -16424,12 +17999,15 @@
 @item xp@angles{line break}
 The @samp{p} stands for @var{pause}.
 
-Parsed but ignored.  The original Unix troff manual writes
+Parsed but ignored.  The @acronym{AT&T} @code{troff} manual documents
+this command as
 
 @display
 pause device, can be restarted
 @end display
 
+but GNU @code{troff} output drivers do nothing with this command.
+
 @item xr @var{n} @var{h} @var{v}@angles{line break}
 The @samp{r} stands for @var{resolution}.
 
@@ -16447,29 +18025,29 @@
 The @samp{s} stands for @var{stop}.
 
 Terminates the processing of the current file; issued as the last
-command of any intermediate troff output.
+command of any intermediate @code{troff} output.
 
 @item xt@angles{line break}
 The @samp{t} stands for @var{trailer}.
 
-Generate trailer information, if any.  In @var{gtroff}, this is actually
-just ignored.
+Generate trailer information, if any.  In GNU @code{troff}, this is
+ignored.
 
 @item xT @var{xxx}@angles{line break}
 The @samp{T} stands for @var{Typesetter}.
 
-Set name of device to word @var{xxx}, a sequence of characters ended by
-the next white space character.  The possible device names coincide with
-those from the @code{groff} @option{-T} option.  This is the first
-command of the prologue.
+Set the name of the output driver to @var{xxx}, a sequence of
+non-whitespace characters terminated by whitespace.  The possible names
+correspond to those of @code{groff}'s @option{-T} option.  This is the
+first command of the prologue.
 
 @item xu @var{n}@angles{line break}
 The @samp{u} stands for @var{underline}.
 
 Configure underlining of spaces.  If @var{n} is@tie{}1, start
 underlining of spaces; if @var{n} is@tie{}0, stop underlining of spaces.
-This is needed for the @code{cu} request in nroff mode and is ignored
-otherwise.  This command is a @code{gtroff} extension.
+This is needed for the @code{cu} request in @code{nroff} mode and is
+ignored otherwise.  This command is a @code{gtroff} extension.
 
 @item xX @var{anything}@angles{line break}
 The @samp{x} stands for @var{X-escape}.
@@ -16498,12 +18076,12 @@
 Move right @var{dd} (exactly two decimal digits) basic units @samp{u},
 then print glyph@tie{}@var{g} (represented as a single character).
 
-In @code{gtroff}, arbitrary syntactical space around and within this
-command is allowed to be added.  Only when a preceding command on the
-same line ends with an argument of variable length a separating space is
-obligatory.  In @acronym{AT&T} @code{troff}, large clusters of these and
-other commands are used, mostly without spaces; this made such output
-almost unreadable.
+In GNU @code{troff}, arbitrary syntactical space around and within this
+command is allowed.  Only when a preceding command on the same line ends
+with an argument of variable length is a separating space obligatory.
+In @acronym{AT&T} @code{troff}, large clusters of these and other
+commands are used, mostly without spaces; this made such output almost
+unreadable.
 @end table
 
 For modern high-resolution devices, this command does not make sense
@@ -16556,7 +18134,7 @@
 
 @noindent
 This output can be fed into @code{grops} to get its representation as a
-@sc{PostScript} file.
+PostScript file.
 
 @item Low-resolution device @code{latin1}
 
@@ -16583,16 +18161,16 @@
 # initial positioning on the page
 V40
 H0
-# write text `hell'
+# write text 'hell'
 thell
 # inform about space, and issue a horizontal jump
 wh24
-# write text `world'
+# write text 'world'
 tworld
-# announce line break, but do nothing because ...
+# announce line break, but do nothing because...
 n40 0
 @group
-# ... the end of the document has been reached
+# ...the end of the document has been reached
 x trailer
 V2640
 x stop
@@ -16604,9 +18182,9 @@
 document.
 
 @item @acronym{AT&T} @code{troff} output
-Since a computer monitor has a very low resolution compared to modern
-printers the intermediate output for the X@tie{}Window devices can use
-the jump-and-write command with its 2-digit displacements.
+Since a computer monitor has a much lower resolution than modern
+printers, the intermediate output for X11 devices can use the
+jump-and-write command with its 2-digit displacements.
 
 @example
 @group
@@ -16646,27 +18224,27 @@
 @subsection Output Language Compatibility
 
 The intermediate output language of @acronym{AT&T} @code{troff} was
-first documented in the Unix troff manual, with later additions
-documented in @cite{A Typesetter-independent TROFF}, written by Brian
-Kernighan.
+first documented in @cite{A Typesetter-independent TROFF}, by Brian
+Kernighan, and by 1992 the @acronym{AT&T} @code{troff} manual was
+updated to incorprate a description of it.
 
-The @code{gtroff} intermediate output format is compatible with this
+The GNU @code{troff} intermediate output format is compatible with this
 specification except for the following features.
 
 @itemize @bullet
 @item
-The classical quasi device independence is not yet implemented.
+The classical quasi-device independence is not yet implemented.
 
 @item
 The old hardware was very different from what we use today.  So the
 @code{groff} devices are also fundamentally different from the ones
 in @acronym{AT&T} @code{troff}.  For example, the @acronym{AT&T}
-@sc{PostScript} device is called @code{post} and has a resolution of
-only 720 units per inch, suitable for printers 20 years ago, while
-@code{groff}'s @code{ps} device has a resolution of 72000 units per
-inch.  Maybe, by implementing some rescaling mechanism similar to the
-classical quasi device independence, @code{groff} could emulate
-@acronym{AT&T}'s @code{post} device.
+PostScript device is called @code{post} and has a resolution of only 720
+units per inch, suitable for printers 20 years ago, while @code{groff}'s
+@code{ps} device has a resolution of 72000 units per inch.  Maybe, by
+implementing some rescaling mechanism similar to the classical
+quasi-device independence, @code{groff} could emulate @acronym{AT&T}'s
+@code{post} device.
 
 @item
 The B-spline command @samp{D~} is correctly handled by the intermediate
@@ -16692,8 +18270,9 @@
 
 @ignore
 Temporarily, there existed some confusion on the positioning after the
-@samp{D} commands that are groff extensions.  This has been clarified by
-establishing the classical rule for all @code{groff} drawing commands:
+@samp{D} commands that are @code{groff} extensions.  This has been
+clarified by establishing the classical rule for all @code{groff}
+drawing commands:
 
 @itemize
 @item
@@ -16707,135 +18286,150 @@
 @end ignore
 
 @end itemize
+@c END TODO: Make parallel with groff_out(5).
 
 
 @c =====================================================================
 
-@node Font Files,  , gtroff Output, File formats
-@section Font Files
+@c BEGIN Keep parallel with groff_font(5).
+@node Device and Font Description Files,  , gtroff Output, File Formats
+@section Device and Font Description Files
 @cindex font files
 @cindex files, font
 
-The @code{gtroff} font format is roughly a superset of the
-@code{ditroff} font format (as used in later versions of @acronym{AT&T}
-@code{troff} and its descendants).  Unlike the @code{ditroff} font
-format, there is no associated binary format; all files are text
+The @code{groff} font and output device description formats are slight
+extensions of those used by @acronym{AT&T} device-independent
+@code{troff}.  In distinction to the @acronym{AT&T} implementation,
+@code{groff} lacks a binary format; all files are text
 files.@footnote{Plan@tie{}9 @code{troff} has also abandoned the binary
-format.}  The font files for device @var{name} are stored in a directory
-@file{dev@var{name}}.  There are two types of file: a device description
-file called @file{DESC} and for each font@tie{}@var{f} a font file
-called@tie{}@file{@var{f}}.
+format.}  The device and font description files for a device @var{name}
+are stored in a @file{dev@var{name}} directory.  The device description
+file is called @file{DESC}, and, for each font supported by the device,
+a font description file is called@tie{}@file{@var{f}}, where
+@var{f}@tie{}is usually an abbreviation of a font's name and/or style.
+For example, the @code{ps} (PostScript) device has @code{groff} font
+description files for Times roman (@file{TR}) and Zapf Chancery Medium
+italic (@file{ZCMI}), among many others, while the @code{utf8} device
+(for terminal emulators) has only font descriptions for the roman,
+italic, bold, and bold-italic styles (@file{R}, @file{I}, @file{B}, and
+@file{BI}, respectively).
+
+Device and font description files are read both by the formatter, GNU
+@code{troff}, and by output drivers.  The programs delegate these files'
+processing to an internal library, @file{libgroff}, ensuring their
+consistent interpretation.
 
 @menu
 * DESC File Format::
-* Font File Format::
+* Font Description File Format::
 @end menu
 
 @c ---------------------------------------------------------------------
 
-@node DESC File Format, Font File Format, Font Files, Font Files
+@node DESC File Format, Font Description File Format, Device and Font Description Files, Device and Font Description Files
 @subsection @file{DESC} File Format
-@cindex @file{DESC} file, format
-@cindex font description file, format
+@cindex @file{DESC} file format
+@cindex font description file format
 @cindex format of font description file
-@pindex DESC@r{ file format}
 
-The @file{DESC} file can contain the following types of line.  Except
-for the @code{charset} keyword, which must come last (if at all), the
-order of the lines is not important.  Later entries in the file,
-however, override previous values.
+The @file{DESC} file contains a series of directives; each begins a
+line.  Their order is not important, with two exceptions: (1) the
+@code{res} directive must precede any @code{papersize} directive; and
+(2) the @code{charset} directive must come last (if at all).  If a
+directive name is repeated, later entries in the file override previous
+ones (except that the paper dimensions are computed based on the
+@code{res} directive last seen when @code{papersize} is encountered).
+Spaces and/or tabs separate words and are ignored at line boundaries.
+@cindex comments in device description files
+@cindex device description files, comments
+@kindex #
+Comments start with the @samp{#} character and extend to the end of a
+line.  Empty lines are ignored.
 
 @table @code
-@item charset
-@kindex charset
-This line and everything following in the file are ignored.  It is
-allowed for the sake of backwards compatibility.
-
 @item family @var{fam}
 @kindex family
 The default font family is @var{fam}.
 
-@item fonts @var{n} @var{F1} @var{F2} @var{F3} @dots{} @var{Fn}
+@item fonts @var{n} @var{F1} @r{@dots{}} @var{Fn}
 @kindex fonts
-Fonts @var{F1} @dots{} @var{Fn} are mounted in the font positions
+Fonts @var{F1}, @dots{}, @var{Fn} are mounted at font positions
 @var{m}+1, @dots{}, @var{m}+@var{n} where @var{m} is the number of
-styles.  This command may extend over more than one line.  A font name
-of@tie{}0 means no font is mounted on the corresponding font position.
+@code{styles} (see below).  This directive may extend over more than one
+line.  A font name of@tie{}@code{0} causes no font to be mounted at the
+corresponding position.
 
 @item hor @var{n}
 @kindex hor
+@cindex horizontal motion quantum
+@cindex motion quantum, horizontal
+@cindex quantum, horizontal motion
 @cindex horizontal resolution
 @cindex resolution, horizontal
-The horizontal resolution is @var{n}@tie{}machine units.  All horizontal
-quantities are rounded to be multiples of this value.
+The horizontal motion quantum is @var{n}@tie{}basic units.  All
+horizontal quantities are rounded to multiples of@tie{}@var{n}.
 
-@item image_generator @var{string}
+@item image_generator @var{program}
 @kindex image_generator
 @cindex PostScript, PNG image generation
 @cindex PNG image generation from PostScript
-Needed for @code{grohtml} only.  It specifies the program to generate
-PNG images from @sc{PostScript} input.  Under GNU/Linux this is
-usually @code{gs} but under other systems (notably cygwin) it might
-be set to another name.
+Use @var{program} to generate PNG images from PostScript input.  Under
+GNU/Linux, this is usually @code{gs}, but under other systems (notably
+Cygwin) it might be set to another name.  The @code{grohtml} driver uses
+this directive.
 
 @item paperlength @var{n}
 @kindex paperlength
-The physical vertical dimension of the output medium in machine units.
-This isn't used by @code{troff} itself but by output devices.
-Deprecated.  Use @code{papersize} instead.
+The vertical dimension of the output medium is @var{n}@tie{}basic units
+(deprecated: use @code{papersize} instead).
 
-@item papersize @var{string} @dots{}
+@item papersize @var{format-or-dimension-pair-or-file-name} @r{@dots{}}
 @kindex papersize
-Select a paper size.  Valid values for @var{string} are the ISO paper
-types @code{A0}--@code{A7}, @code{B0}--@code{B7}, @code{C0}--@code{C7},
-@code{D0}--@code{D7}, @code{DL}, and the US paper types @code{letter},
-@code{legal}, @code{tabloid}, @code{ledger}, @code{statement},
-@code{executive}, @code{com10}, and @code{monarch}.  Case is not
-significant for @var{string} if it holds predefined paper types.
-Alternatively, @var{string} can be a file name (e.g.@:
-@file{/etc/papersize}); if the file can be opened, @code{groff} reads
-the first line and tests for the above paper sizes.  Finally,
-@var{string} can be a custom paper size in the format
-@code{@var{length},@var{width}} (no spaces before and after the comma).
-Both @var{length} and @var{width} must have a unit appended; valid
-values are @samp{i} for inches, @samp{c} for centimeters, @samp{p} for
-points, and @samp{P} for picas.  Example: @code{12c,235p}.  An argument
-that starts with a digit is always treated as a custom paper format.
-@code{papersize} sets both the vertical and horizontal dimension of the
-output medium.
+The dimensions of the output medium are as according to the
+argument, which is either a standard paper format, a pair of dimensions,
+or the name of a plain text file containing either of the foregoing.
+
+Recognized paper formats are the ISO and DIN formats
+@code{A0}--@code{A7}, @code{B0}--@code{B7}, @code{C0}--@code{C7},
+@code{D0}--@code{D7}; the U.S.@: paper types @code{letter},
+@code{legal}, @code{tabloid}, @code{ledger}, @code{statement}, and
+@code{executive}; and the envelope formats @code{com10}, @code{monarch},
+and @code{DL}.  Matching is performed without regard for lettercase.
+
+Alternatively, the argument can be a custom paper format in the format
+@code{@var{length},@var{width}} (with no spaces before or after the
+comma).  Both @var{length} and @var{width} must have a unit appended;
+valid units are @samp{i} for inches, @samp{c} for centimeters, @samp{p}
+for points, and @samp{P} for picas.  Example: @samp{12c,235p}.  An
+argument that starts with a digit is always treated as a custom paper
+format.
+
+Finally, the argument can be a file name (e.g., @file{/etc/papersize});
+if the file can be opened, the first line is read and a match attempted
+against each of the other forms.  No comment syntax is supported.
 
-More than one argument can be specified; @code{groff} scans from left to
-right and uses the first valid paper specification.
+More than one argument can be specified;
+each is scanned in turn and the first valid paper specification used.
 
 @item paperwidth @var{n}
 @kindex paperwidth
-The physical horizontal dimension of the output medium in machine units.
-This isn't used by @code{troff} itself but by output devices.
-Deprecated.  Use @code{papersize} instead.
+The horizontal dimension of the output medium is @var{n}@tie{}basic
+units (deprecated: use @code{papersize} instead).
 
 @item pass_filenames
 @kindex pass_filenames
-Tell @code{gtroff} to emit the name of the source file currently being
-processed.  This is achieved by the intermediate output command
-@samp{F}.  Currently, this is only used by the @code{grohtml} output
-device.
+Direct GNU @code{troff} to emit the name of the source file being
+processed.  This is achieved with the intermediate output command
+@samp{x F}, which @code{grohtml} interprets.
 
 @item postpro @var{program}
 @kindex postpro
-Call @var{program} as a postprocessor.  For example, the line
-
-@Example
-postpro grodvi
-@endExample
-
-@noindent
-in the file @file{devdvi/DESC} makes @code{groff} call @code{grodvi} if
-option @option{-Tdvi} is given (and @option{-Z} isn't used).
+Use @var{program} as the postprocessor.
 
 @item prepro @var{program}
 @kindex prepro
-Call @var{program} as a preprocessor.  Currently, this keyword is used
-by @code{groff} with option @option{-Thtml} or @option{-Txhtml} only.
+Use @var{program} as a preprocessor.  The @code{html} and @code{xhtml}
+output devices use this directive.
 
 @item print @var{program}
 @kindex print
@@ -16846,148 +18440,187 @@
 @kindex res
 @cindex device resolution
 @cindex resolution, device
-There are @var{n}@tie{}machine units per inch.
+The device resolution is @var{n}@tie{}basic units per inch.
 
-@item sizes @var{s1} @var{s2} @dots{} @var{sn} 0
+@item sizes @var{s1} @r{@dots{}} @var{sn} 0
 @kindex sizes
-This means that the device has fonts at @var{s1}, @var{s2}, @dots{}
-@var{sn} scaled points.  The list of sizes must be terminated by@tie{}0
-(this is digit zero).  Each @var{si} can also be a range of sizes
-@var{m}--@var{n}.  The list can extend over more than one line.
+The device has fonts at @var{s1}, @dots{}, @var{sn} scaled points (see
+below).  The list of sizes must be terminated by@tie{}@code{0}.  Each
+@var{si} can also be a range of sizes @var{m}--@var{n}.  The list can
+extend over more than one line.
 
 @item sizescale @var{n}
 @kindex sizescale
-The scale factor for point sizes.  By default this has a value
-of@tie{}1.  One scaled point is equal to one point/@var{n}.  The
-arguments to the @code{unitwidth} and @code{sizes} commands are given in
-scaled points.  @xref{Fractional Type Sizes}, for more information.
+A typographical point is subdivided into @var{n}@tie{}scaled points.
+The default is@tie{}@code{1}.  @xref{Using Fractional Type Sizes}.
 
-@item styles @var{S1} @var{S2} @dots{} @var{Sm}
+@item styles @var{S1} @r{@dots{}} @var{Sm}
 @kindex styles
-The first @var{m}@tie{}font positions are associated with styles
-@var{S1} @dots{} @var{Sm}.
+The first@tie{}@var{m} mounting positions are associated with styles
+@var{S1}, @dots{}, @var{Sm}.
 
 @item tcommand
 @kindex tcommand
-This means that the postprocessor can handle the @samp{t} and @samp{u}
-intermediate output commands.
+The postprocessor can handle the @samp{t} and @samp{u} intermediate
+output commands.
 
 @item unicode
 @kindex unicode
-Indicate that the output device supports the complete Unicode
-repertoire.  Useful only for devices that produce @emph{character
-entities} instead of glyphs.
+The output device supports the complete Unicode repertoire.  This
+directive is useful only for devices that produce character entities
+instead of glyphs.
 
 If @code{unicode} is present, no @code{charset} section is required in
 the font description files since the Unicode handling built into
-@code{groff} is used.  However, if there are entries in a @code{charset}
-section, they either override the default mappings for those particular
-characters or add new mappings (normally for composite characters).
+@code{groff} is used.  However, if there are entries in a font
+description file's @code{charset} section, they either override the
+default mappings for those particular characters or add new mappings
+(normally for composite characters).
 
-This is used for @option{-Tutf8}, @option{-Thtml}, and @option{-Txhtml}.
+The @code{utf8}, @code{html}, and @code{xhtml} output devices use this
+directive.
 
 @item unitwidth @var{n}
 @kindex unitwidth
-Quantities in the font files are given in machine units for fonts whose
-point size is @var{n}@tie{}scaled points.
+Quantities in the font description files are in basic units for fonts
+whose type size is @var{n}@tie{}scaled points.
 
 @item unscaled_charwidths
 @kindex unscaled_charwidths
 Make the font handling module always return unscaled character widths.
-Needed for the @code{grohtml} device.
+The @code{grohtml} driver uses this directive.
 
 @item use_charnames_in_special
 @kindex use_charnames_in_special
-This command indicates that @code{gtroff} should encode special
-characters inside special commands.  Currently, this is only used by the
-@code{grohtml} output device.  @xref{Postprocessor Access}.
+GNU @code{troff} should encode special characters inside device control
+commands; see @ref{Postprocessor Access}.  The @code{grohtml} driver
+uses this directive.
 
 @item vert @var{n}
 @kindex vert
+@cindex vertical motion quantum
+@cindex motion quantum, vertical
+@cindex quantum, vertical motion
 @cindex vertical resolution
 @cindex resolution, vertical
-The vertical resolution is @var{n}@tie{}machine units.  All vertical
-quantities are rounded to be multiples of this value.
-@end table
+The vertical motion quantum is @var{n}@tie{}basic units.  All vertical
+quantities are rounded to multiples of@tie{}@var{n}.
 
-The @code{res}, @code{unitwidth}, @code{fonts}, and @code{sizes} lines
-are mandatory.  Other commands are ignored by @code{gtroff} but may be
-used by postprocessors to store arbitrary information about the device
-in the @file{DESC} file.
+@item charset
+@kindex charset
+This line and everything following it in the file are ignored.  It is
+recognized for compatibility with other @code{troff} implementations.
+In GNU @code{troff}, character set repertoire is described on a
+per-font basis.
+@end table
 
 @kindex spare1
 @kindex spare2
 @kindex biggestfont
-Here a list of obsolete keywords that are recognized by @code{groff}
-but completely ignored: @code{spare1}, @code{spare2},
-@code{biggestfont}.
+GNU @code{troff} recognizes but ignores the directives @code{spare1},
+@code{spare2}, and @code{biggestfont}.
+
+The @code{res}, @code{unitwidth}, @code{fonts}, and @code{sizes} lines
+are mandatory.  Directives not listed above are ignored by GNU
+@code{troff} but may be used by postprocessors to obtain further
+information about the device.
 
 @c ---------------------------------------------------------------------
 
-@node Font File Format,  , DESC File Format, Font Files
-@subsection Font File Format
+@node Font Description File Format,  , DESC File Format, Device and Font Description Files
+@subsection Font Description File Format
 @cindex font file, format
 @cindex font description file, format
 @cindex format of font files
 @cindex format of font description files
 
-A @dfn{font file}, also (and probably better) called a @dfn{font
-description file}, has two sections.  The first section is a sequence of
-lines each containing a sequence of blank delimited words; the first
-word in the line is a key, and subsequent words give a value for that
-key.
+On typesetting output devices, each font is typically available at
+multiple sizes.  While paper measurements in the device description file
+are in absolute units, measurements applicable to fonts must be
+proportional to the type size.  @code{groff} achieves this using the
+precedent set by @acronym{AT&T} device-independent @code{troff}: one
+font size is chosen as a norm, and all others are scaled linearly
+relative to that basis.  The ``unit width'' is the number of basic units
+per point when the font is rendered at this nominal size.
+
+For instance, @code{groff}'s @code{lbp} device uses a @code{unitwidth}
+of@tie{}800.  Its Times roman font @samp{TR} has a @code{spacewidth}
+of@tie{}833; this is also the width of its comma, period, centered
+period, and mathematical asterisk, while its @samp{M} is 2,963 basic
+units.  Thus, an @samp{M} on the @code{lbp} device is 2,963 basic units
+wide at a notional type size of 800@tie{}points.@footnote{800-point type
+is not practical for most purposes, but using it enables the quantities
+in the font description files to be expressed as integers.}
+
+A font description file has two sections.  The first is a sequence of
+directives, and is parsed similarly to the @file{DESC} file described
+above.  Except for the directive names that begin the second section,
+their ordering is immaterial.  Later directives of the same name
+override earlier ones, spaces and tabs are handled in the same way,
+@cindex comments in font description files
+@cindex font description files, comments
+@kindex #
+and the same comment syntax is supported.  Empty lines are ignored
+throughout.
 
 @table @code
 @item name @var{f}
 @kindex name
-The name of the font is@tie{}@var{f}.
+The name of the font is@tie{}@var{f}.  @samp{DESC} is an invalid font
+name.  Simple integers are valid, but their use is
+discouraged.@footnote{@code{groff} requests and escape sequences
+interpret non-negative font names as mounting positions instead.
+Further, a font named @samp{0} cannot be automatically mounted by the
+@code{fonts} directive of a @file{DESC} file.}
 
 @item spacewidth @var{n}
 @kindex spacewidth
-The normal width of a space is@tie{}@var{n}.
+The width of an unadjusted inter-word space is @var{n}@tie{}basic units.
+@end table
+
+The directives above must appear in the first section; those below are
+optional.
 
+@table @code
 @item slant @var{n}
 @kindex slant
-The glyphs of the font have a slant of @var{n}@tie{}degrees.  (Positive
-means forward.)
+The font's glyphs have a slant of @var{n}@tie{}degrees; a positive
+@var{n} slants in the direction of text flow.
 
-@item ligatures @var{lig1} @var{lig2} @dots{} @var{lign} 0
+@item ligatures @var{lig1} @r{@dots{}} @var{lign} @r{}0@r{}
 @kindex ligatures
-Glyphs @var{lig1}, @var{lig2}, @dots{}, @var{lign} are ligatures;
-possible ligatures are @samp{ff}, @samp{fi}, @samp{fl}, @samp{ffi} and
-@samp{ffl}.  For backwards compatibility, the list of ligatures may be
-terminated with a@tie{}0.  The list of ligatures may not extend over
-more than one line.
+Glyphs @var{lig1}, @dots{}, @var{lign} are ligatures; possible ligatures
+are @samp{ff}, @samp{fi}, @samp{fl}, @samp{ffi} and @samp{ffl}.  For
+compatibility with other @code{troff} implementations, the list of
+ligatures may be terminated with a@tie{}@code{0}.  The list of ligatures
+must not extend over more than one line.
 
 @item special
 @cindex special fonts
 @kindex special
-The font is @dfn{special}; this means that when a glyph is requested
-that is not present in the current font, it is searched for in any
-special fonts that are mounted.
+The font is @dfn{special}: when a glyph is requested that is not present
+in the current font, it is sought in any mounted fonts that bear this
+property.
 @end table
 
-Other commands are ignored by @code{gtroff} but may be used by
-postprocessors to store arbitrary information about the font in the font
-file.
-
-@cindex comments in font files
-@cindex font files, comments
-@kindex #
-The first section can contain comments, which start with the @samp{#}
-character and extend to the end of a line.
+Other directives in this section are ignored by GNU @code{troff}, but
+may be used by postprocessors to obtain further information about the
+font.
 
-The second section contains one or two subsections.  It must contain a
-@code{charset} subsection and it may also contain a @code{kernpairs}
-subsection.  These subsections can appear in any order.  Each subsection
-starts with a word on a line by itself.
+The second section contains one or two subsections.  These can appear in
+either order; the first one encountered commences the second section.
+Each starts with a directive on a line by itself.  A @code{charset}
+subsection is mandatory unless the associated @file{DESC} file contains
+the @code{unicode} directive.  Another subsection, @code{kernpairs},
+is optional.
 
 @kindex charset
-The word @code{charset} starts the character set
-subsection.@footnote{This keyword is misnamed since it starts a list of
-ordered glyphs, not characters.}  The @code{charset} line is followed by
-a sequence of lines.  Each line gives information for one glyph.  A line
-comprises a number of fields separated by blanks or tabs.  The format is
+The directive @code{charset} starts the character set
+subsection.@footnote{For typesetter devices, this directive is misnamed
+since it starts a list of glyphs, not characters.}  It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
 
 @quotation
 @var{name} @var{metrics} @var{type} @var{code} @var{entity-name}
@@ -17002,137 +18635,161 @@
 @cindex glyphs, unnamed, accessing with @code{\N}
 @kindex ---
 @noindent
-@var{name} identifies the glyph name@footnote{The distinction between
-input, characters, and output, glyphs, is not clearly separated in the
-terminology of @code{groff}; for example, the @code{char} request should
-be called @code{glyph} since it defines an output entity.}: If
-@var{name} is a single character@tie{}@var{c} then it corresponds to the
-@code{gtroff} input character@tie{}@var{c}; if it is of the form
-@samp{\@var{c}} where @var{c} is a single character, then it corresponds
-to the special character @code{\@var{c}}; otherwise it corresponds to
-the special character @samp{\@var{name}}.  If it is exactly two
-characters @var{xx} it can be entered as @samp{\(@var{xx}}.  Note that
-single-letter special characters can't be accessed as @samp{\@var{c}};
-the only exception is @samp{\-}, which is identical to @code{\-}.
-
-@code{gtroff} supports 8-bit input characters; however some utilities
-have difficulties with eight-bit characters.  For this reason, there is
-a convention that the entity name @samp{char@var{n}} is equivalent to
-the single input character whose code is@tie{}@var{n}.  For example,
-@samp{char163} would be equivalent to the character with code@tie{}163,
-which is the pounds sterling sign in the ISO@tie{}@w{Latin-1} character
-set.  You shouldn't use @samp{char@var{n}} entities in font description
-files since they are related to input, not output.  Otherwise, you get
-hard-coded connections between input and output encoding, which prevents
-use of different (input) character sets.
-
-The name @samp{---} is special and indicates that the glyph is unnamed;
-such glyphs can only be used by means of the @code{\N} escape sequence
-in @code{gtroff}.
-
-The @var{type} field gives the glyph type:
-
-@table @code
-@item 1
-the glyph has a descender, for example, @samp{p};
-
-@item 2
-the glyph has an ascender, for example, @samp{b};
-
-@item 3
-the glyph has both an ascender and a descender, for example, @samp{(}.
-@end table
-
-The @var{code} field gives the code that the postprocessor uses to
-print the glyph.  The glyph can also be input to @code{gtroff} using
-this code by means of the @code{\N} escape sequence.  @var{code} can be
-any integer.  If it starts with @samp{0} it is interpreted as octal; if
-it starts with @samp{0x} or @samp{0X} it is interpreted as hexadecimal.
-Note, however, that the @code{\N} escape sequence only accepts a decimal
-integer.
-
-The @var{entity-name} field gives an @acronym{ASCII} string identifying
-the glyph that the postprocessor uses to print the @code{gtroff} glyph
-@var{name}.  This field is optional and has been introduced so that the
-@code{grohtml} device driver can encode its character set.  For example,
-the glyph @samp{\Po} is represented as @samp{&pound;} in
-@acronym{HTML} 4.0.
-
-Anything on the line after the @var{entity-name} field resp.@: after
-@samp{--} is ignored.
+@var{name} identifies the glyph:
+@c XXX: Move this footnote to a more general discussion since it is
+@c applicable to the groff system overall.
+@c
+@c @footnote{The distinction between input, characters, and output,
+@c glyphs, is not clearly separated in the terminology of @code{groff};
+@c for example, the @code{char} request should be called @code{glyph}
+@c since it defines an output entity.}
+if @var{name} is a printable character@tie{}@var{c}, it corresponds to
+the @code{troff} ordinary character@tie{}@var{c}.  If @var{name} is a
+multi-character sequence not beginning with @code{\}, it corresponds to
+the GNU @code{troff} special character escape sequence
+@samp{\@var{name}}.  A name consisting of three minus signs,
+@samp{---}, is special and indicates that the glyph is unnamed: such
+glyphs can be accessed only by the @code{\N} escape sequence in
+@code{troff}.  A special character named @samp{---} can still be defined
+using @code{char} and similar requests.  The @var{name} @samp{\-}
+defines the minus sign glyph.  Finally, @var{name} can be the
+unbreakable one-sixth and one-twelfth space escape sequences, @code{\|}
+and @code{\^} (``thin'' and ``hair'' spaces, respectively), in which
+case only the width metric described below is interpreted; a font can
+thus customize the widths of these spaces.
+@c XXX: For exhaustivity purposes...you can define "\whatever", which
+@c has to be accessed with \C'\\whatever' or \\\whatever, but the
+@c parser matches predefined escape sequences before looking up special
+@c characters.  Most such definitions are inaccessible from the
+@c language, because nearly every '\x', where 'x' is a Unicode basic
+@c Latin character, is a predefined groff escape sequence.
+@c
+@c XXX: Commented out because the charXXX feature is very legacy, and as
+@c noted below, discouraged in font description files.
+@c
+@c GNU @code{troff} supports 8-bit input characters; however some
+@c utilities have difficulties with eight-bit characters.  For this
+@c reason, there is a convention that the entity name @samp{char@var{n}}
+@c is equivalent to the single input character whose code
+@c is@tie{}@var{n}.  For example, @samp{char163} would be equivalent to
+@c the character with code@tie{}163, which is the pounds sterling sign
+@c in the ISO@tie{}@w{Latin-1} character set.  You shouldn't use
+@c @samp{char@var{n}} entities in font description files since they are
+@c related to input, not output.  Otherwise, you get hard-coded
+@c connections between input and output encoding, which prevents use of
+@c different (input) character sets.
 
-The @var{metrics} field has the form:
+The form of the @var{metrics} field is as follows.
 
 @display
 @group
-@var{width}@code{,}@var{height}@code{,}@var{depth}@code{,}@var{italic-correction}
-  @code{,}@var{left-italic-correction}@code{,}@var{subscript-correction}
+@var{width}@code{,}@var{height}@code{,}@var{depth}@code{,}@var{italic-correction}
+  @code{,}@var{left-italic-correction}@code{,}@var{subscript-correction}
 @end group
 @end display
 
 @noindent
-There must not be any spaces between these subfields (it has been split
-here into two lines for better legibility only).  Missing subfields are
-assumed to be@tie{}0.  The subfields are all decimal integers.  Since
-there is no associated binary format, these values are not required to
-fit into a variable of type @samp{char} as they are in @code{ditroff}.
+There must not be any spaces, tabs, or newlines between these
+@dfn{subfields} (which have been split here into two lines only for
+better legibility).  The subfields are in basic units expressed as
+decimal integers.  Unspecified subfields default to@tie{}@code{0}.
+Since there is no associated binary format, these values are not
+required to fit into the C language data type @samp{char} as they are in
+@acronym{AT&T} device-independent @code{troff}.
+
 The @var{width} subfield gives the width of the glyph.  The @var{height}
-subfield gives the height of the glyph (upwards is positive); if a glyph
+subfield gives the height of the glyph (upward is positive); if a glyph
 does not extend above the baseline, it should be given a zero height,
 rather than a negative height.  The @var{depth} subfield gives the depth
-of the glyph, that is, the distance from the baseline to the lowest
-point below the baseline to which the glyph extends (downwards is
-positive); if a glyph does not extend below the baseline, it should be
-given a zero depth, rather than a negative depth.  The
-@var{italic-correction} subfield gives the amount of space that should
-be added after the glyph when it is immediately to be followed by a
-glyph from a roman font.  The @var{left-italic-correction} subfield
-gives the amount of space that should be added before the glyph when it
-is immediately to be preceded by a glyph from a roman font.  The
-@var{subscript-correction} gives the amount of space that should be
-added after a glyph before adding a subscript.  This should be less than
-the italic correction.
+of the glyph, that is, the distance below the baseline to which the
+glyph extends (downward is positive); if a glyph does not extend below
+the baseline, it should be given a zero depth, rather than a negative
+depth.  Italic corrections are relevant to glyphs in italic or oblique
+styles.  The @var{italic-correction} is the amount of space that should
+be added after an oblique glyph to be followed immediately by an upright
+glyph.  The @var{left-italic-correction} is the amount of space that
+should be added before an oblique glyph to be preceded immediately by an
+upright glyph.  The @var{subscript-correction} is the amount of space
+that should be added after an oblique glyph to be followed by a
+subscript; it should be less than the italic correction.
+
+For fonts used with typesetting devices, the @var{type} field gives a
+featural description of the glyph: it is a bit mask recording whether
+the glyph is an ascender, descender, both, or neither.  When a @code{\w}
+escape sequence is interpolated, these values are bitwise or-ed
+together for each glyph and stored in the @code{nr} register.  In font
+descriptions for terminal devices, all glyphs might have a type of zero,
+regardless of their appearance.
 
-A line in the @code{charset} section can also have the format
+@table @code
+@item 0
+means the glyph lies entirely between the baseline and a horizontal line
+at the ``x-height'' of the font; typical examples are @samp{a},
+@samp{c}, and @samp{x};
+
+@item 1
+means the glyph descends below the baseline, like @samp{p};
+
+@item 2
+means the glyph ascends above the font's x-height, like @samp{A} or
+@samp{b}; and
+
+@item 3
+means the glyph is both an ascender and a descender---this is true of
+parentheses in some fonts.
+@end table
+
+The @var{code} field gives a numeric identifier that the postprocessor
+uses to render the glyph.  The glyph can be specified to @code{troff}
+using this code by means of the @code{\N} escape sequence.  @var{code}
+can be any integer.@footnote{that is, any integer parsable by the C
+standard library's @cite{strtol@r{(3)}} function}
+
+The @var{entity-name} field defines an identifier for the glyph that the
+postprocessor uses to print the GNU @code{troff} glyph @var{name}.  This
+field is optional; it was introduced so that the @code{grohtml} output
+driver could encode its character set.  For example, the glyph
+@samp{\Po} is represented by @samp{&pound;} in @acronym{HTML} 4.0.
+For efficiency, these data are now compiled directly into
+@code{grohtml}.  @code{grops} uses the field to build sub-encoding
+arrays for PostScript fonts containing more than 256 glyphs.  Anything
+on the line after the @var{entity-name} field or @samp{--} is ignored.
+
+A line in the @code{charset} section can also have the form
 
 @Example
 @var{name} "
 @endExample
 
 @noindent
-This indicates that @var{name} is just another name for the glyph
-mentioned in the preceding line.
+identifying @var{name} as another name for the glyph mentioned in the
+preceding line.  Such aliases can be chained.
 
 @kindex kernpairs
-The word @code{kernpairs} starts the kernpairs section.  This contains a
-sequence of lines of the form:
+The directive @code{kernpairs} starts a list of kerning adjustments to
+be made to adjacent glyph pairs from this font.  It contains a sequence
+of lines formatted as follows.
 
 @Example
-@var{c1} @var{c2} @var{n}
+@var{g1} @var{g2} @var{n}
 @endExample
 
 @noindent
-This means that when glyph @var{c1} appears next to glyph @var{c2} the
-space between them should be increased by@tie{}@var{n}.  Most entries in
-the kernpairs section have a negative value for@tie{}@var{n}.
-
-
-
-@c =====================================================================
-@c =====================================================================
-
-@node Installation, Copying This Manual, File formats, Top
-@chapter Installation
-@cindex installation
+The foregoing means that when glyph @var{g1} is typeset immediately
+before @var{g2}, the space between them should be increased
+by@tie{}@var{n}.  Most kerning pairs should have a negative value
+for@tie{}@var{n}.
+@c END Keep parallel with groff_font(5).
 
-@c XXX
+@codequotebacktick off
+@codequoteundirected off
 
 
 
 @c =====================================================================
 @c =====================================================================
 
-@node Copying This Manual, Request Index, Installation, Top
+@node Copying This Manual, Request Index, Font Description File Format, Top
 @appendix Copying This Manual
 
 @include fdl.texi
@@ -17142,11 +18799,16 @@
 @c =====================================================================
 @c =====================================================================
 
-@node Request Index, Escape Index, Copying This Manual, Top
+@c This'll do us for the rest of the file...
+@codequotebacktick on
+@codequoteundirected on
+
+@node Request Index, Escape Sequence Index, Copying This Manual, Top
 @appendix Request Index
 
-Requests appear without the leading control character (normally either
-@samp{.} or @samp{'}).
+Request names appear without a leading control character; the defaults
+are @code{.} for the regular control character and @code{'} for the
+no-break control character.
 
 @printindex rq
 
@@ -17155,11 +18817,16 @@
 @c =====================================================================
 @c =====================================================================
 
-@node Escape Index, Operator Index, Request Index, Top
-@appendix Escape Index
+@node Escape Sequence Index, Operator Index, Request Index, Top
+@appendix Escape Sequence Index
 
-Any escape sequence @code{\@var{X}} with @var{X} not in the list below
-emits a warning, printing glyph @var{X}.
+The escape character, @code{\} by default, is always followed by at
+least one more input character, making an escape @emph{sequence}.  Any
+input token @code{\@var{X}} with @var{X} not in the list below emits a
+warning and interpolates glyph @var{X}.  Note the entries for @code{\.},
+which may be obscured by the leader dots, and for @code{\@key{RET}} and
+@code{\@key{SP}}, which are sorted alphabetically, not by code point
+order.
 
 @printindex es
 
@@ -17168,7 +18835,7 @@
 @c =====================================================================
 @c =====================================================================
 
-@node Operator Index, Register Index, Escape Index, Top
+@node Operator Index, Register Index, Escape Sequence Index, Top
 @appendix Operator Index
 
 @printindex op
@@ -17181,8 +18848,8 @@
 @node Register Index, Macro Index, Operator Index, Top
 @appendix Register Index
 
-The macro package or program a specific register belongs to is appended in
-brackets.
+The macro package or program a specific register belongs to is appended
+in brackets.
 
 A register name@tie{}@code{x} consisting of exactly one character can be
 accessed as @samp{\nx}.  A register name @code{xx} consisting of exactly
@@ -17209,16 +18876,12 @@
 @c =====================================================================
 @c =====================================================================
 
-@node String Index, Glyph Name Index, Macro Index, Top
+@node String Index, File Keyword Index, Macro Index, Top
 @appendix String Index
 
-The macro package or program a specific string belongs to is appended in
-brackets.
-
-A string name@tie{}@code{x} consisting of exactly one character can be
-accessed as @samp{\*x}.  A string name @code{xx} consisting of exactly
-two characters can be accessed as @samp{\*(xx}.  String names @code{xxx}
-of any length can be accessed as @samp{\*xxx}.
+The macro package or program a that defines or uses each string is
+appended in brackets. (Only one string, @code{.T}, is defined by the
+@code{troff} formatter itself.)  @xref{Strings}.
 
 
 @printindex st
@@ -17228,22 +18891,8 @@
 @c =====================================================================
 @c =====================================================================
 
-@node Glyph Name Index, Font File Keyword Index, String Index, Top
-@appendix Glyph Name Index
-
-A glyph name @code{xx} consisting of exactly two characters can be
-accessed as @samp{\(xx}.  Glyph names @code{xxx} of any length can be
-accessed as @samp{\xxx}.
-
-@c XXX
-
-
-
-@c =====================================================================
-@c =====================================================================
-
-@node Font File Keyword Index, Program and File Index, Glyph Name Index, Top
-@appendix Font File Keyword Index
+@node File Keyword Index, Program and File Index, String Index, Top
+@appendix File Keyword Index
 
 @printindex ky
 
@@ -17252,7 +18901,7 @@
 @c =====================================================================
 @c =====================================================================
 
-@node Program and File Index, Concept Index, Font File Keyword Index, Top
+@node Program and File Index, Concept Index, File Keyword Index, Top
 @appendix Program and File Index
 
 @printindex pg

_service:tar_scm:groff-1.23.0.tar.gz/doc/groff.txt Added

@@ -0,0 +1,18123 @@
+GNU 'troff'
+1 Introduction
+  1.1 Background
+  1.2 What Is 'groff'?
+  1.3 'groff' Capabilities
+  1.4 Macro Packages
+  1.5 Preprocessors
+  1.6 Output Devices
+  1.7 Installation
+  1.8 Conventions Used in This Manual
+  1.9 Credits
+2 Invoking 'groff'
+  2.1 Options
+  2.2 Environment
+  2.3 Macro Directories
+  2.4 Font Directories
+  2.5 Paper Format
+  2.6 Invocation Examples
+3 Tutorial for Macro Users
+  3.1 Basics
+  3.2 Common Features
+    3.2.1 Paragraphs
+    3.2.2 Sections and Chapters
+    3.2.3 Headers and Footers
+    3.2.4 Page Layout
+    3.2.5 Displays and Keeps
+    3.2.6 Footnotes and Endnotes
+    3.2.7 Table of Contents
+    3.2.8 Indexing
+    3.2.9 Document Formats
+    3.2.10 Columnation
+    3.2.11 Font and Size Changes
+    3.2.12 Predefined Text
+    3.2.13 Preprocessor Support
+    3.2.14 Configuration and Customization
+4 Macro Packages
+  4.1 'man'
+    4.1.1 Optional 'man' extensions
+      Custom headers and footers
+      Ultrix-specific man macros
+      Simple example
+  4.2 'mdoc'
+  4.3 'me'
+  4.4 'mm'
+  4.5 'mom'
+  4.6 'ms'
+    4.6.1 Introduction
+      4.6.1.1 Basic information
+    4.6.2 Document Structure
+    4.6.3 Document Control Settings
+      Margin settings
+      Titles (headers, footers)
+      Text settings
+      Paragraph settings
+      Heading settings
+      Footnote settings
+      Display settings
+      Other settings
+    4.6.4 Document Description Macros
+    4.6.5 Body Text
+      4.6.5.1 Text settings
+      4.6.5.2 Typographical symbols
+      4.6.5.3 Paragraphs
+      4.6.5.4 Headings
+      4.6.5.5 Typeface and decoration
+      4.6.5.6 Lists
+      4.6.5.7 Indented regions
+      4.6.5.8 Keeps, boxed keeps, and displays
+      4.6.5.9 Tables, figures, equations, and references
+      4.6.5.10 Footnotes
+      4.6.5.11 Language and localization
+    4.6.6 Page layout
+      4.6.6.1 Headers and footers
+      4.6.6.2 Tab stops
+      4.6.6.3 Margins
+      4.6.6.4 Multiple columns
+      4.6.6.5 Creating a table of contents
+    4.6.7 Differences from AT&T 'ms'
+      4.6.7.1 Unix Version 7 'ms' macros not implemented by 'groff' 'ms'
+    4.6.8 Legacy Features
+      AT&T accent mark strings
+      Berkeley accent mark and glyph strings
+    4.6.9 Naming Conventions
+5 GNU 'troff' Reference
+  5.1 Text
+    5.1.1 Filling
+    5.1.2 Sentences
+    5.1.3 Hyphenation
+    5.1.4 Breaking
+    5.1.5 Adjustment
+    5.1.6 Tabs and Leaders
+    5.1.7 Requests and Macros
+    5.1.8 Macro Packages
+    5.1.9 Input Encodings
+    5.1.10 Input Conventions
+  5.2 Page Geometry
+  5.3 Measurements
+    5.3.1 Motion Quanta
+    5.3.2 Default Units
+  5.4 Numeric Expressions
+  5.5 Identifiers
+  5.6 Formatter Instructions
+    5.6.1 Control Characters
+    5.6.2 Invoking Requests
+    5.6.3 Calling Macros
+    5.6.4 Using Escape Sequences
+    5.6.5 Delimiters
+  5.7 Comments
+  5.8 Registers
+    5.8.1 Setting Registers
+    5.8.2 Interpolating Registers
+    5.8.3 Auto-increment
+    5.8.4 Assigning Register Formats
+    5.8.5 Built-in Registers
+  5.9 Manipulating Filling and Adjustment
+  5.10 Manipulating Hyphenation
+  5.11 Manipulating Spacing
+  5.12 Tabs and Fields
+    5.12.1 Leaders
+    5.12.2 Fields
+  5.13 Character Translations
+  5.14 'troff' and 'nroff' Modes
+  5.15 Line Layout
+  5.16 Line Continuation
+  5.17 Page Layout
+  5.18 Page Control
+  5.19 Using Fonts
+    5.19.1 Selecting Fonts
+    5.19.2 Font Families
+    5.19.3 Font Positions
+    5.19.4 Using Symbols
+    5.19.5 Character Classes
+    5.19.6 Special Fonts
+    5.19.7 Artificial Fonts
+    5.19.8 Ligatures and Kerning
+    5.19.9 Italic Corrections
+    5.19.10 Dummy Characters
+  5.20 Manipulating Type Size and Vertical Spacing
+    5.20.1 Changing the Type Size
+    5.20.2 Changing the Vertical Spacing
+    5.20.3 Using Fractional Type Sizes
+  5.21 Colors
+  5.22 Strings
+  5.23 Conditionals and Loops
+    5.23.1 Operators in Conditionals
+    5.23.2 if-then
+    5.23.3 if-else
+    5.23.4 Conditional Blocks
+    5.23.5 while
+  5.24 Writing Macros
+    5.24.1 Parameters
+    5.24.2 Copy Mode
+  5.25 Page Motions
+  5.26 Drawing Geometric Objects
+  5.27 Deferring Output
+  5.28 Traps
+    5.28.1 Vertical Position Traps
+      5.28.1.1 Page Location Traps
+      5.28.1.2 The Implicit Page Trap
+      5.28.1.3 Diversion Traps
+    5.28.2 Input Line Traps
+    5.28.3 Blank Line Traps
+    5.28.4 Leading Space Traps
+    5.28.5 End-of-input Traps
+  5.29 Diversions
+  5.30 Punning Names
+  5.31 Environments
+  5.32 Suppressing Output
+  5.33 I/O
+  5.34 Postprocessor Access
+  5.35 Miscellaneous
+  5.36 'gtroff' Internals
+  5.37 Debugging
+    5.37.1 Warnings
+  5.38 Implementation Differences
+    5.38.1 Safer Mode
+    5.38.2 Compatibility Mode
+    5.38.3 Other Differences
+6 File Formats
+  6.1 'gtroff' Output
+    6.1.1 Language Concepts
+      6.1.1.1 Separation
+      6.1.1.2 Argument Units
+      6.1.1.3 Document Parts
+    6.1.2 Command Reference
+      6.1.2.1 Comment Command
+      6.1.2.2 Simple Commands
+      6.1.2.3 Graphics Commands
+      6.1.2.4 Device Control Commands
+      6.1.2.5 Obsolete Command
+    6.1.3 Intermediate Output Examples
+    6.1.4 Output Language Compatibility
+  6.2 Device and Font Description Files
+    6.2.1 'DESC' File Format
+    6.2.2 Font Description File Format
+Appendix A Copying This Manual
+Appendix B Request Index
+Appendix C Escape Sequence Index
+Appendix D Operator Index
+Appendix E Register Index
+Appendix F Macro Index
+Appendix G String Index
+Appendix H File Keyword Index
+Appendix I Program and File Index
+Appendix J Concept Index
+GNU 'troff'
+***********
+
+This manual documents GNU 'troff' version 1.23.0.
+
+   Copyright © 1994-2023 Free Software Foundation, Inc.
+
+     Permission is granted to copy, distribute and/or modify this
+     document under the terms of the GNU Free Documentation License,
+     Version 1.3 or any later version published by the Free Software
+     Foundation; with no Invariant Sections, no Front-Cover Texts, and
+     no Back-Cover Texts.  A copy of the license is included in the
+     section entitled "GNU Free Documentation License".
+
+1 Introduction
+**************
+
+GNU 'roff' (or 'groff') is a programming system for typesetting
+documents.  It is highly flexible and has been used extensively for over
+thirty years.
+
+1.1 Background
+==============
+
+M. Douglas McIlroy, formerly of AT&T Bell Laboratories and present at
+the creation of the Unix operating system, offers an authoritative
+historical summary.
+
+     The prime reason for Unix was the desire of Ken Thompson, Dennis
+     Ritchie, and Joe Ossanna to have a pleasant environment for
+     software development.  The fig leaf that got the nod from ...
+     management was that an early use would be to develop a
+     "stand-alone" word-processing system for use in typing pools and
+     secretarial offices.  Perhaps they had in mind "dedicated", as
+     distinct from "stand-alone"; that's what eventuated in various
+     cases, most notably in the legal/patent department and in the AT&T
+     CEO's office.
+
+     Both those systems were targets of opportunity, not foreseen from
+     the start.  When Unix was up and running on the PDP-11, Joe got
+     wind of the legal department having installed a commercial word
+     processor.  He went to pitch Unix as an alternative and clinched a
+     trial by promising to make 'roff' able to number lines by tomorrow
+     in order to fulfill a patent-office requirement that the commercial
+     system did not support.
+
+     Modems were installed so legal-department secretaries could try the
+     Research machine.  They liked it and Joe's superb customer service.
+     Soon the legal department got a system of their own.  Joe went on
+     to create 'nroff' and 'troff'.  Document preparation became a
+     widespread use of Unix, but no stand-alone word-processing system
+     was ever undertaken.
+
+   A history relating 'groff' to its predecessors 'roff', 'nroff', and
+'troff' is available in the 'roff(7)' man page.
+
+1.2 What Is 'groff'?
+====================
+
+'groff' (GNU 'roff') is a typesetting system that reads plain text input
+files that include formatting commands to produce output in PostScript,
+PDF, HTML, DVI, or other formats, or for display to a terminal.
+Formatting commands can be low-level typesetting primitives, macros from
+a supplied package, or user-defined macros.  All three approaches can be
+combined.
+
+   A reimplementation and extension of the typesetter from AT&T Unix,
+'groff' is present on most POSIX systems owing to its long association
+with Unix manuals (including man pages).  It and its predecessor are
+notable for their production of several best-selling software
+engineering texts.  'groff' is capable of producing typographically
+sophisticated documents while consuming minimal system resources.
+
+1.3 'groff' Capabilities
+========================
+
+GNU 'troff' is a typesetting document formatter; it provides a wide
+range of low-level text and page operations within the framework of a
+programming language.  These operations compose to generate footnotes,
+tables of contents, mathematical equations, diagrams, multi-column text,
+and other elements of typeset works.  Here is a survey of formatter
+features; all are under precise user control.
+
+   * text filling, breaking, alignment to the left or right margin;
+     centering
+
+   * adjustment of inter-word space size to justify text, and of
+     inter-sentence space size to suit local style conventions
+
+   * automatic and manual determination of hyphenation break points
+
+   * pagination
+
+   * selection of any font available to the output device
+
+   * adjustment of type size and vertical spacing (or "leading")
+
+   * configuration of line length and indentation amounts; columnation
+
+   * drawing of geometric primitives (lines, arcs, polygons, circles,
+     ...)
+
+   * setup of stroke and fill colors (where supported by the output
+     device)
+
+   * embedding of hyperlinks, images, document metadata, and other
+     inclusions (where supported by the output device)
+
+1.4 Macro Packages
+==================
+
+Elemental typesetting functions can be be challenging to use directly
+with complex documents.  A "macro" facility specifies how certain
+routine operations, such as starting paragraphs, or printing headers and
+footers, should be performed in terms of those low-level instructions.
+Macros can be specific to one document or collected together into a
+"macro package" for use by many.  Several macro packages available; the
+most widely used are provided with 'groff'.  They are 'man', 'mdoc',
+'me', 'mm', 'mom', and 'ms'.
+
+1.5 Preprocessors
+=================
+
+An alternative approach to complexity management, particularly when
+constructing tables, setting mathematics, or drawing diagrams, lies in
+preprocessing.  A "preprocessor" employs a domian-specific language to
+ease the generation of tables, equations, and so forth in terms that are
+convenient for human entry.  Each preprocessor reads a document and
+translates the parts of it that apply to it into GNU 'troff' input.
+Command-line options to 'groff' tell it which preprocessors to use.
+
+   'groff' provides preprocessors for laying out tables ('gtbl'),
+typesetting equations ('geqn'), drawing diagrams ('gpic' and 'ggrn'),
+inserting bibliographic references ('grefer'), and drawing chemical
+structures ('gchem').  An associated program that is useful when dealing
+with preprocessors is 'gsoelim'.(1)  (*note Preprocessor
+Intro-Footnote-1::)
+
+   'groff' also supports 'grap', a preprocessor for drawing graphs.  A
+free implementation of it can be obtained separately.
+
+   Unique to 'groff' is the 'preconv' preprocessor that enables 'groff'
+to handle documents in a variety of input encodings.
+
+   Other preprocessors exist, but no free implementations are known.  An
+example is 'ideal', which draws diagrams using a mathematical constraint
+language.
+
+   (1) The 'g' prefix is not used on all systems; see *note Invoking
+groff::.
+
+1.6 Output Devices
+==================
+
+GNU 'troff''s output is in a device-independent page description
+language, which is then read by an "output driver" that translates this
+language into a file format or byte stream that a piece of (possibly
+emulated) hardware understands.  'groff' features output drivers for
+PostScript devices, terminal emulators (and other simple typewriter-like
+machines), X11 (for previewing), TeX DVI, HP LaserJet 4/PCL5 and Canon
+LBP printers (which use CaPSL), HTML, XHTML, and PDF.
+
+1.7 Installation
+================
+
+Locate installation instructions in the files 'INSTALL',
+'INSTALL.extra', and 'INSTALL.REPO' in the 'groff' source distribution.
+Being a GNU project, 'groff' supports the familiar './configure && make'
+command sequence.
+
+1.8 Conventions Used in This Manual
+===================================
+
+We apply the term "groff" to the language documented here, the GNU
+implementation of the overall system, the project that develops that
+system, and the command of that name.  In the first sense, 'groff' is an
+extended dialect of the 'roff' language, for which many similar
+implementations exist.
+
+   The 'roff' language features several major categories for which many
+items are predefined.  Presentations of these items feature the form in
+which the item is most commonly used on the left, and, aligned to the
+right margin, the name of the category in brackets.
+
+ -- Register: \nexample
+     The register 'example' is one that that 'groff' _doesn't_
+     predefine.  You can create it yourself, though; see *note Setting
+     Registers::.
+
+   To make this document useful as a reference and not merely amiable
+bedtime reading, we tend to present these syntax items in exhaustive
+detail when they arise.  References to topics discussed later in the
+text are frequent; skip material you don't understand yet.
+
+   We use Texinfo's "result" (=>) and error-> notations to present
+output written to the standard output and standard error streams,
+respectively.  Diagnostic messages from the GNU 'troff' formatter and
+other programs are examples of the latter, but the formatter can also be
+directed to write user-specified messages to the standard error stream.
+The notation then serves to identify the output stream and does not
+necessarily mean that an error has occurred.(1)  (*note Conventions Used
+in This Manual-Footnote-1::)
+
+     $ echo "Twelve o'clock and" | groff -Tascii | sed '/^$/d'
+         => Twelve o'clock and
+     $ echo '.tm all is well.' | groff > /dev/null
+         error-> all is well.
+
+   Sometimes we use => somewhat abstractly to represent formatted text
+that you will need to use a PostScript or PDF viewer program (or a
+printer) to observe.  While arguably an abuse of notation, we think this
+preferable to requiring the reader to understand the syntax of these
+page description languages.
+
+   We also present diagnostic messages in an abbreviated form, often
+omitting the name of the program issuing them, the input file name, and
+line number or other positional information when such data do not serve
+to illuminate the topic under discussion.
+
+   Most examples are of 'roff' language input that would be placed in a
+text file.  Occasionally, we start an example with a '$' character to
+indicate a shell prompt, as seen above.
+
+   You are encouraged to try the examples yourself, and to alter them to
+better learn 'groff''s behavior.  Our examples frequently need to direct
+the formatter to set a line length (with '.ll') that will fit within the
+page margins of this manual.  We mention this so that you know why it is
+there before we discuss the 'll' request formally.(2)  (*note
+Conventions Used in This Manual-Footnote-2::)
+
+   (1) Unix and related operating systems distinguish standard output
+and standard error streams _because_ of 'troff':
+<https://minnie.tuhs.org/pipermail/tuhs/2013-December/006113.html>.
+
+   (2) *Note Line Layout::.
+
+1.9 Credits
+===========
+
+We adapted portions of this manual from existing documents.  James
+Clark's man pages were an essential resource; we have updated them in
+parallel with the development of this manual.  We based the tutorial for
+macro users on Eric Allman's introduction to his 'me' macro package
+(which we also provide, little altered from 4.4BSD). Larry Kollar
+contributed much of the material on the 'ms' macro package.
+
+2 Invoking 'groff'
+******************
+
+This chapter focuses on how to invoke the 'groff' front end.  This front
+end takes care of the details of constructing the pipeline among the
+preprocessors, 'gtroff' and the postprocessor.
+
+   It has become a tradition that GNU programs get the prefix 'g' to
+distinguish them from their original counterparts provided by the host
+(*note Environment::).  Thus, for example, 'geqn' is GNU 'eqn'.  On
+operating systems like GNU/Linux or the Hurd, which don't contain
+proprietary versions of 'troff', and on MS-DOS/MS-Windows, where 'troff'
+and associated programs are not available at all, this prefix is omitted
+since GNU 'troff' is the only incarnation of 'troff' used.  Exception:
+'groff' is never replaced by 'roff'.
+
+   In this document, we consequently say 'gtroff' when talking about the
+GNU 'troff' program.  All other implementations of 'troff' are called
+AT&T 'troff', which is the common origin of almost all 'troff'
+implementations(1) (*note Invoking groff-Footnote-1::) (with more or
+less compatible changes).  Similarly, we say 'gpic', 'geqn', and so on.
+
+   (1) Besides 'groff', 'neatroff' is an exception.
+
+2.1 Options
+===========
+
+'groff' normally runs the 'gtroff' program and a postprocessor
+appropriate for the selected device.  The default device is 'ps' (but it
+can be changed when 'groff' is configured and built).  It can optionally
+preprocess with any of 'gpic', 'geqn', 'gtbl', 'ggrn', 'grap', 'gchem',
+'grefer', 'gsoelim', or 'preconv'.
+
+   This section documents only options to the 'groff' front end.  Many
+of the arguments to 'groff' are passed on to 'gtroff'; therefore, those
+are also included.  Arguments to preprocessors and output drivers can be
+found in the man pages 'gpic(1)', 'geqn(1)', 'gtbl(1)', 'ggrn(1)',
+'grefer(1)', 'gchem(1)', 'gsoelim(1)', 'preconv(1)', 'grotty(1)',
+'grops(1)', 'gropdf(1)', 'grohtml(1)', 'grodvi(1)', 'grolj4(1)',
+'grolbp(1)', and 'gxditview(1)'.
+
+   The command-line format for 'groff' is:
+
+     groff  -abceghijklpstvzCEGNRSUVXZ   -dCS   -DARG 
+            -fFAM   -FDIR   -IDIR   -KARG 
+            -LARG   -mNAME   -MDIR   -nNUM 
+            -oLIST   -PARG   -rCN   -TDEV 
+            -wNAME   -WNAME   FILES... 
+
+   The command-line format for 'gtroff' is as follows.
+
+     gtroff  -abcivzCERU   -dCS   -fFAM   -FDIR 
+             -mNAME   -MDIR   -nNUM   -oLIST 
+             -rCN   -TNAME   -wNAME   -WNAME 
+             FILES... 
+
+Obviously, many of the options to 'groff' are actually passed on to
+'gtroff'.
+
+   Options without an argument can be grouped behind a single '-'.  A
+filename of '-' denotes the standard input.  Whitespace is permitted
+between an option and its argument.
+
+   The 'grog' command can be used to guess the correct 'groff' command
+to format a file.  See its man page 'grog(1)'; type 'man grog' at the
+command line to view it.
+
+   'groff''s command-line options are as follows.
+
+'-a'
+     Generate a plain text approximation of the typeset output.  The
+     read-only register '.A' is set to 1.  *Note Built-in Registers::.
+     This option produces a sort of abstract preview of the formatted
+     output.
+
+        * Page breaks are marked by a phrase in angle brackets; for
+          example, '<beginning of page>'.
+
+        * Lines are broken where they would be in the formatted output.
+
+        * A horizontal motion of any size is represented as one space.
+          Adjacent horizontal motions are not combined.  Inter-sentence
+          space nodes (those arising from the second argument to the
+          'ss' request) are not represented.
+
+        * Vertical motions are not represented.
+
+        * Special characters are rendered in angle brackets; for
+          example, the default soft hyphen character appears as '<hy>'.
+
+     The above description should not be considered a specification; the
+     details of '-a' output are subject to change.
+
+'-b'
+     Write a backtrace reporting the state of 'gtroff''s input parser to
+     the standard error stream with each diagnostic message.  The line
+     numbers given in the backtrace might not always be correct, because
+     'gtroff''s idea of line numbers can be confused by requests that
+     append to macros.
+
+'-c'
+     Start with color output disabled.
+
+'-C'
+     Enable AT&T 'troff' compatibility mode; implies '-c'.  *Note
+     Implementation Differences::, for the list of incompatibilities
+     between 'groff' and AT&T 'troff'.
+
+'-dCTEXT'
+'-dSTRING=TEXT'
+     Define 'roff' string C or STRING as T or TEXT.  C must be one
+     character; STRING can be of arbitrary length.  Such string
+     assignments happen before any macro file is loaded, including the
+     startup file.  Due to 'getopt_long' limitations, C cannot be, and
+     STRING cannot contain, an equals sign, even though that is a valid
+     character in a 'roff' identifier.
+
+'-DENC'
+     Set fallback input encoding used by 'preconv' to ENC; implies '-k'.
+
+'-e'
+     Run 'geqn' preprocessor.
+
+'-E'
+     Inhibit 'gtroff' error messages.  This option does _not_ suppress
+     messages sent to the standard error stream by documents or macro
+     packages using 'tm' or related requests.
+
+'-fFAM'
+     Use FAM as the default font family.  *Note Font Families::.
+
+'-FDIR'
+     Search in directory 'DIR' for the selected output device's
+     directory of device and font description files.  See the
+     description of 'GROFF_FONT_PATH' in *note Environment:: below for
+     the default search locations and ordering.
+
+'-g'
+     Run 'ggrn' preprocessor.
+
+'-G'
+     Run 'grap' preprocessor; implies '-p'.
+
+'-h'
+     Display a usage message and exit.
+
+'-i'
+     Read the standard input after all the named input files have been
+     processed.
+
+'-IDIR'
+     Search the directory DIR for files named in several contexts;
+     implies '-g' and '-s'.
+
+        * 'gsoelim' replaces 'so' requests with the contents of their
+          file name arguments.
+
+        * 'gtroff' searches for files named as operands in its command
+          line and as arguments to 'psbb', 'so', and 'soquiet' requests.
+
+        * Output drivers may search for files; for instance, 'grops'
+          looks for files named in '\X'ps: import ...'', '\X'ps: file
+          ...'', and '\X'pdf: pdfpic ...'' device control escape
+          sequences.
+
+     This option may be specified more than once; the directories are
+     searched in the order specified.  If you want to search the current
+     directory before others, add '-I .' at the desired place.  The
+     current working directory is otherwise searched last.  '-I' works
+     similarly to, and is named for, the "include" option of Unix C
+     compilers.
+
+     '-I' options are passed to 'gsoelim', 'gtroff', and output drivers;
+     with the flag letter changed to '-M', they are also passed to
+     'ggrn'.
+
+'-j'
+     Run 'gchem' preprocessor.  Implies '-p'.
+
+'-k'
+     Run 'preconv' preprocessor.  Refer to its man page for its behavior
+     if neither of 'groff''s '-K' or '-D' options is also specified.
+
+'-KENC'
+     Set input encoding used by 'preconv' to ENC; implies '-k'.
+
+'-l'
+     Send the output to a spooler for printing.  The 'print' directive
+     in the device description file specifies the default command to be
+     used; see *note Device and Font Description Files::.  See options
+     '-L' and '-X'.
+
+'-LARG'
+     Pass ARG to the print spooler program.  If multiple ARGs are
+     required, pass each with a separate '-L' option.  'groff' does not
+     prefix an option dash to ARG before passing it to the spooler
+     program.
+
+'-mNAME'
+     Process the file 'NAME.tmac' prior to any input files.  If not
+     found, 'tmac.NAME' is attempted.  NAME (in both arrangements) is
+     presumed to be a macro file; see the description of
+     'GROFF_TMAC_PATH' in *note Environment:: below for the default
+     search locations and ordering.  This option and its argument are
+     also passed to 'geqn', 'grap', and 'ggrn'.
+
+'-MDIR'
+     Search directory 'DIR' for macro files; see the description of
+     'GROFF_TMAC_PATH' in *note Environment:: below for the default
+     search locations and ordering.  This option and its argument are
+     also passed to 'geqn', 'grap', and 'ggrn'.
+
+'-nNUM'
+     Number the first page NUM.
+
+'-N'
+     Prohibit newlines between 'eqn' delimiters: pass '-N' to 'geqn'.
+
+'-oLIST'
+     Output only pages in LIST, which is a comma-separated list of page
+     ranges; 'N' means page N, 'M-N' means every page between M and N,
+     '-N' means every page up to N, 'N-' means every page from N on.
+     'gtroff' stops processing and exits after formatting the last page
+     enumerated in LIST.
+
+'-p'
+     Run 'gpic' preprocessor.
+
+'-PARG'
+     Pass ARG to the postprocessor.  If multiple ARGs are required, pass
+     each with a separate '-P' option.  'groff' does not prefix an
+     option dash to ARG before passing it to the postprocessor.
+
+'-rCNUMERIC-EXPRESSION'
+'-rREGISTER=EXPR'
+     Set 'roff' register C or REGISTER to the value NUMERIC-EXPRESSION
+     (*note Numeric Expressions::).  C must be one character; REGISTER
+     can be of arbitrary length.  Such register assignments happen
+     before any macro file is loaded, including the startup file.  Due
+     to 'getopt_long' limitations, C cannot be, and REGISTER cannot
+     contain, an equals sign, even though that is a valid character in a
+     'roff' identifier.
+
+'-R'
+     Run 'grefer' preprocessor.  No mechanism is provided for passing
+     arguments to 'grefer' because most 'grefer' options have equivalent
+     language elements that can be specified within the document.
+
+     'gtroff' also accepts a '-R' option, which is not accessible via
+     'groff'.  This option prevents the loading of the 'troffrc' and
+     'troffrc-end' files.
+
+'-s'
+     Run 'gsoelim' preprocessor.
+
+'-S'
+     Operate in "safer" mode; see '-U' below for its opposite.  For
+     security reasons, safer mode is enabled by default.
+
+'-t'
+     Run 'gtbl' preprocessor.
+
+'-TDEV'
+     Direct 'gtroff' to format the input for the output device DEV.
+     'groff' then calls an output driver to convert 'gtroff''s output to
+     a form appropriate for DEV.  The following output devices are
+     available.
+
+     'ps'
+          For PostScript printers and previewers.
+
+     'pdf'
+          For PDF viewers or printers.
+
+     'dvi'
+          For TeX DVI format.
+
+     'X75'
+          For a 75dpi X11 previewer.
+
+     'X75-12'
+          For a 75dpi X11 previewer with a 12-point base font in the
+          document.
+
+     'X100'
+          For a 100dpi X11 previewer.
+
+     'X100-12'
+          For a 100dpi X11 previewer with a 12-point base font in the
+          document.
+
+     'ascii'
+          For typewriter-like devices using the (7-bit) ASCII (ISO 646)
+          character set.
+
+     'latin1'
+          For typewriter-like devices that support the Latin-1
+          (ISO 8859-1) character set.
+
+     'utf8'
+          For typewriter-like devices that use the Unicode (ISO 10646)
+          character set with UTF-8 encoding.
+
+     'cp1047'
+          For typewriter-like devices that use the EBCDIC encoding IBM
+          code page 1047.
+
+     'lj4'
+          For HP LaserJet4-compatible (or other PCL5-compatible)
+          printers.
+
+     'lbp'
+          For Canon CaPSL printers (LBP-4 and LBP-8 series laser
+          printers).
+
+     'html'
+     'xhtml'
+          To produce HTML and XHTML output, respectively.  This driver
+          consists of two parts, a preprocessor ('pre-grohtml') and a
+          postprocessor ('post-grohtml').
+
+     The predefined GNU 'troff' string '.T' contains the name of the
+     output device; the read-only register '.T' is set to 1 if this
+     option is used (which is always true if 'groff' is used to call GNU
+     'troff').  *Note Built-in Registers::.
+
+     The postprocessor to be used for a device is specified by the
+     'postpro' command in the device description file.  (*Note Device
+     and Font Description Files::.)  This can be overridden with the
+     '-X' option.
+
+'-U'
+     Operate in "unsafe mode", which enables the 'open', 'opena', 'pi',
+     'pso', and 'sy' requests.  These requests are disabled by default
+     because they allow an untrusted input document to write to
+     arbitrary file names and run arbitrary commands.  This option also
+     adds the current directory to the macro package search path; see
+     the '-m' option above.  '-U' is passed to 'gpic' and 'gtroff'.
+
+'-v'
+     Write version information for 'groff' and all programs run by it to
+     the standard output stream; that is, the given command line is
+     processed in the usual way, passing '-v' to the formatter and any
+     pre- or postprocessors invoked.
+
+'-V'
+     Output the pipeline that would be run by 'groff' (as a wrapper
+     program) to the standard output stream, but do not execute it.  If
+     given more than once, the pipeline is both written to the standard
+     error stream and run.
+
+'-wCATEGORY'
+     Enable warnings in CATEGORY.  Categories are listed in *note
+     Warnings::.
+
+'-WCATEGORY'
+     Inhibit warnings in CATEGORY.  Categories are listed in *note
+     Warnings::.
+
+'-X'
+     Use 'gxditview' instead of the usual postprocessor to (pre)view a
+     document on an X11 display.  Combining this option with '-Tps' uses
+     the font metrics of the PostScript device, whereas the '-TX75' and
+     '-TX100' options use the metrics of X11 fonts.
+
+'-z'
+     Suppress formatted output from 'gtroff'.
+
+'-Z'
+     Disable postprocessing.  'gtroff' output will appear on the
+     standard output stream (unless suppressed with '-z'; see *note
+     gtroff Output:: for a description of this format.
+
+2.2 Environment
+===============
+
+There are also several environment variables (of the operating system,
+not within 'gtroff') that can modify the behavior of 'groff'.
+
+'GROFF_BIN_PATH'
+     This search path, followed by 'PATH', is used for commands executed
+     by 'groff'.
+
+'GROFF_COMMAND_PREFIX'
+     If this is set to X, then 'groff' runs 'Xtroff' instead of
+     'gtroff'.  This also applies to 'tbl', 'pic', 'eqn', 'grn', 'chem',
+     'refer', and 'soelim'.  It does not apply to 'grops', 'grodvi',
+     'grotty', 'pre-grohtml', 'post-grohtml', 'preconv', 'grolj4',
+     'gropdf', and 'gxditview'.
+
+     The default command prefix is determined during the installation
+     process.  If a non-GNU 'troff' system is found, prefix 'g' is used,
+     none otherwise.
+
+'GROFF_ENCODING'
+     The value of this variable is passed to the 'preconv'
+     preprocessor's '-e' option to select the character encoding of
+     input files.  This variable's existence implies the 'groff' option
+     '-k'.  If set but empty, 'groff' calls 'preconv' without an '-e'
+     option.  'groff''s '-K' option overrides 'GROFF_ENCODING'.  See the
+     'preconv(7)' man page; type 'man preconv' at the command line to
+     view it.
+
+'GROFF_FONT_PATH'
+     A list of directories in which to seek the selected output device's
+     directory of device and font description files.  GNU 'troff' will
+     search directories given as arguments to any specified '-F' options
+     before these, and a built-in list of directories after them.  *Note
+     Font Directories:: and the 'troff(1)' or 'gtroff(1)' man pages.
+
+'GROFF_TMAC_PATH'
+     A list of directories in which to seek macro files.  GNU 'troff'
+     will search directories given as arguments to any specified '-M'
+     options before these, and a built-in list of directories after
+     them.  *Note Macro Directories:: and the 'troff(1)' or 'gtroff(1)'
+     man pages.
+
+'GROFF_TMPDIR'
+     The directory in which 'groff' creates temporary files.  If this is
+     not set and 'TMPDIR' is set, temporary files are created in that
+     directory.  Otherwise temporary files are created in a
+     system-dependent default directory (on Unix and GNU/Linux systems,
+     this is usually '/tmp').  'grops', 'grefer', 'pre-grohtml', and
+     'post-grohtml' can create temporary files in this directory.
+
+'GROFF_TYPESETTER'
+     Sets the default output device.  If empty or not set, a build-time
+     default (often 'ps') is used.  The '-TDEV' option overrides
+     'GROFF_TYPESETTER'.
+
+'SOURCE_DATE_EPOCH'
+     A timestamp (expressed as seconds since the Unix epoch) to use as
+     the output creation timestamp in place of the current time.  The
+     time is converted to human-readable form using 'localtime(3)' when
+     the formatter starts up and stored in registers usable by documents
+     and macro packages (*note Built-in Registers::).
+
+'TZ'
+     The time zone to use when converting the current time (or value of
+     'SOURCE_DATE_EPOCH') to human-readable form; see 'tzset(3)'.
+
+   MS-DOS and MS-Windows ports of 'groff' use semicolons, rather than
+colons, to separate the directories in the lists described above.
+
+2.3 Macro Directories
+=====================
+
+A macro file must have a name in the form 'NAME.tmac' or 'tmac.NAME' and
+be placed in a "tmac directory" to be found by the '-mNAME' command-line
+option.(1)  (*note Macro Directories-Footnote-1::) Together, these
+directories constitute the "tmac path".  Each directory is searched in
+the following order until the desired macro file is found or the list is
+exhausted.
+
+   * Directories specified with GNU 'troff''s or 'groff''s '-M'
+     command-line option.
+
+   * Directories listed in the 'GROFF_TMAC_PATH' environment variable.
+
+   * The current working directory (only if in unsafe mode using the
+     '-U' command-line option).
+
+   * The user's home directory, 'HOME'.
+
+   * A platform-dependent directory, a site-local (platform-independent)
+     directory, and the main tmac directory.  The locations
+     corresponding to your installation are listed in section
+     "Environment" of 'gtroff(1)'.  If not otherwise configured, they
+     are as follows.
+
+          /usr/local/lib/groff/site-tmac
+          /usr/local/share/groff/site-tmac
+          /usr/local/share/groff/1.23.0/tmac
+
+     The foregoing assumes that the version of 'groff' is 1.23.0, and
+     that the installation prefix was '/usr/local'.  It is possible to
+     fine-tune these locations during the source configuration process.
+
+   (1) The 'mso' request does not have these limitations.  *Note I/O::.
+
+2.4 Font Directories
+====================
+
+'groff' enforces few restrictions on how font description files are
+named.  For its family/style mechanism to work (*note Font Families::),
+the names of fonts within a family should start with the family name,
+followed by the style.  For example, the Times family uses 'T' for the
+family name and 'R', 'B', 'I', and 'BI' to indicate the styles 'roman',
+'bold', 'italic', and 'bold italic', respectively.  Thus the final font
+names are 'TR', 'TB', 'TI', and 'TBI'.
+
+   Font description files are kept in "font directories", which together
+constitute the "font path".  The search procedure always appends the
+directory 'dev'NAME, where NAME is the name of the output device.
+Assuming TeX DVI output, and '/foo/bar' as a font directory, the font
+description files for 'grodvi' must be in '/foo/bar/devdvi'.  Each
+directory in the font path is searched in the following order until the
+desired font description file is found or the list is exhausted.
+
+   * Directories specified with GNU 'troff''s or 'groff''s '-f'
+     command-line option.  All output drivers (and some preprocessors)
+     support this option as well, because they require information about
+     the glyphs to be rendered in the document.
+
+   * Directories listed in the 'GROFF_FONT_PATH' environment variable.
+
+   * A site-local directory and the main font description directory.
+     The locations corresponding to your installation are listed in
+     section "Environment" of 'gtroff(1)'.  If not otherwise configured,
+     they are as follows.
+
+          /usr/local/share/groff/site-font
+          /usr/local/share/groff/1.23.0/font
+
+     The foregoing assumes that the version of 'groff' is 1.23.0, and
+     that the installation prefix was '/usr/local'.  It is possible to
+     fine-tune these locations during the source configuration process.
+
+2.5 Paper Format
+================
+
+In 'groff', the page dimensions for the formatter GNU 'troff' and for
+output devices are handled separately.  *Note Page Layout::, for
+vertical manipulation of the page size, and *Note Line Layout::, for
+horizontal changes.  The 'papersize' macro package, normally loaded by
+'troffrc' at startup, provides an interface for configuring page
+dimensions by convenient names, like 'letter' or 'a4'; see
+'groff_tmac(5)'.  The default used by the formatter depends on its build
+configuration, but is usually one of the foregoing, as geographically
+appropriate.
+
+   It is up to each macro package to respect the page dimensions
+configured in this way.
+
+   For each output device, the size of the output medium can be set in
+its 'DESC' file.  Most output drivers also recognize a command-line
+option '-p' to override the default dimensions and an option '-l' to use
+landscape orientation.  *Note DESC File Format::, for a description of
+the 'papersize' keyword, which takes an argument of the same form as
+'-p'.  The output driver's man page, such as 'grops(1)', may also be
+helpful.
+
+   'groff' uses the command-line option '-P' to pass options to
+postprocessors; for example, use the following for PostScript output on
+A4 paper in landscape orientation.
+
+     groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+
+2.6 Invocation Examples
+=======================
+
+'roff' systems are best known for formatting man pages.  Once a 'man'
+librarian program has located a man page, it may execute a 'groff'
+command much like the following.
+
+     groff -t -man -Tutf8 /usr/share/man/man1/groff.1
+
+   The librarian will also pipe the output through a pager, which might
+not interpret the SGR terminal escape sequences 'groff' emits for
+boldface, underlining, or italics; see the 'grotty(1)' man page for a
+discussion.
+
+   To process a 'roff' input file using the preprocessors 'gtbl' and
+'gpic' and the 'me' macro package in the way to which AT&T 'troff' users
+were accustomed, one would type (or script) a pipeline.
+
+     gpic foo.me | gtbl | gtroff -me -Tutf8 | grotty
+
+   Using 'groff', this pipe can be shortened to an equivalent command.
+
+     groff -p -t -me -T utf8 foo.me
+
+   An even easier way to do this is to use 'grog' to guess the
+preprocessor and macro options and execute the result by using the
+command substitution feature of the shell.
+
+     $(grog -Tutf8 foo.me)
+
+   Each command-line option to a postprocessor must be specified with
+any required leading dashes '-' because 'groff' passes the arguments
+as-is to the postprocessor; this permits arbitrary arguments to be
+transmitted.  For example, to pass a title to the 'gxditview'
+postprocessor, the shell commands
+
+     groff -X -P -title -P 'trial run' mydoc.t
+
+and
+
+     groff -X -Z mydoc.t | gxditview -title 'trial run' -
+
+are equivalent.
+
+3 Tutorial for Macro Users
+**************************
+
+Most users of the 'roff' language employ a macro package to format their
+documents.  Successful macro packages ease the composition process;
+their users need not have mastered the full formatting language, nor
+understand features like diversions, traps, and environments.  This
+chapter aims to familiarize you with basic concepts and mechanisms
+common to many macro packages (like "displays").  If you prefer a
+meticulous and comprehensive presentation, try *note GNU troff
+Reference:: instead.
+
+3.1 Basics
+==========
+
+Let us first survey some basic concepts necessary to use a macro package
+fruitfully.(1)  (*note Basics-Footnote-1::) References are made
+throughout to more detailed information.
+
+   GNU 'troff' reads an input file prepared by the user and outputs a
+formatted document suitable for publication or framing.  The input
+consists of text, or words to be printed, and embedded commands
+(requests and escape sequences), which tell GNU 'troff' how to format
+the output.  *Note Formatter Instructions::.
+
+   The word argument is used in this chapter to mean a word or number
+that appears on the same line as a request, and which modifies the
+meaning of that request.  For example, the request
+
+     .sp
+
+spaces one line, but
+
+     .sp 4
+
+spaces four lines.  The number 4 is an argument to the 'sp' request,
+which says to space four lines instead of one.  Arguments are separated
+from the request and from each other by spaces (_not_ tabs).  *Note
+Invoking Requests::.
+
+   The primary function of GNU 'troff' is to collect words from input
+lines, fill output lines with those words, adjust the line to the
+right-hand margin by widening spaces, and output the result.  For
+example, the input:
+
+     Now is the time
+     for all good men
+     to come to the aid
+     of their party.
+     Four score and seven
+     years ago, etc.
+
+is read, packed onto output lines, and justified to produce:
+
+       => Now is the time for all good men to come to the aid of
+       => their party.  Four score and seven years ago, etc.
+
+   Sometimes a new output line should be started even though the current
+line is not yet full--for example, at the end of a paragraph.  To do
+this it is possible to force a break, starting a new output line.  Some
+requests cause a break automatically, as do (normally) blank input lines
+and input lines beginning with a space or tab.
+
+   Not all input lines are text lines--words to be formatted.  Some are
+control lines that tell a macro package (or GNU 'troff' directly) how to
+format the text.  Control lines start with a dot ('.') or an apostrophe
+(''') as the first character, and can be followed by a macro call.
+
+   The formatter also does more complex things, such as automatically
+numbering pages, skipping over page boundaries, putting footnotes in the
+correct place, and so forth.
+
+   Here are a few hints for preparing text for input to GNU 'troff'.
+
+   * First, keep the input lines short.  Short input lines are easier to
+     edit, and GNU 'troff' packs words onto longer lines anyhow.
+
+   * In keeping with this, it is helpful to begin a new line after every
+     comma or phrase, since common corrections are to add or delete
+     sentences or phrases.
+
+   * End each sentence with two spaces--or better, start each sentence
+     on a new line.  GNU 'troff' recognizes characters that usually end
+     a sentence, and inserts inter-sentence space accordingly.
+
+   * Do not hyphenate words at the end of lines--GNU 'troff' is smart
+     enough to hyphenate words as needed, but is not smart enough to
+     take hyphens out and join a word back together.  Also, words such
+     as "mother-in-law" should not be broken over a line, since then a
+     space can occur where not wanted, such as "mother- in-law".
+
+   We offer further advice in *note Input Conventions::.
+
+   GNU 'troff' permits alteration of the distance between lines of text.
+This is termed vertical spacing and is expressed in the same units as
+the type size--the point.  The default is 10-point type on 12-point
+spacing.  To get double-spaced text you would set the vertical spacing
+to 24 points.  Some, but not all, macro packages expose a macro or
+register to configure the vertical spacing.
+
+   A number of requests allow you to change the way the output is
+arranged on the page, sometimes called the layout of the output page.
+Most macro packages don't supply macros for performing these (at least
+not without performing other actions besides), as they are such basic
+operations.  The macro packages for writing man pages, 'man' and 'mdoc',
+don't encourage explicit use of these requests at all.
+
+   The request '.sp N' leaves N lines of blank space.  N can be omitted
+(skipping a single line) or can be of the form Ni (for N inches) or Nc
+(for N centimeters).  For example, the input:
+
+     .sp 1.5i
+     My thoughts on the subject
+     .sp
+
+leaves one and a half inches of space, followed by the line "My thoughts
+on the subject", followed by a single blank line (more measurement units
+are available; see *note Measurements::).
+
+   If you seek precision in spacing, be advised when using a macro
+package that it might not honor 'sp' requests as you expect; it can use
+a formatter feature called no-space mode to prevent excess space from
+accumulating.  Macro packages typically offer registers to control
+spacing between paragraphs, before section headings, and around displays
+(discussed below); use these facilities preferentially.  *Note
+Manipulating Spacing::.
+
+   Text lines can be centered by using the 'ce' request.  The line after
+'ce' is centered (horizontally) on the page.  To center more than one
+line, use '.ce N' (where N is the number of lines to center), followed
+by the N lines.  To center many lines without counting them, type:
+
+     .ce 1000
+     lines to center
+     .ce 0
+
+The '.ce 0' request tells GNU 'troff' to center zero more lines, in
+other words, stop centering.
+
+   GNU 'troff' also offers the 'rj' request for right-aligning text.  It
+works analogously to 'ce' and is convenient for setting epigraphs.
+
+   The 'bp' request starts a new page; this necessarily implies an
+ordinary (line) break.
+
+   All of these requests cause a break; that is, they always start a new
+line.  To start a new line without performing any other action, use
+'br'.  If you invoke them with the apostrophe ''', the no-break control
+character, the (initial) break they normally perform is suppressed.
+''br' does nothing.
+
+   (1) The remainder of this chapter is based on 'Writing Papers with
+nroff using -me' by Eric P. Allman, which is distributed with 'groff' as
+'meintro.me'.
+
+3.2 Common Features
+===================
+
+GNU 'troff' provides low-level operations for formatting a document.
+Many routine operations are undertaken in nearly all documents that
+require a series of such primitive operations to be performed.  These
+common tasks are grouped into macros, which are then collected into a
+macro package.
+
+   Macro packages come in two varieties: "major" or "full-service" ones
+that manage page layout, and "minor" or "auxiliary" ones that do not,
+instead fulfilling narrow, specific tasks.  Find a list in the
+'groff_tmac(5)' man page.  Type 'man groff_tmac' at the command line to
+view it.
+
+   We survey several capabilities of full-service macro package below.
+Each package employs its own macros to exercise them.  For details,
+consult its man page or, for 'ms', see *note ms::.
+
+3.2.1 Paragraphs
+----------------
+
+Paragraphs can be separated and indented in various ways.  Some start
+with a blank line and have a first-line indentation, like most of the
+ones in this manual.  Block paragraphs omit the indentation.
+
+       => Some  men  look  at constitutions with sanctimonious
+       => reverence,  and  deem  them  like  the  ark  of  the
+       => covenant, too sacred to be touched.
+
+We also frequently encounter tagged paragraphs, which begin with a tag
+or label at the left margin and indent the remaining text.
+
+       => one  This  is the first paragraph.  Notice how the
+       =>      first line of the resulting  paragraph  lines
+       =>      up with the other lines in the paragraph.
+
+If the tag is too wide for the indentation, the line is broken.
+
+       => longlabel
+       =>      The  label does not align with the subsequent
+       =>      lines, but they align with each other.
+
+A variation of the tagged paragraph is the itemized or enumerated
+paragraph, which might use punctuation or a digit for a tag,
+respectively.  These are frequently used to construct lists.
+
+       => o    This  list  item  starts with a bullet.  When
+       =>      producing output for a device using the ASCII
+       =>      character set, an 'o' is formatted instead.
+
+Often, use of the same macro without a tag continues such a discussion.
+
+       => -xyz  This option is recognized but ignored.
+       =>
+       =>       It had a security hole that we don't discuss.
+
+3.2.2 Sections and Chapters
+---------------------------
+
+The simplest kind of section heading is unnumbered, set in a bold or
+italic style, and occupies a line by itself.  Others possess
+automatically numbered multi-level headings and/or different typeface
+styles or sizes at different levels.  More sophisticated macro packages
+supply macros for designating chapters and appendices.
+
+3.2.3 Headers and Footers
+-------------------------
+
+Headers and footers occupy the top and bottom of each page,
+respectively, and contain data like the page number and the article or
+chapter title.  Their appearance is not affected by the running text.
+Some packages allow for different titles on even- and odd-numbered pages
+(for printed, bound material).
+
+   Headers and footers are together called titles, and comprise three
+parts: left-aligned, centered, and right-aligned.  A '%' character
+appearing anywhere in a title is automatically replaced by the page
+number.  *Note Page Layout::.
+
+3.2.4 Page Layout
+-----------------
+
+Most macro packages let the user specify the size of the page margins.
+The top and bottom margins are typically handled differently than the
+left and right margins; the latter two are derived from the page offset,
+indentation, and line length.  *Note Line Layout::.  Commonly, packages
+support registers to tune these values.
+
+3.2.5 Displays and Keeps
+------------------------
+
+Displays are sections of text set off from the surrounding material
+(typically paragraphs), often differing in indentation, and/or spacing.
+Tables, block quotations, and figures are displayed.  Equations and code
+examples, when not much shorter than an output line, often are.  Lists
+may or may not be.  Packages for setting man pages support example
+displays but not keeps.
+
+   A keep is a group of output lines, often a display, that is formatted
+on a single page if possible; it causes a page break to happen early so
+as to not interrupt the kept material.
+
+   Floating keeps can move, or "float", relative to the text around them
+in the input.  They are useful for displays that are captioned and
+referred to by name, as with "See figure 3".  Depending on the package,
+a floating keep appears at the bottom of the current page if it fits,
+and at the top of the next otherwise.  Alternatively, floating keeps
+might be deferred to the end of a section.  Using a floating keep can
+avoid the large vertical spaces that may precede a tall keep of the
+ordinary sort when it won't fit on the page.
+
+3.2.6 Footnotes and Endnotes
+----------------------------
+
+Footnotes and endnotes are forms of delayed formatting.  They are
+recorded at their points of relevance in the input, but not formatted
+there.  Instead, a mark cues the reader to check the "foot", or bottom,
+of the current page, or in the case of endnotes, an annotation list
+later in the document.  Macro packages that support these features also
+supply a means of automatically numbering either type of annotation.
+
+3.2.7 Table of Contents
+-----------------------
+
+A package may handle a table of contents by directing section heading
+macros to save section heading text and the page number where it occurs
+for use in a later entry for a table of contents.  It writes the
+collected entries at the end of the document, once all are known, upon
+request.  A row of dots (a leader) bridges the text on the left with its
+location on the right.  Other collections might work in this manner,
+providing lists of figures or tables.
+
+   A table of contents is often found at the end of a GNU 'troff'
+document because the formatter processes the document in a single pass.
+The 'gropdf' output driver supports a PDF feature that relocates pages
+at the time the document is rendered; see the 'gropdf(1)' man page.
+Type 'man gropdf' at the command line to view it.
+
+3.2.8 Indexing
+--------------
+
+An index is similar to a table of contents, in that entry labels and
+locations must be collected, but poses a greater challenge because it
+needs to be sorted before it is output.  Here, processing the document
+in multiple passes is inescapable, and tools like the 'makeindex'
+program are necessary.
+
+3.2.9 Document Formats
+----------------------
+
+Some macro packages supply stock configurations of certain documents,
+like business letters and memoranda.  These often also have provision
+for a cover sheet, which may be rigid in its format.  With these
+features, it is even more important to use the package's macros in
+preference to the formatter requests presented earlier, where possible.
+
+3.2.10 Columnation
+------------------
+
+Macro packages apart from 'man' and 'mdoc' for man page formatting offer
+a facility for setting multiple columns on the page.
+
+3.2.11 Font and Size Changes
+----------------------------
+
+The formatter's requests and escape sequences for setting the typeface
+and size are not always intuitive, so all macro packages provide macros
+to make these operations simpler.  They also make it more convenient to
+change typefaces in the middle of a word and can handle italic
+corrections automatically.  *Note Italic Corrections::.
+
+3.2.12 Predefined Text
+----------------------
+
+Most macro packages supply predefined strings to set prepared text like
+the date, or to perform operations like super- and subscripting.
+
+3.2.13 Preprocessor Support
+---------------------------
+
+All macro packages provide support for various preprocessors and may
+extend their functionality by defining macros to set their contents in
+displays.  Examples include 'TS' and 'TE' for 'gtbl', 'EQ' and 'EN' for
+'geqn', and 'PS' and 'PE' for 'gpic'.
+
+3.2.14 Configuration and Customization
+--------------------------------------
+
+Packages provide means of customizing many of the details of how the
+package behaves.  These range from setting the default type size to
+changing the appearance of section headers.
+
+4 Macro Packages
+****************
+
+This chapter surveys the "major" macro packages that come with 'groff'.
+One, 'ms', is presented in detail.
+
+   Major macro packages are also sometimes described as "full-service"
+due to the breadth of features they provide and because more than one
+cannot be used by the same document; for example
+
+     groff -m man foo.man -m ms bar.doc
+
+doesn't work.  Option arguments are processed before non-option
+arguments; the above (failing) sample is thus reordered to
+
+     groff -m man -m ms foo.man bar.doc
+
+   Many auxiliary, or "minor", macro packages are also available.  They
+may in general be used with any full-service macro package and handle a
+variety of tasks from character encoding selection, to language
+localization, to inlining of raster images.  See the 'groff_tmac(5)' man
+page for a list.  Type 'man groff_tmac' at the command line to view it.
+
+4.1 'man'
+=========
+
+The 'man' macro package is the most widely used and probably the most
+important ever developed for 'troff'.  It is easy to use, and a vast
+majority of manual pages ("man pages") are written in it.
+
+   'groff''s implementation is documented in the 'groff_man(7)' man
+page.  Type 'man groff_man' at the command line to view it.
+
+4.1.1 Optional 'man' extensions
+-------------------------------
+
+Use the file 'man.local' for local extensions to the 'man' macros or for
+style changes.
+
+Custom headers and footers
+..........................
+
+In 'groff' versions 1.18.2 and later, you can specify custom headers and
+footers by redefining the following macros in 'man.local'.
+
+ -- Macro: .PT
+     Control the content of the headers.  Normally, the header prints
+     the command name and section number on either side, and the
+     optional fifth argument to 'TH' in the center.
+
+ -- Macro: .BT
+     Control the content of the footers.  Normally, the footer prints
+     the page number and the third and fourth arguments to 'TH'.
+
+     Use the 'FT' register to specify the footer position.  The default
+     is -0.5i.
+
+Ultrix-specific man macros
+..........................
+
+The 'groff' source distribution includes a file named 'man.ultrix',
+containing macros compatible with the Ultrix variant of 'man'.  Copy
+this file into 'man.local' (or use the 'mso' request to load it) to
+enable the following macros.
+
+ -- Macro: .CT key
+     Print '<CTRL/KEY>'.
+
+ -- Macro: .CW
+     Print subsequent text using a "constant-width" (monospaced)
+     typeface (Courier roman).
+
+ -- Macro: .Ds
+     Begin a non-filled display.
+
+ -- Macro: .De
+     End a non-filled display started with 'Ds'.
+
+ -- Macro: .EX indent
+     Begin a non-filled display using a monospaced typeface (Courier
+     roman).  Use the optional INDENT argument to indent the display.
+
+ -- Macro: .EE
+     End a non-filled display started with 'EX'.
+
+ -- Macro: .G text
+     Set TEXT in Helvetica.  If no text is present on the line where the
+     macro is called, then the text of the next line appears in
+     Helvetica.
+
+ -- Macro: .GL text
+     Set TEXT in Helvetica oblique.  If no text is present on the line
+     where the macro is called, then the text of the next line appears
+     in Helvetica Oblique.
+
+ -- Macro: .HB text
+     Set TEXT in Helvetica bold.  If no text is present on the line
+     where the macro is called, then all text up to the next 'HB'
+     appears in Helvetica bold.
+
+ -- Macro: .TB text
+     Identical to 'HB'.
+
+ -- Macro: .MS title sect punct
+     Set a man page reference in Ultrix format.  The TITLE is in Courier
+     instead of italic.  Optional punctuation follows the section number
+     without an intervening space.
+
+ -- Macro: .NT C title
+     Begin a note.  Print the optional title, or the word "Note",
+     centered on the page.  Text following the macro makes up the body
+     of the note, and is indented on both sides.  If the first argument
+     is 'C', the body of the note is printed centered (the second
+     argument replaces the word "Note" if specified).
+
+ -- Macro: .NE
+     End a note begun with 'NT'.
+
+ -- Macro: .PN path punct
+     Set the path name in a monospaced typeface (Courier roman),
+     followed by optional punctuation.
+
+ -- Macro: .Pn punct path punct
+     If called with two arguments, identical to 'PN'.  If called with
+     three arguments, set the second argument in a monospaced typeface
+     (Courier roman), bracketed by the first and third arguments in the
+     current font.
+
+ -- Macro: .R
+     Switch to roman font and turn off any underlining in effect.
+
+ -- Macro: .RN
+     Print the string '<RETURN>'.
+
+ -- Macro: .VS 4
+     Start printing a change bar in the margin if the number '4' is
+     specified.  Otherwise, this macro does nothing.
+
+ -- Macro: .VE
+     End printing the change bar begun by 'VS'.
+
+Simple example
+..............
+
+The following example 'man.local' file alters the 'SH' macro to add some
+extra vertical space before printing the heading.  Headings are printed
+in Helvetica bold.
+
+     .\" Make the heading fonts Helvetica
+     .ds HF HB
+     .
+     .\" Put more space in front of headings.
+     .rn SH SH-orig
+     .de SH
+     .  if t .sp (u;\\nPD*2)
+     .  SH-orig \\$*
+     ..
+
+4.2 'mdoc'
+==========
+
+'groff''s implementation of the BSD 'doc' package for man pages is
+documented in the 'groff_mdoc(7)' man page.  Type 'man groff_mdoc' at
+the command line to view it.
+
+4.3 'me'
+========
+
+'groff''s implementation of the BSD 'me' macro package is documented
+using itself.  A tutorial, 'meintro.me', and reference, 'meref.me', are
+available in 'groff''s documentation directory.  A 'groff_me(7)' man
+page is also available and identifies the installation path for these
+documents.  Type 'man groff_me' at the command line to view it.
+
+   A French translation of the tutorial is available as 'meintro_fr.me'
+and installed parallel to the English version.
+
+4.4 'mm'
+========
+
+'groff''s implementation of the AT&T memorandum macro package is
+documented in the 'groff_mm(7)' man page.  Type 'man groff_mm' at the
+command line) to view it.
+
+   A Swedish localization of 'mm' is also available; see
+'groff_mmse(7)'.
+
+4.5 'mom'
+=========
+
+The main documentation files for the 'mom' macros are in HTML format.
+Additional, useful documentation is in PDF format.  See the 'groff(1)'
+man page, section "Installation Directories", for their location.
+
+   * 'toc.html' Entry point to the full mom manual.
+
+   * 'macrolist.html' Hyperlinked index of macros with brief
+     descriptions, arranged by category.
+
+   * 'mom-pdf.pdf' PDF features and usage.
+
+   The mom macros are in active development between 'groff' releases.
+The most recent version, along with up-to-date documentation, is
+available at <http://www.schaffter.ca/mom/mom-05.html>.
+
+   The 'groff_mom(7)' man page (type 'man groff_mom' at the command
+line) contains a partial list of available macros, however their usage
+is best understood by consulting the HTML documentation.
+
+4.6 'ms'
+========
+
+The 'ms' ("manuscript") package is suitable for the preparation of
+letters, memoranda, reports, and books.  These 'groff' macros feature
+cover page and table of contents generation, automatically numbered
+headings, several paragraph styles, a variety of text styling options,
+footnotes, and multi-column page layouts.  'ms' supports the 'tbl',
+'eqn', 'pic', and 'refer' preprocessors for inclusion of tables,
+mathematical equations, diagrams, and standardized bibliographic
+citations.  This implementation is mostly compatible with the documented
+interface and behavior of AT&T Unix Version 7 'ms'.  Many extensions
+from 4.2BSD (Berkeley) and Tenth Edition Research Unix have been
+recreated.
+
+4.6.1 Introduction
+------------------
+
+The 'ms' macros are the oldest surviving package for 'roff' systems.(1)
+(*note ms Introduction-Footnote-1::) While the 'man' package was
+designed for brief reference documents, the 'ms' macros are also
+suitable for longer works intended for printing and possible
+publication.
+
+   (1) While manual _pages_ are older, early ones used macros supplanted
+by the 'man' package of Seventh Edition Unix (1979).  'ms' shipped with
+Sixth Edition (1975) and was documented by Mike Lesk in a Bell Labs
+internal memorandum.
+
+4.6.1.1 Basic information
+.........................
+
+'ms' documents are plain text files; prepare them with your preferred
+text editor.  If you're in a hurry to start, know that 'ms' needs one of
+its macros called at the beginning of a document so that it can
+initialize.  A "macro" is a formatting instruction to 'ms'.  Put a macro
+call on a line by itself.  Use '.PP' if you want your paragraph's first
+line to be indented, or '.LP' if you don't.
+
+   After that, start typing normally.  It is a good practice to start
+each sentence on a new line, or to put two spaces after sentence-ending
+punctuation, so that the formatter knows where the sentence boundaries
+are.  You can separate paragraphs with further paragraphing macros, or
+with blank lines, and you can indent with tabs.  When you need one of
+the features mentioned earlier (*note ms::), return to this part of the
+manual.
+
+   Format the document with the 'groff' command.  'nroff' can be useful
+for previewing.
+
+     $ editor radical.ms
+     $ nroff -ww -z -ms radical.ms # check for errors
+     $ nroff -ms radical.ms | less -R
+     $ groff -T ps -ms radical.ms > radical.ps
+     $ see radical.ps
+
+   Our 'radical.ms' document might look like this.
+
+     .LP
+     Radical novelties are so disturbing that they tend to be
+     suppressed or ignored, to the extent that even the
+     possibility of their existence in general is more often
+     denied than admitted.
+
+     ->That's what Dijkstra said, anyway.
+
+   'ms' exposes many aspects of document layout to user control via
+'groff''s "registers" and "strings", which store numbers and text,
+respectively.  Measurements in 'groff' are expressed with a suffix
+called a "scaling unit".
+
+'i'
+     inches
+
+'c'
+     centimeters
+
+'p'
+     points (1/72 inch)
+
+'P'
+     picas (1/6 inch)
+
+'v'
+     vees; current vertical spacing
+
+'m'
+     ems; width of an "M" in the current font
+
+'n'
+     ens; one-half em
+
+   Set registers with the 'nr' request and strings with the 'ds'
+request.  "Requests" are like macro calls; they go on lines by
+themselves and start with the "control character", a dot ('.').  The
+difference is that they directly instruct the formatter program, rather
+than the macro package.  We'll discuss a few as applicable.  It is wise
+to specify a scaling unit when setting any register that represents a
+length, size, or distance.
+
+     .nr PS 10.5p \" Use 10.5-point type.
+     .ds FAM P    \" Use Palatino font family.
+
+In the foregoing, we see that '\"' begins a comment.  This is an example
+of an "escape sequence", the other kind of formatting instruction.
+Escape sequences can appear anywhere.  They begin with the escape
+character ('\') and are followed by at least one more character.  'ms'
+documents tend to use only a few of 'groff''s many requests and escape
+sequences; see *note Request Index:: and *note Escape Sequence Index::
+or the 'groff(7)' man page for complete lists.
+
+'\"'
+     Begin comment; ignore remainder of line.
+
+'\nREG'
+     Interpolate value of register REG.
+
+'\*STR'
+     Interpolate contents of string STR.
+
+'\*S'
+     abbreviation of '\*S'; the name S must be only one character
+
+'\CHAR'
+     Interpolate glyph of special character named CHAR.
+
+'\&'
+     dummy character
+
+'\~'
+     Insert an unbreakable space that is adjustable like a normal space.
+
+'\|'
+     Move horizontally by one-sixth em ("thin space").
+
+   Prefix any words that start with a dot '.' or neutral apostrophe '''
+with '\&' if they are at the beginning of an input line (or might become
+that way in editing) to prevent them from being interpreted as macro
+calls or requests.  Suffix '.', '?', and '!' with '\&' when needed to
+cancel end-of-sentence detection.
+
+     My exposure was \&.5 to \&.6 Sv of neutrons, said Dr.\&
+     Wallace after the criticality incident.
+
+4.6.2 Document Structure
+------------------------
+
+The 'ms' macro package expects a certain amount of structure: a
+well-formed document contains at least one paragraphing or heading macro
+call.  Longer documents have a structure as follows.
+
+*Document type*
+     Calling the 'RP' macro at the beginning of your document puts the
+     document description (see below) on a cover page.  Otherwise, 'ms'
+     places the information (if any) on the first page, followed
+     immediately by the body text.  Some document types found in other
+     'ms' implementations are specific to AT&T or Berkeley, and are not
+     supported by 'groff' 'ms'.
+
+*Format and layout*
+     By setting registers and strings, you can configure your document's
+     typeface, margins, spacing, headers and footers, and footnote
+     arrangement.  *Note ms Document Control Settings::.
+
+*Document description*
+     A document description consists of any of: a title, one or more
+     authors' names and affiliated institutions, an abstract, and a date
+     or other identifier.  *Note ms Document Description Macros::.
+
+*Body text*
+     The main matter of your document follows its description (if any).
+     'ms' supports highly structured text consisting of paragraphs
+     interspersed with multi-level headings (chapters, sections,
+     subsections, and so forth) and augmented by lists, footnotes,
+     tables, diagrams, and similar material.  *Note ms Body Text::.
+
+*Tables of contents*
+     Macros enable the collection of entries for a table of contents (or
+     index) as the material they discuss appears in the document.  You
+     then call a macro to emit the table of contents at the end of your
+     document.  The table of contents must necessarily follow the rest
+     of the text since GNU 'troff' is a single-pass formatter; it thus
+     cannot determine the page number of a division of the text until it
+     has been set and output.  Since 'ms' was designed for the
+     production of hard copy, the traditional procedure was to manually
+     relocate the pages containing the table of contents between the
+     cover page and the body text.  Today, page resequencing is more
+     often done in the digital domain.  An index works similarly, but
+     because it typically needs to be sorted after collection, its
+     preparation requires separate processing.
+
+4.6.3 Document Control Settings
+-------------------------------
+
+'ms' exposes many aspects of document layout to user control via 'groff'
+requests.  To use them, you must understand how to define registers and
+strings.
+
+ -- Request: .nr reg value
+     Set register REG to VALUE.  If REG doesn't exist, GNU 'troff'
+     creates it.
+
+ -- Request: .ds name contents
+     Set string NAME to CONTENTS.
+
+   A list of document control registers and strings follows.  For any
+parameter whose default is unsatisfactory, define its register or string
+before calling any 'ms' macro other than 'RP'.
+
+Margin settings
+...............
+
+ -- Register: \nPO
+     Defines the page offset (i.e., the left margin).
+
+     Effective: next page.
+
+     Default: Varies by output device and paper format; 1i is used for
+     typesetters using U.S. letter paper, and zero for terminals.  *Note
+     Paper Format::.
+
+ -- Register: \nLL
+     Defines the line length (i.e., the width of the body text).
+
+     Effective: next paragraph.
+
+     Default: Varies by output device and paper format; 6.5i is used for
+     typesetters using U.S. letter paper (*note Paper Format::) and 65n
+     on terminals.
+
+ -- Register: \nLT
+     Defines the title line length (i.e., the header and footer width).
+     This is usually the same as 'LL', but need not be.
+
+     Effective: next paragraph.
+
+     Default: Varies by output device and paper format; 6.5i is used for
+     typesetters using U.S. letter paper (*note Paper Format::) and 65n
+     on terminals.
+
+ -- Register: \nHM
+     Defines the header margin height at the top of the page.
+
+     Effective: next page.
+
+     Default: 1i.
+
+ -- Register: \nFM
+     Defines the footer margin height at the bottom of the page.
+
+     Effective: next page.
+
+     Default: 1i.
+
+Titles (headers, footers)
+.........................
+
+ -- String: \*LH
+     Defines the text displayed in the left header position.
+
+     Effective: next header.
+
+     Default: empty.
+
+ -- String: \*CH
+     Defines the text displayed in the center header position.
+
+     Effective: next header.
+
+     Default: '-\n%-'.
+
+ -- String: \*RH
+     Defines the text displayed in the right header position.
+
+     Effective: next header.
+
+     Default: empty.
+
+ -- String: \*LF
+     Defines the text displayed in the left footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+ -- String: \*CF
+     Defines the text displayed in the center footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+ -- String: \*RF
+     Defines the text displayed in the right footer position.
+
+     Effective: next footer.
+
+     Default: empty.
+
+Text settings
+.............
+
+ -- Register: \nPS
+     Defines the type size of the body text.
+
+     Effective: next paragraph.
+
+     Default: 10p.
+
+ -- Register: \nVS
+     Defines the vertical spacing (type size plus leading).
+
+     Effective: next paragraph.
+
+     Default: 12p.
+
+ -- Register: \nHY
+     Defines the automatic hyphenation mode used with the 'hy' request.
+     Setting 'HY' to 0 is equivalent to using the 'nh' request.  This is
+     a Tenth Edition Research Unix extension.
+
+     Effective: next paragraph.
+
+     Default: 6.
+
+ -- String: \*FAM
+     Defines the font family used to typeset the document.  This is a
+     GNU extension.
+
+     Effective: next paragraph.
+
+     Default: defined by the output device; often 'T' (*note ms Body
+     Text::)
+
+Paragraph settings
+..................
+
+ -- Register: \nPI
+     Defines the indentation amount used by the 'PP', 'IP' (unless
+     overridden by an optional argument), 'XP', and 'RS' macros.
+
+     Effective: next paragraph.
+
+     Default: 5n.
+
+ -- Register: \nPD
+     Defines the space between paragraphs.
+
+     Effective: next paragraph.
+
+     Default: 0.3v (1v on low-resolution devices).
+
+ -- Register: \nQI
+     Defines the indentation amount used on both sides of a paragraph
+     set with the 'QP' or between the 'QS' and 'QE' macros.
+
+     Effective: next paragraph.
+
+     Default: 5n.
+
+ -- Register: \nPORPHANS
+     Defines the minimum number of initial lines of any paragraph that
+     must be kept together to avoid isolated lines at the bottom of a
+     page.  If a new paragraph is started close to the bottom of a page,
+     and there is insufficient space to accommodate 'PORPHANS' lines
+     before an automatic page break, then a page break is forced before
+     the start of the paragraph.  This is a GNU extension.
+
+     Effective: next paragraph.
+
+     Default: 1.
+
+Heading settings
+................
+
+ -- Register: \nPSINCR
+     Defines an increment in type size to be applied to a heading at a
+     lesser depth than that specified in 'GROWPS'.  The value of
+     'PSINCR' should be specified in points with the p scaling unit and
+     may include a fractional component; for example, '.nr PSINCR 1.5p'
+     sets a type size increment of 1.5p.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: 1p.
+
+ -- Register: \nGROWPS
+     Defines the heading depth above which the type size increment set
+     by 'PSINCR' becomes effective.  For each heading depth less than
+     the value of 'GROWPS', the type size is increased by 'PSINCR'.
+     Setting 'GROWPS' to any value less than 2 disables the incremental
+     heading size feature.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: 0.
+
+ -- Register: \nHORPHANS
+     Defines the minimum number of lines of an immediately succeeding
+     paragraph that should be kept together with any heading introduced
+     by the 'NH' or 'SH' macros.  If a heading is placed close to the
+     bottom of a page, and there is insufficient space to accommodate
+     both the heading and at least 'HORPHANS' lines of the following
+     paragraph, before an automatic page break, then the page break is
+     forced before the heading.  This is a GNU extension.
+
+     Effective: next paragraph.
+
+     Default: 1.
+
+ -- String: \*SN-STYLE
+     Defines the style used to print numbered headings.  *Note Headings
+     in ms::.  This is a GNU extension.
+
+     Effective: next heading.
+
+     Default: alias of 'SN-DOT'
+
+Footnote settings
+.................
+
+ -- Register: \nFI
+     Defines the footnote indentation.  This is a Berkeley extension.
+
+     Effective: next footnote.
+
+     Default: 2n.
+
+ -- Register: \nFF
+     Defines the format of automatically numbered footnotes, and those
+     for which the 'FS' request is given a marker argument, at the
+     bottom of a column or page.  This is a Berkeley extension.
+     '0'
+          Set an automatic number(1) (*note ms Document Control
+          Settings-Footnote-1::) as a superscript (on typesetter
+          devices) or surrounded by square brackets (on terminals).  The
+          footnote paragraph is indented as with 'PP' if there is an
+          'FS' argument or an automatic number, and as with 'LP'
+          otherwise.  This is the default.
+
+     '1'
+          As '0', but set the marker as regular text and follow an
+          automatic number with a period.
+
+     '2'
+          As '1', but without indentation (like 'LP').
+
+     '3'
+          As '1', but set the footnote paragraph with the marker hanging
+          (like 'IP').
+
+     Effective: next footnote.
+
+     Default: 0.
+
+ -- Register: \nFPS
+     Defines the footnote type size.
+
+     Effective: next footnote.
+
+     Default: '\nPS - 2p'.
+
+ -- Register: \nFVS
+     Defines the footnote vertical spacing.
+
+     Effective: next footnote.
+
+     Default: '\nFPS + 2p'.
+
+ -- Register: \nFPD
+     Defines the footnote paragraph spacing.  This is a GNU extension.
+
+     Effective: next footnote.
+
+     Default: '\nPD / 2'.
+
+ -- String: \*FR
+     Defines the ratio of the footnote line length to the current line
+     length.  This is a GNU extension.
+
+     Effective: next footnote in single-column arrangements, next page
+     otherwise.
+
+     Default: '11/12'.
+
+Display settings
+................
+
+ -- Register: \nDD
+     Sets the display distance--the vertical spacing before and after a
+     display, a 'tbl' table, an 'eqn' equation, or a 'pic' image.  This
+     is a Berkeley extension.
+
+     Effective: next display boundary.
+
+     Default: 0.5v (1v on low-resolution devices).
+
+ -- Register: \nDI
+     Sets the default amount by which to indent a display started with
+     'DS' and 'ID' without arguments, to '.DS I' without an indentation
+     argument, and to equations set with '.EQ I'.  This is a GNU
+     extension.
+
+     Effective: next indented display.
+
+     Default: 0.5i.
+
+Other settings
+..............
+
+ -- Register: \nMINGW
+     Defines the default minimum width between columns in a multi-column
+     document.  This is a GNU extension.
+
+     Effective: next page.
+
+     Default: 2n.
+
+ -- Register: \nTC-MARGIN
+     Defines the width of the field in which page numbers are set in a
+     table of contents entry; the right margin thus moves inboard by
+     this amount.  This is a GNU extension.
+
+     Effective: next 'PX' call.
+
+     Default: '\w'000''
+
+   (1) defined in *note ms Footnotes::
+
+4.6.4 Document Description Macros
+---------------------------------
+
+Only the simplest document lacks a title.(1)  (*note ms Document
+Description Macros-Footnote-1::) As its level of sophistication (or
+complexity) increases, it tends to acquire a date of revision,
+explicitly identified authors, sponsoring institutions for authors, and,
+at the rarefied heights, an abstract of its content.  Define these data
+by calling the macros below in the order shown; 'DA' or 'ND' can be
+called to set the document date (or other identifier) at any time before
+(a) the abstract, if present, or (b) its information is required in a
+header or footer.  Use of these macros is optional, except that 'TL' is
+mandatory if any of 'RP', 'AU', 'AI', or 'AB' is called, and 'AE' is
+mandatory if 'AB' is called.
+
+ -- Macro: .RP no-repeat-info no-renumber
+     Use the "report" (AT&T: "released paper") format for your document,
+     creating a separate cover page.  The default arrangement is to
+     place most of the document description (title, author names and
+     institutions, and abstract, but not the date) at the top of the
+     first page.  If the optional 'no-repeat-info' argument is given,
+     'ms' produces a cover page but does not repeat any of its
+     information subsequently (but see the 'DA' macro below regarding
+     the date).  Normally, 'RP' sets the page number following the cover
+     page to 1.  Specifying the optional 'no-renumber' argument
+     suppresses this alteration.  Optional arguments can occur in any
+     order.  'no' is recognized as a synonym of 'no-repeat-info' for
+     'AT&T' compatibility.
+
+ -- Macro: .TL
+     Specify the document title.  'ms' collects text on input lines
+     following this call into the title until reaching 'AU', 'AB', or a
+     heading or paragraphing macro call.
+
+ -- Macro: .AU
+     Specify an author's name.  'ms' collects text on input lines
+     following this call into the author's name until reaching 'AI',
+     'AB', another 'AU', or a heading or paragraphing macro call.  Call
+     it repeatedly to specify multiple authors.
+
+ -- Macro: .AI
+     Specify the preceding author's institution.  An 'AU' call is
+     usefully followed by at most one 'AI' call; if there are more, the
+     last 'AI' call controls.  'ms' collects text on input lines
+     following this call into the author's institution until reaching
+     'AU', 'AB', or a heading or paragraphing macro call.
+
+ -- Macro: .DA x ...
+     Typeset the current date, or any arguments X, in the center footer,
+     and, if 'RP' is also called, left-aligned at the end of the
+     description information on the cover page.
+
+ -- Macro: .ND x ...
+     Typeset the current date, or any arguments X, if 'RP' is also
+     called, left-aligned at the end of the document description on the
+     cover page.  This is 'groff' 'ms''s default.
+
+ -- Macro: .AB no
+     Begin the abstract.  'ms' collects text on input lines following
+     this call into the abstract until reaching an 'AE' call.  By
+     default, 'ms' places the word "ABSTRACT" centered and in italics
+     above the text of the abstract.  The optional argument 'no'
+     suppresses this heading.
+
+ -- Macro: .AE
+     End the abstract.
+
+   An example document description, using a cover page, follows.
+
+     .RP
+     .TL
+     The Inevitability of Code Bloat
+     in Commercial and Free Software
+     .AU
+     J.\& Random Luser
+     .AI
+     University of West Bumblefuzz
+     .AB
+     This report examines the long-term growth of the code
+     bases in two large,
+     popular software packages;
+     the free Emacs and the commercial Microsoft Word.
+     While differences appear in the type or order of
+     features added,
+     due to the different methodologies used,
+     the results are the same in the end.
+     .PP
+     The free software approach is shown to be superior in
+     that while free software can become as bloated as
+     commercial offerings,
+     free software tends to have fewer serious bugs and the
+     added features are more in line with user demand.
+     .AE
+
+     ...the rest of the paper...
+
+   (1) Distinguish a document title from "titles", which are what 'roff'
+systems call headers and footers collectively.
+
+4.6.5 Body Text
+---------------
+
+A variety of macros, registers, and strings can be used to structure and
+style the body of your document.  They organize your text into
+paragraphs, headings, footnotes, and inclusions of material such as
+tables and figures.
+
+4.6.5.1 Text settings
+.....................
+
+The 'FAM' string, a GNU extension, sets the font family for body text;
+the default is 'T'.  The 'PS' and 'VS' registers set the type size and
+vertical spacing (distance between text baselines), respectively.  The
+font family and type size are ignored on terminal devices.  Setting
+these parameters before the first call of a heading, paragraphing, or
+(non-date) document description macro also applies them to headers,
+footers, and (for 'FAM') footnotes.
+
+   Which font families are available depends on the output device; as a
+convention, 'T' selects a serif family ("Times"), 'H' a sans-serif
+family ("Helvetica"), and 'C' a monospaced family ("Courier").  The man
+page for the output driver documents its font repertoire.  Consult the
+'groff(1)' man page for lists of available output devices and their
+drivers.
+
+   The hyphenation mode (as used by the 'hy' request) is set from the
+'HY' register.  Setting 'HY' to '0' is equivalent to using the 'nh'
+request.  This is a Tenth Edition Research Unix extension.
+
+4.6.5.2 Typographical symbols
+.............................
+
+'ms' provides a few strings to obtain typographical symbols not easily
+entered with the keyboard.  These and many others are available as
+special character escape sequences--see the 'groff_char(7)' man page.
+
+ -- String: \*-
+     Interpolate an em dash.
+
+ -- String: \*Q
+ -- String: \*U
+     Interpolate typographer's quotation marks where available, and
+     neutral double quotes otherwise.  '\*Q' is the left quote and '\*U'
+     the right.
+
+4.6.5.3 Paragraphs
+..................
+
+Paragraphing macros "break", or terminate, any pending output line so
+that a new paragraph can begin.  Several paragraph types are available,
+differing in how indentation applies to them: to left, right, or both
+margins; to the first output line of the paragraph, all output lines, or
+all but the first.  All paragraphing macro calls cause the insertion of
+vertical space in the amount stored in the 'PD' register, except at page
+or column breaks.  Alternatively, a blank input line breaks the output
+line and vertically spaces by one vee.
+
+ -- Macro: .LP
+     Set a paragraph without any (additional) indentation.
+
+ -- Macro: .PP
+     Set a paragraph with a first-line left indentation in the amount
+     stored in the 'PI' register.
+
+ -- Macro: .IP marker width
+     Set a paragraph with a left indentation.  The optional MARKER is
+     not indented and is empty by default.  It has several applications;
+     see *note Lists in ms::.  WIDTH overrides the indentation amount
+     stored in the 'PI' register; its default unit is 'n'.  Once
+     specified, WIDTH applies to further 'IP' calls until specified
+     again or a heading or different paragraphing macro is called.
+
+ -- Macro: .QP
+     Set a paragraph indented from both left and right margins by the
+     amount stored in the 'QI' register.
+
+ -- Macro: .QS
+ -- Macro: .QE
+     Begin ('QS') and end ('QE') a region where each paragraph is
+     indented from both margins by the amount stored in the 'QI'
+     register.  The text between 'QS' and 'QE' can be structured further
+     by use of other paragraphing macros.
+
+ -- Macro: .XP
+     Set an "exdented" paragraph--one with a left indentation in the
+     amount stored in the 'PI' register on every line _except_ the first
+     (also known as a hanging indent).  This is a Berkeley extension.
+
+   The following example illustrates the use of paragraphing macros.
+
+     .NH 2
+     Cases used in the 2001 study
+     .LP
+     Two software releases were considered for this report.
+     .PP
+     The first is commercial software;
+     the second is free.
+     .IP \bu
+     Microsoft Word for Windows,
+     starting with version 1.0 through the current version
+     (Word 2000).
+     .IP \bu
+     GNU Emacs,
+     from its first appearance as a standalone editor through
+     the current version (v20).
+     See Bloggs 2002 for details.
+     .QP
+     Franklin's Law applied to software:
+     software expands to outgrow both RAM and disk space over
+     time.
+     .SH
+     Bibliography
+     .XP
+     Bloggs, Joseph R.,
+     .I "Everyone's a Critic" ,
+     Underground Press, March 2002.
+     A definitive work that answers all questions and
+     criticisms about the quality and usability of free
+     software.
+
+4.6.5.4 Headings
+................
+
+Use headings to create a sequential or hierarchical structure for your
+document.  The 'ms' macros print headings in *bold* using the same font
+family and, by default, type size as the body text.  Headings are
+available with and without automatic numbering.  Text on input lines
+following the macro call becomes the heading's title.  Call a
+paragraphing macro to end the heading text and start the section's
+content.
+
+ -- Macro: .NH depth
+ -- Macro: .NH S heading-depth-index ...
+     Set an automatically numbered heading.
+
+     'ms' produces a numbered heading the form A.B.C..., to any depth
+     desired, with the numbering of each depth increasing automatically
+     and being reset to zero when a more significant level is increased.
+     "1" is the most significant or coarsest division of the document.
+     Only non-zero values are output.  If DEPTH is omitted, it is taken
+     to be '1'.
+
+     If you specify DEPTH such that an ascending gap occurs relative to
+     the previous 'NH' call--that is, you "skip a depth", as by '.NH 1'
+     and then '.NH 3'--'groff' 'ms' emits a warning on the standard
+     error stream.
+
+     Alternatively, you can give 'NH' a first argument of 'S', followed
+     by integers to number the heading depths explicitly.  Further
+     automatic numbering, if used, resumes using the specified indices
+     as their predecessors.  This feature is a Berkeley extension.
+
+   An example may be illustrative.
+
+     .NH 1
+     Animalia
+     .NH 2
+     Arthropoda
+     .NH 3
+     Crustacea
+     .NH 2
+     Chordata
+     .NH S 6 6 6
+     Daimonia
+     .NH 1
+     Plantae
+
+   The above results in numbering as follows; the vertical space that
+normally precedes each heading is omitted.
+
+     1.  Animalia
+     1.1.  Arthropoda
+     1.1.1.  Crustacea
+     1.2.  Chordata
+     6.6.6.  Daimonia
+     7.  Plantae
+
+ -- String: \*SN-STYLE
+ -- String: \*SN-DOT
+ -- String: \*SN-NO-DOT
+ -- String: \*SN
+     After 'NH' is called, the assigned number is made available in the
+     strings 'SN-DOT' (as it appears in a printed heading with default
+     formatting, followed by a terminating period) and 'SN-NO-DOT' (with
+     the terminating period omitted).  These are GNU extensions.
+
+     You can control the style used to print numbered headings by
+     defining an appropriate alias for the string 'SN-STYLE'.  By
+     default, 'SN-STYLE' is aliased to 'SN-DOT'.  If you prefer to omit
+     the terminating period from numbers appearing in numbered headings,
+     you may define the alias as follows.
+
+          .als SN-STYLE SN-NO-DOT
+
+     Any such change in numbering style becomes effective from the next
+     use of 'NH' following redefinition of the alias for 'SN-STYLE'.
+     The formatted number of the current heading is available in the
+     'SN' string (a feature first documented by Berkeley), which
+     facilitates its inclusion in, for example, table captions, equation
+     labels, and 'XS'/'XA'/'XE' table of contents entries.
+
+ -- Macro: .SH depth
+     Set an unnumbered heading.
+
+     The optional DEPTH argument is a GNU extension indicating the
+     heading depth corresponding to the DEPTH argument of 'NH'.  It
+     matches the type size at which the heading is set to that of a
+     numbered heading at the same depth when the 'GROWPS' and 'PSINCR'
+     heading size adjustment mechanism is in effect.
+
+   If the 'GROWPS' register is set to a value greater than the LEVEL
+argument to 'NH' or 'SH', the type size of a heading produced by these
+macros increases by 'PSINCR' units over the size specified by 'PS'
+multiplied by the difference of 'GROWPS' and LEVEL.  The value stored in
+'PSINCR' is interpreted in 'groff' basic units; the 'p' scaling unit
+should be employed when assigning a value specified in points.  For
+example, the sequence
+
+     .nr PS 10
+     .nr GROWPS 3
+     .nr PSINCR 1.5p
+     .NH 1
+     Carnivora
+     .NH 2
+     Felinae
+     .NH 3
+     Felis catus
+     .SH 2
+     Machairodontinae
+
+will cause "1.  Carnivora" to be printed in 13-point text, followed by
+"1.1.  Felinae" in 11.5-point text, while "1.1.1.  Felis catus" and all
+more deeply nested heading levels will remain in the 10-point text
+specified by the 'PS' register.  "Machairodontinae" is printed at 11.5
+points, since it corresponds to heading level 2.
+
+   The 'HORPHANS' register operates in conjunction with the 'NH' and
+'SH' macros to inhibit the printing of isolated headings at the bottom
+of a page; it specifies the minimum number of lines of an immediately
+subsequent paragraph that must be kept on the same page as the heading.
+If insufficient space remains on the current page to accommodate the
+heading and this number of lines of paragraph text, a page break is
+forced before the heading is printed.  Any display macro call or 'tbl',
+'pic', or 'eqn' region between the heading and the subsequent paragraph
+suppresses this grouping.  *Note ms keeps and displays:: and *note ms
+Insertions::.
+
+4.6.5.5 Typeface and decoration
+...............................
+
+The 'ms' macros provide a variety of ways to style text.  Attend closely
+to the ordering of arguments labeled PRE and POST, which is not
+intuitive.  Support for PRE arguments is a GNU extension.(1)  (*note
+Typeface and decoration-Footnote-1::)
+
+ -- Macro: .B text post pre
+     Style TEXT in bold, followed by POST in the previous font style
+     without intervening space, and preceded by PRE similarly.  Without
+     arguments, 'ms' styles subsequent text in bold until the next
+     paragraphing, heading, or no-argument typeface macro call.
+
+ -- Macro: .R text post pre
+     As 'B', but use the roman style (upright text of normal weight)
+     instead of bold.  Argument recognition is a GNU extension.
+
+ -- Macro: .I text post pre
+     As 'B', but use an italic or oblique style instead of bold.
+
+ -- Macro: .BI text post pre
+     As 'B', but use a bold italic or bold oblique style instead of
+     upright bold.  This is a Tenth Edition Research Unix extension.
+
+ -- Macro: .CW text post pre
+     As 'B', but use a constant-width (monospaced) roman typeface
+     instead of bold.  This is a Tenth Edition Research Unix extension.
+
+ -- Macro: .BX text
+     Typeset TEXT and draw a box around it.  On terminal devices,
+     reverse video is used instead.  If you want TEXT to contain space,
+     use unbreakable space or horizontal motion escape sequences ('\~',
+     '\<SP>', '\^', '\|', '\0' or '\h').
+
+ -- Macro: .UL text post
+     Typeset TEXT with an underline.  POST, if present, is set after
+     TEXT with no intervening space.
+
+ -- Macro: .LG
+     Set subsequent text in larger type (two points larger than the
+     current size) until the next type size, paragraphing, or heading
+     macro call.  You can specify this macro multiple times to enlarge
+     the type size as needed.
+
+ -- Macro: .SM
+     Set subsequent text in smaller type (two points smaller than the
+     current size) until the next type size, paragraphing, or heading
+     macro call.  You can specify this macro multiple times to reduce
+     the type size as needed.
+
+ -- Macro: .NL
+     Set subsequent text at the normal type size (the amount in the 'PS'
+     register).
+
+   PRE and POST arguments are typically used to simplify the attachment
+of punctuation to styled words.  When PRE is used, a hyphenation control
+escape sequence '\%' that would ordinarily start TEXT must start PRE
+instead to have the desired effect.
+
+     The CS course's students found one C language keyword
+     .CW static ) \%(
+     most troublesome.
+
+   The foregoing example produces output as follows.
+
+     The CS course's students found one C language keyword (static)
+     most troublesome.
+
+   You can use the output line continuation escape sequence '\c' to
+achieve the same result (*note Line Continuation::).  It is also
+portable to older 'ms' implementations.
+
+     The CS course's students found one C language keyword
+     \%(\c
+     .CW \%static )
+     most troublesome.
+
+   'groff' 'ms' also offers strings to begin and end super- and
+subscripting.  These are GNU extensions.
+
+ -- String: \*{
+ -- String: \*}
+     Begin and end superscripting, respectively.
+
+ -- String: \*<
+ -- String: \*>
+     Begin and end subscripting, respectively.
+
+   Rather than calling the 'CW' macro, in 'groff' 'ms' you might prefer
+to change the font family to Courier by setting the 'FAM' string to 'C'.
+You can then use all four style macros above, returning to the default
+family (Times) with '.ds FAM T'.  Because changes to 'FAM' take effect
+only at the next paragraph, 'CW' remains useful to "inline" a change to
+the font family, similarly to the practice of this document in noting
+syntactical elements of 'ms' and 'groff'.
+
+   (1) This idiosyncrasy arose through feature accretion; for example,
+the 'B' macro in Version 6 Unix 'ms' (1975) accepted only one argument,
+the text to be set in boldface.  By Version 7 (1979) it recognized a
+second argument; in 1990, 'groff' 'ms' added a "pre" argument, placing
+it third to avoid breaking support for older documents.
+
+4.6.5.6 Lists
+.............
+
+The MARKER argument to the 'IP' macro can be employed to present a
+variety of lists; for instance, you can use a bullet glyph ('\bu') for
+unordered lists, a number (or auto-incrementing register) for numbered
+lists, or a word or phrase for glossary-style or definition lists.  If
+you set the paragraph indentation register 'PI' before calling 'IP', you
+can later reorder the items in the list without having to ensure that a
+WIDTH argument remains affixed to the first call.
+
+   The following is an example of a bulleted list.
+
+     .nr PI 2n
+     A bulleted list:
+     .IP \bu
+     lawyers
+     .IP \bu
+     guns
+     .IP \bu
+     money
+
+     A bulleted list:
+
+     * lawyers
+
+     * guns
+
+     * money
+
+   The following is an example of a numbered list.
+
+     .nr step 0 1
+     .nr PI 3n
+     A numbered list:
+     .IP \n+step
+     lawyers
+     .IP \n+step
+     guns
+     .IP \n+step
+     money
+
+     A numbered list:
+
+     1. lawyers
+
+     2. guns
+
+     3. money
+
+   Here we have employed the 'nr' request to create a register of our
+own, 'step'.  We initialized it to zero and assigned it an
+auto-increment of 1.  Each time we use the escape sequence '\n+PI'
+(note the plus sign), the formatter applies the increment just before
+interpolating the register's value.  Preparing the 'PI' register as well
+enables us to rearrange the list without the tedium of updating macro
+calls.
+
+   The next example illustrates a glossary-style list.
+
+     A glossary-style list:
+     .IP lawyers 0.4i
+     Two or more attorneys.
+     .IP guns
+     Firearms,
+     preferably large-caliber.
+     .IP money
+     Gotta pay for those
+     lawyers and guns!
+
+     A glossary-style list:
+
+     lawyers
+           Two or more attorneys.
+
+     guns  Firearms, preferably large-caliber.
+
+     money
+           Gotta pay for those lawyers and guns!
+
+   In the previous example, observe how the 'IP' macro places the
+definition on the same line as the term if it has enough space.  If this
+is not what you want, there are a few workarounds we will illustrate by
+modifying the example.  First, you can use a 'br' request to force a
+break after printing the term or label.
+
+     .IP guns
+     .br
+     Firearms,
+
+   Second, you could apply the '\p' escape sequence to force a break.
+The space following the escape sequence is important; if you omit it,
+'groff' prints the first word of the paragraph text on the same line as
+the term or label (if it fits) _then_ breaks the line.
+
+     .IP guns
+     \p Firearms,
+
+   Finally, you may append a horizontal motion to the marker with the
+'\h' escape sequence; using the same amount as the indentation will
+ensure that the marker is too wide for 'groff' to treat it as "fitting"
+on the same line as the paragraph text.
+
+     .IP guns\h'0.4i'
+     Firearms,
+
+   In each case, the result is the same.
+
+     A glossary-style list:
+
+     lawyers
+           Two or more attorneys.
+
+     guns
+           Firearms, preferably large-caliber.
+
+     money
+           Gotta pay for those lawyers and guns!
+
+4.6.5.7 Indented regions
+........................
+
+You may need to indent a region of text while otherwise formatting it
+normally.  Indented regions can be nested; you can change '\nPI'
+before each call to vary the amount of inset.
+
+ -- Macro: .RS
+     Begin a region where headings, paragraphs, and displays are
+     indented (further) by the amount stored in the 'PI' register.
+
+ -- Macro: .RE
+     End the (next) most recent indented region.
+
+   This feature enables you to easily line up text under hanging and
+indented paragraphs.  For example, you may wish to structure lists
+hierarchically.
+
+     .IP \bu 2
+     Lawyers:
+     .RS
+     .IP \bu
+     Dewey,
+     .IP \bu
+     Cheatham,
+     and
+     .IP \bu
+     and Howe.
+     .RE
+     .IP \bu
+     Guns
+
+     * Lawyers:
+
+       *  Dewey,
+
+       *  Cheatham, and
+
+       *  Howe.
+
+     * Guns
+
+4.6.5.8 Keeps, boxed keeps, and displays
+........................................
+
+On occasion, you may want to "keep" several lines of text, or a region
+of a document, together on a single page, preventing an automatic page
+break within certain boundaries.  This can cause a page break to occur
+earlier than it normally would.  For example, you may want to keep two
+paragraphs together, or a paragraph that refers to a table, list, or
+figure adjacent to the item it discusses.  'ms' provides the 'KS' and
+'KE' macros for this purpose.
+
+   You can alternatively specify a "floating keep": if a keep cannot fit
+on the current page, 'ms' holds its contents and allows material
+following the keep (in the source document) to fill the remainder of the
+current page.  When the page breaks, whether by reaching the end or 'bp'
+request, 'ms' puts the floating keep at the beginning of the next page.
+This is useful for placing large graphics or tables that do not need to
+appear exactly where they occur in the source document.
+
+ -- Macro: .KS
+ -- Macro: .KF
+ -- Macro: .KE
+     'KS' begins a keep, 'KF' a floating keep, and 'KE' ends a keep of
+     either kind.
+
+   As an alternative to the keep mechanism, the 'ne' request forces a
+page break if there is not at least the amount of vertical space
+specified in its argument remaining on the page (*note Page Control::).
+One application of 'ne' is to reserve space on the page for a figure or
+illustration to be included later.
+
+   A "boxed keep" has a frame drawn around it.
+
+ -- Macro: .B1
+ -- Macro: .B2
+     'B1' begins a keep with a box drawn around it.  'B2' ends a boxed
+     keep.
+
+   Boxed keep macros cause breaks; if you need to box a word or phrase
+within a line, see the 'BX' macro in *note Typeface and decoration::.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.  If you wish to box one or more
+paragraphs, you may improve the appearance by calling 'B1' after the
+first paragraphing macro, and by adding a small amount of vertical space
+before calling 'B2'.
+
+     .LP
+     .B1
+     .I Warning:
+     Happy Fun Ball may suddenly accelerate to dangerous
+     speeds.
+     .sp \nPD/2 \" space by half the inter-paragraph distance
+     .B2
+
+   If you want a boxed keep to float, you will need to enclose the 'B1'
+and 'B2' calls within a pair of 'KF' and 'KE' calls.
+
+   "Displays" turn off filling; lines of verse or program code are shown
+with their lines broken as in the source document without requiring 'br'
+requests between lines.  Displays can be kept on a single page or
+allowed to break across pages.  The 'DS' macro begins a kept display of
+the layout specified in its first argument; non-kept displays are begun
+with dedicated macros corresponding to their layout.
+
+ -- Macro: .DS L
+ -- Macro: .LD
+     Begin ('DS': kept) left-aligned display.
+
+ -- Macro: .DS I indent
+ -- Macro: .ID indent
+     Begin ('DS': kept) display indented by INDENT if specified, and by
+     the amount of the 'DI' register otherwise.
+
+ -- Macro: .DS B
+ -- Macro: .BD
+     Begin a ('DS': kept) a block display: the entire display is
+     left-aligned, but indented such that the longest line in the
+     display is centered on the page.
+
+ -- Macro: .DS C
+ -- Macro: .CD
+     Begin a ('DS': kept) centered display: each line in the display is
+     centered.
+
+ -- Macro: .DS R
+ -- Macro: .RD
+     Begin a ('DS': kept) right-aligned display.  This is a GNU
+     extension.
+
+ -- Macro: .DE
+     End any display.
+
+   The distance stored in the 'DD' register is inserted before and after
+each pair of display macros; this is a Berkeley extension.  In 'groff'
+'ms', this distance replaces any adjacent inter-paragraph distance or
+subsequent spacing prior to a section heading.  The 'DI' register is a
+GNU extension; its value is an indentation applied to displays created
+with '.DS' and '.ID' without arguments, to '.DS I' without an
+indentation argument, and to indented equations set with '.EQ'.  Changes
+to either register take effect at the next display boundary.
+
+4.6.5.9 Tables, figures, equations, and references
+..................................................
+
+The 'ms' package is often used with the 'tbl', 'pic', 'eqn', and 'refer'
+preprocessors.  Mark text meant for preprocessors by enclosing it in
+pairs of tokens as follows, with nothing between the dot and the macro
+name.  The preprocessors match these tokens only at the start of an
+input line.
+
+ -- Macro: .TS H
+ -- Macro: .TE
+     Demarcate a table to be processed by the 'tbl' preprocessor.  The
+     optional argument 'H' to 'TS' instructs 'ms' to repeat table rows
+     (often column headings) at the top of each new page the table
+     spans, if applicable; calling the 'TH' macro marks the end of such
+     rows.  The GNU 'tbl(1)' man page provides a comprehensive reference
+     to the preprocessor and offers examples of its use.
+
+ -- Macro: .PS
+ -- Macro: .PE
+ -- Macro: .PF
+     'PS' begins a picture to be processed by the 'gpic' preprocessor;
+     either of 'PE' or 'PF' ends it, the latter with "flyback" to the
+     vertical position at its top.  You can create 'pic' input manually
+     or with a program such as 'xfig'.
+
+ -- Macro: .EQ align label
+ -- Macro: .EN
+     Demarcate an equation to be processed by the 'eqn' preprocessor.
+     The equation is centered by default; ALIGN can be 'C', 'L', or 'I'
+     to (explicitly) center, left-align, or indent it by the amount
+     stored in the 'DI' register, respectively.  If specified, LABEL is
+     set right-aligned.
+
+ -- Macro: .
+ -- Macro: .
+     Demarcate a bibliographic citation to be processed by the 'refer'
+     preprocessor.  The GNU 'refer(1)' man page provides a comprehensive
+     reference to the preprocessor and the format of its bibliographic
+     database.  Type 'man refer' at the command line to view it.
+
+   When 'refer' emits collected references (as might be done on a "Works
+Cited" page), it interpolates the 'REFERENCES' string as an unnumbered
+heading ('SH').
+
+   The following is an example of how to set up a table that may print
+across two or more pages.
+
+     .TS H
+     allbox;
+     Cb | Cb .
+     Part->Description
+     _
+     .TH
+     .T&
+     GH-1978->Fribulating gonkulator
+     ...the rest of the table follows...
+     .TE
+
+Attempting to place a multi-page table inside a keep can lead to
+unpleasant results, particularly if the 'tbl' 'allbox' option is used.
+
+   Mathematics can be typeset using the language of the 'eqn'
+preprocessor.
+
+     .EQ C (\*SN-NO-DOTa)
+     p ~ = ~ q sqrt { ( 1 + ~ ( x / q sup 2 ) }
+     .EN
+
+This input formats a labelled equation.  We used the 'SN-NO-DOT' string
+to base the equation label on the current heading number, giving us more
+flexibility to reorganize the document.
+
+   Use 'groff' options to run preprocessors on the input: '-e' for
+'geqn', '-p' for 'gpic', '-R' for 'grefer', and '-t' for 'gtbl'.
+
+4.6.5.10 Footnotes
+..................
+
+A footnote is typically anchored to a place in the text with a "marker",
+which is a small integer, a symbol such as a dagger, or arbitrary
+user-specified text.
+
+ -- String: \**
+     Place an "automatic number", an automatically generated numeric
+     footnote marker, in the text.  Each time this string is
+     interpolated, the number it produces increments by one.  Automatic
+     numbers start at 1.  This is a Berkeley extension.
+
+   Enclose the footnote text in 'FS' and 'FE' macro calls to set it at
+the nearest available "foot", or bottom, of a text column or page.
+
+ -- Macro: .FS marker
+ -- Macro: .FE
+     Begin ('FS') and end ('FE') a footnote.  'FS' calls 'FS-MARK' with
+     any supplied MARKER argument, which is then also placed at the
+     beginning of the footnote text.  If MARKER is omitted, the next
+     pending automatic footnote number enqueued by interpolation of the
+     '*' string is used, and if none exists, nothing is prefixed.
+
+   You may not desire automatically numbered footnotes in spite of their
+convenience.  You can indicate a footnote with a symbol or other text by
+specifying its marker at the appropriate place (for example, by using
+'\dg' for the dagger glyph) _and_ as an argument to the 'FS' macro.
+Such manual marks should be repeated as arguments to 'FS' or as part of
+the footnote text to disambiguate their correspondence.  You may wish to
+use '\*{' and '\*}' to superscript the marker at the anchor point, in
+the footnote text, or both.
+
+   'groff' 'ms' provides a hook macro, 'FS-MARK', for user-determined
+operations to be performed when the 'FS' macro is called.  It is passed
+the same arguments as 'FS' itself.  An application of 'FS-MARK' is
+anchor placement for a hyperlink reference, so that a footnote can link
+back to its referential context.(1)  (*note ms Footnotes-Footnote-1::)
+By default, this macro has an empty definition.  'FS-MARK' is a GNU
+extension.
+
+   Footnotes can be safely used within keeps and displays, but you
+should avoid using automatically numbered footnotes within floating
+keeps.  You can place a second '\**' interpolation between a '\**' and
+its corresponding 'FS' call as long as each 'FS' call occurs _after_ the
+corresponding '\**' and occurrences of 'FS' are in the same order as
+corresponding occurrences of '\**'.
+
+   Footnote text is formatted as paragraphs are, using analogous
+parameters.  The registers 'FI', 'FPD', 'FPS', and 'FVS' correspond to
+'PI', 'PD', 'PS', and 'CS', respectively; 'FPD', 'FPS', and 'FVS' are
+GNU extensions.
+
+   The 'FF' register controls the formatting of automatically numbered
+footnote paragraphs and those for which 'FS' is given a marker argument.
+*Note ms Document Control Settings::.
+
+   The default footnote line length is 11/12ths of the normal line
+length for compatibility with the expectations of historical 'ms'
+documents; you may wish to set the 'FR' string to '1' to align with
+contemporary typesetting practices.  In the past,(2) (*note ms
+Footnotes-Footnote-2::) an 'FL' register was used for the line length in
+footnotes; however, setting this register at document initialization
+time had no effect on the footnote line length in multi-column
+arrangements.(3)  (*note ms Footnotes-Footnote-3::)
+
+   'FR' should be used in preference to the old 'FL' register in
+contemporary documents.  The footnote line length is effectively
+computed as 'column-width * \*FR'.  If an absolute footnote line
+length is required, recall that arithmetic expressions in 'roff' input
+are evaluated strictly from left to right, with no operator precedence
+(parentheses are honored).
+
+     .ds FR 0+3i \" Set footnote line length to 3 inches.
+
+   (1) "Portable Document Format Publishing with GNU Troff",
+'pdfmark.ms' in the 'groff' distribution, uses this technique.
+
+   (2) Unix Version 7 'ms', its descendants, and GNU 'ms' prior to
+'groff' version 1.23.0
+
+   (3) You could reset it after each call to '.1C', '.2C', or '.MC'.
+
+4.6.5.11 Language and localization
+..................................
+
+'groff' 'ms' provides several strings that you can customize for your
+own purposes, or redefine to adapt the macro package to languages other
+than English.  It is already localized for Czech, German, French,
+Italian, and Swedish.  Load the desired localization macro package after
+'ms'; see the 'groff_tmac(5)' man page.
+
+     $ groff -ms -mfr bienvenue.ms
+
+   The following strings are available.
+
+ -- String: \*REFERENCES
+     Contains the string printed at the beginning of a references
+     (bibliography) page produced with GNU 'refer(1)'.  The default is
+     'References'.
+
+ -- String: \*ABSTRACT
+     Contains the string printed at the beginning of the abstract.  The
+     default is '\fIABSTRACT\f'; it includes font selection escape
+     sequences to set the word in italics.
+
+ -- String: \*TOC
+     Contains the string printed at the beginning of the table of
+     contents.  The default is 'Table of Contents'.
+
+ -- String: \*MONTH1
+ -- String: \*MONTH2
+ -- String: \*MONTH3
+ -- String: \*MONTH4
+ -- String: \*MONTH5
+ -- String: \*MONTH6
+ -- String: \*MONTH7
+ -- String: \*MONTH8
+ -- String: \*MONTH9
+ -- String: \*MONTH10
+ -- String: \*MONTH11
+ -- String: \*MONTH12
+     Contain the full names of the calendar months.  The defaults are in
+     English: 'January', 'February', and so on.
+
+4.6.6 Page layout
+-----------------
+
+'ms''s default page layout arranges text in a single column with the
+page number between hyphens centered in a header on each page except the
+first, and produces no footers.  You can customize this arrangement.
+
+4.6.6.1 Headers and footers
+...........................
+
+There are multiple ways to produce headers and footers.  One is to
+define the strings 'LH', 'CH', and 'RH' to set the left, center, and
+right headers, respectively; and 'LF', 'CF', and 'RF' to set the left,
+center, and right footers.  This approach suffices for documents that do
+not distinguish odd- and even-numbered pages.
+
+   Another method is to call macros that set headers or footers for odd-
+or even-numbered pages.  Each such macro takes a delimited argument
+separating the left, center, and right header or footer texts from each
+other.  You can replace the neutral apostrophes (''') shown below with
+any character not appearing in the header or footer text.  These macros
+are Berkeley extensions.
+
+ -- Macro: .OH 'left'center'right'
+ -- Macro: .EH 'left'center'right'
+ -- Macro: .OF 'left'center'right'
+ -- Macro: .EF 'left'center'right'
+     The 'OH' and 'EH' macros define headers for odd- (recto) and
+     even-numbered (verso) pages, respectively; the 'OF' and 'EF' macros
+     define footers for them.
+
+   With either method, a percent sign '%' in header or footer text is
+replaced by the current page number.  By default, 'ms' places no header
+on a page numbered "1" (regardless of its number format).
+
+ -- Macro: .P1
+     Typeset the header even on page 1.  To be effective, this macro
+     must be called before the header trap is sprung on any page
+     numbered "1"; in practice, unless your page numbering is unusual,
+     this means that you should call it early, before 'TL' or any
+     heading or paragraphing macro.  This is a Berkeley extension.
+
+   For even greater flexibility, 'ms' is designed to permit the
+redefinition of the macros that are called when the 'groff' traps that
+ordinarily cause the headers and footers to be output are sprung.  'PT'
+("page trap") is called by 'ms' when the header is to be written, and
+'BT' ("bottom trap") when the footer is to be.  The 'groff' page
+location trap that 'ms' sets up to format the header also calls the
+(normally undefined) 'HD' macro after 'PT'; you can define 'HD' if you
+need additional processing after setting the header (for example, to
+draw a line below it).  The 'HD' hook is a Berkeley extension.  Any such
+macros you (re)define must implement any desired specialization for
+odd-, even-, or first numbered pages.
+
+4.6.6.2 Tab stops
+.................
+
+Use the 'ta' request to define tab stops as needed.  *Note Tabs and
+Fields::.
+
+ -- Macro: .TA
+     Reset the tab stops to the 'ms' default (every 5 ens).  Redefine
+     this macro to create a different set of default tab stops.
+
+4.6.6.3 Margins
+...............
+
+Control margins using the registers summarized in "Margin settings" in
+*note ms Document Control Settings:: above.  There is no setting for the
+right margin; the combination of page offset '\nPO' and line length
+'\nLL' determines it.
+
+4.6.6.4 Multiple columns
+........................
+
+'ms' can set text in as many columns as reasonably fit on the page.  The
+following macros force a page break if a multi-column layout is active
+when they are called.  The 'MINGW' register stores the default minimum
+gutter width; it is a GNU extension.  When multiple columns are in use,
+keeps and the 'HORPHANS' and 'PORPHANS' registers work with respect to
+column breaks instead of page breaks.
+
+ -- Macro: .1C
+     Arrange page text in a single column (the default).
+
+ -- Macro: .2C
+     Arrange page text in two columns.
+
+ -- Macro: .MC column-width gutter-width
+     Arrange page text in multiple columns.  If you specify no
+     arguments, it is equivalent to the '2C' macro.  Otherwise,
+     COLUMN-WIDTH is the width of each column and GUTTER-WIDTH is the
+     minimum distance between columns.
+
+4.6.6.5 Creating a table of contents
+....................................
+
+Because 'roff' formatters process their input in a single pass, material
+on page 50, for example, cannot influence what appears on page 1--this
+poses a challenge for a table of contents at its traditional location in
+front matter, if you wish to avoid manually maintaining it.  'ms'
+enables the collection of material to be presented in the table of
+contents as it appears, saving its page number along with it, and then
+emitting the collected contents on demand toward the end of the
+document.  The table of contents can then be resequenced to its desired
+location by physically rearranging the pages of a printed document, or
+as part of post-processing--with a 'sed(1)' script to reorder the pages
+in 'troff''s output, with 'pdfjam(1)', or with 'gropdf(1)''s
+'.pdfswitchtopage' feature, for example.
+
+   Define an entry to appear in the table of contents by bracketing its
+text between calls to the 'XS' and 'XE' macros.  A typical application
+is to call them immediately after 'NH' or 'SH' and repeat the heading
+text within them.  The 'XA' macro, used within '.XS'/'.XE' pairs,
+supplements an entry--for instance, when it requires multiple output
+lines, whether because a heading is too long to fit or because style
+dictates that page numbers not be repeated.  You may wish to indent the
+text thus wrapped to correspond to its heading depth; this can be done
+in the entry text by prefixing it with tabs or horizontal motion escape
+sequences, or by providing a second argument to the 'XA' macro.  'XS'
+and 'XA' automatically associate the page number where they are called
+with the text following them, but they accept arguments to override this
+behavior.  At the end of the document, call 'TC' or 'PX' to emit the
+table of contents; 'TC' resets the page number to 'i' (Roman numeral
+one), and then calls 'PX'.  All of these macros are Berkeley extensions.
+
+ -- Macro: .XS page-number
+ -- Macro: .XA page-number indentation
+ -- Macro: .XE
+     Begin, supplement, and end a table of contents entry.  Each entry
+     is associated with PAGE-NUMBER (otherwise the current page number);
+     a PAGE-NUMBER of 'no' prevents a leader and page number from being
+     emitted for that entry.  Use of 'XA' within 'XS'/'XE' is optional;
+     it can be repeated.  If INDENTATION is present, a supplemental
+     entry is indented by that amount; ens are assumed if no unit is
+     indicated.  Text on input lines between 'XS' and 'XE' is stored for
+     later recall by 'PX'.
+
+ -- Macro: .PX no
+     Switch to single-column layout.  Unless 'no' is specified, center
+     and interpolate the 'TOC' string in bold and two points larger than
+     the body text.  Emit the table of contents entries.
+
+ -- Macro: .TC no
+     Set the page number to 1, the page number format to lowercase Roman
+     numerals, and call 'PX' (with a 'no' argument, if present).
+
+   Here's an example of typical 'ms' table of contents preparation.  We
+employ horizontal escape sequences '\h' to indent the entries by
+sectioning depth.
+
+     .NH 1
+     Introduction
+     .XS
+     Introduction
+     .XE
+     ...
+     .NH 2
+     Methodology
+     .XS
+     \h'2n'Methodology
+     .XA
+     \h'4n'Fassbinder's Approach
+     \h'4n'Kahiu's Approach
+     .XE
+     ...
+     .NH 1
+     Findings
+     .XS
+     Findings
+     .XE
+     ...
+     .TC
+
+   The remaining features in this subsubsection are GNU extensions.
+'groff' 'ms' obviates the need to repeat heading text after 'XS' calls.
+Call 'XN' and 'XH' after 'NH' and 'SH', respectively.
+
+ -- Macro: .XN heading-text
+ -- Macro: .XH depth heading-text
+     Format HEADING-TEXT and create a corresponding table of contents
+     entry.  'XN' computes the indentation from the depth of the
+     preceding 'NH' call; 'XH' requires a DEPTH argument to do so.
+
+   'groff' 'ms' encourages customization of table of contents entry
+production.
+
+ -- Macro: .XN-REPLACEMENT heading-text
+ -- Macro: .XH-REPLACEMENT depth heading-text
+     These hook macros implement 'XN' and 'XH', respectively.  They call
+     'XN-INIT' and pass their HEADING-TEXT arguments to 'XH-UPDATE-TOC'.
+
+ -- Macro: .XN-INIT
+ -- Macro: .XH-UPDATE-TOC depth heading-text
+     The 'XN-INIT' hook macro does nothing by default.  'XH-UPDATE-TOC'
+     brackets HEADING-TEXT with 'XS' and 'XE' calls, indenting it by 2
+     ens per level of DEPTH beyond the first.
+
+   We could therefore produce a table of contents similar to that in the
+previous example with fewer macro calls.  (The difference is that this
+input follows the "Approach" entries with leaders and page numbers.)
+
+     .NH 1
+     .XN Introduction
+     ...
+     .NH 2
+     .XN Methodology
+     .XH 3 "Fassbinder's Approach"
+     .XH 3 "Kahiu's Approach"
+     ...
+     .NH 1
+     .XN Findings
+     ...
+
+   To get the section number of the numbered headings into the table of
+contents entries, we might define 'XN-REPLACEMENT' as follows.  (We
+obtain the heading depth from 'groff' 'ms''s internal register 'nh*hl'.)
+
+     .de XN-REPLACEMENT
+     .XN-INIT
+     .XH-UPDATE-TOC \\nnh*hl \\$@
+     \&\\*SN \\$*
+     ..
+
+   You can change the style of the leader that bridges each table of
+contents entry with its page number; define the 'TC-LEADER' special
+character by using the 'char' request.  A typical leader combines the
+dot glyph '.' with a horizontal motion escape sequence to spread the
+dots.  The width of the page number field is stored in the 'TC-MARGIN'
+register.
+
+4.6.7 Differences from AT&T 'ms'
+--------------------------------
+
+The 'groff' 'ms' macros are an independent reimplementation, using no
+AT&T code.  Since they take advantage of the extended features of
+'groff', they cannot be used with AT&T 'troff'.  'groff' 'ms' supports
+features described above as Berkeley and Tenth Edition Research Unix
+extensions, and adds several of its own.
+
+   * The internals of 'groff' 'ms' differ from the internals of AT&T
+     'ms'.  Documents that depend upon implementation details of AT&T
+     'ms' may not format properly with 'groff' 'ms'.  Such details
+     include macros whose function was not documented in the AT&T 'ms'
+     manual.(1)  (*note Differences from AT&T ms-Footnote-1::)
+
+   * The error-handling policy of 'groff' 'ms' is to detect and report
+     errors, rather than to ignore them silently.
+
+   * Tenth Edition Research Unix supported 'P1'/'P2' macros to bracket
+     code examples; 'groff' 'ms' does not.
+
+   * 'groff' 'ms' does not work in GNU 'troff''s AT&T compatibility
+     mode.  If loaded when that mode is enabled, it aborts processing
+     with a diagnostic message.
+
+   * Multiple line spacing is not supported.  Use a larger vertical
+     spacing instead.
+
+   * 'groff' 'ms' uses the same header and footer defaults in both
+     'nroff' and 'troff' modes as AT&T 'ms' does in 'troff' mode; AT&T's
+     default in 'nroff' mode is to put the date, in U.S. traditional
+     format (e.g., "January 1, 2021"), in the center footer (the 'CF'
+     string).
+
+   * Many 'groff' 'ms' macros, including those for paragraphs, headings,
+     and displays, cause a reset of paragraph rendering parameters, and
+     may change the indentation; they do so not by incrementing or
+     decrementing it, but by setting it absolutely.  This can cause
+     problems for documents that define additional macros of their own
+     that try to manipulate indentation.  Use the 'ms' 'RS' and 'RE'
+     macros instead of the 'in' request.
+
+   * AT&T 'ms' interpreted the values of the registers 'PS' and 'VS' in
+     points, and did not support the use of scaling units with them.
+     'groff' 'ms' interprets values of the registers 'PS', 'VS', 'FPS',
+     and 'FVS' equal to or larger than 1,000 (one thousand) as decimal
+     fractions multiplied by 1,000.(2)  (*note Differences from AT&T
+     ms-Footnote-2::) This threshold makes use of a scaling unit with
+     these parameters practical for high-resolution devices while
+     preserving backward compatibility.  It also permits expression of
+     non-integral type sizes.  For example, 'groff -rPS=10.5p' at the
+     shell prompt is equivalent to placing '.nr PS 10.5p' at the
+     beginning of the document.
+
+   * AT&T 'ms''s 'AU' macro supported arguments used with some document
+     types; 'groff' 'ms' does not.
+
+   * Right-aligned displays are available.  The AT&T 'ms' manual
+     observes that "it is tempting to assume that '.DS R' will right
+     adjust lines, but it doesn't work".  In 'groff' 'ms', it does.
+
+   * To make 'groff' 'ms' use the default page offset (which also
+     specifies the left margin), the 'PO' register must stay undefined
+     until the first 'ms' macro is called.
+
+     This implies that '\nPO' should not be used early in the
+     document, unless it is changed also: accessing an undefined
+     register automatically defines it.
+
+   * 'groff' 'ms' supports the 'PN' register, but it is not necessary;
+     you can access the page number via the usual '%' register and
+     invoke the 'af' request to assign a different format to it if
+     desired.(3)  (*note Differences from AT&T ms-Footnote-3::)
+
+   * The AT&T 'ms' manual documents registers 'CW' and 'GW' as setting
+     the default column width and "intercolumn gap", respectively, and
+     which applied when 'MC' was called with fewer than two arguments.
+     'groff' 'ms' instead treats 'MC' without arguments as synonymous
+     with '2C'; there is thus no occasion for a default column width
+     register.  Further, the 'MINGW' register and the second argument to
+     'MC' specify a _minimum_ space between columns, not the fixed
+     gutter width of AT&T 'ms'.
+
+   * The AT&T 'ms' manual did not document the 'QI' register; Berkeley
+     and 'groff' 'ms' do.
+
+ -- Register: \nGS
+     The register 'GS' is set to 1 by the 'groff' 'ms' macros, but is
+     not used by the AT&T 'ms' package.  Documents that need to
+     determine whether they are being formatted with 'groff' 'ms' or
+     another implementation should test this register.
+
+   (1) 'Typing Documents on the UNIX System: Using the -ms Macros with
+Troff and Nroff', M. E. Lesk, Bell Laboratories, 1978
+
+   (2) Register values are converted to and stored as basic units.
+*Note Measurements::.
+
+   (3) If you redefine the 'ms' 'PT' macro and desire special treatment
+of certain page numbers (like '1'), you may need to handle a non-Arabic
+page number format, as 'groff' 'ms''s 'PT' does; see the macro package
+source.  'groff' 'ms' aliases the 'PN' register to '%'.
+
+4.6.7.1 Unix Version 7 'ms' macros not implemented by 'groff' 'ms'
+..................................................................
+
+Several macros described in the Unix Version 7 'ms' documentation are
+unimplemented by 'groff' 'ms' because they are specific to the
+requirements of documents produced internally by Bell Laboratories, some
+of which also require a glyph for the Bell System logo that 'groff' does
+not support.  These macros implemented several document type formats
+('EG', 'IM', 'MF', 'MR', 'TM', 'TR'), were meaningful only in
+conjunction with the use of certain document types ('AT', 'CS', 'CT',
+'OK', 'SG'), stored the postal addresses of Bell Labs sites ('HO', 'IH',
+'MH', 'PY', 'WH'), or lacked a stable definition over time ('UX').  To
+compatibly render historical 'ms' documents using these macros, we
+advise your documents to invoke the 'rm' request to remove any such
+macros it uses and then define replacements with an authentically
+typeset original at hand.(1)  (*note Missing Unix Version 7 ms
+Macros-Footnote-1::) For informal purposes, a simple definition of 'UX'
+should maintain the readability of the document's substance.
+
+     .rm UX
+     .ds UX Unix\"
+
+   (1) The removal beforehand is necessary because 'groff' 'ms' aliases
+these macros to a diagnostic macro, and you want to redefine the aliased
+name, not its target.
+
+4.6.8 Legacy Features
+---------------------
+
+'groff' 'ms' retains some legacy features solely to support formatting
+of historical documents; contemporary ones should not use them because
+they can render poorly.  See the 'groff_char(7)' man page.
+
+AT&T accent mark strings
+........................
+
+AT&T 'ms' defined accent mark strings as follows.
+
+ -- String: \*'
+     Apply acute accent to subsequent glyph.
+
+ -- String: \*`
+     Apply grave accent to subsequent glyph.
+
+ -- String: \*:
+     Apply dieresis (umlaut) to subsequent glyph.
+
+ -- String: \*^
+     Apply circumflex accent to subsequent glyph.
+
+ -- String: \*~
+     Apply tilde accent to subsequent glyph.
+
+ -- String: \*C
+     Apply caron to subsequent glyph.
+
+ -- String: \*,
+     Apply cedilla to subsequent glyph.
+
+Berkeley accent mark and glyph strings
+......................................
+
+Berkeley 'ms' offered an 'AM' macro; calling it redefined the AT&T
+accent mark strings (except for '\*C'), applied them to the _preceding_
+glyph, and defined additional strings, some for spacing glyphs.
+
+ -- Macro: .AM
+     Enable alternative accent mark and glyph-producing strings.
+
+ -- String: \*'
+     Apply acute accent to preceding glyph.
+
+ -- String: \*`
+     Apply grave accent to preceding glyph.
+
+ -- String: \*:
+     Apply dieresis (umlaut) to preceding glyph.
+
+ -- String: \*^
+     Apply circumflex accent to preceding glyph.
+
+ -- String: \*~
+     Apply tilde accent to preceding glyph.
+
+ -- String: \*,
+     Apply cedilla to preceding glyph.
+
+ -- String: \*/
+     Apply stroke (slash) to preceding glyph.
+
+ -- String: \*v
+     Apply caron to preceding glyph.
+
+ -- String: \*_
+     Apply macron to preceding glyph.
+
+ -- String: \*.
+     Apply underdot to preceding glyph.
+
+ -- String: \*o
+     Apply ring accent to preceding glyph.
+
+ -- String: \*?
+     Interpolate inverted question mark.
+
+ -- String: \*!
+     Interpolate inverted exclamation mark.
+
+ -- String: \*8
+     Interpolate small letter sharp s.
+
+ -- String: \*q
+     Interpolate small letter o with hook accent (ogonek).
+
+ -- String: \*3
+     Interpolate small letter yogh.
+
+ -- String: \*d-
+     Interpolate small letter eth.
+
+ -- String: \*D-
+     Interpolate capital letter eth.
+
+ -- String: \*th
+     Interpolate small letter thorn.
+
+ -- String: \*Th
+     Interpolate capital letter thorn.
+
+ -- String: \*ae
+     Interpolate small æ ligature.
+
+ -- String: \*Ae
+     Interpolate capital Æ ligature.
+
+ -- String: \*oe
+     Interpolate small oe ligature.
+
+ -- String: \*OE
+     Interpolate capital OE ligature.
+
+4.6.9 Naming Conventions
+------------------------
+
+The following conventions are used for names of macros, strings, and
+registers.  External names available to documents that use the 'groff'
+'ms' macros contain only uppercase letters and digits.
+
+   Internally, the macros are divided into modules.  Conventions for
+identifier names are as follows.
+
+   * Names used only within one module are of the form MODULE'*'NAME.
+
+   * Names used outside the module in which they are defined are of the
+     form MODULE'@'NAME.
+
+   * Names associated with a particular environment are of the form
+     ENVIRONMENT':'NAME; these are used only within the 'par' module.
+
+   * NAME does not have a module prefix.
+
+   * Constructed names used to implement arrays are of the form
+     ARRAY'!'INDEX.
+
+   Thus the 'groff' 'ms' macros reserve the following names.
+
+   * Names containing the characters '*', '@', and ':'.
+
+   * Names containing only uppercase letters and digits.
+
+5 GNU 'troff' Reference
+***********************
+
+This chapter covers _all_ of the facilities of the GNU 'troff'
+formatting engine.  Users of macro packages may skip it if not
+interested in details.
+
+5.1 Text
+========
+
+AT&T 'troff' was designed to take input as it would be composed on a
+typewriter, including the teletypewriters used as early computer
+terminals, and relieve the user drafting a document of concern with
+details like line length, hyphenation breaking, and the achievement of
+straight margins.  Early in its development, the program gained the
+ability to prepare output for a phototypesetter; a document could then
+be prepared for output to either a teletypewriter, a phototypesetter, or
+both.  GNU 'troff' continues this tradition of permitting an author to
+compose a single master version of a document which can then be rendered
+for a variety of output formats or devices.
+
+   'roff' input files contain text interspersed with instructions to
+control the formatter.  Even in the absence of such instructions, GNU
+'troff' still processes its input in several ways, by filling,
+hyphenating, breaking, and adjusting it, and supplementing it with
+inter-sentence space.
+
+5.1.1 Filling
+-------------
+
+When GNU 'troff' starts up, it obtains information about the device for
+which it is preparing output.(1)  (*note Filling-Footnote-1::) An
+essential property is the length of the output line, such as "6.5
+inches".
+
+   GNU 'troff' interprets plain text files employing the Unix
+line-ending convention.  It reads input a character at a time,
+collecting words as it goes, and fits as many words together on an
+output line as it can--this is known as "filling".  To GNU 'troff', a
+"word" is any sequence of one or more characters that aren't spaces or
+newlines.  The exceptions separate words.(2)  (*note
+Filling-Footnote-2::) To disable filling, see *note Manipulating Filling
+and Adjustment::.
+
+     It is a truth universally acknowledged
+     that a single man in possession of a
+     good fortune must be in want of a wife.
+         => It is a truth universally acknowledged that a
+         => single man in possession of a good fortune must
+         => be in want of a wife.
+
+   (1) *Note Device and Font Description Files::.
+
+   (2) Tabs and leaders also separate words.  Escape sequences can
+function as word characters, word separators, or neither--the last
+simply have no effect on GNU 'troff''s idea of whether an input
+character is within a word.  We'll discuss all of these in due course.
+
+5.1.2 Sentences
+---------------
+
+A passionate debate has raged for decades among writers of the English
+language over whether more space should appear between adjacent
+sentences than between words within a sentence, and if so, how much, and
+what other circumstances should influence this spacing.(1)  (*note
+Sentences-Footnote-1::) GNU 'troff' follows the example of AT&T 'troff';
+it attempts to detect the boundaries between sentences, and supplies
+additional inter-sentence space between them.
+
+     Hello, world!
+     Welcome to groff.
+         => Hello, world!  Welcome to groff.
+
+   GNU 'troff' flags certain characters (normally '!', '?', and '.') as
+potentially ending a sentence.  When GNU 'troff' encounters one of these
+"end-of-sentence characters" at the end of an input line, or one of them
+is followed by two (unescaped) spaces on the same input line, it appends
+an inter-word space followed by an inter-sentence space in the output.
+
+     R. Harper subscribes to a maxim of P. T. Barnum.
+         => R. Harper subscribes to a maxim of P. T. Barnum.
+
+   In the above example, inter-sentence space is not added after 'P.' or
+'T.' because the periods do not occur at the end of an input line, nor
+are they followed by two or more spaces.  Let's imagine that we've heard
+something about defamation from Mr. Harper's attorney, recast the
+sentence, and reflowed it in our text editor.
+
+     I submit that R. Harper subscribes to a maxim of P. T.
+     Barnum.
+         => I submit that R. Harper subscribes to a maxim of
+         => P. T.  Barnum.
+
+   "Barnum" doesn't begin a sentence!  What to do?  Let us meet our
+first "escape sequence", a series of input characters that give
+instructions to GNU 'troff' instead of being used to construct output
+device glyphs.(2)  (*note Sentences-Footnote-2::) An escape sequence
+begins with the backslash character '\' by default, an uncommon
+character in natural language text, and is _always_ followed by at least
+one other character, hence the term "sequence".
+
+   The dummy character escape sequence '\&' can be used after an
+end-of-sentence character to defeat end-of-sentence detection on a
+per-instance basis.  We can therefore rewrite our input more
+defensively.
+
+     I submit that R.\& Harper subscribes to a maxim of P.\&
+     T.\& Barnum.
+         => I submit that R. Harper subscribes to a maxim of
+         => P. T. Barnum.
+
+   Adding text caused our input to wrap; now, we don't need '\&' after
+'T.' but we do after 'P.'.  Consistent use of the escape sequence
+ensures that potential sentence boundaries are robust to editing
+activities.  Further advice along these lines will follow in *note Input
+Conventions::.
+
+   Normally, the occurrence of a visible non-end-of-sentence character
+(as opposed to a space or tab) immediately after an end-of-sentence
+character cancels detection of the end of a sentence.  For example, it
+would be incorrect for GNU 'troff' to infer the end of a sentence after
+the dot in '3.14159'.  However, several characters are treated
+_transparently_ after the occurrence of an end-of-sentence character.
+That is, GNU 'troff' does not cancel end-of-sentence detection when it
+processes them.  This is because such characters are often used as
+footnote markers or to close quotations and parentheticals.  The default
+set is '"', ''', ')', '', '*', '\dg', '\dd', '\rq', and '\cq'.
+The last four are examples of "special characters", escape sequences
+whose purpose is to obtain glyphs that are not easily typed at the
+keyboard, or which have special meaning to GNU 'troff' (like '\'
+itself).(3)  (*note Sentences-Footnote-3::)
+
+     \lqThe idea that the poor should have leisure has always
+     been shocking to the rich.\rq
+     (Bertrand Russell, 1935)
+         => "The idea that the poor should have
+         => leisure has always been shocking to
+         => the rich."  (Bertrand Russell, 1935)
+
+   The sets of characters that potentially end sentences or are
+transparent to sentence endings are configurable.  See the 'cflags'
+request in *note Using Symbols::.  To change the additional
+inter-sentence space amount--even to remove it entirely--see *note
+Manipulating Filling and Adjustment::.
+
+   (1) A well-researched jeremiad appreciated by 'groff' contributors on
+both sides of the sentence-spacing debate can be found at
+<https://web.archive.org/web/20171217060354/http://www.heracliteanriver.com/?p=324>.
+
+   (2) This statement oversimplifies; there are escape sequences whose
+purpose is precisely to produce glyphs on the output device, and input
+characters that _aren't_ part of escape sequences can undergo a great
+deal of processing before getting to the output.
+
+   (3) The mnemonics for the special characters shown here are "dagger",
+"double dagger", "right (double) quote", and "closing (single) quote".
+See the 'groff_char(7)' man page.
+
+5.1.3 Hyphenation
+-----------------
+
+When an output line is nearly full, it is uncommon for the next word
+collected from the input to exactly fill it--typically, there is room
+left over only for part of the next word.  The process of splitting a
+word so that it appears partially on one line (with a hyphen to indicate
+to the reader that the word has been broken) with its remainder on the
+next is "hyphenation".  Hyphenation points can be manually specified;
+GNU 'troff' also uses a hyphenation algorithm and language-specific
+pattern files (based on those used in TeX) to decide which words can be
+hyphenated and where.
+
+   Hyphenation does not always occur even when the hyphenation rules for
+a word allow it; it can be disabled, and when not disabled there are
+several parameters that can prevent it in certain circumstances.  *Note
+Manipulating Hyphenation::.
+
+5.1.4 Breaking
+--------------
+
+Once an output line is full, the next word (or remainder of a hyphenated
+one) is placed on a different output line; this is called a "break".  In
+this manual and in 'roff' discussions generally, a "break" if not
+further qualified always refers to the termination of an output line.
+When the formatter is filling text, it introduces breaks automatically
+to keep output lines from exceeding the configured line length.  After
+an automatic break, GNU 'troff' adjusts the line if applicable (see
+below), and then resumes collecting and filling text on the next output
+line.
+
+   Sometimes, a line cannot be broken automatically.  This usually does
+not happen with natural language text unless the output line length has
+been manipulated to be extremely short, but it can with specialized text
+like program source code.  We can use 'perl' at the shell prompt to
+contrive an example of failure to break the line.  We also employ the
+'-z' option to suppress normal output.
+
+     $ perl -e 'print "#" x 80, "\n";' | nroff -z
+         error-> warning: cannot break line
+
+   The remedy for these cases is to tell GNU 'troff' where the line may
+be broken without hyphens.  This is done with the non-printing break
+point escape sequence '\:'; see *note Manipulating Hyphenation::.
+
+   What if the document author wants to stop filling lines temporarily,
+for instance to start a new paragraph?  There are several solutions.  A
+blank input line not only causes a break, but by default it also outputs
+a one-line vertical space (effectively a blank output line).  This
+behavior can be modified; see *note Blank Line Traps::.  Macro packages
+may discourage or disable the blank line method of paragraphing in favor
+of their own macros.
+
+   A line that begins with one or more spaces causes a break.  The
+spaces are output at the beginning of the next line without being
+_adjusted_ (see below); however, this behavior can be modified (*note
+Leading Space Traps::).  Again, macro packages may provide other methods
+of producing indented paragraphs.  Trailing spaces on text lines are
+discarded.(1)  (*note Breaking-Footnote-1::)
+
+   What if the file ends before enough words have been collected to fill
+an output line?  Or the output line is exactly full but not yet broken,
+and there is no more input?  GNU 'troff' interprets the end of input as
+a break.  Certain requests also cause breaks, implicitly or explicitly.
+This is discussed in *note Manipulating Filling and Adjustment::.
+
+   (1) "Text lines" are defined in *note Requests and Macros::.
+
+5.1.5 Adjustment
+----------------
+
+After GNU 'troff' performs an automatic break, it may then "adjust" the
+line, widening inter-word spaces until the text reaches the right
+margin.  Extra spaces between words are preserved.  Leading and trailing
+spaces are handled as noted above.  Text can be aligned to the left or
+right margin only, or centered; see *note Manipulating Filling and
+Adjustment::.
+
+5.1.6 Tabs and Leaders
+----------------------
+
+GNU 'troff' translates input horizontal tab characters ("tabs") and
+<Control+A> characters ("leaders") into movements to the next tab stop.
+Tabs simply move to the next tab stop; leaders place enough periods to
+fill the space.  Tab stops are by default located every half inch
+measured from the drawing position corresponding to the beginning of the
+input line; see *note Page Geometry::.  Tabs and leaders do not cause
+breaks and therefore do not interrupt filling.  Below, we use arrows ->
+and bullets * to indicate input tabs and leaders, respectively.
+
+     1
+     -> 2 -> 3 * 4
+     -> * 5
+     => 1         2       3.......4         ........5
+
+   Tabs and leaders lend themselves to table construction.(1)  (*note
+Tabs and Leaders-Footnote-1::) The tab and leader glyphs can be
+configured, and further facilities for sophisticated table composition
+are available; see *note Tabs and Fields::.  There are many details to
+track when using such low-level features, so most users turn to the
+'tbl(1)' preprocessor to lay out tables.
+
+   (1) "Tab" is short for "tabulation", revealing the term's origin as a
+spacing mechanism for table arrangement.
+
+5.1.7 Requests and Macros
+-------------------------
+
+We have now encountered almost all of the syntax there is in the 'roff'
+language, with an exception already noted in passing.  A "request" is an
+instruction to the formatter that occurs after a "control character",
+which is recognized at the beginning of an input line.  The regular
+control character is a dot ('.').  Its counterpart, the "no-break
+control character", a neutral apostrophe ('''), suppresses the break
+that is implied by some requests.  These characters were chosen because
+it is uncommon for lines of text in natural languages to begin with
+them.  If you require a formatted period or apostrophe (closing single
+quotation mark) where GNU 'troff' is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence, '\&'.
+
+   An input line beginning with a control character is called a "control
+line".  Every line of input that is not a control line is a "text
+line".(1)  (*note Requests and Macros-Footnote-1::)
+
+   Requests often take "arguments", words (separated from the request
+name and each other by spaces) that specify details of the action GNU
+'troff' is expected to perform.  If a request is meaningless without
+arguments, it is typically ignored.
+
+   GNU 'troff''s requests and escape sequences comprise the control
+language of the formatter.  Of key importance are the requests that
+define macros.  Macros are invoked like requests, enabling the request
+repertoire to be extended or overridden.(2)  (*note Requests and
+Macros-Footnote-2::)
+
+   A "macro" can be thought of as an abbreviation you can define for a
+collection of control and text lines.  When the macro is "called" by
+giving its name after a control character, it is replaced with what it
+stands for.  The process of textual replacement is known as
+"interpolation".(3)  (*note Requests and Macros-Footnote-3::)
+Interpolations are handled as soon as they are recognized, and once
+performed, a 'roff' formatter scans the replacement for further
+requests, macro calls, and escape sequences.
+
+   In 'roff' systems, the 'de' request defines a macro.(4)  (*note
+Requests and Macros-Footnote-4::)
+
+     .de DATE
+     2020-11-14
+     ..
+
+The foregoing input produces no output by itself; all we have done is
+store some information.  Observe the pair of dots that ends the macro
+definition.  This is a default; you can specify your own terminator for
+the macro definition as the second argument to the 'de' request.
+
+     .de NAME ENDNAME
+     Heywood Jabuzzoff
+     .ENDNAME
+
+   In fact, the ending marker is itself the name of a macro to be
+called, or a request to be invoked, if it is defined at the time its
+control line is read.
+
+     .de END
+     Big Rip
+     ..
+     .de START END
+     Big Bang
+     .END
+     .START
+         => Big Rip Big Bang
+
+In the foregoing example, "Big Rip" printed before "Big Bang" because
+its macro was _called_ first.  Consider what would happen if we dropped
+'END' from the '.de START' line and added '..' after '.END'.  Would the
+order change?
+
+   Let us consider a more elaborate example.
+
+     .de DATE
+     2020-10-05
+     ..
+     .
+     .de BOSS
+     D.\& Kruger,
+     J.\& Peterman
+     ..
+     .
+     .de NOTICE
+     Approved:
+     .DATE
+     by
+     .BOSS
+     ..
+     .
+     Insert tedious regulatory compliance paragraph here.
+
+     .NOTICE
+
+     Insert tedious liability disclaimer paragraph here.
+
+     .NOTICE
+         => Insert tedious regulatory compliance paragraph here.
+         =>
+         => Approved: 2020-10-05 by D. Kruger, J. Peterman
+         =>
+         => Insert tedious liability disclaimer paragraph here.
+         =>
+         => Approved: 2020-10-05 by D. Kruger, J. Peterman
+
+The above document started with a series of control lines.  Three macros
+were defined, with a 'de' request declaring each macro's name, and the
+"body" of the macro starting on the next line and continuing until a
+line with two dots ''..'' marked its end.  The text proper began only
+after the macros were defined; this is a common pattern.  Only the
+'NOTICE' macro was called "directly" by the document; 'DATE' and 'BOSS'
+were called only by 'NOTICE' itself.  Escape sequences were used in
+'BOSS', two levels of macro interpolation deep.
+
+   The advantage in typing and maintenance economy may not be obvious
+from such a short example, but imagine a much longer document with
+dozens of such paragraphs, each requiring a notice of managerial
+approval.  Consider what must happen if you are in charge of generating
+a new version of such a document with a different date, for a different
+boss.  With well-chosen macros, you only have to change each datum in
+one place.
+
+   In practice, we would probably use strings (*note Strings::) instead
+of macros for such simple interpolations; what is important here is to
+glimpse the potential of macros and the power of recursive
+interpolation.
+
+   We could have defined 'DATE' and 'BOSS' in the opposite order;
+perhaps less obviously, we could also have defined them _after_
+'NOTICE'.  "Forward references" like this are acceptable because the
+body of a macro definition is not (completely) interpreted, but stored
+instead (*note Copy Mode::).  While a macro is being defined (or
+appended to), requests are not interpreted and macros not interpolated,
+whereas some commonly used escape sequences _are_ interpreted.  'roff'
+systems also support recursive macro calls, as long as you have a way to
+break the recursion (*note Conditionals and Loops::).  Maintainable
+'roff' documents tend to arrange macro definitions to minimize forward
+references.
+
+   (1) The '\<RET>' escape sequence can alter how an input line is
+classified; see *note Line Continuation::.
+
+   (2) Argument handling in macros is more flexible but also more
+complex.  *Note Calling Macros::.
+
+   (3) Some escape sequences undergo interpolation as well.
+
+   (4) GNU 'troff' offers additional ones.  *Note Writing Macros::.
+
+5.1.8 Macro Packages
+--------------------
+
+Macro definitions can be collected into "macro files", 'roff' input
+files designed to produce no output themselves but instead ease the
+preparation of other 'roff' documents.  There is no syntactical
+difference between a macro file and any other 'roff' document; only its
+purpose distinguishes it.  When a macro file is installed at a standard
+location and suitable for use by a general audience, it is often termed
+a "macro package".(1)  (*note Macro Packages-Footnote-1::) Macro
+packages can be loaded by supplying the '-m' option to GNU 'troff' or a
+'groff' front end.  Alternatively, a document requiring a macro package
+can load it with the 'mso' ("macro source") request.
+
+   (1) Macro files and packages frequently define registers and strings
+as well.
+
+5.1.9 Input Encodings
+---------------------
+
+The 'groff' command's '-k' option calls the 'preconv' preprocessor to
+perform input character encoding conversions.  Input to the GNU 'troff'
+formatter itself, on the other hand, must be in one of two encodings it
+can recognize.
+
+'cp1047'
+     The code page 1047 input encoding works only on EBCDIC platforms
+     (and conversely, the other input encodings don't work with EBCDIC);
+     the file 'cp1047.tmac' is loaded at startup.
+
+'latin1'
+     ISO Latin-1, an encoding for Western European languages, is the
+     default input encoding on non-EBCDIC platforms; the file
+     'latin1.tmac' is loaded at startup.
+
+Any document that is encoded in ISO 646:1991 (a descendant of USAS
+X3.4-1968 or "US-ASCII"), or, equivalently, uses only code points from
+the "C0 Controls" and "Basic Latin" parts of the Unicode character set
+is also a valid ISO Latin-1 document; the standards are interchangeable
+in their first 128 code points.(1)  (*note Input Encodings-Footnote-1::)
+
+   Other encodings are supported by means of macro packages.
+
+'latin2'
+     To use ISO Latin-2, an encoding for Central and Eastern European
+     languages, invoke '.mso latin2.tmac' at the beginning of your
+     document or supply '-mlatin2' as a command-line argument to
+     'groff'.
+
+'latin5'
+     To use ISO Latin-5, an encoding for the Turkish language, invoke
+     '.mso latin5.tmac' at the beginning of your document or supply
+     '-mlatin5' as a command-line argument to 'groff'.
+
+'latin9'
+     ISO Latin-9 succeeds Latin-1; it includes a Euro sign and better
+     glyph coverage for French.  To use this encoding, invoke
+     '.mso latin9.tmac' at the beginning of your document or supply
+     '-mlatin9' as a command-line argument to 'groff'.
+
+   Some characters from an input encoding may not be available with a
+particular output driver, or their glyphs may not have representation in
+the font used.  For terminal devices, fallbacks are defined, like 'EUR'
+for the Euro sign and '(C)' for the copyright sign.  For typesetter
+devices, you may need to "mount" fonts that support glyphs required by
+the document.  *Note Font Positions::.
+
+   Because a Euro glyph was not historically defined in PostScript
+fonts, 'groff' comes with a font called 'freeeuro.pfa' that provides the
+Euro in several styles.  Standard PostScript fonts contain the glyphs
+from Latin-5 and Latin-9 that Latin-1 lacks, so these encodings are
+supported for the 'ps' and 'pdf' output devices as 'groff' ships, while
+Latin-2 is not.
+
+   Unicode supports characters from all other input encodings; the
+'utf8' output driver for terminals therefore does as well.  The DVI
+output driver supports the Latin-2 and Latin-9 encodings if the
+command-line option '-mec' is used as well.  (2)  (*note Input
+Encodings-Footnote-2::)
+
+   (1) The _semantics_ of certain punctuation code points have gotten
+stricter with the successive standards, a cause of some frustration
+among man page writers; see the 'groff_char(7)' man page.
+
+   (2) The DVI output device defaults to using the Computer Modern (CM)
+fonts; 'ec.tmac' loads the EC fonts instead, which provide Euro '\Eu'
+and per mille '\%0' glyphs.
+
+5.1.10 Input Conventions
+------------------------
+
+Since GNU 'troff' fills text automatically, it is common practice in the
+'roff' language to avoid visual composition of text in input files: the
+esthetic appeal of the formatted output is what matters.  Therefore,
+'roff' input should be arranged such that it is easy for authors and
+maintainers to compose and develop the document, understand the syntax
+of 'roff' requests, macro calls, and preprocessor languages used, and
+predict the behavior of the formatter.  Several traditions have accrued
+in service of these goals.
+
+   * Follow sentence endings in the input with newlines to ease their
+     recognition (*note Sentences::).  It is frequently convenient to
+     end text lines after colons and semicolons as well, as these
+     typically precede independent clauses.  Consider doing so after
+     commas; they often occur in lists that become easy to scan when
+     itemized by line, or constitute supplements to the sentence that
+     are added, deleted, or updated to clarify it.  Parenthetical and
+     quoted phrases are also good candidates for placement on text lines
+     by themselves.
+
+   * Set your text editor's line length to 72 characters or fewer.(1)
+     (*note Input Conventions-Footnote-1::) This limit, combined with
+     the previous item of advice, makes it less common that an input
+     line will wrap in your text editor, and thus will help you perceive
+     excessively long constructions in your text.  Recall that natural
+     languages originate in speech, not writing, and that punctuation is
+     correlated with pauses for breathing and changes in prosody.
+
+   * Use '\&' after '!', '?', and '.' if they are followed by space,
+     tab, or newline characters and don't end a sentence.
+
+   * In filled text lines, use '\&' before '.' and ''' if they are
+     preceded by space, so that reflowing the input doesn't turn them
+     into control lines.
+
+   * Do not use spaces to perform indentation or align columns of a
+     table.  Leading spaces are reliable when text is not being filled.
+
+   * Comment your document.  It is never too soon to apply comments to
+     record information of use to future document maintainers (including
+     your future self).  We thus introduce another escape sequence,
+     '\"', which causes GNU 'troff' to ignore the remainder of the input
+     line.
+
+   * Use the empty request--a control character followed immediately by
+     a newline--to visually manage separation of material in input
+     files.  Many of the 'groff' project's own documents use an empty
+     request between sentences, after macro definitions, and where a
+     break is expected, and two empty requests between paragraphs or
+     other requests or macro calls that will introduce vertical space
+     into the document.
+
+     You can combine the empty request with the comment escape sequence
+     to include whole-line comments in your document, and even "comment
+     out" sections of it.
+
+   We conclude this section with an example sufficiently long to
+illustrate most of the above suggestions in practice.  For the purpose
+of fitting the example between the margins of this manual with the font
+used for its typeset version, we have shortened the input line length to
+56 columns.  As before, an arrow -> indicates a tab character.
+
+     .\"   nroff this_file.roff | less
+     .\"   groff -T ps this_file.roff > this_file.ps
+     ->The theory of relativity is intimately connected with
+     the theory of space and time.
+     .
+     I shall therefore begin with a brief investigation of
+     the origin of our ideas of space and time,
+     although in doing so I know that I introduce a
+     controversial subject.  \" remainder of paragraph elided
+     .
+     .
+
+     ->The experiences of an individual appear to us arranged
+     in a series of events;
+     in this series the single events which we remember
+     appear to be ordered according to the criterion of
+     \lqearlier\rq and \lqlater\rq, \" punct swapped
+     which cannot be analysed further.
+     .
+     There exists,
+     therefore,
+     for the individual,
+     an I-time,
+     or subjective time.
+     .
+     This itself is not measurable.
+     .
+     I can,
+     indeed,
+     associate numbers with the events,
+     in such a way that the greater number is associated with
+     the later event than with an earlier one;
+     but the nature of this association may be quite
+     arbitrary.
+     .
+     This association I can define by means of a clock by
+     comparing the order of events furnished by the clock
+     with the order of a given series of events.
+     .
+     We understand by a clock something which provides a
+     series of events which can be counted,
+     and which has other properties of which we shall speak
+     later.
+     .\" Albert Einstein, _The Meaning of Relativity_, 1922
+
+   (1) Emacs: 'fill-column: 72'; Vim: 'textwidth=72'
+
+5.2 Page Geometry
+=================
+
+'roff' systems format text under certain assumptions about the size of
+the output medium, or page.  For the formatter to correctly break a line
+it is filling, it must know the line length, which it derives from the
+page width (*note Line Layout::).  For it to decide whether to write an
+output line to the current page or wait until the next one, it must know
+the page length (*note Page Layout::).
+
+   A device's "resolution" converts practical units like inches or
+centimeters to "basic units", a convenient length measure for the output
+device or file format.  The formatter and output driver use basic units
+to reckon page measurements.  The device description file defines its
+resolution and page dimensions (*note DESC File Format::).
+
+   A "page" is a two-dimensional structure upon which a 'roff' system
+imposes a rectangular coordinate system with its upper left corner as
+the origin.  Coordinate values are in basic units and increase down and
+to the right.  Useful ones are therefore always positive and within
+numeric ranges corresponding to the page boundaries.
+
+   While the formatter (and, later, output driver) is processing a page,
+it keeps track of its "drawing position", which is the location at which
+the next glyph will be written, from which the next motion will be
+measured, or where a geometric object will commence rendering.
+Notionally, glyphs are drawn from the text baseline upward and to the
+right.(1)  (*note Page Geometry-Footnote-1::) The "text baseline" is a
+(usually invisible) line upon which the glyphs of a typeface are
+aligned.  A glyph therefore "starts" at its bottom-left corner.  If
+drawn at the origin, a typical letter glyph would lie partially or
+wholly off the page, depending on whether, like "g", it features a
+descender below the baseline.
+
+   Such a situation is nearly always undesirable.  It is furthermore
+conventional not to write or draw at the extreme edges of the page.
+Therefore the initial drawing position of a 'roff' formatter is not at
+the origin, but below and to the right of it.  This rightward shift from
+the left edge is known as the "page offset".(2)  (*note Page
+Geometry-Footnote-2::) The downward shift leaves room for a text output
+line.
+
+   Text is arranged on a one-dimensional lattice of text baselines from
+the top to the bottom of the page.  "Vertical spacing" is the distance
+between adjacent text baselines.  Typographic tradition sets this
+quantity to 120% of the type size.  The initial drawing position is one
+unit of vertical spacing below the page top.  Typographers term this
+unit a vee.
+
+   Vertical spacing has an impact on page-breaking decisions.
+Generally, when a break occurs, the formatter moves the drawing position
+to the next text baseline automatically.  If the formatter were already
+writing to the last line that would fit on the page, advancing by one
+vee would place the next text baseline off the page.  Rather than let
+that happen, 'roff' formatters instruct the output driver to eject the
+page, start a new one, and again set the drawing position to one vee
+below the page top; this is a "page break".
+
+   When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one.  Macro packages keep
+users from having to confront this difficulty by setting "traps" (*note
+Traps::); moreover, all but the simplest page layouts tend to have
+headers and footers, or at least bear vertical margins larger than one
+vee.
+
+   (1) 'groff' does not yet support right-to-left scripts.
+
+   (2) 'groff''s terminal output devices have page offsets of zero.
+
+5.3 Measurements
+================
+
+The formatter sometimes requires the input of numeric parameters to
+specify measurements.  These are specified as integers or decimal
+fractions with an optional "scaling unit" suffixed.  A scaling unit is a
+letter that immediately follows the last digit of a number.  Digits
+after the decimal point are optional.  Measurement expressions include
+'10.5p', '11i', and '3.c'.
+
+   Measurements are scaled by the scaling unit and stored internally
+(with any fractional part discarded) in basic units.  The device
+resolution can therefore be obtained by storing a value of '1i' to a
+register.  The only constraint on the basic unit is that it is at least
+as small as any other unit.
+
+'u'
+     Basic unit.
+
+'i'
+     Inch; defined as 2.54 centimeters.
+
+'c'
+     Centimeter; a centimeter is about 0.3937 inches.
+
+'p'
+     Point; a typesetter's unit used for measuring type size.  There are
+     72 points to an inch.
+
+'P'
+     Pica; another typesetter's unit.  There are 6 picas to an inch and
+     12 points to a pica.
+
+'s'
+'z'
+     *Note Using Fractional Type Sizes::, for a discussion of these
+     units.
+
+'f'
+     GNU 'troff' defines this unit to scale decimal fractions in the
+     interval 0, 1 to 16-bit unsigned integers.  It multiplies a
+     quantity by 65,536.  *Note Colors::, for usage.
+
+   The magnitudes of other scaling units depend on the text formatting
+parameters in effect.  These are useful when specifying measurements
+that need to scale with the typeface or vertical spacing.
+
+'m'
+     Em; an em is equal to the current type size in points.  It is named
+     thus because it is approximately the width of the letter 'M'.
+
+'n'
+     En; an en is one-half em.
+
+'v'
+     Vee; recall *note Page Geometry::.
+
+'M'
+     Hundredth of an em.
+
+5.3.1 Motion Quanta
+-------------------
+
+An output device's basic unit 'u' is not necessarily its smallest
+addressable length; 'u' can be smaller to avoid problems with integer
+roundoff.  The minimum distances that a device can work with in the
+horizontal and vertical directions are termed its "motion quanta".
+Measurements are rounded to applicable motion quanta.  Half-quantum
+fractions round toward zero.
+
+ -- Register: \n.H
+ -- Register: \n.V
+     These read-only registers interpolate the horizontal and vertical
+     motion quanta, respectively, of the output device in basic units.
+
+   For example, we might draw short baseline rules on a terminal device
+as follows.  *Note Drawing Geometric Objects::.
+
+     .tm \n.H
+         error-> 24
+     .nf
+     \l'36u' 36u
+     \l'37u' 37u
+         => _ 36u
+         => __ 37u
+
+5.3.2 Default Units
+-------------------
+
+A general-purpose register (one created or updated with the 'nr'
+request; see *note Registers::) is implicitly dimensionless, or reckoned
+in basic units if interpreted in a measurement context.  But it is
+convenient for many requests and escape sequences to infer a scaling
+unit for an argument if none is specified.  An explicit scaling unit
+(not after a closing parenthesis) can override an undesirable default.
+Effectively, the default unit is suffixed to the expression if a scaling
+unit is not already present.  GNU 'troff''s use of integer arithmetic
+should also be kept in mind (*note Numeric Expressions::).
+
+   The 'll' request interprets its argument in ems by default.  Consider
+several attempts to set a line length of 3.5 inches when the type size
+is 10 points on a terminal device with a resolution of 240 basic units
+and horizontal motion quantum of 24.  Some expressions become zero; the
+request clamps them to that quantum.
+
+     .ll 3.5i      \" 3.5i (= 840u)
+     .ll 7/2       \" 7u/2u -> 3u -> 3m -> 0, clamped to 24u
+     .ll (7 / 2)u  \" 7u/2u -> as above
+     .ll 7/2i      \" 7u/2i -> 7u/480u -> 0 -> as above
+     .ll 7i/2      \" 7i/2u -> 1680u/2m -> 1680u/24u -> 35u
+     .ll 7i/2u     \" 3.5i (= 840u)
+
+The safest way to specify measurements is to attach a scaling unit.  To
+multiply or divide by a dimensionless quantity, use 'u' as its scaling
+unit.
+
+5.4 Numeric Expressions
+=======================
+
+A "numeric expression" evaluates to an integer: it can be as simple as a
+literal '0' or it can be a complex sequence of register and string
+interpolations interleaved with measurements and operators.
+
+   GNU 'troff' provides a set of mathematical and logical operators
+familiar to programmers--as well as some unusual ones--but supports only
+integer arithmetic.(1)  (*note Numeric Expressions-Footnote-1::) The
+internal data type used for computing results is usually a 32-bit signed
+integer, which suffices to represent magnitudes within a range of ±2
+billion.(2)  (*note Numeric Expressions-Footnote-2::)
+
+   Arithmetic infix operators perform a function on the numeric
+expressions to their left and right; they are '+' (addition), '-'
+(subtraction), '*' (multiplication), '/' (truncating division), and '%'
+(modulus).  "Truncating division" rounds to the integer nearer to zero,
+no matter how large the fractional portion.  Overflow and division (or
+modulus) by zero are errors and abort evaluation of a numeric
+expression.
+
+   Arithmetic unary operators operate on the numeric expression to their
+right; they are '-' (negation) and '+' (assertion--for completeness; it
+does nothing).  The unary minus must often be used with parentheses to
+avoid confusion with the decrementation operator, discussed below.
+
+   Observe the rounding behavior and effect of negative operands on the
+modulus and truncating division operators.
+
+     .nr T 199/100
+     .nr U 5/2
+     .nr V (-5)/2
+     .nr W 5/-2
+     .nr X 5%2
+     .nr Y (-5)%2
+     .nr Z 5%-2
+     T=\nT U=\nU V=\nV W=\nW X=\nX Y=\nY Z=\nZ
+         => T=1 U=2 V=-2 W=-2 X=1 Y=-1 Z=1
+
+The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.  Division and modulus operators satisfy the following
+property: given a dividend A and a divisor B, a quotient Q formed by '(a
+/ b)' and a remainder R by '(a % b)', then qb + r = a.
+
+   GNU 'troff''s scaling operator, used with parentheses as '(C;E)',
+evaluates a numeric expression E using C as the default scaling unit.
+If C is omitted, scaling units are ignored in the evaluation of E.  This
+operator can save typing by avoiding the attachment of scaling units to
+every operand out of caution.  Your macros can select a sensible default
+unit in case the user neglects to supply one.
+
+     .\" Indent by amount given in first argument; assume ens.
+     .de Indent
+     .  in (n;\\$1)
+     ..
+
+Without the scaling operator, the foregoing macro would, if called with
+a unitless argument, cause indentation by the 'in' request's default
+scaling unit (ems).  The result would be twice as much indentation as
+expected.
+
+   GNU 'troff' also provides a pair of operators to compute the extrema
+of two operands: '>?' (maximum) and '<?' (minimum).
+
+     .nr slots 5
+     .nr candidates 3
+     .nr salaries (\nslots <? \ncandidates)
+     Looks like we'll end up paying \nsalaries salaries.
+         => Looks like we'll end up paying 3 salaries.
+
+   Comparison operators comprise '<' (less than), '>' (greater than),
+'<=' (less than or equal), '>=' (greater than or equal), and '='
+(equal).  '==' is a synonym for '='.  When evaluated, a comparison is
+replaced with '0' if it is false and '1' if true.  In the 'roff'
+language, positive values are true, others false.
+
+   We can operate on truth values with the logical operators '&'
+(logical conjunction or "and") and ':' (logical disjunction or "or").
+They evaluate as comparison operators do.
+
+   A logical complementation ("not") operator, '!', works only within
+'if', 'ie', and 'while' requests.  Furthermore, '!' is recognized only
+at the beginning of a numeric expression not contained by another
+numeric expression.  In other words, it must be the "outermost"
+operator.  Including it elsewhere in the expression produces a warning
+in the 'number' category (*note Warnings::), and its expression
+evaluates false.  This unfortunate limitation maintains compatibility
+with AT&T 'troff'.  Test a numeric expression for falsity by comparing
+it to a false value.(3)  (*note Numeric Expressions-Footnote-3::)
+
+     .nr X 1
+     .nr Y 0
+     .\" This does not work as expected.
+     .if (\nX)&(!\nY) .nop A: X is true, Y is false
+     .
+     .\" Use this construct instead.
+     .if (\nX)&(\nY<=0) .nop B: X is true, Y is false
+         error-> warning: expected numeric expression, got '!'
+         => B: X is true, Y is false
+
+   The 'roff' language has no operator precedence: expressions are
+evaluated strictly from left to right, in contrast to schoolhouse
+arithmetic.  Use parentheses '(' ')' to impose a desired precedence upon
+subexpressions.
+
+     .nr X 3+5*4
+     .nr Y (3+5)*4
+     .nr Z 3+(5*4)
+     X=\nX Y=\nY Z=\nZ
+         => X=32 Y=32 Z=23
+
+   For many requests and escape sequences that cause motion on the page,
+the unary operators '+' and '-' work differently when leading a numeric
+expression.  They then indicate a motion relative to the drawing
+position: positive is down in vertical contexts, right in horizontal
+ones.
+
+   '+' and '-' are also treated differently by the following requests
+and escape sequences: 'bp', 'in', 'll', 'lt', 'nm', 'nr', 'pl', 'pn',
+'po', 'ps', 'pvs', 'rt', 'ti', '\H', '\R', and '\s'.  Here, leading plus
+and minus signs serve as incrementation and decrementation operators,
+respectively.  To negate an expression, subtract it from zero or include
+the unary minus in parentheses with its argument.  *Note Setting
+Registers::, for examples.
+
+   A leading '|' operator indicates a motion relative not to the drawing
+position but to a boundary.  For horizontal motions, the measurement
+specifies a distance relative to a drawing position corresponding to the
+beginning of the _input_ line.  By default, tab stops reckon movements
+in this way.  Most escape sequences do not; '|' tells them to do so.
+
+     Mind the \h'1.2i'gap.
+     .br
+     Mind the \h'|1.2i'gap.
+     .br
+     Mind the
+     \h'|1.2i'gap.
+         => Mind the             gap.
+         => Mind the    gap.
+         => Mind the             gap.
+
+   One use of this feature is to define macros whose scope is limited to
+the output they format.
+
+     .\" underline word $1 with trailing punctuation $2
+     .de Underline
+     .  nop \\$1\l'|0\ul'\\$2
+     ..
+     Typographical emphasis is best used
+     .Underline sparingly .
+
+In the above example, '|0' specifies a negative motion from the current
+position (at the end of the argument just emitted, '\$1') to the
+beginning of the input line.  Thus, the '\l' escape sequence in this
+case draws a line from right to left.  A macro call occurs at the
+beginning of an input line;(4) (*note Numeric Expressions-Footnote-4::)
+if the '|' operator were omitted, then the underline would be drawn at
+zero distance from the current position, producing device-dependent, and
+likely undesirable, results.  On the 'ps' output device, it underlines
+the period.
+
+   For vertical motions, the '|' operator specifies a distance from the
+first text baseline on the page or in the current diversion,(5) (*note
+Numeric Expressions-Footnote-5::) using the current vertical spacing.
+
+     A
+     .br
+     B \Z'C'\v'|0'D
+         => A D
+         => B C
+
+   In the foregoing example, we've used the '\Z' escape sequence (*note
+Page Motions::) to restore the drawing position after formatting 'C',
+then moved vertically to the first text baseline on the page.
+
+ -- Escape sequence: \B'anything'
+     Interpolate 1 if ANYTHING is a valid numeric expression, and 0
+     otherwise.  The delimiter need not be a neutral apostrophe; see
+     *note Delimiters::.
+
+   You might use '\B' along with the 'if' request to filter out invalid
+macro or string arguments.  *Note Conditionals and Loops::.
+
+     .\" Indent by amount given in first argument; assume ens.
+     .de Indent
+     .  if \B'\\$1' .in (n;\\$1)
+     ..
+
+   A register interpolated as an operand in a numeric expression must
+have an Arabic format; luckily, this is the default.  *Note Assigning
+Register Formats::.
+
+   Because spaces separate arguments to requests, spaces are not allowed
+in numeric expressions unless the (sub)expression containing them is
+surrounded by parentheses.  *Note Invoking Requests::, and *note
+Conditionals and Loops::.
+
+     .nf
+     .nr a 1+2 + 2+1
+     \na
+         error-> expected numeric expression, got a space
+         => 3
+     .nr a 1+(2 + 2)+1
+     \na
+         => 6
+
+   The 'nr' request (*note Setting Registers::) expects its second and
+optional third arguments to be numeric expressions; a bare '+' does not
+qualify, so our first attempt got a warning.
+
+   (1) Provision is made for interpreting and reporting decimal
+fractions in certain cases.
+
+   (2) If that's not enough, see the 'groff_tmac(5)' man page for the
+'62bit.tmac' macro package.
+
+   (3) *Note Conditionals and Loops::.
+
+   (4) Control structure syntax creates an exception to this rule, but
+is designed to remain useful: recalling our example, '.if 1 .Underline
+this' would underline only "this", precisely.  *Note Conditionals and
+Loops::.
+
+   (5) *Note Diversions::.
+
+5.5 Identifiers
+===============
+
+An "identifier" labels a GNU 'troff' datum such as a register, name
+(macro, string, or diversion), typeface, color, special character,
+character class, environment, or stream.  Valid identifiers consist of
+one or more ordinary characters.  An ordinary character is an input
+character that is not the escape character, a leader, tab, newline, or
+invalid as GNU 'troff' input.
+
+   Invalid input characters are a subset of control characters (from the
+sets "C0 Controls" and "C1 Controls" as Unicode describes them).  When
+GNU 'troff' encounters one in an identifier, it produces a warning in
+category 'input' (*note Warnings::).  They are removed during
+interpretation: an identifier 'foo', followed by an invalid character
+and then 'bar', is processed as 'foobar'.
+
+   On a machine using the ISO 646, 8859, or 10646 character encodings,
+invalid input characters are '0x00', '0x08', '0x0B', '0x0D'-'0x1F', and
+'0x80'-'0x9F'.  On an EBCDIC host, they are '0x00'-'0x01', '0x08',
+'0x09', '0x0B', '0x0D'-'0x14', '0x17'-'0x1F', and '0x30'-'0x3F'.(1)
+(*note Identifiers-Footnote-1::) Some of these code points are used by
+GNU 'troff' internally, making it non-trivial to extend the program to
+accept UTF-8 or other encodings that use characters from these
+ranges.(2)  (*note Identifiers-Footnote-2::)
+
+   Thus, the identifiers 'br', 'PP', 'end-list', 'ref*normal-print',
+'|', '@_', and '!"#$%'()*+,-./' are all valid.  Discretion should be
+exercised to prevent confusion.  Identifiers starting with '(' or ''
+require care.
+
+     .nr x 9
+     .nr y 1
+     .nr (x 2
+     .nr y 3
+     .nr sum1 (\n(x + \ny)
+         error-> a space character is not allowed in an escape
+         error->   sequence parameter
+     A:2+3=\nsum1
+     .nr sum2 (\n((x + \ny)
+     B:2+3=\nsum2
+     .nr sum3 (\n(x + \n(y)
+     C:2+3=\nsum3
+         => A:2+3=1 B:2+3=5 C:2+3=5
+
+An identifier with a closing bracket ('') in its name can't be accessed
+with bracket-form escape sequences that expect an identifier as a
+parameter.  For example, '\foo' accesses the glyph 'foo', followed by
+'' in whatever the surrounding context is, whereas '\C'foo'' formats a
+glyph named 'foo'.  Similarly, the identifier '(' can't be interpolated
+_except_ with bracket forms.
+
+   If you begin a macro, string, or diversion name with either of the
+characters '' or '', you foreclose use of the 'grefer' preprocessor,
+which recognizes '.' and '.' as bibliographic reference delimiters.
+
+ -- Escape sequence: \A'anything'
+     Interpolate 1 if ANYTHING is a valid identifier, and 0 otherwise.
+     The delimiter need not be a neutral apostrophe; see *note
+     Delimiters::.  Because invalid input characters are removed (see
+     above), invalid identifiers are empty or contain spaces, tabs, or
+     newlines.
+
+     You can employ '\A' to validate a macro argument before using it to
+     construct another escape sequence or identifier.
+
+          .\" usage: .init-coordinate-pair name val1 val2
+          .\" Create a coordinate pair where name!x=val1 and
+          .\" name!y=val2.
+          .de init-coordinate-pair
+          .  if \A'\\$1' \{\
+          .    if \B'\\$2' .nr \\$1!x \\$2
+          .    if \B'\\$3' .nr \\$1!y \\$3
+          .  \}
+          ..
+          .init-coordinate-pair center 5 10
+          The center is at (\ncenter!x, \ncenter!y).
+          .init-coordinate-pair "poi->nt" trash garbage \" ignored
+          .init-coordinate-pair point trash garbage \" ignored
+              => The center is at (5, 10).
+
+     In this example, we also validated the numeric arguments; the
+     registers 'point!x' and 'point!y' remain undefined.  *Note Numeric
+     Expressions:: for the '\B' escape sequence.
+
+   How GNU 'troff' handles the interpretation of an undefined identifier
+depends on the context.  There is no way to invoke an undefined request;
+such syntax is interpreted as a macro call instead.  If the identifier
+is interpreted as a string, macro, or diversion, GNU 'troff' emits a
+warning in category 'mac', defines it as empty, and interpolates
+nothing.  If the identifier is interpreted as a register, GNU 'troff'
+emits a warning in category 'reg', initializes it to zero, and
+interpolates that value.  *Note Warnings::, *note Interpolating
+Registers::, and *note Strings::.  Attempting to use an undefined
+typeface, special character, color, character class, environment, or
+stream generally provokes an error diagnostic.
+
+   Identifiers for requests, macros, strings, and diversions share one
+name space; special characters and character classes another.  No other
+object types do.
+
+     .de xxx
+     .  nop foo
+     ..
+     .di xxx
+     bar
+     .br
+     .di
+     .
+     .xxx
+         => bar
+
+The foregoing example shows that GNU 'troff' reuses the identifier
+'xxx', changing it from a macro to a diversion.  No warning is emitted,
+and the previous contents of 'xxx' are lost.
+
+   (1) Historically, control characters like ASCII STX, ETX, and BEL
+(<Control+B>, <Control+C>, and <Control+G>) have been observed in 'roff'
+documents, particularly in macro packages employing them as delimiters
+with the output comparison operator to try to avoid collisions with the
+content of arbitrary user-supplied parameters (*note Operators in
+Conditionals::).  We discourage this expedient; in GNU 'troff' it is
+unnecessary (outside of compatibility mode) because delimited arguments
+are parsed at a different input level than the surrounding context.
+*Note Implementation Differences::.
+
+   (2) Consider what happens when a C1 control '0x80'-'0x9F' is
+necessary as a continuation byte in a UTF-8 sequence.
+
+5.6 Formatter Instructions
+==========================
+
+To support documents that require more than filling, automatic line
+breaking and hyphenation, adjustment, and supplemental inter-sentence
+space, the 'roff' language offers two means of embedding instructions to
+the formatter.
+
+   One is a "request", which begins with a control character and takes
+up the remainder of the input line.  Requests often perform relatively
+large-scale operations such as setting the page length, breaking the
+line, or starting a new page.  They also conduct internal operations
+like defining macros.
+
+   The other is an "escape sequence", which begins with the escape
+character and can be embedded anywhere in the input, even in arguments
+to requests and other escape sequences.  Escape sequences interpolate
+special characters, strings, or registers, and handle comparatively
+minor formatting tasks like sub- and superscripting.
+
+   Some operations, such as font selection and type size alteration, are
+available via both requests and escape sequences.
+
+5.6.1 Control Characters
+------------------------
+
+The mechanism of using 'roff''s control characters to invoke requests
+and call macros was introduced in *note Requests and Macros::.  Control
+characters are recognized only at the beginning of an input line, or at
+the beginning of the branch of a control structure request; see *note
+Conditionals and Loops::.
+
+   A few requests cause a break implicitly; use the no-break control
+character to prevent the break.  Break suppression is its sole
+behavioral distinction.  Employing the no-break control character to
+invoke requests that don't cause breaks is harmless but poor style.
+*Note Manipulating Filling and Adjustment::.
+
+   The control '.' and no-break control ''' characters can each be
+changed to any ordinary character(1) (*note Control
+Characters-Footnote-1::) with the 'cc' and 'c2' requests, respectively.
+
+ -- Request: .cc o
+     Recognize the ordinary character O as the control character.  If O
+     is absent or invalid, the default control character '.' is
+     selected.  The identity of the control character is associated with
+     the environment (*note Environments::).
+
+ -- Request: .c2 o
+     Recognize the ordinary character O as the no-break control
+     character.  If O is absent or invalid, the default no-break control
+     character ''' is selected.  The identity of the no-break control
+     character is associated with the environment (*note
+     Environments::).
+
+   When writing a macro, you might wish to know which control character
+was used to call it.
+
+ -- Register: \n.br
+     This read-only register interpolates 1 if the currently executing
+     macro was called using the normal control character and 0
+     otherwise.  If a macro is interpolated as a string, the '.br'
+     register's value is inherited from the context of the string
+     interpolation.  *Note Strings::.
+
+     Use this register to reliably intercept requests that imply breaks.
+
+          .als bp*orig bp
+          .de bp
+          .  ie \\n.br .bp*orig
+          .  el          'bp*orig
+          ..
+
+     Testing the '.br' register outside of a macro definition makes no
+     sense.
+
+   (1) Recall *note Identifiers::.
+
+5.6.2 Invoking Requests
+-----------------------
+
+A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.  The invocation of an
+unrecognized request is interpreted as a macro call.  Defining a macro
+with the same name as a request replaces the request.  Deleting a
+request name with the 'rm' request makes it unavailable.  The 'als'
+request can alias requests, permitting them to be wrapped or
+non-destructively replaced.  *Note Strings::.
+
+   There is no inherent limit on argument length or quantity.  Most
+requests take one or more arguments, and ignore any they do not expect.
+A request may be separated from its arguments by tabs or spaces, but
+only spaces can separate an argument from its successor.  Only one
+between arguments is necessary; any excess is ignored.  GNU 'troff' does
+not allow tabs for argument separation.(1)  (*note Invoking
+Requests-Footnote-1::)
+
+   Generally, a space _within_ a request argument is not relevant, not
+meaningful, or is supported by bespoke provisions, as with the 'tl'
+request's delimiters (*note Page Layout::).  Some requests, like 'ds',
+interpret the remainder of the control line as a single argument.  *Note
+Strings::.
+
+   Spaces and tabs immediately after a control character are ignored.
+Commonly, authors structure the source of documents or macro files with
+them.
+
+     .de center
+     .  if \\n.br \
+     .    br
+     .  ce \\$1
+     ..
+     .
+     .
+     .de right-align
+     .->if \\n.br \
+     .->->br
+     .->rj \\$1
+     ..
+
+   If you assign an empty blank line trap, you can separate macro
+definitions (or any input lines) with blank lines.
+
+     .de do-nothing
+     ..
+     .blm do-nothing  \" activate blank line trap
+
+     .de center
+     .  if \\n.br \
+     .    br
+     .  ce \\$1
+     ..
+
+
+     .de right-align
+     .->if \\n.br \
+     .->->br
+     .->rj \\$1
+     ..
+
+     .blm             \" deactivate blank line trap
+
+   *Note Blank Line Traps::.
+
+   (1) In compatibility mode, a space is not necessary after a request
+or macro name of two characters' length.  Also, Plan 9 'troff' allows
+tabs to separate arguments.
+
+5.6.3 Calling Macros
+--------------------
+
+If a macro of the desired name does not exist when called, it is
+created, assigned an empty definition, and a warning in category 'mac'
+is emitted.  Calling an undefined macro _does_ end a macro definition
+naming it as its end macro (*note Writing Macros::).
+
+   To embed spaces _within_ a macro argument, enclose the argument in
+neutral double quotes '"'.  Horizontal motion escape sequences are
+sometimes a better choice for arguments to be formatted as text.
+
+   Consider calls to a hypothetical section heading macro 'uh'.
+
+     .uh The Mouse Problem
+     .uh "The Mouse Problem"
+     .uh The\~Mouse\~Problem
+     .uh The\ Mouse\ Problem
+
+The first line calls 'uh' with three arguments: 'The', 'Mouse', and
+'Problem'.  The remainder call the 'uh' macro with one argument, 'The
+Mouse Problem'.  The last solution, using escaped spaces, can be found
+in documents prepared for AT&T 'troff'.  It can cause surprise when text
+is adjusted, because '\<SP>' inserts a _fixed-width_, non-breaking
+space.  GNU 'troff''s '\~' escape sequence inserts an adjustable,
+non-breaking space.(1)  (*note Calling Macros-Footnote-1::)
+
+   The foregoing raises the question of how to embed neutral double
+quotes or backslashes in macro arguments when _those_ characters are
+desired as literals.  In GNU 'troff', the special character escape
+sequence '\rs' produces a backslash and '\dq' a neutral double
+quote.
+
+   In GNU 'troff''s AT&T compatibility mode, these characters remain
+available as '\(rs' and '\(dq', respectively.  AT&T 'troff' did not
+consistently define these special characters, but its descendants can be
+made to support them.  *Note Device and Font Description Files::.
+
+   If even that is not feasible, options remain.  To obtain a literal
+escape character in a macro argument, you can simply type it if you
+change or disable the escape character first.  *Note Using Escape
+Sequences::.  Otherwise, you must escape the escape character repeatedly
+to a context-dependent extent.  *Note Copy Mode::.
+
+   For the (neutral) double quote, you have recourse to an obscure
+syntactical feature of AT&T 'troff'.  Because a double quote can begin a
+macro argument, the formatter keeps track of whether the current
+argument was started thus, and doesn't require a space after the double
+quote that ends it.(2)  (*note Calling Macros-Footnote-2::) In the
+argument list to a macro, a double quote that _isn't_ preceded by a
+space _doesn't_ start a macro argument.  If not preceded by a double
+quote that began an argument, this double quote becomes part of the
+argument.  Furthermore, within a quoted argument, a pair of adjacent
+double quotes becomes a literal double quote.
+
+     .de eq
+     .  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+     .  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+     .. \" 4 backslashes on the next line
+     .eq a" "b c" "de"f\\\\g" h""i "j""k"
+         error-> arg1:a" arg2:b c arg3:de
+         error-> arg4:f\g" arg5:h""i arg6:j"k
+
+   Apart from the complexity of the rules, this traditional solution has
+the disadvantage that double quotes don't survive repeated argument
+expansion in AT&T 'troff' or GNU 'troff''s compatibility mode.  This can
+frustrate efforts to pass such arguments intact through multiple macro
+calls.
+
+     .cp 1
+     .de eq
+     .  tm arg1:\\$1 arg2:\\$2 arg3:\\$3
+     .  tm arg4:\\$4 arg5:\\$5 arg6:\\$6
+     ..
+     .de xe
+     .  eq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6
+     .. \" 8 backslashes on the next line
+     .xe a" "b c" "de"f\\\\\\\\g" h""i "j""k"
+         error-> arg1:a" arg2:b arg3:c
+         error-> arg4:de arg5:f\g" arg6:h""i
+
+   Outside of compatibility mode, GNU 'troff' doesn't exhibit this
+problem because it tracks the nesting depth of interpolations.  *Note
+Implementation Differences::.
+
+   (1) '\~' is fairly portable; see *note Other Differences::.
+
+   (2) Strictly, you can neglect to close the last quoted macro
+argument, relying on the end of the control line to do so.  We consider
+this lethargic practice poor style.
+
+5.6.4 Using Escape Sequences
+----------------------------
+
+Whereas requests must occur on control lines, escape sequences can occur
+intermixed with text and may appear in arguments to requests, macros,
+and other escape sequences.  An escape sequence is introduced by the
+escape character, a backslash '\' (but see the 'ec' request below).  The
+next character selects the escape's function.
+
+   Escape sequences vary in length.  Some take an argument, and of
+those, some have different syntactical forms for a one-character,
+two-character, or arbitrary-length argument.  Others accept _only_ an
+arbitrary-length argument.  In the former scheme, a one-character
+argument follows the function character immediately, an opening
+parenthesis '(' introduces a two-character argument (no closing
+parenthesis is used), and an argument of arbitrary length is enclosed in
+brackets ''.  In the latter scheme, the user selects a delimiter
+character.  A few escape sequences are idiosyncratic, and support both
+of the foregoing conventions ('\s'), designate their own termination
+sequence ('\?'), consume input until the next newline ('\!', '\"',
+'\#'), or support an additional modifier character ('\s' again, and
+'\n').  As with requests, use of some escape sequences in source
+documents may interact poorly with a macro package you use; consult its
+documentation to learn of "safe" sequences or alternative facilities it
+provides to achieve the desired result.
+
+   If an escape character is followed by a character that does not
+identify a defined operation, the escape character is ignored (producing
+a diagnostic of the 'escape' warning category, which is not enabled by
+default) and the following character is processed normally.
+
+     $ groff -Tps -ww
+     .nr N 12
+     .ds co white
+     .ds animal elephant
+     I have \fI\nN \*(co \*animals,\f
+     said \P.\&\~Pseudo Pachyderm.
+         error-> warning: escape character ignored before 'P'
+         => I have 12 white elephants, said P. Pseudo Pachyderm.
+
+   Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.  This rule affords flexibility in
+using escape sequences to construct parameters to other escape
+sequences.
+
+     .ds family C\" Courier
+     .ds style I\" oblique
+     Choice a typeface \f(\*family\*stylewisely.
+         => Choose a typeface wisely.
+
+In the above, the syntax form '\f(' accepts only two characters for an
+argument; the example works because the subsequent escape sequences are
+interpolated before the selection escape sequence argument is processed,
+and strings 'family' and 'style' interpolate one character each.(1)
+(*note Using Escape Sequences-Footnote-1::)
+
+   The escape character is nearly always interpreted when encountered;
+it is therefore desirable to have a way to interpolate it, disable it,
+or change it.
+
+ -- Escape sequence: \e
+     Interpolate the escape character.
+
+   The '\rs' special character escape sequence formats a backslash
+glyph.  In macro and string definitions, the input sequences '\\' and
+'\E' defer interpretation of escape sequences.  *Note Copy Mode::.
+
+ -- Request: .eo
+     Disable the escape mechanism except in copy mode.  Once this
+     request is invoked, no input character is recognized as starting an
+     escape sequence in interpretation mode.
+
+ -- Request: .ec o
+     Recognize the ordinary character O as the escape character.  If O
+     is absent or invalid, the default escape character '\' is selected.
+
+   Switching escape sequence interpretation off to define a macro and
+back on afterward can obviate the need to double the escape character
+within the definition.  *Note Writing Macros::.  This technique is not
+available if your macro needs to interpolate values at the time it is
+_defined_--but many do not.
+
+     .\" simplified `BR` macro from the man(7) macro package
+     .eo
+     .de BR
+     .  ds result \&
+     .  while (\n.$ >= 2) \{\
+     .    as result \fB\$1\fR\$2\"
+     .    shift 2
+     .  \}
+     .  if \n.$ .as result \fB\$1\"
+     \*result
+     .  rm result
+     .  ft R
+     ..
+     .ec
+
+ -- Request: .ecs
+ -- Request: .ecr
+     The 'ecs' request stores the escape character for recall with
+     'ecr'.  'ecr' sets the escape character to '\' if none has been
+     saved.
+
+     Use these requests together to temporarily change the escape
+     character.
+
+   Using a different escape character, or disabling it, when calling
+macros not under your control will likely cause errors, since GNU
+'troff' has no mechanism to "intern" macros--that is, to convert a macro
+definition into a form independent of its representation.(2)  (*note
+Using Escape Sequences-Footnote-2::) When a macro is called, its
+contents are interpreted literally.
+
+   (1) The omission of spaces before the comment escape sequences is
+necessary; see *note Strings::.
+
+   (2) TeX does have such a mechanism.
+
+5.6.5 Delimiters
+----------------
+
+Some escape sequences that require parameters use delimiters.  The
+neutral apostrophe ''' is a popular choice and shown in this document.
+The neutral double quote '"' is also commonly seen.  Letters, numerals,
+and leaders can be used.  Punctuation characters are likely better
+choices, except for those defined as infix operators in numeric
+expressions; see below.
+
+     \l'1.5i\bu' \" draw 1.5 inches of bullet glyphs
+
+   The following escape sequences don't take arguments and thus are
+allowed as delimiters: '\<SP>', '\%', '\|', '\^', '\{', '\}', '\'',
+'\`', '\-', '\_', '\!', '\?', '\)', '\/', '\,', '\&', '\:', '\~', '\0',
+'\a', '\c', '\d', '\e', '\E', '\p', '\r', '\t', and '\u'.  However,
+using them this way is discouraged; they can make the input confusing to
+read.
+
+   A few escape sequences, '\A', '\b', '\o', '\w', '\X', and '\Z',
+accept a newline as a delimiter.  Newlines that serve as delimiters
+continue to be recognized as input line terminators.
+
+     A caf\o
+     e\(aa
+     in Paris
+         => A café in Paris
+
+Use of newlines as delimiters in escape sequences is also discouraged.
+
+   Finally, the escape sequences '\D', '\h', '\H', '\l', '\L', '\N',
+'\R', '\s', '\S', '\v', and '\x' prohibit many delimiters.
+
+   * the numerals '0'-'9' and the decimal point '.'
+
+   * the (single-character) operators '+-/*%<>=&:()'
+
+   * the space and tab characters
+
+   * any escape sequences other than '\%', '\:', '\{', '\}', '\'', '\`',
+     '\-', '\_', '\!', '\/', '\c', '\e', and '\p'
+
+   Delimiter syntax is complex and flexible primarily for historical
+reasons; the foregoing restrictions need be kept in mind mainly when
+using 'groff' in AT&T compatibility mode.  GNU 'troff' keeps track of
+the nesting depth of escape sequence interpolations, so the only
+characters you need to avoid using as delimiters are those that appear
+in the arguments you input, not any that result from interpolation.
+Typically, ''' works fine.  *Note Implementation Differences::.
+
+     $ groff -Tps
+     .de Mw
+     .  nr wd \w'\\$1'
+     .  tm "\\$1" is \\n(wd units wide.
+     ..
+     .Mw Wet'suwet'en
+     .Mw Wet+200i
+     .cp 1 \" turn on compatibility mode
+     .Mw Wet'suwet'en
+     .Mw Wet'
+     .Mw Wet+200i
+         error-> "Wet'suwet'en" is 54740 units wide.
+         error-> "Wet'+200i" is 42610 units wide.
+         error-> "Wet'suwet'en" is 15860 units wide.
+         error-> "Wet'" is 15860 units wide.
+         error-> "Wet'+200i" is 14415860 units wide.
+
+   We see here that in compatibility mode, the part of the argument
+after the ''' delimiter escapes from its context and, if nefariously
+crafted, influences the computation of the WD register's value in a
+surprising way.
+
+5.7 Comments
+============
+
+One of the most common forms of escape sequence is the comment.(1)
+(*note Comments-Footnote-1::)
+
+ -- Escape sequence: \"
+     Start a comment.  Everything up to the next newline is ignored.
+
+     This may sound simple, but it can be tricky to keep the comments
+     from interfering with the appearance of the output.  If the escape
+     sequence is to the right of some text or a request, that portion of
+     the line is ignored, but spaces preceding it are processed normally
+     by GNU 'troff'.  This affects only the 'ds' and 'as' requests and
+     their variants.
+
+     One possibly irritating idiosyncrasy is that tabs should not be
+     used to vertically align comments in the source document.  Tab
+     characters are not treated as separators between a request name and
+     its first argument, nor between arguments.
+
+     A comment on a line by itself is treated as a blank line, because
+     after eliminating the comment, that is all that remains.
+
+          Test
+          \" comment
+          Test
+              => Test
+              =>
+              => Test
+
+     To avoid this, it is common to combine the empty request with the
+     comment escape sequence as '.\"', causing the input line to be
+     ignored.
+
+     Another commenting scheme sometimes seen is three consecutive
+     single quotes (''''') at the beginning of a line.  This works, but
+     GNU 'troff' emits a warning diagnostic (if enabled) about an
+     undefined macro (namely '''').
+
+ -- Escape sequence: \#
+     Start a comment; everything up to and including the next newline is
+     ignored.  This 'groff' extension was introduced to avoid the
+     problems described above.
+
+          Test
+          \# comment
+          Test
+              => Test Test
+
+ -- Request: .ig end
+     Ignore input until, in the current conditional block (if any),(2)
+     (*note Comments-Footnote-2::) the macro END is called at the start
+     of a control line, or the control line '..' is encountered if END
+     is not specified.  'ig' is parsed as if it were a macro definition,
+     but its contents are discarded, not stored.(3)  (*note
+     Comments-Footnote-3::)
+
+          hand\c
+          .de TX
+          fasting
+          ..
+          .ig TX
+          This is part of a large block of input that has been
+          temporarily(?) commented out.
+          We can restore it simply by removing the .ig request and
+          the call of its end macro.
+          .TX
+              => handfasting
+
+   (1) This claim may be more aspirational than descriptive.
+
+   (2) *Note Conditional Blocks::.
+
+   (3) Exception: auto-incrementing registers defined outside the
+ignored region _will_ be modified if interpolated with '\n±' inside it.
+*Note Auto-increment::.
+
+5.8 Registers
+=============
+
+In the 'roff' language, numbers can be stored in "registers".  Many
+built-in registers exist, supplying anything from the date to details of
+formatting parameters.  You can also define your own.  *Note
+Identifiers::, for information on constructing a valid name for a
+register.
+
+5.8.1 Setting Registers
+-----------------------
+
+Define registers and update their values with the 'nr' request or the
+'\R' escape sequence.
+
+ -- Request: .nr ident value
+ -- Escape sequence: \R'ident value'
+     Set register IDENT to VALUE.  If IDENT doesn't exist, GNU 'troff'
+     creates it.  In the '\R' escape sequence, the delimiter need not be
+     a neutral apostrophe; see *note Delimiters::.  It also does not
+     produce an input token in GNU 'troff'.  *Note Gtroff Internals::.
+
+          .nr a (((17 + (3 * 4))) % 4)
+          \na
+          .\R'a (((17 + (3 * 4))) % 4)'
+          \na
+              => 1 1
+
+     (Later, we will discuss additional forms of 'nr' and '\R' that can
+     change a register's value after it is dereferenced but before it is
+     interpolated.  *Note Auto-increment::.)
+
+     The complete transparency of '\R' can cause surprising effects if
+     you use registers like '.k', which get evaluated at the time they
+     are accessed.
+
+          .ll 1.6i
+          .
+          aaa bbb ccc ddd eee fff ggg hhh\R':k \n.k'
+          .tm :k == \n:k
+              => :k == 126950
+          .
+          .br
+          .
+          aaa bbb ccc ddd eee fff ggg hhh\h'0'\R':k \n.k'
+          .tm :k == \n:k
+              => :k == 15000
+
+     If you process this with the PostScript device ('-Tps'), there will
+     be a line break eventually after 'ggg' in both input lines.
+     However, after processing the space after 'ggg', the partially
+     collected line is not overfull yet, so GNU 'troff' continues to
+     collect input until it sees the space (or in this case, the
+     newline) after 'hhh'.  At this point, the line is longer than the
+     line length, and the line gets broken.
+
+     In the first input line, since the '\R' escape sequence leaves no
+     traces, the check for the overfull line hasn't been done yet at the
+     point where '\R' gets handled, and you get a value for the '.k'
+     register that is even greater than the current line length.
+
+     In the second input line, the insertion of '\h'0'' to cause a
+     zero-width motion forces GNU 'troff' to check the line length,
+     which in turn causes the start of a new output line.  Now '.k'
+     returns the expected value.
+
+   'nr' and '\R' each have two additional special forms to increment or
+decrement a register.
+
+ -- Request: .nr ident +value
+ -- Request: .nr ident -value
+ -- Escape sequence: \R'ident +value'
+ -- Escape sequence: \R'ident -value'
+     Increment (decrement) register IDENT by VALUE.  In the '\R' escape
+     sequence, the delimiter need not be a neutral apostrophe; see *note
+     Delimiters::.
+
+          .nr a 1
+          .nr a +1
+          \na
+              => 2
+
+     A leading minus sign in VALUE is always interpreted as a
+     decrementation operator, not an algebraic sign.  To assign a
+     register a negative value or the negated value of another register,
+     you can force GNU 'troff' to interpret '-' as a negation or minus,
+     rather than decrementation, operator: enclose it with its operand
+     in parentheses or subtract it from zero.
+
+          .nr a 7
+          .nr b 3
+          .nr a -\nb
+          \na
+              => 4
+          .nr a (-\nb)
+          \na
+              => -3
+          .nr a 0-\nb
+          \na
+              => -3
+
+     If a register's prior value does not exist (the register was
+     undefined), an increment or decrement is applied as if to 0.
+
+ -- Request: .rr ident
+     Remove register IDENT.  If IDENT doesn't exist, the request is
+     ignored.  Technically, only the name is removed; the register's
+     contents are still accessible under aliases created with 'aln', if
+     any.
+
+ -- Request: .rnn ident1 ident2
+     Rename register IDENT1 to IDENT2.  If IDENT1 doesn't exist, the
+     request is ignored.  Renaming a built-in register does not
+     otherwise alter its properties.
+
+ -- Request: .aln new old
+     Create an alias NEW for an existing register OLD, causing the names
+     to refer to the same stored object.  If OLD is undefined, a warning
+     in category 'reg' is produced and the request is ignored.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.
+
+     To remove a register alias, invoke 'rr' on its name.  A register's
+     contents do not become inaccessible until it has no more names.
+
+5.8.2 Interpolating Registers
+-----------------------------
+
+Register contents are interpolated with the '\n' escape sequence.
+
+ -- Escape sequence: \ni
+ -- Escape sequence: \n(id
+ -- Escape sequence: \nident
+     Interpolate register with name IDENT (one-character name I,
+     two-character name ID).  '\n' is interpreted even in copy mode
+     (*note Copy Mode::).  If the register is undefined, it is created
+     and assigned a value of '0', that value is interpolated, and a
+     warning in category 'reg' is emitted.  *Note Warnings::, for
+     information about the enablement and suppression of warnings.
+
+          .nr a 5
+          .nr as \na+\na
+          \n(as
+              => 10
+
+          .nr a1 5
+          .nr ab 6
+          .ds str b
+          .ds num 1
+          \na\nnum
+              => 5
+          \na\*str
+              => 6
+
+5.8.3 Auto-increment
+--------------------
+
+Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.  The value of the increment is
+specified with a third argument to the 'nr' request, and a special
+interpolation syntax is used to alter and then retrieve the register's
+value.  Together, these features are called "auto-increment".(1)  (*note
+Auto-increment-Footnote-1::)
+
+ -- Request: .nr ident value incr
+     Set register IDENT to VALUE and its auto-incrementation amount to
+     to INCR.  The '\R' escape sequence doesn't support an INCR
+     argument.
+
+   Auto-incrementation is not _completely_ automatic; the '\n' escape
+sequence in its basic form never alters the value of a register.  To
+apply auto-incrementation to a register, interpolate it with '\n±'.
+
+ -- Escape sequence: \n+i
+ -- Escape sequence: \n-i
+ -- Escape sequence: \n+(id
+ -- Escape sequence: \n-(id
+ -- Escape sequence: \n+ident
+ -- Escape sequence: \n-ident
+     Increment or decrement IDENT (one-character name I, two-character
+     name ID) by the register's auto-incrementation value and then
+     interpolate the new register value.  If IDENT has no
+     auto-incrementation value, interpolate as with '\n'.
+
+     .nr a 0 1
+     .nr xx 0 5
+     .nr foo 0 -2
+     \n+a, \n+a, \n+a, \n+a, \n+a
+     .br
+     \n-(xx, \n-(xx, \n-(xx, \n-(xx, \n-(xx
+     .br
+     \n+foo, \n+foo, \n+foo, \n+foo, \n+foo
+         => 1, 2, 3, 4, 5
+         => -5, -10, -15, -20, -25
+         => -2, -4, -6, -8, -10
+
+   To change the increment value without changing the value of a
+register, assign the register's value to itself by interpolating it, and
+specify the desired increment normally.  Apply an increment of '0' to
+disable auto-incrementation of the register.
+
+   (1) A negative auto-increment can be considered an "auto-decrement".
+
+5.8.4 Assigning Register Formats
+--------------------------------
+
+A writable register's value can be interpolated in several number
+formats.  By default, conventional Arabic numerals are used.  Other
+formats see use in sectioning and outlining schemes and alternative page
+numbering arrangements.
+
+ -- Request: .af reg fmt
+     Use number format FMT when interpolating register REG.  Valid
+     number formats are as follows.
+
+     '0...'
+          Arabic numerals 0, 1, 2, and so on.  Any decimal digit is
+          equivalent to '0'; the formatter merely counts the digits
+          specified.  Multiple Arabic numerals in FMT cause
+          interpolations to be zero-padded on the left if necessary to
+          at least as many digits as specified (interpolations never
+          truncate a register value).  A register with format '00'
+          interpolates values 1, 2, 3 as '01', '02', '03'.  The default
+          format for all writable registers is '0'.
+
+     'I'
+          Uppercase Roman numerals: 0, I, II, III, IV, ...
+
+     'i'
+          Lowercase Roman numerals: 0, i, ii, iii, iv, ...
+
+     'A'
+          Uppercase letters: 0, A, B, C, ..., Z, AA, AB, ...
+
+     'a'
+          Lowercase letters: 0, a, b, c, ..., z, aa, ab, ...
+
+     Omitting FMT causes a warning in category 'missing'.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.  Specifying an unrecognized format is an error.
+
+     Zero values are interpolated as '0' in non-Arabic formats.
+     Negative quantities are prefixed with '-' irrespective of format.
+     In Arabic formats, the sign supplements the field width.  If REG
+     doesn't exist, it is created with a zero value.
+
+          .nr a 10
+          .af a 0           \" the default format
+          \na,
+          .af a I
+          \na,
+          .af a 321
+          .nr a (-\na)
+          \na,
+          .af a a
+          \na
+              => 10, X, -010, -j
+
+     The representable extrema in the 'i' and 'I' formats correspond to
+     Arabic ±39,999.  GNU 'troff' uses 'w' and 'z' to represent 5,000
+     and 10,000 in Roman numerals, respectively, following the
+     convention of AT&T 'troff'--currently, the correct glyphs for Roman
+     numerals five thousand ('U+2181') and ten thousand ('U+2182') are
+     not used.
+
+     Assigning the format of a read-only register is an error.  Instead,
+     copy the read-only register's value to, and assign the format of, a
+     writable register.
+
+ -- Escape sequence: \gr
+ -- Escape sequence: \g(rg
+ -- Escape sequence: \greg
+     Interpolate the format of the register REG (one-character name R,
+     two-character name RG).  Zeroes represent Arabic formats.  If REG
+     is not defined, REG is not created and nothing is interpolated.
+     '\g' is interpreted even in copy mode (*note Copy Mode::).
+
+   GNU 'troff' interprets only Arabic numerals.  The Roman numeral or
+alphabetic formats cannot be used as operands to arithmetic operators in
+expressions (*note Numeric Expressions::).  For instance, it may be
+desirable to test the page number independently of its format.
+
+     .af % i \" front matter
+     .de header-trap
+     .  \" To test the page number, we need it in Arabic.
+     .  ds saved-page-number-format \\g%\"
+     .  af % 0
+     .  nr page-number-in-decimal \\n%
+     .  af % \\*saved-page-number-format
+     .  ie \\npage-number-in-decimal=1 .do-first-page-stuff
+     .  el \{\
+     .    ie o .do-odd-numbered-page-stuff
+     .    el   .do-even-numbered-page-stuff
+     .  \}
+     .  rm saved-page-number-format
+     ..
+     .wh 0 header-trap
+
+5.8.5 Built-in Registers
+------------------------
+
+Predefined registers whose identifiers start with a dot are read-only.
+Many are Boolean-valued, interpolating a true or false value testable
+with the 'if', 'ie', or 'while' requests.  Some read-only registers are
+string-valued, meaning that they interpolate text.
+
+   *Caution:* Built-in registers are subject to removal like others;
+once removed, they can be recreated only as normal writable registers
+and will not reflect formatter state.
+
+   A register name (without the dot) is often associated with a request
+of the same name.  A complete listing of all built-in registers can be
+found in *note Register Index::.
+
+   We present here a few built-in registers that are not described
+elsewhere in this manual; they have to do with invariant properties of
+GNU 'troff', or obtain information about the formatter's command-line
+options, processing progress, or the operating environment.
+
+'\n.A'
+     Approximate output is being formatted (Boolean-valued); see 'groff'
+     '-a' option (*note Groff Options::).
+
+'\n.c'
+'\nc.'
+     Input line number.  'c.' is a writable synonym, affecting
+     subsequent interpolations of both '.c' and 'c.'.
+
+'\n.F'
+     Name of input file (string-valued).
+
+'\n.g'
+     Always true in GNU 'troff' (Boolean-valued).  Documents can use
+     this to ask the formatter if it claims 'groff' compatibility.
+
+'\n.P'
+     Output page selection status (Boolean-valued); see 'groff' '-o'
+     option (*note Groff Options::).
+
+'\n.R'
+     Count of available unused registers; always 10,000 in GNU
+     'troff'.(1)  (*note Built-in Registers-Footnote-1::)
+
+'\n.T'
+     Indicator of output device selection (Boolean-valued); see 'groff'
+     '-T' option (*note Groff Options::).
+
+'\n.U'
+     Unsafe mode enablement status (Boolean-valued); see 'groff' '-U'
+     option (*note Groff Options::).
+
+'\n.x'
+     Major version number of the running GNU 'troff' formatter.  For
+     example, if the version number is 1.23.0, then '.x' contains '1'.
+
+'\n.y'
+     Minor version number of the running GNU 'troff' formatter.  For
+     example, if the version number is 1.23.0, then '.y' contains '23'.
+
+'\n.Y'
+     Revision number of the running GNU 'troff' formatter.  For example,
+     if the version number is 1.23.0, then '.Y' contains '0'.
+
+'\n$$'
+     Process identifier (PID) of the GNU 'troff' program in its
+     operating environment.
+
+   Date- and time-related registers are set per the local time as
+determined by 'localtime(3)' when the formatter launches.  This
+initialization can be overridden by 'SOURCE_DATE_EPOCH' and 'TZ'; see
+*note Environment::.
+
+'\nseconds'
+     Count of seconds elapsed in the minute (0-60).
+
+'\nminutes'
+     Count of minutes elapsed in the hour (0-59).
+
+'\nhours'
+     Count of hours elapsed since midnight (0-23).
+
+'\ndw'
+     Day of the week (1-7; 1 is Sunday).
+
+'\ndy'
+     Day of the month (1-31).
+
+'\nmo'
+     Month of the year (1-12).
+
+'\nyear'
+     Gregorian year.
+
+'\nyr'
+     Gregorian year minus 1900.  This register is incorrectly documented
+     in the AT&T 'troff' manual as storing the last two digits of the
+     current year.  That claim stopped being true in 2000.  Old 'troff'
+     input that looks like:
+
+          '\" The year number is a surprise after 1999.
+          This document was formatted in 19\n(yr.
+
+     can be corrected to:
+
+          This document was formatted in \nyear.
+
+     or, for portability across many 'roff' programs, to the following.
+
+          .nr y4 1900+\n(yr
+          This document was formatted in \n(y4.
+
+   (1) GNU 'troff' dynamically allocates memory for as many registers as
+required.
+
+5.9 Manipulating Filling and Adjustment
+=======================================
+
+When an output line is pending (see below), a break moves the drawing
+position to the beginning of the next text baseline, interrupting
+filling.  Various ways of causing breaks were shown in *note Breaking::.
+The 'br' request likewise causes a break.  Several other requests imply
+breaks: 'bp', 'ce', 'cf', 'fi', 'fl', 'in', 'nf', 'rj', 'sp', 'ti', and
+'trf'.  If the no-break control character is used with any of these
+requests, GNU 'troff' suppresses the break; instead the requested
+operation takes effect at the next break.  ''br' does nothing.
+
+     .ll 55n
+     This line is normally filled and adjusted.
+     .br
+     A line's alignment is decided
+     'ce \" Center the next input line (no break).
+     when it is output.
+     This line returns to normal filling and adjustment.
+         => This line is normally filled and adjusted.
+         =>    A line's alignment is decided when it is output.
+         => This line returns to normal filling and adjustment.
+
+Output line properties like page offset, indentation, adjustment, and
+even the location of its text baseline, are not determined until the
+line has been broken.  An output line is said to be "pending" if some
+input has been collected but an output line corresponding to it has not
+yet been written; such an output line is also termed "partially
+collected".  If no output line is pending, it is as if a break has
+already happened; additional breaks, whether explicit or implicit, have
+no effect.  If the vertical drawing position is negative--as it is when
+the formatter starts up--a break starts a new page (even if no output
+line is pending) unless an end-of-input macro is being interpreted.
+*Note End-of-input Traps::.
+
+ -- Request: .br
+     Break the line: emit any pending output line without adjustment.
+
+          foo bar
+          .br
+          baz
+          'br
+          qux
+              => foo bar
+              => baz qux
+
+   Sometimes you want to prevent a break within a phrase or between a
+quantity and its units.
+
+ -- Escape sequence: \~
+     Insert an unbreakable space that is adjustable like an ordinary
+     space.  It is discarded from the end of an output line if a break
+     is forced.
+
+          Set the output speed to\~1.
+          There are 1,024\~bytes in 1\~KiB.
+          J.\~F.\~Ossanna wrote the original CSTR\~#54.
+
+   By default, GNU 'troff' fills text and adjusts it to reach the output
+line length.  The 'nf' request disables filling; the 'fi' request
+reënables it.
+
+ -- Request: .fi
+ -- Register: \n.u
+     Enable filling of output lines; a pending output line is broken.
+     The read-only register '.u' is set to 1.  The filling enablement
+     status, sometimes called "fill mode", is associated with the
+     environment (*note Environments::).  *Note Line Continuation::, for
+     interaction with the '\c' escape sequence.
+
+ -- Request: .nf
+     Disable filling of output lines: the output line length (*note Line
+     Layout::) is ignored and output lines are broken where the input
+     lines are.  A pending output line is broken and adjustment is
+     suppressed.  The read-only register '.u' is set to 0.  The filling
+     enablement status is associated with the environment (*note
+     Environments::).  See *note Line Continuation::, for interaction
+     with the '\c' escape sequence.
+
+ -- Request: .ad mode
+ -- Register: \n.j
+     Enable output line adjustment in MODE, taking effect when the
+     pending (or next) output line is broken.  Adjustment is suppressed
+     when filling is.  MODE can have one of the following values.
+
+     'b'
+     'n'
+          Adjust "normally": if the output line does not consume the
+          distance between the indentation and the configured output
+          line length, GNU 'troff' stretches adjustable spaces within
+          the line until that length is reached.  When the indentation
+          is zero, this mode spreads the line to both the left and right
+          margins.  This is the GNU 'troff' default.
+
+     'c'
+          Center filled text.  Contrast with the 'ce' request, which
+          centers text _without_ filling it.
+
+     'l'
+          Align text to the left without adjusting it.
+
+     'r'
+          Align text to the right without adjusting it.
+
+     MODE can also be a value previously stored in the '.j' register.
+     Using 'ad' without an argument is the same as '.ad \n.j'; unless
+     filling is disabled, GNU 'troff' resumes adjusting lines in the
+     same way it did before adjustment was disabled by invocation of the
+     'na' request.
+
+     The adjustment mode and enablement status are encoded in the
+     read-only register '.j'.  These parameters are associated with the
+     environment (*note Environments::).
+
+     The value of '.j' for any adjustment mode is an implementation
+     detail and should not be relied upon as a programmer's interface.
+     Do not write logic to interpret or perform arithmetic on it.
+
+          .ll 48n
+          .de AD
+          .  br
+          .  ad \\$1
+          ..
+          .de NA
+          .  br
+          .  na
+          ..
+          left
+          .AD r
+          .nr ad \n(.j
+          right
+          .AD c
+          center
+          .NA
+          left
+          .AD
+          center
+          .AD \n(ad
+          right
+              => left
+              =>                                            right
+              =>                      center
+              => left
+              =>                      center
+              =>                                            right
+
+ -- Request: .na
+     Disable output line adjustment.  This produces the same output as
+     left-alignment, but the value of the adjustment mode register '.j'
+     is altered differently.  The adjustment mode and enablement status
+     are associated with the environment (*note Environments::).
+
+ -- Request: .brp
+ -- Escape sequence: \p
+     Break, adjusting the line per the current adjustment mode.  '\p'
+     schedules a break with adjustment at the next word boundary.  The
+     escape sequence is itself neither a break nor a space of any kind;
+     it can thus be placed in the middle of a word to cause a break at
+     the end of that word.
+
+     Breaking with immediate adjustment can produce ugly results since
+     GNU 'troff' doesn't have a sophisticated paragraph-building
+     algorithm, as TeX has, for example.  Instead, GNU 'troff' fills and
+     adjusts a paragraph line by line.
+
+          .ll 4.5i
+          This is an uninteresting sentence.
+          This is an uninteresting sentence.\p
+          This is an uninteresting sentence.
+
+     is formatted as follows.
+
+          This  is  an uninteresting sentence.  This is
+          an          uninteresting           sentence.
+          This is an uninteresting sentence.
+
+   To clearly present the next couple of requests, we must introduce the
+concept of "productive" input lines.  A "productive input line" is one
+that directly produces formatted output.  Text lines produce output,(1)
+(*note Manipulating Filling and Adjustment-Footnote-1::) as do control
+lines containing requests like 'tl' or escape sequences like '\D'.
+Macro calls are not _directly_ productive, and thus not counted, but
+their interpolated contents can be.  Empty requests, and requests and
+escape sequences that define registers or strings or alter the
+formatting environment (as with changes to the size, face, height,
+slant, or color of the type) are not productive.  We will also preview
+the output line continuation escape sequence, '\c', which "connects" two
+input lines that would otherwise be counted separately.  (2)  (*note
+Manipulating Filling and Adjustment-Footnote-2::)
+
+     .de hello
+     Hello, world!
+     ..
+     .ce \" center output of next productive input line
+     .
+     .nr junk-reg 1
+     .ft I
+     Chorus: \c
+     .ft
+     .hello
+     Went the day well?
+       =>                  Chorus: Hello, world!
+       => Went the day well?
+
+ -- Request: .ce n
+ -- Register: \n.ce
+     Break (unless the no-break control character is used), center the
+     output of the next N productive input lines with respect to the
+     line length and indentation without filling, then break again
+     regardless of the invoking control character.  If the argument is
+     not positive, centering is disabled.  Omitting the argument implies
+     an N of '1'.  The count of lines remaining to be centered is stored
+     in the read-only register '.ce' and is associated with the
+     environment (*note Environments::).
+
+     While the '.ad c' request also centers text, it fills the text as
+     well.
+
+          .de FR
+          This is a small text fragment that shows the differences
+          between the `.ce' and the `.ad c' requests.
+          ..
+          .ll 4i
+          .ce 1000
+          .FR
+          .ce 0
+
+          .ad c
+          .FR
+              => This is a small text fragment that shows
+              =>              the differences
+              => between the `.ce' and the `.ad c' requests.
+              =>
+              => This is a small text fragment that shows
+              =>  the differences between the `.ce' and
+              =>         the `.ad c' requests.
+
+     The previous example illustrates a common idiom of turning
+     centering on for a quantity of lines far in excess of what is
+     required, and off again after the text to be centered.  This
+     technique relieves humans of counting lines for requests that take
+     a count of input lines as an argument.
+
+ -- Request: .rj n
+ -- Register: \n.rj
+     Break (unless the no-break control character is used), align the
+     output of the next N productive input lines to the right margin
+     without filling, then break again regardless of the control
+     character.  If the argument is not positive, right-alignment is
+     disabled.  Omitting the argument implies an N of '1'.  The count of
+     lines remaining to be right-aligned is stored in the read-only
+     register '.rj' and is associated with the environment (*note
+     Environments::).
+
+          .ll 49n
+          .rj 3
+          At first I hoped that such a technically unsound
+          project would collapse but I soon realized it was
+          doomed to success. \em C. A. R. Hoare
+              =>  At first I hoped that such a technically unsound
+              => project would collapse but I soon realized it was
+              =>              doomed to success. -- C. A. R. Hoare
+
+ -- Request: .ss word-space-size additional-sentence-space-size
+ -- Register: \n.ss
+ -- Register: \n.sss
+     Set the sizes of spaces between words and sentences(3) (*note
+     Manipulating Filling and Adjustment-Footnote-3::) in twelfths of
+     font's space width (typically one-fourth to one-third em for
+     Western scripts).  The default for both parameters is 12.  Negative
+     values are erroneous.  The first argument is a minimum; if an
+     output line undergoes adjustment, such spaces may increase in
+     width.  The optional second argument sets the amount of additional
+     space separating sentences on the same output line.  If omitted,
+     this amount is set to WORD-SPACE-SIZE.  The request is ignored if
+     there are no parameters.
+
+     Additional inter-sentence space is used only if the output line is
+     not full when the end of a sentence occurs in the input.  If a
+     sentence ends at the end of an input line, then both an inter-word
+     space and an inter-sentence space are added to the output; if two
+     spaces follow the end of a sentence in the middle of an input line,
+     then the second space becomes an inter-sentence space in the
+     output.  Additional inter-sentence space is not adjusted, but the
+     inter-word space that always precedes it may be.  Further input
+     spaces after the second, if present, are adjusted as normal.
+
+     The read-only registers '.ss' and '.sss' hold the minimal
+     inter-word space and additional inter-sentence space amounts,
+     respectively.  These parameters are part of the environment (*note
+     Environments::), and rounded down to the nearest multiple of 12 on
+     terminals.
+
+     The 'ss' request can insert discardable horizontal space; that is,
+     space that is discarded at a break.  For example, some footnote
+     styles collect the notes into a single paragraph with large gaps
+     between each note.
+
+          .ll 48n
+          1.\~J. Fict. Ch. Soc. 6 (2020), 3\en14.
+          .ss 12 48 \" applies to next sentence ending
+          Reprints no longer available through FCS.
+          .ss 12 \" go back to normal
+          2.\~Better known for other work.
+              => 1.  J.  Fict. Ch. Soc. 6 (2020), 3-14.  Reprints
+              => no longer available through FCS.      2.  Better
+              => known for other work.
+
+     If _undiscardable_ space is required, use the '\h' escape sequence.
+
+   (1) unless diverted; see *note Diversions::
+
+   (2) *Note Line Continuation::.
+
+   (3) Recall *note Filling:: and *note Sentences:: for the definitions
+of word and sentence boundaries, respectively.
+
+5.10 Manipulating Hyphenation
+=============================
+
+When filling, GNU 'troff' hyphenates words as needed at user-specified
+and automatically determined hyphenation points.  The machine-driven
+determination of hyphenation points in words requires algorithms and
+data, and is susceptible to conventions and preferences.  Before
+tackling such "automatic hyphenation", let us consider how hyphenation
+points can be set explicitly.
+
+   Explicitly hyphenated words such as "mother-in-law" are eligible for
+breaking after each of their hyphens.  Relatively few words in a
+language offer such obvious break points, however, and automatic
+detection of syllabic (or phonetic) boundaries for hyphenation is not
+perfect,(1) (*note Manipulating Hyphenation-Footnote-1::) particularly
+for unusual words found in technical literature.  We can instruct GNU
+'troff' how to hyphenate specific words if the need arises.
+
+ -- Request: .hw word ...
+     Define each "hyphenation exception" WORD with each hyphen '-' in
+     the word indicating a hyphenation point.  For example, the request
+
+          .hw in-sa-lub-rious alpha
+
+     marks potential hyphenation points in "insalubrious", and prevents
+     "alpha" from being hyphenated at all.
+
+     Besides the space character, any character whose hyphenation code
+     is zero can be used to separate the arguments of 'hw' (see the
+     'hcode' request below).  In addition, this request can be used more
+     than once.
+
+     Hyphenation points specified with 'hw' are not subject to the
+     within-word placement restrictions imposed by the 'hy' request (see
+     below).
+
+     Hyphenation exceptions specified with the 'hw' request are
+     associated with the hyphenation language (see the 'hla' request
+     below) and environment (*note Environments::); invoking the 'hw'
+     request in the absence of a hyphenation language is an error.
+
+     The request is ignored if there are no parameters.
+
+   These are known as hyphenation exceptions in the expectation that
+most users will avail themselves of automatic hyphenation; these
+exceptions override any rules that would normally apply to a word
+matching a hyphenation exception defined with 'hw'.
+
+   Situations also arise when only a specific occurrence of a word needs
+its hyphenation altered or suppressed, or when a URL or similar string
+needs to be breakable in sensible places without hyphenation.
+
+ -- Escape sequence: \%
+ -- Escape sequence: \:
+     To tell GNU 'troff' how to hyphenate words as they occur in input,
+     use the '\%' escape sequence; it is the default "hyphenation
+     character".  Each instance within a word indicates to GNU 'troff'
+     that the word may be hyphenated at that point, while prefixing a
+     word with this escape sequence prevents it from being otherwise
+     hyphenated.  This mechanism affects only that occurrence of the
+     word; to change the hyphenation of a word for the remainder of
+     input processing, use the 'hw' request.
+
+     GNU 'troff' regards the escape sequences '\X' and '\Y' as starting
+     a word; that is, the '\%' escape sequence in, say,
+     '\X'...'\%foobar' or '\Y'...'\%foobar' no longer prevents
+     hyphenation of 'foobar' but inserts a hyphenation point just prior
+     to it; most likely this isn't what you want.  *Note Postprocessor
+     Access::.
+
+     '\:' inserts a non-printing break point; that is, a word can break
+     there, but the soft hyphen glyph (see below) is not written to the
+     output if it does.  This escape sequence is an input word boundary,
+     so the remainder of the word is subject to hyphenation as normal.
+
+     You can combine '\:' and '\%' to control breaking of a file name or
+     URL, or to permit hyphenation only after certain explicit hyphens
+     within a word.
+
+          The \%Lethbridge-Stewart-\:\%Sackville-Baggins divorce
+          was, in retrospect, inevitable once the contents of
+          \%/var/log/\:\%httpd/\:\%access_log on the family web
+          server came to light, revealing visitors from Hogwarts.
+
+ -- Request: .hc char
+     Change the hyphenation character to CHAR.  This character then
+     works as the '\%' escape sequence normally does, and thus no longer
+     appears in the output.(2)  (*note Manipulating
+     Hyphenation-Footnote-2::) Without an argument, 'hc' resets the
+     hyphenation character to '\%' (the default).  The hyphenation
+     character is associated with the environment (*note
+     Environments::).
+
+ -- Request: .shc c
+     Set the "soft hyphen character", inserted when a word is hyphenated
+     automatically or at a hyphenation character, to the ordinary or
+     special character C.(3)  (*note Manipulating
+     Hyphenation-Footnote-3::) If the argument is omitted, the soft
+     hyphen character is set to the default, '\hy'.  If no glyph for C
+     exists in the font in use at a potential hyphenation point, then
+     the line is not broken there.  Neither character definitions
+     (specified with the 'char' and similar requests) nor translations
+     (specified with the 'tr' request) are applied to C.
+
+   Several requests influence automatic hyphenation.  Because
+conventions vary, a variety of hyphenation modes is available to the
+'hy' request; these determine whether hyphenation will apply to a word
+prior to breaking a line at the end of a page (more or less; see below
+for details), and at which positions within that word automatically
+determined hyphenation points are permissible.  The places within a word
+that are eligible for hyphenation are determined by language-specific
+data and lettercase relationships.  Furthermore, hyphenation of a word
+might be suppressed due to a limit on consecutive hyphenated lines
+('hlm'), a minimum line length threshold ('hym'), or because the line
+can instead be adjusted with additional inter-word space ('hys').
+
+ -- Request: .hy mode
+ -- Register: \n.hy
+     Set automatic hyphenation mode to MODE, an integer encoding
+     conditions for hyphenation; if omitted, '1' is implied.  The
+     hyphenation mode is available in the read-only register '.hy'; it
+     is associated with the environment (*note Environments::).  The
+     default hyphenation mode depends on the localization file loaded
+     when GNU 'troff' starts up; see the 'hpf' request below.
+
+     Typesetting practice generally does not avail itself of every
+     opportunity for hyphenation, but the details differ by language and
+     site mandates.  The hyphenation modes of AT&T 'troff' were
+     implemented with English-language publishing practices of the 1970s
+     in mind, not a scrupulous enumeration of conceivable parameters.
+     GNU 'troff' extends those modes such that finer-grained control is
+     possible, favoring compatibility with older implementations over a
+     more intuitive arrangement.  The means of hyphenation mode control
+     is a set of numbers that can be added up to encode the behavior
+     sought.(4)  (*note Manipulating Hyphenation-Footnote-4::) The
+     entries in the following table are termed "values"; the sum of the
+     desired values is the "mode".
+
+     '0'
+          disables hyphenation.
+
+     '1'
+          enables hyphenation except after the first and before the last
+          character of a word.
+
+     The remaining values "imply" 1; that is, they enable hyphenation
+     under the same conditions as '.hy 1', and then apply or lift
+     restrictions relative to that basis.
+
+     '2'
+          disables hyphenation of the last word on a page,(5) (*note
+          Manipulating Hyphenation-Footnote-5::) even for explicitly
+          hyphenated words.
+
+     '4'
+          disables hyphenation before the last two characters of a word.
+
+     '8'
+          disables hyphenation after the first two characters of a word.
+
+     '16'
+          enables hyphenation before the last character of a word.
+
+     '32'
+          enables hyphenation after the first character of a word.
+
+     Apart from value 2, restrictions imposed by the hyphenation mode
+     are _not_ respected for words whose hyphenations have been
+     specified with the hyphenation character ('\%' by default) or the
+     'hw' request.
+
+     Nonzero values in the previous table are additive.  For example,
+     mode 12 causes GNU 'troff' to hyphenate neither the last two nor
+     the first two characters of a word.  Some values cannot be used
+     together because they contradict; for instance, values 4 and 16,
+     and values 8 and 32.  As noted, it is superfluous to add 1 to any
+     non-zero even mode.
+
+     The automatic placement of hyphens in words is determined by
+     "pattern files", which are derived from TeX and available for
+     several languages.  The number of characters at the beginning of a
+     word after which the first hyphenation point should be inserted is
+     determined by the patterns themselves; it can't be reduced further
+     without introducing additional, invalid hyphenation points
+     (unfortunately, this information is not part of a pattern file--you
+     have to know it in advance).  The same is true for the number of
+     characters at the end of a word before the last hyphenation point
+     should be inserted.  For example, you can supply the following
+     input to 'echo $(nroff)'.
+
+          .ll 1
+          .hy 48
+          splitting
+
+     You will get
+
+          s- plit- t- in- g
+
+     instead of the correct 'split- ting'.  English patterns as
+     distributed with GNU 'troff' need two characters at the beginning
+     and three characters at the end; this means that value 4 of 'hy' is
+     mandatory.  Value 8 is possible as an additional restriction, but
+     values 16 and 32 should be avoided, as should mode 1.  Modes 4
+     and 6 are typical.
+
+     A table of left and right minimum character counts for hyphenation
+     as needed by the patterns distributed with GNU 'troff' follows; see
+     the 'groff_tmac(5)' man page for more information on GNU 'troff''s
+     language macro files.
+
+     language             pattern name   left min   right min
+     -----------------------------------------------------------
+     Czech                cs             2          2
+     English              en             2          3
+     French               fr             2          3
+     German traditional   det            2          2
+     German reformed      den            2          2
+     Italian              it             2          2
+     Swedish              sv             1          2
+
+     Hyphenation exceptions within pattern files (i.e., the words within
+     a TeX '\hyphenation' group) obey the hyphenation restrictions given
+     by 'hy'.
+
+ -- Request: .nh
+     Disable automatic hyphenation; i.e., set the hyphenation mode to 0
+     (see above).  The hyphenation mode of the last call to 'hy' is not
+     remembered.
+
+ -- Request: .hpf pattern-file
+ -- Request: .hpfa pattern-file
+ -- Request: .hpfcode a b c d ...
+     Read hyphenation patterns from PATTERN-FILE, which is sought in the
+     same way that macro files are with the 'mso' request or the
+     '-mNAME' command-line option to 'groff'.  The PATTERN-FILE should
+     have the same format as (simple) TeX pattern files.  More
+     specifically, the following scanning rules are implemented.
+
+        * A percent sign starts a comment (up to the end of the line)
+          even if preceded by a backslash.
+
+        * "Digraphs" like '\$' are not supported.
+
+        * '^^XX' (where each X is 0-9 or a-f) and '^^C' (character C in
+          the code point range 0-127 decimal) are recognized; other uses
+          of '^' cause an error.
+
+        * No macro expansion is performed.
+
+        * 'hpf' checks for the expression '\patterns{...}' (possibly
+          with whitespace before or after the braces).  Everything
+          between the braces is taken as hyphenation patterns.
+          Consequently, '{' and '}' are not allowed in patterns.
+
+        * Similarly, '\hyphenation{...}' gives a list of hyphenation
+          exceptions.
+
+        * '\endinput' is recognized also.
+
+        * For backward compatibility, if '\patterns' is missing, the
+          whole file is treated as a list of hyphenation patterns
+          (except that the '%' character is recognized as the start of a
+          comment).
+
+     The 'hpfa' request appends a file of patterns to the current list.
+
+     The 'hpfcode' request defines mapping values for character codes in
+     pattern files.  It is an older mechanism no longer used by GNU
+     'troff''s own macro files; for its successor, see 'hcode' below.
+     'hpf' or 'hpfa' apply the mapping after reading the patterns but
+     before replacing or appending to the active list of patterns.  Its
+     arguments are pairs of character codes--integers from 0 to 255.
+     The request maps character code A to code B, code C to code D, and
+     so on.  Character codes that would otherwise be invalid in GNU
+     'troff' can be used.  By default, every code maps to itself except
+     those for letters 'A' to 'Z', which map to those for 'a' to 'z'.
+
+     The set of hyphenation patterns is associated with the language set
+     by the 'hla' request (see below).  The 'hpf' request is usually
+     invoked by a localization file loaded by the 'troffrc' file.(6)
+     (*note Manipulating Hyphenation-Footnote-6::)
+
+     A second call to 'hpf' (for the same language) replaces the
+     hyphenation patterns with the new ones.  Invoking 'hpf' or 'hpfa'
+     causes an error if there is no hyphenation language.  If no 'hpf'
+     request is specified (either in the document, in a file loaded at
+     startup, or in a macro package), GNU 'troff' won't automatically
+     hyphenate at all.
+
+ -- Request: .hcode c1 code1 c2 code2 ...
+     Set the hyphenation code of character C1 to CODE1, that of C2 to
+     CODE2, and so on.  A hyphenation code must be an ordinary character
+     (not a special character escape sequence) other than a digit or a
+     space.  The request is ignored if given no arguments.
+
+     For hyphenation to work, hyphenation codes must be set up.  At
+     startup, GNU 'troff' assigns hyphenation codes to the letters
+     'a'-'z' (mapped to themselves), to the letters 'A'-'Z' (mapped to
+     'a'-'z'), and zero to all other characters.  Normally, hyphenation
+     patterns contain only lowercase letters which should be applied
+     regardless of case.  In other words, they assume that the words
+     'FOO' and 'Foo' should be hyphenated exactly as 'foo' is.  The
+     'hcode' request extends this principle to letters outside the
+     Unicode basic Latin alphabet; without it, words containing such
+     letters won't be hyphenated properly even if the corresponding
+     hyphenation patterns contain them.
+
+     For example, the following 'hcode' requests are necessary to assign
+     hyphenation codes to the letters 'ÄäÖöÜüß', needed for German.
+
+          .hcode ä ä  Ä ä
+          .hcode ö ö  Ö ö
+          .hcode ü ü  Ü ü
+          .hcode ß ß
+
+     Without these assignments, GNU 'troff' treats the German word
+     'Kindergärten' (the plural form of 'kindergarten') as two words
+     'kinderg' and 'rten' because the hyphenation code of the umlaut a
+     is zero by default, just like a space.  There is a German
+     hyphenation pattern that covers 'kinder', so GNU 'troff' finds the
+     hyphenation 'kin-der'.  The other two hyphenation points
+     ('kin-der-gär-ten') are missed.
+
+ -- Request: .hla lang
+ -- Register: \n.hla
+     Set the hyphenation language to LANG.  Hyphenation exceptions
+     specified with the 'hw' request and hyphenation patterns and
+     exceptions specified with the 'hpf' and 'hpfa' requests are
+     associated with the hyphenation language.  The 'hla' request is
+     usually invoked by a localization file, which is turn loaded by the
+     'troffrc' or 'troffrc-end' file; see the 'hpf' request above.
+
+     The hyphenation language is available in the read-only
+     string-valued register '.hla'; it is associated with the
+     environment (*note Environments::).
+
+ -- Request: .hlm n
+ -- Register: \n.hlm
+ -- Register: \n.hlc
+     Set the maximum quantity of consecutive hyphenated lines to N.  If
+     N is negative, there is no maximum.  If omitted, N is -1.  This
+     value is associated with the environment (*note Environments::).
+     Only lines output from a given environment count toward the maximum
+     associated with that environment.  Hyphens resulting from '\%' are
+     counted; explicit hyphens are not.
+
+     The '.hlm' read-only register stores this maximum.  The count of
+     immediately preceding consecutive hyphenated lines is available in
+     the read-only register '.hlc'.
+
+ -- Request: .hym length
+ -- Register: \n.hym
+     Set the (right) hyphenation margin to LENGTH.  If the adjustment
+     mode is not 'b' or 'n', the line is not hyphenated if it is shorter
+     than LENGTH.  Without an argument, the hyphenation margin is reset
+     to its default value, 0.  The default scaling unit is 'm'.  The
+     hyphenation margin is associated with the environment (*note
+     Environments::).
+
+     A negative argument resets the hyphenation margin to zero, emitting
+     a warning in category 'range'.
+
+     The hyphenation margin is available in the '.hym' read-only
+     register.
+
+ -- Request: .hys hyphenation-space
+ -- Register: \n.hys
+     Suppress hyphenation of the line in adjustment modes 'b' or 'n' if
+     it can be justified by adding no more than HYPHENATION-SPACE extra
+     space to each inter-word space.  Without an argument, the
+     hyphenation space adjustment threshold is set to its default value,
+     0.  The default scaling unit is 'm'.  The hyphenation space
+     adjustment threshold is associated with the environment (*note
+     Environments::).
+
+     A negative argument resets the hyphenation space adjustment
+     threshold to zero, emitting a warning in category 'range'.
+
+     The hyphenation space adjustment threshold is available in the
+     '.hys' read-only register.
+
+   (1) Whether a perfect algorithm for this application is even possible
+is an unsolved problem in computer science:
+<https://tug.org/docs/liang/liang-thesis.pdf>.
+
+   (2) '\%' itself stops marking hyphenation points but still produces
+no output glyph.
+
+   (3) "Soft" because it appears in output only where a hyphenation
+break is performed; a "hard" hyphen, as in "long-term", always appears.
+
+   (4) The mode is a vector of Booleans encoded as an integer.  To a
+programmer, this fact is easily deduced from the exclusive use of powers
+of two for the configuration parameters; they are computationally easy
+to "mask off" and compare to zero.  To almost everyone else, the
+arrangement seems recondite and unfriendly.
+
+   (5) Hyphenation is prevented if the next page location trap is closer
+to the vertical drawing position than the next text baseline would be.
+*Note Page Location Traps::.
+
+   (6) For more on localization, see the 'groff_tmac(5)' man page.
+
+5.11 Manipulating Spacing
+=========================
+
+A break causes the formatter to update the vertical drawing position at
+which the new text baseline is aligned.  You can alter this location.
+
+ -- Request: .sp distance
+     Break and move the next text baseline down by DISTANCE, or until
+     springing a page location trap.(1)  (*note Manipulating
+     Spacing-Footnote-1::) If invoked with the no-break control
+     character, 'sp' moves the pending output line's text baseline by
+     DISTANCE.  A negative DISTANCE will not reduce the position of the
+     text baseline below zero.  Inside a diversion, any DISTANCE
+     argument is ignored.  The default scaling unit is 'v'.  If DISTANCE
+     is not specified, '1v' is assumed.
+
+          .pl 5v \" Set page length to 5 vees.
+          .de xx
+          \-\-\-
+          .  br
+          ..
+          .wh 0 xx \" Set a trap at the top of the page.
+          foo on page \n%
+          .sp 2v
+          bar on page \n%
+          .sp 50v \" This will cause a page break.
+          baz on page \n%
+          .pl \n(nlu \" Truncate page to current position.
+              => ---
+              => foo on page 1
+              =>
+              =>
+              => bar on page 1
+              => ---
+              => baz on page 2
+
+     You might use the following macros to set the baseline of the next
+     output text at a given distance from the top or the bottom of the
+     page.  We subtract one line height ('\n.v') because the '|'
+     operator moves to one vee below the page top (recall *note Numeric
+     Expressions::).
+
+          .de y-from-top-down
+          .  sp |\\$1-\\n.vu
+          ..
+          .
+          .de y-from-bot-up
+          .  sp |\\n.pu-\\$1-\\n.vu
+          ..
+
+     A call to '.y-from-bot-up 10c' means that the next text baseline
+     will be 10 cm from the bottom edge of the paper.
+
+ -- Request: .ls count
+ -- Register: \n.L
+     Set the line spacing; add COUNT-1 blank lines after each line of
+     text.  With no argument, GNU 'troff' uses the previous value before
+     the last 'ls' call.  The default is '1'.
+
+     The read-only register '.L' contains the current line spacing; it
+     is associated with the environment (*note Environments::).
+
+   The 'ls' request is a coarse mechanism.  *Note Changing the Type
+Size::, for the requests 'vs' and 'pvs' as alternatives to 'ls'.
+
+ -- Escape sequence: \x'spacing'
+ -- Register: \n.a
+     Sometimes, an output line requires additional vertical spacing, for
+     instance to allow room for a tall construct like an inline equation
+     with exponents or subscripts (particularly if they are iterated).
+     The '\x' escape sequence takes a delimited measurement (like
+     '\x'3p'') to increase the vertical spacing of the pending output
+     line.  The default scaling unit is 'v'.  If the measurement is
+     positive, extra vertical space is inserted below the current line;
+     a negative measurement adds space above.  If '\x' is applied to the
+     pending output line multiple times, the maxima of the positive and
+     negative adjustments are separately applied.  The delimiter need
+     not be a neutral apostrophe; see *note Delimiters::.
+
+     The '.a' read-only register contains the extra vertical spacing
+     _after_ the text baseline of the most recently emitted output line.
+     (In other words, it is the largest positive argument to '\x'
+     encountered on that line.)  This quantity is exposed via a register
+     because if an output line requires this "extra post-vertical line
+     spacing", and the subsequent output line requires "extra
+     pre-vertical line spacing" (a negative argument to '\x'), then
+     applying both can lead to excessive spacing between the output
+     lines.  Text that is piling high on line N might not require (as
+     much) extra pre-vertical line spacing if line N-1 carries extra
+     post-vertical line spacing.
+
+     Use of '\x' can be necessary in combination with the
+     bracket-building escape sequence '\b',(2) (*note Manipulating
+     Spacing-Footnote-2::) as the following example shows.
+
+          .nf
+          This is a test of \rsb (1).
+          This is a test of \rsb (2).
+          This is a test of \b'xyz'\x'-1m'\x'1m' (3).
+          This is a test of \rsb (4).
+          This is a test of \rsb (5).
+              => This is a test of \b (1).
+              => This is a test of \b (2).
+              =>                   x
+              => This is a test of y (3).
+              =>                   z
+              => This is a test of \b (4).
+              => This is a test of \b (5).
+
+Without '\x', the backslashes on the lines marked '(2)' and '(4)' would
+be overprinted.
+
+ -- Request: .ns
+ -- Request: .rs
+ -- Register: \n.ns
+     Enable "no-space mode".  Vertical spacing, whether by 'sp' requests
+     or blank input lines, is disabled.  The 'bp' request to advance to
+     the next page is also disabled, unless it is accompanied by a page
+     number (*note Page Control::).  No-space mode ends automatically
+     when text(3) (*note Manipulating Spacing-Footnote-3::) is formatted
+     for output (4) (*note Manipulating Spacing-Footnote-4::) or the
+     'rs' request is invoked, which ends no-space mode.  The read-only
+     register '.ns' interpolates a Boolean value indicating the
+     enablement of no-space mode.
+
+     A paragraphing macro might ordinarily insert vertical space to
+     separate paragraphs.  A section heading macro could invoke 'ns' to
+     suppress this spacing for the first paragraph in a section.
+
+   (1) *Note Page Location Traps::.
+
+   (2) *Note Drawing Geometric Objects::.
+
+   (3) or geometric objects; see *note Drawing Geometric Objects::
+
+   (4) to the top-level diversion; see *note Diversions::
+
+5.12 Tabs and Fields
+====================
+
+A tab character (ISO code point 9, EBCDIC code point 5) causes a
+horizontal movement to the next tab stop, if any.
+
+ -- Escape sequence: \t
+     Interpolate a tab in copy mode; see *note Copy Mode::.
+
+ -- Request: .ta n1 n2 ... nn T r1 r2 ... rn
+ -- Register: \n.tabs
+     Change tab stop positions.  This request takes a series of tab
+     specifiers as arguments (optionally divided into two groups with
+     the letter 'T') that indicate where each tab stop is to be,
+     overriding any previous settings.  The default scaling unit is 'm'.
+     Invoking 'ta' without an argument removes all tab stops.  GNU
+     'troff''s startup value is 'T 0.5i'.
+
+     Tab stops can be specified absolutely--as distances from the left
+     margin.  The following example sets six tab stops, one every inch.
+
+          .ta 1i 2i 3i 4i 5i 6i
+
+     Tab stops can also be specified using a leading '+', which means
+     that the specified tab stop is set relative to the previous tab
+     stop.  For example, the following is equivalent to the previous
+     example.
+
+          .ta 1i +1i +1i +1i +1i +1i
+
+     GNU 'troff' supports an extended syntax to specify repeating tab
+     stops.  These stops appear after a 'T' argument.  Their values are
+     always taken as distances relative to the previous tab stop.  This
+     is the idiomatic way to specify tab stops at equal intervals in
+     'groff'.  The following is, yet again, the same as the previous
+     examples.  It does more, in fact, since it defines an infinite
+     number of tab stops at one-inch intervals.
+
+          .ta T 1i
+
+     Now we are ready to interpret the full syntax given above.  The
+     'ta' request sets tabs at positions N1, N2, ..., NN, then at NN+R1,
+     NN+R2, ..., NN+RN, then at NN+RN+R1, NN+RN+R2, ..., NN+RN+RN, and
+     so on.
+
+     For example, '4c +6c T 3c 5c 2c' is equivalent to '4c 10c 13c 18c
+     20c 23c 28c 30c ...'.
+
+     Text written to a tab column (i.e., between two tab stops, or
+     between a tab stop and an output line boundary) may be aligned to
+     the right or left, or centered in the column.  This alignment is
+     determined by appending 'R', 'L', or 'C' to the tab specifier.  The
+     default is 'L'.
+
+          .ta 1i 2iC 3iR
+
+     The beginning of an output line is not a tab stop; the text that
+     begins an output line is placed according to the configured
+     alignment and indentation; see *note Manipulating Filling and
+     Adjustment:: and *note Line Layout::.
+
+     A tab stop is converted into a non-breakable horizontal movement
+     that cannot be adjusted.
+
+          .ll 2i
+          .ds foo a\tb\tc
+          .ta T 1i
+          \*foo
+              error-> warning: cannot break line
+              => a         b         c
+
+     The above creates a single output line that is a bit longer than
+     two inches (we use a string to show exactly where the tab stops
+     are).  Now consider the following.
+
+          .ll 2i
+          .ds bar a\tb c\td
+          .ta T 1i
+          \*bar
+              error-> warning: cannot adjust line
+              => a         b
+              => c       d
+
+     GNU 'troff' first converts the line's tab stops into unbreakable
+     horizontal movements, then breaks after 'b'.  This usually isn't
+     what you want.
+
+     Superfluous tab characters--those that do not correspond to a tab
+     stop--are ignored except for the first, which delimits the
+     characters belonging to the last tab stop for right-alignment or
+     centering.
+
+          .ds Z   foo\tbar\tbaz
+          .ds ZZ  foo\tbar\tbazqux
+          .ds ZZZ foo\tbar\tbaz\tqux
+          .ta 2i 4iR
+          \*Z
+          .br
+          \*ZZ
+          .br
+          \*ZZZ
+          .br
+              => foo                 bar              baz
+              => foo                 bar           bazqux
+              => foo                 bar              bazqux
+
+     The first line right-aligns "baz" within the second tab stop.  The
+     second line right-aligns "bazqux" within it.  The third line
+     right-aligns only "baz" because of the additional tab character,
+     which marks the end of the text occupying the last tab stop
+     defined.
+
+     Tab stops are associated with the environment (*note
+     Environments::).
+
+     The read-only register '.tabs' contains a string representation of
+     the current tab settings suitable for use as an argument to the
+     'ta' request.(1)  (*note Tabs and Fields-Footnote-1::)
+
+          .ds tab-string \n.tabs
+          \*tab-string
+              => T120u
+
+ -- Request: .tc c
+     Set the tab repetition character to the ordinary or special
+     character C; normally, no glyph is written when moving to a tab
+     stop (and some output devices may output space characters to
+     achieve this motion).  A "tab repetition character" causes the
+     formatter to write as many instances of C as are necessary to
+     occupy the interval from the horizontal drawing position to the
+     next tab stop.  With no argument, GNU 'troff' reverts to the
+     default behavior.  The tab repetition character is associated with
+     the environment (*note Environments::).  Only a single character of
+     C is recognized; any excess is ignored.
+
+ -- Request: .linetabs n
+ -- Register: \n.linetabs
+     If N is missing or non-zero, activate "line-tabs"; deactivate it
+     otherwise (the default).  Active line-tabs cause GNU 'troff' to
+     compute tab distances relative to the start of the output line
+     instead of the input line.
+
+          .de Tabs
+          .  ds x a\t\c
+          .  ds y b\t\c
+          .  ds z c
+          .  ta 1i 3i
+          \\*x
+          \\*y
+          \\*z
+          ..
+          .Tabs
+          .br
+          .linetabs
+          .Tabs
+              => a         b         c
+              => a         b                   c
+
+     Line-tabs activation is associated with the environment (*note
+     Environments::).  The read-only register '.linetabs' interpolates 1
+     if line-tabs are active, and 0 otherwise.
+
+   (1) Plan 9 'troff' uses the register '.S' for this purpose.
+
+5.12.1 Leaders
+--------------
+
+Sometimes it is desirable to fill a tab stop with a given glyph, but
+also use tab stops normally on the same output line.  An example is a
+table of contents entry that uses dots to bridge the entry name with its
+page number, which is itself aligned between tab stops.  The 'roff'
+language provides "leaders" for this purpose.(1)  (*note
+Leaders-Footnote-1::)
+
+   A leader character (ISO and EBCDIC code point 1, also known as SOH or
+"start of heading"), behaves similarly to a tab character: it moves to
+the next tab stop.  The difference is that for this movement, the
+default fill character is a period '.'.
+
+ -- Escape sequence: \a
+     Interpolate a leader in copy mode; see *note Copy Mode::.
+
+ -- Request: .lc c
+     Set the leader repetition character to the ordinary or special
+     character C.  Recall *note Tabs and Leaders::: when encountering a
+     leader character in the input, the formatter writes as many dots
+     '.' as are necessary until reaching the next tab stop; this is the
+     "leader definition character".  Omitting C unsets the leader
+     character.  With no argument, GNU 'troff' treats leaders the same
+     as tabs.  The leader repetition character is associated with the
+     environment (*note Environments::).  Only a single C is recognized;
+     any excess is ignored.
+
+   A table of contents, for example, may define tab stops after a
+section number, a title, and a gap to be filled with leader dots.  The
+page number follows the leader, after a right-aligned final tab stop
+wide enough to house the largest page number occurring in the document.
+
+     .ds entry1 19.\tThe Prophet\a\t98
+     .ds entry2 20.\tAll Astir\a\t101
+     .ta .5i 4.5i +.5iR
+     .nf
+     \*entry1
+     \*entry2
+         => 19.  The Prophet.............................   98
+         => 20.  All Astir...............................  101
+
+   (1) This is pronounced to rhyme with "feeder", and refers to how the
+glyphs "lead" the eye across the page to the corresponding page number
+or other datum.
+
+5.12.2 Fields
+-------------
+
+"Fields" are a more general way of laying out tabular data.  A field is
+defined as the data between a pair of "delimiting characters".  It
+contains substrings that are separated by "padding characters".  The
+width of a field is the distance on the _input_ line from the position
+where the field starts to the next tab stop.  A padding character
+inserts an adjustable space similar to TeX's '\hss' command (thus it can
+even be negative) to make the sum of all substring lengths plus the
+adjustable space equal to the field width.  If more than one padding
+character is inserted, the available space is evenly distributed among
+them.
+
+ -- Request: .fc delim-char padding-char
+     Define a delimiting and a padding character for fields.  If the
+     latter is missing, the padding character defaults to a space
+     character.  If there is no argument at all, the field mechanism is
+     disabled (which is the default).  In contrast to, e.g., the tab
+     repetition character, delimiting and padding characters are _not_
+     associated with the environment (*note Environments::).
+
+          .fc # ^
+          .ta T 3i
+          #foo^bar^smurf#
+          .br
+          #foo^^bar^smurf#
+              => foo         bar          smurf
+              => foo            bar       smurf
+
+5.13 Character Translations
+===========================
+
+A "translation" is a mapping of an input character to an output glyph.
+The mapping occurs at output time, i.e., the input character gets
+assigned the metric information of the mapped output character right
+before input tokens are converted to nodes (*note Gtroff Internals::,
+for more on this process).
+
+ -- Request: .tr abcd...
+ -- Request: .trin abcd...
+     Translate character A to glyph B, character C to glyph D, and so
+     on.  If there is an odd number of characters in the argument, the
+     last one is translated to a fixed-width space (the same one
+     obtained by the '\<SP>' escape sequence).
+
+     The 'trin' request is identical to 'tr', but when you unformat a
+     diversion with 'asciify' it ignores the translation.  *Note
+     Diversions::, for details about the 'asciify' request.
+
+     Some notes:
+
+        * Special characters ('\(XX', '\XXX', '\C'XXX'', '\'', '\`',
+          '\-', '\_'), glyphs defined with the 'char' request, and
+          numbered glyphs ('\N'XXX'') can be translated also.
+
+        * The '\e' escape can be translated also.
+
+        * Characters can be mapped onto the '\%' and '\~' escape
+          sequences (but '\%' and '\~' can't be mapped onto another
+          glyph).
+
+        * The following characters can't be translated: space (with one
+          exception, see below), backspace, newline, leader (and '\a'),
+          tab (and '\t').
+
+        * Translations are not considered for finding the soft hyphen
+          character set with the 'shc' request.
+
+        * The pair 'C\&' (an arbitrary character C followed by the dummy
+          character) maps this character to "nothing".
+
+               .tr a\&
+               foo bar
+                   => foo br
+
+          Even the space character can be mapped to the dummy character.
+
+               .tr aa \&
+               foo bar
+                   => foobar
+
+          As shown in the example, the space character can't be the
+          first character/glyph pair as an argument of 'tr'.
+          Additionally, it is not possible to map the space character to
+          any other glyph; requests like '.tr aa x' undo '.tr aa \&'
+          instead.
+
+          If justification is active, lines are justified in spite of
+          the 'empty' space character (but there is no minimal distance,
+          i.e., the space character, between words).
+
+        * After an output glyph has been constructed (this happens at
+          the moment immediately before the glyph is appended to an
+          output glyph list, either by direct output, in a macro,
+          diversion, or string), it is no longer affected by 'tr'.
+
+        * Translating character to glyphs where one of them or both are
+          undefined is possible also; 'tr' does not check whether the
+          elements of its argument exist.
+
+          *Note Gtroff Internals::.
+
+        * Without an argument, the 'tr' request is ignored.
+
+ -- Request: .trnt abcd...
+     'trnt' is the same as the 'tr' request except that the translations
+     do not apply to text that is transparently throughput into a
+     diversion with '\!'.  *Note Diversions::.
+
+     For example,
+
+          .tr ab
+          .di x
+          \!.tm a
+          .di
+          .x
+
+     prints 'b' to the standard error stream; if 'trnt' is used instead
+     of 'tr' it prints 'a'.
+
+5.14 'troff' and 'nroff' Modes
+==============================
+
+Historically, 'nroff' and 'troff' were two separate programs; the former
+for terminal output, the latter for typesetters.  GNU 'troff' merges
+both functions into one executable(1) (*note troff and nroff
+Modes-Footnote-1::) that sends its output to a device driver ('grotty'
+for terminal devices, 'grops' for PostScript, and so on) which
+interprets this intermediate output format.  When discussing AT&T
+'troff', it makes sense to talk about "'nroff' mode" and "'troff' mode"
+since the differences are hard-coded.  GNU 'troff' takes information
+from device and font description files without handling requests
+specially if a terminal output device is used, so such a strong
+distinction is unnecessary.
+
+   Usually, a macro package can be used with all output devices.
+Nevertheless, it is sometimes necessary to make a distinction between
+terminal and non-terminal devices: GNU 'troff' provides two built-in
+conditions 'n' and 't' for the 'if', 'ie', and 'while' requests to
+decide whether GNU 'troff' shall behave like 'nroff' or like 'troff'.
+
+ -- Request: .troff
+     Make the 't' built-in condition true (and the 'n' built-in
+     condition false) for 'if', 'ie', and 'while' conditional requests.
+     This is the default if GNU 'troff' (_not_ 'groff') is started with
+     the '-R' switch to avoid loading of the startup files 'troffrc' and
+     'troffrc-end'.  Without '-R', GNU 'troff' stays in 'troff' mode if
+     the output device is not a terminal (e.g., 'ps').
+
+ -- Request: .nroff
+     Make the 'n' built-in condition true (and the 't' built-in
+     condition false) for 'if', 'ie', and 'while' conditional requests.
+     This is the default if GNU 'troff' uses a terminal output device;
+     the code for switching to 'nroff' mode is in the file 'tty.tmac',
+     which is loaded by the startup file 'troffrc'.
+
+   *Note Conditionals and Loops::, for more details on built-in
+conditions.
+
+   (1) A GNU 'nroff' program is available for convenience; it calls GNU
+'troff' to perform the formatting.
+
+5.15 Line Layout
+================
+
+The following drawing shows the dimensions that 'gtroff' uses for
+placing a line of output onto the page.  They are labeled with the
+request that manipulates each dimension.
+
+          -->| in |<--
+             |<-----------ll------------>|
+        +----+----+----------------------+----+
+        |    :    :                      :    |
+        +----+----+----------------------+----+
+     -->| po |<--
+        |<--------paper width---------------->|
+
+These dimensions are:
+
+'po'
+     "Page offset"--this is the leftmost position of text on the final
+     output, defining the "left margin".
+
+'in'
+     "Indentation"--this is the distance from the left margin where text
+     is printed.
+
+'ll'
+     "Line length"--this is the distance from the left margin to right
+     margin.
+
+   The right margin is not explicitly configured; the combination of
+page offset and line length provides the information necessary to derive
+it.
+
+   A simple demonstration:
+
+     .ll 3i
+     This is text without indentation.
+     The line length has been set to 3\~inches.
+     .in +.5i
+     .ll -.5i
+     Now the left and right margins are both increased.
+     .in
+     .ll
+     Calling .in and .ll without parameters restores
+     the previous values.
+
+         => This  is text without indenta-
+         => tion.   The  line  length  has
+         => been set to 3 inches.
+         =>      Now   the  left  and
+         =>      right  margins   are
+         =>      both increased.
+         => Calling  .in  and  .ll without
+         => parameters restores the previ-
+         => ous values.
+
+ -- Request: .po offset
+ -- Request: .po +offset
+ -- Request: .po -offset
+ -- Register: \n.o
+     Set page offset to OFFSET (or increment or decrement its current
+     value by OFFSET).  If invoked without an argument, the page offset
+     is restored to the value before the previous 'po' request.  This
+     request does not cause a break; the page offset in effect when an
+     output line is broken prevails (*note Manipulating Filling and
+     Adjustment::).  The initial value is 1i and the default scaling
+     unit is 'm'.  On terminal devices, the page offset is set to zero
+     by a driver-specific macro file, 'tty.tmac'.  The current page
+     offset can be found in the read-only register '.o'.  This request
+     is incorrectly documented in the AT&T 'troff' manual as using a
+     default scaling unit of 'v'.
+
+          .po 3i
+          \n.o
+              => 720
+          .po -1i
+          \n.o
+              => 480
+          .po
+          \n.o
+              => 720
+
+ -- Request: .in indent
+ -- Request: .in +indent
+ -- Request: .in -indent
+ -- Register: \n.i
+     Set indentation to INDENT (or increment or decrement the current
+     value by INDENT).  This request causes a break.  Initially, there
+     is no indentation.
+
+     If 'in' is called without an argument, the indentation is reset to
+     the previous value before the last call to 'in'.  The default
+     scaling unit is 'm'.
+
+     If a negative indentation value is specified (which is not
+     allowed), 'gtroff' emits a warning in category 'range' and sets the
+     indentation to zero.
+
+     The effect of 'in' is delayed until a partially collected line (if
+     it exists) is output.  A temporary indentation value is reset to
+     zero also.
+
+     The current indentation (as set by 'in') can be found in the
+     read-only register '.i'.  The indentation is associated with the
+     environment (*note Environments::).
+
+ -- Request: .ti offset
+ -- Request: .ti +offset
+ -- Request: .ti -offset
+ -- Register: \n.in
+     Temporarily indent the next output line by OFFSET.  If an increment
+     or decrement value is specified, adjust the temporary indentation
+     relative to the value set by the 'in' request.
+
+     This request causes a break; its value is associated with the
+     environment (*note Environments::).  The default scaling unit is
+     'm'.  A call of 'ti' without an argument is ignored.
+
+     If the total indentation value is negative (which is not allowed),
+     'gtroff' emits a warning in category 'range' and sets the temporary
+     indentation to zero.  'Total indentation' is either OFFSET if
+     specified as an absolute value, or the temporary plus normal
+     indentation, if OFFSET is given as a relative value.
+
+     The effect of 'ti' is delayed until a partially collected line (if
+     it exists) is output.
+
+     The read-only register '.in' is the indentation that applies to the
+     current output line.
+
+     The difference between '.i' and '.in' is that the latter takes into
+     account whether a partially collected line still uses the old
+     indentation value or a temporary indentation value is active.
+
+ -- Request: .ll length
+ -- Request: .ll +length
+ -- Request: .ll -length
+ -- Register: \n.l
+ -- Register: \n.ll
+     Set the line length to LENGTH (or increment or decrement the
+     current value by LENGTH).  Initially, the line length is set to
+     6.5i.  The effect of 'll' is delayed until a partially collected
+     line (if it exists) is output.  The default scaling unit is 'm'.
+
+     If 'll' is called without an argument, the line length is reset to
+     the previous value before the last call to 'll'.  If a negative
+     line length is specified (which is not allowed), 'gtroff' emits a
+     warning in category 'range' and sets the line length to zero.  The
+     line length is associated with the environment (*note
+     Environments::).
+
+     The current line length (as set by 'll') can be found in the
+     read-only register '.l'.  The read-only register '.ll' is the line
+     length that applies to the current output line.
+
+     Similar to '.i' and '.in', the difference between '.l' and '.ll' is
+     that the latter takes into account whether a partially collected
+     line still uses the old line length value.
+
+5.16 Line Continuation
+======================
+
+When filling is enabled, input and output line breaks generally do not
+correspond.  The 'roff' language therefore distinguishes input and
+output line continuation.
+
+ -- Escape sequence: \<RET>
+     '\<RET>' (a backslash immediately followed by a newline) suppresses
+     the effects of that newline in the input.  The next input line thus
+     retains the classification of its predecessor as a control or text
+     line.  '\<RET>' is useful for managing line lengths in the input
+     during document maintenance; you can break an input line in the
+     middle of a request invocation, macro call, or escape sequence.
+     Input line continuation is invisible to the formatter, with two
+     exceptions: the '|' operator recognizes the new input line (*note
+     Numeric Expressions::), and the input line counter register '.c' is
+     incremented.
+
+          .ll 50n
+          .de I
+          .  ft I
+          .  nop \\$*
+          .  ft
+          ..
+          Our film class watched
+          .I The Effect of Gamma Rays on Man-in-the-Moon
+          Marigolds. \" whoops, the input line wrapped
+          .br
+          .I My own opus begins on line \n.c \
+          and ends on line \n.c.
+              => Our film class watched The Effect of Gamma Rays on
+              => Man-in-the-Moon Marigolds.
+              => My own opus begins on line 11 and ends on line 12.
+
+ -- Escape sequence: \c
+ -- Register: \n.int
+     '\c' continues an output line.  Nothing after it on the input line
+     is formatted.  In contrast to '\<RET>', a line after '\c' remains a
+     new input line, so a control character is recognized at its
+     beginning.  The visual results depend on whether filling is
+     enabled; see *note Manipulating Filling and Adjustment::.
+
+        * If filling is enabled, a word interrupted with '\c' is
+          continued with the text on the next input text line, without
+          an intervening space.
+
+               This is a te\c
+               st.
+                   => This is a test.
+
+        * If filling is disabled, the next input text line after '\c' is
+          handled as a continuation of the same input text line.
+
+               .nf
+               This is a \c
+               test.
+                   => This is a test.
+
+     An intervening control line that causes a break overrides '\c',
+     flushing out the pending output line in the usual way.
+
+     The '.int' register contains a positive value if the last output
+     line was continued with '\c'; this datum is associated with the
+     environment (*note Environments::).(1)  (*note Line
+     Continuation-Footnote-1::)
+
+   (1) Historically, the '\c' escape sequence has proven challenging to
+characterize.  Some sources say it "connects the next input text" (to
+the input line on which it appears); others describe it as
+"interrupting" text, on the grounds that a text line is interrupted
+without breaking, perhaps to inject a request invocation or macro call.
+
+5.17 Page Layout
+================
+
+The formatter permits configuration of the page length and page number.
+
+ -- Request: .pl length
+ -- Request: .pl +length
+ -- Request: .pl -length
+ -- Register: \n.p
+     Change (increase or decrease) the page length per the numeric
+     expression LENGTH.  The default scaling unit is 'v'.  A negative
+     LENGTH is valid, but an uncommon application: it prevents page
+     location traps from being sprung,(1) (*note Page
+     Layout-Footnote-1::) and each output line is placed on a new page.
+     If LENGTH is invalid, GNU 'troff' emits a warning in category
+     'number'.  If LENGTH is absent or invalid, '11i' is assumed.
+
+     The read-only register '.p' interpolates the current page length.
+
+ -- Request: .pn num
+ -- Request: .pn +num
+ -- Request: .pn -num
+ -- Register: \n.pn
+     Change (increase or decrease) the page number of the _next_ page
+     per the numeric expression NUM.  If NUM is invalid, GNU 'troff'
+     emits a warning in category 'number' and ignores the request.
+     Without an argument, 'pn' is ignored.
+
+     The read-only register '.pn' interpolates NUM if set by 'pn' on the
+     current page, or the current page number plus 1.
+
+   The formatter offers special support for typesetting headers and
+footers, collectively termed "titles".  Titles have an independent line
+length, and their placement on the page is not restricted.
+
+ -- Request: .tl 'left'center'right'
+     Format an output line as a title consisting of LEFT, CENTER, and
+     RIGHT, each aligned accordingly.  The delimiter need not be a
+     neutral apostrophe: 'tl' accepts the same delimiters as most escape
+     sequences; see *note Delimiters::.  If not used as the delimiter,
+     any "page number character" character is replaced with the current
+     page number; the default is '%'; see the the 'pc' request below.
+     Without an argument, 'tl' is ignored.  'tl' writes the title line
+     immediately, ignoring any partially collected line.
+
+     It is not an error to omit delimiters after the first.  For
+     example, '.tl /Thesis' is interpreted as '.tl /Thesis///': it sets
+     a title line comprising only the left-aligned word 'Thesis'.
+
+ -- Request: .lt length
+ -- Request: .lt +length
+ -- Request: .lt -length
+ -- Register: \n.lt
+     Change (increase or decrease) the line length used by titles per
+     the numeric expression LENGTH.  The default scaling unit is 'm'.
+     If LENGTH is negative, GNU emits a warning in category 'range' and
+     treats LENGTH as '0'.  If LENGTH is invalid, GNU 'troff' emits a
+     warning in category 'number' and ignores the request.  The
+     formatter's default title length is '6.5i'.  With no argument, the
+     title length is restored to the previous value.  The title length
+     is is associated with the environment (*note Environments::).
+
+     The read-only register '.lt' interpolates the title line length.
+
+ -- Request: .pc char
+     Set the page number character to CHAR.  With no argument, the page
+     number character is disabled.  'pc' does not affect the
+     register '%'.
+
+   The following example exercises title features.
+
+     .lt 50n
+     This is my partially collected
+     .tl 'Isomers 2023'%'Dextrose Edition'
+     line.
+         => Isomers 2023             1        Dextrose Edition
+         => This is my partially collected line.
+
+   We most often see titles used in page header and footer traps.  *Note
+Traps::.
+
+   (1) *Note Traps::.
+
+5.18 Page Control
+=================
+
+Discretionary page breaks can prevent the unwanted separation of
+content.  A new page number takes effect during page ejection; see *note
+The Implicit Page Trap::.
+
+ -- Request: .bp page-number
+ -- Request: .bp +page-number
+ -- Request: .bp -page-number
+ -- Register: \n%
+     Break the page and change (increase or decrease) the next page
+     number per the numeric expression PAGE-NUMBER.  If PAGE-NUMBER is
+     invalid, GNU 'troff' emits a warning in category 'number' and
+     ignores the argument.  This request causes a break.  A page break
+     advances the vertical drawing position to the bottom of the page,
+     springing traps.  *Note Page Location Traps::.  'bp' has effect
+     only if invoked within the top-level diversion.(1)  (*note Page
+     Control-Footnote-1::) This request is incorrectly documented in the
+     AT&T 'troff' manual as having a default scaling unit of 'v'.
+
+     The register '%' interpolates the current page number.
+
+          .de BP
+          '  bp \" schedule page break once current line is output
+          ..
+
+ -- Request: .ne space
+     Force a page break if insufficient vertical space is available
+     (assert "needed" space).  'ne' tests the distance to the next page
+     location trap; see *note Page Location Traps::, and breaks the page
+     if that amount is less than SPACE.  The default scaling unit is
+     'v'.  If SPACE is invalid, GNU 'troff' emits a warning in category
+     'number' and ignores the argument.  If SPACE is not specified, '1v'
+     is assumed.
+
+     We can require space for at least the first two output lines of a
+     paragraph, preventing its first line from being widowed at the page
+     bottom.
+
+          .ne 2v
+          Considering how common illness is,
+          how tremendous the spiritual change that it brings,
+          how astonishing,
+          when the lights of health go down,
+          the undiscovered countries that are then disclosed,
+          what wastes and deserts of the soul a slight attack
+          of influenza brings to view,
+
+     This method is reliable only if no output line is pending when 'ne'
+     is invoked.  When macro packages are used, this is often not the
+     case: their paragraphing macros perform the break.  You may need to
+     experiment with placing the 'ne' after the paragraphing macro, or
+     'br' and 'ne' before it.
+
+     'ne' is also useful to force grouping of section headings with
+     their subsequent paragraphs, or tables with their captions and/or
+     explanations.  Macro packages often use 'ne' with diversions to
+     implement keeps and displays; see *note Diversions::.  They may
+     also offer parameters for widow and orphan management.
+
+ -- Request: .sv space
+ -- Request: .os
+     Require vertical space as 'ne' does, but also save it for later
+     output by the 'os' request.  If SPACE is available before the next
+     page location trap, it is output immediately.  Both requests ignore
+     a partially collected line, taking effect at the next break.  'sv'
+     and 'os' ignore no-space mode (recall *note Manipulating
+     Spacing::).  While the 'sv' request allows negative values for
+     SPACE, 'os' ignores them.  The default scaling unit is 'v'.  If
+     SPACE is not specified, '1v' is assumed.
+
+ -- Register: \nnl
+     'nl' interpolates or sets the vertical drawing position.  When the
+     formatter starts, the first page transition hasn't happened yet,
+     and 'nl' is negative.  If a header trap has been planted on the
+     page (typically at vertical position '0'), you can assign a
+     negative value to 'nl' to spring it if that page has already
+     started (*note Page Location Traps::).
+
+          .de HD
+          .  sp
+          .  tl ''Goldbach Solution''
+          .  sp
+          ..
+          .
+          First page.
+          .bp
+          .wh 0 HD \" plant header trap at top of page
+          .nr nl (-1)
+          Second page.
+              => First page.
+              =>
+              => (blank lines elided)
+              =>
+              =>                         Goldbach Solution
+              =>
+              => (blank lines elided)
+              =>
+              => Second page.
+
+     Without resetting 'nl' to a negative value, the trap just planted
+     would be active beginning with the _next_ page, not the current
+     one.
+
+     *Note Diversions::, for a comparison of 'nl' with the '.h' and '.d'
+     registers.
+
+   (1) *Note Diversions::.
+
+5.19 Using Fonts
+================
+
+In digital typography, a "font" is a collection of characters in a
+specific typeface that a device can render as glyphs at a desired
+size.(1)  (*note Using Fonts-Footnote-1::) A 'roff' formatter can change
+typefaces at any point in the text.  The basic faces are a set of
+"styles" combining upright and slanted shapes with normal and heavy
+stroke weights: 'R', 'I', 'B', and 'BI'--these stand for roman, italic,
+bold, and bold-italic.  For linguistic text, GNU 'troff' groups
+typefaces into "families" containing each of these styles.(2)  (*note
+Using Fonts-Footnote-2::) A "text font" is thus often a family combined
+with a style, but it need not be: consider the 'ps' and 'pdf' devices'
+'ZCMI' (Zapf Chancery Medium italic)--often, no other style of Zapf
+Chancery Medium is provided.  On typesetting devices, at least one
+"special font" is available, comprising "unstyled" glyphs for
+mathematical operators and other purposes.
+
+   Like AT&T 'troff', GNU 'troff' does not itself load or manipulate a
+digital font file;(3) (*note Using Fonts-Footnote-3::) instead it works
+with a "font description file" that characterizes it, including its
+glyph repertoire and the "metrics" (dimensions) of each glyph.(4)
+(*note Using Fonts-Footnote-4::) This information permits the formatter
+to accurately place glyphs with respect to each other.  Before using a
+font description, the formatter associates it with a "mounting
+position", a place in an ordered list of available typefaces.  So that a
+document need not be strongly coupled to a specific font family, in GNU
+'troff' an output device can associate a style in the abstract sense
+with a mounting position.  Thus the default family can be combined with
+a style dynamically, producing a "resolved font name".
+
+   Fonts often have trademarked names, and even Free Software fonts can
+require renaming upon modification.  'groff' maintains a convention that
+a device's serif font family is given the name 'T' ("Times"), its
+sans-serif family 'H' ("Helvetica"), and its monospaced family 'C'
+("Courier").  Historical inertia has driven 'groff''s font identifiers
+to short uppercase abbreviations of font names, as with 'TR', 'TI',
+'TB', 'TBI', and a special font 'S'.
+
+   The default family used with abstract styles can be changed at any
+time; initially, it is 'T'.  Typically, abstract styles are arranged in
+the first four mounting positions in the order shown above.  The default
+mounting position, and therefore style, is always '1' ('R').  By issuing
+appropriate formatter instructions, you can override these defaults
+before your document writes its first glyph.
+
+   Terminal output devices cannot change font families and lack special
+fonts.  They support style changes by overstriking, or by altering
+ISO 6429/ECMA-48 "graphic renditions" (character cell attributes).
+
+   (1) Terminals and some output devices have fonts that render at only
+one or two sizes.  As examples of the latter, take the 'groff' 'lj4'
+device's Lineprinter, and 'lbp''s Courier and Elite faces.
+
+   (2) Font designers prepare families such that the styles share
+esthetic properties.
+
+   (3) Historically, the fonts 'troff's dealt with were not Free
+Software or, as with the Graphic Systems C/A/T, did not even exist in
+the digital domain.
+
+   (4) *Note Font Description File Format::.
+
+5.19.1 Selecting Fonts
+----------------------
+
+We use "font" to refer to any of several means of identifying a font: by
+mounting position ('3'), by abstract style ('B'), or by its identifier
+('TB').
+
+ -- Request: .ft font
+ -- Escape sequence: \ff
+ -- Escape sequence: \f(fn
+ -- Escape sequence: \ffont
+ -- Register: \n.fn
+     The 'ft' request selects the typeface FONT.  If the argument is
+     absent or 'P', it selects the previously chosen font.  If FONT is a
+     non-negative integer, it is interpreted as mounting position; the
+     font mounted there is selected.  If that position refers to an
+     abstract style, it is combined with the default family (see 'fam'
+     and '\F' below) to make a resolved font name.  If the mounting
+     position is not a style and no font is mounted there, GNU 'troff'
+     emits a warning in category 'font' and ignores the request.
+
+     If FONT matches a style name, it is combined with the current
+     family to make a resolved font name.  Otherwise, FONT is assumed to
+     already be a resolved font name.
+
+     The resolved font name is subject to translation (see request 'ftr'
+     below).  Next, the (possibly translated) font name's mounting
+     position is looked up; if not mounted, FONT is sought on the file
+     system as a font description file and, if located, automatically
+     mounted at the next available position (see register '.fp' below).
+     If the font was mounted using an identifier different from its font
+     description file name (see request 'fp' below), that file name is
+     then looked up.  If a font description file for the resolved font
+     name is not found, GNU 'troff' emits a warning in category 'font'
+     and ignores the request.
+
+     The '\f' escape sequence is similar, using one-character name (or
+     mounting position) F, two-character name FN, or a name FONT of
+     arbitrary length.  '\f' selects the previous font.  The syntax
+     form '\fP' is supported for backward compatibility, and '\fP' for
+     consistency.
+
+          eggs, bacon,
+          .ft I
+          spam,
+          .ft
+          and sausage.
+          .br
+          eggs, bacon, \fIspam,\fP and sausage.
+              => eggs, bacon, spam, and sausage
+              => eggs, bacon, spam, and sausage
+
+     The current and previously selected fonts are properties of the
+     environment (*note Environments::).
+
+     The read-only string-valued register '.fn' contains the resolved
+     font name of the selected font.
+
+     '\f' doesn't produce an input token in GNU 'troff'; it thus can be
+     used in requests that expect a single-character argument.  We can
+     assign a font to a margin character as follows (*note
+     Miscellaneous::).
+
+          .mc \fIx\f
+
+ -- Request: .ftr f g
+     Translate font F to font G.  Whenever a font named F is referred to
+     in a '\f' escape sequence, in the 'F' and 'S' conditional
+     operators, or in the 'ft', 'ul', 'bd', 'cs', 'tkf', 'special',
+     'fspecial', 'fp', or 'sty' requests, font G is used.  If G is
+     missing or equal to F the translation is undone.
+
+     Font translations cannot be chained.
+
+          .ftr XXX TR
+          .ftr XXX YYY
+          .ft XXX
+              error-> warning: can't find font 'XXX'
+
+ -- Request: .fzoom f zoom
+ -- Register: \n.zoom
+     Set magnification of font F to factor ZOOM, which must be a
+     non-negative integer multiple of 1/1000th.  This request is useful
+     to adjust the optical size of a font in relation to the others.  In
+     the example below, font 'CR' is magnified by 10% (the zoom factor
+     is thus 1.1).
+
+          .fam P
+          .fzoom CR 1100
+          .ps 12
+          Palatino and \fCRCourier\f
+
+     A missing or zero value of ZOOM is the same as a value of 1000,
+     which means no magnification.  F must be a resolved font name, not
+     an abstract style.
+
+     The magnification of a font is completely transparent to GNU
+     'troff'; a change of the zoom factor doesn't cause any effect
+     except that the dimensions of glyphs, (word) spaces, kerns, etc.,
+     of the affected font are adjusted accordingly.
+
+     The zoom factor of the current font is available in the read-only
+     register '.zoom', in multiples of 1/1000th.  It returns zero if
+     there is no magnification.
+
+5.19.2 Font Families
+--------------------
+
+To accommodate the wide variety of fonts available, GNU 'troff'
+distinguishes "font families" and "font styles".  A resolved font name
+is the catenation of a font family and a style.  Selecting an abstract
+style causes GNU 'troff' to combine it with the default font family.
+
+   You can thus compose a document using abstract styles exclusively for
+its body or running text, selecting a specific family only for titles or
+examples, for instance, and change the default family on the command
+line (recall *note Groff Options::).
+
+   Fonts for the devices 'ps', 'pdf', 'dvi', 'lj4', 'lbp', and the X11
+devices support this mechanism.  By default, GNU 'troff' uses the Times
+family with the four styles 'R', 'I', 'B', and 'BI'.
+
+ -- Request: .fam family
+ -- Register: \n.fam
+ -- Escape sequence: \Ff
+ -- Escape sequence: \F(fm
+ -- Escape sequence: \Ffamily
+     Set the default font family, used in combination with abstract
+     styles to construct a resolved font name, to FAMILY (one-character
+     name F, two-character name FM).  If no argument is given, GNU
+     'troff' selects the previous font family; if there none, is it
+     falls back to the device's default(1) (*note Font
+     Families-Footnote-1::) or its own ('T').
+
+     The '\F' escape sequence works similarly.  In disanalogy to '\f',
+     '\FP' makes 'P' the default family.  Use '\F' to select the
+     previous default family.  The default font family is available in
+     the read-only string-valued register '.fam'; it is associated with
+     the environment (*note Environments::).
+
+          spam,     \" startup defaults are T (Times) R (roman)
+          .fam H    \" make Helvetica the default family
+          spam,     \" family H + style R = HR
+          .ft B     \" family H + style B = HB
+          spam,
+          .ft CR    \" Courier roman (default family not changed)
+          spam,
+          .ft       \" back to Helvetica bold
+          spam,
+          .fam T    \" make Times the default family
+          spam,     \" family T + style B = TB
+          .ft AR    \" font AR (not a style)
+          baked beans,
+          .ft R     \" family T + style R = TR
+          and spam.
+
+     '\F' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font family on the
+     fly.
+
+          .mc \FPx\F
+
+ -- Request: .sty n style
+ -- Register: \n.sty
+     Associate an abstract style STYLE with mounting position N, which
+     must be a non-negative integer.  If the requests 'cs', 'bd', 'tkf',
+     'uf', or 'fspecial' are applied to an abstract style, they are
+     instead applied to the member of the current family corresponding
+     to that style.
+
+     The default family can be set with the '-f' option (*note Groff
+     Options::).  The 'styles' command in the 'DESC' file controls which
+     font positions (if any) are initially associated with abstract
+     styles rather than fonts.
+
+     *Caution:* The STYLE argument is not validated.  Errors may occur
+     later, when the formatter attempts to construct a resolved font
+     name, or format a character for output.
+
+          .nr BarPos \n.fp
+          .sty \n.fp Bar
+          .fam Foo
+          .ft \nBarPos
+          .tm .f=\n.f
+          A
+              error-> error: no font family named 'Foo' exists
+              error-> .f=41
+              error-> error: cannot format glyph: no current font
+
+     When an abstract style has been selected, the read-only
+     string-valued register '.sty' interpolates its name; this datum is
+     associated with the environment (*note Environments::).  Otherwise,
+     '.sty' interpolates nothing.
+
+   (1) *Note DESC File Format::.
+
+5.19.3 Font Positions
+---------------------
+
+To support typeface indirection through abstract styles, and for
+compatibility with AT&T 'troff', the formatter maintains a list of font
+"positions" at which fonts required by a document are "mounted".  An
+output device's description file 'DESC' typically configures a set of
+pre-mounted fonts; see *note Device and Font Description Files::.  A
+font need not be explicitly mounted before it is selected; GNU 'troff'
+will search 'GROFF_FONT_PATH' for it by name and mount it at the first
+free mounting position on demand.
+
+ -- Request: .fp pos id font-description-file-name
+ -- Register: \n.f
+ -- Register: \n.fp
+     Mount a font under the name ID at mounting position POS, a
+     non-negative integer.  When the formatter starts up, it reads the
+     output device's description to mount an initial set of faces, and
+     selects font position 1.  Position 0 is unused by default.  Unless
+     the FONT-DESCRIPTION-FILE-NAME argument is given, ID should be the
+     name of a font description file stored in a directory corresponding
+     to the selected output device.  GNU 'troff' does not traverse
+     directories to locate the font description file.
+
+     The optional third argument enables font names to be aliased, which
+     can be necessary in compatibility mode since AT&T 'troff' syntax
+     affords no means of identifying fonts with names longer than two
+     characters, like 'TBI' or 'ZCMI', in a font selection escape
+     sequence.  *Note Compatibility Mode::.  You can also alias fonts on
+     mounting for convenience or abstraction.  (See below regarding the
+     '.fp' register.)
+
+          .fp \n.fp SC ZCMI
+          Send a \f(SChand-written\fP thank-you note.
+          .fp \n.fp Emph TI
+          .fp \n.fp Strong TB
+          Are \fEmphthese names\f \fStrongcomfortable\f?
+
+     'DESC', 'P', and non-negative integers are not usable as font
+     identifiers.
+
+     The position of the currently selected font (or abstract style) is
+     available in the read-only register '.f'.  It is associated with
+     the environment (*note Environments::).
+
+     You can copy the value of '.f' to another register to save it for
+     later use.
+
+          .nr saved-font \n.f
+          ... text involving many font changes ...
+          .ft \nsaved-font
+
+     The index of the next (non-zero) free font position is available in
+     the read-only register '.fp'.  Fonts not listed in the 'DESC' file
+     are automatically mounted at position '\n.fp' when selected with
+     the 'ft' request or '\f' escape sequence.  When mounting a font at
+     a position explicitly with the 'fp' request, this same practice
+     should be followed, although GNU 'troff' does not enforce this
+     strictly.
+
+5.19.4 Using Symbols
+--------------------
+
+A "glyph" is a graphical representation of a "character".  While a
+character is an abstraction of semantic information, a glyph is
+something that can be seen on screen or paper.  A character has many
+possible representation forms (for example, the character 'A' can be
+written in an upright or slanted typeface, producing distinct glyphs).
+Sometimes, a sequence of characters map to a single glyph: this is a
+"ligature"--the most common is 'fi'.
+
+   Space characters never become glyphs in GNU 'troff'.  If not
+discarded (as when trailing on text lines), they are represented by
+horizontal motions in the output.
+
+   A "symbol" is simply a named glyph.  Within 'gtroff', all glyph names
+of a particular font are defined in its font file.  If the user requests
+a glyph not available in this font, 'gtroff' looks up an ordered list of
+"special fonts".  By default, the PostScript output device supports the
+two special fonts 'SS' (slanted symbols) and 'S' (symbols) (the former
+is looked up before the latter).  Other output devices use different
+names for special fonts.  Fonts mounted with the 'fonts' keyword in the
+'DESC' file are globally available.  To install additional special fonts
+locally (i.e., for a particular font), use the 'fspecial' request.
+
+   Here are the exact rules how 'gtroff' searches a given symbol:
+
+   * If the symbol has been defined with the 'char' request, use it.
+     This hides a symbol with the same name in the current font.
+
+   * Check the current font.
+
+   * If the symbol has been defined with the 'fchar' request, use it.
+
+   * Check whether the current font has a font-specific list of special
+     fonts; test all fonts in the order of appearance in the last
+     'fspecial' call if appropriate.
+
+   * If the symbol has been defined with the 'fschar' request for the
+     current font, use it.
+
+   * Check all fonts in the order of appearance in the last 'special'
+     call.
+
+   * If the symbol has been defined with the 'schar' request, use it.
+
+   * As a last resort, consult all fonts loaded up to now for special
+     fonts and check them, starting with the lowest font number.  This
+     can sometimes lead to surprising results since the 'fonts' line in
+     the 'DESC' file often contains empty positions, which are filled
+     later on.  For example, consider the following:
+
+          fonts 3 0 0 FOO
+
+     This mounts font 'foo' at font position 3.  We assume that 'FOO' is
+     a special font, containing glyph 'foo', and that no font has been
+     loaded yet.  The line
+
+          .fspecial BAR BAZ
+
+     makes font 'BAZ' special only if font 'BAR' is active.  We further
+     assume that 'BAZ' is really a special font, i.e., the font
+     description file contains the 'special' keyword, and that it also
+     contains glyph 'foo' with a special shape fitting to font 'BAR'.
+     After executing 'fspecial', font 'BAR' is loaded at font
+     position 1, and 'BAZ' at position 2.
+
+     We now switch to a new font 'XXX', trying to access glyph 'foo'
+     that is assumed to be missing.  There are neither font-specific
+     special fonts for 'XXX' nor any other fonts made special with the
+     'special' request, so 'gtroff' starts the search for special fonts
+     in the list of already mounted fonts, with increasing font
+     positions.  Consequently, it finds 'BAZ' before 'FOO' even for
+     'XXX', which is not the intended behaviour.
+
+   *Note Device and Font Description Files::, and *note Special Fonts::,
+for more details.
+
+   The 'groff_char(7)' man page houses a complete list of predefined
+special character names, but the availability of any as a glyph is
+device- and font-dependent.  For example, say
+
+     man -Tdvi groff_char > groff_char.dvi
+
+to obtain those available with the DVI device and default font
+configuration.(1)  (*note Using Symbols-Footnote-1::) If you want to use
+an additional macro package to change the fonts used, 'groff' (or
+'gtroff') must be run directly.
+
+     groff -Tdvi -mec -man groff_char.7 > groff_char.dvi
+
+   Special character names not listed in 'groff_char(7)' are derived
+algorithmically, using a simplified version of the Adobe Glyph List
+(AGL) algorithm, which is described in
+<https://github.com/adobe-type-tools/agl-aglfn>.  The (frozen) set of
+names that can't be derived algorithmically is called the "'groff' glyph
+list (GGL)".
+
+   * A glyph for Unicode character U+XXXXXX, which is not a
+     composite character is named 'uXXXXXX'.  X must be an uppercase
+     hexadecimal digit.  Examples: 'u1234', 'u008E', 'u12DB8'.  The
+     largest Unicode value is 0x10FFFF. There must be at least four 'X'
+     digits; if necessary, add leading zeroes (after the 'u').  No zero
+     padding is allowed for character codes greater than 0xFFFF.
+     Surrogates (i.e., Unicode values greater than 0xFFFF represented
+     with character codes from the surrogate area U+D800-U+DFFF) are not
+     allowed either.
+
+   * A glyph representing more than a single input character is named
+
+          'u' COMPONENT1 '_' COMPONENT2 '_' COMPONENT3 ...
+
+     Example: 'u0045_0302_0301'.
+
+     For simplicity, all Unicode characters that are composites must be
+     maximally decomposed to NFD;(2) (*note Using Symbols-Footnote-2::)
+     for example, 'u00CA_0301' is not a valid glyph name since U+00CA
+     (LATIN CAPITAL LETTER E WITH CIRCUMFLEX) can be further decomposed
+     into U+0045 (LATIN CAPITAL LETTER E) and U+0302 (COMBINING
+     CIRCUMFLEX ACCENT).  'u0045_0302_0301' is thus the glyph name for
+     U+1EBE, LATIN CAPITAL LETTER E WITH CIRCUMFLEX AND ACUTE.
+
+   * groff maintains a table to decompose all algorithmically derived
+     glyph names that are composites itself.  For example, 'u0100'
+     (LATIN LETTER A WITH MACRON) is automatically decomposed into
+     'u0041_0304'.  Additionally, a glyph name of the GGL is preferred
+     to an algorithmically derived glyph name; 'groff' also
+     automatically does the mapping.  Example: The glyph 'u0045_0302' is
+     mapped to '^E'.
+
+   * glyph names of the GGL can't be used in composite glyph names; for
+     example, '^E_u0301' is invalid.
+
+ -- Escape sequence: \(nm
+ -- Escape sequence: \name
+ -- Escape sequence: \base-glyph combining-component ...
+     Typeset a special character NAME (two-character name NM) or a
+     composite glyph consisting of BASE-GLYPH overlaid with one or more
+     COMBINING-COMPONENTs.  For example, '\A ho' is a capital letter
+     "A" with a "hook accent" (ogonek).
+
+     There is no special syntax for one-character names--the analogous
+     form '\N' would collide with other escape sequences.  However, the
+     four escape sequences '\'', '\-', '\_', and '\`', are translated on
+     input to the special character escape sequences '\aa', '\-',
+     '\ul', and '\ga', respectively.
+
+     A special character name of length one is not the same thing as an
+     ordinary character: that is, the character 'a' is not the same as
+     '\a'.
+
+     If NAME is undefined, a warning in category 'char' is produced and
+     the escape is ignored.  *Note Warnings::, for information about the
+     enablement and suppression of warnings.
+
+     GNU 'troff' resolves '\...' with more than a single component as
+     follows:
+
+        * Any component that is found in the GGL is converted to the
+          'uXXXX' form.
+
+        * Any component 'uXXXX' that is found in the list of
+          decomposable glyphs is decomposed.
+
+        * The resulting elements are then concatenated with '_' in
+          between, dropping the leading 'u' in all elements but the
+          first.
+
+     No check for the existence of any component (similar to 'tr'
+     request) is done.
+
+     Examples:
+
+     '\A ho'
+          'A' maps to 'u0041', 'ho' maps to 'u02DB', thus the final
+          glyph name would be 'u0041_02DB'.  This is not the expected
+          result: the ogonek glyph 'ho' is a spacing ogonek, but for a
+          proper composite a non-spacing ogonek (U+0328) is necessary.
+          Looking into the file 'composite.tmac', one can find
+          '.composite ho u0328', which changes the mapping of 'ho' while
+          a composite glyph name is constructed, causing the final glyph
+          name to be 'u0041_0328'.
+
+     '\^E u0301'
+     '\^E aa'
+     '\E a^ aa'
+     '\E ^ ''
+          '^E' maps to 'u0045_0302', thus the final glyph name is
+          'u0045_0302_0301' in all forms (assuming proper calls of the
+          'composite' request).
+
+     It is not possible to define glyphs with names like 'A ho' within a
+     'groff' font file.  This is not really a limitation; instead, you
+     have to define 'u0041_0328'.
+
+ -- Escape sequence: \C'xxx'
+     Typeset the glyph of the special character XXX.  Normally, it is
+     more convenient to use '\XXX', but '\C' has some advantages: it
+     is compatible with AT&T device-independent 'troff' (and therefore
+     available in compatibility mode(3) (*note Using
+     Symbols-Footnote-3::)) and can interpolate special characters with
+     '' in their names.  The delimiter need not be a neutral
+     apostrophe; see *note Delimiters::.
+
+ -- Request: .composite id1 id2
+     Map special character name ID1 to ID2 if ID1 is used in '\...'
+     with more than one component.  See above for examples.  This is a
+     strict rewriting of the special character name; no check is
+     performed for the existence of a glyph for either.  A set of
+     default mappings for many accents can be found in the file
+     'composite.tmac', loaded by the default 'troffrc' at startup.
+
+ -- Escape sequence: \N'n'
+     Typeset the glyph with code N in the current font ('n' is _not_ the
+     input character code).  The number N can be any non-negative
+     decimal integer.  Most devices only have glyphs with codes between
+     0 and 255; the Unicode output device uses codes in the range
+     0-65535.  If the current font does not contain a glyph with that
+     code, special fonts are _not_ searched.  The '\N' escape sequence
+     can be conveniently used in conjunction with the 'char' request:
+
+          .char \phone \fZD\N'37'
+
+     The code of each glyph is given in the fourth column in the font
+     description file after the 'charset' command.  It is possible to
+     include unnamed glyphs in the font description file by using a name
+     of '---'; the '\N' escape sequence is the only way to use these.
+
+     No kerning is applied to glyphs accessed with '\N'.  The delimiter
+     need not be a neutral apostrophe; see *note Delimiters::.
+
+   A few escape sequences are also special characters.
+
+ -- Escape sequence: \'
+     An escaped neutral apostrophe is a synonym for '\aa' (acute
+     accent).
+
+ -- Escape sequence: \`
+     An escaped grave accent is a synonym for '\ga' (grave accent).
+
+ -- Escape sequence: \-
+     An escaped hyphen-minus is a synonym for '\-' (minus sign).
+
+ -- Escape sequence: \_
+     An escaped underscore ("low line") is a synonym for '\ul'
+     (underrule).  On typesetting devices, the underrule is
+     font-invariant and drawn lower than the underscore '_'.
+
+ -- Request: .cflags n c1 c2 ...
+     Assign properties encoded by the number N to characters C1, C2, and
+     so on.
+
+     Input characters, including special characters introduced by an
+     escape, have certain properties associated with them.(4)  (*note
+     Using Symbols-Footnote-4::) These properties can be modified with
+     this request.  The first argument is the sum of the desired flags
+     and the remaining arguments are the characters to be assigned those
+     properties.  Spaces between the CN arguments are optional.  Any
+     argument CN can be a character class defined with the 'class'
+     request rather than an individual character.  *Note Character
+     Classes::.
+
+     The non-negative integer N is the sum of any of the following.
+     Some combinations are nonsensical, such as '33' (1 + 32).
+
+     '1'
+          Recognize the character as ending a sentence if followed by a
+          newline or two spaces.  Initially, characters '.?!' have this
+          property.
+
+     '2'
+          Enable breaks before the character.  A line is not broken at a
+          character with this property unless the characters on each
+          side both have non-zero hyphenation codes.  This exception can
+          be overridden by adding 64.  Initially, no characters have
+          this property.
+
+     '4'
+          Enable breaks after the character.  A line is not broken at a
+          character with this property unless the characters on each
+          side both have non-zero hyphenation codes.  This exception can
+          be overridden by adding 64.  Initially, characters
+          '\-\hy\em' have this property.
+
+     '8'
+          Mark the glyph associated with this character as overlapping
+          other instances of itself horizontally.  Initially, characters
+          '\ul\rn\ru\radicalex\sqrtex' have this property.
+
+     '16'
+          Mark the glyph associated with this character as overlapping
+          other instances of itself vertically.  Initially, the
+          character '\br' has this property.
+
+     '32'
+          Mark the character as transparent for the purpose of
+          end-of-sentence recognition.  In other words, an
+          end-of-sentence character followed by any number of characters
+          with this property is treated as the end of a sentence if
+          followed by a newline or two spaces.  This is the same as
+          having a zero space factor in TeX.  Initially, characters
+          '"')*\dg\dd\rq\cq' have this property.
+
+     '64'
+          Ignore hyphenation codes of the surrounding characters.  Use
+          this in combination with values 2 and 4 (initially, no
+          characters have this property).
+
+          For example, if you need an automatic break point after the
+          en-dash in numeric ranges like "3000-5000", insert
+
+               .cflags 68 \en
+
+          into your document.  However, this practice can lead to bad
+          layout if done thoughtlessly; in most situations, a better
+          solution instead of changing the 'cflags' value is to insert
+          '\:' right after the hyphen at the places that really need a
+          break point.
+
+     The remaining values were implemented for East Asian language
+     support; those who use alphabetic scripts exclusively can disregard
+     them.
+
+     '128'
+          Prohibit a line break before the character, but allow a line
+          break after the character.  This works only in combination
+          with flags 256 and 512 and has no effect otherwise.
+          Initially, no characters have this property.
+
+     '256'
+          Prohibit a line break after the character, but allow a line
+          break before the character.  This works only in combination
+          with flags 128 and 512 and has no effect otherwise.
+          Initially, no characters have this property.
+
+     '512'
+          Allow line break before or after the character.  This works
+          only in combination with flags 128 and 256 and has no effect
+          otherwise.  Initially, no characters have this property.
+
+     In contrast to values 2 and 4, the values 128, 256, and 512 work
+     pairwise.  If, for example, the left character has value 512, and
+     the right character 128, no break will be automatically inserted
+     between them.  If we use value 6 instead for the left character, a
+     break after the character can't be suppressed since the neighboring
+     character on the right doesn't get examined.
+
+ -- Request: .char c contents
+ -- Request: .fchar c contents
+ -- Request: .fschar f c contents
+ -- Request: .schar c contents
+     Define a new character or glyph C to be CONTENTS, which can be
+     empty.  More precisely, 'char' defines a 'groff' object (or
+     redefines an existing one) that is accessed with the name C on
+     input, and produces CONTENTS on output.  Every time glyph C needs
+     to be printed, CONTENTS is processed in a temporary environment and
+     the result is wrapped up into a single object.  Compatibility mode
+     is turned off and the escape character is set to '\' while CONTENTS
+     is processed.  Any emboldening, constant spacing, or track kerning
+     is applied to this object rather than to individual glyphs in
+     CONTENTS.
+
+     An object defined by these requests can be used just like a normal
+     glyph provided by the output device.  In particular, other
+     characters can be translated to it with the 'tr' or 'trin'
+     requests; it can be made the leader character with the 'lc'
+     request; repeated patterns can be drawn with it using the '\l' and
+     '\L' escape sequences; and words containing C can be hyphenated
+     correctly if the 'hcode' request is used to give the object a
+     hyphenation code.
+
+     There is a special anti-recursion feature: use of the object within
+     its own definition is handled like a normal character (not defined
+     with 'char').
+
+     The 'tr' and 'trin' requests take precedence if 'char' accesses the
+     same symbol.
+
+          .tr XY
+          X
+              => Y
+          .char X Z
+          X
+              => Y
+          .tr XX
+          X
+              => Z
+
+     The 'fchar' request defines a fallback glyph: 'gtroff' only checks
+     for glyphs defined with 'fchar' if it cannot find the glyph in the
+     current font.  'gtroff' carries out this test before checking
+     special fonts.
+
+     'fschar' defines a fallback glyph for font F: 'gtroff' checks for
+     glyphs defined with 'fschar' after the list of fonts declared as
+     font-specific special fonts with the 'fspecial' request, but before
+     the list of fonts declared as global special fonts with the
+     'special' request.
+
+     Finally, the 'schar' request defines a global fallback glyph:
+     'gtroff' checks for glyphs defined with 'schar' after the list of
+     fonts declared as global special fonts with the 'special' request,
+     but before the already mounted special fonts.
+
+     *Note Character Classes::.
+
+ -- Request: .rchar c ...
+ -- Request: .rfschar f c ...
+     Remove definition of each ordinary or special character C, undoing
+     the effect of a 'char', 'fchar', or 'schar' request.  Those
+     supplied by font description files cannot be removed.  Spaces and
+     tabs may separate C arguments.
+
+     The request 'rfschar' removes glyph definitions defined with
+     'fschar' for font F.
+
+   (1) Not all versions of the 'man' program support the '-T' option;
+use the subsequent example for an alternative.
+
+   (2) This is "Normalization Form D" as documented in Unicode Standard
+Annex #15 (<https://unicode.org/reports/tr15/>).
+
+   (3) *Note Compatibility Mode::.
+
+   (4) Output glyphs don't--to GNU 'troff', a glyph is simply a box with
+an index into a font, a given height above and depth below the baseline,
+and a width.
+
+5.19.5 Character Classes
+------------------------
+
+Classes are particularly useful for East Asian languages such as
+Chinese, Japanese, and Korean, where the number of needed characters is
+much larger than in European languages, and where large sets of
+characters share the same properties.
+
+ -- Request: .class name c1 c2 ...
+     Define a character class (or simply "class") NAME comprising the
+     characters C1, C2, and so on.
+
+     A class thus defined can then be referred to in lieu of listing all
+     the characters within it.  Currently, only the 'cflags' request can
+     handle references to character classes.
+
+     In the request's simplest form, each CN is a character (or special
+     character).
+
+          .class quotes ' \aq \dq \oq \cq \lq \rq
+
+     Since class and glyph names share the same name space, it is
+     recommended to start and end the class name with '' and '',
+     respectively, to avoid collisions with existing character names
+     defined by GNU 'troff' or the user (with 'char' and related
+     requests).  This practice applies the presence of '' in the class
+     name to prevent the use of the special character escape form
+     '\...', thus you must use the '\C' escape to access a class with
+     such a name.
+
+     You can also use a character range notation consisting of a start
+     character followed by '-' and then an end character.  Internally,
+     GNU 'troff' converts these two symbol names to Unicode code points
+     (according to the 'groff' glyph list GGL), which then give the
+     start and end value of the range.  If that fails, the class
+     definition is skipped.
+
+     Furthermore, classes can be nested.
+
+          .class prepunct , : ; > }
+          .class prepunctx \C'prepunct' \u2013-\u2016
+
+     The class 'prepunctx' thus contains the contents of the class
+     'prepunct' as defined above (the set ', : ; > }'), and characters
+     in the range between 'U+2013' and 'U+2016'.
+
+     If you want to include '-' in a class, it must be the first
+     character value in the argument list, otherwise it gets
+     misinterpreted as part of the range syntax.
+
+     It is not possible to use class names as end points of range
+     definitions.
+
+     A typical use of the 'class' request is to control line-breaking
+     and hyphenation rules as defined by the 'cflags' request.  For
+     example, to inhibit line breaks before the characters belonging to
+     the 'prepunctx' class defined in the previous example, you can
+     write the following.
+
+          .cflags 2 \C'prepunctx'
+
+     See the 'cflags' request in *note Using Symbols::, for more
+     details.
+
+5.19.6 Special Fonts
+--------------------
+
+Special fonts are those that 'gtroff' searches when it cannot find the
+requested glyph in the current font.  The Symbol font is usually a
+special font.
+
+   'gtroff' provides the following two requests to add more special
+fonts.  *Note Using Symbols::, for a detailed description of the glyph
+searching mechanism in 'gtroff'.
+
+   Usually, only non-TTY devices have special fonts.
+
+ -- Request: .special s1 s2 ...
+ -- Request: .fspecial f s1 s2 ...
+     Use the 'special' request to define special fonts.  Initially, this
+     list is empty.
+
+     Use the 'fspecial' request to designate special fonts only when
+     font F is active.  Initially, this list is empty.
+
+     Previous calls to 'special' or 'fspecial' are overwritten; without
+     arguments, the particular list of special fonts is set to empty.
+     Special fonts are searched in the order they appear as arguments.
+
+     All fonts that appear in a call to 'special' or 'fspecial' are
+     loaded.
+
+     *Note Using Symbols::, for the exact search order of glyphs.
+
+5.19.7 Artificial Fonts
+-----------------------
+
+There are a number of requests and escape sequences for artificially
+creating fonts.  These are largely vestiges of the days when output
+devices did not have a wide variety of fonts, and when 'nroff' and
+'troff' were separate programs.  Most of them are no longer necessary in
+GNU 'troff'.  Nevertheless, they are supported.
+
+ -- Escape sequence: \H'height'
+ -- Escape sequence: \H'+height'
+ -- Escape sequence: \H'-height'
+ -- Register: \n.height
+     Change (increment, decrement) the height of the current font, but
+     not the width.  If HEIGHT is zero, restore the original height.
+     Default scaling unit is 'z'.
+
+     The read-only register '.height' contains the font height as set by
+     '\H'.
+
+     Currently, only the '-Tps' and '-Tpdf' devices support this
+     feature.
+
+     '\H' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font on the fly:
+
+          .mc \H'+5z'x\H'0'
+
+     In compatibility mode, 'gtroff' behaves differently: If an
+     increment or decrement is used, it is always taken relative to the
+     current type size and not relative to the previously selected font
+     height.  Thus,
+
+          .cp 1
+          \H'+5'test \H'+5'test
+
+     prints the word 'test' twice with the same font height (five points
+     larger than the current font size).
+
+ -- Escape sequence: \S'slant'
+ -- Register: \n.slant
+     Slant the current font by SLANT degrees.  Positive values slant to
+     the right.  Only integer values are possible.
+
+     The read-only register '.slant' contains the font slant as set by
+     '\S'.
+
+     Currently, only the '-Tps' and '-Tpdf' devices support this
+     feature.
+
+     '\S' doesn't produce an input token in GNU 'troff'.  As a
+     consequence, it can be used in requests like 'mc' (which expects a
+     single character as an argument) to change the font on the fly:
+
+          .mc \S'20'x\S'0'
+
+     This escape is incorrectly documented in the AT&T 'troff' manual;
+     the slant is always set to an absolute value.
+
+ -- Request: .ul lines
+     The 'ul' request normally underlines subsequent lines if a TTY
+     output device is used.  Otherwise, the lines are printed in italics
+     (only the term 'underlined' is used in the following).  The single
+     argument is the quantity of input lines to be underlined; with no
+     argument, the next line is underlined.  If LINES is zero or
+     negative, stop the effects of 'ul' (if it was active).  Requests
+     and empty lines do not count for computing the number of underlined
+     input lines, even if they produce some output like 'tl'.  Lines
+     inserted by macros (e.g., invoked by a trap) do count.
+
+     At the beginning of 'ul', the current font is stored and the
+     underline font is activated.  Within the span of a 'ul' request, it
+     is possible to change fonts, but after the last line affected by
+     'ul' the saved font is restored.
+
+     This number of lines still to be underlined is associated with the
+     environment (*note Environments::).  The underline font can be
+     changed with the 'uf' request.
+
+     The 'ul' request does not underline spaces.
+
+ -- Request: .cu lines
+     The 'cu' request is similar to 'ul' but underlines spaces as well
+     (if a TTY output device is used).
+
+ -- Request: .uf font
+     Set the underline font (globally) used by 'ul' and 'cu'.  By
+     default, this is the font at position 2.  FONT can be either a
+     non-negative font position or the name of a font.
+
+ -- Request: .bd font offset
+ -- Request: .bd font1 font2 offset
+ -- Register: \n.b
+     Embolden FONT by overstriking its glyphs offset by OFFSET units
+     minus one.
+
+     Two syntax forms are available.
+
+        * Imitate a bold font unconditionally.  The first argument
+          specifies the font to embolden, and the second is the number
+          of basic units, minus one, by which the two glyphs are offset.
+          If the second argument is missing, emboldening is turned off.
+
+          FONT can be either a non-negative font position or the name of
+          a font.
+
+          OFFSET is available in the '.b' read-only register if a
+          special font is active; in the 'bd' request, its default unit
+          is 'u'.
+
+        * Imitate a bold form conditionally.  Embolden FONT1 by OFFSET
+          only if font FONT2 is the current font.  This request can be
+          issued repeatedly to set up different emboldening values for
+          different current fonts.  If the second argument is missing,
+          emboldening is turned off for this particular current font.
+
+          This affects special fonts only (either set up with the
+          'special' command in font files or with the 'fspecial'
+          request).
+
+ -- Request: .cs font width em-size
+     Switch to and from "constant glyph space mode".  If activated, the
+     width of every glyph is WIDTH/36 ems.  The em size is given
+     absolutely by EM-SIZE; if this argument is missing, the em value is
+     taken from the current font size (as set with the 'ps' request)
+     when the font is effectively in use.  Without second and third
+     argument, constant glyph space mode is deactivated.
+
+     Default scaling unit for EM-SIZE is 'z'; WIDTH is an integer.
+
+5.19.8 Ligatures and Kerning
+----------------------------
+
+Ligatures are groups of characters that are run together, i.e, producing
+a single glyph.  For example, the letters 'f' and 'i' can form a
+ligature 'fi' as in the word 'file'.  This produces a cleaner look
+(albeit subtle) to the printed output.  Usually, ligatures are not
+available in fonts for TTY output devices.
+
+   Most PostScript fonts support the fi and fl ligatures.  The C/A/T
+typesetter that was the target of AT&T 'troff' also supported 'ff',
+'ffi', and 'ffl' ligatures.  Advanced typesetters or 'expert' fonts may
+include ligatures for 'ft' and 'ct', although GNU 'troff' does not
+support these (yet).
+
+   Only the current font is checked for ligatures and kerns; neither
+special fonts nor special charcters defined with the 'char' request (and
+its siblings) are taken into account.
+
+ -- Request: .lg flag
+ -- Register: \n.lg
+     Switch the ligature mechanism on or off; if the parameter is
+     non-zero or missing, ligatures are enabled, otherwise disabled.
+     Default is on.  The current ligature mode can be found in the
+     read-only register '.lg' (set to 1 or 2 if ligatures are enabled,
+     0 otherwise).
+
+     Setting the ligature mode to 2 enables the two-character ligatures
+     (fi, fl, and ff) and disables the three-character ligatures (ffi
+     and ffl).
+
+   "Pairwise kerning" is another subtle typesetting mechanism that
+modifies the distance between a glyph pair to improve readability.  In
+most cases (but not always) the distance is decreased.  Typewriter-like
+fonts and fonts for terminals where all glyphs have the same width don't
+use kerning.
+
+ -- Request: .kern flag
+ -- Register: \n.kern
+     Switch kerning on or off.  If the parameter is non-zero or missing,
+     enable pairwise kerning, otherwise disable it.  The read-only
+     register '.kern' is set to 1 if pairwise kerning is enabled,
+     0 otherwise.
+
+     If the font description file contains pairwise kerning information,
+     glyphs from that font are kerned.  Kerning between two glyphs can
+     be inhibited by placing '\&' between them: 'V\&A'.
+
+     *Note Font Description File Format::.
+
+   "Track kerning" expands or reduces the space between glyphs.  This
+can be handy, for example, if you need to squeeze a long word onto a
+single line or spread some text to fill a narrow column.  It must be
+used with great care since it is usually considered bad typography if
+the reader notices the effect.
+
+ -- Request: .tkf f s1 n1 s2 n2
+     Enable track kerning for font F.  If the current font is F the
+     width of every glyph is increased by an amount between N1 and N2
+     (N1, N2 can be negative); if the current type size is less than or
+     equal to S1 the width is increased by N1; if it is greater than or
+     equal to S2 the width is increased by N2; if the type size is
+     greater than or equal to S1 and less than or equal to S2 the
+     increase in width is a linear function of the type size.
+
+     The default scaling unit is 'z' for S1 and S2, 'p' for N1 and N2.
+
+     The track kerning amount is added even to the rightmost glyph in a
+     line; for large values it is thus recommended to increase the line
+     length by the same amount to compensate.
+
+5.19.9 Italic Corrections
+-------------------------
+
+When typesetting adjacent glyphs from typefaces of different slants, the
+space between them may require adjustment.
+
+ -- Escape sequence: \/
+     Apply an "italic correction": modify the spacing of the preceding
+     glyph so that the distance between it and the following glyph is
+     correct if the latter is of upright shape.  For example, if an
+     italic 'f' is followed immediately by a roman right parenthesis,
+     then in many fonts the top right portion of the 'f' overlaps the
+     top left of the right parenthesis, which is ugly.  Use this escape
+     sequence whenever an oblique glyph is immediately followed by an
+     upright glyph without any intervening space.
+
+ -- Escape sequence: \,
+     Apply a "left italic correction": modify the spacing of the
+     following glyph so that the distance between it and the preceding
+     glyph is correct if the latter is of upright shape.  For example,
+     if a roman left parenthesis is immediately followed by an
+     italic 'f', then in many fonts the bottom left portion of the 'f'
+     overlaps the bottom of the left parenthesis, which is ugly.  Use
+     this escape sequence whenever an upright glyph is followed
+     immediately by an oblique glyph without any intervening space.
+
+5.19.10 Dummy Characters
+------------------------
+
+As discussed in *note Requests and Macros::, the first character on an
+input line is treated specially.  Further, formatting a glyph has many
+consequences on formatter state (*note Environments::).  Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
+
+ -- Escape sequence: \&
+     Interpolate a dummy character, which is constitutive of output but
+     invisible.(1)  (*note Dummy Characters-Footnote-1::) Its presence
+     alters the interpretation context of a subsequent input character,
+     and enjoys several applications.
+
+        * Prevent insertion of extra space after an end-of-sentence
+          character.
+
+               Test.
+               Test.
+                   => Test.  Test.
+               Test.\&
+               Test.
+                   => Test. Test.
+
+        * Prevent recognition of a control character.
+
+               .Test
+                   error-> warning: macro 'Test' not defined
+               \&.Test
+                   => .Test
+
+        * Prevent kerning between two glyphs.
+
+        * Translate a character to "nothing".
+
+               .tr JIjiK\&k\&UVuv
+               Post universitum, alea jacta est, OK?
+                   => Post vniversitvm, alea iacta est, O?
+
+     The dummy character escape sequence sees use in macro definitions
+     as a means of ensuring that arguments are treated as text even if
+     they begin with spaces or control characters.
+
+          .de HD \" typeset a simple bold heading
+          .  sp
+          .  ft B
+          \&\\$1 \" exercise: remove the \&
+          .  ft
+          .  sp
+          ..
+          .HD .\|.\|.\|surprised?
+
+   One way to think about the dummy character is to imagine placing the
+symbol '&' in the input at a certain location; if doing so has all the
+side effects on formatting that you desire except for sticking an ugly
+ampersand in the midst of your text, the dummy character is what you
+want in its place.
+
+ -- Escape sequence: \)
+     Interpolate a transparent dummy character--one that is transparent
+     to end-of-sentence detection.  It behaves as '\&', except that '\&'
+     is treated as letters and numerals normally are after '.', '?' and
+     '!'; '\&' cancels end-of-sentence detection, and '\)' does not.
+
+          .de Suffix-&
+          .  nop \&\\$1
+          ..
+          .
+          .de Suffix-)
+          .  nop \)\\$1
+          ..
+          .
+          Here's a sentence.\c
+          .Suffix-& '
+          Another one.\c
+          .Suffix-) '
+          And a third.
+              => Here's a sentence.' Another one.'  And a third.
+
+   (1) Opinions of this escape sequence's name abound.  "Zero-width
+space" is a popular misnomer: 'roff' formatters do not treat it like a
+space.  Ossanna called it a "non-printing, zero-width character", but
+the character causes _output_ even though it does not "print".  If no
+output line is pending, the dummy character starts one.  Contrast an
+empty input document with one containing only '\&'.  The former produces
+no output; the latter, a blank page.
+
+5.20 Manipulating Type Size and Vertical Spacing
+================================================
+
+These concepts were introduced in *note Page Geometry::.  The height of
+a font's tallest glyph is one em, which is equal to the type size in
+points.(1)  (*note Manipulating Type Size and Vertical
+Spacing-Footnote-1::) A vertical spacing of less than 120% of the type
+size can make a document hard to read.  Larger proportions can be useful
+to spread the text for annotations or proofreader's marks.  By default,
+GNU 'troff' uses 10 point type on 12 point spacing.  Typographers call
+the difference between type size and vertical spacing "leading".(2)
+(*note Manipulating Type Size and Vertical Spacing-Footnote-2::)
+
+   (1) In text fonts, the tallest glyphs are typically parentheses.
+Unfortunately, in many cases the actual dimensions of the glyphs in a
+font do not closely match its declared type size!  For example, in the
+standard PostScript font families, 10-point Times sets better with
+9-point Helvetica and 11-point Courier than if all three were used at
+10 points.
+
+   (2) Rhyme with "sledding"; mechanical typography used lead metal
+(Latin _plumbum_).
+
+5.20.1 Changing the Type Size
+-----------------------------
+
+ -- Request: .ps size
+ -- Request: .ps +size
+ -- Request: .ps -size
+ -- Escape sequence: \ssize
+ -- Register: \n.s
+     Use the 'ps' request or the '\s' escape sequence to change
+     (increase, decrease) the type size (in scaled points).  Specify
+     SIZE as either an absolute type size, or as a relative change from
+     the current size.  'ps' with no argument restores the previous
+     size.  The 'ps' request's default scaling unit is 'z'.  The
+     requested size is rounded to the nearest valid size (with ties
+     rounding down) within the limits supported by the device.  If the
+     requested size is non-positive, it is treated as 1u.
+
+     Type size alteration is incorrectly documented in the AT&T 'troff'
+     manual, which claims "if the requested size is invalid, the next
+     larger valid size will result, with a maximum of 36".(1)  (*note
+     Changing the Type Size-Footnote-1::)
+
+     The read-only string-valued register '.s' interpolates the type
+     size in points as a decimal fraction; it is associated with the
+     environment (*note Environments::).  To obtain the type size in
+     scaled points, interpolate the '.ps' register instead (*note Using
+     Fractional Type Sizes::).
+
+     The '\s' escape sequence supports a variety of syntax forms.
+
+     '\sN'
+          Set the type size to N points.  N must be a single digit.  If
+          N is 0, restore the previous size.
+
+     '\s+N'
+     '\s-N'
+          Increase or decrease the type size by N points.  N must be
+          exactly one digit.
+
+     '\s(NN'
+          Set the type size to NN points.  NN must be exactly two
+          digits.
+
+     '\s+(NN'
+     '\s-(NN'
+     '\s(+NN'
+     '\s(-NN'
+          Alter the type size in points by the two-digit value NN.
+
+     *Note Using Fractional Type Sizes::, for further syntactical forms
+     of the '\s' escape sequence that additionally accept decimal
+     fractions.
+
+          snap, snap,
+          .ps +2
+          grin, grin,
+          .ps +2
+          wink, wink, \s+2nudge, nudge,\s+8 say no more!
+          .ps 10
+
+   The '\s' escape sequence affects the environment immediately and
+doesn't produce an input token.  Consequently, it can be used in
+requests like 'mc', which expects a single character as an argument, to
+change the type size on the fly.
+
+     .mc \s20x\s0
+
+ -- Request: .sizes s1 s2 ... sn 0
+     The 'DESC' file specifies which type sizes are allowed by the
+     output device; see *note DESC File Format::.  Use the 'sizes'
+     request to change this set of permissible sizes.  Arguments are in
+     scaled points; see *note Using Fractional Type Sizes::.  Each can
+     be a single type size (such as '12000'), or a range of sizes (such
+     as '4000-72000').  You can optionally end the list with a '0'.
+
+   (1) The claim appears to have been true of Ossanna 'troff' for the
+C/A/T device; Kernighan made device-independent 'troff' more flexible.
+
+5.20.2 Changing the Vertical Spacing
+------------------------------------
+
+ -- Request: .vs space
+ -- Request: .vs +space
+ -- Request: .vs -space
+ -- Register: \n.v
+     Set the vertical spacing to, or alter it by, SPACE.  The default
+     scaling unit is 'p'.  If 'vs' is called without an argument, the
+     vertical spacing is reset to the previous value before the last
+     call to 'vs'.  GNU 'troff' emits a warning in category 'range' if
+     SPACE is negative; the vertical spacing is then set to the smallest
+     possible positive value, the vertical motion quantum (as found in
+     the '.V' register).
+
+     '.vs 0' isn't saved in a diversion since it doesn't result in a
+     vertical motion.  You must explicitly issue this request before
+     interpolating the diversion.
+
+     The read-only register '.v' contains the vertical spacing; it is
+     associated with the environment (*note Environments::).
+
+When a break occurs, GNU 'troff' performs the following procedure.
+
+   * Move the drawing position vertically by the "extra pre-vertical
+     line space", the minimum of all negative '\x' escape sequence
+     arguments in the pending output line.
+
+   * Move the drawing position vertically by the vertical line spacing.
+
+   * Write out the pending output line.
+
+   * Move the drawing position vertically by the "extra post-vertical
+     line space", the maximum of all positive '\x' escape sequence
+     arguments in the line that has just been output.
+
+   * Move the drawing position vertically by the "post-vertical line
+     spacing" (see below).
+
+   Prefer 'vs' or 'pvs' over 'ls' to produce double-spaced documents.
+'vs' and 'pvs' have finer granularity than 'ls'; moreover, some
+preprocessors assume single spacing.  *Note Manipulating Spacing::,
+regarding the '\x' escape sequence and the 'ls' request.
+
+ -- Request: .pvs space
+ -- Request: .pvs +space
+ -- Request: .pvs -space
+ -- Register: \n.pvs
+     Set the post-vertical spacing to, or alter it by, SPACE.  The
+     default scaling unit is 'p'.  If 'pvs' is called without an
+     argument, the post-vertical spacing is reset to the previous value
+     before the last call to 'pvs'.  GNU 'troff' emits a warning in
+     category 'range' if SPACE is negative; the post-vertical spacing is
+     then set to zero.
+
+     The read-only register '.pvs' contains the post-vertical spacing;
+     it is associated with the environment (*note Environments::).
+
+5.20.3 Using Fractional Type Sizes
+----------------------------------
+
+AT&T 'troff' interpreted all type size measurements in points.  Combined
+with integer arithmetic, this design choice made it impossible to
+support, for instance, ten and a half-point type.  In GNU 'troff', an
+output device can select a scaling factor that subdivides a point into
+"scaled points".  A type size expressed in scaled points can thus
+represent a non-integral type size.
+
+   A "scaled point" is equal to 1/SIZESCALE points, where SIZESCALE is
+specified in the device description file 'DESC', and defaults to 1.(1)
+(*note Using Fractional Type Sizes-Footnote-1::) Requests and escape
+sequences in GNU 'troff' interpret arguments that represent a type size
+in scaled points, which the formatter multiplies by SIZESCALE and
+converts to an integer.  Arguments treated in this way comprise those to
+the escape sequences '\H' and '\s', to the request 'ps', the third
+argument to the 'cs' request, and the second and fourth arguments to the
+'tkf' request.  Scaled points may be specified explicitly with the 'z'
+scaling unit.
+
+   For example, if SIZESCALE is 1000, then a scaled point is one
+thousandth of a point.  The request '.ps 10.5' is synonymous with '.ps
+10.5z' and sets the type size to 10,500 scaled points, or 10.5 points.
+Consequently, in GNU 'troff', the register '.s' can interpolate a
+non-integral type size.
+
+ -- Register: \n.ps
+     This read-only register interpolates the type size in scaled
+     points; it is associated with the environment (*note
+     Environments::).
+
+   It makes no sense to use the 'z' scaling unit in a numeric expression
+whose default scaling unit is neither 'u' nor 'z', so GNU 'troff'
+disallows this.  Similarly, it is nonsensical to use a scaling unit
+other than 'z' or 'u' in a numeric expression whose default scaling unit
+is 'z', and so GNU 'troff' disallows this as well.
+
+   Another GNU 'troff' scaling unit, 's', multiplies by the number of
+basic units in a scaled point.  Thus, '\n.pss' is equal to '1m' by
+definition.  Do not confuse the 's' and 'z' scaling units.
+
+ -- Register: \n.psr
+ -- Register: \n.sr
+     Output devices may be limited in the type sizes they can employ.
+     The '.s' and '.ps' registers represent the type size selected by
+     the output driver as it understands a device's capability.  The
+     last _requested_ type size is interpolated in scaled points by the
+     read-only register '.psr' and in points as a decimal fraction by
+     the read-only string-valued register '.sr'.  Both are associated
+     with the environment (*note Environments::).
+
+     For example, if a type size of 10.95 points is requested, and the
+     nearest size permitted by a 'sizes' request (or by the 'sizes' or
+     'sizescale' directives in the device's 'DESC' file) is 11 points,
+     the output driver uses the latter value.
+
+   The '\s' escape sequence offers the following syntax forms that work
+with fractional type sizes and accept scaling units.  You may of course
+give them integral arguments.  The delimited forms need not use the
+neutral apostrophe; see *note Delimiters::.
+
+'\sN'
+'\s'N''
+     Set the type size to N scaled points; N is a numeric expression
+     with a default scaling unit of 'z'.
+
+'\s+N'
+'\s-N'
+'\s+N'
+'\s-N'
+'\s'+N''
+'\s'-N''
+'\s+'N''
+'\s-'N''
+     Increase or decrease the type size by N scaled points; N is a
+     numeric expression (which may start with a minus sign) with a
+     default scaling unit of 'z'.
+
+   (1) *Note Device and Font Description Files::.
+
+5.21 Colors
+===========
+
+GNU 'troff' supports color output with a variety of color spaces and up
+to 16 bits per channel.  Some devices, particularly terminals, may be
+more limited.  When color support is enabled, two colors are current at
+any given time: the "stroke color", with which glyphs, rules (lines),
+and geometric objects like circles and polygons are drawn, and the "fill
+color", which can be used to paint the interior of a closed geometric
+figure.
+
+ -- Request: .color n
+ -- Register: \n.color
+     If N is missing or non-zero, enable the output of color-related
+     device-independent output commands (this is the default);
+     otherwise, disable them.  This request sets a global flag; it does
+     not produce an input token (*note Gtroff Internals::).
+
+     The read-only register '.color' is 1 if colors are enabled,
+     0 otherwise.
+
+     Color can also be disabled with the '-c' command-line option.
+
+ -- Request: .defcolor ident scheme color-component ...
+     Define a color named IDENT.  SCHEME selects a color space and
+     determines the quantity of required COLOR-COMPONENTs; it must be
+     one of 'rgb' (three components), 'cmy' (three), 'cmyk' (four), or
+     'gray' (one).  'grey' is accepted as a synonym of 'gray'.  The
+     color components can be encoded as a single hexadecimal value
+     starting with '#' or '##'.  The former indicates that each
+     component is in the range 0-255 (0-FF), the latter the range
+     0-65,535 (0-FFFF).
+
+          .defcolor half gray #7f
+          .defcolor pink rgb #FFC0CB
+          .defcolor magenta rgb  ##ffff0000ffff
+
+     Alternatively, each color component can be specified as a decimal
+     fraction in the range 0-1, interpreted using a default scaling unit
+     of 'f', which multiplies its value by 65,536 (but clamps it at
+     65,535).
+
+          .defcolor gray50 rgb 0.5 0.5 0.5
+          .defcolor darkgreen rgb 0.1f 0.5f 0.2f
+
+   Each output device has a color named 'default', which cannot be
+redefined.  A device's default stroke and fill colors are not
+necessarily the same.  For the 'dvi', 'html', 'pdf', 'ps', and 'xhtml'
+output devices, GNU 'troff' automatically loads a macro file defining
+many color names at startup.  By the same mechanism, the devices
+supported by 'grotty' recognize the eight standard ISO 6429/EMCA-48
+color names.(1)  (*note Colors-Footnote-1::)
+
+ -- Request: .gcolor color
+ -- Escape sequence: \mc
+ -- Escape sequence: \m(co
+ -- Escape sequence: \mcolor
+ -- Register: \n.m
+     Set the stroke color to COLOR.
+
+          .gcolor red
+          The next words
+          .gcolor
+          \mredare in red\m
+          and these words are in the previous color.
+
+     The escape sequence '\m' restores the previous stroke color, as
+     does a 'gcolor' request without an argument.
+
+     The name of the current stroke color is available in the read-only
+     string-valued register '.m'; it is associated with the environment
+     (*note Environments::).  It interpolates nothing when the stroke
+     color is the default.
+
+     '\m' doesn't produce an input token in GNU 'troff' (*note Gtroff
+     Internals::).  It therefore can be used in requests like 'mc'
+     (which expects a single character as an argument) to change the
+     color on the fly:
+
+          .mc \mredx\m
+
+ -- Request: .fcolor color
+ -- Escape sequence: \Mc
+ -- Escape sequence: \M(co
+ -- Escape sequence: \Mcolor
+ -- Register: \n.M
+     Set the fill color for objects drawn with '\D'...'' escape
+     sequences.  The escape sequence '\M' restores the previous fill
+     color, as does an 'fcolor' request without an argument.
+
+     The name of the current fill color is available in the read-only
+     string-valued register '.M'; it is associated with the environment
+     (*note Environments::).  It interpolates nothing when the fill
+     color is the default.  '\M' doesn't produce an input token in GNU
+     'troff'.
+
+     Create an ellipse with a red interior as follows.
+
+          \Mred\h'0.5i'\D'E 2i 1i'\M
+
+   (1) also known vulgarly as "ANSI colors"
+
+5.22 Strings
+============
+
+GNU 'troff' supports strings primarily for user convenience.
+Conventionally, if one would define a macro only to interpolate a small
+amount of text, without invoking requests or calling any other macros,
+one defines a string instead.  Only one string is predefined by the
+language.
+
+ -- String: \*.T
+     Contains the name of the output device (for example, 'utf8' or
+     'pdf').
+
+   The 'ds' request creates a string with a specified name and contents
+and the '\*' escape sequence dereferences its name, interpolating its
+contents.  If the string named by the '\*' escape sequence does not
+exist, it is defined as empty, nothing is interpolated, and a warning in
+category 'mac' is emitted.  *Note Warnings::, for information about the
+enablement and suppression of warnings.
+
+ -- Request: .ds name contents
+ -- Request: .ds1 name contents
+ -- Escape sequence: \*n
+ -- Escape sequence: \*(nm
+ -- Escape sequence: \*name arg1 arg2 ...
+     Define a string called NAME with contents CONTENTS.  If NAME
+     already exists as an alias, the target of the alias is redefined;
+     see 'als' and 'rm' below.  If 'ds' is called with only one
+     argument, NAME is defined as an empty string.  Otherwise, GNU
+     'troff' stores CONTENTS in copy mode.(1)  (*note
+     Strings-Footnote-1::)
+
+     The '\*' escape sequence interpolates a previously defined string
+     variable NAME (one-character name N, two-character name NM).  The
+     bracketed interpolation form accepts arguments that are handled as
+     macro arguments are; recall *note Calling Macros::.  In contrast to
+     macro calls, however, if a closing bracket '' occurs in a string
+     argument, that argument must be enclosed in double quotes.  '\*' is
+     interpreted even in copy mode.  When defining strings, argument
+     interpolations must be escaped if they are to reference parameters
+     from the calling context; *Note Parameters::.
+
+          .ds cite (\\$1, \\$2)
+          Gray codes are explored in \*cite Morgan 1998.
+              => Gray codes are explored in (Morgan, 1998).
+
+     *Caution:* Unlike other requests, the second argument to the 'ds'
+     request consumes the remainder of the input line, including
+     trailing spaces.  This means that comments on a line with such a
+     request can introduce unwanted space into a string when they are
+     set off from the material they annotate, as is conventional.
+
+          .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O \" water
+
+     Instead, place the comment on another line or put the comment
+     escape sequence immediately adjacent to the last character of the
+     string.
+
+          .ds H2O H\v'+.3m'\s'-2'2\v'-.3m'\s0O\" water
+
+     Ending string definitions (and appendments) with a comment, even an
+     empty one, prevents unwanted space from creeping into them during
+     source document maintenance.
+
+          .ds author Alice Pleasance Liddell\"
+          .ds empty \" might be appended to later with .as
+
+     An initial neutral double quote '"' in CONTENTS is stripped to
+     allow embedding of leading spaces.  Any other '"' is interpreted
+     literally, but it is wise to use the special character escape
+     sequence '\dq' instead if the string might be interpolated as
+     part of a macro argument; see *note Calling Macros::.
+
+          .ds salutation "         Yours in a white wine sauce,\"
+          .ds c-var-defn "  char mydate=\dq2020-07-29\dq;\"
+
+     Strings are not limited to a single input line of text.  '\<RET>'
+     works just as it does elsewhere.  The resulting string is stored
+     _without_ the newlines.  Care is therefore required when
+     interpolating strings while filling is disabled.
+
+          .ds foo This string contains \
+          text on multiple lines \
+          of input.
+
+     It is not possible to embed a newline in a string that will be
+     interpreted as such when the string is interpolated.  To achieve
+     that effect, use '\*' to interpolate a macro instead; see *note
+     Punning Names::.
+
+     Because strings are similar to macros, they too can be defined so
+     as to suppress AT&T 'troff' compatibility mode when used; see *note
+     Writing Macros:: and *note Compatibility Mode::.  The 'ds1' request
+     defines a string such that compatibility mode is off when the
+     string is later interpolated.  To be more precise, a "compatibility
+     save" input token is inserted at the beginning of the string, and a
+     "compatibility restore" input token at the end.
+
+          .nr xxx 12345
+          .ds aa The value of xxx is \\nxxx.
+          .ds1 bb The value of xxx is \\nxxx.
+          .
+          .cp 1
+          .
+          \*(aa
+              error-> warning: register '' not defined
+              => The value of xxx is 0xxx.
+          \*(bb
+              => The value of xxx is 12345.
+
+ -- Request: .as name contents
+ -- Request: .as1 name contents
+     The 'as' request is similar to 'ds' but appends CONTENTS to the
+     string stored as NAME instead of redefining it.  If NAME doesn't
+     exist yet, it is created.  If 'as' is called with only one
+     argument, no operation is performed (beyond dereferencing the
+     string).
+
+          .as salutation " with shallots, onions and garlic,\"
+
+     The 'as1' request is similar to 'as', but compatibility mode is
+     switched off when the appended portion of the string is later
+     interpolated.  To be more precise, a "compatibility save" input
+     token is inserted at the beginning of the appended string, and a
+     "compatibility restore" input token at the end.
+
+   Several requests exist to perform rudimentary string operations.
+Strings can be queried ('length') and modified ('chop', 'substring',
+'stringup', 'stringdown'), and their names can be manipulated through
+renaming, removal, and aliasing ('rn', 'rm', 'als').
+
+ -- Request: .length reg anything
+     Compute the number of characters of ANYTHING and store the count in
+     the register REG.  If REG doesn't exist, it is created.  ANYTHING
+     is read in copy mode.
+
+          .ds xxx abcd\h'3i'efgh
+          .length yyy \*xxx
+          \nyyy
+              => 14
+
+ -- Request: .chop object
+     Remove the last character from the macro, string, or diversion
+     named OBJECT.  This is useful for removing the newline from the end
+     of a diversion that is to be interpolated as a string.  This
+     request can be used repeatedly on the same OBJECT; see *note Gtroff
+     Internals::, for details on nodes inserted additionally by GNU
+     'troff'.
+
+ -- Request: .substring str start end
+     Replace the string named STR with its substring bounded by the
+     indices START and END, inclusively.  The first character in the
+     string has index 0.  If END is omitted, it is implicitly set to the
+     largest valid value (the string length minus one).  Negative
+     indices count backward from the end of the string: the last
+     character has index -1, the character before the last has index -2,
+     and so on.
+
+          .ds xxx abcdefgh
+          .substring xxx 1 -4
+          \*xxx
+              => bcde
+          .substring xxx 2
+          \*xxx
+              => de
+
+ -- Request: .stringdown str
+ -- Request: .stringup str
+     Alter the string named STR by replacing each of its bytes with its
+     lowercase ('stringdown') or uppercase ('stringup') version (if one
+     exists).  Special characters in the string will often transform in
+     the expected way due to the regular naming convention for accented
+     characters.  When they do not, use substrings and/or catenation.
+
+          .ds resume R\'esum\'e
+          \*resume
+          .stringdown resume
+          \*resume
+          .stringup resume
+          \*resume
+              => Résumé résumé RÉSUMÉ
+
+   (In practice, we would end the 'ds' request with a comment escape
+'\"' to prevent space from creeping into the definition during source
+document maintenance.)
+
+ -- Request: .rn old new
+     Rename the request, macro, diversion, or string OLD to NEW.
+
+ -- Request: .rm name
+     Remove the request, macro, diversion, or string NAME.  GNU 'troff'
+     treats subsequent invocations as if the name had never been
+     defined.
+
+ -- Request: .als new old
+     Create an alias NEW for the existing request, string, macro, or
+     diversion object named OLD, causing the names to refer to the same
+     stored object.  If OLD is undefined, a warning in category 'mac' is
+     produced, and the request is ignored.  *Note Warnings::, for
+     information about the enablement and suppression of warnings.
+
+     To understand how the 'als' request works, consider two different
+     storage pools: one for objects (macros, strings, etc.), and another
+     for names.  As soon as an object is defined, GNU 'troff' adds it to
+     the object pool, adds its name to the name pool, and creates a link
+     between them.  When 'als' creates an alias, it adds a new name to
+     the name pool that gets linked to the same object as the old name.
+
+     Now consider this example.
+
+          .de foo
+          ..
+          .
+          .als bar foo
+          .
+          .de bar
+          .  foo
+          ..
+          .
+          .bar
+              error-> input stack limit exceeded (probable infinite
+              error-> loop)
+
+     In the above, 'bar' remains an _alias_--another name for--the
+     object referred to by 'foo', which the second 'de' request
+     replaces.  Alternatively, imagine that the 'de' request
+     _dereferences_ its argument before replacing it.  Either way, the
+     result of calling 'bar' is a recursive loop that finally leads to
+     an error.  *Note Writing Macros::.
+
+     To remove an alias, call 'rm' on its name.  The object itself is
+     not destroyed until it has no more names.
+
+     When a request, macro, string, or diversion is aliased,
+     redefinitions and appendments "write through" alias names.  To
+     replace an alias with a separately defined object, you must use the
+     'rm' request on its name first.
+
+   (1) *Note Copy Mode::.
+
+5.23 Conditionals and Loops
+===========================
+
+'groff' has 'if' and 'while' control structures like other languages.
+However, the syntax for grouping multiple input lines in the branches or
+bodies of these structures is unusual.
+
+5.23.1 Operators in Conditionals
+--------------------------------
+
+In 'if', 'ie', and 'while' requests, in addition to the numeric
+expressions described in *note Numeric Expressions::, several Boolean
+operators are available; the members of this expanded class are termed
+"conditional expressions".
+
+'c GLYPH'
+     True if GLYPH is available, where GLYPH is an ordinary character, a
+     special character '\(XX' or '\XXX', '\N'XXX'', or has been
+     defined by any of the 'char', 'fchar', 'fschar', or 'schar'
+     requests.
+
+'d NAME'
+     True if a string, macro, diversion, or request called NAME exists.
+
+'e'
+     True if the current page is even-numbered.
+
+'F FONT'
+     True if FONT exists.  FONT is handled as if it were opened with the
+     'ft' request (that is, font translation and styles are applied),
+     without actually mounting it.
+
+'m COLOR'
+     True if COLOR is defined.
+
+'n'
+     True if the document is being processed in 'nroff' mode.  *Note
+     troff and nroff Modes::.
+
+'o'
+     True if the current page is odd-numbered.
+
+'r REGISTER'
+     True if REGISTER exists.
+
+'S STYLE'
+     True if STYLE is available for the current font family.  Font
+     translation is applied.
+
+'t'
+     True if the document is being processed in 'troff' mode.  *Note
+     troff and nroff Modes::.
+
+'v'
+     Always false.  This condition is recognized only for compatibility
+     with certain other 'troff' implementations.(1)  (*note Operators in
+     Conditionals-Footnote-1::)
+
+   If the first argument to an 'if', 'ie', or 'while' request begins
+with a non-alphanumeric character apart from '!' (see below); it
+performs an output comparison test.  (2)  (*note Operators in
+Conditionals-Footnote-2::)
+
+''XXX'YYY''
+     True if formatting the comparands XXX and YYY produces the same
+     output commands.  The delimiter need not be a neutral apostrophe:
+     the output comparison operator accepts the same delimiters as most
+     escape sequences; see *note Delimiters::.  This "output comparison
+     operator" formats XXX and YYY in separate environments; after the
+     comparison, the resulting data are discarded.
+
+          .ie "|"\fR|\fP" true
+          .el false
+              => true
+
+     The resulting glyph properties, including font family, style, size,
+     and slant, must match, but not necessarily the requests and/or
+     escape sequences used to obtain them.  In the previous example, '|'
+     and '\fR|\fP' result in '|' glyphs in the same typefaces at the
+     same positions, so the comparands are equal.  If '.ft I' had been
+     added before the '.ie', they would differ: the first '|' would
+     produce an italic '|', not a roman one.  Motions must match in
+     orientation and magnitude to within the applicable horizontal and
+     vertical motion quanta of the device, after rounding.  '.if
+     "\u\d"\v'0'"' is false even though both comparands result in zero
+     net motion, because motions are not interpreted or optimized but
+     sent as-is to the output.(3)  (*note Operators in
+     Conditionals-Footnote-3::) On the other hand, '.if "\d"\v'0.5m'"'
+     is true, because '\d' is defined as a downward motion of one-half
+     em.(4)  (*note Operators in Conditionals-Footnote-4::)
+
+     Surround the comparands with '\?' to avoid formatting them; this
+     causes them to be compared character by character, as with string
+     comparisons in other programming languages.
+
+          .ie "\?|\?"\?\fR|\fP\?" true
+          .el false
+              => false
+
+     Since comparands protected with '\?' are read in copy mode (*note
+     Copy Mode::), they need not even be valid 'groff' syntax.  The
+     escape character is still lexically recognized, however, and
+     consumes the next character.
+
+          .ds a \
+          .ds b \
+          .if '\?\*a\?'\?\*b\?' a and b equivalent
+          .if '\?\\?'\?\\?' backslashes equivalent
+              => a and b equivalent
+
+   The above operators can't be combined with most others, but a leading
+'!', not followed immediately by spaces or tabs, complements an
+expression.
+
+     .nr x 1
+     .ie !r x register x is not defined
+     .el      register x is defined
+         => register x is defined
+
+   Spaces and tabs are optional immediately after the 'c', 'd', 'F',
+'m', 'r', and 'S' operators, but right after '!', they end the predicate
+and the conditional evaluates true.(5)  (*note Operators in
+Conditionals-Footnote-5::)
+
+     .nr x 1
+     .ie ! r x register x is not defined
+     .el       register x is defined
+         => r x register x is not defined
+
+The unexpected 'r x' in the output is a clue that our conditional was
+not interpreted as we planned, but matters may not always be so obvious.
+
+   (1) This refers to 'vtroff', a translator that would convert the
+C/A/T output from early-vintage AT&T 'troff' to a form suitable for
+Versatec and Benson-Varian plotters.
+
+   (2) Strictly, letters not otherwise recognized _are_ treated as
+output comparison delimiters.  For portability, it is wise to avoid
+using letters not in the list above; for example, Plan 9 'troff' uses
+'h' to test a mode it calls 'htmlroff', and GNU 'troff' may provide
+additional operators in the future.
+
+   (3) Because formatting of the comparands takes place in a dummy
+environment, vertical motions within them cannot spring traps.
+
+   (4) All of this is to say that the lists of output nodes created by
+formatting XXX and YYY must be identical.  *Note Gtroff Internals::.
+
+   (5) This bizarre behavior maintains compatibility with AT&T 'troff'.
+
+5.23.2 if-then
+--------------
+
+ -- Request: .if cond-expr anything
+     Evaluate the conditional expression COND-EXPR, and if it evaluates
+     true (or to a positive value), interpret the remainder of the line
+     ANYTHING as if it were an input line.  Recall from *note Invoking
+     Requests:: that any quantity of spaces between arguments to
+     requests serves only to separate them; leading spaces in ANYTHING
+     are thus not seen.  ANYTHING effectively _cannot_ be omitted; if
+     COND-EXPR is true and ANYTHING is empty, the newline at the end of
+     the control line is interpreted as a blank input line (and
+     therefore a blank text line).
+
+          super\c
+          tanker
+          .nr force-word-break 1
+          super\c
+          .if ((\nforce-word-break = 1) & \n.int)
+          tanker
+              => supertanker super tanker
+
+ -- Request: .nop anything
+     Interpret ANYTHING as if it were an input line.  This is similar to
+     '.if 1'.  'nop' is not really "no operation"; its argument _is_
+     processed--unconditionally.  It can be used to cause text lines to
+     share indentation with surrounding control lines.
+
+          .als real-MAC MAC
+          .de wrapped-MAC
+          .  tm MAC: called with arguments \\$@
+          .  nop \\*real-MAC\\
+          ..
+          .als MAC wrapped-MAC
+          \# Later...
+          .als MAC real-MAC
+
+     In the above, we've used aliasing, 'nop', and the interpolation of
+     a macro as a string to interpose a wrapper around the macro 'MAC'
+     (perhaps to debug it).
+
+5.23.3 if-else
+--------------
+
+ -- Request: .ie cond-expr anything
+ -- Request: .el anything
+     Use the 'ie' and 'el' requests to write an if-then-else.  The first
+     request is the "if" part and the latter is the "else" part.
+     Unusually among programming languages, any number of
+     non-conditional requests may be interposed between the 'ie' branch
+     and the 'el' branch.
+
+          .nr a 0
+          .ie \na a is non-zero.
+          .nr a +1
+          .el a was not positive but is now \na.
+              => a was not positive but is now 1.
+
+     Another way in which 'el' is an ordinary request is that it does
+     not lexically "bind" more tightly to its 'ie' counterpart than it
+     does to any other request.  This fact can surprise C programmers.
+
+          .nr a 1
+          .nr z 0
+          .ie \nz \
+          .  ie \na a is true
+          .  el     a is false
+          .el z is false
+              error-> warning: unbalanced 'el' request
+              => a is false
+
+     To conveniently nest conditionals, keep reading.
+
+5.23.4 Conditional Blocks
+-------------------------
+
+It is frequently desirable for a control structure to govern more than
+one request, macro call, text line, or a combination of the foregoing.
+The opening and closing brace escape sequences '\{' and '\}' define such
+groups.  These "conditional blocks" can furthermore be nested.
+
+ -- Escape sequence: \{
+ -- Escape sequence: \}
+     '\{' begins a conditional block; it must appear (after optional
+     spaces and tabs) immediately subsequent to the conditional
+     expression of an 'if', 'ie', or 'while' request,(1) (*note
+     Conditional Blocks-Footnote-1::) or as the argument to an 'el'
+     request.
+
+     '\}' ends a condition block and should appear on a line with other
+     occurrences of itself as necessary to match '\{' sequences.  It can
+     be preceded by a control character, spaces, and tabs.  Input after
+     any quantity of '\}' sequences on the same line is processed only
+     if all of the preceding conditions to which they correspond are
+     true.  Furthermore, a '\}' closing the body of a 'while' request
+     must be the last such escape sequence on an input line.
+
+     Brace escape sequences outside of control structures have no
+     meaning and produce no output.
+
+     *Caution:* Input lines using '\{' often end with '\RET', especially
+     in macros that consist primarily of control lines.  Forgetting to
+     use '\RET' on an input line after '\{' is a common source of error.
+
+   We might write the following in a page header macro.  If we delete
+'\RET', the header will carry an unwanted extra empty line (except on
+page 1).
+
+     .if (\\n% != 1) \{\
+     .  ie ((\\n% % 2) = 0) .tl \\*even-numbered-page-title
+     .  el                    .tl \\*odd-numbered-page-title
+     .\}
+
+   Let us take a closer look at how conditional blocks nest.
+
+     A
+     .if 0 \{ B
+     C
+     D
+     \}E
+     F
+         => A F
+
+     N
+     .if 1 \{ O
+     .  if 0 \{ P
+     Q
+     R\} S\} T
+     U
+         => N O U
+
+   The above behavior may challenge the intuition; it was implemented to
+retain compatibility with AT&T 'troff'.  For clarity, it is idiomatic to
+end input lines with '\{' (followed by '\<RET>' if appropriate), and to
+precede '\}' on an input line with nothing more than a control
+character, spaces, tabs, and other instances of itself.
+
+   We can use 'ie', 'el', and conditional blocks to simulate the
+multi-way "switch" or "case" control structures of other languages.  The
+following example is adapted from the 'groff' 'man' package.
+Indentation is used to clarify the logic.
+
+     .\" Simulate switch/case in roff.
+     .      ie '\\$2'1' .ds title General Commands\"
+     .el \{.ie '\\$2'2' .ds title System Calls\"
+     .el \{.ie '\\$2'3' .ds title Library Functions\"
+     .el \{.ie '\\$2'4' .ds title Kernel Interfaces\"
+     .el \{.ie '\\$2'5' .ds title File Formats\"
+     .el \{.ie '\\$2'6' .ds title Games\"
+     .el \{.ie '\\$2'7' .ds title Miscellaneous Information\"
+     .el \{.ie '\\$2'8' .ds title System Management\"
+     .el \{.ie '\\$2'9' .ds title Kernel Development\"
+     .el                .ds title \" empty
+     .\}\}\}\}\}\}\}\}
+
+   (1) *Note while::.
+
+5.23.5 while
+------------
+
+'groff' provides a looping construct: the 'while' request.  Its syntax
+matches the 'if' request.
+
+ -- Request: .while cond-expr anything
+     Evaluate the conditional expression COND-EXPR, and repeatedly
+     execute ANYTHING unless and until COND-EXPR evaluates false.
+     ANYTHING, which is often a conditional block, is referred to as the
+     'while' request's "body".
+
+          .nr a 0 1
+          .while (\na < 9) \{\
+          \n+a,
+          .\}
+          \n+a
+              => 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
+
+     GNU 'troff' treats the body of a 'while' request similarly to that
+     of a 'de' request (albeit one not read in copy mode(1) (*note
+     while-Footnote-1::)), but stores it under an internal name and
+     deletes it when the loop finishes.  The operation of a macro
+     containing a 'while' request can slow significantly if the 'while'
+     body is large.  Each time the macro is executed, the 'while' body
+     is parsed and stored again.
+
+          .de xxx
+          .  nr num 10
+          .  while (\\nnum > 0) \{\
+          .    \" many lines of code
+          .    nr num -1
+          .  \}
+          ..
+
+     An often better solution--and one that is more portable, since AT&T
+     'troff' lacked the 'while' request--is to instead write a recursive
+     macro.  It will be parsed only once.(2)  (*note while-Footnote-2::)
+
+          .de yyy
+          .  if (\\nnum > 0) \{\
+          .    \" many lines of code
+          .    nr num -1
+          .    yyy
+          .  \}
+          ..
+          .
+          .de xxx
+          .  nr num 10
+          .  yyy
+          ..
+
+     To prevent infinite loops, the default number of available
+     recursion levels is 1,000 or somewhat less.(3)  (*note
+     while-Footnote-3::) You can disable this protective measure, or
+     raise the limit, by setting the 'slimit' register.  *Note
+     Debugging::.
+
+     As noted above, if a 'while' body begins with a conditional block,
+     its closing brace must end an input line.
+
+          .if 1 \{\
+          .  nr a 0 1
+          .  while (\na < 10) \{\
+          .    nop \n+a
+          .\}\}
+              error-> unbalanced brace escape sequences
+
+ -- Request: .break
+     Exit a 'while' loop.  Do not confuse this request with a
+     typographical break or the 'br' request.
+
+ -- Request: .continue
+     Skip the remainder of a 'while' loop's body, immediately starting
+     the next iteration.
+
+   (1) *Note Copy Mode::.
+
+   (2) unless you redefine it
+
+   (3) "somewhat less" because things other than macro calls can be on
+the input stack
+
+5.24 Writing Macros
+===================
+
+A "macro" is a stored collection of text and control lines that can be
+interpolated multiple times.  Use macros to define common operations.
+Macros are called in the same way that requests are invoked.  While
+requests exist for the purpose of creating macros, simply calling an
+undefined macro, or interpolating it as a string, will cause it to be
+defined as empty.  *Note Identifiers::.
+
+ -- Request: .de name end
+     Define a macro NAME, replacing the definition of any existing
+     request, macro, string, or diversion called NAME.  If NAME already
+     exists as an alias, the target of the alias is redefined; recall
+     *note Strings::.  GNU 'troff' enters copy mode,(1) (*note Writing
+     Macros-Footnote-1::) storing subsequent input lines as the macro
+     definition.  If the optional second argument is not specified, the
+     definition ends with the control line '..' (two dots).
+     Alternatively, END identifies a macro whose call syntax at the
+     start of a control line ends the definition of NAME; END is then
+     called normally.  A macro definition must end in the same
+     conditional block (if any) in which it began (*note Conditional
+     Blocks::).  Spaces or tabs are permitted after the control
+     character in the line containing this ending token (either '.' or
+     'END'), but a tab immediately after the token prevents its
+     recognition as the end of a macro definition.  The macro END can be
+     called with arguments.(2)  (*note Writing Macros-Footnote-2::)
+
+     Here is a small example macro called 'P' that causes a break and
+     inserts some vertical space.  It could be used to separate
+     paragraphs.
+
+          .de P
+          .  br
+          .  sp .8v
+          ..
+
+     We can define one macro within another.  Attempting to nest '..'
+     naïvely will end the outer definition because the inner definition
+     isn't interpreted as such until the outer macro is later
+     interpolated.  We can use an end macro instead.  Each level of
+     nesting should use a unique end macro.
+
+     An end macro need not be defined until it is called.  This fact
+     enables a nested macro definition to begin inside one macro and end
+     inside another.  Consider the following example.(3)  (*note Writing
+     Macros-Footnote-3::)
+
+          .de m1
+          .  de m2 m3
+          you
+          ..
+          .de m3
+          Hello,
+          Joe.
+          ..
+          .de m4
+          do
+          ..
+          .m1
+          know?
+          .  m3
+          What
+          .m4
+          .m2
+              => Hello, Joe.  What do you know?
+
+     A nested macro definition _can_ be terminated with '..' and nested
+     macros _can_ reuse end macros, but these control lines must be
+     escaped multiple times for each level of nesting.  The necessity of
+     this escaping and the utility of nested macro definitions will
+     become clearer when we employ macro parameters and consider the
+     behavior of copy mode in detail.
+
+   'de' defines a macro that inherits the compatibility mode enablement
+status of its context (*note Implementation Differences::).  Often it is
+desirable to make a macro that uses 'groff' features callable from
+contexts where compatibility mode is on; for instance, when writing
+extensions to a historical macro package.  To achieve this,
+compatibility mode needs to be switched off while such a macro is
+interpreted--without disturbing that state when it is finished.
+
+ -- Request: .de1 name end
+     The 'de1' request defines a macro to be interpreted with
+     compatibility mode disabled.  When NAME is called, compatibility
+     mode enablement status is saved; it is restored when the call
+     completes.  Observe the extra backlash before the interpolation of
+     register 'xxx'; we'll explore this subject in *note Copy Mode::.
+
+          .nr xxx 12345
+          .de aa
+          The value of xxx is \\nxxx.
+          .  br
+          ..
+          .de1 bb
+          The value of xxx is \\nxxx.
+          ..
+          .cp 1
+          .aa
+              error-> warning: register '' not defined
+              => The value of xxx is 0xxx.
+          .bb
+              => The value of xxx is 12345.
+
+ -- Request: .dei name end
+ -- Request: .dei1 name end
+     The 'dei' request defines a macro with its name and end macro
+     indirected through strings.  That is, it interpolates strings named
+     NAME and END before performing the definition.
+
+     The following examples are equivalent.
+
+          .ds xx aa
+          .ds yy bb
+          .dei xx yy
+
+          .de aa bb
+
+     The 'dei1' request bears the same relationship to 'dei' as 'de1'
+     does to 'de'; it temporarily turns compatibility mode off when NAME
+     is called.
+
+ -- Request: .am name end
+ -- Request: .am1 name end
+ -- Request: .ami name end
+ -- Request: .ami1 name end
+     'am' appends subsequent input lines to macro NAME, extending its
+     definition, and otherwise working as 'de' does.
+
+     To make the previously defined 'P' macro set indented instead of
+     block paragraphs, add the necessary code to the existing macro.
+
+          .am P
+          .ti +5n
+          ..
+
+     The other requests are analogous to their 'de' counterparts.  The
+     'am1' request turns off compatibility mode during interpretation of
+     the appendment.  The 'ami' request appends indirectly, meaning that
+     strings NAME and END are interpolated with the resulting names used
+     before appending.  The 'ami1' request is similar to 'ami',
+     disabling compatibility mode during interpretation of the appended
+     lines.
+
+   Using 'trace.tmac', you can trace calls to 'de', 'de1', 'am', and
+'am1'.  You can also use the 'backtrace' request at any point desired to
+troubleshoot tricky spots (*note Debugging::).
+
+   *Note Strings::, for the 'als', 'rm', and 'rn' requests to create an
+alias of, remove, and rename a macro, respectively.
+
+   Macro identifiers share their name space with requests, strings, and
+diversions; see *note Identifiers::.  The 'am', 'as', 'da', 'de', 'di',
+and 'ds' requests (together with their variants) create a new object
+only if the name of the macro, diversion, or string is currently
+undefined or if it is defined as a request; normally, they modify the
+value of an existing object.  *Note the description of the 'als'
+request: als, for pitfalls when redefining a macro that is aliased.
+
+ -- Request: .return anything
+     Exit a macro, immediately returning to the caller.  If called with
+     an argument ANYTHING, exit twice--the current macro and the macro
+     one level higher.  This is used to define a wrapper macro for
+     'return' in 'trace.tmac'.
+
+   (1) *Note Copy Mode::.
+
+   (2) While it is possible to define and call a macro '.', you can't
+use it as an end macro: during a macro definition, '..' is never handled
+as calling '.', even if '.de NAME .' explicitly precedes it.
+
+   (3) Its structure is adapted from, and isomorphic to, part of a
+solution by Tadziu Hoffman to the problem of reflowing text multiple
+times to find an optimal configuration for it.
+<https://lists.gnu.org/archive/html/groff/2008-12/msg00006.html>
+
+5.24.1 Parameters
+-----------------
+
+Macro calls and string interpolations optionally accept a list of
+arguments; recall *note Calling Macros::.  At the time such an
+interpolation takes place, these "parameters" can be examined using a
+register and a variety of escape sequences starting with '\$'.  All such
+escape sequences are interpreted even in copy mode, a fact we shall
+motivate and explain below (*note Copy Mode::).
+
+ -- Register: \n.$
+     The count of parameters available to a macro or string is kept in
+     this read-only register.  The 'shift' request can change its value.
+
+   Any individual parameter can be accessed by its position in the list
+of arguments to the macro call, numbered from left to right starting at
+1, with one of the following escape sequences.
+
+ -- Escape sequence: \$n
+ -- Escape sequence: \$(nn
+ -- Escape sequence: \$nnn
+     Interpolate the Nth, NNth, or NNNth parameter.  The first form
+     expects only a single digit (1<=N<=9)), the second two digits
+     (01<=NN<=99)), and the third any positive integer NNN.  Macros and
+     strings accept an unlimited number of parameters.
+
+ -- Request: .shift n
+     Shift the parameters N places (1 by default).  This is a "left
+     shift": what was parameter I becomes parameter I-N.  The parameters
+     formerly in positions 1 to N are no longer available.  Shifting by
+     a non-positive amount performs no operation.  The register '.$' is
+     adjusted accordingly.
+
+   In practice, parameter interpolations are usually seen prefixed with
+an extra escape character.  This is because the '\$' family of escape
+sequences is interpreted even in copy mode.(1)  (*note
+Parameters-Footnote-1::)
+
+ -- Escape sequence: \$*
+ -- Escape sequence: \$@
+ -- Escape sequence: \$^
+     In some cases it is convenient to interpolate all of the parameters
+     at once (to pass them to a request, for instance).  The '\$*'
+     escape concatenates the parameters, separating them with spaces.
+     '\$@' is similar, concatenating the parameters, surrounding each
+     with double quotes and separating them with spaces.  If not in
+     compatibility mode, the interpolation depth of double quotes is
+     preserved (*note Calling Macros::).  '\$^' interpolates all
+     parameters as if they were arguments to the 'ds' request.
+
+          .de foo
+          . tm $1='\\$1'
+          . tm $2='\\$2'
+          . tm $*='\\$*'
+          . tm $@='\\$@'
+          . tm $^='\\$^'
+          ..
+          .foo " This is a "test"
+              error-> $1=' This is a '
+              error-> $2='test"'
+              error-> $*=' This is a  test"'
+              error-> $@='" This is a " "test""'
+              error-> $^='" This is a "test"'
+
+     '\$*' is useful when writing a macro that doesn't need to
+     distinguish its arguments, or even to not interpret them; examples
+     include macros that produce diagnostic messages by wrapping the
+     'tm' or 'ab' requests.  Use '\$@' when writing a macro that may
+     need to shift its parameters and/or wrap a macro or request that
+     finds the count significant.  If in doubt, prefer '\$@' to '\$*'.
+     An application of '\$^' is seen in 'trace.tmac', which redefines
+     some requests and macros for debugging purposes.
+
+ -- Escape sequence: \$0
+     Interpolate the name by which the macro being interpreted was
+     called.  The 'als' request can cause a macro to have more than one
+     name.  Applying string interpolation to a macro does not change
+     this name.
+
+          .de foo
+          .  tm \\$0
+          ..
+          .als bar foo
+          .
+          .de aaa
+          .  foo
+          ..
+          .de bbb
+          .  bar
+          ..
+          .de ccc
+          \\*foo\\
+          ..
+          .de ddd
+          \\*bar\\
+          ..
+          .
+          .aaa
+              error-> foo
+          .bbb
+              error-> bar
+          .ccc
+              error-> ccc
+          .ddd
+              error-> ddd
+
+   (1) If they were not, parameter interpolations would be similar to
+command-line parameters--fixed for the entire duration of a 'roff'
+program's run.  The advantage of interpolating '\$' escape sequences
+even in copy mode is that they can interpolate different contents from
+one call to the next, like function parameters in a procedural language.
+The additional escape character is the price of this power.
+
+5.24.2 Copy Mode
+----------------
+
+When GNU 'troff' processes certain requests, most importantly those
+which define or append to a macro or string, it does so in "copy mode":
+it copies the characters of the definition into a dedicated storage
+region, interpolating the escape sequences '\n', '\g', '\$', '\*', '\V',
+and '\?' normally; interpreting '\<RET>' immediately; discarding
+comments '\"' and '\#'; interpolating the current leader, escape, or tab
+character with '\a', '\e', and '\t', respectively; and storing all other
+escape sequences in an encoded form.
+
+   The complement of copy mode--a 'roff' formatter's behavior when not
+defining or appending to a macro, string, or diversion--where all macros
+are interpolated, requests invoked, and valid escape sequences processed
+immediately upon recognition, can be termed "interpretation mode".
+
+ -- Escape sequence: \\
+     The escape character, '\' by default, can escape itself.  This
+     enables you to control whether a given '\n', '\g', '\$', '\*',
+     '\V', or '\?' escape sequence is interpreted at the time the macro
+     containing it is defined, or later when the macro is called.(1)
+     (*note Copy Mode-Footnote-1::)
+
+          .nr x 20
+          .de y
+          .nr x 10
+          \&\nx
+          \&\\nx
+          ..
+          .y
+              => 20 10
+
+     You can think of '\\' as a "delayed" backslash; it is the escape
+     character followed by a backslash from which the escape character
+     has removed its special meaning.  Consequently, '\\' is not an
+     escape sequence in the usual sense.  In any escape sequence '\X'
+     that GNU 'troff' does not recognize, the escape character is
+     ignored and X is output.  An unrecognized escape sequence causes a
+     warning in category 'escape', with two exceptions--'\\' is the
+     first.
+
+ -- Escape sequence: \.
+     '\.' escapes the control character.  It is similar to '\\' in that
+     it isn't a true escape sequence.  It is used to permit nested macro
+     definitions to end without a named macro call to conclude them.
+     Without a syntax for escaping the control character, this would not
+     be possible.
+
+          .de m1
+          foo
+          .
+          .  de m2
+          bar
+          \\..
+          .
+          ..
+          .m1
+          .m2
+              => foo bar
+
+     The first backslash is consumed while the macro is read, and the
+     second is interpreted when macro 'm1' is called.
+
+   'roff' documents should not use the '\\' or '\.' character sequences
+outside of copy mode; they serve only to obfuscate the input.  Use '\e'
+to represent the escape character, '\rs' to obtain a backslash glyph,
+and '\&' before '.' and ''' where GNU 'troff' expects them as control
+characters if you mean to use them literally (recall *note Requests and
+Macros::).
+
+   Macro definitions can be nested to arbitrary depth.  The mechanics of
+parsing the escape character have significant consequences for this
+practice.
+
+     .de M1
+     \\$1
+     .  de M2
+     \\\\$1
+     .    de M3
+     \\\\\\\\$1
+     \\\\..
+     .    M3 hand.
+     \\..
+     .  M2 of
+     ..
+     This understeer is getting
+     .M1 out
+         => This understeer is getting out of hand.
+
+   Each escape character is interpreted twice--once in copy mode, when
+the macro is defined, and once in interpretation mode, when the macro is
+called.  As seen above, this fact leads to exponential growth in the
+quantity of escape characters required to delay interpolation of '\n',
+'\g', '\$', '\*', '\V', and '\?' at each nesting level, which can be
+daunting.  GNU 'troff' offers a solution.
+
+ -- Escape sequence: \E
+     '\E' represents an escape character that is not interpreted in copy
+     mode.  You can use it to ease the writing of nested macro
+     definitions.
+
+          .de M1
+          .  nop \E$1
+          .  de M2
+          .    nop \E$1
+          .    de M3
+          .      nop \E$1
+          \\\\..
+          .    M3 better.
+          \\..
+          .  M2 bit
+          ..
+          This vehicle handles
+          .M1 a
+              => This vehicle handles a bit better.
+
+     Observe that because '\.' is not a true escape sequence, we can't
+     use '\E' to keep '..' from ending a macro definition prematurely.
+     If the multiplicity of backslashes complicates maintenance, use end
+     macros.
+
+     '\E' is also convenient to define strings containing escape
+     sequences that need to work when used in copy mode (for example, as
+     macro arguments), or which will be interpolated at varying macro
+     nesting depths.  We might define strings to begin and end
+     superscripting as follows.(2)  (*note Copy Mode-Footnote-2::)
+
+          .ds { \v'-.9m\s'\En.s*7u/10u'+.7m'
+          .ds } \v'-.7m\s0+.9m'
+
+     When the 'ec' request is used to redefine the escape character,
+     '\E' also makes it easier to distinguish the semantics of an escape
+     character from the other meaning(s) its character might have.
+     Consider the use of an unusual escape character, '-'.
+
+          .nr a 1
+          .ec -
+          .de xx
+          --na
+          ..
+          .xx
+              => -na
+
+     This result may surprise you; some people expect '1' to be output
+     since register 'a' has clearly been defined with that value.  What
+     has happened?  The robotic replacement of '\' with '-' has led us
+     astray.  You might recognize the sequence '--' more readily with
+     the default escape character as '\-', the special character escape
+     sequence for the minus sign glyph.
+
+          .nr a 1
+          .ec -
+          .de xx
+          -Ena
+          ..
+          .xx
+              => 1
+
+   (1) Compare this to the '\def' and '\edef' commands in TeX.
+
+   (2) These are lightly adapted from the 'groff' implementation of the
+'ms' macros.
+
+5.25 Page Motions
+=================
+
+*Note Manipulating Spacing::, for a discussion of the most commonly used
+request for vertical motion, 'sp', which spaces downward by one vee.
+
+ -- Request: .mk reg
+ -- Request: .rt dist
+     You can "mark" a location on a page for subsequent "return".  'mk'
+     takes an argument, a register name in which to store the current
+     page location.  If given no argument, it stores the location in an
+     internal register.  This location can be used later by the 'rt' or
+     the 'sp' requests (or the '\v' escape).
+
+     The 'rt' request returns _upward_ to the location marked with the
+     last 'mk' request.  If used with an argument, it returns to a
+     vertical position DIST from the top of the page (no previous call
+     to 'mk' is necessary in this case).  The default scaling unit is
+     'v'.
+
+     If a page break occurs between a 'mk' request and its matching 'rt'
+     request, the 'rt' request is silently ignored.
+
+     A simple implementation of a macro to set text in two columns
+     follows.
+
+          .nr column-length 1.5i
+          .nr column-gap 4m
+          .nr bottom-margin 1m
+          .
+          .de 2c
+          .  br
+          .  mk
+          .  ll \\ncolumn-lengthu
+          .  wh -\\nbottom-marginu 2c-trap
+          .  nr right-side 0
+          ..
+          .
+          .de 2c-trap
+          .  ie \\nright-side \{\
+          .    nr right-side 0
+          .    po -(\\ncolumn-lengthu + \\ncolumn-gapu)
+          .    \" remove trap
+          .    wh -\\nbottom-marginu
+          .  \}
+          .  el \{\
+          .    \" switch to right side
+          .    nr right-side 1
+          .    po +(\\ncolumn-lengthu + \\ncolumn-gapu)
+          .    rt
+          .  \}
+          ..
+
+     Now let us apply our two-column macro.
+
+          .pl 1.5i
+          .ll 4i
+          This is a small test that shows how the
+          rt request works in combination with mk.
+
+          .2c
+          Starting here, text is typeset in two columns.
+          Note that this implementation isn't robust
+          and thus not suited for a real two-column
+          macro.
+              => This is a small test that shows how the
+              => rt request works in combination with mk.
+              =>
+              => Starting  here,    isn't    robust
+              => text is typeset    and   thus  not
+              => in two columns.    suited  for   a
+              => Note that  this    real two-column
+              => implementation     macro.
+
+   Several escape sequences enable fine control of movement about the
+page.
+
+ -- Escape sequence: \v'expr'
+     Vertically move the drawing position.  EXPR indicates the magnitude
+     of motion: positive is downward and and negative upward.  The
+     default scaling unit is 'v'.  The motion is relative to the current
+     drawing position unless EXPR begins with the boundary-relative
+     motion operator '|'.  *Note Numeric Expressions::.
+
+     Text processing continues at the new drawing position; usually,
+     vertical motions should be in balanced pairs to avoid a confusing
+     page layout.
+
+     '\v' will not spring a vertical position trap.  This can be useful;
+     for example, consider a page bottom trap macro that prints a marker
+     in the margin to indicate continuation of a footnote.  *Note
+     Traps::.
+
+   A few escape sequences that produce vertical motion are unusual.
+They are thought to originate early in AT&T 'nroff' history to achieve
+super- and subscripting by half-line motions on line printers and
+teletypewriters before the phototypesetter made more precise positioning
+available.  They are reckoned in ems--not vees--to maintain continuity
+with their original purpose of moving relative to the size of the type
+rather than the distance between text baselines (vees).(1)  (*note Page
+Motions-Footnote-1::)
+
+ -- Escape sequence: \r
+ -- Escape sequence: \u
+ -- Escape sequence: \d
+     Move upward 1m, upward .5m, and downward .5m, respectively.
+
+Let us see these escape sequences in use.
+
+     Obtain 100 cm\u3\d of \ka\d\092\h'|\nau'\r233\dU.
+
+   In the foregoing we have paired '\u' and '\d' to typeset a
+superscript, and later a full em negative ("reverse") motion to place a
+superscript above a subscript.  A numeral-width horizontal motion escape
+sequence aligns the proton and nucleon numbers, while '\k' marks a
+horizontal position to which '\h' returns so that we could stack them.
+(We shall discuss these horizontal motion escape sequences presently.)
+In serious applications, we often want to alter the type size of the
+-scripts and to fine-tune the vertical motions, as the 'groff' 'ms'
+package does with its super- and subscripting string definitions.
+
+ -- Escape sequence: \h'expr'
+     Horizontally move the drawing position.  EXPR indicates the
+     magnitude of motion: positive is rightward and negative leftward.
+     The default scaling unit is 'm'.  The motion is relative to the
+     current drawing position unless EXPR begins with the
+     boundary-relative motion operator '|'.  *Note Numeric
+     Expressions::.
+
+   The following string definition sets the TeX logo.(2)  (*note Page
+Motions-Footnote-2::)
+
+     .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X\"
+
+   There are a number of special-case escape sequences for horizontal
+motion.
+
+ -- Escape sequence: \<SP>
+     Move right one word space.  (The input is a backslash followed by a
+     space.)  This escape sequence can be thought of as a
+     non-adjustable, unbreakable space.  Usually you want '\~' instead;
+     see *note Manipulating Filling and Adjustment::.
+
+ -- Escape sequence: \|
+     Move one-sixth em to the right on typesetting output devices.  If a
+     glyph named '\|' is defined in the current font, its width is used
+     instead, even on terminal output devices.
+
+ -- Escape sequence: \^
+     Move one-twelfth em to the right on typesetting output devices.  If
+     a glyph named '\^' is defined in the current font, its width is
+     used instead, even on terminal output devices.
+
+ -- Escape sequence: \0
+     Move right by the width of a numeral in the current font.
+
+   Horizontal motions are not discarded at the end of an output line as
+word spaces are.  *Note Breaking::.
+
+ -- Escape sequence: \w'anything'
+ -- Register: \nst
+ -- Register: \nsb
+ -- Register: \nrst
+ -- Register: \nrsb
+ -- Register: \nct
+ -- Register: \nssc
+ -- Register: \nskw
+     Interpolate the width of ANYTHING in basic units.  This escape
+     sequence allows several properties of formatted output to be
+     measured without writing it out.
+
+          The length of the string 'abc' is \w'abc'u.
+              => The length of the string 'abc' is 72u.
+
+     ANYTHING is processed in a dummy environment: this means that font
+     and type size changes, for example, may occur within it without
+     affecting subsequent output.
+
+     After each use, '\w' sets several registers.
+
+     'st'
+     'sb'
+          The maximum vertical displacements of the text baseline above
+          and below, respectively.  The sign convention is opposite that
+          of relative vertical motions; that is, depth below the
+          (original) baseline is negative.  These registers are
+          incorrectly documented in the AT&T 'troff' manual as "the
+          highest and lowest extent of the argument to '\w' relative
+          to the baseline".
+
+     'rst'
+     'rsb'
+          Like 'st' and 'sb', but taking account of the heights and
+          depths of glyphs.  In other words, these registers store the
+          highest and lowest vertical positions attained by ANYTHING,
+          doing what AT&T 'troff' documented 'st' and 'sb' as doing.
+
+     'ct'
+          Characterizes the geometry of glyphs occurring in ANYTHING.
+
+          0
+               only short glyphs, no descenders or tall glyphs
+
+          1
+               at least one descender
+
+          2
+               at least one tall glyph
+
+          3
+               at least one each of a descender and a tall glyph
+
+     'ssc'
+          The amount of horizontal space (possibly negative) that should
+          be added to the last glyph before a subscript.
+
+     'skw'
+          How far to right of the center of the last glyph in the '\w'
+          argument, the center of an accent from a roman font should be
+          placed over that glyph.
+
+ -- Escape sequence: \kp
+ -- Escape sequence: \k(ps
+ -- Escape sequence: \kposition
+     Store the current horizontal position in the _input_ line in a
+     register with the name POSITION (one-character name P,
+     two-character name PS).  Use this, for example, to return to the
+     beginning of a string for highlighting or other decoration.
+
+ -- Register: \nhp
+     The current horizontal position at the input line.
+
+ -- Register: \n.k
+     A read-only register containing the current horizontal output
+     position (relative to the current indentation).
+
+ -- Escape sequence: \o'abc...'
+     Overstrike the glyphs of characters A, B, C, ...; the glyphs are
+     centered, written, and the drawing position advanced by the widest
+     of the glyphs.
+
+ -- Escape sequence: \zc
+     Format the character C with zero width; that is, without advancing
+     the drawing position.  Use '\z' to overstrike glyphs aligned to
+     their left edges, in contrast to '\o''s centering.
+
+ -- Escape sequence: \Z'anything'
+     Save the drawing position, format ANYTHING, then restore it.  Tabs
+     and leaders in the argument are ignored with an error diagnostic.
+
+     We might implement a strike-through macro thus.
+
+          .de ST
+          .nr width \w'\\$1'
+          \Z@\v'-.25m'\l'\\nwidthu'@\\$1
+          ..
+          .
+          This is
+          .ST "a test"
+          an actual emergency!
+
+   (1) At the 'grops' defaults of 10-point type on 12-point vertical
+spacing, the difference between half a vee and half an em can be subtle:
+large spacings like '.vs .5i' make it obvious.
+
+   (2) *Note Strings::, for an explanation of the trailing '\"'.
+
+5.26 Drawing Geometric Objects
+==============================
+
+A few of the formatter's escape sequences draw lines and other geometric
+objects.  Combined with each other and with page motion commands (*note
+Page Motions::), a wide variety of figures is possible.  For complex
+drawings, these operations can be cumbersome; the preprocessors 'gpic'
+or 'ggrn' are typically used instead.
+
+   The '\l' and '\L' escape sequences draw horizontal and vertical
+sequences of glyphs, respectively.  Even the simplest of output devices
+supports them.
+
+ -- Escape sequence: \l'l'
+ -- Escape sequence: \l'lc'
+     Draw a horizontal line of length L from the drawing position.
+     Rightward motion is positive.  Afterward, the drawing position is
+     at the right end of the line.  The default scaling unit is 'm'.
+
+     The optional second parameter C is a character with which to draw
+     the line.  The default is the baseline rule special character,
+     '\ru'.
+
+     If C is a valid scaling unit, put '\&' after L to disambiguate the
+     input.
+
+          .de textbox
+          \br\\$*\br\l'|0\rn'\l'|0\ul'
+          ..
+
+     The foregoing outputs a box rule (a vertical line), the text
+     argument(s), and another box rule.  We employ the boundary-relative
+     motion operator '|'.  Finally, the line-drawing escape sequences
+     draw a radical extender (a form of overline) and an underline from
+     the drawing position to the position coresponding to beginning of
+     the _input_ line.  The drawing position returns to just after the
+     right-hand box rule because the lengths of the drawn lines are
+     negative, as noted above.
+
+ -- Escape sequence: \L'l'
+ -- Escape sequence: \L'lc'
+     Draw a vertical line of length L from the drawing position.
+     Downward motion is positive.  The default scaling unit is 'v'.  The
+     default character is the box rule, '\br'.  As with vertical
+     motion escape sequences, text processing continues where the line
+     ends.  '\L' is otherwise similar to '\l'.
+
+          $ nroff <<EOF
+          This is a \L'3v'test.
+          EOF
+              => This is a
+              =>           |
+              =>           |
+              =>           |test.
+
+     When writing text, the drawing position is at the text baseline;
+     recall *note Page Geometry::.
+
+   The '\D' escape sequence provides "drawing commands" that direct the
+output device to render geometrical objects rather than glyphs.
+Specific devices may support only a subset, or may feature additional
+ones; consult the man page for the output driver in use.  Terminal
+devices in particular implement almost none.  *Note Graphics Commands::.
+
+   Rendering starts at the drawing position; when finished, the drawing
+position is left at the rightmost point of the object, even for closed
+figures, except where noted.  GNU 'troff' draws stroked (outlined)
+objects with the stroke color, and shades filled ones with the fill
+color.  *Note Colors::.  Coordinates H and V are horizontal and vertical
+motions relative to the drawing position or previous point in the
+command.  The default scaling unit for horizontal measurements (and
+diameters of circles) is 'm'; for vertical ones, 'v'.
+
+   Circles, ellipses, and polygons can be drawn filled or stroked.
+These are independent properties; if you want a filled, stroked figure,
+you must draw the same figure twice using each drawing command.  A
+filled figure is always smaller than an outlined one because the former
+is drawn only within its defined area, whereas strokes have a line
+thickness (set with '\D't'').
+
+     \h'1i'\v'1i'\
+     \# increase line thickness
+     \Z'\D't 5p''\
+     \# draw stroked (unfilled) polygon
+     \Z'\D'p 3 3 -6 0''\
+     \# draw filled (solid) polygon
+     \Z'\D'P 3 3 -6 0''
+
+ -- Escape sequence: \D'command argument ...'
+     Drawing command escape sequence parameters begin with an ordinary
+     character, COMMAND, selecting the type of object to be drawn,
+     followed by ARGUMENTs whose meaning is determined by COMMAND.
+
+     '\D'~ H1 V1 ... HN VN''
+          Draw a B-spline to each point in sequence, leaving the drawing
+          position at (HN, VN).
+
+     '\D'a HC VC H V''
+          Draw a circular arc centered at (HC, VC) counterclockwise from
+          the drawing position to a point (H, V) relative to the center.
+          (1)  (*note Drawing Geometric Objects-Footnote-1::)
+
+     '\D'c D''
+          Draw a circle of diameter D with its leftmost point at the
+          drawing position.
+
+     '\D'C D''
+          As '\D'C ...'', but the circle is filled.
+
+     '\D'e H V''
+          Draw an ellipse of width H and height V with its leftmost
+          point at the drawing position.
+
+     '\D'E X Y''
+          As '\D'e ...'', but the ellipse is filled.
+
+     '\D'l DX DY''
+          Draw line from the drawing position to (H, V).
+
+          The following is a macro for drawing a box around a text
+          argument; for simplicity, the box margin is a fixed at 0.2m.
+
+               .de TEXTBOX
+               .  nr @wd \w'\\$1'
+               \h'.2m'\
+               \h'-.2m'\v'(.2m - \\nrsbu)'\
+               \D'l 0 -(\\nrstu - \\nrsbu + .4m)'\
+               \D'l (\\n@wdu + .4m) 0'\
+               \D'l 0 (\\nrstu - \\nrsbu + .4m)'\
+               \D'l -(\\n@wdu + .4m) 0'\
+               \h'.2m'\v'-(.2m - \\nrsbu)'\
+               \\$1\
+               \h'.2m'
+               ..
+
+          The argument is measured with the '\w' escape sequence.  Its
+          width is stored in register '@wd'.  '\w' also sets the
+          registers 'rst' and 'rsb'; these contain its maximum vertical
+          extents of the argument.  Then, four lines are drawn to form a
+          box, offset by the box margin.
+
+     '\D'p H1 V1 ... HN VN''
+          Draw polygon with vertices at drawing position and each point
+          in sequence.  GNU 'troff' closes the polygon by drawing a line
+          from (HN, VN) back to the initial drawing position.
+          Afterward, the drawing position is left at (HN, VN).
+
+     '\D'P DX1 DY1 DX2 DY2 ...''
+          As '\D'P ...'', but the polygon is filled.
+
+          The following macro is like the '\D'l'' example, but shades
+          the box.  We draw the box before writing the text because
+          colors in GNU 'troff' have no transparency; in othe opposite
+          order, the filled polygon would occlude the text.
+
+               .de TEXTBOX
+               .  nr @wd \w'\\$1'
+               \h'.2m'\
+               \h'-.2m'\v'(.2m - \\nrsbu)'\
+               \Mlightcyan\
+               \D'P 0 -(\\nrstu - \\nrsbu + .4m) \
+                    (\\n@wdu + .4m) 0 \
+                    0 (\\nrstu - \\nrsbu + .4m) \
+                    -(\\n@wdu + .4m) 0'\
+               \h'.2m'\v'-(.2m - \\nrsbu)'\
+               \M\
+               \\$1\
+               \h'.2m'
+               ..
+
+     '\D't N''
+          Set the stroke thickness of geometric objects to N basic
+          units.  A zero N selects the minimal supported thickness.  A
+          negative N selects a thickness proportional to the type size;
+          this is the default.
+
+   In a hazy penumbra between text rendering and drawing commands we
+locate the bracket-building escape sequence, '\b'.  It can assemble
+apparently large glyphs by vertically stacking ordinary ones.
+
+ -- Escape sequence: \b'contents'
+     Pile and center a sequence of glyphs vertically on the output line.
+     "Piling" stacks glyphs corresponding to each character in CONTENTS,
+     read from left to right, and placed from top to bottom.  GNU
+     'troff' separates the glyphs vertically by 1m, and the pile itself
+     is centered 0.5m above the text baseline.  The horizontal drawing
+     position is then advanced by the width of the widest glyph in the
+     pile.
+
+     This rather inflexible positioning algorithm doesn't work with the
+     'dvi' output device since its bracket pieces vary in height.
+     Instead, use the 'geqn' preprocessor.
+
+     *note Manipulating Spacing:: describes how to adjust the vertical
+     spacing of the output line with the '\x' escape sequence.
+
+     The application of '\b' that lends its name is construction of
+     brackets, braces, and parentheses when typesetting mathematics.  We
+     might construct a large opening (left) brace as follows.
+
+          \b'\lt\bv\lk\bv\lb'
+
+     See 'groff_char(7)' for a list of special character identifiers.
+
+   (1) (HC, VC) is adjusted to the point nearest the perpendicular
+bisector of the arc's chord.
+
+5.27 Deferring Output
+=====================
+
+A few 'roff' language elements are generally not used in simple
+documents, but arise as page layouts become more sophisticated and
+demanding.  "Environments" collect formatting parameters like line
+length and typeface.  A "diversion" stores formatted output for later
+use.  A "trap" is a condition on the input or output, tested
+automatically by the formatter, that is associated with a macro, causing
+it to be called when that condition is fulfilled.
+
+   Footnote support often exercises all three of the foregoing features.
+A simple implementation might work as follows.  A pair of macros is
+defined: one starts a footnote and the other ends it.  The author calls
+the first macro where a footnote marker is desired.  The macro
+establishes a diversion so that the footnote text is collected at the
+place in the body text where its corresponding marker appears.  An
+environment is created for the footnote so that it is set at a smaller
+typeface.  The footnote text is formatted in the diversion using that
+environment, but it does not yet appear in the output.  The document
+author calls the footnote end macro, which returns to the previous
+environment and ends the diversion.  Later, after much more body text in
+the document, a trap, set a small distance above the page bottom, is
+sprung.  The macro called by the trap draws a line across the page and
+emits the stored diversion.  Thus, the footnote is rendered.
+
+   Diversions and traps make the text formatting process non-linear.
+Let us imagine a set of text lines or paragraphs labelled 'A', 'B', and
+so on.  If we set up a trap that produces text 'T' (as a page footer,
+say), and we also use a diversion to store the formatted text 'D', then
+a document with input text in the order 'A B C D E F' might render as 'A
+B C E T F'.  The diversion 'D' will never be output if we do not call
+for it.
+
+   Environments of themselves are not a source of non-linearity in
+document formatting: environment switches have immediate effect.  One
+could always write a macro to change as many formatting parameters as
+desired with a single convenient call.  But because diversions can be
+nested and macros called by traps that are sprung by other trap-called
+macros, they may be called upon in varying contexts.  For example,
+consider a page header that is always to be set in Helvetica.  A
+document that uses Times for most of its body text, but Courier for
+displayed code examples, poses a challenge if a page break occurs in the
+middle of a code display; if the header trap assumes that the "previous
+font" is always Times, the rest of the example will be formatted in the
+wrong typeface.  One could carefully save all formatting parameters upon
+entering the trap and restore them upon leaving it, but this is verbose,
+error-prone, and not future-proof as the 'groff' language develops.
+Environments save us considerable effort.
+
+5.28 Traps
+==========
+
+"Traps" are locations in the output or conditions on the input that,
+when reached or fulfilled, call a specified macro.  These traps can
+occur at a given location on the page, at a given location in the
+current diversion (together, these are known as vertical position
+traps), at a blank line, at a line with leading space characters, after
+a quantity of input lines, or at the end of input.  Macros called by
+traps are passed no arguments.  Setting a trap is also called "planting"
+one.  It is said that a trap is "sprung" if its condition is fulfilled.
+
+5.28.1 Vertical Position Traps
+------------------------------
+
+A "vertical position trap" calls a macro when the formatter's vertical
+drawing position reaches or passes, in the downward direction, a certain
+location on the output page or in a diversion.  Its applications include
+setting page headers and footers, body text in multiple columns, and
+footnotes.
+
+ -- Request: .vpt flag
+ -- Register: \n.vpt
+     Enable vertical position traps if FLAG is non-zero or absent;
+     disable them otherwise.  Vertical position traps are those set by
+     the 'wh' request or by 'dt' within a diversion.  The parameter that
+     controls whether vertical position traps are enabled is global.
+     Initially, vertical position traps are enabled.  The current value
+     is stored in the '.vpt' read-only register.
+
+     A page can't be ejected if 'vpt' is set to zero; see *note The
+     Implicit Page Trap::.
+
+5.28.1.1 Page Location Traps
+............................
+
+A "page location trap" is a vertical position trap that applies to the
+page; that is, to undiverted output.  Many can be present; manage them
+with the 'wh' and 'ch' requests.
+
+ -- Request: .wh dist name
+     Plant macro NAME as page location trap at DIST.  The default
+     scaling unit is 'v'.  Non-negative values for DIST set the trap
+     relative to the top of the page; negative values set the trap
+     relative to the bottom of the page.  It is not possible to plant a
+     trap less than one basic unit from the page bottom: a DIST of '-0'
+     is interpreted as '0', the top of the page.(1)  (*note Page
+     Location Traps-Footnote-1::) An existing _visible_ trap (see below)
+     at DIST is removed; this is 'wh''s sole function if NAME is
+     missing.
+
+     A trap is sprung only if it is "visible", meaning that its location
+     is reachable on the page(2) (*note Page Location
+     Traps-Footnote-2::) and it is not hidden by another trap at the
+     same location already planted there.
+
+     A macro package might set headers and footers as follows; this
+     example configures vertical margins of one inch to the body text,
+     and one half-inch to the titles.  Observe the use of the no-break
+     control character with 'sp' request to position our text baselines,
+     and the page number character '%' used with the 'tl' request.
+
+          .\" hdfo.roff
+          .de hd                  \" page header
+          '  sp .5i
+          '  tl '\\*(Ti''\\*(Da'  \" title and date strings
+          '  sp .5i
+          ..
+          .de fo                  \" page footer
+          '  sp .5i
+          .  tl ''%''
+          .  bp
+          ..
+          .wh 0   hd             \" trap at top of the page
+          .wh -1i fo             \" trap 1 inch from bottom
+
+     To use these traps, copy the above (or load it from a file with the
+     'so' or 'mso' requests), then set up the strings it uses.
+
+          .so hdfo.roff
+          .ds Ti Final Report\"
+          .ds Da 21 May 2023\"
+          .ti
+          On 5 August of last year,
+          this committee tasked me with the investigation of the
+          CFIT (controlled flight into terrain) incident of
+          .\" ...and so on...
+
+     A trap above the top or at or below the bottom of the page can be
+     made visible by either moving it into the page area or increasing
+     the page length so that the trap is on the page.  Negative trap
+     values always use the _current_ page length; they are not converted
+     to an absolute vertical position.  We can use the 'ptr' request to
+     dump our page location traps to the standard error stream (*note
+     Debugging::).  Their positions are reported in basic units; an
+     'nroff' device example follows.
+
+          .pl 5i
+          .wh -1i xx
+          .ptr
+              error-> xx      -240
+          .pl 100i
+          .ptr
+              error-> xx      -240
+
+     It is possible to have more than one trap at the same location
+     (although only one at a time can be visible); to achieve this, the
+     traps must be defined at different locations, then moved to the
+     same place with the 'ch' request.  In the following example, the
+     many empty lines caused by the 'bp' request are not shown in the
+     output.
+
+          .de a
+          .  nop a
+          ..
+          .de b
+          .  nop b
+          ..
+          .de c
+          .  nop c
+          ..
+          .
+          .wh 1i a
+          .wh 2i b
+          .wh 3i c
+          .bp
+              => a b c
+          .ch b 1i
+          .ch c 1i
+          .bp
+              => a
+          .ch a 0.5i
+          .bp
+              => a b
+
+ -- Register: \n.t
+     The read-only register '.t' holds the distance to the next vertical
+     position trap.  If there are no traps between the current position
+     and the bottom of the page, it contains the distance to the page
+     bottom.  Within a diversion, in the absence of a diversion trap,
+     this distance is the largest representable integer in basic
+     units--effectively infinite.
+
+ -- Request: .ch name dist
+     Change the location of a trap by moving macro NAME to new location
+     DIST, or by unplanting it altogether if DIST is absent.  The
+     default scaling unit is 'v'.  Parameters to 'ch' are specified in
+     the opposite order from 'wh'.  If NAME is the earliest planted
+     macro of multiple traps at the same location, (re)moving it from
+     that location exposes the macro next least recently planted at the
+     same place.(3)  (*note Page Location Traps-Footnote-3::)
+
+     Changing a trap's location is useful for building up footnotes in a
+     diversion to allow more space at the bottom of the page for them.
+
+   The same macro can be installed simultaneously at multiple locations;
+however, only the earliest-planted instance--that has not yet been
+deleted with 'wh'--will be moved by 'ch'.  The following example (using
+an 'nroff' device) illustrates this behavior.  Blank lines have been
+elided from the output.
+
+     .de T
+     Trap sprung at \\n(nlu.
+     .br
+     ..
+     .wh 1i T
+     .wh 2i T
+     foo
+     .sp 11i
+     .bp
+     .ch T 4i
+     bar
+     .sp 11i
+     .bp
+     .ch T 5i
+     baz
+     .sp 11i
+     .bp
+     .wh 5i
+     .ch T 6i
+     qux
+     .sp 11i
+         => foo
+         => Trap sprung at 240u.
+         => Trap sprung at 480u.
+         => bar
+         => Trap sprung at 480u.
+         => Trap sprung at 960u.
+         => baz
+         => Trap sprung at 480u.
+         => Trap sprung at 1200u.
+         => qux
+         => Trap sprung at 1440u.
+
+ -- Register: \n.ne
+     The read-only register '.ne' contains the amount of space that was
+     needed in the last 'ne' request that caused a trap to be sprung; it
+     is useful in conjunction with the '.trunc' register.  *Note Page
+     Control::.  Since the '.ne' register is set only by traps, it
+     doesn't make sense to interpolate it outside of macros called by
+     traps.
+
+ -- Register: \n.trunc
+     A read-only register containing the amount of vertical space
+     truncated from an 'sp' request by the most recently sprung vertical
+     position trap, or, if the trap was sprung by an 'ne' request, minus
+     the amount of vertical motion produced by the 'ne' request.  In
+     other words, at the point a trap is sprung, it represents the
+     difference of what the vertical position would have been but for
+     the trap, and what the vertical position actually is.  Since the
+     '.trunc' register is set only by traps, it doesn't make sense to
+     interpolate it outside of macros called by traps.
+
+ -- Register: \n.pe
+     This Boolean-valued, read-only register interpolates 1 while a page
+     is being ejected, and 0 otherwise.
+
+     In the following example, we plant the same trap at the top and the
+     bottom of the page.  We also make the trap report its name and the
+     vertical drawing position.
+
+          .de T
+          .tm \\$0: page \\n%, nl=\\nnl .pe=\\n.pe
+          ..
+          .ll 46n
+          .wh 0 T
+          .wh -1v T
+          Those who can make you believe absurdities can make you
+          commit atrocities. \em Voltaire
+              error-> T: page 1, nl=0 .pe=0
+              error-> T: page 1, nl=2600 .pe=1
+              => Those who can make you believe absurdities can
+              => make you commit atrocities. -- Voltaire
+
+   When designing macros, keep in mind that diversions and traps do
+normally interact.  For example, if a trap calls a header macro (while
+outputting a diversion) that tries to change the font on the current
+page, the effect is not visible before the diversion has completely been
+printed (except for input protected with '\!' or '\?') since the data in
+the diversion is already formatted.  In most cases, this is not the
+expected behaviour.
+
+   (1) *Note The Implicit Page Trap::.
+
+   (2) A trap planted at '20i' or '-30i' will not be sprung on a page of
+length '11i'.
+
+   (3) It may help to think of each trap location as maintaining a
+queue; 'wh' operates on the head of the queue, and 'ch' operates on its
+tail.  Only the trap at the head of the queue is visible.
+
+5.28.1.2 The Implicit Page Trap
+...............................
+
+If, after starting GNU 'troff' without loading a macro package, you use
+the 'ptr' request to dump a list of the active traps to the standard
+error stream,(1) (*note The Implicit Page Trap-Footnote-1::) nothing is
+reported.  Yet the '.t' register will report a steadily decreasing value
+with every output line your document produces, and once the value of
+'.t' gets to within '.V' of zero, you will notice that something
+trap-like happens--the page is ejected, a new one begins, and the value
+of '.t' becomes large once more.
+
+   This "implicit page trap" always exists in the top-level
+diversion;(2) (*note The Implicit Page Trap-Footnote-2::) it works like
+a trap in some ways but not others.  Its purpose is to eject the current
+page and start the next one.  It has no name, so it cannot be moved or
+deleted with 'wh' or 'ch' requests.  You cannot hide it by placing
+another trap at its location, and can move it only by redefining the
+page length with 'pl'.  Its operation is suppressed when vertical page
+traps are disabled with GNU 'troff''s 'vpt' request.
+
+   (1) *Note Debugging::.
+
+   (2) *Note Diversions::.
+
+5.28.1.3 Diversion Traps
+........................
+
+A diversion is not formatted in the context of a page, so it lacks page
+location traps; instead it can have a "diversion trap".  There can exist
+at most one such vertical position trap per diversion.
+
+ -- Request: .dt dist name
+     Set a trap _within_ a diversion at location DIST, which is
+     interpreted relative to diversion rather than page boundaries.  If
+     invoked with fewer than two arguments, any diversion trap in the
+     current diversion is removed.  The register '.t' works within
+     diversions.  It is an error to invoke 'dt' in the top-level
+     diversion.  *Note Diversions::.
+
+5.28.2 Input Line Traps
+-----------------------
+
+ -- Request: .it n name
+ -- Request: .itc n name
+     Set an input line trap, calling macro NAME after processing the
+     next N productive input lines (recall *note Manipulating Filling
+     and Adjustment::).  Any existing input line trap in the environment
+     is replaced.  Without arguments, 'it' and 'itc' clear any input
+     line trap that has not yet sprung.
+
+     Consider a macro '.ST S N' which sets the next N input lines in the
+     font style S.
+
+          .de ST \" Use style $1 for next $2 text lines.
+          .  it \\$2 ES
+          .  ft \\$1
+          ..
+          .de ES \" end ST
+          .  ft R
+          ..
+          .ST I 1
+          oblique
+          face
+          .ST I 1
+          oblique\c
+          face
+              => oblique face obliqueface  (second "face" upright)
+
+     Unlike the 'ce' and 'rj' requests, 'it' counts lines interrupted
+     with the '\c' escape sequence separately (*note Line
+     Continuation::); 'itc' does not.  To see the difference, let's
+     change the previous example to use 'itc' instead.
+
+          ...
+          .  itc \\$2 ES
+          ...
+              => oblique face obliqueface  (second "face" oblique)
+
+     You can think of the 'ce' and 'rj' requests as implicitly creating
+     an input line trap with 'itc' that schedules a break when the trap
+     is sprung.
+
+          .de BR
+          .  br
+          .  internal: disable centering-without-filling
+          ..
+          .
+          .de ce
+          .  if \\n.br .br
+          .  itc \\$1 BR
+          .  internal: enable centering-without-filling
+          ..
+
+     Let us consider in more detail the sorts of input lines that are or
+     are not "productive".
+
+          .de Trap
+          TRAP SPRUNG
+          ..
+          .de Mac
+          .if r a \l'5n'
+          ..
+          .it 2 Trap
+          .
+          foo
+          .Mac
+          bar
+          baz
+          .it 1 Trap
+          .sp \" moves, but does not write or draw
+          qux
+          .itc 1 Trap
+          \h'5n'\c \" moves, but does not write or draw
+          jat
+
+     When 'Trap' gets called depends on whether the 'a' register is
+     defined; the control line with the 'if' request may or may not
+     produce written output.  We also see that the spacing request 'sp',
+     while certainly affecting the output, does not spring the input
+     line trap.  Similarly, the horizontal motion escape sequence '\h'
+     also affected the output, but was not "written".  Observe that we
+     had to follow it with '\c' and use 'itc' to prevent the newline at
+     the end of the text line from causing a word break, which, like an
+     ordinary space character, counts as written output.
+
+          $ groff -Tascii input-trap-example.groff
+              => foo bar TRAP SPRUNG baz
+              =>
+              => qux TRAP SPRUNG      jat TRAP SPRUNG
+          $ groff -Tascii -ra1 input-trap-example.groff
+              => foo _____ TRAP SPRUNG bar baz
+              =>
+              => qux TRAP SPRUNG      jat TRAP SPRUNG
+
+   Input line traps are associated with the environment (*note
+Environments::); switching to another environment suspends the current
+input line trap, and going back resumes it, restoring the count of
+qualifying lines enumerated in that environment.
+
+5.28.3 Blank Line Traps
+-----------------------
+
+ -- Request: .blm name
+     Set a blank line trap, calling the macro NAME when GNU 'troff'
+     encounters a blank line in an input file, instead of the usual
+     behavior (*note Breaking::).  A line consisting only of spaces is
+     also treated as blank and subject to this trap.  If no argument is
+     supplied, the default blank line behavior is (re-)established.
+
+5.28.4 Leading Space Traps
+--------------------------
+
+ -- Request: .lsm name
+ -- Register: \nlsn
+ -- Register: \nlss
+     Set a leading space trap, calling the macro NAME when GNU 'troff'
+     encounters leading spaces in an input line; the implicit line break
+     that normally happens in this case is suppressed.  If no argument
+     is supplied, the default leading space behavior is (re-)established
+     (*note Breaking::).
+
+     The count of leading spaces on an input line is stored in register
+     'lsn', and the amount of corresponding horizontal motion in
+     register 'lss', irrespective of whether a leading space trap is
+     set.  When it is, the leading spaces are removed from the input
+     line, and no motion is produced before calling NAME.
+
+5.28.5 End-of-input Traps
+-------------------------
+
+ -- Request: .em name
+     Set a trap at the end of input, calling macro NAME after the last
+     line of the last input file has been processed.  If no argument is
+     given, any existing end-of-input trap is removed.
+
+     For example, if the document had to have a section at the bottom of
+     the last page for someone to approve it, the 'em' request could be
+     used.
+
+          .de approval
+          \c
+          .  ne 3v
+          .  sp (\\n.tu - 3v)
+          .  in +4i
+          .  lc _
+          .  br
+          Approved:\t\a
+          .  sp
+          Date:\t\t\a
+          ..
+          .
+          .em approval
+
+     The '\c' in the above example needs explanation.  For historical
+     reasons (compatibility with AT&T 'troff'), the end-of-input macro
+     exits as soon as it causes a page break if no partially collected
+     line remains.(1)  (*note End-of-input Traps-Footnote-1::)
+
+     Let us assume that there is no '\c' in the above 'approval' macro,
+     that the page is full, and last output line has been broken with,
+     say, a 'br' request.  Because there is no more room, a 'ne' request
+     at this point causes a page ejection, which in turn makes 'troff'
+     exit immediately as just described.  In most situations, this is
+     not desired; people generally want to format the input after 'ne'.
+
+     To force processing of the whole end-of-input macro independently
+     of this behavior, it is thus advisable to (invisibly) ensure the
+     existence of a partially collected line ('\c') whenever there is a
+     chance that a page break can happen.  In the above example,
+     invoking the 'ne' request ensures that there is room for the
+     subsequent formatted output on the same page, so we need insert
+     '\c' only once.
+
+     The next example shows how to append three lines, then start a new
+     page unconditionally.  Since '.ne 1' doesn't give the desired
+     effect--there is always one line available or we are already at the
+     beginning of the next page--we temporarily increase the page length
+     by one line so that we can use '.ne 2'.
+
+          .de EM
+          .pl +1v
+          \c
+          .ne 2
+          line one
+          .br
+          \c
+          .ne 2
+          line two
+          .br
+          \c
+          .ne 2
+          line three
+          .br
+          .pl -1v
+          \c
+          'bp
+          ..
+          .em EM
+
+     This specific feature affects only the first potential page break
+     caused by the end-of-input macro; further page breaks emitted by
+     the macro are handled normally.
+
+     Another possible use of the 'em' request is to make GNU 'troff'
+     emit a single large page instead of multiple pages.  For example,
+     one may want to produce a long plain text file for reading in a
+     terminal or emulator without page footers and headers interrupting
+     the body of the document.  One approach is to set the page length
+     at the beginning of the document to a very large value to hold all
+     the text,(2) (*note End-of-input Traps-Footnote-2::) and
+     automatically adjust it to the exact height of the document after
+     the text has been output.
+
+          .de adjust-page-length
+          .  br
+          .  pl \\nnlu \" \nnl: current vertical position
+          ..
+          .
+          .de single-page-mode
+          .  pl 99999
+          .  em adjust-page-length
+          ..
+          .
+          .\" Activate the above code if configured.
+          .if \ndo-continuous-rendering \
+          .  single-page-mode
+
+     Since only one end-of-input trap exists and another macro package
+     may already use it, care must be taken not to break the mechanism.
+     A simple solution would be to append the above macro to the macro
+     package's end-of-input macro using the 'am' request.
+
+   (1) While processing an end-of-input macro, the formatter assumes
+that the next page break must be the last; it goes into "sudden death
+overtime".
+
+   (2) Another, taken by the 'groff' 'man' macros, is to intercept 'ne'
+requests and wrap 'bp' ones.
+
+5.29 Diversions
+===============
+
+In 'roff' systems it is possible to format text as if for output, but
+instead of writing it immediately, one can "divert" the formatted text
+into a named storage area.  It is retrieved later by specifying its name
+after a control character.  The same name space is used for such
+diversions as for strings and macros; see *note Identifiers::.  Such
+text is sometimes said to be "stored in a macro", but this coinage
+obscures the important distinction between macros and strings on one
+hand and diversions on the other; the former store _unformatted_ input
+text, and the latter capture _formatted_ output.  Diversions also do not
+interpret arguments.  Applications of diversions include "keeps"
+(preventing a page break from occurring at an inconvenient place by
+forcing a set of output lines to be set as a group), footnotes, tables
+of contents, and indices.  For orthogonality it is said that GNU 'troff'
+is in the "top-level diversion" if no diversion is active (that is,
+formatted output is being "diverted" immediately to the output device).
+
+   Dereferencing an undefined diversion will create an empty one of that
+name and cause a warning in category 'mac' to be emitted.  *Note
+Warnings::, for information about the enablement and suppression of
+warnings.  A diversion does not exist for the purpose of testing with
+the 'd' conditional operator until its initial definition ends (*note
+Operators in Conditionals::).  The following requests are used to create
+and alter diversions.
+
+ -- Request: .di name
+ -- Request: .da name
+     Start collecting formatted output in a diversion called NAME.  The
+     'da' request appends to a diversion called NAME, creating it if
+     necessary.  If NAME already exists as an alias, the target of the
+     alias is replaced or appended to; recall *note Strings::.  The
+     pending output line is diverted as well.  Switching to another
+     environment (with the 'ev' request) before invoking 'di' or 'da'
+     avoids including any pending output line in the diversion; see
+     *note Environments::.
+
+     Invoking 'di' or 'da' without an argument stops diverting output to
+     the diversion named by the most recent corresponding request.  If
+     'di' or 'da' is called without an argument when there is no current
+     diversion, a warning in category 'di' is produced.  *Note
+     Warnings::, for information about the enablement and suppression of
+     warnings.
+
+          Before the diversion.
+          .di yyy
+          In the diversion.
+          .br
+          .di
+          After the diversion.
+          .br
+              => After the diversion.
+          .yyy
+              => Before the diversion.  In the diversion.
+
+   GNU 'troff' supports "box" requests to exclude a partially collected
+line from a diversion, as this is often desirable.
+
+ -- Request: .box name
+ -- Request: .boxa name
+     Divert (or append) output to NAME, similarly to the 'di' and 'da'
+     requests, respectively.  Any pending output line is _not_ included
+     in the diversion.  Without an argument, stop diverting output; any
+     pending output line inside the diversion is discarded.
+
+          Before the box.
+          .box xxx
+          In the box.
+          .br
+          Hidden treasure.
+          .box
+          After the box.
+          .br
+              => Before the box.  After the box.
+          .xxx
+              => In the box.
+
+   Apart from pending output line inclusion and the request names that
+populate them, boxes are handled exactly as diversions are.  All of the
+following 'groff' language elements can be used with them
+interchangeably.
+
+ -- Register: \n.z
+ -- Register: \n.d
+     Diversions may be nested.  The read-only string-valued register
+     '.z' contains the name of the current diversion.  The read-only
+     register '.d' contains the current vertical place in the diversion.
+     If the input text is not being diverted, '.d' reports the same
+     location as the register 'nl'.
+
+ -- Register: \n.h
+     The read-only register '.h' stores the "high-water mark" on the
+     current page or in the current diversion.  It corresponds to the
+     text baseline of the lowest line on the page.(1)  (*note
+     Diversions-Footnote-1::)
+
+          .tm .h==\n.h, nl==\nnl
+              => .h==0, nl==-1
+          This is a test.
+          .br
+          .sp 2
+          .tm .h==\n.h, nl==\nnl
+              => .h==40, nl==120
+
+     As implied by the example, vertical motion does not produce text
+     baselines and thus does not increase the value interpolated by
+     '\n.h'.
+
+ -- Register: \ndn
+ -- Register: \ndl
+     After completing a diversion, the writable registers 'dn' and 'dl'
+     contain its vertical and horizontal sizes.  Only the lines just
+     processed are counted: for the computation of 'dn' and 'dl', the
+     requests 'da' and 'boxa' are handled as if 'di' and 'box' had been
+     used, respectively--lines that have been already stored in the
+     diversion (box) are not taken into account.
+
+          .\" Center text both horizontally and vertically.
+          .\" Macro .(c starts centering mode; .)c terminates it.
+          .
+          .\" Disable the escape character with .eo so that we
+          .\" don't have to double backslashes on the "\n"s.
+          .eo
+          .de (c
+          .  br
+          .  ev (c
+          .  evc 0
+          .  in 0
+          .  nf
+          .  di @c
+          ..
+          .de )c
+          .  br
+          .  ev
+          .  di
+          .  nr @s (((\n.tu - \ndnu) / 2u) - 1v)
+          .  sp \n@su
+          .  ce 1000
+          .  @c
+          .  ce 0
+          .  sp \n@su
+          .  br
+          .  fi
+          .  rr @s
+          .  rm @c
+          ..
+          .ec
+
+ -- Escape sequence: \!anything
+ -- Escape sequence: \?anything\?
+     "Transparently" embed ANYTHING into the current diversion,
+     preventing requests, macro calls, and escape sequences from being
+     interpreted when read into a diversion.  This is useful for
+     preventing them from taking effect until the diverted text is
+     actually output.  The '\!' escape sequence transparently embeds
+     input up to and including the end of the line.  The '\?' escape
+     sequence transparently embeds input until its own next occurrence.
+
+     ANYTHING may not contain newlines; use '\!' by itself to embed
+     newlines in a diversion.  The escape sequence '\?' is also
+     recognized in copy mode and turned into a single internal code; it
+     is this code that terminates ANYTHING.  Thus the following example
+     prints 4.
+
+          .nr x 1
+          .nf
+          .di d
+          \?\\?\\\\?\\\\\\\\nx\\\\?\\?\?
+          .di
+          .nr x 2
+          .di e
+          .d
+          .di
+          .nr x 3
+          .di f
+          .e
+          .di
+          .nr x 4
+          .f
+
+     Both escape sequences read the data in copy mode.
+
+     If '\!' is used in the top-level diversion, its argument is
+     directly embedded into GNU 'troff''s intermediate output.  This can
+     be used, for example, to control a postprocessor that processes the
+     data before it is sent to an output driver.
+
+     The '\?' escape used in the top-level diversion produces no output
+     at all; its argument is simply ignored.
+
+ -- Request: .output contents
+     Emit CONTENTS directly to GNU 'troff''s intermediate output
+     (subject to copy mode interpretation); this is similar to '\!' used
+     at the top level.  An initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces.
+
+     This request can't be used before the first page has started--if
+     you get an error, simply insert '.br' before the 'output' request.
+
+     Use with caution!  It is normally only needed for mark-up used by a
+     postprocessor that does something with the output before sending it
+     to the output device, filtering out CONTENTS again.
+
+ -- Request: .asciify div
+     "Unformat" the diversion DIV in a way such that Unicode basic Latin
+     (ASCII) characters, characters translated with the 'trin' request,
+     space characters, and some escape sequences, that were formatted
+     and diverted into DIV are treated like ordinary input characters
+     when DIV is reread.  Doing so can be useful in conjunction with the
+     'writem' request.  'asciify' can be also used for gross hacks; for
+     example, the following sets register 'n' to 1.
+
+          .tr @.
+          .di x
+          @nr n 1
+          .br
+          .di
+          .tr @@
+          .asciify x
+          .x
+
+     'asciify' cannot return all items in a diversion to their source
+     equivalent: nodes such as those produced by the '\N' escape
+     sequence will remain nodes, so the result cannot be guaranteed to
+     be a pure string.  *Note Copy Mode::.  Glyph parameters such as the
+     type face and size are not preserved; use 'unformat' to achieve
+     that.
+
+ -- Request: .unformat div
+     Like 'asciify', unformat the diversion DIV.  However, 'unformat'
+     handles only tabs and spaces between words, the latter usually
+     arising from spaces or newlines in the input.  Tabs are treated as
+     input tokens, and spaces become adjustable again.  The vertical
+     sizes of lines are not preserved, but glyph information (font, type
+     size, space width, and so on) is retained.
+
+   (1) Thus, the "water" gets "higher" proceeding _down_ the page.
+
+5.30 Punning Names
+==================
+
+Macros, strings, and diversions share a name space; recall *note
+Identifiers::.  Internally, the same mechanism is used to store them.
+You can thus call a macro with string interpolation syntax and vice
+versa.
+
+     .de subject
+     Typesetting
+     ..
+     .de predicate
+     rewards attention to detail
+     ..
+     \*subject \*predicate.
+     Truly.
+         => Typesetting
+         =>  rewards attention to detail Truly.
+
+What went wrong?  Strings don't contain newlines, but macros do.  String
+interpolation placed a newline at the end of '\*subject', and the next
+thing on the input was a space.  Then when '\*predicate' was
+interpolated, it was followed by the empty request '.' on a line by
+itself.  If we want to use macros as strings, we must take interpolation
+behavior into account.
+
+     .de subject
+     Typesetting\\
+     ..
+     .de predicate
+     rewards attention to detail\\
+     ..
+     \*subject \*predicate.
+     Truly.
+         => Typesetting rewards attention to detail.  Truly.
+
+By ending each text line of the macros with an escaped '\<RET>', we get
+the desired effect (*note Line Continuation::).(1)  (*note Punning
+Names-Footnote-1::) What would have happened if we had used only one
+backslash at a time instead?
+
+   Interpolating a string does not hide existing macro arguments.  We
+can also place the escaped newline outside the string interpolation
+instead of within the string definition.  Thus, in a macro, a more
+efficient way of doing
+
+     .xx \\$@
+
+is
+
+     \\*xx\\
+
+The latter calling syntax doesn't change the value of '\$0', which is
+then inherited from the calling macro (*note Parameters::).
+
+   Diversions can be also called with string syntax.  It is sometimes
+convenient to copy one-line diversions to a string.
+
+     .di xx
+     the
+     .ft I
+     interpolation system
+     .ft
+     .br
+     .di
+     .ds yy This is a test of \*(xx\c
+     \*(yy.
+         => This is a test of the interpolation system.
+
+As the previous example shows, it is possible to store formatted output
+in strings.  The '\c' escape sequence prevents the subsequent newline
+from being interpreted as a break (again, *note Line Continuation::).
+
+   Copying multi-output line diversions produces unexpected results.
+
+     .di xxx
+     a funny
+     .br
+     test
+     .br
+     .di
+     .ds yyy This is \*xxx\c
+     \*yyy.
+         => test This is a funny.
+
+   Usually, it is not predictable whether a diversion contains one or
+more output lines, so this mechanism should be avoided.  With AT&T
+'troff', this was the only solution to strip off a final newline from a
+diversion.  Another disadvantage is that the spaces in the copied string
+are already formatted, preventing their adjustment.  This can cause ugly
+results.
+
+   A clean solution to this problem is available in GNU 'troff', using
+the requests 'chop' to remove the final newline of a diversion, and
+'unformat' to make the horizontal spaces adjustable again.
+
+     .box xxx
+     a funny
+     .br
+     test
+     .br
+     .box
+     .chop xxx
+     .unformat xxx
+     This is \*xxx.
+         => This is a funny test.
+
+   *Note Gtroff Internals::.
+
+   (1) The backslash is doubled.  *Note Copy Mode::.
+
+5.31 Environments
+=================
+
+As discussed in *note Deferring Output::, environments store most of the
+parameters that determine the appearance of text.  A default environment
+named '0' exists when GNU 'troff' starts up; it is modified by
+formatting-related requests and escape sequences.
+
+   You can create new environments and switch among them.  Only one is
+current at any given time.  Active environments are managed using a
+"stack", a data structure supporting "push" and "pop" operations.  The
+current environment is at the top of the stack.  The same environment
+name can be pushed onto the stack multiple times, possibly interleaved
+with others.  Popping the environment stack does not destroy the current
+environment; it remains accessible by name and can be made current again
+by pushing it at any time.  Environments cannot be renamed or deleted,
+and can only be modified when current.  To inspect the environment
+stack, use the 'pev' request; see *note Debugging::.
+
+   Environments store the following information.
+
+   * a partially collected line, if any
+
+   * data about the most recently output glyph and line (registers
+     '.cdp', '.cht', '.csk', '.n', '.w')
+
+   * typeface parameters (size, family, style, height and slant,
+     inter-word and inter-sentence space sizes)
+
+   * page parameters (line length, title length, vertical spacing, line
+     spacing, indentation, line numbering, centering, right-alignment,
+     underlining, hyphenation parameters)
+
+   * filling enablement; adjustment enablement and mode
+
+   * tab stops; tab, leader, escape, control, no-break control,
+     hyphenation, and margin characters
+
+   * input line traps
+
+   * stroke and fill colors
+
+ -- Request: .ev ident
+ -- Register: \n.ev
+     Enter the environment IDENT, which is created if it does not
+     already exist, using the same parameters as for the default
+     environment used at startup.  With no argument, GNU 'troff'
+     switches to the previous environment.
+
+     Invoking 'ev' with an argument puts environment IDENT onto the top
+     of the environment stack.  (If it isn't already present in the
+     stack, this is a proper push.)  Without an argument, 'ev' pops the
+     environment stack, making the previous environment current.  It is
+     an error to pop the environment stack with no previous environment
+     available.  The read-only string-valued register '.ev' contains the
+     name of the current environment--the one at the top of the stack.
+
+          .ev footnote-env
+          .fam N
+          .ps 6
+          .vs 8
+          .ll -.5i
+          .ev
+
+          ...
+
+          .ev footnote-env
+          \dg Observe the smaller text and vertical spacing.
+          .ev
+
+     We can familiarize ourselves with stack behavior by wrapping the
+     'ev' request with a macro that reports the contents of the '.ev'
+     register to the standard error stream.
+
+          .de EV
+          .  ev \\$1
+          .  tm environment is now \\n.ev
+          ..
+          .
+          .EV foo
+          .EV bar
+          .EV
+          .EV baz
+          .EV
+          .EV
+          .EV
+
+              error-> environment is now foo
+              error-> environment is now bar
+              error-> environment is now foo
+              error-> environment is now baz
+              error-> environment is now foo
+              error-> environment is now 0
+              error-> error: environment stack underflow
+              error-> environment is now 0
+
+ -- Request: .evc environment
+     Copy the contents of ENVIRONMENT to the current environment.
+
+     The following environment data are not copied.
+
+        * a partially collected line, if present;
+
+        * the interruption status of the previous input line (due to use
+          of the '\c' escape sequence);
+
+        * the count of remaining lines to center, to right-justify, or
+          to underline (with or without underlined spaces)--these are
+          set to zero;
+
+        * the activation status of temporary indentation;
+
+        * input line traps and their associated data;
+
+        * the activation status of line numbering (which can be
+          reactivated with '.nm +0'); and
+
+        * the count of consecutive hyphenated lines (set to zero).
+
+ -- Register: \n.w
+ -- Register: \n.cht
+ -- Register: \n.cdp
+ -- Register: \n.csk
+     The '\n.w' register contains the width of the last glyph
+     formatted in the environment.
+
+     The '\n.cht' register contains the height of the last glyph
+     formatted in the environment.
+
+     The '\n.cdp' register contains the depth of the last glyph
+     formatted in the environment.  It is positive for glyphs extending
+     below the baseline.
+
+     The '\n.csk' register contains the "skew" (how far to the right
+     of the glyph's center that GNU 'troff' should place an accent) of
+     the last glyph formatted in the environment.
+
+ -- Register: \n.n
+     The '\n.n' register contains the length of the previous output
+     line emitted in the environment.
+
+5.32 Suppressing Output
+=======================
+
+ -- Escape sequence: \Onum
+     Suppress GNU 'troff' output of glyphs and geometric objects.  The
+     sequences '\O2', '\O3', '\O4', and '\O5' are intended for internal
+     use by 'grohtml'.
+
+     '\O0'
+          Disable the emission of glyphs and geometric objects to the
+          output driver, provided that this sequence occurs at the
+          outermost suppression level (see '\O3' and '\04' below).
+          Horizontal motions corresponding to non-overstruck glyph
+          widths still occur.
+
+     '\O1'
+          Enable the emission of glyphs and geometric objects to the
+          output driver, provided that this sequence occurs at the
+          outermost suppression level.
+
+     '\O0' and '\O1' also reset the four registers 'opminx', 'opminy',
+     'opmaxx', and 'opmaxy' to -1.  These four registers mark the top
+     left and bottom right hand corners of a box encompassing all
+     written or drawn output.
+
+     '\O2'
+          At the outermost suppression level, enable emission of glyphs
+          and geometric objects, and write to the standard error stream
+          the page number and values of the four aforementioned
+          registers encompassing glyphs written since the last
+          interpolation of a '\O' sequence, as well as the page offset,
+          line length, image file name (if any), horizontal and vertical
+          device motion quanta, and input file name.  Numeric values are
+          in basic units.
+
+     '\O3'
+          Begin a nested suppression level.  'grohtml' uses this
+          mechanism to create images of output preprocessed with 'gpic',
+          'geqn', and 'gtbl'.  At startup, GNU 'troff' is at the
+          outermost suppression level.  'pre-grohtml' generates these
+          sequences when processing the document, using GNU 'troff' with
+          the 'ps' output device, Ghostscript, and the PNM tools to
+          produce images in PNG format.  They start a new page if the
+          device is not 'html' or 'xhtml', to reduce the number of
+          images crossing a page boundary.
+
+     '\O4'
+          End a nested suppression level.
+
+     '\O5PFILE'
+          At the outermost suppression level, write the name 'file' to
+          the standard error stream at position P, which must be one of
+          'l', 'r', 'c', or 'i', corresponding to left, right, centered,
+          and inline alignments within the document, respectively.  FILE
+          is a name associated with the production of the next image.
+
+ -- Register: \n.O
+     Output suppression nesting level applied by '\O3' and '\O4' escape
+     sequences.
+
+5.33 I/O
+========
+
+'gtroff' has several requests for including files:
+
+ -- Request: .so file
+ -- Request: .soquiet file
+     Replace the 'so' request's control line with the contents of the
+     file named by the argument, "sourcing" it.  FILE is sought in the
+     directories specified by '-I' command-line option.  If FILE does
+     not exist, a warning in category 'file' is produced and the request
+     has no further effect.  *Note Warnings::, for information about the
+     enablement and suppression of warnings.
+
+     'so' can be useful for large documents; e.g., allowing each chapter
+     of a book to be kept in a separate file.  However, files
+     interpolated with 'so' are not preprocessed; to overcome this
+     limitation, see the 'gsoelim(1)' man page.
+
+     Since GNU 'troff' replaces the entire control line with the
+     contents of a file, it matters whether 'file' is terminated with a
+     newline or not.  Assume that file 'xxx' contains only the word
+     'foo' without a trailing newline.
+
+          $ printf 'foo' > xxx
+
+          The situation is
+          .so xxx
+          bar.
+              => The situation is foobar.
+
+     'soquiet' works the same way, except that no warning diagnostic is
+     issued if FILE does not exist.
+
+ -- Request: .pso command
+     Read the standard output from the specified COMMAND and include it
+     in place of the 'pso' request.
+
+     It is an error to use this request in safer mode, which is the
+     default.  Invoke GNU 'troff' or a front end with the '-U' option to
+     enable unsafe mode.
+
+     The comment regarding a final newline for the 'so' request is valid
+     for 'pso' also.
+
+ -- Request: .mso file
+ -- Request: .msoquiet file
+     Identical to the 'so' and 'soquiet' requests, respectively, except
+     that 'gtroff' searches for the specified FILE in the same
+     directories as macro files for the '-m' command-line option.  If
+     the file name to be included has the form 'NAME.tmac' and it isn't
+     found, these requests try to include 'tmac.NAME' and vice versa.
+
+ -- Request: .trf file
+ -- Request: .cf file
+     Transparently output the contents of FILE.  Each line is output as
+     if it were preceded by '\!'; however, the lines are _not_ subject
+     to copy mode interpretation.  If the file does not end with a
+     newline, 'trf' adds one.  Both requests cause a break.
+
+     When used in a diversion, these requests embed a node (*note Gtroff
+     Internals::) in it that, when reread, causes the contents of FILE
+     to be transparently copied to the output.  In AT&T 'troff', the
+     contents of FILE are immediately copied to the output regardless of
+     whether there is a current diversion; this behaviour is so
+     anomalous that it must be considered a bug.
+
+     While 'cf' copies the contents of FILE completely unprocessed,
+     'trf' disallows characters such as NUL that are not valid 'gtroff'
+     input characters (*note Identifiers::).
+
+     For 'cf', within a diversion, "completely unprocessed" means that
+     each line of a file to be inserted is handled as if it were
+     preceded by '\!\\!'.
+
+     To define a macro 'x' containing the contents of file 'f', use
+
+          .ev 1
+          .di x
+          .trf f
+          .di
+          .ev
+
+     The calls to 'ev' prevent the partially collected output line from
+     becoming part of the diversion (*note Diversions::).
+
+ -- Request: .nx file
+     Force 'gtroff' to continue processing of the file specified as an
+     argument.  If no argument is given, immediately jump to the end of
+     file.
+
+ -- Request: .rd prompt arg1 arg2 ...
+     Read from standard input, and include what is read as though it
+     were part of the input file.  Text is read until a blank line is
+     encountered.
+
+     If standard input is a TTY input device (keyboard), write PROMPT to
+     standard error, followed by a colon (or send BEL for a beep if no
+     argument is given).
+
+     Arguments after PROMPT are available for the input.  For example,
+     the line
+
+          .rd data foo bar
+
+     with the input 'This is \$2.' prints
+
+          This is bar.
+
+   Using the 'nx' and 'rd' requests, it is easy to set up form letters.
+The form letter template is constructed like this, putting the following
+lines into a file called 'repeat.let':
+
+     .ce
+     \*(td
+     .sp 2
+     .nf
+     .rd
+     .sp
+     .rd
+     .fi
+     Body of letter.
+     .bp
+     .nx repeat.let
+
+When this is run, a file containing the following lines should be
+redirected in.  Requests included in this file are executed as though
+they were part of the form letter.  The last block of input is the 'ex'
+request, which tells GNU 'troff' to stop processing.  If this were not
+there, 'troff' would not know when to stop.
+
+     Trent A. Fisher
+     708 NW 19th Av., #202
+     Portland, OR  97209
+
+     Dear Trent,
+
+     Len Adollar
+     4315 Sierra Vista
+     San Diego, CA  92103
+
+     Dear Mr. Adollar,
+
+     .ex
+
+ -- Request: .pi pipe
+     Pipe the output of 'gtroff' to the shell command(s) specified by
+     PIPE.  This request must occur before 'gtroff' has a chance to
+     print anything.
+
+     It is an error to use this request in safer mode, which is the
+     default.  Invoke GNU 'troff' or a front end with the '-U' option to
+     enable unsafe mode.
+
+     Multiple calls to 'pi' are allowed, acting as a chain.  For
+     example,
+
+          .pi foo
+          .pi bar
+          ...
+
+     is the same as '.pi foo | bar'.
+
+     The intermediate output format of GNU 'troff' is piped to the
+     specified commands.  Consequently, calling 'groff' without the '-Z'
+     option normally causes a fatal error.
+
+ -- Request: .sy cmds
+ -- Register: \nsystat
+     Execute the shell command(s) specified by CMDS.  The output is not
+     saved anywhere, so it is up to the user to do so.
+
+     It is an error to use this request in safer mode; this is the
+     default.  Give GNU 'troff' or a front end program the '-U' option
+     to enable unsafe mode.
+
+     The following code fragment introduces the current time into a
+     document.
+
+          .sy perl -e 'printf ".nr H %d\\n.nr M %d\\n.nr S %d\\n",\
+                       (localtime(time))2,1,0' > /tmp/x\n$$
+          .so /tmp/x\n$$
+          .sy rm /tmp/x\n$$
+          \nH:\nM:\nS
+
+     This works by having the Perl script (run by 'sy') write 'nr'
+     requests that set the registers 'H', 'M', and 'S' to a temporary
+     file.  The 'roff' document then reads the temporary file using the
+     'so' request.
+
+     The registers 'seconds', 'minutes', and 'hours', initialized at
+     startup of GNU 'troff', should satisfy most requirements.  Use the
+     'af' request to format their values for output.
+
+          .af hours 00
+          .af minutes 00
+          .af seconds 00
+          \nhours:\nminutes:\nseconds
+              => 02:17:54
+
+     The writable register 'systat' contains the return value of the
+     'system()' function executed by the last 'sy' request.
+
+ -- Request: .open stream file
+ -- Request: .opena stream file
+     Open the specified FILE for writing and associates the specified
+     STREAM with it.
+
+     The 'opena' request is like 'open', but if the file exists, append
+     to it instead of truncating it.
+
+     It is an error to use these requests in safer mode; this is the
+     default.  Give GNU 'troff' or a front end program the '-U' option
+     to enable unsafe mode.
+
+ -- Request: .write stream data
+ -- Request: .writec stream data
+     Write to the file associated with the specified STREAM.  The stream
+     must previously have been the subject of an open request.  The
+     remainder of the line is interpreted as the 'ds' request reads its
+     second argument: an initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces, and it is read in
+     copy mode.
+
+     The 'writec' request is like 'write', but only 'write' appends a
+     newline to the data.
+
+ -- Request: .writem stream xx
+     Write the contents of the macro or string XX to the file associated
+     with the specified STREAM.
+
+     XX is read in copy mode, i.e., already formatted elements are
+     ignored.  Consequently, diversions must be unformatted with the
+     'asciify' request before calling 'writem'.  Usually, this means a
+     loss of information.
+
+ -- Request: .close stream
+     Close the specified STREAM; the stream is no longer an acceptable
+     argument to the 'write' request.
+
+     Here a simple macro to write an index entry.
+
+          .open idx test.idx
+          .
+          .de IX
+          .  write idx \\n% \\$*
+          ..
+          .
+          .IX test entry
+          .
+          .close idx
+
+ -- Escape sequence: \Ve
+ -- Escape sequence: \V(ev
+ -- Escape sequence: \Venv
+     Interpolate the contents of the specified environment variable ENV
+     (one-character name E, two-character name EV) as returned by the
+     function 'getenv(3)'.  '\V' is interpreted even in copy mode (*note
+     Copy Mode::).
+
+5.34 Postprocessor Access
+=========================
+
+Two escape sequences and two requests enable documents to pass
+information directly to a postprocessor.  These are useful for
+exercising device-specific capabilities that the 'groff' language does
+not abstract or generalize; examples include the embedding of hyperlinks
+and image files.  Device-specific functions are documented in each
+output driver's man page, such as 'gropdf(1)', 'grops(1)', or
+'grotty(1)'.
+
+ -- Request: .device xxx ...
+ -- Escape sequence: \X'xxx ...'
+     Embed all XXX arguments into GNU 'troff' output as parameters to a
+     device control command 'x X'.  The meaning and interpretation of
+     such parameters is determined by the output driver or other
+     postprocessor.
+
+     The 'device' request processes its arguments in copy mode (*note
+     Copy Mode::).  An initial neutral double quote in CONTENTS is
+     stripped to allow embedding of leading spaces.  By contrast, within
+     '\X' arguments, the escape sequences '\&', '\)', '\%', and '\:' are
+     ignored; '\<SP>' and '\~' are converted to single space characters;
+     and '\\' has its escape character stripped.  So that the basic
+     Latin subset of the Unicode character set(1) (*note Postprocessor
+     Access-Footnote-1::) can be reliably encoded in device control
+     commands, seven special character escape sequences ('\-', '\aq',
+     '\dq', '\ga', '\ha', '\rs', and '\ti',) are mapped to
+     basic Latin characters; see the 'groff_char(7)' man page.  For this
+     transformation, character translations and special character
+     definitions are ignored.(2)  (*note Postprocessor
+     Access-Footnote-2::) The use of any other escape sequence in '\X'
+     parameters is normally an error.
+
+     If the 'use_charnames_in_special' directive appears in the output
+     device's 'DESC' file, the use of special character escape sequences
+     is _not_ an error; they are simply output verbatim (with the
+     exception of the seven mapped to Unicode basic Latin characters,
+     discussed above).  'use_charnames_in_special' is currently employed
+     only by 'grohtml'.
+
+ -- Request: .devicem name
+ -- Escape sequence: \Yn
+ -- Escape sequence: \Y(nm
+ -- Escape sequence: \Yname
+     This is approximately equivalent to '\X'\*NAME'' (one-character
+     name N, two-character name NM).  However, the contents of the
+     string or macro NAME are not interpreted; also it is permitted for
+     NAME to have been defined as a macro and thus contain newlines (it
+     is not permitted for the argument to '\X' to contain newlines).
+     The inclusion of newlines requires an extension to the AT&T 'troff'
+     output format, and confuses drivers that do not know about this
+     extension (*note Device Control Commands::).
+
+ -- Request: .tag name
+ -- Request: .taga name
+     Reserved for internal use.
+
+   (1) that is, ISO 646:1991-IRV or, popularly, "US-ASCII"
+
+   (2) They are bypassed because these parameters are not rendered as
+glyphs in the output; instead, they remain abstract characters--in a PDF
+bookmark or a URL, for example.
+
+5.35 Miscellaneous
+==================
+
+We document here GNU 'troff' features that fit poorly elsewhere.
+
+ -- Request: .nm start increment space indentation
+ -- Register: \nln
+ -- Register: \n.nm
+     Begin (or, with no arguments, cease) numbering output lines.  START
+     assigns the number of the _next_ output line.  Only line numbers
+     divisible by INCREMENT are marked (default: '1').  SPACE configures
+     the horizontal spacing between the number and the text (default:
+     '1').  Any given INDENTATION is applied to the numbers (default:
+     '0').  The third and fourth arguments are reckoned in numeral
+     widths ('\0').  START must be non-negative and INCREMENT positive.
+
+     The formatter aligns the number to the right in a width of three
+     numeral spaces plus INDENTATION, then catenates SPACE and the
+     output line.  The line length is _not_ reduced.  Depending on the
+     value of the page offset,(1) (*note Miscellaneous-Footnote-1::)
+     numbers wider than the allocated space protrude into the left
+     margin, or shift the output line to the right.
+
+     Line numbering parameters corresponding to missing arguments are
+     not altered.  After numbering is disabled, '.nm +0' resumes it
+     using the previously active parameters.
+
+     The parameters of 'nm' are associated with the environment (*note
+     Environments::).
+
+     While numbering is enabled, the output line number register 'ln' is
+     updated as each line is output, even if no line number is formatted
+     with it because it is being skipped (it is not a multiple of
+     INCREMENT) or because numbering is suppressed (see the 'nn' request
+     below).
+
+     The '.nm' register tracks the enablement status of numbering.
+     Temporary suspension of numbering with the 'nn' request does _not_
+     alter its value.
+
+          .po 5n
+          .ll 44n
+          Programming,
+          when stripped of all its circumstantial irrelevancies,
+          .nm 999 1 1 -4
+          boils down to no more and no less than
+          .nm +0 3
+          very effective thinking so as to avoid unmastered
+          .nn 2
+          complexity,
+          to very vigorous separation of your many
+          different concerns.
+          .br
+          \(em Edsger Dijkstra
+          .sp
+          .nm 1 1 1
+          This guy's arrogance takes your breath away.
+          .br
+          \(em John Backus
+              =>      Programming,  when  stripped of all its cir-
+              =>  999 cumstantial irrelevancies, boils down to  no
+              =>      more  and no less than very effective think-
+              =>      ing so as to avoid unmastered complexity, to
+              =>      very vigorous separation of your  many  dif-
+              =>      ferent concerns.
+              => 1002 -- Edsger Dijkstra
+              =>
+              =>    1 This guy's arrogance takes your breath away.
+              =>    2 -- John Backus
+
+ -- Request: .nn skip
+ -- Register: \n.nn
+     Suppress numbering of the next SKIP output lines that would
+     otherwise be numbered.  The default is 1.  'nn' can be invoked when
+     line numbering is not active; suppression of numbering will take
+     effect for SKIP lines once 'nm' enables it.
+
+     The '.nn' register stores the count of output lines still to have
+     their numbering suppressed.
+
+     This count is associated with the environment (*note
+     Environments::).
+
+   To test whether the current output line will be numbered, you must
+check both the '.nm' and '.nn' registers.
+
+       .de is-numbered
+       .  nop This line
+       .  ie (\\n.nm & (1-\\n.nn)) IS
+       .  el                           ISN'T
+       .  nop numbered.
+       .  br
+       ..
+       Test line numbering.
+       .is-numbered
+       .nm 1
+       .nn 1
+       .is-numbered
+       .is-numbered
+       .nm
+       .is-numbered
+         => Test line numbering.  This line ISN'T numbered.
+         => This line ISN'T numbered.
+         =>   1 This line IS numbered.
+         => This line ISN'T numbered.
+
+ -- Request: .mc margin-character distance
+     Begin (or, with no arguments, cease) writing a "margin-character"
+     to the right of each output line.  The DISTANCE argument separates
+     MARGIN-CHARACTER from the right margin.  If absent, the most recent
+     value is used; the default is 10 points.  If an output line exceeds
+     the line length, the margin character is appended to it.  No margin
+     character is written on lines produced by the 'tl' request.
+
+     The margin character is a property of the output line; the margin
+     character last configured when the line is output controls.  If the
+     margin character is disabled before an output line breaks, none is
+     output (but see below).
+
+     The margin character is associated with the environment (*note
+     Environments::).
+
+          .ll 5i
+          .nf
+          .mc \br
+          This paragraph is marked with a margin character.
+          .sp
+          As seen above, vertical space isn't thus marked.
+          \&
+          An output line that is present, but empty, is.
+              => This paragraph is marked with a margin character.  |
+              =>
+              => As seen above, vertical space isn't thus marked.   |
+              =>                                                    |
+              => An output line that is present, but empty, is.     |
+
+   For compatibility with AT&T 'troff', a call to 'mc' to set the margin
+character can't be undone immediately; at least one line gets a margin
+character.
+
+     .ll 10n
+     .nf
+     .mc |
+     .mc *
+     .mc
+     foo
+     bar
+         => foo        *
+         => bar
+
+   The margin character mechanism is commonly used to annotate changes
+in documents.  The 'groff' distribution ships a program, 'gdiffmk', to
+assist with this task.(2)  (*note Miscellaneous-Footnote-2::)
+
+ -- Request: .psbb file
+ -- Register: \nllx
+ -- Register: \nlly
+ -- Register: \nurx
+ -- Register: \nury
+     Retrieve the bounding box of the PostScript image found in FILE,
+     which must conform to Adobe's "Document Structuring Conventions"
+     (DSC), locate a '%%BoundingBox' comment, and store the (upper-,
+     lower-, -left, -right) values into the registers 'llx', 'lly',
+     'urx', and 'ury'.  If an error occurs (for example, if no
+     '%%BoundingBox' comment is present), the formatter sets these
+     registers to 0.
+
+     The search path for FILE can be controlled with the '-I'
+     command-line option.
+
+   (1) Recall *note Line Layout::.
+
+   (2) Historically, tools named 'nrchbar' and 'changebar' were
+developed for marking changes with margin characters and could be found
+in archives of the 'comp.sources.unix' USENET group.  Some proprietary
+Unices also offer(ed) a 'diffmk' program.
+
+5.36 'gtroff' Internals
+=======================
+
+'gtroff' processes input in three steps.  One or more input characters
+are converted to an "input token".(1)  (*note Gtroff
+Internals-Footnote-1::) Then, one or more input tokens are converted to
+an "output node".  Finally, output nodes are converted to the
+intermediate output language understood by all output devices.
+
+   Actually, before step one happens, 'gtroff' converts certain escape
+sequences into reserved input characters (not accessible by the user);
+such reserved characters are used for other internal processing also -
+this is the very reason why not all characters are valid input.  *Note
+Identifiers::, for more on this topic.
+
+   For example, the input string 'fi\:u' is converted into a character
+token 'f', a character token 'i', and a special token ':u' (representing
+u umlaut).  Later on, the character tokens 'f' and 'i' are merged to a
+single output node representing the ligature glyph 'fi' (provided the
+current font has a glyph for this ligature); the same happens with ':u'.
+All output glyph nodes are 'processed', which means that they are
+invariably associated with a given font, font size, advance width, etc.
+During the formatting process, 'gtroff' itself adds various nodes to
+control the data flow.
+
+   Macros, diversions, and strings collect elements in two chained
+lists: a list of input tokens that have been passed unprocessed, and a
+list of output nodes.  Consider the following diversion.
+
+     .di xxx
+     a
+     \!b
+     c
+     .br
+     .di
+
+It contains these elements.
+
+node list            token list   element number
+                                  
+line start node      --           1
+glyph node 'a'       --           2
+word space node      --           3
+--                   'b'          4
+--                   '\n'         5
+glyph node 'c'       --           6
+vertical size node   --           7
+vertical size node   --           8
+--                   '\n'         9
+
+Elements 1, 7, and 8 are inserted by 'gtroff'; the latter two (which are
+always present) specify the vertical extent of the last line, possibly
+modified by '\x'.  The 'br' request finishes the pending output line,
+inserting a newline input token, which is subsequently converted to a
+space when the diversion is reread.  Note that the word space node has a
+fixed width that isn't adjustable anymore.  To convert horizontal space
+nodes back to input tokens, use the 'unformat' request.
+
+   Macros only contain elements in the token list (and the node list is
+empty); diversions and strings can contain elements in both lists.
+
+   The 'chop' request simply reduces the number of elements in a macro,
+string, or diversion by one.  Exceptions are "compatibility save" and
+"compatibility ignore" input tokens, which are ignored.  The 'substring'
+request also ignores those input tokens.
+
+   Some requests like 'tr' or 'cflags' work on glyph identifiers only;
+this means that the associated glyph can be changed without destroying
+this association.  This can be very helpful for substituting glyphs.  In
+the following example, we assume that glyph 'foo' isn't available by
+default, so we provide a substitution using the 'fchar' request and map
+it to input character 'x'.
+
+     .fchar \foo foo
+     .tr x \foo
+
+Now let us assume that we install an additional special font 'bar' that
+has glyph 'foo'.
+
+     .special bar
+     .rchar \foo
+
+Since glyphs defined with 'fchar' are searched before glyphs in special
+fonts, we must call 'rchar' to remove the definition of the fallback
+glyph.  Anyway, the translation is still active; 'x' now maps to the
+real glyph 'foo'.
+
+   Macro and request arguments preserve compatibility mode enablement.
+
+     .cp 1     \" switch to compatibility mode
+     .de xx
+     \\$1
+     ..
+     .cp 0     \" switch compatibility mode off
+     .xx caf\'e
+         => café
+
+Since compatibility mode is enabled while 'de' is invoked, the macro
+'xx' enables compatibility mode when it is called.  Argument '$1' can
+still be handled properly because it inherits the compatibility mode
+enablement status that was active at the point where 'xx' was called.
+
+   After interpolation of the parameters, the compatibility save and
+restore tokens are removed.
+
+   (1) Except the escape sequences '\f', '\F', '\H', '\m', '\M', '\R',
+'\s', and '\S', which are processed immediately if not in copy mode.
+
+5.37 Debugging
+==============
+
+          Standard troff voodoo, just put a power of two backslashes in
+    front of it until it works and if you still have problems add a \c.
+                                                         -- Ron Natalie
+
+   GNU 'troff' is not the easiest language to debug, in part thanks to
+its design features of recursive interpolation and the use of
+multi-stage pipeline processing in the surrounding system.  Nevertheless
+there exist several features useful for troubleshooting.
+
+   Preprocessors use the 'lf' request to preserve the identity of the
+line numbers and names of input files.  GNU 'troff' emits a variety of
+error diagnostics and supports several categories of warning; the output
+of these can be selectively suppressed.  A trace of the formatter's
+input processing stack can be emitted when errors or warnings occur by
+means of GNU 'troff''s '-b' option, or produced on demand with the
+'backtrace' request.  The 'tm' and related requests can be used to emit
+customized diagnostic messages or for instrumentation while
+troubleshooting.  The 'ex' and 'ab' requests cause early termination
+with successful and error exit codes respectively, to halt further
+processing when continuing would be fruitless.  Examine the state of the
+formatter with requests that write lists of defined names (macros,
+strings, and diversions), environments, registers, and page location
+traps to the standard error stream.
+
+ -- Request: .lf line file
+     Set the input line number (and, optionally, the file name) GNU
+     'troff' shall use for error and warning messages.  LINE is the
+     input line number of the _next_ line.  Without an argument, the
+     request is ignored.
+
+     'lf''s primary purpose is to aid the debugging of documents that
+     undergo preprocessing.  Programs like 'tbl' that transform input in
+     their own languages into 'roff' requests use it so that any
+     diagnostic messages emitted by 'troff' correspond to the source
+     document.
+
+ -- Request: .tm message
+ -- Request: .tm1 message
+ -- Request: .tmc message
+     Send MESSAGE, which consumes the remainder of the input line and
+     cannot contain special characters, to the standard error stream,
+     followed by a newline.  Leading spaces in MESSAGE are ignored.
+
+     'tm1' is similar, but recognizes and strips a leading neutral
+     double quote from MESSAGE to allow the embedding of leading spaces.
+
+     'tmc' works as 'tm1', but does not append a newline.
+
+ -- Request: .ab message
+     Write any MESSAGE to the standard error stream (like 'tm') and then
+     abort GNU 'troff'; that is, stop processing and terminate with a
+     failure status.
+
+ -- Request: .ex
+     Exit GNU 'troff'; that is, stop processing and terminate with a
+     successful status.  To stop processing only the current file, use
+     the 'nx' request; see *note I/O::.
+
+   When doing something involved, it is useful to leave the debugging
+statements in the code and have them turned on by a command-line flag.
+
+     .if \nDB .tm debugging output
+
+To activate such statements, use the '-r' option to set the register.
+
+     groff -rDB=1 file
+
+   If it is known in advance that there are many errors and no useful
+output, GNU 'troff' can be forced to suppress formatted output with the
+'-z' option.
+
+ -- Request: .pev
+     Report the state of the current environment followed by that of all
+     other environments to the standard error stream.
+
+ -- Request: .pm
+     Report, to the standard error stream, the names of all defined
+     macros, strings, and diversions with their sizes in bytes.
+
+ -- Request: .pnr
+     Report the names and contents of all currently defined registers to
+     the standard error stream.
+
+ -- Request: .ptr
+     Report the names and positions of all page location traps to the
+     standard error stream.  Empty slots in the list, where a trap has
+     been planted but subsequently (re)moved, are printed as well.
+
+ -- Request: .fl
+     Instruct 'gtroff' to flush its output immediately.  The intent is
+     for interactive use, but this behaviour is currently not
+     implemented in 'gtroff'.  Contrary to Unix 'troff', TTY output is
+     sent to a device driver also ('grotty'), making it non-trivial to
+     communicate interactively.
+
+     This request causes a line break.
+
+ -- Request: .backtrace
+     Write the state of the input stack to the standard error stream.
+
+     Consider the following in a file 'test'.
+
+          .de xxx
+          .  backtrace
+          ..
+          .de yyy
+          .  xxx
+          ..
+          .
+          .yyy
+              error-> troff: backtrace: 'test':2: macro 'xxx'
+              error-> troff: backtrace: 'test':5: macro 'yyy'
+              error-> troff: backtrace: file 'test':8
+
+     The '-b' option of GNU 'troff' causes a backtrace to be generated
+     on each error or warning.  Some warnings have to be enabled; *Note
+     Warnings::.
+
+ -- Register: \nslimit
+     If greater than 0, sets the maximum quantity of objects on GNU
+     'troff''s internal input stack.  If less than or equal to 0, there
+     is no limit: recursion can continue until program memory is
+     exhausted.  The default is 1,000.
+
+ -- Request: .warnscale su
+     Set the scaling unit used in certain warnings to SU, which can take
+     the values 'u', 'i', 'c', 'p', and 'P'.  The default is 'i'.
+
+ -- Request: .spreadwarn limit
+     Emit a 'break' warning if the additional space inserted for each
+     space between words in an output line adjusted to both margins with
+     '.ad b' is larger than or equal to LIMIT.  A negative value is
+     treated as zero; an absent argument toggles the warning on and off
+     without changing LIMIT.  The default scaling unit is 'm'.  At
+     startup, 'spreadwarn' is inactive and LIMIT is 3m.
+
+     For example,
+
+          .spreadwarn 0.2m
+
+     causes a warning if 'break' warnings are not suppressed and
+     'gtroff' must add 0.2m or more for each inter-word space in a line.
+     *Note Warnings::.
+
+   GNU 'troff' has command-line options for reporting warnings ('-w')
+and backtraces ('-b') when a warning or an error occurs.
+
+ -- Request: .warn n
+ -- Register: \n.warn
+     Select the categories, or "types", of reported warnings.  N is the
+     sum of the numeric codes associated with each warning category that
+     is to be enabled; all other categories are disabled.  The
+     categories and their associated codes are listed in *note
+     Warnings::.  For example, '.warn 0' disables all warnings, and
+     '.warn 1' disables all warnings except those about missing glyphs.
+     If no argument is given, all warning categories are enabled.
+
+     The read-only register '.warn' contains the sum of the numeric
+     codes of enabled warning categories.
+
+5.37.1 Warnings
+---------------
+
+Warning diagnostics emitted by GNU 'troff' are divided into named,
+numbered categories.  The name associated with each warning category is
+used by the '-w' and '-W' options.  Each category is also assigned a
+power of two; the sum of enabled category values is used by the 'warn'
+request and the '.warn' register.
+
+   Warnings of each category are produced under the following
+circumstances.
+
+'char'
+'1'
+     No mounted font defines a glyph for the requested character.  This
+     category is enabled by default.
+
+'number'
+'2'
+     An invalid numeric expression was encountered.  This category is
+     enabled by default.  *Note Numeric Expressions::.
+
+'break'
+'4'
+     A filled output line could not be broken such that its length was
+     less than the output line length '\n.l'.  This category is
+     enabled by default.
+
+'delim'
+'8'
+     The closing delimiter in an escape sequence was missing or
+     mismatched.
+
+'el'
+'16'
+     The 'el' request was encountered with no prior corresponding 'ie'
+     request.  *Note if-else::.
+
+'scale'
+'32'
+     A scaling unit inappropriate to its context was used in a numeric
+     expression.
+
+'range'
+'64'
+     A numeric expression was out of range for its context.
+
+'syntax'
+'128'
+     A self-contradictory hyphenation mode was requested; an empty or
+     incomplete numeric expression was encountered; an operand to a
+     numeric operator was missing; an attempt was made to define a
+     recursive, empty, or nonsensical character class; or a 'groff'
+     extension conditional expression operator was used while in
+     compatibility mode.
+
+'di'
+'256'
+     A 'di', 'da', 'box', or 'boxa' request was invoked without an
+     argument when there was no current diversion.
+
+'mac'
+'512'
+     An undefined string, macro, or diversion was used.  When such an
+     object is dereferenced, an empty one of that name is automatically
+     created.  So, unless it is later deleted, at most one warning is
+     given for each.
+
+     This warning is also emitted upon an attempt to move an unplanted
+     trap macro (*note Page Location Traps::).  In such cases, the
+     unplanted macro is _not_ dereferenced, so it is not created if it
+     does not exist.
+
+'reg'
+'1024'
+     An undefined register was used.  When an undefined register is
+     dereferenced, it is automatically defined with a value of 0.  So,
+     unless it is later deleted, at most one warning is given for each.
+
+'tab'
+'2048'
+     A tab character was encountered where a number was expected, or
+     appeared in an unquoted macro argument.
+
+'right-brace'
+'4096'
+     A right brace escape sequence '\}' was encountered where a number
+     was expected.
+
+'missing'
+'8192'
+     A request was invoked with a mandatory argument absent.
+
+'input'
+'16384'
+     An invalid character occurred on the input stream.
+
+'escape'
+'32768'
+     An unsupported escape sequence was encountered.
+
+'space'
+'65536'
+     A space was missing between a request or macro and its argument.
+     This warning is produced when an undefined name longer than two
+     characters is encountered and the first two characters of the name
+     constitute a defined name.  No request is invoked, no macro called,
+     and an empty macro is not defined.  This category is enabled by
+     default.  It never occurs in compatibility mode.
+
+'font'
+'131072'
+     A non-existent font was selected, or the selection was ignored
+     because a font selection escape sequence was used after the output
+     line continuation escape sequence on an input line.  This category
+     is enabled by default.
+
+'ig'
+'262144'
+     An invalid escape sequence occurred in input ignored using the 'ig'
+     request.  This warning category diagnoses a condition that is an
+     error when it occurs in non-ignored input.
+
+'color'
+'524288'
+     An undefined color was selected, an attempt was made to define a
+     color using an unrecognized color space, an invalid component in a
+     color definition was encountered, or an attempt was made to
+     redefine a default color.
+
+'file'
+'1048576'
+     An attempt was made to load a file that does not exist.  This
+     category is enabled by default.
+
+   Two warning names group other warning categories for convenience.
+
+'all'
+     All warning categories except 'di', 'mac' and 'reg'.  This
+     shorthand is intended to produce all warnings that are useful with
+     macro packages written for AT&T 'troff' and its descendants, which
+     have less fastidious diagnostics than GNU 'troff'.
+
+'w'
+     All warning categories.  Authors of documents and macro packages
+     targeting 'groff' are encouraged to use this setting.
+
+5.38 Implementation Differences
+===============================
+
+GNU 'troff' has a number of features that cause incompatibilities with
+documents written for other versions of 'troff'.  Some GNU extensions to
+'troff' have become supported by other implementations.
+
+5.38.1 Safer Mode
+-----------------
+
+The formatter operates in "safer" mode by default; to mitigate risks
+from untrusted input documents, the 'pi' and 'sy' requests are disabled.
+GNU 'troff''s '-U' option enables "unsafe mode", restoring their
+function and enabling additional 'groff' extension requests, 'open',
+'opena', and 'pso'.  *Note I/O::.
+
+5.38.2 Compatibility Mode
+-------------------------
+
+Long identifier names may be GNU 'troff''s most obvious innovation.
+AT&T 'troff' interprets '.dsabcd' as defining a string 'ab' with
+contents 'cd'.  Normally, GNU 'troff' interprets this as a call of a
+macro named 'dsabcd'.  AT&T 'troff' also interprets '\*' and '\n' as
+an interpolation of a string or register, respectively, named ''.  In
+GNU 'troff', however, the '' is normally interpreted as delimiting a
+long name.  In compatibility mode, GNU 'troff' interprets names in the
+traditional way; they thus can be two characters long at most.
+
+ -- Request: .cp n
+ -- Register: \n.C
+     If N is missing or non-zero, turn on compatibility mode; otherwise,
+     turn it off.
+
+     The read-only register '.C' is 1 if compatibility mode is on,
+     0 otherwise.
+
+     Compatibility mode can be also turned on with the '-C' command-line
+     option.
+
+ -- Request: .do name
+ -- Register: \n.cp
+     The 'do' request interprets the string, request, diversion, or
+     macro NAME (along with any further arguments) with compatibility
+     mode disabled.  Compatibility mode is restored (only if it was
+     active) when the _expansion_ of NAME is interpreted; that is, the
+     restored compatibility state applies to the contents of the macro,
+     string, or diversion NAME as well as data read from files or pipes
+     if NAME is any of the 'so', 'soquiet', 'mso', 'msoquiet', or 'pso'
+     requests.
+
+     The following example illustrates several aspects of 'do' behavior.
+
+          .de mac1
+          FOO
+          ..
+          .de1 mac2
+          groff
+          .mac1
+          ..
+          .de mac3
+          compatibility
+          .mac1
+          ..
+          .de ma
+          \\$1
+          ..
+          .cp 1
+          .do mac1
+          .do mac2 \" mac2, defined with .de1, calls "mac1"
+          .do mac3 \" mac3 calls "ma" with argument "c1"
+          .do mac3 \ti \" groff syntax accepted in .do arguments
+              => FOO groff FOO compatibility c1 ~
+
+     The read-only register '.cp', meaningful only when dereferenced
+     from a 'do' request, is 1 if compatibility mode was on when the
+     'do' request was encountered, and 0 if it was not.  This register
+     is specialized and may require a statement of rationale.
+
+     When writing macro packages or documents that use GNU 'troff'
+     features and which may be mixed with other packages or documents
+     that do not--common scenarios include serial processing of man
+     pages or use of the 'so' or 'mso' requests--you may desire correct
+     operation regardless of compatibility mode enablement in the
+     surrounding context.  It may occur to you to save the existing
+     value of '\n(.C' into a register, say, '_C', at the beginning of
+     your file, turn compatibility mode off with '.cp 0', then restore
+     it from that register at the end with '.cp \n(_C'.  At the same
+     time, a modular design of a document or macro package may lead you
+     to multiple layers of inclusion.  You cannot use the same register
+     name everywhere lest you "clobber" the value from a preceding or
+     enclosing context.  The two-character register name space of AT&T
+     'troff' is confining and mnemonically challenging; you may wish to
+     use the more capacious name space of GNU 'troff'.  However,
+     attempting '.nr _my_saved_C \n(.C' will not work in compatibility
+     mode; the register name is too long.  "This is exactly what 'do' is
+     for," you think, '.do nr _my_saved_C \n(.C'.  The foregoing will
+     always save zero to your register, because 'do' turns compatibility
+     mode _off_ while it interprets its argument list.
+
+     To robustly save compatibility mode before switching it off, use
+
+          .do nr _my_saved_C \n.cp
+          .cp 0
+
+     at the beginning of your file, followed by
+
+          .cp \n_my_saved_C
+          .do rr _my_saved_C
+
+     at the end.  As in the C language, we all have to share one big
+     name space, so choose a register name that is unlikely to collide
+     with other uses.
+
+   Normally, GNU 'troff' preserves the interpolation depth in delimited
+arguments, but not in compatibility mode.
+
+     .ds xx '
+     \w'abc\*(xxdef'
+         => 168 (normal mode on a terminal device)
+         => 72def' (compatibility mode on a terminal device)
+
+   Furthermore, the escape sequences '\f', '\H', '\m', '\M', '\R', '\s',
+and '\S' are transparent for the purpose of recognizing a control
+character at the beginning of a line only in compatibility mode.  For
+example, this code produces bold output in both cases, but the text
+differs.
+
+     .de xx
+     Hello!
+     ..
+     \fB.xx\fP
+         => .xx (normal mode)
+         => Hello! (compatibility mode)
+
+   Normally, the syntax form '\s'N accepts only a single character (a
+digit) for N, consistently with other forms that originated in AT&T
+'troff', like '\*', '\$', '\f', '\g', '\k', '\n', and '\z'.  In
+compatibility mode only, a non-zero N must be in the range 4-39.  Legacy
+documents relying upon this quirk of parsing(1) (*note Compatibility
+Mode-Footnote-1::) should be migrated to another '\s' form.
+
+   (1) The Graphic Systems C/A/T phototypesetter (the original device
+target for AT&T 'troff') supported only a few discrete type sizes in the
+range 6-36 points, so Ossanna contrived a special case in the parser to
+do what the user must have meant.  Kernighan warned of this in the 1992
+revision of CSTR #54 (§2.3), and more recently, McIlroy referred to it
+as a "living fossil".
+
+5.38.3 Other Differences
+------------------------
+
+'groff' request names unrecognized by other 'troff' implementations will
+likely be ignored by them; escape sequences that are 'groff' extensions
+are liable to be interpreted as if the escape character were not
+present.  For example, the adjustable, non-breaking escape sequence '\~'
+is also supported by Heirloom Doctools 'troff' 050915 (September 2005),
+'mandoc' 1.9.5 (2009-09-21), 'neatroff' (commit 1c6ab0f6e, 2016-09-13),
+and Plan 9 from User Space 'troff' (commit 93f8143600, 2022-08-12), but
+not by Solaris or Documenter's Workbench 'troff's.  *Note Manipulating
+Filling and Adjustment::.
+
+   GNU 'troff' does not allow the use of the escape sequences '\|',
+'\^', '\&', '\{', '\}', '\<SP>', '\'', '\`', '\-', '\_', '\!', '\%', and
+'\c' in identifiers; AT&T 'troff' does.  The '\A' escape sequence (*note
+Identifiers::) may be helpful in avoiding use of these escape sequences
+in names.
+
+   When adjusting to both margins, AT&T 'troff' at first adjusts spaces
+starting from the right; GNU 'troff' begins from the left.  Both
+implementations adjust spaces from opposite ends on alternating output
+lines in this adjustment mode to prevent "rivers" in the text.
+
+   GNU 'troff' does not always hyphenate words as AT&T 'troff' does.
+The AT&T implementation uses a set of hard-coded rules specific to
+English, while GNU 'troff' uses language-specific hyphenation pattern
+files derived from TeX.  Furthermore, in old versions of 'troff' there
+was a limited amount of space to store hyphenation exceptions (arguments
+to the 'hw' request); GNU 'troff' has no such restriction.
+
+   GNU 'troff' predefines a string '.T' containing the argument given to
+the '-T' command-line option, namely the current output device (for
+example, 'pdf' or 'utf8').  The existence of this string is a common
+feature of post-CSTR #54 'troff's(1) (*note Other
+Differences-Footnote-1::) but valid values are specific to each
+implementation.
+
+   AT&T 'troff' ignored attempts to remove read-only registers; GNU
+'troff' honors such requests.  *Note Built-in Registers::.
+
+   The (read-only) register '.T' interpolates 1 if GNU 'troff' is called
+with the '-T' command-line option, and 0 otherwise.  This behavior
+differs from AT&T 'troff', which interpolated 1 only if 'nroff' was the
+formatter and was called with '-T'.
+
+   AT&T 'troff' and other implementations handle the 'lf' request
+differently.  For them, its LINE argument changes the line number of the
+_current_ line.
+
+   AT&T 'troff' had only environments named '0', '1', and '2'.  In GNU
+'troff', any number of environments may exist, using any valid
+identifiers for their names (*note Identifiers::.)
+
+   Fractional type sizes cause one noteworthy incompatibility.  In AT&T
+'troff' the 'ps' request ignores scaling units and thus '.ps 10u' sets
+the type size to 10 points, whereas in GNU 'troff' it sets the type size
+to 10 _scaled_ points.  *Note Using Fractional Type Sizes::.
+
+   The 'ab' request differs from AT&T 'troff': GNU 'troff' writes no
+message to the standard error stream if no arguments are given, and it
+exits with a failure status instead of a successful one.
+
+   The 'bp' request differs from AT&T 'troff': GNU 'troff' does not
+accept a scaling unit on the argument, a page number; the former
+(somewhat uselessly) does.
+
+   The 'pm' request differs from AT&T 'troff': GNU 'troff' reports the
+sizes of macros, strings, and diversions in bytes and ignores an
+argument to report only the sum of the sizes.
+
+   Unlike AT&T 'troff', GNU 'troff' does not ignore the 'ss' request if
+the output is a terminal device; instead, the values of minimal
+inter-word and additional inter-sentence space are each rounded down to
+the nearest multiple of 12.
+
+   In GNU 'troff' there is a fundamental difference between
+(unformatted) characters and (formatted) glyphs.  Everything that
+affects how a glyph is output is stored with the glyph node; once a
+glyph node has been constructed, it is unaffected by any subsequent
+requests that are executed, including 'bd', 'cs', 'tkf', 'tr', or 'fp'
+requests.  Normally, glyphs are constructed from characters immediately
+before the glyph is added to an output line.  Macros, diversions, and
+strings are all, in fact, the same type of object; they contain a
+sequence of intermixed character and glyph nodes.  Special characters
+transform from one to the other: before being added to the output, they
+behave as characters; afterward, they are glyphs.  A glyph node does not
+behave like a character node when it is processed by a macro: it does
+not inherit any of the special properties that the character from which
+it was constructed might have had.  For example, the input
+
+     .di x
+     \\\\
+     .br
+     .di
+     .x
+
+produces '\\' in GNU 'troff'.  Each pair of backslashes becomes one
+backslash _glyph_; the resulting backslashes are thus not interpreted as
+escape _characters_ when they are reread as the diversion is output.
+AT&T 'troff' _would_ interpret them as escape characters when rereading
+them and end up printing one '\'.
+
+   One correct way to obtain a printable backslash in most documents is
+to use the '\e' escape sequence; this always prints a single instance of
+the current escape character,(2) (*note Other Differences-Footnote-2::)
+regardless of whether or not it is used in a diversion; it also works in
+both GNU 'troff' and AT&T 'troff'.
+
+   The other correct way, appropriate in contexts independent of the
+backslash's common use as a 'troff' escape character--perhaps in
+discussion of character sets or other programming languages--is the
+character escape '\(rs' or '\rs', for "reverse solidus", from its name
+in the ECMA-6 (ISO/IEC 646) standard.(3)  (*note Other
+Differences-Footnote-3::)
+
+   To store an escape sequence in a diversion that is interpreted when
+the diversion is reread, either use the traditional '\!' transparent
+output facility, or, if this is unsuitable, the new '\?' escape
+sequence.  *Note Diversions:: and *note Gtroff Internals::.
+
+   In the somewhat pathological case where a diversion exists containing
+a partially collected line and a partially collected line at the
+top-level diversion has never existed, AT&T 'troff' will output the
+partially collected line at the end of input; GNU 'troff' will not.
+
+   (1) DWB 3.3, Solaris, Heirloom Doctools, and Plan 9 'troff' all
+support it.
+
+   (2) Naturally, if you've changed the escape character, you need to
+prefix the 'e' with whatever it is--and you'll likely get something
+other than a backslash in the output.
+
+   (3) The 'rs' special character identifier was not defined in AT&T
+'troff''s font description files, but is in those of its lineal
+descendant, Heirloom Doctools 'troff', as of the latter's 060716 release
+(July 2006).
+
+6 File Formats
+**************
+
+All files read and written by 'gtroff' are text files.  The following
+two sections describe their format.
+
+6.1 'gtroff' Output
+===================
+
+This section describes the 'groff' intermediate output format produced
+by GNU 'troff'.
+
+   As 'groff' is a wrapper program around GNU 'troff' and automatically
+calls an output driver (or "postprocessor"), this output does not show
+up normally.  This is why it is called _intermediate_.  'groff' provides
+the option '-Z' to inhibit postprocessing such that the produced
+intermediate output is sent to standard output just as it is when
+calling GNU 'troff' directly.
+
+   Here, the term "troff output" describes what is output by GNU
+'troff', while "intermediate output" refers to the language that is
+accepted by the parser that prepares this output for the output drivers.
+This parser handles whitespace more flexibly than AT&T's implementation
+and implements obsolete elements for compatibility; otherwise, both
+formats are the same.(1)  (*note gtroff Output-Footnote-1::)
+
+   The main purpose of the intermediate output concept is to facilitate
+the development of postprocessors by providing a common programming
+interface for all devices.  It has a language of its own that is
+completely different from the 'gtroff' language.  While the 'gtroff'
+language is a high-level programming language for text processing, the
+intermediate output language is a kind of low-level assembler language
+by specifying all positions on the page for writing and drawing.
+
+   The intermediate output produced by 'gtroff' is fairly readable,
+while output from AT&T 'troff' is rather hard to understand because of
+strange habits that are still supported, but not used any longer by
+'gtroff'.
+
+   (1) The parser and postprocessor for intermediate output can be found
+in the file
+'GROFF-SOURCE-DIR/src/libs/libdriver/input.cpp'.
+
+6.1.1 Language Concepts
+-----------------------
+
+The fundamental operation of the GNU 'troff' formatter is the
+translation of the 'groff' input language into a device-independent form
+primarily concerned with what has to be written or drawn at specific
+positions on the output device.  This language is simple and imperative.
+In the following discussion, the term "command" always refers to this
+intermediate output language, and never to the 'groff' language intended
+for direct use by document authors.  Intermediate output commands
+comprise several categories: glyph output; font, color, and text size
+selection; motion of the printing position; page advancement; drawing of
+geometric objects; and device control commands, a catch-all for
+operations not easily classified as any of the foregoing, such as
+directives to start and stop output, identify the intended output
+device, or place URL hyperlinks in supported output formats.
+
+6.1.1.1 Separation
+..................
+
+AT&T 'troff' output has strange requirements regarding whitespace.  The
+'gtroff' output parser, however, is more tolerant, making whitespace
+maximally optional.  Such characters, i.e., the tab, space, and newline,
+always have a syntactical meaning.  They are never printable because
+spacing within the output is always done by positioning commands.
+
+   Any sequence of space or tab characters is treated as a single
+"syntactical space".  It separates commands and arguments, but is only
+required when there would occur a clashing between the command code and
+the arguments without the space.  Most often, this happens when
+variable-length command names, arguments, argument lists, or command
+clusters meet.  Commands and arguments with a known, fixed length need
+not be separated by syntactical space.
+
+   A line break is a syntactical element, too.  Every command argument
+can be followed by whitespace, a comment, or a newline character.  Thus
+a "syntactical line break" is defined to consist of optional syntactical
+space that is optionally followed by a comment, and a newline character.
+
+   The normal commands, those for positioning and text, consist of a
+single letter taking a fixed number of arguments.  For historical
+reasons, the parser allows stacking of such commands on the same line,
+but fortunately, in 'gtroff''s intermediate output, every command with
+at least one argument is followed by a line break, thus providing
+excellent readability.
+
+   The other commands--those for drawing and device controlling--have a
+more complicated structure; some recognize long command names, and some
+take a variable number of arguments.  So all 'D' and 'x' commands were
+designed to request a syntactical line break after their last argument.
+Only one command, 'x X', has an argument that can span several input
+lines; all other commands must have all of their arguments on the same
+line as the command, i.e., the arguments may not be split by a line
+break.
+
+   Empty lines (these are lines containing only space and/or a comment),
+can occur everywhere.  They are just ignored.
+
+6.1.1.2 Argument Units
+......................
+
+Some commands take integer arguments that are assumed to represent
+values in a measurement unit, but the letter for the corresponding
+scaling unit is not written with the output command arguments.  Most
+commands assume the scaling unit 'u', the basic unit of the device, some
+use 'z', the scaled point unit of the device, while others, such as the
+color commands, expect plain integers.
+
+   Single characters can have the eighth bit set, as can the names of
+fonts and special characters.  The names of characters and fonts can be
+of arbitrary length.  A character that is to be printed is always in the
+current font.
+
+   A string argument is always terminated by the next whitespace
+character (space, tab, or newline); an embedded '#' character is
+regarded as part of the argument, not as the beginning of a comment
+command.  An integer argument is already terminated by the next
+non-digit character, which then is regarded as the first character of
+the next argument or command.
+
+6.1.1.3 Document Parts
+......................
+
+A correct intermediate output document consists of two parts, the
+"prologue" and the "body".
+
+   The task of the prologue is to set the general device parameters
+using three exactly specified commands.  'gtroff''s prologue is
+guaranteed to consist of the following three lines (in that order):
+
+     x T DEVICE
+     x res N H V
+     x init
+
+with the arguments set as outlined in *note Device Control Commands::.
+The parser for the intermediate output format is able to interpret
+additional whitespace and comments as well even in the prologue.
+
+   The body is the main section for processing the document data.
+Syntactically, it is a sequence of any commands different from the ones
+used in the prologue.  Processing is terminated as soon as the first
+'x stop' command is encountered; the last line of any 'gtroff'
+intermediate output always contains such a command.
+
+   Semantically, the body is page oriented.  A new page is started by a
+'p' command.  Positioning, writing, and drawing commands are always done
+within the current page, so they cannot occur before the first 'p'
+command.  Absolute positioning (by the 'H' and 'V' commands) is done
+relative to the current page; all other positioning is done relative to
+the current location within this page.
+
+6.1.2 Command Reference
+-----------------------
+
+This section describes all intermediate output commands, both from AT&T
+'troff' as well as the 'gtroff' extensions.
+
+6.1.2.1 Comment Command
+.......................
+
+'#ANYTHING<end of line>'
+     A comment.  Ignore any characters from the '#' character up to the
+     next newline character.
+
+     This command is the only possibility for commenting in the
+     intermediate output.  Each comment can be preceded by arbitrary
+     syntactical space; every command can be terminated by a comment.
+
+6.1.2.2 Simple Commands
+.......................
+
+The commands in this subsection have a command code consisting of a
+single character, taking a fixed number of arguments.  Most of them are
+commands for positioning and text writing.  These commands are tolerant
+of whitespace.  Optionally, syntactical space can be inserted before,
+after, and between the command letter and its arguments.  All of these
+commands are stackable; i.e., they can be preceded by other simple
+commands or followed by arbitrary other commands on the same line.  A
+separating syntactical space is necessary only when two integer
+arguments would clash or if the preceding argument ends with a string
+argument.
+
+'C ID<whitespace>'
+     Typeset the glyph of the special character ID.  Trailing
+     syntactical space is necessary to allow special character names of
+     arbitrary length.  The drawing position is not advanced.
+
+'c G'
+     Typeset the glyph of the ordinary character C.  The drawing
+     position is not advanced.
+
+'f N'
+     Select the font mounted at position N.  N cannot be negative.
+
+'H N'
+     Horizontally move the drawing position to N basic units from the
+     left edge of the page.  N cannot be negative.
+
+'h N'
+     Move the drawing position right N basic units.  AT&T 'troff'
+     allowed negative N; GNU 'troff' does not produce such values, but
+     'groff''s output driver library handles them.
+
+'m COLOR-SCHEME COMPONENT ...'
+     Select the stroke color using the COMPONENTs in the color space
+     SCHEME.  Each COMPONENT is an integer between 0 and 65535.  The
+     quantity of components and their meanings vary with each SCHEME.
+     This command is a 'groff' extension.
+
+     'mc CYAN MAGENTA YELLOW'
+          Use the CMY color scheme with components cyan, magenta, and
+          yellow.
+
+     'md'
+          Use the default color (no components; black in most cases).
+
+     'mg GRAY'
+          Use a grayscale color scheme with a component ranging between
+          0 (black) and 65535 (white).
+
+     'mk CYAN MAGENTA YELLOW BLACK'
+          Use the CMYK color scheme with components cyan, magenta,
+          yellow, and black.
+
+     'mr RED GREEN BLUE'
+          Use the RGB color scheme with components red, green, and blue.
+
+'N N'
+     Typeset the glyph with index N in the current font.  N is normally
+     a non-negative integer.  The drawing position is not advanced.  The
+     'html' and 'xhtml' devices use this command with negative N to
+     produce unbreakable space; the absolute value of N is taken and
+     interpreted in basic units.
+
+'n B A'
+     Indicate a break.  No action is performed; the command is present
+     to make the output more easily parsed.  The integers B and A
+     describe the vertical space amounts before and after the break,
+     respectively.  GNU 'troff' issues this command but 'groff''s output
+     driver library ignores it.  See 'v' and 'V' below.
+
+'p N'
+     Begin a new page, setting its number to N.  Each page is
+     independent, even from those using the same number.  The vertical
+     drawing position is set to 0.  All positioning, writing, and
+     drawing commands are interpreted in the context of a page, so a
+     'p' command must precede them.
+
+'s N'
+     Set type size to N scaled points (unit 'z' in GNU 'troff'.  AT&T
+     'troff' used unscaled points 'p' instead; see *note Output Language
+     Compatibility::.
+
+'t XYZ<whitespace>'
+'t XYZ DUMMY-ARG<whitespace>'
+     Typeset a word XYZ; that is, set a sequence of ordinary glyphs
+     named X, Y, Z, ..., terminated by a space character or a line
+     break; an optional second integer argument is ignored (this allows
+     the formatter to generate an even number of arguments).  Each glyph
+     is set at the current drawing position, and the position is then
+     advanced horizontally by the glyph's width.  A glyph's width is
+     read from its metrics in the font description file, scaled to the
+     current type size, and rounded to a multiple of the horizontal
+     motion quantum.  Use the 'C' command to emplace glyphs of special
+     characters.  The 't' command is a 'groff' extension and is output
+     only for devices whose 'DESC' file contains the 'tcommand'
+     directive; see *note DESC File Format::.
+
+'u N XYZ<whitespace>'
+     Typeset word XYZ with track kerning.  As 't', but after placing
+     each glyph, the drawing position is further advanced horizontally
+     by N basic units ('u').  The 'u' command is a 'groff' extension and
+     is output only for devices whose 'DESC' file contains the
+     'tcommand' directive; see *note DESC File Format::.
+
+'V N'
+     Vertically move the drawing position to N basic units from the top
+     edge of the page.  N cannot be negative.
+
+'v N'
+     Move the drawing position down N basic units.  AT&T 'troff' allowed
+     negative N; GNU 'troff' does not produce such values, but 'groff''s
+     output driver library handles them.
+
+'w'
+     Indicate an inter-word space.  No action is performed; the command
+     is present to make the output more easily parsed.  Only adjustable,
+     breakable inter-word spaces are thus described; those resulting
+     from '\~' or horizontal motion escape sequences are not.  GNU
+     'troff' issues this command but 'groff''s output driver library
+     ignores it.  See 'h' and 'H' above.
+
+6.1.2.3 Graphics Commands
+.........................
+
+Each graphics or drawing command in the intermediate output starts with
+the letter 'D', followed by one or two characters that specify a
+subcommand; this is followed by a fixed or variable number of integer
+arguments that are separated by a single space character.  A 'D' command
+may not be followed by another command on the same line (apart from a
+comment), so each 'D' command is terminated by a syntactical line break.
+
+   'gtroff' output follows the classical spacing rules (no space between
+command and subcommand, all arguments are preceded by a single space
+character), but the parser allows optional space between the command
+letters and makes the space before the first argument optional.  As
+usual, each space can be any sequence of tab and space characters.
+
+   Some graphics commands can take a variable number of arguments.  In
+this case, they are integers representing a size measured in basic units
+'u'.  The arguments called H1, H2, ..., HN stand for horizontal
+distances where positive means right, negative left.  The arguments
+called V1, V2, ..., VN stand for vertical distances where positive means
+down, negative up.  All these distances are offsets relative to the
+current location.
+
+   Each graphics command directly corresponds to a similar 'gtroff' '\D'
+escape sequence.  *Note Drawing Geometric Objects::.
+
+   Unknown 'D' commands are assumed to be device-specific.  Its
+arguments are parsed as strings; the whole information is then sent to
+the postprocessor.
+
+   In the following command reference, the syntax element <line break>
+means a syntactical line break as defined above.
+
+'D~ H1 V1 H2 V2 ... HN VN<line break>'
+     Draw B-spline from current position to offset (H1,V1), then to
+     offset (H2,V2), if given, etc., up to (HN,VN).  This command takes
+     a variable number of argument pairs; the current position is moved
+     to the terminal point of the drawn curve.
+
+'Da H1 V1 H2 V2<line break>'
+     Draw arc from current position to (H1,V1)+(H2,V2) with center at
+     (H1,V1); then move the current position to the final point of the
+     arc.
+
+'DC D<line break>'
+'DC D DUMMY-ARG<line break>'
+     Draw a solid circle using the current fill color with diameter D
+     (integer in basic units 'u') with leftmost point at the current
+     position; then move the current position to the rightmost point of
+     the circle.  An optional second integer argument is ignored (this
+     allows the formatter to generate an even number of arguments).
+     This command is a 'gtroff' extension.
+
+'Dc D<line break>'
+     Draw circle line with diameter D (integer in basic units 'u') with
+     leftmost point at the current position; then move the current
+     position to the rightmost point of the circle.
+
+'DE H V<line break>'
+     Draw a solid ellipse in the current fill color with a horizontal
+     diameter of H and a vertical diameter of V (both integers in basic
+     units 'u') with the leftmost point at the current position; then
+     move to the rightmost point of the ellipse.  This command is a
+     'gtroff' extension.
+
+'De H V<line break>'
+     Draw an outlined ellipse with a horizontal diameter of H and a
+     vertical diameter of V (both integers in basic units 'u') with the
+     leftmost point at current position; then move to the rightmost
+     point of the ellipse.
+
+'DF COLOR-SCHEME COMPONENT ...<line break>'
+     Set fill color for solid drawing objects using different color
+     schemes; the analogous command for setting the color of text, line
+     graphics, and the outline of graphic objects is 'm'.  The color
+     components are specified as integer arguments between 0 and 65535.
+     The number of color components and their meaning vary for the
+     different color schemes.  These commands are generated by
+     'gtroff''s escape sequences '\D'F ...'' and '\M' (with no other
+     corresponding graphics commands).  No position changing.  This
+     command is a 'gtroff' extension.
+
+     'DFc CYAN MAGENTA YELLOW<line break>'
+          Set fill color for solid drawing objects using the CMY color
+          scheme, having the 3 color components CYAN, MAGENTA, and
+          YELLOW.
+
+     'DFd<line break>'
+          Set fill color for solid drawing objects to the default fill
+          color value (black in most cases).  No component arguments.
+
+     'DFg GRAY<line break>'
+          Set fill color for solid drawing objects to the shade of gray
+          given by the argument, an integer between 0 (black) and 65535
+          (white).
+
+     'DFk CYAN MAGENTA YELLOW BLACK<line break>'
+          Set fill color for solid drawing objects using the CMYK color
+          scheme, having the 4 color components CYAN, MAGENTA, YELLOW,
+          and BLACK.
+
+     'DFr RED GREEN BLUE<line break>'
+          Set fill color for solid drawing objects using the RGB color
+          scheme, having the 3 color components RED, GREEN, and BLUE.
+
+'Df N<line break>'
+     The argument N must be an integer in the range -32767 to 32767.
+
+     0 <= N <= 1000
+          Set the color for filling solid drawing objects to a shade of
+          gray, where 0 corresponds to solid white, 1000 (the default)
+          to solid black, and values in between to intermediate shades
+          of gray; this is obsoleted by command 'DFg'.
+
+     N < 0 or N > 1000
+          Set the filling color to the color that is currently being
+          used for the text and the outline, see command 'm'.  For
+          example, the command sequence
+
+               mg 0 0 65535
+               Df -1
+
+          sets all colors to blue.
+
+     No position changing.  This command is a 'gtroff' extension.
+
+'Dl H V<line break>'
+     Draw line from current position to offset (H,V) (integers in basic
+     units 'u'); then set current position to the end of the drawn line.
+
+'Dp H1 V1 H2 V2 ... HN VN<line break>'
+     Draw a polygon line from current position to offset (H1,V1), from
+     there to offset (H2,V2), etc., up to offset (HN,VN), and from there
+     back to the starting position.  For historical reasons, the
+     position is changed by adding the sum of all arguments with odd
+     index to the actual horizontal position and the even ones to the
+     vertical position.  Although this doesn't make sense it is kept for
+     compatibility.  This command is a 'gtroff' extension.
+
+'DP H1 V1 H2 V2 ... HN VN<line break>'
+     Draw a solid polygon in the current fill color rather than an
+     outlined polygon, using the same arguments and positioning as the
+     corresponding 'Dp' command.  This command is a 'gtroff' extension.
+
+'Dt N<line break>'
+     Set the current line thickness to N (an integer in basic units 'u')
+     if N>0; if N=0 select the smallest available line thickness; if N<0
+     set the line thickness proportional to the type size (this is the
+     default before the first 'Dt' command was specified).  For
+     historical reasons, the horizontal position is changed by adding
+     the argument to the actual horizontal position, while the vertical
+     position is not changed.  Although this doesn't make sense it is
+     kept for compatibility.  This command is a 'gtroff' extension.
+
+6.1.2.4 Device Control Commands
+...............................
+
+Each device control command starts with the letter 'x', followed by a
+space character (optional or arbitrary space or tab in 'gtroff') and a
+subcommand letter or word; each argument (if any) must be preceded by a
+syntactical space.  All 'x' commands are terminated by a syntactical
+line break; no device control command can be followed by another command
+on the same line (except a comment).
+
+   The subcommand is basically a single letter, but to increase
+readability, it can be written as a word, i.e., an arbitrary sequence of
+characters terminated by the next tab, space, or newline character.  All
+characters of the subcommand word but the first are simply ignored.  For
+example, 'gtroff' outputs the initialization command 'x i' as 'x init'
+and the resolution command 'x r' as 'x res'.
+
+   In the following, the syntax element <line break> means a syntactical
+line break (*note Separation::).
+
+'xF NAME<line break>'
+     The 'F' stands for FILENAME.
+
+     Use NAME as the intended name for the current file in error
+     reports.  This is useful for remembering the original file name
+     when 'gtroff' uses an internal piping mechanism.  The input file is
+     not changed by this command.  This command is a 'gtroff' extension.
+
+'xf N S<line break>'
+     The 'f' stands for FONT.
+
+     Mount font position N (a non-negative integer) with font named S (a
+     text word).  *Note Font Positions::.
+
+'xH N<line break>'
+     The 'H' stands for HEIGHT.
+
+     Set glyph height to N (a positive integer in scaled points 'z').
+     AT&T 'troff' uses the unit points ('p') instead.  *Note Output
+     Language Compatibility::.
+
+'xi<line break>'
+     The 'i' stands for INIT.
+
+     Initialize device.  This is the third command of the prologue.
+
+'xp<line break>'
+     The 'p' stands for PAUSE.
+
+     Parsed but ignored.  The AT&T 'troff' manual documents this command
+     as
+
+          pause device, can be restarted
+
+     but GNU 'troff' output drivers do nothing with this command.
+
+'xr N H V<line break>'
+     The 'r' stands for RESOLUTION.
+
+     Resolution is N, while H is the minimal horizontal motion, and V
+     the minimal vertical motion possible with this device; all
+     arguments are positive integers in basic units 'u' per inch.  This
+     is the second command of the prologue.
+
+'xS N<line break>'
+     The 'S' stands for SLANT.
+
+     Set slant to N (an integer in basic units 'u').
+
+'xs<line break>'
+     The 's' stands for STOP.
+
+     Terminates the processing of the current file; issued as the last
+     command of any intermediate 'troff' output.
+
+'xt<line break>'
+     The 't' stands for TRAILER.
+
+     Generate trailer information, if any.  In GNU 'troff', this is
+     ignored.
+
+'xT XXX<line break>'
+     The 'T' stands for TYPESETTER.
+
+     Set the name of the output driver to XXX, a sequence of
+     non-whitespace characters terminated by whitespace.  The possible
+     names correspond to those of 'groff''s '-T' option.  This is the
+     first command of the prologue.
+
+'xu N<line break>'
+     The 'u' stands for UNDERLINE.
+
+     Configure underlining of spaces.  If N is 1, start underlining of
+     spaces; if N is 0, stop underlining of spaces.  This is needed for
+     the 'cu' request in 'nroff' mode and is ignored otherwise.  This
+     command is a 'gtroff' extension.
+
+'xX ANYTHING<line break>'
+     The 'x' stands for X-ESCAPE.
+
+     Send string ANYTHING uninterpreted to the device.  If the line
+     following this command starts with a '+' character this line is
+     interpreted as a continuation line in the following sense.  The '+'
+     is ignored, but a newline character is sent instead to the device,
+     the rest of the line is sent uninterpreted.  The same applies to
+     all following lines until the first character of a line is not a
+     '+' character.  This command is generated by the 'gtroff' escape
+     sequence '\X'.  The line-continuing feature is a 'gtroff'
+     extension.
+
+6.1.2.5 Obsolete Command
+........................
+
+In AT&T 'troff' output, the writing of a single glyph is mostly done by
+a very strange command that combines a horizontal move and a single
+character giving the glyph name.  It doesn't have a command code, but is
+represented by a 3-character argument consisting of exactly 2 digits and
+a character.
+
+DDG
+     Move right DD (exactly two decimal digits) basic units 'u', then
+     print glyph G (represented as a single character).
+
+     In GNU 'troff', arbitrary syntactical space around and within this
+     command is allowed.  Only when a preceding command on the same line
+     ends with an argument of variable length is a separating space
+     obligatory.  In AT&T 'troff', large clusters of these and other
+     commands are used, mostly without spaces; this made such output
+     almost unreadable.
+
+   For modern high-resolution devices, this command does not make sense
+because the width of the glyphs can become much larger than two decimal
+digits.  In 'gtroff', this is only used for the devices 'X75', 'X75-12',
+'X100', and 'X100-12'.  For other devices, the commands 't' and 'u'
+provide a better functionality.
+
+6.1.3 Intermediate Output Examples
+----------------------------------
+
+This section presents the intermediate output generated from the same
+input for three different devices.  The input is the sentence 'hell
+world' fed into 'gtroff' on the command line.
+
+High-resolution device 'ps'
+
+     This is the standard output of 'gtroff' if no '-T' option is given.
+
+          shell> echo "hell world" | groff -Z -T ps
+
+          x T ps
+          x res 72000 1 1
+          x init
+          p1
+          x font 5 TR
+          f5
+          s10000
+          V12000
+          H72000
+          thell
+          wh2500
+          tw
+          H96620
+          torld
+          n12000 0
+          x trailer
+          V792000
+          x stop
+
+     This output can be fed into 'grops' to get its representation as a
+     PostScript file.
+
+Low-resolution device 'latin1'
+
+     This is similar to the high-resolution device except that the
+     positioning is done at a minor scale.  Some comments (lines
+     starting with '#') were added for clarification; they were not
+     generated by the formatter.
+
+          shell> echo "hell world" | groff -Z -T latin1
+
+          # prologue
+          x T latin1
+          x res 240 24 40
+          x init
+          # begin a new page
+          p1
+          # font setup
+          x font 1 R
+          f1
+          s10
+          # initial positioning on the page
+          V40
+          H0
+          # write text 'hell'
+          thell
+          # inform about space, and issue a horizontal jump
+          wh24
+          # write text 'world'
+          tworld
+          # announce line break, but do nothing because...
+          n40 0
+          # ...the end of the document has been reached
+          x trailer
+          V2640
+          x stop
+
+     This output can be fed into 'grotty' to get a formatted text
+     document.
+
+AT&T 'troff' output
+     Since a computer monitor has a much lower resolution than modern
+     printers, the intermediate output for X11 devices can use the
+     jump-and-write command with its 2-digit displacements.
+
+          shell> echo "hell world" | groff -Z -T X100
+
+          x T X100
+          x res 100 1 1
+          x init
+          p1
+          x font 5 TR
+          f5
+          s10
+          V16
+          H100
+          # write text with jump-and-write commands
+          ch07e07l03lw06w11o07r05l03dh7
+          n16 0
+          x trailer
+          V1100
+          x stop
+
+     This output can be fed into 'xditview' or 'gxditview' for
+     displaying in X.
+
+     Due to the obsolete jump-and-write command, the text clusters in
+     the AT&T 'troff' output are almost unreadable.
+
+6.1.4 Output Language Compatibility
+-----------------------------------
+
+The intermediate output language of AT&T 'troff' was first documented in
+'A Typesetter-independent TROFF', by Brian Kernighan, and by 1992 the
+AT&T 'troff' manual was updated to incorprate a description of it.
+
+   The GNU 'troff' intermediate output format is compatible with this
+specification except for the following features.
+
+   * The classical quasi-device independence is not yet implemented.
+
+   * The old hardware was very different from what we use today.  So the
+     'groff' devices are also fundamentally different from the ones in
+     AT&T 'troff'.  For example, the AT&T PostScript device is called
+     'post' and has a resolution of only 720 units per inch, suitable
+     for printers 20 years ago, while 'groff''s 'ps' device has a
+     resolution of 72000 units per inch.  Maybe, by implementing some
+     rescaling mechanism similar to the classical quasi-device
+     independence, 'groff' could emulate AT&T's 'post' device.
+
+   * The B-spline command 'D~' is correctly handled by the intermediate
+     output parser, but the drawing routines aren't implemented in some
+     of the postprocessor programs.
+
+   * The argument of the commands 's' and 'x H' has the implicit unit
+     scaled point 'z' in 'gtroff', while AT&T 'troff' has point ('p').
+     This isn't an incompatibility but a compatible extension, for both
+     units coincide for all devices without a 'sizescale' parameter in
+     the 'DESC' file, including all postprocessors from AT&T and
+     'groff''s text devices.  The few 'groff' devices with a 'sizescale'
+     parameter either do not exist for AT&T 'troff', have a different
+     name, or seem to have a different resolution.  So conflicts are
+     very unlikely.
+
+   * The position changing after the commands 'Dp', 'DP', and 'Dt' is
+     illogical, but as old versions of 'gtroff' used this feature it is
+     kept for compatibility reasons.
+
+6.2 Device and Font Description Files
+=====================================
+
+The 'groff' font and output device description formats are slight
+extensions of those used by AT&T device-independent 'troff'.  In
+distinction to the AT&T implementation, 'groff' lacks a binary format;
+all files are text files.(1)  (*note Device and Font Description
+Files-Footnote-1::) The device and font description files for a device
+NAME are stored in a 'devNAME' directory.  The device description file
+is called 'DESC', and, for each font supported by the device, a font
+description file is called 'F', where F is usually an abbreviation of a
+font's name and/or style.  For example, the 'ps' (PostScript) device has
+'groff' font description files for Times roman ('TR') and Zapf Chancery
+Medium italic ('ZCMI'), among many others, while the 'utf8' device (for
+terminal emulators) has only font descriptions for the roman, italic,
+bold, and bold-italic styles ('R', 'I', 'B', and 'BI', respectively).
+
+   Device and font description files are read both by the formatter, GNU
+'troff', and by output drivers.  The programs delegate these files'
+processing to an internal library, 'libgroff', ensuring their consistent
+interpretation.
+
+   (1) Plan 9 'troff' has also abandoned the binary format.
+
+6.2.1 'DESC' File Format
+------------------------
+
+The 'DESC' file contains a series of directives; each begins a line.
+Their order is not important, with two exceptions: (1) the 'res'
+directive must precede any 'papersize' directive; and (2) the 'charset'
+directive must come last (if at all).  If a directive name is repeated,
+later entries in the file override previous ones (except that the paper
+dimensions are computed based on the 'res' directive last seen when
+'papersize' is encountered).  Spaces and/or tabs separate words and are
+ignored at line boundaries.  Comments start with the '#' character and
+extend to the end of a line.  Empty lines are ignored.
+
+'family FAM'
+     The default font family is FAM.
+
+'fonts N F1 ... FN'
+     Fonts F1, ..., FN are mounted at font positions M+1, ..., M+N where
+     M is the number of 'styles' (see below).  This directive may extend
+     over more than one line.  A font name of '0' causes no font to be
+     mounted at the corresponding position.
+
+'hor N'
+     The horizontal motion quantum is N basic units.  All horizontal
+     quantities are rounded to multiples of N.
+
+'image_generator PROGRAM'
+     Use PROGRAM to generate PNG images from PostScript input.  Under
+     GNU/Linux, this is usually 'gs', but under other systems (notably
+     Cygwin) it might be set to another name.  The 'grohtml' driver uses
+     this directive.
+
+'paperlength N'
+     The vertical dimension of the output medium is N basic units
+     (deprecated: use 'papersize' instead).
+
+'papersize FORMAT-OR-DIMENSION-PAIR-OR-FILE-NAME ...'
+     The dimensions of the output medium are as according to the
+     argument, which is either a standard paper format, a pair of
+     dimensions, or the name of a plain text file containing either of
+     the foregoing.
+
+     Recognized paper formats are the ISO and DIN formats 'A0'-'A7',
+     'B0'-'B7', 'C0'-'C7', 'D0'-'D7'; the U.S. paper types 'letter',
+     'legal', 'tabloid', 'ledger', 'statement', and 'executive'; and the
+     envelope formats 'com10', 'monarch', and 'DL'.  Matching is
+     performed without regard for lettercase.
+
+     Alternatively, the argument can be a custom paper format in the
+     format 'LENGTH,WIDTH' (with no spaces before or after the comma).
+     Both LENGTH and WIDTH must have a unit appended; valid units are
+     'i' for inches, 'c' for centimeters, 'p' for points, and 'P' for
+     picas.  Example: '12c,235p'.  An argument that starts with a digit
+     is always treated as a custom paper format.
+
+     Finally, the argument can be a file name (e.g., '/etc/papersize');
+     if the file can be opened, the first line is read and a match
+     attempted against each of the other forms.  No comment syntax is
+     supported.
+
+     More than one argument can be specified; each is scanned in turn
+     and the first valid paper specification used.
+
+'paperwidth N'
+     The horizontal dimension of the output medium is N basic units
+     (deprecated: use 'papersize' instead).
+
+'pass_filenames'
+     Direct GNU 'troff' to emit the name of the source file being
+     processed.  This is achieved with the intermediate output command
+     'x F', which 'grohtml' interprets.
+
+'postpro PROGRAM'
+     Use PROGRAM as the postprocessor.
+
+'prepro PROGRAM'
+     Use PROGRAM as a preprocessor.  The 'html' and 'xhtml' output
+     devices use this directive.
+
+'print PROGRAM'
+     Use PROGRAM as a spooler program for printing.  If omitted, the
+     '-l' and '-L' options of 'groff' are ignored.
+
+'res N'
+     The device resolution is N basic units per inch.
+
+'sizes S1 ... SN 0'
+     The device has fonts at S1, ..., SN scaled points (see below).  The
+     list of sizes must be terminated by '0'.  Each SI can also be a
+     range of sizes M-N.  The list can extend over more than one line.
+
+'sizescale N'
+     A typographical point is subdivided into N scaled points.  The
+     default is '1'.  *Note Using Fractional Type Sizes::.
+
+'styles S1 ... SM'
+     The first M mounting positions are associated with styles S1, ...,
+     SM.
+
+'tcommand'
+     The postprocessor can handle the 't' and 'u' intermediate output
+     commands.
+
+'unicode'
+     The output device supports the complete Unicode repertoire.  This
+     directive is useful only for devices that produce character
+     entities instead of glyphs.
+
+     If 'unicode' is present, no 'charset' section is required in the
+     font description files since the Unicode handling built into
+     'groff' is used.  However, if there are entries in a font
+     description file's 'charset' section, they either override the
+     default mappings for those particular characters or add new
+     mappings (normally for composite characters).
+
+     The 'utf8', 'html', and 'xhtml' output devices use this directive.
+
+'unitwidth N'
+     Quantities in the font description files are in basic units for
+     fonts whose type size is N scaled points.
+
+'unscaled_charwidths'
+     Make the font handling module always return unscaled character
+     widths.  The 'grohtml' driver uses this directive.
+
+'use_charnames_in_special'
+     GNU 'troff' should encode special characters inside device control
+     commands; see *note Postprocessor Access::.  The 'grohtml' driver
+     uses this directive.
+
+'vert N'
+     The vertical motion quantum is N basic units.  All vertical
+     quantities are rounded to multiples of N.
+
+'charset'
+     This line and everything following it in the file are ignored.  It
+     is recognized for compatibility with other 'troff' implementations.
+     In GNU 'troff', character set repertoire is described on a per-font
+     basis.
+
+   GNU 'troff' recognizes but ignores the directives 'spare1', 'spare2',
+and 'biggestfont'.
+
+   The 'res', 'unitwidth', 'fonts', and 'sizes' lines are mandatory.
+Directives not listed above are ignored by GNU 'troff' but may be used
+by postprocessors to obtain further information about the device.
+
+6.2.2 Font Description File Format
+----------------------------------
+
+On typesetting output devices, each font is typically available at
+multiple sizes.  While paper measurements in the device description file
+are in absolute units, measurements applicable to fonts must be
+proportional to the type size.  'groff' achieves this using the
+precedent set by AT&T device-independent 'troff': one font size is
+chosen as a norm, and all others are scaled linearly relative to that
+basis.  The "unit width" is the number of basic units per point when the
+font is rendered at this nominal size.
+
+   For instance, 'groff''s 'lbp' device uses a 'unitwidth' of 800.  Its
+Times roman font 'TR' has a 'spacewidth' of 833; this is also the width
+of its comma, period, centered period, and mathematical asterisk, while
+its 'M' is 2,963 basic units.  Thus, an 'M' on the 'lbp' device is 2,963
+basic units wide at a notional type size of 800 points.(1)  (*note Font
+Description File Format-Footnote-1::)
+
+   A font description file has two sections.  The first is a sequence of
+directives, and is parsed similarly to the 'DESC' file described above.
+Except for the directive names that begin the second section, their
+ordering is immaterial.  Later directives of the same name override
+earlier ones, spaces and tabs are handled in the same way, and the same
+comment syntax is supported.  Empty lines are ignored throughout.
+
+'name F'
+     The name of the font is F.  'DESC' is an invalid font name.  Simple
+     integers are valid, but their use is discouraged.(2)  (*note Font
+     Description File Format-Footnote-2::)
+
+'spacewidth N'
+     The width of an unadjusted inter-word space is N basic units.
+
+   The directives above must appear in the first section; those below
+are optional.
+
+'slant N'
+     The font's glyphs have a slant of N degrees; a positive N slants in
+     the direction of text flow.
+
+'ligatures LIG1 ... LIGN 0'
+     Glyphs LIG1, ..., LIGN are ligatures; possible ligatures are 'ff',
+     'fi', 'fl', 'ffi' and 'ffl'.  For compatibility with other 'troff'
+     implementations, the list of ligatures may be terminated with
+     a '0'.  The list of ligatures must not extend over more than one
+     line.
+
+'special'
+     The font is "special": when a glyph is requested that is not
+     present in the current font, it is sought in any mounted fonts that
+     bear this property.
+
+   Other directives in this section are ignored by GNU 'troff', but may
+be used by postprocessors to obtain further information about the font.
+
+   The second section contains one or two subsections.  These can appear
+in either order; the first one encountered commences the second section.
+Each starts with a directive on a line by itself.  A 'charset'
+subsection is mandatory unless the associated 'DESC' file contains the
+'unicode' directive.  Another subsection, 'kernpairs', is optional.
+
+   The directive 'charset' starts the character set subsection.(3)
+(*note Font Description File Format-Footnote-3::) It precedes a series
+of glyph descriptions, one per line.  Each such glyph description
+comprises a set of fields separated by spaces or tabs and organized as
+follows.
+
+     NAME METRICS TYPE CODE ENTITY-NAME '--' COMMENT
+
+NAME identifies the glyph: if NAME is a printable character C, it
+corresponds to the 'troff' ordinary character C.  If NAME is a
+multi-character sequence not beginning with '\', it corresponds to the
+GNU 'troff' special character escape sequence '\NAME'.  A name
+consisting of three minus signs, '---', is special and indicates that
+the glyph is unnamed: such glyphs can be accessed only by the '\N'
+escape sequence in 'troff'.  A special character named '---' can still
+be defined using 'char' and similar requests.  The NAME '\-' defines the
+minus sign glyph.  Finally, NAME can be the unbreakable one-sixth and
+one-twelfth space escape sequences, '\|' and '\^' ("thin" and "hair"
+spaces, respectively), in which case only the width metric described
+below is interpreted; a font can thus customize the widths of these
+spaces.
+
+   The form of the METRICS field is as follows.
+
+     WIDTH','HEIGHT','DEPTH','ITALIC-CORRECTION
+       ','LEFT-ITALIC-CORRECTION','SUBSCRIPT-CORRECTION
+
+There must not be any spaces, tabs, or newlines between these
+"subfields" (which have been split here into two lines only for better
+legibility).  The subfields are in basic units expressed as decimal
+integers.  Unspecified subfields default to '0'.  Since there is no
+associated binary format, these values are not required to fit into the
+C language data type 'char' as they are in AT&T device-independent
+'troff'.
+
+   The WIDTH subfield gives the width of the glyph.  The HEIGHT subfield
+gives the height of the glyph (upward is positive); if a glyph does not
+extend above the baseline, it should be given a zero height, rather than
+a negative height.  The DEPTH subfield gives the depth of the glyph,
+that is, the distance below the baseline to which the glyph extends
+(downward is positive); if a glyph does not extend below the baseline,
+it should be given a zero depth, rather than a negative depth.  Italic
+corrections are relevant to glyphs in italic or oblique styles.  The
+ITALIC-CORRECTION is the amount of space that should be added after an
+oblique glyph to be followed immediately by an upright glyph.  The
+LEFT-ITALIC-CORRECTION is the amount of space that should be added
+before an oblique glyph to be preceded immediately by an upright glyph.
+The SUBSCRIPT-CORRECTION is the amount of space that should be added
+after an oblique glyph to be followed by a subscript; it should be less
+than the italic correction.
+
+   For fonts used with typesetting devices, the TYPE field gives a
+featural description of the glyph: it is a bit mask recording whether
+the glyph is an ascender, descender, both, or neither.  When a '\w'
+escape sequence is interpolated, these values are bitwise or-ed together
+for each glyph and stored in the 'nr' register.  In font descriptions
+for terminal devices, all glyphs might have a type of zero, regardless
+of their appearance.
+
+'0'
+     means the glyph lies entirely between the baseline and a horizontal
+     line at the "x-height" of the font; typical examples are 'a', 'c',
+     and 'x';
+
+'1'
+     means the glyph descends below the baseline, like 'p';
+
+'2'
+     means the glyph ascends above the font's x-height, like 'A' or 'b';
+     and
+
+'3'
+     means the glyph is both an ascender and a descender--this is true
+     of parentheses in some fonts.
+
+   The CODE field gives a numeric identifier that the postprocessor uses
+to render the glyph.  The glyph can be specified to 'troff' using this
+code by means of the '\N' escape sequence.  CODE can be any integer.(4)
+(*note Font Description File Format-Footnote-4::)
+
+   The ENTITY-NAME field defines an identifier for the glyph that the
+postprocessor uses to print the GNU 'troff' glyph NAME.  This field is
+optional; it was introduced so that the 'grohtml' output driver could
+encode its character set.  For example, the glyph '\Po' is represented
+by '&pound;' in HTML 4.0.  For efficiency, these data are now compiled
+directly into 'grohtml'.  'grops' uses the field to build sub-encoding
+arrays for PostScript fonts containing more than 256 glyphs.  Anything
+on the line after the ENTITY-NAME field or '--' is ignored.
+
+   A line in the 'charset' section can also have the form
+
+     NAME "
+
+identifying NAME as another name for the glyph mentioned in the
+preceding line.  Such aliases can be chained.
+
+   The directive 'kernpairs' starts a list of kerning adjustments to be
+made to adjacent glyph pairs from this font.  It contains a sequence of
+lines formatted as follows.
+
+     G1 G2 N
+
+The foregoing means that when glyph G1 is typeset immediately before G2,
+the space between them should be increased by N.  Most kerning pairs
+should have a negative value for N.
+
+   (1) 800-point type is not practical for most purposes, but using it
+enables the quantities in the font description files to be expressed as
+integers.
+
+   (2) 'groff' requests and escape sequences interpret non-negative font
+names as mounting positions instead.  Further, a font named '0' cannot
+be automatically mounted by the 'fonts' directive of a 'DESC' file.
+
+   (3) For typesetter devices, this directive is misnamed since it
+starts a list of glyphs, not characters.
+
+   (4) that is, any integer parsable by the C standard library's
+'strtol(3)' function
+
+Appendix A Copying This Manual
+******************************
+
+                     Version 1.3, 3 November 2008
+
+     Copyright © 2000-2018 Free Software Foundation, Inc.
+     <http://fsf.org/>
+
+     Everyone is permitted to copy and distribute verbatim copies
+     of this license document, but changing it is not allowed.
+
+  0. PREAMBLE
+
+     The purpose of this License is to make a manual, textbook, or other
+     functional and useful document "free" in the sense of freedom: to
+     assure everyone the effective freedom to copy and redistribute it,
+     with or without modifying it, either commercially or
+     noncommercially.  Secondarily, this License preserves for the
+     author and publisher a way to get credit for their work, while not
+     being considered responsible for modifications made by others.
+
+     This License is a kind of "copyleft", which means that derivative
+     works of the document must themselves be free in the same sense.
+     It complements the GNU General Public License, which is a copyleft
+     license designed for free software.
+
+     We have designed this License in order to use it for manuals for
+     free software, because free software needs free documentation: a
+     free program should come with manuals providing the same freedoms
+     that the software does.  But this License is not limited to
+     software manuals; it can be used for any textual work, regardless
+     of subject matter or whether it is published as a printed book.  We
+     recommend this License principally for works whose purpose is
+     instruction or reference.
+
+  1. APPLICABILITY AND DEFINITIONS
+
+     This License applies to any manual or other work, in any medium,
+     that contains a notice placed by the copyright holder saying it can
+     be distributed under the terms of this License.  Such a notice
+     grants a world-wide, royalty-free license, unlimited in duration,
+     to use that work under the conditions stated herein.  The
+     "Document", below, refers to any such manual or work.  Any member
+     of the public is a licensee, and is addressed as "you".  You accept
+     the license if you copy, modify or distribute the work in a way
+     requiring permission under copyright law.
+
+     A "Modified Version" of the Document means any work containing the
+     Document or a portion of it, either copied verbatim, or with
+     modifications and/or translated into another language.
+
+     A "Secondary Section" is a named appendix or a front-matter section
+     of the Document that deals exclusively with the relationship of the
+     publishers or authors of the Document to the Document's overall
+     subject (or to related matters) and contains nothing that could
+     fall directly within that overall subject.  (Thus, if the Document
+     is in part a textbook of mathematics, a Secondary Section may not
+     explain any mathematics.)  The relationship could be a matter of
+     historical connection with the subject or with related matters, or
+     of legal, commercial, philosophical, ethical or political position
+     regarding them.
+
+     The "Invariant Sections" are certain Secondary Sections whose
+     titles are designated, as being those of Invariant Sections, in the
+     notice that says that the Document is released under this License.
+     If a section does not fit the above definition of Secondary then it
+     is not allowed to be designated as Invariant.  The Document may
+     contain zero Invariant Sections.  If the Document does not identify
+     any Invariant Sections then there are none.
+
+     The "Cover Texts" are certain short passages of text that are
+     listed, as Front-Cover Texts or Back-Cover Texts, in the notice
+     that says that the Document is released under this License.  A
+     Front-Cover Text may be at most 5 words, and a Back-Cover Text may
+     be at most 25 words.
+
+     A "Transparent" copy of the Document means a machine-readable copy,
+     represented in a format whose specification is available to the
+     general public, that is suitable for revising the document
+     straightforwardly with generic text editors or (for images composed
+     of pixels) generic paint programs or (for drawings) some widely
+     available drawing editor, and that is suitable for input to text
+     formatters or for automatic translation to a variety of formats
+     suitable for input to text formatters.  A copy made in an otherwise
+     Transparent file format whose markup, or absence of markup, has
+     been arranged to thwart or discourage subsequent modification by
+     readers is not Transparent.  An image format is not Transparent if
+     used for any substantial amount of text.  A copy that is not
+     "Transparent" is called "Opaque".
+
+     Examples of suitable formats for Transparent copies include plain
+     ASCII without markup, Texinfo input format, LaTeX input format,
+     SGML or XML using a publicly available DTD, and standard-conforming
+     simple HTML, PostScript or PDF designed for human modification.
+     Examples of transparent image formats include PNG, XCF and JPG.
+     Opaque formats include proprietary formats that can be read and
+     edited only by proprietary word processors, SGML or XML for which
+     the DTD and/or processing tools are not generally available, and
+     the machine-generated HTML, PostScript or PDF produced by some word
+     processors for output purposes only.
+
+     The "Title Page" means, for a printed book, the title page itself,
+     plus such following pages as are needed to hold, legibly, the
+     material this License requires to appear in the title page.  For
+     works in formats which do not have any title page as such, "Title
+     Page" means the text near the most prominent appearance of the
+     work's title, preceding the beginning of the body of the text.
+
+     The "publisher" means any person or entity that distributes copies
+     of the Document to the public.
+
+     A section "Entitled XYZ" means a named subunit of the Document
+     whose title either is precisely XYZ or contains XYZ in parentheses
+     following text that translates XYZ in another language.  (Here XYZ
+     stands for a specific section name mentioned below, such as
+     "Acknowledgements", "Dedications", "Endorsements", or "History".)
+     To "Preserve the Title" of such a section when you modify the
+     Document means that it remains a section "Entitled XYZ" according
+     to this definition.
+
+     The Document may include Warranty Disclaimers next to the notice
+     which states that this License applies to the Document.  These
+     Warranty Disclaimers are considered to be included by reference in
+     this License, but only as regards disclaiming warranties: any other
+     implication that these Warranty Disclaimers may have is void and
+     has no effect on the meaning of this License.
+
+  2. VERBATIM COPYING
+
+     You may copy and distribute the Document in any medium, either
+     commercially or noncommercially, provided that this License, the
+     copyright notices, and the license notice saying this License
+     applies to the Document are reproduced in all copies, and that you
+     add no other conditions whatsoever to those of this License.  You
+     may not use technical measures to obstruct or control the reading
+     or further copying of the copies you make or distribute.  However,
+     you may accept compensation in exchange for copies.  If you
+     distribute a large enough number of copies you must also follow the
+     conditions in section 3.
+
+     You may also lend copies, under the same conditions stated above,
+     and you may publicly display copies.
+
+  3. COPYING IN QUANTITY
+
+     If you publish printed copies (or copies in media that commonly
+     have printed covers) of the Document, numbering more than 100, and
+     the Document's license notice requires Cover Texts, you must
+     enclose the copies in covers that carry, clearly and legibly, all
+     these Cover Texts: Front-Cover Texts on the front cover, and
+     Back-Cover Texts on the back cover.  Both covers must also clearly
+     and legibly identify you as the publisher of these copies.  The
+     front cover must present the full title with all words of the title
+     equally prominent and visible.  You may add other material on the
+     covers in addition.  Copying with changes limited to the covers, as
+     long as they preserve the title of the Document and satisfy these
+     conditions, can be treated as verbatim copying in other respects.
+
+     If the required texts for either cover are too voluminous to fit
+     legibly, you should put the first ones listed (as many as fit
+     reasonably) on the actual cover, and continue the rest onto
+     adjacent pages.
+
+     If you publish or distribute Opaque copies of the Document
+     numbering more than 100, you must either include a machine-readable
+     Transparent copy along with each Opaque copy, or state in or with
+     each Opaque copy a computer-network location from which the general
+     network-using public has access to download using public-standard
+     network protocols a complete Transparent copy of the Document, free
+     of added material.  If you use the latter option, you must take
+     reasonably prudent steps, when you begin distribution of Opaque
+     copies in quantity, to ensure that this Transparent copy will
+     remain thus accessible at the stated location until at least one
+     year after the last time you distribute an Opaque copy (directly or
+     through your agents or retailers) of that edition to the public.
+
+     It is requested, but not required, that you contact the authors of
+     the Document well before redistributing any large number of copies,
+     to give them a chance to provide you with an updated version of the
+     Document.
+
+  4. MODIFICATIONS
+
+     You may copy and distribute a Modified Version of the Document
+     under the conditions of sections 2 and 3 above, provided that you
+     release the Modified Version under precisely this License, with the
+     Modified Version filling the role of the Document, thus licensing
+     distribution and modification of the Modified Version to whoever
+     possesses a copy of it.  In addition, you must do these things in
+     the Modified Version:
+
+       A. Use in the Title Page (and on the covers, if any) a title
+          distinct from that of the Document, and from those of previous
+          versions (which should, if there were any, be listed in the
+          History section of the Document).  You may use the same title
+          as a previous version if the original publisher of that
+          version gives permission.
+
+       B. List on the Title Page, as authors, one or more persons or
+          entities responsible for authorship of the modifications in
+          the Modified Version, together with at least five of the
+          principal authors of the Document (all of its principal
+          authors, if it has fewer than five), unless they release you
+          from this requirement.
+
+       C. State on the Title page the name of the publisher of the
+          Modified Version, as the publisher.
+
+       D. Preserve all the copyright notices of the Document.
+
+       E. Add an appropriate copyright notice for your modifications
+          adjacent to the other copyright notices.
+
+       F. Include, immediately after the copyright notices, a license
+          notice giving the public permission to use the Modified
+          Version under the terms of this License, in the form shown in
+          the Addendum below.
+
+       G. Preserve in that license notice the full lists of Invariant
+          Sections and required Cover Texts given in the Document's
+          license notice.
+
+       H. Include an unaltered copy of this License.
+
+       I. Preserve the section Entitled "History", Preserve its Title,
+          and add to it an item stating at least the title, year, new
+          authors, and publisher of the Modified Version as given on the
+          Title Page.  If there is no section Entitled "History" in the
+          Document, create one stating the title, year, authors, and
+          publisher of the Document as given on its Title Page, then add
+          an item describing the Modified Version as stated in the
+          previous sentence.
+
+       J. Preserve the network location, if any, given in the Document
+          for public access to a Transparent copy of the Document, and
+          likewise the network locations given in the Document for
+          previous versions it was based on.  These may be placed in the
+          "History" section.  You may omit a network location for a work
+          that was published at least four years before the Document
+          itself, or if the original publisher of the version it refers
+          to gives permission.
+
+       K. For any section Entitled "Acknowledgements" or "Dedications",
+          Preserve the Title of the section, and preserve in the section
+          all the substance and tone of each of the contributor
+          acknowledgements and/or dedications given therein.
+
+       L. Preserve all the Invariant Sections of the Document, unaltered
+          in their text and in their titles.  Section numbers or the
+          equivalent are not considered part of the section titles.
+
+       M. Delete any section Entitled "Endorsements".  Such a section
+          may not be included in the Modified Version.
+
+       N. Do not retitle any existing section to be Entitled
+          "Endorsements" or to conflict in title with any Invariant
+          Section.
+
+       O. Preserve any Warranty Disclaimers.
+
+     If the Modified Version includes new front-matter sections or
+     appendices that qualify as Secondary Sections and contain no
+     material copied from the Document, you may at your option designate
+     some or all of these sections as invariant.  To do this, add their
+     titles to the list of Invariant Sections in the Modified Version's
+     license notice.  These titles must be distinct from any other
+     section titles.
+
+     You may add a section Entitled "Endorsements", provided it contains
+     nothing but endorsements of your Modified Version by various
+     parties--for example, statements of peer review or that the text
+     has been approved by an organization as the authoritative
+     definition of a standard.
+
+     You may add a passage of up to five words as a Front-Cover Text,
+     and a passage of up to 25 words as a Back-Cover Text, to the end of
+     the list of Cover Texts in the Modified Version.  Only one passage
+     of Front-Cover Text and one of Back-Cover Text may be added by (or
+     through arrangements made by) any one entity.  If the Document
+     already includes a cover text for the same cover, previously added
+     by you or by arrangement made by the same entity you are acting on
+     behalf of, you may not add another; but you may replace the old
+     one, on explicit permission from the previous publisher that added
+     the old one.
+
+     The author(s) and publisher(s) of the Document do not by this
+     License give permission to use their names for publicity for or to
+     assert or imply endorsement of any Modified Version.
+
+  5. COMBINING DOCUMENTS
+
+     You may combine the Document with other documents released under
+     this License, under the terms defined in section 4 above for
+     modified versions, provided that you include in the combination all
+     of the Invariant Sections of all of the original documents,
+     unmodified, and list them all as Invariant Sections of your
+     combined work in its license notice, and that you preserve all
+     their Warranty Disclaimers.
+
+     The combined work need only contain one copy of this License, and
+     multiple identical Invariant Sections may be replaced with a single
+     copy.  If there are multiple Invariant Sections with the same name
+     but different contents, make the title of each such section unique
+     by adding at the end of it, in parentheses, the name of the
+     original author or publisher of that section if known, or else a
+     unique number.  Make the same adjustment to the section titles in
+     the list of Invariant Sections in the license notice of the
+     combined work.
+
+     In the combination, you must combine any sections Entitled
+     "History" in the various original documents, forming one section
+     Entitled "History"; likewise combine any sections Entitled
+     "Acknowledgements", and any sections Entitled "Dedications".  You
+     must delete all sections Entitled "Endorsements."
+
+  6. COLLECTIONS OF DOCUMENTS
+
+     You may make a collection consisting of the Document and other
+     documents released under this License, and replace the individual
+     copies of this License in the various documents with a single copy
+     that is included in the collection, provided that you follow the
+     rules of this License for verbatim copying of each of the documents
+     in all other respects.
+
+     You may extract a single document from such a collection, and
+     distribute it individually under this License, provided you insert
+     a copy of this License into the extracted document, and follow this
+     License in all other respects regarding verbatim copying of that
+     document.
+
+  7. AGGREGATION WITH INDEPENDENT WORKS
+
+     A compilation of the Document or its derivatives with other
+     separate and independent documents or works, in or on a volume of a
+     storage or distribution medium, is called an "aggregate" if the
+     copyright resulting from the compilation is not used to limit the
+     legal rights of the compilation's users beyond what the individual
+     works permit.  When the Document is included in an aggregate, this
+     License does not apply to the other works in the aggregate which
+     are not themselves derivative works of the Document.
+
+     If the Cover Text requirement of section 3 is applicable to these
+     copies of the Document, then if the Document is less than one half
+     of the entire aggregate, the Document's Cover Texts may be placed
+     on covers that bracket the Document within the aggregate, or the
+     electronic equivalent of covers if the Document is in electronic
+     form.  Otherwise they must appear on printed covers that bracket
+     the whole aggregate.
+
+  8. TRANSLATION
+
+     Translation is considered a kind of modification, so you may
+     distribute translations of the Document under the terms of section
+     4.  Replacing Invariant Sections with translations requires special
+     permission from their copyright holders, but you may include
+     translations of some or all Invariant Sections in addition to the
+     original versions of these Invariant Sections.  You may include a
+     translation of this License, and all the license notices in the
+     Document, and any Warranty Disclaimers, provided that you also
+     include the original English version of this License and the
+     original versions of those notices and disclaimers.  In case of a
+     disagreement between the translation and the original version of
+     this License or a notice or disclaimer, the original version will
+     prevail.
+
+     If a section in the Document is Entitled "Acknowledgements",
+     "Dedications", or "History", the requirement (section 4) to
+     Preserve its Title (section 1) will typically require changing the
+     actual title.
+
+  9. TERMINATION
+
+     You may not copy, modify, sublicense, or distribute the Document
+     except as expressly provided under this License.  Any attempt
+     otherwise to copy, modify, sublicense, or distribute it is void,
+     and will automatically terminate your rights under this License.
+
+     However, if you cease all violation of this License, then your
+     license from a particular copyright holder is reinstated (a)
+     provisionally, unless and until the copyright holder explicitly and
+     finally terminates your license, and (b) permanently, if the
+     copyright holder fails to notify you of the violation by some
+     reasonable means prior to 60 days after the cessation.
+
+     Moreover, your license from a particular copyright holder is
+     reinstated permanently if the copyright holder notifies you of the
+     violation by some reasonable means, this is the first time you have
+     received notice of violation of this License (for any work) from
+     that copyright holder, and you cure the violation prior to 30 days
+     after your receipt of the notice.
+
+     Termination of your rights under this section does not terminate
+     the licenses of parties who have received copies or rights from you
+     under this License.  If your rights have been terminated and not
+     permanently reinstated, receipt of a copy of some or all of the
+     same material does not give you any rights to use it.
+
+  10. FUTURE REVISIONS OF THIS LICENSE
+
+     The Free Software Foundation may publish new, revised versions of
+     the GNU Free Documentation License from time to time.  Such new
+     versions will be similar in spirit to the present version, but may
+     differ in detail to address new problems or concerns.  See
+     <http://www.gnu.org/copyleft/>.
+
+     Each version of the License is given a distinguishing version
+     number.  If the Document specifies that a particular numbered
+     version of this License "or any later version" applies to it, you
+     have the option of following the terms and conditions either of
+     that specified version or of any later version that has been
+     published (not as a draft) by the Free Software Foundation.  If the
+     Document does not specify a version number of this License, you may
+     choose any version ever published (not as a draft) by the Free
+     Software Foundation.  If the Document specifies that a proxy can
+     decide which future versions of this License can be used, that
+     proxy's public statement of acceptance of a version permanently
+     authorizes you to choose that version for the Document.
+
+  11. RELICENSING
+
+     "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
+     World Wide Web server that publishes copyrightable works and also
+     provides prominent facilities for anybody to edit those works.  A
+     public wiki that anybody can edit is an example of such a server.
+     A "Massive Multiauthor Collaboration" (or "MMC") contained in the
+     site means any set of copyrightable works thus published on the MMC
+     site.
+
+     "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
+     license published by Creative Commons Corporation, a not-for-profit
+     corporation with a principal place of business in San Francisco,
+     California, as well as future copyleft versions of that license
+     published by that same organization.
+
+     "Incorporate" means to publish or republish a Document, in whole or
+     in part, as part of another Document.
+
+     An MMC is "eligible for relicensing" if it is licensed under this
+     License, and if all works that were first published under this
+     License somewhere other than this MMC, and subsequently
+     incorporated in whole or in part into the MMC, (1) had no cover
+     texts or invariant sections, and (2) were thus incorporated prior
+     to November 1, 2008.
+
+     The operator of an MMC Site may republish an MMC contained in the
+     site under CC-BY-SA on the same site at any time before August 1,
+     2009, provided the MMC is eligible for relicensing.
+
+ADDENDUM: How to use this License for your documents
+====================================================
+
+To use this License in a document you have written, include a copy of
+the License in the document and put the following copyright and license
+notices just after the title page:
+
+       Copyright (C)  YEAR  YOUR NAME.
+       Permission is granted to copy, distribute and/or modify this document
+       under the terms of the GNU Free Documentation License, Version 1.3
+       or any later version published by the Free Software Foundation;
+       with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
+       Texts.  A copy of the license is included in the section entitled ``GNU
+       Free Documentation License''.
+
+   If you have Invariant Sections, Front-Cover Texts and Back-Cover
+Texts, replace the "with...Texts." line with this:
+
+         with the Invariant Sections being LIST THEIR TITLES, with
+         the Front-Cover Texts being LIST, and with the Back-Cover Texts
+         being LIST.
+
+   If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+
+   If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of free
+software license, such as the GNU General Public License, to permit
+their use in free software.
+
+Appendix B Request Index
+************************
+
+Request names appear without a leading control character; the defaults
+are '.' for the regular control character and ''' for the no-break
+control character.
+
+* Menu:
+
+* ab:                                    Debugging.         (line 12127)
+* ad:                                    Manipulating Filling and Adjustment.
+                                                            (line  5701)
+* af:                                    Assigning Register Formats.
+                                                            (line  5419)
+* aln:                                   Setting Registers. (line  5323)
+* als:                                   Strings.           (line  8972)
+* am:                                    Writing Macros.    (line  9530)
+* am1:                                   Writing Macros.    (line  9531)
+* ami:                                   Writing Macros.    (line  9532)
+* ami1:                                  Writing Macros.    (line  9533)
+* as:                                    Strings.           (line  8888)
+* as1:                                   Strings.           (line  8889)
+* asciify:                               Diversions.        (line 11120)
+* backtrace:                             Debugging.         (line 12176)
+* bd:                                    Artificial Fonts.  (line  8211)
+* blm:                                   Blank Line Traps.  (line 10779)
+* box:                                   Diversions.        (line 10975)
+* boxa:                                  Diversions.        (line 10976)
+* bp:                                    Page Control.      (line  7175)
+* br:                                    Manipulating Filling and Adjustment.
+                                                            (line  5657)
+* break:                                 while.             (line  9393)
+* brp:                                   Manipulating Filling and Adjustment.
+                                                            (line  5774)
+* c2:                                    Control Characters.
+                                                            (line  4749)
+* cc:                                    Control Characters.
+                                                            (line  4743)
+* ce:                                    Manipulating Filling and Adjustment.
+                                                            (line  5826)
+* cf:                                    I/O.               (line 11521)
+* cflags:                                Using Symbols.     (line  7846)
+* ch:                                    Page Location Traps.
+                                                            (line 10528)
+* char:                                  Using Symbols.     (line  7945)
+* chop:                                  Strings.           (line  8919)
+* class:                                 Character Classes. (line  8034)
+* close:                                 I/O.               (line 11703)
+* color:                                 Colors.            (line  8687)
+* composite:                             Using Symbols.     (line  7802)
+* continue:                              while.             (line  9397)
+* cp:                                    Compatibility Mode.
+                                                            (line 12414)
+* cs:                                    Artificial Fonts.  (line  8241)
+* cu:                                    Artificial Fonts.  (line  8202)
+* da:                                    Diversions.        (line 10944)
+* de:                                    Writing Macros.    (line  9418)
+* de1:                                   Writing Macros.    (line  9490)
+* defcolor:                              Colors.            (line  8699)
+* dei:                                   Writing Macros.    (line  9512)
+* dei1:                                  Writing Macros.    (line  9513)
+* device:                                Postprocessor Access.
+                                                            (line 11738)
+* devicem:                               Postprocessor Access.
+                                                            (line 11768)
+* di:                                    Diversions.        (line 10943)
+* do:                                    Compatibility Mode.
+                                                            (line 12425)
+* ds:                                    ms Document Control Settings.
+                                                            (line  1803)
+* ds <1>:                                Strings.           (line  8798)
+* ds1:                                   Strings.           (line  8799)
+* dt:                                    Diversion Traps.   (line 10668)
+* ec:                                    Using Escape Sequences.
+                                                            (line  5012)
+* ecr:                                   Using Escape Sequences.
+                                                            (line  5038)
+* ecs:                                   Using Escape Sequences.
+                                                            (line  5037)
+* el:                                    if-else.           (line  9213)
+* em:                                    End-of-input Traps.
+                                                            (line 10807)
+* eo:                                    Using Escape Sequences.
+                                                            (line  5007)
+* ev:                                    Environments.      (line 11308)
+* evc:                                   Environments.      (line 11362)
+* ex:                                    Debugging.         (line 12132)
+* fam:                                   Font Families.     (line  7463)
+* fc:                                    Fields.            (line  6704)
+* fchar:                                 Using Symbols.     (line  7946)
+* fcolor:                                Colors.            (line  8757)
+* fi:                                    Manipulating Filling and Adjustment.
+                                                            (line  5684)
+* fl:                                    Debugging.         (line 12167)
+* fp:                                    Font Positions.    (line  7550)
+* fschar:                                Using Symbols.     (line  7947)
+* fspecial:                              Special Fonts.     (line  8104)
+* ft:                                    Selecting Fonts.   (line  7348)
+* ftr:                                   Selecting Fonts.   (line  7406)
+* fzoom:                                 Selecting Fonts.   (line  7420)
+* gcolor:                                Colors.            (line  8729)
+* hc:                                    Manipulating Hyphenation.
+                                                            (line  6023)
+* hcode:                                 Manipulating Hyphenation.
+                                                            (line  6228)
+* hla:                                   Manipulating Hyphenation.
+                                                            (line  6262)
+* hlm:                                   Manipulating Hyphenation.
+                                                            (line  6275)
+* hpf:                                   Manipulating Hyphenation.
+                                                            (line  6168)
+* hpfa:                                  Manipulating Hyphenation.
+                                                            (line  6169)
+* hpfcode:                               Manipulating Hyphenation.
+                                                            (line  6170)
+* hw:                                    Manipulating Hyphenation.
+                                                            (line  5957)
+* hy:                                    Manipulating Hyphenation.
+                                                            (line  6055)
+* hym:                                   Manipulating Hyphenation.
+                                                            (line  6289)
+* hys:                                   Manipulating Hyphenation.
+                                                            (line  6304)
+* ie:                                    if-else.           (line  9212)
+* if:                                    if-then.           (line  9171)
+* ig:                                    Comments.          (line  5180)
+* in:                                    Line Layout.       (line  6935)
+* it:                                    Input Line Traps.  (line 10679)
+* itc:                                   Input Line Traps.  (line 10680)
+* kern:                                  Ligatures and Kerning.
+                                                            (line  8288)
+* lc:                                    Leaders.           (line  6661)
+* length:                                Strings.           (line  8909)
+* lf:                                    Debugging.         (line 12103)
+* lg:                                    Ligatures and Kerning.
+                                                            (line  8270)
+* linetabs:                              Tabs and Fields.   (line  6614)
+* ll:                                    Line Layout.       (line  6987)
+* ls:                                    Manipulating Spacing.
+                                                            (line  6395)
+* lsm:                                   Leading Space Traps.
+                                                            (line 10789)
+* lt:                                    Page Layout.       (line  7134)
+* mc:                                    Miscellaneous.     (line 11897)
+* mk:                                    Page Motions.      (line  9867)
+* mso:                                   I/O.               (line 11512)
+* msoquiet:                              I/O.               (line 11513)
+* na:                                    Manipulating Filling and Adjustment.
+                                                            (line  5768)
+* ne:                                    Page Control.      (line  7195)
+* nf:                                    Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* nh:                                    Manipulating Hyphenation.
+                                                            (line  6163)
+* nm:                                    Miscellaneous.     (line 11796)
+* nn:                                    Miscellaneous.     (line 11861)
+* nop:                                   if-then.           (line  9190)
+* nr:                                    ms Document Control Settings.
+                                                            (line  1799)
+* nr <1>:                                Setting Registers. (line  5223)
+* nr <2>:                                Setting Registers. (line  5277)
+* nr <3>:                                Auto-increment.    (line  5372)
+* nroff:                                 troff and nroff Modes.
+                                                            (line  6840)
+* ns:                                    Manipulating Spacing.
+                                                            (line  6454)
+* nx:                                    I/O.               (line 11553)
+* open:                                  I/O.               (line 11670)
+* opena:                                 I/O.               (line 11671)
+* os:                                    Page Control.      (line  7230)
+* output:                                Diversions.        (line 11107)
+* pc:                                    Page Layout.       (line  7149)
+* pev:                                   Debugging.         (line 12150)
+* pi:                                    I/O.               (line 11612)
+* pl:                                    Page Layout.       (line  7090)
+* pm:                                    Debugging.         (line 12154)
+* pn:                                    Page Layout.       (line  7104)
+* pnr:                                   Debugging.         (line 12158)
+* po:                                    Line Layout.       (line  6909)
+* ps:                                    Changing the Type Size.
+                                                            (line  8462)
+* psbb:                                  Miscellaneous.     (line 11945)
+* pso:                                   I/O.               (line 11501)
+* ptr:                                   Debugging.         (line 12162)
+* pvs:                                   Changing the Vertical Spacing.
+                                                            (line  8581)
+* rchar:                                 Using Symbols.     (line  8004)
+* rd:                                    I/O.               (line 11558)
+* return:                                Writing Macros.    (line  9567)
+* rfschar:                               Using Symbols.     (line  8005)
+* rj:                                    Manipulating Filling and Adjustment.
+                                                            (line  5865)
+* rm:                                    Strings.           (line  8967)
+* rn:                                    Strings.           (line  8964)
+* rnn:                                   Setting Registers. (line  5318)
+* rr:                                    Setting Registers. (line  5312)
+* rs:                                    Manipulating Spacing.
+                                                            (line  6455)
+* rt:                                    Page Motions.      (line  9868)
+* schar:                                 Using Symbols.     (line  7948)
+* shc:                                   Manipulating Hyphenation.
+                                                            (line  6032)
+* shift:                                 Parameters.        (line  9610)
+* sizes:                                 Changing the Type Size.
+                                                            (line  8526)
+* so:                                    I/O.               (line 11472)
+* soquiet:                               I/O.               (line 11473)
+* sp:                                    Manipulating Spacing.
+                                                            (line  6348)
+* special:                               Special Fonts.     (line  8103)
+* spreadwarn:                            Debugging.         (line 12207)
+* ss:                                    Manipulating Filling and Adjustment.
+                                                            (line  5885)
+* stringdown:                            Strings.           (line  8944)
+* stringup:                              Strings.           (line  8945)
+* sty:                                   Font Families.     (line  7504)
+* substring:                             Strings.           (line  8927)
+* sv:                                    Page Control.      (line  7229)
+* sy:                                    I/O.               (line 11634)
+* ta:                                    Tabs and Fields.   (line  6488)
+* tag:                                   Postprocessor Access.
+                                                            (line 11781)
+* taga:                                  Postprocessor Access.
+                                                            (line 11782)
+* tc:                                    Tabs and Fields.   (line  6602)
+* ti:                                    Line Layout.       (line  6959)
+* tkf:                                   Ligatures and Kerning.
+                                                            (line  8307)
+* tl:                                    Page Layout.       (line  7120)
+* tm:                                    Debugging.         (line 12115)
+* tm1:                                   Debugging.         (line 12116)
+* tmc:                                   Debugging.         (line 12117)
+* tr:                                    Character Translations.
+                                                            (line  6729)
+* trf:                                   I/O.               (line 11520)
+* trin:                                  Character Translations.
+                                                            (line  6730)
+* trnt:                                  Character Translations.
+                                                            (line  6795)
+* troff:                                 troff and nroff Modes.
+                                                            (line  6832)
+* uf:                                    Artificial Fonts.  (line  8206)
+* ul:                                    Artificial Fonts.  (line  8180)
+* unformat:                              Diversions.        (line 11145)
+* vpt:                                   Vertical Position Traps.
+                                                            (line 10406)
+* vs:                                    Changing the Vertical Spacing.
+                                                            (line  8540)
+* warn:                                  Debugging.         (line 12226)
+* warnscale:                             Debugging.         (line 12203)
+* wh:                                    Page Location Traps.
+                                                            (line 10425)
+* while:                                 while.             (line  9331)
+* write:                                 I/O.               (line 11682)
+* writec:                                I/O.               (line 11683)
+* writem:                                I/O.               (line 11694)
+
+Appendix C Escape Sequence Index
+********************************
+
+The escape character, '\' by default, is always followed by at least one
+more input character, making an escape _sequence_.  Any input token '\X'
+with X not in the list below emits a warning and interpolates glyph X.
+Note the entries for '\.', which may be obscured by the leader dots, and
+for '\<RET>' and '\<SP>', which are sorted alphabetically, not by code
+point order.
+
+* Menu:
+
+* \:                                     Using Escape Sequences.
+                                                            (line  4944)
+* \ <1>:                                 Using Symbols.     (line  7731)
+* \!:                                    Diversions.        (line 11065)
+* \":                                    Comments.          (line  5136)
+* \#:                                    Comments.          (line  5170)
+* \$:                                    Parameters.        (line  9602)
+* \$*:                                   Parameters.        (line  9622)
+* \$0:                                   Parameters.        (line  9657)
+* \$@:                                   Parameters.        (line  9623)
+* \$^:                                   Parameters.        (line  9624)
+* \%:                                    Manipulating Hyphenation.
+                                                            (line  5991)
+* \&:                                    Dummy Characters.  (line  8357)
+* \':                                    Using Symbols.     (line  7831)
+* $:                                    Using Symbols.     (line  7733)
+* $:                                    Dummy Characters.  (line  8407)
+* \*:                                    Strings.           (line  8800)
+* \,:                                    Italic Corrections.
+                                                            (line  8338)
+* \-:                                    Using Symbols.     (line  7838)
+* \.:                                    Copy Mode.         (line  9739)
+* \/:                                    Italic Corrections.
+                                                            (line  8328)
+* \0:                                    Page Motions.      (line 10014)
+* \::                                    Manipulating Hyphenation.
+                                                            (line  5992)
+* \?:                                    Diversions.        (line 11066)
+* \A:                                    Identifiers.       (line  4628)
+* \a:                                    Leaders.           (line  6658)
+* \B:                                    Numeric Expressions.
+                                                            (line  4522)
+* \b:                                    Drawing Geometric Objects.
+                                                            (line 10308)
+* \c:                                    Line Continuation. (line  7047)
+* \C:                                    Using Symbols.     (line  7793)
+* \d:                                    Page Motions.      (line  9965)
+* \D:                                    Drawing Geometric Objects.
+                                                            (line 10216)
+* \e:                                    Using Escape Sequences.
+                                                            (line  5000)
+* \E:                                    Copy Mode.         (line  9794)
+* \f:                                    Selecting Fonts.   (line  7349)
+* \F:                                    Font Families.     (line  7465)
+* \g:                                    Assigning Register Formats.
+                                                            (line  5477)
+* \H:                                    Artificial Fonts.  (line  8129)
+* \h:                                    Page Motions.      (line  9982)
+* \k:                                    Page Motions.      (line 10082)
+* \l:                                    Drawing Geometric Objects.
+                                                            (line 10141)
+* \L:                                    Drawing Geometric Objects.
+                                                            (line 10167)
+* \m:                                    Colors.            (line  8730)
+* \M:                                    Colors.            (line  8758)
+* \n:                                    Interpolating Registers.
+                                                            (line  5338)
+* \n <1>:                                Auto-increment.    (line  5381)
+* \N:                                    Using Symbols.     (line  7810)
+* \newline:                              Line Continuation. (line  7019)
+* \o:                                    Page Motions.      (line 10097)
+* \O:                                    Suppressing Output.
+                                                            (line 11410)
+* \p:                                    Manipulating Filling and Adjustment.
+                                                            (line  5775)
+* \R:                                    Setting Registers. (line  5224)
+* \R <1>:                                Setting Registers. (line  5279)
+* \r:                                    Page Motions.      (line  9963)
+* \<RET>:                                Line Continuation. (line  7019)
+* \S:                                    Artificial Fonts.  (line  8160)
+* \s:                                    Changing the Type Size.
+                                                            (line  8465)
+* \<SP>:                                 Page Motions.      (line  9998)
+* \space:                                Page Motions.      (line  9998)
+* \t:                                    Tabs and Fields.   (line  6485)
+* \u:                                    Page Motions.      (line  9964)
+* \v:                                    Page Motions.      (line  9938)
+* \V:                                    I/O.               (line 11719)
+* \w:                                    Page Motions.      (line 10020)
+* \x:                                    Manipulating Spacing.
+                                                            (line  6407)
+* \X:                                    Postprocessor Access.
+                                                            (line 11739)
+* \Y:                                    Postprocessor Access.
+                                                            (line 11769)
+* \z:                                    Page Motions.      (line 10102)
+* \Z:                                    Page Motions.      (line 10107)
+* \:                                    Using Symbols.     (line  7733)
+* \\:                                    Copy Mode.         (line  9714)
+* \^:                                    Page Motions.      (line 10009)
+* \_:                                    Using Symbols.     (line  7841)
+* \`:                                    Using Symbols.     (line  7835)
+* \{:                                    Conditional Blocks.
+                                                            (line  9249)
+* \{ <1>:                                Conditional Blocks.
+                                                            (line  9250)
+* \|:                                    Page Motions.      (line 10004)
+* \}:                                    Conditional Blocks.
+                                                            (line  9250)
+* \~:                                    Manipulating Filling and Adjustment.
+                                                            (line  5671)
+
+Appendix D Operator Index
+*************************
+
+* Menu:
+
+* !:                                     Numeric Expressions.
+                                                             (line 4426)
+* %:                                     Numeric Expressions.
+                                                             (line 4359)
+* &:                                     Numeric Expressions.
+                                                             (line 4422)
+* (:                                     Numeric Expressions.
+                                                             (line 4446)
+* ):                                     Numeric Expressions.
+                                                             (line 4446)
+* *:                                     Numeric Expressions.
+                                                             (line 4359)
+* +:                                     Numeric Expressions.
+                                                             (line 4359)
+* + <1>:                                 Numeric Expressions.
+                                                             (line 4365)
+* + (unary):                             Numeric Expressions.
+                                                             (line 4457)
+* -:                                     Numeric Expressions.
+                                                             (line 4359)
+* - <1>:                                 Numeric Expressions.
+                                                             (line 4365)
+* - (unary):                             Numeric Expressions.
+                                                             (line 4457)
+* /:                                     Numeric Expressions.
+                                                             (line 4359)
+* ;:                                     Numeric Expressions.
+                                                             (line 4390)
+* <:                                     Numeric Expressions.
+                                                             (line 4416)
+* <=:                                    Numeric Expressions.
+                                                             (line 4416)
+* <?:                                    Numeric Expressions.
+                                                             (line 4407)
+* <colon>:                               Numeric Expressions.
+                                                             (line 4422)
+* =:                                     Numeric Expressions.
+                                                             (line 4416)
+* ==:                                    Numeric Expressions.
+                                                             (line 4416)
+* >:                                     Numeric Expressions.
+                                                             (line 4416)
+* >=:                                    Numeric Expressions.
+                                                             (line 4416)
+* >?:                                    Numeric Expressions.
+                                                             (line 4407)
+* |:                                     Numeric Expressions.
+                                                             (line 4471)
+
+Appendix E Register Index
+*************************
+
+The macro package or program a specific register belongs to is appended
+in brackets.
+
+   A register name 'x' consisting of exactly one character can be
+accessed as '\nx'.  A register name 'xx' consisting of exactly two
+characters can be accessed as '\n(xx'.  Register names 'xxx' of any
+length can be accessed as '\nxxx'.
+
+* Menu:
+
+* $$:                                    Built-in Registers.
+                                                            (line  5571)
+* %:                                     Page Layout.       (line  7149)
+* % <1>:                                 Page Control.      (line  7178)
+* .$:                                    Parameters.        (line  9594)
+* .A:                                    Built-in Registers.
+                                                            (line  5527)
+* .a:                                    Manipulating Spacing.
+                                                            (line  6408)
+* .b:                                    Artificial Fonts.  (line  8213)
+* .br:                                   Control Characters.
+                                                            (line  4759)
+* .c:                                    Built-in Registers.
+                                                            (line  5531)
+* .C:                                    Compatibility Mode.
+                                                            (line 12415)
+* .cdp:                                  Environments.      (line 11387)
+* .ce:                                   Manipulating Filling and Adjustment.
+                                                            (line  5827)
+* .cht:                                  Environments.      (line 11386)
+* .color:                                Colors.            (line  8688)
+* .cp:                                   Compatibility Mode.
+                                                            (line 12426)
+* .csk:                                  Environments.      (line 11388)
+* .d:                                    Diversions.        (line 11000)
+* .ev:                                   Environments.      (line 11309)
+* .F:                                    Built-in Registers.
+                                                            (line  5536)
+* .f:                                    Font Positions.    (line  7551)
+* .fam:                                  Font Families.     (line  7464)
+* .fn:                                   Selecting Fonts.   (line  7352)
+* .fp:                                   Font Positions.    (line  7552)
+* .g:                                    Built-in Registers.
+                                                            (line  5539)
+* .H:                                    Motion Quanta.     (line  4300)
+* .h:                                    Diversions.        (line 11007)
+* .height:                               Artificial Fonts.  (line  8132)
+* .hla:                                  Manipulating Hyphenation.
+                                                            (line  6263)
+* .hlc:                                  Manipulating Hyphenation.
+                                                            (line  6277)
+* .hlm:                                  Manipulating Hyphenation.
+                                                            (line  6276)
+* .hy:                                   Manipulating Hyphenation.
+                                                            (line  6056)
+* .hym:                                  Manipulating Hyphenation.
+                                                            (line  6290)
+* .hys:                                  Manipulating Hyphenation.
+                                                            (line  6305)
+* .i:                                    Line Layout.       (line  6938)
+* .in:                                   Line Layout.       (line  6962)
+* .int:                                  Line Continuation. (line  7048)
+* .j:                                    Manipulating Filling and Adjustment.
+                                                            (line  5702)
+* .k:                                    Page Motions.      (line 10093)
+* .kern:                                 Ligatures and Kerning.
+                                                            (line  8289)
+* .L:                                    Manipulating Spacing.
+                                                            (line  6396)
+* .l:                                    Line Layout.       (line  6990)
+* .lg:                                   Ligatures and Kerning.
+                                                            (line  8271)
+* .linetabs:                             Tabs and Fields.   (line  6615)
+* .ll:                                   Line Layout.       (line  6991)
+* .lt:                                   Page Layout.       (line  7137)
+* .m:                                    Colors.            (line  8733)
+* .M:                                    Colors.            (line  8761)
+* .n:                                    Environments.      (line 11403)
+* .ne:                                   Page Location Traps.
+                                                            (line 10579)
+* .nm:                                   Miscellaneous.     (line 11798)
+* .nn:                                   Miscellaneous.     (line 11862)
+* .ns:                                   Manipulating Spacing.
+                                                            (line  6456)
+* .o:                                    Line Layout.       (line  6912)
+* .O:                                    Suppressing Output.
+                                                            (line 11463)
+* .P:                                    Built-in Registers.
+                                                            (line  5543)
+* .p:                                    Page Layout.       (line  7093)
+* .pe:                                   Page Location Traps.
+                                                            (line 10598)
+* .pn:                                   Page Layout.       (line  7107)
+* .ps:                                   Using Fractional Type Sizes.
+                                                            (line  8622)
+* .psr:                                  Using Fractional Type Sizes.
+                                                            (line  8637)
+* .pvs:                                  Changing the Vertical Spacing.
+                                                            (line  8584)
+* .R:                                    Built-in Registers.
+                                                            (line  5547)
+* .rj:                                   Manipulating Filling and Adjustment.
+                                                            (line  5866)
+* .s:                                    Changing the Type Size.
+                                                            (line  8466)
+* .slant:                                Artificial Fonts.  (line  8161)
+* .sr:                                   Using Fractional Type Sizes.
+                                                            (line  8638)
+* .ss:                                   Manipulating Filling and Adjustment.
+                                                            (line  5886)
+* .sss:                                  Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* .sty:                                  Font Families.     (line  7505)
+* .T:                                    Built-in Registers.
+                                                            (line  5551)
+* .t:                                    Page Location Traps.
+                                                            (line 10520)
+* .tabs:                                 Tabs and Fields.   (line  6489)
+* .trunc:                                Page Location Traps.
+                                                            (line 10587)
+* .U:                                    Built-in Registers.
+                                                            (line  5555)
+* .u:                                    Manipulating Filling and Adjustment.
+                                                            (line  5685)
+* .V:                                    Motion Quanta.     (line  4301)
+* .v:                                    Changing the Vertical Spacing.
+                                                            (line  8543)
+* .vpt:                                  Vertical Position Traps.
+                                                            (line 10407)
+* .w:                                    Environments.      (line 11385)
+* .warn:                                 Debugging.         (line 12227)
+* .x:                                    Built-in Registers.
+                                                            (line  5559)
+* .y:                                    Built-in Registers.
+                                                            (line  5563)
+* .Y:                                    Built-in Registers.
+                                                            (line  5567)
+* .z:                                    Diversions.        (line 10999)
+* .zoom:                                 Selecting Fonts.   (line  7421)
+* c.:                                    Built-in Registers.
+                                                            (line  5532)
+* ct:                                    Page Motions.      (line 10025)
+* DD ms:                               ms Document Control Settings.
+                                                            (line  2089)
+* DI ms:                               ms Document Control Settings.
+                                                            (line  2098)
+* dl:                                    Diversions.        (line 11026)
+* dn:                                    Diversions.        (line 11025)
+* dw:                                    Built-in Registers.
+                                                            (line  5589)
+* dy:                                    Built-in Registers.
+                                                            (line  5592)
+* FF ms:                               ms Document Control Settings.
+                                                            (line  2029)
+* FI ms:                               ms Document Control Settings.
+                                                            (line  2022)
+* FM ms:                               ms Document Control Settings.
+                                                            (line  1848)
+* FPD ms:                              ms Document Control Settings.
+                                                            (line  2070)
+* FPS ms:                              ms Document Control Settings.
+                                                            (line  2056)
+* FVS ms:                              ms Document Control Settings.
+                                                            (line  2063)
+* GROWPS ms:                           ms Document Control Settings.
+                                                            (line  1987)
+* GS ms:                               Differences from AT&T ms.
+                                                            (line  3360)
+* HM ms:                               ms Document Control Settings.
+                                                            (line  1841)
+* HORPHANS ms:                         ms Document Control Settings.
+                                                            (line  1998)
+* hours:                                 Built-in Registers.
+                                                            (line  5586)
+* hp:                                    Page Motions.      (line 10090)
+* HY ms:                               ms Document Control Settings.
+                                                            (line  1917)
+* LL ms:                               ms Document Control Settings.
+                                                            (line  1822)
+* llx:                                   Miscellaneous.     (line 11946)
+* lly:                                   Miscellaneous.     (line 11947)
+* ln:                                    Miscellaneous.     (line 11797)
+* lsn:                                   Leading Space Traps.
+                                                            (line 10790)
+* lss:                                   Leading Space Traps.
+                                                            (line 10791)
+* LT ms:                               ms Document Control Settings.
+                                                            (line  1831)
+* MINGW ms:                            ms Document Control Settings.
+                                                            (line  2111)
+* minutes:                               Built-in Registers.
+                                                            (line  5583)
+* mo:                                    Built-in Registers.
+                                                            (line  5595)
+* nl:                                    Page Control.      (line  7240)
+* opmaxx:                                Suppressing Output.
+                                                            (line 11426)
+* opmaxy:                                Suppressing Output.
+                                                            (line 11426)
+* opminx:                                Suppressing Output.
+                                                            (line 11426)
+* opminy:                                Suppressing Output.
+                                                            (line 11426)
+* PD ms:                               ms Document Control Settings.
+                                                            (line  1946)
+* PI ms:                               ms Document Control Settings.
+                                                            (line  1938)
+* PO ms:                               ms Document Control Settings.
+                                                            (line  1813)
+* PORPHANS ms:                         ms Document Control Settings.
+                                                            (line  1961)
+* PS ms:                               ms Document Control Settings.
+                                                            (line  1903)
+* PSINCR ms:                           ms Document Control Settings.
+                                                            (line  1976)
+* QI ms:                               ms Document Control Settings.
+                                                            (line  1953)
+* rsb:                                   Page Motions.      (line 10024)
+* rst:                                   Page Motions.      (line 10023)
+* sb:                                    Page Motions.      (line 10022)
+* seconds:                               Built-in Registers.
+                                                            (line  5580)
+* skw:                                   Page Motions.      (line 10027)
+* slimit:                                Debugging.         (line 12197)
+* ssc:                                   Page Motions.      (line 10026)
+* st:                                    Page Motions.      (line 10021)
+* systat:                                I/O.               (line 11635)
+* TC-MARGIN ms:                        ms Document Control Settings.
+                                                            (line  2119)
+* urx:                                   Miscellaneous.     (line 11948)
+* ury:                                   Miscellaneous.     (line 11949)
+* VS ms:                               ms Document Control Settings.
+                                                            (line  1910)
+* year:                                  Built-in Registers.
+                                                            (line  5598)
+* yr:                                    Built-in Registers.
+                                                            (line  5601)
+
+Appendix F Macro Index
+**********************
+
+The macro package a specific macro belongs to is appended in brackets.
+They appear without the leading control character (normally '.').
+
+* Menu:
+
+* 1C ms:                               ms Multiple Columns.
+                                                             (line 3125)
+* 2C ms:                               ms Multiple Columns.
+                                                             (line 3128)
+*  ms:                                ms Insertions.      (line 2876)
+*  ms:                                ms Insertions.      (line 2877)
+* AB ms:                               ms Document Description Macros.
+                                                             (line 2187)
+* AE ms:                               ms Document Description Macros.
+                                                             (line 2194)
+* AI ms:                               ms Document Description Macros.
+                                                             (line 2170)
+* AM ms:                               ms Legacy Features. (line 3443)
+* AU ms:                               ms Document Description Macros.
+                                                             (line 2164)
+* B ms:                                Typeface and decoration.
+                                                             (line 2485)
+* B1 ms:                               ms keeps and displays.
+                                                             (line 2774)
+* B2 ms:                               ms keeps and displays.
+                                                             (line 2775)
+* BD ms:                               ms keeps and displays.
+                                                             (line 2815)
+* BI ms:                               Typeface and decoration.
+                                                             (line 2498)
+* BT man:                              Optional man extensions.
+                                                             (line 1442)
+* BX ms:                               Typeface and decoration.
+                                                             (line 2506)
+* CD ms:                               ms keeps and displays.
+                                                             (line 2821)
+* CT man:                              Optional man extensions.
+                                                             (line 1457)
+* CW man:                              Optional man extensions.
+                                                             (line 1460)
+* CW ms:                               Typeface and decoration.
+                                                             (line 2502)
+* DA ms:                               ms Document Description Macros.
+                                                             (line 2177)
+* De man:                              Optional man extensions.
+                                                             (line 1467)
+* DE ms:                               ms keeps and displays.
+                                                             (line 2830)
+* Ds man:                              Optional man extensions.
+                                                             (line 1464)
+* DS ms:                               ms keeps and displays.
+                                                             (line 2805)
+* DS ms <1>:                           ms keeps and displays.
+                                                             (line 2809)
+* DS ms <2>:                           ms keeps and displays.
+                                                             (line 2814)
+* DS ms <3>:                           ms keeps and displays.
+                                                             (line 2820)
+* DS ms <4>:                           ms keeps and displays.
+                                                             (line 2825)
+* EE man:                              Optional man extensions.
+                                                             (line 1474)
+* EF ms:                               ms Headers and Footers.
+                                                             (line 3069)
+* EH ms:                               ms Headers and Footers.
+                                                             (line 3067)
+* EN ms:                               ms Insertions.      (line 2869)
+* EQ ms:                               ms Insertions.      (line 2868)
+* EX man:                              Optional man extensions.
+                                                             (line 1470)
+* FE ms:                               ms Footnotes.       (line 2935)
+* FS ms:                               ms Footnotes.       (line 2934)
+* G man:                               Optional man extensions.
+                                                             (line 1477)
+* GL man:                              Optional man extensions.
+                                                             (line 1482)
+* HB man:                              Optional man extensions.
+                                                             (line 1487)
+* I ms:                                Typeface and decoration.
+                                                             (line 2495)
+* ID ms:                               ms keeps and displays.
+                                                             (line 2810)
+* IP ms:                               Paragraphs in ms.   (line 2294)
+* KE ms:                               ms keeps and displays.
+                                                             (line 2762)
+* KF ms:                               ms keeps and displays.
+                                                             (line 2761)
+* KS ms:                               ms keeps and displays.
+                                                             (line 2760)
+* LD ms:                               ms keeps and displays.
+                                                             (line 2806)
+* LG ms:                               Typeface and decoration.
+                                                             (line 2516)
+* LP ms:                               Paragraphs in ms.   (line 2287)
+* MC ms:                               ms Multiple Columns.
+                                                             (line 3131)
+* MS man:                              Optional man extensions.
+                                                             (line 1495)
+* ND ms:                               ms Document Description Macros.
+                                                             (line 2182)
+* NE man:                              Optional man extensions.
+                                                             (line 1507)
+* NH ms:                               Headings in ms.     (line 2361)
+* NL ms:                               Typeface and decoration.
+                                                             (line 2528)
+* NT man:                              Optional man extensions.
+                                                             (line 1500)
+* OF ms:                               ms Headers and Footers.
+                                                             (line 3068)
+* OH ms:                               ms Headers and Footers.
+                                                             (line 3066)
+* P1 ms:                               ms Headers and Footers.
+                                                             (line 3078)
+* PE ms:                               ms Insertions.      (line 2861)
+* PF ms:                               ms Insertions.      (line 2862)
+* PN man:                              Optional man extensions.
+                                                             (line 1510)
+* Pn man:                              Optional man extensions.
+                                                             (line 1514)
+* PP ms:                               Paragraphs in ms.   (line 2290)
+* PS ms:                               ms Insertions.      (line 2860)
+* PT man:                              Optional man extensions.
+                                                             (line 1437)
+* PX ms:                               ms TOC.             (line 3181)
+* QE ms:                               Paragraphs in ms.   (line 2307)
+* QP ms:                               Paragraphs in ms.   (line 2302)
+* QS ms:                               Paragraphs in ms.   (line 2306)
+* R man:                               Optional man extensions.
+                                                             (line 1520)
+* R ms:                                Typeface and decoration.
+                                                             (line 2491)
+* RD ms:                               ms keeps and displays.
+                                                             (line 2826)
+* RE ms:                               Indented regions in ms.
+                                                             (line 2710)
+* RN man:                              Optional man extensions.
+                                                             (line 1523)
+* RP ms:                               ms Document Description Macros.
+                                                             (line 2145)
+* RS ms:                               Indented regions in ms.
+                                                             (line 2706)
+* SH ms:                               Headings in ms.     (line 2431)
+* SM ms:                               Typeface and decoration.
+                                                             (line 2522)
+* TA ms:                               Tab Stops in ms.    (line 3103)
+* TB man:                              Optional man extensions.
+                                                             (line 1492)
+* TC ms:                               ms TOC.             (line 3186)
+* TE ms:                               ms Insertions.      (line 2852)
+* TL ms:                               ms Document Description Macros.
+                                                             (line 2159)
+* TS ms:                               ms Insertions.      (line 2851)
+* UL ms:                               Typeface and decoration.
+                                                             (line 2512)
+* VE man:                              Optional man extensions.
+                                                             (line 1530)
+* VS man:                              Optional man extensions.
+                                                             (line 1526)
+* XA ms:                               ms TOC.             (line 3170)
+* XE ms:                               ms TOC.             (line 3171)
+* XH ms:                               ms TOC.             (line 3222)
+* XH-REPLACEMENT ms:                   ms TOC.             (line 3231)
+* XH-UPDATE-TOC ms:                    ms TOC.             (line 3236)
+* XN ms:                               ms TOC.             (line 3221)
+* XN-INIT ms:                          ms TOC.             (line 3235)
+* XN-REPLACEMENT ms:                   ms TOC.             (line 3230)
+* XP ms:                               Paragraphs in ms.   (line 2313)
+* XS ms:                               ms TOC.             (line 3169)
+
+Appendix G String Index
+***********************
+
+The macro package or program a that defines or uses each string is
+appended in brackets.  (Only one string, '.T', is defined by the 'troff'
+formatter itself.)  *Note Strings::.
+
+* Menu:
+
+* ! ms:                                ms Legacy Features. (line 3482)
+* ' ms:                                ms Legacy Features. (line 3415)
+* ' ms <1>:                            ms Legacy Features. (line 3446)
+* * ms:                                ms Footnotes.       (line 2925)
+* , ms:                                ms Legacy Features. (line 3433)
+* , ms <1>:                            ms Legacy Features. (line 3461)
+* - ms:                                Typographical symbols in ms.
+                                                             (line 2266)
+* . ms:                                ms Legacy Features. (line 3473)
+* .T:                                    Strings.            (line 8787)
+* .T <1>:                                Strings.            (line 8787)
+* / ms:                                ms Legacy Features. (line 3464)
+* 3 ms:                                ms Legacy Features. (line 3491)
+* 8 ms:                                ms Legacy Features. (line 3485)
+* : ms:                                ms Legacy Features. (line 3421)
+* : ms <1>:                            ms Legacy Features. (line 3452)
+* < ms:                                Typeface and decoration.
+                                                             (line 2562)
+* > ms:                                Typeface and decoration.
+                                                             (line 2563)
+* ? ms:                                ms Legacy Features. (line 3479)
+* ^ ms:                                ms Legacy Features. (line 3424)
+* ^ ms <1>:                            ms Legacy Features. (line 3455)
+* _ ms:                                ms Legacy Features. (line 3470)
+* ` ms:                                ms Legacy Features. (line 3418)
+* ` ms <1>:                            ms Legacy Features. (line 3449)
+* { ms:                                Typeface and decoration.
+                                                             (line 2558)
+* } ms:                                Typeface and decoration.
+                                                             (line 2559)
+* ~ ms:                                ms Legacy Features. (line 3427)
+* ~ ms <1>:                            ms Legacy Features. (line 3458)
+* ABSTRACT ms:                         ms language and localization.
+                                                             (line 3019)
+* ae ms:                               ms Legacy Features. (line 3506)
+* Ae ms:                               ms Legacy Features. (line 3509)
+* C ms:                                ms Legacy Features. (line 3430)
+* CF ms:                               ms Document Control Settings.
+                                                             (line 1886)
+* CH ms:                               ms Document Control Settings.
+                                                             (line 1865)
+* d- ms:                               ms Legacy Features. (line 3494)
+* D- ms:                               ms Legacy Features. (line 3497)
+* FAM ms:                              ms Document Control Settings.
+                                                             (line 1926)
+* FR ms:                               ms Document Control Settings.
+                                                             (line 2077)
+* LF ms:                               ms Document Control Settings.
+                                                             (line 1879)
+* LH ms:                               ms Document Control Settings.
+                                                             (line 1858)
+* MONTH1 ms:                           ms language and localization.
+                                                             (line 3028)
+* MONTH10 ms:                          ms language and localization.
+                                                             (line 3037)
+* MONTH11 ms:                          ms language and localization.
+                                                             (line 3038)
+* MONTH12 ms:                          ms language and localization.
+                                                             (line 3039)
+* MONTH2 ms:                           ms language and localization.
+                                                             (line 3029)
+* MONTH3 ms:                           ms language and localization.
+                                                             (line 3030)
+* MONTH4 ms:                           ms language and localization.
+                                                             (line 3031)
+* MONTH5 ms:                           ms language and localization.
+                                                             (line 3032)
+* MONTH6 ms:                           ms language and localization.
+                                                             (line 3033)
+* MONTH7 ms:                           ms language and localization.
+                                                             (line 3034)
+* MONTH8 ms:                           ms language and localization.
+                                                             (line 3035)
+* MONTH9 ms:                           ms language and localization.
+                                                             (line 3036)
+* o ms:                                ms Legacy Features. (line 3476)
+* oe ms:                               ms Legacy Features. (line 3512)
+* OE ms:                               ms Legacy Features. (line 3515)
+* Q ms:                                Typographical symbols in ms.
+                                                             (line 2269)
+* q ms:                                ms Legacy Features. (line 3488)
+* REFERENCES ms:                       ms language and localization.
+                                                             (line 3014)
+* RF ms:                               ms Document Control Settings.
+                                                             (line 1893)
+* RH ms:                               ms Document Control Settings.
+                                                             (line 1872)
+* SN ms:                               Headings in ms.     (line 2410)
+* SN-DOT ms:                           Headings in ms.     (line 2408)
+* SN-NO-DOT ms:                        Headings in ms.     (line 2409)
+* SN-STYLE ms:                         ms Document Control Settings.
+                                                             (line 2011)
+* SN-STYLE ms <1>:                     Headings in ms.     (line 2407)
+* th ms:                               ms Legacy Features. (line 3500)
+* Th ms:                               ms Legacy Features. (line 3503)
+* TOC ms:                              ms language and localization.
+                                                             (line 3024)
+* U ms:                                Typographical symbols in ms.
+                                                             (line 2270)
+* v ms:                                ms Legacy Features. (line 3467)
+
+Appendix H File Keyword Index
+*****************************
+
+* Menu:
+
+* #:                                     DESC File Format.  (line 13432)
+* # <1>:                                 Font Description File Format.
+                                                            (line 13592)
+* ---:                                   Font Description File Format.
+                                                            (line 13639)
+* biggestfont:                           DESC File Format.  (line 13562)
+* charset:                               DESC File Format.  (line 13557)
+* charset <1>:                           Font Description File Format.
+                                                            (line 13631)
+* family:                                Selecting Fonts.   (line  7352)
+* family <1>:                            DESC File Format.  (line 13436)
+* fonts:                                 Using Symbols.     (line  7612)
+* fonts <1>:                             Special Fonts.     (line  8104)
+* fonts <2>:                             DESC File Format.  (line 13439)
+* hor:                                   DESC File Format.  (line 13445)
+* image_generator:                       DESC File Format.  (line 13449)
+* kernpairs:                             Font Description File Format.
+                                                            (line 13727)
+* ligatures:                             Font Description File Format.
+                                                            (line 13611)
+* name:                                  Font Description File Format.
+                                                            (line 13596)
+* paperlength:                           DESC File Format.  (line 13455)
+* papersize:                             DESC File Format.  (line 13459)
+* paperwidth:                            DESC File Format.  (line 13486)
+* pass_filenames:                        DESC File Format.  (line 13490)
+* postpro:                               DESC File Format.  (line 13495)
+* prepro:                                DESC File Format.  (line 13498)
+* print:                                 DESC File Format.  (line 13502)
+* res:                                   DESC File Format.  (line 13506)
+* sizes:                                 DESC File Format.  (line 13509)
+* sizescale:                             DESC File Format.  (line 13514)
+* slant:                                 Font Description File Format.
+                                                            (line 13607)
+* spacewidth:                            Font Description File Format.
+                                                            (line 13601)
+* spare1:                                DESC File Format.  (line 13562)
+* spare2:                                DESC File Format.  (line 13562)
+* special:                               Artificial Fonts.  (line  8230)
+* special <1>:                           Font Description File Format.
+                                                            (line 13618)
+* styles:                                Selecting Fonts.   (line  7352)
+* styles <1>:                            Font Families.     (line  7511)
+* styles <2>:                            DESC File Format.  (line 13518)
+* tcommand:                              DESC File Format.  (line 13522)
+* unicode:                               DESC File Format.  (line 13526)
+* unitwidth:                             DESC File Format.  (line 13540)
+* unscaled_charwidths:                   DESC File Format.  (line 13544)
+* use_charnames_in_special:              Postprocessor Access.
+                                                            (line 11760)
+* use_charnames_in_special <1>:          DESC File Format.  (line 13548)
+* vert:                                  DESC File Format.  (line 13553)
+
+Appendix I Program and File Index
+*********************************
+
+* Menu:
+
+* an.tmac:                               man.               (line  1417)
+* changebar:                             Miscellaneous.     (line 11940)
+* composite.tmac:                        Using Symbols.     (line  7802)
+* cp1047.tmac:                           Input Encodings.   (line  3986)
+* cs.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* de.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* DESC:                                  Selecting Fonts.   (line  7352)
+* DESC <1>:                              Font Families.     (line  7511)
+* DESC <2>:                              Using Symbols.     (line  7612)
+* DESC <3>:                              Using Symbols.     (line  7820)
+* DESC <4>:                              Special Fonts.     (line  8104)
+* diffmk:                                Miscellaneous.     (line 11940)
+* ec.tmac:                               Input Encodings.   (line  4027)
+* en.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* eqn:                                   ms Insertions.     (line  2845)
+* fr.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* freeeuro.pfa:                          Input Encodings.   (line  4027)
+* gchem:                                 Groff Options.     (line   478)
+* gdiffmk:                               Miscellaneous.     (line 11940)
+* geqn:                                  Groff Options.     (line   478)
+* ggrn:                                  Groff Options.     (line   478)
+* gpic:                                  Groff Options.     (line   478)
+* grap:                                  Groff Options.     (line   478)
+* grefer:                                Groff Options.     (line   478)
+* groff:                                 Groff Options.     (line   478)
+* gsoelim:                               Groff Options.     (line   478)
+* gtbl:                                  Groff Options.     (line   478)
+* gtroff:                                Groff Options.     (line   478)
+* it.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* ja.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* latin1.tmac:                           Input Encodings.   (line  3991)
+* latin2.tmac:                           Input Encodings.   (line  4004)
+* latin5.tmac:                           Input Encodings.   (line  4010)
+* latin9.tmac:                           Input Encodings.   (line  4015)
+* makeindex:                             Indexing.          (line  1340)
+* man.local:                             Optional man extensions.
+                                                            (line  1427)
+* man.tmac:                              man.               (line  1417)
+* man.ultrix:                            Optional man extensions.
+                                                            (line  1451)
+* nrchbar:                               Miscellaneous.     (line 11940)
+* papersize.tmac:                        Paper Format.      (line   975)
+* perl:                                  I/O.               (line 11645)
+* pic:                                   ms Insertions.     (line  2845)
+* post-grohtml:                          Groff Options.     (line   766)
+* pre-grohtml:                           Groff Options.     (line   766)
+* preconv:                               Groff Options.     (line   478)
+* refer:                                 ms Insertions.     (line  2845)
+* soelim:                                Debugging.         (line 12103)
+* sv.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+* tbl:                                   ms Insertions.     (line  2845)
+* trace.tmac:                            Writing Macros.    (line  9551)
+* troffrc:                               Groff Options.     (line   699)
+* troffrc <1>:                           Paper Format.      (line   975)
+* troffrc <2>:                           Manipulating Hyphenation.
+                                                            (line  6215)
+* troffrc <3>:                           Manipulating Hyphenation.
+                                                            (line  6263)
+* troffrc <4>:                           troff and nroff Modes.
+                                                            (line  6832)
+* troffrc-end:                           Groff Options.     (line   699)
+* troffrc-end <1>:                       Manipulating Hyphenation.
+                                                            (line  6263)
+* troffrc-end <2>:                       troff and nroff Modes.
+                                                            (line  6832)
+* tty.tmac:                              troff and nroff Modes.
+                                                            (line  6840)
+* tty.tmac <1>:                          Line Layout.       (line  6912)
+* vtroff:                                Operators in Conditionals.
+                                                            (line  9070)
+* zh.tmac:                               Manipulating Hyphenation.
+                                                            (line  6215)
+
+Appendix J Concept Index
+************************
+
+* Menu:
+
+* ", as delimiter:                       Delimiters.        (line  5060)
+* ", at end of sentence:                 Sentences.         (line  3663)
+* ", at end of sentence <1>:             Using Symbols.     (line  7892)
+* ", embedding in a macro argument:      Calling Macros.    (line  4875)
+* %, as delimiter:                       Delimiters.        (line  5092)
+* &, as delimiter:                       Delimiters.        (line  5092)
+* ', as a comment:                       Comments.          (line  5164)
+* ', as delimiter:                       Delimiters.        (line  5060)
+* ', at end of sentence:                 Sentences.         (line  3663)
+* ', at end of sentence <1>:             Using Symbols.     (line  7892)
+* (, as delimiter:                       Delimiters.        (line  5092)
+* ), as delimiter:                       Delimiters.        (line  5092)
+* ), at end of sentence:                 Sentences.         (line  3663)
+* ), at end of sentence <1>:             Using Symbols.     (line  7892)
+* *, as delimiter:                       Delimiters.        (line  5092)
+* *, at end of sentence:                 Sentences.         (line  3663)
+* *, at end of sentence <1>:             Using Symbols.     (line  7892)
+* +, and page motion:                    Numeric Expressions.
+                                                            (line  4457)
+* +, as delimiter:                       Delimiters.        (line  5092)
+* -, and page motion:                    Numeric Expressions.
+                                                            (line  4457)
+* -, as delimiter:                       Delimiters.        (line  5092)
+* ., as delimiter:                       Delimiters.        (line  5090)
+* .h register, difference from nl:       Diversions.        (line 11020)
+* .ps register, in comparison with .psr: Using Fractional Type Sizes.
+                                                            (line  8638)
+* .s register, in comparison with .sr:   Using Fractional Type Sizes.
+                                                            (line  8638)
+* .S register, Plan 9 alias for .tabs:   Tabs and Fields.   (line  6593)
+* .t register, and diversions:           Diversion Traps.   (line 10668)
+* .tabs register, Plan 9 alias (.S):     Tabs and Fields.   (line  6593)
+* .V register, and vs:                   Changing the Vertical Spacing.
+                                                            (line  8546)
+* /, as delimiter:                       Delimiters.        (line  5092)
+* 8-bit input:                           Font Description File Format.
+                                                            (line 13639)
+* <, as delimiter:                       Delimiters.        (line  5092)
+* <colon>, as delimiter:                 Delimiters.        (line  5092)
+* =, as delimiter:                       Delimiters.        (line  5092)
+* >, as delimiter:                       Delimiters.        (line  5092)
+* , macro names starting with, and refer: Identifiers.     (line  4623)
+* \!, and copy mode:                     Diversions.        (line 11074)
+* \!, and output request:                Diversions.        (line 11106)
+* \!, and trnt:                          Character Translations.
+                                                            (line  6795)
+* \!, as delimiter:                      Delimiters.        (line  5069)
+* \!, as delimiter <1>:                  Delimiters.        (line  5096)
+* \!, in top-level diversion:            Diversions.        (line 11098)
+* \!, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \!, incompatibilities with AT&T troff <1>: Other Differences.
+                                                            (line 12636)
+* \$, when reading text for a macro:     Copy Mode.         (line  9699)
+* \%, and translations:                  Character Translations.
+                                                            (line  6747)
+* \%, as delimiter:                      Delimiters.        (line  5069)
+* \%, as delimiter <1>:                  Delimiters.        (line  5096)
+* \%, following \X or \Y:                Manipulating Hyphenation.
+                                                            (line  6001)
+* \%, in \X:                             Postprocessor Access.
+                                                            (line 11746)
+* \%, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \&, and glyph definitions:             Using Symbols.     (line  7948)
+* \&, and translations:                  Character Translations.
+                                                            (line  6758)
+* \&, as delimiter:                      Delimiters.        (line  5069)
+* \&, at end of sentence:                Sentences.         (line  3647)
+* \&, in \X:                             Postprocessor Access.
+                                                            (line 11746)
+* \&, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \', and translations:                  Character Translations.
+                                                            (line  6741)
+* \', as delimiter:                      Delimiters.        (line  5069)
+* \', as delimiter <1>:                  Delimiters.        (line  5096)
+* \', incompatibilities with AT&T troff: Other Differences. (line 12546)
+* $, and translations:                  Character Translations.
+                                                            (line  6741)
+* $, as delimiter:                      Delimiters.        (line  5069)
+* \), in \X:                             Postprocessor Access.
+                                                            (line 11746)
+* \*, and warnings:                      Warnings.          (line 12301)
+* \*, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12404)
+* \*, when reading text for a macro:     Copy Mode.         (line  9699)
+* \, disabling (eo):                     Using Escape Sequences.
+                                                            (line  5007)
+* \, embedding in a macro argument:      Calling Macros.    (line  4875)
+* \,, as delimiter:                      Delimiters.        (line  5069)
+* \- glyph, and cflags:                  Using Symbols.     (line  7875)
+* \-, and translations:                  Character Translations.
+                                                            (line  6741)
+* \-, as delimiter:                      Delimiters.        (line  5069)
+* \-, as delimiter <1>:                  Delimiters.        (line  5096)
+* \-, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \/, as delimiter:                      Delimiters.        (line  5069)
+* \/, as delimiter <1>:                  Delimiters.        (line  5096)
+* \0, as delimiter:                      Delimiters.        (line  5069)
+* \:, as delimiter:                      Delimiters.        (line  5069)
+* \:, as delimiter <1>:                  Delimiters.        (line  5096)
+* \<colon>, in \X:                       Postprocessor Access.
+                                                            (line 11746)
+* \?, and copy mode:                     Operators in Conditionals.
+                                                            (line  9116)
+* \?, and copy mode <1>:                 Diversions.        (line 11074)
+* \?, as delimiter:                      Delimiters.        (line  5069)
+* \?, in top-level diversion:            Diversions.        (line 11103)
+* \?, incompatibilities with AT&T troff: Other Differences. (line 12636)
+* \a, and copy mode:                     Leaders.           (line  6658)
+* \a, and translations:                  Character Translations.
+                                                            (line  6751)
+* \a, as delimiter:                      Delimiters.        (line  5069)
+* \A, delimiters allowed by:             Delimiters.        (line  5076)
+* \A, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \b, delimiters allowed by:             Delimiters.        (line  5076)
+* \b, limitations of:                    Drawing Geometric Objects.
+                                                            (line 10316)
+* \C, and translations:                  Character Translations.
+                                                            (line  6741)
+* \c, as delimiter:                      Delimiters.        (line  5069)
+* \c, as delimiter <1>:                  Delimiters.        (line  5096)
+* \c, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \c, when filling disabled:             Line Continuation. (line  7062)
+* \c, when filling enabled:              Line Continuation. (line  7054)
+* \d, as delimiter:                      Delimiters.        (line  5069)
+* \D, delimiters allowed by:             Delimiters.        (line  5087)
+* \e, and glyph definitions:             Using Symbols.     (line  7948)
+* \e, and translations:                  Character Translations.
+                                                            (line  6745)
+* \e, as delimiter:                      Delimiters.        (line  5069)
+* \E, as delimiter:                      Delimiters.        (line  5069)
+* \e, as delimiter <1>:                  Delimiters.        (line  5096)
+* \e, incompatibilities with AT&T troff: Other Differences. (line 12636)
+* \F, and changing fonts:                Selecting Fonts.   (line  7352)
+* \f, and font translations:             Selecting Fonts.   (line  7406)
+* \f, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12506)
+* \h, delimiters allowed by:             Delimiters.        (line  5087)
+* \H, delimiters allowed by:             Delimiters.        (line  5087)
+* \H, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12506)
+* \H, using + and - with:                Numeric Expressions.
+                                                            (line  4463)
+* \H, with fractional type sizes:        Using Fractional Type Sizes.
+                                                            (line  8604)
+* \l, and glyph definitions:             Using Symbols.     (line  7948)
+* \L, and glyph definitions:             Using Symbols.     (line  7948)
+* \l, delimiters allowed by:             Delimiters.        (line  5087)
+* \L, delimiters allowed by:             Delimiters.        (line  5087)
+* \N, and translations:                  Character Translations.
+                                                            (line  6741)
+* \n, and warnings:                      Warnings.          (line 12313)
+* \N, delimiters allowed by:             Delimiters.        (line  5087)
+* \n, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12404)
+* \n, when reading text for a macro:     Copy Mode.         (line  9699)
+* \o, delimiters allowed by:             Delimiters.        (line  5076)
+* \p, as delimiter:                      Delimiters.        (line  5069)
+* \p, as delimiter <1>:                  Delimiters.        (line  5096)
+* \R, after \c:                          Line Continuation. (line  7048)
+* \R, and warnings:                      Warnings.          (line 12313)
+* \r, as delimiter:                      Delimiters.        (line  5069)
+* \R, delimiters allowed by:             Delimiters.        (line  5087)
+* \R, difference from nr:                Auto-increment.    (line  5372)
+* \R, using + and - with:                Numeric Expressions.
+                                                            (line  4463)
+* \<RET>, when reading text for a macro: Copy Mode.         (line  9699)
+* \s, delimiters allowed by:             Delimiters.        (line  5087)
+* \S, delimiters allowed by:             Delimiters.        (line  5087)
+* \s, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12506)
+* \S, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12506)
+* \s, incompatibilities with AT&T troff <1>: Compatibility Mode.
+                                                            (line 12519)
+* \s, using + and - with:                Numeric Expressions.
+                                                            (line  4463)
+* \s, with fractional type sizes:        Using Fractional Type Sizes.
+                                                            (line  8604)
+* \<SP>, as delimiter:                   Delimiters.        (line  5069)
+* \<SP>, difference from \~:             Calling Macros.    (line  4867)
+* \<SP>, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12546)
+* \t, and copy mode:                     Tabs and Fields.   (line  6485)
+* \t, and translations:                  Character Translations.
+                                                            (line  6751)
+* \t, and warnings:                      Warnings.          (line 12319)
+* \t, as delimiter:                      Delimiters.        (line  5069)
+* \u, as delimiter:                      Delimiters.        (line  5069)
+* \V, and copy mode:                     I/O.               (line 11721)
+* \v, delimiters allowed by:             Delimiters.        (line  5087)
+* \v, internal representation:           Gtroff Internals.  (line 12017)
+* \w, delimiters allowed by:             Delimiters.        (line  5076)
+* \X, and special characters:            Postprocessor Access.
+                                                            (line 11760)
+* \X, delimiters allowed by:             Delimiters.        (line  5076)
+* \x, delimiters allowed by:             Delimiters.        (line  5087)
+* \X, followed by \%:                    Manipulating Hyphenation.
+                                                            (line  6001)
+* \Y, followed by \%:                    Manipulating Hyphenation.
+                                                            (line  6001)
+* \Z, delimiters allowed by:             Delimiters.        (line  5076)
+* \, and translations:                  Character Translations.
+                                                            (line  6741)
+* \\, when reading text for a macro:     Copy Mode.         (line  9738)
+* \^, as delimiter:                      Delimiters.        (line  5069)
+* \^, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \_, and translations:                  Character Translations.
+                                                            (line  6741)
+* \_, as delimiter:                      Delimiters.        (line  5069)
+* \_, as delimiter <1>:                  Delimiters.        (line  5096)
+* \_, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \`, and translations:                  Character Translations.
+                                                            (line  6741)
+* \`, as delimiter:                      Delimiters.        (line  5069)
+* \`, as delimiter <1>:                  Delimiters.        (line  5096)
+* \`, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \{, as delimiter:                      Delimiters.        (line  5069)
+* \{, as delimiter <1>:                  Delimiters.        (line  5096)
+* \{, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \|, as delimiter:                      Delimiters.        (line  5069)
+* \|, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \}, and warnings:                      Warnings.          (line 12324)
+* \}, as delimiter:                      Delimiters.        (line  5069)
+* \}, as delimiter <1>:                  Delimiters.        (line  5096)
+* \}, incompatibilities with AT&T troff: Other Differences. (line 12546)
+* \~, and translations:                  Character Translations.
+                                                            (line  6747)
+* \~, as delimiter:                      Delimiters.        (line  5069)
+* \~, difference from \<SP>:             Calling Macros.    (line  4867)
+* \~, incompatibilities with AT&T troff: Other Differences. (line 12539)
+* , as part of an identifier:           Identifiers.       (line  4616)
+* , at end of sentence:                 Sentences.         (line  3663)
+* , at end of sentence <1>:             Using Symbols.     (line  7892)
+* , macro names starting with, and refer: Identifiers.     (line  4623)
+* |, and page motion:                    Numeric Expressions.
+                                                            (line  4471)
+* ab request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12592)
+* aborting (ab):                         Debugging.         (line 12127)
+* absolute (sic) position operator (|):  Numeric Expressions.
+                                                            (line  4471)
+* abstract font style:                   Using Fonts.       (line  7302)
+* abstract font style, setting up (sty): Font Families.     (line  7505)
+* accent marks ms:                     ms Legacy Features.
+                                                            (line  3405)
+* access to postprocessor:               Postprocessor Access.
+                                                            (line 11729)
+* accessing unnamed glyphs with \N:      Font Description File Format.
+                                                            (line 13639)
+* activating kerning (kern):             Ligatures and Kerning.
+                                                            (line  8289)
+* activating ligatures (lg):             Ligatures and Kerning.
+                                                            (line  8271)
+* activating track kerning (tkf):        Ligatures and Kerning.
+                                                            (line  8307)
+* ad request, and hyphenation margin:    Manipulating Hyphenation.
+                                                            (line  6290)
+* ad request, and hyphenation space:     Manipulating Hyphenation.
+                                                            (line  6305)
+* addition:                              Numeric Expressions.
+                                                            (line  4359)
+* additional inter-sentence space:       Manipulating Filling and Adjustment.
+                                                            (line  5893)
+* adjustment and filling, manipulating:  Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* adjustment mode register (.j):         Manipulating Filling and Adjustment.
+                                                            (line  5731)
+* adjustment to both margins, difference from AT&T troff: Other Differences.
+                                                            (line 12552)
+* Adobe Glyph List (AGL):                Using Symbols.     (line  7688)
+* alias, diversion, creating (als):      Strings.           (line  8972)
+* alias, diversion, removing (rm):       Strings.           (line  9007)
+* alias, macro, creating (als):          Strings.           (line  8972)
+* alias, macro, removing (rm):           Strings.           (line  9007)
+* alias, register, creating (aln):       Setting Registers. (line  5323)
+* alias, register, removing (rr):        Setting Registers. (line  5329)
+* alias, string, creating (als):         Strings.           (line  8972)
+* alias, string, removing (rm):          Strings.           (line  9007)
+* aliasing fonts with third argument to fp request: Font Positions.
+                                                            (line  7561)
+* als request, and \$0:                  Parameters.        (line  9657)
+* am, am1, ami requests, and warnings:   Warnings.          (line 12301)
+* appending to a diversion (da, boxa):   Diversions.        (line 10944)
+* appending to a file (opena):           I/O.               (line 11671)
+* appending to a macro (am):             Writing Macros.    (line  9533)
+* appending to a string (as):            Strings.           (line  8889)
+* approximation output register (.A):    Built-in Registers.
+                                                            (line  5527)
+* arc, drawing (\D'a ...'):              Drawing Geometric Objects.
+                                                            (line 10225)
+* argument:                              Requests and Macros.
+                                                            (line  3829)
+* arguments to macros:                   Calling Macros.    (line  4851)
+* arguments to macros, and tabs:         Invoking Requests. (line  4789)
+* arguments to requests:                 Invoking Requests. (line  4789)
+* arguments to requests, and tabs:       Invoking Requests. (line  4789)
+* arguments, and compatibility mode:     Gtroff Internals.  (line 12054)
+* arguments, to escape sequences, delimiting: Delimiters.   (line  5060)
+* arguments, to strings:                 Strings.           (line  8802)
+* arithmetic operators:                  Numeric Expressions.
+                                                            (line  4359)
+* artificial fonts:                      Artificial Fonts.  (line  8122)
+* as, as1 requests, and comments:        Comments.          (line  5139)
+* as, as1 requests, and warnings:        Warnings.          (line 12301)
+* ASCII output encoding:                 Groff Options.     (line   743)
+* asciify request, and writem:           I/O.               (line 11694)
+* assertion (arithmetic operator):       Numeric Expressions.
+                                                            (line  4365)
+* assign number format to register (af): Assigning Register Formats.
+                                                            (line  5413)
+* assignments, indirect:                 Interpolating Registers.
+                                                            (line  5340)
+* assignments, nested:                   Interpolating Registers.
+                                                            (line  5340)
+* AT&T ms, macro package differences:    Differences from AT&T ms.
+                                                            (line  3276)
+* attributes, character cell:            Using Fonts.       (line  7323)
+* auto-incrementation of a register:     Auto-increment.    (line  5364)
+* automatic font mounting:               Selecting Fonts.   (line  7365)
+* automatic hyphenation:                 Manipulating Hyphenation.
+                                                            (line  5941)
+* automatic hyphenation parameters:      Manipulating Hyphenation.
+                                                            (line  6042)
+* auxiliary macro package:               Major Macro Packages.
+                                                            (line  1408)
+* available glyphs, list of (groff_char(7) man page): Using Symbols.
+                                                            (line  7675)
+* background:                            Background.        (line   229)
+* background color name register (.M):   Colors.            (line  8765)
+* backslash glyph, formatting (\rs):   Using Escape Sequences.
+                                                            (line  5002)
+* backslash, embedding in a macro argument: Calling Macros. (line  4875)
+* backslash, printing (\\, \e, \E, \rs): Other Differences.
+                                                            (line 12636)
+* backspace character, and translations: Character Translations.
+                                                            (line  6751)
+* backtrace of input stack (backtrace):  Debugging.         (line 12176)
+* baseline rule special character(\ru): Drawing Geometric Objects.
+                                                            (line 10146)
+* baseline, text:                        Page Geometry.     (line  4184)
+* baseline, text <1>:                    Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* basic scaling unit (u):                Measurements.      (line  4245)
+* basic units:                           Page Geometry.     (line  4169)
+* basic units, conversion to:            Measurements.      (line  4239)
+* basics of macro package usage:         Basics.            (line  1058)
+* bd request, and font styles:           Font Families.     (line  7505)
+* bd request, and font translations:     Selecting Fonts.   (line  7406)
+* bd request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12609)
+* beginning diversion (di, box):         Diversions.        (line 10944)
+* beginning of conditional block (\{):   Conditional Blocks.
+                                                            (line  9250)
+* blank line:                            Breaking.          (line  3749)
+* blank line macro (blm):                Breaking.          (line  3749)
+* blank line macro (blm) <1>:            Invoking Requests. (line  4820)
+* blank line macro (blm) <2>:            Blank Line Traps.  (line 10779)
+* blank line trap (blm):                 Invoking Requests. (line  4820)
+* blank line traps:                      Blank Line Traps.  (line 10778)
+* blank lines, disabling:                Manipulating Spacing.
+                                                            (line  6456)
+* block, conditional, beginning (\{):    Conditional Blocks.
+                                                            (line  9250)
+* block, conditional, end (\}):          Conditional Blocks.
+                                                            (line  9250)
+* blocks, conditional:                   Conditional Blocks.
+                                                            (line  9243)
+* body, of a while request:              while.             (line  9330)
+* boldface, imitating (bd):              Artificial Fonts.  (line  8213)
+* bottom margin:                         Page Location Traps.
+                                                            (line 10440)
+* boundary-relative motion operator (|): Numeric Expressions.
+                                                            (line  4471)
+* bounding box:                          Miscellaneous.     (line 11949)
+* box (diversion operation):             Diversions.        (line 10971)
+* box request, and warnings:             Warnings.          (line 12296)
+* box rule glyph (\br):                Drawing Geometric Objects.
+                                                            (line 10168)
+* box, boxa requests, and warnings:      Warnings.          (line 12301)
+* boxa request, and dn (dl):             Diversions.        (line 11026)
+* boxa request, and warnings:            Warnings.          (line 12296)
+* boxes ms:                            ms keeps and displays.
+                                                            (line  2771)
+* bp request, and top-level diversion:   Page Control.      (line  7183)
+* bp request, and traps (.pe):           Page Location Traps.
+                                                            (line 10598)
+* bp request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* bp request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12596)
+* bp request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* br glyph, and cflags:                  Using Symbols.     (line  7887)
+* brace escape sequence, closing (\}):   Conditional Blocks.
+                                                            (line  9250)
+* brace escape sequence, opening (\}):   Conditional Blocks.
+                                                            (line  9250)
+* brace escape sequences (\{, \}):       Conditional Blocks.
+                                                            (line  9250)
+* break:                                 Breaking.          (line  3725)
+* break <1>:                             Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* break (introduction):                  Basics.            (line  1188)
+* break request, in a while loop:        while.             (line  9393)
+* break, page:                           Page Geometry.     (line  4208)
+* break, page <1>:                       Page Control.      (line  7170)
+* break, page <2>:                       The Implicit Page Trap.
+                                                            (line 10638)
+* break, page (introduction):            Basics.            (line  1185)
+* break, page, final:                    End-of-input Traps.
+                                                            (line 10834)
+* break, page, prevented by vpt:         Vertical Position Traps.
+                                                            (line 10414)
+* breaking file names (\:):              Manipulating Hyphenation.
+                                                            (line  6008)
+* breaking URLs (\:):                    Manipulating Hyphenation.
+                                                            (line  6008)
+* breaking without hyphens (\:):         Manipulating Hyphenation.
+                                                            (line  6008)
+* built-in register, removing:           Built-in Registers.
+                                                            (line  5513)
+* built-in registers:                    Built-in Registers.
+                                                            (line  5508)
+* bulleted list, example markup ms:    Lists in ms.       (line  2590)
+* c scaling unit:                        Measurements.      (line  4252)
+* calling a macro:                       Requests and Macros.
+                                                            (line  3840)
+* calling macros:                        Calling Macros.    (line  4851)
+* capabilities of groff:                 groff Capabilities.
+                                                            (line   281)
+* case-transforming a string (stringdown, stringup): Strings.
+                                                            (line  8945)
+* categories, warning:                   Warnings.          (line 12250)
+* CCSID 1047 output encoding (EBCDIC):   Groff Options.     (line   755)
+* ce request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* ce request, difference from .ad c:     Manipulating Filling and Adjustment.
+                                                            (line  5836)
+* cell, character, attributes:           Using Fonts.       (line  7323)
+* centered text (filled):                Manipulating Filling and Adjustment.
+                                                            (line  5716)
+* centered text (unfilled):              Manipulating Filling and Adjustment.
+                                                            (line  5827)
+* centering lines (ce):                  Manipulating Filling and Adjustment.
+                                                            (line  5827)
+* centering lines (introduction):        Basics.            (line  1170)
+* centimeter scaling unit (c):           Measurements.      (line  4252)
+* cf request, and copy mode:             I/O.               (line 11521)
+* cf request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* changing control characters:           Control Characters.
+                                                            (line  4726)
+* changing font family (fam, \F):        Font Families.     (line  7467)
+* changing fonts (ft, \f):               Selecting Fonts.   (line  7352)
+* changing format, and read-only registers: Assigning Register Formats.
+                                                            (line  5472)
+* changing the font height (\H):         Artificial Fonts.  (line  8132)
+* changing the font slant (\S):          Artificial Fonts.  (line  8161)
+* changing the page number character (pc): Page Layout.     (line  7149)
+* changing trap location (ch):           Page Location Traps.
+                                                            (line 10528)
+* changing type sizes (ps, \s):          Changing the Type Size.
+                                                            (line  8466)
+* changing vertical line spacing (vs):   Changing the Vertical Spacing.
+                                                            (line  8543)
+* char request, and soft hyphen character: Manipulating Hyphenation.
+                                                            (line  6032)
+* char request, and translations:        Character Translations.
+                                                            (line  6741)
+* char request, used with \N:            Using Symbols.     (line  7810)
+* character:                             Using Symbols.     (line  7600)
+* character cell attributes:             Using Fonts.       (line  7323)
+* character class (class):               Character Classes. (line  8034)
+* character classes:                     Character Classes. (line  8028)
+* character properties (cflags):         Using Symbols.     (line  7846)
+* character translations:                Character Translations.
+                                                            (line  6722)
+* character, backspace, and translations: Character Translations.
+                                                            (line  6751)
+* character, control (.):                Requests and Macros.
+                                                            (line  3813)
+* character, control, changing (cc):     Control Characters.
+                                                            (line  4738)
+* character, defining (char):            Using Symbols.     (line  7948)
+* character, defining fallback (fchar, fschar, schar): Using Symbols.
+                                                            (line  7948)
+* character, distinguished from glyph:   Using Symbols.     (line  7600)
+* character, dummy (\&):                 Dummy Characters.  (line  8357)
+* character, dummy (\&), as control character suppressor: Requests and Macros.
+                                                            (line  3820)
+* character, dummy (\&), effect on kerning: Ligatures and Kerning.
+                                                            (line  8294)
+* character, dummy (\&), effect on \l escape sequence: Drawing Geometric Objects.
+                                                            (line 10150)
+* character, escape, changing (ec):      Using Escape Sequences.
+                                                            (line  5012)
+* character, escape, while defining glyph: Using Symbols.   (line  7948)
+* character, field delimiting (fc):      Fields.            (line  6692)
+* character, field padding (fc):         Fields.            (line  6692)
+* character, horizontal tab:             Tabs and Leaders.  (line  3785)
+* character, hyphenation (\%):           Manipulating Hyphenation.
+                                                            (line  5992)
+* character, leader:                     Tabs and Leaders.  (line  3785)
+* character, leader repetition (lc):     Leaders.           (line  6661)
+* character, leader, and translations:   Character Translations.
+                                                            (line  6751)
+* character, leader, non-interpreted (\a): Leaders.         (line  6658)
+* character, named (\C):                 Using Symbols.     (line  7793)
+* character, newline, and translations:  Character Translations.
+                                                            (line  6751)
+* character, no-break control ('):       Requests and Macros.
+                                                            (line  3813)
+* character, no-break control, changing (c2): Control Characters.
+                                                            (line  4738)
+* character, ordinary:                   Identifiers.       (line  4577)
+* character, soft hyphen, setting (shc): Manipulating Hyphenation.
+                                                            (line  6032)
+* character, special:                    Character Translations.
+                                                            (line  6741)
+* character, tab repetition (tc):        Tabs and Fields.   (line  6602)
+* character, tab, and translations:      Character Translations.
+                                                            (line  6751)
+* character, tab, non-interpreted (\t):  Tabs and Fields.   (line  6485)
+* character, transparent:                Using Symbols.     (line  7892)
+* character, transparent dummy (\)):     Dummy Characters.  (line  8407)
+* characters, end-of-sentence:           Using Symbols.     (line  7863)
+* characters, end-of-sentence transparent: Sentences.       (line  3663)
+* characters, hyphenation:               Using Symbols.     (line  7868)
+* characters, input, and output glyphs, compatibility with AT&T troff: Other Differences.
+                                                            (line 12609)
+* characters, invalid for trf request:   I/O.               (line 11533)
+* characters, invalid input:             Identifiers.       (line  4581)
+* characters, overlapping:               Using Symbols.     (line  7882)
+* characters, special:                   Sentences.         (line  3663)
+* characters, special, list of (groff_char(7) man page): Using Symbols.
+                                                            (line  7675)
+* characters, unnamed, accessing with \N: Font Description File Format.
+                                                            (line 13639)
+* circle, filled, drawing (\D'C ...'):   Drawing Geometric Objects.
+                                                            (line 10234)
+* circle, outlined, drawing (\D'c ...'): Drawing Geometric Objects.
+                                                            (line 10230)
+* circle, solid, drawing (\D'C ...'):    Drawing Geometric Objects.
+                                                            (line 10234)
+* circle, stroked, drawing (\D'c ...'):  Drawing Geometric Objects.
+                                                            (line 10230)
+* class of characters (class):           Character Classes. (line  8034)
+* classes, character:                    Character Classes. (line  8028)
+* clearing input line trap (it, itc):    Input Line Traps.  (line 10680)
+* closing brace escape sequence (\}):    Conditional Blocks.
+                                                            (line  9250)
+* closing file (close):                  I/O.               (line 11703)
+* code page 1047 output encoding:        Groff Options.     (line   755)
+* code page 1047, input encoding:        Input Encodings.   (line  3986)
+* code, hyphenation (hcode):             Manipulating Hyphenation.
+                                                            (line  6228)
+* color name, background, register (.M): Colors.            (line  8765)
+* color name, fill, register (.M):       Colors.            (line  8765)
+* color name, stroke, register (.m):     Colors.            (line  8744)
+* color, default:                        Colors.            (line  8720)
+* color, fill:                           Colors.            (line  8678)
+* color, stroke:                         Colors.            (line  8678)
+* colors:                                Colors.            (line  8678)
+* command prefix:                        Environment.       (line   835)
+* command-line options:                  Groff Options.     (line   520)
+* comments:                              Comments.          (line  5132)
+* comments in device description files:  DESC File Format.  (line 13432)
+* comments in font description files:    Font Description File Format.
+                                                            (line 13592)
+* comments, lining up with tabs:         Comments.          (line  5145)
+* comments, with ds:                     Strings.           (line  8823)
+* common features:                       Common Features.   (line  1201)
+* common name space of macros, diversions, and strings: Identifiers.
+                                                            (line  4668)
+* comparison of strings:                 Operators in Conditionals.
+                                                            (line  9108)
+* comparison operators:                  Numeric Expressions.
+                                                            (line  4416)
+* compatibility mode:                    Warnings.          (line 12341)
+* compatibility mode <1>:                Compatibility Mode.
+                                                            (line 12404)
+* compatibility mode, and parameters:    Gtroff Internals.  (line 12054)
+* complementation, logical:              Numeric Expressions.
+                                                            (line  4426)
+* composite glyph names:                 Using Symbols.     (line  7688)
+* conditional block, beginning (\{):     Conditional Blocks.
+                                                            (line  9250)
+* conditional block, end (\}):           Conditional Blocks.
+                                                            (line  9250)
+* conditional blocks:                    Conditional Blocks.
+                                                            (line  9243)
+* conditional expressions:               Operators in Conditionals.
+                                                            (line  9027)
+* conditional output for terminal (TTY): Operators in Conditionals.
+                                                            (line  9053)
+* conditional page break (ne):           Page Control.      (line  7195)
+* conditionals and loops:                Conditionals and Loops.
+                                                            (line  9020)
+* configuring control characters:        Control Characters.
+                                                            (line  4726)
+* configuring the page length (pl):      Page Layout.       (line  7093)
+* consecutive hyphenated lines (hlm):    Manipulating Hyphenation.
+                                                            (line  6277)
+* constant glyph space mode (cs):        Artificial Fonts.  (line  8241)
+* contents, table of:                    Table of Contents. (line  1323)
+* contents, table of <1>:                Leaders.           (line  6671)
+* continuation, input line (\<RET>):     Line Continuation. (line  7019)
+* continuation, output line (\c):        Line Continuation. (line  7048)
+* continue request, in a while loop:     while.             (line  9393)
+* continued output line register (.int): Line Continuation. (line  7073)
+* continuous underlining (cu):           Artificial Fonts.  (line  8202)
+* control character (.):                 Requests and Macros.
+                                                            (line  3813)
+* control character, changing (cc):      Control Characters.
+                                                            (line  4738)
+* control character, no-break ('):       Requests and Macros.
+                                                            (line  3813)
+* control character, no-break, changing (c2): Control Characters.
+                                                            (line  4738)
+* control characters:                    Control Characters.
+                                                            (line  4726)
+* control line:                          Requests and Macros.
+                                                            (line  3825)
+* control, line:                         Line Continuation. (line  7014)
+* control, page:                         Page Control.      (line  7170)
+* conventions for input:                 Input Conventions. (line  4051)
+* conversion to basic units:             Measurements.      (line  4239)
+* copy mode:                             Copy Mode.         (line  9699)
+* copy mode <1>:                         Copy Mode.         (line  9699)
+* copy mode, and cf request:             I/O.               (line 11521)
+* copy mode, and device request:         Postprocessor Access.
+                                                            (line 11744)
+* copy mode, and length request:         Strings.           (line  8909)
+* copy mode, and macro parameters:       Parameters.        (line  9616)
+* copy mode, and output request:         Diversions.        (line 11106)
+* copy mode, and trf request:            I/O.               (line 11521)
+* copy mode, and write request:          I/O.               (line 11683)
+* copy mode, and writec request:         I/O.               (line 11683)
+* copy mode, and writem request:         I/O.               (line 11697)
+* copy mode, and \!:                     Diversions.        (line 11074)
+* copy mode, and \?:                     Operators in Conditionals.
+                                                            (line  9116)
+* copy mode, and \? <1>:                 Diversions.        (line 11074)
+* copy mode, and \a:                     Leaders.           (line  6658)
+* copy mode, and \t:                     Tabs and Fields.   (line  6485)
+* copy mode, and \V:                     I/O.               (line 11721)
+* copying environment (evc):             Environments.      (line 11362)
+* correction between oblique and upright glyph (\/, \,): Italic Corrections.
+                                                            (line  8328)
+* correction between upright and oblique glyph (\/, \,): Italic Corrections.
+                                                            (line  8338)
+* correction, italic (\/):               Italic Corrections.
+                                                            (line  8328)
+* correction, left italic (\,):          Italic Corrections.
+                                                            (line  8338)
+* cover page in ms, example markup:    ms Document Description Macros.
+                                                            (line  2196)
+* cp request, and glyph definitions:     Using Symbols.     (line  7948)
+* cq glyph, at end of sentence:          Sentences.         (line  3663)
+* cq glyph, at end of sentence <1>:      Using Symbols.     (line  7892)
+* creating alias for register (aln):     Setting Registers. (line  5323)
+* creating alias, for diversion (als):   Strings.           (line  8972)
+* creating alias, for macro (als):       Strings.           (line  8972)
+* creating alias, for string (als):      Strings.           (line  8972)
+* creating new characters (char):        Using Symbols.     (line  7948)
+* credits:                               Credits.           (line   444)
+* cs request, and font styles:           Font Families.     (line  7505)
+* cs request, and font translations:     Selecting Fonts.   (line  7406)
+* cs request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12609)
+* cs request, with fractional type sizes: Using Fractional Type Sizes.
+                                                            (line  8604)
+* CSTR #54 errata:                       Built-in Registers.
+                                                            (line  5600)
+* CSTR #54 errata <1>:                   Line Layout.       (line  6920)
+* CSTR #54 errata <2>:                   Page Control.      (line  7185)
+* CSTR #54 errata <3>:                   Artificial Fonts.  (line  8176)
+* CSTR #54 errata <4>:                   Changing the Type Size.
+                                                            (line  8475)
+* CSTR #54 errata <5>:                   Page Motions.      (line 10040)
+* CSTR #54 erratum, bp request:          Page Control.      (line  7185)
+* CSTR #54 erratum, po request:          Line Layout.       (line  6920)
+* CSTR #54 erratum, ps request:          Changing the Type Size.
+                                                            (line  8475)
+* CSTR #54 erratum, sb register:         Page Motions.      (line 10040)
+* CSTR #54 erratum, st register:         Page Motions.      (line 10040)
+* CSTR #54 erratum, yr register:         Built-in Registers.
+                                                            (line  5600)
+* CSTR #54 erratum, \S escape:           Artificial Fonts.  (line  8176)
+* CSTR #54 erratum, \s escape sequence:  Changing the Type Size.
+                                                            (line  8475)
+* current directory:                     Macro Directories. (line   910)
+* current input file name register (.F): Built-in Registers.
+                                                            (line  5536)
+* current page number (%):               Page Control.      (line  7188)
+* current time, hours (hours):           Built-in Registers.
+                                                            (line  5586)
+* current time, minutes (minutes):       Built-in Registers.
+                                                            (line  5583)
+* current time, seconds (seconds):       Built-in Registers.
+                                                            (line  5580)
+* da request, and dn (dl):               Diversions.        (line 11026)
+* da request, and warnings:              Warnings.          (line 12296)
+* da request, and warnings <1>:          Warnings.          (line 12301)
+* date, day of the month register (dy):  Built-in Registers.
+                                                            (line  5592)
+* date, day of the week register (dw):   Built-in Registers.
+                                                            (line  5589)
+* date, month of the year register (mo): Built-in Registers.
+                                                            (line  5595)
+* date, year register (year, yr):        Built-in Registers.
+                                                            (line  5598)
+* day of the month register (dy):        Built-in Registers.
+                                                            (line  5592)
+* day of the week register (dw):         Built-in Registers.
+                                                            (line  5589)
+* dd glyph, at end of sentence:          Sentences.         (line  3663)
+* dd glyph, at end of sentence <1>:      Using Symbols.     (line  7892)
+* de request, and while:                 while.             (line  9343)
+* de, de1, dei requests, and warnings:   Warnings.          (line 12301)
+* debugging:                             Debugging.         (line 12078)
+* debugging page location traps:         Page Location Traps.
+                                                            (line 10476)
+* decimal point, as delimiter:           Delimiters.        (line  5090)
+* decrementation, automatic, of a register: Auto-increment. (line  5364)
+* default color:                         Colors.            (line  8720)
+* default tab stops:                     Tabs and Fields.   (line  6493)
+* default units:                         Default Units.     (line  4318)
+* deferred output:                       Deferring Output.  (line 10337)
+* defining character (char):             Using Symbols.     (line  7948)
+* defining character class (class):      Character Classes. (line  8034)
+* defining fallback character (fchar, fschar, schar): Using Symbols.
+                                                            (line  7948)
+* defining glyph (char):                 Using Symbols.     (line  7948)
+* defining symbol (char):                Using Symbols.     (line  7948)
+* delimited arguments, incompatibilities with AT&T troff: Compatibility Mode.
+                                                            (line 12498)
+* delimiters, for escape sequence arguments: Delimiters.    (line  5060)
+* delimiting character, for fields (fc): Fields.            (line  6692)
+* delimiting escape sequence arguments:  Delimiters.        (line  5060)
+* depth, interpolation:                  Calling Macros.    (line  4929)
+* depth, of last glyph (.cdp):           Environments.      (line 11388)
+* DESC file format:                      DESC File Format.  (line 13425)
+* DESC file, and font mounting:          Font Positions.    (line  7590)
+* DESC file, and use_charnames_in_special keyword: Postprocessor Access.
+                                                            (line 11760)
+* description file, font:                Using Fonts.       (line  7295)
+* device description files, comments:    DESC File Format.  (line 13432)
+* device request, and copy mode:         Postprocessor Access.
+                                                            (line 11744)
+* device resolution:                     Page Geometry.     (line  4169)
+* device resolution <1>:                 DESC File Format.  (line 13506)
+* device resolution, obtaining in the formatter: Measurements.
+                                                            (line  4240)
+* devices for output:                    Output Device Intro.
+                                                            (line   359)
+* dg glyph, at end of sentence:          Sentences.         (line  3663)
+* dg glyph, at end of sentence <1>:      Using Symbols.     (line  7892)
+* di request, and warnings:              Warnings.          (line 12296)
+* di request, and warnings <1>:          Warnings.          (line 12301)
+* differences in implementation:         Implementation Differences.
+                                                            (line 12388)
+* digit-width space (\0):                Page Motions.      (line 10014)
+* digits, as delimiters:                 Delimiters.        (line  5090)
+* dimensions, line:                      Line Layout.       (line  6855)
+* directories for fonts:                 Font Directories.  (line   934)
+* directories for macros:                Macro Directories. (line   898)
+* directory, current:                    Macro Directories. (line   910)
+* directory, for tmac files:             Macro Directories. (line   900)
+* directory, home:                       Macro Directories. (line   913)
+* directory, platform-specific:          Macro Directories. (line   915)
+* directory, site-local:                 Macro Directories. (line   915)
+* directory, site-local <1>:             Font Directories.  (line   957)
+* disabling hyphenation (\%):            Manipulating Hyphenation.
+                                                            (line  5992)
+* disabling \ (eo):                      Using Escape Sequences.
+                                                            (line  5007)
+* discardable horizontal space:          Manipulating Filling and Adjustment.
+                                                            (line  5914)
+* displays:                              Displays and Keeps.
+                                                            (line  1290)
+* displays ms:                         ms keeps and displays.
+                                                            (line  2797)
+* displays, and footnotes ms:          ms Footnotes.      (line  2958)
+* distance to next vertical position trap register (.t): Page Location Traps.
+                                                            (line 10520)
+* diversion:                             Deferring Output.  (line 10337)
+* diversion name register (.z):          Diversions.        (line 11000)
+* diversion trap, setting (dt):          Diversion Traps.   (line 10668)
+* diversion traps:                       Diversion Traps.   (line 10663)
+* diversion, appending to (da, boxa):    Diversions.        (line 10944)
+* diversion, beginning (di, box):        Diversions.        (line 10944)
+* diversion, creating alias for (als):   Strings.           (line  8972)
+* diversion, ending (di, box):           Diversions.        (line 10944)
+* diversion, nested:                     Diversions.        (line 11000)
+* diversion, removing (rm):              Strings.           (line  8967)
+* diversion, removing alias for (rm):    Strings.           (line  9007)
+* diversion, renaming (rn):              Strings.           (line  8964)
+* diversion, stripping final newline:    Punning Names.     (line 11246)
+* diversion, top-level:                  Diversions.        (line 10930)
+* diversion, top-level, and bp:          Page Control.      (line  7183)
+* diversion, top-level, and \!:          Diversions.        (line 11098)
+* diversion, top-level, and \?:          Diversions.        (line 11103)
+* diversion, unformatting (asciify):     Diversions.        (line 11120)
+* diversion, vertical position in, register (.d): Diversions.
+                                                            (line 11000)
+* diversions:                            Diversions.        (line 10918)
+* diversions <1>:                        Punning Names.     (line 11157)
+* diversions, and traps:                 Page Location Traps.
+                                                            (line 10618)
+* diversions, shared name space with macros and strings: Identifiers.
+                                                            (line  4668)
+* division, truncating:                  Numeric Expressions.
+                                                            (line  4359)
+* dl register, and da (boxa):            Diversions.        (line 11026)
+* dn register, and da (boxa):            Diversions.        (line 11026)
+* document description macros, ms:     ms Document Description Macros.
+                                                            (line  2132)
+* document formats:                      Document Formats.  (line  1349)
+* documents, multi-file:                 Debugging.         (line 12103)
+* documents, structuring the source of:  Invoking Requests. (line  4803)
+* dot, as delimiter:                     Delimiters.        (line  5090)
+* double quote, embedding in a macro argument: Calling Macros.
+                                                            (line  4875)
+* double quotes, trailing, in strings:   Strings.           (line  8844)
+* double-spacing (ls):                   Manipulating Spacing.
+                                                            (line  6396)
+* double-spacing (vs, pvs):              Changing the Vertical Spacing.
+                                                            (line  8575)
+* down-casing a string (stringdown):     Strings.           (line  8945)
+* drawing a filled circle (\D'C ...'):   Drawing Geometric Objects.
+                                                            (line 10234)
+* drawing a filled ellipse (\D'E ...'):  Drawing Geometric Objects.
+                                                            (line 10241)
+* drawing a filled polygon (\D'P ...'):  Drawing Geometric Objects.
+                                                            (line 10275)
+* drawing a line (\D'l ...'):            Drawing Geometric Objects.
+                                                            (line 10244)
+* drawing a solid circle (\D'C ...'):    Drawing Geometric Objects.
+                                                            (line 10234)
+* drawing a solid ellipse (\D'E ...'):   Drawing Geometric Objects.
+                                                            (line 10241)
+* drawing a solid polygon (\D'P ...'):   Drawing Geometric Objects.
+                                                            (line 10275)
+* drawing a spline (\D'~ ...'):          Drawing Geometric Objects.
+                                                            (line 10221)
+* drawing a stroked circle (\D'c ...'):  Drawing Geometric Objects.
+                                                            (line 10230)
+* drawing a stroked ellipse (\D'e ...'): Drawing Geometric Objects.
+                                                            (line 10237)
+* drawing a stroked polygon (\D'p ...'): Drawing Geometric Objects.
+                                                            (line 10269)
+* drawing an arc (\D'a ...'):            Drawing Geometric Objects.
+                                                            (line 10225)
+* drawing an outlined circle (\D'c ...'): Drawing Geometric Objects.
+                                                            (line 10230)
+* drawing an outlined ellipse (\D'e ...'): Drawing Geometric Objects.
+                                                            (line 10237)
+* drawing an outlined polygon (\D'p ...'): Drawing Geometric Objects.
+                                                            (line 10269)
+* drawing horizontal lines (\l):         Drawing Geometric Objects.
+                                                            (line 10142)
+* drawing position:                      Page Geometry.     (line  4181)
+* drawing position, vertical (nl):       Page Control.      (line  7240)
+* drawing requests:                      Drawing Geometric Objects.
+                                                            (line 10130)
+* drawing vertical lines (\L):           Drawing Geometric Objects.
+                                                            (line 10168)
+* ds request, and comments:              Strings.           (line  8823)
+* ds request, and double quotes:         Strings.           (line  8844)
+* ds request, and leading spaces:        Strings.           (line  8844)
+* ds, ds1 requests, and comments:        Comments.          (line  5139)
+* ds, ds1 requests, and warnings:        Warnings.          (line 12301)
+* dummy character (\&):                  Dummy Characters.  (line  8357)
+* dummy character (\&), as control character suppressor: Requests and Macros.
+                                                            (line  3820)
+* dummy character (\&), effect on kerning: Ligatures and Kerning.
+                                                            (line  8294)
+* dummy character (\&), effect on \l escape sequence: Drawing Geometric Objects.
+                                                            (line 10150)
+* dummy character, transparent (\)):     Dummy Characters.  (line  8407)
+* dummy environment, used by \w escape sequence: Page Motions.
+                                                            (line 10034)
+* dumping environments (pev):            Debugging.         (line 12150)
+* dumping page location traps (ptr):     Debugging.         (line 12162)
+* dumping registers (pnr):               Debugging.         (line 12158)
+* dumping symbol table (pm):             Debugging.         (line 12154)
+* EBCDIC output encoding:                Groff Options.     (line   755)
+* EBCDIC, input encoding:                Input Encodings.   (line  3986)
+* ejection, page:                        Page Geometry.     (line  4208)
+* ejection, page <1>:                    Page Control.      (line  7170)
+* ejection, page <2>:                    The Implicit Page Trap.
+                                                            (line 10638)
+* ejection, page, of final page:         End-of-input Traps.
+                                                            (line 10834)
+* ejection, page, prevented by vpt:      Vertical Position Traps.
+                                                            (line 10414)
+* el request, and warnings:              Warnings.          (line 12273)
+* ellipse, filled, drawing (\D'E ...'):  Drawing Geometric Objects.
+                                                            (line 10241)
+* ellipse, outlined, drawing (\D'e ...'): Drawing Geometric Objects.
+                                                            (line 10237)
+* ellipse, solid, drawing (\D'E ...'):   Drawing Geometric Objects.
+                                                            (line 10241)
+* ellipse, stroked, drawing (\D'e ...'): Drawing Geometric Objects.
+                                                            (line 10237)
+* em glyph, and cflags:                  Using Symbols.     (line  7875)
+* em scaling unit (m):                   Measurements.      (line  4277)
+* embolding of special fonts:            Artificial Fonts.  (line  8230)
+* empty line:                            Breaking.          (line  3749)
+* en scaling unit (n):                   Measurements.      (line  4281)
+* enabling vertical position traps (vpt): Vertical Position Traps.
+                                                            (line 10407)
+* encoding, input, code page 1047:       Input Encodings.   (line  3986)
+* encoding, input, EBCDIC:               Input Encodings.   (line  3986)
+* encoding, input, Latin-1 (ISO 8859-1): Input Encodings.   (line  3991)
+* encoding, input, Latin-2 (ISO 8859-2): Input Encodings.   (line  4004)
+* encoding, input, Latin-5 (ISO 8859-9): Input Encodings.   (line  4010)
+* encoding, input, Latin-9 (ISO 8859-15): Input Encodings.  (line  4015)
+* encoding, output, ASCII:               Groff Options.     (line   743)
+* encoding, output, code page 1047:      Groff Options.     (line   755)
+* encoding, output, EBCDIC:              Groff Options.     (line   755)
+* encoding, output, ISO 646:             Groff Options.     (line   743)
+* encoding, output, Latin-1 (ISO 8859-1): Groff Options.    (line   747)
+* encoding, output, UTF-8:               Groff Options.     (line   751)
+* end of conditional block (\}):         Conditional Blocks.
+                                                            (line  9250)
+* end-of-input macro (em):               End-of-input Traps.
+                                                            (line 10807)
+* end-of-input trap, setting (em):       End-of-input Traps.
+                                                            (line 10807)
+* end-of-input traps:                    End-of-input Traps.
+                                                            (line 10806)
+* end-of-sentence characters:            Sentences.         (line  3619)
+* end-of-sentence characters <1>:        Using Symbols.     (line  7863)
+* end-of-sentence transparent characters: Sentences.        (line  3663)
+* ending diversion (di, box):            Diversions.        (line 10944)
+* endnotes:                              Footnotes and Endnotes.
+                                                            (line  1313)
+* environment:                           Deferring Output.  (line 10337)
+* environment availability and naming, incompatibilities with: Other Differences.
+                                                            (line 12583)
+* environment number/name register (.ev): Environments.     (line 11309)
+* environment variables:                 Environment.       (line   827)
+* environment, copying (evc):            Environments.      (line 11362)
+* environment, dimensions of last glyph (.w, .cht, .cdp, .csk): Environments.
+                                                            (line 11388)
+* environment, dummy, used by \w escape sequence: Page Motions.
+                                                            (line 10034)
+* environment, previous line length (.n): Environments.     (line 11403)
+* environment, switching (ev):           Environments.      (line 11309)
+* environments:                          Environments.      (line 11268)
+* environments, dumping (pev):           Debugging.         (line 12150)
+* equality operator:                     Numeric Expressions.
+                                                            (line  4416)
+* equation example ms:                 ms Insertions.     (line  2903)
+* equations ms:                        ms Insertions.     (line  2844)
+* escape character, changing (ec):       Using Escape Sequences.
+                                                            (line  5012)
+* escape character, formatting (\e):     Using Escape Sequences.
+                                                            (line  4999)
+* escape character, while defining glyph: Using Symbols.    (line  7948)
+* escape sequence:                       Formatter Instructions.
+                                                            (line  4714)
+* escape sequence argument delimiters:   Delimiters.        (line  5060)
+* escape sequences:                      Using Escape Sequences.
+                                                            (line  4942)
+* escape sequences, brace (\{, \}):      Conditional Blocks.
+                                                            (line  9250)
+* escaping newline characters, in strings: Strings.         (line  8853)
+* ex request, use in debugging:          Debugging.         (line 12132)
+* ex request, used with nx and rd:       I/O.               (line 11591)
+* example markup, bulleted list ms:    Lists in ms.       (line  2590)
+* example markup, cover page in ms:    ms Document Description Macros.
+                                                            (line  2196)
+* example markup, glossary-style list ms: Lists in ms.    (line  2637)
+* example markup, numbered list ms:    Lists in ms.       (line  2609)
+* examples of invocation:                Invocation Examples.
+                                                            (line  1002)
+* exiting (ex):                          Debugging.         (line 12132)
+* expansion of strings (\*):             Strings.           (line  8802)
+* explicit hyphen (\%):                  Manipulating Hyphenation.
+                                                            (line  6277)
+* explicit hyphenation:                  Manipulating Hyphenation.
+                                                            (line  5948)
+* expression, limitation of logical not in: Numeric Expressions.
+                                                            (line  4426)
+* expression, order of evaluation:       Numeric Expressions.
+                                                            (line  4446)
+* expressions, and register format:      Assigning Register Formats.
+                                                            (line  5484)
+* expressions, and space characters:     Numeric Expressions.
+                                                            (line  4538)
+* expressions, conditional:              Operators in Conditionals.
+                                                            (line  9027)
+* expressions, numeric:                  Numeric Expressions.
+                                                            (line  4348)
+* extra post-vertical line space (\x):   Changing the Vertical Spacing.
+                                                            (line  8568)
+* extra post-vertical line space register (.a): Manipulating Spacing.
+                                                            (line  6420)
+* extra pre-vertical line space (\x):    Changing the Vertical Spacing.
+                                                            (line  8560)
+* extra spaces between words:            Adjustment.        (line  3775)
+* extreme values representable with Roman numerals: Assigning Register Formats.
+                                                            (line  5465)
+* extremum operators (>?, <?):           Numeric Expressions.
+                                                            (line  4407)
+* f scaling unit:                        Colors.            (line  8712)
+* factor, zoom, of a font (fzoom):       Selecting Fonts.   (line  7421)
+* fallback character, defining (fchar, fschar, schar): Using Symbols.
+                                                            (line  7948)
+* fallback glyph, removing definition (rchar, rfschar): Using Symbols.
+                                                            (line  8005)
+* fam request, and changing fonts:       Selecting Fonts.   (line  7352)
+* families, font:                        Font Families.     (line  7448)
+* family, font:                          Using Fonts.       (line  7280)
+* features, common:                      Common Features.   (line  1201)
+* fi request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* field delimiting character (fc):       Fields.            (line  6692)
+* field padding character (fc):          Fields.            (line  6692)
+* fields:                                Fields.            (line  6692)
+* fields, and tabs:                      Tabs and Fields.   (line  6481)
+* figure space (\0):                     Page Motions.      (line 10014)
+* figures ms:                          ms Insertions.     (line  2844)
+* file formats:                          File Formats.      (line 12674)
+* file names, breaking (\:):             Manipulating Hyphenation.
+                                                            (line  6008)
+* file, appending to (opena):            I/O.               (line 11671)
+* file, closing (close):                 I/O.               (line 11703)
+* file, font description:                Using Fonts.       (line  7295)
+* file, inclusion (so):                  I/O.               (line 11473)
+* file, macro, search path:              Macro Directories. (line   900)
+* file, opening (open):                  I/O.               (line 11671)
+* file, processing next (nx):            I/O.               (line 11553)
+* file, writing to (write, writec):      I/O.               (line 11683)
+* files, font:                           Device and Font Description Files.
+                                                            (line 13401)
+* fill color:                            Colors.            (line  8678)
+* fill color name register (.M):         Colors.            (line  8765)
+* fill mode (fi), enabling:              Manipulating Filling and Adjustment.
+                                                            (line  5685)
+* fill mode, and \c:                     Line Continuation. (line  7054)
+* fill mode, disabling:                  Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* filled circle, drawing (\D'C ...'):    Drawing Geometric Objects.
+                                                            (line 10234)
+* filled ellipse, drawing (\D'E ...'):   Drawing Geometric Objects.
+                                                            (line 10241)
+* filled polygon, drawing (\D'P ...'):   Drawing Geometric Objects.
+                                                            (line 10275)
+* filling:                               Filling.           (line  3581)
+* filling and adjustment, manipulating:  Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* filling of output, disabling (nf):     Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* filling of output, enabling (fi):      Manipulating Filling and Adjustment.
+                                                            (line  5685)
+* filling, and break warnings:           Warnings.          (line 12262)
+* filling, and inter-sentence space:     Manipulating Filling and Adjustment.
+                                                            (line  5898)
+* final newline, stripping in diversions: Punning Names.    (line 11246)
+* fl request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* floating keep:                         Displays and Keeps.
+                                                            (line  1301)
+* flush output (fl):                     Debugging.         (line 12167)
+* font:                                  Using Fonts.       (line  7280)
+* font aliasing with third argument to fp request: Font Positions.
+                                                            (line  7561)
+* font description file:                 Using Fonts.       (line  7295)
+* font description file format:          DESC File Format.  (line 13425)
+* font description file, format:         Font Description File Format.
+                                                            (line 13572)
+* font description files, comments:      Font Description File Format.
+                                                            (line 13592)
+* font directories:                      Font Directories.  (line   934)
+* font families:                         Font Families.     (line  7448)
+* font family:                           Using Fonts.       (line  7280)
+* font family, changing (fam, \F):       Font Families.     (line  7467)
+* font file, format:                     Font Description File Format.
+                                                            (line 13572)
+* font files:                            Device and Font Description Files.
+                                                            (line 13401)
+* font for underlining (uf):             Artificial Fonts.  (line  8206)
+* font height, changing (\H):            Artificial Fonts.  (line  8132)
+* font metrics:                          Using Fonts.       (line  7295)
+* font mounting, automatic:              Selecting Fonts.   (line  7365)
+* font path:                             Font Directories.  (line   942)
+* font position register (.f):           Font Positions.    (line  7578)
+* font positions:                        Font Positions.    (line  7540)
+* font slant, changing (\S):             Artificial Fonts.  (line  8161)
+* font style:                            Using Fonts.       (line  7280)
+* font style, abstract:                  Using Fonts.       (line  7302)
+* font style, abstract, setting up (sty): Font Families.    (line  7505)
+* font styles:                           Font Families.     (line  7448)
+* font translation (ftr):                Selecting Fonts.   (line  7406)
+* font, magnification (fzoom):           Selecting Fonts.   (line  7421)
+* font, mounting (fp):                   Font Positions.    (line  7552)
+* font, optical size:                    Selecting Fonts.   (line  7421)
+* font, previous, selecting (\f, \fP): Selecting Fonts.   (line  7378)
+* font, previous, slecting (ft):         Selecting Fonts.   (line  7352)
+* font, selection:                       Selecting Fonts.   (line  7343)
+* font, special:                         Using Fonts.       (line  7280)
+* font, text:                            Using Fonts.       (line  7280)
+* font, unstyled:                        Using Fonts.       (line  7280)
+* font, zoom factor (fzoom):             Selecting Fonts.   (line  7421)
+* fonts, artificial:                     Artificial Fonts.  (line  8122)
+* fonts, changing (ft, \f):              Selecting Fonts.   (line  7352)
+* fonts, searching:                      Font Directories.  (line   934)
+* fonts, special:                        Special Fonts.     (line  8092)
+* footers:                               Page Layout.       (line  7115)
+* footers <1>:                           Page Location Traps.
+                                                            (line 10440)
+* footers ms:                          ms Headers and Footers.
+                                                            (line  3052)
+* footnote marker ms:                  ms Footnotes.      (line  2920)
+* footnotes:                             Footnotes and Endnotes.
+                                                            (line  1313)
+* footnotes ms:                        ms Footnotes.      (line  2920)
+* footnotes, and displays ms:          ms Footnotes.      (line  2958)
+* footnotes, and keeps ms:             ms Footnotes.      (line  2958)
+* form letters:                          I/O.               (line 11575)
+* format of font description file:       DESC File Format.  (line 13425)
+* format of font description files:      Font Description File Format.
+                                                            (line 13572)
+* format of font files:                  Font Description File Format.
+                                                            (line 13572)
+* format of register (\g):               Assigning Register Formats.
+                                                            (line  5479)
+* format, paper:                         Paper Format.      (line   972)
+* formats, file:                         File Formats.      (line 12674)
+* formatter instructions:                Formatter Instructions.
+                                                            (line  4703)
+* formatting a backslash glyph (\rs):  Using Escape Sequences.
+                                                            (line  5002)
+* formatting a title line (tl):          Page Layout.       (line  7120)
+* formatting the escape character (\e):  Using Escape Sequences.
+                                                            (line  4999)
+* formatting the time:                   I/O.               (line 11656)
+* fp request, and font translations:     Selecting Fonts.   (line  7406)
+* fp request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12609)
+* fractional point sizes:                Using Fractional Type Sizes.
+                                                            (line  8597)
+* fractional point sizes <1>:            Other Differences. (line 12587)
+* fractional type sizes:                 Using Fractional Type Sizes.
+                                                            (line  8597)
+* fractional type sizes <1>:             Other Differences. (line 12587)
+* fractional type sizes in ms macros:    Differences from AT&T ms.
+                                                            (line  3315)
+* French spacing:                        Sentences.         (line  3619)
+* fspecial request, and font styles:     Font Families.     (line  7505)
+* fspecial request, and font translations: Selecting Fonts. (line  7406)
+* fspecial request, and glyph search order: Using Symbols.  (line  7612)
+* fspecial request, and imitating bold:  Artificial Fonts.  (line  8230)
+* ft request, and font translations:     Selecting Fonts.   (line  7406)
+* full-service macro package:            Major Macro Packages.
+                                                            (line  1397)
+* geometry, page:                        Page Geometry.     (line  4162)
+* GGL (groff glyph list):                Using Symbols.     (line  7688)
+* GGL (groff glyph list) <1>:            Character Classes. (line  8055)
+* glossary-style list, example markup ms: Lists in ms.    (line  2637)
+* glyph:                                 Using Symbols.     (line  7600)
+* glyph for line drawing:                Drawing Geometric Objects.
+                                                            (line 10168)
+* glyph names, composite:                Using Symbols.     (line  7688)
+* glyph pile (\b):                       Drawing Geometric Objects.
+                                                            (line 10308)
+* glyph properties (cflags):             Using Symbols.     (line  7846)
+* glyph, box rule (\br):               Drawing Geometric Objects.
+                                                            (line 10168)
+* glyph, constant space:                 Artificial Fonts.  (line  8241)
+* glyph, defining (char):                Using Symbols.     (line  7948)
+* glyph, distinguished from character:   Using Symbols.     (line  7600)
+* glyph, for line drawing:               Drawing Geometric Objects.
+                                                            (line 10146)
+* glyph, for margins (mc):               Miscellaneous.     (line 11897)
+* glyph, last, dimensions (.w, .cht, .cdp, .csk): Environments.
+                                                            (line 11388)
+* glyph, leader repetition (lc):         Leaders.           (line  6661)
+* glyph, numbered (\N):                  Character Translations.
+                                                            (line  6741)
+* glyph, numbered (\N) <1>:              Using Symbols.     (line  7810)
+* glyph, removing definition (rchar, rfschar): Using Symbols.
+                                                            (line  8005)
+* glyph, soft hyphen (hy):               Manipulating Hyphenation.
+                                                            (line  6032)
+* glyph, tab repetition (tc):            Tabs and Fields.   (line  6602)
+* glyph, underscore (\ru):             Drawing Geometric Objects.
+                                                            (line 10146)
+* glyphs, available, list of (groff_char(7) man page): Using Symbols.
+                                                            (line  7675)
+* glyphs, output, and input characters, compatibility with AT&T troff: Other Differences.
+                                                            (line 12609)
+* glyphs, overstriking (\o):             Page Motions.      (line 10097)
+* glyphs, unnamed:                       Using Symbols.     (line  7820)
+* glyphs, unnamed, accessing with \N:    Font Description File Format.
+                                                            (line 13639)
+* GNU troff, identification register (.g): Built-in Registers.
+                                                            (line  5539)
+* GNU troff, PID register ($$):          Built-in Registers.
+                                                            (line  5571)
+* GNU troff, process ID register ($$):   Built-in Registers.
+                                                            (line  5571)
+* GNU-specific register (.g):            Built-in Registers.
+                                                            (line  5539)
+* graphic renditions:                    Using Fonts.       (line  7323)
+* greater than (or equal to) operator:   Numeric Expressions.
+                                                            (line  4416)
+* groff capabilities:                    groff Capabilities.
+                                                            (line   281)
+* groff glyph list (GGL):                Using Symbols.     (line  7688)
+* groff glyph list (GGL) <1>:            Character Classes. (line  8055)
+* groff invocation:                      Invoking groff.    (line   454)
+* groff, and pi request:                 I/O.               (line 11629)
+* groff--what is it?:                    What Is groff?.    (line   264)
+* GROFF_BIN_PATH, environment variable:  Environment.       (line   831)
+* GROFF_COMMAND_PREFIX, environment variable: Environment.  (line   835)
+* GROFF_ENCODING, environment variable:  Environment.       (line   846)
+* GROFF_FONT_PATH, environment variable: Environment.       (line   855)
+* GROFF_FONT_PATH, environment variable <1>: Font Directories.
+                                                            (line   955)
+* GROFF_TMAC_PATH, environment variable: Environment.       (line   862)
+* GROFF_TMAC_PATH, environment variable <1>: Macro Directories.
+                                                            (line   908)
+* GROFF_TMPDIR, environment variable:    Environment.       (line   869)
+* GROFF_TYPESETTER, environment variable: Environment.      (line   877)
+* grohtml, the program:                  Groff Options.     (line   766)
+* gtroff, interactive use:               Debugging.         (line 12167)
+* gtroff, output:                        gtroff Output.     (line 12680)
+* gtroff, reference:                     GNU troff Reference.
+                                                            (line  3549)
+* hair space (\^):                       Page Motions.      (line 10008)
+* hcode request, and glyph definitions:  Using Symbols.     (line  7948)
+* headers:                               Page Layout.       (line  7115)
+* headers <1>:                           Page Location Traps.
+                                                            (line 10440)
+* headers ms:                          ms Headers and Footers.
+                                                            (line  3052)
+* height, font, changing (\H):           Artificial Fonts.  (line  8132)
+* height, of last glyph (.cht):          Environments.      (line 11388)
+* high-water mark register (.h):         Diversions.        (line 11007)
+* home directory:                        Macro Directories. (line   913)
+* horizontal discardable space:          Manipulating Filling and Adjustment.
+                                                            (line  5914)
+* horizontal input line position register (hp): Page Motions.
+                                                            (line 10090)
+* horizontal input line position, saving (\k): Page Motions.
+                                                            (line 10084)
+* horizontal line, drawing (\l):         Drawing Geometric Objects.
+                                                            (line 10142)
+* horizontal motion (\h):                Page Motions.      (line  9982)
+* horizontal motion quantum:             DESC File Format.  (line 13445)
+* horizontal motion quantum register (.H): Motion Quanta.   (line  4299)
+* horizontal output line position register (.k): Page Motions.
+                                                            (line 10093)
+* horizontal resolution:                 DESC File Format.  (line 13445)
+* horizontal resolution register (.H):   Motion Quanta.     (line  4299)
+* horizontal space (\h):                 Page Motions.      (line  9982)
+* horizontal space, unformatting:        Punning Names.     (line 11246)
+* horizontal tab character:              Tabs and Leaders.  (line  3785)
+* hours, current time (hours):           Built-in Registers.
+                                                            (line  5586)
+* hpf request, and hyphenation language: Manipulating Hyphenation.
+                                                            (line  6263)
+* hw request, and hy restrictions:       Manipulating Hyphenation.
+                                                            (line  5970)
+* hw request, and hyphenation language:  Manipulating Hyphenation.
+                                                            (line  6263)
+* hy glyph, and cflags:                  Using Symbols.     (line  7875)
+* hyphen, explicit (\%):                 Manipulating Hyphenation.
+                                                            (line  6277)
+* hyphenated lines, consecutive (hlm):   Manipulating Hyphenation.
+                                                            (line  6277)
+* hyphenating characters:                Using Symbols.     (line  7868)
+* hyphenation:                           Hyphenation.       (line  3707)
+* hyphenation character (\%):            Manipulating Hyphenation.
+                                                            (line  5992)
+* hyphenation code (hcode):              Manipulating Hyphenation.
+                                                            (line  6228)
+* hyphenation consecutive line count register (.hlc): Manipulating Hyphenation.
+                                                            (line  6284)
+* hyphenation consecutive line limit register (.hlm): Manipulating Hyphenation.
+                                                            (line  6284)
+* hyphenation exceptions:                Manipulating Hyphenation.
+                                                            (line  5956)
+* hyphenation language register (.hla):  Manipulating Hyphenation.
+                                                            (line  6270)
+* hyphenation margin (hym):              Manipulating Hyphenation.
+                                                            (line  6290)
+* hyphenation margin register (.hym):    Manipulating Hyphenation.
+                                                            (line  6300)
+* hyphenation mode register (.hy):       Manipulating Hyphenation.
+                                                            (line  6054)
+* hyphenation parameters, automatic:     Manipulating Hyphenation.
+                                                            (line  6042)
+* hyphenation pattern files:             Manipulating Hyphenation.
+                                                            (line  6116)
+* hyphenation patterns (hpf):            Manipulating Hyphenation.
+                                                            (line  6170)
+* hyphenation space (hys):               Manipulating Hyphenation.
+                                                            (line  6305)
+* hyphenation space adjustment threshold: Manipulating Hyphenation.
+                                                            (line  6305)
+* hyphenation space adjustment threshold register (.hys): Manipulating Hyphenation.
+                                                            (line  6316)
+* hyphenation, automatic:                Manipulating Hyphenation.
+                                                            (line  5941)
+* hyphenation, disabling (\%):           Manipulating Hyphenation.
+                                                            (line  5992)
+* hyphenation, explicit:                 Manipulating Hyphenation.
+                                                            (line  5948)
+* hyphenation, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12557)
+* hyphenation, manipulating:             Manipulating Hyphenation.
+                                                            (line  5941)
+* hyphenation, manual:                   Manipulating Hyphenation.
+                                                            (line  5948)
+* i scaling unit:                        Measurements.      (line  4249)
+* i/o:                                   I/O.               (line 11469)
+* IBM code page 1047 input encoding:     Input Encodings.   (line  3986)
+* IBM code page 1047 output encoding:    Groff Options.     (line   755)
+* identifiers:                           Identifiers.       (line  4574)
+* identifiers, undefined:                Identifiers.       (line  4656)
+* ie request, and font translations:     Selecting Fonts.   (line  7406)
+* ie request, and warnings:              Warnings.          (line 12273)
+* ie request, operators to use with:     Operators in Conditionals.
+                                                            (line  9027)
+* if request, and font translations:     Selecting Fonts.   (line  7406)
+* if request, and the ! operator:        Numeric Expressions.
+                                                            (line  4365)
+* if request, operators to use with:     Operators in Conditionals.
+                                                            (line  9027)
+* if-else:                               if-else.           (line  9211)
+* if-then:                               if-then.           (line  9170)
+* imitating boldface (bd):               Artificial Fonts.  (line  8213)
+* implementation differences:            Implementation Differences.
+                                                            (line 12388)
+* implicit line break:                   Breaking.          (line  3725)
+* implicit trap:                         The Implicit Page Trap.
+                                                            (line 10638)
+* in request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* in request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* inch scaling unit (i):                 Measurements.      (line  4249)
+* including a file (so):                 I/O.               (line 11473)
+* incompatibilities with AT&T troff:     Implementation Differences.
+                                                            (line 12388)
+* increment value without changing the register: Auto-increment.
+                                                            (line  5403)
+* incrementation, automatic, of a register: Auto-increment. (line  5364)
+* indentation (in):                      Line Layout.       (line  6874)
+* indentation, of roff source code:      Invoking Requests. (line  4803)
+* index, in macro package:               Indexing.          (line  1340)
+* indicator, scaling:                    Measurements.      (line  4232)
+* indirect assignments:                  Interpolating Registers.
+                                                            (line  5340)
+* input and output requests:             I/O.               (line 11469)
+* input characters and output glyphs, compatibility with AT&T troff: Other Differences.
+                                                            (line 12609)
+* input characters, invalid:             Identifiers.       (line  4581)
+* input conventions:                     Input Conventions. (line  4051)
+* input encoding, code page 1047:        Input Encodings.   (line  3986)
+* input encoding, EBCDIC:                Input Encodings.   (line  3986)
+* input encoding, Latin-1 (ISO 8859-1):  Input Encodings.   (line  3991)
+* input encoding, Latin-2 (ISO 8859-2):  Input Encodings.   (line  4004)
+* input encoding, Latin-5 (ISO 8859-9):  Input Encodings.   (line  4010)
+* input encoding, Latin-9 (ISO 8859-15): Input Encodings.   (line  4015)
+* input file name, current, register (.F): Built-in Registers.
+                                                            (line  5536)
+* input level:                           Calling Macros.    (line  4929)
+* input level in delimited arguments:    Compatibility Mode.
+                                                            (line 12498)
+* input line continuation (\<RET>):      Line Continuation. (line  7019)
+* input line number register (.c, c.):   Built-in Registers.
+                                                            (line  5532)
+* input line number, setting (lf):       Debugging.         (line 12103)
+* input line position, horizontal, saving (\k): Page Motions.
+                                                            (line 10084)
+* input line trap, clearing (it, itc):   Input Line Traps.  (line 10680)
+* input line trap, setting (it, itc):    Input Line Traps.  (line 10680)
+* input line traps:                      Input Line Traps.  (line 10678)
+* input line traps and interrupted lines (itc): Input Line Traps.
+                                                            (line 10704)
+* input line, horizontal position, register (hp): Page Motions.
+                                                            (line 10090)
+* input line, productive:                Manipulating Filling and Adjustment.
+                                                            (line  5797)
+* input stack, backtrace (backtrace):    Debugging.         (line 12176)
+* input stack, setting limit:            Debugging.         (line 12197)
+* input token:                           Gtroff Internals.  (line 11970)
+* input, 8-bit:                          Font Description File Format.
+                                                            (line 13639)
+* input, standard, reading from (rd):    I/O.               (line 11558)
+* inserting horizontal space (\h):       Page Motions.      (line  9982)
+* installation:                          Installation.      (line   370)
+* instructing the formatter:             Formatter Instructions.
+                                                            (line  4703)
+* inter-sentence space size register (.sss): Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* inter-sentence space, additional:      Manipulating Filling and Adjustment.
+                                                            (line  5893)
+* inter-word spacing, minimal:           Manipulating Filling and Adjustment.
+                                                            (line  5891)
+* interactive use of gtroff:             Debugging.         (line 12167)
+* intercepting requests:                 Control Characters.
+                                                            (line  4765)
+* intermediate output:                   gtroff Output.     (line 12690)
+* interpolating registers (\n):          Interpolating Registers.
+                                                            (line  5335)
+* interpolation:                         Requests and Macros.
+                                                            (line  3840)
+* interpolation depth:                   Calling Macros.    (line  4929)
+* interpolation depth in delimited arguments: Compatibility Mode.
+                                                            (line 12498)
+* interpolation of strings (\*):         Strings.           (line  8802)
+* interpretation mode:                   Copy Mode.         (line  9708)
+* interrupted line:                      Line Continuation. (line  7048)
+* interrupted line register (.int):      Line Continuation. (line  7073)
+* interrupted lines and input line traps (itc): Input Line Traps.
+                                                            (line 10704)
+* introduction:                          Introduction.      (line   222)
+* invalid characters for trf request:    I/O.               (line 11533)
+* invalid input characters:              Identifiers.       (line  4581)
+* invocation examples:                   Invocation Examples.
+                                                            (line  1002)
+* invoking groff:                        Invoking groff.    (line   454)
+* invoking requests:                     Invoking Requests. (line  4781)
+* ISO 646 output encoding:               Groff Options.     (line   743)
+* ISO 8859-1 (Latin-1) output encoding:  Groff Options.     (line   747)
+* ISO 8859-1 (Latin-1), input encoding:  Input Encodings.   (line  3991)
+* ISO 8859-15 (Latin-9), input encoding: Input Encodings.   (line  4015)
+* ISO 8859-2 (Latin-2), input encoding:  Input Encodings.   (line  4004)
+* ISO 8859-9 (Latin-5), input encoding:  Input Encodings.   (line  4010)
+* italic correction (\/):                Italic Corrections.
+                                                            (line  8328)
+* justifying text:                       Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* justifying text (rj):                  Manipulating Filling and Adjustment.
+                                                            (line  5866)
+* keep, floating:                        Displays and Keeps.
+                                                            (line  1301)
+* keeps (introduction):                  Displays and Keeps.
+                                                            (line  1297)
+* keeps ms:                            ms keeps and displays.
+                                                            (line  2743)
+* keeps, and footnotes ms:             ms Footnotes.      (line  2958)
+* kerning and ligatures:                 Ligatures and Kerning.
+                                                            (line  8253)
+* kerning enabled register (.kern):      Ligatures and Kerning.
+                                                            (line  8289)
+* kerning, activating (kern):            Ligatures and Kerning.
+                                                            (line  8289)
+* kerning, track:                        Ligatures and Kerning.
+                                                            (line  8300)
+* landscape page orientation:            Paper Format.      (line   972)
+* language ms:                         ms language and localization.
+                                                            (line  3003)
+* last glyph, dimensions (.w, .cht, .cdp, .csk): Environments.
+                                                            (line 11388)
+* last-requested point size registers (.psr, .sr): Using Fractional Type Sizes.
+                                                            (line  8638)
+* last-requested type size registers (.psr, .sr): Using Fractional Type Sizes.
+                                                            (line  8638)
+* Latin-1 (ISO 8859-1) output encoding:  Groff Options.     (line   747)
+* Latin-1 (ISO 8859-1), input encoding:  Input Encodings.   (line  3991)
+* Latin-2 (ISO 8859-2), input encoding:  Input Encodings.   (line  4004)
+* Latin-5 (ISO 8859-9), input encoding:  Input Encodings.   (line  4010)
+* Latin-9 (ISO 8859-15), input encoding: Input Encodings.   (line  4015)
+* layout, line:                          Line Layout.       (line  6855)
+* layout, page:                          Page Layout.       (line  7087)
+* lc request, and glyph definitions:     Using Symbols.     (line  7948)
+* leader character:                      Tabs and Leaders.  (line  3785)
+* leader character <1>:                  Leaders.           (line  6652)
+* leader character, and translations:    Character Translations.
+                                                            (line  6751)
+* leader character, non-interpreted (\a): Leaders.          (line  6658)
+* leader repetition character (lc):      Leaders.           (line  6661)
+* leaders:                               Leaders.           (line  6645)
+* leading:                               Manipulating Type Size and Vertical Spacing.
+                                                            (line  8444)
+* leading space macro (lsm):             Breaking.          (line  3757)
+* leading space traps:                   Leading Space Traps.
+                                                            (line 10788)
+* leading spaces:                        Breaking.          (line  3757)
+* leading spaces macro (lsm):            Leading Space Traps.
+                                                            (line 10791)
+* leading spaces with ds:                Strings.           (line  8844)
+* left italic correction (\,):           Italic Corrections.
+                                                            (line  8338)
+* left margin (po):                      Line Layout.       (line  6870)
+* length of a string (length):           Strings.           (line  8909)
+* length of line (ll):                   Line Layout.       (line  6878)
+* length of previous line (.n):          Environments.      (line 11403)
+* length of the page, configuring (pl):  Page Layout.       (line  7093)
+* length of title line, configuring (lt): Page Layout.      (line  7137)
+* length request, and copy mode:         Strings.           (line  8909)
+* less than (or equal to) operator:      Numeric Expressions.
+                                                            (line  4416)
+* letters, form:                         I/O.               (line 11575)
+* level, input:                          Calling Macros.    (line  4929)
+* level, suppression nesting, register:  Suppressing Output.
+                                                            (line 11463)
+* lf request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12579)
+* ligature:                              Using Symbols.     (line  7600)
+* ligatures and kerning:                 Ligatures and Kerning.
+                                                            (line  8253)
+* ligatures enabled register (.lg):      Ligatures and Kerning.
+                                                            (line  8271)
+* ligatures, activating (lg):            Ligatures and Kerning.
+                                                            (line  8271)
+* limitations of \b escape sequence:     Drawing Geometric Objects.
+                                                            (line 10316)
+* line break:                            Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* line break (introduction):             Basics.            (line  1188)
+* line break, output:                    Breaking.          (line  3725)
+* line control:                          Line Continuation. (line  7014)
+* line dimensions:                       Line Layout.       (line  6855)
+* line drawing glyph:                    Drawing Geometric Objects.
+                                                            (line 10146)
+* line drawing glyph <1>:                Drawing Geometric Objects.
+                                                            (line 10168)
+* line indentation (in):                 Line Layout.       (line  6874)
+* line layout:                           Line Layout.       (line  6855)
+* line length (ll):                      Line Layout.       (line  6878)
+* line length register (.l):             Line Layout.       (line  7003)
+* line length, previous (.n):            Environments.      (line 11403)
+* line number, input, register (.c, c.): Built-in Registers.
+                                                            (line  5532)
+* line number, output, register (ln):    Miscellaneous.     (line 11820)
+* line numbers, printing (nm):           Miscellaneous.     (line 11798)
+* line space, extra post-vertical (\x):  Changing the Vertical Spacing.
+                                                            (line  8568)
+* line space, extra pre-vertical (\x):   Changing the Vertical Spacing.
+                                                            (line  8560)
+* line spacing register (.L):            Manipulating Spacing.
+                                                            (line  6400)
+* line spacing, post-vertical (pvs):     Changing the Vertical Spacing.
+                                                            (line  8572)
+* line thickness (\D't ...'):            Drawing Geometric Objects.
+                                                            (line 10298)
+* line, blank:                           Breaking.          (line  3749)
+* line, drawing (\D'l ...'):             Drawing Geometric Objects.
+                                                            (line 10244)
+* line, horizontal, drawing (\l):        Drawing Geometric Objects.
+                                                            (line 10142)
+* line, input, continuation (\<RET>):    Line Continuation. (line  7019)
+* line, input, horizontal position, register (hp): Page Motions.
+                                                            (line 10090)
+* line, input, horizontal position, saving (\k): Page Motions.
+                                                            (line 10084)
+* line, interrupted:                     Line Continuation. (line  7048)
+* line, output, continuation (\c):       Line Continuation. (line  7048)
+* line, output, horizontal position, register (.k): Page Motions.
+                                                            (line 10093)
+* line, productive input:                Manipulating Filling and Adjustment.
+                                                            (line  5797)
+* line, vertical, drawing (\L):          Drawing Geometric Objects.
+                                                            (line 10168)
+* line-tabs mode:                        Tabs and Fields.   (line  6615)
+* lines, blank, disabling:               Manipulating Spacing.
+                                                            (line  6456)
+* lines, centering (ce):                 Manipulating Filling and Adjustment.
+                                                            (line  5827)
+* lines, centering (introduction):       Basics.            (line  1170)
+* lines, consecutive hyphenated (hlm):   Manipulating Hyphenation.
+                                                            (line  6277)
+* lines, interrupted, and input line traps (itc): Input Line Traps.
+                                                            (line 10704)
+* lines, right-aligning (introduction):  Basics.            (line  1182)
+* lines, right-justifying (introduction): Basics.           (line  1182)
+* list of special characters (groff_char(7) man page): Using Symbols.
+                                                            (line  7675)
+* listing page location traps (ptr):     Debugging.         (line 12162)
+* lists:                                 Paragraphs.        (line  1228)
+* ll request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* localization:                          Manipulating Hyphenation.
+                                                            (line  6215)
+* localization ms:                     ms language and localization.
+                                                            (line  3003)
+* locating macro files:                  Macro Directories. (line   900)
+* locating macro packages:               Macro Directories. (line   900)
+* location, vertical, page, marking (mk): Page Motions.     (line  9868)
+* location, vertical, page, returning to marked (rt): Page Motions.
+                                                            (line  9868)
+* logical "and" operator:                Numeric Expressions.
+                                                            (line  4422)
+* logical "or" operator:                 Numeric Expressions.
+                                                            (line  4422)
+* logical complementation operator:      Numeric Expressions.
+                                                            (line  4426)
+* logical conjunction operator:          Numeric Expressions.
+                                                            (line  4422)
+* logical disjunction operator:          Numeric Expressions.
+                                                            (line  4422)
+* logical not, limitation in expression: Numeric Expressions.
+                                                            (line  4426)
+* logical operators:                     Numeric Expressions.
+                                                            (line  4422)
+* long names:                            Compatibility Mode.
+                                                            (line 12404)
+* loops and conditionals:                Conditionals and Loops.
+                                                            (line  9020)
+* lowercasing a string (stringdown):     Strings.           (line  8945)
+* ls request, alternative to (pvs):      Changing the Vertical Spacing.
+                                                            (line  8584)
+* lt request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* m scaling unit:                        Measurements.      (line  4277)
+* M scaling unit:                        Measurements.      (line  4287)
+* machine units:                         Page Geometry.     (line  4169)
+* macro:                                 Requests and Macros.
+                                                            (line  3840)
+* macro arguments:                       Calling Macros.    (line  4851)
+* macro arguments, and compatibility mode: Gtroff Internals.
+                                                            (line 12054)
+* macro arguments, and tabs:             Invoking Requests. (line  4789)
+* macro directories:                     Macro Directories. (line   898)
+* macro file search path:                Macro Directories. (line   900)
+* macro name register (\$0):             Parameters.        (line  9657)
+* macro names, starting with  or , and refer: Identifiers.
+                                                            (line  4623)
+* macro package:                         Macro Packages.    (line  3963)
+* macro package search path:             Macro Directories. (line   900)
+* macro package usage, basics of:        Basics.            (line  1058)
+* macro package, auxiliary:              Major Macro Packages.
+                                                            (line  1408)
+* macro package, full-service:           Major Macro Packages.
+                                                            (line  1397)
+* macro package, introduction:           Macro Package Intro.
+                                                            (line   316)
+* macro package, major:                  Major Macro Packages.
+                                                            (line  1394)
+* macro package, minor:                  Major Macro Packages.
+                                                            (line  1408)
+* macro package, structuring the source of: Invoking Requests.
+                                                            (line  4803)
+* macro, appending to (am):              Writing Macros.    (line  9533)
+* macro, creating alias for (als):       Strings.           (line  8972)
+* macro, end-of-input (em):              End-of-input Traps.
+                                                            (line 10807)
+* macro, parameters (\$):                Parameters.        (line  9616)
+* macro, removing (rm):                  Strings.           (line  8967)
+* macro, removing alias for (rm):        Strings.           (line  9007)
+* macro, renaming (rn):                  Strings.           (line  8964)
+* macros, recursive:                     while.             (line  9359)
+* macros, searching:                     Macro Directories. (line   898)
+* macros, shared name space with strings and diversions: Identifiers.
+                                                            (line  4668)
+* macros, tutorial for users:            Tutorial for Macro Users.
+                                                            (line  1046)
+* macros, writing:                       Writing Macros.    (line  9410)
+* magnification of a font (fzoom):       Selecting Fonts.   (line  7421)
+* major macro package:                   Major Macro Packages.
+                                                            (line  1394)
+* major version number register (.x):    Built-in Registers.
+                                                            (line  5559)
+* man macros, custom headers and footers: Optional man extensions.
+                                                            (line  1433)
+* man macros, Ultrix-specific:           Optional man extensions.
+                                                            (line  1451)
+* man pages:                             man.               (line  1417)
+* manipulating filling and adjustment:   Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* manipulating hyphenation:              Manipulating Hyphenation.
+                                                            (line  5941)
+* manipulating spacing:                  Manipulating Spacing.
+                                                            (line  6344)
+* manipulating type size and vertical spacing: Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* manual hyphenation:                    Manipulating Hyphenation.
+                                                            (line  5948)
+* manual pages:                          man.               (line  1417)
+* margin for hyphenation (hym):          Manipulating Hyphenation.
+                                                            (line  6290)
+* margin glyph (mc):                     Miscellaneous.     (line 11897)
+* margin, bottom:                        Page Location Traps.
+                                                            (line 10440)
+* margin, left (po):                     Line Layout.       (line  6870)
+* margin, right:                         Line Layout.       (line  6881)
+* margin, top:                           Page Location Traps.
+                                                            (line 10440)
+* mark, high-water, register (.h):       Diversions.        (line 11007)
+* marker, footnote ms:                 ms Footnotes.      (line  2920)
+* marking vertical page location (mk):   Page Motions.      (line  9868)
+* maximum operator:                      Numeric Expressions.
+                                                            (line  4407)
+* maximum value representable with Roman numerals: Assigning Register Formats.
+                                                            (line  5465)
+* mdoc macros:                           mdoc.              (line  1552)
+* me macro package:                      me.                (line  1559)
+* measurement units:                     Measurements.      (line  4232)
+* measurements:                          Measurements.      (line  4232)
+* measurements, specifying safely:       Default Units.     (line  4341)
+* metrics, font:                         Using Fonts.       (line  7295)
+* minimal inter-word spacing:            Manipulating Filling and Adjustment.
+                                                            (line  5891)
+* minimum operator:                      Numeric Expressions.
+                                                            (line  4407)
+* minimum value representable with Roman numerals: Assigning Register Formats.
+                                                            (line  5465)
+* minor macro package:                   Major Macro Packages.
+                                                            (line  1408)
+* minor version number register (.y):    Built-in Registers.
+                                                            (line  5563)
+* minutes, current time (minutes):       Built-in Registers.
+                                                            (line  5583)
+* mm macro package:                      mm.                (line  1571)
+* mode for constant glyph space (cs):    Artificial Fonts.  (line  8241)
+* mode, compatibility:                   Compatibility Mode.
+                                                            (line 12404)
+* mode, compatibility, and parameters:   Gtroff Internals.  (line 12054)
+* mode, copy:                            Copy Mode.         (line  9699)
+* mode, copy <1>:                        Copy Mode.         (line  9699)
+* mode, copy, and cf request:            I/O.               (line 11521)
+* mode, copy, and device request:        Postprocessor Access.
+                                                            (line 11744)
+* mode, copy, and length request:        Strings.           (line  8909)
+* mode, copy, and macro parameters:      Parameters.        (line  9616)
+* mode, copy, and output request:        Diversions.        (line 11106)
+* mode, copy, and trf request:           I/O.               (line 11521)
+* mode, copy, and write request:         I/O.               (line 11683)
+* mode, copy, and writec request:        I/O.               (line 11683)
+* mode, copy, and writem request:        I/O.               (line 11697)
+* mode, copy, and \!:                    Diversions.        (line 11074)
+* mode, copy, and \?:                    Operators in Conditionals.
+                                                            (line  9116)
+* mode, copy, and \? <1>:                Diversions.        (line 11074)
+* mode, copy, and \a:                    Leaders.           (line  6658)
+* mode, copy, and \t:                    Tabs and Fields.   (line  6485)
+* mode, copy, and \V:                    I/O.               (line 11721)
+* mode, fill (fi), enabling:             Manipulating Filling and Adjustment.
+                                                            (line  5685)
+* mode, fill, and break warnings:        Warnings.          (line 12262)
+* mode, fill, and inter-sentence space:  Manipulating Filling and Adjustment.
+                                                            (line  5898)
+* mode, fill, and \c:                    Line Continuation. (line  7054)
+* mode, fill, disabling:                 Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* mode, interpretation:                  Copy Mode.         (line  9708)
+* mode, line-tabs:                       Tabs and Fields.   (line  6615)
+* mode, no-fill:                         Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* mode, no-fill, and \c:                 Line Continuation. (line  7062)
+* mode, no-space (ns):                   Manipulating Spacing.
+                                                            (line  6456)
+* mode, nroff:                           troff and nroff Modes.
+                                                            (line  6813)
+* mode, safer:                           Groff Options.     (line   707)
+* mode, safer <1>:                       Macro Directories. (line   910)
+* mode, safer <2>:                       Built-in Registers.
+                                                            (line  5555)
+* mode, safer <3>:                       I/O.               (line 11504)
+* mode, safer <4>:                       I/O.               (line 11616)
+* mode, safer <5>:                       I/O.               (line 11638)
+* mode, safer <6>:                       I/O.               (line 11677)
+* mode, safer <7>:                       Safer Mode.        (line 12395)
+* mode, troff:                           troff and nroff Modes.
+                                                            (line  6813)
+* mode, unsafe:                          Groff Options.     (line   783)
+* mode, unsafe <1>:                      Macro Directories. (line   910)
+* mode, unsafe <2>:                      Built-in Registers.
+                                                            (line  5555)
+* mode, unsafe <3>:                      I/O.               (line 11504)
+* mode, unsafe <4>:                      I/O.               (line 11616)
+* mode, unsafe <5>:                      I/O.               (line 11638)
+* mode, unsafe <6>:                      I/O.               (line 11677)
+* modifying requests:                    Control Characters.
+                                                            (line  4765)
+* modulus:                               Numeric Expressions.
+                                                            (line  4359)
+* mom macro package:                     mom.               (line  1581)
+* month of the year register (mo):       Built-in Registers.
+                                                            (line  5595)
+* motion operators:                      Numeric Expressions.
+                                                            (line  4457)
+* motion quanta:                         Motion Quanta.     (line  4292)
+* motion quantum, horizontal:            DESC File Format.  (line 13445)
+* motion quantum, horizontal, register (.H): Motion Quanta. (line  4299)
+* motion quantum, vertical:              DESC File Format.  (line 13553)
+* motion, horizontal (\h):               Page Motions.      (line  9982)
+* motion, vertical (\v):                 Page Motions.      (line  9938)
+* motions, page:                         Page Motions.      (line  9863)
+* mounting a font (fp):                  Font Positions.    (line  7552)
+* mounting position:                     Using Fonts.       (line  7295)
+* mounting position <1>:                 Using Fonts.       (line  7295)
+* mounting, font, automatic:             Selecting Fonts.   (line  7365)
+* ms macros:                             ms.                (line  1603)
+* ms macros, accent marks:               ms Legacy Features.
+                                                            (line  3405)
+* ms macros, body text:                  ms Body Text.      (line  2231)
+* ms macros, creating table of contents: ms TOC.            (line  3139)
+* ms macros, displays:                   ms keeps and displays.
+                                                            (line  2743)
+* ms macros, document control settings:  ms Document Control Settings.
+                                                            (line  1794)
+* ms macros, document description:       ms Document Description Macros.
+                                                            (line  2132)
+* ms macros, equations:                  ms Insertions.     (line  2844)
+* ms macros, figures:                    ms Insertions.     (line  2844)
+* ms macros, footers:                    ms Headers and Footers.
+                                                            (line  3052)
+* ms macros, footnotes:                  ms Footnotes.      (line  2920)
+* ms macros, fractional type sizes in:   Differences from AT&T ms.
+                                                            (line  3315)
+* ms macros, general structure:          ms Document Structure.
+                                                            (line  1747)
+* ms macros, groff differences from AT&T: Differences from AT&T ms.
+                                                            (line  3276)
+* ms macros, headers:                    ms Headers and Footers.
+                                                            (line  3052)
+* ms macros, headings:                   Headings in ms.    (line  2352)
+* ms macros, keeps:                      ms keeps and displays.
+                                                            (line  2743)
+* ms macros, language:                   ms language and localization.
+                                                            (line  3003)
+* ms macros, lists:                      Lists in ms.       (line  2582)
+* ms macros, localization:               ms language and localization.
+                                                            (line  3003)
+* ms macros, margins:                    ms Margins.        (line  3109)
+* ms macros, multiple columns:           ms Multiple Columns.
+                                                            (line  3117)
+* ms macros, naming conventions:         ms Naming Conventions.
+                                                            (line  3520)
+* ms macros, nested lists:               Indented regions in ms.
+                                                            (line  2713)
+* ms macros, obtaining typographical symbols: Typographical symbols in ms.
+                                                            (line  2261)
+* ms macros, page layout:                ms Page Layout.    (line  3045)
+* ms macros, paragraph handling:         Paragraphs in ms.  (line  2277)
+* ms macros, references:                 ms Insertions.     (line  2844)
+* ms macros, special characters:         ms Legacy Features.
+                                                            (line  3405)
+* ms macros, strings:                    ms Legacy Features.
+                                                            (line  3405)
+* ms macros, tables:                     ms Insertions.     (line  2844)
+* ms macros, text settings:              Text settings in ms.
+                                                            (line  2239)
+* multi-file documents:                  Debugging.         (line 12103)
+* multi-line strings:                    Strings.           (line  8853)
+* multi-page table example ms:         ms Insertions.     (line  2886)
+* multiple columns ms:                 ms Multiple Columns.
+                                                            (line  3117)
+* multiplication:                        Numeric Expressions.
+                                                            (line  4359)
+* n scaling unit:                        Measurements.      (line  4281)
+* name space, common, of macros, diversions, and strings: Identifiers.
+                                                            (line  4668)
+* name, background color, register (.M): Colors.            (line  8765)
+* name, fill color, register (.M):       Colors.            (line  8765)
+* name, stroke color, register (.m):     Colors.            (line  8744)
+* named character (\C):                  Using Symbols.     (line  7793)
+* names, long:                           Compatibility Mode.
+                                                            (line 12404)
+* naming conventions, ms macros:         ms Naming Conventions.
+                                                            (line  3520)
+* ne request, and the .trunc register:   Page Location Traps.
+                                                            (line 10587)
+* ne request, comparison with sv:        Page Control.      (line  7230)
+* negating register values:              Setting Registers. (line  5289)
+* negation:                              Numeric Expressions.
+                                                            (line  4365)
+* nested assignments:                    Interpolating Registers.
+                                                            (line  5340)
+* nested diversions:                     Diversions.        (line 11000)
+* nested lists ms:                     Indented regions in ms.
+                                                            (line  2713)
+* nesting level, suppression, register:  Suppressing Output.
+                                                            (line 11463)
+* new page (bp):                         Page Control.      (line  7178)
+* newline character, and translations:   Character Translations.
+                                                            (line  6751)
+* newline character, in strings, escaping: Strings.         (line  8853)
+* newline, as delimiter:                 Delimiters.        (line  5076)
+* newline, final, stripping in diversions: Punning Names.   (line 11246)
+* next file, processing (nx):            I/O.               (line 11553)
+* next free font position register (.fp): Font Positions.   (line  7589)
+* next page number register (.pn):       Page Layout.       (line  7112)
+* next page number, configuring (pn):    Page Layout.       (line  7107)
+* nf request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* nl register, and .d:                   Diversions.        (line 11000)
+* nl register, difference from .h:       Diversions.        (line 11020)
+* nm request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* no-break control character ('):        Requests and Macros.
+                                                            (line  3813)
+* no-break control character, changing (c2): Control Characters.
+                                                            (line  4738)
+* no-fill mode:                          Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* no-fill mode, and \c:                  Line Continuation. (line  7062)
+* no-space mode (ns):                    Manipulating Spacing.
+                                                            (line  6456)
+* node, output:                          Gtroff Internals.  (line 11970)
+* non-printing break point (\:):         Manipulating Hyphenation.
+                                                            (line  6008)
+* nr request, and warnings:              Warnings.          (line 12313)
+* nr request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* nroff mode:                            troff and nroff Modes.
+                                                            (line  6813)
+* number formats, assigning to register (af): Assigning Register Formats.
+                                                            (line  5413)
+* number of registers register (.R):     Built-in Registers.
+                                                            (line  5547)
+* number, input line, setting (lf):      Debugging.         (line 12103)
+* number, page, next, configuring (pn):  Page Layout.       (line  7107)
+* numbered glyph (\N):                   Character Translations.
+                                                            (line  6741)
+* numbered glyph (\N) <1>:               Using Symbols.     (line  7810)
+* numbered list, example markup ms:    Lists in ms.       (line  2609)
+* numbers, line, printing (nm):          Miscellaneous.     (line 11798)
+* numeral-width space (\0):              Page Motions.      (line 10014)
+* numerals, as delimiters:               Delimiters.        (line  5090)
+* numerals, Roman:                       Assigning Register Formats.
+                                                            (line  5433)
+* numeric expression, valid:             Numeric Expressions.
+                                                            (line  4522)
+* numeric expressions:                   Numeric Expressions.
+                                                            (line  4348)
+* object creation:                       Writing Macros.    (line  9558)
+* offset, page:                          Page Geometry.     (line  4193)
+* offset, page (po):                     Line Layout.       (line  6870)
+* open request, and safer mode:          Groff Options.     (line   707)
+* opena request, and safer mode:         Groff Options.     (line   707)
+* opening brace escape sequence (\}):    Conditional Blocks.
+                                                            (line  9250)
+* opening file (open):                   I/O.               (line 11671)
+* operator, scaling:                     Numeric Expressions.
+                                                            (line  4390)
+* operators, arithmetic:                 Numeric Expressions.
+                                                            (line  4359)
+* operators, as delimiters:              Delimiters.        (line  5092)
+* operators, comparison:                 Numeric Expressions.
+                                                            (line  4416)
+* operators, extremum (>?, <?):          Numeric Expressions.
+                                                            (line  4407)
+* operators, logical:                    Numeric Expressions.
+                                                            (line  4422)
+* operators, motion:                     Numeric Expressions.
+                                                            (line  4457)
+* operators, unary arithmetic:           Numeric Expressions.
+                                                            (line  4365)
+* optical size of a font:                Selecting Fonts.   (line  7421)
+* options:                               Groff Options.     (line   478)
+* order of evaluation in expressions:    Numeric Expressions.
+                                                            (line  4446)
+* ordinary character:                    Identifiers.       (line  4577)
+* orientation, landscape:                Paper Format.      (line   972)
+* orphan:                                Page Control.      (line  7222)
+* orphan lines, preventing with ne:      Page Control.      (line  7195)
+* os request, and no-space mode:         Page Control.      (line  7233)
+* outlined circle, drawing (\D'c ...'):  Drawing Geometric Objects.
+                                                            (line 10230)
+* outlined ellipse, drawing (\D'e ...'): Drawing Geometric Objects.
+                                                            (line 10237)
+* outlined polygon, drawing (\D'p ...'): Drawing Geometric Objects.
+                                                            (line 10269)
+* output and input requests:             I/O.               (line 11469)
+* output comparison operator:            Operators in Conditionals.
+                                                            (line  9080)
+* output device name string (.T):        Groff Options.     (line   772)
+* output device name string (.T) <1>:    Strings.           (line  8787)
+* output device name string (.T), in other implementations: Other Differences.
+                                                            (line 12564)
+* output device usage register (.T):     Groff Options.     (line   772)
+* output device usage register (.T), incompatibility with AT&T troff: Other Differences.
+                                                            (line 12574)
+* output devices:                        Output Device Intro.
+                                                            (line   359)
+* output encoding, ASCII:                Groff Options.     (line   743)
+* output encoding, code page 1047:       Groff Options.     (line   755)
+* output encoding, EBCDIC:               Groff Options.     (line   755)
+* output encoding, ISO 646:              Groff Options.     (line   743)
+* output encoding, Latin-1 (ISO 8859-1): Groff Options.     (line   747)
+* output encoding, UTF-8:                Groff Options.     (line   751)
+* output glyphs, and input characters, compatibility with AT&T troff: Other Differences.
+                                                            (line 12609)
+* output line break:                     Breaking.          (line  3725)
+* output line number register (ln):      Miscellaneous.     (line 11820)
+* output line properties:                Manipulating Filling and Adjustment.
+                                                            (line  5644)
+* output line, continuation (\c):        Line Continuation. (line  7048)
+* output line, horizontal position, register (.k): Page Motions.
+                                                            (line 10093)
+* output node:                           Gtroff Internals.  (line 11970)
+* output request, and copy mode:         Diversions.        (line 11106)
+* output request, and \!:                Diversions.        (line 11106)
+* output, filling, disablement of (nf):  Manipulating Filling and Adjustment.
+                                                            (line  5692)
+* output, filling, enablement of (fi):   Manipulating Filling and Adjustment.
+                                                            (line  5685)
+* output, flush (fl):                    Debugging.         (line 12167)
+* output, gtroff:                        gtroff Output.     (line 12680)
+* output, intermediate:                  gtroff Output.     (line 12690)
+* output, suppressing (\O):              Suppressing Output.
+                                                            (line 11410)
+* output, transparent (cf, trf):         I/O.               (line 11521)
+* output, transparent (\!, \?):          Diversions.        (line 11066)
+* output, transparent, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12636)
+* output, troff:                         gtroff Output.     (line 12690)
+* overlapping characters:                Using Symbols.     (line  7882)
+* overstriking glyphs (\o):              Page Motions.      (line 10097)
+* p scaling unit:                        Measurements.      (line  4255)
+* P scaling unit:                        Measurements.      (line  4259)
+* package, macro:                        Macro Packages.    (line  3963)
+* package, macro, auxiliary:             Major Macro Packages.
+                                                            (line  1408)
+* package, macro, full-service:          Major Macro Packages.
+                                                            (line  1397)
+* package, macro, introduction:          Macro Package Intro.
+                                                            (line   316)
+* package, macro, major:                 Major Macro Packages.
+                                                            (line  1394)
+* package, macro, minor:                 Major Macro Packages.
+                                                            (line  1408)
+* package, macro, search path:           Macro Directories. (line   900)
+* package, package, structuring the source of: Invoking Requests.
+                                                            (line  4803)
+* padding character, for fields (fc):    Fields.            (line  6692)
+* page:                                  Page Geometry.     (line  4175)
+* page break:                            Page Geometry.     (line  4208)
+* page break <1>:                        Page Control.      (line  7170)
+* page break <2>:                        The Implicit Page Trap.
+                                                            (line 10638)
+* page break (introduction):             Basics.            (line  1185)
+* page break, conditional (ne):          Page Control.      (line  7195)
+* page break, final:                     End-of-input Traps.
+                                                            (line 10834)
+* page break, prevented by vpt:          Vertical Position Traps.
+                                                            (line 10414)
+* page control:                          Page Control.      (line  7170)
+* page ejection:                         Page Geometry.     (line  4208)
+* page ejection <1>:                     Page Control.      (line  7170)
+* page ejection <2>:                     The Implicit Page Trap.
+                                                            (line 10638)
+* page ejection status register (.pe):   Page Location Traps.
+                                                            (line 10598)
+* page ejection, of final page:          End-of-input Traps.
+                                                            (line 10834)
+* page ejection, prevented by vpt:       Vertical Position Traps.
+                                                            (line 10414)
+* page footers:                          Page Location Traps.
+                                                            (line 10440)
+* page headers:                          Page Location Traps.
+                                                            (line 10440)
+* page layout:                           Page Layout.       (line  7087)
+* page layout ms:                      ms Page Layout.    (line  3045)
+* page length register (.p):             Page Layout.       (line  7101)
+* page length, configuring (pl):         Page Layout.       (line  7093)
+* page location traps:                   Page Location Traps.
+                                                            (line 10420)
+* page location traps, debugging:        Page Location Traps.
+                                                            (line 10476)
+* page location, vertical, marking (mk): Page Motions.      (line  9868)
+* page location, vertical, returning to marked (rt): Page Motions.
+                                                            (line  9868)
+* page motions:                          Page Motions.      (line  9863)
+* page number character (%):             Page Layout.       (line  7120)
+* page number character, changing (pc):  Page Layout.       (line  7149)
+* page number register (%):              Page Control.      (line  7188)
+* page number, configuring next (pn):    Page Layout.       (line  7107)
+* page number, next, register (.pn):     Page Layout.       (line  7112)
+* page offset:                           Page Geometry.     (line  4193)
+* page offset (po):                      Line Layout.       (line  6870)
+* page orientation, landscape:           Paper Format.      (line   972)
+* page, geometry of:                     Page Geometry.     (line  4162)
+* page, new (bp):                        Page Control.      (line  7178)
+* paper format:                          Paper Format.      (line   972)
+* paper size:                            Paper Format.      (line   972)
+* paragraphs:                            Paragraphs.        (line  1220)
+* parameter count register (.$):         Parameters.        (line  9594)
+* parameters:                            Parameters.        (line  9586)
+* parameters, and compatibility mode:    Gtroff Internals.  (line 12054)
+* parameters, macro (\$):                Parameters.        (line  9616)
+* parentheses:                           Numeric Expressions.
+                                                            (line  4446)
+* partially collected line:              Manipulating Filling and Adjustment.
+                                                            (line  5644)
+* path, for font files:                  Font Directories.  (line   942)
+* path, for tmac files:                  Macro Directories. (line   900)
+* pattern files, for hyphenation:        Manipulating Hyphenation.
+                                                            (line  6116)
+* patterns for hyphenation (hpf):        Manipulating Hyphenation.
+                                                            (line  6170)
+* pending output line:                   Manipulating Filling and Adjustment.
+                                                            (line  5644)
+* pi request, and groff:                 I/O.               (line 11629)
+* pi request, and safer mode:            Groff Options.     (line   707)
+* pi request, disabled by default:       Safer Mode.        (line 12395)
+* pica scaling unit (P):                 Measurements.      (line  4259)
+* PID of GNU troff register ($$):        Built-in Registers.
+                                                            (line  5571)
+* pile, glyph (\b):                      Drawing Geometric Objects.
+                                                            (line 10308)
+* pl request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* plain text approximation output register (.A): Groff Options.
+                                                            (line   521)
+* plain text approximation output register (.A) <1>: Built-in Registers.
+                                                            (line  5527)
+* planting a trap:                       Traps.             (line 10393)
+* platform-specific directory:           Macro Directories. (line   915)
+* pm request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12600)
+* pn request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* PNG image generation from PostScript:  DESC File Format.  (line 13449)
+* po request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* point scaling unit (p):                Measurements.      (line  4255)
+* point size registers (.s, .ps):        Changing the Type Size.
+                                                            (line  8480)
+* point size registers, last-requested (.psr, .sr): Using Fractional Type Sizes.
+                                                            (line  8638)
+* point sizes, changing (ps, \s):        Changing the Type Size.
+                                                            (line  8466)
+* point sizes, fractional:               Using Fractional Type Sizes.
+                                                            (line  8597)
+* point sizes, fractional <1>:           Other Differences. (line 12587)
+* polygon, filled, drawing (\D'P ...'):  Drawing Geometric Objects.
+                                                            (line 10275)
+* polygon, outlined, drawing (\D'p ...'): Drawing Geometric Objects.
+                                                            (line 10269)
+* polygon, solid, drawing (\D'P ...'):   Drawing Geometric Objects.
+                                                            (line 10275)
+* polygon, stroked, drawing (\D'p ...'): Drawing Geometric Objects.
+                                                            (line 10269)
+* position of lowest text line (.h):     Diversions.        (line 11007)
+* position, absolute (sic) operator (|): Numeric Expressions.
+                                                            (line  4471)
+* position, drawing:                     Page Geometry.     (line  4181)
+* position, horizontal input line, saving (\k): Page Motions.
+                                                            (line 10084)
+* position, horizontal, in input line, register (hp): Page Motions.
+                                                            (line 10090)
+* position, horizontal, in output line, register (.k): Page Motions.
+                                                            (line 10093)
+* position, mounting:                    Using Fonts.       (line  7295)
+* position, vertical, in diversion, register (.d): Diversions.
+                                                            (line 11000)
+* positions, font:                       Font Positions.    (line  7540)
+* post-vertical line spacing:            Changing the Vertical Spacing.
+                                                            (line  8572)
+* post-vertical line spacing register (.pvs): Changing the Vertical Spacing.
+                                                            (line  8584)
+* post-vertical line spacing, changing (pvs): Changing the Vertical Spacing.
+                                                            (line  8584)
+* postprocessor access:                  Postprocessor Access.
+                                                            (line 11729)
+* postprocessors:                        Output Device Intro.
+                                                            (line   359)
+* PostScript, bounding box:              Miscellaneous.     (line 11949)
+* PostScript, PNG image generation:      DESC File Format.  (line 13449)
+* prefix, for commands:                  Environment.       (line   835)
+* preprocessors:                         Preprocessor Intro.
+                                                            (line   328)
+* previous font, selecting (ft):         Selecting Fonts.   (line  7352)
+* previous font, selecting (\f, \fP):  Selecting Fonts.   (line  7378)
+* previous line length (.n):             Environments.      (line 11403)
+* print current page register (.P):      Groff Options.     (line   670)
+* printing backslash (\\, \e, \E, \rs): Other Differences.
+                                                            (line 12636)
+* printing line numbers (nm):            Miscellaneous.     (line 11798)
+* printing to stderr (tm, tm1, tmc):     Debugging.         (line 12117)
+* printing, zero-width (\z, \Z):         Page Motions.      (line 10102)
+* printing, zero-width (\z, \Z) <1>:     Page Motions.      (line 10107)
+* process ID of GNU troff register ($$): Built-in Registers.
+                                                            (line  5571)
+* processing next file (nx):             I/O.               (line 11553)
+* productive input line:                 Manipulating Filling and Adjustment.
+                                                            (line  5797)
+* properties of characters (cflags):     Using Symbols.     (line  7846)
+* properties of glyphs (cflags):         Using Symbols.     (line  7846)
+* properties of output lines:            Manipulating Filling and Adjustment.
+                                                            (line  5644)
+* ps request, and constant glyph space mode: Artificial Fonts.
+                                                            (line  8241)
+* ps request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12587)
+* ps request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* ps request, with fractional type sizes: Using Fractional Type Sizes.
+                                                            (line  8604)
+* pso request, and safer mode:           Groff Options.     (line   707)
+* pvs request, using + and - with:       Numeric Expressions.
+                                                            (line  4463)
+* quanta, motion:                        Motion Quanta.     (line  4292)
+* quantum, horizontal motion:            DESC File Format.  (line 13445)
+* quantum, vertical motion:              DESC File Format.  (line 13553)
+* radicalex glyph, and cflags:           Using Symbols.     (line  7882)
+* ragged-left text:                      Manipulating Filling and Adjustment.
+                                                            (line  5723)
+* ragged-right text:                     Manipulating Filling and Adjustment.
+                                                            (line  5720)
+* rc request, and glyph definitions:     Using Symbols.     (line  7948)
+* read-only register removal, incompatibility with AT&T troff: Other Differences.
+                                                            (line 12571)
+* read-only register, changing format:   Assigning Register Formats.
+                                                            (line  5472)
+* reading from standard input (rd):      I/O.               (line 11558)
+* recursive macros:                      while.             (line  9359)
+* refer, and macro names starting with  or : Identifiers. (line  4623)
+* reference, gtroff:                     GNU troff Reference.
+                                                            (line  3549)
+* references ms:                       ms Insertions.     (line  2844)
+* register format, in expressions:       Assigning Register Formats.
+                                                            (line  5484)
+* register, assigning number format to (af): Assigning Register Formats.
+                                                            (line  5413)
+* register, built-in, removing:          Built-in Registers.
+                                                            (line  5513)
+* register, creating alias for (aln):    Setting Registers. (line  5323)
+* register, format (\g):                 Assigning Register Formats.
+                                                            (line  5479)
+* register, read-only, removal, incompatibility with AT&T troff: Other Differences.
+                                                            (line 12571)
+* register, removing (rr):               Setting Registers. (line  5312)
+* register, removing alias for (rr):     Setting Registers. (line  5329)
+* register, renaming (rnn):              Setting Registers. (line  5318)
+* registers:                             Registers.         (line  5210)
+* registers, built-in:                   Built-in Registers.
+                                                            (line  5508)
+* registers, dumping (pnr):              Debugging.         (line 12158)
+* registers, interpolating (\n):         Interpolating Registers.
+                                                            (line  5335)
+* registers, number of, register (.R):   Built-in Registers.
+                                                            (line  5547)
+* registers, setting (nr, \R):           Setting Registers. (line  5219)
+* removal of read-only registers, incompatibility with AT&T troff: Other Differences.
+                                                            (line 12571)
+* removing a built-in register:          Built-in Registers.
+                                                            (line  5513)
+* removing a register (rr):              Setting Registers. (line  5312)
+* removing alias for register (rr):      Setting Registers. (line  5329)
+* removing alias, for diversion (rm):    Strings.           (line  9007)
+* removing alias, for macro (rm):        Strings.           (line  9007)
+* removing alias, for string (rm):       Strings.           (line  9007)
+* removing diversion (rm):               Strings.           (line  8967)
+* removing glyph definition (rchar, rfschar): Using Symbols.
+                                                            (line  8005)
+* removing macro (rm):                   Strings.           (line  8967)
+* removing request (rm):                 Strings.           (line  8967)
+* removing string (rm):                  Strings.           (line  8967)
+* renaming a register (rnn):             Setting Registers. (line  5318)
+* renaming diversion (rn):               Strings.           (line  8964)
+* renaming macro (rn):                   Strings.           (line  8964)
+* renaming request (rn):                 Strings.           (line  8964)
+* renaming string (rn):                  Strings.           (line  8964)
+* renditions, graphic:                   Using Fonts.       (line  7323)
+* request:                               Requests and Macros.
+                                                            (line  3813)
+* request <1>:                           Formatter Instructions.
+                                                            (line  4708)
+* request arguments:                     Invoking Requests. (line  4789)
+* request arguments, and compatibility mode: Gtroff Internals.
+                                                            (line 12054)
+* request arguments, and tabs:           Invoking Requests. (line  4789)
+* request, removing (rm):                Strings.           (line  8967)
+* request, renaming (rn):                Strings.           (line  8964)
+* request, undefined:                    Comments.          (line  5150)
+* requests for drawing:                  Drawing Geometric Objects.
+                                                            (line 10130)
+* requests for input and output:         I/O.               (line 11469)
+* requests, intercepting:                Control Characters.
+                                                            (line  4765)
+* requests, invoking:                    Invoking Requests. (line  4781)
+* requests, modifying:                   Control Characters.
+                                                            (line  4765)
+* resolution, device:                    Page Geometry.     (line  4169)
+* resolution, device <1>:                DESC File Format.  (line 13506)
+* resolution, device, obtaining in the formatter: Measurements.
+                                                            (line  4240)
+* resolution, horizontal:                DESC File Format.  (line 13445)
+* resolution, horizontal, register (.H): Motion Quanta.     (line  4299)
+* resolution, vertical:                  DESC File Format.  (line 13553)
+* returning to marked vertical page location (rt): Page Motions.
+                                                            (line  9868)
+* revision number register (.Y):         Built-in Registers.
+                                                            (line  5567)
+* right margin:                          Line Layout.       (line  6881)
+* right-aligning lines (introduction):   Basics.            (line  1182)
+* right-justifying (rj):                 Manipulating Filling and Adjustment.
+                                                            (line  5866)
+* right-justifying lines (introduction): Basics.            (line  1182)
+* rivers:                                Other Differences. (line 12552)
+* rj request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* rn glyph, and cflags:                  Using Symbols.     (line  7882)
+* roman glyph, correction after italic glyph (\/): Italic Corrections.
+                                                            (line  8328)
+* roman glyph, correction before italic glyph (\,): Italic Corrections.
+                                                            (line  8338)
+* Roman numerals:                        Assigning Register Formats.
+                                                            (line  5433)
+* Roman numerals, extrema (maximum and minimum): Assigning Register Formats.
+                                                            (line  5465)
+* rq glyph, at end of sentence:          Sentences.         (line  3663)
+* rq glyph, at end of sentence <1>:      Using Symbols.     (line  7892)
+* rt request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* ru glyph, and cflags:                  Using Symbols.     (line  7882)
+* running system commands:               I/O.               (line 11633)
+* s scaling unit:                        Using Fractional Type Sizes.
+                                                            (line  8604)
+* safer mode:                            Groff Options.     (line   707)
+* safer mode <1>:                        Macro Directories. (line   910)
+* safer mode <2>:                        Built-in Registers.
+                                                            (line  5555)
+* safer mode <3>:                        I/O.               (line 11504)
+* safer mode <4>:                        I/O.               (line 11616)
+* safer mode <5>:                        I/O.               (line 11638)
+* safer mode <6>:                        I/O.               (line 11677)
+* safer mode <7>:                        Safer Mode.        (line 12395)
+* saving horizontal input line position (\k): Page Motions. (line 10084)
+* scaling indicator:                     Measurements.      (line  4232)
+* scaling operator:                      Numeric Expressions.
+                                                            (line  4390)
+* scaling unit c:                        Measurements.      (line  4252)
+* scaling unit f:                        Colors.            (line  8712)
+* scaling unit i:                        Measurements.      (line  4249)
+* scaling unit m:                        Measurements.      (line  4277)
+* scaling unit M:                        Measurements.      (line  4287)
+* scaling unit n:                        Measurements.      (line  4281)
+* scaling unit p:                        Measurements.      (line  4255)
+* scaling unit P:                        Measurements.      (line  4259)
+* scaling unit s:                        Using Fractional Type Sizes.
+                                                            (line  8604)
+* scaling unit u:                        Measurements.      (line  4245)
+* scaling unit v:                        Measurements.      (line  4284)
+* scaling unit z:                        Using Fractional Type Sizes.
+                                                            (line  8604)
+* searching fonts:                       Font Directories.  (line   934)
+* searching macros:                      Macro Directories. (line   898)
+* seconds, current time (seconds):       Built-in Registers.
+                                                            (line  5580)
+* selecting the previous font (ft):      Selecting Fonts.   (line  7352)
+* sentence space:                        Sentences.         (line  3619)
+* sentence space size register (.sss):   Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* sentences:                             Sentences.         (line  3607)
+* sequence, escape:                      Formatter Instructions.
+                                                            (line  4714)
+* setting diversion trap (dt):           Diversion Traps.   (line 10668)
+* setting end-of-input trap (em):        End-of-input Traps.
+                                                            (line 10807)
+* setting input line number (lf):        Debugging.         (line 12103)
+* setting input line trap (it, itc):     Input Line Traps.  (line 10680)
+* setting registers (nr, \R):            Setting Registers. (line  5219)
+* setting the page length (pl):          Page Layout.       (line  7093)
+* setting up an abstract font style (sty): Font Families.   (line  7505)
+* shc request, and translations:         Character Translations.
+                                                            (line  6755)
+* site-local directory:                  Macro Directories. (line   915)
+* site-local directory <1>:              Font Directories.  (line   957)
+* size of sentence space register (.sss): Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* size of word space register (.ss):     Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* size, optical, of a font:              Selecting Fonts.   (line  7421)
+* size, paper:                           Paper Format.      (line   972)
+* size, size:                            Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* sizes, fractional:                     Other Differences. (line 12587)
+* sizes, fractional type:                Using Fractional Type Sizes.
+                                                            (line  8597)
+* skew, of last glyph (.csk):            Environments.      (line 11388)
+* slant, font, changing (\S):            Artificial Fonts.  (line  8161)
+* soft hyphen character, setting (shc):  Manipulating Hyphenation.
+                                                            (line  6032)
+* soft hyphen glyph (hy):                Manipulating Hyphenation.
+                                                            (line  6032)
+* solid circle, drawing (\D'C ...'):     Drawing Geometric Objects.
+                                                            (line 10234)
+* solid ellipse, drawing (\D'E ...'):    Drawing Geometric Objects.
+                                                            (line 10241)
+* solid polygon, drawing (\D'P ...'):    Drawing Geometric Objects.
+                                                            (line 10275)
+* SOURCE_DATE_EPOCH, environment variable: Environment.     (line   882)
+* sp request, and no-space mode:         Manipulating Spacing.
+                                                            (line  6456)
+* sp request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* space between sentences:               Sentences.         (line  3619)
+* space between sentences register (.sss): Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* space between words register (.ss):    Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* space character, as delimiter:         Delimiters.        (line  5094)
+* space characters, in expressions:      Numeric Expressions.
+                                                            (line  4538)
+* space, between sentences:              Manipulating Filling and Adjustment.
+                                                            (line  5893)
+* space, between words:                  Manipulating Filling and Adjustment.
+                                                            (line  5891)
+* space, discardable, horizontal:        Manipulating Filling and Adjustment.
+                                                            (line  5914)
+* space, hair (\^):                      Page Motions.      (line 10008)
+* space, horizontal (\h):                Page Motions.      (line  9982)
+* space, horizontal, unformatting:       Punning Names.     (line 11246)
+* space, thin (\|):                      Page Motions.      (line 10003)
+* space, unbreakable (\~):               Manipulating Filling and Adjustment.
+                                                            (line  5671)
+* space, unbreakable and unadjustable (\<SP>): Page Motions.
+                                                            (line  9998)
+* space, vertical, unit (v):             Measurements.      (line  4284)
+* space, width of a digit (numeral) (\0): Page Motions.     (line 10014)
+* spaces with ds:                        Strings.           (line  8844)
+* spaces, in a macro argument:           Calling Macros.    (line  4856)
+* spaces, leading and trailing:          Breaking.          (line  3757)
+* spacing (introduction):                Basics.            (line  1150)
+* spacing, manipulating:                 Manipulating Spacing.
+                                                            (line  6344)
+* spacing, vertical:                     Page Geometry.     (line  4202)
+* spacing, vertical <1>:                 Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* spacing, vertical (introduction):      Basics.            (line  1136)
+* special characters:                    Sentences.         (line  3663)
+* special characters <1>:                Character Translations.
+                                                            (line  6741)
+* special characters ms:               ms Legacy Features.
+                                                            (line  3405)
+* special characters, list of (groff_char(7) man page): Using Symbols.
+                                                            (line  7675)
+* special font:                          Using Fonts.       (line  7280)
+* special fonts:                         Using Symbols.     (line  7612)
+* special fonts <1>:                     Special Fonts.     (line  8092)
+* special fonts <2>:                     Font Description File Format.
+                                                            (line 13618)
+* special fonts, emboldening:            Artificial Fonts.  (line  8230)
+* special request, and font translations: Selecting Fonts.  (line  7406)
+* special request, and glyph search order: Using Symbols.   (line  7612)
+* spline, drawing (\D'~ ...'):           Drawing Geometric Objects.
+                                                            (line 10221)
+* springing a trap:                      Traps.             (line 10394)
+* sqrtex glyph, and cflags:              Using Symbols.     (line  7882)
+* ss request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12604)
+* stack:                                 Environments.      (line 11273)
+* stacking glyphs (\b):                  Drawing Geometric Objects.
+                                                            (line 10308)
+* standard input, reading from (rd):     I/O.               (line 11558)
+* stderr, printing to (tm, tm1, tmc):    Debugging.         (line 12117)
+* stops, tab:                            Tabs and Leaders.  (line  3785)
+* string arguments:                      Strings.           (line  8802)
+* string comparison:                     Operators in Conditionals.
+                                                            (line  9108)
+* string expansion (\*):                 Strings.           (line  8802)
+* string interpolation (\*):             Strings.           (line  8802)
+* string, appending (as):                Strings.           (line  8889)
+* string, creating alias for (als):      Strings.           (line  8972)
+* string, length of (length):            Strings.           (line  8909)
+* string, removing (rm):                 Strings.           (line  8967)
+* string, removing alias for (rm):       Strings.           (line  9007)
+* string, renaming (rn):                 Strings.           (line  8964)
+* strings:                               Strings.           (line  8780)
+* strings ms:                          ms Legacy Features.
+                                                            (line  3405)
+* strings, multi-line:                   Strings.           (line  8853)
+* strings, shared name space with macros and diversions: Identifiers.
+                                                            (line  4668)
+* stripping final newline in diversions: Punning Names.     (line 11246)
+* stroke color:                          Colors.            (line  8678)
+* stroke color name register (.m):       Colors.            (line  8744)
+* stroked circle, drawing (\D'c ...'):   Drawing Geometric Objects.
+                                                            (line 10230)
+* stroked ellipse, drawing (\D'e ...'):  Drawing Geometric Objects.
+                                                            (line 10237)
+* stroked polygon, drawing (\D'p ...'):  Drawing Geometric Objects.
+                                                            (line 10269)
+* structuring source code of documents or macro packages: Invoking Requests.
+                                                            (line  4803)
+* sty request, and changing fonts:       Selecting Fonts.   (line  7352)
+* sty request, and font translations:    Selecting Fonts.   (line  7406)
+* style, font:                           Using Fonts.       (line  7280)
+* style, font, abstract:                 Using Fonts.       (line  7302)
+* style, font, abstract, setting up (sty): Font Families.   (line  7505)
+* styles, font:                          Font Families.     (line  7448)
+* substring (substring):                 Strings.           (line  8927)
+* subtraction:                           Numeric Expressions.
+                                                            (line  4359)
+* suppressing output (\O):               Suppressing Output.
+                                                            (line 11410)
+* suppression nesting level register:    Suppressing Output.
+                                                            (line 11463)
+* sv request, and no-space mode:         Page Control.      (line  7233)
+* switching environments (ev):           Environments.      (line 11309)
+* sy request, and safer mode:            Groff Options.     (line   707)
+* sy request, disabled by default:       Safer Mode.        (line 12395)
+* symbol:                                Using Symbols.     (line  7612)
+* symbol table, dumping (pm):            Debugging.         (line 12154)
+* symbol, defining (char):               Using Symbols.     (line  7948)
+* symbols, using:                        Using Symbols.     (line  7600)
+* system commands, running:              I/O.               (line 11633)
+* system() return value register (systat): I/O.             (line 11666)
+* tab character:                         Tabs and Leaders.  (line  3785)
+* tab character encoding:                Tabs and Fields.   (line  6481)
+* tab character, and translations:       Character Translations.
+                                                            (line  6751)
+* tab character, as delimiter:           Delimiters.        (line  5094)
+* tab character, non-interpreted (\t):   Tabs and Fields.   (line  6485)
+* tab repetition character (tc):         Tabs and Fields.   (line  6602)
+* tab stop settings register (.tabs):    Tabs and Fields.   (line  6593)
+* tab stops:                             Tabs and Leaders.  (line  3785)
+* tab stops, default:                    Tabs and Fields.   (line  6493)
+* tab, line-tabs mode:                   Tabs and Fields.   (line  6615)
+* table of contents:                     Table of Contents. (line  1323)
+* table of contents <1>:                 Leaders.           (line  6671)
+* table of contents, creating ms:      ms TOC.            (line  3139)
+* table, multi-page, example ms:       ms Insertions.     (line  2886)
+* tables ms:                           ms Insertions.     (line  2844)
+* tabs, and fields:                      Tabs and Fields.   (line  6481)
+* tabs, and macro arguments:             Invoking Requests. (line  4789)
+* tabs, and request arguments:           Invoking Requests. (line  4789)
+* tabs, before comments:                 Comments.          (line  5145)
+* tagged paragraphs:                     Paragraphs.        (line  1228)
+* tags, paragraph:                       Paragraphs.        (line  1228)
+* terminal, conditional output for:      Operators in Conditionals.
+                                                            (line  9053)
+* text baseline:                         Page Geometry.     (line  4184)
+* text baseline <1>:                     Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* text font:                             Using Fonts.       (line  7280)
+* text line:                             Requests and Macros.
+                                                            (line  3826)
+* text line, position of lowest (.h):    Diversions.        (line 11007)
+* text, GNU troff processing:            Text.              (line  3556)
+* text, justifying:                      Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* text, justifying (rj):                 Manipulating Filling and Adjustment.
+                                                            (line  5866)
+* thickness of lines (\D't ...'):        Drawing Geometric Objects.
+                                                            (line 10298)
+* thin space (\|):                       Page Motions.      (line 10003)
+* three-part title (tl):                 Page Layout.       (line  7120)
+* ti request, causing implicit break:    Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* ti request, using + and - with:        Numeric Expressions.
+                                                            (line  4463)
+* time, current, hours (hours):          Built-in Registers.
+                                                            (line  5586)
+* time, current, minutes (minutes):      Built-in Registers.
+                                                            (line  5583)
+* time, current, seconds (seconds):      Built-in Registers.
+                                                            (line  5580)
+* time, formatting:                      I/O.               (line 11656)
+* title length, configuring (lt):        Page Layout.       (line  7137)
+* title line length register (.lt):      Page Layout.       (line  7146)
+* title line, formatting (tl):           Page Layout.       (line  7120)
+* titles:                                Page Layout.       (line  7115)
+* tkf request, and font styles:          Font Families.     (line  7505)
+* tkf request, and font translations:    Selecting Fonts.   (line  7406)
+* tkf request, with fractional type sizes: Using Fractional Type Sizes.
+                                                            (line  8604)
+* tl request, and mc:                    Miscellaneous.     (line 11901)
+* tmac, directory:                       Macro Directories. (line   900)
+* tmac, path:                            Macro Directories. (line   900)
+* TMPDIR, environment variable:          Environment.       (line   869)
+* token, input:                          Gtroff Internals.  (line 11970)
+* top margin:                            Page Location Traps.
+                                                            (line 10440)
+* top-level diversion:                   Diversions.        (line 10930)
+* top-level diversion, and bp:           Page Control.      (line  7183)
+* top-level diversion, and \!:           Diversions.        (line 11098)
+* top-level diversion, and \?:           Diversions.        (line 11103)
+* tr request, and glyph definitions:     Using Symbols.     (line  7948)
+* tr request, and soft hyphen character: Manipulating Hyphenation.
+                                                            (line  6032)
+* tr request, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12609)
+* track kerning:                         Ligatures and Kerning.
+                                                            (line  8300)
+* track kerning, activating (tkf):       Ligatures and Kerning.
+                                                            (line  8307)
+* trailing double quotes in strings:     Strings.           (line  8844)
+* trailing spaces in string definitions and appendments: Strings.
+                                                            (line  8823)
+* trailing spaces on text lines:         Breaking.          (line  3757)
+* translations of characters:            Character Translations.
+                                                            (line  6722)
+* transparent characters:                Using Symbols.     (line  7892)
+* transparent dummy character (\)):      Dummy Characters.  (line  8407)
+* transparent output (cf, trf):          I/O.               (line 11521)
+* transparent output (\!, \?):           Diversions.        (line 11066)
+* transparent output, incompatibilities with AT&T troff: Other Differences.
+                                                            (line 12636)
+* trap:                                  Deferring Output.  (line 10337)
+* trap, changing location (ch):          Page Location Traps.
+                                                            (line 10528)
+* trap, distance to next vertical position, register (.t): Page Location Traps.
+                                                            (line 10520)
+* trap, diversion, setting (dt):         Diversion Traps.   (line 10668)
+* trap, end-of-input, setting (em):      End-of-input Traps.
+                                                            (line 10807)
+* trap, implicit:                        The Implicit Page Trap.
+                                                            (line 10638)
+* trap, input line, clearing (it, itc):  Input Line Traps.  (line 10680)
+* trap, input line, setting (it, itc):   Input Line Traps.  (line 10680)
+* trap, planting:                        Traps.             (line 10393)
+* trap, springing:                       Traps.             (line 10394)
+* traps:                                 Traps.             (line 10387)
+* traps, and diversions:                 Page Location Traps.
+                                                            (line 10618)
+* traps, blank line:                     Blank Line Traps.  (line 10778)
+* traps, diversion:                      Diversion Traps.   (line 10663)
+* traps, end-of-input:                   End-of-input Traps.
+                                                            (line 10806)
+* traps, input line:                     Input Line Traps.  (line 10678)
+* traps, input line, and interrupted lines (itc): Input Line Traps.
+                                                            (line 10704)
+* traps, leading space:                  Leading Space Traps.
+                                                            (line 10788)
+* traps, page location:                  Page Location Traps.
+                                                            (line 10420)
+* traps, page location, dumping (ptr):   Debugging.         (line 12162)
+* traps, page location, listing (ptr):   Debugging.         (line 12162)
+* traps, sprung by bp request (.pe):     Page Location Traps.
+                                                            (line 10598)
+* traps, vertical position:              Vertical Position Traps.
+                                                            (line 10399)
+* trf request, and copy mode:            I/O.               (line 11521)
+* trf request, and invalid characters:   I/O.               (line 11533)
+* trf request, causing implicit break:   Manipulating Filling and Adjustment.
+                                                            (line  5624)
+* trin request, and asciify:             Diversions.        (line 11120)
+* troff mode:                            troff and nroff Modes.
+                                                            (line  6813)
+* troff output:                          gtroff Output.     (line 12690)
+* truncated vertical space register (.trunc): Page Location Traps.
+                                                            (line 10587)
+* truncating division:                   Numeric Expressions.
+                                                            (line  4359)
+* TTY, conditional output for:           Operators in Conditionals.
+                                                            (line  9053)
+* tutorial for macro users:              Tutorial for Macro Users.
+                                                            (line  1046)
+* type size:                             Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* type size registers (.s, .ps):         Changing the Type Size.
+                                                            (line  8480)
+* type size registers, last-requested (.psr, .sr): Using Fractional Type Sizes.
+                                                            (line  8638)
+* type sizes, changing (ps, \s):         Changing the Type Size.
+                                                            (line  8466)
+* type sizes, fractional:                Using Fractional Type Sizes.
+                                                            (line  8597)
+* type sizes, fractional <1>:            Other Differences. (line 12587)
+* typeface:                              Using Fonts.       (line  7280)
+* TZ, environment variable:              Environment.       (line   889)
+* u scaling unit:                        Measurements.      (line  4245)
+* uf request, and font styles:           Font Families.     (line  7505)
+* ul glyph, and cflags:                  Using Symbols.     (line  7882)
+* ul request, and font translations:     Selecting Fonts.   (line  7406)
+* Ultrix-specific man macros:            Optional man extensions.
+                                                            (line  1451)
+* unadjustable and unbreakable space (\<SP>): Page Motions. (line  9998)
+* unary arithmetic operators:            Numeric Expressions.
+                                                            (line  4365)
+* unbreakable and unadjustable space (\<SP>): Page Motions. (line  9998)
+* unbreakable space (\~):                Manipulating Filling and Adjustment.
+                                                            (line  5671)
+* undefined identifiers:                 Identifiers.       (line  4656)
+* undefined request:                     Comments.          (line  5150)
+* underline font (uf):                   Artificial Fonts.  (line  8206)
+* underlining (ul):                      Artificial Fonts.  (line  8180)
+* underlining, continuous (cu):          Artificial Fonts.  (line  8202)
+* unformatting diversions (asciify):     Diversions.        (line 11120)
+* unformatting horizontal space:         Punning Names.     (line 11246)
+* Unicode:                               Identifiers.       (line  4581)
+* Unicode <1>:                           Using Symbols.     (line  7810)
+* unit, scaling, c:                      Measurements.      (line  4252)
+* unit, scaling, f:                      Colors.            (line  8712)
+* unit, scaling, i:                      Measurements.      (line  4249)
+* unit, scaling, m:                      Measurements.      (line  4277)
+* unit, scaling, M:                      Measurements.      (line  4287)
+* unit, scaling, n:                      Measurements.      (line  4281)
+* unit, scaling, p:                      Measurements.      (line  4255)
+* unit, scaling, P:                      Measurements.      (line  4259)
+* unit, scaling, s:                      Using Fractional Type Sizes.
+                                                            (line  8604)
+* unit, scaling, u:                      Measurements.      (line  4245)
+* unit, scaling, v:                      Measurements.      (line  4284)
+* unit, scaling, z:                      Using Fractional Type Sizes.
+                                                            (line  8604)
+* units of measurement:                  Measurements.      (line  4232)
+* units, basic:                          Page Geometry.     (line  4169)
+* units, basic, conversion to:           Measurements.      (line  4239)
+* units, default:                        Default Units.     (line  4318)
+* units, machine:                        Page Geometry.     (line  4169)
+* unnamed glyphs:                        Using Symbols.     (line  7820)
+* unnamed glyphs, accessing with \N:     Font Description File Format.
+                                                            (line 13639)
+* unsafe mode:                           Groff Options.     (line   783)
+* unsafe mode <1>:                       Macro Directories. (line   910)
+* unsafe mode <2>:                       Built-in Registers.
+                                                            (line  5555)
+* unsafe mode <3>:                       I/O.               (line 11504)
+* unsafe mode <4>:                       I/O.               (line 11616)
+* unsafe mode <5>:                       I/O.               (line 11638)
+* unsafe mode <6>:                       I/O.               (line 11677)
+* unstyled font:                         Using Fonts.       (line  7280)
+* up-casing a string (stringup):         Strings.           (line  8945)
+* uppercasing a string (stringup):       Strings.           (line  8945)
+* upright glyph, correction after oblique glyph (\/): Italic Corrections.
+                                                            (line  8328)
+* upright glyph, correction before oblique glyph (\,): Italic Corrections.
+                                                            (line  8338)
+* URLs, breaking (\:):                   Manipulating Hyphenation.
+                                                            (line  6008)
+* user's macro tutorial:                 Tutorial for Macro Users.
+                                                            (line  1046)
+* user's tutorial for macros:            Tutorial for Macro Users.
+                                                            (line  1046)
+* using escape sequences:                Using Escape Sequences.
+                                                            (line  4942)
+* using symbols:                         Using Symbols.     (line  7600)
+* UTF-8 output encoding:                 Groff Options.     (line   751)
+* v scaling unit:                        Measurements.      (line  4284)
+* valid numeric expression:              Numeric Expressions.
+                                                            (line  4522)
+* value, incrementing without changing the register: Auto-increment.
+                                                            (line  5403)
+* variables in environment:              Environment.       (line   827)
+* vee:                                   Page Geometry.     (line  4202)
+* vee scaling unit (v):                  Measurements.      (line  4284)
+* version number, major, register (.x):  Built-in Registers.
+                                                            (line  5559)
+* version number, minor, register (.y):  Built-in Registers.
+                                                            (line  5563)
+* vertical drawing position (nl):        Page Control.      (line  7240)
+* vertical line drawing (\L):            Drawing Geometric Objects.
+                                                            (line 10168)
+* vertical line spacing register (.v):   Changing the Vertical Spacing.
+                                                            (line  8543)
+* vertical line spacing, changing (vs):  Changing the Vertical Spacing.
+                                                            (line  8543)
+* vertical line spacing, effective value: Changing the Vertical Spacing.
+                                                            (line  8558)
+* vertical motion (\v):                  Page Motions.      (line  9938)
+* vertical motion quantum:               DESC File Format.  (line 13553)
+* vertical page location, marking (mk):  Page Motions.      (line  9868)
+* vertical page location, returning to marked (rt): Page Motions.
+                                                            (line  9868)
+* vertical position in diversion register (.d): Diversions. (line 11000)
+* vertical position trap enable register (.vpt): Vertical Position Traps.
+                                                            (line 10407)
+* vertical position traps:               Vertical Position Traps.
+                                                            (line 10399)
+* vertical position traps, enabling (vpt): Vertical Position Traps.
+                                                            (line 10407)
+* vertical position, drawing (nl):       Page Control.      (line  7240)
+* vertical resolution:                   DESC File Format.  (line 13553)
+* vertical space unit (v):               Measurements.      (line  4284)
+* vertical spacing:                      Page Geometry.     (line  4202)
+* vertical spacing <1>:                  Manipulating Type Size and Vertical Spacing.
+                                                            (line  8438)
+* vertical spacing (introduction):       Basics.            (line  1136)
+* warning categories:                    Warnings.          (line 12250)
+* warning level (warn):                  Debugging.         (line 12227)
+* warnings:                              Debugging.         (line 12222)
+* warnings <1>:                          Warnings.          (line 12241)
+* what is groff?:                        What Is groff?.    (line   264)
+* while:                                 while.             (line  9327)
+* while request, and font translations:  Selecting Fonts.   (line  7406)
+* while request, and the ! operator:     Numeric Expressions.
+                                                            (line  4365)
+* while request, confusing with br:      while.             (line  9393)
+* while request, operators to use with:  Operators in Conditionals.
+                                                            (line  9027)
+* widow:                                 Page Control.      (line  7203)
+* widow <1>:                             Page Control.      (line  7222)
+* width escape (\w):                     Page Motions.      (line 10027)
+* width, of last glyph (.w):             Environments.      (line 11388)
+* word space size register (.ss):        Manipulating Filling and Adjustment.
+                                                            (line  5887)
+* word, definition of:                   Filling.           (line  3581)
+* write request, and copy mode:          I/O.               (line 11683)
+* writec request, and copy mode:         I/O.               (line 11683)
+* writem request, and copy mode:         I/O.               (line 11697)
+* writing macros:                        Writing Macros.    (line  9410)
+* writing to file (write, writec):       I/O.               (line 11683)
+* year, current, register (year, yr):    Built-in Registers.
+                                                            (line  5598)
+* z scaling unit:                        Using Fractional Type Sizes.
+                                                            (line  8604)
+* zero-width printing (\z, \Z):          Page Motions.      (line 10102)
+* zero-width printing (\z, \Z) <1>:      Page Motions.      (line 10107)
+* zoom factor of a font (fzoom):         Selecting Fonts.   (line  7421)
+

_service:tar_scm:groff-1.23.0.tar.gz/doc/me-revisions Added

@@ -0,0 +1,261 @@
+8.1	Sat Jun 5 14:06:23 1993 UTC	bostic
+-- 4.4BSD snapshot (revision 8.1); add 1993 to copyright
+
+2.37	Sat Oct 26 22:29:25 1991 UTC	eric
+-- have .rn (in @h) check to see that the temp macros are defined
+   first -- for SoftQuad troff, per Rick Adam's request
+
+2.36	Mon Oct 7 20:57:46 1991 UTC	cael
+-- modify pathname
+
+2.35	Wed Apr 17 15:31:46 1991 UTC	bostic
+-- new copyright; att/bsd/shared
+
+2.34	Sat Jun 2 18:30:49 1990 UTC	karels
+-- reorg: move me library directory
+
+2.33	Wed Jan 4 10:54:00 1989 UTC	karels
+-- don't use bold if \n(pf is >4 but not 8 (allow pf to be, eg, 5)
+
+2.32	Fri Sep 30 10:19:15 1988 UTC	bostic
+-- update to new copyright notices
+
+2.31	Sat May 21 15:12:44 1988 UTC	bostic
+-- don't strip copyright notice
+
+2.30	Thu May 19 17:21:40 1988 UTC	bostic
+-- written by Eric Allman; add Berkeley specific header
+
+2.29	Fri Apr 22 10:48:37 1988 UTC	karels
+-- allow .PS to support old or new pic (new uses units of inches)
+
+2.28	12 May 86
+-- Fix footnotes if no -rv flag specified
+
+2.27	17 Apr 86
+-- Assume non-C/A/T typesetters -- use -rv2 to get old function
+
+2.26	27 Mar 86
+-- Always go into fill mode in .sh; necessary to get output format
+   correct.
+
+2.25	3 Mar 86
+-- Drop basic unit scaling on .sz and .ps requests; this confuses some
+   versions of troff.
+
+2.24	7 Jan 86
+-- Merge ditroff and troff versions.
+-- Add support for pic, gremlin, and ideal.
+-- Add .lh macro to print a letterhead.
+-- Adjust .bi (bold italics) to be more device resolution independent.
+
+2.23	23 Jun 85
+-- Allow .< to initialize refer macros (as well as .-).
+
+2.22	27 Apr 85
+-- Fix incorrect comment strip in $p macro.
+-- Drop into fill mode in .TS so that text boxes will work properly.
+
+2.21	4 Mar 85
+-- Change \*- macro from \- to \(em in troff.
+-- Change block indent (\n(bi) from 4n to 4m to look better in troff.
+
+2.20	18 Feb 85
+-- Don't reset ii register in .bu or .np
+
+2.19	14 Feb 85
+-- add .bu and .sm macros (bullet and smaller).
+-- have .np take a fixed .ip width.
+
+2.18	14 Feb 85
+-- Avoid cut marks on laser printers.
+
+2.17	14 Feb 85
+-- Some bug fixes as reported from many places.
+
+2.16	11 Oct 84
+-- Improve some tracing.
+-- Minor improvements from rrh.
+
+2.15	10 Apr 83
+-- Fix a name conflict between .sh and floating keeps (as suggested
+   by Hy Murviet).
+
+2.14	28 Dec 81
+-- Integrate the refer macros into -me.  This is basically a cheap
+   and dirty modification of the -ms version, and is probably not
+   terribly compatible with the usual -me standards.  This can be
+   tuned later if needed.
+
+2.13	22 Dec 81
+-- Allow the -rb<x> flag to set the font you want for bold font --
+   set it to font <x>.  Default 2 (italic) in nroff, 3 (bold) in
+   troff.
+
+2.12	20 Mar 81
+-- Remove silly "." at top of page on dumb terminals -- lpr is smarter
+   now.
+
+2.11	19 Mar 81
+-- Fixed indexes to indent on second line.
+
+2.10	26 Feb 81
+-- Improvement to nested index solution, now works for ()b & ()z.
+
+2.9	10 Dec 80
+-- More stuff to make indices inside keeps work correctly.
+
+2.8	10 Nov 80
+-- Had .)c do a .br to insure that the final line is forced out.
+
+2.7	24 Sep 80
+-- Fixed bug in 2.6
+
+2.6	23 Sep 80
+-- Fixed problem introduced by 2.2 which occurred in footnotes and
+   index entries in filled keeps
+
+2.5	29 Aug 80
+-- Changed umlaut to not be so tricky -- it seems to backfire.
+
+2.4	25 Aug 80
+-- Fixed bug in indices caused by 2.2.
+
+2.3	20 Aug 80
+-- Fixed bug in footnotes caused by 2.2.
+-- Changed temp file names that macros that do dynamic loading rename
+   themselves to.  For example, if you say '.TS ... .(f' when both of
+   them have been used for the first time, the @T macro got used twice.
+
+2.2	18 Aug 80
+-- Suspended footnote & index processing until final output
+   (so that they will work properly in keeps).
+
+2.1	18 Aug 80
+-- Release 2.  No changes.
+
+Mod 28	18 Aug 80
+-- If \nv is set on entry, handle .po differently (for vtroff).
+-- Allow ".nr fi 0".
+
+Mod 27	30 Jun 80
+-- Put in a cludge to try to make multi-columned output work
+   with wide floating keeps.  Moves all wide keeps to the top
+   of the next real page.
+
+Mod 26	9 Nov 79
+-- Fixed footnote bug that caused the first line of footnotes
+   that were broken across a page to be indented.
+
+Mod 25	1 Oct 79
+-- Fixed footnote bug that caused footnotes invoked at the
+   top of pages to come out in bold font.
+-- Fixed equation bug that caused equations at the top of
+   page to be improperly centered.
+
+Mod 24	27 Sep 79
+-- Changed delimiter in all \w's to " from ', to allow for
+   apostrophes in labels.
+-- Increased footnote fudge factor.
+-- Changed \x factor in \* & \*< to be one half previous value.
+
+Mod 23	24 Aug 79
+-- Changed .ip to start new line if the tag is too long for
+   the space provided.
+
+Mod 22	11 Jul 79
+-- Changed .ac to handle new paper (with second parameter
+   == "*").
+
+Mod 21	24 Apr 79
+-- Changed \* and \*< to use \x -- to avoid line overlap.
+
+Mod 20	6 Apr 79
+-- Changed 12-pitch DTC terminals to still space 1/6 inch (instead
+   of 1/8 inch), unless the 'x' register is non-zero -- do-able with
+   the -rx1 option on the nroff command line.
+
+Mod 19	28 Mar 79
+-- Had .ep do a .rs, to avoid occasional problems (like with
+   .+c (again).
+-- Added the 'X' register: if non-zero on startup on a 12-pitch
+   terminal, it outputs 6 LPI instead of 8 LPI.
+
+Mod 18	26 Mar 79
+-- Had .+c reset indent, to solve problems of prelim material
+   after a .ip (as with references)
+
+Mod 17	19 Mar 79
+-- Fixed a bug in .++ which caused it to renumber pages incorrectly,
+   the result of nroff starting a new page immediately upon reaching
+   the end of the previous page (damn!).
+
+Mod 16	8 Mar 79
+-- Fixed a bug in .++ which caused it to change page number formats
+   before forcing out the page.
+-- Changed tmac.e so that extra '.so's to the package will next to
+   'null.me'.
+-- Changed .sh so that a title of "_" will cause section depth change
+   side-effects only (base indent will remain the same, and no output
+   will occur).
+
+Mod 15a	7 Mar 79
+-- Fixed a bug in Mod 15 which caused .ip's to fail.
+
+Mod 15	2 Mar 79
+-- Changed .@p to do paragraph indents normally in keeps, which
+   will override the indent parameter in keeps with paragraph
+   forms in them (use .ba to fix this).
+
+Mod 14	23 Feb 79
+-- Fixed .ip so it would hyphenate correctly.
+
+Mod 13	16 Feb 79
+-- Added .rs before eqn title output to fix vertical centering
+   problem.
+
+Mod 12	15 Feb 79
+-- Changed NROFF bold font to be regular .ul (.cu is a pain).
+-- Changed .sh to output regular spaces instead of unpaddable
+   spaces.
+-- Fixed bug in .1c with bad line length (didn't reset \n($l).
+
+Mod 11	13 Feb 79
+-- Added hook to .$c to call .$C (for index entries or whatever).
+
+Mod 10	12 Feb 79
+-- Had .xp print in current environment and not reset to single
+   spacing, to allow more control over output format.
+
+Mod 9	26 Dec 78
+-- Fixed yet another problem with equation spacing.
+
+Mod 8	18 Dec 78
+-- Fixed .@q to solve a problem with \n(dn getting lost on
+   equations at top of page.
+
+Mod 7	11 Dec 78
+-- Had .@q (equation output) move to end of equation after
+   equation output (eqn doesn't seem to space quite right).
+
+Mod 6	27 Nov 78
+-- Fixed the umlaut on DTC output to be prettier.
+
+Mod 5	5 Nov 78
+-- Fixed a bug with the second parameter to .ip.
+
+Mod 4	2 Nov 78
+-- Added .uh command (unnumbered heading).
+-- Changed .$p and .sh accordingly.
+
+Mod 3	2 Oct 78
+-- Fixed .ne command in .$p (print section headings).
+
+Mod 2	25 Sep 78
+-- Changed .np to use () instead of .
+
+Mod 1	12 Sep 78
+-- Fixed footnote fudge factor (curse NROFF!!)
+-- Put "needs" on .(z, .)z.
+
+Mod 0	11 Sep 78

_service:tar_scm:groff-1.23.0.tar.gz/doc/meintro.me.in Added

@@ -0,0 +1,2266 @@
+.\" groff -me
+.\"
+.\" Copyright (c) 1986, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)intro.me	8.2 (Berkeley) 06/01/94
+.\"
+.\" Modified for groff by jjc@jclark.com.
+.\"UC 7
+.if t .ll 6.5i
+.if t .lt 6.5i
+.nr sx 0
+.ds MO @VERSION@
+.nr si 3n
+.he 'Using \f(BIgroff\fP and \f(BI\-me\fP''%'
+.\"eh 'USD:19-%''Writing Papers with NROFF using \-me'
+.\"oh 'Writing Papers with NROFF using \-me''USD:19-%'
+.ds U Unix
+.ds N \fInroff\fP
+.ds T \fItroff\fP
+.ds G \fIgroff\fP
+.ds UG groff\" upright "groff" for use in slanted contexts
+.+c
+.(l C
+.sz 14
+.b "Writing Papers with \f(BIgroff\fP using \f(BI\-me\fP"
+.sz
+.sp 2
+.ul
+Eric P. Allman
+.sp
+Project INGRES
+Electronics Research Laboratory
+University of California, Berkeley
+Berkeley, California  94720
+.sp 2
+.i "Modified for \fR\*(UG\fP by James Clark*"
+.(f
+* This document applies to the version of the \-me macros
+included with \*G version \*(MO.
+.)f
+.)l
+.sp 4
+.pp
+This document describes
+the text processing facilities
+available on \*U
+and other
+operating systems
+via \*G and the
+\-me
+macro package.
+It is assumed
+that the reader
+already is generally familiar
+with the \*U operating system
+and a text editor
+such as
+.i vi .
+This is intended to be a casual introduction,
+and
+as such not all material is covered.
+In particular,
+many variations and additional features
+of the \-me macro package
+are not explained.
+For a complete discussion of this
+and other issues,
+see
+the
+.q "\fIme\fP Reference Manual"
+and
+.i "groff: The GNU implementation of troff."
+.pp
+\*G, a computer program
+that runs on the \*U operating system,
+reads an input file
+prepared by the user
+and outputs a formatted paper
+suitable for publication or framing.
+The input consists of
+.i text ,
+or words to be printed,
+and
+.i requests ,
+which give instructions
+to the \*G program
+telling how to format the printed copy.
+.pp
+Section 1
+describes the basics
+of text processing.
+Section 2
+describes the basic requests.
+Section 3
+introduces displays.
+Annotations,
+such as footnotes,
+are handled in
+section 4.
+The more complex requests
+which are not discussed in section 2
+are covered in section 5.
+Finally,
+section 6
+discusses things you will need
+to know
+if you want to typeset documents.
+If you are a novice,
+you probably won't want to read beyond section 4
+until you have tried some of the basic features out.
+.pp
+When you have your raw text ready,
+call the \*G formatter by typing
+as a request to the \*U shell:
+.(b
+groff \-me \-T\c
+.i "type files"
+.)b
+where
+.i type
+describes the type of
+output device you are using.
+A complete description of options
+to the \*G command can be found in
+.i groff (1).
+.pp
+The word
+.i argument
+is used in this manual
+to mean a word or number
+which appears on the same line
+as a request
+which modifies the meaning
+of that request.
+For example,
+the request
+.(b
+\&.sp
+.)b
+spaces one line,
+but
+.(b
+\&.sp 4
+.)b
+spaces four lines.
+The number
+.b 4
+is an
+.i argument
+to the
+.b .sp
+request
+which says to space four lines
+instead of one.
+Arguments are separated from the request
+and from each other
+by spaces.
+.sh 1 "Basics of Text Processing"
+.pp
+The primary function
+of \*G
+is to
+.i collect
+words from input lines,
+.i fill
+output lines with those words,
+.i justify
+the right hand margin by inserting extra spaces
+in the line,
+and output the result.
+For example,
+the input:
+.(b
+Now is the time
+for all good men
+to come to the aid
+of their party.
+Four score and seven
+years ago,...
+.)b
+will be read,
+packed onto output lines,
+and justified
+to produce:
+.(b F
+Now is the time
+for all good men
+to come to the aid
+of their party.
+Four score and seven
+years ago,...
+.)b
+Sometimes you may want to start a new output line
+even though the line you are on
+is not yet full;
+for example,
+at the end of a paragraph.
+To do this
+you can cause a
+.i break ,
+which
+starts a new output line.
+Some requests
+cause a break automatically,
+as do blank input lines
+and input lines beginning with a space.
+.pp
+Not all input lines
+are text to be formatted.
+Some of the input lines
+are
+.i requests
+which describe
+how to format the text.
+Requests always have a period
+or an apostrophe
+(\c
+.q "\|\(aq\|" )
+as the first character
+of the input line.
+.pp
+The text formatter
+also does more complex things,
+such as automatically numbering pages,
+skipping over page folds,
+putting footnotes in the correct place,
+and so forth.
+.pp
+I can offer you a few hints
+for preparing text
+for input to \*G.
+First,
+keep the input lines short.
+Short input lines are easier to edit,
+and \*G will pack words onto longer lines
+for you anyhow.
+In keeping with this,
+it is helpful
+to begin a new line
+after every period,
+comma,
+or phrase,
+since common corrections
+are to add or delete sentences
+or phrases.
+Second,
+do not put spaces at the end of lines.
+Third,
+do not hyphenate words at the end of lines
+(except words that should have hyphens in them,
+such as
+.q mother-in-law );
+\*G is smart enough to hyphenate words
+for you as needed,
+but is not smart enough
+to take hyphens out
+and join a word back together.
+Also,
+words such as
+.q mother-in-law
+should not be broken
+over a line,
+since then you will get a space
+where not wanted,
+such as
+.tr @-
+.nh
+.q "mother@\ in@law" .
+.br
+.tr @@
+.hy 14
+.sh 1 "Basic Requests"
+.sh 2 "Paragraphs"
+.pp
+Paragraphs are begun
+by using the
+.b .pp
+request.
+For example,
+the input:
+.(b
+\&.pp
+Now is the time for all good men
+to come to the aid of their party.
+Four score and seven years ago,...
+.)b
+produces a blank line
+followed by an indented first line.
+The result is:
+.(b F
+.ti +\n(piu
+Now is the time for all good men
+to come to the aid of their party.
+Four score and seven years ago,...
+.)b
+.pp
+Notice that the sentences
+of the paragraphs
+.i "must not"
+begin with a space,
+since blank lines
+and lines beginning with spaces
+cause a break.
+For example,
+if I had typed:
+.(b
+\&.pp
+Now is the time for all good men
+      to come to the aid of their party.
+Four score and seven years ago,...
+.)b
+The output would be:
+.(b F
+.ti +\n(piu
+Now is the time for all good men
+      to come to the aid of their party.
+Four score and seven years ago,...
+.)b
+A new line begins after the word
+.q men
+because the second line began with a space character.
+.pp
+There are many
+fancier
+types of paragraphs,
+which will be described later.
+.sh 2 "Headers and Footers"
+.pp
+Arbitrary headers and footers
+can be put
+at the top and bottom
+of every page.
+Two requests
+of the form
+.b .he \ \c
+.i title
+and
+.b .fo \ \c
+.i title
+define the titles to put at the head and the foot
+of every page,
+respectively.
+The titles are called
+.i three-part
+titles,
+that is,
+there is a left-justified part,
+a centered part,
+and a right-justified part.
+To separate these three parts
+the first character of
+.i title
+(whatever it may be)
+is used as a delimiter.
+Any character may be used,
+but
+backslash
+and double quote marks
+should be avoided.
+The percent sign
+is replaced by the current page number
+whenever found in the title.
+For example,
+the input:
+.(b
+\&.he \(aq\(aq%\(aq\(aq
+\&.fo \(aqJane Jones\(aq\(aqMy Book\(aq
+.)b
+results in the page number
+centered at the top
+of each page,
+.q "Jane Jones"
+in the lower left corner,
+and
+.q "My Book"
+in the lower right corner.
+.sh 2 "Double Spacing"
+.pp
+.ls 2
+\*G will double space output text automatically if you
+use the request
+.b ".ls\ 2" ,
+as is done in this section.
+You can revert to single spaced mode
+by typing
+.b ".ls\ 1" .
+.ls 1
+.sh 2 "Page Layout"
+.pp
+A number of requests allow
+you to change the way the printed copy looks,
+sometimes called the
+.i layout
+of the output page.
+Most of these requests adjust the placing
+of
+.q "white space"
+(blank lines or spaces).
+In these explanations,
+characters in italics
+should be replaced with values you wish to use;
+bold characters
+represent characters which should actually be typed.
+.pp
+The
+.b .bp
+request
+starts a new page.
+.pp
+The request
+.b .sp \ \c
+.i N
+leaves
+.i N
+lines of blank space.
+.i N
+can be omitted
+(meaning skip a single line)
+or can be of the form
+.i N \^\c
+.b i
+(for
+.i N
+inches)
+or
+.i N \^\c
+.b c
+(for
+.i N
+centimeters).
+For example, the input:
+.(b
+\&.sp 1.5i
+My thoughts on the subject
+\&.sp
+.)b
+leaves one and a half inches of space,
+followed by the line
+.q "My thoughts on the subject" ,
+followed by a single blank line.
+.pp
+This request will not leave space at the top of a page.
+If you need the requested space to appear regardless of page position,
+use the
+.b .bl
+request, which has the same syntax as
+.b .sp
+but always leaves the requested space, even at the top of a page.
+.pp
+The
+.b .in \ \c
+.i +N
+request
+changes the amount of white space
+on the left of the page
+(the
+.i indent ).
+The argument
+.i N
+can be of the form
+.b + \c
+.i N
+(meaning leave
+.i N
+spaces more than you are already leaving),
+.b \- \c
+.i N
+(meaning leave less than you do now),
+or just
+.i N
+(meaning leave exactly
+.i N
+spaces).
+.i N
+can be of the form
+.i N \^\c
+.b i
+or
+.i N \^\c
+.b c
+also.
+For example,
+the input:
+.(b
+initial text
+\&.in 5
+some text
+\&.in +1i
+more text
+\&.in \-2c
+final text
+.)b
+produces
+.q "some text"
+indented exactly five spaces
+from the left margin,
+.q "more text"
+indented five spaces
+plus one inch
+from the left margin
+(fifteen spaces
+on a pica typewriter),
+and
+.q "final text"
+indented five spaces
+plus one inch
+minus two centimeters
+from the margin.
+That is,
+the output is:
+.(b
+initial text
+.in +5
+some text
+.in +1i
+more text
+.in -2c
+final text
+.)b
+.pp
+The
+.b .ti \ \c
+.i +N
+(temporary indent)
+request is used like
+.b .in \ \c
+.i +N
+when the indent
+should apply to one line only,
+after which it should revert
+to the previous indent.
+For example,
+the input:
+.(b
+\&.in 1i
+\&.ti 0
+Ware, James R.  The Best of Confucius,
+Halcyon House, 1950.
+An excellent book containing translations of
+most of Confucius\(aq most delightful sayings.
+A definite must for anyone interested in the early
+foundations of Chinese philosophy.
+.)b
+produces:
+.in 1i+\n($iu
+.ti \n($iu
+Ware, James R.  The Best of Confucius,
+Halcyon House, 1950.
+An excellent book containing translations of
+most of Confucius' most delightful sayings.
+A definite must for anyone interested in the early foundations
+of Chinese philosophy.
+.pp
+Text lines can be centered
+by using the
+.b .ce
+request.
+The line after the
+.b .ce
+is centered
+(horizontally)
+on the page.
+To center more than one line,
+use
+.b .ce \ \c
+.i N
+(where
+.i N
+is the number of lines to center),
+followed by the
+.i N
+lines.
+If you want to center many lines
+but don't want to count them,
+type:
+.(b
+\&.ce 1000
+lines to center
+\&.ce 0
+.)b
+The
+.b ".ce\ 0"
+request tells \*G to center zero more lines,
+in other words,
+stop centering.
+.pp
+All of these requests
+cause a break;
+that is,
+they always start
+a new line.
+If you want to start a new line
+without performing any other action,
+use
+.b .br .
+.sh 1 "Displays"
+.pp
+Displays are sections of text
+to be set off
+from the body of the paper.
+Major quotes,
+tables,
+and figures
+are types of displays,
+as are all the examples
+used in this document.
+All displays
+except centered blocks
+are output
+single spaced.
+.sh 2 "Major Quotes"
+.pp
+Major quotes
+are quotes which are several lines long,
+and hence are set in from the rest
+of the text
+without quote marks
+around them.
+These can be generated
+using the requests
+.b .(q
+and
+.b .)q
+to surround the quote.
+For example,
+the input:
+.(b
+As Weizenbaum points out:
+\&.(q
+It is said that to explain is to explain away.
+This maxim is nowhere so well fulfilled
+as in the areas of computer programming,...
+\&.)q
+.)b
+generates as output:
+.lp
+As Weizenbaum points out:
+.(q
+It is said that to explain is to explain away.
+This maxim is nowhere so well fulfilled
+as in the areas of computer programming,...
+.)q
+.sh 2 "Lists"
+.pp
+A
+.i list
+is an indented,
+single spaced,
+unfilled display.
+Lists should be used
+when the material to be printed
+should not be filled and justified
+like normal text,
+such as columns of figures
+or the examples used in this paper.
+Lists are surrounded
+by the requests
+.b .(l
+and
+.b .)l .
+For example,
+type:
+.(b
+Alternatives to avoid deadlock are:
+\&.(l
+Lock in a specified order
+Detect deadlock and back out one process
+Lock all resources needed before proceeding
+\&.)l
+.)b
+will produce:
+.br
+Alternatives to avoid deadlock are:
+.(l
+Lock in a specified order
+Detect deadlock and back out one process
+Lock all resources needed before proceeding
+.)l
+.sh 2 "Keeps"
+.pp
+A
+.i keep
+is a display of lines
+which are kept on a single page
+if possible.
+An example of where you would use a keep
+might be a diagram.
+Keeps differ from lists
+in that lists may be broken
+over a page boundary
+whereas keeps will not.
+.pp
+Blocks are the basic kind of keep.
+They begin with the request
+.b .(b
+and end with the request
+.b .)b .
+If there is not room on the current page
+for everything in the block,
+a new page is begun.
+This has the unpleasant effect
+of leaving blank space
+at the bottom of the page.
+When this is not appropriate,
+you can use the alternative,
+called
+.i "floating keeps" .
+.pp
+.i "Floating keeps"
+move relative to the text.
+Hence,
+they are good for things
+which will be referred to
+by name,
+such as
+.q "See figure 3" .
+A floating keep will appear
+at the bottom of the current page
+if it will fit;
+otherwise,
+it will appear at the top
+of the next page.
+Floating keeps begin with the line
+.b .(z
+and end with the line
+.b .)z .
+For an example of a floating keep,
+see figure 1.
+.(z
+.in 1i
+.xl -1i
+.hl
+\&.(z
+\&.hl
+Text of keep to be floated.
+\&.sp
+\&.ce
+Figure 1.  Example of a Floating Keep.
+\&.hl
+\&.)z
+.sp
+.ce
+Figure 1.  Example of a Floating Keep.
+.hl
+.)z
+The
+.b .hl
+request is used
+to draw a horizontal line
+so that the figure
+stands out from the text.
+.sh 2 "Fancier Displays"
+.pp
+Keeps and lists are normally collected in
+.i nofill
+mode,
+so that they are good for tables and such.
+If you want filling enabled in the display
+(for text),
+type
+.b ".(l\ F"
+(Throughout this section,
+comments applied to
+.b .(l
+also apply to
+.b .(b
+and
+.b .(z ).
+This kind of display
+will be indented from both margins.
+For example,
+the input:
+.(b
+\&.(l F
+And now boys and girls,
+a newer, bigger, better toy than ever before!
+Be the first on your block to have your own computer!
+Yes kids, you too can have one of these modern
+data processing devices.
+You too can produce beautifully formatted papers
+without even batting an eye!
+\&.)l
+.)b
+will be output as:
+.(b F
+And now boys and girls,
+a newer, bigger, better toy than ever before!
+Be the first on your block to have your own computer!
+Yes kids, you too can have one of these modern
+data processing devices.
+You too can produce beautifully formatted papers
+without even batting an eye!
+.)b
+.pp
+Lists and blocks are also normally indented
+(floating keeps are normally left justified).
+To get a left-justified list,
+type
+.b ".(l\ L" .
+To get a list centered
+line-for-line,
+type
+.b ".(l C" .
+For example,
+to get a filled,
+left justified list, enter:
+.(b
+\&.(l L F
+text of block
+\&.)l
+.)b
+The input:
+.(b
+\&.(l
+first line of unfilled display
+more lines
+\&.)l
+.)b
+produces the indented text:
+.(b
+first line of unfilled display
+more lines
+.)b
+Typing the character
+.b L
+after the
+.b .(l
+request produces the left justified result:
+.(b L
+first line of unfilled display
+more lines
+.)b
+Using
+.b C
+instead of
+.b L
+produces the line-at-a-time centered output:
+.(b C
+first line of unfilled display
+more lines
+.)b
+.pp
+Sometimes it may be
+that you want to center several lines
+as a group,
+rather than centering them
+one line at a time.
+To do this
+use centered blocks,
+which are surrounded by the requests
+.b .(c
+and
+.b .)c .
+All the lines are centered as a unit,
+such that the longest line is centered
+and the rest are
+lined up around that line.
+Notice that lines
+do not move
+relative to each other
+using centered blocks,
+whereas they do
+using the
+.b C
+argument to keeps.
+.pp
+Centered blocks are
+.i not
+keeps,
+and may be used
+in conjunction
+with keeps.
+For example,
+to center a group of lines
+as a unit
+and keep them
+on one page,
+use:
+.(b
+\&.(b L
+\&.(c
+first line of unfilled display
+more lines
+\&.)c
+\&.)b
+.)b
+.ne 1i
+to produce:
+.(b L
+.(c
+first line of unfilled display
+more lines
+.)c
+.)b
+If the block requests
+(\c
+.b .(b
+and
+.b .)b )
+had been omitted
+the result would have been the same,
+but with no guarantee
+that the lines of the centered block
+would have all been on one page.
+Note the use of the
+.b L
+argument to
+.b .(b ;
+this causes the centered block
+to center within the entire line
+rather than within the line
+minus the indent.
+Also,
+the center requests
+must
+be nested
+.i inside
+the keep requests.
+.sh 1 "Annotations"
+.pp
+There are a number of requests
+to save text
+for later printing.
+.i Footnotes
+are printed at the bottom of the current page.
+.i "Delayed text"
+is intended to be a variant form
+of footnote;
+the text is printed only 
+when explicitly called for,
+such as at the end of each chapter.
+.i Indexes
+are a type of delayed text
+having a tag
+(usually the page number)
+attached to each entry
+after a row of dots.
+Indexes are also saved
+until called for explicitly.
+.sh 2 "Footnotes"
+.pp
+Footnotes begin with the request
+.b .(f
+and end with the request
+.b .)f .
+The current footnote number is maintained
+automatically,
+and can be used by typing \e**,
+to produce a footnote number\**.
+.(f
+\** Like this.
+.)f
+The number is automatically incremented
+after every footnote.
+For example,
+the input:
+.(b
+\&.(q
+A man who is not upright
+and at the same time is presumptuous;
+one who is not diligent and at the same time is ignorant;
+one who is untruthful and at the same time is incompetent;
+such men I do not count among acquaintances.\e**
+\&.(f
+\e** James R. Ware,
+\&.ul
+The Best of Confucius,
+Halcyon House, 1950.
+Page 77.
+\&.)f
+\&.)q
+.)b
+generates the result:
+.(q
+A man who is not upright
+and at the same time is presumptuous;
+one who is not diligent and at the same time is ignorant;
+one who is untruthful and at the same time is incompetent;
+such men I do not count among acquaintances.\**
+.(f
+\** James R. Ware,
+.ul
+The Best of Confucius,
+Halcyon House, 1950.
+Page 77.
+.)f
+.)q
+It is important
+that the footnote
+appears
+.i inside
+the quote,
+so that you can be sure
+that the footnote
+will appear
+on the same page
+as the quote.
+.sh 2 "Delayed Text"
+.pp
+Delayed text
+is very similar to a footnote
+except that it is printed
+when called for explicitly.
+This allows a list of
+references to
+appear
+(for example)
+at the end of each chapter,
+as is the convention in some disciplines.
+Use
+.b \e*#
+on delayed text
+instead of
+.b \e**
+as on footnotes.
+.pp
+If you are using delayed text
+as your standard reference mechanism,
+you can still use footnotes,
+except that you may want to reference them
+with special characters*
+.(f
+*Such as an asterisk.
+.)f
+rather than numbers.
+.sh 2 "Indexes"
+.pp
+An
+.q index
+(actually more like a table of contents,
+since the entries are not sorted alphabetically)
+resembles delayed text,
+in that it is saved until called for.
+However,
+each entry has the page number
+(or some other tag)
+appended to the last line
+of the index entry
+after a row of dots.
+.pp
+Index entries begin with the request
+.b .(x
+and end with
+.b .)x .
+The
+.b .)x
+request may have a argument,
+which is the value to print
+as the
+.q "page number" .
+It defaults to the current page number.
+If the page number given is an underscore
+(\c
+.q _ )
+no page number
+or line of dots
+is printed at all.
+To get the line of dots
+without a page number,
+type
+.b ".)x """"" ,
+which specifies an explicitly null page number.
+.pp
+The
+.b .xp
+request prints the index.
+.pp
+For example,
+the input:
+.(b
+\&.(x
+Sealing wax
+\&.)x
+\&.(x
+Cabbages and kings
+\&.)x _
+\&.(x
+Why the sea is boiling hot
+\&.)x 2.5a
+\&.(x
+Whether pigs have wings
+\&.)x ""
+\&.(x
+This is a terribly long index entry, such as might be used
+for a list of illustrations, tables, or figures; I expect it to
+take at least two lines.
+\&.)x
+\&.xp
+.)b
+generates:
+.(x
+Sealing wax
+.)x
+.(x
+Cabbages and kings
+.)x _
+.(x
+Why the sea is boiling hot
+.)x 2.5a
+.(x
+Whether pigs have wings
+.)x ""
+.(x
+This is a terribly long index entry, such as might be used
+for a list of illustrations, tables, or figures; I expect it to
+take at least two lines.
+.)x
+.xp
+.pp
+The
+.b .(x
+request may have a single character
+argument,
+specifying the
+.q name
+of the index;
+the normal index is
+.b x .
+Thus,
+several
+.q indices
+may be maintained simultaneously
+(such as a list of tables, table of contents, etc.).
+.pp
+Notice that the index must be printed
+at the
+.i end
+of the paper,
+rather than at the beginning
+where it will probably appear
+(as a table of contents);
+the pages may have to be physically rearranged
+after printing.
+.sh 1 "Fancier Features"
+.pp
+A large number of fancier requests
+exist,
+notably requests to provide other sorts of paragraphs,
+numbered sections of the form
+.b 1.2.3
+(such as used in this document),
+and multicolumn output.
+.sh 2 "More Paragraphs"
+.pp
+Paragraphs generally start with
+a blank line
+and with the first line
+indented.
+It is possible to get
+left-justified block-style paragraphs
+by using
+.b .lp
+instead of
+.b .pp ,
+as demonstrated by the next paragraph.
+.lp
+Sometimes you want to use paragraphs
+that have the
+.i body
+indented,
+and the first line
+exdented
+(opposite of indented)
+with a label.
+This can be done with the
+.b .ip
+request.
+A word specified on the same line as
+.b .ip
+is printed in the margin,
+and the body is lined up
+at a prespecified position
+.ne 1i
+(normally five spaces).
+For example,
+the input:
+.(b
+\&.ip one
+This is the first paragraph.
+Notice how the first line
+of the resulting paragraph lines up
+with the other lines in the paragraph.
+\&.ip two
+And here we are at the second paragraph already.
+You may notice that the argument to \c
+.b .ip
+appears
+in the margin.
+\&.lp
+We can continue text...
+.)b
+produces as output:
+.ip one
+This is the first paragraph.
+Notice how the first line of the resulting paragraph lines up
+with the other lines in the paragraph.
+.ip two
+And here we are at the second paragraph already.
+You may notice that the argument to
+.b .ip
+appears
+in the margin.
+.lp
+We can continue text without starting a new indented
+paragraph
+by using the
+.b .lp
+request.
+.pp
+If you have spaces in the label of a
+.b .ip
+request,
+you must use an
+.q "unpaddable space"
+instead of a regular space.
+This is typed as a backslash character
+(\c
+.q \e )
+followed by a space.
+For example,
+to print the label
+.q "Part 1" ,
+enter:
+.(b
+\&.ip "Part\e 1"
+.)b
+.pp
+If a label of an indented paragraph
+(that is, the argument to
+.b .ip )
+is longer than the space allocated for the label,
+.b .ip
+will begin a new line after the label.
+For example,
+the input:
+.(b
+\&.ip longlabel
+This paragraph had a long label.
+The first character of text on the first line
+will not line up with the text on second and subsequent lines,
+although they will line up with each other.
+.)b
+will produce:
+.ip longlabel
+This paragraph had a long label.
+The first character of text on the first line
+will not line up with the text on second and subsequent lines,
+although they will line up with each other.
+.pp
+It is possible to change the size of the label
+by using a second argument
+which is the size of the label.
+For example,
+the above example could be done correctly
+by saying:
+.(b
+\&.ip longlabel 10
+.)b
+which will make the paragraph indent
+10 spaces for this paragraph only.
+If you have many paragraphs to indent
+all the same amount,
+alter the value of the
+.i register
+.b ii .
+For example, to leave one inch of space
+for the label,
+type:
+.(b
+\&.nr ii 1i
+.)b
+somewhere before the first call to
+.b .ip .
+Refer to the reference manual
+for more information.
+.pp
+If
+.b .ip
+is used
+with no argument at all
+no hanging tag will be printed.
+For example,
+the input:
+.(b
+\&.ip a
+This is the first paragraph of the example.
+We have seen this sort of example before.
+\&.ip
+This paragraph is lined up with the previous paragraph,
+but it has no tag in the margin.
+.)b
+produces as output:
+.ip a
+This is the first paragraph of the example.
+We have seen this sort of example before.
+.ip
+This paragraph is lined up with the previous paragraph,
+but it has no tag in the margin.
+.pp
+A special case of
+.b .ip
+is
+.b .np ,
+which automatically
+numbers paragraphs sequentially from 1.
+The numbering is reset at the next
+.b .pp ,
+.b .lp ,
+or
+.b .sh
+(to be described in the next section)
+request.
+For example,
+the input:
+.(b
+\&.np
+This is the first point.
+\&.np
+This is the second point.
+Points are just regular paragraphs
+which are given sequence numbers automatically
+by the \&.np request.
+\&.pp
+This paragraph will reset numbering by \&.np.
+\&.np
+For example,
+we have reverted to numbering from one now.
+.)b
+generates:
+.np
+This is the first point.
+.np
+This is the second point.
+Points are just regular paragraphs
+which are given sequence numbers automatically
+by the \&.np request.
+.pp
+This paragraph will reset numbering by \&.np.
+.np
+For example,
+we have reverted to numbering from one now.
+.pp
+The
+.b .bu
+request gives lists of this sort that are identified with
+bullets rather than numbers.
+The paragraphs are also crunched together.
+For example,
+the input:
+.(b
+\&.bu
+\&One egg yolk
+\&.bu
+\&One tablespoon cream or top milk
+\&.bu
+\&Salt, cayenne, and lemon juice to taste
+\&.bu
+\&A generous two tablespoonfuls of butter
+.)b
+produces\**:
+.(f
+\** By the way,
+if you put the first three ingredients in a a heavy, deep pan
+and whisk the ingredients madly over a medium flame
+(never taking your hand off the handle of the pot)
+until the mixture reaches the consistency of custard
+(just a minute or two),
+then mix in the butter off-heat,
+you will have a wonderful Hollandaise sauce.
+.)f
+.bu
+One egg yolk
+.bu
+One tablespoon cream or top milk
+.bu
+Salt, cayenne, and lemon juice to taste
+.bu
+A generous two tablespoonfuls of butter
+.sh 2 "Section Headings"
+.pp
+Section numbers
+(such as the ones used in this document)
+can be automatically generated
+using the
+.b .sh
+request.
+You must tell
+.b .sh
+the
+.i depth
+of the section number
+and a section title.
+The depth
+specifies how many numbers
+are to appear
+(separated by decimal points)
+in the section number.
+For example,
+the section number
+.b 4.2.5
+has a depth of three.
+.pp
+Section numbers
+are incremented
+in a fairly intuitive fashion.
+If you add a number
+(increase the depth),
+the new number starts out
+at one.
+If you subtract section numbers
+(or keep the same number)
+the final number is incremented.
+For example,
+the input:
+.(b
+\&.sh 1 "The Preprocessor"
+\&.sh 2 "Basic Concepts"
+\&.sh 2 "Control Inputs"
+\&.sh 3
+\&.sh 3
+\&.sh 1 "Code Generation"
+\&.sh 3
+.)b
+produces as output the result:
+.(b
+.b
+1.  The Preprocessor
+1.1.  Basic Concepts
+1.2.  Control Inputs
+1.2.1.
+1.2.2.
+2.  Code Generation
+2.1.1.
+.)b
+.pp
+You can specify the section number to begin
+by placing the section number after the section title,
+using spaces instead of dots.
+For example,
+the request:
+.(b
+\&.sh 3 "Another section" 7 3 4
+.)b
+will begin the section numbered
+.b 7.3.4 ;
+all subsequent
+.b .sh
+requests will number relative to this number.
+.pp
+There are more complex features
+which will cause each section to be indented
+proportionally to the depth of the section.
+For example, if you enter:
+.(b
+\&.nr si \c
+.i N
+.)b
+each section will be indented by an amount
+.i N .
+.i N
+must have a scaling factor attached,
+that is, it must be of the form
+.i Nx ,
+where
+.i x
+is a character telling what units
+.i N
+is in.
+Common values for
+.i x
+are
+.b i
+for inches,
+.b c
+for centimeters,
+and
+.b n
+for
+.i ens
+(the width of a single character).
+For example,
+to indent each section
+one-half inch,
+type:
+.(b
+\&.nr si 0.5i
+.)b
+After this,
+sections will be indented by
+one-half inch
+per level of depth in the section number.
+For example,
+this document was produced
+using the request
+.(b
+\&.nr si 3n
+.)b
+at the beginning of the input file,
+giving three spaces of indent
+per section depth.
+.pp
+Section headers without automatically generated numbers
+can be done using:
+.(b
+\&.uh "Title"
+.)b
+which will do a section heading,
+but will put no number on the section.
+.sh 2 "Parts of the Basic Paper"
+.pp
+There are some requests
+which assist in setting up
+papers.
+The
+.b .tp
+request
+initializes for a title page.
+There are no headers or footers
+on a title page,
+and unlike other pages
+you can space down
+and leave blank space
+at the top.
+For example,
+a typical title page might appear as:
+.(b
+\&.tp
+\&.sp 2i
+\&.(l C
+THE GROWTH OF TOENAILS
+IN UPPER PRIMATES
+\&.sp
+by
+\&.sp
+Frank N. Furter
+\&.)l
+\&.bp
+.)b
+.pp
+The
+.b .+c \ \c
+.i T
+request can be used
+to start chapters.
+Each chapter is automatically numbered
+from one,
+and a heading is printed at the top of each chapter
+with the chapter number
+and the chapter name
+.i T .
+For example,
+to begin a chapter called
+.q Conclusions ,
+use the request:
+.(b
+\&.+c "CONCLUSIONS"
+.)b
+which will produce,
+on a new page,
+the lines
+.(b C
+Chapter 5
+CONCLUSIONS
+.)b
+with appropriate spacing for a thesis.
+Also, the header is moved to the foot of the page
+on the first page of a chapter.
+Although the
+.b .+c
+request was not designed to work only with the
+.b .th
+request,
+it is tuned for the format acceptable
+for a PhD thesis
+at Berkeley.
+.pp
+If the
+title parameter
+.i T
+is omitted from the
+.b .+c
+request,
+the result is a chapter with no heading.
+This can also be used at the beginning
+of a paper;
+for example,
+.b .+c
+was used to generate page one
+of this document.
+.pp
+Although
+papers traditionally have the abstract,
+table of contents,
+and so forth at the front of the paper,
+it is more convenient to format
+and print them last
+when using \*G.
+This is so that index entries
+can be collected and then printed
+for the table of contents
+(or whatever).
+At the end of the paper,
+issue the
+.b ".++ P"
+request,
+which begins the preliminary part
+of the paper.
+After issuing this request,
+the
+.b .+c
+request will begin a preliminary section
+of the paper.
+Most notably,
+this prints the page number
+restarted from one
+in lower case Roman numbers.
+.b .+c
+may be used repeatedly
+to begin different parts of the
+front material
+for example,
+the abstract,
+the table of contents,
+acknowledgments,
+list of illustrations,
+etc.
+The request
+.b ".++ B"
+may also be used
+to begin the bibliographic section
+at the end of the paper.
+For example,
+the paper might appear
+as outlined in figure 2.
+(In this figure,
+comments begin with the sequence
+.b \e" .)
+.(z
+.hl
+.if t .in 0.5i
+.if t .ta 2i
+.if n .ta 3i
+\&.th	\e" set for thesis mode
+\&.fo \(aq\(aqDRAFT\(aq\(aq	\e" define footer for each page
+\&.tp	\e" begin title page
+\&.(l C	\e" center a large block
+THE GROWTH OF TOENAILS
+IN UPPER PRIMATES
+\&.sp
+by
+\&.sp
+Frank Furter
+\&.)l	\e" end centered part
+\&.+c INTRODUCTION	\e" begin chapter named "INTRODUCTION"
+\&.(x t	\e" make an entry into index `t'
+Introduction
+\&.)x	\e" end of index entry
+text of chapter one
+\&.+c "NEXT CHAPTER"	\e" begin another chapter
+\&.(x t	\e" enter into index `t' again
+Next Chapter
+\&.)x
+text of chapter two
+\&.+c CONCLUSIONS
+\&.(x t
+Conclusions
+\&.)x
+text of chapter three
+\&.++ B	\e" begin bibliographic information
+\&.+c BIBLIOGRAPHY	\e" begin another `chapter'
+\&.(x t
+Bibliography
+\&.)x
+text of bibliography
+\&.++ P	\e" begin preliminary material
+\&.+c "TABLE OF CONTENTS"
+\&.xp t	\e" print index `t' collected above
+\&.+c PREFACE	\e" begin another preliminary section
+text of preface
+.sp 2
+.in 0
+.ce
+Figure 2.  Outline of a Sample Paper
+.hl
+.)z
+.sh 2 "Equations and Tables"
+.pp
+Two special \*U programs exist
+to format special types of material.
+.b Eqn
+sets equations.
+.b Tbl
+arranges to print
+extremely pretty tables
+in a variety of formats.
+This document will only describe
+the embellishments
+to the standard features;
+consult the reference manuals
+for those processors
+for a description of their use.
+.pp
+The
+.b eqn
+program is described fully
+in the document
+.ul
+Typesetting Mathematics \- User's Guide
+by Brian W. Kernighan
+and Lorinda L. Cherry.
+Equations are centered,
+and are kept on one page.
+They are introduced by the
+.b .EQ
+request and terminated by the
+.b .EN
+request.
+.pp
+The
+.b .EQ
+request may take an
+equation number as an
+optional argument,
+which is printed vertically centered
+on the right hand side
+of the equation.
+If the equation becomes too long
+it should be split
+between two lines.
+To do this, type:
+.(b
+\&.EQ (eq 34)
+text of equation 34
+\&.EN C
+\&.EQ
+continuation of equation 34
+\&.EN
+.)b
+The
+.b C
+on the
+.b .EN
+request
+specifies that the equation
+will be continued.
+.pp
+The
+.b tbl
+program produces tables.
+It is fully described
+(including numerous examples)
+in the document
+.ul
+Tbl \- A Program to Format Tables
+by M. E. Lesk.
+Tables begin with the
+.b .TS
+request
+and end with the
+.b .TE
+request.
+Tables are normally kept on a single page.
+If you have a table which is too big
+to fit on a single page,
+so that you know it will extend
+to several pages,
+begin the table with the request
+.b ".TS\ H"
+and put the request
+.b .TH
+after the part of the table
+which you want
+duplicated at the top of every page
+that the table is printed on.
+For example, a table definition
+for a long table might look like:
+.ds TA \|\h'.4n'\v'-.2n'\s-4\zT\s0\v'.2n'\h'-.4n'\(ci\|
+.if n .ds TA \ \o'-T'\ \"
+.(b
+\&.TS H
+c s s
+n n n.
+THE TABLE TITLE
+\&.TH
+text of the table
+\&.TE
+.)b
+.sh 2 "Two Column Output"
+.pp
+You can get two-column output
+automatically
+by using the request
+.b .2c .
+This causes everything after it
+to be output in two-column form.
+The request
+.b .bc
+will start a new column;
+it differs from
+.b .bp
+in that
+.b .bp
+may leave a totally blank column
+when it starts a new page.
+To revert to single-column output,
+use
+.b .1c .
+.sh 2 "Defining Macros"
+.pp
+A
+.i macro
+is a collection of requests and text
+which may be used
+by stating a simple request.
+Macros begin with the line
+.b ".de" \ \c
+.i xx
+(where
+.i xx
+is the name of the macro to be defined)
+and end with the line consisting of two dots.
+After defining the macro,
+stating the line
+.b . \c
+.i xx
+is the same as stating all the other lines.
+For example,
+to define a macro
+that spaces 3 lines
+and then centers the next input line,
+enter:
+.(b
+\&.de SS
+\&.sp 3
+\&.ce
+\&..
+.)b
+and use it by typing:
+.(b
+\&.SS
+\&Title Line
+(beginning of text)
+.)b
+.pp
+Macro names may be one or two characters.
+In order to avoid conflicts
+with names in \-me,
+always use upper case letters as names.
+The only names to avoid are
+.b TS ,
+.b TH ,
+.b TE ,
+.b EQ ,
+and
+.b EN .
+.sh 2 "Annotations Inside Keeps"
+.pp
+Sometimes you may want to put
+a footnote
+or index entry inside a keep.
+For example,
+if you want to maintain a
+.q "list of figures"
+you will want to do something like:
+.(b
+\&.(z
+\&.(c
+text of figure
+\&.)c
+\&.ce
+Figure 5.
+\&.(x f
+Figure 5
+\&.)x
+\&.)z
+.)b
+which you may hope
+will give you a figure
+with a label
+and an entry in the index
+.b f
+(presumably a list of figures index).
+Unfortunately,
+the
+index entry
+is read and interpreted
+when the keep is read,
+not when it is printed,
+so the page number in the index is likely to be wrong.
+The solution is to use the magic string
+.b \e!
+at the beginning of all the lines dealing with the index.
+In other words,
+you should use:
+.(b
+\&.(z
+\&.(c
+Text of figure
+\&.)c
+\&.ce
+Figure 5.
+\e!.(x f
+\e!Figure 5
+\e!.)x
+\&.)z
+.)b
+which will defer the processing of the index
+until the figure is output.
+This will guarantee
+that the page number in the index
+is correct.
+The same comments apply
+to
+blocks
+(with
+.b .(b
+and
+.b .)b )
+as well.
+.sh 1 "\*T and the Photosetter"
+.pp
+With a little care,
+you can prepare
+documents that
+will print nicely
+on either a regular terminal
+or when phototypeset
+using the \*T formatting program.
+.sh 2 "Fonts"
+.pp
+A
+.i font
+is a style of type.
+There are three fonts
+that are available simultaneously,
+Times Roman,
+Times Italic,
+and Times Bold,
+plus the special math font.
+The normal font is Roman.
+.pp
+There are ways of switching between fonts.
+The requests
+.b .r ,
+.b .i ,
+.b .b ,
+and
+.b .bi
+switch to Roman,
+italic,
+bold,
+and bold-italic fonts respectively.
+You can set a single word
+in some font
+by typing (for example):
+.(b
+\&.i word
+.)b
+which will set
+.i word
+in italics
+but does not affect the surrounding text.
+.pp
+Notice that if you are setting more than one word
+in whatever font,
+you must surround that word with double quote marks
+(`\|"\|')
+so that it will appear to the \*G processor as a single word.
+The quote marks will not appear in the formatted text.
+If you do want a quote mark to appear,
+you should quote the entire string
+(even if a single word),
+and use
+.i two
+quote marks where you want one to appear.
+For example,
+if you want to produce the text:
+.(b
+.i """Master Control\|"""
+.)b
+in italics, you must type:
+.(b
+\&.i """Master Control\e|"""
+.)b
+The
+.b \e|
+produces a thin space
+so that the
+.q l
+does not overlap the quote sign in \*G,
+like this:
+.(b
+.i """Master Control"""
+.)b
+.pp
+There are also some
+.q pseudo-fonts
+available.
+The input:
+.(b
+\&.(b
+\&.u underlined
+\&.bx "words in a box"
+\&.)b
+.)b
+generates
+.(b
+.u underlined
+.bx "words in a box"
+.)b
+Notice that pseudo font requests
+set only the single parameter in the pseudo font;
+ordinary font requests will begin setting all text
+in the special font
+if you do not provide a parameter.
+No more than one word
+should appear
+with these three font requests
+in the middle of lines.
+This is because
+of the way \*G justifies text.
+For example,
+if you were to issue the requests:
+.(b
+\&.u "some underlined words"
+and
+\&.bx "words in a box"
+.)b
+in the middle of a line
+\*G would produce
+.u "some underlined words"
+and
+.bx "words in a box" ,\p
+which I think you will agree does not look good.
+.pp
+The second parameter
+of all font requests
+is set in the original font.
+For example,
+the font request:
+.(b
+\&.b bold face
+.)b
+generates
+.q bold
+in bold font,
+but sets
+.q face
+in the font of the surrounding text,
+resulting in:
+.(b
+.b bold face.
+.)b
+To set the two words
+.b bold
+and
+.b face
+both in
+.b "bold face" ,
+type:
+.(b
+\&.b "bold face"
+.)b
+.pp
+You can mix fonts in a word by using the
+special sequence
+.b \ec
+at the end of a line
+to indicate
+.q "continue text processing" ;
+this allows input lines
+to be joined together
+without a space between them.
+For example, the input:
+.(b
+\&.u under \ec
+\&.i italics
+.)b
+generates
+.u under \c
+.i italics ,
+but if we had typed:
+.(b
+\&.u under
+\&.i italics
+.)b
+the result would have been
+.u under
+.i italics
+as two words.
+.sh 2 "Point Sizes"
+.pp
+The phototypesetter
+supports different sizes of type,
+measured in points.
+The default point size
+is 10 points
+for most text,
+8 points for footnotes.
+To change the point size,
+type:
+.(b
+\&.sz \c
+.i +N
+.)b
+where
+.i N
+is the size wanted in points.
+The
+.i "vertical spacing"
+(distance between the bottom of most letters
+(the
+.i baseline )
+between adjacent lines)
+is set to be proportional
+to the type size.
+.pp
+These point-size changes are
+.i temporary !!!
+For example,
+to reset the point size of basic text to twelve point, use:
+.(b
+\&.nr pp 12
+\&.nr sp 12
+\&.nr tp 12
+.)b
+to reset the default point size of
+paragraphs,
+section headers,
+and titles respectively.
+If you only want to set the names of sections in a larger point size,
+use:
+.(b
+\&.nr sp 11
+.)b
+alone \*- this sets section titles
+(e.g.,
+.b "Point Sizes"
+above)
+in a larger font than the default.
+.pp
+A single word or phrase can be set in a smaller point size
+than the surrounding text
+using the
+.b .sm
+request.
+This is especially convenient for words that are all capitals,
+due to the optical illusion that makes them look even larger
+than they actually are.
+For example:
+.(b
+\&.sm UNIX
+.)b
+prints as
+.sm UNIX
+rather than
+UNIX.
+.\" Dave Kemper notes that the following probably has not been true
+.\" since 1986; keeping (but commented) for historical interest.
+.\" .pp
+.\" Warning:
+.\" changing point sizes
+.\" on the phototypesetter
+.\" is a slow mechanical operation.
+.\" On laser printers it may require loading new fonts.
+.\" Size changes
+.\" .ne 1i
+.\" should be considered carefully.
+.sh 2 "Quotes"
+.pp
+It is conventional when using
+the typesetter to
+use pairs of grave and acute accents
+to generate double quotes,
+rather than the
+double quote character
+(`\|"\|').
+This is because it looks better
+to use grave and acute accents;
+for example, compare
+"quote" to
+``quote''.
+.pp
+You may use the sequences
+.b \e*(lq
+and
+.b \e*(rq
+to stand for the left and right quote
+respectively.
+For example,
+use:
+.(b
+\e*(lqSome things aren\(aqt true
+even if they did happen.\e*(rq
+.)b
+to generate the result:
+.(b
+.q "Some things aren't true even if they did happen."
+.)b
+As a shorthand,
+the special font request:
+.(b
+\&.q "quoted text"
+.)b
+will generate
+.q "quoted text" .
+Notice that you must surround
+the material to be quoted
+with double quote marks
+if it is more than one word.
+.sx 0
+.uh Acknowledgments
+.pp
+I would like to thank
+Bob Epstein,
+Bill Joy,
+and Larry Rowe
+for having the courage
+to use the \-me macros
+to produce non-trivial papers
+during the development stages;
+Ricki Blau,
+Pamela Humphrey,
+and Jim Joyce
+for their help with the documentation phase;
+peter kessler
+for numerous complaints years after I was
+.q done
+with this project,
+most accompanied by fixes
+(hence forcing me to fix several small bugs);
+and the plethora of people who have contributed ideas
+and have given support for the project.
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.23.0.tar.gz/doc/meintro_fr.me.in Added

@@ -0,0 +1,2374 @@
+.\" groff -kt -me -mfr
+.\"
+.\" Copyright (c) 1986, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)intro.me	8.2 (Berkeley) 06/01/94
+.\"
+.\" Modified for groff by jjc@jclark.com.
+.\"
+.\" Translated to French by Grégoire Babey <gibux@gmx.ch>
+.\"UC 7
+.if t .ll 6.5i
+.if t .lt 6.5i
+.nr sx 0
+.ds MO @VERSION@
+.nr si 3n
+.he '\f(BIgroff\fP en option \f(BI\-me\fP''%'
+.\"eh 'USD:19-%''Writing Papers with NROFF using \-me'
+.\"oh 'Writing Papers with NROFF using \-me''USD:19-%'
+.ds U Unix
+.ds N \fInroff\fP
+.ds T \fItroff\fP
+.ds G \fIgroff\fP
+.ds UG groff\" upright "groff" for use in slanted contexts
+.+c
+.(l C
+.sz 14
+.b "Rédiger des documents avec \f(BIgroff \-me\fP"
+.sz
+.sp 2
+.ul
+Eric P. Allman
+.sp
+Projet INGRES
+Electronics Research Laboratory
+University of California, Berkeley
+Berkeley, California 94720
+.sp 2
+.i "Modifié pour \fR\*(UG\fP par James Clark*"
+.(f
+* Ce document a été
+.i \*(UG\fRé \" defeat italic correction
+le 27 octobre 2001 et s'applique à la version des macros \-me
+inclus dans la version \*(MO de \*G.
+.)f
+.sp 2
+.i "Adapté au français par Grégoire Babey\(dg"
+.(f
+\(dg La traduction française a été
+.i \*(UG\fRée \" defeat italic correction
+le 20 octobre 2013,
+toutes les commandes ont été testées sur la version 1.21 de \*G.
+.)f
+.)l
+.sp 2
+.pp
+Ce document décrit les outils de traitement de texte
+sur un système \*U
+et autres systèmes d'exploitation
+fournis par \*G
+et le
+paquet de macros
+\-me.
+Il présuppose que le lecteur
+est déjà familiarisé avec les systèmes \*U
+et un éditeur de texte
+(tel que par exemple
+.i vi ).
+Son intention est d'être une introduction
+simple et concrète, et par conséquent,
+il ne traitera pas toute la matière disponible.
+En particulier,
+de nombreuses variantes et fonctionnalités supplémentaires
+du paquet de macros \-me ne seront pas décrites.
+Pour une discussion plus complète de telle ou telle fonctionnalité,
+voyez
+.q "\fIme\fP Reference Manual"
+et
+.i "groff: The GNU implementation of troff."
+.pp
+\*G, est un logiciel
+fonctionnant sur le système d'exploitation \*U.
+Il lit un fichier d'entrée
+préparé par l'utilisateur
+et sort un texte formaté,
+prêt à être publié ou mis en page.
+Le fichier d'entrée est formé de
+.i texte ,
+les mots destinés à être imprimés,
+et de
+.i requêtes ,
+qui donnent des instructions au programme \*G
+et lui indiquent quelle forme donner à la copie imprimée.
+.nr ii \w'Chapitre\~\0'u+1n
+.ip "Chapitre\~1"
+décrit les éléments de base du traitement de texte.
+.ip "Chapitre\~2"
+décrit les requêtes de base.
+.ip "Chapitre\~3"
+introduit les mises en évidence: citations, tableaux, figures.
+.ip "Chapitre\~4"
+annotations (notes en bas de page, texte différé, index).
+.ip "Chapitre\~5"
+requêtes plus complexes, n'ayant pu être traitées au chapitre 2.
+.ip "Chapitre\~6"
+les choses que vous devez savoir pour pouvoir rédiger des documents.
+.pp
+Si vous êtes novice,
+vous ne voudrez sans doute pas attendre d'avoir lu jusqu'au chapitre 4
+pour tester par vous mêmes les fonctions de base du programme.
+Quand votre texte sera prêt à être traité,
+appelez le formateur \*G en tapant
+cette commande dans votre shell \*U (ou terminal):
+.(b
+groff \-k \-me \-mfr foo.me > foo.ps
+.)b
+L'option
+.b \-k
+tient compte des caractères accentués propres au français.
+L'option
+.b \-mfr
+permet de configurer les espaces entre les phrases
+ainsi que les césures de manière appropriée
+si on suppose que
+.q foo.me
+est rédigé en français.
+Remplacez
+.q foo
+par le nom de votre fichier qui devra être en un mot.
+Le fichier devra être placé dans votre répertoire personnel,
+sinon remplacez foo par le chemin du fichier.
+À la place de \&.ps,
+vous pouvez mettre \&.pdf ou le format que vous désirez obtenir.
+Vous trouverez un description plus complète des options pour la commande
+\*G en tapant
+.b "man groff"
+dans votre terminal ou console.
+.pp
+Le mot
+.i argument
+est utilisé dans ce manuel
+pour décrire un mot ou un nombre
+qui apparait sur la même ligne qu'une requête
+en modifiant le sens de cette requête.
+Par exemple,
+la requête
+.(b
+\&.sp
+.)b
+met un espace après une ligne,
+mais
+.(b
+\&.sp 4
+.)b
+met 4 espaces après une ligne.
+Le nombre
+.b 4
+est un
+.i argument
+de la requête
+.b .sp
+qui lui dit d'espacer de quatre lignes
+au lieu d'une.
+Les arguments sont séparés de la requête et des autres arguments
+par un espacement.
+.sh 1 "Éléments de base du traitement de texte"
+.pp
+La fonction primaire
+de \*G
+est de
+.i collecter
+des mots sur les lignes du fichier d'entrée, de
+.i remplir
+de ces mots les lignes du ficher de sortie, de
+.i justifier
+le texte sur la marge de droite
+en insérant des espaces supplémentaires entre les mots,
+et de rendre le fichier de sortie.
+Par exemple,
+l'entrée:
+.(b
+Maintenant il est temps
+pour tous les hommes bons
+de venir en aide
+à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+sera lu,
+rendu dans des lignes de sortie,
+et justifié,
+ce qui produira:
+.(b F
+Maintenant il est temps
+pour tous les hommes bons
+de venir en aide
+à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+Parfois,
+vous désirerez commencer une nouvelle ligne,
+même si la ligne actuelle n'est pas encore pleine;
+par exemple,
+à la fin d'un paragraphe.
+Pour y parvenir,
+vous pouvez provoquer une
+.i interruption:
+une ligne d'entrée vide,
+ou une nouvelle ligne commençant par un espacement
+provoquent le début d'une nouvelle ligne.
+Certaines requêtes provoquent automatiquement une interruption.
+.pp
+Les lignes d'entrée ne sont pas toutes destinées à être formatées
+(voir plus bas).
+Certaines lignes sont des
+.i requêtes
+qui décrivent
+comment le texte doit être formaté.
+Les requêtes commencent toujours par un point ou une apostrophe
+(\c
+.q "\|\(aq\|" ).
+.pp
+Le formateur de texte effectue aussi des tâches plus complexes,
+comme la numérotation automatique des pages,
+le saut de page automatique,
+le placement des notes en bas de page au bon endroit,
+et ainsi de suite.
+.pp
+Je peux vous donner quelques conseils
+comment préparer votre texte d'entrée pour \*G.
+Premièrement,
+écrivez des lignes d'entrée courtes.
+Des lignes d'entrée courtes seront plus faciles à modifier,
+et de toutes façons, \*G les saisira pour vous en lignes plus longues.
+En accord avec cette idée,
+il est pratique de commencer une
+nouvelle ligne après
+chaque virgule ou point,
+puisque habituellement les corrections consistent à
+modifier ou supprimer des propositions ou des phrases.
+Deuxièmement,
+n'ajoutez pas d'espacements à la fin des lignes.
+Troisièmement,
+ne séparez pas vous-même les mots en fin de ligne
+avec des traits d'union
+(excepté les mots qui en contiennent naturellement,
+comme
+.q belle-mère );
+\*G est assez futé pour séparer pour vous les mots qui doivent l'être,
+mais il ne l'est pas assez pour réunir les syllabes
+que vous auriez séparées vous-même.
+Ainsi,
+des mots tels que
+.q belle-mère
+ne devraient pas être écrit sur deux lignes,
+sinon vous obtiendrez un espacement là ou vous n'en vouliez pas,
+comme ici par exemple:
+.tr @-
+.nh
+.q "belle@\~mère" .
+.br
+.tr @@
+.hy 14
+.sh 1 "Requêtes de base"
+.sh 2 "Paragraphes"
+.pp
+On commence un nouveau paragraphe
+en utilisant la requête
+.b .pp .
+Par exemple,
+l'entrée:
+.(b
+\&.pp
+Maintenant il est temps pour tous les hommes bons
+de venir en aide à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+donne un ligne d'espacement, suivie d'une ligne indentée.
+Le résultat est:
+.(b F
+.ti +\n(piu
+Maintenant il est temps pour tous les hommes bons
+de venir en aide à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+.pp
+Notez que les phrases d'un paragraphes ne
+.i "devront pas"
+commencer par un espacement,
+puisque une ligne d'espacement ou un espace en début de ligne
+provoque une interruption.
+Par exemple,
+si je tapais:
+.(b
+\&.pp
+Maintenant il est temps pour tous les hommes bons
+      de venir en aide à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+La sortie serait:
+.(b F
+.ti +\n(piu
+Maintenant il est temps pour tous les hommes bons
+      de venir en aide à leur parti.
+Il y a quatre-vingt-sept ans...
+.)b
+Une nouvelle ligne commence après le mot
+.q bons
+parce que la deuxième ligne d'entrée a été commencée avec un espacement.
+.pp
+Il existe beaucoup de types de paragraphes plus élaborés,
+qui seront décrits plus tard.
+.sh 2 "En-têtes et pied de page "
+.pp
+On peut ajouter si on veut des en-têtes et des pieds de page.
+Deux requêtes
+ayant la forme de
+.b .he \~\c
+.i titre
+and
+.b .fo \~\c
+.i titre
+définissent les titres à mettre respectivement en haut
+et en pied de page.
+Ces titres sont appelés titres
+.i "en trois parties"
+:
+une première partie est justifiée sur la gauche,
+la deuxième est centrée,
+la troisième justifiée sur la droite.
+Les trois parties sont séparées par des apostrophes.
+Le signe %,
+si il est présent dans le titre,
+sera automatiquement remplacé par le numéro de page courant.
+Par exemple l'entrée:
+.(b
+\&.he \(aq\(aq%\(aq\(aq
+.)b
+donnera le numéro de page courant centré sur chaque page.
+.(b
+\&.he \(aq\(aq\(aq%\(aq
+.)b
+donnera le numéro de page jusifié à droite sur chaque page.
+.(b
+\&.he \(aqGroff -me\(aqTraduction\(aq%\(aq
+.)b
+donnera à gauche "Groff -me",
+au centre "Traduction" et à droite le numéro de page courant.
+.br
+Les éléments de l'en-tête peuvent débuter par n'importe quelle lettre,
+mais antislash et guillemets sont à éviter.
+La commande
+.b .fo
+fonctionne de manière analogue.
+.sh 2 "Double espacement"
+.pp
+.ls 2
+\*G insère un double espacement vertical dans le texe de sortie
+si vous utilisez la requête
+.b ".ls\~2" ,
+comme cela a été fait ici.
+Vous pouvez retourner à l'espacement vertical simple en tapant
+.b ".ls\~1" .
+.ls 1
+.sh 2 "Layout de la page"
+.pp
+Un certain nombre de requêtes
+vous permettent de modifier la présentation de la copie imprimée,
+ce qu'on appelle le
+.i layout
+de la page de sortie.
+La plupart de ces requêtes ajustent dans le texte des
+.q "espaces blancs"
+(espacement, espacement vertical).
+Dans les explications qui suivent, les caractères en italique
+doivent être remplacés par les valeurs que vous souhaitez;
+les caractères gras
+devront être tapés tels quels.
+.pp
+La requête
+.b .bp
+commence une nouvelle page.
+.pp
+La requête
+.b .sp \~\c
+.i N
+laisse
+.i N
+lignes d'espacement vertical.
+.i N
+peut être négligé
+(dans ce cas, il n'y aura qu'une ligne d'espacement),
+ou peut prendre la forme
+.i N \^\c
+.b i
+(pour
+.i N
+pouces)
+or
+.i N \^\c
+.b c
+(pour
+.i N
+centimètres).
+Par exemple, l'entrée:
+.(b
+\&.sp 3.5c
+Mes pensées sur le sujet
+\&.sp
+.)b
+laissera trois centimètres et demi d'espace sur la gauche,
+suivis de la ligne
+.q "Mes pensées sur le sujet" ,
+suivie elle-même d'un espacement vertical.
+.pp
+Cette requête ne laissera pas d'espacement vertical en haut d'une page.
+Si vous avez besoin de l'espacement que apparaisse quelle que soit la
+position sur la page,
+utilisez la requête
+.b .bl
+, qui a la même syntaxe que
+.b .sp
+mais qui ajoutera toujours l'espacement demandé,
+même en haut d'une page.
+.pp
+La requête
+.b .in \~\c
+.i +N
+change le nombre d'espacements sur la gauche de la page
+(l'
+.i indentation).
+L'argument
+.i N
+peut avoir la forme
+.b + \c
+.i N
+(ce qui veut dire
+.i N
+espacements de plus que ce qu'il y avait avant),
+.b \- \c
+.i N
+(ce qui veut dire
+.i N
+espacements de moins que ce qu'il y avait avant),
+ou juste
+.i N
+(ce qui veut dire exactement
+.i N
+espacements).
+.i N
+peut aussi avoir la forme
+.i N \^\c
+.b i
+ou
+.i N \^\c
+.b c .
+Par exemple,
+l'entrée:
+.(b
+texte initial
+\&.in 5
+plus de texte
+\&.in +1i
+encore plus de texte
+\&.in \-2c
+fin du texte
+.)b
+produit
+.q "texte initial"
+justifié à gauche
+.q "plus de texte"
+indenté à 5 espacements
+de la marge de gauche,
+.q "encore plus d texte"
+indenté à 5 espacements
+plus un pouce
+de la marge de gauche
+(15 espacements sur une machine à écrire à picas),
+et
+.q "fin du texte"
+à 5 espacements
+plus un pouce
+moins deux centimètres
+de la marge de gauche.
+C'est à dire la sortie suivante:
+.(b
+texte initial
+.in +5
+plus de texte
+.in +1i
+encore plus de texte
+.in -2c
+fin du texte
+.)b
+.pp
+La requête
+.b .ti \~\c
+.i +N
+(indentation temporaire)
+est utilisée de la même manière que
+.b .in \~\c
+.i +N
+quand l'indentation ne concerne qu'une seule ligne,
+après quoi on retourne à l'indentation initiale.
+Par exemple,
+l'entrée:
+.(b
+\&.in 1i
+\&.ti 0
+Ware, James R. The Best of Confucius,
+Halcyon House, 1950.
+Un livre excellent,
+qui présente en traduction (anglaise)
+les phrases les plus délicieuses de Confucius.
+Décidément un passage obligé
+pour tous ceux qui s'intéressent
+au fondements primitifs de la philosophie chinoise.
+.)b
+produira:
+.sp 2
+.in 1i+\n($iu
+.ti \n($iu
+Ware, James R. The Best of Confucius,
+Halcyon House, 1950.
+Un livre excellent, qui présente
+en traduction (anglaise) les phrases les plus délicieuses de Confucius.
+Décidément un passage obligé pour tous ceux
+qui s'intéressent au fondements primitifs de la philosophie chinoise.
+.pp
+Les lignes de texte peuvent être centrées en utilisant la requête
+.b .ce .
+La ligne qui suit
+.b .ce
+est centrée (horizontalement)
+sur la page.
+Pour centrer plus qu'une ligne,
+utilisez
+.b .ce \~\c
+.i N
+(où
+.i N
+est le nombre de lignes à centrer),
+suivi de
+.i N
+lignes.
+Si vous voulez centrer plusieurs lignes,
+mais vous vous refusez à les compter,
+tapez:
+.(b
+\&.ce 1000
+lignes à centrer
+\&.ce 0
+.)b
+Cette requête
+.b ".ce\~0"
+dit à \*G de ne centrer plus que 0 lignes,
+c'est à dire,
+d'arrêter de centrer.
+.pp
+Toutes ces requêtes provoquent une interruption;
+c'est à dire qu'elles commencent toutes une nouvelle ligne.
+Si vous voulez commencer une nouvelle ligne sans rien faire d'autre,
+utilisez
+.b .br .
+.sh 1 "Mises en évidences"
+.pp
+Les mises en évidences sont des passages de textes sortis
+du corps de texte.
+Citations,
+tableaux
+et figures
+sont des types de mise en évidence,
+comme le sont tous les exemples
+exposés dans ce document.
+Toutes les mises en évidence,
+exceptés les blocs centrés,
+sont précédés et suivis en sortie d'un seul espacement vertical.
+.sh 2 "Citations longues"
+.pp
+Les citations longues
+sont des citations qui s'étalent sur plusieurs lignes,
+elles sont donc sorties du corps de texte
+et ne sont pas entourées de guillemets.
+Cela peut être réalisé
+en utilisant les requêtes
+.b .(q
+et
+.b .)q
+entourant la citation.
+Par exemple,
+l'entrée:
+.(b
+Comme l'indique Weizenbaum:
+\&.(q
+On dit qu'expliquer, c'est expliquer en s'éloignant.
+Cette maxime ne s'accomplit nulle part aussi bien
+que dans le domaine de la programmation informatique,...
+\&.)q
+.)b
+génère comme sortie:
+.lp
+Comme l'indique Weizenbaum:
+.(q
+On dit qu'expliquer, c'est expliquer en s'éloignant.
+Cette maxime ne s'accomplit nulle part aussi bien
+que dans le domaine de la programmation informatique,...
+.)q
+.sh 2 "Listes"
+.pp
+Une
+.i liste
+est une mise en évidence
+indentée,
+à espacements simples,
+non justifiée.
+On devrait utiliser une liste
+quand le matériel à imprimer
+ne doit pas être justifié comme un texte normal,
+tels les colonnes de figures
+ou les exemples utilisés dans ce document.
+Les listes sont encadrées par les requêtes
+.b .(l
+et
+.b .)l .
+Par exemple,
+tapez:
+.(b
+La famille des Équidés comprend:
+\&.(l
+les chevaux
+les ânes
+les hémiones
+les zèbres
+\&.)l
+.)b
+cela produira:
+.br
+La famille des Équidés comprend:
+.(l
+les chevaux
+les ânes
+les hémiones
+les zèbres
+.)l
+.sh 2 "Clos"
+.pp
+Un
+.i clos
+est un ensemble de lignes mises en évidences
+que l'on désire garder sur la même page
+si possible.
+Par exemple un diagramme.
+Les clos diffèrent des listes.
+Les listes peuvent être réparties sur plusieurs pages,
+tandis que les clos ne peuvent pas l'être.
+.pp
+Les blocs sont un genre primitif de clos.
+Ils débutent avec la requête
+.b .(b
+et se terminent avec la requête
+.b .)b .
+Si il n'y a pas de place sur la page courante
+pour y placer le bloc entier,
+il sera placé sur une nouvelle page.
+Cela a pour effet déplaisant de laisser
+un espace blanc en fin de page.
+Quand cela n'est pas approprié,
+vous pouvez user d'une alternative
+appelée
+.i "clos flottants" .
+.pp
+Les
+.i "clos flottants"
+se déplacent dans le texte.
+Donc,
+il sont appropriés pour les choses
+auxquelles on se réfère nommément, comme
+.q "voir Figure 3" .
+Un clos flottant apparaîtra
+au bas de la page courante
+si il y a la place;
+autrement,
+il apparaîtra
+sur la page suivante.
+Les clos flottants commencent par
+.b .(z
+et finissent par
+.b .)z .
+Comme exemple de clos flottant,
+voir figure 1.
+.(z
+.in 1i
+.xl -1i
+.hl
+\&.(z
+\&.hl
+Texte du clos flottant
+\&.sp
+\&.ce
+Figure 1. Exemple de clos flottant.
+\&.hl
+\&.)z
+.sp
+.ce
+Figure 1. Exemple de clos flottant.
+.hl
+.)z
+La requête
+.b .hl
+est utilisée
+pour dessiner une ligne horizontale
+de sorte que la figure
+soit séparée du texte.
+.sp 15
+.sh 2 "Mises en évidences plus élaborées"
+.pp
+Les clos et les listes sont normalement collectés en mode
+.i non-justifié .
+Ils sont donc propres à contenir des tableaux et autres.
+Si vous voulez obtenir une mise en évidence
+en mode justifié
+(pour du texte),
+tapez
+.b ".(l\~F"
+Tout au long de ce chapitre,
+les remarques s'appliquant à
+.b .(l
+s'appliquent aussi à
+.b .(b
+et
+.b .(z .
+Cette espèce de mise en évidence
+sera indentée des deux côtés.
+Par exemple,
+l'entrée:
+.(b
+\&.(l F
+Et maintenant les garçons et les filles,
+un jouet plus grand,
+plus beau que tout ce qui a existé auparavant!
+Soyez le premier, la première de votre quartier
+à posséder votre propre ordinateur!
+Oui les enfants, vous aussi vous pouvez posséder
+une de ces machines à gérer les informations.
+Vous aussi vous pouvez produire de beaux papiers
+formatés sans même remuer le petit doigt!
+\&.)l
+.)b
+donnera en sortie:
+.(b F
+Et maintenant les garçons et les filles,
+un jouet plus grand,
+plus beau que tout ce qui a existé auparavant!
+Soyez le premier, la première de votre quartier
+à posséder votre propre ordinateur!
+Oui les enfants, vous aussi vous pouvez posséder
+une de ces machines à gérer les informations.
+Vous aussi vous pouvez produire de beaux papiers
+formatés sans même remuer le petit doigt!
+.)b
+.pp
+Par exemple,
+pour obtenir une liste justifiée,
+alignée sur la gauche, entrez:
+.(b
+\&.(l L F
+Et maintenant les garçons et les filles,
+un jouet plus grand,
+plus beau que tout ce qui a existé auparavant!
+Soyez le premier, la première de votre quartier
+à posséder votre propre ordinateur!
+Oui les enfants, vous aussi vous pouvez posséder
+une de ces machines à gérer les informations.
+Vous aussi vous pouvez produire de beaux papiers
+formatés sans même remuer le petit doigt!
+\&.)l
+.)b
+Ce qui donnera:
+.(l L F
+Et maintenant les garçons et les filles,
+un jouet plus grand,
+plus beau que tout ce qui a existé auparavant!
+Soyez le premier, la première de votre quartier
+à posséder votre propre ordinateur!
+Oui les enfants, vous aussi vous pouvez posséder
+une de ces machines à gérer les informations.
+Vous aussi vous pouvez produire de beaux papiers
+formatés sans même remuer le petit doigt!
+.)l
+.pp
+Normalement, les listes et les blocs sont indentés
+(les clos flottant sont normalement alignés sur la gauche).
+Pour obtenir une liste
+alignée sur la gauche,
+tapez
+.b ".(l\~L" .
+Pour obtenir une ligne centrée
+ligne après ligne,
+tapez
+.b ".(l C" .
+L'entrée:
+.(b
+\&.(l
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+\&.)l
+.)b
+produit un texte indenté:
+.(b
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+.)b
+En tapant
+.b L
+après la requête
+.b .(l
+cela produira le même résultat, mais aligné à gauche:
+.(b L
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+.)b
+Si vous utilisez
+.b C
+à la place de
+.b L
+vous obtenez une liste centrée:
+.(b C
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+.)b
+.pp
+Parfois,
+vous voudrez centrer
+plusieurs lignes en groupe
+plutôt que de centrer ligne par ligne.
+Pour le faire,
+utilisez les blocs centrés
+qui sont produits par les requêtes
+.b .(c
+et
+.b .)c .
+Toutes les lignes sont centrées en tant que groupe.
+La ligne la plus longue est centrée par rapport aux marges
+et les lignes plus courtes sont alignées sur la plus longue.
+Notez que si vous utilisez un bloc centré,
+les lignes ne bougent pas les unes par rapport aux autres,
+tandis qu'elles le feront si vous utilisez l'argument
+.b C
+pour les clos.
+.pp
+Les blocs centrés ne sont
+.i pas
+des clos,
+et peuvent même être combinés
+avec eux comme nous allons le voir.
+Par exemple,
+pour centrer des lignes
+en groupe
+et les garder
+sur une même page,
+utilisez:
+.(b
+\&.(b L
+\&.(c
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+\&.)c
+\&.)b
+.\" .ne 1i
+.)b
+ce qui produira:
+.(b L
+.(c
+première ligne d'une mise en évidence non-justifiée
+lignes suivantes
+.)c
+.)b
+Sans les requêtes
+(\c
+.b .(b
+et
+.b .)b )
+le résultat aurait été le même,
+mais sans garantie
+que les lignes du bloc centré
+aient été sur la même page.
+Notez l'usage de l'argument
+.b L
+après
+.b .(b .
+Il fait en sorte
+que le bloc se centre
+sur toute la longueur de la ligne
+plutôt que sur la longueur de ligne raccourcie de l'indentation.
+Aussi,
+la requête demandant de centrer
+doit être placée
+.i à \~l'intérieur
+de la requête formant le clos.
+.sh 1 "Annotations"
+.pp
+Un certain nombre de requêtes
+servent à mettre du texte de côté
+pour l'imprimer plus tard, comme les
+.i "notes en bas de page"
+qui sont imprimées au bas de la page courante.
+.br
+Le
+.i "texte différé"
+est en quelque sorte une variante de la
+note en bas de page;
+le texte n'est imprimé
+qu'au moment où on fait appel à lui,
+par exemple à la fin de chaque chapitre.
+.br
+Les
+.i Index
+sont un genre de texte différé
+ayant un numéro de rappel
+(habituellement le numéro de la page)
+attaché à chaque entrée
+après une rangée de points.
+Les Index sont aussi mis de côté
+jusqu'à ce qu'on fasse explicitement appel à eux.
+.sh 2 "Notes en bas de page"
+.pp
+Une note en bas de page commence avec la requête
+.b .(f
+et se termine avec la requête
+.b .)f .
+La note en bas de page courante
+est maintenue automatiquement,
+et peut être utilisée en tapant \e**,
+ce qui produira un numéro de note\**.
+.(f
+\**Comme celui-ci.
+.)f
+Le numéro est automatiquement incrémenté
+après chaque note en bas de page.
+Par exemple,
+l'entrée:
+.(b
+\&.(q
+Un homme qui n'est pas honnête
+et qui, en même temps, est présomptueux;
+un homme qui n'est pas attentif
+et qui, en même temps, est ignorant;
+un homme qui est rempli de mensonge
+et qui, en même temps, est incompétent;
+un tel homme ne fait pas partie de mes relations.\e**
+\&.(f
+\e**Traduit de :James R. Ware,
+\&.ul
+The Best of Confucius,
+Halcyon House, 1950.
+Page 77.
+\&.)f
+\&.)q
+.)b
+génère le résultat suivant:
+.(q
+Un homme qui n'est pas honnête
+et qui, en même temps, est présomptueux;
+un homme qui n'est pas attentif
+et qui, en même temps, est ignorant;
+un homme qui est rempli de mensonge
+et qui, en même temps, est incompétent;
+un tel homme ne fait pas partie de mes relations.\**
+.(f
+\**Traduit de: James R. Ware,
+.ul
+The Best of Confucius,
+Halcyon House, 1950.
+Page 77.
+.)f
+.)q
+Il est important que la note en bas de page
+apparaisse
+.i "à l'intérieur"
+de la citation,
+ainsi vous serez sûr
+qu'elle
+apparaîtra
+sur la même page
+que la citation.
+.sh 2 "Texte différé"
+.pp
+Le texte différé
+ressemble beaucoup à la note en bas de page
+sauf qu'il est imprimé seulement
+si on fait explicitement appel à lui.
+Cela permet de faire apparaître par exemple
+une liste de références
+à la fin de chaque chapitre,
+ce qui est une convention dans certaines disciplines.
+Utilisez
+.b \e*#
+pour le texte différé
+en lieu et place du
+.b \e**
+des notes en bas de page.
+.pp
+Si vous faites du texte différé
+votre moyen habituel de noter les références,
+vous pourrez toujours utiliser en parallèle
+les notes en bas de page,
+mais, comme référence,
+vous utiliserez alors des signes spéciaux*
+.(f
+*comme un astérisque (!)
+.)f
+plutôt que des numéros.
+.br
+Pour faire apparaître une note en bas de page munie
+d'un signe spécial comme celle que vous admirez ci- dessus,
+entrez:
+.br
+\&...vous utiliserez alors des signes spéciaux*.
+.br
+Suivi de:
+.(b
+\&.(f
+.br
+*comme un astérisque (!).
+.br
+\&.)f
+.)b
+.sh 2 "Index"
+.pp
+Un
+.q index
+(ou plutôt table des matières
+puisque les éléments ne sont pas classés
+par ordre alphabétique)
+ressemble au texte différé,
+par le fait qu'il est gardé en réserve
+jusqu'à ce qu'on fasse appel à lui.
+Cependant,
+chaque élément de l'index
+a un numéro de page
+(ou un autre signe distinctif)
+à la fin de la dernière ligne le décrivant,
+à la suite d'une rangée de points (voir ci-dessous).
+.pp
+Les entrées pour l'index
+commencent avec
+.b .(x
+et finissent avec
+.b .)x .
+Dans chaque chapitre
+dont vous voulez qu'il apparaisse dans l'index,
+introduisez une telle requête
+en répétant l'énoncé du titre**.
+.(f
+**Voir aussi le plan de thèse exposé au chapitre 5.3.
+.)f
+La requête
+.b .)x
+peut avoir un argument,
+quand on veut formuler soi-même
+une valeur prenant la place du
+.q "numéro de page" .
+Sans argument,
+c'est le numéro de page où se trouve la requête
+qui sera utilisé automatiquement.
+Si le numéro de page donné est un trait de soulignage
+(\c
+.q _ )
+aucun numéro de page
+ou ligne de points ne sera imprimé.
+Pour obtenir une ligne de points
+sans numéro de page,
+tapez
+.b ".)x """"" ,
+ce qui signifie qu'il n'y a pas de numéro de page.
+.pp
+La requête
+.b .xp
+imprime l'index.
+.pp
+Par exemple,
+l'entrée:
+.(b
+\&.(x
+Cire à cacheter
+\&.)x
+\&.(x
+Des choux et des rois
+\&.)x _
+\&.(x
+Pourquoi la mer bout
+\&.)x 2.5a
+\&.(x
+Si les cochons avaient des ailes
+\&.)x ""
+\&.(x
+Ceci est une entrée d'index terriblement longue,
+comme on pourrait en avoir besoin pour
+une liste d'illustrations, de tableaux, ou de figures;
+je m'attends à ce qu'elle fasse au moins deux lignes.
+\&.)x
+\&.xp
+.)b
+génère:
+.(x
+Cire à cacheter
+.)x
+.(x
+Des choux et des rois
+.)x _
+.(x
+Pourquoi la mer bout
+.)x 2.5a
+.(x
+Si les cochons avaient des ailes
+.)x ""
+.(x
+Ceci est une entrée d'index terriblement longue,
+comme on pourrait en avoir besoin pour
+une liste d'illustrations, de tableaux, ou de figures;
+je m'attends à ce qu'elle fasse au moins deux lignes.
+.)x
+.xp
+.pp
+La requête
+.b .(x
+peut avoir comme argument
+un caractère unique,
+qui spécifie le
+.q nom
+de l'index;
+l'index normal répond à la requête
+.b x .
+Donc,
+on peut maintenir plusieurs
+.q indices
+simultanément**
+.(f
+**Voir aussi le plan de thèse exposé au chapitre 5.3
+.)f
+(un pour la liste des tableaux, un pour la table des matières, etc.).
+.pp
+Notez que l'index doit
+être imprimé à la
+.i fin
+du document,
+plutôt qu'au début
+où il apparaîtra sans doute
+(en temps que table des matières);
+les pages devront peut-être être réarrangées physiquement
+après impression.
+.sh 1 "Fonctionnalités plus complexes"
+.pp
+Il existe un grand nombre d'autres possibilités,
+notamment des requêtes
+qui fournissent d'autres types de paragraphes,
+des chapitres numérotés en forme
+.b 1.2.3
+(comme ils le sont dans le présent document),
+et l'impression sur plusieurs colonnes.
+.sh 2 "Autres types de paragraphes"
+.pp
+Généralement, les paragraphes
+commencent par un espacement vertical et
+la première ligne est indentée.
+On peut obtenir des paragraphes justifiés
+et alignés à gauche
+en utilisant
+.b .lp
+au lieu de
+.b .pp ,
+comme démontré au paragraphe suivant.
+.lp
+Parfois, vous voudrez utiliser des paragraphes dont le
+.i corps
+est indenté
+et la première ligne
+non-indentée
+et munie d'un label.
+Cela peut être réalisé grâce à la requête
+.b .ip .
+Un mot spécifié sur la même ligne que
+.b .ip
+est imprimé dans la marge,
+et le corps du paragraphe est aligné
+sur une position prédéfinie
+.\" .ne 1i
+(normalement cinq espacements).
+Par exemple,
+l'entrée:
+.(b
+\&.ip un
+Ceci est le premier paragraphe.
+Notez comment le reste de la première
+ligne s'aligne
+sur les autres lignes du paragraphe.
+\&.ip deux
+Et ici nous sommes déjà au second paragraphe.
+Vous noterez que l'argument de \c
+.b .ip
+apparaît dans la marge.
+\&.lp
+Nous pouvons poursuivre ce texte...
+.)b
+produit comme sortie:
+.ip un
+Ceci est le premier paragraphe.
+Notez comment le reste de la première
+ligne s'aligne
+sur les autres lignes du paragraphe.
+.ip deux
+Et ici nous sommes déjà au second paragraphe.
+Vous noterez que l'argument de
+.b .ip
+apparaît dans la marge
+.lp
+Nous pouvons poursuivre ce texte sans
+commencer un nouveau paragraphe indenté
+en utilisant la requête
+.b .lp .
+.pp
+Si vous avez des espacements
+dans le label de la requête
+.b .ip ,
+vous devrez utiliser un
+.q "espacement inremplissable"
+au lieu d'un espacement normal.
+On crée celui-ci à l'aide d'un caractère antislash
+(\c
+.q \e )
+suivi d'un espacement.
+Par exemple,
+pour imprimer le label
+.q "Partie 1" ,
+entrer:
+.(b
+\&.ip "Partie\e 1"
+.)b
+.pp
+Si le label prévu pour un paragraphe indenté
+(c'est à dire l'argument de
+.b .ip )
+est plus long que l'espace prévu pour le label (cinq espacements),
+.b .ip
+commencera une nouvelle ligne après le label.
+Par exemple,
+l'entrée:
+.(b
+\&.ip label\~long
+Ce paragraphe a un label long.
+Le premier caractère du texte de la première ligne
+ne s'alignera pas sur le texte de la seconde ligne
+et suivantes,
+bien que celles-ci soient alignées entre elles.
+.)b
+produira:
+.ip label\~long
+Ce paragraphe a un label long.
+Le premier caractère du texte de la première ligne
+ne s'alignera pas sur le texte de la seconde ligne
+et suivantes,
+bien que celles-ci soient alignées entre elles.
+.pp
+Il est possible de changer la taille du label
+en utilisant un second argument
+qui définit la taille du label.
+Par exemple,
+on pourra écrire l'exemple ci-dessus correctement
+en disant:
+.(b
+\&.ip label\~long 10
+.)b
+qui rendra l'indentation du paragraphe longue de
+10 espacements pour ce paragraphe seulement.
+Si vous avez plusieurs paragraphes à indenter
+de la même longueur,
+utilisez un
+.i "registre de nombres"
+.b ii .
+Par exemple, pour laisser un pouce d'espace
+avant le label,
+tapez:
+.(b
+\&.nr ii 1i
+.)b
+quelque part avant le premier appel de
+.b .ip .
+Pour plus d'informations, voyez le
+.i "Manuel de Référence" .
+.pp
+Si
+.b .ip
+est utilisé
+sans aucun argument
+aucun label ne sera imprimé.
+Par exemple,
+l'entrée:
+.(b
+\&.ip a
+Ceci est le premier paragraphe de l'exemple.
+Nous avons déjà vu ce genre d'exemples auparavant.
+\&.ip
+Ce paragraphe est aligné sur le précédent,
+mais il n'a pas de label dans la marge.
+.)b
+produit la sortie:
+.ip a
+Ceci est le premier paragraphe de l'exemple.
+Nous avons déjà vu ce genre d'exemples auparavant.
+.ip
+Ce paragraphe est aligné sur le précédent,
+mais il n'a pas de label dans la marge.
+.pp
+Un cas spécial de
+.b .ip
+est
+.b .np ,
+qui numérote automatiquement
+les paragraphes de manière séquentielle à partir de 1.
+La numérotation repart de 1 à la prochaine requête
+.b .pp ,
+.b .lp ,
+or
+.b .sh
+(cette dernière est décrite au chapitre suivant).
+Par exemple,
+l'entrée:
+.(b
+\&.np
+Ceci est le premier point.
+\&.np
+Ceci est le second point.
+Les "points" sont juste des paragraphes normaux
+auxquels on donne automatiquement un numéro
+à l'aide de la requête \&.np.
+\&.pp
+Ce paragraphe remet la numérotation par \&.np à 1.
+\&.np
+Là par exemple,
+nous avons recommencé la numérotation à 1.
+.)b
+génère:
+.np
+Ceci est le premier point.
+.np
+Ceci est le second point.
+Les "points" sont juste des paragraphes normaux
+auxquels on donne automatiquement un numéro
+à l'aide de la requête \&.np.
+.pp
+Ce paragraphe remet la numérotation à 1 à cause de \&.pp.
+.np
+Là par exemple,
+nous avons recommencé la numérotation à 1.
+.pp
+La requête
+.b .bu
+donne des listes de ce type,
+qui sont identifiées par des puces
+plutôt que par des numéros.
+Les paragraphes sont aussi regroupés verticalement.
+Par exemple,
+l'entrée:
+.(b
+\&.bu
+\&Un jaune d'oeuf
+\&.bu
+\&Une c.-à-s. de crème
+\&.bu
+\&Sel, poivre de Cayenne et jus de citron pour assaisonner
+\&.bu
+\&Deux bonnes c.-à-s. de beurre
+.)b
+produit\**:
+.(f
+\**Par ailleurs,
+si vous mettez ces trois ingrédients
+dans une cocotte assez haute,
+et que vous remuez le tout comme un cinglé à feu moyen
+(ne lâchez jamais l'anse de la cocotte)
+jusqu'à ce que le mélange ait la consistance d'une béchamel
+(ce qui prend juste une à deux minutes),
+si ensuite,
+vous retirez la cocotte du feu et vous incorporez le beurre,
+vous obtiendrez une délicieuse sauce hollandaise.
+.)f
+.bu
+Un jaune d'oeuf
+.bu
+Une c.-à-s. de crème
+.bu
+Sel, poivre de Cayenne et jus de citron pour assaisonner
+.bu
+Deux bonnes c.-à-s. de beurre
+.sh 2 "Titres de chapitres"
+.pp
+Les titres de chapitre
+(comme ceux utilisés dans ce document)
+peuvent être générés automatiquement
+pa la requête
+.b .sh .
+Vous devez indiquer à la requête
+.b .sh
+la
+.i profondeur
+du numéro de chapitre
+et le titre du chapitre.
+La profondeur indique
+combien de nombres doivent apparaître
+(séparés par des points décimaux)
+dans le numéro de chapitre.
+Par exemple,
+le numéro de chapitre
+.b 4.2.5
+a une profondeur de trois.
+.pp
+Les numéros de chapitres
+sont incrémentés
+de façon assez intuitive.
+Si vous ajoutez un numéro
+(ce faisant, vous augmentez la profondeur),
+le nouveau numéro commencera à 1.
+Si vous enlevez un numéro de chapitre
+(vous réduisez la profondeur)
+ou que vous gardez
+le même nombre de chapitre
+(vous gardez la même profondeur),
+le numéro final sera incrémenté.
+Par exemple,
+l'entrée:
+.(b
+\&.sh 1 "Le Préprocesseur"
+\&.sh 2 "Concepts de base"
+\&.sh 2 "Entrées de contrôle"
+\&.sh 3
+\&.sh 3
+\&.sh 1 "Produire du code"
+\&.sh 3
+.)b
+donnera comme résultat:
+.(b
+.b
+1. Le Préprocesseur
+1.1. Concepts de base
+1.2. Entrées de contrôle
+1.2.1.
+1.2.2.
+2. Produire du code
+2.1.1.
+.)b
+.pp
+Vous pouvez spécifier le numéro de chapitre dès le départ
+en plaçant le numéro de chapitre après le titre de chapitre,
+en utilisant des espacements à la place des points.
+Par exemple,
+la requête:
+.(b
+\&.sh 3 "un autre chapitre" 7 3 4
+.)b
+commencera par le chapitre ayant le numéro
+.b 7.3.4 ;
+toutes les requêtes
+.b .sh
+suivantes seront numérotées relativement à ce chapitre.
+.pp
+Il y a des fonctionnalités encore plus complexes
+qui vont indenter le titre de chaque chapitre,
+sous-chapitre, ou sous-sous-chapitre
+relativement à sa profondeur.
+Par exemple, si vous entrez:
+.(b
+\&.nr si \c
+.i N
+.)b
+chaque titre et sous-titre sera indenté d'une quantité
+.i N .
+.i N
+a un facteur d'échelle attaché,
+c'est à dire qu'il doit avoir la forme
+.i Nx ,
+où
+.i x
+indique de quelle unité est
+.i N .
+Les valeurs courantes pour
+.i x
+.b i
+pour les pouces (inches),
+.b c
+pour les centimètres,
+et
+.b n
+pour les
+.i ens
+(= une largeur de caractère).
+Par exemple,
+pour indenter chaque sous-chapitre
+d'un demi-pouce,
+tapez:
+.(b
+\&.nr si 0.5i
+.)b
+après cette requête,
+les titre de chapitres seront indentés
+d'un demi-pouce
+par niveau de profondeur.
+Par exemple,
+le présent document a écrit
+en ayant recours à la requête
+.(b
+\&.nr si 3n
+.)b
+au début du fichier d'entrée,
+ce qui donne trois espacements d'indentation
+par niveau de profondeur du chapitre.
+.pp
+Des numéros de chapitre
+sans indentation automatique
+peuvent être créés
+grâce à la requête:
+.(b
+\&.uh "Titre"
+.)b
+qui fera un titre de chapitre,
+sans numérotation.
+.sh 2 "Les parties du document"
+.pp
+Certaines requêtes sont là pour
+aider à mettre en forme le document.
+La requête
+.b .tp
+initialise une page de titre.
+Sur une page de titre,
+il n'y a ni en-tête ni pied de page, et,
+contrairement à ce qui se passe sur les autres pages,
+vous pouvez laisser des grands espaces blancs
+en haut de la page.
+Par exemple,
+une page de titre typique aura cette apparence:
+.(b
+\&.tp
+\&.sp 7c
+\&.(l C
+LA CROISSANCE DES ONGLES D\(aqORTEILS
+CHEZ LES PRIMATES SUPÉRIEURS
+\&.sp
+par
+\&.sp
+Frank N. Furter
+\&.)l
+\&.bp
+.)b
+.pp
+La requête
+.b .+c \~\c
+.i T
+peut être utilisée pour
+commencer un nouveau chapitre.
+Chaque nouveau chapitre sera numéroté automatiquement
+à partir de 1,
+et le titre sera imprimé au début de chaque chapitre
+avec le numéro de chapitre
+et le nom du chapitre
+.i T .
+Par exemple,
+pour commencer un chapitre s'intitulant
+.q Conclusions,
+utilisez la requête:
+.(b
+\&.+c "CONCLUSIONS"
+.)b
+qui produira sur une nouvelle page,
+les lignes
+.(b C
+Chapitre 5
+CONCLUSIONS
+.)b
+avec des espacements appropriés pour une thèse.
+L'en-tête aussi est déplacé en bas de page
+sur la première page d'un chapitre\** \&.
+.(f
+\**Voir la première page de ce document
+.)f
+.pp
+Si on omet le paramètre de titre
+.i T
+après la requête
+.b .+c
+,
+Le chapitre résultant sera un chapitre sans titre.
+cela peut être utilisé au commencement d'un document;
+par exemple,
+.b .+c
+a été utilisé pour créer la page 1
+du présent document.
+.pp
+Même si traditionnellement
+les documents ont le résumé,
+la table des matières,
+etc... au début du document,
+si vous utilisez
+\*G,
+il sera plus pratique
+de les rédiger en dernier.
+Il faut vous dire que les entrées d'index
+peuvent être collectées en amont
+et être imprimées
+dans la table des matières
+(ou d'autres index).
+À la fin du document,
+utilisez la requête
+.b ".++ P" ,
+qui commence la partie préliminaire du document.
+Après cette requête,
+la requête
+.b .+c
+commencera une section préliminaire
+pour votre document.
+Remarquez que,
+cela imprime le numéro de la page
+en repartant de 1
+en chiffres romains minuscules.
+.b .+c
+peut être utilisé plusieurs fois d'affilée
+pour ébaucher les différentes parties du document.
+Par exemple,
+le résumé,
+la table des matières,
+les remerciements,
+la liste des illustrations,
+etc.
+La requête
+.b ".++ B"
+peut aussi être employée
+pour commencer le chapitre de bibliographie
+à la fin du document.
+.pp
+Une ébauche peut être organisée
+comme le montre la figure 2 ci-dessous.
+(Dans cette figure,
+les commentaires débutent par la requête
+.b \e" .)
+.(z
+.hl
+.if t .in 0.5i
+.if t .ta 2i
+.if n .ta \w'.+c "CHAPITRE SUIVANT"'u+1n
+\&.fo \(aq\(aqÉBAUCHE\(aq\(aq	\e" définir un pied de page pour chaque\
+ page
+\&.tp			\e" commencer la page de titre
+\&.(l C			\e" liste centrée
+LA CROISSANCE
+DES ONGLES D\(aqORTEILS
+CHEZ LES PRIMATES SUPÉRIEURS
+\&.sp
+par
+\&.sp
+Frank Furter
+\&.)l			\e" fin de la liste centrée
+\&.+c INTRODUCTION	\e" début du chapitre intitulé "INTRODUCTION"
+\&.(x t			\e" faire une entrée pour l\(aqindex "t"
+Introduction
+\&.)x 			\e" fin de l\(aqentrée d\(aqindex
+texte du chapitre 1	\e" =Introduction
+\&.+c "CHAPITRE SUIVANT"	\e" commencer un nouveau chapitre
+\&.(x t			\e" faire un entrée pour l\(aqindex "t"
+Chapitre suivant
+\&.)x
+texte du chapitre 2	\e" =chapitre suivant
+\&.+c CONCLUSIONS
+\&.(x t
+Conclusions
+\&.)x
+texte du chapitre 3	\e" =Conclusions
+\&.++ B			\e" commencer la bibliographie
+\&.+c BIBLIOGRAPHIE	\e" commencer un nouveau "chapitre"
+\&.(x t
+Bibliographie
+\&.)x
+texte de la bibliographie
+\&.++ P			\e" commencer la partie préliminaire...
+\&.	\e" ...du document
+\&.+c "TABLE DES MATIÈRES"
+\&.xp t			\e" imprimer l\(aqindex "t" collecté en amont
+\&.+c PREFACE		\e" commencer un nouveau chapitre...
+\&.	\e" ...dans la partie préliminaire.
+texte de la préface
+.sp 2
+.in 0
+.ce
+Figure 2. Ébauche d'un exemple de document.
+.hl
+.)z
+.sh 2 "Équations et Tableaux"
+.pp
+Il existe deux programmes \*U spécialement conçus
+pour formater les types de matières spéciaux.
+.b Eqn
+imprime les équations.
+.b Tbl
+permet d'imprimer
+de très jolis tableaux
+dans toute une variété de formats.
+Le présent document décrira seulement comment
+rendre plus jolie
+leur fonctionnalités standard.
+Pour savoir
+comment ces deux programmes fonctionnent
+consultez les manuels de référence de ces processeurs\**.
+.(f
+\**N.d.tr.
+.b "man eqn"
+et
+.b "man tbl"
+.)f
+.pp
+Le logiciel
+.b eqn
+est décrit complètement
+dans le document
+.ul
+Typesetting Mathematics \- User's Guide
+par Brian W. Kernighan
+and Lorinda L. Cherry\**.
+.(f
+\**Disponible sur la toile
+.)f
+Les équations sont centrées
+et restent sur une page.
+On les introduit dans le texte par la requête
+.b .EQ
+et on les termine par la requête
+.b .E .
+.pp
+La requête
+.b .EQ
+peut avoir un numéro d'équation comme
+argument optionnel.
+Ce numéro sera imprimé centré
+à droite de l'équation.
+Si l'équation devient trop longue,
+on devra l'imprimer sur deux lignes.
+Pour faire ceci, tapez:
+.(b
+\&.EQ (eq 34)
+texte de l'équation 34
+\&.EN C
+\&.EQ
+continuation de l'équation 34
+\&.EN
+.)b
+Le
+.b C
+après la requête
+.b .EN
+spécifie que l'équation
+sera continuée.
+.pp
+Le programme
+.b tbl
+produit des tableaux.
+Il est décrit complètement
+(avec des exemples numériques)
+dans le document
+.ul
+Tbl \- A Program to Format Tables
+par M. E. Lesk\**.
+.(f
+\**Également disponible sur la toile
+.)f
+Les tableaux commencent par la requête
+.b .TS
+et se terminent par la requête
+.b .TE .
+Normalement, les tableaux restent sur la même page.
+Si vous avez un tableau trop grand
+pour tenir sur une seule page,
+et dont vous savez
+qu'il lui en faudra plusieurs,
+commencez le tableau avec la requête
+.b ".TS\~H"
+et mettez la requête
+.b .TH
+après la ligne du tableau
+que vous voulez
+imprimer au début de chaque page
+contenant le tableau.
+Par exemple, la définition
+d'un long tableau
+pourrait être:
+.ds TA \|\h'.4n'\v'-.2n'\s-4\zT\s0\v'.2n'\h'-.4n'\(ci\|
+.if n .ds TA \~\o'-T'\~\"
+.(b
+\&.TS H
+c s s
+n n n.
+TITRE DU TABLEAU
+\&.TH
+texte du tableau
+\&.TE
+.)b
+.sh 2 "Sortie sur deux colonnes"
+.pp
+Vous pouvez rédiger votre texte sur deux colonnes
+automatiquement
+grâce à la requête
+.b .2c .
+Cela rendra tout contenu
+suivant cette requête
+sur deux colonnes.
+La requête
+.b .bc
+commencera une nouvelle colonne;
+elle diffère de
+.b .bp
+en ce que
+.b .bp
+peut laisser une colonne totalement
+vide quand il commence une nouvelle page.
+Pour revenir à l'impression sur une colonne,
+utilisez
+.b .1c .
+.sh 2 "Définir un macro"
+.pp
+Un
+.i macro
+est un ensemble formé de requêtes et de texte
+qui peut être résumé
+en une seule requête.
+Les macros commencent par la ligne
+.b ".de" \~\c
+.i xx
+(où
+.i xx
+est le nom du macro que l'on va définir)
+et elle finit par une ligne consistant en 2 points.
+Après avoir défini le macro,
+écrire la ligne
+.b . \c
+.i xx
+revient à écrire toutes les autres lignes.
+Par exemple,
+pour définir un macro
+qui espace de trois lignes
+et centre les lignes qui suivent,
+entrez:
+.(b
+\&.de SS
+\&.sp 3
+\&.ce
+\&..
+.)b
+et utilisez en rédigeant:
+.(b
+\&.SS
+\&Ligne de titre
+(début du texte)
+.)b
+.pp
+Les noms des macros peuvent être formés d'un ou deux caractères.
+Pour éviter les conflits avec des noms de requêtes
+dans \-me,
+utilisez toujours des majuscules.
+Les seuls noms à éviter sont
+.b TS ,
+.b TH ,
+.b TE ,
+.b EQ ,
+and
+.b EN .
+.sh 2 "Annotations à l'intérieur d'un clos"
+.pp
+Parfois, vous voudrez insérer
+une note en bas de page
+ou une entrée d'index
+à l'intérieur d'un clos.
+Par exemple,
+si vous vouliez maintenir une
+.q "liste des figures"
+vous pourriez vouloir faire quelque chose comme:
+.(b
+\&.(z
+\&.(c
+texte de la figure
+\&.)c
+\&.ce
+Figure 5.
+\&.(x f
+Figure 5
+\&.)x
+\&.)z
+.)b
+et vous pourriez espérer
+que ça donne une figure
+avec un label
+et une entrée d'index
+.b f
+(probablement une liste des figures).
+Par malheur,
+l'entrée d'index
+est lue et interprétée
+lorsque le clos est lu,
+et non pas lorsqu'il est imprimé,
+et donc le numéro de page dans l'index sera probablement erroné.
+La solution est d'utiliser la chaîne magique
+.b \e!
+au début de chaque ligne se rapportant à l'index.
+Autrement dit,
+vous utiliserez:
+.(b
+\&.(z
+\&.(c
+Texte de la figure
+\&.)c
+\&.ce
+Figure 5.
+\e!.(x f
+\e!Figure 5
+\e!.)x
+\&.)z
+.)b
+qui différera l'indexation
+jusqu'à ce que la figure soit en sortie.
+Cela garantira
+que le numéro de la page dans l'index soit correct.
+Le même commentaire s'applique aussi
+aux blocs (avec
+.b .(b
+et
+.b .)b )
+.
+.sh 1 "\*T et le photocompositeur"
+.pp
+Avec un peu de soin,
+vous pouvez préparer
+des documents
+qui seront joliment imprimés
+sur un terminal normal,
+ou, si vous avez besoin d'un photocompositeur,
+en utilisant le programme de formatage \*T \&.
+.sh 2 "Polices"
+.pp
+Une
+.i police
+est un style de caractères.
+Trois polices sont
+disponibles simultanément,
+Times Roman,
+Times italique,
+et Times en gras,
+plus la police spéciale pour les maths.
+La police normale est Roman.
+.pp
+On peut à tout instant
+changer de police.
+Les requêtes
+.b .r ,
+.b .i ,
+.b .b ,
+et
+.b .bi
+changent respectivement sur Roman,
+italique,
+gras,
+et italique gras.
+Vous pouvez mettre un seul mot
+dans une certaine police
+en tapant (par exemple):
+.(b
+\&.i mot
+.)b
+ce qui mettra ce
+.i mot
+en italique,
+mais n'affectera pas le texte environnant.
+.pp
+Notez que si vous voulez mettre plus d'un mot à la fois
+dans une police de votre choix,
+vous devez entourer ces mots de guillemets
+(`\|"\|')
+ainsi, pour le processeur \*G, ils apparaîtront comme un seul mot.
+Les guillemets n'apparaîtront pas dans le texte.
+Si vous voulez que des guillemets apparaissent dans le texte,
+vous devrez mettre toute la chaîne de caractères entre guillemets
+(même si il s'agit d'un seul mot),
+et utiliser
+.i deux
+paires de guillemets,
+quand vous voulez qu'une paire apparaisse.
+Par exemple,
+si vous voulez produire le texte:
+.(b
+.i """poisson d'avril\|"""
+.)b
+en italique, vous devez taper:
+.(b
+\&.i """poisson d'avril\e|"""
+.)b
+Le
+.b \e|
+produit un petit espacement
+de sorte que
+.q l
+d'
+.i avril
+ne soit pas trop proche des guillemets dans \*G,
+comme cela l'est ici:
+.(b
+.i """poisson d'avril"""
+.)b
+.pp
+Quelques
+.q pseudo-polices
+sont disponibles.
+L'entrée:
+.(b
+\&.(b
+\&.u souligné
+\&.bx "mots dans un cadre"
+\&.)b
+.)b
+génère
+.(b
+.u souligné
+.bx "mots dans un cadre"
+.)b
+Notez que les requêtes de pseudo-police
+ne mettent qu'un seul paramètre dans la pseudo-police;
+les requêtes de police ordinaire (.r, \&.i, \&.b, et \&.bi)
+vont commencer à mettre
+tout le texte qui suit
+dans la police spéciale
+si vous ne fournissez pas de paramètre précis\**.
+.(f
+\**N.d.tr. Pour cela,
+commencer une nouvelle ligne directement après la requête.
+La police spéciale sera maintenue jusqu'à la fin du paragraphe.
+.)f
+Si vous utilisez ces requêtes de pseudo-polices (.u, \&.bx)
+au milieu des lignes,
+elles ne devraient porter vraiment que sur un seul mot.
+Ceci à cause de la manière
+de laquelle \*G justifie le texte.
+Par exemple,
+si vous voulez utiliser les requêtes:
+.(b
+\&.u "mots soulignés"
+et
+\&.bx "mots dans un cadre"
+.)b
+au milieu d'une ligne,
+\*G produirait
+.u "mots soulignés"
+et
+.bx "mots dans un cadre" ,\p
+ce qui, vous l'admettrez sans peine, n'est pas très joli.
+.pp
+Le second paramètre
+de toutes les requêtes de police
+est dans la police d'origine.
+Par exemple,
+la requête de police:
+.(b
+\&.b hardi petit
+.)b
+génère
+.q hardi
+en caractères gras,
+mais mettra
+.q petit
+dans la police du texte environnant,
+ce qui donne:
+.(b
+.b hardi petit.
+.)b
+Pour avoir les deux mots
+.b hardi
+et
+.b petit
+en gras
+.b "hardi petit" ,
+tapez:
+.(b
+\&.b "hardi petit"
+.)b
+.pp
+Vous pouvez panacher les polices à l'intérieur
+d'un seul mot en utilisant une séquence spéciale
+.b \ec
+en fin de ligne
+pour indiquer
+.q "continuer à traiter le texte" ;
+cela permet aux lignes d'entrée
+d'être mises bout à bout
+sans être interrompues par un espacement.
+Par exemple, l'entrée:
+.(b
+\&.u sou \ec
+\&.i ligné
+.)b
+génère
+.u sou \c
+.i ligné ,
+mais si nous avions tapé:
+.(b
+\&.u sou
+\&.i ligné
+.)b
+le résultat aurait été
+.u sou
+.i ligné
+en deux mots.
+.sh 2 "Tailles de caractères"
+.pp
+Le photocompositeur
+supporte différentes tailles de caractères,
+mesurées en points.
+La taille de caractères par défaut
+est 10 points
+pour le corps de texte,
+8 points pour les notes en bas de page.
+Pour changer la taille des caractères,
+tapez:
+.(b
+\&.sz \c
+.i N
+.)b
+où
+.i N
+est la taille souhaitée exprimée en points.
+Vous pouvez aussi
+.q "ajouter de la taille"
+avec la requête
+.(b
+\&.sz \c
+.i +N
+.)b
+ou en
+.q enlever
+en utilisant le signe - à la place de + \&.
+.br
+L'
+.i "espacement vertical"\**
+.(f
+\**Distance entre le bas de la plupart des lettre
+(la
+.i "ligne de base")
+de deux lignes adjacentes.
+.)f
+sera proportionnel à
+la taille des caractères.
+.pp
+Avec
+.b .sz
+, ces changements de tailles de caractères sont
+.i temporaires !!!
+Pour revenir à la taille par défaut, tapez simplement
+.(b
+\& \&.sz
+.)b
+Si vous voulez influencer systématiquement
+la taille des éléments de votre texte,
+utilisez les commandes
+.b .nr:
+.(b
+\&.nr pp 12
+.)b
+met tout corps de texte se trouvant après cette commande à 12 pts.
+.(b
+\&.nr sp 12
+.)b
+met tous les titres de chapitre suivant cette commande à 12 pts.
+.(b
+\&.nr tp 12
+.)b
+met tous les en-têtes et pieds de page suivant cette commande à 12 pts.
+Vous la placerez avantageusement directement après la commande
+.b .he
+(ou
+.b .fo ).
+.pp
+On peut donner à un seul mot ou phrase
+une taille plus petite
+que celle du texte environnant
+en utilisant la requête
+.b .sm .
+Cela convient spécialement aux mots écrits en capitales,
+à cause d'une illusion d'optique qui les fait paraître
+plus grandes qu'elles ne le sont vraiment.
+Par exemple:
+.(b
+\&.sm UNIX
+.)b
+s'imprime
+.sm UNIX ,
+ce qui est plus joli que UNIX.
+.\" Dave Kemper notes that the following probably has not been true
+.\" since 1986; keeping (but commented) for historical interest.
+.\" .pp
+.\" Avertissement:
+.\" changer les tailles de caractères
+.\" sur le photocompositeur
+.\" est une opération mécanique lente.
+.\" Sur les imprimantes laser, il faudra peut-être recharger de
+.\" nouvelles polices.
+.\" Dès lors les changements de tailles de caractères devraient être
+.\" .ne 1i
+.\" utilisés avec prudence.
+.sh 2 "Guillemets"
+.pp
+En typographie,
+pour créer des guillemets,
+il est habituel
+d'utiliser deux accents graves et deux accents aigus,
+plutôt que les guillemets
+(`\|"\|').
+C'est parce que
+deux accents graves et deux accents aigus
+donnent un meilleur résultat optique.
+Par exemple, comparez
+"guillemets" à
+``guillemets''.
+.pp
+Vous pourrez aussi utiliser la séquence
+.b \e*(lq
+et
+.b \e*(rq
+pour mettre les guillemets respectivement à gauche et à droite
+du mot ou de l'expression concernés.
+Par exemple,
+utilisez:
+.(b
+\e*(lqCertaines choses ne sont pas vraies,
+même si elles ont eu lieu.\e*(rq
+.)b
+génère le résultat:
+.(b
+\*(lqCertaines choses ne sont pas vraies,
+même si elles ont eu lieu.\*(rq
+.)b
+Plus rapide, la requête:
+.(b
+\&.q "texte entre guillemets"
+.)b
+générera
+.q "texte entre guillemets" .
+Notez que vous devez entourer
+le texte concerné de guillemets
+s'il est formé de plusieurs mots.
+.sx 0
+.uh Remerciements
+.pp
+J'aimerais remercier
+Bob Epstein,
+Bill Joy,
+et Larry Rowe
+pour avoir eu le courage
+d'utiliser les macros \-me
+pour écrire des documents inhabituels
+durant la phase de développement;
+Ricki Blau,
+Pamela Humphrey,
+et Jim Joyce
+pour leur aide durant la phase de documentation;
+Peter Kessler
+pour ses nombreux griefs,
+des années après que j'aie considéré le projet comme
+.q achevé ,
+le plus souvent accompagnés de propositions de solutions
+(qui m'ont donc forcé à réparer plusieurs petits bogues);
+et la foule de gens qui ont contribué à ce projet
+par leurs idées ou leur soutien.
+.(b
+.uh "Annexe: petit lexique des noms de requêtes"
+Par ordre d'apparition dans le texte
+.sp
+.TS
+tab(|);
+L L Lx.
+\&.sp|space|espacement
+\&.pp|paragraph|nouveau paragraphe
+\&.he|header|en-tête
+\&.fo|footer|pied de page
+\&.ls|line spacing|T{
+espacement vertical (entre les lignes)
+T}
+\&.in|indent|indentation
+\&.ce|center|centrer
+\&.br|break|T{
+interruption (commence une nouvelle ligne)
+T}
+\&.(q|quote|citation (début)
+\&.)q|quote|citation (fin)
+\&.(l|list|liste (début)
+\&.)l|list|liste (fin)
+\&.(b|bloc|bloc (début)
+\&.)b|bloc|bloc (fin)
+\&.(z|floating keep|clos flottant (début)
+\&.)z|floating keep|clos flottant (fin)
+\&.hl|horizontal line|ligne horizontale
+\&.(c|centered block|bloc centré (début)
+\&.)c|centered block|bloc centré (fin)
+\&.(f|footnote|note en bas de page (début)
+\&.)f|footnote|note en bas de page (fin)
+\&.(x|index|T{
+faire apparaître dans l'index (début)
+T}
+\&.)x|index|T{
+faire apparaître dans l'index (fin)
+T}
+\&.xp|print index|imprimer l'index
+\&.lp|lined up paragraph|T{
+paragraphe aligné (à 1e ligne non-indentée)
+T}
+\&.ip|indented paragraph|T{
+paragraphe indenté, sauf en sa première ligne
+T}
+\&.np|numbered paragraph|paragraphe numéroté
+\&.sh|set header|faire un titre
+\&.uh|unnumbered header|titre non-numéroté
+\&.tp|title page|page de titre
+\&.+c|add chapter|ajouter un chapitre
+\&.EQ|equation|équation (début)
+\&.EN|equation|équation (fin)
+\&.TS|table start|tableau (début)
+\&.TE|table end|tableau (fin)
+\&.2c|2 column|écrire sur 2 colonnes
+\&.1c|1 columns|écrire sur 1 colonne
+\&.de xx|define macro|définir un macro
+\&.r|roman|roman
+\&.i|italic|italique
+\&.b|bold|gras
+\&.bi|bold italic|italique gras
+\&.u|underlined|souligné
+\&.bx|box|encadré
+\&.sz|size|taille de police
+\&.sm|small|T{
+plus petit que le texte environnant
+T}
+\&.q|quoted|entre guillemets
+.TE
+.)b
+.\" Local Variables:
+.\" mode: nroff
+.\" coding: utf-8
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.23.0.tar.gz/doc/meref.me.in Added

@@ -0,0 +1,2439 @@
+.\" Copyright (c) 1986, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)ref.me	8.2 (Berkeley) 06/01/94
+.\"
+.\" Modified by jjc@jclark.com and g.branden.robinson@gmail.com for
+.\" groff.
+.\"UC 7
+.nr fi 1n
+.nr sx 0
+.\"pn 0
+.ds MO @VERSION@
+.de TL			\" *** title line
+.lp
+.di XX
+..
+.ie \n(.g \{\
+.de DE
+\?\h'|\\n(DIu'\c\?
+..
+.\}
+.el \{\
+.de DE
+\\\\h'|\\\\n(DIu'\\\\c
+..
+.\}
+.am DE
+.br
+.di
+.in +\\n(DIu
+.ti 0
+.XX
+.rm XX
+..
+.ds UG groff\" upright "groff" for use outside of running text
+.ds UM me\" upright "me"
+.ds G \fI\*(UG\fP\"
+.ds N \fInroff\fP\"
+.ds T \fItroff\fP\"
+.ds ME \fI\*(UM\fP\"
+.ds MR \f(BI\*(UM\fP Reference Manual\"
+.\" Compute an indentation for the macro and string synopses based on
+.\" the length of the longest entry.
+.nr DI \w'.sh \(+-N T a b c d e f'+2n
+.he '\*(MR''%'
+.de NR
+.b "\en\\$1" "\\$2"
+..
+.de ST
+.b "\e*\\$1" "\\$2"
+..
+.\"sc
+.\"eh 'USD:20-%''\-me Reference Manual'
+.\"oh '\-me Reference Manual''USD:20-%'
+.+c
+.ce 20
+.sz 14
+.b "\*(MR"
+.sz
+.sp
+.i "for \fR\*(UG \*(UM\fP version \*(MO*"
+.(f
+* based on \fIe.tmac\fP 8.1 from 4.4BSD
+.)f
+.sp 2
+.ul
+Eric P. Allman
+.sp
+.i "Adapted for \fR\*(UG\fP by James Clark and G.\& Branden Robinson"
+.ce 0
+.sp 4
+.pp
+This document describes
+in terse form
+the features
+of the \*(ME macro package
+for \*G.
+Some familiarity with the latter is assumed.
+Specifically,
+the reader should understand
+breaks;
+filling;
+adjustment;
+font selection;
+type sizes;
+the definition and use of
+registers,
+strings,
+and macros;
+and typographical units of measurement:
+points, ems, ens, and vees.
+For a more casual introduction
+to text processing,
+refer to
+.\" the document \" slack phrasing for widow/orphan control
+.q "Writing Papers with \*G using \-\*(ME" .
+.pp
+Many of the package's rendering parameters
+can be adjusted through
+registers,
+strings,
+and macro calls.
+Macro arguments are denoted with lowercase letters for
+numeric values
+(suffixed with a scaling unit if appropriate)
+and with uppercase for text arguments.
+Default parameter values are shown in square brackets.
+The notation
+.i \(+-n
+indicates a numerical value with an optional leading sign.
+Without the sign,
+it assigns a value
+.i n.
+With it,
+it expresses alteration of an existing value by the amount
+.i n.
+\*(ME's font registers may be set only to mounting positions.
+Position zero tells \*(ME to perform no font change;
+the font of the preceding text
+is used instead.
+Position zero is a
+.q pseudo-font ;
+that is,
+it is interpreted and handled by the macros.
+In contrast,
+using position zero
+may produce unexpected results
+in a font selection escape sequence such as
+.b \ef0 ,
+because those are interpreted directly by \*T.
+\*(ME's type size registers support only integral values in points.
+Changes to parameters
+that affect the layout of the page
+(notably page length and vertical margins)
+should be done before calling
+any paragraphing or sectioning macros.
+Normally,
+vertical space is suppressed at the top of a page
+if no text has yet appeared
+(page headers notwithstanding).
+.pp
+\*G measures distances
+in device-specific basic units,
+so it is often necessary
+to specify measurements with a scaling unit.
+For instance,
+to set the paragraph indentation
+to eight ens,
+input
+.q ".nr pi 8n" .
+.q ".nr pi 8"
+makes the paragraph indentation eight basic units,
+or 8/72,000 inches on
+.i grops,
+\*G's PostScript output driver.
+.pp
+Registers and strings
+with names of the form
+.b $ \c
+.bi x
+may be used in expressions and text
+but should not be changed.
+Macros with names of the form
+.b $ \c
+.bi x
+are
+.i hooks,
+called internally by \*(ME,
+and can be redefined
+to alter their function.
+This may be a sensitive operation;
+look at the macro definition in the
+.i e.tmac
+file before changing it.
+If you don't require a given hook,
+(re)define it as empty instead of removing it.
+.pp
+Objects in \*(ME
+follow a rigid naming convention.
+To avoid conflict,
+any user-defined register,
+string,
+or macro
+names should be single numerals or uppercase letters,
+or any longer character sequence
+including at least one uppercase letter.\**
+.(f
+\**
+For portability between BSD and \*G \*(ME,
+limit names to
+two characters,
+and avoid names starting with
+.b 
+(left square bracket).
+.)f
+The names employed
+by any preprocessors in use
+should also not be repurposed.
+.\" dead-tree pagination
+.br
+.ne 8v
+.sh 1 "Paragraphing"
+.TL
+.b .lp
+.DE
+Begin left-aligned paragraph.
+Centering,
+right-alignment,
+and underlining are canceled.
+The font is set to
+.NR (pf
+1,
+the type size
+to
+.NR (pp
+10p,
+and vertical spacing
+(text baseline spacing)
+to
+.NR (tv
+120%
+of the type size.
+Vertical space of
+.NR (ps
+0.35v
+is inserted
+before the paragraph.
+The indentation is reset
+to
+.NR ($i
+0
+plus
+.NR (po
+0
+unless the paragraph
+is inside a display
+(see
+.b .ba ).
+At least
+the first two output lines
+of the paragraph
+are kept together
+on a page.
+.TL
+.b .pp
+.DE
+Like
+.b .lp ,
+but apply a (further) indentation of
+.NR (pi
+5n
+to the first output line.
+.TL
+.b .ip
+.i T
+.i i
+.DE
+Like
+.b .lp ,
+but set the paragraph
+with an optional hanging tag
+.i T
+empty
+and the remainder indented by
+.i i
+\c
+.NR (ii
+5n.
+The tag
+.i T
+is
+.q exdented
+(the opposite of
+.i in dented).
+Any spaces in
+.i T
+must be unbreakable.
+If
+.i T
+does not fit in the space
+.i i,
+.b .ip
+breaks the line after
+.i T .
+.TL
+.b .np
+.DE
+Like
+.b .ip ,
+but tag the paragraph with a number in parentheses,
+starting at 1.
+Each subsequent
+.b .np
+call increments it.
+The paragraph number is stored in
+.NR ($p
+and reset to 1 by
+.b .lp ,
+.b .pp ,
+.b .bu ,
+.b .sh ,
+and
+.b .sx .
+.TL
+.b .bu
+.DE
+Like
+.b .ip ,
+except that the tag is a bullet (\(bu).
+No vertical space is inserted
+between adjacent bulleted paragraphs,
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+enabling the construction of compact itemized lists.
+.sh 1 "Sectioning"
+.pp
+Numbered sections
+are similar to paragraphs
+except that a
+section number of the form
+.q 1.2.3
+is automatically
+generated for each.
+\*(ME supports up to six levels of sectioning;
+any given section has a
+.i depth
+that determines
+the quantity of components
+(separated by dots)
+shown in its section number.
+Unnumbered section headings are similar,
+except that no number is prefixed
+to the section title.
+.TL
+.b .sh
+.i \(+-n
+.i T
+.i "a b c d e f"
+.DE
+Begin section with numbered heading
+of depth
+.i \(+-n
++0
+and optional title
+.i T
+empty.
+Vertical space of
+.NR (ss
+1v
+precedes the heading.
+The components
+of the section number
+are maintained in
+.NR ($1
+through
+.NR ($6 ;
+combined,
+they are available in
+.ST ($n .
+Automatic section numbering at all depths begins at 1.
+The heading is set in font
+.NR (sf
+3
+at size
+.NR (sp
+10p
+and uses the indentation of its parent depth;
+a further indentation of
+.NR (so
+0
+is applied only to its output line.
+The section number is followed by a period,
+after which the typeface is set
+to the paragraph font
+.NR (pf
+at size
+.NR (pp
+so that content may follow immediately
+on the same output line.
+.b .sh
+ensures that there is enough room
+to format the section heading
+with the beginning of a paragraph on the same page
+(about 3 lines total).
+If any of
+.i a
+through
+.i f
+all empty
+is specified,
+each component of the section number
+is assigned the corresponding argument
+instead of being automatically adjusted.
+A hyphen
+(\c
+.q \- )
+for a component argument
+prevents its alteration.
+If
+.i T
+is an underscore
+(\c
+.q _ ),
+the section depth and numbering are reset,
+the base indentation is not,
+and nothing is output\(em\c
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+this is useful to automatically
+coordinate section numbers with
+chapter numbers.
+If all components are zero,
+no number is output.
+.TL
+.b .sx
+.i \(+-n
+.DE
+Go to section depth
+.i \(+-n
+\-1,
+but emit no section heading
+and do not increment the section number.
+This has the effect of an
+.b .lp
+call
+at the new depth.
+.TL
+.b .uh
+.i T
+.DE
+Begin unnumbered section.
+Like
+.b .sh ,
+without the section numbering features.
+.TL
+.b .$p
+.i T
+.i B
+.i n
+.DE
+Output section heading.
+.i T
+is the title,
+.i B
+is the concatenated number,
+and
+.i n
+is the depth.
+These parameters are not always present;
+.b .sh
+passes all three,
+.b .uh
+only the first,
+and
+.b .sx
+all three,
+but the first two
+are empty.
+If
+.i n
+is present,
+the section indentation is set to
+.NR (si
+times\~\c
+.i n .
+.TL
+.b .$0
+.i T
+.i B
+.i n
+.DE
+This hook macro,
+normally empty,
+is called automatically
+by
+.b .sh
+and
+.b .uh
+after they call
+.b .$p ,
+and is passed the same arguments.
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+You can define it to,
+for instance,
+automatically put
+each section title
+into a table of contents
+using
+.b .(x
+and
+.b .)x .
+.TL
+.b .$ \c
+.bi n
+.DE
+These hook macros
+(where
+.i n
+is an integer 1\(en6)
+are called by
+.b .$p
+just before it outputs
+a section heading
+of depth
+.i n.
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+They could be used
+to obtain section depth-dependent spacing.
+.sh 1 "Headers, Footers, and Margins"
+.ds TP \(aq\,\fIL\/\fP\(aq\,\fIM\/\fP\(aq\,\fIR\/\fP\(aq
+.pp
+Headers and footers
+are known as
+.i "three-part titles"
+for their left,
+middle,
+and right-hand components
+.i L,
+.i M,
+and
+.i R.
+The components are separated
+by a
+.i delimiter,
+shown here as a neutral apostrophe,
+but which can be any character
+that does not occur in any of the components.
+Any defined title is
+placed on the page automatically,
+set in font
+.NR (tf
+3
+at size
+.NR (tp
+10p.
+Each title definition
+applies starting with the
+.i next
+page;
+titles intended for output on the first page
+should be defined prior to any sectioning or paragraphing macro calls.
+A title
+must be quoted
+if it contains more than two adjacent spaces
+or more than eight spaces total.
+.pp
+The placement
+of headers and footers
+is controlled by four registers
+initialized to values scaled
+with respect to the default type size and vertical spacing.
+.NR (hm
+4v
+is the distance from the top of the page
+to the top of the header,
+.NR (fm
+3v
+that from the bottom of the page
+to the bottom of the footer,
+.NR (tm
+7v
+that from the top of the page
+to the top of the text,
+and
+.NR (bm
+6v
+that from the bottom of the page
+to the (nominal) bottom of the text.
+.pp
+\*(ME uses \*T's environment 0 for body text,
+1 for keeps
+(see below),
+and 2 for headers and footers.
+The default line length is two inches less than the page width
+(e.g.,
+6.5i on U.S.\& letter paper).
+The default page offset
+(left margin)
+is determined by the output device;
+it is typically 1.0i on typesetting devices and 0 on terminals.
+.TL
+.b .xl
+.i \(+-n
+.DE
+Set line length to
+.i n
+see above
+only in the current environment.
+.TL
+.b .ll
+.i \(+-n
+.DE
+Set line length to
+to
+.i n
+see above
+in all environments used by \*(ME,\**
+.(f
+\**
+\*(ME uses only the three environments of AT&T \*T,
+but in GNU \*T,
+the user can create additional ones.
+.b .ll
+works like
+.b .xl
+for the latter.
+.)f
+and store it in
+.NR ($l .
+This macro should not be used
+after output has begun,
+and particularly not in multi-column layouts.
+.TL
+.b .he
+\*(TP
+.DE
+Define header
+to be placed at the top
+of every page.
+.TL
+.b .fo
+\*(TP
+.DE
+Define footer
+to be placed at the bottom
+of every page.
+.TL
+.b .eh
+\*(TP
+.DE
+Define header
+to be placed at the top
+of every even-numbered page.
+.TL
+.b .oh
+\*(TP
+.DE
+Define header
+to be placed at the top
+of every odd-numbered page.
+.TL
+.b .ef
+\*(TP
+.DE
+Define footer
+to be placed at the bottom
+of every even-numbered page.
+.TL
+.b .of
+\*(TP
+.DE
+Define footer
+to be placed at the bottom
+of every odd-numbered page.
+.TL
+.b .hx
+.DE
+Suppress headers and footers
+on the next page.
+.TL
+.b .$h
+.DE
+Output the page header.
+Care should be taken when redefining this macro.
+Doing so
+can disable the
+.b .he ,
+.b .fo ,
+.b .eh ,
+.b .oh ,
+.b .ef ,
+and
+.b .of
+macros,
+as well as the chapter-style title feature
+of
+.b .+c .
+.TL
+.b .$f
+.DE
+Output the page footer;
+the same comments apply
+as to
+.b .$h .
+.TL
+.b .$H
+.DE
+This hook macro is called
+at the top of each page
+(after the header and any
+pending floating keeps are emitted)
+and of each column in multi-column mode.
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+Use it for column headings.
+.sh 1 "Displays"
+.pp
+Display macros enclose material;
+their names are of the form
+.b .( \c
+.bi x
+and
+.b .) \c
+.bi x ,
+and must be paired.
+Not all display types can nest
+with themselves or each other.
+All displays except centered blocks
+and long quotations
+are preceded and followed
+by an extra
+.NR (bs
+0.35v
+of vertical space
+and use a vertical spacing of
+.NR (dv
+120%.
+Long quotation pre- and post-space is stored in a dedicated register,
+while centered blocks have none;
+both use the vertical spacing of normal text,
+.NR (tv .
+.TL
+.b .(l
+.i A
+.i F
+.DE
+Begin list.
+Text until
+.b .)l
+is set in font
+.NR (df
+0
+with filling disabled.
+If
+.i A
+\c
+.b I 
+is
+.b I ,
+the list is indented by
+.NR (bi
+4m;
+if
+.b M ,
+it is set at the left margin;
+if
+.b L ,
+it is left-aligned
+(distinguishably from
+.b M
+only if the base indentation
+is not zero);
+and if
+.b C ,
+the list is centered on a line-by-line basis.
+If
+.i F
+empty
+is
+.b F ,
+filling is enabled.
+.TL
+.b .)l
+.DE
+End list.
+.\" dead-tree pagination
+.br
+.ne 4v
+.TL
+.b .(q
+.DE
+Begin long quotation.
+Text until
+.b .)q
+is filled,
+indented on the left and right
+by
+.NR (qi
+4n,
+preceded and followed
+by
+.NR (qs
+0.35v
+space,
+and set at type size
+.NR (qp
+\-1p.
+.TL
+.b .)q
+.DE
+End long quotation.
+.TL
+.b .(b
+.i A
+.i F
+.DE
+Begin a block,
+a form of
+.i keep:
+\*(ME tries to avoid breaking a page
+or column between
+.b .(b
+and
+.b .)b .
+Such a break is allowed anyway
+if respecting the keep
+would leave more than
+.NR (bt
+0
+vees of blank space
+below it.
+If
+.NR (bt
+is zero,
+this threshold feature
+is disabled:
+the break will not occur within the keep.
+The font and
+.i A
+and
+.i F
+arguments are handled as with
+.b .(l .
+.TL
+.b .)b
+.DE
+End block.
+.\" dead-tree pagination
+.br
+.ne 3v
+.TL
+.b .(z
+.i A
+.i F
+.DE
+Begin floating keep.
+Like
+.b .(b ,
+except that
+.i A
+defaults to
+.b M
+and the keep
+.i floats
+to the bottom of the page or column
+if it fits,
+or the top of the next otherwise.
+Its position relative to adjacent formatted text
+is thus flexible.
+.NR (zs
+1v
+space
+precedes and follows
+a floating keep.
+.TL
+.b .)z
+.DE
+End floating keep.
+.TL
+.b .(c
+.DE
+Begin centered block.
+Input until
+.b .)c
+is collected,
+its longest output line centered,
+and the remainder aligned with respect to that line;
+contrast with the line-by-line centering obtained with
+\(lq\c
+.b ".(b C" \(rq.
+.TL
+.b .)c
+.DE
+End centered block.
+.sh 1 "Annotations"
+.pp
+Some annotation macros are also mandatorily paired enclosures,
+as display macros are.
+.TL
+.b .(d
+.DE
+Begin delayed text.
+Input until
+.b .)d
+is saved for later output by
+.b .pd .
+Delayed text regions are numbered
+starting at 1;
+the number is kept in
+.NR ($d
+and in the associated string
+.ST # .
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+Endnotes are one application.
+.TL
+.b .)d
+.DE
+End delayed text.
+.NR ($d
+and the associated string
+.ST #
+are incremented.
+.TL
+.b .pd
+.DE
+Emit delayed text:
+output everything accumulated with
+.b .(d
+since the last call to
+.b .pd .
+The delayed text number is reset to 1.
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+This might be used
+at the end of each chapter.
+.TL
+.b .(f
+.DE
+Begin footnote.
+Input until
+.b .)f
+is saved for output
+when the foot of the page is reached.
+Footnotes are numbered
+starting at 1;
+the number is kept in
+.NR ($f
+and in the associated string
+.ST * .
+The text of the footnote
+floats to the bottom
+of the page
+and set in font
+.NR (ff
+1
+at size
+.NR (fp
+8p.
+Each entry
+is preceded by
+.NR (fs
+0.2v
+space,
+indented
+.NR (fi
+3n
+on its first line,
+and
+.q undented
+(indented from the right margin)
+by
+.NR (fu
+0.
+Footnotes line up underneath
+columns in the page layout.
+.\" XXX: Quantify when debugged.  See Savannah #58447, #63163, #63164.
+If the footnote's content
+does not fit on the page,
+it carries over
+to the next.
+.TL
+.b .)f
+.DE
+End footnote.
+.NR ($f
+and the associated string
+.ST *
+are incremented
+if the latter has been interpolated
+outside a footnote.
+.TL
+.b .$s
+.DE
+Output footnote separator:
+draw a horizontal line up to 2 inches wide.
+Called by
+.b .(f .
+Any redefinition should produce output
+no more than one vee in height.
+.TL
+.b .(x
+.i X
+.DE
+Begin index entry.
+Input until
+.b .)x
+is saved in an index named
+.i X
+\c
+.b x 
+until called up with
+.b .xp.
+Each entry is preceded
+by
+.NR (xs
+0.2v
+of vertical space
+and undented by
+.NR (xu
+0.5i;
+that amount of space is reserved
+on the right end of the line
+for the
+(possibly affixed)
+page number.
+.TL
+.b .)x
+.i P
+.i A
+.DE
+End index entry.
+The entry
+is rendered with a
+.i leader
+(row of dots)
+up to an affix
+(such as a volume number and
+separating punctuation)
+.i A
+empty
+followed by
+.i P
+\c
+.NR % 
+right-aligned on the last line of the entry.
+If
+.i A
+is specified,
+.i P
+must be as well.
+If
+.i P
+is an underscore,
+the leader,
+.i P,
+and any
+.i A
+are suppressed.
+.TL
+.b .xp
+.i X
+.DE
+Emit index
+.i X
+\c
+.b x 
+using the current font and type size
+with display vertical spacing
+(\c
+.NR (dv ).
+.\" dead-tree pagination
+.br
+.ne 4v
+.sh 1 "Columnated Output"
+.TL
+.b .2c
+.i \(+-s
+.i n
+.DE
+Enter multi-column mode,
+formatting text in
+.i n
+2
+columns of equal width.
+The column separation
+(\c
+.q gutter )
+is set to
+.i \(+-s
+4n,
+saved
+in
+.NR ($s ,
+and persists until changed by this macro.
+The
+.i n
+columns with
+.i n \-1
+gutters
+fill the single-column line length;
+each column's line length
+is stored in
+.NR ($l .
+The current column number
+is in
+.NR ($c
+and the number of columns in
+.NR ($m .
+.TL
+.b .1c
+.DE
+Leave multi-column mode;
+return to single-column layout.
+.TL
+.b .bc
+.DE
+Begin new column.
+Like
+.b .bp ,
+but begin a column
+on a new page
+only if necessary.
+.\" dead-tree pagination
+.br
+.ne 4v
+.sh 1 "Type Size and Font Styles"
+.TL
+.b .sz
+.i \(+-p
+.DE
+Set the type size to
+.i \(+-p
+10p,
+and the vertical spacing per
+.NR (tv .
+These do
+.i not
+persist beyond many \*(ME macro calls:
+paragraph macros reset
+the type size and vertical spacing.
+Similarly,
+headers/footers,
+section headings,
+long quotations,
+footnotes,
+and
+chapter titles
+alter them.
+.pp
+\*(ME assumes that font positions 1 through 4 correspond to
+roman,
+italic,
+bold,
+and bold-italic typefaces,
+respectively.
+Use the
+.b .fp
+request to mount your preferred fonts in these positions.
+.pp
+The following macros
+style or decorate an argument
+.i W
+and accept an optional second argument
+.i X,
+formatted as the previous text without intervening space.
+To suppress a word break after the call,
+populate or suffix
+.i X
+with
+.b \ec .
+.TL
+.b .r
+.i W
+.i X
+.DE
+Set
+.i W
+in the roman style.
+If no parameters,
+change to the roman style.
+.TL
+.b .i
+.i W
+.i X
+.DE
+Set
+.i W
+in italics.
+If no parameters,
+change to the italic style.
+.TL
+.b .b
+.i W
+.i X
+.DE
+Set
+.i W
+in boldface.
+If no parameters,
+switch to the bold style.
+.TL
+.b .bi
+.i W
+.i X
+.DE
+Set
+.i W
+in bold italics.
+If no parameters,
+switch to the bold-italic style.
+.TL
+.b .q
+.i W
+.i X
+.DE
+Quote
+.i W ,
+surrounding it with
+with
+.b \(lq
+and
+.b \(rq .
+.TL
+.b .sm
+.i W
+.i X
+.DE
+Set
+.i W
+one point smaller than the surrounding type.
+It has no effect in \*N mode.
+.TL
+.b .u
+.i W
+.i X
+.DE
+Underline
+.i W.
+On typesetting output devices,
+this is true underlining,
+in contrast to the
+.b .ul
+request,
+which changes to the
+.q "underline font"
+(usually italics in \*G).
+On terminal output devices,
+.i W
+is surrounded by underscores.
+This argument should not be subject to adjustment,
+hyphenation,
+or breaking;
+.b .u
+is reliable only when filling is disabled.
+.TL
+.b .bx
+.i W
+.i X
+.DE
+Set
+.i W
+in a box.
+On typesetting output devices,
+.i W
+is surrounded by rules (lines).
+On terminal output devices,
+.i W
+is simulated with ISO\~6429 color escape sequences
+or surrounded by vertical bars.
+It is not marked specially on
+.i groff 's
+.b html
+output device.
+This argument should not be subject to adjustment,
+hyphenation,
+or breaking;
+.b .bx
+is reliable only when filling is disabled.
+.sh 1 "Preprocessor Support"
+.TL
+.b .EQ
+.i A
+.i T
+.DE
+Begin
+.i \%@g@eqn (1)
+equation.
+If
+.i A
+\c
+.b C 
+is
+.b C ,
+the equation is centered;
+if
+.b I ,
+indented by
+.NR (bi
+4m;
+and if
+.b L ,
+left-aligned.
+.i T
+empty
+is a title aligned to the right margin
+next to the equation.
+See
+.q "Typesetting Mathematics \- User's Guide"
+by Brian W. Kernighan
+and Lorinda L. Cherry.
+.TL
+.b .EN
+.i C
+.DE
+End
+.i \%@g@eqn
+equation.
+If
+.i C
+empty
+is
+.b C ,
+and the equation is followed immediately
+by another
+.b .EQ ,
+the texts of each are centered together.
+Otherwise,
+the equation is typeset
+within the page or column
+with
+.NR (es
+0.5v
+space
+above and below it.
+.TL
+.b .TS
+.i H
+.DE
+Begin (start)
+.i \%@g@tbl (1)
+table.
+Tables are preceded and followed by
+.NR (bs
+of space.
+If
+.i H
+empty
+is
+.b H ,
+you can call
+.b .TH
+after some table rows
+to repeat them across columns or pages.
+If you want a table to float,
+surround the
+.b .TS
+and
+.b .TE
+calls with
+.b .(z
+and
+.b .)z
+calls.
+.TL
+.b .TH
+.DE
+With \(lq\c
+.b ".TS H" \(rq,
+end the
+.i \%@g@tbl
+table header.
+.TL
+.b .TE
+.DE
+End
+.i \%@g@tbl
+table.
+.TL
+.b .PS
+.i h
+.i w
+.DE
+Begin
+.i \%@g@pic (1)
+picture.
+.i h
+empty
+and
+.i w
+empty,
+if present,
+scale the image.
+.\" XXX: That's vague, but DWB pic and GNU pic reportedly interpret
+.\" these arguments differently and there's no room here to discuss it.
+.TL
+.b .PE
+.DE
+End
+.i \%@g@pic
+picture,
+leaving the drawing position at the bottom of the picture.
+.TL
+.b .PF
+.DE
+End
+.i \%@g@pic
+picture,
+leaving the drawing position at the top of the picture.
+.TL
+.b .IS
+.DE
+Begin
+.i ideal (1)\**
+picture.
+.(f
+\**
+.i groff
+does not provide an implementation of the
+.i ideal
+preprocessor.
+.)f
+.TL
+.b .IE
+.DE
+End
+.i ideal
+picture,
+leaving the drawing position at the bottom of the picture.
+.TL
+.b .IF
+.DE
+End
+.i ideal
+picture,
+leaving the drawing position at the top of the picture.
+.TL
+.b .GS
+.i A
+.DE
+Begin
+.i \%@g@grn (1)
+picture.
+.i A
+\c
+.b C 
+can be
+.b C ,
+.b L ,
+or
+.b R
+to center, left-, or right-align
+the picture.
+.TL
+.b .GE
+.DE
+End
+.i \%@g@grn
+picture,
+leaving the drawing position at the bottom of the picture.
+.TL
+.b .GF
+.DE
+End
+.i \%@g@grn
+picture,
+leaving the drawing position at the top of the picture.
+.sh 1 "Formal Documents"
+.TL
+.b .tp
+.DE
+Begin title page.
+Unusually,
+.b .sp
+calls at the top of the page
+.i are
+honored.
+Headers and footers are suppressed.
+The page number
+is not incremented
+for this page.
+.TL
+.b .++
+.i S
+.i H
+.DE
+Begin a
+.i segment
+of an organized document,
+affecting the values and formatting
+of chapter and page numbers.
+The chapter number in
+.NR (ch
+is reset to\~0.
+A segment uses Arabic numerals
+for chapter and page numbers
+except where noted.
+The mandatory segment type argument
+.i S
+must be one of
+.b C
+for chapters
+(of the main matter),
+.b A
+for appendices
+(uppercase alphabetical chapter numbers),
+.b P
+for preliminary (\(lqfront\(rq) matter
+(such as a foreword;
+lowercase Roman page numbers),
+.b AB
+for an abstract
+(page numbering restarts at 1),
+or
+.b B
+for \(lqback\(rq matter,
+such as a bibliography.
+.b C
+or
+.b A
+may be prefixed with
+.b R ,
+which specifies a restart of page numbering
+when
+.b .+c
+is called within the applicable segment.
+If present,
+the
+.i H
+empty
+parameter defines the new header,
+which must be delimited as a three-part title\(em\c
+if it contains spaces,
+it must furthermore be quoted.
+To include the chapter number in
+.i H,
+use the input sequence
+.b "\eEn(ch" .\**
+.(f
+\**
+If you wish to avoid use of the \*G\|\" prevent italic f \ ugliness
+.b \eE
+extension,
+fully
+.i eight
+backslashes must precede
+.q n(ch .
+.)f
+For example,
+\lq\c
+.b ".++ RA |||\eEn(ch.%|" \rq
+numbers appendices and pages as
+.bi A .\c
+.bi n
+in the right-hand header,
+where
+.i A
+is the appendix letter
+and
+.i n
+is the page number.
+Each subdivision of a segment
+(each chapter,
+appendix,
+etc.\&)
+should be preceded by a
+.b .+c
+call.
+It is easier when using
+\*T to put the front matter
+at the end of the paper,
+so that the table of contents
+can be collected and put out;
+this material can then be resequenced
+by a tool that processes the output format,
+or physically moved
+to the beginning of the printed document.
+.TL
+.b .+c
+.i T
+.DE
+Begin chapter
+(or appendix).
+Reset the footnote number
+in
+.NR ($f
+to 1.
+If the segment type is
+.b RA
+or
+.b RC ,
+reset the page number
+in
+.NR %
+to 1.
+If
+.b .++
+has not been called,
+a segment type of
+.b C
+is assumed.
+If a header is defined,
+it replaces the footer
+on the first page
+of each chapter.
+If a title
+.i T
+empty
+is supplied,
+.b .$c
+is called.
+.TL
+.b .$c
+.i T
+.DE
+Format a chapter heading
+centered in boldface.
+The text
+.ST (wc
+\c
+.b Chapter 
+is output
+if the segment type is
+.b C
+or
+.b RC,
+or that in
+.ST (wa
+\c
+.b Appendix 
+if the segment type is
+.b A
+or
+.b RA.
+The chapter number
+is incremented and output. \" except for abstract and bibliography segs
+If a chapter title
+.i T
+is present,
+it is formatted the same way,
+preceded by vertical space.
+If the segment type is any of
+.b C ,
+.b RC ,
+.b A ,
+or
+.b RA ,
+.b $C
+is called.
+.TL
+.b .$C
+.i K
+.i N
+.i T
+.DE
+This hook macro
+is called by
+.b .+c
+and
+.b .$c .
+.i K
+is the chapter or appendix term supplied by
+.b $c ,
+.i N
+is the chapter or appendix number,
+and
+.i T
+is its title.
+.\" TODO: Move the following application note to meintro.me.in or some
+.\" future non-introductory me(7) usage manual.
+This hook can be used to insert chapter titles
+into a table of contents.
+.sh 1 "Miscellaneous"
+.TL
+.b .ld
+.DE
+Update the
+.NR (y2
+and
+.NR (y4
+registers based on the current value of
+.NR (yr ,
+reinitialize the localized strings
+.ST (dw ,
+.ST (mo ,
+.ST (wa ,
+and
+.ST (wc ,
+and reset
+.ST (td
+based on the foregoing.
+.TL
+.b .re
+.DE
+Reset tab stops to every 0.5i.
+.TL
+.b .ba
+.i \(+-n
+.DE
+Set the base indentation
+to
+.i \(+-n
+0.
+Paragraphs,
+sections,
+and displays
+are indented by at least this amount,
+stored in
+.NR ($i .
+Titles and footnotes
+are unaffected.
+.TL
+.b .hl
+.DE
+Break and draw a horizontal line
+of the current line length.
+You might call
+.b .hl
+at the beginning and/or end
+of a floating keep
+to differentiate
+the text from a figure.
+.TL
+.b .ep
+.DE
+End this page,
+but do not begin the next page.
+Useful for forcing out footnotes,
+but other than
+that hardly ever used.
+Must be followed by a
+.b .bp
+request or the end of input.
+.\" dead-tree pagination
+.br
+.ne 6v
+.sh 1 "\f(BIroff\fP Support\fR\**"
+.(f
+\**
+These facilities are provided to aid migration of
+\(lqold
+.i roff \(rq
+documents.
+See
+.i roff (7)
+for a history of
+.i roff -related
+typesetting systems.
+.)f
+.pp
+.TL
+.b .ix
+.i \(+-n
+.DE
+Equivalent to \(lq\|\fB\aqin \fI\(+-n\/\fR\(rq.
+.TL
+.b .bl
+.i n
+.DE
+Equivalent to \(lq\fB.sp \fIN\/\fR\(rq
+inside a
+.b .(b
+block.
+.TL
+.b .m1
+.i \(+-n
+.DE
+Set/adjust the space between the top of the page
+and the header to/by
+.i \(+-n
+4v.
+.TL
+.b .m2
+.i \(+-n
+.DE
+Set/adjust the space between the header
+and the first line of text to/by
+.i \(+-n
+2v.
+.TL
+.b .m3
+.i \(+-n
+.DE
+Set/adjust the space
+between the bottom of the text
+and the footer to/by
+.i \(+-n
+2v.
+.TL
+.b .m4
+.i \(+-n
+.DE
+Set/adjust the space
+between the footer
+and the bottom of the page to/by
+.i \(+-n
+4v.
+.TL
+.b .pa
+.i \(+-n
+.DE
+Equivalent to \(lq\fB.bp \fI\(+-n\/\fR\(rq.
+.TL
+.b .ro
+.DE
+Equivalent to \(lq\fB.af % i\fP\(rq.
+.TL
+.b .ar
+.DE
+Equivalent to \(lq\fB.af % 1\fP\(rq.
+.TL
+.b .n1
+.i C
+.DE
+Number output lines starting from 1.
+If
+.i C
+empty
+is
+.b C ,
+the line length is reduced
+and correspondingly indented;
+otherwise,
+the page offset is reduced
+to accommodate the line number.
+The amount in all cases is
+.NR (no
+\ew\(aq0000\(aqu
+(the width of four numerals
+in the current font).
+.TL
+.b .n2
+.i \(+-n
+.DE
+Stop numbering output lines if
+.i n
+missing,
+otherwise continue with the number modified by
+\(+-\c
+.i n.
+.TL
+.b .sk
+.DE
+Leave the next output page blank
+except for headers and footers.
+This can reserve space
+for a full-page diagram
+produced externally
+and composited in later.
+(To reserve only a partial page,
+use \lq\c
+.b .sv \~\c
+.bi n \rq,
+where
+.i n
+is the amount of space required.
+This space will be output immediately
+if there is room,
+and otherwise
+at the top of the next page.
+If
+.i n
+is greater than the space available
+on an empty page,
+none will be output.)
+.sh 1 "Predefined Strings"
+.TL
+.ST *
+.DE
+Interpolate footnote number bracketed by superscripting strings:
+.ST { \c
+.\" \^ avoids 'f\' bad kerning in Times bold; wrong font metrics?
+.NR ($f \^\c
+.ST } .
+.TL
+.ST #
+.DE
+Interpolate delayed text number surrounded by square brackets:
+.b  \c
+.NR ($d \c
+.b  .
+.TL
+.ST {
+.DE
+Begin superscripting:
+move upward and reduce the type size.
+The line height is increased above by
+.NR (sx
+0.2m
+to accommodate the superscript.
+In \*N mode,
+output a left square bracket.
+.TL
+.ST }
+.DE
+End superscripting:
+reverse the motion and type size change of
+.ST { .
+In \*N mode,
+output a right square bracket.
+.\" TODO: Move this example to a section on super- and subscripting in
+.\" meintro.
+.\"For example,
+.\"to produce a superscript
+.\"you might type
+.\".b x \c
+.\".ST { \c
+.\".b 2 \c
+.\".ST } ,
+.\"which will render as
+.\".b x\*{2\*}
+.\"on typesetters and as
+.\".b x2
+.\"on terminals.
+.TL
+.ST <
+.DE
+Begin subscripting:
+move downward and reduce the type size.
+The line height is increased below by
+.NR (sx
+to accommodate the subscript.
+In \*N mode,
+output a left angle bracket.
+.TL
+.ST >
+.DE
+End subscripting:
+reverse the motion and type size change of
+.ST < .
+In \*N mode,
+output a right angle bracket.
+.\" dead-tree pagination
+.br
+.ne 6v
+.pp
+\*G \*(ME provides localized strings
+to support documents in several input languages;
+see the
+.i groff_tmac (5)
+man page.
+The date-related strings are initialized
+based on the current date
+when the formatter runs.
+To encode a different date in your document,
+change the \*T date registers as desired
+and then call
+.b .ld
+to update the strings.
+The day of the week is
+.i not
+recomputed from a new calendar date;
+.NR (dw
+must be modified manually.
+The strings can also be defined directly.
+.(b L F
+.TL
+.ST (dw
+.DE
+Weekday name.
+.TL
+.ST (mo
+.DE
+Month name.
+.TL
+.ST (td
+.DE
+The date in a form suitable for correspondence.
+Construct other date formats with
+.ST (dw ,
+.NR (dy
+(day of the month),
+.ST (mo ,
+.NR (mo
+(month of the year),
+.NR (y4
+(year),
+and
+.NR (y2
+(year of the century).
+.TL
+.ST (wa
+.DE
+The term
+.b .$c
+uses for
+.q appendix .
+.TL
+.ST (wc
+.DE
+The term
+.b .$c
+uses for
+.q chapter .
+.)b
+.sh 1 "Special Characters"
+.pp
+For modern documents,
+see the
+.i groff_char (7)
+man page.
+.pp
+For rendering of legacy \*(ME documents,
+the macro package defines several strings that construct accent marks
+and two symbols from mathematical set theory.
+These strings are limited in multiple respects:
+they can have a crude appearance,
+they are unrecognizable on character-cell video terminals
+because they rely on overstriking,
+and they cannot in general be \(lqstacked\(rq,
+as is required to correctly render words in
+(for example)
+Vietnamese.
+Preferable \*G alternatives
+are presented alongside them in the following table.
+.sp
+.\" dead-tree pagination
+.ne 2v
+.ta 5n +\w'There exists'u+2n +\w'Usage'u+3n +\w'Example'u+3n \
++\w'Output'u+3n +\w'groff'u+3n +\w'Output'u+3n
+.nf
+.b "	Name	Usage	Example	Output	\f(BIgroff\fP	Output"
+	Acute	\e*\(aq	a\e*\(aq	a\*'	\ea aa	\a aa
+	Grave	\e*\(ga	e\e*\(ga	e\*`	\ee ga	\e ga
+	Umlaut	\e*:	u\e*:	u\*:	\eu ad	\u ad
+	Tilde	\e*\(ti	n\e*\(ti	n\*~	\en a\(ti	\n a~
+	Caret	\e*\(ha	e\e*\(ha	e\*^	\ee a\(ha	\e a^
+	Cedilla	\e*,	c\e*,	c\*,	\ec ac	\c ac
+	Caron	\e*v	s\e*v	s\*v	\es ah	\s ah
+	Ring	\e*o	A\e*o	A\*o	\eA ao	\A ao
+	There exists	\e*(qe		\*(qe	\ete	\te
+	For all	\e*(qa		\*(qa	\efa	\fa
+.fi
+.pp
+Three further string definitions cause no particular problems but have
+no advantage over \*G special character escape sequences
+apart from portability to BSD Unix systems.
+(The last lacks even that distinction,
+since
+Unix Version\~7 \*T
+supported the
+.b \e(em
+special character.)
+.TL
+.ST (lq
+.DE
+Left double quotation mark.
+Use
+.b \e(lq
+instead.
+.TL
+.ST (rq
+.DE
+Right double quotation mark.
+Use
+.b \e(rq
+instead.
+.TL
+.ST \-
+.DE
+Em dash.
+Use
+.b \e(em
+instead.
+.uh Acknowledgments
+.pp
+Allman would like to thank
+Bob Epstein,
+Bill Joy,
+and Larry Rowe
+for having the courage
+to use the \*(ME macros
+to produce non-trivial papers
+during the development stages;
+Ricki Blau,
+Pamela Humphrey,
+and Jim Joyce
+for their help with the documentation phase;
+peter kessler
+for numerous complaints,
+most accompanied by fixes;
+and the plethora of people who have contributed ideas
+and have given support for the project.
+.bp
+.uh Summary
+.pp
+Almost all macros,
+strings,
+and registers
+available in the \*(ME package
+are summarized below;
+the legacy strings from section
+.q "Special Characters"
+are omitted.
+Selected \*T
+requests,
+registers,
+and escape sequences are included as well;
+those listed can generally be used with impunity.
+The list is sorted by Unicode code point
+(basic Latin subset)
+keyed on the identifier:
+escape and control characters are disregarded,
+as are the escape function selectors for register and string
+interpolation,
+.b n
+and
+.b * .
+.pp
+Each row contains the name of the
+macro (or request),
+register,
+string,
+or escape function;
+a code for the name's type
+(one of the foregoing);
+and its description.
+The type codes are
+.b M
+for a macro or \*T
+request
+(shown prefixed with the control character
+.b . ,
+but the no-break control character
+.b \(aq
+can also be used),
+.b S
+for a string
+(shown using its interpolation syntax,
+.b \e*
+or
+.b \e*( ),
+.b R
+for a register
+(shown using its interpolation syntax,
+.b \en
+or
+.b \en( ),
+and
+.b F
+for a \*T built-in function
+(shown prefixed with the escape character
+.b \e ).
+.pp
+The type code can carry a variety of annotations.
+A section sign \(sc indicates features interpreted by \*T
+rather than the \*(ME package.
+The dagger \(dg and double dagger \(dd identify user-definable macros.
+Those marked with
+\(dd have default definitions;
+changing them may have unexpected side effects.
+The degree sign \(de notes features requiring AT&T device-independent
+\*T extensions
+(ca.\& 1981),
+and a square \(sq labels \*G extensions.
+.de $H
+.ev 1
+.ta \w'\enewline\(sc'u +\w'TYPE'u+2n
+.b "Name	Type	Description"
+.ev
+..
+.sp
+.if t .2c
+.if n .(c
+.(l L
+.$H
+\e\fI\,newline\fP	F\(sc	continue input line
+\e"	F\(sc	comment (to end of input line)
+\e*#	S	delayed text marker
+\e$\fI\,n\fP	F\(sc	interpolate \fIn\/\fPth macro argument
+\en($0	R	section depth
+\&.$0	M\(dg	post-section heading hook
+\en($1	R	first section number component
+\&.$1	M\(dg	pre-section heading depth 1 hook
+\en($2	R	second section number component
+\&.$2	M\(dg	pre-section heading depth 2 hook
+\en($3	R	third section number component
+\&.$3	M\(dg	pre-section heading depth 3 hook
+\en($4	R	fourth section number component
+\&.$4	M\(dg	pre-section heading depth 4 hook
+\en($5	R	fifth section number component
+\&.$5	M\(dg	pre-section heading depth 5 hook
+\en($6	R	sixth section number component
+\&.$6	M\(dg	pre-section heading depth 6 hook
+\&.$C	M\(dg	post-chapter title heading hook
+\&.$H	M\(dg	page/column heading hook
+\en($c	R	current column number
+\&.$c	M\(dd	output chapter number and title
+\en($d	R	delayed text number
+\en($f	R	footnote number
+\&.$f	M\(dd	output footer
+\&.$h	M\(dd	output header
+\en($i	R	paragraph base indentation
+\en($l	R	column width
+\en($m	R	number of available columns
+\e*($n	S	concatenated section number
+\en($p	R	numbered paragraph number
+\&.$p	M\(dd	output section heading
+\en($s	R	column spacing (indentation)
+\&.$s	M\(dd	output footnote area separator
+\e%	F\(sc	control hyphenation
+\en%	R\(sc	current page number
+\e&	F\(sc	dummy character
+\e(\fI\,xx\fP	F\(sc	interpolate special character \fIxx\fP
+\&.(b	M	begin block
+\&.(c	M	begin centered block
+\&.(d	M	begin delayed text
+\&.(f	M	begin footnote
+\&.(l	M	begin list
+\&.(q	M	begin long quotation
+\&.(x	M	begin index entry
+\&.(z	M	begin floating keep
+\e\(aq	F\(sc	acute accent
+\&.)b	M	end block
+\&.)c	M	end centered block
+\&.)d	M	end delayed text
+\&.)f	M	end footnote
+\&.)l	M	end list
+\&.)q	M	end long quotation
+\&.)x	M	end index entry
+\&.)z	M	end floating keep
+\e*\fI\,x\fP	F\(sc	interpolate string \fIx\fP
+\e*(\fI\,xx\fP	F\(sc	interpolate string \fIxx\fP
+\e**	S	footnote marker
+\&.++	M	set document segment type
+\&.+c	M	begin chapter or appendix
+\e\-	F\(sc	minus sign
+\e*\-	S	em dash
+\en(.$	R\(sc	macro parameter count
+\en(.i	R\(sc	current indentation
+\en(.l	R\(sc	current line length
+\en(.p	R\(sc	current page length
+\en(.s	R\(sc	current type size in points
+\e0	F\(sc	unadjustable digit-width space
+\&.1c	M	end multi-column layout
+\&.2c	M	begin multi-column layout
+\e*<	S	begin subscripting
+\e*>	S	end subscripting
+\&.EN	M	end \fI@g@eqn\fP equation
+\&.EQ	M	begin \fI@g@eqn\fP equation
+\&.GE	M\(de	end \fI@g@grn\fP picture with position at bottom
+\&.GF	M\(de	end \fI@g@grn\fP picture with position at top
+\&.GS	M\(de	start \fI@g@grn\fP picture
+\&.IE	M\(de	end \fIideal\fP picture with position at bottom
+\&.IF	M\(de	end \fIideal\fP picture with position at top
+\&.IS	M\(de	start \fIideal\fP picture
+\eL\(aq\fI\,d\/\fP\(aq	F\(sc	draw vertical line of length \fId\fP
+\&.PE	M\(de	end \fI@g@pic\fP picture with position at bottom
+\&.PF	M\(de	end \fI@g@pic\fP picture with position at top
+\&.PS	M\(de	start \fI@g@pic\fP picture
+\&.TE	M	end \fI@g@tbl\fP table
+\&.TH	M	end heading for multi-page \fI@g@tbl\fP table
+\&.TS	M	begin \fI@g@tbl\fP table
+\e\(ha	F\(sc	1/12 em unbreakable hair space
+\e_	F\(sc	underrule
+\e\(ga	F\(sc	grave accent
+\&.ad	M\(sc	set text adjustment mode
+\&.af	M\(sc	assign register format
+\&.am	M\(sc	append to macro
+\&.ar	M	use Arabic numerals for page numbers
+\&.as	M\(sc	append to string
+\&.b	M	embolden argument
+\&.ba	M	set base indentation
+\&.bc	M	begin new column
+\&.bi	M	embolden and italicize argument
+\en(bi	R	display (block) indentation
+\&.bl	M	insert space (even at page top; cf.\& \fB.sp\fP)
+\en(bm	R	distance from text area to page bottom
+\&.bp	M\(sc	begin new page
+\&.br	M\(sc	break output line
+\en(bs	R	display (block) pre/post space
+\en(bt	R	block threshold for keeps
+\&.bx	M	box argument
+\ec	F\(sc	continue output line
+\&.ce	M\(sc	center output lines
+\en(ch	R	current chapter number
+\&.cp	M\(sc\(sq	toggle AT&T \*T compatibility mode
+\&.de	M\(sc	define macro
+\en(df	R	display font
+\&.do	M\(sc\(sq	operate with compatibility mode off
+\&.ds	M\(sc	define string
+\en(dv	R\(sq	vertical spacing of displayed text (%)
+\en(dw	R\(sc	day of the week
+\e*(dw	S	weekday name
+\en(dy	R\(sc	day of the month
+\ee	F\(sc	printable version of escape character \fB\e\fP
+\&.ef	M	set even-numbered page footer
+\&.eh	M	set even-numbered page header
+\&.el	M\(sc	else part of \fB.ie\fP conditional
+\&.ep	M	end page
+\en(es	R	equation pre/post space
+\ef\fI\,f\fP	F\(sc	inline font change to font \fIf\fP
+\ef(\fI\,ff\fP	F\(sc	inline font change to font \fIff\fP
+\&.fc	M\(sc	set field characters
+\en(ff	R	footnote font
+\&.fi	M\(sc	enable filling
+\en(fi	R	footnote indentation (first line only)
+\en(fm	R	footer margin
+\&.fo	M	set footer
+\&.fp	M	mount font at position
+\en(fp	R	footnote type size in points
+\en(fs	R	footnote prespace
+\en(fu	R	footnote undent (right indentation)
+\eh\(aq\fI\,d\/\fP\(aq	F\(sc	move distance \fId\fP horizontally
+\&.hc	M\(sc	set hyphenation character
+\&.he	M	set header
+\&.hl	M	draw horizontal line
+\en(hm	R	header margin
+\&.hx	M	suppress next page's headers/footers
+\&.hy	M\(sc	set automatic hyphenation mode
+\&.i	M	italicize argument
+\&.ie	M\(sc	conditional with \fB.el\fP
+\&.if	M\(sc	conditional
+\en(ii	R	indented paragraph indentation
+\&.in	M\(sc	set indentation (transient; cf.\& \fB.ba\fP)
+\&.ip	M	begin indented paragraph
+\&.ix	M	set indentation without break
+\el\(aq\fI\,d\/\fP\(aq	F\(sc	draw horizontal line of length \fId\fP
+\&.lc	M\(sc	set leader repetition character
+\&.ld	M\(sq	reset localization and date info
+\&.ll	M	set line length in \fIme\fP environments
+\&.lp	M	begin fully left-aligned paragraph
+\e*(lq	S	left double quotation mark
+\&.ls	M\(sc	set multi-line spacing
+\&.m1	M	set page top to header distance
+\&.m2	M	set header to text distance
+\&.m3	M	set text to footer distance
+\&.m4	M	set footer to page bottom distance
+\&.mc	M\(sc	set margin character
+\&.mk	M\(sc	mark vertical position (see \fB.rt\fP)
+\en(mo	R\(sc	month of the year
+\e*(mo	S	month name
+\en\fI\,x\fP	F\(sc	interpolate register \fIx\fP
+\en(\fI\,xx\fP	F\(sc	interpolate register \fIxx\fP
+\&.n1	M	begin output line numbering
+\&.n2	M	end or alter output line numbering
+\&.na	M\(sc	disable adjustment
+\&.ne	M\(sc	need vertical space
+\&.nf	M\(sc	disable filling
+\&.nh	M\(sc	disable automatic hyphenation
+\en(no	R\(sq	line numbering offset
+\&.np	M	begin numbered paragraph
+\&.nr	M\(sc	set register
+\&.ns	M\(sc	begin no-space mode
+\&.of	M	set odd-numbered page footer
+\&.oh	M	set odd-numbered page header
+\&.pa	M	begin page
+\&.pd	M	output delayed text
+\en(pf	R	paragraph font
+\en(pi	R	paragraph indentation
+\&.pl	M\(sc	set page length
+\&.pn	M\(sc	set next page number
+\&.po	M\(sc	set page offset
+\en(po	R	paragraph offset
+\&.pp	M	begin first-line indented paragraph
+\en(pp	R	paragraph type size in points
+\en(ps	R	paragraph prespace
+\&.q	M	quote argument
+\en(qi	R	long quotation left/right indentation
+\en(qp	R	long quotation type size in points
+\en(qs	R	long quotation pre/post space
+\&.r	M	set argument in roman
+\&.re	M	reset tab stops
+\&.rj	M\(sq	right-align output lines
+\&.rm	M\(sc	remove macro, string, or request
+\&.rn	M\(sc	rename macro, string, or request
+\&.ro	M	use Roman numerals for page numbers
+\e*(rq	S	right double quotation mark
+\&.rr	M\(sc	remove register
+\&.rs	M\(sc	restore spacing (end no-space mode)
+\&.rt	M\(sc	return to vertical position set by \fB.mk\fP
+\es\(aq\fI\,\(+-n\/\fP\(aq	F\(sc\(de	inline type size change\
+ to/by \fIn\fP points
+\en(sf	R	section title font
+\&.sh	M	begin numbered section
+\en(si	R	section indentation per level of depth
+\&.sk	M	skip next page
+\&.sm	M	set argument at smaller type size
+\&.so	M\(sc	source (interpolate) input file
+\en(so	R	additional section title offset
+\&.sp	M\(sc	insert space (except at page top; cf.\& \fB.bl\fP)
+\en(sp	R	section title type size in points
+\en(ss	R	section prespace
+\&.sx	M	change section depth
+\en(sx	R\(sq	super/subscript line height increase
+\&.sz	M	set type size and vertical spacing
+\&.ta	M\(sc	set tab stops
+\&.tc	M\(sc	set tab repetition character
+\e*(td	S	today's date
+\en(tf	R	title font
+\&.ti	M\(sc	temporary indentation (next line only)
+\&.tl	M\(sc	output three-part title
+\en(tm	R	distance from page top to text area
+\&.tp	M	begin title page
+\en(tp	R	title type size in points
+\&.tr	M\(sc	translate characters
+\en(tv	R\(sq	vertical spacing of text (%)
+\&.u	M	underline argument
+\&.uh	M	begin unnumbered section
+\&.ul	M\(sc	underline output lines
+\ev\(aq\fI\,d\/\fP\(aq	F\(sc	move distance \fId\fP vertically
+\ew\(aq\fI\,S\/\fP\(aq	F\(sc	interpolate formatted width of \fIS\fP
+\e*(wa	S\(sq	term for \(lqappendix\(rq used by \fB.$c\fP
+\e*(wc	S\(sq	term for \(lqchapter\(rq used by \fB.$c\fP
+\&.xl	M	set line length (current environment)
+\&.xp	M	output index
+\en(xs	R	index entry prespace
+\en(xu	R	index undent (right indentation)
+\en(y2	R\(sq	year of the century
+\en(y4	R\(sq	year
+\en(yr	R\(sc	year minus 1900
+\en(zs	R	floating keep pre/post space
+\e{	F\(sc	begin conditional group
+\e*{	S	begin superscripting
+\e|	F\(sc	1/6 em unbreakable thin space
+\e}	F\(sc	end conditional group
+\e*}	S	end superscripting
+\e\(ti	F\(sc\(sq	unbreakable word space
+.)l
+.if n .)c
+.ds $H \" empty
+.\" If we're laying out the final column, `1c` will produce an
+.\" unnecessary empty page.  If we're not, omitting `1c` will format a
+.\" column of headers with nothing underneath.
+.if \n($c<\n($m .1c
+.\" Local Variables:
+.\" mode: nroff
+.\" End:
+.\" vim: filetype=groff:

_service:tar_scm:groff-1.23.0.tar.gz/doc/ms.ms Added

@@ -0,0 +1,4486 @@
+.\" 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
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" 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 this program. If not, see <http://www.gnu.org/licenses/>.
+.
+.\" Handle font requests with families, for instance in tbl(1) tables.
+.if n \{\
+.  ftr CR B \" for a visible distinction from roman
+.  ftr CB B
+.  ftr CI I
+.  ftr CBI BI
+.  \" Redefine CW to use bold instead for a visible font change.
+.  als CW B
+.  \" The "document control settings" table imposes this minimum width.
+.  nr LL 87n
+.\}
+.\" This document doesn't require the minus sign (in Times) but we do
+.\" want a copy- and-pastable hyphen-minus.
+.ie '\*.T'cp1047' .char \- \N'96'
+.el                 .char \- \N'45'
+.\" A very limited output device might not have a dagger glyph.
+.fchar \dg *
+.nr PS 11
+.nr VS 13
+.ds FR 1
+.nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
+.ie t .nr PI 3.5n
+.el   .nr PI 4n
+.ND May 2023
+.EH '%''May 2023'
+.EF ''''
+.OH 'Using \fIgroff\f with the \fIms\f macros''%'
+.OF ''''
+.TL
+Using
+.BI groff
+with the
+.BI ms
+Macro Package
+.AU
+Larry Kollar
+.AI
+kollar@alltel.net
+.AU
+G.\& Branden Robinson
+.AI
+g.branden.robinson@gmail.com
+.AB no
+The
+.I ms
+(\lqmanuscript\rq) package is suitable for the composition of
+letters,
+memoranda,
+reports,
+and books.
+.
+These
+.I groff
+macros feature cover page and table of contents generation,
+automatically numbered headings,
+several paragraph styles,
+a variety of text styling options,
+footnotes,
+and multi-column page layouts.
+.
+.I ms
+supports the
+.I tbl ,
+.I eqn ,
+.I pic ,
+and
+.I refer
+preprocessors for inclusion of tables,
+mathematical equations,
+diagrams,
+and standardized bibliographic citations.
+.
+This implementation is mostly compatible with the documented interface
+and behavior of AT&T Unix Version\~7
+.I ms .
+.
+Many extensions from 4.2BSD (Berkeley)
+.\" Few changes were made in 4.3, Tahoe, Reno, or 4.4.
+and Tenth Edition Research Unix have been recreated.
+.AE
+.
+.
+.\" ------------------------- End of cover page ------------------------
+.NH 1
+Introduction
+.XS
+Introduction
+.XE
+.
+.
+.LP
+The
+.I ms
+macros are the oldest surviving package for
+.I roff
+systems.\**
+.
+.FS
+While manual
+.I pages
+are older,
+early ones used macros supplanted by the
+.I man
+package of Seventh Edition Unix (1979).
+.
+.I ms
+shipped with Sixth Edition (1975) and was documented by Mike Lesk in a
+Bell Labs internal memorandum.
+.FE
+.
+While the
+.I man
+package was designed for brief reference documents,
+the
+.I ms
+macros are also suitable for longer works intended for printing and
+possible publication.
+.
+.
+.PP
+In this document,
+a right arrow (\->) is used to indicate a tab character in the input.
+.
+.
+.KS
+.NH 2
+Basic information
+.XS
+	Basic information
+.XE
+.
+.
+.LP
+.I ms
+documents are plain text files;
+prepare them with your preferred text editor.
+.
+If you're in a hurry to start,
+know that
+.I ms
+needs one of its macros called at the beginning of a document so that it
+can initialize.
+.
+A
+.I macro
+is a formatting instruction to
+.I ms.
+.
+Put a macro call on a line by itself.
+.
+Use
+.CW .PP
+if you want your paragraph's first line to be indented,
+or
+.CW .LP
+if you don't.
+.KE
+.
+.
+.PP
+After that,
+start typing normally.
+.
+It is a good practice to start each sentence on a new line,
+or to put two spaces after sentence-ending punctuation,
+so that the formatter knows where the sentence boundaries are.
+.
+You can separate paragraphs with further paragraphing macro calls,
+or with blank lines,
+and you can indent with tabs.
+.
+When you need one of the features mentioned earlier,
+return to this manual.
+.
+.
+.PP
+Format the document with the
+.I groff (1)
+command.
+.
+.I nroff (1)
+can be useful for previewing.
+.
+.
+.if n .ftr TI I
+.TS
+box center;
+Lf(CR)1 Lf(CB).
+$	editor radical.ms \fTI# vim, emacs, .\|.\|.
+$	nroff -ww -z -ms radical.ms \fTI# check for errors
+$	nroff \-ms radical.ms | less \-R
+$	groff \-T pdf \-ms radical.ms > radical.pdf
+$	see radical.pdf \fTI# or your favorite PDF viewer
+.TE
+.if n .ftr TI
+.
+.
+.PP
+Our
+.CW radical.ms
+document might look like this.
+.
+.
+.TS
+box center;
+Lf(CR).
+\&.LP
+Radical novelties are so disturbing that they tend to be
+suppressed or ignored, to the extent that even the
+possibility of their existence in general is more often
+denied than admitted.
+.sp
+\->That\aqs what Dijkstra said, anyway.
+.TE
+.
+.
+.LP
+.I ms
+exposes many aspects of document layout to user control via
+.I groff 's
+.I registers
+and
+.I strings,
+which store numbers and text,
+respectively.
+.
+Measurements in
+.I groff
+are expressed with a suffix called a
+.I "scaling unit."
+.
+.
+.TS
+box center;
+cb cb
+cf(CR) l .
+Scaling unit	Description
+_
+i	inches (\sd)
+c	centimeters
+p	points (1/72\sd)
+P	picas (1/6\sd)
+v	\lqvees\rq; current vertical spacing
+m	\lqems\rq; width of an \lqM\rq in the current font
+n	\lqens\rq; one-half em
+.TE
+.
+.
+.PP
+Set registers with the
+.CW nr
+request
+and strings with the
+.CW ds
+request.
+.
+.I Requests
+are like macro calls;
+they go on lines by themselves and start with the
+.I "control character,"
+a dot
+.CW . ). (
+.
+The difference is that they directly instruct the formatter program,
+rather than the macro package.
+.
+We'll discuss a few as applicable.
+.
+It is wise to specify a scaling unit when setting any register that
+represents a length,
+size,
+or distance.
+.
+.
+.TS
+box center;
+lf(CR).
+\&.nr PS 10.5p \rs" Use 10.5\-point type.
+\&.ds FAM P    \rs" Use Palatino font family.
+.TE
+.
+.
+.LP
+In the foregoing,
+we see that
+.CW \rs"
+begins a comment.
+.
+This is an example of an
+.I "escape sequence,"
+the other kind of formatting instruction.
+.
+Escape sequences can appear anywhere.
+.
+They begin with the escape character
+.CW \rs ) (
+and are followed by at least one more character.
+.
+.I ms
+documents like this one tend to use only a few of
+.I groff 's
+many requests and escape sequences;
+see the
+.I groff (7)
+man page for complete lists.
+.
+.
+.TS
+box center;
+Cb Cb
+Lf(CR) Lx .
+Escape sequence	Description
+_
+\rs"	Begin comment; ignore remainder of line.
+\rsn\fIreg\f	T{
+Interpolate value of register
+.I reg .
+T}
+\rs*\fIstr\f	T{
+Interpolate contents of string
+.I str .
+T}
+\rs*\fIs	T{
+abbreviation of
+.CW \rs*\fIs\f ;
+the name
+.I s
+must be only one character
+T}
+\rs\fIchar\f	T{
+Interpolate glyph of special character named
+.I char .
+T}
+\rs&	non-printing, zero-width dummy character
+\rs\ti	T{
+Insert an unbreakable space of adjustable width like a normal space.
+T}
+\rs|	T{
+Move horizontally by one-sixth em
+(\lqthin space\rq).
+T}
+.TE
+.
+.
+.PP
+Prefix any words that start with a dot
+.CW .\& ) (
+or neutral apostrophe
+.CW \aq ) (
+with
+.CW \rs&
+if they are at the beginning of an input line
+(or might become that way in editing)
+to prevent them from being interpreted as macro calls or requests.
+.
+Suffix
+.CW . ,
+.CW ? ,
+and
+.CW !\&
+with
+.CW \rs&
+when needed to cancel end-of-sentence detection.
+.
+.
+.TS
+box center;
+lf(CR).
+My exposure was \rs&.5 to \rs&.6 Sv of neutrons, said Dr.\rs&
+Wallace after the criticality incident.
+.TE
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+General structure of an
+.BI ms
+document
+.XS
+General structure of an
+.I ms
+document
+.XE
+.
+.
+.LP
+The
+.I ms
+macro package expects a certain amount of structure:
+a well-formed document contains at least one paragraphing or heading
+macro call.
+.
+Longer documents have a structure as follows.
+.
+.
+.IP "\fBDocument type\fP"
+Calling the
+.CW RP
+macro at the beginning of your document puts the document description
+(see below)
+on a cover page.
+.
+Otherwise,
+.I ms
+places this information
+(if any)
+on the first page,
+followed immediately by the body text.
+.
+Some document types found in other
+.I ms
+implementations are specific to AT&T or Berkeley,
+and are not supported by
+.I "groff ms" .
+.
+.
+.IP "\fBFormat and layout\fP"
+By setting registers and strings,
+you can configure your document's typeface,
+margins,
+spacing,
+headers and footers,
+and footnote arrangement.
+.
+See section \lqDocument control settings\rq below.
+.
+.
+.IP "\fBDocument description\fP"
+A document description consists of any of:
+a title,
+one or more authors' names and affiliated institutions,
+an abstract,
+and a date or other identifier.
+.
+See section \lqDocument description macros\rq below.
+.
+.
+.IP "\fBBody text\fP"
+The main matter of your document follows its description
+(if any).
+.
+.I ms
+supports highly structured text consisting of paragraphs interspersed
+with multi-level headings
+(chapters,
+sections,
+subsections,
+and so forth)
+and augmented by lists,
+footnotes,
+tables,
+diagrams,
+and similar material.
+.
+See section \lqBody text\rq below.
+.
+.
+.IP "\fBTables of contents\fP"
+Macros enable the collection of entries for a table of contents
+(or index)
+as the material they discuss appears in the document.
+.
+You then call a macro to emit the table of contents at the end of
+your document.
+.
+The table of contents must necessarily follow the rest of the text since
+GNU
+.I troff
+is a single-pass formatter;
+it thus cannot determine the page number of a division of the text until
+it has been set and output.
+.
+Since
+.I ms
+output was designed for the production of hard copy,
+the traditional procedure was to manually relocate the pages containing
+the table of contents between the cover page and the body text.
+.
+Today,
+page resequencing is more often done in the digital domain.
+.
+An index works similarly,
+but because it typically needs to be sorted after collection,
+its preparation requires separate processing.
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Document control settings
+.XS
+Document control settings
+.XE
+.
+.
+.LP
+The document parameters below are presented in the syntax
+used to interpolate their values.
+.
+For any unsatisfactory default,
+define its register,
+string,
+or special character before calling any
+.I ms
+macro other than
+.CW RP .
+.
+The \lqNext\rq heading indicates that changes to the parameter are
+effective as of the next new element processed of the listed type.
+.
+For entries marked
+.I special ,
+see the discussion in the applicable section.
+.
+.
+.TS H
+box;
+cb | cb cb cb cb
+l | lf(CR)p-1 lx l lf(CR)p-1.
+Type	Parameter	Definition	Next	Default
+_
+.TH
+Margins	\rsnPO	Page offset (left margin)	page\
+	1i (0)\*{*\*}
+\^	\rsnLL	Line length	paragraph	\
+6.5i (65n)\*{*\*}
+\^	\rsnLT	Title line length	paragraph	\
+6.5i (65n)\*{*\*}
+\^	\rsnHM	Top (header) margin	page	1i
+\^	\rsnFM	Bottom (footer) margin	page	1i
+_
+T{
+Titles
+.br
+(headers,
+.br
+footers)
+T}	\rs*LH	Left header text	header	\fIempty
+\^	\rs*CH	Center header text	header	\-\rsn%\-
+\^	\rs*RH	Right header text	header	\fIempty
+\^	\rs*LF	Left footer text	footer	\fIempty
+\^	\rs*CF	Center footer text	footer	\fIempty
+\^	\rs*RF	Right footer text	footer	\fIempty
+_
+Text	\rsnPS	Type (point) size	paragraph	10p
+\^	\rsnVS	Vertical spacing	paragraph	12p
+\^	\rsnHY	Hyphenation mode	paragraph	6
+\^	\rs*FAM	Font family	paragraph	T
+_
+Paragraphs	\rsnPI	Indentation	paragraph	5n
+\^	\rsnPD	Paragraph distance (spacing)	paragraph\
+	0.3v \fR(\f1v\fR)\*{\dg\*}
+\^	\rsnQI	Quotation indentation	paragraph	5n
+\^	\rsnPORPHANS	# of initial lines kept	paragraph\
+	1
+_
+Headings	\rsnPSINCR	Type (point) size increment\
+	heading	1p
+\^	\rsnGROWPS	Size increase depth limit	heading	0
+\^	\rsnHORPHANS	# of following lines kept\
+	heading	1
+\^	\rs*SN\-STYLE	Numbering style (alias)	heading\
+	\rs*SN\-DOT
+_
+Footnotes	\rsnFI	Indentation	footnote	2n
+\^	\rsnFF	Format	footnote	0
+\^	\rsnFPS	Type (point) size	footnote\
+	\rsnPS\-2p
+\^	\rsnFVS	Vertical spacing	footnote\
+	\rsnFPS+2p
+\^	\rsnFPD	Paragraph distance (spacing)	footnote\
+	\rsnPD/2
+\^	\rs*FR	Line length ratio	\fIspecial	11/12
+_
+Displays	\rsnDD	Display distance (spacing)\
+	\fIspecial	0.5v \fR(\f1v\fR)\*{\dg\*}
+\^	\rsnDI	Display indentation	\fIspecial	0.5i
+_
+Other	\rsnMINGW	Minimum gutter width	page	2n
+\^	\rsnTC\-MARGIN	TOC page number margin width\
+	\fCRPX\f call	\rsw\aq000\aq
+\^	\rsTC\-LEADER	TOC leader character\
+	\fCRPX\f call	.\rsh\aq1m\aq
+.TE
+.
+.
+.IP \*{*\*}
+Defaults vary by output device and paper format;
+the values shown are for typesetters using U.S.\& letter paper,
+and then terminals.
+.
+See section \lqPaper format\rq of the
+.I groff (1)
+man page.
+.
+.
+.IP \*{\dg\*}
+The
+.CW PD
+and
+.CW DD
+registers use the larger value if the vertical motion quantum of the
+output device is too coarse for the smaller one;
+usually,
+this is the case only for output to terminals and emulators thereof.
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Document description macros
+.XS
+Document description macros
+.XE
+.
+.
+.LP
+Only the simplest document lacks a title.\**
+.
+.FS
+Distinguish a document title from \lqtitles\rq,
+which are what
+.I roff
+systems call headers and footers collectively.
+.FE
+.
+As its level of sophistication
+(or complexity)
+increases,
+it tends to acquire a date of revision,
+explicitly identified authors,
+sponsoring institutions for authors,
+and,
+at the rarefied heights,
+an abstract of its content.
+.
+By default,
+.I ms
+arranges most of the document description
+(the title,
+author names and institutions,
+and abstract,
+but not the date)
+at the top of the first page.
+.
+.
+.PP
+Define these data by calling the macros below in the order shown;
+.CW .DA
+or
+.CW .ND
+can be called to set the document date
+(or other identifier)
+at any time before (a) the abstract,
+if present,
+or (b) its information is required in a header or footer.
+.
+Use of these macros is optional,
+except that
+.CW .TL
+is mandatory if any of
+.CW .RP ,
+.CW .AU ,
+.CW .AI ,
+or
+.CW .AB
+is called,
+and
+.CW .AE
+is mandatory if
+.CW .AB
+is called.
+.
+.
+.TS H
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+.TH
+\&.RP \fR\fIoption\f .\|.\|.	T{
+Use the \lqreport\rq
+(AT&T: \lqreleased paper\rq)
+format for your document,
+creating a separate cover page.
+.
+If the optional
+.CW no\-\:\%repeat\-\:\%info
+argument is given,
+.I ms
+produces a cover page but does not repeat any of its information
+subsequently
+(but see the
+.CW DA
+macro below regarding the date).
+.
+Normally,
+.CW .RP
+sets the page number following the cover page to\~1.
+.
+Specifying the optional
+.CW no\-\:\%renumber
+argument suppresses this alteration.
+.
+Optional arguments can occur in any order.
+.
+.CW no
+is recognized as a synonym of
+.CW no\-\:\%repeat\-\:\%info
+for AT&T compatibility.
+T}
+_
+\&.TL	T{
+Specify the document title.
+.
+.I ms
+collects text on input lines following this call into the title
+until reaching
+.CW .AU ,
+.CW .AB ,
+or a heading or paragraphing macro call.
+T}
+_
+\&.AU	T{
+Specify an author's name.
+.
+.I ms
+collects text on input lines following this call into the author's name
+until reaching
+.CW .AI ,
+.CW .AB ,
+another
+.CW .AU ,
+or a heading or paragraphing macro call.
+.
+Call it repeatedly to specify multiple authors.
+T}
+_
+\&.AI	T{
+Specify the preceding author's institution.
+.
+An
+.CW .AU
+call is usefully followed by at most one
+.CW .AI
+call;
+if there are more,
+the last
+.CW .AI
+call controls.
+.
+.I ms
+collects text on input lines following this call into the author's
+institution until reaching
+.CW .AU ,
+.CW .AB ,
+or a heading or paragraphing macro call.
+T}
+_
+\&.DA \fR\fIx\f .\|.\|.\&	T{
+Typeset the current date,
+or any
+.I x , arguments\~
+in the center footer,
+and,
+if
+.CW .RP
+is also called,
+left-aligned at the end of the document description on the cover page.
+T}
+_
+\&.ND \fR\fIx\f .\|.\|.\&	T{
+Typeset the current date,
+or any
+.I x , arguments\~
+if
+.CW .RP
+is also called,
+left-aligned at the end of the document description on the cover page.
+.
+This is
+.I "groff ms" 's
+default.
+T}
+_
+\&.AB \fR\fno\fR	T{
+Begin the abstract.
+.
+.I ms
+collects text on input lines following this call into the abstract
+until reaching an
+.CW .AE
+call.
+.
+By default,
+.I ms
+places the word \lqABSTRACT\rq centered and in italics above the
+text of the abstract.
+.
+The optional argument
+.CW no
+suppresses this heading.
+T}
+_
+\&.AE	End the abstract.
+.TE
+.
+.
+.KS
+.LP
+An example document description,
+using a cover page,
+follows.
+.
+.
+.\" Wrap lines in the code example below at 64 columns.
+.TS
+box center;
+l.
+T{
+.nf
+.CW
+\&.RP
+\&.TL
+The Inevitability of Code Bloat in Commercial and Free Software
+\&.AU
+J.\rs& Random Luser
+\&.AI
+University of West Bumblefuzz
+\&.AB
+This report examines the long-term growth of the code bases in
+two large,
+popular software packages;
+the free Emacs and the commercial Microsoft Word.
+While differences appear in the type or order of features added,
+due to the different methodologies used,
+the results are the same in the end.
+\&.PP
+The free software approach is shown to be superior in that while
+free software can become as bloated as commercial offerings,
+free software tends to have fewer serious bugs and the added
+features are more in line with user demand.
+\&.AE
+.R
+\&.\|.\|.\|the rest of the paper\|.\|.\|.
+.fi
+T}
+.TE
+.KE
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Body text
+.XS
+Body text
+.XE
+.
+.
+.LP
+A variety of macros,
+registers,
+and strings can be used to structure and style the body of your
+document.
+.
+They organize your text into
+paragraphs,
+headings,
+footnotes,
+and inclusions of material such as tables and figures.
+.
+.
+.KS
+.NH 2
+Text settings
+.XS
+	Text settings
+.XE
+.
+.
+.LP
+The
+.CW FAM
+string,
+a GNU extension,
+sets the font family for body text;
+the default is
+.CW T \rq. \lq
+.
+The
+.CW PS
+and
+.CW VS
+registers set the type size and vertical spacing
+(distance between text baselines),
+respectively.
+.
+The font family and type size are ignored on terminal devices.
+.
+Setting these parameters before the first call of a heading,
+paragraphing,
+or (non-date) document description macro also applies them to headers,
+footers,
+and
+(for
+.CW FAM )
+footnotes.
+.
+.
+.PP
+Which font families are available depends on the output device;
+as a convention,
+.CW T
+selects a serif family (\lqTimes\rq),
+.CW H
+a sans-serif family (\lqHelvetica\rq),
+and
+.CW C
+a monospaced family (\lqCourier\rq).
+.
+The man page for the output driver documents its font repertoire.
+.
+Consult the
+.I groff (1)
+man page for lists of available output devices and their drivers.
+.
+.
+.PP
+The
+.CW HY
+register defines the automatic hyphenation mode used with the
+.CW hy
+request.
+.
+Setting
+.CW \rsnHY
+.CW 0 "" to\~
+is equivalent to using the
+.CW nh
+request.
+.
+This is a Tenth Edition Research Unix extension.
+.KE
+.
+.
+.KS
+.NH 2
+Typographical symbols
+.XS
+	Typographical symbols
+.XE
+.
+.
+.LP
+.I ms
+provides a few strings to obtain typographical symbols not easily
+entered with the keyboard.
+.
+These and many others are available as special character escape
+sequences\*-see
+the
+.I groff_char (7)
+man page.
+.
+.TS
+box center;
+cb lb
+Lf(CR) Lx.
+String	Description
+_
+\rs*\-	Interpolate an em dash.
+_
+\rs*Q	T{
+Interpolate typographer's quotation marks where available,
+and neutral double quotes otherwise.
+.
+.CW \rs*Q
+is the left quote and
+.CW \rs*U
+the right.
+T}
+\rs*U	\^
+.TE
+.KE
+.
+.
+.KS
+.NH 2
+Paragraphs
+.XS
+	Paragraphs
+.XE
+.
+.
+.LP
+Paragraphing macros
+.I break ,
+or terminate,
+any pending output line so that a new paragraph can begin.
+.
+Several paragraph types are available,
+differing in how indentation
+applies to them:
+to left,
+right,
+or both margins;
+to the first output line of the paragraph,
+all output lines,
+or all but the first.
+.
+All paragraphing macro calls cause the insertion of vertical space in
+the amount stored in the
+.CW PD
+register,
+except at page or column breaks.
+.
+Alternatively,
+a blank input line breaks the output line and vertically spaces by one
+vee.
+.KE
+.
+.
+.PP
+The
+.CW PORPHANS
+register defines the minimum number of initial lines of any paragraph
+that must be kept together to avoid isolated lines at the bottom of a
+page.
+.
+If a new paragraph is started close to the bottom of a page,
+and there is insufficient space to accommodate
+.CW \rsnPORPHANS
+lines before an automatic page break,
+then a page break is forced before the start of the paragraph.
+.
+This is a GNU extension.
+.
+.
+.TS H
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+.TH
+\&.LP	Set a paragraph without any (additional) indentation.
+_
+\&.PP	T{
+Set a paragraph with a first-line left indentation of
+.CW \rsnPI .
+T}
+_
+\&.IP \fR\fImarker\f \fIwidth\f	T{
+Set a paragraph with a left indentation.
+.
+The optional
+.I marker
+is not indented and is empty by default.
+.
+It has several applications;
+see subsection \lqLists\rq below.
+.
+.I width
+overrides the indentation amount in
+.CW \rsnPI ;
+its default unit is
+.CW n \rq. \lq
+.
+Once specified,
+.I width
+applies to further
+.CW .IP
+calls until specified again or a heading or different paragraphing macro
+is called.
+T}
+_
+\&.QP	T{
+Set a paragraph indented from both left and right margins by
+.CW \rsnQI .
+T}
+_
+T{
+\&.QS
+.br
+\&.QE
+T}	T{
+Begin
+.CW QS ) (
+and end
+.CW QE ) (
+a region where each paragraph is indented from both margins by
+.CW \rsnQI .
+.
+The text between
+.CW .QS
+and
+.CW .QE
+can be structured further by use of other paragraphing macros.
+T}
+_
+\&.XP	T{
+Set an \lqexdented\rq paragraph\emone with a left indentation of
+.CW \rsnPI
+on every line
+.I except
+the first
+(also known as a hanging indent).
+.
+This is a Berkeley extension.
+T}
+.TE
+.
+.
+.KS
+.PP
+The following example illustrates the use of paragraphing macros.
+.
+.
+.TS
+box center;
+l.
+T{
+.nf
+.CW
+\&.NH 2
+Cases used in the 2001 study
+\&.LP
+Two software releases were considered for this report.
+\&.PP
+The first is commercial software;
+the second is free.
+\&.IP \rsbu
+Microsoft Word for Windows,
+starting with version 1.0 through the current version
+(Word 2000).
+\&.IP \rsbu
+GNU Emacs,
+from its first appearance as a standalone editor through the
+current version (v20).
+See Bloggs 2002 for details.
+\&.QP
+Franklin\aqs Law applied to software:
+software expands to outgrow both RAM and disk space over time.
+\&.SH
+Bibliography
+\&.XP
+Bloggs, Joseph R.,
+\&.I "Everyone\aqs a Critic" ,
+Underground Press, March 2002.
+A definitive work that answers all questions and criticisms
+about the quality and usability of free software.
+.R
+.fi
+T}
+.TE
+.KE
+.
+.
+.KS
+.NH 2
+Headings
+.XS
+	Headings
+.XE
+.
+.
+.LP
+Use headings to create a hierarchical structure for your document.
+.
+The
+.I ms
+macros print headings in
+.B bold
+using the same font family and,
+by default,
+type size as the body text.
+.
+Headings are available with and without automatic numbering.
+.
+Text on input lines following the macro call becomes the heading's
+title.
+.
+Call a paragraphing macro to end the heading text and start the
+section's content.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.NH \fIdepth\f	T{
+Set an automatically numbered heading.
+.
+.I ms
+produces a numbered heading in the form
+.CW
+.I a .\c
+.I b .\c
+.R
+.I c .\|.\|.,
+to any level desired,
+with the numbering of each depth increasing automatically and being
+reset to zero when a more significant depth increases.
+.
+\lq1\rq\~is the most significant or coarsest division of the
+document.
+.
+Only non-zero values are output.
+.
+If
+.I depth
+is omitted,
+it is taken to be
+.CW 1 .
+.
+If you specify
+.I depth
+such that an ascending gap occurs relative to the previous
+.CW NH
+call\emthat is,
+you \lqskip a depth\rq,
+as by
+.CW ".NH\~1" \rq \lq
+and then
+.CW ".NH\~3" \rq\c \lq
+.I "groff ms" "" \em
+emits a warning on the standard error stream.
+T}
+\&.NH S \fIheading-depth-index\f\fR .\|.\|.\f	T{
+Alternatively,
+you can give
+.CW NH
+a first argument
+.CW S , of\~
+followed by integers to number the heading depths explicitly.
+.
+Further automatic numbering,
+if used,
+resumes using the specified indices as their predecessors.
+.
+.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+This feature is a Berkeley extension.
+T}
+.TE
+.KE
+.
+.
+.PP
+An example may be illustrative.
+.
+.
+.TS
+box center;
+cb | cb
+lf(CR) | lB.
+Input	Result
+_
+T{
+.nf
+\&.NH 1
+Animalia
+\&.NH 2
+Arthropoda
+\&.NH 3
+Crustacea
+\&.NH 2
+Chordata
+\&.NH S 6 6 6
+Daimonia
+\&.NH 1
+Plantae
+.fi
+T}	T{
+.nf
+1.  Animalia
+.sp
+1.1.  Arthropoda
+.sp
+1.1.1.  Crustacea
+.sp
+1.2.  Chordata
+.sp
+6.6.6.  Daimonia
+.sp
+7.  Plantae
+.fi
+T}
+.TE
+.
+.
+.PP
+After
+.CW .NH
+is called,
+the assigned number is made available in the strings
+.CW SN\-DOT
+(as it appears in a printed heading with default formatting,
+followed by a terminating period)
+and
+.CW SN\-NO\-DOT
+(with the terminating period omitted).
+.
+These are GNU extensions.
+.
+.
+.PP
+You can control the style used to print numbered headings by defining an
+appropriate alias for the string
+.CW SN\-STYLE .
+.
+By default,
+.CW \rs*SN\-STYLE
+is aliased to
+.CW \rs*SN\-DOT .
+.
+If you prefer to omit the terminating period from numbers appearing in
+numbered headings,
+you may define the alias as follows.
+.
+.
+.TS
+box center;
+lf(CR).
+\&.als SN\-STYLE SN\-NO\-DOT
+.TE
+.
+.
+.LP
+Any such change in numbering style becomes effective from the next use
+of
+.CW .NH
+following redefinition of the alias for
+.CW \rs*SN\-STYLE .
+.
+The formatted number of the current heading is available in
+.CW \rs*SN
+(a feature first documented by Berkeley),
+which facilitates its inclusion in,
+for example,
+table captions,
+equation labels,
+and
+.CW .XS /\c
+.CW .XA /\c
+.CW .XE
+table of contents entries.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.SH \fIdepth\f	T{
+Set an unnumbered heading.
+.
+The optional
+.I depth
+argument is a GNU extension indicating the heading depth corresponding
+to the
+.I depth
+argument of
+.CW .NH .
+.
+It matches the type size at which the heading is set to that of a
+numbered heading at the same depth when the
+.CW \rsnGROWPS
+and
+.CW \rsnPSINCR
+heading size adjustment mechanism is in effect.
+T}
+.TE
+.
+.
+.PP
+The
+.CW PSINCR
+register defines an increment in type size to be applied to a heading at
+a lesser depth than that specified in
+.CW \rsnGROWPS .
+.
+The value of
+.CW \rsnPSINCR
+should be specified in points with the
+.CW p
+scaling unit and may include a fractional component;
+for example,
+.
+.
+.TS
+box center;
+lf(CR).
+\&.nr PSINCR 1.5p
+.TE
+.
+.
+.LP
+sets a type size increment of 1.5 points.
+.
+.
+.PP
+The
+.CW GROWPS
+register defines the heading depth above which the type size increment
+set by
+.CW \rsnPSINCR
+becomes effective.
+.
+For each heading depth less than the value of
+.CW \rsnGROWPS ,
+the type size is increased by
+.CW \rsnPSINCR .
+.
+Setting
+.CW \rsnGROWPS
+to a value less than\~2 disables the incremental heading size feature.
+.
+.
+.PP
+In other words,
+if the value of
+.CW GROWPS
+register is greater than the
+.I depth
+argument to a
+.CW .NH
+or
+.CW .SH
+call,
+the type size of a heading produced by these macros increases by
+.CW \rsnPSINCR
+units over
+.CW \rsnPS
+multiplied by the difference of
+.CW \rsnGROWPS
+and
+.I depth .
+.
+.
+For example,
+the sequence
+.
+.TS
+box center;
+lf(CR).
+\&.nr PS 10
+\&.nr GROWPS 3
+\&.nr PSINCR 1.5p
+\&.NH 1
+Carnivora
+\&.NH 2
+Felinae
+\&.NH 3
+Felis catus
+\&.SH 2
+Machairodontinae
+.TE
+.
+.
+.LP
+will cause \lq1. Carnivora\rq to be printed in 13-point text,
+followed by \lq1.1. Felinae\rq in 11.5-point text,
+while \lq1.1.1. Felis catus\rq and all more deeply nested headings
+will remain in the 10-point text specified by the
+.CW PS
+register.
+.
+\lqMachairodontinae\rq is printed at 11.5 points,
+since it corresponds to heading depth\~2.
+.
+.
+.PP
+The
+.CW \rsnHORPHANS
+register operates in conjunction with the
+.CW NH
+and
+.CW SH
+macros to inhibit the printing of isolated headings at the bottom of a
+page;
+it specifies the minimum number of lines of the subsequent paragraph
+that must be kept on the same page as the heading.
+.
+If insufficient space remains on the current page to accommodate the
+heading and this number of lines of paragraph text,
+a page break is forced before the heading is printed.
+.
+Any display macro call or
+.I tbl ,
+.I pic ,
+or
+.I eqn
+region
+(see subsequent sections)
+between the heading and the subsequent paragraph suppresses this
+grouping.
+.
+.
+.\" The next table is huge and we need a lot of room for it, but we
+.\" can't use a keep because it's a boxed repeated-heading table.  Flush
+.\" the pending output line and demand half a page.
+.br
+.ne (\n.pu / 2u)
+.NH 2
+Typeface and decoration
+.XS
+	Typeface and decoration
+.XE
+.
+.
+.LP
+The
+.I ms
+macros provide a variety of ways to style text.
+.
+Attend closely to the ordering of arguments labeled
+.I pre
+and
+.I post,
+which is not intuitive.
+.
+Support for
+.I pre
+arguments is a GNU extension.\**
+.FS
+This idiosyncrasy arose through feature accretion;
+for example,
+the
+.CW B
+macro in Version\~6 Unix
+.I ms
+(1975) accepted only one argument,
+the text to be set in boldface.
+.
+By Version\~7 (1979) it recognized a second argument;
+in 1990,
+.I "groff ms"
+added a \*Qpre\*U argument,
+placing it third to avoid breaking support for older documents.
+.FE
+.
+.
+.TS H
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+.TH
+\&.B \fR\fItext\f \fIpost\f \fIpre\f	T{
+Style
+.I text
+in
+.B bold ,
+followed by
+.I post
+in the previous font style without intervening space,
+and preceded by
+.I pre
+similarly.
+.
+Without arguments,
+.I ms
+styles subsequent text in bold
+until the next
+paragraphing,
+heading,
+or no-argument typeface macro call.
+T}
+_
+\&.R \fR\fItext\f \fIpost\f \fIpre\f	T{
+As
+.CW .B ,
+but use the roman style
+(upright text of normal weight)
+instead of bold.
+.
+Argument recognition is a GNU extension.
+T}
+_
+\&.I \fR\fItext\f \fIpost\f \fIpre\f	T{
+As
+.CW .B ,
+but use an
+.I italic
+or oblique style instead of bold.
+T}
+_
+\&.BI \fR\fItext\f \fIpost\f \fIpre\f	T{
+As
+.CW .B ,
+but use a
+.BI "bold italic"
+or bold oblique style instead of upright bold.
+.
+This is a Tenth Edition Research Unix extension.
+.\" possibly 9th, but definitely not Berkeley
+T}
+_
+\&.CW \fR\fItext\f \fIpost\f \fIpre\f	T{
+As
+.CW .B ,
+but use a
+.CW constant-width
+(monospaced) roman typeface instead of bold.
+.
+This is a Tenth Edition Research Unix extension.
+.\" possibly 9th, but definitely not Berkeley
+T}
+_
+\&.BX \fR\fItext\f	T{
+Typeset
+.I text
+and draw a
+.BX box
+around it.
+.
+On terminal devices,
+reverse video is used instead
+(see the implementation note below).
+.
+If you want
+.I text
+to contain space,
+use unbreakable space or horizontal motion escape sequences
+.CW \rs\ti , (
+.CW \rs\c
+.I space ,
+.CW \rs\ha ,
+.CW \rs| ,
+.CW \rs0 ,
+or
+.CW \rsh ).
+T}
+_
+\&.UL \fR\fItext\f \fIpost\f	T{
+Typeset
+.I text
+with an
+.UL underline .
+.
+.I post,
+if present,
+is set after
+.I text
+with no intervening space.
+T}
+_
+\&.LG	T{
+Set subsequent text in
+.LG
+larger type
+.NL
+(2\~points larger than the current size)
+until the next
+type size,
+paragraphing,
+or heading macro call.
+.
+You can
+.LG
+specify this macro
+.LG
+multiple times
+.NL
+to enlarge the type size as needed.
+T}
+_
+\&.SM	T{
+Set subsequent text in
+.SM
+smaller type
+.NL
+(2\~points smaller than the current size)
+until the next
+type size,
+paragraphing,
+or heading macro call.
+.
+You can
+.SM
+specify this macro
+.SM
+multiple times
+.NL
+to reduce the type size as needed.
+T}
+_
+\&.NL	T{
+Set subsequent text at the normal type size
+.CW \rsnPS ). (
+T}
+.TE
+.
+.
+.PP
+.I pre
+and
+.I post
+arguments
+are typically used to simplify the attachment of punctuation to styled
+words.
+When
+.I pre
+is used,
+a hyphenation control escape sequence
+.CW \rs%
+that would ordinarily start
+.I text
+must start
+.I pre
+instead to have the desired effect.
+.
+.TS
+box center;
+Cb Cb
+Lf(CR) L.
+Input	Result
+T{
+.na
+.nh
+The CS course\aqs students found one C language keyword
+.br
+\&.CW static ) \rs%(
+.br
+most troublesome.
+T}	T{
+The CS course's students found one C language keyword
+.CW static ) \%(
+most troublesome.
+T}
+.TE
+.
+.KS
+You can use the output line continuation escape sequence
+.CW \rsc
+to achieve the same result.
+.
+It is also portable to some older
+.I ms
+implementations. \" DWB 3.3 ms: no; Heirloom Doctools ms: yes
+.
+.TS
+box center;
+Cb Cb
+Lf(CR) L.
+Input	Result
+T{
+.na
+.nh
+The CS course\aqs students found one C language keyword
+.br
+\rs%(\rsc
+.br
+\&.CW static )
+.br
+most troublesome.
+T}	T{
+The CS course's students found one C language keyword
+\%(\c
+.CW static )
+most troublesome.
+T}
+.TE
+.KE
+.
+.
+.PP
+Rather than calling the
+.CW CW
+macro,
+in
+.I "groff ms"
+you might prefer to change the font family to Courier by setting
+.CW \rs*FAM
+to
+.CW C \rq. \lq
+.
+You can then use all four style macros above,
+returning to the default family (Times) with
+.CW ".ds FAM T" \rq. \lq
+.
+Because changes to
+.CW \rs*FAM
+take effect only at the next paragraph,
+this document uses
+.CW .CW
+to \lqinline\rq a change to the font family,
+marking syntactical elements of
+.I ms
+and
+.I groff .
+.
+.
+.KS
+.PP
+.I "groff ms"
+also offers strings to begin and end super- and subscripting.
+.
+These are GNU extensions.
+.
+.
+.TS
+box;
+lb lb
+lf(CR) lx.
+String	Description
+_
+\rs*{	Begin superscripting.
+\rs*}	End superscripting.
+_
+\rs*<	Begin subscripting.
+\rs*>	End subscripting.
+.TE
+.KE
+.
+.
+.nr PS -2
+.nr VS -2
+.LP
+.B1
+.hy 0
+.I "Implementation note:"
+In
+.CW nroff
+mode,
+the
+.CW BX
+macro \lqboxes\rq its argument by bracketing it with
+.I groff
+extension escape sequences to set the foreground color to black and the
+background to white and then reset them to their previous values;
+the terminal output driver,
+.I grotty (1),
+converts these to ISO\~6429 color escape sequences,
+which may be ignored or mishandled by some terminals,
+or may be disabled by
+.I grotty 's
+.CW \-c
+option.
+.
+Further,
+if the terminal is set up to use these colors in those roles already,
+.CW .BX
+will cause no visible effect in the output.
+.
+Surmounting these challenges would require adding features to
+.I grotty ,
+for instance to provide a mechanism to request ISO\~6429's
+\lqstandout\rq mode \" That's "smso" and "rmso" in terminfo.
+(often supported on monochrome terminals),
+or to replace the presumed support of the terminal for ISO\~6429 escape
+sequences with the use of a library that can query the capabilities of
+the terminal and adapt the output sent to the device accordingly.
+.
+(Practically,
+this likely means adding a dependency on
+.CW libtinfo .)
+.
+Contact the
+.I groff
+development mailing list if you'd like to contribute.
+.sp \nPD/2
+.B2
+.nr PS +2
+.nr VS +2
+.
+.
+.NH 2
+Lists
+.XS
+	Lists
+.XE
+.
+.
+.LP
+The
+.I marker
+argument to the
+.CW IP
+macro can be employed to present a variety of lists;
+for instance,
+you can use a bullet glyph
+.CW \rsbu ) (
+for unordered lists,
+a number
+(or auto-incrementing register)
+for numbered lists,
+or a word or phrase for glossary-style or definition lists.
+.
+If you set the paragraph indentation register
+.CW PI
+before calling
+.CW IP ,
+you can later reorder the items in the list without having to ensure
+that a
+.I width
+argument remains affixed to the first call.
+.
+.
+.TS H
+box center;
+cb cb
+lf(CR) l .
+Input	Result
+_
+.TH
+T{
+.nf
+\&.nr PI 2n
+A bulleted list:
+\&.IP \rsbu
+lawyers
+\&.IP \rsbu
+guns
+\&.IP \rsbu
+money
+.fi
+T}	T{
+.nr PI 2n
+A bulleted list:
+.IP \bu
+lawyers
+.IP \bu
+guns
+.IP \bu
+money
+T}
+_
+T{
+.nf
+\&.nr step 0 1
+\&.nr PI 3n
+A numbered list:
+\&.IP \rsn+step.
+lawyers
+\&.IP \rsn+step.
+guns
+\&.IP \rsn+step.
+money
+.fi
+T}	T{
+.nr step 0 1
+.nr PI 3n
+A numbered list:
+.IP \n+step.
+lawyers
+.IP \n+step.
+guns
+.IP \n+step.
+money
+T}
+_
+T{
+.nf
+A glossary-style list:
+\&.IP lawyers 0.4i
+Two or more attorneys.
+\&.IP guns
+Firearms,
+preferably large-caliber.
+\&.IP money
+Gotta pay for those
+lawyers and guns!
+.fi
+T}	T{
+A glossary-style list:
+.
+.IP lawyers 0.4i
+Two or more attorneys.
+.IP guns
+Firearms,
+preferably large-caliber.
+.IP money
+Gotta pay for those lawyers and guns!
+T}
+.TE
+.
+.
+.PP
+In the enumerated list example,
+we employed the
+.CW nr
+request to create a register of our own,
+.CW step .
+.
+We initialized it to zero and assigned it an auto-increment of 1.
+.
+Each time we use the escape sequence
+.CW \rsn+PI
+(note the plus sign),
+the formatter applies the increment just before interpolating the
+register's value.
+.
+Preparing the
+.CW PI
+register as well enables us to rearrange the list without the tedium of
+updating macro calls.
+.
+.
+.PP
+In the glossary example,
+observe how the
+.CW IP
+macro places the definition on the same line as the term if it has
+enough space.
+.
+If this is not what you want,
+there are a few workarounds we will illustrate by modifying the example.
+.
+First,
+you can use a
+.CW br
+request to force a break after printing the term or label.
+.
+Second,
+you could apply the
+.CW \rsp
+escape sequence to force a break.
+.
+The space following the escape sequence is important;
+if you omit it,
+.I groff
+prints the first word of the paragraph text on the same line as the term
+or label
+(if it fits)
+.I then
+breaks the line.
+.
+Finally,
+you may append a horizontal motion to the marker with the
+.CW \rsh
+escape sequence;
+using the same amount as the indentation will ensure that the marker is
+too wide for
+.I groff
+to treat it as \lqfitting\rq on the same line as the paragraph text.
+.
+.
+.TS
+box center;
+cb | cb | cb
+lf(CR) | lf(CR)  | lf(CR).
+Approach #1	Approach #2	Approach #3
+_
+T{
+.nf
+\&.IP guns
+\&.br
+Firearms,
+.fi
+T}	T{
+.nf
+\&.IP guns
+\rsp Firearms,
+.fi
+T}	T{
+.nf
+\&.IP guns\rsh\aq0.4i\aq
+Firearms,
+.fi
+T}
+_
+.T&
+cb s s
+l s s.
+Result
+_
+T{
+A glossary-style list:
+.
+.IP lawyers 0.4i
+Two or more attorneys.
+.IP guns\h\aq0.4i\aq 0.4i
+Firearms,
+preferably large-caliber.
+.IP money
+Gotta pay for those lawyers and guns!
+T}
+.TE
+.
+.
+.NH 2
+Indented regions
+.XS
+	Indented regions
+.XE
+.
+.
+.LP
+You may need to indent a region of text while otherwise formatting it
+normally.
+.
+Indented regions can be nested;
+you can change
+.CW \rsnPI
+before each call to vary the amount of inset.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.RS	T{
+Begin a region where headings,
+paragraphs,
+and displays are indented (further) by
+.CW \rsnPI .
+T}
+\&.RE	T{
+End the (next) most recent indented region.
+T}
+.TE
+.
+.
+.PP
+This feature enables you to easily line up text under hanging and
+indented paragraphs.
+.
+For example,
+you may wish to structure lists hierarchically.
+.
+.
+.KS
+.TS
+box center;
+cb cb
+lf(CR)8 l .
+Input	Result
+_
+T{
+.nf
+.CW
+\&.IP \rsbu 2
+Lawyers:
+\&.RS
+\&.IP \rsbu
+Dewey,
+\&.IP \rsbu
+Cheatham,
+and
+\&.IP \rsbu
+Howe.
+\&.RE
+\&.IP \rsbu
+Guns
+.R
+\&.\|.\|.
+.fi
+T}	T{
+.IP \bu 2
+Lawyers:
+.RS
+.IP \bu
+Dewey,
+.IP \bu
+Cheatham,
+and
+.IP \bu
+Howe.
+.RE
+.IP \bu
+Guns
+\&.\|.\|.
+T}
+.TE
+.KE
+.
+.
+.NH 2
+Keeps, boxed keeps, and displays
+.XS
+	Keeps, boxed keeps, and displays
+.XE
+.
+.
+.LP
+On occasion,
+you may want to
+.I keep
+several lines of text,
+or a region of a document,
+together on a single page,
+preventing an automatic page break within certain boundaries.
+.
+This can cause a page break to occur earlier than it normally would.
+.
+For example,
+you may want to keep two paragraphs together,
+or a paragraph that refers to a table,
+list,
+or figure adjacent to the item it discusses.
+.
+.I ms
+provides the
+.CW KS
+and
+.CW KE
+macros for this purpose.
+.
+.
+.PP
+You can alternatively specify a
+.I "floating keep:"
+if a keep cannot fit on the current page,
+.I ms
+holds its contents and allows material following the keep
+(in the source document)
+to fill the remainder of the current page.
+.
+When the page breaks,
+whether by reaching the end or
+.CW bp
+request,
+.I ms
+puts the floating keep at the beginning of the next page.
+.
+This is useful for placing large graphics or tables that do not need to
+appear exactly where they occur in the source document.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.KS	Begin a keep.
+\&.KF	Begin a floating keep.
+_
+\&.KE	End (floating) keep.
+.TE
+.
+.
+.PP
+As an alternative to the keep mechanism,
+the
+.CW ne
+request forces a page break if there is not at least the amount of
+vertical space specified in its argument remaining on the page.
+.
+One application of
+.CW ne
+is to reserve space on the page for a figure or illustration to be
+included later.
+.
+.
+.KS
+.PP
+A
+.I "boxed keep"
+has a frame drawn around it.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.B1	Begin a keep with a box drawn around it.
+\&.B2	End boxed keep.
+.TE
+.KE
+.
+.
+.KS
+.LP
+Boxed keep macros cause breaks;
+if you need to box a word or phrase within a line,
+see the
+.CW BX
+macro in section \lqTypeface and decoration\rq above.
+.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.
+.
+If you wish to place one or more paragraphs in a boxed keep,
+you may improve their appearance by calling
+.CW .B1
+after the first paragraphing macro,
+and by adding a small amount of vertical space before calling
+.CW .B2 .
+.
+.
+.TS
+box center;
+lf(CR).
+\&.LP
+\&.B1
+\&.I Warning:
+Happy Fun Ball may suddenly accelerate to dangerous speeds.
+\&.sp \rsnPD/2 \rs" space by half the inter-paragraph distance
+\&.B2
+.TE
+.KE
+.
+.
+.LP
+If you want a boxed keep to float,
+you will need to enclose the
+.CW .B1
+and
+.CW .B2
+calls within a pair of
+.CW .KF
+and
+.CW .KE
+calls.
+.
+.
+.PP
+.I Displays
+turn off filling;
+lines of verse or program code are shown with their lines broken as in
+the source document without requiring
+.CW br
+requests between lines.
+.
+Displays can be kept on a single page or allowed to break across pages.
+.
+The
+.CW DS
+macro begins a kept display of the layout specified in its first
+argument;
+non-kept displays are begun with dedicated macros corresponding to their
+layout.
+.
+.
+.TS
+box;
+cb s | cb
+cb cb | ^
+lf(CR) lf(CR) | lx .
+Display macro	Description
+With keep	Without keep
+_
+\&.DS L	\&.LD	Begin left-aligned display.
+\&.DS \fR\fI\fR \,\fIindent\/\f	\
+\&.ID \fR\,\fIindent\/\f	T{
+Begin display indented by
+.I indent
+if given,
+.CW \rsnDI
+otherwise.
+T}
+\&.DS B	\&.BD	T{
+Begin block display
+(left-aligned with longest line centered).
+T}
+\&.DS C	\&.CD	Begin centered display.
+\&.DS R	\&.RD	T{
+Begin right-aligned display.
+This is a GNU extension.
+T}
+_
+.T&
+cf(CR) s | lx .
+\&.DE	End any display.
+.TE
+.
+.
+.PP
+The distance stored in
+.CW \rsnDD
+is inserted before and after each pair of display macros;
+this is a Berkeley extension.
+.
+In
+.I "groff ms" ,
+this distance replaces any adjacent inter-paragraph distance
+or subsequent spacing prior to a section heading.
+.
+The
+.CW DI
+register is a GNU extension;
+its value is an indentation applied to displays created with
+.CW .DS
+and
+.CW .ID
+without arguments,
+to
+.CW .DS\~I \rq \lq
+without an indentation argument,
+and to equations set with
+.CW .EQ\~I \rq. \lq
+.
+Changes to either register take effect at the next display boundary.
+.
+.
+.KS
+.NH 2
+Tables, figures, equations, and references
+.XS
+	Tables, figures, equations, and references
+.XE
+.LP
+The
+.I ms
+package is often used with the
+.I tbl ,
+.I pic ,
+.I eqn ,
+and
+.I refer
+preprocessors.
+.
+The
+.CW \rsnDD
+distance is also applied to regions of the document preprocessed with
+.I tbl ,
+.I pic ,
+and
+.I eqn .
+.
+Mark text meant for preprocessors by enclosing it in pairs of tokens as
+follows,
+with nothing between the dot and the macro name.
+.
+The preprocessors match these tokens only at the start of an input line.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Tag pair	Description
+_
+T{
+\&.TS
+.R
+.CW H  
+.CW
+.br
+\&.TE
+T}	T{
+Demarcate a table to be processed by the
+.I tbl
+preprocessor.
+.
+The optional
+.CW H
+argument to
+.CW .TS
+instructs
+.I ms
+to repeat table rows
+(often column headings)
+at the top of each new page the table spans,
+if applicable;
+calling the
+.CW TH
+macro marks the end of such rows.
+.
+The GNU
+.I tbl (1)
+man page provides a comprehensive reference to the preprocessor and
+offers examples of its use.
+T}
+_
+T{
+\&.PS
+.br
+\&.PE
+.br
+\&.PF
+T}	T{
+.CW .PS
+begins a picture to be processed by the
+.I pic
+preprocessor;
+either of
+.CW .PE
+or
+.CW .PF
+ends it,
+the latter with \lqflyback\rq to the vertical position at its top.
+.
+You can create
+.I pic
+input manually or with a program such as
+.I xfig (1).
+T}
+_
+T{
+\&.EQ
+.R
+.I align \~\c 
+.I label 
+.CW
+.br
+\&.EN
+T}	T{
+Demarcate an equation to be processed by the
+.I eqn
+preprocessor.
+.
+The equation is centered by default;
+.I align
+can be
+.CW C ,
+.CW L ,
+or
+.CW I
+to (explicitly) center,
+left-align,
+or indent it by
+.CW \rsnDI ,
+respectively.
+.
+If specified,
+.I label
+is set right-aligned.
+T}
+_
+T{
+\&.
+.br
+\&.
+T}	T{
+Demarcate a bibliographic citation to be processed by the
+.I refer
+preprocessor.
+.
+The GNU
+.I refer (1)
+man page provides a comprehensive reference to the preprocessor and the
+format of its bibliographic database.
+T}
+.TE
+.KE
+.
+.
+.PP
+When
+.I refer
+emits collected references
+(as might be done on a \lqWorks Cited\rq page),
+it interpolates the string
+.CW \rs*REFERENCES
+as an unnumbered heading
+.CW .SH ). (
+.
+.
+.KS
+.PP
+The following is an example of how to set up a table that may print
+across two or more pages.
+.
+.
+.TS
+box center;
+l .
+T{
+.nf
+.CW
+\&.TS H
+allbox;
+Cb | Cb .
+Part\->Description
+_
+\&.TH
+\&.T&
+L | Lx .
+GH-1978\->Fribulating gonkulator
+.R
+\&.\|.\|.\|the rest of the table follows\|.\|.\|.
+.CW
+\&.TE
+.R
+.fi
+T}
+.TE
+.
+.
+Attempting to place a multi-page table inside a keep can lead to
+unpleasant results,
+particularly if the
+.I tbl
+.CW allbox
+option is used.
+.KE
+.
+.
+.PP
+Mathematics can be typeset using the language of the
+.I eqn
+preprocessor.
+.
+.
+.TS
+box center;
+Lf(CR).
+\&.EQ C (\rs*SN\-NO\-DOTa)
+p \ti = \ti q sqrt { 1 + \ti ( x / q sup 2 ) }
+\&.EN
+.TE
+.
+.
+This input formats a labelled equation.
+.
+We used the
+.CW SN\-NO\-DOT
+string to base the equation label on the current heading number,
+giving us more flexibility to reorganize the document.
+.
+.
+.EQ C (\*SN-NO-DOTa)
+p ~ = ~ q sqrt { 1 + ~ ( x / q sup 2 ) }
+.EN
+.
+Use
+.I groff
+options
+to run preprocessors on the input:
+.CW \-e
+for
+.I eqn ,
+.CW \-p
+for
+.I pic ,
+.CW \-R
+for
+.I refer ,
+and
+.CW \-t
+for
+.I tbl.
+.
+.
+.KS
+.NH 2
+Footnotes
+.XS
+	Footnotes
+.XE
+.
+.
+.LP
+.\" The following sentence is used below as an example as well.  Keep it
+.\" in sync.
+A footnote is typically anchored to a place in the text with a
+.I marker,
+which is a small integer,\**
+.FS
+like this numeric footnote
+.FE
+a symbol,\*{\dg\*}
+.FS \dg
+like this symbolic footnote
+.FE
+or arbitrary user-specified text.
+.
+.
+.TS
+box;
+lb lb
+lf(CR) lx.
+String	Description
+_
+\rs**	T{
+Place an
+.I "automatic number,"
+an automatically updated numeric footnote marker,
+in the text.
+.
+Each time this string is interpolated,
+the number it produces increments by one.
+.
+Automatic numbers start at 1.
+.
+This is a Berkeley extension.
+T}
+.TE
+.KE
+.
+.
+.PP
+Enclose the footnote text in
+.CW FS
+and
+.CW FE
+macro calls to set it at the nearest available \lqfoot\rq,
+or bottom,
+of a text column or page.
+.
+.
+.TS
+box;
+cb cb
+lfCR lx .
+Macro	Description
+_
+\&.FS \fR\fImarker\f	T{
+Begin a footnote.
+.
+The
+.CW FS\-MARK
+hook
+(see below)
+is called with any supplied
+.I marker
+argument,
+which is then also placed at the beginning of the footnote text.
+.
+If
+.I marker
+is omitted,
+the next pending automatic number enqueued by interpolation of the
+.CW *
+string is used,
+and if none exists,
+nothing is prefixed.
+.
+T}
+_
+\&.FE	End footnote text.
+.TE
+.
+.
+.PP
+You may not desire automatically numbered footnotes in spite of their
+convenience.
+.
+You can indicate a footnote with a symbol or other text by specifying
+its marker at the appropriate place
+(for example,
+by using
+.CW \rsdg
+for the dagger glyph)
+.I and
+as an argument to the
+.CW FS
+macro.
+.
+Such manual marks should be repeated as arguments to
+.CW .FS
+or as part of the footnote text to disambiguate their correspondence.
+.
+You may wish to use
+.CW \rs*{
+and
+.CW \rs*}
+to superscript the marker at the anchor point,
+in the footnote text,
+or both.
+.
+.
+.PP
+.I "groff ms"
+provides a hook macro,
+.CW FS\-MARK ,
+for user-determined operations to be performed when the
+.CW FS
+macro is called.
+.
+It is passed the same arguments as
+.CW FS
+itself.
+.
+An application of
+.CW FS\-MARK
+is anchor placement for a hyperlink reference,
+so that a footnote can link back to its referential context.\**
+.
+.FS
+\lqPortable Document Format Publishing with GNU Troff\rq,
+.I pdfmark.ms
+in the
+.I groff
+distribution,
+uses this technique.
+.FE
+.
+By default,
+this macro has an empty definition.
+.
+.CW FS\-MARK
+is a GNU extension.
+.
+.
+.PP
+The following input was used to produce the first sentence in this
+section.
+.
+.
+.TS
+box center;
+lfCR.
+A footnote is anchored to a place in the text with a
+\&.I marker,
+which is a small integer,\rs**
+\&.FS
+like this numeric footnote
+\&.FE
+a symbol,\rs*{\rsdg\rs*}
+\&.FS \rsdg
+like this symbolic footnote
+\&.FE
+or arbitrary user-specified text.
+.TE
+.
+.
+.PP
+Footnotes can be safely used within keeps and displays,
+but you should avoid using automatically numbered footnotes within
+floating keeps.
+.
+You can place a second
+.CW \rs**
+interpolation between a
+.CW \rs**
+and its corresponding
+.CW .FS
+call as long as each
+.CW .FS
+call occurs
+.I after
+the corresponding
+.CW \rs**
+and occurrences of
+.CW .FS
+are in the same order as corresponding occurrences of
+.CW \rs** .
+.
+.
+.PP
+Footnote text is formatted as paragraphs are,
+using analogous parameters.
+.
+The registers
+.CW FI ,
+.CW FPD ,
+.CW FPS ,
+and
+.CW FVS
+correspond to
+.CW PI ,
+.CW PD ,
+.CW PS ,
+and
+.CW VS ,
+respectively;
+.CW FPD ,
+.CW FPS ,
+and
+.CW FVS
+are GNU extensions.
+.
+.
+.KS
+.PP
+The
+.CW FF
+register controls the formatting of automatically numbered footnote
+paragraphs,
+and those for which
+.CW .FS
+is given a
+.I marker
+argument,
+at the bottom of a column or page as follows.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+\fCBFF\f value	Description
+_
+0	T{
+Set an automatic number as a superscript
+(on typesetter devices)
+or surrounded by square brackets
+(on terminals).
+.
+The footnote paragraph is indented as with
+.CW .PP
+if there is an
+.CW .FS
+argument or an automatic number,
+and as with
+.CW .LP
+otherwise.
+.
+This is the default.
+T}
+1	T{
+As
+.CW 0 ,
+but set the marker as regular text,
+and follow an automatic number with a period.
+T}
+2	T{
+As
+.CW 1 ,
+but without indentation
+(like
+.CW .LP ).
+T}
+3	T{
+As
+.CW 1 ,
+but set the footnote paragraph with the marker hanging
+(like
+.CW .IP ).
+T}
+.TE
+.KE
+.
+.
+.PP
+The default footnote line length is 11/12ths of the normal line length
+for compatibility with the expectations of historical
+.I ms
+documents;
+you may wish to set
+.CW \rs*FR
+to
+.CW 1
+to align with contemporary typesetting practices.
+.
+In the past,\**
+.FS
+Unix
+Version\~7
+.I ms ,
+its descendants,
+and
+.I "groff ms"
+prior to version 1.23.0
+.FE
+an
+.CW FL
+register was used for the line length in footnotes;
+however,
+setting this register at document initialization time had no effect on
+the footnote line length in multi-column arrangements.\**
+.
+.FS
+You could reset it after each call to
+.CW .1C ,
+.CW .2C ,
+or
+.CW .MC .
+.FE
+.
+.
+.PP
+.CW \rs*FR
+should be used in preference to
+.CW \rsnFL
+in contemporary documents.
+.
+The footnote line length is effectively computed as
+.I column-width "" \lq
+.CW "\~*\~\rs*FR" \rq.
+.
+If an absolute footnote line length is required,
+recall that arithmetic expressions in the
+.I roff
+language are evaluated strictly from left to right,
+with no operator precedence
+(parentheses are honored).
+.
+.
+.TS
+box center;
+lf(CR).
+\&.ds FR 0+3i \rs" Set footnote line length to 3 inches.
+.TE
+.
+.
+.LP \" continuing previous paragraph
+Changes to the footnote length ratio
+.CW \rs*FR
+take effect with the next footnote written in single-column
+arrangements,
+but on the next page in multiple-column contexts.
+.
+.
+.KS
+.NH 2
+Language and localization
+.XS
+	Language and localization
+.XE
+.
+.
+.LP
+.I "groff ms"
+provides several strings that you can customize for your own purposes,
+or redefine to adapt the macro package to languages other than English.
+.
+It is already localized for
+.\" cs, de, fr, it, sv
+Czech,
+German,
+French,
+Italian,
+and
+Swedish.
+.
+Load the desired localization macro package after
+.I ms ;
+see the
+.I groff_tmac (5)
+man page.
+.
+.
+.TS
+box center;
+lf(CR).
+$ \fCBgroff \-ms \-mfr bienvenue.ms
+.TE
+.
+.
+.PP
+The following strings are available.
+.
+.TS
+box center;
+cb lb
+lf(CR) lf(CR) .
+String	Default
+_
+\rs*REFERENCES	References
+\rs*ABSTRACT	\rsfIABSTRACT\rsf
+\rs*TOC	Table of Contents
+\rs*MONTH1	January
+\rs*MONTH2	February
+\rs*MONTH3	March
+\rs*MONTH4	April
+\rs*MONTH5	May
+\rs*MONTH6	June
+\rs*MONTH7	July
+\rs*MONTH8	August
+\rs*MONTH9	September
+\rs*MONTH10	October
+\rs*MONTH11	November
+\rs*MONTH12	December
+.TE
+.
+.
+.PP
+The default for
+.CW \rs*ABSTRACT
+includes font selection escape sequences to set the word in italics.
+.KE
+.
+.
+.KS
+.NH 2
+Glyphs for special characters
+.XS
+	Glyphs for special characters
+.XE
+.
+.
+.LP
+Some of the special character escape sequences used in this document
+are listed below.
+.
+The minus sign glyph can also be accessed by the shorthand
+.CW \rs\mi .
+.
+These and many others are documented in the
+.I groff_char (7)
+man page.
+.
+.
+.TS
+box center;
+Cb Lb Lb
+Lf(CR) L L .
+Input	Appearance	Description
+_
+\rs\-	\mi	minus sign
+\rs\->	\->	right arrow
+\rsaq	\aq	neutral apostrophe
+\rsbu	\bu	bullet
+\rsdq	\dq	neutral double quote
+\rsdg	\dg	dagger
+\rsem	\em	em dash
+\rsha	\ha	circumflex accent (caret, hat)
+\rslg	\lq	left double quotation mark
+\rsrq	\rq	right double quotation mark
+\rsrs	\rs	reverse solidus (backslash)
+\rssd	\sd	seconds (double prime) mark
+\rsti	\ti	tilde
+.TE
+.KE
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Page layout
+.XS
+Page layout
+.XE
+.LP
+.I ms 's
+default page layout arranges text
+in a single column
+with the page number
+between hyphens
+centered in a header
+on each page
+except the first,
+and produces no footers.
+.
+You can customize this arrangement.
+.
+.
+.NH 2
+Headers and footers
+.XS
+	Headers and footers
+.XE
+.
+.
+.LP
+There are multiple ways to produce headers and footers.
+.
+One is to define the strings
+.CW LH ,
+.CW CH ,
+and
+.CW RH
+to set the left,
+center,
+and right headers,
+respectively;
+and
+.CW LF ,
+.CW CF ,
+and
+.CW RF
+to set the left,
+center,
+and right footers.
+.
+This approach suffices for documents that do not distinguish odd- and
+even-numbered pages.
+.
+.
+.PP
+Another method is to call macros that set headers or footers for odd- or
+even-numbered pages.
+.
+Each such macro takes a delimited argument separating the left,
+center,
+and right header or footer texts from each other.
+.
+You can replace the neutral apostrophes (\aq) shown below with any
+character not appearing in the header or footer text.
+.
+These macros are Berkeley extensions.
+.
+.
+.TS
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+\&.OH \aq\fIleft\f\aq\fIcenter\f\aq\fIright\f\aq\
+	T{
+Set the left, center, and right headers on odd-numbered (recto) pages.
+T}
+\&.OF \aq\fIleft\f\aq\fIcenter\f\aq\fIright\f\aq\
+	T{
+Set the left, center, and right footers on odd-numbered (recto) pages.
+T}
+\&.EH \aq\fIleft\f\aq\fIcenter\f\aq\fIright\f\aq\
+	T{
+Set the left, center, and right headers on even-numbered (verso) pages.
+T}
+\&.EF \aq\fIleft\f\aq\fIcenter\f\aq\fIright\f\aq\
+	T{
+Set the left, center, and right footers on even-numbered (verso) pages.
+T}
+.TE
+.
+.
+.PP
+With either method,
+a percent sign
+.B %
+in header or footer text is replaced by the current page number.
+.
+By default,
+.I ms
+places no header on a page numbered \lq1\rq
+(regardless of its number format).
+.
+.
+.TS
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+\&.P1	T{
+Typeset the header even on page\~1.
+.
+To be effective,
+this macro must be called before the header trap is sprung on any page
+numbered \lq1\rq;
+in practice,
+unless your page numbering is unusual,
+this means that you should call it early,
+before
+.CW .TL
+or any heading or paragraphing macro.
+.
+This is a Berkeley extension.
+T}
+.TE
+.
+.
+.PP
+For even greater flexibility,
+.I ms
+is designed to permit the redefinition of the macros that are called
+when the
+.I groff
+traps that ordinarily cause the headers and footers to be output are
+sprung.
+.
+.CW PT
+(\lqpage trap\rq)
+is called by
+.I ms
+when the header is to be written,
+and
+.CW BT
+(\lqbottom trap\rq)
+when the footer is to be.
+.
+The
+.I groff
+page location trap that
+.I ms
+sets up to format the header also calls the
+(normally undefined)
+.CW HD
+macro after
+.CW .PT ;
+you can define
+.CW .HD
+if you need additional processing after setting the header
+(for example,
+to draw a line below it).
+.
+.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+The
+.CW HD
+hook is a Berkeley extension.
+.
+Any such macros you (re)define must implement any desired specialization
+for odd-,
+even-,
+or first numbered pages.
+.
+.
+.KS
+.NH 2
+Tab stops
+.XS
+	Tab stops
+.XE
+.
+.
+.LP
+Use the
+.CW ta
+request to set tab stops as needed.
+.
+.
+.TS
+box;
+lb lb
+lf(CR) lx.
+Macro	Description
+_
+\&.TA	T{
+Reset the tab stops to the
+.I ms
+default
+(every 5 ens).
+.
+Redefine this macro to create a different set of default tab stops.
+T}
+.TE
+.KE
+.
+.
+.KS
+.NH 2
+Margins
+.XS
+	Margins
+.XE
+.
+.
+.LP
+Control margins using the registers summarized in the \lqMargins\rq
+portion of the table in section \lqDocument control settings\rq
+above.
+.
+There is no setting for the right margin;
+the combination of page offset
+.CW \rsnPO
+and line length
+.CW \rsnLL
+determines it.
+.KE
+.
+.
+.KS
+.NH 2
+Multiple columns
+.XS
+	Multiple columns
+.XE
+.
+.
+.LP
+.I ms
+can set text in as many columns as reasonably fit on the page.
+.
+The following macros force a page break if a multi-column layout is
+active when they are called.
+.
+.CW \rsnMINGW
+is the default minimum gutter width;
+it is a GNU extension.
+.
+When multiple columns are in use,
+keeps
+and the
+.CW \%HORPHANS
+and
+.CW \%PORPHANS
+registers
+work with respect to column breaks instead of page breaks.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.1C	T{
+Arrange page text in a single column (the default).
+T}
+_
+\&.2C	T{
+Arrange page text in two columns.
+T}
+_
+\&.MC \fR\fIcolumn-width\f \fIgutter-width\f	T{
+Arrange page text in multiple columns.
+.
+If you specify no arguments,
+it is equivalent to the
+.CW 2C
+macro.
+.
+Otherwise,
+.I column-width
+is the width of each column and
+.I gutter-width
+is the minimum distance between columns.
+T}
+.TE
+.KE
+.
+.
+.\" ------------------------
+.NH 2
+Creating a table of contents
+.XS
+	Creating a table of contents
+.XE
+.LP
+Because
+.I roff
+formatters process their input in a single pass,
+material on page 50,
+for example,
+cannot influence what appears on page\~1\emthis poses a challenge for
+a table of contents at its traditional location in front matter,
+if you wish to avoid manually maintaining it.
+.
+.I ms
+enables the collection of material to be presented in the table of
+contents as it appears,
+saving its page number along with it,
+and then emitting the collected contents on demand toward the end of the
+document.
+.
+The table of contents can then be resequenced to its desired location
+by physically rearranging the pages of a printed document,
+or as part of post-processing\emwith a
+.I sed (1)
+script to reorder the pages in
+.I troff 's
+output,
+with
+.I pdfjam (1),
+or with
+.I gropdf (1)'s
+.B .pdfswitchtopage
+feature,
+for example.
+.
+.
+.PP
+Define an entry to appear in the table of contents by bracketing its
+text between calls to the
+.CW XS
+and
+.CW XE
+macros.
+.
+A typical application is to call them immediately after
+.CW NH
+or
+.CW SH
+and repeat the heading text within them.
+.
+The
+.CW XA
+macro,
+used within
+.CW .XS /\c
+.CW .XE
+pairs,
+supplements an entry\emfor instance,
+when it requires multiple output lines,
+whether because a heading is too long to fit or because style dictates
+that page numbers not be repeated.
+.
+You may wish to indent the text thus wrapped to correspond to its
+heading depth;
+this can be done in the entry text by prefixing it with tabs or
+horizontal motion escape sequences,
+or by providing a second argument to the
+.CW XA
+macro.
+.
+.CW .XS
+and
+.CW .XA
+automatically associate the page number where they are called with the
+text following them,
+but they accept arguments to override this behavior.
+.
+At the end of the document,
+call
+.CW TC
+or
+.CW PX
+to emit the table of contents;
+.CW .TC
+resets the page number
+.B i "" to\~
+(Roman numeral one),
+and then calls
+.CW PX .
+.
+All of these macros are Berkeley extensions.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.XS \fR\fIpage-number\f	T{
+Begin,
+supplement,
+and end a table of contents entry.
+.
+Each entry is associated with
+.I page-number
+(otherwise the current page number);
+a
+.I page-number
+of
+.CW no
+prevents a leader and page number from being emitted for that entry.
+.
+Use of
+.CW .XA
+within
+.CW .XS /\c
+.CW .XE
+is optional;
+it can be repeated.
+.
+If
+.I indentation
+is present,
+a supplemental entry is indented by that amount;
+ens are assumed if no unit is indicated.
+.
+Text on input lines between
+.CW .XS
+and
+.CW .XE
+is stored for later recall by
+.CW .PX .
+T}
+\&.XA \fR\fIpage-number\f \fIindentation\f	\^
+\&.XE	\^
+_
+\&.PX \fR\fno\fR	T{
+Switch to single-column layout.
+.
+Unless
+.CW no
+is specified,
+center and interpolate
+.CW \rs*TOC
+in bold and two points larger than the body text.
+.
+Emit the table of contents entries.
+T}
+_
+\&.TC \fR\fno\fR	T{
+Set the page number to\~1,
+the page number format to lowercase Roman numerals,
+and call
+.CW PX
+(with a
+.CW no
+argument,
+if present).
+T}
+.TE
+.
+.
+.KS
+.PP
+Here's an example of typical
+.I ms
+table of contents preparation and
+its result.
+.
+We employ horizontal escape sequences
+.CW \rsh
+to indent the entries by sectioning depth.
+.
+.TS
+box center;
+L.
+T{
+.nf
+.CW
+\&.NH 1
+Introduction
+\&.XS
+Introduction
+\&.XE
+.R
+\&.\|.\|.
+.CW
+\&.NH 2
+Methodology
+\&.XS
+\rsh\aq2n\aqMethodology
+\&.XA no
+\rsh\aq4n\aqFassbinder\aqs Approach
+\&.XA no
+\rsh\aq4n\aqKahiu\aqs Approach
+\&.XE
+.R
+\&.\|.\|.
+.CW
+\&.NH 1
+Findings
+\&.XS
+Findings
+\&.XE
+.R
+\&.\|.\|.
+.CW
+\&.TC
+.fi
+T}
+.TE
+.KE
+.
+.nr SavedPageNumber \n%
+.nr SavedH1 \nH1 \" groff ms internal name
+.nr SavedH2 \nH2 \" groff ms internal name
+.nr % 1
+.rr H1
+.rr H2
+.als SavedTOC toc*div \" groff ms internal name
+.rm toc*div
+.di ThrowAway
+.NH 1
+Introduction
+.XS
+Introduction
+.XE
+.nr % 2
+.NH 2
+Methodology
+.XS
+\h'2n'Methodology
+.XA no
+\h'4n'Fassbinder's Approach
+.XA no
+\h'4n'Kahiu's Approach
+.XE
+.nr % 5
+.NH 1
+Findings
+.XS
+Findings
+.XE
+.br
+.di
+.\" We can't emit the TOC inside a B1/B2 box, so use lines instead.
+.R
+\l'\n.lu'
+.PX
+\l'\n.lu'
+.als toc*div SavedTOC
+.rm SavedTOC
+.nr % \nSavedPageNumber
+.nr H1 \nSavedH1
+.nr H2 \nSavedH2
+.rr SavedPageNumber
+.rr SavedH1
+.rr SavedH2
+.
+.
+.PP
+The remaining features in this subsection are GNU extensions.
+.
+.I "groff ms"
+obviates the need to repeat heading text after
+.CW XS
+calls.
+.
+Call
+.CW XN
+and
+.CW XH
+after
+.CW NH
+and
+.CW SH ,
+respectively.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.XN \fIheading-text	T{
+Format
+.I heading-text
+and create a corresponding table of contents entry;
+the indentation is computed from the depth of the preceding
+.CW NH
+call.
+T}
+\&.XH \fIdepth heading-text	T{
+As
+.CW .XN ,
+but use
+.I depth
+to determine the indentation.
+T}
+.TE
+.
+.
+.KS
+.PP
+.I "groff ms"
+encourages customization of table of contents entry production.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.XN\-REPLACEMENT \fIheading-text	T{
+These hook macros implement
+.CW .XN
+and
+.CW .XH ,
+respectively.
+.
+They call
+.CW \%XN\-INIT
+and
+pass their
+.I heading-text
+arguments to
+.CW .\%XH\-UPDATE\-TOC .
+T}
+\&.XH\-REPLACEMENT \fIdepth heading-text	\^
+\&.XH\-INIT	T{
+This hook macro does nothing by default.
+T}
+\&.XH\-UPDATE\-TOC\~ \fIdepth heading-text	T{
+Bracket
+.I heading-text
+with
+.CW XS
+and
+.CW XE
+calls,
+indenting it by 2 ens per level of
+.I depth
+beyond the first.
+T}
+.TE
+.KE
+.
+.
+.LP
+.TS
+box center;
+L.
+T{
+.nf
+.CW
+\&.NH 1
+\&.XN Introduction
+.R
+\&.\|.\|.
+.CW
+\&.NH 2
+\&.XN Methodology
+\&.XH 3 \dqFassbinder\aqs Approach\dq
+\&.XH 3 \dqKahiu\aqs Approach\dq
+.R
+\&.\|.\|.
+.CW
+\&.NH 1
+\&.XN Findings
+.R
+\&.\|.\|.
+.CW
+\&.TC
+.fi
+T}
+.TE
+.
+.nr SavedPageNumber \n%
+.nr SavedH1 \nH1 \" groff ms internal name
+.nr SavedH2 \nH2 \" groff ms internal name
+.nr % 1
+.rr H1
+.rr H2
+.als SavedTOC toc*div \" groff ms internal name
+.rm toc*div
+.di ThrowAway
+.NH 1
+.XN Introduction
+.nr % 2
+.NH 2
+.XN Methodology
+.XH 3 "Fassbinder's Approach"
+.XH 3 "Kahiu's Approach"
+.nr % 5
+.NH 1
+.XN Findings
+.br
+.di
+.\" We can't emit the TOC inside a B1/B2 box, so use lines instead.
+.R
+\l'\n.lu'
+.PX
+\l'\n.lu'
+.als toc*div SavedTOC
+.rm SavedTOC
+.nr % \nSavedPageNumber
+.nr H1 \nSavedH1
+.nr H2 \nSavedH2
+.rr SavedPageNumber
+.rr SavedH1
+.rr SavedH2
+.
+.
+.PP
+To get the section number of the numbered headings into the table of
+contents entries,
+we might define
+.CW \%XN\-REPLACEMENT
+as follows.
+.
+(We obtain the heading depth from
+.I "groff ms" 's
+internal register
+.CW nh*hl .)
+.
+.
+.LP
+.TS
+box center;
+L.
+T{
+.nf
+.CW
+\&.de XN\-REPLACEMENT
+\&.XN\-INIT
+\&.XH\-UPDATE\-TOC \rs\rsnnh*hl \rs\rs$@
+\&\rs&\rs\rs*SN \rs\rs$*
+\&..
+T}
+.TE
+.
+.
+.PP
+You can change the style of the leader that bridges each table of
+contents entry with its page number;
+define the
+.CW TC\-LEADER
+special character by using the
+.CW char
+request.
+.
+A typical leader combines the dot glyph
+.CW .\& \rq \lq
+with a horizontal motion escape sequence to spread the dots.
+.
+The width of the page number field is stored in the
+.CW TC\-MARGIN
+register.
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Differences from AT&T
+.BI ms
+.XS
+Differences from AT&T
+.I ms
+.XE
+.LP
+The
+.I "groff ms"
+macros are an independent reimplementation,
+using no AT&T code.
+.
+Since they take advantage of the extended features of
+.I groff ,
+they cannot be used with AT&T
+.I troff .
+.
+.I "groff ms"
+supports features described above as Berkeley and Tenth Edition Research
+Unix extensions,
+and adds several of its own.
+.
+.
+.PP
+The internals of
+.I "groff ms"
+differ from those of AT&T
+.I ms .
+.
+Documents that depend upon implementation details of AT&T
+.I ms
+may not format properly with
+.I "groff ms" .
+.
+Such details include macros whose function was not documented in the
+AT&T
+.I ms
+manual Lesk 1978.
+.\" TODO: Use refer(1).
+.\" XXX: We support RT anyway; maybe we should stop?
+.
+.
+.PP
+The error-handling policy of
+.I "groff ms"
+is to detect and report errors,
+rather than to ignore them silently.
+.
+.
+.PP
+Tenth Edition \" possibly 9th
+Research Unix supported
+.B P1 /
+.B P2
+macros to bracket code examples;
+.I "groff ms"
+does not.
+.
+.
+.PP
+.I "groff ms"
+does not work in GNU
+.I troff 's \" GNU
+AT&T compatibility mode.
+.
+If loaded when that mode is enabled,
+it aborts processing with a diagnostic message.
+.
+.
+.PP
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
+.
+.
+.PP
+.I "groff ms"
+uses the same header and footer defaults in both
+.CW nroff
+and
+.CW troff
+modes
+as AT&T
+.I ms
+does in
+.CW troff
+mode;
+AT&T's default in
+.CW nroff
+mode is to put the date,
+in U.S.\& traditional format
+(e.g.,
+\lqJanuary 1, 2021\rq),
+in the center footer
+(the
+.CW CF
+string).
+.
+.
+.PP
+Many
+.I "groff ms"
+macros,
+including those for paragraphs,
+headings,
+and displays,
+cause a reset of formatting parameters,
+and may change the indentation;
+they do so not by incrementing or decrementing it,
+but by setting it absolutely.
+.
+This can cause problems for documents that define additional macros of
+their own that try to manipulate indentation.
+.
+Use
+.CW .RS
+and
+.CW .RE
+instead of the
+.CW in
+request.
+.
+.
+.PP
+AT&T
+.I ms
+interpreted the values of the registers
+.CW PS
+and
+.CW VS
+in points,
+and did not support the use of scaling units with them.
+.
+.I "groff ms"
+interprets values of the registers
+.CW PS ,
+.CW VS ,
+.CW FPS ,
+and
+.CW FVS
+equal to or larger than\~1,000
+(one thousand)
+as decimal fractions multiplied by\~1,000.\**
+.FS
+Register values are converted to and stored as basic units.
+.
+See \lqMeasurements\rq in the
+.I groff
+Texinfo manual or in
+.I groff (7).
+.FE
+.
+This threshold makes use of a scaling unit with these parameters
+practical for high-resolution devices while preserving backward
+compatibility.
+.
+It also permits expression of non-integral type sizes.
+.
+For example,
+.CW "groff \-rPS=10.5p" \rq \lq
+at the shell prompt is equivalent to placing
+.CW ".nr PS 10.5p" \rq \lq
+at the beginning of the document.
+.
+.
+.PP
+AT&T
+.I ms 's
+.CW AU
+macro supported arguments used with some document types;
+.I "groff ms"
+does not.
+.
+.
+.PP
+Right-aligned displays are available.
+.
+The AT&T
+.I ms
+manual observes that \lqit is tempting to assume that
+.CW ".DS R"
+will right adjust lines,
+but it doesn't work\rq.
+.
+In
+.I "groff ms" ,
+it does.
+.
+.
+.PP
+To make
+.I "groff ms"
+use the default page offset
+(which also specifies the left margin),
+the
+.B PO
+register must stay undefined until the first
+.I ms
+macro is called.
+.
+This implies that
+.B \rsnPO
+should not be used early in the document,
+unless it is changed also:
+accessing an undefined register automatically defines it.
+.
+.
+.PP
+.I "groff ms"
+supports the
+.CW PN
+register,
+but it is not necessary;
+you can access the page number via the usual
+.CW %
+register and invoke the
+.CW af
+request to assign a different format to it if desired.\**
+.FS
+If you redefine the
+.I ms
+.CW PT
+macro \" I wouldn't mention that, but Lesk 1978 encourages doing so. :-/
+and desire special treatment of certain page numbers
+(like
+.CW 1 \rq), \lq
+you may need to handle a non-Arabic page number format,
+as
+.I "groff ms" 's
+.CW .PT
+does;
+see the macro package source.
+.
+.I "groff ms"
+aliases the
+.CW PN
+register to
+.CW % .
+.FE
+.
+.
+.PP
+The AT&T
+.I ms
+manual documents registers
+.CW CW
+and
+.CW GW
+as setting the default column width and \lqintercolumn gap\rq,
+respectively,
+and which applied when
+.CW .MC
+was called with fewer than two arguments.
+.
+.I "groff ms"
+instead treats
+.CW .MC
+without arguments as synonymous with
+.CW .2C ;
+there is thus no occasion for a default column width register.
+.
+Further,
+the
+.CW MINGW
+register
+and the second argument to
+.CW .MC
+specify a
+.I minimum
+space between columns,
+not the fixed gutter width of AT&T
+.I ms .
+.
+.
+.PP
+The AT&T
+.I ms
+manual did not document the
+.CW QI
+register;
+Berkeley and
+.I "groff ms"
+do.
+.
+.
+.PP
+The register
+.CW GS
+is set to\~1 by the
+.I "groff ms"
+macros,
+but is not used by the AT&T
+.I ms
+package.
+.
+Documents that need to determine whether they are being formatted with
+.I "groff ms"
+or another implementation should test this register.
+.
+.
+.\" XXX: We can't use a keep here because the wrong page number will be
+.\" recorded in the table of contents; see Savannah #63159.
+.\"KS
+.br
+.ne 6v
+.NH 2
+Unix Version\~7
+.BI ms
+macros not implemented by
+.BI "groff ms"
+.XS
+	Unix Version 7
+.I ms
+macros not implemented by
+.I "groff ms"
+.XE
+.LP
+Several macros described in the Unix Version\~7
+.I ms
+documentation are unimplemented by
+.I "groff ms"
+because they are specific to the requirements of documents produced
+internally by Bell Laboratories,
+some of which also require a glyph for the Bell System logo that
+.I groff
+does not support.
+.
+These macros implemented several document type formats
+(\c
+.CW EG , \" engineer's notes
+.CW IM , \" internal memorandum
+.CW MF , \" memorandum for file
+.CW MR , \" memorandum for record
+.CW TM , \" technical memorandum
+.CW TR ), \" technical report
+were meaningful only in conjunction with the use of certain document
+types
+(\c
+.CW AT , \" attachments
+.CW CS , \" cover sheet info for `TM` documents
+.CW CT , \" copies to
+.CW OK , \" "other keywords" for `TM` documents
+.CW SG ), \" signatures for `TM` documents
+stored the postal addresses of Bell Labs sites
+(\c
+.CW HO , \" Holmdel
+.CW IH , \" Naperville
+.CW MH , \" Murray Hill
+.CW PY , \" Piscataway
+.CW WH ), \" Whippany
+or lacked a stable definition over time
+(\c
+.CW UX ). \" Unix; on 1st use, add footnote identifying trademark owner
+.
+To compatibly render historical
+.I ms
+documents using these macros,
+we advise your documents to invoke the
+.CW rm
+request to remove any such macros it uses and then define replacements
+with an authentically typeset original at hand.\**
+.FS
+The removal beforehand is necessary because
+.I "groff ms"
+aliases these macros to a diagnostic macro,
+and you want to redefine the aliased name,
+not its target.
+.FE
+.
+For informal purposes,
+a simple definition of
+.CW UX
+should maintain the readability of the document's substance.
+.
+.
+.TS
+box center;
+lf(CR).
+\&.rm UX
+\&.ds UX Unix\rs"
+.TE
+.rs \" XXX: Work around Savannah #64005.
+.\"KE
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Legacy features
+.XS
+Legacy features
+.XE
+.
+.
+.LP
+.I "groff ms"
+retains some legacy features solely to support formatting of historical
+documents;
+contemporary ones should not use them because they can render poorly.
+.
+See
+.I groff_char (7)
+instead.
+.
+.
+.KS
+.NH 2
+AT&T
+.I ms
+accent mark strings
+.XS
+	AT&T
+.I ms
+accent mark strings
+.XE
+.LP
+AT&T
+.I ms
+defined
+accent mark strings as follows.
+.
+.
+.TS
+box center;
+Cb Lb
+Lf(CR) Lx.
+String	Description
+_
+\rs*\aq	Apply acute accent to subsequent glyph.
+\rs*\ga	Apply grave accent to subsequent glyph.
+\rs*:	Apply dieresis (umlaut) to subsequent glyph.
+\rs*\ha	Apply circumflex accent to subsequent glyph.
+\rs*\ti	Apply tilde accent to subsequent glyph.
+\rs*C	Apply caron to subsequent glyph.
+.\" \*v was an undocumented (in Lesk 1978-11-13) synonym for \*C.
+\rs*,	Apply cedilla to subsequent glyph.
+.TE
+.KE
+.
+.
+.NH 2
+Berkeley
+.I ms
+accent mark and glyph strings
+.XS
+	Berkeley
+.I ms
+accent mark and glyph strings
+.XE
+.LP
+Berkeley
+.I ms
+offered an
+.CW AM
+macro;
+calling it redefined the AT&T accent mark strings
+(except for
+.CW \rs*C ),
+applied them to the
+.I preceding
+glyph,
+and defined additional strings,
+some for spacing glyphs.
+.
+.
+.TS
+box;
+cb cb
+lf(CR) lx .
+Macro	Description
+_
+\&.AM	Enable alternative accent mark and glyph-producing strings.
+.TE
+.
+.
+.TS
+box center;
+Cb Lb
+Lf(CR) Lx.
+String	Description
+_
+\rs*\aq	Apply acute accent to preceding glyph.
+\rs*\ga	Apply grave accent to preceding glyph.
+\rs*:	Apply dieresis (umlaut) to preceding glyph.
+\rs*\ha	Apply circumflex accent to preceding glyph.
+\rs*\ti	Apply tilde accent to preceding glyph.
+\rs*,	Apply cedilla to preceding glyph.
+\rs*/	Apply stroke (slash) to preceding glyph.
+\rs*v	Apply caron to preceding glyph.
+\rs*_	Apply macron to preceding glyph.
+\rs*.	Apply underdot to preceding glyph.
+\rs*o	Apply ring accent to preceding glyph.
+_
+\rs*?	Interpolate inverted question mark.
+\rs*!	Interpolate inverted exclamation mark.
+\rs*8	Interpolate small letter sharp s.
+\rs*q	Interpolate small letter o with hook accent (ogonek).
+\rs*3	Interpolate small letter yogh.
+\rs*d-	Interpolate small letter eth.
+\rs*D-	Interpolate capital letter eth.
+\rs*th	Interpolate small letter thorn.
+\rs*TH	Interpolate capital letter thorn.
+\rs*ae	Interpolate small ae ligature.
+\rs*AE	Interpolate capital ae ligature.
+\rs*oe	Interpolate small oe ligature.
+\rs*OE	Interpolate capital oe ligature.
+.TE
+.rs \" XXX: Work around Savannah #64005.
+.
+.
+.\" ------------------------
+.if t \{\
+.  br
+.  bp
+.\}
+.NH 1
+Further reading
+.XS
+Further reading
+.XE
+.
+.
+.XP
+\lqTyping Documents on the Unix System:
+Using the \-ms Macros with Troff and Nroff\rq;
+M.\& E.\& Lesk;
+November 13, 1978.
+.
+This document describes the
+.I ms
+supplied with AT&T Unix Version\~7.
+.
+.
+.XP
+\lqA Revised Version of \-ms\rq;
+Bill Tuthill;
+August 1983.
+.
+The 4.2BSD release featured several extensions to
+.I ms ,
+most of which are recreated in
+.I "groff ms" .
+.
+(The exceptions are the
+.CW TM
+and
+.CW CT
+macros for setting a doctoral thesis in the format required by the
+contemporaneous degree-granting authorities of the University of
+California at Berkeley.)
+.
+.
+.XP
+\lqUsing PDF boxes with
+.I groff
+and the
+.I ms
+macros\rq;
+Deri James;
+March 2021.
+.
+.CW BOXSTART
+and
+.CW BOXSTOP
+macros are available via the
+.I sboxes
+extension package,
+enabling colored,
+bordered boxes when the
+.CW pdf
+output device is used.
+.
+This document is distributed with
+.I groff
+as the file
+.I msboxes.pdf .
+.
+.
+.LP
+This manual was composed using
+.I "groff ms" ;
+the curious may consult its source in the file
+.I ms.ms
+to see how its formatting was achieved.
+.\" ------------------------
+.TC
+.
+.
+.\" Local Variables:
+.\" fill-column: 72
+.\" mode: nroff
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/doc/pic.ms -> _service:tar_scm:groff-1.23.0.tar.gz/doc/pic.ms Changed

@@ -1,4 +1,4 @@
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2020 Free Software Foundation, Inc.
 .\"      Written by Eric S. Raymond <esr@thyrsus.com>
 .\"
 .\" This file is part of groff.
@@ -144,23 +144,40 @@
 package and elsewhere have also the side-effect of centering the
 \fBpic\fP output on the page.
 .
+.KS
 .NH 2
 PIC Error Messages
 .PP
-If you make a \fBpic\fP syntax error, \fIgpic\/\fP(1) issues an
-error message in the standard \fIgcc\/\fP(1)-like syntax.
-A typical error message looks like this
-.KS
+If you make a mistake in \fBpic\fP input such that the program cannot
+interpret what you mean,
+\fIgpic\/\fP(1) issues a diagnostic message in the format prescribed by
+the GNU Coding Standards.
+.
+A typical error message looks like
+.
+.
+.ds FAM C
 .DS
-.CW
-pic:pic.ms:<nnn>: parse error before `<token>'
-pic:pic.ms:<nnn>: giving up on this picture
+pic:\fIfile\fP:\fInnn\fP: syntax error before \aq\fItoken\fP\aq
+pic:\fIfile\fP:\fInnn\fP: giving up on this picture
 .DE
-.R
-.KE
+.ds FAM T
+.
+.
 .LP
-where \lannn\ra is a line number, and \latoken\ra is a token near (usually
-just after) the error location.
+where
+.I file
+is the name of the file being processed,
+.I nnn
+is a line number within that file,
+and
+.I token
+is a symbol in the \fBpic\fP language
+(often a keyword)
+near
+(usually just after)
+the error location.
+.KE
 .
 .
 .NH 1
@@ -213,7 +230,8 @@
 boxes.
 We see how to declare text lines to go within an object (and that text
 can have font changes in it).
-We see how to change the line style of an object from solid to dashed.
+We see how to change the line style of an object from solid (the
+default) to dashed.
 And we see that a box can be made wider than its default size to
 accommodate more text (we'll discuss this facility in detail in the next
 section).
@@ -329,7 +347,7 @@
 .PS
 arc; move; "arc";
 .PE
-.CE "5: Result of \fBarc; move; \"arc\"\fP"
+.CE "5: Result of \fBarc; move; ""arc""\fP"
 .PP
 This is because drawing an arc changes the default direction to the
 one its exit end points at.
@@ -338,7 +356,7 @@
 .PS
 arc cw; move; "arc";
 .PE
-.CE "6: Result of \fBarc cw; move; \"arc\"\fP"
+.CE "6: Result of \fBarc cw; move; ""arc""\fP"
 .PP
 All we've done differently here is specify \lqcw\rq for a clockwise arc
 (\lqccw\rq specifies counter-clockwise direction).
@@ -442,7 +460,7 @@
 .PS
 box width 3 "this text is far too long for a default box"
 .PE
-.CE "2: Result of \fBbox width 3 \"text far too long\"\fP"
+.CE "2: Result of \fBbox width 3 ""text far too long""\fP"
 .PP
 This modifier takes a dimension in inches.
 There is also a \lqheight\rq modifier that changes a box's height.
@@ -619,13 +637,13 @@
 .PP
 All \fBpic\fP implementations support the following font-styling
 escapes within text objects:
-.IP "\efR, \ef1"
+.IP "\efR, \ef1" \w'\efR,\~\ef3'u+2n
 Set Roman style (the default)
 .IP "\efI, \ef2"
 Set Italic style
 .IP "\efB, \ef3"
 Set Bold style
-.IP "\efP\ \ \ \ \ \ "
+.IP \efP
 Revert to previous style; only works one level deep, does not stack.
 .PP
 In the \fBpic\fP implementations that are preprocessors for a
@@ -824,10 +842,6 @@
 The invisible attribute does not affect the filling of objects.
 Any text associated with a filled object is added after the object has
 been filled, so that the text is not obscured by the filling.
-.PP
-The closed-object modifier \fBsolid\fP is equivalent to \fBfill\fP
-with the darkest fill value (DWB \fBpic\fP had this capability but
-mentioned it only in a reference section).
 .
 .NH 2
 Colored Objects
@@ -990,7 +1004,8 @@
 attachment point for an
 object to be joined to the right.
 .PP
-The meaning of the command \fBmove to last circle .s\fP should be obvious.
+The meaning of the command \fBmove to last circle \&.s\fP should be
+obvious.
 In order to see how it generalizes, we'll need to go into detail on two
 important topics; locations and object names.
 .
@@ -1179,7 +1194,7 @@
 .LP
 these are the locations where eight compass rays from the geometric center
 would intersect the figure.
-So when we say \fBlast circle .s\fP we are referring to the south
+So when we say \fBlast circle \&.s\fP we are referring to the south
 compass point of the last circle drawn.
 The explanation of Figure 8-3's program is now complete.
 .PP
@@ -1243,7 +1258,7 @@
 more precise, you can only add a position and an expression pair; the
 latter must be on the right side of the addition or subtraction sign).
 The result is the conventional vector sum or difference of coordinates.
-For example, \fBlast box .ne + (0.1, 0)\fP is a valid position.
+For example, \fBlast box \&.ne + (0.1, 0)\fP is a valid position.
 This example illustrates a common use, to define a position slightly
 offset from a named one (say, for captioning purposes).
 .NH 3
@@ -1422,9 +1437,9 @@
 \fBcirclerad\fR.
 By suffixing it with a number you can change the amount of chopping.
 .PP
-If you say \fBline .\|.\|.\& chop \fIr1\fP chop \fIr2\fP\fR with \fIr1\fP
-and \fIr2\fP both numbers, you can vary the amount of chopping at both
-ends.
+If you say \fBline \&.\|.\|.\& chop \fIr1\fP chop \fIr2\fP\fR with
+\fIr1\fP and \fIr2\fP both numbers, you can vary the amount of chopping
+at both ends.
 You can use this in combination with trigonometric functions to write
 code that deals with more complex intersections.
 .
@@ -1489,9 +1504,9 @@
 .CE "1: A sample composite object"
 .LP
 To refer to one of the composite's attachment points, you can say
-(for example) \fBA .s\fP.
+(for example) \fBA \&.s\fP.
 For purposes of object naming, composites are a class.
-You could write \fBlast  .s\fP as an equivalent reference, usable
+You could write \fBlast  \&.s\fP as an equivalent reference, usable
 anywhere a location is needed.
 This construction is very important for putting together large,
 multi-part diagrams.
@@ -1722,7 +1737,8 @@
 version.
 .PP
 The function \fBsprintf()\fP behaves like a C \fIsprintf\/\fP(3)
-function that only takes %, %e, %f, and %g format strings.
+function that only takes %%, %e, %E, %f, %g, and %G conversion
+specifications.
 .
 .
 .NH 1
@@ -1851,9 +1867,9 @@
 .PP
 One detail the example above does not illustrate is the fact that
 macro argument parsing is not token-oriented.
-If you call \fBjumper(\ 1\ )\fP, the value of $1 is \fB"\ 1\ "\fP.
-You could even call \fBjumper(big\ string)\fP to give $1 the value
-\fB"big\ string"\fP.
+If you call \fBjumper(\~1\~)\fP, the value of $1 is \fB"\~1\~"\fP.
+You could even call \fBjumper(big\~string)\fP to give $1 the value
+\fB"big\~string"\fP.
 .PP
 If you want to pass in a coordinate pair, you can avoid getting
 tripped up by the comma by wrapping the pair in parentheses.
@@ -1911,7 +1927,7 @@
 In either of the last two \fBcopy\fP commands, GNU \fBgpic\fP permits a
 trailing `\fBuntil\fP \fIword\/\fP' clause to be added which terminates
 the copy when the first word matches the argument (the default
-behavior is therefore equivalent to \fBuntil .PE\fP).
+behavior is therefore equivalent to \fBuntil \&.PE\fP).
 .PP
 Accordingly, the command
 .RS
@@ -2152,7 +2168,7 @@
 How Scaling is Handled
 .PP
 When \fBpic\fP processes a picture description on input, it passes
-\fB.PS\fP and \fB.PE\fP through to the postprocessor.
+\fB.PS\fP, \fB.PE\fP, and \fB.PF\fP through to the postprocessor.
 The \fB.PS\fP gets decorated with two numeric arguments which are the X
 and Y\~dimensions of the picture in inches.
 The post-processor can use these to reserve space for the picture and
@@ -2184,9 +2200,9 @@
 .vs
 .KE
 .LP
-Equivalent definition is supplied by GNU \fIpic\/\fP(1) if you use
-the \-mpic option; this should make it usable with macro pages other
-than \fIms\/\fR(1).
+Equivalent definitions of these and of \fB.PF\fP are supplied by GNU
+\fIpic\/\fP(1) if you use the \-mpic option; this should make it usable
+with macro pages other than \fIms\/\fR(1).
 .PP
 If \fB.PF\fP is used instead of \fB.PE\fP, the \fBtroff\fP position is
 restored to what it was at the picture start (Kernighan notes that
@@ -2198,7 +2214,7 @@
 .DE
 .LP
 causes the contents of \fIfile\fP to replace the \fB.PS\fP line.
-This feature is deprecated; use `\fBcopy\fP \fIfile\fR' instead).
+This feature is deprecated; use `\fBcopy\fP \fIfile\fR' instead.
 .
 .NH 2
 PIC and gtroff commands
@@ -2211,7 +2227,8 @@
 Point sizes and font changes are also safe within text strings, as
 long as they are undone before the end of string.
 .PP
-The state of \fBgtroff\fP's fill mode is preserved across pictures.
+The enablement of output line filling by \fBgtroff\fP is preserved
+across pictures.
 .
 .NH 2
 PIC and EQN
@@ -2646,8 +2663,8 @@
 .PP
 In general, \fBpic\fP is a free-format, token-oriented language that
 ignores whitespace outside strings.
-But certain lines and contructs are specially interpreted at the lexical
-level:
+But certain lines and constructs are specially interpreted at the
+lexical level:
 .PP
 A comment begins with \fB#\fP and continues to \fB\en\fP (comments may
 also follow text in a line).
@@ -2739,7 +2756,7 @@
 .PP
 If the ending `.PE' is replaced by `.PF', the page vertical position is
 restored to its value at the time `.PS' was encountered.
-Another alternate form of invocation is `.PS\ <\s-1FILENAME\s0',
+Another alternate form of invocation is `.PS\~<\s-1FILENAME\s0',
 which replaces the `.PS' line with a file to be interpreted by \fBpic\fR
 (but this feature is deprecated).
 .PP
@@ -2785,8 +2802,8 @@
 .R
 .DE
 .PP
-The current position and direction are saved on entry to a `{\ .\|.\|.\ }'
-construction and restored on exit from it.
+The current position and direction are saved on entry to a
+ `{\~.\|.\|.\~}' construction and restored on exit from it.
 .PP
 Note that in `if' constructions, newlines can only occur in
 \s-1BALANCED-BODY\s0.
@@ -2865,26 +2882,26 @@
 .R
 .DE
 .PP
-Drawn objects within `\ .\|.\|.\ ' are treated as a single composite
+Drawn objects within `\~.\|.\|.\~' are treated as a single composite
 object with a rectangular shape (that of the bounding box of all the
 elements).
 Variable and label assignments within a block are local to the block.
 Current direction of motion is restored to the value at start of block
 upon exit.
-Position is \fInot\fR restored (unlike `{\ }');
+Position is \fInot\fR restored (unlike `{\~}');
 instead, the current position becomes the exit position for the current
 direction on the block's bounding box.
 .DS
 .CW
 <attribute> ::=
-  height <expr>       \fR# set height of closed figure \fP
-  width <expr>        \fR# set width of closed figure \fP
-  radius <expr>       \fR# set radius of circle/arc \fP
-  diameter <expr>     \fR# set diameter of circle/arc \fP
-  up <expr>           \fR# move up \fP
-  down <expr>         \fR# move down \fP
-  left <expr>         \fR# move left \fP
-  right <expr>        \fR# move right \fP
+  height <expr>       \fR# set height of closed figure\fP
+  width <expr>        \fR# set width of closed figure\fP
+  radius <expr>       \fR# set radius of circle/arc\fP
+  diameter <expr>     \fR# set diameter of circle/arc\fP
+  up <expr>           \fR# move up\fP
+  down <expr>         \fR# move down\fP
+  left <expr>         \fR# move left\fP
+  right <expr>        \fR# move right\fP
   from <position>       \fR# set from position of open figure\fP
   to <position>         \fR# set to position of open figure\fP
   at <position>         \fR# set center of open figure\fP
@@ -2898,8 +2915,8 @@
   chop <expr>         \fR# chop end(s) of segment\fP
   '->' | '<-' | '<->'   \fR# decorate with arrows\fP
   invisible           \fR# make primitive invisible\fP
-  solid                 \fR# make closed figure solid\fP
-  filled <expr>     \fR# set fill density for figure\fP
+  solid                 \fR# set solid line style\fP
+  filled <expr>     \fR# fill closed figure with optional density\fP
   xscaled <expr>        \fR# slant box into x direction\fP
   yscaled <expr>        \fR# slant box into y direction\fP
   coloured TEXT     \fR# set fill and outline color for figure\fP
@@ -2927,7 +2944,7 @@
 The `by' primitive is not documented in the tutorial portion of
 the Kernighan paper, and should probably be considered unreliable.
 .PP
-The primitive `arrow' is a synonym for `line\ ->'.
+The primitive `arrow' is a synonym for `line\~->'.
 .PP
 Text is normally an attribute of some object, in which case successive
 strings are vertically stacked and centered on the object's center by
@@ -2942,13 +2959,13 @@
 Text may also contain \e-escapes denoting special characters.
 The base font and specific set of escapes supported is implementation
 dependent, but supported escapes always include the following:
-.IP "\efR, \ef1"
+.IP "\efR, \ef1" \w'\efR,\~\ef3'u+2n
 Set Roman style (the default)
 .IP "\efI, \ef2"
 Set Italic style
 .IP "\efB, \ef3"
 Set Bold style
-.IP "\efP\ \ \ \ \ \ "
+.IP \efP
 Revert to previous style; only works one level deep, does not stack.
 .PP
 Color names are dependent on the \gBpic\fR implementation, but in
@@ -3078,7 +3095,7 @@
 .R
 .DE
 both cause a syntax error.
-(DWB \fBpic\fP also allows the weird form `A\ north\ of'.)
+(DWB \fBpic\fP also allows the weird form `A\~north\~of'.)
 .PP
 Here the special rules for the `with' keyword using a path:
 .DS
@@ -3132,7 +3149,7 @@
 .TE
 Any of these can be set by assignment, or reset using the \fBreset\fP
 statement.
-Style variables assigned within `\ ' blocks are restored to their
+Style variables assigned within `\~' blocks are restored to their
 beginning-of-block value on exit; top-level assignments persist across
 pictures.
 Dimensions are divided by \fBscale\fR on output.
@@ -3202,7 +3219,7 @@
 .R
 .DE
 .LP
-The arguments (if any) are substituted for tokens $1, $2 .\|.\|.\& $n
+The arguments (if any) are substituted for tokens $1, $2 \&.\|.\|.\& $n
 appearing in the replacement text.
 To undefine a macro, say \fBundef\fP \fIname\fR, specifying the name to
 be undefined.

_service:tar_scm:groff-1.22.4.tar.gz/doc/webpage.ms -> _service:tar_scm:groff-1.23.0.tar.gz/doc/webpage.ms Changed

@@ -5,6 +5,10 @@
 .\" To make it work with other output devices also, we include
 .\" www.tmac directly.
 .\"
+.am pspic*error-hook
+.  ab \\n.F:\\n.c: fatal error: PSPIC failed to include '\\$1'
+..
+.
 .nr PS 10
 .nr VS 12
 .if '\*.T'html' .nr LL 10i
@@ -82,14 +86,11 @@
 the current development version is available from a
 .URL "https://\:savannah.gnu.org/\:git/\:?group=groff" "git repository" .
 .
-The current version is 1.22.4 (Spring 2018).
+The current version is 1.23.0 (March 2023).
 
 To view the git repository in your browser, use
 .URL "http://\:git.savannah.gnu.org/\:cgit/\:groff.git" \
      "Savannah's cgit interface" .
-.
-There you can also download snapshots;
-simply click on a commit entry line to get the URL.
 
 Additional contributions can be found
 .URL "http://\:groff.ffii.org/\:groff/\:contrib/" here .
@@ -105,8 +106,8 @@
 .
 .HR
 .
-\s-4\fIThis document was produced using
-.URL http://\:www.gnu.org/\:software/\:groff groff-\n.x.\n.y.\n.Y .
+\s-2\fIThis document was produced using
+.URL http://\:www.gnu.org/\:software/\:groff groff\~\n.x.\n.y.\n.Y .
 .br
 The image at the top has been contributed by Imogen Mulley,
 based on a similar picture found on the
@@ -131,7 +132,7 @@
 Included in this release are implementations of `troff', `pic', `eqn',
 `tbl', `grn', `refer', `\-man', `\-mdoc', `\-mom', and `\-ms' macros, and
 drivers for `PostScript', `PDF', `TeX DVI' format, `HP LaserJet\~4'
-printers, `Canon CAPSL' printers, `HTML' and `XHTML' formats (beta status),
+printers, `Canon CaPSL' printers, `HTML' and `XHTML' formats (beta status),
 and typewriter-like devices.
 Also included is a modified version of the Berkeley `\-me' macros, the
 enhanced version `gxditview' of the X11 `xditview' previewer, and an
@@ -142,7 +143,7 @@
 You require a C++ compiler.
 
 The file `INSTALL.REPO' contains supplementary instructions for building
-directly from a clone of the repository or a snapshot tarball.
+directly from a clone of the repository.
 
 The file `NEWS' describes recent user-visible changes to `groff'.
 
@@ -167,8 +168,6 @@
 
 To view the git repository in your browser, go to its
 .URL http://\:git.savannah.gnu.org/\:cgit/\:groff.git "browser interface" .
-There you can also download snapshots; simply click on a commit entry
-line to get the URL.
 .
 .
 .SH
@@ -179,21 +178,20 @@
 
 .in 2m
 .nf
-perl >= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
+perl \>= v5.6.1 (see macro GROFF_PERL in file `m4/groff.m4')
 ghostscript
 the psutils package
 the netpbm package
-texinfo 4.8
+texinfo 5.0
 bison \>= 1.875b or byacc
 .fi
 .in
 
 Note that `texinfo' and `bison' or `byacc' are required only for building
-from repository sources (either a checked out working copy, or a commit
-snapshot).
+from repository sources (a checked-out working copy).
 They are not required for building from a stable release tarball.
 Also note that the version numbers stated are the minimum supported.
-No version of `texinfo' < 4.8 works, and the original release of `bison'
+No version of `texinfo' < 5.0 works, and the original release of `bison'
 1.875 is known not to work; you \fImay\fP find that `bison' releases < 1.875
 work, but in case of difficulty, please update to a later version
 \fIbefore\fP posting a bug report.
@@ -210,8 +208,8 @@
 The `groff' configure script searches for the X11 headers and libraries
 `Xaw' and `Xmu'.
 So the corresponding developer packages of your system must be installed,
-otherwise `groff' does not install `gxditview' and the `-TX*' devices.
-In Debian, the developer packages are `libxaw7-dev' and `libxmu-dev'.
+otherwise `groff' does not install `gxditview' and the `\-TX*' devices.
+In Debian, the developer packages are `libxaw7\-dev' and `libxmu\-dev'.
 .
 .
 .SH
@@ -220,9 +218,9 @@
 Please report bugs using the project's
 .URL https://\:savannah.gnu.org/\:projects/\:groff "bug tracker" .
 
-You may use the form in the file `BUG-REPORT'; the idea of this is to
+You may use the form in the file `BUG\-REPORT'; the idea of this is to
 make sure that FSF has all the information it needs to fix the bug.
-At the very least, read the `BUG-REPORT' form and make sure that you supply
+At the very least, read the `BUG\-REPORT' form and make sure that you supply
 all the information that it asks for.
 Even if you are not sure that something is a bug, report it:
 this enables us to determine whether it really is a bug.
@@ -247,7 +245,7 @@
 a read-only list showing commits to the git repository.
 .ULE
 
-To subscribe, send a mail to \lalist\ra-request@\ladomain\ra
+To subscribe, send a mail to \lalist\ra\-request@\ladomain\ra
 (example:
 .MTO groff\-request@\:gnu.org
 for the `groff' list) with the word `subscribe' in either the
@@ -256,9 +254,9 @@
 
 .in 2m
 .nf
-.URL http://lists.gnu.org/mailman/listinfo/bug-groff
+.URL http://lists.gnu.org/mailman/listinfo/bug\-groff
 .URL http://lists.gnu.org/mailman/listinfo/groff
-.URL http://lists.gnu.org/mailman/listinfo/groff-commit
+.URL http://lists.gnu.org/mailman/listinfo/groff\-commit
 .fi
 .in
 
@@ -275,8 +273,8 @@
 .ULS
 .LI
 X11 resources for gxditview, which were previously installed in
-/usr/X11/lib/X11/app-defaults no matter which `prefix' was set, are
-now installed in appresdir=$prefix/lib/X11/app-defaults.
+/usr/X11/lib/X11/app\-defaults no matter which `prefix' was set, are
+now installed in appresdir=$prefix/lib/X11/app\-defaults.
 If `appresdir' is not a standard X11 resource directory, the environment
 variable XFILESEARCHPATH should be set to this path.
 The standard default directories depends on the system `libXt'.
@@ -284,9 +282,9 @@
 
 .in 2m
 .nf
-/usr/lib/X11/app-defaults
-/usr/share/X11/app-defaults
-/etc/X11/app-defaults
+/usr/lib/X11/app\-defaults
+/usr/share/X11/app\-defaults
+/etc/X11/app\-defaults
 .fi
 .in
 
@@ -338,14 +336,14 @@
 
 .in 2m
 .nf
-\&.if !\enPHASE .tm pdfroff-option:set toc_relocation=enabled
+\&.if !\enPHASE .tm pdfroff\-option:set toc_relocation=enabled
 .fi
 .in
 
-is invoked during input file processing; (`.if !\enPHASE ...' ensures
-that the effect of the `.tm' request is restricted to the document setup
-phase of processing, as pdfroff sets it to 1 or\~2 in the output phase,
-but leaves it unset in the setup phase).
+is invoked during input file processing; (`.if !\enPHASE \&.\|.\|.\&'
+ensures that the effect of the `.tm' request is restricted to the
+document setup phase of processing, as pdfroff sets it to 1 or\~2 in the
+output phase, but leaves it unset in the setup phase).
 
 The bundled `spdf.tmac' macro package, which implicitly activates
 `\-mpdfmark' for `ms' macro users, ensures that TOC relocation is
@@ -368,7 +366,7 @@
 `meintro_fr.me').
 
 .LI
-In -mdoc, command %C is now available, providing a city or place reference.
+In \-mdoc, command %C is now available, providing a city or place reference.
 .ULE
 .
 .
@@ -448,7 +446,7 @@
 .LI
 The \-mom macro package has reached version 2.0, focusing on PDF output
 with gropdf (using the new `pdfmom' wrapper script).
-See the file `version-2.html' of the \-mom documentation for a list of the
+See the file `version\-2.html' of the \-mom documentation for a list of the
 many changes.
 
 .LI
@@ -552,7 +550,7 @@
 .ULS
 .LI
 A new macro `%U' has been added to the mdoc package to indicate a URL
-reference within an .Rs/.Re environment.
+reference within an \&.Rs/.Re environment.
 
 .LI
 Rudimentary support for the Japanese script has been added, most
@@ -609,7 +607,7 @@
 
 .LI
 A new read-only number register `.br' is available which is set to\~1
-if a macro is called as .foo and to\~0 if called as 'foo.
+if a macro is called as \&.foo and to\~0 if called as \&'foo.
 This allows reliable modification of requests.
 
 .in 2m
@@ -617,10 +615,10 @@
 .ft C
 \&.als bp@orig bp
 \&.de bp
-\&.  tm before bp
-\&.  ie \e\en.br .bp@orig
-\&.  el 'bp@orig
-\&.  tm after bp
+\&.\&  tm before bp
+\&.\&  ie \e\en.br .bp@orig
+\&.\&  el \aqbp@orig
+\&.\&  tm after bp
 \&..
 .ft P
 .fi
@@ -745,7 +743,7 @@
 
 .ULS
 .LI
-Eric S. Raymond has added a new device type to eqn, MathML.
+Eric S.\& Raymond has added a new device type to eqn, MathML.
 When \-TMathML is enabled, eqn now emits MathML formula markup rather than
 groff commands.
 The new groff \-Txhtml device uses this.
@@ -783,8 +781,8 @@
 
 .ULS
 .LI
-\eD'p...' is now supported if the polygon consists entirely of horizontal
-and vertical lines.
+\eD'p.\|.\|.\&' is now supported if the polygon consists entirely of
+horizontal and vertical lines.
 .ULE
 .
 .
@@ -814,7 +812,7 @@
 
 .LI
 Similar to other X11 applications, there are now two resource files,
-`GXditview' and `GXditview-color'.
+`GXditview' and `GXditview\-color'.
 .ULE
 .
 .
@@ -855,8 +853,8 @@
 .nf
 .ft C
 \&.TBL cols=2
-\&.  TR .TD 1*1 .TD 1*2
-\&.  TR .TD 2*1 .TD 2*2
+\&.\&  TR .TD 1*1 .TD 1*2
+\&.\&  TR .TD 2*1 .TD 2*2
 \&.ETB
 .ft P
 .fi
@@ -869,12 +867,12 @@
 .nf
 .ft C
 \&.TBL cols=2
-\&.  TR
-\&.    TD 1*1
-\&.    TD 1*2
-\&.  TR
-\&.    TD 2*1
-\&.    TD 2*2
+\&.\&  TR
+\&.\&    TD 1*1
+\&.\&    TD 1*2
+\&.\&  TR
+\&.\&    TD 2*1
+\&.\&    TD 2*2
 \&.ETB
 .ft P
 .fi
@@ -892,7 +890,7 @@
 Fabrice M\'enard contributed locales support.
 In particular, it is now possible to get French localization of the main
 macro packages (\-ms, \-mm, \-me, and \-mom, but not \-man and \-mdoc
-which are localized differently) by appending `-mfr' to the list of macro
+which are localized differently) by appending `\-mfr' to the list of macro
 packages.
 Example:
 
@@ -939,13 +937,13 @@
 
 .LI
 A new auxiliary macro package `62bit' has been added which provides some
-macros for adding, multiplying, and dividing signed 62bit integers (mainly
+macros for adding, multiplying, and dividing signed 62-bit integers (mainly
 to handle normal groff number operations without risking overflow errors).
 
 .LI
-For \-ms, Eric S. Raymond contributed support for ancient Bell Labs
+For \-ms, Eric S.\& Raymond contributed support for ancient Bell Labs
 localisms `.SC', `.UC', `.P1', and `.P2'.
-The latter three are enabled only after .SC is called.
+The latter three are enabled only after \&.SC is called.
 
 .LI
 A new string, `SN-STYLE', has been added to the ms macros, controlling
@@ -965,7 +963,7 @@
 
 .ULS
 .LI
-Analogously to the .ft and \ef pair, two new requests `gcolor' and
+Analogously to the \&.ft and \ef pair, two new requests `gcolor' and
 `fcolor' (which pair with \em and \eM, respectively) have been added to
 set the glyph and background colours.
 
@@ -1003,20 +1001,34 @@
 The following keywords aren't new but haven't been documented previously:
 
 .in 2m
-\fBundef NAME\fP (to undefine a macro)
+.B undef
+.I name
+(to undefine a macro)
 .br
-\fBcopy "FILE"\fP (a synonym for `include')
+.B
+copy
+.I file \dq \dq
+.R
+a synonym for `include')
 .br
-\fBspace n\fP (to modify the vertical spacing before and after an equation)
+.B space
+.I n
+(to modify the vertical spacing before and after an equation)
 .in
 
 .LI
 The following macros aren't new but haven't been documented previously:
 
 .in 2m
-\fBAlpha, .\|.\|., Omega\fP (the same as `ALPHA', .\|.\|., `OMEGA')
+.B Alpha ,
+\&\.\.\.,
+.B Omega
+(the same as
+.B ALPHA ,
+\&\.\.\.,
+.B OMEGA )
 .br
-\fBldots\fP (three dots on the base line)
+\fBldots\fP (three dots on the baseline)
 .br
 \fBdollar\fP (a dollar glyph)
 .in
@@ -1026,24 +1038,56 @@
 Again, this isn't new but hasn't been documented previously:
 
 .in 2m
-.ft B
-col n { .\|.\|. }
+.B col
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-lcol n { .\|.\|. }
+.B lcol
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-rcol n { .\|.\|. }
+.B rcol
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-ccol n { .\|.\|. }
+.B ccol
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-pile n { .\|.\|. }
+.B pile
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-lpile n { .\|.\|. }
+.B lpile
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-rpile n { .\|.\|. }
+.B rpile
+.I n
+.B {
+\&\.\.\.\&
+.B }
 .br
-cpile n { .\|.\|. }
-.ft P
-(set vertical spacing between rows to\~N)
+.B cpile
+.I n
+.B {
+\&\.\.\.\&
+.B }
+.br
+The above all set the vertical spacing between rows to\~\c
+.I n ).
 .ULE
 .
 .
@@ -1162,8 +1206,9 @@
 Sets the point size increment for each level of heading (set with
 `NH'), below the threshold level set by `GROWPS'; e.g., if
 \enPS\~=\~10, \enGROWPS\~=\~3 and \enPSINCR\~=\~2.0p, then `.NH\~1'
-produces 14pt headings, `.NH\~2' produces 12pt, and all other levels
-remain at 10pt (because \enPS\~=\~10).
+produces 14-point headings, `.NH\~2' produces 12-point,
+and all other levels
+remain at 10\~points (because \enPS\~=\~10).
 
 .LI
 The `SH' macro now accepts a numeric argument, to make heading size
@@ -1187,7 +1232,7 @@
 The `HR' macro no longer causes an empty line for non-HTML devices.
 
 A new macro `HEAD' has been added to directly add data to the
-<head>...</head> block.
+<head>.\|.\|.</head> block.
 
 New macros `OLS' and `OLE' to start and end an ordered list.
 
@@ -1246,8 +1291,8 @@
 name of the current drawing and background color, respectively.
 
 .LI
-New read-only register `.U' which is set to\~1 if in safer mode and set
-to\~0 if in unsafe mode.
+New read-only register `.U' which is set to\~1 if in unsafe mode and
+0\~otherwise.
 
 .LI
 An input encoding file for \%latin-5 (a.k.a.\& ISO \%8859-9) has been
@@ -1352,7 +1397,9 @@
 
 .ULS
 .LI
-A new man page `lj4_font(5)' documents how fonts are accessed with
+A new man page
+.I lj4_font (5)
+documents how fonts are accessed with
 grolj4.
 
 .LI
@@ -1394,9 +1441,9 @@
 
 .ULS
 .LI
-New options: \-\-text (\-\-mode\~text), \-\-tty-viewer, \-\-X (\-\-mode\~X),
-\-\-X-viewer, \-\-html (\-\-mode\~html), \-\-html-view, \-\-apropos-data,
-\-\-apropos-devel, \-\-apropos-progs.
+New options: \-\-text (\-\-mode\~text), \-\-tty\-viewer, \-\-X (\-\-mode\~X),
+\-\-X\-viewer, \-\-html (\-\-mode\~html), \-\-html\-view, \-\-apropos\-data,
+\-\-apropos\-devel, \-\-apropos\-progs.
 
 .LI
 New documentation file README_SH.
@@ -1434,7 +1481,7 @@
 
 .in 2m
 .ft C
-groff -Tdvi -mlatin9 my_file > my_file.dvi
+groff \-Tdvi \-mlatin9 my_file > my_file.dvi
 .ft P
 .in
 
@@ -1451,8 +1498,8 @@
 The existing groff glyph names are frozen; no glyph names which can't be
 constructed algorithmically will be added in the future.
 
-The \e... escape sequence has been extended to specify multiple glyph
-components.
+The \e.\|.\|.\& escape sequence has been extended to specify multiple
+glyph components.
 Example:
 
 .in 2m
@@ -1508,16 +1555,17 @@
 `special' request but before the already mounted special fonts.
 
 .LI
-In groff versions 1.18 and 1.18.1, \eD'f\~...'\& didn't move the current
-point horizontally.
+In groff versions 1.18 and 1.18.1, \eD'f\~.\|.\|.\&' didn't move the
+current point horizontally.
 Despite of being silly, this change has been reverted for backwards
 compatibility.
 Consequently, the intermediate output command `Df' also moves the
 position horizontally again.
 
-\eD'f\~...'\& is deprecated since it depends on the horizontal resolution
-of the output device (given with the `hor' parameter in the DESC file).
-Use the new \eD'Fg\~...'\& escape instead.
+\eD'f\~.\|.\|.\&' is deprecated since it depends on the horizontal
+motion quanum of the output device (given with the `hor' parameter in
+the DESC file).
+Use the new \eD'Fg\~.\|.\|.\&' escape instead.
 
 .LI
 For orthogonality, new \eD subcommands to change the fill color are
@@ -1525,15 +1573,15 @@
 
 .in 2m
 .ft C
-\eD'Fr ...' \fR(rgb)\f
+\eD\aqFr \&.\|.\|.\&\aq \fR(rgb)\f
 .br
-\eD'Fc ...' \fR(cmy)\f
+\eD\aqFc \&.\|.\|.\&\aq \fR(cmy)\f
 .br
-\eD'Fg ...' \fR(gray)\f
+\eD\aqFg \&.\|.\|.\&\aq \fR(gray)\f
 .br
-\eD'Fk ...' \fR(cmyk)\f
+\eD\aqFk \&.\|.\|.\&\aq \fR(cmyk)\f
 .br
-\eD'Fd' \fR(default color)\f
+\eD\aqFd\aq \fR(default color)\f
 .ft R
 .in
 
@@ -1626,8 +1674,9 @@
 all other devices.
 
 .LI
-The glyph \e~= is now called \e|=.
-Similar to other devices, \e~= is now another name for glyph \e~~.
+The glyph \e\ti= is now called \e|=.
+Similar to other devices,
+\e\ti= is now another name for glyph \e\ti\ti.
 .ULE
 .
 .
@@ -1726,13 +1775,13 @@
 
 .LI
 troff's start-up file `troffrc' now includes `papersize.tmac' to set
-the paper size with the command-line option `-dpaper=<size>'.
+the paper size with the command-line option `\-dpaper=<size>'.
 
 Possible values for `<size>' are the same as the predefined `papersize'
 values in the DESC file (only lowercase; see the groff_font man page)
-except \%a7-d7.
+except \%a7\end7.
 An appended `l' (ell) character denotes landscape orientation.
-Examples: `a4', `c3l', `letterl'.
+Examples: `a4l', `c3l', `letterl'.
 
 Most output drivers need additional command-line switches `\-p' and
 `\-l' to override the default paper length and orientation as set in
@@ -1743,7 +1792,7 @@
 
 .in 2m
 .ft C
-groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
+groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms > foo.ps
 .ft R
 .in
 .ULE
@@ -1804,7 +1853,7 @@
 
 .ULS
 .LI
-New option \-\-shell to select the shell under wich groffer shall run.
+New option \-\-shell to select the shell under which groffer shall run.
 .ULE
 .
 .SH 2
@@ -1847,13 +1896,15 @@
 
 .LI
 A local font directory has been prepended to the default font path; it
-defaults to /usr/local/share/groff/site-font.
+defaults to /usr/local/share/groff/site\-font.
 Similar to the normal font searching process, files must be placed into
-a dev\fIXXX\f subdirectory, e.g.
+a \%dev\c
+.I XXX
+subdirectory, e.g.,
 
 .in 2m
 .ft C
-/usr/local/share/groff/site-font/devps/FOO
+/usr/local/share/groff/site\-font/devps/FOO
 .ft P
 .in
 
@@ -1890,7 +1941,7 @@
 follow).
 A new function `defcolor' defines colors; the escape sequence `\em' sets the
 drawing color, the escape sequence `\eM' specifies the background color for
-closed objects created with \eD'.\|.\|.' commands.
+closed objects created with \eD'.\|.\|.\&' commands.
 `\em' and `\eM' switch back to the previous color.
 `\em' and `\eM' correspond to the new troff output command sets starting
 with `m' and `DF'.
@@ -1914,9 +1965,9 @@
 . nop GROFF_NO_SGR
 environment variable also.
 
-For defining color components as fractions between 0 and\~1, a new scaling
-indicator `f' has been defined: 1f\~=\~65536u.
-For testing whether a color is defined (with .if and .ie), a new
+For defining color components as fractions between 0 and\~1, a new
+scaling unit `f' has been defined: 1f\~=\~65536u.
+For testing whether a color is defined (with \&.if and \&.ie), a new
 conditional operator `m' is available.
 
 More details can be found in the groff_diff.7 manual page and in
@@ -1970,11 +2021,11 @@
 \&..
 \&.
 \&.de foo
-\&.  nop Hello, I'm `foo'.
-\&.  nop I will now define `bar'.
-\&.  de bar !
-\&.    nop Hello, I'm `bar'.
-\&.  !
+\&.\&  nop Hello, I\aqm \aqfoo\aq.
+\&.\&  nop I will now define \aqbar\aq.
+\&.\&  de bar !
+\&.\&    nop Hello, I\aqm \aqbar\aq.
+\&.\&  !
 \&..
 .ft P
 .fi
@@ -2110,10 +2161,11 @@
 .LI
 The escapes `\e%', `\e&', `\e)', and `\e:' no longer cause an error in \eX;
 they are ignored now.
-Additionally `\e\ ' and `\e~' are converted to single space characters.
+Additionally `\e\~' (space) and `\e\ti' are converted to single space
+characters.
 
 .LI
-The default tab distance in nroff mode is now 0.8i to be compatible
+The default tab distance in nroff mode is now 0.8i\~(inches) to be compatible
 with Unix troff.
 
 .LI
@@ -2137,7 +2189,7 @@
 `mom' has been designed to format documents for PostScript output only.
 
 .LI
-Two macros `AT' (AT&T) and `UC' (Univ. of California) have been added to
+Two macros `AT' (AT&T) and `UC' (Univ.\& of California) have been added to
 the man macros for compatibility with older BSD releases.
 
 .LI
@@ -2145,7 +2197,8 @@
 setting the line and title length, respectively (similar to those
 registers in the ms macro package).
 If not set on the command line or in a macro file loaded before the macro
-package itself, they default to 78n in nroff mode and 6.5i in troff mode.
+package itself, they default to 78n\~(ens) in nroff mode and
+6.5i\~(inches) in troff mode.
 
 .LI
 The `\-xwidth' specifier in the mdoc macro package has been removed.
@@ -2200,9 +2253,9 @@
 
 .in 2m
 .nf
-MAILTO -> MTO
-IMAGE  -> IMG
-LINE   -> HR
+MAILTO \-> MTO
+IMAGE  \-> IMG
+LINE   \-> HR
 .fi
 .in
 
@@ -2364,16 +2417,17 @@
 
 .ULS
 .LI
-By default, font sizes are now available in the range 5\-10000pt, similar
-to PS fonts.
+By default,
+font sizes are now available in the range 5\en10000p\~(points),
+similar to PS fonts.
 If you want the old behaviour (i.e., font sizes at discrete values only),
 insert the following at the start of your document:
 
 .in 2m
 .nf
 .ft C
-\&.if '\e*.T'dvi' \e
-\&.  sizes 500 600 700 800 900 1000 1095 1200 1400 1440 1600 \e
+\&.if \aq\e*.T\aqdvi\aq \e
+\&.\&  sizes 500 600 700 800 900 1000 1095 1200 1400 1440 1600 \e
 \&         1728 1800 2000 2074 2200 2400 2488 2800 3600
 .ft P
 .fi
@@ -2426,7 +2480,9 @@
 `less' to the $PAGER environment variable (or $MANPAGER, depending on the
 used version of `man'); alternatively, you can use `man's `\-P' option (or
 adapt its configuration file accordingly).
-See man(1) for more details.
+See
+.I man (1)
+for more details.
 
 .TAG GROFF_NO_SGR
 .LI
@@ -2497,17 +2553,19 @@
 
 .ULS
 .LI
-a predefined paper format (e.g. `A4' or `letter')
+a predefined paper format (e.g., `A4' or `letter')
 
 .LI
 a file name pointing to a file which must contain a paper size
-specification in its first line (e.g. `/etc/papersize')
+specification in its first line (e.g., `/etc/papersize')
 
 .LI
 a custom paper size definition like `35c,4i'
 .ULE
 
-See groff_font(5) for more details.
+See
+.I groff_font (5)
+for more details.
 This keyword only affects the physical dimensions of the output medium;
 grops, grolj4, and grolbp use it currently.
 troff completely ignores it.

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/CB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/CB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/CBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/CBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/CI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/CI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/CR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/CR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/HB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/HB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/HBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/HBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/HI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/HI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/HR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/HR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/NB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/NB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/NBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/NBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/NI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/NI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/NR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/NR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/TB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/TB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/TBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/TBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/TI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/TI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/TR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/TR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100-12/devX100-12.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100-12/devX100-12.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -38,19 +36,30 @@
   font/devX100-12/S
 
 if !WITHOUT_X11
-devX10012fontdir = $(fontdir)/devX100-12
-devX10012font_DATA = $(DEVX10012FONTS)
+devX100_12_fontdir = $(fontdir)/devX100-12
+devX100_12_font_DATA = $(DEVX10012FONTS)
 endif
 
 EXTRA_DIST += $(DEVX10012FONTS)
 
-
-########################################################################
-# Editor settings
-########################################################################
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
 #
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX100-12_font-descriptions
+devX100_12_fontsrcdir = $(top_srcdir)/font/devX100-12
+devX100-12_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX100_12_fontsrcdir) \
+	  && sed -e 's/res .*/res 100/;s/unitwidth .*/unitwidth 12/' \
+	    $(xditview_srcdir)/DESC.in >$(devX100_12_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX100_12_fontsrcdir) -r 100 -s 12 \
+	    $(xditview_srcdir)/FontMap-X11
+
+
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/CB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/CB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/CBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/CBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/CI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/CI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/CR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/CR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/HB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/HB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/HBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/HBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/HI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/HI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/HR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/HR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/NB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/NB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/NBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/NBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/NI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/NI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/NR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/NR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/TB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/TB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/TBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/TBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/TI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/TI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/TR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/TR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX100/devX100.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX100/devX100.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -38,19 +36,30 @@
   font/devX100/S
 
 if !WITHOUT_X11
-devX100fontdir = $(fontdir)/devX100
-devX100font_DATA = $(DEVX100FONTS)
+devX100_fontdir = $(fontdir)/devX100
+devX100_font_DATA = $(DEVX100FONTS)
 endif
 
 EXTRA_DIST += $(DEVX100FONTS)
 
-
-########################################################################
-# Editor settings
-########################################################################
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
 #
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX100_font-descriptions
+devX100_fontsrcdir=$(top_srcdir)/font/devX100
+devX100_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX100_fontsrcdir) \
+	  && sed -e 's/res .*/res 100/' $(xditview_srcdir)/DESC.in \
+	    >$(devX100_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX100_fontsrcdir) -r 100 -s 10 \
+	    $(xditview_srcdir)/FontMap-X11
+
+
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/CB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/CB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/CBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/CBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/CI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/CI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/CR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/CR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/HB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/HB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/HBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/HBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/HI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/HI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/HR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/HR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/NB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/NB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/NBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/NBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/NI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/NI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/NR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/NR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/TB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/TB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/TBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/TBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/TI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/TI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/TR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/TR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75-12/devX75-12.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75-12/devX75-12.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -36,19 +34,32 @@
   font/devX75-12/NB \
   font/devX75-12/NBI \
   font/devX75-12/S
+
 if !WITHOUT_X11
-devX7512fontdir = $(fontdir)/devX75-12
-devX7512font_DATA = $(DEVX7512FONTS)
+devX75_12_fontdir = $(fontdir)/devX75-12
+devX75_12_font_DATA = $(DEVX7512FONTS)
 endif
-EXTRA_DIST += $(DEVX7512FONTS)
 
+EXTRA_DIST += $(DEVX7512FONTS)
 
-########################################################################
-# Editor settings
-########################################################################
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
 #
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX75-12_font-descriptions
+devX75_12_fontsrcdir=$(top_srcdir)/font/devX75-12
+devX75-12_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX75_12_fontsrcdir) \
+	  && sed -e 's/res .*/res 75/;s/unitwidth .*/unitwidth 12/' \
+	    $(xditview_srcdir)/DESC.in >$(devX75_12_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX75_12_fontsrcdir) -r 75 -s 12 \
+	    $(xditview_srcdir)/FontMap-X11
+
+
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/CB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/CB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/CBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/CBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/CI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/CI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/CR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/CR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/HB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/HB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/HBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/HBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/HI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/HI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/HR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/HR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/NB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/NB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/NBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/NBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/NI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/NI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/NR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/NR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/TB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/TB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/TBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/TBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/TI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/TI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/TR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/TR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devX75/devX75.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devX75/devX75.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -38,19 +36,30 @@
   font/devX75/S
 
 if !WITHOUT_X11
-devX75fontdir = $(fontdir)/devX75
-devX75font_DATA = $(DEVX75FONTS)
+devX75_fontdir = $(fontdir)/devX75
+devX75_font_DATA = $(DEVX75FONTS)
 endif
 
 EXTRA_DIST += $(DEVX75FONTS)
 
-
-########################################################################
-# Editor settings
-########################################################################
+# This target generates font descriptions from core X11 font data
+# returned by a running X server; these are _not_ normally generated
+# during a build, but provided with the groff source distribution.
 #
+# This maintainer-mode target alters files in the source tree.
+maintainer-font-descriptions: devX75_font-descriptions
+devX75_fontsrcdir=$(top_srcdir)/font/devX75
+devX75_font-descriptions: $(xtotroff) $(xditview_srcdir)/DESC.in \
+  $(xditview_srcdir)/FontMap-X11
+	  $(AM_V_GEN)$(MKDIR_P) $(devX75_fontsrcdir) \
+	  && sed -e 's/res .*/res 75/' $(xditview_srcdir)/DESC.in \
+	    >$(devX75_fontsrcdir)/DESC \
+	  && $(xtotroff) -d $(devX75_fontsrcdir) -r 75 -s 10 \
+	    $(xditview_srcdir)/FontMap-X11
+
+
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devascii/R.proto -> _service:tar_scm:groff-1.23.0.tar.gz/font/devascii/R.proto Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devascii/devascii.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devascii/devascii.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devcp1047/devcp1047.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devcp1047/devcp1047.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/EX -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/EX Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/MI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/MI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/S -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/S Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/SA -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/SA Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/devdvi.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/devdvi.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devdvi/generate/Makefile -> _service:tar_scm:groff-1.23.0.tar.gz/font/devdvi/generate/Makefile Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devhtml/R.proto -> _service:tar_scm:groff-1.23.0.tar.gz/font/devhtml/R.proto Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devhtml/devhtml.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devhtml/devhtml.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -46,21 +44,26 @@
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(RM) $@ \
 	&& $(SHELL) $(GENFONTSSH) $(devhtml_srcdir)/R.proto \
-	     $(DEVHTMLRES) $(DEVHTMLCPI) `basename $@` > $@
+	  $(DEVHTMLRES) $(DEVHTMLCPI) `basename $@` >$@
 
 font/devhtml/DESC: $(devhtml_srcdir)/DESC.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(SHELL) $(GENDESCSH) $(devhtml_srcdir)/DESC.proto \
-	     $(DEVHTMLRES) $(DEVHTMLCPI) $(DEVHTMLLPI) $(DEVHTMLFONTS) > $@ \
-	&& echo "image_generator $(GHOSTSCRIPT)" >> $@
+	  $(DEVHTMLRES) $(DEVHTMLCPI) $(DEVHTMLLPI) $(DEVHTMLFONTS) \
+	  > $@.tmp \
+	&& echo "image_generator $(GHOSTSCRIPT)" >>$@.tmp \
+	&& mv $@.tmp $@
+
+# HTML documents to be produced by troff should depend on this stamp
+# file to ensure that (post-)grohtml's device and font description files
+# are available.
+MOSTLYCLEANFILES += font/devhtml/stamp
+font/devhtml/stamp: font/devhtml/DESC $(DEVHTMLFONTSFILES)
+	$(AM_V_at)>$@
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devlatin1/R.proto -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlatin1/R.proto Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devlatin1/devlatin1.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlatin1/devlatin1.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devlbp/devlbp.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlbp/devlbp.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devlj4/S -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlj4/S Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devlj4/devlj4.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlj4/devlj4.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devlj4/generate/Makefile -> _service:tar_scm:groff-1.23.0.tar.gz/font/devlj4/generate/Makefile Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devpdf/Foundry.in -> _service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/Foundry.in Changed

@@ -1,7 +1,7 @@
 # Foundry file
 
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
-#      Written by Deri James <deri@chuzzlewit.demon.co.uk>
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
+#      Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #
 # This file is part of groff.
 #
@@ -10,104 +10,112 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-#=====================================================================
-#Foundry|Name|Searchpath
-foundry||(gs)
+#=======================================================================
+#Foundry|Name|Search path
+foundry||@urwfontsdir@:(gs):/usr/share/fonts/type1/gsfonts:/usr/share/fonts/default/Type1:/usr/share/fonts/default/Type1/adobestd35:/usr/share/fonts/type1/urw-base35:/opt/local/share/fonts/urw-fonts:/usr/local/share/fonts/ghostscript
 
-# These are just copies of the grops fonts so MUST not have any flags etc set
+# Enable the font description files for grops (generated from Adobe
+# foundry font files) to be used with gropdf.  afmtodit must not be
+# called with any flags.  URW fonts are substituted for Adobe fonts in
+# the download file by default.  If you have Adobe Type 1 fonts, you can
+# update the foundry search path above if necessary and replace the
+# contents of the file fields below with their file names.
 
-#Font|IsBase14|Flags|Map|Encoding|File(!file...)
-AB|N||||URWGothic-Demi!URWGothicL-Demi!a010015l.pfb
-ABI|N||||URWGothic-DemiOblique!URWGothicL-DemiObli!a010035l.pfb
-AI|N||||URWGothic-BookOblique!URWGothicL-BookObli!a010033l.pfb
-AR|N||||URWGothic-Book!URWGothicL-Book!a010013l.pfb
-BMB|N||||URWBookman-Demi!URWBookmanL-DemiBold!b018015l.pfb
-BMBI|N||||URWBookman-DemiItalic!URWBookmanL-DemiBoldItal!b018035l.pfb
-BMI|N||||URWBookman-Light!URWBookmanL-LighItal!b018032l.pfb
-BMR|N||||URWBookman-LightItalic!URWBookmanL-Ligh!b018012l.pfb
-CB|Y||||NimbusMonoPS-Bold!NimbusMonL-Bold!n022004l.pfb
-CBI|Y||||NimbusMonoPS-BoldItalic!NimbusMonL-BoldObli!n022024l.pfb
-CI|Y||||NimbusMonoPS-Italic!NimbusMonL-ReguObli!n022023l.pfb
-CR|Y||||NimbusMonoPS-Regular!NimbusMonL-Regu!n022003l.pfb
+#Font|IsBase14|Flags|Map|Encoding|File(!file)...
+AB|N||||URWGothic-Demi.t1!URWGothic-Demi!URWGothicL-Demi!a010015l.pfb
+ABI|N||||URWGothic-DemiOblique.t1!URWGothic-DemiOblique!URWGothicL-DemiObli!a010035l.pfb
+AI|N||||URWGothic-BookOblique.t1!URWGothic-BookOblique!URWGothicL-BookObli!a010033l.pfb
+AR|N||||URWGothic-Book.t1!URWGothic-Book!URWGothicL-Book!a010013l.pfb
+BMB|N||||URWBookman-Demi.t1!URWBookman-Demi!URWBookmanL-DemiBold!b018015l.pfb
+BMBI|N||||URWBookman-DemiItalic.t1!URWBookman-DemiItalic!URWBookmanL-DemiBoldItal!b018035l.pfb
+BMI|N||||URWBookman-LightItalic.t1!URWBookman-LightItalic!URWBookmanL-LighItal!b018032l.pfb
+BMR|N||||URWBookman-Light.t1!URWBookman-Light!URWBookmanL-Ligh!b018012l.pfb
+CB|Y||||NimbusMonoPS-Bold.t1!NimbusMonoPS-Bold!NimbusMonL-Bold!n022004l.pfb
+CBI|Y||||NimbusMonoPS-BoldItalic.t1!NimbusMonoPS-BoldItalic!NimbusMonL-BoldObli!n022024l.pfb
+CI|Y||||NimbusMonoPS-Italic.t1!NimbusMonoPS-Italic!NimbusMonL-ReguObli!n022023l.pfb
+CR|Y||||NimbusMonoPS-Regular.t1!NimbusMonoPS-Regular!NimbusMonL-Regu!n022003l.pfb
+HB|Y||||NimbusSans-Bold.t1!NimbusSans-Bold!NimbusSanL-Bold!n019004l.pfb
+HBI|Y||||NimbusSans-BoldItalic.t1!NimbusSans-BoldItalic!NimbusSans-BoldOblique.t1!NimbusSans-BoldOblique!NimbusSanL-BoldItal!n019024l.pfb
+HI|Y||||NimbusSans-Italic.t1!NimbusSans-Italic!NimbusSans-Oblique.t1!NimbusSans-Oblique!NimbusSanL-ReguItal!n019023l.pfb
+HNB|N||||NimbusSansNarrow-Bold.t1!NimbusSansNarrow-Bold!NimbusSanL-BoldCond!n019044l.pfb
+HNBI|N||||NimbusSansNarrow-BoldOblique.t1!NimbusSansNarrow-BoldOblique!NimbusSansNarrow-BdOblique!NimbusSanL-BoldCondItal.t1!NimbusSanL-BoldCondItal!n019064l.pfb
+HNI|N||||NimbusSansNarrow-Oblique.t1!NimbusSansNarrow-Oblique!NimbusSanL-ReguCondItal!n019063l.pfb
+HNR|N||||NimbusSansNarrow-Regular.t1!NimbusSansNarrow-Regular!NimbusSanL-ReguCond!n019043l.pfb
+HR|Y||||NimbusSans-Regular.t1!NimbusSans-Regular!NimbusSans-Regular!NimbusSanL-Regu!n019003l.pfb
+NB|N||||C059-Bold.t1!C059-Bold!CenturySchL-Bold!c059016l.pfb
+NBI|N||||C059-BdIta.t1!C059-BdIta!CenturySchL-BoldItal!c059036l.pfb
+NI|N||||C059-Italic.t1!C059-Italic!CenturySchL-Ital!c059033l.pfb
+NR|N||||C059-Roman.t1!C059-Roman!CenturySchL-Roma!c059013l.pfb
+PB|N||||P052-Bold.t1!P052-Bold!URWPalladioL-Bold!p052004l.pfb
+PBI|N||||P052-BoldItalic.t1!P052-BoldItalic!URWPalladioL-BoldItal!p052024l.pfb
+PI|N||||P052-Italic.t1!P052-Italic!URWPalladioL-Ital!p052023l.pfb
+PR|N||||P052-Roman.t1!P052-Roman!URWPalladioL-Roma!p052003l.pfb
+S|Y||||StandardSymbolsPS.t1!StandardSymbolsPS!StandardSymL!s050000l.pfb
+TB|Y||||NimbusRoman-Bold.t1!NimbusRoman-Bold!NimbusRomNo9L-Medi!n021004l.pfb
+TBI|Y||||NimbusRoman-BoldItalic.t1!NimbusRoman-BoldItalic!NimbusRomNo9L-MediItal!n021024l.pfb
+TI|Y||||NimbusRoman-Italic.t1!NimbusRoman-Italic!NimbusRomNo9L-ReguItal!n021023l.pfb
+TR|Y||||NimbusRoman-Regular.t1!NimbusRoman-Regular!NimbusRomNo9L-Regu!n021003l.pfb
+ZCMI|N||||Z003-MediumItalic.t1!Z003-MediumItalic!URWChanceryL-MediItal!z003034l.pfb
+ZD|Y||||D050000L!D050000L.t1!Dingbats!d050000l.pfb
 EURO|N||||*../devps/freeeuro.pfa
-HB|Y||||NimbusSans-Bold!NimbusSanL-Bold!n019004l.pfb
-HBI|Y||||NimbusSans-BoldOblique!NimbusSanL-BoldItal!n019024l.pfb
-HI|Y||||NimbusSans-Oblique!NimbusSanL-ReguItal!n019023l.pfb
-HNB|N||||NimbusSansNarrow-Bold!NimbusSanL-BoldCond!n019044l.pfb
-HNBI|N||||NimbusSansNarrow-BoldOblique!NimbusSansNarrow-BdOblique!NimbusSanL-BoldCondItal!n019064l.pfb
-HNI|N||||NimbusSansNarrow-Oblique!NimbusSanL-ReguCondItal!n019063l.pfb
-HNR|N||||NimbusSansNarrow-Regular!NimbusSanL-ReguCond!n019043l.pfb
-HR|Y||||NimbusSans-Regular!NimbusSans-Regular!NimbusSanL-Regu!n019003l.pfb
-NB|N||||C059-Bold!CenturySchL-Bold!c059016l.pfb
-NBI|N||||C059-BdIta!CenturySchL-BoldItal!c059036l.pfb
-NI|N||||C059-Italic!CenturySchL-Ital!c059033l.pfb
-NR|N||||C059-Roman!CenturySchL-Roma!c059013l.pfb
-PB|N||||P052-Bold!URWPalladioL-Bold!p052004l.pfb
-PBI|N||||P052-BoldItalic!URWPalladioL-BoldItal!p052024l.pfb
-PI|N||||P052-Italic!URWPalladioL-Ital!p052023l.pfb
-PR|N||||P052-Roman!URWPalladioL-Roma!p052003l.pfb
-S|Y||||StandardSymbolsPS!StandardSymL!s050000l.pfb
-TB|Y||||NimbusRoman-Bold!NimbusRomNo9L-Medi!n021004l.pfb
-TBI|Y||||NimbusRoman-BoldItalic!NimbusRomNo9L-MediItal!n021024l.pfb
-TI|Y||||NimbusRoman-Italic!NimbusRomNo9L-ReguItal!n021023l.pfb
-TR|Y||||NimbusRoman-Regular!NimbusRomNo9L-Regu!n021003l.pfb
-ZCMI|N||||Z003-MediumItalic!URWChanceryL-MediItal!z003034l.pfb
-ZD|Y||||Dingbats!d050000l.pfb
 
-#======================================================================
+# BEGIN URW ============================================================
 
-#Foundry|Name|Searchpath
-foundry|U|(gs):@urwfontsdir@ :/usr/share/fonts/type1/gsfonts :/opt/local/share/fonts/urw-fonts # the URW fonts delivered with ghostscript (may be different)
-#Define Flags for afmtodit
+# URW fonts are typically shipped with Ghostscript, but can be replaced.
+
+#Foundry|Name|Search path
+foundry|U|@urwfontsdir@:/usr/share/fonts/type1/gsfonts:/usr/share/fonts/default/Type1:/usr/share/fonts/default/Type1/adobestd35:/usr/share/fonts/type1/urw-base35:/opt/local/share/fonts/urw-fonts:/usr/local/share/fonts/ghostscript:(gs)
+
+# Define flags for afmtodit.
 
 r=-i 0 -m
 i=-i 50
 n=-n
 s=-s
 
-#Font|IsBase14|Flags|Map|Encoding|File
-AB|N|r|textmap|text.enc|a010015l.pfb
-ABI|N|i|textmap|text.enc|a010035l.pfb
-AI|N|i|textmap|text.enc|a010033l.pfb
-AR|N|r|textmap|text.enc|a010013l.pfb
-BMB|N|r|textmap|text.enc|b018015l.pfb
-BMBI|N|i|textmap|text.enc|b018035l.pfb
-BMI|N|i|textmap|text.enc|b018032l.pfb
-BMR|N|r|textmap|text.enc|b018012l.pfb
-CB|N|nr|textmap|text.enc|n022004l.pfb
-CBI|N|ni|textmap|text.enc|n022024l.pfb
-CI|N|ni|textmap|text.enc|n022023l.pfb
-CR|N|nr|textmap|text.enc|n022003l.pfb
-HB|N|r|textmap|text.enc|n019004l.pfb
-HBI|N|i|textmap|text.enc|n019024l.pfb
-HI|N|i|textmap|text.enc|n019023l.pfb
-HNB|N|r|textmap|text.enc|n019044l.pfb
-HNBI|N|i|textmap|text.enc|n019064l.pfb
-HNI|N|i|textmap|text.enc|n019063l.pfb
-HNR|N|r|textmap|text.enc|n019043l.pfb
-HR|N|r|textmap|text.enc|n019003l.pfb
-NB|N|r|textmap|text.enc|c059016l.pfb
-NBI|N|i|textmap|text.enc|c059036l.pfb
-NI|N|i|textmap|text.enc|c059033l.pfb
-NR|N|r|textmap|text.enc|c059013l.pfb
-PB|N|r|textmap|text.enc|p052004l.pfb
-PBI|N|i|textmap|text.enc|p052024l.pfb
-PI|N|i|textmap|text.enc|p052023l.pfb
-PR|N|r|textmap|text.enc|p052003l.pfb
-S|N|sr|symbolmap||s050000l.pfb
-TB|N|r|textmap|text.enc|n021004l.pfb
-TBI|N|i|textmap|text.enc|n021024l.pfb
-TI|N|i|textmap|text.enc|n021023l.pfb
-TR|N|r|textmap|text.enc|n021003l.pfb
-ZCMI|N|i|textmap|text.enc|z003034l.pfb
-ZD|N|sr|dingbats.map||d050000l.pfb
+#Font|IsBase14|Flags|Map|Encoding|File(!file)...
+AB|N|r|text.map|text.enc|URWGothic-Demi.t1!URWGothic-Demi!URWGothicL-Demi!a010015l.pfb
+ABI|N|i|text.map|text.enc|URWGothic-DemiOblique.t1!URWGothic-DemiOblique!URWGothicL-DemiObli!a010035l.pfb
+AI|N|i|text.map|text.enc|URWGothic-BookOblique.t1!URWGothic-BookOblique!URWGothicL-BookObli!a010033l.pfb
+AR|N|r|text.map|text.enc|URWGothic-Book.t1!URWGothic-Book!URWGothicL-Book!a010013l.pfb
+BMB|N|r|text.map|text.enc|URWBookman-Demi.t1!URWBookman-Demi!URWBookmanL-DemiBold!b018015l.pfb
+BMBI|N|i|text.map|text.enc|URWBookman-DemiItalic.t1!URWBookman-DemiItalic!URWBookmanL-DemiBoldItal!b018035l.pfb
+BMI|N|i|text.map|text.enc|URWBookman-Light.t1!URWBookman-Light!URWBookmanL-LighItal!b018032l.pfb
+BMR|N|r|text.map|text.enc|URWBookman-LightItalic.t1!URWBookman-LightItalic!URWBookmanL-Ligh!b018012l.pfb
+CB|N|nr|text.map|text.enc|NimbusMonoPS-Bold.t1!NimbusMonoPS-Bold!NimbusMonL-Bold!n022004l.pfb
+CBI|N|ni|text.map|text.enc|NimbusMonoPS-BoldItalic.t1!NimbusMonoPS-BoldItalic!NimbusMonL-BoldObli!n022024l.pfb
+CI|N|ni|text.map|text.enc|NimbusMonoPS-Italic.t1!NimbusMonoPS-Italic!NimbusMonL-ReguObli!n022023l.pfb
+CR|N|nr|text.map|text.enc|NimbusMonoPS-Regular.t1!NimbusMonoPS-Regular!NimbusMonL-Regu!n022003l.pfb
+HB|N|r|text.map|text.enc|NimbusSans-Bold.t1!NimbusSans-Bold!NimbusSanL-Bold!n019004l.pfb
+HBI|N|i|text.map|text.enc|NimbusSans-BoldItalic!NimbusSans-BoldItalic.t1!NimbusSans-BoldOblique!NimbusSanL-BoldItal!n019024l.pfb
+HI|N|i|text.map|text.enc|NimbusSans-Italic!NimbusSans-Italic.t1!NimbusSans-Oblique!NimbusSanL-ReguItal!n019023l.pfb
+HNB|N|r|text.map|text.enc|NimbusSansNarrow-Bold.t1!NimbusSansNarrow-Bold!NimbusSanL-BoldCond!n019044l.pfb
+HNBI|N|i|text.map|text.enc|NimbusSansNarrow-BoldOblique.t1!NimbusSansNarrow-BoldOblique!NimbusSansNarrow-BdOblique!NimbusSanL-BoldCondItal.t1!NimbusSanL-BoldCondItal!n019064l.pfb
+HNI|N|i|text.map|text.enc|NimbusSansNarrow-Oblique.t1!NimbusSansNarrow-Oblique!NimbusSanL-ReguCondItal!n019063l.pfb
+HNR|N|r|text.map|text.enc|NimbusSansNarrow-Regular.t1!NimbusSansNarrow-Regular!NimbusSanL-ReguCond!n019043l.pfb
+HR|N|r|text.map|text.enc|NimbusSans-Regular.t1!NimbusSans-Regular!NimbusSans-Regular!NimbusSanL-Regu!n019003l.pfb
+NB|N|r|text.map|text.enc|C059-Bold.t1!C059-Bold!CenturySchL-Bold!c059016l.pfb
+NBI|N|i|text.map|text.enc|C059-BdIta.t1!C059-BdIta!CenturySchL-BoldItal!c059036l.pfb
+NI|N|i|text.map|text.enc|C059-Italic.t1!C059-Italic!CenturySchL-Ital!c059033l.pfb
+NR|N|r|text.map|text.enc|C059-Roman.t1!C059-Roman!CenturySchL-Roma!c059013l.pfb
+PB|N|r|text.map|text.enc|P052-Bold.t1!P052-Bold!URWPalladioL-Bold!p052004l.pfb
+PBI|N|i|text.map|text.enc|P052-BoldItalic.t1!P052-BoldItalic!URWPalladioL-BoldItal!p052024l.pfb
+PI|N|i|text.map|text.enc|P052-Italic.t1!P052-Italic!URWPalladioL-Ital!p052023l.pfb
+PR|N|r|text.map|text.enc|P052-Roman.t1!P052-Roman!URWPalladioL-Roma!p052003l.pfb
+S|N|sr|symbol.map||StandardSymbolsPS.t1!StandardSymbolsPS!StandardSymL!s050000l.pfb
+TB|N|r|text.map|text.enc|NimbusRoman-Bold.t1!NimbusRoman-Bold!NimbusRomNo9L-Medi!n021004l.pfb
+TBI|N|i|text.map|text.enc|NimbusRoman-BoldItalic.t1!NimbusRoman-BoldItalic!NimbusRomNo9L-MediItal!n021024l.pfb
+TI|N|i|text.map|text.enc|NimbusRoman-Italic.t1!NimbusRoman-Italic!NimbusRomNo9L-ReguItal!n021023l.pfb
+TR|N|r|text.map|text.enc|NimbusRoman-Regular.t1!NimbusRoman-Regular!NimbusRomNo9L-Regu!n021003l.pfb
+ZCMI|N|i|text.map|text.enc|Z003-MediumItalic.t1!Z003-MediumItalic!URWChanceryL-MediItal!z003034l.pfb
+ZD|N|sr|dingbats.map||D050000L!D050000L.t1!Dingbats!d050000l.pfb
 
-#======================================================================
+# END URW ==============================================================

_service:tar_scm:groff-1.22.4.tar.gz/font/devpdf/devpdf.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/devpdf.am Changed

@@ -1,9 +1,7 @@
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
-#      Original Makefile.sub written
-#      by Deri James <deri@chuzzlewit.demon.co.uk>
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
+#      Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #      Automake migration by Bertrand Garrigues
-#
-# Last update: 2017-11-02
+#        <bertrand.garrigues@laposte.net>
 #
 # This file is part of groff.
 #
@@ -30,7 +28,6 @@
   font/devpdf/download \
   font/devpdf/DESC \
   font/devpdf/Foundry \
-  font/devpdf/build_font_files \
   font/devpdf/util/BuildFoundries
 
 devpdffontdir = $(fontdir)/devpdf
@@ -42,41 +39,40 @@
 devpdffontenc_DATA = font/devpdf/enc/text.enc
 
 devpdffontmapdir = $(devpdffontdir)/map
-DEVPDFFONTMAP_1 = \
+devpdffontmapdata = \
   font/devpdf/map/dingbats.map \
+  font/devpdf/map/symbol.map \
   font/devpdf/map/symbolchars \
-  font/devpdf/map/textmap
-DEVPDFFONTMAP_2 = font/devpdf/map/symbolmap
-devpdffontmap_DATA = $(DEVPDFFONTMAP_1) $(DEVPDFFONTMAP_2)
+  font/devpdf/map/text.map
+devpdffontmap_DATA = $(devpdffontmapdata)
 
 EXTRA_DIST += \
   font/devpdf/DESC.in \
   font/devpdf/Foundry.in \
   font/devpdf/util/BuildFoundries.pl
 
+all: font/devpdf/stamp
+
 font/devpdf/enc/text.enc:
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/enc
-	cp -f $(top_srcdir)/font/devps/text.enc \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/enc
+	$(AM_V_at)cp -f $(top_srcdir)/font/devps/text.enc \
 	  $(top_builddir)/font/devpdf/enc
 
-font/devpdf/map/symbolmap:
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/map
-	@cp -f $(top_srcdir)/font/devps/symbolmap \
-	  $(top_builddir)/font/devpdf/map
-
-$(DEVPDFFONTMAP_1):
-	@$(MKDIR_P) $(top_builddir)/font/devpdf/map
-	@cp -f $(top_srcdir)/font/devps/generate/`basename $@` \
+$(devpdffontmapdata):
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/map
+	$(AM_V_at)cp -f \
+	  $(top_srcdir)/font/devps/generate/`basename $@` \
 	  $(top_builddir)/font/devpdf/map
 
-font/devpdf/util/BuildFoundries: shdeps.sed \
-  $(devpdf_srcdir)/util/BuildFoundries.pl
+MOSTLYCLEANFILES += font/devpdf/util/BuildFoundries
+font/devpdf/util/BuildFoundries: \
+  $(devpdf_srcdir)/util/BuildFoundries.pl $(SH_DEPS_SED_SCRIPT) afmtodit
 	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf/util \
-	&& $(RM) $(top_builddir)/font/devpdf/util/BuildFoundries \
 	&& if test -n "$(PERL)"; then \
 	     sed -f $(SH_DEPS_SED_SCRIPT) \
 	         -e "s|/usr/bin/perl|$(PERL)|" \
-	         -e "s|@GROFF_GHOSTSCRIPT_INTERPRETERS@|$(GHOSTSCRIPT)|" \
+	         -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|" \
+	         -e "s|@PATH_SEPARATOR@|$(PATH_SEPARATOR)|" \
 	         -e "s|@VERSION@|$(VERSION)|" \
 	         -e "s|@GROFF_FONT_DIR@|$(fontdir)|" \
 	         $(devpdf_srcdir)/util/BuildFoundries.pl \
@@ -90,42 +86,52 @@
 	   fi \
 	&& chmod +x $(top_builddir)/font/devpdf/util/BuildFoundries
 
+MOSTLYCLEANFILES += font/devpdf/DESC
 font/devpdf/DESC: $(devpdf_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf \
-	&& $(RM) $(top_builddir)/font/devpdf/DESC \
-	&& cat $(devpdf_srcdir)/DESC.in >$(top_builddir)/font/devpdf/DESC \
+	&& cat $(devpdf_srcdir)/DESC.in \
+	  >$(top_builddir)/font/devpdf/DESC \
 	&& if test "$(PAGE)" = A4; then \
 	     echo "papersize a4" >>$(top_builddir)/font/devpdf/DESC; \
 	   else \
-	     echo "papersize letter" >>$(top_builddir)/font/devpdf/DESC; \
+	     echo "papersize letter" \
+	       >>$(top_builddir)/font/devpdf/DESC; \
 	   fi
 
-font/devpdf/Foundry:
-	$(AM_V_GEN)$(RM) $(top_builddir)/font/devpdf/Foundry \
-	&& sed "s|@urwfontsdir@|$(urwfontsdir)|" \
-	       $(devpdf_srcdir)/Foundry.in >$(top_builddir)/$@
-
-all: font/devpdf/build_font_files
-
-# PATH: path to find afmtodit. We add $(abs_top_builddir) because
-# afmtodit is built in the top builddir.
-font/devpdf/build_font_files: afmtodit font/devpdf/DESC \
-  $(devpdffontenc_DATA) $(devpdffontmap_DATA) $(devpdffont_DATA) \
+font/devpdf/Foundry: $(devpdf_srcdir)/Foundry.in
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/font/devpdf/
+if HAVE_URW_FONTS
+	$(AM_V_GEN)sed "s|@urwfontsdir@|$(urwfontsdir)|" \
+	  $(devpdf_srcdir)/Foundry.in >$@
+else
+	$(AM_V_GEN)sed "/BEGIN URW/,/END URW/d" \
+	  $(devpdf_srcdir)/Foundry.in >$@
+endif
+
+# This is kind of a cheat, but works because BuildFoundries produces so
+# many artifacts.
+$(DEFAULT_BASE35_FONTS) $(URW_BASE35_FONTS): font/devpdf/download
+
+MOSTLYCLEANFILES += font/devpdf/download
+font/devpdf/download: $(devpdffontmapdata) font/devpdf/DESC \
+  font/devpdf/Foundry font/devpdf/enc/text.enc \
   font/devpdf/util/BuildFoundries
-	@if $(AM_V_P); then \
-	  set -x; \
-	else \
-	  echo "  GEN      $(top_builddir)/font/devpdf/download"; \
-	fi \
-	&& $(RM) $@ \
-	&& $(MKDIR_P) $(top_builddir)/font/devpdf \
-	&& echo "# foundry	ps name	psfile" > $(top_builddir)/font/devpdf/download \
+	$(AM_V_GEN)$(MKDIR_P) $(top_builddir)/font/devpdf \
+	&& echo "# foundry	ps-font-name	ps-font-file" >$@.tmp \
+	&& echo "# A blank foundry is the default." >>$@.tmp \
 	&& PATH="$(abs_top_builddir)$(GROFF_PATH_SEPARATOR)$(abs_top_builddir)/build-aux$(GROFF_PATH_SEPARATOR)$(PATH)" \
 	     $(abs_top_builddir)/font/devpdf/util/BuildFoundries \
-	       $(abs_top_builddir)/font/devpdf \
-	       '$(abs_top_srcdir)/font/devps : $(abs_top_builddir)/font/devps' \
-	       >> $(top_builddir)/font/devpdf/download \
-	&& touch $@
+	       --strict $(abs_top_builddir)/font/devpdf \
+	       '$(abs_top_srcdir)/font/devps:$(abs_top_builddir)/font/devps' \
+	       >>$@.tmp \
+	&& mv $@.tmp $@
+
+# PDFs to be produced by troff should depend on this stamp file to
+# ensure that gropdf's device and font description files are available.
+MOSTLYCLEANFILES += font/devpdf/stamp
+font/devpdf/stamp: font/devpdf/DESC font/devpdf/download \
+  $(devpdffontenc_DATA) $(devpdffontmap_DATA) $(devpdffont_DATA)
+	$(AM_V_at)>$@
 
 mostlyclean-local: mostlyclean_devpdf_extra
 mostlyclean_devpdf_extra:
@@ -172,13 +178,33 @@
 	  rmdir $(DESTDIR)$(devpdffontdir); \
 	fi
 
+font_devpdf_default_test=\
+  $(devpdf_srcdir)/tests/check-default-foundry.sh.in
+font_devpdf_urw_test=$(devpdf_srcdir)/tests/check-urw-foundry.sh.in
+
+font/devpdf/tests/check-default-foundry.sh: $(font_devpdf_default_test)
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+	&& sed -e "s|@GHOSTSCRIPT@|$(GHOSTSCRIPT)|g" \
+	  $(font_devpdf_default_test) > $@ \
+	&& chmod +x $@
+
+font/devpdf/tests/check-urw-foundry.sh: $(font_devpdf_urw_test)
+	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+	&& sed -e "s|@urwfontsdir@|$(urwfontsdir)|g" \
+	  $(font_devpdf_urw_test) > $@ \
+	&& chmod +x $@
+
+font_devpdf_TESTS = \
+  font/devpdf/tests/check-default-foundry.sh \
+  font/devpdf/tests/check-urw-foundry.sh
+
+TESTS += $(font_devpdf_TESTS)
+MOSTLYCLEANFILES += $(font_devpdf_TESTS)
+EXTRA_DIST += $(font_devpdf_default_test) $(font_devpdf_urw_test)
+
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/tests/check-default-foundry.sh.in Added

@@ -0,0 +1,99 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+devpdf_fontbuilddir="${abs_top_builddir:-.}"/font/devpdf
+ghostscript=@GHOSTSCRIPT@
+
+wail () {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+fail=
+
+# The are the base 14 fonts required by the PDF standard.  They should
+# _always_ be present and supported.  If their corresponding Type 1 font
+# files are available, they too can be embedded in a PDF using gropdf's
+# "-e" option.  groff's "EURO" font is always available; we ship it.
+mandatory_fonts='CB
+CBI
+CI
+CR
+HB
+HBI
+HI
+HR
+S
+TB
+TBI
+TI
+TR
+ZD'
+
+# These fonts are commonly, but not universally, available; if used,
+# their corresponding Type 1 font files must be embedded in a document.
+#
+# Their groff font descriptions will always be available: we ship them.
+# But they are not usable with gropdf(1) if the Type 1 files are absent.
+# We thus will not test them if they are not expected to work.
+supplementary_fonts='AB
+ABI
+AI
+AR
+BMB
+BMBI
+BMI
+BMR
+HNB
+HNBI
+HNI
+HNR
+NB
+NBI
+NI
+NR
+PB
+PBI
+PI
+PR
+ZCMI'
+
+for f in $mandatory_fonts
+do
+    printf "checking for font description %s...\n" "$f" >&2
+    test -f "$devpdf_fontbuilddir"/"$f" || wail
+done
+
+if  "$ghostscript" = no  ||  "$ghostscript" = missing 
+then
+    echo "Ghostscript not available; skipping check for any further" \
+         "fonts in the default foundry" >&2
+    exit 77 # skip
+fi
+
+for f in $supplementary_fonts
+do
+    printf "checking for font description %s...\n" "$f" >&2
+    test -f "$devpdf_fontbuilddir"/"$f" || wail
+done
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/tests/check-urw-foundry.sh.in Added

@@ -0,0 +1,86 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+# Ensure that groff's PDF device has URW font descriptions it expects.
+# These are generated at build time by afmtodit(1) if a URW font
+# directory was discovered at configuration time.
+
+devpdf_fontbuilddir="${abs_top_builddir:-.}"/font/devpdf
+urwfontsdir=@urwfontsdir@
+
+if  -z "$urwfontsdir" 
+then
+    echo "URW fonts not found at configuration time; skipping" >&2
+    exit 77 # skip
+fi
+
+fonts='AB
+ABI
+AI
+AR
+BMB
+BMBI
+BMI
+BMR
+CB
+CBI
+CI
+CR
+HB
+HBI
+HI
+HNB
+HNBI
+HNI
+HNR
+HR
+NB
+NBI
+NI
+NR
+PB
+PBI
+PI
+PR
+S
+TB
+TBI
+TI
+TR
+ZCMI
+ZD'
+
+fail=
+
+for basefontname in $fonts
+do
+    f=U-$basefontname
+    printf "checking for font description %s...\n" $f >&2
+    if ! test -f "$devpdf_fontbuilddir"/$f
+    then
+        echo test -f "$devpdf_fontbuilddir"/$f
+        echo ...FAILED >&2
+        fail=yes
+    fi
+done
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devpdf/util/BuildFoundries.pl -> _service:tar_scm:groff-1.23.0.tar.gz/font/devpdf/util/BuildFoundries.pl Changed

@@ -1,10 +1,10 @@
-#!/usr/bin/perl -w
+#!/usr/bin/perl
 #
-#   BuildFoundries   : Given a Foundry file generate groff and download files
-#   Deri James       : Monday 07 Feb 2011
-
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
-#      Written by Deri James <deri@chuzzlewit.demon.co.uk>
+# BuildFoundries: Given a Foundry file, generate groff font description
+# files and a "download" file so gropdf can embed fonts in PDF output.
+#
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
+#      Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #
 # This file is part of groff.
 #
@@ -13,8 +13,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -22,21 +22,40 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 use strict;
+use Getopt::Long;
+use warnings;
+
+my $pathsep='@PATH_SEPARATOR@';
+
+my $check=0;
+my $dirURW='';
+my $beStrict=0;
+
+GetOptions("check" => \$check, "dirURW=s" => \$dirURW,
+	   "strict" => \$beStrict);
 
 (my $progname = $0) =~s @.*/@@;
 my $where=shift||'';
-my $devps=shift||'../devps';
+my @d=(split(':',shift||'../devps'));
+my $devps=\@d;
 chdir $where if $where ne '';
-my (%foundry,%flg,@downloadpreamble,%download);
+my (%flg,@downloadpreamble,%download);
 my $GSpath=FindGSpath();
-my $warn=0;
 my $lct=0;
 my $foundry='';	# the default foundry
+my $notFoundFont=0;
 
-LoadDownload("download");
-LoadFoundry("Foundry");
-WriteDownload("download");
-
+if ($check)
+{
+    CheckFoundry("Foundry.in");
+    exit $notFoundFont;
+}
+else
+{
+    LoadDownload("download"); # not required
+    LoadFoundry("Foundry");
+    WriteDownload();
+}
 exit 0;
 
 
@@ -44,10 +63,10 @@
 sub LoadFoundry
 {
     my $fn=shift;
-    my $foundrypath='';
-    my $notFoundFont=0;
+    my $foundrypath;
+    $notFoundFont=0;
 
-    open(F,"<$fn") or Die("No $fn file found");
+    open(F,"<$fn") or Die("file '$fn' not found or not readable");
 
     while (<F>)
     {
@@ -70,10 +89,19 @@
 
 	if (lc($r0) eq 'foundry')
 	{
-	    Warn("\nThe path(s) used for searching:\n$foundrypath\n") if $notFoundFont;
+	    Warn("\nThe path(s) used for searching:\n".join(':',@{$foundrypath})."\n") if $notFoundFont;
 	    $foundry=uc($r1);
-	    $foundrypath=$r2.' : '.$devps;
-	    $foundrypath=~s/$gs$/$GSpath /;
+	    $foundrypath=;
+	    push(@{$foundrypath},$dirURW) if $dirURW;
+	    push(@{$foundrypath},(split(':',$r2)),@{$devps});
+	    foreach my $j (0..$#{$foundrypath})
+	    {
+		if (defined($foundrypath->$j)
+		    && $foundrypath->$j=~m'\s*$gs$')
+		{
+		    splice(@{$foundrypath},$j,1,@{$GSpath});
+		}
+	    }
 	    $notFoundFont=0;
 	}
 	else
@@ -84,38 +112,36 @@
 	    # 3=map file
 	    # 4=encoding file
 	    # 5=font file
-	    # 6=afm file
-
-	    if (!defined($r6) or $r6 eq '')
-	    {
-		# if no afm file, have a guess!
-		$r6=substr($r5,0,-3)."afm";
-	    }
 
 	    my $gfont=($foundry eq '')?$r0:"$foundry-$r0";
 
 	    if ($r2 eq '')
 	    {
-		# Don't run afmtodit, just copy the grops font file
-
+		# Don't run afmtodit; just copy the groff font
+		# description file for grops.
 		my $gotf=1;
 		my $gropsfnt=LocateFile($devps,$r0,0);
-
 		if ($gropsfnt ne '' and -r "$gropsfnt")
 		{
 		    my $psfont=UseGropsVersion($gropsfnt);
-		    if (!PutDownload($psfont,LocatePF($foundrypath,$r5),uc($r1)))
+		    # To be embeddable in PDF, the font file name itself
+		    # needs to be located and written to "download".
+		    if (!PutDownload($psfont,
+				     LocatePF($foundrypath,$r5),
+					      uc($r1)))
 		    {
 			if (uc($r1) ne 'Y')
 			{
 			    $gotf=0;
-			    my $fns=join(',',split('!',$r5));
-			    Warn("Unable to locate font(s) $fns");
+			    my $fns=join(', ',split('!',$r5));
+			    Warn("groff font '$gfont' will not be"
+				 . " available for PDF output; unable"
+				 . " to locate font file(s): $fns");
 			    $notFoundFont=1;
-			    unlink $gfont;	# Unable to find the postscript file for the font just created by afmtodit
+			    unlink $gfont;
 			}
 		    }
-		    Notice("Copied grops font $gfont...") if $gotf;
+		    Notice("copied grops font $gfont") if $gotf;
 
 		}
 		else
@@ -125,8 +151,15 @@
 	    }
 	    else
 	    {
-		# We need to run afmtodit to create this groff font
-		my $psfont=RunAfmtodit($gfont,LocateAF($foundrypath,$r6),$r2,$r3,$r4);
+		# Use afmtodit to create a groff font description file.
+		my $afmfile=LocateAF($foundrypath,$r5);
+		if (!$afmfile) {
+		    my $sub=\&Warn;
+		    $sub=\&Die if ($beStrict);
+		    &$sub("cannot locate AFM file for font '$gfont'");
+		    next;
+		}
+		my $psfont=RunAfmtodit($gfont,$afmfile,$r2,$r3,$r4);
 
 		if ($psfont)
 		{
@@ -136,7 +169,7 @@
 		    }
 		    else
 		    {
-			Notice("Generated $gfont...");
+			Notice("generated $gfont");
 		    }
 		}
 		else
@@ -148,8 +181,8 @@
 	}
     }
 
-    close();
-    Warn("\nThe path(s) used for searching:\n$foundrypath\n") if $notFoundFont;
+    close(F);
+    Warn("\nThe path(s) used for searching:\n".join(':',@{$foundrypath})."\n") if $notFoundFont;
 }
 
 sub RunAfmtodit
@@ -177,7 +210,7 @@
 	$cmd.=" $flg{$f}";
     }
 
-    system("$cmd $enc '$afmfile' $map $gfont 2>/dev/null");
+    system("$cmd $enc '$afmfile' $map $gfont");
 
     if ($?)
     {
@@ -228,59 +261,69 @@
     my $tryafm=shift;
     return(substr($files,1)) if substr($files,0,1) eq '*';
 
-    foreach my $file (split('!',$files))
+    foreach my $p (@{$path})
     {
-    if ($file=~m'/')
-    {
-	# path given with file name so no need to search the paths
-
-	if (-r $file)
-	{
-	    return($file);
-	}
-
-	if ($tryafm and $file=~s'type1/'afm/'i)
-	{
-	    if (-r "$file")
-	    {
-		return($file);
-	    }
-	}
-
-	return('');
-    }
-
-	if ($path eq '(tex)')
-    {
-	my $res=`kpsewhich $file`;
-	return '' if $?;
-	chomp($res);
-	return($res);
-    }
-
-	my (@paths)=split(/ (:|;)/,$path);
-
-    foreach my $p (@paths)
-    {
-	    next if !defined($p) or $p eq ';' or $p eq ':';
-	$p=~s/^\s+//;
-	$p=~s/\s+$//;
-
-	next if $p=~m/^\%rom\%/;	# exclude %rom% paths (from (gs))
-
-	if (-r "$p/$file")
-	{
-	    return("$p/$file");
-	}
-
-	if ($tryafm and $p=~s'type1/'afm/'i)
-	{
-	    if (-r "$p/$file")
-	    {
-		return("$p/$file");
-	    }
-	}
-    }
+        next if !defined($p) or $p eq ';' or $p eq ':';
+        $p=~s/^\s+//;
+        $p=~s/\s+$//;
+        $p=~s@/+$@@;
+
+        next if $p=~m/^\%rom\%/;	# exclude %rom% paths (from (gs))
+
+        foreach my $file (reverse(split('!',$files)))
+        {
+            if ($tryafm)
+            {
+                if (!($file=~s/\..+$/.afm/))
+                {
+                    # no extenaion
+                    $file.='.afm';
+                }
+            }
+
+            if ($file=~m'/')
+            {
+                # path given with file name so no need to search the paths
+
+                if (-r $file)
+                {
+                    return($file);
+                }
+
+                if ($tryafm and $file=~s'type1/'afm/'i)
+                {
+                    if (-r "$file")
+                    {
+                        return($file);
+                    }
+                }
+
+                return('');
+            }
+
+            if ($path eq '(tex)')
+            {
+                my $res=`kpsewhich $file`;
+                return '' if $?;
+                chomp($res);
+                return($res);
+            }
+
+            if (-r "$p/$file")
+            {
+                return("$p/$file");
+            }
+
+            my $ap=$p;
+
+            if ($tryafm and $ap=~s'type1/'afm/'i)
+            {
+                if (-r "$ap/$file")
+                {
+                    return("$ap/$file");
+                }
+            }
+        }
     }
 
     return('');
@@ -288,9 +331,9 @@
 
 sub FindGSpath
 {
-    my (@res)=`@GROFF_GHOSTSCRIPT_INTERPRETERS@ -h 2>/dev/null`;
-    return '' if $?;
-    my $buildpath='';
+    my (@res)=`@GHOSTSCRIPT@ -h 2>/dev/null`;
+    return  if $?;
+    my $buildpath=;
     my $stg=1;
 
     foreach my $l (@res)
@@ -310,7 +353,8 @@
 	    else
 	    {
 		$l=~s/^\s+//;
-		$buildpath.=$l;
+                $pathsep=';' if substr($l,-1) eq ';';
+                push(@{$buildpath},(split("$pathsep",$l)));
 	    }
 	}
     }
@@ -388,7 +432,6 @@
 sub LoadDownload
 {
     my $fn=shift;
-    my $top=1;
 
     return if !open(F,"<$fn");
 
@@ -397,7 +440,7 @@
 	chomp;
 	s/\r$//;	# in case edited in windows
 
-	if ($top and substr($_,0,1) eq '#' or $_ eq '')
+	if (substr($_,0,1) eq '#' or $_ eq '')
 	{
 	    # Preserve comments at top of download file
 
@@ -405,7 +448,6 @@
 	    next;
 	}
 
-	$top=0;
 	s/\s*#.*?$//;	# remove comments
 
 	next if $_ eq '';
@@ -421,20 +463,13 @@
 
 sub WriteDownload
 {
-    my $fn=shift;
-    my $top=1;
-
-    open(F,">$fn") or Die("Can't Create new file '$fn'");
-
-    print F join("\n",@downloadpreamble),"\n";
+    print join("\n",@downloadpreamble),"\n";
 
     foreach my $k (sort keys %download)
     {
 	my ($f,$ps)=split(/ /,$k);
-	print F "$f\t$ps\t$download{$k}\n";
+	print "$f\t$ps\t$download{$k}\n";
     }
-
-    close(F);
 }
 
 sub Notice {
@@ -445,12 +480,11 @@
 sub Warn {
     my $msg=shift;
     Msg("warning: line $lct: $msg");
-    $warn=1;
 }
 
 sub Die {
     my $msg=shift;
-    Msg("error: line $lct: $msg");
+    Msg("error: $msg");
     exit 2;
 }
 
@@ -458,3 +492,87 @@
     my $msg=shift;
     print STDERR "$progname: $msg\n";
 }
+
+sub CheckFoundry
+{
+    my $fn=shift;
+    my $foundrypath=;
+    $notFoundFont=0;
+
+    open(F,"<$fn") or Die("file '$fn' not found or not readable");
+
+    while (<F>)
+    {
+	chomp;
+	s/\r$//;	# in case edited in windows
+
+	s/\s*#.*?$//;	# remove comments
+
+	next if $_ eq '';
+
+	if (m/^A-Za-z=/)
+	{
+	    next;
+	}
+
+	my (@r)=split('\|');
+
+	if (lc($r0) eq 'foundry')
+	{
+	    $foundry=uc($r1);
+	    $foundrypath=;
+	    push(@{$foundrypath},$dirURW) if $dirURW;
+	    push(@{$foundrypath},(split(':',$r2)),$devps);
+	    foreach my $j (0..$#{$foundrypath})
+	    {
+		if ($foundrypath->$j=~m'\s*$gs$')
+		{
+		    splice(@{$foundrypath},$j,1,@{$GSpath});
+		}
+	    }
+	    $notFoundFont=0;
+	}
+	else
+	{
+	    # 0=groff font name
+	    # 1=IsBase Y/N (one of PDFs 14 base fonts)
+	    # 2=afmtodit flag
+	    # 3=map file
+	    # 4=encoding file
+	    # 5=font file
+
+	    my $gfont=($foundry eq '')?$r0:"$foundry-$r0";
+
+	    if ($r2 eq '')
+	    {
+		# Don't run afmtodit, just copy the grops font file
+
+		my $gotf=1;
+		my $gropsfnt=LocateFile($devps,$r0,0);
+
+		if ($gropsfnt ne '' and -r "$gropsfnt")
+		{
+
+		}
+		else
+		{
+                    $notFoundFont|=1;
+		}
+	    }
+	    else
+	    {
+		# We need to run afmtodit to create this groff font
+		$notFoundFont|=2 if !LocateAF($foundrypath,$r5);
+		$notFoundFont|=1 if !LocatePF($foundrypath,$r5);
+	    }
+	}
+    }
+
+    close(F);
+}
+
+# Local Variables:
+# fill-column: 72
+# mode: CPerl
+# End:
+# vim: set cindent noexpandtab shiftwidth=4 softtabstop=4 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/AB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/AB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/ABI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/ABI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/AI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/AI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/AR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/AR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/BMB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/BMB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/BMBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/BMBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/BMI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/BMI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/BMR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/BMR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/EURO -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/EURO Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HB Changed

@@ -269,6 +269,7 @@
 D :Y -70
 D , -30
 D . -30
+D u2026 -30
 F A -80
 F 'A -80
 F ^A -80
@@ -285,6 +286,7 @@
 F ~a -20
 F , -100
 F . -100
+F u2026 -100
 J A -20
 J 'A -20
 J ^A -20
@@ -294,6 +296,7 @@
 J ~A -20
 J , -20
 J . -20
+J u2026 -20
 J u -20
 J 'u -20
 J ^u -20
@@ -366,6 +369,7 @@
 O :Y -70
 O , -40
 O . -40
+O u2026 -40
 'O A -50
 'O 'A -50
 'O ^A -50
@@ -382,6 +386,7 @@
 'O :Y -70
 'O , -40
 'O . -40
+'O u2026 -40
 ^O A -50
 ^O 'A -50
 ^O ^A -50
@@ -398,6 +403,7 @@
 ^O :Y -70
 ^O , -40
 ^O . -40
+^O u2026 -40
 :O A -50
 :O 'A -50
 :O ^A -50
@@ -414,6 +420,7 @@
 :O :Y -70
 :O , -40
 :O . -40
+:O u2026 -40
 `O A -50
 `O 'A -50
 `O ^A -50
@@ -430,6 +437,7 @@
 `O :Y -70
 `O , -40
 `O . -40
+`O u2026 -40
 /O A -50
 /O 'A -50
 /O ^A -50
@@ -446,6 +454,7 @@
 /O :Y -70
 /O , -40
 /O . -40
+/O u2026 -40
 ~O A -50
 ~O 'A -50
 ~O ^A -50
@@ -462,6 +471,7 @@
 ~O :Y -70
 ~O , -40
 ~O . -40
+~O u2026 -40
 P A -100
 P 'A -100
 P ^A -100
@@ -490,6 +500,7 @@
 P /o -40
 P ~o -40
 P . -120
+P u2026 -120
 Q U -10
 Q 'U -10
 Q ^U -10
@@ -497,6 +508,7 @@
 Q `U -10
 Q , 20
 Q . 20
+Q u2026 20
 R O -20
 R 'O -20
 R ^O -20
@@ -553,6 +565,7 @@
 T /o -80
 T ~o -80
 T . -80
+T u2026 -80
 T r -80
 T ; -40
 T u -90
@@ -573,6 +586,7 @@
 U ~A -50
 U , -30
 U . -30
+U u2026 -30
 'U A -50
 'U 'A -50
 'U ^A -50
@@ -582,6 +596,7 @@
 'U ~A -50
 'U , -30
 'U . -30
+'U u2026 -30
 ^U A -50
 ^U 'A -50
 ^U ^A -50
@@ -591,6 +606,7 @@
 ^U ~A -50
 ^U , -30
 ^U . -30
+^U u2026 -30
 :U A -50
 :U 'A -50
 :U ^A -50
@@ -600,6 +616,7 @@
 :U ~A -50
 :U , -30
 :U . -30
+:U u2026 -30
 `U A -50
 `U 'A -50
 `U ^A -50
@@ -609,6 +626,7 @@
 `U ~A -50
 `U , -30
 `U . -30
+`U u2026 -30
 V A -80
 V 'A -80
 V ^A -80
@@ -648,6 +666,7 @@
 V /o -90
 V ~o -90
 V . -120
+V u2026 -120
 V ; -40
 V u -60
 V 'u -60
@@ -692,6 +711,7 @@
 W /o -60
 W ~o -60
 W . -80
+W u2026 -80
 W ; -10
 W u -45
 W 'u -45
@@ -737,6 +757,7 @@
 Y /o -100
 Y ~o -100
 Y . -100
+Y u2026 -100
 Y ; -50
 Y u -100
 Y 'u -100
@@ -779,6 +800,7 @@
 'Y /o -100
 'Y ~o -100
 'Y . -100
+'Y u2026 -100
 'Y ; -50
 'Y u -100
 'Y 'u -100
@@ -821,6 +843,7 @@
 :Y /o -100
 :Y ~o -100
 :Y . -100
+:Y u2026 -100
 :Y ; -50
 :Y u -100
 :Y 'u -100
@@ -907,6 +930,7 @@
 d :y -15
 e , 10
 e . 20
+e u2026 20
 e v -15
 e w -15
 e x -15
@@ -915,6 +939,7 @@
 e :y -15
 'e , 10
 'e . 20
+'e u2026 20
 'e v -15
 'e w -15
 'e x -15
@@ -923,6 +948,7 @@
 'e :y -15
 ^e , 10
 ^e . 20
+^e u2026 20
 ^e v -15
 ^e w -15
 ^e x -15
@@ -931,6 +957,7 @@
 ^e :y -15
 :e , 10
 :e . 20
+:e u2026 20
 :e v -15
 :e w -15
 :e x -15
@@ -939,6 +966,7 @@
 :e :y -15
 `e , 10
 `e . 20
+`e u2026 20
 `e v -15
 `e w -15
 `e x -15
@@ -959,6 +987,7 @@
 f /o -20
 f ~o -20
 f . -10
+f u2026 -10
 f rq 30
 f ' 30
 f cq 30
@@ -1058,9 +1087,13 @@
 p 'y -15
 p :y -15
 . rq -120
+u2026 rq -120
 . ' -120
+u2026 ' -120
 . cq -120
+u2026 cq -120
 . u0020 -40
+u2026 u0020 -40
 rq u0020 -80
 ` ` -46
 ` oq -46
@@ -1101,6 +1134,7 @@
 r /o -20
 r ~o -20
 r . -60
+r u2026 -60
 r q -20
 r s -15
 r vs -15
@@ -1137,6 +1171,7 @@
 v /o -30
 v ~o -30
 v . -80
+v u2026 -80
 w , -40
 w o -20
 w 'o -20
@@ -1146,6 +1181,7 @@
 w /o -20
 w ~o -20
 w . -40
+w u2026 -40
 x e -10
 x 'e -10
 x ^e -10
@@ -1172,6 +1208,7 @@
 y /o -25
 y ~o -25
 y . -80
+y u2026 -80
 'y a -30
 'y 'a -30
 'y ^a -30
@@ -1193,6 +1230,7 @@
 'y /o -25
 'y ~o -25
 'y . -80
+'y u2026 -80
 :y a -30
 :y 'a -30
 :y ^a -30
@@ -1214,6 +1252,7 @@
 :y /o -25
 :y ~o -25
 :y . -80
+:y u2026 -80
 z e 10
 z 'e 10
 z ^e 10

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HBI Changed

@@ -270,6 +270,7 @@
 D :Y -70
 D , -30
 D . -30
+D u2026 -30
 F A -80
 F 'A -80
 F ^A -80
@@ -286,6 +287,7 @@
 F ~a -20
 F , -100
 F . -100
+F u2026 -100
 J A -20
 J 'A -20
 J ^A -20
@@ -295,6 +297,7 @@
 J ~A -20
 J , -20
 J . -20
+J u2026 -20
 J u -20
 J 'u -20
 J ^u -20
@@ -367,6 +370,7 @@
 O :Y -70
 O , -40
 O . -40
+O u2026 -40
 'O A -50
 'O 'A -50
 'O ^A -50
@@ -383,6 +387,7 @@
 'O :Y -70
 'O , -40
 'O . -40
+'O u2026 -40
 ^O A -50
 ^O 'A -50
 ^O ^A -50
@@ -399,6 +404,7 @@
 ^O :Y -70
 ^O , -40
 ^O . -40
+^O u2026 -40
 :O A -50
 :O 'A -50
 :O ^A -50
@@ -415,6 +421,7 @@
 :O :Y -70
 :O , -40
 :O . -40
+:O u2026 -40
 `O A -50
 `O 'A -50
 `O ^A -50
@@ -431,6 +438,7 @@
 `O :Y -70
 `O , -40
 `O . -40
+`O u2026 -40
 /O A -50
 /O 'A -50
 /O ^A -50
@@ -447,6 +455,7 @@
 /O :Y -70
 /O , -40
 /O . -40
+/O u2026 -40
 ~O A -50
 ~O 'A -50
 ~O ^A -50
@@ -463,6 +472,7 @@
 ~O :Y -70
 ~O , -40
 ~O . -40
+~O u2026 -40
 P A -100
 P 'A -100
 P ^A -100
@@ -491,6 +501,7 @@
 P /o -40
 P ~o -40
 P . -120
+P u2026 -120
 Q U -10
 Q 'U -10
 Q ^U -10
@@ -498,6 +509,7 @@
 Q `U -10
 Q , 20
 Q . 20
+Q u2026 20
 R O -20
 R 'O -20
 R ^O -20
@@ -554,6 +566,7 @@
 T /o -80
 T ~o -80
 T . -80
+T u2026 -80
 T r -80
 T ; -40
 T u -90
@@ -574,6 +587,7 @@
 U ~A -50
 U , -30
 U . -30
+U u2026 -30
 'U A -50
 'U 'A -50
 'U ^A -50
@@ -583,6 +597,7 @@
 'U ~A -50
 'U , -30
 'U . -30
+'U u2026 -30
 ^U A -50
 ^U 'A -50
 ^U ^A -50
@@ -592,6 +607,7 @@
 ^U ~A -50
 ^U , -30
 ^U . -30
+^U u2026 -30
 :U A -50
 :U 'A -50
 :U ^A -50
@@ -601,6 +617,7 @@
 :U ~A -50
 :U , -30
 :U . -30
+:U u2026 -30
 `U A -50
 `U 'A -50
 `U ^A -50
@@ -610,6 +627,7 @@
 `U ~A -50
 `U , -30
 `U . -30
+`U u2026 -30
 V A -80
 V 'A -80
 V ^A -80
@@ -649,6 +667,7 @@
 V /o -90
 V ~o -90
 V . -120
+V u2026 -120
 V ; -40
 V u -60
 V 'u -60
@@ -693,6 +712,7 @@
 W /o -60
 W ~o -60
 W . -80
+W u2026 -80
 W ; -10
 W u -45
 W 'u -45
@@ -738,6 +758,7 @@
 Y /o -100
 Y ~o -100
 Y . -100
+Y u2026 -100
 Y ; -50
 Y u -100
 Y 'u -100
@@ -780,6 +801,7 @@
 'Y /o -100
 'Y ~o -100
 'Y . -100
+'Y u2026 -100
 'Y ; -50
 'Y u -100
 'Y 'u -100
@@ -822,6 +844,7 @@
 :Y /o -100
 :Y ~o -100
 :Y . -100
+:Y u2026 -100
 :Y ; -50
 :Y u -100
 :Y 'u -100
@@ -908,6 +931,7 @@
 d :y -15
 e , 10
 e . 20
+e u2026 20
 e v -15
 e w -15
 e x -15
@@ -916,6 +940,7 @@
 e :y -15
 'e , 10
 'e . 20
+'e u2026 20
 'e v -15
 'e w -15
 'e x -15
@@ -924,6 +949,7 @@
 'e :y -15
 ^e , 10
 ^e . 20
+^e u2026 20
 ^e v -15
 ^e w -15
 ^e x -15
@@ -932,6 +958,7 @@
 ^e :y -15
 :e , 10
 :e . 20
+:e u2026 20
 :e v -15
 :e w -15
 :e x -15
@@ -940,6 +967,7 @@
 :e :y -15
 `e , 10
 `e . 20
+`e u2026 20
 `e v -15
 `e w -15
 `e x -15
@@ -960,6 +988,7 @@
 f /o -20
 f ~o -20
 f . -10
+f u2026 -10
 f rq 30
 f ' 30
 f cq 30
@@ -1059,9 +1088,13 @@
 p 'y -15
 p :y -15
 . rq -120
+u2026 rq -120
 . ' -120
+u2026 ' -120
 . cq -120
+u2026 cq -120
 . u0020 -40
+u2026 u0020 -40
 rq u0020 -80
 ` ` -46
 ` oq -46
@@ -1102,6 +1135,7 @@
 r /o -20
 r ~o -20
 r . -60
+r u2026 -60
 r q -20
 r s -15
 r vs -15
@@ -1138,6 +1172,7 @@
 v /o -30
 v ~o -30
 v . -80
+v u2026 -80
 w , -40
 w o -20
 w 'o -20
@@ -1147,6 +1182,7 @@
 w /o -20
 w ~o -20
 w . -40
+w u2026 -40
 x e -10
 x 'e -10
 x ^e -10
@@ -1173,6 +1209,7 @@
 y /o -25
 y ~o -25
 y . -80
+y u2026 -80
 'y a -30
 'y 'a -30
 'y ^a -30
@@ -1194,6 +1231,7 @@
 'y /o -25
 'y ~o -25
 'y . -80
+'y u2026 -80
 :y a -30
 :y 'a -30
 :y ^a -30
@@ -1215,6 +1253,7 @@
 :y /o -25
 :y ~o -25
 :y . -80
+:y u2026 -80
 z e 10
 z 'e 10
 z ^e 10

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HI Changed

@@ -251,10 +251,13 @@
 B `U -10
 B , -20
 B . -20
+B u2026 -20
 C , -30
 C . -30
+C u2026 -30
 ,C , -30
 ,C . -30
+,C u2026 -30
 D A -40
 D 'A -40
 D ^A -40
@@ -269,6 +272,7 @@
 D :Y -90
 D , -70
 D . -70
+D u2026 -70
 F A -80
 F 'A -80
 F ^A -80
@@ -297,6 +301,7 @@
 F /o -30
 F ~o -30
 F . -150
+F u2026 -150
 F r -45
 J A -20
 J 'A -20
@@ -314,6 +319,7 @@
 J ~a -20
 J , -30
 J . -30
+J u2026 -30
 J u -20
 J 'u -20
 J ^u -20
@@ -386,6 +392,7 @@
 O :Y -70
 O , -40
 O . -40
+O u2026 -40
 'O A -20
 'O 'A -20
 'O ^A -20
@@ -402,6 +409,7 @@
 'O :Y -70
 'O , -40
 'O . -40
+'O u2026 -40
 ^O A -20
 ^O 'A -20
 ^O ^A -20
@@ -418,6 +426,7 @@
 ^O :Y -70
 ^O , -40
 ^O . -40
+^O u2026 -40
 :O A -20
 :O 'A -20
 :O ^A -20
@@ -434,6 +443,7 @@
 :O :Y -70
 :O , -40
 :O . -40
+:O u2026 -40
 `O A -20
 `O 'A -20
 `O ^A -20
@@ -450,6 +460,7 @@
 `O :Y -70
 `O , -40
 `O . -40
+`O u2026 -40
 /O A -20
 /O 'A -20
 /O ^A -20
@@ -466,6 +477,7 @@
 /O :Y -70
 /O , -40
 /O . -40
+/O u2026 -40
 ~O A -20
 ~O 'A -20
 ~O ^A -20
@@ -482,6 +494,7 @@
 ~O :Y -70
 ~O , -40
 ~O . -40
+~O u2026 -40
 P A -120
 P 'A -120
 P ^A -120
@@ -510,6 +523,7 @@
 P /o -50
 P ~o -50
 P . -180
+P u2026 -180
 Q U -10
 Q 'U -10
 Q ^U -10
@@ -535,8 +549,10 @@
 R :Y -50
 S , -20
 S . -20
+S u2026 -20
 vS , -20
 vS . -20
+vS u2026 -20
 T A -120
 T 'A -120
 T ^A -120
@@ -575,6 +591,7 @@
 T /o -120
 T ~o -60
 T . -120
+T u2026 -120
 T r -120
 T ; -20
 T u -120
@@ -595,6 +612,7 @@
 U ~A -40
 U , -40
 U . -40
+U u2026 -40
 'U A -40
 'U 'A -40
 'U ^A -40
@@ -604,6 +622,7 @@
 'U ~A -40
 'U , -40
 'U . -40
+'U u2026 -40
 ^U A -40
 ^U 'A -40
 ^U ^A -40
@@ -613,6 +632,7 @@
 ^U ~A -40
 ^U , -40
 ^U . -40
+^U u2026 -40
 :U A -40
 :U 'A -40
 :U ^A -40
@@ -622,6 +642,7 @@
 :U ~A -40
 :U , -40
 :U . -40
+:U u2026 -40
 `U A -40
 `U 'A -40
 `U ^A -40
@@ -631,6 +652,7 @@
 `U ~A -40
 `U , -40
 `U . -40
+`U u2026 -40
 V A -80
 V 'A -80
 V ^A -80
@@ -670,6 +692,7 @@
 V /o -80
 V ~o -80
 V . -125
+V u2026 -125
 V ; -40
 V u -70
 V 'u -70
@@ -713,6 +736,7 @@
 W /o -30
 W ~o -30
 W . -80
+W u2026 -80
 W u -30
 W 'u -30
 W ^u -30
@@ -761,6 +785,7 @@
 Y /o -140
 Y ~o -140
 Y . -140
+Y u2026 -140
 Y ; -60
 Y u -110
 Y 'u -110
@@ -807,6 +832,7 @@
 'Y /o -140
 'Y ~o -140
 'Y . -140
+'Y u2026 -140
 'Y ; -60
 'Y u -110
 'Y 'u -110
@@ -853,6 +879,7 @@
 :Y /o -140
 :Y ~o -140
 :Y . -140
+:Y u2026 -140
 :Y ; -60
 :Y u -110
 :Y 'u -110
@@ -899,6 +926,7 @@
 b l -20
 b /l -20
 b . -40
+b u2026 -40
 b u -20
 b 'u -20
 b ^u -20
@@ -918,6 +946,7 @@
 , cq -100
 e , -15
 e . -15
+e u2026 -15
 e v -30
 e w -20
 e x -30
@@ -926,6 +955,7 @@
 e :y -20
 'e , -15
 'e . -15
+'e u2026 -15
 'e v -30
 'e w -20
 'e x -30
@@ -934,6 +964,7 @@
 'e :y -20
 ^e , -15
 ^e . -15
+^e u2026 -15
 ^e v -30
 ^e w -20
 ^e x -30
@@ -942,6 +973,7 @@
 ^e :y -20
 :e , -15
 :e . -15
+:e u2026 -15
 :e v -30
 :e w -20
 :e x -30
@@ -950,6 +982,7 @@
 :e :y -20
 `e , -15
 `e . -15
+`e u2026 -15
 `e v -30
 `e w -20
 `e x -30
@@ -978,6 +1011,7 @@
 f /o -30
 f ~o -30
 f . -30
+f u2026 -30
 f rq 60
 f ' 50
 f cq 50
@@ -1025,6 +1059,7 @@
 ~n :y -15
 o , -40
 o . -40
+o u2026 -40
 o v -15
 o w -15
 o x -30
@@ -1033,6 +1068,7 @@
 o :y -30
 'o , -40
 'o . -40
+'o u2026 -40
 'o v -15
 'o w -15
 'o x -30
@@ -1041,6 +1077,7 @@
 'o :y -30
 ^o , -40
 ^o . -40
+^o u2026 -40
 ^o v -15
 ^o w -15
 ^o x -30
@@ -1049,6 +1086,7 @@
 ^o :y -30
 :o , -40
 :o . -40
+:o u2026 -40
 :o v -15
 :o w -15
 :o x -30
@@ -1057,6 +1095,7 @@
 :o :y -30
 `o , -40
 `o . -40
+`o u2026 -40
 `o v -15
 `o w -15
 `o x -30
@@ -1104,6 +1143,7 @@
 /o ~o -55
 /o p -55
 /o . -95
+/o u2026 -95
 /o q -55
 /o r -55
 /o s -55
@@ -1124,6 +1164,7 @@
 /o vz -55
 ~o , -40
 ~o . -40
+~o u2026 -40
 ~o v -15
 ~o w -15
 ~o x -30
@@ -1132,13 +1173,18 @@
 ~o :y -30
 p , -35
 p . -35
+p u2026 -35
 p y -30
 p 'y -30
 p :y -30
 . rq -100
+u2026 rq -100
 . ' -100
+u2026 ' -100
 . cq -100
+u2026 cq -100
 . u0020 -60
+u2026 u0020 -60
 rq u0020 -40
 ` ` -57
 ` oq -57
@@ -1180,6 +1226,7 @@
 r ~n 25
 r p 30
 r . -50
+r u2026 -50
 r ; 30
 r t 40
 r u 15
@@ -1193,9 +1240,11 @@
 r :y 30
 s , -15
 s . -15
+s u2026 -15
 s w -30
 vs , -15
 vs . -15
+vs u2026 -15
 vs w -30
 ; u0020 -50
 u0020 T -50
@@ -1228,6 +1277,7 @@
 v /o -25
 v ~o -25
 v . -80
+v u2026 -80
 w a -15
 w 'a -15
 w ^a -15
@@ -1249,6 +1299,7 @@
 w /o -10
 w ~o -10
 w . -60
+w u2026 -60
 x e -30
 x 'e -30
 x ^e -30
@@ -1275,6 +1326,7 @@
 y /o -20
 y ~o -20
 y . -100
+y u2026 -100
 'y a -20
 'y 'a -20
 'y ^a -20
@@ -1296,6 +1348,7 @@
 'y /o -20
 'y ~o -20
 'y . -100
+'y u2026 -100
 :y a -20
 :y 'a -20
 :y ^a -20
@@ -1317,6 +1370,7 @@
 :y /o -20
 :y ~o -20
 :y . -100
+:y u2026 -100
 z e -15
 z 'e -15
 z ^e -15

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HNB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HNB Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HNBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HNBI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HNI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HNI Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HNR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HNR Changed

@@ -250,10 +250,13 @@
 B `U -10
 B , -20
 B . -20
+B u2026 -20
 C , -30
 C . -30
+C u2026 -30
 ,C , -30
 ,C . -30
+,C u2026 -30
 D A -40
 D 'A -40
 D ^A -40
@@ -268,6 +271,7 @@
 D :Y -90
 D , -70
 D . -70
+D u2026 -70
 F A -80
 F 'A -80
 F ^A -80
@@ -296,6 +300,7 @@
 F /o -30
 F ~o -30
 F . -150
+F u2026 -150
 F r -45
 J A -20
 J 'A -20
@@ -313,6 +318,7 @@
 J ~a -20
 J , -30
 J . -30
+J u2026 -30
 J u -20
 J 'u -20
 J ^u -20
@@ -385,6 +391,7 @@
 O :Y -70
 O , -40
 O . -40
+O u2026 -40
 'O A -20
 'O 'A -20
 'O ^A -20
@@ -401,6 +408,7 @@
 'O :Y -70
 'O , -40
 'O . -40
+'O u2026 -40
 ^O A -20
 ^O 'A -20
 ^O ^A -20
@@ -417,6 +425,7 @@
 ^O :Y -70
 ^O , -40
 ^O . -40
+^O u2026 -40
 :O A -20
 :O 'A -20
 :O ^A -20
@@ -433,6 +442,7 @@
 :O :Y -70
 :O , -40
 :O . -40
+:O u2026 -40
 `O A -20
 `O 'A -20
 `O ^A -20
@@ -449,6 +459,7 @@
 `O :Y -70
 `O , -40
 `O . -40
+`O u2026 -40
 /O A -20
 /O 'A -20
 /O ^A -20
@@ -465,6 +476,7 @@
 /O :Y -70
 /O , -40
 /O . -40
+/O u2026 -40
 ~O A -20
 ~O 'A -20
 ~O ^A -20
@@ -481,6 +493,7 @@
 ~O :Y -70
 ~O , -40
 ~O . -40
+~O u2026 -40
 P A -120
 P 'A -120
 P ^A -120
@@ -509,6 +522,7 @@
 P /o -50
 P ~o -50
 P . -180
+P u2026 -180
 Q U -10
 Q 'U -10
 Q ^U -10
@@ -534,8 +548,10 @@
 R :Y -50
 S , -20
 S . -20
+S u2026 -20
 vS , -20
 vS . -20
+vS u2026 -20
 T A -120
 T 'A -120
 T ^A -120
@@ -574,6 +590,7 @@
 T /o -120
 T ~o -60
 T . -120
+T u2026 -120
 T r -120
 T ; -20
 T u -120
@@ -594,6 +611,7 @@
 U ~A -40
 U , -40
 U . -40
+U u2026 -40
 'U A -40
 'U 'A -40
 'U ^A -40
@@ -603,6 +621,7 @@
 'U ~A -40
 'U , -40
 'U . -40
+'U u2026 -40
 ^U A -40
 ^U 'A -40
 ^U ^A -40
@@ -612,6 +631,7 @@
 ^U ~A -40
 ^U , -40
 ^U . -40
+^U u2026 -40
 :U A -40
 :U 'A -40
 :U ^A -40
@@ -621,6 +641,7 @@
 :U ~A -40
 :U , -40
 :U . -40
+:U u2026 -40
 `U A -40
 `U 'A -40
 `U ^A -40
@@ -630,6 +651,7 @@
 `U ~A -40
 `U , -40
 `U . -40
+`U u2026 -40
 V A -80
 V 'A -80
 V ^A -80
@@ -669,6 +691,7 @@
 V /o -80
 V ~o -80
 V . -125
+V u2026 -125
 V ; -40
 V u -70
 V 'u -70
@@ -712,6 +735,7 @@
 W /o -30
 W ~o -30
 W . -80
+W u2026 -80
 W u -30
 W 'u -30
 W ^u -30
@@ -760,6 +784,7 @@
 Y /o -140
 Y ~o -140
 Y . -140
+Y u2026 -140
 Y ; -60
 Y u -110
 Y 'u -110
@@ -806,6 +831,7 @@
 'Y /o -140
 'Y ~o -140
 'Y . -140
+'Y u2026 -140
 'Y ; -60
 'Y u -110
 'Y 'u -110
@@ -852,6 +878,7 @@
 :Y /o -140
 :Y ~o -140
 :Y . -140
+:Y u2026 -140
 :Y ; -60
 :Y u -110
 :Y 'u -110
@@ -898,6 +925,7 @@
 b l -20
 b /l -20
 b . -40
+b u2026 -40
 b u -20
 b 'u -20
 b ^u -20
@@ -917,6 +945,7 @@
 , cq -100
 e , -15
 e . -15
+e u2026 -15
 e v -30
 e w -20
 e x -30
@@ -925,6 +954,7 @@
 e :y -20
 'e , -15
 'e . -15
+'e u2026 -15
 'e v -30
 'e w -20
 'e x -30
@@ -933,6 +963,7 @@
 'e :y -20
 ^e , -15
 ^e . -15
+^e u2026 -15
 ^e v -30
 ^e w -20
 ^e x -30
@@ -941,6 +972,7 @@
 ^e :y -20
 :e , -15
 :e . -15
+:e u2026 -15
 :e v -30
 :e w -20
 :e x -30
@@ -949,6 +981,7 @@
 :e :y -20
 `e , -15
 `e . -15
+`e u2026 -15
 `e v -30
 `e w -20
 `e x -30
@@ -977,6 +1010,7 @@
 f /o -30
 f ~o -30
 f . -30
+f u2026 -30
 f rq 60
 f ' 50
 f cq 50
@@ -1024,6 +1058,7 @@
 ~n :y -15
 o , -40
 o . -40
+o u2026 -40
 o v -15
 o w -15
 o x -30
@@ -1032,6 +1067,7 @@
 o :y -30
 'o , -40
 'o . -40
+'o u2026 -40
 'o v -15
 'o w -15
 'o x -30
@@ -1040,6 +1076,7 @@
 'o :y -30
 ^o , -40
 ^o . -40
+^o u2026 -40
 ^o v -15
 ^o w -15
 ^o x -30
@@ -1048,6 +1085,7 @@
 ^o :y -30
 :o , -40
 :o . -40
+:o u2026 -40
 :o v -15
 :o w -15
 :o x -30
@@ -1056,6 +1094,7 @@
 :o :y -30
 `o , -40
 `o . -40
+`o u2026 -40
 `o v -15
 `o w -15
 `o x -30
@@ -1103,6 +1142,7 @@
 /o ~o -55
 /o p -55
 /o . -95
+/o u2026 -95
 /o q -55
 /o r -55
 /o s -55
@@ -1123,6 +1163,7 @@
 /o vz -55
 ~o , -40
 ~o . -40
+~o u2026 -40
 ~o v -15
 ~o w -15
 ~o x -30
@@ -1131,13 +1172,18 @@
 ~o :y -30
 p , -35
 p . -35
+p u2026 -35
 p y -30
 p 'y -30
 p :y -30
 . rq -100
+u2026 rq -100
 . ' -100
+u2026 ' -100
 . cq -100
+u2026 cq -100
 . u0020 -60
+u2026 u0020 -60
 rq u0020 -40
 ` ` -57
 ` oq -57
@@ -1179,6 +1225,7 @@
 r ~n 25
 r p 30
 r . -50
+r u2026 -50
 r ; 30
 r t 40
 r u 15
@@ -1192,9 +1239,11 @@
 r :y 30
 s , -15
 s . -15
+s u2026 -15
 s w -30
 vs , -15
 vs . -15
+vs u2026 -15
 vs w -30
 ; u0020 -50
 u0020 T -50
@@ -1227,6 +1276,7 @@
 v /o -25
 v ~o -25
 v . -80
+v u2026 -80
 w a -15
 w 'a -15
 w ^a -15
@@ -1248,6 +1298,7 @@
 w /o -10
 w ~o -10
 w . -60
+w u2026 -60
 x e -30
 x 'e -30
 x ^e -30
@@ -1274,6 +1325,7 @@
 y /o -20
 y ~o -20
 y . -100
+y u2026 -100
 'y a -20
 'y 'a -20
 'y ^a -20
@@ -1295,6 +1347,7 @@
 'y /o -20
 'y ~o -20
 'y . -100
+'y u2026 -100
 :y a -20
 :y 'a -20
 :y ^a -20
@@ -1316,6 +1369,7 @@
 :y /o -20
 :y ~o -20
 :y . -100
+:y u2026 -100
 z e -15
 z 'e -15
 z ^e -15

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/HR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/HR Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/NB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/NB Changed

@@ -154,10 +154,13 @@
 ~A :y -18
 C , -18
 C . -18
+C u2026 -18
 ,C , -18
 ,C . -18
+,C u2026 -18
 D , -25
 D . -25
+D u2026 -25
 F a -74
 F 'a -74
 F ^a -74
@@ -184,6 +187,7 @@
 F /o -55
 F ~o -55
 F . -125
+F u2026 -125
 F r -18
 J A -18
 J 'A -18
@@ -213,6 +217,7 @@
 J /o -18
 J ~o -18
 J . -55
+J u2026 -55
 J u -18
 J 'u -18
 J ^u -18
@@ -252,29 +257,38 @@
 /L :y -25
 N , -18
 N . -18
+N u2026 -18
 ~N , -18
 ~N . -18
+~N u2026 -18
 O T 10
 O , -25
 O . -25
+O u2026 -25
 'O T 10
 'O , -25
 'O . -25
+'O u2026 -25
 ^O T 10
 ^O , -25
 ^O . -25
+^O u2026 -25
 :O T 10
 :O , -25
 :O . -25
+:O u2026 -25
 `O T 10
 `O , -25
 `O . -25
+`O u2026 -25
 /O T 10
 /O , -25
 /O . -25
+/O u2026 -25
 ~O T 10
 ~O , -25
 ~O . -25
+~O u2026 -25
 P A -74
 P 'A -74
 P ^A -74
@@ -303,10 +317,13 @@
 P /o -55
 P ~o -55
 P . -150
+P u2026 -150
 S , -18
 S . -18
+S u2026 -18
 vS , -18
 vS . -18
+vS u2026 -18
 T A -55
 T 'A -55
 T ^A -55
@@ -349,6 +366,7 @@
 T /o -74
 T ~o -74
 T . -100
+T u2026 -100
 T r -18
 T u -18
 T 'u -18
@@ -364,6 +382,7 @@
 U ~A -18
 U , -25
 U . -25
+U u2026 -25
 'U A -18
 'U 'A -18
 'U ^A -18
@@ -373,6 +392,7 @@
 'U ~A -18
 'U , -25
 'U . -25
+'U u2026 -25
 ^U A -18
 ^U 'A -18
 ^U ^A -18
@@ -382,6 +402,7 @@
 ^U ~A -18
 ^U , -25
 ^U . -25
+^U u2026 -25
 :U A -18
 :U 'A -18
 :U ^A -18
@@ -391,6 +412,7 @@
 :U ~A -18
 :U , -25
 :U . -25
+:U u2026 -25
 `U A -18
 `U 'A -18
 `U ^A -18
@@ -400,6 +422,7 @@
 `U ~A -18
 `U , -25
 `U . -25
+`U u2026 -25
 V A -74
 V 'A -74
 V ^A -74
@@ -436,6 +459,7 @@
 V /o -74
 V ~o -74
 V . -125
+V u2026 -125
 V ; -37
 V u -55
 V 'u -55
@@ -478,6 +502,7 @@
 W /o -74
 W ~o -74
 W . -100
+W u2026 -100
 W ; -55
 W u -37
 W 'u -37
@@ -521,6 +546,7 @@
 Y /o -100
 Y ~o -100
 Y . -100
+Y u2026 -100
 Y ; -25
 Y u -55
 Y 'u -55
@@ -561,6 +587,7 @@
 'Y /o -100
 'Y ~o -100
 'Y . -100
+'Y u2026 -100
 'Y ; -25
 'Y u -55
 'Y 'u -55
@@ -601,6 +628,7 @@
 :Y /o -100
 :Y ~o -100
 :Y . -100
+:Y u2026 -100
 :Y ; -25
 :Y u -55
 :Y 'u -55
@@ -616,9 +644,13 @@
 f ' 75
 f cq 75
 . rq -18
+u2026 rq -18
 . ' -18
+u2026 ' -18
 . cq -18
+u2026 cq -18
 . u0020 -18
+u2026 u0020 -18
 lq A -74
 lq 'A -74
 lq ^A -74
@@ -649,6 +681,7 @@
 cq vs -25
 r , -74
 r . -74
+r u2026 -74
 ; u0020 -18
 u0020 A -18
 u0020 'A -18
@@ -668,14 +701,19 @@
 u0020 oq -18
 v , -100
 v . -100
+v u2026 -100
 w , -100
 w . -100
+w u2026 -100
 y , -100
 y . -100
+y u2026 -100
 'y , -100
 'y . -100
+'y u2026 -100
 :y , -100
 :y . -100
+:y u2026 -100
 
 charset
 ha	606,690	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/NBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/NBI Changed

@@ -279,6 +279,7 @@
 B `U 15
 B , 15
 B . 15
+B u2026 15
 C A -5
 C 'A -5
 C ^A -5
@@ -300,6 +301,7 @@
 D :Y 6
 D , -11
 D . -11
+D u2026 -11
 F A -79
 F 'A -79
 F ^A -79
@@ -333,6 +335,7 @@
 F /o -47
 F ~o -47
 F . -91
+F u2026 -91
 F r -27
 J A -30
 J 'A -30
@@ -362,6 +365,7 @@
 J /o -40
 J ~o -40
 J . -74
+J u2026 -74
 J u -39
 J 'u -39
 J ^u -39
@@ -413,8 +417,10 @@
 /L :y -30
 N , -49
 N . -49
+N u2026 -49
 ~N , -49
 ~N . -49
+~N u2026 -49
 O A -5
 O 'A -5
 O ^A -5
@@ -427,6 +433,7 @@
 O X -18
 O , -18
 O . -18
+O u2026 -18
 'O A -5
 'O 'A -5
 'O ^A -5
@@ -439,6 +446,7 @@
 'O X -18
 'O , -18
 'O . -18
+'O u2026 -18
 ^O A -5
 ^O 'A -5
 ^O ^A -5
@@ -451,6 +459,7 @@
 ^O X -18
 ^O , -18
 ^O . -18
+^O u2026 -18
 :O A -5
 :O 'A -5
 :O ^A -5
@@ -463,6 +472,7 @@
 :O X -18
 :O , -18
 :O . -18
+:O u2026 -18
 `O A -5
 `O 'A -5
 `O ^A -5
@@ -475,6 +485,7 @@
 `O X -18
 `O , -18
 `O . -18
+`O u2026 -18
 /O A -5
 /O 'A -5
 /O ^A -5
@@ -487,6 +498,7 @@
 /O X -18
 /O , -18
 /O . -18
+/O u2026 -18
 ~O A -5
 ~O 'A -5
 ~O ^A -5
@@ -499,6 +511,7 @@
 ~O X -18
 ~O , -18
 ~O . -18
+~O u2026 -18
 P A -80
 P 'A -80
 P ^A -80
@@ -527,12 +540,15 @@
 P /o -40
 P ~o -40
 P . -100
+P u2026 -100
 R V -24
 R W -14
 S , -18
 S . -18
+S u2026 -18
 vS , -18
 vS . -18
+vS u2026 -18
 T A -60
 T 'A -60
 T ^A -60
@@ -576,6 +592,7 @@
 T /o -40
 T ~o -40
 T . -55
+T u2026 -55
 T r -9
 T u -22
 T 'u -22
@@ -595,6 +612,7 @@
 U ~A -42
 U , -25
 U . -25
+U u2026 -25
 'U A -42
 'U 'A -42
 'U ^A -42
@@ -604,6 +622,7 @@
 'U ~A -42
 'U , -25
 'U . -25
+'U u2026 -25
 ^U A -42
 ^U 'A -42
 ^U ^A -42
@@ -613,6 +632,7 @@
 ^U ~A -42
 ^U , -25
 ^U . -25
+^U u2026 -25
 :U A -42
 :U 'A -42
 :U ^A -42
@@ -622,6 +642,7 @@
 :U ~A -42
 :U , -25
 :U . -25
+:U u2026 -25
 `U A -42
 `U 'A -42
 `U ^A -42
@@ -631,6 +652,7 @@
 `U ~A -42
 `U , -25
 `U . -25
+`U u2026 -25
 V A -100
 V 'A -100
 V ^A -100
@@ -672,6 +694,7 @@
 V /o -71
 V ~o -71
 V . -94
+V u2026 -94
 V ; 6
 V u -70
 V 'u -70
@@ -719,6 +742,7 @@
 W /o -33
 W ~o -33
 W . -86
+W u2026 -86
 W ; -22
 W u -25
 W 'u -25
@@ -762,6 +786,7 @@
 Y /o -77
 Y ~o -77
 Y . -91
+Y u2026 -91
 Y ; -55
 Y u -58
 Y 'u -58
@@ -802,6 +827,7 @@
 'Y /o -77
 'Y ~o -77
 'Y . -91
+'Y u2026 -91
 'Y ; -55
 'Y u -58
 'Y 'u -58
@@ -842,6 +868,7 @@
 :Y /o -77
 :Y ~o -77
 :Y . -91
+:Y u2026 -91
 :Y ; -55
 :Y u -58
 :Y 'u -58
@@ -885,6 +912,7 @@
 ~a :y -8
 b , 6
 b . 6
+b u2026 6
 b v 8
 b y -6
 b 'y -6
@@ -895,6 +923,7 @@
 c l -13
 c /l -13
 c . -8
+c u2026 -8
 c y -20
 c 'y -20
 c :y -20
@@ -904,6 +933,7 @@
 ,c l -13
 ,c /l -13
 ,c . -8
+,c u2026 -8
 ,c y -20
 ,c 'y -20
 ,c :y -20
@@ -985,11 +1015,13 @@
 f /o 7
 f ~o 7
 f . -28
+f u2026 -28
 f rq 105
 f ' 105
 f cq 105
 g , -5
 g . -5
+g u2026 -5
 g r 11
 g y -11
 g 'y -11
@@ -1088,13 +1120,18 @@
 ~o :y -11
 p , 8
 p . 8
+p u2026 8
 p y -4
 p 'y -4
 p :y -4
 . rq -18
+u2026 rq -18
 . ' -18
+u2026 ' -18
 . cq -18
+u2026 cq -18
 . u0020 -18
+u2026 u0020 -18
 lq A -60
 lq 'A -60
 lq ^A -60
@@ -1170,6 +1207,7 @@
 r ~o -11
 r p -17
 r . -90
+r u2026 -90
 r ' 9
 r cq 9
 r s -20
@@ -1187,8 +1225,10 @@
 r :y -20
 s , 11
 s . 11
+s u2026 11
 vs , 11
 vs . 11
+vs u2026 11
 ; u0020 -18
 u0020 A -22
 u0020 'A -22
@@ -1220,6 +1260,7 @@
 v /o -6
 v ~o -6
 v . -11
+v u2026 -11
 w a -14
 w 'a -14
 w ^a -14
@@ -1241,6 +1282,7 @@
 w /o -14
 w ~o -14
 w . -17
+w u2026 -17
 x e 5
 x 'e 5
 x ^e 5
@@ -1267,6 +1309,7 @@
 y /o 8
 y ~o 8
 y . -25
+y u2026 -25
 'y a 8
 'y 'a 8
 'y ^a 8
@@ -1288,6 +1331,7 @@
 'y /o 8
 'y ~o 8
 'y . -25
+'y u2026 -25
 :y a 8
 :y 'a 8
 :y ^a 8
@@ -1309,6 +1353,7 @@
 :y /o 8
 :y ~o 8
 :y . -25
+:y u2026 -25
 z e 4
 z 'e 4
 z ^e 4

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/NI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/NI Changed

@@ -267,10 +267,13 @@
 ~A :y -55
 B , -50
 B . -50
+B u2026 -50
 C , -50
 C . -50
+C u2026 -50
 ,C , -50
 ,C . -50
+,C u2026 -50
 D V -18
 D W -18
 D Y -18
@@ -278,6 +281,7 @@
 D :Y -18
 D , -50
 D . -50
+D u2026 -50
 F A -35
 F 'A -35
 F ^A -35
@@ -311,9 +315,11 @@
 F /o -55
 F ~o -55
 F . -125
+F u2026 -125
 F r -55
 G , -50
 G . -50
+G u2026 -50
 J A -18
 J 'A -18
 J ^A -18
@@ -342,6 +348,7 @@
 J /o -37
 J ~o -37
 J . -100
+J u2026 -100
 J u -18
 J 'u -18
 J ^u -18
@@ -373,8 +380,10 @@
 /L :y -50
 N , -60
 N . -60
+N u2026 -60
 ~N , -60
 ~N . -60
+~N u2026 -60
 O T 18
 O V -18
 O X -18
@@ -383,6 +392,7 @@
 O :Y -18
 O , -50
 O . -50
+O u2026 -50
 'O T 18
 'O V -18
 'O X -18
@@ -391,6 +401,7 @@
 'O :Y -18
 'O , -50
 'O . -50
+'O u2026 -50
 ^O T 18
 ^O V -18
 ^O X -18
@@ -399,6 +410,7 @@
 ^O :Y -18
 ^O , -50
 ^O . -50
+^O u2026 -50
 :O T 18
 :O V -18
 :O X -18
@@ -407,6 +419,7 @@
 :O :Y -18
 :O , -50
 :O . -50
+:O u2026 -50
 `O T 18
 `O V -18
 `O X -18
@@ -415,6 +428,7 @@
 `O :Y -18
 `O , -50
 `O . -50
+`O u2026 -50
 /O T 18
 /O V -18
 /O X -18
@@ -423,6 +437,7 @@
 /O :Y -18
 /O , -50
 /O . -50
+/O u2026 -50
 ~O T 18
 ~O V -18
 ~O X -18
@@ -431,6 +446,7 @@
 ~O :Y -18
 ~O , -50
 ~O . -50
+~O u2026 -50
 P A -50
 P 'A -50
 P ^A -50
@@ -459,8 +475,10 @@
 P /o -55
 P ~o -55
 P . -125
+P u2026 -125
 Q , -20
 Q . -20
+Q u2026 -20
 R U -18
 R 'U -18
 R ^U -18
@@ -473,8 +491,10 @@
 R :Y -18
 S , -50
 S . -50
+S u2026 -50
 vS , -50
 vS . -50
+vS u2026 -50
 T O 18
 T 'O 18
 T ^O 18
@@ -510,6 +530,7 @@
 T /o -74
 T ~o -34
 T . -100
+T u2026 -100
 T r -50
 T ; -50
 T u -50
@@ -530,6 +551,7 @@
 U ~A -18
 U , -100
 U . -100
+U u2026 -100
 'U A -18
 'U 'A -18
 'U ^A -18
@@ -539,6 +561,7 @@
 'U ~A -18
 'U , -100
 'U . -100
+'U u2026 -100
 ^U A -18
 ^U 'A -18
 ^U ^A -18
@@ -548,6 +571,7 @@
 ^U ~A -18
 ^U , -100
 ^U . -100
+^U u2026 -100
 :U A -18
 :U 'A -18
 :U ^A -18
@@ -557,6 +581,7 @@
 :U ~A -18
 :U , -100
 :U . -100
+:U u2026 -100
 `U A -18
 `U 'A -18
 `U ^A -18
@@ -566,6 +591,7 @@
 `U ~A -18
 `U , -100
 `U . -100
+`U u2026 -100
 V A -37
 V 'A -37
 V ^A -37
@@ -602,6 +628,7 @@
 V /o -75
 V ~o -35
 V . -100
+V u2026 -100
 V ; -75
 V u -75
 V 'u -75
@@ -643,6 +670,7 @@
 W /o -55
 W ~o -55
 W . -100
+W u2026 -100
 W ; -75
 W u -55
 W 'u -55
@@ -685,6 +713,7 @@
 Y /o -100
 Y ~o -60
 Y . -100
+Y u2026 -100
 Y ; -75
 Y u -100
 Y 'u -100
@@ -724,6 +753,7 @@
 'Y /o -100
 'Y ~o -60
 'Y . -100
+'Y u2026 -100
 'Y ; -75
 'Y u -100
 'Y 'u -100
@@ -763,6 +793,7 @@
 :Y /o -100
 :Y ~o -60
 :Y . -100
+:Y u2026 -100
 :Y ; -75
 :Y u -100
 :Y 'u -100
@@ -772,14 +803,17 @@
 b b -10
 b , -50
 b . -50
+b u2026 -50
 c , -50
 c h -18
 c k -18
 c . -50
+c u2026 -50
 ,c , -50
 ,c h -18
 ,c k -18
 ,c . -50
+,c u2026 -50
 : u0020 -37
 , rq -37
 , ' -37
@@ -787,14 +821,19 @@
 , u0020 -37
 e , -37
 e . -37
+e u2026 -37
 'e , -37
 'e . -37
+'e u2026 -37
 ^e , -37
 ^e . -37
+^e u2026 -37
 :e , -37
 :e . -37
+:e u2026 -37
 `e , -37
 `e . -37
+`e u2026 -37
 f , -75
 f o -10
 f 'o -10
@@ -804,11 +843,13 @@
 f /o -10
 f ~o -10
 f . -75
+f u2026 -75
 f rq 75
 f ' 75
 f cq 75
 g , -50
 g . -50
+g u2026 -50
 l y -10
 l 'y -10
 l :y -10
@@ -817,24 +858,36 @@
 /l :y -10
 o , -50
 o . -50
+o u2026 -50
 'o , -50
 'o . -50
+'o u2026 -50
 ^o , -50
 ^o . -50
+^o u2026 -50
 :o , -50
 :o . -50
+:o u2026 -50
 `o , -50
 `o . -50
+`o u2026 -50
 /o , -50
 /o . -50
+/o u2026 -50
 ~o , -50
 ~o . -50
+~o u2026 -50
 p , -50
 p . -50
+p u2026 -50
 . rq -37
+u2026 rq -37
 . ' -37
+u2026 ' -37
 . cq -37
+u2026 cq -37
 . u0020 -37
+u2026 u0020 -37
 lq A -75
 lq 'A -75
 lq ^A -75
@@ -877,13 +930,16 @@
 r hy -75
 r k -18
 r . -125
+r u2026 -125
 r s -10
 r vs -10
 r ; -25
 s , -50
 s . -50
+s u2026 -50
 vs , -50
 vs . -50
+vs u2026 -50
 ; u0020 -37
 u0020 A -37
 u0020 'A -37
@@ -903,14 +959,19 @@
 u0020 oq -37
 v , -75
 v . -75
+v u2026 -75
 w , -75
 w . -75
+w u2026 -75
 y , -75
 y . -75
+y u2026 -75
 'y , -75
 'y . -75
+'y u2026 -75
 :y , -75
 :y . -75
+:y u2026 -75
 
 charset
 ha	606,690,0,0,-39	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/NR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/NR Changed

@@ -161,6 +161,7 @@
 B ~A -18
 B , -37
 B . -37
+B u2026 -37
 C A -18
 C 'A -18
 C ^A -18
@@ -170,6 +171,7 @@
 C ~A -18
 C , -37
 C . -37
+C u2026 -37
 ,C A -18
 ,C 'A -18
 ,C ^A -18
@@ -179,12 +181,14 @@
 ,C ~A -18
 ,C , -37
 ,C . -37
+,C u2026 -37
 D V -18
 D Y -18
 D 'Y -18
 D :Y -18
 D , -37
 D . -37
+D u2026 -37
 F A -50
 F 'A -50
 F ^A -50
@@ -218,9 +222,11 @@
 F /o -55
 F ~o -55
 F . -125
+F u2026 -125
 F r -10
 G , -37
 G . -37
+G u2026 -37
 J A -18
 J 'A -18
 J ^A -18
@@ -249,6 +255,7 @@
 J /o -25
 J ~o -25
 J . -74
+J u2026 -74
 J u -25
 J 'u -25
 J ^u -25
@@ -295,8 +302,10 @@
 /L :y -25
 N , -55
 N . -55
+N u2026 -55
 ~N , -55
 ~N . -55
+~N u2026 -55
 O T 10
 O V -18
 O Y -18
@@ -304,6 +313,7 @@
 O :Y -18
 O , -37
 O . -37
+O u2026 -37
 'O T 10
 'O V -18
 'O Y -18
@@ -311,6 +321,7 @@
 'O :Y -18
 'O , -37
 'O . -37
+'O u2026 -37
 ^O T 10
 ^O V -18
 ^O Y -18
@@ -318,6 +329,7 @@
 ^O :Y -18
 ^O , -37
 ^O . -37
+^O u2026 -37
 :O T 10
 :O V -18
 :O Y -18
@@ -325,6 +337,7 @@
 :O :Y -18
 :O , -37
 :O . -37
+:O u2026 -37
 `O T 10
 `O V -18
 `O Y -18
@@ -332,6 +345,7 @@
 `O :Y -18
 `O , -37
 `O . -37
+`O u2026 -37
 /O T 10
 /O V -18
 /O Y -18
@@ -339,6 +353,7 @@
 /O :Y -18
 /O , -37
 /O . -37
+/O u2026 -37
 ~O T 10
 ~O V -18
 ~O Y -18
@@ -346,6 +361,7 @@
 ~O :Y -18
 ~O , -37
 ~O . -37
+~O u2026 -37
 P A -55
 P 'A -55
 P ^A -55
@@ -374,12 +390,16 @@
 P /o -37
 P ~o -37
 P . -125
+P u2026 -125
 Q , -25
 Q . -25
+Q u2026 -25
 S , -37
 S . -37
+S u2026 -37
 vS , -37
 vS . -37
+vS u2026 -37
 T A -18
 T 'A -18
 T ^A -18
@@ -418,6 +438,7 @@
 T /o -55
 T ~o -55
 T . -125
+T u2026 -125
 T ; -37
 U A -30
 U 'A -30
@@ -428,6 +449,7 @@
 U ~A -30
 U , -100
 U . -100
+U u2026 -100
 'U A -30
 'U 'A -30
 'U ^A -30
@@ -437,6 +459,7 @@
 'U ~A -30
 'U , -100
 'U . -100
+'U u2026 -100
 ^U A -30
 ^U 'A -30
 ^U ^A -30
@@ -446,6 +469,7 @@
 ^U ~A -30
 ^U , -100
 ^U . -100
+^U u2026 -100
 :U A -30
 :U 'A -30
 :U ^A -30
@@ -455,6 +479,7 @@
 :U ~A -30
 :U , -100
 :U . -100
+:U u2026 -100
 `U A -30
 `U 'A -30
 `U ^A -30
@@ -464,6 +489,7 @@
 `U ~A -30
 `U , -100
 `U . -100
+`U u2026 -100
 V A -74
 V 'A -74
 V ^A -74
@@ -505,6 +531,7 @@
 V /o -75
 V ~o -75
 V . -125
+V u2026 -125
 V ; -75
 V u -75
 V 'u -75
@@ -545,6 +572,7 @@
 W /o -60
 W ~o -60
 W . -125
+W u2026 -125
 W ; -100
 W u -55
 W 'u -55
@@ -595,6 +623,7 @@
 Y /o -100
 Y ~o -100
 Y . -100
+Y u2026 -100
 Y ; -75
 Y u -91
 Y 'u -91
@@ -642,6 +671,7 @@
 'Y /o -100
 'Y ~o -100
 'Y . -100
+'Y u2026 -100
 'Y ; -75
 'Y u -91
 'Y 'u -91
@@ -689,6 +719,7 @@
 :Y /o -100
 :Y ~o -100
 :Y . -100
+:Y u2026 -100
 :Y ; -75
 :Y u -91
 :Y 'u -91
@@ -732,18 +763,21 @@
 ~a :y -10
 b , -18
 b . -18
+b u2026 -18
 c , -18
 c h -7
 c k -7
 c l -7
 c /l -7
 c . -18
+c u2026 -18
 ,c , -18
 ,c h -7
 ,c k -7
 ,c l -7
 ,c /l -7
 ,c . -18
+,c u2026 -18
 : u0020 -37
 , rq -37
 , ' -37
@@ -751,41 +785,60 @@
 , u0020 -37
 e , -18
 e . -18
+e u2026 -18
 'e , -18
 'e . -18
+'e u2026 -18
 ^e , -18
 ^e . -18
+^e u2026 -18
 :e , -18
 :e . -18
+:e u2026 -18
 `e , -18
 `e . -18
+`e u2026 -18
 f , -37
 f . -37
+f u2026 -37
 f rq 100
 f ' 100
 f cq 100
 g , -25
 g . -25
+g u2026 -25
 o , -18
 o . -18
+o u2026 -18
 'o , -18
 'o . -18
+'o u2026 -18
 ^o , -18
 ^o . -18
+^o u2026 -18
 :o , -18
 :o . -18
+:o u2026 -18
 `o , -18
 `o . -18
+`o u2026 -18
 /o , -18
 /o . -18
+/o u2026 -18
 ~o , -18
 ~o . -18
+~o u2026 -18
 p , -18
 p . -18
+p u2026 -18
 . rq -37
+u2026 rq -37
 . ' -37
+u2026 ' -37
 . cq -37
+u2026 cq -37
 . u0020 -37
+u2026 u0020 -37
 lq A -74
 lq 'A -74
 lq ^A -74
@@ -826,10 +879,13 @@
 r - -37
 r hy -37
 r . -100
+r u2026 -100
 s , -25
 s . -25
+s u2026 -25
 vs , -25
 vs . -25
+vs u2026 -25
 ; u0020 -37
 u0020 A -37
 u0020 'A -37
@@ -849,6 +905,7 @@
 u0020 oq -37
 v , -125
 v . -125
+v u2026 -125
 w a -18
 w 'a -18
 w ^a -18
@@ -858,12 +915,16 @@
 w ~a -18
 w , -125
 w . -125
+w u2026 -125
 y , -125
 y . -125
+y u2026 -125
 'y , -125
 'y . -125
+'y u2026 -125
 :y , -125
 :y . -125
+:y u2026 -125
 
 charset
 ha	606,690	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/PB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/PB Changed

@@ -126,6 +126,7 @@
 F ~A -55
 F , -111
 F . -111
+F u2026 -111
 L T -74
 L V -92
 L W -92
@@ -159,6 +160,7 @@
 P ~A -74
 P , -129
 P . -129
+P u2026 -129
 R T -55
 R V -74
 R W -37
@@ -203,6 +205,7 @@
 T /o -111
 T ~o -111
 T . -92
+T u2026 -92
 T r -111
 T s -111
 T vs -71
@@ -249,6 +252,7 @@
 V /o -111
 V ~o -111
 V . -129
+V u2026 -129
 V r -111
 V ; -74
 V u -92
@@ -292,6 +296,7 @@
 W /o -74
 W ~o -74
 W . -37
+W u2026 -37
 W r -74
 W ; -37
 W u -74
@@ -336,6 +341,7 @@
 Y ~o -74
 Y p -74
 Y . -74
+Y u2026 -74
 Y q -92
 Y ; -55
 Y u -74
@@ -378,6 +384,7 @@
 'Y ~o -74
 'Y p -74
 'Y . -74
+'Y u2026 -74
 'Y q -92
 'Y ; -55
 'Y u -74
@@ -420,6 +427,7 @@
 :Y ~o -74
 :Y p -74
 :Y . -74
+:Y u2026 -74
 :Y q -92
 :Y ; -55
 :Y u -74
@@ -452,18 +460,24 @@
 r - -18
 r hy -18
 r . -55
+r u2026 -55
 r ' 55
 r cq 55
 v , -111
 v . -111
+v u2026 -111
 w , -92
 w . -92
+w u2026 -92
 y , -92
 y . -92
+y u2026 -92
 'y , -92
 'y . -92
+'y u2026 -92
 :y , -92
 :y . -92
+:y u2026 -92
 
 charset
 ha	606,678	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/PBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/PBI Changed

@@ -127,6 +127,7 @@
 F ~A -74
 F , -111
 F . -111
+F u2026 -111
 F u0020 -18
 L T -74
 L V -74
@@ -161,6 +162,7 @@
 P ~A -92
 P , -129
 P . -129
+P u2026 -129
 P u0020 -55
 R T -37
 R V -55
@@ -216,6 +218,7 @@
 T /o -111
 T ~o -111
 T . -55
+T u2026 -55
 T r -92
 T s -92
 T vs -92
@@ -262,6 +265,7 @@
 V /o -74
 V ~o -74
 V . -111
+V u2026 -111
 V r -74
 V ; -37
 V u -50
@@ -303,6 +307,7 @@
 W /o -55
 W ~o -55
 W . -55
+W u2026 -55
 W r -30
 W ; -18
 W u -30
@@ -347,6 +352,7 @@
 Y ~o -111
 Y p -74
 Y . -55
+Y u2026 -55
 Y q -92
 Y ; -55
 Y u -50
@@ -389,6 +395,7 @@
 'Y ~o -111
 'Y p -74
 'Y . -55
+'Y u2026 -55
 'Y q -92
 'Y ; -55
 'Y u -50
@@ -431,6 +438,7 @@
 :Y ~o -111
 :Y p -74
 :Y . -55
+:Y u2026 -55
 :Y q -92
 :Y ; -55
 :Y u -50
@@ -477,19 +485,25 @@
 r /o -18
 r ~o -18
 r . -55
+r u2026 -55
 r q -18
 r ' 55
 r cq 55
 v , -55
 v . -55
+v u2026 -55
 w , -55
 w . -55
+w u2026 -55
 y , -37
 y . -37
+y u2026 -37
 'y , -37
 'y . -37
+'y u2026 -37
 :y , -37
 :y . -37
+:y u2026 -37
 
 charset
 ha	606,678,0,0,-13	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/PI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/PI Changed

@@ -127,6 +127,7 @@
 F ~A -111
 F , -111
 F . -111
+F u2026 -111
 L T -74
 L V -74
 L W -74
@@ -160,6 +161,7 @@
 P ~A -129
 P , -129
 P . -129
+P u2026 -129
 R T -55
 R V -74
 R W -55
@@ -211,6 +213,7 @@
 T /o -111
 T ~o -71
 T . -74
+T u2026 -74
 T r -111
 T s -111
 T vs -71
@@ -260,6 +263,7 @@
 V /o -74
 V ~o -74
 V . -129
+V u2026 -129
 V r -92
 V ; -37
 V u -74
@@ -303,6 +307,7 @@
 W /o -20
 W ~o -20
 W . -55
+W u2026 -55
 W r -20
 W ; -18
 W u -20
@@ -347,6 +352,7 @@
 Y ~o -111
 Y p -74
 Y . -92
+Y u2026 -92
 Y q -92
 Y ; -74
 Y u -92
@@ -389,6 +395,7 @@
 'Y ~o -111
 'Y p -74
 'Y . -92
+'Y u2026 -92
 'Y q -92
 'Y ; -74
 'Y u -92
@@ -431,6 +438,7 @@
 :Y ~o -111
 :Y p -74
 :Y . -92
+:Y u2026 -92
 :Y q -92
 :Y ; -74
 :Y u -92
@@ -476,19 +484,25 @@
 r /o -18
 r ~o -18
 r . -74
+r u2026 -74
 r q -18
 r ' 37
 r cq 37
 v , -55
 v . -55
+v u2026 -55
 w , -55
 w . -55
+w u2026 -55
 y , -37
 y . -37
+y u2026 -37
 'y , -37
 'y . -37
+'y u2026 -37
 :y , -37
 :y . -37
+:y u2026 -37
 
 charset
 ha	606,689,0,0,-1	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/PR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/PR Changed

@@ -126,6 +126,7 @@
 F ~A -74
 F , -92
 F . -92
+F u2026 -92
 L T -74
 L V -92
 L W -74
@@ -159,6 +160,7 @@
 P ~A -92
 P , -129
 P . -129
+P u2026 -129
 P u0020 -18
 R T -37
 R V -55
@@ -211,6 +213,7 @@
 T /o -92
 T ~o -92
 T . -74
+T u2026 -74
 T r -90
 T s -90
 T vs -50
@@ -257,6 +260,7 @@
 V /o -111
 V ~o -111
 V . -129
+V u2026 -129
 V r -92
 V ; -55
 V u -92
@@ -303,6 +307,7 @@
 W /o -92
 W ~o -92
 W . -92
+W u2026 -92
 W r -74
 W ; -18
 W u -50
@@ -347,6 +352,7 @@
 Y ~o -92
 Y p -111
 Y . -111
+Y u2026 -111
 Y q -90
 Y ; -74
 Y u0020 -18
@@ -390,6 +396,7 @@
 'Y ~o -92
 'Y p -111
 'Y . -111
+'Y u2026 -111
 'Y q -90
 'Y ; -74
 'Y u0020 -18
@@ -433,6 +440,7 @@
 :Y ~o -92
 :Y p -111
 :Y . -111
+:Y u2026 -111
 :Y q -90
 :Y ; -74
 :Y u0020 -18
@@ -475,6 +483,7 @@
 r /o -18
 r ~o -18
 r . -74
+r u2026 -74
 r q -18
 r ' 74
 r cq 74
@@ -495,14 +504,19 @@
 u0020 :Y -18
 v , -111
 v . -111
+v u2026 -111
 w , -92
 w . -92
+w u2026 -92
 y , -111
 y . -111
+y u2026 -111
 'y , -111
 'y . -111
+'y u2026 -111
 :y , -111
 :y . -111
+:y u2026 -111
 
 charset
 ha	606,689	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/S -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/S Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/TB -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/TB Changed

@@ -64,6 +64,7 @@
 D W -40
 D Y -40
 D . -20
+D u2026 -20
 F A -90
 F oA -90
 F a -25
@@ -73,6 +74,7 @@
 F o -25
 F /o -25
 F . -110
+F u2026 -110
 J A -30
 J oA -30
 J a -15
@@ -81,6 +83,7 @@
 J o -15
 J /o -15
 J . -20
+J u2026 -20
 J u -15
 K O -30
 K /O -30
@@ -130,8 +133,10 @@
 P o -20
 P /o -20
 P . -110
+P u2026 -110
 Q U -10
 Q . -20
+Q u2026 -20
 R O -30
 R /O -30
 R T -40
@@ -154,6 +159,7 @@
 T o -92
 T /o -92
 T . -90
+T u2026 -90
 T r -74
 T ; -74
 T u -92
@@ -163,6 +169,7 @@
 U oA -60
 U , -50
 U . -50
+U u2026 -50
 V A -135
 V oA -135
 V G -30
@@ -179,6 +186,7 @@
 V o -100
 V /o -100
 V . -145
+V u2026 -145
 V ; -92
 V u -92
 W A -120
@@ -196,6 +204,7 @@
 W o -75
 W /o -75
 W . -92
+W u2026 -92
 W ; -55
 W u -50
 W y -60
@@ -214,12 +223,14 @@
 Y o -111
 Y /o -111
 Y . -92
+Y u2026 -92
 Y ; -92
 Y u -92
 a v -25
 oa v -25
 b b -10
 b . -40
+b u2026 -40
 b u -20
 b v -15
 , rq -45
@@ -233,10 +244,12 @@
 f o -25
 f /o -25
 f . -15
+f u2026 -15
 f rq 50
 f ' 55
 f cq 55
 g . -15
+g u2026 -15
 h y -15
 i v -10
 k e -10
@@ -249,8 +262,11 @@
 /o v -10
 /o w -10
 . rq -55
+u2026 rq -55
 . ' -55
+u2026 ' -55
 . cq -55
+u2026 cq -55
 lq A -10
 lq oA -10
 ` A -10
@@ -285,6 +301,7 @@
 r /o -18
 r p -10
 r . -100
+r u2026 -100
 r q -18
 r v -10
 v a -10
@@ -294,15 +311,18 @@
 v o -10
 v /o -10
 v . -70
+v u2026 -70
 w , -55
 w o -10
 w /o -10
 w . -70
+w u2026 -70
 y , -55
 y e -10
 y o -25
 y /o -25
 y . -70
+y u2026 -70
 
 charset
 ha	581,676	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/TBI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/TBI Changed

@@ -72,6 +72,7 @@
 F o -70
 F /o -70
 F . -129
+F u2026 -129
 F r -50
 J A -25
 J oA -25
@@ -82,6 +83,7 @@
 J o -40
 J /o -40
 J . -10
+J u2026 -10
 J u -40
 K O -30
 K /O -30
@@ -129,6 +131,7 @@
 P o -55
 P /o -55
 P . -129
+P u2026 -129
 Q U -10
 R O -40
 R /O -40
@@ -152,6 +155,7 @@
 T o -95
 T /o -95
 T . -92
+T u2026 -92
 T r -37
 T ; -74
 T u -37
@@ -175,6 +179,7 @@
 V o -111
 V /o -111
 V . -129
+V u2026 -129
 V ; -74
 V u -55
 W A -74
@@ -192,6 +197,7 @@
 W o -80
 W /o -80
 W . -74
+W u2026 -74
 W ; -55
 W u -55
 W y -55
@@ -210,10 +216,12 @@
 Y o -111
 Y /o -111
 Y . -74
+Y u2026 -74
 Y ; -92
 Y u -92
 b b -10
 b . -40
+b u2026 -40
 b u -20
 c h -10
 c k -10
@@ -230,6 +238,7 @@
 f o -10
 f /o -10
 f . -10
+f u2026 -10
 f ' 55
 f cq 55
 k e -30
@@ -245,8 +254,11 @@
 /o x -10
 /o y -10
 . rq -95
+u2026 rq -95
 . ' -95
+u2026 ' -95
 . cq -95
+u2026 cq -95
 ` ` -74
 ` oq -74
 oq ` -74
@@ -267,11 +279,13 @@
 cq v -15
 r , -65
 r . -65
+r u2026 -65
 v , -37
 v e -15
 v o -15
 v /o -15
 v . -37
+v u2026 -37
 w a -10
 w oa -10
 w , -37
@@ -279,9 +293,11 @@
 w o -15
 w /o -15
 w . -37
+w u2026 -37
 x e -10
 y , -37
 y . -37
+y u2026 -37
 
 charset
 ha	570,669,0,0,-17	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/TI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/TI Changed

@@ -72,6 +72,7 @@
 F o -105
 F /o -105
 F . -135
+F u2026 -135
 F r -55
 J A -40
 J oA -40
@@ -82,6 +83,7 @@
 J o -25
 J /o -25
 J . -25
+J u2026 -25
 J u -35
 K O -50
 K /O -50
@@ -129,6 +131,7 @@
 P o -80
 P /o -80
 P . -135
+P u2026 -135
 Q U -10
 R O -40
 R /O -40
@@ -151,6 +154,7 @@
 T o -92
 T /o -92
 T . -74
+T u2026 -74
 T r -55
 T ; -65
 T u -55
@@ -160,6 +164,7 @@
 U oA -40
 U , -25
 U . -25
+U u2026 -25
 V A -60
 V oA -60
 V O -30
@@ -175,6 +180,7 @@
 V o -111
 V /o -111
 V . -129
+V u2026 -129
 V ; -74
 V u -74
 W A -60
@@ -192,6 +198,7 @@
 W o -92
 W /o -92
 W . -92
+W u2026 -92
 W ; -65
 W u -55
 W y -70
@@ -210,11 +217,13 @@
 Y o -92
 Y /o -92
 Y . -92
+Y u2026 -92
 Y ; -65
 Y u -92
 a g -10
 oa g -10
 b . -40
+b u2026 -40
 b u -20
 c h -15
 c k -20
@@ -226,6 +235,7 @@
 e , -10
 e g -40
 e . -15
+e u2026 -15
 e v -15
 e w -15
 e x -20
@@ -235,12 +245,14 @@
 f f -18
 f i -20
 f . -15
+f u2026 -15
 f ' 92
 f cq 92
 g , -10
 g e -10
 g g -10
 g . -15
+g u2026 -15
 k e -10
 k o -10
 k /o -10
@@ -251,8 +263,11 @@
 /o g -10
 /o v -10
 . rq -140
+u2026 rq -140
 . ' -140
+u2026 ' -140
 . cq -140
+u2026 cq -140
 ` ` -111
 ` oq -111
 oq ` -111
@@ -284,14 +299,18 @@
 r o -45
 r /o -45
 r . -111
+r u2026 -111
 r q -37
 r s -10
 v , -74
 v . -74
+v u2026 -74
 w , -74
 w . -74
+w u2026 -74
 y , -55
 y . -55
+y u2026 -55
 
 charset
 ha	422,666,0,50,50,43	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/TR -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/TR Changed

@@ -67,6 +67,7 @@
 F o -15
 F /o -15
 F . -80
+F u2026 -80
 J A -60
 J oA -60
 K O -30
@@ -112,6 +113,7 @@
 P oa -15
 P , -111
 P . -111
+P u2026 -111
 Q U -10
 R O -40
 R /O -40
@@ -135,6 +137,7 @@
 T o -80
 T /o -80
 T . -74
+T u2026 -74
 T r -35
 T ; -55
 T u -45
@@ -158,6 +161,7 @@
 V o -129
 V /o -129
 V . -129
+V u2026 -129
 V ; -74
 V u -75
 W A -120
@@ -175,6 +179,7 @@
 W o -80
 W /o -80
 W . -92
+W u2026 -92
 W ; -37
 W u -50
 W y -73
@@ -193,6 +198,7 @@
 Y o -110
 Y /o -110
 Y . -129
+Y u2026 -129
 Y ; -92
 Y u -111
 a v -20
@@ -200,6 +206,7 @@
 oa v -20
 oa w -15
 b . -40
+b u2026 -40
 b u -20
 b v -15
 c y -15
@@ -239,8 +246,11 @@
 /o y -10
 p y -10
 . rq -70
+u2026 rq -70
 . ' -70
+u2026 ' -70
 . cq -70
+u2026 cq -70
 lq A -80
 lq oA -80
 ` A -80
@@ -274,6 +284,7 @@
 r - -20
 r hy -20
 r . -55
+r u2026 -55
 v a -25
 v oa -25
 v , -65
@@ -281,15 +292,18 @@
 v o -20
 v /o -20
 v . -65
+v u2026 -65
 w a -10
 w oa -10
 w , -65
 w o -10
 w /o -10
 w . -65
+w u2026 -65
 x e -15
 y , -65
 y . -65
+y u2026 -65
 
 charset
 ha	469,662	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/ZCMI -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/ZCMI Changed

@@ -154,13 +154,17 @@
 D :Y 10
 D , -20
 D . -30
+D u2026 -30
 F , -30
 F i 10
 F . -40
+F u2026 -40
 G , -10
 G . -20
+G u2026 -20
 J , -10
 J . -20
+J u2026 -20
 K e -20
 K 'e -20
 K ^e -20
@@ -198,6 +202,7 @@
 O :Y 10
 O , -10
 O . -20
+O u2026 -20
 'O A -20
 'O 'A -20
 'O ^A -20
@@ -211,6 +216,7 @@
 'O :Y 10
 'O , -10
 'O . -20
+'O u2026 -20
 ^O A -20
 ^O 'A -20
 ^O ^A -20
@@ -224,6 +230,7 @@
 ^O :Y 10
 ^O , -10
 ^O . -20
+^O u2026 -20
 :O A -20
 :O 'A -20
 :O ^A -20
@@ -237,6 +244,7 @@
 :O :Y 10
 :O , -10
 :O . -20
+:O u2026 -20
 `O A -20
 `O 'A -20
 `O ^A -20
@@ -250,6 +258,7 @@
 `O :Y 10
 `O , -10
 `O . -20
+`O u2026 -20
 /O A -20
 /O 'A -20
 /O ^A -20
@@ -263,6 +272,7 @@
 /O :Y 10
 /O , -10
 /O . -20
+/O u2026 -20
 ~O A -20
 ~O 'A -20
 ~O ^A -20
@@ -276,6 +286,7 @@
 ~O :Y 10
 ~O , -10
 ~O . -20
+~O u2026 -20
 P A -10
 P 'A -10
 P ^A -10
@@ -303,6 +314,7 @@
 P `o -10
 P ~o -10
 P . -50
+P u2026 -50
 Q U -10
 Q 'U -10
 Q ^U -10
@@ -369,6 +381,7 @@
 V `o -20
 V ~o -20
 V . -100
+V u2026 -100
 W O 10
 W 'O 10
 W ^O 10
@@ -398,6 +411,7 @@
 W `o -20
 W ~o -20
 W . -50
+W u2026 -50
 Y a -60
 Y 'a -60
 Y ^a -20
@@ -420,6 +434,7 @@
 Y `o -20
 Y ~o -20
 Y . -50
+Y u2026 -50
 Y u -20
 Y 'u -20
 Y ^u -20
@@ -448,6 +463,7 @@
 'Y `o -20
 'Y ~o -20
 'Y . -50
+'Y u2026 -50
 'Y u -20
 'Y 'u -20
 'Y ^u -20
@@ -476,6 +492,7 @@
 :Y `o -20
 :Y ~o -20
 :Y . -50
+:Y u2026 -50
 :Y u -20
 :Y 'u -20
 :Y ^u -20
@@ -485,6 +502,7 @@
 b , -20
 b l -20
 b . -30
+b u2026 -30
 c k -10
 ,c k -10
 , rq -70
@@ -523,6 +541,7 @@
 f `e -10
 f f -50
 f . -50
+f u2026 -50
 f rq 30
 f ' 30
 f cq 30
@@ -531,6 +550,7 @@
 g e 10
 g i 10
 g . -30
+g u2026 -30
 g y 10
 k e -20
 k 'e -20
@@ -560,22 +580,32 @@
 ~n :y 20
 o , -20
 o . -30
+o u2026 -30
 'o , -20
 'o . -30
+'o u2026 -30
 ^o , -20
 ^o . -30
+^o u2026 -30
 :o , -20
 :o . -30
+:o u2026 -30
 `o , -20
 `o . -30
+`o u2026 -30
 ~o , -20
 ~o . -30
+~o u2026 -30
 p , -20
 p p -10
 p . -30
+p u2026 -30
 . rq -80
+u2026 rq -80
 . ' -80
+u2026 ' -80
 . cq -80
+u2026 cq -80
 lq A 10
 lq ` 20
 lq oq 20
@@ -610,12 +640,16 @@
 r :i 10
 r `i 10
 r . -50
+r u2026 -50
 s , -10
 s . -20
+s u2026 -20
 vs , -10
 vs . -20
+vs u2026 -20
 v , -20
 v . -30
+v u2026 -30
 w , -20
 w h 20
 w o 10
@@ -625,6 +659,7 @@
 w `o 10
 w ~o 10
 w . -30
+w u2026 -30
 
 charset
 ha	520,594,0,62,-82,62	2	0	asciicircum

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/devps.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/devps.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2022 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -58,18 +56,20 @@
   font/devps/TI \
   font/devps/TR \
   font/devps/EURO \
-  font/devps/freeeuro.pfa \
   font/devps/freeeuro.afm \
+  font/devps/symbolsl.afm \
   font/devps/text.enc \
+  font/devps/zapfdr.afm \
   font/devps/download
 
 DEVPSFONTFILES_GENERATED = \
   font/devps/DESC \
   font/devps/prologue \
+  font/devps/freeeuro.pfa \
   font/devps/zapfdr.pfa \
   font/devps/symbolsl.pfa
 devpsfontdir = $(fontdir)/devps
-dist_devpsfont_DATA = $(DEVPSFONTFILES) 
+dist_devpsfont_DATA = $(DEVPSFONTFILES)
 nodist_devpsfont_DATA = $(DEVPSFONTFILES_GENERATED)
 
 # these files will be installed in oldfontdir
@@ -111,11 +111,11 @@
 DEVPSGENFILES = \
   font/devps/generate/Makefile \
   font/devps/generate/dingbats.map \
-  font/devps/generate/dingbats.rmap \
-  font/devps/generate/lgreekmap \
+  font/devps/generate/dingbats-reversed.map \
+  font/devps/generate/slanted-symbol.map \
+  font/devps/generate/symbol.map \
   font/devps/generate/symbolchars \
-  font/devps/generate/symbolsl.afm \
-  font/devps/generate/textmap
+  font/devps/generate/text.map
 DEVPSGENSCRIPTS = \
   font/devps/generate/afmname \
   font/devps/generate/symbol.sed
@@ -124,11 +124,12 @@
 
 MOSTLYCLEANFILES += $(DEVPSFONTFILES_GENERATED)
 EXTRA_DIST += \
-  font/devps/symbolmap \
   font/devps/DESC.in  \
   font/devps/prologue.ps \
   font/devps/psstrip.sed \
+  font/devps/freeeuro.ps \
   font/devps/symbol.afm \
+  font/devps/symbolsl.afm \
   font/devps/symbolsl.ps \
   font/devps/zapfdr.afm \
   font/devps/zapfdr.ps \
@@ -140,20 +141,36 @@
 
 font/devps/DESC: $(devps_srcdir)/DESC.in
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
-	&& cat $(devps_srcdir)/DESC.in >$@ \
-	&& echo broken $(BROKEN_SPOOLER_FLAGS) >>$@ \
+	&& cat $(devps_srcdir)/DESC.in >$@.tmp \
+	&& echo broken $(BROKEN_SPOOLER_FLAGS) >>$@.tmp \
 	&& if test "$(PAGE)" = A4; then \
-	     echo "papersize a4" >>$@; \
+	     echo "papersize a4" >>$@.tmp; \
 	   else \
-	     echo "papersize letter" >>$@; \
+	     echo "papersize letter" >>$@.tmp; \
 	   fi \
 	&& (test -z '$(PSPRINT)' \
-	    || echo print '$(PSPRINT)' >>$@)
+	    || echo print '$(PSPRINT)' >>$@.tmp)
+	$(AM_V_at)mv $@.tmp $@
+
+# PostScript documents to be produced by troff should depend on this
+# stamp file to ensure that grops's device and font description files
+# are available.
+MOSTLYCLEANFILES += font/devps/stamp
+font/devps/stamp: font/devps/DESC \
+  $(DEVPSFONTFILES) $(DEVPSFONTFILES_GENERATED)
+	$(AM_V_at)>$@
 
-fonts: devps_fonts
+maintainer-font-descriptions: devps_font-descriptions
+# This target generates font descriptions from installed Type 1 AFM
+# files; these are _not_ normally generated during a build, but provided
+# with the groff source distribution.
+#
 # We add top_builddir to the PATH in case the only afmtodit available is
 # the one in the current build.
-devps_fonts: afmtodit font/devps/DESC
+#
+# The AFM files from which these descriptions are produced must be
+# obtained elsewhere, so this target runs only in "maintainer mode".
+devps_font-descriptions: afmtodit font/devps/DESC
 	PATH=$(top_builddir)$(GROFF_PATH_SEPARATOR)$(PATH) \
 	  $(MAKE) -f $(devps_srcdir)/generate/Makefile \
 	  srcdir=$(devps_srcdir)/generate DESC=$(devps_srcdir)/DESC.in
@@ -162,22 +179,15 @@
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
 	&& $(RM) $@ \
 	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
-font/devps/zapfdr.pfa: $(devps_srcdir)/zapfdr.ps
-	$(AM_V_GEN)$(MKDIR_P) font/devps \
-	&& $(RM) $@ \
-	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
-font/devps/symbolsl.pfa: $(devps_srcdir)/symbolsl.ps
+
+.ps.pfa:
 	$(AM_V_GEN)$(MKDIR_P) font/devps \
 	&& $(RM) $@ \
 	&& sed -f $(devps_srcdir)/psstrip.sed $? >$@
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/freeeuro.ps Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/generate/Makefile -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/Makefile Changed

@@ -1,6 +1,4 @@
-# Location: <groff-source>/font/devps/generate/Makefile
-#
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+# Copyright (C) 1989-2022 Free Software Foundation, Inc.
 #      Written by James Clark (jjc@jclark.com)
 #
 # This file is part of groff.
@@ -31,6 +29,9 @@
 # timesr.afm) may be used. See the afmname script.
 afmdir=/usr/local/lib/afm
 
+# Write font descriptions to this directory.
+outdir=$(srcdir)/..
+
 # The symbol font which fits to 'Symbol.afm'.  For the creation of
 # 'symbolsl.afm' we need the 'printafm' script from ghostscript.
 symbolfont=/usr/local/lib/fonts/Symbol.pfb
@@ -61,7 +62,7 @@
 NOLIGFLAG=-n
 TEXTENC=$(srcdir)/../text.enc
 EFLAG=-e $(TEXTENC)
-TEXTMAP=$(srcdir)/textmap
+TEXTMAP=$(srcdir)/text.map
 AFMNAME=$(srcdir)/afmname
 
 RM=rm -f
@@ -71,240 +72,241 @@
 TR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Times-Roman.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 TB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Times-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 TI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) -a 7 \
 	  `$(AFMNAME) $(afmdir)/Times-Italic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 TBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Times-BoldItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Oblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-BoldOblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 CR:
 	$(AFMTODIT) $(NOLIGFLAG) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Courier.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 CB:
 	$(AFMTODIT) $(NOLIGFLAG) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Courier-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 CI:
 	$(AFMTODIT) $(NOLIGFLAG) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Courier-Oblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 CBI:
 	$(AFMTODIT) $(NOLIGFLAG) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Courier-BoldOblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 PR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Palatino-Roman.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 PB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Palatino-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 PI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Palatino-Italic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 PBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Palatino-BoldItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 NR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/NewCenturySchlbk-Roman.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 NB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/NewCenturySchlbk-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 NI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/NewCenturySchlbk-Italic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 NBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/NewCenturySchlbk-BoldItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 BMR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Bookman-Light.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 BMB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Bookman-Demi.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 BMI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Bookman-LightItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 BMBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Bookman-DemiItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 AR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/AvantGarde-Book.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 AB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/AvantGarde-Demi.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 AI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/AvantGarde-BookOblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 ABI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/AvantGarde-DemiOblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HNR:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Narrow.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HNB:
 	$(AFMTODIT) $(EFLAG) $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Narrow-Bold.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HNI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Narrow-Oblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 HNBI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/Helvetica-Narrow-BoldOblique.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 ZCMI:
 	$(AFMTODIT) $(EFLAG) $(IFLAG) \
 	  `$(AFMNAME) $(afmdir)/ZapfChancery-MediumItalic.afm` \
-	  $(TEXTMAP) $@
+	  $(TEXTMAP) $(OUTDIR)/$@
 
 ZD:
 	$(AFMTODIT) -s $(RFLAG) \
 	  `$(AFMNAME) $(afmdir)/ZapfDingbats.afm` \
-	  $(srcdir)/dingbats.map $@
+	  $(srcdir)/dingbats.map $(OUTDIR)/$@
 
-SS: symbolsl.afm
+SS: $(OUTDIR)/symbolsl.afm
 	$(AFMTODIT) -s -x $(IFLAG) \
-	  symbolsl.afm $(srcdir)/lgreekmap $@
+	  $(OUTDIR)/symbolsl.afm $(srcdir)/slanted-symbol.map \
+	  $(OUTDIR)/$@
 
 S: symbol.afm
 	$(AFMTODIT) -s $(RFLAG) \
-	  symbol.afm symbolmap $@
+	  symbol.afm $(srcdir)/symbol.map $(OUTDIR)/$@
 
-ZDR: zapfdr.afm
+ZDR: $(OUTDIR)/zapfdr.afm
 	$(AFMTODIT) -s $(RFLAG) \
-	  zapfdr.afm $(srcdir)/dingbats.rmap $@
+	  $(OUTDIR)/zapfdr.afm $(srcdir)/dingbats-reversed.map \
+	  $(OUTDIR)/$@
 
 # the map is just a dummy
 EURO: freeeuro.afm
 	$(AFMTODIT) $(RFLAG) \
-	  freeeuro.afm symbolmap $@
+	  freeeuro.afm $(srcdir)/symbol.map $(OUTDIR)/$@
 
 freeeuro.afm freeeuro.pfa: $(srcdir)/freeeuro.sfd
-	fontforge -script $(srcdir)/sfdtopfa.pe $(srcdir)/freeeuro.sfd
+	fontforge -script $(srcdir)/sfdtopfa.pe $(srcdir)/freeeuro.sfd \
+	  && mv freeeuro.afm freeeuro.pfa $(OUTDIR)
 
 symbol.afm: $(srcdir)/symbol.sed
-	$(RM) $@
 	sed -f $(srcdir)/symbol.sed `$(AFMNAME) $(afmdir)/Symbol.afm` \
-	  >$@
+	  >$(OUTDIR)/$@
 
 symbolsl.afm: $(srcdir)/symbolsl.awk $(srcdir)/../symbolsl.ps
-	$(RM) $@ Fontmap
-	echo "/Symbol-Slanted ($(srcdir)/../symbolsl.ps) ;"  > Fontmap
-	echo "/Symbol         ($(symbolfont)) ;" >> Fontmap
-	$(PRINTAFM) Symbol-Slanted > tmp.afm
-	awk -f $(srcdir)/symbolsl.awk -v SYMAFM=`$(AFMNAME) \
-	  $(afmdir)/Symbol.afm` tmp.afm >$@
-	$(RM) Fontmap tmp.afm
-
-zapfdr.afm: $(srcdir)/zapfdr.sed
-	$(RM) $@
+	$(RM) Fontmap \
+	  && echo "/Symbol-Slanted ($(srcdir)/../symbolsl.ps) ;" \
+	    > Fontmap \
+	  && echo "/Symbol         ($(symbolfont)) ;" >> Fontmap \
+	  && $(PRINTAFM) Symbol-Slanted > tmp.afm \
+	  && awk -f $(srcdir)/symbolsl.awk -v SYMAFM=`$(AFMNAME) \
+	    $(afmdir)/Symbol.afm` tmp.afm >$(OUTDIR)/$@ \
+	  && $(RM) Fontmap tmp.afm
+
+zapfdr.afm: $(srcdir)/apfdr.sed
 	sed -f $(srcdir)/zapfdr.sed \
-	  `$(AFMNAME) $(afmdir)/ZapfDingbats.afm` >$@
+	  `$(AFMNAME) $(afmdir)/ZapfDingbats.afm` >$(OUTDIR)/$@
 
 ZD: $(srcdir)/dingbats.map
-ZDR: $(srcdir)/dingbats.rmap
+ZDR: $(srcdir)/dingbats-reversed.map
 $(TEXTFONTS): $(TEXTMAP) $(TEXTENC)
-$(SPECIALFONTS): symbolmap
-$(GREEKFONTS): $(srcdir)/lgreekmap
+$(SPECIALFONTS): $(srcdir)/symbol.map
+$(GREEKFONTS): $(srcdir)/slanted-symbol.map
 $(FONTS): $(DESC)
 
-symbolmap: $(TEXTMAP) $(srcdir)/symbolchars
-	echo '#' >$@
-	echo '# This is a list of all predefined groff symbols.' >>$@
-	echo '#' >>$@
-	cat $(TEXTMAP) $(srcdir)/symbolchars >>$@
+$(srcdir)/symbol.map: $(TEXTMAP) $(srcdir)/symbolchars
+	printf \
+	  '#\n# This is a list of all predefined groff symbols.\n#\n' \
+	  > $(OUTDIR)/$@ \
+	  && cat $(TEXTMAP) $(srcdir)/symbolchars >>$@
 
 clean:
-	$(RM) symbolmap symbol.afm
+	cd $(OUTDIR) \
+	  && $(RM) freeeuro.afm freeeuro.pfa symbol.afm \
+	    $(srcdir)/symbol.map symbolsl.afm zapfdr.afm
 
 realclean: clean
-	$(RM) $(FONTS)
+	cd $(OUTDIR) \
+	  && $(RM) $(FONTS)
 
 extraclean: realclean
 	$(RM) core *~ "#*"
 
 .PHONY: all clean realclean extraclean
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile
 # fill-column: 72

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/dingbats-reversed.map Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/generate/make-zapfdr -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/make-zapfdr Changed

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/slanted-symbol.map Changed

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/symbol.map Added

@@ -0,0 +1,449 @@
+#
+# This is a list of all predefined groff symbols.
+#
+#
+# Predefined groff symbols for textual fonts.
+#
+a14 rh
+a a
+A A
+aacute 'a
+Aacute 'A
+acircumflex ^a
+Acircumflex ^A
+acute aa
+adieresis :a
+Adieresis :A
+ae ae
+AE AE
+agrave `a
+Agrave `A
+aleph Ah
+alpha *a
+Alpha *A
+ampersand &
+angle /_
+angleleft la
+angleright ra
+approxequal ~~
+approxequal ~=
+aring oa
+Aring oA
+arrowboth <>
+arrowdblboth hA
+arrowdbldown dA
+arrowdblleft lA
+arrowdblright rA
+arrowdblup uA
+arrowdown da
+arrowhorizex an
+arrowleft <-
+arrowright ->
+arrowupdn va
+arrowup ua
+arrowvertex arrowvertex
+asciicircum ha
+asciitilde ti
+asterisk *
+asteriskmath **
+at @
+at at
+atilde ~a
+Atilde ~A
+backslash \
+backslash rs
+bar |
+bar ba
+b b
+B B
+beta *b
+Beta *B
+braceex barex
+braceex braceex
+braceex braceleftex
+braceex bracerightex
+braceex bv
+braceleft {
+braceleftbt braceleftbt
+braceleftbt lb
+braceleft lC
+braceleftmid braceleftmid
+braceleftmid lk
+bracelefttp bracelefttp
+bracelefttp lt
+braceright }
+bracerightbt bracerightbt
+bracerightbt rb
+bracerightmid bracerightmid
+bracerightmid rk
+braceright rC
+bracerighttp bracerighttp
+bracerighttp rt
+bracketleft 
+bracketleftbt bracketleftbt
+bracketleftbt lf
+bracketleftex bracketleftex
+bracketleft lB
+bracketlefttp bracketlefttp
+bracketlefttp lc
+bracketright 
+bracketrightbt bracketrightbt
+bracketrightbt rf
+bracketrightex bracketrightex
+bracketright rB
+bracketrighttp bracketrighttp
+bracketrighttp rc
+breve ab
+brokenbar bb
+bullet bu
+cacute 'c
+Cacute 'C
+caron ah
+carriagereturn CR
+c c
+C C
+ccedilla ,c
+Ccedilla ,C
+cedilla ac
+cent ct
+checkmark OK
+chi *x
+Chi *X
+circle ci
+circlemultiply c*
+circleplus c+
+circumflex ^
+circumflex a^
+club CL
+colon :
+comma ,
+congruent =~
+copyright co
+currency Cs
+daggerdbl dd
+dagger dg
+d d
+D D
+degree de
+delta *d
+Delta *D
+diamond DI
+dieresis ad
+divide tdi
+dollar $
+dollar Do
+dotaccent a.
+dotlessi .i
+dotlessj .j
+dotmath md
+eacute 'e
+Eacute 'E
+ecircumflex ^e
+Ecircumflex ^E
+edieresis :e
+Edieresis :E
+e e
+E E
+egrave `e
+Egrave `E
+eight 8
+element mo
+emdash em
+emptyset es
+endash en
+epsilon *e
+Epsilon *E
+equal =
+equivalence ==
+eta *y
+Eta *Y
+Eth -D
+eth Sd
+Euro Eu
+exclam !
+exclamdown r!
+existential te
+f f
+F F
+ff ff
+ffi Fi
+ffl Fl
+fi fi
+five 5
+fiveeighths 58
+fl fl
+florin Fn
+four 4
+fraction f/
+gamma *g
+Gamma *G
+germandbls ss
+g g
+G G
+gradient gr
+grave ga
+greater >
+greaterequal >=
+guillemotleft Fo
+guillemotright Fc
+guilsinglleft fo
+guilsinglright fc
+heart HE
+h h
+H H
+hungarumlaut a"
+hyphen -
+hyphen hy
+iacute 'i
+Iacute 'I
+icircumflex ^i
+Icircumflex ^I
+idieresis :i
+Idieresis :I
+Ifraktur Im
+igrave `i
+Igrave `I
+i i
+I I
+ij ij
+IJ IJ
+infinity if
+# the next line overrides the (old) PUA value of the AGL
+integralex u23AE
+integral integral
+integral is
+intersection ca
+iota *i
+Iota *I
+j j
+J J
+kappa *k
+Kappa *K
+k k
+K K
+lambda *l
+Lambda *L
+less <
+lessequal <=
+l l
+L L
+logicaland AN
+logicalnot tno
+logicalor OR
+lozenge lz
+lslash /l
+Lslash /L
+macron a-
+minus \-
+minute fm
+m m
+M M
+mu1 mc
+multiply tmu
+mu *m
+Mu *M
+# if there is "mu1" glyph in the font - comment out the following line
+mu mc
+nine 9
+n n
+N N
+notelement nm
+notequal !=
+notsubset nb
+ntilde ~n
+Ntilde ~N
+numbersign #
+numbersign sh
+nu *n
+Nu *N
+oacute 'o
+Oacute 'O
+ocircumflex ^o
+Ocircumflex ^O
+odieresis :o
+Odieresis :O
+oe oe
+OE OE
+ogonek ho
+ograve `o
+Ograve `O
+omega1 +p
+omega *w
+Omega *W
+omicron *o
+Omicron *O
+one 1
+oneeighth 18
+onehalf 12
+onequarter 14
+onesuperior S1
+o o
+O O
+ordfeminine Of
+ordmasculine Om
+oslash /o
+Oslash /O
+otilde ~o
+Otilde ~O
+overline rn
+paragraph ps
+parenleft (
+parenleftbt parenleftbt
+parenleftex parenleftex
+parenlefttp parenlefttp
+parenright )
+parenrightbt parenrightbt
+parenrightex parenrightex
+parenrighttp parenrighttp
+partialdiff pd
+percent %
+period .
+periodcentered pc
+perpendicular pp
+perthousand %0
+phi1 +f
+phi *f
+Phi *F
+pi *p
+Pi *P
+plus +
+plusminus t+-
+p p
+P P
+product product
+propersubset sb
+propersuperset sp
+proportional pt
+psi *q
+Psi *Q
+q q
+Q Q
+question ?
+questiondown r?
+quotedbl "
+quotedblbase Bq
+quotedbl dq
+quotedblleft lq
+quotedblright rq
+quoteleft `
+quoteleft oq
+quoteright '
+quoteright cq
+quotesinglbase bq
+quotesingle aq
+radicalex radicalex
+radical sqrt
+radical sr
+reflexsubset ib
+reflexsuperset ip
+registered rg
+Rfraktur Re
+rho *r
+Rho *R
+ring ao
+r r
+R R
+scaron vs
+Scaron vS
+second sd
+section sc
+semicolon ;
+seven 7
+seveneighths 78
+SF110000 br
+sigma1 ts
+sigma *s
+Sigma *S
+similar ap
+six 6
+slash /
+slash sl
+spade SP
+s s
+S S
+sterling Po
+suchthat st
+summation sum
+tau *t
+Tau *T
+therefore 3d
+therefore tf
+theta1 +h
+theta *h
+Theta *H
+thorn Tp
+Thorn TP
+three 3
+threeeighths 38
+threequarters 34
+threesuperior S3
+tilde ~
+tilde a~
+trademark tm
+t t
+T T
+two 2
+twosuperior S2
+uacute 'u
+Uacute 'U
+ucircumflex ^u
+Ucircumflex ^U
+udieresis :u
+Udieresis :U
+ugrave `u
+Ugrave `U
+underscore _
+uni03F5 +e
+uni210F -h
+uni210F hbar
+uni21D5 vA
+uni2210 coproduct
+uni2213 -+
+uni2243 |=
+uni2262 ne
+uni226A >>
+uni226B <<
+uni2285 nc
+uni25A1 sq
+uni261C lh
+union cu
+universal fa
+upsilon *u
+u u
+U U
+v v
+V V
+weierstrass wp
+w w
+W W
+xi *c
+Xi *C
+x x
+X X
+yacute 'y
+Yacute 'Y
+ydieresis :y
+Ydieresis :Y
+yen Ye
+y y
+Y Y
+zcaron vz
+Zcaron vZ
+zero 0
+zeta *z
+Zeta *Z
+z z
+Z Z
+#
+# Additional predefined groff symbols for special fonts.
+#
+arrowdown arrowvertbt
+arrowup arrowverttp
+divide di
+equal eq
+logicalnot no
+minus mi
+multiply mu
+plusminus +-
+plus pl
+Upsilon1 *U

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/generate/text.map Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devps/psstrip.sed -> _service:tar_scm:groff-1.23.0.tar.gz/font/devps/psstrip.sed Changed

_service:tar_scm:groff-1.23.0.tar.gz/font/devps/symbolsl.afm Added

@@ -0,0 +1,225 @@
+StartFontMetrics 2.0
+Comment Copyright (c) 1985, 1987, 1989, 1990, 1997 Adobe Systems Incorporated. All rights reserved.
+Comment Creation Date: Thu May  1 15:12:25 1997
+Comment UniqueID 43064
+Comment VMusage 30820 39997
+EncodingScheme FontSpecific
+Comment UniqueID 5021339
+FontName Symbol-Slanted
+Weight Regular
+IsFixedPitch false
+UnderlinePosition -229
+FamilyName Standard Symbols PS
+FullName Standard Symbols PS Slanted
+Version 2.00
+Copyright Copyright URW Software, Copyright 2015 by URW
+ItalicAngle 0.0
+UnderlineThickness 46
+Notice URW Software, Copyright 2015 by URW
+FontBBox -180 -293 1090 1010
+StartCharMetrics 203
+C 32 ; WX 250 ; N space ; B 250 0 250 0 ;
+C 33 ; WX 333 ; N exclam ; B 128 -13 240 686 ;
+C 34 ; WX 713 ; N universal ; B 31 0 681 673 ;
+C 35 ; WX 500 ; N numbersign ; B 20 0 481 631 ;
+C 36 ; WX 549 ; N existential ; B 25 0 478 673 ;
+C 37 ; WX 833 ; N percent ; B 63 -7 771 673 ;
+C 38 ; WX 778 ; N ampersand ; B 41 -13 750 675 ;
+C 39 ; WX 439 ; N suchthat ; B 48 -13 414 503 ;
+C 40 ; WX 333 ; N parenleft ; B 53 -172 300 680 ;
+C 41 ; WX 333 ; N parenright ; B 30 -172 277 680 ;
+C 42 ; WX 500 ; N asteriskmath ; B 65 127 427 546 ;
+C 43 ; WX 549 ; N plus ; B 10 0 539 533 ;
+C 44 ; WX 250 ; N comma ; B 56 -120 194 102 ;
+C 45 ; WX 549 ; N minus ; B 11 239 535 294 ;
+C 46 ; WX 250 ; N period ; B 69 -13 181 100 ;
+C 47 ; WX 278 ; N slash ; B 0 0 254 673 ;
+C 48 ; WX 500 ; N zero ; B 23 -13 471 686 ;
+C 49 ; WX 500 ; N one ; B 117 0 390 673 ;
+C 50 ; WX 500 ; N two ; B 25 0 475 686 ;
+C 51 ; WX 500 ; N three ; B 39 -13 435 686 ;
+C 52 ; WX 500 ; N four ; B 16 0 469 680 ;
+C 53 ; WX 500 ; N five ; B 29 -13 443 699 ;
+C 54 ; WX 500 ; N six ; B 36 -13 467 685 ;
+C 55 ; WX 500 ; N seven ; B 24 -7 448 673 ;
+C 56 ; WX 500 ; N eight ; B 54 -13 440 686 ;
+C 57 ; WX 500 ; N nine ; B 31 -13 460 686 ;
+C 58 ; WX 278 ; N colon ; B 81 -13 193 463 ;
+C 59 ; WX 278 ; N semicolon ; B 83 -120 221 463 ;
+C 60 ; WX 549 ; N less ; B 26 0 523 522 ;
+C 61 ; WX 549 ; N equal ; B 11 142 537 391 ;
+C 62 ; WX 549 ; N greater ; B 26 0 523 522 ;
+C 63 ; WX 444 ; N question ; B 70 -13 412 686 ;
+C 64 ; WX 549 ; N congruent ; B 11 0 537 475 ;
+C 65 ; WX 722 ; N Alpha ; B 4 0 684 673 ;
+C 66 ; WX 667 ; N Beta ; B 29 0 592 673 ;
+C 67 ; WX 722 ; N Chi ; B -9 0 704 673 ;
+C 68 ; WX 612 ; N Delta ; B 6 0 608 688 ;
+C 69 ; WX 611 ; N Epsilon ; B 32 0 617 673 ;
+C 70 ; WX 763 ; N Phi ; B 26 0 742 673 ;
+C 71 ; WX 603 ; N Gamma ; B 24 0 609 673 ;
+C 72 ; WX 722 ; N Eta ; B 39 0 729 673 ;
+C 73 ; WX 333 ; N Iota ; B 32 0 316 673 ;
+C 74 ; WX 631 ; N theta1 ; B 18 -13 623 686 ;
+C 75 ; WX 722 ; N Kappa ; B 35 0 722 673 ;
+C 76 ; WX 686 ; N Lambda ; B 6 0 680 688 ;
+C 77 ; WX 889 ; N Mu ; B 28 0 887 673 ;
+C 78 ; WX 722 ; N Nu ; B 29 0 720 673 ;
+C 79 ; WX 722 ; N Omicron ; B 41 -13 715 686 ;
+C 80 ; WX 768 ; N Pi ; B 25 0 745 673 ;
+C 81 ; WX 741 ; N Theta ; B 41 -13 715 686 ;
+C 82 ; WX 556 ; N Rho ; B 28 0 563 673 ;
+C 83 ; WX 592 ; N Sigma ; B 5 0 589 673 ;
+C 84 ; WX 611 ; N Tau ; B 33 0 607 673 ;
+C 85 ; WX 690 ; N Upsilon ; B -8 0 694 673 ;
+C 86 ; WX 439 ; N sigma1 ; B 40 -222 436 513 ;
+C 87 ; WX 768 ; N Omega ; B 34 0 736 686 ;
+C 88 ; WX 645 ; N Xi ; B 40 0 599 673 ;
+C 89 ; WX 795 ; N Psi ; B 15 0 780 686 ;
+C 90 ; WX 611 ; N Zeta ; B 44 0 636 673 ;
+C 91 ; WX 333 ; N bracketleft ; B 86 -165 299 673 ;
+C 92 ; WX 863 ; N therefore ; B 163 -13 701 433 ;
+C 93 ; WX 333 ; N bracketright ; B 33 -165 246 673 ;
+C 94 ; WX 658 ; N perpendicular ; B 15 0 652 673 ;
+C 95 ; WX 500 ; N underscore ; B -2 -252 502 -206 ;
+C 96 ; WX 500 ; N radicalex ; B 480 857 1090 913 ;
+C 97 ; WX 631 ; N alpha ; B 41 -13 622 513 ;
+C 98 ; WX 549 ; N beta ; B 61 -222 515 740 ;
+C 99 ; WX 549 ; N chi ; B 12 -210 522 513 ;
+C 100 ; WX 494 ; N delta ; B 40 -13 481 740 ;
+C 101 ; WX 439 ; N epsilon ; B 22 -13 427 513 ;
+C 102 ; WX 521 ; N phi ; B 27 -222 490 686 ;
+C 103 ; WX 411 ; N gamma ; B 5 -219 484 513 ;
+C 104 ; WX 603 ; N eta ; B 0 -222 527 513 ;
+C 105 ; WX 329 ; N iota ; B 0 -13 301 513 ;
+C 106 ; WX 603 ; N phi1 ; B 36 -222 587 513 ;
+C 107 ; WX 549 ; N kappa ; B 33 0 558 513 ;
+C 108 ; WX 549 ; N lambda ; B 24 -13 548 740 ;
+C 109 ; WX 576 ; N mu ; B 33 -219 567 500 ;
+C 110 ; WX 521 ; N nu ; B -9 -13 475 513 ;
+C 111 ; WX 549 ; N omicron ; B 35 -13 501 513 ;
+C 112 ; WX 549 ; N pi ; B 10 -13 530 500 ;
+C 113 ; WX 521 ; N theta ; B 43 -13 485 686 ;
+C 114 ; WX 549 ; N rho ; B 50 -220 490 513 ;
+C 115 ; WX 603 ; N sigma ; B 30 -13 588 500 ;
+C 116 ; WX 439 ; N tau ; B 10 -13 418 500 ;
+C 117 ; WX 576 ; N upsilon ; B 7 -13 535 513 ;
+C 118 ; WX 713 ; N omega1 ; B 12 -13 671 583 ;
+C 119 ; WX 686 ; N omega ; B 42 -13 684 513 ;
+C 120 ; WX 493 ; N xi ; B 27 -222 469 766 ;
+C 121 ; WX 686 ; N psi ; B 12 -222 701 513 ;
+C 122 ; WX 494 ; N zeta ; B 60 -222 467 756 ;
+C 123 ; WX 480 ; N braceleft ; B 58 -165 397 673 ;
+C 124 ; WX 200 ; N bar ; B 65 -177 135 673 ;
+C 125 ; WX 480 ; N braceright ; B 79 -165 418 673 ;
+C 126 ; WX 549 ; N similar ; B 17 196 529 325 ;
+C 128 ; WX 790 ; N apple ; B 56 -4 733 808 ;
+C 160 ; WX 750 ; N Euro ; B 47 -4 716 671 ;
+C 161 ; WX 620 ; N Upsilon1 ; B -2 0 610 687 ;
+C 162 ; WX 247 ; N minute ; B 27 476 228 735 ;
+C 163 ; WX 549 ; N lessequal ; B 29 0 526 639 ;
+C 164 ; WX 167 ; N fraction ; B -180 0 340 673 ;
+C 165 ; WX 713 ; N infinity ; B 26 115 688 414 ;
+C 166 ; WX 500 ; N florin ; B 2 -174 494 687 ;
+C 167 ; WX 753 ; N club ; B 86 -26 660 544 ;
+C 168 ; WX 753 ; N diamond ; B 142 -36 600 550 ;
+C 169 ; WX 753 ; N heart ; B 117 -33 631 528 ;
+C 170 ; WX 753 ; N spade ; B 113 -36 629 591 ;
+C 171 ; WX 1042 ; N arrowboth ; B 24 -16 1024 512 ;
+C 172 ; WX 987 ; N arrowleft ; B 32 -15 942 511 ;
+C 173 ; WX 603 ; N arrowup ; B 45 0 571 910 ;
+C 174 ; WX 987 ; N arrowright ; B 49 -15 959 511 ;
+C 175 ; WX 603 ; N arrowdown ; B 45 -22 571 888 ;
+C 176 ; WX 400 ; N degree ; B 50 380 350 686 ;
+C 177 ; WX 549 ; N plusminus ; B 10 0 539 662 ;
+C 178 ; WX 411 ; N second ; B 20 476 413 735 ;
+C 179 ; WX 549 ; N greaterequal ; B 29 0 526 639 ;
+C 180 ; WX 549 ; N multiply ; B 17 9 533 525 ;
+C 181 ; WX 713 ; N proportional ; B 27 114 639 413 ;
+C 182 ; WX 494 ; N partialdiff ; B 26 -10 462 753 ;
+C 183 ; WX 460 ; N bullet ; B 50 155 410 518 ;
+C 184 ; WX 549 ; N divide ; B 10 2 536 525 ;
+C 185 ; WX 549 ; N notequal ; B 15 -25 540 549 ;
+C 186 ; WX 549 ; N equivalence ; B 14 87 538 446 ;
+C 187 ; WX 549 ; N approxequal ; B 14 121 527 408 ;
+C 188 ; WX 1000 ; N ellipsis ; B 111 -13 889 100 ;
+C 189 ; WX 603 ; N arrowvertex ; B 280 -120 336 1010 ;
+C 190 ; WX 1000 ; N arrowhorizex ; B -60 220 1050 276 ;
+C 191 ; WX 658 ; N carriagereturn ; B 15 -16 602 629 ;
+C 192 ; WX 823 ; N aleph ; B 175 0 661 689 ;
+C 193 ; WX 686 ; N Ifraktur ; B 10 -54 578 736 ;
+C 194 ; WX 795 ; N Rfraktur ; B 26 -16 759 730 ;
+C 195 ; WX 987 ; N weierstrass ; B 159 -211 870 574 ;
+C 196 ; WX 768 ; N circlemultiply ; B 43 0 733 691 ;
+C 197 ; WX 768 ; N circleplus ; B 43 0 733 689 ;
+C 198 ; WX 823 ; N emptyset ; B 39 -24 781 718 ;
+C 199 ; WX 768 ; N intersection ; B 40 0 732 507 ;
+C 200 ; WX 768 ; N union ; B 40 -18 732 489 ;
+C 201 ; WX 713 ; N propersuperset ; B 20 0 673 470 ;
+C 202 ; WX 713 ; N reflexsuperset ; B 20 -125 673 470 ;
+C 203 ; WX 713 ; N notsubset ; B 36 -70 690 540 ;
+C 204 ; WX 713 ; N propersubset ; B 37 0 690 470 ;
+C 205 ; WX 713 ; N reflexsubset ; B 37 -125 690 470 ;
+C 206 ; WX 713 ; N element ; B 45 0 505 470 ;
+C 207 ; WX 713 ; N notelement ; B 45 -58 505 555 ;
+C 208 ; WX 768 ; N angle ; B 26 -1 738 672 ;
+C 209 ; WX 713 ; N gradient ; B 36 0 681 687 ;
+C 210 ; WX 790 ; N registerserif ; B 50 -13 740 690 ;
+C 211 ; WX 790 ; N copyrightserif ; B 51 -13 741 690 ;
+C 212 ; WX 890 ; N trademarkserif ; B 18 269 855 673 ;
+C 213 ; WX 823 ; N product ; B 25 -124 803 751 ;
+C 214 ; WX 549 ; N radical ; B 10 -35 515 913 ;
+C 215 ; WX 250 ; N dotmath ; B 69 209 169 311 ;
+C 216 ; WX 713 ; N logicalnot ; B 15 40 680 367 ;
+C 217 ; WX 603 ; N logicaland ; B 23 -1 583 476 ;
+C 218 ; WX 603 ; N logicalor ; B 30 -1 578 476 ;
+C 219 ; WX 1042 ; N arrowdblboth ; B 27 -19 1023 506 ;
+C 220 ; WX 987 ; N arrowdblleft ; B 30 -19 939 506 ;
+C 221 ; WX 603 ; N arrowdblup ; B 39 0 567 909 ;
+C 222 ; WX 987 ; N arrowdblright ; B 45 -19 954 506 ;
+C 223 ; WX 603 ; N arrowdbldown ; B 44 0 572 909 ;
+C 224 ; WX 494 ; N lozenge ; B 18 -1 466 740 ;
+C 225 ; WX 329 ; N angleleft ; B 25 -152 306 757 ;
+C 226 ; WX 790 ; N registersans ; B 50 -12 740 679 ;
+C 227 ; WX 790 ; N copyrightsans ; B 49 -12 739 679 ;
+C 228 ; WX 786 ; N trademarksans ; B 5 277 725 673 ;
+C 229 ; WX 713 ; N summation ; B 14 -123 695 752 ;
+C 230 ; WX 384 ; N parenlefttp ; B 40 -293 436 926 ;
+C 231 ; WX 384 ; N parenleftex ; B 40 -79 92 925 ;
+C 232 ; WX 384 ; N parenleftbt ; B 40 -293 436 926 ;
+C 233 ; WX 384 ; N bracketlefttp ; B 0 -80 341 926 ;
+C 234 ; WX 384 ; N bracketleftex ; B 0 -85 55 925 ;
+C 235 ; WX 384 ; N bracketleftbt ; B 0 -80 340 926 ;
+C 236 ; WX 494 ; N bracelefttp ; B 201 -75 439 926 ;
+C 237 ; WX 494 ; N braceleftmid ; B 14 -85 255 935 ;
+C 238 ; WX 494 ; N braceleftbt ; B 201 -70 439 926 ;
+C 239 ; WX 494 ; N braceex ; B 201 -79 255 925 ;
+C 241 ; WX 329 ; N angleright ; B 21 -152 302 757 ;
+C 242 ; WX 274 ; N integral ; B 2 -107 291 916 ;
+C 243 ; WX 686 ; N integraltp ; B 332 -83 715 922 ;
+C 244 ; WX 686 ; N integralex ; B 332 -88 415 975 ;
+C 245 ; WX 686 ; N integralbt ; B 39 -81 415 921 ;
+C 246 ; WX 384 ; N parenrighttp ; B 54 -293 450 926 ;
+C 247 ; WX 384 ; N parenrightex ; B 398 -70 450 935 ;
+C 248 ; WX 384 ; N parenrightbt ; B 54 -293 450 926 ;
+C 249 ; WX 384 ; N bracketrighttp ; B 22 -80 360 926 ;
+C 250 ; WX 384 ; N bracketrightex ; B 305 -85 360 925 ;
+C 251 ; WX 384 ; N bracketrightbt ; B 20 -80 360 926 ;
+C 252 ; WX 494 ; N bracerighttp ; B 17 -75 255 926 ;
+C 253 ; WX 494 ; N bracerightmid ; B 204 -85 445 935 ;
+C 254 ; WX 494 ; N bracerightbt ; B 17 -70 255 926 ;
+C -1 ; WX 549 ; N thereexists ; B 25 0 478 673 ;
+C -1 ; WX 713 ; N superset ; B 20 0 673 470 ;
+C -1 ; WX 750 ; N euro ; B 47 -4 716 671 ;
+C -1 ; WX 768 ; N Ohm ; B 34 0 736 686 ;
+C -1 ; WX 250 ; N spacehackarabic ; B 250 0 250 0 ;
+C -1 ; WX 549 ; N tildeoperator ; B 17 196 529 325 ;
+C -1 ; WX 753 ; N heartsuitblack ; B 117 -33 631 528 ;
+C -1 ; WX 713 ; N subset ; B 37 0 690 470 ;
+C -1 ; WX 620 ; N Upsilonhooksymbol ; B -2 0 610 687 ;
+C -1 ; WX 713 ; N notelementof ; B 45 -58 505 555 ;
+C -1 ; WX 753 ; N clubsuitblack ; B 86 -26 660 544 ;
+C -1 ; WX 631 ; N thetasymbolgreek ; B 18 -13 623 686 ;
+C -1 ; WX 713 ; N pisymbolgreek ; B 12 -13 671 583 ;
+EndCharMetrics
+EndFontMetrics

_service:tar_scm:groff-1.22.4.tar.gz/font/devutf8/NOTES -> _service:tar_scm:groff-1.23.0.tar.gz/font/devutf8/NOTES Changed

@@ -1,53 +1,47 @@
-Note that all \charXXX entity names have been removed from the font files.
-They don't make sense for Unicode.
+All \charXXX special character names have been removed from the font
+files.  They don't make sense for Unicode.
 
-The following entity from the original troff manual (by Ossanna and
-Kernighan) is unmapped:
+The following special character name from the AT&T troff manual by
+Ossanna and Kernighan is unmapped:
 
   bs    shaded solid ball (Bell System logo, AT&T logo)
 
-Character 0x002D has not been given a name because its Unicode name
+Code point 0x002D has not been given a name because its Unicode name
 HYPHEN-MINUS is so ambiguous that it is unusable for serious typographic
-use.
+work.
 
 \wp has been mapped to 0x2118, because according to Unicode 4.1's
 NamesList.txt, U+2118 SCRIPT CAPITAL P is really a Weierstrass 'p',
 neither SCRIPT nor CAPITAL.
 
 The following line could be added; \space is known to devps but is not
-documented and not known to devdvi (actually, there is no space glyph within
-the TeX system).
+documented and not known to devdvi (actually, there is no space glyph
+within the TeX system).
 
   space   24   0   0x0020
 
-devps maps \a~ and '~' to 'asciitilde', which is equivalent to 0x02DC, but
-this glyph is just too small.  We map them to 0x007E instead.
+devps maps \*U to 'Upsilon1', which is equivalent to 0x03D2.  We map
+it to 0x03A5 instead.
 
-devps maps \a^ and '^' to 'circumflex', which is equivalent to 0x02C6, but
-this glyph is just too small.  We map them to 0x005E instead.
+devps maps \*W to 'Omega', which is equivalent to either 0x2126 or
+0x03A9.  We map it to 0x03A9.
 
-devps maps \*U to 'Upsilon1', which is equivalent to 0x03D2.  We map it to
-0x03A5 instead.
-
-devps maps \*W to 'Omega', which is equivalent to either 0x2126 or 0x03A9.
-We map it to 0x03A9.
-
-devps maps \*D to 'Delta', which is equivalent to either 0x2206 or 0x0394.
-We map it to 0x0394.
+devps maps \*D to 'Delta', which is equivalent to either 0x2206 or
+0x0394.  We map it to 0x0394.
 
 
 Adding Unicode characters
 -------------------------
 
 Assume you want to use a Unicode character not provided in the list, say
-U+20AC. You need to do two things:
+U+20AC.  You need to do two things:
 
 - Add a line
 
     u20AC   24   0   0x20AC
 
   (the second column is computed as 24 * wcwidth(0x20AC)) to the file
-  R.proto, or, when groff is already installed, to the four fonts files in
-  $(prefix)/share/groff/<version>/font/devutf8/.
+  R.proto, or, when groff is already installed, to the four font
+  description files in $(prefix)/share/groff/<version>/font/devutf8/.
 
 - In your source file, use the notation \u20AC to access it.

_service:tar_scm:groff-1.22.4.tar.gz/font/devutf8/R.proto -> _service:tar_scm:groff-1.23.0.tar.gz/font/devutf8/R.proto Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/devutf8/devutf8.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/devutf8/devutf8.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of 'groff'.
 #
@@ -39,20 +37,23 @@
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(RM) $@ \
 	&& $(SHELL) $(GENFONTSSH) $(devutf8_srcdir)/R.proto \
-	     $(DEVUTF8RES) $(DEVUTF8CPI) `basename $@` > $@
+	  $(DEVUTF8RES) $(DEVUTF8CPI) `basename $@` >$@
 
 font/devutf8/DESC: $(devutf8_srcdir)/DESC.proto
 	$(AM_V_GEN)$(MKDIR_P) `dirname $@` \
 	&& $(SHELL) $(GENDESCSH) $(devutf8_srcdir)/DESC.proto \
-	     $(DEVUTF8RES) $(DEVUTF8CPI) $(DEVUTF8LPI) $(DEVUTF8FONTS) > $@
+	  $(DEVUTF8RES) $(DEVUTF8CPI) $(DEVUTF8LPI) $(DEVUTF8FONTS) >$@
+
+# (UTF-8-encoded) text documents to be produced by troff should depend
+# on this stamp file to ensure that grotty's device and font description
+# files are available.
+MOSTLYCLEANFILES += font/devutf8/stamp
+font/devutf8/stamp: font/devutf8/DESC $(DEVUTF8FONTSFILES)
+	$(AM_V_at)>$@
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/font/scripts/scripts.am -> _service:tar_scm:groff-1.23.0.tar.gz/font/scripts/scripts.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/font/util/make-Rproto -> _service:tar_scm:groff-1.23.0.tar.gz/font/util/make-Rproto Changed

_service:tar_scm:groff-1.22.4.tar.gz/gendef.sh -> _service:tar_scm:groff-1.23.0.tar.gz/gendef.sh Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/00gnulib.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/00gnulib.m4 Changed

@@ -1,43 +1,82 @@
-# 00gnulib.m4 serial 3
-dnl Copyright (C) 2009-2018 Free Software Foundation, Inc.
+# 00gnulib.m4 serial 8
+dnl Copyright (C) 2009-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 dnl This file must be named something that sorts before all other
-dnl gnulib-provided .m4 files.  It is needed until such time as we can
-dnl assume Autoconf 2.64, with its improved AC_DEFUN_ONCE and
-dnl m4_divert semantics.
+dnl gnulib-provided .m4 files.  It is needed until the clang fix has
+dnl been included in Autoconf.
 
-# Until autoconf 2.63, handling of the diversion stack required m4_init
-# to be called first; but this does not happen with aclocal.  Wrapping
-# the entire execution in another layer of the diversion stack fixes this.
-# Worse, prior to autoconf 2.62, m4_wrap depended on the underlying m4
-# for whether it was FIFO or LIFO; in order to properly balance with
-# m4_init, we need to undo our push just before anything wrapped within
-# the m4_init body.  The way to ensure this is to wrap both sides of
-# m4_init with a one-shot macro that does the pop at the right time.
-m4_ifndef(_m4_divert_diversion,
-m4_divert_push(KILL)
-m4_define(gl_divert_fixup, m4_divert_pop()m4_define($0))
-m4_define(m4_init,
-  gl_divert_fixup()m4_defn(m4_init)gl_divert_fixup()))
-
-
-# AC_DEFUN_ONCE(NAME, VALUE)
-# ----------------------------
-# Define NAME to expand to VALUE on the first use (whether by direct
-# expansion, or by AC_REQUIRE), and to nothing on all subsequent uses.
-# Avoid bugs in AC_REQUIRE in Autoconf 2.63 and earlier.  This
-# definition is slower than the version in Autoconf 2.64, because it
-# can only use interfaces that existed since 2.59; but it achieves the
-# same effect.  Quoting is necessary to avoid confusing Automake.
-m4_version_prereq(2.63.263, ,
-m4_define(AC_DEFUN_ONCE,
-  AC_DEFUN($1,
-    AC_REQUIRE(_gl_DEFUN_ONCE($1),
-      m4_indir(_gl_DEFUN_ONCE($1))))dnl
-AC_DEFUN(_gl_DEFUN_ONCE($1), $2)))
+# The following definitions arrange to use a compiler option
+# -Werror=implicit-function-declaration in AC_CHECK_DECL, when the
+# compiler is clang.  Without it, clang implicitly declares "known"
+# library functions in C mode, but not in C++ mode, which would cause
+# Gnulib to omit a declaration and thus later produce an error in C++
+# mode.  As of clang 9.0, these "known" functions are identified through
+# LIBBUILTIN invocations in the LLVM source file
+# llvm/tools/clang/include/clang/Basic/Builtins.def.
+# It's not possible to AC_REQUIRE the extra tests from AC_CHECK_DECL,
+# because AC_CHECK_DECL, like other Autoconf built-ins, is not supposed
+# to AC_REQUIRE anything: some configure.ac files have their first
+# AC_CHECK_DECL executed conditionally.  Therefore append the extra tests
+# to AC_PROG_CC.
+AC_DEFUN(gl_COMPILER_CLANG,
+
+dnl AC_REQUIRE(AC_PROG_CC)
+  AC_CACHE_CHECK(whether the compiler is clang,
+    gl_cv_compiler_clang,
+    dnl Use _AC_COMPILE_IFELSE instead of AC_EGREP_CPP, to avoid error
+     dnl "circular dependency of AC_LANG_COMPILER(C)" if AC_PROG_CC has
+     dnl not yet been invoked.
+     _AC_COMPILE_IFELSE(
+        AC_LANG_PROGRAM(
+           #ifdef __clang__
+           barfbarf
+           #endif
+           ,)
+        ,
+        gl_cv_compiler_clang=no,
+        gl_cv_compiler_clang=yes)
+    )
+)
+AC_DEFUN(gl_COMPILER_PREPARE_CHECK_DECL,
+
+dnl AC_REQUIRE(AC_PROG_CC)
+dnl AC_REQUIRE(gl_COMPILER_CLANG)
+  AC_CACHE_CHECK(for compiler option needed when checking for declarations,
+    gl_cv_compiler_check_decl_option,
+    if test $gl_cv_compiler_clang = yes; then
+       dnl Test whether the compiler supports the option
+       dnl '-Werror=implicit-function-declaration'.
+       save_ac_compile="$ac_compile"
+       ac_compile="$ac_compile -Werror=implicit-function-declaration"
+       dnl Use _AC_COMPILE_IFELSE instead of AC_COMPILE_IFELSE, to avoid a
+       dnl warning "AC_COMPILE_IFELSE was called before AC_USE_SYSTEM_EXTENSIONS".
+       _AC_COMPILE_IFELSE(AC_LANG_PROGRAM(,),
+         gl_cv_compiler_check_decl_option='-Werror=implicit-function-declaration',
+         gl_cv_compiler_check_decl_option=none)
+       ac_compile="$save_ac_compile"
+     else
+       gl_cv_compiler_check_decl_option=none
+     fi
+    )
+  if test "x$gl_cv_compiler_check_decl_option" != xnone; then
+    ac_compile_for_check_decl="$ac_compile $gl_cv_compiler_check_decl_option"
+  else
+    ac_compile_for_check_decl="$ac_compile"
+  fi
+)
+dnl Redefine _AC_CHECK_DECL_BODY so that it references ac_compile_for_check_decl
+dnl instead of ac_compile.  If, for whatever reason, the override of AC_PROG_CC
+dnl in zzgnulib.m4 is inactive, use the original ac_compile.
+m4_define(_AC_CHECK_DECL_BODY,
+  ac_save_ac_compile="$ac_compile"
+  if test -n "$ac_compile_for_check_decl"; then
+    ac_compile="$ac_compile_for_check_decl"
+  fi
+m4_defn(_AC_CHECK_DECL_BODY)  ac_compile="$ac_save_ac_compile"
+)
 
 # gl_00GNULIB
 # -----------

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/absolute-header.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/absolute-header.m4 Changed

@@ -1,5 +1,5 @@
-# absolute-header.m4 serial 16
-dnl Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# absolute-header.m4 serial 17
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -22,23 +22,21 @@
 AC_DEFUN(gl_ABSOLUTE_HEADER,
 AC_REQUIRE(AC_CANONICAL_HOST)
 AC_LANG_PREPROC_REQUIRE()dnl
-dnl FIXME: gl_absolute_header and ac_header_exists must be used unquoted
-dnl until we can assume autoconf 2.64 or newer.
 m4_foreach_w(gl_HEADER_NAME, $1,
   AS_VAR_PUSHDEF(gl_absolute_header,
                   gl_cv_absolute_m4_defn(gl_HEADER_NAME))dnl
   AC_CACHE_CHECK(absolute name of <m4_defn(gl_HEADER_NAME)>,
-    m4_defn(gl_absolute_header),
+    gl_absolute_header,
     AS_VAR_PUSHDEF(ac_header_exists,
                     ac_cv_header_m4_defn(gl_HEADER_NAME))dnl
     AC_CHECK_HEADERS_ONCE(m4_defn(gl_HEADER_NAME))dnl
-    if test AS_VAR_GET(ac_header_exists) = yes; then
+    if test AS_VAR_GET(ac_header_exists) = yes; then
       gl_ABSOLUTE_HEADER_ONE(m4_defn(gl_HEADER_NAME))
     fi
     AS_VAR_POPDEF(ac_header_exists)dnl
     )dnl
   AC_DEFINE_UNQUOTED(AS_TR_CPP(ABSOLUTE_m4_defn(gl_HEADER_NAME)),
-                     "AS_VAR_GET(gl_absolute_header)",
+                     "AS_VAR_GET(gl_absolute_header)",
                      Define this to an absolute name of <m4_defn(gl_HEADER_NAME)>.)
   AS_VAR_POPDEF(gl_absolute_header)dnl
 )dnl

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/alloca.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/alloca.m4 Changed

@@ -1,5 +1,5 @@
-# alloca.m4 serial 14
-dnl Copyright (C) 2002-2004, 2006-2007, 2009-2018 Free Software Foundation,
+# alloca.m4 serial 21
+dnl Copyright (C) 2002-2004, 2006-2007, 2009-2023 Free Software Foundation,
 dnl Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
@@ -26,30 +26,35 @@
       AC_DEFINE(HAVE_ALLOCA, 1,
         Define to 1 if you have 'alloca' after including <alloca.h>,
          a header that may be supplied by this distribution.)
-      ALLOCA_H=alloca.h
+      GL_GENERATE_ALLOCA_H=true
     else
       dnl alloca exists as a library function, i.e. it is slow and probably
       dnl a memory leak. Don't define HAVE_ALLOCA in this case.
-      ALLOCA_H=
+      GL_GENERATE_ALLOCA_H=false
     fi
   else
-    ALLOCA_H=alloca.h
+    GL_GENERATE_ALLOCA_H=true
   fi
-  AC_SUBST(ALLOCA_H)
-  AM_CONDITIONAL(GL_GENERATE_ALLOCA_H, test -n "$ALLOCA_H")
+
+  if test $ac_cv_working_alloca_h = yes; then
+    HAVE_ALLOCA_H=1
+  else
+    HAVE_ALLOCA_H=0
+  fi
+  AC_SUBST(HAVE_ALLOCA_H)
 )
 
 # Prerequisites of lib/alloca.c.
 # STACK_DIRECTION is already handled by AC_FUNC_ALLOCA.
 AC_DEFUN(gl_PREREQ_ALLOCA, :)
 
-# This works around a bug in autoconf <= 2.68.
-# See <https://lists.gnu.org/r/bug-gnulib/2011-06/msg00277.html>.
+m4_version_prereq(2.70, , 
 
-m4_version_prereq(2.69,  ,
-
-# This is taken from the following Autoconf patch:
-# https://git.savannah.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=6cd9f12520b0d6f76d3230d7565feba1ecf29497
+# This works around a bug in autoconf <= 2.68 and has simplifications
+# from 2.70.  See:
+# https://lists.gnu.org/r/bug-gnulib/2011-06/msg00277.html
+# https://git.savannah.gnu.org/cgit/autoconf.git/commit/?id=6cd9f12520b0d6f76d3230d7565feba1ecf29497
+# https://git.savannah.gnu.org/cgit/autoconf.git/commit/?id=15edf7fd8094fd14a89d9891dd72a9624762597a
 
 # _AC_LIBOBJ_ALLOCA
 # -----------------
@@ -65,26 +70,6 @@
 AC_SUBST(ALLOCA, \${LIBOBJDIR}alloca.$ac_objext)dnl
 AC_DEFINE(C_ALLOCA, 1, Define to 1 if using 'alloca.c'.)
 
-AC_CACHE_CHECK(whether 'alloca.c' needs Cray hooks, ac_cv_os_cray,
-AC_EGREP_CPP(webecray,
-#if defined CRAY && ! defined CRAY2
-webecray
-#else
-wenotbecray
-#endif
-, ac_cv_os_cray=yes, ac_cv_os_cray=no))
-if test $ac_cv_os_cray = yes; then
-  for ac_func in _getb67 GETB67 getb67; do
-    AC_CHECK_FUNC($ac_func,
-                  AC_DEFINE_UNQUOTED(CRAY_STACKSEG_END, $ac_func,
-                                      Define to one of '_getb67', 'GETB67',
-                                       'getb67' for Cray-2 and Cray-YMP
-                                       systems. This function is required for
-                                       'alloca.c' support on those systems.)
-    break)
-  done
-fi
-
 AC_CACHE_CHECK(stack direction for C alloca,
                ac_cv_c_stack_direction,
 AC_RUN_IFELSE(AC_LANG_SOURCE(
@@ -115,7 +100,7 @@
         STACK_DIRECTION > 0 => grows toward higher addresses
         STACK_DIRECTION < 0 => grows toward lower addresses
         STACK_DIRECTION = 0 => direction of growth unknown */
-@%:@undef STACK_DIRECTION)dnl
+#undef STACK_DIRECTION)dnl
 AC_DEFINE_UNQUOTED(STACK_DIRECTION, $ac_cv_c_stack_direction)
 )# _AC_LIBOBJ_ALLOCA
 )

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/assert_h.m4 Added

@@ -0,0 +1,67 @@
+# assert-h.m4
+dnl Copyright (C) 2011-2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+dnl From Paul Eggert.
+
+AC_DEFUN(gl_ASSERT_H,
+
+  AC_CACHE_CHECK(for static_assert, gl_cv_static_assert,
+    gl_save_CFLAGS=$CFLAGS
+     for gl_working in "yes, a keyword" "yes, an <assert.h> macro"; do
+      AS_CASE($gl_working,
+        *assert.h*, CFLAGS="$gl_save_CFLAGS -DINCLUDE_ASSERT_H")
+
+      AC_COMPILE_IFELSE(
+       AC_LANG_PROGRAM(
+          #if defined __clang__ && __STDC_VERSION__ < 202311
+             #pragma clang diagnostic error "-Wc2x-extensions"
+             #pragma clang diagnostic error "-Wc++1z-extensions"
+            #endif
+            #ifdef INCLUDE_ASSERT_H
+             #include <assert.h>
+            #endif
+            static_assert (2 + 2 == 4, "arithmetic does not work");
+            static_assert (2 + 2 == 4);
+          ,
+          
+            static_assert (sizeof (char) == 1, "sizeof does not work");
+            static_assert (sizeof (char) == 1);
+          ),
+       gl_cv_static_assert=$gl_working,
+       gl_cv_static_assert=no)
+      CFLAGS=$gl_save_CFLAGS
+      test "$gl_cv_static_assert" != no && break
+     done)
+
+  GL_GENERATE_ASSERT_H=false
+  AS_CASE($gl_cv_static_assert,
+    yes*keyword*,
+      AC_DEFINE(HAVE_C_STATIC_ASSERT, 1,
+         Define to 1 if the static_assert keyword works.),
+    no,
+      GL_GENERATE_ASSERT_H=true
+       gl_NEXT_HEADERS(assert.h))
+
+  dnl The "zz" puts this toward config.h's end, to avoid potential
+  dnl collisions with other definitions.  #undef assert so that
+  dnl programs are not tempted to use it without specifically
+  dnl including assert.h.  Break the #undef apart with a comment
+  dnl so that 'configure' does not comment it out.
+  AH_VERBATIM(zzstatic_assert,
+#if (!defined HAVE_C_STATIC_ASSERT && !defined assert \
+     && (!defined __cplusplus \
+         || (__cpp_static_assert < 201411 \
+             && __GNUG__ < 6 && __clang_major__ < 6)))
+ #include <assert.h>
+ #undef/**/assert
+ /* Solaris 11.4 <assert.h> defines static_assert as a macro with 2 arguments.
+    We need it also to be invocable with a single argument.  */
+ #if defined __sun && (__STDC_VERSION__ - 0 >= 201112L) && !defined __cplusplus
+  #undef/**/static_assert
+  #define static_assert _Static_assert
+ #endif
+#endif)
+)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/errno_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/errno_h.m4 Changed

@@ -1,9 +1,11 @@
-# errno_h.m4 serial 12
-dnl Copyright (C) 2004, 2006, 2008-2018 Free Software Foundation, Inc.
+# errno_h.m4 serial 14
+dnl Copyright (C) 2004, 2006, 2008-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
+AC_PREREQ(2.61)
+
 AC_DEFUN_ONCE(gl_HEADER_ERRNO_H,
 
   AC_REQUIRE(AC_PROG_CC)
@@ -66,13 +68,11 @@
       gl_cv_header_errno_h_complete=yes)
   )
   if test $gl_cv_header_errno_h_complete = yes; then
-    ERRNO_H=''
+    GL_GENERATE_ERRNO_H=false
   else
     gl_NEXT_HEADERS(errno.h)
-    ERRNO_H='errno.h'
+    GL_GENERATE_ERRNO_H=true
   fi
-  AC_SUBST(ERRNO_H)
-  AM_CONDITIONAL(GL_GENERATE_ERRNO_H, test -n "$ERRNO_H")
   gl_REPLACE_ERRNO_VALUE(EMULTIHOP)
   gl_REPLACE_ERRNO_VALUE(ENOLINK)
   gl_REPLACE_ERRNO_VALUE(EOVERFLOW)
@@ -86,7 +86,7 @@
 # Set the variables EOVERFLOW_HIDDEN and EOVERFLOW_VALUE.
 AC_DEFUN(gl_REPLACE_ERRNO_VALUE,
 
-  if test -n "$ERRNO_H"; then
+  if $GL_GENERATE_ERRNO_H; then
     AC_CACHE_CHECK(for $1 value, gl_cv_header_errno_h_$1, 
       AC_EGREP_CPP(yes,
 #include <errno.h>
@@ -129,9 +129,3 @@
     AC_SUBST($1_VALUE)
   fi
 )
-
-dnl Autoconf >= 2.61 has AC_COMPUTE_INT built-in.
-dnl Remove this when we can assume autoconf >= 2.61.
-m4_ifdef(AC_COMPUTE_INT, , 
-  AC_DEFUN(AC_COMPUTE_INT, _AC_COMPUTE_INT($2,$1,$3,$4))
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/exponentd.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/exponentd.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/exponentf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/exponentf.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/exponentl.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/exponentl.m4 Changed

@@ -1,5 +1,5 @@
-# exponentl.m4 serial 4
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# exponentl.m4 serial 5
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -22,14 +22,14 @@
         memory_long_double;
 static unsigned int ored_wordsNWORDS;
 static unsigned int anded_wordsNWORDS;
-static void add_to_ored_words (long double x)
+static void add_to_ored_words (long double *x)
 {
   memory_long_double m;
   size_t i;
   /* Clear it first, in case
      sizeof (long double) < sizeof (memory_long_double).  */
   memset (&m, 0, sizeof (memory_long_double));
-  m.value = x;
+  m.value = *x;
   for (i = 0; i < NWORDS; i++)
     {
       ored_wordsi |= m.wordi;
@@ -38,17 +38,15 @@
 }
 int main ()
 {
+  static long double samples5 = { 0.25L, 0.5L, 1.0L, 2.0L, 4.0L };
   size_t j;
   FILE *fp = fopen ("conftest.out", "w");
   if (fp == NULL)
     return 1;
   for (j = 0; j < NWORDS; j++)
     anded_wordsj = ~ (unsigned int) 0;
-  add_to_ored_words (0.25L);
-  add_to_ored_words (0.5L);
-  add_to_ored_words (1.0L);
-  add_to_ored_words (2.0L);
-  add_to_ored_words (4.0L);
+  for (j = 0; j < 5; j++)
+    add_to_ored_words (&samplesj);
   /* Remove bits that are common (e.g. if representation of the first mantissa
      bit is explicit).  */
   for (j = 0; j < NWORDS; j++)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/extensions.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/extensions.m4 Changed

@@ -1,14 +1,19 @@
-# serial 18  -*- Autoconf -*-
+# serial 23  -*- Autoconf -*-
 # Enable extensions on systems that normally disable them.
 
-# Copyright (C) 2003, 2006-2018 Free Software Foundation, Inc.
+# Copyright (C) 2003, 2006-2023 Free Software Foundation, Inc.
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
 # with or without modifications, as long as this notice is preserved.
 
+dnl Define to empty for the benefit of Autoconf 2.69 and earlier, so that
+dnl AC_USE_SYSTEM_EXTENSIONS (below) can be used unchanged from Autoconf 2.70+.
+m4_ifndef(AC_CHECK_INCLUDES_DEFAULT,
+  AC_DEFUN(AC_CHECK_INCLUDES_DEFAULT, ))
+
 # This definition of AC_USE_SYSTEM_EXTENSIONS is stolen from git
 # Autoconf.  Perhaps we can remove this once we can assume Autoconf
-# 2.70 or later everywhere, but since Autoconf mutates rapidly
+# is recent-enough everywhere, but since Autoconf mutates rapidly
 # enough in this area it's likely we'll need to redefine
 # AC_USE_SYSTEM_EXTENSIONS for quite some time.
 
@@ -26,36 +31,27 @@
 #      its dependencies. This will ensure that the gl_USE_SYSTEM_EXTENSIONS
 #      invocation occurs in gl_EARLY, not in gl_INIT.
 
+m4_version_prereq(2.72, , 
+
 # AC_USE_SYSTEM_EXTENSIONS
 # ------------------------
 # Enable extensions on systems that normally disable them,
 # typically due to standards-conformance issues.
-#
-# Remember that #undef in AH_VERBATIM gets replaced with #define by
-# AC_DEFINE.  The goal here is to define all known feature-enabling
-# macros, then, if reports of conflicts are made, disable macros that
-# cause problems on some platforms (such as __EXTENSIONS__).
+# We unconditionally define as many of the known feature-enabling
+# as possible, reserving conditional behavior for macros that are
+# known to cause problems on some platforms (such as __EXTENSIONS__).
 AC_DEFUN_ONCE(AC_USE_SYSTEM_EXTENSIONS,
-AC_BEFORE($0, AC_COMPILE_IFELSE)dnl
+AC_BEFORE($0, AC_PREPROC_IFELSE)dnl
+AC_BEFORE($0, AC_COMPILE_IFELSE)dnl
+AC_BEFORE($0, AC_LINK_IFELSE)dnl
 AC_BEFORE($0, AC_RUN_IFELSE)dnl
-
-  AC_CHECK_HEADER(minix/config.h, MINIX=yes, MINIX=)
-  if test "$MINIX" = yes; then
-    AC_DEFINE(_POSIX_SOURCE, 1,
-      Define to 1 if you need to in order for 'stat' and other
-       things to work.)
-    AC_DEFINE(_POSIX_1_SOURCE, 2,
-      Define to 2 if the system does not provide POSIX.1 features
-       except with this defined.)
-    AC_DEFINE(_MINIX, 1,
-      Define to 1 if on MINIX.)
-    AC_DEFINE(_NETBSD_SOURCE, 1,
-      Define to 1 to make NetBSD features available.  MINIX 3 needs this.)
-  fi
-
+AC_BEFORE($0, AC_CHECK_INCLUDES_DEFAULT)dnl
+dnl #undef in AH_VERBATIM gets replaced with #define by AC_DEFINE.
 dnl Use a different key than __EXTENSIONS__, as that name broke existing
 dnl configure.ac when using autoheader 2.62.
-  AH_VERBATIM(USE_SYSTEM_EXTENSIONS,
+dnl The macros below are in alphabetical order ignoring leading _ or __
+dnl prefixes.
+AH_VERBATIM(USE_SYSTEM_EXTENSIONS,
 /* Enable extensions on AIX 3, Interix.  */
 #ifndef _ALL_SOURCE
 # undef _ALL_SOURCE
@@ -64,19 +60,44 @@
 #ifndef _DARWIN_C_SOURCE
 # undef _DARWIN_C_SOURCE
 #endif
+/* Enable general extensions on Solaris.  */
+#ifndef __EXTENSIONS__
+# undef __EXTENSIONS__
+#endif
 /* Enable GNU extensions on systems that have them.  */
 #ifndef _GNU_SOURCE
 # undef _GNU_SOURCE
 #endif
-/* Enable NetBSD extensions on NetBSD.  */
+/* Enable X/Open compliant socket functions that do not require linking
+   with -lxnet on HP-UX 11.11.  */
+#ifndef _HPUX_ALT_XOPEN_SOCKET_API
+# undef _HPUX_ALT_XOPEN_SOCKET_API
+#endif
+/* Identify the host operating system as Minix.
+   This macro does not affect the system headers' behavior.
+   A future release of Autoconf may stop defining this macro.  */
+#ifndef _MINIX
+# undef _MINIX
+#endif
+/* Enable general extensions on NetBSD.
+   Enable NetBSD compatibility extensions on Minix.  */
 #ifndef _NETBSD_SOURCE
 # undef _NETBSD_SOURCE
 #endif
-/* Enable OpenBSD extensions on NetBSD.  */
+/* Enable OpenBSD compatibility extensions on NetBSD.
+   Oddly enough, this does nothing on OpenBSD.  */
 #ifndef _OPENBSD_SOURCE
 # undef _OPENBSD_SOURCE
 #endif
-/* Enable threading extensions on Solaris.  */
+/* Define to 1 if needed for POSIX-compatible behavior.  */
+#ifndef _POSIX_SOURCE
+# undef _POSIX_SOURCE
+#endif
+/* Define to 2 if needed for POSIX-compatible behavior.  */
+#ifndef _POSIX_1_SOURCE
+# undef _POSIX_1_SOURCE
+#endif
+/* Enable POSIX-compatible threading on Solaris.  */
 #ifndef _POSIX_PTHREAD_SEMANTICS
 # undef _POSIX_PTHREAD_SEMANTICS
 #endif
@@ -92,11 +113,15 @@
 #ifndef __STDC_WANT_IEC_60559_DFP_EXT__
 # undef __STDC_WANT_IEC_60559_DFP_EXT__
 #endif
+/* Enable extensions specified by C23 Annex F.  */
+#ifndef __STDC_WANT_IEC_60559_EXT__
+# undef __STDC_WANT_IEC_60559_EXT__
+#endif
 /* Enable extensions specified by ISO/IEC TS 18661-4:2015.  */
 #ifndef __STDC_WANT_IEC_60559_FUNCS_EXT__
 # undef __STDC_WANT_IEC_60559_FUNCS_EXT__
 #endif
-/* Enable extensions specified by ISO/IEC TS 18661-3:2015.  */
+/* Enable extensions specified by C23 Annex H and ISO/IEC TS 18661-3:2015.  */
 #ifndef __STDC_WANT_IEC_60559_TYPES_EXT__
 # undef __STDC_WANT_IEC_60559_TYPES_EXT__
 #endif
@@ -112,22 +137,19 @@
 #ifndef _TANDEM_SOURCE
 # undef _TANDEM_SOURCE
 #endif
-/* Enable X/Open extensions if necessary.  HP-UX 11.11 defines
-   mbstate_t only if _XOPEN_SOURCE is defined to 500, regardless of
-   whether compiling with -Ae or -D_HPUX_SOURCE=1.  */
+/* Enable X/Open extensions.  Define to 500 only if necessary
+   to make mbstate_t available.  */
 #ifndef _XOPEN_SOURCE
 # undef _XOPEN_SOURCE
 #endif
-/* Enable X/Open compliant socket functions that do not require linking
-   with -lxnet on HP-UX 11.11.  */
-#ifndef _HPUX_ALT_XOPEN_SOCKET_API
-# undef _HPUX_ALT_XOPEN_SOCKET_API
-#endif
-/* Enable general extensions on Solaris.  */
-#ifndef __EXTENSIONS__
-# undef __EXTENSIONS__
-#endif
-)
+)dnl
+
+  AC_REQUIRE(AC_CHECK_INCLUDES_DEFAULT)dnl
+  _AC_CHECK_HEADER_ONCE(wchar.h)
+  _AC_CHECK_HEADER_ONCE(minix/config.h)
+
+dnl Defining __EXTENSIONS__ may break the system headers on some systems.
+dnl (FIXME: Which ones?)
   AC_CACHE_CHECK(whether it is safe to define __EXTENSIONS__,
     ac_cv_safe_to_define___extensions__,
     AC_COMPILE_IFELSE(
@@ -136,40 +158,57 @@
           AC_INCLUDES_DEFAULT),
        ac_cv_safe_to_define___extensions__=yes,
        ac_cv_safe_to_define___extensions__=no))
-  test $ac_cv_safe_to_define___extensions__ = yes &&
-    AC_DEFINE(__EXTENSIONS__)
+
+dnl HP-UX 11.11 defines mbstate_t only if _XOPEN_SOURCE is defined to
+dnl 500, regardless of whether compiling with -Ae or -D_HPUX_SOURCE=1.
+dnl But defining _XOPEN_SOURCE may turn *off* extensions on platforms
+dnl not covered by turn-on-extensions macros (notably Dragonfly, Free,
+dnl and OpenBSD, which don't have any equivalent of _NETBSD_SOURCE) so
+dnl it should only be defined when necessary.
+  AC_CACHE_CHECK(whether _XOPEN_SOURCE should be defined,
+    ac_cv_should_define__xopen_source,
+    ac_cv_should_define__xopen_source=no
+    AS_IF(test $ac_cv_header_wchar_h = yes,
+      AC_COMPILE_IFELSE(
+        AC_LANG_PROGRAM(
+          #include <wchar.h>
+          mbstate_t x;),
+        ,
+        AC_COMPILE_IFELSE(
+          AC_LANG_PROGRAM(
+            #define _XOPEN_SOURCE 500
+            #include <wchar.h>
+            mbstate_t x;),
+          ac_cv_should_define__xopen_source=yes))))
+
   AC_DEFINE(_ALL_SOURCE)
   AC_DEFINE(_DARWIN_C_SOURCE)
   AC_DEFINE(_GNU_SOURCE)
+  AC_DEFINE(_HPUX_ALT_XOPEN_SOCKET_API)
   AC_DEFINE(_NETBSD_SOURCE)
   AC_DEFINE(_OPENBSD_SOURCE)
   AC_DEFINE(_POSIX_PTHREAD_SEMANTICS)
   AC_DEFINE(__STDC_WANT_IEC_60559_ATTRIBS_EXT__)
   AC_DEFINE(__STDC_WANT_IEC_60559_BFP_EXT__)
   AC_DEFINE(__STDC_WANT_IEC_60559_DFP_EXT__)
+  AC_DEFINE(__STDC_WANT_IEC_60559_EXT__)
   AC_DEFINE(__STDC_WANT_IEC_60559_FUNCS_EXT__)
   AC_DEFINE(__STDC_WANT_IEC_60559_TYPES_EXT__)
   AC_DEFINE(__STDC_WANT_LIB_EXT2__)
   AC_DEFINE(__STDC_WANT_MATH_SPEC_FUNCS__)
   AC_DEFINE(_TANDEM_SOURCE)
-  AC_CACHE_CHECK(whether _XOPEN_SOURCE should be defined,
-    ac_cv_should_define__xopen_source,
-    ac_cv_should_define__xopen_source=no
-     AC_COMPILE_IFELSE(
-       AC_LANG_PROGRAM(
-          #include <wchar.h>
-          mbstate_t x;),
-       ,
-       AC_COMPILE_IFELSE(
-          AC_LANG_PROGRAM(
-             #define _XOPEN_SOURCE 500
-             #include <wchar.h>
-             mbstate_t x;),
-          ac_cv_should_define__xopen_source=yes)))
-  test $ac_cv_should_define__xopen_source = yes &&
-    AC_DEFINE(_XOPEN_SOURCE, 500)
-  AC_DEFINE(_HPUX_ALT_XOPEN_SOCKET_API)
+  AS_IF(test $ac_cv_header_minix_config_h = yes,
+    MINIX=yes
+    AC_DEFINE(_MINIX)
+    AC_DEFINE(_POSIX_SOURCE)
+    AC_DEFINE(_POSIX_1_SOURCE, 2),
+    MINIX=)
+  AS_IF(test $ac_cv_safe_to_define___extensions__ = yes,
+    AC_DEFINE(__EXTENSIONS__))
+  AS_IF(test $ac_cv_should_define__xopen_source = yes,
+    AC_DEFINE(_XOPEN_SOURCE, 500))
 )# AC_USE_SYSTEM_EXTENSIONS
+)
 
 # gl_USE_SYSTEM_EXTENSIONS
 # ------------------------
@@ -177,13 +216,17 @@
 # typically due to standards-conformance issues.
 AC_DEFUN_ONCE(gl_USE_SYSTEM_EXTENSIONS,
 
-  dnl Require this macro before AC_USE_SYSTEM_EXTENSIONS.
-  dnl gnulib does not need it. But if it gets required by third-party macros
-  dnl after AC_USE_SYSTEM_EXTENSIONS is required, autoconf 2.62..2.63 emit a
-  dnl warning: "AC_COMPILE_IFELSE was called before AC_USE_SYSTEM_EXTENSIONS".
-  dnl Note: We can do this only for one of the macros AC_AIX, AC_GNU_SOURCE,
-  dnl AC_MINIX. If people still use AC_AIX or AC_MINIX, they are out of luck.
-  AC_REQUIRE(AC_GNU_SOURCE)
-
   AC_REQUIRE(AC_USE_SYSTEM_EXTENSIONS)
+
+  dnl On OpenBSD 6.8 with GCC, the include files contain a couple of
+  dnl definitions that are only activated with an explicit -D_ISOC11_SOURCE.
+  dnl That's because this version of GCC (4.2.1) supports the option
+  dnl '-std=gnu99' but not the option '-std=gnu11'.
+  AC_REQUIRE(AC_CANONICAL_HOST)
+  case "$host_os" in
+    openbsd*)
+      AC_DEFINE(_ISOC11_SOURCE, 1,
+        Define to enable the declarations of ISO C 11 types and functions.)
+      ;;
+  esac
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/extern-inline.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/extern-inline.m4 Changed

@@ -1,13 +1,28 @@
 dnl 'extern inline' a la ISO C99.
 
-dnl Copyright 2012-2018 Free Software Foundation, Inc.
+dnl Copyright 2012-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 AC_DEFUN(gl_EXTERN_INLINE,
 
-  AH_VERBATIM(extern_inline,
+  AC_CACHE_CHECK(whether ctype.h defines __header_inline,
+    gl_cv_have___header_inline,
+    AC_PREPROC_IFELSE(
+       AC_LANG_SOURCE(#include <ctype.h>
+                         #ifndef __header_inline
+                          #error "<ctype.h> does not define __header_inline"
+                         #endif
+                        ),
+       gl_cv_have___header_inline=yes,
+       gl_cv_have___header_inline=no))
+  if test "$gl_cv_have___header_inline" = yes; then
+    AC_DEFINE(HAVE___HEADER_INLINE, 1,
+      Define to 1 if ctype.h defines __header_inline.)
+  fi
+
+  AH_VERBATIM(HAVE___HEADER_INLINE_1,
 /* Please see the Gnulib manual for how to use these macros.
 
    Suppress extern inline with HP-UX cc, as it appears to be broken; see
@@ -17,7 +32,8 @@
    mishandles inline functions that call each other.  E.g., for 'inline void f
    (void) { } inline void g (void) { f (); }', c99 incorrectly complains
    'reference to static identifier "f" in extern inline function'.
-   This bug was observed with Sun C 5.12 SunOS_i386 2011/11/16.
+   This bug was observed with Oracle Developer Studio 12.6
+   (Sun C 5.15 SunOS_sparc 2017/05/30).
 
    Suppress extern inline (with or without __attribute__ ((__gnu_inline__)))
    on configurations that mistakenly use 'static inline' to implement
@@ -32,7 +48,7 @@
      https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html
 
      DragonFly; see
-     http://muscles.dragonflybsd.org/bulk/bleeding-edge-potential/latest-per-pkg/ah-tty-0.3.12.log
+     http://muscles.dragonflybsd.org/bulk/clang-master-potential/20141111_102002/logs/ah-tty-0.3.12.log
 
      FreeBSD; see:
      https://lists.gnu.org/r/bug-gnulib/2014-07/msg00104.html
@@ -53,7 +69,7 @@
  */
 #if (((defined __APPLE__ && defined __MACH__) \
       || defined __DragonFly__ || defined __FreeBSD__) \
-     && (defined __header_inline \
+     && (defined HAVE___HEADER_INLINE \
          ? (defined __cplusplus && defined __GNUC_STDC_INLINE__ \
             && ! defined __clang__) \
          : ((! defined _DONT_USE_CTYPE_INLINE_ \
@@ -83,8 +99,8 @@
 # define _GL_EXTERN_INLINE extern
 # define _GL_EXTERN_INLINE_IN_USE
 #else
-# define _GL_INLINE static _GL_UNUSED
-# define _GL_EXTERN_INLINE static _GL_UNUSED
+# define _GL_INLINE _GL_UNUSED static
+# define _GL_EXTERN_INLINE _GL_UNUSED static
 #endif
 
 /* In GCC 4.6 (inclusive) to 5.1 (exclusive),

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/float_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/float_h.m4 Changed

@@ -1,5 +1,5 @@
-# float_h.m4 serial 12
-dnl Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+# float_h.m4 serial 13
+dnl Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -8,18 +8,18 @@
 
   AC_REQUIRE(AC_PROG_CC)
   AC_REQUIRE(AC_CANONICAL_HOST)
-  FLOAT_H=
+  GL_GENERATE_FLOAT_H=false
   REPLACE_FLOAT_LDBL=0
   case "$host_os" in
     aix* | beos* | openbsd* | mirbsd* | irix*)
-      FLOAT_H=float.h
+      GL_GENERATE_FLOAT_H=true
       ;;
     freebsd* | dragonfly*)
       case "$host_cpu" in
 changequote(,)dnl
         i3456786 )
 changequote(,)dnl
-          FLOAT_H=float.h
+          GL_GENERATE_FLOAT_H=true
           ;;
         x86_64 )
           # On x86_64 systems, the C compiler may still be generating
@@ -33,21 +33,21 @@
                  #endif
                ),
             ,
-            FLOAT_H=float.h)
+            GL_GENERATE_FLOAT_H=true)
           ;;
       esac
       ;;
     linux*)
       case "$host_cpu" in
         powerpc*)
-          FLOAT_H=float.h
+          GL_GENERATE_FLOAT_H=true
           ;;
       esac
       ;;
   esac
   case "$host_os" in
     aix* | freebsd* | dragonfly* | linux*)
-      if test -n "$FLOAT_H"; then
+      if $GL_GENERATE_FLOAT_H; then
         REPLACE_FLOAT_LDBL=1
       fi
       ;;
@@ -95,14 +95,12 @@
       REPLACE_ITOLD=1
       dnl We add the workaround to <float.h> but also to <math.h>,
       dnl to increase the chances that the fix function gets pulled in.
-      FLOAT_H=float.h
+      GL_GENERATE_FLOAT_H=true
       ;;
   esac
 
-  if test -n "$FLOAT_H"; then
+  if $GL_GENERATE_FLOAT_H; then
     gl_NEXT_HEADERS(float.h)
   fi
-  AC_SUBST(FLOAT_H)
-  AM_CONDITIONAL(GL_GENERATE_FLOAT_H, test -n "$FLOAT_H")
   AC_SUBST(REPLACE_ITOLD)
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/fpieee.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/fpieee.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/fprintf-posix.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/fprintf-posix.m4 Changed

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/free.m4 Added

@@ -0,0 +1,52 @@
+# free.m4 serial 6
+# Copyright (C) 2003-2005, 2009-2023 Free Software Foundation, Inc.
+# This file is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# Written by Paul Eggert and Bruno Haible.
+
+AC_DEFUN(gl_FUNC_FREE,
+
+  AC_REQUIRE(gl_STDLIB_H_DEFAULTS)
+
+  dnl In the next release of POSIX, free must preserve errno.
+  dnl https://www.austingroupbugs.net/view.php?id=385
+  dnl https://sourceware.org/bugzilla/show_bug.cgi?id=17924
+  dnl So far, we know of three platforms that do this:
+  dnl * glibc >= 2.33, thanks to the fix for this bug:
+  dnl   <https://sourceware.org/bugzilla/show_bug.cgi?id=17924>
+  dnl * OpenBSD >= 4.5, thanks to this commit:
+  dnl   <https://cvsweb.openbsd.org/cgi-bin/cvsweb/src/lib/libc/stdlib/malloc.c.diff?r1=1.100&r2=1.101&f=h>
+  dnl * Solaris, because its malloc() implementation is based on brk(),
+  dnl   not mmap(); hence its free() implementation makes no system calls.
+  dnl For other platforms, you can only be sure if they state it in their
+  dnl documentation, or by code inspection of the free() implementation in libc.
+  AC_CACHE_CHECK(whether free is known to preserve errno,
+    gl_cv_func_free_preserves_errno,
+    AC_COMPILE_IFELSE(
+       AC_LANG_PROGRAM(
+          #include <stdlib.h>
+          ,
+          #if 2 < __GLIBC__ + (33 <= __GLIBC_MINOR__)
+            #elif defined __OpenBSD__
+            #elif defined __sun
+            #else
+              #error "'free' is not known to preserve errno"
+            #endif
+          ),
+       gl_cv_func_free_preserves_errno=yes,
+       gl_cv_func_free_preserves_errno=no)
+    )
+
+  case $gl_cv_func_free_preserves_errno in
+   *yes)
+    AC_DEFINE(HAVE_FREE_POSIX, 1,
+      Define if the 'free' function is guaranteed to preserve errno.)
+    ;;
+   *) REPLACE_FREE=1 ;;
+  esac
+)
+
+# Prerequisites of lib/free.c.
+AC_DEFUN(gl_PREREQ_FREE, :)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/frexp.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/frexp.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/frexpl.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/frexpl.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/fseterr.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/fseterr.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/gnulib-cache.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/gnulib-cache.m4 Changed

@@ -1,8 +1,8 @@
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2023 Free Software Foundation, Inc.
 #
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This file is distributed in the hope that it will be useful,
@@ -35,14 +35,16 @@
 #  --tests-base=tests \
 #  --aux-dir=build-aux \
 #  --makefile-name=gnulib.mk \
+#  --automake-subdir \
 #  --no-conditional-dependencies \
 #  --no-libtool \
 #  --macro-prefix=gl \
 #  fprintf-posix \
 #  git-version-gen \
 #  havelib \
-#  non-recursive-gnulib-prefix-hack \
 #  snprintf \
+#  stdbool-c99 \
+#  stdint \
 #  vsnprintf \
 #  wcwidth
 
@@ -52,8 +54,9 @@
   fprintf-posix
   git-version-gen
   havelib
-  non-recursive-gnulib-prefix-hack
   snprintf
+  stdbool-c99
+  stdint
   vsnprintf
   wcwidth
 )
@@ -65,6 +68,7 @@
 gl_TESTS_BASE(tests)
 gl_LIB(libgnu)
 gl_MAKEFILE_NAME(gnulib.mk)
+gl_AUTOMAKE_SUBDIR
 gl_MACRO_PREFIX(gl)
 gl_PO_DOMAIN()
 gl_WITNESS_C_MACRO()

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/gnulib-common.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/gnulib-common.m4 Changed

@@ -1,25 +1,59 @@
-# gnulib-common.m4 serial 39
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# gnulib-common.m4 serial 80
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
+AC_PREREQ(2.62)
+
 # gl_COMMON
 # is expanded unconditionally through gnulib-tool magic.
 AC_DEFUN(gl_COMMON, 
   dnl Use AC_REQUIRE here, so that the code is expanded once only.
   AC_REQUIRE(gl_00GNULIB)
   AC_REQUIRE(gl_COMMON_BODY)
+  AC_REQUIRE(gl_ZZGNULIB)
 )
 AC_DEFUN(gl_COMMON_BODY, 
+  AH_VERBATIM(_GL_GNUC_PREREQ,
+/* True if the compiler says it groks GNU C version MAJOR.MINOR.  */
+#if defined __GNUC__ && defined __GNUC_MINOR__
+# define _GL_GNUC_PREREQ(major, minor) \
+    ((major) < __GNUC__ + ((minor) <= __GNUC_MINOR__))
+#else
+# define _GL_GNUC_PREREQ(major, minor) 0
+#endif
+)
   AH_VERBATIM(_Noreturn,
 /* The _Noreturn keyword of C11.  */
-#if ! (defined _Noreturn \
-       || (defined __STDC_VERSION__ && 201112 <= __STDC_VERSION__))
-# if (3 <= __GNUC__ || (__GNUC__ == 2 && 8 <= __GNUC_MINOR__) \
-      || 0x5110 <= __SUNPRO_C)
+#ifndef _Noreturn
+# if (defined __cplusplus \
+      && ((201103 <= __cplusplus && !(__GNUC__ == 4 && __GNUC_MINOR__ == 7)) \
+          || (defined _MSC_VER && 1900 <= _MSC_VER)) \
+      && 0)
+    /* noreturn is not practically usable, because with it the syntax
+         extern _Noreturn void func (...);
+       would not be valid; such a declaration would only be valid with 'extern'
+       and '_Noreturn' swapped, or without the 'extern' keyword.  However, some
+       AIX system header files and several gnulib header files use precisely
+       this syntax with 'extern'.  */
+#  define _Noreturn noreturn
+# elif (defined __clang__ && __clang_major__ < 16 \
+        && defined _GL_WORK_AROUND_LLVM_BUG_59792)
+   /* Compile with -D_GL_WORK_AROUND_LLVM_BUG_59792 to work around
+      that rare LLVM bug, though you may get many false-alarm warnings.  */
+#  define _Noreturn
+# elif ((!defined __cplusplus || defined __clang__) \
+        && (201112 <= (defined __STDC_VERSION__ ? __STDC_VERSION__ : 0) \
+            || (!defined __STRICT_ANSI__ \
+                && (_GL_GNUC_PREREQ (4, 7) \
+                    || (defined __apple_build_version__ \
+                        ? 6000000 <= __apple_build_version__ \
+                        : 3 < __clang_major__ + (5 <= __clang_minor__))))))
+   /* _Noreturn works as-is.  */
+# elif _GL_GNUC_PREREQ (2, 8) || defined __clang__ || 0x5110 <= __SUNPRO_C
 #  define _Noreturn __attribute__ ((__noreturn__))
-# elif defined _MSC_VER && 1200 <= _MSC_VER
+# elif 1200 <= (defined _MSC_VER ? _MSC_VER : 0)
 #  define _Noreturn __declspec (noreturn)
 # else
 #  define _Noreturn
@@ -36,50 +70,534 @@
 #if defined __APPLE__ && defined __MACH__ && __APPLE_CC__ >= 5465 && !defined __cplusplus && __STDC_VERSION__ >= 199901L && !defined __GNUC_STDC_INLINE__
 # define __GNUC_STDC_INLINE__ 1
 #endif)
-  AH_VERBATIM(unused_parameter,
-/* Define as a marker that can be attached to declarations that might not
-    be used.  This helps to reduce warnings, such as from
-    GCC -Wunused-parameter.  */
-#if __GNUC__ >= 3 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
-# define _GL_UNUSED __attribute__ ((__unused__))
-#else
-# define _GL_UNUSED
-#endif
-/* The name _UNUSED_PARAMETER_ is an earlier spelling, although the name
-   is a misnomer outside of parameter lists.  */
-#define _UNUSED_PARAMETER_ _GL_UNUSED
-
-/* gcc supports the "unused" attribute on possibly unused labels, and
-   g++ has since version 4.5.  Note to support C++ as well as C,
-   _GL_UNUSED_LABEL should be used with a trailing ;  */
-#if !defined __cplusplus || __GNUC__ > 4 \
-    || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)
-# define _GL_UNUSED_LABEL _GL_UNUSED
+  AH_VERBATIM(attribute,
+/* Attributes.  */
+#if (defined __has_attribute \
+     && (!defined __clang_minor__ \
+         || (defined __apple_build_version__ \
+             ? 6000000 <= __apple_build_version__ \
+             : 5 <= __clang_major__)))
+# define _GL_HAS_ATTRIBUTE(attr) __has_attribute (__##attr##__)
 #else
-# define _GL_UNUSED_LABEL
+# define _GL_HAS_ATTRIBUTE(attr) _GL_ATTR_##attr
+# define _GL_ATTR_alloc_size _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_always_inline _GL_GNUC_PREREQ (3, 2)
+# define _GL_ATTR_artificial _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_cold _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_const _GL_GNUC_PREREQ (2, 95)
+# define _GL_ATTR_deprecated _GL_GNUC_PREREQ (3, 1)
+# define _GL_ATTR_diagnose_if 0
+# define _GL_ATTR_error _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_externally_visible _GL_GNUC_PREREQ (4, 1)
+# define _GL_ATTR_fallthrough _GL_GNUC_PREREQ (7, 0)
+# define _GL_ATTR_format _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_leaf _GL_GNUC_PREREQ (4, 6)
+# define _GL_ATTR_malloc _GL_GNUC_PREREQ (3, 0)
+# ifdef _ICC
+#  define _GL_ATTR_may_alias 0
+# else
+#  define _GL_ATTR_may_alias _GL_GNUC_PREREQ (3, 3)
+# endif
+# define _GL_ATTR_noinline _GL_GNUC_PREREQ (3, 1)
+# define _GL_ATTR_nonnull _GL_GNUC_PREREQ (3, 3)
+# define _GL_ATTR_nonstring _GL_GNUC_PREREQ (8, 0)
+# define _GL_ATTR_nothrow _GL_GNUC_PREREQ (3, 3)
+# define _GL_ATTR_packed _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_pure _GL_GNUC_PREREQ (2, 96)
+# define _GL_ATTR_returns_nonnull _GL_GNUC_PREREQ (4, 9)
+# define _GL_ATTR_sentinel _GL_GNUC_PREREQ (4, 0)
+# define _GL_ATTR_unused _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_warn_unused_result _GL_GNUC_PREREQ (3, 4)
 #endif
 
-/* The __pure__ attribute was added in gcc 2.96.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-# define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
-#else
-# define _GL_ATTRIBUTE_PURE /* empty */
+/* Disable GCC -Wpedantic if using __has_c_attribute and this is not C23+.  */
+#if (defined __has_c_attribute && _GL_GNUC_PREREQ (4, 6) \
+     && (defined __STDC_VERSION__ ? __STDC_VERSION__ : 0) <= 201710)
+# pragma GCC diagnostic ignored "-Wpedantic"
 #endif
 
-/* The __const__ attribute was added in gcc 2.95.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
-# define _GL_ATTRIBUTE_CONST __attribute__ ((__const__))
-#else
-# define _GL_ATTRIBUTE_CONST /* empty */
+dnl There is no _GL_ATTRIBUTE_ALIGNED; use stdalign's alignas instead.
+
+/* _GL_ATTRIBUTE_ALLOC_SIZE ((N)) declares that the Nth argument of the function
+   is the size of the returned memory block.
+   _GL_ATTRIBUTE_ALLOC_SIZE ((M, N)) declares that the Mth argument multiplied
+   by the Nth argument of the function is the size of the returned memory block.
+ */
+/* Applies to: function, pointer to function, function types.  */
+#ifndef _GL_ATTRIBUTE_ALLOC_SIZE
+# if _GL_HAS_ATTRIBUTE (alloc_size)
+#  define _GL_ATTRIBUTE_ALLOC_SIZE(args) __attribute__ ((__alloc_size__ args))
+# else
+#  define _GL_ATTRIBUTE_ALLOC_SIZE(args)
+# endif
 #endif
 
-/* The __malloc__ attribute was added in gcc 3.  */
-#if 3 <= __GNUC__
-# define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
-#else
-# define _GL_ATTRIBUTE_MALLOC /* empty */
+/* _GL_ATTRIBUTE_ALWAYS_INLINE tells that the compiler should always inline the
+   function and report an error if it cannot do so.  */
+/* Applies to: function.  */
+#ifndef _GL_ATTRIBUTE_ALWAYS_INLINE
+# if _GL_HAS_ATTRIBUTE (always_inline)
+#  define _GL_ATTRIBUTE_ALWAYS_INLINE __attribute__ ((__always_inline__))
+# else
+#  define _GL_ATTRIBUTE_ALWAYS_INLINE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_ARTIFICIAL declares that the function is not important to show
+    in stack traces when debugging.  The compiler should omit the function from
+    stack traces.  */
+/* Applies to: function.  */
+#ifndef _GL_ATTRIBUTE_ARTIFICIAL
+# if _GL_HAS_ATTRIBUTE (artificial)
+#  define _GL_ATTRIBUTE_ARTIFICIAL __attribute__ ((__artificial__))
+# else
+#  define _GL_ATTRIBUTE_ARTIFICIAL
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_COLD declares that the function is rarely executed.  */
+/* Applies to: functions.  */
+/* Avoid __attribute__ ((cold)) on MinGW; see thread starting at
+   <https://lists.gnu.org/r/emacs-devel/2019-04/msg01152.html>.
+   Also, Oracle Studio 12.6 requires 'cold' not '__cold__'.  */
+#ifndef _GL_ATTRIBUTE_COLD
+# if _GL_HAS_ATTRIBUTE (cold) && !defined __MINGW32__
+#  ifndef __SUNPRO_C
+#   define _GL_ATTRIBUTE_COLD __attribute__ ((__cold__))
+#  else
+#   define _GL_ATTRIBUTE_COLD __attribute__ ((cold))
+#  endif
+# else
+#  define _GL_ATTRIBUTE_COLD
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_CONST declares that it is OK for a compiler to omit duplicate
+   calls to the function with the same arguments.
+   This attribute is safe for a function that neither depends on nor affects
+   observable state, and always returns exactly once - e.g., does not loop
+   forever, and does not call longjmp.
+   (This attribute is stricter than _GL_ATTRIBUTE_PURE.)  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_CONST
+# if _GL_HAS_ATTRIBUTE (const)
+#  define _GL_ATTRIBUTE_CONST __attribute__ ((__const__))
+# else
+#  define _GL_ATTRIBUTE_CONST
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.
+   _GL_ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if _GL_GNUC_PREREQ (11, 0)
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+/* If gnulib's <string.h> or <wchar.h> has already defined this macro, continue
+   to use this earlier definition, since <stdlib.h> may not have been included
+   yet.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC_FREE
+# if defined __cplusplus && defined __GNUC__ && !defined __clang__
+/* Work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=108231> */
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC ((void (*) (void *)) free, 1)
+# else
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC (free, 1)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEPRECATED: Declares that an entity is deprecated.
+   The compiler may warn if the entity is used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: namespace, class, template specialization.  */
+#ifndef _GL_ATTRIBUTE_DEPRECATED
+# ifdef __has_c_attribute
+#  if __has_c_attribute (__deprecated__)
+#   define _GL_ATTRIBUTE_DEPRECATED __deprecated__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_DEPRECATED && _GL_HAS_ATTRIBUTE (deprecated)
+#  define _GL_ATTRIBUTE_DEPRECATED __attribute__ ((__deprecated__))
+# endif
+# ifndef _GL_ATTRIBUTE_DEPRECATED
+#  define _GL_ATTRIBUTE_DEPRECATED
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_ERROR(msg) requests an error if a function is called and
+   the function call is not optimized away.
+   _GL_ATTRIBUTE_WARNING(msg) requests a warning if a function is called and
+   the function call is not optimized away.  */
+/* Applies to: functions.  */
+#if !(defined _GL_ATTRIBUTE_ERROR && defined _GL_ATTRIBUTE_WARNING)
+# if _GL_HAS_ATTRIBUTE (error)
+#  define _GL_ATTRIBUTE_ERROR(msg) __attribute__ ((__error__ (msg)))
+#  define _GL_ATTRIBUTE_WARNING(msg) __attribute__ ((__warning__ (msg)))
+# elif _GL_HAS_ATTRIBUTE (diagnose_if)
+#  define _GL_ATTRIBUTE_ERROR(msg) __attribute__ ((__diagnose_if__ (1, msg, "error")))
+#  define _GL_ATTRIBUTE_WARNING(msg) __attribute__ ((__diagnose_if__ (1, msg, "warning")))
+# else
+#  define _GL_ATTRIBUTE_ERROR(msg)
+#  define _GL_ATTRIBUTE_WARNING(msg)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_EXTERNALLY_VISIBLE declares that the entity should remain
+   visible to debuggers etc., even with '-fwhole-program'.  */
+/* Applies to: functions, variables.  */
+#ifndef _GL_ATTRIBUTE_EXTERNALLY_VISIBLE
+# if _GL_HAS_ATTRIBUTE (externally_visible)
+#  define _GL_ATTRIBUTE_EXTERNALLY_VISIBLE __attribute__ ((externally_visible))
+# else
+#  define _GL_ATTRIBUTE_EXTERNALLY_VISIBLE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_FALLTHROUGH declares that it is not a programming mistake if
+   the control flow falls through to the immediately following 'case' or
+   'default' label.  The compiler should not warn in this case.  */
+/* Applies to: Empty statement (;), inside a 'switch' statement.  */
+/* Always expands to something.  */
+#ifndef _GL_ATTRIBUTE_FALLTHROUGH
+# ifdef __has_c_attribute
+#  if __has_c_attribute (__fallthrough__)
+#   define _GL_ATTRIBUTE_FALLTHROUGH __fallthrough__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_FALLTHROUGH && _GL_HAS_ATTRIBUTE (fallthrough)
+#  define _GL_ATTRIBUTE_FALLTHROUGH __attribute__ ((__fallthrough__))
+# endif
+# ifndef _GL_ATTRIBUTE_FALLTHROUGH
+#  define _GL_ATTRIBUTE_FALLTHROUGH ((void) 0)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_FORMAT ((ARCHETYPE, STRING-INDEX, FIRST-TO-CHECK))
+   declares that the STRING-INDEXth function argument is a format string of
+   style ARCHETYPE, which is one of:
+     printf, gnu_printf
+     scanf, gnu_scanf,
+     strftime, gnu_strftime,
+     strfmon,
+   or the same thing prefixed and suffixed with '__'.
+   If FIRST-TO-CHECK is not 0, arguments starting at FIRST-TO_CHECK
+   are suitable for the format string.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_FORMAT
+# if _GL_HAS_ATTRIBUTE (format)
+#  define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
+# else
+#  define _GL_ATTRIBUTE_FORMAT(spec)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_LEAF declares that if the function is called from some other
+   compilation unit, it executes code from that unit only by return or by
+   exception handling.  This declaration lets the compiler optimize that unit
+   more aggressively.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_LEAF
+# if _GL_HAS_ATTRIBUTE (leaf)
+#  define _GL_ATTRIBUTE_LEAF __attribute__ ((__leaf__))
+# else
+#  define _GL_ATTRIBUTE_LEAF
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MALLOC declares that the function returns a pointer to freshly
+   allocated memory.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_MALLOC
+# if _GL_HAS_ATTRIBUTE (malloc)
+#  define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
+# else
+#  define _GL_ATTRIBUTE_MALLOC
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MAY_ALIAS declares that pointers to the type may point to the
+   same storage as pointers to other types.  Thus this declaration disables
+   strict aliasing optimization.  */
+/* Applies to: types.  */
+/* Oracle Studio 12.6 mishandles may_alias despite __has_attribute OK.  */
+#ifndef _GL_ATTRIBUTE_MAY_ALIAS
+# if _GL_HAS_ATTRIBUTE (may_alias) && !defined __SUNPRO_C
+#  define _GL_ATTRIBUTE_MAY_ALIAS __attribute__ ((__may_alias__))
+# else
+#  define _GL_ATTRIBUTE_MAY_ALIAS
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MAYBE_UNUSED declares that it is not a programming mistake if
+   the entity is not used.  The compiler should not warn if the entity is not
+   used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: class.  */
+/* In C++ and C23, this is spelled __maybe_unused__.
+   GCC's syntax is __attribute__ ((__unused__)).
+   clang supports both syntaxes.  Except that with clang ≥ 6, < 10, in C++ mode,
+   __has_c_attribute (__maybe_unused__) yields true but the use of
+   __maybe_unused__ nevertheless produces a warning.  */
+#ifndef _GL_ATTRIBUTE_MAYBE_UNUSED
+# if defined __clang__ && defined __cplusplus
+#  if __clang_major__ >= 10
+#   define _GL_ATTRIBUTE_MAYBE_UNUSED __maybe_unused__
+#  endif
+# elif defined __has_c_attribute
+#  if __has_c_attribute (__maybe_unused__)
+#   define _GL_ATTRIBUTE_MAYBE_UNUSED __maybe_unused__
+#  endif
+# endif
+# ifndef _GL_ATTRIBUTE_MAYBE_UNUSED
+#  define _GL_ATTRIBUTE_MAYBE_UNUSED _GL_ATTRIBUTE_UNUSED
+# endif
+#endif
+/* Alternative spelling of this macro, for convenience and for
+   compatibility with glibc/include/libc-symbols.h.  */
+#define _GL_UNUSED _GL_ATTRIBUTE_MAYBE_UNUSED
+/* Earlier spellings of this macro.  */
+#define _UNUSED_PARAMETER_ _GL_ATTRIBUTE_MAYBE_UNUSED
+
+/* _GL_ATTRIBUTE_NODISCARD declares that the caller of the function should not
+   discard the return value.  The compiler may warn if the caller does not use
+   the return value, unless the caller uses something like ignore_value.  */
+/* Applies to: function, enumeration, class.  */
+#ifndef _GL_ATTRIBUTE_NODISCARD
+# if defined __clang__ && defined __cplusplus
+  /* With clang up to 15.0.6 (at least), in C++ mode, __nodiscard__ produces
+     a warning.
+     The 1000 below means a yet unknown threshold.  When clang++ version X
+     starts supporting __nodiscard__ without warning about it, you can
+     replace the 1000 with X.  */
+#  if __clang_major__ >= 1000
+#   define _GL_ATTRIBUTE_NODISCARD __nodiscard__
+#  endif
+# elif defined __has_c_attribute
+#  if __has_c_attribute (__nodiscard__)
+#   define _GL_ATTRIBUTE_NODISCARD __nodiscard__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_NODISCARD && _GL_HAS_ATTRIBUTE (warn_unused_result)
+#  define _GL_ATTRIBUTE_NODISCARD __attribute__ ((__warn_unused_result__))
+# endif
+# ifndef _GL_ATTRIBUTE_NODISCARD
+#  define _GL_ATTRIBUTE_NODISCARD
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NOINLINE tells that the compiler should not inline the
+   function.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NOINLINE
+# if _GL_HAS_ATTRIBUTE (noinline)
+#  define _GL_ATTRIBUTE_NOINLINE __attribute__ ((__noinline__))
+# else
+#  define _GL_ATTRIBUTE_NOINLINE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NONNULL ((N1, N2,...)) declares that the arguments N1, N2,...
+   must not be NULL.
+   _GL_ATTRIBUTE_NONNULL () declares that all pointer arguments must not be
+   null.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NONNULL
+# if _GL_HAS_ATTRIBUTE (nonnull)
+#  define _GL_ATTRIBUTE_NONNULL(args) __attribute__ ((__nonnull__ args))
+# else
+#  define _GL_ATTRIBUTE_NONNULL(args)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NONSTRING declares that the contents of a character array is
+   not meant to be NUL-terminated.  */
+/* Applies to: struct/union members and variables that are arrays of element
+   type 'unsigned char'.  */
+#ifndef _GL_ATTRIBUTE_NONSTRING
+# if _GL_HAS_ATTRIBUTE (nonstring)
+#  define _GL_ATTRIBUTE_NONSTRING __attribute__ ((__nonstring__))
+# else
+#  define _GL_ATTRIBUTE_NONSTRING
+# endif
+#endif
+
+/* There is no _GL_ATTRIBUTE_NORETURN; use _Noreturn instead.  */
+
+/* _GL_ATTRIBUTE_NOTHROW declares that the function does not throw exceptions.
+ */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NOTHROW
+# if _GL_HAS_ATTRIBUTE (nothrow) && !defined __cplusplus
+#  define _GL_ATTRIBUTE_NOTHROW __attribute__ ((__nothrow__))
+# else
+#  define _GL_ATTRIBUTE_NOTHROW
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_PACKED declares:
+   For struct members: The member has the smallest possible alignment.
+   For struct, union, class: All members have the smallest possible alignment,
+   minimizing the memory required.  */
+/* Applies to: struct members, struct, union,
+   in C++ also: class.  */
+#ifndef _GL_ATTRIBUTE_PACKED
+# if _GL_HAS_ATTRIBUTE (packed)
+#  define _GL_ATTRIBUTE_PACKED __attribute__ ((__packed__))
+# else
+#  define _GL_ATTRIBUTE_PACKED
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_PURE declares that It is OK for a compiler to omit duplicate
+   calls to the function with the same arguments if observable state is not
+   changed between calls.
+   This attribute is safe for a function that does not affect
+   observable state, and always returns exactly once.
+   (This attribute is looser than _GL_ATTRIBUTE_CONST.)  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_PURE
+# if _GL_HAS_ATTRIBUTE (pure)
+#  define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
+# else
+#  define _GL_ATTRIBUTE_PURE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_RETURNS_NONNULL declares that the function's return value is
+   a non-NULL pointer.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_RETURNS_NONNULL
+# if _GL_HAS_ATTRIBUTE (returns_nonnull)
+#  define _GL_ATTRIBUTE_RETURNS_NONNULL __attribute__ ((__returns_nonnull__))
+# else
+#  define _GL_ATTRIBUTE_RETURNS_NONNULL
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_SENTINEL(pos) declares that the variadic function expects a
+   trailing NULL argument.
+   _GL_ATTRIBUTE_SENTINEL () - The last argument is NULL (requires C99).
+   _GL_ATTRIBUTE_SENTINEL ((N)) - The (N+1)st argument from the end is NULL.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_SENTINEL
+# if _GL_HAS_ATTRIBUTE (sentinel)
+#  define _GL_ATTRIBUTE_SENTINEL(pos) __attribute__ ((__sentinel__ pos))
+# else
+#  define _GL_ATTRIBUTE_SENTINEL(pos)
+# endif
 #endif
+
+/* A helper macro.  Don't use it directly.  */
+#ifndef _GL_ATTRIBUTE_UNUSED
+# if _GL_HAS_ATTRIBUTE (unused)
+#  define _GL_ATTRIBUTE_UNUSED __attribute__ ((__unused__))
+# else
+#  define _GL_ATTRIBUTE_UNUSED
+# endif
+#endif
+
+dnl There is no _GL_ATTRIBUTE_VISIBILITY; see m4/visibility.m4 instead.
+
+/* _GL_UNUSED_LABEL; declares that it is not a programming mistake if the
+   immediately preceding label is not used.  The compiler should not warn
+   if the label is not used.  */
+/* Applies to: label (both in C and C++).  */
+/* Note that g++ < 4.5 does not support the '__attribute__ ((__unused__)) ;'
+   syntax.  But clang does.  */
+#ifndef _GL_UNUSED_LABEL
+# if !(defined __cplusplus && !_GL_GNUC_PREREQ (4, 5)) || defined __clang__
+#  define _GL_UNUSED_LABEL _GL_ATTRIBUTE_UNUSED
+# else
+#  define _GL_UNUSED_LABEL
+# endif
+#endif
+)
+  AH_VERBATIM(async_safe,
+/* The _GL_ASYNC_SAFE marker should be attached to functions that are
+   signal handlers (for signals other than SIGABRT, SIGPIPE) or can be
+   invoked from such signal handlers.  Such functions have some restrictions:
+     * All functions that it calls should be marked _GL_ASYNC_SAFE as well,
+       or should be listed as async-signal-safe in POSIX
+       <https://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_04>
+       section 2.4.3.  Note that malloc(), sprintf(), and fwrite(), in
+       particular, are NOT async-signal-safe.
+     * All memory locations (variables and struct fields) that these functions
+       access must be marked 'volatile'.  This holds for both read and write
+       accesses.  Otherwise the compiler might optimize away stores to and
+       reads from such locations that occur in the program, depending on its
+       data flow analysis.  For example, when the program contains a loop
+       that is intended to inspect a variable set from within a signal handler
+           while (!signal_occurred)
+             ;
+       the compiler is allowed to transform this into an endless loop if the
+       variable 'signal_occurred' is not declared 'volatile'.
+   Additionally, recall that:
+     * A signal handler should not modify errno (except if it is a handler
+       for a fatal signal and ends by raising the same signal again, thus
+       provoking the termination of the process).  If it invokes a function
+       that may clobber errno, it needs to save and restore the value of
+       errno.  */
+#define _GL_ASYNC_SAFE
 )
+  AH_VERBATIM(micro_optimizations,
+/* _GL_CMP (n1, n2) performs a three-valued comparison on n1 vs. n2, where
+   n1 and n2 are expressions without side effects, that evaluate to real
+   numbers (excluding NaN).
+   It returns
+     1  if n1 > n2
+     0  if n1 == n2
+     -1 if n1 < n2
+   The naïve code   (n1 > n2 ? 1 : n1 < n2 ? -1 : 0)  produces a conditional
+   jump with nearly all GCC versions up to GCC 10.
+   This variant     (n1 < n2 ? -1 : n1 > n2)  produces a conditional with many
+   GCC versions up to GCC 9.
+   The better code  (n1 > n2) - (n1 < n2)  from Hacker's Delight § 2-9
+   avoids conditional jumps in all GCC versions >= 3.4.  */
+#define _GL_CMP(n1, n2) (((n1) > (n2)) - ((n1) < (n2)))
+)
+  dnl Hint which direction to take regarding cross-compilation guesses:
+  dnl When a user installs a program on a platform they are not intimately
+  dnl familiar with, --enable-cross-guesses=conservative is the appropriate
+  dnl choice.  It implements the "If we don't know, assume the worst" principle.
+  dnl However, when an operating system developer (on a platform which is not
+  dnl yet known to gnulib) builds packages for their platform, they want to
+  dnl expose, not hide, possible platform bugs; in this case,
+  dnl --enable-cross-guesses=risky is the appropriate choice.
+  dnl Sets the variables
+  dnl gl_cross_guess_normal    (to be used when 'yes' is good and 'no' is bad),
+  dnl gl_cross_guess_inverted  (to be used when 'no' is good and 'yes' is bad).
+  AC_ARG_ENABLE(cross-guesses,
+    AS_HELP_STRING(--enable-cross-guesses={conservative|risky},
+       specify policy for cross-compilation guesses),
+    if test "x$enableval" != xconservative && test "x$enableval" != xrisky; then
+       AC_MSG_WARN(invalid argument supplied to --enable-cross-guesses)
+       enableval=conservative
+     fi
+     gl_cross_guesses="$enableval",
+    gl_cross_guesses=conservative)
+  if test $gl_cross_guesses = risky; then
+    gl_cross_guess_normal="guessing yes"
+    gl_cross_guess_inverted="guessing no"
+  else
+    gl_cross_guess_normal="guessing no"
+    gl_cross_guess_inverted="guessing yes"
+  fi
   dnl Preparation for running test programs:
   dnl Tell glibc to write diagnostics from -D_FORTIFY_SOURCE=2 to stderr, not
   dnl to /dev/tty, so they can be redirected to log files.  Such diagnostics
@@ -88,6 +606,16 @@
   export LIBC_FATAL_STDERR_
 )
 
+# gl_MODULE_INDICATOR_INIT_VARIABLE(variablename)
+# gl_MODULE_INDICATOR_INIT_VARIABLE(variablename, initialvalue)
+# initializes the shell variable that indicates the presence of the given module
+# as a C preprocessor expression.
+AC_DEFUN(gl_MODULE_INDICATOR_INIT_VARIABLE,
+
+  GL_MODULE_INDICATOR_PREFIX_$1=m4_if($2, , 0, $2)
+  AC_SUBST(GL_MODULE_INDICATOR_PREFIX_$1)
+)
+
 # gl_MODULE_INDICATOR_CONDITION
 # expands to a C preprocessor expression that evaluates to 1 or 0, depending
 # whether a gnulib module that has been requested shall be considered present
@@ -100,9 +628,9 @@
 AC_DEFUN(gl_MODULE_INDICATOR_SET_VARIABLE,
 
   gl_MODULE_INDICATOR_SET_VARIABLE_AUX(
-    GNULIB_m4_translit($1,
-                          abcdefghijklmnopqrstuvwxyz./-,
-                          ABCDEFGHIJKLMNOPQRSTUVWXYZ___),
+    GL_MODULE_INDICATOR_PREFIX_GNULIB_m4_translit($1,
+                                                       abcdefghijklmnopqrstuvwxyz./-,
+                                                       ABCDEFGHIJKLMNOPQRSTUVWXYZ___),
     gl_MODULE_INDICATOR_CONDITION)
 )
 
@@ -214,42 +742,20 @@
   AC_SUBST(HAVE_FEATURES_H)
 )
 
-# m4_foreach_w
-# is a backport of autoconf-2.59c's m4_foreach_w.
-# Remove this macro when we can assume autoconf >= 2.60.
-m4_ifndef(m4_foreach_w,
-  m4_define(m4_foreach_w,
-    m4_foreach($1, m4_split(m4_normalize($2),  ), $3)))
-
-# AS_VAR_IF(VAR, VALUE, IF-MATCH, IF-NOT-MATCH)
-# ----------------------------------------------------
-# Backport of autoconf-2.63b's macro.
-# Remove this macro when we can assume autoconf >= 2.64.
-m4_ifndef(AS_VAR_IF,
-m4_define(AS_VAR_IF,
-AS_IF(test x"AS_VAR_GET($1)" = x""$2, $3, $4)))
-
 # gl_PROG_CC_C99
 # Modifies the value of the shell variable CC in an attempt to make $CC
 # understand ISO C99 source code.
-# This is like AC_PROG_CC_C99, except that
-# - AC_PROG_CC_C99 did not exist in Autoconf versions < 2.60,
-# - AC_PROG_CC_C99 does not mix well with AC_PROG_CC_STDC
-#   <https://lists.gnu.org/r/bug-gnulib/2011-09/msg00367.html>,
-#   but many more packages use AC_PROG_CC_STDC than AC_PROG_CC_C99
-#   <https://lists.gnu.org/r/bug-gnulib/2011-09/msg00441.html>.
-# Remaining problems:
-# - When AC_PROG_CC_STDC is invoked twice, it adds the C99 enabling options
-#   to CC twice
-#   <https://lists.gnu.org/r/bug-gnulib/2011-09/msg00431.html>.
-# - AC_PROG_CC_STDC is likely to change now that C11 is an ISO standard.
 AC_DEFUN(gl_PROG_CC_C99,
 
-  dnl Change that version number to the minimum Autoconf version that supports
-  dnl mixing AC_PROG_CC_C99 calls with AC_PROG_CC_STDC calls.
-  m4_version_prereq(9.0,
-    AC_REQUIRE(AC_PROG_CC_C99),
-    AC_REQUIRE(AC_PROG_CC_STDC))
+  dnl Just use AC_PROG_CC_C99.
+  dnl When AC_PROG_CC_C99 and AC_PROG_CC_STDC are used together, the substituted
+  dnl value of CC will contain the C99 enabling options twice. But this is only
+  dnl a cosmetic problem.
+  dnl With Autoconf >= 2.70, use AC_PROG_CC since it implies AC_PROG_CC_C99;
+  dnl this avoids a "warning: The macro `AC_PROG_CC_C99' is obsolete."
+  m4_version_prereq(2.70,
+    AC_REQUIRE(AC_PROG_CC),
+    AC_REQUIRE(AC_PROG_CC_C99))
 )
 
 # gl_PROG_AR_RANLIB
@@ -322,36 +828,17 @@
   AC_SUBST(RANLIB)
 )
 
-# AC_PROG_MKDIR_P
-# is a backport of autoconf-2.60's AC_PROG_MKDIR_P, with a fix
-# for interoperability with automake-1.9.6 from autoconf-2.62.
-# Remove this macro when we can assume autoconf >= 2.62 or
-# autoconf >= 2.60 && automake >= 1.10.
-# AC_AUTOCONF_VERSION was introduced in 2.62, so use that as the witness.
-m4_ifndef(AC_AUTOCONF_VERSION,
-m4_ifdef(AC_PROG_MKDIR_P, 
-  dnl For automake-1.9.6 && autoconf < 2.62: Ensure MKDIR_P is AC_SUBSTed.
-  m4_define(AC_PROG_MKDIR_P,
-    m4_defn(AC_PROG_MKDIR_P)
-    AC_SUBST(MKDIR_P)), 
-  dnl For autoconf < 2.60: Backport of AC_PROG_MKDIR_P.
-  AC_DEFUN_ONCE(AC_PROG_MKDIR_P,
-    AC_REQUIRE(AM_PROG_MKDIR_P)dnl defined by automake
-     MKDIR_P='$(mkdir_p)'
-     AC_SUBST(MKDIR_P)))
-)
-
 # AC_C_RESTRICT
-# This definition is copied from post-2.69 Autoconf and overrides the
-# AC_C_RESTRICT macro from autoconf 2.60..2.69.  It can be removed
-# once autoconf >= 2.70 can be assumed.  It's painful to check version
-# numbers, and in practice this macro is more up-to-date than Autoconf
-# is, so override Autoconf unconditionally.
+# This definition is copied from post-2.70 Autoconf and overrides the
+# AC_C_RESTRICT macro from autoconf 2.60..2.70.
+m4_version_prereq(2.70.1, , 
 AC_DEFUN(AC_C_RESTRICT,
 AC_CACHE_CHECK(for C/C++ restrict keyword, ac_cv_c_restrict,
   ac_cv_c_restrict=no
-   # The order here caters to the fact that C++ does not require restrict.
-   for ac_kw in __restrict __restrict__ _Restrict restrict; do
+   # Put '__restrict__' first, to avoid problems with glibc and non-GCC; see:
+   # https://lists.gnu.org/archive/html/bug-autoconf/2016-02/msg00006.html
+   # Put 'restrict' last, because C++ lacks it.
+   for ac_kw in __restrict__ __restrict _Restrict restrict; do
      AC_COMPILE_IFELSE(
       AC_LANG_PROGRAM(
          typedef int *int_ptr;
@@ -371,14 +858,15 @@
  AH_VERBATIM(restrict,
 /* Define to the equivalent of the C99 'restrict' keyword, or to
    nothing if this is not supported.  Do not define if restrict is
-   supported directly.  */
+   supported only directly.  */
 #undef restrict
-/* Work around a bug in Sun C++: it does not support _Restrict or
-   __restrict__, even though the corresponding Sun C compiler ends up with
-   "#define restrict _Restrict" or "#define restrict __restrict__" in the
-   previous line.  Perhaps some future version of Sun C++ will work with
-   restrict; if so, hopefully it defines __RESTRICT like Sun C does.  */
-#if defined __SUNPRO_CC && !defined __RESTRICT
+/* Work around a bug in older versions of Sun C++, which did not
+   #define __restrict__ or support _Restrict or __restrict__
+   even though the corresponding Sun C compiler ended up with
+   "#define restrict _Restrict" or "#define restrict __restrict__"
+   in the previous line.  This workaround can be removed once
+   we assume Oracle Developer Studio 12.5 (2016) or later.  */
+#if defined __SUNPRO_CC && !defined __RESTRICT && !defined __restrict__
 # define _Restrict
 # define __restrict__
 #endif)
@@ -388,6 +876,7 @@
    *)  AC_DEFINE_UNQUOTED(restrict, $ac_cv_c_restrict) ;;
  esac
 )# AC_C_RESTRICT
+)
 
 # gl_BIGENDIAN
 # is like AC_C_BIGENDIAN, except that it can be AC_REQUIREd.
@@ -398,6 +887,22 @@
   AC_C_BIGENDIAN
 )
 
+# A temporary file descriptor.
+# Must be less than 10, because dash 0.5.8 does not support redirections
+# with multi-digit file descriptors.
+m4_define(GL_TMP_FD, 9)
+
+# gl_SILENT(command)
+# executes command, but without the normal configure output.
+# This is useful when you want to invoke AC_CACHE_CHECK (or AC_CHECK_FUNC etc.)
+# inside another AC_CACHE_CHECK.
+AC_DEFUN(gl_SILENT,
+
+  exec GL_TMP_FD>&AS_MESSAGE_FD AS_MESSAGE_FD>/dev/null
+  $1
+  exec AS_MESSAGE_FD>&GL_TMP_FD GL_TMP_FD>&-
+)
+
 # gl_CACHE_VAL_SILENT(cache-id, command-to-set-it)
 # is like AC_CACHE_VAL(cache-id, command-to-set-it), except that it does not
 # output a spurious "(cached)" mark in the midst of other configure output.
@@ -405,70 +910,334 @@
 # by an AC_MSG_CHECKING/AC_MSG_RESULT pair.
 AC_DEFUN(gl_CACHE_VAL_SILENT,
 
-  saved_as_echo_n="$as_echo_n"
-  as_echo_n=':'
-  AC_CACHE_VAL($1, $2)
-  as_echo_n="$saved_as_echo_n"
+  gl_SILENT(
+    AC_CACHE_VAL($1, $2)
+  )
 )
 
-# AS_VAR_COPY was added in autoconf 2.63b
-m4_define_default(AS_VAR_COPY,
-AS_LITERAL_IF($1$2, $1=$$2, eval $1=\$$2))
-
-# AC_PROG_SED was added in autoconf 2.59b
-m4_ifndef(AC_PROG_SED,
-AC_DEFUN(AC_PROG_SED,
-AC_CACHE_CHECK(for a sed that does not truncate output, ac_cv_path_SED,
-    dnl ac_script should not contain more than 99 commands (for HP-UX sed),
-     dnl but more than about 7000 bytes, to catch a limit in Solaris 8 /usr/ucb/sed.
-     ac_script=s/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb/
-     for ac_i in 1 2 3 4 5 6 7; do
-       ac_script="$ac_script$as_nl$ac_script"
-     done
-     echo "$ac_script" 2>/dev/null | sed 99q >conftest.sed
-     AS_UNSET(ac_script)
-     if test -z "$SED"; then
-       ac_path_SED_found=false
-       _AS_PATH_WALK(, 
-         for ac_prog in sed gsed; do
-           for ac_exec_ext in '' $ac_executable_extensions; do
-             ac_path_SED="$as_dir/$ac_prog$ac_exec_ext"
-             AS_EXECUTABLE_P("$ac_path_SED") || continue
-             case `"$ac_path_SED" --version 2>&1` in
-               *GNU*) ac_cv_path_SED=$ac_path_SED ac_path_SED_found=:;;
-               *)
-                 ac_count=0
-                 _AS_ECHO_N(0123456789) >conftest.in
-                 while :
-                 do
-                   cat conftest.in conftest.in >conftest.tmp
-                   mv conftest.tmp conftest.in
-                   cp conftest.in conftest.nl
-                   echo >> conftest.nl
-                   "$ac_path_SED" -f conftest.sed <conftest.nl >conftest.out 2>/dev/null || break
-                   diff conftest.out conftest.nl >/dev/null 2>&1 || break
-                   ac_count=`expr $ac_count + 1`
-                   if test $ac_count -gt ${ac_path_SED_max-0}; then
-                     # Best so far, but keep looking for better
-                     ac_cv_path_SED=$ac_path_SED
-                     ac_path_SED_max=$ac_count
-                   fi
-                   test $ac_count -gt 10 && break
-                 done
-                 rm -f conftest.in conftest.tmp conftest.nl conftest.out;;
-             esac
-             $ac_path_SED_found && break 3
-           done
-         done)
-       if test -z "$ac_cv_path_SED"; then
-         AC_ERROR(no acceptable sed could be found in \$PATH)
-       fi
+# gl_CONDITIONAL(conditional, condition)
+# is like AM_CONDITIONAL(conditional, condition), except that it does not
+# produce an error
+#   configure: error: conditional "..." was never defined.
+#   Usually this means the macro was only invoked conditionally.
+# when only invoked conditionally. Instead, in that case, both the _TRUE
+# and the _FALSE case are disabled.
+AC_DEFUN(gl_CONDITIONAL,
+
+  pushdef(AC_CONFIG_COMMANDS_PRE, :)dnl
+  AM_CONDITIONAL($1, $2)
+  popdef(AC_CONFIG_COMMANDS_PRE)dnl
+  if test -z "${$1_TRUE}" && test -z "${$1_FALSE}"; then
+    $1_TRUE='#'
+    $1_FALSE='#'
+  fi
+)
+
+# gl_CC_ALLOW_WARNINGS
+# sets and substitutes a variable GL_CFLAG_ALLOW_WARNINGS, to a $(CC) option
+# that reverts a preceding '-Werror' option, if available.
+# This is expected to be '-Wno-error' on gcc, clang (except clang/MSVC), xlclang
+# and empty otherwise.
+AC_DEFUN(gl_CC_ALLOW_WARNINGS,
+
+  AC_REQUIRE(AC_PROG_CC)
+  AC_CACHE_CHECK(for C compiler option to allow warnings,
+    gl_cv_cc_wallow,
+    rm -f conftest*
+     echo 'int dummy;' > conftest.c
+     AC_TRY_COMMAND(${CC-cc} $CFLAGS $CPPFLAGS -c conftest.c 2>conftest1.err) >/dev/null
+     AC_TRY_COMMAND(${CC-cc} $CFLAGS $CPPFLAGS -Wno-error -c conftest.c 2>conftest2.err) >/dev/null
+     dnl Test the number of error output lines, because AIX xlc accepts the
+     dnl option '-Wno-error', just to produce a warning
+     dnl "Option -Wno-error was incorrectly specified. The option will be ignored."
+     dnl afterwards.
+     if test $? = 0 && test `wc -l < conftest1.err` = `wc -l < conftest2.err`; then
+       gl_cv_cc_wallow='-Wno-error'
      else
-       ac_cv_path_SED=$SED
+       gl_cv_cc_wallow=none
      fi
+     rm -f conftest*
+    )
+  case "$gl_cv_cc_wallow" in
+    none) GL_CFLAG_ALLOW_WARNINGS='' ;;
+    *)    GL_CFLAG_ALLOW_WARNINGS="$gl_cv_cc_wallow" ;;
+  esac
+  AC_SUBST(GL_CFLAG_ALLOW_WARNINGS)
+)
+
+# gl_CXX_ALLOW_WARNINGS
+# sets and substitutes a variable GL_CXXFLAG_ALLOW_WARNINGS, to a $(CC) option
+# that reverts a preceding '-Werror' option, if available.
+AC_DEFUN(gl_CXX_ALLOW_WARNINGS,
+
+  dnl Requires AC_PROG_CXX or gl_PROG_ANSI_CXX.
+  if test -n "$CXX" && test "$CXX" != no; then
+    AC_CACHE_CHECK(for C++ compiler option to allow warnings,
+      gl_cv_cxx_wallow,
+      rm -f conftest*
+       echo 'int dummy;' > conftest.cc
+       AC_TRY_COMMAND(${CXX-c++} $CXXFLAGS $CPPFLAGS -c conftest.cc 2>conftest1.err) >/dev/null
+       AC_TRY_COMMAND(${CXX-c++} $CXXFLAGS $CPPFLAGS -Wno-error -c conftest.cc 2>conftest2.err) >/dev/null
+       dnl Test the number of error output lines, because AIX xlC accepts the
+       dnl option '-Wno-error', just to produce a warning
+       dnl "Option -Wno-error was incorrectly specified. The option will be ignored."
+       dnl afterwards.
+       if test $? = 0 && test `wc -l < conftest1.err` = `wc -l < conftest2.err`; then
+         gl_cv_cxx_wallow='-Wno-error'
+       else
+         gl_cv_cxx_wallow=none
+       fi
+       rm -f conftest*
+      )
+    case "$gl_cv_cxx_wallow" in
+      none) GL_CXXFLAG_ALLOW_WARNINGS='' ;;
+      *)    GL_CXXFLAG_ALLOW_WARNINGS="$gl_cv_cxx_wallow" ;;
+    esac
+  else
+    GL_CXXFLAG_ALLOW_WARNINGS=''
+  fi
+  AC_SUBST(GL_CXXFLAG_ALLOW_WARNINGS)
+)
+
+# gl_CC_GNULIB_WARNINGS
+# sets and substitutes a variable GL_CFLAG_GNULIB_WARNINGS, to a $(CC) option
+# set that enables or disables warnings as suitable for the Gnulib coding style.
+AC_DEFUN(gl_CC_GNULIB_WARNINGS,
+
+  AC_REQUIRE(gl_CC_ALLOW_WARNINGS)
+  dnl Assume that the compiler supports -Wno-* options only if it also supports
+  dnl -Wno-error.
+  GL_CFLAG_GNULIB_WARNINGS=''
+  if test -n "$GL_CFLAG_ALLOW_WARNINGS"; then
+    dnl Enable these warning options:
+    dnl
+    dnl                                       GCC             clang
+    dnl -Wno-cast-qual                        >= 3            >= 3.9
+    dnl -Wno-conversion                       >= 3            >= 3.9
+    dnl -Wno-float-conversion                 >= 4.9          >= 3.9
+    dnl -Wno-float-equal                      >= 3            >= 3.9
+    dnl -Wimplicit-fallthrough                >= 7            >= 3.9
+    dnl -Wno-pedantic                         >= 4.8          >= 3.9
+    dnl -Wno-sign-compare                     >= 3            >= 3.9
+    dnl -Wno-sign-conversion                  >= 4.3          >= 3.9
+    dnl -Wno-type-limits                      >= 4.3          >= 3.9
+    dnl -Wno-undef                            >= 3            >= 3.9
+    dnl -Wno-unsuffixed-float-constants       >= 4.5
+    dnl -Wno-unused-function                  >= 3            >= 3.9
+    dnl -Wno-unused-parameter                 >= 3            >= 3.9
+    dnl
+    cat > conftest.c <<\EOF
+      #if __GNUC__ >= 3 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-cast-qual
+      -Wno-conversion
+      -Wno-float-equal
+      -Wno-sign-compare
+      -Wno-undef
+      -Wno-unused-function
+      -Wno-unused-parameter
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 9) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-float-conversion
+      #endif
+      #if __GNUC__ >= 7 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wimplicit-fallthrough
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 8) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-pedantic
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 3) > 4 || (__clang_major__ + (__clang_minor__ >= 9) > 3)
+      -Wno-sign-conversion
+      -Wno-type-limits
+      #endif
+      #if __GNUC__ + (__GNUC_MINOR__ >= 5) > 4
+      -Wno-unsuffixed-float-constants
+      #endif
+EOF
+    gl_command="$CC $CFLAGS $CPPFLAGS -E conftest.c > conftest.out"
+    if AC_TRY_EVAL(gl_command); then
+      gl_options=`grep -v '#' conftest.out`
+      for word in $gl_options; do
+        GL_CFLAG_GNULIB_WARNINGS="$GL_CFLAG_GNULIB_WARNINGS $word"
+      done
+    fi
+    rm -f conftest.c conftest.out
+  fi
+  AC_SUBST(GL_CFLAG_GNULIB_WARNINGS)
+)
+
+dnl gl_CONDITIONAL_HEADER(foo.h)
+dnl takes a shell variable GL_GENERATE_FOO_H (with value true or false) as input
+dnl and produces
+dnl   - an AC_SUBSTed variable FOO_H that is either a file name or empty, based
+dnl     on whether GL_GENERATE_FOO_H is true or false,
+dnl   - an Automake conditional GL_GENERATE_FOO_H that evaluates to the value of
+dnl     the shell variable GL_GENERATE_FOO_H.
+AC_DEFUN(gl_CONDITIONAL_HEADER,
+
+  m4_pushdef(gl_header_name, AS_TR_SH(m4_toupper($1)))
+  m4_pushdef(gl_generate_var, GL_GENERATE_AS_TR_SH(m4_toupper($1)))
+  m4_pushdef(gl_generate_cond, GL_GENERATE_AS_TR_SH(m4_toupper($1)))
+  case "$gl_generate_var" in
+    false) gl_header_name='' ;;
+    true)
+      dnl It is OK to use a .h file in lib/ from within tests/, but not vice
+      dnl versa.
+      if test -z "$gl_header_name"; then
+        gl_header_name="${gl_source_base_prefix}$1"
+      fi
+      ;;
+    *) echo "*** gl_generate_var is not set correctly" 1>&2; exit 1 ;;
+  esac
+  AC_SUBST(gl_header_name)
+  gl_CONDITIONAL(gl_generate_cond, $gl_generate_var)
+  m4_popdef(gl_generate_cond)
+  m4_popdef(gl_generate_var)
+  m4_popdef(gl_header_name)
+)
+
+dnl gl_CHECK_FUNCS_ANDROID(func, #include <foo.h>)
+dnl is like AC_CHECK_FUNCS(func), taking into account a portability problem
+dnl on Android.
+dnl
+dnl When code is compiled on Android, it is in the context of a certain
+dnl "Android API level", which indicates the minimum version of Android on
+dnl which the app can be installed. In other words, you don't compile for a
+dnl specific version of Android. You compile for all versions of Android,
+dnl onwards from the given API level.
+dnl Thus, the question "does the OS have the function func" has three possible
+dnl answers:
+dnl   - yes, in all versions starting from the given API level,
+dnl   - no, in no version,
+dnl   - not in the given API level, but in a later version of Android.
+dnl
+dnl In detail, this works as follows:
+dnl If func was added to Android API level, say, 28, then the libc.so has the
+dnl symbol func always, whereas the header file <foo.h> declares func
+dnl conditionally:
+dnl   #if __ANDROID_API__ >= 28
+dnl   ... func (...) __INTRODUCED_IN(28);
+dnl   #endif
+dnl Thus, when compiling with "clang -target armv7a-unknown-linux-android28",
+dnl the function func is declared and exists in libc.
+dnl Whereas when compiling with "clang -target armv7a-unknown-linux-android27",
+dnl the function func is not declared but exists in libc.
+dnl
+dnl This macro sets two variables:
+dnl   - gl_cv_onwards_func_<func>   to yes / no / "future OS version"
+dnl   - ac_cv_func_<func>           to yes / no / no
+dnl The first variable allows to distinguish all three cases.
+dnl The second variable is set, so that an invocation
+dnl   gl_CHECK_FUNCS_ANDROID(func, #include <foo.h>)
+dnl can be used as a drop-in replacement for
+dnl   AC_CHECK_FUNCS(func).
+AC_DEFUN(gl_CHECK_FUNCS_ANDROID,
+
+  AC_REQUIRE(AC_CANONICAL_HOST)
+  AC_CACHE_CHECK(for $1,
+    gl_cv_onwards_func_$1,
+    gl_SILENT(
+       case "$host_os" in
+         linux*-android*)
+           AC_CHECK_DECL($1, , , $2)
+           if test $ac_cv_have_decl_$1 = yes; then
+             AC_CHECK_FUNC($1)
+             if test $ac_cv_func_$1 = yes; then
+               gl_cv_onwards_func_$1=yes
+             else
+               dnl The function is declared but does not exist. This should not
+               dnl happen normally. But anyway, we know that a future version
+               dnl of Android will have the function.
+               gl_cv_onwards_func_$1='future OS version'
+             fi
+           else
+             gl_cv_onwards_func_$1='future OS version'
+           fi
+           ;;
+         *)
+           AC_CHECK_FUNC($1)
+           gl_cv_onwards_func_$1=$ac_cv_func_$1
+           ;;
+       esac
+      )
     )
- SED="$ac_cv_path_SED"
- AC_SUBST(SED)dnl
- rm -f conftest.sed
+  case "$gl_cv_onwards_func_$1" in
+    future*) ac_cv_func_$1=no ;;
+    *)       ac_cv_func_$1=$gl_cv_onwards_func_$1 ;;
+  esac
+  if test $ac_cv_func_$1 = yes; then
+    AC_DEFINE(HAVE_m4_translit($1,
+                                 abcdefghijklmnopqrstuvwxyz,
+                                 ABCDEFGHIJKLMNOPQRSTUVWXYZ),
+              1, Define to 1 if you have the `$1' function.)
+  fi
 )
+
+dnl Expands to some code for use in .c programs that, on native Windows, defines
+dnl the Microsoft deprecated alias function names to the underscore-prefixed
+dnl actual function names. With this macro, these function names are available
+dnl without linking with '-loldnames' and without generating warnings.
+dnl Usage: Use it after all system header files are included.
+dnl          #include <...>
+dnl          #include <...>
+dnl          GL_MDA_DEFINES
+dnl          ...
+AC_DEFUN(GL_MDA_DEFINES,
+AC_REQUIRE(_GL_MDA_DEFINES)
+$gl_mda_defines
+)
+AC_DEFUN(_GL_MDA_DEFINES,
+gl_mda_defines='
+#if defined _WIN32 && !defined __CYGWIN__
+#define access    _access
+#define chdir     _chdir
+#define chmod     _chmod
+#define close     _close
+#define creat     _creat
+#define dup       _dup
+#define dup2      _dup2
+#define ecvt      _ecvt
+#define execl     _execl
+#define execle    _execle
+#define execlp    _execlp
+#define execv     _execv
+#define execve    _execve
+#define execvp    _execvp
+#define execvpe   _execvpe
+#define fcloseall _fcloseall
+#define fcvt      _fcvt
+#define fdopen    _fdopen
+#define fileno    _fileno
+#define gcvt      _gcvt
+#define getcwd    _getcwd
+#define getpid    _getpid
+#define getw      _getw
+#define isatty    _isatty
+#define j0        _j0
+#define j1        _j1
+#define jn        _jn
+#define lfind     _lfind
+#define lsearch   _lsearch
+#define lseek     _lseek
+#define memccpy   _memccpy
+#define mkdir     _mkdir
+#define mktemp    _mktemp
+#define open      _open
+#define putenv    _putenv
+#define putw      _putw
+#define read      _read
+#define rmdir     _rmdir
+#define strdup    _strdup
+#define swab      _swab
+#define tempnam   _tempnam
+#define tzset     _tzset
+#define umask     _umask
+#define unlink    _unlink
+#define utime     _utime
+#define wcsdup    _wcsdup
+#define write     _write
+#define y0        _y0
+#define y1        _y1
+#define yn        _yn
+#endif
+'
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/gnulib-comp.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/gnulib-comp.m4 Changed

@@ -1,9 +1,9 @@
 # DO NOT EDIT! GENERATED AUTOMATICALLY!
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2023 Free Software Foundation, Inc.
 #
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This file is distributed in the hope that it will be useful,
@@ -42,9 +42,10 @@
   AC_REQUIRE(gl_USE_SYSTEM_EXTENSIONS)
   AC_REQUIRE(gl_PROG_AR_RANLIB)
 
-  AC_REQUIRE(AM_PROG_CC_C_O)
   # Code from module absolute-header:
   # Code from module alloca-opt:
+  # Code from module assert-h:
+  # Code from module attribute:
   # Code from module errno:
   # Code from module extensions:
   # Code from module extern-inline:
@@ -53,13 +54,15 @@
   AC_REQUIRE(gl_FP_IEEE)
   # Code from module fprintf-posix:
   # Code from module fpucw:
+  # Code from module free-posix:
   # Code from module frexp-nolibm:
   # Code from module frexpl-nolibm:
   # Code from module fseterr:
+  # Code from module gen-header:
   # Code from module git-version-gen:
   # Code from module havelib:
-  # Code from module host-cpu-c-abi:
   # Code from module include_next:
+  # Code from module inttypes-incomplete:
   # Code from module isnand-nolibm:
   # Code from module isnanf-nolibm:
   # Code from module isnanl-nolibm:
@@ -69,28 +72,30 @@
   # Code from module memchr:
   # Code from module multiarch:
   # Code from module nocrash:
-  # Code from module non-recursive-gnulib-prefix-hack:
   # Code from module printf-frexp:
   # Code from module printf-frexpl:
   # Code from module printf-safe:
   # Code from module signbit:
   # Code from module size_max:
+  # Code from module snippet/_Noreturn:
   # Code from module snippet/arg-nonnull:
   # Code from module snippet/c++defs:
   # Code from module snippet/warn-on-use:
   # Code from module snprintf:
   # Code from module ssize_t:
+  # Code from module stdbool-c99:
   # Code from module stddef:
   # Code from module stdint:
   # Code from module stdio:
+  # Code from module stdlib:
   # Code from module streq:
   # Code from module string:
   # Code from module sys_types:
+  # Code from module unistd:
   # Code from module unitypes:
   # Code from module uniwidth/base:
   # Code from module uniwidth/width:
   # Code from module vasnprintf:
-  # Code from module verify:
   # Code from module vsnprintf:
   # Code from module wchar:
   # Code from module wctype-h:
@@ -112,20 +117,34 @@
   m4_pushdef(AC_LIBSOURCES, m4_defn(gl_LIBSOURCES))
   m4_pushdef(gl_LIBSOURCES_LIST, )
   m4_pushdef(gl_LIBSOURCES_DIR, )
+  m4_pushdef(GL_MACRO_PREFIX, gl)
+  m4_pushdef(GL_MODULE_INDICATOR_PREFIX, GL)
   gl_COMMON
   gl_source_base='lib'
+  gl_source_base_prefix='$(top_build_prefix)lib/'
   gl_FUNC_ALLOCA
+  gl_CONDITIONAL_HEADER(alloca.h)
+  AC_PROG_MKDIR_P
+  gl_ASSERT_H
+  gl_CONDITIONAL_HEADER(assert.h)
+  AC_PROG_MKDIR_P
   gl_HEADER_ERRNO_H
+  gl_CONDITIONAL_HEADER(errno.h)
+  AC_PROG_MKDIR_P
   AC_REQUIRE(gl_EXTERN_INLINE)
   gl_FLOAT_H
-  if test $REPLACE_FLOAT_LDBL = 1; then
-    AC_LIBOBJ(float)
-  fi
-  if test $REPLACE_ITOLD = 1; then
-    AC_LIBOBJ(itold)
-  fi
+  gl_CONDITIONAL_HEADER(float.h)
+  AC_PROG_MKDIR_P
+  gl_CONDITIONAL(GL_COND_OBJ_FLOAT, test $REPLACE_FLOAT_LDBL = 1)
+  gl_CONDITIONAL(GL_COND_OBJ_ITOLD, test $REPLACE_ITOLD = 1)
   gl_FUNC_FPRINTF_POSIX
   gl_STDIO_MODULE_INDICATOR(fprintf-posix)
+  gl_FUNC_FREE
+  gl_CONDITIONAL(GL_COND_OBJ_FREE, test $REPLACE_FREE = 1)
+  AM_COND_IF(GL_COND_OBJ_FREE, 
+    gl_PREREQ_FREE
+  )
+  gl_STDLIB_MODULE_INDICATOR(free-posix)
   gl_FUNC_FREXP_NO_LIBM
   if test $gl_func_frexp_no_libm != yes; then
     AC_LIBOBJ(frexp)
@@ -137,10 +156,11 @@
   fi
   gl_MATH_MODULE_INDICATOR(frexpl)
   gl_FUNC_FSETERR
-  if test $ac_cv_func___fseterr = no; then
-    AC_LIBOBJ(fseterr)
-  fi
-  AC_REQUIRE(gl_HOST_CPU_C_ABI)
+  gl_CONDITIONAL(GL_COND_OBJ_FSETERR, test $ac_cv_func___fseterr = no)
+  AC_DEFUN(gl_HAVE_MODULE_HAVELIB)
+  gl_INTTYPES_INCOMPLETE
+  gl_INTTYPES_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
   gl_FUNC_ISNAND_NO_LIBM
   if test $gl_func_isnand_no_libm != yes; then
     AC_LIBOBJ(isnand)
@@ -157,60 +177,121 @@
     gl_PREREQ_ISNANL
   fi
   gl_LIMITS_H
+  gl_CONDITIONAL_HEADER(limits.h)
+  AC_PROG_MKDIR_P
   gl_LOCALCHARSET
   dnl For backward compatibility. Some packages still use this.
   LOCALCHARSET_TESTS_ENVIRONMENT=
   AC_SUBST(LOCALCHARSET_TESTS_ENVIRONMENT)
   gl_MATH_H
+  gl_MATH_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
   gl_FUNC_MEMCHR
-  if test $HAVE_MEMCHR = 0 || test $REPLACE_MEMCHR = 1; then
-    AC_LIBOBJ(memchr)
+  gl_CONDITIONAL(GL_COND_OBJ_MEMCHR, test $REPLACE_MEMCHR = 1)
+  AM_COND_IF(GL_COND_OBJ_MEMCHR, 
     gl_PREREQ_MEMCHR
-  fi
+  )
   gl_STRING_MODULE_INDICATOR(memchr)
   gl_MULTIARCH
-  dnl Run our hack near the end, just before config.status creation.
-  dnl It must happen late, i.e., after gl_LIBOBJS has been finalized.
-  AC_CONFIG_COMMANDS_PRE(
-    dnl Note we can't currently pass $gl_source_base instead of 'lib',
-    dnl because $gl_source_base is unset or the wrong value in the references
-    dnl generated in m4/non-recursive-gnulib-prefix-hack.m4
-    gl_NON_RECURSIVE_GNULIB_PREFIX_HACK(lib)
-    )
   gl_FUNC_PRINTF_FREXP
   gl_FUNC_PRINTF_FREXPL
   m4_divert_text(INIT_PREPARE, gl_printf_safe=yes)
   gl_SIGNBIT
-  if test $REPLACE_SIGNBIT = 1; then
-    AC_LIBOBJ(signbitf)
-    AC_LIBOBJ(signbitd)
-    AC_LIBOBJ(signbitl)
-  fi
+  gl_CONDITIONAL(GL_COND_OBJ_SIGNBIT3, test $REPLACE_SIGNBIT = 1)
   gl_MATH_MODULE_INDICATOR(signbit)
   gl_SIZE_MAX
   gl_FUNC_SNPRINTF
   gl_STDIO_MODULE_INDICATOR(snprintf)
   gl_MODULE_INDICATOR(snprintf)
   gt_TYPE_SSIZE_T
+  gl_STDBOOL_H
+  gl_CONDITIONAL_HEADER(stdbool.h)
+  AC_PROG_MKDIR_P
   gl_STDDEF_H
+  gl_STDDEF_H_REQUIRE_DEFAULTS
+  gl_CONDITIONAL_HEADER(stddef.h)
+  AC_PROG_MKDIR_P
   gl_STDINT_H
+  gl_CONDITIONAL_HEADER(stdint.h)
+  dnl Because of gl_REPLACE_LIMITS_H:
+  gl_CONDITIONAL_HEADER(limits.h)
+  AC_PROG_MKDIR_P
   gl_STDIO_H
-  gl_HEADER_STRING_H
+  gl_STDIO_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
+  gl_CONDITIONAL(GL_COND_OBJ_STDIO_READ, test $REPLACE_STDIO_READ_FUNCS = 1)
+  gl_CONDITIONAL(GL_COND_OBJ_STDIO_WRITE, test $REPLACE_STDIO_WRITE_FUNCS = 1)
+  dnl No need to create extra modules for these functions. Everyone who uses
+  dnl <stdio.h> likely needs them.
+  gl_STDIO_MODULE_INDICATOR(fscanf)
+  gl_MODULE_INDICATOR(fscanf)
+  gl_STDIO_MODULE_INDICATOR(scanf)
+  gl_MODULE_INDICATOR(scanf)
+  gl_STDIO_MODULE_INDICATOR(fgetc)
+  gl_STDIO_MODULE_INDICATOR(getc)
+  gl_STDIO_MODULE_INDICATOR(getchar)
+  gl_STDIO_MODULE_INDICATOR(fgets)
+  gl_STDIO_MODULE_INDICATOR(fread)
+  dnl No need to create extra modules for these functions. Everyone who uses
+  dnl <stdio.h> likely needs them.
+  gl_STDIO_MODULE_INDICATOR(fprintf)
+  gl_STDIO_MODULE_INDICATOR(printf)
+  gl_STDIO_MODULE_INDICATOR(vfprintf)
+  gl_STDIO_MODULE_INDICATOR(vprintf)
+  gl_STDIO_MODULE_INDICATOR(fputc)
+  gl_STDIO_MODULE_INDICATOR(putc)
+  gl_STDIO_MODULE_INDICATOR(putchar)
+  gl_STDIO_MODULE_INDICATOR(fputs)
+  gl_STDIO_MODULE_INDICATOR(puts)
+  gl_STDIO_MODULE_INDICATOR(fwrite)
+  gl_STDLIB_H
+  gl_STDLIB_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
+  gl_STRING_H
+  gl_STRING_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
   gl_SYS_TYPES_H
+  gl_SYS_TYPES_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
+  gl_UNISTD_H
+  gl_UNISTD_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
+  gl_LIBUNISTRING_LIBHEADER(0.9.11, unitypes.h)
+  AC_PROG_MKDIR_P
+  AH_VERBATIM(unitypes_restrict, 
+  /* This definition is a duplicate of the one in unitypes.h.
+     It is here so that we can cope with an older version of unitypes.h
+     that does not contain this definition and that is pre-installed among
+     the public header files.  */
+  # if defined __restrict \
+       || 2 < __GNUC__ + (95 <= __GNUC_MINOR__) \
+       || __clang_major__ >= 3
+  #  define _UC_RESTRICT __restrict
+  # elif 199901L <= __STDC_VERSION__ || defined restrict
+  #  define _UC_RESTRICT restrict
+  # else
+  #  define _UC_RESTRICT
+  # endif
+  )
+  gl_LIBUNISTRING_LIBHEADER(0.9.11, uniwidth.h)
   AC_PROG_MKDIR_P
-  gl_LIBUNISTRING_LIBHEADER(0.9.4, unitypes.h)
-  gl_LIBUNISTRING_LIBHEADER(0.9.4, uniwidth.h)
-  gl_LIBUNISTRING_MODULE(0.9.8, uniwidth/width)
+  gl_LIBUNISTRING_MODULE(1.1, uniwidth/width)
+  AC_REQUIRE(AC_C_RESTRICT)
   gl_FUNC_VASNPRINTF
   gl_FUNC_VSNPRINTF
   gl_STDIO_MODULE_INDICATOR(vsnprintf)
   gl_WCHAR_H
+  gl_WCHAR_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
   gl_WCTYPE_H
+  gl_WCTYPE_H_REQUIRE_DEFAULTS
+  AC_PROG_MKDIR_P
   gl_FUNC_WCWIDTH
-  if test $HAVE_WCWIDTH = 0 || test $REPLACE_WCWIDTH = 1; then
-    AC_LIBOBJ(wcwidth)
+  gl_CONDITIONAL(GL_COND_OBJ_WCWIDTH,
+                 test $HAVE_WCWIDTH = 0 || test $REPLACE_WCWIDTH = 1)
+  AM_COND_IF(GL_COND_OBJ_WCWIDTH, 
     gl_PREREQ_WCWIDTH
-  fi
+  )
   gl_WCHAR_MODULE_INDICATOR(wcwidth)
   gl_XSIZE
   # End of code from modules
@@ -225,6 +306,8 @@
       m4_if(m4_sysval, 0, ,
         AC_FATAL(expected source file, required through AC_LIBSOURCES, not found))
   )
+  m4_popdef(GL_MODULE_INDICATOR_PREFIX)
+  m4_popdef(GL_MACRO_PREFIX)
   m4_popdef(gl_LIBSOURCES_DIR)
   m4_popdef(gl_LIBSOURCES_LIST)
   m4_popdef(AC_LIBSOURCES)
@@ -233,16 +316,28 @@
   AC_CONFIG_COMMANDS_PRE(
     gl_libobjs=
     gl_ltlibobjs=
+    gl_libobjdeps=
     if test -n "$gl_LIBOBJS"; then
       # Remove the extension.
+changequote(,)dnl
       sed_drop_objext='s/\.o$//;s/\.obj$//'
+      sed_dirname1='s,//*,/,g'
+      sed_dirname2='s,$.$/$,\1,'
+      sed_dirname3='s,^^/*$,.,'
+      sed_dirname4='s,$.$/^/*$,\1,'
+      sed_basename1='s,.*/,,'
+changequote(, )dnl
       for i in `for i in $gl_LIBOBJS; do echo "$i"; done | sed -e "$sed_drop_objext" | sort | uniq`; do
-        gl_libobjs="$gl_libobjs $i.$ac_objext"
-        gl_ltlibobjs="$gl_ltlibobjs $i.lo"
+        gl_libobjs="$gl_libobjs lib/$i.$ac_objext"
+        gl_ltlibobjs="$gl_ltlibobjs lib/$i.lo"
+        i_dir=`echo "$i" | sed -e "$sed_dirname1" -e "$sed_dirname2" -e "$sed_dirname3" -e "$sed_dirname4"`
+        i_base=`echo "$i" | sed -e "$sed_basename1"`
+        gl_libobjdeps="$gl_libobjdeps lib/$i_dir/\$(DEPDIR)/$i_base.Po"
       done
     fi
     AC_SUBST(gl_LIBOBJS, $gl_libobjs)
     AC_SUBST(gl_LTLIBOBJS, $gl_ltlibobjs)
+    AC_SUBST(gl_LIBOBJDEPS, $gl_libobjdeps)
   )
   gltests_libdeps=
   gltests_ltlibdeps=
@@ -251,8 +346,11 @@
   m4_pushdef(AC_LIBSOURCES, m4_defn(gltests_LIBSOURCES))
   m4_pushdef(gltests_LIBSOURCES_LIST, )
   m4_pushdef(gltests_LIBSOURCES_DIR, )
+  m4_pushdef(GL_MACRO_PREFIX, gltests)
+  m4_pushdef(GL_MODULE_INDICATOR_PREFIX, GL)
   gl_COMMON
   gl_source_base='tests'
+  gl_source_base_prefix=
 changequote(,)dnl
   gltests_WITNESS=IN_`echo "${PACKAGE-$PACKAGE_TARNAME}" | LC_ALL=C tr abcdefghijklmnopqrstuvwxyz ABCDEFGHIJKLMNOPQRSTUVWXYZ | LC_ALL=C sed -e 's/^A-Z0-9_/_/g'`_GNULIB_TESTS
 changequote(, )dnl
@@ -271,6 +369,8 @@
       m4_if(m4_sysval, 0, ,
         AC_FATAL(expected source file, required through AC_LIBSOURCES, not found))
   )
+  m4_popdef(GL_MODULE_INDICATOR_PREFIX)
+  m4_popdef(GL_MACRO_PREFIX)
   m4_popdef(gltests_LIBSOURCES_DIR)
   m4_popdef(gltests_LIBSOURCES_LIST)
   m4_popdef(AC_LIBSOURCES)
@@ -279,17 +379,30 @@
   AC_CONFIG_COMMANDS_PRE(
     gltests_libobjs=
     gltests_ltlibobjs=
+    gltests_libobjdeps=
     if test -n "$gltests_LIBOBJS"; then
       # Remove the extension.
+changequote(,)dnl
       sed_drop_objext='s/\.o$//;s/\.obj$//'
+      sed_dirname1='s,//*,/,g'
+      sed_dirname2='s,$.$/$,\1,'
+      sed_dirname3='s,^^/*$,.,'
+      sed_dirname4='s,$.$/^/*$,\1,'
+      sed_basename1='s,.*/,,'
+changequote(, )dnl
       for i in `for i in $gltests_LIBOBJS; do echo "$i"; done | sed -e "$sed_drop_objext" | sort | uniq`; do
-        gltests_libobjs="$gltests_libobjs $i.$ac_objext"
-        gltests_ltlibobjs="$gltests_ltlibobjs $i.lo"
+        gltests_libobjs="$gltests_libobjs lib/$i.$ac_objext"
+        gltests_ltlibobjs="$gltests_ltlibobjs lib/$i.lo"
+        i_dir=`echo "$i" | sed -e "$sed_dirname1" -e "$sed_dirname2" -e "$sed_dirname3" -e "$sed_dirname4"`
+        i_base=`echo "$i" | sed -e "$sed_basename1"`
+        gltests_libobjdeps="$gltests_libobjdeps lib/$i_dir/\$(DEPDIR)/$i_base.Po"
       done
     fi
     AC_SUBST(gltests_LIBOBJS, $gltests_libobjs)
     AC_SUBST(gltests_LTLIBOBJS, $gltests_ltlibobjs)
+    AC_SUBST(gltests_LIBOBJDEPS, $gltests_libobjdeps)
   )
+  AC_REQUIRE(gl_CC_GNULIB_WARNINGS)
   LIBGNU_LIBDEPS="$gl_libdeps"
   AC_SUBST(LIBGNU_LIBDEPS)
   LIBGNU_LTLIBDEPS="$gl_ltlibdeps"
@@ -355,10 +468,12 @@
 AC_DEFUN(gl_FILE_LIST, 
   build-aux/config.rpath
   build-aux/git-version-gen
-  build-aux/prefix-gnulib-mk
+  lib/_Noreturn.h
   lib/alloca.in.h
   lib/arg-nonnull.h
   lib/asnprintf.c
+  lib/assert.in.h
+  lib/attribute.h
   lib/c++defs.h
   lib/errno.in.h
   lib/float+.h
@@ -366,10 +481,12 @@
   lib/float.in.h
   lib/fprintf.c
   lib/fpucw.h
+  lib/free.c
   lib/frexp.c
   lib/frexpl.c
   lib/fseterr.c
   lib/fseterr.h
+  lib/inttypes.in.h
   lib/isnan.c
   lib/isnand-nolibm.h
   lib/isnand.c
@@ -398,17 +515,26 @@
   lib/signbitl.c
   lib/size_max.h
   lib/snprintf.c
+  lib/stdbool.in.h
   lib/stddef.in.h
   lib/stdint.in.h
   lib/stdio-impl.h
+  lib/stdio-read.c
+  lib/stdio-write.c
   lib/stdio.in.h
+  lib/stdlib.in.h
   lib/streq.h
   lib/string.in.h
   lib/sys_types.in.h
+  lib/unictype/bitmap.h
+  lib/unistd.c
+  lib/unistd.in.h
   lib/unitypes.in.h
   lib/uniwidth.in.h
   lib/uniwidth/cjk.h
   lib/uniwidth/width.c
+  lib/uniwidth/width0.h
+  lib/uniwidth/width2.h
   lib/vasnprintf.c
   lib/vasnprintf.h
   lib/verify.h
@@ -423,7 +549,7 @@
   m4/00gnulib.m4
   m4/absolute-header.m4
   m4/alloca.m4
-  m4/asm-underscore.m4
+  m4/assert_h.m4
   m4/codeset.m4
   m4/errno_h.m4
   m4/exponentd.m4
@@ -434,6 +560,7 @@
   m4/float_h.m4
   m4/fpieee.m4
   m4/fprintf-posix.m4
+  m4/free.m4
   m4/frexp.m4
   m4/frexpl.m4
   m4/fseterr.m4
@@ -441,6 +568,7 @@
   m4/host-cpu-c-abi.m4
   m4/include_next.m4
   m4/intmax_t.m4
+  m4/inttypes.m4
   m4/inttypes_h.m4
   m4/isnand.m4
   m4/isnanf.m4
@@ -452,14 +580,13 @@
   m4/libunistring-base.m4
   m4/limits-h.m4
   m4/localcharset.m4
-  m4/longlong.m4
   m4/math_h.m4
   m4/memchr.m4
   m4/mmap-anon.m4
   m4/multiarch.m4
   m4/nocrash.m4
-  m4/non-recursive-gnulib-prefix-hack.m4
   m4/off_t.m4
+  m4/pid_t.m4
   m4/printf-frexp.m4
   m4/printf-frexpl.m4
   m4/printf.m4
@@ -467,12 +594,15 @@
   m4/size_max.m4
   m4/snprintf.m4
   m4/ssize_t.m4
+  m4/stdbool.m4
   m4/stddef_h.m4
   m4/stdint.m4
   m4/stdint_h.m4
   m4/stdio_h.m4
+  m4/stdlib_h.m4
   m4/string_h.m4
   m4/sys_types_h.m4
+  m4/unistd_h.m4
   m4/vasnprintf.m4
   m4/vsnprintf.m4
   m4/warn-on-use.m4
@@ -482,4 +612,5 @@
   m4/wcwidth.m4
   m4/wint_t.m4
   m4/xsize.m4
+  m4/zzgnulib.m4
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/include_next.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/include_next.m4 Changed

@@ -1,5 +1,5 @@
-# include_next.m4 serial 24
-dnl Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# include_next.m4 serial 26
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -106,19 +106,21 @@
   AC_SUBST(INCLUDE_NEXT)
   AC_SUBST(INCLUDE_NEXT_AS_FIRST_DIRECTIVE)
   AC_SUBST(PRAGMA_SYSTEM_HEADER)
-  AC_CACHE_CHECK(whether system header files limit the line length,
-    gl_cv_pragma_columns,
-    dnl HP NonStop systems, which define __TANDEM, have this misfeature.
-     AC_EGREP_CPP(choke me,
+
+  dnl HP NonStop systems, which define __TANDEM, limit the line length
+  dnl after including some system header files.
+  AC_CACHE_CHECK(whether source code line length is unlimited,
+    gl_cv_source_line_length_unlimited,
+    AC_EGREP_CPP(choke me,
        
 #ifdef __TANDEM
 choke me
 #endif
        ,
-       gl_cv_pragma_columns=yes,
-       gl_cv_pragma_columns=no)
+       gl_cv_source_line_length_unlimited=no,
+       gl_cv_source_line_length_unlimited=yes)
     )
-  if test $gl_cv_pragma_columns = yes; then
+  if test $gl_cv_source_line_length_unlimited = no; then
     PRAGMA_COLUMNS="#pragma COLUMNS 10000"
   else
     PRAGMA_COLUMNS=
@@ -176,42 +178,40 @@
     AC_CHECK_HEADERS_ONCE($1)
     )
 
-dnl FIXME: gl_next_header and gl_header_exists must be used unquoted
-dnl until we can assume autoconf 2.64 or newer.
   m4_foreach_w(gl_HEADER_NAME, $1,
     AS_VAR_PUSHDEF(gl_next_header,
                     gl_cv_next_m4_defn(gl_HEADER_NAME))
      if test $gl_cv_have_include_next = yes; then
-       AS_VAR_SET(gl_next_header, '<'gl_HEADER_NAME'>')
+       AS_VAR_SET(gl_next_header, '<'gl_HEADER_NAME'>')
      else
        AC_CACHE_CHECK(
          absolute name of <m4_defn(gl_HEADER_NAME)>,
-         m4_defn(gl_next_header),
+         gl_next_header,
          m4_if($2, check,
             AS_VAR_PUSHDEF(gl_header_exists,
                             ac_cv_header_m4_defn(gl_HEADER_NAME))
-             if test AS_VAR_GET(gl_header_exists) = yes; then
+             if test AS_VAR_GET(gl_header_exists) = yes; then
              AS_VAR_POPDEF(gl_header_exists)
             )
-           gl_ABSOLUTE_HEADER_ONE(gl_HEADER_NAME)
-           AS_VAR_COPY(gl_header, gl_cv_absolute_AS_TR_SH(gl_HEADER_NAME))
-           AS_VAR_SET(gl_next_header, '"'$gl_header'"')
+          gl_ABSOLUTE_HEADER_ONE(gl_HEADER_NAME)
+          AS_VAR_COPY(gl_header, gl_cv_absolute_AS_TR_SH(gl_HEADER_NAME))
+          AS_VAR_SET(gl_next_header, '"'$gl_header'"')
           m4_if($2, check,
             else
-               AS_VAR_SET(gl_next_header, '<'gl_HEADER_NAME'>')
+               AS_VAR_SET(gl_next_header, '<'gl_HEADER_NAME'>')
              fi
             )
          )
      fi
      AC_SUBST(
        AS_TR_CPP(NEXT_m4_defn(gl_HEADER_NAME)),
-       AS_VAR_GET(gl_next_header))
+       AS_VAR_GET(gl_next_header))
      if test $gl_cv_have_include_next = yes || test $gl_cv_have_include_next = buggy; then
        # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include_next'
        gl_next_as_first_directive='<'gl_HEADER_NAME'>'
      else
        # INCLUDE_NEXT_AS_FIRST_DIRECTIVE='include'
-       gl_next_as_first_directive=AS_VAR_GET(gl_next_header)
+       gl_next_as_first_directive=AS_VAR_GET(gl_next_header)
      fi
      AC_SUBST(
        AS_TR_CPP(NEXT_AS_FIRST_DIRECTIVE_m4_defn(gl_HEADER_NAME)),

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/intmax_t.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/intmax_t.m4 Changed

@@ -1,5 +1,5 @@
-# intmax_t.m4 serial 8
-dnl Copyright (C) 1997-2004, 2006-2007, 2009-2018 Free Software Foundation,
+# intmax_t.m4 serial 9
+dnl Copyright (C) 1997-2004, 2006-2007, 2009-2023 Free Software Foundation,
 dnl Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
@@ -19,11 +19,7 @@
   AC_REQUIRE(gl_AC_HEADER_INTTYPES_H)
   AC_REQUIRE(gl_AC_HEADER_STDINT_H)
   if test $gl_cv_header_inttypes_h = no && test $gl_cv_header_stdint_h = no; then
-    AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
-    test $ac_cv_type_long_long_int = yes \
-      && ac_type='long long' \
-      || ac_type='long'
-    AC_DEFINE_UNQUOTED(intmax_t, $ac_type,
+    AC_DEFINE_UNQUOTED(intmax_t, long long,
      Define to long or long long if <inttypes.h> and <stdint.h> don't define.)
   else
     AC_DEFINE(HAVE_INTMAX_T, 1,
@@ -57,11 +53,7 @@
     AC_DEFINE(HAVE_INTMAX_T, 1,
       Define if you have the 'intmax_t' type in <stdint.h> or <inttypes.h>.)
   else
-    AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
-    test $ac_cv_type_long_long_int = yes \
-      && ac_type='long long' \
-      || ac_type='long'
-    AC_DEFINE_UNQUOTED(intmax_t, $ac_type,
+    AC_DEFINE_UNQUOTED(intmax_t, long long,
      Define to long or long long if <stdint.h> and <inttypes.h> don't define.)
   fi
 )

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/inttypes.m4 Added

@@ -0,0 +1,184 @@
+# inttypes.m4 serial 37
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+dnl From Derek Price, Bruno Haible.
+dnl Test whether <inttypes.h> is supported or must be substituted.
+
+AC_DEFUN_ONCE(gl_INTTYPES_H,
+
+  AC_REQUIRE(gl_INTTYPES_INCOMPLETE)
+  gl_INTTYPES_PRI_SCN
+)
+
+AC_DEFUN_ONCE(gl_INTTYPES_INCOMPLETE,
+
+  AC_REQUIRE(gl_STDINT_H)
+  AC_CHECK_HEADERS_ONCE(inttypes.h)
+
+  dnl Override <inttypes.h> always, so that the portability warnings work.
+  AC_REQUIRE(gl_INTTYPES_H_DEFAULTS)
+  gl_CHECK_NEXT_HEADERS(inttypes.h)
+
+  AC_REQUIRE(gl_MULTIARCH)
+
+  dnl Check for declarations of anything we want to poison if the
+  dnl corresponding gnulib module is not in use.
+  gl_WARN_ON_USE_PREPARE(#include <inttypes.h>
+    , imaxabs imaxdiv strtoimax strtoumax)
+
+  AC_REQUIRE(AC_C_RESTRICT)
+)
+
+# Ensure that the PRI* and SCN* macros are defined appropriately.
+AC_DEFUN(gl_INTTYPES_PRI_SCN,
+
+  PRIPTR_PREFIX=
+  if $GL_GENERATE_STDINT_H; then
+    dnl Using the gnulib <stdint.h>. It defines intptr_t to 'long' or
+    dnl 'long long', depending on _WIN64.
+    AC_COMPILE_IFELSE(
+      AC_LANG_PROGRAM(
+         #ifdef _WIN64
+         LLP64
+         #endif
+         )
+      ,
+      PRIPTR_PREFIX='"l"',
+      PRIPTR_PREFIX='"ll"')
+  else
+    dnl Using the system's <stdint.h>.
+    for glpfx in '' l ll I64; do
+      case $glpfx in
+        '')  gltype1='int';;
+        l)   gltype1='long int';;
+        ll)  gltype1='long long int';;
+        I64) gltype1='__int64';;
+      esac
+      AC_COMPILE_IFELSE(
+        AC_LANG_PROGRAM(#include <stdint.h>
+           extern intptr_t foo;
+           extern $gltype1 foo;),
+        PRIPTR_PREFIX='"'$glpfx'"')
+      test -n "$PRIPTR_PREFIX" && break
+    done
+  fi
+  AC_SUBST(PRIPTR_PREFIX)
+
+  gl_INTTYPES_CHECK_LONG_LONG_INT_CONDITION(
+    INT32_MAX_LT_INTMAX_MAX,
+    defined INT32_MAX && defined INTMAX_MAX,
+    INT32_MAX < INTMAX_MAX,
+    sizeof (int) < sizeof (long long int))
+  if test $APPLE_UNIVERSAL_BUILD = 0; then
+    gl_INTTYPES_CHECK_LONG_LONG_INT_CONDITION(
+      INT64_MAX_EQ_LONG_MAX,
+      defined INT64_MAX,
+      INT64_MAX == LONG_MAX,
+      sizeof (long long int) == sizeof (long int))
+  else
+    INT64_MAX_EQ_LONG_MAX=-1
+  fi
+  gl_INTTYPES_CHECK_LONG_LONG_INT_CONDITION(
+    UINT32_MAX_LT_UINTMAX_MAX,
+    defined UINT32_MAX && defined UINTMAX_MAX,
+    UINT32_MAX < UINTMAX_MAX,
+    sizeof (unsigned int) < sizeof (unsigned long long int))
+  if test $APPLE_UNIVERSAL_BUILD = 0; then
+    gl_INTTYPES_CHECK_LONG_LONG_INT_CONDITION(
+      UINT64_MAX_EQ_ULONG_MAX,
+      defined UINT64_MAX,
+      UINT64_MAX == ULONG_MAX,
+      sizeof (unsigned long long int) == sizeof (unsigned long int))
+  else
+    UINT64_MAX_EQ_ULONG_MAX=-1
+  fi
+)
+
+# Define the symbol $1 to be 1 if the condition is true, 0 otherwise.
+# If $2 is true, the condition is $3; otherwise if long long int is supported
+# approximate the condition with $4; otherwise, assume the condition is false.
+# The condition should work on all C99 platforms; the approximations should be
+# good enough to work on all practical pre-C99 platforms.
+# $2 is evaluated by the C preprocessor, $3 and $4 as compile-time constants.
+AC_DEFUN(gl_INTTYPES_CHECK_LONG_LONG_INT_CONDITION,
+
+  AC_CACHE_CHECK(whether $3,
+    gl_cv_test_$1,
+    AC_COMPILE_IFELSE(
+       AC_LANG_PROGRAM(
+          /* Work also in C++ mode.  */
+            #define __STDC_LIMIT_MACROS 1
+
+            /* Work if build is not clean.  */
+            #define _GL_JUST_INCLUDE_SYSTEM_STDINT_H
+
+            #include <limits.h>
+            #if HAVE_STDINT_H
+             #include <stdint.h>
+            #endif
+
+            #if $2
+             #define CONDITION ($3)
+            #else
+             #define CONDITION ($4)
+            #endif
+            int testCONDITION ? 1 : -1;),
+       gl_cv_test_$1=yes,
+       gl_cv_test_$1=no))
+  if test $gl_cv_test_$1 = yes; then
+    $1=1;
+  else
+    $1=0;
+  fi
+  AC_SUBST($1)
+)
+
+# gl_INTTYPES_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
+AC_DEFUN(gl_INTTYPES_MODULE_INDICATOR,
+
+  dnl Ensure to expand the default settings once only.
+  gl_INTTYPES_H_REQUIRE_DEFAULTS
+  gl_MODULE_INDICATOR_SET_VARIABLE($1)
+)
+
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_INTTYPES_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_INTTYPES_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_IMAXABS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_IMAXDIV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOIMAX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOUMAX)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_INTTYPES_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_INTTYPES_H_DEFAULTS)
+)
+
+AC_DEFUN(gl_INTTYPES_H_DEFAULTS,
+
+  dnl Assume proper GNU behavior unless another module says otherwise.
+  HAVE_DECL_IMAXABS=1;   AC_SUBST(HAVE_DECL_IMAXABS)
+  HAVE_DECL_IMAXDIV=1;   AC_SUBST(HAVE_DECL_IMAXDIV)
+  HAVE_DECL_STRTOIMAX=1; AC_SUBST(HAVE_DECL_STRTOIMAX)
+  HAVE_DECL_STRTOUMAX=1; AC_SUBST(HAVE_DECL_STRTOUMAX)
+  HAVE_IMAXDIV_T=1;      AC_SUBST(HAVE_IMAXDIV_T)
+  HAVE_IMAXABS=1;        AC_SUBST(HAVE_IMAXABS)
+  HAVE_IMAXDIV=1;        AC_SUBST(HAVE_IMAXDIV)
+  REPLACE_IMAXABS=0;     AC_SUBST(REPLACE_IMAXABS)
+  REPLACE_IMAXDIV=0;     AC_SUBST(REPLACE_IMAXDIV)
+  REPLACE_STRTOIMAX=0;   AC_SUBST(REPLACE_STRTOIMAX)
+  REPLACE_STRTOUMAX=0;   AC_SUBST(REPLACE_STRTOUMAX)
+  INT32_MAX_LT_INTMAX_MAX=1;  AC_SUBST(INT32_MAX_LT_INTMAX_MAX)
+  INT64_MAX_EQ_LONG_MAX='defined _LP64';  AC_SUBST(INT64_MAX_EQ_LONG_MAX)
+  PRIPTR_PREFIX=__PRIPTR_PREFIX;  AC_SUBST(PRIPTR_PREFIX)
+  UINT32_MAX_LT_UINTMAX_MAX=1;  AC_SUBST(UINT32_MAX_LT_UINTMAX_MAX)
+  UINT64_MAX_EQ_ULONG_MAX='defined _LP64';  AC_SUBST(UINT64_MAX_EQ_ULONG_MAX)
+)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/inttypes_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/inttypes_h.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/isnand.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/isnand.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/isnanf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/isnanf.m4 Changed

@@ -1,5 +1,5 @@
-# isnanf.m4 serial 15
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# isnanf.m4 serial 18
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -74,9 +74,9 @@
       AC_LINK_IFELSE(
         AC_LANG_PROGRAM(
            #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanf
-             # define isnanf(x) __builtin_isnanf ((float)(x))
+             # define isnanf(x) __builtin_isnan ((float)(x))
              #elif defined isnan
              # undef isnanf
              # define isnanf(x) isnan ((float)(x))
@@ -99,9 +99,9 @@
       AC_LINK_IFELSE(
         AC_LANG_PROGRAM(
            #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanf
-             # define isnanf(x) __builtin_isnanf ((float)(x))
+             # define isnanf(x) __builtin_isnan ((float)(x))
              #elif defined isnan
              # undef isnanf
              # define isnanf(x) isnan ((float)(x))
@@ -127,9 +127,9 @@
       AC_RUN_IFELSE(
         AC_LANG_SOURCE(
 #include <math.h>
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # undef isnanf
-# define isnanf(x) __builtin_isnanf ((float)(x))
+# define isnanf(x) __builtin_isnan ((float)(x))
 #elif defined isnan
 # undef isnanf
 # define isnanf(x) isnan ((float)(x))
@@ -169,7 +169,7 @@
       m.value = NaN ();
       /* Set the bits below the exponent to 01111...111.  */
       m.word0 &= -1U << FLT_EXPBIT0_BIT;
-      m.word0 |= 1U << (FLT_EXPBIT0_BIT - 1) - 1;
+      m.word0 |= (1U << (FLT_EXPBIT0_BIT - 1)) - 1;
       if (!isnanf (m.value))
         result |= 4;
     }

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/isnanl.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/isnanl.m4 Changed

@@ -1,5 +1,5 @@
-# isnanl.m4 serial 20
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# isnanl.m4 serial 22
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -68,9 +68,9 @@
       AC_LINK_IFELSE(
         AC_LANG_PROGRAM(
            #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanl
-             # define isnanl(x) __builtin_isnanl ((long double)(x))
+             # define isnanl(x) __builtin_isnan ((long double)(x))
              #elif defined isnan
              # undef isnanl
              # define isnanl(x) isnan ((long double)(x))
@@ -93,9 +93,9 @@
       AC_LINK_IFELSE(
         AC_LANG_PROGRAM(
            #include <math.h>
-             #if __GNUC__ >= 4
+             #if (__GNUC__ >= 4) || (__clang_major__ >= 4)
              # undef isnanl
-             # define isnanl(x) __builtin_isnanl ((long double)(x))
+             # define isnanl(x) __builtin_isnan ((long double)(x))
              #elif defined isnan
              # undef isnanl
              # define isnanl(x) isnan ((long double)(x))
@@ -123,9 +123,9 @@
 #include <float.h>
 #include <limits.h>
 #include <math.h>
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # undef isnanl
-# define isnanl(x) __builtin_isnanl ((long double)(x))
+# define isnanl(x) __builtin_isnan ((long double)(x))
 #elif defined isnan
 # undef isnanl
 # define isnanl(x) isnan ((long double)(x))

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/ldexpl.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/ldexpl.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/libunistring-base.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/libunistring-base.m4 Changed

@@ -1,5 +1,5 @@
-# libunistring-base.m4 serial 5
-dnl Copyright (C) 2010-2018 Free Software Foundation, Inc.
+# libunistring-base.m4 serial 7
+dnl Copyright (C) 2010-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -24,7 +24,7 @@
   AC_REQUIRE(gl_LIBUNISTRING_LIB_PREPARE)
   dnl Use the variables HAVE_LIBUNISTRING, LIBUNISTRING_VERSION from
   dnl gl_LIBUNISTRING_CORE if that macro has been run.
-  AM_CONDITIONAL(AS_TR_CPP(LIBUNISTRING_COMPILE_$2),
+  gl_CONDITIONAL(AS_TR_CPP(LIBUNISTRING_COMPILE_$2),
     gl_LIBUNISTRING_VERSION_CMP($1))
 )
 
@@ -51,7 +51,11 @@
   dnl Use the variables HAVE_LIBUNISTRING, LIBUNISTRING_VERSION from
   dnl gl_LIBUNISTRING_CORE if that macro has been run.
   if gl_LIBUNISTRING_VERSION_CMP($1); then
-    LIBUNISTRING_AS_TR_CPP($2)='$2'
+    dnl It is OK to use a .h file in lib/ from within tests/, but not vice
+    dnl versa.
+    if test -z "$LIBUNISTRING_AS_TR_CPP($2)"; then
+      LIBUNISTRING_AS_TR_CPP($2)="${gl_source_base_prefix}$2"
+    fi
   else
     LIBUNISTRING_AS_TR_CPP($2)=
   fi

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/limits-h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/limits-h.m4 Changed

@@ -1,6 +1,6 @@
 dnl Check whether limits.h has needed features.
 
-dnl Copyright 2016-2018 Free Software Foundation, Inc.
+dnl Copyright 2016-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -11,7 +11,7 @@
 
   gl_CHECK_NEXT_HEADERS(limits.h)
 
-  AC_CACHE_CHECK(whether limits.h has LLONG_MAX, WORD_BIT, ULLONG_WIDTH etc.,
+  AC_CACHE_CHECK(whether limits.h has WORD_BIT, BOOL_WIDTH etc.,
     gl_cv_header_limits_width,
     AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
@@ -22,22 +22,20 @@
             long long llm = LLONG_MAX;
             int wb = WORD_BIT;
             int ullw = ULLONG_WIDTH;
+            int bw = BOOL_WIDTH;
           ),
        gl_cv_header_limits_width=yes,
        gl_cv_header_limits_width=no))
   if test "$gl_cv_header_limits_width" = yes; then
-    LIMITS_H=
+    GL_GENERATE_LIMITS_H=false
   else
-    LIMITS_H=limits.h
+    GL_GENERATE_LIMITS_H=true
   fi
-  AC_SUBST(LIMITS_H)
-  AM_CONDITIONAL(GL_GENERATE_LIMITS_H, test -n "$LIMITS_H")
 )
 
 dnl Unconditionally enables the replacement of <limits.h>.
 AC_DEFUN(gl_REPLACE_LIMITS_H,
 
   AC_REQUIRE(gl_LIMITS_H)
-  LIMITS_H='limits.h'
-  AM_CONDITIONAL(GL_GENERATE_LIMITS_H, test -n "$LIMITS_H")
+  GL_GENERATE_LIMITS_H=true
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/math_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/math_h.m4 Changed

@@ -1,16 +1,16 @@
-# math_h.m4 serial 116
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# math_h.m4 serial 125
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
-AC_DEFUN(gl_MATH_H,
+AC_DEFUN_ONCE(gl_MATH_H,
 
   AC_REQUIRE(gl_MATH_H_DEFAULTS)
   gl_CHECK_NEXT_HEADERS(math.h)
 
   AC_CACHE_CHECK(whether NAN macro works, gl_cv_header_math_nan_works,
-    AC_COMPILE_IFELSE(AC_LANG_PROGRAM(@%:@include <math.h>,
+    AC_COMPILE_IFELSE(AC_LANG_PROGRAM(#include <math.h>,
       /* Solaris 10 has a broken definition of NAN.  Other platforms
         fail to provide NAN, or provide it only in C99 mode; this
         test only needs to fail when NAN is provided but wrong.  */
@@ -25,7 +25,7 @@
     REPLACE_NAN=1
   fi
   AC_CACHE_CHECK(whether HUGE_VAL works, gl_cv_header_math_huge_val_works,
-    AC_COMPILE_IFELSE(AC_LANG_PROGRAM(@%:@include <math.h>,
+    AC_COMPILE_IFELSE(AC_LANG_PROGRAM(#include <math.h>,
       /* Solaris 10 has a broken definition of HUGE_VAL.  */
          double d = HUGE_VAL;
          return d == 0;),
@@ -53,285 +53,310 @@
      tanf tanl tanhf trunc truncf truncl)
 )
 
+# gl_MATH_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_MATH_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_MATH_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_MATH_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
   dnl Define it also as a C macro, for the benefit of the unit tests.
   gl_MODULE_INDICATOR_FOR_TESTS($1)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_MATH_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_MATH_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ACOSF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ACOSL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ASINF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ASINL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ATANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ATANL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ATAN2F)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CBRT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CBRTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CBRTL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CEIL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CEILF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CEILL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COPYSIGN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COPYSIGNF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COPYSIGNL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COSF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COSL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COSHF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXP2)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXP2F)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXP2L)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPM1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPM1F)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPM1L)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FABSF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FABSL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FLOOR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FLOORF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FLOORL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMA)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMAF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMAL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMOD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMODF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FMODL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREXPF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREXP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREXPL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_HYPOT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_HYPOTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_HYPOTL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ILOGB)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ILOGBF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ILOGBL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISFINITE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISINF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISNAN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISNANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISNAND)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISNANL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LDEXPF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LDEXPL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOGF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOGL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG10)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG10F)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG10L)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG1P)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG1PF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG1PL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG2)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG2F)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOG2L)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOGB)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOGBF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LOGBL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MODF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MODFF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MODFL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_POWF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REMAINDER)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REMAINDERF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REMAINDERL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RINT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RINTL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ROUND)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ROUNDF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ROUNDL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SIGNBIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SINF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SINL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SINHF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SQRTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SQRTL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TANL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TANHF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TRUNC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TRUNCF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TRUNCL)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_J0, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_J1, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_JN, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_Y0, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_Y1, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_YN, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_MATH_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_MATH_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_MATH_H_DEFAULTS,
 
-  GNULIB_ACOSF=0;      AC_SUBST(GNULIB_ACOSF)
-  GNULIB_ACOSL=0;      AC_SUBST(GNULIB_ACOSL)
-  GNULIB_ASINF=0;      AC_SUBST(GNULIB_ASINF)
-  GNULIB_ASINL=0;      AC_SUBST(GNULIB_ASINL)
-  GNULIB_ATANF=0;      AC_SUBST(GNULIB_ATANF)
-  GNULIB_ATANL=0;      AC_SUBST(GNULIB_ATANL)
-  GNULIB_ATAN2F=0;     AC_SUBST(GNULIB_ATAN2F)
-  GNULIB_CBRT=0;       AC_SUBST(GNULIB_CBRT)
-  GNULIB_CBRTF=0;      AC_SUBST(GNULIB_CBRTF)
-  GNULIB_CBRTL=0;      AC_SUBST(GNULIB_CBRTL)
-  GNULIB_CEIL=0;       AC_SUBST(GNULIB_CEIL)
-  GNULIB_CEILF=0;      AC_SUBST(GNULIB_CEILF)
-  GNULIB_CEILL=0;      AC_SUBST(GNULIB_CEILL)
-  GNULIB_COPYSIGN=0;   AC_SUBST(GNULIB_COPYSIGN)
-  GNULIB_COPYSIGNF=0;  AC_SUBST(GNULIB_COPYSIGNF)
-  GNULIB_COPYSIGNL=0;  AC_SUBST(GNULIB_COPYSIGNL)
-  GNULIB_COSF=0;       AC_SUBST(GNULIB_COSF)
-  GNULIB_COSL=0;       AC_SUBST(GNULIB_COSL)
-  GNULIB_COSHF=0;      AC_SUBST(GNULIB_COSHF)
-  GNULIB_EXPF=0;       AC_SUBST(GNULIB_EXPF)
-  GNULIB_EXPL=0;       AC_SUBST(GNULIB_EXPL)
-  GNULIB_EXP2=0;       AC_SUBST(GNULIB_EXP2)
-  GNULIB_EXP2F=0;      AC_SUBST(GNULIB_EXP2F)
-  GNULIB_EXP2L=0;      AC_SUBST(GNULIB_EXP2L)
-  GNULIB_EXPM1=0;      AC_SUBST(GNULIB_EXPM1)
-  GNULIB_EXPM1F=0;     AC_SUBST(GNULIB_EXPM1F)
-  GNULIB_EXPM1L=0;     AC_SUBST(GNULIB_EXPM1L)
-  GNULIB_FABSF=0;      AC_SUBST(GNULIB_FABSF)
-  GNULIB_FABSL=0;      AC_SUBST(GNULIB_FABSL)
-  GNULIB_FLOOR=0;      AC_SUBST(GNULIB_FLOOR)
-  GNULIB_FLOORF=0;     AC_SUBST(GNULIB_FLOORF)
-  GNULIB_FLOORL=0;     AC_SUBST(GNULIB_FLOORL)
-  GNULIB_FMA=0;        AC_SUBST(GNULIB_FMA)
-  GNULIB_FMAF=0;       AC_SUBST(GNULIB_FMAF)
-  GNULIB_FMAL=0;       AC_SUBST(GNULIB_FMAL)
-  GNULIB_FMOD=0;       AC_SUBST(GNULIB_FMOD)
-  GNULIB_FMODF=0;      AC_SUBST(GNULIB_FMODF)
-  GNULIB_FMODL=0;      AC_SUBST(GNULIB_FMODL)
-  GNULIB_FREXPF=0;     AC_SUBST(GNULIB_FREXPF)
-  GNULIB_FREXP=0;      AC_SUBST(GNULIB_FREXP)
-  GNULIB_FREXPL=0;     AC_SUBST(GNULIB_FREXPL)
-  GNULIB_HYPOT=0;      AC_SUBST(GNULIB_HYPOT)
-  GNULIB_HYPOTF=0;     AC_SUBST(GNULIB_HYPOTF)
-  GNULIB_HYPOTL=0;     AC_SUBST(GNULIB_HYPOTL)
-  GNULIB_ILOGB=0;      AC_SUBST(GNULIB_ILOGB)
-  GNULIB_ILOGBF=0;     AC_SUBST(GNULIB_ILOGBF)
-  GNULIB_ILOGBL=0;     AC_SUBST(GNULIB_ILOGBL)
-  GNULIB_ISFINITE=0;   AC_SUBST(GNULIB_ISFINITE)
-  GNULIB_ISINF=0;      AC_SUBST(GNULIB_ISINF)
-  GNULIB_ISNAN=0;      AC_SUBST(GNULIB_ISNAN)
-  GNULIB_ISNANF=0;     AC_SUBST(GNULIB_ISNANF)
-  GNULIB_ISNAND=0;     AC_SUBST(GNULIB_ISNAND)
-  GNULIB_ISNANL=0;     AC_SUBST(GNULIB_ISNANL)
-  GNULIB_LDEXPF=0;     AC_SUBST(GNULIB_LDEXPF)
-  GNULIB_LDEXPL=0;     AC_SUBST(GNULIB_LDEXPL)
-  GNULIB_LOG=0;        AC_SUBST(GNULIB_LOG)
-  GNULIB_LOGF=0;       AC_SUBST(GNULIB_LOGF)
-  GNULIB_LOGL=0;       AC_SUBST(GNULIB_LOGL)
-  GNULIB_LOG10=0;      AC_SUBST(GNULIB_LOG10)
-  GNULIB_LOG10F=0;     AC_SUBST(GNULIB_LOG10F)
-  GNULIB_LOG10L=0;     AC_SUBST(GNULIB_LOG10L)
-  GNULIB_LOG1P=0;      AC_SUBST(GNULIB_LOG1P)
-  GNULIB_LOG1PF=0;     AC_SUBST(GNULIB_LOG1PF)
-  GNULIB_LOG1PL=0;     AC_SUBST(GNULIB_LOG1PL)
-  GNULIB_LOG2=0;       AC_SUBST(GNULIB_LOG2)
-  GNULIB_LOG2F=0;      AC_SUBST(GNULIB_LOG2F)
-  GNULIB_LOG2L=0;      AC_SUBST(GNULIB_LOG2L)
-  GNULIB_LOGB=0;       AC_SUBST(GNULIB_LOGB)
-  GNULIB_LOGBF=0;      AC_SUBST(GNULIB_LOGBF)
-  GNULIB_LOGBL=0;      AC_SUBST(GNULIB_LOGBL)
-  GNULIB_MODF=0;       AC_SUBST(GNULIB_MODF)
-  GNULIB_MODFF=0;      AC_SUBST(GNULIB_MODFF)
-  GNULIB_MODFL=0;      AC_SUBST(GNULIB_MODFL)
-  GNULIB_POWF=0;       AC_SUBST(GNULIB_POWF)
-  GNULIB_REMAINDER=0;  AC_SUBST(GNULIB_REMAINDER)
-  GNULIB_REMAINDERF=0; AC_SUBST(GNULIB_REMAINDERF)
-  GNULIB_REMAINDERL=0; AC_SUBST(GNULIB_REMAINDERL)
-  GNULIB_RINT=0;       AC_SUBST(GNULIB_RINT)
-  GNULIB_RINTF=0;      AC_SUBST(GNULIB_RINTF)
-  GNULIB_RINTL=0;      AC_SUBST(GNULIB_RINTL)
-  GNULIB_ROUND=0;      AC_SUBST(GNULIB_ROUND)
-  GNULIB_ROUNDF=0;     AC_SUBST(GNULIB_ROUNDF)
-  GNULIB_ROUNDL=0;     AC_SUBST(GNULIB_ROUNDL)
-  GNULIB_SIGNBIT=0;    AC_SUBST(GNULIB_SIGNBIT)
-  GNULIB_SINF=0;       AC_SUBST(GNULIB_SINF)
-  GNULIB_SINL=0;       AC_SUBST(GNULIB_SINL)
-  GNULIB_SINHF=0;      AC_SUBST(GNULIB_SINHF)
-  GNULIB_SQRTF=0;      AC_SUBST(GNULIB_SQRTF)
-  GNULIB_SQRTL=0;      AC_SUBST(GNULIB_SQRTL)
-  GNULIB_TANF=0;       AC_SUBST(GNULIB_TANF)
-  GNULIB_TANL=0;       AC_SUBST(GNULIB_TANL)
-  GNULIB_TANHF=0;      AC_SUBST(GNULIB_TANHF)
-  GNULIB_TRUNC=0;      AC_SUBST(GNULIB_TRUNC)
-  GNULIB_TRUNCF=0;     AC_SUBST(GNULIB_TRUNCF)
-  GNULIB_TRUNCL=0;     AC_SUBST(GNULIB_TRUNCL)
   dnl Assume proper GNU behavior unless another module says otherwise.
-  HAVE_ACOSF=1;                AC_SUBST(HAVE_ACOSF)
-  HAVE_ACOSL=1;                AC_SUBST(HAVE_ACOSL)
-  HAVE_ASINF=1;                AC_SUBST(HAVE_ASINF)
-  HAVE_ASINL=1;                AC_SUBST(HAVE_ASINL)
-  HAVE_ATANF=1;                AC_SUBST(HAVE_ATANF)
-  HAVE_ATANL=1;                AC_SUBST(HAVE_ATANL)
-  HAVE_ATAN2F=1;               AC_SUBST(HAVE_ATAN2F)
-  HAVE_CBRT=1;                 AC_SUBST(HAVE_CBRT)
-  HAVE_CBRTF=1;                AC_SUBST(HAVE_CBRTF)
-  HAVE_CBRTL=1;                AC_SUBST(HAVE_CBRTL)
-  HAVE_COPYSIGN=1;             AC_SUBST(HAVE_COPYSIGN)
-  HAVE_COPYSIGNL=1;            AC_SUBST(HAVE_COPYSIGNL)
-  HAVE_COSF=1;                 AC_SUBST(HAVE_COSF)
-  HAVE_COSL=1;                 AC_SUBST(HAVE_COSL)
-  HAVE_COSHF=1;                AC_SUBST(HAVE_COSHF)
-  HAVE_EXPF=1;                 AC_SUBST(HAVE_EXPF)
-  HAVE_EXPL=1;                 AC_SUBST(HAVE_EXPL)
-  HAVE_EXPM1=1;                AC_SUBST(HAVE_EXPM1)
-  HAVE_EXPM1F=1;               AC_SUBST(HAVE_EXPM1F)
-  HAVE_FABSF=1;                AC_SUBST(HAVE_FABSF)
-  HAVE_FABSL=1;                AC_SUBST(HAVE_FABSL)
-  HAVE_FMA=1;                  AC_SUBST(HAVE_FMA)
-  HAVE_FMAF=1;                 AC_SUBST(HAVE_FMAF)
-  HAVE_FMAL=1;                 AC_SUBST(HAVE_FMAL)
-  HAVE_FMODF=1;                AC_SUBST(HAVE_FMODF)
-  HAVE_FMODL=1;                AC_SUBST(HAVE_FMODL)
-  HAVE_FREXPF=1;               AC_SUBST(HAVE_FREXPF)
-  HAVE_HYPOTF=1;               AC_SUBST(HAVE_HYPOTF)
-  HAVE_HYPOTL=1;               AC_SUBST(HAVE_HYPOTL)
-  HAVE_ILOGB=1;                AC_SUBST(HAVE_ILOGB)
-  HAVE_ILOGBF=1;               AC_SUBST(HAVE_ILOGBF)
-  HAVE_ILOGBL=1;               AC_SUBST(HAVE_ILOGBL)
-  HAVE_ISNANF=1;               AC_SUBST(HAVE_ISNANF)
-  HAVE_ISNAND=1;               AC_SUBST(HAVE_ISNAND)
-  HAVE_ISNANL=1;               AC_SUBST(HAVE_ISNANL)
-  HAVE_LDEXPF=1;               AC_SUBST(HAVE_LDEXPF)
-  HAVE_LOGF=1;                 AC_SUBST(HAVE_LOGF)
-  HAVE_LOGL=1;                 AC_SUBST(HAVE_LOGL)
-  HAVE_LOG10F=1;               AC_SUBST(HAVE_LOG10F)
-  HAVE_LOG10L=1;               AC_SUBST(HAVE_LOG10L)
-  HAVE_LOG1P=1;                AC_SUBST(HAVE_LOG1P)
-  HAVE_LOG1PF=1;               AC_SUBST(HAVE_LOG1PF)
-  HAVE_LOG1PL=1;               AC_SUBST(HAVE_LOG1PL)
-  HAVE_LOGBF=1;                AC_SUBST(HAVE_LOGBF)
-  HAVE_LOGBL=1;                AC_SUBST(HAVE_LOGBL)
-  HAVE_MODFF=1;                AC_SUBST(HAVE_MODFF)
-  HAVE_MODFL=1;                AC_SUBST(HAVE_MODFL)
-  HAVE_POWF=1;                 AC_SUBST(HAVE_POWF)
-  HAVE_REMAINDER=1;            AC_SUBST(HAVE_REMAINDER)
-  HAVE_REMAINDERF=1;           AC_SUBST(HAVE_REMAINDERF)
-  HAVE_RINT=1;                 AC_SUBST(HAVE_RINT)
-  HAVE_RINTL=1;                AC_SUBST(HAVE_RINTL)
-  HAVE_SINF=1;                 AC_SUBST(HAVE_SINF)
-  HAVE_SINL=1;                 AC_SUBST(HAVE_SINL)
-  HAVE_SINHF=1;                AC_SUBST(HAVE_SINHF)
-  HAVE_SQRTF=1;                AC_SUBST(HAVE_SQRTF)
-  HAVE_SQRTL=1;                AC_SUBST(HAVE_SQRTL)
-  HAVE_TANF=1;                 AC_SUBST(HAVE_TANF)
-  HAVE_TANL=1;                 AC_SUBST(HAVE_TANL)
-  HAVE_TANHF=1;                AC_SUBST(HAVE_TANHF)
-  HAVE_DECL_ACOSL=1;           AC_SUBST(HAVE_DECL_ACOSL)
-  HAVE_DECL_ASINL=1;           AC_SUBST(HAVE_DECL_ASINL)
-  HAVE_DECL_ATANL=1;           AC_SUBST(HAVE_DECL_ATANL)
-  HAVE_DECL_CBRTF=1;           AC_SUBST(HAVE_DECL_CBRTF)
-  HAVE_DECL_CBRTL=1;           AC_SUBST(HAVE_DECL_CBRTL)
-  HAVE_DECL_CEILF=1;           AC_SUBST(HAVE_DECL_CEILF)
-  HAVE_DECL_CEILL=1;           AC_SUBST(HAVE_DECL_CEILL)
-  HAVE_DECL_COPYSIGNF=1;       AC_SUBST(HAVE_DECL_COPYSIGNF)
-  HAVE_DECL_COSL=1;            AC_SUBST(HAVE_DECL_COSL)
-  HAVE_DECL_EXPL=1;            AC_SUBST(HAVE_DECL_EXPL)
-  HAVE_DECL_EXP2=1;            AC_SUBST(HAVE_DECL_EXP2)
-  HAVE_DECL_EXP2F=1;           AC_SUBST(HAVE_DECL_EXP2F)
-  HAVE_DECL_EXP2L=1;           AC_SUBST(HAVE_DECL_EXP2L)
-  HAVE_DECL_EXPM1L=1;          AC_SUBST(HAVE_DECL_EXPM1L)
-  HAVE_DECL_FLOORF=1;          AC_SUBST(HAVE_DECL_FLOORF)
-  HAVE_DECL_FLOORL=1;          AC_SUBST(HAVE_DECL_FLOORL)
-  HAVE_DECL_FREXPL=1;          AC_SUBST(HAVE_DECL_FREXPL)
-  HAVE_DECL_LDEXPL=1;          AC_SUBST(HAVE_DECL_LDEXPL)
-  HAVE_DECL_LOGL=1;            AC_SUBST(HAVE_DECL_LOGL)
-  HAVE_DECL_LOG10L=1;          AC_SUBST(HAVE_DECL_LOG10L)
-  HAVE_DECL_LOG2=1;            AC_SUBST(HAVE_DECL_LOG2)
-  HAVE_DECL_LOG2F=1;           AC_SUBST(HAVE_DECL_LOG2F)
-  HAVE_DECL_LOG2L=1;           AC_SUBST(HAVE_DECL_LOG2L)
-  HAVE_DECL_LOGB=1;            AC_SUBST(HAVE_DECL_LOGB)
-  HAVE_DECL_REMAINDER=1;       AC_SUBST(HAVE_DECL_REMAINDER)
-  HAVE_DECL_REMAINDERL=1;      AC_SUBST(HAVE_DECL_REMAINDERL)
-  HAVE_DECL_RINTF=1;           AC_SUBST(HAVE_DECL_RINTF)
-  HAVE_DECL_ROUND=1;           AC_SUBST(HAVE_DECL_ROUND)
-  HAVE_DECL_ROUNDF=1;          AC_SUBST(HAVE_DECL_ROUNDF)
-  HAVE_DECL_ROUNDL=1;          AC_SUBST(HAVE_DECL_ROUNDL)
-  HAVE_DECL_SINL=1;            AC_SUBST(HAVE_DECL_SINL)
-  HAVE_DECL_SQRTL=1;           AC_SUBST(HAVE_DECL_SQRTL)
-  HAVE_DECL_TANL=1;            AC_SUBST(HAVE_DECL_TANL)
-  HAVE_DECL_TRUNC=1;           AC_SUBST(HAVE_DECL_TRUNC)
-  HAVE_DECL_TRUNCF=1;          AC_SUBST(HAVE_DECL_TRUNCF)
-  HAVE_DECL_TRUNCL=1;          AC_SUBST(HAVE_DECL_TRUNCL)
-  REPLACE_ACOSF=0;             AC_SUBST(REPLACE_ACOSF)
-  REPLACE_ASINF=0;             AC_SUBST(REPLACE_ASINF)
-  REPLACE_ATANF=0;             AC_SUBST(REPLACE_ATANF)
-  REPLACE_ATAN2F=0;            AC_SUBST(REPLACE_ATAN2F)
-  REPLACE_CBRTF=0;             AC_SUBST(REPLACE_CBRTF)
-  REPLACE_CBRTL=0;             AC_SUBST(REPLACE_CBRTL)
-  REPLACE_CEIL=0;              AC_SUBST(REPLACE_CEIL)
-  REPLACE_CEILF=0;             AC_SUBST(REPLACE_CEILF)
-  REPLACE_CEILL=0;             AC_SUBST(REPLACE_CEILL)
-  REPLACE_COSF=0;              AC_SUBST(REPLACE_COSF)
-  REPLACE_COSHF=0;             AC_SUBST(REPLACE_COSHF)
-  REPLACE_EXPF=0;              AC_SUBST(REPLACE_EXPF)
-  REPLACE_EXPM1=0;             AC_SUBST(REPLACE_EXPM1)
-  REPLACE_EXPM1F=0;            AC_SUBST(REPLACE_EXPM1F)
-  REPLACE_EXP2=0;              AC_SUBST(REPLACE_EXP2)
-  REPLACE_EXP2L=0;             AC_SUBST(REPLACE_EXP2L)
-  REPLACE_FABSL=0;             AC_SUBST(REPLACE_FABSL)
-  REPLACE_FLOOR=0;             AC_SUBST(REPLACE_FLOOR)
-  REPLACE_FLOORF=0;            AC_SUBST(REPLACE_FLOORF)
-  REPLACE_FLOORL=0;            AC_SUBST(REPLACE_FLOORL)
-  REPLACE_FMA=0;               AC_SUBST(REPLACE_FMA)
-  REPLACE_FMAF=0;              AC_SUBST(REPLACE_FMAF)
-  REPLACE_FMAL=0;              AC_SUBST(REPLACE_FMAL)
-  REPLACE_FMOD=0;              AC_SUBST(REPLACE_FMOD)
-  REPLACE_FMODF=0;             AC_SUBST(REPLACE_FMODF)
-  REPLACE_FMODL=0;             AC_SUBST(REPLACE_FMODL)
-  REPLACE_FREXPF=0;            AC_SUBST(REPLACE_FREXPF)
-  REPLACE_FREXP=0;             AC_SUBST(REPLACE_FREXP)
-  REPLACE_FREXPL=0;            AC_SUBST(REPLACE_FREXPL)
-  REPLACE_HUGE_VAL=0;          AC_SUBST(REPLACE_HUGE_VAL)
-  REPLACE_HYPOT=0;             AC_SUBST(REPLACE_HYPOT)
-  REPLACE_HYPOTF=0;            AC_SUBST(REPLACE_HYPOTF)
-  REPLACE_HYPOTL=0;            AC_SUBST(REPLACE_HYPOTL)
-  REPLACE_ILOGB=0;             AC_SUBST(REPLACE_ILOGB)
-  REPLACE_ILOGBF=0;            AC_SUBST(REPLACE_ILOGBF)
-  REPLACE_ILOGBL=0;            AC_SUBST(REPLACE_ILOGBL)
-  REPLACE_ISFINITE=0;          AC_SUBST(REPLACE_ISFINITE)
-  REPLACE_ISINF=0;             AC_SUBST(REPLACE_ISINF)
-  REPLACE_ISNAN=0;             AC_SUBST(REPLACE_ISNAN)
-  REPLACE_LDEXPL=0;            AC_SUBST(REPLACE_LDEXPL)
-  REPLACE_LOG=0;               AC_SUBST(REPLACE_LOG)
-  REPLACE_LOGF=0;              AC_SUBST(REPLACE_LOGF)
-  REPLACE_LOGL=0;              AC_SUBST(REPLACE_LOGL)
-  REPLACE_LOG10=0;             AC_SUBST(REPLACE_LOG10)
-  REPLACE_LOG10F=0;            AC_SUBST(REPLACE_LOG10F)
-  REPLACE_LOG10L=0;            AC_SUBST(REPLACE_LOG10L)
-  REPLACE_LOG1P=0;             AC_SUBST(REPLACE_LOG1P)
-  REPLACE_LOG1PF=0;            AC_SUBST(REPLACE_LOG1PF)
-  REPLACE_LOG1PL=0;            AC_SUBST(REPLACE_LOG1PL)
-  REPLACE_LOG2=0;              AC_SUBST(REPLACE_LOG2)
-  REPLACE_LOG2F=0;             AC_SUBST(REPLACE_LOG2F)
-  REPLACE_LOG2L=0;             AC_SUBST(REPLACE_LOG2L)
-  REPLACE_LOGB=0;              AC_SUBST(REPLACE_LOGB)
-  REPLACE_LOGBF=0;             AC_SUBST(REPLACE_LOGBF)
-  REPLACE_LOGBL=0;             AC_SUBST(REPLACE_LOGBL)
-  REPLACE_MODF=0;              AC_SUBST(REPLACE_MODF)
-  REPLACE_MODFF=0;             AC_SUBST(REPLACE_MODFF)
-  REPLACE_MODFL=0;             AC_SUBST(REPLACE_MODFL)
-  REPLACE_NAN=0;               AC_SUBST(REPLACE_NAN)
-  REPLACE_REMAINDER=0;         AC_SUBST(REPLACE_REMAINDER)
-  REPLACE_REMAINDERF=0;        AC_SUBST(REPLACE_REMAINDERF)
-  REPLACE_REMAINDERL=0;        AC_SUBST(REPLACE_REMAINDERL)
-  REPLACE_ROUND=0;             AC_SUBST(REPLACE_ROUND)
-  REPLACE_ROUNDF=0;            AC_SUBST(REPLACE_ROUNDF)
-  REPLACE_ROUNDL=0;            AC_SUBST(REPLACE_ROUNDL)
-  REPLACE_SIGNBIT=0;           AC_SUBST(REPLACE_SIGNBIT)
-  REPLACE_SIGNBIT_USING_GCC=0; AC_SUBST(REPLACE_SIGNBIT_USING_GCC)
-  REPLACE_SINF=0;              AC_SUBST(REPLACE_SINF)
-  REPLACE_SINHF=0;             AC_SUBST(REPLACE_SINHF)
-  REPLACE_SQRTF=0;             AC_SUBST(REPLACE_SQRTF)
-  REPLACE_SQRTL=0;             AC_SUBST(REPLACE_SQRTL)
-  REPLACE_TANF=0;              AC_SUBST(REPLACE_TANF)
-  REPLACE_TANHF=0;             AC_SUBST(REPLACE_TANHF)
-  REPLACE_TRUNC=0;             AC_SUBST(REPLACE_TRUNC)
-  REPLACE_TRUNCF=0;            AC_SUBST(REPLACE_TRUNCF)
-  REPLACE_TRUNCL=0;            AC_SUBST(REPLACE_TRUNCL)
+  HAVE_ACOSF=1;                     AC_SUBST(HAVE_ACOSF)
+  HAVE_ACOSL=1;                     AC_SUBST(HAVE_ACOSL)
+  HAVE_ASINF=1;                     AC_SUBST(HAVE_ASINF)
+  HAVE_ASINL=1;                     AC_SUBST(HAVE_ASINL)
+  HAVE_ATANF=1;                     AC_SUBST(HAVE_ATANF)
+  HAVE_ATANL=1;                     AC_SUBST(HAVE_ATANL)
+  HAVE_ATAN2F=1;                    AC_SUBST(HAVE_ATAN2F)
+  HAVE_CBRT=1;                      AC_SUBST(HAVE_CBRT)
+  HAVE_CBRTF=1;                     AC_SUBST(HAVE_CBRTF)
+  HAVE_CBRTL=1;                     AC_SUBST(HAVE_CBRTL)
+  HAVE_COPYSIGN=1;                  AC_SUBST(HAVE_COPYSIGN)
+  HAVE_COPYSIGNL=1;                 AC_SUBST(HAVE_COPYSIGNL)
+  HAVE_COSF=1;                      AC_SUBST(HAVE_COSF)
+  HAVE_COSL=1;                      AC_SUBST(HAVE_COSL)
+  HAVE_COSHF=1;                     AC_SUBST(HAVE_COSHF)
+  HAVE_EXPF=1;                      AC_SUBST(HAVE_EXPF)
+  HAVE_EXPL=1;                      AC_SUBST(HAVE_EXPL)
+  HAVE_EXPM1=1;                     AC_SUBST(HAVE_EXPM1)
+  HAVE_EXPM1F=1;                    AC_SUBST(HAVE_EXPM1F)
+  HAVE_FABSF=1;                     AC_SUBST(HAVE_FABSF)
+  HAVE_FABSL=1;                     AC_SUBST(HAVE_FABSL)
+  HAVE_FMA=1;                       AC_SUBST(HAVE_FMA)
+  HAVE_FMAF=1;                      AC_SUBST(HAVE_FMAF)
+  HAVE_FMAL=1;                      AC_SUBST(HAVE_FMAL)
+  HAVE_FMODF=1;                     AC_SUBST(HAVE_FMODF)
+  HAVE_FMODL=1;                     AC_SUBST(HAVE_FMODL)
+  HAVE_FREXPF=1;                    AC_SUBST(HAVE_FREXPF)
+  HAVE_HYPOTF=1;                    AC_SUBST(HAVE_HYPOTF)
+  HAVE_HYPOTL=1;                    AC_SUBST(HAVE_HYPOTL)
+  HAVE_ILOGB=1;                     AC_SUBST(HAVE_ILOGB)
+  HAVE_ILOGBF=1;                    AC_SUBST(HAVE_ILOGBF)
+  HAVE_ILOGBL=1;                    AC_SUBST(HAVE_ILOGBL)
+  HAVE_ISNANF=1;                    AC_SUBST(HAVE_ISNANF)
+  HAVE_ISNAND=1;                    AC_SUBST(HAVE_ISNAND)
+  HAVE_ISNANL=1;                    AC_SUBST(HAVE_ISNANL)
+  HAVE_LDEXPF=1;                    AC_SUBST(HAVE_LDEXPF)
+  HAVE_LOGF=1;                      AC_SUBST(HAVE_LOGF)
+  HAVE_LOGL=1;                      AC_SUBST(HAVE_LOGL)
+  HAVE_LOG10F=1;                    AC_SUBST(HAVE_LOG10F)
+  HAVE_LOG10L=1;                    AC_SUBST(HAVE_LOG10L)
+  HAVE_LOG1P=1;                     AC_SUBST(HAVE_LOG1P)
+  HAVE_LOG1PF=1;                    AC_SUBST(HAVE_LOG1PF)
+  HAVE_LOG1PL=1;                    AC_SUBST(HAVE_LOG1PL)
+  HAVE_LOGBF=1;                     AC_SUBST(HAVE_LOGBF)
+  HAVE_LOGBL=1;                     AC_SUBST(HAVE_LOGBL)
+  HAVE_MODFF=1;                     AC_SUBST(HAVE_MODFF)
+  HAVE_MODFL=1;                     AC_SUBST(HAVE_MODFL)
+  HAVE_POWF=1;                      AC_SUBST(HAVE_POWF)
+  HAVE_REMAINDER=1;                 AC_SUBST(HAVE_REMAINDER)
+  HAVE_REMAINDERF=1;                AC_SUBST(HAVE_REMAINDERF)
+  HAVE_RINT=1;                      AC_SUBST(HAVE_RINT)
+  HAVE_RINTL=1;                     AC_SUBST(HAVE_RINTL)
+  HAVE_SINF=1;                      AC_SUBST(HAVE_SINF)
+  HAVE_SINL=1;                      AC_SUBST(HAVE_SINL)
+  HAVE_SINHF=1;                     AC_SUBST(HAVE_SINHF)
+  HAVE_SQRTF=1;                     AC_SUBST(HAVE_SQRTF)
+  HAVE_SQRTL=1;                     AC_SUBST(HAVE_SQRTL)
+  HAVE_TANF=1;                      AC_SUBST(HAVE_TANF)
+  HAVE_TANL=1;                      AC_SUBST(HAVE_TANL)
+  HAVE_TANHF=1;                     AC_SUBST(HAVE_TANHF)
+  HAVE_DECL_ACOSL=1;                AC_SUBST(HAVE_DECL_ACOSL)
+  HAVE_DECL_ASINL=1;                AC_SUBST(HAVE_DECL_ASINL)
+  HAVE_DECL_ATANL=1;                AC_SUBST(HAVE_DECL_ATANL)
+  HAVE_DECL_CBRTF=1;                AC_SUBST(HAVE_DECL_CBRTF)
+  HAVE_DECL_CBRTL=1;                AC_SUBST(HAVE_DECL_CBRTL)
+  HAVE_DECL_CEILF=1;                AC_SUBST(HAVE_DECL_CEILF)
+  HAVE_DECL_CEILL=1;                AC_SUBST(HAVE_DECL_CEILL)
+  HAVE_DECL_COPYSIGNF=1;            AC_SUBST(HAVE_DECL_COPYSIGNF)
+  HAVE_DECL_COSL=1;                 AC_SUBST(HAVE_DECL_COSL)
+  HAVE_DECL_EXPL=1;                 AC_SUBST(HAVE_DECL_EXPL)
+  HAVE_DECL_EXP2=1;                 AC_SUBST(HAVE_DECL_EXP2)
+  HAVE_DECL_EXP2F=1;                AC_SUBST(HAVE_DECL_EXP2F)
+  HAVE_DECL_EXP2L=1;                AC_SUBST(HAVE_DECL_EXP2L)
+  HAVE_DECL_EXPM1L=1;               AC_SUBST(HAVE_DECL_EXPM1L)
+  HAVE_DECL_FLOORF=1;               AC_SUBST(HAVE_DECL_FLOORF)
+  HAVE_DECL_FLOORL=1;               AC_SUBST(HAVE_DECL_FLOORL)
+  HAVE_DECL_FREXPL=1;               AC_SUBST(HAVE_DECL_FREXPL)
+  HAVE_DECL_LDEXPL=1;               AC_SUBST(HAVE_DECL_LDEXPL)
+  HAVE_DECL_LOGL=1;                 AC_SUBST(HAVE_DECL_LOGL)
+  HAVE_DECL_LOG10L=1;               AC_SUBST(HAVE_DECL_LOG10L)
+  HAVE_DECL_LOG2=1;                 AC_SUBST(HAVE_DECL_LOG2)
+  HAVE_DECL_LOG2F=1;                AC_SUBST(HAVE_DECL_LOG2F)
+  HAVE_DECL_LOG2L=1;                AC_SUBST(HAVE_DECL_LOG2L)
+  HAVE_DECL_LOGB=1;                 AC_SUBST(HAVE_DECL_LOGB)
+  HAVE_DECL_REMAINDER=1;            AC_SUBST(HAVE_DECL_REMAINDER)
+  HAVE_DECL_REMAINDERL=1;           AC_SUBST(HAVE_DECL_REMAINDERL)
+  HAVE_DECL_RINTF=1;                AC_SUBST(HAVE_DECL_RINTF)
+  HAVE_DECL_ROUND=1;                AC_SUBST(HAVE_DECL_ROUND)
+  HAVE_DECL_ROUNDF=1;               AC_SUBST(HAVE_DECL_ROUNDF)
+  HAVE_DECL_ROUNDL=1;               AC_SUBST(HAVE_DECL_ROUNDL)
+  HAVE_DECL_SINL=1;                 AC_SUBST(HAVE_DECL_SINL)
+  HAVE_DECL_SQRTL=1;                AC_SUBST(HAVE_DECL_SQRTL)
+  HAVE_DECL_TANL=1;                 AC_SUBST(HAVE_DECL_TANL)
+  HAVE_DECL_TRUNC=1;                AC_SUBST(HAVE_DECL_TRUNC)
+  HAVE_DECL_TRUNCF=1;               AC_SUBST(HAVE_DECL_TRUNCF)
+  HAVE_DECL_TRUNCL=1;               AC_SUBST(HAVE_DECL_TRUNCL)
+  REPLACE_ACOSF=0;                  AC_SUBST(REPLACE_ACOSF)
+  REPLACE_ASINF=0;                  AC_SUBST(REPLACE_ASINF)
+  REPLACE_ATANF=0;                  AC_SUBST(REPLACE_ATANF)
+  REPLACE_ATAN2F=0;                 AC_SUBST(REPLACE_ATAN2F)
+  REPLACE_CBRTF=0;                  AC_SUBST(REPLACE_CBRTF)
+  REPLACE_CBRTL=0;                  AC_SUBST(REPLACE_CBRTL)
+  REPLACE_CEIL=0;                   AC_SUBST(REPLACE_CEIL)
+  REPLACE_CEILF=0;                  AC_SUBST(REPLACE_CEILF)
+  REPLACE_CEILL=0;                  AC_SUBST(REPLACE_CEILL)
+  REPLACE_COSF=0;                   AC_SUBST(REPLACE_COSF)
+  REPLACE_COSHF=0;                  AC_SUBST(REPLACE_COSHF)
+  REPLACE_EXPF=0;                   AC_SUBST(REPLACE_EXPF)
+  REPLACE_EXPL=0;                   AC_SUBST(REPLACE_EXPL)
+  REPLACE_EXPM1=0;                  AC_SUBST(REPLACE_EXPM1)
+  REPLACE_EXPM1F=0;                 AC_SUBST(REPLACE_EXPM1F)
+  REPLACE_EXPM1L=0;                 AC_SUBST(REPLACE_EXPM1L)
+  REPLACE_EXP2=0;                   AC_SUBST(REPLACE_EXP2)
+  REPLACE_EXP2L=0;                  AC_SUBST(REPLACE_EXP2L)
+  REPLACE_FABSL=0;                  AC_SUBST(REPLACE_FABSL)
+  REPLACE_FLOOR=0;                  AC_SUBST(REPLACE_FLOOR)
+  REPLACE_FLOORF=0;                 AC_SUBST(REPLACE_FLOORF)
+  REPLACE_FLOORL=0;                 AC_SUBST(REPLACE_FLOORL)
+  REPLACE_FMA=0;                    AC_SUBST(REPLACE_FMA)
+  REPLACE_FMAF=0;                   AC_SUBST(REPLACE_FMAF)
+  REPLACE_FMAL=0;                   AC_SUBST(REPLACE_FMAL)
+  REPLACE_FMOD=0;                   AC_SUBST(REPLACE_FMOD)
+  REPLACE_FMODF=0;                  AC_SUBST(REPLACE_FMODF)
+  REPLACE_FMODL=0;                  AC_SUBST(REPLACE_FMODL)
+  REPLACE_FREXPF=0;                 AC_SUBST(REPLACE_FREXPF)
+  REPLACE_FREXP=0;                  AC_SUBST(REPLACE_FREXP)
+  REPLACE_FREXPL=0;                 AC_SUBST(REPLACE_FREXPL)
+  REPLACE_HUGE_VAL=0;               AC_SUBST(REPLACE_HUGE_VAL)
+  REPLACE_HYPOT=0;                  AC_SUBST(REPLACE_HYPOT)
+  REPLACE_HYPOTF=0;                 AC_SUBST(REPLACE_HYPOTF)
+  REPLACE_HYPOTL=0;                 AC_SUBST(REPLACE_HYPOTL)
+  REPLACE_ILOGB=0;                  AC_SUBST(REPLACE_ILOGB)
+  REPLACE_ILOGBF=0;                 AC_SUBST(REPLACE_ILOGBF)
+  REPLACE_ILOGBL=0;                 AC_SUBST(REPLACE_ILOGBL)
+  REPLACE_ISFINITE=0;               AC_SUBST(REPLACE_ISFINITE)
+  REPLACE_ISINF=0;                  AC_SUBST(REPLACE_ISINF)
+  REPLACE_ISNAN=0;                  AC_SUBST(REPLACE_ISNAN)
+  REPLACE_LDEXPL=0;                 AC_SUBST(REPLACE_LDEXPL)
+  REPLACE_LOG=0;                    AC_SUBST(REPLACE_LOG)
+  REPLACE_LOGF=0;                   AC_SUBST(REPLACE_LOGF)
+  REPLACE_LOGL=0;                   AC_SUBST(REPLACE_LOGL)
+  REPLACE_LOG10=0;                  AC_SUBST(REPLACE_LOG10)
+  REPLACE_LOG10F=0;                 AC_SUBST(REPLACE_LOG10F)
+  REPLACE_LOG10L=0;                 AC_SUBST(REPLACE_LOG10L)
+  REPLACE_LOG1P=0;                  AC_SUBST(REPLACE_LOG1P)
+  REPLACE_LOG1PF=0;                 AC_SUBST(REPLACE_LOG1PF)
+  REPLACE_LOG1PL=0;                 AC_SUBST(REPLACE_LOG1PL)
+  REPLACE_LOG2=0;                   AC_SUBST(REPLACE_LOG2)
+  REPLACE_LOG2F=0;                  AC_SUBST(REPLACE_LOG2F)
+  REPLACE_LOG2L=0;                  AC_SUBST(REPLACE_LOG2L)
+  REPLACE_LOGB=0;                   AC_SUBST(REPLACE_LOGB)
+  REPLACE_LOGBF=0;                  AC_SUBST(REPLACE_LOGBF)
+  REPLACE_LOGBL=0;                  AC_SUBST(REPLACE_LOGBL)
+  REPLACE_MODF=0;                   AC_SUBST(REPLACE_MODF)
+  REPLACE_MODFF=0;                  AC_SUBST(REPLACE_MODFF)
+  REPLACE_MODFL=0;                  AC_SUBST(REPLACE_MODFL)
+  REPLACE_NAN=0;                    AC_SUBST(REPLACE_NAN)
+  REPLACE_REMAINDER=0;              AC_SUBST(REPLACE_REMAINDER)
+  REPLACE_REMAINDERF=0;             AC_SUBST(REPLACE_REMAINDERF)
+  REPLACE_REMAINDERL=0;             AC_SUBST(REPLACE_REMAINDERL)
+  REPLACE_RINTL=0;                  AC_SUBST(REPLACE_RINTL)
+  REPLACE_ROUND=0;                  AC_SUBST(REPLACE_ROUND)
+  REPLACE_ROUNDF=0;                 AC_SUBST(REPLACE_ROUNDF)
+  REPLACE_ROUNDL=0;                 AC_SUBST(REPLACE_ROUNDL)
+  REPLACE_SIGNBIT=0;                AC_SUBST(REPLACE_SIGNBIT)
+  REPLACE_SIGNBIT_USING_BUILTINS=0; AC_SUBST(REPLACE_SIGNBIT_USING_BUILTINS)
+  REPLACE_SINF=0;                   AC_SUBST(REPLACE_SINF)
+  REPLACE_SINHF=0;                  AC_SUBST(REPLACE_SINHF)
+  REPLACE_SQRTF=0;                  AC_SUBST(REPLACE_SQRTF)
+  REPLACE_SQRTL=0;                  AC_SUBST(REPLACE_SQRTL)
+  REPLACE_TANF=0;                   AC_SUBST(REPLACE_TANF)
+  REPLACE_TANHF=0;                  AC_SUBST(REPLACE_TANHF)
+  REPLACE_TRUNC=0;                  AC_SUBST(REPLACE_TRUNC)
+  REPLACE_TRUNCF=0;                 AC_SUBST(REPLACE_TRUNCF)
+  REPLACE_TRUNCL=0;                 AC_SUBST(REPLACE_TRUNCL)
 )
 
 # gl_LONG_DOUBLE_VS_DOUBLE

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/memchr.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/memchr.m4 Changed

@@ -1,5 +1,5 @@
-# memchr.m4 serial 13
-dnl Copyright (C) 2002-2004, 2009-2018 Free Software Foundation, Inc.
+# memchr.m4 serial 18
+dnl Copyright (C) 2002-2004, 2009-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -13,25 +13,18 @@
   AC_CHECK_HEADERS_ONCE(sys/mman.h)
   AC_CHECK_FUNCS_ONCE(mprotect)
 
-  AC_REQUIRE(gl_HEADER_STRING_H_DEFAULTS)
-  m4_ifdef(gl_FUNC_MEMCHR_OBSOLETE, 
-    dnl These days, we assume memchr is present.  But if support for old
-    dnl platforms is desired:
-    AC_CHECK_FUNCS_ONCE(memchr)
-    if test $ac_cv_func_memchr = no; then
-      HAVE_MEMCHR=0
-    fi
-  )
-  if test $HAVE_MEMCHR = 1; then
-    # Detect platform-specific bugs in some versions of glibc:
-    # memchr should not dereference anything with length 0
-    #   https://bugzilla.redhat.com/show_bug.cgi?id=499689
-    # memchr should not dereference overestimated length after a match
-    #   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=521737
-    #   https://sourceware.org/bugzilla/show_bug.cgi?id=10162
-    # Assume that memchr works on platforms that lack mprotect.
-    AC_CACHE_CHECK(whether memchr works, gl_cv_func_memchr_works,
-      AC_RUN_IFELSE(AC_LANG_PROGRAM(
+  AC_REQUIRE(gl_STRING_H_DEFAULTS)
+  # Detect platform-specific bugs in some versions of glibc:
+  # memchr should not dereference anything with length 0
+  #   https://bugzilla.redhat.com/show_bug.cgi?id=499689
+  # memchr should not dereference overestimated length after a match
+  #   https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=521737
+  #   https://sourceware.org/bugzilla/show_bug.cgi?id=10162
+  # memchr should cast the second argument to 'unsigned char'.
+  #   This bug exists in Android 4.3.
+  # Assume that memchr works on platforms that lack mprotect.
+  AC_CACHE_CHECK(whether memchr works, gl_cv_func_memchr_works,
+    AC_RUN_IFELSE(AC_LANG_PROGRAM(
 #include <string.h>
 #if HAVE_SYS_MMAN_H
 # include <fcntl.h>
@@ -66,6 +59,7 @@
 #endif
   if (fence)
     {
+      /* Test against bugs on glibc systems.  */
       if (memchr (fence, 0, 0))
         result |= 1;
       strcpy (fence - 9, "12345678");
@@ -73,24 +67,37 @@
         result |= 2;
       if (memchr (fence - 1, 0, 3) != fence - 1)
         result |= 4;
+      /* Test against bug on AIX 7.2.  */
+      if (memchr (fence - 4, '6', 16) != fence - 4)
+        result |= 8;
     }
+  /* Test against bug on Android 4.3.  */
+  {
+    char input3;
+    input0 = 'a';
+    input1 = 'b';
+    input2 = 'c';
+    if (memchr (input, 0x789abc00 | 'b', 3) != input + 1)
+      result |= 16;
+  }
   return result;
 ),
-         gl_cv_func_memchr_works=yes,
-         gl_cv_func_memchr_works=no,
-         case "$host_os" in
-                    # Guess yes on native Windows.
-            mingw*) gl_cv_func_memchr_works="guessing yes" ;;
-                    # Be pessimistic for now.
-            *)      gl_cv_func_memchr_works="guessing no" ;;
-          esac
-         )
-      )
-    case "$gl_cv_func_memchr_works" in
-      *yes) ;;
-      *) REPLACE_MEMCHR=1 ;;
-    esac
-  fi
+       gl_cv_func_memchr_works=yes,
+       gl_cv_func_memchr_works=no,
+       case "$host_os" in
+                           # Guess no on Android.
+          linux*-android*) gl_cv_func_memchr_works="guessing no" ;;
+                           # Guess yes on native Windows.
+          mingw*)          gl_cv_func_memchr_works="guessing yes" ;;
+                           # If we don't know, obey --enable-cross-guesses.
+          *)               gl_cv_func_memchr_works="$gl_cross_guess_normal" ;;
+        esac
+       )
+    )
+  case "$gl_cv_func_memchr_works" in
+    *yes) ;;
+    *) REPLACE_MEMCHR=1 ;;
+  esac
 )
 
 # Prerequisites of lib/memchr.c.

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/mmap-anon.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/mmap-anon.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/multiarch.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/multiarch.m4 Changed

@@ -1,5 +1,5 @@
-# multiarch.m4 serial 7
-dnl Copyright (C) 2008-2018 Free Software Foundation, Inc.
+# multiarch.m4 serial 9
+dnl Copyright (C) 2008-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -21,37 +21,40 @@
 AC_DEFUN_ONCE(gl_MULTIARCH,
 
   dnl Code similar to autoconf-2.63 AC_C_BIGENDIAN.
-  gl_cv_c_multiarch=no
-  AC_COMPILE_IFELSE(
-    AC_LANG_SOURCE(
-      #ifndef __APPLE_CC__
-         not a universal capable compiler
-        #endif
-        typedef int dummy;
-      ),
-    
-     dnl Check for potential -arch flags.  It is not universal unless
-     dnl there are at least two -arch flags with different values.
-     arch=
-     prev=
-     for word in ${CC} ${CFLAGS} ${CPPFLAGS} ${LDFLAGS}; do
-       if test -n "$prev"; then
-         case $word in
-           i?86 | x86_64 | ppc | ppc64)
-             if test -z "$arch" || test "$arch" = "$word"; then
-               arch="$word"
-             else
-               gl_cv_c_multiarch=yes
-             fi
-             ;;
-         esac
-         prev=
-       else
-         if test "x$word" = "x-arch"; then
-           prev=arch
-         fi
-       fi
-     done
+  AC_CACHE_CHECK(whether the compiler produces multi-arch binaries,
+    gl_cv_c_multiarch,
+    gl_cv_c_multiarch=no
+     AC_COMPILE_IFELSE(
+       AC_LANG_SOURCE(
+         #ifndef __APPLE_CC__
+            not a universal capable compiler
+           #endif
+           typedef int dummy;
+         ),
+       
+        dnl Check for potential -arch flags.  It is not universal unless
+        dnl there are at least two -arch flags with different values.
+        arch=
+        prev=
+        for word in ${CC} ${CFLAGS} ${CPPFLAGS} ${LDFLAGS}; do
+          if test -n "$prev"; then
+            case $word in
+              i?86 | x86_64 | ppc | ppc64 | arm | arm64)
+                if test -z "$arch" || test "$arch" = "$word"; then
+                  arch="$word"
+                else
+                  gl_cv_c_multiarch=yes
+                fi
+                ;;
+            esac
+            prev=
+          else
+            if test "x$word" = "x-arch"; then
+              prev=arch
+            fi
+          fi
+        done
+       )
     )
   if test $gl_cv_c_multiarch = yes; then
     APPLE_UNIVERSAL_BUILD=1

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/nocrash.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/nocrash.m4 Changed

@@ -1,5 +1,5 @@
 # nocrash.m4 serial 5
-dnl Copyright (C) 2005, 2009-2018 Free Software Foundation, Inc.
+dnl Copyright (C) 2005, 2009-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -53,7 +53,7 @@
   /* Allocate a port on which the thread shall listen for exceptions.  */
   if (mach_port_allocate (self, MACH_PORT_RIGHT_RECEIVE, &our_exception_port)
       == KERN_SUCCESS) {
-    /* See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
+    /* See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/mach_port_insert_right.html.  */
     if (mach_port_insert_right (self, our_exception_port, our_exception_port,
                                 MACH_MSG_TYPE_MAKE_SEND)
         == KERN_SUCCESS) {
@@ -72,7 +72,7 @@
            for a particular thread.  This has the effect that when our exception
            port gets the message, the thread specific exception port has already
            been asked, and we don't need to bother about it.
-           See http://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
+           See https://web.mit.edu/darwin/src/modules/xnu/osfmk/man/task_set_exception_ports.html.  */
         task_set_exception_ports (self, mask, our_exception_port,
                                   EXCEPTION_DEFAULT, MACHINE_THREAD_STATE);
       }

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/off_t.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/off_t.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/printf-frexp.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/printf-frexp.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/printf-frexpl.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/printf-frexpl.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/printf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/printf.m4 Changed

@@ -1,5 +1,5 @@
-# printf.m4 serial 58
-dnl Copyright (C) 2003, 2007-2018 Free Software Foundation, Inc.
+# printf.m4 serial 73
+dnl Copyright (C) 2003, 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -62,9 +62,12 @@
 changequote(,)dnl
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_sizes_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_sizes_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_printf_sizes_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_sizes_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_sizes_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_sizes_c99="guessing no";;
            darwin*)              gl_cv_func_printf_sizes_c99="guessing yes";;
@@ -79,6 +82,8 @@
            netbsd1-2* | netbsdelf1-2* | netbsdaout1-2* | netbsdcoff1-2*)
                                  gl_cv_func_printf_sizes_c99="guessing no";;
            netbsd*)              gl_cv_func_printf_sizes_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_printf_sizes_c99="guessing yes";;
 changequote(,)dnl
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               AC_EGREP_CPP(Known, 
@@ -89,8 +94,8 @@
                                    gl_cv_func_printf_sizes_c99="guessing yes",
                                    gl_cv_func_printf_sizes_c99="guessing no")
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_sizes_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_sizes_c99="$gl_cross_guess_normal";;
          esac
         )
     )
@@ -132,17 +137,20 @@
         gl_cv_func_printf_long_double=yes,
         gl_cv_func_printf_long_double=no,
         case "$host_os" in
-           beos*)  gl_cv_func_printf_long_double="guessing no";;
-                   # Guess yes on MSVC, no on mingw.
-           mingw*) AC_EGREP_CPP(Known, 
+                            # Guess no on BeOS.
+           beos*)           gl_cv_func_printf_long_double="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_long_double="guessing yes";;
+                            # Guess yes on MSVC, no on mingw.
+           mingw*)          AC_EGREP_CPP(Known, 
 #ifdef _MSC_VER
  Known
 #endif
-                     ,
-                     gl_cv_func_printf_long_double="guessing yes",
-                     gl_cv_func_printf_long_double="guessing no")
-                   ;;
-           *)      gl_cv_func_printf_long_double="guessing yes";;
+                              ,
+                              gl_cv_func_printf_long_double="guessing yes",
+                              gl_cv_func_printf_long_double="guessing no")
+                            ;;
+           *)               gl_cv_func_printf_long_double="guessing yes";;
          esac
         )
     )
@@ -235,9 +243,12 @@
 changequote(,)dnl
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on FreeBSD >= 6.
            freebsd1-5.*)       gl_cv_func_printf_infinite="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_infinite="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_infinite="guessing no";;
            darwin*)              gl_cv_func_printf_infinite="guessing yes";;
@@ -248,8 +259,13 @@
            netbsd1-2* | netbsdelf1-2* | netbsdaout1-2* | netbsdcoff1-2*)
                                  gl_cv_func_printf_infinite="guessing no";;
            netbsd*)              gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)       gl_cv_func_printf_infinite="guessing no";;
+           openbsd*)             gl_cv_func_printf_infinite="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_printf_infinite="guessing yes";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_infinite="guessing no";;
 changequote(,)dnl
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               AC_EGREP_CPP(Known, 
@@ -260,8 +276,8 @@
                                    gl_cv_func_printf_infinite="guessing yes",
                                    gl_cv_func_printf_infinite="guessing no")
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_infinite="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_infinite="$gl_cross_guess_normal";;
          esac
         )
     )
@@ -450,12 +466,20 @@
 changequote(,)dnl
                                          # Guess yes on glibc systems.
                    *-gnu* | gnu*)        gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess yes on musl systems.
+                   *-musl*)              gl_cv_func_printf_infinite_long_double="guessing yes";;
                                          # Guess yes on FreeBSD >= 6.
                    freebsd1-5.*)       gl_cv_func_printf_infinite_long_double="guessing no";;
                    freebsd* | kfreebsd*) gl_cv_func_printf_infinite_long_double="guessing yes";;
+                   midnightbsd*)         gl_cv_func_printf_infinite_long_double="guessing yes";;
                                          # Guess yes on HP-UX >= 11.
                    hpux7-9* | hpux10*) gl_cv_func_printf_infinite_long_double="guessing no";;
                    hpux*)                gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess yes on OpenBSD >= 6.0.
+                   openbsd1-5.*)       gl_cv_func_printf_infinite_long_double="guessing no";;
+                   openbsd*)             gl_cv_func_printf_infinite_long_double="guessing yes";;
+                                         # Guess no on Android.
+                   linux*-android*)      gl_cv_func_printf_infinite_long_double="guessing no";;
 changequote(,)dnl
                                          # Guess yes on MSVC, no on mingw.
                    mingw*)               AC_EGREP_CPP(Known, 
@@ -466,8 +490,8 @@
                                            gl_cv_func_printf_infinite_long_double="guessing yes",
                                            gl_cv_func_printf_infinite_long_double="guessing no")
                                          ;;
-                                         # If we don't know, assume the worst.
-                   *)                    gl_cv_func_printf_infinite_long_double="guessing no";;
+                                         # If we don't know, obey --enable-cross-guesses.
+                   *)                    gl_cv_func_printf_infinite_long_double="$gl_cross_guess_normal";;
                  esac
                  ;;
              esac
@@ -513,7 +537,7 @@
           && strcmp (buf, "-0X6.488P-1 33") != 0
           && strcmp (buf, "-0XC.91P-2 33") != 0))
     result |= 2;
-  /* This catches a FreeBSD 6.1 bug: it doesn't round.  */
+  /* This catches a FreeBSD 13.0 bug: it doesn't round.  */
   if (sprintf (buf, "%.2a %d", 1.51, 33, 44, 55) < 0
       || (strcmp (buf, "0x1.83p+0 33") != 0
           && strcmp (buf, "0x3.05p-1 33") != 0
@@ -566,10 +590,14 @@
                gl_cv_func_printf_directive_a="guessing yes",
                gl_cv_func_printf_directive_a="guessing no")
              ;;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_directive_a="guessing yes";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_directive_a="guessing no";;
                                  # Guess no on native Windows.
            mingw*)               gl_cv_func_printf_directive_a="guessing no";;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_directive_a="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_directive_a="$gl_cross_guess_normal";;
          esac
         )
     )
@@ -614,15 +642,23 @@
 changequote(,)dnl
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_printf_directive_f="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on FreeBSD >= 6.
            freebsd1-5.*)       gl_cv_func_printf_directive_f="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_printf_directive_f="guessing yes";;
+           midnightbsd*)         gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_printf_directive_f="guessing no";;
            darwin*)              gl_cv_func_printf_directive_f="guessing yes";;
+                                 # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)       gl_cv_func_printf_directive_f="guessing no";;
+           openbsd*)             gl_cv_func_printf_directive_f="guessing yes";;
                                  # Guess yes on Solaris >= 2.10.
            solaris2.1-90-9*) gl_cv_func_printf_directive_f="guessing yes";;
            solaris*)             gl_cv_func_printf_directive_f="guessing no";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_printf_directive_f="guessing no";;
 changequote(,)dnl
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               AC_EGREP_CPP(Known, 
@@ -633,8 +669,8 @@
                                    gl_cv_func_printf_directive_f="guessing yes",
                                    gl_cv_func_printf_directive_f="guessing no")
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_printf_directive_f="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_printf_directive_f="$gl_cross_guess_normal";;
          esac
         )
     )
@@ -657,7 +693,10 @@
 #include <stdlib.h>
 #include <string.h>
 #ifdef _MSC_VER
-/* See page about "Parameter Validation" on msdn.microsoft.com.  */
+#include <inttypes.h>
+/* See page about "Parameter Validation" on msdn.microsoft.com.
+   <https://docs.microsoft.com/en-us/cpp/c-runtime-library/parameter-validation>
+   <https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/set-invalid-parameter-handler-set-thread-local-invalid-parameter-handler>  */
 static void cdecl
 invalid_parameter_handler (const wchar_t *expression,
                            const wchar_t *function,
@@ -688,9 +727,21 @@
         gl_cv_func_printf_directive_n=yes,
         gl_cv_func_printf_directive_n=no,
         case "$host_os" in
-                   # Guess no on native Windows.
-           mingw*) gl_cv_func_printf_directive_n="guessing no";;
-           *)      gl_cv_func_printf_directive_n="guessing yes";;
+                            # Guess no on glibc when _FORTIFY_SOURCE >= 2.
+           *-gnu* | gnu*)   AC_COMPILE_IFELSE(
+                              AC_LANG_SOURCE(
+                                 #if _FORTIFY_SOURCE >= 2
+                                    error fail
+                                   #endif
+                                 ),
+                              gl_cv_func_printf_directive_n="guessing yes",
+                              gl_cv_func_printf_directive_n="guessing no")
+                            ;;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_directive_n="guessing no";;
+                            # Guess no on native Windows.
+           mingw*)          gl_cv_func_printf_directive_n="guessing no";;
+           *)               gl_cv_func_printf_directive_n="guessing yes";;
          esac
         )
     )
@@ -712,13 +763,7 @@
     
       AC_RUN_IFELSE(
         AC_LANG_SOURCE(
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
 #include <stdio.h>
-#include <time.h>
 #include <wchar.h>
 #include <string.h>
 int main ()
@@ -766,14 +811,18 @@
         
 changequote(,)dnl
          case "$host_os" in
-           openbsd*)       gl_cv_func_printf_directive_ls="guessing no";;
-           irix*)          gl_cv_func_printf_directive_ls="guessing no";;
-           solaris*)       gl_cv_func_printf_directive_ls="guessing no";;
-           cygwin*)        gl_cv_func_printf_directive_ls="guessing no";;
-           beos* | haiku*) gl_cv_func_printf_directive_ls="guessing no";;
-                           # Guess yes on native Windows.
-           mingw*)         gl_cv_func_printf_directive_ls="guessing yes";;
-           *)              gl_cv_func_printf_directive_ls="guessing yes";;
+                            # Guess yes on OpenBSD >= 6.0.
+           openbsd1-5.*)  gl_cv_func_printf_directive_ls="guessing no";;
+           openbsd*)        gl_cv_func_printf_directive_ls="guessing yes";;
+           irix*)           gl_cv_func_printf_directive_ls="guessing no";;
+           solaris*)        gl_cv_func_printf_directive_ls="guessing no";;
+           cygwin*)         gl_cv_func_printf_directive_ls="guessing no";;
+           beos* | haiku*)  gl_cv_func_printf_directive_ls="guessing no";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_directive_ls="guessing no";;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_printf_directive_ls="guessing yes";;
+           *)               gl_cv_func_printf_directive_ls="guessing yes";;
          esac
 changequote(,)dnl
         )
@@ -810,11 +859,13 @@
 changequote(,)dnl
          case "$host_os" in
            netbsd1-3* | netbsdelf1-3* | netbsdaout1-3* | netbsdcoff1-3*)
-                         gl_cv_func_printf_positions="guessing no";;
-           beos*)        gl_cv_func_printf_positions="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_positions="guessing no";;
-           *)            gl_cv_func_printf_positions="guessing yes";;
+                            gl_cv_func_printf_positions="guessing no";;
+           beos*)           gl_cv_func_printf_positions="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_positions="guessing yes";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_positions="guessing no";;
+           *)               gl_cv_func_printf_positions="guessing yes";;
          esac
 changequote(,)dnl
         )
@@ -849,11 +900,13 @@
         
 changequote(,)dnl
          case "$host_os" in
-           cygwin*)      gl_cv_func_printf_flag_grouping="guessing no";;
-           netbsd*)      gl_cv_func_printf_flag_grouping="guessing no";;
-                         # Guess no on native Windows.
-           mingw* | pw*) gl_cv_func_printf_flag_grouping="guessing no";;
-           *)            gl_cv_func_printf_flag_grouping="guessing yes";;
+           cygwin*)         gl_cv_func_printf_flag_grouping="guessing no";;
+           netbsd*)         gl_cv_func_printf_flag_grouping="guessing no";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_flag_grouping="guessing no";;
+                            # Guess no on native Windows.
+           mingw* | pw*)    gl_cv_func_printf_flag_grouping="guessing no";;
+           *)               gl_cv_func_printf_flag_grouping="guessing yes";;
          esac
 changequote(,)dnl
         )
@@ -890,14 +943,16 @@
         
 changequote(,)dnl
          case "$host_os" in
-                    # Guess yes on HP-UX 11.
-           hpux11*) gl_cv_func_printf_flag_leftadjust="guessing yes";;
-                    # Guess no on HP-UX 10 and older.
-           hpux*)   gl_cv_func_printf_flag_leftadjust="guessing no";;
-                    # Guess yes on native Windows.
-           mingw*)  gl_cv_func_printf_flag_leftadjust="guessing yes";;
-                    # Guess yes otherwise.
-           *)       gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes on HP-UX 11.
+           hpux11*)         gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess no on HP-UX 10 and older.
+           hpux*)           gl_cv_func_printf_flag_leftadjust="guessing no";;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_printf_flag_leftadjust="guessing yes";;
+                            # Guess yes otherwise.
+           *)               gl_cv_func_printf_flag_leftadjust="guessing yes";;
          esac
 changequote(,)dnl
         )
@@ -935,14 +990,18 @@
         
 changequote(,)dnl
          case "$host_os" in
-                          # Guess yes on glibc systems.
-           *-gnu* | gnu*) gl_cv_func_printf_flag_zero="guessing yes";;
-                          # Guess yes on BeOS.
-           beos*)         gl_cv_func_printf_flag_zero="guessing yes";;
-                          # Guess no on native Windows.
-           mingw*)        gl_cv_func_printf_flag_zero="guessing no";;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_printf_flag_zero="guessing no";;
+                            # Guess yes on glibc systems.
+           *-gnu* | gnu*)   gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess yes on musl systems.
+           *-musl*)         gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess yes on BeOS.
+           beos*)           gl_cv_func_printf_flag_zero="guessing yes";;
+                            # Guess no on Android.
+           linux*-android*) gl_cv_func_printf_flag_zero="guessing no";;
+                            # Guess no on native Windows.
+           mingw*)          gl_cv_func_printf_flag_zero="guessing no";;
+                            # If we don't know, obey --enable-cross-guesses.
+           *)               gl_cv_func_printf_flag_zero="$gl_cross_guess_normal";;
          esac
 changequote(,)dnl
         )
@@ -995,10 +1054,12 @@
 changequote(,)dnl
          case "$host_os" in
            # Guess no only on Solaris, native Windows, and BeOS systems.
-           solaris*)     gl_cv_func_printf_precision="guessing no" ;;
-           mingw* | pw*) gl_cv_func_printf_precision="guessing no" ;;
-           beos*)        gl_cv_func_printf_precision="guessing no" ;;
-           *)            gl_cv_func_printf_precision="guessing yes" ;;
+           solaris*)        gl_cv_func_printf_precision="guessing no" ;;
+           mingw* | pw*)    gl_cv_func_printf_precision="guessing no" ;;
+           beos*)           gl_cv_func_printf_precision="guessing no" ;;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_printf_precision="guessing yes" ;;
+           *)               gl_cv_func_printf_precision="guessing yes" ;;
          esac
 changequote(,)dnl
         )
@@ -1020,9 +1081,8 @@
       gl_cv_func_printf_enomem="guessing no"
       if test "$cross_compiling" = no; then
         if test $APPLE_UNIVERSAL_BUILD = 0; then
-          AC_LANG_CONFTEST(AC_LANG_SOURCE(
+          AC_LANG_CONFTEST(AC_LANG_SOURCE(
 GL_NOCRASH
-changequote(,)dnl
 #include <stdio.h>
 #include <sys/types.h>
 #include <sys/time.h>
@@ -1067,8 +1127,7 @@
   ret = printf ("%.5000000f", 1.0);
   return !(ret == 5000002 || (ret < 0 && errno == ENOMEM));
 }
-changequote(,)dnl
-          ))
+          ))
           if AC_TRY_EVAL(ac_link) && test -s conftest$ac_exeext; then
             (./conftest 2>&AS_MESSAGE_LOG_FD
              result=$?
@@ -1095,28 +1154,30 @@
       if test "$gl_cv_func_printf_enomem" = "guessing no"; then
 changequote(,)dnl
         case "$host_os" in
-                         # Guess yes on glibc systems.
-          *-gnu* | gnu*) gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on Solaris.
-          solaris*)      gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on AIX.
-          aix*)          gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on HP-UX/hppa.
-          hpux*)         case "$host_cpu" in
-                           hppa*) gl_cv_func_printf_enomem="guessing yes";;
-                           *)     gl_cv_func_printf_enomem="guessing no";;
-                         esac
-                         ;;
-                         # Guess yes on IRIX.
-          irix*)         gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on OSF/1.
-          osf*)          gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on BeOS.
-          beos*)         gl_cv_func_printf_enomem="guessing yes";;
-                         # Guess yes on Haiku.
-          haiku*)        gl_cv_func_printf_enomem="guessing yes";;
-                         # If we don't know, assume the worst.
-          *)             gl_cv_func_printf_enomem="guessing no";;
+                           # Guess yes on glibc systems.
+          *-gnu* | gnu*)   gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on Solaris.
+          solaris*)        gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on AIX.
+          aix*)            gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on HP-UX/hppa.
+          hpux*)           case "$host_cpu" in
+                             hppa*) gl_cv_func_printf_enomem="guessing yes";;
+                             *)     gl_cv_func_printf_enomem="guessing no";;
+                           esac
+                           ;;
+                           # Guess yes on IRIX.
+          irix*)           gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on OSF/1.
+          osf*)            gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on BeOS.
+          beos*)           gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess yes on Haiku.
+          haiku*)          gl_cv_func_printf_enomem="guessing yes";;
+                           # Guess no on Android.
+          linux*-android*) gl_cv_func_printf_enomem="guessing no";;
+                           # If we don't know, obey --enable-cross-guesses.
+          *)               gl_cv_func_printf_enomem="$gl_cross_guess_normal";;
         esac
 changequote(,)dnl
       fi
@@ -1135,7 +1196,7 @@
 dnl terminated. (ISO C99, POSIX:2001)
 dnl Result is gl_cv_func_snprintf_truncation_c99.
 
-AC_DEFUN(gl_SNPRINTF_TRUNCATION_C99,
+AC_DEFUN_ONCE(gl_SNPRINTF_TRUNCATION_C99,
 
   AC_REQUIRE(AC_PROG_CC)
   AC_REQUIRE(AC_CANONICAL_HOST) dnl for cross-compiles
@@ -1177,9 +1238,12 @@
          case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_snprintf_truncation_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_snprintf_truncation_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_snprintf_truncation_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_snprintf_truncation_c99="guessing no";;
            darwin*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
@@ -1208,10 +1272,12 @@
            netbsd*)              gl_cv_func_snprintf_truncation_c99="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_snprintf_truncation_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_snprintf_truncation_c99="guessing yes";;
                                  # Guess no on native Windows.
            mingw*)               gl_cv_func_snprintf_truncation_c99="guessing no";;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_snprintf_truncation_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_snprintf_truncation_c99="$gl_cross_guess_normal";;
          esac
 changequote(,)dnl
         )
@@ -1277,9 +1343,12 @@
 changequote(,)dnl
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_snprintf_retval_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_snprintf_retval_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_snprintf_retval_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_snprintf_retval_c99="guessing no";;
            darwin*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
@@ -1299,6 +1368,8 @@
            netbsd*)              gl_cv_func_snprintf_retval_c99="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_snprintf_retval_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_snprintf_retval_c99="guessing yes";;
 changequote(,)dnl
                                  # Guess yes on MSVC, no on mingw.
            mingw*)               AC_EGREP_CPP(Known, 
@@ -1309,8 +1380,8 @@
                                    gl_cv_func_snprintf_retval_c99="guessing yes",
                                    gl_cv_func_snprintf_retval_c99="guessing no")
                                  ;;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_snprintf_retval_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_snprintf_retval_c99="$gl_cross_guess_normal";;
          esac
         )
     )
@@ -1363,13 +1434,24 @@
         gl_cv_func_snprintf_directive_n=yes,
         gl_cv_func_snprintf_directive_n=no,
         
-changequote(,)dnl
          case "$host_os" in
-                                 # Guess yes on glibc systems.
-           *-gnu* | gnu*)        gl_cv_func_snprintf_directive_n="guessing yes";;
+                                 # Guess no on glibc when _FORTIFY_SOURCE >= 2.
+           *-gnu* | gnu*)        AC_COMPILE_IFELSE(
+                                   AC_LANG_SOURCE(
+                                      #if _FORTIFY_SOURCE >= 2
+                                         error fail
+                                        #endif
+                                      ),
+                                   gl_cv_func_snprintf_directive_n="guessing yes",
+                                   gl_cv_func_snprintf_directive_n="guessing no")
+                                 ;;
+changequote(,)dnl
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_snprintf_directive_n="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_snprintf_directive_n="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_snprintf_directive_n="guessing yes";;
+           midnightbsd*)         gl_cv_func_snprintf_directive_n="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_snprintf_directive_n="guessing no";;
            darwin*)              gl_cv_func_snprintf_directive_n="guessing yes";;
@@ -1391,12 +1473,14 @@
            netbsd*)              gl_cv_func_snprintf_directive_n="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_snprintf_directive_n="guessing yes";;
+                                 # Guess no on Android.
+           linux*-android*)      gl_cv_func_snprintf_directive_n="guessing no";;
                                  # Guess no on native Windows.
            mingw*)               gl_cv_func_snprintf_directive_n="guessing no";;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_snprintf_directive_n="guessing no";;
-         esac
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_snprintf_directive_n="$gl_cross_guess_normal";;
 changequote(,)dnl
+         esac
         )
     )
 )
@@ -1440,9 +1524,11 @@
         gl_cv_func_snprintf_size1=yes,
         gl_cv_func_snprintf_size1=no,
         case "$host_os" in
-                   # Guess yes on native Windows.
-           mingw*) gl_cv_func_snprintf_size1="guessing yes" ;;
-           *)      gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on Android.
+           linux*-android*) gl_cv_func_snprintf_size1="guessing yes" ;;
+                            # Guess yes on native Windows.
+           mingw*)          gl_cv_func_snprintf_size1="guessing yes" ;;
+           *)               gl_cv_func_snprintf_size1="guessing yes" ;;
          esac
         )
     )
@@ -1517,9 +1603,12 @@
          case "$host_os" in
                                  # Guess yes on glibc systems.
            *-gnu* | gnu*)        gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
+                                 # Guess yes on musl systems.
+           *-musl*)              gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
                                  # Guess yes on FreeBSD >= 5.
            freebsd1-4.*)       gl_cv_func_vsnprintf_zerosize_c99="guessing no";;
            freebsd* | kfreebsd*) gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
+           midnightbsd*)         gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
                                  # Guess yes on Mac OS X >= 10.3.
            darwin1-6.*)        gl_cv_func_vsnprintf_zerosize_c99="guessing no";;
            darwin*)              gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
@@ -1540,10 +1629,12 @@
            netbsd*)              gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
                                  # Guess yes on BeOS.
            beos*)                gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
+                                 # Guess yes on Android.
+           linux*-android*)      gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
                                  # Guess yes on native Windows.
            mingw* | pw*)         gl_cv_func_vsnprintf_zerosize_c99="guessing yes";;
-                                 # If we don't know, assume the worst.
-           *)                    gl_cv_func_vsnprintf_zerosize_c99="guessing no";;
+                                 # If we don't know, obey --enable-cross-guesses.
+           *)                    gl_cv_func_vsnprintf_zerosize_c99="$gl_cross_guess_normal";;
          esac
 changequote(,)dnl
         )
@@ -1599,13 +1690,17 @@
 dnl                                  1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20
 dnl   glibc 2.5                      .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 dnl   glibc 2.3.6                    .  .  .  .  #  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
+dnl   FreeBSD 13.0                   .  .  .  .  #  .  .  .  .  .  .  .  .  #  .  .  .  .  .  .
 dnl   FreeBSD 5.4, 6.1               .  .  .  .  #  .  .  .  .  .  .  #  .  #  .  .  .  .  .  .
+dnl   Mac OS X 10.13.5               .  .  .  #  #  .  #  .  .  .  .  .  .  .  .  .  .  #  .  .
 dnl   Mac OS X 10.5.8                .  .  .  #  #  .  .  .  .  .  .  #  .  .  .  .  .  .  .  .
 dnl   Mac OS X 10.3.9                .  .  .  .  #  .  .  .  .  .  .  #  .  #  .  .  .  .  .  .
+dnl   OpenBSD 6.0, 6.7               .  .  .  .  #  .  .  .  .  .  .  .  .  #  .  .  .  .  .  .
 dnl   OpenBSD 3.9, 4.0               .  .  #  #  #  #  .  #  .  #  .  #  .  #  .  .  .  .  .  .
 dnl   Cygwin 1.7.0 (2009)            .  .  .  #  .  .  .  ?  .  .  .  .  .  ?  .  .  .  .  .  .
 dnl   Cygwin 1.5.25 (2008)           .  .  .  #  #  .  .  #  .  .  .  .  .  #  .  .  .  .  .  .
 dnl   Cygwin 1.5.19 (2006)           #  .  .  #  #  #  .  #  .  #  .  #  #  #  .  .  .  .  .  .
+dnl   Solaris 11.4                   .  .  #  #  #  .  .  #  .  .  .  #  .  .  .  .  .  .  .  .
 dnl   Solaris 11.3                   .  .  .  .  #  .  .  #  .  .  .  .  .  .  .  .  .  .  .  .
 dnl   Solaris 11.0                   .  .  #  #  #  .  .  #  .  .  .  #  .  .  .  .  .  .  .  .
 dnl   Solaris 10                     .  .  #  #  #  .  .  #  .  .  .  #  #  .  .  .  .  .  .  .
@@ -1620,11 +1715,13 @@
 dnl   IRIX 6.5                       #  .  #  #  #  #  .  #  .  .  .  #  .  .  .  .  #  .  .  .
 dnl   OSF/1 5.1                      #  .  #  #  #  #  .  .  .  .  .  #  .  .  .  .  #  .  .  #
 dnl   OSF/1 4.0d                     #  .  #  #  #  #  .  .  .  .  .  #  .  .  #  #  #  #  #  #
+dnl   NetBSD 9.0                     .  .  .  .  #  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 dnl   NetBSD 5.0                     .  .  .  #  #  .  .  .  .  .  .  #  .  #  .  .  .  .  .  .
 dnl   NetBSD 4.0                     .  ?  ?  ?  ?  ?  .  ?  .  ?  ?  ?  ?  ?  .  .  .  ?  ?  ?
 dnl   NetBSD 3.0                     .  .  .  .  #  #  .  ?  #  #  ?  #  .  #  .  .  .  .  .  .
 dnl   Haiku                          .  .  .  #  #  #  .  #  .  .  .  .  .  ?  .  .  ?  .  .  .
 dnl   BeOS                           #  #  .  #  #  #  .  ?  #  .  ?  .  #  ?  .  .  ?  .  .  .
+dnl   Android 4.3                    .  .  #  #  #  #  #  #  .  #  .  #  .  #  .  .  .  #  .  .
 dnl   old mingw / msvcrt             #  #  #  #  #  #  .  .  #  #  .  #  #  ?  .  #  #  #  .  .
 dnl   MSVC 9                         #  #  #  #  #  #  #  .  #  #  .  #  #  ?  #  #  #  #  .  .
 dnl   mingw 2009-2011                .  #  .  #  .  .  .  .  #  #  .  .  .  ?  .  .  .  .  .  .

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/signbit.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/signbit.m4 Changed

@@ -1,5 +1,5 @@
-# signbit.m4 serial 16
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# signbit.m4 serial 20
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -7,7 +7,7 @@
 AC_DEFUN(gl_SIGNBIT,
 
   AC_REQUIRE(gl_MATH_H_DEFAULTS)
-  AC_REQUIRE(AC_CANONICAL_HOST) dnl for cross-compiles
+  AC_REQUIRE(AC_CANONICAL_HOST)
   AC_CACHE_CHECK(for signbit macro, gl_cv_func_signbit,
     
       AC_RUN_IFELSE(
@@ -31,22 +31,25 @@
         case "$host_os" in
                           # Guess yes on glibc systems.
            *-gnu* | gnu*) gl_cv_func_signbit="guessing yes" ;;
+                          # Guess yes on musl systems.
+           *-musl*)       gl_cv_func_signbit="guessing yes" ;;
                           # Guess yes on native Windows.
            mingw*)        gl_cv_func_signbit="guessing yes" ;;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_signbit="guessing no" ;;
+                          # If we don't know, obey --enable-cross-guesses.
+           *)             gl_cv_func_signbit="$gl_cross_guess_normal" ;;
          esac
         )
     )
-  dnl GCC 4.0 and newer provides three built-ins for signbit.
+  dnl GCC >= 4.0 and clang provide three built-ins for signbit.
   dnl They can be used without warnings, also in C++, regardless of <math.h>.
   dnl But they may expand to calls to functions, which may or may not be in
   dnl libc.
-  AC_CACHE_CHECK(for signbit compiler built-ins, gl_cv_func_signbit_gcc,
+  AC_CACHE_CHECK(for signbit compiler built-ins,
+    gl_cv_func_signbit_builtins,
     
       AC_RUN_IFELSE(
         AC_LANG_SOURCE(
-#if __GNUC__ >= 4
+#if (__GNUC__ >= 4) || (__clang_major__ >= 4)
 # define signbit(x) \
    (sizeof (x) == sizeof (long double) ? __builtin_signbitl (x) : \
     sizeof (x) == sizeof (double) ? __builtin_signbit (x) : \
@@ -57,28 +60,30 @@
 #include <string.h>
 gl_SIGNBIT_TEST_PROGRAM
 ),
-        gl_cv_func_signbit_gcc=yes,
-        gl_cv_func_signbit_gcc=no,
+        gl_cv_func_signbit_builtins=yes,
+        gl_cv_func_signbit_builtins=no,
         case "$host_os" in
                           # Guess yes on glibc systems.
-           *-gnu* | gnu*) gl_cv_func_signbit_gcc="guessing yes" ;;
+           *-gnu* | gnu*) gl_cv_func_signbit_builtins="guessing yes" ;;
+                          # Guess yes on musl systems.
+           *-musl*)       gl_cv_func_signbit_builtins="guessing yes" ;;
                           # Guess yes on mingw, no on MSVC.
            mingw*)        if test -n "$GCC"; then
-                            gl_cv_func_signbit_gcc="guessing yes"
+                            gl_cv_func_signbit_builtins="guessing yes"
                           else
-                            gl_cv_func_signbit_gcc="guessing no"
+                            gl_cv_func_signbit_builtins="guessing no"
                           fi
                           ;;
-                          # If we don't know, assume the worst.
-           *)             gl_cv_func_signbit_gcc="guessing no" ;;
+                          # If we don't know, obey --enable-cross-guesses.
+           *)             gl_cv_func_signbit_builtins="$gl_cross_guess_normal" ;;
          esac
         )
     )
   dnl Use the compiler built-ins whenever possible, because they are more
   dnl efficient than the system library functions (if they exist).
-  case "$gl_cv_func_signbit_gcc" in
+  case "$gl_cv_func_signbit_builtins" in
     *yes)
-      REPLACE_SIGNBIT_USING_GCC=1
+      REPLACE_SIGNBIT_USING_BUILTINS=1
       ;;
     *)
       case "$gl_cv_func_signbit" in
@@ -86,79 +91,90 @@
         *)
           dnl REPLACE_SIGNBIT=1 makes sure the signbitfdl functions get built.
           REPLACE_SIGNBIT=1
-          gl_FLOAT_SIGN_LOCATION
-          gl_DOUBLE_SIGN_LOCATION
-          gl_LONG_DOUBLE_SIGN_LOCATION
-          if test "$gl_cv_cc_float_signbit" = unknown; then
-            dnl Test whether copysignf() is declared.
-            AC_CHECK_DECLS(copysignf, , , #include <math.h>)
-            if test "$ac_cv_have_decl_copysignf" = yes; then
-              dnl Test whether copysignf() can be used without libm.
-              AC_CACHE_CHECK(whether copysignf can be used without linking with libm,
-                gl_cv_func_copysignf_no_libm,
-                
-                  AC_LINK_IFELSE(
-                    AC_LANG_PROGRAM(
-                       #include <math.h>
-                         float x, y;,
-                       return copysignf (x, y) < 0;),
-                    gl_cv_func_copysignf_no_libm=yes,
-                    gl_cv_func_copysignf_no_libm=no)
-                )
-              if test $gl_cv_func_copysignf_no_libm = yes; then
-                AC_DEFINE(HAVE_COPYSIGNF_IN_LIBC, 1,
-                  Define if the copysignf function is declared in <math.h> and available in libc.)
-              fi
-            fi
-          fi
-          if test "$gl_cv_cc_double_signbit" = unknown; then
-            dnl Test whether copysign() is declared.
-            AC_CHECK_DECLS(copysign, , , #include <math.h>)
-            if test "$ac_cv_have_decl_copysign" = yes; then
-              dnl Test whether copysign() can be used without libm.
-              AC_CACHE_CHECK(whether copysign can be used without linking with libm,
-                gl_cv_func_copysign_no_libm,
-                
-                  AC_LINK_IFELSE(
-                    AC_LANG_PROGRAM(
-                       #include <math.h>
-                         double x, y;,
-                       return copysign (x, y) < 0;),
-                    gl_cv_func_copysign_no_libm=yes,
-                    gl_cv_func_copysign_no_libm=no)
-                )
-              if test $gl_cv_func_copysign_no_libm = yes; then
-                AC_DEFINE(HAVE_COPYSIGN_IN_LIBC, 1,
-                  Define if the copysign function is declared in <math.h> and available in libc.)
-              fi
-            fi
-          fi
-          if test "$gl_cv_cc_long_double_signbit" = unknown; then
-            dnl Test whether copysignl() is declared.
-            AC_CHECK_DECLS(copysignl, , , #include <math.h>)
-            if test "$ac_cv_have_decl_copysignl" = yes; then
-              dnl Test whether copysignl() can be used without libm.
-              AC_CACHE_CHECK(whether copysignl can be used without linking with libm,
-                gl_cv_func_copysignl_no_libm,
-                
-                  AC_LINK_IFELSE(
-                    AC_LANG_PROGRAM(
-                       #include <math.h>
-                         long double x, y;,
-                       return copysignl (x, y) < 0;),
-                    gl_cv_func_copysignl_no_libm=yes,
-                    gl_cv_func_copysignl_no_libm=no)
-                )
-              if test $gl_cv_func_copysignl_no_libm = yes; then
-                AC_DEFINE(HAVE_COPYSIGNL_IN_LIBC, 1,
-                  Define if the copysignl function is declared in <math.h> and available in libc.)
-              fi
-            fi
-          fi
           ;;
       esac
       ;;
   esac
+  dnl On Solaris 10, with CC in C++ mode, signbit is not available although
+  dnl is with cc in C mode. This cannot be worked around by defining
+  dnl _XOPEN_SOURCE=600, because the latter does not work in C++ mode on
+  dnl Solaris 11.0. Therefore use the replacement functions on Solaris.
+  case "$host_os" in
+    solaris*)
+      REPLACE_SIGNBIT=1
+      ;;
+  esac
+  if test $REPLACE_SIGNBIT = 1; then
+    gl_FLOAT_SIGN_LOCATION
+    gl_DOUBLE_SIGN_LOCATION
+    gl_LONG_DOUBLE_SIGN_LOCATION
+    if test "$gl_cv_cc_float_signbit" = unknown; then
+      dnl Test whether copysignf() is declared.
+      AC_CHECK_DECLS(copysignf, , , #include <math.h>)
+      if test "$ac_cv_have_decl_copysignf" = yes; then
+        dnl Test whether copysignf() can be used without libm.
+        AC_CACHE_CHECK(whether copysignf can be used without linking with libm,
+          gl_cv_func_copysignf_no_libm,
+          
+            AC_LINK_IFELSE(
+              AC_LANG_PROGRAM(
+                 #include <math.h>
+                   float x, y;,
+                 return copysignf (x, y) < 0;),
+              gl_cv_func_copysignf_no_libm=yes,
+              gl_cv_func_copysignf_no_libm=no)
+          )
+        if test $gl_cv_func_copysignf_no_libm = yes; then
+          AC_DEFINE(HAVE_COPYSIGNF_IN_LIBC, 1,
+            Define if the copysignf function is declared in <math.h> and available in libc.)
+        fi
+      fi
+    fi
+    if test "$gl_cv_cc_double_signbit" = unknown; then
+      dnl Test whether copysign() is declared.
+      AC_CHECK_DECLS(copysign, , , #include <math.h>)
+      if test "$ac_cv_have_decl_copysign" = yes; then
+        dnl Test whether copysign() can be used without libm.
+        AC_CACHE_CHECK(whether copysign can be used without linking with libm,
+          gl_cv_func_copysign_no_libm,
+          
+            AC_LINK_IFELSE(
+              AC_LANG_PROGRAM(
+                 #include <math.h>
+                   double x, y;,
+                 return copysign (x, y) < 0;),
+              gl_cv_func_copysign_no_libm=yes,
+              gl_cv_func_copysign_no_libm=no)
+          )
+        if test $gl_cv_func_copysign_no_libm = yes; then
+          AC_DEFINE(HAVE_COPYSIGN_IN_LIBC, 1,
+            Define if the copysign function is declared in <math.h> and available in libc.)
+        fi
+      fi
+    fi
+    if test "$gl_cv_cc_long_double_signbit" = unknown; then
+      dnl Test whether copysignl() is declared.
+      AC_CHECK_DECLS(copysignl, , , #include <math.h>)
+      if test "$ac_cv_have_decl_copysignl" = yes; then
+        dnl Test whether copysignl() can be used without libm.
+        AC_CACHE_CHECK(whether copysignl can be used without linking with libm,
+          gl_cv_func_copysignl_no_libm,
+          
+            AC_LINK_IFELSE(
+              AC_LANG_PROGRAM(
+                 #include <math.h>
+                   long double x, y;,
+                 return copysignl (x, y) < 0;),
+              gl_cv_func_copysignl_no_libm=yes,
+              gl_cv_func_copysignl_no_libm=no)
+          )
+        if test $gl_cv_func_copysignl_no_libm = yes; then
+          AC_DEFINE(HAVE_COPYSIGNL_IN_LIBC, 1,
+            Define if the copysignl function is declared in <math.h> and available in libc.)
+        fi
+      fi
+    fi
+  fi
 )
 
 AC_DEFUN(gl_SIGNBIT_TEST_PROGRAM,

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/size_max.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/size_max.m4 Changed

@@ -1,17 +1,19 @@
-# size_max.m4 serial 10
-dnl Copyright (C) 2003, 2005-2006, 2008-2018 Free Software Foundation, Inc.
+# size_max.m4 serial 12
+dnl Copyright (C) 2003, 2005-2006, 2008-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 dnl From Bruno Haible.
 
+AC_PREREQ(2.61)
+
 AC_DEFUN(gl_SIZE_MAX,
 
   AC_CHECK_HEADERS(stdint.h)
   dnl First test whether the system already has SIZE_MAX.
   AC_CACHE_CHECK(for SIZE_MAX, gl_cv_size_max, 
-    gl_cv_size_max=
+    gl_cv_size_max=no
     AC_EGREP_CPP(Found it, 
 #include <limits.h>
 #if HAVE_STDINT_H
@@ -21,7 +23,7 @@
 Found it
 #endif
 , gl_cv_size_max=yes)
-    if test -z "$gl_cv_size_max"; then
+    if test $gl_cv_size_max != yes; then
       dnl Define it ourselves. Here we assume that the type 'size_t' is not wider
       dnl than the type 'unsigned long'. Try hard to find a definition that can
       dnl be used in a preprocessor #if, i.e. doesn't contain a cast.
@@ -71,9 +73,3 @@
 # undef SIZE_MAX
 #endif)
 )
-
-dnl Autoconf >= 2.61 has AC_COMPUTE_INT built-in.
-dnl Remove this when we can assume autoconf >= 2.61.
-m4_ifdef(AC_COMPUTE_INT, , 
-  AC_DEFUN(AC_COMPUTE_INT, _AC_COMPUTE_INT($2,$1,$3,$4))
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/snprintf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/snprintf.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/ssize_t.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/ssize_t.m4 Changed

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stdbool.m4 Added

@@ -0,0 +1,118 @@
+# Check for stdbool.h that conforms to C99.
+
+dnl Copyright (C) 2002-2006, 2009-2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+#serial 10
+
+# Prepare for substituting <stdbool.h> if it is not supported.
+
+AC_DEFUN(gl_STDBOOL_H,
+
+  AC_REQUIRE(AC_CHECK_HEADER_STDBOOL)
+  AC_REQUIRE(AC_CANONICAL_HOST)
+
+  dnl On some platforms, <stdbool.h> does not exist or does not conform to C99.
+  dnl On Solaris 10 with CC=cc CXX=CC, <stdbool.h> exists but is not usable
+  dnl in C++ mode (and no <cstdbool> exists). In this case, we use our
+  dnl replacement, also in C mode (for binary compatibility between C and C++).
+  if test "$ac_cv_header_stdbool_h" = yes; then
+    case "$host_os" in
+      solaris*)
+        if test -z "$GCC"; then
+          GL_GENERATE_STDBOOL_H=true
+        else
+          GL_GENERATE_STDBOOL_H=false
+        fi
+        ;;
+      *)
+        GL_GENERATE_STDBOOL_H=false
+        ;;
+    esac
+  else
+    GL_GENERATE_STDBOOL_H=true
+  fi
+
+  if test "$ac_cv_type__Bool" = yes; then
+    HAVE__BOOL=1
+  else
+    HAVE__BOOL=0
+  fi
+  AC_SUBST(HAVE__BOOL)
+)
+
+m4_version_prereq(2.72, , 
+
+AC_DEFUN(AC_CHECK_HEADER_STDBOOL,
+  AC_CHECK_TYPES(_Bool)
+   AC_CACHE_CHECK(for stdbool.h that conforms to C99 or later,
+     ac_cv_header_stdbool_h,
+     AC_COMPILE_IFELSE(
+        AC_LANG_PROGRAM(
+           #include <stdbool.h>
+
+             /* "true" and "false" should be usable in #if expressions and
+                integer constant expressions, and "bool" should be a valid
+                type name.
+
+                Although C99 requires bool, true, and false to be macros,
+                C23 and C++11 overrule that, so do not test for that.
+                Although C99 requires __bool_true_false_are_defined and
+                _Bool, C23 says they are obsolescent, so do not require
+                them.  */
+
+             #if !true
+               #error "'true' is not true"
+             #endif
+             #if true != 1
+               #error "'true' is not equal to 1"
+             #endif
+             char btrue == 1 ? 1 : -1;
+             char ctrue;
+
+             #if false
+               #error "'false' is not false"
+             #endif
+             #if false != 0
+               #error "'false' is not equal to 0"
+             #endif
+             char dfalse == 0 ? 1 : -1;
+
+             enum { e = false, f = true, g = false * true, h = true * 256 };
+
+             char i(bool) 0.5 == true ? 1 : -1;
+             char j(bool) 0.0 == false ? 1 : -1;
+             char ksizeof (bool) > 0 ? 1 : -1;
+
+             struct sb { bool s: 1; bool t; } s;
+             char lsizeof s.t > 0 ? 1 : -1;
+
+             /* The following fails for
+                HP aC++/ANSI C B3910B A.05.55 Dec 04 2003. */
+             bool mh;
+             char nsizeof m == h * sizeof m0 ? 1 : -1;
+             char o-1 - (bool) 0 < 0 ? 1 : -1;
+             /* Catch a bug in an HP-UX C compiler.  See
+                https://gcc.gnu.org/ml/gcc-patches/2003-12/msg02303.html
+                https://lists.gnu.org/r/bug-coreutils/2005-11/msg00161.html
+              */
+             bool p = true;
+             bool *pp = &p;
+           ,
+           
+             bool ps = &s;
+             *pp |= p;
+             *pp |= ! p;
+
+             /* Refer to every declared value, so they cannot be
+                discarded as unused.  */
+             return (!b + !c + !d + !e + !f + !g + !h + !i + !j + !k
+                     + !l + !m + !n + !o + !p + !pp + !ps);
+           ),
+        ac_cv_header_stdbool_h=yes,
+        ac_cv_header_stdbool_h=no))
+)# AC_CHECK_HEADER_STDBOOL
+
+) # m4_version_prereq 2.72

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/stddef_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stddef_h.m4 Changed

@@ -1,15 +1,20 @@
-dnl A placeholder for <stddef.h>, for platforms that have issues.
-# stddef_h.m4 serial 6
-dnl Copyright (C) 2009-2018 Free Software Foundation, Inc.
+# stddef_h.m4 serial 13
+dnl Copyright (C) 2009-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
-AC_DEFUN(gl_STDDEF_H,
+dnl A placeholder for <stddef.h>, for platforms that have issues.
+
+AC_DEFUN_ONCE(gl_STDDEF_H,
 
   AC_REQUIRE(gl_STDDEF_H_DEFAULTS)
   AC_REQUIRE(gt_TYPE_WCHAR_T)
-  STDDEF_H=
+
+  dnl Persuade OpenBSD <stddef.h> to declare max_align_t.
+  AC_REQUIRE(gl_USE_SYSTEM_EXTENSIONS)
+
+  GL_GENERATE_STDDEF_H=false
 
   dnl Test whether the type max_align_t exists and whether its alignment
   dnl "is as great as is supported by the implementation in all contexts".
@@ -17,24 +22,38 @@
     gl_cv_type_max_align_t,
     AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
-          #include <stddef.h>
+          /* On FreeBSD 12.0/x86, max_align_t defined by <stddef.h> has
+               the correct alignment with the default (wrong) definition of
+               _Alignof, but a wrong alignment as soon as we activate an
+               ISO C compliant _Alignof definition.  */
+            #if ((defined __GNUC__ && 4 <= __GNUC__) || defined __clang__) && !defined __cplusplus
+             #define _Alignof(type) __builtin_offsetof (struct { char __a; type __b; }, __b)
+            #endif
+            #include <stddef.h>
             unsigned int s = sizeof (max_align_t);
-            #if defined __GNUC__ || defined __IBM__ALIGNOF__
+            #if defined __GNUC__ || defined __clang__ || defined __IBM__ALIGNOF__
             int check12 * (__alignof__ (double) <= __alignof__ (max_align_t)) - 1;
             int check22 * (__alignof__ (long double) <= __alignof__ (max_align_t)) - 1;
             #endif
+            typedef struct { char a; max_align_t b; } max_helper;
+            typedef struct { char a; long b; } long_helper;
+            typedef struct { char a; double b; } double_helper;
+            typedef struct { char a; long double b; } long_double_helper;
+            int check32 * (offsetof (long_helper, b) <= offsetof (max_helper, b)) - 1;
+            int check42 * (offsetof (double_helper, b) <= offsetof (max_helper, b)) - 1;
+            int check52 * (offsetof (long_double_helper, b) <= offsetof (max_helper, b)) - 1;
           ),
        gl_cv_type_max_align_t=yes,
        gl_cv_type_max_align_t=no)
     )
   if test $gl_cv_type_max_align_t = no; then
     HAVE_MAX_ALIGN_T=0
-    STDDEF_H=stddef.h
+    GL_GENERATE_STDDEF_H=true
   fi
 
   if test $gt_cv_c_wchar_t = no; then
     HAVE_WCHAR_T=0
-    STDDEF_H=stddef.h
+    GL_GENERATE_STDDEF_H=true
   fi
 
   AC_CACHE_CHECK(whether NULL can be used in arbitrary expressions,
@@ -46,23 +65,36 @@
       gl_cv_decl_null_works=no))
   if test $gl_cv_decl_null_works = no; then
     REPLACE_NULL=1
-    STDDEF_H=stddef.h
+    GL_GENERATE_STDDEF_H=true
   fi
 
-  AC_SUBST(STDDEF_H)
-  AM_CONDITIONAL(GL_GENERATE_STDDEF_H, test -n "$STDDEF_H")
-  if test -n "$STDDEF_H"; then
+  if $GL_GENERATE_STDDEF_H; then
     gl_NEXT_HEADERS(stddef.h)
   fi
 )
 
+# gl_STDDEF_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_STDDEF_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_STDDEF_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_STDDEF_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_STDDEF_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_STDDEF_H_MODULE_INDICATOR_DEFAULTS, 
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_STDDEF_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_STDDEF_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_STDDEF_H_DEFAULTS,
 
   dnl Assume proper GNU behavior unless another module says otherwise.

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/stdint.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stdint.m4 Changed

@@ -1,5 +1,5 @@
-# stdint.m4 serial 52
-dnl Copyright (C) 2001-2018 Free Software Foundation, Inc.
+# stdint.m4 serial 61
+dnl Copyright (C) 2001-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -7,6 +7,8 @@
 dnl From Paul Eggert and Bruno Haible.
 dnl Test whether <stdint.h> is supported or must be substituted.
 
+AC_PREREQ(2.61)
+
 AC_DEFUN_ONCE(gl_STDINT_H,
 
   AC_PREREQ(2.59)dnl
@@ -15,21 +17,12 @@
   AC_REQUIRE(gl_LIMITS_H)
   AC_REQUIRE(gt_TYPE_WINT_T)
 
-  dnl Check for long long int and unsigned long long int.
-  AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
-  if test $ac_cv_type_long_long_int = yes; then
-    HAVE_LONG_LONG_INT=1
-  else
-    HAVE_LONG_LONG_INT=0
-  fi
-  AC_SUBST(HAVE_LONG_LONG_INT)
-  AC_REQUIRE(AC_TYPE_UNSIGNED_LONG_LONG_INT)
-  if test $ac_cv_type_unsigned_long_long_int = yes; then
-    HAVE_UNSIGNED_LONG_LONG_INT=1
-  else
-    HAVE_UNSIGNED_LONG_LONG_INT=0
-  fi
-  AC_SUBST(HAVE_UNSIGNED_LONG_LONG_INT)
+  dnl For backward compatibility. Some packages may still be testing these
+  dnl macros.
+  AC_DEFINE(HAVE_LONG_LONG_INT, 1,
+    Define to 1 if the system has the type 'long long int'.)
+  AC_DEFINE(HAVE_UNSIGNED_LONG_LONG_INT, 1,
+    Define to 1 if the system has the type 'unsigned long long int'.)
 
   dnl Check for <wchar.h>, in the same way as gl_WCHAR_H does.
   AC_CHECK_HEADERS_ONCE(wchar.h)
@@ -41,7 +34,7 @@
   AC_SUBST(HAVE_WCHAR_H)
 
   dnl Check for <inttypes.h>.
-  dnl AC_INCLUDES_DEFAULT defines $ac_cv_header_inttypes_h.
+  AC_CHECK_HEADERS_ONCE(inttypes.h)
   if test $ac_cv_header_inttypes_h = yes; then
     HAVE_INTTYPES_H=1
   else
@@ -50,7 +43,7 @@
   AC_SUBST(HAVE_INTTYPES_H)
 
   dnl Check for <sys/types.h>.
-  dnl AC_INCLUDES_DEFAULT defines $ac_cv_header_sys_types_h.
+  AC_CHECK_HEADERS_ONCE(sys/types.h)
   if test $ac_cv_header_sys_types_h = yes; then
     HAVE_SYS_TYPES_H=1
   else
@@ -159,7 +152,7 @@
 /* Check that SIZE_MAX has the correct type, if possible.  */
 #if 201112 <= __STDC_VERSION__
 int k = _Generic (SIZE_MAX, size_t: 0);
-#elif (2 <= __GNUC__ || defined __IBM__TYPEOF__ \
+#elif (2 <= __GNUC__ || 4 <= __clang_major__ || defined __IBM__TYPEOF__ \
        || (0x5110 <= __SUNPRO_C && !__STDC__))
 extern size_t k;
 extern __typeof__ (SIZE_MAX) k;
@@ -177,7 +170,7 @@
       PTRDIFF_MIN == TYPE_MINIMUM (ptrdiff_t)
       && PTRDIFF_MAX == TYPE_MAXIMUM (ptrdiff_t)
       ? 1 : -1;
-  /* Detect bug in FreeBSD 6.0 / ia64.  */
+  /* Detect bug in FreeBSD 6.0/ia64 and FreeBSD 13.0/arm64.  */
   int check_SIG_ATOMIC:
       SIG_ATOMIC_MIN == TYPE_MINIMUM (sig_atomic_t)
       && SIG_ATOMIC_MAX == TYPE_MAXIMUM (sig_atomic_t)
@@ -303,15 +296,16 @@
   HAVE_C99_STDINT_H=0
   HAVE_SYS_BITYPES_H=0
   HAVE_SYS_INTTYPES_H=0
-  STDINT_H=stdint.h
+  GL_GENERATE_STDINT_H=true
   case "$gl_cv_header_working_stdint_h" in
     *yes)
       HAVE_C99_STDINT_H=1
       dnl Now see whether the system <stdint.h> works without
       dnl __STDC_CONSTANT_MACROS/__STDC_LIMIT_MACROS defined.
-      AC_CACHE_CHECK(whether stdint.h predates C++11,
-        gl_cv_header_stdint_predates_cxx11_h,
-        gl_cv_header_stdint_predates_cxx11_h=yes
+      dnl If not, there would be problems when stdint.h is included from C++.
+      AC_CACHE_CHECK(whether stdint.h works without ISO C predefines,
+        gl_cv_header_stdint_without_STDC_macros,
+        gl_cv_header_stdint_without_STDC_macros=no
          AC_COMPILE_IFELSE(
            AC_LANG_PROGRAM(
 #define _GL_JUST_INCLUDE_SYSTEM_STDINT_H 1 /* work if build isn't clean */
@@ -322,13 +316,14 @@
 intmax_t im = INTMAX_MAX;
 int32_t i32 = INT32_C (0x7fffffff);
            ),
-           gl_cv_header_stdint_predates_cxx11_h=no))
+           gl_cv_header_stdint_without_STDC_macros=yes)
+        )
 
-      if test "$gl_cv_header_stdint_predates_cxx11_h" = yes; then
+      if test $gl_cv_header_stdint_without_STDC_macros = no; then
         AC_DEFINE(__STDC_CONSTANT_MACROS, 1,
-                  Define to 1 if the system <stdint.h> predates C++11.)
+          Define to 1 if the system <stdint.h> predates C++11.)
         AC_DEFINE(__STDC_LIMIT_MACROS, 1,
-                  Define to 1 if the system <stdint.h> predates C++11.)
+          Define to 1 if the system <stdint.h> predates C++11.)
       fi
       AC_CACHE_CHECK(whether stdint.h has UINTMAX_WIDTH etc.,
         gl_cv_header_stdint_width,
@@ -346,7 +341,7 @@
               ),
            gl_cv_header_stdint_width=yes))
       if test "$gl_cv_header_stdint_width" = yes; then
-        STDINT_H=
+        GL_GENERATE_STDINT_H=false
       fi
       ;;
     *)
@@ -369,8 +364,6 @@
   AC_SUBST(HAVE_C99_STDINT_H)
   AC_SUBST(HAVE_SYS_BITYPES_H)
   AC_SUBST(HAVE_SYS_INTTYPES_H)
-  AC_SUBST(STDINT_H)
-  AM_CONDITIONAL(GL_GENERATE_STDINT_H, test -n "$STDINT_H")
 )
 
 dnl gl_STDINT_BITSIZEOF(TYPES, INCLUDES)
@@ -498,13 +491,9 @@
 dnl gl_STDINT_INCLUDES
 AC_DEFUN(gl_STDINT_INCLUDES,
 
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
   #include <stddef.h>
   #include <signal.h>
   #if HAVE_WCHAR_H
-  # include <stdio.h>
-  # include <time.h>
   # include <wchar.h>
   #endif
 )
@@ -536,13 +525,7 @@
   dnl requirement that wint_t is "unchanged by default argument promotions".
   dnl In this case gnulib's <wchar.h> and <wctype.h> override wint_t.
   dnl Set the variable BITSIZEOF_WINT_T accordingly.
-  if test $GNULIB_OVERRIDES_WINT_T = 1; then
+  if test $GNULIBHEADERS_OVERRIDE_WINT_T = 1; then
     BITSIZEOF_WINT_T=32
   fi
 )
-
-dnl Autoconf >= 2.61 has AC_COMPUTE_INT built-in.
-dnl Remove this when we can assume autoconf >= 2.61.
-m4_ifdef(AC_COMPUTE_INT, , 
-  AC_DEFUN(AC_COMPUTE_INT, _AC_COMPUTE_INT($2,$1,$3,$4))
-)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/stdint_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stdint_h.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/stdio_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stdio_h.m4 Changed

@@ -1,11 +1,12 @@
-# stdio_h.m4 serial 49
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# stdio_h.m4 serial 61
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
-AC_DEFUN(gl_STDIO_H,
+AC_DEFUN_ONCE(gl_STDIO_H,
 
+  AC_REQUIRE(gl_STDIO_H_DEFAULTS)
   AH_VERBATIM(MINGW_ANSI_STDIO,
 /* Use GNU style printf and scanf.  */
 #ifndef __USE_MINGW_ANSI_STDIO
@@ -13,7 +14,6 @@
 #endif
 )
   AC_DEFINE(__USE_MINGW_ANSI_STDIO)
-  AC_REQUIRE(gl_STDIO_H_DEFAULTS)
   gl_NEXT_HEADERS(stdio.h)
 
   dnl Determine whether __USE_MINGW_ANSI_STDIO makes printf and
@@ -40,64 +40,32 @@
        attribute "__gnu_printf__" instead of "__printf__")
   fi
 
-  dnl No need to create extra modules for these functions. Everyone who uses
-  dnl <stdio.h> likely needs them.
-  GNULIB_FSCANF=1
-  gl_MODULE_INDICATOR(fscanf)
-  GNULIB_SCANF=1
-  gl_MODULE_INDICATOR(scanf)
-  GNULIB_FGETC=1
-  GNULIB_GETC=1
-  GNULIB_GETCHAR=1
-  GNULIB_FGETS=1
-  GNULIB_FREAD=1
-  dnl This ifdef is necessary to avoid an error "missing file lib/stdio-read.c"
-  dnl "expected source file, required through AC_LIBSOURCES, not found". It is
-  dnl also an optimization, to avoid performing a configure check whose result
-  dnl is not used. But it does not make the test of GNULIB_STDIO_H_NONBLOCKING
-  dnl or GNULIB_NONBLOCKING redundant.
+  dnl This ifdef is an optimization, to avoid performing a configure check whose
+  dnl result is not used. But it does not make the test of
+  dnl GNULIB_STDIO_H_NONBLOCKING or GNULIB_NONBLOCKING redundant.
   m4_ifdef(gl_NONBLOCKING_IO, 
     gl_NONBLOCKING_IO
     if test $gl_cv_have_nonblocking != yes; then
       REPLACE_STDIO_READ_FUNCS=1
-      AC_LIBOBJ(stdio-read)
     fi
   )
 
-  dnl No need to create extra modules for these functions. Everyone who uses
-  dnl <stdio.h> likely needs them.
-  GNULIB_FPRINTF=1
-  GNULIB_PRINTF=1
-  GNULIB_VFPRINTF=1
-  GNULIB_VPRINTF=1
-  GNULIB_FPUTC=1
-  GNULIB_PUTC=1
-  GNULIB_PUTCHAR=1
-  GNULIB_FPUTS=1
-  GNULIB_PUTS=1
-  GNULIB_FWRITE=1
-  dnl This ifdef is necessary to avoid an error "missing file lib/stdio-write.c"
-  dnl "expected source file, required through AC_LIBSOURCES, not found". It is
-  dnl also an optimization, to avoid performing a configure check whose result
-  dnl is not used. But it does not make the test of GNULIB_STDIO_H_SIGPIPE or
-  dnl GNULIB_SIGPIPE redundant.
+  dnl This ifdef is an optimization, to avoid performing a configure check whose
+  dnl result is not used. But it does not make the test of
+  dnl GNULIB_STDIO_H_SIGPIPE or GNULIB_SIGPIPE redundant.
   m4_ifdef(gl_SIGNAL_SIGPIPE, 
     gl_SIGNAL_SIGPIPE
     if test $gl_cv_header_signal_h_SIGPIPE != yes; then
       REPLACE_STDIO_WRITE_FUNCS=1
-      AC_LIBOBJ(stdio-write)
     fi
   )
-  dnl This ifdef is necessary to avoid an error "missing file lib/stdio-write.c"
-  dnl "expected source file, required through AC_LIBSOURCES, not found". It is
-  dnl also an optimization, to avoid performing a configure check whose result
-  dnl is not used. But it does not make the test of GNULIB_STDIO_H_NONBLOCKING
-  dnl or GNULIB_NONBLOCKING redundant.
+  dnl This ifdef is an optimization, to avoid performing a configure check whose
+  dnl result is not used. But it does not make the test of
+  dnl GNULIB_STDIO_H_NONBLOCKING or GNULIB_NONBLOCKING redundant.
   m4_ifdef(gl_NONBLOCKING_IO, 
     gl_NONBLOCKING_IO
     if test $gl_cv_have_nonblocking != yes; then
       REPLACE_STDIO_WRITE_FUNCS=1
-      AC_LIBOBJ(stdio-write)
     fi
   )
 
@@ -107,79 +75,122 @@
   gl_WARN_ON_USE_PREPARE(#include <stdio.h>
     , dprintf fpurge fseeko ftello getdelim getline gets pclose popen
     renameat snprintf tmpfile vdprintf vsnprintf)
+
+  AC_REQUIRE(AC_C_RESTRICT)
+
+  AC_CHECK_DECLS_ONCE(fcloseall)
+  if test $ac_cv_have_decl_fcloseall = no; then
+    HAVE_DECL_FCLOSEALL=0
+  fi
+
+  AC_CHECK_DECLS_ONCE(getw)
+  if test $ac_cv_have_decl_getw = no; then
+    HAVE_DECL_GETW=0
+  fi
+
+  AC_CHECK_DECLS_ONCE(putw)
+  if test $ac_cv_have_decl_putw = no; then
+    HAVE_DECL_PUTW=0
+  fi
 )
 
+# gl_STDIO_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_STDIO_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_STDIO_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_STDIO_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
   dnl Define it also as a C macro, for the benefit of the unit tests.
   gl_MODULE_INDICATOR_FOR_TESTS($1)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_STDIO_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_STDIO_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_DPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FCLOSE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FDOPEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FFLUSH)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FGETC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FGETS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FOPEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FOPEN_GNU)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FPRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FPURGE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FPUTC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FPUTS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREAD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREOPEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FSCANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FSEEK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FSEEKO)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FTELL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FTELLO)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FWRITE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETCHAR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETDELIM)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETLINE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_OBSTACK_PRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_OBSTACK_PRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PCLOSE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PERROR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_POPEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PUTC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PUTCHAR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PUTS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REMOVE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RENAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RENAMEAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SCANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SNPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SPRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STDIO_H_NONBLOCKING)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STDIO_H_SIGPIPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TMPFILE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VASPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VFSCANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VSCANF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VDPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VFPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VFPRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VPRINTF_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VSNPRINTF)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_VSPRINTF_POSIX)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_FCLOSEALL, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_FDOPEN, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_FILENO, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_GETW, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_PUTW, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_TEMPNAM, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_STDIO_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_STDIO_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_STDIO_H_DEFAULTS,
 
-  GNULIB_DPRINTF=0;              AC_SUBST(GNULIB_DPRINTF)
-  GNULIB_FCLOSE=0;               AC_SUBST(GNULIB_FCLOSE)
-  GNULIB_FDOPEN=0;               AC_SUBST(GNULIB_FDOPEN)
-  GNULIB_FFLUSH=0;               AC_SUBST(GNULIB_FFLUSH)
-  GNULIB_FGETC=0;                AC_SUBST(GNULIB_FGETC)
-  GNULIB_FGETS=0;                AC_SUBST(GNULIB_FGETS)
-  GNULIB_FOPEN=0;                AC_SUBST(GNULIB_FOPEN)
-  GNULIB_FPRINTF=0;              AC_SUBST(GNULIB_FPRINTF)
-  GNULIB_FPRINTF_POSIX=0;        AC_SUBST(GNULIB_FPRINTF_POSIX)
-  GNULIB_FPURGE=0;               AC_SUBST(GNULIB_FPURGE)
-  GNULIB_FPUTC=0;                AC_SUBST(GNULIB_FPUTC)
-  GNULIB_FPUTS=0;                AC_SUBST(GNULIB_FPUTS)
-  GNULIB_FREAD=0;                AC_SUBST(GNULIB_FREAD)
-  GNULIB_FREOPEN=0;              AC_SUBST(GNULIB_FREOPEN)
-  GNULIB_FSCANF=0;               AC_SUBST(GNULIB_FSCANF)
-  GNULIB_FSEEK=0;                AC_SUBST(GNULIB_FSEEK)
-  GNULIB_FSEEKO=0;               AC_SUBST(GNULIB_FSEEKO)
-  GNULIB_FTELL=0;                AC_SUBST(GNULIB_FTELL)
-  GNULIB_FTELLO=0;               AC_SUBST(GNULIB_FTELLO)
-  GNULIB_FWRITE=0;               AC_SUBST(GNULIB_FWRITE)
-  GNULIB_GETC=0;                 AC_SUBST(GNULIB_GETC)
-  GNULIB_GETCHAR=0;              AC_SUBST(GNULIB_GETCHAR)
-  GNULIB_GETDELIM=0;             AC_SUBST(GNULIB_GETDELIM)
-  GNULIB_GETLINE=0;              AC_SUBST(GNULIB_GETLINE)
-  GNULIB_OBSTACK_PRINTF=0;       AC_SUBST(GNULIB_OBSTACK_PRINTF)
-  GNULIB_OBSTACK_PRINTF_POSIX=0; AC_SUBST(GNULIB_OBSTACK_PRINTF_POSIX)
-  GNULIB_PCLOSE=0;               AC_SUBST(GNULIB_PCLOSE)
-  GNULIB_PERROR=0;               AC_SUBST(GNULIB_PERROR)
-  GNULIB_POPEN=0;                AC_SUBST(GNULIB_POPEN)
-  GNULIB_PRINTF=0;               AC_SUBST(GNULIB_PRINTF)
-  GNULIB_PRINTF_POSIX=0;         AC_SUBST(GNULIB_PRINTF_POSIX)
-  GNULIB_PUTC=0;                 AC_SUBST(GNULIB_PUTC)
-  GNULIB_PUTCHAR=0;              AC_SUBST(GNULIB_PUTCHAR)
-  GNULIB_PUTS=0;                 AC_SUBST(GNULIB_PUTS)
-  GNULIB_REMOVE=0;               AC_SUBST(GNULIB_REMOVE)
-  GNULIB_RENAME=0;               AC_SUBST(GNULIB_RENAME)
-  GNULIB_RENAMEAT=0;             AC_SUBST(GNULIB_RENAMEAT)
-  GNULIB_SCANF=0;                AC_SUBST(GNULIB_SCANF)
-  GNULIB_SNPRINTF=0;             AC_SUBST(GNULIB_SNPRINTF)
-  GNULIB_SPRINTF_POSIX=0;        AC_SUBST(GNULIB_SPRINTF_POSIX)
-  GNULIB_STDIO_H_NONBLOCKING=0;  AC_SUBST(GNULIB_STDIO_H_NONBLOCKING)
-  GNULIB_STDIO_H_SIGPIPE=0;      AC_SUBST(GNULIB_STDIO_H_SIGPIPE)
-  GNULIB_TMPFILE=0;              AC_SUBST(GNULIB_TMPFILE)
-  GNULIB_VASPRINTF=0;            AC_SUBST(GNULIB_VASPRINTF)
-  GNULIB_VFSCANF=0;              AC_SUBST(GNULIB_VFSCANF)
-  GNULIB_VSCANF=0;               AC_SUBST(GNULIB_VSCANF)
-  GNULIB_VDPRINTF=0;             AC_SUBST(GNULIB_VDPRINTF)
-  GNULIB_VFPRINTF=0;             AC_SUBST(GNULIB_VFPRINTF)
-  GNULIB_VFPRINTF_POSIX=0;       AC_SUBST(GNULIB_VFPRINTF_POSIX)
-  GNULIB_VPRINTF=0;              AC_SUBST(GNULIB_VPRINTF)
-  GNULIB_VPRINTF_POSIX=0;        AC_SUBST(GNULIB_VPRINTF_POSIX)
-  GNULIB_VSNPRINTF=0;            AC_SUBST(GNULIB_VSNPRINTF)
-  GNULIB_VSPRINTF_POSIX=0;       AC_SUBST(GNULIB_VSPRINTF_POSIX)
   dnl Assume proper GNU behavior unless another module says otherwise.
+  HAVE_DECL_FCLOSEALL=1;         AC_SUBST(HAVE_DECL_FCLOSEALL)
   HAVE_DECL_FPURGE=1;            AC_SUBST(HAVE_DECL_FPURGE)
   HAVE_DECL_FSEEKO=1;            AC_SUBST(HAVE_DECL_FSEEKO)
   HAVE_DECL_FTELLO=1;            AC_SUBST(HAVE_DECL_FTELLO)
   HAVE_DECL_GETDELIM=1;          AC_SUBST(HAVE_DECL_GETDELIM)
   HAVE_DECL_GETLINE=1;           AC_SUBST(HAVE_DECL_GETLINE)
+  HAVE_DECL_GETW=1;              AC_SUBST(HAVE_DECL_GETW)
   HAVE_DECL_OBSTACK_PRINTF=1;    AC_SUBST(HAVE_DECL_OBSTACK_PRINTF)
+  HAVE_DECL_PUTW=1;              AC_SUBST(HAVE_DECL_PUTW)
   HAVE_DECL_SNPRINTF=1;          AC_SUBST(HAVE_DECL_SNPRINTF)
   HAVE_DECL_VSNPRINTF=1;         AC_SUBST(HAVE_DECL_VSNPRINTF)
   HAVE_DPRINTF=1;                AC_SUBST(HAVE_DPRINTF)
@@ -195,6 +206,7 @@
   REPLACE_FDOPEN=0;              AC_SUBST(REPLACE_FDOPEN)
   REPLACE_FFLUSH=0;              AC_SUBST(REPLACE_FFLUSH)
   REPLACE_FOPEN=0;               AC_SUBST(REPLACE_FOPEN)
+  REPLACE_FOPEN_FOR_FOPEN_GNU=0; AC_SUBST(REPLACE_FOPEN_FOR_FOPEN_GNU)
   REPLACE_FPRINTF=0;             AC_SUBST(REPLACE_FPRINTF)
   REPLACE_FPURGE=0;              AC_SUBST(REPLACE_FPURGE)
   REPLACE_FREOPEN=0;             AC_SUBST(REPLACE_FREOPEN)

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/stdlib_h.m4 Added

@@ -0,0 +1,209 @@
+# stdlib_h.m4 serial 71
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+AC_DEFUN_ONCE(gl_STDLIB_H,
+
+  AC_REQUIRE(gl_STDLIB_H_DEFAULTS)
+  gl_NEXT_HEADERS(stdlib.h)
+
+  dnl Check for declarations of anything we want to poison if the
+  dnl corresponding gnulib module is not in use, and which is not
+  dnl guaranteed by C89.
+  gl_WARN_ON_USE_PREPARE(#include <stdlib.h>
+#if HAVE_SYS_LOADAVG_H
+/* OpenIndiana has a bug: <sys/time.h> must be included before
+   <sys/loadavg.h>.  */
+# include <sys/time.h>
+# include <sys/loadavg.h>
+#endif
+#if HAVE_RANDOM_H
+# include <random.h>
+#endif
+    , _Exit aligned_alloc atoll canonicalize_file_name free
+    getloadavg getprogname getsubopt grantpt
+    initstate initstate_r mbtowc mkdtemp mkostemp mkostemps mkstemp mkstemps
+    posix_memalign posix_openpt ptsname ptsname_r qsort_r
+    random random_r reallocarray realpath rpmatch secure_getenv setenv
+    setstate setstate_r srandom srandom_r
+    strtod strtol strtold strtoll strtoul strtoull unlockpt unsetenv)
+
+  AC_REQUIRE(AC_C_RESTRICT)
+
+  AC_CHECK_DECLS_ONCE(ecvt)
+  if test $ac_cv_have_decl_ecvt = no; then
+    HAVE_DECL_ECVT=0
+  fi
+  AC_CHECK_DECLS_ONCE(fcvt)
+  if test $ac_cv_have_decl_fcvt = no; then
+    HAVE_DECL_FCVT=0
+  fi
+  AC_CHECK_DECLS_ONCE(gcvt)
+  if test $ac_cv_have_decl_gcvt = no; then
+    HAVE_DECL_GCVT=0
+  fi
+)
+
+# gl_STDLIB_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
+AC_DEFUN(gl_STDLIB_MODULE_INDICATOR,
+
+  dnl Ensure to expand the default settings once only.
+  gl_STDLIB_H_REQUIRE_DEFAULTS
+  gl_MODULE_INDICATOR_SET_VARIABLE($1)
+  dnl Define it also as a C macro, for the benefit of the unit tests.
+  gl_MODULE_INDICATOR_FOR_TESTS($1)
+)
+
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_STDLIB_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_STDLIB_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB__EXIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ALIGNED_ALLOC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ATOLL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CALLOC_GNU)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CALLOC_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CANONICALIZE_FILE_NAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FREE_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETLOADAVG)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETPROGNAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETSUBOPT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GRANTPT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MALLOC_GNU)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MALLOC_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBTOWC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MKDTEMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MKOSTEMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MKOSTEMPS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MKSTEMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MKSTEMPS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_POSIX_MEMALIGN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_POSIX_OPENPT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PTSNAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PTSNAME_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PUTENV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_QSORT_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RANDOM)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RANDOM_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REALLOCARRAY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REALLOC_GNU)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REALLOC_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_REALPATH)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RPMATCH)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SECURE_GETENV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SETENV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOLD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOLL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOUL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOULL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SYSTEM_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNLOCKPT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNSETENV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCTOMB)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_ECVT, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_FCVT, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_GCVT, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_MKTEMP, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_PUTENV, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_STDLIB_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_STDLIB_H_DEFAULTS)
+)
+
+AC_DEFUN(gl_STDLIB_H_DEFAULTS,
+
+  dnl Assume proper GNU behavior unless another module says otherwise.
+  HAVE__EXIT=1;              AC_SUBST(HAVE__EXIT)
+  HAVE_ALIGNED_ALLOC=1;      AC_SUBST(HAVE_ALIGNED_ALLOC)
+  HAVE_ATOLL=1;              AC_SUBST(HAVE_ATOLL)
+  HAVE_CANONICALIZE_FILE_NAME=1;  AC_SUBST(HAVE_CANONICALIZE_FILE_NAME)
+  HAVE_DECL_ECVT=1;          AC_SUBST(HAVE_DECL_ECVT)
+  HAVE_DECL_FCVT=1;          AC_SUBST(HAVE_DECL_FCVT)
+  HAVE_DECL_GCVT=1;          AC_SUBST(HAVE_DECL_GCVT)
+  HAVE_DECL_GETLOADAVG=1;    AC_SUBST(HAVE_DECL_GETLOADAVG)
+  HAVE_GETPROGNAME=1;        AC_SUBST(HAVE_GETPROGNAME)
+  HAVE_GETSUBOPT=1;          AC_SUBST(HAVE_GETSUBOPT)
+  HAVE_GRANTPT=1;            AC_SUBST(HAVE_GRANTPT)
+  HAVE_INITSTATE=1;          AC_SUBST(HAVE_INITSTATE)
+  HAVE_DECL_INITSTATE=1;     AC_SUBST(HAVE_DECL_INITSTATE)
+  HAVE_MBTOWC=1;             AC_SUBST(HAVE_MBTOWC)
+  HAVE_MKDTEMP=1;            AC_SUBST(HAVE_MKDTEMP)
+  HAVE_MKOSTEMP=1;           AC_SUBST(HAVE_MKOSTEMP)
+  HAVE_MKOSTEMPS=1;          AC_SUBST(HAVE_MKOSTEMPS)
+  HAVE_MKSTEMP=1;            AC_SUBST(HAVE_MKSTEMP)
+  HAVE_MKSTEMPS=1;           AC_SUBST(HAVE_MKSTEMPS)
+  HAVE_POSIX_MEMALIGN=1;     AC_SUBST(HAVE_POSIX_MEMALIGN)
+  HAVE_POSIX_OPENPT=1;       AC_SUBST(HAVE_POSIX_OPENPT)
+  HAVE_PTSNAME=1;            AC_SUBST(HAVE_PTSNAME)
+  HAVE_PTSNAME_R=1;          AC_SUBST(HAVE_PTSNAME_R)
+  HAVE_QSORT_R=1;            AC_SUBST(HAVE_QSORT_R)
+  HAVE_RANDOM=1;             AC_SUBST(HAVE_RANDOM)
+  HAVE_RANDOM_H=1;           AC_SUBST(HAVE_RANDOM_H)
+  HAVE_RANDOM_R=1;           AC_SUBST(HAVE_RANDOM_R)
+  HAVE_REALLOCARRAY=1;       AC_SUBST(HAVE_REALLOCARRAY)
+  HAVE_REALPATH=1;           AC_SUBST(HAVE_REALPATH)
+  HAVE_RPMATCH=1;            AC_SUBST(HAVE_RPMATCH)
+  HAVE_SECURE_GETENV=1;      AC_SUBST(HAVE_SECURE_GETENV)
+  HAVE_SETENV=1;             AC_SUBST(HAVE_SETENV)
+  HAVE_DECL_SETENV=1;        AC_SUBST(HAVE_DECL_SETENV)
+  HAVE_SETSTATE=1;           AC_SUBST(HAVE_SETSTATE)
+  HAVE_DECL_SETSTATE=1;      AC_SUBST(HAVE_DECL_SETSTATE)
+  HAVE_STRTOD=1;             AC_SUBST(HAVE_STRTOD)
+  HAVE_STRTOL=1;             AC_SUBST(HAVE_STRTOL)
+  HAVE_STRTOLD=1;            AC_SUBST(HAVE_STRTOLD)
+  HAVE_STRTOLL=1;            AC_SUBST(HAVE_STRTOLL)
+  HAVE_STRTOUL=1;            AC_SUBST(HAVE_STRTOUL)
+  HAVE_STRTOULL=1;           AC_SUBST(HAVE_STRTOULL)
+  HAVE_STRUCT_RANDOM_DATA=1; AC_SUBST(HAVE_STRUCT_RANDOM_DATA)
+  HAVE_SYS_LOADAVG_H=0;      AC_SUBST(HAVE_SYS_LOADAVG_H)
+  HAVE_UNLOCKPT=1;           AC_SUBST(HAVE_UNLOCKPT)
+  HAVE_DECL_UNSETENV=1;      AC_SUBST(HAVE_DECL_UNSETENV)
+  REPLACE__EXIT=0;           AC_SUBST(REPLACE__EXIT)
+  REPLACE_ALIGNED_ALLOC=0;   AC_SUBST(REPLACE_ALIGNED_ALLOC)
+  REPLACE_CALLOC_FOR_CALLOC_GNU=0;    AC_SUBST(REPLACE_CALLOC_FOR_CALLOC_GNU)
+  REPLACE_CALLOC_FOR_CALLOC_POSIX=0;  AC_SUBST(REPLACE_CALLOC_FOR_CALLOC_POSIX)
+  REPLACE_CANONICALIZE_FILE_NAME=0;  AC_SUBST(REPLACE_CANONICALIZE_FILE_NAME)
+  REPLACE_FREE=0;            AC_SUBST(REPLACE_FREE)
+  REPLACE_GETLOADAVG=0;      AC_SUBST(REPLACE_GETLOADAVG)
+  REPLACE_GETPROGNAME=0;     AC_SUBST(REPLACE_GETPROGNAME)
+  REPLACE_GETSUBOPT=0;       AC_SUBST(REPLACE_GETSUBOPT)
+  REPLACE_INITSTATE=0;       AC_SUBST(REPLACE_INITSTATE)
+  REPLACE_MALLOC_FOR_MALLOC_GNU=0;    AC_SUBST(REPLACE_MALLOC_FOR_MALLOC_GNU)
+  REPLACE_MALLOC_FOR_MALLOC_POSIX=0;  AC_SUBST(REPLACE_MALLOC_FOR_MALLOC_POSIX)
+  REPLACE_MBTOWC=0;          AC_SUBST(REPLACE_MBTOWC)
+  REPLACE_MKOSTEMP=0;        AC_SUBST(REPLACE_MKOSTEMP)
+  REPLACE_MKOSTEMPS=0;       AC_SUBST(REPLACE_MKOSTEMPS)
+  REPLACE_MKSTEMP=0;         AC_SUBST(REPLACE_MKSTEMP)
+  REPLACE_POSIX_MEMALIGN=0;  AC_SUBST(REPLACE_POSIX_MEMALIGN)
+  REPLACE_POSIX_OPENPT=0;    AC_SUBST(REPLACE_POSIX_OPENPT)
+  REPLACE_PTSNAME=0;         AC_SUBST(REPLACE_PTSNAME)
+  REPLACE_PTSNAME_R=0;       AC_SUBST(REPLACE_PTSNAME_R)
+  REPLACE_PUTENV=0;          AC_SUBST(REPLACE_PUTENV)
+  REPLACE_QSORT_R=0;         AC_SUBST(REPLACE_QSORT_R)
+  REPLACE_RANDOM=0;          AC_SUBST(REPLACE_RANDOM)
+  REPLACE_RANDOM_R=0;        AC_SUBST(REPLACE_RANDOM_R)
+  REPLACE_REALLOC_FOR_REALLOC_GNU=0;    AC_SUBST(REPLACE_REALLOC_FOR_REALLOC_GNU)
+  REPLACE_REALLOC_FOR_REALLOC_POSIX=0;  AC_SUBST(REPLACE_REALLOC_FOR_REALLOC_POSIX)
+  REPLACE_REALLOCARRAY=0;    AC_SUBST(REPLACE_REALLOCARRAY)
+  REPLACE_REALPATH=0;        AC_SUBST(REPLACE_REALPATH)
+  REPLACE_SETENV=0;          AC_SUBST(REPLACE_SETENV)
+  REPLACE_SETSTATE=0;        AC_SUBST(REPLACE_SETSTATE)
+  REPLACE_STRTOD=0;          AC_SUBST(REPLACE_STRTOD)
+  REPLACE_STRTOL=0;          AC_SUBST(REPLACE_STRTOL)
+  REPLACE_STRTOLD=0;         AC_SUBST(REPLACE_STRTOLD)
+  REPLACE_STRTOLL=0;         AC_SUBST(REPLACE_STRTOLL)
+  REPLACE_STRTOUL=0;         AC_SUBST(REPLACE_STRTOUL)
+  REPLACE_STRTOULL=0;        AC_SUBST(REPLACE_STRTOULL)
+  REPLACE_UNSETENV=0;        AC_SUBST(REPLACE_UNSETENV)
+  REPLACE_WCTOMB=0;          AC_SUBST(REPLACE_WCTOMB)
+)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/string_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/string_h.m4 Changed

@@ -1,25 +1,19 @@
 # Configure a GNU-like replacement for <string.h>.
 
-# Copyright (C) 2007-2018 Free Software Foundation, Inc.
+# Copyright (C) 2007-2023 Free Software Foundation, Inc.
 # This file is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
 # with or without modifications, as long as this notice is preserved.
 
-# serial 22
+# serial 37
 
 # Written by Paul Eggert.
 
-AC_DEFUN(gl_HEADER_STRING_H,
+AC_DEFUN_ONCE(gl_STRING_H,
 
-  dnl Use AC_REQUIRE here, so that the default behavior below is expanded
-  dnl once only, before all statements that occur in other macros.
-  AC_REQUIRE(gl_HEADER_STRING_H_BODY)
-)
-
-AC_DEFUN(gl_HEADER_STRING_H_BODY,
-
-  AC_REQUIRE(AC_C_RESTRICT)
-  AC_REQUIRE(gl_HEADER_STRING_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only, before all statements
+  dnl that occur in other macros.
+  AC_REQUIRE(gl_STRING_H_DEFAULTS)
   gl_NEXT_HEADERS(string.h)
 
   dnl Check for declarations of anything we want to poison if the
@@ -27,68 +21,95 @@
   dnl guaranteed by C89.
   gl_WARN_ON_USE_PREPARE(#include <string.h>
     ,
-    ffsl ffsll memmem mempcpy memrchr rawmemchr stpcpy stpncpy strchrnul
+    explicit_bzero ffsl ffsll memmem mempcpy memrchr memset_explicit
+     rawmemchr stpcpy stpncpy strchrnul
      strdup strncat strndup strnlen strpbrk strsep strcasestr strtok_r
-     strerror_r strsignal strverscmp)
+     strerror_r strerrorname_np sigabbrev_np sigdescr_np strsignal strverscmp)
+
+  AC_REQUIRE(AC_C_RESTRICT)
 )
 
+# gl_STRING_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_STRING_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_HEADER_STRING_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_STRING_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
   dnl Define it also as a C macro, for the benefit of the unit tests.
   gl_MODULE_INDICATOR_FOR_TESTS($1)
 )
 
-AC_DEFUN(gl_HEADER_STRING_H_DEFAULTS,
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_STRING_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_STRING_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXPLICIT_BZERO)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FFSL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FFSLL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MEMCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MEMMEM)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MEMPCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MEMRCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MEMSET_EXPLICIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RAWMEMCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STPCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STPNCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRCHRNUL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRDUP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRNCAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRNDUP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRNLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRPBRK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRSEP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRSTR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRCASESTR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRTOK_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSNLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSRCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSSTR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSCASECMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSNCASECMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSPCASECMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSCASESTR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSCSPN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSPBRK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSSPN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSSEP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSTOK_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRERROR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRERROR_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRERRORNAME_NP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SIGABBREV_NP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SIGDESCR_NP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRSIGNAL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_STRVERSCMP)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_MEMCCPY, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_STRDUP, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_STRING_H_MODULE_INDICATOR_DEFAULTS)
+  dnl Make sure the shell variable for GNULIB_FREE_POSIX is initialized.
+  gl_STDLIB_H_REQUIRE_DEFAULTS
+  AC_REQUIRE(gl_STRING_H_DEFAULTS)
+)
+
+AC_DEFUN(gl_STRING_H_DEFAULTS,
 
-  GNULIB_EXPLICIT_BZERO=0; AC_SUBST(GNULIB_EXPLICIT_BZERO)
-  GNULIB_FFSL=0;        AC_SUBST(GNULIB_FFSL)
-  GNULIB_FFSLL=0;       AC_SUBST(GNULIB_FFSLL)
-  GNULIB_MEMCHR=0;      AC_SUBST(GNULIB_MEMCHR)
-  GNULIB_MEMMEM=0;      AC_SUBST(GNULIB_MEMMEM)
-  GNULIB_MEMPCPY=0;     AC_SUBST(GNULIB_MEMPCPY)
-  GNULIB_MEMRCHR=0;     AC_SUBST(GNULIB_MEMRCHR)
-  GNULIB_RAWMEMCHR=0;   AC_SUBST(GNULIB_RAWMEMCHR)
-  GNULIB_STPCPY=0;      AC_SUBST(GNULIB_STPCPY)
-  GNULIB_STPNCPY=0;     AC_SUBST(GNULIB_STPNCPY)
-  GNULIB_STRCHRNUL=0;   AC_SUBST(GNULIB_STRCHRNUL)
-  GNULIB_STRDUP=0;      AC_SUBST(GNULIB_STRDUP)
-  GNULIB_STRNCAT=0;     AC_SUBST(GNULIB_STRNCAT)
-  GNULIB_STRNDUP=0;     AC_SUBST(GNULIB_STRNDUP)
-  GNULIB_STRNLEN=0;     AC_SUBST(GNULIB_STRNLEN)
-  GNULIB_STRPBRK=0;     AC_SUBST(GNULIB_STRPBRK)
-  GNULIB_STRSEP=0;      AC_SUBST(GNULIB_STRSEP)
-  GNULIB_STRSTR=0;      AC_SUBST(GNULIB_STRSTR)
-  GNULIB_STRCASESTR=0;  AC_SUBST(GNULIB_STRCASESTR)
-  GNULIB_STRTOK_R=0;    AC_SUBST(GNULIB_STRTOK_R)
-  GNULIB_MBSLEN=0;      AC_SUBST(GNULIB_MBSLEN)
-  GNULIB_MBSNLEN=0;     AC_SUBST(GNULIB_MBSNLEN)
-  GNULIB_MBSCHR=0;      AC_SUBST(GNULIB_MBSCHR)
-  GNULIB_MBSRCHR=0;     AC_SUBST(GNULIB_MBSRCHR)
-  GNULIB_MBSSTR=0;      AC_SUBST(GNULIB_MBSSTR)
-  GNULIB_MBSCASECMP=0;  AC_SUBST(GNULIB_MBSCASECMP)
-  GNULIB_MBSNCASECMP=0; AC_SUBST(GNULIB_MBSNCASECMP)
-  GNULIB_MBSPCASECMP=0; AC_SUBST(GNULIB_MBSPCASECMP)
-  GNULIB_MBSCASESTR=0;  AC_SUBST(GNULIB_MBSCASESTR)
-  GNULIB_MBSCSPN=0;     AC_SUBST(GNULIB_MBSCSPN)
-  GNULIB_MBSPBRK=0;     AC_SUBST(GNULIB_MBSPBRK)
-  GNULIB_MBSSPN=0;      AC_SUBST(GNULIB_MBSSPN)
-  GNULIB_MBSSEP=0;      AC_SUBST(GNULIB_MBSSEP)
-  GNULIB_MBSTOK_R=0;    AC_SUBST(GNULIB_MBSTOK_R)
-  GNULIB_STRERROR=0;    AC_SUBST(GNULIB_STRERROR)
-  GNULIB_STRERROR_R=0;  AC_SUBST(GNULIB_STRERROR_R)
-  GNULIB_STRSIGNAL=0;   AC_SUBST(GNULIB_STRSIGNAL)
-  GNULIB_STRVERSCMP=0;  AC_SUBST(GNULIB_STRVERSCMP)
-  HAVE_MBSLEN=0;        AC_SUBST(HAVE_MBSLEN)
+  HAVE_MBSLEN=0;             AC_SUBST(HAVE_MBSLEN)
   dnl Assume proper GNU behavior unless another module says otherwise.
   HAVE_EXPLICIT_BZERO=1;        AC_SUBST(HAVE_EXPLICIT_BZERO)
   HAVE_FFSL=1;                  AC_SUBST(HAVE_FFSL)
   HAVE_FFSLL=1;                 AC_SUBST(HAVE_FFSLL)
-  HAVE_MEMCHR=1;                AC_SUBST(HAVE_MEMCHR)
   HAVE_DECL_MEMMEM=1;           AC_SUBST(HAVE_DECL_MEMMEM)
   HAVE_MEMPCPY=1;               AC_SUBST(HAVE_MEMPCPY)
+  HAVE_MEMSET_EXPLICIT=1;       AC_SUBST(HAVE_MEMSET_EXPLICIT)
   HAVE_DECL_MEMRCHR=1;          AC_SUBST(HAVE_DECL_MEMRCHR)
   HAVE_RAWMEMCHR=1;             AC_SUBST(HAVE_RAWMEMCHR)
   HAVE_STPCPY=1;                AC_SUBST(HAVE_STPCPY)
@@ -102,10 +123,16 @@
   HAVE_STRCASESTR=1;            AC_SUBST(HAVE_STRCASESTR)
   HAVE_DECL_STRTOK_R=1;         AC_SUBST(HAVE_DECL_STRTOK_R)
   HAVE_DECL_STRERROR_R=1;       AC_SUBST(HAVE_DECL_STRERROR_R)
+  HAVE_STRERRORNAME_NP=1;       AC_SUBST(HAVE_STRERRORNAME_NP)
+  HAVE_SIGABBREV_NP=1;          AC_SUBST(HAVE_SIGABBREV_NP)
+  HAVE_SIGDESCR_NP=1;           AC_SUBST(HAVE_SIGDESCR_NP)
   HAVE_DECL_STRSIGNAL=1;        AC_SUBST(HAVE_DECL_STRSIGNAL)
   HAVE_STRVERSCMP=1;            AC_SUBST(HAVE_STRVERSCMP)
+  REPLACE_FFSLL=0;              AC_SUBST(REPLACE_FFSLL)
   REPLACE_MEMCHR=0;             AC_SUBST(REPLACE_MEMCHR)
   REPLACE_MEMMEM=0;             AC_SUBST(REPLACE_MEMMEM)
+  REPLACE_MEMPCPY=0;            AC_SUBST(REPLACE_MEMPCPY)
+  REPLACE_STPCPY=0;             AC_SUBST(REPLACE_STPCPY)
   REPLACE_STPNCPY=0;            AC_SUBST(REPLACE_STPNCPY)
   REPLACE_STRCHRNUL=0;          AC_SUBST(REPLACE_STRCHRNUL)
   REPLACE_STRDUP=0;             AC_SUBST(REPLACE_STRDUP)
@@ -117,6 +144,7 @@
   REPLACE_STRTOK_R=0;           AC_SUBST(REPLACE_STRTOK_R)
   REPLACE_STRERROR=0;           AC_SUBST(REPLACE_STRERROR)
   REPLACE_STRERROR_R=0;         AC_SUBST(REPLACE_STRERROR_R)
+  REPLACE_STRERRORNAME_NP=0;    AC_SUBST(REPLACE_STRERRORNAME_NP)
   REPLACE_STRSIGNAL=0;          AC_SUBST(REPLACE_STRSIGNAL)
   UNDEFINE_STRTOK_R=0;          AC_SUBST(UNDEFINE_STRTOK_R)
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/sys_types_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/sys_types_h.m4 Changed

@@ -1,15 +1,16 @@
-# sys_types_h.m4 serial 9
-dnl Copyright (C) 2011-2018 Free Software Foundation, Inc.
+# sys_types_h.m4 serial 13
+dnl Copyright (C) 2011-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 AC_DEFUN_ONCE(gl_SYS_TYPES_H,
 
+  AC_REQUIRE(gl_SYS_TYPES_H_DEFAULTS)
+
   dnl Use sane struct stat types in OpenVMS 8.2 and later.
   AC_DEFINE(_USE_STD_STAT, 1, For standard stat data types on VMS.)
 
-  AC_REQUIRE(gl_SYS_TYPES_H_DEFAULTS)
   gl_NEXT_HEADERS(sys/types.h)
 
   dnl Ensure the type pid_t gets defined.
@@ -30,31 +31,40 @@
   AC_SUBST(WINDOWS_STAT_INODES)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_SYS_TYPES_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_SYS_TYPE_H_MODULE_INDICATOR_DEFAULTS, 
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_SYS_TYPE_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_SYS_TYPES_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_SYS_TYPES_H_DEFAULTS,
 
 )
 
 # This works around a buggy version in autoconf <= 2.69.
 # See <https://lists.gnu.org/r/autoconf/2016-08/msg00014.html>
+# The 2.70 version isn't quoted properly, so override it too.
 
-m4_version_prereq(2.70, , 
-
-# This is taken from the following Autoconf patch:
-# https://git.savannah.gnu.org/cgit/autoconf.git/commit/?id=e17a30e987d7ee695fb4294a82d987ec3dc9b974
+m4_version_prereq(2.70.1, , 
 
 m4_undefine(AC_HEADER_MAJOR)
 AC_DEFUN(AC_HEADER_MAJOR,
 AC_CHECK_HEADERS_ONCE(sys/types.h)
 AC_CHECK_HEADER(sys/mkdev.h,
-  AC_DEFINE(MAJOR_IN_MKDEV, 1,
-    Define to 1 if `major', `minor', and `makedev' are declared in
-     <mkdev.h>.))
+                AC_DEFINE(MAJOR_IN_MKDEV, 1,
+                           Define to 1 if `major', `minor', and `makedev' are
+                            declared in <mkdev.h>.))
 if test $ac_cv_header_sys_mkdev_h = no; then
   AC_CHECK_HEADER(sys/sysmacros.h,
-    AC_DEFINE(MAJOR_IN_SYSMACROS, 1,
-      Define to 1 if `major', `minor', and `makedev' are declared in
-       <sysmacros.h>.))
+                  AC_DEFINE(MAJOR_IN_SYSMACROS, 1,
+                             Define to 1 if `major', `minor', and `makedev'
+                              are declared in <sysmacros.h>.))
 fi
-)
+)# AC_HEADER_MAJOR
 
 )

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/unistd_h.m4 Added

@@ -0,0 +1,275 @@
+# unistd_h.m4 serial 94
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
+dnl This file is free software; the Free Software Foundation
+dnl gives unlimited permission to copy and/or distribute it,
+dnl with or without modifications, as long as this notice is preserved.
+
+dnl Written by Simon Josefsson, Bruno Haible.
+
+AC_DEFUN_ONCE(gl_UNISTD_H,
+
+  dnl Ensure to expand the default settings once only, before all statements
+  dnl that occur in other macros.
+  AC_REQUIRE(gl_UNISTD_H_DEFAULTS)
+
+  gl_CHECK_NEXT_HEADERS(unistd.h)
+  if test $ac_cv_header_unistd_h = yes; then
+    HAVE_UNISTD_H=1
+  else
+    HAVE_UNISTD_H=0
+  fi
+  AC_SUBST(HAVE_UNISTD_H)
+
+  dnl Ensure the type pid_t gets defined.
+  AC_REQUIRE(AC_TYPE_PID_T)
+
+  dnl Determine WINDOWS_64_BIT_OFF_T.
+  AC_REQUIRE(gl_TYPE_OFF_T)
+
+  dnl Check for declarations of anything we want to poison if the
+  dnl corresponding gnulib module is not in use.
+  gl_WARN_ON_USE_PREPARE(
+#if HAVE_UNISTD_H
+# include <unistd.h>
+#endif
+/* Some systems declare various items in the wrong headers.  */
+#if !(defined __GLIBC__ && !defined __UCLIBC__)
+# include <fcntl.h>
+# include <stdio.h>
+# include <stdlib.h>
+# if defined _WIN32 && ! defined __CYGWIN__
+#  include <io.h>
+# endif
+#endif
+    , access chdir chown copy_file_range dup dup2 dup3 environ euidaccess
+    execl execle execlp execv execve execvp execvpe
+    faccessat fchdir
+    fchownat fdatasync fsync ftruncate getcwd getdomainname getdtablesize
+    getentropy getgroups gethostname getlogin getlogin_r getpagesize getpass
+    getusershell setusershell endusershell
+    group_member isatty lchown link linkat lseek pipe pipe2 pread pwrite
+    readlink readlinkat rmdir sethostname sleep symlink symlinkat
+    truncate ttyname_r unlink unlinkat usleep)
+
+  AC_REQUIRE(AC_C_RESTRICT)
+
+  AC_CHECK_DECLS_ONCE(execvpe)
+  if test $ac_cv_have_decl_execvpe = no; then
+    HAVE_DECL_EXECVPE=0
+  fi
+)
+
+# gl_UNISTD_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
+AC_DEFUN(gl_UNISTD_MODULE_INDICATOR,
+
+  dnl Ensure to expand the default settings once only.
+  gl_UNISTD_H_REQUIRE_DEFAULTS
+  gl_MODULE_INDICATOR_SET_VARIABLE($1)
+  dnl Define it also as a C macro, for the benefit of the unit tests.
+  gl_MODULE_INDICATOR_FOR_TESTS($1)
+)
+
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_UNISTD_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_UNISTD_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ACCESS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CHDIR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CHOWN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_CLOSE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_COPY_FILE_RANGE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_DUP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_DUP2)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_DUP3)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ENVIRON)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EUIDACCESS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECLE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECLP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECV)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECVE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECVP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_EXECVPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FACCESSAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FCHDIR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FCHOWNAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FDATASYNC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FSYNC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_FTRUNCATE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETCWD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETDOMAINNAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETDTABLESIZE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETENTROPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETGROUPS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETHOSTNAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETLOGIN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETLOGIN_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETOPT_POSIX)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETPAGESIZE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETPASS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETPASS_GNU)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GETUSERSHELL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_GROUP_MEMBER)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISATTY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LCHOWN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LINK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LINKAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_LSEEK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PIPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PIPE2)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PREAD)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_PWRITE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_READ)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_READLINK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_READLINKAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_RMDIR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SETHOSTNAME)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SLEEP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SYMLINK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_SYMLINKAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TRUNCATE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TTYNAME_R)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNISTD_H_GETOPT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNISTD_H_NONBLOCKING)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNISTD_H_SIGPIPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNLINK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_UNLINKAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_USLEEP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WRITE)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_ACCESS, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_CHDIR, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_CLOSE, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_DUP, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_DUP2, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECL, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECLE, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECLP, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECV, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECVE, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECVP, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_EXECVPE, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_GETCWD, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_GETPID, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_ISATTY, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_LSEEK, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_READ, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_RMDIR, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_SWAB, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_UNLINK, 1)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_WRITE, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_UNISTD_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_UNISTD_H_DEFAULTS)
+)
+
+AC_DEFUN(gl_UNISTD_H_DEFAULTS,
+
+  dnl Assume proper GNU behavior unless another module says otherwise.
+  HAVE_CHOWN=1;                      AC_SUBST(HAVE_CHOWN)
+  HAVE_COPY_FILE_RANGE=1;            AC_SUBST(HAVE_COPY_FILE_RANGE)
+  HAVE_DUP3=1;                       AC_SUBST(HAVE_DUP3)
+  HAVE_EUIDACCESS=1;                 AC_SUBST(HAVE_EUIDACCESS)
+  HAVE_EXECVPE=1;                    AC_SUBST(HAVE_EXECVPE)
+  HAVE_FACCESSAT=1;                  AC_SUBST(HAVE_FACCESSAT)
+  HAVE_FCHDIR=1;                     AC_SUBST(HAVE_FCHDIR)
+  HAVE_FCHOWNAT=1;                   AC_SUBST(HAVE_FCHOWNAT)
+  HAVE_FDATASYNC=1;                  AC_SUBST(HAVE_FDATASYNC)
+  HAVE_FSYNC=1;                      AC_SUBST(HAVE_FSYNC)
+  HAVE_FTRUNCATE=1;                  AC_SUBST(HAVE_FTRUNCATE)
+  HAVE_GETDTABLESIZE=1;              AC_SUBST(HAVE_GETDTABLESIZE)
+  HAVE_GETENTROPY=1;                 AC_SUBST(HAVE_GETENTROPY)
+  HAVE_GETGROUPS=1;                  AC_SUBST(HAVE_GETGROUPS)
+  HAVE_GETHOSTNAME=1;                AC_SUBST(HAVE_GETHOSTNAME)
+  HAVE_GETLOGIN=1;                   AC_SUBST(HAVE_GETLOGIN)
+  HAVE_GETPAGESIZE=1;                AC_SUBST(HAVE_GETPAGESIZE)
+  HAVE_GETPASS=1;                    AC_SUBST(HAVE_GETPASS)
+  HAVE_GROUP_MEMBER=1;               AC_SUBST(HAVE_GROUP_MEMBER)
+  HAVE_LCHOWN=1;                     AC_SUBST(HAVE_LCHOWN)
+  HAVE_LINK=1;                       AC_SUBST(HAVE_LINK)
+  HAVE_LINKAT=1;                     AC_SUBST(HAVE_LINKAT)
+  HAVE_PIPE=1;                       AC_SUBST(HAVE_PIPE)
+  HAVE_PIPE2=1;                      AC_SUBST(HAVE_PIPE2)
+  HAVE_PREAD=1;                      AC_SUBST(HAVE_PREAD)
+  HAVE_PWRITE=1;                     AC_SUBST(HAVE_PWRITE)
+  HAVE_READLINK=1;                   AC_SUBST(HAVE_READLINK)
+  HAVE_READLINKAT=1;                 AC_SUBST(HAVE_READLINKAT)
+  HAVE_SETHOSTNAME=1;                AC_SUBST(HAVE_SETHOSTNAME)
+  HAVE_SLEEP=1;                      AC_SUBST(HAVE_SLEEP)
+  HAVE_SYMLINK=1;                    AC_SUBST(HAVE_SYMLINK)
+  HAVE_SYMLINKAT=1;                  AC_SUBST(HAVE_SYMLINKAT)
+  HAVE_UNLINKAT=1;                   AC_SUBST(HAVE_UNLINKAT)
+  HAVE_USLEEP=1;                     AC_SUBST(HAVE_USLEEP)
+  HAVE_DECL_ENVIRON=1;               AC_SUBST(HAVE_DECL_ENVIRON)
+  HAVE_DECL_EXECVPE=1;               AC_SUBST(HAVE_DECL_EXECVPE)
+  HAVE_DECL_FCHDIR=1;                AC_SUBST(HAVE_DECL_FCHDIR)
+  HAVE_DECL_FDATASYNC=1;             AC_SUBST(HAVE_DECL_FDATASYNC)
+  HAVE_DECL_GETDOMAINNAME=1;         AC_SUBST(HAVE_DECL_GETDOMAINNAME)
+  HAVE_DECL_GETLOGIN=1;              AC_SUBST(HAVE_DECL_GETLOGIN)
+  HAVE_DECL_GETLOGIN_R=1;            AC_SUBST(HAVE_DECL_GETLOGIN_R)
+  HAVE_DECL_GETPAGESIZE=1;           AC_SUBST(HAVE_DECL_GETPAGESIZE)
+  HAVE_DECL_GETUSERSHELL=1;          AC_SUBST(HAVE_DECL_GETUSERSHELL)
+  HAVE_DECL_SETHOSTNAME=1;           AC_SUBST(HAVE_DECL_SETHOSTNAME)
+  HAVE_DECL_TRUNCATE=1;              AC_SUBST(HAVE_DECL_TRUNCATE)
+  HAVE_DECL_TTYNAME_R=1;             AC_SUBST(HAVE_DECL_TTYNAME_R)
+  HAVE_OS_H=0;                       AC_SUBST(HAVE_OS_H)
+  HAVE_SYS_PARAM_H=0;                AC_SUBST(HAVE_SYS_PARAM_H)
+  REPLACE_ACCESS=0;                  AC_SUBST(REPLACE_ACCESS)
+  REPLACE_CHOWN=0;                   AC_SUBST(REPLACE_CHOWN)
+  REPLACE_CLOSE=0;                   AC_SUBST(REPLACE_CLOSE)
+  REPLACE_COPY_FILE_RANGE=0;         AC_SUBST(REPLACE_COPY_FILE_RANGE)
+  REPLACE_DUP=0;                     AC_SUBST(REPLACE_DUP)
+  REPLACE_DUP2=0;                    AC_SUBST(REPLACE_DUP2)
+  REPLACE_DUP3=0;                    AC_SUBST(REPLACE_DUP3)
+  REPLACE_EXECL=0;                   AC_SUBST(REPLACE_EXECL)
+  REPLACE_EXECLE=0;                  AC_SUBST(REPLACE_EXECLE)
+  REPLACE_EXECLP=0;                  AC_SUBST(REPLACE_EXECLP)
+  REPLACE_EXECV=0;                   AC_SUBST(REPLACE_EXECV)
+  REPLACE_EXECVE=0;                  AC_SUBST(REPLACE_EXECVE)
+  REPLACE_EXECVP=0;                  AC_SUBST(REPLACE_EXECVP)
+  REPLACE_EXECVPE=0;                 AC_SUBST(REPLACE_EXECVPE)
+  REPLACE_FACCESSAT=0;               AC_SUBST(REPLACE_FACCESSAT)
+  REPLACE_FCHOWNAT=0;                AC_SUBST(REPLACE_FCHOWNAT)
+  REPLACE_FDATASYNC=0;               AC_SUBST(REPLACE_FDATASYNC)
+  REPLACE_FTRUNCATE=0;               AC_SUBST(REPLACE_FTRUNCATE)
+  REPLACE_GETCWD=0;                  AC_SUBST(REPLACE_GETCWD)
+  REPLACE_GETDOMAINNAME=0;           AC_SUBST(REPLACE_GETDOMAINNAME)
+  REPLACE_GETDTABLESIZE=0;           AC_SUBST(REPLACE_GETDTABLESIZE)
+  REPLACE_GETENTROPY=0;              AC_SUBST(REPLACE_GETENTROPY)
+  REPLACE_GETLOGIN_R=0;              AC_SUBST(REPLACE_GETLOGIN_R)
+  REPLACE_GETGROUPS=0;               AC_SUBST(REPLACE_GETGROUPS)
+  REPLACE_GETPAGESIZE=0;             AC_SUBST(REPLACE_GETPAGESIZE)
+  REPLACE_GETPASS=0;                 AC_SUBST(REPLACE_GETPASS)
+  REPLACE_GETPASS_FOR_GETPASS_GNU=0; AC_SUBST(REPLACE_GETPASS_FOR_GETPASS_GNU)
+  REPLACE_ISATTY=0;                  AC_SUBST(REPLACE_ISATTY)
+  REPLACE_LCHOWN=0;                  AC_SUBST(REPLACE_LCHOWN)
+  REPLACE_LINK=0;                    AC_SUBST(REPLACE_LINK)
+  REPLACE_LINKAT=0;                  AC_SUBST(REPLACE_LINKAT)
+  REPLACE_LSEEK=0;                   AC_SUBST(REPLACE_LSEEK)
+  REPLACE_PIPE2=0;                   AC_SUBST(REPLACE_PIPE2)
+  REPLACE_PREAD=0;                   AC_SUBST(REPLACE_PREAD)
+  REPLACE_PWRITE=0;                  AC_SUBST(REPLACE_PWRITE)
+  REPLACE_READ=0;                    AC_SUBST(REPLACE_READ)
+  REPLACE_READLINK=0;                AC_SUBST(REPLACE_READLINK)
+  REPLACE_READLINKAT=0;              AC_SUBST(REPLACE_READLINKAT)
+  REPLACE_RMDIR=0;                   AC_SUBST(REPLACE_RMDIR)
+  REPLACE_SETHOSTNAME=0;             AC_SUBST(REPLACE_SETHOSTNAME)
+  REPLACE_SLEEP=0;                   AC_SUBST(REPLACE_SLEEP)
+  REPLACE_SYMLINK=0;                 AC_SUBST(REPLACE_SYMLINK)
+  REPLACE_SYMLINKAT=0;               AC_SUBST(REPLACE_SYMLINKAT)
+  REPLACE_TRUNCATE=0;                AC_SUBST(REPLACE_TRUNCATE)
+  REPLACE_TTYNAME_R=0;               AC_SUBST(REPLACE_TTYNAME_R)
+  REPLACE_UNLINK=0;                  AC_SUBST(REPLACE_UNLINK)
+  REPLACE_UNLINKAT=0;                AC_SUBST(REPLACE_UNLINKAT)
+  REPLACE_USLEEP=0;                  AC_SUBST(REPLACE_USLEEP)
+  REPLACE_WRITE=0;                   AC_SUBST(REPLACE_WRITE)
+  UNISTD_H_HAVE_SYS_RANDOM_H=0;      AC_SUBST(UNISTD_H_HAVE_SYS_RANDOM_H)
+  UNISTD_H_HAVE_WINSOCK2_H=0;        AC_SUBST(UNISTD_H_HAVE_WINSOCK2_H)
+  UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS=0;
+                           AC_SUBST(UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS)
+)

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/vasnprintf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/vasnprintf.m4 Changed

@@ -1,5 +1,5 @@
-# vasnprintf.m4 serial 36
-dnl Copyright (C) 2002-2004, 2006-2018 Free Software Foundation, Inc.
+# vasnprintf.m4 serial 39
+dnl Copyright (C) 2002-2004, 2006-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -32,7 +32,6 @@
 # Prerequisites of lib/printf-args.h, lib/printf-args.c.
 AC_DEFUN(gl_PREREQ_PRINTF_ARGS,
 
-  AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
   AC_REQUIRE(gt_TYPE_WCHAR_T)
   AC_REQUIRE(gt_TYPE_WINT_T)
 )
@@ -41,7 +40,6 @@
 AC_DEFUN(gl_PREREQ_PRINTF_PARSE,
 
   AC_REQUIRE(gl_FEATURES_H)
-  AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
   AC_REQUIRE(gt_TYPE_WCHAR_T)
   AC_REQUIRE(gt_TYPE_WINT_T)
   AC_REQUIRE(AC_TYPE_SIZE_T)
@@ -56,7 +54,6 @@
 AC_DEFUN_ONCE(gl_PREREQ_VASNPRINTF,
 
   AC_REQUIRE(AC_FUNC_ALLOCA)
-  AC_REQUIRE(AC_TYPE_LONG_LONG_INT)
   AC_REQUIRE(gt_TYPE_WCHAR_T)
   AC_REQUIRE(gt_TYPE_WINT_T)
   AC_CHECK_FUNCS(snprintf strnlen wcslen wcsnlen mbrtowc wcrtomb)
@@ -77,6 +74,16 @@
          if the buffer had been large enough.)
       ;;
   esac
+  dnl Additionally, the use of %n can be eliminated by assuming that snprintf
+  dnl always produces NUL-terminated strings (no truncation).
+  AC_REQUIRE(gl_SNPRINTF_TRUNCATION_C99)
+  case "$gl_cv_func_snprintf_truncation_c99" in
+    *yes)
+      AC_DEFINE(HAVE_SNPRINTF_TRUNCATION_C99, 1,
+        Define if the string produced by the snprintf function is always NUL
+         terminated.)
+      ;;
+  esac
 )
 
 # Extra prerequisites of lib/vasnprintf.c for supporting 'long double'
@@ -145,7 +152,7 @@
       AC_DEFINE(NEED_PRINTF_DIRECTIVE_A, 1,
         Define if the vasnprintf implementation needs special code for
          the 'a' and 'A' directives.)
-      AC_CHECK_FUNCS(nl_langinfo)
+      gl_CHECK_FUNCS_ANDROID(nl_langinfo, #include <langinfo.h>)
       ;;
   esac
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/vsnprintf.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/vsnprintf.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/warn-on-use.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/warn-on-use.m4 Changed

@@ -1,5 +1,5 @@
-# warn-on-use.m4 serial 6
-dnl Copyright (C) 2010-2018 Free Software Foundation, Inc.
+# warn-on-use.m4 serial 10
+dnl Copyright (C) 2010-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -30,21 +30,32 @@
        AH_TEMPLATE(HAVE_RAW_DECL_AS_TR_CPP(m4_defn(gl_decl)),
          Define to 1 if m4_defn(gl_decl) is declared even after
           undefining macros.))dnl
-dnl FIXME: gl_Symbol must be used unquoted until we can assume
-dnl autoconf 2.64 or newer.
      for gl_func in m4_flatten($2); do
        AS_VAR_PUSHDEF(gl_Symbol, gl_cv_have_raw_decl_$gl_func)dnl
+       dnl As a workaround to implicit built-in function declarations in
+       dnl clang (e.g. strndup), reference ac_compile_for_check_decl instead
+       dnl of ac_compile.  If, for whatever reason, the override of AC_PROG_CC
+       dnl in zzgnulib.m4 is inactive, use the original ac_compile.
+       ac_save_ac_compile="$ac_compile"
+       if test -n "$ac_compile_for_check_decl"; then
+         ac_compile="$ac_compile_for_check_decl"
+       fi
        AC_CACHE_CHECK(whether $gl_func is declared without a macro,
-         gl_Symbol,
+         gl_Symbol,
          AC_COMPILE_IFELSE(AC_LANG_PROGRAM($1,
-@%:@undef $gl_func
-  (void) $gl_func;),
-           AS_VAR_SET(gl_Symbol, yes), AS_VAR_SET(gl_Symbol, no)))
-       AS_VAR_IF(gl_Symbol, yes,
+#undef $gl_func
+  (void) $gl_func;),
+           AS_VAR_SET(gl_Symbol, yes), AS_VAR_SET(gl_Symbol, no)))
+       ac_compile="$ac_save_ac_compile"
+       AS_VAR_IF(gl_Symbol, yes,
          AC_DEFINE_UNQUOTED(AS_TR_CPP(HAVE_RAW_DECL_$gl_func), 1)
-          dnl shortcut - if the raw declaration exists, then set a cache
-          dnl variable to allow skipping any later AC_CHECK_DECL efforts
-          eval ac_cv_have_decl_$gl_func=yes)
+          dnl Shortcut for an AC_CHECK_DECL invocation that may come later:
+          dnl If the raw declaration exists with the given includes, then
+          dnl AC_CHECK_DECL with its many includes would see it as well.
+          dnl So, set a cache variable to allow skipping any later
+          dnl AC_CHECK_DECL invocation for $gl_func.
+          eval "ac_cv_have_decl_$gl_func=yes"
+         )
        AS_VAR_POPDEF(gl_Symbol)dnl
      done
     )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/wchar_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/wchar_h.m4 Changed

@@ -1,15 +1,15 @@
 dnl A placeholder for ISO C99 <wchar.h>, for platforms that have issues.
 
-dnl Copyright (C) 2007-2018 Free Software Foundation, Inc.
+dnl Copyright (C) 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 dnl Written by Eric Blake.
 
-# wchar_h.m4 serial 43
+# wchar_h.m4 serial 56
 
-AC_DEFUN(gl_WCHAR_H,
+AC_DEFUN_ONCE(gl_WCHAR_H,
 
   AC_REQUIRE(gl_WCHAR_H_DEFAULTS)
   AC_REQUIRE(gl_WCHAR_H_INLINE_OK)
@@ -40,23 +40,24 @@
   dnl Check for declarations of anything we want to poison if the
   dnl corresponding gnulib module is not in use.
   gl_WARN_ON_USE_PREPARE(
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#if !(defined __GLIBC__ && !defined __UCLIBC__)
-# include <stddef.h>
-# include <stdio.h>
-# include <time.h>
-#endif
-#include <wchar.h>
+      #include <wchar.h>
     ,
     btowc wctob mbsinit mbrtowc mbrlen mbsrtowcs mbsnrtowcs wcrtomb
-     wcsrtombs wcsnrtombs wcwidth wmemchr wmemcmp wmemcpy wmemmove wmemset
+     wcsrtombs wcsnrtombs wcwidth
+     wmemchr wmemcmp wmemcpy wmemmove wmempcpy wmemset
      wcslen wcsnlen wcscpy wcpcpy wcsncpy wcpncpy wcscat wcsncat wcscmp
      wcsncmp wcscasecmp wcsncasecmp wcscoll wcsxfrm wcsdup wcschr wcsrchr
      wcscspn wcsspn wcspbrk wcsstr wcstok wcswidth wcsftime
     )
+
+  AC_REQUIRE(AC_C_RESTRICT)
+
+  AC_CHECK_DECLS(wcsdup, , , 
+      #include <wchar.h>
+    )
+  if test $ac_cv_have_decl_wcsdup = no; then
+    HAVE_DECL_WCSDUP=0
+  fi
 )
 
 dnl Check whether <wchar.h> is usable at all.
@@ -67,56 +68,49 @@
   dnl and <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=42440>. In summary,
   dnl glibc version 2.5 or older, together with gcc version 4.3 or newer and
   dnl the option -std=c99 or -std=gnu99, leads to a broken <wchar.h>.
+  AC_REQUIRE(AC_CANONICAL_HOST)
   AC_CACHE_CHECK(whether <wchar.h> uses 'inline' correctly,
     gl_cv_header_wchar_h_correct_inline,
     gl_cv_header_wchar_h_correct_inline=yes
-     AC_LANG_CONFTEST(
-       AC_LANG_SOURCE(#define wcstod renamed_wcstod
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
-extern int zero (void);
-int main () { return zero(); }
-))
-     dnl Do not rename the object file from conftest.$ac_objext to
-     dnl conftest1.$ac_objext, as this will cause the link to fail on
-     dnl z/OS when using the XPLINK object format (due to duplicate
-     dnl CSECT names). Instead, temporarily redefine $ac_compile so
-     dnl that the object file has the latter name from the start.
-     save_ac_compile="$ac_compile"
-     ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest1/`
-     if echo '#include "conftest.c"' >conftest1.c &&
-        AC_TRY_EVAL(ac_compile); then
-       AC_LANG_CONFTEST(
-         AC_LANG_SOURCE(#define wcstod renamed_wcstod
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
-int zero (void) { return 0; }
-))
-       dnl See note above about renaming object files.
-       ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest2/`
-       if echo '#include "conftest.c"' >conftest2.c &&
-          AC_TRY_EVAL(ac_compile); then
-         if $CC -o conftest$ac_exeext $CFLAGS $LDFLAGS conftest1.$ac_objext conftest2.$ac_objext $LIBS >&AS_MESSAGE_LOG_FD 2>&1; then
-           :
-         else
-           gl_cv_header_wchar_h_correct_inline=no
+     case "$host_os" in
+       *-gnu* | gnu*)
+         AC_LANG_CONFTEST(
+           AC_LANG_SOURCE(
+             #define wcstod renamed_wcstod
+             #include <wchar.h>
+             extern int zero (void);
+             int main () { return zero(); }
+           ))
+         dnl Do not rename the object file from conftest.$ac_objext to
+         dnl conftest1.$ac_objext, as this will cause the link to fail on
+         dnl z/OS when using the XPLINK object format (due to duplicate
+         dnl CSECT names). Instead, temporarily redefine $ac_compile so
+         dnl that the object file has the latter name from the start.
+         save_ac_compile="$ac_compile"
+         ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest1/`
+         if echo '#include "conftest.c"' >conftest1.c \
+            && AC_TRY_EVAL(ac_compile); then
+           AC_LANG_CONFTEST(
+             AC_LANG_SOURCE(
+               #define wcstod renamed_wcstod
+               #include <wchar.h>
+               int zero (void) { return 0; }
+             ))
+           dnl See note above about renaming object files.
+           ac_compile=`echo "$save_ac_compile" | sed s/conftest/conftest2/`
+           if echo '#include "conftest.c"' >conftest2.c \
+              && AC_TRY_EVAL(ac_compile); then
+             if $CC -o conftest$ac_exeext $CFLAGS $LDFLAGS conftest1.$ac_objext conftest2.$ac_objext $LIBS >&AS_MESSAGE_LOG_FD 2>&1; then
+               :
+             else
+               gl_cv_header_wchar_h_correct_inline=no
+             fi
+           fi
          fi
-       fi
-     fi
-     ac_compile="$save_ac_compile"
-     rm -f conftest12.c conftest12.$ac_objext conftest$ac_exeext
+         ac_compile="$save_ac_compile"
+         rm -f conftest12.c conftest12.$ac_objext conftest$ac_exeext
+         ;;
+     esac
     )
   if test $gl_cv_header_wchar_h_correct_inline = no; then
     AC_MSG_ERROR(<wchar.h> cannot be used with this compiler ($CC $CFLAGS $CPPFLAGS).
@@ -131,57 +125,77 @@
   fi
 )
 
+# gl_WCHAR_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_WCHAR_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_WCHAR_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_WCHAR_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
   dnl Define it also as a C macro, for the benefit of the unit tests.
   gl_MODULE_INDICATOR_FOR_TESTS($1)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_WCHAR_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_WCHAR_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_BTOWC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCTOB)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSINIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBRTOWC)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBRLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSRTOWCS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MBSNRTOWCS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCRTOMB)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSRTOMBS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNRTOMBS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCWIDTH)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMCMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMMOVE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMPCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WMEMSET)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNLEN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCPCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCPNCPY)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNCAT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNCMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCASECMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSNCASECMP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCOLL)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSXFRM)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSDUP)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSRCHR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSCSPN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSSPN)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSPBRK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSSTR)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSTOK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSWIDTH)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCSFTIME)
+    dnl Support Microsoft deprecated alias function names by default.
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_MDA_WCSDUP, 1)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_WCHAR_H_MODULE_INDICATOR_DEFAULTS)
+  dnl Make sure the shell variable for GNULIB_FREE_POSIX is initialized.
+  gl_STDLIB_H_REQUIRE_DEFAULTS
+  AC_REQUIRE(gl_WCHAR_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_WCHAR_H_DEFAULTS,
 
-  GNULIB_BTOWC=0;       AC_SUBST(GNULIB_BTOWC)
-  GNULIB_WCTOB=0;       AC_SUBST(GNULIB_WCTOB)
-  GNULIB_MBSINIT=0;     AC_SUBST(GNULIB_MBSINIT)
-  GNULIB_MBRTOWC=0;     AC_SUBST(GNULIB_MBRTOWC)
-  GNULIB_MBRLEN=0;      AC_SUBST(GNULIB_MBRLEN)
-  GNULIB_MBSRTOWCS=0;   AC_SUBST(GNULIB_MBSRTOWCS)
-  GNULIB_MBSNRTOWCS=0;  AC_SUBST(GNULIB_MBSNRTOWCS)
-  GNULIB_WCRTOMB=0;     AC_SUBST(GNULIB_WCRTOMB)
-  GNULIB_WCSRTOMBS=0;   AC_SUBST(GNULIB_WCSRTOMBS)
-  GNULIB_WCSNRTOMBS=0;  AC_SUBST(GNULIB_WCSNRTOMBS)
-  GNULIB_WCWIDTH=0;     AC_SUBST(GNULIB_WCWIDTH)
-  GNULIB_WMEMCHR=0;     AC_SUBST(GNULIB_WMEMCHR)
-  GNULIB_WMEMCMP=0;     AC_SUBST(GNULIB_WMEMCMP)
-  GNULIB_WMEMCPY=0;     AC_SUBST(GNULIB_WMEMCPY)
-  GNULIB_WMEMMOVE=0;    AC_SUBST(GNULIB_WMEMMOVE)
-  GNULIB_WMEMSET=0;     AC_SUBST(GNULIB_WMEMSET)
-  GNULIB_WCSLEN=0;      AC_SUBST(GNULIB_WCSLEN)
-  GNULIB_WCSNLEN=0;     AC_SUBST(GNULIB_WCSNLEN)
-  GNULIB_WCSCPY=0;      AC_SUBST(GNULIB_WCSCPY)
-  GNULIB_WCPCPY=0;      AC_SUBST(GNULIB_WCPCPY)
-  GNULIB_WCSNCPY=0;     AC_SUBST(GNULIB_WCSNCPY)
-  GNULIB_WCPNCPY=0;     AC_SUBST(GNULIB_WCPNCPY)
-  GNULIB_WCSCAT=0;      AC_SUBST(GNULIB_WCSCAT)
-  GNULIB_WCSNCAT=0;     AC_SUBST(GNULIB_WCSNCAT)
-  GNULIB_WCSCMP=0;      AC_SUBST(GNULIB_WCSCMP)
-  GNULIB_WCSNCMP=0;     AC_SUBST(GNULIB_WCSNCMP)
-  GNULIB_WCSCASECMP=0;  AC_SUBST(GNULIB_WCSCASECMP)
-  GNULIB_WCSNCASECMP=0; AC_SUBST(GNULIB_WCSNCASECMP)
-  GNULIB_WCSCOLL=0;     AC_SUBST(GNULIB_WCSCOLL)
-  GNULIB_WCSXFRM=0;     AC_SUBST(GNULIB_WCSXFRM)
-  GNULIB_WCSDUP=0;      AC_SUBST(GNULIB_WCSDUP)
-  GNULIB_WCSCHR=0;      AC_SUBST(GNULIB_WCSCHR)
-  GNULIB_WCSRCHR=0;     AC_SUBST(GNULIB_WCSRCHR)
-  GNULIB_WCSCSPN=0;     AC_SUBST(GNULIB_WCSCSPN)
-  GNULIB_WCSSPN=0;      AC_SUBST(GNULIB_WCSSPN)
-  GNULIB_WCSPBRK=0;     AC_SUBST(GNULIB_WCSPBRK)
-  GNULIB_WCSSTR=0;      AC_SUBST(GNULIB_WCSSTR)
-  GNULIB_WCSTOK=0;      AC_SUBST(GNULIB_WCSTOK)
-  GNULIB_WCSWIDTH=0;    AC_SUBST(GNULIB_WCSWIDTH)
-  GNULIB_WCSFTIME=0;    AC_SUBST(GNULIB_WCSFTIME)
   dnl Assume proper GNU behavior unless another module says otherwise.
   HAVE_BTOWC=1;         AC_SUBST(HAVE_BTOWC)
   HAVE_MBSINIT=1;       AC_SUBST(HAVE_MBSINIT)
@@ -196,6 +210,7 @@
   HAVE_WMEMCMP=1;       AC_SUBST(HAVE_WMEMCMP)
   HAVE_WMEMCPY=1;       AC_SUBST(HAVE_WMEMCPY)
   HAVE_WMEMMOVE=1;      AC_SUBST(HAVE_WMEMMOVE)
+  HAVE_WMEMPCPY=1;      AC_SUBST(HAVE_WMEMPCPY)
   HAVE_WMEMSET=1;       AC_SUBST(HAVE_WMEMSET)
   HAVE_WCSLEN=1;        AC_SUBST(HAVE_WCSLEN)
   HAVE_WCSNLEN=1;       AC_SUBST(HAVE_WCSNLEN)
@@ -222,6 +237,7 @@
   HAVE_WCSWIDTH=1;      AC_SUBST(HAVE_WCSWIDTH)
   HAVE_WCSFTIME=1;      AC_SUBST(HAVE_WCSFTIME)
   HAVE_DECL_WCTOB=1;    AC_SUBST(HAVE_DECL_WCTOB)
+  HAVE_DECL_WCSDUP=1;   AC_SUBST(HAVE_DECL_WCSDUP)
   HAVE_DECL_WCWIDTH=1;  AC_SUBST(HAVE_DECL_WCWIDTH)
   REPLACE_MBSTATE_T=0;  AC_SUBST(REPLACE_MBSTATE_T)
   REPLACE_BTOWC=0;      AC_SUBST(REPLACE_BTOWC)
@@ -237,4 +253,6 @@
   REPLACE_WCWIDTH=0;    AC_SUBST(REPLACE_WCWIDTH)
   REPLACE_WCSWIDTH=0;   AC_SUBST(REPLACE_WCSWIDTH)
   REPLACE_WCSFTIME=0;   AC_SUBST(REPLACE_WCSFTIME)
+  REPLACE_WCSTOK=0;     AC_SUBST(REPLACE_WCSTOK)
+  REPLACE_WMEMPCPY=0;   AC_SUBST(REPLACE_WMEMPCPY)
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/wchar_t.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/wchar_t.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/wctype_h.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/wctype_h.m4 Changed

@@ -1,15 +1,15 @@
-# wctype_h.m4 serial 21
+# wctype_h.m4 serial 30
 
 dnl A placeholder for ISO C99 <wctype.h>, for platforms that lack it.
 
-dnl Copyright (C) 2006-2018 Free Software Foundation, Inc.
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
 
 dnl Written by Paul Eggert.
 
-AC_DEFUN(gl_WCTYPE_H,
+AC_DEFUN_ONCE(gl_WCTYPE_H,
 
   AC_REQUIRE(gl_WCTYPE_H_DEFAULTS)
   AC_REQUIRE(AC_PROG_CC)
@@ -41,13 +41,6 @@
         
           AC_RUN_IFELSE(
             AC_LANG_SOURCE(
-               /* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-                  included before <wchar.h>.
-                  BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-                  must be included before <wchar.h>.  */
-               #include <stddef.h>
-               #include <stdio.h>
-               #include <time.h>
                #include <wchar.h>
                #include <wctype.h>
                int main () { return iswprint ('x') == 0; }
@@ -57,7 +50,7 @@
              AC_COMPILE_IFELSE(AC_LANG_PROGRAM(#include <stdlib.h>
                           #if __GNU_LIBRARY__ == 1
                           Linux libc5 i18n is broken.
-                          #endif, ),
+                          #endif, ),
               gl_cv_func_iswcntrl_works="guessing yes",
               gl_cv_func_iswcntrl_works="guessing no")
             )
@@ -69,10 +62,14 @@
   fi
   AC_SUBST(HAVE_WCTYPE_H)
 
-  case "$gl_cv_func_iswcntrl_works" in
-    *yes) REPLACE_ISWCNTRL=0 ;;
-    *)    REPLACE_ISWCNTRL=1 ;;
-  esac
+  if test $GNULIBHEADERS_OVERRIDE_WINT_T = 1; then
+    REPLACE_ISWCNTRL=1
+  else
+    case "$gl_cv_func_iswcntrl_works" in
+      *yes) REPLACE_ISWCNTRL=0 ;;
+      *)    REPLACE_ISWCNTRL=1 ;;
+    esac
+  fi
   AC_SUBST(REPLACE_ISWCNTRL)
 
   if test $HAVE_ISWCNTRL = 0 || test $REPLACE_ISWCNTRL = 1; then
@@ -88,14 +85,7 @@
       REPLACE_TOWLOWER=0
     else
       AC_CHECK_DECLS(towlower,,,
-        /* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-             included before <wchar.h>.
-             BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-             must be included before <wchar.h>.  */
-          #include <stddef.h>
-          #include <stdio.h>
-          #include <time.h>
-          #include <wchar.h>
+        #include <wchar.h>
           #if HAVE_WCTYPE_H
           # include <wctype.h>
           #endif
@@ -124,14 +114,7 @@
   AC_CACHE_CHECK(for wctype_t, gl_cv_type_wctype_t,
     AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
-          /* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-               included before <wchar.h>.
-               BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-               must be included before <wchar.h>.  */
-            #include <stddef.h>
-            #include <stdio.h>
-            #include <time.h>
-            #include <wchar.h>
+          #include <wchar.h>
             #if HAVE_WCTYPE_H
             # include <wctype.h>
             #endif
@@ -150,14 +133,7 @@
   AC_CACHE_CHECK(for wctrans_t, gl_cv_type_wctrans_t,
     AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
-          /* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be
-               included before <wchar.h>.
-               BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h>
-               must be included before <wchar.h>.  */
-            #include <stddef.h>
-            #include <stdio.h>
-            #include <time.h>
-            #include <wchar.h>
+          #include <wchar.h>
             #include <wctype.h>
             wctrans_t a;
           ,
@@ -172,14 +148,7 @@
   dnl Check for declarations of anything we want to poison if the
   dnl corresponding gnulib module is not in use.
   gl_WARN_ON_USE_PREPARE(
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
 #if !(defined __GLIBC__ && !defined __UCLIBC__)
-# include <stddef.h>
-# include <stdio.h>
-# include <time.h>
 # include <wchar.h>
 #endif
 #include <wctype.h>
@@ -188,25 +157,44 @@
     )
 )
 
+# gl_WCTYPE_MODULE_INDICATOR(modulename)
+# sets the shell variable that indicates the presence of the given module
+# to a C preprocessor expression that will evaluate to 1.
+# This macro invocation must not occur in macros that are AC_REQUIREd.
 AC_DEFUN(gl_WCTYPE_MODULE_INDICATOR,
 
-  dnl Use AC_REQUIRE here, so that the default settings are expanded once only.
-  AC_REQUIRE(gl_WCTYPE_H_DEFAULTS)
+  dnl Ensure to expand the default settings once only.
+  gl_WCTYPE_H_REQUIRE_DEFAULTS
   gl_MODULE_INDICATOR_SET_VARIABLE($1)
   dnl Define it also as a C macro, for the benefit of the unit tests.
   gl_MODULE_INDICATOR_FOR_TESTS($1)
 )
 
+# Initializes the default values for AC_SUBSTed shell variables.
+# This macro must not be AC_REQUIREd.  It must only be invoked, and only
+# outside of macros or in macros that are not AC_REQUIREd.
+AC_DEFUN(gl_WCTYPE_H_REQUIRE_DEFAULTS,
+
+  m4_defun(GL_MODULE_INDICATOR_PREFIX_WCTYPE_H_MODULE_INDICATOR_DEFAULTS, 
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISWBLANK)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISWDIGIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISWXDIGIT)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCTYPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_ISWCTYPE)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_WCTRANS)
+    gl_MODULE_INDICATOR_INIT_VARIABLE(GNULIB_TOWCTRANS)
+  )
+  m4_require(GL_MODULE_INDICATOR_PREFIX_WCTYPE_H_MODULE_INDICATOR_DEFAULTS)
+  AC_REQUIRE(gl_WCTYPE_H_DEFAULTS)
+)
+
 AC_DEFUN(gl_WCTYPE_H_DEFAULTS,
 
-  GNULIB_ISWBLANK=0;    AC_SUBST(GNULIB_ISWBLANK)
-  GNULIB_WCTYPE=0;      AC_SUBST(GNULIB_WCTYPE)
-  GNULIB_ISWCTYPE=0;    AC_SUBST(GNULIB_ISWCTYPE)
-  GNULIB_WCTRANS=0;     AC_SUBST(GNULIB_WCTRANS)
-  GNULIB_TOWCTRANS=0;   AC_SUBST(GNULIB_TOWCTRANS)
   dnl Assume proper GNU behavior unless another module says otherwise.
   HAVE_ISWBLANK=1;      AC_SUBST(HAVE_ISWBLANK)
   HAVE_WCTYPE_T=1;      AC_SUBST(HAVE_WCTYPE_T)
   HAVE_WCTRANS_T=1;     AC_SUBST(HAVE_WCTRANS_T)
   REPLACE_ISWBLANK=0;   AC_SUBST(REPLACE_ISWBLANK)
+  REPLACE_ISWDIGIT=0;   AC_SUBST(REPLACE_ISWDIGIT)
+  REPLACE_ISWXDIGIT=0;  AC_SUBST(REPLACE_ISWXDIGIT)
 )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/wcwidth.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/wcwidth.m4 Changed

@@ -1,5 +1,5 @@
-# wcwidth.m4 serial 27
-dnl Copyright (C) 2006-2018 Free Software Foundation, Inc.
+# wcwidth.m4 serial 34
+dnl Copyright (C) 2006-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -19,17 +19,8 @@
   AC_CHECK_FUNCS_ONCE(wcwidth)
 
   AC_CHECK_DECLS(wcwidth, , , 
-/* AIX 3.2.5 declares wcwidth in <string.h>. */
-#include <string.h>
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
-)
+    #include <wchar.h>
+  )
   if test $ac_cv_have_decl_wcwidth != yes; then
     HAVE_DECL_WCWIDTH=0
   fi
@@ -50,25 +41,20 @@
   if test $ac_cv_func_wcwidth = yes || test $gl_cv_func_wcwidth_macro = yes; then
     HAVE_WCWIDTH=1
     dnl On Mac OS X 10.3, wcwidth(0x0301) (COMBINING ACUTE ACCENT) returns 1.
-    dnl On OpenBSD 5.0, wcwidth(0x05B0) (HEBREW POINT SHEVA) returns 1.
-    dnl On OSF/1 5.1, wcwidth(0x200B) (ZERO WIDTH SPACE) returns 1.
+    dnl On NetBSD 9.0, OpenBSD 5.0, MidnightBSD 1.1,
+    dnl wcwidth(0x05B0) (HEBREW POINT SHEVA) returns 1.
+    dnl On NetBSD 9.0, MidnightBSD 1.1, OSF/1 5.1,
+    dnl wcwidth(0x200B) (ZERO WIDTH SPACE) returns 1.
     dnl On OpenBSD 5.8, wcwidth(0xFF1A) (FULLWIDTH COLON) returns 0.
     dnl This leads to bugs in 'ls' (coreutils).
+    dnl On Solaris 11.4, wcwidth(0x2202) (PARTIAL DIFFERENTIAL) returns 2,
+    dnl even in Western locales.
     AC_CACHE_CHECK(whether wcwidth works reasonably in UTF-8 locales,
       gl_cv_func_wcwidth_works,
       
         AC_RUN_IFELSE(
           AC_LANG_SOURCE(
 #include <locale.h>
-/* AIX 3.2.5 declares wcwidth in <string.h>. */
-#include <string.h>
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
 #include <wchar.h>
 #if !HAVE_DECL_WCWIDTH
 extern
@@ -80,7 +66,7 @@
 int main ()
 {
   int result = 0;
-  if (setlocale (LC_ALL, "fr_FR.UTF-8") != NULL)
+  if (setlocale (LC_ALL, "en_US.UTF-8") != NULL)
     {
       if (wcwidth (0x0301) > 0)
         result |= 1;
@@ -90,6 +76,8 @@
         result |= 4;
       if (wcwidth (0xFF1A) == 0)
         result |= 8;
+      if (wcwidth (0x2202) > 1)
+        result |= 16;
     }
   return result;
 }),
@@ -98,9 +86,13 @@
           
 changequote(,)dnl
            case "$host_os" in
-                                        # Guess yes on glibc and AIX 7 systems.
-             *-gnu* | gnu* | aix7-9*) gl_cv_func_wcwidth_works="guessing yes";;
-             *)                         gl_cv_func_wcwidth_works="guessing no";;
+                            # Guess yes on glibc systems.
+             *-gnu* | gnu*) gl_cv_func_wcwidth_works="guessing yes";;
+                            # Guess yes on musl systems.
+             *-musl*)       gl_cv_func_wcwidth_works="guessing yes";;
+                            # Guess yes on AIX 7 systems.
+             aix7-9*)     gl_cv_func_wcwidth_works="guessing yes";;
+             *)             gl_cv_func_wcwidth_works="$gl_cross_guess_normal";;
            esac
 changequote(,)dnl
           )

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/wint_t.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/wint_t.m4 Changed

@@ -1,5 +1,5 @@
-# wint_t.m4 serial 7
-dnl Copyright (C) 2003, 2007-2018 Free Software Foundation, Inc.
+# wint_t.m4 serial 11
+dnl Copyright (C) 2003, 2007-2023 Free Software Foundation, Inc.
 dnl This file is free software; the Free Software Foundation
 dnl gives unlimited permission to copy and/or distribute it,
 dnl with or without modifications, as long as this notice is preserved.
@@ -14,15 +14,7 @@
   AC_CACHE_CHECK(for wint_t, gt_cv_c_wint_t,
     AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
-          
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be included
-   before <wchar.h>.  */
-#include <stddef.h>
-#include <stdio.h>
-#include <time.h>
-#include <wchar.h>
+          #include <wchar.h>
             wint_t foo = (wchar_t)'\0';,
           ),
        gt_cv_c_wint_t=yes,
@@ -32,33 +24,24 @@
 
     dnl Determine whether gnulib's <wchar.h> or <wctype.h> would, if present,
     dnl override 'wint_t'.
-    AC_CACHE_CHECK(whether wint_t is too small,
-      gl_cv_type_wint_t_too_small,
+    AC_CACHE_CHECK(whether wint_t is large enough,
+      gl_cv_type_wint_t_large_enough,
       AC_COMPILE_IFELSE(
-           AC_LANG_PROGRAM(
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-#if !(defined __GLIBC__ && !defined __UCLIBC__)
-# include <stddef.h>
-# include <stdio.h>
-# include <time.h>
-#endif
-#include <wchar.h>
+         AC_LANG_PROGRAM(
+            #include <wchar.h>
               int verifysizeof (wint_t) < sizeof (int) ? -1 : 1;
-              ),
-           gl_cv_type_wint_t_too_small=no,
-           gl_cv_type_wint_t_too_small=yes))
-    if test $gl_cv_type_wint_t_too_small = yes; then
-      GNULIB_OVERRIDES_WINT_T=1
+            ),
+         gl_cv_type_wint_t_large_enough=yes,
+         gl_cv_type_wint_t_large_enough=no))
+    if test $gl_cv_type_wint_t_large_enough = no; then
+      GNULIBHEADERS_OVERRIDE_WINT_T=1
     else
-      GNULIB_OVERRIDES_WINT_T=0
+      GNULIBHEADERS_OVERRIDE_WINT_T=0
     fi
   else
-    GNULIB_OVERRIDES_WINT_T=0
+    GNULIBHEADERS_OVERRIDE_WINT_T=0
   fi
-  AC_SUBST(GNULIB_OVERRIDES_WINT_T)
+  AC_SUBST(GNULIBHEADERS_OVERRIDE_WINT_T)
 )
 
 dnl Prerequisites of the 'wint_t' override.

_service:tar_scm:groff-1.22.4.tar.gz/gnulib_m4/xsize.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/xsize.m4 Changed

_service:tar_scm:groff-1.23.0.tar.gz/gnulib_m4/zzgnulib.m4 Added

_service:tar_scm:groff-1.23.0.tar.gz/lib/_Noreturn.h Added

@@ -0,0 +1,50 @@
+/* A C macro for declaring that a function does not return.
+   Copyright (C) 2011-2023 Free Software Foundation, Inc.
+
+   This program is free software: you can redistribute it and/or modify it
+   under the terms of the GNU Lesser General Public License as published
+   by the Free Software Foundation; either version 2 of the License, or
+   (at your option) any later version.
+
+   This program 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
+   Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#ifndef _Noreturn
+# if (defined __cplusplus \
+      && ((201103 <= __cplusplus && !(__GNUC__ == 4 && __GNUC_MINOR__ == 7)) \
+          || (defined _MSC_VER && 1900 <= _MSC_VER)) \
+      && 0)
+    /* noreturn is not practically usable, because with it the syntax
+         extern _Noreturn void func (...);
+       would not be valid; such a declaration would only be valid with 'extern'
+       and '_Noreturn' swapped, or without the 'extern' keyword.  However, some
+       AIX system header files and several gnulib header files use precisely
+       this syntax with 'extern'.  */
+#  define _Noreturn noreturn
+# elif (defined __clang__ && __clang_major__ < 16 \
+        && defined _GL_WORK_AROUND_LLVM_BUG_59792)
+   /* Compile with -D_GL_WORK_AROUND_LLVM_BUG_59792 to work around
+      that rare LLVM bug, though you may get many false-alarm warnings.  */
+#  define _Noreturn
+# elif ((!defined __cplusplus || defined __clang__) \
+        && (201112 <= (defined __STDC_VERSION__ ? __STDC_VERSION__ : 0) \
+            || (!defined __STRICT_ANSI__ \
+                && (4 < __GNUC__ + (7 <= __GNUC_MINOR__) \
+                    || (defined __apple_build_version__ \
+                        ? 6000000 <= __apple_build_version__ \
+                        : 3 < __clang_major__ + (5 <= __clang_minor__))))))
+   /* _Noreturn works as-is.  */
+# elif (2 < __GNUC__ + (8 <= __GNUC_MINOR__) || defined __clang__ \
+        || 0x5110 <= __SUNPRO_C)
+#  define _Noreturn __attribute__ ((__noreturn__))
+# elif 1200 <= (defined _MSC_VER ? _MSC_VER : 0)
+#  define _Noreturn __declspec (noreturn)
+# else
+#  define _Noreturn
+# endif
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/alloca.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/alloca.in.h Changed

@@ -1,22 +1,20 @@
 /* Memory allocation on the stack.
 
-   Copyright (C) 1995, 1999, 2001-2004, 2006-2018 Free Software Foundation,
+   Copyright (C) 1995, 1999, 2001-2004, 2006-2023 Free Software Foundation,
    Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public
-   License along with this program; if not, see
-   <https://www.gnu.org/licenses/>.
-  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Avoid using the symbol _ALLOCA_H here, as Bison assumes _ALLOCA_H
    means there is a real alloca function.  */
@@ -35,7 +33,16 @@
  */
 
 #ifndef alloca
-# ifdef __GNUC__
+  /* Some version of mingw have an <alloca.h> that causes trouble when
+     included after 'alloca' gets defined as a macro.  As a workaround,
+     include this <alloca.h> first and define 'alloca' as a macro afterwards
+     if needed.  */
+# if defined __GNUC__ && (defined _WIN32 && ! defined __CYGWIN__) && @HAVE_ALLOCA_H@
+#  include_next <alloca.h>
+# endif
+#endif
+#ifndef alloca
+# if defined __GNUC__ || (__clang_major__ >= 4)
 #  define alloca __builtin_alloca
 # elif defined _AIX
 #  define alloca __alloca

_service:tar_scm:groff-1.22.4.tar.gz/lib/arg-nonnull.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/arg-nonnull.h Changed

@@ -1,24 +1,24 @@
 /* A C macro for declaring that specific arguments must not be NULL.
-   Copyright (C) 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2009-2023 Free Software Foundation, Inc.
 
    This program 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
+   under the terms of the GNU Lesser General Public License as published
+   by the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program 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.
+   Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* _GL_ARG_NONNULL((n,...,m)) tells the compiler and static analyzer tools
    that the values passed as arguments n, ..., m must be non-NULL pointers.
    n = 1 stands for the first argument, n = 2 for the second argument etc.  */
 #ifndef _GL_ARG_NONNULL
-# if (__GNUC__ == 3 && __GNUC_MINOR__ >= 3) || __GNUC__ > 3
+# if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 3) || defined __clang__
 #  define _GL_ARG_NONNULL(params) __attribute__ ((__nonnull__ params))
 # else
 #  define _GL_ARG_NONNULL(params)

_service:tar_scm:groff-1.22.4.tar.gz/lib/asnprintf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/asnprintf.c Changed

@@ -1,18 +1,18 @@
 /* Formatted output to strings.
-   Copyright (C) 1999, 2002, 2006, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 1999, 2002, 2006, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.23.0.tar.gz/lib/assert.in.h Added

@@ -0,0 +1,27 @@
+/* Substitute for and wrapper around <assert.h>
+   Copyright (C) 2011-2023 Free Software Foundation, Inc.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+/* Do not guard the include, since <assert.h> is supposed to define
+   the assert macro each time it is included.  */
+
+#if __GNUC__ >= 3
+@PRAGMA_SYSTEM_HEADER@
+#endif
+@PRAGMA_COLUMNS@
+
+#@INCLUDE_NEXT@ @NEXT_ASSERT_H@
+
+/* The definition of static_assert is copied here.  */

_service:tar_scm:groff-1.23.0.tar.gz/lib/attribute.h Added

@@ -0,0 +1,226 @@
+/* ATTRIBUTE_* macros for using attributes in GCC and similar compilers
+
+   Copyright 2020-2023 Free Software Foundation, Inc.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+/* Written by Paul Eggert.  */
+
+/* Provide public ATTRIBUTE_* names for the private _GL_ATTRIBUTE_*
+   macros used within Gnulib.  */
+
+/* These attributes can be placed in two ways:
+     - At the start of a declaration (i.e. even before storage-class
+       specifiers!); then they apply to all entities that are declared
+       by the declaration.
+     - Immediately after the name of an entity being declared by the
+       declaration; then they apply to that entity only.  */
+
+#ifndef _GL_ATTRIBUTE_H
+#define _GL_ATTRIBUTE_H
+
+
+/* This file defines two types of attributes:
+   * C23 standard attributes.  These have macro names that do not begin with
+     'ATTRIBUTE_'.
+   * Selected GCC attributes; see:
+     https://gcc.gnu.org/onlinedocs/gcc/Common-Function-Attributes.html
+     https://gcc.gnu.org/onlinedocs/gcc/Common-Variable-Attributes.html
+     https://gcc.gnu.org/onlinedocs/gcc/Common-Type-Attributes.html
+     These names begin with 'ATTRIBUTE_' to avoid name clashes.  */
+
+
+/* =============== Attributes for specific kinds of functions =============== */
+
+/* Attributes for functions that should not be used.  */
+
+/* Warn if the entity is used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: namespace, class, template specialization.  */
+#define DEPRECATED _GL_ATTRIBUTE_DEPRECATED
+
+/* If a function call is not optimized way, warn with MSG.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_WARNING(msg) _GL_ATTRIBUTE_WARNING (msg)
+
+/* If a function call is not optimized way, report an error with MSG.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_ERROR(msg) _GL_ATTRIBUTE_ERROR (msg)
+
+
+/* Attributes for memory-allocating functions.  */
+
+/* The function returns a pointer to freshly allocated memory.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_MALLOC _GL_ATTRIBUTE_MALLOC
+
+/* ATTRIBUTE_ALLOC_SIZE ((N)) - The Nth argument of the function
+   is the size of the returned memory block.
+   ATTRIBUTE_ALLOC_SIZE ((M, N)) - Multiply the Mth and Nth arguments
+   to determine the size of the returned memory block.  */
+/* Applies to: function, pointer to function, function types.  */
+#define ATTRIBUTE_ALLOC_SIZE(args) _GL_ATTRIBUTE_ALLOC_SIZE (args)
+
+/* ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.
+   ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#define ATTRIBUTE_DEALLOC(f, i) _GL_ATTRIBUTE_DEALLOC(f, i)
+#define ATTRIBUTE_DEALLOC_FREE _GL_ATTRIBUTE_DEALLOC_FREE
+
+/* Attributes for variadic functions.  */
+
+/* The variadic function expects a trailing NULL argument.
+   ATTRIBUTE_SENTINEL () - The last argument is NULL (requires C99).
+   ATTRIBUTE_SENTINEL ((N)) - The (N+1)st argument from the end is NULL.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_SENTINEL(pos) _GL_ATTRIBUTE_SENTINEL (pos)
+
+
+/* ================== Attributes for compiler diagnostics ================== */
+
+/* Attributes that help the compiler diagnose programmer mistakes.
+   Some of them may also help for some compiler optimizations.  */
+
+/* ATTRIBUTE_FORMAT ((ARCHETYPE, STRING-INDEX, FIRST-TO-CHECK)) -
+   The STRING-INDEXth function argument is a format string of style
+   ARCHETYPE, which is one of:
+     printf, gnu_printf
+     scanf, gnu_scanf,
+     strftime, gnu_strftime,
+     strfmon,
+   or the same thing prefixed and suffixed with '__'.
+   If FIRST-TO-CHECK is not 0, arguments starting at FIRST-TO_CHECK
+   are suitable for the format string.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_FORMAT(spec) _GL_ATTRIBUTE_FORMAT (spec)
+
+/* ATTRIBUTE_NONNULL ((N1, N2,...)) - Arguments N1, N2,... must not be NULL.
+   ATTRIBUTE_NONNULL () - All pointer arguments must not be null.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_NONNULL(args) _GL_ATTRIBUTE_NONNULL (args)
+
+/* The function's return value is a non-NULL pointer.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_RETURNS_NONNULL _GL_ATTRIBUTE_RETURNS_NONNULL
+
+/* Warn if the caller does not use the return value,
+   unless the caller uses something like ignore_value.  */
+/* Applies to: function, enumeration, class.  */
+#define NODISCARD _GL_ATTRIBUTE_NODISCARD
+
+
+/* Attributes that disable false alarms when the compiler diagnoses
+   programmer "mistakes".  */
+
+/* Do not warn if the entity is not used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: class.  */
+#define MAYBE_UNUSED _GL_ATTRIBUTE_MAYBE_UNUSED
+
+/* The contents of a character array is not meant to be NUL-terminated.  */
+/* Applies to: struct/union members and variables that are arrays of element
+   type 'unsigned char'.  */
+#define ATTRIBUTE_NONSTRING _GL_ATTRIBUTE_NONSTRING
+
+/* Do not warn if control flow falls through to the immediately
+   following 'case' or 'default' label.  */
+/* Applies to: Empty statement (;), inside a 'switch' statement.  */
+#define FALLTHROUGH _GL_ATTRIBUTE_FALLTHROUGH
+
+
+/* ================== Attributes for debugging information ================== */
+
+/* Attributes regarding debugging information emitted by the compiler.  */
+
+/* Omit the function from stack traces when debugging.  */
+/* Applies to: function.  */
+#define ATTRIBUTE_ARTIFICIAL _GL_ATTRIBUTE_ARTIFICIAL
+
+/* Make the entity visible to debuggers etc., even with '-fwhole-program'.  */
+/* Applies to: functions, variables.  */
+#define ATTRIBUTE_EXTERNALLY_VISIBLE _GL_ATTRIBUTE_EXTERNALLY_VISIBLE
+
+
+/* ========== Attributes that mainly direct compiler optimizations ========== */
+
+/* The function does not throw exceptions.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_NOTHROW _GL_ATTRIBUTE_NOTHROW
+
+/* Do not inline the function.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_NOINLINE _GL_ATTRIBUTE_NOINLINE
+
+/* Always inline the function, and report an error if the compiler
+   cannot inline.  */
+/* Applies to: function.  */
+#define ATTRIBUTE_ALWAYS_INLINE _GL_ATTRIBUTE_ALWAYS_INLINE
+
+/* It is OK for a compiler to omit duplicate calls with the same arguments.
+   This attribute is safe for a function that neither depends on
+   nor affects observable state, and always returns exactly once -
+   e.g., does not loop forever, and does not call longjmp.
+   (This attribute is stricter than ATTRIBUTE_PURE.)  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_CONST _GL_ATTRIBUTE_CONST
+
+/* It is OK for a compiler to omit duplicate calls with the same
+   arguments if observable state is not changed between calls.
+   This attribute is safe for a function that does not affect
+   observable state, and always returns exactly once.
+   (This attribute is looser than ATTRIBUTE_CONST.)  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_PURE _GL_ATTRIBUTE_PURE
+
+/* The function is rarely executed.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_COLD _GL_ATTRIBUTE_COLD
+
+/* If called from some other compilation unit, the function executes
+   code from that unit only by return or by exception handling,
+   letting the compiler optimize that unit more aggressively.  */
+/* Applies to: functions.  */
+#define ATTRIBUTE_LEAF _GL_ATTRIBUTE_LEAF
+
+/* For struct members: The member has the smallest possible alignment.
+   For struct, union, class: All members have the smallest possible alignment,
+   minimizing the memory required.  */
+/* Applies to: struct members, struct, union,
+   in C++ also: class.  */
+#define ATTRIBUTE_PACKED _GL_ATTRIBUTE_PACKED
+
+
+/* ================ Attributes that make invalid code valid ================ */
+
+/* Attributes that prevent fatal compiler optimizations for code that is not
+   fully ISO C compliant.  */
+
+/* Pointers to the type may point to the same storage as pointers to
+   other types, thus disabling strict aliasing optimization.  */
+/* Applies to: types.  */
+#define ATTRIBUTE_MAY_ALIAS _GL_ATTRIBUTE_MAY_ALIAS
+
+
+#endif /* _GL_ATTRIBUTE_H */

_service:tar_scm:groff-1.22.4.tar.gz/lib/c++defs.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/c++defs.h Changed

@@ -1,17 +1,17 @@
 /* C++ compatible function declaration macros.
-   Copyright (C) 2010-2018 Free Software Foundation, Inc.
+   Copyright (C) 2010-2023 Free Software Foundation, Inc.
 
    This program 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
+   under the terms of the GNU Lesser General Public License as published
+   by the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program 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.
+   Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _GL_CXXDEFS_H
@@ -146,6 +146,16 @@
     _GL_EXTERN_C int _gl_cxxalias_dummy
 #endif
 
+/* _GL_CXXALIAS_MDA (func, rettype, parameters);
+   is to be used when func is a Microsoft deprecated alias, on native Windows.
+   It declares a C++ alias called GNULIB_NAMESPACE::func
+   that redirects to _func, if GNULIB_NAMESPACE is defined.
+   Example:
+     _GL_CXXALIAS_MDA (open, int, (const char *filename, int flags, ...));
+ */
+#define _GL_CXXALIAS_MDA(func,rettype,parameters) \
+  _GL_CXXALIAS_RPL_1 (func, _##func, rettype, parameters)
+
 /* _GL_CXXALIAS_RPL_CAST_1 (func, rpl_func, rettype, parameters);
    is like  _GL_CXXALIAS_RPL_1 (func, rpl_func, rettype, parameters);
    except that the C function rpl_func may have a slightly different
@@ -171,6 +181,14 @@
     _GL_EXTERN_C int _gl_cxxalias_dummy
 #endif
 
+/* _GL_CXXALIAS_MDA_CAST (func, rettype, parameters);
+   is like  _GL_CXXALIAS_MDA (func, rettype, parameters);
+   except that the C function func may have a slightly different declaration.
+   A cast is used to silence the "invalid conversion" error that would
+   otherwise occur.  */
+#define _GL_CXXALIAS_MDA_CAST(func,rettype,parameters) \
+  _GL_CXXALIAS_RPL_CAST_1 (func, _##func, rettype, parameters)
+
 /* _GL_CXXALIAS_SYS (func, rettype, parameters);
    declares a C++ alias called GNULIB_NAMESPACE::func
    that redirects to the system provided function func, if GNULIB_NAMESPACE
@@ -268,7 +286,7 @@
    _GL_CXXALIASWARN_2 (func, namespace)
 /* To work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=43881>,
    we enable the warning only when not optimizing.  */
-# if !__OPTIMIZE__
+# if !(defined __GNUC__ && !defined __clang__ && __OPTIMIZE__)
 #  define _GL_CXXALIASWARN_2(func,namespace) \
     _GL_WARN_ON_USE (func, \
                      "The symbol ::" #func " refers to the system function. " \
@@ -296,14 +314,11 @@
    _GL_CXXALIASWARN1_2 (func, rettype, parameters_and_attributes, namespace)
 /* To work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=43881>,
    we enable the warning only when not optimizing.  */
-# if !__OPTIMIZE__
+# if !(defined __GNUC__ && !defined __clang__ && __OPTIMIZE__)
 #  define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \
-    _GL_WARN_ON_USE_CXX (func, rettype, parameters_and_attributes, \
+    _GL_WARN_ON_USE_CXX (func, rettype, rettype, parameters_and_attributes, \
                          "The symbol ::" #func " refers to the system function. " \
                          "Use " #namespace "::" #func " instead.")
-# elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING
-#  define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \
-     extern __typeof__ (func) func
 # else
 #  define _GL_CXXALIASWARN1_2(func,rettype,parameters_and_attributes,namespace) \
      _GL_EXTERN_C int _gl_cxxalias_dummy

_service:tar_scm:groff-1.22.4.tar.gz/lib/errno.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/errno.in.h Changed

@@ -1,19 +1,19 @@
 /* A POSIX-like <errno.h>.
 
-   Copyright (C) 2008-2018 Free Software Foundation, Inc.
+   Copyright (C) 2008-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _@GUARD_PREFIX@_ERRNO_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/float+.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/float+.h Changed

@@ -1,19 +1,19 @@
 /* Supplemental information about the floating-point formats.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2007.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _FLOATPLUS_H
 #define _FLOATPLUS_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/float.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/float.c Changed

@@ -1,18 +1,18 @@
 /* Auxiliary definitions for <float.h>.
-   Copyright (C) 2011-2018 Free Software Foundation, Inc.
+   Copyright (C) 2011-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2011.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/float.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/float.in.h Changed

@@ -1,18 +1,18 @@
 /* A correct <float.h>.
 
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _@GUARD_PREFIX@_FLOAT_H
@@ -93,11 +93,14 @@
      extern const long double LDBL_MAX;
 
    Unfortunately, this is not a constant expression.  */
+# if !GNULIB_defined_long_double_union
 union gl_long_double_union
   {
     struct { unsigned int lo; unsigned int hi; unsigned int exponent; } xd;
     long double ld;
   };
+#  define GNULIB_defined_long_double_union 1
+# endif
 extern const union gl_long_double_union gl_LDBL_MAX;
 # define LDBL_MAX (gl_LDBL_MAX.ld)
 /* Minimum e such that 10^e is in the range of normalized numbers.  */
@@ -146,11 +149,14 @@
 
    Unfortunately, this is not a constant expression, and the latter expression
    does not work well when GCC is optimizing..  */
+# if !GNULIB_defined_long_double_union
 union gl_long_double_union
   {
     struct { double hi; double lo; } dd;
     long double ld;
   };
+#  define GNULIB_defined_long_double_union 1
+# endif
 extern const union gl_long_double_union gl_LDBL_MAX;
 # define LDBL_MAX (gl_LDBL_MAX.ld)
 #endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/fprintf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/fprintf.c Changed

@@ -1,17 +1,17 @@
 /* Formatted output to a stream.
-   Copyright (C) 2004, 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 2004, 2006-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation, either version 3 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifdef HAVE_CONFIG_H
@@ -55,11 +55,7 @@
   if (fwrite (output, 1, len, fp) < len)
     {
       if (output != buf)
-        {
-          int saved_errno = errno;
-          free (output);
-          errno = saved_errno;
-        }
+        free (output);
       return -1;
     }

_service:tar_scm:groff-1.22.4.tar.gz/lib/fpucw.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/fpucw.h Changed

@@ -1,18 +1,18 @@
 /* Manipulating the FPU control word.  -*- coding: utf-8 -*-
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2007.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _FPUCW_H
@@ -43,7 +43,7 @@
 
    See Vincent Lefèvre's page https://www.vinc17.net/research/extended.en.html
    for a good explanation.
-   See http://www.uwsg.iu.edu/hypermail/linux/kernel/0103.0/0453.html for
+   See https://web.archive.org/web/20060905133417/http://www.uwsg.iu.edu/hypermail/linux/kernel/0103.0/0453.html
    some argumentation which setting should be the default.  */
 
 /* This header file provides the following facilities:
@@ -61,8 +61,8 @@
                                     'long double' safe operation precision
  */
 
-/* Inline assembler like this works only with GNU C.  */
-#if (defined __i386__ || defined __x86_64__) && defined __GNUC__
+/* Inline assembler like this works only with GNU C and clang.  */
+#if (defined __i386__ || defined __x86_64__) && (defined __GNUC__ || defined __clang__)
 
 typedef unsigned short fpucw_t; /* glibc calls this fpu_control_t */
 
@@ -70,12 +70,12 @@
 # define FPU_PC_DOUBLE 0x200    /* glibc calls this _FPU_DOUBLE */
 # define FPU_PC_EXTENDED 0x300  /* glibc calls this _FPU_EXTENDED */
 
-# define GET_FPUCW() \
+# define GET_FPUCW() __extension__ \
   ({ fpucw_t _cw;                                               \
      __asm__ __volatile__ ("fnstcw %0" : "=m" (*&_cw));         \
      _cw;                                                       \
    })
-# define SET_FPUCW(word) \
+# define SET_FPUCW(word) __extension__ \
   (void)({ fpucw_t _ncw = (word);                               \
            __asm__ __volatile__ ("fldcw %0" : : "m" (*&_ncw));  \
          })

_service:tar_scm:groff-1.23.0.tar.gz/lib/free.c Added

@@ -0,0 +1,53 @@
+/* Make free() preserve errno.
+
+   Copyright (C) 2003, 2006, 2009-2023 Free Software Foundation, Inc.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+/* written by Paul Eggert */
+
+#include <config.h>
+
+/* Specification.  */
+#include <stdlib.h>
+
+/* A function definition is only needed if HAVE_FREE_POSIX is not defined.  */
+#if !HAVE_FREE_POSIX
+
+# include <errno.h>
+
+void
+rpl_free (void *p)
+# undef free
+{
+# if defined __GNUC__ && !defined __clang__
+  /* An invalid GCC optimization
+     <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=98396>
+     would optimize away the assignments in the code below, when link-time
+     optimization (LTO) is enabled.  Make the code more complicated, so that
+     GCC does not grok how to optimize it.  */
+  int err2;
+  err0 = errno;
+  err1 = errno;
+  errno = 0;
+  free (p);
+  errno = errerrno == 0;
+# else
+  int err = errno;
+  free (p);
+  errno = err;
+# endif
+}
+
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/frexp.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/frexp.c Changed

@@ -1,17 +1,17 @@
 /* Split a double into fraction and mantissa.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Paolo Bonzini <bonzini@gnu.org>, 2003, and

_service:tar_scm:groff-1.22.4.tar.gz/lib/frexpl.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/frexpl.c Changed

@@ -1,17 +1,17 @@
 /* Split a 'long double' into fraction and mantissa.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/fseterr.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/fseterr.c Changed

@@ -1,17 +1,17 @@
 /* Set the error indicator of a stream.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>
@@ -42,7 +42,7 @@
   fp->_flags |= _IOERR;
 #elif defined __minix               /* Minix */
   fp->_flags |= _IOERR;
-#elif defined _IOERR                /* AIX, HP-UX, IRIX, OSF/1, Solaris, OpenServer, mingw, MSVC, NonStop Kernel, OpenVMS */
+#elif defined _IOERR                /* AIX, HP-UX, IRIX, OSF/1, Solaris, OpenServer, UnixWare, mingw, MSVC, NonStop Kernel, OpenVMS */
   fp_->_flag |= _IOERR;
 #elif defined __UCLIBC__            /* uClibc */
   fp->__modeflags |= __FLAG_ERROR;

_service:tar_scm:groff-1.22.4.tar.gz/lib/fseterr.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/fseterr.h Changed

@@ -1,17 +1,17 @@
 /* Set the error indicator of a stream.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _FSETERR_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/gnulib.mk -> _service:tar_scm:groff-1.23.0.tar.gz/lib/gnulib.mk Changed

@@ -1,10 +1,10 @@
 ## DO NOT EDIT! GENERATED AUTOMATICALLY!
 ## Process this file with automake to produce Makefile.in.
-# Copyright (C) 2002-2018 Free Software Foundation, Inc.
+# Copyright (C) 2002-2023 Free Software Foundation, Inc.
 #
 # This file 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 3 of the License, or
 # (at your option) any later version.
 #
 # This file is distributed in the hope that it will be useful,
@@ -30,14 +30,16 @@
 #  --tests-base=tests \
 #  --aux-dir=build-aux \
 #  --makefile-name=gnulib.mk \
+#  --automake-subdir \
 #  --no-conditional-dependencies \
 #  --no-libtool \
 #  --macro-prefix=gl \
 #  fprintf-posix \
 #  git-version-gen \
 #  havelib \
-#  non-recursive-gnulib-prefix-hack \
 #  snprintf \
+#  stdbool-c99 \
+#  stdint \
 #  vsnprintf \
 #  wcwidth
 
@@ -48,6 +50,7 @@
 noinst_LIBRARIES += lib/libgnu.a
 
 lib_libgnu_a_SOURCES =
+lib_libgnu_a_CFLAGS = $(AM_CFLAGS) $(GL_CFLAG_GNULIB_WARNINGS)
 lib_libgnu_a_LIBADD = $(gl_LIBOBJS)
 lib_libgnu_a_DEPENDENCIES = $(gl_LIBOBJS)
 EXTRA_lib_libgnu_a_SOURCES =
@@ -57,7 +60,7 @@
 # Use this preprocessor expression to decide whether #include_next works.
 # Do not rely on a 'configure'-time test for this, since the expression
 # might appear in an installed header, which is used by some other compiler.
-HAVE_INCLUDE_NEXT = lib/(__GNUC__ lib/|| lib/60000000 lib/<= lib/__DECC_VER)
+HAVE_INCLUDE_NEXT = (__GNUC__ || __clang__ || 60000000 <= __DECC_VER)
 
 ## end   gnulib module absolute-header
 
@@ -69,11 +72,11 @@
 # doesn't have one that works with the given compiler.
 if GL_GENERATE_ALLOCA_H
 lib/alloca.h: lib/alloca.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  cat $(top_srcdir)/lib/alloca.in.h; \
-	} > $@-t && \
-	mv -f $@-t $@
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	  -e 's|@''HAVE_ALLOCA_H''@|$(HAVE_ALLOCA_H)|g' \
+	  $(top_srcdir)/lib/alloca.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/alloca.h: $(top_builddir)/config.status
 	rm -f $@
@@ -84,6 +87,45 @@
 
 ## end   gnulib module alloca-opt
 
+## begin gnulib module assert-h
+
+BUILT_SOURCES += $(ASSERT_H)
+
+# We need the following in order to create <assert.h> when the system
+# doesn't have one that works with the given compiler.
+if GL_GENERATE_ASSERT_H
+lib/assert.h: lib/assert.in.h lib/verify.h $(top_builddir)/config.status
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at){ $(SED_HEADER_STDOUT) \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_ASSERT_H''@|$(NEXT_ASSERT_H)|g' \
+	      < $(top_srcdir)/lib/assert.in.h && \
+	  sed -e '/@assert.h omit start@/,/@assert.h omit end@/d' \
+	      -e 's|_gl_verify|_gl_static_assert|g' \
+	      -e 's|_GL_VERIFY|_GL_STATIC_ASSERT|g' \
+	      -e 's|_GL$_STATIC_ASSERT_H$|_GL\1|g' \
+	      < $(top_srcdir)/lib/verify.h; \
+	} > $@-t
+	$(AM_V_at)mv $@-t $@
+else
+lib/assert.h: $(top_builddir)/config.status
+	rm -f $@
+endif
+MOSTLYCLEANFILES += lib/assert.h lib/assert.h-t
+
+EXTRA_DIST += lib/assert.in.h lib/verify.h
+
+## end   gnulib module assert-h
+
+## begin gnulib module attribute
+
+
+EXTRA_DIST += lib/attribute.h
+
+## end   gnulib module attribute
+
 ## begin gnulib module errno
 
 BUILT_SOURCES += $(ERRNO_H)
@@ -92,9 +134,9 @@
 # doesn't have one that is POSIX compliant.
 if GL_GENERATE_ERRNO_H
 lib/errno.h: lib/errno.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -105,9 +147,8 @@
 	      -e 's|@''ENOLINK_VALUE''@|$(ENOLINK_VALUE)|g' \
 	      -e 's|@''EOVERFLOW_HIDDEN''@|$(EOVERFLOW_HIDDEN)|g' \
 	      -e 's|@''EOVERFLOW_VALUE''@|$(EOVERFLOW_VALUE)|g' \
-	      < $(top_srcdir)/lib/errno.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/errno.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/errno.h: $(top_builddir)/config.status
 	rm -f $@
@@ -126,26 +167,30 @@
 # doesn't have one that works with the given compiler.
 if GL_GENERATE_FLOAT_H
 lib/float.h: lib/float.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_FLOAT_H''@|$(NEXT_FLOAT_H)|g' \
 	      -e 's|@''REPLACE_ITOLD''@|$(REPLACE_ITOLD)|g' \
-	      < $(top_srcdir)/lib/float.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/float.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/float.h: $(top_builddir)/config.status
 	rm -f $@
 endif
 MOSTLYCLEANFILES += lib/float.h lib/float.h-t
 
-EXTRA_DIST += lib/float.c lib/float.in.h lib/itold.c
+if GL_COND_OBJ_FLOAT
+lib_libgnu_a_SOURCES += lib/float.c
+endif
+if GL_COND_OBJ_ITOLD
+lib_libgnu_a_SOURCES += lib/itold.c
+endif
 
-EXTRA_lib_libgnu_a_SOURCES += lib/float.c lib/itold.c
+EXTRA_DIST += lib/float.in.h
 
 ## end   gnulib module float
 
@@ -165,6 +210,14 @@
 
 ## end   gnulib module fpucw
 
+## begin gnulib module free-posix
+
+if GL_COND_OBJ_FREE
+lib_libgnu_a_SOURCES += lib/free.c
+endif
+
+## end   gnulib module free-posix
+
 ## begin gnulib module frexp-nolibm
 
 
@@ -185,13 +238,34 @@
 
 ## begin gnulib module fseterr
 
+if GL_COND_OBJ_FSETERR
+lib_libgnu_a_SOURCES += lib/fseterr.c
+endif
 
-EXTRA_DIST += lib/fseterr.c lib/fseterr.h lib/stdio-impl.h
-
-EXTRA_lib_libgnu_a_SOURCES += lib/fseterr.c
+EXTRA_DIST += lib/fseterr.h lib/stdio-impl.h
 
 ## end   gnulib module fseterr
 
+## begin gnulib module gen-header
+
+# In 'sed', replace the pattern space with a "DO NOT EDIT" comment.
+SED_HEADER_NOEDIT = s,.*,/* DO NOT EDIT! GENERATED AUTOMATICALLY! */,
+
+# '$(SED_HEADER_STDOUT) -e "..."' runs 'sed' but first outputs "DO NOT EDIT".
+SED_HEADER_STDOUT = sed -e 1h -e '1$(SED_HEADER_NOEDIT)' -e 1G
+
+# '$(SED_HEADER_TO_AT_t) FILE' copies FILE to $@-t, prepending a leading
+# "DO_NOT_EDIT".  Although this could be done more simply via:
+#	SED_HEADER_TO_AT_t = $(SED_HEADER_STDOUT) > $@-t
+# the -n and 'w' avoid a fork+exec, at least when GNU Make is used.
+SED_HEADER_TO_AT_t = $(SED_HEADER_STDOUT) -n -e 'w $@-t'
+
+# Use $(gl_V_at) instead of $(AM_V_GEN) or $(AM_V_at) on a line that
+# is its recipe's first line if and only if  lines are absent.
+gl_V_at = $(AM_V_at)
+
+## end   gnulib module gen-header
+
 ## begin gnulib module git-version-gen
 
 
@@ -206,6 +280,50 @@
 
 ## end   gnulib module havelib
 
+## begin gnulib module inttypes-incomplete
+
+BUILT_SOURCES += lib/inttypes.h
+
+# We need the following in order to create <inttypes.h> when the system
+# doesn't have one that works with the given compiler.
+lib/inttypes.h: lib/inttypes.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(WARN_ON_USE_H) $(ARG_NONNULL_H)
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's/@''HAVE_INTTYPES_H''@/$(HAVE_INTTYPES_H)/g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_INTTYPES_H''@|$(NEXT_INTTYPES_H)|g' \
+	      -e 's/@''APPLE_UNIVERSAL_BUILD''@/$(APPLE_UNIVERSAL_BUILD)/g' \
+	      -e 's/@''PRIPTR_PREFIX''@/$(PRIPTR_PREFIX)/g' \
+	      -e 's/@''GNULIB_IMAXABS''@/$(GL_GNULIB_IMAXABS)/g' \
+	      -e 's/@''GNULIB_IMAXDIV''@/$(GL_GNULIB_IMAXDIV)/g' \
+	      -e 's/@''GNULIB_STRTOIMAX''@/$(GL_GNULIB_STRTOIMAX)/g' \
+	      -e 's/@''GNULIB_STRTOUMAX''@/$(GL_GNULIB_STRTOUMAX)/g' \
+	      -e 's/@''HAVE_DECL_IMAXABS''@/$(HAVE_DECL_IMAXABS)/g' \
+	      -e 's/@''HAVE_DECL_IMAXDIV''@/$(HAVE_DECL_IMAXDIV)/g' \
+	      -e 's/@''HAVE_DECL_STRTOIMAX''@/$(HAVE_DECL_STRTOIMAX)/g' \
+	      -e 's/@''HAVE_DECL_STRTOUMAX''@/$(HAVE_DECL_STRTOUMAX)/g' \
+	      -e 's/@''HAVE_IMAXDIV_T''@/$(HAVE_IMAXDIV_T)/g' \
+	      -e 's/@''REPLACE_IMAXABS''@/$(REPLACE_IMAXABS)/g' \
+	      -e 's/@''REPLACE_IMAXDIV''@/$(REPLACE_IMAXDIV)/g' \
+	      -e 's/@''REPLACE_STRTOIMAX''@/$(REPLACE_STRTOIMAX)/g' \
+	      -e 's/@''REPLACE_STRTOUMAX''@/$(REPLACE_STRTOUMAX)/g' \
+	      -e 's/@''INT32_MAX_LT_INTMAX_MAX''@/$(INT32_MAX_LT_INTMAX_MAX)/g' \
+	      -e 's/@''INT64_MAX_EQ_LONG_MAX''@/$(INT64_MAX_EQ_LONG_MAX)/g' \
+	      -e 's/@''UINT32_MAX_LT_UINTMAX_MAX''@/$(UINT32_MAX_LT_UINTMAX_MAX)/g' \
+	      -e 's/@''UINT64_MAX_EQ_ULONG_MAX''@/$(UINT64_MAX_EQ_ULONG_MAX)/g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      $(top_srcdir)/lib/inttypes.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
+MOSTLYCLEANFILES += lib/inttypes.h lib/inttypes.h-t
+
+EXTRA_DIST += lib/inttypes.in.h
+
+## end   gnulib module inttypes-incomplete
+
 ## begin gnulib module isnand-nolibm
 
 
@@ -241,16 +359,15 @@
 # doesn't have one that is compatible with GNU.
 if GL_GENERATE_LIMITS_H
 lib/limits.h: lib/limits.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_LIMITS_H''@|$(NEXT_LIMITS_H)|g' \
-	      < $(top_srcdir)/lib/limits.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/limits.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/limits.h: $(top_builddir)/config.status
 	rm -f $@
@@ -277,109 +394,115 @@
 # We need the following in order to create <math.h> when the system
 # doesn't have one that works with the given compiler.
 lib/math.h: lib/math.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT_AS_FIRST_DIRECTIVE''@|$(INCLUDE_NEXT_AS_FIRST_DIRECTIVE)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_AS_FIRST_DIRECTIVE_MATH_H''@|$(NEXT_AS_FIRST_DIRECTIVE_MATH_H)|g' \
-	      -e 's/@''GNULIB_ACOSF''@/$(GNULIB_ACOSF)/g' \
-	      -e 's/@''GNULIB_ACOSL''@/$(GNULIB_ACOSL)/g' \
-	      -e 's/@''GNULIB_ASINF''@/$(GNULIB_ASINF)/g' \
-	      -e 's/@''GNULIB_ASINL''@/$(GNULIB_ASINL)/g' \
-	      -e 's/@''GNULIB_ATANF''@/$(GNULIB_ATANF)/g' \
-	      -e 's/@''GNULIB_ATANL''@/$(GNULIB_ATANL)/g' \
-	      -e 's/@''GNULIB_ATAN2F''@/$(GNULIB_ATAN2F)/g' \
-	      -e 's/@''GNULIB_CBRT''@/$(GNULIB_CBRT)/g' \
-	      -e 's/@''GNULIB_CBRTF''@/$(GNULIB_CBRTF)/g' \
-	      -e 's/@''GNULIB_CBRTL''@/$(GNULIB_CBRTL)/g' \
-	      -e 's/@''GNULIB_CEIL''@/$(GNULIB_CEIL)/g' \
-	      -e 's/@''GNULIB_CEILF''@/$(GNULIB_CEILF)/g' \
-	      -e 's/@''GNULIB_CEILL''@/$(GNULIB_CEILL)/g' \
-	      -e 's/@''GNULIB_COPYSIGN''@/$(GNULIB_COPYSIGN)/g' \
-	      -e 's/@''GNULIB_COPYSIGNF''@/$(GNULIB_COPYSIGNF)/g' \
-	      -e 's/@''GNULIB_COPYSIGNL''@/$(GNULIB_COPYSIGNL)/g' \
-	      -e 's/@''GNULIB_COSF''@/$(GNULIB_COSF)/g' \
-	      -e 's/@''GNULIB_COSL''@/$(GNULIB_COSL)/g' \
-	      -e 's/@''GNULIB_COSHF''@/$(GNULIB_COSHF)/g' \
-	      -e 's/@''GNULIB_EXPF''@/$(GNULIB_EXPF)/g' \
-	      -e 's/@''GNULIB_EXPL''@/$(GNULIB_EXPL)/g' \
-	      -e 's/@''GNULIB_EXP2''@/$(GNULIB_EXP2)/g' \
-	      -e 's/@''GNULIB_EXP2F''@/$(GNULIB_EXP2F)/g' \
-	      -e 's/@''GNULIB_EXP2L''@/$(GNULIB_EXP2L)/g' \
-	      -e 's/@''GNULIB_EXPM1''@/$(GNULIB_EXPM1)/g' \
-	      -e 's/@''GNULIB_EXPM1F''@/$(GNULIB_EXPM1F)/g' \
-	      -e 's/@''GNULIB_EXPM1L''@/$(GNULIB_EXPM1L)/g' \
-	      -e 's/@''GNULIB_FABSF''@/$(GNULIB_FABSF)/g' \
-	      -e 's/@''GNULIB_FABSL''@/$(GNULIB_FABSL)/g' \
-	      -e 's/@''GNULIB_FLOOR''@/$(GNULIB_FLOOR)/g' \
-	      -e 's/@''GNULIB_FLOORF''@/$(GNULIB_FLOORF)/g' \
-	      -e 's/@''GNULIB_FLOORL''@/$(GNULIB_FLOORL)/g' \
-	      -e 's/@''GNULIB_FMA''@/$(GNULIB_FMA)/g' \
-	      -e 's/@''GNULIB_FMAF''@/$(GNULIB_FMAF)/g' \
-	      -e 's/@''GNULIB_FMAL''@/$(GNULIB_FMAL)/g' \
-	      -e 's/@''GNULIB_FMOD''@/$(GNULIB_FMOD)/g' \
-	      -e 's/@''GNULIB_FMODF''@/$(GNULIB_FMODF)/g' \
-	      -e 's/@''GNULIB_FMODL''@/$(GNULIB_FMODL)/g' \
-	      -e 's/@''GNULIB_FREXPF''@/$(GNULIB_FREXPF)/g' \
-	      -e 's/@''GNULIB_FREXP''@/$(GNULIB_FREXP)/g' \
-	      -e 's/@''GNULIB_FREXPL''@/$(GNULIB_FREXPL)/g' \
-	      -e 's/@''GNULIB_HYPOT''@/$(GNULIB_HYPOT)/g' \
-	      -e 's/@''GNULIB_HYPOTF''@/$(GNULIB_HYPOTF)/g' \
-	      -e 's/@''GNULIB_HYPOTL''@/$(GNULIB_HYPOTL)/g' \
+	      -e 's/@''GNULIB_ACOSF''@/$(GL_GNULIB_ACOSF)/g' \
+	      -e 's/@''GNULIB_ACOSL''@/$(GL_GNULIB_ACOSL)/g' \
+	      -e 's/@''GNULIB_ASINF''@/$(GL_GNULIB_ASINF)/g' \
+	      -e 's/@''GNULIB_ASINL''@/$(GL_GNULIB_ASINL)/g' \
+	      -e 's/@''GNULIB_ATANF''@/$(GL_GNULIB_ATANF)/g' \
+	      -e 's/@''GNULIB_ATANL''@/$(GL_GNULIB_ATANL)/g' \
+	      -e 's/@''GNULIB_ATAN2F''@/$(GL_GNULIB_ATAN2F)/g' \
+	      -e 's/@''GNULIB_CBRT''@/$(GL_GNULIB_CBRT)/g' \
+	      -e 's/@''GNULIB_CBRTF''@/$(GL_GNULIB_CBRTF)/g' \
+	      -e 's/@''GNULIB_CBRTL''@/$(GL_GNULIB_CBRTL)/g' \
+	      -e 's/@''GNULIB_CEIL''@/$(GL_GNULIB_CEIL)/g' \
+	      -e 's/@''GNULIB_CEILF''@/$(GL_GNULIB_CEILF)/g' \
+	      -e 's/@''GNULIB_CEILL''@/$(GL_GNULIB_CEILL)/g' \
+	      -e 's/@''GNULIB_COPYSIGN''@/$(GL_GNULIB_COPYSIGN)/g' \
+	      -e 's/@''GNULIB_COPYSIGNF''@/$(GL_GNULIB_COPYSIGNF)/g' \
+	      -e 's/@''GNULIB_COPYSIGNL''@/$(GL_GNULIB_COPYSIGNL)/g' \
+	      -e 's/@''GNULIB_COSF''@/$(GL_GNULIB_COSF)/g' \
+	      -e 's/@''GNULIB_COSL''@/$(GL_GNULIB_COSL)/g' \
+	      -e 's/@''GNULIB_COSHF''@/$(GL_GNULIB_COSHF)/g' \
+	      -e 's/@''GNULIB_EXPF''@/$(GL_GNULIB_EXPF)/g' \
+	      -e 's/@''GNULIB_EXPL''@/$(GL_GNULIB_EXPL)/g' \
+	      -e 's/@''GNULIB_EXP2''@/$(GL_GNULIB_EXP2)/g' \
+	      -e 's/@''GNULIB_EXP2F''@/$(GL_GNULIB_EXP2F)/g' \
+	      -e 's/@''GNULIB_EXP2L''@/$(GL_GNULIB_EXP2L)/g' \
+	      -e 's/@''GNULIB_EXPM1''@/$(GL_GNULIB_EXPM1)/g' \
+	      -e 's/@''GNULIB_EXPM1F''@/$(GL_GNULIB_EXPM1F)/g' \
+	      -e 's/@''GNULIB_EXPM1L''@/$(GL_GNULIB_EXPM1L)/g' \
+	      -e 's/@''GNULIB_FABSF''@/$(GL_GNULIB_FABSF)/g' \
+	      -e 's/@''GNULIB_FABSL''@/$(GL_GNULIB_FABSL)/g' \
+	      -e 's/@''GNULIB_FLOOR''@/$(GL_GNULIB_FLOOR)/g' \
+	      -e 's/@''GNULIB_FLOORF''@/$(GL_GNULIB_FLOORF)/g' \
+	      -e 's/@''GNULIB_FLOORL''@/$(GL_GNULIB_FLOORL)/g' \
+	      -e 's/@''GNULIB_FMA''@/$(GL_GNULIB_FMA)/g' \
+	      -e 's/@''GNULIB_FMAF''@/$(GL_GNULIB_FMAF)/g' \
+	      -e 's/@''GNULIB_FMAL''@/$(GL_GNULIB_FMAL)/g' \
+	      -e 's/@''GNULIB_FMOD''@/$(GL_GNULIB_FMOD)/g' \
+	      -e 's/@''GNULIB_FMODF''@/$(GL_GNULIB_FMODF)/g' \
+	      -e 's/@''GNULIB_FMODL''@/$(GL_GNULIB_FMODL)/g' \
+	      -e 's/@''GNULIB_FREXPF''@/$(GL_GNULIB_FREXPF)/g' \
+	      -e 's/@''GNULIB_FREXP''@/$(GL_GNULIB_FREXP)/g' \
+	      -e 's/@''GNULIB_FREXPL''@/$(GL_GNULIB_FREXPL)/g' \
+	      -e 's/@''GNULIB_HYPOT''@/$(GL_GNULIB_HYPOT)/g' \
+	      -e 's/@''GNULIB_HYPOTF''@/$(GL_GNULIB_HYPOTF)/g' \
+	      -e 's/@''GNULIB_HYPOTL''@/$(GL_GNULIB_HYPOTL)/g' \
 	      < $(top_srcdir)/lib/math.in.h | \
-	  sed -e 's/@''GNULIB_ILOGB''@/$(GNULIB_ILOGB)/g' \
-	      -e 's/@''GNULIB_ILOGBF''@/$(GNULIB_ILOGBF)/g' \
-	      -e 's/@''GNULIB_ILOGBL''@/$(GNULIB_ILOGBL)/g' \
-	      -e 's/@''GNULIB_ISFINITE''@/$(GNULIB_ISFINITE)/g' \
-	      -e 's/@''GNULIB_ISINF''@/$(GNULIB_ISINF)/g' \
-	      -e 's/@''GNULIB_ISNAN''@/$(GNULIB_ISNAN)/g' \
-	      -e 's/@''GNULIB_ISNANF''@/$(GNULIB_ISNANF)/g' \
-	      -e 's/@''GNULIB_ISNAND''@/$(GNULIB_ISNAND)/g' \
-	      -e 's/@''GNULIB_ISNANL''@/$(GNULIB_ISNANL)/g' \
-	      -e 's/@''GNULIB_LDEXPF''@/$(GNULIB_LDEXPF)/g' \
-	      -e 's/@''GNULIB_LDEXPL''@/$(GNULIB_LDEXPL)/g' \
-	      -e 's/@''GNULIB_LOG''@/$(GNULIB_LOG)/g' \
-	      -e 's/@''GNULIB_LOGF''@/$(GNULIB_LOGF)/g' \
-	      -e 's/@''GNULIB_LOGL''@/$(GNULIB_LOGL)/g' \
-	      -e 's/@''GNULIB_LOG10''@/$(GNULIB_LOG10)/g' \
-	      -e 's/@''GNULIB_LOG10F''@/$(GNULIB_LOG10F)/g' \
-	      -e 's/@''GNULIB_LOG10L''@/$(GNULIB_LOG10L)/g' \
-	      -e 's/@''GNULIB_LOG1P''@/$(GNULIB_LOG1P)/g' \
-	      -e 's/@''GNULIB_LOG1PF''@/$(GNULIB_LOG1PF)/g' \
-	      -e 's/@''GNULIB_LOG1PL''@/$(GNULIB_LOG1PL)/g' \
-	      -e 's/@''GNULIB_LOG2''@/$(GNULIB_LOG2)/g' \
-	      -e 's/@''GNULIB_LOG2F''@/$(GNULIB_LOG2F)/g' \
-	      -e 's/@''GNULIB_LOG2L''@/$(GNULIB_LOG2L)/g' \
-	      -e 's/@''GNULIB_LOGB''@/$(GNULIB_LOGB)/g' \
-	      -e 's/@''GNULIB_LOGBF''@/$(GNULIB_LOGBF)/g' \
-	      -e 's/@''GNULIB_LOGBL''@/$(GNULIB_LOGBL)/g' \
-	      -e 's/@''GNULIB_MODF''@/$(GNULIB_MODF)/g' \
-	      -e 's/@''GNULIB_MODFF''@/$(GNULIB_MODFF)/g' \
-	      -e 's/@''GNULIB_MODFL''@/$(GNULIB_MODFL)/g' \
-	      -e 's/@''GNULIB_POWF''@/$(GNULIB_POWF)/g' \
-	      -e 's/@''GNULIB_REMAINDER''@/$(GNULIB_REMAINDER)/g' \
-	      -e 's/@''GNULIB_REMAINDERF''@/$(GNULIB_REMAINDERF)/g' \
-	      -e 's/@''GNULIB_REMAINDERL''@/$(GNULIB_REMAINDERL)/g' \
-	      -e 's/@''GNULIB_RINT''@/$(GNULIB_RINT)/g' \
-	      -e 's/@''GNULIB_RINTF''@/$(GNULIB_RINTF)/g' \
-	      -e 's/@''GNULIB_RINTL''@/$(GNULIB_RINTL)/g' \
-	      -e 's/@''GNULIB_ROUND''@/$(GNULIB_ROUND)/g' \
-	      -e 's/@''GNULIB_ROUNDF''@/$(GNULIB_ROUNDF)/g' \
-	      -e 's/@''GNULIB_ROUNDL''@/$(GNULIB_ROUNDL)/g' \
-	      -e 's/@''GNULIB_SIGNBIT''@/$(GNULIB_SIGNBIT)/g' \
-	      -e 's/@''GNULIB_SINF''@/$(GNULIB_SINF)/g' \
-	      -e 's/@''GNULIB_SINL''@/$(GNULIB_SINL)/g' \
-	      -e 's/@''GNULIB_SINHF''@/$(GNULIB_SINHF)/g' \
-	      -e 's/@''GNULIB_SQRTF''@/$(GNULIB_SQRTF)/g' \
-	      -e 's/@''GNULIB_SQRTL''@/$(GNULIB_SQRTL)/g' \
-	      -e 's/@''GNULIB_TANF''@/$(GNULIB_TANF)/g' \
-	      -e 's/@''GNULIB_TANL''@/$(GNULIB_TANL)/g' \
-	      -e 's/@''GNULIB_TANHF''@/$(GNULIB_TANHF)/g' \
-	      -e 's/@''GNULIB_TRUNC''@/$(GNULIB_TRUNC)/g' \
-	      -e 's/@''GNULIB_TRUNCF''@/$(GNULIB_TRUNCF)/g' \
-	      -e 's/@''GNULIB_TRUNCL''@/$(GNULIB_TRUNCL)/g' \
+	  sed -e 's/@''GNULIB_ILOGB''@/$(GL_GNULIB_ILOGB)/g' \
+	      -e 's/@''GNULIB_ILOGBF''@/$(GL_GNULIB_ILOGBF)/g' \
+	      -e 's/@''GNULIB_ILOGBL''@/$(GL_GNULIB_ILOGBL)/g' \
+	      -e 's/@''GNULIB_ISFINITE''@/$(GL_GNULIB_ISFINITE)/g' \
+	      -e 's/@''GNULIB_ISINF''@/$(GL_GNULIB_ISINF)/g' \
+	      -e 's/@''GNULIB_ISNAN''@/$(GL_GNULIB_ISNAN)/g' \
+	      -e 's/@''GNULIB_ISNANF''@/$(GL_GNULIB_ISNANF)/g' \
+	      -e 's/@''GNULIB_ISNAND''@/$(GL_GNULIB_ISNAND)/g' \
+	      -e 's/@''GNULIB_ISNANL''@/$(GL_GNULIB_ISNANL)/g' \
+	      -e 's/@''GNULIB_LDEXPF''@/$(GL_GNULIB_LDEXPF)/g' \
+	      -e 's/@''GNULIB_LDEXPL''@/$(GL_GNULIB_LDEXPL)/g' \
+	      -e 's/@''GNULIB_LOG''@/$(GL_GNULIB_LOG)/g' \
+	      -e 's/@''GNULIB_LOGF''@/$(GL_GNULIB_LOGF)/g' \
+	      -e 's/@''GNULIB_LOGL''@/$(GL_GNULIB_LOGL)/g' \
+	      -e 's/@''GNULIB_LOG10''@/$(GL_GNULIB_LOG10)/g' \
+	      -e 's/@''GNULIB_LOG10F''@/$(GL_GNULIB_LOG10F)/g' \
+	      -e 's/@''GNULIB_LOG10L''@/$(GL_GNULIB_LOG10L)/g' \
+	      -e 's/@''GNULIB_LOG1P''@/$(GL_GNULIB_LOG1P)/g' \
+	      -e 's/@''GNULIB_LOG1PF''@/$(GL_GNULIB_LOG1PF)/g' \
+	      -e 's/@''GNULIB_LOG1PL''@/$(GL_GNULIB_LOG1PL)/g' \
+	      -e 's/@''GNULIB_LOG2''@/$(GL_GNULIB_LOG2)/g' \
+	      -e 's/@''GNULIB_LOG2F''@/$(GL_GNULIB_LOG2F)/g' \
+	      -e 's/@''GNULIB_LOG2L''@/$(GL_GNULIB_LOG2L)/g' \
+	      -e 's/@''GNULIB_LOGB''@/$(GL_GNULIB_LOGB)/g' \
+	      -e 's/@''GNULIB_LOGBF''@/$(GL_GNULIB_LOGBF)/g' \
+	      -e 's/@''GNULIB_LOGBL''@/$(GL_GNULIB_LOGBL)/g' \
+	      -e 's/@''GNULIB_MODF''@/$(GL_GNULIB_MODF)/g' \
+	      -e 's/@''GNULIB_MODFF''@/$(GL_GNULIB_MODFF)/g' \
+	      -e 's/@''GNULIB_MODFL''@/$(GL_GNULIB_MODFL)/g' \
+	      -e 's/@''GNULIB_POWF''@/$(GL_GNULIB_POWF)/g' \
+	      -e 's/@''GNULIB_REMAINDER''@/$(GL_GNULIB_REMAINDER)/g' \
+	      -e 's/@''GNULIB_REMAINDERF''@/$(GL_GNULIB_REMAINDERF)/g' \
+	      -e 's/@''GNULIB_REMAINDERL''@/$(GL_GNULIB_REMAINDERL)/g' \
+	      -e 's/@''GNULIB_RINT''@/$(GL_GNULIB_RINT)/g' \
+	      -e 's/@''GNULIB_RINTF''@/$(GL_GNULIB_RINTF)/g' \
+	      -e 's/@''GNULIB_RINTL''@/$(GL_GNULIB_RINTL)/g' \
+	      -e 's/@''GNULIB_ROUND''@/$(GL_GNULIB_ROUND)/g' \
+	      -e 's/@''GNULIB_ROUNDF''@/$(GL_GNULIB_ROUNDF)/g' \
+	      -e 's/@''GNULIB_ROUNDL''@/$(GL_GNULIB_ROUNDL)/g' \
+	      -e 's/@''GNULIB_SIGNBIT''@/$(GL_GNULIB_SIGNBIT)/g' \
+	      -e 's/@''GNULIB_SINF''@/$(GL_GNULIB_SINF)/g' \
+	      -e 's/@''GNULIB_SINL''@/$(GL_GNULIB_SINL)/g' \
+	      -e 's/@''GNULIB_SINHF''@/$(GL_GNULIB_SINHF)/g' \
+	      -e 's/@''GNULIB_SQRTF''@/$(GL_GNULIB_SQRTF)/g' \
+	      -e 's/@''GNULIB_SQRTL''@/$(GL_GNULIB_SQRTL)/g' \
+	      -e 's/@''GNULIB_TANF''@/$(GL_GNULIB_TANF)/g' \
+	      -e 's/@''GNULIB_TANL''@/$(GL_GNULIB_TANL)/g' \
+	      -e 's/@''GNULIB_TANHF''@/$(GL_GNULIB_TANHF)/g' \
+	      -e 's/@''GNULIB_TRUNC''@/$(GL_GNULIB_TRUNC)/g' \
+	      -e 's/@''GNULIB_TRUNCF''@/$(GL_GNULIB_TRUNCF)/g' \
+	      -e 's/@''GNULIB_TRUNCL''@/$(GL_GNULIB_TRUNCL)/g' \
+	      -e 's/@''GNULIB_MDA_J0''@/$(GL_GNULIB_MDA_J0)/g' \
+	      -e 's/@''GNULIB_MDA_J1''@/$(GL_GNULIB_MDA_J1)/g' \
+	      -e 's/@''GNULIB_MDA_JN''@/$(GL_GNULIB_MDA_JN)/g' \
+	      -e 's/@''GNULIB_MDA_Y0''@/$(GL_GNULIB_MDA_Y0)/g' \
+	      -e 's/@''GNULIB_MDA_Y1''@/$(GL_GNULIB_MDA_Y1)/g' \
+	      -e 's/@''GNULIB_MDA_YN''@/$(GL_GNULIB_MDA_YN)/g' \
 	  | \
 	  sed -e 's|@''HAVE_ACOSF''@|$(HAVE_ACOSF)|g' \
 	      -e 's|@''HAVE_ACOSL''@|$(HAVE_ACOSL)|g' \
@@ -490,8 +613,10 @@
 	      -e 's|@''REPLACE_COSF''@|$(REPLACE_COSF)|g' \
 	      -e 's|@''REPLACE_COSHF''@|$(REPLACE_COSHF)|g' \
 	      -e 's|@''REPLACE_EXPF''@|$(REPLACE_EXPF)|g' \
+	      -e 's|@''REPLACE_EXPL''@|$(REPLACE_EXPL)|g' \
 	      -e 's|@''REPLACE_EXPM1''@|$(REPLACE_EXPM1)|g' \
 	      -e 's|@''REPLACE_EXPM1F''@|$(REPLACE_EXPM1F)|g' \
+	      -e 's|@''REPLACE_EXPM1L''@|$(REPLACE_EXPM1L)|g' \
 	      -e 's|@''REPLACE_EXP2''@|$(REPLACE_EXP2)|g' \
 	      -e 's|@''REPLACE_EXP2L''@|$(REPLACE_EXP2L)|g' \
 	      -e 's|@''REPLACE_FABSL''@|$(REPLACE_FABSL)|g' \
@@ -541,11 +666,12 @@
 	      -e 's|@''REPLACE_REMAINDER''@|$(REPLACE_REMAINDER)|g' \
 	      -e 's|@''REPLACE_REMAINDERF''@|$(REPLACE_REMAINDERF)|g' \
 	      -e 's|@''REPLACE_REMAINDERL''@|$(REPLACE_REMAINDERL)|g' \
+	      -e 's|@''REPLACE_RINTL''@|$(REPLACE_RINTL)|g' \
 	      -e 's|@''REPLACE_ROUND''@|$(REPLACE_ROUND)|g' \
 	      -e 's|@''REPLACE_ROUNDF''@|$(REPLACE_ROUNDF)|g' \
 	      -e 's|@''REPLACE_ROUNDL''@|$(REPLACE_ROUNDL)|g' \
 	      -e 's|@''REPLACE_SIGNBIT''@|$(REPLACE_SIGNBIT)|g' \
-	      -e 's|@''REPLACE_SIGNBIT_USING_GCC''@|$(REPLACE_SIGNBIT_USING_GCC)|g' \
+	      -e 's|@''REPLACE_SIGNBIT_USING_BUILTINS''@|$(REPLACE_SIGNBIT_USING_BUILTINS)|g' \
 	      -e 's|@''REPLACE_SINF''@|$(REPLACE_SINF)|g' \
 	      -e 's|@''REPLACE_SINHF''@|$(REPLACE_SINHF)|g' \
 	      -e 's|@''REPLACE_SQRTF''@|$(REPLACE_SQRTF)|g' \
@@ -557,9 +683,9 @@
 	      -e 's|@''REPLACE_TRUNCL''@|$(REPLACE_TRUNCL)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/math.h lib/math.h-t
 
 EXTRA_DIST += lib/math.in.h
@@ -568,20 +694,14 @@
 
 ## begin gnulib module memchr
 
+if GL_COND_OBJ_MEMCHR
+lib_libgnu_a_SOURCES += lib/memchr.c
+endif
 
-EXTRA_DIST += lib/memchr.c lib/memchr.valgrind
-
-EXTRA_lib_libgnu_a_SOURCES += lib/memchr.c
+EXTRA_DIST += lib/memchr.valgrind
 
 ## end   gnulib module memchr
 
-## begin gnulib module non-recursive-gnulib-prefix-hack
-
-
-EXTRA_DIST += $(top_srcdir)/build-aux/prefix-gnulib-mk
-
-## end   gnulib module non-recursive-gnulib-prefix-hack
-
 ## begin gnulib module printf-frexp
 
 lib_libgnu_a_SOURCES += lib/printf-frexp.c
@@ -602,10 +722,11 @@
 
 ## begin gnulib module signbit
 
+if GL_COND_OBJ_SIGNBIT3
+lib_libgnu_a_SOURCES += lib/signbitf.c lib/signbitd.c lib/signbitl.c
+endif
 
-EXTRA_DIST += lib/float+.h lib/signbitd.c lib/signbitf.c lib/signbitl.c
-
-EXTRA_lib_libgnu_a_SOURCES += lib/signbitd.c lib/signbitf.c lib/signbitl.c
+EXTRA_DIST += lib/float+.h
 
 ## end   gnulib module signbit
 
@@ -615,6 +736,18 @@
 
 ## end   gnulib module size_max
 
+## begin gnulib module snippet/_Noreturn
+
+# Because this Makefile snippet defines a variable used by other
+# gnulib Makefile snippets, it must be present in all makefiles that
+# need it. This is ensured by the applicability 'all' defined above.
+
+_NORETURN_H=$(top_srcdir)/lib/_Noreturn.h
+
+EXTRA_DIST += lib/_Noreturn.h
+
+## end   gnulib module snippet/_Noreturn
+
 ## begin gnulib module snippet/arg-nonnull
 
 # Because this Makefile snippet defines a variable used by other
@@ -660,6 +793,29 @@
 
 ## end   gnulib module snprintf
 
+## begin gnulib module stdbool-c99
+
+BUILT_SOURCES += $(STDBOOL_H)
+
+# We need the following in order to create <stdbool.h> when the system
+# doesn't have one that works.
+if GL_GENERATE_STDBOOL_H
+lib/stdbool.h: lib/stdbool.in.h $(top_builddir)/config.status
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	  -e 's/@''HAVE__BOOL''@/$(HAVE__BOOL)/g' \
+	  $(top_srcdir)/lib/stdbool.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
+else
+lib/stdbool.h: $(top_builddir)/config.status
+	rm -f $@
+endif
+MOSTLYCLEANFILES += lib/stdbool.h lib/stdbool.h-t
+
+EXTRA_DIST += lib/stdbool.in.h
+
+## end   gnulib module stdbool-c99
+
 ## begin gnulib module stddef
 
 BUILT_SOURCES += $(STDDEF_H)
@@ -668,9 +824,9 @@
 # doesn't have one that works with the given compiler.
 if GL_GENERATE_STDDEF_H
 lib/stddef.h: lib/stddef.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -678,9 +834,8 @@
 	      -e 's|@''HAVE_MAX_ALIGN_T''@|$(HAVE_MAX_ALIGN_T)|g' \
 	      -e 's|@''HAVE_WCHAR_T''@|$(HAVE_WCHAR_T)|g' \
 	      -e 's|@''REPLACE_NULL''@|$(REPLACE_NULL)|g' \
-	      < $(top_srcdir)/lib/stddef.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/stddef.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/stddef.h: $(top_builddir)/config.status
 	rm -f $@
@@ -699,9 +854,9 @@
 # doesn't have one that works with the given compiler.
 if GL_GENERATE_STDINT_H
 lib/stdint.h: lib/stdint.in.h $(top_builddir)/config.status
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's/@''HAVE_STDINT_H''@/$(HAVE_STDINT_H)/g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
@@ -713,8 +868,6 @@
 	      -e 's/@''HAVE_SYS_INTTYPES_H''@/$(HAVE_SYS_INTTYPES_H)/g' \
 	      -e 's/@''HAVE_SYS_BITYPES_H''@/$(HAVE_SYS_BITYPES_H)/g' \
 	      -e 's/@''HAVE_WCHAR_H''@/$(HAVE_WCHAR_H)/g' \
-	      -e 's/@''HAVE_LONG_LONG_INT''@/$(HAVE_LONG_LONG_INT)/g' \
-	      -e 's/@''HAVE_UNSIGNED_LONG_LONG_INT''@/$(HAVE_UNSIGNED_LONG_LONG_INT)/g' \
 	      -e 's/@''APPLE_UNIVERSAL_BUILD''@/$(APPLE_UNIVERSAL_BUILD)/g' \
 	      -e 's/@''BITSIZEOF_PTRDIFF_T''@/$(BITSIZEOF_PTRDIFF_T)/g' \
 	      -e 's/@''PTRDIFF_T_SUFFIX''@/$(PTRDIFF_T_SUFFIX)/g' \
@@ -729,10 +882,9 @@
 	      -e 's/@''BITSIZEOF_WINT_T''@/$(BITSIZEOF_WINT_T)/g' \
 	      -e 's/@''HAVE_SIGNED_WINT_T''@/$(HAVE_SIGNED_WINT_T)/g' \
 	      -e 's/@''WINT_T_SUFFIX''@/$(WINT_T_SUFFIX)/g' \
-	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-	      < $(top_srcdir)/lib/stdint.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+	      $(top_srcdir)/lib/stdint.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 else
 lib/stdint.h: $(top_builddir)/config.status
 	rm -f $@
@@ -750,73 +902,83 @@
 # We need the following in order to create <stdio.h> when the system
 # doesn't have one that works with the given compiler.
 lib/stdio.h: lib/stdio.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_STDIO_H''@|$(NEXT_STDIO_H)|g' \
-	      -e 's/@''GNULIB_DPRINTF''@/$(GNULIB_DPRINTF)/g' \
-	      -e 's/@''GNULIB_FCLOSE''@/$(GNULIB_FCLOSE)/g' \
-	      -e 's/@''GNULIB_FDOPEN''@/$(GNULIB_FDOPEN)/g' \
-	      -e 's/@''GNULIB_FFLUSH''@/$(GNULIB_FFLUSH)/g' \
-	      -e 's/@''GNULIB_FGETC''@/$(GNULIB_FGETC)/g' \
-	      -e 's/@''GNULIB_FGETS''@/$(GNULIB_FGETS)/g' \
-	      -e 's/@''GNULIB_FOPEN''@/$(GNULIB_FOPEN)/g' \
-	      -e 's/@''GNULIB_FPRINTF''@/$(GNULIB_FPRINTF)/g' \
-	      -e 's/@''GNULIB_FPRINTF_POSIX''@/$(GNULIB_FPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_FPURGE''@/$(GNULIB_FPURGE)/g' \
-	      -e 's/@''GNULIB_FPUTC''@/$(GNULIB_FPUTC)/g' \
-	      -e 's/@''GNULIB_FPUTS''@/$(GNULIB_FPUTS)/g' \
-	      -e 's/@''GNULIB_FREAD''@/$(GNULIB_FREAD)/g' \
-	      -e 's/@''GNULIB_FREOPEN''@/$(GNULIB_FREOPEN)/g' \
-	      -e 's/@''GNULIB_FSCANF''@/$(GNULIB_FSCANF)/g' \
-	      -e 's/@''GNULIB_FSEEK''@/$(GNULIB_FSEEK)/g' \
-	      -e 's/@''GNULIB_FSEEKO''@/$(GNULIB_FSEEKO)/g' \
-	      -e 's/@''GNULIB_FTELL''@/$(GNULIB_FTELL)/g' \
-	      -e 's/@''GNULIB_FTELLO''@/$(GNULIB_FTELLO)/g' \
-	      -e 's/@''GNULIB_FWRITE''@/$(GNULIB_FWRITE)/g' \
-	      -e 's/@''GNULIB_GETC''@/$(GNULIB_GETC)/g' \
-	      -e 's/@''GNULIB_GETCHAR''@/$(GNULIB_GETCHAR)/g' \
-	      -e 's/@''GNULIB_GETDELIM''@/$(GNULIB_GETDELIM)/g' \
-	      -e 's/@''GNULIB_GETLINE''@/$(GNULIB_GETLINE)/g' \
-	      -e 's/@''GNULIB_OBSTACK_PRINTF''@/$(GNULIB_OBSTACK_PRINTF)/g' \
-	      -e 's/@''GNULIB_OBSTACK_PRINTF_POSIX''@/$(GNULIB_OBSTACK_PRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_PCLOSE''@/$(GNULIB_PCLOSE)/g' \
-	      -e 's/@''GNULIB_PERROR''@/$(GNULIB_PERROR)/g' \
-	      -e 's/@''GNULIB_POPEN''@/$(GNULIB_POPEN)/g' \
-	      -e 's/@''GNULIB_PRINTF''@/$(GNULIB_PRINTF)/g' \
-	      -e 's/@''GNULIB_PRINTF_POSIX''@/$(GNULIB_PRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_PUTC''@/$(GNULIB_PUTC)/g' \
-	      -e 's/@''GNULIB_PUTCHAR''@/$(GNULIB_PUTCHAR)/g' \
-	      -e 's/@''GNULIB_PUTS''@/$(GNULIB_PUTS)/g' \
-	      -e 's/@''GNULIB_REMOVE''@/$(GNULIB_REMOVE)/g' \
-	      -e 's/@''GNULIB_RENAME''@/$(GNULIB_RENAME)/g' \
-	      -e 's/@''GNULIB_RENAMEAT''@/$(GNULIB_RENAMEAT)/g' \
-	      -e 's/@''GNULIB_SCANF''@/$(GNULIB_SCANF)/g' \
-	      -e 's/@''GNULIB_SNPRINTF''@/$(GNULIB_SNPRINTF)/g' \
-	      -e 's/@''GNULIB_SPRINTF_POSIX''@/$(GNULIB_SPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_STDIO_H_NONBLOCKING''@/$(GNULIB_STDIO_H_NONBLOCKING)/g' \
-	      -e 's/@''GNULIB_STDIO_H_SIGPIPE''@/$(GNULIB_STDIO_H_SIGPIPE)/g' \
-	      -e 's/@''GNULIB_TMPFILE''@/$(GNULIB_TMPFILE)/g' \
-	      -e 's/@''GNULIB_VASPRINTF''@/$(GNULIB_VASPRINTF)/g' \
-	      -e 's/@''GNULIB_VDPRINTF''@/$(GNULIB_VDPRINTF)/g' \
-	      -e 's/@''GNULIB_VFPRINTF''@/$(GNULIB_VFPRINTF)/g' \
-	      -e 's/@''GNULIB_VFPRINTF_POSIX''@/$(GNULIB_VFPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_VFSCANF''@/$(GNULIB_VFSCANF)/g' \
-	      -e 's/@''GNULIB_VSCANF''@/$(GNULIB_VSCANF)/g' \
-	      -e 's/@''GNULIB_VPRINTF''@/$(GNULIB_VPRINTF)/g' \
-	      -e 's/@''GNULIB_VPRINTF_POSIX''@/$(GNULIB_VPRINTF_POSIX)/g' \
-	      -e 's/@''GNULIB_VSNPRINTF''@/$(GNULIB_VSNPRINTF)/g' \
-	      -e 's/@''GNULIB_VSPRINTF_POSIX''@/$(GNULIB_VSPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_DPRINTF''@/$(GL_GNULIB_DPRINTF)/g' \
+	      -e 's/@''GNULIB_FCLOSE''@/$(GL_GNULIB_FCLOSE)/g' \
+	      -e 's/@''GNULIB_FDOPEN''@/$(GL_GNULIB_FDOPEN)/g' \
+	      -e 's/@''GNULIB_FFLUSH''@/$(GL_GNULIB_FFLUSH)/g' \
+	      -e 's/@''GNULIB_FGETC''@/$(GL_GNULIB_FGETC)/g' \
+	      -e 's/@''GNULIB_FGETS''@/$(GL_GNULIB_FGETS)/g' \
+	      -e 's/@''GNULIB_FOPEN''@/$(GL_GNULIB_FOPEN)/g' \
+	      -e 's/@''GNULIB_FOPEN_GNU''@/$(GL_GNULIB_FOPEN_GNU)/g' \
+	      -e 's/@''GNULIB_FPRINTF''@/$(GL_GNULIB_FPRINTF)/g' \
+	      -e 's/@''GNULIB_FPRINTF_POSIX''@/$(GL_GNULIB_FPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_FPURGE''@/$(GL_GNULIB_FPURGE)/g' \
+	      -e 's/@''GNULIB_FPUTC''@/$(GL_GNULIB_FPUTC)/g' \
+	      -e 's/@''GNULIB_FPUTS''@/$(GL_GNULIB_FPUTS)/g' \
+	      -e 's/@''GNULIB_FREAD''@/$(GL_GNULIB_FREAD)/g' \
+	      -e 's/@''GNULIB_FREOPEN''@/$(GL_GNULIB_FREOPEN)/g' \
+	      -e 's/@''GNULIB_FSCANF''@/$(GL_GNULIB_FSCANF)/g' \
+	      -e 's/@''GNULIB_FSEEK''@/$(GL_GNULIB_FSEEK)/g' \
+	      -e 's/@''GNULIB_FSEEKO''@/$(GL_GNULIB_FSEEKO)/g' \
+	      -e 's/@''GNULIB_FTELL''@/$(GL_GNULIB_FTELL)/g' \
+	      -e 's/@''GNULIB_FTELLO''@/$(GL_GNULIB_FTELLO)/g' \
+	      -e 's/@''GNULIB_FWRITE''@/$(GL_GNULIB_FWRITE)/g' \
+	      -e 's/@''GNULIB_GETC''@/$(GL_GNULIB_GETC)/g' \
+	      -e 's/@''GNULIB_GETCHAR''@/$(GL_GNULIB_GETCHAR)/g' \
+	      -e 's/@''GNULIB_GETDELIM''@/$(GL_GNULIB_GETDELIM)/g' \
+	      -e 's/@''GNULIB_GETLINE''@/$(GL_GNULIB_GETLINE)/g' \
+	      -e 's/@''GNULIB_OBSTACK_PRINTF''@/$(GL_GNULIB_OBSTACK_PRINTF)/g' \
+	      -e 's/@''GNULIB_OBSTACK_PRINTF_POSIX''@/$(GL_GNULIB_OBSTACK_PRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_PCLOSE''@/$(GL_GNULIB_PCLOSE)/g' \
+	      -e 's/@''GNULIB_PERROR''@/$(GL_GNULIB_PERROR)/g' \
+	      -e 's/@''GNULIB_POPEN''@/$(GL_GNULIB_POPEN)/g' \
+	      -e 's/@''GNULIB_PRINTF''@/$(GL_GNULIB_PRINTF)/g' \
+	      -e 's/@''GNULIB_PRINTF_POSIX''@/$(GL_GNULIB_PRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_PUTC''@/$(GL_GNULIB_PUTC)/g' \
+	      -e 's/@''GNULIB_PUTCHAR''@/$(GL_GNULIB_PUTCHAR)/g' \
+	      -e 's/@''GNULIB_PUTS''@/$(GL_GNULIB_PUTS)/g' \
+	      -e 's/@''GNULIB_REMOVE''@/$(GL_GNULIB_REMOVE)/g' \
+	      -e 's/@''GNULIB_RENAME''@/$(GL_GNULIB_RENAME)/g' \
+	      -e 's/@''GNULIB_RENAMEAT''@/$(GL_GNULIB_RENAMEAT)/g' \
+	      -e 's/@''GNULIB_SCANF''@/$(GL_GNULIB_SCANF)/g' \
+	      -e 's/@''GNULIB_SNPRINTF''@/$(GL_GNULIB_SNPRINTF)/g' \
+	      -e 's/@''GNULIB_SPRINTF_POSIX''@/$(GL_GNULIB_SPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_STDIO_H_NONBLOCKING''@/$(GL_GNULIB_STDIO_H_NONBLOCKING)/g' \
+	      -e 's/@''GNULIB_STDIO_H_SIGPIPE''@/$(GL_GNULIB_STDIO_H_SIGPIPE)/g' \
+	      -e 's/@''GNULIB_TMPFILE''@/$(GL_GNULIB_TMPFILE)/g' \
+	      -e 's/@''GNULIB_VASPRINTF''@/$(GL_GNULIB_VASPRINTF)/g' \
+	      -e 's/@''GNULIB_VDPRINTF''@/$(GL_GNULIB_VDPRINTF)/g' \
+	      -e 's/@''GNULIB_VFPRINTF''@/$(GL_GNULIB_VFPRINTF)/g' \
+	      -e 's/@''GNULIB_VFPRINTF_POSIX''@/$(GL_GNULIB_VFPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_VFSCANF''@/$(GL_GNULIB_VFSCANF)/g' \
+	      -e 's/@''GNULIB_VSCANF''@/$(GL_GNULIB_VSCANF)/g' \
+	      -e 's/@''GNULIB_VPRINTF''@/$(GL_GNULIB_VPRINTF)/g' \
+	      -e 's/@''GNULIB_VPRINTF_POSIX''@/$(GL_GNULIB_VPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_VSNPRINTF''@/$(GL_GNULIB_VSNPRINTF)/g' \
+	      -e 's/@''GNULIB_VSPRINTF_POSIX''@/$(GL_GNULIB_VSPRINTF_POSIX)/g' \
+	      -e 's/@''GNULIB_MDA_FCLOSEALL''@/$(GL_GNULIB_MDA_FCLOSEALL)/g' \
+	      -e 's/@''GNULIB_MDA_FDOPEN''@/$(GL_GNULIB_MDA_FDOPEN)/g' \
+	      -e 's/@''GNULIB_MDA_FILENO''@/$(GL_GNULIB_MDA_FILENO)/g' \
+	      -e 's/@''GNULIB_MDA_GETW''@/$(GL_GNULIB_MDA_GETW)/g' \
+	      -e 's/@''GNULIB_MDA_PUTW''@/$(GL_GNULIB_MDA_PUTW)/g' \
+	      -e 's/@''GNULIB_MDA_TEMPNAM''@/$(GL_GNULIB_MDA_TEMPNAM)/g' \
 	      < $(top_srcdir)/lib/stdio.in.h | \
-	  sed -e 's|@''HAVE_DECL_FPURGE''@|$(HAVE_DECL_FPURGE)|g' \
+	  sed -e 's|@''HAVE_DECL_FCLOSEALL''@|$(HAVE_DECL_FCLOSEALL)|g' \
+	      -e 's|@''HAVE_DECL_FPURGE''@|$(HAVE_DECL_FPURGE)|g' \
 	      -e 's|@''HAVE_DECL_FSEEKO''@|$(HAVE_DECL_FSEEKO)|g' \
 	      -e 's|@''HAVE_DECL_FTELLO''@|$(HAVE_DECL_FTELLO)|g' \
 	      -e 's|@''HAVE_DECL_GETDELIM''@|$(HAVE_DECL_GETDELIM)|g' \
 	      -e 's|@''HAVE_DECL_GETLINE''@|$(HAVE_DECL_GETLINE)|g' \
+	      -e 's|@''HAVE_DECL_GETW''@|$(HAVE_DECL_GETW)|g' \
 	      -e 's|@''HAVE_DECL_OBSTACK_PRINTF''@|$(HAVE_DECL_OBSTACK_PRINTF)|g' \
+	      -e 's|@''HAVE_DECL_PUTW''@|$(HAVE_DECL_PUTW)|g' \
 	      -e 's|@''HAVE_DECL_SNPRINTF''@|$(HAVE_DECL_SNPRINTF)|g' \
 	      -e 's|@''HAVE_DECL_VSNPRINTF''@|$(HAVE_DECL_VSNPRINTF)|g' \
 	      -e 's|@''HAVE_DPRINTF''@|$(HAVE_DPRINTF)|g' \
@@ -832,6 +994,7 @@
 	      -e 's|@''REPLACE_FDOPEN''@|$(REPLACE_FDOPEN)|g' \
 	      -e 's|@''REPLACE_FFLUSH''@|$(REPLACE_FFLUSH)|g' \
 	      -e 's|@''REPLACE_FOPEN''@|$(REPLACE_FOPEN)|g' \
+	      -e 's|@''REPLACE_FOPEN_FOR_FOPEN_GNU''@|$(REPLACE_FOPEN_FOR_FOPEN_GNU)|g' \
 	      -e 's|@''REPLACE_FPRINTF''@|$(REPLACE_FPRINTF)|g' \
 	      -e 's|@''REPLACE_FPURGE''@|$(REPLACE_FPURGE)|g' \
 	      -e 's|@''REPLACE_FREOPEN''@|$(REPLACE_FREOPEN)|g' \
@@ -862,15 +1025,181 @@
 	      -e 's|@''ASM_SYMBOL_PREFIX''@|$(ASM_SYMBOL_PREFIX)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/stdio.h lib/stdio.h-t
 
+if GL_COND_OBJ_STDIO_READ
+lib_libgnu_a_SOURCES += lib/stdio-read.c
+endif
+if GL_COND_OBJ_STDIO_WRITE
+lib_libgnu_a_SOURCES += lib/stdio-write.c
+endif
+
 EXTRA_DIST += lib/stdio.in.h
 
 ## end   gnulib module stdio
 
+## begin gnulib module stdlib
+
+BUILT_SOURCES += lib/stdlib.h
+
+# We need the following in order to create <stdlib.h> when the system
+# doesn't have one that works with the given compiler.
+lib/stdlib.h: lib/stdlib.in.h $(top_builddir)/config.status $(CXXDEFS_H) \
+  $(_NORETURN_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_STDLIB_H''@|$(NEXT_STDLIB_H)|g' \
+	      -e 's/@''GNULIB__EXIT''@/$(GL_GNULIB__EXIT)/g' \
+	      -e 's/@''GNULIB_ALIGNED_ALLOC''@/$(GL_GNULIB_ALIGNED_ALLOC)/g' \
+	      -e 's/@''GNULIB_ATOLL''@/$(GL_GNULIB_ATOLL)/g' \
+	      -e 's/@''GNULIB_CALLOC_GNU''@/$(GL_GNULIB_CALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_CALLOC_POSIX''@/$(GL_GNULIB_CALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_CANONICALIZE_FILE_NAME''@/$(GL_GNULIB_CANONICALIZE_FILE_NAME)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
+	      -e 's/@''GNULIB_GETLOADAVG''@/$(GL_GNULIB_GETLOADAVG)/g' \
+	      -e 's/@''GNULIB_GETPROGNAME''@/$(GL_GNULIB_GETPROGNAME)/g' \
+	      -e 's/@''GNULIB_GETSUBOPT''@/$(GL_GNULIB_GETSUBOPT)/g' \
+	      -e 's/@''GNULIB_GRANTPT''@/$(GL_GNULIB_GRANTPT)/g' \
+	      -e 's/@''GNULIB_MALLOC_GNU''@/$(GL_GNULIB_MALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_MALLOC_POSIX''@/$(GL_GNULIB_MALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_MBTOWC''@/$(GL_GNULIB_MBTOWC)/g' \
+	      -e 's/@''GNULIB_MKDTEMP''@/$(GL_GNULIB_MKDTEMP)/g' \
+	      -e 's/@''GNULIB_MKOSTEMP''@/$(GL_GNULIB_MKOSTEMP)/g' \
+	      -e 's/@''GNULIB_MKOSTEMPS''@/$(GL_GNULIB_MKOSTEMPS)/g' \
+	      -e 's/@''GNULIB_MKSTEMP''@/$(GL_GNULIB_MKSTEMP)/g' \
+	      -e 's/@''GNULIB_MKSTEMPS''@/$(GL_GNULIB_MKSTEMPS)/g' \
+	      -e 's/@''GNULIB_POSIX_MEMALIGN''@/$(GL_GNULIB_POSIX_MEMALIGN)/g' \
+	      -e 's/@''GNULIB_POSIX_OPENPT''@/$(GL_GNULIB_POSIX_OPENPT)/g' \
+	      -e 's/@''GNULIB_PTSNAME''@/$(GL_GNULIB_PTSNAME)/g' \
+	      -e 's/@''GNULIB_PTSNAME_R''@/$(GL_GNULIB_PTSNAME_R)/g' \
+	      -e 's/@''GNULIB_PUTENV''@/$(GL_GNULIB_PUTENV)/g' \
+	      -e 's/@''GNULIB_QSORT_R''@/$(GL_GNULIB_QSORT_R)/g' \
+	      -e 's/@''GNULIB_RANDOM''@/$(GL_GNULIB_RANDOM)/g' \
+	      -e 's/@''GNULIB_RANDOM_R''@/$(GL_GNULIB_RANDOM_R)/g' \
+	      -e 's/@''GNULIB_REALLOC_GNU''@/$(GL_GNULIB_REALLOC_GNU)/g' \
+	      -e 's/@''GNULIB_REALLOC_POSIX''@/$(GL_GNULIB_REALLOC_POSIX)/g' \
+	      -e 's/@''GNULIB_REALLOCARRAY''@/$(GL_GNULIB_REALLOCARRAY)/g' \
+	      -e 's/@''GNULIB_REALPATH''@/$(GL_GNULIB_REALPATH)/g' \
+	      -e 's/@''GNULIB_RPMATCH''@/$(GL_GNULIB_RPMATCH)/g' \
+	      -e 's/@''GNULIB_SECURE_GETENV''@/$(GL_GNULIB_SECURE_GETENV)/g' \
+	      -e 's/@''GNULIB_SETENV''@/$(GL_GNULIB_SETENV)/g' \
+	      -e 's/@''GNULIB_STRTOD''@/$(GL_GNULIB_STRTOD)/g' \
+	      -e 's/@''GNULIB_STRTOL''@/$(GL_GNULIB_STRTOL)/g' \
+	      -e 's/@''GNULIB_STRTOLD''@/$(GL_GNULIB_STRTOLD)/g' \
+	      -e 's/@''GNULIB_STRTOLL''@/$(GL_GNULIB_STRTOLL)/g' \
+	      -e 's/@''GNULIB_STRTOUL''@/$(GL_GNULIB_STRTOUL)/g' \
+	      -e 's/@''GNULIB_STRTOULL''@/$(GL_GNULIB_STRTOULL)/g' \
+	      -e 's/@''GNULIB_SYSTEM_POSIX''@/$(GL_GNULIB_SYSTEM_POSIX)/g' \
+	      -e 's/@''GNULIB_UNLOCKPT''@/$(GL_GNULIB_UNLOCKPT)/g' \
+	      -e 's/@''GNULIB_UNSETENV''@/$(GL_GNULIB_UNSETENV)/g' \
+	      -e 's/@''GNULIB_WCTOMB''@/$(GL_GNULIB_WCTOMB)/g' \
+	      -e 's/@''GNULIB_MDA_ECVT''@/$(GL_GNULIB_MDA_ECVT)/g' \
+	      -e 's/@''GNULIB_MDA_FCVT''@/$(GL_GNULIB_MDA_FCVT)/g' \
+	      -e 's/@''GNULIB_MDA_GCVT''@/$(GL_GNULIB_MDA_GCVT)/g' \
+	      -e 's/@''GNULIB_MDA_MKTEMP''@/$(GL_GNULIB_MDA_MKTEMP)/g' \
+	      -e 's/@''GNULIB_MDA_PUTENV''@/$(GL_GNULIB_MDA_PUTENV)/g' \
+	      < $(top_srcdir)/lib/stdlib.in.h | \
+	  sed -e 's|@''HAVE__EXIT''@|$(HAVE__EXIT)|g' \
+	      -e 's|@''HAVE_ALIGNED_ALLOC''@|$(HAVE_ALIGNED_ALLOC)|g' \
+	      -e 's|@''HAVE_ATOLL''@|$(HAVE_ATOLL)|g' \
+	      -e 's|@''HAVE_CANONICALIZE_FILE_NAME''@|$(HAVE_CANONICALIZE_FILE_NAME)|g' \
+	      -e 's|@''HAVE_DECL_ECVT''@|$(HAVE_DECL_ECVT)|g' \
+	      -e 's|@''HAVE_DECL_FCVT''@|$(HAVE_DECL_FCVT)|g' \
+	      -e 's|@''HAVE_DECL_GCVT''@|$(HAVE_DECL_GCVT)|g' \
+	      -e 's|@''HAVE_DECL_GETLOADAVG''@|$(HAVE_DECL_GETLOADAVG)|g' \
+	      -e 's|@''HAVE_GETPROGNAME''@|$(HAVE_GETPROGNAME)|g' \
+	      -e 's|@''HAVE_GETSUBOPT''@|$(HAVE_GETSUBOPT)|g' \
+	      -e 's|@''HAVE_GRANTPT''@|$(HAVE_GRANTPT)|g' \
+	      -e 's|@''HAVE_INITSTATE''@|$(HAVE_INITSTATE)|g' \
+	      -e 's|@''HAVE_DECL_INITSTATE''@|$(HAVE_DECL_INITSTATE)|g' \
+	      -e 's|@''HAVE_MBTOWC''@|$(HAVE_MBTOWC)|g' \
+	      -e 's|@''HAVE_MKDTEMP''@|$(HAVE_MKDTEMP)|g' \
+	      -e 's|@''HAVE_MKOSTEMP''@|$(HAVE_MKOSTEMP)|g' \
+	      -e 's|@''HAVE_MKOSTEMPS''@|$(HAVE_MKOSTEMPS)|g' \
+	      -e 's|@''HAVE_MKSTEMP''@|$(HAVE_MKSTEMP)|g' \
+	      -e 's|@''HAVE_MKSTEMPS''@|$(HAVE_MKSTEMPS)|g' \
+	      -e 's|@''HAVE_POSIX_MEMALIGN''@|$(HAVE_POSIX_MEMALIGN)|g' \
+	      -e 's|@''HAVE_POSIX_OPENPT''@|$(HAVE_POSIX_OPENPT)|g' \
+	      -e 's|@''HAVE_PTSNAME''@|$(HAVE_PTSNAME)|g' \
+	      -e 's|@''HAVE_PTSNAME_R''@|$(HAVE_PTSNAME_R)|g' \
+	      -e 's|@''HAVE_QSORT_R''@|$(HAVE_QSORT_R)|g' \
+	      -e 's|@''HAVE_RANDOM''@|$(HAVE_RANDOM)|g' \
+	      -e 's|@''HAVE_RANDOM_H''@|$(HAVE_RANDOM_H)|g' \
+	      -e 's|@''HAVE_RANDOM_R''@|$(HAVE_RANDOM_R)|g' \
+	      -e 's|@''HAVE_REALLOCARRAY''@|$(HAVE_REALLOCARRAY)|g' \
+	      -e 's|@''HAVE_REALPATH''@|$(HAVE_REALPATH)|g' \
+	      -e 's|@''HAVE_RPMATCH''@|$(HAVE_RPMATCH)|g' \
+	      -e 's|@''HAVE_SECURE_GETENV''@|$(HAVE_SECURE_GETENV)|g' \
+	      -e 's|@''HAVE_DECL_SETENV''@|$(HAVE_DECL_SETENV)|g' \
+	      -e 's|@''HAVE_SETSTATE''@|$(HAVE_SETSTATE)|g' \
+	      -e 's|@''HAVE_DECL_SETSTATE''@|$(HAVE_DECL_SETSTATE)|g' \
+	      -e 's|@''HAVE_STRTOD''@|$(HAVE_STRTOD)|g' \
+	      -e 's|@''HAVE_STRTOL''@|$(HAVE_STRTOL)|g' \
+	      -e 's|@''HAVE_STRTOLD''@|$(HAVE_STRTOLD)|g' \
+	      -e 's|@''HAVE_STRTOLL''@|$(HAVE_STRTOLL)|g' \
+	      -e 's|@''HAVE_STRTOUL''@|$(HAVE_STRTOUL)|g' \
+	      -e 's|@''HAVE_STRTOULL''@|$(HAVE_STRTOULL)|g' \
+	      -e 's|@''HAVE_STRUCT_RANDOM_DATA''@|$(HAVE_STRUCT_RANDOM_DATA)|g' \
+	      -e 's|@''HAVE_SYS_LOADAVG_H''@|$(HAVE_SYS_LOADAVG_H)|g' \
+	      -e 's|@''HAVE_UNLOCKPT''@|$(HAVE_UNLOCKPT)|g' \
+	      -e 's|@''HAVE_DECL_UNSETENV''@|$(HAVE_DECL_UNSETENV)|g' \
+	      -e 's|@''REPLACE__EXIT''@|$(REPLACE__EXIT)|g' \
+	      -e 's|@''REPLACE_ALIGNED_ALLOC''@|$(REPLACE_ALIGNED_ALLOC)|g' \
+	      -e 's|@''REPLACE_CALLOC_FOR_CALLOC_GNU''@|$(REPLACE_CALLOC_FOR_CALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_CALLOC_FOR_CALLOC_POSIX''@|$(REPLACE_CALLOC_FOR_CALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_CANONICALIZE_FILE_NAME''@|$(REPLACE_CANONICALIZE_FILE_NAME)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
+	      -e 's|@''REPLACE_GETLOADAVG''@|$(REPLACE_GETLOADAVG)|g' \
+	      -e 's|@''REPLACE_GETPROGNAME''@|$(REPLACE_GETPROGNAME)|g' \
+	      -e 's|@''REPLACE_GETSUBOPT''@|$(REPLACE_GETSUBOPT)|g' \
+	      -e 's|@''REPLACE_INITSTATE''@|$(REPLACE_INITSTATE)|g' \
+	      -e 's|@''REPLACE_MALLOC_FOR_MALLOC_GNU''@|$(REPLACE_MALLOC_FOR_MALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_MALLOC_FOR_MALLOC_POSIX''@|$(REPLACE_MALLOC_FOR_MALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_MBTOWC''@|$(REPLACE_MBTOWC)|g' \
+	      -e 's|@''REPLACE_MKOSTEMP''@|$(REPLACE_MKOSTEMP)|g' \
+	      -e 's|@''REPLACE_MKOSTEMPS''@|$(REPLACE_MKOSTEMPS)|g' \
+	      -e 's|@''REPLACE_MKSTEMP''@|$(REPLACE_MKSTEMP)|g' \
+	      -e 's|@''REPLACE_POSIX_MEMALIGN''@|$(REPLACE_POSIX_MEMALIGN)|g' \
+	      -e 's|@''REPLACE_POSIX_OPENPT''@|$(REPLACE_POSIX_OPENPT)|g' \
+	      -e 's|@''REPLACE_PTSNAME''@|$(REPLACE_PTSNAME)|g' \
+	      -e 's|@''REPLACE_PTSNAME_R''@|$(REPLACE_PTSNAME_R)|g' \
+	      -e 's|@''REPLACE_PUTENV''@|$(REPLACE_PUTENV)|g' \
+	      -e 's|@''REPLACE_QSORT_R''@|$(REPLACE_QSORT_R)|g' \
+	      -e 's|@''REPLACE_RANDOM''@|$(REPLACE_RANDOM)|g' \
+	      -e 's|@''REPLACE_RANDOM_R''@|$(REPLACE_RANDOM_R)|g' \
+	      -e 's|@''REPLACE_REALLOC_FOR_REALLOC_GNU''@|$(REPLACE_REALLOC_FOR_REALLOC_GNU)|g' \
+	      -e 's|@''REPLACE_REALLOC_FOR_REALLOC_POSIX''@|$(REPLACE_REALLOC_FOR_REALLOC_POSIX)|g' \
+	      -e 's|@''REPLACE_REALLOCARRAY''@|$(REPLACE_REALLOCARRAY)|g' \
+	      -e 's|@''REPLACE_REALPATH''@|$(REPLACE_REALPATH)|g' \
+	      -e 's|@''REPLACE_SETENV''@|$(REPLACE_SETENV)|g' \
+	      -e 's|@''REPLACE_SETSTATE''@|$(REPLACE_SETSTATE)|g' \
+	      -e 's|@''REPLACE_STRTOD''@|$(REPLACE_STRTOD)|g' \
+	      -e 's|@''REPLACE_STRTOL''@|$(REPLACE_STRTOL)|g' \
+	      -e 's|@''REPLACE_STRTOLD''@|$(REPLACE_STRTOLD)|g' \
+	      -e 's|@''REPLACE_STRTOLL''@|$(REPLACE_STRTOLL)|g' \
+	      -e 's|@''REPLACE_STRTOUL''@|$(REPLACE_STRTOUL)|g' \
+	      -e 's|@''REPLACE_STRTOULL''@|$(REPLACE_STRTOULL)|g' \
+	      -e 's|@''REPLACE_UNSETENV''@|$(REPLACE_UNSETENV)|g' \
+	      -e 's|@''REPLACE_WCTOMB''@|$(REPLACE_WCTOMB)|g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _Noreturn/r $(_NORETURN_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
+MOSTLYCLEANFILES += lib/stdlib.h lib/stdlib.h-t
+
+EXTRA_DIST += lib/stdlib.in.h
+
+## end   gnulib module stdlib
+
 ## begin gnulib module streq
 
 
@@ -885,60 +1214,67 @@
 # We need the following in order to create <string.h> when the system
 # doesn't have one that works with the given compiler.
 lib/string.h: lib/string.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */' && \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_STRING_H''@|$(NEXT_STRING_H)|g' \
-	      -e 's/@''GNULIB_EXPLICIT_BZERO''@/$(GNULIB_EXPLICIT_BZERO)/g' \
-	      -e 's/@''GNULIB_FFSL''@/$(GNULIB_FFSL)/g' \
-	      -e 's/@''GNULIB_FFSLL''@/$(GNULIB_FFSLL)/g' \
-	      -e 's/@''GNULIB_MBSLEN''@/$(GNULIB_MBSLEN)/g' \
-	      -e 's/@''GNULIB_MBSNLEN''@/$(GNULIB_MBSNLEN)/g' \
-	      -e 's/@''GNULIB_MBSCHR''@/$(GNULIB_MBSCHR)/g' \
-	      -e 's/@''GNULIB_MBSRCHR''@/$(GNULIB_MBSRCHR)/g' \
-	      -e 's/@''GNULIB_MBSSTR''@/$(GNULIB_MBSSTR)/g' \
-	      -e 's/@''GNULIB_MBSCASECMP''@/$(GNULIB_MBSCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSNCASECMP''@/$(GNULIB_MBSNCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSPCASECMP''@/$(GNULIB_MBSPCASECMP)/g' \
-	      -e 's/@''GNULIB_MBSCASESTR''@/$(GNULIB_MBSCASESTR)/g' \
-	      -e 's/@''GNULIB_MBSCSPN''@/$(GNULIB_MBSCSPN)/g' \
-	      -e 's/@''GNULIB_MBSPBRK''@/$(GNULIB_MBSPBRK)/g' \
-	      -e 's/@''GNULIB_MBSSPN''@/$(GNULIB_MBSSPN)/g' \
-	      -e 's/@''GNULIB_MBSSEP''@/$(GNULIB_MBSSEP)/g' \
-	      -e 's/@''GNULIB_MBSTOK_R''@/$(GNULIB_MBSTOK_R)/g' \
-	      -e 's/@''GNULIB_MEMCHR''@/$(GNULIB_MEMCHR)/g' \
-	      -e 's/@''GNULIB_MEMMEM''@/$(GNULIB_MEMMEM)/g' \
-	      -e 's/@''GNULIB_MEMPCPY''@/$(GNULIB_MEMPCPY)/g' \
-	      -e 's/@''GNULIB_MEMRCHR''@/$(GNULIB_MEMRCHR)/g' \
-	      -e 's/@''GNULIB_RAWMEMCHR''@/$(GNULIB_RAWMEMCHR)/g' \
-	      -e 's/@''GNULIB_STPCPY''@/$(GNULIB_STPCPY)/g' \
-	      -e 's/@''GNULIB_STPNCPY''@/$(GNULIB_STPNCPY)/g' \
-	      -e 's/@''GNULIB_STRCHRNUL''@/$(GNULIB_STRCHRNUL)/g' \
-	      -e 's/@''GNULIB_STRDUP''@/$(GNULIB_STRDUP)/g' \
-	      -e 's/@''GNULIB_STRNCAT''@/$(GNULIB_STRNCAT)/g' \
-	      -e 's/@''GNULIB_STRNDUP''@/$(GNULIB_STRNDUP)/g' \
-	      -e 's/@''GNULIB_STRNLEN''@/$(GNULIB_STRNLEN)/g' \
-	      -e 's/@''GNULIB_STRPBRK''@/$(GNULIB_STRPBRK)/g' \
-	      -e 's/@''GNULIB_STRSEP''@/$(GNULIB_STRSEP)/g' \
-	      -e 's/@''GNULIB_STRSTR''@/$(GNULIB_STRSTR)/g' \
-	      -e 's/@''GNULIB_STRCASESTR''@/$(GNULIB_STRCASESTR)/g' \
-	      -e 's/@''GNULIB_STRTOK_R''@/$(GNULIB_STRTOK_R)/g' \
-	      -e 's/@''GNULIB_STRERROR''@/$(GNULIB_STRERROR)/g' \
-	      -e 's/@''GNULIB_STRERROR_R''@/$(GNULIB_STRERROR_R)/g' \
-	      -e 's/@''GNULIB_STRSIGNAL''@/$(GNULIB_STRSIGNAL)/g' \
-	      -e 's/@''GNULIB_STRVERSCMP''@/$(GNULIB_STRVERSCMP)/g' \
+	      -e 's/@''GNULIB_EXPLICIT_BZERO''@/$(GL_GNULIB_EXPLICIT_BZERO)/g' \
+	      -e 's/@''GNULIB_FFSL''@/$(GL_GNULIB_FFSL)/g' \
+	      -e 's/@''GNULIB_FFSLL''@/$(GL_GNULIB_FFSLL)/g' \
+	      -e 's/@''GNULIB_MBSLEN''@/$(GL_GNULIB_MBSLEN)/g' \
+	      -e 's/@''GNULIB_MBSNLEN''@/$(GL_GNULIB_MBSNLEN)/g' \
+	      -e 's/@''GNULIB_MBSCHR''@/$(GL_GNULIB_MBSCHR)/g' \
+	      -e 's/@''GNULIB_MBSRCHR''@/$(GL_GNULIB_MBSRCHR)/g' \
+	      -e 's/@''GNULIB_MBSSTR''@/$(GL_GNULIB_MBSSTR)/g' \
+	      -e 's/@''GNULIB_MBSCASECMP''@/$(GL_GNULIB_MBSCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSNCASECMP''@/$(GL_GNULIB_MBSNCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSPCASECMP''@/$(GL_GNULIB_MBSPCASECMP)/g' \
+	      -e 's/@''GNULIB_MBSCASESTR''@/$(GL_GNULIB_MBSCASESTR)/g' \
+	      -e 's/@''GNULIB_MBSCSPN''@/$(GL_GNULIB_MBSCSPN)/g' \
+	      -e 's/@''GNULIB_MBSPBRK''@/$(GL_GNULIB_MBSPBRK)/g' \
+	      -e 's/@''GNULIB_MBSSPN''@/$(GL_GNULIB_MBSSPN)/g' \
+	      -e 's/@''GNULIB_MBSSEP''@/$(GL_GNULIB_MBSSEP)/g' \
+	      -e 's/@''GNULIB_MBSTOK_R''@/$(GL_GNULIB_MBSTOK_R)/g' \
+	      -e 's/@''GNULIB_MEMCHR''@/$(GL_GNULIB_MEMCHR)/g' \
+	      -e 's/@''GNULIB_MEMMEM''@/$(GL_GNULIB_MEMMEM)/g' \
+	      -e 's/@''GNULIB_MEMPCPY''@/$(GL_GNULIB_MEMPCPY)/g' \
+	      -e 's/@''GNULIB_MEMRCHR''@/$(GL_GNULIB_MEMRCHR)/g' \
+	      -e 's/@''GNULIB_MEMSET_EXPLICIT''@/$(GL_GNULIB_MEMSET_EXPLICIT)/g' \
+	      -e 's/@''GNULIB_RAWMEMCHR''@/$(GL_GNULIB_RAWMEMCHR)/g' \
+	      -e 's/@''GNULIB_STPCPY''@/$(GL_GNULIB_STPCPY)/g' \
+	      -e 's/@''GNULIB_STPNCPY''@/$(GL_GNULIB_STPNCPY)/g' \
+	      -e 's/@''GNULIB_STRCHRNUL''@/$(GL_GNULIB_STRCHRNUL)/g' \
+	      -e 's/@''GNULIB_STRDUP''@/$(GL_GNULIB_STRDUP)/g' \
+	      -e 's/@''GNULIB_STRNCAT''@/$(GL_GNULIB_STRNCAT)/g' \
+	      -e 's/@''GNULIB_STRNDUP''@/$(GL_GNULIB_STRNDUP)/g' \
+	      -e 's/@''GNULIB_STRNLEN''@/$(GL_GNULIB_STRNLEN)/g' \
+	      -e 's/@''GNULIB_STRPBRK''@/$(GL_GNULIB_STRPBRK)/g' \
+	      -e 's/@''GNULIB_STRSEP''@/$(GL_GNULIB_STRSEP)/g' \
+	      -e 's/@''GNULIB_STRSTR''@/$(GL_GNULIB_STRSTR)/g' \
+	      -e 's/@''GNULIB_STRCASESTR''@/$(GL_GNULIB_STRCASESTR)/g' \
+	      -e 's/@''GNULIB_STRTOK_R''@/$(GL_GNULIB_STRTOK_R)/g' \
+	      -e 's/@''GNULIB_STRERROR''@/$(GL_GNULIB_STRERROR)/g' \
+	      -e 's/@''GNULIB_STRERROR_R''@/$(GL_GNULIB_STRERROR_R)/g' \
+	      -e 's/@''GNULIB_STRERRORNAME_NP''@/$(GL_GNULIB_STRERRORNAME_NP)/g' \
+	      -e 's/@''GNULIB_SIGABBREV_NP''@/$(GL_GNULIB_SIGABBREV_NP)/g' \
+	      -e 's/@''GNULIB_SIGDESCR_NP''@/$(GL_GNULIB_SIGDESCR_NP)/g' \
+	      -e 's/@''GNULIB_STRSIGNAL''@/$(GL_GNULIB_STRSIGNAL)/g' \
+	      -e 's/@''GNULIB_STRVERSCMP''@/$(GL_GNULIB_STRVERSCMP)/g' \
+	      -e 's/@''GNULIB_MDA_MEMCCPY''@/$(GL_GNULIB_MDA_MEMCCPY)/g' \
+	      -e 's/@''GNULIB_MDA_STRDUP''@/$(GL_GNULIB_MDA_STRDUP)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
 	      < $(top_srcdir)/lib/string.in.h | \
 	  sed -e 's|@''HAVE_EXPLICIT_BZERO''@|$(HAVE_EXPLICIT_BZERO)|g' \
 	      -e 's|@''HAVE_FFSL''@|$(HAVE_FFSL)|g' \
 	      -e 's|@''HAVE_FFSLL''@|$(HAVE_FFSLL)|g' \
 	      -e 's|@''HAVE_MBSLEN''@|$(HAVE_MBSLEN)|g' \
-	      -e 's|@''HAVE_MEMCHR''@|$(HAVE_MEMCHR)|g' \
 	      -e 's|@''HAVE_DECL_MEMMEM''@|$(HAVE_DECL_MEMMEM)|g' \
 	      -e 's|@''HAVE_MEMPCPY''@|$(HAVE_MEMPCPY)|g' \
 	      -e 's|@''HAVE_DECL_MEMRCHR''@|$(HAVE_DECL_MEMRCHR)|g' \
+	      -e 's|@''HAVE_MEMSET_EXPLICIT''@|$(HAVE_MEMSET_EXPLICIT)|g' \
 	      -e 's|@''HAVE_RAWMEMCHR''@|$(HAVE_RAWMEMCHR)|g' \
 	      -e 's|@''HAVE_STPCPY''@|$(HAVE_STPCPY)|g' \
 	      -e 's|@''HAVE_STPNCPY''@|$(HAVE_STPNCPY)|g' \
@@ -951,10 +1287,17 @@
 	      -e 's|@''HAVE_STRCASESTR''@|$(HAVE_STRCASESTR)|g' \
 	      -e 's|@''HAVE_DECL_STRTOK_R''@|$(HAVE_DECL_STRTOK_R)|g' \
 	      -e 's|@''HAVE_DECL_STRERROR_R''@|$(HAVE_DECL_STRERROR_R)|g' \
+	      -e 's|@''HAVE_STRERRORNAME_NP''@|$(HAVE_STRERRORNAME_NP)|g' \
+	      -e 's|@''HAVE_SIGABBREV_NP''@|$(HAVE_SIGABBREV_NP)|g' \
+	      -e 's|@''HAVE_SIGDESCR_NP''@|$(HAVE_SIGDESCR_NP)|g' \
 	      -e 's|@''HAVE_DECL_STRSIGNAL''@|$(HAVE_DECL_STRSIGNAL)|g' \
 	      -e 's|@''HAVE_STRVERSCMP''@|$(HAVE_STRVERSCMP)|g' \
+	      -e 's|@''REPLACE_FFSLL''@|$(REPLACE_FFSLL)|g' \
 	      -e 's|@''REPLACE_MEMCHR''@|$(REPLACE_MEMCHR)|g' \
 	      -e 's|@''REPLACE_MEMMEM''@|$(REPLACE_MEMMEM)|g' \
+	      -e 's|@''REPLACE_MEMPCPY''@|$(REPLACE_MEMPCPY)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
+	      -e 's|@''REPLACE_STPCPY''@|$(REPLACE_STPCPY)|g' \
 	      -e 's|@''REPLACE_STPNCPY''@|$(REPLACE_STPNCPY)|g' \
 	      -e 's|@''REPLACE_STRCHRNUL''@|$(REPLACE_STRCHRNUL)|g' \
 	      -e 's|@''REPLACE_STRDUP''@|$(REPLACE_STRDUP)|g' \
@@ -966,14 +1309,14 @@
 	      -e 's|@''REPLACE_STRTOK_R''@|$(REPLACE_STRTOK_R)|g' \
 	      -e 's|@''REPLACE_STRERROR''@|$(REPLACE_STRERROR)|g' \
 	      -e 's|@''REPLACE_STRERROR_R''@|$(REPLACE_STRERROR_R)|g' \
+	      -e 's|@''REPLACE_STRERRORNAME_NP''@|$(REPLACE_STRERRORNAME_NP)|g' \
 	      -e 's|@''REPLACE_STRSIGNAL''@|$(REPLACE_STRSIGNAL)|g' \
 	      -e 's|@''UNDEFINE_STRTOK_R''@|$(UNDEFINE_STRTOK_R)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	      < $(top_srcdir)/lib/string.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/string.h lib/string.h-t
 
 EXTRA_DIST += lib/string.in.h
@@ -987,35 +1330,244 @@
 # We need the following in order to create <sys/types.h> when the system
 # doesn't have one that works with the given compiler.
 lib/sys/types.h: lib/sys_types.in.h $(top_builddir)/config.status
-	$(AM_V_at)$(MKDIR_P) lib/sys
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%/sys'
+	$(AM_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_SYS_TYPES_H''@|$(NEXT_SYS_TYPES_H)|g' \
 	      -e 's|@''WINDOWS_64_BIT_OFF_T''@|$(WINDOWS_64_BIT_OFF_T)|g' \
 	      -e 's|@''WINDOWS_STAT_INODES''@|$(WINDOWS_STAT_INODES)|g' \
-	      < $(top_srcdir)/lib/sys_types.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/sys_types.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/sys/types.h lib/sys/types.h-t
 
 EXTRA_DIST += lib/sys_types.in.h
 
 ## end   gnulib module sys_types
 
+## begin gnulib module unistd
+
+BUILT_SOURCES += lib/unistd.h
+lib_libgnu_a_SOURCES += lib/unistd.c
+
+# We need the following in order to create an empty placeholder for
+# <unistd.h> when the system doesn't have one.
+lib/unistd.h: lib/unistd.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
+	      -e 's|@''HAVE_UNISTD_H''@|$(HAVE_UNISTD_H)|g' \
+	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
+	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
+	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
+	      -e 's|@''NEXT_UNISTD_H''@|$(NEXT_UNISTD_H)|g' \
+	      -e 's|@''WINDOWS_64_BIT_OFF_T''@|$(WINDOWS_64_BIT_OFF_T)|g' \
+	      -e 's/@''GNULIB_ACCESS''@/$(GL_GNULIB_ACCESS)/g' \
+	      -e 's/@''GNULIB_CHDIR''@/$(GL_GNULIB_CHDIR)/g' \
+	      -e 's/@''GNULIB_CHOWN''@/$(GL_GNULIB_CHOWN)/g' \
+	      -e 's/@''GNULIB_CLOSE''@/$(GL_GNULIB_CLOSE)/g' \
+	      -e 's/@''GNULIB_COPY_FILE_RANGE''@/$(GL_GNULIB_COPY_FILE_RANGE)/g' \
+	      -e 's/@''GNULIB_DUP''@/$(GL_GNULIB_DUP)/g' \
+	      -e 's/@''GNULIB_DUP2''@/$(GL_GNULIB_DUP2)/g' \
+	      -e 's/@''GNULIB_DUP3''@/$(GL_GNULIB_DUP3)/g' \
+	      -e 's/@''GNULIB_ENVIRON''@/$(GL_GNULIB_ENVIRON)/g' \
+	      -e 's/@''GNULIB_EUIDACCESS''@/$(GL_GNULIB_EUIDACCESS)/g' \
+	      -e 's/@''GNULIB_EXECL''@/$(GL_GNULIB_EXECL)/g' \
+	      -e 's/@''GNULIB_EXECLE''@/$(GL_GNULIB_EXECLE)/g' \
+	      -e 's/@''GNULIB_EXECLP''@/$(GL_GNULIB_EXECLP)/g' \
+	      -e 's/@''GNULIB_EXECV''@/$(GL_GNULIB_EXECV)/g' \
+	      -e 's/@''GNULIB_EXECVE''@/$(GL_GNULIB_EXECVE)/g' \
+	      -e 's/@''GNULIB_EXECVP''@/$(GL_GNULIB_EXECVP)/g' \
+	      -e 's/@''GNULIB_EXECVPE''@/$(GL_GNULIB_EXECVPE)/g' \
+	      -e 's/@''GNULIB_FACCESSAT''@/$(GL_GNULIB_FACCESSAT)/g' \
+	      -e 's/@''GNULIB_FCHDIR''@/$(GL_GNULIB_FCHDIR)/g' \
+	      -e 's/@''GNULIB_FCHOWNAT''@/$(GL_GNULIB_FCHOWNAT)/g' \
+	      -e 's/@''GNULIB_FDATASYNC''@/$(GL_GNULIB_FDATASYNC)/g' \
+	      -e 's/@''GNULIB_FSYNC''@/$(GL_GNULIB_FSYNC)/g' \
+	      -e 's/@''GNULIB_FTRUNCATE''@/$(GL_GNULIB_FTRUNCATE)/g' \
+	      -e 's/@''GNULIB_GETCWD''@/$(GL_GNULIB_GETCWD)/g' \
+	      -e 's/@''GNULIB_GETDOMAINNAME''@/$(GL_GNULIB_GETDOMAINNAME)/g' \
+	      -e 's/@''GNULIB_GETDTABLESIZE''@/$(GL_GNULIB_GETDTABLESIZE)/g' \
+	      -e 's/@''GNULIB_GETENTROPY''@/$(GL_GNULIB_GETENTROPY)/g' \
+	      -e 's/@''GNULIB_GETGROUPS''@/$(GL_GNULIB_GETGROUPS)/g' \
+	      -e 's/@''GNULIB_GETHOSTNAME''@/$(GL_GNULIB_GETHOSTNAME)/g' \
+	      -e 's/@''GNULIB_GETLOGIN''@/$(GL_GNULIB_GETLOGIN)/g' \
+	      -e 's/@''GNULIB_GETLOGIN_R''@/$(GL_GNULIB_GETLOGIN_R)/g' \
+	      -e 's/@''GNULIB_GETOPT_POSIX''@/$(GL_GNULIB_GETOPT_POSIX)/g' \
+	      -e 's/@''GNULIB_GETPAGESIZE''@/$(GL_GNULIB_GETPAGESIZE)/g' \
+	      -e 's/@''GNULIB_GETPASS''@/$(GL_GNULIB_GETPASS)/g' \
+	      -e 's/@''GNULIB_GETPASS_GNU''@/$(GL_GNULIB_GETPASS_GNU)/g' \
+	      -e 's/@''GNULIB_GETUSERSHELL''@/$(GL_GNULIB_GETUSERSHELL)/g' \
+	      -e 's/@''GNULIB_GROUP_MEMBER''@/$(GL_GNULIB_GROUP_MEMBER)/g' \
+	      -e 's/@''GNULIB_ISATTY''@/$(GL_GNULIB_ISATTY)/g' \
+	      -e 's/@''GNULIB_LCHOWN''@/$(GL_GNULIB_LCHOWN)/g' \
+	      -e 's/@''GNULIB_LINK''@/$(GL_GNULIB_LINK)/g' \
+	      -e 's/@''GNULIB_LINKAT''@/$(GL_GNULIB_LINKAT)/g' \
+	      -e 's/@''GNULIB_LSEEK''@/$(GL_GNULIB_LSEEK)/g' \
+	      -e 's/@''GNULIB_PIPE''@/$(GL_GNULIB_PIPE)/g' \
+	      -e 's/@''GNULIB_PIPE2''@/$(GL_GNULIB_PIPE2)/g' \
+	      -e 's/@''GNULIB_PREAD''@/$(GL_GNULIB_PREAD)/g' \
+	      -e 's/@''GNULIB_PWRITE''@/$(GL_GNULIB_PWRITE)/g' \
+	      -e 's/@''GNULIB_READ''@/$(GL_GNULIB_READ)/g' \
+	      -e 's/@''GNULIB_READLINK''@/$(GL_GNULIB_READLINK)/g' \
+	      -e 's/@''GNULIB_READLINKAT''@/$(GL_GNULIB_READLINKAT)/g' \
+	      -e 's/@''GNULIB_RMDIR''@/$(GL_GNULIB_RMDIR)/g' \
+	      -e 's/@''GNULIB_SETHOSTNAME''@/$(GL_GNULIB_SETHOSTNAME)/g' \
+	      -e 's/@''GNULIB_SLEEP''@/$(GL_GNULIB_SLEEP)/g' \
+	      -e 's/@''GNULIB_SYMLINK''@/$(GL_GNULIB_SYMLINK)/g' \
+	      -e 's/@''GNULIB_SYMLINKAT''@/$(GL_GNULIB_SYMLINKAT)/g' \
+	      -e 's/@''GNULIB_TRUNCATE''@/$(GL_GNULIB_TRUNCATE)/g' \
+	      -e 's/@''GNULIB_TTYNAME_R''@/$(GL_GNULIB_TTYNAME_R)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_GETOPT''@/0$(GL_GNULIB_UNISTD_H_GETOPT)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_NONBLOCKING''@/$(GL_GNULIB_UNISTD_H_NONBLOCKING)/g' \
+	      -e 's/@''GNULIB_UNISTD_H_SIGPIPE''@/$(GL_GNULIB_UNISTD_H_SIGPIPE)/g' \
+	      -e 's/@''GNULIB_UNLINK''@/$(GL_GNULIB_UNLINK)/g' \
+	      -e 's/@''GNULIB_UNLINKAT''@/$(GL_GNULIB_UNLINKAT)/g' \
+	      -e 's/@''GNULIB_USLEEP''@/$(GL_GNULIB_USLEEP)/g' \
+	      -e 's/@''GNULIB_WRITE''@/$(GL_GNULIB_WRITE)/g' \
+	      -e 's/@''GNULIB_MDA_ACCESS''@/$(GL_GNULIB_MDA_ACCESS)/g' \
+	      -e 's/@''GNULIB_MDA_CHDIR''@/$(GL_GNULIB_MDA_CHDIR)/g' \
+	      -e 's/@''GNULIB_MDA_CLOSE''@/$(GL_GNULIB_MDA_CLOSE)/g' \
+	      -e 's/@''GNULIB_MDA_DUP''@/$(GL_GNULIB_MDA_DUP)/g' \
+	      -e 's/@''GNULIB_MDA_DUP2''@/$(GL_GNULIB_MDA_DUP2)/g' \
+	      -e 's/@''GNULIB_MDA_EXECL''@/$(GL_GNULIB_MDA_EXECL)/g' \
+	      -e 's/@''GNULIB_MDA_EXECLE''@/$(GL_GNULIB_MDA_EXECLE)/g' \
+	      -e 's/@''GNULIB_MDA_EXECLP''@/$(GL_GNULIB_MDA_EXECLP)/g' \
+	      -e 's/@''GNULIB_MDA_EXECV''@/$(GL_GNULIB_MDA_EXECV)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVE''@/$(GL_GNULIB_MDA_EXECVE)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVP''@/$(GL_GNULIB_MDA_EXECVP)/g' \
+	      -e 's/@''GNULIB_MDA_EXECVPE''@/$(GL_GNULIB_MDA_EXECVPE)/g' \
+	      -e 's/@''GNULIB_MDA_GETCWD''@/$(GL_GNULIB_MDA_GETCWD)/g' \
+	      -e 's/@''GNULIB_MDA_GETPID''@/$(GL_GNULIB_MDA_GETPID)/g' \
+	      -e 's/@''GNULIB_MDA_ISATTY''@/$(GL_GNULIB_MDA_ISATTY)/g' \
+	      -e 's/@''GNULIB_MDA_LSEEK''@/$(GL_GNULIB_MDA_LSEEK)/g' \
+	      -e 's/@''GNULIB_MDA_READ''@/$(GL_GNULIB_MDA_READ)/g' \
+	      -e 's/@''GNULIB_MDA_RMDIR''@/$(GL_GNULIB_MDA_RMDIR)/g' \
+	      -e 's/@''GNULIB_MDA_SWAB''@/$(GL_GNULIB_MDA_SWAB)/g' \
+	      -e 's/@''GNULIB_MDA_UNLINK''@/$(GL_GNULIB_MDA_UNLINK)/g' \
+	      -e 's/@''GNULIB_MDA_WRITE''@/$(GL_GNULIB_MDA_WRITE)/g' \
+	      < $(top_srcdir)/lib/unistd.in.h | \
+	  sed -e 's|@''HAVE_CHOWN''@|$(HAVE_CHOWN)|g' \
+	      -e 's|@''HAVE_COPY_FILE_RANGE''@|$(HAVE_COPY_FILE_RANGE)|g' \
+	      -e 's|@''HAVE_DUP3''@|$(HAVE_DUP3)|g' \
+	      -e 's|@''HAVE_EUIDACCESS''@|$(HAVE_EUIDACCESS)|g' \
+	      -e 's|@''HAVE_EXECVPE''@|$(HAVE_EXECVPE)|g' \
+	      -e 's|@''HAVE_FACCESSAT''@|$(HAVE_FACCESSAT)|g' \
+	      -e 's|@''HAVE_FCHDIR''@|$(HAVE_FCHDIR)|g' \
+	      -e 's|@''HAVE_FCHOWNAT''@|$(HAVE_FCHOWNAT)|g' \
+	      -e 's|@''HAVE_FDATASYNC''@|$(HAVE_FDATASYNC)|g' \
+	      -e 's|@''HAVE_FSYNC''@|$(HAVE_FSYNC)|g' \
+	      -e 's|@''HAVE_FTRUNCATE''@|$(HAVE_FTRUNCATE)|g' \
+	      -e 's|@''HAVE_GETDTABLESIZE''@|$(HAVE_GETDTABLESIZE)|g' \
+	      -e 's|@''HAVE_GETENTROPY''@|$(HAVE_GETENTROPY)|g' \
+	      -e 's|@''HAVE_GETGROUPS''@|$(HAVE_GETGROUPS)|g' \
+	      -e 's|@''HAVE_GETHOSTNAME''@|$(HAVE_GETHOSTNAME)|g' \
+	      -e 's|@''HAVE_GETPAGESIZE''@|$(HAVE_GETPAGESIZE)|g' \
+	      -e 's|@''HAVE_GETPASS''@|$(HAVE_GETPASS)|g' \
+	      -e 's|@''HAVE_GROUP_MEMBER''@|$(HAVE_GROUP_MEMBER)|g' \
+	      -e 's|@''HAVE_LCHOWN''@|$(HAVE_LCHOWN)|g' \
+	      -e 's|@''HAVE_LINK''@|$(HAVE_LINK)|g' \
+	      -e 's|@''HAVE_LINKAT''@|$(HAVE_LINKAT)|g' \
+	      -e 's|@''HAVE_PIPE''@|$(HAVE_PIPE)|g' \
+	      -e 's|@''HAVE_PIPE2''@|$(HAVE_PIPE2)|g' \
+	      -e 's|@''HAVE_PREAD''@|$(HAVE_PREAD)|g' \
+	      -e 's|@''HAVE_PWRITE''@|$(HAVE_PWRITE)|g' \
+	      -e 's|@''HAVE_READLINK''@|$(HAVE_READLINK)|g' \
+	      -e 's|@''HAVE_READLINKAT''@|$(HAVE_READLINKAT)|g' \
+	      -e 's|@''HAVE_SETHOSTNAME''@|$(HAVE_SETHOSTNAME)|g' \
+	      -e 's|@''HAVE_SLEEP''@|$(HAVE_SLEEP)|g' \
+	      -e 's|@''HAVE_SYMLINK''@|$(HAVE_SYMLINK)|g' \
+	      -e 's|@''HAVE_SYMLINKAT''@|$(HAVE_SYMLINKAT)|g' \
+	      -e 's|@''HAVE_UNLINKAT''@|$(HAVE_UNLINKAT)|g' \
+	      -e 's|@''HAVE_USLEEP''@|$(HAVE_USLEEP)|g' \
+	      -e 's|@''HAVE_DECL_ENVIRON''@|$(HAVE_DECL_ENVIRON)|g' \
+	      -e 's|@''HAVE_DECL_EXECVPE''@|$(HAVE_DECL_EXECVPE)|g' \
+	      -e 's|@''HAVE_DECL_FCHDIR''@|$(HAVE_DECL_FCHDIR)|g' \
+	      -e 's|@''HAVE_DECL_FDATASYNC''@|$(HAVE_DECL_FDATASYNC)|g' \
+	      -e 's|@''HAVE_DECL_GETDOMAINNAME''@|$(HAVE_DECL_GETDOMAINNAME)|g' \
+	      -e 's|@''HAVE_DECL_GETLOGIN''@|$(HAVE_DECL_GETLOGIN)|g' \
+	      -e 's|@''HAVE_DECL_GETLOGIN_R''@|$(HAVE_DECL_GETLOGIN_R)|g' \
+	      -e 's|@''HAVE_DECL_GETPAGESIZE''@|$(HAVE_DECL_GETPAGESIZE)|g' \
+	      -e 's|@''HAVE_DECL_GETUSERSHELL''@|$(HAVE_DECL_GETUSERSHELL)|g' \
+	      -e 's|@''HAVE_DECL_SETHOSTNAME''@|$(HAVE_DECL_SETHOSTNAME)|g' \
+	      -e 's|@''HAVE_DECL_TRUNCATE''@|$(HAVE_DECL_TRUNCATE)|g' \
+	      -e 's|@''HAVE_DECL_TTYNAME_R''@|$(HAVE_DECL_TTYNAME_R)|g' \
+	      -e 's|@''HAVE_OS_H''@|$(HAVE_OS_H)|g' \
+	      -e 's|@''HAVE_SYS_PARAM_H''@|$(HAVE_SYS_PARAM_H)|g' \
+	  | \
+	  sed -e 's|@''REPLACE_ACCESS''@|$(REPLACE_ACCESS)|g' \
+	      -e 's|@''REPLACE_CHOWN''@|$(REPLACE_CHOWN)|g' \
+	      -e 's|@''REPLACE_CLOSE''@|$(REPLACE_CLOSE)|g' \
+	      -e 's|@''REPLACE_COPY_FILE_RANGE''@|$(REPLACE_COPY_FILE_RANGE)|g' \
+	      -e 's|@''REPLACE_DUP''@|$(REPLACE_DUP)|g' \
+	      -e 's|@''REPLACE_DUP2''@|$(REPLACE_DUP2)|g' \
+	      -e 's|@''REPLACE_DUP3''@|$(REPLACE_DUP3)|g' \
+	      -e 's|@''REPLACE_EXECL''@|$(REPLACE_EXECL)|g' \
+	      -e 's|@''REPLACE_EXECLE''@|$(REPLACE_EXECLE)|g' \
+	      -e 's|@''REPLACE_EXECLP''@|$(REPLACE_EXECLP)|g' \
+	      -e 's|@''REPLACE_EXECV''@|$(REPLACE_EXECV)|g' \
+	      -e 's|@''REPLACE_EXECVE''@|$(REPLACE_EXECVE)|g' \
+	      -e 's|@''REPLACE_EXECVP''@|$(REPLACE_EXECVP)|g' \
+	      -e 's|@''REPLACE_EXECVPE''@|$(REPLACE_EXECVPE)|g' \
+	      -e 's|@''REPLACE_FACCESSAT''@|$(REPLACE_FACCESSAT)|g' \
+	      -e 's|@''REPLACE_FCHOWNAT''@|$(REPLACE_FCHOWNAT)|g' \
+	      -e 's|@''REPLACE_FDATASYNC''@|$(REPLACE_FDATASYNC)|g' \
+	      -e 's|@''REPLACE_FTRUNCATE''@|$(REPLACE_FTRUNCATE)|g' \
+	      -e 's|@''REPLACE_GETCWD''@|$(REPLACE_GETCWD)|g' \
+	      -e 's|@''REPLACE_GETDOMAINNAME''@|$(REPLACE_GETDOMAINNAME)|g' \
+	      -e 's|@''REPLACE_GETDTABLESIZE''@|$(REPLACE_GETDTABLESIZE)|g' \
+	      -e 's|@''REPLACE_GETENTROPY''@|$(REPLACE_GETENTROPY)|g' \
+	      -e 's|@''REPLACE_GETLOGIN_R''@|$(REPLACE_GETLOGIN_R)|g' \
+	      -e 's|@''REPLACE_GETGROUPS''@|$(REPLACE_GETGROUPS)|g' \
+	      -e 's|@''REPLACE_GETPAGESIZE''@|$(REPLACE_GETPAGESIZE)|g' \
+	      -e 's|@''REPLACE_GETPASS''@|$(REPLACE_GETPASS)|g' \
+	      -e 's|@''REPLACE_GETPASS_FOR_GETPASS_GNU''@|$(REPLACE_GETPASS_FOR_GETPASS_GNU)|g' \
+	      -e 's|@''REPLACE_ISATTY''@|$(REPLACE_ISATTY)|g' \
+	      -e 's|@''REPLACE_LCHOWN''@|$(REPLACE_LCHOWN)|g' \
+	      -e 's|@''REPLACE_LINK''@|$(REPLACE_LINK)|g' \
+	      -e 's|@''REPLACE_LINKAT''@|$(REPLACE_LINKAT)|g' \
+	      -e 's|@''REPLACE_LSEEK''@|$(REPLACE_LSEEK)|g' \
+	      -e 's|@''REPLACE_PIPE2''@|$(REPLACE_PIPE2)|g' \
+	      -e 's|@''REPLACE_PREAD''@|$(REPLACE_PREAD)|g' \
+	      -e 's|@''REPLACE_PWRITE''@|$(REPLACE_PWRITE)|g' \
+	      -e 's|@''REPLACE_READ''@|$(REPLACE_READ)|g' \
+	      -e 's|@''REPLACE_READLINK''@|$(REPLACE_READLINK)|g' \
+	      -e 's|@''REPLACE_READLINKAT''@|$(REPLACE_READLINKAT)|g' \
+	      -e 's|@''REPLACE_RMDIR''@|$(REPLACE_RMDIR)|g' \
+	      -e 's|@''REPLACE_SETHOSTNAME''@|$(REPLACE_SETHOSTNAME)|g' \
+	      -e 's|@''REPLACE_SLEEP''@|$(REPLACE_SLEEP)|g' \
+	      -e 's|@''REPLACE_SYMLINK''@|$(REPLACE_SYMLINK)|g' \
+	      -e 's|@''REPLACE_SYMLINKAT''@|$(REPLACE_SYMLINKAT)|g' \
+	      -e 's|@''REPLACE_TRUNCATE''@|$(REPLACE_TRUNCATE)|g' \
+	      -e 's|@''REPLACE_TTYNAME_R''@|$(REPLACE_TTYNAME_R)|g' \
+	      -e 's|@''REPLACE_UNLINK''@|$(REPLACE_UNLINK)|g' \
+	      -e 's|@''REPLACE_UNLINKAT''@|$(REPLACE_UNLINKAT)|g' \
+	      -e 's|@''REPLACE_USLEEP''@|$(REPLACE_USLEEP)|g' \
+	      -e 's|@''REPLACE_WRITE''@|$(REPLACE_WRITE)|g' \
+	      -e 's|@''UNISTD_H_HAVE_SYS_RANDOM_H''@|$(UNISTD_H_HAVE_SYS_RANDOM_H)|g' \
+	      -e 's|@''UNISTD_H_HAVE_WINSOCK2_H''@|$(UNISTD_H_HAVE_WINSOCK2_H)|g' \
+	      -e 's|@''UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS''@|$(UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS)|g' \
+	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
+	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
+MOSTLYCLEANFILES += lib/unistd.h lib/unistd.h-t
+
+EXTRA_DIST += lib/unistd.in.h
+
+## end   gnulib module unistd
+
 ## begin gnulib module unitypes
 
 BUILT_SOURCES += $(LIBUNISTRING_UNITYPES_H)
 
 lib/unitypes.h: lib/unitypes.in.h
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  cat $(top_srcdir)/lib/unitypes.in.h; \
-	} > $@-t && \
-	mv -f $@-t $@
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_TO_AT_t) $(top_srcdir)/lib/unitypes.in.h
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/unitypes.h lib/unitypes.h-t
 
 EXTRA_DIST += lib/unitypes.in.h
@@ -1027,11 +1579,9 @@
 BUILT_SOURCES += $(LIBUNISTRING_UNIWIDTH_H)
 
 lib/uniwidth.h: lib/uniwidth.in.h
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  cat $(top_srcdir)/lib/uniwidth.in.h; \
-	} > $@-t && \
-	mv -f $@-t $@
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_TO_AT_t) $(top_srcdir)/lib/uniwidth.in.h
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/uniwidth.h lib/uniwidth.h-t
 
 EXTRA_DIST += lib/localcharset.h lib/uniwidth.in.h
@@ -1044,7 +1594,7 @@
 lib_libgnu_a_SOURCES += lib/uniwidth/width.c
 endif
 
-EXTRA_DIST += lib/uniwidth/cjk.h
+EXTRA_DIST += lib/unictype/bitmap.h lib/uniwidth/cjk.h lib/uniwidth/width0.h lib/uniwidth/width2.h
 
 ## end   gnulib module uniwidth/width
 
@@ -1057,13 +1607,6 @@
 
 ## end   gnulib module vasnprintf
 
-## begin gnulib module verify
-
-
-EXTRA_DIST += lib/verify.h
-
-## end   gnulib module verify
-
 ## begin gnulib module vsnprintf
 
 
@@ -1080,9 +1623,9 @@
 # We need the following in order to create <wchar.h> when the system
 # version does not work standalone.
 lib/wchar.h: lib/wchar.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(ARG_NONNULL_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
@@ -1090,47 +1633,50 @@
 	      -e 's|@''NEXT_WCHAR_H''@|$(NEXT_WCHAR_H)|g' \
 	      -e 's|@''HAVE_WCHAR_H''@|$(HAVE_WCHAR_H)|g' \
 	      -e 's/@''HAVE_CRTDEFS_H''@/$(HAVE_CRTDEFS_H)/g' \
-	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-	      -e 's/@''GNULIB_BTOWC''@/$(GNULIB_BTOWC)/g' \
-	      -e 's/@''GNULIB_WCTOB''@/$(GNULIB_WCTOB)/g' \
-	      -e 's/@''GNULIB_MBSINIT''@/$(GNULIB_MBSINIT)/g' \
-	      -e 's/@''GNULIB_MBRTOWC''@/$(GNULIB_MBRTOWC)/g' \
-	      -e 's/@''GNULIB_MBRLEN''@/$(GNULIB_MBRLEN)/g' \
-	      -e 's/@''GNULIB_MBSRTOWCS''@/$(GNULIB_MBSRTOWCS)/g' \
-	      -e 's/@''GNULIB_MBSNRTOWCS''@/$(GNULIB_MBSNRTOWCS)/g' \
-	      -e 's/@''GNULIB_WCRTOMB''@/$(GNULIB_WCRTOMB)/g' \
-	      -e 's/@''GNULIB_WCSRTOMBS''@/$(GNULIB_WCSRTOMBS)/g' \
-	      -e 's/@''GNULIB_WCSNRTOMBS''@/$(GNULIB_WCSNRTOMBS)/g' \
-	      -e 's/@''GNULIB_WCWIDTH''@/$(GNULIB_WCWIDTH)/g' \
-	      -e 's/@''GNULIB_WMEMCHR''@/$(GNULIB_WMEMCHR)/g' \
-	      -e 's/@''GNULIB_WMEMCMP''@/$(GNULIB_WMEMCMP)/g' \
-	      -e 's/@''GNULIB_WMEMCPY''@/$(GNULIB_WMEMCPY)/g' \
-	      -e 's/@''GNULIB_WMEMMOVE''@/$(GNULIB_WMEMMOVE)/g' \
-	      -e 's/@''GNULIB_WMEMSET''@/$(GNULIB_WMEMSET)/g' \
-	      -e 's/@''GNULIB_WCSLEN''@/$(GNULIB_WCSLEN)/g' \
-	      -e 's/@''GNULIB_WCSNLEN''@/$(GNULIB_WCSNLEN)/g' \
-	      -e 's/@''GNULIB_WCSCPY''@/$(GNULIB_WCSCPY)/g' \
-	      -e 's/@''GNULIB_WCPCPY''@/$(GNULIB_WCPCPY)/g' \
-	      -e 's/@''GNULIB_WCSNCPY''@/$(GNULIB_WCSNCPY)/g' \
-	      -e 's/@''GNULIB_WCPNCPY''@/$(GNULIB_WCPNCPY)/g' \
-	      -e 's/@''GNULIB_WCSCAT''@/$(GNULIB_WCSCAT)/g' \
-	      -e 's/@''GNULIB_WCSNCAT''@/$(GNULIB_WCSNCAT)/g' \
-	      -e 's/@''GNULIB_WCSCMP''@/$(GNULIB_WCSCMP)/g' \
-	      -e 's/@''GNULIB_WCSNCMP''@/$(GNULIB_WCSNCMP)/g' \
-	      -e 's/@''GNULIB_WCSCASECMP''@/$(GNULIB_WCSCASECMP)/g' \
-	      -e 's/@''GNULIB_WCSNCASECMP''@/$(GNULIB_WCSNCASECMP)/g' \
-	      -e 's/@''GNULIB_WCSCOLL''@/$(GNULIB_WCSCOLL)/g' \
-	      -e 's/@''GNULIB_WCSXFRM''@/$(GNULIB_WCSXFRM)/g' \
-	      -e 's/@''GNULIB_WCSDUP''@/$(GNULIB_WCSDUP)/g' \
-	      -e 's/@''GNULIB_WCSCHR''@/$(GNULIB_WCSCHR)/g' \
-	      -e 's/@''GNULIB_WCSRCHR''@/$(GNULIB_WCSRCHR)/g' \
-	      -e 's/@''GNULIB_WCSCSPN''@/$(GNULIB_WCSCSPN)/g' \
-	      -e 's/@''GNULIB_WCSSPN''@/$(GNULIB_WCSSPN)/g' \
-	      -e 's/@''GNULIB_WCSPBRK''@/$(GNULIB_WCSPBRK)/g' \
-	      -e 's/@''GNULIB_WCSSTR''@/$(GNULIB_WCSSTR)/g' \
-	      -e 's/@''GNULIB_WCSTOK''@/$(GNULIB_WCSTOK)/g' \
-	      -e 's/@''GNULIB_WCSWIDTH''@/$(GNULIB_WCSWIDTH)/g' \
-	      -e 's/@''GNULIB_WCSFTIME''@/$(GNULIB_WCSFTIME)/g' \
+	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+	      -e 's/@''GNULIB_BTOWC''@/$(GL_GNULIB_BTOWC)/g' \
+	      -e 's/@''GNULIB_WCTOB''@/$(GL_GNULIB_WCTOB)/g' \
+	      -e 's/@''GNULIB_MBSINIT''@/$(GL_GNULIB_MBSINIT)/g' \
+	      -e 's/@''GNULIB_MBRTOWC''@/$(GL_GNULIB_MBRTOWC)/g' \
+	      -e 's/@''GNULIB_MBRLEN''@/$(GL_GNULIB_MBRLEN)/g' \
+	      -e 's/@''GNULIB_MBSRTOWCS''@/$(GL_GNULIB_MBSRTOWCS)/g' \
+	      -e 's/@''GNULIB_MBSNRTOWCS''@/$(GL_GNULIB_MBSNRTOWCS)/g' \
+	      -e 's/@''GNULIB_WCRTOMB''@/$(GL_GNULIB_WCRTOMB)/g' \
+	      -e 's/@''GNULIB_WCSRTOMBS''@/$(GL_GNULIB_WCSRTOMBS)/g' \
+	      -e 's/@''GNULIB_WCSNRTOMBS''@/$(GL_GNULIB_WCSNRTOMBS)/g' \
+	      -e 's/@''GNULIB_WCWIDTH''@/$(GL_GNULIB_WCWIDTH)/g' \
+	      -e 's/@''GNULIB_WMEMCHR''@/$(GL_GNULIB_WMEMCHR)/g' \
+	      -e 's/@''GNULIB_WMEMCMP''@/$(GL_GNULIB_WMEMCMP)/g' \
+	      -e 's/@''GNULIB_WMEMCPY''@/$(GL_GNULIB_WMEMCPY)/g' \
+	      -e 's/@''GNULIB_WMEMMOVE''@/$(GL_GNULIB_WMEMMOVE)/g' \
+	      -e 's/@''GNULIB_WMEMPCPY''@/$(GL_GNULIB_WMEMPCPY)/g' \
+	      -e 's/@''GNULIB_WMEMSET''@/$(GL_GNULIB_WMEMSET)/g' \
+	      -e 's/@''GNULIB_WCSLEN''@/$(GL_GNULIB_WCSLEN)/g' \
+	      -e 's/@''GNULIB_WCSNLEN''@/$(GL_GNULIB_WCSNLEN)/g' \
+	      -e 's/@''GNULIB_WCSCPY''@/$(GL_GNULIB_WCSCPY)/g' \
+	      -e 's/@''GNULIB_WCPCPY''@/$(GL_GNULIB_WCPCPY)/g' \
+	      -e 's/@''GNULIB_WCSNCPY''@/$(GL_GNULIB_WCSNCPY)/g' \
+	      -e 's/@''GNULIB_WCPNCPY''@/$(GL_GNULIB_WCPNCPY)/g' \
+	      -e 's/@''GNULIB_WCSCAT''@/$(GL_GNULIB_WCSCAT)/g' \
+	      -e 's/@''GNULIB_WCSNCAT''@/$(GL_GNULIB_WCSNCAT)/g' \
+	      -e 's/@''GNULIB_WCSCMP''@/$(GL_GNULIB_WCSCMP)/g' \
+	      -e 's/@''GNULIB_WCSNCMP''@/$(GL_GNULIB_WCSNCMP)/g' \
+	      -e 's/@''GNULIB_WCSCASECMP''@/$(GL_GNULIB_WCSCASECMP)/g' \
+	      -e 's/@''GNULIB_WCSNCASECMP''@/$(GL_GNULIB_WCSNCASECMP)/g' \
+	      -e 's/@''GNULIB_WCSCOLL''@/$(GL_GNULIB_WCSCOLL)/g' \
+	      -e 's/@''GNULIB_WCSXFRM''@/$(GL_GNULIB_WCSXFRM)/g' \
+	      -e 's/@''GNULIB_WCSDUP''@/$(GL_GNULIB_WCSDUP)/g' \
+	      -e 's/@''GNULIB_WCSCHR''@/$(GL_GNULIB_WCSCHR)/g' \
+	      -e 's/@''GNULIB_WCSRCHR''@/$(GL_GNULIB_WCSRCHR)/g' \
+	      -e 's/@''GNULIB_WCSCSPN''@/$(GL_GNULIB_WCSCSPN)/g' \
+	      -e 's/@''GNULIB_WCSSPN''@/$(GL_GNULIB_WCSSPN)/g' \
+	      -e 's/@''GNULIB_WCSPBRK''@/$(GL_GNULIB_WCSPBRK)/g' \
+	      -e 's/@''GNULIB_WCSSTR''@/$(GL_GNULIB_WCSSTR)/g' \
+	      -e 's/@''GNULIB_WCSTOK''@/$(GL_GNULIB_WCSTOK)/g' \
+	      -e 's/@''GNULIB_WCSWIDTH''@/$(GL_GNULIB_WCSWIDTH)/g' \
+	      -e 's/@''GNULIB_WCSFTIME''@/$(GL_GNULIB_WCSFTIME)/g' \
+	      -e 's/@''GNULIB_MDA_WCSDUP''@/$(GL_GNULIB_MDA_WCSDUP)/g' \
+	      -e 's/@''GNULIB_FREE_POSIX''@/$(GL_GNULIB_FREE_POSIX)/g' \
 	      < $(top_srcdir)/lib/wchar.in.h | \
 	  sed -e 's|@''HAVE_WINT_T''@|$(HAVE_WINT_T)|g' \
 	      -e 's|@''HAVE_BTOWC''@|$(HAVE_BTOWC)|g' \
@@ -1146,6 +1692,7 @@
 	      -e 's|@''HAVE_WMEMCMP''@|$(HAVE_WMEMCMP)|g' \
 	      -e 's|@''HAVE_WMEMCPY''@|$(HAVE_WMEMCPY)|g' \
 	      -e 's|@''HAVE_WMEMMOVE''@|$(HAVE_WMEMMOVE)|g' \
+	      -e 's|@''HAVE_WMEMPCPY''@|$(HAVE_WMEMPCPY)|g' \
 	      -e 's|@''HAVE_WMEMSET''@|$(HAVE_WMEMSET)|g' \
 	      -e 's|@''HAVE_WCSLEN''@|$(HAVE_WCSLEN)|g' \
 	      -e 's|@''HAVE_WCSNLEN''@|$(HAVE_WCSNLEN)|g' \
@@ -1172,11 +1719,13 @@
 	      -e 's|@''HAVE_WCSWIDTH''@|$(HAVE_WCSWIDTH)|g' \
 	      -e 's|@''HAVE_WCSFTIME''@|$(HAVE_WCSFTIME)|g' \
 	      -e 's|@''HAVE_DECL_WCTOB''@|$(HAVE_DECL_WCTOB)|g' \
+	      -e 's|@''HAVE_DECL_WCSDUP''@|$(HAVE_DECL_WCSDUP)|g' \
 	      -e 's|@''HAVE_DECL_WCWIDTH''@|$(HAVE_DECL_WCWIDTH)|g' \
 	  | \
 	  sed -e 's|@''REPLACE_MBSTATE_T''@|$(REPLACE_MBSTATE_T)|g' \
 	      -e 's|@''REPLACE_BTOWC''@|$(REPLACE_BTOWC)|g' \
 	      -e 's|@''REPLACE_WCTOB''@|$(REPLACE_WCTOB)|g' \
+	      -e 's|@''REPLACE_FREE''@|$(REPLACE_FREE)|g' \
 	      -e 's|@''REPLACE_MBSINIT''@|$(REPLACE_MBSINIT)|g' \
 	      -e 's|@''REPLACE_MBRTOWC''@|$(REPLACE_MBRTOWC)|g' \
 	      -e 's|@''REPLACE_MBRLEN''@|$(REPLACE_MBRLEN)|g' \
@@ -1188,11 +1737,13 @@
 	      -e 's|@''REPLACE_WCWIDTH''@|$(REPLACE_WCWIDTH)|g' \
 	      -e 's|@''REPLACE_WCSWIDTH''@|$(REPLACE_WCSWIDTH)|g' \
 	      -e 's|@''REPLACE_WCSFTIME''@|$(REPLACE_WCSFTIME)|g' \
+	      -e 's|@''REPLACE_WCSTOK''@|$(REPLACE_WCSTOK)|g' \
+	      -e 's|@''REPLACE_WMEMPCPY''@|$(REPLACE_WMEMPCPY)|g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_ARG_NONNULL/r $(ARG_NONNULL_H)' \
-	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)'; \
-	} > $@-t && \
-	mv $@-t $@
+	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
+	      > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/wchar.h lib/wchar.h-t
 
 EXTRA_DIST += lib/wchar.in.h
@@ -1207,34 +1758,37 @@
 # We need the following in order to create <wctype.h> when the system
 # doesn't have one that works with the given compiler.
 lib/wctype.h: lib/wctype.in.h $(top_builddir)/config.status $(CXXDEFS_H) $(WARN_ON_USE_H)
-	$(AM_V_GEN)rm -f $@-t $@ && \
-	{ echo '/* DO NOT EDIT! GENERATED AUTOMATICALLY! */'; \
-	  sed -e 's|@''GUARD_PREFIX''@|GL|g' \
+	$(AM_V_GEN)$(MKDIR_P) '%reldir%'
+	$(gl_V_at)$(SED_HEADER_STDOUT) \
+	      -e 's|@''GUARD_PREFIX''@|GL|g' \
 	      -e 's/@''HAVE_WCTYPE_H''@/$(HAVE_WCTYPE_H)/g' \
 	      -e 's|@''INCLUDE_NEXT''@|$(INCLUDE_NEXT)|g' \
 	      -e 's|@''PRAGMA_SYSTEM_HEADER''@|@PRAGMA_SYSTEM_HEADER@|g' \
 	      -e 's|@''PRAGMA_COLUMNS''@|@PRAGMA_COLUMNS@|g' \
 	      -e 's|@''NEXT_WCTYPE_H''@|$(NEXT_WCTYPE_H)|g' \
 	      -e 's/@''HAVE_CRTDEFS_H''@/$(HAVE_CRTDEFS_H)/g' \
-	      -e 's/@''GNULIB_OVERRIDES_WINT_T''@/$(GNULIB_OVERRIDES_WINT_T)/g' \
-	      -e 's/@''GNULIB_ISWBLANK''@/$(GNULIB_ISWBLANK)/g' \
-	      -e 's/@''GNULIB_WCTYPE''@/$(GNULIB_WCTYPE)/g' \
-	      -e 's/@''GNULIB_ISWCTYPE''@/$(GNULIB_ISWCTYPE)/g' \
-	      -e 's/@''GNULIB_WCTRANS''@/$(GNULIB_WCTRANS)/g' \
-	      -e 's/@''GNULIB_TOWCTRANS''@/$(GNULIB_TOWCTRANS)/g' \
+	      -e 's/@''GNULIBHEADERS_OVERRIDE_WINT_T''@/$(GNULIBHEADERS_OVERRIDE_WINT_T)/g' \
+	      -e 's/@''GNULIB_ISWBLANK''@/$(GL_GNULIB_ISWBLANK)/g' \
+	      -e 's/@''GNULIB_ISWDIGIT''@/$(GL_GNULIB_ISWDIGIT)/g' \
+	      -e 's/@''GNULIB_ISWXDIGIT''@/$(GL_GNULIB_ISWXDIGIT)/g' \
+	      -e 's/@''GNULIB_WCTYPE''@/$(GL_GNULIB_WCTYPE)/g' \
+	      -e 's/@''GNULIB_ISWCTYPE''@/$(GL_GNULIB_ISWCTYPE)/g' \
+	      -e 's/@''GNULIB_WCTRANS''@/$(GL_GNULIB_WCTRANS)/g' \
+	      -e 's/@''GNULIB_TOWCTRANS''@/$(GL_GNULIB_TOWCTRANS)/g' \
 	      -e 's/@''HAVE_ISWBLANK''@/$(HAVE_ISWBLANK)/g' \
 	      -e 's/@''HAVE_ISWCNTRL''@/$(HAVE_ISWCNTRL)/g' \
 	      -e 's/@''HAVE_WCTYPE_T''@/$(HAVE_WCTYPE_T)/g' \
 	      -e 's/@''HAVE_WCTRANS_T''@/$(HAVE_WCTRANS_T)/g' \
 	      -e 's/@''HAVE_WINT_T''@/$(HAVE_WINT_T)/g' \
 	      -e 's/@''REPLACE_ISWBLANK''@/$(REPLACE_ISWBLANK)/g' \
+	      -e 's/@''REPLACE_ISWDIGIT''@/$(REPLACE_ISWDIGIT)/g' \
+	      -e 's/@''REPLACE_ISWXDIGIT''@/$(REPLACE_ISWXDIGIT)/g' \
 	      -e 's/@''REPLACE_ISWCNTRL''@/$(REPLACE_ISWCNTRL)/g' \
 	      -e 's/@''REPLACE_TOWLOWER''@/$(REPLACE_TOWLOWER)/g' \
 	      -e '/definitions of _GL_FUNCDECL_RPL/r $(CXXDEFS_H)' \
 	      -e '/definition of _GL_WARN_ON_USE/r $(WARN_ON_USE_H)' \
-	      < $(top_srcdir)/lib/wctype.in.h; \
-	} > $@-t && \
-	mv $@-t $@
+	      $(top_srcdir)/lib/wctype.in.h > $@-t
+	$(AM_V_at)mv $@-t $@
 MOSTLYCLEANFILES += lib/wctype.h lib/wctype.h-t
 
 EXTRA_DIST += lib/wctype.in.h
@@ -1243,10 +1797,9 @@
 
 ## begin gnulib module wcwidth
 
-
-EXTRA_DIST += lib/wcwidth.c
-
-EXTRA_lib_libgnu_a_SOURCES += lib/wcwidth.c
+if GL_COND_OBJ_WCWIDTH
+lib_libgnu_a_SOURCES += lib/wcwidth.c
+endif
 
 ## end   gnulib module wcwidth
 
@@ -1264,3 +1817,7 @@
 	  fi; \
 	done; \
 	:
+distclean-local: distclean-gnulib-libobjs
+distclean-gnulib-libobjs:
+	-rm -f @gl_LIBOBJDEPS@
+maintainer-clean-local: distclean-gnulib-libobjs

_service:tar_scm:groff-1.23.0.tar.gz/lib/inttypes.in.h Added

@@ -0,0 +1,1028 @@
+/* Copyright (C) 2006-2023 Free Software Foundation, Inc.
+   Written by Paul Eggert, Bruno Haible, Derek Price.
+   This file is part of gnulib.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+/*
+ * ISO C 99 <inttypes.h> for platforms that lack it.
+ * <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/inttypes.h.html>
+ */
+
+#if __GNUC__ >= 3
+@PRAGMA_SYSTEM_HEADER@
+#endif
+@PRAGMA_COLUMNS@
+
+/* Include the original <inttypes.h> if it exists, and if this file
+   has not been included yet or if this file includes gnulib stdint.h
+   which in turn includes this file.
+   The include_next requires a split double-inclusion guard.  */
+#if ! defined INTTYPES_H || defined _GL_JUST_INCLUDE_SYSTEM_INTTYPES_H
+# if @HAVE_INTTYPES_H@
+
+   /* Some pre-C++11 <stdint.h> implementations need this.  */
+#  if defined __cplusplus && ! defined __STDC_FORMAT_MACROS
+#   define __STDC_FORMAT_MACROS 1
+#  endif
+
+#  @INCLUDE_NEXT@ @NEXT_INTTYPES_H@
+
+#  define _GL_FINISHED_INCLUDING_SYSTEM_INTTYPES_H
+# endif
+#endif
+
+#if ! defined INTTYPES_H && ! defined _GL_JUST_INCLUDE_SYSTEM_INTTYPES_H
+#define INTTYPES_H
+
+/* Include <stdint.h> or the gnulib replacement.
+   But avoid namespace pollution on glibc systems.  */
+#ifndef __GLIBC__
+# include <stdint.h>
+#endif
+/* Get CHAR_BIT, INT_MAX, LONG_MAX, etc.  */
+#include <limits.h>
+/* On mingw, __USE_MINGW_ANSI_STDIO only works if <stdio.h> is also included */
+#if defined _WIN32 && ! defined __CYGWIN__
+# include <stdio.h>
+#endif
+
+#if !(INT_MAX == 0x7fffffff && INT_MIN + INT_MAX == -1)
+# error "This file assumes that 'int' is 32-bit two's complement. Please report your platform and compiler to <bug-gnulib@gnu.org>."
+#endif
+
+/* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
+
+/* The definition of _GL_ARG_NONNULL is copied here.  */
+
+/* The definition of _GL_WARN_ON_USE is copied here.  */
+
+/* 7.8.1 Macros for format specifiers */
+
+#if defined _TNS_R_TARGET
+   /* Tandem NonStop R series and compatible platforms released before
+      July 2005 support %Ld but not %lld.  */
+# define _LONG_LONG_FORMAT_PREFIX "L"
+#else
+# define _LONG_LONG_FORMAT_PREFIX "ll"
+#endif
+
+#if !defined PRId8
+# ifdef INT8_MAX
+#  define PRId8 "d"
+# endif
+#endif
+#if !defined PRIi8
+# ifdef INT8_MAX
+#  define PRIi8 "i"
+# endif
+#endif
+#if !defined PRIo8
+# ifdef UINT8_MAX
+#  define PRIo8 "o"
+# endif
+#endif
+#if !defined PRIu8
+# ifdef UINT8_MAX
+#  define PRIu8 "u"
+# endif
+#endif
+#if !defined PRIx8
+# ifdef UINT8_MAX
+#  define PRIx8 "x"
+# endif
+#endif
+#if !defined PRIX8
+# ifdef UINT8_MAX
+#  define PRIX8 "X"
+# endif
+#endif
+#if !defined PRId16
+# ifdef INT16_MAX
+#  define PRId16 "d"
+# endif
+#endif
+#if !defined PRIi16
+# ifdef INT16_MAX
+#  define PRIi16 "i"
+# endif
+#endif
+#if !defined PRIo16
+# ifdef UINT16_MAX
+#  define PRIo16 "o"
+# endif
+#endif
+#if !defined PRIu16
+# ifdef UINT16_MAX
+#  define PRIu16 "u"
+# endif
+#endif
+#if !defined PRIx16
+# ifdef UINT16_MAX
+#  define PRIx16 "x"
+# endif
+#endif
+#if !defined PRIX16
+# ifdef UINT16_MAX
+#  define PRIX16 "X"
+# endif
+#endif
+#if !defined PRId32
+# ifdef INT32_MAX
+#  define PRId32 "d"
+# endif
+#endif
+#if !defined PRIi32
+# ifdef INT32_MAX
+#  define PRIi32 "i"
+# endif
+#endif
+#if !defined PRIo32
+# ifdef UINT32_MAX
+#  define PRIo32 "o"
+# endif
+#endif
+#if !defined PRIu32
+# ifdef UINT32_MAX
+#  define PRIu32 "u"
+# endif
+#endif
+#if !defined PRIx32
+# ifdef UINT32_MAX
+#  define PRIx32 "x"
+# endif
+#endif
+#if !defined PRIX32
+# ifdef UINT32_MAX
+#  define PRIX32 "X"
+# endif
+#endif
+#ifdef INT64_MAX
+# if (@APPLE_UNIVERSAL_BUILD@ ? defined _LP64 : @INT64_MAX_EQ_LONG_MAX@)
+#  define _PRI64_PREFIX "l"
+# elif defined _MSC_VER || defined __MINGW32__
+#  define _PRI64_PREFIX "I64"
+# elif LONG_MAX >> 30 == 1
+#  define _PRI64_PREFIX _LONG_LONG_FORMAT_PREFIX
+# endif
+# if !defined PRId64
+#  define PRId64 _PRI64_PREFIX "d"
+# endif
+# if !defined PRIi64
+#  define PRIi64 _PRI64_PREFIX "i"
+# endif
+#endif
+#ifdef UINT64_MAX
+# if (@APPLE_UNIVERSAL_BUILD@ ? defined _LP64 : @UINT64_MAX_EQ_ULONG_MAX@)
+#  define _PRIu64_PREFIX "l"
+# elif defined _MSC_VER || defined __MINGW32__
+#  define _PRIu64_PREFIX "I64"
+# elif ULONG_MAX >> 31 == 1
+#  define _PRIu64_PREFIX _LONG_LONG_FORMAT_PREFIX
+# endif
+# if !defined PRIo64
+#  define PRIo64 _PRIu64_PREFIX "o"
+# endif
+# if !defined PRIu64
+#  define PRIu64 _PRIu64_PREFIX "u"
+# endif
+# if !defined PRIx64
+#  define PRIx64 _PRIu64_PREFIX "x"
+# endif
+# if !defined PRIX64
+#  define PRIX64 _PRIu64_PREFIX "X"
+# endif
+#endif
+
+#if !defined PRIdLEAST8
+# define PRIdLEAST8 "d"
+#endif
+#if !defined PRIiLEAST8
+# define PRIiLEAST8 "i"
+#endif
+#if !defined PRIoLEAST8
+# define PRIoLEAST8 "o"
+#endif
+#if !defined PRIuLEAST8
+# define PRIuLEAST8 "u"
+#endif
+#if !defined PRIxLEAST8
+# define PRIxLEAST8 "x"
+#endif
+#if !defined PRIXLEAST8
+# define PRIXLEAST8 "X"
+#endif
+#if !defined PRIdLEAST16
+# define PRIdLEAST16 "d"
+#endif
+#if !defined PRIiLEAST16
+# define PRIiLEAST16 "i"
+#endif
+#if !defined PRIoLEAST16
+# define PRIoLEAST16 "o"
+#endif
+#if !defined PRIuLEAST16
+# define PRIuLEAST16 "u"
+#endif
+#if !defined PRIxLEAST16
+# define PRIxLEAST16 "x"
+#endif
+#if !defined PRIXLEAST16
+# define PRIXLEAST16 "X"
+#endif
+#if !defined PRIdLEAST32
+# define PRIdLEAST32 "d"
+#endif
+#if !defined PRIiLEAST32
+# define PRIiLEAST32 "i"
+#endif
+#if !defined PRIoLEAST32
+# define PRIoLEAST32 "o"
+#endif
+#if !defined PRIuLEAST32
+# define PRIuLEAST32 "u"
+#endif
+#if !defined PRIxLEAST32
+# define PRIxLEAST32 "x"
+#endif
+#if !defined PRIXLEAST32
+# define PRIXLEAST32 "X"
+#endif
+#ifdef INT64_MAX
+# if !defined PRIdLEAST64
+#  define PRIdLEAST64 PRId64
+# endif
+# if !defined PRIiLEAST64
+#  define PRIiLEAST64 PRIi64
+# endif
+#endif
+#ifdef UINT64_MAX
+# if !defined PRIoLEAST64
+#  define PRIoLEAST64 PRIo64
+# endif
+# if !defined PRIuLEAST64
+#  define PRIuLEAST64 PRIu64
+# endif
+# if !defined PRIxLEAST64
+#  define PRIxLEAST64 PRIx64
+# endif
+# if !defined PRIXLEAST64
+#  define PRIXLEAST64 PRIX64
+# endif
+#endif
+
+#if !defined PRIdFAST8
+# if INT_FAST8_MAX > INT32_MAX
+#  define PRIdFAST8 PRId64
+# else
+#  define PRIdFAST8 "d"
+# endif
+#endif
+#if !defined PRIiFAST8
+# if INT_FAST8_MAX > INT32_MAX
+#  define PRIiFAST8 PRIi64
+# else
+#  define PRIiFAST8 "i"
+# endif
+#endif
+#if !defined PRIoFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define PRIoFAST8 PRIo64
+# else
+#  define PRIoFAST8 "o"
+# endif
+#endif
+#if !defined PRIuFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define PRIuFAST8 PRIu64
+# else
+#  define PRIuFAST8 "u"
+# endif
+#endif
+#if !defined PRIxFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define PRIxFAST8 PRIx64
+# else
+#  define PRIxFAST8 "x"
+# endif
+#endif
+#if !defined PRIXFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define PRIXFAST8 PRIX64
+# else
+#  define PRIXFAST8 "X"
+# endif
+#endif
+#if !defined PRIdFAST16
+# if INT_FAST16_MAX > INT32_MAX
+#  define PRIdFAST16 PRId64
+# else
+#  define PRIdFAST16 "d"
+# endif
+#endif
+#if !defined PRIiFAST16
+# if INT_FAST16_MAX > INT32_MAX
+#  define PRIiFAST16 PRIi64
+# else
+#  define PRIiFAST16 "i"
+# endif
+#endif
+#if !defined PRIoFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define PRIoFAST16 PRIo64
+# else
+#  define PRIoFAST16 "o"
+# endif
+#endif
+#if !defined PRIuFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define PRIuFAST16 PRIu64
+# else
+#  define PRIuFAST16 "u"
+# endif
+#endif
+#if !defined PRIxFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define PRIxFAST16 PRIx64
+# else
+#  define PRIxFAST16 "x"
+# endif
+#endif
+#if !defined PRIXFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define PRIXFAST16 PRIX64
+# else
+#  define PRIXFAST16 "X"
+# endif
+#endif
+#if !defined PRIdFAST32
+# if INT_FAST32_MAX > INT32_MAX
+#  define PRIdFAST32 PRId64
+# else
+#  define PRIdFAST32 "d"
+# endif
+#endif
+#if !defined PRIiFAST32
+# if INT_FAST32_MAX > INT32_MAX
+#  define PRIiFAST32 PRIi64
+# else
+#  define PRIiFAST32 "i"
+# endif
+#endif
+#if !defined PRIoFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define PRIoFAST32 PRIo64
+# else
+#  define PRIoFAST32 "o"
+# endif
+#endif
+#if !defined PRIuFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define PRIuFAST32 PRIu64
+# else
+#  define PRIuFAST32 "u"
+# endif
+#endif
+#if !defined PRIxFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define PRIxFAST32 PRIx64
+# else
+#  define PRIxFAST32 "x"
+# endif
+#endif
+#if !defined PRIXFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define PRIXFAST32 PRIX64
+# else
+#  define PRIXFAST32 "X"
+# endif
+#endif
+#ifdef INT64_MAX
+# if !defined PRIdFAST64
+#  define PRIdFAST64 PRId64
+# endif
+# if !defined PRIiFAST64
+#  define PRIiFAST64 PRIi64
+# endif
+#endif
+#ifdef UINT64_MAX
+# if !defined PRIoFAST64
+#  define PRIoFAST64 PRIo64
+# endif
+# if !defined PRIuFAST64
+#  define PRIuFAST64 PRIu64
+# endif
+# if !defined PRIxFAST64
+#  define PRIxFAST64 PRIx64
+# endif
+# if !defined PRIXFAST64
+#  define PRIXFAST64 PRIX64
+# endif
+#endif
+
+#if !defined PRIdMAX
+# if @INT32_MAX_LT_INTMAX_MAX@
+#  define PRIdMAX PRId64
+# else
+#  define PRIdMAX "ld"
+# endif
+#endif
+#if !defined PRIiMAX
+# if @INT32_MAX_LT_INTMAX_MAX@
+#  define PRIiMAX PRIi64
+# else
+#  define PRIiMAX "li"
+# endif
+#endif
+#if !defined PRIoMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define PRIoMAX PRIo64
+# else
+#  define PRIoMAX "lo"
+# endif
+#endif
+#if !defined PRIuMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define PRIuMAX PRIu64
+# else
+#  define PRIuMAX "lu"
+# endif
+#endif
+#if !defined PRIxMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define PRIxMAX PRIx64
+# else
+#  define PRIxMAX "lx"
+# endif
+#endif
+#if !defined PRIXMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define PRIXMAX PRIX64
+# else
+#  define PRIXMAX "lX"
+# endif
+#endif
+
+#if !defined PRIdPTR
+# ifdef INTPTR_MAX
+#  define PRIdPTR @PRIPTR_PREFIX@ "d"
+# endif
+#endif
+#if !defined PRIiPTR
+# ifdef INTPTR_MAX
+#  define PRIiPTR @PRIPTR_PREFIX@ "i"
+# endif
+#endif
+#if !defined PRIoPTR
+# ifdef UINTPTR_MAX
+#  define PRIoPTR @PRIPTR_PREFIX@ "o"
+# endif
+#endif
+#if !defined PRIuPTR
+# ifdef UINTPTR_MAX
+#  define PRIuPTR @PRIPTR_PREFIX@ "u"
+# endif
+#endif
+#if !defined PRIxPTR
+# ifdef UINTPTR_MAX
+#  define PRIxPTR @PRIPTR_PREFIX@ "x"
+# endif
+#endif
+#if !defined PRIXPTR
+# ifdef UINTPTR_MAX
+#  define PRIXPTR @PRIPTR_PREFIX@ "X"
+# endif
+#endif
+
+#if !defined SCNd8
+# ifdef INT8_MAX
+#  define SCNd8 "hhd"
+# endif
+#endif
+#if !defined SCNi8
+# ifdef INT8_MAX
+#  define SCNi8 "hhi"
+# endif
+#endif
+#if !defined SCNo8
+# ifdef UINT8_MAX
+#  define SCNo8 "hho"
+# endif
+#endif
+#if !defined SCNu8
+# ifdef UINT8_MAX
+#  define SCNu8 "hhu"
+# endif
+#endif
+#if !defined SCNx8
+# ifdef UINT8_MAX
+#  define SCNx8 "hhx"
+# endif
+#endif
+#if !defined SCNd16
+# ifdef INT16_MAX
+#  define SCNd16 "hd"
+# endif
+#endif
+#if !defined SCNi16
+# ifdef INT16_MAX
+#  define SCNi16 "hi"
+# endif
+#endif
+#if !defined SCNo16
+# ifdef UINT16_MAX
+#  define SCNo16 "ho"
+# endif
+#endif
+#if !defined SCNu16
+# ifdef UINT16_MAX
+#  define SCNu16 "hu"
+# endif
+#endif
+#if !defined SCNx16
+# ifdef UINT16_MAX
+#  define SCNx16 "hx"
+# endif
+#endif
+#if !defined SCNd32
+# ifdef INT32_MAX
+#  define SCNd32 "d"
+# endif
+#endif
+#if !defined SCNi32
+# ifdef INT32_MAX
+#  define SCNi32 "i"
+# endif
+#endif
+#if !defined SCNo32
+# ifdef UINT32_MAX
+#  define SCNo32 "o"
+# endif
+#endif
+#if !defined SCNu32
+# ifdef UINT32_MAX
+#  define SCNu32 "u"
+# endif
+#endif
+#if !defined SCNx32
+# ifdef UINT32_MAX
+#  define SCNx32 "x"
+# endif
+#endif
+#ifdef INT64_MAX
+# if (@APPLE_UNIVERSAL_BUILD@ ? defined _LP64 : @INT64_MAX_EQ_LONG_MAX@)
+#  define _SCN64_PREFIX "l"
+# elif defined _MSC_VER || defined __MINGW32__
+#  define _SCN64_PREFIX "I64"
+# elif LONG_MAX >> 30 == 1
+#  define _SCN64_PREFIX _LONG_LONG_FORMAT_PREFIX
+# endif
+# if !defined SCNd64
+#  define SCNd64 _SCN64_PREFIX "d"
+# endif
+# if !defined SCNi64
+#  define SCNi64 _SCN64_PREFIX "i"
+# endif
+#endif
+#ifdef UINT64_MAX
+# if (@APPLE_UNIVERSAL_BUILD@ ? defined _LP64 : @UINT64_MAX_EQ_ULONG_MAX@)
+#  define _SCNu64_PREFIX "l"
+# elif defined _MSC_VER || defined __MINGW32__
+#  define _SCNu64_PREFIX "I64"
+# elif ULONG_MAX >> 31 == 1
+#  define _SCNu64_PREFIX _LONG_LONG_FORMAT_PREFIX
+# endif
+# if !defined SCNo64
+#  define SCNo64 _SCNu64_PREFIX "o"
+# endif
+# if !defined SCNu64
+#  define SCNu64 _SCNu64_PREFIX "u"
+# endif
+# if !defined SCNx64
+#  define SCNx64 _SCNu64_PREFIX "x"
+# endif
+#endif
+
+#if !defined SCNdLEAST8
+# define SCNdLEAST8 "hhd"
+#endif
+#if !defined SCNiLEAST8
+# define SCNiLEAST8 "hhi"
+#endif
+#if !defined SCNoLEAST8
+# define SCNoLEAST8 "hho"
+#endif
+#if !defined SCNuLEAST8
+# define SCNuLEAST8 "hhu"
+#endif
+#if !defined SCNxLEAST8
+# define SCNxLEAST8 "hhx"
+#endif
+#if !defined SCNdLEAST16
+# define SCNdLEAST16 "hd"
+#endif
+#if !defined SCNiLEAST16
+# define SCNiLEAST16 "hi"
+#endif
+#if !defined SCNoLEAST16
+# define SCNoLEAST16 "ho"
+#endif
+#if !defined SCNuLEAST16
+# define SCNuLEAST16 "hu"
+#endif
+#if !defined SCNxLEAST16
+# define SCNxLEAST16 "hx"
+#endif
+#if !defined SCNdLEAST32
+# define SCNdLEAST32 "d"
+#endif
+#if !defined SCNiLEAST32
+# define SCNiLEAST32 "i"
+#endif
+#if !defined SCNoLEAST32
+# define SCNoLEAST32 "o"
+#endif
+#if !defined SCNuLEAST32
+# define SCNuLEAST32 "u"
+#endif
+#if !defined SCNxLEAST32
+# define SCNxLEAST32 "x"
+#endif
+#ifdef INT64_MAX
+# if !defined SCNdLEAST64
+#  define SCNdLEAST64 SCNd64
+# endif
+# if !defined SCNiLEAST64
+#  define SCNiLEAST64 SCNi64
+# endif
+#endif
+#ifdef UINT64_MAX
+# if !defined SCNoLEAST64
+#  define SCNoLEAST64 SCNo64
+# endif
+# if !defined SCNuLEAST64
+#  define SCNuLEAST64 SCNu64
+# endif
+# if !defined SCNxLEAST64
+#  define SCNxLEAST64 SCNx64
+# endif
+#endif
+
+#if !defined SCNdFAST8
+# if INT_FAST8_MAX > INT32_MAX
+#  define SCNdFAST8 SCNd64
+# elif INT_FAST8_MAX == 0x7fff
+#  define SCNdFAST8 "hd"
+# elif INT_FAST8_MAX == 0x7f
+#  define SCNdFAST8 "hhd"
+# else
+#  define SCNdFAST8 "d"
+# endif
+#endif
+#if !defined SCNiFAST8
+# if INT_FAST8_MAX > INT32_MAX
+#  define SCNiFAST8 SCNi64
+# elif INT_FAST8_MAX == 0x7fff
+#  define SCNiFAST8 "hi"
+# elif INT_FAST8_MAX == 0x7f
+#  define SCNiFAST8 "hhi"
+# else
+#  define SCNiFAST8 "i"
+# endif
+#endif
+#if !defined SCNoFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define SCNoFAST8 SCNo64
+# elif UINT_FAST8_MAX == 0xffff
+#  define SCNoFAST8 "ho"
+# elif UINT_FAST8_MAX == 0xff
+#  define SCNoFAST8 "hho"
+# else
+#  define SCNoFAST8 "o"
+# endif
+#endif
+#if !defined SCNuFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define SCNuFAST8 SCNu64
+# elif UINT_FAST8_MAX == 0xffff
+#  define SCNuFAST8 "hu"
+# elif UINT_FAST8_MAX == 0xff
+#  define SCNuFAST8 "hhu"
+# else
+#  define SCNuFAST8 "u"
+# endif
+#endif
+#if !defined SCNxFAST8
+# if UINT_FAST8_MAX > UINT32_MAX
+#  define SCNxFAST8 SCNx64
+# elif UINT_FAST8_MAX == 0xffff
+#  define SCNxFAST8 "hx"
+# elif UINT_FAST8_MAX == 0xff
+#  define SCNxFAST8 "hhx"
+# else
+#  define SCNxFAST8 "x"
+# endif
+#endif
+#if !defined SCNdFAST16
+# if INT_FAST16_MAX > INT32_MAX
+#  define SCNdFAST16 SCNd64
+# elif INT_FAST16_MAX == 0x7fff
+#  define SCNdFAST16 "hd"
+# else
+#  define SCNdFAST16 "d"
+# endif
+#endif
+#if !defined SCNiFAST16
+# if INT_FAST16_MAX > INT32_MAX
+#  define SCNiFAST16 SCNi64
+# elif INT_FAST16_MAX == 0x7fff
+#  define SCNiFAST16 "hi"
+# else
+#  define SCNiFAST16 "i"
+# endif
+#endif
+#if !defined SCNoFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define SCNoFAST16 SCNo64
+# elif UINT_FAST16_MAX == 0xffff
+#  define SCNoFAST16 "ho"
+# else
+#  define SCNoFAST16 "o"
+# endif
+#endif
+#if !defined SCNuFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define SCNuFAST16 SCNu64
+# elif UINT_FAST16_MAX == 0xffff
+#  define SCNuFAST16 "hu"
+# else
+#  define SCNuFAST16 "u"
+# endif
+#endif
+#if !defined SCNxFAST16
+# if UINT_FAST16_MAX > UINT32_MAX
+#  define SCNxFAST16 SCNx64
+# elif UINT_FAST16_MAX == 0xffff
+#  define SCNxFAST16 "hx"
+# else
+#  define SCNxFAST16 "x"
+# endif
+#endif
+#if !defined SCNdFAST32
+# if INT_FAST32_MAX > INT32_MAX
+#  define SCNdFAST32 SCNd64
+# else
+#  define SCNdFAST32 "d"
+# endif
+#endif
+#if !defined SCNiFAST32
+# if INT_FAST32_MAX > INT32_MAX
+#  define SCNiFAST32 SCNi64
+# else
+#  define SCNiFAST32 "i"
+# endif
+#endif
+#if !defined SCNoFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define SCNoFAST32 SCNo64
+# else
+#  define SCNoFAST32 "o"
+# endif
+#endif
+#if !defined SCNuFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define SCNuFAST32 SCNu64
+# else
+#  define SCNuFAST32 "u"
+# endif
+#endif
+#if !defined SCNxFAST32
+# if UINT_FAST32_MAX > UINT32_MAX
+#  define SCNxFAST32 SCNx64
+# else
+#  define SCNxFAST32 "x"
+# endif
+#endif
+#ifdef INT64_MAX
+# if !defined SCNdFAST64
+#  define SCNdFAST64 SCNd64
+# endif
+# if !defined SCNiFAST64
+#  define SCNiFAST64 SCNi64
+# endif
+#endif
+#ifdef UINT64_MAX
+# if !defined SCNoFAST64
+#  define SCNoFAST64 SCNo64
+# endif
+# if !defined SCNuFAST64
+#  define SCNuFAST64 SCNu64
+# endif
+# if !defined SCNxFAST64
+#  define SCNxFAST64 SCNx64
+# endif
+#endif
+
+#if !defined SCNdMAX
+# if @INT32_MAX_LT_INTMAX_MAX@
+#  define SCNdMAX SCNd64
+# else
+#  define SCNdMAX "ld"
+# endif
+#endif
+#if !defined SCNiMAX
+# if @INT32_MAX_LT_INTMAX_MAX@
+#  define SCNiMAX SCNi64
+# else
+#  define SCNiMAX "li"
+# endif
+#endif
+#if !defined SCNoMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define SCNoMAX SCNo64
+# else
+#  define SCNoMAX "lo"
+# endif
+#endif
+#if !defined SCNuMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define SCNuMAX SCNu64
+# else
+#  define SCNuMAX "lu"
+# endif
+#endif
+#if !defined SCNxMAX
+# if @UINT32_MAX_LT_UINTMAX_MAX@
+#  define SCNxMAX SCNx64
+# else
+#  define SCNxMAX "lx"
+# endif
+#endif
+
+#if !defined SCNdPTR
+# ifdef INTPTR_MAX
+#  define SCNdPTR @PRIPTR_PREFIX@ "d"
+# endif
+#endif
+#if !defined SCNiPTR
+# ifdef INTPTR_MAX
+#  define SCNiPTR @PRIPTR_PREFIX@ "i"
+# endif
+#endif
+#if !defined SCNoPTR
+# ifdef UINTPTR_MAX
+#  define SCNoPTR @PRIPTR_PREFIX@ "o"
+# endif
+#endif
+#if !defined SCNuPTR
+# ifdef UINTPTR_MAX
+#  define SCNuPTR @PRIPTR_PREFIX@ "u"
+# endif
+#endif
+#if !defined SCNxPTR
+# ifdef UINTPTR_MAX
+#  define SCNxPTR @PRIPTR_PREFIX@ "x"
+# endif
+#endif
+
+/* 7.8.2 Functions for greatest-width integer types */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if @GNULIB_IMAXABS@
+# if @REPLACE_IMAXABS@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef imaxabs
+#   define imaxabs rpl_imaxabs
+#  endif
+_GL_FUNCDECL_RPL (imaxabs, intmax_t, (intmax_t x));
+_GL_CXXALIAS_RPL (imaxabs, intmax_t, (intmax_t x));
+# else
+#  if !@HAVE_DECL_IMAXABS@
+_GL_FUNCDECL_SYS (imaxabs, intmax_t, (intmax_t x));
+#  endif
+_GL_CXXALIAS_SYS (imaxabs, intmax_t, (intmax_t x));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (imaxabs);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef imaxabs
+# if HAVE_RAW_DECL_IMAXABS
+_GL_WARN_ON_USE (imaxabs, "imaxabs is unportable - "
+                 "use gnulib module imaxabs for portability");
+# endif
+#endif
+
+#if @GNULIB_IMAXDIV@
+# if !@HAVE_IMAXDIV_T@
+#  if !GNULIB_defined_imaxdiv_t
+typedef struct { intmax_t quot; intmax_t rem; } imaxdiv_t;
+#   define GNULIB_defined_imaxdiv_t 1
+#  endif
+# endif
+# if @REPLACE_IMAXDIV@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef imaxdiv
+#   define imaxdiv rpl_imaxdiv
+#  endif
+_GL_FUNCDECL_RPL (imaxdiv, imaxdiv_t, (intmax_t numer, intmax_t denom));
+_GL_CXXALIAS_RPL (imaxdiv, imaxdiv_t, (intmax_t numer, intmax_t denom));
+# else
+#  if !@HAVE_DECL_IMAXDIV@
+_GL_FUNCDECL_SYS (imaxdiv, imaxdiv_t, (intmax_t numer, intmax_t denom));
+#  endif
+_GL_CXXALIAS_SYS (imaxdiv, imaxdiv_t, (intmax_t numer, intmax_t denom));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (imaxdiv);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef imaxdiv
+# if HAVE_RAW_DECL_IMAXDIV
+_GL_WARN_ON_USE (imaxdiv, "imaxdiv is unportable - "
+                 "use gnulib module imaxdiv for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOIMAX@
+# if @REPLACE_STRTOIMAX@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef strtoimax
+#   define strtoimax rpl_strtoimax
+#  endif
+_GL_FUNCDECL_RPL (strtoimax, intmax_t,
+                  (const char *restrict, char **restrict, int)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtoimax, intmax_t,
+                  (const char *restrict, char **restrict, int));
+# else
+#  if !@HAVE_DECL_STRTOIMAX@
+#   undef strtoimax
+_GL_FUNCDECL_SYS (strtoimax, intmax_t,
+                  (const char *restrict, char **restrict, int)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtoimax, intmax_t,
+                  (const char *restrict, char **restrict, int));
+# endif
+_GL_CXXALIASWARN (strtoimax);
+#elif defined GNULIB_POSIXCHECK
+# undef strtoimax
+# if HAVE_RAW_DECL_STRTOIMAX
+_GL_WARN_ON_USE (strtoimax, "strtoimax is unportable - "
+                 "use gnulib module strtoimax for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOUMAX@
+# if @REPLACE_STRTOUMAX@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef strtoumax
+#   define strtoumax rpl_strtoumax
+#  endif
+_GL_FUNCDECL_RPL (strtoumax, uintmax_t,
+                  (const char *restrict, char **restrict, int)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtoumax, uintmax_t,
+                  (const char *restrict, char **restrict, int));
+# else
+#  if !@HAVE_DECL_STRTOUMAX@
+#   undef strtoumax
+_GL_FUNCDECL_SYS (strtoumax, uintmax_t,
+                  (const char *restrict, char **restrict, int)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtoumax, uintmax_t,
+                  (const char *restrict, char **restrict, int));
+# endif
+_GL_CXXALIASWARN (strtoumax);
+#elif defined GNULIB_POSIXCHECK
+# undef strtoumax
+# if HAVE_RAW_DECL_STRTOUMAX
+_GL_WARN_ON_USE (strtoumax, "strtoumax is unportable - "
+                 "use gnulib module strtoumax for portability");
+# endif
+#endif
+
+/* Don't bother defining or declaring wcstoimax and wcstoumax, since
+   wide-character functions like this are hardly ever useful.  */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* !defined INTTYPES_H && !defined _GL_JUST_INCLUDE_SYSTEM_INTTYPES_H */

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnan.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnan.c Changed

@@ -1,17 +1,17 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible <bruno@clisp.org>, 2007.  */
@@ -82,9 +82,10 @@
 /* Most hosts nowadays use IEEE floating point, so they use IEC 60559
    representations, have infinities and NaNs, and do not trap on
    exceptions.  Define IEEE_FLOATING_POINT if this host is one of the
-   typical ones.  The C11 macro __STDC_IEC_559__ is close to what is
+   typical ones.  The C23 macro __STDC_IEC_60559_BFP__ macro (or its cousin,
+   the now-obsolescent C11 macro __STDC_IEC_559__) is close to what is
    wanted here, but is not quite right because this file does not require
-   all the features of C11 Annex F (and does not require C11 at all,
+   all the features of C23 Annex F (and works even with pre-C11 platforms,
    for that matter).  */
 
 #define IEEE_FLOATING_POINT (FLT_RADIX == 2 && FLT_MANT_DIG == 24 \

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnand-nolibm.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnand-nolibm.h Changed

@@ -1,24 +1,24 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if HAVE_ISNAND_IN_LIBC
 /* Get declaration of isnan macro.  */
 # include <math.h>
-# if __GNUC__ >= 4
-   /* GCC 4.0 and newer provides three built-ins for isnan.  */
+# if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+   /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.  */
 #  undef isnand
 #  define isnand(x) __builtin_isnan ((double)(x))
 # else

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnand.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnand.c Changed

@@ -1,17 +1,17 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2008-2018 Free Software Foundation, Inc.
+   Copyright (C) 2008-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible <bruno@clisp.org>, 2008.  */

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnanf-nolibm.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnanf-nolibm.h Changed

@@ -1,26 +1,27 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if HAVE_ISNANF_IN_LIBC
 /* Get declaration of isnan macro or (older) isnanf function.  */
 # include <math.h>
-# if __GNUC__ >= 4
-   /* GCC 4.0 and newer provides three built-ins for isnan.  */
+# if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+   /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.
+      GCC >= 4.0 also provides __builtin_isnanf, but clang doesn't.  */
 #  undef isnanf
-#  define isnanf(x) __builtin_isnanf ((float)(x))
+#  define isnanf(x) __builtin_isnan ((float)(x))
 # elif defined isnan
 #  undef isnanf
 #  define isnanf(x) isnan ((float)(x))

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnanf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnanf.c Changed

@@ -1,17 +1,17 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible <bruno@clisp.org>, 2007.  */

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnanl-nolibm.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnanl-nolibm.h Changed

@@ -1,26 +1,27 @@
 /* Test for NaN that does not need libm.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if HAVE_ISNANL_IN_LIBC
 /* Get declaration of isnan macro or (older) isnanl function.  */
 # include <math.h>
-# if __GNUC__ >= 4
-   /* GCC 4.0 and newer provides three built-ins for isnan.  */
+# if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+   /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.
+      GCC >= 4.0 also provides __builtin_isnanl, but clang doesn't.  */
 #  undef isnanl
-#  define isnanl(x) __builtin_isnanl ((long double)(x))
+#  define isnanl(x) __builtin_isnan ((long double)(x))
 # elif defined isnan
 #  undef isnanl
 #  define isnanl(x) isnan ((long double)(x))

_service:tar_scm:groff-1.22.4.tar.gz/lib/isnanl.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/isnanl.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/itold.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/itold.c Changed

@@ -1,18 +1,18 @@
 /* Replacement for 'int' to 'long double' conversion routine.
-   Copyright (C) 2011-2018 Free Software Foundation, Inc.
+   Copyright (C) 2011-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2011.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/limits.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/limits.in.h Changed

@@ -1,30 +1,46 @@
 /* A GNU-like <limits.h>.
 
-   Copyright 2016-2018 Free Software Foundation, Inc.
+   Copyright 2016-2023 Free Software Foundation, Inc.
 
-   This program 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, or
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
-
-#ifndef _@GUARD_PREFIX@_LIMITS_H
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if __GNUC__ >= 3
 @PRAGMA_SYSTEM_HEADER@
 #endif
 @PRAGMA_COLUMNS@
 
-/* The include_next requires a split double-inclusion guard.  */
+#if defined _GL_ALREADY_INCLUDING_LIMITS_H
+/* Special invocation convention:
+   On Haiku/x86_64, we have a sequence of nested includes
+   <limits.h> -> <syslimits.h> -> <limits.h>.
+   In this situation, LONG_MAX and INT_MAX are not yet defined,
+   therefore we should not attempt to define LONG_BIT.  */
+
 #@INCLUDE_NEXT@ @NEXT_LIMITS_H@
 
+#else
+/* Normal invocation convention.  */
+
+#ifndef _@GUARD_PREFIX@_LIMITS_H
+
+# define _GL_ALREADY_INCLUDING_LIMITS_H
+
+/* The include_next requires a split double-inclusion guard.  */
+# @INCLUDE_NEXT@ @NEXT_LIMITS_H@
+
+# undef _GL_ALREADY_INCLUDING_LIMITS_H
+
 #ifndef _@GUARD_PREFIX@_LIMITS_H
 #define _@GUARD_PREFIX@_LIMITS_H
 
@@ -83,10 +99,11 @@
 # endif
 #endif
 
-/* Macros specified by ISO/IEC TS 18661-1:2014.  */
+/* Macros specified by C23 and by ISO/IEC TS 18661-1:2014.  */
 
 #if (! defined ULLONG_WIDTH                                             \
-     && (defined _GNU_SOURCE || defined __STDC_WANT_IEC_60559_BFP_EXT__))
+     && (defined _GNU_SOURCE || defined __STDC_WANT_IEC_60559_BFP_EXT__ \
+         || (defined __STDC_VERSION__ && 201710 < __STDC_VERSION__)))
 # define CHAR_WIDTH _GL_INTEGER_WIDTH (CHAR_MIN, CHAR_MAX)
 # define SCHAR_WIDTH _GL_INTEGER_WIDTH (SCHAR_MIN, SCHAR_MAX)
 # define UCHAR_WIDTH _GL_INTEGER_WIDTH (0, UCHAR_MAX)
@@ -98,7 +115,17 @@
 # define ULONG_WIDTH _GL_INTEGER_WIDTH (0, ULONG_MAX)
 # define LLONG_WIDTH _GL_INTEGER_WIDTH (LLONG_MIN, LLONG_MAX)
 # define ULLONG_WIDTH _GL_INTEGER_WIDTH (0, ULLONG_MAX)
-#endif /* !ULLONG_WIDTH && (_GNU_SOURCE || __STDC_WANT_IEC_60559_BFP_EXT__) */
+#endif
+
+/* Macros specified by C23.  */
+
+#if (! defined BOOL_WIDTH \
+     && (defined _GNU_SOURCE \
+         || (defined __STDC_VERSION__ && 201710 < __STDC_VERSION__)))
+# define BOOL_MAX 1
+# define BOOL_WIDTH 1
+#endif
 
 #endif /* _@GUARD_PREFIX@_LIMITS_H */
 #endif /* _@GUARD_PREFIX@_LIMITS_H */
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/localcharset.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/localcharset.c Changed

@@ -1,19 +1,19 @@
 /* Determine a canonical name for the current locale's character encoding.
 
-   Copyright (C) 2000-2006, 2008-2018 Free Software Foundation, Inc.
+   Copyright (C) 2000-2006, 2008-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible <bruno@clisp.org>.  */
 
@@ -58,6 +58,9 @@
 #elif defined WINDOWS_NATIVE
 # define WIN32_LEAN_AND_MEAN
 # include <windows.h>
+  /* For the use of setlocale() below, the Gnulib override in setlocale.c is
+     not needed; see the platform lists in setlocale_null.m4.  */
+# undef setlocale
 #endif
 #if defined OS2
 # define INCL_DOS
@@ -150,7 +153,8 @@
     { "ISO8859-2",  "ISO-8859-2" },
     { "ISO8859-4",  "ISO-8859-4" },
     { "ISO8859-5",  "ISO-8859-5" },
-    { "ISO8859-7",  "ISO-8859-7" }
+    { "ISO8859-7",  "ISO-8859-7" },
+    { "US-ASCII",   "ASCII" }
 #   define alias_table_defined
 #  endif
 #  if defined __APPLE__ && defined __MACH__                 /* Mac OS X */
@@ -377,27 +381,164 @@
     /* The list of encodings is taken from "List of OS/2 Codepages"
        by Alex Taylor:
        <http://altsan.org/os2/toolkits/uls/index.html#codepages>.
-       See also "IBM Globalization - Code page identifiers":
-       <https://www-01.ibm.com/software/globalization/cp/cp_cpgid.html>.  */
-    { "CP1089", "ISO-8859-6" },
-    { "CP1208", "UTF-8" },
-    { "CP1381", "GB2312" },
-    { "CP1386", "GBK" },
-    { "CP3372", "EUC-JP" },
-    { "CP813",  "ISO-8859-7" },
-    { "CP819",  "ISO-8859-1" },
-    { "CP878",  "KOI8-R" },
-    { "CP912",  "ISO-8859-2" },
-    { "CP913",  "ISO-8859-3" },
-    { "CP914",  "ISO-8859-4" },
-    { "CP915",  "ISO-8859-5" },
-    { "CP916",  "ISO-8859-8" },
-    { "CP920",  "ISO-8859-9" },
-    { "CP921",  "ISO-8859-13" },
-    { "CP923",  "ISO-8859-15" },
-    { "CP954",  "EUC-JP" },
-    { "CP964",  "EUC-TW" },
-    { "CP970",  "EUC-KR" }
+       See also "__convcp() of kLIBC":
+       <https://github.com/bitwiseworks/libc/blob/master/src/emx/src/lib/locale/__convcp.c>.  */
+    { "CP1004",        "CP1252" },
+  /*{ "CP1041",        "CP943" },*/
+  /*{ "CP1088",        "CP949" },*/
+    { "CP1089",        "ISO-8859-6" },
+  /*{ "CP1114",        "CP950" },*/
+  /*{ "CP1115",        "GB2312" },*/
+    { "CP1208",        "UTF-8" },
+  /*{ "CP1380",        "GB2312" },*/
+    { "CP1381",        "GB2312" },
+    { "CP1383",        "GB2312" },
+    { "CP1386",        "GBK" },
+  /*{ "CP301",         "CP943" },*/
+    { "CP3372",        "EUC-JP" },
+    { "CP4946",        "CP850" },
+  /*{ "CP5048",        "JIS_X0208-1990" },*/
+  /*{ "CP5049",        "JIS_X0212-1990" },*/
+  /*{ "CP5067",        "KS_C_5601-1987" },*/
+    { "CP813",         "ISO-8859-7" },
+    { "CP819",         "ISO-8859-1" },
+    { "CP878",         "KOI8-R" },
+  /*{ "CP897",         "CP943" },*/
+    { "CP912",         "ISO-8859-2" },
+    { "CP913",         "ISO-8859-3" },
+    { "CP914",         "ISO-8859-4" },
+    { "CP915",         "ISO-8859-5" },
+    { "CP916",         "ISO-8859-8" },
+    { "CP920",         "ISO-8859-9" },
+    { "CP921",         "ISO-8859-13" },
+    { "CP923",         "ISO-8859-15" },
+  /*{ "CP941",         "CP943" },*/
+  /*{ "CP947",         "CP950" },*/
+  /*{ "CP951",         "CP949" },*/
+  /*{ "CP952",         "JIS_X0208-1990" },*/
+  /*{ "CP953",         "JIS_X0212-1990" },*/
+    { "CP954",         "EUC-JP" },
+    { "CP964",         "EUC-TW" },
+    { "CP970",         "EUC-KR" },
+  /*{ "CP971",         "KS_C_5601-1987" },*/
+    { "IBM-1004",      "CP1252" },
+  /*{ "IBM-1006",      "?" },*/
+  /*{ "IBM-1008",      "?" },*/
+  /*{ "IBM-1041",      "CP943" },*/
+  /*{ "IBM-1051",      "?" },*/
+  /*{ "IBM-1088",      "CP949" },*/
+    { "IBM-1089",      "ISO-8859-6" },
+  /*{ "IBM-1098",      "?" },*/
+  /*{ "IBM-1114",      "CP950" },*/
+  /*{ "IBM-1115",      "GB2312" },*/
+  /*{ "IBM-1116",      "?" },*/
+  /*{ "IBM-1117",      "?" },*/
+  /*{ "IBM-1118",      "?" },*/
+  /*{ "IBM-1119",      "?" },*/
+    { "IBM-1124",      "CP1124" },
+    { "IBM-1125",      "CP1125" },
+    { "IBM-1131",      "CP1131" },
+    { "IBM-1208",      "UTF-8" },
+    { "IBM-1250",      "CP1250" },
+    { "IBM-1251",      "CP1251" },
+    { "IBM-1252",      "CP1252" },
+    { "IBM-1253",      "CP1253" },
+    { "IBM-1254",      "CP1254" },
+    { "IBM-1255",      "CP1255" },
+    { "IBM-1256",      "CP1256" },
+    { "IBM-1257",      "CP1257" },
+  /*{ "IBM-1275",      "?" },*/
+  /*{ "IBM-1276",      "?" },*/
+  /*{ "IBM-1277",      "?" },*/
+  /*{ "IBM-1280",      "?" },*/
+  /*{ "IBM-1281",      "?" },*/
+  /*{ "IBM-1282",      "?" },*/
+  /*{ "IBM-1283",      "?" },*/
+  /*{ "IBM-1380",      "GB2312" },*/
+    { "IBM-1381",      "GB2312" },
+    { "IBM-1383",      "GB2312" },
+    { "IBM-1386",      "GBK" },
+  /*{ "IBM-301",       "CP943" },*/
+    { "IBM-3372",      "EUC-JP" },
+    { "IBM-367",       "ASCII" },
+    { "IBM-437",       "CP437" },
+    { "IBM-4946",      "CP850" },
+  /*{ "IBM-5048",      "JIS_X0208-1990" },*/
+  /*{ "IBM-5049",      "JIS_X0212-1990" },*/
+  /*{ "IBM-5067",      "KS_C_5601-1987" },*/
+    { "IBM-813",       "ISO-8859-7" },
+    { "IBM-819",       "ISO-8859-1" },
+    { "IBM-850",       "CP850" },
+  /*{ "IBM-851",       "?" },*/
+    { "IBM-852",       "CP852" },
+    { "IBM-855",       "CP855" },
+    { "IBM-856",       "CP856" },
+    { "IBM-857",       "CP857" },
+  /*{ "IBM-859",       "?" },*/
+    { "IBM-860",       "CP860" },
+    { "IBM-861",       "CP861" },
+    { "IBM-862",       "CP862" },
+    { "IBM-863",       "CP863" },
+    { "IBM-864",       "CP864" },
+    { "IBM-865",       "CP865" },
+    { "IBM-866",       "CP866" },
+  /*{ "IBM-868",       "?" },*/
+    { "IBM-869",       "CP869" },
+    { "IBM-874",       "CP874" },
+    { "IBM-878",       "KOI8-R" },
+  /*{ "IBM-895",       "?" },*/
+  /*{ "IBM-897",       "CP943" },*/
+  /*{ "IBM-907",       "?" },*/
+  /*{ "IBM-909",       "?" },*/
+    { "IBM-912",       "ISO-8859-2" },
+    { "IBM-913",       "ISO-8859-3" },
+    { "IBM-914",       "ISO-8859-4" },
+    { "IBM-915",       "ISO-8859-5" },
+    { "IBM-916",       "ISO-8859-8" },
+    { "IBM-920",       "ISO-8859-9" },
+    { "IBM-921",       "ISO-8859-13" },
+    { "IBM-922",       "CP922" },
+    { "IBM-923",       "ISO-8859-15" },
+    { "IBM-932",       "CP932" },
+  /*{ "IBM-941",       "CP943" },*/
+  /*{ "IBM-942",       "?" },*/
+    { "IBM-943",       "CP943" },
+  /*{ "IBM-947",       "CP950" },*/
+    { "IBM-949",       "CP949" },
+    { "IBM-950",       "CP950" },
+  /*{ "IBM-951",       "CP949" },*/
+  /*{ "IBM-952",       "JIS_X0208-1990" },*/
+  /*{ "IBM-953",       "JIS_X0212-1990" },*/
+    { "IBM-954",       "EUC-JP" },
+  /*{ "IBM-955",       "?" },*/
+    { "IBM-964",       "EUC-TW" },
+    { "IBM-970",       "EUC-KR" },
+  /*{ "IBM-971",       "KS_C_5601-1987" },*/
+    { "IBM-eucCN",     "GB2312" },
+    { "IBM-eucJP",     "EUC-JP" },
+    { "IBM-eucKR",     "EUC-KR" },
+    { "IBM-eucTW",     "EUC-TW" },
+    { "IBM33722",      "EUC-JP" },
+    { "ISO8859-1",     "ISO-8859-1" },
+    { "ISO8859-2",     "ISO-8859-2" },
+    { "ISO8859-3",     "ISO-8859-3" },
+    { "ISO8859-4",     "ISO-8859-4" },
+    { "ISO8859-5",     "ISO-8859-5" },
+    { "ISO8859-6",     "ISO-8859-6" },
+    { "ISO8859-7",     "ISO-8859-7" },
+    { "ISO8859-8",     "ISO-8859-8" },
+    { "ISO8859-9",     "ISO-8859-9" },
+  /*{ "JISX0201-1976", "JISX0201-1976" },*/
+  /*{ "JISX0208-1978", "?" },*/
+  /*{ "JISX0208-1983", "JIS_X0208-1983" },*/
+  /*{ "JISX0208-1990", "JIS_X0208-1990" },*/
+  /*{ "JISX0212-1990", "JIS_X0212-1990" },*/
+  /*{ "KSC5601-1987",  "KS_C_5601-1987" },*/
+    { "SJIS-1",        "CP943" },
+    { "SJIS-2",        "CP943" },
+    { "eucJP",         "EUC-JP" },
+    { "eucKR",         "EUC-KR" },
+    { "eucTW-1993",    "EUC-TW" }
 #   define alias_table_defined
 #  endif
 #  if defined VMS                                           /* OpenVMS */
@@ -675,8 +816,11 @@
 
 
 /* Determine the current locale's character encoding, and canonicalize it
-   into one of the canonical names listed in localcharset.h.
-   The result must not be freed; it is statically allocated.
+   into one of the canonical names listed below.
+   The result must not be freed; it is statically allocated.  The result
+   becomes invalid when setlocale() is used to change the global locale, or
+   when the value of one of the environment variables LC_ALL, LC_CTYPE, LANG
+   is changed; threads in multithreaded programs should not do this.
    If the canonical name cannot be determined, the result is a non-canonical
    name.  */
 
@@ -688,6 +832,13 @@
 {
   const char *codeset;
 
+  /* This function must be multithread-safe.  To achieve this without using
+     thread-local storage, we use a simple strcpy or memcpy to fill this static
+     buffer.  Filling it through, for example, strcpy + strcat would not be
+     guaranteed to leave the buffer's contents intact if another thread is
+     currently accessing it.  If necessary, the contents is first assembled in
+     a stack-allocated buffer.  */
+
 #if HAVE_LANGINFO_CODESET || defined WINDOWS_NATIVE || defined OS2
 
 # if HAVE_LANGINFO_CODESET
@@ -702,7 +853,7 @@
   if (codeset != NULL && strcmp (codeset, "US-ASCII") == 0)
     {
       const char *locale;
-      static char buf2 + 10 + 1;
+      static char resultbuf2 + 10 + 1;
 
       locale = getenv ("LC_ALL");
       if (locale == NULL || locale0 == '\0')
@@ -726,11 +877,12 @@
               modifier = strchr (dot, '@');
               if (modifier == NULL)
                 return dot;
-              if (modifier - dot < sizeof (buf))
+              if (modifier - dot < sizeof (resultbuf))
                 {
-                  memcpy (buf, dot, modifier - dot);
-                  buf modifier - dot = '\0';
-                  return buf;
+                  /* This way of filling resultbuf is multithread-safe.  */
+                  memcpy (resultbuf, dot, modifier - dot);
+                  resultbuf modifier - dot = '\0';
+                  return resultbuf;
                 }
             }
         }
@@ -746,8 +898,13 @@
          converting to GetConsoleOutputCP().  This leads to correct results,
          except when SetConsoleOutputCP has been called and a raster font is
          in use.  */
-      sprintf (buf, "CP%u", GetACP ());
-      codeset = buf;
+      {
+        char buf2 + 10 + 1;
+
+        sprintf (buf, "CP%u", GetACP ());
+        strcpy (resultbuf, buf);
+        codeset = resultbuf;
+      }
     }
 #  endif
 
@@ -757,42 +914,44 @@
 
 # elif defined WINDOWS_NATIVE
 
-  static char buf2 + 10 + 1;
+  char buf2 + 10 + 1;
+  static char resultbuf2 + 10 + 1;
 
   /* The Windows API has a function returning the locale's codepage as
      a number, but the value doesn't change according to what the
      'setlocale' call specified.  So we use it as a last resort, in
      case the string returned by 'setlocale' doesn't specify the
      codepage.  */
-  char *current_locale = setlocale (LC_ALL, NULL);
-  char *pdot;
+  char *current_locale = setlocale (LC_CTYPE, NULL);
+  char *pdot = strrchr (current_locale, '.');
 
-  /* If they set different locales for different categories,
-     'setlocale' will return a semi-colon separated list of locale
-     values.  To make sure we use the correct one, we choose LC_CTYPE.  */
-  if (strchr (current_locale, ';'))
-    current_locale = setlocale (LC_CTYPE, NULL);
-
-  pdot = strrchr (current_locale, '.');
   if (pdot && 2 + strlen (pdot + 1) + 1 <= sizeof (buf))
     sprintf (buf, "CP%s", pdot + 1);
   else
     {
       /* The Windows API has a function returning the locale's codepage as a
-        number: GetACP().
-        When the output goes to a console window, it needs to be provided in
-        GetOEMCP() encoding if the console is using a raster font, or in
-        GetConsoleOutputCP() encoding if it is using a TrueType font.
-        But in GUI programs and for output sent to files and pipes, GetACP()
-        encoding is the best bet.  */
+         number: GetACP().
+         When the output goes to a console window, it needs to be provided in
+         GetOEMCP() encoding if the console is using a raster font, or in
+         GetConsoleOutputCP() encoding if it is using a TrueType font.
+         But in GUI programs and for output sent to files and pipes, GetACP()
+         encoding is the best bet.  */
       sprintf (buf, "CP%u", GetACP ());
     }
-  codeset = buf;
+  /* For a locale name such as "French_France.65001", in Windows 10,
+     setlocale now returns "French_France.utf8" instead.  */
+  if (strcmp (buf + 2, "65001") == 0 || strcmp (buf + 2, "utf8") == 0)
+    codeset = "UTF-8";
+  else
+    {
+      strcpy (resultbuf, buf);
+      codeset = resultbuf;
+    }
 
 # elif defined OS2
 
   const char *locale;
-  static char buf2 + 10 + 1;
+  static char resultbuf2 + 10 + 1;
   ULONG cp3;
   ULONG cplen;
 
@@ -821,11 +980,12 @@
           modifier = strchr (dot, '@');
           if (modifier == NULL)
             return dot;
-          if (modifier - dot < sizeof (buf))
+          if (modifier - dot < sizeof (resultbuf))
             {
-              memcpy (buf, dot, modifier - dot);
-              buf modifier - dot = '\0';
-              return buf;
+              /* This way of filling resultbuf is multithread-safe.  */
+              memcpy (resultbuf, dot, modifier - dot);
+              resultbuf modifier - dot = '\0';
+              return resultbuf;
             }
         }
 
@@ -841,8 +1001,11 @@
         codeset = "";
       else
         {
+          char buf2 + 10 + 1;
+
           sprintf (buf, "CP%u", cp0);
-          codeset = buf;
+          strcpy (resultbuf, buf);
+          codeset = resultbuf;
         }
     }

_service:tar_scm:groff-1.22.4.tar.gz/lib/localcharset.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/localcharset.h Changed

@@ -1,19 +1,19 @@
 /* Determine a canonical name for the current locale's character encoding.
-   Copyright (C) 2000-2003, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2000-2003, 2009-2023 Free Software Foundation, Inc.
    This file is part of the GNU CHARSET Library.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _LOCALCHARSET_H
 #define _LOCALCHARSET_H
@@ -26,7 +26,10 @@
 
 /* Determine the current locale's character encoding, and canonicalize it
    into one of the canonical names listed below.
-   The result must not be freed; it is statically allocated.
+   The result must not be freed; it is statically allocated.  The result
+   becomes invalid when setlocale() is used to change the global locale, or
+   when the value of one of the environment variables LC_ALL, LC_CTYPE, LANG
+   is changed; threads in multithreaded programs should not do this.
    If the canonical name cannot be determined, the result is a non-canonical
    name.  */
 extern const char * locale_charset (void);
@@ -45,15 +48,15 @@
                                     (darwin = Mac OS X, windows = native Windows)
 
    ASCII, ANSI_X3.4-1968       glibc solaris freebsd netbsd darwin minix cygwin
-   ISO-8859-1              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin
-   ISO-8859-2              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin
+   ISO-8859-1              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
+   ISO-8859-2              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
    ISO-8859-3              Y   glibc solaris cygwin
    ISO-8859-4              Y   hpux osf solaris freebsd netbsd openbsd darwin
-   ISO-8859-5              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin
+   ISO-8859-5              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
    ISO-8859-6              Y   glibc aix hpux solaris cygwin
-   ISO-8859-7              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin
-   ISO-8859-8              Y   glibc aix hpux osf solaris cygwin
-   ISO-8859-9              Y   glibc aix hpux irix osf solaris freebsd darwin cygwin
+   ISO-8859-7              Y   glibc aix hpux irix osf solaris freebsd netbsd openbsd darwin cygwin zos
+   ISO-8859-8              Y   glibc aix hpux osf solaris cygwin zos
+   ISO-8859-9              Y   glibc aix hpux irix osf solaris freebsd darwin cygwin zos
    ISO-8859-13                 glibc hpux solaris freebsd netbsd openbsd darwin cygwin
    ISO-8859-14                 glibc cygwin
    ISO-8859-15                 glibc aix irix osf solaris freebsd netbsd openbsd darwin cygwin
@@ -76,7 +79,7 @@
    CP874                       windows dos
    CP922                       aix
    CP932                       aix cygwin windows dos
-   CP943                       aix
+   CP943                       aix zos
    CP949                       osf darwin windows dos
    CP950                       windows dos
    CP1046                      aix
@@ -92,17 +95,17 @@
    CP1255                      glibc windows
    CP1256                      windows
    CP1257                      windows
-   GB2312                  Y   glibc aix hpux irix solaris freebsd netbsd darwin cygwin
+   GB2312                  Y   glibc aix hpux irix solaris freebsd netbsd darwin cygwin zos
    EUC-JP                  Y   glibc aix hpux irix osf solaris freebsd netbsd darwin cygwin
-   EUC-KR                  Y   glibc aix hpux irix osf solaris freebsd netbsd darwin cygwin
+   EUC-KR                  Y   glibc aix hpux irix osf solaris freebsd netbsd darwin cygwin zos
    EUC-TW                      glibc aix hpux irix osf solaris netbsd
-   BIG5                    Y   glibc aix hpux osf solaris freebsd netbsd darwin cygwin
+   BIG5                    Y   glibc aix hpux osf solaris freebsd netbsd darwin cygwin zos
    BIG5-HKSCS                  glibc hpux solaris netbsd darwin
    GBK                         glibc aix osf solaris freebsd darwin cygwin windows dos
    GB18030                     glibc hpux solaris freebsd netbsd darwin
    SHIFT_JIS               Y   hpux osf solaris freebsd netbsd darwin
    JOHAB                       glibc solaris windows
-   TIS-620                     glibc aix hpux osf solaris cygwin
+   TIS-620                     glibc aix hpux osf solaris cygwin zos
    VISCII                  Y   glibc
    TCVN5712-1                  glibc
    ARMSCII-8                   glibc freebsd netbsd darwin
@@ -116,7 +119,7 @@
    HP-KANA8                    hpux
    DEC-KANJI                   osf
    DEC-HANYU                   osf
-   UTF-8                   Y   glibc aix hpux osf solaris netbsd darwin cygwin
+   UTF-8                   Y   glibc aix hpux osf solaris netbsd darwin cygwin zos
 
    Note: Names which are not marked as being a MIME name should not be used in
    Internet protocols for information interchange (mail, news, etc.).

_service:tar_scm:groff-1.22.4.tar.gz/lib/math.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/math.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/math.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/math.in.h Changed

@@ -1,20 +1,25 @@
 /* A GNU-like <math.h>.
 
-   Copyright (C) 2002-2003, 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2002-2003, 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
+/* On Android, in C++ mode, when /usr/include/c++/v1/math.h is being included
+   and /usr/include/math.h has not yet been included, skip this file, since it
+   would lead to many syntax errors.  */
+#if !(defined __ANDROID__ && defined _LIBCPP_MATH_H && !defined INFINITY)
+
 #ifndef _@GUARD_PREFIX@_MATH_H
 
 #if __GNUC__ >= 3
@@ -22,8 +27,23 @@
 #endif
 @PRAGMA_COLUMNS@
 
+#if defined _GL_INCLUDING_MATH_H
+/* Special invocation convention:
+   - On FreeBSD 12.2 we have a sequence of nested includes
+     <math.h> -> <stdlib.h> -> <sys/wait.h> -> <sys/types.h> -> <sys/select.h>
+       -> <signal.h> -> <pthread.h> -> <stdlib.h> -> <math.h>
+     In this situation, the functions are not yet declared, therefore we cannot
+     provide the C++ aliases.  */
+
+#@INCLUDE_NEXT_AS_FIRST_DIRECTIVE@ @NEXT_AS_FIRST_DIRECTIVE_MATH_H@
+
+#else
+/* Normal invocation convention.  */
+
 /* The include_next requires a split double-inclusion guard.  */
+#define _GL_INCLUDING_MATH_H
 #@INCLUDE_NEXT_AS_FIRST_DIRECTIVE@ @NEXT_AS_FIRST_DIRECTIVE_MATH_H@
+#undef _GL_INCLUDING_MATH_H
 
 #ifndef _@GUARD_PREFIX@_MATH_H
 #define _@GUARD_PREFIX@_MATH_H
@@ -41,6 +61,16 @@
 # define _GL_MATH_INLINE _GL_INLINE
 #endif
 
+/* The __attribute__ feature is available in gcc versions 2.5 and later.
+   The attribute __const__ was added in gcc 2.95.  */
+#ifndef _GL_ATTRIBUTE_CONST
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95) || defined __clang__
+#  define _GL_ATTRIBUTE_CONST __attribute__ ((__const__))
+# else
+#  define _GL_ATTRIBUTE_CONST /* empty */
+# endif
+#endif
+
 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
 
 /* The definition of _GL_ARG_NONNULL is copied here.  */
@@ -67,20 +97,20 @@
 {                                                                   \
   return func (l);                                                  \
 }
-# define _GL_MATH_CXX_REAL_FLOATING_DECL_2(func) \
+# define _GL_MATH_CXX_REAL_FLOATING_DECL_2(func,rpl_func,rettype) \
 _GL_BEGIN_NAMESPACE                                                 \
-inline int                                                          \
-func (float f)                                                      \
+inline rettype                                                      \
+rpl_func (float f)                                                  \
 {                                                                   \
   return _gl_cxx_ ## func ## f (f);                                 \
 }                                                                   \
-inline int                                                          \
-func (double d)                                                     \
+inline rettype                                                      \
+rpl_func (double d)                                                 \
 {                                                                   \
   return _gl_cxx_ ## func ## d (d);                                 \
 }                                                                   \
-inline int                                                          \
-func (long double l)                                                \
+inline rettype                                                      \
+rpl_func (long double l)                                            \
 {                                                                   \
   return _gl_cxx_ ## func ## l (l);                                 \
 }                                                                   \
@@ -255,7 +285,9 @@
 _GL_FUNCDECL_SYS (acosl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (acosl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (acosl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef acosl
 # if HAVE_RAW_DECL_ACOSL
@@ -295,7 +327,9 @@
 _GL_FUNCDECL_SYS (asinl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (asinl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (asinl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef asinl
 # if HAVE_RAW_DECL_ASINL
@@ -335,7 +369,9 @@
 _GL_FUNCDECL_SYS (atanl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (atanl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (atanl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef atanl
 # if HAVE_RAW_DECL_ATANL
@@ -398,7 +434,9 @@
 _GL_FUNCDECL_SYS (cbrt, double, (double x));
 # endif
 _GL_CXXALIAS_SYS (cbrt, double, (double x));
-_GL_CXXALIASWARN (cbrt);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (cbrt, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef cbrt
 # if HAVE_RAW_DECL_CBRT
@@ -421,7 +459,9 @@
 #  endif
 _GL_CXXALIAS_SYS (cbrtl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (cbrtl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef cbrtl
 # if HAVE_RAW_DECL_CBRTL
@@ -466,7 +506,9 @@
 # else
 _GL_CXXALIAS_SYS (ceil, double, (double x));
 # endif
-_GL_CXXALIASWARN (ceil);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (ceil, double, (double x));
+# endif
 #endif
 
 #if @GNULIB_CEILL@
@@ -484,7 +526,9 @@
 #  endif
 _GL_CXXALIAS_SYS (ceill, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (ceill);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef ceill
 # if HAVE_RAW_DECL_CEILL
@@ -496,6 +540,7 @@
 
 #if @GNULIB_COPYSIGNF@
 # if !@HAVE_DECL_COPYSIGNF@
+#  undef copysignf
 _GL_FUNCDECL_SYS (copysignf, float, (float x, float y));
 # endif
 _GL_CXXALIAS_SYS (copysignf, float, (float x, float y));
@@ -513,7 +558,9 @@
 _GL_FUNCDECL_SYS (copysign, double, (double x, double y));
 # endif
 _GL_CXXALIAS_SYS (copysign, double, (double x, double y));
-_GL_CXXALIASWARN (copysign);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (copysign, double, (double x, double y));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef copysign
 # if HAVE_RAW_DECL_COPYSIGN
@@ -527,7 +574,9 @@
 _GL_FUNCDECL_SYS (copysignl, long double, (long double x, long double y));
 # endif
 _GL_CXXALIAS_SYS (copysignl, long double, (long double x, long double y));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (copysignl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef copysignl
 # if HAVE_RAW_DECL_COPYSIGNL
@@ -567,7 +616,9 @@
 _GL_FUNCDECL_SYS (cosl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (cosl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (cosl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef cosl
 # if HAVE_RAW_DECL_COSL
@@ -627,12 +678,23 @@
 #endif
 
 #if @GNULIB_EXPL@
-# if !@HAVE_EXPL@ || !@HAVE_DECL_EXPL@
-#  undef expl
+# if @REPLACE_EXPL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef expl
+#   define expl rpl_expl
+#  endif
+_GL_FUNCDECL_RPL (expl, long double, (long double x));
+_GL_CXXALIAS_RPL (expl, long double, (long double x));
+# else
+#  if !@HAVE_EXPL@ || !@HAVE_DECL_EXPL@
+#   undef expl
 _GL_FUNCDECL_SYS (expl, long double, (long double x));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (expl, long double, (long double x));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (expl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef expl
 # if HAVE_RAW_DECL_EXPL
@@ -670,7 +732,9 @@
 #  endif
 _GL_CXXALIAS_SYS (exp2, double, (double x));
 # endif
-_GL_CXXALIASWARN (exp2);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (exp2, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef exp2
 # if HAVE_RAW_DECL_EXP2
@@ -694,7 +758,9 @@
 #  endif
 _GL_CXXALIAS_SYS (exp2l, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (exp2l);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef exp2l
 # if HAVE_RAW_DECL_EXP2L
@@ -741,7 +807,9 @@
 #  endif
 _GL_CXXALIAS_SYS (expm1, double, (double x));
 # endif
-_GL_CXXALIASWARN (expm1);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (expm1, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef expm1
 # if HAVE_RAW_DECL_EXPM1
@@ -751,12 +819,25 @@
 #endif
 
 #if @GNULIB_EXPM1L@
-# if !@HAVE_DECL_EXPM1L@
-#  undef expm1l
+# if @REPLACE_EXPM1L@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef expm1l
+#   define expm1l rpl_expm1l
+#  endif
+_GL_FUNCDECL_RPL (expm1l, long double, (long double x));
+_GL_CXXALIAS_RPL (expm1l, long double, (long double x));
+# else
+#  if !@HAVE_DECL_EXPM1L@
+#   undef expm1l
+#   if !(defined __cplusplus && defined _AIX)
 _GL_FUNCDECL_SYS (expm1l, long double, (long double x));
-# endif
+#   endif
+#  endif
 _GL_CXXALIAS_SYS (expm1l, long double, (long double x));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (expm1l);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef expm1l
 # if HAVE_RAW_DECL_EXPM1L
@@ -772,7 +853,9 @@
 _GL_FUNCDECL_SYS (fabsf, float, (float x));
 # endif
 _GL_CXXALIAS_SYS (fabsf, float, (float x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fabsf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fabsf
 # if HAVE_RAW_DECL_FABSF
@@ -796,7 +879,9 @@
 #  endif
 _GL_CXXALIAS_SYS (fabsl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fabsl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fabsl
 # if HAVE_RAW_DECL_FABSL
@@ -841,7 +926,9 @@
 # else
 _GL_CXXALIAS_SYS (floor, double, (double x));
 # endif
-_GL_CXXALIASWARN (floor);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (floor, double, (double x));
+# endif
 #endif
 
 #if @GNULIB_FLOORL@
@@ -859,7 +946,9 @@
 #  endif
 _GL_CXXALIAS_SYS (floorl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (floorl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef floorl
 # if HAVE_RAW_DECL_FLOORL
@@ -879,6 +968,7 @@
 _GL_CXXALIAS_RPL (fmaf, float, (float x, float y, float z));
 # else
 #  if !@HAVE_FMAF@
+#   undef fmaf
 _GL_FUNCDECL_SYS (fmaf, float, (float x, float y, float z));
 #  endif
 _GL_CXXALIAS_SYS (fmaf, float, (float x, float y, float z));
@@ -902,11 +992,14 @@
 _GL_CXXALIAS_RPL (fma, double, (double x, double y, double z));
 # else
 #  if !@HAVE_FMA@
+#   undef fma
 _GL_FUNCDECL_SYS (fma, double, (double x, double y, double z));
 #  endif
 _GL_CXXALIAS_SYS (fma, double, (double x, double y, double z));
 # endif
-_GL_CXXALIASWARN (fma);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (fma, double, (double x, double y, double z));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fma
 # if HAVE_RAW_DECL_FMA
@@ -928,13 +1021,17 @@
 # else
 #  if !@HAVE_FMAL@
 #   undef fmal
+#   if !(defined __cplusplus && defined _AIX)
 _GL_FUNCDECL_SYS (fmal, long double,
                   (long double x, long double y, long double z));
+#   endif
 #  endif
 _GL_CXXALIAS_SYS (fmal, long double,
                   (long double x, long double y, long double z));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fmal);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fmal
 # if HAVE_RAW_DECL_FMAL
@@ -979,7 +1076,9 @@
 # else
 _GL_CXXALIAS_SYS (fmod, double, (double x, double y));
 # endif
-_GL_CXXALIASWARN (fmod);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (fmod, double, (double x, double y));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fmod
 # if HAVE_RAW_DECL_FMOD
@@ -1003,7 +1102,9 @@
 #  endif
 _GL_CXXALIAS_SYS (fmodl, long double, (long double x, long double y));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fmodl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fmodl
 # if HAVE_RAW_DECL_FMODL
@@ -1035,7 +1136,9 @@
 #  endif
 _GL_CXXALIAS_SYS (frexpf, float, (float x, int *expptr));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (frexpf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef frexpf
 # if HAVE_RAW_DECL_FREXPF
@@ -1062,7 +1165,9 @@
 # else
 _GL_CXXALIAS_SYS (frexp, double, (double x, int *expptr));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN1 (frexp, double, (double x, int *expptr));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef frexp
 /* Assume frexp is always declared.  */
@@ -1095,7 +1200,9 @@
 # endif
 #endif
 #if @GNULIB_FREXPL@ && !(@REPLACE_FREXPL@ && !@HAVE_DECL_FREXPL@)
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (frexpl);
+# endif
 #endif
 #if !@GNULIB_FREXPL@ && defined GNULIB_POSIXCHECK
 # undef frexpl
@@ -1121,7 +1228,9 @@
 #  endif
 _GL_CXXALIAS_SYS (hypotf, float, (float x, float y));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (hypotf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef hypotf
 # if HAVE_RAW_DECL_HYPOTF
@@ -1142,7 +1251,9 @@
 # else
 _GL_CXXALIAS_SYS (hypot, double, (double x, double y));
 # endif
-_GL_CXXALIASWARN (hypot);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (hypot, double, (double x, double y));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef hypot
 # if HAVE_RAW_DECL_HYPOT
@@ -1166,7 +1277,9 @@
 #  endif
 _GL_CXXALIAS_SYS (hypotl, long double, (long double x, long double y));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (hypotl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef hypotl
 # if HAVE_RAW_DECL_HYPOTL
@@ -1213,7 +1326,9 @@
 #  endif
 _GL_CXXALIAS_SYS (ilogb, int, (double x));
 # endif
-_GL_CXXALIASWARN (ilogb);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (ilogb, int, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef ilogb
 # if HAVE_RAW_DECL_ILOGB
@@ -1232,11 +1347,14 @@
 _GL_CXXALIAS_RPL (ilogbl, int, (long double x));
 # else
 #  if !@HAVE_ILOGBL@
+#   undef ilogbl
 _GL_FUNCDECL_SYS (ilogbl, int, (long double x));
 #  endif
 _GL_CXXALIAS_SYS (ilogbl, int, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (ilogbl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef ilogbl
 # if HAVE_RAW_DECL_ILOGBL
@@ -1246,6 +1364,55 @@
 #endif
 
 
+#if @GNULIB_MDA_J0@
+/* On native Windows, map 'j0' to '_j0', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::j0 always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef j0
+#   define j0 _j0
+#  endif
+_GL_CXXALIAS_MDA (j0, double, (double x));
+# else
+_GL_CXXALIAS_SYS (j0, double, (double x));
+# endif
+_GL_CXXALIASWARN (j0);
+#endif
+
+#if @GNULIB_MDA_J1@
+/* On native Windows, map 'j1' to '_j1', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::j1 always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef j1
+#   define j1 _j1
+#  endif
+_GL_CXXALIAS_MDA (j1, double, (double x));
+# else
+_GL_CXXALIAS_SYS (j1, double, (double x));
+# endif
+_GL_CXXALIASWARN (j1);
+#endif
+
+#if @GNULIB_MDA_JN@
+/* On native Windows, map 'jn' to '_jn', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::jn always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef jn
+#   define jn _jn
+#  endif
+_GL_CXXALIAS_MDA (jn, double, (int n, double x));
+# else
+_GL_CXXALIAS_SYS (jn, double, (int n, double x));
+# endif
+_GL_CXXALIASWARN (jn);
+#endif
+
+
 /* Return x * 2^exp.  */
 #if @GNULIB_LDEXPF@
 # if !@HAVE_LDEXPF@
@@ -1253,7 +1420,9 @@
 _GL_FUNCDECL_SYS (ldexpf, float, (float x, int exp));
 # endif
 _GL_CXXALIAS_SYS (ldexpf, float, (float x, int exp));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (ldexpf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef ldexpf
 # if HAVE_RAW_DECL_LDEXPF
@@ -1279,7 +1448,9 @@
 # endif
 #endif
 #if @GNULIB_LDEXPL@
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (ldexpl);
+# endif
 #endif
 #if !@GNULIB_LDEXPL@ && defined GNULIB_POSIXCHECK
 # undef ldexpl
@@ -1325,7 +1496,9 @@
 # else
 _GL_CXXALIAS_SYS (log, double, (double x));
 # endif
-_GL_CXXALIASWARN (log);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (log, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log
 # if HAVE_RAW_DECL_LOG
@@ -1349,7 +1522,9 @@
 #  endif
 _GL_CXXALIAS_SYS (logl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (logl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef logl
 # if HAVE_RAW_DECL_LOGL
@@ -1394,7 +1569,9 @@
 # else
 _GL_CXXALIAS_SYS (log10, double, (double x));
 # endif
-_GL_CXXALIASWARN (log10);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (log10, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log10
 # if HAVE_RAW_DECL_LOG10
@@ -1418,7 +1595,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log10l, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (log10l);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log10l
 # if HAVE_RAW_DECL_LOG10L
@@ -1465,7 +1644,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log1p, double, (double x));
 # endif
-_GL_CXXALIASWARN (log1p);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (log1p, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log1p
 # if HAVE_RAW_DECL_LOG1P
@@ -1488,7 +1669,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log1pl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (log1pl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log1pl
 # if HAVE_RAW_DECL_LOG1PL
@@ -1513,7 +1696,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log2f, float, (float x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (log2f);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log2f
 # if HAVE_RAW_DECL_LOG2F
@@ -1537,7 +1722,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log2, double, (double x));
 # endif
-_GL_CXXALIASWARN (log2);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (log2, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log2
 # if HAVE_RAW_DECL_LOG2
@@ -1560,7 +1747,9 @@
 #  endif
 _GL_CXXALIAS_SYS (log2l, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (log2l);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef log2l
 # if HAVE_RAW_DECL_LOG2L
@@ -1607,7 +1796,9 @@
 #  endif
 _GL_CXXALIAS_SYS (logb, double, (double x));
 # endif
-_GL_CXXALIASWARN (logb);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (logb, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef logb
 # if HAVE_RAW_DECL_LOGB
@@ -1630,7 +1821,9 @@
 #  endif
 _GL_CXXALIAS_SYS (logbl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (logbl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef logbl
 # if HAVE_RAW_DECL_LOGBL
@@ -1675,7 +1868,9 @@
 # else
 _GL_CXXALIAS_SYS (modf, double, (double x, double *iptr));
 # endif
-_GL_CXXALIASWARN (modf);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (modf, double, (double x, double *iptr));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef modf
 # if HAVE_RAW_DECL_MODF
@@ -1701,7 +1896,9 @@
 #  endif
 _GL_CXXALIAS_SYS (modfl, long double, (long double x, long double *iptr));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (modfl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef modfl
 # if HAVE_RAW_DECL_MODFL
@@ -1764,7 +1961,9 @@
 #  endif
 _GL_CXXALIAS_SYS (remainder, double, (double x, double y));
 # endif
-_GL_CXXALIASWARN (remainder);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (remainder, double, (double x, double y));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef remainder
 # if HAVE_RAW_DECL_REMAINDER
@@ -1784,11 +1983,15 @@
 # else
 #  if !@HAVE_DECL_REMAINDERL@
 #   undef remainderl
+#   if !(defined __cplusplus && defined _AIX)
 _GL_FUNCDECL_SYS (remainderl, long double, (long double x, long double y));
+#   endif
 #  endif
 _GL_CXXALIAS_SYS (remainderl, long double, (long double x, long double y));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (remainderl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef remainderl
 # if HAVE_RAW_DECL_REMAINDERL
@@ -1817,7 +2020,9 @@
 _GL_FUNCDECL_SYS (rint, double, (double x));
 # endif
 _GL_CXXALIAS_SYS (rint, double, (double x));
-_GL_CXXALIASWARN (rint);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (rint, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef rint
 # if HAVE_RAW_DECL_RINT
@@ -1827,11 +2032,22 @@
 #endif
 
 #if @GNULIB_RINTL@
-# if !@HAVE_RINTL@
+# if @REPLACE_RINTL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef rintl
+#   define rintl rpl_rintl
+#  endif
+_GL_FUNCDECL_RPL (rintl, long double, (long double x));
+_GL_CXXALIAS_RPL (rintl, long double, (long double x));
+# else
+#  if !@HAVE_RINTL@
 _GL_FUNCDECL_SYS (rintl, long double, (long double x));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (rintl, long double, (long double x));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (rintl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef rintl
 # if HAVE_RAW_DECL_RINTL
@@ -1878,7 +2094,9 @@
 #  endif
 _GL_CXXALIAS_SYS (round, double, (double x));
 # endif
-_GL_CXXALIASWARN (round);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (round, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef round
 # if HAVE_RAW_DECL_ROUND
@@ -1898,11 +2116,15 @@
 # else
 #  if !@HAVE_DECL_ROUNDL@
 #   undef roundl
+#   if !(defined __cplusplus && defined _AIX)
 _GL_FUNCDECL_SYS (roundl, long double, (long double x));
+#   endif
 #  endif
 _GL_CXXALIAS_SYS (roundl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (roundl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef roundl
 # if HAVE_RAW_DECL_ROUNDL
@@ -1922,7 +2144,7 @@
 _GL_CXXALIAS_RPL (sinf, float, (float x));
 # else
 #  if !@HAVE_SINF@
- #  undef sinf
+#   undef sinf
 _GL_FUNCDECL_SYS (sinf, float, (float x));
 #  endif
 _GL_CXXALIAS_SYS (sinf, float, (float x));
@@ -1942,7 +2164,9 @@
 _GL_FUNCDECL_SYS (sinl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (sinl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (sinl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef sinl
 # if HAVE_RAW_DECL_SINL
@@ -2016,7 +2240,9 @@
 #  endif
 _GL_CXXALIAS_SYS (sqrtl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (sqrtl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef sqrtl
 # if HAVE_RAW_DECL_SQRTL
@@ -2056,7 +2282,9 @@
 _GL_FUNCDECL_SYS (tanl, long double, (long double x));
 # endif
 _GL_CXXALIAS_SYS (tanl, long double, (long double x));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (tanl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef tanl
 # if HAVE_RAW_DECL_TANL
@@ -2128,7 +2356,9 @@
 #  endif
 _GL_CXXALIAS_SYS (trunc, double, (double x));
 # endif
-_GL_CXXALIASWARN (trunc);
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN1 (trunc, double, (double x));
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef trunc
 # if HAVE_RAW_DECL_TRUNC
@@ -2151,7 +2381,9 @@
 #  endif
 _GL_CXXALIAS_SYS (truncl, long double, (long double x));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (truncl);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef truncl
 # if HAVE_RAW_DECL_TRUNCL
@@ -2161,6 +2393,55 @@
 #endif
 
 
+#if @GNULIB_MDA_Y0@
+/* On native Windows, map 'y0' to '_y0', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::y0 always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef y0
+#   define y0 _y0
+#  endif
+_GL_CXXALIAS_MDA (y0, double, (double x));
+# else
+_GL_CXXALIAS_SYS (y0, double, (double x));
+# endif
+_GL_CXXALIASWARN (y0);
+#endif
+
+#if @GNULIB_MDA_Y1@
+/* On native Windows, map 'y1' to '_y1', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::y1 always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef y1
+#   define y1 _y1
+#  endif
+_GL_CXXALIAS_MDA (y1, double, (double x));
+# else
+_GL_CXXALIAS_SYS (y1, double, (double x));
+# endif
+_GL_CXXALIASWARN (y1);
+#endif
+
+#if @GNULIB_MDA_YN@
+/* On native Windows, map 'yn' to '_yn', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::yn always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef yn
+#   define yn _yn
+#  endif
+_GL_CXXALIAS_MDA (yn, double, (int n, double x));
+# else
+_GL_CXXALIAS_SYS (yn, double, (int n, double x));
+# endif
+_GL_CXXALIASWARN (yn);
+#endif
+
+
 /* Definitions of function-like macros come here, after the function
    declarations.  */
 
@@ -2180,7 +2461,15 @@
 #  if defined isfinite || defined GNULIB_NAMESPACE
 _GL_MATH_CXX_REAL_FLOATING_DECL_1 (isfinite)
 #   undef isfinite
-_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isfinite)
+#   if __GNUC__ >= 6 || (defined __clang__ && !((defined __APPLE__ && defined __MACH__) || defined __FreeBSD__ || defined __OpenBSD__ || defined _AIX || (defined _WIN32 && !defined __CYGWIN__)))
+  /* This platform's <cmath> possibly defines isfinite through a set of inline
+     functions.  */
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isfinite, rpl_isfinite, bool)
+#    define isfinite rpl_isfinite
+#    define GNULIB_NAMESPACE_LACKS_ISFINITE 1
+#   else
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isfinite, isfinite, bool)
+#   endif
 #  endif
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -2207,7 +2496,15 @@
 #  if defined isinf || defined GNULIB_NAMESPACE
 _GL_MATH_CXX_REAL_FLOATING_DECL_1 (isinf)
 #   undef isinf
-_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isinf)
+#   if __GNUC__ >= 6 || (defined __clang__ && !((defined __APPLE__ && defined __MACH__) || defined __FreeBSD__ || defined __OpenBSD__ || (defined _WIN32 && !defined __CYGWIN__)))
+  /* This platform's <cmath> possibly defines isinf through a set of inline
+     functions.  */
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isinf, rpl_isinf, bool)
+#    define isinf rpl_isinf
+#    define GNULIB_NAMESPACE_LACKS_ISINF 1
+#   else
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isinf, isinf, bool)
+#   endif
 #  endif
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -2224,10 +2521,11 @@
 # if @HAVE_ISNANF@
 /* The original <math.h> included above provides a declaration of isnan macro
    or (older) isnanf function.  */
-#  if __GNUC__ >= 4
-    /* GCC 4.0 and newer provides three built-ins for isnan.  */
+#  if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+    /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.
+       GCC >= 4.0 also provides __builtin_isnanf, but clang doesn't.  */
 #   undef isnanf
-#   define isnanf(x) __builtin_isnanf ((float)(x))
+#   define isnanf(x) __builtin_isnan ((float)(x))
 #  elif defined isnan
 #   undef isnanf
 #   define isnanf(x) isnan ((float)(x))
@@ -2247,8 +2545,8 @@
 # if @HAVE_ISNAND@
 /* The original <math.h> included above provides a declaration of isnan
    macro.  */
-#  if __GNUC__ >= 4
-    /* GCC 4.0 and newer provides three built-ins for isnan.  */
+#  if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+    /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.  */
 #   undef isnand
 #   define isnand(x) __builtin_isnan ((double)(x))
 #  else
@@ -2268,10 +2566,11 @@
 # if @HAVE_ISNANL@
 /* The original <math.h> included above provides a declaration of isnan
    macro or (older) isnanl function.  */
-#  if __GNUC__ >= 4
-    /* GCC 4.0 and newer provides three built-ins for isnan.  */
+#  if (__GNUC__ >= 4) || (__clang_major__ >= 4)
+    /* GCC >= 4.0 and clang provide a type-generic built-in for isnan.
+       GCC >= 4.0 also provides __builtin_isnanl, but clang doesn't.  */
 #   undef isnanl
-#   define isnanl(x) __builtin_isnanl ((long double)(x))
+#   define isnanl(x) __builtin_isnan ((long double)(x))
 #  elif defined isnan
 #   undef isnanl
 #   define isnanl(x) isnan ((long double)(x))
@@ -2291,20 +2590,20 @@
    isnanf.h (e.g.) here, because those may end up being macros
    that recursively expand back to isnan.  So use the gnulib
    replacements for them directly. */
-#  if @HAVE_ISNANF@ && __GNUC__ >= 4
-#   define gl_isnan_f(x) __builtin_isnanf ((float)(x))
+#  if @HAVE_ISNANF@ && (__GNUC__ >= 4) || (__clang_major__ >= 4)
+#   define gl_isnan_f(x) __builtin_isnan ((float)(x))
 #  else
 _GL_EXTERN_C int rpl_isnanf (float x);
 #   define gl_isnan_f(x) rpl_isnanf (x)
 #  endif
-#  if @HAVE_ISNAND@ && __GNUC__ >= 4
+#  if @HAVE_ISNAND@ && (__GNUC__ >= 4) || (__clang_major__ >= 4)
 #   define gl_isnan_d(x) __builtin_isnan ((double)(x))
 #  else
 _GL_EXTERN_C int rpl_isnand (double x);
 #   define gl_isnan_d(x) rpl_isnand (x)
 #  endif
-#  if @HAVE_ISNANL@ && __GNUC__ >= 4
-#   define gl_isnan_l(x) __builtin_isnanl ((long double)(x))
+#  if @HAVE_ISNANL@ && (__GNUC__ >= 4) || (__clang_major__ >= 4)
+#   define gl_isnan_l(x) __builtin_isnan ((long double)(x))
 #  else
 _GL_EXTERN_C int rpl_isnanl (long double x) _GL_ATTRIBUTE_CONST;
 #   define gl_isnan_l(x) rpl_isnanl (x)
@@ -2314,18 +2613,26 @@
    (sizeof (x) == sizeof (long double) ? gl_isnan_l (x) : \
     sizeof (x) == sizeof (double) ? gl_isnan_d (x) : \
     gl_isnan_f (x))
-# elif __GNUC__ >= 4
+# elif (__GNUC__ >= 4) || (__clang_major__ >= 4)
 #  undef isnan
 #  define isnan(x) \
-   (sizeof (x) == sizeof (long double) ? __builtin_isnanl ((long double)(x)) : \
+   (sizeof (x) == sizeof (long double) ? __builtin_isnan ((long double)(x)) : \
     sizeof (x) == sizeof (double) ? __builtin_isnan ((double)(x)) : \
-    __builtin_isnanf ((float)(x)))
+    __builtin_isnan ((float)(x)))
 # endif
 # ifdef __cplusplus
 #  if defined isnan || defined GNULIB_NAMESPACE
 _GL_MATH_CXX_REAL_FLOATING_DECL_1 (isnan)
 #   undef isnan
-_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isnan)
+#   if __GNUC__ >= 6 || (defined __clang__ && !((defined __APPLE__ && defined __MACH__ && __clang_major__ < 12) || (defined __FreeBSD__ && (__clang_major__ < 7 || __clang_major__ >= 11)) || defined __OpenBSD__ || (defined _WIN32 && !defined __CYGWIN__)))
+  /* This platform's <cmath> possibly defines isnan through a set of inline
+     functions.  */
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isnan, rpl_isnan, bool)
+#    define isnan rpl_isnan
+#    define GNULIB_NAMESPACE_LACKS_ISNAN 1
+#   else
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (isnan, isnan, bool)
+#   endif
 #  endif
 # else
 /* Ensure isnan is a macro.  */
@@ -2343,21 +2650,21 @@
 
 
 #if @GNULIB_SIGNBIT@
-# if (@REPLACE_SIGNBIT_USING_GCC@ \
+# if (@REPLACE_SIGNBIT_USING_BUILTINS@ \
       && (!defined __cplusplus || __cplusplus < 201103))
 #  undef signbit
-   /* GCC 4.0 and newer provides three built-ins for signbit.  */
+   /* GCC >= 4.0 and clang provide three built-ins for signbit.  */
 #  define signbit(x) \
    (sizeof (x) == sizeof (long double) ? __builtin_signbitl (x) : \
     sizeof (x) == sizeof (double) ? __builtin_signbit (x) : \
     __builtin_signbitf (x))
 # endif
-# if @REPLACE_SIGNBIT@
+# if @REPLACE_SIGNBIT@ && !GNULIB_defined_signbit
 #  undef signbit
 _GL_EXTERN_C int gl_signbitf (float arg);
 _GL_EXTERN_C int gl_signbitd (double arg);
 _GL_EXTERN_C int gl_signbitl (long double arg);
-#  if __GNUC__ >= 2 && !defined __STRICT_ANSI__
+#  if (__GNUC__ >= 2 || defined __clang__) && !defined __STRICT_ANSI__
 #   define _GL_NUM_UINT_WORDS(type) \
       ((sizeof (type) + sizeof (unsigned int) - 1) / sizeof (unsigned int))
 #   if defined FLT_SIGNBIT_WORD && defined FLT_SIGNBIT_BIT && !defined gl_signbitf
@@ -2395,12 +2702,21 @@
    (sizeof (x) == sizeof (long double) ? gl_signbitl (x) : \
     sizeof (x) == sizeof (double) ? gl_signbitd (x) : \
     gl_signbitf (x))
+#  define GNULIB_defined_signbit 1
 # endif
 # ifdef __cplusplus
 #  if defined signbit || defined GNULIB_NAMESPACE
 _GL_MATH_CXX_REAL_FLOATING_DECL_1 (signbit)
 #   undef signbit
-_GL_MATH_CXX_REAL_FLOATING_DECL_2 (signbit)
+#   if __GNUC__ >= 6 || (defined __clang__ && !((defined __APPLE__ && defined __MACH__) || defined __FreeBSD__ || defined __OpenBSD__ || defined _AIX || (defined _WIN32 && !defined __CYGWIN__)))
+  /* This platform's <cmath> possibly defines signbit through a set of inline
+     functions.  */
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (signbit, rpl_signbit, bool)
+#    define signbit rpl_signbit
+#    define GNULIB_NAMESPACE_LACKS_SIGNBIT 1
+#   else
+_GL_MATH_CXX_REAL_FLOATING_DECL_2 (signbit, signbit, bool)
+#   endif
 #  endif
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -2414,4 +2730,6 @@
 _GL_INLINE_HEADER_END
 
 #endif /* _@GUARD_PREFIX@_MATH_H */
+#endif /* _GL_INCLUDING_MATH_H */
 #endif /* _@GUARD_PREFIX@_MATH_H */
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/memchr.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/memchr.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1991, 1993, 1996-1997, 1999-2000, 2003-2004, 2006, 2008-2018
+/* Copyright (C) 1991, 1993, 1996-1997, 1999-2000, 2003-2004, 2006, 2008-2023
    Free Software Foundation, Inc.
 
    Based on strlen implementation by Torbjorn Granlund (tege@sics.se),
@@ -7,21 +7,21 @@
    adaptation to memchr suggested by Dick Karpinski (dick@cca.ucsf.edu),
    and implemented by Roland McGrath (roland@ai.mit.edu).
 
-NOTE: The canonical source of this file is maintained with the GNU C Library.
-Bugs can be reported to bug-glibc@prep.ai.mit.edu.
+   NOTE: The canonical source of this file is maintained with the GNU C Library.
+   Bugs can be reported to bug-glibc@prep.ai.mit.edu.
 
-This program 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 any
-later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-This program 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.
+   This file 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 Lesser General Public License for more details.
 
-You should have received a copy of the GNU General Public License
-along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _LIBC
 # include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/memchr.valgrind -> _service:tar_scm:groff-1.23.0.tar.gz/lib/memchr.valgrind Changed

@@ -1,4 +1,20 @@
 # Suppress a valgrind message about use of uninitialized memory in memchr().
+
+# Copyright (C) 2009-2023 Free Software Foundation, Inc.
+#
+# This file is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as
+# published by the Free Software Foundation; either version 2.1 of the
+# License, or (at your option) any later version.
+#
+# This file 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 Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
 # POSIX states that when the character is found, memchr must not read extra
 # bytes in an overestimated length (for example, where memchr is used to
 # implement strnlen).  However, we use a safe word read to provide a speedup.

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-args.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-args.c Changed

@@ -1,19 +1,19 @@
 /* Decomposed printf argument list.
-   Copyright (C) 1999, 2002-2003, 2005-2007, 2009-2018 Free Software
+   Copyright (C) 1999, 2002-2003, 2005-2007, 2009-2023 Free Software
    Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* This file can be parametrized with the following macros:
      ENABLE_UNISTDIO    Set to 1 to enable the unistdio extensions.
@@ -65,14 +65,12 @@
       case TYPE_ULONGINT:
         ap->a.a_ulongint = va_arg (args, unsigned long int);
         break;
-#if HAVE_LONG_LONG_INT
       case TYPE_LONGLONGINT:
         ap->a.a_longlongint = va_arg (args, long long int);
         break;
       case TYPE_ULONGLONGINT:
         ap->a.a_ulonglongint = va_arg (args, unsigned long long int);
         break;
-#endif
       case TYPE_DOUBLE:
         ap->a.a_double = va_arg (args, double);
         break;
@@ -135,11 +133,9 @@
       case TYPE_COUNT_LONGINT_POINTER:
         ap->a.a_count_longint_pointer = va_arg (args, long int *);
         break;
-#if HAVE_LONG_LONG_INT
       case TYPE_COUNT_LONGLONGINT_POINTER:
         ap->a.a_count_longlongint_pointer = va_arg (args, long long int *);
         break;
-#endif
 #if ENABLE_UNISTDIO
       /* The unistdio extensions.  */
       case TYPE_U8_STRING:

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-args.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-args.h Changed

@@ -1,19 +1,19 @@
 /* Decomposed printf argument list.
-   Copyright (C) 1999, 2002-2003, 2006-2007, 2011-2018 Free Software
+   Copyright (C) 1999, 2002-2003, 2006-2007, 2011-2023 Free Software
    Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _PRINTF_ARGS_H
 #define _PRINTF_ARGS_H
@@ -57,10 +57,8 @@
   TYPE_UINT,
   TYPE_LONGINT,
   TYPE_ULONGINT,
-#if HAVE_LONG_LONG_INT
   TYPE_LONGLONGINT,
   TYPE_ULONGLONGINT,
-#endif
   TYPE_DOUBLE,
   TYPE_LONGDOUBLE,
   TYPE_CHAR,
@@ -75,10 +73,8 @@
   TYPE_COUNT_SCHAR_POINTER,
   TYPE_COUNT_SHORT_POINTER,
   TYPE_COUNT_INT_POINTER,
-  TYPE_COUNT_LONGINT_POINTER
-#if HAVE_LONG_LONG_INT
-, TYPE_COUNT_LONGLONGINT_POINTER
-#endif
+  TYPE_COUNT_LONGINT_POINTER,
+  TYPE_COUNT_LONGLONGINT_POINTER
 #if ENABLE_UNISTDIO
   /* The unistdio extensions.  */
 , TYPE_U8_STRING
@@ -101,10 +97,8 @@
     unsigned int                a_uint;
     long int                    a_longint;
     unsigned long int           a_ulongint;
-#if HAVE_LONG_LONG_INT
     long long int               a_longlongint;
     unsigned long long int      a_ulonglongint;
-#endif
     float                       a_float;
     double                      a_double;
     long double                 a_longdouble;
@@ -121,9 +115,7 @@
     short *                     a_count_short_pointer;
     int *                       a_count_int_pointer;
     long int *                  a_count_longint_pointer;
-#if HAVE_LONG_LONG_INT
     long long int *             a_count_longlongint_pointer;
-#endif
 #if ENABLE_UNISTDIO
     /* The unistdio extensions.  */
     const uint8_t *             a_u8_string;

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-frexp.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-frexp.c Changed

@@ -1,17 +1,17 @@
 /* Split a double into fraction and mantissa, for hexadecimal printf.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if ! defined USE_LONG_DOUBLE

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-frexp.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-frexp.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-frexpl.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-frexpl.c Changed

@@ -1,17 +1,17 @@
 /* Split a 'long double' into fraction and mantissa, for hexadecimal printf.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-frexpl.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-frexpl.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-parse.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-parse.c Changed

@@ -1,18 +1,18 @@
 /* Formatted output to strings.
-   Copyright (C) 1999-2000, 2002-2003, 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 1999-2000, 2002-2003, 2006-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* This file can be parametrized with the following macros:
      CHAR_T             The element type of the format string.
@@ -48,16 +48,7 @@
 #include <stddef.h>
 
 /* Get intmax_t.  */
-#if defined IN_LIBINTL || defined IN_LIBASPRINTF
-# if HAVE_STDINT_H_WITH_UINTMAX
-#  include <stdint.h>
-# endif
-# if HAVE_INTTYPES_H_WITH_UINTMAX
-#  include <inttypes.h>
-# endif
-#else
-# include <stdint.h>
-#endif
+#include <stdint.h>
 
 /* malloc(), realloc(), free().  */
 #include <stdlib.h>
@@ -447,14 +438,12 @@
               switch (c)
                 {
                 case 'd': case 'i':
-#if HAVE_LONG_LONG_INT
-                  /* If 'long long' exists and is larger than 'long':  */
+                  /* If 'long long' is larger than 'long':  */
                   if (flags >= 16 || (flags & 4))
                     type = TYPE_LONGLONGINT;
                   else
-#endif
-                  /* If 'long long' exists and is the same as 'long', we parse
-                     "lld" into TYPE_LONGINT.  */
+                  /* If 'long long' is the same as 'long', we parse "lld" into
+                     TYPE_LONGINT.  */
                   if (flags >= 8)
                     type = TYPE_LONGINT;
                   else if (flags & 2)
@@ -465,14 +454,12 @@
                     type = TYPE_INT;
                   break;
                 case 'o': case 'u': case 'x': case 'X':
-#if HAVE_LONG_LONG_INT
-                  /* If 'long long' exists and is larger than 'long':  */
+                  /* If 'unsigned long long' is larger than 'unsigned long':  */
                   if (flags >= 16 || (flags & 4))
                     type = TYPE_ULONGLONGINT;
                   else
-#endif
-                  /* If 'unsigned long long' exists and is the same as
-                     'unsigned long', we parse "llu" into TYPE_ULONGINT.  */
+                  /* If 'unsigned long long' is the same as 'unsigned long', we
+                     parse "llu" into TYPE_ULONGINT.  */
                   if (flags >= 8)
                     type = TYPE_ULONGINT;
                   else if (flags & 2)
@@ -525,14 +512,12 @@
                   type = TYPE_POINTER;
                   break;
                 case 'n':
-#if HAVE_LONG_LONG_INT
-                  /* If 'long long' exists and is larger than 'long':  */
+                  /* If 'long long' is larger than 'long':  */
                   if (flags >= 16 || (flags & 4))
                     type = TYPE_COUNT_LONGLONGINT_POINTER;
                   else
-#endif
-                  /* If 'long long' exists and is the same as 'long', we parse
-                     "lln" into TYPE_COUNT_LONGINT_POINTER.  */
+                  /* If 'long long' is the same as 'long', we parse "lln" into
+                     TYPE_COUNT_LONGINT_POINTER.  */
                   if (flags >= 8)
                     type = TYPE_COUNT_LONGINT_POINTER;
                   else if (flags & 2)

_service:tar_scm:groff-1.22.4.tar.gz/lib/printf-parse.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/printf-parse.h Changed

@@ -1,19 +1,19 @@
 /* Parse printf format string.
-   Copyright (C) 1999, 2002-2003, 2005, 2007, 2010-2018 Free Software
+   Copyright (C) 1999, 2002-2003, 2005, 2007, 2010-2023 Free Software
    Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _PRINTF_PARSE_H
 #define _PRINTF_PARSE_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/signbitd.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/signbitd.c Changed

@@ -1,17 +1,17 @@
 /* signbit() macro: Determine the sign bit of a floating-point number.
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/signbitf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/signbitf.c Changed

@@ -1,17 +1,17 @@
 /* signbit() macro: Determine the sign bit of a floating-point number.
-   Copyright (C) 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/signbitl.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/signbitl.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/size_max.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/size_max.h Changed

@@ -1,19 +1,19 @@
 /* size_max.h -- declare SIZE_MAX through system headers
-   Copyright (C) 2005-2006, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2005-2006, 2009-2023 Free Software Foundation, Inc.
    Written by Simon Josefsson.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef GNULIB_SIZE_MAX_H
 #define GNULIB_SIZE_MAX_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/snprintf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/snprintf.c Changed

@@ -1,19 +1,19 @@
 /* Formatted output to strings.
-   Copyright (C) 2004, 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 2004, 2006-2023 Free Software Foundation, Inc.
    Written by Simon Josefsson and Paul Eggert.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>

_service:tar_scm:groff-1.23.0.tar.gz/lib/stdbool.in.h Added

@@ -0,0 +1,126 @@
+/* Copyright (C) 2001-2003, 2006-2023 Free Software Foundation, Inc.
+   Written by Bruno Haible <haible@clisp.cons.org>, 2001.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#ifndef _GL_STDBOOL_H
+#define _GL_STDBOOL_H
+
+/* ISO C 99 <stdbool.h> for platforms that lack it.  */
+
+/* Usage suggestions:
+
+   Programs that use <stdbool.h> should be aware of some limitations
+   and standards compliance issues.
+
+   Standards compliance:
+
+       - <stdbool.h> must be #included before 'bool', 'false', 'true'
+         can be used.
+
+       - You cannot assume that sizeof (bool) == 1.
+
+       - Programs should not undefine the macros bool, true, and false,
+         as C99 lists that as an "obsolescent feature".
+
+   Limitations of this substitute, when used in a C89 environment:
+
+       - <stdbool.h> must be #included before the '_Bool' type can be used.
+
+       - You cannot assume that _Bool is a typedef; it might be a macro.
+
+       - Bit-fields of type 'bool' are not supported.  Portable code
+         should use 'unsigned int foo : 1;' rather than 'bool foo : 1;'.
+
+       - In C99, casts and automatic conversions to '_Bool' or 'bool' are
+         performed in such a way that every nonzero value gets converted
+         to 'true', and zero gets converted to 'false'.  This doesn't work
+         with this substitute.  With this substitute, only the values 0 and 1
+         give the expected result when converted to _Bool' or 'bool'.
+
+       - C99 allows the use of (_Bool)0.0 in constant expressions, but
+         this substitute cannot always provide this property.
+
+   Also, it is suggested that programs use 'bool' rather than '_Bool';
+   this isn't required, but 'bool' is more common.  */
+
+
+/* 7.16. Boolean type and values */
+
+#ifdef __cplusplus
+# if !defined _MSC_VER
+#  define _Bool bool
+#  define bool bool
+# endif
+#else
+# if !defined __GNUC__
+   /* If @HAVE__BOOL@:
+        Some HP-UX cc and AIX IBM C compiler versions have compiler bugs when
+        the built-in _Bool type is used.  See
+          https://gcc.gnu.org/ml/gcc-patches/2003-12/msg02303.html
+          https://lists.gnu.org/r/bug-coreutils/2005-11/msg00161.html
+          https://lists.gnu.org/r/bug-coreutils/2005-10/msg00086.html
+        Similar bugs are likely with other compilers as well; this file
+        wouldn't be used if <stdbool.h> was working.
+        So we override the _Bool type.
+      If !@HAVE__BOOL@:
+        Need to define _Bool ourselves. As 'signed char' or as an enum type?
+        Use of a typedef, with SunPRO C, leads to a stupid
+          "warning: _Bool is a keyword in ISO C99".
+        Use of an enum type, with IRIX cc, leads to a stupid
+          "warning(1185): enumerated type mixed with another type".
+        Even the existence of an enum type, without a typedef,
+          "Invalid enumerator. (badenum)" with HP-UX cc on Tru64.
+        The only benefit of the enum, debuggability, is not important
+        with these compilers.  So use 'signed char' and no enum.  */
+#  define _Bool signed char
+# else
+   /* With this compiler, trust the _Bool type if the compiler has it.  */
+#  if !@HAVE__BOOL@
+   /* For the sake of symbolic names in gdb, define true and false as
+      enum constants, not only as macros.
+      It is tempting to write
+         typedef enum { false = 0, true = 1 } _Bool;
+      so that gdb prints values of type 'bool' symbolically.  But then
+      values of type '_Bool' might promote to 'int' or 'unsigned int'
+      (see ISO C 99 6.7.2.2.(4)); however, '_Bool' must promote to 'int'
+      (see ISO C 99 6.3.1.1.(2)).  So add a negative value to the
+      enum; this ensures that '_Bool' promotes to 'int'.  */
+typedef enum { _Bool_must_promote_to_int = -1, false = 0, true = 1 } _Bool;
+#  endif
+# endif
+# define bool _Bool
+#endif
+
+/* The other macros must be usable in preprocessor directives.  */
+#ifdef __cplusplus
+# if !defined _MSC_VER
+#  define false false
+#  define true true
+# endif
+/* In Sun C++ 5.11 (Solaris Studio 12.2) and older, 'true' as a preprocessor
+   expression evaluates to 0, not 1.  Fix this by overriding 'true'.  Note that
+   the replacement has to be of type 'bool'.  */
+# if defined __SUNPRO_CC && true != 1
+#  undef true
+#  define true (!false)
+# endif
+#else
+# define false 0
+# define true 1
+#endif
+
+#define __bool_true_false_are_defined 1
+
+#endif /* _GL_STDBOOL_H */

_service:tar_scm:groff-1.22.4.tar.gz/lib/stddef.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/stddef.in.h Changed

@@ -1,25 +1,25 @@
 /* A substitute for POSIX 2008 <stddef.h>, for platforms that have issues.
 
-   Copyright (C) 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2009-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Eric Blake.  */
 
 /*
  * POSIX 2008 <stddef.h> for platforms that have issues.
- * <http://www.opengroup.org/susv3xbd/stddef.h.html>
+ * <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stddef.h.html>
  */
 
 #if __GNUC__ >= 3
@@ -42,6 +42,13 @@
 #   define _GL_STDDEF_WINT_T
 #  endif
 #  @INCLUDE_NEXT@ @NEXT_STDDEF_H@
+   /* On TinyCC, make sure that the macros that indicate the special invocation
+      convention get undefined.  */
+#  undef __need_wchar_t
+#  undef __need_size_t
+#  undef __need_ptrdiff_t
+#  undef __need_NULL
+#  undef __need_wint_t
 # endif
 
 #else
@@ -49,6 +56,23 @@
 
 # ifndef _@GUARD_PREFIX@_STDDEF_H
 
+/* On AIX 7.2, with xlc in 64-bit mode, <stddef.h> defines max_align_t to a
+   type with alignment 4, but 'long' has alignment 8.  */
+#  if defined _AIX && defined __LP64__
+#   if !GNULIB_defined_max_align_t
+#    ifdef _MAX_ALIGN_T
+/* /usr/include/stddef.h has already defined max_align_t.  Override it.  */
+typedef long rpl_max_align_t;
+#     define max_align_t rpl_max_align_t
+#    else
+/* Prevent /usr/include/stddef.h from defining max_align_t.  */
+typedef long max_align_t;
+#     define _MAX_ALIGN_T
+#    endif
+#    define GNULIB_defined_max_align_t 1
+#   endif
+#  endif
+
 /* The include_next requires a split double-inclusion guard.  */
 
 #  @INCLUDE_NEXT@ @NEXT_STDDEF_H@
@@ -83,20 +107,28 @@
 
 /* Some platforms lack max_align_t.  The check for _GCC_MAX_ALIGN_T is
    a hack in case the configure-time test was done with g++ even though
-   we are currently compiling with gcc.  */
-#if ! (@HAVE_MAX_ALIGN_T@ || defined _GCC_MAX_ALIGN_T)
-# if !GNULIB_defined_max_align_t
+   we are currently compiling with gcc.
+   On MSVC, max_align_t is defined only in C++ mode, after <cstddef> was
+   included.  Its definition is good since it has an alignment of 8 (on x86
+   and x86_64).
+   Similarly on OS/2 kLIBC.  */
+#if (defined _MSC_VER || (defined __KLIBC__ && !defined __LIBCN__)) \
+    && defined __cplusplus
+# include <cstddef>
+#else
+# if ! (@HAVE_MAX_ALIGN_T@ || (defined _GCC_MAX_ALIGN_T && !defined __clang__))
+#  if !GNULIB_defined_max_align_t
 /* On the x86, the maximum storage alignment of double, long, etc. is 4,
    but GCC's C11 ABI for x86 says that max_align_t has an alignment of 8,
    and the C11 standard allows this.  Work around this problem by
    using __alignof__ (which returns 8 for double) rather than _Alignof
    (which returns 4), and align each union member accordingly.  */
-#  ifdef __GNUC__
-#   define _GL_STDDEF_ALIGNAS(type) \
-      __attribute__ ((__aligned__ (__alignof__ (type))))
-#  else
-#   define _GL_STDDEF_ALIGNAS(type) /* */
-#  endif
+#   if defined __GNUC__ || (__clang_major__ >= 4)
+#    define _GL_STDDEF_ALIGNAS(type) \
+       __attribute__ ((__aligned__ (__alignof__ (type))))
+#   else
+#    define _GL_STDDEF_ALIGNAS(type) /* */
+#   endif
 typedef union
 {
   char *__p _GL_STDDEF_ALIGNAS (char *);
@@ -104,8 +136,9 @@
   long double __ld _GL_STDDEF_ALIGNAS (long double);
   long int __i _GL_STDDEF_ALIGNAS (long int);
 } rpl_max_align_t;
-#  define max_align_t rpl_max_align_t
-#  define GNULIB_defined_max_align_t 1
+#   define max_align_t rpl_max_align_t
+#   define GNULIB_defined_max_align_t 1
+#  endif
 # endif
 #endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/stdint.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/stdint.in.h Changed

@@ -1,23 +1,23 @@
-/* Copyright (C) 2001-2002, 2004-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2001-2002, 2004-2023 Free Software Foundation, Inc.
    Written by Paul Eggert, Bruno Haible, Sam Steingold, Peter Burwood.
    This file is part of gnulib.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /*
  * ISO C 99 <stdint.h> for platforms that lack it.
- * <http://www.opengroup.org/susv3xbd/stdint.h.html>
+ * <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/stdint.h.html>
  */
 
 #ifndef _@GUARD_PREFIX@_STDINT_H
@@ -85,7 +85,7 @@
 
 /* Override WINT_MIN and WINT_MAX if gnulib's <wchar.h> or <wctype.h> overrides
    wint_t.  */
-#if @GNULIB_OVERRIDES_WINT_T@
+#if @GNULIBHEADERS_OVERRIDE_WINT_T@
 # undef WINT_MIN
 # undef WINT_MAX
 # define WINT_MIN 0x0U
@@ -188,7 +188,7 @@
 typedef __int64 gl_int64_t;
 #   define int64_t gl_int64_t
 #   define GL_INT64_T
-#  elif @HAVE_LONG_LONG_INT@
+#  else
 #   undef int64_t
 typedef long long int gl_int64_t;
 #   define int64_t gl_int64_t
@@ -209,7 +209,7 @@
 typedef unsigned __int64 gl_uint64_t;
 #   define uint64_t gl_uint64_t
 #   define GL_UINT64_T
-#  elif @HAVE_UNSIGNED_LONG_LONG_INT@
+#  else
 #   undef uint64_t
 typedef unsigned long long int gl_uint64_t;
 #   define uint64_t gl_uint64_t
@@ -299,16 +299,25 @@
 
 /* 7.18.1.4. Integer types capable of holding object pointers */
 
-/* kLIBC's stdint.h defines _INTPTR_T_DECLARED and needs its own
+/* kLIBC's <stdint.h> defines _INTPTR_T_DECLARED and needs its own
    definitions of intptr_t and uintptr_t (which use int and unsigned)
-   to avoid clashes with declarations of system functions like sbrk.  */
-# ifndef _INTPTR_T_DECLARED
-# undef intptr_t
-# undef uintptr_t
+   to avoid clashes with declarations of system functions like sbrk.
+   Similarly, MinGW WSL-5.4.1 <stdint.h> needs its own intptr_t and
+   uintptr_t to avoid conflicting declarations of system functions like
+   _findclose in <io.h>.  */
+# if !((defined __KLIBC__ && defined _INTPTR_T_DECLARED) \
+       || defined __MINGW32__)
+#  undef intptr_t
+#  undef uintptr_t
+#  ifdef _WIN64
+typedef long long int gl_intptr_t;
+typedef unsigned long long int gl_uintptr_t;
+#  else
 typedef long int gl_intptr_t;
 typedef unsigned long int gl_uintptr_t;
-# define intptr_t gl_intptr_t
-# define uintptr_t gl_uintptr_t
+#  endif
+#  define intptr_t gl_intptr_t
+#  define uintptr_t gl_uintptr_t
 # endif
 
 /* 7.18.1.5. Greatest-width integer types */
@@ -323,7 +332,7 @@
 # ifndef INTMAX_MAX
 #  undef INTMAX_C
 #  undef intmax_t
-#  if @HAVE_LONG_LONG_INT@ && LONG_MAX >> 30 == 1
+#  if LONG_MAX >> 30 == 1
 typedef long long int gl_intmax_t;
 #   define intmax_t gl_intmax_t
 #  elif defined GL_INT64_T
@@ -337,7 +346,7 @@
 # ifndef UINTMAX_MAX
 #  undef UINTMAX_C
 #  undef uintmax_t
-#  if @HAVE_UNSIGNED_LONG_LONG_INT@ && ULONG_MAX >> 31 == 1
+#  if ULONG_MAX >> 31 == 1
 typedef unsigned long long int gl_uintmax_t;
 #   define uintmax_t gl_uintmax_t
 #  elif defined GL_UINT64_T
@@ -485,9 +494,15 @@
 # undef INTPTR_MIN
 # undef INTPTR_MAX
 # undef UINTPTR_MAX
-# define INTPTR_MIN  LONG_MIN
-# define INTPTR_MAX  LONG_MAX
-# define UINTPTR_MAX  ULONG_MAX
+# ifdef _WIN64
+#  define INTPTR_MIN  LLONG_MIN
+#  define INTPTR_MAX  LLONG_MAX
+#  define UINTPTR_MAX  ULLONG_MAX
+# else
+#  define INTPTR_MIN  LONG_MIN
+#  define INTPTR_MAX  LONG_MAX
+#  define UINTPTR_MAX  ULONG_MAX
+# endif
 
 /* 7.18.2.5. Limits of greatest-width integer types */
 
@@ -564,11 +579,6 @@
    <wchar.h> -> <stdio.h> -> <getopt.h> -> <stdlib.h>, and the latter includes
    <stdint.h> and assumes its types are already defined.  */
 # if @HAVE_WCHAR_H@ && ! (defined WCHAR_MIN && defined WCHAR_MAX)
-  /* BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-     included before <wchar.h>.  */
-#  include <stddef.h>
-#  include <stdio.h>
-#  include <time.h>
 #  define _GL_JUST_INCLUDE_SYSTEM_WCHAR_H
 #  include <wchar.h>
 #  undef _GL_JUST_INCLUDE_SYSTEM_WCHAR_H
@@ -586,17 +596,21 @@
    _STDINT_MAX (@HAVE_SIGNED_WCHAR_T@, @BITSIZEOF_WCHAR_T@, 0@WCHAR_T_SUFFIX@)
 
 /* wint_t limits */
-# undef WINT_MIN
-# undef WINT_MAX
-# if @HAVE_SIGNED_WINT_T@
-#  define WINT_MIN  \
-    _STDINT_SIGNED_MIN (@BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
-# else
-#  define WINT_MIN  \
-    _STDINT_UNSIGNED_MIN (@BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
+/* If gnulib's <wchar.h> or <wctype.h> overrides wint_t, @WINT_T_SUFFIX@ is not
+   accurate, therefore use the definitions from above.  */
+# if !@GNULIBHEADERS_OVERRIDE_WINT_T@
+#  undef WINT_MIN
+#  undef WINT_MAX
+#  if @HAVE_SIGNED_WINT_T@
+#   define WINT_MIN  \
+     _STDINT_SIGNED_MIN (@BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
+#  else
+#   define WINT_MIN  \
+     _STDINT_UNSIGNED_MIN (@BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
+#  endif
+#  define WINT_MAX  \
+    _STDINT_MAX (@HAVE_SIGNED_WINT_T@, @BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
 # endif
-# define WINT_MAX  \
-   _STDINT_MAX (@HAVE_SIGNED_WINT_T@, @BITSIZEOF_WINT_T@, 0@WINT_T_SUFFIX@)
 
 /* 7.18.4. Macros for integer constants */
 
@@ -627,21 +641,21 @@
 #  define INT64_C(x) x##L
 # elif defined _MSC_VER
 #  define INT64_C(x) x##i64
-# elif @HAVE_LONG_LONG_INT@
+# else
 #  define INT64_C(x) x##LL
 # endif
 # if ULONG_MAX >> 31 >> 31 >> 1 == 1
 #  define UINT64_C(x) x##UL
 # elif defined _MSC_VER
 #  define UINT64_C(x) x##ui64
-# elif @HAVE_UNSIGNED_LONG_LONG_INT@
+# else
 #  define UINT64_C(x) x##ULL
 # endif
 
 /* 7.18.4.2. Macros for greatest-width integer constants */
 
 # ifndef INTMAX_C
-#  if @HAVE_LONG_LONG_INT@ && LONG_MAX >> 30 == 1
+#  if LONG_MAX >> 30 == 1
 #   define INTMAX_C(x)   x##LL
 #  elif defined GL_INT64_T
 #   define INTMAX_C(x)   INT64_C(x)
@@ -651,7 +665,7 @@
 # endif
 
 # ifndef UINTMAX_C
-#  if @HAVE_UNSIGNED_LONG_LONG_INT@ && ULONG_MAX >> 31 == 1
+#  if ULONG_MAX >> 31 == 1
 #   define UINTMAX_C(x)  x##ULL
 #  elif defined GL_UINT64_T
 #   define UINTMAX_C(x)  UINT64_C(x)

_service:tar_scm:groff-1.22.4.tar.gz/lib/stdio-impl.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/stdio-impl.h Changed

@@ -1,28 +1,33 @@
 /* Implementation details of FILE streams.
-   Copyright (C) 2007-2008, 2010-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2008, 2010-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Many stdio implementations have the same logic and therefore can share
    the same implementation of stdio extension API, except that some fields
    have different naming conventions, or their access requires some casts.  */
 
-/* Glibc 2.28 made _IO_IN_BACKUP private.  For now, work around this
-   problem by defining it ourselves.  FIXME: Do not rely on glibc
+/* Glibc 2.28 made _IO_UNBUFFERED and _IO_IN_BACKUP private.  For now, work
+   around this problem by defining them ourselves.  FIXME: Do not rely on glibc
    internals.  */
-#if !defined _IO_IN_BACKUP && defined _IO_EOF_SEEN
-# define _IO_IN_BACKUP 0x100
+#if defined _IO_EOF_SEEN
+# if !defined _IO_UNBUFFERED
+#  define _IO_UNBUFFERED 0x2
+# endif
+# if !defined _IO_IN_BACKUP
+#  define _IO_IN_BACKUP 0x100
+# endif
 #endif
 
 /* BSD stdio derived implementations.  */
@@ -61,6 +66,17 @@
 #  define _r pub._r
 #  define _w pub._w
 # elif defined __ANDROID__ /* Android */
+#  ifdef __LP64__
+#   define _gl_flags_file_t int
+#  else
+#   define _gl_flags_file_t short
+#  endif
+#  ifdef __LP64__
+#   define _gl_file_offset_t int64_t
+#  else
+    /* see https://android.googlesource.com/platform/bionic/+/master/docs/32-bit-abi.md */
+#   define _gl_file_offset_t __kernel_off_t
+#  endif
   /* Up to this commit from 2015-10-12
      <https://android.googlesource.com/platform/bionic.git/+/f0141dfab10a4b332769d52fa76631a64741297a>
      the innards of FILE were public, and fp_ub could be defined like for OpenBSD,
@@ -70,8 +86,8 @@
 #  define fp_ ((struct { unsigned char *_p; \
                          int _r; \
                          int _w; \
-                         int _flags; \
-                         int _file; \
+                         _gl_flags_file_t _flags; \
+                         _gl_flags_file_t _file; \
                          struct { unsigned char *_base; size_t _size; } _bf; \
                          int _lbfsize; \
                          void *_cookie; \
@@ -86,7 +102,7 @@
                          unsigned char _nbuf1; \
                          struct { unsigned char *_base; size_t _size; } _lb; \
                          int _blksize; \
-                         fpos_t _offset; \
+                         _gl_file_offset_t _offset; \
                          /* More fields, not relevant here.  */ \
                        } *) fp)
 # else
@@ -165,7 +181,7 @@
 #  define fp_ fp
 # endif
 
-# if defined _SCO_DS                /* OpenServer */
+# if defined _SCO_DS || (defined __SCO_VERSION__ || defined __sysv5__)  /* OpenServer 5, OpenServer 6, UnixWare 7 */
 #  define _cnt __cnt
 #  define _ptr __ptr
 #  define _base __base

_service:tar_scm:groff-1.23.0.tar.gz/lib/stdio-read.c Added

@@ -0,0 +1,168 @@
+/* POSIX compatible FILE stream read function.
+   Copyright (C) 2008-2023 Free Software Foundation, Inc.
+   Written by Bruno Haible <bruno@clisp.org>, 2011.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#include <config.h>
+
+/* Specification.  */
+#include <stdio.h>
+
+/* Replace these functions only if module 'nonblocking' is requested.  */
+#if GNULIB_NONBLOCKING
+
+/* On native Windows platforms, when read() is called on a non-blocking pipe
+   with an empty buffer, ReadFile() fails with error GetLastError() =
+   ERROR_NO_DATA, and read() in consequence fails with error EINVAL.  This
+   read() function is at the basis of the function which fills the buffer of
+   a FILE stream.  */
+
+# if defined _WIN32 && ! defined __CYGWIN__
+
+#  include <errno.h>
+#  include <io.h>
+
+#  define WIN32_LEAN_AND_MEAN  /* avoid including junk */
+#  include <windows.h>
+
+#  if GNULIB_MSVC_NOTHROW
+#   include "msvc-nothrow.h"
+#  else
+#   include <io.h>
+#  endif
+
+/* Don't assume that UNICODE is not defined.  */
+#  undef GetNamedPipeHandleState
+#  define GetNamedPipeHandleState GetNamedPipeHandleStateA
+
+#  define CALL_WITH_ERRNO_FIX(RETTYPE, EXPRESSION, FAILED) \
+  if (ferror (stream))                                                        \
+    return (EXPRESSION);                                                      \
+  else                                                                        \
+    {                                                                         \
+      RETTYPE ret;                                                            \
+      SetLastError (0);                                                       \
+      ret = (EXPRESSION);                                                     \
+      if (FAILED)                                                             \
+        {                                                                     \
+          if (GetLastError () == ERROR_NO_DATA && ferror (stream))            \
+            {                                                                 \
+              int fd = fileno (stream);                                       \
+              if (fd >= 0)                                                    \
+                {                                                             \
+                  HANDLE h = (HANDLE) _get_osfhandle (fd);                    \
+                  if (GetFileType (h) == FILE_TYPE_PIPE)                      \
+                    {                                                         \
+                      /* h is a pipe or socket.  */                           \
+                      DWORD state;                                            \
+                      if (GetNamedPipeHandleState (h, &state, NULL, NULL,     \
+                                                   NULL, NULL, 0)             \
+                          && (state & PIPE_NOWAIT) != 0)                      \
+                        /* h is a pipe in non-blocking mode.                  \
+                           Change errno from EINVAL to EAGAIN.  */            \
+                        errno = EAGAIN;                                       \
+                    }                                                         \
+                }                                                             \
+            }                                                                 \
+        }                                                                     \
+      return ret;                                                             \
+    }
+
+/* Enable this function definition only if gnulib's <stdio.h> has prepared it.
+   Otherwise we get a function definition conflict with mingw64's <stdio.h>.  */
+#  if GNULIB_SCANF
+int
+scanf (const char *format, ...)
+{
+  int retval;
+  va_list args;
+
+  va_start (args, format);
+  retval = vfscanf (stdin, format, args);
+  va_end (args);
+
+  return retval;
+}
+#  endif
+
+/* Enable this function definition only if gnulib's <stdio.h> has prepared it.
+   Otherwise we get a function definition conflict with mingw64's <stdio.h>.  */
+#  if GNULIB_FSCANF
+int
+fscanf (FILE *stream, const char *format, ...)
+{
+  int retval;
+  va_list args;
+
+  va_start (args, format);
+  retval = vfscanf (stream, format, args);
+  va_end (args);
+
+  return retval;
+}
+#  endif
+
+/* Enable this function definition only if gnulib's <stdio.h> has prepared it.
+   Otherwise we get a function definition conflict with mingw64's <stdio.h>.  */
+#  if GNULIB_VSCANF
+int
+vscanf (const char *format, va_list args)
+{
+  return vfscanf (stdin, format, args);
+}
+#  endif
+
+/* Enable this function definition only if gnulib's <stdio.h> has prepared it.
+   Otherwise we get a function definition conflict with mingw64's <stdio.h>.  */
+#  if GNULIB_VFSCANF
+int
+vfscanf (FILE *stream, const char *format, va_list args)
+#undef vfscanf
+{
+  CALL_WITH_ERRNO_FIX (int, vfscanf (stream, format, args), ret == EOF)
+}
+#  endif
+
+int
+getchar (void)
+{
+  return fgetc (stdin);
+}
+
+int
+fgetc (FILE *stream)
+#undef fgetc
+{
+  CALL_WITH_ERRNO_FIX (int, fgetc (stream), ret == EOF)
+}
+
+char *
+fgets (char *s, int n, FILE *stream)
+#undef fgets
+{
+  CALL_WITH_ERRNO_FIX (char *, fgets (s, n, stream), ret == NULL)
+}
+
+/* We intentionally don't bother to fix gets.  */
+
+size_t
+fread (void *ptr, size_t s, size_t n, FILE *stream)
+#undef fread
+{
+  CALL_WITH_ERRNO_FIX (size_t, fread (ptr, s, n, stream), ret < n)
+}
+
+# endif
+#endif

_service:tar_scm:groff-1.23.0.tar.gz/lib/stdio-write.c Added

@@ -0,0 +1,206 @@
+/* POSIX compatible FILE stream write function.
+   Copyright (C) 2008-2023 Free Software Foundation, Inc.
+   Written by Bruno Haible <bruno@clisp.org>, 2008.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#include <config.h>
+
+/* Specification.  */
+#include <stdio.h>
+
+/* Replace these functions only if module 'nonblocking' or module 'sigpipe' is
+   requested.  */
+#if GNULIB_NONBLOCKING || GNULIB_SIGPIPE
+
+/* On native Windows platforms, SIGPIPE does not exist.  When write() is
+   called on a pipe with no readers, WriteFile() fails with error
+   GetLastError() = ERROR_NO_DATA, and write() in consequence fails with
+   error EINVAL.  This write() function is at the basis of the function
+   which flushes the buffer of a FILE stream.  */
+
+# if defined _WIN32 && ! defined __CYGWIN__
+
+#  include <errno.h>
+#  include <signal.h>
+#  include <io.h>
+
+#  define WIN32_LEAN_AND_MEAN  /* avoid including junk */
+#  include <windows.h>
+
+#  if GNULIB_MSVC_NOTHROW
+#   include "msvc-nothrow.h"
+#  else
+#   include <io.h>
+#  endif
+
+/* Don't assume that UNICODE is not defined.  */
+#  undef GetNamedPipeHandleState
+#  define GetNamedPipeHandleState GetNamedPipeHandleStateA
+
+#  if GNULIB_NONBLOCKING
+#   define CLEAR_ERRNO \
+      errno = 0;
+#   define HANDLE_ENOSPC \
+          if (errno == ENOSPC && ferror (stream))                             \
+            {                                                                 \
+              int fd = fileno (stream);                                       \
+              if (fd >= 0)                                                    \
+                {                                                             \
+                  HANDLE h = (HANDLE) _get_osfhandle (fd);                    \
+                  if (GetFileType (h) == FILE_TYPE_PIPE)                      \
+                    {                                                         \
+                      /* h is a pipe or socket.  */                           \
+                      DWORD state;                                            \
+                      if (GetNamedPipeHandleState (h, &state, NULL, NULL,     \
+                                                   NULL, NULL, 0)             \
+                          && (state & PIPE_NOWAIT) != 0)                      \
+                        /* h is a pipe in non-blocking mode.                  \
+                           Change errno from ENOSPC to EAGAIN.  */            \
+                        errno = EAGAIN;                                       \
+                    }                                                         \
+                }                                                             \
+            }                                                                 \
+          else
+#  else
+#   define CLEAR_ERRNO
+#   define HANDLE_ENOSPC
+#  endif
+
+#  if GNULIB_SIGPIPE
+#   define CLEAR_LastError \
+      SetLastError (0);
+#   define HANDLE_ERROR_NO_DATA \
+          if (GetLastError () == ERROR_NO_DATA && ferror (stream))            \
+            {                                                                 \
+              int fd = fileno (stream);                                       \
+              if (fd >= 0                                                     \
+                  && GetFileType ((HANDLE) _get_osfhandle (fd))               \
+                     == FILE_TYPE_PIPE)                                       \
+                {                                                             \
+                  /* Try to raise signal SIGPIPE.  */                         \
+                  raise (SIGPIPE);                                            \
+                  /* If it is currently blocked or ignored, change errno from \
+                     EINVAL to EPIPE.  */                                     \
+                  errno = EPIPE;                                              \
+                }                                                             \
+            }                                                                 \
+          else
+#  else
+#   define CLEAR_LastError
+#   define HANDLE_ERROR_NO_DATA
+#  endif
+
+#  define CALL_WITH_SIGPIPE_EMULATION(RETTYPE, EXPRESSION, FAILED) \
+  if (ferror (stream))                                                        \
+    return (EXPRESSION);                                                      \
+  else                                                                        \
+    {                                                                         \
+      RETTYPE ret;                                                            \
+      CLEAR_ERRNO                                                             \
+      CLEAR_LastError                                                         \
+      ret = (EXPRESSION);                                                     \
+      if (FAILED)                                                             \
+        {                                                                     \
+          HANDLE_ENOSPC                                                       \
+          HANDLE_ERROR_NO_DATA                                                \
+          ;                                                                   \
+        }                                                                     \
+      return ret;                                                             \
+    }
+
+#  if !REPLACE_PRINTF_POSIX /* avoid collision with printf.c */
+int
+printf (const char *format, ...)
+{
+  int retval;
+  va_list args;
+
+  va_start (args, format);
+  retval = vfprintf (stdout, format, args);
+  va_end (args);
+
+  return retval;
+}
+#  endif
+
+#  if !REPLACE_FPRINTF_POSIX /* avoid collision with fprintf.c */
+int
+fprintf (FILE *stream, const char *format, ...)
+{
+  int retval;
+  va_list args;
+
+  va_start (args, format);
+  retval = vfprintf (stream, format, args);
+  va_end (args);
+
+  return retval;
+}
+#  endif
+
+#  if !REPLACE_VPRINTF_POSIX /* avoid collision with vprintf.c */
+int
+vprintf (const char *format, va_list args)
+{
+  return vfprintf (stdout, format, args);
+}
+#  endif
+
+#  if !REPLACE_VFPRINTF_POSIX /* avoid collision with vfprintf.c */
+int
+vfprintf (FILE *stream, const char *format, va_list args)
+#undef vfprintf
+{
+  CALL_WITH_SIGPIPE_EMULATION (int, vfprintf (stream, format, args), ret == EOF)
+}
+#  endif
+
+int
+putchar (int c)
+{
+  return fputc (c, stdout);
+}
+
+int
+fputc (int c, FILE *stream)
+#undef fputc
+{
+  CALL_WITH_SIGPIPE_EMULATION (int, fputc (c, stream), ret == EOF)
+}
+
+int
+fputs (const char *string, FILE *stream)
+#undef fputs
+{
+  CALL_WITH_SIGPIPE_EMULATION (int, fputs (string, stream), ret == EOF)
+}
+
+int
+puts (const char *string)
+#undef puts
+{
+  FILE *stream = stdout;
+  CALL_WITH_SIGPIPE_EMULATION (int, puts (string), ret == EOF)
+}
+
+size_t
+fwrite (const void *ptr, size_t s, size_t n, FILE *stream)
+#undef fwrite
+{
+  CALL_WITH_SIGPIPE_EMULATION (size_t, fwrite (ptr, s, n, stream), ret < n)
+}
+
+# endif
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/stdio.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/stdio.in.h Changed

@@ -1,19 +1,19 @@
 /* A GNU-like <stdio.h>.
 
-   Copyright (C) 2004, 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2004, 2007-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if __GNUC__ >= 3
 @PRAGMA_SYSTEM_HEADER@
@@ -56,41 +56,103 @@
    May also define off_t to a 64-bit type on native Windows.  */
 #include <sys/types.h>
 
+/* Solaris 10 and NetBSD 7.0 declare renameat in <unistd.h>, not in <stdio.h>.  */
+/* But in any case avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && (defined __sun || defined __NetBSD__) \
+    && ! defined __GLIBC__
+# include <unistd.h>
+#endif
+
+/* Android 4.3 declares renameat in <sys/stat.h>, not in <stdio.h>.  */
+/* But in any case avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \
+    && ! defined __GLIBC__
+# include <sys/stat.h>
+#endif
+
+/* MSVC declares 'perror' in <stdlib.h>, not in <stdio.h>.  We must include
+   it before we  #define perror rpl_perror.  */
+/* But in any case avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_PERROR@ || defined GNULIB_POSIXCHECK) \
+    && (defined _WIN32 && ! defined __CYGWIN__) \
+    && ! defined __GLIBC__
+# include <stdlib.h>
+#endif
+
+/* MSVC declares 'remove' in <io.h>, not in <stdio.h>.  We must include
+   it before we  #define remove rpl_remove.  */
+/* MSVC declares 'rename' in <io.h>, not in <stdio.h>.  We must include
+   it before we  #define rename rpl_rename.  */
+/* But in any case avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_REMOVE@ || @GNULIB_RENAME@ || defined GNULIB_POSIXCHECK) \
+    && (defined _WIN32 && ! defined __CYGWIN__) \
+    && ! defined __GLIBC__
+# include <io.h>
+#endif
+
+
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if __GNUC__ >= 11
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+
 /* The __attribute__ feature is available in gcc versions 2.5 and later.
    The __-protected variants of the attributes 'format' and 'printf' are
    accepted by gcc versions 2.6.4 (effectively 2.7) and later.
    We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because
    gnulib and libintl do '#define printf __printf__' when they override
    the 'printf' function.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
-# define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
+#ifndef _GL_ATTRIBUTE_FORMAT
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7) || defined __clang__
+#  define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
+# else
+#  define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
+# endif
+#endif
+
+/* An __attribute__ __format__ specifier for a function that takes a format
+   string and arguments, where the format string directives are the ones
+   standardized by ISO C99 and POSIX.
+   _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD  */
+/* __gnu_printf__ is supported in GCC >= 4.4.  */
+#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)
+# define _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD __gnu_printf__
 #else
-# define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
+# define _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD __printf__
 #endif
 
-/* _GL_ATTRIBUTE_FORMAT_PRINTF
+/* An __attribute__ __format__ specifier for a function that takes a format
+   string and arguments, where the format string directives are the ones of the
+   system printf(), rather than the ones standardized by ISO C99 and POSIX.
+   _GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM  */
+/* On mingw, Gnulib sets __USE_MINGW_ANSI_STDIO in order to get closer to
+   the standards.  The macro GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU indicates
+   whether this change is effective.  On older mingw, it is not.  */
+#if GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU
+# define _GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD
+#else
+# define _GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM __printf__
+#endif
+
+/* _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD
    indicates to GCC that the function takes a format string and arguments,
    where the format string directives are the ones standardized by ISO C99
    and POSIX.  */
-#if __GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4)
-# define _GL_ATTRIBUTE_FORMAT_PRINTF(formatstring_parameter, first_argument) \
-   _GL_ATTRIBUTE_FORMAT ((__gnu_printf__, formatstring_parameter, first_argument))
-#else
-# define _GL_ATTRIBUTE_FORMAT_PRINTF(formatstring_parameter, first_argument) \
-   _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
-#endif
+#define _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD(formatstring_parameter, first_argument) \
+  _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, formatstring_parameter, first_argument))
 
-/* _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM is like _GL_ATTRIBUTE_FORMAT_PRINTF,
+/* _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM is like _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD,
    except that it indicates to GCC that the supported format string directives
    are the ones of the system printf(), rather than the ones standardized by
    ISO C99 and POSIX.  */
-#if GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU
-# define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
-  _GL_ATTRIBUTE_FORMAT_PRINTF (formatstring_parameter, first_argument)
-#else
-# define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
-  _GL_ATTRIBUTE_FORMAT ((__printf__, formatstring_parameter, first_argument))
-#endif
+#define _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM(formatstring_parameter, first_argument) \
+  _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_SYSTEM, formatstring_parameter, first_argument))
 
 /* _GL_ATTRIBUTE_FORMAT_SCANF
    indicates to GCC that the function takes a format string and arguments,
@@ -111,34 +173,6 @@
 #define _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM(formatstring_parameter, first_argument) \
   _GL_ATTRIBUTE_FORMAT ((__scanf__, formatstring_parameter, first_argument))
 
-/* Solaris 10 and NetBSD 7.0 declare renameat in <unistd.h>, not in <stdio.h>.  */
-/* But in any case avoid namespace pollution on glibc systems.  */
-#if (@GNULIB_RENAMEAT@ || defined GNULIB_POSIXCHECK) && (defined __sun || defined __NetBSD__) \
-    && ! defined __GLIBC__
-# include <unistd.h>
-#endif
-
-/* MSVC declares 'perror' in <stdlib.h>, not in <stdio.h>.  We must include
-   it before we  #define perror rpl_perror.  */
-/* But in any case avoid namespace pollution on glibc systems.  */
-#if (@GNULIB_PERROR@ || defined GNULIB_POSIXCHECK) \
-    && (defined _WIN32 && ! defined __CYGWIN__) \
-    && ! defined __GLIBC__
-# include <stdlib.h>
-#endif
-
-/* MSVC declares 'remove' in <io.h>, not in <stdio.h>.  We must include
-   it before we  #define remove rpl_remove.  */
-/* MSVC declares 'rename' in <io.h>, not in <stdio.h>.  We must include
-   it before we  #define rename rpl_rename.  */
-/* But in any case avoid namespace pollution on glibc systems.  */
-#if (@GNULIB_REMOVE@ || @GNULIB_RENAME@ || defined GNULIB_POSIXCHECK) \
-    && (defined _WIN32 && ! defined __CYGWIN__) \
-    && ! defined __GLIBC__
-# include <io.h>
-#endif
-
-
 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
 
 /* The definition of _GL_ARG_NONNULL is copied here.  */
@@ -164,19 +198,21 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define dprintf rpl_dprintf
 #  endif
-_GL_FUNCDECL_RPL (dprintf, int, (int fd, const char *format, ...)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+_GL_FUNCDECL_RPL (dprintf, int, (int fd, const char *restrict format, ...)
+                                _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                                 _GL_ARG_NONNULL ((2)));
-_GL_CXXALIAS_RPL (dprintf, int, (int fd, const char *format, ...));
+_GL_CXXALIAS_RPL (dprintf, int, (int fd, const char *restrict format, ...));
 # else
 #  if !@HAVE_DPRINTF@
-_GL_FUNCDECL_SYS (dprintf, int, (int fd, const char *format, ...)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+_GL_FUNCDECL_SYS (dprintf, int, (int fd, const char *restrict format, ...)
+                                _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                                 _GL_ARG_NONNULL ((2)));
 #  endif
-_GL_CXXALIAS_SYS (dprintf, int, (int fd, const char *format, ...));
+_GL_CXXALIAS_SYS (dprintf, int, (int fd, const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (dprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef dprintf
 # if HAVE_RAW_DECL_DPRINTF
@@ -196,7 +232,9 @@
 # else
 _GL_CXXALIAS_SYS (fclose, int, (FILE *stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fclose);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fclose
 /* Assume fclose is always declared.  */
@@ -204,24 +242,84 @@
                  "use gnulib module fclose for portable POSIX compliance");
 #endif
 
+#if @GNULIB_MDA_FCLOSEALL@
+/* On native Windows, map 'fcloseall' to '_fcloseall', so that -loldnames is
+   not required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::fcloseall on all platforms that have
+   it.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fcloseall
+#   define fcloseall _fcloseall
+#  endif
+_GL_CXXALIAS_MDA (fcloseall, int, (void));
+# else
+#  if @HAVE_DECL_FCLOSEALL@
+#   if defined __FreeBSD__ || defined __DragonFly__
+_GL_CXXALIAS_SYS (fcloseall, void, (void));
+#   else
+_GL_CXXALIAS_SYS (fcloseall, int, (void));
+#   endif
+#  endif
+# endif
+# if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_FCLOSEALL@
+_GL_CXXALIASWARN (fcloseall);
+# endif
+#endif
+
 #if @GNULIB_FDOPEN@
 # if @REPLACE_FDOPEN@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   undef fdopen
 #   define fdopen rpl_fdopen
 #  endif
-_GL_FUNCDECL_RPL (fdopen, FILE *, (int fd, const char *mode)
-                                  _GL_ARG_NONNULL ((2)));
+_GL_FUNCDECL_RPL (fdopen, FILE *,
+                  (int fd, const char *mode)
+                  _GL_ARG_NONNULL ((2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
 _GL_CXXALIAS_RPL (fdopen, FILE *, (int fd, const char *mode));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fdopen
+#   define fdopen _fdopen
+#  endif
+_GL_CXXALIAS_MDA (fdopen, FILE *, (int fd, const char *mode));
 # else
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate fdopen with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (fdopen, FILE *,
+                  (int fd, const char *mode)
+                  _GL_ARG_NONNULL ((2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+#  endif
 _GL_CXXALIAS_SYS (fdopen, FILE *, (int fd, const char *mode));
 # endif
 _GL_CXXALIASWARN (fdopen);
-#elif defined GNULIB_POSIXCHECK
-# undef fdopen
+#else
+# if @GNULIB_FCLOSE@ && __GNUC__ >= 11 && !defined fdopen
+/* For -Wmismatched-dealloc: Associate fdopen with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (fdopen, FILE *,
+                  (int fd, const char *mode)
+                  _GL_ARG_NONNULL ((2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef fdopen
 /* Assume fdopen is always declared.  */
 _GL_WARN_ON_USE (fdopen, "fdopen on native Windows platforms is not POSIX compliant - "
                  "use gnulib module fdopen for portability");
+# elif @GNULIB_MDA_FDOPEN@
+/* On native Windows, map 'fdopen' to '_fdopen', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::fdopen always.  */
+#  if defined _WIN32 && !defined __CYGWIN__
+#   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#    undef fdopen
+#    define fdopen _fdopen
+#   endif
+_GL_CXXALIAS_MDA (fdopen, FILE *, (int fd, const char *mode));
+#  else
+_GL_CXXALIAS_SYS (fdopen, FILE *, (int fd, const char *mode));
+#  endif
+_GL_CXXALIASWARN (fdopen);
+# endif
 #endif
 
 #if @GNULIB_FFLUSH@
@@ -240,7 +338,9 @@
 # else
 _GL_CXXALIAS_SYS (fflush, int, (FILE *gl_stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fflush);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef fflush
 /* Assume fflush is always declared.  */
@@ -259,7 +359,9 @@
 # else
 _GL_CXXALIAS_SYS (fgetc, int, (FILE *stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fgetc);
+# endif
 #endif
 
 #if @GNULIB_FGETS@
@@ -268,33 +370,74 @@
 #   undef fgets
 #   define fgets rpl_fgets
 #  endif
-_GL_FUNCDECL_RPL (fgets, char *, (char *s, int n, FILE *stream)
-                                 _GL_ARG_NONNULL ((1, 3)));
-_GL_CXXALIAS_RPL (fgets, char *, (char *s, int n, FILE *stream));
+_GL_FUNCDECL_RPL (fgets, char *,
+                  (char *restrict s, int n, FILE *restrict stream)
+                  _GL_ARG_NONNULL ((1, 3)));
+_GL_CXXALIAS_RPL (fgets, char *,
+                  (char *restrict s, int n, FILE *restrict stream));
 # else
-_GL_CXXALIAS_SYS (fgets, char *, (char *s, int n, FILE *stream));
+_GL_CXXALIAS_SYS (fgets, char *,
+                  (char *restrict s, int n, FILE *restrict stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fgets);
+# endif
+#endif
+
+#if @GNULIB_MDA_FILENO@
+/* On native Windows, map 'fileno' to '_fileno', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::fileno always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fileno
+#   define fileno _fileno
+#  endif
+_GL_CXXALIAS_MDA (fileno, int, (FILE *restrict stream));
+# else
+_GL_CXXALIAS_SYS (fileno, int, (FILE *restrict stream));
+# endif
+_GL_CXXALIASWARN (fileno);
 #endif
 
 #if @GNULIB_FOPEN@
-# if @REPLACE_FOPEN@
+# if (@GNULIB_FOPEN@ && @REPLACE_FOPEN@) \
+     || (@GNULIB_FOPEN_GNU@ && @REPLACE_FOPEN_FOR_FOPEN_GNU@)
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   undef fopen
 #   define fopen rpl_fopen
 #  endif
-_GL_FUNCDECL_RPL (fopen, FILE *, (const char *filename, const char *mode)
-                                 _GL_ARG_NONNULL ((1, 2)));
-_GL_CXXALIAS_RPL (fopen, FILE *, (const char *filename, const char *mode));
+_GL_FUNCDECL_RPL (fopen, FILE *,
+                  (const char *restrict filename, const char *restrict mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+_GL_CXXALIAS_RPL (fopen, FILE *,
+                  (const char *restrict filename, const char *restrict mode));
 # else
-_GL_CXXALIAS_SYS (fopen, FILE *, (const char *filename, const char *mode));
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate fopen with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (fopen, FILE *,
+                  (const char *restrict filename, const char *restrict mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+#  endif
+_GL_CXXALIAS_SYS (fopen, FILE *,
+                  (const char *restrict filename, const char *restrict mode));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fopen);
-#elif defined GNULIB_POSIXCHECK
-# undef fopen
+# endif
+#else
+# if @GNULIB_FCLOSE@ && __GNUC__ >= 11 && !defined fopen
+/* For -Wmismatched-dealloc: Associate fopen with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (fopen, FILE *,
+                  (const char *restrict filename, const char *restrict mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef fopen
 /* Assume fopen is always declared.  */
 _GL_WARN_ON_USE (fopen, "fopen on native Windows platforms is not POSIX compliant - "
                  "use gnulib module fopen for portability");
+# endif
 #endif
 
 #if @GNULIB_FPRINTF_POSIX@ || @GNULIB_FPRINTF@
@@ -305,19 +448,25 @@
 #  endif
 #  define GNULIB_overrides_fprintf 1
 #  if @GNULIB_FPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
-_GL_FUNCDECL_RPL (fprintf, int, (FILE *fp, const char *format, ...)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
-                                _GL_ARG_NONNULL ((1, 2)));
+_GL_FUNCDECL_RPL (fprintf, int,
+                  (FILE *restrict fp, const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
+                  _GL_ARG_NONNULL ((1, 2)));
 #  else
-_GL_FUNCDECL_RPL (fprintf, int, (FILE *fp, const char *format, ...)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 3)
-                                _GL_ARG_NONNULL ((1, 2)));
+_GL_FUNCDECL_RPL (fprintf, int,
+                  (FILE *restrict fp, const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 3)
+                  _GL_ARG_NONNULL ((1, 2)));
 #  endif
-_GL_CXXALIAS_RPL (fprintf, int, (FILE *fp, const char *format, ...));
+_GL_CXXALIAS_RPL (fprintf, int,
+                  (FILE *restrict fp, const char *restrict format, ...));
 # else
-_GL_CXXALIAS_SYS (fprintf, int, (FILE *fp, const char *format, ...));
+_GL_CXXALIAS_SYS (fprintf, int,
+                  (FILE *restrict fp, const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fprintf);
+# endif
 #endif
 #if !@GNULIB_FPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 # if !GNULIB_overrides_fprintf
@@ -368,7 +517,9 @@
 # else
 _GL_CXXALIAS_SYS (fputc, int, (int c, FILE *stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fputc);
+# endif
 #endif
 
 #if @GNULIB_FPUTS@
@@ -377,13 +528,18 @@
 #   undef fputs
 #   define fputs rpl_fputs
 #  endif
-_GL_FUNCDECL_RPL (fputs, int, (const char *string, FILE *stream)
-                              _GL_ARG_NONNULL ((1, 2)));
-_GL_CXXALIAS_RPL (fputs, int, (const char *string, FILE *stream));
+_GL_FUNCDECL_RPL (fputs, int,
+                  (const char *restrict string, FILE *restrict stream)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (fputs, int,
+                  (const char *restrict string, FILE *restrict stream));
 # else
-_GL_CXXALIAS_SYS (fputs, int, (const char *string, FILE *stream));
+_GL_CXXALIAS_SYS (fputs, int,
+                  (const char *restrict string, FILE *restrict stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fputs);
+# endif
 #endif
 
 #if @GNULIB_FREAD@
@@ -392,13 +548,21 @@
 #   undef fread
 #   define fread rpl_fread
 #  endif
-_GL_FUNCDECL_RPL (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream)
-                                 _GL_ARG_NONNULL ((4)));
-_GL_CXXALIAS_RPL (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream));
+_GL_FUNCDECL_RPL (fread, size_t,
+                  (void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream)
+                  _GL_ARG_NONNULL ((4)));
+_GL_CXXALIAS_RPL (fread, size_t,
+                  (void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream));
 # else
-_GL_CXXALIAS_SYS (fread, size_t, (void *ptr, size_t s, size_t n, FILE *stream));
+_GL_CXXALIAS_SYS (fread, size_t,
+                  (void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fread);
+# endif
 #endif
 
 #if @GNULIB_FREOPEN@
@@ -408,15 +572,20 @@
 #   define freopen rpl_freopen
 #  endif
 _GL_FUNCDECL_RPL (freopen, FILE *,
-                  (const char *filename, const char *mode, FILE *stream)
+                  (const char *restrict filename, const char *restrict mode,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((2, 3)));
 _GL_CXXALIAS_RPL (freopen, FILE *,
-                  (const char *filename, const char *mode, FILE *stream));
+                  (const char *restrict filename, const char *restrict mode,
+                   FILE *restrict stream));
 # else
 _GL_CXXALIAS_SYS (freopen, FILE *,
-                  (const char *filename, const char *mode, FILE *stream));
+                  (const char *restrict filename, const char *restrict mode,
+                   FILE *restrict stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (freopen);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef freopen
 /* Assume freopen is always declared.  */
@@ -431,14 +600,19 @@
 #   undef fscanf
 #   define fscanf rpl_fscanf
 #  endif
-_GL_FUNCDECL_RPL (fscanf, int, (FILE *stream, const char *format, ...)
-                               _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 3)
-                               _GL_ARG_NONNULL ((1, 2)));
-_GL_CXXALIAS_RPL (fscanf, int, (FILE *stream, const char *format, ...));
+_GL_FUNCDECL_RPL (fscanf, int,
+                  (FILE *restrict stream, const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 3)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (fscanf, int,
+                  (FILE *restrict stream, const char *restrict format, ...));
 # else
-_GL_CXXALIAS_SYS (fscanf, int, (FILE *stream, const char *format, ...));
+_GL_CXXALIAS_SYS (fscanf, int,
+                  (FILE *restrict stream, const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fscanf);
+# endif
 #endif
 
 
@@ -489,7 +663,9 @@
 # else
 _GL_CXXALIAS_SYS (fseek, int, (FILE *fp, long offset, int whence));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fseek);
+# endif
 #endif
 
 #if @GNULIB_FSEEKO@
@@ -552,7 +728,9 @@
 # else
 _GL_CXXALIAS_SYS (ftell, long, (FILE *fp));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (ftell);
+# endif
 #endif
 
 #if @GNULIB_FTELLO@
@@ -601,13 +779,16 @@
 #   define fwrite rpl_fwrite
 #  endif
 _GL_FUNCDECL_RPL (fwrite, size_t,
-                  (const void *ptr, size_t s, size_t n, FILE *stream)
+                  (const void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((1, 4)));
 _GL_CXXALIAS_RPL (fwrite, size_t,
-                  (const void *ptr, size_t s, size_t n, FILE *stream));
+                  (const void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream));
 # else
 _GL_CXXALIAS_SYS (fwrite, size_t,
-                  (const void *ptr, size_t s, size_t n, FILE *stream));
+                  (const void *restrict ptr, size_t s, size_t n,
+                   FILE *restrict stream));
 
 /* Work around bug 11959 when fortifying glibc 2.4 through 2.15
    <https://sourceware.org/bugzilla/show_bug.cgi?id=11959>,
@@ -632,7 +813,9 @@
 #   define fwrite_unlocked rpl_fwrite_unlocked
 #  endif
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (fwrite);
+# endif
 #endif
 
 #if @GNULIB_GETC@
@@ -646,7 +829,9 @@
 # else
 _GL_CXXALIAS_SYS (getc, int, (FILE *stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (getc);
+# endif
 #endif
 
 #if @GNULIB_GETCHAR@
@@ -660,7 +845,9 @@
 # else
 _GL_CXXALIAS_SYS (getchar, int, (void));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (getchar);
+# endif
 #endif
 
 #if @GNULIB_GETDELIM@
@@ -676,24 +863,30 @@
 #   define getdelim rpl_getdelim
 #  endif
 _GL_FUNCDECL_RPL (getdelim, ssize_t,
-                  (char **lineptr, size_t *linesize, int delimiter,
-                   FILE *stream)
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   int delimiter,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((1, 2, 4)));
 _GL_CXXALIAS_RPL (getdelim, ssize_t,
-                  (char **lineptr, size_t *linesize, int delimiter,
-                   FILE *stream));
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   int delimiter,
+                   FILE *restrict stream));
 # else
 #  if !@HAVE_DECL_GETDELIM@
 _GL_FUNCDECL_SYS (getdelim, ssize_t,
-                  (char **lineptr, size_t *linesize, int delimiter,
-                   FILE *stream)
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   int delimiter,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((1, 2, 4)));
 #  endif
 _GL_CXXALIAS_SYS (getdelim, ssize_t,
-                  (char **lineptr, size_t *linesize, int delimiter,
-                   FILE *stream));
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   int delimiter,
+                   FILE *restrict stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (getdelim);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef getdelim
 # if HAVE_RAW_DECL_GETDELIM
@@ -715,20 +908,24 @@
 #   define getline rpl_getline
 #  endif
 _GL_FUNCDECL_RPL (getline, ssize_t,
-                  (char **lineptr, size_t *linesize, FILE *stream)
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((1, 2, 3)));
 _GL_CXXALIAS_RPL (getline, ssize_t,
-                  (char **lineptr, size_t *linesize, FILE *stream));
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   FILE *restrict stream));
 # else
 #  if !@HAVE_DECL_GETLINE@
 _GL_FUNCDECL_SYS (getline, ssize_t,
-                  (char **lineptr, size_t *linesize, FILE *stream)
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   FILE *restrict stream)
                   _GL_ARG_NONNULL ((1, 2, 3)));
 #  endif
 _GL_CXXALIAS_SYS (getline, ssize_t,
-                  (char **lineptr, size_t *linesize, FILE *stream));
+                  (char **restrict lineptr, size_t *restrict linesize,
+                   FILE *restrict stream));
 # endif
-# if @HAVE_DECL_GETLINE@
+# if __GLIBC__ >= 2 && @HAVE_DECL_GETLINE@
 _GL_CXXALIASWARN (getline);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -747,6 +944,26 @@
 _GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
 #endif
 
+#if @GNULIB_MDA_GETW@
+/* On native Windows, map 'getw' to '_getw', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::getw always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getw
+#   define getw _getw
+#  endif
+_GL_CXXALIAS_MDA (getw, int, (FILE *restrict stream));
+# else
+#  if @HAVE_DECL_GETW@
+_GL_CXXALIAS_SYS (getw, int, (FILE *restrict stream));
+#  endif
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getw);
+# endif
+#endif
+
 #if @GNULIB_OBSTACK_PRINTF@ || @GNULIB_OBSTACK_PRINTF_POSIX@
 struct obstack;
 /* Grow an obstack with formatted output.  Return the number of
@@ -760,7 +977,7 @@
 #  endif
 _GL_FUNCDECL_RPL (obstack_printf, int,
                   (struct obstack *obs, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (obstack_printf, int,
                   (struct obstack *obs, const char *format, ...));
@@ -768,7 +985,7 @@
 #  if !@HAVE_DECL_OBSTACK_PRINTF@
 _GL_FUNCDECL_SYS (obstack_printf, int,
                   (struct obstack *obs, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                   _GL_ARG_NONNULL ((1, 2)));
 #  endif
 _GL_CXXALIAS_SYS (obstack_printf, int,
@@ -781,7 +998,7 @@
 #  endif
 _GL_FUNCDECL_RPL (obstack_vprintf, int,
                   (struct obstack *obs, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (obstack_vprintf, int,
                   (struct obstack *obs, const char *format, va_list args));
@@ -789,7 +1006,7 @@
 #  if !@HAVE_DECL_OBSTACK_PRINTF@
 _GL_FUNCDECL_SYS (obstack_vprintf, int,
                   (struct obstack *obs, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 #  endif
 _GL_CXXALIAS_SYS (obstack_vprintf, int,
@@ -825,7 +1042,9 @@
 # else
 _GL_CXXALIAS_SYS (perror, void, (const char *string));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (perror);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef perror
 /* Assume perror is always declared.  */
@@ -839,43 +1058,53 @@
 #   undef popen
 #   define popen rpl_popen
 #  endif
-_GL_FUNCDECL_RPL (popen, FILE *, (const char *cmd, const char *mode)
-                                 _GL_ARG_NONNULL ((1, 2)));
+_GL_FUNCDECL_RPL (popen, FILE *,
+                  (const char *cmd, const char *mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (pclose, 1));
 _GL_CXXALIAS_RPL (popen, FILE *, (const char *cmd, const char *mode));
 # else
-#  if !@HAVE_POPEN@
-_GL_FUNCDECL_SYS (popen, FILE *, (const char *cmd, const char *mode)
-                                 _GL_ARG_NONNULL ((1, 2)));
+#  if !@HAVE_POPEN@ || __GNUC__ >= 11
+_GL_FUNCDECL_SYS (popen, FILE *,
+                  (const char *cmd, const char *mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (pclose, 1));
 #  endif
 _GL_CXXALIAS_SYS (popen, FILE *, (const char *cmd, const char *mode));
 # endif
 _GL_CXXALIASWARN (popen);
-#elif defined GNULIB_POSIXCHECK
-# undef popen
-# if HAVE_RAW_DECL_POPEN
+#else
+# if @GNULIB_PCLOSE@ && __GNUC__ >= 11 && !defined popen
+/* For -Wmismatched-dealloc: Associate popen with pclose or rpl_pclose.  */
+_GL_FUNCDECL_SYS (popen, FILE *,
+                  (const char *cmd, const char *mode)
+                  _GL_ARG_NONNULL ((1, 2)) _GL_ATTRIBUTE_DEALLOC (pclose, 1));
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef popen
+#  if HAVE_RAW_DECL_POPEN
 _GL_WARN_ON_USE (popen, "popen is buggy on some platforms - "
                  "use gnulib module popen or pipe for more portability");
+#  endif
 # endif
 #endif
 
 #if @GNULIB_PRINTF_POSIX@ || @GNULIB_PRINTF@
 # if (@GNULIB_PRINTF_POSIX@ && @REPLACE_PRINTF@) \
      || (@GNULIB_PRINTF@ && @REPLACE_STDIO_WRITE_FUNCS@ && (@GNULIB_STDIO_H_NONBLOCKING@ || @GNULIB_STDIO_H_SIGPIPE@))
-#  if defined __GNUC__
+#  if defined __GNUC__ || defined __clang__
 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 /* Don't break __attribute__((format(printf,M,N))).  */
 #    define printf __printf__
 #   endif
 #   if @GNULIB_PRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
 _GL_FUNCDECL_RPL_1 (__printf__, int,
-                    (const char *format, ...)
+                    (const char *restrict format, ...)
                     __asm__ (@ASM_SYMBOL_PREFIX@
                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
-                    _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
+                    _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (1, 2)
                     _GL_ARG_NONNULL ((1)));
 #   else
 _GL_FUNCDECL_RPL_1 (__printf__, int,
-                    (const char *format, ...)
+                    (const char *restrict format, ...)
                     __asm__ (@ASM_SYMBOL_PREFIX@
                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_printf))
                     _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 2)
@@ -887,16 +1116,18 @@
 #    define printf rpl_printf
 #   endif
 _GL_FUNCDECL_RPL (printf, int,
-                  (const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (1, 2)
+                  (const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (1, 2)
                   _GL_ARG_NONNULL ((1)));
-_GL_CXXALIAS_RPL (printf, int, (const char *format, ...));
+_GL_CXXALIAS_RPL (printf, int, (const char *restrict format, ...));
 #  endif
 #  define GNULIB_overrides_printf 1
 # else
-_GL_CXXALIAS_SYS (printf, int, (const char *format, ...));
+_GL_CXXALIAS_SYS (printf, int, (const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (printf);
+# endif
 #endif
 #if !@GNULIB_PRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 # if !GNULIB_overrides_printf
@@ -919,7 +1150,9 @@
 # else
 _GL_CXXALIAS_SYS (putc, int, (int c, FILE *stream));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (putc);
+# endif
 #endif
 
 #if @GNULIB_PUTCHAR@
@@ -933,7 +1166,9 @@
 # else
 _GL_CXXALIAS_SYS (putchar, int, (int c));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (putchar);
+# endif
 #endif
 
 #if @GNULIB_PUTS@
@@ -947,7 +1182,29 @@
 # else
 _GL_CXXALIAS_SYS (puts, int, (const char *string));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (puts);
+# endif
+#endif
+
+#if @GNULIB_MDA_PUTW@
+/* On native Windows, map 'putw' to '_putw', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::putw always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef putw
+#   define putw _putw
+#  endif
+_GL_CXXALIAS_MDA (putw, int, (int w, FILE *restrict stream));
+# else
+#  if @HAVE_DECL_PUTW@
+_GL_CXXALIAS_SYS (putw, int, (int w, FILE *restrict stream));
+#  endif
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (putw);
+# endif
 #endif
 
 #if @GNULIB_REMOVE@
@@ -961,7 +1218,9 @@
 # else
 _GL_CXXALIAS_SYS (remove, int, (const char *name));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (remove);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef remove
 /* Assume remove is always declared.  */
@@ -984,7 +1243,9 @@
 _GL_CXXALIAS_SYS (rename, int,
                   (const char *old_filename, const char *new_filename));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (rename);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef rename
 /* Assume rename is always declared.  */
@@ -1023,33 +1284,35 @@
 
 #if @GNULIB_SCANF@
 # if @REPLACE_STDIO_READ_FUNCS@ && @GNULIB_STDIO_H_NONBLOCKING@
-#  if defined __GNUC__
+#  if defined __GNUC__ || defined __clang__
 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #    undef scanf
 /* Don't break __attribute__((format(scanf,M,N))).  */
 #    define scanf __scanf__
 #   endif
 _GL_FUNCDECL_RPL_1 (__scanf__, int,
-                    (const char *format, ...)
+                    (const char *restrict format, ...)
                     __asm__ (@ASM_SYMBOL_PREFIX@
                              _GL_STDIO_MACROEXPAND_AND_STRINGIZE(rpl_scanf))
                     _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
                     _GL_ARG_NONNULL ((1)));
-_GL_CXXALIAS_RPL_1 (scanf, __scanf__, int, (const char *format, ...));
+_GL_CXXALIAS_RPL_1 (scanf, __scanf__, int, (const char *restrict format, ...));
 #  else
 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #    undef scanf
 #    define scanf rpl_scanf
 #   endif
-_GL_FUNCDECL_RPL (scanf, int, (const char *format, ...)
+_GL_FUNCDECL_RPL (scanf, int, (const char *restrict format, ...)
                               _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 2)
                               _GL_ARG_NONNULL ((1)));
-_GL_CXXALIAS_RPL (scanf, int, (const char *format, ...));
+_GL_CXXALIAS_RPL (scanf, int, (const char *restrict format, ...));
 #  endif
 # else
-_GL_CXXALIAS_SYS (scanf, int, (const char *format, ...));
+_GL_CXXALIAS_SYS (scanf, int, (const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (scanf);
+# endif
 #endif
 
 #if @GNULIB_SNPRINTF@
@@ -1057,23 +1320,30 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define snprintf rpl_snprintf
 #  endif
+#  define GNULIB_overrides_snprintf 1
 _GL_FUNCDECL_RPL (snprintf, int,
-                  (char *str, size_t size, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
+                  (char *restrict str, size_t size,
+                   const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (3, 4)
                   _GL_ARG_NONNULL ((3)));
 _GL_CXXALIAS_RPL (snprintf, int,
-                  (char *str, size_t size, const char *format, ...));
+                  (char *restrict str, size_t size,
+                   const char *restrict format, ...));
 # else
 #  if !@HAVE_DECL_SNPRINTF@
 _GL_FUNCDECL_SYS (snprintf, int,
-                  (char *str, size_t size, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (3, 4)
+                  (char *restrict str, size_t size,
+                   const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (3, 4)
                   _GL_ARG_NONNULL ((3)));
 #  endif
 _GL_CXXALIAS_SYS (snprintf, int,
-                  (char *str, size_t size, const char *format, ...));
+                  (char *restrict str, size_t size,
+                   const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (snprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef snprintf
 # if HAVE_RAW_DECL_SNPRINTF
@@ -1096,14 +1366,20 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define sprintf rpl_sprintf
 #  endif
-_GL_FUNCDECL_RPL (sprintf, int, (char *str, const char *format, ...)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
-                                _GL_ARG_NONNULL ((1, 2)));
-_GL_CXXALIAS_RPL (sprintf, int, (char *str, const char *format, ...));
+#  define GNULIB_overrides_sprintf 1
+_GL_FUNCDECL_RPL (sprintf, int,
+                  (char *restrict str, const char *restrict format, ...)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (sprintf, int,
+                  (char *restrict str, const char *restrict format, ...));
 # else
-_GL_CXXALIAS_SYS (sprintf, int, (char *str, const char *format, ...));
+_GL_CXXALIAS_SYS (sprintf, int,
+                  (char *restrict str, const char *restrict format, ...));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (sprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef sprintf
 /* Assume sprintf is always declared.  */
@@ -1112,22 +1388,53 @@
                  "POSIX compliance");
 #endif
 
+#if @GNULIB_MDA_TEMPNAM@
+/* On native Windows, map 'tempnam' to '_tempnam', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::tempnam always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef tempnam
+#   define tempnam _tempnam
+#  endif
+_GL_CXXALIAS_MDA (tempnam, char *, (const char *dir, const char *prefix));
+# else
+_GL_CXXALIAS_SYS (tempnam, char *, (const char *dir, const char *prefix));
+# endif
+_GL_CXXALIASWARN (tempnam);
+#endif
+
 #if @GNULIB_TMPFILE@
 # if @REPLACE_TMPFILE@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define tmpfile rpl_tmpfile
 #  endif
-_GL_FUNCDECL_RPL (tmpfile, FILE *, (void));
+_GL_FUNCDECL_RPL (tmpfile, FILE *, (void)
+                                   _GL_ATTRIBUTE_DEALLOC (fclose, 1));
 _GL_CXXALIAS_RPL (tmpfile, FILE *, (void));
 # else
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate tmpfile with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (tmpfile, FILE *, (void)
+                                   _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+#  endif
 _GL_CXXALIAS_SYS (tmpfile, FILE *, (void));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (tmpfile);
-#elif defined GNULIB_POSIXCHECK
-# undef tmpfile
-# if HAVE_RAW_DECL_TMPFILE
+# endif
+#else
+# if @GNULIB_FCLOSE@ && __GNUC__ >= 11 && !defined tmpfile
+/* For -Wmismatched-dealloc: Associate tmpfile with fclose or rpl_fclose.  */
+_GL_FUNCDECL_SYS (tmpfile, FILE *, (void)
+                                   _GL_ATTRIBUTE_DEALLOC (fclose, 1));
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef tmpfile
+#  if HAVE_RAW_DECL_TMPFILE
 _GL_WARN_ON_USE (tmpfile, "tmpfile is not usable on mingw - "
                  "use gnulib module tmpfile for portability");
+#  endif
 # endif
 #endif
 
@@ -1140,9 +1447,10 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define asprintf rpl_asprintf
 #  endif
+#  define GNULIB_overrides_asprintf
 _GL_FUNCDECL_RPL (asprintf, int,
                   (char **result, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (asprintf, int,
                   (char **result, const char *format, ...));
@@ -1150,7 +1458,7 @@
 #  if !@HAVE_VASPRINTF@
 _GL_FUNCDECL_SYS (asprintf, int,
                   (char **result, const char *format, ...)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 3)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 3)
                   _GL_ARG_NONNULL ((1, 2)));
 #  endif
 _GL_CXXALIAS_SYS (asprintf, int,
@@ -1161,9 +1469,10 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define vasprintf rpl_vasprintf
 #  endif
+#  define GNULIB_overrides_vasprintf 1
 _GL_FUNCDECL_RPL (vasprintf, int,
                   (char **result, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (vasprintf, int,
                   (char **result, const char *format, va_list args));
@@ -1171,7 +1480,7 @@
 #  if !@HAVE_VASPRINTF@
 _GL_FUNCDECL_SYS (vasprintf, int,
                   (char **result, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 #  endif
 _GL_CXXALIAS_SYS (vasprintf, int,
@@ -1185,22 +1494,27 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define vdprintf rpl_vdprintf
 #  endif
-_GL_FUNCDECL_RPL (vdprintf, int, (int fd, const char *format, va_list args)
-                                 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
-                                 _GL_ARG_NONNULL ((2)));
-_GL_CXXALIAS_RPL (vdprintf, int, (int fd, const char *format, va_list args));
+_GL_FUNCDECL_RPL (vdprintf, int,
+                  (int fd, const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (vdprintf, int,
+                  (int fd, const char *restrict format, va_list args));
 # else
 #  if !@HAVE_VDPRINTF@
-_GL_FUNCDECL_SYS (vdprintf, int, (int fd, const char *format, va_list args)
-                                 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
-                                 _GL_ARG_NONNULL ((2)));
+_GL_FUNCDECL_SYS (vdprintf, int,
+                  (int fd, const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
+                  _GL_ARG_NONNULL ((2)));
 #  endif
 /* Need to cast, because on Solaris, the third parameter will likely be
                                                     __va_list args.  */
 _GL_CXXALIAS_SYS_CAST (vdprintf, int,
-                       (int fd, const char *format, va_list args));
+                       (int fd, const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vdprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef vdprintf
 # if HAVE_RAW_DECL_VDPRINTF
@@ -1217,23 +1531,32 @@
 #  endif
 #  define GNULIB_overrides_vfprintf 1
 #  if @GNULIB_VFPRINTF_POSIX@
-_GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)
-                                 _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
-                                 _GL_ARG_NONNULL ((1, 2)));
+_GL_FUNCDECL_RPL (vfprintf, int,
+                  (FILE *restrict fp,
+                   const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
+                  _GL_ARG_NONNULL ((1, 2)));
 #  else
-_GL_FUNCDECL_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args)
-                                 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 0)
-                                 _GL_ARG_NONNULL ((1, 2)));
+_GL_FUNCDECL_RPL (vfprintf, int,
+                  (FILE *restrict fp,
+                   const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (2, 0)
+                  _GL_ARG_NONNULL ((1, 2)));
 #  endif
-_GL_CXXALIAS_RPL (vfprintf, int, (FILE *fp, const char *format, va_list args));
+_GL_CXXALIAS_RPL (vfprintf, int,
+                  (FILE *restrict fp,
+                   const char *restrict format, va_list args));
 # else
 /* Need to cast, because on Solaris, the third parameter is
                                                       __va_list args
    and GCC's fixincludes did not change this to __gnuc_va_list.  */
 _GL_CXXALIAS_SYS_CAST (vfprintf, int,
-                       (FILE *fp, const char *format, va_list args));
+                       (FILE *restrict fp,
+                        const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vfprintf);
+# endif
 #endif
 #if !@GNULIB_VFPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 # if !GNULIB_overrides_vfprintf
@@ -1252,16 +1575,21 @@
 #   define vfscanf rpl_vfscanf
 #  endif
 _GL_FUNCDECL_RPL (vfscanf, int,
-                  (FILE *stream, const char *format, va_list args)
+                  (FILE *restrict stream,
+                   const char *restrict format, va_list args)
                   _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (vfscanf, int,
-                  (FILE *stream, const char *format, va_list args));
+                  (FILE *restrict stream,
+                   const char *restrict format, va_list args));
 # else
 _GL_CXXALIAS_SYS (vfscanf, int,
-                  (FILE *stream, const char *format, va_list args));
+                  (FILE *restrict stream,
+                   const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vfscanf);
+# endif
 #endif
 
 #if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VPRINTF@
@@ -1272,22 +1600,25 @@
 #  endif
 #  define GNULIB_overrides_vprintf 1
 #  if @GNULIB_VPRINTF_POSIX@ || @GNULIB_VFPRINTF_POSIX@
-_GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args)
-                                _GL_ATTRIBUTE_FORMAT_PRINTF (1, 0)
+_GL_FUNCDECL_RPL (vprintf, int, (const char *restrict format, va_list args)
+                                _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (1, 0)
                                 _GL_ARG_NONNULL ((1)));
 #  else
-_GL_FUNCDECL_RPL (vprintf, int, (const char *format, va_list args)
+_GL_FUNCDECL_RPL (vprintf, int, (const char *restrict format, va_list args)
                                 _GL_ATTRIBUTE_FORMAT_PRINTF_SYSTEM (1, 0)
                                 _GL_ARG_NONNULL ((1)));
 #  endif
-_GL_CXXALIAS_RPL (vprintf, int, (const char *format, va_list args));
+_GL_CXXALIAS_RPL (vprintf, int, (const char *restrict format, va_list args));
 # else
 /* Need to cast, because on Solaris, the second parameter is
                                                           __va_list args
    and GCC's fixincludes did not change this to __gnuc_va_list.  */
-_GL_CXXALIAS_SYS_CAST (vprintf, int, (const char *format, va_list args));
+_GL_CXXALIAS_SYS_CAST (vprintf, int,
+                       (const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vprintf);
+# endif
 #endif
 #if !@GNULIB_VPRINTF_POSIX@ && defined GNULIB_POSIXCHECK
 # if !GNULIB_overrides_vprintf
@@ -1305,14 +1636,16 @@
 #   undef vscanf
 #   define vscanf rpl_vscanf
 #  endif
-_GL_FUNCDECL_RPL (vscanf, int, (const char *format, va_list args)
+_GL_FUNCDECL_RPL (vscanf, int, (const char *restrict format, va_list args)
                                _GL_ATTRIBUTE_FORMAT_SCANF_SYSTEM (1, 0)
                                _GL_ARG_NONNULL ((1)));
-_GL_CXXALIAS_RPL (vscanf, int, (const char *format, va_list args));
+_GL_CXXALIAS_RPL (vscanf, int, (const char *restrict format, va_list args));
 # else
-_GL_CXXALIAS_SYS (vscanf, int, (const char *format, va_list args));
+_GL_CXXALIAS_SYS (vscanf, int, (const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vscanf);
+# endif
 #endif
 
 #if @GNULIB_VSNPRINTF@
@@ -1320,23 +1653,30 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define vsnprintf rpl_vsnprintf
 #  endif
+#  define GNULIB_overrides_vsnprintf 1
 _GL_FUNCDECL_RPL (vsnprintf, int,
-                  (char *str, size_t size, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
+                  (char *restrict str, size_t size,
+                   const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (3, 0)
                   _GL_ARG_NONNULL ((3)));
 _GL_CXXALIAS_RPL (vsnprintf, int,
-                  (char *str, size_t size, const char *format, va_list args));
+                  (char *restrict str, size_t size,
+                   const char *restrict format, va_list args));
 # else
 #  if !@HAVE_DECL_VSNPRINTF@
 _GL_FUNCDECL_SYS (vsnprintf, int,
-                  (char *str, size_t size, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0)
+                  (char *restrict str, size_t size,
+                   const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (3, 0)
                   _GL_ARG_NONNULL ((3)));
 #  endif
 _GL_CXXALIAS_SYS (vsnprintf, int,
-                  (char *str, size_t size, const char *format, va_list args));
+                  (char *restrict str, size_t size,
+                   const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vsnprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef vsnprintf
 # if HAVE_RAW_DECL_VSNPRINTF
@@ -1350,20 +1690,26 @@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   define vsprintf rpl_vsprintf
 #  endif
+#  define GNULIB_overrides_vsprintf 1
 _GL_FUNCDECL_RPL (vsprintf, int,
-                  (char *str, const char *format, va_list args)
-                  _GL_ATTRIBUTE_FORMAT_PRINTF (2, 0)
+                  (char *restrict str,
+                   const char *restrict format, va_list args)
+                  _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (2, 0)
                   _GL_ARG_NONNULL ((1, 2)));
 _GL_CXXALIAS_RPL (vsprintf, int,
-                  (char *str, const char *format, va_list args));
+                  (char *restrict str,
+                   const char *restrict format, va_list args));
 # else
 /* Need to cast, because on Solaris, the third parameter is
                                                        __va_list args
    and GCC's fixincludes did not change this to __gnuc_va_list.  */
 _GL_CXXALIAS_SYS_CAST (vsprintf, int,
-                       (char *str, const char *format, va_list args));
+                       (char *restrict str,
+                        const char *restrict format, va_list args));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (vsprintf);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef vsprintf
 /* Assume vsprintf is always declared.  */

_service:tar_scm:groff-1.23.0.tar.gz/lib/stdlib.in.h Added

@@ -0,0 +1,1678 @@
+/* A GNU-like <stdlib.h>.
+
+   Copyright (C) 1995, 2001-2004, 2006-2023 Free Software Foundation, Inc.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#if __GNUC__ >= 3
+@PRAGMA_SYSTEM_HEADER@
+#endif
+@PRAGMA_COLUMNS@
+
+#if defined __need_system_stdlib_h || defined __need_malloc_and_calloc
+/* Special invocation conventions inside some gnulib header files,
+   and inside some glibc header files, respectively.  */
+
+#@INCLUDE_NEXT@ @NEXT_STDLIB_H@
+
+#else
+/* Normal invocation convention.  */
+
+#ifndef _@GUARD_PREFIX@_STDLIB_H
+
+/* The include_next requires a split double-inclusion guard.  */
+#@INCLUDE_NEXT@ @NEXT_STDLIB_H@
+
+#ifndef _@GUARD_PREFIX@_STDLIB_H
+#define _@GUARD_PREFIX@_STDLIB_H
+
+/* NetBSD 5.0 mis-defines NULL.  */
+#include <stddef.h>
+
+/* MirBSD 10 defines WEXITSTATUS in <sys/wait.h>, not in <stdlib.h>.  */
+#if @GNULIB_SYSTEM_POSIX@ && !defined WEXITSTATUS
+# include <sys/wait.h>
+#endif
+
+/* Solaris declares getloadavg() in <sys/loadavg.h>.  */
+#if (@GNULIB_GETLOADAVG@ || defined GNULIB_POSIXCHECK) && @HAVE_SYS_LOADAVG_H@
+/* OpenIndiana has a bug: <sys/time.h> must be included before
+   <sys/loadavg.h>.  */
+# include <sys/time.h>
+# include <sys/loadavg.h>
+#endif
+
+/* Native Windows platforms declare _mktemp() in <io.h>.  */
+#if defined _WIN32 && !defined __CYGWIN__
+# include <io.h>
+#endif
+
+#if @GNULIB_RANDOM_R@
+
+/* OSF/1 5.1 declares 'struct random_data' in <random.h>, which is included
+   from <stdlib.h> if _REENTRANT is defined.  Include it whenever we need
+   'struct random_data'.  */
+# if @HAVE_RANDOM_H@
+#  include <random.h>
+# endif
+
+# if !@HAVE_STRUCT_RANDOM_DATA@ || @REPLACE_RANDOM_R@ || !@HAVE_RANDOM_R@
+#  include <stdint.h>
+# endif
+
+# if !@HAVE_STRUCT_RANDOM_DATA@
+/* Define 'struct random_data'.
+   But allow multiple gnulib generated <stdlib.h> replacements to coexist.  */
+#  if !GNULIB_defined_struct_random_data
+struct random_data
+{
+  int32_t *fptr;                /* Front pointer.  */
+  int32_t *rptr;                /* Rear pointer.  */
+  int32_t *state;               /* Array of state values.  */
+  int rand_type;                /* Type of random number generator.  */
+  int rand_deg;                 /* Degree of random number generator.  */
+  int rand_sep;                 /* Distance between front and rear.  */
+  int32_t *end_ptr;             /* Pointer behind state table.  */
+};
+#   define GNULIB_defined_struct_random_data 1
+#  endif
+# endif
+#endif
+
+#if (@GNULIB_MKSTEMP@ || @GNULIB_MKSTEMPS@ || @GNULIB_MKOSTEMP@ || @GNULIB_MKOSTEMPS@ || @GNULIB_GETSUBOPT@ || defined GNULIB_POSIXCHECK) && ! defined __GLIBC__ && !(defined _WIN32 && ! defined __CYGWIN__)
+/* On Mac OS X 10.3, only <unistd.h> declares mkstemp.  */
+/* On Mac OS X 10.5, only <unistd.h> declares mkstemps.  */
+/* On Mac OS X 10.13, only <unistd.h> declares mkostemp and mkostemps.  */
+/* On Cygwin 1.7.1, only <unistd.h> declares getsubopt.  */
+/* But avoid namespace pollution on glibc systems and native Windows.  */
+# include <unistd.h>
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if __GNUC__ >= 11
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC_FREE
+# define _GL_ATTRIBUTE_DEALLOC_FREE _GL_ATTRIBUTE_DEALLOC (free, 1)
+#endif
+
+/* _GL_ATTRIBUTE_MALLOC declares that the function returns a pointer to freshly
+   allocated memory.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_MALLOC
+# if __GNUC__ >= 3 || defined __clang__
+#  define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
+# else
+#  define _GL_ATTRIBUTE_MALLOC
+# endif
+#endif
+
+/* The __attribute__ feature is available in gcc versions 2.5 and later.
+   The attribute __pure__ was added in gcc 2.96.  */
+#ifndef _GL_ATTRIBUTE_PURE
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) || defined __clang__
+#  define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
+# else
+#  define _GL_ATTRIBUTE_PURE /* empty */
+# endif
+#endif
+
+/* The definition of _Noreturn is copied here.  */
+
+/* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
+
+/* The definition of _GL_ARG_NONNULL is copied here.  */
+
+/* The definition of _GL_WARN_ON_USE is copied here.  */
+
+
+/* Some systems do not define EXIT_*, despite otherwise supporting C89.  */
+#ifndef EXIT_SUCCESS
+# define EXIT_SUCCESS 0
+#endif
+/* Tandem/NSK and other platforms that define EXIT_FAILURE as -1 interfere
+   with proper operation of xargs.  */
+#ifndef EXIT_FAILURE
+# define EXIT_FAILURE 1
+#elif EXIT_FAILURE != 1
+# undef EXIT_FAILURE
+# define EXIT_FAILURE 1
+#endif
+
+
+#if @GNULIB__EXIT@
+/* Terminate the current process with the given return code, without running
+   the 'atexit' handlers.  */
+# if @REPLACE__EXIT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef _Exit
+#   define _Exit rpl__Exit
+#  endif
+_GL_FUNCDECL_RPL (_Exit, _Noreturn void, (int status));
+_GL_CXXALIAS_RPL (_Exit, void, (int status));
+# else
+#  if !@HAVE__EXIT@
+_GL_FUNCDECL_SYS (_Exit, _Noreturn void, (int status));
+#  endif
+_GL_CXXALIAS_SYS (_Exit, void, (int status));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (_Exit);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef _Exit
+# if HAVE_RAW_DECL__EXIT
+_GL_WARN_ON_USE (_Exit, "_Exit is unportable - "
+                 "use gnulib module _Exit for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FREE_POSIX@
+# if @REPLACE_FREE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef free
+#   define free rpl_free
+#  endif
+#  if defined __cplusplus && (__GLIBC__ + (__GLIBC_MINOR__ >= 14) > 2)
+_GL_FUNCDECL_RPL (free, void, (void *ptr) throw ());
+#  else
+_GL_FUNCDECL_RPL (free, void, (void *ptr));
+#  endif
+_GL_CXXALIAS_RPL (free, void, (void *ptr));
+# else
+_GL_CXXALIAS_SYS (free, void, (void *ptr));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (free);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef free
+/* Assume free is always declared.  */
+_GL_WARN_ON_USE (free, "free is not future POSIX compliant everywhere - "
+                 "use gnulib module free for portability");
+#endif
+
+
+/* Allocate memory with indefinite extent and specified alignment.  */
+#if @GNULIB_ALIGNED_ALLOC@
+# if @REPLACE_ALIGNED_ALLOC@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef aligned_alloc
+#   define aligned_alloc rpl_aligned_alloc
+#  endif
+_GL_FUNCDECL_RPL (aligned_alloc, void *,
+                  (size_t alignment, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+_GL_CXXALIAS_RPL (aligned_alloc, void *, (size_t alignment, size_t size));
+# else
+#  if @HAVE_ALIGNED_ALLOC@
+#   if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate aligned_alloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (aligned_alloc, void *,
+                  (size_t alignment, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#   endif
+_GL_CXXALIAS_SYS (aligned_alloc, void *, (size_t alignment, size_t size));
+#  endif
+# endif
+# if (__GLIBC__ >= 2) && @HAVE_ALIGNED_ALLOC@
+_GL_CXXALIASWARN (aligned_alloc);
+# endif
+#else
+# if @GNULIB_FREE_POSIX@ && __GNUC__ >= 11 && !defined aligned_alloc
+/* For -Wmismatched-dealloc: Associate aligned_alloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (aligned_alloc, void *,
+                  (size_t alignment, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef aligned_alloc
+#  if HAVE_RAW_DECL_ALIGNED_ALLOC
+_GL_WARN_ON_USE (aligned_alloc, "aligned_alloc is not portable - "
+                 "use gnulib module aligned_alloc for portability");
+#  endif
+# endif
+#endif
+
+#if @GNULIB_ATOLL@
+/* Parse a signed decimal integer.
+   Returns the value of the integer.  Errors are not detected.  */
+# if !@HAVE_ATOLL@
+_GL_FUNCDECL_SYS (atoll, long long, (const char *string)
+                                    _GL_ATTRIBUTE_PURE
+                                    _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (atoll, long long, (const char *string));
+_GL_CXXALIASWARN (atoll);
+#elif defined GNULIB_POSIXCHECK
+# undef atoll
+# if HAVE_RAW_DECL_ATOLL
+_GL_WARN_ON_USE (atoll, "atoll is unportable - "
+                 "use gnulib module atoll for portability");
+# endif
+#endif
+
+#if @GNULIB_CALLOC_POSIX@
+# if (@GNULIB_CALLOC_POSIX@ && @REPLACE_CALLOC_FOR_CALLOC_POSIX@) \
+     || (@GNULIB_CALLOC_GNU@ && @REPLACE_CALLOC_FOR_CALLOC_GNU@)
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef calloc
+#   define calloc rpl_calloc
+#  endif
+_GL_FUNCDECL_RPL (calloc, void *,
+                  (size_t nmemb, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+_GL_CXXALIAS_RPL (calloc, void *, (size_t nmemb, size_t size));
+# else
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate calloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (calloc, void *,
+                  (size_t nmemb, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#  endif
+_GL_CXXALIAS_SYS (calloc, void *, (size_t nmemb, size_t size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (calloc);
+# endif
+#else
+# if @GNULIB_FREE_POSIX@ && __GNUC__ >= 11 && !defined calloc
+/* For -Wmismatched-dealloc: Associate calloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (calloc, void *,
+                  (size_t nmemb, size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef calloc
+/* Assume calloc is always declared.  */
+_GL_WARN_ON_USE (calloc, "calloc is not POSIX compliant everywhere - "
+                 "use gnulib module calloc-posix for portability");
+# endif
+#endif
+
+#if @GNULIB_CANONICALIZE_FILE_NAME@
+# if @REPLACE_CANONICALIZE_FILE_NAME@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define canonicalize_file_name rpl_canonicalize_file_name
+#  endif
+_GL_FUNCDECL_RPL (canonicalize_file_name, char *,
+                  (const char *name)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+_GL_CXXALIAS_RPL (canonicalize_file_name, char *, (const char *name));
+# else
+#  if !@HAVE_CANONICALIZE_FILE_NAME@ || __GNUC__ >= 11
+_GL_FUNCDECL_SYS (canonicalize_file_name, char *,
+                  (const char *name)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#  endif
+_GL_CXXALIAS_SYS (canonicalize_file_name, char *, (const char *name));
+# endif
+# ifndef GNULIB_defined_canonicalize_file_name
+#  define GNULIB_defined_canonicalize_file_name \
+     (!@HAVE_CANONICALIZE_FILE_NAME@ || @REPLACE_CANONICALIZE_FILE_NAME@)
+# endif
+_GL_CXXALIASWARN (canonicalize_file_name);
+#else
+# if @GNULIB_FREE_POSIX@ && __GNUC__ >= 11 && !defined canonicalize_file_name
+/* For -Wmismatched-dealloc: Associate canonicalize_file_name with free or
+   rpl_free.  */
+_GL_FUNCDECL_SYS (canonicalize_file_name, char *,
+                  (const char *name)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef canonicalize_file_name
+#  if HAVE_RAW_DECL_CANONICALIZE_FILE_NAME
+_GL_WARN_ON_USE (canonicalize_file_name,
+                 "canonicalize_file_name is unportable - "
+                 "use gnulib module canonicalize-lgpl for portability");
+#  endif
+# endif
+#endif
+
+#if @GNULIB_MDA_ECVT@
+/* On native Windows, map 'ecvt' to '_ecvt', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::ecvt on all platforms that have
+   it.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef ecvt
+#   define ecvt _ecvt
+#  endif
+_GL_CXXALIAS_MDA (ecvt, char *,
+                  (double number, int ndigits, int *decptp, int *signp));
+# else
+#  if @HAVE_DECL_ECVT@
+_GL_CXXALIAS_SYS (ecvt, char *,
+                  (double number, int ndigits, int *decptp, int *signp));
+#  endif
+# endif
+# if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_ECVT@
+_GL_CXXALIASWARN (ecvt);
+# endif
+#endif
+
+#if @GNULIB_MDA_FCVT@
+/* On native Windows, map 'fcvt' to '_fcvt', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::fcvt on all platforms that have
+   it.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fcvt
+#   define fcvt _fcvt
+#  endif
+_GL_CXXALIAS_MDA (fcvt, char *,
+                  (double number, int ndigits, int *decptp, int *signp));
+# else
+#  if @HAVE_DECL_FCVT@
+_GL_CXXALIAS_SYS (fcvt, char *,
+                  (double number, int ndigits, int *decptp, int *signp));
+#  endif
+# endif
+# if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_FCVT@
+_GL_CXXALIASWARN (fcvt);
+# endif
+#endif
+
+#if @GNULIB_MDA_GCVT@
+/* On native Windows, map 'gcvt' to '_gcvt', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::gcvt on all platforms that have
+   it.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef gcvt
+#   define gcvt _gcvt
+#  endif
+_GL_CXXALIAS_MDA (gcvt, char *, (double number, int ndigits, char *buf));
+# else
+#  if @HAVE_DECL_GCVT@
+_GL_CXXALIAS_SYS (gcvt, char *, (double number, int ndigits, char *buf));
+#  endif
+# endif
+# if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_GCVT@
+_GL_CXXALIASWARN (gcvt);
+# endif
+#endif
+
+#if @GNULIB_GETLOADAVG@
+/* Store max(NELEM,3) load average numbers in LOADAVG.
+   The three numbers are the load average of the last 1 minute, the last 5
+   minutes, and the last 15 minutes, respectively.
+   LOADAVG is an array of NELEM numbers.  */
+# if @REPLACE_GETLOADAVG@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getloadavg
+#   define getloadavg rpl_getloadavg
+#  endif
+_GL_FUNCDECL_RPL (getloadavg, int, (double loadavg, int nelem)
+                                   _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (getloadavg, int, (double loadavg, int nelem));
+# else
+#  if !@HAVE_DECL_GETLOADAVG@
+_GL_FUNCDECL_SYS (getloadavg, int, (double loadavg, int nelem)
+                                   _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (getloadavg, int, (double loadavg, int nelem));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getloadavg);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getloadavg
+# if HAVE_RAW_DECL_GETLOADAVG
+_GL_WARN_ON_USE (getloadavg, "getloadavg is not portable - "
+                 "use gnulib module getloadavg for portability");
+# endif
+#endif
+
+#if @GNULIB_GETPROGNAME@
+/* Return the base name of the executing program.
+   On native Windows this will usually end in ".exe" or ".EXE". */
+# if @REPLACE_GETPROGNAME@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getprogname
+#   define getprogname rpl_getprogname
+#  endif
+#  ifdef HAVE_DECL_PROGRAM_INVOCATION_NAME
+_GL_FUNCDECL_RPL (getprogname, const char *, (void) _GL_ATTRIBUTE_PURE);
+#  else
+_GL_FUNCDECL_RPL (getprogname, const char *, (void));
+#  endif
+_GL_CXXALIAS_RPL (getprogname, const char *, (void));
+# else
+#  if !@HAVE_GETPROGNAME@
+#   ifdef HAVE_DECL_PROGRAM_INVOCATION_NAME
+_GL_FUNCDECL_SYS (getprogname, const char *, (void) _GL_ATTRIBUTE_PURE);
+#   else
+_GL_FUNCDECL_SYS (getprogname, const char *, (void));
+#   endif
+#  endif
+_GL_CXXALIAS_SYS (getprogname, const char *, (void));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getprogname);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getprogname
+# if HAVE_RAW_DECL_GETPROGNAME
+_GL_WARN_ON_USE (getprogname, "getprogname is unportable - "
+                 "use gnulib module getprogname for portability");
+# endif
+#endif
+
+#if @GNULIB_GETSUBOPT@
+/* Assuming *OPTIONP is a comma separated list of elements of the form
+   "token" or "token=value", getsubopt parses the first of these elements.
+   If the first element refers to a "token" that is member of the given
+   NULL-terminated array of tokens:
+     - It replaces the comma with a NUL byte, updates *OPTIONP to point past
+       the first option and the comma, sets *VALUEP to the value of the
+       element (or NULL if it doesn't contain an "=" sign),
+     - It returns the index of the "token" in the given array of tokens.
+   Otherwise it returns -1, and *OPTIONP and *VALUEP are undefined.
+   For more details see the POSIX specification.
+   https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsubopt.html */
+# if @REPLACE_GETSUBOPT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getsubopt
+#   define getsubopt rpl_getsubopt
+#  endif
+_GL_FUNCDECL_RPL (getsubopt, int,
+                  (char **optionp, char *const *tokens, char **valuep)
+                  _GL_ARG_NONNULL ((1, 2, 3)));
+_GL_CXXALIAS_RPL (getsubopt, int,
+                  (char **optionp, char *const *tokens, char **valuep));
+# else
+#  if !@HAVE_GETSUBOPT@
+_GL_FUNCDECL_SYS (getsubopt, int,
+                  (char **optionp, char *const *tokens, char **valuep)
+                  _GL_ARG_NONNULL ((1, 2, 3)));
+#  endif
+_GL_CXXALIAS_SYS (getsubopt, int,
+                  (char **optionp, char *const *tokens, char **valuep));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getsubopt);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getsubopt
+# if HAVE_RAW_DECL_GETSUBOPT
+_GL_WARN_ON_USE (getsubopt, "getsubopt is unportable - "
+                 "use gnulib module getsubopt for portability");
+# endif
+#endif
+
+#if @GNULIB_GRANTPT@
+/* Change the ownership and access permission of the slave side of the
+   pseudo-terminal whose master side is specified by FD.  */
+# if !@HAVE_GRANTPT@
+_GL_FUNCDECL_SYS (grantpt, int, (int fd));
+# endif
+_GL_CXXALIAS_SYS (grantpt, int, (int fd));
+_GL_CXXALIASWARN (grantpt);
+#elif defined GNULIB_POSIXCHECK
+# undef grantpt
+# if HAVE_RAW_DECL_GRANTPT
+_GL_WARN_ON_USE (grantpt, "grantpt is not portable - "
+                 "use gnulib module grantpt for portability");
+# endif
+#endif
+
+/* If _GL_USE_STDLIB_ALLOC is nonzero, the including module does not
+   rely on GNU or POSIX semantics for malloc and realloc (for example,
+   by never specifying a zero size), so it does not need malloc or
+   realloc to be redefined.  */
+#if @GNULIB_MALLOC_POSIX@
+# if (@GNULIB_MALLOC_POSIX@ && @REPLACE_MALLOC_FOR_MALLOC_POSIX@) \
+     || (@GNULIB_MALLOC_GNU@ && @REPLACE_MALLOC_FOR_MALLOC_GNU@)
+#  if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
+        || _GL_USE_STDLIB_ALLOC)
+#   undef malloc
+#   define malloc rpl_malloc
+#  endif
+_GL_FUNCDECL_RPL (malloc, void *,
+                  (size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+_GL_CXXALIAS_RPL (malloc, void *, (size_t size));
+# else
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate malloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (malloc, void *,
+                  (size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#  endif
+_GL_CXXALIAS_SYS (malloc, void *, (size_t size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (malloc);
+# endif
+#else
+# if @GNULIB_FREE_POSIX@ && __GNUC__ >= 11 && !defined malloc
+/* For -Wmismatched-dealloc: Associate malloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (malloc, void *,
+                  (size_t size)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
+#  undef malloc
+/* Assume malloc is always declared.  */
+_GL_WARN_ON_USE (malloc, "malloc is not POSIX compliant everywhere - "
+                 "use gnulib module malloc-posix for portability");
+# endif
+#endif
+
+/* Convert a multibyte character to a wide character.  */
+#if @GNULIB_MBTOWC@
+# if @REPLACE_MBTOWC@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef mbtowc
+#   define mbtowc rpl_mbtowc
+#  endif
+_GL_FUNCDECL_RPL (mbtowc, int,
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n));
+_GL_CXXALIAS_RPL (mbtowc, int,
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n));
+# else
+#  if !@HAVE_MBTOWC@
+_GL_FUNCDECL_SYS (mbtowc, int,
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n));
+#  endif
+_GL_CXXALIAS_SYS (mbtowc, int,
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (mbtowc);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef mbtowc
+# if HAVE_RAW_DECL_MBTOWC
+_GL_WARN_ON_USE (mbtowc, "mbtowc is not portable - "
+                 "use gnulib module mbtowc for portability");
+# endif
+#endif
+
+#if @GNULIB_MKDTEMP@
+/* Create a unique temporary directory from TEMPLATE.
+   The last six characters of TEMPLATE must be "XXXXXX";
+   they are replaced with a string that makes the directory name unique.
+   Returns TEMPLATE, or a null pointer if it cannot get a unique name.
+   The directory is created mode 700.  */
+# if !@HAVE_MKDTEMP@
+_GL_FUNCDECL_SYS (mkdtemp, char *, (char * /*template*/) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (mkdtemp, char *, (char * /*template*/));
+_GL_CXXALIASWARN (mkdtemp);
+#elif defined GNULIB_POSIXCHECK
+# undef mkdtemp
+# if HAVE_RAW_DECL_MKDTEMP
+_GL_WARN_ON_USE (mkdtemp, "mkdtemp is unportable - "
+                 "use gnulib module mkdtemp for portability");
+# endif
+#endif
+
+#if @GNULIB_MKOSTEMP@
+/* Create a unique temporary file from TEMPLATE.
+   The last six characters of TEMPLATE must be "XXXXXX";
+   they are replaced with a string that makes the file name unique.
+   The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
+   and O_TEXT, O_BINARY (defined in "binary-io.h").
+   The file is then created, with the specified flags, ensuring it didn't exist
+   before.
+   The file is created read-write (mask at least 0600 & ~umask), but it may be
+   world-readable and world-writable (mask 0666 & ~umask), depending on the
+   implementation.
+   Returns the open file descriptor if successful, otherwise -1 and errno
+   set.  */
+# if @REPLACE_MKOSTEMP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef mkostemp
+#   define mkostemp rpl_mkostemp
+#  endif
+_GL_FUNCDECL_RPL (mkostemp, int, (char * /*template*/, int /*flags*/)
+                                 _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (mkostemp, int, (char * /*template*/, int /*flags*/));
+# else
+#  if !@HAVE_MKOSTEMP@
+_GL_FUNCDECL_SYS (mkostemp, int, (char * /*template*/, int /*flags*/)
+                                 _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (mkostemp, int, (char * /*template*/, int /*flags*/));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (mkostemp);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef mkostemp
+# if HAVE_RAW_DECL_MKOSTEMP
+_GL_WARN_ON_USE (mkostemp, "mkostemp is unportable - "
+                 "use gnulib module mkostemp for portability");
+# endif
+#endif
+
+#if @GNULIB_MKOSTEMPS@
+/* Create a unique temporary file from TEMPLATE.
+   The last six characters of TEMPLATE before a suffix of length
+   SUFFIXLEN must be "XXXXXX";
+   they are replaced with a string that makes the file name unique.
+   The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
+   and O_TEXT, O_BINARY (defined in "binary-io.h").
+   The file is then created, with the specified flags, ensuring it didn't exist
+   before.
+   The file is created read-write (mask at least 0600 & ~umask), but it may be
+   world-readable and world-writable (mask 0666 & ~umask), depending on the
+   implementation.
+   Returns the open file descriptor if successful, otherwise -1 and errno
+   set.  */
+# if @REPLACE_MKOSTEMPS@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef mkostemps
+#   define mkostemps rpl_mkostemps
+#  endif
+_GL_FUNCDECL_RPL (mkostemps, int,
+                  (char * /*template*/, int /*suffixlen*/, int /*flags*/)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (mkostemps, int,
+                  (char * /*template*/, int /*suffixlen*/, int /*flags*/));
+# else
+#  if !@HAVE_MKOSTEMPS@
+_GL_FUNCDECL_SYS (mkostemps, int,
+                  (char * /*template*/, int /*suffixlen*/, int /*flags*/)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (mkostemps, int,
+                  (char * /*template*/, int /*suffixlen*/, int /*flags*/));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (mkostemps);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef mkostemps
+# if HAVE_RAW_DECL_MKOSTEMPS
+_GL_WARN_ON_USE (mkostemps, "mkostemps is unportable - "
+                 "use gnulib module mkostemps for portability");
+# endif
+#endif
+
+#if @GNULIB_MKSTEMP@
+/* Create a unique temporary file from TEMPLATE.
+   The last six characters of TEMPLATE must be "XXXXXX";
+   they are replaced with a string that makes the file name unique.
+   The file is then created, ensuring it didn't exist before.
+   The file is created read-write (mask at least 0600 & ~umask), but it may be
+   world-readable and world-writable (mask 0666 & ~umask), depending on the
+   implementation.
+   Returns the open file descriptor if successful, otherwise -1 and errno
+   set.  */
+# if @REPLACE_MKSTEMP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define mkstemp rpl_mkstemp
+#  endif
+_GL_FUNCDECL_RPL (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (mkstemp, int, (char * /*template*/));
+# else
+#  if ! @HAVE_MKSTEMP@
+_GL_FUNCDECL_SYS (mkstemp, int, (char * /*template*/) _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (mkstemp, int, (char * /*template*/));
+# endif
+_GL_CXXALIASWARN (mkstemp);
+#elif defined GNULIB_POSIXCHECK
+# undef mkstemp
+# if HAVE_RAW_DECL_MKSTEMP
+_GL_WARN_ON_USE (mkstemp, "mkstemp is unportable - "
+                 "use gnulib module mkstemp for portability");
+# endif
+#endif
+
+#if @GNULIB_MKSTEMPS@
+/* Create a unique temporary file from TEMPLATE.
+   The last six characters of TEMPLATE prior to a suffix of length
+   SUFFIXLEN must be "XXXXXX";
+   they are replaced with a string that makes the file name unique.
+   The file is then created, ensuring it didn't exist before.
+   The file is created read-write (mask at least 0600 & ~umask), but it may be
+   world-readable and world-writable (mask 0666 & ~umask), depending on the
+   implementation.
+   Returns the open file descriptor if successful, otherwise -1 and errno
+   set.  */
+# if !@HAVE_MKSTEMPS@
+_GL_FUNCDECL_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/)
+                                 _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (mkstemps, int, (char * /*template*/, int /*suffixlen*/));
+_GL_CXXALIASWARN (mkstemps);
+#elif defined GNULIB_POSIXCHECK
+# undef mkstemps
+# if HAVE_RAW_DECL_MKSTEMPS
+_GL_WARN_ON_USE (mkstemps, "mkstemps is unportable - "
+                 "use gnulib module mkstemps for portability");
+# endif
+#endif
+
+#if @GNULIB_MDA_MKTEMP@
+/* On native Windows, map 'mktemp' to '_mktemp', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::mktemp always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef mktemp
+#   define mktemp _mktemp
+#  endif
+_GL_CXXALIAS_MDA (mktemp, char *, (char * /*template*/));
+# else
+_GL_CXXALIAS_SYS (mktemp, char *, (char * /*template*/));
+# endif
+_GL_CXXALIASWARN (mktemp);
+#endif
+
+/* Allocate memory with indefinite extent and specified alignment.  */
+#if @GNULIB_POSIX_MEMALIGN@
+# if @REPLACE_POSIX_MEMALIGN@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef posix_memalign
+#   define posix_memalign rpl_posix_memalign
+#  endif
+_GL_FUNCDECL_RPL (posix_memalign, int,
+                  (void **memptr, size_t alignment, size_t size)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (posix_memalign, int,
+                  (void **memptr, size_t alignment, size_t size));
+# else
+#  if @HAVE_POSIX_MEMALIGN@
+_GL_CXXALIAS_SYS (posix_memalign, int,
+                  (void **memptr, size_t alignment, size_t size));
+#  endif
+# endif
+# if __GLIBC__ >= 2 && @HAVE_POSIX_MEMALIGN@
+_GL_CXXALIASWARN (posix_memalign);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef posix_memalign
+# if HAVE_RAW_DECL_POSIX_MEMALIGN
+_GL_WARN_ON_USE (posix_memalign, "posix_memalign is not portable - "
+                 "use gnulib module posix_memalign for portability");
+# endif
+#endif
+
+#if @GNULIB_POSIX_OPENPT@
+/* Return an FD open to the master side of a pseudo-terminal.  Flags should
+   include O_RDWR, and may also include O_NOCTTY.  */
+# if @REPLACE_POSIX_OPENPT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef posix_openpt
+#   define posix_openpt rpl_posix_openpt
+#  endif
+_GL_FUNCDECL_RPL (posix_openpt, int, (int flags));
+_GL_CXXALIAS_RPL (posix_openpt, int, (int flags));
+# else
+#  if !@HAVE_POSIX_OPENPT@
+_GL_FUNCDECL_SYS (posix_openpt, int, (int flags));
+#  endif
+_GL_CXXALIAS_SYS (posix_openpt, int, (int flags));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (posix_openpt);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef posix_openpt
+# if HAVE_RAW_DECL_POSIX_OPENPT
+_GL_WARN_ON_USE (posix_openpt, "posix_openpt is not portable - "
+                 "use gnulib module posix_openpt for portability");
+# endif
+#endif
+
+#if @GNULIB_PTSNAME@
+/* Return the pathname of the pseudo-terminal slave associated with
+   the master FD is open on, or NULL on errors.  */
+# if @REPLACE_PTSNAME@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef ptsname
+#   define ptsname rpl_ptsname
+#  endif
+_GL_FUNCDECL_RPL (ptsname, char *, (int fd));
+_GL_CXXALIAS_RPL (ptsname, char *, (int fd));
+# else
+#  if !@HAVE_PTSNAME@
+_GL_FUNCDECL_SYS (ptsname, char *, (int fd));
+#  endif
+_GL_CXXALIAS_SYS (ptsname, char *, (int fd));
+# endif
+_GL_CXXALIASWARN (ptsname);
+#elif defined GNULIB_POSIXCHECK
+# undef ptsname
+# if HAVE_RAW_DECL_PTSNAME
+_GL_WARN_ON_USE (ptsname, "ptsname is not portable - "
+                 "use gnulib module ptsname for portability");
+# endif
+#endif
+
+#if @GNULIB_PTSNAME_R@
+/* Set the pathname of the pseudo-terminal slave associated with
+   the master FD is open on and return 0, or set errno and return
+   non-zero on errors.  */
+# if @REPLACE_PTSNAME_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef ptsname_r
+#   define ptsname_r rpl_ptsname_r
+#  endif
+_GL_FUNCDECL_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
+_GL_CXXALIAS_RPL (ptsname_r, int, (int fd, char *buf, size_t len));
+# else
+#  if !@HAVE_PTSNAME_R@
+_GL_FUNCDECL_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
+#  endif
+_GL_CXXALIAS_SYS (ptsname_r, int, (int fd, char *buf, size_t len));
+# endif
+# ifndef GNULIB_defined_ptsname_r
+#  define GNULIB_defined_ptsname_r (!@HAVE_PTSNAME_R@ || @REPLACE_PTSNAME_R@)
+# endif
+_GL_CXXALIASWARN (ptsname_r);
+#elif defined GNULIB_POSIXCHECK
+# undef ptsname_r
+# if HAVE_RAW_DECL_PTSNAME_R
+_GL_WARN_ON_USE (ptsname_r, "ptsname_r is not portable - "
+                 "use gnulib module ptsname_r for portability");
+# endif
+#endif
+
+#if @GNULIB_PUTENV@
+# if @REPLACE_PUTENV@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef putenv
+#   define putenv rpl_putenv
+#  endif
+_GL_FUNCDECL_RPL (putenv, int, (char *string) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (putenv, int, (char *string));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef putenv
+#   define putenv _putenv
+#  endif
+_GL_CXXALIAS_MDA (putenv, int, (char *string));
+# else
+_GL_CXXALIAS_SYS (putenv, int, (char *string));
+# endif
+_GL_CXXALIASWARN (putenv);
+#elif @GNULIB_MDA_PUTENV@
+/* On native Windows, map 'putenv' to '_putenv', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::putenv always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef putenv
+#   define putenv _putenv
+#  endif
+/* Need to cast, because on mingw, the parameter is either
+   'const char *string' or 'char *string'.  */
+_GL_CXXALIAS_MDA_CAST (putenv, int, (char *string));
+# else
+_GL_CXXALIAS_SYS (putenv, int, (char *string));
+# endif
+_GL_CXXALIASWARN (putenv);
+#endif
+
+#if @GNULIB_QSORT_R@
+/* Sort an array of NMEMB elements, starting at address BASE, each element
+   occupying SIZE bytes, in ascending order according to the comparison
+   function COMPARE.  */
+# ifdef __cplusplus
+extern "C" {
+# endif
+# if !GNULIB_defined_qsort_r_fn_types
+typedef int (*_gl_qsort_r_compar_fn) (void const *, void const *, void *);
+#  define GNULIB_defined_qsort_r_fn_types 1
+# endif
+# ifdef __cplusplus
+}
+# endif
+# if @REPLACE_QSORT_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef qsort_r
+#   define qsort_r rpl_qsort_r
+#  endif
+_GL_FUNCDECL_RPL (qsort_r, void, (void *base, size_t nmemb, size_t size,
+                                  _gl_qsort_r_compar_fn compare,
+                                  void *arg) _GL_ARG_NONNULL ((1, 4)));
+_GL_CXXALIAS_RPL (qsort_r, void, (void *base, size_t nmemb, size_t size,
+                                  _gl_qsort_r_compar_fn compare,
+                                  void *arg));
+# else
+#  if !@HAVE_QSORT_R@
+_GL_FUNCDECL_SYS (qsort_r, void, (void *base, size_t nmemb, size_t size,
+                                  _gl_qsort_r_compar_fn compare,
+                                  void *arg) _GL_ARG_NONNULL ((1, 4)));
+#  endif
+_GL_CXXALIAS_SYS (qsort_r, void, (void *base, size_t nmemb, size_t size,
+                                  _gl_qsort_r_compar_fn compare,
+                                  void *arg));
+# endif
+_GL_CXXALIASWARN (qsort_r);
+#elif defined GNULIB_POSIXCHECK
+# undef qsort_r
+# if HAVE_RAW_DECL_QSORT_R
+_GL_WARN_ON_USE (qsort_r, "qsort_r is not portable - "
+                 "use gnulib module qsort_r for portability");
+# endif
+#endif
+
+
+#if @GNULIB_RANDOM_R@
+# if !@HAVE_RANDOM_R@
+#  ifndef RAND_MAX
+#   define RAND_MAX 2147483647
+#  endif
+# endif
+#endif
+
+
+#if @GNULIB_RANDOM@
+# if @REPLACE_RANDOM@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef random
+#   define random rpl_random
+#  endif
+_GL_FUNCDECL_RPL (random, long, (void));
+_GL_CXXALIAS_RPL (random, long, (void));
+# else
+#  if !@HAVE_RANDOM@
+_GL_FUNCDECL_SYS (random, long, (void));
+#  endif
+/* Need to cast, because on Haiku, the return type is
+                               int.  */
+_GL_CXXALIAS_SYS_CAST (random, long, (void));
+# endif
+_GL_CXXALIASWARN (random);
+#elif defined GNULIB_POSIXCHECK
+# undef random
+# if HAVE_RAW_DECL_RANDOM
+_GL_WARN_ON_USE (random, "random is unportable - "
+                 "use gnulib module random for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM@
+# if @REPLACE_RANDOM@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef srandom
+#   define srandom rpl_srandom
+#  endif
+_GL_FUNCDECL_RPL (srandom, void, (unsigned int seed));
+_GL_CXXALIAS_RPL (srandom, void, (unsigned int seed));
+# else
+#  if !@HAVE_RANDOM@
+_GL_FUNCDECL_SYS (srandom, void, (unsigned int seed));
+#  endif
+/* Need to cast, because on FreeBSD, the first parameter is
+                                       unsigned long seed.  */
+_GL_CXXALIAS_SYS_CAST (srandom, void, (unsigned int seed));
+# endif
+_GL_CXXALIASWARN (srandom);
+#elif defined GNULIB_POSIXCHECK
+# undef srandom
+# if HAVE_RAW_DECL_SRANDOM
+_GL_WARN_ON_USE (srandom, "srandom is unportable - "
+                 "use gnulib module random for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM@
+# if @REPLACE_INITSTATE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef initstate
+#   define initstate rpl_initstate
+#  endif
+_GL_FUNCDECL_RPL (initstate, char *,
+                  (unsigned int seed, char *buf, size_t buf_size)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (initstate, char *,
+                  (unsigned int seed, char *buf, size_t buf_size));
+# else
+#  if !@HAVE_INITSTATE@ || !@HAVE_DECL_INITSTATE@
+_GL_FUNCDECL_SYS (initstate, char *,
+                  (unsigned int seed, char *buf, size_t buf_size)
+                  _GL_ARG_NONNULL ((2)));
+#  endif
+/* Need to cast, because on FreeBSD, the first parameter is
+                        unsigned long seed.  */
+_GL_CXXALIAS_SYS_CAST (initstate, char *,
+                       (unsigned int seed, char *buf, size_t buf_size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (initstate);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef initstate
+# if HAVE_RAW_DECL_INITSTATE
+_GL_WARN_ON_USE (initstate, "initstate is unportable - "
+                 "use gnulib module random for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM@
+# if @REPLACE_SETSTATE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef setstate
+#   define setstate rpl_setstate
+#  endif
+_GL_FUNCDECL_RPL (setstate, char *, (char *arg_state) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (setstate, char *, (char *arg_state));
+# else
+#  if !@HAVE_SETSTATE@ || !@HAVE_DECL_SETSTATE@
+_GL_FUNCDECL_SYS (setstate, char *, (char *arg_state) _GL_ARG_NONNULL ((1)));
+#  endif
+/* Need to cast, because on Mac OS X 10.13, HP-UX, Solaris the first parameter
+   is                                     const char *arg_state.  */
+_GL_CXXALIAS_SYS_CAST (setstate, char *, (char *arg_state));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (setstate);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef setstate
+# if HAVE_RAW_DECL_SETSTATE
+_GL_WARN_ON_USE (setstate, "setstate is unportable - "
+                 "use gnulib module random for portability");
+# endif
+#endif
+
+
+#if @GNULIB_RANDOM_R@
+# if @REPLACE_RANDOM_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef random_r
+#   define random_r rpl_random_r
+#  endif
+_GL_FUNCDECL_RPL (random_r, int, (struct random_data *buf, int32_t *result)
+                                 _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (random_r, int, (struct random_data *buf, int32_t *result));
+# else
+#  if !@HAVE_RANDOM_R@
+_GL_FUNCDECL_SYS (random_r, int, (struct random_data *buf, int32_t *result)
+                                 _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (random_r, int, (struct random_data *buf, int32_t *result));
+# endif
+_GL_CXXALIASWARN (random_r);
+#elif defined GNULIB_POSIXCHECK
+# undef random_r
+# if HAVE_RAW_DECL_RANDOM_R
+_GL_WARN_ON_USE (random_r, "random_r is unportable - "
+                 "use gnulib module random_r for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM_R@
+# if @REPLACE_RANDOM_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef srandom_r
+#   define srandom_r rpl_srandom_r
+#  endif
+_GL_FUNCDECL_RPL (srandom_r, int,
+                  (unsigned int seed, struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (srandom_r, int,
+                  (unsigned int seed, struct random_data *rand_state));
+# else
+#  if !@HAVE_RANDOM_R@
+_GL_FUNCDECL_SYS (srandom_r, int,
+                  (unsigned int seed, struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (srandom_r, int,
+                  (unsigned int seed, struct random_data *rand_state));
+# endif
+_GL_CXXALIASWARN (srandom_r);
+#elif defined GNULIB_POSIXCHECK
+# undef srandom_r
+# if HAVE_RAW_DECL_SRANDOM_R
+_GL_WARN_ON_USE (srandom_r, "srandom_r is unportable - "
+                 "use gnulib module random_r for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM_R@
+# if @REPLACE_RANDOM_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef initstate_r
+#   define initstate_r rpl_initstate_r
+#  endif
+_GL_FUNCDECL_RPL (initstate_r, int,
+                  (unsigned int seed, char *buf, size_t buf_size,
+                   struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((2, 4)));
+_GL_CXXALIAS_RPL (initstate_r, int,
+                  (unsigned int seed, char *buf, size_t buf_size,
+                   struct random_data *rand_state));
+# else
+#  if !@HAVE_RANDOM_R@
+_GL_FUNCDECL_SYS (initstate_r, int,
+                  (unsigned int seed, char *buf, size_t buf_size,
+                   struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((2, 4)));
+#  endif
+/* Need to cast, because on Haiku, the third parameter is
+                                                     unsigned long buf_size.  */
+_GL_CXXALIAS_SYS_CAST (initstate_r, int,
+                       (unsigned int seed, char *buf, size_t buf_size,
+                        struct random_data *rand_state));
+# endif
+_GL_CXXALIASWARN (initstate_r);
+#elif defined GNULIB_POSIXCHECK
+# undef initstate_r
+# if HAVE_RAW_DECL_INITSTATE_R
+_GL_WARN_ON_USE (initstate_r, "initstate_r is unportable - "
+                 "use gnulib module random_r for portability");
+# endif
+#endif
+
+#if @GNULIB_RANDOM_R@
+# if @REPLACE_RANDOM_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef setstate_r
+#   define setstate_r rpl_setstate_r
+#  endif
+_GL_FUNCDECL_RPL (setstate_r, int,
+                  (char *arg_state, struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (setstate_r, int,
+                  (char *arg_state, struct random_data *rand_state));
+# else
+#  if !@HAVE_RANDOM_R@
+_GL_FUNCDECL_SYS (setstate_r, int,
+                  (char *arg_state, struct random_data *rand_state)
+                  _GL_ARG_NONNULL ((1, 2)));
+#  endif
+/* Need to cast, because on Haiku, the first parameter is
+                        void *arg_state.  */
+_GL_CXXALIAS_SYS_CAST (setstate_r, int,
+                       (char *arg_state, struct random_data *rand_state));
+# endif
+_GL_CXXALIASWARN (setstate_r);
+#elif defined GNULIB_POSIXCHECK
+# undef setstate_r
+# if HAVE_RAW_DECL_SETSTATE_R
+_GL_WARN_ON_USE (setstate_r, "setstate_r is unportable - "
+                 "use gnulib module random_r for portability");
+# endif
+#endif
+
+
+#if @GNULIB_REALLOC_POSIX@
+# if (@GNULIB_REALLOC_POSIX@ && @REPLACE_REALLOC_FOR_REALLOC_POSIX@) \
+     || (@GNULIB_REALLOC_GNU@ && @REPLACE_REALLOC_FOR_REALLOC_GNU@)
+#  if !((defined __cplusplus && defined GNULIB_NAMESPACE) \
+        || _GL_USE_STDLIB_ALLOC)
+#   undef realloc
+#   define realloc rpl_realloc
+#  endif
+_GL_FUNCDECL_RPL (realloc, void *, (void *ptr, size_t size)
+                                   _GL_ATTRIBUTE_DEALLOC_FREE);
+_GL_CXXALIAS_RPL (realloc, void *, (void *ptr, size_t size));
+# else
+#  if __GNUC__ >= 11
+/* For -Wmismatched-dealloc: Associate realloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (realloc, void *, (void *ptr, size_t size)
+                                   _GL_ATTRIBUTE_DEALLOC_FREE);
+#  endif
+_GL_CXXALIAS_SYS (realloc, void *, (void *ptr, size_t size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (realloc);
+# endif
+#else
+# if @GNULIB_FREE_POSIX@ && __GNUC__ >= 11 && !defined realloc
+/* For -Wmismatched-dealloc: Associate realloc with free or rpl_free.  */
+_GL_FUNCDECL_SYS (realloc, void *, (void *ptr, size_t size)
+                                   _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK && !_GL_USE_STDLIB_ALLOC
+#  undef realloc
+/* Assume realloc is always declared.  */
+_GL_WARN_ON_USE (realloc, "realloc is not POSIX compliant everywhere - "
+                 "use gnulib module realloc-posix for portability");
+# endif
+#endif
+
+
+#if @GNULIB_REALLOCARRAY@
+# if @REPLACE_REALLOCARRAY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef reallocarray
+#   define reallocarray rpl_reallocarray
+#  endif
+_GL_FUNCDECL_RPL (reallocarray, void *,
+                  (void *ptr, size_t nmemb, size_t size));
+_GL_CXXALIAS_RPL (reallocarray, void *,
+                  (void *ptr, size_t nmemb, size_t size));
+# else
+#  if ! @HAVE_REALLOCARRAY@
+_GL_FUNCDECL_SYS (reallocarray, void *,
+                  (void *ptr, size_t nmemb, size_t size));
+#  endif
+_GL_CXXALIAS_SYS (reallocarray, void *,
+                  (void *ptr, size_t nmemb, size_t size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (reallocarray);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef reallocarray
+# if HAVE_RAW_DECL_REALLOCARRAY
+_GL_WARN_ON_USE (reallocarray, "reallocarray is not portable - "
+                 "use gnulib module reallocarray for portability");
+# endif
+#endif
+
+#if @GNULIB_REALPATH@
+# if @REPLACE_REALPATH@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define realpath rpl_realpath
+#  endif
+_GL_FUNCDECL_RPL (realpath, char *,
+                  (const char *restrict name, char *restrict resolved)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (realpath, char *,
+                  (const char *restrict name, char *restrict resolved));
+# else
+#  if !@HAVE_REALPATH@
+_GL_FUNCDECL_SYS (realpath, char *,
+                  (const char *restrict name, char *restrict resolved)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (realpath, char *,
+                  (const char *restrict name, char *restrict resolved));
+# endif
+_GL_CXXALIASWARN (realpath);
+#elif defined GNULIB_POSIXCHECK
+# undef realpath
+# if HAVE_RAW_DECL_REALPATH
+_GL_WARN_ON_USE (realpath, "realpath is unportable - use gnulib module "
+                 "canonicalize or canonicalize-lgpl for portability");
+# endif
+#endif
+
+#if @GNULIB_RPMATCH@
+/* Test a user response to a question.
+   Return 1 if it is affirmative, 0 if it is negative, or -1 if not clear.  */
+# if !@HAVE_RPMATCH@
+_GL_FUNCDECL_SYS (rpmatch, int, (const char *response) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (rpmatch, int, (const char *response));
+_GL_CXXALIASWARN (rpmatch);
+#elif defined GNULIB_POSIXCHECK
+# undef rpmatch
+# if HAVE_RAW_DECL_RPMATCH
+_GL_WARN_ON_USE (rpmatch, "rpmatch is unportable - "
+                 "use gnulib module rpmatch for portability");
+# endif
+#endif
+
+#if @GNULIB_SECURE_GETENV@
+/* Look up NAME in the environment, returning 0 in insecure situations.  */
+# if !@HAVE_SECURE_GETENV@
+_GL_FUNCDECL_SYS (secure_getenv, char *,
+                  (char const *name) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (secure_getenv, char *, (char const *name));
+_GL_CXXALIASWARN (secure_getenv);
+#elif defined GNULIB_POSIXCHECK
+# undef secure_getenv
+# if HAVE_RAW_DECL_SECURE_GETENV
+_GL_WARN_ON_USE (secure_getenv, "secure_getenv is unportable - "
+                 "use gnulib module secure_getenv for portability");
+# endif
+#endif
+
+#if @GNULIB_SETENV@
+/* Set NAME to VALUE in the environment.
+   If REPLACE is nonzero, overwrite an existing value.  */
+# if @REPLACE_SETENV@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef setenv
+#   define setenv rpl_setenv
+#  endif
+_GL_FUNCDECL_RPL (setenv, int,
+                  (const char *name, const char *value, int replace)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (setenv, int,
+                  (const char *name, const char *value, int replace));
+# else
+#  if !@HAVE_DECL_SETENV@
+_GL_FUNCDECL_SYS (setenv, int,
+                  (const char *name, const char *value, int replace)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (setenv, int,
+                  (const char *name, const char *value, int replace));
+# endif
+# if !(@REPLACE_SETENV@ && !@HAVE_DECL_SETENV@)
+_GL_CXXALIASWARN (setenv);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef setenv
+# if HAVE_RAW_DECL_SETENV
+_GL_WARN_ON_USE (setenv, "setenv is unportable - "
+                 "use gnulib module setenv for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOD@
+ /* Parse a double from STRING, updating ENDP if appropriate.  */
+# if @REPLACE_STRTOD@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtod rpl_strtod
+#  endif
+#  define GNULIB_defined_strtod_function 1
+_GL_FUNCDECL_RPL (strtod, double,
+                  (const char *restrict str, char **restrict endp)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtod, double,
+                  (const char *restrict str, char **restrict endp));
+# else
+#  if !@HAVE_STRTOD@
+_GL_FUNCDECL_SYS (strtod, double,
+                  (const char *restrict str, char **restrict endp)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtod, double,
+                  (const char *restrict str, char **restrict endp));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (strtod);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef strtod
+# if HAVE_RAW_DECL_STRTOD
+_GL_WARN_ON_USE (strtod, "strtod is unportable - "
+                 "use gnulib module strtod for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOLD@
+ /* Parse a 'long double' from STRING, updating ENDP if appropriate.  */
+# if @REPLACE_STRTOLD@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtold rpl_strtold
+#  endif
+#  define GNULIB_defined_strtold_function 1
+_GL_FUNCDECL_RPL (strtold, long double,
+                  (const char *restrict str, char **restrict endp)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtold, long double,
+                  (const char *restrict str, char **restrict endp));
+# else
+#  if !@HAVE_STRTOLD@
+_GL_FUNCDECL_SYS (strtold, long double,
+                  (const char *restrict str, char **restrict endp)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtold, long double,
+                  (const char *restrict str, char **restrict endp));
+# endif
+_GL_CXXALIASWARN (strtold);
+#elif defined GNULIB_POSIXCHECK
+# undef strtold
+# if HAVE_RAW_DECL_STRTOLD
+_GL_WARN_ON_USE (strtold, "strtold is unportable - "
+                 "use gnulib module strtold for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOL@
+/* Parse a signed integer whose textual representation starts at STRING.
+   The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
+   it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
+   "0x").
+   If ENDPTR is not NULL, the address of the first byte after the integer is
+   stored in *ENDPTR.
+   Upon overflow, the return value is LONG_MAX or LONG_MIN, and errno is set
+   to ERANGE.  */
+# if @REPLACE_STRTOL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtol rpl_strtol
+#  endif
+#  define GNULIB_defined_strtol_function 1
+_GL_FUNCDECL_RPL (strtol, long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtol, long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# else
+#  if !@HAVE_STRTOL@
+_GL_FUNCDECL_SYS (strtol, long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtol, long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (strtol);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef strtol
+# if HAVE_RAW_DECL_STRTOL
+_GL_WARN_ON_USE (strtol, "strtol is unportable - "
+                 "use gnulib module strtol for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOLL@
+/* Parse a signed integer whose textual representation starts at STRING.
+   The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
+   it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
+   "0x").
+   If ENDPTR is not NULL, the address of the first byte after the integer is
+   stored in *ENDPTR.
+   Upon overflow, the return value is LLONG_MAX or LLONG_MIN, and errno is set
+   to ERANGE.  */
+# if @REPLACE_STRTOLL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtoll rpl_strtoll
+#  endif
+#  define GNULIB_defined_strtoll_function 1
+_GL_FUNCDECL_RPL (strtoll, long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtoll, long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# else
+#  if !@HAVE_STRTOLL@
+_GL_FUNCDECL_SYS (strtoll, long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtoll, long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# endif
+_GL_CXXALIASWARN (strtoll);
+#elif defined GNULIB_POSIXCHECK
+# undef strtoll
+# if HAVE_RAW_DECL_STRTOLL
+_GL_WARN_ON_USE (strtoll, "strtoll is unportable - "
+                 "use gnulib module strtoll for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOUL@
+/* Parse an unsigned integer whose textual representation starts at STRING.
+   The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
+   it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
+   "0x").
+   If ENDPTR is not NULL, the address of the first byte after the integer is
+   stored in *ENDPTR.
+   Upon overflow, the return value is ULONG_MAX, and errno is set to ERANGE.  */
+# if @REPLACE_STRTOUL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtoul rpl_strtoul
+#  endif
+#  define GNULIB_defined_strtoul_function 1
+_GL_FUNCDECL_RPL (strtoul, unsigned long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtoul, unsigned long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# else
+#  if !@HAVE_STRTOUL@
+_GL_FUNCDECL_SYS (strtoul, unsigned long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtoul, unsigned long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (strtoul);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef strtoul
+# if HAVE_RAW_DECL_STRTOUL
+_GL_WARN_ON_USE (strtoul, "strtoul is unportable - "
+                 "use gnulib module strtoul for portability");
+# endif
+#endif
+
+#if @GNULIB_STRTOULL@
+/* Parse an unsigned integer whose textual representation starts at STRING.
+   The integer is expected to be in base BASE (2 <= BASE <= 36); if BASE == 0,
+   it may be decimal or octal (with prefix "0") or hexadecimal (with prefix
+   "0x").
+   If ENDPTR is not NULL, the address of the first byte after the integer is
+   stored in *ENDPTR.
+   Upon overflow, the return value is ULLONG_MAX, and errno is set to
+   ERANGE.  */
+# if @REPLACE_STRTOULL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define strtoull rpl_strtoull
+#  endif
+#  define GNULIB_defined_strtoull_function 1
+_GL_FUNCDECL_RPL (strtoull, unsigned long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (strtoull, unsigned long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# else
+#  if !@HAVE_STRTOULL@
+_GL_FUNCDECL_SYS (strtoull, unsigned long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base)
+                  _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (strtoull, unsigned long long,
+                  (const char *restrict string, char **restrict endptr,
+                   int base));
+# endif
+_GL_CXXALIASWARN (strtoull);
+#elif defined GNULIB_POSIXCHECK
+# undef strtoull
+# if HAVE_RAW_DECL_STRTOULL
+_GL_WARN_ON_USE (strtoull, "strtoull is unportable - "
+                 "use gnulib module strtoull for portability");
+# endif
+#endif
+
+#if @GNULIB_UNLOCKPT@
+/* Unlock the slave side of the pseudo-terminal whose master side is specified
+   by FD, so that it can be opened.  */
+# if !@HAVE_UNLOCKPT@
+_GL_FUNCDECL_SYS (unlockpt, int, (int fd));
+# endif
+_GL_CXXALIAS_SYS (unlockpt, int, (int fd));
+_GL_CXXALIASWARN (unlockpt);
+#elif defined GNULIB_POSIXCHECK
+# undef unlockpt
+# if HAVE_RAW_DECL_UNLOCKPT
+_GL_WARN_ON_USE (unlockpt, "unlockpt is not portable - "
+                 "use gnulib module unlockpt for portability");
+# endif
+#endif
+
+#if @GNULIB_UNSETENV@
+/* Remove the variable NAME from the environment.  */
+# if @REPLACE_UNSETENV@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef unsetenv
+#   define unsetenv rpl_unsetenv
+#  endif
+_GL_FUNCDECL_RPL (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (unsetenv, int, (const char *name));
+# else
+#  if !@HAVE_DECL_UNSETENV@
+_GL_FUNCDECL_SYS (unsetenv, int, (const char *name) _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (unsetenv, int, (const char *name));
+# endif
+# if !(@REPLACE_UNSETENV@ && !@HAVE_DECL_UNSETENV@)
+_GL_CXXALIASWARN (unsetenv);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef unsetenv
+# if HAVE_RAW_DECL_UNSETENV
+_GL_WARN_ON_USE (unsetenv, "unsetenv is unportable - "
+                 "use gnulib module unsetenv for portability");
+# endif
+#endif
+
+/* Convert a wide character to a multibyte character.  */
+#if @GNULIB_WCTOMB@
+# if @REPLACE_WCTOMB@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef wctomb
+#   define wctomb rpl_wctomb
+#  endif
+_GL_FUNCDECL_RPL (wctomb, int, (char *s, wchar_t wc));
+_GL_CXXALIAS_RPL (wctomb, int, (char *s, wchar_t wc));
+# else
+_GL_CXXALIAS_SYS (wctomb, int, (char *s, wchar_t wc));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (wctomb);
+# endif
+#endif
+
+
+#endif /* _@GUARD_PREFIX@_STDLIB_H */
+#endif /* _@GUARD_PREFIX@_STDLIB_H */
+#endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/streq.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/streq.h Changed

@@ -1,17 +1,17 @@
 /* Optimized string comparison.
-   Copyright (C) 2001-2002, 2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2001-2002, 2007, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible <bruno@clisp.org>.  */
@@ -29,7 +29,7 @@
 
 /* Help GCC to generate good code for string comparisons with
    immediate strings. */
-#if defined (__GNUC__) && defined (__OPTIMIZE__)
+#if (defined __GNUC__ || defined __clang__) && defined __OPTIMIZE__
 
 static inline int
 streq9 (const char *s1, const char *s2)

_service:tar_scm:groff-1.22.4.tar.gz/lib/string.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/string.in.h Changed

@@ -1,19 +1,19 @@
 /* A GNU-like <string.h>.
 
-   Copyright (C) 1995-1996, 2001-2018 Free Software Foundation, Inc.
+   Copyright (C) 1995-1996, 2001-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if __GNUC__ >= 3
 @PRAGMA_SYSTEM_HEADER@
@@ -52,14 +52,6 @@
 # include <wchar.h>
 #endif
 
-/* The __attribute__ feature is available in gcc versions 2.5 and later.
-   The attribute __pure__ was added in gcc 2.96.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-# define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
-#else
-# define _GL_ATTRIBUTE_PURE /* empty */
-#endif
-
 /* NetBSD 5.0 declares strsignal in <unistd.h>, not in <string.h>.  */
 /* But in any case avoid namespace pollution on glibc systems.  */
 #if (@GNULIB_STRSIGNAL@ || defined GNULIB_POSIXCHECK) && defined __NetBSD__ \
@@ -67,12 +59,106 @@
 # include <unistd.h>
 #endif
 
+/* AIX 7.2 and Android 13 declare ffsl and ffsll in <strings.h>, not in
+   <string.h>.  */
+/* But in any case avoid namespace pollution on glibc systems.  */
+#if ((@GNULIB_FFSL@ || @GNULIB_FFSLL@ || defined GNULIB_POSIXCHECK) \
+     && (defined _AIX || defined __ANDROID__)) \
+    && ! defined __GLIBC__
+# include <strings.h>
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if __GNUC__ >= 11
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC_FREE
+# if defined __cplusplus && defined __GNUC__ && !defined __clang__
+/* Work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=108231> */
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC ((void (*) (void *)) free, 1)
+# else
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC (free, 1)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MALLOC declares that the function returns a pointer to freshly
+   allocated memory.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_MALLOC
+# if __GNUC__ >= 3 || defined __clang__
+#  define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
+# else
+#  define _GL_ATTRIBUTE_MALLOC
+# endif
+#endif
+
+/* The __attribute__ feature is available in gcc versions 2.5 and later.
+   The attribute __pure__ was added in gcc 2.96.  */
+#ifndef _GL_ATTRIBUTE_PURE
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) || defined __clang__
+#  define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
+# else
+#  define _GL_ATTRIBUTE_PURE /* empty */
+# endif
+#endif
+
 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
 
 /* The definition of _GL_ARG_NONNULL is copied here.  */
 
 /* The definition of _GL_WARN_ON_USE is copied here.  */
 
+/* Make _GL_ATTRIBUTE_DEALLOC_FREE work, even though <stdlib.h> may not have
+   been included yet.  */
+#if @GNULIB_FREE_POSIX@
+# if (@REPLACE_FREE@ && !defined free \
+      && !(defined __cplusplus && defined GNULIB_NAMESPACE))
+/* We can't do '#define free rpl_free' here.  */
+_GL_EXTERN_C void rpl_free (void *);
+#  undef _GL_ATTRIBUTE_DEALLOC_FREE
+#  define _GL_ATTRIBUTE_DEALLOC_FREE _GL_ATTRIBUTE_DEALLOC (rpl_free, 1)
+# else
+#  if defined _MSC_VER && !defined free
+_GL_EXTERN_C
+#   if defined _DLL
+     __declspec (dllimport)
+#   endif
+     void __cdecl free (void *);
+#  else
+#   if defined __cplusplus && (__GLIBC__ + (__GLIBC_MINOR__ >= 14) > 2)
+_GL_EXTERN_C void free (void *) throw ();
+#   else
+_GL_EXTERN_C void free (void *);
+#   endif
+#  endif
+# endif
+#else
+# if defined _MSC_VER && !defined free
+_GL_EXTERN_C
+#   if defined _DLL
+     __declspec (dllimport)
+#   endif
+     void __cdecl free (void *);
+# else
+#  if defined __cplusplus && (__GLIBC__ + (__GLIBC_MINOR__ >= 14) > 2)
+_GL_EXTERN_C void free (void *) throw ();
+#  else
+_GL_EXTERN_C void free (void *);
+#  endif
+# endif
+#endif
 
 /* Clear a block of memory.  The compiler will not delete a call to
    this function, even if the block is dead after the call.  */
@@ -108,10 +194,18 @@
 
 /* Find the index of the least-significant set bit.  */
 #if @GNULIB_FFSLL@
-# if !@HAVE_FFSLL@
+# if @REPLACE_FFSLL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define ffsll rpl_ffsll
+#  endif
+_GL_FUNCDECL_RPL (ffsll, int, (long long int i));
+_GL_CXXALIAS_RPL (ffsll, int, (long long int i));
+# else
+#  if !@HAVE_FFSLL@
 _GL_FUNCDECL_SYS (ffsll, int, (long long int i));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (ffsll, int, (long long int i));
+# endif
 _GL_CXXALIASWARN (ffsll);
 #elif defined GNULIB_POSIXCHECK
 # undef ffsll
@@ -121,10 +215,30 @@
 #endif
 
 
+#if @GNULIB_MDA_MEMCCPY@
+/* On native Windows, map 'memccpy' to '_memccpy', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::memccpy always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef memccpy
+#   define memccpy _memccpy
+#  endif
+_GL_CXXALIAS_MDA (memccpy, void *,
+                  (void *dest, const void *src, int c, size_t n));
+# else
+_GL_CXXALIAS_SYS (memccpy, void *,
+                  (void *dest, const void *src, int c, size_t n));
+# endif
+_GL_CXXALIASWARN (memccpy);
+#endif
+
+
 /* Return the first instance of C within N bytes of S, or NULL.  */
 #if @GNULIB_MEMCHR@
 # if @REPLACE_MEMCHR@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef memchr
 #   define memchr rpl_memchr
 #  endif
 _GL_FUNCDECL_RPL (memchr, void *, (void const *__s, int __c, size_t __n)
@@ -132,11 +246,6 @@
                                   _GL_ARG_NONNULL ((1)));
 _GL_CXXALIAS_RPL (memchr, void *, (void const *__s, int __c, size_t __n));
 # else
-#  if ! @HAVE_MEMCHR@
-_GL_FUNCDECL_SYS (memchr, void *, (void const *__s, int __c, size_t __n)
-                                  _GL_ATTRIBUTE_PURE
-                                  _GL_ARG_NONNULL ((1)));
-#  endif
   /* On some systems, this function is defined as an overloaded function:
        extern "C" { const void * std::memchr (const void *, int, size_t); }
        extern "C++" { void * std::memchr (void *, int, size_t); }  */
@@ -145,11 +254,12 @@
                         void const *, (void const *__s, int __c, size_t __n));
 # endif
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (memchr, void *, (void *__s, int __c, size_t __n));
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (memchr, void *, (void *__s, int __c, size_t __n) throw ());
 _GL_CXXALIASWARN1 (memchr, void const *,
-                   (void const *__s, int __c, size_t __n));
-# else
+                   (void const *__s, int __c, size_t __n) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (memchr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -198,16 +308,32 @@
 /* Copy N bytes of SRC to DEST, return pointer to bytes after the
    last written byte.  */
 #if @GNULIB_MEMPCPY@
-# if ! @HAVE_MEMPCPY@
+# if @REPLACE_MEMPCPY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef mempcpy
+#   define mempcpy rpl_mempcpy
+#  endif
+_GL_FUNCDECL_RPL (mempcpy, void *,
+                  (void *restrict __dest, void const *restrict __src,
+                   size_t __n)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (mempcpy, void *,
+                  (void *restrict __dest, void const *restrict __src,
+                   size_t __n));
+# else
+#  if !@HAVE_MEMPCPY@
 _GL_FUNCDECL_SYS (mempcpy, void *,
                   (void *restrict __dest, void const *restrict __src,
                    size_t __n)
                   _GL_ARG_NONNULL ((1, 2)));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (mempcpy, void *,
                   (void *restrict __dest, void const *restrict __src,
                    size_t __n));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mempcpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mempcpy
 # if HAVE_RAW_DECL_MEMPCPY
@@ -230,10 +356,11 @@
                         void *, (void const *, int, size_t),
                         void const *, (void const *, int, size_t));
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (memrchr, void *, (void *, int, size_t));
-_GL_CXXALIASWARN1 (memrchr, void const *, (void const *, int, size_t));
-# else
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (memrchr, void *, (void *, int, size_t) throw ());
+_GL_CXXALIASWARN1 (memrchr, void const *, (void const *, int, size_t) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (memrchr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -244,6 +371,23 @@
 # endif
 #endif
 
+/* Overwrite a block of memory.  The compiler will not optimize
+   effects away, even if the block is dead after the call.  */
+#if @GNULIB_MEMSET_EXPLICIT@
+# if ! @HAVE_MEMSET_EXPLICIT@
+_GL_FUNCDECL_SYS (memset_explicit, void *,
+                  (void *__dest, int __c, size_t __n) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (memset_explicit, void *, (void *__dest, int __c, size_t __n));
+_GL_CXXALIASWARN (memset_explicit);
+#elif defined GNULIB_POSIXCHECK
+# undef memset_explicit
+# if HAVE_RAW_DECL_MEMSET_EXPLICIT
+_GL_WARN_ON_USE (memset_explicit, "memset_explicit is unportable - "
+                 "use gnulib module memset_explicit for portability");
+# endif
+#endif
+
 /* Find the first occurrence of C in S.  More efficient than
    memchr(S,C,N), at the expense of undefined behavior if C does not
    occur within N bytes.  */
@@ -260,9 +404,11 @@
                         void *, (void const *__s, int __c_in),
                         void const *, (void const *__s, int __c_in));
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (rawmemchr, void *, (void *__s, int __c_in));
-_GL_CXXALIASWARN1 (rawmemchr, void const *, (void const *__s, int __c_in));
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (rawmemchr, void *, (void *__s, int __c_in) throw ());
+_GL_CXXALIASWARN1 (rawmemchr, void const *,
+                   (void const *__s, int __c_in) throw ());
 # else
 _GL_CXXALIASWARN (rawmemchr);
 # endif
@@ -276,14 +422,28 @@
 
 /* Copy SRC to DST, returning the address of the terminating '\0' in DST.  */
 #if @GNULIB_STPCPY@
-# if ! @HAVE_STPCPY@
+# if @REPLACE_STPCPY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef stpcpy
+#   define stpcpy rpl_stpcpy
+#  endif
+_GL_FUNCDECL_RPL (stpcpy, char *,
+                  (char *restrict __dst, char const *restrict __src)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (stpcpy, char *,
+                  (char *restrict __dst, char const *restrict __src));
+# else
+#  if !@HAVE_STPCPY@
 _GL_FUNCDECL_SYS (stpcpy, char *,
                   (char *restrict __dst, char const *restrict __src)
                   _GL_ARG_NONNULL ((1, 2)));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (stpcpy, char *,
                   (char *restrict __dst, char const *restrict __src));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (stpcpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef stpcpy
 # if HAVE_RAW_DECL_STPCPY
@@ -318,7 +478,9 @@
                   (char *restrict __dst, char const *restrict __src,
                    size_t __n));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (stpncpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef stpncpy
 # if HAVE_RAW_DECL_STPNCPY
@@ -332,9 +494,11 @@
    GB18030 and the character to be searched is a digit.  */
 # undef strchr
 /* Assume strchr is always declared.  */
-_GL_WARN_ON_USE (strchr, "strchr cannot work correctly on character strings "
-                 "in some multibyte locales - "
-                 "use mbschr if you care about internationalization");
+_GL_WARN_ON_USE_CXX (strchr,
+                     const char *, char *, (const char *, int),
+                     "strchr cannot work correctly on character strings "
+                     "in some multibyte locales - "
+                     "use mbschr if you care about internationalization");
 #endif
 
 /* Find the first occurrence of C in S or the final NUL byte.  */
@@ -362,10 +526,12 @@
                         char const *, (char const *__s, int __c_in));
 # endif
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (strchrnul, char *, (char *__s, int __c_in));
-_GL_CXXALIASWARN1 (strchrnul, char const *, (char const *__s, int __c_in));
-# else
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (strchrnul, char *, (char *__s, int __c_in) throw ());
+_GL_CXXALIASWARN1 (strchrnul, char const *,
+                   (char const *__s, int __c_in) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (strchrnul);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -383,24 +549,62 @@
 #   undef strdup
 #   define strdup rpl_strdup
 #  endif
-_GL_FUNCDECL_RPL (strdup, char *, (char const *__s) _GL_ARG_NONNULL ((1)));
+_GL_FUNCDECL_RPL (strdup, char *,
+                  (char const *__s)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
 _GL_CXXALIAS_RPL (strdup, char *, (char const *__s));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef strdup
+#   define strdup _strdup
+#  endif
+_GL_CXXALIAS_MDA (strdup, char *, (char const *__s));
 # else
 #  if defined __cplusplus && defined GNULIB_NAMESPACE && defined strdup
     /* strdup exists as a function and as a macro.  Get rid of the macro.  */
 #   undef strdup
 #  endif
-#  if !(@HAVE_DECL_STRDUP@ || defined strdup)
-_GL_FUNCDECL_SYS (strdup, char *, (char const *__s) _GL_ARG_NONNULL ((1)));
+#  if (!@HAVE_DECL_STRDUP@ || __GNUC__ >= 11) && !defined strdup
+_GL_FUNCDECL_SYS (strdup, char *,
+                  (char const *__s)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
 #  endif
 _GL_CXXALIAS_SYS (strdup, char *, (char const *__s));
 # endif
 _GL_CXXALIASWARN (strdup);
-#elif defined GNULIB_POSIXCHECK
-# undef strdup
-# if HAVE_RAW_DECL_STRDUP
+#else
+# if __GNUC__ >= 11 && !defined strdup
+/* For -Wmismatched-dealloc: Associate strdup with free or rpl_free.  */
+_GL_FUNCDECL_SYS (strdup, char *,
+                  (char const *__s)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef strdup
+#  if HAVE_RAW_DECL_STRDUP
 _GL_WARN_ON_USE (strdup, "strdup is unportable - "
                  "use gnulib module strdup for portability");
+#  endif
+# elif @GNULIB_MDA_STRDUP@
+/* On native Windows, map 'creat' to '_creat', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::strdup always.  */
+#  if defined _WIN32 && !defined __CYGWIN__
+#   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#    undef strdup
+#    define strdup _strdup
+#   endif
+_GL_CXXALIAS_MDA (strdup, char *, (char const *__s));
+#  else
+#   if defined __cplusplus && defined GNULIB_NAMESPACE && defined strdup
+#    undef strdup
+#   endif
+_GL_CXXALIAS_SYS (strdup, char *, (char const *__s));
+#  endif
+_GL_CXXALIASWARN (strdup);
 # endif
 #endif
 
@@ -411,13 +615,18 @@
 #   undef strncat
 #   define strncat rpl_strncat
 #  endif
-_GL_FUNCDECL_RPL (strncat, char *, (char *dest, const char *src, size_t n)
-                                   _GL_ARG_NONNULL ((1, 2)));
-_GL_CXXALIAS_RPL (strncat, char *, (char *dest, const char *src, size_t n));
+_GL_FUNCDECL_RPL (strncat, char *,
+                  (char *restrict dest, const char *restrict src, size_t n)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (strncat, char *,
+                  (char *restrict dest, const char *restrict src, size_t n));
 # else
-_GL_CXXALIAS_SYS (strncat, char *, (char *dest, const char *src, size_t n));
+_GL_CXXALIAS_SYS (strncat, char *,
+                  (char *restrict dest, const char *restrict src, size_t n));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (strncat);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef strncat
 # if HAVE_RAW_DECL_STRNCAT
@@ -433,22 +642,35 @@
 #   undef strndup
 #   define strndup rpl_strndup
 #  endif
-_GL_FUNCDECL_RPL (strndup, char *, (char const *__s, size_t __n)
-                                   _GL_ARG_NONNULL ((1)));
+_GL_FUNCDECL_RPL (strndup, char *,
+                  (char const *__s, size_t __n)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
 _GL_CXXALIAS_RPL (strndup, char *, (char const *__s, size_t __n));
 # else
-#  if ! @HAVE_DECL_STRNDUP@
-_GL_FUNCDECL_SYS (strndup, char *, (char const *__s, size_t __n)
-                                   _GL_ARG_NONNULL ((1)));
+#  if !@HAVE_DECL_STRNDUP@ || (__GNUC__ >= 11 && !defined strndup)
+_GL_FUNCDECL_SYS (strndup, char *,
+                  (char const *__s, size_t __n)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
 #  endif
 _GL_CXXALIAS_SYS (strndup, char *, (char const *__s, size_t __n));
 # endif
 _GL_CXXALIASWARN (strndup);
-#elif defined GNULIB_POSIXCHECK
-# undef strndup
-# if HAVE_RAW_DECL_STRNDUP
+#else
+# if __GNUC__ >= 11 && !defined strndup
+/* For -Wmismatched-dealloc: Associate strndup with free or rpl_free.  */
+_GL_FUNCDECL_SYS (strndup, char *,
+                  (char const *__s, size_t __n)
+                  _GL_ARG_NONNULL ((1))
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef strndup
+#  if HAVE_RAW_DECL_STRNDUP
 _GL_WARN_ON_USE (strndup, "strndup is unportable - "
                  "use gnulib module strndup for portability");
+#  endif
 # endif
 #endif
 
@@ -508,11 +730,12 @@
                         char *, (char const *__s, char const *__accept),
                         const char *, (char const *__s, char const *__accept));
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (strpbrk, char *, (char *__s, char const *__accept));
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (strpbrk, char *, (char *__s, char const *__accept) throw ());
 _GL_CXXALIASWARN1 (strpbrk, char const *,
-                   (char const *__s, char const *__accept));
-# else
+                   (char const *__s, char const *__accept) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (strpbrk);
 # endif
 # if defined GNULIB_POSIXCHECK
@@ -521,15 +744,19 @@
    locale encoding is GB18030 and one of the characters to be searched is a
    digit.  */
 #  undef strpbrk
-_GL_WARN_ON_USE (strpbrk, "strpbrk cannot work correctly on character strings "
-                 "in multibyte locales - "
-                 "use mbspbrk if you care about internationalization");
+_GL_WARN_ON_USE_CXX (strpbrk,
+                     const char *, char *, (const char *, const char *),
+                     "strpbrk cannot work correctly on character strings "
+                     "in multibyte locales - "
+                     "use mbspbrk if you care about internationalization");
 # endif
 #elif defined GNULIB_POSIXCHECK
 # undef strpbrk
 # if HAVE_RAW_DECL_STRPBRK
-_GL_WARN_ON_USE (strpbrk, "strpbrk is unportable - "
-                 "use gnulib module strpbrk for portability");
+_GL_WARN_ON_USE_CXX (strpbrk,
+                     const char *, char *, (const char *, const char *),
+                     "strpbrk is unportable - "
+                     "use gnulib module strpbrk for portability");
 # endif
 #endif
 
@@ -548,9 +775,11 @@
    GB18030 and the character to be searched is a digit.  */
 # undef strrchr
 /* Assume strrchr is always declared.  */
-_GL_WARN_ON_USE (strrchr, "strrchr cannot work correctly on character strings "
-                 "in some multibyte locales - "
-                 "use mbsrchr if you care about internationalization");
+_GL_WARN_ON_USE_CXX (strrchr,
+                     const char *, char *, (const char *, int),
+                     "strrchr cannot work correctly on character strings "
+                     "in some multibyte locales - "
+                     "use mbsrchr if you care about internationalization");
 #endif
 
 /* Search the next delimiter (char listed in DELIM) starting at *STRINGP.
@@ -610,11 +839,13 @@
                         const char *, (const char *haystack, const char *needle));
 # endif
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (strstr, char *, (char *haystack, const char *needle));
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (strstr, char *,
+                   (char *haystack, const char *needle) throw ());
 _GL_CXXALIASWARN1 (strstr, const char *,
-                   (const char *haystack, const char *needle));
-# else
+                   (const char *haystack, const char *needle) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (strstr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -659,11 +890,13 @@
                         const char *, (const char *haystack, const char *needle));
 # endif
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
-     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
-_GL_CXXALIASWARN1 (strcasestr, char *, (char *haystack, const char *needle));
+     && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4) \
+         || defined __clang__)
+_GL_CXXALIASWARN1 (strcasestr, char *,
+                   (char *haystack, const char *needle) throw ());
 _GL_CXXALIASWARN1 (strcasestr, const char *,
-                   (const char *haystack, const char *needle));
-# else
+                   (const char *haystack, const char *needle) throw ());
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (strcasestr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -693,7 +926,7 @@
    This is a variant of strtok() that is multithread-safe.
 
    For the POSIX documentation for this function, see:
-   http://www.opengroup.org/susv3xsh/strtok.html
+   https://pubs.opengroup.org/onlinepubs/9699919799/functions/strtok.html
 
    Caveat: It modifies the original string.
    Caveat: These functions cannot be used on constant strings.
@@ -767,7 +1000,9 @@
                                   _GL_ARG_NONNULL ((1)));
 _GL_CXXALIAS_SYS (mbslen, size_t, (const char *string));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbslen);
+# endif
 #endif
 
 #if @GNULIB_MBSNLEN@
@@ -964,7 +1199,8 @@
    Caveat: The identity of the delimiting character is lost.
 
    See also mbssep().  */
-_GL_EXTERN_C char * mbstok_r (char *string, const char *delim, char **save_ptr)
+_GL_EXTERN_C char * mbstok_r (char *restrict string, const char *delim,
+                              char **save_ptr)
      _GL_ARG_NONNULL ((2, 3));
 #endif
 
@@ -980,7 +1216,9 @@
 # else
 _GL_CXXALIAS_SYS (strerror, char *, (int));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (strerror);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef strerror
 /* Assume strerror is always declared.  */
@@ -1006,7 +1244,7 @@
 #  endif
 _GL_CXXALIAS_SYS (strerror_r, int, (int errnum, char *buf, size_t buflen));
 # endif
-# if @HAVE_DECL_STRERROR_R@
+# if __GLIBC__ >= 2 && @HAVE_DECL_STRERROR_R@
 _GL_CXXALIASWARN (strerror_r);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -1017,6 +1255,60 @@
 # endif
 #endif
 
+/* Return the name of the system error code ERRNUM.  */
+#if @GNULIB_STRERRORNAME_NP@
+# if @REPLACE_STRERRORNAME_NP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef strerrorname_np
+#   define strerrorname_np rpl_strerrorname_np
+#  endif
+_GL_FUNCDECL_RPL (strerrorname_np, const char *, (int errnum));
+_GL_CXXALIAS_RPL (strerrorname_np, const char *, (int errnum));
+# else
+#  if !@HAVE_STRERRORNAME_NP@
+_GL_FUNCDECL_SYS (strerrorname_np, const char *, (int errnum));
+#  endif
+_GL_CXXALIAS_SYS (strerrorname_np, const char *, (int errnum));
+# endif
+_GL_CXXALIASWARN (strerrorname_np);
+#elif defined GNULIB_POSIXCHECK
+# undef strerrorname_np
+# if HAVE_RAW_DECL_STRERRORNAME_NP
+_GL_WARN_ON_USE (strerrorname_np, "strerrorname_np is unportable - "
+                 "use gnulib module strerrorname_np for portability");
+# endif
+#endif
+
+/* Return an abbreviation string for the signal number SIG.  */
+#if @GNULIB_SIGABBREV_NP@
+# if ! @HAVE_SIGABBREV_NP@
+_GL_FUNCDECL_SYS (sigabbrev_np, const char *, (int sig));
+# endif
+_GL_CXXALIAS_SYS (sigabbrev_np, const char *, (int sig));
+_GL_CXXALIASWARN (sigabbrev_np);
+#elif defined GNULIB_POSIXCHECK
+# undef sigabbrev_np
+# if HAVE_RAW_DECL_SIGABBREV_NP
+_GL_WARN_ON_USE (sigabbrev_np, "sigabbrev_np is unportable - "
+                 "use gnulib module sigabbrev_np for portability");
+# endif
+#endif
+
+/* Return an English description string for the signal number SIG.  */
+#if @GNULIB_SIGDESCR_NP@
+# if ! @HAVE_SIGDESCR_NP@
+_GL_FUNCDECL_SYS (sigdescr_np, const char *, (int sig));
+# endif
+_GL_CXXALIAS_SYS (sigdescr_np, const char *, (int sig));
+_GL_CXXALIASWARN (sigdescr_np);
+#elif defined GNULIB_POSIXCHECK
+# undef sigdescr_np
+# if HAVE_RAW_DECL_SIGDESCR_NP
+_GL_WARN_ON_USE (sigdescr_np, "sigdescr_np is unportable - "
+                 "use gnulib module sigdescr_np for portability");
+# endif
+#endif
+
 #if @GNULIB_STRSIGNAL@
 # if @REPLACE_STRSIGNAL@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)

_service:tar_scm:groff-1.22.4.tar.gz/lib/sys_types.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/sys_types.in.h Changed

@@ -1,19 +1,19 @@
 /* Provide a more complete sys/types.h.
 
-   Copyright (C) 2011-2018 Free Software Foundation, Inc.
+   Copyright (C) 2011-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #if __GNUC__ >= 3
 @PRAGMA_SYSTEM_HEADER@

_service:tar_scm:groff-1.23.0.tar.gz/lib/unictype Added

_service:tar_scm:groff-1.23.0.tar.gz/lib/unictype/bitmap.h Added

@@ -0,0 +1,48 @@
+/* Three-level bitmap lookup.
+   Copyright (C) 2000-2002, 2005-2007, 2009-2023 Free Software Foundation, Inc.
+   Written by Bruno Haible <bruno@clisp.org>, 2000-2002.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+static inline int bitmap_lookup (const void *table, ucs4_t uc);
+
+/* These values are currently hardcoded into gen-uni-tables.c, function
+   output_predicate().  */
+#define header_0 16
+#define header_2 9
+#define header_3 127
+#define header_4 15
+
+static inline int
+bitmap_lookup (const void *table, ucs4_t uc)
+{
+  unsigned int index1 = uc >> header_0;
+  if (index1 < ((const int *) table)0)
+    {
+      int lookup1 = ((const int *) table)1 + index1;
+      if (lookup1 >= 0)
+        {
+          unsigned int index2 = (uc >> header_2) & header_3;
+          int lookup2 = ((const short *) table)lookup1 + index2;
+          if (lookup2 >= 0)
+            {
+              unsigned int index3 = (uc >> 5) & header_4;
+              unsigned int lookup3 = ((const unsigned int *) table)lookup2 + index3;
+
+              return (lookup3 >> (uc & 0x1f)) & 1;
+            }
+        }
+    }
+  return 0;
+}

_service:tar_scm:groff-1.23.0.tar.gz/lib/unistd.c Added

_service:tar_scm:groff-1.23.0.tar.gz/lib/unistd.in.h Added

@@ -0,0 +1,2393 @@
+/* Substitute for and wrapper around <unistd.h>.
+   Copyright (C) 2003-2023 Free Software Foundation, Inc.
+
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
+
+   This file 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 Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#ifndef _@GUARD_PREFIX@_UNISTD_H
+
+#if __GNUC__ >= 3
+@PRAGMA_SYSTEM_HEADER@
+#endif
+@PRAGMA_COLUMNS@
+
+#if @HAVE_UNISTD_H@ && defined _GL_INCLUDING_UNISTD_H
+/* Special invocation convention:
+   - On Mac OS X 10.3.9 we have a sequence of nested includes
+     <unistd.h> -> <signal.h> -> <pthread.h> -> <unistd.h>
+     In this situation, the functions are not yet declared, therefore we cannot
+     provide the C++ aliases.  */
+
+#@INCLUDE_NEXT@ @NEXT_UNISTD_H@
+
+#else
+/* Normal invocation convention.  */
+
+/* The include_next requires a split double-inclusion guard.  */
+#if @HAVE_UNISTD_H@
+# define _GL_INCLUDING_UNISTD_H
+# @INCLUDE_NEXT@ @NEXT_UNISTD_H@
+# undef _GL_INCLUDING_UNISTD_H
+#endif
+
+/* Get all possible declarations of gethostname().  */
+#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@ \
+  && !defined _GL_INCLUDING_WINSOCK2_H
+# define _GL_INCLUDING_WINSOCK2_H
+# include <winsock2.h>
+# undef _GL_INCLUDING_WINSOCK2_H
+#endif
+
+#if !defined _@GUARD_PREFIX@_UNISTD_H && !defined _GL_INCLUDING_WINSOCK2_H
+#define _@GUARD_PREFIX@_UNISTD_H
+
+/* NetBSD 5.0 mis-defines NULL.  Also get size_t.  */
+/* But avoid namespace pollution on glibc systems.  */
+#ifndef __GLIBC__
+# include <stddef.h>
+#endif
+
+/* mingw doesn't define the SEEK_* or *_FILENO macros in <unistd.h>.  */
+/* MSVC declares 'unlink' in <stdio.h>, not in <unistd.h>.  We must include
+   it before we  #define unlink rpl_unlink.  */
+/* Cygwin 1.7.1 declares symlinkat in <stdio.h>, not in <unistd.h>.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if (!(defined SEEK_CUR && defined SEEK_END && defined SEEK_SET) \
+     || ((@GNULIB_UNLINK@ || defined GNULIB_POSIXCHECK) \
+         && (defined _WIN32 && ! defined __CYGWIN__)) \
+     || ((@GNULIB_SYMLINKAT@ || defined GNULIB_POSIXCHECK) \
+         && defined __CYGWIN__)) \
+    && ! defined __GLIBC__
+# include <stdio.h>
+#endif
+
+/* Cygwin 1.7.1 and Android 4.3 declare unlinkat in <fcntl.h>, not in
+   <unistd.h>.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_UNLINKAT@ || defined GNULIB_POSIXCHECK) \
+    && (defined __CYGWIN__ || defined __ANDROID__) \
+    && ! defined __GLIBC__
+# include <fcntl.h>
+#endif
+
+/* mingw fails to declare _exit in <unistd.h>.  */
+/* mingw, MSVC, BeOS, Haiku declare environ in <stdlib.h>, not in
+   <unistd.h>.  */
+/* Solaris declares getcwd not only in <unistd.h> but also in <stdlib.h>.  */
+/* OSF Tru64 Unix cannot see gnulib rpl_strtod when system <stdlib.h> is
+   included here.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if !defined __GLIBC__ && !defined __osf__
+# define __need_system_stdlib_h
+# include <stdlib.h>
+# undef __need_system_stdlib_h
+#endif
+
+/* Native Windows platforms declare _chdir, _getcwd, _rmdir in
+   <io.h> and/or <direct.h>, not in <unistd.h>.
+   They also declare _access(), _chmod(), _close(), _dup(), _dup2(), _isatty(),
+   _lseek(), _read(), _unlink(), _write() in <io.h>.  */
+#if defined _WIN32 && !defined __CYGWIN__
+# include <io.h>
+# include <direct.h>
+#endif
+
+/* Native Windows platforms declare _execl*, _execv* in <process.h>.  */
+#if defined _WIN32 && !defined __CYGWIN__
+# include <process.h>
+#endif
+
+/* AIX and OSF/1 5.1 declare getdomainname in <netdb.h>, not in <unistd.h>.
+   NonStop Kernel declares gethostname in <netdb.h>, not in <unistd.h>.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if ((@GNULIB_GETDOMAINNAME@ && (defined _AIX || defined __osf__)) \
+     || (@GNULIB_GETHOSTNAME@ && defined __TANDEM)) \
+    && !defined __GLIBC__
+# include <netdb.h>
+#endif
+
+/* Mac OS X 10.13, Solaris 11.4, and Android 9.0 declare getentropy in
+   <sys/random.h>, not in <unistd.h>.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_GETENTROPY@ || defined GNULIB_POSIXCHECK) \
+    && ((defined __APPLE__ && defined __MACH__) || defined __sun \
+        || defined __ANDROID__) \
+    && @UNISTD_H_HAVE_SYS_RANDOM_H@ \
+    && !defined __GLIBC__
+# include <sys/random.h>
+#endif
+
+/* Android 4.3 declares fchownat in <sys/stat.h>, not in <unistd.h>.  */
+/* But avoid namespace pollution on glibc systems.  */
+#if (@GNULIB_FCHOWNAT@ || defined GNULIB_POSIXCHECK) && defined __ANDROID__ \
+    && !defined __GLIBC__
+# include <sys/stat.h>
+#endif
+
+/* MSVC defines off_t in <sys/types.h>.
+   May also define off_t to a 64-bit type on native Windows.  */
+/* Get off_t, ssize_t, mode_t.  */
+#include <sys/types.h>
+
+/* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
+
+/* The definition of _GL_ARG_NONNULL is copied here.  */
+
+/* The definition of _GL_WARN_ON_USE is copied here.  */
+
+
+/* Get getopt(), optarg, optind, opterr, optopt.  */
+#if @GNULIB_GETOPT_POSIX@ && @GNULIB_UNISTD_H_GETOPT@ && !defined _GL_SYSTEM_GETOPT
+# include <getopt-cdefs.h>
+# include <getopt-pfx-core.h>
+#endif
+
+#ifndef _GL_INLINE_HEADER_BEGIN
+ #error "Please include config.h first."
+#endif
+_GL_INLINE_HEADER_BEGIN
+#ifndef _GL_UNISTD_INLINE
+# define _GL_UNISTD_INLINE _GL_INLINE
+#endif
+
+/* Hide some function declarations from <winsock2.h>.  */
+
+#if @GNULIB_GETHOSTNAME@ && @UNISTD_H_HAVE_WINSOCK2_H@
+# if !defined _@GUARD_PREFIX@_SYS_SOCKET_H
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef socket
+#   define socket              socket_used_without_including_sys_socket_h
+#   undef connect
+#   define connect             connect_used_without_including_sys_socket_h
+#   undef accept
+#   define accept              accept_used_without_including_sys_socket_h
+#   undef bind
+#   define bind                bind_used_without_including_sys_socket_h
+#   undef getpeername
+#   define getpeername         getpeername_used_without_including_sys_socket_h
+#   undef getsockname
+#   define getsockname         getsockname_used_without_including_sys_socket_h
+#   undef getsockopt
+#   define getsockopt          getsockopt_used_without_including_sys_socket_h
+#   undef listen
+#   define listen              listen_used_without_including_sys_socket_h
+#   undef recv
+#   define recv                recv_used_without_including_sys_socket_h
+#   undef send
+#   define send                send_used_without_including_sys_socket_h
+#   undef recvfrom
+#   define recvfrom            recvfrom_used_without_including_sys_socket_h
+#   undef sendto
+#   define sendto              sendto_used_without_including_sys_socket_h
+#   undef setsockopt
+#   define setsockopt          setsockopt_used_without_including_sys_socket_h
+#   undef shutdown
+#   define shutdown            shutdown_used_without_including_sys_socket_h
+#  else
+    _GL_WARN_ON_USE (socket,
+                     "socket() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (connect,
+                     "connect() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (accept,
+                     "accept() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (bind,
+                     "bind() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (getpeername,
+                     "getpeername() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (getsockname,
+                     "getsockname() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (getsockopt,
+                     "getsockopt() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (listen,
+                     "listen() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (recv,
+                     "recv() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (send,
+                     "send() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (recvfrom,
+                     "recvfrom() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (sendto,
+                     "sendto() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (setsockopt,
+                     "setsockopt() used without including <sys/socket.h>");
+    _GL_WARN_ON_USE (shutdown,
+                     "shutdown() used without including <sys/socket.h>");
+#  endif
+# endif
+# if !defined _@GUARD_PREFIX@_SYS_SELECT_H
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef select
+#   define select              select_used_without_including_sys_select_h
+#  else
+    _GL_WARN_ON_USE (select,
+                     "select() used without including <sys/select.h>");
+#  endif
+# endif
+#endif
+
+
+/* OS/2 EMX lacks these macros.  */
+#ifndef STDIN_FILENO
+# define STDIN_FILENO 0
+#endif
+#ifndef STDOUT_FILENO
+# define STDOUT_FILENO 1
+#endif
+#ifndef STDERR_FILENO
+# define STDERR_FILENO 2
+#endif
+
+/* Ensure *_OK macros exist.  */
+#ifndef F_OK
+# define F_OK 0
+# define X_OK 1
+# define W_OK 2
+# define R_OK 4
+#endif
+
+
+/* Declare overridden functions.  */
+
+
+#if @GNULIB_ACCESS@
+# if @REPLACE_ACCESS@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef access
+#   define access rpl_access
+#  endif
+_GL_FUNCDECL_RPL (access, int, (const char *file, int mode)
+                               _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (access, int, (const char *file, int mode));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef access
+#   define access _access
+#  endif
+_GL_CXXALIAS_MDA (access, int, (const char *file, int mode));
+# else
+_GL_CXXALIAS_SYS (access, int, (const char *file, int mode));
+# endif
+_GL_CXXALIASWARN (access);
+#elif defined GNULIB_POSIXCHECK
+# undef access
+# if HAVE_RAW_DECL_ACCESS
+/* The access() function is a security risk.  */
+_GL_WARN_ON_USE (access, "access does not always support X_OK - "
+                 "use gnulib module access for portability; "
+                 "also, this function is a security risk - "
+                 "use the gnulib module faccessat instead");
+# endif
+#elif @GNULIB_MDA_ACCESS@
+/* On native Windows, map 'access' to '_access', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::access always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef access
+#   define access _access
+#  endif
+_GL_CXXALIAS_MDA (access, int, (const char *file, int mode));
+# else
+_GL_CXXALIAS_SYS (access, int, (const char *file, int mode));
+# endif
+_GL_CXXALIASWARN (access);
+#endif
+
+
+#if @GNULIB_CHDIR@
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef chdir
+#   define chdir _chdir
+#  endif
+_GL_CXXALIAS_MDA (chdir, int, (const char *file));
+# else
+_GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIASWARN (chdir);
+#elif defined GNULIB_POSIXCHECK
+# undef chdir
+# if HAVE_RAW_DECL_CHDIR
+_GL_WARN_ON_USE (chown, "chdir is not always in <unistd.h> - "
+                 "use gnulib module chdir for portability");
+# endif
+#elif @GNULIB_MDA_CHDIR@
+/* On native Windows, map 'chdir' to '_chdir', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::chdir always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef chdir
+#   define chdir _chdir
+#  endif
+_GL_CXXALIAS_MDA (chdir, int, (const char *file));
+# else
+_GL_CXXALIAS_SYS (chdir, int, (const char *file) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIASWARN (chdir);
+#endif
+
+
+#if @GNULIB_CHOWN@
+/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
+   to GID (if GID is not -1).  Follow symbolic links.
+   Return 0 if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/chown.html.  */
+# if @REPLACE_CHOWN@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef chown
+#   define chown rpl_chown
+#  endif
+_GL_FUNCDECL_RPL (chown, int, (const char *file, uid_t uid, gid_t gid)
+                              _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (chown, int, (const char *file, uid_t uid, gid_t gid));
+# else
+#  if !@HAVE_CHOWN@
+_GL_FUNCDECL_SYS (chown, int, (const char *file, uid_t uid, gid_t gid)
+                              _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (chown, int, (const char *file, uid_t uid, gid_t gid));
+# endif
+_GL_CXXALIASWARN (chown);
+#elif defined GNULIB_POSIXCHECK
+# undef chown
+# if HAVE_RAW_DECL_CHOWN
+_GL_WARN_ON_USE (chown, "chown fails to follow symlinks on some systems and "
+                 "doesn't treat a uid or gid of -1 on some systems - "
+                 "use gnulib module chown for portability");
+# endif
+#endif
+
+
+#if @GNULIB_CLOSE@
+# if @REPLACE_CLOSE@
+/* Automatically included by modules that need a replacement for close.  */
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef close
+#   define close rpl_close
+#  endif
+_GL_FUNCDECL_RPL (close, int, (int fd));
+_GL_CXXALIAS_RPL (close, int, (int fd));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef close
+#   define close _close
+#  endif
+_GL_CXXALIAS_MDA (close, int, (int fd));
+# else
+_GL_CXXALIAS_SYS (close, int, (int fd));
+# endif
+_GL_CXXALIASWARN (close);
+#elif @UNISTD_H_HAVE_WINSOCK2_H_AND_USE_SOCKETS@
+# undef close
+# define close close_used_without_requesting_gnulib_module_close
+#elif defined GNULIB_POSIXCHECK
+# undef close
+/* Assume close is always declared.  */
+_GL_WARN_ON_USE (close, "close does not portably work on sockets - "
+                 "use gnulib module close for portability");
+#elif @GNULIB_MDA_CLOSE@
+/* On native Windows, map 'close' to '_close', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::close always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef close
+#   define close _close
+#  endif
+_GL_CXXALIAS_MDA (close, int, (int fd));
+# else
+_GL_CXXALIAS_SYS (close, int, (int fd));
+# endif
+_GL_CXXALIASWARN (close);
+#endif
+
+
+#if @GNULIB_COPY_FILE_RANGE@
+# if @REPLACE_COPY_FILE_RANGE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef copy_file_range
+#   define copy_file_range rpl_copy_file_range
+#  endif
+_GL_FUNCDECL_RPL (copy_file_range, ssize_t, (int ifd, off_t *ipos,
+                                             int ofd, off_t *opos,
+                                             size_t len, unsigned flags));
+_GL_CXXALIAS_RPL (copy_file_range, ssize_t, (int ifd, off_t *ipos,
+                                             int ofd, off_t *opos,
+                                             size_t len, unsigned flags));
+# else
+#  if !@HAVE_COPY_FILE_RANGE@
+_GL_FUNCDECL_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
+                                             int ofd, off_t *opos,
+                                             size_t len, unsigned flags));
+#  endif
+_GL_CXXALIAS_SYS (copy_file_range, ssize_t, (int ifd, off_t *ipos,
+                                             int ofd, off_t *opos,
+                                             size_t len, unsigned flags));
+# endif
+_GL_CXXALIASWARN (copy_file_range);
+#elif defined GNULIB_POSIXCHECK
+# undef copy_file_range
+# if HAVE_RAW_DECL_COPY_FILE_RANGE
+_GL_WARN_ON_USE (copy_file_range,
+                 "copy_file_range is unportable - "
+                 "use gnulib module copy_file_range for portability");
+# endif
+#endif
+
+
+#if @GNULIB_DUP@
+# if @REPLACE_DUP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define dup rpl_dup
+#  endif
+_GL_FUNCDECL_RPL (dup, int, (int oldfd));
+_GL_CXXALIAS_RPL (dup, int, (int oldfd));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef dup
+#   define dup _dup
+#  endif
+_GL_CXXALIAS_MDA (dup, int, (int oldfd));
+# else
+_GL_CXXALIAS_SYS (dup, int, (int oldfd));
+# endif
+_GL_CXXALIASWARN (dup);
+#elif defined GNULIB_POSIXCHECK
+# undef dup
+# if HAVE_RAW_DECL_DUP
+_GL_WARN_ON_USE (dup, "dup is unportable - "
+                 "use gnulib module dup for portability");
+# endif
+#elif @GNULIB_MDA_DUP@
+/* On native Windows, map 'dup' to '_dup', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::dup always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef dup
+#   define dup _dup
+#  endif
+_GL_CXXALIAS_MDA (dup, int, (int oldfd));
+# else
+_GL_CXXALIAS_SYS (dup, int, (int oldfd));
+# endif
+_GL_CXXALIASWARN (dup);
+#endif
+
+
+#if @GNULIB_DUP2@
+/* Copy the file descriptor OLDFD into file descriptor NEWFD.  Do nothing if
+   NEWFD = OLDFD, otherwise close NEWFD first if it is open.
+   Return newfd if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/dup2.html>.  */
+# if @REPLACE_DUP2@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define dup2 rpl_dup2
+#  endif
+_GL_FUNCDECL_RPL (dup2, int, (int oldfd, int newfd));
+_GL_CXXALIAS_RPL (dup2, int, (int oldfd, int newfd));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef dup2
+#   define dup2 _dup2
+#  endif
+_GL_CXXALIAS_MDA (dup2, int, (int oldfd, int newfd));
+# else
+_GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
+# endif
+_GL_CXXALIASWARN (dup2);
+#elif defined GNULIB_POSIXCHECK
+# undef dup2
+# if HAVE_RAW_DECL_DUP2
+_GL_WARN_ON_USE (dup2, "dup2 is unportable - "
+                 "use gnulib module dup2 for portability");
+# endif
+#elif @GNULIB_MDA_DUP2@
+/* On native Windows, map 'dup2' to '_dup2', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::dup2 always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef dup2
+#   define dup2 _dup2
+#  endif
+_GL_CXXALIAS_MDA (dup2, int, (int oldfd, int newfd));
+# else
+_GL_CXXALIAS_SYS (dup2, int, (int oldfd, int newfd));
+# endif
+_GL_CXXALIASWARN (dup2);
+#endif
+
+
+#if @GNULIB_DUP3@
+/* Copy the file descriptor OLDFD into file descriptor NEWFD, with the
+   specified flags.
+   The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
+   and O_TEXT, O_BINARY (defined in "binary-io.h").
+   Close NEWFD first if it is open.
+   Return newfd if successful, otherwise -1 and errno set.
+   See the Linux man page at
+   <https://www.kernel.org/doc/man-pages/online/pages/man2/dup3.2.html>.  */
+# if @REPLACE_DUP3@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef dup3
+#   define dup3 rpl_dup3
+#  endif
+_GL_FUNCDECL_RPL (dup3, int, (int oldfd, int newfd, int flags));
+_GL_CXXALIAS_RPL (dup3, int, (int oldfd, int newfd, int flags));
+# else
+#  if !@HAVE_DUP3@
+_GL_FUNCDECL_SYS (dup3, int, (int oldfd, int newfd, int flags));
+#  endif
+_GL_CXXALIAS_SYS (dup3, int, (int oldfd, int newfd, int flags));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (dup3);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef dup3
+# if HAVE_RAW_DECL_DUP3
+_GL_WARN_ON_USE (dup3, "dup3 is unportable - "
+                 "use gnulib module dup3 for portability");
+# endif
+#endif
+
+
+#if @GNULIB_ENVIRON@
+# if defined __CYGWIN__ && !defined __i386__
+/* The 'environ' variable is defined in a DLL. Therefore its declaration needs
+   the '__declspec(dllimport)' attribute, but the system's <unistd.h> lacks it.
+   This leads to a link error on 64-bit Cygwin when the option
+   -Wl,--disable-auto-import is in use.  */
+_GL_EXTERN_C __declspec(dllimport) char **environ;
+# endif
+# if !@HAVE_DECL_ENVIRON@
+/* Set of environment variables and values.  An array of strings of the form
+   "VARIABLE=VALUE", terminated with a NULL.  */
+#  if defined __APPLE__ && defined __MACH__
+#   include <TargetConditionals.h>
+#   if !TARGET_OS_IPHONE && !TARGET_IPHONE_SIMULATOR
+#    define _GL_USE_CRT_EXTERNS
+#   endif
+#  endif
+#  ifdef _GL_USE_CRT_EXTERNS
+#   include <crt_externs.h>
+#   define environ (*_NSGetEnviron ())
+#  else
+#   ifdef __cplusplus
+extern "C" {
+#   endif
+extern char **environ;
+#   ifdef __cplusplus
+}
+#   endif
+#  endif
+# endif
+#elif defined GNULIB_POSIXCHECK
+# if HAVE_RAW_DECL_ENVIRON
+_GL_UNISTD_INLINE char ***
+_GL_WARN_ON_USE_ATTRIBUTE ("environ is unportable - "
+                           "use gnulib module environ for portability")
+rpl_environ (void)
+{
+  return &environ;
+}
+#  undef environ
+#  define environ (*rpl_environ ())
+# endif
+#endif
+
+
+#if @GNULIB_EUIDACCESS@
+/* Like access(), except that it uses the effective user id and group id of
+   the current process.  */
+# if !@HAVE_EUIDACCESS@
+_GL_FUNCDECL_SYS (euidaccess, int, (const char *filename, int mode)
+                                   _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (euidaccess, int, (const char *filename, int mode));
+_GL_CXXALIASWARN (euidaccess);
+# if defined GNULIB_POSIXCHECK
+/* Like access(), this function is a security risk.  */
+_GL_WARN_ON_USE (euidaccess, "the euidaccess function is a security risk - "
+                 "use the gnulib module faccessat instead");
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef euidaccess
+# if HAVE_RAW_DECL_EUIDACCESS
+_GL_WARN_ON_USE (euidaccess, "euidaccess is unportable - "
+                 "use gnulib module euidaccess for portability");
+# endif
+#endif
+
+
+#if @GNULIB_EXECL@
+# if @REPLACE_EXECL@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execl
+#   define execl rpl_execl
+#  endif
+_GL_FUNCDECL_RPL (execl, int, (const char *program, const char *arg, ...)
+                              _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (execl, int, (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execl, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execl);
+#elif defined GNULIB_POSIXCHECK
+# undef execl
+# if HAVE_RAW_DECL_EXECL
+_GL_WARN_ON_USE (execl, "execl behaves very differently on mingw - "
+                 "use gnulib module execl for portability");
+# endif
+#elif @GNULIB_MDA_EXECL@
+/* On native Windows, map 'execl' to '_execl', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execl always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execl
+#   define execl _execl
+#  endif
+_GL_CXXALIAS_MDA (execl, intptr_t, (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execl, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execl);
+#endif
+
+#if @GNULIB_EXECLE@
+# if @REPLACE_EXECLE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execle
+#   define execle rpl_execle
+#  endif
+_GL_FUNCDECL_RPL (execle, int, (const char *program, const char *arg, ...)
+                               _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (execle, int, (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execle, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execle);
+#elif defined GNULIB_POSIXCHECK
+# undef execle
+# if HAVE_RAW_DECL_EXECLE
+_GL_WARN_ON_USE (execle, "execle behaves very differently on mingw - "
+                 "use gnulib module execle for portability");
+# endif
+#elif @GNULIB_MDA_EXECLE@
+/* On native Windows, map 'execle' to '_execle', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execle always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execle
+#   define execle _execle
+#  endif
+_GL_CXXALIAS_MDA (execle, intptr_t,
+                  (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execle, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execle);
+#endif
+
+#if @GNULIB_EXECLP@
+# if @REPLACE_EXECLP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execlp
+#   define execlp rpl_execlp
+#  endif
+_GL_FUNCDECL_RPL (execlp, int, (const char *program, const char *arg, ...)
+                               _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (execlp, int, (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execlp, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execlp);
+#elif defined GNULIB_POSIXCHECK
+# undef execlp
+# if HAVE_RAW_DECL_EXECLP
+_GL_WARN_ON_USE (execlp, "execlp behaves very differently on mingw - "
+                 "use gnulib module execlp for portability");
+# endif
+#elif @GNULIB_MDA_EXECLP@
+/* On native Windows, map 'execlp' to '_execlp', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execlp always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execlp
+#   define execlp _execlp
+#  endif
+_GL_CXXALIAS_MDA (execlp, intptr_t,
+                  (const char *program, const char *arg, ...));
+# else
+_GL_CXXALIAS_SYS (execlp, int, (const char *program, const char *arg, ...));
+# endif
+_GL_CXXALIASWARN (execlp);
+#endif
+
+
+#if @GNULIB_EXECV@
+# if @REPLACE_EXECV@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execv
+#   define execv rpl_execv
+#  endif
+_GL_FUNCDECL_RPL (execv, int, (const char *program, char * const *argv)
+                              _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (execv, int, (const char *program, char * const *argv));
+# else
+_GL_CXXALIAS_SYS (execv, int, (const char *program, char * const *argv));
+# endif
+_GL_CXXALIASWARN (execv);
+#elif defined GNULIB_POSIXCHECK
+# undef execv
+# if HAVE_RAW_DECL_EXECV
+_GL_WARN_ON_USE (execv, "execv behaves very differently on mingw - "
+                 "use gnulib module execv for portability");
+# endif
+#elif @GNULIB_MDA_EXECV@
+/* On native Windows, map 'execv' to '_execv', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execv always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execv
+#   define execv _execv
+#  endif
+_GL_CXXALIAS_MDA_CAST (execv, intptr_t,
+                       (const char *program, char * const *argv));
+# else
+_GL_CXXALIAS_SYS (execv, int, (const char *program, char * const *argv));
+# endif
+_GL_CXXALIASWARN (execv);
+#endif
+
+#if @GNULIB_EXECVE@
+# if @REPLACE_EXECVE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execve
+#   define execve rpl_execve
+#  endif
+_GL_FUNCDECL_RPL (execve, int,
+                  (const char *program, char * const *argv, char * const *env)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (execve, int,
+                  (const char *program, char * const *argv, char * const *env));
+# else
+_GL_CXXALIAS_SYS (execve, int,
+                  (const char *program, char * const *argv, char * const *env));
+# endif
+_GL_CXXALIASWARN (execve);
+#elif defined GNULIB_POSIXCHECK
+# undef execve
+# if HAVE_RAW_DECL_EXECVE
+_GL_WARN_ON_USE (execve, "execve behaves very differently on mingw - "
+                 "use gnulib module execve for portability");
+# endif
+#elif @GNULIB_MDA_EXECVE@
+/* On native Windows, map 'execve' to '_execve', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execve always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execve
+#   define execve _execve
+#  endif
+_GL_CXXALIAS_MDA_CAST (execve, intptr_t,
+                       (const char *program, char * const *argv,
+                        char * const *env));
+# else
+_GL_CXXALIAS_SYS (execve, int,
+                  (const char *program, char * const *argv, char * const *env));
+# endif
+_GL_CXXALIASWARN (execve);
+#endif
+
+#if @GNULIB_EXECVP@
+# if @REPLACE_EXECVP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execvp
+#   define execvp rpl_execvp
+#  endif
+_GL_FUNCDECL_RPL (execvp, int, (const char *program, char * const *argv)
+                               _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (execvp, int, (const char *program, char * const *argv));
+# else
+_GL_CXXALIAS_SYS (execvp, int, (const char *program, char * const *argv));
+# endif
+_GL_CXXALIASWARN (execvp);
+#elif defined GNULIB_POSIXCHECK
+# undef execvp
+# if HAVE_RAW_DECL_EXECVP
+_GL_WARN_ON_USE (execvp, "execvp behaves very differently on mingw - "
+                 "use gnulib module execvp for portability");
+# endif
+#elif @GNULIB_MDA_EXECVP@
+/* On native Windows, map 'execvp' to '_execvp', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execvp always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execvp
+#   define execvp _execvp
+#  endif
+_GL_CXXALIAS_MDA_CAST (execvp, intptr_t,
+                       (const char *program, char * const *argv));
+# else
+_GL_CXXALIAS_SYS (execvp, int, (const char *program, char * const *argv));
+# endif
+_GL_CXXALIASWARN (execvp);
+#endif
+
+#if @GNULIB_EXECVPE@
+# if @REPLACE_EXECVPE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execvpe
+#   define execvpe rpl_execvpe
+#  endif
+_GL_FUNCDECL_RPL (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env));
+# else
+#  if !@HAVE_DECL_EXECVPE@
+_GL_FUNCDECL_SYS (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env)
+                  _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (execvpe);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef execvpe
+# if HAVE_RAW_DECL_EXECVPE
+_GL_WARN_ON_USE (execvpe, "execvpe behaves very differently on mingw - "
+                 "use gnulib module execvpe for portability");
+# endif
+#elif @GNULIB_MDA_EXECVPE@
+/* On native Windows, map 'execvpe' to '_execvpe', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::execvpe on all platforms that have
+   it.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef execvpe
+#   define execvpe _execvpe
+#  endif
+_GL_CXXALIAS_MDA_CAST (execvpe, intptr_t,
+                       (const char *program, char * const *argv,
+                        char * const *env));
+# elif @HAVE_EXECVPE@
+#  if !@HAVE_DECL_EXECVPE@
+_GL_FUNCDECL_SYS (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env)
+                  _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (execvpe, int,
+                  (const char *program, char * const *argv, char * const *env));
+# endif
+# if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_EXECVPE@
+_GL_CXXALIASWARN (execvpe);
+# endif
+#endif
+
+
+#if @GNULIB_FACCESSAT@
+# if @REPLACE_FACCESSAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef faccessat
+#   define faccessat rpl_faccessat
+#  endif
+_GL_FUNCDECL_RPL (faccessat, int,
+                  (int fd, char const *name, int mode, int flag)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (faccessat, int,
+                  (int fd, char const *name, int mode, int flag));
+# else
+#  if !@HAVE_FACCESSAT@
+_GL_FUNCDECL_SYS (faccessat, int,
+                  (int fd, char const *file, int mode, int flag)
+                  _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (faccessat, int,
+                  (int fd, char const *file, int mode, int flag));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (faccessat);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef faccessat
+# if HAVE_RAW_DECL_FACCESSAT
+_GL_WARN_ON_USE (faccessat, "faccessat is not portable - "
+                 "use gnulib module faccessat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FCHDIR@
+/* Change the process' current working directory to the directory on which
+   the given file descriptor is open.
+   Return 0 if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fchdir.html>.  */
+# if ! @HAVE_FCHDIR@
+_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
+
+/* Gnulib internal hooks needed to maintain the fchdir metadata.  */
+_GL_EXTERN_C int _gl_register_fd (int fd, const char *filename)
+     _GL_ARG_NONNULL ((2));
+_GL_EXTERN_C void _gl_unregister_fd (int fd);
+_GL_EXTERN_C int _gl_register_dup (int oldfd, int newfd);
+_GL_EXTERN_C const char *_gl_directory_name (int fd);
+
+# else
+#  if !@HAVE_DECL_FCHDIR@
+_GL_FUNCDECL_SYS (fchdir, int, (int /*fd*/));
+#  endif
+# endif
+_GL_CXXALIAS_SYS (fchdir, int, (int /*fd*/));
+_GL_CXXALIASWARN (fchdir);
+#elif defined GNULIB_POSIXCHECK
+# undef fchdir
+# if HAVE_RAW_DECL_FCHDIR
+_GL_WARN_ON_USE (fchdir, "fchdir is unportable - "
+                 "use gnulib module fchdir for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FCHOWNAT@
+# if @REPLACE_FCHOWNAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fchownat
+#   define fchownat rpl_fchownat
+#  endif
+_GL_FUNCDECL_RPL (fchownat, int, (int fd, char const *file,
+                                  uid_t owner, gid_t group, int flag)
+                                 _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (fchownat, int, (int fd, char const *file,
+                                  uid_t owner, gid_t group, int flag));
+# else
+#  if !@HAVE_FCHOWNAT@
+_GL_FUNCDECL_SYS (fchownat, int, (int fd, char const *file,
+                                  uid_t owner, gid_t group, int flag)
+                                 _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (fchownat, int, (int fd, char const *file,
+                                  uid_t owner, gid_t group, int flag));
+# endif
+_GL_CXXALIASWARN (fchownat);
+#elif defined GNULIB_POSIXCHECK
+# undef fchownat
+# if HAVE_RAW_DECL_FCHOWNAT
+_GL_WARN_ON_USE (fchownat, "fchownat is not portable - "
+                 "use gnulib module fchownat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FDATASYNC@
+/* Synchronize changes to a file.
+   Return 0 if successful, otherwise -1 and errno set.
+   See POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fdatasync.html>.  */
+# if @REPLACE_FDATASYNC@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef fdatasync
+#   define fdatasync rpl_fdatasync
+#  endif
+_GL_FUNCDECL_RPL (fdatasync, int, (int fd));
+_GL_CXXALIAS_RPL (fdatasync, int, (int fd));
+# else
+#  if !@HAVE_FDATASYNC@|| !@HAVE_DECL_FDATASYNC@
+_GL_FUNCDECL_SYS (fdatasync, int, (int fd));
+#  endif
+_GL_CXXALIAS_SYS (fdatasync, int, (int fd));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (fdatasync);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef fdatasync
+# if HAVE_RAW_DECL_FDATASYNC
+_GL_WARN_ON_USE (fdatasync, "fdatasync is unportable - "
+                 "use gnulib module fdatasync for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FSYNC@
+/* Synchronize changes, including metadata, to a file.
+   Return 0 if successful, otherwise -1 and errno set.
+   See POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html>.  */
+# if !@HAVE_FSYNC@
+_GL_FUNCDECL_SYS (fsync, int, (int fd));
+# endif
+_GL_CXXALIAS_SYS (fsync, int, (int fd));
+_GL_CXXALIASWARN (fsync);
+#elif defined GNULIB_POSIXCHECK
+# undef fsync
+# if HAVE_RAW_DECL_FSYNC
+_GL_WARN_ON_USE (fsync, "fsync is unportable - "
+                 "use gnulib module fsync for portability");
+# endif
+#endif
+
+
+#if @GNULIB_FTRUNCATE@
+/* Change the size of the file to which FD is opened to become equal to LENGTH.
+   Return 0 if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/ftruncate.html>.  */
+# if @REPLACE_FTRUNCATE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef ftruncate
+#   define ftruncate rpl_ftruncate
+#  endif
+_GL_FUNCDECL_RPL (ftruncate, int, (int fd, off_t length));
+_GL_CXXALIAS_RPL (ftruncate, int, (int fd, off_t length));
+# else
+#  if !@HAVE_FTRUNCATE@
+_GL_FUNCDECL_SYS (ftruncate, int, (int fd, off_t length));
+#  endif
+_GL_CXXALIAS_SYS (ftruncate, int, (int fd, off_t length));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (ftruncate);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef ftruncate
+# if HAVE_RAW_DECL_FTRUNCATE
+_GL_WARN_ON_USE (ftruncate, "ftruncate is unportable - "
+                 "use gnulib module ftruncate for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETCWD@
+/* Get the name of the current working directory, and put it in SIZE bytes
+   of BUF.
+   Return BUF if successful, or NULL if the directory couldn't be determined
+   or SIZE was too small.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getcwd.html>.
+   Additionally, the gnulib module 'getcwd' guarantees the following GNU
+   extension: If BUF is NULL, an array is allocated with 'malloc'; the array
+   is SIZE bytes long, unless SIZE == 0, in which case it is as big as
+   necessary.  */
+# if @REPLACE_GETCWD@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define getcwd rpl_getcwd
+#  endif
+_GL_FUNCDECL_RPL (getcwd, char *, (char *buf, size_t size));
+_GL_CXXALIAS_RPL (getcwd, char *, (char *buf, size_t size));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getcwd
+#   define getcwd _getcwd
+#  endif
+_GL_CXXALIAS_MDA (getcwd, char *, (char *buf, size_t size));
+# else
+/* Need to cast, because on mingw, the second parameter is
+                                                   int size.  */
+_GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
+# endif
+_GL_CXXALIASWARN (getcwd);
+#elif defined GNULIB_POSIXCHECK
+# undef getcwd
+# if HAVE_RAW_DECL_GETCWD
+_GL_WARN_ON_USE (getcwd, "getcwd is unportable - "
+                 "use gnulib module getcwd for portability");
+# endif
+#elif @GNULIB_MDA_GETCWD@
+/* On native Windows, map 'getcwd' to '_getcwd', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::getcwd always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getcwd
+#   define getcwd _getcwd
+#  endif
+/* Need to cast, because on mingw, the second parameter is either
+   'int size' or 'size_t size'.  */
+_GL_CXXALIAS_MDA_CAST (getcwd, char *, (char *buf, size_t size));
+# else
+_GL_CXXALIAS_SYS_CAST (getcwd, char *, (char *buf, size_t size));
+# endif
+_GL_CXXALIASWARN (getcwd);
+#endif
+
+
+#if @GNULIB_GETDOMAINNAME@
+/* Return the NIS domain name of the machine.
+   WARNING! The NIS domain name is unrelated to the fully qualified host name
+            of the machine.  It is also unrelated to email addresses.
+   WARNING! The NIS domain name is usually the empty string or "(none)" when
+            not using NIS.
+
+   Put up to LEN bytes of the NIS domain name into NAME.
+   Null terminate it if the name is shorter than LEN.
+   If the NIS domain name is longer than LEN, set errno = EINVAL and return -1.
+   Return 0 if successful, otherwise set errno and return -1.  */
+# if @REPLACE_GETDOMAINNAME@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getdomainname
+#   define getdomainname rpl_getdomainname
+#  endif
+_GL_FUNCDECL_RPL (getdomainname, int, (char *name, size_t len)
+                                      _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (getdomainname, int, (char *name, size_t len));
+# else
+#  if !@HAVE_DECL_GETDOMAINNAME@
+_GL_FUNCDECL_SYS (getdomainname, int, (char *name, size_t len)
+                                      _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (getdomainname, int, (char *name, size_t len));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getdomainname);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getdomainname
+# if HAVE_RAW_DECL_GETDOMAINNAME
+_GL_WARN_ON_USE (getdomainname, "getdomainname is unportable - "
+                 "use gnulib module getdomainname for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETDTABLESIZE@
+/* Return the maximum number of file descriptors in the current process.
+   In POSIX, this is same as sysconf (_SC_OPEN_MAX).  */
+# if @REPLACE_GETDTABLESIZE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getdtablesize
+#   define getdtablesize rpl_getdtablesize
+#  endif
+_GL_FUNCDECL_RPL (getdtablesize, int, (void));
+_GL_CXXALIAS_RPL (getdtablesize, int, (void));
+# else
+#  if !@HAVE_GETDTABLESIZE@
+_GL_FUNCDECL_SYS (getdtablesize, int, (void));
+#  endif
+/* Need to cast, because on AIX, the parameter list is
+                                           (...).  */
+_GL_CXXALIAS_SYS_CAST (getdtablesize, int, (void));
+# endif
+_GL_CXXALIASWARN (getdtablesize);
+#elif defined GNULIB_POSIXCHECK
+# undef getdtablesize
+# if HAVE_RAW_DECL_GETDTABLESIZE
+_GL_WARN_ON_USE (getdtablesize, "getdtablesize is unportable - "
+                 "use gnulib module getdtablesize for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETENTROPY@
+/* Fill a buffer with random bytes.  */
+# if @REPLACE_GETENTROPY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getentropy
+#   define getentropy rpl_getentropy
+#  endif
+_GL_FUNCDECL_RPL (getentropy, int, (void *buffer, size_t length));
+_GL_CXXALIAS_RPL (getentropy, int, (void *buffer, size_t length));
+# else
+#  if !@HAVE_GETENTROPY@
+_GL_FUNCDECL_SYS (getentropy, int, (void *buffer, size_t length));
+#  endif
+_GL_CXXALIAS_SYS (getentropy, int, (void *buffer, size_t length));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getentropy);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getentropy
+# if HAVE_RAW_DECL_GETENTROPY
+_GL_WARN_ON_USE (getentropy, "getentropy is unportable - "
+                 "use gnulib module getentropy for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETGROUPS@
+/* Return the supplemental groups that the current process belongs to.
+   It is unspecified whether the effective group id is in the list.
+   If N is 0, return the group count; otherwise, N describes how many
+   entries are available in GROUPS.  Return -1 and set errno if N is
+   not 0 and not large enough.  Fails with ENOSYS on some systems.  */
+# if @REPLACE_GETGROUPS@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getgroups
+#   define getgroups rpl_getgroups
+#  endif
+_GL_FUNCDECL_RPL (getgroups, int, (int n, gid_t *groups));
+_GL_CXXALIAS_RPL (getgroups, int, (int n, gid_t *groups));
+# else
+#  if !@HAVE_GETGROUPS@
+_GL_FUNCDECL_SYS (getgroups, int, (int n, gid_t *groups));
+#  endif
+_GL_CXXALIAS_SYS (getgroups, int, (int n, gid_t *groups));
+# endif
+_GL_CXXALIASWARN (getgroups);
+#elif defined GNULIB_POSIXCHECK
+# undef getgroups
+# if HAVE_RAW_DECL_GETGROUPS
+_GL_WARN_ON_USE (getgroups, "getgroups is unportable - "
+                 "use gnulib module getgroups for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETHOSTNAME@
+/* Return the standard host name of the machine.
+   WARNING! The host name may or may not be fully qualified.
+
+   Put up to LEN bytes of the host name into NAME.
+   Null terminate it if the name is shorter than LEN.
+   If the host name is longer than LEN, set errno = EINVAL and return -1.
+   Return 0 if successful, otherwise set errno and return -1.  */
+# if @UNISTD_H_HAVE_WINSOCK2_H@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef gethostname
+#   define gethostname rpl_gethostname
+#  endif
+_GL_FUNCDECL_RPL (gethostname, int, (char *name, size_t len)
+                                    _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (gethostname, int, (char *name, size_t len));
+# else
+#  if !@HAVE_GETHOSTNAME@
+_GL_FUNCDECL_SYS (gethostname, int, (char *name, size_t len)
+                                    _GL_ARG_NONNULL ((1)));
+#  endif
+/* Need to cast, because on Solaris 10 and OSF/1 5.1 systems, the second
+   parameter is
+                                                      int len.  */
+_GL_CXXALIAS_SYS_CAST (gethostname, int, (char *name, size_t len));
+# endif
+_GL_CXXALIASWARN (gethostname);
+#elif @UNISTD_H_HAVE_WINSOCK2_H@
+# undef gethostname
+# define gethostname gethostname_used_without_requesting_gnulib_module_gethostname
+#elif defined GNULIB_POSIXCHECK
+# undef gethostname
+# if HAVE_RAW_DECL_GETHOSTNAME
+_GL_WARN_ON_USE (gethostname, "gethostname is unportable - "
+                 "use gnulib module gethostname for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETLOGIN@
+/* Returns the user's login name, or NULL if it cannot be found.  Upon error,
+   returns NULL with errno set.
+
+   See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
+
+   Most programs don't need to use this function, because the information is
+   available through environment variables:
+     ${LOGNAME-$USER}        on Unix platforms,
+     $USERNAME               on native Windows platforms.
+ */
+# if !@HAVE_DECL_GETLOGIN@
+_GL_FUNCDECL_SYS (getlogin, char *, (void));
+# endif
+_GL_CXXALIAS_SYS (getlogin, char *, (void));
+_GL_CXXALIASWARN (getlogin);
+#elif defined GNULIB_POSIXCHECK
+# undef getlogin
+# if HAVE_RAW_DECL_GETLOGIN
+_GL_WARN_ON_USE (getlogin, "getlogin is unportable - "
+                 "use gnulib module getlogin for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETLOGIN_R@
+/* Copies the user's login name to NAME.
+   The array pointed to by NAME has room for SIZE bytes.
+
+   Returns 0 if successful.  Upon error, an error number is returned, or -1 in
+   the case that the login name cannot be found but no specific error is
+   provided (this case is hopefully rare but is left open by the POSIX spec).
+
+   See <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getlogin.html>.
+
+   Most programs don't need to use this function, because the information is
+   available through environment variables:
+     ${LOGNAME-$USER}        on Unix platforms,
+     $USERNAME               on native Windows platforms.
+ */
+# if @REPLACE_GETLOGIN_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define getlogin_r rpl_getlogin_r
+#  endif
+_GL_FUNCDECL_RPL (getlogin_r, int, (char *name, size_t size)
+                                   _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (getlogin_r, int, (char *name, size_t size));
+# else
+#  if !@HAVE_DECL_GETLOGIN_R@
+_GL_FUNCDECL_SYS (getlogin_r, int, (char *name, size_t size)
+                                   _GL_ARG_NONNULL ((1)));
+#  endif
+/* Need to cast, because on Solaris 10 systems, the second argument is
+                                                     int size.  */
+_GL_CXXALIAS_SYS_CAST (getlogin_r, int, (char *name, size_t size));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (getlogin_r);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getlogin_r
+# if HAVE_RAW_DECL_GETLOGIN_R
+_GL_WARN_ON_USE (getlogin_r, "getlogin_r is unportable - "
+                 "use gnulib module getlogin_r for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETPAGESIZE@
+# if @REPLACE_GETPAGESIZE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define getpagesize rpl_getpagesize
+#  endif
+_GL_FUNCDECL_RPL (getpagesize, int, (void));
+_GL_CXXALIAS_RPL (getpagesize, int, (void));
+# else
+/* On HP-UX, getpagesize exists, but it is not declared in <unistd.h> even if
+   the compiler options -D_HPUX_SOURCE -D_XOPEN_SOURCE=600 are used.  */
+#  if defined __hpux
+_GL_FUNCDECL_SYS (getpagesize, int, (void));
+#  endif
+#  if !@HAVE_GETPAGESIZE@
+#   if !defined getpagesize
+/* This is for POSIX systems.  */
+#    if !defined _gl_getpagesize && defined _SC_PAGESIZE
+#     if ! (defined __VMS && __VMS_VER < 70000000)
+#      define _gl_getpagesize() sysconf (_SC_PAGESIZE)
+#     endif
+#    endif
+/* This is for older VMS.  */
+#    if !defined _gl_getpagesize && defined __VMS
+#     ifdef __ALPHA
+#      define _gl_getpagesize() 8192
+#     else
+#      define _gl_getpagesize() 512
+#     endif
+#    endif
+/* This is for BeOS.  */
+#    if !defined _gl_getpagesize && @HAVE_OS_H@
+#     include <OS.h>
+#     if defined B_PAGE_SIZE
+#      define _gl_getpagesize() B_PAGE_SIZE
+#     endif
+#    endif
+/* This is for AmigaOS4.0.  */
+#    if !defined _gl_getpagesize && defined __amigaos4__
+#     define _gl_getpagesize() 2048
+#    endif
+/* This is for older Unix systems.  */
+#    if !defined _gl_getpagesize && @HAVE_SYS_PARAM_H@
+#     include <sys/param.h>
+#     ifdef EXEC_PAGESIZE
+#      define _gl_getpagesize() EXEC_PAGESIZE
+#     else
+#      ifdef NBPG
+#       ifndef CLSIZE
+#        define CLSIZE 1
+#       endif
+#       define _gl_getpagesize() (NBPG * CLSIZE)
+#      else
+#       ifdef NBPC
+#        define _gl_getpagesize() NBPC
+#       endif
+#      endif
+#     endif
+#    endif
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     define getpagesize() _gl_getpagesize ()
+#    else
+#     if !GNULIB_defined_getpagesize_function
+_GL_UNISTD_INLINE int
+getpagesize ()
+{
+  return _gl_getpagesize ();
+}
+#      define GNULIB_defined_getpagesize_function 1
+#     endif
+#    endif
+#   endif
+#  endif
+/* Need to cast, because on Cygwin 1.5.x systems, the return type is size_t.  */
+_GL_CXXALIAS_SYS_CAST (getpagesize, int, (void));
+# endif
+# if @HAVE_DECL_GETPAGESIZE@
+_GL_CXXALIASWARN (getpagesize);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef getpagesize
+# if HAVE_RAW_DECL_GETPAGESIZE
+_GL_WARN_ON_USE (getpagesize, "getpagesize is unportable - "
+                 "use gnulib module getpagesize for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GETPASS@
+/* Function getpass() from module 'getpass':
+     Read a password from /dev/tty or stdin.
+   Function getpass() from module 'getpass-gnu':
+     Read a password of arbitrary length from /dev/tty or stdin.  */
+# if (@GNULIB_GETPASS@ && @REPLACE_GETPASS@) \
+     || (@GNULIB_GETPASS_GNU@ && @REPLACE_GETPASS_FOR_GETPASS_GNU@)
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getpass
+#   define getpass rpl_getpass
+#  endif
+_GL_FUNCDECL_RPL (getpass, char *, (const char *prompt)
+                                   _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (getpass, char *, (const char *prompt));
+# else
+#  if !@HAVE_GETPASS@
+_GL_FUNCDECL_SYS (getpass, char *, (const char *prompt)
+                                   _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (getpass, char *, (const char *prompt));
+# endif
+_GL_CXXALIASWARN (getpass);
+#elif defined GNULIB_POSIXCHECK
+# undef getpass
+# if HAVE_RAW_DECL_GETPASS
+_GL_WARN_ON_USE (getpass, "getpass is unportable - "
+                 "use gnulib module getpass or getpass-gnu for portability");
+# endif
+#endif
+
+
+#if @GNULIB_MDA_GETPID@
+/* On native Windows, map 'getpid' to '_getpid', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::getpid always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef getpid
+#   define getpid _getpid
+#  endif
+_GL_CXXALIAS_MDA (getpid, int, (void));
+# else
+_GL_CXXALIAS_SYS (getpid, pid_t, (void));
+# endif
+_GL_CXXALIASWARN (getpid);
+#endif
+
+
+#if @GNULIB_GETUSERSHELL@
+/* Return the next valid login shell on the system, or NULL when the end of
+   the list has been reached.  */
+# if !@HAVE_DECL_GETUSERSHELL@
+_GL_FUNCDECL_SYS (getusershell, char *, (void));
+# endif
+_GL_CXXALIAS_SYS (getusershell, char *, (void));
+_GL_CXXALIASWARN (getusershell);
+#elif defined GNULIB_POSIXCHECK
+# undef getusershell
+# if HAVE_RAW_DECL_GETUSERSHELL
+_GL_WARN_ON_USE (getusershell, "getusershell is unportable - "
+                 "use gnulib module getusershell for portability");
+# endif
+#endif
+
+#if @GNULIB_GETUSERSHELL@
+/* Rewind to pointer that is advanced at each getusershell() call.  */
+# if !@HAVE_DECL_GETUSERSHELL@
+_GL_FUNCDECL_SYS (setusershell, void, (void));
+# endif
+_GL_CXXALIAS_SYS (setusershell, void, (void));
+_GL_CXXALIASWARN (setusershell);
+#elif defined GNULIB_POSIXCHECK
+# undef setusershell
+# if HAVE_RAW_DECL_SETUSERSHELL
+_GL_WARN_ON_USE (setusershell, "setusershell is unportable - "
+                 "use gnulib module getusershell for portability");
+# endif
+#endif
+
+#if @GNULIB_GETUSERSHELL@
+/* Free the pointer that is advanced at each getusershell() call and
+   associated resources.  */
+# if !@HAVE_DECL_GETUSERSHELL@
+_GL_FUNCDECL_SYS (endusershell, void, (void));
+# endif
+_GL_CXXALIAS_SYS (endusershell, void, (void));
+_GL_CXXALIASWARN (endusershell);
+#elif defined GNULIB_POSIXCHECK
+# undef endusershell
+# if HAVE_RAW_DECL_ENDUSERSHELL
+_GL_WARN_ON_USE (endusershell, "endusershell is unportable - "
+                 "use gnulib module getusershell for portability");
+# endif
+#endif
+
+
+#if @GNULIB_GROUP_MEMBER@
+/* Determine whether group id is in calling user's group list.  */
+# if !@HAVE_GROUP_MEMBER@
+_GL_FUNCDECL_SYS (group_member, int, (gid_t gid));
+# endif
+_GL_CXXALIAS_SYS (group_member, int, (gid_t gid));
+_GL_CXXALIASWARN (group_member);
+#elif defined GNULIB_POSIXCHECK
+# undef group_member
+# if HAVE_RAW_DECL_GROUP_MEMBER
+_GL_WARN_ON_USE (group_member, "group_member is unportable - "
+                 "use gnulib module group-member for portability");
+# endif
+#endif
+
+
+#if @GNULIB_ISATTY@
+# if @REPLACE_ISATTY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef isatty
+#   define isatty rpl_isatty
+#  endif
+#  define GNULIB_defined_isatty 1
+_GL_FUNCDECL_RPL (isatty, int, (int fd));
+_GL_CXXALIAS_RPL (isatty, int, (int fd));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef isatty
+#   define isatty _isatty
+#  endif
+_GL_CXXALIAS_MDA (isatty, int, (int fd));
+# else
+_GL_CXXALIAS_SYS (isatty, int, (int fd));
+# endif
+_GL_CXXALIASWARN (isatty);
+#elif defined GNULIB_POSIXCHECK
+# undef isatty
+# if HAVE_RAW_DECL_ISATTY
+_GL_WARN_ON_USE (isatty, "isatty has portability problems on native Windows - "
+                 "use gnulib module isatty for portability");
+# endif
+#elif @GNULIB_MDA_ISATTY@
+/* On native Windows, map 'isatty' to '_isatty', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::isatty always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef isatty
+#   define isatty _isatty
+#  endif
+_GL_CXXALIAS_MDA (isatty, int, (int fd));
+# else
+_GL_CXXALIAS_SYS (isatty, int, (int fd));
+# endif
+_GL_CXXALIASWARN (isatty);
+#endif
+
+
+#if @GNULIB_LCHOWN@
+/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE
+   to GID (if GID is not -1).  Do not follow symbolic links.
+   Return 0 if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lchown.html>.  */
+# if @REPLACE_LCHOWN@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef lchown
+#   define lchown rpl_lchown
+#  endif
+_GL_FUNCDECL_RPL (lchown, int, (char const *file, uid_t owner, gid_t group)
+                               _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (lchown, int, (char const *file, uid_t owner, gid_t group));
+# else
+#  if !@HAVE_LCHOWN@
+_GL_FUNCDECL_SYS (lchown, int, (char const *file, uid_t owner, gid_t group)
+                               _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (lchown, int, (char const *file, uid_t owner, gid_t group));
+# endif
+_GL_CXXALIASWARN (lchown);
+#elif defined GNULIB_POSIXCHECK
+# undef lchown
+# if HAVE_RAW_DECL_LCHOWN
+_GL_WARN_ON_USE (lchown, "lchown is unportable to pre-POSIX.1-2001 systems - "
+                 "use gnulib module lchown for portability");
+# endif
+#endif
+
+
+#if @GNULIB_LINK@
+/* Create a new hard link for an existing file.
+   Return 0 if successful, otherwise -1 and errno set.
+   See POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/link.html>.  */
+# if @REPLACE_LINK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define link rpl_link
+#  endif
+_GL_FUNCDECL_RPL (link, int, (const char *path1, const char *path2)
+                             _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (link, int, (const char *path1, const char *path2));
+# else
+#  if !@HAVE_LINK@
+_GL_FUNCDECL_SYS (link, int, (const char *path1, const char *path2)
+                             _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (link, int, (const char *path1, const char *path2));
+# endif
+_GL_CXXALIASWARN (link);
+#elif defined GNULIB_POSIXCHECK
+# undef link
+# if HAVE_RAW_DECL_LINK
+_GL_WARN_ON_USE (link, "link is unportable - "
+                 "use gnulib module link for portability");
+# endif
+#endif
+
+
+#if @GNULIB_LINKAT@
+/* Create a new hard link for an existing file, relative to two
+   directories.  FLAG controls whether symlinks are followed.
+   Return 0 if successful, otherwise -1 and errno set.  */
+# if @REPLACE_LINKAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef linkat
+#   define linkat rpl_linkat
+#  endif
+_GL_FUNCDECL_RPL (linkat, int,
+                  (int fd1, const char *path1, int fd2, const char *path2,
+                   int flag)
+                  _GL_ARG_NONNULL ((2, 4)));
+_GL_CXXALIAS_RPL (linkat, int,
+                  (int fd1, const char *path1, int fd2, const char *path2,
+                   int flag));
+# else
+#  if !@HAVE_LINKAT@
+_GL_FUNCDECL_SYS (linkat, int,
+                  (int fd1, const char *path1, int fd2, const char *path2,
+                   int flag)
+                  _GL_ARG_NONNULL ((2, 4)));
+#  endif
+_GL_CXXALIAS_SYS (linkat, int,
+                  (int fd1, const char *path1, int fd2, const char *path2,
+                   int flag));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (linkat);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef linkat
+# if HAVE_RAW_DECL_LINKAT
+_GL_WARN_ON_USE (linkat, "linkat is unportable - "
+                 "use gnulib module linkat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_LSEEK@
+/* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END.
+   Return the new offset if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/lseek.html>.  */
+# if @REPLACE_LSEEK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define lseek rpl_lseek
+#  endif
+_GL_FUNCDECL_RPL (lseek, off_t, (int fd, off_t offset, int whence));
+_GL_CXXALIAS_RPL (lseek, off_t, (int fd, off_t offset, int whence));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef lseek
+#   define lseek _lseek
+#  endif
+_GL_CXXALIAS_MDA (lseek, off_t, (int fd, off_t offset, int whence));
+# else
+_GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
+# endif
+_GL_CXXALIASWARN (lseek);
+#elif defined GNULIB_POSIXCHECK
+# undef lseek
+# if HAVE_RAW_DECL_LSEEK
+_GL_WARN_ON_USE (lseek, "lseek does not fail with ESPIPE on pipes on some "
+                 "systems - use gnulib module lseek for portability");
+# endif
+#elif @GNULIB_MDA_LSEEK@
+/* On native Windows, map 'lseek' to '_lseek', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::lseek always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef lseek
+#   define lseek _lseek
+#  endif
+_GL_CXXALIAS_MDA (lseek, long, (int fd, long offset, int whence));
+# else
+_GL_CXXALIAS_SYS (lseek, off_t, (int fd, off_t offset, int whence));
+# endif
+_GL_CXXALIASWARN (lseek);
+#endif
+
+
+#if @GNULIB_PIPE@
+/* Create a pipe, defaulting to O_BINARY mode.
+   Store the read-end as fd0 and the write-end as fd1.
+   Return 0 upon success, or -1 with errno set upon failure.  */
+# if !@HAVE_PIPE@
+_GL_FUNCDECL_SYS (pipe, int, (int fd2) _GL_ARG_NONNULL ((1)));
+# endif
+_GL_CXXALIAS_SYS (pipe, int, (int fd2));
+_GL_CXXALIASWARN (pipe);
+#elif defined GNULIB_POSIXCHECK
+# undef pipe
+# if HAVE_RAW_DECL_PIPE
+_GL_WARN_ON_USE (pipe, "pipe is unportable - "
+                 "use gnulib module pipe-posix for portability");
+# endif
+#endif
+
+
+#if @GNULIB_PIPE2@
+/* Create a pipe, applying the given flags when opening the read-end of the
+   pipe and the write-end of the pipe.
+   The flags are a bitmask, possibly including O_CLOEXEC (defined in <fcntl.h>)
+   and O_TEXT, O_BINARY (defined in "binary-io.h").
+   Store the read-end as fd0 and the write-end as fd1.
+   Return 0 upon success, or -1 with errno set upon failure.
+   See also the Linux man page at
+   <https://www.kernel.org/doc/man-pages/online/pages/man2/pipe2.2.html>.  */
+# if @REPLACE_PIPE2@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef pipe2
+#   define pipe2 rpl_pipe2
+#  endif
+_GL_FUNCDECL_RPL (pipe2, int, (int fd2, int flags) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (pipe2, int, (int fd2, int flags));
+# else
+_GL_FUNCDECL_SYS (pipe2, int, (int fd2, int flags) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_SYS (pipe2, int, (int fd2, int flags));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (pipe2);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef pipe2
+# if HAVE_RAW_DECL_PIPE2
+_GL_WARN_ON_USE (pipe2, "pipe2 is unportable - "
+                 "use gnulib module pipe2 for portability");
+# endif
+#endif
+
+
+#if @GNULIB_PREAD@
+/* Read at most BUFSIZE bytes from FD into BUF, starting at OFFSET.
+   Return the number of bytes placed into BUF if successful, otherwise
+   set errno and return -1.  0 indicates EOF.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pread.html>.  */
+# if @REPLACE_PREAD@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef pread
+#   define pread rpl_pread
+#  endif
+_GL_FUNCDECL_RPL (pread, ssize_t,
+                  (int fd, void *buf, size_t bufsize, off_t offset)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (pread, ssize_t,
+                  (int fd, void *buf, size_t bufsize, off_t offset));
+# else
+#  if !@HAVE_PREAD@
+_GL_FUNCDECL_SYS (pread, ssize_t,
+                  (int fd, void *buf, size_t bufsize, off_t offset)
+                  _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (pread, ssize_t,
+                  (int fd, void *buf, size_t bufsize, off_t offset));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (pread);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef pread
+# if HAVE_RAW_DECL_PREAD
+_GL_WARN_ON_USE (pread, "pread is unportable - "
+                 "use gnulib module pread for portability");
+# endif
+#endif
+
+
+#if @GNULIB_PWRITE@
+/* Write at most BUFSIZE bytes from BUF into FD, starting at OFFSET.
+   Return the number of bytes written if successful, otherwise
+   set errno and return -1.  0 indicates nothing written.  See the
+   POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/pwrite.html>.  */
+# if @REPLACE_PWRITE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef pwrite
+#   define pwrite rpl_pwrite
+#  endif
+_GL_FUNCDECL_RPL (pwrite, ssize_t,
+                  (int fd, const void *buf, size_t bufsize, off_t offset)
+                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (pwrite, ssize_t,
+                  (int fd, const void *buf, size_t bufsize, off_t offset));
+# else
+#  if !@HAVE_PWRITE@
+_GL_FUNCDECL_SYS (pwrite, ssize_t,
+                  (int fd, const void *buf, size_t bufsize, off_t offset)
+                  _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (pwrite, ssize_t,
+                  (int fd, const void *buf, size_t bufsize, off_t offset));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (pwrite);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef pwrite
+# if HAVE_RAW_DECL_PWRITE
+_GL_WARN_ON_USE (pwrite, "pwrite is unportable - "
+                 "use gnulib module pwrite for portability");
+# endif
+#endif
+
+
+#if @GNULIB_READ@
+/* Read up to COUNT bytes from file descriptor FD into the buffer starting
+   at BUF.  See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/read.html>.  */
+# if @REPLACE_READ@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef read
+#   define read rpl_read
+#  endif
+_GL_FUNCDECL_RPL (read, ssize_t, (int fd, void *buf, size_t count)
+                                 _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (read, ssize_t, (int fd, void *buf, size_t count));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef read
+#   define read _read
+#  endif
+_GL_CXXALIAS_MDA (read, ssize_t, (int fd, void *buf, size_t count));
+# else
+_GL_CXXALIAS_SYS (read, ssize_t, (int fd, void *buf, size_t count));
+# endif
+_GL_CXXALIASWARN (read);
+#elif @GNULIB_MDA_READ@
+/* On native Windows, map 'read' to '_read', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::read always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef read
+#   define read _read
+#  endif
+#  ifdef __MINGW32__
+_GL_CXXALIAS_MDA (read, int, (int fd, void *buf, unsigned int count));
+#  else
+_GL_CXXALIAS_MDA (read, ssize_t, (int fd, void *buf, unsigned int count));
+#  endif
+# else
+_GL_CXXALIAS_SYS (read, ssize_t, (int fd, void *buf, size_t count));
+# endif
+_GL_CXXALIASWARN (read);
+#endif
+
+
+#if @GNULIB_READLINK@
+/* Read the contents of the symbolic link FILE and place the first BUFSIZE
+   bytes of it into BUF.  Return the number of bytes placed into BUF if
+   successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/readlink.html>.  */
+# if @REPLACE_READLINK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define readlink rpl_readlink
+#  endif
+_GL_FUNCDECL_RPL (readlink, ssize_t,
+                  (const char *restrict file,
+                   char *restrict buf, size_t bufsize)
+                  _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (readlink, ssize_t,
+                  (const char *restrict file,
+                   char *restrict buf, size_t bufsize));
+# else
+#  if !@HAVE_READLINK@
+_GL_FUNCDECL_SYS (readlink, ssize_t,
+                  (const char *restrict file,
+                   char *restrict buf, size_t bufsize)
+                  _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (readlink, ssize_t,
+                  (const char *restrict file,
+                   char *restrict buf, size_t bufsize));
+# endif
+_GL_CXXALIASWARN (readlink);
+#elif defined GNULIB_POSIXCHECK
+# undef readlink
+# if HAVE_RAW_DECL_READLINK
+_GL_WARN_ON_USE (readlink, "readlink is unportable - "
+                 "use gnulib module readlink for portability");
+# endif
+#endif
+
+
+#if @GNULIB_READLINKAT@
+# if @REPLACE_READLINKAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define readlinkat rpl_readlinkat
+#  endif
+_GL_FUNCDECL_RPL (readlinkat, ssize_t,
+                  (int fd, char const *restrict file,
+                   char *restrict buf, size_t len)
+                  _GL_ARG_NONNULL ((2, 3)));
+_GL_CXXALIAS_RPL (readlinkat, ssize_t,
+                  (int fd, char const *restrict file,
+                   char *restrict buf, size_t len));
+# else
+#  if !@HAVE_READLINKAT@
+_GL_FUNCDECL_SYS (readlinkat, ssize_t,
+                  (int fd, char const *restrict file,
+                   char *restrict buf, size_t len)
+                  _GL_ARG_NONNULL ((2, 3)));
+#  endif
+_GL_CXXALIAS_SYS (readlinkat, ssize_t,
+                  (int fd, char const *restrict file,
+                   char *restrict buf, size_t len));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (readlinkat);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef readlinkat
+# if HAVE_RAW_DECL_READLINKAT
+_GL_WARN_ON_USE (readlinkat, "readlinkat is not portable - "
+                 "use gnulib module readlinkat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_RMDIR@
+/* Remove the directory DIR.  */
+# if @REPLACE_RMDIR@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   define rmdir rpl_rmdir
+#  endif
+_GL_FUNCDECL_RPL (rmdir, int, (char const *name) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (rmdir, int, (char const *name));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef rmdir
+#   define rmdir _rmdir
+#  endif
+_GL_CXXALIAS_MDA (rmdir, int, (char const *name));
+# else
+_GL_CXXALIAS_SYS (rmdir, int, (char const *name));
+# endif
+_GL_CXXALIASWARN (rmdir);
+#elif defined GNULIB_POSIXCHECK
+# undef rmdir
+# if HAVE_RAW_DECL_RMDIR
+_GL_WARN_ON_USE (rmdir, "rmdir is unportable - "
+                 "use gnulib module rmdir for portability");
+# endif
+#elif @GNULIB_MDA_RMDIR@
+/* On native Windows, map 'rmdir' to '_rmdir', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::rmdir always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef rmdir
+#   define rmdir _rmdir
+#  endif
+_GL_CXXALIAS_MDA (rmdir, int, (char const *name));
+# else
+_GL_CXXALIAS_SYS (rmdir, int, (char const *name));
+# endif
+_GL_CXXALIASWARN (rmdir);
+#endif
+
+
+#if @GNULIB_SETHOSTNAME@
+/* Set the host name of the machine.
+   The host name may or may not be fully qualified.
+
+   Put LEN bytes of NAME into the host name.
+   Return 0 if successful, otherwise, set errno and return -1.
+
+   Platforms with no ability to set the hostname return -1 and set
+   errno = ENOSYS.  */
+# if @REPLACE_SETHOSTNAME@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef sethostname
+#   define sethostname rpl_sethostname
+#  endif
+_GL_FUNCDECL_RPL (sethostname, int, (const char *name, size_t len)
+                                    _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (sethostname, int, (const char *name, size_t len));
+# else
+#  if !@HAVE_SETHOSTNAME@ || !@HAVE_DECL_SETHOSTNAME@
+_GL_FUNCDECL_SYS (sethostname, int, (const char *name, size_t len)
+                                    _GL_ARG_NONNULL ((1)));
+#  endif
+/* Need to cast, because on Solaris 11 2011-10, Mac OS X 10.5, IRIX 6.5
+   and FreeBSD 6.4 the second parameter is int.  On Solaris 11
+   2011-10, the first parameter is not const.  */
+_GL_CXXALIAS_SYS_CAST (sethostname, int, (const char *name, size_t len));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (sethostname);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef sethostname
+# if HAVE_RAW_DECL_SETHOSTNAME
+_GL_WARN_ON_USE (sethostname, "sethostname is unportable - "
+                 "use gnulib module sethostname for portability");
+# endif
+#endif
+
+
+#if @GNULIB_SLEEP@
+/* Pause the execution of the current thread for N seconds.
+   Returns the number of seconds left to sleep.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/sleep.html>.  */
+# if @REPLACE_SLEEP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef sleep
+#   define sleep rpl_sleep
+#  endif
+_GL_FUNCDECL_RPL (sleep, unsigned int, (unsigned int n));
+_GL_CXXALIAS_RPL (sleep, unsigned int, (unsigned int n));
+# else
+#  if !@HAVE_SLEEP@
+_GL_FUNCDECL_SYS (sleep, unsigned int, (unsigned int n));
+#  endif
+_GL_CXXALIAS_SYS (sleep, unsigned int, (unsigned int n));
+# endif
+_GL_CXXALIASWARN (sleep);
+#elif defined GNULIB_POSIXCHECK
+# undef sleep
+# if HAVE_RAW_DECL_SLEEP
+_GL_WARN_ON_USE (sleep, "sleep is unportable - "
+                 "use gnulib module sleep for portability");
+# endif
+#endif
+
+
+#if @GNULIB_MDA_SWAB@
+/* On native Windows, map 'swab' to '_swab', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::swab always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef swab
+#   define swab _swab
+#  endif
+/* Need to cast, because in old mingw the arguments are
+                             (const char *from, char *to, size_t n).  */
+_GL_CXXALIAS_MDA_CAST (swab, void, (char *from, char *to, int n));
+# else
+#  if defined __hpux /* HP-UX */
+_GL_CXXALIAS_SYS (swab, void, (const char *from, char *to, int n));
+#  elif defined __sun && (defined __SunOS_5_10 || defined __XOPEN_OR_POSIX) && !defined _XPG4 /* Solaris */
+_GL_CXXALIAS_SYS (swab, void, (const char *from, char *to, ssize_t n));
+#  else
+_GL_CXXALIAS_SYS (swab, void, (const void *from, void *to, ssize_t n));
+#  endif
+# endif
+_GL_CXXALIASWARN (swab);
+#endif
+
+
+#if @GNULIB_SYMLINK@
+# if @REPLACE_SYMLINK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef symlink
+#   define symlink rpl_symlink
+#  endif
+_GL_FUNCDECL_RPL (symlink, int, (char const *contents, char const *file)
+                                _GL_ARG_NONNULL ((1, 2)));
+_GL_CXXALIAS_RPL (symlink, int, (char const *contents, char const *file));
+# else
+#  if !@HAVE_SYMLINK@
+_GL_FUNCDECL_SYS (symlink, int, (char const *contents, char const *file)
+                                _GL_ARG_NONNULL ((1, 2)));
+#  endif
+_GL_CXXALIAS_SYS (symlink, int, (char const *contents, char const *file));
+# endif
+_GL_CXXALIASWARN (symlink);
+#elif defined GNULIB_POSIXCHECK
+# undef symlink
+# if HAVE_RAW_DECL_SYMLINK
+_GL_WARN_ON_USE (symlink, "symlink is not portable - "
+                 "use gnulib module symlink for portability");
+# endif
+#endif
+
+
+#if @GNULIB_SYMLINKAT@
+# if @REPLACE_SYMLINKAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef symlinkat
+#   define symlinkat rpl_symlinkat
+#  endif
+_GL_FUNCDECL_RPL (symlinkat, int,
+                  (char const *contents, int fd, char const *file)
+                  _GL_ARG_NONNULL ((1, 3)));
+_GL_CXXALIAS_RPL (symlinkat, int,
+                  (char const *contents, int fd, char const *file));
+# else
+#  if !@HAVE_SYMLINKAT@
+_GL_FUNCDECL_SYS (symlinkat, int,
+                  (char const *contents, int fd, char const *file)
+                  _GL_ARG_NONNULL ((1, 3)));
+#  endif
+_GL_CXXALIAS_SYS (symlinkat, int,
+                  (char const *contents, int fd, char const *file));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (symlinkat);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef symlinkat
+# if HAVE_RAW_DECL_SYMLINKAT
+_GL_WARN_ON_USE (symlinkat, "symlinkat is not portable - "
+                 "use gnulib module symlinkat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_TRUNCATE@
+/* Change the size of the file designated by FILENAME to become equal to LENGTH.
+   Return 0 if successful, otherwise -1 and errno set.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/truncate.html>.  */
+# if @REPLACE_TRUNCATE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef truncate
+#   define truncate rpl_truncate
+#  endif
+_GL_FUNCDECL_RPL (truncate, int, (const char *filename, off_t length)
+                                 _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (truncate, int, (const char *filename, off_t length));
+# else
+#  if !@HAVE_DECL_TRUNCATE@
+_GL_FUNCDECL_SYS (truncate, int, (const char *filename, off_t length)
+                                 _GL_ARG_NONNULL ((1)));
+#  endif
+_GL_CXXALIAS_SYS (truncate, int, (const char *filename, off_t length));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (truncate);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef truncate
+# if HAVE_RAW_DECL_TRUNCATE
+_GL_WARN_ON_USE (truncate, "truncate is unportable - "
+                 "use gnulib module truncate for portability");
+# endif
+#endif
+
+
+#if @GNULIB_TTYNAME_R@
+/* Store at most BUFLEN characters of the pathname of the terminal FD is
+   open on in BUF.  Return 0 on success, otherwise an error number.  */
+# if @REPLACE_TTYNAME_R@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef ttyname_r
+#   define ttyname_r rpl_ttyname_r
+#  endif
+_GL_FUNCDECL_RPL (ttyname_r, int,
+                  (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (ttyname_r, int,
+                  (int fd, char *buf, size_t buflen));
+# else
+#  if !@HAVE_DECL_TTYNAME_R@
+_GL_FUNCDECL_SYS (ttyname_r, int,
+                  (int fd, char *buf, size_t buflen) _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (ttyname_r, int,
+                  (int fd, char *buf, size_t buflen));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (ttyname_r);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef ttyname_r
+# if HAVE_RAW_DECL_TTYNAME_R
+_GL_WARN_ON_USE (ttyname_r, "ttyname_r is not portable - "
+                 "use gnulib module ttyname_r for portability");
+# endif
+#endif
+
+
+#if @GNULIB_UNLINK@
+# if @REPLACE_UNLINK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef unlink
+#   define unlink rpl_unlink
+#  endif
+_GL_FUNCDECL_RPL (unlink, int, (char const *file) _GL_ARG_NONNULL ((1)));
+_GL_CXXALIAS_RPL (unlink, int, (char const *file));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef unlink
+#   define unlink _unlink
+#  endif
+_GL_CXXALIAS_MDA (unlink, int, (char const *file));
+# else
+_GL_CXXALIAS_SYS (unlink, int, (char const *file));
+# endif
+_GL_CXXALIASWARN (unlink);
+#elif defined GNULIB_POSIXCHECK
+# undef unlink
+# if HAVE_RAW_DECL_UNLINK
+_GL_WARN_ON_USE (unlink, "unlink is not portable - "
+                 "use gnulib module unlink for portability");
+# endif
+#elif @GNULIB_MDA_UNLINK@
+/* On native Windows, map 'unlink' to '_unlink', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::unlink always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef unlink
+#   define unlink _unlink
+#  endif
+_GL_CXXALIAS_MDA (unlink, int, (char const *file));
+# else
+_GL_CXXALIAS_SYS (unlink, int, (char const *file));
+# endif
+_GL_CXXALIASWARN (unlink);
+#endif
+
+
+#if @GNULIB_UNLINKAT@
+# if @REPLACE_UNLINKAT@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef unlinkat
+#   define unlinkat rpl_unlinkat
+#  endif
+_GL_FUNCDECL_RPL (unlinkat, int, (int fd, char const *file, int flag)
+                                 _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (unlinkat, int, (int fd, char const *file, int flag));
+# else
+#  if !@HAVE_UNLINKAT@
+_GL_FUNCDECL_SYS (unlinkat, int, (int fd, char const *file, int flag)
+                                 _GL_ARG_NONNULL ((2)));
+#  endif
+_GL_CXXALIAS_SYS (unlinkat, int, (int fd, char const *file, int flag));
+# endif
+_GL_CXXALIASWARN (unlinkat);
+#elif defined GNULIB_POSIXCHECK
+# undef unlinkat
+# if HAVE_RAW_DECL_UNLINKAT
+_GL_WARN_ON_USE (unlinkat, "unlinkat is not portable - "
+                 "use gnulib module unlinkat for portability");
+# endif
+#endif
+
+
+#if @GNULIB_USLEEP@
+/* Pause the execution of the current thread for N microseconds.
+   Returns 0 on completion, or -1 on range error.
+   See the POSIX:2001 specification
+   <https://pubs.opengroup.org/onlinepubs/009695399/functions/usleep.html>.  */
+# if @REPLACE_USLEEP@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef usleep
+#   define usleep rpl_usleep
+#  endif
+_GL_FUNCDECL_RPL (usleep, int, (useconds_t n));
+_GL_CXXALIAS_RPL (usleep, int, (useconds_t n));
+# else
+#  if !@HAVE_USLEEP@
+_GL_FUNCDECL_SYS (usleep, int, (useconds_t n));
+#  endif
+/* Need to cast, because on Haiku, the first parameter is
+                                     unsigned int n.  */
+_GL_CXXALIAS_SYS_CAST (usleep, int, (useconds_t n));
+# endif
+_GL_CXXALIASWARN (usleep);
+#elif defined GNULIB_POSIXCHECK
+# undef usleep
+# if HAVE_RAW_DECL_USLEEP
+_GL_WARN_ON_USE (usleep, "usleep is unportable - "
+                 "use gnulib module usleep for portability");
+# endif
+#endif
+
+
+#if @GNULIB_WRITE@
+/* Write up to COUNT bytes starting at BUF to file descriptor FD.
+   See the POSIX:2008 specification
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/write.html>.  */
+# if @REPLACE_WRITE@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef write
+#   define write rpl_write
+#  endif
+_GL_FUNCDECL_RPL (write, ssize_t, (int fd, const void *buf, size_t count)
+                                  _GL_ARG_NONNULL ((2)));
+_GL_CXXALIAS_RPL (write, ssize_t, (int fd, const void *buf, size_t count));
+# elif defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef write
+#   define write _write
+#  endif
+_GL_CXXALIAS_MDA (write, ssize_t, (int fd, const void *buf, size_t count));
+# else
+_GL_CXXALIAS_SYS (write, ssize_t, (int fd, const void *buf, size_t count));
+# endif
+_GL_CXXALIASWARN (write);
+#elif @GNULIB_MDA_WRITE@
+/* On native Windows, map 'write' to '_write', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::write always.  */
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef write
+#   define write _write
+#  endif
+#  ifdef __MINGW32__
+_GL_CXXALIAS_MDA (write, int, (int fd, const void *buf, unsigned int count));
+#  else
+_GL_CXXALIAS_MDA (write, ssize_t, (int fd, const void *buf, unsigned int count));
+#  endif
+# else
+_GL_CXXALIAS_SYS (write, ssize_t, (int fd, const void *buf, size_t count));
+# endif
+_GL_CXXALIASWARN (write);
+#endif
+
+_GL_INLINE_HEADER_END
+
+#endif /* _@GUARD_PREFIX@_UNISTD_H */
+#endif /* _GL_INCLUDING_UNISTD_H */
+#endif /* _@GUARD_PREFIX@_UNISTD_H */

_service:tar_scm:groff-1.22.4.tar.gz/lib/unitypes.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/unitypes.in.h Changed

@@ -1,17 +1,17 @@
 /* Elementary types and macros for the GNU UniString library.
-   Copyright (C) 2002, 2005-2006, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2005-2006, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _UNITYPES_H
@@ -26,7 +26,7 @@
 /* Attribute of a function whose result depends only on the arguments
    (not pointers!) and which has no side effects.  */
 #ifndef _UC_ATTRIBUTE_CONST
-# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95) || defined __clang__
 #  define _UC_ATTRIBUTE_CONST __attribute__ ((__const__))
 # else
 #  define _UC_ATTRIBUTE_CONST
@@ -36,11 +36,26 @@
 /* Attribute of a function whose result depends only on the arguments
    (possibly pointers) and global memory, and which has no side effects.  */
 #ifndef _UC_ATTRIBUTE_PURE
-# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) || defined __clang__
 #  define _UC_ATTRIBUTE_PURE __attribute__ ((__pure__))
 # else
 #  define _UC_ATTRIBUTE_PURE
 # endif
 #endif
 
+/* Qualifier in a function declaration, that asserts that the caller must
+   pass a pointer to a different object in the specified pointer argument
+   than in the other pointer arguments.  */
+#ifndef _UC_RESTRICT
+# if defined __restrict \
+     || 2 < __GNUC__ + (95 <= __GNUC_MINOR__) \
+     || __clang_major__ >= 3
+#  define _UC_RESTRICT __restrict
+# elif 199901L <= __STDC_VERSION__ || defined restrict
+#  define _UC_RESTRICT restrict
+# else
+#  define _UC_RESTRICT
+# endif
+#endif
+
 #endif /* _UNITYPES_H */

_service:tar_scm:groff-1.22.4.tar.gz/lib/uniwidth.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/uniwidth.in.h Changed

@@ -1,18 +1,18 @@
 /* Display width functions.
-   Copyright (C) 2001-2002, 2005, 2007, 2009-2018 Free Software Foundation,
+   Copyright (C) 2001-2002, 2005, 2007, 2009-2023 Free Software Foundation,
    Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _UNIWIDTH_H

_service:tar_scm:groff-1.22.4.tar.gz/lib/uniwidth/cjk.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/uniwidth/cjk.h Changed

@@ -1,18 +1,18 @@
 /* Test for CJK encoding.
-   Copyright (C) 2001-2002, 2005-2007, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2001-2002, 2005-2007, 2009-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2002.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include "streq.h"

_service:tar_scm:groff-1.22.4.tar.gz/lib/uniwidth/width.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/uniwidth/width.c Changed

@@ -1,18 +1,18 @@
 /* Determine display width of Unicode character.
-   Copyright (C) 2001-2002, 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 2001-2002, 2006-2023 Free Software Foundation, Inc.
    Written by Bruno Haible <bruno@clisp.org>, 2002.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>
@@ -22,400 +22,43 @@
 
 #include "cjk.h"
 
-/*
- * Non-spacing attribute table.
- * Consists of:
- * - Non-spacing characters; generated from PropList.txt or
- *   "grep '^^;*;^;*;^;*;^;*;NSM;' UnicodeData.txt"
- * - Format control characters; generated from
- *   "grep '^^;*;^;*;Cf;' UnicodeData.txt"
- * - Zero width characters; generated from
- *   "grep '^^;*;ZERO WIDTH ' UnicodeData.txt"
+/* The non-spacing attribute table consists of:
+   * Non-spacing characters; generated from PropList.txt or
+     "grep '^^;*;^;*;^;*;^;*;NSM;' UnicodeData.txt"
+   * Format control characters; generated from
+     "grep '^^;*;^;*;Cf;' UnicodeData.txt"
+   * Zero width characters; generated from
+     "grep '^^;*;ZERO WIDTH ' UnicodeData.txt"
+   * Hangul Jamo characters that have conjoining behaviour:
+       - jungseong = syllable-middle vowels
+       - jongseong = syllable-final consonants
+     Rationale:
+     1) These characters act like combining characters. They have no
+     equivalent in legacy character sets. Therefore the EastAsianWidth.txt
+     file does not really matter for them; UAX #11 East Asian Width
+     <https://www.unicode.org/reports/tr11/> makes it clear that it focus
+     is on compatibility with traditional Japanese layout.
+     By contrast, the same glyphs without conjoining behaviour are available
+     in the U+3130..U+318F block, and these characters are mapped to legacy
+     character sets, and traditional Japanese layout matters for them.
+     2) glibc does the same thing, see
+     <https://sourceware.org/bugzilla/show_bug.cgi?id=21750>
+     <https://sourceware.org/bugzilla/show_bug.cgi?id=26120>
  */
-static const unsigned char nonspacing_table_data38*64 = {
-  /* 0x0000-0x01ff */
-  0xff, 0xff, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00, /* 0x0000-0x003f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0x0040-0x007f */
-  0xff, 0xff, 0xff, 0xff, 0x00, 0x20, 0x00, 0x00, /* 0x0080-0x00bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x00c0-0x00ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0100-0x013f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0140-0x017f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0180-0x01bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x01c0-0x01ff */
-  /* 0x0200-0x03ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0200-0x023f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0240-0x027f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0280-0x02bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x02c0-0x02ff */
-  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x0300-0x033f */
-  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x00, 0x00, /* 0x0340-0x037f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0380-0x03bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x03c0-0x03ff */
-  /* 0x0400-0x05ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0400-0x043f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0440-0x047f */
-  0xf8, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0480-0x04bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x04c0-0x04ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0500-0x053f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0540-0x057f */
-  0x00, 0x00, 0xfe, 0xff, 0xff, 0xff, 0xff, 0xbf, /* 0x0580-0x05bf */
-  0xb6, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x05c0-0x05ff */
-  /* 0x0600-0x07ff */
-  0x3f, 0x00, 0xff, 0x17, 0x00, 0x00, 0x00, 0x00, /* 0x0600-0x063f */
-  0x00, 0xf8, 0xff, 0xff, 0x00, 0x00, 0x01, 0x00, /* 0x0640-0x067f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0680-0x06bf */
-  0x00, 0x00, 0xc0, 0xbf, 0x9f, 0x3d, 0x00, 0x00, /* 0x06c0-0x06ff */
-  0x00, 0x80, 0x02, 0x00, 0x00, 0x00, 0xff, 0xff, /* 0x0700-0x073f */
-  0xff, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0740-0x077f */
-  0x00, 0x00, 0x00, 0x00, 0xc0, 0xff, 0x01, 0x00, /* 0x0780-0x07bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0x00, /* 0x07c0-0x07ff */
-  /* 0x0800-0x09ff */
-  0x00, 0x00, 0xc0, 0xfb, 0xef, 0x3e, 0x00, 0x00, /* 0x0800-0x083f */
-  0x00, 0x00, 0x00, 0x0e, 0x00, 0x00, 0x00, 0x00, /* 0x0840-0x087f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0880-0x08bf */
-  0x00, 0x00, 0xf0, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x08c0-0x08ff */
-  0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x14, /* 0x0900-0x093f */
-  0xfe, 0x21, 0xfe, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0940-0x097f */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0980-0x09bf */
-  0x1e, 0x20, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x09c0-0x09ff */
-  /* 0x0a00-0x0bff */
-  0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0a00-0x0a3f */
-  0x86, 0x39, 0x02, 0x00, 0x00, 0x00, 0x23, 0x00, /* 0x0a40-0x0a7f */
-  0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0a80-0x0abf */
-  0xbe, 0x21, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0ac0-0x0aff */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x90, /* 0x0b00-0x0b3f */
-  0x1e, 0x20, 0x40, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0b40-0x0b7f */
-  0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0b80-0x0bbf */
-  0x01, 0x20, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0bc0-0x0bff */
-  /* 0x0c00-0x0dff */
-  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, /* 0x0c00-0x0c3f */
-  0xc1, 0x3d, 0x60, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0c40-0x0c7f */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0c80-0x0cbf */
-  0x00, 0x30, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0cc0-0x0cff */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0d00-0x0d3f */
-  0x1e, 0x20, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0d40-0x0d7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0d80-0x0dbf */
-  0x00, 0x04, 0x5c, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0dc0-0x0dff */
-  /* 0x0e00-0x0fff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf2, 0x07, /* 0x0e00-0x0e3f */
-  0x80, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0e40-0x0e7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf2, 0x1b, /* 0x0e80-0x0ebf */
-  0x00, 0x3f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0ec0-0x0eff */
-  0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0xa0, 0x02, /* 0x0f00-0x0f3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x7f, /* 0x0f40-0x0f7f */
-  0xdf, 0xe0, 0xff, 0xfe, 0xff, 0xff, 0xff, 0x1f, /* 0x0f80-0x0fbf */
-  0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0fc0-0x0fff */
-  /* 0x1000-0x11ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0xe0, 0xfd, 0x66, /* 0x1000-0x103f */
-  0x00, 0x00, 0x00, 0xc3, 0x01, 0x00, 0x1e, 0x00, /* 0x1040-0x107f */
-  0x64, 0x20, 0x00, 0x20, 0x00, 0x00, 0x00, 0x00, /* 0x1080-0x10bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10c0-0x10ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1100-0x113f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1140-0x117f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1180-0x11bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11c0-0x11ff */
-  /* 0x1200-0x13ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1200-0x123f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1240-0x127f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1280-0x12bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x12c0-0x12ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1300-0x133f */
-  0x00, 0x00, 0x00, 0xe0, 0x00, 0x00, 0x00, 0x00, /* 0x1340-0x137f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1380-0x13bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13c0-0x13ff */
-  /* 0x1600-0x17ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1600-0x163f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1640-0x167f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1680-0x16bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16c0-0x16ff */
-  0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x1c, 0x00, /* 0x1700-0x173f */
-  0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, 0x0c, 0x00, /* 0x1740-0x177f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xb0, 0x3f, /* 0x1780-0x17bf */
-  0x40, 0xfe, 0x0f, 0x20, 0x00, 0x00, 0x00, 0x00, /* 0x17c0-0x17ff */
-  /* 0x1800-0x19ff */
-  0x00, 0x78, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1800-0x183f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1840-0x187f */
-  0x60, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, /* 0x1880-0x18bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x18c0-0x18ff */
-  0x00, 0x00, 0x00, 0x00, 0x87, 0x01, 0x04, 0x0e, /* 0x1900-0x193f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1940-0x197f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1980-0x19bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x19c0-0x19ff */
-  /* 0x1a00-0x1bff */
-  0x00, 0x00, 0x80, 0x09, 0x00, 0x00, 0x00, 0x00, /* 0x1a00-0x1a3f */
-  0x00, 0x00, 0x40, 0x7f, 0xe5, 0x1f, 0xf8, 0x9f, /* 0x1a40-0x1a7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0x7f, /* 0x1a80-0x1abf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1ac0-0x1aff */
-  0x0f, 0x00, 0x00, 0x00, 0x00, 0x00, 0xd0, 0x17, /* 0x1b00-0x1b3f */
-  0x04, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0x00, /* 0x1b40-0x1b7f */
-  0x03, 0x00, 0x00, 0x00, 0x3c, 0x3b, 0x00, 0x00, /* 0x1b80-0x1bbf */
-  0x00, 0x00, 0x00, 0x00, 0x40, 0xa3, 0x03, 0x00, /* 0x1bc0-0x1bff */
-  /* 0x1c00-0x1dff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0xf0, 0xcf, 0x00, /* 0x1c00-0x1c3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1c40-0x1c7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1c80-0x1cbf */
-  0x00, 0x00, 0xf7, 0xff, 0xfd, 0x21, 0x10, 0x03, /* 0x1cc0-0x1cff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d00-0x1d3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d40-0x1d7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d80-0x1dbf */
-  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x3f, 0xf8, /* 0x1dc0-0x1dff */
-  /* 0x2000-0x21ff */
-  0x00, 0xf8, 0x00, 0x00, 0x00, 0x7c, 0x00, 0x00, /* 0x2000-0x203f */
-  0x00, 0x00, 0x00, 0x00, 0xdf, 0xff, 0x00, 0x00, /* 0x2040-0x207f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2080-0x20bf */
-  0x00, 0x00, 0xff, 0xff, 0xff, 0xff, 0x01, 0x00, /* 0x20c0-0x20ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2100-0x213f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2140-0x217f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2180-0x21bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x21c0-0x21ff */
-  /* 0x2c00-0x2dff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c00-0x2c3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c40-0x2c7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c80-0x2cbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x03, 0x00, /* 0x2cc0-0x2cff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2d00-0x2d3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0x2d40-0x2d7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2d80-0x2dbf */
-  0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff, /* 0x2dc0-0x2dff */
-  /* 0x3000-0x31ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x3c, 0x00, 0x00, /* 0x3000-0x303f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3040-0x307f */
-  0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00, 0x00, /* 0x3080-0x30bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x30c0-0x30ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3100-0x313f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3140-0x317f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3180-0x31bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x31c0-0x31ff */
-  /* 0xa600-0xa7ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa600-0xa63f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xf7, 0x3f, /* 0xa640-0xa67f */
-  0x00, 0x00, 0x00, 0xc0, 0x00, 0x00, 0x00, 0x00, /* 0xa680-0xa6bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, /* 0xa6c0-0xa6ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa700-0xa73f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa740-0xa77f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa780-0xa7bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa7c0-0xa7ff */
-  /* 0xa800-0xa9ff */
-  0x44, 0x08, 0x00, 0x00, 0x60, 0x00, 0x00, 0x00, /* 0xa800-0xa83f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa840-0xa87f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa880-0xa8bf */
-  0x30, 0x00, 0x00, 0x00, 0xff, 0xff, 0x03, 0x00, /* 0xa8c0-0xa8ff */
-  0x00, 0x00, 0x00, 0x00, 0xc0, 0x3f, 0x00, 0x00, /* 0xa900-0xa93f */
-  0x80, 0xff, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa940-0xa97f */
-  0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc8, 0x13, /* 0xa980-0xa9bf */
-  0x00, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, 0x00, /* 0xa9c0-0xa9ff */
-  /* 0xaa00-0xabff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x7e, 0x66, 0x00, /* 0xaa00-0xaa3f */
-  0x08, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0xaa40-0xaa7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x9d, 0xc1, /* 0xaa80-0xaabf */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x30, 0x40, 0x00, /* 0xaac0-0xaaff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab00-0xab3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab40-0xab7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab80-0xabbf */
-  0x00, 0x00, 0x00, 0x00, 0x20, 0x21, 0x00, 0x00, /* 0xabc0-0xabff */
-  /* 0xfa00-0xfbff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa00-0xfa3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa40-0xfa7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa80-0xfabf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfac0-0xfaff */
-  0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00, /* 0xfb00-0xfb3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfb40-0xfb7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfb80-0xfbbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfbc0-0xfbff */
-  /* 0xfe00-0xffff */
-  0xff, 0xff, 0x00, 0x00, 0xff, 0xff, 0x00, 0x00, /* 0xfe00-0xfe3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfe40-0xfe7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfe80-0xfebf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0xfec0-0xfeff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff00-0xff3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff40-0xff7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff80-0xffbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0e, /* 0xffc0-0xffff */
-  /* 0x10000-0x101ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10000-0x1003f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10040-0x1007f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10080-0x100bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x100c0-0x100ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10100-0x1013f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10140-0x1017f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10180-0x101bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, /* 0x101c0-0x101ff */
-  /* 0x10200-0x103ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10200-0x1023f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10240-0x1027f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10280-0x102bf */
-  0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, /* 0x102c0-0x102ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10300-0x1033f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x07, /* 0x10340-0x1037f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10380-0x103bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x103c0-0x103ff */
-  /* 0x10a00-0x10bff */
-  0x6e, 0xf0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x87, /* 0x10a00-0x10a3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10a40-0x10a7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10a80-0x10abf */
-  0x00, 0x00, 0x00, 0x00, 0x60, 0x00, 0x00, 0x00, /* 0x10ac0-0x10aff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b00-0x10b3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b40-0x10b7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b80-0x10bbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10bc0-0x10bff */
-  /* 0x11000-0x111ff */
-  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, /* 0x11000-0x1103f */
-  0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0x11040-0x1107f */
-  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x78, 0x26, /* 0x11080-0x110bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x110c0-0x110ff */
-  0x07, 0x00, 0x00, 0x00, 0x80, 0xef, 0x1f, 0x00, /* 0x11100-0x1113f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x08, 0x00, /* 0x11140-0x1117f */
-  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x7f, /* 0x11180-0x111bf */
-  0x00, 0x1c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x111c0-0x111ff */
-  /* 0x11200-0x113ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xd3, 0x40, /* 0x11200-0x1123f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11240-0x1127f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11280-0x112bf */
-  0x00, 0x00, 0x00, 0x80, 0xf8, 0x07, 0x00, 0x00, /* 0x112c0-0x112ff */
-  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x11300-0x1133f */
-  0x01, 0x00, 0x00, 0x00, 0xc0, 0x1f, 0x1f, 0x00, /* 0x11340-0x1137f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11380-0x113bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x113c0-0x113ff */
-  /* 0x11400-0x115ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, /* 0x11400-0x1143f */
-  0x5c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11440-0x1147f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x85, /* 0x11480-0x114bf */
-  0x0d, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x114c0-0x114ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11500-0x1153f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11540-0x1157f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3c, 0xb0, /* 0x11580-0x115bf */
-  0x01, 0x00, 0x00, 0x30, 0x00, 0x00, 0x00, 0x00, /* 0x115c0-0x115ff */
-  /* 0x11600-0x117ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0xa7, /* 0x11600-0x1163f */
-  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11640-0x1167f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x28, 0xbf, 0x00, /* 0x11680-0x116bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x116c0-0x116ff */
-  0x00, 0x00, 0x00, 0xe0, 0xbc, 0x0f, 0x00, 0x00, /* 0x11700-0x1173f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11740-0x1177f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11780-0x117bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x117c0-0x117ff */
-  /* 0x11c00-0x11dff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7f, 0x3f, /* 0x11c00-0x11c3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11c40-0x11c7f */
-  0x00, 0x00, 0xfc, 0xff, 0xff, 0xfc, 0x6d, 0x00, /* 0x11c80-0x11cbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11cc0-0x11cff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11d00-0x11d3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11d40-0x11d7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11d80-0x11dbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11dc0-0x11dff */
-  /* 0x16a00-0x16bff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a00-0x16a3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a40-0x16a7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a80-0x16abf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1f, 0x00, /* 0x16ac0-0x16aff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7f, 0x00, /* 0x16b00-0x16b3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16b40-0x16b7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16b80-0x16bbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16bc0-0x16bff */
-  /* 0x16e00-0x16fff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e00-0x16e3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e40-0x16e7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e80-0x16ebf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16ec0-0x16eff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f00-0x16f3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f40-0x16f7f */
-  0x00, 0x80, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f80-0x16fbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16fc0-0x16fff */
-  /* 0x1bc00-0x1bdff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bc00-0x1bc3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bc40-0x1bc7f */
-  0x00, 0x00, 0x00, 0x60, 0x0f, 0x00, 0x00, 0x00, /* 0x1bc80-0x1bcbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bcc0-0x1bcff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd00-0x1bd3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd40-0x1bd7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd80-0x1bdbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bdc0-0x1bdff */
-  /* 0x1d000-0x1d1ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d000-0x1d03f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d040-0x1d07f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d080-0x1d0bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d0c0-0x1d0ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d100-0x1d13f */
-  0x00, 0x00, 0x00, 0x00, 0x80, 0x03, 0xf8, 0xff, /* 0x1d140-0x1d17f */
-  0xe7, 0x0f, 0x00, 0x00, 0x00, 0x3c, 0x00, 0x00, /* 0x1d180-0x1d1bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d1c0-0x1d1ff */
-  /* 0x1d200-0x1d3ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d200-0x1d23f */
-  0x1c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d240-0x1d27f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d280-0x1d2bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d2c0-0x1d2ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d300-0x1d33f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d340-0x1d37f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d380-0x1d3bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d3c0-0x1d3ff */
-  /* 0x1da00-0x1dbff */
-  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x7f, 0xf8, /* 0x1da00-0x1da3f */
-  0xff, 0xff, 0xff, 0xff, 0xff, 0x1f, 0x20, 0x00, /* 0x1da40-0x1da7f */
-  0x10, 0x00, 0x00, 0xf8, 0xfe, 0xff, 0x00, 0x00, /* 0x1da80-0x1dabf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1dac0-0x1daff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db00-0x1db3f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db40-0x1db7f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db80-0x1dbbf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1dbc0-0x1dbff */
-  /* 0x1e000-0x1e1ff */
-  0x7f, 0xff, 0xff, 0xf9, 0xdb, 0x07, 0x00, 0x00, /* 0x1e000-0x1e03f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e040-0x1e07f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e080-0x1e0bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e0c0-0x1e0ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e100-0x1e13f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e140-0x1e17f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e180-0x1e1bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e1c0-0x1e1ff */
-  /* 0x1e800-0x1e9ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e800-0x1e83f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e840-0x1e87f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e880-0x1e8bf */
-  0x00, 0x00, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e8c0-0x1e8ff */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e900-0x1e93f */
-  0xf0, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e940-0x1e97f */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e980-0x1e9bf */
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00  /* 0x1e9c0-0x1e9ff */
-};
-static const signed char nonspacing_table_ind248 = {
-   0,  1,  2,  3,  4,  5,  6,  7, /* 0x0000-0x0fff */
-   8,  9, -1, 10, 11, 12, 13, -1, /* 0x1000-0x1fff */
-  14, -1, -1, -1, -1, -1, 15, -1, /* 0x2000-0x2fff */
-  16, -1, -1, -1, -1, -1, -1, -1, /* 0x3000-0x3fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x4000-0x4fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x5000-0x5fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x6000-0x6fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x7000-0x7fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x8000-0x8fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x9000-0x9fff */
-  -1, -1, -1, 17, 18, 19, -1, -1, /* 0xa000-0xafff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xb000-0xbfff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xc000-0xcfff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xd000-0xdfff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xe000-0xefff */
-  -1, -1, -1, -1, -1, 20, -1, 21, /* 0xf000-0xffff */
-  22, 23, -1, -1, -1, 24, -1, -1, /* 0x10000-0x10fff */
-  25, 26, 27, 28, -1, -1, 29, -1, /* 0x11000-0x11fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x12000-0x12fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x13000-0x13fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x14000-0x14fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x15000-0x15fff */
-  -1, -1, -1, -1, -1, 30, -1, 31, /* 0x16000-0x16fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x17000-0x17fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x18000-0x18fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x19000-0x19fff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x1a000-0x1afff */
-  -1, -1, -1, -1, -1, -1, 32, -1, /* 0x1b000-0x1bfff */
-  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x1c000-0x1cfff */
-  33, 34, -1, -1, -1, 35, -1, -1, /* 0x1d000-0x1dfff */
-  36, -1, -1, -1, 37, -1, -1, -1  /* 0x1e000-0x1efff */
-};
+#include "uniwidth/width0.h"
+
+#include "uniwidth/width2.h"
+#include "unictype/bitmap.h"
+
+#define SIZEOF(a) (sizeof(a) / sizeof(a0))
+
 
 /* Determine number of column positions required for UC.  */
 int
 uc_width (ucs4_t uc, const char *encoding)
 {
   /* Test for non-spacing or control character.  */
-  if ((uc >> 9) < 248)
+  if ((uc >> 9) < SIZEOF (nonspacing_table_ind))
     {
       int ind = nonspacing_table_induc >> 9;
       if (ind >= 0)
@@ -440,24 +83,8 @@
             return 0;
         }
     }
-  /* Test for double-width character.
-   * Generated from "grep '^^;\{4,5\};WF' EastAsianWidth.txt"
-   * and            "grep '^^;\{4,5\};^WF' EastAsianWidth.txt"
-   */
-  if (uc >= 0x1100
-      && ((uc < 0x1160) /* Hangul Jamo */
-          || (uc >= 0x2329 && uc < 0x232b) /* Angle Brackets */
-          || (uc >= 0x2e80 && uc < 0xa4d0  /* CJK ... Yi */
-              && !(uc == 0x303f) && !(uc >= 0x4dc0 && uc < 0x4e00))
-          || (uc >= 0xac00 && uc < 0xd7a4) /* Hangul Syllables */
-          || (uc >= 0xf900 && uc < 0xfb00) /* CJK Compatibility Ideographs */
-          || (uc >= 0xfe10 && uc < 0xfe20) /* Presentation Forms for Vertical */
-          || (uc >= 0xfe30 && uc < 0xfe70) /* CJK Compatibility Forms */
-          || (uc >= 0xff00 && uc < 0xff61) /* Fullwidth Forms */
-          || (uc >= 0xffe0 && uc < 0xffe7) /* Fullwidth Signs */
-          || (uc >= 0x20000 && uc <= 0x2ffff) /* Supplementary Ideographic Plane */
-          || (uc >= 0x30000 && uc <= 0x3ffff) /* Tertiary Ideographic Plane */
-     )   )
+  /* Test for double-width character.  */
+  if (bitmap_lookup (&u_width2, uc))
     return 2;
   /* In ancient CJK encodings, Cyrillic and most other characters are
      double-width as well.  */

_service:tar_scm:groff-1.23.0.tar.gz/lib/uniwidth/width0.h Added

@@ -0,0 +1,494 @@
+/* DO NOT EDIT! GENERATED AUTOMATICALLY! */
+/* Table of non-spacing or control characters.  */
+/* Generated automatically by gen-uni-tables.c for Unicode 15.0.0.  */
+
+/* Copyright (C) 2000-2022 Free Software Foundation, Inc.
+
+   This file is free software.
+   It is dual-licensed under "the GNU LGPLv3+ or the GNU GPLv2+".
+   You can redistribute it and/or modify it under either
+     - the terms of the GNU Lesser General Public License as published
+       by the Free Software Foundation, either version 3, or (at your
+       option) any later version, or
+     - the terms of the GNU General Public License as published by the
+       Free Software Foundation; either version 2, or (at your option)
+       any later version, or
+     - the same dual license "the GNU LGPLv3+ or the GNU GPLv2+".
+
+   This file 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
+   Lesser General Public License and the GNU General Public License
+   for more details.
+
+   You should have received a copy of the GNU Lesser General Public
+   License and of the GNU General Public License along with this
+   program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+static const unsigned char nonspacing_table_data48*64 = {
+  /* 0x0000-0x01ff */
+  0xff, 0xff, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00, /* 0x0000-0x003f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0x0040-0x007f */
+  0xff, 0xff, 0xff, 0xff, 0x00, 0x20, 0x00, 0x00, /* 0x0080-0x00bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x00c0-0x00ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0100-0x013f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0140-0x017f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0180-0x01bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x01c0-0x01ff */
+  /* 0x0200-0x03ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0200-0x023f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0240-0x027f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0280-0x02bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x02c0-0x02ff */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x0300-0x033f */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x00, 0x00, /* 0x0340-0x037f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0380-0x03bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x03c0-0x03ff */
+  /* 0x0400-0x05ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0400-0x043f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0440-0x047f */
+  0xf8, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0480-0x04bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x04c0-0x04ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0500-0x053f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0540-0x057f */
+  0x00, 0x00, 0xfe, 0xff, 0xff, 0xff, 0xff, 0xbf, /* 0x0580-0x05bf */
+  0xb6, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x05c0-0x05ff */
+  /* 0x0600-0x07ff */
+  0x3f, 0x00, 0xff, 0x17, 0x00, 0x00, 0x00, 0x00, /* 0x0600-0x063f */
+  0x00, 0xf8, 0xff, 0xff, 0x00, 0x00, 0x01, 0x00, /* 0x0640-0x067f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0680-0x06bf */
+  0x00, 0x00, 0xc0, 0xbf, 0x9f, 0x3d, 0x00, 0x00, /* 0x06c0-0x06ff */
+  0x00, 0x80, 0x02, 0x00, 0x00, 0x00, 0xff, 0xff, /* 0x0700-0x073f */
+  0xff, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0740-0x077f */
+  0x00, 0x00, 0x00, 0x00, 0xc0, 0xff, 0x01, 0x00, /* 0x0780-0x07bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0x20, /* 0x07c0-0x07ff */
+  /* 0x0800-0x09ff */
+  0x00, 0x00, 0xc0, 0xfb, 0xef, 0x3e, 0x00, 0x00, /* 0x0800-0x083f */
+  0x00, 0x00, 0x00, 0x0e, 0x00, 0x00, 0x00, 0x00, /* 0x0840-0x087f */
+  0x00, 0x00, 0x03, 0xff, 0x00, 0x00, 0x00, 0x00, /* 0x0880-0x08bf */
+  0x00, 0xfc, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x08c0-0x08ff */
+  0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x14, /* 0x0900-0x093f */
+  0xfe, 0x21, 0xfe, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0940-0x097f */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0980-0x09bf */
+  0x1e, 0x20, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x40, /* 0x09c0-0x09ff */
+  /* 0x0a00-0x0bff */
+  0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0a00-0x0a3f */
+  0x86, 0x39, 0x02, 0x00, 0x00, 0x00, 0x23, 0x00, /* 0x0a40-0x0a7f */
+  0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0a80-0x0abf */
+  0xbe, 0x21, 0x00, 0x00, 0x0c, 0x00, 0x00, 0xfc, /* 0x0ac0-0x0aff */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x90, /* 0x0b00-0x0b3f */
+  0x1e, 0x20, 0x60, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0b40-0x0b7f */
+  0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0b80-0x0bbf */
+  0x01, 0x20, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0bc0-0x0bff */
+  /* 0x0c00-0x0dff */
+  0x11, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xd0, /* 0x0c00-0x0c3f */
+  0xc1, 0x3d, 0x60, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0c40-0x0c7f */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0x0c80-0x0cbf */
+  0x00, 0x30, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0cc0-0x0cff */
+  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, /* 0x0d00-0x0d3f */
+  0x1e, 0x20, 0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, /* 0x0d40-0x0d7f */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0d80-0x0dbf */
+  0x00, 0x04, 0x5c, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0dc0-0x0dff */
+  /* 0x0e00-0x0fff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf2, 0x07, /* 0x0e00-0x0e3f */
+  0x80, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0e40-0x0e7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf2, 0x1f, /* 0x0e80-0x0ebf */
+  0x00, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0ec0-0x0eff */
+  0x00, 0x00, 0x00, 0x03, 0x00, 0x00, 0xa0, 0x02, /* 0x0f00-0x0f3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xfe, 0x7f, /* 0x0f40-0x0f7f */
+  0xdf, 0xe0, 0xff, 0xfe, 0xff, 0xff, 0xff, 0x1f, /* 0x0f80-0x0fbf */
+  0x40, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x0fc0-0x0fff */
+  /* 0x1000-0x11ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0xe0, 0xfd, 0x66, /* 0x1000-0x103f */
+  0x00, 0x00, 0x00, 0xc3, 0x01, 0x00, 0x1e, 0x00, /* 0x1040-0x107f */
+  0x64, 0x20, 0x00, 0x20, 0x00, 0x00, 0x00, 0x00, /* 0x1080-0x10bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10c0-0x10ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1100-0x113f */
+  0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff, /* 0x1140-0x117f */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x1180-0x11bf */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x11c0-0x11ff */
+  /* 0x1200-0x13ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1200-0x123f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1240-0x127f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1280-0x12bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x12c0-0x12ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1300-0x133f */
+  0x00, 0x00, 0x00, 0xe0, 0x00, 0x00, 0x00, 0x00, /* 0x1340-0x137f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1380-0x13bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13c0-0x13ff */
+  /* 0x1600-0x17ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1600-0x163f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1640-0x167f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1680-0x16bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16c0-0x16ff */
+  0x00, 0x00, 0x1c, 0x00, 0x00, 0x00, 0x0c, 0x00, /* 0x1700-0x173f */
+  0x00, 0x00, 0x0c, 0x00, 0x00, 0x00, 0x0c, 0x00, /* 0x1740-0x177f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xb0, 0x3f, /* 0x1780-0x17bf */
+  0x40, 0xfe, 0x0f, 0x20, 0x00, 0x00, 0x00, 0x00, /* 0x17c0-0x17ff */
+  /* 0x1800-0x19ff */
+  0x00, 0xf8, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1800-0x183f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1840-0x187f */
+  0x60, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, /* 0x1880-0x18bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x18c0-0x18ff */
+  0x00, 0x00, 0x00, 0x00, 0x87, 0x01, 0x04, 0x0e, /* 0x1900-0x193f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1940-0x197f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1980-0x19bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x19c0-0x19ff */
+  /* 0x1a00-0x1bff */
+  0x00, 0x00, 0x80, 0x09, 0x00, 0x00, 0x00, 0x00, /* 0x1a00-0x1a3f */
+  0x00, 0x00, 0x40, 0x7f, 0xe5, 0x1f, 0xf8, 0x9f, /* 0x1a40-0x1a7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, /* 0x1a80-0x1abf */
+  0xff, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1ac0-0x1aff */
+  0x0f, 0x00, 0x00, 0x00, 0x00, 0x00, 0xd0, 0x17, /* 0x1b00-0x1b3f */
+  0x04, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x0f, 0x00, /* 0x1b40-0x1b7f */
+  0x03, 0x00, 0x00, 0x00, 0x3c, 0x3b, 0x00, 0x00, /* 0x1b80-0x1bbf */
+  0x00, 0x00, 0x00, 0x00, 0x40, 0xa3, 0x03, 0x00, /* 0x1bc0-0x1bff */
+  /* 0x1c00-0x1dff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0xf0, 0xcf, 0x00, /* 0x1c00-0x1c3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1c40-0x1c7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1c80-0x1cbf */
+  0x00, 0x00, 0xf7, 0xff, 0xfd, 0x21, 0x10, 0x03, /* 0x1cc0-0x1cff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d00-0x1d3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d40-0x1d7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d80-0x1dbf */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, /* 0x1dc0-0x1dff */
+  /* 0x2000-0x21ff */
+  0x00, 0xf8, 0x00, 0x00, 0x00, 0x7c, 0x00, 0x00, /* 0x2000-0x203f */
+  0x00, 0x00, 0x00, 0x00, 0xdf, 0xff, 0x00, 0x00, /* 0x2040-0x207f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2080-0x20bf */
+  0x00, 0x00, 0xff, 0xff, 0xff, 0xff, 0x01, 0x00, /* 0x20c0-0x20ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2100-0x213f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2140-0x217f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2180-0x21bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x21c0-0x21ff */
+  /* 0x2c00-0x2dff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c00-0x2c3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c40-0x2c7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2c80-0x2cbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x03, 0x00, /* 0x2cc0-0x2cff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2d00-0x2d3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0x2d40-0x2d7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x2d80-0x2dbf */
+  0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff, /* 0x2dc0-0x2dff */
+  /* 0x3000-0x31ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x3c, 0x00, 0x00, /* 0x3000-0x303f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3040-0x307f */
+  0x00, 0x00, 0x00, 0x06, 0x00, 0x00, 0x00, 0x00, /* 0x3080-0x30bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x30c0-0x30ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3100-0x313f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3140-0x317f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x3180-0x31bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x31c0-0x31ff */
+  /* 0xa600-0xa7ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa600-0xa63f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xf7, 0x3f, /* 0xa640-0xa67f */
+  0x00, 0x00, 0x00, 0xc0, 0x00, 0x00, 0x00, 0x00, /* 0xa680-0xa6bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x00, /* 0xa6c0-0xa6ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa700-0xa73f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa740-0xa77f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa780-0xa7bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa7c0-0xa7ff */
+  /* 0xa800-0xa9ff */
+  0x44, 0x08, 0x00, 0x00, 0x60, 0x10, 0x00, 0x00, /* 0xa800-0xa83f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa840-0xa87f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa880-0xa8bf */
+  0x30, 0x00, 0x00, 0x00, 0xff, 0xff, 0x03, 0x80, /* 0xa8c0-0xa8ff */
+  0x00, 0x00, 0x00, 0x00, 0xc0, 0x3f, 0x00, 0x00, /* 0xa900-0xa93f */
+  0x80, 0xff, 0x03, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xa940-0xa97f */
+  0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc8, 0x33, /* 0xa980-0xa9bf */
+  0x00, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, 0x00, /* 0xa9c0-0xa9ff */
+  /* 0xaa00-0xabff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x7e, 0x66, 0x00, /* 0xaa00-0xaa3f */
+  0x08, 0x10, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, /* 0xaa40-0xaa7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x9d, 0xc1, /* 0xaa80-0xaabf */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x30, 0x40, 0x00, /* 0xaac0-0xaaff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab00-0xab3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab40-0xab7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xab80-0xabbf */
+  0x00, 0x00, 0x00, 0x00, 0x20, 0x21, 0x00, 0x00, /* 0xabc0-0xabff */
+  /* 0xd600-0xd7ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd600-0xd63f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd640-0xd67f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd680-0xd6bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd6c0-0xd6ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd700-0xd73f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xd740-0xd77f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, /* 0xd780-0xd7bf */
+  0x7f, 0xf8, 0xff, 0xff, 0xff, 0xff, 0xff, 0x0f, /* 0xd7c0-0xd7ff */
+  /* 0xfa00-0xfbff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa00-0xfa3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa40-0xfa7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfa80-0xfabf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfac0-0xfaff */
+  0x00, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00, /* 0xfb00-0xfb3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfb40-0xfb7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfb80-0xfbbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfbc0-0xfbff */
+  /* 0xfe00-0xffff */
+  0xff, 0xff, 0x00, 0x00, 0xff, 0xff, 0x00, 0x00, /* 0xfe00-0xfe3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfe40-0xfe7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xfe80-0xfebf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, /* 0xfec0-0xfeff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff00-0xff3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff40-0xff7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0xff80-0xffbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0e, /* 0xffc0-0xffff */
+  /* 0x10000-0x101ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10000-0x1003f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10040-0x1007f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10080-0x100bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x100c0-0x100ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10100-0x1013f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10140-0x1017f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10180-0x101bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, /* 0x101c0-0x101ff */
+  /* 0x10200-0x103ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10200-0x1023f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10240-0x1027f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10280-0x102bf */
+  0x00, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, /* 0x102c0-0x102ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10300-0x1033f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x07, /* 0x10340-0x1037f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10380-0x103bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x103c0-0x103ff */
+  /* 0x10a00-0x10bff */
+  0x6e, 0xf0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x87, /* 0x10a00-0x10a3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10a40-0x10a7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10a80-0x10abf */
+  0x00, 0x00, 0x00, 0x00, 0x60, 0x00, 0x00, 0x00, /* 0x10ac0-0x10aff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b00-0x10b3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b40-0x10b7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10b80-0x10bbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10bc0-0x10bff */
+  /* 0x10c00-0x10dff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10c00-0x10c3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10c40-0x10c7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10c80-0x10cbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10cc0-0x10cff */
+  0x00, 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00, 0x00, /* 0x10d00-0x10d3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10d40-0x10d7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10d80-0x10dbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10dc0-0x10dff */
+  /* 0x10e00-0x10fff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10e00-0x10e3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10e40-0x10e7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x00, 0x00, /* 0x10e80-0x10ebf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xe0, /* 0x10ec0-0x10eff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10f00-0x10f3f */
+  0xc0, 0xff, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10f40-0x10f7f */
+  0x3c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10f80-0x10fbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x10fc0-0x10fff */
+  /* 0x11000-0x111ff */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, /* 0x11000-0x1103f */
+  0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x19, 0x80, /* 0x11040-0x1107f */
+  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x78, 0x26, /* 0x11080-0x110bf */
+  0x04, 0x20, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x110c0-0x110ff */
+  0x07, 0x00, 0x00, 0x00, 0x80, 0xef, 0x1f, 0x00, /* 0x11100-0x1113f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x08, 0x00, /* 0x11140-0x1117f */
+  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x7f, /* 0x11180-0x111bf */
+  0x00, 0x9e, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x111c0-0x111ff */
+  /* 0x11200-0x113ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xd3, 0x40, /* 0x11200-0x1123f */
+  0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11240-0x1127f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11280-0x112bf */
+  0x00, 0x00, 0x00, 0x80, 0xf8, 0x07, 0x00, 0x00, /* 0x112c0-0x112ff */
+  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, /* 0x11300-0x1133f */
+  0x01, 0x00, 0x00, 0x00, 0xc0, 0x1f, 0x1f, 0x00, /* 0x11340-0x1137f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11380-0x113bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x113c0-0x113ff */
+  /* 0x11400-0x115ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, /* 0x11400-0x1143f */
+  0x5c, 0x00, 0x00, 0x40, 0x00, 0x00, 0x00, 0x00, /* 0x11440-0x1147f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x85, /* 0x11480-0x114bf */
+  0x0d, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x114c0-0x114ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11500-0x1153f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11540-0x1157f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x3c, 0xb0, /* 0x11580-0x115bf */
+  0x01, 0x00, 0x00, 0x30, 0x00, 0x00, 0x00, 0x00, /* 0x115c0-0x115ff */
+  /* 0x11600-0x117ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xf8, 0xa7, /* 0x11600-0x1163f */
+  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11640-0x1167f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x28, 0xbf, 0x00, /* 0x11680-0x116bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x116c0-0x116ff */
+  0x00, 0x00, 0x00, 0xe0, 0xbc, 0x0f, 0x00, 0x00, /* 0x11700-0x1173f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11740-0x1177f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11780-0x117bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x117c0-0x117ff */
+  /* 0x11800-0x119ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0xff, 0x06, /* 0x11800-0x1183f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11840-0x1187f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11880-0x118bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x118c0-0x118ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x58, /* 0x11900-0x1193f */
+  0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11940-0x1197f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11980-0x119bf */
+  0x00, 0x00, 0xf0, 0x0c, 0x01, 0x00, 0x00, 0x00, /* 0x119c0-0x119ff */
+  /* 0x11a00-0x11bff */
+  0x7e, 0x06, 0x00, 0x00, 0x00, 0x00, 0xf8, 0x79, /* 0x11a00-0x11a3f */
+  0x80, 0x00, 0x7e, 0x0e, 0x00, 0x00, 0x00, 0x00, /* 0x11a40-0x11a7f */
+  0x00, 0xfc, 0x7f, 0x03, 0x00, 0x00, 0x00, 0x00, /* 0x11a80-0x11abf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11ac0-0x11aff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11b00-0x11b3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11b40-0x11b7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11b80-0x11bbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11bc0-0x11bff */
+  /* 0x11c00-0x11dff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7f, 0x3f, /* 0x11c00-0x11c3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11c40-0x11c7f */
+  0x00, 0x00, 0xfc, 0xff, 0xff, 0xfc, 0x6d, 0x00, /* 0x11c80-0x11cbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11cc0-0x11cff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7e, 0xb4, /* 0x11d00-0x11d3f */
+  0xbf, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11d40-0x11d7f */
+  0x00, 0x00, 0xa3, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11d80-0x11dbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11dc0-0x11dff */
+  /* 0x11e00-0x11fff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11e00-0x11e3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11e40-0x11e7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11e80-0x11ebf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x18, 0x00, /* 0x11ec0-0x11eff */
+  0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0xc0, 0x07, /* 0x11f00-0x11f3f */
+  0x05, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11f40-0x11f7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11f80-0x11fbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x11fc0-0x11fff */
+  /* 0x13400-0x135ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, /* 0x13400-0x1343f */
+  0x81, 0xff, 0x3f, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13440-0x1347f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13480-0x134bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x134c0-0x134ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13500-0x1353f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13540-0x1357f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x13580-0x135bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x135c0-0x135ff */
+  /* 0x16a00-0x16bff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a00-0x16a3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a40-0x16a7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16a80-0x16abf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x1f, 0x00, /* 0x16ac0-0x16aff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7f, 0x00, /* 0x16b00-0x16b3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16b40-0x16b7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16b80-0x16bbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16bc0-0x16bff */
+  /* 0x16e00-0x16fff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e00-0x16e3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e40-0x16e7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16e80-0x16ebf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16ec0-0x16eff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f00-0x16f3f */
+  0x00, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f40-0x16f7f */
+  0x00, 0x80, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x16f80-0x16fbf */
+  0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00, /* 0x16fc0-0x16fff */
+  /* 0x1bc00-0x1bdff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bc00-0x1bc3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bc40-0x1bc7f */
+  0x00, 0x00, 0x00, 0x60, 0x0f, 0x00, 0x00, 0x00, /* 0x1bc80-0x1bcbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bcc0-0x1bcff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd00-0x1bd3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd40-0x1bd7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bd80-0x1bdbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1bdc0-0x1bdff */
+  /* 0x1ce00-0x1cfff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1ce00-0x1ce3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1ce40-0x1ce7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1ce80-0x1cebf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1cec0-0x1ceff */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0x3f, 0xff, 0xff, /* 0x1cf00-0x1cf3f */
+  0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1cf40-0x1cf7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1cf80-0x1cfbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1cfc0-0x1cfff */
+  /* 0x1d000-0x1d1ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d000-0x1d03f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d040-0x1d07f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d080-0x1d0bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d0c0-0x1d0ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d100-0x1d13f */
+  0x00, 0x00, 0x00, 0x00, 0x80, 0x03, 0xf8, 0xff, /* 0x1d140-0x1d17f */
+  0xe7, 0x0f, 0x00, 0x00, 0x00, 0x3c, 0x00, 0x00, /* 0x1d180-0x1d1bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d1c0-0x1d1ff */
+  /* 0x1d200-0x1d3ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d200-0x1d23f */
+  0x1c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d240-0x1d27f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d280-0x1d2bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d2c0-0x1d2ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d300-0x1d33f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d340-0x1d37f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d380-0x1d3bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1d3c0-0x1d3ff */
+  /* 0x1da00-0x1dbff */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x7f, 0xf8, /* 0x1da00-0x1da3f */
+  0xff, 0xff, 0xff, 0xff, 0xff, 0x1f, 0x20, 0x00, /* 0x1da40-0x1da7f */
+  0x10, 0x00, 0x00, 0xf8, 0xfe, 0xff, 0x00, 0x00, /* 0x1da80-0x1dabf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1dac0-0x1daff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db00-0x1db3f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db40-0x1db7f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1db80-0x1dbbf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1dbc0-0x1dbff */
+  /* 0x1e000-0x1e1ff */
+  0x7f, 0xff, 0xff, 0xf9, 0xdb, 0x07, 0x00, 0x00, /* 0x1e000-0x1e03f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e040-0x1e07f */
+  0x00, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e080-0x1e0bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e0c0-0x1e0ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x7f, 0x00, /* 0x1e100-0x1e13f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e140-0x1e17f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e180-0x1e1bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e1c0-0x1e1ff */
+  /* 0x1e200-0x1e3ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e200-0x1e23f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e240-0x1e27f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00, 0x00, /* 0x1e280-0x1e2bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00, /* 0x1e2c0-0x1e2ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e300-0x1e33f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e340-0x1e37f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e380-0x1e3bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e3c0-0x1e3ff */
+  /* 0x1e400-0x1e5ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e400-0x1e43f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e440-0x1e47f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e480-0x1e4bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0xf0, 0x00, 0x00, /* 0x1e4c0-0x1e4ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e500-0x1e53f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e540-0x1e57f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e580-0x1e5bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e5c0-0x1e5ff */
+  /* 0x1e800-0x1e9ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e800-0x1e83f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e840-0x1e87f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e880-0x1e8bf */
+  0x00, 0x00, 0x7f, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e8c0-0x1e8ff */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e900-0x1e93f */
+  0xf0, 0x07, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e940-0x1e97f */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, /* 0x1e980-0x1e9bf */
+  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00  /* 0x1e9c0-0x1e9ff */
+};
+static const signed char nonspacing_table_ind248 = {
+   0,  1,  2,  3,  4,  5,  6,  7, /* 0x0000-0x0fff */
+   8,  9, -1, 10, 11, 12, 13, -1, /* 0x1000-0x1fff */
+  14, -1, -1, -1, -1, -1, 15, -1, /* 0x2000-0x2fff */
+  16, -1, -1, -1, -1, -1, -1, -1, /* 0x3000-0x3fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x4000-0x4fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x5000-0x5fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x6000-0x6fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x7000-0x7fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x8000-0x8fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x9000-0x9fff */
+  -1, -1, -1, 17, 18, 19, -1, -1, /* 0xa000-0xafff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xb000-0xbfff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xc000-0xcfff */
+  -1, -1, -1, 20, -1, -1, -1, -1, /* 0xd000-0xdfff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0xe000-0xefff */
+  -1, -1, -1, -1, -1, 21, -1, 22, /* 0xf000-0xffff */
+  23, 24, -1, -1, -1, 25, 26, 27, /* 0x10000-0x10fff */
+  28, 29, 30, 31, 32, 33, 34, 35, /* 0x11000-0x11fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x12000-0x12fff */
+  -1, -1, 36, -1, -1, -1, -1, -1, /* 0x13000-0x13fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x14000-0x14fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x15000-0x15fff */
+  -1, -1, -1, -1, -1, 37, -1, 38, /* 0x16000-0x16fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x17000-0x17fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x18000-0x18fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x19000-0x19fff */
+  -1, -1, -1, -1, -1, -1, -1, -1, /* 0x1a000-0x1afff */
+  -1, -1, -1, -1, -1, -1, 39, -1, /* 0x1b000-0x1bfff */
+  -1, -1, -1, -1, -1, -1, -1, 40, /* 0x1c000-0x1cfff */
+  41, 42, -1, -1, -1, 43, -1, -1, /* 0x1d000-0x1dfff */
+  44, 45, 46, -1, 47, -1, -1, -1  /* 0x1e000-0x1efff */
+};

_service:tar_scm:groff-1.23.0.tar.gz/lib/uniwidth/width2.h Added

@@ -0,0 +1,549 @@
+/* DO NOT EDIT! GENERATED AUTOMATICALLY! */
+/* Width 2 property of Unicode characters.  */
+/* Generated automatically by gen-uni-tables.c for Unicode 15.0.0.  */
+
+/* Copyright (C) 2000-2022 Free Software Foundation, Inc.
+
+   This file is free software.
+   It is dual-licensed under "the GNU LGPLv3+ or the GNU GPLv2+".
+   You can redistribute it and/or modify it under either
+     - the terms of the GNU Lesser General Public License as published
+       by the Free Software Foundation, either version 3, or (at your
+       option) any later version, or
+     - the terms of the GNU General Public License as published by the
+       Free Software Foundation; either version 2, or (at your option)
+       any later version, or
+     - the same dual license "the GNU LGPLv3+ or the GNU GPLv2+".
+
+   This file 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
+   Lesser General Public License and the GNU General Public License
+   for more details.
+
+   You should have received a copy of the GNU Lesser General Public
+   License and of the GNU General Public License along with this
+   program.  If not, see <https://www.gnu.org/licenses/>.  */
+
+#define header_0 16
+#define header_2 9
+#define header_3 127
+#define header_4 15
+static const
+struct
+  {
+    int header1;
+    int level14;
+    short level23 << 7;
+    unsigned int level328 << 4;
+  }
+u_width2 =
+{
+  { 4 },
+  {
+        5 * sizeof (int) / sizeof (short) +     0,
+        5 * sizeof (int) / sizeof (short) +   128,
+        5 * sizeof (int) / sizeof (short) +   256,
+        5 * sizeof (int) / sizeof (short) +   256
+  },
+  {
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +     0,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +    16,
+        5 +   384 * sizeof (short) / sizeof (int) +    32,
+        5 +   384 * sizeof (short) / sizeof (int) +    48,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +    64,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +    80,
+        5 +   384 * sizeof (short) / sizeof (int) +    96,
+        5 +   384 * sizeof (short) / sizeof (int) +   112,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   144,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   160,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   176,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   192,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   208,
+        5 +   384 * sizeof (short) / sizeof (int) +   224,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   240,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   256,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   272,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   288,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   304,
+        5 +   384 * sizeof (short) / sizeof (int) +   320,
+        5 +   384 * sizeof (short) / sizeof (int) +   336,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   352,
+        5 +   384 * sizeof (short) / sizeof (int) +   368,
+        5 +   384 * sizeof (short) / sizeof (int) +   384,
+        5 +   384 * sizeof (short) / sizeof (int) +   400,
+        5 +   384 * sizeof (short) / sizeof (int) +   416,
+        5 +   384 * sizeof (short) / sizeof (int) +   432,
+       -1,
+       -1,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128,
+        5 +   384 * sizeof (short) / sizeof (int) +   128
+  },
+  {
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x0C000000U, 0x00000600U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00091E00U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x60000000U,
+    0x00300000U, 0x00000000U, 0x000FFF00U, 0x80000000U,
+    0x00080000U, 0x60000C02U, 0x00104030U, 0x242C0400U,
+    0x00000C20U, 0x00000100U, 0x00B85000U, 0x00000000U,
+    0x00E00000U, 0x80010000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x18000000U, 0x00000000U, 0x00210000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0x7FFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFF00FFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0x0000FFFFU, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x1FFFFFFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0x0000000FU, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFF0000U, 0xFFFF0000U, 0xFFFFFFFFU, 0x0000FFFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0x00000001U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x0000007FU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x0003000FU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0x00FFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0x003FFFFFU, 0x00000000U,
+    0x000001FFU, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x6FEF0000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0x00000007U, 0x00070000U, 0xFFFF00F0U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0x0FFFFFFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000010U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00008000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x07FE4000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFBFE001U, 0xFFFFFFFFU, 0xDFFFFFFFU,
+    0x000FFFFFU, 0xFFFFFFFFU, 0x000F87FFU, 0xFF11FFFFU,
+    0xFFFFFFFFU, 0x7FFFFFFFU, 0xFFFFFFFDU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0x9FFFFFFFU,
+    0xFFFFFFFFU, 0x3FFFFFFFU, 0xFFFF7800U, 0x040000FFU,
+    0x00600000U, 0x00000010U, 0x00000000U, 0xF8000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0x0000FFFFU, 0x00000000U,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xE0E7103FU, 0x1FF01800U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00010FFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0xFFFFF000U, 0xF7FFFFFFU, 0xFFFFFFBFU, 0xFFFFFFFFU,
+    0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU, 0xFFFFFFFFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x1F1F0000U,
+    0xFFFF007FU, 0x07FF1FFFU, 0x03FF003FU, 0x007F00FFU,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U,
+    0x00000000U, 0x00000000U, 0x00000000U, 0x00000000U
+  }
+};

_service:tar_scm:groff-1.22.4.tar.gz/lib/vasnprintf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/vasnprintf.c Changed

@@ -1,18 +1,18 @@
 /* vsprintf with automatic memory allocation.
-   Copyright (C) 1999, 2002-2018 Free Software Foundation, Inc.
+   Copyright (C) 1999, 2002-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* This file can be parametrized with the following macros:
      VASNPRINTF         The name of the function being defined.
@@ -41,7 +41,14 @@
      DCHAR_CONV_FROM_ENCODING A function to convert from char to DCHAR.
      DCHAR_IS_UINT8_T   Set to 1 if DCHAR_T is uint8_t.
      DCHAR_IS_UINT16_T  Set to 1 if DCHAR_T is uint16_t.
-     DCHAR_IS_UINT32_T  Set to 1 if DCHAR_T is uint32_t.  */
+     DCHAR_IS_UINT32_T  Set to 1 if DCHAR_T is uint32_t.
+     ENABLE_UNISTDIO    Set to 1 to enable the unistdio extensions.
+     ENABLE_WCHAR_FALLBACK  Set to 1 to avoid EILSEQ during conversion of wide
+                        characters (wchar_t) and wide character strings
+                        (wchar_t) to multibyte sequences.  The fallback is the
+                        hexadecimal escape syntax (\unnnn or \Unnnnnnnn) or,
+                        if wchar_t is not Unicode encoded, \wnnnn or \Wnnnnnnnn.
+ */
 
 /* Tell glibc's <stdio.h> to provide a prototype for snprintf().
    This must come before <config.h> because <config.h> may include
@@ -53,10 +60,16 @@
 #ifndef VASNPRINTF
 # include <config.h>
 #endif
-#ifndef IN_LIBINTL
-# include <alloca.h>
+
+/* As of GCC 11.2.1, gcc -Wanalyzer-too-complex reports that main's
+   use of CHECK macros expands to code that is too complicated for gcc
+   -fanalyzer.  Suppress the resulting bogus warnings.  */
+#if 10 <= __GNUC__
+# pragma GCC diagnostic ignored "-Wanalyzer-null-argument"
 #endif
 
+#include <alloca.h>
+
 /* Specification.  */
 #ifndef VASNPRINTF
 # if WIDE_CHAR_VERSION
@@ -70,6 +83,7 @@
 #include <stdio.h>      /* snprintf(), sprintf() */
 #include <stdlib.h>     /* abort(), malloc(), realloc(), free() */
 #include <string.h>     /* memcpy(), strlen() */
+#include <wchar.h>      /* mbstate_t, mbrtowc(), mbrlen(), wcrtomb() */
 #include <errno.h>      /* errno */
 #include <limits.h>     /* CHAR_BIT */
 #include <float.h>      /* DBL_MAX_EXP, LDBL_MAX_EXP */
@@ -87,7 +101,7 @@
 /* Checked size_t computations.  */
 #include "xsize.h"
 
-#include "verify.h"
+#include "attribute.h"
 
 #if (NEED_PRINTF_DOUBLE || NEED_PRINTF_LONG_DOUBLE) && !defined IN_LIBINTL
 # include <math.h>
@@ -118,14 +132,6 @@
 # include "fpucw.h"
 #endif
 
-#ifndef FALLTHROUGH
-# if __GNUC__ < 7
-#  define FALLTHROUGH ((void) 0)
-# else
-#  define FALLTHROUGH __attribute__ ((__fallthrough__))
-# endif
-#endif
-
 /* Default parameters.  */
 #ifndef VASNPRINTF
 # if WIDE_CHAR_VERSION
@@ -277,6 +283,74 @@
 # endif
 #endif
 
+#if (((!USE_SNPRINTF || !HAVE_SNPRINTF_RETVAL_C99 || USE_MSVC__SNPRINTF || (NEED_PRINTF_DIRECTIVE_LS && !defined IN_LIBINTL) || ENABLE_WCHAR_FALLBACK) && HAVE_WCHAR_T) || (ENABLE_WCHAR_FALLBACK && HAVE_WINT_T)) && !WIDE_CHAR_VERSION
+# if ENABLE_WCHAR_FALLBACK
+static size_t
+wctomb_fallback (char *s, wchar_t wc)
+{
+  static char hex16 = "0123456789ABCDEF";
+
+  s0 = '\\';
+  if (sizeof (wchar_t) > 2 && wc > 0xffff)
+    {
+#  if __STDC_ISO_10646__ || (__GLIBC__ >= 2) || (defined _WIN32 || defined __CYGWIN__)
+      s1 = 'U';
+#  else
+      s1 = 'W';
+#  endif
+      s2 = hex(wc & 0xf0000000U) >> 28;
+      s3 = hex(wc & 0xf000000U) >> 24;
+      s4 = hex(wc & 0xf00000U) >> 20;
+      s5 = hex(wc & 0xf0000U) >> 16;
+      s6 = hex(wc & 0xf000U) >> 12;
+      s7 = hex(wc & 0xf00U) >> 8;
+      s8 = hex(wc & 0xf0U) >> 4;
+      s9 = hexwc & 0xfU;
+      return 10;
+    }
+  else
+    {
+#  if __STDC_ISO_10646__ || (__GLIBC__ >= 2) || (defined _WIN32 || defined __CYGWIN__)
+      s1 = 'u';
+#  else
+      s1 = 'w';
+#  endif
+      s2 = hex(wc & 0xf000U) >> 12;
+      s3 = hex(wc & 0xf00U) >> 8;
+      s4 = hex(wc & 0xf0U) >> 4;
+      s5 = hexwc & 0xfU;
+      return 6;
+    }
+}
+#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+static size_t
+local_wcrtomb (char *s, wchar_t wc, mbstate_t *ps)
+{
+  size_t count = wcrtomb (s, wc, ps);
+  if (count == (size_t)(-1))
+    count = wctomb_fallback (s, wc);
+  return count;
+}
+#  else
+static int
+local_wctomb (char *s, wchar_t wc)
+{
+  int count = wctomb (s, wc);
+  if (count < 0)
+    count = wctomb_fallback (s, wc);
+  return count;
+}
+#   define local_wcrtomb(S, WC, PS)  local_wctomb ((S), (WC))
+#  endif
+# else
+#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+#   define local_wcrtomb(S, WC, PS)  wcrtomb ((S), (WC), (PS))
+#  else
+#   define local_wcrtomb(S, WC, PS)  wctomb ((S), (WC))
+#  endif
+# endif
+#endif
+
 #if (NEED_PRINTF_DIRECTIVE_A || NEED_PRINTF_LONG_DOUBLE || NEED_PRINTF_INFINITE_LONG_DOUBLE || NEED_PRINTF_DOUBLE || NEED_PRINTF_INFINITE_DOUBLE) && !defined IN_LIBINTL
 /* Determine the decimal-point character according to the current locale.  */
 # ifndef decimal_point_char_defined
@@ -334,11 +408,11 @@
 
 typedef unsigned int mp_limb_t;
 # define GMP_LIMB_BITS 32
-verify (sizeof (mp_limb_t) * CHAR_BIT == GMP_LIMB_BITS);
+static_assert (sizeof (mp_limb_t) * CHAR_BIT == GMP_LIMB_BITS);
 
 typedef unsigned long long mp_twolimb_t;
 # define GMP_TWOLIMB_BITS 64
-verify (sizeof (mp_twolimb_t) * CHAR_BIT == GMP_TWOLIMB_BITS);
+static_assert (sizeof (mp_twolimb_t) * CHAR_BIT == GMP_TWOLIMB_BITS);
 
 /* Representation of a bignum >= 0.  */
 typedef struct
@@ -565,7 +639,8 @@
         mp_limb_t msd = b_ptrb_len - 1; /* = bn-1, > 0 */
         /* Determine s = GMP_LIMB_BITS - integer_length (msd).
            Code copied from gnulib's integer_length.c.  */
-# if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4)
+# if __GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 4) \
+     || (__clang_major__ >= 4)
         s = __builtin_clz (msd);
 # else
 #  if defined DBL_EXPBIT0_WORD && defined DBL_EXPBIT0_BIT
@@ -840,8 +915,7 @@
       q_ptrq_len++ = 1;
     }
   keep_q:
-  if (tmp_roomptr != NULL)
-    free (tmp_roomptr);
+  free (tmp_roomptr);
   q->limbs = q_ptr;
   q->nlimbs = q_len;
   return roomptr;
@@ -1553,16 +1627,13 @@
   switch (conversion)
     {
     case 'd': case 'i': case 'u':
-# if HAVE_LONG_LONG_INT
       if (type == TYPE_LONGLONGINT || type == TYPE_ULONGLONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long long) * CHAR_BIT
                           * 0.30103 /* binary -> decimal */
                          )
           + 1; /* turn floor into ceil */
-      else
-# endif
-      if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
+      else if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long) * CHAR_BIT
                           * 0.30103 /* binary -> decimal */
@@ -1583,16 +1654,13 @@
       break;
 
     case 'o':
-# if HAVE_LONG_LONG_INT
       if (type == TYPE_LONGLONGINT || type == TYPE_ULONGLONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long long) * CHAR_BIT
                           * 0.333334 /* binary -> octal */
                          )
           + 1; /* turn floor into ceil */
-      else
-# endif
-      if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
+      else if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long) * CHAR_BIT
                           * 0.333334 /* binary -> octal */
@@ -1611,16 +1679,13 @@
       break;
 
     case 'x': case 'X':
-# if HAVE_LONG_LONG_INT
       if (type == TYPE_LONGLONGINT || type == TYPE_ULONGLONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long long) * CHAR_BIT
                           * 0.25 /* binary -> hexadecimal */
                          )
           + 1; /* turn floor into ceil */
-      else
-# endif
-      if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
+      else if (type == TYPE_LONGINT || type == TYPE_ULONGINT)
         tmp_length =
           (unsigned int) (sizeof (unsigned long) * CHAR_BIT
                           * 0.25 /* binary -> hexadecimal */
@@ -1686,7 +1751,13 @@
     case 'c':
 # if HAVE_WINT_T && !WIDE_CHAR_VERSION
       if (type == TYPE_WIDE_CHAR)
-        tmp_length = MB_CUR_MAX;
+        {
+          tmp_length = MB_CUR_MAX;
+#  if ENABLE_WCHAR_FALLBACK
+          if (tmp_length < (sizeof (wchar_t) > 2 ? 10 : 6))
+            tmp_length = (sizeof (wchar_t) > 2 ? 10 : 6);
+#  endif
+        }
       else
 # endif
         tmp_length = 1;
@@ -1793,6 +1864,7 @@
     /* errno is already set.  */
     return NULL;
 
+  /* Frees the memory allocated by this function.  Preserves errno.  */
 #define CLEANUP() \
   if (d.dir != d.direct_alloc_dir)                                      \
     free (d.dir);                                                       \
@@ -1800,11 +1872,7 @@
     free (a.arg);
 
   if (PRINTF_FETCHARGS (args, &a) < 0)
-    {
-      CLEANUP ();
-      errno = EINVAL;
-      return NULL;
-    }
+    goto fail_1_with_EINVAL;
 
   {
     size_t buf_neededlength;
@@ -1840,24 +1908,17 @@
         buf_malloced = buf;
       }
 
-    if (resultbuf != NULL)
-      {
-        result = resultbuf;
-        allocated = *lengthp;
-      }
-    else
-      {
-        result = NULL;
-        allocated = 0;
-      }
+    result = resultbuf;
+    allocated = (resultbuf != NULL ? *lengthp : 0);
     length = 0;
     /* Invariants:
-       result is either == resultbuf or == NULL or malloc-allocated.
+       result is either == resultbuf or malloc-allocated.
+       If result == NULL, resultbuf is == NULL as well.
        If length > 0, then result != NULL.  */
 
     /* Ensures that allocated >= needed.  Aborts through a jump to
        out_of_memory if needed is SIZE_MAX or otherwise too big.  */
-#define ENSURE_ALLOCATION(needed) \
+#define ENSURE_ALLOCATION_ELSE(needed, oom_statement) \
     if ((needed) > allocated)                                                \
       {                                                                      \
         size_t memory_size;                                                  \
@@ -1868,17 +1929,19 @@
           allocated = (needed);                                              \
         memory_size = xtimes (allocated, sizeof (DCHAR_T));                  \
         if (size_overflow_p (memory_size))                                   \
-          goto out_of_memory;                                                \
-        if (result == resultbuf || result == NULL)                           \
+          oom_statement                                                      \
+        if (result == resultbuf)                                             \
           memory = (DCHAR_T *) malloc (memory_size);                         \
         else                                                                 \
           memory = (DCHAR_T *) realloc (result, memory_size);                \
         if (memory == NULL)                                                  \
-          goto out_of_memory;                                                \
+          oom_statement                                                      \
         if (result == resultbuf && length > 0)                               \
           DCHAR_CPY (memory, result, length);                                \
         result = memory;                                                     \
       }
+#define ENSURE_ALLOCATION(needed) \
+  ENSURE_ALLOCATION_ELSE((needed), goto out_of_memory; )
 
     for (cp = format, i = 0, dp = &d.dir0; ; cp = dp->dir_end, i++, dp++)
       {
@@ -1939,11 +2002,9 @@
                   case TYPE_COUNT_LONGINT_POINTER:
                     *a.argdp->arg_index.a.a_count_longint_pointer = length;
                     break;
-#if HAVE_LONG_LONG_INT
                   case TYPE_COUNT_LONGLONGINT_POINTER:
                     *a.argdp->arg_index.a.a_count_longlongint_pointer = length;
                     break;
-#endif
                   default:
                     abort ();
                   }
@@ -2039,15 +2100,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2064,15 +2117,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2085,7 +2130,7 @@
                           characters = 0;
                         }
 
-                      if (characters < width && !(dp->flags & FLAG_LEFT))
+                      if (characters < width && !(flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2118,19 +2163,11 @@
                                        converted, &converted_len);
 #  endif
                         if (converted == NULL)
-                          {
-                            int saved_errno = errno;
-                            if (!(result == resultbuf || result == NULL))
-                              free (result);
-                            if (buf_malloced != NULL)
-                              free (buf_malloced);
-                            CLEANUP ();
-                            errno = saved_errno;
-                            return NULL;
-                          }
+                          goto fail_with_errno;
                         if (converted != result + length)
                           {
-                            ENSURE_ALLOCATION (xsum (length, converted_len));
+                            ENSURE_ALLOCATION_ELSE (xsum (length, converted_len),
+                                                    { free (converted); goto out_of_memory; });
                             DCHAR_CPY (result + length, converted, converted_len);
                             free (converted);
                           }
@@ -2138,7 +2175,7 @@
                       }
 # endif
 
-                      if (characters < width && (dp->flags & FLAG_LEFT))
+                      if (characters < width && (flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2165,15 +2202,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2190,15 +2219,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2211,7 +2232,7 @@
                           characters = 0;
                         }
 
-                      if (characters < width && !(dp->flags & FLAG_LEFT))
+                      if (characters < width && !(flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2244,19 +2265,11 @@
                                         converted, &converted_len);
 #  endif
                         if (converted == NULL)
-                          {
-                            int saved_errno = errno;
-                            if (!(result == resultbuf || result == NULL))
-                              free (result);
-                            if (buf_malloced != NULL)
-                              free (buf_malloced);
-                            CLEANUP ();
-                            errno = saved_errno;
-                            return NULL;
-                          }
+                          goto fail_with_errno;
                         if (converted != result + length)
                           {
-                            ENSURE_ALLOCATION (xsum (length, converted_len));
+                            ENSURE_ALLOCATION_ELSE (xsum (length, converted_len),
+                                                    { free (converted); goto out_of_memory; });
                             DCHAR_CPY (result + length, converted, converted_len);
                             free (converted);
                           }
@@ -2264,7 +2277,7 @@
                       }
 # endif
 
-                      if (characters < width && (dp->flags & FLAG_LEFT))
+                      if (characters < width && (flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2291,15 +2304,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2316,15 +2321,7 @@
                               if (count == 0)
                                 break;
                               if (count < 0)
-                                {
-                                  if (!(result == resultbuf || result == NULL))
-                                    free (result);
-                                  if (buf_malloced != NULL)
-                                    free (buf_malloced);
-                                  CLEANUP ();
-                                  errno = EILSEQ;
-                                  return NULL;
-                                }
+                                goto fail_with_EILSEQ;
                               arg_end += count;
                               characters++;
                             }
@@ -2337,7 +2334,7 @@
                           characters = 0;
                         }
 
-                      if (characters < width && !(dp->flags & FLAG_LEFT))
+                      if (characters < width && !(flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2370,19 +2367,11 @@
                                         converted, &converted_len);
 #  endif
                         if (converted == NULL)
-                          {
-                            int saved_errno = errno;
-                            if (!(result == resultbuf || result == NULL))
-                              free (result);
-                            if (buf_malloced != NULL)
-                              free (buf_malloced);
-                            CLEANUP ();
-                            errno = saved_errno;
-                            return NULL;
-                          }
+                          goto fail_with_errno;
                         if (converted != result + length)
                           {
-                            ENSURE_ALLOCATION (xsum (length, converted_len));
+                            ENSURE_ALLOCATION_ELSE (xsum (length, converted_len),
+                                                    { free (converted); goto out_of_memory; });
                             DCHAR_CPY (result + length, converted, converted_len);
                             free (converted);
                           }
@@ -2390,7 +2379,7 @@
                       }
 # endif
 
-                      if (characters < width && (dp->flags & FLAG_LEFT))
+                      if (characters < width && (flags & FLAG_LEFT))
                         {
                           size_t n = width - characters;
                           ENSURE_ALLOCATION (xsum (length, n));
@@ -2405,7 +2394,7 @@
                   }
               }
 #endif
-#if (!USE_SNPRINTF || !HAVE_SNPRINTF_RETVAL_C99 || USE_MSVC__SNPRINTF || (NEED_PRINTF_DIRECTIVE_LS && !defined IN_LIBINTL)) && HAVE_WCHAR_T
+#if (!USE_SNPRINTF || !HAVE_SNPRINTF_RETVAL_C99 || USE_MSVC__SNPRINTF || (NEED_PRINTF_DIRECTIVE_LS && !defined IN_LIBINTL) || ENABLE_WCHAR_FALLBACK) && HAVE_WCHAR_T
             else if (dp->conversion == 's'
 # if WIDE_CHAR_VERSION
                      && a.argdp->arg_index.type != TYPE_WIDE_STRING
@@ -2520,16 +2509,8 @@
                             /* Found the terminating NUL.  */
                             break;
                           if (count < 0)
-                            {
-                              /* Invalid or incomplete multibyte character.  */
-                              if (!(result == resultbuf || result == NULL))
-                                free (result);
-                              if (buf_malloced != NULL)
-                                free (buf_malloced);
-                              CLEANUP ();
-                              errno = EILSEQ;
-                              return NULL;
-                            }
+                            /* Invalid or incomplete multibyte character.  */
+                            goto fail_with_EILSEQ;
                           arg_end += count;
                           characters++;
                         }
@@ -2556,16 +2537,8 @@
                             /* Found the terminating NUL.  */
                             break;
                           if (count < 0)
-                            {
-                              /* Invalid or incomplete multibyte character.  */
-                              if (!(result == resultbuf || result == NULL))
-                                free (result);
-                              if (buf_malloced != NULL)
-                                free (buf_malloced);
-                              CLEANUP ();
-                              errno = EILSEQ;
-                              return NULL;
-                            }
+                            /* Invalid or incomplete multibyte character.  */
+                            goto fail_with_EILSEQ;
                           arg_end += count;
                           characters++;
                         }
@@ -2578,7 +2551,7 @@
                       characters = 0;
                     }
 
-                  if (characters < width && !(dp->flags & FLAG_LEFT))
+                  if (characters < width && !(flags & FLAG_LEFT))
                     {
                       size_t n = width - characters;
                       ENSURE_ALLOCATION (xsum (length, n));
@@ -2639,7 +2612,7 @@
                         }
                     }
 
-                  if (characters < width && (dp->flags & FLAG_LEFT))
+                  if (characters < width && (flags & FLAG_LEFT))
                     {
                       size_t n = width - characters;
                       ENSURE_ALLOCATION (xsum (length, n));
@@ -2655,7 +2628,7 @@
                   size_t characters;
 #  if !DCHAR_IS_TCHAR
                   /* This code assumes that TCHAR_T is 'char'.  */
-                  verify (sizeof (TCHAR_T) == 1);
+                  static_assert (sizeof (TCHAR_T) == 1);
                   TCHAR_T *tmpsrc;
                   DCHAR_T *tmpdst;
                   size_t tmpdst_len;
@@ -2680,22 +2653,10 @@
                           if (*arg_end == 0)
                             /* Found the terminating null wide character.  */
                             break;
-#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
-                          count = wcrtomb (cbuf, *arg_end, &state);
-#  else
-                          count = wctomb (cbuf, *arg_end);
-#  endif
+                          count = local_wcrtomb (cbuf, *arg_end, &state);
                           if (count < 0)
-                            {
-                              /* Cannot convert.  */
-                              if (!(result == resultbuf || result == NULL))
-                                free (result);
-                              if (buf_malloced != NULL)
-                                free (buf_malloced);
-                              CLEANUP ();
-                              errno = EILSEQ;
-                              return NULL;
-                            }
+                            /* Cannot convert.  */
+                            goto fail_with_EILSEQ;
                           if (precision < (unsigned int) count)
                             break;
                           arg_end++;
@@ -2725,22 +2686,10 @@
                           if (*arg_end == 0)
                             /* Found the terminating null wide character.  */
                             break;
-#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
-                          count = wcrtomb (cbuf, *arg_end, &state);
-#  else
-                          count = wctomb (cbuf, *arg_end);
-#  endif
+                          count = local_wcrtomb (cbuf, *arg_end, &state);
                           if (count < 0)
-                            {
-                              /* Cannot convert.  */
-                              if (!(result == resultbuf || result == NULL))
-                                free (result);
-                              if (buf_malloced != NULL)
-                                free (buf_malloced);
-                              CLEANUP ();
-                              errno = EILSEQ;
-                              return NULL;
-                            }
+                            /* Cannot convert.  */
+                            goto fail_with_EILSEQ;
                           arg_end++;
                           characters += count;
                         }
@@ -2774,11 +2723,7 @@
 
                         if (*arg == 0)
                           abort ();
-#   if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
-                        count = wcrtomb (cbuf, *arg, &state);
-#   else
-                        count = wctomb (cbuf, *arg);
-#   endif
+                        count = local_wcrtomb (cbuf, *arg, &state);
                         if (count <= 0)
                           /* Inconsistency.  */
                           abort ();
@@ -2800,15 +2745,8 @@
                                               NULL, &tmpdst_len);
                   if (tmpdst == NULL)
                     {
-                      int saved_errno = errno;
                       free (tmpsrc);
-                      if (!(result == resultbuf || result == NULL))
-                        free (result);
-                      if (buf_malloced != NULL)
-                        free (buf_malloced);
-                      CLEANUP ();
-                      errno = saved_errno;
-                      return NULL;
+                      goto fail_with_errno;
                     }
                   free (tmpsrc);
 #  endif
@@ -2830,7 +2768,7 @@
                     /* w doesn't matter.  */
                     w = 0;
 
-                  if (w < width && !(dp->flags & FLAG_LEFT))
+                  if (w < width && !(flags & FLAG_LEFT))
                     {
                       size_t n = width - w;
                       ENSURE_ALLOCATION (xsum (length, n));
@@ -2855,11 +2793,7 @@
 
                           if (*arg == 0)
                             abort ();
-#   if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
-                          count = wcrtomb (cbuf, *arg, &state);
-#   else
-                          count = wctomb (cbuf, *arg);
-#   endif
+                          count = local_wcrtomb (cbuf, *arg, &state);
                           if (count <= 0)
                             /* Inconsistency.  */
                             abort ();
@@ -2884,22 +2818,10 @@
 
                           if (*arg == 0)
                             abort ();
-#   if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
-                          count = wcrtomb (cbuf, *arg, &state);
-#   else
-                          count = wctomb (cbuf, *arg);
-#   endif
+                          count = local_wcrtomb (cbuf, *arg, &state);
                           if (count <= 0)
-                            {
-                              /* Cannot convert.  */
-                              if (!(result == resultbuf || result == NULL))
-                                free (result);
-                              if (buf_malloced != NULL)
-                                free (buf_malloced);
-                              CLEANUP ();
-                              errno = EILSEQ;
-                              return NULL;
-                            }
+                            /* Cannot convert.  */
+                            goto fail_with_EILSEQ;
                           ENSURE_ALLOCATION (xsum (length, count));
                           memcpy (result + length, cbuf, count);
                           length += count;
@@ -2907,13 +2829,14 @@
                         }
                     }
 #  else
-                  ENSURE_ALLOCATION (xsum (length, tmpdst_len));
+                  ENSURE_ALLOCATION_ELSE (xsum (length, tmpdst_len),
+                                          { free (tmpdst); goto out_of_memory; });
                   DCHAR_CPY (result + length, tmpdst, tmpdst_len);
                   free (tmpdst);
                   length += tmpdst_len;
 #  endif
 
-                  if (w < width && (dp->flags & FLAG_LEFT))
+                  if (w < width && (flags & FLAG_LEFT))
                     {
                       size_t n = width - w;
                       ENSURE_ALLOCATION (xsum (length, n));
@@ -2924,6 +2847,202 @@
 # endif
               }
 #endif
+#if ENABLE_WCHAR_FALLBACK && HAVE_WINT_T && !WIDE_CHAR_VERSION
+            else if (dp->conversion == 'c'
+                     && a.argdp->arg_index.type == TYPE_WIDE_CHAR)
+              {
+                /* Implement the 'lc' directive ourselves, in order to provide
+                   the fallback that avoids EILSEQ.  */
+                int flags = dp->flags;
+                int has_width;
+                size_t width;
+
+                has_width = 0;
+                width = 0;
+                if (dp->width_start != dp->width_end)
+                  {
+                    if (dp->width_arg_index != ARG_NONE)
+                      {
+                        int arg;
+
+                        if (!(a.argdp->width_arg_index.type == TYPE_INT))
+                          abort ();
+                        arg = a.argdp->width_arg_index.a.a_int;
+                        width = arg;
+                        if (arg < 0)
+                          {
+                            /* "A negative field width is taken as a '-' flag
+                                followed by a positive field width."  */
+                            flags |= FLAG_LEFT;
+                            width = -width;
+                          }
+                      }
+                    else
+                      {
+                        const FCHAR_T *digitp = dp->width_start;
+
+                        do
+                          width = xsum (xtimes (width, 10), *digitp++ - '0');
+                        while (digitp != dp->width_end);
+                      }
+                    has_width = 1;
+                  }
+
+                /* %lc in vasnprintf.  See the specification of fprintf.  */
+                {
+                  wchar_t arg = (wchar_t) a.argdp->arg_index.a.a_wide_char;
+                  size_t characters;
+# if !DCHAR_IS_TCHAR
+                  /* This code assumes that TCHAR_T is 'char'.  */
+                  static_assert (sizeof (TCHAR_T) == 1);
+                  TCHAR_T tmpsrc64; /* Assume MB_CUR_MAX <= 64.  */
+                  DCHAR_T *tmpdst;
+                  size_t tmpdst_len;
+# endif
+                  size_t w;
+
+# if DCHAR_IS_TCHAR
+                  if (has_width)
+# endif
+                    {
+                      /* Count the number of bytes.  */
+                      characters = 0;
+                      if (arg != 0)
+                        {
+                          char cbuf64; /* Assume MB_CUR_MAX <= 64.  */
+                          int count;
+# if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+                          mbstate_t state;
+                          memset (&state, '\0', sizeof (mbstate_t));
+# endif
+
+                          count = local_wcrtomb (cbuf, arg, &state);
+                          if (count < 0)
+                            /* Inconsistency.  */
+                            abort ();
+                          characters = count;
+                        }
+                    }
+# if DCHAR_IS_TCHAR
+                  else
+                    {
+                      /* The number of bytes doesn't matter.  */
+                      characters = 0;
+                    }
+# endif
+
+# if !DCHAR_IS_TCHAR
+                  /* Convert the string into a piece of temporary memory.  */
+                  if (characters > 0) /* implies arg != 0 */
+                    {
+                      char cbuf64; /* Assume MB_CUR_MAX <= 64.  */
+                      int count;
+#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+                      mbstate_t state;
+                      memset (&state, '\0', sizeof (mbstate_t));
+#  endif
+
+                      count = local_wcrtomb (cbuf, arg, &state);
+                      if (count <= 0)
+                        /* Inconsistency.  */
+                        abort ();
+                      memcpy (tmpsrc, cbuf, count);
+                    }
+
+                  /* Convert from TCHAR_T to DCHAR_T.  */
+                  tmpdst =
+                    DCHAR_CONV_FROM_ENCODING (locale_charset (),
+                                              iconveh_question_mark,
+                                              tmpsrc, characters,
+                                              NULL,
+                                              NULL, &tmpdst_len);
+                  if (tmpdst == NULL)
+                    goto fail_with_errno;
+# endif
+
+                  if (has_width)
+                    {
+# if ENABLE_UNISTDIO
+                      /* Outside POSIX, it's preferable to compare the width
+                         against the number of _characters_ of the converted
+                         value.  */
+                      w = DCHAR_MBSNLEN (result + length, characters);
+# else
+                      /* The width is compared against the number of _bytes_
+                         of the converted value, says POSIX.  */
+                      w = characters;
+# endif
+                    }
+                  else
+                    /* w doesn't matter.  */
+                    w = 0;
+
+                  if (w < width && !(flags & FLAG_LEFT))
+                    {
+                      size_t n = width - w;
+                      ENSURE_ALLOCATION (xsum (length, n));
+                      DCHAR_SET (result + length, ' ', n);
+                      length += n;
+                    }
+
+# if DCHAR_IS_TCHAR
+                  if (has_width)
+                    {
+                      /* We know the number of bytes in advance.  */
+                      ENSURE_ALLOCATION (xsum (length, characters));
+                      if (characters > 0) /* implies arg != 0 */
+                        {
+                          int count;
+#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+                          mbstate_t state;
+                          memset (&state, '\0', sizeof (mbstate_t));
+#  endif
+
+                          count = local_wcrtomb (result + length, arg, &state);
+                          if (count <= 0)
+                            /* Inconsistency.  */
+                            abort ();
+                          length += count;
+                        }
+                    }
+                  else
+                    {
+                      if (arg != 0)
+                        {
+                          char cbuf64; /* Assume MB_CUR_MAX <= 64.  */
+                          int count;
+#  if HAVE_WCRTOMB && !defined GNULIB_defined_mbstate_t
+                          mbstate_t state;
+                          memset (&state, '\0', sizeof (mbstate_t));
+#  endif
+
+                          count = local_wcrtomb (cbuf, arg, &state);
+                          if (count <= 0)
+                            /* Inconsistency.  */
+                            abort ();
+                          ENSURE_ALLOCATION (xsum (length, count));
+                          memcpy (result + length, cbuf, count);
+                          length += count;
+                        }
+                    }
+# else
+                  ENSURE_ALLOCATION_ELSE (xsum (length, tmpdst_len),
+                                          { free (tmpdst); goto out_of_memory; });
+                  DCHAR_CPY (result + length, tmpdst, tmpdst_len);
+                  free (tmpdst);
+                  length += tmpdst_len;
+# endif
+
+                  if (w < width && (flags & FLAG_LEFT))
+                    {
+                      size_t n = width - w;
+                      ENSURE_ALLOCATION (xsum (length, n));
+                      DCHAR_SET (result + length, ' ', n);
+                      length += n;
+                    }
+                }
+              }
+#endif
 #if (NEED_PRINTF_DIRECTIVE_A || NEED_PRINTF_LONG_DOUBLE || NEED_PRINTF_DOUBLE) && !defined IN_LIBINTL
             else if ((dp->conversion == 'a' || dp->conversion == 'A')
 # if !(NEED_PRINTF_DIRECTIVE_A || (NEED_PRINTF_LONG_DOUBLE && NEED_PRINTF_DOUBLE))
@@ -4835,17 +4954,15 @@
 
                 switch (type)
                   {
-#if HAVE_LONG_LONG_INT
                   case TYPE_LONGLONGINT:
                   case TYPE_ULONGLONGINT:
-# if defined _WIN32 && ! defined __CYGWIN__
+#if defined _WIN32 && ! defined __CYGWIN__
                     *fbp++ = 'I';
                     *fbp++ = '6';
                     *fbp++ = '4';
                     break;
-# else
+#else
                     *fbp++ = 'l';
-# endif
 #endif
                     FALLTHROUGH;
                   case TYPE_LONGINT:
@@ -4871,30 +4988,32 @@
 #endif
                   *fbp = dp->conversion;
 #if USE_SNPRINTF
-# if ! (((__GLIBC__ > 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 3))        \
-         && !defined __UCLIBC__)                                            \
-        || (defined __APPLE__ && defined __MACH__)                          \
-        || (defined _WIN32 && ! defined __CYGWIN__))
-                fbp1 = '%';
-                fbp2 = 'n';
-                fbp3 = '\0';
-# else
-                /* On glibc2 systems from glibc >= 2.3 - probably also older
-                   ones - we know that snprintf's return value conforms to
-                   ISO C 99: the tests gl_SNPRINTF_RETVAL_C99 and
-                   gl_SNPRINTF_TRUNCATION_C99 pass.
-                   Therefore we can avoid using %n in this situation.
-                   On glibc2 systems from 2004-10-18 or newer, the use of %n
-                   in format strings in writable memory may crash the program
-                   (if compiled with _FORTIFY_SOURCE=2), so we should avoid it
-                   in this situation.  */
-                /* On Mac OS X 10.3 or newer, we know that snprintf's return
-                   value conforms to ISO C 99: the tests gl_SNPRINTF_RETVAL_C99
-                   and gl_SNPRINTF_TRUNCATION_C99 pass.
-                   Therefore we can avoid using %n in this situation.
-                   On Mac OS X 10.13 or newer, the use of %n in format strings
-                   in writable memory by default crashes the program, so we
-                   should avoid it in this situation.  */
+# if ((HAVE_SNPRINTF_RETVAL_C99 && HAVE_SNPRINTF_TRUNCATION_C99)            \
+      || ((__GLIBC__ > 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 3))       \
+          && !defined __UCLIBC__)                                           \
+      || (defined __APPLE__ && defined __MACH__)                            \
+      || defined __ANDROID__                                                \
+      || (defined _WIN32 && ! defined __CYGWIN__))
+                /* On systems where we know that snprintf's return value
+                   conforms to ISO C 99 (HAVE_SNPRINTF_RETVAL_C99) and that
+                   snprintf always produces NUL-terminated strings
+                   (HAVE_SNPRINTF_TRUNCATION_C99), it is possible to avoid
+                   using %n.  And it is desirable to do so, because more and
+                   more platforms no longer support %n, for "security reasons".
+                   In particular, the following platforms:
+                     - On glibc2 systems from 2004-10-18 or newer, the use of
+                       %n in format strings in writable memory may crash the
+                       program (if compiled with _FORTIFY_SOURCE=2).
+                     - On Mac OS X 10.13 or newer, the use of %n in format
+                       strings in writable memory by default crashes the
+                       program.
+                     - On Android, starting on 2018-03-07, the use of %n in
+                       format strings produces a fatal error (see
+                       <https://android.googlesource.com/platform/bionic/+/41398d03b7e8e0dfb951660ae713e682e9fc0336>).
+                   On these platforms, HAVE_SNPRINTF_RETVAL_C99 and
+                   HAVE_SNPRINTF_TRUNCATION_C99 are 1. We have listed them
+                   explicitly in the condition above, in case of cross-
+                   compilation (just to be sure).  */
                 /* On native Windows systems (such as mingw), we can avoid using
                    %n because:
                      - Although the gl_SNPRINTF_TRUNCATION_C99 test fails,
@@ -4908,9 +5027,13 @@
                    Windows Vista, the use of %n in format strings by default
                    crashes the program. See
                      <https://gcc.gnu.org/ml/gcc/2007-06/msg00122.html> and
-                     <https://msdn.microsoft.com/en-us/library/ms175782.aspx>
+                     <https://docs.microsoft.com/en-us/cpp/c-runtime-library/reference/set-printf-count-output>
                    So we should avoid %n in this situation.  */
                 fbp1 = '\0';
+# else           /* AIX <= 5.1, HP-UX, IRIX, OSF/1, Solaris <= 9, BeOS */
+                fbp1 = '%';
+                fbp2 = 'n';
+                fbp3 = '\0';
 # endif
 #else
                 fbp1 = '\0';
@@ -5054,7 +5177,6 @@
                           SNPRINTF_BUF (arg);
                         }
                         break;
-#if HAVE_LONG_LONG_INT
                       case TYPE_LONGLONGINT:
                         {
                           long long int arg = a.argdp->arg_index.a.a_longlongint;
@@ -5067,7 +5189,6 @@
                           SNPRINTF_BUF (arg);
                         }
                         break;
-#endif
                       case TYPE_DOUBLE:
                         {
                           double arg = a.argdp->arg_index.a.a_double;
@@ -5199,25 +5320,17 @@
                     /* Attempt to handle failure.  */
                     if (count < 0)
                       {
-                        /* SNPRINTF or sprintf failed.  Save and use the errno
-                           that it has set, if any.  */
-                        int saved_errno = errno;
-                        if (saved_errno == 0)
+                        /* SNPRINTF or sprintf failed.  Use the errno that it
+                           has set, if any.  */
+                        if (errno == 0)
                           {
                             if (dp->conversion == 'c' || dp->conversion == 's')
-                              saved_errno = EILSEQ;
+                              errno = EILSEQ;
                             else
-                              saved_errno = EINVAL;
+                              errno = EINVAL;
                           }
 
-                        if (!(result == resultbuf || result == NULL))
-                          free (result);
-                        if (buf_malloced != NULL)
-                          free (buf_malloced);
-                        CLEANUP ();
-
-                        errno = saved_errno;
-                        return NULL;
+                        goto fail_with_errno;
                       }
 
 #if USE_SNPRINTF
@@ -5338,7 +5451,7 @@
                         DCHAR_T *tmpdst;
                         size_t tmpdst_len;
                         /* This code assumes that TCHAR_T is 'char'.  */
-                        verify (sizeof (TCHAR_T) == 1);
+                        static_assert (sizeof (TCHAR_T) == 1);
 # if USE_SNPRINTF
                         tmpsrc = (TCHAR_T *) (result + length);
 # else
@@ -5351,17 +5464,9 @@
                                                     NULL,
                                                     NULL, &tmpdst_len);
                         if (tmpdst == NULL)
-                          {
-                            int saved_errno = errno;
-                            if (!(result == resultbuf || result == NULL))
-                              free (result);
-                            if (buf_malloced != NULL)
-                              free (buf_malloced);
-                            CLEANUP ();
-                            errno = saved_errno;
-                            return NULL;
-                          }
-                        ENSURE_ALLOCATION (xsum (length, tmpdst_len));
+                          goto fail_with_errno;
+                        ENSURE_ALLOCATION_ELSE (xsum (length, tmpdst_len),
+                                                { free (tmpdst); goto out_of_memory; });
                         DCHAR_CPY (result + length, tmpdst, tmpdst_len);
                         free (tmpdst);
                         count = tmpdst_len;
@@ -5584,25 +5689,40 @@
 
 #if USE_SNPRINTF
   overflow:
-    if (!(result == resultbuf || result == NULL))
-      free (result);
-    if (buf_malloced != NULL)
-      free (buf_malloced);
-    CLEANUP ();
     errno = EOVERFLOW;
-    return NULL;
+    goto fail_with_errno;
 #endif
 
   out_of_memory:
-    if (!(result == resultbuf || result == NULL))
+    errno = ENOMEM;
+    goto fail_with_errno;
+
+#if ENABLE_UNISTDIO || ((!USE_SNPRINTF || !HAVE_SNPRINTF_RETVAL_C99 || USE_MSVC__SNPRINTF || (NEED_PRINTF_DIRECTIVE_LS && !defined IN_LIBINTL) || ENABLE_WCHAR_FALLBACK) && HAVE_WCHAR_T)
+  fail_with_EILSEQ:
+    errno = EILSEQ;
+    goto fail_with_errno;
+#endif
+
+  fail_with_errno:
+    if (result != resultbuf)
       free (result);
     if (buf_malloced != NULL)
       free (buf_malloced);
-  out_of_memory_1:
     CLEANUP ();
-    errno = ENOMEM;
     return NULL;
   }
+
+ out_of_memory_1:
+  errno = ENOMEM;
+  goto fail_1_with_errno;
+
+ fail_1_with_EINVAL:
+  errno = EINVAL;
+  goto fail_1_with_errno;
+
+ fail_1_with_errno:
+  CLEANUP ();
+  return NULL;
 }
 
 #undef MAX_ROOM_NEEDED

_service:tar_scm:groff-1.22.4.tar.gz/lib/vasnprintf.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/vasnprintf.h Changed

@@ -1,18 +1,18 @@
 /* vsprintf with automatic memory allocation.
-   Copyright (C) 2002-2004, 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2002-2004, 2007-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _VASNPRINTF_H
 #define _VASNPRINTF_H
@@ -23,17 +23,8 @@
 /* Get size_t.  */
 #include <stddef.h>
 
-/* The __attribute__ feature is available in gcc versions 2.5 and later.
-   The __-protected variants of the attributes 'format' and 'printf' are
-   accepted by gcc versions 2.6.4 (effectively 2.7) and later.
-   We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because
-   gnulib and libintl do '#define printf __printf__' when they override
-   the 'printf' function.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
-# define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
-#else
-# define _GL_ATTRIBUTE_FORMAT(spec) /* empty */
-#endif
+/* Get _GL_ATTRIBUTE_SPEC_PRINTF_STANDARD.  */
+#include <stdio.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -67,10 +58,12 @@
 # define asnprintf rpl_asnprintf
 # define vasnprintf rpl_vasnprintf
 #endif
-extern char * asnprintf (char *resultbuf, size_t *lengthp, const char *format, ...)
-       _GL_ATTRIBUTE_FORMAT ((__printf__, 3, 4));
-extern char * vasnprintf (char *resultbuf, size_t *lengthp, const char *format, va_list args)
-       _GL_ATTRIBUTE_FORMAT ((__printf__, 3, 0));
+extern char * asnprintf (char *restrict resultbuf, size_t *lengthp,
+                         const char *format, ...)
+       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 3, 4));
+extern char * vasnprintf (char *restrict resultbuf, size_t *lengthp,
+                          const char *format, va_list args)
+       _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF_STANDARD, 3, 0));
 
 #ifdef __cplusplus
 }

_service:tar_scm:groff-1.22.4.tar.gz/lib/verify.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/verify.h Changed

@@ -1,18 +1,18 @@
 /* Compile-time assert-like macros.
 
-   Copyright (C) 2005-2006, 2009-2018 Free Software Foundation, Inc.
+   Copyright (C) 2005-2006, 2009-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Paul Eggert, Bruno Haible, and Jim Meyering.  */
@@ -21,31 +21,32 @@
 #define _GL_VERIFY_H
 
 
-/* Define _GL_HAVE__STATIC_ASSERT to 1 if _Static_assert works as per C11.
-   This is supported by GCC 4.6.0 and later, in C mode, and its use
-   here generates easier-to-read diagnostics when verify (R) fails.
+/* Define _GL_HAVE__STATIC_ASSERT to 1 if _Static_assert (R, DIAGNOSTIC)
+   works as per C11.  This is supported by GCC 4.6.0+ and by clang 4+.
 
-   Define _GL_HAVE_STATIC_ASSERT to 1 if static_assert works as per C++11.
-   This will likely be supported by future GCC versions, in C++ mode.
+   Define _GL_HAVE__STATIC_ASSERT1 to 1 if _Static_assert (R) works as
+   per C23.  This is supported by GCC 9.1+.
 
-   Use this only with GCC.  If we were willing to slow 'configure'
-   down we could also use it with other compilers, but since this
-   affects only the quality of diagnostics, why bother?  */
-#if (4 < __GNUC__ + (6 <= __GNUC_MINOR__) \
-     && (201112L <= __STDC_VERSION__  || !defined __STRICT_ANSI__) \
-     && !defined __cplusplus)
-# define _GL_HAVE__STATIC_ASSERT 1
-#endif
-/* The condition (99 < __GNUC__) is temporary, until we know about the
-   first G++ release that supports static_assert.  */
-#if (99 < __GNUC__) && defined __cplusplus
-# define _GL_HAVE_STATIC_ASSERT 1
+   Support compilers claiming conformance to the relevant standard,
+   and also support GCC when not pedantic.  If we were willing to slow
+   'configure' down we could also use it with other compilers, but
+   since this affects only the quality of diagnostics, why bother?  */
+#ifndef __cplusplus
+# if (201112 <= __STDC_VERSION__ \
+      || (!defined __STRICT_ANSI__ \
+          && (4 < __GNUC__ + (6 <= __GNUC_MINOR__) || 5 <= __clang_major__)))
+#  define _GL_HAVE__STATIC_ASSERT 1
+# endif
+# if (202311 <= __STDC_VERSION__ \
+      || (!defined __STRICT_ANSI__ && 9 <= __GNUC__))
+#  define _GL_HAVE__STATIC_ASSERT1 1
+# endif
 #endif
 
 /* FreeBSD 9.1 <sys/cdefs.h>, included by <stddef.h> and lots of other
    system headers, defines a conflicting _Static_assert that is no
    better than ours; override it.  */
-#ifndef _GL_HAVE_STATIC_ASSERT
+#ifndef _GL_HAVE__STATIC_ASSERT
 # include <stddef.h>
 # undef _Static_assert
 #endif
@@ -143,9 +144,9 @@
      which do not support _Static_assert, also do not warn about the
      last declaration mentioned above.
 
-   * GCC warns if -Wnested-externs is enabled and verify() is used
+   * GCC warns if -Wnested-externs is enabled and 'verify' is used
      within a function body; but inside a function, you can always
-     arrange to use verify_expr() instead.
+     arrange to use verify_expr instead.
 
    * In C++, any struct definition inside sizeof is invalid.
      Use a template type to work around the problem.  */
@@ -197,48 +198,110 @@
 #endif
 
 /* Verify requirement R at compile-time, as a declaration without a
-   trailing ';'.  If R is false, fail at compile-time, preferably
-   with a diagnostic that includes the string-literal DIAGNOSTIC.
+   trailing ';'.  If R is false, fail at compile-time.
+
+   This macro requires three or more arguments but uses at most the first
+   two, so that the _Static_assert macro optionally defined below supports
+   both the C11 two-argument syntax and the C23 one-argument syntax.
 
    Unfortunately, unlike C11, this implementation must appear as an
    ordinary declaration, and cannot appear inside struct { ... }.  */
 
-#ifdef _GL_HAVE__STATIC_ASSERT
-# define _GL_VERIFY _Static_assert
+#if 202311 <= __STDC_VERSION__ || 200410 <= __cpp_static_assert
+# define _GL_VERIFY(R, DIAGNOSTIC, ...) static_assert (R, DIAGNOSTIC)
+#elif defined _GL_HAVE__STATIC_ASSERT
+# define _GL_VERIFY(R, DIAGNOSTIC, ...) _Static_assert (R, DIAGNOSTIC)
 #else
-# define _GL_VERIFY(R, DIAGNOSTIC)				       \
+# define _GL_VERIFY(R, DIAGNOSTIC, ...)                                \
     extern int (*_GL_GENSYM (_gl_verify_function) (void))	       \
       _GL_VERIFY_TRUE (R, DIAGNOSTIC)
+# if 4 < __GNUC__ + (6 <= __GNUC_MINOR__)
+#  pragma GCC diagnostic ignored "-Wnested-externs"
+# endif
 #endif
 
 /* _GL_STATIC_ASSERT_H is defined if this code is copied into assert.h.  */
 #ifdef _GL_STATIC_ASSERT_H
-# if !defined _GL_HAVE__STATIC_ASSERT && !defined _Static_assert
-#  define _Static_assert(R, DIAGNOSTIC) _GL_VERIFY (R, DIAGNOSTIC)
+/* Define _Static_assert if needed.  */
+/* With clang ≥ 3.8.0 in C++ mode, _Static_assert already works and accepts
+   1 or 2 arguments.  We better don't override it, because clang's standard
+   C++ library uses static_assert inside classes in several places, and our
+   replacement via _GL_VERIFY does not work in these contexts.  */
+# if (defined __cplusplus && defined __clang__ \
+      && (4 <= __clang_major__ + (8 <= __clang_minor__)))
+#  if 5 <= __clang_major__
+/* Avoid "warning: 'static_assert' with no message is a C++17 extension".  */
+#   pragma clang diagnostic ignored "-Wc++17-extensions"
+#  else
+/* Avoid "warning: static_assert with no message is a C++1z extension".  */
+#   pragma clang diagnostic ignored "-Wc++1z-extensions"
+#  endif
+# elif !defined _GL_HAVE__STATIC_ASSERT1 && !defined _Static_assert
+#  if !defined _MSC_VER || defined __clang__
+#   define _Static_assert(...) \
+      _GL_VERIFY (__VA_ARGS__, "static assertion failed", -)
+#  else
+    /* Work around MSVC preprocessor incompatibility with ISO C; see
+       <https://stackoverflow.com/questions/5134523/>.  */
+#   define _Static_assert(R, ...) \
+      _GL_VERIFY ((R), "static assertion failed", -)
+#  endif
 # endif
-# if !defined _GL_HAVE_STATIC_ASSERT && !defined static_assert
-#  define static_assert _Static_assert /* C11 requires this #define.  */
+/* Define static_assert if needed.  */
+# if (!defined static_assert \
+      && __STDC_VERSION__ < 202311 \
+      && (!defined __cplusplus \
+          || (__cpp_static_assert < 201411 \
+              && __GNUG__ < 6 && __clang_major__ < 6)))
+#  if defined __cplusplus && _MSC_VER >= 1900 && !defined __clang__
+/* MSVC 14 in C++ mode supports the two-arguments static_assert but not
+   the one-argument static_assert, and it does not support _Static_assert.
+   We have to play preprocessor tricks to distinguish the two cases.
+   Since the MSVC preprocessor is not ISO C compliant (see above),.
+   the solution is specific to MSVC.  */
+#   define _GL_EXPAND(x) x
+#   define _GL_SA1(a1) static_assert ((a1), "static assertion failed")
+#   define _GL_SA2 static_assert
+#   define _GL_SA3 static_assert
+#   define _GL_SA_PICK(x1,x2,x3,x4,...) x4
+#   define static_assert(...) _GL_EXPAND(_GL_SA_PICK(__VA_ARGS__,_GL_SA3,_GL_SA2,_GL_SA1)) (__VA_ARGS__)
+#  else
+#   define static_assert _Static_assert /* C11 requires this #define. */
+#  endif
 # endif
 #endif
 
 /* @assert.h omit start@  */
 
+#if defined __clang_major__ && __clang_major__ < 5
+# define _GL_HAS_BUILTIN_TRAP 0
+#elif 3 < __GNUC__ + (3 < __GNUC_MINOR__ + (4 <= __GNUC_PATCHLEVEL__))
+# define _GL_HAS_BUILTIN_TRAP 1
+#elif defined __has_builtin
+# define _GL_HAS_BUILTIN_TRAP __has_builtin (__builtin_trap)
+#else
+# define _GL_HAS_BUILTIN_TRAP 0
+#endif
+
+#if defined __clang_major__ && __clang_major__ < 5
+# define _GL_HAS_BUILTIN_UNREACHABLE 0
+#elif 4 < __GNUC__ + (5 <= __GNUC_MINOR__)
+# define _GL_HAS_BUILTIN_UNREACHABLE 1
+#elif defined __has_builtin
+# define _GL_HAS_BUILTIN_UNREACHABLE __has_builtin (__builtin_unreachable)
+#else
+# define _GL_HAS_BUILTIN_UNREACHABLE 0
+#endif
+
 /* Each of these macros verifies that its argument R is nonzero.  To
    be portable, R should be an integer constant expression.  Unlike
    assert (R), there is no run-time overhead.
 
    There are two macros, since no single macro can be used in all
-   contexts in C.  verify_true (R) is for scalar contexts, including
+   contexts in C.  verify_expr (R, E) is for scalar contexts, including
    integer constant expression contexts.  verify (R) is for declaration
    contexts, e.g., the top level.  */
 
-/* Verify requirement R at compile-time, as an integer constant expression.
-   Return 1.  This is equivalent to verify_expr (R, 1).
-
-   verify_true is obsolescent; please use verify_expr instead.  */
-
-#define verify_true(R) _GL_VERIFY_TRUE (R, "verify_true (" #R ")")
-
 /* Verify requirement R at compile-time.  Return the value of the
    expression E.  */
 
@@ -246,37 +309,54 @@
    (_GL_VERIFY_TRUE (R, "verify_expr (" #R ", " #E ")") ? (E) : (E))
 
 /* Verify requirement R at compile-time, as a declaration without a
-   trailing ';'.  */
+   trailing ';'.  verify (R) acts like static_assert (R) except that
+   it is portable to C11/C++14 and earlier, it can issue better
+   diagnostics, and its name is shorter and may be more convenient.  */
 
-#ifdef __GNUC__
-# define verify(R) _GL_VERIFY (R, "verify (" #R ")")
+#ifdef __PGI
+/* PGI barfs if R is long.  */
+# define verify(R) _GL_VERIFY (R, "verify (...)", -)
 #else
-/* PGI barfs if R is long.  Play it safe.  */
-# define verify(R) _GL_VERIFY (R, "verify (...)")
+# define verify(R) _GL_VERIFY (R, "verify (" #R ")", -)
 #endif
 
-#ifndef __has_builtin
-# define __has_builtin(x) 0
-#endif
+/* Assume that R always holds.  Behavior is undefined if R is false,
+   fails to evaluate, or has side effects.
+
+   'assume (R)' is a directive from the programmer telling the
+   compiler that R is true so the compiler needn't generate code to
+   test R.  This is why 'assume' is in verify.h: it's related to
+   static checking (in this case, static checking done by the
+   programmer), not dynamic checking.
+
+   'assume (R)' can affect compilation of all the code, not just code
+   that happens to be executed after the assume (R) is "executed".
+   For example, if the code mistakenly does 'assert (R); assume (R);'
+   the compiler is entitled to optimize away the 'assert (R)'.
 
-/* Assume that R always holds.  This lets the compiler optimize
-   accordingly.  R should not have side-effects; it may or may not be
-   evaluated.  Behavior is undefined if R is false.  */
+   Although assuming R can help a compiler generate better code or
+   diagnostics, performance can suffer if R uses hard-to-optimize
+   features such as function calls not inlined by the compiler.
 
-#if (__has_builtin (__builtin_unreachable) \
-     || 4 < __GNUC__ + (5 <= __GNUC_MINOR__))
+   Avoid Clang's __builtin_assume, as it breaks GNU Emacs master
+   as of 2020-08-23T21:09:49Z!eggert@cs.ucla.edu; see
+   <https://bugs.gnu.org/43152#71>.  It's not known whether this breakage
+   is a Clang bug or an Emacs bug; play it safe for now.  */
+
+#if _GL_HAS_BUILTIN_UNREACHABLE
 # define assume(R) ((R) ? (void) 0 : __builtin_unreachable ())
 #elif 1200 <= _MSC_VER
 # define assume(R) __assume (R)
-#elif ((defined GCC_LINT || defined lint) \
-       && (__has_builtin (__builtin_trap) \
-           || 3 < __GNUC__ + (3 < __GNUC_MINOR__ + (4 <= __GNUC_PATCHLEVEL__))))
+#elif 202311 <= __STDC_VERSION__
+# include <stddef.h>
+# define assume(R) ((R) ? (void) 0 : unreachable ())
+#elif (defined GCC_LINT || defined lint) && _GL_HAS_BUILTIN_TRAP
   /* Doing it this way helps various packages when configured with
      --enable-gcc-warnings, which compiles with -Dlint.  It's nicer
-     when 'assume' silences warnings even with older GCCs.  */
+     if 'assume' silences warnings with GCC 3.4 through GCC 4.4.7 (2012).  */
 # define assume(R) ((R) ? (void) 0 : __builtin_trap ())
 #else
-  /* Some tools grok NOTREACHED, e.g., Oracle Studio 12.6.  */
+  /* Some older tools grok NOTREACHED, e.g., Oracle Studio 12.6 (2017).  */
 # define assume(R) ((R) ? (void) 0 : /*NOTREACHED*/ (void) 0)
 #endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/vsnprintf.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/vsnprintf.c Changed

@@ -1,19 +1,19 @@
 /* Formatted output to strings.
-   Copyright (C) 2004, 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 2004, 2006-2023 Free Software Foundation, Inc.
    Written by Simon Josefsson and Yoann Vandoorselaere <yoann@prelude-ids.org>.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License along
-   with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifdef HAVE_CONFIG_H
 # include <config.h>

_service:tar_scm:groff-1.22.4.tar.gz/lib/warn-on-use.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/warn-on-use.h Changed

@@ -1,17 +1,17 @@
 /* A C macro for emitting warnings if a function is used.
-   Copyright (C) 2010-2018 Free Software Foundation, Inc.
+   Copyright (C) 2010-2023 Free Software Foundation, Inc.
 
    This program 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
+   under the terms of the GNU Lesser General Public License as published
+   by the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
 
    This program 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.
+   Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* _GL_WARN_ON_USE (function, "literal string") issues a declaration
@@ -84,13 +84,20 @@
 # if 4 < __GNUC__ || (__GNUC__ == 4 && 3 <= __GNUC_MINOR__)
 /* A compiler attribute is available in gcc versions 4.3.0 and later.  */
 #  define _GL_WARN_ON_USE(function, message) \
-extern __typeof__ (function) function __attribute__ ((__warning__ (message)))
+_GL_WARN_EXTERN_C __typeof__ (function) function __attribute__ ((__warning__ (message)))
 #  define _GL_WARN_ON_USE_ATTRIBUTE(message) \
   __attribute__ ((__warning__ (message)))
+# elif __clang_major__ >= 4
+/* Another compiler attribute is available in clang.  */
+#  define _GL_WARN_ON_USE(function, message) \
+_GL_WARN_EXTERN_C __typeof__ (function) function \
+  __attribute__ ((__diagnose_if__ (1, message, "warning")))
+#  define _GL_WARN_ON_USE_ATTRIBUTE(message) \
+  __attribute__ ((__diagnose_if__ (1, message, "warning")))
 # elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING
 /* Verify the existence of the function.  */
 #  define _GL_WARN_ON_USE(function, message) \
-extern __typeof__ (function) function
+_GL_WARN_EXTERN_C __typeof__ (function) function
 #  define _GL_WARN_ON_USE_ATTRIBUTE(message)
 # else /* Unsupported.  */
 #  define _GL_WARN_ON_USE(function, message) \
@@ -99,24 +106,35 @@
 # endif
 #endif
 
-/* _GL_WARN_ON_USE_CXX (function, rettype, parameters_and_attributes, "string")
-   is like _GL_WARN_ON_USE (function, "string"), except that the function is
-   declared with the given prototype, consisting of return type, parameters,
-   and attributes.
+/* _GL_WARN_ON_USE_CXX (function, rettype_gcc, rettype_clang, parameters_and_attributes, "message")
+   is like _GL_WARN_ON_USE (function, "message"), except that in C++ mode the
+   function is declared with the given prototype, consisting of return type,
+   parameters, and attributes.
    This variant is useful for overloaded functions in C++. _GL_WARN_ON_USE does
    not work in this case.  */
 #ifndef _GL_WARN_ON_USE_CXX
-# if 4 < __GNUC__ || (__GNUC__ == 4 && 3 <= __GNUC_MINOR__)
-#  define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \
-extern rettype function parameters_and_attributes \
-     __attribute__ ((__warning__ (msg)))
-# elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING
+# if !defined __cplusplus
+#  define _GL_WARN_ON_USE_CXX(function,rettype_gcc,rettype_clang,parameters_and_attributes,msg) \
+     _GL_WARN_ON_USE (function, msg)
+# else
+#  if 4 < __GNUC__ || (__GNUC__ == 4 && 3 <= __GNUC_MINOR__)
+/* A compiler attribute is available in gcc versions 4.3.0 and later.  */
+#   define _GL_WARN_ON_USE_CXX(function,rettype_gcc,rettype_clang,parameters_and_attributes,msg) \
+extern rettype_gcc function parameters_and_attributes \
+  __attribute__ ((__warning__ (msg)))
+#  elif __clang_major__ >= 4
+/* Another compiler attribute is available in clang.  */
+#   define _GL_WARN_ON_USE_CXX(function,rettype_gcc,rettype_clang,parameters_and_attributes,msg) \
+extern rettype_clang function parameters_and_attributes \
+  __attribute__ ((__diagnose_if__ (1, msg, "warning")))
+#  elif __GNUC__ >= 3 && GNULIB_STRICT_CHECKING
 /* Verify the existence of the function.  */
-#  define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \
-extern rettype function parameters_and_attributes
-# else /* Unsupported.  */
-#  define _GL_WARN_ON_USE_CXX(function,rettype,parameters_and_attributes,msg) \
+#   define _GL_WARN_ON_USE_CXX(function,rettype_gcc,rettype_clang,parameters_and_attributes,msg) \
+extern rettype_gcc function parameters_and_attributes
+#  else /* Unsupported.  */
+#   define _GL_WARN_ON_USE_CXX(function,rettype_gcc,rettype_clang,parameters_and_attributes,msg) \
 _GL_WARN_EXTERN_C int _gl_warn_on_use
+#  endif
 # endif
 #endif

_service:tar_scm:groff-1.22.4.tar.gz/lib/wchar.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/wchar.in.h Changed

@@ -1,25 +1,25 @@
 /* A substitute for ISO C99 <wchar.h>, for platforms that have issues.
 
-   Copyright (C) 2007-2018 Free Software Foundation, Inc.
+   Copyright (C) 2007-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Eric Blake.  */
 
 /*
  * ISO C 99 <wchar.h> for platforms that have issues.
- * <http://www.opengroup.org/susv3xbd/wchar.h.html>
+ * <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/wchar.h.html>
  *
  * For now, this just ensures proper prerequisite inclusion order and
  * the declaration of wcwidth().
@@ -33,7 +33,8 @@
 #if (((defined __need_mbstate_t || defined __need_wint_t)               \
       && !defined __MINGW32__)                                          \
      || (defined __hpux                                                 \
-         && ((defined _INTTYPES_INCLUDED && !defined strtoimax)         \
+         && ((defined _INTTYPES_INCLUDED                                \
+              && !defined _GL_FINISHED_INCLUDING_SYSTEM_INTTYPES_H)     \
              || defined _GL_JUST_INCLUDE_SYSTEM_WCHAR_H))               \
      || (defined __MINGW32__ && defined __STRING_H_SOURCED__)           \
      || defined _GL_ALREADY_INCLUDING_WCHAR_H)
@@ -64,20 +65,12 @@
 # include <features.h> /* for __GLIBC__ */
 #endif
 
-/* Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.
-   In some builds of uClibc, <wchar.h> is nonexistent and wchar_t is defined
+/* In some builds of uClibc, <wchar.h> is nonexistent and wchar_t is defined
    by <stddef.h>.
    But avoid namespace pollution on glibc systems.  */
 #if !(defined __GLIBC__ && !defined __UCLIBC__)
 # include <stddef.h>
 #endif
-#ifndef __GLIBC__
-# include <stdio.h>
-# include <time.h>
-#endif
 
 /* Include the original <wchar.h> if it exists.
    Some builds of uClibc lack it.  */
@@ -91,12 +84,50 @@
 #ifndef _@GUARD_PREFIX@_WCHAR_H
 #define _@GUARD_PREFIX@_WCHAR_H
 
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if __GNUC__ >= 11
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC_FREE
+# if defined __cplusplus && defined __GNUC__ && !defined __clang__
+/* Work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=108231> */
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC ((void (*) (void *)) free, 1)
+# else
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC (free, 1)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MALLOC declares that the function returns a pointer to freshly
+   allocated memory.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_MALLOC
+# if __GNUC__ >= 3 || defined __clang__
+#  define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
+# else
+#  define _GL_ATTRIBUTE_MALLOC
+# endif
+#endif
+
 /* The __attribute__ feature is available in gcc versions 2.5 and later.
    The attribute __pure__ was added in gcc 2.96.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-# define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
-#else
-# define _GL_ATTRIBUTE_PURE /* empty */
+#ifndef _GL_ATTRIBUTE_PURE
+# if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96) || defined __clang__
+#  define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
+# else
+#  define _GL_ATTRIBUTE_PURE /* empty */
+# endif
 #endif
 
 /* The definitions of _GL_FUNCDECL_RPL etc. are copied here.  */
@@ -116,7 +147,7 @@
 /* mingw and MSVC define wint_t as 'unsigned short' in <crtdefs.h> or
    <stddef.h>.  This is too small: ISO C 99 section 7.24.1.(2) says that
    wint_t must be "unchanged by default argument promotions".  Override it.  */
-# if @GNULIB_OVERRIDES_WINT_T@
+# if @GNULIBHEADERS_OVERRIDE_WINT_T@
 #  if !GNULIB_defined_wint_t
 #   if @HAVE_CRTDEFS_H@
 #    include <crtdefs.h>
@@ -137,16 +168,59 @@
 
 /* Override mbstate_t if it is too small.
    On IRIX 6.5, sizeof (mbstate_t) == 1, which is not sufficient for
-   implementing mbrtowc for encodings like UTF-8.  */
-#if !(@HAVE_MBSINIT@ && @HAVE_MBRTOWC@) || @REPLACE_MBSTATE_T@
+   implementing mbrtowc for encodings like UTF-8.
+   On AIX and MSVC, mbrtowc needs to be overridden, but mbstate_t exists and is
+   large enough and overriding it would cause problems in C++ mode.  */
+#if !(((defined _WIN32 && !defined __CYGWIN__) || @HAVE_MBSINIT@) && @HAVE_MBRTOWC@) || @REPLACE_MBSTATE_T@
 # if !GNULIB_defined_mbstate_t
+#  if !(defined _AIX || defined _MSC_VER)
 typedef int rpl_mbstate_t;
-#  undef mbstate_t
-#  define mbstate_t rpl_mbstate_t
+#   undef mbstate_t
+#   define mbstate_t rpl_mbstate_t
+#  endif
 #  define GNULIB_defined_mbstate_t 1
 # endif
 #endif
 
+/* Make _GL_ATTRIBUTE_DEALLOC_FREE work, even though <stdlib.h> may not have
+   been included yet.  */
+#if @GNULIB_FREE_POSIX@
+# if (@REPLACE_FREE@ && !defined free \
+      && !(defined __cplusplus && defined GNULIB_NAMESPACE))
+/* We can't do '#define free rpl_free' here.  */
+_GL_EXTERN_C void rpl_free (void *);
+#  undef _GL_ATTRIBUTE_DEALLOC_FREE
+#  define _GL_ATTRIBUTE_DEALLOC_FREE _GL_ATTRIBUTE_DEALLOC (rpl_free, 1)
+# else
+#  if defined _MSC_VER && !defined free
+_GL_EXTERN_C
+#   if defined _DLL
+     __declspec (dllimport)
+#   endif
+     void __cdecl free (void *);
+#  else
+#   if defined __cplusplus && (__GLIBC__ + (__GLIBC_MINOR__ >= 14) > 2)
+_GL_EXTERN_C void free (void *) throw ();
+#   else
+_GL_EXTERN_C void free (void *);
+#   endif
+#  endif
+# endif
+#else
+# if defined _MSC_VER && !defined free
+_GL_EXTERN_C
+#   if defined _DLL
+     __declspec (dllimport)
+#   endif
+     void __cdecl free (void *);
+# else
+#  if defined __cplusplus && (__GLIBC__ + (__GLIBC_MINOR__ >= 14) > 2)
+_GL_EXTERN_C void free (void *) throw ();
+#  else
+_GL_EXTERN_C void free (void *);
+#  endif
+# endif
+#endif
 
 /* Convert a single-byte character to a wide character.  */
 #if @GNULIB_BTOWC@
@@ -161,9 +235,12 @@
 #  if !@HAVE_BTOWC@
 _GL_FUNCDECL_SYS (btowc, wint_t, (int c) _GL_ATTRIBUTE_PURE);
 #  endif
-_GL_CXXALIAS_SYS (btowc, wint_t, (int c));
+/* Need to cast, because on mingw, the return type is 'unsigned short'.  */
+_GL_CXXALIAS_SYS_CAST (btowc, wint_t, (int c));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (btowc);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef btowc
 # if HAVE_RAW_DECL_BTOWC
@@ -189,7 +266,9 @@
 #  endif
 _GL_CXXALIAS_SYS (wctob, int, (wint_t wc));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wctob);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wctob
 # if HAVE_RAW_DECL_WCTOB
@@ -214,7 +293,9 @@
 #  endif
 _GL_CXXALIAS_SYS (mbsinit, int, (const mbstate_t *ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbsinit);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mbsinit
 # if HAVE_RAW_DECL_MBSINIT
@@ -232,18 +313,24 @@
 #   define mbrtowc rpl_mbrtowc
 #  endif
 _GL_FUNCDECL_RPL (mbrtowc, size_t,
-                  (wchar_t *pwc, const char *s, size_t n, mbstate_t *ps));
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n,
+                   mbstate_t *restrict ps));
 _GL_CXXALIAS_RPL (mbrtowc, size_t,
-                  (wchar_t *pwc, const char *s, size_t n, mbstate_t *ps));
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n,
+                   mbstate_t *restrict ps));
 # else
 #  if !@HAVE_MBRTOWC@
 _GL_FUNCDECL_SYS (mbrtowc, size_t,
-                  (wchar_t *pwc, const char *s, size_t n, mbstate_t *ps));
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n,
+                   mbstate_t *restrict ps));
 #  endif
 _GL_CXXALIAS_SYS (mbrtowc, size_t,
-                  (wchar_t *pwc, const char *s, size_t n, mbstate_t *ps));
+                  (wchar_t *restrict pwc, const char *restrict s, size_t n,
+                   mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbrtowc);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mbrtowc
 # if HAVE_RAW_DECL_MBRTOWC
@@ -260,15 +347,21 @@
 #   undef mbrlen
 #   define mbrlen rpl_mbrlen
 #  endif
-_GL_FUNCDECL_RPL (mbrlen, size_t, (const char *s, size_t n, mbstate_t *ps));
-_GL_CXXALIAS_RPL (mbrlen, size_t, (const char *s, size_t n, mbstate_t *ps));
+_GL_FUNCDECL_RPL (mbrlen, size_t,
+                  (const char *restrict s, size_t n, mbstate_t *restrict ps));
+_GL_CXXALIAS_RPL (mbrlen, size_t,
+                  (const char *restrict s, size_t n, mbstate_t *restrict ps));
 # else
 #  if !@HAVE_MBRLEN@
-_GL_FUNCDECL_SYS (mbrlen, size_t, (const char *s, size_t n, mbstate_t *ps));
+_GL_FUNCDECL_SYS (mbrlen, size_t,
+                  (const char *restrict s, size_t n, mbstate_t *restrict ps));
 #  endif
-_GL_CXXALIAS_SYS (mbrlen, size_t, (const char *s, size_t n, mbstate_t *ps));
+_GL_CXXALIAS_SYS (mbrlen, size_t,
+                  (const char *restrict s, size_t n, mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbrlen);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mbrlen
 # if HAVE_RAW_DECL_MBRLEN
@@ -286,22 +379,30 @@
 #   define mbsrtowcs rpl_mbsrtowcs
 #  endif
 _GL_FUNCDECL_RPL (mbsrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t len, mbstate_t *ps)
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 _GL_CXXALIAS_RPL (mbsrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t len,
-                   mbstate_t *ps));
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t len,
+                   mbstate_t *restrict ps));
 # else
 #  if !@HAVE_MBSRTOWCS@
 _GL_FUNCDECL_SYS (mbsrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t len, mbstate_t *ps)
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 #  endif
 _GL_CXXALIAS_SYS (mbsrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t len,
-                   mbstate_t *ps));
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t len,
+                   mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbsrtowcs);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mbsrtowcs
 # if HAVE_RAW_DECL_MBSRTOWCS
@@ -319,24 +420,30 @@
 #   define mbsnrtowcs rpl_mbsnrtowcs
 #  endif
 _GL_FUNCDECL_RPL (mbsnrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps)
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t srclen, size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 _GL_CXXALIAS_RPL (mbsnrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps));
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t srclen, size_t len,
+                   mbstate_t *restrict ps));
 # else
 #  if !@HAVE_MBSNRTOWCS@
 _GL_FUNCDECL_SYS (mbsnrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps)
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t srclen, size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 #  endif
 _GL_CXXALIAS_SYS (mbsnrtowcs, size_t,
-                  (wchar_t *dest, const char **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps));
+                  (wchar_t *restrict dest,
+                   const char **restrict srcp, size_t srclen, size_t len,
+                   mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (mbsnrtowcs);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef mbsnrtowcs
 # if HAVE_RAW_DECL_MBSNRTOWCS
@@ -353,15 +460,21 @@
 #   undef wcrtomb
 #   define wcrtomb rpl_wcrtomb
 #  endif
-_GL_FUNCDECL_RPL (wcrtomb, size_t, (char *s, wchar_t wc, mbstate_t *ps));
-_GL_CXXALIAS_RPL (wcrtomb, size_t, (char *s, wchar_t wc, mbstate_t *ps));
+_GL_FUNCDECL_RPL (wcrtomb, size_t,
+                  (char *restrict s, wchar_t wc, mbstate_t *restrict ps));
+_GL_CXXALIAS_RPL (wcrtomb, size_t,
+                  (char *restrict s, wchar_t wc, mbstate_t *restrict ps));
 # else
 #  if !@HAVE_WCRTOMB@
-_GL_FUNCDECL_SYS (wcrtomb, size_t, (char *s, wchar_t wc, mbstate_t *ps));
+_GL_FUNCDECL_SYS (wcrtomb, size_t,
+                  (char *restrict s, wchar_t wc, mbstate_t *restrict ps));
 #  endif
-_GL_CXXALIAS_SYS (wcrtomb, size_t, (char *s, wchar_t wc, mbstate_t *ps));
+_GL_CXXALIAS_SYS (wcrtomb, size_t,
+                  (char *restrict s, wchar_t wc, mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcrtomb);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcrtomb
 # if HAVE_RAW_DECL_WCRTOMB
@@ -379,22 +492,30 @@
 #   define wcsrtombs rpl_wcsrtombs
 #  endif
 _GL_FUNCDECL_RPL (wcsrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t len, mbstate_t *ps)
+                  (char *restrict dest, const wchar_t **restrict srcp,
+                   size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 _GL_CXXALIAS_RPL (wcsrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t len,
-                   mbstate_t *ps));
+                  (char *restrict dest, const wchar_t **restrict srcp,
+                   size_t len,
+                   mbstate_t *restrict ps));
 # else
 #  if !@HAVE_WCSRTOMBS@
 _GL_FUNCDECL_SYS (wcsrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t len, mbstate_t *ps)
+                  (char *restrict dest, const wchar_t **restrict srcp,
+                   size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 #  endif
 _GL_CXXALIAS_SYS (wcsrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t len,
-                   mbstate_t *ps));
+                  (char *restrict dest, const wchar_t **restrict srcp,
+                   size_t len,
+                   mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsrtombs);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsrtombs
 # if HAVE_RAW_DECL_WCSRTOMBS
@@ -412,24 +533,34 @@
 #   define wcsnrtombs rpl_wcsnrtombs
 #  endif
 _GL_FUNCDECL_RPL (wcsnrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps)
+                  (char *restrict dest,
+                   const wchar_t **restrict srcp, size_t srclen,
+                   size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 _GL_CXXALIAS_RPL (wcsnrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps));
+                  (char *restrict dest,
+                   const wchar_t **restrict srcp, size_t srclen,
+                   size_t len,
+                   mbstate_t *restrict ps));
 # else
-#  if !@HAVE_WCSNRTOMBS@
+#  if !@HAVE_WCSNRTOMBS@ || (defined __cplusplus && defined __sun)
 _GL_FUNCDECL_SYS (wcsnrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps)
+                  (char *restrict dest,
+                   const wchar_t **restrict srcp, size_t srclen,
+                   size_t len,
+                   mbstate_t *restrict ps)
                   _GL_ARG_NONNULL ((2)));
 #  endif
 _GL_CXXALIAS_SYS (wcsnrtombs, size_t,
-                  (char *dest, const wchar_t **srcp, size_t srclen, size_t len,
-                   mbstate_t *ps));
+                  (char *restrict dest,
+                   const wchar_t **restrict srcp, size_t srclen,
+                   size_t len,
+                   mbstate_t *restrict ps));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsnrtombs);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsnrtombs
 # if HAVE_RAW_DECL_WCSNRTOMBS
@@ -455,7 +586,9 @@
 #  endif
 _GL_CXXALIAS_SYS (wcwidth, int, (wchar_t));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcwidth);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcwidth
 # if HAVE_RAW_DECL_WCWIDTH
@@ -484,7 +617,7 @@
 _GL_CXXALIASWARN1 (wmemchr, wchar_t *, (wchar_t *s, wchar_t c, size_t n));
 _GL_CXXALIASWARN1 (wmemchr, const wchar_t *,
                    (const wchar_t *s, wchar_t c, size_t n));
-# else
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (wmemchr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -505,7 +638,9 @@
 # endif
 _GL_CXXALIAS_SYS (wmemcmp, int,
                   (const wchar_t *s1, const wchar_t *s2, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wmemcmp);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wmemcmp
 # if HAVE_RAW_DECL_WMEMCMP
@@ -519,11 +654,15 @@
 #if @GNULIB_WMEMCPY@
 # if !@HAVE_WMEMCPY@
 _GL_FUNCDECL_SYS (wmemcpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
 # endif
 _GL_CXXALIAS_SYS (wmemcpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wmemcpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wmemcpy
 # if HAVE_RAW_DECL_WMEMCPY
@@ -542,7 +681,9 @@
 # endif
 _GL_CXXALIAS_SYS (wmemmove, wchar_t *,
                   (wchar_t *dest, const wchar_t *src, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wmemmove);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wmemmove
 # if HAVE_RAW_DECL_WMEMMOVE
@@ -552,13 +693,51 @@
 #endif
 
 
+/* Copy N wide characters of SRC to DEST.
+   Return pointer to wide characters after the last written wide character.  */
+#if @GNULIB_WMEMPCPY@
+# if @REPLACE_WMEMPCPY@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef wmempcpy
+#   define wmempcpy rpl_wmempcpy
+#  endif
+_GL_FUNCDECL_RPL (wmempcpy, wchar_t *,
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+_GL_CXXALIAS_RPL (wmempcpy, wchar_t *,
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+# else
+#  if !@HAVE_WMEMPCPY@
+_GL_FUNCDECL_SYS (wmempcpy, wchar_t *,
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+#  endif
+_GL_CXXALIAS_SYS (wmempcpy, wchar_t *,
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+# endif
+# if __GLIBC__ >= 2
+_GL_CXXALIASWARN (wmempcpy);
+# endif
+#elif defined GNULIB_POSIXCHECK
+# undef wmempcpy
+# if HAVE_RAW_DECL_WMEMPCPY
+_GL_WARN_ON_USE (wmempcpy, "wmempcpy is unportable - "
+                 "use gnulib module wmempcpy for portability");
+# endif
+#endif
+
+
 /* Set N wide characters of S to C.  */
 #if @GNULIB_WMEMSET@
 # if !@HAVE_WMEMSET@
 _GL_FUNCDECL_SYS (wmemset, wchar_t *, (wchar_t *s, wchar_t c, size_t n));
 # endif
 _GL_CXXALIAS_SYS (wmemset, wchar_t *, (wchar_t *s, wchar_t c, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wmemset);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wmemset
 # if HAVE_RAW_DECL_WMEMSET
@@ -574,7 +753,9 @@
 _GL_FUNCDECL_SYS (wcslen, size_t, (const wchar_t *s) _GL_ATTRIBUTE_PURE);
 # endif
 _GL_CXXALIAS_SYS (wcslen, size_t, (const wchar_t *s));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcslen);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcslen
 # if HAVE_RAW_DECL_WCSLEN
@@ -586,7 +767,10 @@
 
 /* Return the number of wide characters in S, but at most MAXLEN.  */
 #if @GNULIB_WCSNLEN@
-# if !@HAVE_WCSNLEN@
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+# if !@HAVE_WCSNLEN@ || (defined __sun && defined __cplusplus)
 _GL_FUNCDECL_SYS (wcsnlen, size_t, (const wchar_t *s, size_t maxlen)
                                    _GL_ATTRIBUTE_PURE);
 # endif
@@ -604,10 +788,14 @@
 /* Copy SRC to DEST.  */
 #if @GNULIB_WCSCPY@
 # if !@HAVE_WCSCPY@
-_GL_FUNCDECL_SYS (wcscpy, wchar_t *, (wchar_t *dest, const wchar_t *src));
+_GL_FUNCDECL_SYS (wcscpy, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
 # endif
-_GL_CXXALIAS_SYS (wcscpy, wchar_t *, (wchar_t *dest, const wchar_t *src));
+_GL_CXXALIAS_SYS (wcscpy, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcscpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcscpy
 # if HAVE_RAW_DECL_WCSCPY
@@ -619,10 +807,15 @@
 
 /* Copy SRC to DEST, returning the address of the terminating L'\0' in DEST.  */
 #if @GNULIB_WCPCPY@
-# if !@HAVE_WCPCPY@
-_GL_FUNCDECL_SYS (wcpcpy, wchar_t *, (wchar_t *dest, const wchar_t *src));
-# endif
-_GL_CXXALIAS_SYS (wcpcpy, wchar_t *, (wchar_t *dest, const wchar_t *src));
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+# if !@HAVE_WCPCPY@ || (defined __sun && defined __cplusplus)
+_GL_FUNCDECL_SYS (wcpcpy, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
+# endif
+_GL_CXXALIAS_SYS (wcpcpy, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
 _GL_CXXALIASWARN (wcpcpy);
 #elif defined GNULIB_POSIXCHECK
 # undef wcpcpy
@@ -637,11 +830,15 @@
 #if @GNULIB_WCSNCPY@
 # if !@HAVE_WCSNCPY@
 _GL_FUNCDECL_SYS (wcsncpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
 # endif
 _GL_CXXALIAS_SYS (wcsncpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsncpy);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsncpy
 # if HAVE_RAW_DECL_WCSNCPY
@@ -654,12 +851,17 @@
 /* Copy no more than N characters of SRC to DEST, returning the address of
    the last character written into DEST.  */
 #if @GNULIB_WCPNCPY@
-# if !@HAVE_WCPNCPY@
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+# if !@HAVE_WCPNCPY@ || (defined __sun && defined __cplusplus)
 _GL_FUNCDECL_SYS (wcpncpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
 # endif
 _GL_CXXALIAS_SYS (wcpncpy, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest,
+                   const wchar_t *restrict src, size_t n));
 _GL_CXXALIASWARN (wcpncpy);
 #elif defined GNULIB_POSIXCHECK
 # undef wcpncpy
@@ -673,10 +875,14 @@
 /* Append SRC onto DEST.  */
 #if @GNULIB_WCSCAT@
 # if !@HAVE_WCSCAT@
-_GL_FUNCDECL_SYS (wcscat, wchar_t *, (wchar_t *dest, const wchar_t *src));
+_GL_FUNCDECL_SYS (wcscat, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
 # endif
-_GL_CXXALIAS_SYS (wcscat, wchar_t *, (wchar_t *dest, const wchar_t *src));
+_GL_CXXALIAS_SYS (wcscat, wchar_t *,
+                  (wchar_t *restrict dest, const wchar_t *restrict src));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcscat);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcscat
 # if HAVE_RAW_DECL_WCSCAT
@@ -690,11 +896,15 @@
 #if @GNULIB_WCSNCAT@
 # if !@HAVE_WCSNCAT@
 _GL_FUNCDECL_SYS (wcsncat, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest, const wchar_t *restrict src,
+                   size_t n));
 # endif
 _GL_CXXALIAS_SYS (wcsncat, wchar_t *,
-                  (wchar_t *dest, const wchar_t *src, size_t n));
+                  (wchar_t *restrict dest, const wchar_t *restrict src,
+                   size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsncat);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsncat
 # if HAVE_RAW_DECL_WCSNCAT
@@ -711,7 +921,9 @@
                                _GL_ATTRIBUTE_PURE);
 # endif
 _GL_CXXALIAS_SYS (wcscmp, int, (const wchar_t *s1, const wchar_t *s2));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcscmp);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcscmp
 # if HAVE_RAW_DECL_WCSCMP
@@ -730,7 +942,9 @@
 # endif
 _GL_CXXALIAS_SYS (wcsncmp, int,
                   (const wchar_t *s1, const wchar_t *s2, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsncmp);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsncmp
 # if HAVE_RAW_DECL_WCSNCMP
@@ -742,7 +956,10 @@
 
 /* Compare S1 and S2, ignoring case.  */
 #if @GNULIB_WCSCASECMP@
-# if !@HAVE_WCSCASECMP@
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+# if !@HAVE_WCSCASECMP@ || (defined __sun && defined __cplusplus)
 _GL_FUNCDECL_SYS (wcscasecmp, int, (const wchar_t *s1, const wchar_t *s2)
                                    _GL_ATTRIBUTE_PURE);
 # endif
@@ -759,7 +976,10 @@
 
 /* Compare no more than N chars of S1 and S2, ignoring case.  */
 #if @GNULIB_WCSNCASECMP@
-# if !@HAVE_WCSNCASECMP@
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+# if !@HAVE_WCSNCASECMP@ || (defined __sun && defined __cplusplus)
 _GL_FUNCDECL_SYS (wcsncasecmp, int,
                   (const wchar_t *s1, const wchar_t *s2, size_t n)
                   _GL_ATTRIBUTE_PURE);
@@ -783,7 +1003,9 @@
 _GL_FUNCDECL_SYS (wcscoll, int, (const wchar_t *s1, const wchar_t *s2));
 # endif
 _GL_CXXALIAS_SYS (wcscoll, int, (const wchar_t *s1, const wchar_t *s2));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcscoll);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcscoll
 # if HAVE_RAW_DECL_WCSCOLL
@@ -798,10 +1020,14 @@
    original strings.  */
 #if @GNULIB_WCSXFRM@
 # if !@HAVE_WCSXFRM@
-_GL_FUNCDECL_SYS (wcsxfrm, size_t, (wchar_t *s1, const wchar_t *s2, size_t n));
+_GL_FUNCDECL_SYS (wcsxfrm, size_t,
+                  (wchar_t *restrict s1, const wchar_t *restrict s2, size_t n));
 # endif
-_GL_CXXALIAS_SYS (wcsxfrm, size_t, (wchar_t *s1, const wchar_t *s2, size_t n));
+_GL_CXXALIAS_SYS (wcsxfrm, size_t,
+                  (wchar_t *restrict s1, const wchar_t *restrict s2, size_t n));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsxfrm);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsxfrm
 # if HAVE_RAW_DECL_WCSXFRM
@@ -813,16 +1039,58 @@
 
 /* Duplicate S, returning an identical malloc'd string.  */
 #if @GNULIB_WCSDUP@
-# if !@HAVE_WCSDUP@
-_GL_FUNCDECL_SYS (wcsdup, wchar_t *, (const wchar_t *s));
-# endif
+# if defined _WIN32 && !defined __CYGWIN__
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef wcsdup
+#   define wcsdup _wcsdup
+#  endif
+_GL_CXXALIAS_MDA (wcsdup, wchar_t *, (const wchar_t *s));
+# else
+/* On Solaris 11.3, the header files declare the function in the std::
+   namespace, not in the global namespace.  So, force a declaration in
+   the global namespace.  */
+#  if !@HAVE_WCSDUP@ || (defined __sun && defined __cplusplus) || __GNUC__ >= 11
+_GL_FUNCDECL_SYS (wcsdup, wchar_t *,
+                  (const wchar_t *s)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#  endif
 _GL_CXXALIAS_SYS (wcsdup, wchar_t *, (const wchar_t *s));
+# endif
 _GL_CXXALIASWARN (wcsdup);
-#elif defined GNULIB_POSIXCHECK
-# undef wcsdup
-# if HAVE_RAW_DECL_WCSDUP
+#else
+# if __GNUC__ >= 11 && !defined wcsdup
+/* For -Wmismatched-dealloc: Associate wcsdup with free or rpl_free.  */
+_GL_FUNCDECL_SYS (wcsdup, wchar_t *,
+                  (const wchar_t *s)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+# endif
+# if defined GNULIB_POSIXCHECK
+#  undef wcsdup
+#  if HAVE_RAW_DECL_WCSDUP
 _GL_WARN_ON_USE (wcsdup, "wcsdup is unportable - "
                  "use gnulib module wcsdup for portability");
+#  endif
+# elif @GNULIB_MDA_WCSDUP@
+/* On native Windows, map 'wcsdup' to '_wcsdup', so that -loldnames is not
+   required.  In C++ with GNULIB_NAMESPACE, avoid differences between
+   platforms by defining GNULIB_NAMESPACE::wcsdup always.  */
+#  if defined _WIN32 && !defined __CYGWIN__
+#   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#    undef wcsdup
+#    define wcsdup _wcsdup
+#   endif
+_GL_CXXALIAS_MDA (wcsdup, wchar_t *, (const wchar_t *s));
+#  else
+_GL_FUNCDECL_SYS (wcsdup, wchar_t *,
+                  (const wchar_t *s)
+                  _GL_ATTRIBUTE_MALLOC _GL_ATTRIBUTE_DEALLOC_FREE);
+#   if @HAVE_DECL_WCSDUP@
+_GL_CXXALIAS_SYS (wcsdup, wchar_t *, (const wchar_t *s));
+#   endif
+#  endif
+#  if (defined _WIN32 && !defined __CYGWIN__) || @HAVE_DECL_WCSDUP@
+_GL_CXXALIASWARN (wcsdup);
+#  endif
 # endif
 #endif
 
@@ -845,7 +1113,7 @@
      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 _GL_CXXALIASWARN1 (wcschr, wchar_t *, (wchar_t *wcs, wchar_t wc));
 _GL_CXXALIASWARN1 (wcschr, const wchar_t *, (const wchar_t *wcs, wchar_t wc));
-# else
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcschr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -875,7 +1143,7 @@
      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 _GL_CXXALIASWARN1 (wcsrchr, wchar_t *, (wchar_t *wcs, wchar_t wc));
 _GL_CXXALIASWARN1 (wcsrchr, const wchar_t *, (const wchar_t *wcs, wchar_t wc));
-# else
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsrchr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -895,7 +1163,9 @@
                                    _GL_ATTRIBUTE_PURE);
 # endif
 _GL_CXXALIAS_SYS (wcscspn, size_t, (const wchar_t *wcs, const wchar_t *reject));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcscspn);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcscspn
 # if HAVE_RAW_DECL_WCSCSPN
@@ -913,7 +1183,9 @@
                                   _GL_ATTRIBUTE_PURE);
 # endif
 _GL_CXXALIAS_SYS (wcsspn, size_t, (const wchar_t *wcs, const wchar_t *accept));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsspn);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsspn
 # if HAVE_RAW_DECL_WCSSPN
@@ -944,7 +1216,7 @@
                    (wchar_t *wcs, const wchar_t *accept));
 _GL_CXXALIASWARN1 (wcspbrk, const wchar_t *,
                    (const wchar_t *wcs, const wchar_t *accept));
-# else
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcspbrk);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -960,7 +1232,8 @@
 #if @GNULIB_WCSSTR@
 # if !@HAVE_WCSSTR@
 _GL_FUNCDECL_SYS (wcsstr, wchar_t *,
-                  (const wchar_t *haystack, const wchar_t *needle)
+                  (const wchar_t *restrict haystack,
+                   const wchar_t *restrict needle)
                   _GL_ATTRIBUTE_PURE);
 # endif
   /* On some systems, this function is defined as an overloaded function:
@@ -969,15 +1242,19 @@
          wchar_t * std::wcsstr (wchar_t *, const wchar_t *);
        }  */
 _GL_CXXALIAS_SYS_CAST2 (wcsstr,
-                        wchar_t *, (const wchar_t *, const wchar_t *),
-                        const wchar_t *, (const wchar_t *, const wchar_t *));
+                        wchar_t *,
+                        (const wchar_t *restrict, const wchar_t *restrict),
+                        const wchar_t *,
+                        (const wchar_t *restrict, const wchar_t *restrict));
 # if ((__GLIBC__ == 2 && __GLIBC_MINOR__ >= 10) && !defined __UCLIBC__) \
      && (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ >= 4))
 _GL_CXXALIASWARN1 (wcsstr, wchar_t *,
-                   (wchar_t *haystack, const wchar_t *needle));
+                   (wchar_t *restrict haystack,
+                    const wchar_t *restrict needle));
 _GL_CXXALIASWARN1 (wcsstr, const wchar_t *,
-                   (const wchar_t *haystack, const wchar_t *needle));
-# else
+                   (const wchar_t *restrict haystack,
+                    const wchar_t *restrict needle));
+# elif __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsstr);
 # endif
 #elif defined GNULIB_POSIXCHECK
@@ -991,13 +1268,30 @@
 
 /* Divide WCS into tokens separated by characters in DELIM.  */
 #if @GNULIB_WCSTOK@
-# if !@HAVE_WCSTOK@
+# if @REPLACE_WCSTOK@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef wcstok
+#   define wcstok rpl_wcstok
+#  endif
+_GL_FUNCDECL_RPL (wcstok, wchar_t *,
+                  (wchar_t *restrict wcs, const wchar_t *restrict delim,
+                   wchar_t **restrict ptr));
+_GL_CXXALIAS_RPL (wcstok, wchar_t *,
+                  (wchar_t *restrict wcs, const wchar_t *restrict delim,
+                   wchar_t **restrict ptr));
+# else
+#  if !@HAVE_WCSTOK@
 _GL_FUNCDECL_SYS (wcstok, wchar_t *,
-                  (wchar_t *wcs, const wchar_t *delim, wchar_t **ptr));
-# endif
+                  (wchar_t *restrict wcs, const wchar_t *restrict delim,
+                   wchar_t **restrict ptr));
+#  endif
 _GL_CXXALIAS_SYS (wcstok, wchar_t *,
-                  (wchar_t *wcs, const wchar_t *delim, wchar_t **ptr));
+                  (wchar_t *restrict wcs, const wchar_t *restrict delim,
+                   wchar_t **restrict ptr));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcstok);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcstok
 # if HAVE_RAW_DECL_WCSTOK
@@ -1025,7 +1319,9 @@
 #  endif
 _GL_CXXALIAS_SYS (wcswidth, int, (const wchar_t *s, size_t n));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcswidth);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcswidth
 # if HAVE_RAW_DECL_WCSWIDTH
@@ -1036,28 +1332,38 @@
 
 
 /* Convert *TP to a date and time wide string.  See
-   <http://pubs.opengroup.org/onlinepubs/9699919799/functions/wcsftime.html>.  */
+   <https://pubs.opengroup.org/onlinepubs/9699919799/functions/wcsftime.html>.  */
 #if @GNULIB_WCSFTIME@
 # if @REPLACE_WCSFTIME@
 #  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #   undef wcsftime
 #   define wcsftime rpl_wcsftime
 #  endif
-_GL_FUNCDECL_RPL (wcsftime, size_t, (wchar_t *__buf, size_t __bufsize,
-                                     const wchar_t *__fmt, const struct tm *__tp)
-                                    _GL_ARG_NONNULL ((1, 3, 4)));
-_GL_CXXALIAS_RPL (wcsftime, size_t, (wchar_t *__buf, size_t __bufsize,
-                                     const wchar_t *__fmt, const struct tm *__tp));
+_GL_FUNCDECL_RPL (wcsftime, size_t,
+                  (wchar_t *restrict __buf, size_t __bufsize,
+                   const wchar_t *restrict __fmt,
+                   const struct tm *restrict __tp)
+                  _GL_ARG_NONNULL ((1, 3, 4)));
+_GL_CXXALIAS_RPL (wcsftime, size_t,
+                  (wchar_t *restrict __buf, size_t __bufsize,
+                   const wchar_t *restrict __fmt,
+                   const struct tm *restrict __tp));
 # else
 #  if !@HAVE_WCSFTIME@
-_GL_FUNCDECL_SYS (wcsftime, size_t, (wchar_t *__buf, size_t __bufsize,
-                                     const wchar_t *__fmt, const struct tm *__tp)
-                                    _GL_ARG_NONNULL ((1, 3, 4)));
+_GL_FUNCDECL_SYS (wcsftime, size_t,
+                  (wchar_t *restrict __buf, size_t __bufsize,
+                   const wchar_t *restrict __fmt,
+                   const struct tm *restrict __tp)
+                  _GL_ARG_NONNULL ((1, 3, 4)));
 #  endif
-_GL_CXXALIAS_SYS (wcsftime, size_t, (wchar_t *__buf, size_t __bufsize,
-                                     const wchar_t *__fmt, const struct tm *__tp));
+_GL_CXXALIAS_SYS (wcsftime, size_t,
+                  (wchar_t *restrict __buf, size_t __bufsize,
+                   const wchar_t *restrict __fmt,
+                   const struct tm *restrict __tp));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wcsftime);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wcsftime
 # if HAVE_RAW_DECL_WCSFTIME

_service:tar_scm:groff-1.22.4.tar.gz/lib/wctype-h.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/wctype-h.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/wctype.in.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/wctype.in.h Changed

@@ -1,25 +1,25 @@
 /* A substitute for ISO C99 <wctype.h>, for platforms that lack it.
 
-   Copyright (C) 2006-2018 Free Software Foundation, Inc.
+   Copyright (C) 2006-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* Written by Bruno Haible and Paul Eggert.  */
 
 /*
  * ISO C 99 <wctype.h> for platforms that lack it.
- * <http://www.opengroup.org/susv3xbd/wctype.h.html>
+ * <https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/wctype.h.html>
  *
  * iswctype, towctrans, towlower, towupper, wctrans, wctype,
  * wctrans_t, and wctype_t are not yet implemented.
@@ -45,14 +45,7 @@
 #ifndef _@GUARD_PREFIX@_WCTYPE_H
 
 #if @HAVE_WINT_T@
-/* Solaris 2.5 has a bug: <wchar.h> must be included before <wctype.h>.
-   Tru64 with Desktop Toolkit C has a bug: <stdio.h> must be included before
-   <wchar.h>.
-   BSD/OS 4.0.1 has a bug: <stddef.h>, <stdio.h> and <time.h> must be
-   included before <wchar.h>.  */
-# include <stddef.h>
-# include <stdio.h>
-# include <time.h>
+/* Solaris 2.5 has a bug: <wchar.h> must be included before <wctype.h>.  */
 # include <wchar.h>
 #endif
 
@@ -110,7 +103,7 @@
 /* mingw and MSVC define wint_t as 'unsigned short' in <crtdefs.h> or
    <stddef.h>.  This is too small: ISO C 99 section 7.24.1.(2) says that
    wint_t must be "unchanged by default argument promotions".  Override it.  */
-# if @GNULIB_OVERRIDES_WINT_T@
+# if @GNULIBHEADERS_OVERRIDE_WINT_T@
 #  if !GNULIB_defined_wint_t
 #   if @HAVE_CRTDEFS_H@
 #    include <crtdefs.h>
@@ -133,33 +126,116 @@
 
 /* FreeBSD 4.4 to 4.11 has <wctype.h> but lacks the functions.
    Linux libc5 has <wctype.h> and the functions but they are broken.
+   mingw and MSVC have <wctype.h> and the functions but they take a wchar_t
+   as argument, not an rpl_wint_t.
    Assume all 11 functions (all isw* except iswblank) are implemented the
    same way, or not at all.  */
 # if ! @HAVE_ISWCNTRL@ || @REPLACE_ISWCNTRL@
 
-/* IRIX 5.3 has macros but no functions, its isw* macros refer to an
-   undefined variable _ctmp_ and to <ctype.h> macros like _P, and they
-   refer to system functions like _iswctype that are not in the
-   standard C library.  Rather than try to get ancient buggy
-   implementations like this to work, just disable them.  */
-#  undef iswalnum
-#  undef iswalpha
-#  undef iswblank
-#  undef iswcntrl
-#  undef iswdigit
-#  undef iswgraph
-#  undef iswlower
-#  undef iswprint
-#  undef iswpunct
-#  undef iswspace
-#  undef iswupper
-#  undef iswxdigit
-#  undef towlower
-#  undef towupper
+#  if @GNULIBHEADERS_OVERRIDE_WINT_T@ /* implies @REPLACE_ISWCNTRL@ */
+
+_GL_WCTYPE_INLINE int
+rpl_iswalnum (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswalnum ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswalpha (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswalpha ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswblank (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswblank ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswcntrl (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswcntrl ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswdigit (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? wc >= '0' && wc <= '9' : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswgraph (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswgraph ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswlower (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswlower ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswprint (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswprint ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswpunct (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswpunct ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswspace (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswspace ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswupper (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? iswupper ((wchar_t) wc) : 0);
+}
+
+_GL_WCTYPE_INLINE int
+rpl_iswxdigit (wint_t wc)
+{
+  return ((wchar_t) wc == wc
+          ? (wc >= '0' && wc <= '9')
+            || ((wc & ~0x20) >= 'A' && (wc & ~0x20) <= 'F')
+          : 0);
+}
+
+_GL_WCTYPE_INLINE wint_t
+rpl_towlower (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? (wchar_t) towlower ((wchar_t) wc) : wc);
+}
+
+_GL_WCTYPE_INLINE wint_t
+rpl_towupper (wint_t wc)
+{
+  return ((wchar_t) wc == wc ? (wchar_t) towupper ((wchar_t) wc) : wc);
+}
 
-/* Linux libc5 has <wctype.h> and the functions but they are broken.  */
-#  if @REPLACE_ISWCNTRL@
 #   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#    undef iswalnum
+#    undef iswalpha
+#    undef iswblank
+#    undef iswcntrl
+#    undef iswdigit
+#    undef iswgraph
+#    undef iswlower
+#    undef iswprint
+#    undef iswpunct
+#    undef iswspace
+#    undef iswupper
+#    undef iswxdigit
+#    undef towlower
+#    undef towupper
 #    define iswalnum rpl_iswalnum
 #    define iswalpha rpl_iswalpha
 #    define iswblank rpl_iswblank
@@ -172,21 +248,62 @@
 #    define iswspace rpl_iswspace
 #    define iswupper rpl_iswupper
 #    define iswxdigit rpl_iswxdigit
-#   endif
-#  endif
-#  if @REPLACE_TOWLOWER@
-#   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
 #    define towlower rpl_towlower
 #    define towupper rpl_towupper
 #   endif
-#  endif
+
+#  else
+
+/* IRIX 5.3 has macros but no functions, its isw* macros refer to an
+   undefined variable _ctmp_ and to <ctype.h> macros like _P, and they
+   refer to system functions like _iswctype that are not in the
+   standard C library.  Rather than try to get ancient buggy
+   implementations like this to work, just disable them.  */
+#   undef iswalnum
+#   undef iswalpha
+#   undef iswblank
+#   undef iswcntrl
+#   undef iswdigit
+#   undef iswgraph
+#   undef iswlower
+#   undef iswprint
+#   undef iswpunct
+#   undef iswspace
+#   undef iswupper
+#   undef iswxdigit
+#   undef towlower
+#   undef towupper
+
+/* Linux libc5 has <wctype.h> and the functions but they are broken.  */
+#   if @REPLACE_ISWCNTRL@
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     define iswalnum rpl_iswalnum
+#     define iswalpha rpl_iswalpha
+#     define iswblank rpl_iswblank
+#     define iswcntrl rpl_iswcntrl
+#     define iswdigit rpl_iswdigit
+#     define iswgraph rpl_iswgraph
+#     define iswlower rpl_iswlower
+#     define iswprint rpl_iswprint
+#     define iswpunct rpl_iswpunct
+#     define iswspace rpl_iswspace
+#     define iswupper rpl_iswupper
+#     define iswxdigit rpl_iswxdigit
+#    endif
+#   endif
+#   if @REPLACE_TOWLOWER@
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     define towlower rpl_towlower
+#     define towupper rpl_towupper
+#    endif
+#   endif
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswalnum
-#  else
+#   else
 iswalnum
-#  endif
+#   endif
          (wint_t wc)
 {
   return ((wc >= '0' && wc <= '9')
@@ -194,88 +311,88 @@
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswalpha
-#  else
+#   else
 iswalpha
-#  endif
+#   endif
          (wint_t wc)
 {
   return (wc & ~0x20) >= 'A' && (wc & ~0x20) <= 'Z';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswblank
-#  else
+#   else
 iswblank
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc == ' ' || wc == '\t';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswcntrl
-#  else
+#   else
 iswcntrl
-#  endif
+#   endif
         (wint_t wc)
 {
   return (wc & ~0x1f) == 0 || wc == 0x7f;
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWDIGIT@
 rpl_iswdigit
-#  else
+#   else
 iswdigit
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc >= '0' && wc <= '9';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswgraph
-#  else
+#   else
 iswgraph
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc >= '!' && wc <= '~';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswlower
-#  else
+#   else
 iswlower
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc >= 'a' && wc <= 'z';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswprint
-#  else
+#   else
 iswprint
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc >= ' ' && wc <= '~';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswpunct
-#  else
+#   else
 iswpunct
-#  endif
+#   endif
          (wint_t wc)
 {
   return (wc >= '!' && wc <= '~'
@@ -284,11 +401,11 @@
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswspace
-#  else
+#   else
 iswspace
-#  endif
+#   endif
          (wint_t wc)
 {
   return (wc == ' ' || wc == '\t'
@@ -296,22 +413,22 @@
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWCNTRL@
 rpl_iswupper
-#  else
+#   else
 iswupper
-#  endif
+#   endif
          (wint_t wc)
 {
   return wc >= 'A' && wc <= 'Z';
 }
 
 _GL_WCTYPE_INLINE int
-#  if @REPLACE_ISWCNTRL@
+#   if @REPLACE_ISWXDIGIT@
 rpl_iswxdigit
-#  else
+#   else
 iswxdigit
-#  endif
+#   endif
           (wint_t wc)
 {
   return ((wc >= '0' && wc <= '9')
@@ -319,42 +436,67 @@
 }
 
 _GL_WCTYPE_INLINE wint_t
-#  if @REPLACE_TOWLOWER@
+#   if @REPLACE_TOWLOWER@
 rpl_towlower
-#  else
+#   else
 towlower
-#  endif
+#   endif
          (wint_t wc)
 {
   return (wc >= 'A' && wc <= 'Z' ? wc - 'A' + 'a' : wc);
 }
 
 _GL_WCTYPE_INLINE wint_t
-#  if @REPLACE_TOWLOWER@
+#   if @REPLACE_TOWLOWER@
 rpl_towupper
-#  else
+#   else
 towupper
-#  endif
+#   endif
          (wint_t wc)
 {
   return (wc >= 'a' && wc <= 'z' ? wc - 'a' + 'A' : wc);
 }
 
-# elif @GNULIB_ISWBLANK@ && (! @HAVE_ISWBLANK@ || @REPLACE_ISWBLANK@)
-/* Only the iswblank function is missing.  */
+#  endif
 
-#  if @REPLACE_ISWBLANK@
-#   if !(defined __cplusplus && defined GNULIB_NAMESPACE)
-#    define iswblank rpl_iswblank
-#   endif
+# else
+/* Only some of the functions are missing or broken.  */
+
+#  if @GNULIB_ISWBLANK@ && (! @HAVE_ISWBLANK@ || @REPLACE_ISWBLANK@)
+/* Only the iswblank function is missing.  */
+#   if @REPLACE_ISWBLANK@
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     define iswblank rpl_iswblank
+#    endif
 _GL_FUNCDECL_RPL (iswblank, int, (wint_t wc));
-#  else
+#   else
 _GL_FUNCDECL_SYS (iswblank, int, (wint_t wc));
+#   endif
+#  endif
+
+#  if @GNULIB_ISWDIGIT@
+#   if @REPLACE_ISWDIGIT@
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     undef iswdigit
+#     define iswdigit rpl_iswdigit
+#    endif
+_GL_FUNCDECL_RPL (iswdigit, int, (wint_t wc));
+#   endif
+#  endif
+
+#  if @GNULIB_ISWXDIGIT@
+#   if @REPLACE_ISWXDIGIT@
+#    if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#     undef iswxdigit
+#     define iswxdigit rpl_iswxdigit
+#    endif
+_GL_FUNCDECL_RPL (iswxdigit, int, (wint_t wc));
+#   endif
 #  endif
 
 # endif
 
-# if defined __MINGW32__
+# if defined __MINGW32__ && !@GNULIBHEADERS_OVERRIDE_WINT_T@
 
 /* On native Windows, wchar_t is uint16_t, and wint_t is uint32_t.
    The functions towlower and towupper are implemented in the MSVCRT library
@@ -387,36 +529,71 @@
 #   define towupper rpl_towupper
 #  endif
 
-# endif /* __MINGW32__ */
+# endif /* __MINGW32__ && !@GNULIBHEADERS_OVERRIDE_WINT_T@ */
 
 # define GNULIB_defined_wctype_functions 1
 #endif
 
 #if @REPLACE_ISWCNTRL@
 _GL_CXXALIAS_RPL (iswalnum, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswalpha, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswcntrl, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswdigit, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswgraph, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswlower, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswprint, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswpunct, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswspace, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswupper, int, (wint_t wc));
-_GL_CXXALIAS_RPL (iswxdigit, int, (wint_t wc));
 #else
 _GL_CXXALIAS_SYS (iswalnum, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswalpha, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswalpha, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswcntrl, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswcntrl, int, (wint_t wc));
+#endif
+#if @GNULIB_ISWDIGIT@
+# if @REPLACE_ISWDIGIT@
+_GL_CXXALIAS_RPL (iswdigit, int, (wint_t wc));
+# else
 _GL_CXXALIAS_SYS (iswdigit, int, (wint_t wc));
+# endif
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswgraph, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswgraph, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswlower, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswlower, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswprint, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswprint, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswpunct, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswpunct, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswspace, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswspace, int, (wint_t wc));
+#endif
+#if @REPLACE_ISWCNTRL@
+_GL_CXXALIAS_RPL (iswupper, int, (wint_t wc));
+#else
 _GL_CXXALIAS_SYS (iswupper, int, (wint_t wc));
+#endif
+#if @GNULIB_ISWXDIGIT@
+# if @REPLACE_ISWXDIGIT@
+_GL_CXXALIAS_RPL (iswxdigit, int, (wint_t wc));
+# else
 _GL_CXXALIAS_SYS (iswxdigit, int, (wint_t wc));
+# endif
 #endif
+#if __GLIBC__ >= 2
 _GL_CXXALIASWARN (iswalnum);
 _GL_CXXALIASWARN (iswalpha);
 _GL_CXXALIASWARN (iswcntrl);
@@ -428,6 +605,7 @@
 _GL_CXXALIASWARN (iswspace);
 _GL_CXXALIASWARN (iswupper);
 _GL_CXXALIASWARN (iswxdigit);
+#endif
 
 #if @GNULIB_ISWBLANK@
 # if @REPLACE_ISWCNTRL@ || @REPLACE_ISWBLANK@
@@ -435,7 +613,9 @@
 # else
 _GL_CXXALIAS_SYS (iswblank, int, (wint_t wc));
 # endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (iswblank);
+# endif
 #endif
 
 #if !@HAVE_WCTYPE_T@
@@ -451,7 +631,9 @@
 _GL_FUNCDECL_SYS (wctype, wctype_t, (const char *name));
 # endif
 _GL_CXXALIAS_SYS (wctype, wctype_t, (const char *name));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wctype);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wctype
 # if HAVE_RAW_DECL_WCTYPE
@@ -464,11 +646,22 @@
    The argument WC must be either a wchar_t value or WEOF.
    The argument DESC must have been returned by the wctype() function.  */
 #if @GNULIB_ISWCTYPE@
-# if !@HAVE_WCTYPE_T@
+# if @GNULIBHEADERS_OVERRIDE_WINT_T@
+#  if !(defined __cplusplus && defined GNULIB_NAMESPACE)
+#   undef iswctype
+#   define iswctype rpl_iswctype
+#  endif
+_GL_FUNCDECL_RPL (iswctype, int, (wint_t wc, wctype_t desc));
+_GL_CXXALIAS_RPL (iswctype, int, (wint_t wc, wctype_t desc));
+# else
+#  if !@HAVE_WCTYPE_T@
 _GL_FUNCDECL_SYS (iswctype, int, (wint_t wc, wctype_t desc));
-# endif
+#  endif
 _GL_CXXALIAS_SYS (iswctype, int, (wint_t wc, wctype_t desc));
+# endif
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (iswctype);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef iswctype
 # if HAVE_RAW_DECL_ISWCTYPE
@@ -484,8 +677,10 @@
 _GL_CXXALIAS_SYS (towlower, wint_t, (wint_t wc));
 _GL_CXXALIAS_SYS (towupper, wint_t, (wint_t wc));
 #endif
+#if __GLIBC__ >= 2
 _GL_CXXALIASWARN (towlower);
 _GL_CXXALIASWARN (towupper);
+#endif
 
 #if !@HAVE_WCTRANS_T@
 # if !GNULIB_defined_wctrans_t
@@ -500,7 +695,9 @@
 _GL_FUNCDECL_SYS (wctrans, wctrans_t, (const char *name));
 # endif
 _GL_CXXALIAS_SYS (wctrans, wctrans_t, (const char *name));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (wctrans);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef wctrans
 # if HAVE_RAW_DECL_WCTRANS
@@ -517,7 +714,9 @@
 _GL_FUNCDECL_SYS (towctrans, wint_t, (wint_t wc, wctrans_t desc));
 # endif
 _GL_CXXALIAS_SYS (towctrans, wint_t, (wint_t wc, wctrans_t desc));
+# if __GLIBC__ >= 2
 _GL_CXXALIASWARN (towctrans);
+# endif
 #elif defined GNULIB_POSIXCHECK
 # undef towctrans
 # if HAVE_RAW_DECL_TOWCTRANS

_service:tar_scm:groff-1.22.4.tar.gz/lib/wcwidth.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/wcwidth.c Changed

@@ -1,17 +1,17 @@
 /* Determine the number of screen columns needed for a character.
-   Copyright (C) 2006-2007, 2010-2018 Free Software Foundation, Inc.
+   Copyright (C) 2006-2007, 2010-2023 Free Software Foundation, Inc.
 
-   This program 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
-   (at your option) any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
+   You should have received a copy of the GNU Lesser General Public License
    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #include <config.h>
@@ -34,7 +34,7 @@
   return STREQ_OPT (encoding, "UTF-8", 'U', 'T', 'F', '-', '8', 0, 0, 0, 0);
 }
 
-#if GNULIB_WCHAR_SINGLE
+#if GNULIB_WCHAR_SINGLE_LOCALE
 /* When we know that the locale does not change, provide a speedup by
    caching the value of is_locale_utf8.  */
 static int cached_is_locale_utf8 = -1;

_service:tar_scm:groff-1.22.4.tar.gz/lib/xsize.c -> _service:tar_scm:groff-1.23.0.tar.gz/lib/xsize.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/lib/xsize.h -> _service:tar_scm:groff-1.23.0.tar.gz/lib/xsize.h Changed

@@ -1,19 +1,19 @@
 /* xsize.h -- Checked size_t computations.
 
-   Copyright (C) 2003, 2008-2018 Free Software Foundation, Inc.
+   Copyright (C) 2003, 2008-2023 Free Software Foundation, Inc.
 
-   This program 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, or (at your option)
-   any later version.
+   This file is free software: you can redistribute it and/or modify
+   it under the terms of the GNU Lesser General Public License as
+   published by the Free Software Foundation; either version 2.1 of the
+   License, or (at your option) any later version.
 
-   This program is distributed in the hope that it will be useful,
+   This file 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.
+   GNU Lesser General Public License for more details.
 
-   You should have received a copy of the GNU General Public License
-   along with this program; if not, see <https://www.gnu.org/licenses/>.  */
+   You should have received a copy of the GNU Lesser General Public License
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 #ifndef _XSIZE_H
 #define _XSIZE_H
@@ -27,6 +27,9 @@
 # include <stdint.h>
 #endif
 
+/* Get ATTRIBUTE_PURE.  */
+#include "attribute.h"
+
 #ifndef _GL_INLINE_HEADER_BEGIN
  #error "Please include config.h first."
 #endif
@@ -56,10 +59,7 @@
   ((N) <= SIZE_MAX ? (size_t) (N) : SIZE_MAX)
 
 /* Sum of two sizes, with overflow check.  */
-XSIZE_INLINE size_t
-#if __GNUC__ >= 3
-__attribute__ ((__pure__))
-#endif
+XSIZE_INLINE size_t ATTRIBUTE_PURE
 xsum (size_t size1, size_t size2)
 {
   size_t sum = size1 + size2;
@@ -67,30 +67,21 @@
 }
 
 /* Sum of three sizes, with overflow check.  */
-XSIZE_INLINE size_t
-#if __GNUC__ >= 3
-__attribute__ ((__pure__))
-#endif
+XSIZE_INLINE size_t ATTRIBUTE_PURE
 xsum3 (size_t size1, size_t size2, size_t size3)
 {
   return xsum (xsum (size1, size2), size3);
 }
 
 /* Sum of four sizes, with overflow check.  */
-XSIZE_INLINE size_t
-#if __GNUC__ >= 3
-__attribute__ ((__pure__))
-#endif
+XSIZE_INLINE size_t ATTRIBUTE_PURE
 xsum4 (size_t size1, size_t size2, size_t size3, size_t size4)
 {
   return xsum (xsum (xsum (size1, size2), size3), size4);
 }
 
 /* Maximum of two sizes, with overflow check.  */
-XSIZE_INLINE size_t
-#if __GNUC__ >= 3
-__attribute__ ((__pure__))
-#endif
+XSIZE_INLINE size_t ATTRIBUTE_PURE
 xmax (size_t size1, size_t size2)
 {
   /* No explicit check is needed here, because for any n:

_service:tar_scm:groff-1.22.4.tar.gz/m4/groff.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/m4/groff.m4 Changed

@@ -1,5 +1,5 @@
 # Autoconf macros for groff.
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+# Copyright (C) 1989-2023 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -8,416 +8,495 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
-AC_DEFUN(GROFF_PRINT,
-  if test -z "$PSPRINT"; then
-     AC_CHECK_PROGS(LPR, lpr)
-     AC_CHECK_PROGS(LP, lp)
-     if test -n "$LPR" && test -n "$LP"; then
-       # HP-UX provides an lpr command that emulates lpr using lp,
-       # but it doesn't have lpq; in this case we want to use lp
-       # rather than lpr.
-       AC_CHECK_PROGS(LPQ, lpq)
-       test -n "$LPQ" || LPR=
-     fi
-     if test -n "$LPR"; then
-       PSPRINT="$LPR"
-     elif test -n "$LP"; then
-       PSPRINT="$LP"
-     fi
-   fi
-   AC_SUBST(PSPRINT)
-   AC_MSG_CHECKING(for command to use for printing PostScript files)
-   AC_MSG_RESULT($PSPRINT)
-
-   # Figure out DVIPRINT from PSPRINT.
-   AC_MSG_CHECKING(for command to use for printing dvi files)
-   if test -n "$PSPRINT" && test -z "$DVIPRINT"; then
-     if test "x$PSPRINT" = "xlpr"; then
-       DVIPRINT="lpr -d"
-     else
-       DVIPRINT="$PSPRINT"
-     fi
-   fi
-   AC_SUBST(DVIPRINT)
-   AC_MSG_RESULT($DVIPRINT))
+# Locate a print spooler for certain output formats.
+
+AC_DEFUN(GROFF_PRINT, 
+  groff_have_spooler=no
+  if test -z "$PSPRINT"
+  then
+    AC_CHECK_PROGS(LPR, lpr)
+    AC_CHECK_PROGS(LP, lp)
+    if test -n "$LPR" && test -n "$LP"
+     then
+      # HP-UX provides an lpr command that emulates lpr using lp,
+      # but it doesn't have lpq; in this case we want to use lp
+      # rather than lpr.
+      AC_CHECK_PROGS(LPQ, lpq)
+      test -n "$LPQ" || LPR=
+    fi
+    if test -n "$LPR"
+    then
+      PSPRINT="$LPR"
+    elif test -n "$LP"
+    then
+      PSPRINT="$LP"
+    fi
+  fi
 
+  if test -n "$PSPRINT"
+  then
+    groff_have_spooler="$PSPRINT"
+    AC_SUBST(PSPRINT)
+    # Figure out DVIPRINT from PSPRINT.
+    AC_MSG_CHECKING(option to use when spooling DVI files)
+    spooler_option=none
+    if test -n "$PSPRINT" && test -z "$DVIPRINT"
+    then
+      if test "$PSPRINT" = lpr
+      then
+        spooler_option=-d
+        DVIPRINT="$PSPRINT $spooler_option"
+      else
+        DVIPRINT="$PSPRINT"
+      fi
+    fi
+    AC_SUBST(DVIPRINT)
+    AC_MSG_RESULT($spooler_option)
+  fi
+)
+
+# Bison-generated parsers have problems with C++ compilers other than
+# g++.  Thus, byacc is preferred over bison.  If no yacc program is
+# available, we issue an error only if not building from a distribution
+# archive, because files generated by a yacc are already present there.
+
+AC_DEFUN(GROFF_PROG_YACC, 
+  AC_CHECK_PROGS(YACC, byacc 'bison -y' yacc, missing)
+  if ! test -f "$srcdir"/.tarball-version
+  then
+    if test "$YACC" = missing
+    then
+      AC_MSG_ERROR(could not find 'byacc', 'bison', or 'yacc', 1)
+    fi
+  fi
+)
 
-# Bison generated parsers have problems with C++ compilers other than
-# g++.  So byacc is preferred over bison.  If no 'yacc' program is
-# available, we issue an error only if building from the source as in
-# distributed tarball files generated by 'yacc' are already present.
+# We need Perl 5.6.1 or newer.
 
-AC_DEFUN(GROFF_PROG_YACC,
-  AC_CHECK_PROGS(YACC, byacc 'bison -y' yacc, missing)
-  if test "x$YACC" = "xmissing" -a -d ${srcdir}/.git; then
-    AC_MSG_ERROR(Could not find 'yacc' or 'bison', 1)
+AC_DEFUN(GROFF_PERL, 
+  PERLVERSION=v5.6.1
+  AC_PATH_PROG(PERL, perl, no)
+  if test "$PERL" = no
+  then
+    AC_MSG_ERROR(perl binary not found, 1)
   fi
-  )
+  AX_PROG_PERL_VERSION($PERLVERSION, true,
+    AC_MSG_ERROR(perl version is too old, 1))
+)
 
+# We need m4 to generate some man pages.
 
-# We need Perl 5.6.1 or newer.
+AC_DEFUN(GROFF_PROG_M4, 
+  AC_CHECK_PROGS(M4, m4, missing)
+  if test "$M4" = missing
+  then
+    AC_MSG_ERROR(could not find 'm4', 1)
+  fi
+)
 
-AC_DEFUN(GROFF_PERL,
-  PERLVERSION=v5.6.1
-   AC_PATH_PROG(PERL, perl, no)
-   if test "x$PERL" = "xno"; then
-     AC_MSG_ERROR(perl binary not found, 1)
-   fi
-   AX_PROG_PERL_VERSION($PERLVERSION, true, \
-     AC_MSG_ERROR(perl version is too old, 1)))
-
-
-# It is possible to fine-tune generation of documentation.
-
-AC_DEFUN(GROFF_DOC_CHECK,
-  AC_ARG_WITH(doc,
-    AS_HELP_STRING(--with-doc=TYPE,
-      choose which manuals (beside man pages) are desirable. \
-       TYPE can be 'yes' or 'no', or a comma-separated list of \
-       one or multiple of 'html', 'info', 'other', 'pdf', and \
-       'examples', to restrict what is produced),
-    doc="$withval",
-    doc=yes)
-  test "x$doc" = xno && doc=''
-  if test "x$doc" = xyes; then
-    doc_dist_target_ok=yes
-    docadd_html=yes
-    docadd_info=yes
-    docadd_other=yes
-    docadd_pdf=yes
-    docadd_examples=yes
+# We need makeinfo from Texinfo 5.0 or newer, for @codequoteundirected.
+# The minor version checking logic is present for future needs.
+
+AC_DEFUN(GROFF_PROG_MAKEINFO, 
+  # By default automake will set MAKEINFO to MAKEINFO = ${SHELL} <top
+  # src dir>/build-aux/missing makeinfo.  As we need a more precise
+  # check of makeinfo version, we don't use it.
+  MAKEINFO=
+  missing=
+  AC_CHECK_PROG(MAKEINFO, makeinfo, makeinfo)
+  if test -z "$MAKEINFO"
+  then
+    missing="missing 'makeinfo'"
   else
-    # Don't use case/esac, verify input.
-    doc_dist_target_ok=no
-    docadd_html=no
-    docadd_info=no
-    docadd_other=no
-    docadd_pdf=no
-    docadd_examples=no
-    OFS=$IFS
-    IFS=','
-    set -- $doc
-    IFS=$OFS
-    for i
-    do
-      test "x$i" = xhtml     && { docadd_html=yes; continue; }
-      test "x$i" = xinfo     && { docadd_info=yes; continue; }
-      test "x$i" = xother    && { docadd_other=yes; continue; }
-      test "x$i" = xpdf      && { docadd_pdf=yes; continue; }
-      test "x$i" = xexamples && { docadd_examples=yes; continue; }
-      AC_MSG_WARN(Invalid '--with-doc' argument: $i)
-    done
+    AC_MSG_CHECKING(for makeinfo version)
+    # We need an additional level of quoting to make sed's regexps
+    # work.
+    makeinfo_version=`$MAKEINFO --version 2>&1 \
+     | sed -e 's/^.* $^ ^ *$$/\1/' -e '1q'`
+    AC_MSG_RESULT($makeinfo_version)
+    # Consider only the first two numbers in version number string.
+    makeinfo_version_major=`IFS=.; set x $makeinfo_version; echo ${2}`
+    makeinfo_version_minor=`IFS=.; set x $makeinfo_version; echo ${3}`
+    makeinfo_version_numeric=`
+      expr ${makeinfo_version_major}000 + $makeinfo_version_minor`
+    if test $makeinfo_version_numeric -lt 5000
+    then
+      missing="'makeinfo' is too old."
+      MAKEINFO=
+    fi
   fi
-  if test $docadd_html = yes; then
-    make_install_shipped_htmldoc=install_shipped_htmldoc
-    make_uninstall_shipped_htmldoc=uninstall_shipped_htmldoc
-  else
-    make_install_shipped_htmldoc=
-    make_uninstall_shipped_htmldoc=
+
+  if test -n "$missing"
+  then
+    infofile=doc/groff.info
+    test -f $infofile || infofile="$srcdir"/$infofile
+    if test ! -f $infofile \
+     || test "$srcdir"/doc/groff.texi -nt $infofile
+    then
+      AC_MSG_ERROR($missing
+Get the 'texinfo' package version 5.0 or newer.)
+    fi
   fi
-  if test $docadd_other = yes; then
-    make_otherdoc=otherdoc
-    make_install_otherdoc=install_otherdoc
-    make_uninstall_otherdoc=uninstall_otherdoc
-  else
-    make_otherdoc=
-    make_install_otherdoc=
-    make_uninstall_otherdoc=
+  AC_SUBST(MAKEINFO)
+)
+
+# 'makeinfo' and 'texi2dvi' are distributed together, so if the former
+# is too old, the latter is too.
+
+AC_DEFUN(GROFF_PROG_TEXI2DVI, 
+  AC_REQUIRE(GROFF_PROG_MAKEINFO)
+  AC_CHECK_PROG(PROG_TEXI2DVI, texi2dvi, texi2dvi, missing)
+  groff_have_texi2dvi=no
+  if test "$PROG_TEXI2DVI" != missing && test -n "$MAKEINFO"
+  then
+    groff_have_texi2dvi=yes
   fi
-  if test $docadd_examples = yes; then
-    make_examples=examples
-    make_install_examples=install_examples
-    make_uninstall_examples=uninstall_examples
+)
+
+# 'texi2dvi' can be installed without TeX itself, so check for a 'tex'
+# executable independently.
+
+AC_DEFUN(GROFF_USE_TEX_CHECK, 
+  AC_REQUIRE(GROFF_PROG_TEXI2DVI)
+  AC_CHECK_PROG(PROG_TEX, tex, found, missing)
+  groff_use_tex=no
+  test "$PROG_TEX" = found && groff_use_tex=yes
+)
+
+# grohtml needs the following programs to produce images from tbl(1)
+# tables and eqn(1) equations.
+
+dnl Any macro that tests $make_htmldoc should AC_REQUIRE this.
+
+AC_DEFUN(GROFF_CHECK_GROHTML_PROGRAMS, 
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
+
+  make_htmldoc=no
+  missing=
+  m4_foreach(groff_prog,
+dnl Keep this list of programs in sync with grohtml test scripts.
+    pnmcrop, pnmcut, pnmtopng, pnmtops, psselect, 
+      AC_CHECK_PROG(groff_prog, groff_prog, found, missing)
+      if test $groff_prog = missing
+      then
+        missing="$missing 'groff_prog'"
+      fi
+    )
+
+  test "$GHOSTSCRIPT" = "missing" && missing="'gs' $missing"
+
+  if test -z "$missing"
+  then
+      make_htmldoc=yes
   else
-    make_examples=
-    make_install_examples=
-    make_uninstall_examples=
+    plural=`set $missing; test $# -gt 1 && echo s`
+    oxford=`set $missing; test $# -gt 2 && echo ,`
+    missing=`set $missing
+      missing=
+      while test $# -gt 0
+      do
+        case $# in
+          1) missing="$missing$1" ;;
+          2) missing="$missing$1$oxford and " ;;
+          *) missing="$missing$1, " ;;
+        esac
+        shift
+      done
+      echo $missing`
+    verb=`set $missing
+      if test $# -gt 1
+      then
+        echo were
+      else
+        echo was
+      fi`
+
+    grohtml_notice="The program$plural $missing $verb not found in \
+\$PATH.
+
+  Consequently, groff's HTML output driver, 'grohtml', will not work
+  properly.  It will not be possible to prepare or install
+  groff-generated documentation in HTML format.
+"
+   fi
+   AC_SUBST(make_htmldoc)
+)
+
+
+AC_DEFUN(GROFF_GROHTML_PROGRAM_NOTICE, 
+  AC_REQUIRE(GROFF_CHECK_GROHTML_PROGRAMS)
+
+  if test "$make_htmldoc" = no
+  then
+    AC_MSG_NOTICE($grohtml_notice)
   fi
-  AC_SUBST(doc_dist_target_ok)
-  AC_SUBST(make_install_shipped_htmldoc)
-  AC_SUBST(make_uninstall_shipped_htmldoc)
-  AC_SUBST(make_otherdoc)
-  AC_SUBST(make_install_otherdoc)
-  AC_SUBST(make_uninstall_otherdoc)
-  AC_SUBST(make_examples)
-  AC_SUBST(make_install_examples)
-  AC_SUBST(make_uninstall_examples))
+)
 
+dnl pdfroff uses awk, and we use it in GROFF_URW_FONTS_CHECK.
 
-# We need makeinfo 4.8 or newer.
+AC_DEFUN(GROFF_AWK_NOTICE, 
+  AC_REQUIRE(GROFF_AWK_PATH)
 
-AC_DEFUN(GROFF_MAKEINFO,
-  # By default automake will set MAKEINFO to MAKEINFO = ${SHELL} <top
-  # src dir>/build-aux/missing makeinfo.As we need a more precise
-  # check of makeinfo version, we don't use it.
-  MAKEINFO=
-   if test $docadd_info = yes; then
-     missing=
-     AC_CHECK_PROG(MAKEINFO, makeinfo, makeinfo)
-     if test -z "$MAKEINFO"; then
-       missing="'makeinfo' is missing."
-     else
-       AC_MSG_CHECKING(for makeinfo version)
-       # We need an additional level of quoting to make sed's regexps work.
-       makeinfo_version=`$MAKEINFO --version 2>&1 \
-        | sed -e 's/^.* $^ ^ *$$/\1/' -e '1q'`
-       AC_MSG_RESULT($makeinfo_version)
-       # Consider only the first two numbers in version number string.
-       makeinfo_version_major=`IFS=.; set x $makeinfo_version; echo 0${2}`
-       makeinfo_version_minor=`IFS=.; set x $makeinfo_version; echo 0${3}`
-       makeinfo_version_numeric=`
-         expr ${makeinfo_version_major}000 \+ ${makeinfo_version_minor}`
-       if test $makeinfo_version_numeric -lt 4008; then
-         missing="'makeinfo' is too old."
-       fi
-     fi
+  awk_names=awk
+  if test -n "$ALT_AWK_PROGS"
+  then
+    awk_names="$ALT_AWK_PROGS"
+  fi
 
-     if test -n "$missing"; then
-       infofile=doc/groff.info
-       test -f ${infofile} || infofile=${srcdir}/${infofile}
-       if test ! -f ${infofile} \
-	|| test ${srcdir}/doc/groff.texi -nt ${infofile}; then
-	 AC_MSG_ERROR($missing
-Get the 'texinfo' package version 4.8 or newer.)
-       else
-	 AC_MSG_WARN($missing
-Get the 'texinfo' package version 4.8 or newer if you want to convert
-'groff.texi' into a PDF or HTML document.)
-       fi
-     fi
+  if test "$AWK" = missing
+  then
+    AC_MSG_NOTICE(No awk program was found in \$PATH.
 
-     make_infodoc=infodoc
-     make_install_infodoc=install_infodoc
-     make_uninstall_infodoc=uninstall_infodoc
-   else
-     make_infodoc=
-     make_install_infodoc=
-     make_uninstall_infodoc=
-     MAKEINFO=
-   fi
-   AC_SUBST(MAKEINFO)
-   AC_SUBST(make_infodoc)
-   AC_SUBST(make_install_infodoc)
-   AC_SUBST(make_uninstall_infodoc)
-   AC_SUBST(makeinfo_version_numeric))
-
-AC_DEFUN(GROFF_TEXI2DVI,
-  AC_CHECK_PROG(PROG_TEXI2DVI, texi2dvi, found, missing)
-   if test "x$PROG_TEXI2DVI" = "xfound"; then
-      groff_have_texi2dvi=yes;
-   else
-      groff_have_texi2dvi=no;
-   fi
-   )
-
-# The following programs are needed for grohtml.
-
-AC_DEFUN(GROFF_HTML_PROGRAMS,
-  make_htmldoc=
-   make_install_htmldoc=
-   make_uninstall_htmldoc=
-   make_htmlexamples=
-   make_install_htmlexamples=
-   make_uninstall_htmlexamples=
-   AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
-
-   missing=
-   AC_FOREACH(groff_prog,
-     pnmcut pnmcrop pnmtopng psselect pnmtops,
-     AC_CHECK_PROG(groff_prog, groff_prog, found, missing)
-      if test $groff_prog = missing; then
-	missing="$missing 'groff_prog'"
-      fi;)
-
-   test "$GHOSTSCRIPT" = "missing" && missing="$missing 'gs'"
-
-   if test -z "$missing"; then
-     if test $docadd_html = yes; then
-       make_htmldoc=htmldoc
-       make_install_htmldoc=install_htmldoc
-       make_uninstall_htmldoc=uninstall_htmldoc
-       if test $docadd_examples = yes; then
-         make_htmlexamples=html_examples
-         make_install_htmlexamples=install_htmlexamples
-         make_uninstall_htmlexamples=uninstall_htmlexamples
-       fi
-     fi
-   else
-     plural=`set $missing; test $# -gt 1 && echo s`
-     missing=`set $missing
-       missing=""
-       while test $# -gt 0
-	 do
-	   case $# in
-	     1) missing="$missing$1" ;;
-	     2) missing="$missing$1 and " ;;
-	     *) missing="$missing$1, " ;;
-	   esac
-	   shift
-	 done
-	 echo $missing`
-
-     docnote=.
-     test $docadd_html = yes && docnote=';
-  therefore, it will neither be possible to prepare, nor to install,
-  documentation in HTML format.'
-
-     AC_MSG_WARN(missing program$plural:
-
-  The program$plural
-     $missing
-  cannot be found in the PATH.
-  Consequently, groff's HTML backend (grohtml) will not work properly$docnote
-     )
-     doc_dist_target_ok=no
-   fi
-   AC_SUBST(make_htmldoc)
-   AC_SUBST(make_install_htmldoc)
-   AC_SUBST(make_uninstall_htmldoc)
-   AC_SUBST(make_htmlexamples)
-   AC_SUBST(make_install_htmlexamples)
-   AC_SUBST(make_uninstall_htmlexamples))
-
-
-# To produce PDF docs, we need both awk and ghostscript.
-
-AC_DEFUN(GROFF_PDFDOC_PROGRAMS,
-  make_pdfdoc=
-   make_install_pdfdoc=
-   make_uninstall_pdfdoc=
-   make_pdfexamples=
-   make_install_pdfexamples=
-   make_uninstall_pdfexamples=
-   AC_REQUIRE(GROFF_AWK_PATH)
-   AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
-
-   missing=""
-   test "$AWK" = missing && missing="'awk'"
-   test "$GHOSTSCRIPT" = missing && missing="$missing 'gs'"
-   if test -z "$missing"; then
-     if test $docadd_pdf = yes; then
-       make_pdfdoc=pdfdoc
-       make_install_pdfdoc=install_pdfdoc
-       make_uninstall_pdfdoc=uninstall_pdfdoc
-       if test $docadd_examples = yes; then
-         make_pdfexamples=pdfexamples
-         make_install_pdfexamples=install_pdfexamples
-         make_uninstall_pdfexamples=uninstall_pdfexamples
-       fi
-     fi
-   else
-     plural=`set $missing; test $# -eq 2 && echo s`
-     test x$plural = xs \
-       && missing=`set $missing; echo "$1 and $2"` \
-       || missing=`echo $missing`
-
-     docnote=.
-     test $docadd_pdf = yes && docnote=';
-  therefore, it will neither be possible to prepare, nor to install,
-  documentation and most of the examples in PDF format.'
-
-     AC_MSG_WARN(missing program$plural:
-
-  The program$plural $missing cannot be found in the PATH.
-  Consequently, groff's PDF formatter (pdfroff) will not work properly$docnote
-     )
-     doc_dist_target_ok=no
-   fi
-   AC_SUBST(make_pdfdoc)
-   AC_SUBST(make_install_pdfdoc)
-   AC_SUBST(make_uninstall_pdfdoc)
-   AC_SUBST(make_pdfexamples)
-   AC_SUBST(make_install_pdfexamples)
-   AC_SUBST(make_uninstall_pdfexamples))
-
-# Option to configure path to URW fonts
-AC_DEFUN(GROFF_URW_FONTS_PATH,
-   AC_ARG_WITH(urw-fonts-dir,
-     AS_HELP_STRING(--with-urw-fonts-dir=DIR,
-       Search for URW fonts in this directory),
-     urwfontsdir="$withval")
-   AC_SUBST(urwfontsdir))
-
-# Check if URW fonts are available, either in the paths given by `gs
-# -h', in /usr/share/fonts/type1/gsfonts/ ,
-# /opt/local/share/fonts/urw-fonts (where font/devpdf/Foundry.in
-# expect them), or in the custom path passed to configure.
-AC_DEFUN(GROFF_URW_FONTS,
-  AC_MSG_CHECKING(whether URW fonts in pfb format are available)
-   AC_REQUIRE(GROFF_AWK_PATH)
-   AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
-   groff_have_urw_fonts=no
-   if test "$AWK" = "missing" -o "$GHOSTSCRIPT" = "missing"; then
-     AC_MSG_WARN(awk and gs are required, can't look for URW fonts)
-   else
-     _list_paths=`$GHOSTSCRIPT -h | $AWK 'BEGIN { found = 0 } /Search path:/ { found = 1 } /^ *\// { print $'0' }'| tr : ' '`
-     _list_paths="$_list_paths /usr/share/fonts/type1/gsfonts/ \
-               /opt/local/share/fonts/urw-fonts/"
-     if test -n "$urwfontsdir"; then
-       _list_paths="$ _list_paths $urwfontsdir"
-     fi
-     for k in $_list_paths; do
-       if test -f $k/a010013l.pfb; then
-         AC_MSG_RESULT(found in $k)
-         groff_have_urw_fonts=yes
-         break
-       fi
-     done
-   fi
-   if test $groff_have_urw_fonts = no; then
-     AC_MSG_RESULT(no)
-   fi
-   AC_SUBST(groff_have_urw_fonts)
-   )
-
-# Warning if URW fonts were not found
-AC_DEFUN(GROFF_URW_FONTS_CHECK,
-  if test "$groff_have_urw_fonts" = no; then
-  AC_MSG_NOTICE(
-  No URW fonts in .pfb format were found on your system, URW fonts
-  generation for 'devpdf' will not work properly.  These fonts can be
-  downloaded here:
-
-    http://downloads.ghostscript.com/public/fonts/urw-base35-v1.10.zip
-
-  By default groff will search these fonts in the paths given by `gs
-  -h' and in these 2 default directories:
-  '/usr/share/fonts/type1/gsfonts/' and
-  '/opt/local/share/fonts/urw-fonts/' (paths used by
-  font/devpdf/Foundry.in).  You can also pass the option
-  '--with-urw-fonts-dir=DIR' to 'configure' to set a custom path.  You
-  would need to re-run the 'configure' script after installing these
-  fonts.
-  
-  )
+  It was sought under the name(s) "$awk_names".
+    )
   fi
-  )
+)
 
+AC_DEFUN(GROFF_PDFROFF_DEPENDENCIES_CHECK, 
+  AC_REQUIRE(GROFF_AWK_PATH)
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
 
-# Check whether pnmtops can handle the -nosetpage option.
+  use_pdfroff=no
+  pdfroff_missing_deps=
 
-AC_DEFUN(GROFF_PNMTOPS_NOSETPAGE,
-  AC_MSG_CHECKING(whether pnmtops can handle the -nosetpage option)
-   if echo P2 2 2 255 0 1 2 0 | pnmtops -nosetpage > /dev/null 2>&1 ; then
-     AC_MSG_RESULT(yes)
-     pnmtops_nosetpage="pnmtops -nosetpage"
-   else
-     AC_MSG_RESULT(no)
-     pnmtops_nosetpage="pnmtops"
-   fi
-   AC_SUBST(pnmtops_nosetpage))
+  test "$AWK" = missing && pdfroff_missing_deps="awk"
+
+  if test "$GHOSTSCRIPT" = missing
+  then
+    verb=is
+
+    if test -n "$pdfroff_missing_deps"
+    then
+      pdfroff_missing_deps="$pdfroff_missing_deps and "
+      verb=are
+    fi
+    pdfroff_missing_deps="${pdfroff_missing_deps}Ghostscript $verb"
+  fi
+
+  if test -z "$pdfroff_missing_deps"
+  then
+    use_pdfroff=yes
+  fi
+
+  AC_SUBST(use_pdfroff)
+)
+
+AC_DEFUN(GROFF_GROPDF_DEPENDENCIES_CHECK, 
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
+  AC_REQUIRE(GROFF_URW_FONTS_CHECK)
+
+  use_gropdf=no
+  gropdf_missing_deps=
+
+  if test "$GHOSTSCRIPT" != missing \
+    || test "$groff_have_urw_fonts" = yes
+  then
+    use_gropdf=yes
+  fi
+
+  AC_SUBST(use_gropdf)
+)
+
+AC_DEFUN(GROFF_PDFROFF_PROGRAM_NOTICE, 
+  AC_REQUIRE(GROFF_PDFROFF_DEPENDENCIES_CHECK)
+
+  if test "$use_pdfroff" = no
+  then
+    AC_MSG_NOTICE('pdfroff' will not be functional.
+
+  Because $pdfroff_missing_deps missing, 'pdfroff' will not operate
+  and the 'pdfmark.pdf' document will not be available.
+)
+  fi
+)
+
+AC_DEFUN(GROFF_GROPDF_PROGRAM_NOTICE, 
+  AC_REQUIRE(GROFF_GROPDF_DEPENDENCIES_CHECK)
+
+  if test "$use_gropdf" = no
+  then
+    AC_MSG_NOTICE('gropdf' will have reduced function.
+
+  Neither Ghostscript nor URW fonts are available; groff documentation
+  thus will not be available in PDF.
+
+  'gropdf' will be able to handle only documents using the standard PDF
+  base 14 fonts, plus the 'EURO' font groff supplies, and font embedding
+  with its '-e' option (accessed via the 'groff' command with the option
+  '-P -e') will not be possible.
+)
+  fi
+)
+
+# Make URW font directory configurable.
+
+AC_DEFUN(GROFF_URW_FONTS_PATH, 
+  AC_ARG_WITH(urw-fonts-dir,
+    AS_HELP_STRING(--with-urw-fonts-dir=DIR,
+      search for URW PostScript Type 1 fonts in DIR),
+    urwfontsdir="$withval")
+)
+
+# Check for availability of URW fonts in the directory specified by the
+# user (see GROFF_URW_FONTS_PATH above).  We do NOT search the path of
+# directories built into Ghostscript because those fonts lack the
+# corresponding AFM files we need to generate groff font description
+# files; see afmtodit(1).  Ghostscript's own fonts are treated as the
+# "default foundry" and we already provide descriptions of them in
+# font/devpdf (along with groff's EURO font).
+
+AC_DEFUN(GROFF_URW_FONTS_CHECK, 
+  AC_REQUIRE(GROFF_URW_FONTS_PATH)
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
+  groff_have_urw_fonts=no
+  AC_MSG_CHECKING(for URW fonts in Type 1/PFB format)
+
+dnl Keep this list in sync with font/devpdf/Foundry.in.
+  _list_paths="\
+    /usr/share/fonts/type1/gsfonts/ \
+    /usr/share/fonts/default/Type1/ \
+    /usr/share/fonts/default/Type1/adobestd35/ \
+    /usr/share/fonts/type1/urw-base35/ \
+    /opt/local/share/fonts/urw-fonts/ \
+    /usr/local/share/fonts/ghostscript/"
+
+  if test -n "$urwfontsdir"
+  then
+    _list_paths="$urwfontsdir"
+  fi
+
+dnl Keep this list of font file names in sync with the corresponding
+dnl entry in font/devpdf/util/BuildFoundries.pl.
+  for k in $_list_paths
+  do
+    for _font_file in \
+      URWGothic-Book \
+      URWGothic-Book.t1 \
+      URWGothic-Book.pfb \
+      URWGothicL-Book.pfb \
+      a010013l.pfb
+    do
+      if test -f $k/$_font_file
+      then
+        AC_MSG_RESULT(found in $k)
+        groff_have_urw_fonts=yes
+        urwfontsdir=$k
+        break 2
+      fi
+    done
+  done
+
+  if test $groff_have_urw_fonts = no
+  then
+    AC_MSG_RESULT(none found)
+    urwfontsdir=
+  fi
+
+  AC_SUBST(groff_have_urw_fonts)
+  AC_SUBST(urwfontsdir)
+)
+
+AC_DEFUN(GROFF_URW_FONTS_NOTICE, 
+  if test "$groff_have_urw_fonts" = no
+  then
+    gs_verbiage=
+    if test "$GHOSTSCRIPT" != missing
+    then
+      gs_verbiage=' as well as the search path shown by the
+  "'"$GHOSTSCRIPT"' -h" command (if available)'
+    fi
+    AC_MSG_NOTICE(URW fonts in Type 1/PFB format were not found.
+
+  groff font description files for the URW fonts, used by the 'gropdf'
+  output driver, will not be available.  Use and embedding of fonts from
+  the 'U' foundry in PDF documents generated by groff will not be
+  possible.
+
+  You can obtain the URW base 35 fonts from their GitHub project.  As of
+  this writing (2023-02-15), you can find them in the 'fonts' directory
+  of the following archives (choose one).
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.zip
+    https://github.com/ArtifexSoftware/urw-base35-fonts/archive/refs/
+      tags/20200910.tar.gz
+
+  You may wish to check for a newer release.
+
+    https://github.com/ArtifexSoftware/urw-base35-fonts/releases
+
+  'gropdf' looks for these fonts in several directories specified in
+  font/devpdf/Foundry.in$gs_verbiage.
+
+  You will need to "make distclean" and re-run the 'configure' script
+  after installing the URW fonts.
+
+  Alternatively, you can pass the option '--with-urw-fonts-dir=DIR'
+  to 'configure' to look for them in the directory DIR you specify.
+  If found, the 'U' foundry will be available via the '-y' option to
+  'gropdf' (accessed via the 'groff' command with the option '-P -y').
+    )
+  fi
+)
+
+
+# Check whether the pnm tools accept the -quiet option.
+
+dnl Any macro that tests $pnmtools_quiet should AC_REQUIRE this.
+
+AC_DEFUN(GROFF_PNMTOOLS_CAN_BE_QUIET, 
+  AC_REQUIRE(GROFF_CHECK_GROHTML_PROGRAMS)
+
+  pnmtools_quiet=
+
+  if test "$make_htmldoc" = yes
+  then
+    AC_MSG_CHECKING(whether PNM tools accept the '-quiet' option)
+    if echo P2 2 2 255 0 1 2 0 | pnmtops -quiet > /dev/null 2>&1
+    then
+      AC_MSG_RESULT(yes)
+      pnmtools_quiet=-quiet
+    else
+      AC_MSG_RESULT(no)
+    fi
+  fi
+  AC_SUBST(pnmtools_quiet)
+)
+
+
+# Check whether pnmtops can handle the -nosetpage option.
+#
+# We require this both for grohtml operation and generation of
+# doc/gnu.eps from repository builds.
+
+AC_DEFUN(GROFF_PNMTOPS_NOSETPAGE, 
+  AC_REQUIRE(GROFF_PNMTOOLS_CAN_BE_QUIET)
+
+  pnmtops_nosetpage="pnmtops $pnmtools_quiet"
+  AC_MSG_CHECKING(whether pnmtops accepts the '-nosetpage' option)
+  if echo P2 2 2 255 0 1 2 0 | pnmtops -nosetpage > /dev/null 2>&1
+  then
+    AC_MSG_RESULT(yes)
+    pnmtops_nosetpage="pnmtops $pnmtools_quiet -nosetpage"
+  else
+    AC_MSG_RESULT(no)
+  fi
+  AC_SUBST(pnmtops_nosetpage)
+)
 
 
 # Check location of 'gs'; allow '--with-gs=PROG' option to override.
 
+dnl Any macro that tests $GHOSTSCRIPT should AC_REQUIRE this.
+
 AC_DEFUN(GROFF_GHOSTSCRIPT_PATH,
   AC_REQUIRE(GROFF_GHOSTSCRIPT_PREFS)
    AC_ARG_WITH(gs,
@@ -425,7 +504,7 @@
        actual /path/name of ghostscript executable),
      GHOSTSCRIPT=$withval,
      AC_CHECK_TOOLS(GHOSTSCRIPT, $ALT_GHOSTSCRIPT_PROGS, missing))
-   test "$GHOSTSCRIPT" = "no" && GHOSTSCRIPT=missing)
+   test "$GHOSTSCRIPT" = no && GHOSTSCRIPT=missing)
 
 # Preferences for choice of 'gs' program...
 # (allow --with-alt-gs="LIST" to override).
@@ -438,6 +517,106 @@
     ALT_GHOSTSCRIPT_PROGS="gs gswin32c gsos2")
    AC_SUBST(ALT_GHOSTSCRIPT_PROGS))
 
+AC_DEFUN(GROFF_GHOSTSCRIPT_AVAILABILITY_NOTICE, 
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
+
+  gs_names=gs
+  if test -n "$ALT_GHOSTSCRIPT_PROGS"
+  then
+    gs_names="$ALT_GHOSTSCRIPT_PROGS"
+  fi
+
+  if test "$GHOSTSCRIPT" = missing
+  then
+    AC_MSG_NOTICE(No Ghostscript program was found in \$PATH.
+
+  It was sought under the name(s) "$gs_names".
+
+  groff documentation will not be available in HTML.
+
+  'grohtml' will have reduced function, being unable to produce
+  documents using the 'tbl' preprocessor.
+    )
+  fi
+)
+
+# Ghostscript version check.  Versions 9.00 <= x < 9.54 suffer from a
+# rendering glitch that affects the AT&T troff (and groff) special
+# character \(lh; see
+#   <https://bugs.ghostscript.com/show_bug.cgi?id=703187>.
+
+AC_DEFUN(GROFF_GHOSTSCRIPT_VERSION_CHECK, 
+  AC_REQUIRE(GROFF_GHOSTSCRIPT_PATH)
+
+  if test "$GHOSTSCRIPT" != missing
+  then
+    AC_MSG_CHECKING(for gs version with good left sidebearing handling)
+    ghostscript_notice=
+    ghostscript_version_good=
+    ghostscript_v_string=`"$GHOSTSCRIPT" -v | sed 1q`
+    # Get first word.
+    ghostscript_words=`echo "$ghostscript_v_string" | cut -d\  -f1-`
+
+    # If the first word is "GPL", discard it.
+    if expr "$ghostscript_words" : "GPL" > /dev/null
+    then
+      ghostscript_words=`echo "$ghostscript_words" | cut -d\  -f2-`
+    fi
+
+    # Only do a version check if the program calls itself Ghostscript.
+    if expr "$ghostscript_words" : "Ghostscript" > /dev/null
+    then
+      ghostscript_version_good=no
+      ghostscript_version=`echo "$ghostscript_words" | cut -d\  -f2`
+      ghostscript_major=`echo "$ghostscript_version" | cut -d. -f1`
+      ghostscript_minor=`echo "$ghostscript_version" | cut -d. -f2`
+
+      if test "$ghostscript_major" -lt 9
+      then
+        ghostscript_version_good=yes
+      elif test "$ghostscript_major" -ge 10
+      then
+        ghostscript_version_good=yes
+      elif test "$ghostscript_minor" -ge 54
+      then
+        ghostscript_version_good=yes
+      fi
+    fi
+
+    if test "$ghostscript_version_good" = yes
+    then
+      ghostscript_version="$ghostscript_version (good)"
+    elif test "$ghostscript_version_good" = no
+    then
+      ghostscript_version="$ghostscript_version (buggy)"
+      ghostscript_notice="Buggy version of Ghostscript detected."
+    else
+      ghostscript_notice="Unable to determine version of Ghostscript."
+    fi
+
+    if test -n "$ghostscript_version"
+    then
+      AC_MSG_RESULT(got $ghostscript_version)
+    else
+      AC_MSG_RESULT(unable to determine)
+    fi
+  fi
+)
+
+AC_DEFUN(GROFF_GHOSTSCRIPT_VERSION_NOTICE, 
+  if test -n "$ghostscript_notice"
+  then
+    AC_MSG_NOTICE($ghostscript_notice
+
+  Ghostscript versions 9.00 <= x < 9.54 suffer from a rendering glitch
+  that affects the AT&T troff (and groff) special character '\(lh'; see
+  <https://bugs.ghostscript.com/show_bug.cgi?id=703187>.  If your
+  version of Ghostscript has not been patched to fix this problem, you
+  may need to work around it in groff documents you render for the
+  PostScript (and, for tbl(1) tables, HTML) output devices.
+  )
+  fi
+)
 
 # Check location of 'awk'; allow '--with-awk=PROG' option to override.
 
@@ -448,7 +627,7 @@
        actual /path/name of awk executable),
      AWK=$withval,
      AC_CHECK_TOOLS(AWK, $ALT_AWK_PROGS, missing))
-   test "$AWK" = "no" && AWK=missing)
+   test "$AWK" = no && AWK=missing)
 
 
 # Preferences for choice of 'awk' program; allow --with-alt-awk="LIST"
@@ -714,7 +893,7 @@
 
 AC_DEFUN(GROFF_ARRAY_DELETE,
   AC_LANG_PUSH(C++)
-   AC_MSG_CHECKING(whether ANSI array delete syntax is supported)
+   AC_MSG_CHECKING(whether ISO C++98 array deletion syntax is supported)
    AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(, 
 
@@ -725,13 +904,12 @@
      ,
      AC_MSG_RESULT(yes),
      AC_MSG_RESULT(no)
-      AC_DEFINE(ARRAY_DELETE_NEEDS_SIZE, 1,
-	Define if your C++ doesn't understand 'delete '.))
+      AC_MSG_ERROR(an ISO C++98-conformant compiler is required))
    AC_LANG_POP(C++))
 
 AC_DEFUN(GROFF_TRADITIONAL_CPP,
   AC_LANG_PUSH(C++)
-   AC_MSG_CHECKING(traditional preprocessor)
+   AC_MSG_CHECKING(whether C preprocessor uses pre-ISO C90 syntax)
    AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
 
@@ -745,8 +923,7 @@
        )
      ,
      AC_MSG_RESULT(yes)
-      AC_DEFINE(TRADITIONAL_CPP, 1,
-	Define if your C++ compiler uses a traditional (Reiser) preprocessor.),
+      AC_MSG_ERROR(an ISO C90-conformant C preprocessor is required),
      AC_MSG_RESULT(no))
    AC_LANG_POP(C++))
 
@@ -785,69 +962,87 @@
 
 AC_DEFUN(GROFF_BROKEN_SPOOLER_FLAGS,
   AC_MSG_CHECKING(default value for grops -b option)
-   test -n "${BROKEN_SPOOLER_FLAGS}" || BROKEN_SPOOLER_FLAGS=0
+   test -n "$BROKEN_SPOOLER_FLAGS" || BROKEN_SPOOLER_FLAGS=0
    AC_MSG_RESULT($BROKEN_SPOOLER_FLAGS)
    AC_SUBST(BROKEN_SPOOLER_FLAGS))
 
 
-AC_DEFUN(GROFF_PAGE,
-  AC_MSG_CHECKING(default paper size)
-   groff_prefix=$prefix
-   test "x$prefix" = "xNONE" && groff_prefix=$ac_default_prefix
-   if test -z "$PAGE" && test -r /etc/papersize; then
-     PAGE=`cat /etc/papersize | sed -e 's/^ *#.*//g' | tr -d "\n" | awk '{ print $1 }'`
-   fi
-   if test -z "$PAGE"; then
-     descfile=
-     if test -r "$groff_prefix"/share/groff/font/devps/DESC; then
-       descfile=$groff_prefix/share/groff/font/devps/DESC
-     elif test -r "$groff_prefix"/lib/groff/font/devps/DESC; then
-       descfile=$groff_prefix/lib/groff/font/devps/DESC
-     else
-       for f in "$groff_prefix"/share/groff/*/font/devps/DESC; do
-	 if test -r "$f"; then
-	   descfile=$f
-	   break
-	 fi
-       done
-     fi
+AC_DEFUN(GROFF_PAGE, 
+  AC_MSG_CHECKING(default paper format)
+  groff_prefix=$prefix
+  test "$prefix" = NONE && groff_prefix=$ac_default_prefix
+  if test -z "$PAGE" && test -r /etc/papersize
+  then
+    sedexpr='s/#.*//;s/ \t\+/ /;s/ \+$//;s/^ \+//;/^$/d;p'
+    PAGE=`sed -n "$sedexpr" /etc/papersize`
+  fi
+  if test -z "$PAGE"
+  then
+    descfile=
+    if test -r "$groff_prefix"/share/groff/font/devps/DESC
+    then
+      descfile=$groff_prefix/share/groff/font/devps/DESC
+    elif test -r "$groff_prefix"/lib/groff/font/devps/DESC
+    then
+      descfile=$groff_prefix/lib/groff/font/devps/DESC
+    else
+      for f in "$groff_prefix"/share/groff/*/font/devps/DESC
+      do
+	if test -r "$f"
+	then
+	  descfile=$f
+	  break
+	fi
+      done
+    fi
 
-     if test -n "$descfile"; then
-       if grep '^paperlength	 \+841890' "$descfile" >/dev/null 2>&1; then
-	 PAGE=A4
-       elif grep '^papersize	 \+aA4' "$descfile" >/dev/null 2>&1; then
-	 PAGE=A4
-       fi
-     fi
-   fi
+    if test -n "$descfile"
+    then
+      if grep -q '^paperlength	 \+841890' "$descfile"
+      then
+	PAGE=A4
+      elif grep -q '^papersize	 \+aA4' "$descfile"
+      then
+	PAGE=A4
+      fi
+    fi
+  fi
 
-   if test -z "$PAGE"; then
-     dom=`awk '($1 == "dom" || $1 == "search") { print $2; exit}' \
-	 /etc/resolv.conf 2>/dev/null`
-     if test -z "$dom"; then
-       dom=`(domainname) 2>/dev/null | tr -d '+'`
-       if test -z "$dom" \
-	  || test "$dom" = '(none)'; then
-	 dom=`(hostname) 2>/dev/null | grep '\.'`
-       fi
-     fi
-     # If the top-level domain is two letters and it's not 'us' or 'ca'
-     # then they probably use A4 paper.
-     case "$dom" in
-     *.UuSs|*.CcAa)
-       ;;
-     *.A-Za-zA-Za-z)
-       PAGE=A4 ;;
-     esac
-   fi
+  if test -z "$PAGE"
+  then
+    domains=
+    if test -r /etc/resolv.conf
+    then
+      sedexpr='s/#.*//;s/ \t\+/ /;s/ \+$//;s/^ \+//;/^$/d;
+/^$domain\|search$/!d;s/$domain\|search$ //;p'
+      domains=`sed -n "$sedexpr" /etc/resolv.conf`
+    fi
+    if test -z "$domains"
+    then
+      domains=`(domainname) 2>/dev/null | tr -d '+'`
+      if test -z "$domains" || test "$domains" = '(none)'
+      then
+        domains=`(hostname) 2>/dev/null | grep '\.'`
+      fi
+    fi
+    # resolv.conf's "search" directive might return multiple domains.
+    # If any top-level domain is two letters and it's not 'us' or 'ca',
+    # assume the system uses A4 paper.
+    for d in $domains
+    do
+      case "$d" in
+      *.UuSs|*.CcAa)
+        ;;
+      *.A-Za-zA-Za-z)
+        PAGE=A4 ;;
+      esac
+    done
+  fi
 
-   test -n "$PAGE" || PAGE=letter
-   if test "x$PAGE" = "xA4"; then
-     AC_DEFINE(PAGEA4, 1,
-       Define if the printer's page size is A4.)
-   fi
-   AC_MSG_RESULT($PAGE)
-   AC_SUBST(PAGE))
+  test -n "$PAGE" || PAGE=letter
+  AC_MSG_RESULT($PAGE)
+  AC_SUBST(PAGE)
+)
 
 
 AC_DEFUN(GROFF_CXX_CHECK,
@@ -939,12 +1134,15 @@
        done
      done
    done
-   AC_MSG_RESULT($sys_tmac_prefix)
+   sys_tmac_prefix_result=none
+   test -z "$sys_tmac_prefix" \
+	|| sys_tmac_prefix_result="$sys_tmac_prefix"
+   AC_MSG_RESULT($sys_tmac_prefix_result)
    AC_SUBST(sys_tmac_prefix)
 
    AC_MSG_CHECKING(which system macro packages should be made available)
    tmac_wrap=
-   if test "x$sys_tmac_file_prefix" = "xtmac."; then
+   if test "$sys_tmac_file_prefix" = tmac.; then
      for f in $sys_tmac_prefix*; do
        suff=`echo $f | sed -e "s;$sys_tmac_prefix;;"`
        case "$suff" in
@@ -984,22 +1182,28 @@
      done
      rm -f conftest.sol
    fi
-   AC_MSG_RESULT($tmac_wrap)
+   tmac_wrap_result="none found"
+   test -z "$tmac_wrap" || tmac_wrap_result="$tmac_wrap"
+   AC_MSG_RESULT($tmac_wrap_result)
    AC_SUBST(tmac_wrap))
 
 
 # Searching if a non-GNU Troff is installed.  The built-in register
 # \n.g is always 1 in GNU Troff.
-AC_DEFUN(GROFF_G,
-  AC_MSG_CHECKING(for existing troff installation)
-   if test "x`(echo .tm '|n(.g' | tr '|' '\\\\' | troff -z -i 2>&1) 2>/dev/null`" = x0; then
-     AC_MSG_RESULT(yes)
-     g=g
-   else
-     AC_MSG_RESULT(no)
-     g=
-   fi
-   AC_SUBST(g))
+AC_DEFUN(GROFF_G, 
+  g=
+  AC_MSG_CHECKING(for existing troff installation)
+  if test "`(echo .tm '|n(.g' | tr '|' '\\\\' | troff -z -i 2>&1) \
+    2>/dev/null`" = 0
+  then
+    AC_MSG_RESULT(yes)
+    g=g
+  else
+    AC_MSG_RESULT(no)
+  fi
+  AC_SUBST(g)
+)
+
 
 # Controllable groff compatibility wrappers for vendor-provided macro sets
 #
@@ -1096,49 +1300,48 @@
 
 AC_DEFUN(GROFF_WITH_COMPATIBILITY_WRAPPERS,
   AC_ARG_WITH(compatibility-wrappers,
-    AS_HELP_STRING(--with-compatibility-wrappers=VALUE,
+    AS_HELP_STRING(--with-compatibility-wrappers={check|manual|no|yes},
       choose whether and how groff compatibility wrappers for \
-       vendor-provided non-GNU macro sets are installed. VALUE can be \
-       'check', 'yes', 'no' or 'manual'. \
-       'check' (the default) checks for the existence of vendor-provided \
-       non-GNU macro sets, and implements the 'yes' or 'no' option \
-       accordingly. \
-       'yes' generates compatibility wrappers for vendor-provided non-GNU \
-       macro sets to allow their use with groff-based tools. The \
-       compatibility wrappers are installed with the original macro set name, \
-       while groff implementation of these macro sets are installed with a \
-       'g' prefix. Thus use of the groff implementation of these macro sets \
-       requires use of the '-mg<macro>' option (example: -mgan). \
-       'no' only installs the groff implementation of macro sets. \
-       'manual' generates compatibility wrappers for vendor-provided non-GNU \
-       macro sets as '<macro>-os'. Use of these groff compatibility wrappers \
-       (for vendor-provided non-GNU macro sets) requires the use of the \
+       vendor-provided non-GNU macro packages are installed. \
+       'check' searches for such packages, and behaves as if 'yes' or \
+       'no' were given, accordingly. \
+       'yes' generates compatibility wrappers for the vendor-provided \
+       packages to allow their use with groff and related tools. \
+       The compatibility wrappers are installed using the
+       vendor-provided names, while their groff implementations are \
+       installed with a 'g' prefix. \
+       Use of the latter thus requires options of the form
+       '-mg<package>' (example: -mgan). \
+       'no' installs only the groff implementations.
+       'manual' generates compatibility wrappers for the \
+       vendor-provided packages as '<macro>-os'. \
+       Use of the latter thus requires options of the form
        '-m<macro>-os' option (example: -man-os).),
     compatibility_wrappers="$withval",
     compatibility_wrappers="check")
 
-    if test "x$compatibility_wrappers" != "xcheck"  -a \
-            "x$compatibility_wrappers" != "xyes"    -a \
-            "x$compatibility_wrappers" != "xno"     -a \
-            "x$compatibility_wrappers" != "xmanual"
+    if    test "$compatibility_wrappers" != check \
+       && test "$compatibility_wrappers" != yes   \
+       && test "$compatibility_wrappers" != no    \
+       && test "$compatibility_wrappers" != manual
     then
          AC_MSG_WARN(Invalid '--with-compatibility-wrappers' argument: '$compatibility_wrappers' - assuming 'check' requested.)
          compatibility_wrappers="check"
     fi
 
-    if test "x$tmac_wrap" = "x"
+    if test -z "$tmac_wrap"
     then
         # No Operating System Macro Sets Present
-        if   test "x$compatibility_wrappers" = "xcheck"
+        if   test "$compatibility_wrappers" = check
         then
             compatibility_wrappers="no"
-        elif test "x$compatibility_wrappers" = "xyes"
+        elif test "$compatibility_wrappers" = yes
         then
             AC_MSG_ERROR(No non-GNU macro sets found - cannot create and install compatibility wrappers)
-        elif test "x$compatibility_wrappers" = "xno"
+        elif test "$compatibility_wrappers" = no
         then
             : # No action required
-        elif test "x$compatibility_wrappers" = "xmanual"
+        elif test "$compatibility_wrappers" = manual
         then
             # 'manual' allows quiet conversion to 'no' to support
             # cross-platform build instructions
@@ -1146,7 +1349,7 @@
         fi
     else
         # One or more Operating System Macro Sets Present
-        if   test "x$compatibility_wrappers" = "xcheck"
+        if   test "$compatibility_wrappers" = check
         then
             compatibility_wrappers="yes"
         fi
@@ -1167,9 +1370,7 @@
 # Test whether install-info is available.
 
 AC_DEFUN(GROFF_INSTALL_INFO,
-  if test $docadd_info = yes; then
-     AC_CHECK_PROGS(INSTALL_INFO, install-info, :)
-   fi)
+  AC_CHECK_PROGS(INSTALL_INFO, install-info, :))
 
 
 # At least one Unix system, Apple Macintosh Rhapsody 5.5,
@@ -1398,11 +1599,11 @@
 # MS-DOS/Win32=';').
 #
 # The logic to resolve this test is already encapsulated in
-# '${srcdir}/src/include/nonposix.h'.
+# '$srcdir/src/include/nonposix.h'.
 
 AC_DEFUN(GROFF_TARGET_PATH_SEPARATOR,
   AC_MSG_CHECKING(separator character to use in groff search paths)
-   cp ${srcdir}/src/include/nonposix.h conftest.h
+   cp "$srcdir"/src/include/nonposix.h conftest.h
    AC_COMPILE_IFELSE(
        AC_LANG_PROGRAM(
 	
@@ -1426,147 +1627,133 @@
 
 # Check for X11.
 
-AC_DEFUN(GROFF_X11,
-  AC_REQUIRE(AC_PATH_XTRA)
-   groff_no_x=$no_x
-   if test -z "$groff_no_x"; then
-     OLDCFLAGS=$CFLAGS
-     OLDLDFLAGS=$LDFLAGS
-     OLDLIBS=$LIBS
-     CFLAGS="$CFLAGS $X_CFLAGS"
-     LDFLAGS="$LDFLAGS $X_LIBS"
-     LIBS="$LIBS $X_PRE_LIBS -lX11 $X_EXTRA_LIBS"
-
-     LIBS="$LIBS -lXaw"
-     AC_MSG_CHECKING(for Xaw library and header files)
-     AC_LINK_IFELSE(
-	 AC_LANG_PROGRAM(
+AC_DEFUN(GROFF_X11, 
+  AC_REQUIRE(AC_PATH_XTRA)
+  groff_no_x=$no_x
+  if test -z "$groff_no_x"
+  then
+    OLDCFLAGS=$CFLAGS
+    OLDLDFLAGS=$LDFLAGS
+    OLDLIBS=$LIBS
+    CFLAGS="$CFLAGS $X_CFLAGS"
+    LDFLAGS="$LDFLAGS $X_LIBS"
+    LIBS="$LIBS $X_PRE_LIBS -lX11 $X_EXTRA_LIBS"
+
+    LIBS="$LIBS -lXaw"
+    AC_MSG_CHECKING(for Xaw library and header files)
+    AC_LINK_IFELSE(
+      AC_LANG_PROGRAM(
 
 #include <X11/Intrinsic.h>
 #include <X11/Xaw/Simple.h>
 
-	 ,
-	 )
-       ,
-       AC_MSG_RESULT(yes),
-       AC_MSG_RESULT(no)
-	groff_no_x="yes")
+        ,
+        )
+      ,
+      AC_MSG_RESULT(yes),
+      AC_MSG_RESULT(no)
+      groff_no_x=yes)
 
-     LIBS="$LIBS -lXmu"
-     AC_MSG_CHECKING(for Xmu library and header files)
-     AC_LINK_IFELSE(
-	 AC_LANG_PROGRAM(
+    LIBS="$LIBS -lXmu"
+    AC_MSG_CHECKING(for Xmu library and header files)
+    AC_LINK_IFELSE(
+      AC_LANG_PROGRAM(
 
 #include <X11/Intrinsic.h>
 #include <X11/Xmu/Converters.h>
 
-	 ,
-	 )
-       ,
-       AC_MSG_RESULT(yes),
-       AC_MSG_RESULT(no)
-	groff_no_x="yes")
+        ,
+        )
+      ,
+      AC_MSG_RESULT(yes),
+      AC_MSG_RESULT(no)
+      groff_no_x=yes)
 
-     CFLAGS=$OLDCFLAGS
-     LDFLAGS=$OLDLDFLAGS
-     LIBS=$OLDLIBS
-   fi
+    CFLAGS=$OLDCFLAGS
+    LDFLAGS=$OLDLDFLAGS
+    LIBS=$OLDLIBS
+  fi
 
-   if test "x$groff_no_x" = "xyes"; then
-     AC_MSG_NOTICE(gxditview and xtotroff won't be built)
-   else
-     XDEVDIRS="font/devX75 font/devX75-12 font/devX100 font/devX100-12"
-     XPROGDIRS="src/devices/xditview src/utils/xtotroff"
-     XLIBDIRS="src/libs/libxutil"
-   fi
+  if ! test "$groff_no_x" = yes
+  then
+    XDEVDIRS="font/devX75 font/devX75-12 font/devX100 font/devX100-12"
+    XPROGDIRS="src/devices/xditview src/utils/xtotroff"
+    XLIBDIRS="src/libs/libxutil"
+  fi
 
-   AC_SUBST(XDEVDIRS)
-   AC_SUBST(XPROGDIRS)
-   AC_SUBST(XLIBDIRS))
+  AC_SUBST(XDEVDIRS)
+  AC_SUBST(XPROGDIRS)
+  AC_SUBST(XLIBDIRS)
+)
 
 
-# Set up the '--with-appresdir' command-line option.
+# Interpret the '--with-appdefdir' command-line option.
 
-# Don't quote AS_HELP_STRING!
-AC_DEFUN(GROFF_APPRESDIR_OPTION,
-  AC_ARG_WITH(appresdir,
-     AS_HELP_STRING(--with-appresdir=DIR,
-		    X11 application resource files)))
+dnl Don't quote AS_HELP_STRING!
+dnl
+dnl TODO: Include the computed default in the RHS of the help string.
+AC_DEFUN(GROFF_APPDEFDIR_OPTION, 
+  AC_ARG_WITH(appdefdir,
+    AS_HELP_STRING(--with-appdefdir=DIR,
+      place X11 application defaults files in DIR))
+)
 
 
-# Get a default value for the application resource directory.
+# Get a default value for the application defaults directory.
 #
-# We ignore the 'XAPPLRES' and 'XUSERFILESEARCHPATH' environment variables.
+# We ignore the 'XAPPLRES' and 'XUSERFILESEARCHPATH' environment
+# variables.
 #
-# By default if --with-appresdir is not used, we will install the
-# gxditview resources in $prefix/lib/X11/app-defaults.
+# By default if --with-appdefdir is not used, we will install the
+# gxditview application defaults in $prefix/lib/X11/app-defaults.
 #
-# Note that if --with-appresdir was passed to 'configure', no prefix is
-# added to 'appresdir'.
+# Note that if --with-appdefdir was passed to 'configure', no prefix is
+# added to 'appdefdir'.
 
-AC_DEFUN(GROFF_APPRESDIR_DEFAULT,
+AC_DEFUN(GROFF_APPDEFDIR_DEFAULT,
   if test -z "$groff_no_x"; then
-     if test "x$with_appresdir" = "x"; then
-       if test "x$prefix" = "xNONE"; then
-         appresdir=$ac_default_prefix/lib/X11/app-defaults
+     if test -z "$with_appdefdir"; then
+       if test "$prefix" = NONE; then
+         appdefdir=$ac_default_prefix/lib/X11/app-defaults
        else
-         appresdir=$prefix/lib/X11/app-defaults
+         appdefdir=$prefix/lib/X11/app-defaults
        fi
      else
-       appresdir=$with_appresdir
+       appdefdir=$with_appdefdir
      fi
    fi
-   AC_SUBST(appresdir))
+   AC_SUBST(appdefdir))
 
-# Emit warning if --with-appresdir hasn't been used.
+# Emit warning if --with-appdefdir hasn't been used.
 
-AC_DEFUN(GROFF_APPRESDIR_CHECK,
+AC_DEFUN(GROFF_APPDEFDIR_NOTICE,
   if test -z "$groff_no_x"; then
-     if test "x$with_appresdir" = "x"; then
-       AC_MSG_NOTICE(
-  The application resource files for gxditview (GXditview and
-  GXditview-color) will be installed in:
-
-    $appresdir
-
-  (existing files will be saved by appending '.old' to the file
-  name).
-
-  To install them into a different directory, say,
-  '/etc/X11/app-defaults', add
-  '--with-appresdir=/etc/X11/app-defaults' to the configure script
-  command-line options and rerun it ('prefix' value has no effect on
-  a --with-appresdir option).
-
-  If the gxditview resources are installed in a directory that is not
-  one of the default X11 resources directories (common default
-  directories are /usr/lib/X11/app-defaults,
-  /usr/share/X11/app-defaults and /etc/X11/app-defaults), you will
-  have to set the environment variable XFILESEARCHPATH to this
-  path.  More details can be found in the X(7) manual page, or in "X
-  Toolkit Intrinsics - C Language Interface manual".
+     if test -z "$with_appdefdir"; then
+       AC_MSG_NOTICE(Default X11 application defaults directory \
+assumed.
+
+  The application defaults files for gxditview (GXditview and
+  GXditview-color) will be installed in the following directory.
+
+    $appdefdir
+
+  To install elsewhere, say, '/etc/X11/app-defaults', add
+  '--with-appdefdir=/etc/X11/app-defaults' to the configure script
+  command-line options and rerun it (the 'prefix' value has no effect on
+  a --with-appdefdir option).
+
+  If the gxditview app-defaults are installed in a directory that is not
+  one of the default X11 directories for this purpose (common defaults
+  are /usr/lib/X11/app-defaults, /usr/share/X11/app-defaults, and
+  /etc/X11/app-defaults), you will have to set the environment variable
+  XFILESEARCHPATH to this path.  More details can be found in the X(7)
+  manual page, or in the document "X Toolkit Intrinsics - C Language
+  Interface manual".
        )
      fi
    fi)
 
 
-# Set up the '--with-grofferdir' command-line option.
-
-AC_DEFUN(GROFF_GROFFERDIR_OPTION,
-  AC_ARG_WITH(grofferdir,
-     AS_HELP_STRING(--with-grofferdir=DIR,
-		    groffer files location)))
-
-
-AC_DEFUN(GROFF_GROFFERDIR_DEFAULT,
-  if test "x$with_grofferdir" = "x"; then
-    groffer_dir=$libprogramdir/groffer
-  else
-    groffer_dir=$with_grofferdir
-  fi
-  AC_SUBST(groffer_dir))
-
-
 AC_DEFUN(GROFF_LIBPROGRAMDIR_DEFAULT,
   libprogramdir=$libdir/groff
   AC_SUBST(libprogramdir))
@@ -1582,38 +1769,44 @@
   AC_SUBST(gpinyin_dir))
 
 
-AC_DEFUN(GROFF_GROGDIR_DEFAULT,
-  grog_dir=$libprogramdir/grog
-  AC_SUBST(grog_dir))
-
 AC_DEFUN(GROFF_REFERDIR_DEFAULT,
   referdir=$libprogramdir/refer
   AC_SUBST(referdir))
 
-# Check for xpmtoppm, for gnu.eps generation
+# Generation of doc/gnu.eps requires xpmtoppm.
+
 AC_DEFUN(GROFF_PROG_XPMTOPPM,
   AC_CHECK_PROG(XPMTOPPM, xpmtoppm, found, missing))
 
-# Check for make built-in variable RM
-AC_DEFUN(GROFF_MAKE_RM,
-  AC_MSG_CHECKING(whether make has builtin variable RM)
-cat <<EOF > test_make_rm.mk
+# Check for make built-in variable RM.
+
+AC_DEFUN(GROFF_MAKE_DEFINES_RM, 
+  AC_MSG_CHECKING(whether make defines 'RM')
+  make=make
+  if test -n "$MAKE"
+  then
+    make=$MAKE
+  fi
+  cat <<EOF > test_make_rm.mk
 all:
-	@if test -n "\$(RM)"; then \
-	   echo "yes"; \
+	@if test -n "\$(RM)"; \
+	then \
+	   echo yes; \
 	else \
-	   echo "no"; \
+	   echo no; \
 	fi
 EOF
-  groff_is_rm_defined=`make -sf test_make_rm.mk`
-  AC_MSG_RESULT($groff_is_rm_defined)
-  rm -f test_make_rm.mk)
+  groff_make_defines_rm=`"$make" -sf test_make_rm.mk`
+  AC_MSG_RESULT($groff_make_defines_rm)
+  rm -f test_make_rm.mk
+)
 
 # Check if diff has option -D, for gdiffmk. If not, check if gdiff is
 # available on the system and make the same test. If either diff or
 # gdiff is working, it is set to DIFF_PROG.  If -D option is not
 # available, DIFF_PROG is left to diff (gdiffmk will report a
 # problem).
+
 AC_DEFUN(GROFF_DIFF_D,
   AC_MSG_CHECKING(for a diff program that supports option -D)
   groff_has_diff_d_option=no
@@ -1632,6 +1825,7 @@
   AC_SUBST(DIFF_PROG))
 
 # Check if 'test' supports the option -ef.
+
 AC_DEFUN(GROFF_HAVE_TEST_EF_OPTION,
   AC_MSG_CHECKING(whether test supports option -ef)
   HAVE_TEST_EF_OPTION=no
@@ -1641,55 +1835,52 @@
 
 # gdiffmk will attempt to use bash (for option -ef of 'test'). If bash
 # is not available it will use /bin/sh.
+
 AC_DEFUN(GROFF_BASH,
   AC_PATH_PROGS(BASH_PROG, bash, no)
-  if test x$BASH_PROG = xno; then
+  if test "$BASH_PROG" = no; then
      BASH_PROG=/bin/sh
   fi
   AC_SUBST(BASH_PROG))
 
-# Looking for uchardet library, used by preconv.
-AC_DEFUN(GROFF_UCHARDET,
-  AC_ARG_WITH(uchardet,
-               AS_HELP_STRING(--with-uchardet,
-                              Build 'preconv' with uchardet library for file \
-                               encoding automatic detection =auto|no|yes))
-   AS_IF(test "x$with_uchardet" != "xno",
-         PKG_CHECK_MODULES(UCHARDET,
-                            uchardet >= 0.0.1,
-                            AC_DEFINE(HAVE_UCHARDET,
-                                       1,
-                                       uchardet library availability)
-                             groff_have_uchardet=yes,
-                            if test "x$with_uchardet" = "xyes"; then
-                               AC_MSG_FAILURE(Could not found uchardet library)
-                             else
-                               AC_MSG_WARN(uchardet library not found, preconv \
-might not work properly)
-                             fi
-                             groff_have_uchardet=no),
-          groff_have_uchardet=no
-          ))
-
-# Warning if uchardet library was not found
-AC_DEFUN(GROFF_UCHARDET_CHECK,
-  if test "x$groff_have_uchardet" = "xno" -a "x$with_uchardet" != "xno"; then
-  AC_MSG_WARN(
-  uchardet library was not found; preprocessor 'preconv', which uses it to detect
-  the input file encoding, might not work properly (to check how and in which
-  order 'preconv' tries to determine the file encoding, see its man page).
+# Search for uchardet library used by preconv.
+
+AC_DEFUN(GROFF_UCHARDET, 
+  AC_ARG_WITH(uchardet,
+    AS_HELP_STRING(--with-uchardet={auto|no|yes},
+      build 'preconv' against uchardet library to automatically \
+detect input file encoding))
+    AS_IF(test "$with_uchardet" != no,
+      PKG_CHECK_MODULES(UCHARDET,
+        uchardet >= 0.0.1,
+        AC_DEFINE(HAVE_UCHARDET, 1,
+          uchardet library availability)
+        groff_have_uchardet=yes, 
+          if test "$with_uchardet" = yes
+          then
+            AC_MSG_FAILURE(could not find uchardet library)
+          fi
+          groff_have_uchardet=no),
+      groff_have_uchardet=no)
+)
+
+AC_DEFUN(GROFF_UCHARDET_NOTICE, 
+  if test "$groff_have_uchardet" = no && test "$with_uchardet" != no
+  then
+    AC_MSG_NOTICE(The uchardet library was not found.
+
+  The 'preconv' preprocessor program will be unable to attempt automatic
+  inference of an input file's character encoding.  See the preconv(1)
+  man page.
   )
   fi
-  )
+)
 
-# pdftools needed for sanity checks
-AC_DEFUN(GROFF_PDFTOOLS,
-  AC_CHECK_PROG(PDFINFO, pdfinfo, found, missing)
-   AC_CHECK_PROG(PDFFONTS, pdffonts, found, missing)
-   AC_CHECK_PROG(PDFIMAGES, pdfimages, found, missing)
-   if test "x$PDFINFO" = "xfound" -a "x$PDFFONTS" = "xfound" -a "x$PDFIMAGES" = "xfound"; then
-      groff_have_pdftools=yes;
-   else
-      groff_have_pdftools=no;
-   fi
-   )
+
+AC_DEFUN(GROFF_USE_GROFF_ALLOCATOR, 
+  AC_ARG_ENABLE(groff-allocator,
+    AS_HELP_STRING(--enable-groff-allocator, enable libgroff's \
+allocator for C++ new/delete),
+    test "$enableval" = yes && groff_use_own_allocator=yes,
+    groff_use_own_allocator=no)
+)

_service:tar_scm:groff-1.22.4.tar.gz/m4/lib-link.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/m4/lib-link.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/m4/localcharset.m4 -> _service:tar_scm:groff-1.23.0.tar.gz/m4/localcharset.m4 Changed

_service:tar_scm:groff-1.22.4.tar.gz/makevarescape.sed -> _service:tar_scm:groff-1.23.0.tar.gz/makevarescape.sed Changed

_service:tar_scm:groff-1.22.4.tar.gz/man/groff.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff.7.man Changed

@@ -1,16 +1,16 @@
 '\" t
-.TH GROFF @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff \- a short reference for the GNU roff language
+.TH groff @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff \- GNU
+.I roff
+language reference
 .
-.\" Before installation: <top-groff-source>/man/groff.man
-.\" After installation:  </usr or /usr/local>/share/man/man7/groff.7
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -24,18 +24,35 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Setup
 .\" ====================================================================
 .
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_7_C \n.C
-.cp 0
-.
+.\" Man pages should not define page-local macros.  Most of these were
+.\" written long ago; someday we'll revise the page without them.
 .
 .\" ====================================================================
-.\" start of macro definitions
+.\" start a macro, escape sequence, or register definition
 .
 .de TPx
 .  TP 10n
@@ -49,13 +66,6 @@
 .  nop \)\\$*
 ..
 .
-.\" ========= command=line option =========
-.
-.de option
-.  Text \fCB\\$*
-.  ft P
-..
-.
 .\" ========= characters =========
 .
 .de squoted_char
@@ -68,7 +78,7 @@
 .
 .\" synopsis of a request
 .de REQ
-.  ie \n.$=1 \{\
+.  ie \\n.$=1 \{\
 .    Text \fCB\\$1\f
 .  \}
 .  el \{\
@@ -78,10 +88,13 @@
 .
 .\" reference of a request
 .de request
-.  BR \\$*
+.  ie (\\n.$ < 2) \
+.    B \\$*
+.  el \
+.    BR \\$*
 ..
 .
-.\" ========= numerical elements =========
+.\" ========= numeric elements =========
 .
 .\" number with a trailing unit
 .de scalednumber
@@ -137,7 +150,7 @@
 .\" Result : prints \name'arg', where 'name' is in CB, 'arg' in I
 .\"
 .de ESCq
-.  Text "\fCB\e\\$1\cq\f\,\fI\\$2\/\f\fCB\cq\f"
+.  Text "\fCB\e\\$1\aq\f\,\fI\\$2\/\f\fCB\aq\f"
 ..
 .\" ====================================================================
 .\" .ESC? arg
@@ -145,10 +158,10 @@
 .\" Synopsis for escape sequence with a bracketed long argument
 .\" Args   : 1 obligatory
 .\"   arg  : arbitrary text
-.\" Result : prints '\?arg?', where the '?' are in CB, 'arg' in I
+.\" Result : prints '\?arg\?', where the '\?' are in CB, 'arg' in I
 .\"
 .de ESC?
-.  Text "\fCB\e?\,\fI\\$1\/\fCB?\fR"
+.  Text "\fCB\e?\,\fI\\$1\/\fCB\rs?\fR"
 ..
 .\" ====================================================================
 .\" .esc name punct
@@ -160,7 +173,10 @@
 .\" Result  : prints \name, where 'name' is in B, 'punct' in R
 .\"
 .de esc
-.  BR "\e\\$1" \\$2
+.  ie (\\n.$ < 2) \
+.    B "\e\\$1"
+.  el \
+.    BR "\e\\$1" \\$2
 ..
 .\" ====================================================================
 .\" .escarg name arg punct
@@ -188,19 +204,6 @@
 .  Text \fCB\e\\$1\lB\f\,\fCI\\$2\/\f\fCB\rB\f\\$3
 ..
 .
-.\" ====================================================================
-.\" .escq name arg
-.\"
-.\" Reference for escape sequence with a bracketed long argument
-.\" Args   : 2 obligatory
-.\"   name : suitable name for an escape sequence (c, (xy, long)
-.\"   arg  : arbitrary text
-.\" Result : prints \name'arg', where 'name' is in CB, 'arg' in CI
-.\"
-.de escq
-.  Text \fCB\e\\$1\cq\f\,\fCI\\$2\/\f\fCB\cq\f\\$3
-..
-.
 .\" ========= strings =========
 .
 .\" synopsis for string, with \*
@@ -223,936 +226,2187 @@
 .\" reference of a register, without decoration
 .de register
 .  Text register
-.  BR \\$*
+.  ie (\\n.$ < 2) \
+.    B \\$*
+.  el \
+.    BR \\$*
+..
+.
+.\" begin list piloting a possible extension to man(7)
+.de LS
+.  nr saved-PD \\nPD
+.  nr PD 0
+..
+.
+.\" end list piloting a possible extension to man(7)
+.de LE
+.  nr PD \\nsaved-PD
 ..
 .
+.
 .\" end of macro definitions
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.P
-The name
 .I groff
-stands for
-.I GNU roff
-and is the free implementation of the roff type-setting system.
+is short for GNU
+.IR roff ,
+a free reimplementation of the AT&T device-independent
+.I troff \" AT&T
+typesetting system.
 .
 See
-.BR roff (@MAN7EXT@)
-for a survey and the background of the groff system.
+.MR roff @MAN7EXT@
+for a survey of and background on
+.I roff
+systems.
 .
 .
 .P
-This document provides only short descriptions of roff language
-elements.
+This document is intended as a reference.
 .
+The primary
+.I groff
+manual,
 .IR "Groff: The GNU Implementation of troff" ,
 by Trent A.\& Fisher and Werner Lemberg,
-is the primary
+is a better resource for learners,
+containing many examples and much discussion.
+.
+It is written in Texinfo;
+you can browse it interactively with \lqinfo groff\rq.
+.
+Additional formats,
+including plain text,
+HTML,
+DVI,
+and PDF,
+may be available in
+.IR @DOCDIR@ .
+.
+.
+.P
 .I groff
-manual,
-and is written in Texinfo.
+is also a name for an extended dialect of the
+.I roff
+language.
 .
-You can browse it interactively with \lqinfo groff\rq.
+We use \lqroff\rq to denote features that are universal,
+or nearly so,
+among implementations of this family.
+.
+We apply the term \lqgroff\rq to the language documented here,
+the GNU implementation of the overall system,
+the project that develops that system,
+and the command of that name.
 .
 .
 .P
-Historically, the
-.I roff language
-was called
-.IR troff .
+GNU
+.IR troff , \" GNU
+installed on this system as
+.MR @g@troff @MAN1EXT@ ,
+is the
+.I formatter:
+a program that reads device and font descriptions
+(\c
+.MR groff_font @MAN5EXT@ ),
+interprets the
 .I groff
-is compatible with the classical system and provides proper
-extensions.
+language expressed in text input files,
+and translates that input into a device-independent output format
+(\c
+.MR groff_out @MAN5EXT@ )
+that is usually then post-processed by an output driver to produce
+PostScript,
+PDF,
+HTML,
+DVI,
+or terminal output.
 .
-So in GNU, the terms
-.IR roff ,
-.IR troff ,
+.
+.\" ====================================================================
+.SH "Input format"
+.\" ====================================================================
+.
+Input to GNU
+.I troff \" GNU
+is organized into lines separated by the Unix newline character
+(U+000A),
+and must be in one of two character encodings it can recognize:
+IBM code page 1047 on EBCDIC systems,
+and ISO\~Latin-1 (8859-1) otherwise.
+.
+Use of ISO\~646-1991:IRV (\lqUS-ASCII\rq) or (equivalently) the
+\lqBasic Latin\rq
+subset of ISO\~10646 (\lqUnicode\rq) is recommended;
+see
+.MR groff_char @MAN7EXT@ .
+.
+The
+.MR preconv @MAN1EXT@
+preprocessor transforms other encodings,
+including UTF-8,
+to satisfy
+.IR @g@troff 's
+requirements.
+.
+.
+.\" ====================================================================
+.SH "Syntax characters"
+.\" ====================================================================
+.
+Several input characters are syntactically significant to
+.IR groff .
+.
+.
+.IP . 4n
+A dot at the beginning of an input line marks it as a
+.I control line.
+.
+It can also follow the
+.request .el
+and
+.request .nop
+requests,
+and the condition in
+.request .if ,
+.request .ie ,
 and
-.I groff language
-could be used as synonyms.
+.request .while
+requests.
+.
+The control character invokes requests and calls macros by the name that
+follows it.
+.
+The
+.request .cc
+request can change the control character.
+.
+.
+.IP \aq
+The neutral apostrophe is the
+.I "no-break control character,"
+recognized where the control character is.
+.
+It suppresses the (first) break implied by the
+.request .bp ,
+.request .cf ,
+.request .fi ,
+.request .fl ,
+.request .in ,
+.request .nf ,
+.request .rj ,
+.request .sp ,
+.request .ti ,
+and
+.request .trf
+requests.
+.
+The requested operation takes effect at the next break.
+.
+It makes
+.request .br
+nilpotent.
+.
+The no-break control character can be changed with the
+.request .c2
+request.
+.
+When formatted,
+.RB \lq \aq \rq
+may be typeset as a typographical quotation mark;
+use the
+.esc aq
+special character escape sequence to format a neutral apostrophe glyph.
+.
+.
+.IP \dq
+The neutral double quote can be used to enclose arguments to macros and
+strings,
+and is required if those arguments contain space or tab characters.
+.
+In the
+.request .ds ,
+.request .ds1 ,
+.request .as ,
+and
+.request .as1
+requests,
+an initial neutral double quote in the second argument is stripped off
+to allow embedding of leading spaces.
+.
+To include a double quote inside a quoted argument,
+use the
+.esc dq
+special character escape sequence
+(which also serves to typeset the glyph in text).
+.
+.
+.IP \rs
+A backslash introduces an escape sequence.
+.
+The escape character can be changed with the
+.request .ec
+request;
+.request .eo
+disables escape sequence recognition.
+.
+Use the
+.esc rs
+special character escape sequence to format a backslash glyph,
+and
+.esc e
+to typeset the glyph of the current escape character.
+.
+.
+.IP (
+An opening parenthesis is special only in certain escape sequences;
+when recognized,
+it introduces an argument of exactly two characters.
 .
-However
-.I troff
-slightly tends to refer more to the classical aspects, whereas
 .I groff
-emphasizes the GNU extensions, and
-.I roff
-is the general term for the language.
+offers the more flexible square bracket syntax.
+.
+.
+.IP 
+An opening bracket is special only in certain escape sequences;
+when recognized,
+it introduces an argument (list) of any length,
+not including a closing bracket.
+.
+.
+.IP 
+A closing bracket is special only when an escape sequence using an
+opening bracket as an argument delimiter is being interpreted.
+.
+It ends the argument (list).
 .
 .
 .P
-The general syntax for writing groff documents is relatively easy, but
-writing extensions to the roff language can be a bit harder.
+Additionally,
+the Control+A character (U+0001) in text is interpreted as a
+.I leader
+(see below).
 .
 .
 .P
-The roff language is line-oriented.
+Horizontal white space characters are significant to
+.I groff,
+but trailing spaces on text lines are ignored.
+.\" slack text for widow/orphan control: trailing tabs are not
+.
+.
+.TP 8n
+.I space
+Space characters separate arguments in request invocations,
+macro calls,
+and string interpolations.
 .
-There are only two kinds of lines, control lines and text lines.
+In text,
+they separate words.
 .
-The control lines start with a control character, by default a period
-.dquoted_char .
-or a single quote
-.dquoted_char \aq ;
-all other lines are text lines.
+Multiple adjacent space characters in text cause
+.I groff
+to attempt end-of-sentence detection on the preceding word
+(and trailing punctuation).
 .
+The amount of space between words and sentences is controlled by the
+.request .ss
+request.
 .
-.P
-.B Control lines
-represent commands, optionally with arguments.
+When filling is enabled
+(the default),
+a line may be broken at a space.
+.
+When adjustment is enabled
+(the default),
+inter-word spaces are expanded until the output line reaches the
+configured length.
+.
+An adjustable but non-breaking space is available with
+.esc \ti .
+.
+To get a space of fixed width,
+use one of the escape sequences
+.squoted_char "\rs\~"
+(the escape character followed by a space),
+.esc 0 ,
+.esc | ,
+.esc \ha ,
+or
+.esc h ;
+see section \lqEscape sequences\rq below.
 .
-They have the following syntax.
 .
-The leading control character can be followed by a command name;
-arguments, if any, are separated by spaces (but not tab characters)
-from the command name and among themselves, for example,
-.RS
-.P
-.Text .command_name arg1 arg2
-.RE
+.TP
+.I newline
+In text,
+a newline puts an inter-word space onto the output and,
+if filling is enabled,
+triggers end-of-sentence recognition on the preceding text.
 .
+See section \lqLine continuation\rq below.
 .
-.P
-For indentation, any number of space or tab characters can be inserted
-between the leading control character and the command name, but the
-control character must be on the first position of the line.
+.
+.TP
+.I tab
+A tab character in text causes the drawing position to advance to the
+next defined tab stop.
 .
 .
-.P
-.B Text lines
-represent the parts that is printed.
-They can be modified by escape sequences, which are recognized by a
-leading backslash
-.squoted_char \rs .
-These are in-line or even in-word formatting elements or functions.
+.\" ====================================================================
+.SH "Tabs and leaders"
+.\" ====================================================================
 .
-Some of these take arguments separated by single quotes
-.dquoted_char \aq ,
-others are regulated by a length encoding introduced by an open
-parenthesis
-.squoted_char (
-or enclosed in brackets
-.squoted_char 
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Tabs and
+.\" Leaders".
+The formatter interprets input horizontal tab characters
+(\lqtabs\rq) and Control+A characters (\lqleaders\rq) into
+movements to the next tab stop.
+.
+Tabs simply move to the next tab stop;
+leaders place enough periods to fill the space.
+.
+Tab stops are by default located every half inch measured from the
+drawing position corresponding to the beginning of the input line;
+see section \lqPage geometry\rq of
+.MR roff 7 .
+.
+Tabs and leaders do not cause breaks and therefore do not interrupt
+filling.
+.
+Tab stops can be configured with the
+.B ta
+request,
+and tab and leader glyphs with the
+.B tc
 and
-.squoted_char  .
+.B lc
+requests,
+respectively.
+.\" END Keep (roughly) parallel with groff.texi node "Tabs and Leaders".
 .
 .
-.P
-The roff language provides flexible instruments for writing language
-extension, such as macros.
+.\" ====================================================================
+.SH "Line continuation"
+.\" ====================================================================
 .
-When interpreting macro definitions, the roff system enters a special
-operating mode, called the
-.BR "copy mode" .
+When filling is enabled,
+input and output line breaks generally do not correspond.
+.
+The
+.I roff
+language therefore distinguishes input and output line continuation.
 .
 .
 .P
-The copy mode behaviour can be quite tricky, but there are some rules
-that ensure a safe usage.
+A backslash
+.B \rs
+immediately followed by a newline,
+sometimes discussed as
+.BI \rs newline\c
+,
+suppresses the effects of that newline
+on the input.
 .
-.IP 1.
-Printable backslashes must be denoted as
-.esc e .
-To be more precise,
-.esc e
-represents the current escape character.
+The next input line thus retains the classification of its predecessor
+as a control or text line.
 .
-To get a backslash glyph, use
-.esc (rs
-or
-.esc rs .
-.IP 2.
-Double all backslashes.
-.IP 3.
-Begin all text lines with the special non-spacing character
-.esc & .
+.BI \rs newline
+is useful for managing line lengths in the input during document
+maintenance;
+you can break an input line in the middle of a request invocation,
+macro call,
+or escape sequence.
+.
+Input line continuation is invisible to the formatter,
+with two exceptions:
+the
+.B \or
+operator recognizes the new input line,
+and the input line counter register
+.B .c
+is incremented.
 .
 .
 .P
-This does not produce the most efficient code, but it should work as a
-first measure.
+The
+.esc c
+escape sequence continues an
+.I output
+line.
+.
+Nothing on the input line after it is formatted.
+.
+In contrast to
+.BI \rs newline\c
+,
+a line after
+.esc c
+is treated as a new input line,
+so a control character is recognized at its beginning.
+.
+The visual results depend on whether filling is enabled.
+.
+An intervening control line that causes a break overrides
+.esc c ,
+flushing out the pending output line in the usual way.
+.
+The
+.register .int
+contains a positive value if the last output line was continued with
+.esc c ;
+this datum is associated with the
+environment.
 .
-For better strategies, see the
+.
+.\" ====================================================================
+.SH Colors
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Colors".
 .I groff
-Texinfo manual and
-.BR groff_tmac (@MAN5EXT@).
+supports color output with a variety of color spaces and up to 16 bits
+per channel.
+.
+Some devices,
+particularly terminals,
+may be more limited.
+.
+When color support is enabled,
+two colors are current at any given time:
+the
+.I stroke color,
+with which glyphs,
+rules (lines),
+and geometric objects like circles and polygons are drawn,
+and the
+.I fill color,
+which can be used to paint the interior of a closed geometric figure.
+.
+The
+.BR color ,
+.BR defcolor ,
+.BR gcolor ,
+and
+.B fcolor
+requests;
+.B \rsm
+and
+.B \rsM
+escape sequences;
+and
+.BR .color ,
+.BR .m ,
+and
+.B .M
+registers exercise color support.
 .
 .
 .P
-Reading roff source files is easier, just reduce all double backslashes
-to a single one in all macro definitions.
+Each output device has a color named
+.RB \lq default \rq,
+which cannot be redefined.
+.
+A device's default stroke and fill colors are not necessarily the same.
+.
+For the
+.BR dvi ,
+.BR html ,
+.BR pdf ,
+.BR ps ,
+and
+.B xhtml
+output devices,
+.I @g@troff
+automatically loads a macro file defining many color names at startup.
+.
+By the same mechanism,
+the devices supported by
+.MR grotty @MAN1EXT@
+recognize the eight standard ISO\~6429/ECMA-48 color names
+(also known vulgarly as \lqANSI colors\rq).
+.\" END Keep (roughly) parallel with groff.texi node "Colors".
 .
 .
+.br
+.ne 3v
 .\" ====================================================================
-.SH "GROFF ELEMENTS"
+.SH Measurements
 .\" ====================================================================
 .
-The roff language elements add formatting information to a text file.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Measurements".
+Numeric parameters that specify measurements are expressed as
+integers or decimal fractions with an optional
+.I scaling unit
+suffixed.
+.
+A scaling unit is a letter that immediately follows the last digit of a
+number.
 .
-The fundamental elements are predefined commands and variables that
-make roff a full-blown programming language.
+Digits after the decimal point are optional.
 .
 .
 .P
-There are two kinds of roff commands, possibly with arguments.
-.B Requests
-are written on a line of their own starting with a dot
-.squoted_char .
-or a
-.dquoted_char \aq ,
-whereas
-.B Escape sequences
-are in-line functions and in-word formatting elements starting with a
-backslash
-.squoted_char \rs .
+Measurements are scaled by the scaling unit and stored internally
+(with any fractional part discarded)
+in basic units.
+.
+The device resolution can therefore be obtained by storing a value of
+.RB \lq 1i \rq
+to a register.
+.
+The only constraint on the basic unit is that it is at least as small as
+any other unit.
+.\" That's a fib.  A device resolution of around 2^31 would surely also
+.\" cause problems.  But nobody does that.
 .
 .
 .P
-The user can define her own formatting commands using the
-.request de
-request.
+.LS
+.TP
+.B u
+Basic unit.
 .
-These commands are called
-.BR macros ,
-but they are used exactly like requests.
+.TP
+.B i
+Inch;
+defined as 2.54\~centimeters.
 .
-Macro packages are pre-defined sets of macros written in the groff
-language.
+.TP
+.B c
+Centimeter.
 .
-A user's possibilities to create escape sequences herself is very
-limited, only special characters can be mapped.
+.TP
+.B p
+Point;
+a typesetter's unit used for measuring type size.
+.
+There are 72\~points to an inch.
+.
+.TP
+.B P
+Pica;
+another typesetter's unit.
+.
+There are 6\~picas to an inch and 12\~points to a pica.
+.
+.TP
+.BR s ,\~ z
+Scaled points and multiplication by the output device's
+.I sizescale
+parameter,
+respectively.
+.
+.TP
+.B f
+Multiplication by 65,536;
+.
+scales decimal fractions in the interval 0, 1 to 16-bit unsigned
+integers.
+.LE
+.
+.
+.P
+The magnitudes of other scaling units depend on the text formatting
+parameters in effect.
 .
 .
 .P
-The groff language provides several kinds of variables with
-different interfaces.
+.LS
+.TP
+.B m
+Em;
+an em is equal to the current type size in points.
+.
+.TP
+.B n
+En;
+an en is one-half em.
+.
+.TP
+.B v
+Vee;
+distance between text baselines.
+.
+.TP
+.B M
+Hundredth of an em.
+.LE
+.\" END Keep (roughly) parallel with groff.texi node "Measurements".
+.
+.
+.\" ====================================================================
+.SS "Motion quanta"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Motion Quanta".
+An output device's basic unit
+.B u
+is not necessarily its smallest addressable length;
+.B u
+can be smaller to avoid problems with integer roundoff.
+.
+The minimum distances that a device can work with in the horizontal and
+vertical directions are termed its
+.I "motion quanta,"
+stored in the
+.B .H
+and
+.B .V
+registers,
+respectively.
+.
+Measurements are rounded to applicable motion quanta.
+.
+Half-quantum fractions round toward zero.
+.\" END Keep (roughly) parallel with groff.texi node "Motion Quanta".
+.
+.
+.\" ====================================================================
+.SS "Default units"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Default Units".
+A general-purpose register
+(one created or updated with the
+.B nr
+request;
+see section \lqRegisters\rq below)
+is implicitly dimensionless,
+or reckoned in basic units if interpreted in a measurement context.
+.
+But it is convenient for many requests and escape sequences to infer a
+scaling unit for an argument if none is specified.
+.
+An explicit scaling unit
+(not after a closing parenthesis)
+can override an undesirable default.
+.
+Effectively,
+the default unit is suffixed to the expression if a scaling unit is not
+already present.
+.
+GNU
+.IR troff 's \" GNU
+use of integer arithmetic should also be kept in mind;
+see below.
+.\" END Keep (roughly) parallel with groff.texi node "Default Units".
+.
+.
+.\" ====================================================================
+.SH "Numeric expressions"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Numeric
+.\" expressions".
+A
+.I numeric expression
+evaluates to an integer.
 .
-There are pre-defined variables, but the user can define her own
-variables as well.
+The following operators are recognized.
+.\"evaluates to an integer:
+.\"it can be as simple as a literal
+.\".RB \lq 0 \rq
+.\"or it can be a complex sequence of register and string interpolations
+.\"interleaved with measurement operators.
 .
 .
 .P
-.B String
-variables store character sequences.
+.TS
+Rf(CR) L.
++	addition
+\-	subtraction
+*	multiplication
+/	truncating division
+%	modulus
+_
+\fRunary\f +	assertion, motion, incrementation
+\fRunary\f \-	negation, motion, decrementation
+_
+;	scaling
+>?	maximum
+<?	minimum
+_
+<	less than
+>	greater than
+<=	less than or equal
+>=	greater than or equal
+\&=	equal
+==	equal
+_
+&	logical conjunction (\lqand\rq)
+:	logical disjunction (\lqor\rq)
+!	logical complementation (\lqnot\rq)
+_
+( )	precedence
+_
+|	boundary-relative motion
+.TE
 .
-They are set with the
-.request ds
-request and retrieved by the
-.esc *
-escape sequences.
 .
-Strings can have variables.
+.P
+.I @g@troff
+provides a set of mathematical and logical operators familiar to
+programmers\emas well as some unusual ones\embut supports only
+integer arithmetic.
+.
+(Provision is made for interpreting and
+reporting decimal fractions in certain cases.)
+.
+The internal data type used for computing results is usually a 32-bit
+signed integer,
+which suffices to represent magnitudes within a range of \+-2
+billion.
+.
+(If that's not enough, see
+.MR groff_tmac @MAN5EXT@
+for the
+.I 62bit.tmac
+macro package.)
 .
 .
 .P
-.B Register
-variables can store numerical values, numbers with a scale unit, and
-occasionally string-like objects.
+Arithmetic infix operators perform a function on the numeric expressions
+to their left and right;
+they are
+.B +
+(addition),
+.B \-
+(subtraction),
+.B *
+(multiplication),
+.B /
+(truncating division),
+and
+.B %
+(modulus).
 .
-They are set with the
-.request nr
-request and retrieved by the
-.esc n
-escape sequences.
+.I Truncating division
+rounds to the integer nearer to zero,
+no matter how large the fractional portion.
+.
+Overflow and division
+(or modulus)
+by zero are errors and abort evaluation of a numeric expression.
 .
 .
 .P
-.B Environments
-allow the user to temporarily store global formatting parameters like
-line length, font size, etc.\& for later reuse.
+Arithmetic unary operators operate on the numeric expression to their
+right;
+they are
+.B \-
+(negation)
+and
+.B +
+(assertion\emfor completeness;
+it does nothing).
 .
-This is done by the
-.request ev
-request.
+The unary minus must often be used with parentheses to avoid confusion
+with the decrementation operator,
+discussed below.
 .
 .
 .P
-.B Fonts
-are identified either by a name or by an internal number.
+The sign of the modulus of operands of mixed signs is determined by the
+sign of the first.
+.
+Division and modulus operators satisfy the following property:
+given a
+.RI dividend\~ a
+and a
+.RI divisor\~ b ,
+a
+.RI quotient\~ q
+formed by
+.RB \lq "(a / b)" \rq
+and a
+.RI remainder\~ r
+by
+.RB \lq "(a % b)" \rq,
+then
+.IR qb \~+\~ r \~=\~ a .
 .
-The current font is chosen by the
-.request ft
-request or by the
-.esc f
-escape sequences.
-.
-Each device has special fonts, but the following fonts are available
-for all devices.
-.B R
-is the standard font Roman.
-.B B
-is its
-.B bold
-counterpart.
 .
-The
-.I italic
-font is called
-.B I
-and is available everywhere, but on text devices it is displayed as an
-underlined Roman font.
+.P
+GNU
+.IR troff 's \" GNU
+scaling operator,
+used with parentheses as
+.BI ( c ; e )\c
+,
+evaluates a numeric
+.RI expression\~ e
+.RI using\~ c
+as the default scaling unit.
 .
-For the graphical output devices, there exist constant-width pendants
-of these fonts,
-.BR CR ,
-.BR CI ,
+If
+.I c
+is omitted,
+scaling units are ignored in the evaluation
+.RI of\~ e .
+.
+GNU
+.I troff \" GNU
+also provides a pair of operators to compute the extrema of two
+operands:
+.B >?\&
+(maximum)
 and
-.BR CB .
-On text devices, all glyphs have a constant width anyway.
+.B <?\&
+(minimum).
 .
 .
 .P
-.B Glyphs
-are visual representation forms of
-.BR characters .
-In groff, the distinction between those two elements is not always
-obvious (and a full discussion is beyond the scope of this man page).
+Comparison operators comprise
+.B <
+(less than),
+.B >
+(greater than),
+.B <=
+(less than or equal),
+.B >=
+(greater than or equal),
+and
+.B =
+(equal).
 .
-A first approximation is that glyphs have a specific size and
-colour and are taken from a specific font; they can't be modified any
-more \en characters are the input, and glyphs are the output.
+.B ==
+is a synonym for
+.BR = .
 .
-As soon as an output line has been generated, it no longer contains
-characters but glyphs.
+When evaluated,
+a comparison is replaced with
+.RB \lq 0 \rq
+if it is false and
+.RB \lq 1 \rq
+if true.
 .
-In this man page, we use either \oqglyph\cq or
-\oqcharacter\cq, whatever is more appropriate.
+In the
+.I roff
+language,
+positive values are true,
+others false.
 .
 .
 .P
-Moreover, there are some advanced roff elements.
+We can operate on truth values with the logical operators
+.B &
+(logical conjunction or \lqand\rq)
+and
+.B :
+(logical disjunction or \lqor\rq).
 .
-A
-.B diversion
-stores (formatted) information into a macro for later usage.
-See
-.BR groff_tmac (@MAN5EXT@)
-for more details.
+They evaluate as comparison operators do.
 .
-A
-.B trap
-is a positional condition like a certain number of lines from page top
-or in a diversion or in the input.
+A logical complementation (\lqnot\rq) operator,
+.B !\&,
+works only within
+.RB \lq if \rq,
+.RB \lq ie \rq,
+and
+.RB \lq while \rq
+requests.
 .
-Some action can be prescribed to be run automatically when the
-condition is met.
+.\" This is worded to avoid implying that the operator doesn't apply to
+.\" conditional expressions in general, albeit without mentioning them
+.\" because they're out of scope.
+Furthermore,
+.B !\&
+is recognized only at the beginning of a numeric expression not
+contained by another numeric expression.
+.
+In other words,
+it must be the \lqoutermost\rq operator.
+.
+Including it elsewhere in the expression produces a warning in the
+.RB \%\lq number \rq
+category
+(see
+.MR @g@troff @MAN1EXT@ ),
+and its expression evaluates false.
 .
+This unfortunate limitation maintains compatibility with AT&T
+.IR troff .\" AT&T
 .
-.P
-More detailed information and examples can be found in the
-.I groff
-Texinfo manual.
+Test a numeric expression for falsity by comparing it to a false value.
 .
 .
-.\" ====================================================================
-.SH "CONTROL CHARACTERS"
-.\" ====================================================================
+.P
+The
+.I roff
+language has no operator precedence:
+expressions are evaluated strictly from left to right,
+in contrast to schoolhouse arithmetic.
 .
-There is a small set of characters that have a special controlling
-task in certain conditions.
+Use parentheses
+.B ( )
+to impose a desired precedence upon subexpressions.
 .
-.TP
-\&\fCB.\f
-A dot is only special at the beginning of a line or after the
-condition in the requests
-.request if\c
-,
-.request ie\c
-,
-.request el\c
-,
+.
+.P
+For many requests and escape sequences that cause motion on the page,
+the unary operators
+.B +
 and
-.request while\c
-\&.
-There it is the control character that introduces a request (or macro).
+.B \-
+work differently when leading a numeric expression.
 .
-By using the
-.request cc
-request, the control character can be set to a different character,
-making the dot
-.squoted_char .
-a non-special character.
+They then indicate a motion relative to the drawing position:
+positive is down in vertical contexts,
+right in horizontal ones.
 .
-.IP ""
-In all other positions, it just means a dot character.
 .
-In text paragraphs, it is advantageous to start each sentence at a
-line of its own.
+.P
+.B +
+and
+.B \-
+are also treated differently by the following requests and escape
+sequences:
+.BR bp ,
+.BR in ,
+.BR ll ,
+.BR pl ,
+.BR pn ,
+.BR po ,
+.BR ps ,
+.BR pvs ,
+.BR rt ,
+.BR ti ,
+.BR \rsH ,
+.BR \rsR ,
+and
+.BR \rss .
 .
-.TP
-\&\fCB\aq\f
-The single quote has two controlling tasks.
+Here,
+leading plus and minus signs serve as incrementation and decrementation
+operators,
+respectively.
 .
-At the beginning of a line and in the conditional requests it is the
-non-breaking control character.
+To negate an expression,
+subtract it from zero
+or include the unary minus in parentheses with its argument.
+.\" @xref{Setting Registers}, for examples.
 .
-That means that it introduces a request like the dot, but with the
-additional property that this request doesn't cause a linebreak.
 .
-By using the
-.request c2
-request, the non-break control character can be set to a different
-character.
+.P
+A leading
+.B \or
+operator indicates a motion relative not to the drawing position but to
+a boundary.
 .
-.IP ""
-As a second task, it is the most commonly used argument separator in
-some functional escape sequences (but any pair of characters not part
-of the argument do work).
+For horizontal motions,
+the measurement specifies a distance relative to a drawing position
+corresponding to the beginning of the
+.I input
+line.
 .
-In all other positions, it denotes the single quote or apostrophe
-character.
+By default,
+tab stops reckon movements in this way.
+Most escape sequences do not;
+.\" XXX: Which ones do?
+.B \or
+tells them to do so.
 .
-Groff provides a printable representation with the
-.esc (cq
-escape sequence.
+For vertical motions,
+the
+.B \or
+operator specifies a distance from the first text baseline on the page
+or in the current diversion,
+using the current vertical spacing.
 .
-.TP
-\&\fCB\dq\f
-The double quote is used to enclose arguments in macros (but not in
-requests and strings).
 .
-In the
-.request ds
+.P
+The
+.B \rsB
+escape sequence tests its argument for validity as a numeric expression.
+.
+.
+.br
+.ne 2v
+.P
+A register interpolated as an operand in a numeric expression must have
+an Arabic format;
+luckily,
+this is the default.\" @xref{Assigning Register Formats}.
+.
+.
+.P
+Due to the way arguments are parsed,
+spaces are not allowed in numeric expressions unless the (sub)expression
+containing them is surrounded by parentheses.
+.\"@xref{Request and Macro Arguments}, and @ref{Conditionals and Loops}.
+.\" END Keep (roughly) parallel with groff.texi node "Numeric
+.\" expressions".
+.
+.
+.\" ====================================================================
+.SH Identifiers
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Identifiers".
+An
+.I identifier
+labels a GNU
+.I troff \" GNU
+datum such as a register,
+name
+(macro,
+string,
+or diversion),
+typeface,
+color,
+special character,
+character class,
+environment,
+or stream.
+.
+Valid identifiers consist of one or more ordinary characters.
+.
+An
+.I ordinary character
+is an input character that is not the escape character,
+a leader,
+tab,
+newline,
+or invalid as GNU
+.I troff \" GNU
+input.
+.
+.
+.\" XXX: We might move this discussion earlier since it is applicable to
+.\" troff input in general, and include a reference to the `trin`
+.\" request.
+.P
+Invalid input characters are subset of control characters
+(from the sets \lqC0 Controls\rq and \lqC1 Controls\rq as
+Unicode describes them).
+.
+When
+.I @g@troff
+encounters one in an identifier,
+it produces a warning in category
+.RB \%\lq input \rq
+(see section \lqWarnings\rq in
+.MR @g@troff @MAN1EXT@ ).
+.
+They are removed during interpretation:
+an identifier \lqfoo\rq,
+followed by an invalid
+character and then \lqbar\rq,
+is processed as \lqfoobar\rq.
+.
+.
+.P
+On a machine using the ISO 646,
+8859,
+or 10646 character encodings,
+invalid input characters are
+.BR 0x00 ,
+.BR 0x08 ,
+.BR 0x0B ,
+.BR 0x0D \en 0x1F ,
 and
-.request as
-requests, a leading double quote in the argument is stripped off,
-making everything else afterwards the string to be defined (enabling
-leading whitespace).
+.BR 0x80 \en 0x9F .
 .
-The escaped double quote
-.esc \dq
-introduces a comment.
+On an EBCDIC host,
+they are
+.BR 0x00 \en 0x01 ,
+.BR 0x08 ,
+.BR 0x09 ,
+.BR 0x0B ,
+.BR 0x0D \en 0x14 ,
+.BR 0x17 \en 0x1F ,
+and
+.BR 0x30 \en 0x3F .
 .
-Otherwise, it is not special.
+Some of these code points are used by
+.I @g@troff
+internally,
+making it non-trivial to extend the program to accept UTF-8 or other
+encodings that use characters from these ranges.
 .
-Groff provides a printable representation with the
-.esc (dq
-escape sequence.
 .
-.TP
-\&\fCB\e\f
-The backslash usually introduces an escape sequence (this can be
-changed with the
-.request ec
-request).
+.P
+An identifier with a closing bracket (\lq\rq) in its name can't be
+accessed with bracket-form escape sequences that expect an identifier as
+a parameter.
 .
-A printed version of the escape character is the
-.esc e
-escape; a backslash glyph can be obtained by
-.esc (rs .
+Similarly,
+the
+identifier \lq(\rq can't be interpolated
+.I except
+with bracket forms.
 .
-.TP
-\&\fCB(\f
-The open parenthesis is only special in escape sequences when
-introducing an escape name or argument consisting of exactly two
-characters.
 .
-In groff, this behaviour can be replaced by the \fCB\f construct.
+.P
+If you begin a macro,
+string,
+or diversion name with either of the characters \lq\rq or
+\lq\rq,
+you foreclose use of the
+.MR @g@refer @MAN1EXT@
+preprocessor,
+which recognizes \lq.\rq and \lq.\rq as bibliographic
+reference delimiters.
 .
-.TP
-\&\fCB\f
-The opening bracket is only special in groff escape sequences; there
-it is used to introduce a long escape name or long escape argument.
 .
-Otherwise, it is non-special, e.g.\& in macro calls.
+.P
+The escape sequence
+.B \rsA
+tests its argument for validity as an identifier.
 .
-.TP
-\&\fCB\f
-The closing bracket is only special in groff escape sequences; there
-it terminates a long escape name or long escape argument.
 .
-Otherwise, it is non-special.
+.P
+How GNU
+.I troff \" GNU
+handles the interpretation of an undefined identifier depends on the
+context.
 .
-.TP
-\fCIspace\f
-Space characters are only functional characters.
+There is no way to invoke an undefined request;
+such syntax is interpreted as a macro call instead.
 .
-They separate the arguments in requests, macros, and strings, and the
-words in text lines.
+If the identifier is interpreted as a string,
+macro,
+or diversion,
+.I @g@troff
+emits a warning in category
+.RB \lq mac \rq,
+defines it as empty,
+and interpolates nothing.
 .
-They are subject to groff's horizontal spacing calculations.
+If the identifier is interpreted as a register,
+.I @g@troff
+emits a warning in category
+.RB \lq reg \rq,
+initializes it to zero,
+and interpolates that value.
 .
-To get a defined space width, escape sequences like
-.squoted_char "\rs\ "
-(this is the escape character followed by a space),
-.esc | ,
-.esc ^ ,
-or
-.esc h
-should be used.
+See section \lqWarnings\rq in
+.MR @g@troff @MAN1EXT@ ,
+and subsection \lqInterpolating registers\rq and section
+\lqStrings\rq below.
 .
-.IP \fCInewline\f
-In text paragraphs, newlines mostly behave like space characters.
+Attempting to use an undefined
+typeface,
+style,
+special character,
+color,
+character class,
+environment,
+or stream generally provokes an error diagnostic.
 .
-Continuation lines can be specified by an escaped newline, i.e., by
-specifying a backslash
-.squoted_char \rs
-as the last character of a line.
 .
-.IP \fCItab\f
-If a tab character occurs during text the interpreter makes a
-horizontal jump to the next pre-defined tab position.
+.P
+Identifiers for requests,
+macros,
+strings,
+and diversions share one name
+space;
+special characters and character classes another.
 .
-There is a sophisticated interface for handling tab positions.
+No other object types do.
+.\" END Keep (roughly) parallel with groff.texi node "Identifiers".
 .
 .
 .\" ====================================================================
-.SH "NUMERICAL EXPRESSIONS"
+.SH "Control characters"
 .\" ====================================================================
 .
-A
-.B numerical value
-is a signed or unsigned integer or float with or without an appended
-scaling indicator.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Control
+.\" Characters".
+.\" The mechanism of using @code{roff}'s control characters to invoke
+.\" requests and call macros was introduced in @ref{Requests and Macros}.
+Control characters are recognized only at the beginning of an input
+line,
+or at the beginning of the branch of a control structure request;
+.\" see @ref{Conditionals and Loops}.
+see section \lqControl structures\rq below.
 .
-A
-.B scaling indicator
-is a one-character abbreviation for a unit of measurement.
 .
-A number followed by a scaling indicator signifies a size value.
+.P
+A few requests cause a break implicitly;
+use the no-break control character to prevent the break.
+.
+Break suppression is its sole behavioral distinction.
 .
-By default, numerical values do not have a scaling indicator, i.e., they
-are normal numbers.
+Employing the no-break control character to invoke requests that don't
+cause breaks is harmless but poor style.
 .
 .
 .P
+The control character
+.RB \lq .\& \rq
+and the no-break control character
+.RB \lq \|\aq\| \rq
+can be changed with the
+.B cc
+and
+.B c2
+requests,
+respectively.
+.
+Within a macro definition,
+.\" you might wish to know
+register
+.B .br
+indicates the control character used to call it.
+.\" END Keep (roughly) parallel with groff.texi node "Control
+.\" Characters".
+.
+.
+.\" ====================================================================
+.SH "Invoking requests"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Invoking
+.\" Requests".
+A control character is optionally followed by tabs and/or spaces and
+then an identifier naming a request or macro.
+.
+The invocation of an unrecognized request is interpreted as a macro
+call.
+.
+Defining a macro with the same name as a request replaces the request.
+.
+Deleting a request name with the
+.B rm
+request makes it unavailable.
+.
 The
-.I roff
-language defines the following scaling indicators.
+.B als
+request can alias requests,
+permitting them to be wrapped or non-destructively replaced.
 .
+See section \lqStrings\rq below.
 .
+.
+.br
+.ne 4v
 .P
-.PD 0
-.RS
+There is no inherent limit on argument length or quantity.
 .
-.TPx
-.B c
-centimeter
+Most requests take one or more arguments,
+and ignore any they do not expect.
 .
-.TPx
-.B i
-inch
+A request may be separated from its arguments by tabs or spaces,
+but only spaces can separate an argument from its successor.
 .
-.TPx
-.B P
-pica\ \eq\ 1/6\ inch
+Only one between arguments is necessary;
+any excess is ignored.
 .
-.TPx
-.B p
-point\ \eq\ 1/72\ inch
+GNU
+.I troff \" GNU
+does not allow tabs for argument separation.
+.\" @footnote{In compatibility mode, a space is not necessary after a
+.\" request or macro name of two characters' length.  Also, Plan@tie{}9
+.\" @code{troff} allows tabs to separate arguments.}
 .
-.TPx
-.B m
-em\ \eq\ \fRthe font size in points (approx.\& width of letter
-\oq\fCRm\fR\cq)
 .
-.TPx
-.B M
-100\^th \fRof an \fCRem
+.br
+.ne 3v
+.P
+Generally,
+a space
+.I within
+a request argument is not relevant,
+not meaningful,
+or is supported by bespoke provisions,
+as with the
+.B tl
+request's delimiters.
 .
-.TPx
-.B n
-en\ \eq\ em/2
+Some requests,
+like
+.BR ds ,
+interpret the remainder of the control line as a single argument.
 .
-.TPx
-.B u
-Basic unit for actual output device
+See section \lqStrings\rq below.
 .
-.TPx
-.B v
-Vertical line space in basic units
 .
-.TPx
-.B s
-scaled point\ \eq\ 1/\fCIsizescale\fR of a point (defined in
-font \fIDESC\f file)
+.P
+Spaces and tabs immediately after a control character are ignored.
 .
-.TPx
-.B f
-Scale by 65536.
-.RE
-.PD
+Commonly,
+authors structure the source of documents or macro files with them.
+.\" END Keep (roughly) parallel with groff.texi node "Requests".
 .
 .
-.P
-.B Numerical expressions
-are combinations of the numerical values defined above with the
-following arithmetical operators already defined in classical troff.
+.\" ====================================================================
+.SH "Calling macros"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Calling Macros".
+If a macro of the desired name does not exist when called,
+it is created,
+assigned an empty definition,
+and a warning in category
+.RB \lq mac \rq
+is emitted.
+.
+Calling an undefined macro
+.I does
+end a macro definition naming it as its end macro
+(see section \lqWriting macros\rq below).
 .
 .
 .P
-.PD 0
-.RS
+To embed spaces
+.I within
+a macro argument,
+enclose the argument in neutral double quotes
+.RB \oq \|\dq\| \cq.
 .
-.TPx
-.B +
-Addition
+Horizontal motion escape sequences are sometimes a better choice for
+arguments to be formatted as text.
 .
-.TPx
-.B \-
-Subtraction
 .
-.TPx
-.B *
-Multiplication
+.P
+The foregoing raises the question of how to embed neutral double quotes
+or backslashes in macro arguments when
+.I those
+characters are desired as literals.
 .
-.TPx
-.B /
-Division
+In GNU
+.IR troff , \" GNU
+the special character escape sequence
+.B \rsrs
+produces a backslash and
+.B \rsdq
+a neutral double quote.
 .
-.TPx
-.B %
-Modulo
 .
-.TPx
-.B =
-Equals
+.P
+In GNU
+.IR troff 's \" GNU
+AT&T compatibility mode,
+these characters remain available as
+.B \rs(rs
+and
+.BR \rs(dq ,
+respectively.
 .
-.TPx
-.B ==
-Equals
+AT&T
+.I troff \" AT&T
+did not consistently define these special characters,
+.\" It seems that AT&T troff never recognized \(rs, though DWB 3.3
+.\" defined \(bs as an alias of "\" on its "Latin1" device, in
+.\" deliberate(?) collision with the Bell System logo identifier.  It
+.\" also defined \(dq for several devices (pcl, Latin1, nroff, ...)
+.\" along with \(aq.
+but its descendants can be made to support them.
 .
-.TPx
-.B <
-Less than
+See
+.MR groff_font @MAN5EXT@ .
 .
-.TPx
-.B >
-Greater than
+If even that is not feasible,
+.\" Nope nope nope--if you're this much of a masochist, go read Texinfo.
+see the \lqCalling Macros\rq section of the
+.I groff
+Texinfo manual for the complex macro argument quoting rules of AT&T
+.IR troff . \" AT&T
+.\" END Keep (roughly) parallel with groff.texi node "Calling Macros".
 .
-.TPx
-.B <=
-Less or equal
 .
-.TPx
-.B >=
-Greater or equal
+.\" ====================================================================
+.SH "Using escape sequences"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Using Escape
+.\" Sequences".
+Whereas requests must occur on control lines,
+escape sequences can occur intermixed with text and may appear in
+arguments to requests,
+macros,
+and other escape sequences.
+.
+An escape sequence is introduced by the escape character,
+a backslash
+.BR \rs .
+.\" (but see the @code{ec} request below)
+.
+The next character selects the escape's function.
 .
-.TPx
-.B &
-Logical and
 .
-.TPx
-.B :
-Logical or
+.P
+Escape sequences vary in length.
+.
+Some take an argument,
+and of those,
+some have different syntactical forms for a one-character,
+two-character,
+or arbitrary-length argument.
+.
+Others accept
+.I only
+an arbitrary-length argument.
+.
+In the former scheme,
+a one-character argument follows the function character immediately,
+an opening parenthesis
+.RB \lq ( \rq
+introduces a two-character argument
+(no closing parenthesis is used),
+and an argument of arbitrary length is enclosed in brackets
+.RB \lq  \rq.
+.
+In the latter scheme,
+the user selects a delimiter character.
+.
+A few escape sequences are idiosyncratic,
+and support both of the foregoing conventions
+.RB ( \|\rss ),
+designate their own termination sequence
+.RB ( \|\rs? ),
+consume input until the next newline
+.RB ( \|\rs! ,
+.BR \|\rs" ,
+.BR \|\rs# ),
+or support an additional modifier character
+.RB ( \|\rss
+again,
+and
+.BR \|\rsn ).
+.\" As with requests, use of some escape sequences in source documents
+.\" may interact poorly with a macro package you use; consult its
+.\" documentation to learn of ``safe'' sequences or alternative
+.\" facilities it provides to achieve the desired result.
 .
-.TPx
-.B !
-Logical not
 .
-.TPx
-.B (
-Grouping of expressions
+.P
+If an escape character is followed by a character that does not
+identify a defined operation,
+the escape character is ignored
+(producing
+a diagnostic of the
+.RB \lq escape \rq
+warning category,
+which is not enabled by default)
+and the following character is processed normally.
 .
-.TPx
-.B )
-Close current grouping
 .
-.RE
-.PD
+.P
+Escape sequence interpolation is of higher precedence than escape
+sequence argument interpretation.
+.
+This rule affords flexibility in using escape sequences to construct
+parameters to other escape sequences.
 .
 .
 .P
-Moreover,
-.I groff
-added the following operators for numerical expressions:
+The escape character can be interpolated
+.RB ( \rse ).
+.
+Requests permit the escape mechanism to be deactivated
+.RB ( eo )
+and restored,
+or the escape character changed
+.RB ( ec ),
+and to save and restore it
+.RB ( ecs
+and
+.BR ecr ).
+.\" END Keep (roughly) parallel with groff.texi node "Using Escape
+.\" Sequences".
+.
+.
+.\" ====================================================================
+.SH Delimiters
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Delimiters".
+Some escape sequences that require parameters use delimiters.
+.
+The neutral apostrophe
+.B \aq
+is a popular choice and shown in this document.
+.
+The neutral double quote
+.B \dq
+is also commonly seen.
+.
+Letters,
+numerals,
+and leaders can be used.
+.
+Punctuation characters are likely better choices,
+except for those defined as infix operators in numeric expressions;
+see below.
 .
 .
+.br
+.ne 2v
 .P
-.PD 0
-.RS
+The following escape sequences don't take arguments and thus are allowed
+as delimiters:
+.BI \rs space\c
+,
+.BR \rs% ,
+.BR \rs| ,
+.BR \rs\ha ,
+.BR \rs{ ,
+.BR \rs} ,
+.BR \rs\aq ,
+.BR \rs\ga ,
+.BR \rs\- ,
+.BR \rs_ ,
+.BR \rs! ,
+.BR \rs? ,
+.BR \rs) ,
+.BR \rs/ ,
+.BR \rs, ,
+.BR \rs& ,
+.BR \rs: ,
+.BR \rs\ti ,
+.BR \rs0 ,
+.BR \rsa ,
+.BR \rsc ,
+.BR \rsd ,
+.BR \rse ,
+.BR \rsE ,
+.BR \rsp ,
+.BR \rsr ,
+.BR \rst ,
+and
+.BR \rsu .
 .
-.TPx
-\fIe1\/\fCB>?\,\fIe2\fR
-The maximum of
-.I e1
+However,
+using them this way is discouraged;
+they can make the input confusing to read.
+.
+.
+.P
+A few escape sequences,
+.BR \rsA ,
+.BR \rsb ,
+.BR \rso ,
+.BR \rsw ,
+.BR \rsX ,
 and
-.IR e2 .
+.BR \rsZ ,
+accept a newline as a delimiter.
 .
-.TPx
-\fIe1\/\fCB<?\,\fIe2\fR
-The minimum of
-.I e1
+Newlines that serve as delimiters continue to be recognized as input
+line terminators.
+.
+Use of newlines as delimiters in escape sequences is also discouraged.
+.
+.
+.br
+.ne 2v
+.P
+Finally,
+the escape sequences
+.BR \rsD ,
+.BR \rsh ,
+.BR \rsH ,
+.BR \rsl ,
+.BR \rsL ,
+.BR \rsN ,
+.BR \rsR ,
+.BR \rss ,
+.BR \rsS ,
+.BR \rsv ,
 and
-.IR e2 .
+.B \rsx
+prohibit many delimiters.
 .
-.TPx
-\fCB(\,\fIc\/\fCB;\,\fIe\/\fCB)\fR
-Evaluate
-.I e
-using
-.I c
-as the default scaling indicator.
 .
+.RS
+.IP \bu 2n
+the numerals 0\en9 and the decimal point
+.RB \lq . \rq
+.
+.
+.IP \bu
+the (single-character) operators
+.B +\-/*%<>=&:()
+.
+.
+.IP \bu
+any escape sequences other than
+.BR \rs% ,
+.BR \rs: ,
+.BR \rs{ ,
+.BR \rs} ,
+.BR \rs\aq ,
+.BR \rs\ga ,
+.BR \rs\- ,
+.BR \rs_ ,
+.BR \rs! ,
+.BR \rs/ ,
+.BR \rsc ,
+.BR \rse ,
+and
+.B \rsp
 .RE
-.PD
 .
 .
 .P
-For details see the
+Delimiter syntax is complex and flexible primarily for historical
+reasons;
+the foregoing restrictions need be kept in mind mainly when using
 .I groff
-Texinfo manual.
+in AT&T compatibility mode.
+.
+GNU
+.I troff \" GNU
+keeps track of the nesting depth of escape sequence interpolations,
+so the only characters you need to avoid using as delimiters are those
+that appear in the arguments you input,
+not any that result from interpolation.
+.
+Typically,
+.B \aq
+works fine.
+.
+See section \lqImplementation differences\rq in
+.MR groff_diff @MAN7EXT@ .
+.\" END Keep (roughly) parallel with groff.texi node "Delimiters".
 .
 .
 .\" ====================================================================
-.SH CONDITIONS
+.SH "Dummy characters"
 .\" ====================================================================
 .
-.B Conditions
-occur in tests raised by the
-.request if\c
-,
-.request ie\c
-,
-and the
-.request while
-requests.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Dummy
+.\" Characters".
+As discussed in
+.MR roff @MAN7EXT@ ,
+the first character on an input line is treated specially.
 .
-The following table characterizes the different types of conditions.
+Further,
+formatting a glyph has many
+consequences on formatter state
+(see section \lqEnvironments\rq below).
 .
-.P
+Occasionally,
+we want to escape this context or embrace some of those consequences
+without actually rendering a glyph to the output.
 .
-.PD 0
-.RS
+.B \rs&
+interpolates a dummy character,
+which is constitutive of output but invisible.
 .
-.TPx
-.I N
-A numerical expression
-.I N
-yields true if its value is greater than\~0.
+Its presence alters the interpretation context of a subsequent input
+character,
+and enjoys several applications:
+preventing the insertion of extra space after an end-of-sentence
+character,
+preventing interpretation of a control character at the beginning of an
+input line,
+preventing kerning between two glyphs,
+and permitting the
+.B tr
+request to remap a character to \lqnothing\rq.
 .
-.TPx
-.BI ! N
-True if the value of
-.I N
-is\~0 (see below).
+.B \rs)
+works as
+.B \rs&
+does,
+except that it does not cancel a pending end-of-sentence state.
+.\" END Keep (roughly) parallel with groff.texi node "Dummy Characters".
 .
-.TPx
-.BI \aq s1 \aq s2 \aq
-True if string\~\c
-.I s1
-is identical to string\~\c
-.IR s2 .
 .
-.TPx
-.BI !\aq s1 \aq s2 \aq
-True if string\~\c
-.I s1
-is not identical to string\~\c
-.I s2
-(see below).
+.\" ====================================================================
+.SH "Control structures"
+.\" ====================================================================
 .
-.TPx
-.BI c ch
-True if there is a glyph\~\c
-.I ch
-available.
+.I groff
+has \lqif\rq and \lqwhile\rq control structures like other
+languages.
 .
-.TPx
-.BI d name
-True if there is a string, macro, diversion, or request called
-.IR name .
+However,
+the syntax for grouping multiple input lines in the branches or bodies
+of these structures is unusual.
 .
-.TPx
-.B e
-Current page number is even.
 .
-.TPx
-.B o
-Current page number is odd.
+.P
+They have a common form:
+the request name is
+(except for
+.request .el
+\lqelse\rq)
+followed by a conditional expression
+.IR cond-expr ;
+the remainder of the line,
+.IR anything ,
+is interpreted as if it were an input line.
+.
+Any quantity of spaces between arguments to requests serves only to
+separate them;
+leading spaces in
+.I anything
+are therefore not seen.
 .
-.TPx
-.BI m name
-True if there is a color called
-.IR name .
+.I anything
+effectively
+.I cannot
+be omitted;
+if
+.I cond-expr
+is true and
+.I anything
+is empty,
+the newline at the end of the control line is interpreted as a blank
+line
+(and therefore a blank text line).
 .
-.TPx
-.B n
-Formatter is
-.BR nroff .
 .
-.TPx
-.BI r reg
-True if there is a register named
-.IR reg .
+.P
+It is frequently desirable for a control structure to govern more than
+one request,
+macro call,
+or text line,
+or a combination of the foregoing.
 .
-.TPx
-.B t
-Formatter is
-.BR troff .
+The opening and closing brace escape sequences
+.esc {
+and
+.esc }
+perform such grouping.
 .
-.TPx
-.BI F font
-True if there exists a font named
-.IR font .
+Brace escape sequences outside of control structures have no meaning and
+produce no output.
 .
-.TPx
-.BI S style
-True if a style named
-.I style
-has been registered.
 .
-.RE
-.PD
+.P
+.esc {
+should appear
+(after optional spaces and tabs)
+immediately subsequent to the request's conditional expression.
+.
+.esc }
+should appear on a line with other occurrences of itself as necessary to
+match
+.esc {
+sequences.
 .
+It can be preceded by a control character,
+spaces,
+and tabs.
 .
-.P
-Note that the
-.B !
-operator may only appear at the beginning of an expression,
-and negates the entire expression.
-This maintains bug-compatibility with AT&T
-.IR troff .
+Input after any quantity of
+.esc }
+sequences on the same line is processed only if all the preceding
+conditions to which they correspond are true.
+.
+Furthermore,
+a
+.esc }
+closing the body of a
+.request .while
+request must be the last such escape sequence on an input line.
 .
 .
 .\" ====================================================================
-.SH REQUESTS
+.SS "Conditional expressions"
 .\" ====================================================================
 .
-This section provides a short reference for the predefined requests.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Operators in
+.\" Conditionals".
+The
+.request .if ,
+.request .ie ,
+and
+.request .while
+requests test the truth values of numeric expressions.
 .
-In groff, request, macro, and string names can be arbitrarily long.
+They also support several additional Boolean operators;
+the members of this expanded class are termed
+.IR "conditional expressions" ;
+their truth values are as shown below.
 .
-No bracketing or marking of long names is needed.
+.
+.br
+.ne 3v
+.P
+.TS
+rf(BI) lB
+rB lx.
+cond-expr\fR.\|.\|.	.\|.\|.is true if.\|.\|.
+_
+T{
+.BI \aq s1 \aq s2 \aq
+T}	T{
+.I s1
+produces the same formatted output as
+.IR s2 .
+T}
+T{
+.BI c\~ g
+T}	T{
+a glyph
+.I g
+is available.
+T}
+T{
+.BI d\~ m
+T}	T{
+a string,
+macro,
+diversion,
+or request
+.I m
+is defined.
+T}
+e	T{
+the current page number is even.
+T}
+T{
+.BI F\~ f
+T}	T{
+a font named
+.I f
+is available.
+T}
+T{
+.BI m\~ c
+T}	T{
+a color named
+.I c
+is defined.
+T}
+n	T{
+the formatter is in
+.I nroff
+mode.
+T}
+o	T{
+the current page number is odd.
+T}
+T{
+.BI r\~ n
+T}	T{
+a register named
+.I n
+is defined.
+T}
+T{
+.BI S\~ s
+T}	T{
+a font style named
+.I s
+is available.
+T}
+t	T{
+the formatter is in
+.I troff
+mode.
+T}
+v	T{
+n/a
+(historical artifact;
+always false).
+T}
+.TE
 .
 .
+.br
+.ne 2v
 .P
-Most requests take one or more arguments.
+If the first argument to an
+.BR .if ,
+.BR .ie ,
+or
+.B .while
+request begins with a non-alphanumeric character apart from
+.B !\&
+(see below);
+it performs an
+.I output comparison test.
 .
-The arguments are separated by space characters (no tabs!); there is
-no inherent limit for their length or number.
+Shown first in the table above,
+the
+.I output comparison operator
+interpolates a true value if formatting its comparands
+.I s1
+and
+.I s2
+produces the same output commands.
 .
+Other delimiters can be used in place of the neutral apostrophes.
 .
-.P
-Some requests have optional arguments with a different behaviour.
+.I @g@troff
+formats
+.I s1
+and
+.I s2
+in separate environments;
+after the comparison,
+the resulting data are discarded.
+.
+The resulting glyph properties,
+including font family,
+style,
+size,
+and
+slant,
+must match,
+but not necessarily the requests and/or escape sequences used to obtain
+them.
+.
+Motions must match in orientation and magnitude to within the applicable
+horizontal or vertical motion quantum of the device,
+after rounding.
+.
+.\" TODO: Uncomment and add forward reference when we add a "GNU troff
+.\" internals" subsection to this page.
+.\"(All of this is to say that the lists of output nodes created by
+.\"formatting
+.\".I s1
+.\"and
+.\".I s2
+.\"must be identical.)
 .
-Not all of these details are outlined here.
 .
-Refer to the
+.P
+Surround the comparands with
+.B \rs?\&
+to avoid formatting them;
+this causes them to be compared character by character,
+as with string comparisons in other programming languages.
+.
+Since comparands protected with
+.B \rs?\&
+are read in copy mode,
+they need not even be valid
 .I groff
-Texinfo manual and
-.BR groff_diff (@MAN7EXT@)
-for all details.
+syntax.
+.
+The escape character is still lexically recognized,
+however,
+and consumes the next character.
 .
 .
 .P
-In the following request specifications, most argument names were
-chosen to be descriptive.
+The above operators can't be combined with most others,
+but a leading
+.RB \lq !\& \rq,
+not followed immediately by spaces or tabs,
+complements an expression.
+.
+Spaces and tabs are optional immediately after the
+.RB \lq c \rq,
+.RB \lq d \rq,
+.RB \lq F \rq,
+.RB \lq m \rq,
+.RB \lq r \rq,
+and
+.RB \lq S \rq
+operators,
+but right after
+.RB \lq !\& \rq,
+they end the predicate and the conditional evaluates true.
+.
+(This bizarre behavior maintains compatibility with AT&T
+.IR troff .)
+.\" END Keep (roughly) parallel with groff.texi node "Operators in
+.\" Conditionals".
+.
+.
+.\" ====================================================================
+.SH "Syntax reference conventions"
+.\" ====================================================================
 .
-Only the following denotations need clarification.
+In the following request and escape sequence specifications,
+most argument names were chosen to be descriptive.
+.
+A few denotations may require introduction.
 .
 .
 .P
-.PD 0
+.LS
 .RS
 .
 .TPx
 .I c
-denotes a single character.
+denotes a single input character.
 .
 .TPx
 .I font
-a font either specified as a font name or a font number.
+a font either specified as a font name or a numeric mounting position.
 .
 .TPx
 .I anything
-all characters up to the end of the line or within
+all characters up to the end of the line,
+to the ending delimiter for the escape sequence,
+or within
 .esc {
 and
 .esc } .
 .
+Escape sequences may generally be used freely in
+.IR anything ,
+except when it is read in copy mode.
+.
+.TPx
+.I message
+is a character sequence to be emitted on the standard error stream.
+.
+Special character escape sequences are
+.I not
+interpreted.
+.
 .TPx
 .I n
-is a numerical expression that evaluates to an integer value.
+is a numeric expression that evaluates to a non-negative integer.
 .
 .TPx
-.I N
-is an arbitrary numerical expression, signed or unsigned.
+.I npl
+is a numeric expression constituting a count of subsequent
+.I productive
+input lines;
+that is,
+those that directly produce formatted output.
+.
+Text lines produce output,
+as do control lines containing requests like
+.request .tl
+or escape sequences like
+.esc D .
+.
+Macro calls are not themselves productive,
+but their interpolated contents can be.
 .
 .TPx
 .I \+-N
-has three meanings depending on its sign, described below.
-.
+is a numeric expression with a meaning dependent on its sign.
 .RE
-.PD
+.LE
 .
 .
 .P
-If an expression defined as
+If a numeric expression presented as
 .I \+-N
 starts with a
 .squoted_char +
-sign the resulting value of the expression is added to an already
-existing value inherent to the related request, e.g.\& adding to a
-number register.
-.
-If the expression starts with a
-.squoted_char -
-the value of the expression is subtracted from the request value.
-.
+sign,
+an increment in the amount of
+.RI of\~ N
+is applied to the value applicable to the request or escape sequence.
+.
+If it starts with a
+.squoted_char \-
+sign,
+a decrement of magnitude
+.I N
+is applied instead.
 .
-.P
 Without a sign,
 .I N
-replaces the existing value directly.
+replaces any existing value.
+.
+A leading minus sign
+.RI in\~ N
+is always interpreted as a decrementation operator,
+not an algebraic sign.
 .
-To assign a negative number either prepend\~0 or enclose the negative
-number in parentheses.
+To assign a register a negative value or the negated value of another
+register,
+enclose it with its operand in
+parentheses or subtract it from zero.
+.
+If a prior value does not exist
+(the register was undefined),
+an increment or decrement is applied as if to\~0.
 .
 .
 .\" ====================================================================
-.SS "Request Short Reference"
+.SH "Request short reference"
 .\" ====================================================================
 .
-.PD 0
+Not all details of request behavior are outlined here.
+.
+See the
+.I groff
+Texinfo manual or,
+for features new to GNU
+.IR troff , \" GNU
+.MR groff_diff @MAN7EXT@ .
 .
-.TPx
-.REQ .
-Empty line, ignored.
 .
-Useful for structuring documents.
+.P
+.LS
 .
 .TPx
-.REQ .\e\dq "anything"
-Complete line is a comment.
+.REQ .ab
+Abort processing;
+exit with failure status.
 .
 .TPx
-.REQ .ab "string"
-Print
-.I string
-on standard error, exit program.
+.REQ .ab message
+Abort processing;
+write
+.I message
+to the standard error stream and exit with failure status.
+.
 .
 .TPx
 .REQ .ad
-Begin line adjustment for output lines in current adjust mode.
+Enable output line alignment and adjustment using the mode stored in
+.BR \rsn.j .
+.
 .
 .TPx
-.REQ .ad "c"
-Start line adjustment in mode
+.REQ .ad c
+Enable output line alignment and adjustment in mode
 .I c
-(\fCIc\/\f\fCR\|\^\eq\|l,r,c,b,n\f).
+.RI ( c =\c
+.BR b , c , l , n , r ).
+.
+Sets
+.BR \rsn.j .
+.
 .
 .TPx
 .REQ .af "register c"
 Assign format
 .I c
 to
-.I register
-(\fCIc\/\f\fCR\|\^\eq\|l,i,I,a,A\f).
-.
-.TPx
-.REQ .aln "alias register"
-Create alias name for
-.IR register .
+.IR register ,
+where
+.I c
+is
+.RB \lq i \rq,
+.RB \lq I \rq,
+.RB \lq a \rq,
+.RB \lq A \rq,
+or a sequence of decimal digits whose quantity denotes the minimum width
+in digits to be used when the register is interpolated.
 .
-.TPx
-.REQ .als "alias object"
-Create alias name for request, string, macro, or diversion
-.IR object .
+.RB \lq i \rq
+and
+.RB \lq a \rq
+indicate Roman numerals and basic Latin alphabetics,
+respectively,
+in the lettercase specified.
+.
+The default is
+.BR 0 .
+.
+.TPx
+.REQ .aln "new old"
+Create alias
+(additional name)
+.I new
+for existing register named
+.IR old .
+.
+.TPx
+.REQ .als "new old"
+Create alias
+(additional name)
+.I new
+for existing request,
+string,
+macro,
+or diversion
+.IR old .
 .
 .TPx
 .REQ .am "macro"
@@ -1184,7 +2438,7 @@
 .
 .TPx
 .REQ .ami "macro"
-Append to a macro whose name is contained in the string register
+Append to a macro whose name is contained in the string
 .I macro
 until
 .B ..\&
@@ -1196,8 +2450,9 @@
 .I macro
 and
 .I end
-are string registers whose contents are interpolated for the macro name
-and the end macro, respectively.
+are strings whose contents are interpolated for the macro name and the
+end macro,
+respectively.
 .
 .TPx
 .REQ .ami1 "macro"
@@ -1212,17 +2467,30 @@
 but with compatibility mode switched off during macro expansion.
 .
 .TPx
-.REQ .as "stringvar anything"
+.REQ .as name
+Create string
+.I name
+with empty contents;
+no operation if
+.I name
+already exists.
+.
+.TPx
+.REQ .as "name contents"
 Append
-.I anything
-to
-.IR stringvar .
+.I contents
+to string
+.IR name .
 .
 .TPx
-.REQ .as1 "stringvar anything"
-Same as
-.request .as
-but with compatibility mode switched off during string expansion.
+.REQ .as1 string
+.TQ
+.REQ .as1 "string contents"
+As
+.request .as ,
+but with compatibility mode disabled when
+.I contents
+interpolated.
 .
 .TPx
 .REQ .asciify "diversion"
@@ -1231,68 +2499,108 @@
 .
 .TPx
 .REQ .backtrace
-Print a backtrace of the input on stderr.
+Write the state of the input stack to the standard error stream.
+.
+See the
+.B \-b
+option of
+.MR groff @MAN1EXT@ .
+.
+.TPx
+.REQ .bd font
+Stop emboldening font
+.I font.
 .
 .TPx
-.REQ .bd "font N"
+.REQ .bd "font n"
 Embolden
 .I font
-by
-.IR N \-1
+by overstriking its glyphs offset by
+.IR n \-1
 units.
 .
+See
+.register .b .
+.\" XXX: negative values accepted; check AT&T troff
+.
 .TPx
-.REQ .bd "S font N"
-Embolden Special Font
-.I S
-when current font is
-.IR font .
+.REQ .bd "special-font font"
+Stop emboldening
+.I special-font
+when
+.I font
+is selected.
+.
+.TPx
+.REQ .bd "special-font font n"
+Embolden
+.I special-font,
+overstriking its glyphs offset by
+.IR n \-1
+units when
+.I font
+is selected.
+.
+See
+.register .b .
 .
 .TPx
 .REQ .blm
-Unset the blank line macro.
+Unset blank line macro (trap).
+.
+Restore default handling of blank lines.
+.
 .
 .TPx
-.REQ .blm "macro"
-Set the blank line macro to
-.IR macro .
+.REQ .blm name
+Set blank line macro (trap) to
+.IR name .
+.
 .
 .TPx
 .REQ .box
-End current diversion.
+Stop directing output to current diversion;
+any pending output line is discarded.
+.
 .
 .TPx
-.REQ .box "macro"
-Divert to
-.IR macro ,
-omitting a partially filled line.
+.REQ .box name
+Direct output to diversion
+.IR name ,
+omitting a partially collected line.
+.
 .
 .TPx
 .REQ .boxa
-End current diversion.
+Stop appending output to current diversion;
+any pending output line is discarded.
+.
 .
 .TPx
-.REQ .boxa "macro"
-Divert and append to
-.IR macro ,
-omitting a partially filled line.
+.REQ .boxa name
+Append output to diversion
+.IR name ,
+omitting a partially collected line.
+.
 .
 .TPx
 .REQ .bp
-Eject current page and begin new page.
+Break page and start a new one.
 .
 .TPx
 .REQ .bp "\+-N"
-Eject current page; next page number
+Break page,
+starting a new one numbered
 .IR \+-N .
 .
 .TPx
 .REQ .br
-Line break.
+Break output line.
 .
 .TPx
 .REQ .brp
-Break output line; adjust if applicable.
+Break output line;
+adjust if applicable.
 .
 .TPx
 .REQ .break
@@ -1304,9 +2612,10 @@
 .dquoted_char \aq .
 .
 .TPx
-.REQ .c2 "c"
-Set no-break control character to
-.IR c .
+.REQ .c2 "o"
+Recognize ordinary character
+.I o
+as no-break control character.
 .
 .TPx
 .REQ .cc
@@ -1314,79 +2623,109 @@
 .squoted_char . .
 .
 .TPx
-.REQ .cc "c"
-Set control character to
-.IR c .
+.REQ .cc "o"
+Recognize ordinary character
+.I o
+as the control character.
 .
 .TPx
 .REQ .ce
-Center the next input line.
+Break,
+center the output of the next productive input line without filling,
+and break again.
 .
 .TPx
-.REQ .ce "N"
-Center following
-.I N
-input lines.
+.REQ .ce npl
+Break,
+center the output of the next
+.I npl
+productive input lines without filling,
+then break again.
+.
+If
+.I npl
+\<= 0,
+stop centering.
 .
 .TPx
-.REQ .cf "filename"
-Copy contents of file
-.I filename
-unprocessed to stdout or to the diversion.
+.REQ .cf file
+Copy contents of
+.I file
+without formatting to the (top-level) diversion.
 .
 .TPx
-.REQ .cflags "mode c1 c2 \fR\&.\|.\|.\&\fP"
-Treat characters
+.REQ .cflags "n c1 c2 \fR\&.\|.\|.\&\fP"
+Assign properties encoded
+.RI by\~ n
+to characters
 .IR c1 ,
 .IR c2 ,
-\&.\|.\|.\&
-according to
-.I mode
-number.
+and so on.
+.
 .
 .TPx
-.REQ .ch "trap N"
-Change
-.I trap
-location
-to
-.IR N .
+.REQ .ch name
+Unplant page location trap
+.IR name .
+.
 .
 .TPx
-.REQ .char "c anything"
-Define entity
+.REQ .ch "name vpos"
+Change page location trap
+.I name
+planted by
+.request .wh
+by moving its location to
+.I vpos
+(default scaling unit\~\c
+.scaleindicator v ).
+.
+.
+.TPx
+.REQ .char "c contents"
+Define ordinary or special character
 .I c
-as string
-.IR anything .
+as
+.IR contents .
 .
 .TPx
-.REQ .chop "object"
-Chop the last character off macro, string, or diversion
+.REQ .chop object
+Remove the last character from the macro,
+string,
+or diversion
+named
 .IR object .
 .
 .TPx
 .REQ .class "name c1 c2 \fR\&.\|.\|.\&\fP"
-Assign a set of characters, character ranges, or classes
+Define a (character) class
+.I name
+comprising the characters or range expressions
 .IR c1 ,
 .IR c2 ,
-\&.\|.\|.\&
-to
-.IR name .
+and so on.
 .
 .TPx
 .REQ .close "stream"
 Close the
 .IR stream .
 .
+.
 .TPx
 .REQ .color
-Enable colors.
+Enable output of color-related device-independent output commands.
+.
 .
 .TPx
-.REQ .color "N"
+.REQ .color n
 If
-.I N
-is zero disable colors, otherwise enable them.
+.I n
+is zero,
+disable output of color-related device-independent output commands;
+otherwise,
+enable them.
+.\" XXX: Should probably interpret negative values as false.
+.
 .
 .TPx
 .REQ .composite "from to"
@@ -1405,232 +2744,332 @@
 Enable compatibility mode.
 .
 .TPx
-.REQ .cp "N"
+.REQ .cp n
 If
-.I N
-is zero disable compatibility mode, otherwise enable it.
+.I n
+is zero,
+disable compatibility mode,
+otherwise enable it.
 .
 .TPx
-.REQ .cs "font N M"
+.REQ .cs "font n m"
 Set constant character width mode for
 .I font
 to
-.IR N /36
+.IR n /36
 ems with em
-.IR M .
+.IR m .
+.\" XXX: m parameter needs more explanation.
+.
 .
 .TPx
-.REQ .cu "N"
-Continuous underline in nroff, like
-.request .ul
-in troff.
+.REQ .cu
+Continuously underline the output of the next productive input line.
+.
+.
+.TPx
+.REQ .cu npl
+Continuously underline the output of the next
+.I npl
+productive input lines.
+.
+If
+.IR npl =0,
+stop continuously underlining.
+.
 .
 .TPx
 .REQ .da
-End current diversion.
+Stop appending output to current diversion.
+.
 .
 .TPx
-.REQ .da "macro"
-Divert and append to
-.IR macro .
+.REQ .da name
+Append output to diversion
+.IR name .
+.
 .
 .TPx
-.REQ .de "macro"
+.REQ .de macro
 Define or redefine
 .I macro
 until
-.B ..\&
-is encountered.
+.RB \lq ..\& \rq
+occurs at the start of a control line in the current conditional block.
+.
 .
 .TPx
 .REQ .de "macro end"
 Define or redefine
 .I macro
 until
-.BI . end
-is called.
+.I end
+is invoked or called at the start of a control line in the current
+conditional block.
+.
 .
 .TPx
 .REQ .de1 "macro"
-Same as
-.request .de
-but with compatibility mode switched off during macro expansion.
+As
+.request .de ,
+but disable compatibility mode during macro expansion.
 .
 .TPx
 .REQ .de1 "macro end"
-Same as
-.request .de
-but with compatibility mode switched off during macro expansion.
+As
+.RB \lq .de
+.IR "macro end" \rq,
+but disable compatibility mode during macro expansion.
+.
 .
 .TPx
-.REQ .defcolor "color scheme component"
-Define or redefine a color with name
-.IR color .
+.REQ .defcolor "ident scheme color-component \fR.\|.\|."
+Define a color named
+.I ident.
+.
 .I scheme
-can be
-.BR rgb ,
-.BR cym ,
-.BR cymk ,
-.BR gray ,
+identifies a color space and determines the number of required
+.IR color-component s;
+it must be one of
+.RB \lq rgb \rq
+(three components),
+.RB \lq cmy \rq
+(three),
+.RB \lq cmyk \rq
+(four),
+or
+.RB \lq gray \rq
+(one).
+.
+.RB \lq grey \rq
+is accepted as a synonym of
+.RB \lq gray \rq.
+.
+The color components can be encoded as a single hexadecimal value
+starting with
+.B #
 or
-.BR grey .
-.I component
-can be single components specified as fractions in the range 0 to 1
-(default scaling indicator\~\c
-.scaleindicator f ),
-as a string of two-digit hexadecimal color components with a leading
-.BR # ,
-or as a string of four-digit hexadecimal components with two leading
-.BR # .
-The color
-.B default
-can't be redefined.
+.BR ## .
+.
+The former indicates that each component is in the range 0\en255
+(0\enFF),
+the latter the range 0\en65,535 (0\enFFFF).
+.
+Alternatively,
+each color component can be specified as a decimal fraction in the range
+0\en1,
+interpreted using a default scaling unit
+.RB of\~\lq f \rq,
+which multiplies its value by 65,536
+(but clamps it at 65,535).
+.
+Each output device has a color named
+.RB \lq default \rq,
+which cannot be redefined.
+.
+A device's default stroke and fill colors are not necessarily the same.
+.
 .
 .TPx
 .REQ .dei "macro"
-Define or redefine a macro whose name is contained in the string
-register
+Define macro indirectly.
+.
+As
+.request .de ,
+but use interpolation of string
 .I macro
-until
-.B ..\&
-is encountered.
+as the name of the defined macro.
+.
 .
 .TPx
 .REQ .dei "macro end"
-Define or redefine a macro indirectly.
+Define macro indirectly.
+.
+As
+.request .de ,
+but use interpolations of strings
 .I macro
 and
 .I end
-are string registers whose contents are interpolated for the macro name
-and the end macro, respectively.
+as the names of the defined and end macros.
+.
 .
 .TPx
 .REQ .dei1 "macro"
-Same as
-.request .dei
-but with compatibility mode switched off during macro expansion.
+As
+.request .dei ,
+but disable compatibility mode during macro expansion.
+.
 .
 .TPx
 .REQ .dei1 "macro end"
-Same as
-.request .dei
-but with compatibility mode switched off during macro expansion.
+As
+.request ".dei\~\fImacro\~end\f" ,
+but disable compatibility mode during macro expansion.
 .
 .TPx
 .REQ .device "anything"
 Write
-.I anything
-to the intermediate output as a device control function.
+.IR anything ,
+read in copy mode,
+to
+.I @g@troff
+output as a device control command.
+.
+An initial neutral double quote is stripped to allow embedding of
+leading spaces.
 .
 .TPx
 .REQ .devicem "name"
 Write contents of macro or string
 .I name
-uninterpreted to the intermediate output as a device control function.
+to
+.I @g@troff
+output as a device control command.
 .
 .TPx
 .REQ .di
-End current diversion.
+Stop directing output to current diversion.
+.
 .
 .TPx
-.REQ .di "macro"
-Divert to
-.IR macro .
-See
-.BR groff_tmac (@MAN5EXT@)
-for more details.
+.REQ .di name
+Direct output to diversion
+.IR name .
 .
 .TPx
-.REQ .do "name"
-Interpret
-.BI . name
+.REQ .do "name \fR\&.\|.\|.\&\fP"
+Interpret the string,
+request,
+diversion,
+or macro
+.I name
+(along with any arguments)
 with compatibility mode disabled.
 .
+Compatibility mode is restored
+(only if it was active)
+when the
+.I expansion
+of
+.I name
+is interpreted.
+.
 .TPx
-.REQ .ds "stringvar anything"
-Set
-.I stringvar
-to
-.IR anything .
+.REQ .ds name
+Create empty string
+.IR name .
 .
 .TPx
-.REQ .ds1 "stringvar anything"
-Same as
-.request .ds
-but with compatibility mode switched off during string expansion.
+.REQ .ds "name contents"
+Create a string
+.I name
+containing
+.IR contents .
 .
 .TPx
-.REQ .dt "N trap"
-Set diversion trap to position
-.I N
-(default scaling indicator\~\c
+.REQ .ds1 name
+.TQ
+.REQ .ds1 "name contents"
+As
+.request .ds ,
+but with compatibility mode disabled when
+.I contents
+interpolated.
+.
+.TPx
+.REQ .dt
+Clear diversion trap.
+.
+.
+.TPx
+.REQ .dt "vertical-position name"
+Set the diversion trap to macro
+.I name
+at
+.I vertical-position
+(default scaling unit\~\c
 .scaleindicator v ).
 .
+.
 .TPx
 .REQ .ec
-Reset escape character to
-.squoted_char \rs .
+Recognize
+.B \rs
+as the escape character.
+.
 .
 .TPx
-.REQ .ec "c"
-Set escape character to
-.IR c .
+.REQ .ec "o"
+Recognize ordinary character
+.I o
+as the escape character.
+.
 .
 .TPx
 .REQ .ecr
 Restore escape character saved with
-.request .ecs\c
-\&.
+.request .ecs .
+.
 .
 .TPx
 .REQ .ecs
-Save current escape character.
+Save the escape character.
+.
 .
 .TPx
 .REQ .el "anything"
-Else part for if-else (\c
-.request .ie\c
-)
-request.
+Interpret
+.I anything
+as if it were an input line if the conditional expression of the
+corresponding
+.request .ie
+request was false.
+.
 .
 .TPx
-.REQ .em "macro"
-The
-.I macro
-is run after the end of input.
+.REQ .em name
+Call macro
+.I name
+after the end of input.
+.
 .
 .TPx
 .REQ .eo
-Turn off escape character mechanism.
+Disable the escape mechanism in interpretation mode.
+.
 .
 .TPx
 .REQ .ev
-Switch to previous environment and pop it off the stack.
+Pop environment stack,
+returning to previous one.
+.
 .
 .TPx
 .REQ .ev "env"
-Push down environment number or name
-.I env
-to the stack and switch to it.
+Push current environment onto stack and switch to
+.IR env .
+.
 .
 .TPx
 .REQ .evc "env"
-Copy the contents of environment
+Copy environment
 .I env
-to the current environment.
-No pushing or popping.
+to the current one.
+.
 .
 .TPx
 .REQ .ex
-Exit from roff processing.
+Exit with successful status.
+.
 .
 .TPx
 .REQ .fam
-Return to previous font family.
+Set default font family to previous value.
 .
 .TPx
 .REQ .fam "name"
-Set the current font family to
+Set default font family to
 .IR name .
 .
 .TPx
@@ -1651,44 +3090,52 @@
 .IR b .
 .
 .TPx
-.REQ .fchar "c anything"
+.REQ .fchar "c contents"
 Define fallback character (or glyph)
 .I c
-as string
-.IR anything .
+as
+.IR contents .
+.
 .
 .TPx
 .REQ .fcolor
-Set fill color to previous fill color.
+Restore previous fill color.
+.
 .
 .TPx
 .REQ .fcolor "c"
 Set fill color to
 .IR c .
 .
+.
 .TPx
 .REQ .fi
-Fill output lines.
+Enable filling of output lines;
+a pending output line is broken.
+.
+Sets
+.BR \rsn.u .
+.
 .
 .TPx
 .REQ .fl
 Flush output buffer.
 .
 .TPx
-.REQ .fp "n font"
-Mount
-.I font
-on position
-.IR n .
+.REQ .fp "pos id"
+Mount font with font description file name
+.I id
+at non-negative
+.RI position\~ n .
 .
 .TPx
-.REQ .fp "n internal external"
-Mount font with long
-.I external
-name to short
-.I internal
-name on position
-.IR n .
+.REQ .fp "pos id font-description-file-name"
+Mount font with
+.I font-description-file-name
+as name
+.I id
+at non-negative
+.RI position\~ n .
 .
 .TPx
 .REQ .fschar "f c anything"
@@ -1717,21 +3164,31 @@
 .
 .TPx
 .REQ .ft
-Return to previous font.
-Same as
-.request \rs
+.TQ
+.REQ ".ft P"
+Select previous font mounting position
+(abstract style or font);
+same as
+.esc f
 or
-.request \rs\c
-\&.
+.esc fP .
 .
 .TPx
 .REQ .ft "font"
-Change to font name or number
-.IR font ;
+Select typeface
+.I font,
+which can be a
+mounting position,
+abstract style,
+or font name;
 same as
 .esc f font
 escape sequence.
 .
+.I font
+cannot be
+.BR P .
+.
 .TPx
 .REQ .ftr "font1 font2"
 Translate
@@ -1740,36 +3197,45 @@
 .IR font2 .
 .
 .TPx
-.REQ .fzoom "font"
-Don't magnify
+.REQ .fzoom font
+.TQ
+.REQ .fzoom font\~\fCB0\f
+Stop magnifying
 .IR font .
 .
 .TPx
-.REQ .fzoom "font zoom"
+.REQ .fzoom "font z"
 Set zoom factor for
 .I font
-(in multiples of 1/1000th).
+.RI to\~ z
+(in thousandths;
+default:
+1000).
 .
 .TPx
 .REQ .gcolor
-Set glyph color to previous glyph color.
+Restore previous stroke color.
+.
 .
 .TPx
 .REQ .gcolor "c"
-Set glyph color to
+Set stroke color to
 .IR c .
 .
+.
 .TPx
 .REQ .hc
-Remove additional hyphenation indicator character.
+Reset the hyphenation character
+.RB to\~ \rs%
+(the default).
 .
 .TPx
-.REQ .hc "c"
-Set up additional hyphenation indicator character\~\c
-.IR c .
+.REQ .hc char
+Change the hyphenation character
+.RI to\~ char .
 .
 .TPx
-.REQ .hcode "c1 code1 \fR\fPc2 code2\fR\fP \fR\&.\|.\|.\&\fP"
+.REQ .hcode "c1 code1 \fR\fPc2 code2\fR .\|.\|.\fP"
 Set the hyphenation code of character
 .I c1
 to
@@ -1778,297 +3244,462 @@
 .I c2
 to
 .IR code2 ,
-etc.
+and so on.
 .
 .TPx
-.REQ .hla "lang"
-Set the current hyphenation language to
+.REQ .hla lang
+Set the hyphenation language to
 .IR lang .
 .
 .TPx
-.REQ .hlm "n"
-Set the maximum number of consecutive hyphenated lines to
+.REQ .hlm n
+Set the maximum quantity of consecutive hyphenated lines to
 .IR n .
 .
 .TPx
-.REQ .hpf "file"
+.REQ .hpf pattern-file
 Read hyphenation patterns from
-.IR file .
+.IR pattern-file .
 .
 .TPx
-.REQ .hpfa "file"
+.REQ .hpfa pattern-file
 Append hyphenation patterns from
-.IR file .
+.IR pattern-file .
 .
 .TPx
-.REQ .hpfcode "a b c d \fR\&.\|.\|.\&\fP"
-Set input mapping for
-.request .hpf\c
-\&.
+.REQ .hpfcode "a b \fR\fPc d\fR .\|.\|.\fP"
+Define mappings for character codes in hyphenation pattern files read
+with
+.request .hpf
+and
+.request .hpfa .
 .
 .TPx
-.REQ .hw "words"
-List of
-.I words
-with exceptional hyphenation.
+.REQ .hw "word \fR.\|.\|.\fP"
+Define hyphenation overrides for each
+.I word;
+a hyphen
+.RB \lq \- \rq
+indicates a hyphenation point.
+.
 .
 .TPx
-.REQ .hy "N"
-Switch to hyphenation mode
-.IR N .
+.REQ .hy
+Set automatic hyphenation mode to
+.BR 1 .
+.
 .
 .TPx
-.REQ .hym "n"
-Set the hyphenation margin to
-.I n
-(default scaling indicator\~\c
+.REQ .hy\~0
+Disable automatic hyphenation;
+same as
+.BR .nh .
+.
+.
+.TPx
+.REQ .hy mode
+Set automatic hyphenation mode to
+.IR mode ;
+see section \lqHyphenation\rq below.
+.
+.
+.TPx
+.REQ .hym
+Set the (right) hyphenation margin to
+.B 0
+(the default).
+.
+.TPx
+.REQ .hym length
+Set the (right) hyphenation margin to
+.I length
+(default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
-.REQ .hys "n"
+.REQ .hys
 Set the hyphenation space to
-.IR n .
+.B 0
+(the default).
 .
 .TPx
-.REQ .ie "cond anything"
+.REQ .hys hyphenation-space
+Suppress automatic hyphenation in adjustment modes
+.RB \lq b \rq
+or
+.RB \lq n \rq
+if the line can be justified with the addition of up to
+.I hyphenation-space
+to each inter-word space
+(default scaling unit\~\c
+.scaleindicator m ).
+.
+.
+.TPx
+.REQ .ie "cond-expr anything"
 If
-.I cond
-then
+.I cond-expr
+is true,
+interpret
 .I anything
-else goto
-.request .el\c
-\&.
+as if it were an input line,
+otherwise skip to a corresponding
+.request .el
+request.
+.
 .
 .TPx
-.REQ .if "cond anything"
+.REQ .if "cond-expr anything"
 If
-.I cond
-then
-.IR anything ;
-otherwise do nothing.
+.I cond-expr
+is true,
+then interpret
+.I anything
+as if it were an input line.
+.
 .
 .TPx
 .REQ .ig
-Ignore text until
-.B ..\&
-is encountered.
+Ignore input
+(except for side effects of
+.B \rsR
+on auto-incrementing registers)
+until
+.RB \lq ..\& \rq
+occurs at the start of a control line in the current conditional block.
+.
 .
 .TPx
 .REQ .ig "end"
-Ignore text until
+Ignore input
+(except for side effects of
+.B \rsR
+on auto-incrementing registers)
+until
 .BI . end
-is called.
+is called at the start of a control line in the current conditional
+block.
 .
 .TPx
 .REQ .in
-Change to previous indentation value.
+Set indentation amount to previous value.
 .
 .TPx
 .REQ .in "\+-N"
-Change indentation according to
+Set indentation to
 .I \+-N
-(default scaling indicator\~\c
+(default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
-.REQ .it "N trap"
-Set an input-line count trap for the next
-.I N
-lines.
+.REQ .it
+Cancel any pending input line trap.
 .
 .TPx
-.REQ .itc "N trap"
-Same as
-.request .it
-but don't count lines interrupted with
-.esc c .
+.REQ .it "npl name"
+Set
+(or replace)
+an input line trap in the environment,
+calling macro
+.IR name ,
+after the next
+.I npl
+productive input lines have been read.
+.
+Lines interrupted with the
+.B \rsc
+escape sequence are counted separately.
+.
+.TPx
+.REQ .itc
+Cancel any pending input line trap.
+.
+.TPx
+.REQ .itc "npl name"
+As
+.request .it ,
+except that input lines interrupted with the
+.B \rsc
+escape sequence are not counted.
 .
 .TPx
 .REQ .kern
 Enable pairwise kerning.
 .
 .TPx
-.REQ .kern "n"
+.REQ .kern n
 If
 .I n
-is zero, disable pairwise kerning, otherwise enable it.
+is zero,
+disable pairwise kerning,
+otherwise enable it.
 .
 .TPx
 .REQ .lc
-Remove leader repetition glyph.
+Unset leader repetition character.
 .
 .TPx
 .REQ .lc "c"
-Set leader repetition glyph to\~\c
-.IR c .
+Set leader repetition character
+.RI to\~ c
+(default:
+.RB \lq . \rq).
 .
 .TPx
-.REQ .length "register anything"
-Write the length of the string
+.REQ .length "reg anything"
+Compute the number of characters of
 .I anything
-to
-.IR register .
+and store the count
+in the register
+.IR reg .
+.
 .
 .TPx
 .REQ .linetabs
-Enable line-tabs mode (i.e., calculate tab positions relative to output
-line).
+Enable line-tabs mode
+(calculate tab positions relative to beginning of output line).
+.
 .
 .TPx
-.REQ .linetabs "n"
-If
-.I n
-is zero, disable line-tabs mode, otherwise enable it.
+.REQ .linetabs\~0
+Disable line-tabs mode.
+.
 .
 .TPx
-.REQ .lf "N"
-Set input line number to
-.IR N .
+.REQ .lf n
+Set number of next input line to
+.IR n .
+.\" XXX: negative values accepted; check AT&T troff
 .
 .TPx
-.REQ .lf "N file"
-Set input line number to
-.I N
-and filename to
+.REQ .lf "n file"
+Set number of next input line to
+.I n
+and input file name to
 .IR file .
 .
 .TPx
-.REQ .lg "N"
-Ligature mode on if
-.IR N >0.
+.REQ .lg m
+Set ligature mode to
+.I m
+.RB ( 0
+= disable,
+.B 1
+= enable,
+.B 2
+= enable for two-letter ligatures only).
+.\" XXX: negative values accepted (mapped to 1); check AT&T troff
 .
 .TPx
 .REQ .ll
-Change to previous line length.
+Set line length to previous value.
+.
+Does not affect a pending output line.
 .
 .TPx
 .REQ .ll "\+-N"
-Set line length according to
+Set line length to
 .I \+-N
 (default length
 .scalednumber 6.5 i ,
-default scaling indicator\~\c
+default scaling unit\~\c
 .scaleindicator m ).
 .
+Does not affect a pending output line.
+.
 .TPx
 .REQ .lsm
-Unset the leading spaces macro.
+Unset the leading space macro (trap).
+.
+Restore default handling of lines with leading spaces.
 .
 .TPx
-.REQ .lsm "macro"
-Set the leading spaces macro to
-.IR macro .
+.REQ .lsm name
+Set the leading space macro (trap) to
+.IR name .
 .
 .TPx
 .REQ .ls
 Change to the previous value of additional intra-line skip.
 .
 .TPx
-.REQ .ls "N"
+.REQ .ls n
 Set additional intra-line skip value to
-.IR N ,
+.IR n ,
 i.e.,
-.IR N \-1
+.IR n \-1
 blank lines are inserted after each text output line.
+.\" XXX: negative values accepted; check AT&T troff
+.
+.TPx
+.REQ .lt
+Set length of title lines to previous value.
 .
 .TPx
 .REQ .lt "\+-N"
-Length of title (default scaling indicator\~\c
+Set length of title lines
+(default length
+.scalednumber 6.5 i ,
+default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
 .REQ .mc
-Margin glyph off.
+Cease writing margin character.
 .
 .TPx
-.REQ .mc "c"
-Print glyph\~\c
-.I c
-after each text line at actual distance from right margin.
+.REQ .mc c
+Begin writing margin
+.RI character\~ c
+to the right of each output line.
+.
+.TPx
+.REQ .mc "c d"
+Begin writing margin
+.RI character\~ c
+on each output line at
+.RI distance\~ d
+to the right of the right margin
+(default distance
+.scalednumber 10 p ,
+default scaling unit\~\c
+.scaleindicator m ).
 .
 .TPx
-.REQ .mc "c N"
-Set margin glyph to\~\c
-.I c
-and distance to\~\c
-.I N
-from right margin (default scaling indicator\~\c
-.scaleindicator m ).
+.REQ .mk
+Mark vertical drawing position in an internal register;
+see
+.BR .rt .
 .
 .TPx
-.REQ .mk "\fR\fPregister\fR\fP"
-Mark current vertical position in
-.IR register ,
-or in an internal register used by
-.B .rt
-if no argument.
+.REQ .mk register
+Mark vertical drawing position in
+.IR register .
 .
 .TPx
 .REQ .mso "file"
-The same as
-.request .so
+As
+.request .so ,
 except that
 .I file
-is searched in the tmac directories.
+is sought in the
+.I tmac
+directories.
+.
+.
+.TPx
+.REQ .msoquiet "file"
+As
+.request .mso ,
+but no warning is emitted if
+.I file
+does not exist.
+.
 .
 .TPx
 .REQ .na
-No output-line adjusting.
+Disable output line adjustment.
+.
 .
 .TPx
 .REQ .ne
-Need a one-line vertical space.
+Break page if distance to next page location trap is less than one vee.
 .
 .TPx
-.REQ .ne "N"
-Need
-.I N
-vertical space (default scaling indicator\~\c
+.REQ .ne d
+Break page if distance to next page location trap is less than distance
+.I d
+(default scaling unit\~\c
 .scaleindicator v ).
 .
+.
 .TPx
 .REQ .nf
-No filling or adjusting of output lines.
+Disable filling of output lines;
+a pending output line is broken.
+.
+Clears
+.BR \rsn.u .
+.
 .
 .TPx
 .REQ .nh
-No hyphenation.
+Disable automatic hyphenation;
+same as
+.RB \lq ".hy 0" \rq.
 .
 .TPx
 .REQ .nm
-Number mode off.
+Deactivate output line numbering.
 .
 .TPx
-.REQ .nm "\+-N \fR\fPM \fR\fPS \fR\fPI\fR\fP"
-In line number mode, set number, multiple, spacing, and indentation.
+.REQ .nm \+-N
+.TQ
+.REQ .nm "\+-N m"
+.TQ
+.REQ .nm "\+-N m s"
+.TQ
+.REQ .nm "\+-N m s i"
+Activate output line numbering:
+number the next output line
+.I \+-N,
+writing numbers every
+.I m
+lines,
+with
+.I s
+numeral widths
+.RB ( \rs0 )
+between the line number and the output
+(default 1),
+and indenting the line number by
+.I i
+numeral widths
+(default 0).
 .
 .TPx
 .REQ .nn
-Do not number next line.
+Suppress numbering of the next output line to be numbered with
+.BR nm .
 .
 .TPx
-.REQ .nn "N"
-Do not number next
-.I N
-lines.
+.REQ .nn n
+Suppress numbering of the next
+.I n
+output lines to be numbered with
+.BR nm .
+.
+If
+.IR n =0,
+cancel suppression.
+.\" XXX: negative values accepted; check AT&T troff
+.
 .
 .TPx
 .REQ .nop "anything"
-Always process
-.IR anything .
+Interpret
+.I anything
+as if it were an input line.
 .
 .TPx
-.REQ .nr "register \+-N \fR\fPM\fR\fP"
-Define or modify
-.I register
-using
-.I \+-N
-with auto-increment
-.IR M .
+.REQ .nr "reg \+-N"
+Define or update register
+.I reg
+with value
+.IR N .
+.
+.TPx
+.REQ .nr "reg \+-N I"
+Define or update register
+.I reg
+with value
+.I N
+and auto-increment
+.IR I .
 .
 .TPx
 .REQ .nroff
-Make the built-in conditions
+Make the conditional expressions
 .B n
 true and
 .B t
@@ -2076,42 +3707,59 @@
 .
 .TPx
 .REQ .ns
-Turn on no-space mode.
+Enable
+.IR "no-space mode" ,
+ignoring
+.B .sp
+requests until a glyph or
+.B \rsD
+primitive is output.
+.
+See
+.BR .rs .
 .
 .TPx
 .REQ .nx
 Immediately jump to end of current file.
 .
 .TPx
-.REQ .nx "filename"
-Immediately continue processing with file
-.IR file .
+.REQ .nx file
+Stop formatting current file and begin reading
+.I file.
 .
 .TPx
-.REQ .open "stream filename"
+.REQ .open "stream file"
 Open
-.I filename
+.I file
 for writing and associate the stream named
 .I stream
 with it.
 .
+Unsafe request;
+disabled by default.
+.
 .TPx
-.REQ .opena "stream filename"
-Like
-.request .open
-but append to it.
+.REQ .opena "stream file"
+As
+.request .open ,
+but append to
+.I file.
+.
+Unsafe request;
+disabled by default.
 .
 .TPx
 .REQ .os
 Output vertical distance that was saved by the
-.request sv
+.request .sv
 request.
 .
 .TPx
-.REQ .output "string"
+.REQ .output contents
 Emit
-.I string
-directly to intermediate output, allowing leading whitespace if
+.I contents
+directly to intermediate output,
+allowing leading whitespace if
 .I string
 starts with
 \&\fCB\dq\f
@@ -2126,39 +3774,46 @@
 .REQ .pc "c"
 Page number character.
 .
+.
 .TPx
 .REQ .pev
-Print the current environment and each defined environment
-state to stderr.
+Report the state of the current environment followed by that of all
+other environments to the standard error stream.
 .
 .TPx
 .REQ .pi "program"
 Pipe output to
 .I program
-(nroff only).
+.RI ( nroff
+only).
+.
+Unsafe request;
+disabled by default.
 .
 .TPx
 .REQ .pl
 Set page length to default
 .scalednumber 11 i .
-The current page length is stored in
-.register .p\c
-\&.
+The current page length is stored in register
+.BR .p .
 .
 .TPx
 .REQ .pl "\+-N"
 Change page length to
 .I \+-N
-(default scaling indicator\~\c
+(default scaling unit\~\c
 .scaleindicator v ).
 .
 .TPx
 .REQ .pm
-Print macro names and sizes (number of blocks of 128 bytes).
-.
-.TPx
-.REQ .pm "t"
-Print only total of sizes of macros (number of 128 bytes blocks).
+Report,
+to the standard error stream,
+the names and sizes in bytes of
+defined
+macros,
+strings,
+and
+diversions.
 .
 .TPx
 .REQ .pn "\+-N"
@@ -2167,46 +3822,64 @@
 .
 .TPx
 .REQ .pnr
-Print the names and contents of all currently defined number registers
-on stderr.
+Write the names and contents of all defined registers to the standard
+error stream.
 .
 .TPx
 .REQ .po
 Change to previous page offset.
 .
-The current page offset is available in
-.register .o\c
-\&.
+The current page offset is available in register
+.BR .o .
 .
 .TPx
 .REQ .po "\+-N"
 Page offset
 .IR N .
 .
+.
 .TPx
 .REQ .ps
-Return to previous point size.
+Return to previous type size.
 .TPx
+.
+.
 .REQ .ps "\+-N"
-Point size; same as
+Set/increase/decrease the type size to/by
+.I N
+scaled points
+(a non-positive resulting type size is set to 1\~u);
+also see
 .esc s \+-N .
 .
 .TPx
-.REQ .psbb "filename"
-Get the bounding box of a PostScript image
-.IR filename .
+.REQ .psbb file
+Retrieve the bounding box of the PostScript image found in
+.I file,
+which must conform to Adobe's Document Structuring Conventions (DSC).
+.
+See registers
+.BR llx ,
+.BR lly ,
+.BR urx ,
+.BR ury .
 .
 .TPx
-.REQ .pso "command"
-This behaves like the
-.request so
-request except that input comes from the standard output of
-.IR command .
+.REQ .pso "command-line"
+Execute
+.I command-line
+with
+.MR popen 3
+and interpolate its output.
+.
+Unsafe request;
+disabled by default.
 .
 .TPx
 .REQ .ptr
-Print the names and positions of all traps (not including input line
-traps and diversion traps) on stderr.
+Report names and positions of all page location traps to the standard
+error stream.
+.
 .
 .TPx
 .REQ .pvs
@@ -2216,15 +3889,20 @@
 .REQ .pvs "\+-N"
 Change post-vertical line spacing according to
 .I \+-N
-(default scaling indicator\~\c
+(default scaling unit\~\c
 .scaleindicator p ).
 .
 .TPx
-.REQ .rchar "c1 c2 \fR\&.\|.\|.\&\fP"
-Remove the definitions of entities
+.REQ .rchar "c1 c2 \fR.\|.\|.\&\fP"
+Remove definition of each ordinary or special character
 .IR c1 ,
 .IR c2 ,
-\&.\|.\|.\&
+\&.\|.\|.\& defined by a
+.request .char ,
+.request .fchar ,
+or
+.request .schar
+request.
 .
 .TPx
 .REQ .rd "prompt"
@@ -2241,18 +3919,31 @@
 .
 .TPx
 .REQ .rfschar "f c1 c2 \fR\&.\|.\|.\&\fP"
-Remove the definitions of entities
+Remove the font-specific definitions of glyphs
 .IR c1 ,
 .IR c2 ,
-\&.\|.\|.\&
-for font
-.IR f .
+\&.\|.\|.\& for
+.RI font\~ f .
 .
 .TPx
-.REQ .rj "n"
-Right justify the next
-.I n
-input lines.
+.REQ .rj npl
+Break,
+right-align the output of the next productive input line without
+filling,
+then break again.
+.
+.TPx
+.REQ .rj npl
+Break,
+right-align the output of the next
+.I npl
+productive input lines without filling,
+then break again.
+.
+If
+.I npl
+\<= 0,
+stop right-aligning.
 .
 .TPx
 .REQ .rm "name"
@@ -2273,14 +3964,20 @@
 to
 .IR reg2 .
 .
+.
 .TPx
-.REQ .rr "register"
-Remove
-.IR register .
+.REQ .rr ident
+Remove register
+.IR ident .
+.
 .
 .TPx
 .REQ .rs
-Restore spacing; turn no-space mode off.
+Restore spacing;
+disable no-space mode.
+.
+See
+.BR .ns .
 .
 .TPx
 .REQ .rt
@@ -2291,61 +3988,108 @@
 on the current page.
 .
 .TPx
-.REQ .rt "\+-N"
+.REQ .rt N
 Return
 .I (upward only)
-to specified distance from the top of the page (default scaling
-indicator\~\c
+to vertical position
+.I N
+(default scaling
+unit\~\c
 .scaleindicator v ).
+.\" XXX: negative values accepted; check AT&T troff
 .
 .TPx
-.REQ .schar "c anything"
+.REQ .schar "c contents"
 Define global fallback character (or glyph)\~\c
 .I c
-as string
-.IR anything .
+as
+.IR contents .
+.
 .
 .TPx
 .REQ .shc
-Reset soft hyphen glyph to
-.esc (hy .
+Reset the soft hyphen character to
+.esc hy .
+.
 .
 .TPx
-.REQ .shc "c"
-Set the soft hyphen glyph to\~\c
-.IR c .
+.REQ .shc c
+Set the soft hyphen character
+.RI to\~ c .
+.
 .
 .TPx
-.REQ .shift "n"
-In a macro, shift the arguments by
+.REQ .shift n
+In a macro definition,
+left-shift arguments by
 .IR n \~\c
 positions.
 .
 .TPx
-.REQ .sizes "s1 s2 \fR\&.\|.\|.\&\fP s\fRn\fP \fR\fB0\fP\fR\fP"
-Set available font sizes similar to the
+.REQ .sizes "s1 s2 \fR.\|.\|.\&\f sn \fR\fCB0\f"
+Set available type sizes similarly to the
 .B sizes
-command in a
+directive in a
 .I DESC
 file.
 .
+Each
+.IR s i
+is interpreted in units of scaled points (\c
+.scaleindicator z ).
+.
+.
+.TPx
+.REQ .so file
+Replace the request's control line with the contents of
+.IR file ,
+\lqsourcing\rq it.
+.
+.
 .TPx
-.REQ .so "filename"
-Include source file.
+.REQ .soquiet file
+As
+.request .so ,
+but no warning is emitted if
+.I file
+does not exist.
+.
 .
 .TPx
 .REQ .sp
-Skip one line vertically.
+Break and move the next text baseline down by one vee,
+or until springing a page location trap.
+.
 .
 .TPx
-.REQ .sp "N"
-Space vertical distance
-.I N
-up or down according to sign of
-.I N
-(default scaling indicator\~\c
+.REQ .sp dist
+Break and move the next text baseline down by
+.IR dist ,
+or until springing a page location trap
+(default scaling unit\~\c
 .scaleindicator v ).
 .
+A negative
+.I dist
+will not reduce the position of the text baseline below zero.
+.
+Prefixing
+.I dist
+with the
+.B \or
+operator moves to a position relative to the page top for positive
+.IR N ,
+and the bottom if
+.I N
+is negative;
+in all cases,
+one line height (vee) is added
+.RI to\~ dist .
+.
+.I dist
+is ignored inside a diversion.
+.
+.
 .TPx
 .REQ .special
 Reset global list of special fonts to be empty.
@@ -2360,70 +4104,111 @@
 .
 .TPx
 .REQ .spreadwarn
-Toggle the spread warning on and off without changing its value.
+Toggle the spread warning on and off (the default) without changing its
+value.
 .
 .TPx
-.REQ .spreadwarn "limit"
-Emit a warning if each space in an output line is widened by
-.I limit
-or more (default scaling indicator\~\c
-.scaleindicator m ).
+.REQ .spreadwarn N
+Emit a
+.B break
+warning if the additional space inserted for each space between words in
+an adjusted output line is greater than or equal to
+.IR N .
+.
+A negative
+.I N
+is treated as 0.
+.
+The default scaling unit is\~\c
+.scaleindicator m .
+.
+At startup,
+.request .spreadwarn
+is inactive and
+.I N
+is
+.scalednumber "3 m" .
+.\" XXX: negative values accepted; retain for future space-squeezing
+.
+.TPx
+.REQ .ss n
+Set minimal inter-word spacing to
+.IR n \~12ths
+of current font's space width.
+.
+.TPx
+.REQ .ss "n m"
+As
+.RB \lq .ss\~\c
+.IR n \rq,
+and set additional inter-sentence space to
+.IR m \~12ths
+of current font's space width.
 .
 .TPx
-.REQ .ss "N"
-Set space glyph size to
-.IR N /12
-of the space width in the current font.
+.REQ .stringdown stringvar
+Replace each byte in the string named
+.I stringvar
+with its lowercase version.
 .
 .TPx
-.REQ .ss "N M"
-Set space glyph size to
-.IR N /12
-and sentence space size set to
-.IR M /12
-of the space width in the current font.
+.REQ .stringup stringvar
+Replace each byte in the string named
+.I stringvar
+with its uppercase version.
 .
 .TPx
 .REQ .sty "n style"
-Associate
+Associate abstract
 .I style
 with font position
 .IR n .
 .
 .TPx
-.REQ .substring "xx n1 n2"
+.REQ .substring "str start \fR\fPend\fR\fP"
 Replace the string named
-.I xx
-with the substring defined by the indices
-.I n1
+.I str
+with its substring bounded by the indices
+.I start
 and
-.IR n2 .
+.IR end ,
+inclusive.
+.
+Negative indices count backwards from the end of the string.
 .
 .TPx
 .REQ .sv
-Save
+As
+.request .ne ,
+but save
 .scalednumber "1 v"
-of vertical space.
+for output with
+.request .os
+request.
+.
 .TPx
-.REQ .sv "N"
-Save the vertical distance
-.I N
+.REQ .sv d
+As
+.request .ne ,
+but save distance
+.I d
 for later output with
-.request os
-request (default scaling indicator\~\c
+.request .os
+request
+(default scaling unit\~\c
 .scaleindicator v ).
+.\" XXX: negative values accepted; check AT&T troff
 .
 .TPx
 .REQ .sy "command-line"
-Execute program
-.IR command-line .
+Execute
+.I command-line
+with
+.MR system 3 .
+.
+Unsafe request;
+disabled by default.
 .
-.TPx
-.REQ .ta "T N"
-Set tabs after every position that is a multiple of
-.I N
-(default scaling indicator\~\c
-.scaleindicator m ).
 .TPx
 .REQ .ta "n1 n2 \fR\&.\|.\|.\&\fP n\fRn\fP \fCBT\f r1 r2 \
 \fR\&.\|.\|.\&\fP r\fRn\fP"
@@ -2438,27 +4223,56 @@
 .IR n n+ m \tmu r n+ r n,
 where
 .I m
-increments from 0, 1, 2, \&.\|.\|.\& to infinity.
+increments from 0,
+1,
+2,
+\&.\|.\|.\& to the output line length.
+.
+Each
+.IR n \~argument
+can be prefixed with
+.RB a\~\lq + \rq
+to place the tab stop
+.I ni
+at a distance relative to the previous,
+.IR n ( i \-1).
+.
+Each argument
+.IR ni \~or\~ ri
+can be suffixed with a letter to align text within the tab column
+bounded by tab stops
+.IR i \~and\~ i +1;
+.RB \lq L \rq
+for left-aligned
+(the default),
+.RB \lq C \rq
+for centered,
+and
+.RB \lq R \rq
+for right-aligned.
 .
-.\".TPx
-.\".REQ .tar
-.\"Restore internally saved tab positions.
-.\".
-.\".TPx
-.\".REQ .tas
-.\"Save tab positions internally.
+.br
+.ne 4v \" XXX: should need only 2v
+.TPx
+.REQ .tag
+.TQ
+.REQ .taga
+Reserved for internal use.
 .
 .TPx
 .REQ .tc
-Remove tab repetition glyph.
+Unset tab repetition character.
+.
 .TPx
 .REQ .tc "c"
-Set tab repetition glyph to\~\c
-.IR c .
+Set tab repetition character
+.RI to\~ c
+(default: none).
 .
 .TPx
 .REQ .ti "\+-N"
-Temporary indent next line (default scaling indicator\~\c
+Temporarily indent next output line
+(default scaling unit\~\c
 .scaleindicator m ).
 .
 .TPx
@@ -2467,135 +4281,200 @@
 .IR font .
 .
 .TPx
-.REQ .tl "\fCB\cq\fleft\fCB\cq\fcenter\fCB\cq\fright\
-\fCB\cq\f"
-Three-part title.
+.REQ .tl "\fCB\aq\fleft\fCB\aq\fcenter\fCB\aq\fright\
+\fCB\aq\f"
+Format three-part title.
 .
 .TPx
-.REQ .tm "anything"
-Print
-.I anything
-on stderr.
-.
-.TPx
-.REQ .tm1 "anything"
-Print
-.I anything
-on stderr, allowing leading whitespace if
-.I anything
-starts with
-\&\fCB\dq\f
-(which is stripped off).
-.
-.TPx
-.REQ .tmc "anything"
-Similar to
-.request .tm1
-without emitting a final newline.
+.REQ .tm message
+Write
+.I message,
+followed by a newline,
+to the standard error stream.
+.
+.TPx
+.REQ .tm1 message
+As
+.request .tm ,
+but an initial neutral double quote in
+.I message
+is removed,
+allowing it to contain leading spaces.
+.
+.TPx
+.REQ .tmc message
+As
+.request .tm1 ,
+without emitting a newline.
 .
 .TPx
 .REQ .tr "abcd\fR\&.\|.\|.\&\fP"
-Translate
+Translate ordinary or special characters
 .I a
 to
 .IR b ,
 .I c
 to
 .IR d ,
-etc.\& on output.
+and so on prior to output.
 .
 .TPx
-.REQ .trf "filename"
-Transparently output the contents of file
-.IR filename .
+.REQ .trf file
+Transparently output the contents of
+.I file.
+.
+Unlike
+.request .cf ,
+invalid input characters in
+.I file
+are rejected.
 .
 .TPx
 .REQ .trin "abcd\fR\&.\|.\|.\&\fP"
-This is the same as the
-.request tr
-request except that the
-.B asciify
-request uses the character code (if any) before the character
-translation.
+As
+.request .tr ,
+except that
+.request .asciify
+ignores the translation when a diversion is interpolated.
 .
 .TPx
 .REQ .trnt "abcd\fR\&.\|.\|.\&\fP"
-This is the same as the
-.request tr
-request except that the translations do not apply to text that is
-transparently throughput into a diversion with
+As
+.request .tr ,
+except that translations are suppressed in the argument to
 .esc ! .
 .
 .TPx
 .REQ .troff
-Make the built-in conditions
+Make the conditional expressions
 .B t
 true and
 .B n
 false.
 .
 .TPx
-.REQ .uf "font"
-Set underline font to
-.I font
-(to be switched to by
-.request .ul\c
-).
+.REQ .uf font
+Set underline font used by
+.request .ul
+to
+.I font.
+.
 .
 .TPx
-.REQ .ul "N"
-Underline (italicize in troff)
-.I N
-input lines.
+.REQ .ul
+Underline
+(italicize in
+.I troff
+mode)
+the output of the next productive input line.
+.
+.
+.TPx
+.REQ .ul npl
+Underline
+(italicize in
+.I troff
+mode)
+the output of the next
+.I npl
+productive input line.
+.
+If
+.IR npl =0,
+stop underlining.
+.
 .
 .TPx
 .REQ .unformat "diversion"
 Unformat space characters and tabs in
 .IR diversion ,
 preserving font information.
+.
+.
 .TPx
-.REQ .vpt "n"
-Enable vertical position traps if
-.I n
-is non-zero, disable them otherwise.
+.REQ .vpt
+Enable vertical position traps.
+.
+.
+.TPx
+.REQ .vpt\~0
+Disable vertical position traps.
+.
 .
 .TPx
 .REQ .vs
-Change to previous vertical base line spacing.
+Change to previous vertical spacing.
 .
 .TPx
 .REQ .vs "\+-N"
-Set vertical base line spacing to
+Set vertical spacing to
 .I \+-N
-(default scaling indicator\~\c
+(default scaling unit\~\c
 .scaleindicator p ).
 .
+.
 .TPx
-.REQ .warn "n"
-Set warnings code to
-.IR n .
+.REQ .warn
+Enable all warning categories.
+.
 .
 .TPx
-.REQ .warnscale "si"
-Set scaling indicator used in warnings to
-.IR si .
+.REQ .warn\~0
+Disable all warning categories.
+.
 .
 .TPx
-.REQ .wh "N"
-Remove (first) trap at position
-.IR N .
+.REQ .warn n
+Enable warnings in categories whose codes sum
+.RI to\~ n ;
+.\" TODO: Move that table here, perhaps.
+see
+.MR @g@troff @MAN1EXT@ .
+.
+.
+.TPx
+.REQ .warnscale "su"
+Set scaling unit used in certain warnings \" `output_warning()`
+to
+.I su
+(one of
+.BR u ,
+.BR i ,
+.BR c ,
+.BR p ,
+or
+.BR P ;
+default:
+.BR i ).
+.
+.
+.TPx
+.REQ .wh vpos
+Remove visible page location trap at
+.I vpos
+(default scaling unit\~\c
+.scaleindicator v ).
+.
 .
 .TPx
-.REQ .wh "N trap"
-Set location trap; negative means from page bottom.
+.REQ .wh "vpos name"
+Plant macro
+.I name
+as page location trap at
+.I vpos
+(default scaling unit\~\c
+.scaleindicator v ),
+removing any visible trap already there.
+.
 .
 .TPx
-.REQ .while "cond anything"
-While condition
-.I cond
-is true, accept
+.REQ .while "cond-expr anything"
+Repeatedly execute
 .I anything
-as input.
+unless and until
+.I cond-expr
+evaluates false.
+.
 .
 .TPx
 .REQ .write "stream anything"
@@ -2617,334 +4496,252 @@
 to the stream named
 .IR stream .
 .
-.PD
-.
-.
-.P
-Besides these standard groff requests, there might be further macro
-calls.
-They can originate from a macro package (see
-.BR roff (@MAN7EXT@)
-for an overview) or from a preprocessor.
-.
-.
-.P
-Preprocessor macros are easy to recognize.
-.
-They enclose their code between a pair of characteristic macros.
-.
-.
-.P
-.TS
-box, center, tab (^);
-c | c | c
-CfCB | CfCB | CfCB.
-preprocessor^start macro^ end macro
-=
-@g@chem^.cstart^.cend
-@g@eqn^.EQ^.EN
-grap^.G1^.G2
-@g@grn^.GS^.GE
-.\" Keep the .IF line below the @g@ideal line.
-@g@ideal^.IS^.IE
-^^.IF
-@g@pic^.PS^.PE
-@g@refer^.R1^.R2
-@g@soelim^\fInone^\fInone
-@g@tbl^.TS^.TE
-_
-glilypond^.lilypond start^.lilypond stop
-gperl^.Perl start^.Perl stop
-gpinyin^.pinyin start^.pinyin stop
-.TE
-.
-.
-.P
-Note that the \oq@g@ideal\cq preprocessor is not available in groff
-yet.
+.LE
 .
 .
 .\" ====================================================================
-.SH "ESCAPE SEQUENCES"
+.SH "Escape sequence short reference"
 .\" ====================================================================
 .
-Escape sequences are in-line language elements usually introduced by a
-backslash
-.squoted_char \rs
-and followed by an escape name and sometimes by a required argument.
-.
-Input processing is continued directly after the escaped character or
-the argument (without an intervening separation character).
-.
-So there must be a way to determine the end of the escape name and the
-end of the argument.
-.
-.
-.P
-This is done by enclosing names (escape name and arguments consisting
-of a variable name) by a pair of brackets
-.BI \lB name \rB
-and constant arguments (number expressions and characters) by
-apostrophes (ASCII 0x27) like
-.BI \cq constant \cq \fR.
-.
-.
-.P
-There are abbreviations for short names.
-.
-Two-character escape names can be specified by an opening parenthesis
-like
-.esc ( xy
-or
-.esc *( xy
-without a closing counterpart.
-.
-And all one-character names different from the special characters
-.squoted_char 
+The escape sequences
+.esc \dq ,
+.esc # ,
+.esc $ ,
+.esc * ,
+.esc ? ,
+.esc a ,
+.esc e ,
+.esc n ,
+.esc t ,
+.esc g ,
+.esc V ,
 and
-.squoted_char (
-can even be specified without a marker, for example
-.esc n c
-or
-.esc $ c.
-.
-.
-.P
-Constant arguments of length\~1 can omit the marker apostrophes, too,
-but there is no two-character analogue.
+.escarg \& newline
+are interpreted even in copy mode.
 .
 .
 .P
-While one-character escape sequences are mainly used for in-line
-functions and system-related tasks, the two-letter names following the
-.esc (
-construct are glyphs predefined by the roff system; these are called
-\oqSpecial Characters\cq in the classical documentation.
-.
-Escapes sequences of the form
-.esc "" name
-denote glyphs too.
-.
-.
-.\" ====================================================================
-.SS "Single-Character Escapes"
-.\" ====================================================================
-.
-.PD 0
+.LS
 .
 .\" ========= comments =========
 .
 .TP
 .ESC \dq
-Start of a comment.
+Comment.
 .
 Everything up to the end of the line is ignored.
 .
+.
 .TP
 .ESC #
-Everything up to and including the next newline is ignored.
+Comment.
 .
-This is interpreted in copy mode.
+Everything up to and including the next newline is ignored.
 .
-This is like
-.esc \dq
-except that the terminating newline is ignored as well.
 .
 .\" ========= strings =========
 .
 .TP
 .ESC * s
-The string stored in the string variable with one-character name\~\c
-.IR s .
+Interpolate string with one-character
+.RI name\~ s .
+.
 .
 .TP
 .ESC *( st
-The string stored in the string variable with two-character name
-.IR st .
+Interpolate string with two-character
+.RI name\~ st .
+.
 .
 .TP
 .ESC * string
-The string stored in the string variable with name
+Interpolate string with name
 .I string
-(with arbitrary length).
+(of arbitrary length).
+.
 .
 .TP
-.ESC * "stringvar arg1 arg2 \fR\&.\|.\|.\fP"
-The string stored in the string variable with arbitrarily long name
-.IR stringvar ,
+.ESC * "string arg \fR\&.\|.\|.\fP"
+Interpolate string with name
+.I string
+(of arbitrary length),
 taking
-.IR arg1 ,
-.IR arg2 ,
+.I arg
 \&.\|.\|.\&
 as arguments.
 .
+.
 .\" ========= macro arguments =========
 .
 .TP
 .ESC $0
-The name by which the current macro was invoked.
+Interpolate name by which currently executing macro was invoked.
 .
-The
-.request als
-request can make a macro have more than one name.
 .
 .TP
-.ESC $ x
-Macro or string argument with one-digit number\~\c
-.I x
-in the range 1 to\~9.
+.ESC $ n
+Interpolate macro or string parameter
+.RI numbered\~ n
+.RI (1\|\<=\| n \|\<=\|9).
+.
 .
 .TP
-.ESC $( xy
-Macro or string argument with two-digit number
-.I xy
-(larger than zero).
+.ESC $( nn
+Interpolate macro or string parameter
+.RI numbered\~ nn
+.RI (01\|\<=\| nn \|\<=\|99).
 .
 .TP
-.ESC $ nexp
-Macro or string argument with number
-.IR nexp ,
-where
-.I nexp
-is a numerical expression evaluating to an integer \>=1.
+.ESC $ nnn
+Interpolate macro or string parameter
+.RI numbered\~ nnn
+.RI ( nnn \|\>=\|1).
+.
 .
 .TP
 .ESC $*
-In a macro or string, the concatenation of all the arguments separated
-by spaces.
+Interpolate concatenation of all macro or string parameters,
+separated by spaces.
+.
 .
 .TP
 .ESC $@
-In a macro or string, the concatenation of all the arguments with each
-surrounded by double quotes, and separated by spaces.
+Interpolate concatenation of all macro or string parameters,
+with each surrounded by double quotes and separated by spaces.
+.
 .
 .TP
-.ESC $^
-In a macro, the representation of all parameters as if they were an
-argument to the
-.request ds
+.ESC $\ha
+Interpolate concatenation of all macro or string parameters
+as if they were arguments to the
+.request .ds
 request.
 .
-.\" ========= escaped characters =========
 .
-.TP
-.ESC \e
-reduces to a single backslash; useful to delay its interpretation as
-escape character in copy mode.
+.\" ========= escaped characters =========
 .
-For a printable backslash, use
-.esc e ,
-or even better
-.esc rs ,
-to be independent from the current escape character.
 .
 .TP
-.ESC \aa
-The acute accent \aa; same as
-.esc (aa .
-Unescaped: apostrophe, right quotation mark, single quote (ASCII 0x27).
+.ESC \aq
+is a synonym for
+.esc aa ,
+the acute accent special character.
+.
 .
 .TP
 .ESC \ga
-The grave accent \ga; same as
-.esc (ga .
-Unescaped: left quote, backquote (ASCII 0x60).
+is a synonym for
+.esc ga ,
+the grave accent special character.
+.
 .
 .TP
 .ESC \-
-The \- (minus) sign in the current font.
+is a synonym for
+.esc \- ,
+the minus sign special character.
+.
 .
 .TP
 .ESC _
-The same as
-.esc (ul ,
-the underline character.
+is a synonym for
+.esc ul ,
+the underrule special character.
 .
-.TP
-.ESC .
-The same as a dot (\oq.\cq).
-Necessary in nested macro definitions so that \oq\rs\rs..\cq\&
-expands to \oq..\cq.
 .
 .TP
 .ESC %
-Default optional hyphenation character.
+Control hyphenation.
+.
 .
 .TP
 .ESC !
-Transparent line indicator.
+Transparent line.
+.
+The remainder of the input line is interpreted
+(1) when the current diversion is read;
+or
+(2) if in the top-level diversion,
+by the postprocessor
+(if any).
+.
 .
 .TP
 .ESC? anything
-In a diversion, this transparently embeds
-.I anything
-in the diversion.
-.I anything
-is read in copy mode.
+Transparently embed
+.IR anything ,
+read in copy mode,
+in a diversion,
+or unformatted as an output comparand in a conditional expression.
 .
-See also the escape sequences
-.esc !
-and
-.esc ? .
 .
+.\" ========= spaces and fixed-width horizontal motions =========
+.
+.TP
+.ESC \fIspace
+Move right one word space.
 .
-.\" ========= spacing =========
 .
 .TP
-.ESC \& space
-Unpaddable space size space glyph (no line break).
+.ESC \ti
+Insert an unbreakable,
+adjustable space.
+.
 .
 .TP
 .ESC 0
-Digit-width space.
+Move right by the width of a numeral in the current font.
+.
 .
 .TP
 .ESC |
-1/6\ em narrow space glyph; zero width in nroff.
+Move one-sixth em to the right on typesetters.
+.
 .
 .TP
-.ESC ^
-1/12\ em half-narrow space glyph; zero width in nroff.
+.ESC \ha
+Move one-twelfth em to the right on typesetters.
+.
 .
 .TP
 .ESC &
-Non-printable, zero-width glyph.
+Interpolate a dummy character.
+.
 .
 .TP
 .ESC )
-Like
-.esc &
-except that it behaves like a glyph declared with the
-.request cflags
-request to be transparent for the purposes of end-of-sentence
+Interpolate a dummy character that is transparent to end-of-sentence
 recognition.
 .
+.
 .TP
 .ESC /
-Increases the width of the preceding glyph so that the spacing
-between that glyph and the following glyph is correct if
-the following glyph is a roman glyph.
+Apply italic correction.
+.
+Use between an immediately adjacent oblique glyph on the left and an
+upright glyph on the right.
+.
 .
 .TP
 .ESC ,
-Modifies the spacing of the following glyph so that the spacing
-between that glyph and the preceding glyph is correct if the
-preceding glyph is a roman glyph.
+Apply left italic correction.
+.
+Use between an immediately adjacent upright glyph on the left and an
+oblique glyph on the right.
 .
-.TP
-.ESC ~
-Unbreakable space that stretches like a normal inter-word space when a
-line is adjusted.
 .
 .TP
 .ESC :
-Inserts a zero-width break point (similar to
-.esc %
-but without a soft hyphen character).
+Non-printing break point
+(similar to
+.esc % ,
+but never produces a hyphen glyph).
+.
 .
 .TP
 .ESC "" newline
-Ignored newline, for continuation lines.
+Continue current input line on the next.
+.
 .
 .\" ========= structuring =========
 .
@@ -2959,1512 +4756,2929 @@
 .\" ========= longer escape names =========
 .
 .TP
-.ESC ( sc
-A glyph with two-character name
-.IR sc ;
-see section \lqSpecial Characters\rq below.
+.ESC ( gl
+Interpolate glyph with two-character name
+.IR gl .
+.
 .
 .TP
-.ESC "" name
-A glyph with name
-.I name
+.ESC "" glyph
+Interpolate glyph with name
+.I glyph
 (of arbitrary length).
 .
+.
 .TP
-.ESC "" "comp1 comp2 \fR\&.\|.\|.\&\fP"
-A composite glyph with components
-.IR comp1 ,
-.IR comp2 ,
-\&.\|.\|.\&
+.ESC "" "base-char comp \fR\&.\|.\|."
+Interpolate composite glyph constructed from
+.I base-char
+and each component
+.IR comp .
+.
+.
+.TP
+.ESC "" "\fCBchar\fnnn"
+Interpolate glyph of eight-bit encoded character
+.IR nnn ,
+where
+.RI 0\|\<=\| nnn \|\<=\|255.
+.
+.
+.TP
+.ESC "" "\fCBu\fnnnn\fR\fn\fR\fn\fR"
+Interpolate glyph of Unicode character with code point
+.IR nnnn  n  n 
+in uppercase hexadecimal.
+.
+.
+.TP
+.ESC "" "\fCBu\fbase-char\fR\f\fCB_\f\
+combining-component\fR.\|.\|."
+Interpolate composite glyph from Unicode character
+.I base-char
+and
+.IR combining-components .
+.
 .
-.\" ========= alphabetical escapes =========
+.\" ========= alphabetical escape sequences =========
 .
 .TP
 .ESC a
-Non-interpreted leader character.
+Interpolate a leader in copy mode.
 .
 .TP
 .ESCq A anything
-If
+Interpolate 1 if
 .I anything
-is acceptable as a name of a string, macro, diversion, register,
-environment or font it expands to\~1, and to\~0 otherwise.
+is a valid identifier,
+and\~0 otherwise.
 .
 .TP
-.ESCq b abc\fR\&.\|.\|.\&\fP
-Bracket building function.
+.ESCq b string
+Build bracket:
+pile a sequence of glyphs corresponding to each character in
+.I string
+vertically,
+and center it vertically on the output line.
 .
 .TP
 .ESCq B anything
-If
+Interpolate 1 if
 .I anything
-is acceptable as a valid numeric expression it expands to\~1, and
-to\~0 otherwise.
+is a valid numeric expression,
+and\~0 otherwise.
+.
 .
 .TP
 .ESC c
 Continue output line at next input line.
-Anything after this escape on the same line is ignored except
-.ESC R
-(which works as usual).
-Anything before
-.ESC c
-on the same line is appended to the current partial output line.
-The next non-command line after a line interrupted with
-.ESC c
-counts as a new input line.
+.
 .
 .TP
 .ESCq C glyph
-The glyph called
-.IR glyph ;
-same as
+As
 .esc "" glyph ,
-but compatible to other roff versions.
+but compatible with other
+.I troff \" generic
+implementations.
+.
 .
 .TP
 .ESC d
-Forward (down) 1/2 em (1/2 line in nroff).
+Move downward \12\~em on typesetters.
+.\" XXX: No current groff nroff-mode output driver supports half-line
+.\" motions.
+.\" (\12\~line in
+.\" .I nroff
+.\" contingent on device support).
+.
 .
 .TP
-.ESCq D charseq
-Draw a graphical element defined by the characters in
-.IR charseq ;
-see the
-.I groff
-Texinfo manual for details.
+.ESCq D drawing-command
+See subsection \lqDrawing commands\rq below.
+.
 .
 .TP
 .ESC e
-Printable version of the current escape character.
+Interpolate the escape character.
+.
 .
 .TP
 .ESC E
-Equivalent to an escape character, but is not interpreted in copy mode.
+As
+.esc e ,
+but not interpreted in copy mode.
 .
 .TP
-.ESC f F
-Change to font with one-character name or one-digit number\~\c
-.IR F .
+.ESC fP
+Select previous font mounting position
+(abstract style or font);
+same as
+.RB \lq .ft \rq
+or
+.RB \lq .ft\~P \rq.
 .
 .TP
-.ESC fP
-Switch back to previous font.
+.ESC f F
+Select font mounting position,
+abstract style,
+or font with one-character name or one-digit
+.RI position\~ F .
+.
+.IR F \~cannot
+be
+.BR P .
 .
 .TP
-.ESC f( fo
-Change to font with two-character name or two-digit number
-.IR fo .
+.ESC f( ft
+Select font mounting position,
+abstract style,
+or font with two-character name or two-digit
+.RI position\~ ft .
 .
 .TP
 .ESC f font
-Change to font with arbitrarily long name or number expression
+Select font mounting position,
+abstract style,
+or font with arbitrarily long name or position
 .IR font .
 .
+.I font
+cannot be
+.BR P .
+.
 .TP
 .ESC f ""
-Switch back to previous font.
+Select previous font mounting position
+(abstract style or font).
 .
 .TP
 .ESC F f
-Change to font family with one-character name\~\c
-.IR f .
+Set default font family to that with one-character
+.RI name\~ f .
 .
 .TP
 .ESC F( fm
-Change to font family with two-character name
-.IR fm .
+Set default font family to that with two-character
+.RI name\~ fm .
 .
 .TP
 .ESC F fam
-Change to font family with arbitrarily long name
+Set default font family to that with arbitrarily long name
 .IR fam .
 .
 .TP
 .ESC F ""
-Switch back to previous font family.
+Set default font family to previous value.
 .
 .TP
 .ESC g r
-Return format of register with one-character name\~\c
-.I r
-suitable for
-.request af
-request.
+Interpolate format of register with one-character
+.RI name\~ r .
+.
 .
 .TP
 .ESC g( rg
-Return format of register with two-character name
-.I rg
-suitable for
-.request af
-request.
+Interpolate format of register with two-character
+.RI name\~ rg .
+.
 .
 .TP
 .ESC g reg
-Return format of register with arbitrarily long name
-.I reg
-suitable for
-.request af
-request.
+Interpolate format of register with arbitrarily long name
+.IR reg .
+.
 .
 .TP
 .ESCq h N
-Local horizontal motion; move right
-.I N
-(left if negative).
+Horizontally move the drawing position by
+.IR N \~ems
+(or specified units);
+.B \or
+may be used.
+.
+Positive motion is rightward.
+.
 .
 .TP
 .ESCq H N
 Set height of current font to
-.IR N .
+.IR N \~scaled
+points
+(or specified units).
+.
 .
 .TP
 .ESC k r
-Mark horizontal input place in one-character register\~\c
-.IR r .
+Mark horizontal position in one-character register
+.RI name\~ r .
 .
 .TP
 .ESC k( rg
-Mark horizontal input place in two-character register
-.IR rg .
+Mark horizontal position in two-character register
+.RI name\~ rg .
+.
 .
 .TP
 .ESC k reg
-Mark horizontal input place in register with arbitrarily long name
-.IR reg .
+Mark horizontal position in register with arbitrarily long
+.RI name\~ reg .
+.
 .
 .TP
-.ESCq l Nc
-Horizontal line drawing function (optionally using character
-.IR c ).
+.ESCq l N\/\fR\fc\fR
+Draw horizontal line of length
+.I N
+with character
+.B c
+(default:
+.BR \rsru ;
+default scaling unit\~\c
+.scaleindicator m ).
+.
+.
 .
 .TP
-.ESCq L Nc
-Vertical line drawing function (optionally using character
-.IR c ).
+.ESCq L N\/\fR\fc\fR
+Draw vertical line of length
+.I N
+with character
+.B c
+(default:
+.BR \rsbr ;
+default scaling unit\~\c
+.scaleindicator v ).
+.
 .
 .TP
 .ESC m c
-Change to color with one-character name\~\c
-.IR c .
+Set stroke color to that with one-character
+.RI name\~ c .
+.
 .
 .TP
 .ESC m( cl
-Change to color with two-character name
-.IR cl .
+Set stroke color to that with two-character
+.RI name\~ cl .
+.
 .
 .TP
 .ESC m color
-Change to color with arbitrarily long name
-.IR color .
+Set stroke color to that with arbitrarily long
+.RI name\~ color .
+.
 .
 .TP
 .ESC m ""
-Switch back to previous color.
+Restore previous stroke color.
+.
 .
 .TP
 .ESC M c
-Change filling color for closed drawn objects to color with
-one-character name\~\c
-.IR c .
+Set fill color to that with one-character
+.RI name\~ c .
+.
 .
 .TP
 .ESC M( cl
-Change filling color for closed drawn objects to color with
-two-character name
-.IR cl .
+Set fill color to that with two-character
+.RI name\~ cl .
+.
 .
 .TP
 .ESC M color
-Change filling color for closed drawn objects to color with
-arbitrarily long name
-.IR color .
+Set fill color to that with arbitrarily long
+.RI name\~ color .
+.
 .
 .TP
 .ESC M ""
-Switch to previous fill color.
+Restore previous fill color.
+.
 .
+.br
+.ne 4v \" XXX: why not 3v?
 .TP
 .ESC n r
-The numerical value stored in the register variable with the
-one-character name\~\c
-.IR r .
+Interpolate contents of register with one-character
+.RI name\~ r .
+.
 .
 .TP
-.ESC n( re
-The numerical value stored in the register variable with the
-two-character name
-.IR re .
+.ESC n( rg
+Interpolate contents of register with two-character
+.RI name\~ rg .
+.
 .
 .TP
 .ESC n reg
-The numerical value stored in the register variable with arbitrarily
-long name
-.IR reg .
+Interpolate contents of register with arbitrarily long
+.RI name\~ reg .
+.
 .
 .TP
 .ESCq N n
-Typeset the glyph with index\~\c
-.I n
+Interpolate glyph with
+.RI index\~ n
 in the current font.
 .
-No special fonts are searched.
-.
-Useful for adding (named) entities to a document using the
-.request char
-request and friends.
-.
 .TP
-.ESCq o abc\fR\&.\|.\|.\&\fP
-Overstrike glyphs
+.ESCq o abc\fR.\|.\|.\f
+Overstrike centered glyphs of characters
 .IR a ,
 .IR b ,
 .IR c ,
-etc.
+and so on.
 .
 .TP
 .ESC O0
-Disable glyph output.
+At the outermost suppression level,
+disable emission of glyphs and geometric objects to the output
+driver.
 .
-Mainly for internal use.
 .
 .TP
 .ESC O1
-Enable glyph output.
+At the outermost suppression level,
+enable emission of glyphs and geometric objects to the output driver.
+.
+.
+.TP
+.ESC O2
+At the outermost suppression level,
+enable glyph and geometric primitive emission to the output driver and
+write to the standard error stream the page number,
+four bounding box registers enclosing glyphs written since the previous
+.B \rsO
+escape sequence,
+the page offset,
+line length,
+image file name
+(if any),
+horizontal and vertical device motion quanta,
+and input file name.
+.
+.
+.TP
+.ESC O3
+Begin a nested suppression level.
+.
+.
+.TP
+.ESC O4
+End a nested suppression level.
+.
+.
+.TP
+.ESC O "\fCB5\fPfile"
+At the outermost suppression level,
+write the name
+.I file
+to the standard error stream at
+.RI position\~ P ,
+which must be one of
+.BR l ,
+.BR r ,
+.BR c ,
+or
+.BR i .
 .
-Mainly for internal use.
 .
 .TP
 .ESC p
-Break output line at next word boundary; adjust if applicable.
+Break output line at next word boundary;
+adjust if applicable.
+.
 .
 .TP
 .ESC r
-Reverse 1\ em vertical motion (reverse line in nroff).
+Move \lqin reverse\rq (upward) 1\~em.
+.
 .
 .TP
-.ESCq R "name\~\+-n"
-The same as
-.request .nr
+.ESCq R "name\~\+-N"
+Set,
+increment,
+or decrement register
 .I name
-.IR \+-n .
+.RI by\~ N .
+.
 .
 .TP
 .ESC s \+-N
-Set/increase/decrease the point size to/by
+Set/increase/decrease the type size to/by
 .I N
-scaled points;
+scaled points.
+.
 .I N
-is a one-digit number in the range 1 to\~9.
+must be a single digit;
+0 restores the previous type size.
 .
-Same as
-.request ps
+(In compatibility mode only,
+a non-zero
+.I N
+must be in the range 4\en39.)
+.
+Otherwise,
+as
+.request .ps
 request.
 .
+.
 .TP
 .ESC s( \+-N
 .TQ
-.ESC s\+-( N
-Set/increase/decrease the point size to/by
+.fam C
+.BI \es \+- ( N
+.fam
+Set/increase/decrease the type size to/by
 .I N
 scaled points;
 .I N
 is a two-digit number \>=1.
 .
-Same as
-.request ps
+As
+.request .ps
 request.
 .
+.
 .TP
 .ESC s \+-N
 .TQ
-.ESC s\+- N
+.fam C
+.BI \es \+-  N 
+.fam
 .TQ
 .ESCq s \+-N
 .TQ
-.ESCq s\+- N
-Set/increase/decrease the point size to/by
+.fam C
+.BI \es \+- \aq N \aq
+.fam
+Set/increase/decrease the type size to/by
 .I N
 scaled points.
 .
-Same as
-.request ps
+As
+.request .ps
 request.
 .
+.
 .TP
 .ESCq S N
-Slant output by
+Slant output glyphs by
 .I N
-degrees.
+degrees;
+the direction of text flow is positive.
+.
 .
 .TP
 .ESC t
-Non-interpreted horizontal tab.
+Interpolate a tab in copy mode.
+.
 .
 .TP
 .ESC u
-Reverse (up) 1/2 em vertical motion (1/2 line in nroff).
+Move upward \12\~em on typesetters.
+.\" XXX: No current groff nroff-mode output driver supports half-line
+.\" motions.
+.\" (\12\~line in
+.\" .I nroff
+.\" contingent on device support).
+.
 .
 .TP
 .ESCq v N
-Local vertical motion; move down
-.I N
-(up if negative).
+Vertically move the drawing position by
+.IR N \~vees
+(or specified units);
+.B \or
+may be used.
+.
+Positive motion is downward.
+.
 .
 .TP
 .ESC V e
-The contents of the environment variable with one-character
-name\~\c
-.IR e .
+Interpolate contents of environment variable with one-character
+.RI name\~ e .
+.
 .
 .TP
 .ESC V( ev
-The contents of the environment variable with two-character name
-.IR ev .
+Interpolate contents of environment variable with two-character
+.RI name\~ ev .
+.
 .
 .TP
 .ESC V env
-The contents of the environment variable with arbitrarily long name
-.IR env .
+Interpolate contents of environment variable with arbitrarily long
+.RI name\~ env .
+.
 .
 .TP
-.ESCq w string
-The width of the glyph sequence
-.IR string .
+.ESCq w anything
+Interpolate width of
+.IR anything ,
+formatted in a dummy environment.
+.
 .
 .TP
 .ESCq x N
-Extra line-space function (negative before, positive after).
+Increase vertical spacing of pending output line by
+.IR N \~vees
+(or specified units;
+negative before,
+positive after).
 .
 .TP
-.ESCq X string
-Output
-.I string
-as device control function.
+.ESCq X anything
+Write
+.I anything
+to
+.I @g@troff
+output as a device control command.
+.
+Within
+.IR anything ,
+the escape sequences
+.BR \rs& ,
+.BR \rs) ,
+.BR \rs% ,
+and
+.B \rs:
+are ignored;
+.BI \rs space
+and
+.B \rs\ti
+are converted to single space characters;
+and
+.B \rs\rs
+has its escape character stripped.
+.
+So that the basic Latin subset of the Unicode character
+set can be reliably encoded in
+.I anything,
+the special character escape sequences
+.BR \rs\- ,
+.BR \rsaq ,
+.BR \rsdq ,
+.BR \rsga ,
+.BR \rsha ,
+.BR \rsrs ,
+and
+.B \rsti
+are mapped to basic Latin characters;
+see
+.MR groff_char @MAN7EXT@ .
+.
+For this transformation,
+character translations and special character definitions are ignored.
 .
 .TP
 .ESC Y n
-Output string variable or macro with one-character name\~\c
+Write contents of macro or string
 .I n
-uninterpreted as device control function.
+to
+.I @g@troff
+output as a device control command.
 .
 .TP
 .ESC Y( nm
-Output string variable or macro with two-character name
+Write contents of macro or string
 .I nm
-uninterpreted as device control function.
+to
+.I @g@troff
+output as a device control command.
 .
 .TP
 .ESC Y name
-Output string variable or macro with arbitrarily long name
+Write contents of macro or string
 .I name
-uninterpreted as device control function.
+to
+.I @g@troff
+output as a device control command.
 .
 .TP
 .ESC z c
-Print
+Format character
 .I c
-with zero width (without spacing).
+with zero width\emwithout advancing the drawing position.
 .
 .TP
 .ESCq Z anything
-Print
-.I anything
-and then restore the horizontal and vertical position;
-.I anything
-may not contain tabs or leaders.
+Save the drawing position,
+format
+.IR anything ,
+then restore it.
+.LE
 .
 .
-.PD
-.P
-The escape sequences
-.esc e ,
-.esc . ,
-.esc \dq ,
-.esc $ ,
-.esc * ,
-.esc a ,
-.esc n ,
-.esc t ,
-.esc g ,
-and
-.escarg \& newline
-are interpreted in copy mode.
-.
+.\" ====================================================================
+.SS "Drawing commands"
+.\" ====================================================================
 .
-.P
-Escape sequences starting with
-.esc (
-or
-.esc 
-do not represent single character escape sequences, but introduce escape
-names with two or more characters.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Drawing
+.\" commands".
+Drawing commands direct the output device to render geometrical objects
+rather than glyphs.
 .
+Specific devices may support only a subset,
+or may feature additional ones;
+consult the man page for the output driver in use.
 .
-.P
-If a backslash is followed by a character that does not constitute a
-defined escape sequence, the backslash is silently ignored and the
-character maps to itself.
+Terminal devices in particular implement almost none.
 .
 .
-.\" ====================================================================
-.SS "Special Characters"
-.\" ====================================================================
+.P
+Rendering starts at the drawing position;
+when finished,
+the drawing position is left at the rightmost point of the object,
+even for closed figures,
+except where noted.
 .
-Note: \oqSpecial Characters\cq is a misnomer; those entities are
-(output) glyphs, not (input) characters.
+GNU
+.I troff \" GNU
+draws stroked (outlined) objects with the stroke color,
+and shades filled ones with the fill color.
 .
+See section \lqColors\rq above.
 .
-.P
-Common special characters are predefined by escape sequences of the
-form
-.BI \e( xy
-with characters
-.I x
+Coordinates
+.I h
 and
-.IR y .
-.
-In
-.IR groff ,
-it is also possible to use the writing
-.BI \e xy 
-as well.
+.I v
+are horizontal and vertical motions relative to the drawing position
+or previous point in the command.
 .
+The default scaling unit for horizontal measurements
+(and diameters of circles)
+.RB is\~ m ;
+for vertical ones,
+.BR v .
 .
-.P
-Some of these special characters exist in the usual font while most of
-them are only available in the special font.
 .
-Below you can see a small selection of the most important glyphs; a
-complete list can be found in
-.BR groff_char (@MAN7EXT@).
-.RS
 .P
-.PD 0
-.
-.TP
-.ESC (Do
-Dollar
-.B \(Do
+Circles,
+ellipses,
+and polygons can be drawn stroked or filled.
 .
-.TP
-.ESC (Eu
-Euro
-.B \(Eu
+These are independent properties;
+if you want a filled,
+stroked figure,
+you must draw the same figure twice using each drawing command.
 .
-.TP
-.ESC (Po
-British pound sterling
-.B \(Po
+A filled figure is always smaller than an outlined one because the
+former is drawn only within its defined area,
+whereas strokes have a line thickness
+(set with
+.BR \rsD\aqt\aq ).
 .
-.TP
-.ESC (aq
-Apostrophe quote
-.B \(aq
 .
+.P
+.LS
 .TP
-.ESC (bu
-Bullet sign
-.B \(bu
+.BI \rsD\aq\ti\~ "h1 v1"\~\c
+.RI .\|.\|.\~ "hn vn"\c
+.B \aq
+Draw B-spline to each point in sequence,
+leaving drawing position at
+.RI ( hn ,\~ vn ).
 .
+.\" XXX: This is one case where a valid coordinate pair could be off the
+.\" page (even negative) and we need to discuss this frankly.
 .TP
-.ESC (co
-Copyright
-.B \(co
+.BI \rsD\aqa\~ "hc vc h v" \aq
+Draw circular arc centered at
+.RI ( hc ,\~ vc )
+counterclockwise from the drawing position to a point
+.RI ( h ,\~ v )
+relative to the center.
 .
-.TP
-.ESC (cq
-Single closing quote (right)
-.B \(cq
-.TP
-.ESC (ct
-Cent
-.B \(ct
+.RI ( hc ,\~ vc )
+is adjusted to the point nearest the perpendicular bisector of the arc's
+chord.
 .
 .TP
-.ESC (dd
-Double dagger
-.B  \(dd
+.BI \rsD\aqc\~ "d" \aq
+Draw circle of diameter
+.I d
+with its leftmost point at the drawing position.
 .
 .TP
-.ESC (de
-Degree
-.B \(de
+.BI \rsD\aqC\~ "d" \aq
+As
+.BR \rsD\aqC\aq ,
+but the circle is filled.
 .
 .TP
-.ESC (dg
-Dagger
-.B \(dg
+.BI \rsD\aqe\~ "h v" \aq
+Draw ellipse of width
+.I h
+and height
+.I v
+with its leftmost point at the drawing position.
 .
+.\" How do we draw an ellipse with rotated axes?
 .TP
-.ESC (dq
-Double quote (ASCII 34)
-.B \(dq
+.BI \rsD\aqE\~ "h v" \aq
+As
+.BR \rsD\aqe\aq ,
+but the ellipse is filled.
 .
+.\" XXX: Df and dF are taken care of by \M and .defcolor.
 .TP
-.ESC (em
-Em-dash
-.B \(em
+.BI \rsD\aql\~ "h v" \aq
+Draw line from the drawing position to
+.RI ( h ,\~ v ).
 .
 .TP
-.ESC (en
-En-dash
-.B \(en
+.BI \rsD\aqp\~ "h1 v1"\~\c
+.RI .\|.\|.\~ "hn vn"\c
+.B \aq
+Draw polygon with vertices at drawing position and each point
+in sequence.
 .
-.TP
-.ESC (hy
-Hyphen
-.B \(hy
+GNU
+.I troff \" GNU
+closes the polygon by drawing a line from
+.RI ( hn ,\~ vn )
+back to the initial drawing position.
 .
-.TP
-.ESC (lq
-Double quote left
-.B \(lq
+.\" XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
+.\" src/libs/libdriver/input.cpp.  It is neither the rightmost point
+.\" of the figure nor the initial drawing position that GNU troff
+.\" automatically returned to to close the figure.
+Afterward,
+the drawing position is left at
+.RI ( hn ,\~ vn ).
 .
 .TP
-.ESC (oq
-Single opening quote (left)
-.B \(oq
+.BI \rsD\aqP\~ "h1 v1"\~\c
+.RI .\|.\|.\~ "hn vn"\c
+.B \aq
+As
+.BR \rsD\aqp\aq ,
+but the polygon is filled.
 .
 .TP
-.ESC (rg
-Registered sign
-.B \(rg
+.BI \rsD\aqt\~ "n" \aq
+Set stroke thickness of geometric objects to
+.RI to\~ n
+basic units.
 .
-.TP
-.ESC (rq
-Double quote right
-.B \(rq
+A zero
+.I n
+selects the minimal supported thickness.
 .
-.TP
-.ESC (rs
-Printable backslash character
-.B \(rs
+A negative
+.I n
+selects a thickness proportional to the type size;
+this is the default.
+.LE
+.\" END Keep (roughly) parallel with groff.texi node "Drawing
+.\" commands".
 .
-.TP
-.ESC (sc
-Section sign
-.B \(sc
 .
-.TP
-.ESC (tm
-Trademark symbol
-.B  \(tm
+.\" ====================================================================
+.SS "Device control commands"
+.\" ====================================================================
 .
-.TP
-.ESC (ul
-Underline character
-.B  \(ul
+The
+.B .device
+and
+.B .devicem
+requests,
+and
+.B \rsX
+and
+.B \rsY
+escape sequences,
+enable documents to pass information directly to a postprocessor.
 .
-.TP
-.ESC (==
-Identical
-.B \(==
+These are useful for
+exercising device-specific capabilities that the
+.I groff
+language does not abstract or generalize;
+such functions include the embedding of hyperlinks and image files.
 .
-.TP
-.ESC (>=
-Larger or equal
-.B \(>=
+Device-specific functions are documented in
+each output driver's man page.
 .
-.TP
-.ESC (<=
-Less or equal
-.B \(<=
 .
-.TP
-.ESC (!=
-Not equal
-.B \(!=
+.\" ====================================================================
+.SH Strings
+.\" ====================================================================
 .
-.TP
-.ESC (->
-Right arrow
-.B \(->
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Strings".
+.I groff
+supports strings primarily for user convenience.
 .
-.TP
-.ESC (<-
-Left arrow
-.B \(<-
+Conventionally,
+if one would define a macro only to interpolate a small amount of text,
+without invoking requests or calling any other macros,
+one defines a string instead.
 .
-.TP
-.ESC (+-
-Plus-minus sign
-.B \(+-
+Only one string is predefined by the language.
 .
-.PD
-.RE
 .
+.TPx
+.STRING .T
+Contains the name of the output device
+(for example,
+.RB \lq utf8 \rq
+or
+.RB \lq pdf \rq ).
 .
-.\" ====================================================================
-.SS "Unicode Characters"
-.\" ====================================================================
 .
-The extended escape
-.B u
-allows the inclusion of all available Unicode characters into a
-.I roff
-file.
+.P
+The
+.request .ds
+request creates a string with a specified name and contents.
 .
+If the identifier named by
+.request .ds
+already exists as an alias,
+the target of the alias is redefined.
 .
-.TP
-.BI \eu xxxx 
-.B u
-is the escape name.
+If
+.request .ds
+is called with only one argument,
+the named string becomes empty.
 .
-.I xxxx
-is a hexadecimal number of four hex digits, such as
-.B 0041
-for the letter
-.BR A ,
-thus
-.BR \eu0041 .
+Otherwise,
+.I @g@troff
+stores the remainder of the control line in copy mode;
+see subsection \lqCopy mode\rq below.
 .
 .
-.TP
-.BI \eu yyyyy 
-.B u
-is the escape name.
+.P
+The
+.esc *
+escape sequence dereferences a string's name,
+interpolating its contents.
 .
-.I yyyyy
-is a hexadecimal number of five hex digits, such as
-.B 2FA1A
-for a Chinese-looking character from the Unicode block
-.IR "CJK Compatibility Ideographs Supplement" ,
-thus
-.BR \eu2FA1A .
+If the name does not exist,
+it is defined as empty,
+nothing is interpolated,
+and a warning in category
+.RB \%\lq mac \rq
+is emitted.
+.
+See section \lqWarnings\rq in
+.MR @g@troff 1 .
+.
+The bracketed interpolation form accepts arguments that are handled as
+macro arguments are;
+see section \lqCalling macros\rq above.
+.
+In contrast to macro calls,
+however,
+if a closing bracket
+.B 
+occurs in a string argument,
+that argument must be enclosed in double quotes.
+.
+.B \rs*
+is interpreted even in copy mode.
+.
+When defining strings,
+argument interpolations must be escaped if they are to reference
+parameters from the calling context;
+see section \lqParameters\rq below.
+.
+.
+.P
+An initial neutral double quote
+.B \dq
+in the string contents is stripped to allow embedding of leading spaces.
+.
+Any other
+.B \dq
+is interpreted literally,
+but it is wise to use the special character escape sequence
+.B \rsdq
+instead if the string might be interpolated as part of a macro argument;
+see section \lqCalling macros\rq above.
+.
+Strings are not limited to a single input line of text.
+.BI \rs newline
+works just as it does elsewhere.
+.
+The resulting string is stored
+.I without
+the newlines.
+.
+Care is therefore required when interpolating strings while filling is
+disabled.
+.
+It is not possible to embed a newline in a string that will be
+interpreted as such when the string is interpolated.
+.
+To achieve that effect,
+use
+.B \rs*
+to interpolate a macro instead.\" see @ref{Punning Names}.
 .
 .
 .P
-The hexadecimal value indicates the corresponding Unicode code point for
-a character.
-.
+The
+.request .as
+request is similar to
+.request .ds
+but appends to a string instead of redefining it.
 .
-.TP
-.BI \eu hex1 _ hex2 
-.TQ
-.BI \eu hex1 _ hex2 _ hex3 
-.IR hex1 ,
-.IR hex2 ,
-and
-.I hex3
-are all Unicode hexadecimal codes (4 or 5 hex digits) that are used
-for overstriking, e.g.\&
-.B \eu0041_0301
-is
-.IR "A acute" ,
-which can also be specified as
-.BR \'A ;
-see
-.BR groff_char (7).
+If
+.request .as
+is called with only one argument,
+no operation is performed
+(beyond dereferencing the string).
 .
 .
 .P
-The availability of the Unicode characters depends on the font used.
-.
-For text mode, the device
-.B \-Tutf8
-is quite complete; for
-.I troff
-modes it might happen that some or many characters will not be
-displayed.
-.
-Please check your fonts.
+Because strings are similar to macros,
+they too can be defined to suppress AT&T
+.I troff \" AT&T
+compatibility mode enablement when interpolated;
+see section \lqCompatibility mode\rq below.
 .
+The
+.request .ds1
+request defines a string that suspends compatibility mode when the
+string is later interpolated.
+.
+.request .as1
+is likewise similar to
+.BR .as ,
+with compatibility mode suspended when the appended portion of the
+string is later interpolated.
 .
-.\" ====================================================================
-.SS "Strings"
-.\" ====================================================================
 .
-Strings are defined by the
-.request ds
-request and can be retrieved by the
-.esc *
-escape sequence.
+.P
+.B Caution:
+Unlike other requests,
+the second argument to these requests consumes the remainder of the
+input line,
+including trailing spaces.
+.
+Ending string definitions
+(and appendments)
+with a comment,
+even an empty one,
+prevents unwanted space from creeping into them during source document
+maintenance.
 .
 .
+.br
+.ne 3v
 .P
-Strings share their name space with macros.
+Several requests exist to perform rudimentary string operations.
 .
-So strings and macros without arguments are roughly equivalent; it is
-possible to call a string like a macro and vice versa, but this often
-leads to unpredictable results.
+Strings can be queried
+(\c
+.request .length )
+and modified
+(\c
+.request .chop ,
+.request .substring ,
+.request .stringup ,
+.request .stringdown ),
+and their names can be manipulated through renaming,
+removal,
+and aliasing
+(\c
+.request .rn ,
+.request .rm ,
+.request .als).
 .
-The following string is the only one predefined in groff.
 .
-.TPx
-.STRING .T
-The name of the current output device as specified by the
-.option \-T
-command-line option.
+.P
+When a request,
+macro,
+string,
+or diversion is aliased,
+redefinitions and appendments \lqwrite through\rq alias names.
+.
+To replace an alias with a separately defined object,
+you must use the
+.B rm
+request on its name first.
+.\" END Keep (roughly) parallel with groff.texi node "Strings".
 .
 .
 .\" ====================================================================
-.SH REGISTERS
+.SH Registers
 .\" ====================================================================
 .
-Registers are variables that store a value.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Registers".
+In the
+.I roff
+language,
+numbers can be stored in
+.I registers.
+.
+Many built-in registers exist,
+supplying anything from the date to details of formatting parameters.
 .
-In groff,
-most registers store numerical values
-(see section \lqNumerical Expressions\rq above),
-but some can also hold a string value.
+You can also define your own.
+.
+See section \lqIdentifiers\rq above for information on constructing
+a valid name for a register.
 .
 .
 .P
-Each register is given a name.
-Arbitrary registers can be defined and set with the
-.request nr
-request.
+Define registers and update their values with the
+.B nr
+request or the
+.B \rsR
+escape sequence.
 .
 .
 .P
-The value stored in a register can be retrieved by the escape sequences
-introduced by
-.esc n .
+Registers can also be incremented or decremented by a configured amount
+at the time they are interpolated.
+.
+The value of the increment is specified with a third argument to the
+.request .nr
+request,
+and a special interpolation syntax,
+.BI \rsn \+-
+is used to alter and then retrieve
+the register's value.
+.
+Together,
+these features are called
+.IR auto-increment .
+.
+(A negative auto-increment can be
+considered an \lqauto-decrement\rq.)
 .
 .
 .P
-Most useful are predefined registers.
+Many predefined registers are available.
 .
-In the following the notation
+In the following presentation,
+the register interpolation syntax
+.BI \rsn name 
+is used to refer to a register
 .I name
-is used to refer to
-.register name
-to make clear that we speak about registers.
+to clearly distinguish it from a string or request
+.IR name .
 .
-Please keep in mind that the
-.esc n ""
-decoration is not part of the register name.
+The register name space is separate from that used for requests,
+macros,
+strings,
+and diversions.
+.
+Bear in mind that the symbols
+.B \rsn
+are
+.I not
+part of the register name.
+.\" END Keep (roughly) parallel with groff.texi node "Registers".
 .
 .
 .\" ====================================================================
-.SS "Read-only Registers"
+.SS "Read-only registers"
 .\" ====================================================================
 .
-The following registers have predefined values that should not be
-modified by the user (usually, registers starting with a dot are
-read-only).
+Predefined registers whose identifiers start with a dot are read-only.
 .
-Mostly, they provide information on the current settings or store
-results from request calls.
+Many are Boolean-valued.
 .
+Some are string-valued,
+meaning that they interpolate text.
 .
-.P
-.PD 0
+A register name
+(without the dot)
+is often associated with a request of the same name;
+exceptions are noted.
 .
-.TPx
-.REG $$
-The process ID of
-.BR troff .
 .
-.TPx
+.P
+.LS
+.
+.TP 15n
 .REG .$
-Number of arguments in the current macro or string.
+Count of arguments passed to currently interpolated macro or string.
 .
-.TPx
+.TP
 .REG .a
-Post-line extra line-space most recently utilized using
+Amount of extra post-vertical line space;
+see
 .esc x .
 .
-.TPx
+.TP
 .REG .A
-Set to\~1 in
-.B troff
-if option
-.option \-A
-is used; always\~1 in
-.BR nroff .
+Approximate output is being formatted (Boolean-valued);
+see
+.I @g@troff
+.B \-a
+option.
 .
-.TPx
+.TP
 .REG .b
-The emboldening offset while
-.request .bd
-is active.
+Font emboldening offset;
+see
+.request .bd .
 .
-.TPx
+.TP
 .REG .br
-Within a macro, set to\~1 if macro called with the \oqnormal\cq
-control character, and to\~0 otherwise.
+The normal control character was used to call the currently interpolated
+macro (Boolean-valued).
 .
-.TPx
+.TP
 .REG .c
-Current input line number.
+Input line number;
+see
+.request .lf
+and
+.register \fR\lq\fc.\fR\rq\f .
 .
-.TPx
+.TP
 .REG .C
-1\~if compatibility mode is in effect, 0\~otherwise.
+Compatibility mode is enabled (Boolean-valued);
+see
+.request .cp .
 .
-.TPx
-.REG .cdp
-The depth of the last glyph added to the current environment.
+Always false when processing
+.request .do ;
+see
+.register .cp .
 .
-It is positive if the glyph extends below the baseline.
+.TP
+.REG .cdp
+Depth of last glyph formatted in the environment;
+.\" TODO: Give page a discussion of glyph properties and move this.
+positive if glyph extends below the baseline.
 .
-.TPx
+.TP
 .REG .ce
-The number of lines remaining to be centered, as set by the
-.request ce
-request.
+Count of output lines remaining to be centered.
 .
-.TPx
+.TP
 .REG .cht
-The height of the last glyph added to the current environment.
-.
-It is positive if the glyph extends above the baseline.
+Height of last glyph formatted in the environment;
+.\" TODO: Give page a discussion of glyph properties and move this.
+positive if glyph extends above the baseline.
 .
-.TPx
+.TP
 .REG .color
-1\~if colors are enabled, 0\~otherwise.
+Color output is enabled (Boolean-valued).
 .
-.TPx
-.REG .csk
-The skew of the last glyph added to the current environment.
+.TP
+.REG .cp
+Within
+.request .do ,
+the saved value of compatibility mode;
+see
+.register .C .
 .
-The skew of a glyph is how far to the right of the center of a glyph
-the center of an accent over that glyph should be placed.
+.TP
+.REG .csk
+Skew of the last glyph formatted in the environment;
+.\" TODO: Give page a discussion of glyph properties and move this.
+skew is how far to the right of the center of a glyph the center of an
+accent over that glyph should be placed.
 .
-.TPx
+.TP
 .REG .d
-Current vertical place in current diversion; equal to
-.register nl\c
-\&.
+Vertical drawing position in diversion.
 .
-.TPx
+.TP
 .REG .ev
-The name or number of the current environment (string-valued).
+Name of environment (string-valued).
 .
-.TPx
+.TP
 .REG .f
-Current font number.
+Mounting position of selected font;
+see
+.request .ft
+and
+.esc f .
 .
-.TPx
+.TP
 .REG .F
-The name of the current input file (string-valued).
+Name of input file (string-valued);
+see
+.request .lf .
 .
-.TPx
+.TP
 .REG .fam
-The current font family (string-valued).
+Name of default font family (string-valued).
 .
-.TPx
+.TP
 .REG .fn
-The current (internal) real font name (string-valued).
+Resolved name of selected font (string-valued);
+see
+.request .ft
+and
+.esc f .
 .
-.TPx
+.TP
 .REG .fp
-The number of the next free font position.
+Next non-zero free font mounting position index.
 .
-.TPx
+.TP
 .REG .g
-Always 1 in GNU troff.
+Always true in GNU
+.I troff \" GNU
+(Boolean-valued).
 .
-Macros should use it to test if running under groff.
-.
-.TPx
+.TP
 .REG .h
-Text base-line high-water mark on current page or diversion.
+Text baseline high-water mark on page or in diversion.
 .
-.TPx
+.TP
 .REG .H
-Number of basic units per horizontal unit of output device resolution.
+Horizontal motion quantum of output device in basic units.
 .
-.TPx
+.TP
 .REG .height
-The current font height as set with
-.request \rsH\c
-\&.
+Font height;
+see
+.esc H .
 .
-.TPx
+.TP
 .REG .hla
-The current hyphenation language as set by the
-.request hla
-request.
+Hyphenation language in environment (string-valued).
 .
-.TPx
+.TP
 .REG .hlc
-The number of immediately preceding consecutive hyphenated lines.
+Count of immediately preceding consecutive hyphenated lines in
+environment.
 .
-.TPx
+.TP
 .REG .hlm
-The maximum allowed number of consecutive hyphenated lines, as set by
-the
-.request hlm
-request.
+Maximum quantity of consecutive hyphenated lines allowed in environment.
 .
-.TPx
+.TP
 .REG .hy
-The current hyphenation flags (as set by the
-.request hy
-request).
+Automatic hyphenation mode in environment.
 .
-.TPx
+.TP
 .REG .hym
-The current hyphenation margin (as set by the
-.request hym
-request).
+Hyphenation margin in environment.
 .
-.TPx
+.TP
 .REG .hys
-The current hyphenation space (as set by the
-.request hys
-request).
+Hyphenation space adjustment threshold in environment.
 .
-.TPx
+.TP
 .REG .i
-Current indentation.
+Indentation amount;
+see
+.request .in .
 .
-.TPx
+.TP
 .REG .in
-The indentation that applies to the current output line.
+Indentation amount applicable to the pending output line;
+see
+.request .ti .
 .
-.TPx
+.TP
 .REG .int
-Positive if last output line contains
-.esc c .
+Previous output line was \lqinterrupted\rq or continued with
+.esc c
+(Boolean-valued).
 .
-.TPx
+.TP
 .REG .j
-The current adjustment mode.
-It can be stored and used to set adjustment.
-(n\ =\ 1, b\ =\ 1, l\ =\ 0, r\ =\ 5, c\ =\ 3).
+Adjustment mode encoded as an integer;
+see
+.request .ad
+and
+.request .na .
 .
-.TPx
+Do not interpret or perform arithmetic on its value.
+.
+.TP
 .REG .k
-The current horizontal output position (relative to the current
-indentation).
-.TPx
+Horizontal drawing position relative to indentation.
+.
+.TP
 .REG .kern
-1\~if pairwise kerning is enabled, 0\~otherwise.
+Pairwise kerning is enabled (Boolean-valued).
 .
-.TPx
+.TP
 .REG .l
-Current line length.
+Line length;
+see
+.request .ll .
 .
-.TPx
+.TP
 .REG .L
-The current line spacing setting as set by
-.request .ls\c
-\&.
+Line spacing;
+see
+.request .ls .
 .
-.TPx
+.TP
 .REG .lg
-The current ligature mode (as set by the
-.request lg
-request).
+Ligature mode.
 .
-.TPx
+.TP
 .REG .linetabs
-The current line-tabs mode (as set by the
-.request linetabs
-request).
+Line-tabs mode is enabled (Boolean-valued).
 .
-.TPx
+.TP
 .REG .ll
-The line length that applies to the current output line.
+Line length applicable to the pending output line.
 .
-.TPx
+.TP
 .REG .lt
-The title length (as set by the
-.request lt
-request).
+Title length.
 .
-.TPx
+.TP
 .REG .m
-The current drawing color (string-valued).
+Stroke color (string-valued);
+see
+.request .gcolor
+and
+.esc m .
 .
-.TPx
+Empty if the stroke color is the default.
+.
+.TP
 .REG .M
-The current background color (string-valued).
+Fill color (string-valued);
+see
+.request .fcolor
+and
+.esc M .
 .
-.TPx
+Empty if the fill color is the default.
+.
+.TP
 .REG .n
-Length of text portion on previous output line.
+Length of formatted output on previous output line.
 .
-.TPx
+.TP
 .REG .ne
-The amount of space that was needed in the last
-.request ne
-request that caused a trap to be sprung.
-.
-Useful in conjunction with
-.register .trunc\c
-\&.
+Amount of vertical space required by last
+.request .ne
+that caused a trap to be sprung;
+also see
+.register .trunc .
 .
-.TPx
+.TP
+.REG .nm
+Output line numbering is enabled (Boolean-valued).
+.
+.TP
+.REG .nn
+Count of output lines remaining to have numbering suppressed.
+.
+.TP
 .REG .ns
-1\~if in no-space mode, 0\~otherwise.
+No-space mode is enabled (Boolean-valued).
 .
-.TPx
+.TP
 .REG .o
-Current page offset.
+Page offset;
+see
+.request .po .
 .
-.TPx
+.TP
 .REG .O
-The suppression nesting level (see
-.esc O ).
+Output suppression nesting level;
+see
+.esc O .
 .
-.TPx
+.TP
 .REG .p
-Current page length.
+Page length;
+see
+.request .pl .
 .
-.TPx
+.TP
 .REG .P
-1\~if the current page is being printed, 0\~otherwise (as determined by
-the
-.option \-o
-command-line option).
+The page is selected for output (Boolean-valued);
+see
+.I @g@troff
+.B \-o
+option.
 .
-.TPx
+.TP
 .REG .pe
-1\~during page ejection, 0\~otherwise.
+Page ejection is in progress (Boolean-valued).
 .
-.TPx
+.TP
 .REG .pn
-The number of the next page: either the value set by a
-.request pn
-request, or the number of the current page plus\ 1.
+Number of the next page.
 .
-.TPx
+.TP
 .REG .ps
-The current point size in scaled points.
+Type size in scaled points.
 .
-.TPx
+.TP
 .REG .psr
-The last-requested point size in scaled points.
+Most recently requested type size in scaled points;
+see
+.request .ps
+and
+.esc s .
 .
-.TPx
+.TP
 .REG .pvs
-The current post-vertical line spacing.
+Post-vertical line spacing.
 .
-.TPx
+.TP
 .REG .R
-The number of unused number registers.
-Always 10000 in GNU troff.
+Count of available unused registers;
+always 10,000 in GNU
+.IR troff . \" GNU
 .
-.TPx
+.TP
 .REG .rj
-The number of lines to be right-justified as set by the
-.request rj
-request.
+Count of lines remaining to be right-aligned.
 .
-.TPx
+.TP
 .REG .s
-Current point size as a decimal fraction.
+Type size in points as a decimal fraction (string-valued);
+see
+.request .ps
+and
+.esc s .
 .
-.TPx
+.TP
 .REG .slant
-The slant of the current font as set with
-.request \eS\c
-\&.
+Slant of font in degrees;
+see
+.esc S .
 .
-.TPx
+.TP
 .REG .sr
-The last requested point size in points as a decimal fraction
-(string-valued).
+Most recently requested type size in points as a decimal fraction
+(string-valued);
+see
+.request .ps
+and
+.esc s .
 .
-.TPx
+.TP
 .REG .ss
-The value of the parameters set by the first argument of the
-.request ss
-request.
+Size of minimal inter-word space in twelfths of the space width of the
+selected font.
 .
-.TPx
+.TP
 .REG .sss
-The value of the parameters set by the second argument of the
-.request ss
-request.
+Size of additional inter-sentence space in twelfths of the space width
+of the selected font.
 .
-.TPx
+.TP
 .REG .sty
-The current font style (string-valued).
+Selected abstract style (string-valued);
+see
+.request .ft
+and
+.esc f .
 .
-.TPx
+.TP
 .REG .t
-Vertical distance to the next trap.
+Distance to next vertical position trap;
+see
+.request .wh
+and
+.request .ch .
 .
-.TPx
+.TP
 .REG .T
-Set to\~1
-if option
-.option \-T
-is used.
+An output device was explicitly selected (Boolean-valued);
+see
+.I @g@troff
+.B \-T
+option.
 .
-.TPx
+.TP
 .REG .tabs
-A string representation of the current tab settings suitable for use
-as an argument to the
-.request ta
-request.
+Representation of tab settings suitable for use as argument to
+.request .ta
+(string-valued).
 .
-.TPx
+.TP
 .REG .trunc
-The amount of vertical space truncated by the most recently sprung
-vertical position trap, or, if the trap was sprung by an
-.request ne
-request, minus the amount of vertical motion produced by
-.request .ne\c
-\&.
-.
-Useful in conjunction with the
-.register .ne\c
-\&.
+Amount of vertical space truncated by the most recently sprung
+vertical position trap,
+or,
+if the trap was sprung by an
+.request .ne ,
+minus the amount of vertical motion produced by
+.request .ne ;
+also see
+.register .ne .
 .
-.TPx
+.TP
 .REG .u
-Equal to 1 in fill mode and 0 in no-fill mode.
+Filling is enabled (Boolean-valued);
+see
+.request .fi
+and
+.request .nf .
 .
-.TPx
+.TP
 .REG .U
-Equal to 1 in safer mode and 0 in unsafe mode.
+Unsafe mode is enabled (Boolean-valued);
+see
+.I @g@troff
+.B \-U
+option.
 .
-.TPx
+.TP
 .REG .v
-Current vertical line spacing.
+Vertical line spacing;
+see
+.request .vs .
 .
-.TPx
+.TP
 .REG .V
-Number of basic units per vertical unit of output device resolution.
+Vertical motion quantum of the output device in basic units.
 .
-.TPx
+.TP
 .REG .vpt
-1\~if vertical position traps are enabled, 0\~otherwise.
+Vertical position traps are enabled (Boolean-valued).
 .
-.TPx
+.TP
 .REG .w
-Width of previous glyph.
+Width of previous glyph formatted in the environment.
 .
-.TPx
+.TP
 .REG .warn
-The sum of the number codes of the currently enabled warnings.
+Sum of the numeric codes of enabled warning categories.
 .
-.TPx
+.TP
 .REG .x
-The major version number.
+Major version number of the running
+.I @g@troff
+formatter.
 .
-.TPx
+.TP
 .REG .y
-The minor version number.
+Minor version number of the running
+.I @g@troff
+formatter.
 .
-.TPx
+.TP
 .REG .Y
-The revision number of groff.
+Revision number of the running
+.I @g@troff
+formatter.
 .
-.TPx
+.TP
 .REG .z
-Name of current diversion.
+Name of diversion (string-valued).
 .
-.TPx
+Empty if output is directed to the top-level diversion.
+.
+.TP
 .REG .zoom
-Zoom factor for current font (in multiples of 1/1000th; zero if no
-magnification).
-.PD
+Zoom multiplier of current font
+(in thousandths;
+zero if no magnification);
+see
+.request .fzoom .
+.LE
 .
 .
 .\" ====================================================================
-.SS "Writable Registers"
+.SS "Writable predefined registers"
 .\" ====================================================================
 .
-The following registers can be read and written by the user.
-They have predefined default values, but these can be modified for
-customizing a document.
+Several registers are predefined but also modifiable;
+some are updated upon interpretation of certain requests or escape
+sequences.
+.
+Date- and time-related registers are set to the local time as determined
+by
+.MR localtime 3
+when the formatter launches.
+.
+This initialization can be overridden by
+.I \%SOURCE_DATE_EPOCH
+and
+.IR TZ ;
+see section \lqEnvironment\rq of
+.MR groff @MAN1EXT@ .
 .
 .
 .P
-.PD 0
-.TPx
+.LS
+.
+.TP 15n
+.REG $$
+Process ID of
+.IR @g@troff .
+.
+.TP
 .REG %
-Current page number.
+Page number.
 .
-.TPx
+.TP
 .REG c.
-Current input line number.
+Input line number.
 .
-.TPx
+.TP
 .REG ct
-Character type (set by width function
-.esc w ).
+Union of character types of each glyph rendered into dummy environment
+by
+.esc w .
 .
-.TPx
+.TP
 .REG dl
-Maximal width of last completed diversion.
+Width of last closed diversion.
 .
-.TPx
+.TP
 .REG dn
-Height of last completed diversion.
+Height of last closed diversion.
 .
-.TPx
+.TP
 .REG dw
-Current day of week (1\(en7).
+Day of the week (1\en7;
+1 is Sunday).
 .
-.TPx
+.TP
 .REG dy
-Current day of month (1\(en31).
+Day of the month (1\en31).
 .
-.TPx
+.TP
 .REG hours
-The number of hours past midnight.
-.
-Initialized at start-up.
+Count of hours elapsed since midnight (0\en23).
 .
-.TPx
+.TP
 .REG hp
-Current horizontal position at input line.
+Horizontal drawing position relative to start of input line.
 .
-.TPx
+.TP
 .REG llx
-Lower left x-coordinate (in PostScript units) of a given PostScript
-image (set by
-.request .psbb\c
-).
+Lower-left
+.I x
+coordinate
+(in PostScript units)
+of PostScript image;
+see
+.request .psbb .
 .
-.TPx
+.TP
 .REG lly
-Lower left y-coordinate (in PostScript units) of a given PostScript
-image (set by
-.request .psbb\c
-).
+Lower-left
+.I y
+coordinate
+(in PostScript units)
+of PostScript image;
+see
+.request .psbb .
 .
-.TPx
+.TP
 .REG ln
-Output line number.
+Output line number;
+see
+.request .nm .
 .
-.TPx
+.TP
 .REG lsn
-The number of leading spaces of an input line.
+Count of leading spaces on input line.
 .
-.TPx
+.TP
 .REG lss
-The horizontal space corresponding to the leading spaces of an input
+Amount of horizontal space corresponding to leading spaces on input
 line.
 .
-.TPx
+.TP
 .REG minutes
-The number of minutes after the hour.
+Count of minutes elapsed in the hour (0\en59).
 .
-Initialized at start-up.
-.
-.TPx
+.TP
 .REG mo
-Current month (1\(en12).
+Month of the year (1\en12).
 .
-.TPx
+.TP
 .REG nl
-Vertical position of last printed text base-line.
+Vertical drawing position.
 .
-.TPx
+.TP
 .REG opmaxx
-.TPx
+.TP
 .REG opmaxy
-.TPx
+.TP
 .REG opminx
-.TPx
+.TP
 .REG opminy
-These four registers mark the top left and bottom right hand corners of
-a box which encompasses all written glyphs.
+These four registers mark the top left- and bottom right-hand corners of
+a rectangle encompassing all formatted output on the page.
+.
 They are reset to \-1 by
-.escarg O 0
+.B \rsO0
 or
-.escarg O 1 .
+.BR \rsO1 .
 .
-.TPx
+.TP
 .REG rsb
-Like
-.register sb\c
-,
-but takes account of the heights and depths of glyphs.
+As
+.register sb ,
+adding maximum glyph height to measurement.
 .
-.TPx
+.TP
 .REG rst
-Like
-.register st\c
-,
-but takes account of the heights and depths of glyphs.
+As
+.register st ,
+adding maximum glyph depth to measurement.
 .
-.TPx
+.TP
 .REG sb
-Depth of string below base line (generated by width function
-.esc w ).
+Maximum displacement of text baseline below its original position
+after rendering into dummy environment by
+.esc w .
 .
-.TPx
+.TP
 .REG seconds
-The number of seconds after the minute.
+Count of seconds elapsed in the minute (0\en60). \" not 59; see POSIX
 .
-Initialized at start-up.
-.
-.TPx
+.TP
 .REG skw
-Right skip width from the center of the last glyph in the
-.esc w
-argument.
+Skew of last glyph rendered into dummy environment by
+.esc w .
 .
-.TPx
+.TP
 .REG slimit
-If greater than 0, the maximum number of objects on the input stack.
+The maximum depth of
+.IR @g@troff 's
+internal input stack.
+.
+If \<=0,
+there is no limit:
+recursion can continue until available memory is exhausted.
 .
-If \<=0 there is no limit, i.e., recursion can continue until virtual
-memory is exhausted.
+The default is 1,000.
 .
-.TPx
+.TP
 .REG ssc
-The amount of horizontal space (possibly negative) that should be
-added to the last glyph before a subscript (generated by width
-function
-.esc w ).
+Subscript correction of last glyph rendered into dummy environment by
+.esc w .
 .
-.TPx
+.TP
 .REG st
-Height of string above base line (generated by width function
-.esc w ).
+Maximum displacement of text baseline above its original position
+after rendering into dummy environment by
+.esc w .
 .
-.TPx
+.TP
 .REG systat
-The return value of the
+Return value of
 .I system()
-function executed by the last
-.request sy
-request.
+function; see
+.request .sy .
 .
-.TPx
+.TP
 .REG urx
-Upper right x-coordinate (in PostScript units) of a given PostScript
-image (set by
-.request .psbb\c
-).
+Upper-right
+.I x
+coordinate
+(in PostScript units)
+of PostScript image;
+see
+.request .psbb .
 .
-.TPx
+.TP
 .REG ury
-Upper right y-coordinate (in PostScript units) of a given PostScript
-image (set by
-.request .psbb\c
-).
+Upper-right
+.I y
+coordinate
+(in PostScript units)
+of PostScript image;
+see
+.request .psbb .
 .
-.TPx
+.TP
 .REG year
-The current year (year 2000 compliant).
+Gregorian year.
 .
-.TPx
+.TP
 .REG yr
-Current year minus 1900.
+Gregorian year minus 1900.
+.LE
+.
+.
+.\" ====================================================================
+.SH "Using fonts"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Using Fonts".
+In digital typography,
+a
+.I font
+is a collection of characters in a specific typeface that a device can
+render as glyphs at a desired size.
+.
+(Terminals and some output devices have fonts that render at only one or
+two sizes.
+.
+As examples of the latter,
+take the
+.I groff
+.B lj4
+device's
+Lineprinter,
+and
+.BR lbp 's
+Courier and Elite faces.)
 .
-For Y2K compliance use
-.register year
-instead.
 .
-.PD
+A
+.I roff
+formatter can change typefaces at any point in the text.
+.
+The basic faces are a set of
+.I styles
+combining upright and slanted shapes with normal and heavy stroke
+weights:
+.RB \lq R \rq,
+.RB \lq I \rq,
+.RB \lq B \rq,
+and
+.RB \lq BI \rq\em\c
+these stand for
+.I roman,
+.I bold,
+.I italic,
+and
+.I bold-italic.
+.
+For linguistic text,
+GNU
+.I troff \" GNU
+groups typefaces into
+.I families
+containing each of these styles.
+.
+(Font designers prepare families such that the styles share esthetic
+properties.)
+.
+A
+.I "text font"
+is thus often a family combined with a style,
+but it need not be:
+consider the
+.B ps
+and
+.B pdf
+devices'
+.B ZCMI
+(Zapf Chancery Medium italic)\em\c
+often,
+no other style of Zapf Chancery Medium is provided.
+.
+On typesetting devices,
+at least one
+.I "special font"
+is available,
+comprising
+.I unstyled
+glyphs for mathematical operators and other purposes.
+.
+.
+.P
+Like AT&T
+.I troff, \" AT&T
+GNU
+.I troff \" GNU
+does not itself load or manipulate a digital font file;
+.\" @footnote{Historically, the fonts @code{troff}s dealt with were not
+.\" Free Software or, as with the Graphic Systems C/A/T, did not even
+.\" exist in the digital domain.}
+instead it
+works with a
+.I font description file
+that characterizes it,
+including its glyph repertoire and the
+.I metrics
+(dimensions) of each glyph.
+.
+This information permits the formatter to accurately place glyphs with
+respect to each other.
+.
+Before using a font description,
+the formatter associates it with a
+.I "mounting position,"
+a place in an ordered list of available typefaces.
+.
+So that a document need not be strongly coupled to a specific font
+family,
+in GNU
+.I troff \" GNU
+an output device can associate a style in the abstract sense with a
+mounting position.
+.
+Thus the default family can be combined with a style dynamically,
+producing a
+.I "resolved font name."
+.
+.
+.P
+Fonts often have trademarked names,
+and even Free Software fonts can require renaming upon modification.
+.
+.I groff
+maintains a convention that a device's serif font family is given the
+name
+.B T
+(\lqTimes\rq),
+its sans-serif family
+.B H
+(\lqHelvetica\rq),
+and its
+monospaced family
+.B C
+(\lqCourier\rq).
+.
+Historical inertia has driven
+.IR groff 's
+font identifiers to short uppercase abbreviations of font names,
+as with
+.BR TR ,
+.BR TB ,
+.BR TI ,
+.BR TBI ,
+and a special font
+.BR S .
+.
+.
+.P
+The default family used with abstract styles can be changed at any time;
+initially,
+it
+.RB is\~ T .
+.
+Typically,
+abstract styles are arranged in the first four mounting positions in the
+order shown above.
+.
+The default mounting position,
+and therefore style,
+is always
+.B 1
+.RB ( R ).
+.
+By issuing appropriate formatter instructions,
+you can override these defaults before your document writes its first
+glyph.
+.
+.
+.P
+Terminal output devices cannot change font families and lack special
+fonts.
+.
+They support style changes by overstriking,
+or by altering ISO\~6429/\:ECMA-48
+.I "graphic renditions"
+(character cell attributes).
+.\" END Keep (roughly) parallel with groff.texi node "Using Fonts".
 .
 .
 .\" ====================================================================
-.SH HYPHENATION
+.SH Hyphenation
 .\" ====================================================================
 .
+When filling,
+.I groff
+hyphenates words as needed at user-specified and automatically
+determined hyphenation points.
+.
+Explicitly hyphenated words such as \lqmother-in-law\rq are always
+eligible for breaking after each of their hyphens.
+.
+The hyphenation
+.RB character\~ \rs%
+and non-printing break
+.RB point\~ \rs:
+escape sequences may be used to control the hyphenation and breaking of
+individual words.
+.
 The
-.REQ .hy
-request,
-given an integer argument,
-controls when hyphenation applies.
+.B .hw
+request sets user-defined hyphenation points for specified words at any
+subsequent occurrence.
+.
+Otherwise,
+.I groff
+determines hyphenation points automatically by default.
+.
+.
+.P
+Several requests influence automatic hyphenation.
+.
+Because conventions vary,
+a variety of hyphenation modes is available to the
+.B .hy
+request;
+these determine whether hyphenation will apply to a word prior to
+breaking a line at the end of a page
+(more or less;
+see below for details),
+and at which positions within that word automatically determined
+hyphenation points are permissible.
 .
-The default value is
-.BR 1 ,
-which enables hyphenation almost everywhere (see below).
+The default is
+.RB \lq 1 \rq
+for historical reasons,
+but this is not an appropriate value for the English hyphenation
+patterns used by
+.IR groff ;
+localization macro files loaded by
+.I troffrc
+and macro packages often override it.
 .
-Macro packages often override this default.
+.
+.TP
+.B 0
+disables hyphenation.
 .
 .
 .TP
 .B 1
-disables hyphenation only after the first and before the last
-character of a word.
+enables hyphenation except after the first and before the last character
+of a word.
+.
+.
+.P
+The remaining values \lqimply\rq
+.BR 1 ;
+that is,
+they enable hyphenation under the same conditions as
+.RB \lq ".hy 1" \rq,
+and then apply or lift restrictions relative to that basis.
+.
 .
 .TP
 .B 2
-disables hyphenation only of the last word on a page or column.
+disables hyphenation of the last word on a page.
+.
+(Hyphenation is prevented if the next page location trap is closer to
+the vertical drawing position than the next text baseline would be.
+.
+See section \lqTraps\rq below.)
+.
 .
 .TP
 .B 4
-disables hyphenation only before the last two characters of a word.
+disables hyphenation before the last two characters of a word.
+.
 .
 .TP
 .B 8
-disables hyphenation only after the first two characters of a word.
+disables hyphenation after the first two characters of a word.
+.
 .
 .TP
 .B 16
 enables hyphenation before the last character of a word.
 .
+.
 .TP
 .B 32
 enables hyphenation after the first character of a word.
 .
+.
+.P
+Apart from value\~2,
+restrictions imposed by the hyphenation mode are
+.I not
+respected for words whose hyphenations have been specified with the
+hyphenation character
+.RB (\lq \|\rs% \rq
+by default)
+or the
+.B .hw
+request.
+.
+.
 .P
-The values are additive.
+Nonzero values are additive.
+.
+For example,
+mode\~12 causes
+.I groff
+to hyphenate neither the last two nor the first two characters of a
+word.
 .
 Some values cannot be used together because they contradict;
 for instance,
-4 and\~16;
-8 and\~32.
+values 4 and\~16,
+and values 8 and\~32.
+.
+As noted,
+it is superfluous to add\~1 to any non-zero even mode.
+.
+.
+.br
+.ne 2v
+.P
+The places within a word that are eligible for hyphenation are
+determined by language-specific data
+.RB ( .hla ,
+.BR .hpf ,
+and
+.BR .hpfa )
+and lettercase relationships
+.RB ( .hcode
+and
+.BR .hpfcode ).
+.
+Furthermore,
+hyphenation of a word might be suppressed due to a limit on
+consecutive hyphenated lines
+.RB ( .hlm ),
+a minimum line length threshold
+.RB ( .hym ),
+or because the line can instead be adjusted with additional inter-word
+space
+.RB ( .hys ).
 .
 .
 .\" ====================================================================
-.SH UNDERLINING
+.SH Localization
 .\" ====================================================================
 .
-In the
-.I RUNOFF
-language, the underlining was quite easy.
+The set of hyphenation patterns is associated with the hyphenation
+language set by the
+.B .hla
+request.
+.
+The
+.B .hpf
+request is usually invoked by a localization file loaded by the
+.I troffrc
+file.
+.
+.I groff
+provides localization files for several languages;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+.
+.\" ====================================================================
+.SH "Writing macros"
+.\" ====================================================================
+.
+The
+.B .de
+request defines a macro named for its argument.
+.
+If that name already exists as an alias,
+the target of the alias is redefined;
+see section \lqStrings\rq above.
+.
+.I @g@troff
+enters \lqcopy mode\rq
+(see below),
+storing subsequent input lines as the definition.
+.
+If the optional second argument is not specified,
+the definition ends with the control line
+.RB \lq .. \rq\&
+(two dots).
+.
+Alternatively,
+a second argument names a macro whose call syntax ends the definition;
+this \lqend macro\rq is then called normally.
+.
+Spaces or tabs are permitted after the first control character in the
+line containing this ending token,
+but a tab immediately after the token prevents its recognition as the
+end of a macro definition.
+.
+Macro definitions can be nested if they use distinct end macros or if
+their ending tokens are sufficiently escaped.
+.
+An end macro need not be defined until it is called.
+.
+This fact enables a nested macro definition to begin inside one macro
+and end inside another.
+.
+.
+.P
+Variants of
+.B .de
+disable compatibility mode and/or indirect the names of the macros
+specified for definition or termination:
+these are
+.BR .de1 ,
+.BR .dei ,
+and
+.BR .dei1 .
+.
+Append to macro definitions with
+.BR .am ,
+.BR .am1 ,
+.BR .ami ,
+and
+.BR .ami1 .
+.
+The
+.BR .als ,
+.BR .rm ,
+and
+.B .rn
+requests create an alias of,
+remove,
+and rename a macro,
+respectively.
+.
+.B .return
+stops the execution of a macro immediately,
+returning to the enclosing context.
+.
+.
+.\" ====================================================================
+.SS Parameters
+.\" ====================================================================
+.
+Macro call and string interpolation parameters can be accessed using
+escape sequences starting with
+.RB \lq \|\rs$ \rq.
+.
+The
+.B \rsn.$
+read-only register stores the count of parameters available to a macro
+or string;
+its value can be changed by the
+.B .shift
+request,
+which dequeues parameters from the current list.
+.
+The
+.B \rs$0
+escape sequence interpolates the name by which a macro was called.
+.
+Applying string interpolation to a macro does not change this name.
+.
+.
+.\" ====================================================================
+.SS "Copy mode"
+.\" ====================================================================
+.
+When
+.I @g@troff
+processes certain requests,
+most importantly those which define or append to a macro or string,
+it does so in
+.IR "copy mode" :
+it copies the characters of the definition into a dedicated storage
+region,
+interpolating the escape sequences
+.BR \rsn ,
+.BR \rsg ,
+.BR \rs$ ,
+.BR \rs* ,
+.BR \rsV ,
+and
+.B \rs?\&
+normally;
+interpreting
+.BI \rs newline
+immediately;
+discarding comments
+.B \rs"
+and
+.BR \rs# ;
+interpolating the current leader,
+escape,
+or tab character with
+.BR \rsa ,
+.BR \rse ,
+and
+.BR \rst ,
+respectively;
+and storing all other escape sequences in an encoded form.
 .
-But in
+The complement of copy mode\ema
 .I roff
-this is much more difficult.
+formatter's behavior when not defining or appending to a macro,
+string,
+or diversion\emwhere all macros are interpolated,
+requests invoked,
+and valid escape sequences processed immediately upon recognition,
+can be termed
+.IR "interpretation mode" .
+.
+.
+.P
+The escape character,
+.B \rs
+by default,
+can escape itself.
+.
+This enables you to control whether a given
+.BR \rsn ,
+.BR \rsg ,
+.BR \rs$ ,
+.BR \rs* ,
+.BR \rsV ,
+or
+.B \rs?\&
+escape sequence is interpreted at the time the macro containing it is
+defined,
+or later when the macro is called.
+.
+.
+.P
+You can think of
+.B \rs\rs
+as a \lqdelayed\rq backslash;
+it is the escape character followed by a backslash from which the escape
+character has removed its special meaning.
+.
+Consequently,
+.B \rs\rs
+is not an escape sequence in the usual sense.
+.
+In any escape sequence
+.BI \rs X
+that
+.I @g@troff
+does not recognize,
+the escape character is ignored and
+.IR X \~is
+output.
+.
+An unrecognized escape sequence causes a warning in category
+.RB \%\lq escape \rq,
+with two exceptions,
+.B \rs\rs
+being one.
+.
+The other is
+.BR \rs. ,
+which escapes the control character.
+.
+It is used to permit nested macro definitions to end without a named
+macro call to conclude them.
+.
+Without a syntax for escaping the control character,
+this would not be possible.
+.
+.I roff
+documents should not use the
+.B \rs\rs
+or
+.B \rs.\&
+character sequences outside of copy mode;
+they serve only to obfuscate the input.
+.
+Use
+.B \rse
+to represent the escape character,
+.B \rsrs
+to obtain a backslash glyph,
+and
+.B \rs&
+before
+.B .\&
+and
+.B \aq
+where
+.I @g@troff
+expects them as control characters if you mean to use them literally.
+.
+.
+.br
+.ne 2v
+.P
+Macro definitions can be nested to arbitrary depth.
+.
+In
+.RB \lq \|\rs\rs \rq,
+each escape character is interpreted twice\emonce in copy mode,
+when the macro is defined,
+and once in interpretation mode,
+when the macro is called.
+.
+This fact leads to exponential growth in the quantity of escape
+characters required to delay interpolation of
+.BR \rsn ,
+.BR \rsg ,
+.BR \rs$ ,
+.BR \rs* ,
+.BR \rsV ,
+and
+.B \rs?\&
+at each nesting level.
+.
+An alternative is to use
+.BR \rsE ,
+which represents an escape character that is not interpreted in copy
+mode.
+.
+Because
+.B \rs.\&
+is not a true escape sequence,
+we can't use
+.B \rsE
+to keep
+.RB \lq ..\& \rq
+from ending a macro definition prematurely.
+.
+If the multiplicity of backslashes complicates maintenance,
+use end macros.
 .
 .
 .\" ====================================================================
-.SS Underlining with .ul
+.SH Traps
 .\" ====================================================================
 .
-There exists a
-.I groff
-request
-.B .ul
-(see above) that can underline the next or further source lines in
-.BR nroff ,
-but in
-.B troff
-it produces only a font change into
-.IR italic .
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Traps".
+.I Traps
+are locations in the output,
+or conditions on the input that,
+when reached or fulfilled,
+call a specified macro.
+.
+A
+.I "vertical position trap"
+calls a macro when the formatter's vertical drawing position reaches or
+passes,
+in the downward direction,
+a certain location on the output page or in a diversion.
+.
+Its applications include setting page headers and footers,
+body text in multiple columns,
+and footnotes.
+.
+These traps can occur at a given location on the page
+.RB ( .wh ,\~ .ch );
+at a given location in the current diversion
+.RB ( .dt )\emtogether,
+these are known as
+vertical position traps,
+which can be disabled and re-enabled
+.RB ( .vpt ).
+.
+.
+.P
+A diversion is not formatted in the context of a page,
+so it lacks page location traps;
+instead it can have a
+.I "diversion trap."
+.
+There can exist at most one such vertical position trap per diversion.
+.
+.
+.P
+Other kinds of trap can be planted
+at a blank line
+.RB ( .blm );
+at a line with leading space characters
+.RB ( .lsm );
+after a certain number of productive input lines
+.RB ( .it ,\~ .itc );
+or at the end of input
+.RB ( .em ).
+.
+Macros called by traps are passed no arguments.
+.
+Setting a trap is also called
+.I planting
+one.
+.
+It is said that a trap is
+.I sprung
+if its condition is fulfilled.
+.\" END Keep (roughly) parallel with groff.texi node "Traps".
+.
+.
+.br
+.ne 5v
+.P
+Registers associated with trap management include
+vertical position trap enablement status
+.RB ( \rsn.vpt ),
+distance to the next trap
+.RB ( \rsn.t ),
+amount of needed
+.RB ( .ne -requested)
+space that caused the most recent vertical position trap to be sprung
+.RB ( \rsn.ne ),
+amount of needed space truncated from the amount requested
+.RB ( \rsn.trunc ),
+page ejection status
+.RB ( \rsn.pe ),
+and
+leading space count
+.RB ( \rsn.lsn )
+with its corresponding amount of motion
+.RB ( \rsn.lss ).
+.
+.
+.\" ====================================================================
+.SS "Page location traps"
+.\" ====================================================================
+.
+A
+.I "page location trap"
+is a vertical position trap that applies to
+the page;
+that is,
+to undiverted output.
+.
+Many can be present;
+manage them with
+the
+.B wh
+and
+.B ch
+requests.
+.
+Non-negative page locations given to these requests set the trap
+relative to the top of the page;
+negative values set the trap relative to the bottom of the page.
+.
+It is not possible to plant a trap less than one basic unit from the
+page bottom:
+a location of \lq\-0\rq is interpreted as \lq0\rq,
+the top of the page.
+.
+An existing
+.I visible
+trap
+(see below)
+at the same location is removed;
+this is
+.BR .wh 's
+sole function if its second argument is missing.
+.
+.
+.P
+A trap is sprung only if it is
+.I visible,
+meaning that its location is reachable on the page and it is not hidden
+by another trap at the same location already planted there.
+.
+(A trap planted at \lq20i\rq or \lq\-30i\rq will not be sprung
+on a page of length \lq11i\rq.)
+.
+.
+.P
+A trap above the top or at or below the bottom of the page can be made
+visible by either moving it into the page area or increasing the page
+length so that the trap is on the page.
+.
+Negative trap values always use the
+.I current
+page length;
+they are not converted to an absolute vertical position.
+.
+Use
+.B .ptr
+to dump page location traps to the standard error stream;
+their positions are reported in basic units.
+.
+.
+.br
+.ne 6v
+.\" ====================================================================
+.SS "The implicit page trap"
+.\" ====================================================================
+.
+An
+.I implicit page trap
+always exists in the top-level diversion;
+it works like a trap in some ways but not others.
+.
+Its purpose is to eject the current page and start the next one.
+.
+It has no name,
+so it cannot be moved or deleted with
+.B wh
+or
+.B ch
+requests.
+.
+You cannot hide it by placing another trap at its location,
+and can move it only by redefining the page length with
+.BR .pl .
+.
+Its operation is suppressed when vertical page traps are disabled with
+the
+.B vpt
+request.
+.
+.
+.\" ====================================================================
+.SH Diversions
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Diversions".
+In
+.I roff
+systems it is possible to format text as if for output,
+but instead of writing it immediately,
+one can
+.I divert
+the formatted text into a named storage area.
+.
+It is retrieved later by specifying its name after a control character.
+.
+The same name space is used for such
+.I diversions
+as for strings and macros;
+see section \lqIdentifiers\rq above.
+.
+Such text is sometimes said to be \lqstored in a macro\rq,
+but this coinage obscures the important distinction between macros and
+strings on one hand and diversions on the other;
+the former store
+.I unformatted
+input text,
+and the latter capture
+.I formatted
+output.
+.
+Diversions also do not interpret arguments.
+.
+Applications of diversions include \lqkeeps\rq
+(preventing a page break from occurring at an inconvenient place by
+forcing a set of output lines to be set as a group),
+footnotes,
+tables of contents,
+and indices.
+.
+For orthogonality it is said that GNU
+.I troff \" GNU
+is in the
+.I top-level diversion
+if no diversion is active
+(that is,
+formatted output is being \lqdiverted\rq immediately to the output
+device.
+.
+.
+.P
+Dereferencing an undefined diversion will create an empty one of that
+name and cause a warning in category
+.B mac
+to be emitted.
+(see section \lqWarnings\rq in
+.MR @g@troff @MAN1EXT@ ).
+.
+A diversion does not exist for the purpose of testing with the
+.B d
+conditional operator until its initial definition ends
+(see subsection \lqConditional expressions\rq above).
+.\" The following requests are used to create and alter diversions.
+.\" END Keep (roughly) parallel with groff.texi node "Diversions".
+.
+.
+.P
+The
+.B di
+request creates a diversion,
+including any partially collected line.
+.
+.B da
+appends to a diversion,
+creating one if it does not already exist.
+.
+If the diversion's name already exists as an alias,
+the target of the alias is replaced or appended to;
+see section \lqStrings\rq above.
+.
+.B box
+and
+.B boxa
+works similarly,
+but ignore partially collected lines.
+.
+Call any of these macros again without an argument to end the diversion.
+.
+.
+.br
+.ne 2v
+.P
+Diversions can be nested.
+.
+The registers
+.BR .d ,
+.BR .z ,
+.BR dn ,
+and
+.B dl
+report information about the current
+(or last closed)
+diversion.
+.
+.B .h
+is meaningful in diversions,
+including the top level.
+.
+.
+.P
+The
+.B \rs!\%
+and
+.B \rs?\%
+escape sequences and
+.B output
+request escape from a diversion,
+the first two to the enclosing level and the last to the top level.
+.
+This facility is termed
+.IR "transparent embedding" .
+.
+.
+.P
+The
+.B asciify
+and
+.B unformat
+requests reprocess diversions.
+.\" XXX: That's a weak statement.  What we need is a `for` request and
+.\" a new conditional operator that tests whether an item in a node list
+.\" is an (otherwise unrepresentable) node.  See Savannah #62264.
+.
+.
+.\" ====================================================================
+.SH "Punning names"
+.\" ====================================================================
 .
-So this request is not really useful.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Punning names".
+Macros,
+strings,
+and diversions share a name space;
+see section \lqIdentifiers\rq above.
+.
+Internally,
+the same mechanism is used to store them.
+.
+You can thus call a macro with string interpolation syntax and vice
+versa.
+.
+Interpolating a string does not hide existing macro arguments.
+.
+The sequence
+.B \rs\rs
+can be placed at the end of a line in a macro definition or,
+within a macro definition,
+immediately after the interpolation of a macro as a string to suppress
+the effect of a newline.
+.\" END Keep (roughly) parallel with groff.texi node "Punning names".
 .
 .
 .\" ====================================================================
-.SS Underlining with .UL from ms
+.SH Environments
 .\" ====================================================================
 .
-In the \oqms\cq macro package in tmac/s.tmac
-.BR groff_ms (@MAN7EXT@),
-there is the macro
-.BR .UL .
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Environments".
+Environments store most of the parameters that control text processing.
+.
+A default environment named
+.RB \lq 0 \rq
+exists when
+.I @g@troff
+starts up;
+it is modified by formatting-related requests and escape sequences.
+.
+.
+.P
+You can create new environments and switch among them.
+.
+Only one is current at any given time.
+.
+Active environments are managed using a
+.I stack,
+a data structure supporting \lqpush\rq and \lqpop\rq operations.
+.
+The current environment is at the top of the stack.
+.
+The same environment name can be pushed onto the stack multiple times,
+possibly interleaved with others.
+.
+Popping the environment stack does not destroy the current environment;
+it remains accessible by name and can be made current again by pushing
+it at any time.
+.
+Environments cannot be renamed or deleted,
+and can only be modified when current.
+.
+To inspect the environment stack,
+use the
+.B pev
+request;
+see section \lqDebugging\rq below.
+.
+.
+.P
+Environments store the following information.
+.
+.
+.IP \bu 2n
+a partially collected line, if any
+.
+.
+.IP \bu
+data about the most recently output glyph and line
+(registers
+.BR .cdp ,
+.BR .cht ,
+.BR .csk ,
+.BR .n ,
+.BR .w )
+.
+.
+.IP \bu
+typeface parameters
+(size,
+family,
+style,
+height and slant,
+inter-word and inter-sentence space sizes)
 .
-But this works only in
-.BR troff ,
-not in
-.BR nroff .
+.
+.IP \bu
+page parameters
+(line length,
+title length,
+vertical spacing,
+line spacing,
+indentation,
+line numbering,
+centering,
+right-alignment,
+underlining,
+hyphenation parameters)
+.
+.
+.IP \bu
+filling enablement;
+adjustment enablement and mode
+.
+.
+.IP \bu
+tab stops;
+tab,
+leader,
+escape,
+control,
+no-break control,
+hyphenation,
+and
+margin characters
+.
+.
+.IP \bu
+input line traps
+.
+.
+.IP \bu
+stroke and fill colors
+.
+.
+.P
+The
+.B ev
+request pushes to and pops from the environment stack,
+while
+.B evc
+copies a named environment's contents to the current one.
+.\" END Keep (roughly) parallel with groff.texi node "Environments".
 .
 .
 .\" ====================================================================
-.SS Underlining macro definitions
+.SH Underlining
 .\" ====================================================================
 .
-So one can use the
-.I italic
-.B nroff
-idea from
+In
+.I RUNOFF
+(see
+.MR roff @MAN7EXT@ ),
+underlining,
+even of lengthy passages,
+was straightforward because only fixed-pitch printing devices were
+targeted.
+.
+Typesetter output posed a greater challenge.
+.
+There exists a
+.I groff
+request
 .B .ul
-and the
-.B troff
-definition
-in
+(see above)
+that underlines subsequent source lines on terminal devices,
+but on typesetters,
+it selects an italic font style instead.
+.
+.
+The
 .I ms
-for writing a useful new macro, something like
+macro package
+(see
+.MR groff_ms @MAN7EXT@ )
+offers a macro
+.BR .UL ,
+but it too produces the desired effect only on typesetters,
+and has other limitations.
+.
+.
+.P
+One could adapt
+.IR ms 's
+approach to the construction of a macro as follows.
 .
 .RS
 .EX
@@ -4478,25 +7692,29 @@
 .RE
 .
 If
-.BR doclifter (1)
+.MR doclifter 1
 makes trouble, change the macro name
 .B UNDERLINE
 into some 2-letter word, like
 .BR Ul .
 .
-Moreover change the font writing from
+Moreover,
+change the form of the font selection escape sequence from
 .B \rsfP
 to
 .BR \rsfP .
 .
 .
 .\" ====================================================================
-.SS Underlining without macro definitions
+.SS "Underlining without macro definitions"
 .\" ====================================================================
 .
-If one does not want to use macro definitions, e.g., when
-.B doclifter
-gets lost, use the following:
+If one does not want to use macro definitions,
+e.g.,
+when
+.I doclifter
+gets lost,
+use the following.
 .
 .RS
 .EX
@@ -4510,13 +7728,15 @@
 .EE
 .RE
 .
-Due to
-.BR doclifter ,
-it might be necessary to change the variable writing
+.ne 2v
+When using
+.IR doclifter ,
+it might be necessary to change syntax forms such as
 .B \exy
 and
 .B \e*xy
-into the strange ancient writing
+to those supported by AT&T
+.IR troff :
 .B \e*(xy
 and
 .BR \e(xy ,
@@ -4531,8 +7751,8 @@
 \&.ds u2 in
 \&.ds u3 after
 \&.ie n \rs*u1\rsfI\rs*(u2\rsfP\rs*(u3
-\&.el \rs*(u1\rsZ\aq\rs*(u2\aq\rsv\aq.25m'\rsD\aql \
-\rsw\aq\rs*(u2\aqu 0\aq\rsv\aq\-.25m\aq\rs*(u3
+\&.el \rs*(u1\rsZ\aq\rs*(u2\aq\rsv\aq.25m\aq\rsD\
+\aql \rsw\aq\rs*(u2\aqu 0\aq\rsv\aq\-.25m\aq\rs*(u3
 .EE
 .RE
 .
@@ -4550,187 +7770,286 @@
 .
 .
 .\" ====================================================================
-.SS Underlining with Overstriking \ez and \e(ul
+.SS "Underlining by overstriking with \e(ul"
 .\" ====================================================================
 .
-There is another possibility for underlining by using overstriking
-with
-.BI \ez c
-(print
+The
+.B \rsz
+escape sequence writes a glyph without advancing the
+drawing position,
+enabling overstriking.
+.
+Thus,
+.BI \rsz c \rs(ul
+formats
 .I c
-with zero width without spacing) and
-.B \e(ul
-(underline character).
+with an underrule glyph on top of it.
 .
-This produces the underlining of 1 character, both in
-.B nroff
-and in
-.BR troff .
-.
-.
-.P
-For example the underlining of a character say
-.B t
-looks like
-.B \ez\eult
-or
-.B \ez\e(ult
+Video terminals implement the underrule by setting a character cell's
+underline attribute,
+so this technique works in both
+.I nroff \" mode
+and
+.I troff \" mode
+modes.
 .
 .
 .P
-Longer words look then a bit strange, but a useful mode is to write
-each character into a whole own line.
+Long words may then look intimidating in the input;
+a clarifying approach might be to use the input line continuation escape
+sequence
+.BI \rs newline
+to place each underlined character on its own input line.
 .
-To underlines the 3 character part "tar" of the word "start":
+Thus,
 .
 .RS
 .EX
-.br
-before s\rs
-\rsz\rsult\rs
-\rsz\rsula\rs
-\rsz\rsulr\rs
-t after
+\&.nf
+\rs&\rsfB: ${\rsfIvar\rsfR\rsc
+\rszo\rs(ul\rs
+\rszp\rs(ul\rsc
+\rs&\rsfIvalue\rsfB}
+\&.fi
 .EE
 .RE
 .
-or
+produces
 .
 .RS
 .EX
-.br
-before s\rs
-\rsz\rs(ult\rs
-\rsz\rs(ula\rs
-\rsz\rs(ulr\rs
-t after
+.BI ": ${" var \c
+\zo\(ul\
+\zp\(ul\c
+.IB value }
 .EE
 .RE
 .
+as output.
 .
-.P
-The result looks like
-.RS
-.ft CR
-before s\
-\z\ult\
-\z\ula\
-\z\ulr\
-t after
-.ft R
-.RE
 .
 .\" ====================================================================
-.SH COMPATIBILITY
+.SH "Compatibility mode"
 .\" ====================================================================
 .
-The differences between the groff language and classical troff as
-defined by
-CSTR\~#54
-are documented in
-.BR groff_diff (@MAN7EXT@).
+The differences between the
+.I roff
+language recognized by GNU
+.I troff \" GNU
+and that of AT&T
+.IR troff , \" AT&T
+as well as the device,
+font,
+and device-independent intermediate output formats described by
+CSTR\~#54 are documented in
+.MR groff_diff @MAN7EXT@ .
 .
+.I groff
+provides an AT&T compatibility mode.
 .
-.P
-The groff system provides a compatibility mode, see
-.BR groff (@MAN1EXT@)
-on how to invoke this.
+The
+.request .cp
+request and registers
+.B .C
+and
+.B .cp
+set and test the enablement of this mode.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Debugging
 .\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Debugging".
+Preprocessors use the
+.B .lf
+request to preserve the identities of line numbers and names of input
+files.
+.
+.I groff
+emits a variety of error diagnostics and supports several categories of
+warning;
+the output of these can be selectively suppressed with
+.B .warn
+(and see the
+.BR \-E ,
+.BR \-w ,
+and
+.B \-W
+options of
+.MR @g@troff @MAN1EXT@ ).
+.
+A trace of the formatter's input processing stack can be emitted when
+errors or warnings occur by means of
+.MR @g@troff @MAN1EXT@ 's
+.B \-b
+option,
+or produced on demand with the
+.request .backtrace
+request.
+.
+.BR .tm ,
+.BR .tmc ,
+and
+.B .tm1
+can be used to emit customized diagnostic messages or for
+instrumentation while troubleshooting.
+.
+.B .ex
+and
+.B .ab
+cause early termination with successful and error exit codes
+respectively,
+to halt further processing when continuing would be fruitless.
+.
+Examine the state of the formatter with requests that write lists of
+defined names\emmacros,
+strings,
+and
+.RB diversions\em( .pm );
+environments
+.RB ( .pev ),
+registers
+.RB ( .pnr ),
+and page location traps
+.RB ( .ptr )
+to the standard error stream.
+.\" END Keep (roughly) parallel with groff.texi node "Debugging".
+.
+.
+.\" ====================================================================
+.SH Authors
+.\" ====================================================================
+.
 This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
+by Trent A.\& Fisher,
+Werner Lemberg,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
+.ME .
+.
+Section \lqUnderlining\rq was primarily written by
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
+.ne 2v
 .IR "Groff: The GNU Implementation of troff" ,
 by Trent A.\& Fisher and Werner Lemberg,
 is the primary
 .I groff
 manual.
 .
-You can browse it interactively with \(lqinfo groff\(rq.
+You can browse it interactively with \lqinfo groff\rq.
 .
-Besides the gory details, it contains many examples.
 .
+.br
+.ne 4v
+.P
+\lqTroff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
+widely called simply \lqCSTR\~#54\rq,
+documents the language,
+device and font description file formats,
+and device-independent output format
+referred to collectively in
+.I groff
+documentation as
+.RI \lqAT&T\~ troff \rq.
 .
-.TP
-.BR groff (@MAN1EXT@)
-the usage of the groff program and pointers to the documentation and
-availability of the groff system.
 .
-.TP
-.BR groff_diff (@MAN7EXT@)
-describes the differences between the groff language and classical
-troff.
+.br
+.ne 3v
+.P
+\lqA Typesetter-independent TROFF\rq
+by Brian W.\& Kernighan,
+1982,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 97
+(CSTR\~#97),
+provides additional insights into the
+device and font description file formats
+and device-independent output format.
 .
-.IP
-This is the authoritative document for the predefined language
-elements that are specific to groff.
 .
 .TP
-.BR groff_char (@MAN7EXT@)
-the predefined groff special characters (glyphs).
+.MR groff @MAN1EXT@
+is the preferred interface to the
+.I groff
+system;
+it manages the pipeline that carries a source document through
+preprocessors,
+the
+.I @g@troff
+formatter,
+and an output driver to viewable or printable form.
+.
+It also exhaustively lists the man pages provided with the GNU
+.I roff
+system.
 .
-.TP
-.BR groff_font (@MAN5EXT@)
-the specification of fonts and the DESC file.
 .
 .TP
-.BR groff_tmac (@MAN5EXT@)
-contains an overview of available groff macro packages, instructions on
-how to interface them with a document, guidance on writing macro
-packages and using diversions, and historical information on macro
-package naming conventions.
-.TP
-.BR roff (@MAN7EXT@)
-the history of roff, the common parts shared by all roff systems, and
-pointers to further documentation.
+.MR groff_char @MAN7EXT@
+discusses character encoding issues,
+escape sequences that produce glyphs,
+and enumerates
+.IR groff 's
+predefined special character escape sequences.
+.
 .
 .TP
-CSTR\~#54
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
-Nroff/\:Troff User's Manual by Ossanna & Kernighan
-.UE
-\em the bible for classical troff.
+.MR groff_diff @MAN7EXT@
+covers differences between the
+GNU
+.I troff \" GNU
+formatter,
+its device and font description file formats,
+its device-independent output format,
+and those of AT&T
+.IR troff ,\" AT&T
+whose design it reimplements.
+.
 .
 .TP
-.I Wikipedia
-article about
-.I groff
-.UR https://\:en.wikipedia.org/\:wiki/\:Groff_%28software%29
-.UE .
+.MR groff_font @MAN5EXT@
+describes the formats of the files that describe devices
+.RI ( DESC )
+and fonts.
+.
 .
 .TP
-.I Tutorial about groff
-.UR dl.dropbox.com/\:u/\:4299293/\:grofftut.pdf
-Manas Laha - An Introduction to the GNU Groff Text Processing System
-.UE
+.MR groff_tmac @MAN5EXT@
+surveys macro packages provided with
+.IR groff ,
+describes how documents can take advantage of them,
+offers guidance on writing macro packages and using diversions,
+and includes historical information on macro package naming conventions.
+.
 .
 .TP
-.I troff.org
-This is a collection of internet sites with classical
+.MR roff @MAN7EXT@
+presents a detailed history of
 .I roff
-documentations and other information.
+systems and summarizes concepts common to them.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_7_C
+.cp \n*groff_groff_7_man_C
+.do rr *groff_groff_7_man_C
 .
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/groff_char.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff_char.7.man Changed

@@ -1,20 +1,16 @@
 '\" t
-.TH GROFF_CHAR @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_char \- groff glyph names
-.
-.\" For best results, format this document with 'groff' (GNU roff).
-.
-.\" groff_char(7):
-.\" Source file position: <groff_source>/man/groff_char.man
-.\" Installed position: <prefix>/share/man/man7/groff_char.7
+.TH groff_char @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_char \- GNU
+.I roff
+special character and glyph repertoire
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff (GNU roff), which is a free software
 .\" project.
@@ -30,1328 +26,2170 @@
 .\" If not, see <http://www.gnu.org/licenses/gpl-2.0.html>.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_char_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.\" Setup
+.SH Description
 .\" ====================================================================
 .
+The GNU
+.I roff
+typesetting system has a large glyph repertoire suitable for production
+of varied literary,
+professional,
+technical,
+and mathematical documents.
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_char_C \n.C
-.cp 0
+.I groff
+works with
+.I characters;
+an output device renders
+.I glyphs.
+.
+.IR groff 's
+input character set is restricted to that defined by the standards
+ISO Latin-1
+(ISO 8859-1)
+and CCSID \lqcode page\rq 1047
+(an EBCDIC arrangement of Latin-1).
+.
+For ease of document maintenance in UTF-8 environments,
+it is advisable to use only the Unicode basic Latin code points,
+a subset of all of the foregoing historically referred to as \%US-ASCII,
+.\" Yes, a subset, albeit a permutation as well in the cp1047 case.
+which has only 94 visible,
+printable code points.
+.\" In groff, 0x20 SP is mapped to a space node, not a glyph node, and
+.\" all kinds of special behavior attaches to such nodes, so we count
+.\" only to 94 and not 95 as is often done in other ASCII contexts.
+In
+.I groff,
+these are termed
+.I "ordinary characters."
 .
+Often,
+many more are desired in output.
 .
-.\" groff only
-.\".if \n(.g .ne 2v
-.\".if \n(.g .sv 2v
 .
-.ds aq \(aq
+.P
+AT&T
+.I troff
+in the 1970s faced a similar problem:
+the available typesetter's glyph repertoire differed from that of the
+computers that controlled it.
+.
+.IR troff 's \" AT&T
+solution was a form of escape sequence known as a
+.I special character
+to access several dozen additional glyphs available in the fonts
+prepared for mounting in the phototypesetter.
+.
+These glyphs were mapped onto a two-character name space for a degree
+of mnemonic convenience;
+for example,
+the escape sequence
+.B \e(aa
+encoded an acute accent and
+.B \e(sc
+a section sign.
 .
-.\" non-groff
-.if !\n(.g .if '\(aq'' .ds aq \'
 .
-.nr Sp 2n
+.P
+.I groff
+has lifted historical
+.I roff
+limitations on special character name lengths,
+but recognizes and retains compatibility with the historical names.
+.
+.I groff
+expands the lexicon of glyphs available by name and permits users to
+define their own special character escape sequences with the
+.B char
+request.
 .
-.do if !r ECFONTS .do fspecial CR R
+Special character names are
+.I groff
+identifiers;
+see section \lqIdentifiers\rq in
+.MR groff @MAN7EXT@ .
 .
+Our discussion uses the terms \lqglyph name\rq and \lqspecial
+character name\rq interchangeably;
+we assume no character translations or redefinitions.
 .
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
 .
-This manual page lists the standard
-.B groff
-glyph names and the default input mapping, \%latin1.
+.P
+This document lists all of the glyph names predefined by
+.IR groff 's
+font description files and presents the systematic notation by which it
+enables access to arbitrary Unicode code points and construction of
+composite glyphs.
 .
-The glyphs in this document look different depending on which output
-device was chosen (with option
-.B \-T
-for the
-.BR man (1)
-program or the roff formatter).
+Glyphs listed may be unavailable,
+or may vary in appearance,
+depending on the output device and font chosen when the page was
+formatted.
 .
-Glyphs not available for the device that is being used to print or
-view this manual page are marked with
-.ie \n(.g \oq(N/A)\cq; the device currently used is \oq\*(.T\cq.
-.el \oq(N/A)\cq.
+This page was rendered for device
+.B \*.T
+using font
+.BR \n.fn .
 .
 .
 .P
-In the actual version,
-.B groff
-provides only \%8-bit characters for direct input and named entities
-for further glyphs.
-.
-On ASCII platforms, input character codes in the range 0 to 127
-(decimal) represent the usual \%7-bit ASCII characters, while codes
-between 127 and 255 are interpreted as the corresponding characters in
-the
-.I \%latin1
-.RI ( \%ISO-8859-1 )
-code set by default.
-.
-This mapping is contained in the file \f(CWlatin1.tmac\fP
-and can be changed by loading a different input encoding.
+A few escape sequences that are not
+.I groff
+special characters also produce glyphs;
+these exist for syntactical or historical reasons.
 .
-Note that some of the input characters are reserved by
-.BR groff ,
-either for internal use or for special input purposes.
+.BR \e\aq ,
+.BR \e\ga ,
+.BR \e\- ,
+and
+.B \e_
+are translated on input to the special character escape sequences
+.BR \eaa ,
+.BR \ega ,
+.BR \e\- ,
+and
+.BR \eul ,
+respectively.
 .
-On EBCDIC platforms, only code page
-.I cp1047
-is supported (which contains the same characters as \%latin1; the
-input encoding file is called \f(CWcp1047.tmac\fP).
+Others include
+.BR \e\e ,
+.B \e.\&
+(backslash-dot),
+and
+.BR \ee ;
+see
+.MR groff @MAN7EXT@ .
 .
-Again, some input characters are reserved for internal and special
-purposes.
+A small number of special characters represent glyphs that are not
+encoded in Unicode;
+examples include the baseline rule
+.B \eru
+and the Bell System logo
+.B \ebs.
 .
 .
 .P
-All roff systems provide the concept of named glyphs.
-.
-In traditional roff systems, only names of length\ 2 were used, while
-groff also provides support for longer names.
+In
+.IR groff ,
+you can test output device support for any character
+(ordinary or special)
+with the conditional expression operator
+.RB \lq c \rq.
 .
-It is strongly suggested that only named glyphs are used for all
-character representations outside of the printable \%7-bit ASCII range.
+.RS
+.\" https://www.bell-labs.com/usr/dmr/www/ ("In 1984, ...")
+.EX
+\&.ie c \ebs \e{Welcome to the \ebs Bell System;
+did you get the Wehrmacht helmet or the Death Star?\e}
+\&.el No Bell System logo.
+.EE
+.RE
 .
 .
 .P
-Some of the predefined groff escape sequences (with names of length\ 1)
-also produce single glyphs; these exist for historical reasons or
-are printable versions of syntactical characters.
-.
-They include
-\oq\f(CW\e\e\fP\cq,
-\oq\f(CW\e\aq\fP\cq,
-\oq\f(CW\e\ga\fP\cq,
-\oq\f(CW\e\-\fP\cq,
-\oq\f(CW\e.\fP\cq,
-and
-\oq\f(CW\ee\fP\cq;
-see
-.BR groff (@MAN7EXT@).
+For brevity in the remainder of this document,
+we shall refer to systems conforming to the
+ISO 646:1991 IRV,
+ISO 8859,
+or
+ISO 10646 (\lqUnicode\rq)
+character encoding standards as \lqISO\rq systems,
+and those employing IBM code page 1047 as \lqEBCDIC\rq systems.
+.
+That said,
+EBCDIC systems that support
+.I groff
+are known to also support UTF-8.
 .
 .
 .P
-In groff, all of these different types of characters and glyphs can be
-tested positively with the \oq\f(CW.if\ c\fP\cq conditional.
+While
+.I groff
+accepts eight-bit encoded input,
+not all such code points are valid as input.
+.
+.\" src/libs/libgroff/invalid.cpp
+On ISO platforms,
+character codes
+0,
+11,
+13\en31,
+and
+128\en159
+are invalid.
+.
+(This is all C0 and C1 controls except for
+SOH through LF
+Control+A to Control+J,
+and FF
+Control+L.)
+.
+On EBCDIC platforms,
+0,
+8\en9,
+11,
+13\en20,
+23\en31,
+and
+48\en63
+are invalid.
+.
+Some of these code points are used by
+.I groff
+for internal purposes,
+which is one reason it does not support UTF-8 natively.
 .
 .
 .\" ====================================================================
-.SH REFERENCE
+.SS "Fundamental character set"
 .\" ====================================================================
 .
-In this section, the glyphs in groff are specified in tabular
-form.
+The ordinary characters catalogued above,
+plus the space,
+tab,
+newline,
+and leader (Control+A),
+form the fundamental character
+set for
+.I groff
+input;
+anything in the language,
+even over one million code points in Unicode,
+can be expressed using it.
 .
-The meaning of the columns is as follows.
+On ISO systems,
+code points in the range 33\en126 comprise a common set of
+printable glyphs in all of the aforementioned ISO character encoding
+standards.
 .
+It is this character set and
+(with some noteworthy exceptions)
+the corresponding glyph repertoire for which AT&T
+.I troff
+was implemented.
 .
-.TP
-.I "Output"
-shows how the glyph is printed for the current device; although
-this can have quite a different shape on other devices, it always
-represents the same glyph.
+On EBCDIC systems,
+printable characters are in the range 66\en201 and 203\en254;
+those without counterparts in the ISO range 33\en126 are discussed
+in the next subsection.
+.\" From this point, do not talk about numerical character assignments.
 .
 .
-.TP
-.I "Input"
-specifies how the glyph is input either directly by a key on the
-keyboard, or by a groff escape sequence.
+.P
+All of the following characters map to glyphs as you would expect.
 .
+.TS
+center box;
+Lf(CR).
+! # $ % & ( ) * + , . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @
+A B C D E F G H I J K L M N O P Q R S T U V W X Y Z   _
+a b c d e f g h i j k l m n o p q r s t u v w x y z { | }
+.TE
+.\" The bottom border of that box is practically kissin' the tittles.
+.if t .sp 0.2v
 .
-.TP
-.I "Code"
-applies to glyphs which can be input with a single character, and
-gives the ISO \%latin1 decimal code of that input character.
+The remaining ordinary characters surprise computing professionals and
+others intimately familiar with the ISO character encodings.
 .
-Note that this code is equivalent to the lowest 256 Unicode characters,
-including \%7-bit ASCII in the range 0 to\ 127.
+The developers of AT&T
+.I troff
+chose mappings for them that would be useful for typesetting technical
+literature in a broad range of scientific disciplines:
+Bell Labs used the system for preparation of AT&T's patent filings with
+the U.S.\& government.
 .
+Further,
+the prevailing character encoding standard in the 1970s,
+USAS X3.4-1968 (\lqASCII\rq),
+deliberately supported semantic ambiguity at some code points,
+and outright substitution at several others,
+to suit the localization demands of various national standards bodies.
 .
-.TP
-.I "PostScript"
-gives the usual PostScript name of the glyph.
 .
+.P
+The table below presents the seven exceptional code points
+with their typical keycap engravings,
+their glyph mappings and semantics in
+.I roff
+systems,
+and the escape sequences producing the Unicode basic Latin character
+they replace.
+.
+The first,
+the neutral double quote,
+is a partial exception because it does represent itself,
+but since the
+.I roff
+language also uses it to quote macro arguments,
+.I groff
+supports a special character escape sequence as an alternative form so
+that the glyph can be easily included in macro arguments without
+requiring the user to master the quoting rules that AT&T
+.I troff
+required in that context.
+.
+(Some requests,
+like
+.BR ds ,
+also treat
+.B \dq
+non-literally.)
+.
+Furthermore,
+not all of the special character escape sequences are portable to AT&T
+.I troff
+and all of its descendants;
+these
+.I groff
+extensions are presented using its special character form
+.BR \rs ,
+whereas portable special character escape sequences are shown in the
+traditional
+.B \rs(
+form.
 .
-.TP
-.I "Unicode"
-is the glyph name used in composite glyph names.
+.B \rs\-
+and
+.B \rse
+are portable to all known
+.IR troff s.
+.
+.B \rse
+means \lqthe glyph of the current escape character\rq;
+it therefore can produce unexpected output if the
+.B ec
+request is used.
+.
+On devices with a limited glyph repertoire,
+glyphs in the \lqkeycap\rq and \lqappearance\rq columns on the
+same row of the table may look identical;
+except for the neutral double quote,
+this will
+.I not
+be the case on more-capable devices.
 .
-The names in the Unicode column look like
-.B u0021
-or
-.BR u0041_0300 .
+Review your document using as many different output devices as possible.
 .
-In groff, the corresponding Unicode characters can be constructed
-by adding a backslash and a pair of square brackets, for example
-.B \eu0021
-or
-.BR \eu0041_0300 .
 .
+.P
+.TS
+center box;
+L L L.
+Keycap	Appearance and meaning	Special character and meaning
+_
+"	" neutral double quote	\fCR\rsdq\f neutral double quote
+\aq	\cq closing single quote	\fCR\rsaq\f neutral apostrophe
+\-	- hyphen	\fCR\rs\-\f or \fCR\rs\-\f minus sign/Unix dash
+\rs	(escape character)	\fCR\rse\f or \fCR\rsrs\f reverse solidus
+\ha	\u02C6 modifier circumflex	\fCR\rs(ha\f circumflex/caret/\lqhat\rq
+\ga	\oq opening single quote	\fCR\rs(ga\f grave accent
+\ti	\u02DC modifier tilde	\fCR\rs(ti\f tilde
+.TE
 .
-.\" ====================================================================
-.SS "7-bit Character Codes 32\(en126"
-.\" ====================================================================
 .
-These are the basic glyphs having 7-bit ASCII code values assigned.
+.P
+The hyphen-minus is a particularly unfortunate case of overloading.
+.
+Its awkward name in ISO 8859 and later standards reflects the many
+distinguishable purposes to which it had already been put by the 1980s,
+including
+a hyphen,
+a minus sign,
+and
+(alone or in repetition)
+dashes of varying widths.
+.
+For best results in
+.I roff
+systems,
+use the
+.RB \lq \- \rq
+character in input outside an escape sequence
+.I only
+to mean a hyphen,
+as in the phrase \lqlong-term\rq.
+.
+For a minus sign in running text or a Unix command-line option dash,
+use
+.B \rs\-
+(or
+.B \rs\-
+in
+.I groff
+if you find it helps the clarity of the source document).
 .
-They are identical to the printable characters of the
-character standards \%ISO-8859-1 (\%latin1) and Unicode (range
-.IR "Basic Latin" ).
+(Another minus sign,
+for use in mathematical equations,
+is available as
+.BR \rsmi ).
 .
-The glyph names used in composite glyph names are \oqu0020\cq up
-to \oqu007E\cq.
+AT&T
+.I troff
+supported em-dashes as
+.BR \rs(em ,
+as does
+.IR groff .
 .
 .
 .P
-Note that input characters in the range \%0\-31 and character 127 are
-.I not
-printable characters.
+The special character escape sequence for the apostrophe as a neutral
+single quote is typically needed only in technical content;
+typing words like \lqcan't\rq and \lqAnne's\rq in a natural way
+will render correctly,
+because in ordinary prose an apostrophe is typeset either as a closing
+single quotation mark or as a neutral single quote,
+depending on the capabilities of the output device.
+.
+By contrast,
+special character escape sequences should be used for quotation marks
+unless portability to limited or historical
+.I troff
+implementations is necessary;
+on those systems,
+the input convention is to pair the grave accent with the apostrophe for
+single quotes,
+and to double both characters for double quotes.
+.
+AT&T
+.I troff
+defined no special characters for quotation marks or the apostrophe.
+.
+Repeated single quotes
+(\oq\oqthus\cq\cq)
+will be visually distinguishable from double quotes
+(\lqthus\rq)
+on terminal devices,
+and perhaps on others
+(depending on the font selected).
 .
-Most of them are invalid input characters for
-.B groff
-anyway, and the valid ones have special meaning.
+.TS
+tab(@) center box;
+L L.
+AT&T \fItroff\f input@recommended \fIgroff\f input
+_
+.T&
+Lf(CR) Lf(CR).
+A Winter\aqs Tale@A Winter\aqs Tale
+\gaU.K.\& outer quotes\aq@\rsoqU.K.\& outer quotes\rscq
+\gaU.K.\& \ga\gainner\aq\aq quotes\aq\
+@\rsoqU.K.\& \rslqinner\rsrq quotes\rscq
+\ga\gaU.S.\& outer quotes\aq\aq\
+@\rslqU.S.\& outer quotes\rsrq
+\ga\gaU.S.\& \gainner\aq quotes\aq\aq\
+@\rslqU.S.\& \rsoqinner\rscq quotes\rsrq
+.TE
+.\" Keep bottom border of box from sitting on the ascenders below.
+.if t .sp 0.2v
 .
-For EBCDIC, the printable characters are in the range \%66\-255.
+If you frequently require quotation marks in your document,
+see if the macro package you're using supplies strings or macros to
+facilitate quotation,
+or define them yourself
+(except in man pages).
 .
 .
-.TP
-48\-57
-Decimal digits 0 to\ 9 (print as themselves).
+.P
+Using Unicode basic Latin characters to compose boxes and lines is
+ill-advised.
 .
+.I roff
+systems have special characters for drawing horizontal and vertical
+lines;
+see subsection \lqRules and lines\rq below.
 .
-.TP
-65\-90
-Upper case letters A\-Z (print as themselves).
+Preprocessors like
+.MR @g@tbl @MAN1EXT@
+and
+.MR @g@pic @MAN1EXT@
+draw boxes and will produce the best possible output for the device,
+falling back to basic Latin glyphs only when necessary.
 .
 .
-.TP
-97\-122
-Lower case letters a\(enz (print as themselves).
+.\" ====================================================================
+.SS "Eight-bit encodings and Latin-1 supplement"
+.\" ====================================================================
 .
+ISO 646 is a seven-bit code encoding 128 code points;
+eight-bit codes are twice the size.
 .
-.P
-Most of the remaining characters not in the just described ranges print
-as themselves; the only exceptions are the following characters:
+ISO 8859-1 and code page 1047 allocated the additional space to what
+Unicode calls \lqC1 controls\rq
+(control characters)
+and the \lqLatin-1 supplement\rq.
 .
+The C1 controls are neither printable nor usable as
+.I groff
+input.
 .
-.TP
-.B \`
-the ISO \%latin1 \oqGrave Accent\cq (code\ 96) prints as \oq, a
-left single quotation mark (Unicode u2018).
-The same output glyph can be requested explicitly
-with \oq\f(CW\e(oq\fP\cq.
-The original character can be obtained
-with \oq\f(CW\e`\fP\cq (Unicode u0060).
 .
+.P
+Two Latin-1 supplement characters are handled specially on input.
 .
-.TP
-.B \*(aq
-the ISO \%latin1 \oqApostrophe\cq (code\ 39) prints as \cq,
-a right single quotation mark (Unicode u2019).
-The same output glyph is commonly used in typography to represent
-a punctation apostrophe, for example in contractions.
-It can be requested explicitly with \oq\f(CW\e(cq\fP\cq.
-The original character can be obtained with
-\oq\f(CW\e(aq\fP\cq (Unicode u0027).
+.I @g@troff
+never produces them as output.
 .
 .
 .TP
-.B -
-the ISO \%latin1 \oqHyphen, Minus Sign\cq (code\ 45) prints as a
-hyphen (Unicode u2010).
-The same output glyph can be requested explicitly
-with \oq\f(CW\e(hy\fP\cq.
-A minus sign can be obtained with \oq\f(CW\e-\fP\cq (Unicode u2212).
+NBSP
+encodes a no-break space;
+it is mapped to
+.BR \rs\ti ,
+the adjustable non-breaking space escape sequence.
 .
 .
 .TP
-.B ~
-the ISO \%latin1 \oqTilde\cq (code\ 126) is reduced in size to be
-usable as a diacritic (Unicode u02DC).
-A larger glyph can be obtained with
-\oq\f(CW\e(ti\fP\cq (Unicode u007E).
+SHY
+encodes a soft hyphen;
+it is mapped to
+.BR \rs% ,
+the hyphenation control escape sequence.
 .
 .
-.TP
-.B ^
-the ISO \%latin1 \oqCircumflex Accent\cq (code\ 94) is reduced in
-size to be usable as a diacritic (Unicode u02C6); a larger glyph
-can be obtained with \oq\f(CW\e(ha\fP\cq (Unicode u005E).
+.P
+The remaining characters in the Latin-1 supplement represent
+themselves.
+.
+Although they can be specified directly with the keyboard on systems
+configured to use Latin-1 as the character encoding,
+it is more portable,
+both to other
+.I roff
+systems and to UTF-8 environments,
+to use their special character escape sequences,
+shown below.
+.
+The glyph descriptions we use are non-standard in some cases,
+for brevity.
 .
 .
 .P
-.na
 .TS
-l l l l l lx.
-Output	Input	Code	PostScript	Unicode	Notes
-_
-\char33	\char33	33	exclam	u0021	exclamation mark (bang)
-\char34	\char34	34	quotedbl	u0022	double quote
-\char35	\char35	35	numbersign	u0023	number sign
-\char36	\char36	36	dollar	u0024	currency dollar sign
-\char37	\char37	37	percent	u0025	percent
-\char38	\char38	38	ampersand	u0026	ampersand
-\cq	\aq	39	quoteright	u2019	right quote
-\aq	\e(aq		quotesingle	u0027	apostrophe quote
-\char40	\char40	40	parenleft	u0028	parentheses left
-\char41	\char41	41	parenright	u0029	parentheses right
-\char42	\char42	42	asterisk	u002A	asterisk
-\char43	\char43	43	plus	u002B	plus
-\char44	\char44	44	comma	u002C	comma
-\hy	\char45	45	hyphen	u2010	hyphen
-\-	\e-		minus	u2212	minus sign
-\char46	\char46	46	period	u002E	period, dot
-\char47	\char47	47	slash	u002F	slash
-\char58	\char58	58	colon	u003A	colon
-\char59	\char59	59	semicolon	u003B	semicolon
-\char60	\char60	60	less	u003C	less than
-\char61	\char61	61	equal	u003D	equal
-\char62	\char62	62	greater	u003E	greater than
-\char63	\char63	63	question	u003F	question mark
-\char64	\char64	64	at	u0040	at
-\char91	\char91	91	bracketleft	u005B	square bracket left
-\char92	\char92	92	backslash	u005C	backslash
-\char93	\char93	93	bracketright	u005D	square bracket right
-\a^	\ha	94	circumflex	u02C6	modifier circumflex
-\ha	\e(ha		asciicircum	u005E	circumflex accent
-\char95	\char95	95	underscore	u005F	underscore
-\oq	\ga	96	quoteleft	u2018	left quote
-\ga	\e(ga		grave	u0060	grave accent
-\char123	\char123	123	braceleft	u007B	curly brace left
-\char124	\char124	124	bar	u007C	bar
-\char125	\char125	125	braceright	u007D	curly brace right
-\u02DC	\ti	126	tilde	u02DC	small tilde
-\ti	\e(ti		asciitilde	u007E	tilde
+L2 Lf(CR)1 L L2 Lf(CR)1 L.
+\r!	\er!	inverted exclamation mark	\~N	\e\tiN	N tilde
+\ct	\ect	cent sign	\`O	\e\gaO	O grave
+\Po	\ePo	pound sign	\'O	\e\aqO	O acute
+\Cs	\eCs	currency sign	\^O	\e\haO	O circumflex
+\Ye	\eYe	yen sign	\~O	\e\tiO	O tilde
+\bb	\ebb	broken bar	\:O	\e:O	O dieresis
+\sc	\esc	section sign	\mu	\emu	multiplication sign
+\ad	\ead	dieresis accent	\/O	\e/O	O slash
+\co	\eco	copyright sign	\`U	\e\gaU	U grave
+\Of	\eOf	feminine ordinal indicator	\'U	\e\aqU	U acute
+\Fo	\eFo	left double chevron	\^U	\e\haU	U circumflex
+\no	\eno	logical not	\:U	\e:U	U dieresis
+\rg	\erg	registered sign	\'Y	\e\aqY	Y acute
+\a-	\ea\-	macron accent	\TP	\eTP	uppercase thorn
+\de	\ede	degree sign	\ss	\ess	lowercase sharp s
+\+-	\e+\-	plus-minus	\`a	\e\gaa	a grave
+\S2	\eS2	superscript two	\'a	\e\aqa	a acute
+\S3	\eS3	superscript three	\^a	\e\haa	a circumflex
+\aa	\eaa	acute accent	\~a	\e\tia	a tilde
+\mc	\emc	micro sign	\:a	\e:a	a dieresis
+\ps	\eps	pilcrow sign	\oa	\eoa	a ring
+\pc	\epc	centered period	\ae	\eae	ae ligature
+\ac	\eac	cedilla accent	\,c	\e,c	c cedilla
+\S1	\eS1	superscript one	\`e	\e\gae	e grave
+\Om	\eOm	masculine ordinal indicator	\'e	\e\aqe	e acute
+\Fc	\eFc	right double chevron	\^e	\e\hae	e circumflex
+\14	\e14	one quarter symbol	\:e	\e:e	e dieresis
+\12	\e12	one half symbol	\`i	\e\gai	i grave
+\34	\e34	three quarters symbol	\'i	\e\aqi	e acute
+\r?	\er?	inverted question mark	\^i	\e\hai	i circumflex
+\`A	\e\gaA	A grave	\:i	\e:i	i dieresis
+\'A	\e\aqA	A acute	\Sd	\eSd	lowercase eth
+\^A	\e\haA	A circumflex	\~n	\e\tin	n tilde
+\~A	\e\tiA	A tilde	\`o	\e\gao	o grave
+\:A	\e:A	A dieresis	\'o	\e\aqo	o acute
+\oA	\eoA	A ring	\^o	\e\hao	o circumflex
+\AE	\eAE	AE ligature	\~o	\e\tio	o tilde
+\,C	\e,C	C cedilla	\:o	\e:o	o dieresis
+\`E	\e\gaE	E grave	\di	\edi	division sign
+\'E	\e\aqE	E acute	\/o	\e/o	o slash
+\^E	\e\haE	E circumflex	\`u	\e\gau	u grave
+\:E	\e:E	E dieresis	\'u	\e\aqu	u acute
+\`I	\e\gaI	I grave	\^u	\e\hau	u circumflex
+\'I	\e\aqI	I acute	\:u	\e:u	u dieresis
+\^I	\e\haI	I circumflex	\'y	\e\aqy	y acute
+\:I	\e:I	I dieresis	\Tp	\eTp	lowercase thorn
+\-D	\e\-D	uppercase eth	\:y	\e:y	y dieresis
 .TE
-.ad
 .
 .
 .\" ====================================================================
-.SS "8-bit Character Codes 160 to 255"
+.SS "Special character escape forms"
 .\" ====================================================================
 .
-They are interpreted as printable characters according to the
-.I latin1
-.RI ( ISO-8859-1 )
-code set, being identical to the Unicode range
-.IR "Latin-1 Supplement" .
+Glyphs that lack a character code in the basic Latin repertoire to
+directly represent them are entered by one of several special character
+escape forms.
 .
+Such glyphs can be simple or composite,
+and accessed either by name or numerically by code point.
 .
-.P
-Input characters in range 128\-159 (on non-EBCDIC hosts) are not
-printable characters.
+Code points and combining properties are determined by character
+encoding standards,
+whereas glyph names as used here originated in AT&T
+.I troff \" AT&T
+special character escape sequences.
+.
+Predefined glyph names use only characters in the basic Latin
+repertoire.
 .
 .
 .TP
-160
+.BI \rs( gl
+is a special character escape sequence for the glyph with the
+two-character name
+.IR gl .
 .
-the ISO \%latin1
-.I no-break space
-is mapped to \oq\f(CW\e\(ti\fP\cq, the stretchable space
-character.
+This is the original syntax form supported by AT&T
+.IR troff .
+.
+The acute accent,
+.BR \rs(aa ,
+is an example.
 .
 .
 .TP
-173
+.BI \rsC\aq glyph-name \aq
+is a special character escape sequence for
+.IR glyph-name ,
+which can be of arbitrary length.
+.
+The delimiter,
+shown here as a neutral apostrophe,
+can be any character not occurring in
+.IR glyph-name .
+.
+This syntax form was introduced in later versions of AT&T
+device-independent
+.IR troff . \" AT&T
 .
-the soft hyphen control character.
+The foregoing acute accent example can be expressed
+as
+.BR \rsC\aqaa\aq .
 .
-.B groff
-never uses this character for output (thus it is omitted in the table
-below); the input character\ 173 is mapped onto \oq\f(CW\e%\fP\cq.
+.
+.TP
+.BI \rs glyph-name 
+is a special character escape sequence for
+.IR glyph-name ,
+which can be of arbitrary length but must not contain a closing square
+bracket
+.RB \lq  \rq.
+.
+(No glyph names predefined by
+.I groff
+employ
+.RB \lq  \rq.)
+.
+The foregoing acute accent example can be expressed in
+.I groff
+as
+.BR \rsaa .
 .
 .
 .P
-The remaining ranges (\%161\-172, \%174\-255)
-are printable characters that print as themselves.
+.BI \rsC\aq c \aq
+and
+.BI \rs c 
+are not synonyms for the ordinary character
+.RI \lq c \rq,
+but request the special character named
+.RB \lq \rs \c
+.IR c \rq.
+.
+For example,
+.RB \lq \rsa \rq
+is not \lqa\rq,
+but rather a special character with the internal glyph name
+(used in font description files and diagnostic messages)
+.BR \rsa ,
+which is typically undefined.
+.
+The only such glyph name
+.I groff
+predefines is the minus sign,
+which can therefore be accessed as
+.B \rsC\aq\-\aq
+or
+.BR \rs\- .
+.
+.
+.TP
+.BI \rs "base-char composite-1 composite-2"\~\c
+\&.\|.\|.\~\c
+.IB composite-n 
+is a composite glyph.
+.
+Glyphs like a lowercase \lqe\rq with an acute accent,
+as in the word \lqcaf\e aa\rq,
+can be expressed as
+.BR "\rse aa" .
+.
+See subsection \lqAccents\rq below for a table of combining glyph
+names.
 .
-Although they can be specified directly with the keyboard on systems
-with a \%latin1 code page, it is better to use their glyph names;
-see the next section.
 .
 .P
-.na
-.TS
-l l l l l lx.
-Output	Input	Code	PostScript	Unicode	Notes
-_
-\char161	\char161	161	exclamdown	u00A1	inverted exclamation mark
-\char162	\char162	162	cent	u00A2	currency unit
-\char163	\char163	163	sterling	u00A3	pound sterling
-\char164	\char164	164	currency	u00A4	generic currency symbol
-\char165	\char165	165	yen	u00A5	Japanese currency symbol
-\char166	\char166	166	brokenbar	u00A6	broken bar
-\char167	\char167	167	section	u00A7	section sign
-\char168	\char168	168	dieresis	u00A8	dieresis (umlaut)
-\char169	\char169	169	copyright	u00A9	copyright symbol
-\char170	\char170	170	ordfeminine	u00AA	feminine ordinal (Spanish)
-\char171	\char171	171	guillemotleft	u00AB	left guillemet sic
-\char172	\char172	172	logicalnot	u00AC	logical not
-\char174	\char174	174	registered	u00AE	registered mark symbol
-\char175	\char175	175	macron	u00AF	overbar accent
-\char176	\char176	176	degree	u00B0	degree sign
-\char177	\char177	177	plusminus	u00B1	plus-minus sign
-\char178	\char178	178	twosuperior	u00B2	superscript 2
-\char179	\char179	179	threesuperior	u00B3	superscript 3
-\char180	\char180	180	acute	u00B4	acute accent
-\char181	\char181	181	mu	u00B5	micro sign
-\char182	\char182	182	paragraph	u00B6	end of paragraphs marker
-\char183	\char183	183	periodcentered	u00B7	centered period
-\char184	\char184	184	cedilla	u00B8	cedilla accent
-\char185	\char185	185	onesuperior	u00B9	superscript 1
-\char186	\char186	186	ordmasculine	u00BA	masculine ordinal (Spanish)
-\char187	\char187	187	guillemotright	u00BB	right guillemet sic
-\char188	\char188	188	onequarter	u00BC	1/4 symbol
-\char189	\char189	189	onehalf	u00BD	1/2 symbol
-\char190	\char190	190	threequarters	u00BE	3/4 symbol
-\char191	\char191	191	questiondown	u00BF	inverted question mark
-\char192	\char192	192	Agrave	u0041_0300	A grave
-\char193	\char193	193	Aacute	u0041_0301	A acute
-\char194	\char194	194	Acircumflex	u0041_0302	A circumflex
-\char195	\char195	195	Atilde	u0041_0303	A tilde
-\char196	\char196	196	Adieresis	u0041_0308	A dieresis (umlaut)
-\char197	\char197	197	Aring	u0041_030A	A ring
-\char198	\char198	198	AE	u00C6	A+E combined
-\char199	\char199	199	Ccedilla	u0043_0327	C cedilla
-\char200	\char200	200	Egrave	u0045_0300	E grave
-\char201	\char201	201	Eacute	u0045_0301	E acute
-\char202	\char202	202	Ecircumflex	u0045_0302	E circumflex
-\char203	\char203	203	Edieresis	u0045_0308	E dieresis (umlaut)
-\char204	\char204	204	Igrave	u0049_0300	I grave
-\char205	\char205	205	Iacute	u0049_0301	I acute
-\char206	\char206	206	Icircumflex	u0049_0302	I circumflex
-\char207	\char207	207	Idieresis	u0049_0308	I dieresis
-\char208	\char208	208	Eth	u00D0	E th
-\char209	\char209	209	Ntilde	u004E_0303	N tilde
-\char210	\char210	210	Ograve	u004F_0300	O grave
-\char211	\char211	211	Oacute	u004F_0301	O acute
-\char212	\char212	212	Ocircumflex	u004F_0302	O circumflex
-\char213	\char213	213	Otilde	u004F_0303	O tilde
-\char214	\char214	214	Odieresis	u004F_0308	O dieresis (umlaut)
-\char215	\char215	215	multiply	u00D7	multiply
-\char216	\char216	216	Oslash	u00D8	O slash
-\char217	\char217	217	Ugrave	u0055_0300	U grave
-\char218	\char218	218	Uacute	u0055_0301	U acute
-\char219	\char219	219	Ucircumflex	u0055_0302	U circumflex
-\char220	\char220	220	Udieresis	u0055_0308	U dieresis (umlaut)
-\char221	\char221	221	Yacute	u0059_0301	Y acute
-\char222	\char222	222	Thorn	u00DE	Thorn
-\char223	\char223	223	germandbls	u00DF	German double s (sharp s)
-\char224	\char224	224	agrave	u0061_0300	a grave
-\char225	\char225	225	aacute	u0061_0301	a acute
-\char226	\char226	226	acircumflex	u0061_0302	a circumflex
-\char227	\char227	227	atilde	u0061_0303	a tilde
-\char228	\char228	228	adieresis	u0061_0308	a dieresis (umlaut)
-\char229	\char229	229	aring	u0061_030A	a ring
-\char230	\char230	230	ae	u00E6	a+e combined
-\char231	\char231	231	ccedilla	u0063_0327	c cedilla
-\char232	\char232	232	egrave	u0065_0300	e grave
-\char233	\char233	233	eacute	u0065_0301	e acute
-\char234	\char234	234	ecircumflex	u0065_0302	e circumflex
-\char235	\char235	235	edieresis	u0065_0308	e dieresis (umlaut)
-\char236	\char236	236	igrave	u0069_0300	i grave
-\char237	\char237	237	iacute	u0069_0301	i acute
-\char238	\char238	238	icircumflex	u0069_0302	i circumflex
-\char239	\char239	239	idieresis	u0069_0308	i dieresis (umlaut)
-\char240	\char240	240	eth	u00F0	e th
-\char241	\char241	241	ntilde	u006E_0303	n tilde
-\char242	\char242	242	ograve	u006F_0300	o grave
-\char243	\char243	243	oacute	u006F_0301	o acute
-\char244	\char244	244	ocircumflex	u006F_0302	o circumflex
-\char245	\char245	245	otilde	u006F_0303	o tilde
-\char246	\char246	246	odieresis	u006F_0308	o dieresis (umlaut)
-\char247	\char247	247	divide	u00F7	divide
-\char248	\char248	248	oslash	u00F8	o slash
-\char249	\char249	249	ugrave	u0075_0300	u grave
-\char250	\char250	250	uacute	u0075_0301	u acute
-\char251	\char251	251	ucircumflex	u0075_0302	u circumflex
-\char252	\char252	252	udieresis	u0075_0308	u dieresis (umlaut)
-\char253	\char253	253	yacute	u0079_0301	y acute
-\char254	\char254	254	thorn	u00FE	thorn
-\char255	\char255	255	ydieresis	u0079_0308	y dieresis (umlaut)
-.TE
-.ad
+Unicode encodes far more characters than
+.I groff
+has glyph names for;
+special character escape forms based on numerical code points enable
+access to any of them.
+.
+Frequently used glyphs or glyph combinations can be stored in strings,
+and new glyph names can be created
+.I "ad hoc"
+with the
+.B char
+request;
+see
+.MR groff @MAN7EXT@ .
+.
+.
+.TP
+.BI \rsu nnnn\c
+.RI  n\c
+.RI  n \c
+.B 
+is a Unicode numeric special character escape sequence.
+.
+Any Unicode code point can be accessed with four to six hexadecimal
+digits,
+with hexadecimal letters accepted in uppercase form only.
+.
+Thus,
+.B \rsu02DA
+accesses the (spacing) ring accent,
+producing \lq\u02DA\rq.
+.
+.
+.\" Use "GNU troff" in this paragraph because the contrast with AT&T
+.\" troff, which antedated Unicode, is important, and that contrast is
+.\" obscured with the default empty command prefix on "troff".
+.P
+Unicode code points can be composed as well;
+when they are,
+GNU
+.I troff \" GNU
+requires NFD
+(Normalization Form D),
+where all Unicode glyphs are maximally decomposed.
+.
+(Exception:
+precomposed characters in the Latin-1 supplement described above are
+also accepted.
+.
+Do not count on this exception remaining in a future
+GNU
+.I troff \" GNU
+that accepts UTF-8 input directly.)
+.
+.
+Thus,
+GNU
+.I troff \" GNU
+accepts
+.RB \lqcaf \rs\aqe \rq,
+.RB \lqcaf \rse\~aa \rq,
+and
+.RB \lqcaf \rsu0065_0301 \rq,
+as ways to input \lqcaf\'e\rq.
+.
+(Due to its legacy 8-bit encoding compatibility,
+at present it also accepts
+.RB \lqcaf \rsu00E9 \rq
+on ISO Latin-1 systems.)
+.
+.
+.TP
+.BI \rsu base-char\c
+\c
+.BI _ combining-component\c
+.\|.\|.
+constructs a composite glyph from Unicode numeric special character
+escape sequences.
+.
+The code points of the base glyph and the combining components are each
+expressed in hexadecimal,
+with an underscore
+.RB ( _ )
+separating each component.
+.
+Thus,
+.B \rsu006E_0303
+produces \lq\u006E_0303\rq.
+.
+.
+.TP
+.BI \rschar nnn 
+expresses an eight-bit code point where
+.I nnn
+is the code point of the character,
+a decimal number between 0 and\~255
+without leading zeroes.
+.
+This legacy numeric special character escape sequence is used to map
+characters onto glyphs via the
+.B trin
+request in macro files loaded by
+.MR grotty @MAN1EXT@ .
 .
 .
 .\" ====================================================================
-.SS "Named Glyphs"
+.SH "Glyph tables"
 .\" ====================================================================
 .
-Glyph names can be embedded into the document text by using escape
-sequences.
+In this section,
+.IR groff 's
+glyph name repertoire is presented in tabular form.
 .
-.BR groff (@MAN7EXT@)
-describes how these escape sequences look.
+The meanings of the columns are as follows.
 .
-Glyph names can consist of quite arbitrary characters from the
-ASCII or \%latin1 code set, not only alphanumeric characters.
 .
-Here some examples:
+.TP 8n
+.B Output
+shows the glyph as it appears on the device used to render this
+document;
+although it can have a notably different shape on other devices
+(and is subject to user-directed translation and replacement),
+.I groff
+attempts reasonable equivalency on all output devices.
+.
 .
 .TP
-\f(CW\e(\fP\fIch\fP
-A glyph having the 2-character name
-.IR ch .
+.B Input
+shows the
+.I groff
+character
+(ordinary or special)
+that normally produces the glyph.
+.
+Some code points have multiple glyph names.
+.
 .
 .TP
-\f(CW\e\fP\,\fIchar_name\/\fP\f(CW\fP
-A glyph having the name
-.I char_name
-(having length 1, 2, 3, \&.\|.\|.).
+.B Unicode
+is the code point notation for the glyph or combining glyph sequence as
+described in subsection \lqSpecial character escape forms\rq above.
 .
-Note that \oq\fIc\fP\cq is not the same as
-\oq\f(CW\e\fP\,\fIc\/\fP\f(CW\fP\cq (\,\fIc\fP\ a single
-character): The latter is internally mapped to glyph name
-\oq\e\fIc\fP\cq.
+It corresponds to the standard notation for Unicode short identifiers
+such that
+.IR groff 's
+.BI u nnnn
+is equivalent to Unicode's
+.RI U+ nnnn .
+.\" And thereby hangs a tale...
+.\" https://unicode.org/mail-arch/unicode-ml/y2005-m11/0060.html
 .
-By default, groff defines a single glyph name starting with a
-backslash, namely \%\oq\e-\cq, which can be either accessed as
-\oq\f(CW\e\-\fP\cq or \oq\f(CW\e-\fP\cq.
 .
 .TP
-\f(CW\e\fP\,\fIbase_glyph composite_1 composite_2 \&.\|.\|.\/\fP\
-\f(CW\fP
-A composite glyph; see below for a more detailed description.
+.B Notes
+describes the glyph,
+elucidating the mnemonic value of the glyph name where possible.
 .
 .
-.P
-In groff, each \%8-bit input character can also referred to by the
-construct
-\oq\f(CW\echar\fP\,\fIn\/\fP\f(CW\fP\cq where
-.I n
-is the decimal code of the character, a number between 0 and\ 255
-without leading zeros (those entities are
-.I not
-glyph names).
+.IP
+A plus sign \lq+\rq indicates that the glyph name appears in the
+AT&T
+.I troff
+user's manual,
+CSTR\~#54
+(1992 revision).
 .
-They are normally mapped onto glyphs using the \f(CW.trin\fP request.
+When using the AT&T special character syntax
+.BI \rs( xx\c
+, widespread portability can be expected from such names.
 .
 .
-.P
-Another special convention is the handling of glyphs with names directly
-derived from a Unicode code point; this is shown in the
-\oqUnicode\cq column of the table below.
+.IP
+Entries marked with \lq***\rq denote glyphs used for mathematical
+purposes.
 .
-In general, all glyphs not having a name as listed in this manual page
-can be accessed with the
-\oq\f(CW\eu\fP\,\fIXXXX\/\fP\f(CW\fP\cq
-construct.
+On typesetting devices,
+such glyphs are typically drawn from a
+.I special
+font
+(see
+.MR groff_font @MAN5EXT@ ).
 .
-Refer to section \lqUsing Symbols\rq in
-.IR "Groff: The GNU Implementation of troff" ,
-the
-.I groff
-Texinfo manual,
-which describes how
-.I groff
-glyph names are constructed.
+Often,
+such glyphs lack bold or italic style forms or have metrics that look
+incongruous in ordinary prose.
 .
+A few which are not uncommon in running text have \lqtext
+variants\rq,
+which should work better in that context.
 .
-.P
-Moreover, new glyph names can be created by the \f(CW.char\fP request;
-see
-.BR groff (@MAN7EXT@).
+Conversely,
+a handful of glyphs that are normally drawn from a text font may be
+required in mathematical equations.
+.
+Both sets of exceptions are noted in the tables where they appear
+(\lqLogical symbols\rq and \lqMathematical symbols\rq).
+.
+.
+.\" ====================================================================
+.SS "Basic Latin"
+.\" ====================================================================
+.
+Apart from basic Latin characters with special mappings,
+described in subsection \lqFundamental character set\rq above,
+a few others in that range have special character glyph names.
+.
+.\" XXX: I surmise that...
+These were defined for ease of input on non-U.S.\& keyboards lacking
+keycaps for them,
+or for symmetry with other special character glyph names serving a
+similar purpose.
 .
-.P
-In the following, a plus sign \oq+\cq in the \oqNotes\cq column
-indicates that this particular glyph name appears in the PS version of
-the original troff documentation, CSTR\ 54.
 .
 .P
-Entries marked with \oq***\cq denote glyphs for mathematical
-purposes (mainly used for DVI output).
+The vertical bar is overloaded;
+the
+.B \rsba
+and
+.B \rsor
+escape sequences may render differently.
 .
-Normally, such glyphs have metrics which make them unusable in normal
-text.
+See subsection \lqMathematical symbols\rq below for special variants
+of the plus,
+minus,
+and equals
+signs normally drawn from this range.
 .
 .
 .P
-.na
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\-D	\e-D	Eth	u00D0	uppercase eth
-\Sd	\eSd	eth	u00F0	lowercase eth
-\TP	\eTP	Thorn	u00DE	uppercase thorn
-\Tp	\eTp	thorn	u00FE	lowercase thorn
-\ss	\ess	germandbls	u00DF	German double s (sharp s)
+.T&
+L Lf(CR) L Lx.
+\dq	\edq	u0022	neutral double quote
+\sh	\esh	u0023	number sign
+\Do	\eDo	u0024	dollar sign
+\aq	\eaq	u0027	apostrophe, neutral single quote
+\sl	\esl	u002F	slash, solidus +
+\at	\eat	u0040	at sign
+\lB	\elB	u005B	left square bracket
+\rs	\ers	u005C	reverse solidus
+\rB	\erB	u005D	right square bracket
+\ha	\eha	u005E	circumflex, caret, \lqhat\rq
+\lC	\elC	u007B	left brace
+|	|	u007C	bar
+\ba	\eba	u007C	bar
+\or	\eor	u007C	bitwise or +
+\rC	\erC	u007D	right brace
+\ti	\eti	u007E	tilde
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Supplementary Latin letters"
+.\" ====================================================================
+.
+Historically,
+.B \rsss
+could be considered a ligature of \lqsz\rq.
+.
+An uppercase form is available as
+.BR \rsu1E9E ,
+but in the German language it is of specialized use;
+\ss does
+.I not
+normally uppercase-transform to it,
+but rather to \lqSS\rq.
+.
+\lqLowercase f with hook\rq is also used as a function symbol;
+see subsection \lqMathematical symbols\rq below.
+.
 .
 .P
-.I Ligatures and Other Latin Glyphs
-.P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\ff	\eff	ff	u0066_0066	ff ligature +
-\fi	\efi	fi	u0066_0069	fi ligature +
-\fl	\efl	fl	u0066_006C	fl ligature +
-\Fi	\eFi	ffi	u0066_0066_0069	ffi ligature +
-\Fl	\eFl	ffl	u0066_0066_006C	ffl ligature +
-\/L	\e/L	Lslash	u0141	L slash (Polish)
-\/l	\e/l	lslash	u0142	l slash (Polish)
-\/O	\e/O	Oslash	u00D8	O slash (Scandinavian)
-\/o	\e/o	oslash	u00F8	o slash (Scandinavian)
-\AE	\eAE	AE	u00C6	A+E combined
-\ae	\eae	ae	u00E6	a+e combined
-\OE	\eOE	OE	u0152	O+E combined
-\oe	\eoe	oe	u0153	o+e combined
-\IJ	\eIJ	IJ	u0132	I+J combined (Dutch)
-\ij	\eij	ij	u0133	i+j combined(Dutch)
-\.i	\e.i	dotlessi	u0131	i without a dot (Turkish)
-\.j	\e.j	dotlessj	u0237	j without a dot
+.T&
+L Lf(CR) L Lx.
+\-D	\e\-D	u00D0	uppercase eth
+\Sd	\eSd	u00F0	lowercase eth
+\TP	\eTP	u00DE	uppercase thorn
+\Tp	\eTp	u00FE	lowercase thorn
+\ss	\ess	u00DF	lowercase sharp s
+\.i	\e.i	u0131	i without tittle
+\.j	\e.j	u0237	j without tittle
+\Fn	\eFn	u0192	lowercase f with hook, function
+\/L	\e/L	u0141	L with stroke
+\/l	\e/l	u0142	l with stroke
+\/O	\e/O	u00D8	O with stroke
+\/o	\e/o	u00F8	o with stroke
 .TE
-.ad
 .
-.P
-.I Accented Characters
-.P
-.na
+.
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS "Ligatures and digraphs"
+.\" ====================================================================
+.
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\'A	\e'A	Aacute	u0041_0301	A acute
-\'C	\e'C	Cacute	u0043_0301	C acute
-\'E	\e'E	Eacute	u0045_0301	E acute
-\'I	\e'I	Iacute	u0049_0301	I acute
-\'O	\e'O	Oacute	u004F_0301	O acute
-\'U	\e'U	Uacute	u0055_0301	U acute
-\'Y	\e'Y	Yacute	u0059_0301	Y acute
-\'a	\e'a	aacute	u0061_0301	a acute
-\'c	\e'c	cacute	u0063_0301	c acute
-\'e	\e'e	eacute	u0065_0301	e acute
-\'i	\e'i	iacute	u0069_0301	i acute
-\'o	\e'o	oacute	u006F_0301	o acute
-\'u	\e'u	uacute	u0075_0301	u acute
-\'y	\e'y	yacute	u0079_0301	y acute
-\:A	\e:A	Adieresis	u0041_0308	A dieresis (umlaut)
-\:E	\e:E	Edieresis	u0045_0308	E dieresis (umlaut)
-\:I	\e:I	Idieresis	u0049_0308	I dieresis (umlaut)
-\:O	\e:O	Odieresis	u004F_0308	O dieresis (umlaut)
-\:U	\e:U	Udieresis	u0055_0308	U dieresis (umlaut)
-\:Y	\e:Y	Ydieresis	u0059_0308	Y dieresis (umlaut)
-\:a	\e:a	adieresis	u0061_0308	a dieresis (umlaut)
-\:e	\e:e	edieresis	u0065_0308	e dieresis (umlaut)
-\:i	\e:i	idieresis	u0069_0308	i dieresis (umlaut)
-\:o	\e:o	odieresis	u006F_0308	o dieresis (umlaut)
-\:u	\e:u	udieresis	u0075_0308	u dieresis (umlaut)
-\:y	\e:y	ydieresis	u0079_0308	y dieresis (umlaut)
-\^A	\e^A	Acircumflex	u0041_0302	A circumflex
-\^E	\e^E	Ecircumflex	u0045_0302	E circumflex
-\^I	\e^I	Icircumflex	u0049_0302	I circumflex
-\^O	\e^O	Ocircumflex	u004F_0302	O circumflex
-\^U	\e^U	Ucircumflex	u0055_0302	U circumflex
-\^a	\e^a	acircumflex	u0061_0302	a circumflex
-\^e	\e^e	ecircumflex	u0065_0302	e circumflex
-\^i	\e^i	icircumflex	u0069_0302	i circumflex
-\^o	\e^o	ocircumflex	u006F_0302	o circumflex
-\^u	\e^u	ucircumflex	u0075_0302	u circumflex
-\`A	\e`A	Agrave	u0041_0300	A grave
-\`E	\e`E	Egrave	u0045_0300	E grave
-\`I	\e`I	Igrave	u0049_0300	I grave
-\`O	\e`O	Ograve	u004F_0300	O grave
-\`U	\e`U	Ugrave	u0055_0300	U grave
-\`a	\e`a	agrave	u0061_0300	a grave
-\`e	\e`e	egrave	u0065_0300	e grave
-\`i	\e`i	igrave	u0069_0300	i grave
-\`o	\e`o	ograve	u006F_0300	o grave
-\`u	\e`u	ugrave	u0075_0300	u grave
-\~A	\e~A	Atilde	u0041_0303	A tilde
-\~N	\e~N	Ntilde	u004E_0303	N tilde
-\~O	\e~O	Otilde	u004F_0303	O tilde
-\~a	\e~a	atilde	u0061_0303	a tilde
-\~n	\e~n	ntilde	u006E_0303	n tilde
-\~o	\e~o	otilde	u006F_0303	o tilde
-\vS	\evS	Scaron	u0053_030C	S caron
-\vs	\evs	scaron	u0073_030C	s caron
-\vZ	\evZ	Zcaron	u005A_030C	Z caron
-\vz	\evz	zcaron	u007A_030C	z caron
-\,C	\e,C	Ccedilla	u0043_0327	C cedilla
-\,c	\e,c	ccedilla	u0063_0327	c cedilla
-\oA	\eoA	Aring	u0041_030A	A ring
-\oa	\eoa	aring	u0061_030A	a ring
+.T&
+L Lf(CR) L Lx.
+\ff	\eff	u0066_0066	ff ligature +
+\fi	\efi	u0066_0069	fi ligature +
+\fl	\efl	u0066_006C	fl ligature +
+\Fi	\eFi	u0066_0066_0069	ffi ligature +
+\Fl	\eFl	u0066_0066_006C	ffl ligature +
+\AE	\eAE	u00C6	AE ligature
+\ae	\eae	u00E6	ae ligature
+\OE	\eOE	u0152	OE ligature
+\oe	\eoe	u0153	oe ligature
+\IJ	\eIJ	u0132	IJ digraph
+\ij	\eij	u0133	ij digraph
 .TE
-.ad
 .
-.P
-.I Accents
-.P
-The
+.
+.\" ====================================================================
+.SS Accents
+.\" ====================================================================
+.
+Normally,
+the formatting of a special character advances the drawing position as
+an ordinary character does.
+.
+.IR groff 's
 .B composite
-request is used to map most of the accents to non-spacing glyph names;
-the values given in parentheses are the original (spacing) ones.
+request designates a special character as combining.
+.
+The
+.I composite.tmac
+macro file,
+loaded automatically by the default
+.IR troffrc ,
+maps the following special characters to the combining characters shown
+below.
+.
+The non-combining code point in parentheses is used when the special
+character occurs in isolation
+(compare
+.RB \lq "caf\rse aa" \rq
+and
+.RB \lq "caf\rsaae" \rq).
+.
 .
 .P
-.na
+.if t .ne 3v
+.if n .ne 4v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\a"	\ea"	hungarumlaut	u030B (u02DD)	Hungarian umlaut
-\a-	\ea-	macron	u0304 (u00AF)	overbar accent
-\a.	\ea.	dotaccent	u0307 (u02D9)	dot accent
-\a^	\ea^	circumflex	u0302 (u005E)	circumflex accent
-\aa	\eaa	acute	u0301 (u00B4)	acute accent +
-\ga	\ega	grave	u0300 (u0060)	grave accent +
-\ab	\eab	breve	u0306 (u02D8)	breve accent
-\ac	\eac	cedilla	u0327 (u00B8)	cedilla accent
-\ad	\ead	dieresis	u0308 (u00A8)	umlaut accent
-\ah	\eah	caron	u030C (u02C7)	caron accent
-\ao	\eao	ring	u030A (u02DA)	small circle, ring accent
-\a~	\ea~	tilde	u0303 (u007E)	tilde accent
-\ho	\eho	ogonek	u0328 (u02DB)	hook accent
-\ha	\eha	asciicircum	u005E	T{
-high circumflex, ASCII character, in mathematics the power sign
-T}
-\ti	\eti	asciitilde	u007E	T{
-tilde in vertical middle, ASCII, in Unix-like the home directory
-T}
+.T&
+L Lf(CR) L Lx.
+\a"	\ea"	u030B (u02DD)	double acute accent
+\a-	\ea\-	u0304 (u00AF)	macron accent
+\a.	\ea.	u0307 (u02D9)	dot accent
+\a^	\ea\ha	u0302 (u005E)	circumflex accent
+\aa	\eaa	u0301 (u00B4)	acute accent +
+\ga	\ega	u0300 (u0060)	grave accent +
+\ab	\eab	u0306 (u02D8)	breve accent
+\ac	\eac	u0327 (u00B8)	cedilla accent
+\ad	\ead	u0308 (u00A8)	dieresis accent
+\ah	\eah	u030C (u02C7)	caron accent
+\ao	\eao	u030A (u02DA)	ring accent
+\a~	\ea\ti	u0303 (u007E)	tilde accent
+\ho	\eho	u0328 (u02DB)	hook accent
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Accented characters"
+.\" ====================================================================
+.
+All of these glyphs can be composed using combining glyph names as
+described in subsection \lqSpecial character escape forms\rq above;
+the names below are short aliases for convenience.
+.
 .
 .P
-.I Quotes
-.P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\Bq	\eBq	quotedblbase	u201E	low double comma quote
-\bq	\ebq	quotesinglbase	u201A	low single comma quote
-\lq	\elq	quotedblleft	u201C	left double quote
-\rq	\erq	quotedblright	u201D	right double quote
-\oq	\eoq	quoteleft	u2018	single open (left) quote
-\cq	\ecq	quoteright	u2019	single closing (right) quote
-\aq	\eaq	quotesingle	u0027	apostrophe quote (ASCII 39)
-\dq	\edq	quotedbl	u0022	double quote (ASCII 34)
-\Fo	\eFo	guillemotleft	u00AB	left guillemet sic
-\Fc	\eFc	guillemotright	u00BB	right guillemet sic
-\fo	\efo	guilsinglleft	u2039	T{
-single left-pointing angle quotation mark
-T}
-\fc	\efc	guilsinglright	u203A	T{
-single right-pointing angle quotation mark
-T}
+.T&
+L Lf(CR) L Lx.
+\'A	\e\aqA	u0041_0301	A acute
+\'C	\e\aqC	u0043_0301	C acute
+\'E	\e\aqE	u0045_0301	E acute
+\'I	\e\aqI	u0049_0301	I acute
+\'O	\e\aqO	u004F_0301	O acute
+\'U	\e\aqU	u0055_0301	U acute
+\'Y	\e\aqY	u0059_0301	Y acute
+\'a	\e\aqa	u0061_0301	a acute
+\'c	\e\aqc	u0063_0301	c acute
+\'e	\e\aqe	u0065_0301	e acute
+\'i	\e\aqi	u0069_0301	i acute
+\'o	\e\aqo	u006F_0301	o acute
+\'u	\e\aqu	u0075_0301	u acute
+\'y	\e\aqy	u0079_0301	y acute
+
+\:A	\e:A	u0041_0308	A dieresis
+\:E	\e:E	u0045_0308	E dieresis
+\:I	\e:I	u0049_0308	I dieresis
+\:O	\e:O	u004F_0308	O dieresis
+\:U	\e:U	u0055_0308	U dieresis
+\:Y	\e:Y	u0059_0308	Y dieresis
+\:a	\e:a	u0061_0308	a dieresis
+\:e	\e:e	u0065_0308	e dieresis
+\:i	\e:i	u0069_0308	i dieresis
+\:o	\e:o	u006F_0308	o dieresis
+\:u	\e:u	u0075_0308	u dieresis
+\:y	\e:y	u0079_0308	y dieresis
+
+\^A	\e\haA	u0041_0302	A circumflex
+\^E	\e\haE	u0045_0302	E circumflex
+\^I	\e\haI	u0049_0302	I circumflex
+\^O	\e\haO	u004F_0302	O circumflex
+\^U	\e\haU	u0055_0302	U circumflex
+\^a	\e\haa	u0061_0302	a circumflex
+\^e	\e\hae	u0065_0302	e circumflex
+\^i	\e\hai	u0069_0302	i circumflex
+\^o	\e\hao	u006F_0302	o circumflex
+\^u	\e\hau	u0075_0302	u circumflex
+
+\`A	\e\gaA	u0041_0300	A grave
+\`E	\e\gaE	u0045_0300	E grave
+\`I	\e\gaI	u0049_0300	I grave
+\`O	\e\gaO	u004F_0300	O grave
+\`U	\e\gaU	u0055_0300	U grave
+\`a	\e\gaa	u0061_0300	a grave
+\`e	\e\gae	u0065_0300	e grave
+\`i	\e\gai	u0069_0300	i grave
+\`o	\e\gao	u006F_0300	o grave
+\`u	\e\gau	u0075_0300	u grave
+
+\~A	\e\tiA	u0041_0303	A tilde
+\~N	\e\tiN	u004E_0303	N tilde
+\~O	\e\tiO	u004F_0303	O tilde
+\~a	\e\tia	u0061_0303	a tilde
+\~n	\e\tin	u006E_0303	n tilde
+\~o	\e\tio	u006F_0303	o tilde
+
+\vS	\evS	u0053_030C	S caron
+\vs	\evs	u0073_030C	s caron
+\vZ	\evZ	u005A_030C	Z caron
+\vz	\evz	u007A_030C	z caron
+
+\,C	\e,C	u0043_0327	C cedilla
+\,c	\e,c	u0063_0327	c cedilla
+
+\oA	\eoA	u0041_030A	A ring
+\oa	\eoa	u0061_030A	a ring
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Quotation marks"
+.\" ====================================================================
+.
+The neutral double quote,
+often useful when documenting programming languages,
+is also available as a special character for convenient embedding in
+macro arguments;
+see subsection \lqFundamental character set\rq above.
+.
 .
 .P
-.I Punctuation
-.P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\r!	\er!	exclamdown	u00A1	inverted exclamation mark
-\r?	\er?	questiondown	u00BF	inverted question mark
-\em	\eem	emdash	u2014	em-dash symbol +
-\en	\een	endash	u2013	en-dash symbol
-\hy	\ehy	hyphen	u2010	hyphen symbol +
+.T&
+L Lf(CR) L Lx.
+\Bq	\eBq	u201E	low double comma quote
+\bq	\ebq	u201A	low single comma quote
+\lq	\elq	u201C	left double quote
+\rq	\erq	u201D	right double quote
+\oq	\eoq	u2018	single opening (left) quote
+\cq	\ecq	u2019	single closing (right) quote
+\aq	\eaq	u0027	apostrophe, neutral single quote
+\dq	"	u0022	neutral double quote
+\dq	\edq	u0022	neutral double quote
+\Fo	\eFo	u00AB	left double chevron
+\Fc	\eFc	u00BB	right double chevron
+\fo	\efo	u2039	left single chevron
+\fc	\efc	u203A	right single chevron
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS Punctuation
+.\" ====================================================================
+.
+The Unicode name for U+00B7 is \lqmiddle dot\rq,
+which is unfortunately confusable with the
+.I groff
+mnemonic for the visually similar but semantically distinct
+multiplication dot;
+see subsection \lqMathematical symbols\rq below.
+.
 .
 .P
-.I Brackets
-.P
-The extensible bracket pieces are font-invariant glyphs.
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
+.TS
+L L L Lx.
+Output	Input	Unicode	Notes
+_
+.T&
+L Lf(CR) L Lx.
+\r!	\er!	u00A1	inverted exclamation mark
+\r?	\er?	u00BF	inverted question mark
+\pc	\epc	u00B7	centered period
+\em	\eem	u2014	em-dash +
+\en	\een	u2013	en-dash
+\hy	\ehy	u2010	hyphen +
+.TE
+.
+.
+.\" ====================================================================
+.SS Brackets
+.\" ====================================================================
+.
+On typesetting devices,
+the bracket extensions are font-invariant glyphs;
+that is,
+they are rendered the same way regardless of font
+(with a drawing escape sequence).
+.
+On terminals,
+they are
+.I not
+font-invariant;
+.I groff
+maps them rather arbitrarily to U+23AA
+(\lqcurly bracket extension\rq).
+.
+In AT&T
+.IR troff ,
+only one glyph was available to vertically extend
+brackets,
+braces,
+and
+parentheses:
+.BR \rs(bv .
 .
-In classical troff only one glyph was available to vertically extend
-brackets, braces, and parentheses: \oqbv\cq.
 .
-We map it rather arbitrarily to u23AA.
 .
 .P
-Note that not all devices contain extensible bracket pieces which can
-be piled up with \oq\f(CW\eb\fP\cq due to the restrictions of the
-escape's piling algorithm.
+Not all devices supply bracket pieces that can be piled up with
+.B \rsb
+due to the restrictions of the escape's piling algorithm.
 .
 A general solution to build brackets out of pieces is the following
 macro:
 .
-.P
-.nf
+.
 .RS
-.ft C
-\&.\e" Make a pile centered vertically 0.5em
-\&.\e" above the baseline.
+.EX
+\&.\e" Make a pile centered vertically 0.5em above the baseline.
 \&.\e" The first argument is placed at the top.
-\&.\e" The pile is returned in string 'pile'
+\&.\e" The pile is returned in string \aqpile\aq.
 \&.eo
-\&.de pile-make
-\&.  nr pile-wd 0
-\&.  nr pile-ht 0
-\&.  ds pile-args
-\&.
-\&.  nr pile-# \en.$
-\&.  while \enpile-# \e{\e
-\&.    nr pile-wd (\enpile-wd >? \ew'\e$\enpile-#')
-\&.    nr pile-ht +(\enrst - \enrsb)
-\&.    as pile-args \ev'\enrsbu'\e"
-\&.    as pile-args \eZ'\e$\enpile-#'\e"
-\&.    as pile-args \ev'-\enrstu'\e"
-\&.    nr pile-# -1
-\&.  \e}
-\&.
-\&.  ds pile \ev'(-0.5m + (\enpile-htu / 2u))'\e"
-\&.  as pile \e*pile-args\e"
-\&.  as pile \ev'((\enpile-htu / 2u) + 0.5m)'\e"
-\&.  as pile \eh'\enpile-wdu'\e"
+\&.de pile\-make
+\&.\&  nr pile\-wd 0
+\&.\&  nr pile\-ht 0
+\&.\&  ds pile\-args
+\&.\&
+\&.\&  nr pile\-# \en.$
+\&.\&  while \enpile\-# \e{\e
+\&.\&    nr pile\-wd (\enpile\-wd >? \ew\aq\e$\enpile\-#\aq)
+\&.\&    nr pile\-ht +(\enrst \- \enrsb)
+\&.\&    as pile\-args \ev\aq\enrsbu\aq\e"
+\&.\&    as pile\-args \eZ\aq\e$\enpile\-#\aq\e"
+\&.\&    as pile\-args \ev\aq\-\enrstu\aq\e"
+\&.\&    nr pile\-# \-1
+\&.\&  \e}
+\&.\&
+\&.\&  ds pile \ev\aq(\-0.5m + (\enpile\-htu / 2u))\aq\e"
+\&.\&  as pile \e*pile\-args\e"
+\&.\&  as pile \ev\aq((\enpile\-htu / 2u) + 0.5m)\aq\e"
+\&.\&  as pile \eh\aq\enpile\-wdu\aq\e"
 \&..
 \&.ec
-.ft
+.EE
 .RE
-.fi
+.
 .
 .P
 Another complication is the fact that some glyphs which represent
-bracket pieces in original troff can be used for other mathematical
-symbols also, for example \oqlf\cq and \oqrf\cq which provide
-the \oqfloor\cq operator.
-.
-Other devices (most notably for DVI output) don't unify such
-glyphs.
-.
-For this reason, the four glyphs \oqlf\cq, \oqrf\cq,
-\oqlc\cq, and \oqrc\cq are not unified with similarly looking
-bracket pieces.
+bracket pieces in AT&T
+.I troff
+can be used for other mathematical symbols as well,
+for example
+.B \rs(lf
+and
+.BR \rs(rf ,
+which provide the floor operator.
+.
+Some output devices,
+such as
+.BR dvi ,
+don't unify such glyphs.
+.
+For this reason,
+the glyphs
+.BR \rslf ,
+.BR \rsrf ,
+.BR \rslc ,
+and
+.B \rsrc
+are not unified with similar-looking bracket pieces.
 .
 In
-.BR groff ,
+.IR groff ,
 only glyphs with long names are guaranteed to pile up correctly for all
-devices (provided those glyphs exist).
+devices\emprovided those glyphs are available.
+.
 .
 .P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\lB	\elB	bracketleft	u005B	T{
-left square bracket
-T}
-\rB	\erB	bracketright	u005D	T{
-right square bracket
-T}
-\lC	\elC	braceleft	u007B	T{
-left curly brace
-T}
-\rC	\erC	braceright	u007D	T{
-right curly brace
-T}
-\la	\ela	angleleft	u27E8	T{
-left angle bracket
-T}
-\ra	\era	angleright	u27E9	T{
-right angle bracket
-T}
+.T&
+L Lf(CR) L Lx.
+\lB		u005B	left square bracket
+\lB	\elB	u005B	left square bracket
+\rB		u005D	right square bracket
+\rB	\erB	u005D	right square bracket
+\lC	{	u007B	left brace
+\lC	\elC	u007B	left brace
+\rC	}	u007D	right brace
+\rC	\erC	u007D	right brace
+\la	\ela	u27E8	left angle bracket
+\ra	\era	u27E9	right angle bracket
+\bv	\ebv	u23AA	brace vertical extension + ***
+\braceex	\ebraceex	u23AA	brace vertical extension
 
-\bv	\ebv	braceex	u23AA	T{
-curly brace vertical extension *** +
-T}
-\braceex	\ebraceex	braceex	u23AA	T{
-curly brace vertical extension
-T}
+\bracketlefttp	\ebracketlefttp	u23A1	left square bracket top
+\bracketleftex	\ebracketleftex	u23A2	left square bracket extension
+\bracketleftbt	\ebracketleftbt	u23A3	left square bracket bottom
 
-\bracketlefttp	\ebracketlefttp	bracketlefttp	u23A1	T{
-left square bracket top
-T}
-\bracketleftbt	\ebracketleftbt	bracketleftbt	u23A3	T{
-left square bracket bottom
-T}
-\bracketleftex	\ebracketleftex	bracketleftex	u23A2	T{
-left square bracket extension
-T}
-\bracketrighttp	\ebracketrighttp	bracketrighttp	u23A4	T{
-right square bracket top
-T}
-\bracketrightbt	\ebracketrightbt	bracketrightbt	u23A6	T{
-right square bracket bottom
-T}
-\bracketrightex	\ebracketrightex	bracketrightex	u23A5	T{
-right square bracket extension
-T}
+\bracketrighttp	\ebracketrighttp	u23A4	right square bracket top
+\bracketrightex	\ebracketrightex	u23A5	right square bracket extension
+\bracketrightbt	\ebracketrightbt	u23A6	right square bracket bottom
 
-\lt	\elt	bracelefttp	u23A7	T{
-left curly brace top +
-T}
-\bracelefttp	\ebracelefttp	bracelefttp	u23A7	T{
-left curly brace top
-T}
-\lk	\elk	braceleftmid	u23A8	T{
-left curly brace middle +
-T}
-\braceleftmid	\ebraceleftmid	braceleftmid	u23A8	T{
-left curly brace middle
-T}
-\lb	\elb	braceleftbt	u23A9	T{
-left curly brace bottom +
-T}
-\braceleftbt	\ebraceleftbt	braceleftbt	u23A9	T{
-left curly brace bottom
-T}
-\braceleftex	\ebraceleftex	braceleftex	u23AA	T{
-left curly brace extension
-T}
-\rt	\ert	bracerighttp	u23AB	T{
-right curly brace top +
-T}
-\bracerighttp	\ebracerighttp	bracerighttp	u23AB	T{
-right curly brace top
-T}
-\rk	\erk	bracerightmid	u23AC	T{
-right curly brace middle +
-T}
-\bracerightmid	\ebracerightmid	bracerightmid	u23AC	T{
-right curly brace middle
-T}
-\rb	\erb	bracerightbt	u23AD	T{
-right curly brace bottom +
-T}
-\bracerightbt	\ebracerightbt	bracerightbt	u23AD	T{
-right curly brace bottom
-T}
-\bracerightex	\ebracerightex	bracerightex	u23AA	T{
-right curly brace extension
-T}
-\parenlefttp	\eparenlefttp	parenlefttp	u239B	T{
-left parenthesis top
-T}
-\parenleftbt	\eparenleftbt	parenleftbt	u239D	T{
-left parenthesis bottom
-T}
-\parenleftex	\eparenleftex	parenleftex	u239C	T{
-left parenthesis extension
-T}
-\parenrighttp	\eparenrighttp	parenrighttp	u239E	T{
-right parenthesis top
-T}
-\parenrightbt	\eparenrightbt	parenrightbt	u23A0	T{
-right parenthesis bottoom
-T}
-\parenrightex	\eparenrightex	parenrightex	u239F	T{
-right parenthesis extension
-T}
+\lt	\elt	u23A7	left brace top +
+\lk	\elk	u23A8	left brace middle +
+\lb	\elb	u23A9	left brace bottom +
+\bracelefttp	\ebracelefttp	u23A7	left brace top
+\braceleftmid	\ebraceleftmid	u23A8	left brace middle
+\braceleftbt	\ebraceleftbt	u23A9	left brace bottom
+\braceleftex	\ebraceleftex	u23AA	left brace extension
+
+\rt	\ert	u23AB	right brace top +
+\rk	\erk	u23AC	right brace middle +
+\rb	\erb	u23AD	right brace bottom +
+\bracerighttp	\ebracerighttp	u23AB	right brace top
+\bracerightmid	\ebracerightmid	u23AC	right brace middle
+\bracerightbt	\ebracerightbt	u23AD	right brace bottom
+\bracerightex	\ebracerightex	u23AA	right brace extension
+
+\parenlefttp	\eparenlefttp	u239B	left parenthesis top
+\parenleftex	\eparenleftex	u239C	left parenthesis extension
+\parenleftbt	\eparenleftbt	u239D	left parenthesis bottom
+\parenrighttp	\eparenrighttp	u239E	right parenthesis top
+\parenrightex	\eparenrightex	u239F	right parenthesis extension
+\parenrightbt	\eparenrightbt	u23A0	right parenthesis bottom
 .TE
-.ad
 .
-.P
-.I Arrows
-.P
-.na
+.
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS Arrows
+.\" ====================================================================
+.
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\<-	\e<-	arrowleft	u2190	horizontal arrow left +
-\->	\e->	arrowright	u2192	horizontal arrow right +
-\<>	\e<>	arrowboth	u2194	T{
-horizontal arrow in both directions
-T}
-\da	\eda	arrowdown	u2193	vertical arrow down +
-\ua	\eua	arrowup	u2191	vertical arrow up +
-\va	\eva	arrowupdn	u2195	T{
-vertical arrow in both directions
-T}
-\lA	\elA	arrowdblleft	u21D0	horizontal double arrow left
-\rA	\erA	arrowdblright	u21D2	horizontal double arrow right
-\hA	\ehA	arrowdblboth	u21D4	T{
-horizontal double arrow in both directions
-T}
-\dA	\edA	arrowdbldown	u21D3	vertical double arrow down
-\uA	\euA	arrowdblup	u21D1	vertical double arrow up
-\vA	\evA	uni21D5	u21D5	T{
-vertical double arrow in both directions
-T}
-\an	\ean	arrowhorizex	u23AF	horizontal arrow extension
+.T&
+L Lf(CR) L Lx.
+\<-	\e<\-	u2190	horizontal arrow left +
+\->	\e\->	u2192	horizontal arrow right +
+\<>	\e<>	u2194	bidirectional horizontal arrow
+\da	\eda	u2193	vertical arrow down +
+\ua	\eua	u2191	vertical arrow up +
+\va	\eva	u2195	bidirectional vertical arrow
+\lA	\elA	u21D0	horizontal double arrow left
+\rA	\erA	u21D2	horizontal double arrow right
+\hA	\ehA	u21D4	bidirectional horizontal double arrow
+\dA	\edA	u21D3	vertical double arrow down
+\uA	\euA	u21D1	vertical double arrow up
+\vA	\evA	u21D5	bidirectional vertical double arrow
+\an	\ean	u23AF	horizontal arrow extension
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Rules and lines"
+.\" ====================================================================
+.
+On typesetting devices,
+the font-invariant glyphs
+(see subsection \lqBrackets\rq above)
+.BR \rsbr ,
+.BR \rsul ,
+and
+.B \rsrn
+form corners when adjacent;
+they can be used to build boxes.
+.
+On terminal devices,
+they are mapped as shown in the table.
+.
+The Unicode-derived names of these three glyphs are approximations.
+.
 .
 .P
-.I Lines
-.P
-The font-invariant glyphs \oqbr\cq, \oqul\cq, and \oqrn\cq
-form corners; they can be used to build boxes.
+The input character
+.B _
+always accesses the underscore glyph in a font;
+.\" unless one isn't available, but this seems to be only a theoretical
+.\" concern--what font doesn't support every ASCII codepoint these days?
+.BR \rsul ,
+by contrast,
+may be font-invariant on typesetting devices.
 .
-Note that both the PostScript and the Unicode-derived names of
-these three glyphs are just rough approximations.
 .
 .P
-\oqrn\cq also serves in classical troff as the horizontal
-extension of the square root sign.
+The baseline rule
+.B \rsru
+is a font-invariant glyph,
+namely a rule of one-half em.
+.
 .
 .P
-\oqru\cq is a font-invariant glyph, namely a rule of length 0.5m.
+In AT&T
+.IR troff , \" AT&T
+.B \rsrn
+also served as a one\~en extension of the square root symbol.
+.
+.I groff
+favors
+.B \rsradicalex
+for this purpose;
+see subsection \lqMathematical symbols\rq below.
+.
 .
 .P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\ba	\eba	bar	u007C
-\br	\ebr	SF110000	u2502	box rule +
-\ul	\eul	underscore	u005F	+
-\rn	\ern	overline	u203E	+
-\ru	\eru	---	---	baseline rule +
-\bb	\ebb	brokenbar	u00A6
-\sl	\esl	slash	u002F	+
-\rs	\ers	backslash	u005C	reverse solidus
+.T&
+L Lf(CR) L Lx.
+|	|	u007C	bar
+\ba	\eba	u007C	bar
+\br	\ebr	u2502	box rule +
+\&_	\&_	u005F	underscore, low line +
+\ul	\eul	---	underrule +
+\rn	\ern	u203E	overline +
+\ru	\eru	---	baseline rule +
+\bb	\ebb	u00A6	broken bar
+\sl	/	u002F	slash, solidus +
+\sl	\esl	u002F	slash, solidus +
+\rs	\ers	u005C	reverse solidus
 .TE
-.ad
 .
-.P
-Use \oq\f(CW\eradicalex\fP\cq, not
-\oq\f(CW\eoverline\fP\cq, for continuation of square root.
 .
-.P
-.I Text markers
-.P
-.na
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS "Text markers"
+.\" ====================================================================
+.
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\ci	\eci	circle	u25CB	+
-\bu	\ebu	bullet	u2022	+
-\dd	\edd	daggerdbl	u2021	double dagger sign +
-\dg	\edg	dagger	u2020	dagger +
-\lz	\elz	lozenge	u25CA	lozenge, diamond, pound key
-\sq	\esq	uni25A1	u25A1	white square +
-\ps	\eps	paragraph	u00B6	end of paragraph marker
-\sc	\esc	section	u00A7	section sign +
-\lh	\elh	uni261C	u261C	hand pointing left +
-\rh	\erh	a14	u261E	hand pointing right +
-\at	\eat	at	u0040	at
-\sh	\esh	numbersign	u0023	number sign
-\CR	\eCR	carriagereturn	u21B5	carriage return
-\OK	\eOK	a19	u2713	check mark, tick
+.T&
+L Lf(CR) L Lx.
+\ci	\eci	u25CB	circle +
+\bu	\ebu	u2022	bullet +
+\dg	\edg	u2020	dagger +
+\dd	\edd	u2021	double dagger +
+\lz	\elz	u25CA	lozenge, diamond
+\sq	\esq	u25A1	square +
+\ps	\eps	u00B6	pilcrow sign
+\sc	\esc	u00A7	section sign +
+\lh	\elh	u261C	hand pointing left +
+\rh	\erh	u261E	hand pointing right +
+\at	@	u0040	at sign
+\at	\eat	u0040	at sign
+\sh	#	u0023	number sign
+\sh	\esh	u0023	number sign
+\CR	\eCR	u21B5	carriage return
+\OK	\eOK	u2713	check mark
 .TE
-.ad
+.
+.\" ====================================================================
+.SS "Legal symbols"
+.\" ====================================================================
+.
+The Bell System logo is not supported in
+.IR groff .
+.
 .
 .P
-.I Legal Symbols
-.P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\co	\eco	copyright	u00A9	+
-\rg	\erg	registered	u00AE	+
-\tm	\etm	trademark	u2122
-\bs	\ebs	---	---	AT&T Bell Labs logo +
+.T&
+L Lf(CR) L Lx.
+\co	\eco	u00A9	copyright sign +
+\rg	\erg	u00AE	registered sign +
+\tm	\etm	u2122	trade mark sign
+\bs	\ebs	---	Bell System logo +
 .TE
-.ad
 .
-.P
-The Bell Labs logo is not supported in groff.
 .
-.P
-.I Currency symbols
-.P
-.na
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS "Currency symbols"
+.\" ====================================================================
+.
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\Do	\eDo	dollar	u0024	dollar
-\ct	\ect	cent	u00A2	cent +
-\eu	\eeu	---	u20AC	official Euro symbol
-\Eu	\eEu	Euro	u20AC	font-specific Euro glyph variant
-\Ye	\eYe	yen	u00A5	Japanese Yen
-\Po	\ePo	sterling	u00A3	pound sterling (British)
-\Cs	\eCs	currency	u00A4	Scandinavian currency sign
-\Fn	\eFn	florin	u0192	Dutch currency sign
+.T&
+L Lf(CR) L Lx.
+\Do	$	u0024	dollar sign
+\Do	\eDo	u0024	dollar sign
+\ct	\ect	u00A2	cent sign +
+\eu	\eeu	u20AC	Euro sign
+\Eu	\eEu	u20AC	variant Euro sign
+\Ye	\eYe	u00A5	yen sign
+\Po	\ePo	u00A3	pound sign
+\Cs	\eCs	u00A4	currency sign
 .TE
-.ad
 .
-.P
-.I Units
-.P
-.na
+.
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS Units
+.\" ====================================================================
+.
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\de	\ede	degree	u00B0	degree +
-\%0	\e%0	perthousand	u2030	per thousand, per mille sign
-\fm	\efm	minute	u2032	arc minute sign +
-\sd	\esd	second	u2033	acr second sign
-\mc	\emc	mu	u00B5	mu, micro sign
-\Of	\eOf	ordfeminine	u00AA	feminine ordinal (Spanish)
-\Om	\eOm	ordmasculine	u00BA	masculine ordinal (Spanish)
+.T&
+L Lf(CR) L Lx.
+\de	\ede	u00B0	degree sign +
+\%0	\e%0	u2030	per thousand, per mille sign
+\fm	\efm	u2032	arc minute sign, foot mark +
+\sd	\esd	u2033	arc second sign
+\mc	\emc	u00B5	micro sign
+\Of	\eOf	u00AA	feminine ordinal indicator
+\Om	\eOm	u00BA	masculine ordinal indicator
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Logical symbols"
+.\" ====================================================================
+.
+The variants of the not sign may differ in appearance or spacing
+depending on the device and font selected.
+.
+Unicode does not encode a discrete \lqbitwise or\rq sign:
+on typesetting devices,
+it is drawn shorter than the bar,
+about the same height as a capital letter.
+.
+Terminal devices unify
+.B \rsba
+and
+.BR \rsor .
+.
 .
 .P
-.I Logical Symbols
-.P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\AN	\eAN	logicaland	u2227	logical and
-\OR	\eOR	logicalor	u2228	logical or
-\no	\eno	logicalnot	u00AC	logical not + ***
-\tno	\etno	logicalnot	u00AC	text variant of \oqno\cq
-\te	\ete	existential	u2203	there exists
-\fa	\efa	universal	u2200	for all
-\st	\est	suchthat	u220B	sucht that
-\3d	\e3d	therefore	u2234	therefore
-\tf	\etf	therefore	u2234	therefore
-\or	\eor	bar	u007C	T{
-bitwise OR operator (as used in\ C) +
-T}
+.T&
+L Lf(CR) L Lx.
+\AN	\eAN	u2227	logical and
+\OR	\eOR	u2228	logical or
+\no	\eno	u00AC	logical not + ***
+\tno	\etno	u00AC	text variant of \fB\eno\f
+\te	\ete	u2203	there exists
+\fa	\efa	u2200	for all
+\st	\est	u220B	such that
+\3d	\e3d	u2234	therefore
+\tf	\etf	u2234	therefore
+|	|	u007C	bar
+\or	\eor	u007C	bitwise or +
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Mathematical symbols"
+.\" ====================================================================
+.
+.B \rsFn
+also appears in subsection \lqSupplementary Latin letters\rq above.
+.
+Observe the two varieties of the
+plus-minus,
+multiplication,
+and division signs;
+.BR \rs+\- ,
+.BR \rsmu ,
+and
+.B \rsdi
+are normally drawn from the special font,
+but have text font variants.
+.
+Also be aware of three glyphs available in special font variants that
+are normally drawn from text fonts:
+the plus,
+minus,
+and equals signs.
+.
+These variants may differ in appearance or spacing depending on the
+device and font selected.
+.
 .
 .P
-.I Mathematical Symbols
+In AT&T
+.IR troff ,
+.B \rs(rn
+(\lqroot en extender\rq)
+served as the horizontal extension of the radical
+(square root)
+sign,
+.BR \rs(sr ,
+and was drawn at the maximum height of the typeface's bounding box;
+this enabled the special character to double as an overline
+(see subsection \lqRules and lines\rq above).
+.
+A contemporary font's radical sign might not ascend to such an extreme.
+.
+In
+.IR groff ,
+you can instead use
+.B \rsradicalex
+to continue the radical sign
+.BR \rssr ;
+these special characters are intended for use with text fonts.
+.
+.B \rssqrt
+and
+.B \rssqrtex
+are their counterparts with mathematical spacing.
+.
+.
 .P
-.na
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
+L L L Lx.
+Output	Input	Unicode	Notes
 _
-\12	\e12	onehalf	u00BD	1/2 symbol +
-\14	\e14	onequarter	u00BC	1/4 symbol +
-\34	\e34	threequarters	u00BE	3/4 symbol +
-\18	\e18	oneeighth	u215B	1/8 symbol
-\38	\e38	threeeighths	u215C	3/8 symbol
-\58	\e58	fiveeighths	u215D	5/8 symbol
-\78	\e78	seveneighths	u215E	7/8 symbol
-\S1	\eS1	onesuperior	u00B9	superscript 1
-\S2	\eS2	twosuperior	u00B2	superscript 2
-\S3	\eS3	threesuperior	u00B3	superscript 3
+.T&
+L Lf(CR) L Lx.
+\12	\e12	u00BD	one half symbol +
+\14	\e14	u00BC	one quarter symbol +
+\34	\e34	u00BE	three quarters symbol +
+\18	\e18	u215B	one eighth symbol
+\38	\e38	u215C	three eighths symbol
+\58	\e58	u215D	five eighths symbol
+\78	\e78	u215E	seven eighths symbol
+\S1	\eS1	u00B9	superscript one
+\S2	\eS2	u00B2	superscript two
+\S3	\eS3	u00B3	superscript three
 
-\pl	\epl	plus	u002B	plus in special font +
-\mi	\emi	minus	u2212	minus in special font +
-\-+	\e-+	uni2213	u2213	minus-plus
-\+-	\e+-	plusminus	u00B1	plus-minus + ***
-\t+-	\et+-	plusminus	u00B1	text variant of \e+-
-\pc	\epc	periodcentered	u00B7	period centered
-\md	\emd	dotmath	u22C5	multiplication dot
-\mu	\emu	multiply	u00D7	multiply sign + ***
-\tmu	\etmu	multiply	u00D7	text variant of \emu
-\c*	\ec*	circlemultiply	u2297	multiply sign in circle
-\c+	\ec+	circleplus	u2295	plus sign in circle
-\di	\edi	divide	u00F7	division sign + ***
-\tdi	\etdi	divide	u00F7	text variant of \edi
-\f/	\ef/	fraction	u2044	bar for fractions
-\**	\e**	asteriskmath	u2217	mathematical asterisk +
++	+	u002B	plus
+\pl	\epl	u002B	special variant of plus + ***
+\-	\e\-	u002D	minus
+\mi	\emi	u2212	special variant of minus + ***
+\-+	\e\-+	u2213	minus-plus
+\+-	\e+\-	u00B1	plus-minus + ***
+\t+-	\et+\-	u00B1	text variant of \fB\e+\-\f
+\md	\emd	u22C5	multiplication dot
+\mu	\emu	u00D7	multiplication sign + ***
+\tmu	\etmu	u00D7	text variant of \fB\emu\f
+\c*	\ec*	u2297	circled times
+\c+	\ec+	u2295	circled plus
+\di	\edi	u00F7	division sign + ***
+\tdi	\etdi	u00F7	text variant of \fB\edi\f
+\f/	\ef/	u2044	fraction slash
+*	*	u002A	asterisk
+\**	\e**	u2217	mathematical asterisk +
 
-\<=	\e<=	lessequal	u2264	less or equal +
-\>=	\e>=	greaterequal	u2265	greater or equal +
-\<<	\e<<	uni226A	u226A	much less
-\>>	\e>>	uni226B	u226B	much greater
-\eq	\eeq	equal	u003D	equals in special font +
-\!=	\e!=	notequal	u003D_0338	not equal +
-\==	\e==	equivalence	u2261	equivalent +
-\ne	\ene	uni2262	u2261_0338	not equivalent
-\=~	\e=~	congruent	u2245	T{
-congruent, approx.\& equal
-T}
-\|=	\e|=	uni2243	u2243	asymptot.\& equal to +
-\ap	\eap	similar	u223C	similar +
-\~~	\e~~	approxequal	u2248	almost equal to
-\~=	\e~=	approxequal	u2248	almost equal to
-\pt	\ept	proportional	u221D	proportional +
+\<=	\e<=	u2264	less than or equal to +
+\>=	\e>=	u2265	greater than or equal to +
+\<<	\e<<	u226A	much less than
+\>>	\e>>	u226B	much greater than
+\&=	\&=	u003D	equals
+\eq	\eeq	u003D	special variant of equals + ***
+\!=	\e!=	u003D_0338	not equals +
+\==	\e==	u2261	equivalent +
+\ne	\ene	u2261_0338	not equivalent
+\=~	\e=\ti	u2245	approximately equal to
+\|=	\e|=	u2243	asymptotically equal to +
+\ti	\eti	u007E	tilde +
+\ap	\eap	u223C	similar to, tilde operator +
+\~~	\e\ti\ti	u2248	almost equal to
+\~=	\e\ti=	u2248	almost equal to
+\pt	\ept	u221D	proportional to +
 
-\es	\ees	emptyset	u2205	empty set +
-\mo	\emo	element	u2208	element of a set +
-\nm	\enm	notelement	u2208_0338	not element of set
-\sb	\esb	propersubset	u2282	proper subset +
-\nb	\enb	notsubset	u2282_0338	not supset
-\sp	\esp	propersuperset	u2283	proper superset +
-\nc	\enc	uni2285	u2283_0338	not superset
-\ib	\eib	reflexsubset	u2286	subset or equal +
-\ip	\eip	reflexsuperset	u2287	superset or equal +
-\ca	\eca	intersection	u2229	intersection, cap +
-\cu	\ecu	union	u222A	union, cup +
+\es	\ees	u2205	empty set +
+\mo	\emo	u2208	element of a set +
+\nm	\enm	u2208_0338	not element of set
+\sb	\esb	u2282	proper subset +
+\nb	\enb	u2282_0338	not subset
+\sp	\esp	u2283	proper superset +
+\nc	\enc	u2283_0338	not superset
+\ib	\eib	u2286	subset or equal +
+\ip	\eip	u2287	superset or equal +
+\ca	\eca	u2229	intersection, cap +
+\cu	\ecu	u222A	union, cup +
 
-\/_	\e/_	angle	u2220	angle
-\pp	\epp	perpendicular	u22A5	perpendicular
-\is	\eis	integral	u222B	integral +
-\integral	\eintegral	integral	u222B	integral ***
-\sum	\esum	summation	u2211	summation ***
-\product	\eproduct	product	u220F	product ***
-\coproduct	\ecoproduct	uni2210	u2210	coproduct ***
-\gr	\egr	gradient	u2207	gradient +
-\sr	\esr	radical	u221A	square root +
-\sqrt	\esqrt	radical	u221A	square root
-\radicalex	\eradicalex	radicalex	---	T{
-square root continuation ***
-T}
-\sqrtex	\esqrtex	radicalex	---	T{
-square root continuation ***
-T}
+\/_	\e/_	u2220	angle
+\pp	\epp	u22A5	perpendicular
+\is	\eis	u222B	integral +
+\integral	\eintegral	u222B	integral ***
+\sum	\esum	u2211	summation ***
+\product	\eproduct	u220F	product ***
+\coproduct	\ecoproduct	u2210	coproduct ***
+\gr	\egr	u2207	gradient +
+\sr	\esr	u221A	radical sign, square root +
+\rn	\ern	u203E	overline +
+\radicalex	\eradicalex	---	radical extension
+\sqrt	\esqrt	u221A	radical sign, square root ***
+\sqrtex	\esqrtex	---	radical extension ***
 
-\lc	\elc	uni2308	u2308	left ceiling +
-\rc	\erc	uni2309	u2309	right ceiling +
-\lf	\elf	uni230A	u230A	left floor +
-\rf	\erf	uni230B	u230B	right floor +
+\lc	\elc	u2308	left ceiling +
+\rc	\erc	u2309	right ceiling +
+\lf	\elf	u230A	left floor +
+\rf	\erf	u230B	right floor +
 
-\if	\eif	infinity	u221E	infinity +
-\Ah	\eAh	aleph	u2135	aleph
-\Im	\eIm	Ifraktur	u2111	Gothic I, imaginary
-\Re	\eRe	Rfraktur	u211C	Gothic R, real
-\wp	\ewp	weierstrass	u2118	Weierstrass\~p
-\pd	\epd	partialdiff	u2202	T{
-partial differentiation +
-T}
-\-h	\e-h	uni210F	u210F	T{
-Planck\ constant\ /\ 2pi (h-bar)
-T}
-\hbar	\ehbar	uni210F	u210F	T{
-Planck\ constant\ /\ 2pi (h-bar)
-T}
+\if	\eif	u221E	infinity +
+\Ah	\eAh	u2135	aleph symbol
+\Fn	\eFn	u0192	lowercase f with hook, function
+\Im	\eIm	u2111	blackletter I, imaginary part
+\Re	\eRe	u211C	blackletter R, real part
+\wp	\ewp	u2118	Weierstrass p
+\pd	\epd	u2202	partial differential
+\-h	\e\-h	u210F	h bar
+\hbar	\ehbar	u210F	h bar
 .TE
-.ad
+.
+.
+.\" ====================================================================
+.SS "Greek glyphs"
+.\" ====================================================================
+.
+These glyphs are intended for technical use,
+not for typesetting Greek language text;
+normally,
+the uppercase letters have upright shape,
+and the lowercase ones are slanted.
+.
 .
 .P
-.I Greek glyphs
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
+.TS
+L L L Lx.
+Output	Input	Unicode	Notes
+_
+.T&
+L Lf(CR) L Lx.
+\*A	\e*A	u0391	uppercase alpha +
+\*B	\e*B	u0392	uppercase beta +
+\*G	\e*G	u0393	uppercase gamma +
+\*D	\e*D	u0394	uppercase delta +
+\*E	\e*E	u0395	uppercase epsilon +
+\*Z	\e*Z	u0396	uppercase zeta +
+\*Y	\e*Y	u0397	uppercase eta +
+\*H	\e*H	u0398	uppercase theta +
+\*I	\e*I	u0399	uppercase iota +
+\*K	\e*K	u039A	uppercase kappa +
+\*L	\e*L	u039B	uppercase lambda +
+\*M	\e*M	u039C	uppercase mu +
+\*N	\e*N	u039D	uppercase nu +
+\*C	\e*C	u039E	uppercase xi +
+\*O	\e*O	u039F	uppercase omicron +
+\*P	\e*P	u03A0	uppercase pi +
+\*R	\e*R	u03A1	uppercase rho +
+\*S	\e*S	u03A3	uppercase sigma +
+\*T	\e*T	u03A4	uppercase tau +
+\*U	\e*U	u03A5	uppercase upsilon +
+\*F	\e*F	u03A6	uppercase phi +
+\*X	\e*X	u03A7	uppercase chi +
+\*Q	\e*Q	u03A8	uppercase psi +
+\*W	\e*W	u03A9	uppercase omega +
+
+\*a	\e*a	u03B1	lowercase alpha +
+\*b	\e*b	u03B2	lowercase beta +
+\*g	\e*g	u03B3	lowercase gamma +
+\*d	\e*d	u03B4	lowercase delta +
+\*e	\e*e	u03B5	lowercase epsilon +
+\*z	\e*z	u03B6	lowercase zeta +
+\*y	\e*y	u03B7	lowercase eta +
+\*h	\e*h	u03B8	lowercase theta +
+\*i	\e*i	u03B9	lowercase iota +
+\*k	\e*k	u03BA	lowercase kappa +
+\*l	\e*l	u03BB	lowercase lambda +
+\*m	\e*m	u03BC	lowercase mu +
+\*n	\e*n	u03BD	lowercase nu +
+\*c	\e*c	u03BE	lowercase xi +
+\*o	\e*o	u03BF	lowercase omicron +
+\*p	\e*p	u03C0	lowercase pi +
+\*r	\e*r	u03C1	lowercase rho +
+\*s	\e*s	u03C3	lowercase sigma +
+\*t	\e*t	u03C4	lowercase tau +
+\*u	\e*u	u03C5	lowercase upsilon +
+\*f	\e*f	u03D5	lowercase phi +
+\*x	\e*x	u03C7	lowercase chi +
+\*q	\e*q	u03C8	lowercase psi +
+\*w	\e*w	u03C9	lowercase omega +
+
+\+e	\e+e	u03F5	variant epsilon (lunate)
+\+h	\e+h	u03D1	variant theta (cursive form)
+\+p	\e+p	u03D6	variant pi (similar to omega)
+\+f	\e+f	u03C6	variant phi (curly shape)
+\ts	\ets	u03C2	terminal lowercase sigma +
+.TE
+.
+.
+.br
+.if t .ne 4v
+.if n .ne 5v \" account for horizontal rule
+.\" ====================================================================
+.SS "Playing card symbols"
+.\" ====================================================================
+.
+.TS
+L L L Lx.
+Output	Input	Unicode	Notes
+_
+.T&
+L Lf(CR) L Lx.
+\CL	\eCL	u2663	solid club suit
+\SP	\eSP	u2660	solid spade suit
+\HE	\eHE	u2665	solid heart suit
+\DI	\eDI	u2666	solid diamond suit
+.TE
+.
+.
+.\" ====================================================================
+.SH History
+.\" ====================================================================
+.
+A consideration of the typefaces originally available to AT&T
+.I nroff \" AT&T
+and
+.I troff \" AT&T
+illuminates many conventions that one might regard as idiosyncratic
+fifty years afterward.
+.
+(See section \lqHistory\rq of
+.MR roff @MAN7EXT@
+for more context.)
+.
+The face used by the Teletype Model\~37 terminals of the Murray Hill
+Unix Room was based on ASCII,
+but assigned multiple meanings to several code points,
+as suggested by that standard.
+.
+Decimal 34
+.RB ( \dq )
+served as a dieresis accent and neutral double quotation mark;
+decimal 39
+.RB ( \aq )
+as an acute accent,
+apostrophe,
+and closing (right) single quotation mark;
+decimal 45
+.RB ( \- )
+as a hyphen and a minus sign;
+decimal 94
+.RB ( \ha )
+as a circumflex accent and caret;
+decimal 96
+.RB ( \ga )
+as a grave accent and opening (left) single quotation mark;
+and decimal 126
+.RB ( \ti )
+as a tilde accent and
+(with a half-line motion)
+swung dash.
+.
+The Model\~37 bore an optional extended character set offering upright
+Greek letters and several mathematical symbols;
+these were documented as early as the
+.IR kbd (VII)
+man page of the
+(First Edition)
+.I Unix Programmer's Manual.
+.
+.
+.br
+.ne 2v
 .P
-These glyphs are intended for technical use, not for real Greek;
-normally, the uppercase letters have upright shape, and the lowercase
-ones are slanted.
-.
-There is a problem with the mapping of letter phi to Unicode.
-.
-Prior to Unicode version\ 3.0, the difference between U+03C6, GREEK
-SMALL LETTER PHI, and U+03D5, GREEK PHI SYMBOL, was not clearly
-described; only the glyph shapes in the Unicode book could be used as a
-reference.
-.
-Starting with Unicode\ 3.0, the reference glyphs have been exchanged and
-described verbally also: In mathematical context, U+03D5 is the stroked
-variant and U+03C6 the curly glyph.
-.
-Unfortunately, most font vendors didn't update their fonts to
-this (incompatible) change in Unicode.
-.
-At the time of this writing (January 2006), it is not clear yet
-whether the Adobe Glyph Names \oqphi\cq and \oqphi1\cq also
-change its meaning if used for mathematics, thus compatibility
-problems are likely to happen \en being conservative, groff
-currently assumes that \oqphi\cq in a PostScript symbol font is
-the stroked version.
+At the time Graphic Systems delivered the C/A/T phototypesetter to AT&T,
+the ASCII character set was not considered a standard basis for a glyph
+repertoire by traditional typographers.
+.
+In the stock Times roman,
+italic,
+and bold styles available,
+several ASCII characters were not present at all,
+nor was most of the Teletype's extended character set.
+.
+AT&T commissioned a \lqspecial\rq font to ensure no loss of
+repertoire.
+.
+.
+.br
+.ne 2v
 .P
-In groff, symbol \oq\f(CW\e*f\fP\cq always denotes the stroked
-version of phi, and \oq\f(CW\e+f\fP\cq the curly variant.
+A representation of the coverage of the C/A/T's text fonts follows.
+.
+The glyph resembling an underscore is a baseline rule,
+and that resembling a vertical line is a box rule.
+.
+In italics,
+the box rule was not slanted.
+.
+We also observe that the hyphen and minus sign were already
+\lqde-unified\rq by the fonts provided;
+a decision whither to map an input \lq\-\rq therefore had to be
+taken.
+.
+.
+.br
+.if t .ne 5v
+.if t .ne 7v \" account for box border
 .P
-.na
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
-_
-\*A	\e*A	Alpha	u0391	+
-\*B	\e*B	Beta	u0392	+
-\*G	\e*G	Gamma	u0393	+
-\*D	\e*D	Delta	u0394	+
-\*E	\e*E	Epsilon	u0395	+
-\*Z	\e*Z	Zeta	u0396	+
-\*Y	\e*Y	Eta	u0397	+
-\*H	\e*H	Theta	u0398	+
-\*I	\e*I	Iota	u0399	+
-\*K	\e*K	Kappa	u039A	+
-\*L	\e*L	Lambda	u039B	+
-\*M	\e*M	Mu	u039C	+
-\*N	\e*N	Nu	u039D	+
-\*C	\e*C	Xi	u039E	+
-\*O	\e*O	Omicron	u039F	+
-\*P	\e*P	Pi	u03A0	+
-\*R	\e*R	Rho	u03A1	+
-\*S	\e*S	Sigma	u03A3	+
-\*T	\e*T	Tau	u03A4	+
-\*U	\e*U	Upsilon	u03A5	+
-\*F	\e*F	Phi	u03A6	+
-\*X	\e*X	Chi	u03A7	+
-\*Q	\e*Q	Psi	u03A8	+
-\*W	\e*W	Omega	u03A9	+
-\*a	\e*a	alpha	u03B1	+
-\*b	\e*b	beta	u03B2	+
-\*g	\e*g	gamma	u03B3	+
-\*d	\e*d	delta	u03B4	+
-\*e	\e*e	epsilon	u03B5	+
-\*z	\e*z	zeta	u03B6	+
-\*y	\e*y	eta	u03B7	+
-\*h	\e*h	theta	u03B8	+
-\*i	\e*i	iota	u03B9	+
-\*k	\e*k	kappa	u03BA	+
-\*l	\e*l	lambda	u03BB	+
-\*m	\e*m	mu	u03BC	+
-\*n	\e*n	nu	u03BD	+
-\*c	\e*c	xi	u03BE	+
-\*o	\e*o	omicron	u03BF	+
-\*p	\e*p	pi	u03C0	+
-\*r	\e*r	rho	u03C1	+
-\ts	\ets	sigma1	u03C2	terminal sigma +
-\*s	\e*s	sigma	u03C3	+
-\*t	\e*t	tau	u03C4	+
-\*u	\e*u	upsilon	u03C5	+
-\*f	\e*f	phi	u03D5	(stroked glyph) +
-\*x	\e*x	chi	u03C7	+
-\*q	\e*q	psi	u03C8	+
-\*w	\e*w	omega	u03C9	+
-\+h	\e+h	theta1	u03D1	variant theta
-\+f	\e+f	phi1	u03C6	variant phi (curly shape)
-\+p	\e+p	omega1	u03D6	variant pi, looking like omega
-\+e	\e+e	uni03F5	u03F5	variant epsilon
+center box;
+Lf(R).
+A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
+a b c d e f g h i j k l m n o p q r s t u v w x y z
+0 1 2 3 4 5 6 7 8 9 \fi \fl \Fi \Fl
+! $ % & ( ) \oq \cq * + \- . , / : ; = ?   \br
+\bu \sq \em \hy \ru \14 \12 \34 \
+\de \dg \fm \ct \rg \co
 .TE
-.ad
+.
 .
 .P
-.I Card symbols
+The special font supplied the missing ASCII and Teletype extended
+glyphs,
+among several others.
+.
+The plus,
+minus,
+and equals signs appeared in the special font despite availability in
+text fonts \lqto insulate the appearance of equations from the choice
+of standard read: text fonts\rq\ema priority since
+.I troff \" AT&T
+was turned to the task of mathematical typesetting as soon as it was
+developed.
+.
+.
+.P
+We note that AT&T took the opportunity to de-unify the apostrophe/right
+single quotation mark from the acute accent
+(a choice ISO later duplicated in its 8859 series of standards).
+.
+A slash intended to be mirror-symmetric with the backslash was also
+included,
+as was the Bell System logo;
+we do not attempt to depict the latter.
+.
+.
+.br
+.if t .ne 5v
+.if t .ne 7v \" account for box border
 .P
-.na
 .TS
-l l l l lx.
-Output	Input	PostScript	Unicode	Notes
-_
-\CL	\eCL	club	u2663	black club suit
-\SP	\eSP	spade	u2660	black spade suit
-\HE	\eHE	heart	u2665	black heart suit
-\u2661	\eu2661	uni2661	u2661	white heart suit
-\DI	\eDI	diamond	u2666	black diamond suit
-\u2662	\eu2662	uni2662	u2662	white diamond suit
+center box;
+Lf(I),Lf(R).
+\*a \*b \*g \*d \*e \*z \*y \*h \*i \*k \*l \
+\*m \*n \*c \*o \*p \*r \*s \ts \*t \*u \*f \
+\*x \*q \*w
+\*G \*D \*H \*L \*C \*P \*S \*U \*F \*Q \*W
+\dq \aa \rs \ha \ul \ga \ti \sl < > { } # @ \
+\pl \mi \eq \**
+.\" We use \radicalex instead of \rn for more reliable simulation of
+.\" the typeface shown in Table I of CSTR #54 (1976); see subsection
+.\" "Mathematical symbols" above.
+\>= \<= \== \~= \ap \!= \
+\ua \da \<- \-> \mu \di \+- \
+\if \pd \gr \no \is \pt \sr \radicalex \
+\cu \ca \sb \sp \ib \ip \es \mo
+\sc \dd \lh \rh \or \ci \
+\lt \lb \rt \rb \lk \rk \bv \lf \rf \lc \rc
 .TE
-.ad
+.
+.
+.P
+One ASCII character as rendered by the Model 37 was apparently
+abandoned.
+.
+That device printed decimal 124 (\or) as a broken vertical line,
+like Unicode U+00A6 (\bb).
+.
+No equivalent was available on the C/A/T;
+the box rule
+.BR \rsbr ,
+brace vertical extension
+.\" CSTR #54 (1976 edition) called this the "bold vertical", probably
+.\" because it was thicker than the box rule and matched the thickness
+.\" of the bracket pieces \(lt, \(lb, \(rt, \(rb, \(lk, \(rk, and so on.
+.\" Saying "bold" could be misleading because it appeared only in the
+.\" special font, not a bold text font.
+.BR \rsbv ,
+and \lqor\rq operator
+.B \rsor
+were used as contextually appropriate.
+.
+.
+.P
+.\" In the Holt, Reinhart, Winston edition of the _Unix Programmer's
+.\" Manual_, Revised and Expanded Version, Volume 2 (1983), the square
+.\" \(sq in Times bold is _not_ shown as filled on page 226.
+.\"
+.\" ...but in the AT&T USG Unix 4.0 manual (ca. 1981), typeset on the
+.\" Autologic APS-5, the Times bold \(sq _is_ filled.
+.\"
+.\" https://www.tuhs.org/Archive/Documentation/Manuals/Unix_4.0/
+.\"   Volume_1/00_Annotated_Table_of_Contents.pdf
+.\"   Volume_1/C.1.2_NROFF_TROFF_Users_Manual.pdf
+.\" -- GBR
+Devices supported by AT&T device-independent
+.I troff
+exhibited some differences in glyph detail.
+.
+For example,
+on the Autologic APS-5 phototypesetter,
+the square
+.B \rs(sq
+became filled in the Times bold face.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Files
+.\" ====================================================================
+.
+The files below are loaded automatically by the default
+.IR troffrc .
+.
+.
+.TP
+.I @MACRODIR@/\:\%composite\:.tmac
+assigns alternate mappings for identifiers after the first in a
+composite special character escape sequence.
+.
+See subsection \lqAccents\rq above.
+.
+.
+.TP
+.I @MACRODIR@/\:\%fallbacks\:.tmac
+defines fallback mappings for Unicode code points such as the increment
+sign (U+2206) and upper- and lowercase Roman numerals.
+.
+.
+.\" ====================================================================
+.SH Authors
 .\" ====================================================================
 .
 This document was written by
-.MT jjc@\:jclark.com
+.MT jjc@\:jclark\:.com
 James Clark
 .ME ,
 with additions by
-.MT wl@\:gnu.org
+.MT wl@\:gnu\:.org
 Werner Lemberg
 .ME
 and
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME ,
-and revised to use real tables by
-.MT esr@\:thyrsus.com
+revised to use
+.MR @g@tbl @MAN1EXT@
+by
+.MT esr@\:thyrsus\:.com
 Eric S.\& Raymond
+.ME ,
+and largely rewritten by
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -1362,42 +2200,83 @@
 .
 Section \lqUsing Symbols\rq may be of particular note.
 .
-You can browse it interactively with \lqinfo \aq(groff)Using
+You can browse it interactively with \lqinfo \aq(groff) Using
 Symbols\aq\rq.
 .
 .
-.TP
-.BR groff (@MAN1EXT@)
-the GNU roff formatter
-.
-.TP
-.BR groff (@MAN7EXT@)
-a short reference of the groff formatting language
+.P
+\lqAn extension to the
+.I troff
+character set for Europe\rq,
+E.G.\& Keizer,
+K.J.\& Simonsen,
+J.\& Akkerhuis;
+EUUG Newsletter,
+Volume 9,
+No.\& 2,
+Summer 1989
 .
 .
 .P
-.IR "An extension to the troff character set for Europe" ,
-E.G.\& Keizer, K.J.\& Simonsen, J.\& Akkerhuis; EUUG Newsletter,
-Volume 9, No.\& 2, Summer 1989
+.UR http://\:www\:.unicode\:.org
+The Unicode Standard
+.UE
 .
 .
+.br
+.ne 2v
 .P
-.UR http://\:www.unicode.org
-The Unicode Standard
+.UR https://\:www\:.aivosto\:.com/\:articles/\:charsets\-7bit\:.html
+\lq7-bit Character Sets\rq
 .UE
+by Tuomas Salste documents the inherent ambiguity and configurable code
+points of the ASCII encoding standard.
 .
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_char_C
+.P
+\lqNroff/Troff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
+features two tables that throw light on the glyph repertoire available
+to \lqtypesetter
+.IR roff \rq
+when it was first written.
 .
+Be careful of re-typeset versions of this document that can be found on
+the Internet.
+.
+Some do not accurately represent the original document:
+several glyphs are obviously missing.
+.
+More subtly,
+lowercase Greek letters are rendered upright,
+not slanted as they appeared in the C/A/T's special font and as expected
+by
+.I troff \" AT&T
+users.
+.
+.
+.P
+.MR groff_rfc1345 @MAN7EXT@
+describes an alternative set of special character glyph names,
+which extends and in some cases overrides the definitions listed above.
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR troff @MAN1EXT@ ,
+.MR groff @MAN7EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_char_7_man_C
+.do rr *groff_groff_char_7_man_C
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" tab-width: 20
 .\" End:
 .\" vim: set filetype=groff tabstop=20 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/groff_diff.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff_diff.7.man Changed

@@ -1,23 +1,17 @@
 '\" e
-.TH GROFF_DIFF @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_diff \- differences between GNU troff and classical troff
-.
-.\" groff_diff.man:
-.\" Source file position: <groff_source>/man/groff_diff.man
-.\" Installed position: <prefix>/share/man/man7/groff_diff.7
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_diff_C \n.C
-.cp 0
+.TH groff_diff @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_diff \- differences between GNU
+.I roff
+and AT&T
+.I troff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -31,6 +25,26 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_diff_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Local definitions
 .\" ====================================================================
@@ -46,623 +60,1217 @@
 .el \
 .  ds ic \^
 .
-.\" ellipsis
-.ds ellipsis \&.\|.\|.\&
-.
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This manual page describes the language differences between
-.IR groff ,
-the GNU
+The GNU
 .I roff
-text processing system, and the classical
-.I roff
-formatter of the freely available Unix\~7 of the 1970s, documented in
-the
-.I Troff User's Manual
-by
-.I Ossanna
-and
-.IR Kernighan .
+text processing system,
+.IR groff ,
+is an extension of AT&T
+.IR troff , \" AT&T
+the typesetting system originating in Unix systems of the 1970s.
 .
-This includes the roff language as well as the intermediate output
-format (troff output).
+.I groff
+removes many arbitrary limitations and adds features,
+both to the input language and to the page description language output
+by the
+.I troff \" generic
+formatter.
+.
+Differences arising from
+.IR groff 's
+implementation of AT&T
+.I troff \" AT&T
+features are also noted.
 .
+See
+.MR roff @MAN7EXT@
+for background.
 .
-.P
-Section \lqSee Also\rq below gives pointers to both the classical
-.I roff
-and the modern
-.I groff
-documentation.
+.
+.\" ====================================================================
+.SH Language
+.\" ====================================================================
+.
+GNU
+.I troff \" GNU
+features identifiers of arbitrary length;
+supports color output,
+non-integral type sizes,
+and user-defined characters;
+adds more conditional expression operators;
+recognizes additional scaling units and numeric operators;
+enables general file I/O
+(in \lqunsafe mode\rq only);
+and exposes more formatter state.
 .
 .
 .\" ====================================================================
-.SH "GROFF LANGUAGE"
+.SS "Long names"
 .\" ====================================================================
 .
-In this section, all additional features of
+GNU
+.I troff \" GNU
+introduces many new requests;
+with three exceptions
+.RB ( cp ,
+.BR do ,
+.BR rj ),
+they have names longer than two characters.
+.
+The names of registers,
+fonts,
+strings/\:macros/\:diversions,
+environments,
+special characters,
+streams,
+and colors can be of any length.
+.
+Anywhere AT&T
+.I troff \" AT&T
+supports a parameterized escape sequence that uses an opening
+parenthesis \lq(\rq to introduce a two-character argument,
 .I groff
-compared to the classical Unix\~7
-.I troff
-are described in detail.
+supports a square-bracketed form \lq\rq where the argument
+within can be of arbitrary length.
 .
 .
 .\" ====================================================================
-.SS "Long names"
+.SS "Font families, abstract styles, and translation"
 .\" ====================================================================
 .
-The names of number registers, fonts, strings/\:macros/\:diversions,
-special characters (glyphs), and colors can be of any length.
+GNU
+.I troff \" GNU
+can group text typefaces into
+.I families
+containing each of the styles
+.RB \lq R \rq,
+.RB \lq I \rq,
+.RB \lq B \rq,
+and
+.RB \lq BI \rq.
 .
-In escape sequences, additionally to the classical
-\oq\fB(\fP\,\fIxx\/\fP\cq
-construction for a two-character glyph name,
-you can use
-\oq\fB\fP\,\fIxxx\/\fP\fB\fP\cq
-for a name of arbitrary length.
+So that a document need not be coupled to a specific font family,
+an output device can associate a style in the abstract sense with a
+mounting position.
+.
+Thus the default family can be combined with a style dynamically,
+producing a
+.I "resolved font name."
+.
+A document can
+.I translate,
+or remap,
+fonts with the
+.B ftr
+request.
 .
-.TP
-.BI \rs xxx 
-Print the special character (glyph) called
-.IR xxx .
 .
-.TP
-.BI \rs "comp1 comp2 \*ellipsis" 
-Print composite glyph consisting of multiple components.
+.P
+Applying the requests
+.BR cs ,
+.BR bd ,
+.BR tkf ,
+.BR uf ,
+or
+.B \%fspecial
+to an abstract style affects the member of the default family
+corresponding to that style.
 .
-Example: \oq\rsA\~ho\cq is capital letter A with ogonek which
-finally maps to glyph name \oqu0041_0328\cq.
+The default family can be set with the
+.B fam
+request or
+.B \-f
+command-line option.
 .
-See
-.IR "Groff: The GNU Implementation of troff" ,
-the
-.I groff
-Texinfo manual,
-for details of how a glyph name for a composite glyph is constructed,
-and
-.BR groff_char (@MAN7EXT@)
-for a list of glyph name components used in composite glyph names.
+The
+.B styles
+directive in the output device's
+.I DESC
+file controls which mounting positions
+(if any)
+are initially associated with abstract styles rather than fonts,
+and the
+.B sty
+request can update this association.
 .
-.TP
-.BI \rsf xxx 
-Set font
-.IR xxx .
 .
-Additionally,
-.B \rsf
-is a new syntax form equal to
-.BR \rsfP ,
-i.e., to return to the previous font.
+.\" ====================================================================
+.SS Colors
+.\" ====================================================================
 .
-.TP
-.BI \rs* "xxx arg1 arg2 \*ellipsis" 
-Interpolate string
-.IR xxx ,
-taking
-.IR arg1 ,
-.IR arg2 ,
-.IR \*ellipsis ,
-as arguments.
+.I groff
+supports color output with a variety of color spaces and up to 16 bits
+per channel.
 .
-.TP
-.BI \rsn xxx 
-Interpolate number register
-.IR xxx .
+Some devices,
+particularly terminals,
+may be more limited.
+.
+When color support is enabled,
+two colors are current at any given time:
+the
+.I stroke color,
+with which glyphs,
+rules (lines),
+and geometric figures are drawn,
+and the
+.I fill color,
+which paints the interior of filled geometric figures.
+.
+The
+.BR color ,
+.BR \%defcolor ,
+.BR gcolor ,
+and
+.B fcolor
+requests;
+.B \rsm
+and
+.B \rsM
+escape sequences;
+and
+.BR .color ,
+.BR .m ,
+and
+.B .M
+registers exercise color support.
 .
 .
 .\" ====================================================================
-.SS "Fractional point sizes"
+.SS "Fractional type sizes and new scaling units"
 .\" ====================================================================
 .
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Using Fractional
+.\" Type Sizes".
+AT&T
+.I troff \" AT&T
+interpreted all type size measurements in points.
+.
+Combined with integer arithmetic,
+this design choice made it impossible to support,
+for instance,
+ten and a half-point type.
+.
+In GNU
+.IR troff , \" GNU
+an output device can select a scaling factor that subdivides a point
+into \lqscaled points\rq.
+.
+A type size expressed in scaled points can thus represent a non-integral
+type size.
+.
+.
+.P
 A
 .I scaled point
 is equal to
-.B 1/sizescale
-points, where
-.B sizescale
-is specified in the
-.I DESC
-file (1 by default).
-.
-There is a new scale indicator\~\c
-.B z
-that has the effect of multiplying by sizescale.
+.RI 1/ sizescale
+points,
+where
+.I sizescale
+is specified in the device description file,
+.IR DESC ,
+and defaults to\~1;
+see
+.MR groff_font @MAN5EXT@ .
+.
+Requests and escape sequences in GNU
+.I troff \" GNU
+interpret arguments that represent a type size in points,
+which the formatter multiplies by
+.I sizescale
+and converts to an integer.
 .
-Requests and escape sequences in troff interpret arguments that
-represent a point size as being in units of scaled points, but they
-evaluate each such argument using a default scale indicator of\~\c
-.BR z .
-Arguments treated in this way are the argument to the
-.B ps
-request, the third argument to the
+Arguments treated in this way comprise those to the escape sequences
+.B \rsH
+and
+.BR \rss ,
+to the request
+.BR ps ,
+the third argument to the
 .B cs
-request, the second and fourth arguments to the
+request,
+and the second and fourth arguments to the
 .B tkf
-request, the argument to the
-.B \rsH
-escape sequence, and those variants of the
-.B \rss
-escape sequence that take a numeric expression as their argument.
+request.
 .
+Scaled points may be specified explicitly with the
+.B z
+scaling unit.
 .
-.P
-For example, suppose sizescale is 1000; then a scaled point is
-equivalent to a millipoint; the call
-.B .ps\ 10.25
-is equivalent to
-.B .ps\ 10.25z
-and so sets the point size to 10250 scaled points, which is equal to
-10.25 points.
+In GNU
+.IR troff , \" GNU
+the register
+.B \rsn.s
+can interpolate a non-integral type size.
+.
+The register
+.B \rsn.ps
+interpolates the type size in scaled points.
 .
 .
 .P
-The number register
-.B \rsn.s
-returns the point size in points as decimal fraction.
+For example,
+if
+.I sizescale
+is\~1000,
+then a scaled point is one thousandth of a point.
 .
-There is also a new number register
-.B \rsn.ps
-that returns the point size in scaled points.
+Consequently,
+.RB \lq ".ps 10.5" \rq
+is synonymous with
+.RB \lq ".ps 10.5z" \rq;
+both set the type size to 10,500\~scaled points,
+or 10.5\~points.
 .
 .
 .P
-It would make no sense to use the
-.BR z \~\c
-scale indicator in a numeric expression whose default scale indicator
-was neither
-.B u
-nor\~\c
-.BR z ,
-and so
-.B troff
+It makes no sense to use the
+.RB \lq z \rq\~scaling
+unit in a numeric expression whose default scaling unit is neither
+.RB \lq u \rq
+.RB nor\~\lq z \rq,
+so GNU
+.I troff \" GNU
 disallows this.
 .
-Similarly it would make no sense to use a scaling indicator other than
-.B z
-or\~\c
-.B u
-in a numeric expression whose default scale indicator was\~\c
-.BR z ,
-and so
-.B troff
+Similarly,
+it is nonsensical to use a scaling unit other
+.RB than\~\lq z \rq
+.RB or\~\lq u \rq
+in a numeric expression whose default scaling unit
+.RB is\~\lq z \rq,
+so GNU
+.I troff
 disallows this as well.
 .
+.
+.br
+.ne 2v
 .P
-There is also new scale indicator\~\c
-.B s
-which multiplies by the number of units in a scaled point.
+Another new scaling unit,
+.RB \lq s \rq,
+multiplies by the number of basic units in a scaled point.
 .
-So, for example,
-.B \rsn.pss
+Thus,
+.RB \lq\^ \rsn.pss \rq
 is equal to
-.BR 1m .
-Be sure not to confuse the
-.B s
+.RB \lq 1m \rq
+by definition.
+.
+Do not confuse the
+.RB \lq s \rq
 and
-.BR z \~\c
-scale indicators.
+.RB \lq z \rq
+scaling units.
 .
 .
-.\" ====================================================================
-.SS "Numeric expressions"
-.\" ====================================================================
+.br
+.ne 2v
+.P
+Output devices may be limited in the type sizes they can employ.
+.
+The
+.B .s
+and
+.B .ps
+registers represent the type size as selected by the output driver as it
+understands a device's capability.
+.
+The last
+.I requested
+type size is interpolated in scaled points by the read-only register
+.B .psr
+and in points as a decimal fraction by the read-only string-valued
+register
+.BR .sr .
+.
+Both are associated with the environment.
 .
-Spaces are permitted in a number expression within parentheses.
+For example,
+if a type size of 10.95\~points is requested,
+and the nearest size permitted by a
+.B sizes
+request
+(or by the
+.B sizes
+or
+.B \%sizescale
+directives in the device's
+.I DESC
+file)
+is 11\~points,
+the output driver uses the latter value.
+.\" END Keep (roughly) parallel with groff.texi node "Using Fractional
+.\" Type Sizes".
 .
 .
 .P
-.B M
-indicates a scale of 100ths of an em.
-.B f
-indicates a scale of 65536 units, providing fractions for color
-definitions with the
-.B defcolor
+A further two new measurement units available in
+.I groff
+are
+.RB \lq M \rq,
+which indicates hundredths of an em,
+and
+.RB \lq f \^\rq,
+which multiplies by 65,536.
+.
+The latter provides convenient fractions for color definitions with the
+.B \%defcolor
 request.
 .
-For example, 0.5f = 32768u.
+For example,
+0.5f equals 32768u.
+.
+.
+.\" ====================================================================
+.SS "Numeric expressions"
+.\" ====================================================================
+.
+GNU
+.I troff \" GNU
+permits spaces in a numeric expression within parentheses,
+and offers three new operators.
+.
 .
 .TP
 .IB e1 >? e2
-The maximum of
+Interpolate the greater of
 .I e1
 and
 .IR e2 .
 .
+.
 .TP
 .IB e1 <? e2
-The minimum of
+Interpolate the lesser of
 .I e1
 and
 .IR e2 .
 .
+.
 .TP
 .BI ( c ; e )
 Evaluate
 .I e
 using
 .I c
-as the default scaling indicator.
-.
-If
+as the default scaling unit,
+ignoring scaling units in
+.I e
+if
 .I c
-is missing, ignore scaling indicators in the evaluation of\~\c
-.IR e .
+is empty.
 .
 .
 .\" ====================================================================
-.SS "New escape sequences"
+.SS "Conditional expressions"
 .\" ====================================================================
 .
+More conditions can be tested with the
+.RB \lq\| if \|\rq
+and
+.B ie
+requests,
+as well as the new
+.RB \lq while \rq
+request.
+.
+.
 .TP
-.BI \rsA' anything '
-This expands to
-.B 1
-or\~\c
-.BR 0 ,
-depending on whether
-.I anything
-is or is not acceptable as the name of a string, macro, diversion,
-number register, environment, font, or color.
+.BI c\~ chr
+True if a character
+.I chr
+is available,
+where
+.I chr
+is an ordinary character
+(Unicode basic Latin excluding control characters and the space),
+a special character,
+or
+.BI \rsN\aq index\c
+.BR \aq .
 .
-It returns\~\c
-.B 0
-if
-.I anything
-is empty.
 .
-This is useful if you want to look up user input in some sort of
-associative table.
+.TP
+.BI d\~ nam
+True if a string,
+macro,
+diversion,
+or request
+.I nam
+is defined.
+.
+.
+.TP
+.BI F\~ fnt
+True if a font
+.I fnt
+is available;
+.I fnt
+can be an abstract style
+or a font name.
+.
+.I fnt
+is handled as if it
+were accessed with the
+.B ft
+request
+(that is,
+abstract styles and font translation are applied),
+but
+.I fnt
+cannot be a mounting position,
+and no font is mounted.
+.
+.
+.TP
+.BI m\~ col
+True if a color
+.I col
+is defined.
+.
+.
+.TP
+.BI r\~ reg
+True if a register
+.I reg
+is defined.
+.
 .
 .TP
-.BI \rsB' anything '
-This expands to
-.B 1
-or\~\c
-.BR 0 ,
-depending on whether
+.BI S\~ sty
+True if a style
+.I sty
+is registered.
+.
+Font translation applies.
+.
+.
+.TP
+.B v
+Always false.
+.
+This condition is for compatibility with certain other
+.I troff
+implementations only.
+.
+(This refers to
+.IR vtroff ,
+a translator that would convert the C/A/T output from early-vintage AT&T
+.I troff \" AT&T
+to a form suitable for Versatec and Benson-Varian plotters.)
+.
+.
+.\" ====================================================================
+.SS "Drawing commands"
+.\" ====================================================================
+.
+GNU
+.I troff \" GNU
+offers drawing commands to create filled
+circles and ellipses,
+and polygons.
+.\" CSTR #54 did not countenance polygons, but DWB 3.3 had outlined ones
+.\" as \D'p' as we do.  Filled polygons appear to be a GNU innovation.
+.
+Stroked (outlined) objects are drawn with the stroke color and
+filled (solid) ones shaded with the fill color.
+.
+These are independent properties;
+if you want a filled,
+stroked figure,
+you must draw the same figure twice using each drawing command.
+.
+A filled figure is always smaller than a stroked one because the former
+is drawn only within its defined area,
+whereas strokes have a line thickness
+(set with another new drawing command,
+.BR \rsD\aqt\aq ).
+.
+.
+.\" ====================================================================
+.SS "Escape sequences"
+.\" ====================================================================
+.
+.\" TODO: Some of the synopses here and in "New requests" get pretty
+.\" discursive.  It would be better to lift the introduction of new
+.\" concepts in groff programming to new subsections above.  Examples
+.\" include: string parameterization, user-definable characters,
+.\" character properties (cflags), character classes; the hyphenation
+.\" language, code, and pattern file system; file stream manipulation...
+.\"
+.\" _Maybe_ output suppression.  It's a big enough concept, but only
+.\" well understood by retired contributors, only used by the grohtml
+.\" output driver (still beta after 20 years), and we have some Savannah
+.\" tickets that point the way to radically simplifying its design,
+.\" eliminating its need to groff before you groff.
+.I groff
+introduces several new escape sequences
+and extends the syntax of a few AT&T
+.I troff \" AT&T
+escape sequences
+(namely,
+.BR \rsD ,
+.BR \rsf ,
+.BR \rsk ,
+.BR \rsn ,
+.BR \rss ,
+.BR \rs$ ,
+and
+.BR \rs* ).
+.
+In the following list,
+escape sequences are collated alphabetically at first,
+and then by symbol roughly in Unicode code point order.
+.\" Exceptions are made to group closely-related escape sequences in an
+.\" order more agreeable to the development of a topic.
+.
+.
+.TP 7.5 \" sinfully obtain better pagination on typesetters
+.BI \rsA\aq anything \aq
+Interpolate 1 if
 .I anything
-is or is not a valid numeric expression.
+is a valid identifier,
+and\~0 otherwise.
 .
-It returns\~\c
-.B 0
-if
+Because invalid input characters are removed,
+invalid identifiers are empty or contain spaces,
+tabs,
+or newlines.
+.
+You can employ
+.B \rsA
+to validate a macro argument before using it to construct another escape
+sequence or identifier.
+.
+.TP
+.BI \rsB\aq anything \aq
+Interpolate 1 if
 .I anything
-is empty.
+is a valid numeric expression,
+and\~0 otherwise.
+.
+You might use
+.B \rsB
+along with the
+.RB \lq\| if \|\rq
+request to filter out invalid macro arguments.
+.
 .
 .TP
-.BI \rsC' xxx '
-Typeset glyph named
-.IR xxx .
-Normally it is more convenient to use
-.BI \rs xxx \fR.
-But
-.B \rsC
-has the advantage that it is compatible with recent versions of Unix and
-is available in compatibility mode.
+.BI \rsD\aqC\~ "d" \aq
+Draw filled circle of diameter
+.I d
+with its leftmost point at the drawing position.
+.
 .
 .TP
-.B \rsE
-This is equivalent to an escape character, but it is not interpreted in
-copy mode.
+.BI \rsD\aqE\~ "h v" \aq
+Draw filled ellipse with
+.I h
+and
+.I v
+as the axes and the leftmost point at the drawing position.
 .
-For example, strings to start and end superscripting could be defined
-like this
 .
-.RS
-.IP
-.EX
-\&.ds { \rsv'\-.3m'\rss'\rsEn.s*6u/10u'
-\&.ds } \rss0\rsv'.3m'
-.EE
-.RE
+.TP
+.BI \rsD\aqp\~ "h1 v1"\~\c
+.RI .\|.\|.\~ "hn vn"\c
+.B \aq
+Draw polygon with vertices at drawing position and each point
+in sequence.
 .
-.IP
-The use of
+GNU
+.I troff \" GNU
+closes the polygon by drawing a line from
+.RI ( hn ,\~ vn )
+back to the initial drawing position;
+DWB and Heirloom
+.IR troff s \" DWB, Heirloom
+do not.
+.
+.\" XXX: This would be the "STUPID_DRAWING_POSITIONING" complained of in
+.\" src/libs/libdriver/input.cpp.  It is neither the rightmost point
+.\" of the figure nor the initial drawing position that GNU troff
+.\" automatically returned to to close the figure.
+Afterward,
+the drawing position is left at
+.RI ( hn ,\~ vn ).
+.
+.
+.TP
+.BI \rsD\aqP\~ "h1 v1"\~\c
+.RI .\|.\|.\~ "hn vn"\c
+.B \aq
+As
+.BR \rsD\aqp\aq ,
+but the polygon is filled.
+.
+.
+.TP
+.BI \rsD\aqt\~ "n" \aq
+Set line thickness of geometric objects to
+.RI to\~ n
+basic units.
+.
+A zero
+.I n
+selects the minimal supported thickness.
+.
+A negative
+.I n
+selects a thickness proportional to the type size;
+this is the default.
+.
+.
+.TP
 .B \rsE
-ensures that these definitions work even if
-.B \rs*{
-gets interpreted in copy mode (for example, by being used in a macro
-argument).
-.RE
+Embed an escape character that is not interpreted in copy mode
+(compare with
+.B \rsa
+and
+.BR \rst ).
+.
+You can use it to ease the writing of nested macro definitions.
+.
+It is also convenient to define strings containing escape sequences that
+need to work when used in copy mode
+(for example,
+as macro arguments),
+or which will be interpolated at varying macro nesting depths.
+.
+.
+.TP
+.BI \rsf font 
+Select
+.IR font ,
+which may be a mounting position,
+abstract style,
+or font name,
+to choose the typeface.
+.
+.B \rsf
+and
+.B \rsfP
+are synonyms;
+we recommend the former.
+.
 .
 .TP
 .BI \rsF f
 .TQ
 .BI \rsF( fm
 .TQ
-.BI \rsF fam 
-Change font family.
-.
-This is the same as the
-.B fam
-request.
+.BI \rsF family 
+Select default font family.
 .
 .B \rsF
-switches back to the previous font family (note that
+makes the previous font family the default.
+.
 .B \rsFP
-won't work; it selects font family \oqP\cq instead).
+is unlike
+.BR \rsfP ;
+it selects font family \lqP\rq as the default.
+.
+See the
+.B fam
+request below.
+.
 .
 .TP
-.BI \rsm x
-.TQ
-.BI \rsm( xx
+.BI \rsk( rg
 .TQ
-.BI \rsm xxx 
-Set drawing color.
-.B \rsm
-switches back to the previous color.
+.BI \rsk reg 
+Mark horizontal drawing position in
+two-character register
+.RI name\~ rg
+or arbitrary register
+.RI name\~ reg .
+.
 .
 .TP
-.BI \rsM x
+.BI \rsm c
 .TQ
-.BI \rsM( xx
+.BI \rsm( cl
 .TQ
-.BI \rsM xxx 
-Set background color for filled objects drawn with the
-.BI \rsD' \*ellipsis '
-commands.
-.B \rsM
-switches back to the previous color.
+.BI \rsm col 
+Set the stroke color.
 .
-.TP
-.BI \rsN' n '
-Typeset the glyph with index\~\c
-.I n
-in the current font.
-.IR n \~\c
-can be any integer.
+.B \rsm
+restores the previous stroke color,
+or the default if there is none.
 .
-Most devices only have glyphs with indices between 0 and 255.
 .
-If the current font does not contain a glyph with that code,
-special fonts are
-.I not
-searched.
+.TP
+.BI \rsM c
+.TQ
+.BI \rsM( cl
+.TQ
+.BI \rsM col 
+Set the fill color.
 .
-The
-.B \rsN
-escape sequence can be conveniently used in conjunction with the
-.B char
-request, for example
+.B \rsM
+restores the previous fill color,
+or the default if there is none.
 .
-.RS
-.IP
-.EX
-\&.char \rsphone \rsf(ZD\rsN'37'
-.EE
-.RE
 .
-.IP
-The index of each glyph is given in the fourth column in the font
-description file after the
-.B charset
-command.
+.TP
+.BI \rsn reg 
+Interpolate register
+.IR reg .
 .
-It is possible to include unnamed glyphs in the font description
-file by using a name of
-.BR \-\-\- ;
-the
-.B \rsN
-escape sequence is the only way to use these.
 .
 .TP
 .BI \rsO n
 .TQ
 .BI \rsO n 
-Suppress troff output.
+Suppress
+.I @g@troff
+output of glyphs and geometric objects.
 .
-The escapes
+The sequences
 .BR \rsO2 ,
 .BR \rsO3 ,
 .BR \rsO4 ,
 and
 .B \rsO5
 are intended for internal use by
-.BR \%grohtml .
+.MR grohtml @MAN1EXT@ .
+.
 .
 .RS
 .TP
 .B \rsO0
-Disable any ditroff glyphs from being emitted to the device driver,
-provided that the escape occurs at the outer level (see
+.TQ
+.B \rsO1
+Disable and enable,
+respectively,
+the emission of glyphs and geometric objects to the output driver,
+provided that this sequence occurs at the outermost suppression level
+(see
 .B \rsO3
 and
 .BR \rsO4 ).
 .
-.TP
-.B \rsO1
-Enable output of glyphs, provided that the escape occurs at the outer
-level.
-.IP
-.B \rsO0
-and
-.B \rsO1
-also reset the registers
-.BR \rsnopminx ,
-.BR \rsnopminy ,
-.BR \rsnopmaxx ,
+Horizontal motions corresponding to non-overstruck glyph widths still
+occur.
+.
+These sequences also reset the registers
+.BR opminx ,
+.BR opminy ,
+.BR opmaxx ,
 and
-.B \rsnopmaxy
+.B opmaxy
 to\~\-1.
 .
-These four registers mark the top left and bottom right hand corners
-of a box which encompasses all written glyphs.
+These four registers mark the top left and bottom right hand corners of
+a box encompassing all written or drawn output.
+.
 .
 .TP
 .B \rsO2
-Provided that the escape occurs at the outer level, enable output of
-glyphs and also write out to stderr the page number and four registers
-encompassing the glyphs previously written since the last call to
-.BR \rsO .
+At the outermost suppression level,
+enable emission of glyphs and geometric objects,
+and write to the standard error stream the page number and values of the
+four aforementioned registers encompassing glyphs written since the last
+interpolation of a
+.B \rsO
+sequence,
+as well as the page offset,
+line length,
+image file name
+(if any),
+horizontal and vertical device motion quanta,
+and input file name.
+.
+Numeric values are in basic units.
+.
 .
 .TP
 .B \rsO3
-Begin a nesting level.
+.TQ
+.B \rsO4
+Begin and end a nested suppression level,
+respectively.
 .
-At start-up,
-.B troff
-is at outer level.
-.
-This is really an internal mechanism for
-.B \%grohtml
-while producing images.
-.
-They are generated by running the troff source through
-.B troff
-to the PostScript device and
-.B ghostscript
-to produce images in PNG format.
+.I \%grohtml
+uses this mechanism to create images of output preprocessed with
+.IR @g@pic ,
+.IR @g@eqn ,
+and
+.IR @g@tbl .
 .
-The
-.B \rsO3
-escape starts a new page if the device is not html (to reduce the
-possibility of images crossing a page boundary).
+At startup,
+.I @g@troff
+is at the outermost suppression level.
 .
-.TP
-.B \rsO4
-End a nesting level.
+.I \%pre\-grohtml
+generates these sequences when processing the document,
+using
+.I @g@troff
+with the
+.B ps
+output device,
+Ghostscript,
+and the PNM tools to produce images in PNG format.
 .
-.TP
-.BI \rsO5 Pfilename 
-This escape is
-.B \%grohtml
-specific.
+These sequences start a new page if the device is not
+.B html
+or
+.BR xhtml ,
+to reduce the number of images crossing a page boundary.
 .
-Provided that this escape occurs at the outer nesting level, write
-.I filename
-to stderr.
 .
-The position of the image,
+.TP
+.BI \rsO5 Pfile 
+At the outermost suppression level,
+write the name
+.I file
+to the standard error stream at position
 .IR P ,
-must be specified and must be one of
+which must be one of
 .BR l ,
 .BR r ,
 .BR c ,
 or
-.B i
-(left, right, centered, inline).
+.BR i ,
+corresponding to
+left,
+right,
+centered,
+and inline alignments within the document,
+respectively.
 .
-.I filename
-is associated with the production of the next inline image.
+.I file
+is is a name associated with the production of the next image.
 .RE
 .
-.TP
-.BI \rsR' name\ \+-n '
-This has the same effect as
-.
-.RS
-.IP
-.BI .nr\  name\ \+-n
-.RE
 .
 .TP
-.BI \rss( nn
-.TQ
-.BI \rss\+-( nn
-Set the point size to
-.I nn
-points;
-.I nn
-must be exactly two digits.
+.BI \rsR\aq name\~\+-n \aq
+Synonymous with
+.RB \lq .nr
+.IR name\~\+-n \rq.
+.
 .
 .TP
-.BI \rss\+- n 
+.BI \rss \+-n 
 .TQ
-.BI \rss\+- n 
+.BI \rss \+-  n 
 .TQ
-.BI \rss'\+- n '
+.BI \rss\aq \+-n \aq
 .TQ
-.BI \rss\+-' n '
-Set the point size to
+.BI \rss \+- \aq n \aq
+Set the type size to,
+or increment or decrement it by,
 .I n
-scaled points;
-.I n
-is a numeric expression with a default scale indicator of\~\c
-.BR z .
+scaled points.
 .
+.
+.br
+.ne 5v
 .TP
-.BI \rsV x
+.BI \rsV e
 .TQ
-.BI \rsV( xx
+.BI \rsV( ev
 .TQ
-.BI \rsV xxx 
-Interpolate the contents of the environment variable
-.IR xxx ,
+.BI \rsV env 
+Interpolate contents of the environment variable
+.IR env ,
 as returned by
-.BR getenv (3).
+.MR getenv 3 .
+.
 .B \rsV
-is interpreted in copy mode.
+is interpreted even in copy mode.
+.
+.
+.TP
+.BI \rsX\aq anything \aq
+Within
+.B \rsX
+arguments,
+the escape sequences
+.BR \rs& ,
+.BR \rs) ,
+.BR \rs% ,
+and
+.B \rs:
+are ignored;
+.BI \rs space
+and
+.B \rs\ti
+are converted to single space characters;
+and
+.B \rs\rs
+is reduced to
+.BR \rs .
+.
+So that the basic Latin subset of the Unicode character set
+(that is,
+ISO\~646:1991-IRV or,
+popularly,
+\lqUS-ASCII\rq)
+can be reliably encoded in
+.I anything,
+the special character escape sequences
+.BR \rs\- ,
+.BR \rsaq ,
+.BR \rsdq ,
+.BR \rsga ,
+.BR \rsha ,
+.BR \rsrs ,
+and
+.B \rsti
+are mapped to basic Latin characters;
+see
+.MR groff_char @MAN7EXT@ .
+.
+For this transformation,
+character translations and definitions are ignored.
+.
+Other escape sequences are not supported.
+.
+.
+.IP
+If the
+.B \%use_charnames_in_special
+directive appears in the output device's
+.I DESC
+file,
+the use of special character escape sequences is
+.I not
+an error;
+they are simply output verbatim
+(with the exception of the seven mapped to Unicode basic Latin
+characters,
+discussed above).
+.
+.B \%use_charnames_in_special
+is currently employed only by
+.MR grohtml @MAN1EXT@ .
+.
 .
 .TP
-.BI \rsY x
+.BI \rsY m
 .TQ
-.BI \rsY( xx
+.BI \rsY( ma
 .TQ
-.BI \rsY xxx 
-This is approximately equivalent to
-.BI \rsX'\rs* xxx '\fR.
-However the contents of the string or macro
-.I xxx
-are not interpreted; also it is permitted for
-.I xxx
-to have been defined as a macro and thus contain newlines (it is not
-permitted for the argument to
+.BI \rsY mac 
+Interpolate a macro as a device control command.
+.
+This is similar to
+.BI \rsX\aq\rs* mac \aq\fR,
+except the contents of
+.I mac
+are not interpreted,
+and
+.I mac
+can be a macro and thus contain newlines,
+whereas the argument to
 .B \rsX
-to contain newlines).
+cannot.
+.
+This inclusion of newlines requires an extension to the AT&T
+.I troff \" AT&T
+output format,
+and will confuse postprocessors that do not know about it.
 .
-The inclusion of newlines requires an extension to the Unix troff output
-format, and confuses drivers that do not know about this extension.
 .
 .TP
-.BI \rsZ' anything '
-Print anything and then restore the horizontal and vertical position;
-.I anything
-may not contain tabs or leaders.
+.BI \rsZ\aq anything \aq
+Save the drawing position,
+format
+.IR anything ,
+then restore it.
+.
+Tabs and leaders in the argument are ignored with an error diagnostic.
+.
 .
 .TP
+.B \rs#
+Everything up to and including the next newline is ignored.
+.
+This escape sequence is interpreted even in copy mode.
+.
+.B \rs#
+is like
+.BR \rs" ,
+except that
+.B \rs"
+does not ignore a newline;
+the latter therefore cannot be used by itself for a whole-line
+comment\emit leaves a blank line on the input stream.
+.
+.
+.\" Keep \$0 before \$( in spite of collation.
+.TP
 .B \rs$0
-The name by which the current macro was invoked.
+Interpolate the name by which the macro being interpreted was called.
 .
-The
+In GNU
+.I troff \" GNU
+this name can vary;
+see the
 .B als
-request can make a macro have more than one name.
+request.
+.
+.
+.TP
+.BI \rs$( nn
+.TQ
+.BI \rs$ nnn 
+In a macro or string definition,
+interpolate
+the
+.IR nn th
+or
+.IR nnn th
+argument.
+.
+Macros and strings can have an unlimited number of arguments.
+.
 .
 .TP
 .B \rs$*
-In a macro or string, the concatenation of all the arguments separated
-by spaces.
+In a macro or string definition,
+interpolate the catenation of all arguments,
+separated by spaces.
+.
 .
 .TP
 .B \rs$@
-In a macro or string, the concatenation of all the arguments with each
-surrounded by double quotes, and separated by spaces.
+In a macro or string definition,
+interpolate the catenation of all arguments,
+with each surrounded by double quotes and separated by spaces.
+.
 .
 .TP
-.B \rs$^
-In a macro, the representation of all parameters as if they were an
-argument to the
+.B \rs$\ha
+In a macro or string definition,
+interpolate the catenation of all arguments
+constructed in a form suitable for passage to the
 .B ds
 request.
 .
+.
 .TP
-.BI \rs$( nn
-.TQ
-.BI \rs$ nnn 
-In a macro or string, this gives the
-.IR nn -th
-or
-.IR nnn -th
-argument.
+.B \rs)
+Interpolate a
+.I transparent
+dummy character\emone that is ignored by end-of-sentence detection.
+.
+It behaves as
+.BR \rs& ,
+except that
+.B \rs&
+is treated as letters and numerals normally are after
+\lq.\rq,
+\lq?\rq,
+and
+\lq!\rq;
+.B \rs&
+cancels end-of-sentence detection,
+and
+.B \rs)
+does not.
+.
+.
+.TP
+.BI \rs* "string\~\c
+.RI  arg \~.\|.\|.\c
+.B 
+Interpolate
+.I string,
+passing it
+.I arg
+\&.\|.\|.\&
+as arguments.
+.
+.
+.\" Keep \/ before \, in spite of collation.
+.TP
+.B \rs/
+Apply an
+.IR "italic correction" :
+modify the spacing of the preceding glyph so that the distance between
+it and the following glyph is correct if the latter is of upright shape.
+.
+For example,
+if an italic\~\lqf\^\rq is followed immediately by a roman right
+parenthesis,
+then in many fonts the top right portion of the\~\lqf\^\rq overlaps
+the top left of the right parenthesis,
+.if t producing \fIf\fR),
+which is ugly.
+.
+Inserting
+.B \rs\^/
+between them
+.if t \{\
+.  nop produces
+.  ie \n(.g \fIf\/\fR)
+.  el       \fIf\|\fR)
+.  nop and
+.\}
+avoids this problem.
+.
+Use this escape sequence whenever an oblique glyph is immediately
+followed by an upright glyph without any intervening space.
+.
+.
+.TP
+.B \rs,
+Apply a
+.IR "left italic correction" :
+modify the spacing of the following glyph so that the distance between
+it and the preceding glyph is correct if the latter is of upright shape.
+.
+For example,
+if a roman left parenthesis is immediately followed by an
+italic\~\lqf\^\rq,
+then in many fonts the bottom left portion of the\~\lqf\^\rq
+overlaps the bottom of the left parenthesis,
+.if t producing \fR(\fIf\fR,
+which is ugly.
+.
+Inserting
+.B \rs,
+between them
+.if t \{\
+.  nop produces
+.  ie \n(.g \fR(\,\fIf\fR
+.  el       \fR(\^\fIf\fR
+.  nop and
+.\}
+avoids this problem.
+.
+Use this escape sequence whenever an upright glyph is followed
+immediately by an oblique glyph without any intervening space.
+.
+.
+.TP
+.B \rs:
+Insert a non-printing break point.
+.
+That is,
+a word can break there,
+but the soft hyphen character does not mark the break point if it does
+(in contrast to
+.RB \lq\^ \rs% \rq).
+.
+This escape sequence is an input word boundary,
+so the remainder of the word is subject to hyphenation as normal.
 .
-Macros and strings can have an unlimited number of arguments.
 .
 .TP
 .BI \rs? anything \rs?
-When used in a diversion, this transparently embeds
+When used in a diversion,
+this transparently embeds
 .I anything
 in the diversion.
 .I anything
@@ -672,17 +1280,19 @@
 .I anything
 is interpreted.
 .I anything
-may not contain newlines; use
+may not contain newlines;
+use
 .B \rs!\&
 if you want to embed newlines in a diversion.
 .
 The escape sequence
 .B \rs?\&
-is also recognized in copy mode and turned into a single internal
-code; it is this code that terminates
+is also recognized in copy mode and becomes an internal code;
+it is this code that terminates
 .IR anything .
 Thus
 .
+.
 .RS
 .IP
 .EX
@@ -707,83 +1317,72 @@
 .EE
 .RE
 .
+.
 .IP
 prints\~\c
 .BR 4 .
 .
+.
 .TP
-.B \rs/
-This increases the width of the preceding glyph so that the
-spacing between that glyph and the following glyph is
-correct if the following glyph is a roman glyph.
+.BI \rs char 
+Typeset the special character
+.IR char .
 .
-.if t \{\
-.  nop For example, if an italic\~f is immediately followed by a roman
-.  nop right parenthesis, then in many fonts the top right portion of
-.  nop the\~f overlaps the top left of the right parenthesis
-.  nop producing \fIf\fR), which is ugly.
-.  nop Inserting
-.  B \rs/
-.  nop produces
-.  ie \n(.g \fIf\/\fR)
-.  el       \fIf\|\fR)
-.  nop and avoids this problem.
-.\}
-It is a good idea to use this escape sequence whenever an italic
-glyph is immediately followed by a roman glyph without any
-intervening space.
 .
 .TP
-.B \rs,
-This modifies the spacing of the following glyph so that the
-spacing between that glyph and the preceding glyph is
-correct if the preceding glyph is a roman glyph.
+.BI \rs "base-char combining-component\~"\c
+.RB .\|.\|. 
+Typeset a composite glyph consisting of
+.I base-char
+overlaid with one or more
+.IR combining-component s.
 .
-.if t \{\
-.  nop For example, inserting
-.  B \rs,
-.  nop between the parenthesis and the\~f changes
-.  nop \fR(\fIf\fR to
-.  ie \n(.g \fR(\,\fIf\fR.
-.  el       \fR(\^\fIf\fR.
-.\}
-It is a good idea to use this escape sequence whenever a roman
-glyph is immediately followed by an italic glyph without any
-intervening space.
+For example,
+.RB \lq\| \rsA\~ho \^\rq
+is a capital letter \lqA\rq with a \lqhook accent\rq (ogonek).
+.
+See the
+.B \%composite
+request below;
+.IR "Groff: The GNU Implementation of troff" ,
+the
+.I groff
+Texinfo manual,
+for details of composite glyph name construction;
+and
+.MR groff_char @MAN7EXT@
+for a list of components used in composite glyph names.
 .
-.TP
-.B \rs)
-Like
-.B \rs&
-except that it behaves like a character declared with the
-.B cflags
-request to be transparent for the purposes of end-of-sentence
-recognition.
 .
 .TP
 .B \rs\ti
-This produces an unbreakable space that stretches like a normal
-inter-word space when a line is adjusted.
+Insert an unbreakable space that is adjustable like an ordinary space.
 .
-.TP
-.B \rs:
-This causes the insertion of a zero-width break point.
+It is discarded from the end of an output line if a break is forced.
 .
-It is equal to
-.B \rs%
-within a word but without insertion of a soft hyphen glyph.
 .
-.TP
-.B \rs#
-Everything up to and including the next newline is ignored.
+.\" ====================================================================
+.SS "Restricted requests"
+.\" ====================================================================
 .
-This is interpreted in copy mode.
+To mitigate risks from untrusted input documents,
+the
+.B pi
+and
+.B sy
+requests are disabled by default.
 .
-It is like
-.B \rs"
-except that
-.B \rs"
-does not ignore the terminating newline.
+.MR @g@troff @MAN1EXT@ 's
+.B \-U
+option enables the formatter's \lqunsafe mode\rq,
+restoring their function
+(and enabling additional
+.I groff
+extension requests,
+.BR open ,
+.BR opena ,
+and
+.BR pso ).
 .
 .
 .\" ====================================================================
@@ -791,126 +1390,189 @@
 .\" ====================================================================
 .
 .TP
-.BI .aln\  xx\ yy
-Create an alias
-.I xx
-for number register object named
-.IR yy .
-The new name and the old name are exactly equivalent.
+.BI .aln\~ "new old"
+Create alias
+.I new
+for existing register named
+.IR old ,
+causing the names to refer to the same stored value.
 .
 If
-.I yy
-is undefined, a warning of type
-.B reg
-is generated, and the request is ignored.
+.I old
+is undefined,
+a warning in category
+.RB \lq reg \rq
+is generated and the request is ignored.
+.
+To remove a register alias,
+invoke
+.B rr
+on its name.
 .
-.TP
-.BI .als\  xx\ yy
-Create an alias
-.I xx
-for request, string, macro, or diversion object named
-.IR yy .
+A register's contents do not become inaccessible until it has no more
+names.
 .
-The new name and the old name are exactly equivalent (it is
-similar to a hard rather than a soft link).
+.
+.TP
+.BI .als\~ "new old"
+Create alias
+.I new
+for existing request,
+string,
+macro,
+or diversion named
+.IR old ,
+causing the names to refer to the same stored object.
 .
 If
-.I yy
-is undefined, a warning of type
-.B mac
-is generated, and the request is ignored.
+.I old
+is undefined,
+a warning in category
+.RB \lq mac \rq
+is produced,
+and the request is ignored.
 .
 The
+.RB \lq am \rq,
+.RB \lq as \rq,
+.BR da ,
 .BR de ,
-.BR am ,
 .BR di ,
-.BR da ,
-.BR ds ,
 and
-.B as
-requests only create a new object if the name of the macro, diversion
-or string is currently undefined or if it is defined to be a
-request; normally they modify the value of an existing object.
-.
-.TP
-.BI .am1\  xx\ yy
-Similar to
-.BR .am ,
-but compatibility mode is switched off during execution.
-.
-To be more precise, a \oqcompatibility save\cq token is inserted
-at the beginning of the macro addition, and a \oqcompatibility
-restore\cq token at the end.
+.B ds
+requests
+(together with their variants)
+create a new object only if the name of the macro,
+diversion,
+or string is currently undefined
+or if it is defined as a request;
+normally,
+they modify the value of an existing object.
+.
+To remove an alias,
+invoke
+.B rm
+on its name.
+.
+The object itself is not destroyed until it has no more names.
 .
-As a consequence, the requests
-.BR am ,
+.
+.IP
+When a request,
+macro,
+string,
+or diversion is aliased,
+redefinitions and appendments \lqwrite through\rq alias names.
+.
+To replace an alias with a separately defined object,
+you must use the
+.B rm
+request on its name first.
+.
+.
+.TP
+.BI .am1\~ name\~\c
+.RI  end-name 
+As
+.RB \lq am \rq,
+but compatibility mode is disabled while the appendment to
+.I name
+is interpreted:
+a \lqcompatibility save\rq token is inserted at its beginning,
+and a \lqcompatibility restore\rq token at its end.
+.
+As a consequence,
+the requests
+.RB \lq am \rq,
 .BR am1 ,
 .BR de ,
 and
 .B de1
 can be intermixed freely since the compatibility save/\:restore tokens
-only affect the macro parts defined by
-.B .am1
+affect only the parts of the macro populated by
+.B am1
 and
-.BR .ds1 .
+.BR de1 .
+.
 .
 .TP
-.BI .ami\  xx\ yy
+.BI .ami\~ name\~\c
+.RI  end-name 
 Append to macro indirectly.
 .
-See the
+See
 .B dei
-request below for more information.
+below.
 .
-.TP
-.BI .ami1\  xx\ yy
-Same as the
-.B ami
-request but compatibility mode is switched off during execution.
 .
 .TP
-.BI .as1\  xx\ yy
-Similar to
-.BR .as ,
-but compatibility mode is switched off during expansion.
+.BI .ami1\~ name\~\c
+.RI  end-name 
+As
+.BR ami ,
+but compatibility mode is disabled during interpretation of the
+appendment.
 .
-To be more precise, a \oqcompatibility save\cq token is inserted
-at the beginning of the string, and a \oqcompatibility restore\cq
-token at the end.
 .
-As a consequence, the requests
-.BR as ,
+.TP
+.BI .as1\~ name\~\c
+.RI  contents 
+As
+.RB \lq as \rq,
+but compatibility mode is disabled while the appendment to
+.I name
+is interpreted:
+a \lqcompatibility save\rq token is inserted at the beginning of
+.IR contents ,
+and a \lqcompatibility restore\rq token after it.
+.
+As a consequence,
+the requests
+.RB \lq as \rq,
 .BR as1 ,
 .BR ds ,
 and
 .B ds1
 can be intermixed freely since the compatibility save/\:restore tokens
-only affect the (sub)strings defined by
+affect only the portions of the strings populated by
 .B as1
 and
 .BR ds1 .
 .
+.
 .TP
-.BI .asciify\  xx
-This request \oqunformats\cq the diversion
-.I xx
-in such a way that ASCII and space characters (and some escape
-sequences) that were formatted
-and diverted into
-.I xx
+.BI .asciify\~ div
+.I Unformat
+the diversion
+.I div
+in a way such that Unicode basic Latin (ASCII) characters,
+characters translated with the
+.B trin
+request,
+space characters,
+and some escape sequences,
+that were formatted in the diversion
+.I div
 are treated like ordinary input characters when
-.I xx
+.I div
 is reread.
-Useful for diversions in conjunction with the
+.
+Doing so can be useful in conjunction with the
 .B writem
 request.
 .
-It can be also used for gross hacks; for example, this
+.B asciify
+can be also used for gross hacks;
+for example,
+the following sets
+.RB register\~ n
+to\~1.
+.
 .
 .RS
 .IP
 .EX
-.ne 7v+\n(.Vu
+.ne 8v+\n(.Vu
 \&.tr @.
 \&.di x
 \&@nr n 1
@@ -922,877 +1584,1487 @@
 .EE
 .RE
 .
+.
 .IP
-sets register\~\c
-.B n
-to\~1.
+.B asciify
+cannot return all items in a diversion to their source equivalent:
+nodes such as those produced by
+.BR \rsN .\|.\|.\& 
+will remain nodes,
+so the result cannot be guaranteed to be a pure string.
 .
-Note that glyph information (font, font size, etc.) is not preserved;
+See section \lqCopy mode\rq in
+.MR groff @MAN7EXT@ .
+.
+Glyph parameters such as the type face and size are not preserved;
 use
-.B .unformat
-instead.
+.B unformat
+to achieve that.
+.
 .
 .TP
 .B .backtrace
-Print a backtrace of the input stack on stderr.
+Write backtrace of input stack to the standard error stream.
+.
+See the
+.B \-b
+option of
+.MR @g@troff @MAN1EXT@ .
+.
 .
 .TP
-.BI .blm\  xx
-Set the blank line macro to
-.IR xx .
-If there is a blank line macro, it is invoked when a blank line
-is encountered instead of the usual troff behaviour.
+.BR .blm\~ \c
+.IR name 
+Set a blank line macro (trap).
+.
+If a blank line macro is thus defined,
+.I groff
+executes
+.I macro
+when a blank line is encountered in the input file,
+instead of the usual behavior.
+.
+A line consisting only of spaces is also treated as blank and subject to
+this trap.
+.
+If no argument is supplied,
+the default blank line behavior is (re-)established.
+.
 .
 .TP
-.BI .box\  xx
+.BR .box\~ \c
+.IR name 
 .TQ
-.BI .boxa\  xx
-These requests are similar to the
+.BR .boxa\~ \c
+.IR name 
+Divert
+(or append)
+output to
+.I name,
+similarly to the
 .B di
 and
 .B da
-requests with the exception that a partially filled line does not
-become part of the diversion (i.e., the diversion always starts with a
-new line) but is restored after ending the diversion, discarding the
-partially filled line which possibly comes from the diversion.
+requests,
+respectively.
+.
+Any pending output line is
+.I not
+included in the diversion.
+.
+Without an argument,
+stop diverting output;
+any pending output line inside the diversion is discarded.
+.
 .
 .TP
 .B .break
-Break out of a while loop.
+Exit a
+.RB \lq while \rq
+loop.
 .
-See also the
-.B while
-and
-.B continue
-requests.
-.
-Be sure not to confuse this with the
+Do not confuse this request with a typographical break or the
 .B br
 request.
 .
+See
+.RB \lq continue \rq.
+.
+.
 .TP
 .B .brp
-This is the same as
-.BR \rsp .
+Break and adjust line;
+this is the AT&T
+.I troff \" AT&T
+escape sequence
+.B \rsp
+in request form.
+.
 .
 .TP
-.BI .cflags\  "n c1 c2 \*ellipsis"
-Characters
+.BI .cflags\~ "n c1 c2\~"\c
+\&.\|.\|.
+Assign properties encoded by the number
+.I n
+to characters
 .IR c1 ,
 .IR c2 ,
-.IR \*ellipsis ,
-have properties determined by
-.IR n ,
-which is ORed from the following:
+and so on.
+.
+Ordinary and special characters have certain associated properties.
+.
+(Glyphs don't:
+to GNU
+.IR troff , \" GNU
+like AT&T device-independent
+.IR troff , \" AT&T
+a glyph is an identifier corresponding to a rectangle with some metrics;
+see
+.MR groff_font @MAN5EXT@ .)
+.
+The first argument is the sum of the desired flags and the remaining
+arguments are the characters to be assigned those properties.
+.
+Spaces between the
+.I cn
+arguments are optional.
+.
+Any argument
+.I cn
+can be a character class defined with the
+.B class
+request rather than an individual character.
+.
+.
+.IP
+The non-negative integer
+.I n
+is the sum of any of the following.
+.
+Some combinations are nonsensical,
+such as
+.RB \lq 33 \rq
+(1 + 32).
+.
 .
 .RS
 .IP 1
-The character ends sentences (initially characters
-.B .?!\&
-have this property).
+Recognize the character as ending a sentence if followed by a newline
+or two spaces.
+.
+Initially,
+characters
+.RB \lq .?! \rq
+have this property.
+.
 .
 .IP 2
-Lines can be broken before the character (initially no characters have
-this property); a line is not broken at a character with this property
-unless the characters on each side both have non-zero hyphenation
-codes.
-This can be overridden with value 64.
+Enable breaks before the character.
+.
+A line is not broken at a character with this property unless the
+characters on each side both have non-zero hyphenation codes.
+.
+This exception can be overridden by adding 64.
+.
+Initially,
+no characters have this property.
+.
 .
 .IP 4
-Lines can be broken after the character (initially characters
-.B \-\rshy\rsem
-have this property); a line is not broken at a character with this
-property unless the characters on each side both have non-zero
-hyphenation codes.
-This can be overridden with value 64.
+Enable breaks after the character.
+.
+A line is not broken at a character with this property unless the
+characters on each side both have non-zero hyphenation codes.
+.
+This exception can be overridden by adding 64.
+.
+Initially,
+characters
+.RB \lq \-\rshy\rsem \^\rq
+have this property.
+.
 .
 .IP 8
-The glyph associated with this character overlaps horizontally
-(initially characters
-.B \rsul\rsrn\rsru\rsradicalex\rssqrtex
-have this property).
+Mark the glyph associated with this character as overlapping other
+instances of itself horizontally.
+.
+Initially,
+characters
+.RB \lq\^ \rsul\rsrn\rsru\rsradicalex\rssqrtex\
+\& \^\rq
+have this property.
+.
 .
 .IP 16
-The glyph associated with this character overlaps vertically
-(initially glyph
-.B \rsbr
-has this property).
+Mark the glyph associated with this character as overlapping other
+instances of itself vertically.
+.
+Initially,
+the character
+.RB \lq\^ \rsbr \^\rq
+has this property.
+.
 .
 .IP 32
-An end-of-sentence character followed by any number of characters with
+Mark the character as transparent for the purpose of end-of-sentence
+recognition.
+.
+In other words,
+an end-of-sentence character followed by any number of characters with
 this property is treated as the end of a sentence if followed by a
-newline or two spaces; in other words the character is transparent for
-the purposes of end-of-sentence recognition; this is the same as having
-a zero space factor in \*tx (initially characters
-.B \dq')*\rsdg\rsrq\rscq
-have this property).
+newline or two spaces.
+.
+This is the same as having a zero space factor in \*tx.
+.
+Initially,
+characters
+.\" The following is ordered with the apostrophe and (single) closing
+.\" quote on the ends so they are more easily visually distinguished
+.\" from the double quotation marks in roman.
+.RB \lq\| \aq\|"\|)*\rsdg\rsdd\rsrq\rs\^cq \|\rq
+have this property.
+.
 .
 .IP 64
-Ignore hyphenation code values of the surrounding characters.
-Use this in combination with values 2 and\~4 (initially no characters
-have this property).
+Ignore hyphenation codes of the surrounding characters.
+.
+Use this value in combination with values 2 and\~4.
+.
+Initially,
+no characters have this property.
+.
+.
+.IP
+For example,
+if you need an automatic break point after
+the en-dash in numeric ranges like \lq3000\en5000\rq,
+insert
+.RS
+.RS
+.EX
+\&.cflags 68 \rsen
+.EE
+.RE
+into your document.
+.
+However,
+this can lead to bad layout if done without thinking;
+in most situations,
+a better solution than
+changing the
+.B cflags
+value is inserting
+.RB \lq \rs: \rq
+right after the hyphen at the places that really need a break point.
+.RE
+.
+.
+.P
+The remaining values were implemented for East Asian language support;
+those who use alphabetic scripts exclusively can disregard them.
+.
 .
 .IP 128
-Prohibit a line break before the character, but allow a line break after
-the character.
-This works only in combination with flags 256 and 512 and has no effect
+Prohibit a break before the character,
+but allow a break after the character.
+.
+This works only in combination with values 256 and 512 and has no effect
 otherwise.
 .
+Initially,
+no characters have this property.
+.
+.
 .IP 256
-Prohibit a line break after the character, but allow a line break before
-the character.
-This works only in combination with flags 128 and 512 and has no effect
+Prohibit a break after the character,
+but allow a break before the character.
+.
+This works only in combination with values 128 and 512 and has no effect
 otherwise.
 .
+Initially,
+no characters have this property.
+.
+.
 .IP 512
-Allow line break before or after the character.
-This works only in combination with flags 128 and 256 and has no effect
+Allow a break before or after the character.
+.
+This works only in combination with values 128 and 256 and has no effect
 otherwise.
+.
+Initially,
+no characters have this property.
 .RE
 .
+.
 .IP
-Contrary to flag values 2 and\~4, the flags 128, 256, and 512 work
+In contrast to values 2 and\~4,
+the values 128,
+256,
+and 512 work
 pairwise.
 .
-If, for example, the left character has value 512, and the right
-character 128, no line break gets inserted.
+If,
+for example,
+the left character has value 512,
+and the right character 128,
+no break will be automatically inserted between them.
+.
+If we use value\~6 instead for the left character,
+a break after the character can't be suppressed since the neighboring
+character on the right doesn't get examined.
 .
-If we use value\~6 instead for the left character, a line break after
-the character can't be suppressed since the right neighbour character
-doesn't get examined.
 .
 .TP
-.BI .char\  c\ string
-This request can both define characters and glyphs.
-.
-.IP
-Define entity\~\c
-.I c
-to be
-.IR string .
+.BI .char\~ "c contents"
+Define the ordinary or special
+.RI character\~ c
+as
+.IR contents ,
+which can be empty.
 .
-To be more precise, define (or even override) a groff entity which
-can be accessed with name\~\c
-.I c
-on the input side, and which uses
-.I string
-on the output side.
+More precisely,
+.B char
+defines a
+.I groff
+object
+(or redefines an existing one)
+that is accessed with the
+.RI name\~ c
+on input,
+and produces
+.I contents
+on output.
 .
-Every time glyph\~\c
+Every time
 .I c
-needs to be printed,
-.I string
-is processed in a temporary environment and the result is
-wrapped up into a single object.
+is to be formatted,
+.I contents
+is processed in a temporary environment and the result is wrapped up
+into a single object.
 .
 Compatibility mode is turned off and the escape character is
-set to\~\c
-.B \rs
+set
+.RB to\~ \rs
 while
-.I string
-is being processed.
+.I contents
+is processed.
+.
+Any emboldening,
+constant spacing,
+or track kerning is applied to this object as a whole,
+not to each character in
+.IR contents .
 .
-Any emboldening, constant spacing or track kerning is applied to
-this object rather than to individual glyphs in
-.IR string .
 .
 .IP
-A groff object defined by this request can be used just like a
-normal glyph provided by the output device.
+An object defined by this request can be used just like a glyph
+provided by the output device.
 .
-In particular other characters can be translated to it with the
+In particular,
+other characters can be translated to it with the
 .B tr
-request; it can be made the leader glyph by the
+request;
+it can be made the tab or leader fill character with the
+.B tc
+and
 .B lc
-request; repeated patterns can be drawn with the glyph using the
+requests;
+sequences of it can be drawn with the
 .B \rsl
 and
 .B \rsL
-escape sequences; words containing\~\c
-.I c
-can be hyphenated correctly, if the
+escape sequences;
+and,
+if the
 .B hcode
-request is used to give the object a hyphenation code.
+request is used on
+.IR c ,
+it is subject to automatic hyphenation.
+.
 .
 .IP
-There is a special anti-recursion feature: Use of glyph within the
-glyph's definition is handled like normal glyphs not defined with
-.BR char .
-.IP
-A glyph definition can be removed with the
+To prevent infinite recursion,
+occurrences of
+.I c
+within its own definition are treated normally
+(as if it were not being defined with
+.BR char ).
+.
+The
+.B tr
+and
+.B trin
+requests take precedence if
+.B char
+both apply
+.RI to\~ c .
+.
+A character definition can be removed with the
 .B rchar
 request.
 .
+.
 .TP
-.BI .chop\  xx
-Chop the last element off macro, string, or diversion
-.IR xx .
-This is useful for removing the newline from the end of diversions
-that are to be interpolated as strings.
+.BI .chop\~ object
+Remove the last character from the macro,
+string,
+or diversion
+.IR object .
+.
+This is useful for removing the newline from the end of a diversion that
+is to be interpolated as a string.
+.
+This request can be used repeatedly on the same
+.IR object ;
+see section \lqgtroff Internals\rq in
+.IR "Groff: The GNU Implementation of troff" ,
+the
+.I groff
+Texinfo manual,
+for discussion of nodes inserted by
+.IR groff .
+.
 .
 .TP
-.BI .class\  "name c1 c2 \*ellipsis"
-Assign
+.BI .class\~ "name c1 c2\~"\c
+\&.\|.\|.
+Define a character class
+(or simply \lqclass\rq)
 .I name
-to a set of characters
+comprising the characters or range expressions
 .IR c1 ,
 .IR c2 ,
-.IR \*ellipsis ,
-so that they can be referred to from other requests easily (currently
-.B .cflags
-only).
+and so on.
+.
+.
+.IP
+A class thus defined can then be referred to in lieu of listing all the
+characters within it.
+.
+Currently,
+only the
+.B cflags
+request can handle references to character classes.
+.
+.
+.IP
+In the request's simplest form,
+each
+.I cn
+is a character
+(or special character).
+.
+.RS
+.RS
+.EX
+\&.class quotes \aq \rsaq \rsdq \rsoq \rscq \
+\rslq \rsrq
+.EE
+.RE
+.RE
+.
+.
+.IP
+Since class and special character names share the same name space,
+we recommend starting and ending the class name with
+.RB \lq  \rq
+and
+.RB \lq  \rq,
+respectively,
+to avoid collisions with existing character names defined by
+.I groff
+or the user
+(with
+.B char
+and related requests).
+.
+This practice applies the presence of
+.RB \lq  \rq
+in the class name to prevent the usage of the special character escape
+form
+.RB \lq \rs .\|.\|.  \rq,
+thus you must use the
+.B \rsC
+escape to access a class with such a name.
+.
+.
+.IP
+You can also use a character range expression consisting of a start
+character followed by
+.RB \lq \- \rq
+and then an end character.
+.
+Internally,
+GNU
+.I troff \" GNU
+converts these two character names to Unicode code points
+(according to the
+.I groff
+glyph list GGL),
+which determine the start and end values of the range.
+.
+If that fails,
+the class definition is skipped.
+.
+Furthermore,
+classes can be nested.
+.
+.RS
+.RS
+.EX
+\&.class prepunct , : ; > }
+\&.class prepunctx \rsC\aqprepunct\aq \
+\rsu2013\-\rsu2016
+.EE
+.RE
+The class
+.RB \lq prepunctx \rq
+thus contains the contents of the class
+.RB \lq prepunct \rq
+and characters in the range U+2013\enU+2016.
+.RE
+.
+.
+.IP
+If you want to include
+.RB \lq \- \rq
+in a class,
+it must be the first character value in the argument list,
+otherwise it gets misinterpreted as part of the range syntax.
+.
+.
+.IP
+It is not possible to use class names as end points of range
+definitions.
 .
-Character ranges (indicated by an intermediate \oq\-\cq) and
-nested classes are possible also.
 .
-This is useful to assign properties to a large set of characters.
+.IP
+A typical use of the
+.B class
+request is to control line-breaking and hyphenation rules as defined by
+the
+.B cflags
+request.
+.
+For example,
+to inhibit line breaks before the characters belonging to the
+.RB \lq prepunctx \rq
+class defined in the previous example,
+you can write the following.
+.
+.RS
+.RS
+.EX
+\&.cflags 2 \rsC\aqprepunctx\aq
+.EE
+.RE
+.RE
+.
 .
 .TP
-.BI .close\  stream
+.BI .close\~ stream
 Close the stream named
-.IR stream ;
-.I stream
-will no longer be an acceptable argument to the
+.IR stream ,
+invalidating it as an argument to the
 .B write
 request.
 .
-See the
-.B open
-request.
+See
+.BR open .
+.
 .
 .TP
-.BI .composite\  glyph1\ glyph2
-Map glyph name
-.I glyph1
-to glyph name
-.I glyph2
-if it is used in
-.BI \rs \*ellipsis 
-with more than one component.
+.BI .composite\~ c1\~c2
+Map character name
+.I c1
+to character name
+.I c2
+when
+.I c1
+is a combining component in a composite glyph.
+.
+Typically,
+this remaps a spacing glyph to a combining one.
+.
 .
 .TP
 .B .continue
-Finish the current iteration of a while loop.
+Skip the remainder of a
+.RB \lq while \rq
+loop's body,
+immediately starting the next iteration.
+.
+See
+.BR break .
 .
-See also the
-.B while
-and
-.B break
-requests.
 .
 .TP
-.BI .color\  n
+.BI .color\~ n
 If
 .I n
-is non-zero or missing, enable colors (this is the default), otherwise
-disable them.
+is non-zero or missing,
+enable colors
+(the default),
+otherwise disable them.
+.
 .
 .TP
-.BI .cp\  n
+.BI .cp\~ n
 If
 .I n
-is non-zero or missing, enable compatibility mode, otherwise disable
-it.
+is non-zero or missing,
+enable compatibility mode,
+otherwise disable it.
+.
+In compatibility mode,
+long names are not recognized,
+and the incompatibilities they cause do not arise.
 .
-In compatibility mode, long names are not recognized, and the
-incompatibilities caused by long names do not arise.
 .
 .TP
-.BI .defcolor\  xxx\ scheme\ color_components
-Define color
-.IR xxx .
+.BI .defcolor\~ "ident scheme color-component\~\c"
+\&.\|.\|.
+Define a color named
+.I ident.
+.
 .I scheme
-can be one of the following values:
-.B rgb
+identifies a color space and determines the number of required
+.IR color-component s;
+it must be one of
+.RB \lq rgb \rq
 (three components),
-.B cmy
+.RB \lq cmy \rq
 (three components),
-.B cmyk
-(four components), and
-.B gray
+.RB \lq cmyk \rq
+(four components),
 or
-.B grey
+.RB \lq gray \rq
 (one component).
 .
-Color components can be given either as a hexadecimal string or as
-positive decimal integers in the range 0\en65535.
+.RB \lq grey \rq
+is accepted as a synonym of
+.RB \lq gray \rq.
 .
-A hexadecimal string contains all color components concatenated; it
-must start with either
+The color components can be encoded as a hexadecimal value starting
+with
 .B #
 or
 .BR ## .
-The former specifies hex values in the range 0\en255 (which are
-internally multiplied by\~257), the latter in the range 0\en65535.
 .
-Examples: #FFC0CB (pink), ##ffff0000ffff (magenta).
+The former indicates that each component is in the range 0\en255
+(0\enFF),
+the latter the range 0\en65535 (0\enFFFF).
 .
-A new scaling indicator\~\c
-.B f
-has been introduced which multiplies its value by\~65536; this makes
-it convenient to specify color components as fractions in the range 0
-to\~1.
+Alternatively,
+each color component can be specified as a decimal fraction in the range
+0\en1,
+interpreted using a default scaling unit
+.RB of\~\lq f \rq,
+which multiplies its value by 65,536
+(but clamps it at 65,535).
 .
-Example:
 .
-.RS
 .IP
-.EX
-\&.defcolor darkgreen rgb 0.1f 0.5f 0.2f
-.EE
-.RE
+Each output device has a color named
+.RB \lq default \rq,
+which cannot be redefined.
 .
-.IP
-Note that
-.B f
-is the default scaling indicator for the
-.B defcolor
-request, thus the above statement is equivalent to
+A device's default stroke and fill colors are not necessarily the same.
 .
-.RS
-.IP
-.EX
-\&.defcolor darkgreen rgb 0.1 0.5 0.2
-.EE
-.RE
 .
-.IP
-The color named
-.B default
-(which is device-specific) can't be redefined.
+.TP
+.BI .de1\~ name\~\c
+.RI  end-name 
+Define a macro to be interpreted with compatibility mode disabled.
+.
+When
+.I name
+is called,
+compatibility mode enablement status is saved;
+it is restored when the call completes.
+.
+.
+.TP
+.BI .dei\~ name\~\c
+.RI  end-name 
+Define macro indirectly,
+with the name of the macro to be defined in string
+.I name
+and the name of the end macro terminating its definition in string
+.IR end-name .
+.
+.
+.TP
+.BI .dei1\~ name\~\c
+.RI  end-name 
+As
+.BR dei ,
+but compatibility mode is disabled while the definition of the macro
+named in string
+.I name
+is interpreted.
 .
-It is possible that the default color for
-.B \rsM
-and
-.B \rsm
-is not the same.
 .
 .TP
-.BI .de1\  xx\ yy
-Similar to
-.BR .de ,
-but compatibility mode is switched off during execution.
+.BI .device\~ anything
+Write
+.IR anything ,
+read in copy mode,
+to
+.I @g@troff
+output as a device control command.
+.
+An initial neutral double quote is stripped to allow the embedding of
+leading spaces.
 .
-On entry, the current compatibility mode is saved and restored at exit.
 .
 .TP
-.BI .dei\  xx\ yy
-Define macro indirectly.
+.BI .devicem\~ name
+Write contents of macro or string
+.I name
+to
+.I @g@troff
+output as a device control command.
+.
+.
+.TP
+.BI .do\~ name\~\c
+.RI  arg \~.\|.\|.
+Interpret the string,
+request,
+diversion,
+or macro
+.I name
+(along with any arguments)
+with compatibility mode disabled.
+.
+Compatibility mode is restored
+(only if it was active)
+when the
+.I expansion
+of
+.I name
+is interpreted;
+that is,
+the restored compatibility state applies to the contents of the macro,
+string,
+or diversion
+.I name
+as well as data read from files or pipes if
+.I name
+is any of the
+.BR so ,
+.BR soquiet ,
+.BR mso ,
+.BR msoquiet ,
+or
+.B pso
+requests.
 .
-The following example
 .
-.RS
 .IP
-.ne 2v+\n(.Vu
+For example,
+.RS
+.RS \" one "extra" RS to get us inboard of this indented paragraph
 .EX
-\&.ds xx aa
-\&.ds yy bb
-\&.dei xx yy
+\&.de mac1
+FOO
+\&..
+\&.de1 mac2
+groff
+\&.mac1
+\&..
+\&.de mac3
+compatibility
+\&.mac1
+\&..
+\&.de ma
+\rs\rs$1
+\&..
+\&.cp 1
+\&.do mac1
+\&.do mac2 \rs" mac2, defined with .de1, calls "mac1"
+\&.do mac3 \rs" mac3 calls "ma" with argument "c1"
+\&.do mac3 \rsti \rs" groff syntax accepted in .do arguments
 .EE
 .RE
-.
-.IP
-is equivalent to
-.
+results in
 .RS
-.IP
 .EX
-\&.de aa bb
+FOO groff FOO compatibility c1 \ti
 .EE
 .RE
+as output.
+.RE \" this "extra" RE avoids indentation of the remaining paragraphs
+.
 .
 .TP
-.BI .dei1\  xx\ yy
-Similar to the
-.B dei
-request but compatibility mode is switched off during execution.
+.BI .ds1\~ "name contents"
+As
+.BR ds ,
+but compatibility mode is disabled while
+.I name
+is interpreted:
+a \lqcompatibility save\rq token is inserted at the beginning of
+.IR contents ,
+and a \lqcompatibility restore\rq token after it.
+.
 .
 .TP
-.BI .device\  anything
-This is (almost) the same as the
-.B \rsX
-escape.
-.I anything
-is read in copy mode; a leading\~\c
-.B \dq
-is stripped.
+.B .ecr
+Restore the escape character saved with
+.BR ecs ,
+or set escape character to
+.RB \lq\| \rs \rq
+if none has been saved.
+.
 .
 .TP
-.BI .devicem\  xx
-This is the same as the
-.B \rsY
-escape (to embed the contents of a macro into the intermediate
-output preceded with \oqx\~X\cq).
+.B .ecs
+Save the current escape character.
+.
 .
 .TP
-.BI .do\  xxx
-Interpret
-.I .xxx
-with compatibility mode disabled.
+.BI .evc\~ env
+Copy the properties of environment
+.I env
+to the current environment,
+except for the following data.
 .
-For example,
 .
 .RS
+.IP \bu 2n
+a partially collected line,
+if present;
 .
-.IP
-.EX
-\&.do fam T
-.EE
 .
-.P
-would have the same effect as
+.IP \bu
+the interruption status of the previous input line
+(due to use of the
+.B \rsc
+escape sequence);
 .
-.IP
-.EX
-\&.fam T
-.EE
 .
-.P
-except that it would work even if compatibility mode had been enabled.
+.IP \bu
+the count of remaining lines to center,
+to right-justify,
+or to underline
+(with or without underlined spaces)\emthese are set to zero;
 .
-Note that the previous compatibility mode is restored before any files
-sourced by
-.I xxx
-are interpreted.
 .
-.RE
+.IP \bu
+the activation status of temporary indentation;
 .
-.TP
-.BI .ds1\  xx\ yy
-Similar to
-.BR .ds ,
-but compatibility mode is switched off during expansion.
 .
-To be more precise, a \oqcompatibility save\cq token is inserted
-at the beginning of the string, and a \oqcompatibility restore\cq
-token at the end.
+.IP \bu
+input traps and their associated data;
 .
-.TP
-.B .ecs
-Save current escape character.
 .
-.TP
-.B .ecr
-Restore escape character saved with
-.BR ecs .
-Without a previous call to
-.BR ecs ,
-.RB \oq \rs \cq
-will be the new escape character.
+.IP \bu
+the activation status of line numbering
+(which can be reactivated with
+.RB \lq .nm\~+0 \rq);
+and
 .
-.TP
-.BI .evc\  xx
-Copy the contents of environment
-.I xx
-to the current environment.
 .
-No pushing or popping of environments is done.
+.IP \bu
+the count of consecutive hyphenated lines
+(set to zero).
+.RE
+.
 .
 .TP
-.BI .fam\  xx
-Set the current font family to
-.IR xx .
-The current font family is part of the current environment.
-If
-.I xx
-is missing, switch back to previous font family.
+.BR .fam\~ \c
+.IR family 
+Set default font family to
+.IR family .
+.
+If no argument is given,
+the previous font family is selected,
+or the formatter's default family if there is none.
+.
+The formatter's default font family is \lqT\rq (Times),
+but it can be overridden by the output device\emsee
+.MR groff_font @MAN5EXT@ .
 .
-The value at start-up is \oqT\cq.
+The default font family is associated with the environment.
+.
+See
+.BR \rsF .
 .
-See the description of the
-.B sty
-request for more information on font families.
 .
 .TP
-.BI .fchar\  c\ string
-Define fallback character (or glyph)\~\c
-.I c
-to be
-.IR string .
+.BI .fchar\~ c\~contents
+Define fallback
+.RI character\~ c
+as
+.IR contents .
 .
 The syntax of this request is the same as the
 .B char
-request; the only difference is that a glyph defined with
+request;
+the difference is that a character defined with
 .B char
-hides the glyph with the same name in the current font, whereas a
-glyph defined with
+hides a glyph with the same name in the selected font,
+whereas characters defined with
 .B fchar
-is checked only if the particular glyph isn't found in the current
-font.
+are checked only if
+.I c
+isn't found in the selected font.
+.
+This test happens before special fonts are searched.
 .
-This test happens before checking special fonts.
 .
 .TP
-.BI .fcolor\  c
-Set the fill color to\~\c
-.IR c .
-If
-.I c
-is missing,
-switch to the previous fill color.
+.BI .fcolor\~ color
+Set the fill color to
+.IR color .
+.
+Without an argument,
+the previous fill color is selected.
+.
 .
 .TP
-.BI .fschar\  f\ c\ string
-Define fallback character (or glyph)\~\c
-.I c
+.BI .fschar\~ f\~c\~contents
+Define fallback special
+.RI character\~ c
 for font\~\c
 .I f
-to be
-.IR string .
+as
+.IR contents .
 .
-The syntax of this request is the same as the
-.B char
-request (with an additional argument to specify the font); a glyph
-defined with
+A character defined by
 .B fschar
-is searched after the list of fonts declared with the
-.B fspecial
-request but before the list of fonts declared with
-.BR .special .
+is located after the list of fonts declared with
+.B \%fspecial
+is searched but before those declared with the
+.RB \%\lq special \rq
+request.
 .
 .TP
-.BI .fspecial\  "f s1 s2 \*ellipsis"
-When the current font is\~\c
-.IR f ,
+.BI .fspecial\~ "f s1 s2\~"\c
+\&.\|.\|.
+When
+.RI font\~ f
+is selected,
 fonts
 .IR s1 ,
 .IR s2 ,
-.IR \*ellipsis ,
-are special, that is, they are searched for glyphs not in
-the current font.
+\&.\|.\|.\&
+are treated as special;
+that is,
+they are searched for glyphs not found in
+.IR f .
 .
 Any fonts specified in the
-.B special
-request are searched after fonts specified in the
-.B fspecial
-request.
+.RB \%\lq special \rq
+request are searched after
+.IR s1 ,
+.IR s2 ,
+and so on.
+.
+Without
+.I s
+arguments,
+.B \%fspecial
+clears the list of fonts treated as special when
+.I f
+is selected.
 .
-Without argument, reset the list of global special fonts to be empty.
 .
 .TP
-.BI .ftr\  f\ g
-Translate font\~\c
-.I f
-to\~\c
-.IR g .
-Whenever a font named\~\c
-.I f
+.BI .ftr\~ f\~g
+Translate
+.RI font\~ f
+.RI to\~ g .
+.
+Whenever a font
+.RI named\~ f
 is referred to in an
 .B \rsf
-escape sequence, in the
+escape sequence,
+in the
 .B F
 and
 .B S
-conditional operators, or in the
+conditional expression operators,
+or in the
 .BR ft ,
 .BR ul ,
 .BR bd ,
 .BR cs ,
 .BR tkf ,
-.BR special ,
-.BR fspecial ,
+.BR \%special ,
+.BR \%fspecial ,
 .BR fp ,
 or
 .B sty
-requests, font\~\c
-.I g
+requests,
+.RI font\~ g
 is used.
 If
 .I g
-is missing, or equal to\~\c
-.I f
-then font\~\c
-.I f
+is missing or identical
+.RI to\~ f ,
+then
+.RI font\~ f
 is not translated.
 .
+.
 .TP
-.BI .fzoom\  f\ zoom
+.BI .fzoom\~ f\~zoom
 Set zoom factor
 .I zoom
 for font\~\c
 .IR f .
 .I zoom
 must a non-negative integer multiple of 1/1000th.
-If it is missing or is equal to zero, it means the same as 1000, namely
-no magnification.
+.
+If it is missing or is equal to zero,
+it means the same as 1000,
+namely no magnification.
+.
 .IR f \~\c
-must be a real font name, not a style.
+must be a resolved font name,
+not an abstract style.
+.\" XXX: What about a mounting position?  It's not rejected...
+.
 .
 .TP
-.BI .gcolor\  c
-Set the glyph color to\~\c
-.IR c .
-If
-.I c
-is missing,
-switch to the previous glyph color.
+.BI .gcolor\~ color
+Set the stroke color to
+.IR color .
+.
+Without an argument,
+the previous stroke color is selected.
+.
 .
 .TP
-.BI .hcode\  "c1 code1 c2 code2 \*ellipsis"
+.BI .hcode\~ "c1 code1\~"\c
+.RI  "c2 code2" " .\|.\|."
 Set the hyphenation code of character
 .I c1
 to
-.I code1
-and that of
+.IR code1 ,
+that of
 .I c2
 to
 .IR code2 ,
 and so on.
-A hyphenation code must be a single input character (not a special
-character) other than a digit or a space.
 .
-Initially each lower-case letter \%a\enz has a hyphenation code, which
-is itself, and each upper-case letter \%A\enZ has a hyphenation code
-which is the lower-case version of itself.
+A hyphenation code must be an ordinary character
+(not a special character escape sequence)
+other than a digit.
+.
+The request is ignored if given no arguments.
+.
+.
+.IP
+For hyphenation to work,
+hyphenation codes must be set up.
+.
+At startup,
+.I groff
+assigns hyphenation codes to the letters \lqa\enz\rq
+(mapped to themselves),
+to the letters \lqA\enZ\rq
+(mapped to \lqa\enz\rq),
+and zero to all other characters.
+.
+Normally,
+hyphenation patterns contain only lowercase letters which should be
+applied regardless of case.
+.
+In other words,
+they assume that the words \lqABBOT\rq and \lqAbbot\rq should be
+hyphenated exactly as \lqabbot\rq is.
+.
+.B hcode
+extends this principle to letters outside the Unicode basic Latin
+alphabet;
+without it,
+words containing such letters won't be hyphenated properly even if the
+corresponding hyphenation patterns contain them.
 .
-See also the
-.B hpf
-request.
 .
 .TP
-.BI .hla\  lang
-Set the current hyphenation language to
+.BI .hla\~ lang
+Set the hyphenation language to
 .IR lang .
+.
 Hyphenation exceptions specified with the
 .B hw
-request and hyphenation patterns specified with the
+request and hyphenation patterns and exceptions specified with the
 .B hpf
-request are both associated with the current hyphenation language.
+and
+.B hpfa
+requests are associated with the hyphenation language.
 .
 The
 .B hla
-request is usually invoked by the
-.B troffrc
-file to set up a default language.
+request is usually invoked by a localization file,
+which is in turn loaded by the
+.I troffrc
+or
+.I troffrc\-end
+file;
+see the
+.B hpf
+request below.
+.
+The hyphenation language is associated with the environment.
+.
 .
 .TP
-.BI .hlm\  n
-Set the maximum number of consecutive hyphenated lines to\~\c
-.IR n .
+.BR .hlm\~ \c
+.IR n 
+Set the maximum number of consecutive hyphenated lines
+.RI to\~ n .
+.
 If
 .I n
-is negative, there is no maximum.
+is negative,
+there is no maximum.
 .
-The default value is\~\-1.
+If omitted,
+.I n
+is\~\-1.
 .
-This value is associated with the current environment.
+This value is associated with the environment.
 .
-Only lines output from an environment count towards the maximum
+Only lines output from a given environment count towards the maximum
 associated with that environment.
 .
 Hyphens resulting from
 .B \rs%
-are counted; explicit hyphens are not.
+are counted;
+explicit hyphens are not.
+.
 .
 .TP
-.BI .hpf\  file
+.BI .hpf\~ pattern-file
 Read hyphenation patterns from
-.IR file ;
-this is searched for in the same way that
-.IB name .tmac
-is searched for when the
+.IR pattern-file .
+.
+This file is sought in the same way that macro files are with the
+.B mso
+request or the
 .BI \-m name
-option is specified.
+command-line option to
+.MR groff @MAN1EXT@
+and
+.MR @g@troff @MAN1EXT@ .
 .
-It should have the same format as (simple) \*tx patterns files.
 .
-More specifically, the following scanning rules are implemented.
+.IP
+The
+.I pattern-file
+should have the same format as (simple) \*tx pattern files.
+.
+The following scanning rules are implemented.
+.
 .
 .RS
-.IP \bu
-A percent sign starts a comment (up to the end of the line) even if
-preceded by a backslash.
+.IP \bu 2n
+A percent sign starts a comment
+(up to the end of the line)
+even if preceded by a backslash.
+.
 .
 .IP \bu
-No support for \oqdigraphs\cq like
-.BR \rs$ .
+\lqDigraphs\rq like
+.B \rs$
+are not supported.
+.
 .
 .IP \bu
-.BI ^^ xx
-.RI ( x
-is 0\en9 or a\enf) and
-.BI ^^ x
-(character code of\~\c
+.RB \lq \ha\ha\c
+.IR xx \rq
+(where each
 .I x
-in the range 0\en127) are recognized; other use of\~\c
-.B ^
-causes an error.
+is 0\en9 or a\enf) and
+.BI \ha\ha c
+.RI (character\~ c
+in the code point range 0\en127 decimal)
+are recognized;
+other uses
+.RB of\~ \ha
+cause an error.
+.
 .
 .IP \bu
-No macro expansion.
+No macro expansion is performed.
+.
 .
 .IP \bu
 .B hpf
 checks for the expression
-.BR \rspatterns{ \*ellipsis }
-(possibly with whitespace before and after the braces).
+.BR \rspatterns{ .\|.\|. }
+(possibly with whitespace before or after the braces).
 .
 Everything between the braces is taken as hyphenation patterns.
 .
 Consequently,
-.BR { \~\c
-and\~\c
-.B }
+.RB \lq { \rq
+and
+.RB \lq } \rq
 are not allowed in patterns.
 .
+.
 .IP \bu
 Similarly,
-.BR \rshyphenation{ \*ellipsis }
+.BR \rshyphenation{ .\|.\|. }
 gives a list of hyphenation exceptions.
 .
+.
 .IP \bu
 .B \rsendinput
 is recognized also.
 .
+.
 .IP \bu
-For backwards compatibility, if
+For backwards compatibility,
+if
 .B \rspatterns
-is missing, the whole file is treated as a list of hyphenation patterns
-(only recognizing the
-.BR % \~\c
-character as the start of a comment).
+is missing,
+the whole file is treated as a list of hyphenation patterns
+(but the
+.RB \lq % \rq
+character is still recognized as the start of a comment).
 .RE
 .
+.
 .IP
 Use the
 .B hpfcode
-request to map the encoding used in hyphenation patterns files to
-.BR groff 's
+request
+(see below)
+to map the encoding used in hyphenation pattern files to
+.IR groff 's
 input encoding.
 .
-By default, everything maps to itself except letters \oqA\cq to
-\oqZ\cq which map to \oqa\cq to \oqz\cq.
 .
 .IP
-The set of hyphenation patterns is associated with the current language
-set by the
+The set of hyphenation patterns is associated with the hyphenation
+language set by the
 .B hla
 request.
 .
 The
 .B hpf
-request is usually invoked by the
-.B troffrc
-file; a second call replaces the old patterns with the new ones.
+request is usually invoked by a localization file loaded by the
+.I troffrc
+file.
 .
-.TP
-.BI .hpfa\  file
-The same as
+By default,
+.I troffrc
+loads the localization file for English.
+.
+(As of
+.I groff
+1.23.0,
+localization files for Czech
+.RI ( cs ),
+German
+.RI ( de ),
+English
+.RI ( en ),
+French
+.RI ( fr ),
+Japanese
+.RI ( ja ),
+Swedish
+.RI ( sv ),
+and Chinese
+.RI ( zh )
+exist.)
+.
+For Western languages,
+the localization file sets the hyphenation mode and loads hyphenation
+patterns and exceptions.
+.
+.
+.IP
+A second call to
 .B hpf
-except that the hyphenation patterns from
-.I file
-are appended to the patterns already loaded in the current language.
+(for the same language)
+replaces the old patterns with the new ones.
+.
+.
+.IP
+Invoking
+.B hpf
+causes an error if there is no hyphenation language.
+.
+.
+.IP
+If no
+.B hpf
+request is specified
+(either in the document,
+in a file loaded at startup,
+or in a macro package),
+GNU
+.I troff \" GNU
+won't automatically hyphenate at all.
+.
 .
 .TP
-.BI .hpfcode\  "a b c d \*ellipsis"
-After reading a hyphenation patterns file with the
+.BI .hpfa\~ pattern-file
+As
+.BR hpf ,
+except that the hyphenation patterns and exceptions from
+.I pattern-file
+are appended to the patterns already applied to the hyphenation language
+of the environment.
+.
+.
+.TP
+.BI .hpfcode\~ "a b"\c
+.RI \~ "c d" " .\|.\|."
+Define mapping values for character codes in pattern files.
+.
+This is an older mechanism no longer used by
+.IR groff 's
+own macro files;
+for its successor,
+see
+.B hcode
+above.
+.
 .B hpf
 or
 .B hpfa
-request, convert all characters with character code\~\c
-.I a
-in the recently read patterns to character code\~\c
-.IR b ,
-character code\~\c
-.I c
-to\~\c
-.IR d ,
-etc.
+apply the mapping
+after reading or appending to the active list of patterns.
 .
-Initially, all character codes map to themselves.
+Its arguments are pairs of character codes\emintegers from 0 to\~255.
 .
-The arguments of
-.B hpfcode
-must be integers in the range 0 to\~255.
+The request maps character
+.RI code\~ a
+to
+.RI code\~ b ,
+.RI code\~ c
+to
+.RI code\~ d ,
+and so on.
+.
+Character codes that would otherwise be invalid in
+.I groff
+can be used.
+.
+By default,
+every code maps to itself except those for letters \lqA\rq to
+\lqZ\rq,
+which map to those for \lqa\rq to \lqz\rq.
 .
-Note that it is even possible to use character codes which are invalid
-in
-.B groff
-otherwise.
 .
 .TP
-.BI .hym\  n
-Set the
-.I hyphenation margin
-to\~\c
-.IR n :
-when the current adjustment mode is not\~\c
-.BR b ,
-the line is not hyphenated if the line is no more than
-.I n
-short.
+.BR .hym\~ \c
+.IR length 
+Set the (right) hyphenation margin
+.RI to\~ length .
 .
-The default hyphenation margin is\~0.
+If the adjustment mode is not
+.RB \lq b \rq
+or
+.RB \lq n \rq,
+the line is not hyphenated if it is shorter than
+.IR length .
 .
-The default scaling indicator for this request is\~\c
-.BR m .
-The hyphenation margin is associated with the current environment.
+Without an argument,
+the default hyphenation margin is reset to its default value,
+0.
+.
+The default scaling unit
+.RB is\~\lq m \rq.
+.
+The hyphenation margin is associated with the environment.
+.
+A negative argument resets the hyphenation margin to zero,
+emitting a warning in category
+.RB \lq range \rq.
 .
-The current hyphenation margin is available in the
-.B \rsn.hym
-register.
 .
 .TP
-.BI .hys\  n
-Set the
-.I hyphenation space
-to\~\c
-.IR n :
-When the current adjustment mode is\~\c
-.B b
-don't hyphenate the line if the line can be justified by adding no
-more than
-.I n
-extra space to each word space.
+.BR .hys\~ \c
+.IR hyphenation-space 
+Suppress hyphenation of the line in adjustment modes
+.RB \lq b \rq
+or
+.RB \lq n \rq,
+if it can be justified by adding no more than
+.I hyphenation-space
+extra space to each inter-word space.
 .
-The default hyphenation space is\~0.
+Without an argument,
+the hyphenation space adjustment threshold is set to its default value,
+0.
 .
-The default scaling indicator for this request is\~\c
-.BR m .
-The hyphenation space is associated with the current environment.
+The default scaling unit
+.RB is\~\lq m \rq.
+.
+The hyphenation space adjustment threshold is associated with the
+current environment.
+.
+A negative argument resets the hyphenation space adjustment threshold to
+zero,
+emitting a warning in category
+.RB \lq range \rq.
 .
-The current hyphenation space is available in the
-.B \rsn.hys
-register.
 .
 .TP
-.BI .itc\  n\ macro
-Variant of
-.B .it
-for which a line interrupted with
+.BI .itc\~ n\~name
+As
+.RB \lq it \rq,
+but lines interrupted with the
 .B \rsc
-is not counted as an input line.
+escape sequence are not applied to the line count.
+.
 .
 .TP
-.BI .kern\  n
+.BI .kern\~ n
 If
 .I n
-is non-zero or missing, enable pairwise kerning, otherwise disable it.
+is non-zero or missing,
+enable pairwise kerning
+(the default),
+otherwise disable it.
+.
 .
 .TP
-.BI .length\  xx\ string
-Compute the length of
-.I string
-and return it in the number register
-.I xx
-(which is not necessarily defined before).
+.BI .length\~ "reg anything"
+Compute the number of characters in
+.I anything
+and return the count in the register
+.IR reg .
+.
+If
+.I reg
+doesn't exist,
+it is created.
+.
+.I anything
+is read in copy mode.
+.
+.
+.RS
+.IP
+.EX
+.B .ds xxx abcd\eh\aq3i\aqefgh
+.B .length yyy \e*xxx
+.B \enyyy
+14
+.EE
+.RE
+.
 .
 .TP
-.BI .linetabs\  n
+.BI .linetabs\~ n
+.RS
 If
 .I n
-is non-zero or missing, enable line-tabs mode, otherwise disable it
-(which is the default).
+is non-zero or missing,
+enable line-tabs mode,
+otherwise disable it
+(the default).
+.
+In this mode,
+tab stops are computed relative to the start of the pending output line,
+instead of the drawing position corresponding to the start of the input
+line.
 .
-In line-tabs mode, tab distances are computed relative to the
-(current) output line.
+Line-tabs mode is a property of the environment.
 .
-Otherwise they are taken relative to the input line.
 .
-For example, the following
+.P
+For example,
+the following
+.
 .
 .RS
-.IP
+.P
 .ne 6v+\n(.Vu
 .EX
 \&.ds x a\rst\rsc
@@ -1805,56 +3077,70 @@
 .EE
 .RE
 .
-.IP
 yields
 .
 .RS
-.IP
 .EX
 a         b         c
 .EE
 .RE
 .
-.IP
-In line-tabs mode, the same code gives
+whereas in line-tabs mode,
+the same input gives
 .
 .RS
-.IP
 .EX
 a         b                   c
 .EE
 .RE
 .
-.IP
-Line-tabs mode is associated with the current environment; the
-read-only number register
-.B \rsn.linetabs
-is set to\~1 if in line-tabs mode, and 0 otherwise.
+instead.
+.RE
+.
 .
 .TP
-.BI .lsm\  xx
-Set the leading spaces macro to
-.IR xx .
-If there are leading spaces in an input line, it is invoked instead of
-the usual troff behaviour; the leading spaces are removed.
-Registers
-.B \rsnlsn
-and
-.B \rsnlss
-hold the number of removed leading spaces and the corresponding
-horizontal space, respectively.
+.BR .lsm\~ \c
+.IR name 
+Set the leading space macro (trap) to
+.IR name .
+.
+If there are leading space characters on an input line,
+.I name
+is invoked in lieu of the usual
+.I roff
+behavior;
+the leading spaces are removed.
+.
+The count of leading spaces on an input line is stored in
+.BR \rsnlsn ,
+and the amount of corresponding horizontal motion in
+.BR \rsnlss ,
+irrespective of whether a leading space trap is set.
+.
+When it is,
+the leading spaces are removed from the input line,
+and no motion is produced before calling
+.IR name .
+.
+If no argument is supplied,
+the default leading space behavior is (re-)established.
+.
 .
 .TP
-.BI .mso\  file
-The same as the
-.B so
-request except that
+.BI .mso\~ file
+As
+.RB \lq so \rq,
+except that
 .I file
-is searched for in the same directories as macro files for the
+is sought in the same directories as arguments to the
+.MR groff @MAN1EXT@
+and
+.MR @g@troff @MAN1EXT@
 .B \-m
-command-line option.
+command-line option are
+(the \lqtmac path\rq).
 .
-If the file name to be included has the form
+If the file name to be interpolated has the form
 .IB name .tmac
 and it isn't found,
 .B mso
@@ -1862,88 +3148,127 @@
 .BI tmac. name
 instead and vice versa.
 .
-A warning of type
-.B file
-is generated if
+If
 .I file
-can't be loaded, and the request is ignored.
+does not exist,
+a warning in category
+.RB \lq file \rq
+is emitted
+and the request has no other effect.
+.
 .
 .TP
-.BI .nop \ anything
-Execute
-.IR anything .
-This is similar to \oq.if\ 1\cq.
+.BI .msoquiet\~ file
+As
+.BR mso ,
+but no warning is emitted if
+.I file
+does not exist.
+.
+.
+.TP
+.BI .nop \~anything
+Interpret
+.I anything
+as if it were an input line.
+.
+.B nop
+resembles
+.RB \lq ".if 1" \rq;
+it puts a break on the output if
+.I anything
+is empty.
+.
+Unlike
+.RB \lq\| if \|\rq,
+it cannot govern conditional blocks.
+.
+Its application is to maintain consistent indentation within macro
+definitions even when producing text lines.
+.
 .
 .TP
 .B .nroff
 Make the
 .B n
-built-in condition true and the
+conditional expression evaluate true and
 .B t
-built-in condition false.
+false.
+.
+See
+.BR troff .
 .
-This can be reversed using the
-.B troff
-request.
 .
 .TP
-.BI .open\  stream\ filename
+.BI .open\~ "stream file"
 Open
-.I filename
-for writing and associate the stream named
+.I file
+for writing and associate
 .I stream
 with it.
 .
-See also the
-.B close
-and
+See
 .B write
-requests.
+and
+.BR close .
+.
 .
 .TP
-.BI .opena\  stream\ filename
-Like
+.BI .opena\~ "stream file"
+As
 .BR open ,
 but if
-.I filename
-exists, append to it instead of truncating it.
+.I file
+exists,
+append to it instead of truncating it.
+.
 .
 .TP
-.BI .output\  string
+.BI .output\~ contents
 Emit
-.I string
-directly to the intermediate output (subject to copy-mode
-interpretation);
+.IR contents ,
+which are read in copy mode,
+to the formatter output;
 this is similar to
 .B \rs!\&
-used at the top level.
+used in the top-level diversion.
+.
+An initial neutral double quote in
+.I contents
+is stripped to allow the embedding of leading spaces.
+.\" XXX: useless request warning if no argument?
 .
-An initial double quote in
-.I string
-is stripped off to allow initial blanks.
 .
 .TP
 .B .pev
-Print the current environment and each defined environment state on
-stderr.
+Report the state of the current environment followed by that of all
+other environments to the standard error stream.
+.
 .
 .TP
 .B .pnr
-Print the names and contents of all currently defined number registers
-on stderr.
+Write the names and values of all currently defined registers to the
+standard error stream.
+.
 .
 .TP
-.BI .psbb \ filename
+.BI .psbb \~file
 Get the bounding box of a PostScript image
-.IR filename .
+.IR file .
 .
-This file must conform to Adobe's Document Structuring
-Conventions; the command looks for a
+This file must conform to Adobe's Document Structuring Conventions;
+the request attempts to extract the bounding box values from a
 .B \%%%BoundingBox
-comment to extract the bounding box values.
+comment.
 .
-After a successful call, the coordinates (in PostScript units) of the
-lower left and upper right corner can be found in the registers
+After invocation,
+the
+.I x
+and
+.I y
+coordinates
+(in PostScript units)
+of the lower left and upper right corners can be found in the registers
 .BR \rsnllx ,
 .BR \rsnlly ,
 .BR \rsnurx ,
@@ -1951,296 +3276,369 @@
 .BR \rsnury ,
 respectively.
 .
-If some error has occurred, the four registers are set to zero.
+If an error occurs,
+these four registers are set to zero.
+.
 .
 .TP
-.BI .pso \ command
-This behaves like the
-.B so
-request except that input comes from the standard output of
+.BI .pso \~command
+As
+.RB \lq so \rq,
+except that input comes from the standard output stream of
 .IR command .
 .
+.
 .TP
 .B .ptr
-Print the names and positions of all traps (not including input line
-traps and diversion traps) on stderr.
+Report the names and vertical positions of all page location traps
+to the standard error stream.
+.
+Empty slots in the list are shown as well,
+because they can affect the visibility of subsequently planted traps.
 .
-Empty slots in the page trap list are printed as well, because they
-can affect the priority of subsequently planted traps.
 .
 .TP
-.BI .pvs \ \+-n
-Set the post-vertical line space to\~\c
-.IR n ;
-default scale indicator is\~\c
-.BR p .
+.BI .pvs \~\+-n
+Set the post-vertical line spacing
+.RI to\~ n ;
+default scaling unit
+.RB is\~\lq p \rq.
 .
-This value is added to each line after it has been output.
+With no argument,
+the post-vertical line space is set to its previous value.
 .
-With no argument, the post-vertical line space is set to its previous
-value.
 .
 .IP
-The total vertical line spacing consists of four components:
-.B .vs
-and
+In GNU
+.IR troff , \" GNU
+the distance between text baselines consists of the extra pre-vertical
+line spacing set by the most negative
 .B \rsx
-with a negative value which are applied before the line is output, and
-.B .pvs
-and
+argument on the pending output line,
+the vertical spacing
+.RB ( vs ),
+the extra post-vertical line spacing set by the most positive
 .B \rsx
-with a positive value which are applied after the line is output.
+argument on the pending output line,
+and the post-vertical line spacing set by this request.
+.
 .
 .TP
-.BI .rchar\  "c1 c2 \*ellipsis"
-Remove the definitions of glyphs
-.IR c1 ,
-.IR c2 ,
-.I \*ellipsis\ \"Add a sentence space
-This undoes the effect of a
-.B char
+.BI .rchar\~ c\~\c
+\&.\|.\|.
+Remove definition of each ordinary or special character
+.IR c ,
+undoing the effect of a
+.BR char ,
+.BR fchar ,
+or
+.B schar
 request.
 .
+Glyphs,
+which are defined by font description files,
+cannot be removed.
+.
+Spaces and tabs may separate
+.I c
+arguments.
+.
+.
 .TP
 .B .return
-Within a macro, return immediately.
+Within a macro,
+return immediately.
 .
-If called with an argument, return twice, namely from the current macro
-and from the macro one level higher.
+If called with an argument,
+return twice,
+namely from the current macro and from the macro one level higher.
 .
 No effect otherwise.
+.\" XXX: useless request warning?
+.
 .
 .TP
-.BI .rfschar\  "c1 c2 \*ellipsis"
-Remove the font-specific definitions of glyphs
-.IR c1 ,
-.IR c2 ,
-.I \*ellipsis\ \"Add a sentence space
-This undoes the effect of an
-.B fschar
-request.
+.BI .rfschar\~ "f c\~"\c
+\&.\|.\|.
+Remove each fallback special
+.RI character\~ c
+for font
+.IR f .
+.
+Spaces and tabs may separate
+.I c
+arguments.
+.
+See
+.BR fschar .
+.
 .
 .TP
-.B .rj
-.TQ
-.BI .rj \~n
-Right justify the next
-.IR n \~\c
+.BR .rj\~ \c
+.IR n 
+Right-align the
+.RI next\~ n
 input lines.
 .
-Without an argument right justify the next input line.
+Without an argument,
+right-align the next input line.
 .
-The number of lines to be right justified is available in the
-.B \rsn.rj
-register.
-.
-This implicitly does
-.BR .ce\~0 .
-The
+.B rj
+implies
+.RB \lq ".ce 0" \rq,
+and
 .B ce
-request implicitly does
-.BR .rj\~0 .
+implies
+.RB \lq ".rj 0" \rq.
+.
 .
 .TP
-.BI .rnn \ xx\ yy
-Rename number register
-.I xx
+.BI .rnn \~r1\~r2
+Rename register
+.I r1
 to
-.IR yy .
+.IR r2 .
+.
+If
+.I r1
+doesn't exist,
+the request is ignored.
+.
 .
 .TP
-.BI .schar\  c\ string
-Define global fallback character (or glyph)\~\c
+.BI .schar\~ c\~contents
+Define global fallback character
 .I c
-to be
-.IR string .
+as
+.IR contents .
 .
-The syntax of this request is the same as the
-.B char
-request; a glyph defined with
+See
+.BR char ;
+the distinction is that a character defined with
 .B schar
-is searched after the list of fonts declared with the
-.B special
-request but before the mounted special fonts.
+is located after the list of fonts declared with the
+.B \%special
+request but before any mounted special fonts.
+.
 .
 .TP
-.BI .shc\  c
-Set the soft hyphen character to\~\c
-.IR c .
+.BR .shc \~\c
+.RI  c 
+Set the soft hyphen character,
+inserted when a word is hyphenated automatically or at a hyphenation
+character,
+.RI to\~ c .
+.
 If
 .I c
-is omitted, the soft hyphen character is set to the default
+is omitted,
+the soft hyphen character is set to the default,
 .BR \rshy .
-The soft hyphen character is the glyph which is inserted when
-a word is hyphenated at a line break.
 .
-If the soft hyphen character does not exist in the font of the
-glyph immediately preceding a potential break point, then the line
-is not broken at that point.
+If the selected glyph does not exist in the font in use at a potential
+hyphenation point,
+then the line is not broken at that point.
+.
+Neither character definitions
+.RB ( char
+and similar)
+nor translations
+.RB ( tr
+and similar)
+are considered when assigning the soft hyphen character.
 .
-Neither definitions (specified with the
-.B char
-request) nor translations (specified with the
-.B tr
-request) are considered when finding the soft hyphen character.
 .
 .TP
-.BI .shift\  n
-In a macro, shift the arguments by
+.BI .shift\~ n
+In a macro,
+shift the arguments by
 .I n
-positions: argument\~\c
-.I i
+positions:
+.RI argument\~ i
 becomes argument
 .IR i \|\-\| n ;
-arguments 1 to\~\c
-.I n
+arguments 1
+.RI to\~ n
 are no longer available.
 .
-If
-.I n
-is missing, arguments are shifted by\~1.
+.RI If\~ n
+is missing,
+arguments are shifted by\~1.
 .
-Shifting by negative amounts is currently undefined.
+No effect otherwise.
+.\" XXX: useless request warning?
 .
-.TP
-.BI .sizes\  s1\ s2\ \*ellipsis\ sn\  0
-This command is similar to the
-.B sizes
-command of a
-.I DESC
-file.
 .
-It sets the available font sizes for the current font to
+.TP
+.BI .sizes\~ "s1 s2\~"\c
+.RI .\|.\|.\~ sn\~\c
+.RB  0 
+Set the available type sizes to
 .IR s1 ,
 .IR s2 ,
-.IR \*ellipsis\| ,\~ sn
+\&.\|.\|.\&
+.I sn
 scaled points.
 .
-The list of sizes can be terminated by an optional\~\c
-.BR 0 .
+The list of sizes can be terminated by an
+.RB optional\~\lq 0 \rq.
 .
 Each
 .I si
-can also be a range of sizes
+can also be a range
 .IR m \(en n .
 .
-Contrary to the font file command, the list can't extend over more
-than a single line.
+In contrast to the device description file directive of the same name
+(see
+.MR groff_font @MAN5EXT@ ),
+the argument list can't extend over more than one line.
+.
 .
 .TP
-.BI .special\  "s1 s2 \*ellipsis"
-Fonts
-.IR s1 ,
-.IR s2 ,
-.IR \*ellipsis ,
-are special and are searched for glyphs not in the current
-font.
-.
-Without arguments, reset the list of special fonts to be empty.
+.BI .soquiet\~ file
+As
+.RB \lq so \rq,
+but no warning is emitted if
+.I file
+does not exist.
+.
+.
+.TP
+.BI .special\~ f\~\c
+\&.\|.\|.
+Declare each font
+.I f
+as special,
+searching it for glyphs not found in the selected font.
+.
+Without arguments,
+this list of special fonts is made empty.
+.
 .
 .TP
-.BI .spreadwarn\  limit
-Make
-.B troff
-emit a warning if the additional space inserted for each space between
-words in an output line is larger or equal to
+.BR .spreadwarn\~ \c
+.IR limit 
+Emit a
+.B break
+warning if the additional space inserted for each space between words in
+an output line adjusted to both margins with
+.RB \lq .ad\~b \rq
+is larger than or equal to
 .IR limit .
 .
-A negative value is changed to zero; no argument toggles the warning on
-and off without changing
+A negative value is treated as zero;
+an absent argument toggles the warning on and off without changing
 .IR limit .
 .
-The default scaling indicator is\~\c
+The default scaling unit is
 .BR m .
 .
 At startup,
 .B spreadwarn
-is deactivated, and
+is inactive and
 .I limit
-is set to 3m.
+is 3\~m.
+.
 .
+.IP
 For example,
-.B .spreadwarn\ 0.2m
+.RB \lq ".spreadwarn 0.2m" \rq
 causes a warning if
-.B troff
-must add 0.2m or more for each interword space in a line.
+.B break
+warnings are not suppressed and
+.I @g@troff
+must add 0.2\~m or more for each inter-word space in a line.
 .
-This request is active only if text is justified to both margins (using
-.BR .ad\ b ).
 .
 .TP
-.BI .sty\  n\ f
-Associate style\~\c
-.I f
-with font position\~\c
-.IR n .
-A font position can be associated either with a font or with a style.
-.
-The current font is the index of a font position and so is also either
-a font or a style.
-.
-When it is a style, the font that is actually used is the font the
-name of which is the concatenation of the name of the current family
-and the name of the current style.
-.
-For example, if the current font is\~1 and font position\~1 is
-associated with style\~\c
-.B R
-and the current font family is\~\c
-.BR T ,
-then font
-.B TR
-is used.
+.BI .stringdown \~str
+.TQ
+.BI .stringup \~str
+Alter the string named
+.I str
+by replacing each of its bytes with its
+lowercase
+.RB ( down )
+or uppercase
+.RB ( up )
+version
+(if one exists).
+.
+Special characters
+(see
+.MR groff_char @MAN7EXT@ )
+will often transform in the expected way due to the regular naming
+convention for accented characters.
 .
-If the current font is not a style, then the current family is ignored.
+When they do not,
+use substrings and/or catenation.
 .
-When the requests
-.BR cs ,
-.BR bd ,
-.BR tkf ,
-.BR uf ,
-or
-.B fspecial
-are applied to a style, then they are applied instead to the
-member of the current family corresponding to that style.
 .
-The default family can be set with the
-.B \-f
-command-line option.
+.IP
+.RS
+.RS
+.EX
+.B .ds resume R\e\aqesum\e\aqe\e"
+.B \e*resume
+.B .stringdown resume
+.B \e*resume
+.B .stringup resume
+.B \e*resume
+R\'esum\'e r\'esum\'e R\'ESUM\'E
+.EE
+.RE
+.RE
 .
-The
-.B styles
-command in the
-DESC
-file controls which font positions (if any) are initially associated
-with styles rather than fonts.
 .
 .TP
-.BI .substring\  xx\ n1\   n2 
+.BI .sty\~ n\~s
+Associate abstract
+.RI style\~ s
+with font mounting
+.RI position\~ n .
+.
+.
+.TP
+.BI .substring\~ "string start\~"\c
+.RI  end 
 Replace the string named
-.I xx
-with the substring defined by the indices
-.I n1
+.I string
+with its substring bounded by the indices
+.I start
 and
-.IR n2 .
+.IR end ,
+inclusively.
+.
 The first character in the string has index\~0.
 .
 If
-.I n2
-is omitted, it is taken to be equal to the string's length.
+.I end
+is omitted,
+it is implicitly set to the largest valid value
+(the string length minus one).
+.
+Negative indices count backwards from the end of the string:
+the last character has index\~\-1,
+the character before the last has index\~\-2,
+and so on.
 .
-If the index value
-.I n1
-or
-.I n2
-is negative, it is counted from the end of the string,
-going backwards:
 .
-The last character has index\~\-1, the character before the last
-character has index\~\-2, etc.
+.RS
+.IP
+.EX
+.B .ds xxx abcdefgh
+.B .substring xxx 1 \-4
+.B \e*xxx
+bcde
+.B .substring xxx 2
+.B \e*xxx
+de
+.EE
+.RE
+.
 .
 .TP
-.BI .tkf\  f\ s1\ n1\ s2\ n2
+.BI .tkf\~ f\~s1\~n1\~s2\~n2
 Enable track kerning for font\~\c
 .IR f .
 When the current font is\~\c
@@ -2249,7 +3647,7 @@
 .I n1
 and
 .IR n2 ;
-when the current point size is less than or equal to
+when the current type size is less than or equal to
 .I s1
 the width is increased by
 .IR n1 ;
@@ -2257,45 +3655,61 @@
 .I s2
 the width is increased by
 .IR n2 ;
-when the point size is greater than or equal to
+when the type size is greater than or equal to
 .I s1
 and less than or equal to
 .I s2
-the increase in width is a linear function of the point size.
+the increase in width is a linear function of the type size.
+.
 .
 .TP
-.BI .tm1\  string
-Similar to the
+.BI .tm1\~ message
+As
 .B tm
 request,
-.I string
-is read in copy mode and written on the standard error, but an initial
-double quote in
-.I string
-is stripped off to allow initial blanks.
+but strips a leading neutral double quote from
+.I message
+to allow the embedding of leading spaces.
+.
 .
 .TP
-.BI .tmc\  string
-Similar to
+.BI .tmc\~ message
+As
 .B tm1
-but without writing a final newline.
+request,
+but does not append a newline.
+.
 .
 .TP
-.BI .trf\  filename
+.BI .trf\~ file
 Transparently output the contents of file
-.IR filename .
+.IR file .
+.
 Each line is output as if preceded by
 .BR \rs! ;
-however, the lines are not subject to copy-mode interpretation.
+however,
+the lines are not subject to copy-mode interpretation.
+.
+If the file does not end with a newline,
+then a newline is added.
+.
+Unlike
+.BR cf ,
+.I file
+cannot contain characters
+that are invalid as input to GNU
+.IR troff . \" GNU
 .
-If the file does not end with a newline, then a newline is added.
 .
-For example, you can define a macro\~\c
+.IP
+For example,
+you can define a macro\~\c
 .I x
 containing the contents of file\~\c
 .IR f ,
 using
 .
+.
 .RS
 .IP
 .ne 2v+\n(.Vu
@@ -2306,23 +3720,20 @@
 .EE
 .RE
 .
-.IP
-Unlike with the
-.B cf
-request, the file cannot contain characters, such as NUL,
-that are not valid troff input characters.
 .
 .TP
-.BI .trin\  abcd
+.BI .trin\~ abcd
 This is the same as the
 .B tr
 request except that the
 .B asciify
-request uses the character code (if any) before the character
-translation.
+request uses the character code
+(if any)
+before the character translation.
 .
 Example:
 .
+.
 .RS
 .IP
 .EX
@@ -2338,17 +3749,17 @@
 .EE
 .RE
 .
+.
 .IP
-The result is
-.BR x\ a .
+The result is \lqx\~a\rq.
 .
 Using
 .BR tr ,
-the result would be
-.BR x\ x .
+the result would be \lqx\~x\rq.
+.
 .
 .TP
-.BI .trnt\  abcd
+.BI .trnt\~ abcd
 This is the same as the
 .B tr
 request except that the translations do not apply to text that is
@@ -2356,6 +3767,7 @@
 .BR \rs! .
 For example,
 .
+.
 .RS
 .IP
 .EX
@@ -2367,6 +3779,7 @@
 .EE
 .RE
 .
+.
 .IP
 prints\~\c
 .BR b ;
@@ -2376,306 +3789,362 @@
 .B tr
 it prints\~\c
 .BR a .
-.RE
+.
 .
 .TP
 .B .troff
 Make the
-.B n
-built-in condition false, and the
 .B t
-built-in condition true.
+conditional expression evaluate true and
+.B n
+false.
+.
+See
+.BR nroff .
 .
-This undoes the effect of the
-.B nroff
-request.
 .
 .TP
-.BI .unformat\  xx
-This request \oqunformats\cq the diversion
-.IR xx .
+.BI .unformat\~ div
+Unformat the diversion
+.IR div .
 .
-Contrary to the
-.B asciify
-request, which tries to convert formatted elements of the diversion
-back to input tokens as much as possible,
-.B .unformat
-only handles tabs and spaces between words (usually caused by spaces
-or newlines in the input) specially.
+Unlike
+.BR asciify ,
+.B unformat
+handles only tabs and spaces between words,
+the latter usually arising from spaces or newlines in the input.
 .
-The former are treated as if they were input tokens, and the latter
-are stretchable again.
+Tabs are treated as input tokens,
+and spaces become adjustable again.
 .
-Note that the vertical size of lines is not preserved.
+The vertical sizes of lines are not preserved,
+but glyph information
+(font,
+type size,
+space width,
+and so on)
+is retained.
 .
-Glyph information (font, font size, space width, etc.) is retained.
-.
-Useful in conjunction with the
-.B box
-and
-.B boxa
-requests.
 .
 .TP
-.BI .vpt\  n
-Enable vertical position traps if
+.BI .vpt\~ n
+If
 .I n
-is non-zero, disable them otherwise.
-.
-Vertical position traps are traps set by the
-.B wh
-or
+is non-zero or missing,
+enable vertical position traps
+(the default),
+otherwise disable them.
+.
+Vertical position traps are those set by the
+.BR ch ,
+.BR wh ,
+and
 .B dt
 requests.
 .
-Traps set by the
-.B it
-request are not vertical position traps.
-.
-The parameter that controls whether vertical position traps are
-enabled is global.
-.
-Initially vertical position traps are enabled.
 .
 .TP
-.BI .warn\  n
-Control warnings.
-.IR n \~\c
-is the sum of the numbers associated with each warning that is to be
-enabled; all other warnings are disabled.
-.
-The number associated with each warning is listed in
-.BR @g@troff (@MAN1EXT@).
+.BR .warn\~ \c
+.IR n 
+Select the categories,
+or \lqtypes\rq,
+of reported warnings.
+.
+.IR n \~is
+the sum of the numeric codes associated with each warning category that
+is to be enabled;
+all other categories are disabled.
+.
+The categories and their associated codes are listed in section
+\lqWarnings\rq of
+.MR @g@troff @MAN1EXT@ .
+.\" TODO: Maybe move that table to groff(7).
 .
 For example,
-.B .warn\~0
-disables all warnings, and
-.B .warn\~1
-disables all warnings except that about missing glyphs.
+.RB \lq ".warn 0" \rq
+disables all warnings,
+and
+.RB \lq ".warn 1" \rq
+disables all warnings except those about missing glyphs.
+.
+If no argument is given,
+all warning categories are enabled.
 .
-If
-.I n
-is not given, all warnings are enabled.
 .
 .TP
-.BI .warnscale\  si
-Set the scaling indicator used in warnings to
+.BI .warnscale\~ si
+Set the scaling unit used in warnings to
 .IR si .
 .
 Valid values for
 .I si
 are
 .BR u ,
-.BR i ,
+.B i
+(the default),
 .BR c ,
 .BR p ,
-and\~\c
-.BR P .
+.RB and\~ P .
 .
-At startup, it is set to\~\c
-.BR i .
 .
 .TP
-.BI .while \ c\ anything
-While condition\~\c
-.I c
-is true, accept
-.I anything
-as input;
-.IR c \~\c
-can be any condition acceptable to an
-.B if
-request;
+.BI .while \~cond-expr\~anything
+Evaluate the conditional expression
+.IR cond-expr ,
+and repeatedly execute
 .I anything
-can comprise multiple lines if the first line starts with
-.B \rs{
-and the last line ends with
-.BR \rs} .
-See also the
+unless and until
+.I cond-expr
+evaluates false.
+.
+.I anything,
+which is often a conditional block,
+is referred to as the
+.B while
+request's
+.I body.
+.
+.
+.IP
+.I @g@troff
+treats the body of a
+.B while
+request similarly to that of a
+.B de
+request
+(albeit one not read in copy mode),
+but stores it under an internal name and deletes it when the loop
+finishes.
+.
+The operation of a macro containing a
+.B while
+request can slow significantly if the
+.B while
+body is large.
+.
+Each time the macro is executed,
+the
+.B while
+body is parsed and stored again.
+.
+An often better solution\emand one that is more portable,
+since AT&T
+.I troff \" AT&T
+lacked the
+.B while
+request\emis to instead write a recursive macro.
+.
+It will be parsed only once (unless you redefine it).
+.
+To prevent infinite loops,
+the default number of available recursion levels is 1,000 or somewhat
+less (because things other than macro calls can be on the input stack).
+.
+You can disable this protective measure,
+or raise the limit,
+by setting the
+.B slimit
+register.
+.
+See section \lqDebugging\rq below.
+.
+.
+.IP
+If a
+.B while
+body begins with a conditional block,
+its closing brace must end an input line.
+.
+.
+.IP
+The
 .B break
 and
 .B continue
-requests.
+requests alter a
+.B while
+loop's flow of control.
+.
 .
 .TP
-.BI .write\  stream\ anything
+.BI .write\~ stream\~anything
 Write
 .I anything
-to the stream named
-.IR stream .
-.I stream
-must previously have been the subject of an
+to
+.IR stream ,
+which must previously have been the subject of an
 .B open
-request.
+request,
+followed by a newline.
+.
 .I anything
-is read in copy mode;
-a leading\~\c
-.B \dq
-is stripped.
+is read in copy mode.
+.
+An initial neutral double quote in
+.I anything
+is stripped to allow the embedding of leading spaces.
+.
 .
 .TP
-.BI .writec\  stream\ anything
-Similar to
-.B write
-but without writing a final newline.
+.BI .writec\~ stream\~anything
+As
+.BR write ,
+but without a trailing newline.
+.
 .
 .TP
-.BI .writem\  stream\ xx
+.BI .writem\~ "stream name"
 Write the contents of the macro or string
-.I xx
-to the stream named
-.IR stream .
-.I stream
-must previously have been the subject of an
+.I name
+to
+.IR stream ,
+which must previously have been the subject of an
 .B open
 request.
-.I xx
+.
+.I name
 is read in copy mode.
 .
 .
+.br
+.ne 6v
 .\" ====================================================================
-.SS "Extended escape sequences"
+.SS "Extended requests"
 .\" ====================================================================
 .
+.\" XXX: .cf might better belong in "Implementation differences".
 .TP
-.BR \rsD' \*ellipsis '
-All drawing commands of groff's intermediate output are accepted.
-.
-See subsection \lqDrawing Commands\rq below.
+.BI .cf\~ file
+In a diversion,
+embed an object which,
+when reread,
+will cause the contents of
+.I file
+to be copied verbatim to the output.
 .
+In AT&T
+.IR troff ,
+the contents of
+.I file
+are immediately copied to the output regardless of whether a diversion
+is being written to;
+this behavior is so anomalous that it must be considered a bug.
 .
-.\" ====================================================================
-.SS "Extended requests"
-.\" ====================================================================
 .
 .TP
-.BI .cf\  filename
-When used in a diversion, this embeds in the diversion an object
-which, when reread, will cause the contents of
-.I filename
-to be transparently copied through to the output.
-.
-In Unix troff, the contents of
-.I filename
-is immediately copied through to the output regardless of whether
-there is a current diversion; this behaviour is so anomalous that it
-must be considered a bug.
-.
-.TP
-.BI .de\  xx\ yy
-.TQ
-.BI .am\  xx\ yy
-.TQ
-.BI .ds\  xx\ yy
-.TQ
-.BI .as\  xx\ yy
-In compatibility mode, these requests behaves similar to
-.BR .de1 ,
-.BR .am1 ,
-.BR .ds1 ,
-and
-.BR .as1 ,
-respectively: A \oqcompatibility save\cq token is inserted at the
-beginning, and a \oqcompatibility restore\cq token at the end,
+.BI .de\~ name\~\c
+.RI  end-name 
+.TQ
+.BI .am\~ name\~\c
+.RI  end-name 
+.TQ
+.BI .ds\~ name\~\c
+.RI  contents 
+.TQ
+.BI .as\~ name\~\c
+.RI  contents 
+In compatibility mode,
+these requests behave similarly to
+.BR de1 ,
+.BR am1 ,
+.BR ds1 ,
+and
+.BR as1 ,
+respectively:
+a \lqcompatibility save\rq token is inserted at the beginning,
+and a \lqcompatibility restore\rq token at the end,
 with compatibility mode switched on during execution.
 .
+.
 .TP
-.BI .ev\  xx
-If
-.I xx
-is not a number, this switches to a named environment called
-.IR xx .
-The environment should be popped with a matching
-.B ev
-request without any arguments, just as for numbered environments.
+.BI .hy\~ n
+New values 16 and\~32 are available;
+the former enables hyphenation before the last character in a word,
+and the latter enables hyphenation after the first character in a word.
 .
-There is no limit on the number of named environments; they are
-created the first time that they are referenced.
 .
 .TP
-.BI .hy\  n
-New additive values 16 and\~32 are available; the former enables
-hyphenation before the last character, the latter enables hyphenation
-after the first character.
+.BI .ss\~ word-space-size\~\c
+.RI  additional-sentence-space-size 
+A second argument sets the amount of additional space separating
+sentences on the same output line.
 .
-.TP
-.BI .ss\  m\ n
-When two arguments are given to the
-.B ss
-request, the second argument gives the
-.IR "sentence space size" .
-If the second argument is not given, the sentence space size
-is the same as the word space size.
-.
-Like the word space size, the sentence space is in units of
-one twelfth of the spacewidth parameter for the current font.
-.
-Initially both the word space size and the sentence
-space size are\~12.
-.
-Contrary to Unix troff, GNU troff handles this request in nroff mode
-also; a given value is then rounded down to the nearest multiple
-of\~12.
-.
-The sentence space size is used in two circumstances.
-.
-If the end of a sentence occurs at the end of a line in fill mode,
-then both an inter-word space and a sentence space are added; if
-two spaces follow the end of a sentence in the middle of a line, then
-the second space is a sentence space.
+If omitted,
+this amount is set to
+.IR word-space-size .
 .
-Note that the behaviour of Unix troff is exactly that exhibited
-by GNU troff if a second argument is never given to the
-.B ss
-request.
+Both arguments are in twelfths of current font's space width
+(typically one-fourth to one-third em for Western scripts;
+see
+.MR groff_font @MAN5EXT@ ).
+.
+The default for both parameters is\~12.
+.
+Negative values are erroneous.
 .
-In GNU troff, as in Unix troff, you should always follow a sentence
-with either a newline or two spaces.
 .
 .TP
-.BI .ta\  "n1 n2 \*ellipsis nn " "T " "r1 r2 \*ellipsis rn"
-Set tabs at positions
+.BR .ta\~ \c
+.IR "n1 n2\~" .\|.\|.\~ nn \~\c
+.BR T \~\c \" space in roman because we must use 2-font macro with \c
+.IR "r1 r2\~" .\|.\|.\~ rn 
+.I groff
+supports an extended syntax to specify repeating tab stops after
+the
+.RB \lq T \rq
+mark.
+.
+These values are always taken as relative distances from the previous
+tab stop.
+.
+This is the idiomatic way to specify tab stops at equal intervals in
+.IR groff .
+.
+.
+.IP
+The syntax summary above instructs
+.I groff
+to set tabs at positions
 .IR n1 ,
 .IR n2 ,
-.IR \*ellipsis ,
-.I nn
-and then set tabs at
+\&.\|.\|.\|,
+.IR nn ,
+then at
 .IR nn \|+\| r1 ,
 .IR nn \|+\| r2 ,
-.IR \*ellipsis ,
-.IR nn \|+\| rn
-and then at
+\&.\|.\|.\|,
+.IR nn \|+\| rn ,
+then at
 .IR nn \|+\| rn \|+\| r1 ,
 .IR nn \|+\| rn \|+\| r2 ,
-.IR \*ellipsis ,
+\&.\|.\|.\|,
 .IR nn \|+\| rn \|+\| rn ,
 and so on.
-For example,
-.
-.RS
-.IP
-.EX
-\&.ta T .5i
-.EE
-.
-.P
-sets tabs every half an inch.
-.RE
 .
 .
 .\" ====================================================================
-.SS "New number registers"
+.SS "New registers"
 .\" ====================================================================
 .
-The following read-only registers are available:
+GNU
+.I troff \" GNU
+exposes more formatter state via many new read-only registers.
 .
-.TP
+Their names often correspond to the requests that affect them.
+.
+.
+.TP 12n
 .B \rsn.br
-Within a macro call, it is set to\~1 if the macro is called with the
-\oqnormal\cq control character (\oq.\cq by default), and set
-to\~0 otherwise.
+Within a macro call,
+interpolate\~1
+if the macro is called with the \lqnormal\rq control character
+(\lq.\rq by default),
+and\~0 otherwise.
+.
+This facility allows the reliable modification of requests.
+.
+Using this register outside of a macro definition makes no sense.
 .
-This allows the reliable modification of requests.
 .
 .RS
 .IP
@@ -2685,321 +4154,423 @@
 \&.de bp
 \&.tm before bp
 \&.ie \rs\rsn.br .bp*orig
-\&.el 'bp*orig
+\&.el \aqbp*orig
 \&.tm after bp
 \&..
 .EE
 .RE
 .
-.IP
-Using this register outside of a macro makes no sense (it always returns
-zero in such cases).
 .
 .TP
 .B \rsn.C
-1\~if compatibility mode is in effect, 0\~otherwise.
+Interpolate 1\~if compatibility mode is in effect,
+0\~otherwise.
+.
+See
+.BR cp .
+.
 .
 .TP
 .B \rsn.cdp
-The depth of the last glyph added to the current environment.
+Interpolate depth of last glyph added to the environment.
 .
 It is positive if the glyph extends below the baseline.
 .
+.
 .TP
 .B \rsn.ce
-The number of lines remaining to be centered, as set by the
-.B ce
-request.
+Interpolate number of input lines remaining to be centered.
+.
 .
 .TP
 .B \rsn.cht
-The height of the last glyph added to the current environment.
+Interpolate height of last glyph added to the environment.
 .
 It is positive if the glyph extends above the baseline.
 .
+.
 .TP
 .B \rsn.color
-1\~if colors are enabled, 0\~otherwise.
+Interpolate 1\~if colors are enabled,
+0\~otherwise.
+.
+.
+.TP
+.B \rsn.cp
+Within a
+.RB \lq do \rq
+request,
+interpolate the saved value of compatibility mode
+(see
+.B \rsn.C
+above).
+.
 .
 .TP
 .B \rsn.csk
-The skew of the last glyph added to the current environment.
+Interpolate skew of last glyph added to the environment.
 .
 The
 .I skew
-of a glyph is how far to the right of the center of a glyph
-the center of an accent over that glyph should be placed.
+of a glyph is how far to the right of the center of a glyph the center
+of an accent over that glyph should be placed.
+.
 .
 .TP
 .B \rsn.ev
-The name or number of the current environment.
+Interpolate name of current environment.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.fam
-The current font family.
+Interpolate name of default font family.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.fn
-The current (internal) real font name.
+Interpolate resolved name of the selected font.
 .
 This is a string-valued register.
 .
-If the current font is a style, the value of
-.B \rsn.fn
-is the proper concatenation of family and style name.
 .
 .TP
 .B \rsn.fp
-The number of the next free font position.
+Interpolate next free font mounting position.
+.
 .
 .TP
 .B \rsn.g
-Always\~1.
+Interpolate\~1.
+.
+Test with
+.RB \lq\| if \|\rq
+or
+.B ie
+to check whether GNU
+.I troff \" GNU
+is the formatter.
 .
-Macros should use this to determine whether they are running under GNU
-troff.
 .
 .TP
 .B \rsn.height
-The current height of the font as set with
+Interpolate font height.
+.
+See
 .BR \rsH .
 .
+.
 .TP
 .B \rsn.hla
-The current hyphenation language as set by the
-.B hla
-request.
+Interpolate hyphenation language of the environment.
+.
+This is a string-valued register.
+.
 .
 .TP
 .B \rsn.hlc
-The number of immediately preceding consecutive hyphenated lines.
+Interpolate count of immediately preceding consecutive hyphenated lines
+in the environment.
+.
 .
 .TP
 .B \rsn.hlm
-The maximum allowed number of consecutive hyphenated lines, as set by
-the
-.B hlm
-request.
+Interpolate maximum number of consecutive hyphenated lines allowed in
+the environment.
+.
 .
 .TP
 .B \rsn.hy
-The current hyphenation flags (as set by the
-.B hy
-request).
+Interpolate hyphenation mode of the environment.
+.
 .
 .TP
 .B \rsn.hym
-The current hyphenation margin (as set by the
-.B hym
-request).
+Inteprolate hyphenation margin of the environment.
+.
 .
 .TP
 .B \rsn.hys
-The current hyphenation space (as set by the
-.B hys
-request).
+Interpolate hyphenation space adjustment threshold of the environment.
+.
 .
 .TP
 .B \rsn.in
-The indentation that applies to the current output line.
+Interpolate indentation amount applicable to the pending output line.
+.
 .
 .TP
 .B \rsn.int
-Set to a positive value if last output line is interrupted (i.e., if
-it contains
-.BR \rsc ).
+Interpolate\~1 if the previous output line was interrupted
+(ended with
+.BR \rsc ),
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.kern
-1\~if pairwise kerning is enabled, 0\~otherwise.
+Interpolate\~1 if pairwise kerning is enabled,
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.lg
-The current ligature mode (as set by the
-.B lg
-request).
+Interpolate ligature mode.
+.
 .
 .TP
 .B \rsn.linetabs
-The current line-tabs mode (as set by the
-.B linetabs
-request).
+Interpolate\~1 if line-tabs mode is enabled,
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.ll
-The line length that applies to the current output line.
+Interpolate line length applicable to the pending output line.
+.
 .
 .TP
 .B \rsn.lt
-The title length as set by the
-.B lt
-request.
+Interpolate title line length.
+.
 .
 .TP
 .B \rsn.m
-The name of the current drawing color.
+Interpolate name of the selected stroke color.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.M
-The name of the current background color.
+Interpolate name of the selected fill color.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.ne
-The amount of space that was needed in the last
+Interpolate amount of space demanded by the most recent
 .B ne
-request that caused a trap to be sprung.
+request that caused a page location trap to be sprung.
+.
+See
+.BR \rsn.trunc .
+.
+.
+.TP
+.B \rsn.nm
+Interpolate\~1 if output line numbering is enabled
+(even if temporarily suppressed),
+0\~otherwise.
 .
-Useful in conjunction with the
-.B \rsn.trunc
-register.
 .
 .TP
 .B \rsn.ns
-1\~if no-space mode is active, 0\~otherwise.
+Interpolate\~1 if no-space mode is enabled,
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.O
-The current output level as set with
+Interpolate output suppression level.
+.
+See
 .BR \rsO .
 .
+.
 .TP
 .B \rsn.P
-1\~if the current page is in the output list set with
-.BR \-o .
+Interpolate\~1 if the current page is selected for output.
+.
+See
+.B \-o
+command-line option to
+.MR @g@troff @MAN1EXT@ .
+.
 .
 .TP
 .B \rsn.pe
-1\~during a page ejection caused by the
-.B bp
-request, 0\~otherwise.
+Interpolate\~1 during page ejection,
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.pn
-The number of the next page, either the value set by a
-.B pn
-request, or the number of the current page plus\~1.
+Interpolate next page number
+(either that set by
+.BR pn ,
+or that of the current page plus\~1).
+.
 .
 .TP
 .B \rsn.ps
-The current point size in scaled points.
+Interpolate type size in scaled points.
+.
 .
 .TP
 .B \rsn.psr
-The last-requested point size in scaled points.
+Interpolate most recently requested type size in scaled points.
+.
 .
 .TP
 .B \rsn.pvs
-The current post-vertical line space as set with the
-.B pvs
-request.
+Interpolate post-vertical line spacing amount.
+.
 .
 .TP
 .B \rsn.rj
-The number of lines to be right-justified as set by the
-.B rj
-request.
+Interpolate number of input lines remaining to be right-aligned.
+.
 .
 .TP
 .B \rsn.slant
-The slant of the current font as set with
+Interpolate font slant.
+.
+See
 .BR \rsS .
 .
+.
 .TP
 .B \rsn.sr
-The last requested point size in points as a decimal fraction.
+Interpolate most recently requested type size in points as a decimal
+fraction.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.ss
 .TQ
 .B \rsn.sss
-These give the values of the parameters set by the first and second
-arguments of the
-.B ss
-request.
+Interpolate values of minimal inter-word space and additional
+inter-sentence space,
+respectively,
+in twelfths of the space width of the selected font.
+.
 .
 .TP
 .B \rsn.sty
-The current font style.
+Interpolate selected abstract font style,
+if any.
 .
 This is a string-valued register.
 .
+.
 .TP
 .B \rsn.tabs
-A string representation of the current tab settings suitable for use
-as an argument to the
+Interpolate representation of the tab stop settings in a form suitable
+for passage to the
 .B ta
 request.
 .
+.
 .TP
 .B \rsn.trunc
-The amount of vertical space truncated by the most recently sprung
-vertical position trap, or, if the trap was sprung by an
+Interpolate amount of vertical space truncated by the most recently
+sprung page location trap,
+or,
+if the trap was sprung by an
 .B ne
-request, minus the amount of vertical motion produced by the
+request,
+minus the amount of vertical motion produced by the
 .B ne
 request.
 .
-In other words, at the point a trap is sprung, it represents the
-difference of what the vertical position would have been but for the
-trap, and what the vertical position actually is.
+In other words,
+at the point a trap is sprung,
+.B \rsn.trunc
+represents the difference of what the vertical position would have
+been but for the trap,
+and what the vertical position actually is.
+.
+See
+.BR \rsn.ne .
 .
-Useful in conjunction with the
-.B \rsn.ne
-register.
 .
 .TP
 .B \rsn.U
-Set to\~1 if in safer mode and to\~0 if in unsafe mode (as given with
-the
+Interpolate\~1 if in unsafe mode,
+0\~otherwise.
+.
+See
 .B \-U
-command-line option).
+command-line option to
+.MR @g@troff @MAN1EXT@ .
+.
 .
 .TP
 .B \rsn.vpt
-1\~if vertical position traps are enabled, 0\~otherwise.
+Interpolate\~1 if vertical position traps are enabled,
+0\~otherwise.
+.
 .
 .TP
 .B \rsn.warn
-The sum of the numbers associated with each of the currently enabled
-warnings.
+Interpolate warning mode.
+.
+See section \lqWarnings\rq of
+.MR @g@troff @MAN1EXT@ .
+.\" TODO: Maybe move that table to groff(7).
 .
-The number associated with each warning is listed in
-.BR @g@troff (@MAN1EXT@).
 .
 .TP
 .B \rsn.x
-The major version number.
+Interpolate major version number of the running
+.I @g@troff
+formatter.
 .
-For example, if the version number is 1.03, then
+For example,
+if the version number is 1.23.0,
+then
 .B \rsn.x
 contains\~1.
 .
+.
 .TP
 .B \rsn.y
-The minor version number.
+Interpolate minor version number of the running
+.I @g@troff
+formatter.
 .
-For example, if the version number is 1.03, then
+For example,
+if the version number is 1.23.0,
+then
 .B \rsn.y
-contains\~03.
+contains\~23.
+.
 .
 .TP
 .B \rsn.Y
-The revision number of groff.
+Interpolate revision number of the running
+.I @g@troff
+formatter.
+.
+For example,
+if the version number is 1.23.0,
+then
+.B \rsn.Y
+contains\~0.
+.
 .
 .TP
 .B \rsn.zoom
-The zoom value of the current font, in multiples of 1/1000th.
-Zero if no magnification.
+Interpolate magnification of font,
+in thousandths,
+or\~0 if magnification unused.
+.
+See
+.BR fzoom .
+.
+.
+.P
+The following (writable) registers are set by the
+.B psbb
+request.
+.
 .
 .TP
 .B \rsnllx
@@ -3009,790 +4580,1364 @@
 .B \rsnurx
 .TQ
 .B \rsnury
-These four read/\:write registers are set by the
-.B psbb
-request and contain the bounding box values (in PostScript units) of a
-given PostScript image.
+Interpolate the
+(upper,
+lower,
+left,
+right)
+bounding box values
+(in PostScript units) of the most recently processed PostScript image.
+.
 .
 .P
-The following read/\:write registers are set by the
+The following (writable) registers are set by the
 .B \rsw
-escape sequence:
+escape sequence.
 .
-.TP
+.
+.TP 8n
 .B \rsnrst
 .TQ
 .B \rsnrsb
-Like the
-.B st
+Like
+.B \rsnst
 and
-.B sb
-registers, but take account of the heights and depths of glyphs.
+.BR \rsnsb ,
+but taking account of the heights and depths of glyphs.
+.
+In other words,
+these registers store the highest and lowest vertical positions attained
+by the argument formatted by the
+.B \rsw
+escape sequence,
+doing what AT&T
+.I troff \" AT&T
+documented
+.B \rsnst
+and
+.B \rsnsb
+as doing.
+.
 .
 .TP
 .B \rsnssc
 The amount of horizontal space (possibly negative) that should be
 added to the last glyph before a subscript.
 .
+.
 .TP
 .B \rsnskw
 How far to right of the center of the last glyph in the
 .B \rsw
-argument, the center of an accent from a roman font should be placed
+argument,
+the center of an accent from a roman font should be placed
 over that glyph.
 .
+.
 .P
-Other available read/write number registers are:
+Other writable registers are as follows.
 .
-.TP
+Those relating to date and time are initialized using
+.MR localtime 3
+at formatter startup.
+.
+.
+.\" The `c.` register was documented in the January 1981 "Addendum to
+.\" the Nroff/Troff User's Manual" (presumably by Kernighan), and is
+.\" widely supported by descendants of his device-independent troff, but
+.\" appears to have been overlooked in his 1992 revision of CSTR #54.
+.TP 12n
 .B \rsnc.
-The current input line number.
+Interpolate input line number.
+.
 .B \rsn.c
-is a read-only alias to this register.
+is a read-only alias of this register.
+.
 .
 .TP
 .B \rsnhours
-The number of hours past midnight.
+Interpolate number of hours elapsed since midnight.
 .
-Initialized at start-up.
 .
 .TP
 .B \rsnhp
-The current horizontal position at input line.
+Interpolate horizontal position relative to that at the start of the
+input line.
+.
 .
+.br
+.ne 3v
 .TP
 .B \rsnlsn
 .TQ
 .B \rsnlss
-If there are leading spaces in an input line, these registers
-hold the number of leading spaces and the corresponding
-horizontal space, respectively.
+Interpolate count of leading spaces on input line and amount of
+corresponding horizontal motion,
+respectively.
+.
 .
 .TP
 .B \rsnminutes
-The number of minutes after the hour.
+Interpolate number of minutes elapsed in the hour.
 .
-Initialized at start-up.
 .
 .TP
 .B \rsnseconds
-The number of seconds after the minute.
+Interpolate number of seconds elapsed in the minute.
 .
-Initialized at start-up.
 .
 .TP
 .B \rsnsystat
-The return value of the system() function executed by the last
+Interpolate return value of
+.MR system 3
+function executed by most recent
 .B sy
 request.
 .
+.
 .TP
 .B \rsnslimit
-If greater than\~0, the maximum number of objects on the input stack.
-.
-If less than or equal to\~0, there is no limit on the number of
-objects on the input stack.
+Interpolates maximum quantity of objects on
+.IR @g@troff 's
+internal input stack
+(default: 1000).
+.
+If non-positive,
+there is no limit:
+recursion can continue until program memory is exhausted.
 .
-With no limit, recursion can continue until virtual memory is
-exhausted.
 .
 .TP
 .B \rsnyear
-The current year.
+Interpolate Gregorian year.
 .
-Note that the traditional
-.B troff
-number register
-.B \rsnyr
-is the current year minus 1900.
+AT&T
+.IR troff 's \" AT&T
+.B \rsyr
+interpolates the Gregorian year minus 1900.
 .
 .
 .\" ====================================================================
 .SS Miscellaneous
 .\" ====================================================================
 .
-.B @g@troff
-predefines a single (read/write) string-based register,
-.BR \rs*.T ,
-which contains the argument given to the
+GNU
+.I troff \" GNU
+predefines one string,
+.BR .T ,
+containing the argument given to the
 .B \-T
-command-line option, namely the current output device (for example,
-.I latin1
+command-line option,
+namely the output device
+(for example,
+.B pdf
 or
-.IR ascii ).
-Note that this is not the same as the (read-only) number register
-.B \rsn.T
-which is defined to be\~1 if
-.B troff
-is called with the
+.BR utf8 ).
+.
+The (read-only)
+.I register
+.B .T
+interpolates\~1 if GNU
+.I troff \" GNU
+is run with the
 .B \-T
-command-line option, and zero otherwise.
+command-line option,
+and 0\~otherwise.
 .
-This behaviour is different from Unix troff.
 .
 .P
-Fonts not listed in the
-DESC
-file are automatically mounted on the next available font position
-when they are referenced.
+A font not listed in the output device's
+.I DESC
+file's
+.B fonts
+directive is automatically mounted at the next available font position
+when it is selected.
 .
-If a font is to be mounted explicitly with the
+If you mount a font explicitly with the
 .B fp
-request on an unused font position, it should be mounted on the first
-unused font position, which can be found in the
-.B \rsn.fp
-register; although
-.B troff
-does not enforce this strictly, it does not allow a font to be mounted
-at a position whose number is much greater than that of any currently
-used position.
+request,
+you should do so on the first unused position,
+which can be found in the
+.B .fp
+register.
+.
 .
 .P
-Interpolating a string does not hide existing macro arguments.
+Unparameterized string interpolation does not conceal the arguments to a
+macro being interpreted.
 .
-Thus in a macro, a more efficient way of doing
+Thus,
+in a macro definition,
+the call of another macro with the existing argument list,
 .
-.IP
-.BI . xx\  \rs\rs$@
-.P
-is
+.RS
+.EX
+.BI . xx\~ \rs\rs$@
+.EE
+.RE
 .
-.IP
+is more efficiently done with
+.
+.RS
+.EX
 .BI \rs\rs* xx \rs\rs
+.EE
+.RE
 .
+(that is,
+with string interpolation).
+.
+The trailing backslashes prevent the final newline in the macro
+definition from being interpolated,
+potentially putting an unwanted blank line on the output.
+.
+See section \lqPunning Names\rq in
+.MR groff @MAN7EXT@ .
+.
+.
+.\" XXX: Is this really not an AT&T troff feature?
 .P
-If the font description file contains pairwise kerning information,
+If a font description file contains pairwise kerning information,
 glyphs from that font are kerned.
 .
-Kerning between two glyphs can be inhibited by placing a
+Kerning between two glyphs can be inhibited by placing a dummy character
 .B \rs&
 between them.
 .
-.P
-In a string comparison in a condition, characters that appear at
-different input levels to the first delimiter character are not
-recognized as the second or third delimiters.
 .
-This applies also to the
+.P
+GNU
+.I troff \" GNU
+keeps track of the nesting depth of escape sequence
+interpolations and other uses of delimiters,
+as in the
 .B tl
-request.
-.
-In a
-.B \rsw
-escape sequence, a character that appears at a different input level
-to the starting delimiter character is not recognized as the
-closing delimiter character.
-.
-The same is true for
-.BR \rsA ,
-.BR \rsb ,
-.BR \rsB ,
-.BR \rsC ,
-.BR \rsl ,
-.BR \rsL ,
-.BR \rso ,
-.BR \rsX ,
-and
-.BR \rsZ .
-.
-When decoding a macro or string argument that is delimited by double
-quotes, a character that appears at a different input level to the
-starting delimiter character is not recognized as the closing delimiter
-character.
+request and the output comparison operator
+(that is,
+input like
+.B \aqfoo\aqbar\aq
+as a conditional expression),
+so the only characters you need to avoid using as
+delimiters are those that appear in the arguments you input,
+not any that result from interpolation.
+.
+Typically,
+.B \aq
+works fine.
+.
+Use visible characters as delimiters in GNU
+.IR troff , \" GNU
+not \lqASCII\rq controls like BEL (Control+G).
 .
 The implementation of
 .B \rs$@
-ensures that the double quotes surrounding an argument appear at the
-same input level, which is different to the input level of the
-argument itself.
+ensures that the double quotes surrounding an argument appear at an
+interpolation depth different from that of the arguments themselves.
 .
-In a long escape name
+Similarly,
+in bracket-form escape sequences like
+.B \rsfZCMI,
+a right bracket
 .B 
-is not recognized as a closing delimiter except when it occurs at
-the same input level as the opening\~\c
-.BR  .
-.
-In compatibility mode, no attention is paid to the input-level.
-.
-.P
-There are some new types of condition:
-.
-.TP
-.BI .if\ r xxx
-True if there is a number register named
-.IR xxx .
-.
-.TP
-.BI .if\ d xxx
-True if there is a string, macro, diversion, or request named
-.IR xxx .
-.
-.TP
-.BI .if\ m xxx
-True if there is a color named
-.IR xxx .
-.
-.TP
-.BI .if\ c ch
-True if there is a character (or glyph)
-.I ch
-available;
-.I ch
-is either an ASCII character or a glyph (special character)
-.BI \rsN' xxx '\fR,
-.BI \rs( xx
-or
-.BI \rs xxx \fR;
-the condition is also true if
-.I ch
-has been defined by the
-.B char
-request.
+does not end the sequence unless it occurs at the same interpolation
+depth as the
+.RB opening\~  ,
+so input like
 .
-.TP
-.BI .if\ F f
-True if font\~\c
-.I f
-exists.
+.RS
+.EX
+\rsf\rs*my-family\rs*my-style
+.EE
+.RE
 .
-.BR f \~\c
-is handled as if it was opened with the
-.B ft
-request (this is, font translation and styles are applied), without
-actually mounting it.
+works as desired.
 .
-.TP
-.BI .if\ S s
-True if style\~\c
-.I s
-has been registered.
+In compatibility mode,
+no attention is paid to the interpolation depth.
 .
-Font translation is applied.
 .
 .P
-The
+In
+GNU
+.IR troff , \" GNU
+the
 .B tr
-request can now map characters onto
-.BR \rs\ti .
+request can map characters to the unbreakable space escape sequence
+.B \rs\ti
+as a special case
+.RB ( tr
+normally operates only on
+.IR characters ).
 .
-.P
-The space width emitted by the
-.B \rs|
-and
-.B \rs^
-escape sequences can be controlled on a per-font basis.
-If there is a glyph named
-.B \rs|
-or
-.BR \rs^ ,
-respectively (note the leading backslash), defined in the current font
-file, use this glyph's width instead of the default value.
+This feature replaces the odd-parity
+.B tr
+mapping trick used in AT&T
+.I troff \" AT&T
+documents,
+where a character,
+often
+.BR \ti ,
+was \lqsacrificed\rq by mapping it to \lqnothing\rq,
+drafting it into use as an unadjustable,
+unbreakable space.
+.
+(This feature was gratuitous even in early AT&T
+.I troff, \" AT&T
+which supported the
+.BI \rs space
+escape sequence by 1976.) \" see CSTR #54 of that year
+.
+Often,
+it makes more sense to use
+GNU
+.IR troff 's \" GNU
+.B \rs\ti
+escape sequence instead,
+which has been adopted by every other active
+.I troff
+implementation except that of Illumos,
+as well as by the
+.RI non -troff
+.IR mandoc .
 .
-.P
-It is now possible to have whitespace between the first and second dot
-(or the name of the ending macro) to end a macro definition.
+Translation of a character to
+.B \rs\ti
+is unnecessary.
 .
-Example:
 .
-.IP
-.ne 6v+\n(.Vu
+.P
+GNU
+.I troff \" GNU
+permits tabs and spaces after the first dot on a control line that ends
+a macro definition.
+.
+.RS
+.ne 5v+\n(.Vu
 .EX
 \&.if t \rs{\rs
-\&.  de bar
-\&.    nop Hello, I'm \oqbar\cq.
-\&.  .
+\&.\&  de bar
+\&.\&    nop Hello, I\aqm \aqbar\aq.
+\&.\&  .
 \&.\rs}
 .EE
+.RS
 .
 .
 .\" ====================================================================
-.SH "INTERMEDIATE OUTPUT FORMAT"
+.SH "Formatter output"
 .\" ====================================================================
 .
-This section describes the format output by GNU troff.
-.
-The output format used by GNU troff is very similar to that used
-by Unix device-independent troff.
+The page description language output by GNU
+.I troff \" GNU
+is modeled after that used by AT&T
+.I troff \" AT&T
+once the latter adopted a device-independent approach in the early
+1980s.
 .
 Only the differences are documented here.
 .
+For a fuller discussion,
+see
+.MR groff_out @MAN5EXT@ .
+.\"
+.\"
+.\" XXX: This feature is unused and documenting it gives a valuable
+.\" hostage to fortune.
+.\".P
+.\"Note that single characters can have the eighth bit set, as can the
+.\"names of fonts and special characters.
+.
+.
+.P
+Glyph and font names can be of arbitrary length;
+postprocessors should not assume that they are at most two characters.
+.
+A glyph to be formatted is always drawn from the current font;
+in contrast to AT&T device-independent
+.IR troff , \" AT&T
+drivers need not search special fonts to find a glyph.
+.
 .
 .\" ====================================================================
-.SS "Units"
+.SS Units
 .\" ====================================================================
 .
 The argument to the
-.BR s \~\c
-command is in scaled points (units of
+.BR s \~command
+is in scaled points
+(units of
 .RI points/ n ,
 where
 .I n
 is the argument to the
 .B sizescale
-command  in the DESC file).
+command in the
+.I DESC
+file).
 .
 The argument to the
-.B x\ Height
+.RB \lq "x H" \rq
 command is also in scaled points.
 .
 .
 .\" ====================================================================
-.SS "Text Commands"
+.SS "Simple commands"
 .\" ====================================================================
 .
-.TP
-.BI N n
-Print glyph with index\~\c
-.I n
-(a non-negative integer) of the current font.
-.
+.\" BEGIN Keep in sync with relevant portions of section "Simple
+.\" commands" from groff_out(5).
 .P
 If the
 .B tcommand
-line is present in the DESC file, troff uses the following two
-commands.
+directive is present in the output device's
+.I DESC
+file,
+GNU
+.I troff \" GNU
+employs the following two commands.
+.
 .
 .TP
-.BI t xxx
-.I xxx
-is any sequence of characters terminated by a space or a newline (to
-be more precise, it is a sequence of glyphs which are accessed with
-the corresponding characters); the first character should be printed at
-the current position, the current horizontal position should be
-increased by the width of the first character, and so on for each
-character.
+.BI t\~ xyz\c
+\&.\|.\|.
+Typeset word
+.IR xyz ;
+that is,
+set a sequence of ordinary glyphs named
+.IR x ,
+.IR y ,
+.IR z ,
+\&.\|.\|.\|,
+terminated by a space or newline;
+an optional second integer argument is ignored
+(this allows the formatter to generate an even number of arguments).
+.\" XXX: Why?
+.
+Each glyph is set at the current drawing position,
+and the position is then advanced horizontally by the glyph's width.
+.
+A glyph's width is read from its metrics in the font description file,
+scaled to the current type size,
+and rounded to a multiple of the horizontal motion quantum.
 .
-The width of the glyph is that given in the font file,
-appropriately scaled for the current point size, and rounded so that
-it is a multiple of the horizontal resolution.
+Use the
+.B C
+command to emplace glyphs of special characters.
 .
-Special characters cannot be printed using this command.
 .
 .TP
-.BI u n\ xxx
-This is same as the
-.BR t \~\c
-command except that after printing each character, the current
-horizontal position is increased by the sum of the width of that
-character and\~\c
-.IR n .
+.BI u\~ "n xyz"\c
+\&.\|.\|.
+Typeset word
+.I xyz
+with track kerning.
 .
-.P
-Note that single characters can have the eighth bit set, as can the
-names of fonts and special characters.
+As
+.BR t ,
+but after placing each glyph,
+the drawing position is further advanced horizontally
+.RI by\~ n
+basic units.
+.\" END Keep in sync with relevant portions of section "Simple commands"
+.\" from groff_out(5).
 .
-.P
-The names of glyphs and fonts can be of arbitrary length; drivers
-should not assume that they are only two characters long.
 .
 .P
-When a glyph is to be printed, that glyph is always
-in the current font.
+New commands implement color support.
 .
-Unlike device-independent troff, it is not necessary for drivers to
-search special fonts to find a glyph.
-.
-.P
-For color support, some new commands have been added:
 .
 .TP
-\fBmc \fIcyan magenta yellow\fR
+.BI mc\~ "cyan magenta yellow"
 .TQ
-\fBmd\fR
+.B md
 .TQ
-\fBmg \fIgray\fR
+.BI mg\~ gray
 .TQ
-\fBmk \fIcyan magenta yellow black\fR
+.BI mk\~ "cyan magenta yellow black"
 .TQ
-\fBmr \fIred green blue\fR
-Set the color components of the current drawing color, using various
-color schemes.
+.BI mr\~ "red green blue"
+Set the components of the stroke color with respect to various color
+spaces.
 .
 .B md
-resets the drawing color to the default value.
+resets the stroke color to the default value.
+.
+The arguments are integers in the range 0 to 65535.
 .
-The arguments are integers in the range 0 to 65536.
 .
 .P
-The
-.BR x \~\c
-device control command has been extended.
+A new device control subcommand is available.
+.
 .
 .TP
-\fBx u \fIn\fR
+.BI "x u\~" n
 If
 .I n
-is\~1, start underlining of spaces.
+is\~1,
+start underlining of spaces.
 .
 If
 .I n
-is\~0, stop underlining of spaces.
+is\~0,
+stop underlining of spaces.
 .
-This is needed for the
+This facility is needed for the
 .B cu
-request in nroff mode and is ignored otherwise.
+request in
+.I nroff \" mode
+mode and is ignored otherwise.
 .
 .
 .\" ====================================================================
-.SS "Drawing Commands"
+.SS "Extended drawing commands"
 .\" ====================================================================
 .
-The
-.B D
-drawing command has been extended.
-.
-These extensions are not used by GNU pic if the
+GNU
+.I pic \" GNU
+does not produce
+.I @g@troff
+escape sequences employing these extensions if its
 .B \-n
 option is given.
 .
+.
 .TP
-\fBDf \fIn\/\fR\*ic\rsn
-Set the shade of gray to be used for filling solid objects to
-.IR n ;
-.I n
-must be an integer between 0 and 1000, where 0 corresponds solid white
-and 1000 to solid black, and values in between correspond to
-intermediate shades of gray.
+.BI Df\~ n
+Set the shade of gray used to fill geometric objects to
+.IR n ,
+which must be an integer.
+.
+0 corresponds to white and 1000 to black.
+.
+A grayscale ramp spans the two.
 .
-This applies only to solid circles, solid ellipses and solid
-polygons.
+A value outside this range uses the stroke color as the fill color.
 .
-By default, a level of 1000 is used.
+The fill color is opaque.
 .
-Whatever color a solid object has, it should completely obscure
-everything beneath it.
+Normally the default is black,
+but some drivers may provide a way of changing this.
 .
-A value greater than 1000 or less than\~0 can also be used: this means
-fill with the shade of gray that is currently being used for lines and
-text.
+.B Df
+is obsolete since 2002, \" commit ea5a42d080, 2002-01-24
+superseded by
+.B DFg
+below.
 .
-Normally this is black, but some drivers may provide a way of
-changing this.
 .
 .IP
 The corresponding
-.BI \rsD'f \*ellipsis '
-command shouldn't be used since its argument is always rounded to an
-integer multiple of the horizontal resolution which can lead to
-surprising results.
+.B \rsD\aqf\^\aq
+escape sequence should not be used:
+its argument is rounded to an integer multiple of the horizontal motion
+quantum,
+which can limit the precision
+.RI of\~ n .
+.
 .
 .TP
-\fBDC \fI\/d\fR\*ic\rsn
-Draw a solid circle with a diameter of
+.BI DC\~ d
+Draw a filled circle of diameter
 .I d
-with the leftmost point at the current position.
+with its leftmost point at the drawing position.
+.
 .
 .TP
-\fBDE \fIdx dy\/\fR\*ic\rsn
-Draw a solid ellipse with a horizontal diameter of
-.I dx
-and a vertical diameter of
-.I dy
-with the leftmost point at the current position.
+.BI DE\~ "h v"
+Draw a filled ellipse,
+of horizontal axis
+.I h
+and vertical axis
+.IR v ,
+with its leftmost point at the drawing position.
+.
+.
+.br
+.ne 4v
 .EQ
 delim $$
 .EN
-.
 .TP
-\fBDp\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
-$dx sub n$ $dy sub n$\rsn
-Draw a polygon with, for $i = 1 ,..., n+1$, the
-.IR i -th
-vertex at the current position
+.\" `BR`, not `BI`, here, because eqn will take care of font changes.
+.BR Dp\~ "$dx sub 1 ~ dy sub 1 ~ ldots ~ dx sub n ~ dy sub n$"
+Draw a polygon with,
+for $i = 1 , ldots , n + 1$,
+its
+.IR i th
+vertex at the drawing position
+.
+$+ sum from { j = 1 } to { i - 1 } ( dx sub j , dy sub j )$.
 .
-$+ sum from j=1 to i-1 ( dx sub j , dy sub j )$.
+.\" The following is implied by the math above, but let's be kind.
+.I groff
+output drivers automatically close polygons,
+drawing a line from $( dx sub n , dy sub n )$ back to
+$( dx sub 1 , dy sub 1 )$.
+.
+The drawing position is left at the last
+.I specified
+vertex,
+but this may change in a future version of GNU
+.IR troff . \" GNU
+.
+Heirloom Doctools
+.IR troff , \" Heirloom
+like DWB
+.IR troff , \" DWB
+by default does not close the polygon.
+.
+In its
+.I groff
+compatibility mode,
+Heirloom closes the polygon but leaves the drawing position
+.IR unchanged \emthat
+is,
+at the polygon's
+.I initial
+drawing position.
+.
+.
+.IP
+At the moment,
+GNU
+.I pic \" GNU
+uses this command only to generate triangles and rectangles.
 .
-At the moment, GNU pic only uses this command to generate triangles
-and rectangles.
 .
 .TP
-\fBDP\fR $dx sub 1$ $dy sub 1$ $dx sub 2$ $dy sub 2$ $...$ \
-$dx sub n$ $dy sub n$\rsn
+.BR DP\~ "$dx sub 1 ~ dy sub 1 ~ ldots ~ dx sub n ~ dy sub n$"
+As
+.BR Dp ,
+but draw a filled rather than a stroked polygon.
 .
-Like
-.B Dp
-but draw a solid rather than outlined polygon.
 .
 .TP
-\fBDt \fIn\/\fR\*ic\rsn
-Set the current line thickness to
+.BI Dt\~ n
+Set the line thickness to
 .IR n \~\c
-machine units.
+basic units.
+.
+AT&T
+.I troff \" AT&T
+output drivers use a thickness proportional to the type size;
+this is the GNU
+.I troff \" GNU
+default.
+.
+A
+.RI negative\~ n
+requests this explicitly.
+.
+.RI An\~ n
+of zero selects the smallest available line thickness.
 .
-Traditionally Unix troff drivers use a line thickness proportional to
-the current point size; drivers should continue to do this if no
-.B Dt
-command has been given, or if a
-.B Dt
-command has been given with a negative value of\~\c
-.IR n .
-A zero value of\~\c
-.I n
-selects the smallest available line thickness.
 .
 .P
-A difficulty arises in how the current position should be changed after
+A difficulty arises in how the drawing position should be changed after
 the execution of these commands.
 .
-This is not of great importance since the code generated by GNU pic
-does not depend on this.
+This has little importance to most users,
+since the output of GNU
+.I grn \" GNU
+and
+.I pic \" GNU
+does not depend on it.
 .
 Given a drawing command of the form
-.IP
-\fB\rsD'\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
-$x sub n$ $y sub n$\fB'\fR
-.
-.P
+.BI D z
+$x sub 1 ~ y sub 1 ~ ldots ~ x sub n ~ y sub n$,
 where
-.I c
-is not one of
-.BR c ,
+.I z
+is not
+.B c
+or
 .BR e ,
-.BR l ,
-.BR a ,
-or\~\c
-.BR \ti ,
-Unix troff treats each of the $x sub i$ as a horizontal quantity,
-and each of the $y sub i$ as a vertical quantity and assumes that
-the width of the drawn object is $sum from i=1 to n x sub i$,
-and that the height is $sum from i=1 to n y sub i$.
+AT&T
+.I troff \" AT&T
+treats each $x sub i$ as a horizontal motion,
+each $y sub i$ as a vertical one,
+and therefore assumes that the width of the drawn object is
+$sum from { i = 1 } to n x sub i$,
+and its height is $sum from { i = 1 } to n y sub i$.
 .
-(The assumption about the height can be seen by examining the
+(Verify its assumption about height by examining the
 .B st
 and
 .B sb
-registers after using such a
-.BR D \~\c
-command in a
+registers after using such a drawing command in a
 .B \rsw
 escape sequence).
 .
-This rule also holds for all the original drawing commands with the
-exception of
-.BR De .
-For the sake of compatibility GNU troff also follows this rule, even
-though it produces an ugly result in the case of the
+For the sake of compatibility,
+GNU
+.I troff \" GNU
+also follows this rule,
+even though it frustrates extensions to the
+.B D
+command that set drawing parameters rather than rendering objects,
+producing ugly results in the case of
 .B Dt
 and
 .BR Df ,
-and, to a lesser extent,
-.B DE
-commands.
+or otherwise don't parameterize objects as a series of vertices,
+as with
+GNU
+.IR troff 's \" GNU
+filled ellipse,
+.BR DE .
 .
 Thus after executing a
-.BR D \~\c
-command of the form
-.IP
-\fBD\fIc\fR $x sub 1$ $y sub 1$ $x sub 2$ $y sub 2$ $...$ \
-$x sub n$ $y sub n$\rsn
+.BR D \~command
+of the form
+.BI D z
+$x sub 1 ~ y sub 1 ~ ldots ~ x sub n ~ y sub n$,
+the drawing position should be increased by
 .
-.P
-the current position should be increased by
+$( sum from { i = 1 } to n x sub i , sum from { i = 1 } to n y sub i )$.
+.EQ
+delim off
+.EN
+.
+In a future release,
+GNU
+.I troff \" GNU
+and its output drivers may abandon the application of this assumption to
+drawing commands not explicitly specified in the AT&T \lqTroff User's
+Manual\rq.
 .
-$( sum from i=1 to n x sub i , sum from i=1 to n y sub i )$.
 .
 .P
-Another set of extensions is
+Fill color selection is implemented with another set of extensions.
+.
 .
 .TP
-\fBDFc \fIcyan magenta yellow\fR\*ic\rsn
+.BI DFc\~ "cyan magenta yellow"
 .TQ
-\fBDFd\fR\*ic\rsn
+.B DFd
 .TQ
-\fBDFg \fIgray\/\fR\*ic\rsn
+.BI DFg\~ gray
 .TQ
-\fBDFk \fIcyan magenta yellow black\fR\*ic\rsn
+.BI DFk\~ "cyan magenta yellow black"
 .TQ
-\fBDFr \fIred green blue\fR\*ic\rsn
-Set the color components of the filling color similar to the
-.BR m \~\c
-commands above.
+.BI DFr\~ "red green blue"
+Set the components of the fill color as described under the
+.B \rsM
+escape sequence above.
 .
-.P
-The current position isn't changed by those colour commands
-(contrary to
-.BR Df ).
+.B DFd
+restores the device's default fill color.
+.
+The drawing position is not updated,
+in contrast to
+.BR Df .
 .
 .
 .\" ====================================================================
-.SS "Device Control Commands"
+.SS "Device control syntax extension"
 .\" ====================================================================
 .
-There is a continuation convention which permits the argument to the
-.B x\ X
-command to contain newlines: when outputting the argument to the
-.B x\ X
-command, GNU troff follows each newline in the argument with a
-.B +
-character (as usual, it terminates the entire argument with a
-newline); thus if the line after the line containing the
-.B x\ X
-command starts with
-.BR + ,
-then the newline ending the line containing the
-.B x\ X
-command should be treated as part of the argument to the
-.B x\ X
-command, the
-.B +
-should be ignored, and the part of the line following the
-.B +
-should be treated like the part of the line following the
-.B x\ X
+GNU
+.I troff \" GNU
+introduces a line continuation convention,
+permitting the argument to the
+.B x X
+command to contain newlines.
+.
+A newline in the input is transformed to the sequence
+.RI \lq newline\c
+.BR + \rq.
+.
+When interpreting an
+.B x X
+command,
+a postprocessor should therefore be prepared for a plus sign after a
+newline;
+if it occurs,
+preserve the newline,
+discard the plus sign,
+and continue to collect the input into the argument of the
+.B x X
 command.
 .
+A newline
+.I not
+followed by a plus sign terminates the
+.B x X
+command.
+.
+An application of this feature is the embedding of PostScript or PDF
+language command streams into
+.I troff \"
+output.
+.
+.
 .P
-The first three output commands are guaranteed to be:
-.IP
-.BI x\ T\  device
-.br
-.BI x\ res\  n\ h\ v
-.br
-.B x init
+GNU
+.I troff \" GNU
+guarantees that the first three output commands it emits are as follows.
+.
+.
+.P
+.RS
+.EX
+.RI x\~T\~ device
+.RI x\~res\~ n\~h\~v
+x init
+.EE
+.RE
 .
 .
+.br
+.ne 4v
 .\" ====================================================================
-.SH INCOMPATIBILITIES
+.SH Debugging
 .\" ====================================================================
 .
-In spite of the many extensions, groff has retained compatibility to
-classical troff to a large degree.
+In addition to AT&T
+.IR troff 's \" AT&T
+debugging features,
+GNU
+.I troff \" GNU
+emits more error diagnostics when syntactical or semantic nonsense is
+encountered and supports several warning categories;
+the output of these can be selected with
+.BR warn .
+.
+Also see the
+.BR \-E ,
+.BR \-w ,
+and
+.B \-W
+options of
+.MR @g@troff @MAN1EXT@ .
+.
+Backtraces can be automatically produced when errors or warnings occur
+(the
+.B \-b
+option of
+.MR @g@troff @MAN1EXT@ )
+or generated on demand
+.RB ( backtrace ).
+.
+.
+.P
+.I groff
+also adds more flexible diagnostic output requests
+.RB ( tmc
+and
+.BR tm1 ).
 .
-For the cases where the extensions lead to collisions, a special
-compatibility mode with the restricted, old functionality was created
-for groff.
+More aspects of formatter state can be examined with requests that write
+lists of
+defined registers
+.RB ( pnr ),
+environments
+.RB ( pev ),
+and page location traps
+.RB ( ptr )
+to the standard error stream.
 .
 .
 .\" ====================================================================
-.SS "Groff Language"
+.SH "Implementation differences"
 .\" ====================================================================
 .
-.I groff
-provides a
-.B compatibility mode
-that allows the processing of roff code written for classical
-.B troff
-or for other implementations of roff in a consistent way.
+.\" TODO: Resync with the node of this name in our Texinfo manual.
+GNU
+.IR troff 's \" GNU
+features sometimes cause incompatibilities with documents written
+assuming old implementations of
+.IR troff . \" generic
+.
+Some GNU extensions to
+.I troff \" generic
+are supported by other implementations.
+.
 .
 .P
-Compatibility mode can be turned on with the
-.B \-C
-command-line option, and turned on or off with the
-.B .cp
-request.
+When adjusting to both margins,
+AT&T
+.I troff \" AT&T
+at first adjusts spaces starting from the right;
+GNU
+.I troff \" GNU
+begins from the left.
+.
+Both implementations adjust spaces from opposite ends on alternating
+output lines to prevent \lqrivers\rq in the text.
 .
-The number register
-.B \rsn(.C
-is\~1 if compatibility mode is on, 0\~otherwise.
 .
 .P
-This became necessary because the GNU concept for long names causes
-some incompatibilities.
-.I Classical troff
-interprets
-.IP
-.B .dsabcd
+GNU
+.I troff \" GNU
+does not always hyphenate words as AT&T
+.I troff \" AT&T
+does.
+.
+The AT&T implementation uses a set of hard-coded rules specific to
+U.S.\& English,
+while GNU
+.I troff \" GNU
+uses language-specific hyphenation pattern files derived from \*tx.
+.
+In some versions of
+.I troff \" generic
+there was limited space to store hyphenation exceptions
+(arguments to the
+.B hw
+request);
+GNU
+.I troff \" GNU
+has no such restriction.
+.
 .
 .P
+Long names may be GNU
+.IR troff 's \" GNU
+most obvious innovation.
+.
+AT&T
+.I troff \" AT&T
+interprets
+.RB \lq .dsabcd \rq
 as defining a string
-.B ab
+.RB \lq ab \rq
 with contents
-.BR cd .
-In
-.I groff
-mode, this is considered as a call of a macro named
-.BR dsabcd .
+.RB \lq cd \rq.
 .
-.P
-Also
-.I classical troff
-interprets
+Normally,
+GNU
+.I troff \" GNU
+interprets this as a call of a macro named
+.RB \lq dsabcd \rq.
+.
+AT&T
+.I troff \" AT&T
+also interprets
 .B \rs*
-or
+and
 .B \rsn
-as references to a string or number register called\~\c
-.B 
-while
-.I groff
-takes this as the start of a long name.
+as an interpolation of a string or register,
+respectively,
+called
+.RB \lq  \rq.
+.
+In GNU
+.IR troff , \" GNU
+however,
+the
+.RB \lq  \rq
+is normally interpreted as beginning the enclosure of a long identifier.
+.
+In compatibility mode,
+GNU
+.I troff \" GNU
+interprets names in the traditional way,
+which means that they are limited to one or two characters.
+.
+See the
+.B \-C
+option in
+.MR @g@troff @MAN1EXT@
+and,
+above,
+the
+.B .C
+and
+.B .cp
+registers,
+and
+.B cp
+and
+.RB \lq do \rq
+requests,
+for more on compatibility mode.
+.
 .
 .P
-In
-.IR "compatibility mode" ,
-groff interprets these things in the traditional way; so long
-names are not recognized.
+The register
+.B \rsn.cp
+is specialized and may require a statement of rationale.
+.
+When writing macro packages or documents that use GNU
+.I troff \" GNU
+features and which may be mixed with other packages or documents that do
+not\emcommon scenarios include serial processing of man pages or use
+of the
+.RB \lq so \rq
+or
+.B mso
+requests\emyou may desire correct operation regardless of
+compatibility mode enablement in the surrounding context.
+.
+It may occur to you to save the existing value of
+.B \rsn(.C
+into a register,
+say,
+.BR _C ,
+at the beginning of your file,
+turn compatibility mode off with
+.RB \lq .cp\~0 \rq,
+then restore it from that register at the end with
+.RB \lq .cp\~\rsn(_C \rq.
+.
+At the same time,
+a modular design of a document or macro package may lead you to multiple
+layers of inclusion.
+.
+You cannot use the same register name everywhere lest you
+\lqclobber\rq the value from a preceding or enclosing context.
+.
+The two-character register name space of AT&T
+.I troff \" AT&T
+is confining and mnemonically challenging;
+you may wish to use
+GNU
+.IR troff 's \" GNU
+more capacious name space.
+.
+However,
+attempting
+.RB \lq ".nr _my_saved_C \rsn(.C" \rq
+will not work in compatibility mode;
+the register name is too long.
+.
+\lqThis is exactly what
+.B .do
+is for,\rq you think,
+.RB \lq ".do nr _my_saved_C \rsn(.C" \rq.
+.
+The foregoing will always save zero to your register,
+because
+.RB \lq do \rq
+turns compatibility mode
+.I off
+while it interprets its argument list.
+.
+What you need is:
+.
+.RS
+.EX
+\&.do nr _my_saved_C \rsn.cp
+\&.cp 0
+.EE
+.RE
+.
+at the beginning of your file,
+followed by
+.RS
+.EX
+\&.cp \rsn_my_saved_C
+\&.do rr _my_saved_C
+.EE
+.RE
+at the end.
+.
+As in the C language,
+we all have to share one big name space,
+so choose a register name that is unlikely to collide with other uses.
+.
 .
 .P
-On the other hand, groff in
-.I GNU native mode
-does not allow to use the single-character escapes
-.B \rs\rs
-(backslash),
-.B \rs|
-(vertical bar),
-.B \rs\ha
-(caret),
-.B \rs&
-(ampersand),
-.B \rs{
-(opening brace),
-.B \rs}
-(closing brace),
-.RB \oq \rs\  \cq
-(space),
-.B \rs\aq
-(single quote),
-.B \rs\ga
-(backquote),
-.B \rs\-
-(minus),
-.B \rs_
-(underline),
-.B \rs!\&
-(bang),
-.B \rs%
-(percent),
+The existence of the
+.B .T
+string is a common feature of post-CSTR\~#54
+.IR troff s\emDWB\~3.3, \" others
+Solaris,
+Heirloom Doctools,
+and Plan\~9
+.I troff \" foreign
+all support it\embut valid values are specific to each implementation.
+.
+The behavior of the
+.B .T
+register in GNU
+.I troff \" GNU
+differs from AT&T
+.IR troff , \" AT&T
+which interpolated\~1 only if
+.I nroff \" AT&T
+was the formatter and was called with
+.BR \-T .
+.
+.
+.P
+The
+.B lf
+request sets the number of the
+.I current
+input line in AT&T
+.IR troff ,\" AT&T
+and the
+.I next
+in GNU
+.IR troff .\" GNU
+.
+.
+.br
+.ne 2v
+.P
+AT&T
+.I troff
+had only environments named
+.RB \lq 0 \rq,
+.RB \lq 1 \rq,
 and
+.RB \lq 2 \rq.
+.
+In GNU
+.IR troff ,
+any number of environments may exist,
+using any valid identifiers for their names.
+.
+.
+.P
+GNU
+.I troff \" GNU
+normally tracks the interpolation depth of escape sequence parameters
+and other delimited structures,
+but not in compatibility mode.
+.
+See section \lqMiscellaneous\rq above.
+.
+.
+.P
+In compatibility mode,
+the escape sequences
+.BR \rsf ,
+.BR \rsH ,
+.BR \rsm ,
+.BR \rsM ,
+.BR \rsR ,
+.BR \rss ,
+and
+.B \rsS
+are transparent at the beginning of an input line for the purpose of
+recognizing a control character,
+because they modify formatter state
+.RB ( \rsR )
+or properties of the environment
+(the rest)
+and therefore do not create output nodes.
+.
+For example,
+this code produces bold output in both cases,
+but the text differs,
+.
+.RS
+.EX
+\&.de xx \aq
+Hello!
+\&..
+\&\rsfB.xx\rsfP
+.EE
+.RE
+.
+formatting \lq.xx\rq normally and \lqHello!\rq in compatibility
+mode.
+.
+.
+.P
+GNU
+.I troff \" GNU
+request names unrecognized by other
+.I troff \" generic
+implementations will likely be ignored;
+escape sequences that are GNU
+.I troff \" GNU
+extensions are liable to format their function selector character.
+.
+For example,
+the adjustable,
+non-breaking space escape sequence
+.B \rs\ti
+.\" BEGIN Keep in sync with groff.texi node "Other Differences" and
+.\" groff_man_style(7).
+is also supported by Heirloom Doctools
+.I troff \" Heirloom
+050915 (September 2005),
+.I mandoc
+1.9.5 (2009-09-21),
+.I neatroff
+(commit 1c6ab0f6e,
+2016-09-13),
+and Plan\~9 from User Space
+.I troff \" Plan 9
+(commit 93f8143600,
+2022-08-12),
+but not by Solaris/Illumos
+.IR troff s, \" Solaris/Illumos
+which will render it as
+.BR \ti .
+.\" as of this writing, 2022-08-13
+.\" END Keep in sync with groff.texi node "Other Differences" and
+.\" groff_man_style(7).
+.
+.
+.P
+GNU
+.I troff \" GNU
+does not allow the use of the escape sequences
+.BR \rs| ,
+.BR \rs\ha ,
+.BR \rs& ,
+.BR \rs{ ,
+.BR \rs} ,
+.BI \rs space\c
+,
+.BR \rs\aq ,
+.BR \rs\ga ,
+.BR \rs\- ,
+.BR \rs_ ,
+.BR \rs! ,
+.BR \rs% ,
+or
 .B \rsc
-(character\~c) in names of strings, macros, diversions, number
-registers, fonts or environments, whereas
-.I classical troff
+in identifiers;
+AT&T
+.I troff \" AT&T
 does.
 .
-.P
 The
 .B \rsA
-escape sequence can be helpful in avoiding these escape sequences in
-names.
+escape sequence
+(see subsection \lqEscape sequences\rq above)
+may be helpful in avoiding their use.
+.
 .
 .P
-Fractional point sizes cause one noteworthy incompatibility.
+Normally,
+the syntax form
+.BI \rss n
+accepts only a single character
+(a digit)
+for
+.IR n ,
+consistently with other forms that originated in AT&T
+.IR troff , \" AT&T
+like
+.BR \rs* ,
+.BR \rs$ ,
+.BR \rsf ,
+.BR \rsg ,
+.BR \rsk ,
+.BR \rsn ,
+and
+.BR \rsz .
 .
-In
-.I classical
-.IR troff ,
+In compatibility mode only,
+a
+.RI non-zero\~ n
+must be in the range 4\en39.
+.
+Legacy documents relying upon this quirk of parsing should be migrated
+to another
+.B \rss
+form.
+.
+Background:
+The Graphic Systems C/A/T phototypesetter
+(the original device target for AT&T
+.IR troff ) \" AT&T
+supported only a few discrete type sizes in the range 6\en36 points,
+so Ossanna contrived a special case in the parser to do what the user
+must have meant.
+.
+Kernighan warned of this in the 1992 revision of CSTR\~#54 (\sc2.3),
+and more recently,
+McIlroy referred to it as a \lqliving fossil\rq.
+.
+.
+.P
+Fractional type sizes cause one noteworthy incompatibility.
+.
+In AT&T
+.I troff \" AT&T
 the
 .B ps
-request ignores scale indicators and so
-.RS
+request ignores scaling units and thus
+.RB \lq .ps\~10u \rq
+sets the type size to 10\~points,
+whereas in GNU
+.I troff \" GNU
+it sets the type size to
+.RI 10\~ scaled
+points,
+which may be a much smaller measurement.
+.
+See subsection \lqFractional type sizes and new scaling units\rq
+above.
+.
+.
 .P
-.B .ps\~10u
-.RE
+The
+.B ab
+request differs from AT&T
+.IR troff : \" AT&T
+GNU
+.I troff \" GNU
+writes no message to the standard error stream if no arguments are
+given,
+and it exits with a failure status instead of a successful one.
+.
 .
 .P
-sets the point size to 10\~points, whereas in groff native mode the
-point size is set to 10\~scaled points.
+The
+.B bp
+request differs from AT&T
+.IR troff : \" AT&T
+GNU
+.I troff \" GNU
+does not accept a scaling unit on the argument,
+a page number;
+the former
+(somewhat uselessly)
+does.
+.
 .
 .P
-In
-.IR groff ,
-there is a fundamental difference between unformatted input
-characters, and formatted output characters (glyphs).
+In AT&T
+.I troff \" AT&T
+the
+.B pm
+request reports
+macro,
+string,
+and
+diversion
+sizes in units of 128-byte blocks,
+and an argument reduces the report to a sum of the above in the same
+units.
+.
+GNU
+.I troff \" GNU
+ignores any arguments and reports the sizes in bytes.
+.
 .
-Everything that affects how a glyph is output is
-stored with the glyph; once a glyph has been
-constructed it is unaffected by any subsequent requests that are
-executed, including the
+.P
+Unlike AT&T
+.IR troff , \" AT&T
+GNU
+.I troff \" GNU
+does not ignore the
+.B ss
+request if the output is a terminal device;
+instead,
+the values of minimum inter-word and additional inter-sentence space are
+each rounded down to the nearest multiple of\~12.
+.
+.
+.P
+In GNU
+.I troff \" GNU
+there is a fundamental difference between (unformatted) characters and
+(formatted) glyphs.
+.
+Everything that affects how a glyph is output is stored with the glyph
+node;
+once a glyph node has been constructed,
+it is unaffected by any subsequent requests that are executed,
+including
 .BR bd ,
 .BR cs ,
 .BR tkf ,
@@ -3801,28 +5946,33 @@
 .B fp
 requests.
 .
-.P
-Normally glyphs are constructed from input characters at
-the moment immediately before the glyph is added to the current
-output line.
-.
-Macros, diversions and strings are all, in fact, the same type of
-object; they contain lists of input characters and glyphs
-in any combination.
+Normally,
+glyphs are constructed from characters immediately before the glyph is
+added to an output line.
+.
+Macros,
+diversions,
+and strings are all,
+in fact,
+the same type of object;
+they contain a sequence of intermixed character and glyph nodes.
+.
+Special characters transform from one to the other:
+before being added to the output,
+they behave as characters;
+afterward,
+they are glyphs.
+.
+A glyph node does not behave like a character node when it is processed
+by a macro:
+it does not inherit any of the special properties that the character
+from which it was constructed might have had.
 .
-.P
-Special characters can be both; before being added to the output, they
-act as input entities, afterwards they denote glyphs.
-.
-.P
-A glyph does not behave like an input character for the
-purposes of macro processing; it does not inherit any of the special
-properties that the input character from which it was constructed
-might have had.
-.
-The following example makes things clearer.
+For example,
+the input
 .
-.P
+.br
+.ne 5v
 .RS
 .EX
 \&.di x
@@ -3833,90 +5983,149 @@
 .EE
 .RE
 .
-.P
-With
-.I GNU troff
-this is printed as
-.BR \rs\rs .
-So each pair of input backslashes \oq\rs\rs\cq is turned
-into a single output backslash glyph \oq\rs\cq and the
-resulting output backslashes are not interpreted as escape characters
-when they are reread.
-.
-.P
-.I Classical troff
-would interpret them as escape characters when they were reread and
-would end up printing a single backslash \oq\rs\cq.
-.
-.P
-In GNU, the correct way to get a printable version of the backslash
-character \cq\rs\cq
-is the
-.B \rs(rs
-escape sequence, but classical troff does not provide a clean feature
-for getting a non-syntactical backslash.
+produces
+.RB \lq\^ \rs\rs \rq
+in GNU
+.IR troff . \" GNU
+Each pair of backslashes becomes one backslash
+.I glyph;
+the resulting backslashes are thus not interpreted as escape
+.I characters
+when they are reread as the diversion is output.
+.
+AT&T
+.I troff \" AT&T
+.I would
+interpret them as escape characters when rereading them and end up
+printing one
+.RB \lq \rs \rq.
+.
 .
-A close method is the printable version of the current escape
-character using the
+.P
+One way to format a backslash in most documents is with the
 .B \rse
-escape sequence; this works if the current escape character is not
-redefined.
+escape sequence;
+this formats the glyph of the current escape character,
+regardless of whether it is used in a diversion;
+it also works in both GNU
+.I troff \" GNU
+and AT&T
+.IR troff . \" AT&T
+.
+(Naturally,
+if you've changed the escape character,
+you need to prefix the
+.RB \lq e \rq
+with whatever it is\emand you'll likely get something other than a
+backslash in the output.)
+.
+.
+.P
+The other correct way,
+appropriate in contexts independent of the backslash's common use as a
+.I roff
+escape character\emperhaps in discussion of character sets or other
+programming languages\emis the character escape
+.B \rs(rs
+or
+.BR \rsrs ,
+for \lqreverse solidus\rq,
+from its name in the ECMA-6 (ISO/IEC\~646) standard.
+.
+This escape sequence is not portable to AT&T
+.IR troff , \" AT&T
+but is to its lineal descendant,
+Heirloom Doctools
+.IR troff ,
+as of its 060716 release (July 2006).
 .
-It works in both GNU mode and compatibility mode, while dirty tricks
-like specifying a sequence of multiple backslashes do not work
-reliably; for the different handling in diversions, macro definitions,
-or text mode quickly leads to a confusion about the necessary number of
-backslashes.
 .
 .P
-To store an escape sequence in a diversion that is interpreted
-when the diversion is reread, either the traditional
+To store an escape sequence in a diversion that is interpreted when the
+diversion is reread,
+either use the traditional
 .B \rs!\&
-transparent output facility or the
-new
+transparent output facility,
+or,
+if this is unsuitable,
+the new
 .B \rs?\&
-escape sequence can be used.
+escape sequence.
+.
+See subsection \lqEscape sequences\rq above and sections
+\lqDiversions\rq and \lqgtroff Internals\rq in
+.IR "Groff: The GNU Implementation of troff" ,
+the
+.I groff
+Texinfo manual.
+.
+.
+.P
+In the somewhat pathological case where a diversion exists containing a
+partially collected line and a partially collected line at the top-level
+diversion has never existed,
+AT&T
+.I troff
+will output the partially collected line at the end of input;
+GNU
+.I troff \" GNU
+will not.
 .
 .
 .\" ====================================================================
-.SS "Intermediate Output"
+.SS "Formatter output incompatibilities"
 .\" ====================================================================
 .
-The groff intermediate output format is in a state of evolution.
+Its extensions notwithstanding,
+the
+.I groff
+intermediate output format has some incompatibilities
+with that of AT&T
+.IR troff , \" AT&T
+but better compatibility is sought;
+problem reports and patches are welcome.
+.
+The following incompatibilities are known.
+.
 .
-So far it has some incompatibilities, but it is intended to establish
-a full compatibility to the classical troff output format.
+.IP \bu 2n
+The drawing position after rendering polygons is inconsistent with AT&T
+.I troff \" AT&T
+practice.
 .
-Actually the following incompatibilities exist:
+Other implementations have diverged on this point as well.
 .
-.IP \bu 2m
-The positioning after the drawing of the polygons conflicts with the
-classical definition.
 .
-.IP \bu 2m
-The intermediate output cannot be rescaled to other devices as
-classical \oqdevice-independent\cq troff did.
+.IP \bu
+The output cannot be easily rescaled to other devices as AT&T
+.IR troff 's \" AT&T
+could.
+.\" XXX: Why?  What's the problem?  sizescale?  That could be written
+.\" into the output as a comment or x command.  --GBR
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 This document was written by
-.MT jjc@\:jclark.com
+.MT jjc@\:jclark\:.com
 James Clark
-.ME
-and modified by
-.MT wl@\:gnu.org
+.ME ,
+.MT wl@\:gnu\:.org
 Werner Lemberg
-.ME
-and
-.MT groff\-bernd.warken\-72@\:web.de
+.ME ,
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
+.ME ,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -3928,57 +6137,52 @@
 You can browse it interactively with \lqinfo groff\rq.
 .
 .
-.TP
-.BR groff (@MAN1EXT@)
-A list of all documentation around
-.IR groff .
-.
-.TP
-.BR groff (@MAN7EXT@)
-A description of the
+.br
+.ne 4v
+.P
+\lqTroff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
+widely called simply \lqCSTR\~#54\rq,
+documents the language,
+device and font description file formats,
+and output format
+referred to collectively in
 .I groff
-language, including a short, but complete reference of all predefined
-requests, registers, and escapes of plain
-.IR groff .
-From the command line, this is called using
+documentation as AT&T
+.IR troff . \" AT&T
 .
-.RS
-.IP
-.EX
-man 7 groff
-.EE
-.RE
 .
-.TP
-.BR roff (@MAN7EXT@)
-A survey of
-.I roff
-systems, including pointers to further historical documentation.
+.P
+\lqA Typesetter-independent TROFF\rq
+by Brian W.\& Kernighan,
+1982,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
+provides additional insights into the
+device and font description file formats
+and output format.
 .
-.TP
-.RI  CSTR\~#54\/ 
-The
-.I Nroff/\:Troff User's Manual
-by
-.I J.\& F.\& Ossanna
-of 1976 in the revision of
-.I Brian Kernighan
-of 1992, being the
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
-classical troff documentation
-.UE .
 .
+.P
+.MR groff @MAN1EXT@ ,
+.MR groff @MAN7EXT@ ,
+.MR roff @MAN7EXT@
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_diff_C
 .
+.\" Clean up.
+.rm tx
+.rm ic
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_diff_7_man_C
+.do rr *groff_groff_diff_7_man_C
 .
-.\" ====================================================================
-.\" Emacs variables
-.\" ====================================================================
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/groff_font.5.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff_font.5.man Changed

@@ -1,13 +1,15 @@
-.TH GROFF_FONT @MAN5EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_font \- format of groff device and font description files
+.TH groff_font @MAN5EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_font \- GNU
+.I roff
+device and font description files
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff (GNU roff), which is a free software
 .\" project.
@@ -23,364 +25,634 @@
 .
 .
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_font_C \n.C
+.do nr *groff_groff_font_5_man_C \n.cp
 .cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The groff font format is roughly a superset of the ditroff
-font format.
+.\" BEGIN Keep parallel with groff.texi node "Device and Font Files".
+The
+.I groff
+font and output device description formats are slight
+extensions of those used by AT&T device-independent
+.IR troff . \" AT&T
+.
+In distinction to the AT&T implementation,
+.I groff
+lacks a binary format;
+all files are text files.
 .
-The font files for device
+(Plan\~9
+.I troff \" Plan 9
+has also abandoned the binary format.)
+.
+The device and font description files for a device
 .I name
-are stored in a directory
-.IR dev name.
+are stored in a
+.IR dev name
+directory.
+.
+The device description file is called
+.IR DESC ,
+and,
+for each font supported by the device,
+a font description file is
+.RI called\~ f,
+where
+.IR f \~is
+usually an abbreviation of a font's name and/or style.
+.
+For example,
+the
+.B ps
+(PostScript)
+device has
+.I groff
+font description files for Times roman
+.RB ( TR )
+and Zapf Chancery Medium italic
+.RB ( ZCMI ),
+among many others,
+while the
+.B utf8
+device
+(for terminal emulators)
+has only font descriptions for the roman,
+italic,
+bold,
+and bold-italic styles
+.RB ( R ,
+.BR I ,
+.BR B ,
+and
+.BR BI ,
+respectively).
 .
-There are two types of file:
-a device description file called
-.I DESC
-and for each
-.RI font \~F ,
-a font file called\~F.
 .
-These are text files;
-unlike the ditroff font format,
-there is no associated binary format.
+.P
+Device and font description files are read by the formatter,
+.IR @g@troff ,
+and by output drivers.
+.
+The programs typically delegate these files' processing to an internal
+library,
+.IR libgroff ,
+ensuring their consistent interpretation.
 .
 .
 .\" ====================================================================
-.SS DESC file format
+.SH "\fIDESC\f file format"
 .\" ====================================================================
 .
 The
 .I DESC
-file can contain the following types of line as shown below.
+file contains a series of directives;
+each begins a line.
+.
+Their order is not important,
+with two exceptions:
+(1) the
+.B res
+directive must precede any
+.B \%papersize
+directive;
+and
+(2) the
+.B charset
+directive must come last
+(if at all).
 .
-Later entries in the file override previous values.
+If a directive name is repeated,
+later entries in the file override previous ones
+(except that the paper dimensions are computed based on the
+.B res
+directive last seen when
+.B \%papersize
+is encountered).
 .
-.LP
-Empty lines are ignored.
+Spaces and/or tabs separate words and are ignored at line boundaries.
 .
-.TP
-.B charset
-This line and everything following in the file are ignored.
+Comments start with the
+.RB \lq # \rq
+character and extend to the end of a line.
+.
+Empty lines are ignored.
 .
-It is allowed for the sake of backwards compatibility.
 .
 .TP
-.BI "family " fam
+.BI family\~ fam
 The default font family is
 .IR fam .
 .
+.
 .TP
-.BI "fonts " "n F1 F2 F3 \|.\|.\|.\| Fn"
+.BI fonts\~ "n F1"\~\c
+.RI .\|.\|.\&\~ Fn
 Fonts
-.IR F1 ", \|.\|.\|., " Fn
-are mounted in the font positions
+.IR F1 ", \|.\|.\|.\|, " Fn
+are mounted at font positions
 .IR m "\|+\|1, \|.\|.\|., " m \|+\| n
 where
 .I m
-is the number of styles.
+is the number of
+.B styles
+(see below).
 .
-This command may extend over more than one line.
+This directive may extend over more than one line.
 .
-A font name of\~\c
-.B 0
-causes no font to be mounted on the corresponding font position.
+A font name
+.RB of\~ 0
+causes no font to be mounted at the corresponding position.
 .
-.TP
-.BI "hor " n
-The horizontal resolution is
-.IR n \~\c
-machine units.
 .
 .TP
-.BI "image_generator "  string
-Needed for
-.B \%grohtml
-only.
+.BI hor\~ n
+The horizontal motion quantum is
+.IR n \~basic
+units.
 .
-It specifies the program to generate PNG images from
-PostScript input.
+Horizontal quantities are rounded to multiples
+.RI of\~ n.
 .
-Under GNU/Linux this is usually
-.I gs
-but under other systems (notably cygwin) it might be set to another
-name.
 .
 .TP
-.BI "paperlength " n
-The physical vertical dimension of the output medium in machine units.
+.BI image_generator\~ program
+Use
+.I program
+to generate PNG images from PostScript input.
 .
-This isn't used by
-.B troff
-itself but by output devices.
+Under GNU/Linux,
+this is usually
+.MR gs 1 ,
+but under other systems
+(notably Cygwin)
+it might be set to another name.
 .
-Deprecated.
+The
+.MR grohtml @MAN1EXT@
+driver uses this directive.
 .
-Use
-.B papersize
-instead.
 .
 .TP
-.BI "papersize " string
-Select a paper size.
+.BI paperlength\~ n
+The vertical dimension of the output medium is
+.IR n \~basic
+units
+(deprecated:
+use
+.B \%papersize
+instead).
+.
 .
-Valid values for
-.I string
-are the ISO paper types A0\enA7, B0\enB7, C0\enC7, D0\enD7,
-DL, and the US paper
-types letter, legal, tabloid, ledger, statement, executive, com10, and
-monarch.
+.TP
+.BI papersize\~ format-or-dimension-pair-or-file-name\c
+\~.\|.\|.
+The dimensions of the output medium are as according to the
+argument,
+which is either
+a standard paper format,
+a pair of dimensions,
+or the name of a plain text file containing either of the foregoing.
+.
+Recognized paper formats are the ISO and DIN formats
+.BR A0 \en A7 ,
+.BR B0 \en B7 ,
+.BR C0 \en C7 ,
+and
+.BR D0 \en D7 ;
+.\" XXX: tmac/papersize.tmac does not support ABCD7.
+the U.S.\& formats
+.BR letter ,
+.BR legal ,
+.BR tabloid ,
+.BR ledger ,
+.BR statement ,
+and
+.BR executive ;
+and the envelope formats
+.BR com10 ,
+.BR monarch ,
+and
+.BR DL .
 .
-Case is not significant for
-.I string
-if it holds predefined paper types.
+Matching is performed without regard for lettercase.
 .
-Alternatively,
-.I string
-can be a file name (e.g.\&
-.IR /etc/papersize );
-if the file can be opened,
-.B groff
-reads the first line and tests for the above paper sizes.
 .
-Finally,
-.I string
-can be a custom paper size in the format
+.IP
+Alternatively,
+the argument can be a custom paper format
 .IB length , width
-(no spaces before and after the comma).
+(with no spaces before or after the comma).
 .
 Both
 .I length
 and
 .I width
-must have a unit appended; valid values are \oqi\cq for inches,
-\oqc\cq for centimeters, \oqp\cq for points, and \oqP\cq
+must have a unit appended;
+valid units are
+.RB \lq i \rq
+for inches,
+.RB \lq c \rq
+for centimeters,
+.RB \lq p \rq
+for points,
+and
+.RB \lq P \rq
 for picas.
 .
 Example:
-.BR 12c,235p .
+.RB \lq 12c,235p \rq.
 .
-An argument which starts with a digit is always treated as a custom
-paper format.
+An argument that starts with a digit is always treated as a custom paper
+format.
 .
-.B papersize
-sets both the vertical and horizontal dimension of the output medium.
 .
 .IP
-More than one argument can be specified;
-.B groff
-scans from left to right and uses the first valid paper specification.
+Finally,
+the argument can be a file name
+(e.g.,
+.IR /etc/papersize );
+if the file can be opened,
+the first line is read and a match attempted against each other form.
 .
-.TP
-.BI "paperwidth " n
-The physical horizontal dimension of the output medium in machine units.
+No comment syntax is supported.
 .
-Deprecated.
 .
-Use
-.B papersize
-instead.
+.IP
+More than one argument can be specified;
+each is scanned in turn and the first valid paper specification used.
+.
+.
+.TP
+.BI paperwidth\~ n
+The horizontal dimension of the output medium is
+.IR n \~basic
+units
+(deprecated:
+use
+.B \%papersize
+instead).
 .
-This isn't used by
-.B troff
-itself but by output devices.
 .
 .TP
 .B pass_filenames
-Make troff tell the driver the source file name being processed.
+Direct
+.I @g@troff
+to emit the name of the source file being processed.
+.
+This is achieved with the intermediate output command
+.RB \lq "x F" \rq,
+which
+.I \%grohtml
+interprets.
 .
-This is achieved by another tcommand:
-.BR F \~\c
-.IR filename .
 .
 .TP
-.BI "postpro " program
+.BI postpro\~ program
 Use
 .I program
 as the postprocessor.
 .
+.
 .TP
-.BI "prepro " program
-Call
+.BI prepro\~ program
+Use
 .I program
 as a preprocessor.
 .
+The
+.B html
+and
+.B xhtml
+output devices use this directive.
+.
+.
 .TP
-.BI "print "  program
+.BI print\~  program
 Use
 .I program
-as the spooler program for printing.
+as the print spooler.
 .
-If omitted, the
+If omitted,
+.IR groff 's
 .B \-l
 and
 .B \-L
-options of
-.B groff
-are ignored.
+options are ignored.
+.
 .
 .TP
-.BI "res " n
-There are
+.BI res\~ n
+The device resolution is
 .I n
-machine units per inch.
+basic units per inch.
+.
 .
 .TP
-.BI "sizes " "s1 s2 \|.\|.\|.\| sn " 0
-This means that the device has fonts at
+.BI sizes\~ s1\~\c
+.RI .\|.\|.\&\~ sn\~\c
+.B 0
+The device has fonts at
 .IR s1 ,
-.IR s2 ", \|.\|.\|., " sn
-scaled points.
+\&.\|.\|.,
+.I sn
+scaled points
+(see below).
 .
-The list of sizes must be terminated by a
-.BR 0 .
+The list of sizes must be terminated by
+.RB a\~ 0 .
 .
 Each
 .I si
 can also be a range of sizes
-.IR m \(en n .
+.IR m \en n .
 .
 The list can extend over more than one line.
 .
-.TP
-.BI "sizescale " n
-The scale factor for point sizes.
 .
-By default this has a value of 1.
+.TP
+.BI sizescale\~ n
+A typographical point
+is subdivided into
+.IR n \~scaled
+points.
 .
-One
-.I
-scaled point
-is equal to
-one
-.RI point\|/\| n .
+The default
+.RB is\~ 1 .
 .
-The arguments to the
-.B unitwidth
-and
-.B sizes
-commands are given in scaled points.
 .
 .TP
-.BI "styles " "S1 S2 \|.\|.\|.\| Sm"
-The first
-.I m
-font positions are associated with styles
-.IR S1 ", \|.\|.\|., " Sm .
+.BI styles\~ S1\~\c
+.RI .\|.\|.\&\~ Sm
+The
+.RI first\~ m
+font mounting positions are associated with styles
+.IR S1 ,
+\&.\|.\|.,
+.IR Sm .
+.
 .
 .TP
 .B tcommand
-This means that the postprocessor can handle the
+The postprocessor can handle the
 .B t
-and\~\c
-.B u
-output commands.
+.RB and\~ u
+intermediate output commands.
+.
 .
 .TP
 .B unicode
-Indicate that the output device supports the complete Unicode
-repertoire.
+The output device supports the complete Unicode repertoire.
+.
+This directive is useful only for devices which produce character
+entities instead of glyphs.
 .
-Useful only for devices which produce
-.I character entities
-instead of glyphs.
 .
 .IP
 If
 .B unicode
-is present, no
+is present,
+no
 .B charset
 section is required in the font description files since the Unicode
 handling built into
-.B groff
+.I groff
 is used.
 .
-However, if there are entries in a
+However,
+if there are entries in a font description file's
 .B charset
-section, they either override the default mappings for those
-particular characters or add new mappings (normally for composite
-characters).
+section,
+they either override the default mappings for those particular
+characters or add new mappings
+(normally for composite characters).
+.
 .
 .IP
-This is used for
-.BR \-Tutf8 ,
-.BR \-Thtml ,
+The
+.BR utf8 ,
+.BR html ,
 and
-.BR \-Txhtml .
+.B xhtml
+output devices use this directive.
+.
 .
 .TP
-.BI "unitwidth " n
-Quantities in the font files are given in machine units
-for fonts whose point size is
-.IR n \~\c
-scaled points.
+.BI unitwidth\~ n
+Quantities in the font description files are in basic units for fonts
+whose type size is
+.IR n \~scaled
+points.
+.
 .
 .TP
 .B unscaled_charwidths
 Make the font handling module always return unscaled glyph widths.
 .
-Needed for the
-.B \%grohtml
-device.
+The
+.I \%grohtml
+driver uses this directive.
+.
 .
 .TP
 .B use_charnames_in_special
-This command indicates that troff should encode named glyphs inside
-special commands.
+.I @g@troff
+should encode named glyphs inside device control commands.
+.
+The
+.I \%grohtml
+driver uses this directive.
+.
+.
+.TP
+.BI vert\~ n
+The vertical motion quantum is
+.IR n \~basic
+units.
+.
+Vertical quantities are rounded to multiples
+.RI of\~ n.
+.
 .
 .TP
-.BI "vert " n
-The vertical resolution is
-.IR n \~\c
-machine units.
+.B charset
+This directive and the rest of the file are ignored.
+.
+It is recognized for compatibility with other
+.I troff \" generic
+implementations.
 .
-.LP
+In GNU
+.IR troff , \" GNU
+character set repertoire is described on a per-font basis.
+.
+.
+.P
+.I @g@troff
+recognizes but ignores the directives
+.BR spare1 ,
+.BR spare2 ,
+and
+.BR biggestfont .
+.
+.
+.P
 The
 .BR res ,
 .BR unitwidth ,
 .BR fonts ,
 and
 .B sizes
-lines are compulsory.
+lines are mandatory.
 .
-Not all commands in the
-.I DESC
-file are used by
-.B troff
-itself; some of the keywords (or even additional ones) are used by
-postprocessors to store arbitrary information about the device.
-.
-.LP
-Here a list of obsolete keywords which are recognized by
-.B groff
-but completely ignored:
-.BR spare1 ,
-.BR spare2 ,
-.BR biggestfont .
+Directives not listed above are ignored by
+.I @g@troff
+but may be used by postprocessors to obtain further information about
+the device.
 .
 .
 .\" ====================================================================
-.SS Font file format
+.SH "Font description file format"
 .\" ====================================================================
 .
-A font file has two sections; empty lines are ignored in both of them.
+On typesetting output devices,
+each font is typically available at multiple sizes.
+.
+While paper measurements in the device description file are in absolute
+units,
+measurements applicable to fonts must be proportional to the type size.
+.
+.I groff
+achieves this using the precedent set by AT&T device-independent
+.IR troff : \" AT&T
+one font size is chosen as a norm,
+and all others are scaled linearly relative to that basis.
+.
+The \lqunit width\rq is the number of basic units per point when the
+font is rendered at this nominal size.
+.
+.
+.P
+For instance,
+.IR groff 's
+.B lbp
+device uses a
+.B unitwidth
+of\~800.
+.
+Its Times roman font
+.RB (\lq TR \rq)
+has a
+.B spacewidth
+of\~833;
+this is also the width of its comma,
+period,
+centered period,
+and mathematical asterisk,
+while its \lqM\rq is 2,963 basic units.
+.
+Thus,
+an \lqM\rq on the
+.B lbp
+device is 2,963 basic units wide at a notional type size of 800\~points.
+.
+(800-point type is not practical for most purposes,
+but using it enables the quantities in the font description files to be
+expressed as integers.)
+.
+.
+.P
+A font description file has two sections.
+.
+The first is a sequence of directives,
+and is parsed similarly to the
+.I DESC
+file described above.
+.
+Except for the directive names that begin the second section,
+their ordering is immaterial.
+.
+Later directives of the same name override earlier ones,
+spaces and tabs are handled in the same way,
+and the same comment syntax is supported.
+.
+Empty lines are ignored throughout.
 .
-.LP
-The first section is a sequence of lines each containing a sequence of
-blank delimited words; the first word in the line is a key, and
-subsequent words give a value for that key.
 .
 .TP
-.BI "ligatures " "lig1 lig2 \|.\|.\|.\| lign \fR" 0 \fR
+.BI name\~ F
+The name of the font
+.RI is\~ F .
+.
+.RB \lq DESC \rq
+is an invalid font name.
+.
+Simple integers are valid,
+but their use is discouraged.
+.
+.RI ( groff
+requests and escape sequences interpret non-negative font names as
+mounting positions instead.
+.
+Further,
+a font named
+.RB \lq 0 \rq
+cannot be automatically mounted by the
+.B fonts
+directive of a
+.I DESC
+file.)
+.
+.
+.TP
+.BI spacewidth\~  n
+The width of an unadjusted inter-word space is
+.IR n \~basic
+units.
+.
+.
+.P
+The directives above must appear in the first section;
+those below are optional.
+.
+.
+.TP
+.BI slant\~ n
+The font's glyphs have a slant of
+.IR n \~degrees;
+a positive
+.I n
+slants in the direction of text flow.
+.
+.
+.TP
+.BI ligatures\~ lig1\~\c
+.RI .\|.\|.\&\~ lign\~\c
+.RB  0 
 Glyphs
 .IR lig1 ,
-.IR lig2 ", \|.\|.\|., " lign
-are ligatures; possible ligatures are
+\&.\|.\|.,
+.I lign
+are ligatures;
+possible ligatures are
 .BR ff ,
 .BR fi ,
 .BR fl ,
@@ -388,336 +660,455 @@
 and
 .BR ffl .
 .
-For backwards compatibility, the list of ligatures may be terminated
-with a\~\c
-.BR 0 .
+For compatibility with other
+.I troff
+implementations,
+the list of ligatures may be terminated with
+.RB a\~ 0 .
 .
-The list of ligatures may not extend over more than one line.
+The list of ligatures must not extend over more than one line.
 .
-.TP
-.BI "name " F
-The name of the font is\~\c
-.IR F .
 .
 .TP
-.BI "slant " n
-The glyphs of the font have a slant of
-.IR n \~\c
-degrees.
+.B special
+The font is
+.IR special :
+when a glyph is requested that is not present in the current font,
+it is sought in any mounted fonts that bear this property.
 .
-(Positive means forward.)
 .
-.TP
-.BI "spacewidth "  n
-The normal width of a space is\~\c
-.IR n .
+.P
+Other directives in this section are ignored by
+.IR @g@troff ,
+but may be used by postprocessors to obtain further information about
+the font.
 .
-.TP
-.B special
-The font is
-.IR special ;
-this means that when a glyph is requested that is not present in
-the current font, it is searched for in any special fonts that are
-mounted.
-.
-.LP
-Other commands are ignored by
-.B troff
-but may be used by postprocessors to store arbitrary information
-about the font in the font file.
-.
-.LP
-The first section can contain comments which start with the
-.B #
-character and extend to the end of a line.
 .
-.LP
+.P
 The second section contains one or two subsections.
 .
-It must contain a
-.I charset
-subsection
-and it may also contain a
-.I kernpairs
-subsection.
-.
-These subsections can appear in any order.
+These can appear in either order;
+the first one encountered commences the second section.
 .
-Each subsection starts with a word on a line by itself.
+Each starts with a directive on a line by itself.
 .
-.LP
-The word
+A
 .B charset
-starts the charset subsection.
+subsection is mandatory unless the associated
+.I DESC
+file contains the
+.B unicode
+directive.
 .
-The
+Another subsection,
+.BR \%kernpairs ,
+is optional.
+.
+.
+.P
+The directive
 .B charset
-line is followed by a sequence of lines.
+starts the character set subsection.
 .
-Each line gives information for one glyph.
+(For typesetter devices,
+this directive is misnamed since it starts a list of glyphs,
+not characters.)
 .
-A line comprises a number of fields separated
-by blanks or tabs.
+It precedes a series of glyph descriptions,
+one per line.
+.
+Each such glyph description comprises a set of fields separated by
+spaces or tabs and organized as follows.
 .
-The format is
 .
 .IP
 .I name metrics type code
-.RI  entity_name 
+.RI  entity-name 
 .RB  \-\-
 .IR comment 
 .
-.LP
+.
+.P
 .I name
 identifies the glyph:
 if
 .I name
-is a single glyph
-.I c
-then it corresponds to the groff input character
-.IR c ;
-if it is of the form
-.BI \rs c
-where c is a single character, then it
-corresponds to the special character
-.BI \rs c \fR;
-otherwise it corresponds to the groff input character
-.BI \rs name \fR.
-.
-If it is exactly two characters
-.I xx
-it can be entered as
-.BI \rs( xx\fR.
-.
-Note that single-letter special characters can't be accessed as
-.BI \rs c\fR;
-the only exception is \oq\rs\-\cq which is identical to
-\oq\rs\-\cq.
-.
-The name
-.B \-\-\-
-is special and indicates that the glyph is unnamed;
-such glyphs can only be used by means of the
+is a printable
+.RI character\~ c ,
+it corresponds to the
+.I troff \" generic
+ordinary
+.RI character\~ c .
+.
+If
+.I name
+is a multi-character sequence not beginning with
+.BR \rs ,
+it corresponds to the GNU
+.I troff \" GNU
+special character escape sequence
+\lq\c
+.BI \rs name \c
+\rq.
+.
+A name consisting of three minus signs,
+.RB \lq \-\-\- \rq,
+indicates that the glyph is unnamed:
+such glyphs can be accessed only by the
 .B \rsN
 escape sequence in
-.BR troff .
-.
-.LP
-The
-.I type
-field gives the glyph type:
-.
-.TP
-1
-means the glyph has a descender, for example, \oqp\cq;
-.
-.TP
-2
-means the glyph has an ascender, for example, \oqb\cq;
+.IR troff . \" generic; \N is portable
 .
-.TP
-3
-means the glyph has both an ascender and a descender, for example,
-\oq(\cq.
+A special character named
+.RB \lq \-\-\- \rq
+can still be defined using
+.B .char
+and similar requests.
 .
-.LP
 The
-.I code
-field gives the code which the postprocessor uses to print the glyph.
-.
-The glyph can also be input to groff using this code by means of the
-.B \rsN
-escape sequence.
+.I name
+.RB \lq \rs\- \rq
+defines the minus sign glyph.
 .
-The code can be any integer.
+.\" TODO: Withdraw support for this.  No one seems to use it.
+Finally,
+.I name
+can be the horizontal motion escape sequences,
+.B \rs|
+and
+.B \rs\ha
+(\lqthin\rq and \lqhair\rq spaces,
+respectively),
+in which case only the width metric described below is applied;
+a font can thus customize the widths of these spaces.
+.\" XXX: For exhaustivity purposes...you can define "\whatever", which
+.\" has to be accessed with \C'\\whatever' or \\\whatever, but the
+.\" parser matches predefined escape sequences before looking up special
+.\" characters.  Most such definitions are inaccessible from the
+.\" language, because nearly every '\x', where 'x' is a Unicode basic
+.\" Latin character, is a predefined groff escape sequence.
 .
-If it starts with a\~\c
-.B 0
-it is interpreted as octal;
-if it starts with
-.B 0x
-or
-.B 0X
-it is interpreted as hexadecimal.
-.
-Note, however, that the
-.B \rsN
-escape sequence only accepts a decimal integer.
 .
-.LP
-The
-.I entity_name
-field gives an ASCII string identifying the glyph which the
-postprocessor uses to print that glyph.
-.
-This field is optional and is currently used by
-.B grops
-to build sub-encoding arrays for PS fonts containing more than 256
-glyphs.
-.
-(It has also been used for
-.BR \%grohtml 's
-entity names but for efficiency reasons this data is now compiled
-directly into
-.BR \%grohtml .)
-.
-.LP
-Anything on the line after the encoding field or \oq\-\-\cq are
-ignored.
-.
-.LP
-The
+.br
+.ne 4v \" Keep next paragraph together with (possibly 2-line) synopsis.
+.P
+The form of the
 .I metrics
-field has the form (in one line; it is broken here for the sake of
-readability):
+field is as follows
+(on one line;
+it may be broken here for readability).
+.
 .
 .IP
+.\" XXX: Turning off adjustment is ugly; thanks to meter-long specimens
+.\" like this, we need an escape sequence that selectively disables
+.\" adjustment at the end of a word.
+.na
 .I width\/\c
-.RI \fB, height\/\c
-.RI \fB, depth\/\c
-.RI \fB, italic-correction
-.br
-.RI \fB, left-italic-correction\/\c
-.RI \fB, subscript-correction 
+.RI \fB,\fP \:height\/\c
+.RI \fB,\fP \:depth\/\c
+.RI \fB,\fP \:\%italic-correction\/\c
+.RI \fB,\fP \:\%left-italic-correction\/\c
+.RI \fB,\fP \:\%subscript-correction 
+.ad \*AD
+.
 .
-.LP
-There must not be any spaces between these subfields.
+.P
+There must not be any spaces,
+tabs,
+or newlines between these
+.I subfields,
 .
-Missing subfields are assumed to be\~0.
+which are in basic units expressed as decimal integers.
 .
-The subfields are all decimal integers.
+Unspecified subfields default
+.RB to\~ 0 .
 .
-Since there is no associated binary format, these
-values are not required to fit into a variable of type
+Since there is no associated binary format,
+these values are not required to fit into the C language data type
 .B char
-as they are in ditroff.
+as they are in AT&T device-independent
+.IR troff . \" AT&T
+.
 .
+.P
 The
 .I width
-subfields gives the width of the glyph.
+subfield gives the width of the glyph.
 .
 The
 .I height
-subfield gives the height of the glyph (upwards is positive);
-if a glyph does not extend above the baseline, it should be
-given a zero height, rather than a negative height.
+subfield gives the height of the glyph
+(upwards is positive);
+if a glyph does not extend above the baseline,
+it should be given a zero height,
+rather than a negative height.
 .
 The
 .I depth
-subfield gives the depth of the glyph, that is, the distance
-below the baseline to which the glyph extends (downwards is positive);
-if a glyph does not extend below the baseline, it should be
-given a zero depth, rather than a negative depth.
+subfield gives the depth of the glyph,
+that is,
+the distance below the baseline to which the glyph extends
+(downwards is positive);
+if a glyph does not extend below the baseline,
+it should be given a zero depth,
+rather than a negative depth.
+.
+Italic corrections are relevant to glyphs in italic or oblique styles.
 .
 The
 .I italic-correction
-subfield gives the amount of space that should be added after the
-glyph when it is immediately to be followed by a glyph
-from a roman font.
+is the amount of space that should be added after an oblique glyph to be
+followed immediately by an upright glyph.
 .
 The
 .I left-italic-correction
-subfield gives the amount of space that should be added before the
-glyph when it is immediately to be preceded by a glyph
-from a roman font.
+is the amount of space that should be added before an oblique glyph to
+be preceded immediately by an upright glyph.
 .
 The
-.I subscript-correction
-gives the amount of space that should be added after a glyph
-before adding a subscript.
+.I
+subscript-correction
+is the amount of space that should be added after an oblique glyph to be
+followed by a subscript;
+it should be less than the italic correction.
 .
-This should be less than the italic correction.
 .
-.LP
-A line in the charset section can also have the format
+.P
+For fonts used with typesetting devices,
+the
+.I type
+field gives a featural description of the glyph:
+it is a bit mask recording whether the glyph is an ascender,
+descender,
+both,
+or neither.
+.
+When a
+.B \rsw
+escape sequence is interpolated,
+these values are bitwise or-ed together
+for each glyph
+and stored in the
+.B ct
+register.
+.
+In font descriptions for terminal devices,
+all glyphs might have a type of zero,
+regardless of their appearance.
+.
+.
+.TP
+0
+means the glyph lies entirely between the baseline and
+a horizontal line at the \lqx-height\rq of the font,
+as with \lqa\rq,
+\lqc\rq,
+and
+\lqx\rq;
+.
+.
+.TP
+1
+means the glyph descends below the baseline,
+like \lqp\rq;
 .
-.IP
-.I name \fB\dq
 .
-.LP
-This indicates that
+.TP
+2
+means the glyph ascends above the font's x-height,
+like \lqA\rq or
+\lqb\rq);
+and
+.
+.
+.TP
+3
+means the glyph is both an ascender and a descender\emthis is true of
+parentheses in some fonts.
+.
+.
+.P
+The
+.I code
+field gives a numeric identifier that the postprocessor uses to render
+the glyph.
+.
+The glyph can be specified to
+.I troff \" generic
+using this code by means of the
+.B \rsN
+escape sequence.
+.
+The code can be any integer
+(that is,
+any integer parsable by the C standard library's
+.MR strtol 3
+function).
+.
+.
+.P
+The
+.I entity-name
+field defines an identifier for the glyph that the postprocessor
+uses to print the
+.I @g@troff
+glyph
+.IR name .
+.
+This field is optional;
+it was introduced so that the
+.I \%grohtml
+output driver could encode its character set.
+.
+For example,
+the glyph
+.B \rsPo
+is represented by
+.RB \lq &pound; \rq
+in HTML 4.0.
+.
+For efficiency,
+these data are now compiled directly into
+.IR \%grohtml .
+.
+.I grops
+uses the field to build sub-encoding arrays for PostScript fonts
+containing more than 256 glyphs.
+.
+Anything on the line after the
+.I entity-name
+field or
+.RB \lq \-\- \rq
+is ignored.
+.
+.
+.P
+A line in the
+.B charset
+section can also have the form
+.
+.RS
+.IB name\~ \dq
+.RE
+.
+identifying
 .I name
-is just another name for the glyph mentioned in the
-preceding line.
+as another name for the glyph mentioned in the preceding line.
 .
-.LP
-The word
-.B kernpairs
-starts the kernpairs section.
+Such aliases can be chained.
 .
-This contains a sequence of lines of the form:
 .
-.IP
-.I c1 c2 n
+.P
+The directive
+.B \%kernpairs
+starts a list of kerning adjustments to be made to adjacent glyph pairs
+from this font.
+.
+It contains a sequence of lines formatted as follows.
 .
-.LP
-This means that when glyph
-.I c1
-appears next to glyph
-.I c2
-the space between them should be increased by\~\c
-.IR n .
+.RS
+.I g1 g2 n
+.RE
 .
-Most entries in kernpairs section have a negative value for\~\c
-.IR n .
+The foregoing means that when glyph
+.I g1
+is typeset immediately before
+.IR g2 ,
+the space between them should be increased
+.RI by\~ n .
 .
+Most kerning pairs should have a negative value
+.RI for\~ n .
+.\" END Keep parallel with groff.texi node "Device and Font Files".
 .
+.
+.br
+.ne 4v
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.IR @FONTDIR@/dev name /DESC
-Device description file for device
+.IR @FONTDIR@/\:\%dev name /\:DESC
+describes the output device
 .IR name .
 .
+.
 .TP
-.IR @FONTDIR@/dev name / F
-Font file for font\~\c
-.I F
-of device
+.IR @FONTDIR@/\:\%dev name / F
+describes the font known
+.RI as\~ F
+on device
 .IR name .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff_out (@MAN5EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR addftinfo (@MAN1EXT@),
-.BR afmtodit (@MAN1EXT@)
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \lqinfo groff\rq.
 .
 .
 .P
-.\" XXX: Why is this paragraph _here_, of all places?
-A man page
-.IR name ( n )
-of section
-.I n
-can be viewed either with
-.RS
-\Do
-.BI man " n name"
-.RE
-for text mode or
-.RS
-\Do
-.BI groffer " n name"
-.RE
-for graphical mode (default is PDF mode).
+\lqTroff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
+widely called simply \lqCSTR\~#54\rq,
+documents the language,
+device and font description file formats,
+and device-independent output format
+referred to collectively in
+.I groff
+documentation as
+.RI \lqAT&T\~ troff \rq.
 .
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_font_C
+.P
+\lqA Typesetter-independent TROFF\rq
+by Brian W.\& Kernighan,
+1982,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
+provides additional insights into the
+device and font description file formats
+and device-independent output format.
 .
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.P
+.MR groff @MAN1EXT@ ,
+subsection \lqUtilities\rq,
+lists programs available for describing fonts in a variety of formats
+such that
+.I groff
+output drivers can use them.
+.
+.
+.P
+.MR @g@troff @MAN1EXT@
+documents the default device and font description file search path.
+.
+.
+.P
+.MR groff_out @MAN5EXT@ ,
+.MR addftinfo @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_font_5_man_C
+.do rr *groff_groff_font_5_man_C
+.
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/groff_out.5.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff_out.5.man Changed

@@ -1,23 +1,16 @@
-'\" e
-.TH GROFF_OUT @MAN5EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_out \- groff intermediate output format
-.
-.\" groff_out(5):
-.\" Source file position: <groff_source>/man/groff_out.man
-.\" Installed position: <prefix>/share/man/man5/groff_out.5
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_out_C \n.C
-.cp 0
+.TH groff_out @MAN5EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_out \- GNU
+.I roff
+intermediate output format
 .
 .
+.\" XXX: This page needs review and editing.
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -31,6 +24,26 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_out_5_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Setup
 .\" ====================================================================
@@ -38,13 +51,13 @@
 .\" ================= Document configuration
 .
 .\" Number register to decide whether the commands '{' and '}' are used
-.\" 0: disable (actual default); 1: enable
+.\" 0: disable (current default); 1: enable
 .nr @USE_ENV_STACK 0
 .
 .ig
 Unfortunately, old versions of groff used an illogical position change
-after some D\~commands (Dp, DP, Dt).  If the number register
-@STUPID_DRAWING_POSITIONING is 1 (actual default) then change position
+after some D\~commands (Dp, DP, Dt).  If the register
+@STUPID_DRAWING_POSITIONING is 1 (current default) then change position
 after these commands, otherwise the position is not changed.
 ..
 .nr @STUPID_DRAWING_POSITIONING 1
@@ -86,7 +99,7 @@
 .\" graphics command .D with a variable number of arguments
 .\" format: .D-multiarg <subcommand>
 .de D-multiarg
-\fBD\\$1\fP\ \*hv1 \*hv2 .\|.\|. \*hvn\|\*@linebreak
+\fBD\\$1\fP\ \*hv1 \*hv2 \&.\|.\|.\& \*hvn\|\*@linebreak
 ..
 .\" format: .x-command <subname> "<arguments>"
 .de x-command
@@ -100,111 +113,88 @@
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This manual page describes the
-.I intermediate output
-format of the GNU
-.BR roff (@MAN7EXT@)
-text processing system
-.BR groff (@MAN1EXT@).
-.
-This output is produced by a run of the GNU
-.BR @g@troff (@MAN1EXT@)
-program.
-.
-It contains already all device-specific information, but it is not yet
-fed into a device postprocessor program.
+The fundamental operation of the
+.MR @g@troff @MAN1EXT@
+formatter is the translation of the
+.MR groff @MAN7EXT@
+input language into a series of instructions concerned primarily with
+placing glyphs or geometric objects at specific positions on a
+rectangular page.
+.
+In the following discussion,
+the term
+.I command
+refers to this intermediate output language,
+never to the
+.MR groff @MAN7EXT@
+language intended for use by document authors.
+.
+Intermediate output commands comprise several categories:
+glyph output;
+font,
+color,
+and text size selection;
+motion of the printing position;
+page advancement;
+drawing of geometric primitives;
+and device control commands,
+a catch-all for other operations.
+.
+The last includes directives to start and stop output,
+identify the intended output device,
+and embed URL hyperlinks in supported output formats.
 .
 .
 .P
-As the GNU
-.I roff
-processor
-.BR groff (@MAN1EXT@)
-is a wrapper program around
-.B @g@troff
-that automatically calls a
-postprocessor, this output does not show up normally.
-.
-This is why it is called
-.I intermediate
-within the
-.I groff
-.IR system .
+Because the front-end command
+.MR groff @MAN1EXT@
+is a wrapper that normally runs the
+.I @g@troff
+formatter to generate intermediate output
+and an output driver (\lqpostprocessor\rq) to consume it,
+users normally do not encounter this language.
 .
 The
-.B groff
-program provides the option
-.B \-Z
-to inhibit postprocessing, such that the produced
-.I intermediate output
-is sent to standard output just like calling
-.B @g@troff
-manually.
-.
-.
-.P
-In this document, the term
-.I @g@troff output
-describes what is output by the GNU
-.B @g@troff
-program, while
-.I intermediate output
-refers to the language that is accepted by the parser that prepares
-this output for the postprocessors.
-.
-This parser is smarter on whitespace and implements obsolete elements
-for compatibility, otherwise both formats are the same.
-.
-Both formats can be viewed directly with
-.BR \%gxditview (@MAN1EXT@).
-.
-.
-.P
-The main purpose of the
-.I intermediate output
-concept is to facilitate the development of postprocessors by
-providing a common programming interface for all devices.
-.
-It has a language of its own that is completely different from the
-.BR groff (@MAN7EXT@)
-language.
-.
-While the
 .I groff
-language is a high-level programming language for text processing, the
-.I intermediate output
-language is a kind of low-level assembler language by specifying all
-positions on the page for writing and drawing.
+program's
+.B \-Z
+option inhibits postprocessing such that this intermediate output is
+sent to the standard output stream as when
+.I @g@troff
+is run manually.
 .
 .
 .P
-The
-.RI pre- groff
-.I roff
-versions are denoted as
-.I classical
-.IR troff .
-The
-.I intermediate output
-produced by
-.B groff
-is fairly readable, while
-.I classical troff
-output was hard to understand because of strange habits that are
-still supported, but not used any longer by
-.I GNU
-.IR @g@troff .
+.IR groff 's
+intermediate output facilitates the development of output drivers and
+other postprocessors by offering a common programming interface.
+.
+It is an extension of the page description language developed by Brian
+Kernighan for AT&T device-independent
+.I troff \" AT&T
+circa 1980.
+.
+Where a distinction is necessary,
+we will say
+.RI \lq @g@troff
+output\rq to describe the output of GNU
+.IR troff , \" GNU
+and \lqintermediate output\rq to denote the language accepted by
+the parser implemented in
+.IR groff 's
+internal C++ library used by most of its output drivers.
+.\" XXX GBR leaves off here.
 .
 .
 .\" ====================================================================
-.SH "LANGUAGE CONCEPTS"
+.SH "Language concepts"
 .\" ====================================================================
 .
 During the run of
-.BR @g@troff ,
+.IR @g@troff ,
 the
 .I roff
 input is cracked down to the information on what has to be printed at
@@ -227,14 +217,14 @@
 .
 .
 .\" ====================================================================
-.SS "Separation"
+.SS Separation
 .\" ====================================================================
 .
 .I Classical troff output
 had strange requirements on whitespace.
 .
 The
-.B groff
+.I groff
 output parser, however, is smart about whitespace by making it
 maximally optional.
 .
@@ -315,44 +305,39 @@
 command, i.e., the arguments may not be split by a line break.
 .
 .P
-Empty lines, i.e., lines containing only space and/or a comment, can
-occur everywhere.
-.
-They are just ignored.
+Lines containing only spaces and/or a comment are treated as empty and
+ignored.
 .
 .
 .\" ====================================================================
-.SS "Argument Units"
+.SS "Argument units"
 .\" ====================================================================
 .
-Some commands take integer arguments that are assumed to represent
-values in a measurement unit, but the letter for the corresponding
-.I scale indicator
-is not written with the output command arguments;
+Some commands accept integer arguments that represent measurements,
+but the scaling units of the formatter's language are never used.
+.
+Most commands assume a scaling unit
+.RB of\~\lq u \rq
+(basic units),
+and others
+.RB use\~\lq z \rq
+(scaled points);
+.
+These are defined by the parameters specified in the device's
+.I DESC
+file;
 see
-.BR groff (@MAN7EXT@)
+.MR groff_font @MAN5EXT@
+and,
+for more on scaling units,
+.MR groff @MAN7EXT@
 and
 .IR "Groff: The GNU Implementation of troff" ,
 the
 .I groff
-Texinfo manual,
-for more on this topic.
+Texinfo manual.
 .
-Most commands assume the scale indicator\~\c
-.BR u ,
-the basic unit of the device, some use\~\c
-.BR z ,
-the
-.I scaled point unit
-of the device, while others, such as the color commands expect plain
-integers.
-.
-Note that these scale indicators are relative to the chosen device.
-.
-They are defined by the parameters specified in the device's
-.I DESC
-file; see
-.BR groff_font (@MAN5EXT@).
+Color-related commands use dimensionless integers.
 .
 .
 .P
@@ -377,8 +362,9 @@
 .
 .
 .\" ====================================================================
-.SS "Document Parts"
+.SS "Document parts"
 .\" ====================================================================
+.
 A correct
 .I intermediate output
 document consists of two parts, the
@@ -451,7 +437,7 @@
 .
 .
 .\" ====================================================================
-.SH "COMMAND REFERENCE"
+.SH "Command reference"
 .\" ====================================================================
 .
 This section describes all
@@ -462,21 +448,17 @@
 .
 .
 .\" ====================================================================
-.SS "Comment Command"
+.SS "Comment command"
 .\" ====================================================================
 .
 .TP
-.BI # anything \laend-of-line\ra
+.BI # anything\c
+\laline-break\ra
 A comment.
 .
 Ignore any characters from the
-.BR # \~\c
-character up to the next newline character.
-.
-.P
-This command is the only possibility for commenting in the
-.I intermediate
-.IR output .
+.BR # \~character
+up to the next newline.
 .
 Each comment can be preceded by arbitrary
 .I syntactical
@@ -485,7 +467,7 @@
 .
 .
 .\" ====================================================================
-.SS "Simple Commands"
+.SS "Simple commands"
 .\" ====================================================================
 .
 The commands in this subsection have a command code consisting of a
@@ -506,14 +488,14 @@
 .
 A separating
 .I syntactical space
-is only necessary when two integer arguments would clash or if the
+is necessary only when two integer arguments would clash or if the
 preceding argument ends with a string argument.
 .
 .
 .if \n@USE_ENV_STACK=1 \{\
 .TP
 .command {
-Open a new environment by copying the actual device configuration data
+Open a new environment by copying the current device configuration data
 to the environment stack.
 .
 The current environment is setup by the device specification and
@@ -522,311 +504,344 @@
 .
 .TP
 .command }
-Close the actual environment (opened by a preceding
+Close the current environment
+(opened by a preceding
 .BR { \~command)
 and restore the previous environment from the environment
-stack as the actual device configuration data.
+stack as the current device configuration data.
 .
 .\}              \" endif @USE_ENV_STACK
 .
 .
 .TP
-.command C xxx \lawhite-space\ra
-Print a glyph (special character) named
-.IR xxx .
+.command C id \lawhite-space\ra
+Typeset the glyph of the special character
+.IR id .
 .
-The trailing
-.I syntactical space
-or
-.I line break
-is necessary to allow glyph names of arbitrary length.
-.
-The glyph is printed at the current print position; the
-glyph's size is read from the font file.
+Trailing syntactical space is necessary to allow special character names
+of arbitrary length.
 .
-The print position is not changed.
+The drawing position is not advanced.
+.\" XXX: Why does it matter that we read its size if we don't advance
+.\" the drawing position?
+.\" its size is read from the font description file.
 .
 .
 .TP
 .command c c
-Print glyph with single-letter name\~\c
-.I c
-at the current print position;
-the glyph's size is read from the font file.
+Typeset the glyph of the ordinary character
+.RI character\~ c .
 .
-The print position is not changed.
+The drawing position is not advanced.
+.\" XXX: Why does it matter that we read its size if we don't advance
+.\" the drawing position?
+.\" its size is read from the font description file.
 .
 .
 .TP
 .command f n
-Set font to font number\~\c
-.I n
-(a non-negative integer).
+Select the font mounted at
+.RI position\~ n .
+.
+.IR n\~ cannot
+be negative.
 .
 .
 .TP
 .command H n
-Move right to the absolute vertical position\~\c
-.I n
-(a non-negative integer in basic units\~\c
-.BR u )
-relative to left edge of current page.
+Horizontally move the drawing position to
+.IR n\~ basic
+units from the left edge of the page.
+.
+.IR n\~ cannot
+be negative.
 .
 .
 .TP
 .command h n
-Move
-.I n
-(a non-negative integer) basic units\~\c
-.B u
-horizontally to the right.
-.
-CSTR\~#54
-allows negative values for
+Move the drawing position right
 .I n
-also, but
-.I groff
-doesn't use this.
+basic units.
+.
+AT&T
+.I troff \" AT&T
+allowed negative
+.I n;
+GNU
+.I troff \" GNU
+does not produce such values,
+but
+.IR groff 's
+output driver library handles them.
 .
 .
 .TP
-.command m "color-scheme \fR\fPcomponent .\|.\|.\fR\fP"
-Set the color for text (glyphs), line drawing, and the outline of
-graphic objects using different color schemes; the analogous command
-for the filling color of graphic objects is
-.BR DF .
+.command m "scheme \fR\fcomponent\fR .\|.\|."
+Select the stroke color using the
+.IR component s
+in the color space
+.IR scheme .
 .
-The color components are specified as integer arguments between 0 and
-\n@maxcolor.
+Each
+.I component
+is an integer between 0 and \n@maxcolor.
 .
-The number of color components and their meaning vary for the
-different color schemes.
+The quantity of components and their meanings vary with each
+.IR scheme .
 .
-These commands are generated by the
-.I groff
-escape sequence
-.BR \*@backslashm .
-.
-No position changing.
-.
-These commands are a
+This command is a
 .I groff
 extension.
 .
 .
 .RS
-.
 .TP
 .command mc "cyan magenta yellow"
-Set color using the CMY color scheme, having the 3\~color components
-cyan, magenta, and yellow.
+Use the CMY color scheme with components
+cyan,
+magenta,
+and yellow.
 .
 .
 .TP
 .command md
-Set color to the default color value
-(black in most cases).
-.
-No component arguments.
+Use the default color
+(no components;
+black in most cases).
 .
 .
 .TP
-.command mg "gray"
-Set color to the shade of gray given by the argument, an integer
+.command mg gray
+Use a grayscale color scheme with a component ranging
 between 0 (black) and \n@maxcolor (white).
 .
 .
 .TP
 .command mk "cyan magenta yellow black"
-Set color using the CMYK color scheme, having the 4\~color components
-cyan, magenta, yellow, and black.
+Use the CMYK color scheme with components
+cyan,
+magenta,
+yellow,
+and black.
+.
 .
 .TP
 .command mr "red green blue"
-Set color using the RGB color scheme, having the 3\~color components
-red, green, and blue.
-.
+Use the RGB color scheme with components
+red,
+green,
+and blue.
 .RE
 .
 .
 .TP
 .command N n
-Print glyph with index\~\c
-.I n
-(an integer, normally non-negative) of the current font.
+Typeset the glyph with
+.RI index\~ n
+in the current font.
 .
-The print position is not changed.
+.IR n\~ is
+normally a non-negative integer.
 .
-If
-.B \-T\~html
-or
-.B \-T\~xhtml
-is used, negative values are emitted also to indicate an unbreakable
-space with given width.
-.
-For example,
-.B N\~\-193
-represents an unbreakable space which has a width of 193\|u.
+The drawing position is not advanced.
 .
-This command is a
-.I groff
-extension.
+The
+.B html
+and
+.B xhtml
+devices use this command with
+.RI negative\~ n
+to produce unbreakable space;
+the absolute value of
+.I n
+is taken and interpreted in basic units.
 .
 .
 .TP
-.command n b\ a
-Inform the device about a line break, but no positioning is done by
-this command.
+.command n b\~a
+Indicate a break.
 .
-In
-.I classical
-.IR troff ,
-the integer arguments
+No action is performed;
+the command is present to make the output more easily parsed.
+.
+The integers
 .I b
-and\~\c
-.I a
-informed about the space before and after the current line to
-make the
-.I intermediate output
-more human readable without performing any action.
+.RI and\~ a
+describe the vertical space amounts before and after the break,
+respectively.
 .
-In
-.IR groff ,
-they are just ignored, but they must be provided for compatibility
-reasons.
+GNU
+.I troff \" GNU
+issues this command but
+.IR groff 's
+output driver library ignores it.
+.
+See
+.B v
+and
+.BR V .
 .
 .
 .TP
 .command p n
-Begin a new page in the outprint.
+Begin a new page,
+setting its number
+.RI to\~ n .
 .
-The page number is set to\~\c
-.IR n .
+Each page is independent,
+even from those using the same number.
 .
-This page is completely independent of pages formerly processed even
-if those have the same page number.
+The vertical drawing position is set to\~0.
 .
-The vertical position on the outprint is automatically set to\~0.
-.
-All positioning, writing, and drawing is always done relative to a
-page, so a
+All positioning,
+writing,
+and drawing commands are interpreted in the context of a page,
+so a
 .BR p \~command
-must be issued before any of these commands.
+must precede them.
 .
 .
 .TP
 .command s n
-Set point size to
+Set type size to
 .I n
 scaled points
-(this is unit\~\c
-.B z
+.RB (unit\~ z
 in GNU
-.BR @g@troff ).
+.IR troff ). \" GNU
 .
-.I Classical troff
-used the unit
-.I points
-(\c
-.BR p )
+AT&T
+.I troff \" AT&T
+used unscaled points
+.RB ( p )
 instead;
 see section \lqCompatibility\rq below.
 .
 .
 .TP
-.command t xyz\|.\|.\|. \lawhite-space\ra
+.command t xyz\fR\|.\|.\|.\& \fR\lawhite-space\ra
 .TQ
-.command t "xyz\|.\|.\|.\& dummy-arg" \lawhite-space\ra
-Print a word, i.e., a sequence of glyphs with single-letter names
+.command t "xyz\fR\|.\|.\|.\&\f dummy-arg" \lawhite-space\ra
+Typeset word
+.IR xyz ;
+that is,
+set a sequence of ordinary glyphs named
 .IR x ,
 .IR y ,
 .IR z ,
-etc., terminated by a space character or a line break; an optional
-second integer argument is ignored (this allows the formatter to
-generate an even number of arguments).
+\&.\|.\|.\|,
+terminated by a space or newline;
+an optional second integer argument is ignored
+(this allows the formatter to generate an even number of arguments).
+.\" XXX: Why?
 .
-The first glyph should be printed at the current position, the
-current horizontal position should then be increased by the width of
-the first glyph, and so on for each glyph.
+Each glyph is set at the current drawing position,
+and the position is then advanced horizontally by the glyph's width.
 .
-The widths of the glyph are read from the font file, scaled for the
-current point size, and rounded to a multiple of the horizontal
-resolution.
+A glyph's width is read from its metrics in the font description file,
+scaled to the current type size,
+and rounded to a multiple of the horizontal motion quantum.
 .
-Special characters (glyphs with names longer than a single letter)
-cannot be printed using this command; use the
+Use the
 .B C
-command for those glyphs.
+command to emplace glyphs of special characters.
 .
-This command is a
+The
+.BR t \~command
+is a
 .I groff
-extension; it is only used for devices whose
+extension and is output only for devices whose
 .I DESC
 file contains the
 .B tcommand
-keyword; see
-.BR groff_font (@MAN5EXT@).
+directive;
+see
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
-.command u "n xyz\|.\|.\|." \lawhite-space\ra
-Print word with track kerning.
+.command u "n xyz"\fR\|.\|.\|.\& \fR\lawhite-space\ra
+.TQ
+.command u "xyz\fR\|.\|.\|.\&\f dummy-arg" \lawhite-space\ra
+Typeset word
+.I xyz
+with track kerning.
+.
+As
+.BR t ,
+but after placing each glyph,
+the drawing position is further advanced horizontally
+.RI by\~ n
+basic units.
 .
-This is the same as the
-.B t
-command except that after printing each glyph, the current
-horizontal position is increased by the sum of the width of that
-glyph and\~\c
-.I n
-(an integer in
-basic units\~\c
-.BR u ).
-This command is a
+The
+.BR u \~command
+is a
 .I groff
-extension; it is only used for devices whose
+extension and is output only for devices whose
 .I DESC
 file contains the
 .B tcommand
-keyword; see
-.BR groff_font (@MAN5EXT@).
+directive;
+see
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
 .command V n
-Move down to the absolute vertical position\~\c
-.I n
-(a non-negative integer in basic units\~\c
-.BR u )
-relative to upper edge of current page.
+Vertically move the drawing position to
+.IR n\~ basic
+units from the top edge of the page.
+.
+.IR n\~ cannot
+be negative.
 .
 .
 .TP
 .command v n
-Move
+Move the drawing position down
 .I n
-basic units\~\c
-.B u
-down
-.RI ( n
-is a non-negative integer).
-.
-CSTR\~#54
-allows negative values for
-.I n
-also, but
-.I groff
-doesn't use this.
+basic units.
+.
+AT&T
+.I troff \" AT&T
+allowed negative
+.I n;
+GNU
+.I troff \" GNU
+does not produce such values,
+but
+.IR groff 's
+output driver library handles them.
 .
 .
 .TP
 .command w
-Informs about a paddable whitespace to increase readability.
+Indicate an inter-word space.
+.
+No action is performed;
+the command is present to make the output more easily parsed.
+.
+Only adjustable,
+breakable inter-word spaces are thus described;
+those resulting from
+.B \rs\ti
+or horizontal motion escape sequences are not.
 .
-The spacing itself must be performed explicitly by a move command.
+GNU
+.I troff \" GNU
+issues this command but
+.IR groff 's
+output driver library ignores it.
+.
+See
+.B h
+and
+.BR H .
 .
 .
 .\" ====================================================================
-.SS "Graphics Commands"
+.SS "Graphics commands"
 .\" ====================================================================
 .
 Each graphics or drawing command in the
@@ -848,7 +863,7 @@
 .
 .
 .P
-.B @g@troff
+.I @g@troff
 output follows the classical spacing rules (no space between command
 and subcommand, all arguments are preceded by a single space
 character), but the parser allows optional space between the command
@@ -884,7 +899,7 @@
 .I groff
 .B \*@backslashD
 escape sequence; see
-.BR groff (@MAN7EXT@).
+.MR groff @MAN7EXT@ .
 .
 .
 .P
@@ -985,7 +1000,7 @@
 .
 .
 .TP
-.D-command F "color-scheme \fR\fPcomponent .\|.\|.\fR\fP"
+.D-command F "color-scheme \fR\fPcomponent\fR .\|.\|.\fP"
 Set fill color for solid drawing objects using different color
 schemes; the analogous command for setting the color of text, line
 graphics, and the outline of graphic objects is
@@ -1000,13 +1015,11 @@
 These commands are generated by the
 .I groff
 escape sequences
-.BR \*@backslashD'F\  .\|.\|. '
+.BR \*@backslashD\aqF\  .\|.\|. '
 and
 .B \*@backslashM
 (with no other corresponding graphics commands).
 .
-No position changing.
-.
 This command is a
 .I groff
 extension.
@@ -1081,8 +1094,6 @@
 sets all colors to blue.
 .
 .P
-No position changing.
-.
 This command is a
 .I groff
 extension.
@@ -1111,7 +1122,7 @@
 .
 .ie \n@STUPID_DRAWING_POSITIONING=1 \{\
 For historical reasons, the position is changed by adding the sum of
-all arguments with odd index to the actual horizontal position and the
+all arguments with odd index to the current horizontal position and the
 even ones to the vertical position.
 .
 Although this doesn't make sense it is kept for compatibility.
@@ -1134,12 +1145,10 @@
 command with the same arguments, but draws a solid polygon in the
 current fill color rather than an outlined polygon.
 .
-.ie \n@STUPID_DRAWING_POSITIONING=1 \{\
+.if \n@STUPID_DRAWING_POSITIONING=1 \{\
 The position is changed in the same way as with
 .BR Dp .
 .\}
-.el \
-No position changing.
 .
 This command is a
 .I groff
@@ -1148,31 +1157,28 @@
 .
 .TP
 .D-command t n
-Set the current line thickness to\~\c
-.I n
-(an integer in basic units\~\c
-.BR u )
+Set the current line thickness
+.RI to\~ n
+(an integer in basic
+.RB units\~ u )
 if
 .IR n \|>\|0;
 if
 .IR n \|=\|0
-select the smallest available line thickness; if
-.IR n \|<\|0
-set the line thickness proportional to the point size (this is the
-default before the first
-.B Dt
-command was specified).
-.
-.ie \n@STUPID_DRAWING_POSITIONING=1 \{\
-For historical reasons, the horizontal position is changed by adding
-the argument to the actual horizontal position, while the vertical
-position is not changed.
-.
-Although this doesn't make sense it is kept for compatibility.
-.
+select the smallest available line thickness;
+otherwise,
+the line thickness is made proportional to the type size,
+which is the default.
+.
+.if \n@STUPID_DRAWING_POSITIONING=1 \{\
+For historical reasons,
+the horizontal position is changed by adding the argument to the current
+horizontal position,
+while the vertical position is not changed.
+.
+Although this doesn't make sense,
+it is kept for compatibility.
 .\}
-.el \
-No position changing.
 .
 This command is a
 .I groff
@@ -1180,7 +1186,7 @@
 .
 .
 .\" ====================================================================
-.SS "Device Control Commands"
+.SS "Device control commands"
 .\" ====================================================================
 .
 Each device control command starts with the letter
@@ -1207,7 +1213,7 @@
 All characters of the subcommand word but the first are simply ignored.
 .
 For example,
-.B @g@troff
+.I @g@troff
 outputs the initialization command
 .B x\ i
 as
@@ -1238,7 +1244,7 @@
 as the intended name for the current file in error reports.
 .
 This is useful for remembering the original file name when
-.B groff
+.I groff
 uses an internal piping mechanism.
 .
 The input file is not changed by this command.
@@ -1257,7 +1263,7 @@
 .I s
 (a text word);
 see
-.BR groff_font (@MAN5EXT@).
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
@@ -1337,22 +1343,23 @@
 .
 In
 .BR groff ,
-this is actually just ignored.
+this is currently ignored.
 .
 .
 .TP
 .x-command T xxx
 .xsub Typesetter
-Set name of device to word
+.
+Set the name of the output driver to
 .IR xxx ,
-a sequence of characters ended by the next whitespace character.
+a sequence of non-whitespace characters terminated by whitespace.
 .
-The possible device names coincide with those from the groff
+The possible names correspond to those of
+.IR groff 's
 .B \-T
 option.
 .
-This is the first command of the
-.IR prologue .
+This is the first command of the prologue.
 .
 .
 .TP
@@ -1411,7 +1418,7 @@
 .
 .
 .\" ====================================================================
-.SS "Obsolete Command"
+.SS "Obsolete command"
 .\" ====================================================================
 .
 In
@@ -1459,24 +1466,24 @@
 decimal digits.
 .
 In
-.BR groff ,
-this is only used for the devices
+.IR groff ,
+it is used only for output to the
 .BR X75 ,
-.BR X75-12 ,
+.BR X75\-12 ,
 .BR X100 ,
 and
-.BR X100-12 .
+.B X100\-12
+devices.
 .
-For other devices,
+For others,
 the commands
 .B t
-and\~\c
-.B u
-provide a better functionality.
+.RB and\~ u
+provide greater functionality and superior troubleshooting capacity.
 .
 .
 .\" ====================================================================
-.SH "POSTPROCESSING"
+.SH Postprocessing
 .\" ====================================================================
 .
 The
@@ -1507,7 +1514,7 @@
 .
 .
 .\" ====================================================================
-.SH "EXAMPLES"
+.SH Example
 .\" ====================================================================
 .
 This section presents the
@@ -1517,7 +1524,7 @@
 The input is the sentence
 .I hell world
 fed into
-.B groff
+.I groff
 on the command line.
 .
 .
@@ -1529,13 +1536,12 @@
 .RS
 .P
 .EX
-\fBshell>\fP echo "hell world" | groff \-Z \-T ps
+.RB "shell>\~" "echo \dqhell world\dq | groff \-Z \-T ps"
 .EE
 .
 .
 .P
-.nf
-.ft CB
+.EX
 x T ps
 x res 72000 1 1
 x init
@@ -1554,16 +1560,15 @@
 x trailer
 V792000
 x stop
-.ft P
-.fi
+.EE
 .RE
 .
 .
 .P
 This output can be fed into the postprocessor
-.BR grops (@MAN1EXT@)
+.MR grops @MAN1EXT@
 to get its representation as a PostScript file, or
-.BR gropdf (@MAN1EXT@)
+.MR gropdf @MAN1EXT@
 to output directly to PDF.
 .
 .
@@ -1590,49 +1595,39 @@
 .
 .
 .P
-.nf
-.I "# prologue"
-.ft CB
+.EX
+.I # prologue
 x T latin1
 x res 240 24 40
 x init
-.I "# begin a new page"
-.ft CB
+.I # begin a new page
 p1
-.I "# font setup"
-.ft CB
+.I # font setup
 x font 1 R
 f1
 s10
-.I "# initial positioning on the page"
-.ft CB
+.I # initial positioning on the page
 V40
 H0
-.I "# write text \oqhell\cq"
-.ft CB
+.I # write text \aqhell\aq
 thell
-.I "# inform about a space, and do it by a horizontal jump"
-.ft CB
+.I # inform about a space, and do it by a horizontal jump
 wh24
-.I "# write text \oqworld\cq"
-.ft CB
+.I # write text \aqworld\aq
 tworld
-.I "# announce line break, but do nothing because ..."
-.ft CB
+.I # announce line break, but do nothing because ...
 n40 0
-.I "# ... the end of the document has been reached"
-.ft CB
+.I # ... the end of the document has been reached
 x trailer
 V2640
 x stop
-.ft P
-.fi
+.EE
 .RE
 .
 .
 .P
 This output can be fed into the postprocessor
-.BR grotty (@MAN1EXT@)
+.MR grotty @MAN1EXT@
 to get a formatted text document.
 .
 .
@@ -1656,8 +1651,7 @@
 .
 .
 .P
-.nf
-.ft CB
+.EX
 x T X100
 x res 100 1 1
 x init
@@ -1667,23 +1661,21 @@
 s10
 V16
 H100
-.I "# write text with old-style jump-and-write command"
-.ft CB
+.I # write text with old-style jump-and-write command
 ch07e07l03lw06w11o07r05l03dh7
 n16 0
 x trailer
 V1100
 x stop
-.ft P
-.fi
+.EE
 .RE
 .
 .
 .P
 This output can be fed into the postprocessor
-.BR \%xditview (1x)
+.MR xditview 1x
 or
-.BR \%gxditview (@MAN1EXT@)
+.MR gxditview @MAN1EXT@
 for displaying in\~X.
 .
 .
@@ -1693,7 +1685,7 @@
 .
 .
 .\" ====================================================================
-.SH "COMPATIBILITY"
+.SH Compatibility
 .\" ====================================================================
 .
 The
@@ -1701,7 +1693,7 @@
 language of the
 .I classical troff
 was first documented in
-CSTR\~#97 .
+CSTR\~#97.
 .
 The
 .I groff intermediate output
@@ -1816,191 +1808,156 @@
 and
 .I classical troff
 are documented in
-.BR groff_diff (@MAN7EXT@).
+.MR groff_diff @MAN7EXT@ .
 .
 .
 .\" ====================================================================
-.SH "FILES"
+.SH Files
 .\" ====================================================================
 .
 .TP
-.IR @FONTDIR@/dev name /DESC
-Device description file for device
+.IR @FONTDIR@/\:\%dev name /\:DESC
+describes the output device
 .IR name .
 .
-.TP
-.I src/libs/libdriver/input.cpp
-Defines the parser and postprocessor for the
-.I intermediate
-.IR output .
-.
-It is located relative to the top directory of the
-.I groff
-source tree.
-.
-This parser is the definitive specification of the
-.I groff intermediate output
-format.
-.
 .
+.br
+.ne 4v
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-James Clark wrote an early version of this document, which described
-only the differences between
-.BR ditroff (7)'s
+.
+James Clark wrote an early version of this document,
+which described only the differences between AT&T
+device-independent
+.IR troff 's
 output format and that of GNU
 .IR roff .
 .
 The present version was completely rewritten in 2001 by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-A reference like
-.BR groff (@MAN7EXT@)
-refers to a manual page; here
-.B groff
-in section\~\c
-.I @MAN7EXT@
-of the man page documentation system.
+.P
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
 .
-To read the example, look up section\~@MAN7EXT@ in your desktop help
-system or call from the shell prompt
+You can browse it interactively with \lqinfo groff\rq.
 .
 .
-.RS
 .P
-.EX
-\fBshell>\fP man @MAN7EXT@ groff
-.EE
-.RE
+\lqTroff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54,
+widely called simply \lqCSTR\~#54\rq,
+documents the language,
+device and font description file formats,
+and device-independent output format
+referred to collectively in
+.I groff
+documentation as
+.RI \lqAT&T\~ troff \rq.
 .
 .
 .P
-For more details, see
-.BR man (1).
+\lqA Typesetter-independent TROFF\rq
+by Brian W.\& Kernighan,
+1982,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 97,
+provides additional insights into the
+device and font description file formats
+and device-independent output format.
 .
 .
 .TP
-.BR groff (@MAN1EXT@)
-option
+.MR groff @MAN1EXT@
+documents the
 .B \-Z
-and further readings on groff.
+option and contains pointers to further
+.I groff
+documentation.
 .
 .
 .TP
-.BR groff (@MAN7EXT@)
-for details of the
+.MR groff @MAN7EXT@
+describes the
 .I groff
-language such as numerical units and escape sequences.
+language,
+including its escape sequences and system of units.
 .
 .
 .TP
-.BR groff_font (@MAN5EXT@)
-for details on the device scaling parameters of the
+.MR groff_font @MAN5EXT@
+details the device scaling parameters of device
 .I DESC
-file.
+files.
 .
 .
 .TP
-.BR @g@troff (@MAN1EXT@)
-generates the device-independent intermediate output.
+.MR @g@troff @MAN1EXT@
+generates the device-independent intermediate output documented here.
 .
 .
 .TP
-.BR roff (@MAN7EXT@)
-for historical aspects and the general structure of roff systems.
+.MR roff @MAN7EXT@
+presents historical aspects and the general structure of
+.I roff
+systems.
 .
 .
 .TP
-.BR groff_diff (@MAN7EXT@)
-The differences between the intermediate output in groff and classical
-troff.
+.MR groff_diff @MAN7EXT@
+enumerates differences between the intermediate output produced by AT&T
+.I troff \" AT&T
+and that of
+.IR groff .
 .
 .
 .TP
-.BR gxditview (@MAN1EXT@)
-Viewer for the
-.I intermediate
-.IR output .
-.
-.
-.P
-.BR \%grodvi (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
-.BR \%grolbp (@MAN1EXT@),
-.BR \%grolj4 (@MAN1EXT@),
-.BR \%grops (@MAN1EXT@),
-.BR \%grotty (@MAN1EXT@)
-.br
-.RS
-the groff postprocessor programs.
-.RE
-.
-.
-.P
-.IR "Groff: The GNU Implementation of troff" ,
-by Trent A.\& Fisher and Werner Lemberg,
-is the primary
-.I groff
-manual.
-.
-You can browse it interactively with \lqinfo groff\rq.
-.
-.
-.P
-The
-.I classical troff output language
-is described in two AT&T Bell Labs CSTR documents available on-line at
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr.html
-Bell Labs CSTR site
-.UE .
+.MR gxditview @MAN1EXT@
+is a viewer for intermediate output.
 .
 .
 .TP
-CSTR #97
-.I A Typesetter-independent TROFF
-by
-.I Brian Kernighan
-is the original and most comprehensive documentation on the output
-language; see
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz
-CSTR\~#97
-.UE .
+.UR https://\:github.com/\:Alhadis/\:Roff\:.js/
+.I Roff.js
+.UE
+is a viewer for intermediate output written in JavaScript.
 .
 .
-.TP
-CSTR\~#54
-The 1992 revision of the
-.I Nroff/\:Troff User's Manual
-by
-.I J.\& F.\& Ossanna
+.P
+.MR grodvi @MAN1EXT@ ,
+.MR grohtml @MAN1EXT@ ,
+.MR grolbp @MAN1EXT@ ,
+.MR grolj4 @MAN1EXT@ ,
+.MR gropdf @MAN1EXT@ ,
+.MR grops @MAN1EXT@ ,
 and
-.I Brian Kernighan
-isn't as comprehensive as
-CSTR\~#97
-regarding the output language; see
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:54.ps.gz
-CSTR\~#54
-.UE .
+.MR grotty @MAN1EXT@
+are
+.I groff
+postprocessors.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_out_C
-.
+.cp \n*groff_groff_out_5_man_C
+.do rr *groff_groff_out_5_man_C
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/groff_tmac.5.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/groff_tmac.5.man Changed

@@ -1,24 +1,17 @@
-.TH GROFF_TMAC @MAN5EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_tmac \- macro files in the roff typesetting system
-.
-.\" groff_tmac(5):
-.\" Source file position: <groff_source>/man/groff_tmac.man
-.\" Installed position: <prefix>/share/man/man5/groff_tmac.5
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_tmac_C \n.C
-.cp 0
+.TH groff_tmac @MAN5EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_tmac \- macro files in the GNU
+.I roff
+typesetting system
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2022 Free Software Foundation, Inc.
 .\"
-.\" This file is part of groff, the GNU roff type-setting system.
+.\" This file is part of groff, the GNU roff typesetting system.
 .\"
 .\" Permission is granted to copy, distribute and/or modify this
 .\" document under the terms of the GNU Free Documentation License,
@@ -30,111 +23,221 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
-.ds Ellipsis \&.\|.\|.\&\"
-.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_tmac_5_man_C \n.cp
+.cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" TODO: Consider parallelizing with our Texinfo node "Macro Packages".
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The
-.BR roff (@MAN7EXT@)
-type-setting system provides a set of macro packages suitable for
-special kinds of documents.
+Definitions of macros,
+strings,
+and registers for use in a
+.MR roff @MAN7EXT@
+document can be collected into
+.IR "macro files" ,
+.I roff
+input files designed to produce no output themselves but instead ease
+the preparation of other
+.I roff
+documents.
+.
+There is no syntactical difference between a macro file and any other
+.I roff
+document;
+only its purpose distinguishes it.
+.
+When a macro file is installed at a standard location,
+named according to a certain convention,
+and suitable for use by a general audience,
+it is termed a
+.IR "macro package" .
+.
+Macro packages can be loaded by supplying the
+.B \-m
+option to
+.MR @g@troff @MAN1EXT@
+or a
+.I groff
+front end.
 .
-Each macro package stores its macros and definitions in a file called
-the package's
-.BR "tmac file" .
 .
-The name is deduced from
-.RB \oq T\c
-.IB roff MAC\c
-.IR ros \cq.
+.P
+Each macro package stores its macro,
+string,
+and register definitions in one or more
+.I tmac
+files.
+.
+This name originated in early Unix culture as an abbreviation of
+.RI \lq troff \" generic
+macros\rq.
 .
 .
 .P
-The tmac files are normal roff source documents, except that they
-usually contain only definitions and setup commands, but no text.
+A macro file must have a name in the form
+.RI name .tmac
+(or
+.IR tmac. name)
+and be placed in a
+.RI \lq tmac
+directory\rq to be loadable with the
+.BI \-m name
+option.
+.
+Section \lqEnvironment\rq of
+.MR @g@troff @MAN1EXT@
+lists these directories.
+.
+Alternatively,
+a
+.I groff
+document requiring a macro file can load it with the
+.B mso
+(\lqmacro source\rq) request.
 .
-All tmac files are kept in a single or a small number of directories,
-the
-.B tmac
-directories.
 .
+.P
+Like any other
+.I roff
+document,
+a macro file can use the
+.RB \lq so \rq
+request (\lqsource\rq) to load further files relative to its own
+location.
 .
-.\" ====================================================================
-.SH "GROFF MACRO PACKAGES"
-.\" ====================================================================
 .
+.P
+Macro files are named for their most noteworthy application,
+but a macro file need not define any macros.
+.
+It can restrict itself to defining registers and strings or invoking
+other
 .I groff
-provides all classical macro packages, some more full packages, and
-some secondary packages for special purposes.
+requests.
 .
-Note that it is not possible to use multiple primary macro packages at
-the same time; saying e.g.\&
+It can even be empty.
 .
-.IP
-.EX
-\fIsh#\fP groff \-m man \-m ms foo
-.EE
 .
+.\" ====================================================================
+.SH "Macro packages"
+.\" ====================================================================
 .
-.P
-or
+Macro packages come in two varieties;
+those which assume responsibility for page layout and other critical
+functions
+(\lqmajor\rq or \lqfull-service\rq)
+and those which do not
+(\lqsupplemental\rq or \lqauxiliary\rq).
 .
-.IP
-.EX
-\fIsh#\fP groff \-m man foo \-m ms bar
-.EE
+GNU
+.I roff
+provides most major macro packages found in AT&T and BSD Unix systems,
+an additional full-service package,
+and many supplemental packages.
 .
-.P
-fails.
-.
-Exception to this is the use of man pages written with either the
-.B mdoc
-or the
-.B man
-macro package.
-See below the description of the
-.I andoc.tmac
-file.
+Multiple full-service macro packages cannot be used by the same
+document.
+.
+Auxiliary packages can generally be freely combined,
+though attention to their use of the
+.I groff
+language name spaces for identifiers
+(particularly registers,
+macros,
+strings,
+and diversions)
+should be paid.
+.
+Name space management was a significant challenge in AT&T
+.IR troff ;
+.IR groff 's
+support for arbitrarily long identifiers affords few excuses for name
+collisions,
+apart from attempts at compatibility with the demands of historical
+documents.
 .
 .
 .\" ====================================================================
-.SS "Man\~Pages"
+.SS "Man pages"
 .\" ====================================================================
 .
 .TP
+.I an
+.TQ
 .I man
-This is the classical macro package for Unix manual pages
-(man\~pages); it is quite handy and easy to use; see
-.BR groff_man (@MAN7EXT@).
+.I an
+is used to compose man pages in the format originating in Version\~7
+Unix (1979).
+.
+It has a small macro interface and is widely used;
+see
+.MR groff_man @MAN7EXT@ .
 .
 .
 .TP
 .I doc
 .TQ
 .I mdoc
-An alternative macro package for man\~pages mainly used in BSD
-systems; it provides many new features, but it is not the standard for
-man\~pages; see
-.BR groff_mdoc (@MAN7EXT@).
+.I doc
+is used to compose man pages in the format originating in 4.3BSD-Reno
+(1990).
+.
+It provides many more features than
+.IR an ,
+but is also larger,
+more complex,
+and not as widely adopted;
+see
+.MR groff_mdoc @MAN7EXT@ .
+.
+.
+.P
+Because readers of man pages often do not know in advance which macros
+are used to format a given document,
+a wrapper is available.
 .
 .
 .TP
-.I andoc
+.I \%andoc
 .TQ
 .I mandoc
-Use this file in case you don't know whether the
-.B man
-macros or the
-.B mdoc
-package should be used.
-Multiple man pages (in either format) can be handled.
+This macro file,
+specific to
+.IR groff ,
+recognizes whether a document uses
+.I man
+or
+.I mdoc
+format and loads the corresponding macro package.
+.
+Multiple man pages,
+in either format,
+can be handled;
+.I \%andoc
+reloads each macro package as necessary.
 .
 .
 .\" ====================================================================
-.SS "Full Packages"
+.SS "Full-service packages"
 .\" ====================================================================
 .
 The packages in this section provide a complete set of macros for
@@ -149,7 +252,7 @@
 The classical
 .I me
 macro package; see
-.BR groff_me (@MAN7EXT@).
+.MR groff_me @MAN7EXT@ .
 .
 .
 .TP
@@ -157,21 +260,20 @@
 The semi-classical
 .I mm
 macro package; see
-.BR groff_mm (@MAN7EXT@).
+.MR groff_mm @MAN7EXT@ .
 .
 .
 .TP
 .I mom
-The new
+The
 .I mom
 macro package, only available in groff.
 .
-As this is not based on other packages, it can be freely designed.
-.
-So it is expected to become quite a nice, modern macro package.
+As this was not based on other packages, it was freely designed as
+quite a nice, modern macro package.
 .
 See
-.BR groff_mom (@MAN7EXT@).
+.MR groff_mom @MAN7EXT@ .
 .
 .
 .TP
@@ -179,78 +281,150 @@
 The classical
 .I ms
 macro package; see
-.BR groff_ms (@MAN7EXT@).
+.MR groff_ms @MAN7EXT@ .
 .
 .
 .\" ====================================================================
-.SS "Language-specific Packages"
+.SS "Localization packages"
 .\" ====================================================================
 .
+For Western languages,
+the localization file sets the hyphenation mode and loads hyphenation
+patterns and exceptions.
+.
+Localization files can also adjust the date format and provide
+translations of strings used by some of the full-service macro packages;
+alter the input encoding
+(see the next section);
+and change the amount of additional inter-sentence space.
+.
+For Eastern languages,
+the localization file defines character classes and sets flags on them.
+.
+By default,
+.I troffrc
+loads the localization file for English.
+.
+.
+.TP
+.I trans
+loads localized strings used by various macro packages after their
+localized forms have been prepared by a localization macro file.
+.
+.
+.P
+.I groff
+provides the following localization files.
+.
+.
 .TP
 .I cs
-This file adds support for Czech localization, including the main macro
-packages (me, mom, mm, and ms).
+Czech;
+localizes
+.IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+and
+.IR ms .
 .
-.IP
-Note that
-.I cs.tmac
-sets the input encoding to latin-2.
+Sets the input encoding to Latin-2 by loading
+.IR latin2.tmac .
 .
 .
 .TP
 .I de
 .TQ
 .I den
-German localization support, including the main macro packages (me, mom,
-mm, and ms).
+German;
+localizes
+.IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+and
+.IR ms .
+.
+Sets the input encoding to Latin-1 by loading
+.IR latin1.tmac .
+.
 .
 .IP
 .I de.tmac
-selects hyphenation patterns for traditional orthography, and
+selects hyphenation patterns for traditional orthography,
+and
 .I den.tmac
 does the same for the new orthography
-(\oqRecht\%schreib\%reform\cq).
+(\lqRecht\%schreib\%reform\rq).
 .
-It should be used as the last macro package on the command line.
+.
+.TP
+.I en
+English.
 .
 .
 .TP
 .I fr
-This file adds support for French localization, including the main macro
-packages (me, mom, mm, and ms).
+French;
+localizes
+.IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+and
+.IR ms .
 .
+Sets the input encoding to Latin-9 by loading
+.IR latin9.tmac .
 .
-Example:
-.RS
-.IP
-.EX
-\fIsh#\fP groff \-ms \-mfr foo.ms > foo.ps
-.EE
-.RE
 .
-.IP
-Note that
-.I fr.tmac
-sets the input encoding to latin-9 to get proper support of the
-\oqoe\cq ligature.
+.TP
+.I it
+Italian;
+localizes
+.IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+and
+.IR ms .
+.
+.
+.TP
+.I ja
+Japanese.
 .
 .
 .TP
 .I sv
-Swedish localization support, including the me, mom, and ms macro
-packages.
+Swedish;
+localizes
+.IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+and
+.IR ms .
 .
-Note that Swedish for the mm macros is handled separately; see
-.BR groff_mmse (@MAN7EXT@).
+Sets the input encoding to Latin-1 by loading
+.IR latin1.tmac .
+.
+Some of the localization of the
+.I mm
+package is handled separately;
+see
+.MR groff_mmse @MAN7EXT@ .
 .
-It should be used as the last macro package on the command line.
+.
+.TP
+.I zh
+Chinese.
 .
 .
 .\" ====================================================================
-.SS "Input Encodings"
+.SS "Input encodings"
 .\" ====================================================================
 .
-.
 .TP
 .I latin1
 .TQ
@@ -259,216 +433,260 @@
 .I latin5
 .TQ
 .I latin9
-Various input encodings supported directly by groff.
+are various ISO\~8859 input encodings supported by
+.IR groff .
 .
-Normally, this macro is loaded at the very beginning of a document or
-specified as the first macro argument on the command line.
-.
-.B @g@roff
-loads latin1 by default at start-up.
+On systems using ISO character encodings,
+.I groff
+loads
+.I latin1.tmac
+automatically at startup.
 .
-Note that these macro packages don't work on EBCDIC hosts.
+A document that uses Latin-2,
+Latin-5,
+or Latin-9
+can specify one of these alternative encodings.
 .
 .
 .TP
 .I cp1047
-Encoding support for EBCDIC.
-.
-On those platforms it is loaded automatically at start-up.
-.
-Due to different character ranges used in
-.B @g@roff
-it doesn't work on architectures which are based on ASCII.
-.
-.
-.P
-Note that it can happen that some input encoding characters are not
-available for a particular output device.
+provides support for EBCDIC-based systems.
 .
-For example, saying
+On those platforms,
+.I groff
+loads
+.I cp1047.tmac
+automatically at startup.
 .
-.P
-.EX
-groff \-Tlatin1 \-mlatin9 ...
-.EE
 .
 .P
-fails if you use the Euro character in the input.
-.
-Usually, this limitation is present only for devices which have a
-limited set of output glyphs
-.RB ( \-Tascii ,
-.BR \-Tlatin1 );
-for other devices it is usually sufficient to install proper
-fonts which contain the necessary glyphs.
+Because different input character codes constitute valid GNU
+.I troff \" GNU
+input on ISO and EBCDIC systems,
+the
+.I latin
+macro files cannot be used on EBCDIC systems,
+and
+.I cp1047
+cannot be used on ISO systems.
 .
 .
 .\" ====================================================================
-.SS "Special Packages"
+.SS "Auxiliary packages"
 .\" ====================================================================
 .
 The macro packages in this section are not intended for stand-alone
-usage, but can be used to add special functionality to any other
-macro package or to plain groff.
+use,
+but can add functionality to any other macro package or to plain
+(\lqraw\rq)
+.I groff
+documents.
 .
 .
+.\" TODO:
+.\"   a4
+.\"   devtag
+.\"   doc-old
+.\"   europs
+.\"   psatk
+.\"   psfig
 .TP
 .I 62bit
-Provides macros for addition, multiplication, and division of 62-bit
-integers (allowing safe multiplication of 31-bit integers, for example).
-.
-.
-.TP
-.I ec
-Switch to the EC and TC font families.
-.
-To be used with
-.BR \%grodvi (@MAN1EXT@)
-\en this man page also gives more details of how to use it.
+provides macros for addition,
+multiplication,
+and division of 62-bit integers
+(allowing safe multiplication of signed 31-bit integers,
+for example).
 .
 .
 .TP
 .I hdtbl
-The Heidelberger table macros, contributed by Joachim Walsdorff, allow
-the generation of tables through a syntax similar to the HTML table
+allows the generation of tables using a syntax similar to the HTML table
 model.
 .
-Note that
-.I hdtbl
-is a macro package, not a preprocessor like
-.BR tbl (@MAN1EXT@).
+This Heidelberger table macro package is not a preprocessor,
+which can be useful if the contents of table entries are determined by
+macro calls or string interpolations.
 .
-.I hdtbl
-works only with the
-.B \-Tps
+Compare to
+.MR @g@tbl @MAN1EXT@ .
+.
+It works only with the
+.B ps
 and
-.B \-Tpdf
+.B pdf
 output devices.
 .
 See
-.BR groff_hdtbl (@MAN7EXT@) .
+.MR groff_hdtbl @MAN7EXT@ .
 .
 .
 .TP
 .I papersize
-This macro file is already loaded at start-up by
-.B @g@troff
-so it isn't necessary to call it explicitly.
-.
-It provides an interface to set the paper size on the command line with
-the option \fB\%\-dpaper=\f\,\fIsize\f.
+enables the paper format to be set on the command line by giving a
+.RB \lq \-d
+.BI \%paper= format\c
+\rq
+option to
+.IR @g@troff .
 .
 Possible values for
-.I size
-are the same as the predefined
-.B papersize
-values in the DESC file (only lowercase; see
-.BR groff_font (@MAN5EXT@)
-for more) except
-.BR a7 \en d7 .
-.
-An appended
-.B l
-(ell) character denotes landscape orientation.
-.
-Examples:
-.BR a4 ,
-.BR c3l ,
-.BR letterl .
+.I format
+are the ISO and DIN formats
+.RB \lq A0 \en A6 \rq,
+.RB \lq B0 \en B6 \rq,
+.RB \lq C0 \en C6 \rq,
+and
+.RB \lq D0 \en D6 \rq;
+.\" XXX: src/libs/libgroff/paper.cpp also supports ABCD7.
+the U.S.\& formats
+.RB \%\lq letter \rq,
+.RB \%\lq legal \rq,
+.RB \%\lq tabloid \rq,
+.RB \%\lq ledger \rq,
+.RB \%\lq statement \rq,
+and
+.RB \%\lq executive \rq;
+and the envelope formats
+.RB \%\lq com10 \rq,
+.RB \%\lq monarch \rq,
+and
+.RB \%\lq DL \rq.
 .
-.IP
-Most output drivers need additional command-line switches
+All formats,
+even those for envelopes,
+are in portrait orientation:
+the length measurement is vertical.
+.
+Appending \lql\rq (ell) to any of these denotes landscape
+orientation instead.
+.
+This macro file assumes one-inch horizontal margins,
+and sets registers recognized by the
+.I groff
+.IR man ,
+.IR mdoc ,
+.IR mm ,
+.IR mom ,
+and
+.I ms
+packages to configure them accordingly.
+.
+If you want different margins,
+you will need to use those packages' facilities,
+or
+.I @g@troff
+.B ll
+and/or
+.B po
+requests to adjust them.
+.
+An output device typically requires command-line options
 .B \-p
 and
 .B \-l
-to override the default paper length and orientation as set in the
-driver-specific DESC file.
-.
-For example, use the following for PS output on A4 paper in landscape
-orientation:
+to override the paper dimensions and orientation,
+respectively,
+defined in its
+.I DESC
+file;
+see subsection \lqPaper format\rq
+of
+.MR groff @MAN1EXT@ .
 .
-.IP
-.EX
-\fIsh#\fP groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms > foo.ps
-.EE
+This macro file is normally loaded at startup by the
+.I troffrc
+file when formatting for a typesetting device
+(but not a terminal).
 .
 .
 .TP
 .I pdfpic
-A single macro is provided in this file,
-.BR PSPIC ,
-to include a PDF graphic in a document, i.e., under the output device
-.BR \-Tpdf .
-.
-For all other devices,
-.I pspic
-is used.
-.
-So
-.I pdfpic
-is an extension of
-.IR pspic .
-.
-By that you can now even replace all
-.B PSPIC
-by
+provides a single macro,
 .BR PDFPIC ,
-nothing gets lost by that.
+to include a PDF graphic in a document using features of the
+.B pdf
+output driver.
 .
-The options of
+For other output devices,
 .B PDFPIC
-are identical to the
-.B PSDIF
-options.
+calls
+.BR PSPIC ,
+with which it shares an interface
+(see below).
+.
+This macro file is normally loaded at startup by the
+.I troffrc
+file.
 .
 .
 .TP
 .I pic
-This file provides proper definitions for the macros
-.B PS
-and
+supplies definitions of the macros
+.BR PS ,
 .BR PE ,
-needed for the
-.BR @g@pic (@MAN1EXT@)
+and
+.BR PF ,
+usable with the
+.MR @g@pic @MAN1EXT@
 preprocessor.
 .
 They center each picture.
 .
-Use it only if your macro package doesn't provide proper
-definitions for those two macros (actually, most of them already do).
+Use it if your document does not use a full-service macro package,
+or that package does not supply working
+.I pic
+macro definitions.
+.
+Except for
+.I man
+and
+.IR mdoc ,
+those provided with
+.I groff
+already do so
+(exception:
+.I mm
+employs the name
+.B PF
+for a different purpose).
 .
 .
 .TP
 .I pspic
-A single macro is provided in this file,
+provides a macro,
 .BR PSPIC ,
-to include a PostScript graphic in a document.
+that includes a PostScript graphic in a document.
 .
-The following output devices support inclusion of PS images:
-.BR \-Tps ,
-.BR \-Tdvi ,
-.BR \-Thtml ,
+The
+.BR ps ,
+.BR dvi ,
+.BR html ,
 and
-.BR \-Txhtml ;
-for all other devices the image is replaced with a hollow rectangle
-of the same size.
+.B xhtml
+output devices support such inclusions;
+for all other drivers,
+the image is replaced with a rectangular border of the same size.
+.
+.I pspic.tmac
+is loaded at startup by the
+.I troffrc
+file.
 .
-This macro file is already loaded at start-up by
-.B @g@troff
-so it isn't necessary to call it explicitly.
 .
 .IP
-Syntax:
+Its syntax is as follows.
 .RS
 .IP
 \&\fB.PSPIC\fP \
 \fB\-L\fP\|\
 |\|\fB\-R\fP\|\
 |\|\fB\-C\fP\|\
-|\|\fB\-I\fP\ \fIn\fP \
+|\|\fB\-I\fP\~\fIn\fP \
 \fI\|file\fP \fIwidth\fP \,\fIheight\/\fP
 .RE
 .
+.
 .IP
 .I file
 is the name of the PostScript file;
@@ -481,20 +699,23 @@
 .I width
 nor a
 .I height
-argument is specified, the image's natural width (as given in the
-file's bounding box) or the current line length is used as the
-width, whatever is smaller.
+argument is specified,
+the image's natural width
+(as given in the file's bounding box)
+or the current line length is used as the width,
+whatever is smaller.
 .
 The
 .I width
 and
 .I height
-arguments may have scaling indicators attached;
-the default scaling indicator is\~\c
-.BR i .
+arguments may have scaling units attached;
+the default scaling unit
+.RB is\~ i .
 .
-This macro scales the graphic uniformly
-in the x and y\~directions so that it is no more than
+.B PSPIC
+scales the graphic uniformly in the horizontal and vertical directions
+so that it is no more than
 .I width
 wide
 and
@@ -503,37 +724,63 @@
 .
 Option
 .B \-C
-centers the graphic horizontally, which is the default.
+centers the graphic horizontally;
+this is the default.
 .
-The
 .B \-L
 and
 .B \-R
-options cause the graphic to be left-aligned and right-aligned,
+left- and right-align the graphic,
 respectively.
 .
-The
 .B \-I
-option causes the graphic to be indented by\~\c
-.I n
-(default scaling indicator is\~\c
-.BR m ).
+indents the graphic
+.RI by\~ n
+(with a default scaling unit
+.RB of\~ m ).
+.
 .
 .IP
-For use of
-.B .PSPIC
-within a diversion it is recommended to extend it with the following
-code, assuring that the diversion's width completely covers the
-image's width.
+To use
+.B PSPIC
+within a diversion,
+we recommend extending it with the following code,
+assuring that the diversion's width completely covers the image's width.
+.
 .
 .RS
 .IP
 .EX
 \&.am PSPIC
-\&.\ \ vpt 0
-\&\rsh'(\rs\rsnps-offsetu + \rs\rsnps-deswidu)'
-\&.\ \ sp \-1
-\&.\ \ vpt 1
+\&.\~\~vpt 0
+\&\rsh\aq(\rs\rsnps\-offsetu + \rs\rsnps\-deswidu)\aq
+\&.\~\~sp \-1
+\&.\~\~vpt 1
+\&..
+.EE
+.RE
+.
+.
+.IP
+Failure to load
+.BR PSPIC 's
+image argument is not an error.
+.
+(The
+.B psbb
+request does issue an error diagnostic.)
+.
+To make such a failure fatal,
+append to the
+.B pspic*error\-hook
+macro.
+.
+.
+.RS
+.IP
+.EX
+\&.am pspic*error\-hook
+\&.\~\~ab
 \&..
 .EE
 .RE
@@ -541,291 +788,349 @@
 .
 .TP
 .I ptx
-A single macro is provided in this file,
+provides a macro,
 .BR xx ,
-for formatting permuted index entries as produced by the GNU
-.BR ptx (1)
+to format permuted index entries as produced by the GNU
+.MR ptx 1
 program.
 .
-In case you need a different formatting, copy the macro into
-your document and adapt it to your needs.
+If your formatting needs differ,
+copy the macro into your document and adapt it to your needs.
 .
 .
 .TP
-.I trace
-Use this for tracing macro calls.
-.
-It is only useful for debugging.
+.I rfc1345
+defines special character escape sequences named for the glyph mnemonics
+specified in RFC\~1345 and the digraph table of the Vim text editor.
 .
 See
-.BR groff_trace (@MAN7EXT@) .
+.MR groff_rfc1345 @MAN7EXT@ .
 .
 .
 .TP
-.I tty\-char
-Overrides the definition of standard troff characters and some groff
-characters for TTY devices.
-.
-The optical appearance is intentionally inferior compared to that of
-normal TTY formatting to allow processing with critical equipment.
+.I sboxes
+offers an interface to the
+.RB \lq "pdf: background" \rq
+device control command supported by
+.MR gropdf @MAN1EXT@ .
 .
+Using this package,
+.I groff ms
+documents can draw colored rectangles beneath any output.
 .
+.RS
 .TP
-.I www
-Additions of elements known from the HTML format, as used in the
-internet (World Wide Web) pages; this includes URL links and mail
-addresses; see
-.BR groff_www (@MAN7EXT@).
+.BI \%.BOXSTART\~SHADED\~ color\~\c
+.BI \%OUTLINED\~ color\~\c
+.BI \%INDENT\~ size\~\c
+.BI \%WEIGHT\~ size
+begins a box,
+where the argument after
+.B \%SHADED
+gives the fill color and that after
+.B \%OUTLINED
+the border color.
+.
+Omit the former to get a borderless filled box and the latter for a
+border with no fill.
+.
+The specified
+.B \%WEIGHT
+is used if the box is
+.BR \%OUTLINED .
 .
 .
-.\" ====================================================================
-.SH NAMING
-.\" ====================================================================
+.IP
+.B \%INDENT
+precedes a value which leaves a gap between the border and the contents
+inside the box.
 .
-Classical roff systems were designed before the conventions of the
-modern C
-.BR getopt (3)
-call evolved, and used a naming scheme for macro packages that looks
-odd to modern eyes.
 .
-Macro packages were always included with the option
-.BR \-m ;
-when this option was directly followed by its argument without an
-intervening space, this looked like a long option preceded by a single
-minus \em a sensation in the computer stone age.
+.IP
+Each
+.I color
+must be a defined
+.I groff
+color name,
+and each
+.I size
+a valid
+.I groff
+numeric expression.
 .
-To make this invocation form work, classical troff
-macro packages used names that started with the letter \oqm\cq,
-which was omitted in the naming of the macro file.
+The keyword/value pairs can be specified in any order.
+.RE
 .
 .
-.P
-For example, the macro package for the man pages was called
-.IR man ,
-while its macro file
-.IR tmac.an .
-So it could be activated by the argument
-.I an
-to option
-.BR \-m ,
-or
-.B \-man
-for short.
+.IP
+Boxes can be stacked,
+so you can start a box within another box;
+usually the later boxes would be smaller than the containing box,
+but this is not enforced.
 .
+When using
+.BR \%BOXSTART ,
+the left position is the current indent minus the
+.B \%INDENT
+in the command,
+and the right position is the left position
+(calculated above)
+plus the current line length and twice the indent.
 .
-.P
-For similar reasons, macro packages that did not start with an
-\oqm\cq had a leading \oqm\cq added in the documentation and
-in speech; for example, the package corresponding to
-.I tmac.doc
-was called
-.I mdoc
-in the documentation, although a more suitable name would be
-.IR doc .
-For, when omitting the space between the option and its argument, the
-command-line option for activating this package reads
-.BR \-mdoc .
 .
+.RS
+.TP
+.B \%.BOXSTOP
+takes no parameters.
 .
-.P
-To cope with all situations, actual versions of
-.BR groff (@MAN1EXT@)
-are smart about both naming schemes by providing two macro files
-for the inflicted macro packages; one with a leading \oqm\cq
-the other one without it.
+It closes the most recently started box at the current vertical position
+after adding its
+.B \%INDENT
+spacing.
+.RE
 .
-So in
-.IR groff ,
-the
-.I man
-macro package may be specified as one of the following four methods:
 .
 .IP
-.EX
-\fIsh#\fP groff\ \-m\ man
-\fIsh#\fP groff\ \-man
-\fIsh#\fP groff\ \-mman
-\fIsh#\fP groff\ \-m\ an
-.EE
-.
+Your
+.I groff
+documents can conditionally exercise the
+.I sboxes
+macros.
 .
-.P
-Recent packages that do not start with \oqm\cq do not use an
-additional \oqm\cq in the documentation.
+The register
+.B \%GSBOX
+is defined if the package is loaded,
+and interpolates a true value if the
+.B pdf
+output device is in use.
 .
-For example, the
-.I www
-macro package may be specified only as one of the two methods:
 .
 .IP
-.EX
-\fIsh#\fP groff\ \-m\ www
-\fIsh#\fP groff\ \-mwww
-.EE
+.I sboxes
+furthermore hooks into the
+.MR groff_ms @MAN7EXT@
+package to receive notifications when footnotes are growing,
+so that it can close boxes on a page before footnotes are printed.
 .
+When that condition obtains,
+.I sboxes
+will close open boxes two points
+above the footnote separator and re-open them on the next page.
 .
-.P
-Obviously, variants like
-.I \-mmwww
-would not make much sense.
+(This amount probably will not match the box's
+.BR \%INDENT .)
 .
 .
-.P
-A second strange feature of classical troff was to name macro files
-in the form
-.IR tmac. name.
-In modern operating systems, the type of a file is specified as a
-postfix, the file name extension.
+.IP
+See
+.UR file://@DOCDIR@/\:\%msboxes\:.pdf
+\lqUsing PDF boxes with
+.I groff
+and the
+.I ms
+macros\rq
+.UE
+for a demonstration.
 .
-Again, groff copes with this situation by searching both
-.IB anything .tmac
-and
-.BI tmac. anything
-if only
-.I anything
-is specified.
 .
+.TP
+.I trace
+aids the debugging of
+.I groff
+documents by tracing macro calls.
 .
-.P
-The easiest way to find out which macro packages are available on a
-system is to check the man\~page
-.BR groff (@MAN1EXT@),
-or the contents of the
-.I tmac
-directories.
+See
+.MR groff_trace @MAN7EXT@ .
 .
 .
-.P
-In
-.IR groff ,
-most macro packages are described in\~man pages called
-.BR groff_\fIname\f (@MAN7EXT@),
-with a leading \oqm\cq for the classical packages.
+.TP
+.I www
+defines macros corresponding to HTML elements.
+.
+See
+.MR groff_www @MAN7EXT@ .
 .
 .
 .\" ====================================================================
-.SH INCLUSION
+.SH Naming
 .\" ====================================================================
 .
-There are several ways to use a macro package in a document.
-.
-The classical way is to specify the troff/groff option
+AT&T
+.I nroff \" AT&T
+and
+.I troff \" AT&T
+were implemented before the conventions of the modern C
+.MR getopt 3
+call evolved,
+and used a naming scheme for macro packages that looks odd to modern
+eyes.
+.
+Macro packages were typically loaded using the
 .B \-m
-.I name
-at run-time; this makes the contents of the macro package
-.I name
-available.
-.
-In groff, the file
-.RI name .tmac
-is searched within the tmac path; if not found,
-.IR tmac. name
-is searched for instead.
+option to the formatter;
+when directly followed by its argument without an intervening space,
+this looked like a long option preceded by a single minus\ema
+sensation in the computer stone age.
 .
+Macro packages therefore came to be known by names that started with the
+letter \lqm\rq,
+which was omitted from the name of the macro file as stored on disk.
 .
-.P
-Alternatively, it is also possible to include a macro file by adding
-the request
-.B .so
-.I filename
-into the document; the argument must be the full file name of an
-existing file, possibly with the directory where it is kept.
-.
-In groff, this was improved by the similar request
-.B .mso
-.IR package ,
-which added searching in the tmac path, just like option
-.B \-m
-does.
+For example,
+the manuscript macro package was stored as
+.I tmac.s
+and loaded with the option
+.BR \-ms .
 .
 .
 .P
-Note that in order to resolve the
-.B .so
-and
-.B .mso
-requests, the roff preprocessor
-.BR soelim (@MAN1EXT@)
-must be called if the files to be included need preprocessing.
-.
-This can be done either directly by a pipeline on the command line or
-by using the troff/groff option
-.BR \-s .
+.I groff
+commands permit space between an option and its argument.
 .
-.I man
-calls soelim automatically.
+The syntax
+.RB \lq "groff \-m s" \rq
+makes the macro file name more clear but may surprise users familiar
+with the original convention,
+unaware that the package's \lqreal\rq name was \lqs\rq all
+along.
 .
+For such packages of long pedigree,
+.I groff
+accommodates different users' expectations by supplying wrapper macro
+files that load the desired file with
+.B mso
+requests.
 .
-.P
-For example, suppose a macro file is stored as
+Thus,
+all of
+.RB \lq "groff \-m s" \rq,
+.RB \lq "groff \-m ms" \rq,
+.RB \lq "groff \-ms" \rq,
+and
+.RB \lq "groff \-mms" \rq
+serve to load the manuscript macros.
 .
-.IP
-.I @MACRODIR@/macros.tmac
 .
 .P
-and is used in some document called
-.IR docu.roff .
+Wrappers are not provided for packages of more recent vintage,
+like
+.IR www.tmac .
 .
 .
 .P
-At run-time, the formatter call for this is
+As noted in passing above,
+AT&T
+.I troff \" AT&T
+named macro files in the form
+.IR tmac. name.
 .
-.IP
-.EX
-\fIsh#\fP groff \-m macros docu.roff
-.EE
+It has since become conventional in operating systems to use a suffixed
+file name extension to suggest a file type or format.
 .
 .
-.P
-To include the macro file directly in the document either
+.\" ====================================================================
+.SH Inclusion
+.\" ====================================================================
 .
-.IP
-.EX
-\&.mso macros.tmac
-.EE
+The traditional method of employing a macro package is to specify the
+.B \-m
+.I package
+option to the formatter,
+which then reads
+.IR package 's
+macro file prior to any input files.
+.
+Historically,
+.I package
+was sought in a file named
+.IR tmac. package
+(that is,
+with a
+.RB \lq tmac.\& \rq
+prefix).
+.
+GNU
+.I troff \" GNU
+searches for
+.RI package .tmac
+in the macro path;
+if not found,
+it looks for
+.IR tmac. package
+instead,
+and vice versa.
 .
-.P
-is used or
 .
-.IP
-.EX
-\&.so @MACRODIR@/macros.tmac
-.EE
+.P
+Alternatively,
+one could include a macro file by using the request
+.RB \lq .so
+.IR file-name \rq
+in the document;
+.I file-name
+is resolved relative to the location of the input document.
+.
+GNU
+.I troff \" GNU
+offers an improved feature in the similar request
+.RB \lq mso
+.IR package-file-name \rq,
+which searches the macro path for
+.IR package-file-name .
+.
+Because its argument is a file name,
+its
+.RB \lq .tmac \rq
+component must be included for the file to be found;
+however,
+as a convenience,
+if opening it fails,
+.B mso
+strips any such suffix and tries again with a
+.RB \lq tmac.\& \rq
+prefix,
+and vice versa.
 .
 .
 .P
-In both cases, the formatter should be called with option
+If a sourced file requires preprocessing,
+for example if it includes
+.I tbl \" generic
+tables
+or
+.I eqn \" generic
+equations,
+the preprocessor
+.MR @g@soelim @MAN1EXT@
+must be used.
+.
+This can be achieved with a pipeline or,
+in
+.IR groff ,
+by specifying
+the
 .B \-s
-to invoke
-.BR soelim .
-.IP
-.EX
-\fIsh#\fP groff \-s docu.roff
-.EE
+option to the formatter
+(or front end).
 .
+.MR man 1
+librarian programs generally call
+.I @g@soelim
+automatically.
 .
-.P
-If you want to write your own groff macro file, call it
-.RI whatever .tmac
-and put it in a directory in the tmac path;
-see section \lqFiles\rq below.
-.
-Then documents can include it with the
-.B .mso
-request or the option
-.BR \-m .
+(Macro packages themselves generally do not require preprocessing.)
 .
 .
 .ig
 .\" ====================================================================
-.SH CONVENTION
+.SH Convention
 .\" ====================================================================
 .
 .\" This section does not fit into the framework of this document.
 .
 There is a convention that is supported by many modern roff
-type-setters and
-.BR man (1)
+typesetters and
+.MR man 1
 programs, the
 .I preprocessor word
 described in the following.
@@ -843,29 +1148,29 @@
 preprocessors are recognized,
 \oqe\cq
 (for
-.BR eqn ),
+.IR eqn ),
 .\" \oqG\cq,
 .\" \oqg\cq,
 \oqp\cq
 (for
-.BR pic ),
+.IR pic ),
 \oqR\cq
 (for
-.BR refer ),
+.IR refer ),
 \oqs\cq
 (for
-.BR soelim ),
+.IR soelim ),
 and
 \oqt\cq
 (for
-.BR tbl ).
+.IR tbl ).
 (see
-.BR roff (@MAN7EXT@)).
+.MR roff @MAN7EXT@ ).
 .
 .
 .P
 Besides being a good reminder for the user, some formatters (like the
-.BR man (1)
+.MR man 1
 program) are even able to automatically start the preprocessors
 specified in the preprocessor word, but do not bet on this.
 .
@@ -880,17 +1185,17 @@
 .
 ..
 .\" ====================================================================
-.SH "WRITING MACROS"
+.SH "Writing macros"
 .\" ====================================================================
 .
 A
-.BR roff (@MAN7EXT@)
+.MR roff @MAN7EXT@
 document is a text file that is enriched by predefined formatting
 constructs, such as requests, escape sequences, strings, numeric
 registers, and macros from a macro package.
 .
 These elements are described in
-.BR roff (@MAN7EXT@).
+.MR roff @MAN7EXT@ .
 .
 .
 .P
@@ -903,15 +1208,15 @@
 .P
 Macros without arguments are just like strings.
 .
-But the full power of macros reveals when arguments are passed with a
+But the full power of macros occurs when arguments are passed with a
 macro call.
 .
 Within the macro definition, the arguments are available as the escape
 sequences
 .BR \rs$1 ,
-\*Ellipsis,
+\&.\|.\|.,
 .BR \rs$9 ,
-.BR \rs$ \*Ellipsis  ,
+.BR \rs$ .\|.\|.  ,
 .BR \rs$* ,
 and
 .BR \rs$@ ,
@@ -920,112 +1225,17 @@
 and the number of arguments is in register
 .BR \rsn.$ ;
 see
-.BR groff (@MAN7EXT@).
+.MR groff @MAN7EXT@ .
 .
 .
 .\" ====================================================================
-.SS "Copy-in Mode"
-.\" ====================================================================
-.
-The phase when groff reads a macro is called
-.I "copy-in mode"
-or
-.I "copy mode"
-in roff-talk.
-.
-This is comparable to the C\~preprocessing phase during the development
-of a program written in the C\~language.
-.
-.
-.P
-In this phase, groff interprets all backslashes; that means that all
-escape sequences in the macro body are interpreted and replaced by
-their value.
-.
-For constant expressions, this is wanted, but strings and registers
-that might change between calls of the macro must be protected from
-being evaluated.
-.
-This is most easily done by doubling the backslash that introduces the
-escape sequence.
-.
-This doubling is most important for the positional parameters.
-.
-For example, to print information on the arguments that were passed to
-the macro to the terminal, define a macro named \oq.print_args\cq,
-say.
-.
-.
-.IP
-.ds @1 \rsfI\rs\rs$0\rsf\"
-.ds @2 arguments:\"
-.EX
-\&.ds midpart was called with
-\&.de print_args
-\&.\ \ tm\ \*@1\ \rs*midpart\ \rs\rsn.$\ \*@2
-\&.\ \ tm\ \rs\rs$*
-\&..
-.EE
-.rm @1
-.rm @2
-.
-.
-.P
-When calling this macro by
-.
-.IP
-.EX
-\&.print_args arg1 arg2
-.EE
-.
-.P
-the following text is printed to the terminal:
-.
-.IP
-.EX
-\&\fCIprint_args\f was called with the following 2 arguments:
-arg1 arg2
-.EE
-.
-.
-.P
-Let's analyze each backslash in the macro definition.
-.
-As the positional parameters and the number of arguments change
-with each call of the macro their leading backslash must be doubled,
-which results in
-.RI \rs\rs $*
-and
-.RI \rs\rs .$ .
-The same applies to the macro name because it could be called with an
-alias name, so
-.RI \rs\rs $0 .
-.
-.
-.P
-On the other hand,
-.I midpart
-is a constant string, it does not change, so no doubling for
-.RI \rs *midpart .
-The
-.RI \rs f
-escape sequences are predefined groff elements for setting the font
-within the text.
-.
-Of course, this behavior does not change, so no doubling with
-.RI \rs fI
-and
-.RI \rs f .
-.
-.
-.\" ====================================================================
-.SS "Draft Mode"
+.SS "Draft mode"
 .\" ====================================================================
 .
 Writing groff macros is easy when the escaping mechanism is temporarily
 disabled.
 .
-In groff, this is done by enclosing the macro definition(s) into a
+In groff, this is done by enclosing the macro definition(s) within a
 pair of
 .B .eo
 and
@@ -1044,10 +1254,10 @@
 .ds @2 arguments:\"
 .EX
 \&.eo
-\&.ds midpart was called with
+\&.ds midpart was called with the following
 \&.de print_args
-\&.\ \ tm\ \*@1\ \rs*midpart\ \rsn.$\ \*@2
-\&.\ \ tm\ \rs$*
+\&\*@1\ \rs*midpart\ \rsn.$\ \*@2
+\&\rs$*
 \&..
 \&.ec
 .EE
@@ -1069,7 +1279,7 @@
 .
 .
 .\" ====================================================================
-.SS "Tips for Macro Definitions"
+.SS "Tips for macro definitions"
 .\" ====================================================================
 .
 .IP \(bu
@@ -1090,9 +1300,9 @@
 .RE
 .
 .IP \(bu
-Write a comment macro that works both for copy-in and draft mode; for
-as escaping is off in draft mode, trouble might occur when normal
-comments are used.
+Write a comment macro that works both for copy and draft modes;
+since the escape character is off in draft mode,
+trouble might occur when comment escape sequences are used.
 .
 For example, the following macro just ignores its arguments, so it
 acts like a comment line:
@@ -1117,7 +1327,7 @@
 .
 .
 .\" ====================================================================
-.SS "Diversions"
+.SS Diversions
 .\" ====================================================================
 .
 Diversions can be used to implement quite advanced programming
@@ -1129,7 +1339,7 @@
 .
 .P
 In their simplest form, diversions are multi-line strings, but
-they get their power when diversions are used dynamically within macros.
+diversions get their power when used dynamically within macros.
 .
 The (formatted) information stored in a diversion can be retrieved by
 calling the diversion just like a macro.
@@ -1137,17 +1347,17 @@
 .
 .P
 Most of the problems arising with diversions can be avoided if you
-remain aware of the fact that diversions always store complete lines.
+remember that diversions always store complete lines.
 .
-If diversions are used when the line buffer has not been flushed,
-strange results are produced; not knowing this, many people get
-desperate about diversions.
+Using diversions when the line buffer has not been flushed produces
+strange results; not knowing this, many people get desperate about
+diversions.
 .
-To ensure that a diversion works, line breaks should be added at the
-right places.
+To ensure that a diversion works, add line breaks at the right
+places.
 .
-To be on the secure side, enclose everything that has to do with
-diversions into a pair of line breaks; for example, by explicitly using
+To be safe, enclose everything that has to do with diversions within
+a pair of line breaks; for example, by explicitly using
 .B .br
 requests.
 .
@@ -1158,10 +1368,10 @@
 .
 .
 .P
-If you really need diversions which should ignore the current partial
+(If you really need diversions which should ignore the current partial
 line, use environments to save the current partial line and/\:or use the
 .B .box
-request.
+request.)
 .
 .
 .P
@@ -1173,104 +1383,24 @@
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Authors
 .\" ====================================================================
 .
-All macro package files must be named
-.RI name .tmac
-to fully use the tmac mechanism.
-.
-.IR tmac. name
-as with classical packages is possible as well, but deprecated.
-.
-.
-.P
-The macro files are kept in the
-.IR "tmac directories" ;
-a colon separated list of these constitutes the
-.IR "tmac path" .
-.
-.
-.P
-The search sequence for macro files is (in that order):
-.
-.IP \(bu
-the directories specified with troff/groff's
-.B \-M
-command-line option
-.
-.IP \(bu
-the directories given in the
-.I GROFF_TMAC_PATH
-environment variable
-.
-.IP \(bu
-the current directory (only if in unsafe mode, which is enabled by the
-.B \-U
-command-line switch)
-.
-.IP \(bu
-the home directory
-.
-.IP \(bu
-a platform-specific directory, being
-.
-.RS
-.IP
-.I @SYSTEMMACRODIR@
-.RE
-.
-.IP
-in this installation
-.
-.IP \(bu
-a site-specific (platform-independent) directory, being
-.
-.RS
-.IP
-.I @LOCALMACRODIR@
-.RE
-.
-.IP
-in this installation
-.
-.IP \(bu
-the main tmac directory, being
-.
-.RS
-.IP
-.I @MACRODIR@
-.RE
-.
-.IP
-in this installation
-.
-.
-.\" ====================================================================
-.SH ENVIRONMENT
-.\" ====================================================================
-.
-.TP
-.I GROFF_TMAC_PATH
-A colon separated list of additional tmac directories in which to search
-for macro files.
-.
-See the previous section for a detailed description.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
 This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
-.ME
-and
-.MT wl@\:gnu.org
+.ME ,
+.MT wl@\:gnu\:.org
 Werner Lemberg
+.ME ,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
+.
+.
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -1282,52 +1412,63 @@
 You can browse it interactively with \lqinfo groff\rq.
 .
 .
+.LP
+The
+.UR https://\:wiki\:.linuxfoundation\:.org/\:lsb/\:fhs
+Filesystem Hierarchy Standard
+.UE
+is maintained by the Linux Foundation.
+.
+.
 .TP
-.BR groff (@MAN1EXT@)
-an overview of the groff system.
+.MR groff @MAN1EXT@
+is an overview of the
+.I groff
+system.
 .
 .
 .TP
-.BR groff_man (@MAN7EXT@),
+.MR groff_man @MAN7EXT@ ,
 .TQ
-.BR groff_mdoc (@MAN7EXT@),
+.MR groff_mdoc @MAN7EXT@ ,
 .TQ
-.BR groff_me (@MAN7EXT@),
+.MR groff_me @MAN7EXT@ ,
 .TQ
-.BR groff_mm (@MAN7EXT@),
+.MR groff_mm @MAN7EXT@ ,
 .TQ
-.BR groff_mom (@MAN7EXT@),
+.MR groff_mom @MAN7EXT@ ,
 .TQ
-.BR groff_ms (@MAN7EXT@),
+.MR groff_ms @MAN7EXT@ ,
 .TQ
-.BR groff_trace (@MAN7EXT@),
+.MR groff_rfc1345 @MAN7EXT@ ,
 .TQ
-.BR groff_www (@MAN7EXT@).
-the groff tmac macro packages.
+.MR groff_trace @MAN7EXT@ ,
+\~and
+.TQ
+.MR groff_www @MAN7EXT@
+are
+.I groff
+macro packages.
 .
 .
 .TP
-.BR groff (@MAN7EXT@)
-the groff language.
+.MR groff @MAN7EXT@
+summarizes the language recognized by GNU
+.IR troff . \" GNU
 .
 .
-.P
-The Filesystem Hierarchy Standard is available at the
-.UR http://\:www.pathname.com/\:fhs/
-FHS web site
-.UE .
+.TP
+.MR troff @MAN1EXT@
+documents the default macro file search path.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_tmac_C
-.
+.cp \n*groff_groff_tmac_5_man_C
+.do rr *groff_groff_tmac_5_man_C
 .
-.\" ====================================================================
-.\" Emacs settings
-.\" ====================================================================
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/man/man.am -> _service:tar_scm:groff-1.23.0.tar.gz/man/man.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/man/roff.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/man/roff.7.man Changed

@@ -1,21 +1,19 @@
 '\" t
-.TH ROFF @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-roff \- concepts and history of roff typesetting
-.
-.\" this is the man page roff.7
-.
+.TH roff @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+roff \- concepts and history of
+.I roff
+typesetting
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr roff_C \n.C
-.cp 0
 .
+.\" TODO: Synchronize this material with introductory section(s) of our
+.\" Texinfo manual, and then keep it that way.
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2023 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -29,1043 +27,2233 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
-.\" ====================================================================
-.\" Local macros
-.
-.de Esc
-.  ds @1 \\$1
-.  shift
-.  nop \fB\rs\\*@1\f\\$*
-.  rm @1
-..
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_roff_7_man_C \n.cp
+.cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
-.de QuotedChar
-.  ds @1 \\$1
-.  shift
-.  nop \oq\fB\\*@1\f\cq\\$*
-.  rm @1
-..
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
+The term
 .I roff
-is the general name for a set of text formatting programs, known under
-names like
-.BR troff ,
-.BR nroff ,
-.BR ditroff ,
-.BR groff ,
-etc.
+denotes a family of document formatting systems known by names like
+.IR troff ,
+.IR nroff ,
+and
+.IR ditroff .
 .
 A
 .I roff
-system consists of an extensible text formatting language and a set of
-programs for printing and converting to other text formats.
+system consists of an interpreter for an extensible text formatting
+language and a set of programs for preparing output for various devices
+and file formats.
 .
-Unix-like operating systems distribute a
+Unix-like operating systems often distribute a
 .I roff
-system as a core package.
+system.
+.
+The manual pages on Unix systems
+(\lqman\~pages\rq)
+and bestselling books on software engineering,
+including Brian Kernighan and Dennis Ritchie's
+.I The C Programming Language
+and W.\& Richard Stevens's
+.I Advanced Programming in the Unix Environment
+have been written using
+.I roff
+systems.
+.
+GNU
+.IR roff \em groff \emis
+arguably the most widespread
+.I roff
+implementation.
 .
 .
 .P
-The most common
+Below we present
+typographical concepts that form the background of all
 .I roff
-system today is the free software implementation \fCRGNU\f
-.IR roff ,
-.BR groff (@MAN1EXT@).
+implementations,
+narrate the development history of some
+.I roff
+systems,
+detail the command pipeline managed by
+.MR groff @MAN1EXT@ ,
+survey the formatting language,
+suggest tips for editing
+.I roff
+input,
+and recommend further reading materials.
 .
-.I groff
-implements the look-and-feel and functionality of its ancestors, with
-many extensions.
 .
+.\" ====================================================================
+.SH Concepts
+.\" ====================================================================
 .
-.P
-The ancestry of
+.\" BEGIN Keep roughly parallel with groff.texi nodes "Text" through
+.\" "Tab Stops".
 .I roff
-is described in section \lqHistory\rq below.
+input files contain text interspersed with instructions to control the
+formatter.
 .
-In this document, the term
+Even in the absence of such instructions,
+a
 .I roff
-always refers to the general class of roff programs, not to the
-.B roff
-command provided in early Unix systems.
+formatter still processes its input in several ways,
+by filling,
+hyphenating,
+breaking,
+and adjusting it,
+and supplementing it with inter-sentence space.
+.
+These processes are basic to typesetting,
+and can be controlled at the input document's discretion.
 .
 .
 .P
-In spite of its age,
+When a device-independent
 .I roff
-is in wide use today, for example, the manual pages on Unix systems
-.RI ( man\~pages ),
-many software books, system documentation, standards, and corporate
-documents are written in roff.
+formatter starts up,
+it obtains information about the device for which it is preparing
+output from the latter's description file
+(see
+.MR groff_font @MAN5EXT@ ).
 .
-The
+An essential property is the length of the output line,
+such as \lq6.5 inches\rq.
+.
+.
+.P
+The formatter interprets plain text files employing the Unix line-ending
+convention.
+.
+It reads input a character at a time,
+collecting words as it goes,
+and fits as many words together on an output line as it can\emthis
+is known as
+.I filling.
+.
+To a
 .I roff
-output for text devices is still unmatched, and its graphical output
-has the same quality as other free type-setting programs and is better
-than some of the commercial systems.
+system,
+a
+.I word
+is any sequence of one or more characters that aren't spaces or
+newlines.
+.
+The exceptions separate words.
 .
 .
 .P
+A
 .I roff
-is used to format Unix
-.IR "manual pages" ,
-(or
-.IR "man pages" ),
-the standard documentation system on many Unix-derived operating
-systems.
+formatter attempts to detect boundaries between sentences,
+and supplies additional inter-sentence space between them.
+.
+It flags certain characters
+(normally
+.RB \lq !\& \rq,
+.RB \lq ?\& \rq,
+and
+.RB \lq .\& \rq)
+as potentially ending a sentence.
+.
+When the formatter encounters one of these
+.I end-of-sentence characters
+at the end of an input line,
+or one of them is followed by two (unescaped) spaces on the same input
+line,
+it appends an inter-word space
+followed by an inter-sentence space in the output.
+.
+The dummy character escape sequence
+.B \rs&
+can be used after an end-of-sentence character to defeat end-of-sentence
+detection on a per-instance basis.
+.
+Normally,
+the occurrence of a visible non-end-of-sentence character
+(as opposed to a space or tab)
+immediately after an end-of-sentence
+character cancels detection of the end of a sentence.
+.
+However,
+several characters are treated
+.I transparently
+after the occurrence of an end-of-sentence character.
+.
+That is,
+a
+.I roff
+does not cancel end-of-sentence detection when it processes them.
+.
+This is because such characters are often used as footnote markers or to
+close quotations and parentheticals.
+.
+The default set is
+.BR \dq ,
+.BR \aq ,
+.BR ) ,
+.BR  ,
+.BR * ,
+.BR \rsdg ,
+.BR \rsdd ,
+.BR \rsrq ,
+and
+.BR \rscq .
+.
+The last four are examples of
+.I special characters,
+escape sequences whose purpose is to obtain glyphs that are not easily
+typed at the keyboard,
+or which have special meaning to the formatter
+(like
+.BR \rs ).
+.\" slack wording: itself).
+.
+.
+.P
+When an output line is nearly full,
+it is uncommon for the next word collected from the input to exactly
+fill it\emtypically,
+there is room left over only for part of the next word.
+.
+The process of splitting a word so that it appears partially on one line
+(with a hyphen to indicate to the reader that the word has been broken)
+with its remainder on the next is
+.I hyphenation.
+.
+Hyphenation points can be manually specified;
+.I groff
+also uses a hyphenation algorithm and language-specific pattern files to
+decide which words can be hyphenated and where.
+.
+Hyphenation does not always occur even when the hyphenation rules for a
+word allow it;
+it can be disabled,
+and when not disabled there are several parameters that can prevent it
+in certain circumstances.
 .
 .
 .P
-This document describes the history of the development of the
-.IR "roff system" ;
-some usage aspects common to all
+Once an output line is full,
+the next word
+(or remainder of a hyphenated one)
+is placed on a different output line;
+this is called a
+.I break.
+.
+In this document and in
 .I roff
-versions, details on the
+discussions generally,
+a \lqbreak\rq if not further qualified always refers to the
+termination of an output line.
+.
+When the formatter is filling text,
+it introduces breaks automatically to keep output lines from exceeding
+the configured line length.
+.
+After an automatic break,
+a
 .I roff
-pipeline, which is usually hidden behind front-ends like
-.BR groff (@MAN1EXT@);
-a general overview of the formatting language; some tips for editing
+formatter
+.I adjusts
+the line if applicable
+(see below),
+and then resumes collecting and filling text on the next output line.
+.
+.
+.br
+.ne 2v
+.P
+Sometimes,
+a line cannot be broken automatically.
+.
+This usually does not happen with natural language text unless the
+output line length has been manipulated to be extremely short,
+but it can with specialized text like program source code.
+.
+.I groff
+provides a means of telling the formatter where the line may be broken
+without hyphens.
+.
+This is done with the non-printing break point escape sequence
+.BR \rs: .
+.
+.
+.P
+.\" What if the document author wants to stop filling lines temporarily,
+.\" for instance to start a new paragraph?  There are several solutions.
+There are several ways to cause a break at a predictable location.
+.
+A blank input line not only causes a break,
+but by default it also outputs a one-line vertical space
+(effectively a blank output line).
+.
+Macro packages may discourage or disable this \lqblank line
+method\rq of paragraphing in favor of their own macros.
+.
+A line that begins with one or more spaces causes a break.
+.
+The spaces are output at the beginning of the next line without being
+.I adjusted
+(see below).
+.
+Again,
+macro packages may provide other methods of producing indented
+paragraphs.
+.
+Trailing spaces on
+.I text lines
+(see below)
+are discarded.
+.
+The end of input causes a break.
+.
+.
+.P
+After the formatter performs an automatic break,
+it may then
+.I adjust
+the line,
+widening inter-word spaces until the text reaches the right margin.
+.
+Extra spaces between words are preserved.
+.
+Leading and trailing spaces are handled as noted above.
+.
+Text can be aligned to the left or right margin only,
+or centered,
+using
+.I requests.
+.
+.
+.P
+A
 .I roff
-files; and many pointers to further readings.
+formatter translates horizontal tab characters,
+also called simply \lqtabs\rq,
+in the input into movements to the next tab stop.
+.
+These tab stops are by default located every half inch measured from the
+current position on the input line.
+.
+With them,
+simple tables can be made.
+.
+However,
+this method can be deceptive,
+as the appearance
+(and width)
+of the text in an editor and the results from the formatter can vary
+greatly,
+particularly when proportional typefaces are used.
+.
+A tab character does not cause a break and therefore does not interrupt
+filling.
+.
+The formatter provides facilities for sophisticated table composition;
+there are many details to track
+when using the \lqtab\rq and \lqfield\rq low-level features,
+so most users turn to the
+.MR @g@tbl @MAN1EXT@
+preprocessor to lay out tables.
+.\" END Keep roughly parallel with groff.texi nodes "Text" through "Tab
+.\" Stops".
 .
 .
 .\" ====================================================================
-.SH "HISTORY"
+.SS "Requests and macros"
 .\" ====================================================================
 .
-Document formatting by computer dates back to the 1960s.
+.\" BEGIN Keep roughly parallel with groff.texi node "Requests and
+.\" Macros".
+.\" We have now encountered almost all of the syntax there is in the
+.\" @code{roff} language, with an exception already noted in passing.
+A
+.I request
+is an instruction to the formatter that occurs after a
+.I control character,
+which is recognized at the beginning of an input line.
+.
+The regular control character is a dot
+.RB \lq .\& \rq.
+.
+Its counterpart,
+the
+.I no-break control character,
+a neutral apostrophe
+.RB \lq \|\aq\| \rq,
+suppresses the break
+.\" slack wording: that is
+implied by some requests.
+.
+These characters were chosen because it is uncommon for lines of text in
+natural languages to begin with them.
+.
+If you require a formatted period or apostrophe
+(closing single quotation mark)
+where
+.\" GNU @code{troff}
+the formatter is expecting a control character,
+prefix the dot or neutral apostrophe with the dummy character escape
+sequence,
+.RB \lq \rs& \rq.
+.
 .
-The
+.P
+An input line beginning with a control character is called a
+.I control line.
+.
+Every line of input that is not a control line is a
+.I text line.
+.
+.
+.P
+Requests often take
+.I arguments,
+words
+(separated from the request name and each other by spaces)
+that specify details of the action
+.\" GNU @code{troff}
+the formatter is expected to perform.
+.
+If a request is meaningless without arguments,
+it is typically ignored.
+.
+.\" TODO: roff(7): We haven't introduced escape sequences yet.
+.\" GNU @code{troff}'s requests and escape sequences comprise the
+.\" control language of the formatter.
+.
+Of key importance are the requests that define macros.
+.
+Macros are invoked like requests,
+enabling the request repertoire to be extended or overridden.
+.\" @footnote{Argument handling in macros is more flexible but also more
+.\" complex.  @xref{Calling Macros}.}
+.
+.
+.P
+A
+.I macro
+can be thought of as an abbreviation you can define for a
+collection of control and text lines.
+.
+When the macro is
+.I called
+by giving its name after a control character,
+it is replaced with what it stands for.
+.
+The process of textual replacement is known as
+.I interpolation.
+.\" @footnote{Some escape sequences undergo interpolation as well.}
+Interpolations are handled as soon as they are recognized,
+and once performed,
+a
 .I roff
-system itself is intimately connected to the Unix operating system, but
-its roots go back to the earlier operating systems CTSS and Multics.
+formatter scans the replacement for further requests,
+macro calls,
+and escape sequences.
+.
+.
+.P
+In
+.I roff
+systems,
+the
+.RB \lq de \rq
+request defines a macro.
+.\" @footnote{GNU @code{troff} offers additional ones.  @xref{Writing
+.\" Macros}.}
+.\" END Keep roughly parallel with groff.texi node "Requests and
+.\" Macros".
 .
 .
 .\" ====================================================================
-.SS "The Predecessor RUNOFF"
+.SS "Page geometry"
 .\" ====================================================================
 .
-.BR roff 's
-ancestor
-.B RUNOFF
-was written in the MAD language by
-.I Jerry Saltzer
-for the
-.IR "Compatible Time Sharing System (CTSS)" ,
-a project of the Massachusetts Institute of Technology (MIT), in 1963
-and 1964\emnote that CTSS commands were all uppercase.
-.
-.P
-In 1965, MIT's Project MAC teamed with Bell Telephone Laboratories
-(BTL) and General Electric to begin the
-.UR http://\:www.multicians.org
-.I Multics
-system
-.UE .
+.\" BEGIN Keep parallel with groff.texi node "Page Geometry".
+.I roff
+systems format text under certain assumptions about the size of the
+output medium,
+or page.
+.
+For the formatter to correctly break a line it is filling,
+it must know the line length,
+which it derives from the page width.
+.\" (@pxref{Line Layout}).
 .
-A command called
-.B runoff
-was written for Multics in the late 60s in the BCPL language, by
-.IR "Bob Morris" ,
-.IR "Doug McIlroy" ,
-and other members of the Multics team.
+For it to decide whether to write an output line to the current page or
+wait until the next one,
+it must know the page length.
+.\" (@pxref{Page Layout}).
+.
+.
+A device's
+.I resolution
+converts practical units like inches or centimeters to
+.I basic units,
+a convenient length measure for the output device or file format.
+.
+The formatter and output driver use basic units to reckon page
+measurements.
+.
+The device description file defines its resolution and page dimensions
+(see
+.MR groff_font @MAN5EXT@ ).
+.\" (@pxref{DESC File Format}).
 .
 .
 .P
-Like its CTSS ancestor, Multics
-.B runoff
-formatted an input file consisting of text and command lines; commands
-began with a period and were two letters.
+A
+.I page
+is a two-dimensional structure upon which a
+.I roff
+system imposes a rectangular coordinate system with its upper left
+corner as the origin.
 .
-Output from these commands was to terminal devices such as IBM Selectric
-terminals.
+Coordinate values are in basic units and increase down and to the right.
+Useful ones are therefore always positive and within numeric ranges
+corresponding to the page boundaries.
 .
-Multics
-.B runoff
-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
+While the formatter
+(and,
+later,
+output driver)
+is processing a page,
+it keeps track of its
+.I drawing position,
+which is the location at which the next glyph will be written,
+from which the next motion will be measured,
+or where a geometric object will commence rendering.
+.
+Notionally,
+glyphs are drawn from the text baseline upward and to the right.
+.RI ( groff
+does not yet support right-to-left scripts.)
+.
+The
+.I text baseline
+is a
+(usually invisible)
+line upon which the glyphs of a typeface are aligned.
+.
+A glyph therefore \lqstarts\rq at its bottom-left corner.
+.
+If drawn at the origin,
+a typical letter glyph would lie partially or wholly off the page,
+depending on whether,
+like \lqg\rq,
+it features a descender below the baseline.
 .
 .
 .P
-BCPL and
-.B runoff
-were ported to the GCOS system at Bell Labs when BTL left the
-development of Multics.
+Such a situation is nearly always undesirable.
+.
+It is furthermore conventional not to write or draw at the extreme edges
+of the page.
+.
+Therefore the initial drawing position of a
+.I roff
+formatter is not at the origin,
+but below and to the right of it.
+.
+This rightward shift
+from the left edge is known as the
+.I page offset.
+.
+.RI ( groff 's
+terminal output devices have page offsets of zero.)
+.
+The downward shift leaves room for a text output line.
 .
 .
 .P
-There is a free archive about
-.I historical RUNOFF
-documents.
+Text is arranged on a one-dimensional lattice of text baselines from
+the top to the bottom of the page.
 .
-You can get it anonymously by the shell command
-.RS
-.EX
-$git clone https://github.com/bwarken/RUNOFF_historical.git
-.EE
-.RE
+.I Vertical spacing
+is the distance between adjacent text baselines.
+.
+Typographic tradition sets this quantity to 120% of the type size.
+.
+The initial vertical drawing position is one unit of vertical spacing
+below the page top.
+.
+Typographers term this unit a
+.I vee.
 .
 .
 .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.
+Vertical spacing has an impact on page-breaking decisions.
 .
-You can get an early version anonymously by the shell command
-.RS
-.EX
-$git clone https://github.com/bwarken/runoff.git
-.EE
-.RE
+Generally,
+when a break occurs,
+the formatter moves the drawing position to the next text baseline
+automatically.
+.
+If the formatter were already writing to the last line that would fit on
+the page,
+advancing by one vee would place the next text baseline off the page.
+.
+Rather than let that happen,
+.I roff
+formatters instruct the output driver to eject the page,
+start a new one,
+and again set the drawing position to one vee below the page top;
+this is a
+.I page break.
+.
+.
+.P
+When the last line of input text corresponds to the last output line
+that fits on the page,
+the break caused by the end of input will also break the page,
+producing a useless blank one.
+.
+Macro packages keep users from having
+to confront this difficulty by setting \lqtraps\rq;
+.\" (@pxref{Traps});
+moreover,
+all but the simplest page layouts tend to have headers and footers,
+or at least bear vertical margins larger than one vee.
+.\" END Keep parallel with groff.texi node "Page Geometry".
 .
 .
 .\" ====================================================================
-.SS "The Classical nroff/troff System"
+.SS "Other language elements"
 .\" ====================================================================
 .
-At BTL, there was a need to drive the
-.I Graphic Systems CAT
-typesetter, a graphical output device from a PDP-11 computer running
-Unix.
+.I Escape sequences
+start with the
+.I escape character,
+a backslash
+.BR \rs ,
+and are followed by at least one additional character.
+.
+They can appear anywhere in the input.
+.
+.
+.P
+With requests,
+the escape and control characters can be changed;
+further,
+escape sequence recognition can be turned off and back on.
+.
+.
+.P
+.I Strings
+store character sequences.
+.
+In
+.IR groff ,
+they can be parameterized as macros can.
+.
+.
+.P
+.I Registers
+store numerical values,
+including measurements.
+.
+The latter are generally in basic units;
+.I scaling units
+can be appended to numeric expressions to clarify their meaning when
+stored or interpolated.
+.
+Some read-only predefined registers interpolate text.
+.
+.
+.P
+.I Fonts
+are identified either by a name or by a mounting position
+(a non-negative number).
+.
+Four styles are available on all devices.
+.
+.B R
+is \lqroman\rq:
+normal,
+upright text.
+.
+.B B
+is
+.BR bold ,
+an upright typeface with a heavier weight.
+.
+.B I
+is
+.IR italic ,
+a face that is oblique on typesetter output devices and usually
+underlined instead on terminal devices.
+.
+.B BI
+is \fBIbold-italic\f\/, \" indulging a bit of man(7) evil here
+combining both of the foregoing style variations.
+.
+Typesetting devices group these four styles into
+.I families
+of text fonts;
+they also typically offer one or more
+.I special
+fonts that provide unstyled glyphs;
+see
+.MR groff_char @MAN7EXT@ .
+.
+.
+.P
+.I groff
+supports named
+.I colors
+for glyph rendering and drawing of geometric objects.
+.
+Stroke and fill colors are distinct;
+the stroke color is used for glyphs.
+.
+.
+.P
+.I Glyphs
+are visual representation forms of
+.I characters.
+.
+In
+.I groff,
+the distinction between those two elements is not always obvious
+(and a full discussion is beyond our scope).
+.
+In brief,
+\lqA\rq is a character when we consider it in the abstract:
+to make it a glyph,
+we must select a typeface with which to render it,
+and determine its type size and color.
+.
+The formatting process turns input characters into output glyphs.
+.
+A few characters commonly seen on keyboards are treated
+specially by the
+.I roff
+language and may not look correct in output if used unthinkingly;
+they are
+the (double) quotation mark
+.RB ( \|\dq\| ),
+the neutral apostrophe
+.RB ( \|\aq\| ),
+the minus sign
+.RB ( \- ),
+the backslash
+.RB ( \|\rs\| ),
+the caret or circumflex accent
+.RB ( \ha ),
+the grave accent
+.RB ( \|\ga\| ),
+and the tilde
+.RB ( \ti ).
+.
+All of these and more can be produced with
+.I special character
+escape sequences;
+see
+.MR groff_char @MAN7EXT@ .
+.
+.
+.P
+.I groff
+offers
+.IR streams ,
+identifiers for writable files,
+but for security reasons this feature is disabled by default.
+.
+.
+.\" BEGIN Keep roughly parallel with first paragraphs of groff.texi node
+.\" "Deferring Output".
+.P
+A further few language elements arise as page layouts become more
+sophisticated and demanding.
 .
-As
-.B runoff
-was too limited for this task it was further developed into a more
-powerful text formatting system by
-.IR "Joseph F.\& Ossanna" ,
-who already programmed several runoff ports.
+.I Environments
+collect formatting parameters like line length and typeface.
+.
+A
+.I diversion
+stores formatted output for later use.
+.
+A
+.I trap
+is a condition on the input or output,
+tested automatically by the formatter,
+that is associated with a macro,
+calling it when that condition is fulfilled.
 .
 .
 .P
-The name
-.I runoff
-was shortened to
-.IR roff .
+Footnote support often exercises all three of the foregoing features.
+.
+A simple implementation might work as follows.
+.
+A pair of macros is defined:
+one starts a footnote and the other ends it.
+.
+The author calls the first macro where a footnote marker is desired.
+.
+The macro establishes a diversion so that the footnote text is collected
+at the place in the body text where its corresponding marker appears.
+.
+An environment is created for the footnote so that it is set at a
+smaller typeface.
+.
+The footnote text is formatted in the diversion using that environment,
+but it does not yet appear in the output.
+.
+The document author calls the footnote end macro,
+which returns to the previous environment and ends the diversion.
+.
+Later,
+after much more body text in the document,
+a trap,
+set a small distance above the page bottom,
+is sprung.
+.
+The macro called by the trap draws a line across the page and emits the
+stored diversion.
 .
-The greatly enlarged language of Ossanna's version already
-included all elements of a full
-.IR "roff system" .
+Thus,
+the footnote is rendered.
+.\" END Keep roughly parallel with first paragraphs of groff.texi node
+.\" "Deferring Output".
 .
-All modern
+.
+.\" ====================================================================
+.SH History
+.\" ====================================================================
+.
+Computer-driven document formatting dates back to the 1960s.
+.\" John Labovitz points out that Peter Samson's TJ-2 dates to 1963,
+.\" but since this is a *roff man page, we do not begin our story there.
+.\" https://johnlabovitz.com/publications/\
+.\" The-electric-typesetter--The-origins-of-computing-in-typography.pdf
+.
+The
 .I roff
-systems try to implement compatibility to this system.
+system is intimately connected with Unix,
+but its origins lie with the earlier operating systems CTSS,
+GECOS,
+and Multics.
+.
+.
+.\" ====================================================================
+.SS "The predecessor\em\fIRUNOFF\f"
+.\" ====================================================================
 .
-So Joe Ossanna can be called the father of all
+.IR roff 's
+ancestor
+.I RUNOFF
+was written in the MAD language by Jerry Saltzer
+to prepare his Ph.D.\& thesis on the Compatible Time Sharing System
+(CTSS),
+a project of the Massachusetts Institute of Technology (MIT).
+.
+This program is referred to in full capitals,
+both to distinguish it from its many descendants,
+and because bits were expensive in those days;
+five- and six-bit character encodings were still in widespread usage,
+and mixed-case alphabetics in file names seen as a luxury.
+.
+.I RUNOFF
+introduced a syntax of inlining formatting directives amid document
+text,
+by beginning a line with a period
+(an unlikely occurrence in human-readable material)
+followed by a \lqcontrol word\rq.
+.
+Control words with obvious meaning like \lq.line length
+.IR n \rq
+were supported as well as an abbreviation system;
+the latter came to overwhelm the former in popular usage and later
+derivatives of the program.
+.
+A sample of control words from a
+.UR http://\:web\:.mit\:.edu/\:Saltzer/\:www/\:publications/\:ctss/\:AH\
+\:.9\:.01\:.html
+.I RUNOFF
+manual of December 1966
+.UE
+was documented as follows
+(with the parameter notation slightly altered).
+.
+The abbreviations will be familiar to
 .I roff
-systems.
+veterans.
 .
 .
 .P
-This first
-.I roff system
-had three formatter programs.
+.ne 10v
+.TS
+center;
+r l
+rB l.
+Abbreviation	Control word
+\&.ad	.adjust
+\&.bp	.begin page
+\&.br	.break
+\&.ce	.center
+\&.in	.indent \fIn\f
+\&.ll	.line length \fIn\f
+\&.nf	.nofill
+\&.pl	.paper length \fIn\f
+\&.sp	.space \fIn\f
+.TE
 .
-.TP
-.B troff
-.RI ( "typesetter roff\/" )
-generated a graphical output for the
-.I CAT
-typesetter as its only device.
 .
-.TP
-.B nroff
-produced text output suitable for terminals and line printers.
+.P
+In 1965,
+MIT's Project MAC teamed with Bell Telephone Laboratories and General
+Electric (GE) to inaugurate the
+.UR http://\:www\:.multicians\:.org
+Multics
+.UE
+project.
+.
+After a few years,
+Bell Labs discontinued its participation in Multics,
+famously prompting the development of Unix.
+.
+Meanwhile,
+Saltzer's
+.I RUNOFF
+proved influential,
+seeing many ports and derivations elsewhere.
+.
+.
+.\" "Morris did one port and called it roff. I did the BCPL one, adding
+.\" registers, but not macros. Molly Wagner contributed a hyphenation
+.\" algorithm. Ken and/or Dennis redid roff in PDP-11 assembler. Joe
+.\" started afresh for the grander nroff, including macros. Then Joe
+.\" bought a phototypesetter ..."
+.\" -- https://minnie.tuhs.org/pipermail/tuhs/2018-November/017052.html
+.P
+In 1969,
+Doug McIlroy wrote one such reimplementation,
+adding extensions,
+in the BCPL language for a GE 645 running GECOS at the Bell Labs
+location in Murray Hill,
+New Jersey.
+.
+In its manual,
+the control commands were termed \lqrequests\rq,
+their two-letter names were canonical,
+and the control character was configurable with a
+.B .cc
+request.
+.
+Other familiar requests emerged at this time;
+no-adjust
+.RB ( .na ),
+need
+.RB ( .ne ),
+page offset
+.RB ( .po ),
+tab configuration
+.RB ( .ta ,
+though it worked differently),
+temporary indent
+.RB ( .ti ),
+character translation
+.RB ( .tr ),
+and automatic underlining
+.RB ( .ul ;
+on
+.I RUNOFF
+you had to backspace and underscore in the input yourself).
+.B .fi
+to enable filling of output lines got the name it retains to this day.
+.
+McIlroy's program also featured a heuristic system for automatically
+placing hyphenation points,
+designed and implemented by Molly Wagner.
+.
+It furthermore introduced numeric variables,
+termed registers.
+.
+By 1971,
+this program had been ported to Multics and was known as
+.IR roff ,
+a name McIlroy attributes to Bob Morris,
+to distinguish it from CTSS
+.IR RUNOFF .
 .
-.TP
-.B roff
-was the reimplementation of the former
-.B runoff
-program with its limited features; this program was abandoned in later
-versions.
+.\" GBR can't find a source for this claim (of Bernd's).
+.\"Multics
+.\".I runoff
+.\"added features such as the ability to do two-pass formatting;
+.\"it became the main system for Multics documentation and text
+.\"processing.
 .
-Today, the name
+.
+.\" ====================================================================
+.SS "Unix and \fIroff\f"
+.\" ====================================================================
+.
+McIlroy's
 .I roff
-is used to refer to a
-.I troff/\:nroff
-system as a whole.
+was one of the first Unix programs.
+.
+In Ritchie's term,
+it was \lqtransliterated\rq from BCPL to DEC PDP-7 assembly language
+.\" see "The Evolution of the Unix Time-Sharing System", Ritchie, 1984
+for the fledgling Unix operating system.
+.
+Automatic hyphenation was managed with
+.B .hc
+and
+.B .hy
+requests,
+line spacing control was generalized with the
+.B .ls
+request,
+and what later
+.IR roff s
+would call diversions were available via \lqfootnote\rq requests.
+.\" The foregoing features may have been in McIlroy's Multics roff, but
+.\" he no longer has documentation for that--only the GECOS version.
+.\" GBR's guess is that they were, if we take Ritchie's choice of the
+.\" term "transliterated" seriously.  GBR further speculates that there
+.\" is no reason to suppose that McIlroy's roff was stagnant from
+.\" 1969-1971, whereas we have no record of any significant
+.\" post-transliteration development of Unix roff.  Its request list did
+.\" not appear until the 3rd edition manual, and did not change
+.\" thereafter.  In 7th edition, roff was characterized as "utterly
+.\" frozen".
+.
+This
+.I roff
+indirectly funded operating systems research at Murray Hill;
+AT&T prepared patent applications to the U.S.\& government with it.
+.
+This arrangement enabled the group to acquire a PDP-11;
+.I roff
+promptly proved equal to the task of formatting the manual for what
+would become known as \lqFirst Edition Unix\rq,
+dated November 1971.
+.
+.
+.P
+Output from all of the foregoing programs was limited to line printers
+and paper terminals such as the IBM 2471
+(based on the Selectric line of typewriters)
+and the Teletype Corporation Model 37.
+.
+Proportionally spaced type was unavailable.
+.
+.
+.\" ====================================================================
+.SS "New \fIroff\f and Typesetter \fIroff\f"
+.\" ====================================================================
+.
+The first years of Unix were spent in rapid evolution.
+.
+The practicalities of preparing standardized documents like patent
+applications
+(and Unix manual pages),
+combined with McIlroy's enthusiasm for macro languages,
+perhaps created an irresistible pressure to make
+.I roff
+extensible.
+.
+Joe Ossanna's
+.IR nroff ,
+literally a \lqnew roff\rq,
+was the outlet for this pressure.
+.
+.\" nroff is listed in the table of contents of the Version 2 manual,
+.\" but no man page is present.
+By the time of Unix Version\~3
+(February 1973)\emand still in PDP-11 assembly language\emit sported
+a swath of features now considered essential to
+.I roff
+systems:
+.
+definition of macros
+.RB ( .de ),
+diversion of text thither
+.RB ( .di ),
+and removal thereof
+.RB ( .rm );
+.
+trap planting
+.RB ( .wh ;
+\lqwhen\rq)
+and relocation
+.RB ( .ch ;
+\lqchange\rq);
+.
+conditional processing
+.RB ( .if );
+.
+and environments
+.RB ( .ev ).
+.
+Incremental improvements included
+.
+assignment of the next page number
+.RB ( .pn );
+.
+no-space mode
+.RB ( .ns )
+and restoration of vertical spacing
+.RB ( .rs );
+.
+the saving
+.RB ( .sv )
+and output
+.RB ( .os )
+of vertical space;
+.
+specification of replacement characters for tabs
+.RB ( .tc )
+and leaders
+.RB ( .lc );
+.
+configuration of the no-break control character
+.RB ( .c2 );
+.
+shorthand to disable automatic hyphenation
+.RB ( .nh );
+.
+a condensation of what were formerly six different requests for
+configuration of page \lqtitles\rq
+(headers and footers)
+into one
+.RB ( .tl )
+with a length controlled separately from the line length
+.RB ( .lt );
+.
+automatic line numbering
+.RB ( .nm );
+.
+interactive input
+.RB ( .rd ),
+which necessitated buffer-flushing
+.RB ( .fl ),
+and was made convenient with early program cessation
+.RB ( .ex );
+.
+source file inclusion in its modern form
+.RB ( .so ;
+though
+.I RUNOFF
+had an \lq.append\rq control word for a similar purpose)
+and early advance to the next file argument
+.RB ( .nx );
+.
+ignorable content
+.RB ( .ig );
+.
+and programmable abort
+.RB ( .ab ).
 .
 .
 .P
-Ossanna's first version was written in the PDP-11 assembly
-language and released in 1973.
+Third Edition Unix also brought the
+.MR pipe 2
+system call,
+the explosive growth of a componentized system based around it,
+and a \lqfilter model\rq that remains perceptible today.
 .
-.I Brian Kernighan
-joined the
+Equally importantly,
+the Bell Labs site in Murray Hill acquired a Graphic Systems C/A/T
+phototypesetter,
+and with it came the necessity of expanding the capabilities of a
 .I roff
-development by rewriting it in the C\~programming language.
+system to cope with a variety of proportionally spaced typefaces at
+multiple sizes.
 .
-The C\~version was released in 1975.
+Ossanna wrote a parallel implementation of
+.I nroff
+for the C/A/T,
+dubbing it
+.I troff
+(for \lqtypesetter roff\rq).
+.
+Unfortunately,
+surviving documentation does not illustrate what requests were
+implemented at this time for C/A/T support;
+the
+.MR troff 1 \" AT&T
+man page in Fourth Edition Unix
+(November 1973)
+does not feature a request list, \" nor does Unix V6 troff(1) (1975)
+unlike
+.MR nroff 1 . \" AT&T
+.
+Apart from typesetter-driven features,
+Unix Version\~4
+.IR roff s
+added string definitions
+.RB ( .ds );
+made the escape character configurable
+.RB ( .ec );
+and enabled the user to write diagnostics to the standard error stream
+.RB ( .tm ).
+.
+Around 1974,
+empowered with multiple type sizes,
+italics,
+and a symbol font specially commissioned by Bell Labs from
+Graphic Systems,
+Kernighan and Lorinda Cherry implemented
+.I eqn \" AT&T
+for typesetting mathematics.
+.
+.
+In the same year,
+for Fifth Edition Unix,
+Ossanna combined and reimplemented the two
+.IR roff s
+in C,
+using that language's preprocessor to generate both from a single source
+tree.
 .
 .
 .P
-The syntax of the formatting language of the
-.BR nroff /\: troff
-programs was documented in the famous
-.I "Troff User's Manual"
-CSTR\~#54,
-first published in 1976, with further revisions up to 1992 by Brian
-Kernighan.
+Ossanna documented the syntax of the input language to the
+.I nroff
+and
+.I troff
+programs in the \lqTroff User's Manual\rq,
+first published in 1976,
+with further revisions as late as 1992 by Kernighan.
 .
-This document is the specification of the
-.IR "classical troff" .
+(The original version was entitled
+\lqNroff/Troff User's Manual\rq,
+which may partially explain why
+.I roff
+practitioners have tended to refer to it by its AT&T document
+identifier,
+\lqCSTR #54\rq.)
 .
-All later
+Its final revision serves as the
+.I de facto
+specification of AT&T
+.IR troff , \" AT&T
+and all subsequent implementors of
 .I roff
-systems tried to establish compatibility with this specification.
+systems have done so in its shadow.
 .
 .
 .P
-After Ossanna's death in 1977, Kernighan went on with developing
-.IR troff .
+A small and simple set of
+.I roff
+macros was first used for the manual pages of Unix Version\~4 and
+persisted for two further releases,
+but the first macro package to be formally described and installed was
+.I ms
+by Michael Lesk in Version\~6.
+.
+He also wrote a manual,
+\lqTyping Documents on the Unix System\rq,
+describing
+.I ms
+and basic
+.IR nroff / troff
+usage,
+updating it as the package accrued features.
+.
+Sixth Edition additionally saw the debut of the
+.I tbl \" AT&T
+preprocessor for formatting tables,
+also by Lesk.
 .
-In the late 1970s, Kernighan equipped
+.
+.P
+For Unix Version\~7
+(January 1979),
+McIlroy designed,
+implemented,
+and documented the
+.I man
+macro package,
+introducing most of the macros described in
+.MR groff_man 7
+today,
+and edited volume 1 of the Version 7 manual using it.
+.
+Documents composed using
+.I ms
+featured in volume 2,
+edited by Kernighan.
+.
+.
+.\" Thanks to Clem Cole for the following account.
+.\" https://minnie.tuhs.org/pipermail/tuhs/2022-January/025143.html
+.P
+Meanwhile,
 .I troff
-with a general interface to support more devices, the intermediate
-output format, and the postprocessor system.
+proved popular even at Unix sites that lacked a C/A/T device.
 .
-This completed the structure of a
-.I "roff system"
-as it is still in use today;
-see section \lqUsing Roff\rq below.
+Tom Ferrin of the University of California at San Francisco combined it
+with Allen Hershey's popular vector fonts to produce
+.IR vtroff ,
+which translated
+.IR troff 's
+output to the command language used by Versatec and Benson-Varian
+plotters.
 .
-In 1979, these novelties were described in the paper
-CSTR\~#97.
 .
-This new
+.P
+Ossanna had passed away unexpectedly in 1977,
+and after the release of Version 7,
+with the C/A/T typesetter becoming supplanted by alternative devices
+such as the Mergenthaler Linotron 202,
+Kernighan undertook a revision and rewrite of
 .I troff
-version is the basis for all existing newer troff systems, including
-.IR groff .
+to generalize its design.
 .
-On some systems, this
-.I device independent troff
-got a binary of its own, called
-.BR ditroff (@MAN7EXT@).
+To implement this revised architecture,
+he developed the font and device description file formats and the
+page description language that remain in use today.
 .
-All modern
-.B troff
-programs already provide the full
-.B ditroff
-capabilities automatically.
+He described these novelties in the article
+\lqA Typesetter-independent TROFF\rq,
+last revised in 1982,
+and like the
+.I troff
+manual itself,
+it is widely known by a shorthand,
+\lqCSTR #97\rq.
+.\" Further entertaining reading can be found at:
+.\" <https://www.cs.princeton.edu/~bwk/202/summer.reconstructed.pdf>.
 .
 .
-.\" ====================================================================
-.SS "Availability"
-.\" ====================================================================
+.P
+Kernighan's innovations prepared
+.I troff
+well for the introduction of the Adobe PostScript language in 1982 and a
+vibrant market in laser printers with built-in interpreters for it.
+.
+An output driver for PostScript,
+.IR dpost ,
+was swiftly developed.
 .
-The source code of both the ancient Unix and classical
+However,
+AT&T's software licensing practices kept
+Ossanna's
+.IR troff ,
+with its tight coupling to the C/A/T's capabilities,
+in parallel distribution with device-independent
 .I troff
-weren't available for two decades.
+throughout the 1980s.
 .
-Nowadays, it is accessible again (on-line) for non-commercial use;
-see
-.BR "SEE ALSO" ,
-below.
+Today,
+however,
+all actively maintained
+.IR troff s
+follow Kernighan's device-independent design.
 .
 .
 .\" ====================================================================
-.SS "groff \em free GNU roff"
+.SS "\fIgroff\f\ema free \fIroff\f from GNU"
 .\" ====================================================================
 .
 The most important free
 .I roff
-project was the \fCRGNU\f implementation of
+project historically has been
+.IR groff ,
+the GNU implementation of
 .IR troff ,
-written from scratch by
-.I James Clark
-and put under the
-.UR http://\:www.gnu.org/\:copyleft
-GNU Public License
-.UE .
+developed by James Clark starting in 1989 and distributed under
+.UR http://\:www\:.gnu\:.org/\:copyleft
+copyleft
+.UE
+licenses,
+ensuring to all the availability of source code and the freedom to
+modify and redistribute it,
+properties unprecedented in
+.I roff
+systems to that point.
 .
-It was called
 .I groff
-(\fCRGNU\f
-.IR roff ).
+rapidly attracted contributors,
+and has served as a replacement for almost all applications of AT&T
+.I troff
+(exceptions include
+.IR mv ,
+a macro package for preparation of viewgraphs and slides,
+and the
+.I ideal
+preprocessor,
+which produces diagrams from mathematical constraints).
+.
+Beyond that,
+it has added numerous features;
+see
+.MR groff_diff @MAN7EXT@ .
 .
-See
-.BR groff (@MAN1EXT@)
-for an overview.
+Since its inception and for at least the following three decades,
+it has been used by practically all GNU/Linux and BSD operating systems.
 .
 .
 .P
-The
 .I groff
-system is still actively developed.
+continues to be developed,
+is available for almost all operating systems in common use
+(along with several obscure ones),
+and is free.
 .
-It is compatible to the classical
-.IR troff ,
-but many extensions were added.
-.
-It is the first
-.I roff
-system that is available on almost all operating systems \em and it
-is free.
-.
-This makes
+These factors make
 .I groff
-the de facto
+the
+.I de facto
 .I roff
 standard today.
 .
 .
 .\" ====================================================================
-.SS "Free Heirloom roff"
+.SS "Other free \fIroff\fs"
 .\" ====================================================================
 .
-An alternative is
-.UR https://\:github.com/\:n\-t\-roff/\:heirloom\-doctools
-.I Gunnar Ritter's Heirloom roff project
-.UE
-project, started in 2005, which provides enhanced versions of the
-various roff tools found in the OpenSolaris and Plan\~9 operating
-systems, now available under free licenses.
+In 2007, \" TODO: verify
+Caldera/SCO and Sun Microsystems,
+having acquired rights to AT&T Documenter's Workbench (DWB)
+.I troff
+(a descendant of the Bell Labs code),
+released it under a free but GPL-incompatible license.
+.
+.UR https://\:github\:.com/\:n\-t\-roff/\:DWB3.3
+This implementation
+.UE
+was made portable to modern POSIX systems,
+and adopted and enhanced first by Gunnar Ritter and then Carsten Kunze
+to produce
+.UR https://github.com/n-t-roff/heirloom-doctools
+Heirloom Doctools
+.I troff
+.UE .
+.
 .
-You can get this package with the shell command:
-.RS
-.EX
-\Do git clone https://github.com/n\-t\-roff/heirloom\-doctools
-.EE
-.RE
+.P
+.\" https://lists.gnu.org/archive/html/groff/2013-07/msg00001.html
+In July 2013,
+Ali Gholami Rudi announced
+.UR https://\:github\:.com/\:aligrudi/\:neatroff
+.I neatroff
+.UE ,
+a permissively licensed new implementation.
 .
 .
 .P
-Moreover, one finds there the
-.UR https://\:github.com/\:n\-t\-roff/\:DWB3.3
-.I Original Documenter's Workbench Release 3.3
+Another descendant of DWB
+.I troff \" DWB
+is part of
+.UR https://\:9fans\:.github\:.io/\:plan9port/
+Plan\~9 from User Space
 .UE .
 .
+Since 2021,
+this
+.I troff \" Plan 9 from User Space
+has been available under permissive terms.
+.
 .
 .\" ====================================================================
-.SH "USING ROFF"
+.SH "Using \fIroff\f"
 .\" ====================================================================
 .
-Most people won't even notice that they are actually using
-.IR roff .
-.
-When you read a system manual page (man page)
-.I roff
-is working in the background.
-.
-But using
+When you read a man page,
+often a
 .I roff
-explicitly isn't difficult either.
+is the program rendering it.
 .
-.
-.P
 Some
 .I roff
 implementations provide wrapper programs that make it easy to use the
 .I roff
-system on the shell command line.
-.
-For example, the \fCRGNU\f
-.I roff
-implementation
-.BR groff (@MAN1EXT@)
-provides command-line options to avoid the long command pipes of
-classical
-.IR troff ;
-a program
-.BR grog (@MAN1EXT@)
-tries to guess from the document which arguments should be used for a
-run of
-.BR groff ;
-people who do not like specifying command-line options should try the
-.BR groffer (@MAN1EXT@)
-program for graphically displaying
+system from the shell's command line.
+.
+These can be specific to a macro package,
+like
+.MR mmroff @MAN1EXT@ ,
+or more general.
+.
+.MR groff @MAN1EXT@
+provides command-line options sparing the user from constructing the
+long,
+order-dependent pipelines familiar to AT&T
+.I troff
+users.
+.
+Further,
+a heuristic program,
+.MR grog @MAN1EXT@ ,
+is available to infer from a document's contents which
 .I groff
-files and man pages.
+arguments should be used to process it.
 .
 .
 .\" ====================================================================
-.SS "The roff Pipe"
+.SS "The \fIroff\f pipeline"
 .\" ====================================================================
 .
-Each
+A typical
 .I roff
-system consists of preprocessors,
-.I roff
-formatter programs, and a set of device postprocessors.
+document is prepared by running one or more processors in series,
+followed by a a formatter program and then an output driver
+(or \lqdevice postprocessor\rq).
+.
+Commonly,
+these programs are structured into a pipeline;
+that is,
+each is run in sequence such that the output of one is
+taken as the input
+to the next,
+without passing through secondary storage.
+.
+(On non-Unix systems,
+pipelines may have to be simulated with temporary files.)
 .
-This concept makes heavy use of the
-.I piping
-mechanism, that is, a series of programs is called one after the other,
-where the output of each program in the queue is taken as the input
-for the next program.
 .
 .RS
-.P
-cat \fIfile\fP \
-| .\|.\|. \
-| \fIpreproc\fP \
-| .\|.\|. \
-| troff \fIoptions\fP \
-| \fIpostproc\fP
+.PP
+.EX
+.RI $\~ preproc1 \~\c
+.BI <\~ input-file \~|\~ preproc2 \~|\~\c
+.RB .\|.\|.\&\~ "| troff\~"\c
+.RI  option \~\c
+.RB .\|.\|.\&\~ \rs
+.BI "    |\~" output-driver \" 4 leading spaces
+.EE
 .RE
 .
 .
 .P
-The preprocessors generate
+Once all preprocessors have run,
+they deliver pure
 .I roff
-code that is fed into a
-.I roff
-formatter (e.g.\&
-.BR troff ),
-which in turn generates
-.I intermediate output
-that is fed into a device postprocessor program for printing or final
-output.
+language input to the formatter,
+which in turn generates a document in a page description language that
+is then interpreted by a postprocessor for viewing,
+printing,
+or further processing.
 .
 .
 .P
-All of these parts use programming languages of their own; each
-language is totally unrelated to the other parts.
-.
-Moreover,
+Each program interprets input in a language that is independent of the
+others;
+some are purely descriptive,
+as with
+.MR @g@tbl @MAN1EXT@
+and
+.I roff
+output,
+and some permit the definition of macros,
+as with
+.MR @g@eqn @MAN1EXT@
+and
 .I roff
-macro packages that were tailored for special purposes can be
-included.
+input.
 .
 .
-.P
 Most
 .I roff
-documents use the macros of some package, intermixed with code for one
-or more preprocessors, spiced with some elements from the plain
+input files employ the macros of a document formatting package,
+intermixed with instructions for one or more preprocessors,
+and seasoned with escape sequences and requests from the
 .I roff
 language.
 .
-The full power of the
+Some documents are simpler still,
+since their formatting packages discourage direct use of
 .I roff
-formatting language is seldom needed by users; only programmers of
-macro packages need to know about the gory details.
+requests;
+man pages are a prominent example.
 .
+Many features of the
+.I roff
+language are seldom needed by users;
+only authors of macro packages require a substantial command of them.
 .
 .
 .\" ====================================================================
-.SS "Preprocessors"
+.SS Preprocessors
 .\" ====================================================================
 .
 A
 .I roff
-preprocessor is any program that generates output that syntactically
-obeys the rules of the
+preprocessor is a program that,
+directly or ultimately,
+generates output in the
 .I roff
-formatting language.
+language.
 .
-Each preprocessor defines a language of its own that is translated
-into
+Typically, \" preconv is an exception.
+each preprocessor defines a language of its own that transforms its
+input into that for
 .I roff
-code when run through the preprocessor program.
+or another preprocessor.
 .
-Parts written in these languages may be included within a
-.I roff
-document; they are identified by special
-.I roff
-requests or macros.
+As an example of the latter,
+.I chem \" generic
+produces
+.I pic \" generic
+input.
 .
-Each document that is enhanced by preprocessor code must be run
-through all corresponding preprocessors before it is fed into the
-actual
+Preprocessors must consequently be run in an appropriate order;
+.MR groff @MAN1EXT@
+handles this automatically for all preprocessors supplied by the GNU
 .I roff
-formatter program, for the formatter just ignores all alien code.
-.
-The preprocessor programs extract and transform only the document
-parts that are determined for them.
+system.
 .
 .
 .P
-There are a lot of free and commercial
+Portions of the document written in preprocessor languages are usually
+.\" preconv is the exception again.
+bracketed by tokens that look like
 .I roff
-preprocessors.
+macro calls.
 .
-Some of them aren't available on each system, but there is a small
-set of preprocessors that are considered as an integral part of each
 .I roff
-system.
+preprocessor programs transform only the regions of the document
+intended for them.
+.\" In preconv's case, that's the whole document.
 .
-The classical preprocessors are
-.
-.RS
-.TS
-tab (@);
-lb l.
-tbl@for tables.
-eqn@for mathematical formulae.
-pic@for drawing diagrams.
-refer@for bibliographic references.
-soelim@for including macro files from standard locations.
-chem@for drawing chemical formul\ae.
-.TE
-.RE
+When a preprocessor language is used by a document,
+its corresponding program must process it before the input is seen by
+the formatter,
+or incorrect rendering is almost guaranteed.
 .
 .
 .P
-Other known preprocessors that are not available on all systems
-include
+GNU
+.I roff
+provides several preprocessors,
+including
+.IR @g@eqn ,
+.IR @g@grn ,
+.IR @g@pic ,
+.IR @g@tbl ,
+.IR @g@refer ,
+and
+.IR @g@soelim .
+.
+See
+.MR groff @MAN1EXT@
+for a complete list.
+.
+Other preprocessors for
+.I roff
+systems are known.
+.
 .
+.P
 .RS
 .TS
 tab (@);
-lb l.
-grap@for constructing graphical elements.
-grn@for including \fBgremlin\fR(1) pictures.
+Li L.
+dformat@depicts data structures;
+grap@constructs statistical charts; and
+ideal@draws diagrams using a constraint-based language.
 .TE
 .RE
 .
 .
 .\" ====================================================================
-.SS "Formatter Programs"
+.SS "Formatter programs"
 .\" ====================================================================
 .
 A
-.I roff formatter
-is a program that parses documents written in the
-.I roff
-formatting language or uses some of the
 .I roff
-macro packages.
-.
-It generates
-.IR "intermediate output" ,
-which is intended to be fed into a single device postprocessor that
-must be specified by a command-line option to the formatter program.
-.
-The documents must have been run through all necessary preprocessors
-before.
-.
-.
-.P
-The output produced by a
+formatter transforms
 .I roff
-formatter is represented in yet another language, the
-.IR "intermediate output format"
-or
-.IR "troff output" .
+language input into a single file in a page description language,
+described in
+.MR groff_out @MAN5EXT@ ,
+intended for processing by a selected device.
 .
-This language was first specified in
-CSTR\~#97;
-its \fCRGNU\f extension is documented in
-.BR groff_out (@MAN5EXT@).
-.
-The intermediate output language is a kind of assembly language
-compared to the high-level
-.I roff
-language.
+This page description language is specialized in its parameters,
+but not its syntax,
+for the selected device;
+the format is
+.RI device- independent ,
+but not
+.RI device- agnostic .
 .
-The generated intermediate output is optimized for a special device,
-but the language is the same for every device.
+The parameters the formatter uses to arrange the document are stored in
+.I device
+and
+.IR "font description files" ;
+see
+.MR groff_font @MAN5EXT@ .
 .
 .
 .P
-The
-.I roff
-formatter is the heart of the
-.I roff
-system.
+AT&T Unix
+had two formatters\em\c
+.I nroff
+for terminals,
+and
+.I troff
+for typesetters.
 .
-The traditional
-.I roff
-had two formatters,
-.B nroff
-for text devices and
-.B troff
-for graphical devices.
+Often,
+the name
+.I troff
+is used loosely to refer to both.
 .
+When generalizing thus,
+.I groff
+documentation prefers the term
+.RI \lq roff \rq.
 .
-.P
-Often, the name
-.I troff
-is used as a general term to refer to both formatters.
+In GNU
+.IR roff ,
+the formatter program is always
+.MR @g@troff @MAN1EXT@ .
 .
 .
 .\" ====================================================================
-.SS "Devices and Postprocessors"
+.SS "Devices and output drivers"
 .\" ====================================================================
 .
-Devices are hardware interfaces like printers, text or graphical
-terminals, etc., or software interfaces such as a conversion into a
-different text or graphical format.
-.
-.
-.P
-A
-.I roff
-postprocessor is a program that transforms
-.I troff
-output into a form suitable for a special device.
-.
-The
+To a
 .I roff
-postprocessors are like device drivers for the output target.
-.
-.
-.P
-For each device there is a postprocessor program that fits the device
-optimally.
-.
-The postprocessor parses the generated intermediate output and
-generates device-specific code that is sent directly to the device.
+system,
+a
+.I device
+is a hardware interface like a printer,
+a text or graphical terminal,
+or a standardized file format that unrelated software can interpret.
 .
+An
+.I output driver
+is a program that parses the output of
+.I troff \" generic
+and produces instructions specific to the device or file format it
+supports.
 .
-.P
-The names of the devices and the postprocessor programs are not fixed
-because they greatly depend on the software and hardware abilities of
-the actual computer.
-.
-For example, the classical devices mentioned in
-CSTR\~#54
-have greatly changed since the classical times.
-.
-The old hardware doesn't exist any longer and the old graphical
-conversions were quite imprecise when compared to their modern
-counterparts.
+An output driver might support multiple devices,
+particularly if they are similar.
 .
 .
 .P
-For example, the PostScript device
-.I post
-in classical
-.I troff
-had a resolution of 720 units per inch, while
+The names of the devices and their driver programs are not standardized.
+.
+Technological fashions evolve;
+the devices used for document preparation when AT&T
+.I troff \" AT&T
+was first written in the 1970s are no longer used in production
+environments.
+.
+Device capabilities have tended to increase,
+improving resolution and font repertoire,
+and adding color output and hyperlinking.
+.
+Further,
+to reduce file size and processing time,
+AT&T
+.IR troff 's \" AT&T
+page description language placed low limits on the magnitudes of some
+quantities it could represent.
+.
+Its PostScript output driver,
+.MR dpost 1 ,
+had a resolution of 720 units per inch;
 .IR groff 's
-.I ps
-device has 72000, a refinement of factor 100.
+.MR grops @MAN1EXT@
+uses 72,000.
 .
 .
-.P
-Today the operating systems provide device drivers for most
-printer-like hardware, so it isn't necessary to write a special
-hardware postprocessor for each printer.
+.\".P
+.\"Today the operating systems provide device drivers for most
+.\"printer-like hardware, so it isn't necessary to write a special
+.\"hardware postprocessor for each printer.
+.\" XXX?  No they don't.  Instead printers interpret PS or PDF directly.
+.\" With a TCP/IP protocol stack and an HTTP server to accept POSTed
+.\" documents for printing.
 .
 .
 .\" ====================================================================
-.SH "ROFF PROGRAMMING"
+.SH "\fIroff\f programming"
 .\" ====================================================================
 .
 Documents using
 .I roff
-are normal text files decorated by
+are normal text files interleaved with
 .I roff
 formatting elements.
 .
 The
 .I roff
-formatting language is quite powerful; it is almost a full programming
-language and provides elements to enlarge the language.
-.
-With these, it became possible to develop macro packages that are
-tailored for special applications.
+language is powerful enough to support arbitrary computation and
+it supplies facilities that encourage extension.
 .
-Such macro packages are much handier than plain
-.IR roff .
-.
-So most people will choose a macro package without worrying about the
-internals of the
-.I roff
-language.
+The primary such facility is macro definition;
+with this feature,
+macro packages have been developed that are tailored for particular
+applications.
 .
 .
 .\" ====================================================================
-.SS "Macro Packages"
+.SS "Macro packages"
 .\" ====================================================================
 .
-Macro packages are collections of macros that are suitable to format a
-special kind of documents in a convenient way.
-.
-This greatly eases the usage of
-.IR roff .
+Macro packages can have a much smaller vocabulary than
+.I roff
+itself;
+this trait combined with their domain-specific nature can make them easy
+to acquire and master.
 .
-The macro definitions of a package are kept in a file called
+The macro definitions of a package are typically kept in a file called
 .IB name .tmac
-(classically
+(historically,
 .BI tmac. name\/\c\" Italic correction comes before \c !
 ).
 .
-All tmac files are stored in one or more directories at standardized
-positions.
-.
-Details on the naming of macro packages and their placement is found
-in
-.BR groff_tmac (@MAN5EXT@).
+Find details on the naming and placement of macro packages in
+.MR groff_tmac @MAN5EXT@ .
 .
 .
 .P
-A macro package that is to be used in a document can be announced to
+A macro package anticipated for use in a document can be declared to
 the formatter by the command-line option
-.BR \-m ,
+.BR \-m ;
 see
-.BR troff (@MAN1EXT@),
-or it can be specified within a document using the file inclusion
-requests of the
-.I roff
-language, see
-.BR groff (@MAN7EXT@).
+.MR @g@troff @MAN1EXT@ .
+.
+It can alternatively be specified within a document using the
+.B mso
+request of the
+.I groff
+language;
+see
+.MR groff @MAN7EXT@ .
 .
 .
 .P
-Famous classical macro packages are
+Well-known macro packages include
 .I man
-for traditional man pages,
+for traditional man pages and
 .I mdoc
-for \fCRBSD\f-style manual pages;
-the macro sets for books, articles, and letters are
-.I me
-(probably from the first name of its creator
-.I Eric
-Allman),
+for BSD-style manual pages.
+.
+Macro packages for typesetting books,
+articles,
+and letters include
 .I ms
-(from
-.IR "Manuscript Macros\/" ),
-and
+(from \lqmanuscript macros\rq),
+.I me
+(named by a system administrator from the first name of its creator,
+Eric Allman),
 .I mm
-(from
-.IR "Memorandum Macros\/" ).
+(from \lqmemorandum macros\rq),
+and
+.IR mom ,
+a punningly named package exercising many
+.I groff
+extensions.
+.
+See
+.MR groff_tmac @MAN5EXT@
+for more.
 .
 .
 .\" ====================================================================
-.SS "The roff Formatting Language"
+.SS "The \fIroff\f formatting language"
 .\" ====================================================================
 .
-The classical
+.\" TODO: Integrate this subsection with subsection "Other language
+.\" elements".
+The
 .I roff
-formatting language is documented in the
-.I Troff User's Manual
-CSTR\~#54.
+language provides requests,
+escape sequences,
+macro definition facilities,
+string variables,
+registers for storage of numbers or dimensions,
+and control of execution flow.
 .
-The
+The theoretically minded will observe that a
 .I roff
-language is a full programming language providing requests, definition
-of macros, escape sequences, string variables, number or size
-registers, and flow controls.
+is not a mere markup language,
+but Turing-complete.
+.
+It has storage
+(registers),
+it can perform tests
+(as in conditional expressions like
+.RB \lq "(\rsni >= 1)" \rq),
+its
+.\" Kerning between bold "i" and "f" and roman \lq, \rq is tight.
+.RB \lq \|if\| \rq
+and related requests alter the flow of control,
+and macro definition permits unbounded recursion.
 .
 .
 .P
 .I Requests
-are the predefined basic formatting commands similar to the commands
-at the shell prompt.
-.
-The user can define request-like elements using predefined
-.I roff
-elements.
-.
-These are then called
-.IR macros .
+and
+.I escape sequences
+are instructions,
+predefined parts of the language,
+that perform formatting operations,
+interpolate stored material,
+or otherwise change the state of the parser.
+.
+The user can define their own request-like elements by composing
+together text,
+requests,
+and escape sequences
+.I "ad libitum."
+.
+.
+A document writer will not (usually) note any difference in usage for
+requests or macros;
+both are found on control lines.
+.
+However,
+there is a distinction;
+requests take either a fixed number of arguments
+(sometimes zero),
+silently ignoring any excess,
+or consume the rest of the input line,
+whereas macros can take a variable number of arguments.
+.
+Since arguments are separated by spaces,
+macros require a means of embedding a space in an argument;
+in other words,
+of quoting it.
+.
+This then demands a mechanism of embedding the quoting character itself,
+in case
+.I it
+is needed literally in a macro argument.
+.
+AT&T
+.I troff
+had complex rules involving the placement and repetition of the double
+quote to achieve both aims.
 .
-A document writer will not note any difference in usage for requests
-or macros; both are written on a line on their own starting with a dot.
+.I groff
+cuts this knot by supporting a special character escape sequence for the
+neutral double quote,
+.\" The kerning between a roman \lq and a bold backslash is tight.
+.RB \lq \|\rsdq \rq,
+which never performs quoting in the typesetting language,
+but is simply a glyph,
+.RB \oq \dq \cq.
 .
 .
 .P
 .I Escape sequences
-are
-.I roff
-elements starting with a backslash
-.QuotedChar \rs .
-.
-They can be inserted anywhere, also in the midst of text in a line.
-.
-They are used to implement various features, including the insertion of
-non-\fCRASCII\f characters with
-.Esc ( ,
+start with a backslash,
+.RB \lq \|\rs \rq.
+.
+They can appear almost anywhere,
+even in the midst of text on a line,
+and implement various features,
+including the insertion of special characters with
+.RB \lq \|\rs(\fBIxx\f \rq
+or
+.RB \lq \|\rs\fBIxxx\f \rq,
+break suppression at input line endings with
+.RB \lq \|\rsc \rq,
 font changes with
-.Esc f ,
+.RB \lq \|\rsf\| \rq,
+type size changes with
+.RB \lq \|\rss \rq,
 in-line comments with
-.Esc \dq ,
-the escaping of special control characters like
-.Esc \rs ,
-and many other features.
+.RB \lq \|\rs\dq \rq,
+and many others.
 .
 .
 .P
 .I Strings
-are variables that can store a string.
-.
-A string is stored by the
-.B .ds
-request.
+store text.
 .
-The stored string can be retrieved later by the
+They are populated with the
+.B ds
+request and interpolated using the
 .B \rs*
 escape sequence.
 .
 .
 .P
 .I Registers
-store numbers and sizes.
+store numbers and measurements.
 .
 A register can be set with the request
-.B .nr
+.B nr
 and its value can be retrieved by the escape sequence
 .BR "\rsn" .
 .
 .
 .\" ====================================================================
-.SH "FILE NAME EXTENSIONS"
+.SH "File naming conventions"
 .\" ====================================================================
 .
-Manual pages (man pages) take the section number as a file name
-extension, e.g., the filename for this document is
-.IR roff.7 ,
-i.e., it is kept in section\~7
-of the man pages.
+The structure or content of a file name,
+beyond its location in the file system,
+is not significant to
+.I roff
+tools.
+.
+.I roff
+documents employing \lqfull-service\rq macro packages
+(see
+.MR groff_tmac @MAN5EXT@ )
+tend to be named with a suffix identifying the package;
+we thus see file names ending in
+.IR .man ,
+.IR .ms ,
+.IR .me ,
+.IR .mm ,
+and
+.IR .mom ,
+for instance.
 .
+When installed,
+man pages tend to be named with the manual's section number as the
+suffix.
 .
-.P
-The classical macro packages take the package name as an extension,
-e.g.\&
-.IB file. me
-for a document using the
-.I me
-macro package,
-.IB file. mm
-for
-.IR mm ,
-.IB file. ms
-for
-.IR ms ,
-.IB file. pic
-for
-.I pic
-files,
-etc.
+For example,
+the file name for this document is
+.IR roff.7 .
+.
+Practice for
+\lqraw\rq
+.I roff
+documents is less consistent;
+they
+are sometimes seen with a
+.I .t
+suffix.
 .
 .
-.P
-But there is no general naming scheme for
+.\" BEGIN Keep parallel with groff.texi node "Input Conventions".
+.\" ====================================================================
+.SH "Input conventions"
+.\" ====================================================================
+.
+Since
+.I @g@troff
+fills text automatically,
+it is common practice in the
 .I roff
-documents, though
-.IB file. tr
-for
-.I troff file
-is seen now and then.
+language to avoid visual composition of text in input files:
+the esthetic appeal of the formatted output is what matters.
 .
-Maybe there should be a standardization for the filename extensions of
+Therefore,
+.I roff
+input should be arranged such that it is easy for authors and
+maintainers to compose and develop the document,
+understand the syntax of
 .I roff
-files.
+requests,
+macro calls,
+and preprocessor languages used,
+and predict the behavior of the
+formatter.
 .
+Several traditions have accrued in service of these goals.
 .
-.P
-File name extensions can be very handy in conjunction with the
-.BR less (1)
-pager.
 .
-It provides the possibility to feed all input into a command-line pipe
-that is specified in the shell environment variable
-.BR LESSOPEN .
+.IP \bu 2n
+Follow sentence endings in the input with newlines to ease their
+recognition.
+.\" Texinfo: (@pxref{Sentences}).
+It is frequently convenient to end text lines after colons and
+semicolons as well,
+as these typically precede independent clauses.
 .
-This process is not well documented, so here an example:
+Consider doing so after commas;
+they often occur in lists that become easy to scan when itemized by
+line,
+or constitute supplements to the sentence that are added,
+deleted,
+or updated to clarify it.
 .
-.RS
-.P
-.EX
-LESSOPEN='|lesspipe %s'
-.EE
-.RE
+Parenthetical and quoted phrases are also good candidates for placement
+on text lines by themselves.
 .
 .
-.P
-where
-.B lesspipe
-is either a system supplied command or a shell script of your own.
+.IP \bu
+Set your text editor's line length to 72 characters or fewer;
+see the subsections below.
+.\" Texinfo:
+.\" @footnote{Emacs: @code{fill-column: 72}; Vim: @code{textwidth=72}}
 .
+This limit,
+combined with the previous item of advice,
+makes it less common that an input line will wrap in your text editor,
+and thus will help you perceive excessively long constructions in your
+text.
 .
-.P
-More details for
-.I file name extensions
-can be found at
-.BR groff_filenames (5).
+Recall that natural languages originate in speech,
+not writing,
+and that punctuation is correlated with pauses for breathing and changes
+in prosody.
 .
 .
-.\" ====================================================================
-.SH "EDITING ROFF"
-.\" ====================================================================
+.IP \bu
+Use
+.B \rs&
+after
+.RB \lq !\& \rq,
+.RB \lq ?\& \rq,
+and
+.RB \lq .\& \rq
+if they are followed by space,
+tab,
+or newline characters and don't end a sentence.
+.
+.
+.IP \bu
+In filled text lines,
+use
+.B \rs&
+before
+.RB \lq .\& \rq
+and
+.RB \lq \aq \rq
+if they are preceded by space,
+so that reflowing the input doesn't turn them into control lines.
 .
-All
-.I roff
-formatters provide automated line breaks and horizontal and vertical
-spacing.
 .
-In order to not disturb this, the following tips can be helpful.
+.IP \bu
+Do not use spaces to perform indentation or align columns of a table.
+Leading spaces are reliable when text is not being filled.
 .
-.IP \(bu
-Never include empty or blank lines in a
-.I roff
-document.
 .
-Instead, use the empty request (a line consisting of a dot only) or a
-line comment
-.B .\rs"\""
-if a structuring element is needed.
+.IP \bu
+Comment your document.
 .
-.IP \(bu
-Never start a line with whitespace because this can lead to unexpected
-behavior.
+It is never too soon to apply comments to record information of use to
+future document maintainers
+(including your future self).
+.\" Texinfo: We thus introduce another escape sequence, @code{\"}, which
+The
+.B \rs\dq
+escape sequence
+causes
+.I @g@troff
+to ignore the remainder of the input line.
 .
-Indented paragraphs can be constructed in a controlled way by
-.I roff
-requests.
 .
-.IP \(bu
-Start each sentence on a line of its own, for the spacing after a dot
-is handled differently depending on whether it terminates an
-abbreviation or a sentence.
+.IP \bu
+Use the empty request\ema control character followed immediately by a
+newline\emto visually manage separation of material in input files.
 .
-To distinguish both cases, do a line break after each sentence.
+Many of the
+.I groff
+project's own documents use an empty request between sentences,
+after macro definitions,
+and where a break is expected,
+and two empty requests between paragraphs or other requests or macro
+calls that will introduce vertical space into the document.
 .
-.IP \(bu
-To additionally use the auto-fill mode in Emacs, it is best to insert
-an empty
-.I roff
-request (a line consisting of a dot only) after each sentence.
+You can combine the empty request with the comment escape sequence to
+include whole-line comments in your document,
+and even \lqcomment out\rq sections of it.
 .
 .
 .P
-The following example shows judicious line breaking in a
-.I roff
-input file.
+.\" Texinfo: We conclude this section with an example
+An example sufficiently long to illustrate most of the above suggestions
+in practice follows.
+.
+.\" Texinfo: For the purpose of fitting the example between the margins
+.\" of this manual with the font used for its typeset version,
+.\" we have shortened the input line length to 56
+.\" columns.
+.\" Texinfo: As before,
+.
+An arrow \-> indicates a tab character.
+.
 .
-.RS
 .P
+.RS
 .EX
-.\" Keep the text width to 65 columns or fewer in this example so that
-.\" it doesn't overrun the right margin when set in Courier (-Tps,
-.\" -Tpdf).
-This is an example of a
-\&.I roff
-document that you can type into your text editor.
+\&.\rs"   nroff this_file.roff | less
+\&.\rs"   groff \-T ps this_file.roff > this_file.ps
+\->The theory of relativity is intimately connected with
+the theory of space and time.
 \&.
-.
-This is the next sentence in the same paragraph.
+I shall therefore begin with a brief investigation of
+the origin of our ideas of space and time,
+although in doing so I know that I introduce a
+controversial subject.\&  \rs" remainder of paragraph elided
 \&.
-.
-This is a longer sentence stretching over several input lines;
-abbreviations like cf.\& are easily identified because the dot is
-not followed by a line break.
+.ne 3v \" Don't let a page break hide the blank line from the reader.
 \&.
-.
-In the output, this sentence continues the same paragraph.
+\&
+\->The experiences of an individual appear to us arranged
+in a series of events;
+in this series the single events which we remember
+appear to be ordered according to the criterion of
+\rslqearlier\rsrq and \rslqlater\rsrq, \rs" punct \
+swapped
+which cannot be analysed further.
+\&.
+There exists,
+therefore,
+for the individual,
+an I\-time,
+or subjective time.
+\&.
+This itself is not measurable.
+\&.
+I can,
+indeed,
+associate numbers with the events,
+in such a way that the greater number is associated with
+the later event than with an earlier one;
+but the nature of this association may be quite
+arbitrary.
+\&.
+This association I can define by means of a clock by
+comparing the order of events furnished by the clock
+with the order of a given series of events.
+\&.
+We understand by a clock something which provides a
+series of events which can be counted,
+and which has other properties of which we shall speak
+later.
+\&.\rs" Albert Einstein, _The Meaning of Relativity_, 1922
 .EE
 .RE
+.\" END Keep parallel with groff.texi node "Input Conventions".
 .
 .
 .\" ====================================================================
 .SS "Editing with Emacs"
 .\" ====================================================================
 .
-The best program for editing a
+Official GNU doctrine holds that the best program for editing a
 .I roff
-document is Emacs (or XEmacs); see
-.BR emacs (1).
+document is Emacs; see
+.MR emacs 1 .
 .
 It provides an
 .I nroff
-mode that is suitable for all kinds of
+major mode that is suitable for all kinds of
 .I roff
 dialects.
 .
@@ -1074,59 +2262,71 @@
 .
 .P
 When editing a file within Emacs the mode can be changed by typing
-.RI \oq "M-x nroff\-mode" \cq,
+.RI \lq M-x
+.BR nroff\-mode \rq,
 where
-.B M-x
-means to hold down the
-.B Meta
-key (or
-.BR Alt )
-and press the
-.BR x\~ key
-at the same time.
+.I M-x
+means to hold down the meta key
+(often labelled \lqAlt\rq)
+while pressing and releasing the \lqx\rq key.
+.\" Why is this sort of thing not in intro(1)?
 .
 .
 .P
-But it is also possible to have the mode automatically selected when
-the file is loaded into the editor.
+It is also possible to have the mode automatically selected when a
+.I roff
+file is loaded into the editor.
+.
+.
+.IP \(bu 2n
+The most general method is to include file-local variables at the end of
+the file;
+we can also configure the fill column this way.
 .
-.IP \(bu
-The most general method is to include the following 3 comment lines at
-the end of the file.
 .
 .RS
 .IP
 .EX
 \&.\rs" Local Variables:
+\&.\rs" fill\-column: 72
 \&.\rs" mode: nroff
 \&.\rs" End:
 .EE
 .RE
 .
 .IP \(bu
-There is a set of file name extensions, e.g.\& the man pages that
+Certain file name extensions,
+such as those commonly used by man pages,
 trigger the automatic activation of the
 .I nroff
 mode.
 .
+.
+.br
+.ne 3v
 .IP \(bu
-Theoretically, it is possible to write the sequence
+Technically,
+having the sequence
+.
 .
 .RS
 .IP
 .EX
-\&.\rs" \%\-*\-\ nroff\ \-*\-\""
+\&.\rs" \%\-*\- nroff \-*\-
 .EE
 .RE
 .
+.
 .IP
-as the first line of a file to have it started in
+in the first line of a file will cause Emacs to enter the
 .I nroff
-mode when loaded.
+major mode when it is loaded into the buffer.
 .
-Unfortunately, some applications such as the
-.B man
-program are confused by this; so this is deprecated.
+Unfortunately,
+some implementations of the
+.MR man 1
+program are confused by this practice,
+so we discourage it.
 .
 .
 .\" ====================================================================
@@ -1135,294 +2335,279 @@
 .
 .\" TODO: elvis, vile.  Nvi does not support highlighting at all, and
 .\" gedit does but has no rules for roff yet.  Other editors TBD.
-Besides Emacs, some other editors provide
-.I nroff
-style files too, e.g.\&
-.BR vim (1),
+Other editors provide support for
+.IR roff -style
+files too,
+such as
+.MR vim 1 ,
 an extension of the
-.BR vi (1)
+.MR vi 1
 program.
 .
 Vim's highlighting can be made to recognize
 .I roff
 files by setting the
-.I filetype
+.B filetype
 option in a Vim
 .IR modeline .
 .
-For this feature to work, your copy of
-.B vim
-must be built with support for, and configured to enable, several
-features; consult the editor's online help topics
-\lqauto\-setting\rq, \lqfiletype\rq, and \lqsyntax\rq.
+For this feature to work,
+your copy of
+.I vim
+must be built with support for,
+and configured to enable,
+several features;
+consult the editor's online help topics
+\lqauto\-setting\rq,
+\lqfiletype\rq,
+and \lqsyntax\rq.
 .
 Then put the following at the end of your
 .I roff
-files, after any Emacs configuration:
-.\" ...because Emacs pattern-matches against ~3000 bytes from the end of
-.\" the buffer for "Local variables:", but Vim only checks as many lines
-.\" as its 'modelines' variable tells it to.  A common default is "5",
-.\" but Emacs settings can be longer than that.
+files,
+after any Emacs configuration:
+.\" ...because Emacs pattern-matches against 3000 bytes from the end of
+.\" the buffer or until hitting a 0x0C (FF, form-feed control) for
+.\" "Local Variables:", but Vim only checks as many lines as its
+.\" 'modelines' variable tells it to.  A common default is "5", but
+.\" Emacs settings can be longer than that.
 .
-.P
 .
 .RS
 .IP
 .EX
-\&.\rs" vim: set filetype=groff:
+\&.\rs" vim: set filetype=groff textwidth=72:
 .EE
 .RE
 .
 .
 .P
 Replace \lqgroff\rq in the above with \lqnroff\rq if you want
-highlighing that does
+highlighting that does
 .I not
-recognize many of the \fCRGNU\f extensions to
+recognize many of the GNU extensions to
 .IR roff ,
-such as request, register, and string names longer than two characters.
+such as request,
+register,
+and string names longer than two characters.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
+.ME
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-There is a lot of documentation on
-.IR roff .
+Much
+.I roff
+documentation is available.
 .
-The original papers on classical
+The Bell Labs papers describing AT&T
 .I troff
-are still available, and all aspects of
+remain available,
+and
 .I groff
-are documented in great detail.
+is documented comprehensively. \" ...one hopes.
 .
 .
 .\" ====================================================================
 .SS "Internet sites"
 .\" ====================================================================
 .
-.TP
-History of Unix Manpages
-.UR http://\:manpages.bsd.lv/\:history.html
-The history page
-.UE
-of the mdocml project provides an overview of
-.I roff
-development up to date, with links to original documentation
-and comments of the original authors.
-.
-.TP
-troff.org
-.UR http://\:www.troff.org
-The historical troff site
-.UE
-provides an overview and pointers to the historical aspects of
-.IR roff .
+.P
+.UR https://\:github\:.com/\:larrykollar/\:Unix\-Text\-Processing
+.I Unix Text Processing
+.UE ,
+by Dale Dougherty and Tim O'Reilly,
+1987,
+Hayden Books.
 .
-.TP
-Multics
-.UR http://\:www.multicians.org
-The Multics site
-.UE
-contains a lot of information on the MIT projects, CTSS, Multics,
-early Unix, including
-.IR runoff ;
-especially useful are a glossary and the many links to ancient
-documents.
-.
-.TP
-Unix Archive
-.UR http://\:www.tuhs.org/\:Archive/
-The Ancient Unixes Archive
-.UE
+This well-regarded text brings the reader from a state of no knowledge
+of Unix or text editing
+(if necessary)
+to sophisticated computer-aided typesetting.
 .
-provides the source code and some binaries of the ancient Unixes
-(including the source code of
-.I troff
-and its documentation) that were made public by Caldera since 2001,
-e.g.\& of the famous Unix version\~7 for PDP-11 at the
-.UR http://\:www.tuhs.org/\:Archive/\:PDP\-11/\:Trees/\:V7
-Unix V7 site
-.UE .
+It has been placed under a free software license by its authors and
+updated by a team of
+.I groff
+contributors and enthusiasts.
 .
-.TP
-Developers at AT&T Bell Labs
-.UR http://\:www.bell\-labs.com/
-Bell Labs Computing and Mathematical Sciences Research
-.UE
 .
-provides a search facility for tracking information on the early
-developers.
+.P
+.UR http://\:manpages\:.bsd\:.lv/\:history\:.html
+\lqHistory of Unix Manpages\rq
+.UE ,
+an online article maintained by the mdocml project,
+provides an overview of
+.I roff
+development from Saltzer's
+.I RUNOFF
+to 2008,
+with links to original documentation and recollections of the authors
+and their contemporaries.
 .
-.TP
-Plan 9
-.UR http://\:plan9.bell\-labs.com
-The Plan\~9 operating system
-.UE
 .
-by AT&T Bell Labs.
+.P
+.UR http://\:www\:.troff\:.org/
+troff.org
+.UE ,
+Ralph Corderoy's
+.I troff
+site,
+provides an overview and pointers to much historical
+.I roff
+information.
 .
-.TP
-runoff
-.UR http://\:web.mit.edu/\:Saltzer/\:www/\:publications/\:pubs.html
-Jerry Saltzer's home page
-.UE
 .
-stores some documents using the ancient RUNOFF formatting language.
+.P
+.UR http://\:www\:.multicians\:.org/
+Multicians
+.UE ,
+a site by Multics enthusiasts,
+contains a lot of information on the MIT projects CTSS and Multics,
+including
+.IR RUNOFF ;
+it is especially useful for its glossary and the many links to
+historical documents.
 .
-.TP
-CSTR Papers
-.UR https://\:www.alcatel\-lucent.com/\:bell\-labs\-journals
-The Bell Labs (now Alcatel) CSTR site
-.UE
 .
-stores the original
+.P
+.UR http://\:www\:.tuhs\:.org/\:Archive/
+The Unix Archive
+.UE ,
+curated by the Unix Heritage Society,
+provides the source code and some binaries of historical Unices
+(including the source code of some versions of
 .I troff
-manuals (CSTR #54, #97, #114, #116, #122) and famous historical
-documents on programming.
+and its documentation)
+contributed by their copyright holders.
+.
 .
-.TP
-\fCRGNU\f \fIroff\f
-.UR http://\:www.gnu.org/\:software/\:groff
-The groff web site
+.P
+.UR http://\:web\:.mit\:.edu/\:Saltzer/\:www/\:publications/\
+\:pubs\:.html
+Jerry Saltzer's home page
 .UE
-provides the free
-.I roff
-implementation
-.IR groff ,
-the actual standard
-.IR roff .
+stores some documents using the original
+.I RUNOFF
+formatting language.
+.
+.
+.P
+.UR http://\:www\:.gnu\:.org/\:software/\:groff
+.I groff
+.UE ,
+GNU
+.IR roff 's
+web site,
+provides convenient access to
+.IR groff 's
+source code repository,
+bug tracker,
+and mailing lists
+(including archives and the subscription interface).
 .
 .
 .\" ====================================================================
-.SS "Historical roff Documentation"
+.SS "Historical \fIroff\f documentation"
 .\" ====================================================================
 .
-Many classical
-.B troff
-documents are still available on-line.
-.
-The two main manuals of the
+Many AT&T
 .I troff
-language are
-.
-.TP
-CSTR\~#54
-J.\& F.\& Ossanna,
-.UR http://\:www.troff.org/\:54.pdf
-.I "Nroff/\:Troff User's Manual"
-.UE ;
-.
-Bell Labs, 1976; revised by Brian Kernighan, 1992.
-.
-.TP
-CSTR\~#97
-Brian Kernighan,
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:97.ps.gz
-.I "A Typesetter-independent TROFF"
-.UE ,
+documents are available online,
+and can be found at Ralph Corderoy's site
+(see above)
+or via Internet search.
 .
-Bell Labs, 1981, revised March 1982.
 .
 .P
-The \lqlittle language\rq
-.I roff
-papers are
-.
-.TP
-CSTR\~#114
-Jon L.\& Bentley and Brian W.\& Kernighan,
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:114.ps.gz
-.I "GRAP \en A Language for Typesetting Graphs"
-.UE ;
-.
-Bell Labs, August 1984.
+Of foremost significance are two mentioned in section \lqHistory\rq
+above,
+describing the language and its device-independent implementation,
+respectively.
 .
-.TP
-CSTR\~#116
-Brian W.\& Kernighan,
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:116.ps.gz
-.I "PIC \en A Graphics Language for Typesetting"
-.UE ;
 .
-Bell Labs, December 1984.
+.P
+\lqTroff User's Manual\rq
+by Joseph F.\& Ossanna,
+1976
+(revised by Brian W.\& Kernighan,
+1992),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 54.
 .
-.TP
-CSTR\~#122
-J.\& L.\& Bentley, L.\& W.\& Jelinski, and B.\& W.\& Kernighan,
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:122.ps.gz
-.I "CHEM \en A Program for Typesetting Chemical Structure Diagrams,"
-.I "Computers and Chemistry"
-.UE ;
 .
-Bell Labs, April 1986.
+.P
+\lqA Typesetter-independent TROFF\rq
+by Brian W.\& Kernighan,
+1982,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 97.
 .
 .
 .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
+You can obtain many relevant Bell Labs papers in PDF from
+.UR https://\:github\:.com/\:bwarken/\:roff_classical\:.git
+Bernd Warken's
+\lqroff classical\rq
+GitHub repository
+.UE .
 .
 .
 .\" ====================================================================
-.SS "Manual Pages"
+.SS "Manual pages"
 .\" ====================================================================
 .
-Due to its complex structure, a full
+As a system of multiple components,
+a
 .I roff
-system has many man pages, each describing a single aspect of
-.IR roff .
+system potentially has many man pages,
+each describing an aspect of it.
 .
-Unfortunately, there is no general naming scheme for the documentation
-among the different
+Unfortunately,
+there is no consistent naming scheme for these pages among the different
 .I roff
 implementations.
 .
 .
 .P
-In
-.IR groff ,
-the man page
-.BR groff (@MAN1EXT@)
-contains a survey of all documentation available in
-.IR groff .
+For GNU
+.IR roff ,
+the
+.MR groff @MAN1EXT@
+man page enumerates all man pages distributed with the system,
+and individual pages frequently refer to external resources as well as
+manuals distributed with
+.I groff
+on a variety of topics.
 .
 .
 .P
-On other systems, you are on your own, but
-.BR troff (1)
+With other
+.IR roff s,
+you are on your own,
+but
+.MR troff 1 \" foreign troff
 might be a good starting point.
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \nroff_C
-.
+.cp \n*groff_roff_7_man_C
+.do rr *groff_roff_7_man_C
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
 .
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/mdate.pl -> _service:tar_scm:groff-1.23.0.tar.gz/mdate.pl Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grodvi/dvi.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grodvi/dvi.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,8 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#include <assert.h>
+
 #include "driver.h"
 #include "nonposix.h"
 #include "paper.h"
@@ -316,23 +317,23 @@
     break;
   case RGB:
     sprintf(buf, "color rgb %.3g %.3g %.3g",
-		 double(Red) / color::MAX_COLOR_VAL,
-		 double(Green) / color::MAX_COLOR_VAL,
-		 double(Blue) / color::MAX_COLOR_VAL);
+		 double(Red) / double(color::MAX_COLOR_VAL),
+		 double(Green) / double(color::MAX_COLOR_VAL),
+		 double(Blue) / double(color::MAX_COLOR_VAL));
     break;
   case CMY:
     col->get_cmyk(&Cyan, &Magenta, &Yellow, &Black);
     // fall through
   case CMYK:
     sprintf(buf, "color cmyk %.3g %.3g %.3g %.3g",
-		 double(Cyan) / color::MAX_COLOR_VAL,
-		 double(Magenta) / color::MAX_COLOR_VAL,
-		 double(Yellow) / color::MAX_COLOR_VAL,
-		 double(Black) / color::MAX_COLOR_VAL);
+		 double(Cyan) / double(color::MAX_COLOR_VAL),
+		 double(Magenta) / double(color::MAX_COLOR_VAL),
+		 double(Yellow) / double(color::MAX_COLOR_VAL),
+		 double(Black) / double(color::MAX_COLOR_VAL));
     break;
   case GRAY:
     sprintf(buf, "color gray %.3g",
-		 double(Gray) / color::MAX_COLOR_VAL);
+		 double(Gray) / double(color::MAX_COLOR_VAL));
     break;
   }
   do_special(buf);
@@ -694,7 +695,7 @@
     env->fill->get_gray(&g);
   }
   char buf256;
-  sprintf(buf, "sh %.3g", 1 - double(g)/color::MAX_COLOR_VAL);
+  sprintf(buf, "sh %.3g", 1 - double(g) / double(color::MAX_COLOR_VAL));
   do_special(buf);
 }
 
@@ -935,7 +936,7 @@
     case 'p':
       if (!font::scan_papersize(optarg, 0,
 				&user_paper_length, &user_paper_width))
-	error("invalid custom paper size '%1' ignored", optarg);
+	error("ignoring invalid paper format '%1'", optarg);
       break;
     case 'v':
       {
@@ -946,7 +947,7 @@
     case 'w':
       if (sscanf(optarg, "%d", &linewidth) != 1
 	  || linewidth < 0 || linewidth > 1000) {
-	error("bad line width");
+	error("invalid line width '%1' ignored", optarg);
 	linewidth = DEFAULT_LINEWIDTH;
       }
       break;
@@ -973,6 +974,15 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -dv -F dir -w n files ...\n",
-	  program_name);
+  fprintf(stream,
+"usage: %s -dl -F dir -p paper-format -w n file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+          program_name, program_name, program_name);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grodvi/grodvi.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grodvi/grodvi.1.man Changed

@@ -1,13 +1,15 @@
-.TH GRODVI @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grodvi \- convert groff output to TeX DVI format
+.TH grodvi @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grodvi \-
+.I groff
+output driver for TeX DVI format
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020, 2022 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
@@ -26,252 +28,214 @@
 .
 .
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grodvi_C \n.C
+.do nr *groff_grodvi_1_man_C \n.cp
 .cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
 .
 .ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .el .ds tx TeX
 .
+.\" This macro definition is poor style from a portability standpoint,
+.\" but it's a good test and demonstration of the standard font
+.\" repertoire for the devices where it has any effect at all, and so
+.\" should be retained.
 .de FT
 .  if '\\*(.T'dvi' .ft \\$1
 ..
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grodvi
-.OP \-dl
-.OP \-F dir
-.OP \-p papersize
-.OP \-w n
-.RI  file
-\&.\|.\|.\&
+.RB  \-dl 
+.RB  \-F\~\c
+.IR dir 
+.RB  \-p\~\c
+.IR paper-format 
+.RB  \-w\~\c
+.IR n 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY grodvi
 .B \-\-help
 .YS
 .
+.
 .SY grodvi
 .B \-v
+.
 .SY grodvi
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B grodvi
-is a driver for
-.B groff
-that produces \*(tx DVI format.
-.
-Normally it should be run by
-.BR groff\ \-Tdvi .
-.
-This will run
-.BR @g@troff\ \-Tdvi ;
-it will also input the macros in
-.IR @MACRODIR@/\:dvi.tmac .
-.
-.LP
+The GNU
+.I roff
+DVI output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into \*tx DVI format.
+.
+Normally,
+.I grodvi
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given the
+.RB \lq \-T\~dvi \rq
+option.
+.
+(In this installation,
+.B @DEVICE@
+is the default output device.)
+.
+Use
+.IR groff 's
+.B \-P
+option to pass any options shown above to
+.IR grodvi .
+.
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I grodvi
+reads the standard input stream.
+.
+Output is written to the standard output stream.
+.
+.
+.P
 The DVI file generated by
-.B grodvi
-can be printed by any correctly-written DVI driver.
+.I grodvi
+can interpreted by any correctly written DVI driver.
 .
-The troff drawing primitives are implemented
-using the tpic version\~2 specials.
+.I troff \" generic
+drawing primitives are implemented using
+.I tpic
+version\~2 specials.
 .
-If the driver does not support these, the
+If the driver does not support these,
 .B \rsD
-commands will not produce any output.
+escape sequences will not produce any output.
 .
-.LP
-There is an additional drawing command available:
-.
-.TP
-.BI \rsD'R\  dh\ dv '
-Draw a rule (solid black rectangle), with one corner
-at the current position, and the diagonally opposite corner
-at the current position
-.RI +( dh , dv ).
 .
-Afterwards the current position will be at the opposite corner.
-.
-This produces a rule in the DVI file and so can be printed even with a
-driver that does not support the tpic specials unlike the other
-.B \rsD
-commands.
-.
-.LP
-The groff command
-.BI \rsX' anything '
-is translated into the same command in the DVI file as would be
-produced by
-.BI \rsspecial{ anything }
-in \*(tx;
-.I anything
-may not contain a newline.
-.
-.LP
-For inclusion of EPS image files,
-.B \-Tdvi
-loads
-.I pspic.tmac
-automatically, providing the
+.P
+Encapsulated PostScript (EPS) files can be easily included;
+use the
 .B PSPIC
 macro.
 .
-Please check
-.BR groff_tmac (@MAN5EXT@)
-for a detailed description.
-.
-.LP
-Font files for
-.B grodvi
-can be created from tfm files using
-.BR tfmtodit (@MAN1EXT@).
-.
-The font description file should contain the following
-additional commands:
-.
-.TP
-.BI internalname\   name
-The name of the tfm file (without the
-.I .tfm
-extension) is
-.IR name .
-.
-.TP
-.BI checksum\  n
-The checksum in the tfm file is
-.IR n .
+.I pspic.tmac
+is loaded automatically by
+.IR dvi.tmac .
 .
-.TP
-.BI designsize\  n
-The designsize in the tfm file is
-.IR n .
+See
+.MR groff_tmac @MAN5EXT@ .
 .
-.LP
-These are automatically generated by
-.B tfmtodit.
 .
-.LP
-The default color for
+.P
+The default color used by the
 .B \rsm
 and
 .B \rsM
-is black.
+escape sequences is black.
 .
-Currently, the drawing color for
+Currently,
+the stroke color for
 .B \rsD
-commands is always black, and fill color values are translated to gray.
+drawing escape sequences is black;
+fill color values are translated to gray.
 .
-.LP
+.
+.P
 In
-.B troff
+.IR groff ,
+as in AT&T
+.IR troff , \" AT&T
 the
 .B \rsN
-escape sequence can be used to access characters by their position
-in the corresponding tfm file;
-all characters in the tfm file can be accessed this way.
+escape sequence can be used to access any glyph in the current font by
+its position in the corresponding TFM file.
 .
-.LP
-By design, the DVI format doesn't care about physical dimensions of the
-output medium.
+.
+.P
+By design,
+the DVI format doesn't care about the physical dimensions of the output
+medium.
 .
 Instead,
-.B grodvi
+.I grodvi
 emits the equivalent to \*tx's
-.BI \rsspecial{papersize= width , length }
+.BI \%\rsspecial{\:\%papersize= width , length }
 on the first page;
-.B dvips
-(and possibly other DVI drivers) then sets the page size accordingly.
-.
-If either the page width or length is not positive, no papersize special
-is output.
-.
-.
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
-.B \-d
-Do not use tpic specials to implement drawing commands.
-.
-Horizontal and vertical lines will be implemented by rules.
-.
-Other drawing commands will be ignored.
-.
-.TP
-.BI \-F dir
-Prepend directory
-.RI dir /dev name
-to the search path for font and device description files;
-.I name
-is the name of the device, usually
-.BR dvi .
-.
-.TP
-.B \-l
-Specify landscape orientation.
-.
-.TP
-.BI \-p papersize
-Specify paper dimensions.
-.
-This overrides the
-.BR papersize ,
-.BR paperlength ,
-and
-.B paperwidth
-commands in the
-.I DESC
-file; it accepts the same arguments as the
-.B papersize
-command (see
-.BR groff_font (@MAN5EXT@)
-for details).
-.
-.TP
-.B \-v
-Print the version number.
-.
-.TP
-.BI \-w n
-Set the default line thickness to
-.I n
-thousandths of an em.
-.
-If this option isn't specified, the line thickness defaults to
-0.04\~em.
+.I dvips
+(or another DVI driver)
+then sets the page size accordingly.
+.
+If either the page width or length is not positive,
+no
+.B \%papersize
+special is output.
+.
+.
+.P
+A device control escape sequence
+.BI \rsX\aq anything \aq
+is translated to the same DVI file instructions as would be produced by
+.BI \%\rsspecial{ anything }
+in \*tx;
+.I anything
+cannot contain a newline.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SS Typefaces
 .\" ====================================================================
 .
-There are styles called
-.BR R ,
-.BR I ,
-.BR B ,
+.I grodvi
+supports the standard four styles:
+.B R
+(roman),
+.B I
+.RI ( italic ),
+.B B
+.RB ( bold ),
 and
 .B BI
-mounted at font positions 1 to\ 4.
-The fonts are grouped into families
+(\fBIbold-italic\f).
+.
+Fonts are grouped into families
 .B T
 and
 .B H
-having members in each of these styles:
+having members in each style.
+.
+\lqCM\rq abbreviates \lqComputer Modern\rq.
+.
 .
 .RS
 .TP
@@ -323,25 +287,28 @@
 .FT
 .RE
 .
+.
 .LP
-There are also the following fonts which are not members of a family:
+The following fonts are not members of a family.
+.
 .
 .RS
 .TP
 .B CW
-CM Typewriter Text (cmtt10)
 .FT CW
+CM Typewriter Text (cmtt10)
 .FT
 .
 .TQ
 .B CWI
-CM Italic Typewriter Text (cmitt10)
 .FT CWI
+CM Italic Typewriter Text (cmitt10)
 .FT
 .RE
 .
-.LP
-Special fonts are
+.
+.P
+Special fonts include
 .B MI
 (cmmi10),
 .B S
@@ -349,99 +316,276 @@
 .B EX
 (cmex10),
 .B SC
-(cmtex10, only for
+(cmtex10,
+only for
 .BR CW ),
-and, perhaps surprisingly,
+and,
+perhaps surprisingly,
 .BR TR ,
 .BR TI ,
 and
 .BR CW ,
-due to the different font encodings of text fonts.
+.\" See font/devdvi/generate/Makefile for details.
+because \*tx places some glyphs in text fonts that
+.I troff \" generic
+generally does not.
 .
 For italic fonts,
 .B CWI
 is used instead of
 .BR CW .
 .
-.LP
-Finally, the symbol fonts of the American Mathematical Society are available
-as special fonts
+.
+.P
+Finally,
+the symbol fonts of the American Mathematical Society are available as
+special fonts
 .B SA
 (msam10) and
 .B SB
 (msbm10).
 .
-These two fonts are not mounted by default.
+They are are not mounted by default.
 .
-.LP
-Using the option
+.
+.br
+.ne 2v
+.P
+The
+.I @g@troff
+option
 .B \-mec
-(which loads the file
-.IR ec.tmac )
-provides the EC and TC fonts.
+loads the
+.I ec.tmac
+macro file,
+employing the EC and TC fonts instead of CM.
 .
-The design of the EC family is very similar to that of the CM fonts;
-additionally, they give a much better coverage of groff symbols.
+These are designed similarly to the Computer Modern fonts;
+further,
+they provide Euro
+.B \rsEu
+and per mille
+.B \rs%0
+glyphs.
 .
-Note that
 .I ec.tmac
-must be called before any language-specific files; it doesn't take
-care of hcode values.
+must be loaded before any language-specific macro files because it does
+not set up the codes necessary for automatic hyphenation.
+.
+.
+.\" ====================================================================
+.SS "Font description files"
+.\" ====================================================================
+.
+Use
+.MR tfmtodit @MAN1EXT@
+to create
+.I groff
+font description files from TFM
+(\*tx font metrics)
+files.
+.
+The font description file should contain the following additional
+directives,
+which
+.I tfmtodit
+generates automatically.
+.
+.
+.TP
+.BI internalname\~ name
+The name of the TFM file
+(without the
+.I .tfm
+extension) is
+.IR name .
+.
+.
+.TP
+.BI checksum\~ n
+The checksum in the TFM file is
+.IR n .
+.
+.
+.TP
+.BI designsize\~ n
+The design size in the TFM file is
+.IR n .
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SS "Drawing commands"
+.\" ====================================================================
+.
+.I grodvi
+supports an additional drawing command.
+.
+.
+.TP
+.BI \rsD\aqR\~ "dh dv" \aq
+Draw a rule
+(solid black rectangle)
+with one corner at the drawing position,
+and the diagonally opposite corner at the drawing position
+.RI +( dh , dv ),
+which becomes the new drawing position afterward.
+.
+This command produces a rule in the DVI file and so can be printed even
+with a driver that does not support
+.I tpic
+specials,
+unlike the other
+.B \rsD
+commands.
+.
+.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-d
+Do not use
+.I tpic
+specials to implement drawing commands.
+.
+Horizontal and vertical lines are implemented by rules.
+.
+Other drawing commands are ignored.
+.
+.
+.TP
+.BI \-F\~ dir
+Prepend directory
+.RI dir /dev name
+to the search path for font and device description files;
+.I name
+is the name of the device,
+usually
+.BR dvi .
+.
+.
+.TP
+.B \-l
+Use landscape orientation rather than portrait.
+.
+.
+.TP
+.BI \-p\~ paper-format
+Set physical dimensions of output medium,
+overriding the
+.BR \%papersize ,
+.BR \%paperlength ,
+and
+.B \%paperwidth
+directives in the
+.I DESC
+file.
+.
+.I paper-format
+can be any argument accepted by the
+.B \%papersize
+directive;
+see
+.MR groff_font @MAN5EXT@ .
+.
+.
+.TP
+.BI \-w\~ n
+Draw rules (lines) with a thickness of
+.IR n \~thousandths
+of an em.
+.
+The default thickness is
+.B 40
+(0.04\~em).
+.
+.
+.\" ====================================================================
+.SH Environment
 .\" ====================================================================
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+lists directories in which to search for
+.IR devdvi ,
+.IR grodvi 's
+directory of device and font description files.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.MR groff_font @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devdvi/DESC
-Device description file.
+.I @FONTDIR@/\:\%devdvi/\:DESC
+describes the
+.B dvi
+output device.
+.
 .
 .TP
-.IR @FONTDIR@/devdvi/ F
-Font description file for font
-.IR F .
+.IR @FONTDIR@/\:\%devdvi/ F
+describes the font known
+.RI as\~ F
+on device
+.BR dvi .
+.
 .
 .TP
-.I @MACRODIR@/dvi.tmac
-Macros for use with
-.BR grodvi .
+.I @MACRODIR@/\:dvi\:.tmac
+defines font mappings,
+special characters,
+and colors for use with the
+.B dvi
+output device.
+.
+It is automatically loaded by
+.I \%troffrc
+when the
+.B dvi
+output device is selected.
+.
 .
 .TP
-.I @MACRODIR@/ec.tmac
-Macros to switch to EC fonts.
+.I @MACRODIR@/\:ec\:.tmac
+configures the
+.B dvi
+output device to use
+the EC and TC font families instead of CM
+(Computer Modern).
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
 .
-Dvi files produced by
-.B grodvi
-use a different resolution (57816 units per inch) from those produced by
-\*(tx.
+DVI files produced by
+.I grodvi
+use a different resolution
+(57,816 units per inch)
+from those produced by \*tx.
+.
+Incorrectly written drivers which assume the resolution used by \*tx,
+rather than using the resolution specified in the DVI file,
+will not work with
+.IR grodvi .
 .
-Incorrectly written drivers which assume the resolution used by \*(tx,
-rather than using the resolution specified in the DVI file will not
-work with
-.BR grodvi .
 .
 .LP
 When using the
@@ -449,28 +593,41 @@
 option with boxed tables,
 vertical and horizontal lines can sometimes protrude by one pixel.
 .
-This is a consequence of the way \*(tx requires that the heights
+This is a consequence of the way \*tx requires that the heights
 and widths of rules be rounded.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR tfmtodit (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@),
-.BR groff_tmac (@MAN5EXT@)
+.UR https://\:texfaq\:.org/\:FAQ\-\:ECfonts
+\lqWhat are the EC fonts?\rq
+.UE ;
+\*tx FAQ: Frequently Asked Question List for \*tx
+.
+.
+.P
+.MR tfmtodit @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_char @MAN7EXT@ ,
+.MR groff_tmac @MAN5EXT@
+.
 .
+.\" Clean up.
+.rm FT
+.rm tx
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngrodvi_C
+.cp \n*groff_grodvi_1_man_C
+.do rr *groff_grodvi_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grodvi/grodvi.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grodvi/grodvi.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/grohtml.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/grohtml.1.man Changed

@@ -1,13 +1,15 @@
-.TH GROHTML @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grohtml \- HTML driver for groff
+.TH grohtml @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grohtml, post\-grohtml, pre\-grohtml \-
+.I groff
+output driver for HTML
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1999-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1999-2022 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
@@ -25,236 +27,466 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grohtml_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
-.SY grohtml
-.OP \-bhlnprVy
-.OP \-a aa-text-bits
-.OP \-D dir
-.OP \-F dir
-.OP \-g aa-graphic-bits
-.OP \-i resolution
-.OP \-I image-stem
-.OP \-j filename
-.OP \-o image-vertical-offset
-.OP \-s size
-.OP \-S level
-.OP \-x html-dialect
-.RI  file
-\&.\|.\|.\&
+.SY pre\-grohtml
+.RB  \-epV 
+.RB  \-a
+.IR anti-aliasing-text-bits 
+.RB  \-D
+.IR image-directory 
+.RB  \-F
+.IR font-directory 
+.RB  \-g
+.IR anti-aliasing-graphic-bits 
+.RB  \-i
+.IR resolution 
+.RB  \-I
+.IR image-stem 
+.RB  \-o
+.IR image-vertical-offset 
+.RB  \-x
+.IR  html-dialect 
+.I troff-command
+.I troff-argument
+\&.\|.\|.
+.YS
+.
+.
+.SY pre\-grohtml
+.B \-\-help
+.YS
+.
+.
+.SY pre\-grohtml
+.B \-v
+.
+.SY pre\-grohtml
+.B \-\-version
+.YS
+.
+.
+.SY post\-grohtml
+.RB  \-bCGhlnrVy 
+.RB  \-F
+.IR font-directory 
+.RB  \-j
+.IR output-stem 
+.RB  \-s
+.IR base-point-size 
+.RB  \-S
+.IR heading-level 
+.RB  \-x
+.IR html-dialect 
+.RI  file\~ .\|.\|.
 .YS
 .
-.SY grohtml
+.
+.SY post\-grohtml
 .B \-\-help
 .YS
 .
-.SY grohtml
+.
+.SY post\-grohtml
 .B \-v
-.SY grohtml
+.
+.SY post\-grohtml
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The
-.B grohtml
-front end (which consists of a preprocessor,
-.BR pre-grohtml ,
-and a device driver,
-.BR post-grohtml )
-translates the output of GNU
-.B troff
-to HTML.
-.
-Users should always invoke
-.B grohtml
-via the groff command with a
+The GNU
+.I roff
+system's HTML support consists of a preprocessor,
+.IR \%pre\-grohtml ,
+and an output driver,
+.IR \%post\-grohtml ;
+together,
+they translate
+.MR roff @MAN7EXT@
+documents to HTML.
+.
+Because a preprocessor is (uniquely) required for this output driver,
+users should invoke
+.I \%grohtml
+via the
+.MR groff @MAN1EXT@
+command with the
 .B \-Thtml
-option.
+or
+.B \-Txhtml
+options.
 .
-If no files are given,
-.B grohtml
-will read the standard input.
-.
-A filename of
-.B \-
-will also cause
-.B grohtml
-to read the standard input.
-.
-Html output is written to the standard output.
-.
-When
-.B grohtml
-is run by
-.B groff
-options can be passed to
-.B grohtml
-using
-.BR groff 's
+(In this installation,
+.B @DEVICE@
+is the default output device.)
+.
+Use
+.IR groff 's
 .B \-P
-option.
+option to pass any options shown above to
+.IR \%grohtml .
 .
+If no operands are given,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I \%grohtml
+reads the standard input stream.
 .
-.PP
-.B grohtml
+Output is written to the standard output stream.
+.
+.
+.P
+.I \%grohtml
 invokes
-.B groff
+.I groff
 twice.
-In the first pass, pictures, equations, and tables are rendered
-using the
+.
+In the first pass,
+the preprocessor
+.I \%pre\-grohtml
+renders
+pictures,
+equations,
+and tables as images in PostScript format using the
 .B ps
-device, and in the second pass HTML output is generated by the
-.B html
-device.
+output device.
 .
+In the second pass,
+the output driver
+.I \%post\-grohtml
+translates the output of
+.MR @g@troff @MAN1EXT@
+to HTML.
 .
-.PP
-.B grohtml
-always writes output in \%UTF-8 encoding and has built-in entities for
-all non-composite unicode characters.
 .
-In spite of this, groff may issue warnings about unknown special
-characters if they can't be found during the first pass.
+.P
+.I \%grohtml
+writes output encoded in \%UTF-8 and has built-in HTML entities for all
+non-composite Unicode characters.
+.
+In spite of this,
+.I groff
+may issue warnings about unknown special characters if they can't be
+found during the first pass.
 .
 Such warnings can be safely ignored unless the special characters
 appear inside a table or equation.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SS Typefaces
 .\" ====================================================================
 .
+.I \%grohtml
+supports the standard four styles:
+.B R
+(roman),
+.B I
+.RI ( italic ),
+.B B
+.RB ( bold ),
+and
+.B BI
+(\fBIbold-italic\f).
+.
+Fonts are grouped into families
+.B T
+and
+.B C
+having members in each style.
+.
+.
+.RS
 .TP
-.BI \-a aa-text-bits
-Number of bits of antialiasing information to be used by
-.I text
-when generating PNG images.
+.B TR
+Times roman
 .
-The default is\~4 but valid values are 0, 1, 2, and\~4.
+.TQ
+.B TI
+Times italic
 .
-Note your version of
-.B gs
-needs to support the
-.B \%\-dTextAlphaBits
+.TQ
+.B TB
+Times bold
+.
+.TQ
+.B TBI
+Times bold-italic
+.
+.TQ
+.B CR
+Courier roman
+.
+.TQ
+.B CI
+Courier italic
+.
+.TQ
+.B CB
+Courier bold
+.
+.TQ
+.B CBI
+Courier bold-italic
+.RE
+.
+.
+.P
+A special font,
+.BR S ,
+is also provided to accommodate
+.I roff
+documents that expect it to always be available.
+.
+.
+.\" ====================================================================
+.SS "Font description files"
+.\" ====================================================================
+.
+The font description files used with
+.I \%grohtml
+expose the same glyph repertoire in their
+.B charset
+sections.
+.
+See
+.MR groff_font @MAN5EXT@ .
+.
+.
+.\" ====================================================================
+.SS Dependencies
+.\" ====================================================================
+.
+.I \%pre\-grohtml
+generates an image whenever an
+.I @g@eqn
+equation,
+.I @g@tbl
+table,
+or
+.I @g@pic
+picture is encountered in the input.
+.
+.I \%grohtml
+therefore may run several commands as part of its operation.
+.
+These include the \%Netpbm tools
+.IR \%pnmcrop ,
+.IR \%pnmcut ,
 and
-.B \%\-dGraphicAlphaBits
-options in order to exploit antialiasing.
+.IR \%pnmtopng ;
+\%Ghostscript
+.RI ( gs );
+and the \%PSUtils tool
+.IR \%psselect .
+.
+.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.BI \-a \~anti-aliasing-text-bits
+Number of bits of antialiasing information to be used by text when
+generating PNG images.
+.
+The default
+.RB is\~ 4
+but
+.BR 0 ,
+.BR 1 ,
+and
+.B 2
+are also valid.
+.
+Your system's version of
+.I gs
+must support the
+.B \%\-dTextAlphaBits
+option in order to exploit antialiasing.
+.\" XXX: How antiquated are the ones that don't?  Get rid of this?
 .
-A value of\~0 stops
-.B grohtml
+A value
+.RB of\~ 0
+stops
+.I \%grohtml
 from issuing antialiasing commands to
-.BR gs .
+.IR gs .
+.
 .
 .TP
 .B \-b
 Initialize the background color to white.
 .
+.
+.TP
+.B \-C
+Suppress output of \lqCreationDate:\rq HTML comment.
+.
+.
 .TP
-.BI \-D dir
-Inform
-.B grohtml
+.BI \-D \~image-directory
+Instruct
+.I \%grohtml
 to place all image files into directory
-.IR dir .
+.IR image-directory .
+.
 .
 .TP
 .B \-e
-This option should not be directly invoked by the user as it is an
-internal option utilized by
-.B groff
-when
+Direct
+.I @g@eqn
+to produce MathML.
+.
+.
+.IP
+This option should not be manually specified;
+it is synthesized by
+.I groff
+depending on whether it was given the
 .B \-Thtml
 or
 .B \-Txhtml
-is specified.
-It is used by the
-.B grohtml
-preprocessor to determine whether
-.B eqn
-should attempt to produce MathML (if
-.B \-Txhtml
-is specified).
+option.
+.
 .
 .TP
-.BI \-F dir
+.BI \-F \~font-directory
 Prepend directory
-.RI dir /dev name
+.RI font-directory /dev name
 to the search path for font and device description files;
 .I name
-is the name of the device, usually
+is the name of the device,
+usually
 .BR html .
 .
-.TP
-.BI \-g aa-graphic-bits
-Number of bits of antialiasing information to be used by
-.I graphics
-when generating PNG images.
-.
-The default is\~4 but valid values are 0, 1, 2, and\~4.
 .
-Note your version of
-.B gs
-needs to support the
-.B \%\-dTextAlphaBits
+.TP
+.BI \-g \~anti-aliasing-graphic-bits
+Number of bits of antialiasing information to be used by graphics when
+generating PNG images.
+.
+The default
+.RB is\~ 4
+but
+.BR 0 ,
+.BR 1 ,
 and
+.B 2
+are also valid.
+.
+Your system's version of
+.I gs
+must support the
 .B \%\-dGraphicAlphaBits
-options in order to exploit antialiasing.
+option in order to exploit antialiasing.
+.\" XXX: How antiquated are the ones that don't?  Get rid of this?
 .
-A value of\~0 stops
-.B grohtml
+A value
+.RB of\~ 0
+stops
+.I \%grohtml
 from issuing antialiasing commands to
-.BR gs .
+.IR gs .
 .
-.TP
-.B \-h
-Generate section and number headings by using
-.BR <B> .\|.\|. </B>
-and increasing the font size, rather than using the
-.BI <H n >\c
-\&.\|.\|.\c
-.BI </H n >
-tags.
 .
 .TP
-.BI \-i resolution
-Select the resolution for all images.
+.B \-G
+Suppress output of \lqCreator:\rq HTML comment.
 .
-By default this is 100 pixels per inch.
 .
-Example:
-.B \-i200
-indicates 200 pixels per inch.
+.TP
+.B \-h
+Generate section headings by using HTML
+.B B
+elements and increasing the font size,
+rather than HTML
+.B H
+elements.
+.
 .
 .TP
-.BI \-I stem
-Determine the image stem name.
+.BI \-i \~resolution
+Set the image resolution in pixels per inch;
+the default
+.RB is\~ 100 .
+.
 .
-If omitted grohtml uses
-.BI \%grohtml- XXX
-.RI ( XXX
+.TP
+.BI \-I \~image-stem
+Determine the image file name stem.
+.
+If omitted,
+.I \%grohtml
+uses
+.IR \%grohtml\- XXXXX
+(where
+.I XXXXX
 is the process ID).
 .
+A dash is appended to the stem to separate it from the following image
+number.
+.
+.
 .TP
-.BI \-j filename
-Inform
-.B grohtml
+.BI \-j \~output-stem
+Instruct
+.I \%grohtml
 to split the HTML output into multiple files.
 .
-The
-.I filename
-is the stem and specified section headings (default is level one)
-start a new file, named
-.IR filename-n.html .
+Output is written to a new file at each section heading
+(but see option
+.B \-S
+below)
+named
+.IR output-stem\- n .html .
+.
 .
 .TP
 .B \-l
 Turn off the production of automatic section links at the top of the
 document.
 .
+.
 .TP
 .B \-n
 Generate simple heading anchors whenever a section/number heading is
@@ -262,185 +494,238 @@
 .
 Without the option the anchor value is the textual heading.
 .
-This can cause problems when a heading contains a \(oq?\(cqa on older
-versions of some browsers (Netscape).
+This can cause problems when a heading contains a \lq?\rq on older
+versions of some browsers.
+.
+This feature is automatically enabled if a heading contains an image.
 .
-This flag is automatically turned on if a heading contains an image.
 .
 .TP
-.BI \-o vertical-offset
+.BI \-o \~image-vertical-offset
 Specify the vertical offset of images in points.
 .
+.
 .TP
 .B \-p
-Display page rendering progress to stderr.
-.B grohtml
-only displays a page number when an image is required.
+Display page rendering progress to the standard error stream.
+.
+.I \%grohtml
+displays a page number only when an image is required.
+.
 .
 .TP
 .B \-r
-Turn off the automatic header and footer line (HTML rule).
+Turn off the automatic header and footer line
+(HTML rule).
+.
 .
 .TP
-.B \-s size
-Set the base point size of the source file.
+.BI \-s \~base-type-size
+Set the document's base type size in points.
 .
-Thereafter when this point size is used in the source it will
-correspond to the HTML base size.
+When this size is used in the source,
+it corresponds to the HTML base type size.
 .
-Every increase of two points in the source will yield a
-.B <big>
-tag, and conversely when a decrease of two points is seen a
-.B <small>
-tag is emitted.
+Every increase of two points in the source will produce a
+.RB \lq big \rq
+element,
+and conversely when a decrease of two points is seen,
+a
+.RB \lq small \rq
+element is emitted.
 .
-.TP
-.BI \-S level
-When splitting HTML output,
-split at the heading level (or higher) defined by
-.IR level .
 .
 .TP
-.B \-v
-Print the version number.
+.BI \-S \~heading-level
+When splitting HTML output
+(see option
+.B \-j
+above),
+split at each nested heading level defined by
+.IR heading-level ,
+or higher).
+.
+The default is
+.BR 1 .
+.
 .
 .TP
 .B \-V
 Create an XHTML or HTML validator button at the bottom of each page of
 the document.
 .
+.
 .TP
-.BI \-x dialect
+.BI \-x \~html-dialect
 Select HTML dialect.
 .
 Currently,
-.I dialect
-should be either the digit\~\c
-.B 4
-or the letter\~\c
-.B x
+.I html-dialect
+should be either the
+.RB digit\~ 4
+or the
+.RB letter\~ x ,
 which indicates whether
-.B grohtml
-should generate HTML\~4 or XHTML, respectively.
+.I \%grohtml
+should generate HTML\~4 or XHTML,
+respectively.
+.
 .
-This option should not be directly invoked by the user as it is
-an internal option utilized by
-.B groff
-when
+.IP
+This option should not be manually specified;
+it is synthesized by
+.I groff
+depending on whether it was given the
 .B \-Thtml
 or
 .B \-Txhtml
-is specified.
+option.
+.
 .
 .TP
 .B \-y
-Produce a right-justified groff signature at the end of the document.
-.
-This is only generated if the
+Produce a right-aligned
+.I groff
+signature at the end of the document
+(only if
 .B \-V
-flag is also specified.
+is also specified).
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Environment
 .\" ====================================================================
 .
-There are styles called
-.BR R ,
-.BR I ,
-.BR B ,
-and
-.B BI
-mounted at font positions 1 to\~4.
+.TP
+.I GROFF_FONT_PATH
+lists directories in which to search for
+.IR devhtml ,
+.IR grohtml 's
+directory of device and font description files.
 .
+See
+.MR @g@troff @MAN1EXT@
+and
+.MR groff_font @MAN5EXT@ .
 .
-.\" ====================================================================
-.SH DEPENDENCIES
-.\" ====================================================================
 .
-.B grohtml
-is dependent upon the PNG utilities
-.RB ( \%pnmcut ,
-.BR \%pnmcrop ,
-.BR \%pnmtopng )
-and GhostScript
-.RB ( gs ).
+.TP
+.I SOURCE_DATE_EPOCH
+A timestamp
+(expressed as seconds since the Unix epoch)
+to use as the output creation timestamp in place of the current time.
 .
-.B \%pnmtopng
-(version 2.37.6 or greater)
-and
-.B \%pnmcut
-from the netpbm package (version 9.16 or greater) will work also.
+The time is converted to human-readable form using
+.MR ctime 3
+and recorded in an HTML comment.
 .
-It is also dependent upon
-.B \%psselect
-from the
-.B PSUtils
-package.
 .
-Images are generated whenever a table, picture, equation or line is
-encountered.
+.TP
+.I TZ
+The time zone to use when converting the current time
+(or value of
+.IR SOURCE_DATE_EPOCH )
+to human-readable form;
+see
+.MR tzset 3 .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
-.B grohtml
-uses temporary files.
+.TP
+.I @FONTDIR@/\:\%devhtml/\:DESC
+describes the
+.B html
+output device.
 .
-See the
-.BR groff (@MAN1EXT@)
-man page for details where such files are created.
 .
+.TP
+.IR @FONTDIR@/\:\%devhtml/ F
+describes the font known
+.RI as\~ F
+on device
+.BR html .
 .
-.\" ====================================================================
-.SH ENVIRONMENT
-.\" ====================================================================
 .
 .TP
-.I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+.I @MACRODIR@/\:html\:.tmac
+defines font mappings,
+special characters,
+and colors for use with the
+.B html
+output device.
 .
-See
-.BR @g@troff (@MAN1EXT@)
-and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+It is automatically loaded by
+.I \%troffrc
+when either of the
+.B html
+or
+.B xhtml
+output devices is selected.
 .
 .
 .TP
-.I SOURCE_DATE_EPOCH
-A timestamp (expressed as seconds since the Unix epoch) to use as the
-creation timestamp in place of the current time.
+.I @MACRODIR@/\:html\-end\:.tmac
+finalizes setup of the
+.B html
+output device.
+.
+It is automatically loaded by
+.I \%troffrc\-end
+when either of the
+.B html
+or
+.B xhtml
+output devices is selected.
+.
+.
+.P
+.I \%grohtml
+uses temporary files.
+.
+See
+.MR groff @MAN1EXT@
+for details about where such files are created.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
 .
-.B Grohtml
-has been completely redesigned and rewritten.
+.I \%grohtml
+is still beta code.
+.
 .
-It is still beta code.
+.PP
+.I \%grohtml
+does not truly support hyphenation,
+but you can fool it into hyphenating long input lines,
+which can appear in HTML output with a hyphenated word followed by a
+space but no line break.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR afmtodit (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR psbb (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@)
+.\" IR afmtodit (@MAN1EXT@),
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.\" IR psbb (1), \" XXX: what is this?
+.\" IR groff_out (@MAN5EXT@),
+.\" IR groff_char (@MAN7EXT@),
+.MR groff_font @MAN5EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_grohtml_1_man_C
+.do rr *groff_grohtml_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/grohtml.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/grohtml.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/html-table.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/html-table.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/html-table.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/html-table.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/html-text.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/html-text.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/html-text.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/html-text.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/html.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/html.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/output.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/output.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grohtml/post-html.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grohtml/post-html.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 2000-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2000-2020 Free Software Foundation, Inc.
  *
  *  Gaius Mulley (gaius@glam.ac.uk) wrote post-html.cpp
  *  but it owes a huge amount of ideas and raw code from
@@ -49,13 +48,13 @@
 #   define FALSE (1==0)
 #endif
 
-#define MAX_LINE_LENGTH                60            /* maximum characters we want in a line      */
-#define SIZE_INCREMENT                  2            /* font size increment <big> = +2            */
-#define CENTER_TOLERANCE                2            /* how many pixels off center do we allow    */
-#define ANCHOR_TEMPLATE         "heading"            /* if simple anchor is set we use this       */
-#define UNICODE_DESC_START           0x80            /* all character entities above this are     */
-                                                     /* either encoded by their glyph names or if */
-                                                     /* there is no name then we use &#nnn;       */
+#define MAX_LINE_LENGTH    60        /* maximum characters we want in a line      */
+#define SIZE_INCREMENT     2         /* font size increment <big> = +2            */
+#define CENTER_TOLERANCE   2         /* how many pixels off center do we allow    */
+#define ANCHOR_TEMPLATE    "heading" /* if simple anchor is set we use this       */
+#define UNICODE_DESC_START 0x80      /* all character entities above this are     */
+                                     /* either encoded by their glyph names or if */
+                                     /* there is no name then we use &#nnn;       */
 typedef enum {CENTERED, LEFT, RIGHT, INLINE} TAG_ALIGNMENT;
 typedef enum {col_tag, tab_tag, tab0_tag, none} colType;
 
@@ -71,28 +70,30 @@
 int char_translate_to_html (font *f, char *buf, int buflen, unsigned char ch, int b, int and_single);
 
 
-static int auto_links = TRUE;                        /* by default we enable automatic links at  */
-                                                     /* top of the document.                     */
-static int auto_rule  = TRUE;                        /* by default we enable an automatic rule   */
-                                                     /* at the top and bottom of the document    */
-static int simple_anchors = FALSE;                   /* default to anchors with heading text     */
-static int manufacture_headings = FALSE;             /* default is to use the Hn html headings,  */
-                                                     /* rather than manufacture our own.         */
-static color *default_background = NULL;             /* has user requested initial bg color?     */
-static string job_name;                              /* if set then the output is split into     */
-                                                     /* multiple files with 'job_name'-%d.html   */
-static int multiple_files = FALSE;                   /* must we the output be divided into       */
-                                                     /* multiple html files, one for each        */
-                                                     /* heading?                                 */
-static int base_point_size = 0;                      /* which troff font size maps onto html     */
-                                                     /* size 3?                                  */
-static int split_level = 2;                          /* what heading level to split at?          */
-static string head_info;                             /* user supplied information to be placed   */
-                                                     /* into <head> </head>                      */
-static int valid_flag = FALSE;                       /* has user requested a valid flag at the   */
-                                                     /* end of each page?                        */
-static int groff_sig = FALSE;                        /* "This document was produced using"       */
-html_dialect dialect = html4;                        /* which html dialect should grohtml output */
+static int auto_links = TRUE;               /* by default we enable automatic links at  */
+                                            /* top of the document.                     */
+static int auto_rule  = TRUE;               /* by default we enable an automatic rule   */
+                                            /* at the top and bottom of the document    */
+static int simple_anchors = FALSE;          /* default to anchors with heading text     */
+static int manufacture_headings = FALSE;    /* default is to use the Hn html headings,  */
+                                            /* rather than manufacture our own.         */
+static int do_write_creator_comment = TRUE; /* write Creator HTML comment               */
+static int do_write_date_comment = TRUE;    /* write CreationDate HTML comment          */
+static color *default_background = 0;       /* has user requested initial bg color?     */
+static string job_name;                     /* if set then the output is split into     */
+                                            /* multiple files with 'job_name'-%d.html   */
+static int multiple_files = FALSE;          /* must we the output be divided into       */
+                                            /* multiple html files, one for each        */
+                                            /* heading?                                 */
+static int base_point_size = 0;             /* which troff font size maps onto html     */
+                                            /* size 3?                                  */
+static int split_level = 2;                 /* what heading level to split at?          */
+static string head_info;                    /* user supplied information to be placed   */
+                                            /* into <head> </head>                      */
+static int valid_flag = FALSE;              /* has user requested a valid flag at the   */
+                                            /* end of each page?                        */
+static int groff_sig = FALSE;               /* "This document was produced using"       */
+html_dialect dialect = html4;               /* which html dialect should grohtml output */
 
 
 /*
@@ -118,7 +119,8 @@
 }
 
 /*
- *  is_intersection - returns TRUE if range a1..a2 intersects with b1..b2
+ *  is_intersection - returns TRUE if range a1..a2 intersects with
+ *                    b1..b2
  */
 
 static int is_intersection (int a1, int a2, int b1, int b2)
@@ -151,11 +153,11 @@
 };
 
 /*
- *  file - initialize all fields to NULL
+ *  file - initialize all fields to null pointers
  */
 
 file::file (FILE *f)
-  : fp(f), next(NULL), new_output_file(FALSE),
+  : fp(f), next(0), new_output_file(FALSE),
     require_links(FALSE), output_file_name("")
 {
 }
@@ -184,7 +186,7 @@
  */
 
 files::files ()
-  : head(NULL), tail(NULL), ptr(NULL)
+  : head(0), tail(0), ptr(0)
 {
 }
 
@@ -197,7 +199,7 @@
   if (ptr)
     return ptr->fp;
   else
-    return NULL;
+    return 0;
 }
 
 /*
@@ -215,7 +217,7 @@
 
 void files::move_next (void)
 {
-  if (ptr != NULL)
+  if (ptr != 0)
     ptr = ptr->next;
 }
 
@@ -225,7 +227,7 @@
 
 void files::add_new_file (FILE *f)
 {
-  if (head == NULL) {
+  if (0 /* nullptr */ == head) {
     head = new file(f);
     tail = head;
   } else {
@@ -242,7 +244,7 @@
 
 void files::set_file_name (string name)
 {
-  if (ptr != NULL) {
+  if (ptr != 0) {
     ptr->output_file_name = name;
     ptr->new_output_file = TRUE;
   }
@@ -255,7 +257,7 @@
 
 void files::set_links_required (void)
 {
-  if (ptr != NULL)
+  if (ptr != 0)
     ptr->require_links = TRUE;
 }
 
@@ -266,7 +268,7 @@
 
 int files::are_links_required (void)
 {
-  if (ptr != NULL)
+  if (ptr != 0)
     return ptr->require_links;
   return FALSE;
 }
@@ -278,7 +280,7 @@
 
 int files::is_new_output_file (void)
 {
-  if (ptr != NULL)
+  if (ptr != 0)
     return ptr->new_output_file;
   return FALSE;
 }
@@ -289,7 +291,7 @@
 
 string files::file_name (void)
 {
-  if (ptr != NULL)
+  if (ptr != 0)
     return ptr->output_file_name;
   return string("");
 }
@@ -300,7 +302,7 @@
 
 string files::next_file_name (void)
 {
-  if (ptr != NULL && ptr->next != NULL)
+  if (ptr != 0 && ptr->next != 0)
     return ptr->next->output_file_name;
   return string("");
 }
@@ -323,7 +325,7 @@
 };
 
 style::style()
-  : f(NULL)
+  : f(0), point_size(-1)
 {
 }
 
@@ -359,22 +361,22 @@
 };
 
 char_block::char_block()
-: buffer(NULL), used(0), next(NULL)
+: buffer(0), used(0), next(0)
 {
 }
 
 char_block::char_block(int length)
-: used(0), next(NULL)
+: used(0), next(0)
 {
   buffer = new charmax(length, char_block::SIZE);
-  if (buffer == NULL)
+  if (0 /* nullptr */ == buffer)
     fatal("out of memory error");
 }
 
 char_block::~char_block()
 {
-  if (buffer != NULL)
-    a_delete buffer;
+  if (buffer != 0)
+    delete buffer;
 }
 
 class char_buffer {
@@ -389,13 +391,13 @@
 };
 
 char_buffer::char_buffer()
-: head(NULL), tail(NULL)
+: head(0), tail(0)
 {
 }
 
 char_buffer::~char_buffer()
 {
-  while (head != NULL) {
+  while (head != 0) {
     char_block *temp = head;
     head = head->next;
     delete temp;
@@ -404,13 +406,13 @@
 
 char *char_buffer::add_string (const char *s, unsigned int length)
 {
-  int i=0;
+  int i = 0;
   unsigned int old_used;
 
-  if (s == NULL || length == 0)
-    return NULL;
+  if (0 /* nullptr */ == s|| length == 0)
+    return 0;
 
-  if (tail == NULL) {
+  if (0 /* nullptr */ == tail) {
     tail = new char_block(length+1);
     head = tail;
   } else {
@@ -465,7 +467,7 @@
   void text_glob_tag       (style *s, char *str, int length,
 			    int min_vertical, int min_horizontal,
 			    int max_vertical, int max_horizontal);
-		       
+
   text_glob                (void);
   ~text_glob               (void);
   int  is_a_line           (void);
@@ -523,21 +525,23 @@
 		      bool is_auto_image, bool is_special_command,
 		      bool is_a_line_flag, int line_thickness)
   : text_style(*s), text_string(str), text_length(length),
-    minv(min_vertical), minh(min_horizontal), maxv(max_vertical), maxh(max_horizontal),
-    is_tag(is_troff_command), is_img_auto(is_auto_image), is_special(is_special_command),
-    is_line(is_a_line_flag), thickness(line_thickness), tab(NULL)
+    minv(min_vertical), minh(min_horizontal), maxv(max_vertical),
+    maxh(max_horizontal), is_tag(is_troff_command),
+    is_img_auto(is_auto_image), is_special(is_special_command),
+    is_line(is_a_line_flag), thickness(line_thickness), tab(0)
 {
 }
 
 text_glob::text_glob ()
-  : text_string(NULL), text_length(0), minv(-1), minh(-1), maxv(-1), maxh(-1),
-    is_tag(FALSE), is_special(FALSE), is_line(FALSE), thickness(0), tab(NULL)
+  : text_string(0), text_length(0), minv(-1), minh(-1), maxv(-1),
+    maxh(-1), is_tag(FALSE), is_special(FALSE), is_line(FALSE),
+    thickness(0), tab(0)
 {
 }
 
 text_glob::~text_glob ()
 {
-  if (tab != NULL)
+  if (tab != 0)
     delete tab;
 }
 
@@ -550,7 +554,8 @@
 				int max_vertical , int max_horizontal)
 {
   text_glob *g = new text_glob(s, str, length,
-			       min_vertical, min_horizontal, max_vertical, max_horizontal,
+			       min_vertical, min_horizontal,
+			       max_vertical, max_horizontal,
 			       FALSE, FALSE, FALSE, FALSE, 0);
   *this = *g;
   delete g;
@@ -558,17 +563,19 @@
 
 /*
  *  text_glob_html - used to place html specials into the glob buffer.
- *                   This text is essentially html commands coming through
- *                   from the macro sets, with special designated sequences of
- *                   characters translated into html. See add_and_encode.
+ *                   This text is essentially html commands coming
+ *                   through from the macro sets, with special
+ *                   designated sequences of characters translated into
+ *                   html. See add_and_encode.
  */
 
 void text_glob::text_glob_special (style *s, char *str, int length,
-				   int min_vertical , int min_horizontal,
-				   int max_vertical , int max_horizontal)
+				   int min_vertical, int min_horizontal,
+				   int max_vertical, int max_horizontal)
 {
   text_glob *g = new text_glob(s, str, length,
-			       min_vertical, min_horizontal, max_vertical, max_horizontal,
+			       min_vertical, min_horizontal,
+			       max_vertical, max_horizontal,
 			       FALSE, FALSE, TRUE, FALSE, 0);
   *this = *g;
   delete g;
@@ -579,22 +586,25 @@
  */
 
 void text_glob::text_glob_line (style *s,
-				int min_vertical , int min_horizontal,
-				int max_vertical , int max_horizontal,
+				int min_vertical, int min_horizontal,
+				int max_vertical, int max_horizontal,
 				int thickness_value)
 {
   text_glob *g = new text_glob(s, "", 0,
-			       min_vertical, min_horizontal, max_vertical, max_horizontal,
-			       FALSE, FALSE, FALSE, TRUE, thickness_value);
+			       min_vertical, min_horizontal,
+			       max_vertical, max_horizontal,
+			       FALSE, FALSE, FALSE, TRUE,
+			       thickness_value);
   *this = *g;
   delete g;
 }
 
 /*
- *  text_glob_auto_image - record the presence of a .auto-image tag command.
- *                         Used to mark that an image has been created automatically
- *                         by a preprocessor and (pre-grohtml/troff) combination.
- *                         Under some circumstances images may not be created.
+ *  text_glob_auto_image - record the presence of a .auto-image tag
+ *                         command.  Used to mark that an image has been
+ *                         created automatically by a preprocessor and
+ *                         (pre-grohtml/troff) combination.  Under some
+ *                         circumstances images may not be created.
  *                         (consider .EQ
  *                                   delim $$
  *                                   .EN
@@ -603,22 +613,25 @@
  *                                   l!l.
  *                                   $1 over x$!recripical of x
  *                                   .TE
- *
- *                          the first auto-image marker is created via .EQ/.EN pair
- *                          and no image is created.
- *                          The second auto-image marker occurs at $1 over x$
- *                          Currently this image will not be created
- *                          as the whole of the table is created as an image.
- *                          (Once html tables are handled by grohtml this will change.
- *                           Shortly this will be the case).
+ *                          the first auto-image marker is created via
+ *                          .EQ/.EN pair and no image is created.  The
+ *                          second auto-image marker occurs at $1 over
+ *                          x$ Currently this image will not be created
+ *                          as the whole of the table is created as an
+ *                          image.  (Once html tables are handled by
+ *                          grohtml this will change.  Shortly this will
+ *                          be the case).
  */
 
 void text_glob::text_glob_auto_image(style *s, char *str, int length,
-				     int min_vertical, int min_horizontal,
-				     int max_vertical, int max_horizontal)
+				     int min_vertical,
+				     int min_horizontal,
+				     int max_vertical,
+				     int max_horizontal)
 {
   text_glob *g = new text_glob(s, str, length,
-			       min_vertical, min_horizontal, max_vertical, max_horizontal,
+			       min_vertical, min_horizontal,
+			       max_vertical, max_horizontal,
 			       TRUE, TRUE, FALSE, FALSE, 0);
   *this = *g;
   delete g;
@@ -633,7 +646,8 @@
 			       int max_vertical, int max_horizontal)
 {
   text_glob *g = new text_glob(s, str, length,
-			       min_vertical, min_horizontal, max_vertical, max_horizontal,
+			       min_vertical, min_horizontal,
+			       max_vertical, max_horizontal,
 			       TRUE, FALSE, FALSE, FALSE, 0);
   *this = *g;
   delete g;
@@ -710,9 +724,9 @@
 
 int text_glob::is_fi (void)
 {
-  return( is_tag && (strncmp(text_string, "devtag:.fi",
+  return (is_tag && (strncmp(text_string, "devtag:.fi",
 			     strlen("devtag:.fi")) == 0) &&
-	  (get_arg() == 1) );
+	  (get_arg() == 1));
 }
 
 /*
@@ -905,7 +919,7 @@
 
 void text_glob::remember_table (html_table *t)
 {
-  if (tab != NULL)
+  if (tab != 0)
     delete tab;
   tab = t;
 }
@@ -943,12 +957,14 @@
 };
 
 element_list::element_list ()
-  : right(0), left(0), datum(0), lineno(0), minv(-1), minh(-1), maxv(-1), maxh(-1)
+  : right(0), left(0), datum(0), lineno(0), minv(-1), minh(-1),
+    maxv(-1), maxh(-1)
 {
 }
 
 /*
- *  element_list - create a list element assigning the datum and region parameters.
+ *  element_list - create a list element assigning the datum and region
+ *                 parameters.
  */
 
 element_list::element_list (text_glob *in,
@@ -956,13 +972,14 @@
 			    int min_vertical, int min_horizontal,
 			    int max_vertical, int max_horizontal)
   : right(0), left(0), datum(in), lineno(line_number),
-    minv(min_vertical), minh(min_horizontal), maxv(max_vertical), maxh(max_horizontal)
+    minv(min_vertical), minh(min_horizontal),
+    maxv(max_vertical), maxh(max_horizontal)
 {
 }
 
 element_list::~element_list ()
 {
-  if (datum != NULL)
+  if (datum != 0)
     delete datum;
 }
 
@@ -972,9 +989,9 @@
       ~list             ();
   int  is_less          (element_list *a, element_list *b);
   void add              (text_glob *in,
-		         int line_number,
-		         int min_vertical, int min_horizontal,
-		         int max_vertical, int max_horizontal);
+			 int line_number,
+			 int min_vertical, int min_horizontal,
+			 int max_vertical, int max_horizontal);
   void                  sub_move_right      (void);
   void                  move_right          (void);
   void                  move_left           (void);
@@ -999,7 +1016,7 @@
  */
 
 list::list ()
-  : head(NULL), tail(NULL), ptr(NULL)
+  : head(0), tail(0), ptr(0)
 {
 }
 
@@ -1013,11 +1030,11 @@
 
   do {
     temp = head;
-    if (temp != NULL) {
+    if (temp != 0) {
       head = head->right;
       delete temp;
     }
-  } while ((head != NULL) && (head != tail));
+  } while ((head != 0) && (head != tail));
 }
 
 /*
@@ -1027,15 +1044,16 @@
 
 int list::is_less (element_list *a, element_list *b)
 {
-  // was if (is_intersection(a->minv+1, a->maxv-1, b->minv+1, b->maxv-1)) {
+  // was:
+  // if (is_intersection(a->minv+1, a->maxv-1, b->minv+1, b->maxv-1)) {
   if (a->lineno < b->lineno) {
-    return( TRUE );
+    return  TRUE;
   } else if (a->lineno > b->lineno) {
-    return( FALSE );
+    return  FALSE;
   } else if (is_intersection(a->minv, a->maxv, b->minv, b->maxv)) {
-    return( a->minh < b->minh );
+    return (a->minh < b->minh);
   } else {
-    return( a->maxv < b->maxv );
+    return (a->maxv < b->maxv);
   }
 }
 
@@ -1044,19 +1062,25 @@
  *        region position.
  */
 
-void list::add (text_glob *in, int line_number, int min_vertical, int min_horizontal, int max_vertical, int max_horizontal)
+void list::add (text_glob *in, int line_number,
+		int min_vertical, int min_horizontal,
+		int max_vertical, int max_horizontal)
 {
-  // create a new list element with datum and position fields initialized
-  element_list *t    = new element_list(in, line_number, min_vertical, min_horizontal, max_vertical, max_horizontal);
+  // create a new list element with datum and position fields
+  // initialized
+  element_list *t    = new element_list(in, line_number,
+					min_vertical, min_horizontal,
+					max_vertical, max_horizontal);
   element_list *last;
 
 #if 0
   fprintf(stderr, "%s %d,%d,%d,%d ",
-	  in->text_string, min_vertical, min_horizontal, max_vertical, max_horizontal);
+	  in->text_string, min_vertical, min_horizontal,
+	  max_vertical, max_horizontal);
   fflush(stderr);
 #endif
 
-  if (head == NULL) {
+  if (0 /* nullptr */ == head) {
     head     = t;
     tail     = t;
     ptr      = t;
@@ -1090,8 +1114,8 @@
 }
 
 /*
- *  sub_move_right - removes the element which is currently pointed to by ptr
- *                   from the list and moves ptr to the right.
+ *  sub_move_right - removes the element which is currently pointed to
+ *                   by ptr from the list and moves ptr to the right.
  */
 
 void list::sub_move_right (void)
@@ -1099,12 +1123,12 @@
   element_list *t=ptr->right;
 
   if (head == tail) {
-    head = NULL;
-    if (tail != NULL)
+    head = 0;
+    if (tail != 0)
       delete tail;
-    
-    tail = NULL;
-    ptr  = NULL;
+
+    tail = 0;
+    ptr  = 0;
   } else {
     if (head == ptr)
       head = head->right;
@@ -1140,7 +1164,7 @@
 
 int list::is_empty (void)
 {
-  return head == NULL;
+  return 0 /* nullptr */ == head;
 }
 
 /*
@@ -1197,7 +1221,7 @@
 {
   ptr = ptr->right;
   if (ptr == head)
-    return NULL;
+    return 0;
   else
     return ptr->datum;
 }
@@ -1211,7 +1235,7 @@
 {
   ptr = ptr->left;
   if (ptr == tail)
-    return NULL;
+    return 0;
   else
     return ptr->datum;
 }
@@ -1225,10 +1249,12 @@
   if (is_empty())
     fatal("list must not be empty if we are inserting data");
   else {
-    if (ptr == NULL)
+    if (0 /* nullptr */ == ptr)
       ptr = head;
-    
-    element_list *t = new element_list(in, ptr->lineno, ptr->minv, ptr->minh, ptr->maxv, ptr->maxh);
+
+    element_list *t = new element_list(in, ptr->lineno,
+				       ptr->minv, ptr->minh,
+				       ptr->maxv, ptr->maxh);
     if (ptr == tail)
       tail = t;
     ptr->right->left = t;
@@ -1239,8 +1265,9 @@
 }
 
 /*
- *  move_to - moves the current position to the point where data, in, exists.
- *            This is an expensive method and should be used sparingly.
+ *  move_to - moves the current position to the point where data, in,
+ *            exists.  This is an expensive method and should be used
+ *            sparingly.
  */
 
 void list::move_to (text_glob *in)
@@ -1256,31 +1283,31 @@
 
 class page {
 public:
-                              page            (void);
-  void                        add             (style *s, const string &str,
-					       int line_number,
-					       int min_vertical, int min_horizontal,
-					       int max_vertical, int max_horizontal);
-  void                        add_tag         (style *s, const string &str,
-					       int line_number,
-					       int min_vertical, int min_horizontal,
-					       int max_vertical, int max_horizontal);
-  void                        add_and_encode  (style *s, const string &str,
-					       int line_number,
-					       int min_vertical, int min_horizontal,
-					       int max_vertical, int max_horizontal,
-					       int is_tag);
-  void                        add_line        (style *s,
-					       int line_number,
-					       int x1, int y1, int x2, int y2,
-					       int thickness);
-  void                        insert_tag      (const string &str);
-  void                        dump_page       (void);   // debugging method
+              page             (void);
+  void        add             (style *s, const string &str,
+			       int line_number,
+			       int min_vertical, int min_horizontal,
+			       int max_vertical, int max_horizontal);
+  void        add_tag         (style *s, const string &str,
+			       int line_number,
+			       int min_vertical, int min_horizontal,
+			       int max_vertical, int max_horizontal);
+  void        add_and_encode  (style *s, const string &str,
+			       int line_number,
+			       int min_vertical, int min_horizontal,
+			       int max_vertical, int max_horizontal,
+			       int is_tag);
+  void        add_line        (style *s,
+			       int line_number,
+			       int x1, int y1, int x2, int y2,
+			       int thickness);
+  void        insert_tag      (const string &str);
+  void        dump_page       (void);   // debugging method
 
   // and the data
 
-  list                        glyphs;         // position of glyphs and specials on page
-  char_buffer                 buffer;         // all characters for this page
+  list        glyphs;         // position of glyphs and specials on page
+  char_buffer buffer;         // all characters for this page
 };
 
 page::page()
@@ -1296,8 +1323,8 @@
   if (str.length() > 0) {
     text_glob *g=new text_glob();
     text_glob *f=glyphs.get_data();
-    g->text_glob_tag(&f->text_style, buffer.add_string(str), str.length(),
-		     f->minv, f->minh, f->maxv, f->maxh);
+    g->text_glob_tag(&f->text_style, buffer.add_string(str),
+		     str.length(), f->minv, f->minh, f->maxv, f->maxh);
     glyphs.insert(g);
   }
 }
@@ -1314,8 +1341,10 @@
   if (str.length() > 0) {
     text_glob *g=new text_glob();
     g->text_glob_html(s, buffer.add_string(str), str.length(),
-		      min_vertical, min_horizontal, max_vertical, max_horizontal);
-    glyphs.add(g, line_number, min_vertical, min_horizontal, max_vertical, max_horizontal);
+		      min_vertical, min_horizontal,
+		      max_vertical, max_horizontal);
+    glyphs.add(g, line_number, min_vertical, min_horizontal,
+			       max_vertical, max_horizontal);
   }
 }
 
@@ -1335,13 +1364,16 @@
 		strlen("devtag:.auto-image")) == 0) {
       g = new text_glob();
       g->text_glob_auto_image(s, buffer.add_string(str), str.length(),
-			      min_vertical, min_horizontal, max_vertical, max_horizontal);
+			      min_vertical, min_horizontal,
+			      max_vertical, max_horizontal);
     } else {
       g = new text_glob();
       g->text_glob_tag(s, buffer.add_string(str), str.length(),
-		       min_vertical, min_horizontal, max_vertical, max_horizontal);
+		       min_vertical, min_horizontal,
+		       max_vertical, max_horizontal);
     }
-    glyphs.add(g, line_number, min_vertical, min_horizontal, max_vertical, max_horizontal);
+    glyphs.add(g, line_number, min_vertical, min_horizontal,
+			       max_vertical, max_horizontal);
   }
 }
 
@@ -1379,10 +1411,11 @@
 }
 
 /*
- *  add_and_encode - adds a special string to the page, it translates the string
- *                   into html glyphs. The special string will have come from x X html:
- *                   and can contain troff character encodings which appear as
- *                   \char. A sequence of \\ represents \.
+ *  add_and_encode - adds a special string to the page, it translates
+ *                   the string into html glyphs. The special string
+ *                   will have come from x X html: and can contain troff
+ *                   character encodings which appear as \char. A
+ *                   sequence of \\ represents \.
  *                   So for example we can write:
  *                      "cost = \Po3.00 file = \\foo\\bar"
  *                   which is translated into:
@@ -1400,7 +1433,7 @@
   int i = 0;
   const int len = str.length();
 
-  if (s->f == NULL)
+  if (0 /* nullptr */ == s->f)
     return;
   while (i < len) {
     if ((i + 1 < len) && (str.substring(i, 2) == string("\\"))) {
@@ -1459,7 +1492,7 @@
     g = glyphs.get_data();
     if (g->is_tab_ts()) {
       printf("\n\n");
-      if (g->get_table() != NULL)
+      if (g->get_table() != 0)
 	g->get_table()->dump_table();
     }
     printf("%s ", g->text_string);
@@ -1534,24 +1567,24 @@
 
 class header_desc {
 public:
-                            header_desc ();
-                           ~header_desc ();
+              header_desc ();
+              ~header_desc ();
 
-  int                       no_of_level_one_headings; // how many .SH or .NH 1 have we found?
-  int                       no_of_headings;           // how many headings have we found?
-  char_buffer               headings;                 // all the headings used in the document
-  list                      headers;                  // list of headers built from .NH and .SH
-  list                      header_filename;          // in which file is this header?
-  int                       header_level;             // current header level
-  int                       written_header;           // have we written the header yet?
-  string                    header_buffer;            // current header text
+  int         no_of_level_one_headings; // how many .SH or .NH 1 have we found?
+  int         no_of_headings;           // how many headings have we found?
+  char_buffer headings;                 // all the headings used in the document
+  list        headers;                  // list of headers built from .NH and .SH
+  list        header_filename;          // in which file is this header?
+  int         header_level;             // current header level
+  int         written_header;           // have we written the header yet?
+  string      header_buffer;            // current header text
 
-  void                      write_headings (FILE *f, int force);
+  void        write_headings (FILE *f, int force);
 };
 
 header_desc::header_desc ()
-  :   no_of_level_one_headings(0), no_of_headings(0),
-      header_level(2), written_header(0)
+  :   no_of_level_one_headings(0), no_of_headings(0), header_level(2),
+       written_header(0)
 {
 }
 
@@ -1560,7 +1593,8 @@
 }
 
 /*
- *  write_headings - emits a list of links for the headings in this document
+ *  write_headings - emits a list of links for the headings in this
+ *                   document
  */
 
 void header_desc::write_headings (FILE *f, int force)
@@ -1672,38 +1706,38 @@
 assert_state::assert_state ()
 {
   reset();
-  val_br   = NULL;
-  val_ce   = NULL;
-  val_fi   = NULL;
-  val_sp   = NULL;
-  file_br  = NULL;
-  file_ce  = NULL;
-  file_fi  = NULL;
-  file_sp  = NULL;
-  line_br  = NULL;
-  line_ce  = NULL;
-  line_fi  = NULL;
-  line_sp  = NULL;
-  xhead    = NULL;
-  yhead    = NULL;
+  val_br   = 0;
+  val_ce   = 0;
+  val_fi   = 0;
+  val_sp   = 0;
+  file_br  = 0;
+  file_ce  = 0;
+  file_fi  = 0;
+  file_sp  = 0;
+  line_br  = 0;
+  line_ce  = 0;
+  line_fi  = 0;
+  line_sp  = 0;
+  xhead    = 0;
+  yhead    = 0;
 }
 
 assert_state::~assert_state ()
 {
   assert_pos *t;
 
-  while (xhead != NULL) {
+  while (xhead != 0) {
     t = xhead;
     xhead = xhead->next;
-    a_delete (char *)t->val;
-    a_delete (char *)t->id;
+    delete (char *)t->val;
+    delete (char *)t->id;
     delete t;
   }
-  while (yhead != NULL) {
+  while (yhead != 0) {
     t = yhead;
     yhead = yhead->next;
-    a_delete (char *)t->val;
-    a_delete (char *)t->id;
+    delete (char *)t->val;
+    delete (char *)t->id;
     delete t;
   }
 }
@@ -1722,34 +1756,35 @@
 {
   assert_pos *t = *h;
 
-  while (t != NULL) {
+  while (t != 0) {
     if (strcmp(t->id, i) == 0)
       break;
     t = t->next;
   }
-  if (t != NULL && v != NULL && (v0 != '='))
+  if (t != 0 && v != 0 && (v0 != '='))
     compare(t, v, f, l);
   else {
-    if (t == NULL) {
+    if (0 /* nullptr */ == t) {
       t = new assert_pos;
       t->next = *h;
       (*h) = t;
     }
-    if (v == NULL || v0 != '=') {
-      if (f == NULL)
-	f = "stdin";
-      if (l == NULL)
-	l = "<none>";
-      if (v == NULL)
+    if (v == 0 || v0 != '=') {
+      if (0 /* nullptr */ == f)
+	f = strsave("stdin");
+      if (0 /* nullptr */ == l)
+	l = strsave("<none>");
+      if (0 /* nullptr */ == v)
 	v = "no value at all";
-      fprintf(stderr, "%s:%s:error in assert format of id=%s expecting value to be prefixed with an '=' got %s\n",
-	      f, l, i, v);
+      fprintf(stderr, "%s:%s:%s: error in assertion format of id=%s;"
+	      " expected value prefixed with an '=', got %s\n",
+	      program_name, f, l, i, v);
     }
     t->id = i;
     t->val = v;
-    a_delete (char *)c;
-    a_delete (char *)f;
-    a_delete (char *)l;
+    delete (char *)c;
+    delete (char *)f;
+    delete (char *)l;
   }
 }
 
@@ -1774,14 +1809,14 @@
     v++;
   while ((*s) == '=')
     s++;
-  
+
   if (strcmp(v, s) != 0) {
-    if (f == NULL)
+    if (0 /* nullptr */ == f)
       f = "stdin";
-    if (l == NULL)
+    if (0 /* nullptr */ == l)
       l = "<none>";
-    fprintf(stderr, "%s:%s: grohtml assertion failed at id%s expecting %s and was given %s\n",
-	    f, l, t->id, s, v);
+    fprintf(stderr, "%s:%s: grohtml assertion failed at id%s: "
+		    "expected %s, got %s\n", f, l, t->id, s, v);
   }
 }
 
@@ -1798,19 +1833,20 @@
   else if (strcmp(c, "ce") == 0)
     check_ce_flag = 0;
   else
-    fprintf(stderr, "internal error: unrecognised tag in grohtml (%s)\n", c);
+    fprintf(stderr, "internal error: unrecognised tag in grohtml "
+		    "(%s)\n", c);
 }
 
 const char *replace_negate_str (const char *before, char *after)
 {
-  if (before != NULL)
-    a_delete (char *)before;
+  if (before != 0)
+    delete (char *)before;
 
   if (strlen(after) > 0) {
     int d = atoi(after);
 
     if (d < 0 || d > 1) {
-      fprintf(stderr, "expecting nf/fi value to be 0 or 1 not %d\n", d);
+      fprintf(stderr, "expected nf/fi value of 0 or 1, got %d\n", d);
       d = 0;
     }
     if (d == 0)
@@ -1824,17 +1860,17 @@
 
 const char *replace_str (const char *before, const char *after)
 {
-  if (before != NULL)
-    a_delete (char *)before;
+  if (before != 0)
+    delete (char *)before;
   return after;
 }
 
 void assert_state::set (const char *c, const char *v,
 			const char *f, const char *l)
 {
-  if (l == NULL)
+  if (0 /* nullptr */ == l)
     l = "<none>";
-  if (f == NULL)
+  if (0 /* nullptr */ == f)
     f = "stdin";
 
   // fprintf(stderr, "%s:%s:setting %s to %s\n", f, l, c, v);
@@ -1881,16 +1917,16 @@
 }
 
 int assert_state::check_value_error (int c, int v, const char *s,
-				     const char *name,
-				     const char *f, const char *l, int flag)
+				     const char *name, const char *f,
+				     const char *l, int flag)
 {
   if (! c) {
-    if (f == NULL)
+    if (0 /* nullptr */ == f)
       f = "stdin";
-    if (l == NULL)
+    if (0 /* nullptr */ == l)
       l = "<none>";
-    fprintf(stderr, "%s:%s:grohtml (troff state) assertion failed, expected %s to be %s but found it to contain %d\n",
-	    f, l, name, s, v);
+    fprintf(stderr, "%s:%s:grohtml (troff state) assertion failed; "
+	    "expected %s to be %s, got %d\n", f, l, name, s, v);
     return 0;
   }
   return flag;
@@ -1971,7 +2007,7 @@
   title_desc           title;
   header_desc          header;
   int                  header_indent;
-  int                  supress_sub_sup;
+  int                  suppress_sub_sup;
   int                  cutoff_heading;
   page                *page_contents;
   html_text           *current_paragraph;
@@ -2018,7 +2054,8 @@
   void  flush_font                    (void);
   void  add_to_sbuf                   (glyph *g, const string &s);
   void  write_title                   (int in_head);
-  int   sbuf_continuation             (glyph *g, const char *name, const environment *env, int w);
+  int   sbuf_continuation             (glyph *g, const char *name,
+				       const environment *env, int w);
   void  flush_page                    (void);
   void  troff_tag                     (text_glob *g);
   void  flush_globs                   (void);
@@ -2054,7 +2091,8 @@
   void  do_centered_image             (void);
   void  do_left_image                 (void);
   void  do_right_image                (void);
-  void  do_auto_image                 (text_glob *g, const char *filename);
+  void  do_auto_image                 (text_glob *g,
+				       const char *filename);
   void  do_links                      (void);
   void  do_flush                      (void);
   void  do_job_name                   (char *name);
@@ -2069,7 +2107,8 @@
   void  outstanding_eol               (int n);
   int   is_bold                       (font *f);
   font *make_bold                     (font *f);
-  int   overstrike                    (glyph *g, const char *name, const environment *env, int w);
+  int   overstrike                    (glyph *g, const char *name,
+				       const environment *env, int w);
   void  do_body                       (void);
   int   next_horiz_pos                (text_glob *g, int nf);
   void  lookahead_for_tables          (void);
@@ -2077,7 +2116,8 @@
   text_glob *insert_tab_ts            (text_glob *where);
   void insert_tab0_foreach_tab        (void);
   void insert_tab_0                   (text_glob *where);
-  void do_indent                      (int in, int pageoff, int linelen);
+  void do_indent                      (int in, int pageoff,
+				       int linelen);
   void shutdown_table                 (void);
   void do_tab_ts                      (text_glob *g);
   void do_tab_te                      (void);
@@ -2088,15 +2128,22 @@
   void calc_po_in                     (text_glob *g, int nf);
   void remove_tabs                    (void);
   void remove_courier_tabs            (void);
-  void update_min_max                 (colType type_of_col, int *minimum, int *maximum, text_glob *g);
+  void update_min_max                 (colType type_of_col,
+				       int *minimum, int *maximum,
+				       text_glob *g);
   void add_table_end                  (const char *);
   void do_file_components             (void);
-  void write_navigation               (const string &top, const string &prev,
-				       const string &next, const string &current);
-  void emit_link                      (const string &to, const char *name);
+  void write_navigation               (const string &top,
+				       const string &prev,
+				       const string &next,
+				       const string &current);
+  void emit_link                      (const string &to,
+				       const char *name);
   int  get_troff_indent               (void);
   void restore_troff_indent           (void);
-  void handle_assertion               (int minv, int minh, int maxv, int maxh, const char *s);
+  void handle_assertion               (int minv, int minh,
+				       int maxv, int maxh,
+				       const char *s);
   void handle_state_assertion         (text_glob *g);
   void do_end_para                    (text_glob *g);
   int  round_width                    (int x);
@@ -2111,11 +2158,13 @@
 public:
   html_printer          ();
   ~html_printer         ();
-  void set_char         (glyph *g, font *f, const environment *env, int w, const char *name);
+  void set_char         (glyph *g, font *f, const environment *env,
+			 int w, const char *name);
   void set_numbered_char(int num, const environment *env, int *widthp);
   glyph *set_char_and_width(const char *nm, const environment *env,
 			 int *widthp, font **f);
-  void draw             (int code, int *p, int np, const environment *env);
+  void draw             (int code, int *p, int np,
+			 const environment *env);
   void begin_page       (int);
   void end_page         (int);
   void special          (char *arg, const environment *env, char type);
@@ -2134,11 +2183,12 @@
 void html_printer::set_style(const style &sty)
 {
   const char *fontname = sty.f->get_name();
-  if (fontname == NULL)
+  if (0 /* nullptr */ == fontname)
     fatal("no internalname specified for font");
 
 #if 0
-  change_font(fontname, (font::res/(72*font::sizescale))*sty.point_size);
+  change_font(fontname, (font::res / (72 * font::sizescale))
+			* sty.point_size);
 #endif
 }
 
@@ -2153,7 +2203,7 @@
 }
 
 /*
- *  make_bold - if a bold font of, f, exists then return it.
+ *  make_bold - if a bold style for f exists, return it.
  */
 
 font *html_printer::make_bold (font *f)
@@ -2166,7 +2216,7 @@
     return font::load_font("BI");
   if (strcmp(fontname, "BI") == 0)
     return f;
-  return NULL;
+  return 0;
 }
 
 void html_printer::end_of_line()
@@ -2231,15 +2281,23 @@
       break;
     case LEFT:
       if (dialect == html4)
-	current_paragraph->do_para(&html, "align=\"left\"", get_troff_indent(), pageoffset, linelength, space);
+	current_paragraph->do_para(&html, "align=\"left\"",
+				   get_troff_indent(), pageoffset,
+				   linelength, space);
       else
-	current_paragraph->do_para(&html, "class=\"left\"", get_troff_indent(), pageoffset, linelength, space);
+	current_paragraph->do_para(&html, "class=\"left\"",
+				   get_troff_indent(), pageoffset,
+				   linelength, space);
       break;
     case RIGHT:
       if (dialect == html4)
-	current_paragraph->do_para(&html, "align=\"right\"", get_troff_indent(), pageoffset, linelength, space);
+	current_paragraph->do_para(&html, "align=\"right\"",
+				   get_troff_indent(), pageoffset,
+				   linelength, space);
       else
-	current_paragraph->do_para(&html, "class=\"right\"", get_troff_indent(), pageoffset, linelength, space);
+	current_paragraph->do_para(&html, "class=\"right\"",
+				   get_troff_indent(), pageoffset,
+				   linelength, space);
       break;
     default:
       fatal("unknown enumeration");
@@ -2247,7 +2305,7 @@
     current_paragraph->do_emittext(g->text_string, g->text_length);
     current_paragraph->done_para();
     next_tag        = INLINE;
-    supress_sub_sup = TRUE;
+    suppress_sub_sup = TRUE;
     seen_space      = FALSE;
     restore_troff_indent();
   }
@@ -2316,10 +2374,10 @@
   FILE *fp = fopen(filename, "r");
 
   if (fp == 0) {
-    return( FALSE );
+    return FALSE;
   } else {
     fclose(fp);
-    return( TRUE );
+    return TRUE;
   }
 }
 
@@ -2355,7 +2413,7 @@
 void html_printer::do_auto_image (text_glob *g, const char *filename)
 {
   string buffer = generate_img_src(filename);
-  
+
   if (! buffer.empty()) {
     /*
      *  utilize emit_raw by creating a new text_glob.
@@ -2393,7 +2451,7 @@
   if (page_number == 1) {
     int found_title_start  = FALSE;
     if (! page_contents->glyphs.is_empty()) {
-      page_contents->glyphs.sub_move_right();       /* move onto next word */
+      page_contents->glyphs.sub_move_right(); // move onto next word
       do {
 	t = page_contents->glyphs.get_data();
 	removed_from_head = FALSE;
@@ -2407,31 +2465,34 @@
 	    title.has_been_found = TRUE;
 	    title.text += img;
 	  }
-	  page_contents->glyphs.sub_move_right(); 	  /* move onto next word */
+	  page_contents->glyphs.sub_move_right(); // move onto next word
 	  removed_from_head = ((!page_contents->glyphs.is_empty()) &&
-			       (page_contents->glyphs.is_equal_to_head()));
+			       (page_contents->glyphs
+				  .is_equal_to_head()));
 	} else if (t->is_eo_tl()) {
-	  /* end of title found
-	   */
+	  // end of title found
 	  title.has_been_found = TRUE;
 	  return;
 	} else if (t->is_a_tag()) {
 	  handle_tag_within_title(t);
-	  page_contents->glyphs.sub_move_right(); 	  /* move onto next word */
+	  page_contents->glyphs.sub_move_right(); // move onto next word
 	  removed_from_head = ((!page_contents->glyphs.is_empty()) &&
-			       (page_contents->glyphs.is_equal_to_head()));
+			       (page_contents->glyphs
+				  .is_equal_to_head()));
 	} else if (found_title_start) {
 	  title.text += " " + string(t->text_string, t->text_length);
-	  page_contents->glyphs.sub_move_right(); 	  /* move onto next word */
+	  page_contents->glyphs.sub_move_right(); // move onto next word
 	  removed_from_head = ((!page_contents->glyphs.is_empty()) &&
-			       (page_contents->glyphs.is_equal_to_head()));
+			       (page_contents->glyphs
+				  .is_equal_to_head()));
 	} else {
 	  title.text += string(t->text_string, t->text_length);
 	  found_title_start    = TRUE;
 	  title.has_been_found = TRUE;
-	  page_contents->glyphs.sub_move_right(); 	  /* move onto next word */
+	  page_contents->glyphs.sub_move_right(); // move onto next word
 	  removed_from_head = ((!page_contents->glyphs.is_empty()) &&
-			       (page_contents->glyphs.is_equal_to_head()));
+			       (page_contents->glyphs
+				  .is_equal_to_head()));
 	}
       } while ((! page_contents->glyphs.is_equal_to_head()) ||
 	       (removed_from_head));
@@ -2447,7 +2508,7 @@
 void html_printer::write_html_anchor (text_glob *h)
 {
   if (dialect == html4) {
-    if (h != NULL) {
+    if (h != 0) {
       html.put_string("<a name=\"");
       if (simple_anchors) {
 	string buffer(ANCHOR_TEMPLATE);
@@ -2470,7 +2531,7 @@
 void html_printer::write_xhtml_anchor (text_glob *h)
 {
   if (dialect == xhtml) {
-    if (h != NULL) {
+    if (h != 0) {
       html.put_string(" id=\"");
       if (simple_anchors) {
 	string buffer(ANCHOR_TEMPLATE);
@@ -2488,7 +2549,7 @@
 void html_printer::write_header (void)
 {
   if (! header.header_buffer.empty()) {
-    text_glob *a = NULL;
+    text_glob *a = 0;
     int space = current_paragraph->retrieve_para_space() || seen_space;
 
     if (header.header_level > 7)
@@ -2496,7 +2557,7 @@
 
     // firstly we must terminate any font and type faces
     current_paragraph->done_para();
-    supress_sub_sup = TRUE;
+    suppress_sub_sup = TRUE;
 
     if (cutoff_heading+2 > header.header_level) {
       // now we save the header so we can issue a list of links
@@ -2505,7 +2566,8 @@
 
       a = new text_glob();
       a->text_glob_html(&st,
-			header.headings.add_string(header.header_buffer),
+			header.headings
+			  .add_string(header.header_buffer),
 			header.header_buffer.length(),
 			header.no_of_headings, header.header_level,
 			header.no_of_headings, header.header_level);
@@ -2523,7 +2585,8 @@
       // line break before a header
       if (!current_paragraph->emitted_text())
 	current_paragraph->do_space();
-      // user wants manufactured headings which look better than <Hn></Hn>
+      // user wants manufactured headings which look better than
+      // <Hn></Hn>
       if (header.header_level<4) {
 	html.put_string("<b><font size=\"+1\">");
 	html.put_string(header.header_buffer);
@@ -2564,10 +2627,13 @@
 
     header.header_filename.add(h,
 			       header.no_of_headings,
-			       header.no_of_headings, header.no_of_headings,
-			       header.no_of_headings, header.no_of_headings);
+			       header.no_of_headings,
+			       header.no_of_headings,
+			       header.no_of_headings,
+			       header.no_of_headings);
 
-    current_paragraph->do_para(&html, "", get_troff_indent(), pageoffset, linelength, space);
+    current_paragraph->do_para(&html, "", get_troff_indent(),
+			       pageoffset, linelength, space);
   }
 }
 
@@ -2576,8 +2642,8 @@
   if (level == 0) {
     int i;
 
-    for (i=0; ((i<header.header_buffer.length())
-	       && ((header.header_bufferi == '.')
+    for (i = 0; ((i<header.header_buffer.length())
+		 && ((header.header_bufferi == '.')
 		   || is_digit(header.header_bufferi))) ; i++) {
       if (header.header_bufferi == '.') {
 	level++;
@@ -2592,7 +2658,8 @@
 }
 
 /*
- *  do_heading - handle the .SH and .NH and equivalent commands from troff.
+ *  do_heading - handle the .SH and .NH and equivalent commands from
+ *               troff.
  */
 
 void html_printer::do_heading (char *arg)
@@ -2611,14 +2678,16 @@
 	string img=generate_img_src((char *)(g->text_string + 20));
 
 	if (! img.empty()) {
-	  simple_anchors = TRUE;  // we cannot use full heading anchors with images
+	  // we cannot use full heading anchors with images
+	  simple_anchors = TRUE;
 	  if (horiz < g->minh)
 	    header.header_buffer += " ";
-	  
+
 	  header.header_buffer += img;
 	}
       }
-      else if (g->is_in() || g->is_ti() || g->is_po() || g->is_ce() || g->is_ll())
+      else if (g->is_in() || g->is_ti() || g->is_po() || g->is_ce()
+	       || g->is_ll())
 	troff_tag(g);
       else if (g->is_fi())
 	fill_on = 1;
@@ -2648,13 +2717,14 @@
    *  the new paragraph to start a new font block.
    */
 
-  output_style.f = NULL;
+  output_style.f = 0;
   g = page_contents->glyphs.get_data();
-  page_contents->glyphs.move_left();     // so that next time we use old g
+  page_contents->glyphs.move_left(); // so that next time we use old g
 }
 
 /*
- *  is_courier_until_eol - returns TRUE if we can see a whole line which is courier
+ *  is_courier_until_eol - returns TRUE if we can see a whole line which
+ *                         is courier
  */
 
 int html_printer::is_courier_until_eol (void)
@@ -2673,7 +2743,7 @@
     } while (result &&
 	     (! page_contents->glyphs.is_equal_to_head()) &&
 	     (! g->is_fi()) && (! g->is_eol()));
-    
+
     /*
      *  now restore our previous position.
      */
@@ -2750,11 +2820,12 @@
 
 void html_printer::shutdown_table (void)
 {
-  if (table != NULL) {
+  if (table != 0) {
     current_paragraph->done_para();
     table->emit_finish_table();
-    // dont delete this table as it will be deleted when we destroy the text_glob
-    table = NULL;
+    // don't delete this table as it will be deleted when we destroy the
+    // text_glob
+    table = 0;
   }
 }
 
@@ -2769,9 +2840,9 @@
   if ((device_indent != -1) &&
       (pageoffset+device_indent != in+pageoff)) {
 
-    int space = current_paragraph->retrieve_para_space() || seen_space;    
+    int space = current_paragraph->retrieve_para_space() || seen_space;
     current_paragraph->done_para();
-      
+
     device_indent = in;
     pageoffset  = pageoff;
     if (linelen <= max_linelength)
@@ -2798,14 +2869,16 @@
 void html_printer::do_pointsize (char *arg)
 {
   /*
-   *  firstly check to see whether this point size is really associated with a .tl tag
+   *  firstly check to see whether this point size is really associated
+   *  with a .tl tag
    */
 
   if (! page_contents->glyphs.is_empty()) {
     text_glob *g = page_contents->glyphs.get_data();
     text_glob *t = page_contents->glyphs.get_data();
 
-    while (t->is_a_tag() && (! page_contents->glyphs.is_equal_to_head())) {
+    while (t->is_a_tag() && (!page_contents->glyphs.is_equal_to_head()))
+    {
       if (t->is_tl()) {
 	/*
 	 *  found title therefore ignore this .ps tag
@@ -2840,9 +2913,9 @@
 void html_printer::do_fill (char *arg)
 {
   int on = atoi(arg);
-      
+
   output_hpos = get_troff_indent()+pageoffset;
-  supress_sub_sup = TRUE;
+  suppress_sub_sup = TRUE;
 
   if (fill_on != on) {
     if (on)
@@ -2877,9 +2950,10 @@
     seen_center = FALSE;
     if (next_center > 0) {
       if (end_center == 0) {
-	int space = current_paragraph->retrieve_para_space() || seen_space;
+	int space = current_paragraph->retrieve_para_space()
+		    || seen_space;
 	current_paragraph->done_para();
-	supress_sub_sup = TRUE;
+	suppress_sub_sup = TRUE;
 	if (dialect == html4)
 	  current_paragraph->do_para("align=\"center\"", space);
 	else
@@ -2893,17 +2967,16 @@
 	   *  different alignment, so shutdown paragraph and open
 	   *  a new one.
 	   */
-	  int space = current_paragraph->retrieve_para_space() || seen_space;
+	  int space = current_paragraph->retrieve_para_space()
+		      || seen_space;
 	  current_paragraph->done_para();
-	  supress_sub_sup = TRUE;
+	  suppress_sub_sup = TRUE;
 	  if (dialect == html4)
 	    current_paragraph->do_para("align=\"center\"", space);
 	  else
 	    current_paragraph->do_para("class=\"center\"", space);
 	} else
-	  /*
-	   *  same alignment, if we have emitted text then issue a break.
-	   */
+	   // same alignment; if we have emitted text, issue a break.
 	  if (current_paragraph->emitted_text())
 	    current_paragraph->do_break();
     } else
@@ -2911,9 +2984,10 @@
        *  next_center == 0
        */
       if (end_center > 0) {
-	seen_space = seen_space || current_paragraph->retrieve_para_space();
+	seen_space = seen_space
+		     || current_paragraph->retrieve_para_space();
 	current_paragraph->done_para();
-	supress_sub_sup = TRUE;
+	suppress_sub_sup = TRUE;
 	current_paragraph->do_para("", seen_space);
       }
     end_center = next_center;
@@ -2930,11 +3004,11 @@
     if (end_center > 1)
       if (current_paragraph->emitted_text())
 	current_paragraph->do_break();
-    
+
     end_center--;
     if (end_center == 0) {
       current_paragraph->done_para();
-      supress_sub_sup = TRUE;
+      suppress_sub_sup = TRUE;
     }
   }
 }
@@ -2949,20 +3023,21 @@
 }
 
 /*
- *  do_links - moves onto a new temporary file and sets auto_links to FALSE.
+ *  do_links - moves onto a new temporary file and sets auto_links to
+ *             false.
  */
 
 void html_printer::do_links (void)
 {
-  html.end_line();                      // flush line
-  auto_links = FALSE;   /* from now on only emit under user request */
+  html.end_line();  // flush line
+  auto_links = FALSE;  // from now on only emit under user request
   file_list.add_new_file(xtmpfile());
   file_list.set_links_required();
   html.set_file(file_list.get_file());
 }
 
 /*
- *  insert_split_file - 
+ *  insert_split_file -
  */
 
 void html_printer::insert_split_file (void)
@@ -2995,7 +3070,7 @@
 {
   if (! multiple_files) {
     multiple_files = TRUE;
-    while (name != NULL && (*name != (char)0) && (*name == ' '))
+    while (name != 0 && (*name != (char)0) && (*name == ' '))
       name++;
     job_name = name;
   }
@@ -3013,10 +3088,9 @@
 }
 
 /*
- *  do_break - handles the ".br" request and also
- *             undoes an outstanding ".ti" command
- *             and calls indent if the indentation
- *             related registers have changed.
+ *  do_break - handles the ".br" request and also undoes an outstanding
+ *             ".ti" command and calls indent if the indentation related
+ *             registers have changed.
  */
 
 void html_printer::do_break (void)
@@ -3029,7 +3103,8 @@
     if (end_tempindent > 0)
       seen_temp_indent = TRUE;
   }
-  if (seen_indent || seen_pageoffset || seen_linelength || seen_temp_indent) {
+  if (seen_indent || seen_pageoffset || seen_linelength
+      || seen_temp_indent) {
     if (seen_indent && (! seen_temp_indent))
       troff_indent = next_indent;
     if (! seen_pageoffset)
@@ -3043,7 +3118,7 @@
   seen_pageoffset = FALSE;
   do_check_center();
   output_hpos     = get_troff_indent()+pageoffset;
-  supress_sub_sup = TRUE;
+  suppress_sub_sup = TRUE;
 }
 
 void html_printer::do_space (char *arg)
@@ -3061,7 +3136,7 @@
     current_paragraph->do_space();
     n--;
   }
-  supress_sub_sup = TRUE;
+  suppress_sub_sup = TRUE;
 }
 
 /*
@@ -3072,7 +3147,7 @@
 {
   html_table *t = g->get_table();
 
-  if (t != NULL) {
+  if (t != 0) {
     current_column = 0;
     current_paragraph->done_pre();
     current_paragraph->done_para();
@@ -3108,7 +3183,7 @@
     table->emit_finish_table();
   }
 
-  table = NULL;
+  table = 0;
   restore_troff_indent();
 }
 
@@ -3122,7 +3197,8 @@
     while (isspace(*s))
       s++;
     s++;
-    int col = table->find_column(atoi(s) + pageoffset + get_troff_indent());
+    int col = table->find_column(atoi(s) + pageoffset
+	      + get_troff_indent());
     if (col > 0) {
       current_paragraph->done_para();
       table->emit_col(col);
@@ -3175,12 +3251,14 @@
   char *t=(char *)g->text_string+strlen("devtag:");
   if (strncmp(g->text_string, "html</p>:", strlen("html</p>:")) == 0) {
     do_end_para(g);
-  } else if (strncmp(g->text_string, "html<?p>:", strlen("html<?p>:")) == 0) {
+  } else if (strncmp(g->text_string, "html<?p>:", strlen("html<?p>:"))
+	     == 0) {
     if (current_paragraph->emitted_text())
       html.put_string(g->text_string+9);
     else
       do_end_para(g);
-  } else if (strncmp(g->text_string, "math<?p>:", strlen("math<?p>:")) == 0) {
+  } else if (strncmp(g->text_string, "math<?p>:", strlen("math<?p>:"))
+	      == 0) {
     do_math(g);
   } else if (g->is_eol()) {
     do_eol();
@@ -3204,20 +3282,21 @@
     do_auto_image(g, a);
   } else if (strncmp(t, ".ce", 3) == 0) {
     char *a = (char *)t+3;
-    supress_sub_sup = TRUE;
+    suppress_sub_sup = TRUE;
     do_center(a);
   } else if (g->is_tl()) {
-    supress_sub_sup = TRUE;
+    suppress_sub_sup = TRUE;
     title.with_h1 = TRUE;
     do_title();
   } else if (strncmp(t, ".html-tl", 8) == 0) {
-    supress_sub_sup = TRUE;
+    suppress_sub_sup = TRUE;
     title.with_h1 = FALSE;
     do_title();
   } else if (strncmp(t, ".fi", 3) == 0) {
     char *a = (char *)t+3;
     do_fill(a);
-  } else if ((strncmp(t, ".SH", 3) == 0) || (strncmp(t, ".NH", 3) == 0)) {
+  } else if ((strncmp(t, ".SH", 3) == 0)
+	      || (strncmp(t, ".NH", 3) == 0)) {
     char *a = (char *)t+3;
     do_heading(a);
   } else if (strncmp(t, ".ll", 3) == 0) {
@@ -3277,7 +3356,8 @@
 }
 
 /*
- *  is_in_middle - returns TRUE if the positions left..right are in the center of the page.
+ *  is_in_middle - returns TRUE if the positions left..right are in the
+ *                 center of the page.
  */
 
 int html_printer::is_in_middle (int left, int right)
@@ -3324,7 +3404,8 @@
       as.check_fi(fill_on);
       as.check_ce(end_center);
       /*
-       *  after processing the title (and removing it) the glyph list might be empty
+       *  after processing the title (and removing it) the glyph list
+       *  might be empty
        */
       if (! page_contents->glyphs.is_empty()) {
 	page_contents->glyphs.move_right();
@@ -3340,7 +3421,7 @@
 
 int html_printer::calc_nf (text_glob *g, int nf)
 {
-  if (g != NULL) {
+  if (g != 0) {
     if (g->is_fi()) {
       as.check_fi(TRUE);
       return FALSE;
@@ -3382,10 +3463,10 @@
 {
   int next = -1;
 
-  if ((g != NULL) && (g->is_br() || (nf && g->is_eol())))
+  if ((g != 0) && (g->is_br() || (nf && g->is_eol())))
     if (! page_contents->glyphs.is_empty()) {
       page_contents->glyphs.move_right_get_data();
-      if (g == NULL) {
+      if (0 /* nullptr */ == g) {
 	page_contents->glyphs.start_from_head();
 	as.reset();
       }
@@ -3405,10 +3486,10 @@
 {
   text_glob *start_of_table;
   text_glob *old_pos = page_contents->glyphs.get_data();
-
   page_contents->glyphs.move_to(where);
   page_contents->glyphs.move_left();
-  page_contents->insert_tag(string("devtag:.tab-ts"));  // tab table start
+  // tab table start
+  page_contents->insert_tag(string("devtag:.tab-ts"));
   page_contents->glyphs.move_right();
   start_of_table = page_contents->glyphs.get_data();
   page_contents->glyphs.move_to(old_pos);
@@ -3424,11 +3505,10 @@
 {
   text_glob *g = page_contents->glyphs.get_data();
   page_contents->dump_page();
-
   while (page_contents->glyphs.get_data()->is_a_tag())
     page_contents->glyphs.move_left();
-
-  page_contents->insert_tag(string("devtag:.tab-te"));  // tab table end
+  // tab table end
+  page_contents->insert_tag(string("devtag:.tab-te"));
   while (g != page_contents->glyphs.get_data())
     page_contents->glyphs.move_right();
   page_contents->dump_page();
@@ -3444,7 +3524,8 @@
 
   page_contents->glyphs.move_to(where);
   page_contents->glyphs.move_left();
-  page_contents->insert_tag(string("devtag:tab0"));  // tab0 start of line
+  // tab0 start of line
+  page_contents->insert_tag(string("devtag:tab0"));
   page_contents->glyphs.move_right();
   page_contents->glyphs.move_to(old_pos);
 }
@@ -3469,7 +3550,7 @@
 	page_contents->glyphs.move_right();
     } while ((! page_contents->glyphs.is_equal_to_head()) &&
 	     (! g->is_eol()));
-    
+
     /*
      *  now restore our previous position.
      */
@@ -3500,7 +3581,8 @@
 	}
       }
 
-      // line_start = g->is_br() || g->is_nf() || g->is_fi() || (nf && g->is_eol());
+      // line_start = g->is_br() || g->is_nf() || g->is_fi()
+      //             || (nf && g->is_eol());
       line_start = g->is_br() || (nf && g->is_eol());
       page_contents->glyphs.move_right();
     } while (! page_contents->glyphs.is_equal_to_head());
@@ -3509,8 +3591,8 @@
 
 void html_printer::insert_tab0_foreach_tab (void)
 {
-  text_glob  *start_of_line  = NULL;
-  text_glob  *g              = NULL;
+  text_glob  *start_of_line  = 0;
+  text_glob  *g              = 0;
   int seen_tab               = FALSE;
   int seen_col               = FALSE;
   int nf                     = FALSE;
@@ -3526,7 +3608,7 @@
 
       if (g->is_tab())
 	seen_tab = TRUE;
-      
+
       if (g->is_col())
 	seen_col = TRUE;
 
@@ -3561,14 +3643,16 @@
 }
 
 /*
- *  update_min_max - updates the extent of a column, given the left and right
- *                   extents of a glyph, g.
+ *  update_min_max - updates the extent of a column, given the left and
+ *                   right extents of a glyph, g.
  */
 
-void html_printer::update_min_max (colType type_of_col, int *minimum, int *maximum, text_glob *g)
+void html_printer::update_min_max (colType type_of_col,
+				   int *minimum, int *maximum,
+				   text_glob *g)
 {
   switch (type_of_col) {
-    
+
   case tab_tag:
     break;
   case tab0_tag:
@@ -3584,8 +3668,8 @@
 }
 
 /*
- *  add_table_end - moves left one glyph, adds a table end tag and adds a
- *                  debugging string.
+ *  add_table_end - moves left one glyph, adds a table end tag and adds
+ *                  a debugging string.
  */
 
 void html_printer::add_table_end (const char *
@@ -3609,16 +3693,16 @@
 void html_printer::lookahead_for_tables (void)
 {
   text_glob  *g;
-  text_glob  *start_of_line  = NULL;
-  text_glob  *start_of_table = NULL;
-  text_glob  *last           = NULL;
+  text_glob  *start_of_line  = 0;
+  text_glob  *start_of_table = 0;
+  text_glob  *last           = 0;
   colType     type_of_col    = none;
   int         found_col      = FALSE;
   int         ncol           = 0;
   int         colmin         = 0;		// pacify compiler
   int         colmax         = 0;		// pacify compiler
   html_table *tbl            = new html_table(&html, -1);
-  const char *tab_defs       = NULL;
+  const char *tab_defs       = 0;
   char        align          = 'L';
   int         nf             = FALSE;
   int         old_pageoffset = pageoffset;
@@ -3635,9 +3719,9 @@
       g = page_contents->glyphs.move_right_get_data();
       handle_state_assertion(g);
       if (page_contents->glyphs.is_equal_to_head()) {
-	if (tbl != NULL) {
+	if (tbl != 0) {
 	  delete tbl;
-	  tbl = NULL;
+	  tbl = 0;
 	}
 	return;
       }
@@ -3648,7 +3732,7 @@
 	last = g;
       found_col = FALSE;
     }
-    
+
     do {
 #if defined(DEBUG_TABLES)
       fprintf(stderr, " ") ;
@@ -3662,16 +3746,16 @@
       nf = calc_nf(g, nf);
       calc_po_in(g, nf);
       if (g->is_col()) {
-	if (type_of_col == tab_tag && start_of_table != NULL) {
+	if (type_of_col == tab_tag && start_of_table != 0) {
 	  page_contents->glyphs.move_left();
 	  insert_tab_te();
 	  start_of_table->remember_table(tbl);
 	  tbl = new html_table(&html, -1);
 	  page_contents->insert_tag(string("*** TAB -> COL ***"));
-	  if (tab_defs != NULL)
+	  if (tab_defs != 0)
 	    tbl->tab_stops->init(tab_defs);
-	  start_of_table = NULL;
-	  last = NULL;
+	  start_of_table = 0;
+	  last = 0;
 	}
 	type_of_col = col_tag;
 	found_col = TRUE;
@@ -3689,57 +3773,54 @@
 	if (colmax > 0)
 	  colmax += pageoffset + get_troff_indent();
       } else if (g->is_tab0()) {
-	if (type_of_col == col_tag && start_of_table != NULL) {
+	if (type_of_col == col_tag && start_of_table != 0) {
 	  page_contents->glyphs.move_left();
 	  insert_tab_te();
 	  start_of_table->remember_table(tbl);
 	  tbl = new html_table(&html, -1);
 	  page_contents->insert_tag(string("*** COL -> TAB ***"));
-	  start_of_table = NULL;
-	  last = NULL;
+	  start_of_table = 0;
+	  last = 0;
 	}
-	if (tab_defs != NULL)
+	if (tab_defs != 0)
 	  tbl->tab_stops->init(tab_defs);
-
 	type_of_col = tab0_tag;
 	ncol = 1;
 	colmin = 0;
 	colmax = tbl->get_tab_pos(2) + pageoffset + get_troff_indent();
       } else if (! g->is_a_tag())
 	update_min_max(type_of_col, &colmin, &colmax, g);
-
       if ((g->is_col() || g->is_tab() || g->is_tab0())
-	  && (start_of_line != NULL) && (start_of_table == NULL)) {
+	  && (start_of_line != 0)
+	  && (0 /* nullptr */ == start_of_table)) {
 	start_of_table = insert_tab_ts(start_of_line);
-	start_of_line = NULL;
-      } else if (g->is_ce() && (start_of_table != NULL)) {
+	start_of_line = 0;
+      } else if (g->is_ce() && (start_of_table != 0)) {
 	add_table_end("*** CE ***");
 	start_of_table->remember_table(tbl);
- 	tbl = new html_table(&html, -1);
-	start_of_table = NULL;
-	last = NULL;
+	tbl = new html_table(&html, -1);
+	start_of_table = 0;
+	last = 0;
       } else if (g->is_ta()) {
 	tab_defs = g->text_string;
-
 	if (type_of_col == col_tag)
 	  tbl->tab_stops->check_init(tab_defs);
-
 	if (!tbl->tab_stops->compatible(tab_defs)) {
-	  if (start_of_table != NULL) {
+	  if (start_of_table != 0) {
 	    add_table_end("*** TABS ***");
 	    start_of_table->remember_table(tbl);
 	    tbl = new html_table(&html, -1);
-	    start_of_table = NULL;
+	    start_of_table = 0;
 	    type_of_col = none;
-	    last = NULL;
+	    last = 0;
 	  }
 	  tbl->tab_stops->init(tab_defs);
 	}
       }
-
-      if (((! g->is_a_tag()) || g->is_tab()) && (start_of_table != NULL)) {
+      if (((! g->is_a_tag()) || g->is_tab()) && (start_of_table != 0)) {
 	// we are in a table and have a glyph
-	if ((ncol == 0) || (! tbl->add_column(ncol, colmin, colmax, align))) {
+	if ((ncol == 0)
+	    || (! tbl->add_column(ncol, colmin, colmax, align))) {
 	  if (ncol == 0)
 	    add_table_end("*** NCOL == 0 ***");
 	  else
@@ -3747,19 +3828,17 @@
 
 	  start_of_table->remember_table(tbl);
 	  tbl = new html_table(&html, -1);
-	  start_of_table = NULL;
+	  start_of_table = 0;
 	  type_of_col = none;
-	  last = NULL;
+	  last = 0;
 	}
       }
-      
       /*
        *  move onto next glob, check whether we are starting a new line
        */
       g = page_contents->glyphs.move_right_get_data();
       handle_state_assertion(g);
-
-      if (g == NULL) {
+      if (0 /* nullptr */ == g) {
 	if (found_col) {
 	  page_contents->glyphs.start_from_head();
 	  as.reset();
@@ -3771,34 +3850,34 @@
 	  g = page_contents->glyphs.move_right_get_data();
 	  handle_state_assertion(g);
 	  nf = calc_nf(g, nf);
-	} while ((g != NULL) && (g->is_br() || (nf && g->is_eol())));
+	} while ((g != 0) && (g->is_br() || (nf && g->is_eol())));
 	start_of_line = g;
 	ncol = 0;
 	if (found_col)
 	  last = g;
 	found_col = FALSE;
       }
-    } while ((g != NULL) && (! page_contents->glyphs.is_equal_to_head()));
+    } while ((g != 0) && (! page_contents->glyphs.is_equal_to_head()));
 
 #if defined(DEBUG_TABLES)
     fprintf(stderr, "finished scanning for tables\n");
 #endif
 
     page_contents->glyphs.start_from_head();
-    if (start_of_table != NULL) {
-      if (last != NULL)
+    if (start_of_table != 0) {
+      if (last != 0)
 	while (last != page_contents->glyphs.get_data())
 	  page_contents->glyphs.move_left();
 
       insert_tab_te();
       start_of_table->remember_table(tbl);
-      tbl = NULL;
-      page_contents->insert_tag(string("*** LAST ***"));      
+      tbl = 0;
+      page_contents->insert_tag(string("*** LAST ***"));
     }
   }
-  if (tbl != NULL) {
+  if (tbl != 0) {
     delete tbl;
-    tbl = NULL;
+    tbl = 0;
   }
 
   // and reset the registers
@@ -3810,21 +3889,18 @@
 
 void html_printer::flush_page (void)
 {
-  supress_sub_sup = TRUE;
+  suppress_sub_sup = TRUE;
   flush_sbuf();
   page_contents->dump_page();
   lookahead_for_tables();
   page_contents->dump_page();
-
   flush_globs();
   current_paragraph->done_para();
   current_paragraph->flush_text();
-  
   // move onto a new page
   delete page_contents;
 #if defined(DEBUG_TABLES)
   fprintf(stderr, "\n\n*** flushed page ***\n\n");
-
   html.simple_comment("new page called");
 #endif
   page_contents = new page;
@@ -3832,7 +3908,7 @@
 
 /*
  *  determine_space - works out whether we need to write a space.
- *                    If last glyph is ajoining then no space emitted.
+ *                    If last glyph is adjoining, then emit no space.
  */
 
 void html_printer::determine_space (text_glob *g)
@@ -3975,8 +4051,9 @@
 
 /*
  *  start_size - from is old font size, to is the new font size.
- *               The html increase <big> and <small> decrease alters the
- *               font size by 20%. We try and map these onto glyph sizes.
+ *               The HTML elements <big> and <small> respectively
+ *               increase and decrease the font size by 20%.  We try and
+ *               map these onto glyph sizes.
  */
 
 void html_printer::start_size (int from, int to)
@@ -4044,14 +4121,15 @@
   int r        = font::res;
   int height   = output_style.point_size*r/72;
 
-  return( (output_style.point_size != 0) &&
+  return ((output_style.point_size != 0) &&
 	  (output_vpos < g->minv) &&
 	  (output_vpos-height > g->maxv) &&
-	  (output_style.point_size > g->text_style.point_size) );
+	  (output_style.point_size > g->text_style.point_size));
 }
 
 /*
- *  start_superscript - returns TRUE if, g, looks like a superscript start.
+ *  start_superscript - returns TRUE if, g, looks like a superscript
+ *                      start.
  */
 
 int html_printer::start_superscript (text_glob *g)
@@ -4059,14 +4137,15 @@
   int r        = font::res;
   int height   = output_style.point_size*r/72;
 
-  return( (output_style.point_size != 0) &&
+  return ((output_style.point_size != 0) &&
 	  (output_vpos > g->minv) &&
 	  (output_vpos-height < g->maxv) &&
-	  (output_style.point_size > g->text_style.point_size) );
+	  (output_style.point_size > g->text_style.point_size));
 }
 
 /*
- *  end_subscript - returns TRUE if, g, looks like the end of a subscript.
+ *  end_subscript - returns TRUE if, g, looks like the end of a
+ *                  subscript.
  */
 
 int html_printer::end_subscript (text_glob *g)
@@ -4074,14 +4153,15 @@
   int r        = font::res;
   int height   = output_style.point_size*r/72;
 
-  return( (output_style.point_size != 0) &&
+  return ((output_style.point_size != 0) &&
 	  (g->minv < output_vpos) &&
 	  (output_vpos-height > g->maxv) &&
-	  (output_style.point_size < g->text_style.point_size) );
+	  (output_style.point_size < g->text_style.point_size));
 }
 
 /*
- *  end_superscript - returns TRUE if, g, looks like the end of a superscript.
+ *  end_superscript - returns TRUE if, g, looks like the end of a
+ *                    superscript.
  */
 
 int html_printer::end_superscript (text_glob *g)
@@ -4089,21 +4169,21 @@
   int r        = font::res;
   int height   = output_style.point_size*r/72;
 
-  return( (output_style.point_size != 0) &&
+  return ((output_style.point_size != 0) &&
 	  (g->minv > output_vpos) &&
 	  (output_vpos-height < g->maxv) &&
-	  (output_style.point_size < g->text_style.point_size) );
+	  (output_style.point_size < g->text_style.point_size));
 }
 
 /*
- *  do_sup_or_sub - checks to see whether the next glyph is a subscript/superscript
- *                  start/end and it calls the services of html-text to issue the
- *                  appropriate tags.
+ *  do_sup_or_sub - checks to see whether the next glyph is a
+ *                  subscript/superscript start/end and it calls the
+ *                  services of html-text to issue the appropriate tags.
  */
 
 void html_printer::do_sup_or_sub (text_glob *g)
 {
-  if (! supress_sub_sup) {
+  if (! suppress_sub_sup) {
     if (start_subscript(g)) {
       current_paragraph->do_sub();
     } else if (start_superscript(g)) {
@@ -4130,7 +4210,7 @@
   output_vpos     = g->minv;
   output_hpos     = g->maxh;
   output_vpos_max = g->maxv;
-  supress_sub_sup = FALSE;
+  suppress_sub_sup = FALSE;
 }
 
 /*
@@ -4145,7 +4225,7 @@
   output_vpos     = g->minv;
   output_hpos     = g->maxh;
   output_vpos_max = g->maxv;
-  supress_sub_sup = FALSE;
+  suppress_sub_sup = FALSE;
 }
 
 /*
@@ -4160,15 +4240,13 @@
 
     if (overstrike_detected && (! is_bold(sbuf_style.f))) {
       font *bold_font = make_bold(sbuf_style.f);
-      if (bold_font != NULL)
+      if (bold_font != 0)
 	sbuf_style.f = bold_font;
     }
 
-    page_contents->add(&sbuf_style, sbuf,
-		       line_number,
-		       sbuf_vpos-sbuf_style.point_size*r/72, sbuf_start_hpos,
-		       sbuf_vpos                           , sbuf_end_hpos);
-	     
+    page_contents->add(&sbuf_style, sbuf, line_number,
+		       (sbuf_vpos - (sbuf_style.point_size * r / 72)),
+		       sbuf_start_hpos, sbuf_vpos, sbuf_end_hpos);
     output_hpos = sbuf_end_hpos;
     output_vpos = sbuf_vpos;
     last_sbuf_length = 0;
@@ -4183,7 +4261,8 @@
   line_thickness = env->size;
 }
 
-void html_printer::draw(int code, int *p, int np, const environment *env)
+void html_printer::draw(int code, int *p, int np,
+			const environment *env)
 {
   switch (code) {
 
@@ -4192,7 +4271,9 @@
     if (np == 2) {
       page_contents->add_line(&sbuf_style,
 			      line_number,
-			      env->hpos, env->vpos, env->hpos+p0, env->vpos+p1, line_thickness);
+			      env->hpos, env->vpos,
+			      (env->hpos + p0), (env->vpos + p1),
+			      line_thickness);
     } else {
       error("2 arguments required for line");
     }
@@ -4233,7 +4314,7 @@
     break;
   case 'F':
     // fill with color env->fill
-    if (background != NULL)
+    if (background != 0)
       delete background;
     background = new color;
     *background = *env->fill;
@@ -4257,10 +4338,10 @@
   inside_font_style(0),
   page_number(0),
   header_indent(-1),
-  supress_sub_sup(TRUE),
+  suppress_sub_sup(TRUE),
   cutoff_heading(100),
-  indent(NULL),
-  table(NULL),
+  indent(0),
+  table(0),
   end_center(0),
   end_tempindent(0),
   next_tag(INLINE),
@@ -4290,9 +4371,9 @@
   file_list.add_new_file(xtmpfile());
   html.set_file(file_list.get_file());
   if (font::hor != 24)
-    fatal("horizontal resolution must be 24");
+    fatal("horizontal motion quantum must be 24");
   if (font::vert != 40)
-    fatal("vertical resolution must be 40");
+    fatal("vertical motion quantum must be 40");
 #if 0
   // should be sorted html..
   if (font::res % (font::sizescale*72) != 0)
@@ -4322,25 +4403,25 @@
 
 void html_printer::add_to_sbuf (glyph *g, const string &s)
 {
-  if (sbuf_style.f == NULL)
+  if (0 /* nullptr */ == sbuf_style.f)
     return;
 
-  const char *html_glyph = NULL;
+  const char *html_glyph = 0;
   unsigned int code = sbuf_style.f->get_code(g);
 
   if (s.empty()) {
     if (sbuf_style.f->contains(g))
       html_glyph = get_html_entity(sbuf_style.f->get_code(g));
     else
-      html_glyph = NULL;
-    
-    if ((html_glyph == NULL) && (code >= UNICODE_DESC_START))
+      html_glyph = 0;
+
+    if ((0 /* nullptr */ == html_glyph) && (code >= UNICODE_DESC_START))
       html_glyph = to_unicode(code);
-  } else 
+  } else
     html_glyph = get_html_translation(sbuf_style.f, s);
 
   last_sbuf_length = sbuf.length();
-  if (html_glyph == NULL)
+  if (0 /* nullptr */ == html_glyph)
     sbuf += ((char)code);
   else
     sbuf += html_glyph;
@@ -4361,8 +4442,9 @@
     sbuf_end_hpos += w + sbuf_kern;
     return TRUE;
   } else {
-    if ((env->hpos >= sbuf_end_hpos) &&
-	((sbuf_kern == 0) || (sbuf_end_hpos - sbuf_kern != env->hpos))) {
+    if ((env->hpos >= sbuf_end_hpos)
+	&& ((sbuf_kern == 0)
+	    || (sbuf_end_hpos - sbuf_kern != env->hpos))) {
       /*
        *  lets see whether a space is needed or not
        */
@@ -4375,33 +4457,35 @@
       }
     }
   }
-  return FALSE ;
+  return FALSE;
 }
 
 /*
- *  get_html_translation - given the position of the character and its name
- *                         return the device encoding for such character.
+ *  get_html_translation - given the position of the character and its
+ *                         name return the device encoding for such
+ *                         character.
  */
 
 const char *get_html_translation (font *f, const string &name)
 {
-  if ((f == 0) || name.empty())
-    return NULL;
+  if ((0 /* nullptr */ == f) || name.empty())
+    return 0;
   else {
     glyph *g = name_to_glyph((char *)(name + '\0').contents());
     if (f->contains(g))
       return get_html_entity(f->get_code(g));
     else
-      return NULL;
+      return 0;
   }
 }
 
 /*
- * get_html_entity - given a Unicode character's code point, return a
+ * get_html_entity - given a Unicode character's code point, return an
  *                   HTML entity that represents the character, if the
  *                   character cannot represent itself in all contexts.
- * The return value, if non-NULL, is allocated in a static buffer and is
- * only valid until the next call of this function.
+ *                   the return value, if not a null pointer, is
+ *                   allocated in a static buffer and is only valid
+ *                   until the next call of this function.
  */
 static const char *get_html_entity (unsigned int code)
 {
@@ -4411,7 +4495,7 @@
       case 0x0026: return "&amp;";
       case 0x003C: return "&lt;";
       case 0x003E: return "&gt;";
-      default: return NULL;
+      default: return 0;
     }
   } else {
     switch (code) {
@@ -4656,18 +4740,19 @@
     }
   }
 }
- 
+
 /*
- *  overstrike - returns TRUE if the glyph (i, name) is going to overstrike
- *               a previous glyph in sbuf.
- *               If TRUE the font is changed to bold and the previous sbuf
- *               is flushed.
+ *  overstrike - returns TRUE if the glyph (i, name) is going to
+ *               overstrike a previous glyph in sbuf.  If TRUE the font
+ *               is changed to bold and the previous sbuf is flushed.
  */
 
-int html_printer::overstrike(glyph *g, const char *name, const environment *env, int w)
+int html_printer::overstrike(glyph *g, const char *name,
+			     const environment *env, int w)
 {
   if ((env->hpos < sbuf_end_hpos)
-      || ((sbuf_kern != 0) && (sbuf_end_hpos - sbuf_kern < env->hpos))) {
+      || ((sbuf_kern != 0) && (sbuf_end_hpos - sbuf_kern < env->hpos)))
+  {
     /*
      *  at this point we have detected an overlap
      */
@@ -4688,7 +4773,7 @@
       return TRUE;
     }
   }
-  return FALSE ;
+  return FALSE;
 }
 
 /*
@@ -4700,20 +4785,23 @@
 void html_printer::set_char(glyph *g, font *f, const environment *env,
 			    int w, const char *name)
 {
-  style sty(f, env->size, env->height, env->slant, env->fontno, *env->col);
+  style sty(f, env->size, env->height, env->slant, env->fontno,
+	    *env->col);
   if (sty.slant != 0) {
     if (sty.slant > 80 || sty.slant < -80) {
-      error("silly slant '%1' degrees", sty.slant);
+      error("slant of %1 degrees out of range", sty.slant);
       sty.slant = 0;
     }
   }
-  if (((! sbuf.empty()) && (sty == sbuf_style) && (sbuf_vpos == env->vpos))
+  if (((!sbuf.empty())
+       && (sty == sbuf_style)
+       && (sbuf_vpos == env->vpos))
       && (sbuf_continuation(g, name, env, w)
 	  || overstrike(g, name, env, w)))
     return;
-  
+
   flush_sbuf();
-  if (sbuf_style.f == NULL)
+  if (0 /* nullptr */ == sbuf_style.f)
     sbuf_style = sty;
   add_to_sbuf(g, name);
   sbuf_end_hpos = env->hpos + w;
@@ -4725,9 +4813,9 @@
 }
 
 /*
- *  set_numbered_char - handle numbered characters.
- *                      Negative values are interpreted as unbreakable spaces;
- *                      the value (taken positive) gives the width.
+ *  set_numbered_char - handle numbered characters.  Negative values are
+ *                      interpreted as unbreakable spaces; the value
+ *                      (taken positive) gives the width.
  */
 
 void html_printer::set_numbered_char(int num, const environment *env,
@@ -4741,12 +4829,12 @@
   glyph *g = number_to_glyph(num);
   int fn = env->fontno;
   if (fn < 0 || fn >= nfonts) {
-    error("bad font position '%1'", fn);
+    error("invalid font position '%1'", fn);
     return;
   }
   font *f = font_tablefn;
   if (f == 0) {
-    error("no font mounted at '%1'", fn);
+    error("no font mounted at position %1", fn);
     return;
   }
   if (!f->contains(g)) {
@@ -4766,29 +4854,28 @@
   set_char(g, f, env, w, 0);
 }
 
-glyph *html_printer::set_char_and_width(const char *nm, const environment *env,
+glyph *html_printer::set_char_and_width(const char *nm,
+					const environment *env,
 					int *widthp, font **f)
 {
   glyph *g = name_to_glyph(nm);
   int fn = env->fontno;
   if (fn < 0 || fn >= nfonts) {
-    error("bad font position '%1'", fn);
+    error("invalid font position '%1'", fn);
     return UNDEFINED_GLYPH;
   }
   *f = font_tablefn;
   if (*f == 0) {
-    error("no font mounted at '%1'", fn);
+    error("no font mounted at position %1", fn);
     return UNDEFINED_GLYPH;
   }
   if (!(*f)->contains(g)) {
     if (nm0 != '\0' && nm1 == '\0')
-      error("font '%1' does not contain ascii character '%2'",
-	    (*f)->get_name(),
-	    nm0);
+      error("font '%1' does not contain ordinary character '%2'",
+	    (*f)->get_name(), nm0);
     else
       error("font '%1' does not contain special character '%2'",
-	    (*f)->get_name(),
-	    nm);
+	    (*f)->get_name(), nm);
     return UNDEFINED_GLYPH;
   }
   int w = (*f)->get_width(g, env->size);
@@ -4827,7 +4914,7 @@
 }
 
 /*
- *  write_rule - emits a html rule tag, if the auto_rule boolean is true.
+ *  write_rule - emits HTML rule element if the auto_rule is TRUE.
  */
 
 static void write_rule (void)
@@ -4844,7 +4931,8 @@
 {
   page_number            =  n;
 #if defined(DEBUGGING)
-  html.begin_comment("Page: ").put_string(i_to_a(page_number)).end_comment();;
+  html.begin_comment("Page: ")
+    .put_string(i_to_a(page_number)).end_comment();;
 #endif
   no_of_printed_pages++;
 
@@ -4874,11 +4962,11 @@
 
 void html_printer::do_body (void)
 {
-  if (background == NULL)
+  if (0 /* nullptr */ == background)
     fputs("<body>\n\n", stdout);
   else {
+    char buf(INT_HEXDIGITS * 3) + 1;
     unsigned int r, g, b;
-    char buf6+1;
 
     background->get_rgb(&r, &g, &b);
     // we have to scale 0..0xFFFF to 0..0xFF
@@ -4908,8 +4996,10 @@
  *                     file fragments.
  */
 
-void html_printer::write_navigation (const string &top, const string &prev,
-				     const string &next, const string &current)
+void html_printer::write_navigation (const string &top,
+				     const string &prev,
+				     const string &next,
+				     const string &current)
 {
   int need_bar = FALSE;
 
@@ -4919,27 +5009,33 @@
     if (groff_sig)
       fputs("\n\n<table width=\"100%\" border=\"0\" rules=\"none\"\n"
 	    "frame=\"void\" cellspacing=\"1\" cellpadding=\"0\">\n"
-	    "<colgroup><col class=\"left\"></col><col class=\"right\"></col></colgroup>\n"
+	    "<colgroup><col class=\"left\"></col>"
+	    "<col class=\"right\"></col></colgroup>\n"
 	    "<tr><td class=\"left\">", stdout);
     handle_valid_flag(FALSE);
     fputs(" ", stdout);
-    if ((strcmp(prev.contents(), "") != 0) && prev != top && prev != current) {
+    if ((strcmp(prev.contents(), "") != 0)
+	&& prev != top
+	&& prev != current) {
       emit_link(prev, "prev");
       need_bar = TRUE;
     }
-    if ((strcmp(next.contents(), "") != 0) && next != top && next != current) {
+    if ((strcmp(next.contents(), "") != 0)
+	&& next != top
+	&& next != current) {
       if (need_bar)
 	fputs(" | ", stdout);
       emit_link(next, "next");
       need_bar = TRUE;
     }
-    if (top != "<standard input>" && (strcmp(top.contents(), "") != 0) && top != current) {
+    if (top != "<standard input>"
+	&& (strcmp(top.contents(), "") != 0)
+	&& top != current) {
       if (need_bar)
 	fputs(" | ", stdout);
       emit_link(top, "top");
     }
     fputs(" \n", stdout);
-
     if (groff_sig) {
       fputs("</td><td class=\"right\"><i><small>"
 	    "This document was produced using "
@@ -4953,13 +5049,11 @@
 }
 
 /*
- *  do_file_components - scan the file list copying each temporary
- *                       file in turn.  This is used twofold:
- *
- *                       firstly to emit section heading links,
- *                       between file fragments if required and
- *                       secondly to generate jobname file fragments
- *                       if required.
+ *  do_file_components - scan the file list copying each temporary file
+ *                       in turn.  This has twofold use: firstly to emit
+ *                       section heading links, between file fragments
+ *                       if required and secondly to generate jobname
+ *                       file fragments if required.
  */
 
 void html_printer::do_file_components (void)
@@ -4985,7 +5079,6 @@
       fatal("fseek on temporary file failed");
     html.copy_file(file_list.get_file());
     fclose(file_list.get_file());
-    
     file_list.move_next();
     if (file_list.is_new_output_file()) {
 #ifdef LONG_FOR_TIME_T
@@ -5003,21 +5096,28 @@
       string split_file = file_list.file_name();
       split_file += '\0';
       fflush(stdout);
-      freopen(split_file.contents(), "w", stdout);
+      if (!freopen(split_file.contents(), "w", stdout)) {
+	fatal("unable to reopen standard output stream: %1",
+	      strerror(errno));
+      }
       fragment_no++;
       if (dialect == xhtml)
 	writeHeadMetaStyle();
 
-      html.begin_comment("Creator     : ")
-	.put_string("groff ")
-	.put_string("version ")
-	.put_string(Version_string)
-	.end_comment();
-
-      t = current_time();
-      html.begin_comment("CreationDate: ")
-	.put_string(ctime(&t), strlen(ctime(&t))-1)
-	.end_comment();
+      if (do_write_creator_comment) {
+	html.begin_comment("Creator     : ")
+	  .put_string("groff ")
+	  .put_string("version ")
+	  .put_string(Version_string)
+	  .end_comment();
+      }
+
+      if (do_write_date_comment) {
+	t = current_time();
+	html.begin_comment("CreationDate: ")
+	  .put_string(ctime(&t), strlen(ctime(&t))-1)
+	  .end_comment();
+      }
 
       if (dialect == html4)
 	writeHeadMetaStyle();
@@ -5036,13 +5136,15 @@
   if (fragment_no > 1)
     write_navigation(top, prev, next, current);
   else {
+    assert(current_paragraph != 0);
     current_paragraph->done_para();
     write_rule();
     if (valid_flag) {
       if (groff_sig)
 	fputs("\n\n<table width=\"100%\" border=\"0\" rules=\"none\"\n"
 	      "frame=\"void\" cellspacing=\"1\" cellpadding=\"0\">\n"
-	      "<colgroup><col class=\"left\"></col><col class=\"right\"></col></colgroup>\n"
+	      "<colgroup><col class=\"left\"></col>"
+	      "<col class=\"right\"></col></colgroup>\n"
 	      "<tr><td class=\"left\">", stdout);
       handle_valid_flag(TRUE);
       if (groff_sig) {
@@ -5066,7 +5168,8 @@
 void html_printer::writeHeadMetaStyle (void)
 {
   if (dialect == html4) {
-    fputs("<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\"\n", stdout);
+    fputs("<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional"
+	  "//EN\"\n", stdout);
     fputs("\"http://www.w3.org/TR/html4/loose.dtd\">\n", stdout);
     fputs("<html>\n", stdout);
     fputs("<head>\n", stdout);
@@ -5074,23 +5177,28 @@
 	  "content=\"groff -Thtml, see www.gnu.org\">\n", stdout);
     fputs("<meta http-equiv=\"Content-Type\" "
 	  "content=\"text/html; charset=US-ASCII\">\n", stdout);
-    fputs("<meta name=\"Content-Style\" content=\"text/css\">\n", stdout);
+    fputs("<meta name=\"Content-Style\" content=\"text/css\">\n",
+	  stdout);
     fputs("<style type=\"text/css\">\n", stdout);
   }
   else {
     fputs("<?xml version=\"1.0\" encoding=\"us-ascii\"?>\n", stdout);
-    fputs("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN\"\n", stdout);
-    fputs(" \"http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd\"\n", stdout);
-    fputs(" <!ENTITY mathml \"http://www.w3.org/1998/Math/MathML\">>\n", stdout);
-
-    fputs("<html xmlns=\"http://www.w3.org/1999/xhtml\" xml:lang=\"en\">\n",
+    fputs("<!DOCTYPE html PUBLIC \"-//W3C//"
+	  "DTD XHTML 1.1 plus MathML 2.0//EN\"\n", stdout);
+    fputs(" \"http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd\"\n",
 	  stdout);
+    fputs(" <!ENTITY mathml \"http://www.w3.org/1998/Math/"
+	  "MathML\">>\n", stdout);
+
+    fputs("<html xmlns=\"http://www.w3.org/1999/xhtml\" "
+	  "xml:lang=\"en\">\n", stdout);
     fputs("<head>\n", stdout);
     fputs("<meta name=\"generator\" "
 	  "content=\"groff -Txhtml, see www.gnu.org\"/>\n", stdout);
     fputs("<meta http-equiv=\"Content-Type\" "
 	  "content=\"text/html; charset=US-ASCII\"/>\n", stdout);
-    fputs("<meta name=\"Content-Style\" content=\"text/css\"/>\n", stdout);
+    fputs("<meta name=\"Content-Style\" content=\"text/css\"/>\n",
+	  stdout);
     fputs("<style type=\"text/css\">\n", stdout);
     fputs("       .center { text-align: center }\n", stdout);
     fputs("       .right  { text-align: right }\n", stdout);
@@ -5121,16 +5229,20 @@
   if (dialect == xhtml)
     writeHeadMetaStyle();
 
-  html.begin_comment("Creator     : ")
-    .put_string("groff ")
-    .put_string("version ")
-    .put_string(Version_string)
-    .end_comment();
-
-  t = current_time();
-  html.begin_comment("CreationDate: ")
-    .put_string(ctime(&t), strlen(ctime(&t))-1)
-    .end_comment();
+  if (do_write_creator_comment) {
+    html.begin_comment("Creator     : ")
+      .put_string("groff ")
+      .put_string("version ")
+      .put_string(Version_string)
+      .end_comment();
+  }
+
+  if (do_write_date_comment) {
+    t = current_time();
+    html.begin_comment("CreationDate: ")
+      .put_string(ctime(&t), strlen(ctime(&t))-1)
+      .end_comment();
+  }
 
   if (dialect == html4)
     writeHeadMetaStyle();
@@ -5145,7 +5257,8 @@
   header.write_headings(stdout, FALSE);
   write_rule();
 #if defined(DEBUGGING)
-  html.begin_comment("Total number of pages: ").put_string(i_to_a(no_of_printed_pages)).end_comment();
+  html.begin_comment("Total number of pages: ")
+    .put_string(i_to_a(no_of_printed_pages)).end_comment();
 #endif
   html.end_line();
   html.end_line();
@@ -5162,13 +5275,13 @@
 }
 
 /*
- *  get_str - returns a dupicate of string, s. The duplicate
+ *  get_str - returns a duplicate of string, s. The duplicate
  *            string is terminated at the next ',' or ''.
  */
 
 static char *get_str (const char *s, char **n)
 {
-  int i=0;
+  int i = 0;
   char *v;
 
   while ((si != (char)0) && (si != ',') && (si != ''))
@@ -5187,16 +5300,16 @@
     (*n) = (char *)&s1;
   else
     (*n) = (char *)s;
-  return NULL;
+  return 0;
 }
 
 /*
- *  make_val - creates a string from if s is NULL.
+ *  make_val - creates a string from if s is a null pointer.
  */
 
 char *make_val (char *s, int v, char *id, char *f, char *l)
 {
-  if (s == NULL) {
+  if (0 /* nullptr */ == s) {
     char buf30;
 
     sprintf(buf, "%d", v);
@@ -5211,12 +5324,12 @@
     while (*t == '=')
       t++;
     if (atoi(t) != v) {
-      if (f == NULL)
+      if (0 /* nullptr */ == f)
 	f = (char *)"stdin";
-      if (l == NULL)
+      if (0 /* nullptr */ == l)
 	l = (char *)"<none>";
-      fprintf(stderr, "%s:%s: grohtml assertion failed at id%s expecting %d and was given %s\n",
-	      f, l, id, v, s);
+      fprintf(stderr, "%s:%s: grohtml assertion failed at id%s; "
+	      "expected %d, got %s\n", f, l, id, v, s);
     }
     return s;
   }
@@ -5224,15 +5337,15 @@
 
 /*
  *  handle_assertion - handles the assertions created via .www:ASSERT
- *                     in www.tmac. See www.tmac for examples.
- *                     This method should be called as we are
- *                     parsing the ditroff input. It checks the x, y
- *                     position assertions. It does _not_ check the
- *                     troff state assertions as these are unknown at this
- *                     point.
+ *                     in www.tmac.  See www.tmac for examples.  This
+ *                     method should be called as we are parsing the
+ *                     ditroff input.  It checks the x, y position
+ *                     assertions.  It does _not_ check the troff state
+ *                     assertions as these are unknown at this point.
  */
 
-void html_printer::handle_assertion (int minv, int minh, int maxv, int maxh, const char *s)
+void html_printer::handle_assertion (int minv, int minh,
+				     int maxv, int maxh, const char *s)
 {
   char *n;
   char *cmd = get_str(s, &n);
@@ -5257,8 +5370,8 @@
 
 void html_printer::handle_state_assertion (text_glob *g)
 {
-  if (g != NULL && g->is_a_tag() &&
-      (strncmp(g->text_string, "assertion:", 11) == 0)) {
+  if (g != 0 && g->is_a_tag()
+      && (strncmp(g->text_string, "assertion:", 11) == 0)) {
     char *n   = (char *)&g->text_string11;
     char *cmd = get_str(n, &n);
     char *val = get_str(n, &n);
@@ -5271,9 +5384,9 @@
 }
 
 /*
- *  special - handle all x X requests from troff. For post-html they
- *            allow users to pass raw html commands, turn auto linked
- *            headings off/on etc.
+ *  special - handle all x X requests from troff.  For post-html they
+ *            allow users to pass raw HTML commands, turn auto linked
+ *            headings off/on, and so forth.
  */
 
 void html_printer::special(char *s, const environment *env, char type)
@@ -5283,8 +5396,8 @@
   if (s != 0) {
     flush_sbuf();
     if (env->fontno >= 0) {
-      style sty(get_font_from_index(env->fontno), env->size, env->height,
-		env->slant, env->fontno, *env->col);
+      style sty(get_font_from_index(env->fontno), env->size,
+		env->height, env->slant, env->fontno, *env->col);
       sbuf_style = sty;
     }
 
@@ -5292,14 +5405,11 @@
       int r=font::res;   /* resolution of the device */
       font *f=sbuf_style.f;
 
-      if (f == NULL) {
-	int found=FALSE;
-
-	f = font::load_font("TR", &found);
-      }
+      if (0 /* nullptr */ == f)
+	f = font::load_font("TR");
 
       /*
-       *  need to pass rest of string through to html output during flush
+       *  pass rest of string through to html output during flush
        */
       page_contents->add_and_encode(&sbuf_style, string(&s5),
 				    line_number,
@@ -5309,9 +5419,8 @@
 
       /*
        * assume that the html command has no width, if it does then
-       * hopefully troff will have fudged this in a macro by
-       * requesting that the formatting move right by the appropriate
-       * amount.
+       * hopefully troff will have fudged this in a macro by requesting
+       * that the formatting move right by the appropriate amount.
        */
     } else if ((strncmp(s, "html</p>:", 9) == 0) ||
 	       (strncmp(s, "html<?p>:", 9) == 0) ||
@@ -5320,11 +5429,8 @@
       font *f=sbuf_style.f;
       string t;
 
-      if (f == NULL) {
-	int found=FALSE;
-
-	f = font::load_font("TR", &found);
-      }
+      if (0 /* nullptr */ == f)
+	f = font::load_font("TR");
 
       if (strncmp(s, "math<?p>:", 9) == 0) {
 	if (strncmp((char *)&s9, "<math>", 6) == 0) {
@@ -5380,8 +5486,8 @@
   if (s != 0) {
     flush_sbuf();
     if (env->fontno >= 0) {
-      style sty(get_font_from_index(env->fontno), env->size, env->height,
-		env->slant, env->fontno, *env->col);
+      style sty(get_font_from_index(env->fontno), env->size,
+		env->height, env->slant, env->fontno, *env->col);
       sbuf_style = sty;
     }
 
@@ -5406,7 +5512,7 @@
   int r = font::hor;
   int n;
 
-  // don't depend on the rounding direction for division of negative integers
+  // don't depend on rounding direction for division of negative ints
   if (r == 1)
     n = x;
   else
@@ -5417,8 +5523,8 @@
 }
 
 /*
- *  handle_valid_flag - emits a valid xhtml 1.1 or html-4.01 button, provided -V
- *                      was supplied on the command line.
+ *  handle_valid_flag - emits a valid XHTML 1.1 or HTML 4.01 button,
+ *                      provided -V was supplied on the command line.
  */
 
 void html_printer::handle_valid_flag (int needs_para)
@@ -5427,15 +5533,15 @@
     if (needs_para)
       fputs("<p>", stdout);
     if (dialect == xhtml)
-      fputs("<a href=\"http://validator.w3.org/check?uri=referer\"><img "
-	    "src=\"http://www.w3.org/Icons/valid-xhtml11-blue\" "
-	    "alt=\"Valid XHTML 1.1 Transitional\" height=\"31\" width=\"88\" /></a>\n",
-	    stdout);
+      fputs("<a href=\"http://validator.w3.org/check?uri=referer\">"
+	    "<img src=\"http://www.w3.org/Icons/valid-xhtml11-blue\" "
+	    "alt=\"Valid XHTML 1.1 Transitional\" "
+	    "height=\"31\" width=\"88\" /></a>\n", stdout);
     else
-      fputs("<a href=\"http://validator.w3.org/check?uri=referer\"><img "
-	    "src=\"http://www.w3.org/Icons/valid-html401-blue\" "
-	    "alt=\"Valid HTML 4.01 Transitional\" height=\"31\" width=\"88\"></a>\n",
-	    stdout);
+      fputs("<a href=\"http://validator.w3.org/check?uri=referer\">"
+	    "<img src=\"http://www.w3.org/Icons/valid-html401-blue\" "
+	    "alt=\"Valid HTML 4.01 Transitional\" "
+	    "height=\"31\" width=\"88\"></a>\n", stdout);
     if (needs_para)
       fputs("</p>", stdout);
   }
@@ -5452,8 +5558,8 @@
     { "version", no_argument, 0, 'v' },
     { NULL, 0, 0, 0 }
   };
-  while ((c = getopt_long(argc, argv, "a:bdD:eF:g:hi:I:j:lno:prs:S:vVx:y",
-			  long_options, NULL))
+  while ((c = getopt_long(argc, argv,
+	  "a:bCdD:eF:g:Ghi:I:j:lno:prs:S:vVx:y", long_options, NULL))
 	 != EOF)
     switch(c) {
     case 'a':
@@ -5464,6 +5570,10 @@
       default_background = new color;
       default_background->set_gray(color::MAX_COLOR_VAL);
       break;
+    case 'C':
+      // Don't write CreationDate HTML comments.
+      do_write_date_comment = FALSE;
+      break;
     case 'd':
       /* handled by pre-html */
       break;
@@ -5479,6 +5589,10 @@
     case 'g':
       /* graphic antialiasing bits - handled by pre-html */
       break;
+    case 'G':
+      // Don't write Creator HTML comments.
+      do_write_creator_comment = FALSE;
+      break;
     case 'h':
       /* do not use the Hn headings of html, but manufacture our own */
       manufacture_headings = TRUE;
@@ -5528,7 +5642,7 @@
       } else if (strcmp(optarg, "4") == 0)
 	dialect = html4;
       else
-	printf("unsupported html dialect %s (defaulting to html4)\n", optarg);
+	warning("unsupported HTML dialect: '%1'", optarg);
       break;
     case 'y':
       groff_sig = TRUE;
@@ -5542,7 +5656,7 @@
       exit(1);
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled getopt_long return value");
     }
   if (optind >= argc) {
     do_file("-");
@@ -5555,6 +5669,16 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -vbelnhVy -D dir -I image_stem -F dir -x x files ...\n",
-	  program_name);
+  fprintf(stream,
+"usage: %s -bCGhlnrVy -F font-directory -j output-stem"
+" -s base-type-size -S heading-level -x html-dialect file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolbp/charset.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolbp/charset.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolbp/grolbp.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolbp/grolbp.1.man Changed

@@ -1,24 +1,20 @@
 '\" t
-.TH GROLBP @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 \
-series laser printers)
+.TH grolbp @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grolbp \-
+.I groff
+output driver for Canon CaPSL printers
 .
 .
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grolbp_C \n.C
-.cp 0
-.
-.
-.\" Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the
-.\" grolbp program.
+.\" Modified from grolj4 man page by Francisco AndrÃ©s VerdÃº
+.\" <pandres@dragonet.es> for the grolbp program.
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1994-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1994-2020 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
@@ -36,19 +32,44 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grolbp_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grolbp
-.OP \-l
-.OP \-c num-copies
-.OP \-F font-directory
-.OP \-o orientation
-.OP \-p paper-size
-.OP \-w width
-.RI  file
-\&.\|.\|.\&
+.RB  \-l 
+.RB  \-c\~\c
+.IR num-copies 
+.RB  \-F\~\c
+.IR font-directory 
+.RB  \-o\~\c
+.IR orientation 
+.RB  \-p\~\c
+.IR paper-format 
+.RB  \-w\~\c
+.IR width 
+.RI  file\~ .\|.\|.
+.
 .SY grolbp
 \c
 .BI \-\-copies= num-copies\c
@@ -61,396 +82,423 @@
  \c
 .BI \-\-orientation= orientation\c
  \c
-.BI \-\-papersize= paper-size\c
+.BI \-\-papersize= paper-format\c
 
-.RI  file
-\&.\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY grolbp
 .B \-h
+.
 .SY grolbp
 .B \-\-help
 .YS
 .
+.
 .SY grolbp
 .B \-v
+.
 .SY grolbp
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B grolbp
-is a driver for
-.B groff
-that produces output in CAPSL and VDM format suitable for Canon LBP-4
-and LBP-8 printers.
-.
-.
-.LP
-For compatibility with
-.BR grolj4 (@MAN1EXT@)
-there is an additional drawing command available:
-.
-.TP
-.BI \eD'R\  dh\ dv '
-Draw a rule
-(i.e., a solid black rectangle),
-with one corner at the current position,
-and the diagonally opposite corner at the current
-position
-.RI +( dh , dv ).
+This GNU
+.I roff
+output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into a CaPSL and VDM format suitable for Canon LBP-4 and LBP-8 printers.
+.
+Normally,
+.I grolbp
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given the
+.RB \lq \-T\~lbp \rq
+option.
+.
+(In this installation,
+.B @DEVICE@
+is the default output device.)
+.
+Use
+.IR groff 's
+.B \-P
+option to pass any options shown above to
+.IR grolbp .
+.
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I grolbp
+reads the standard input stream.
+.
+Output is written to the standard output stream.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SS Typefaces
 .\" ====================================================================
 .
-Note that there can be whitespace between a one-letter option and its
-argument;
-on the other hand, there must be whitespace and/or an equal sign
-(\(oq=\(cq) between a long-name option and its argument.
-.
-.
-.TP
-.BI \-c " num-copies"
-.TQ
-.BI \-\-copies= num-copies
-Print
-.I num-copies
-copies of each page.
+The driver supports the Dutch,
+Swiss,
+and Swiss-Narrow scalable typefaces,
+each in the regular,
+bold,
+italic,
+and bold-italic styles.
+.
+Additionally,
+the bitmapped,
+monospaced Courier and Elite typefaces are available in regular,
+bold,
+and
+italic styles;
+Courier at 8 and 12 points,
+Elite at 8 and 10 points.
 .
+The following chart summarizes the
+.I groff
+font names used to access them.
 .
-.TP
-.BI \-F " font-directory"
-.TQ
-.BI \-\-fontdir= font-directory
-Prepend directory
-.RI font-directory /dev name
-to the search path for font and device description files;
-.I name
-is the name of the device, usually
-.BR lbp .
 .
+.P
+.TS
+tab(|) allbox center;
+Cb Cb Cb Cb Cb
+L L L L L
 .
-.TP
-.B \-h
-.TQ
-.B \-\-help
-Print a short help text.
+Typeface | Roman | Bold | Italic | Bold-Italic
+Dutch | TR | TB | TI | TBI
+Swiss | HR | HB | HI | HBI
+Swiss Narrow | HNR | HNB | HNI | HNBI
+Courier | CR | CB | CI |
+Elite | ER | EB | EI |
+.TE
 .
 .
-.TP
-.B \-l
-.TQ
-.B \-\-landscape
-Print the document with a landscape orientation.
+.\" ====================================================================
+.SS "Paper format, orientation, and device description file"
+.\" ====================================================================
 .
+.I grolbp
+supports paper formats
+.RB \lq A4 \rq,
+.RB \lq letter \rq,
+.RB \lq legal \rq,
+and
+.RB \lq executive \rq.
 .
-.TP
-.BI \-o " orientation"
-.TQ
-.BI \-\-orientation= orientation
-Print the document with
-.I orientation
-orientation, which must be \(oqportrait\(cq or \(oqlandscape\(cq.
+These are matched case-insensitively.
 .
+The
+.BR \-p ,
+.B \-\-papersize
+option overrides any setting in the device description file
+.IR DESC .
 .
-.TP
-.BI \-p " paper-size"
-.TQ
-.BI \-\-papersize= paper-size
-Set the paper size to
-.IR paper-size ,
-which must be a valid paper size description as indicated in section
-\lqPaper Sizes\rq, below.
+If neither specifies a paper format,
+A4 is assumed.
 .
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Print the version number.
+.P
+In its
+.I DESC
+file,
+.I grolbp
+(case-insensitively) recognizes an
+.B orientation
+directive accepting one mandatory argument,
+.B portrait
+or
+.BR landscape .
 .
+The first valid orientation directive encountered controls.
+.\" XXX: This is inconsistent with other description file processing.
 .
-.TP
-.BI \-w " width"
-.TQ
-.BI \-\-linewidth= width
-Set the default line thickness to
-.I width
-thousandths of an em.
+The
+.BR \-l ,
+.BR \-o ,
+and
+.B \-\-orientation
+command-line options
+override any setting in
+.IR DESC .
 .
-If this option isn't specified, the line thickness defaults to 0.04\~em.
+If none of the foregoing specify the orientation,
+portrait is assumed.
 .
 .
 .\" ====================================================================
-.SH TYPEFACES
+.SS "Font description files"
 .\" ====================================================================
 .
-The driver supports the Dutch, Swiss and Swiss-Narrow scalable
-typefaces, each one in the Regular, Bold, Italic and Bold-Italic styles.
-.
-Additionally, the Courier and Elite monospaced typefaces at the sizes 8
-and 12 points (for Courier) resp.\& 8 and 10 points (for Elite) are
-supported, each one in the Regular, Bold and Italic styles.
+In addition to the font description file directives documented in
+.MR groff_font @MAN5EXT@ ,
+.I grolbp
+recognizes
+.BR lbpname ,
+which maps the
+.I groff
+font name to the font name used internally by the printer.
 .
+Its syntax is as follows.
+.RS
+.EX
+.RI lbpname\~ printer-font-name
+.EE
+.RE
 .
-.PP
-The following chart summarizes the font names you can use to access
-these fonts:
 .
+.BR lbpname 's
+argument is case-sensitive.
 .
-.PP
-.TS
-tab(|) allbox center;
-c c c c c
-ab c c c c
+The printer's font names are encoded as follows.
 .
-Typeface | Regular | Bold | Italic | Bold-Italic
-Dutch | TR | TB | TI | TBI
-Swiss | HR | HB | HI | HBI
-Swiss Narrow | HNR | HNB | HNI | HNBI
-Courier | CR | CB | CI |
-Elite | ER | EB | EI |
-.TE
 .
+.P
+For bitmapped fonts,
+.I printer-font_name
+has the form
+.RS
+.EX
+.RI N\la base-font-name \ra\la font-style \ra
+.EE
+.RE
+.I base-font-name
+is the font name as it appears in the printer's font listings without
+the first letter,
+up to
+(but not including)
+the font size.
+.
+.I font-style
+can be one of the letters
+.BR R ,
+.BR I ,
+or
+.BR B ,
+.\" The bold-italic style apparently was not supported for bitmap fonts.
+indicating the roman,
+italic,
+and bold styles,
+respectively.
+.
+For instance,
+if the printer's \lqfont listing A\rq
+shows \lqNelite12I.ISO_USA\rq,
+the corresponding entry in the
+.I groff
+font description file is
+.RS
+.EX
+lbpname NeliteI
+.EE
+.RE
 .
-.\" ====================================================================
-.SH PAPER SIZES
-.\" ====================================================================
+You may need to modify
+.I grolbp
+to add support for new bitmapped fonts,
+since the available font names and font sizes of bitmapped fonts
+(as documented above)
+are hard-coded into the program.
 .
-The paper size can be set in the
-.I DESC
-file or with command-line options to
-.BR grolbp .
-If the paper size is specified both ways, the command-line options take
-precedence over the contents of the
-.I DESC
-file (this applies to the page orientation too).
 .
+.P
+For scalable fonts,
+.I printer-font-name
+is identical to the font name as it appears in the printer's \lqfont
+listing A\rq.
+.
+For instance,
+to select the \lqSwiss\rq font in bold-italic style,
+which appears in the font listing
+as \%\lqSwiss\-BoldOblique\rq,
+.RS
+.EX
+lbpname Swiss\-BoldOblique
+.EE
+.RE
+is the required directive,
+and this is what we find in the
+.I groff
+font description file
+.I HBI
+for the
+.B lbp
+device.
 .
-.PP
-See
-.BR groff_font (@MAN5EXT@)
-how to set the paper dimensions in the
-.I DESC
-file.
 .
+.\" ====================================================================
+.SS "Drawing commands"
+.\" ====================================================================
 .
-.PP
-To set the paper size in the command line, add
-.sp 1
-.in +2m
-.BI \-p \ paper-size
-.in -2m
-.sp 1
-or
-.sp 1
-.in +2m
-.BI \-\-papersize= paper-size
-.in -2m
-.sp 1
-to the other
-.B grolbp
-options, where
-.I paper-size
-is in the same format as in the
-.I DESC
-file.
+For compatibility with
+.MR grolj4 @MAN1EXT@ ,
+an additional drawing command is available.
 .
 .
-.PP
-If no paper size is specified in the
-.I DESC
-file or the command line, a default size of A4 is used.
+.TP
+.BI \rsD\aqR\~ "dh dv" \aq
+Draw a rule
+(solid black rectangle)
+with one corner at the drawing position,
+and the diagonally opposite corner at the drawing position
+.RI +( dh , dv ).
+.\" XXX , at which the drawing position will be afterward. ?
 .
 .
 .\" ====================================================================
-.SH PAGE ORIENTATION
+.SH Options
 .\" ====================================================================
 .
-As with the page size, the orientation of the printed page
-.RB ( portrait
-or
-.BR landscape )
-can be set in the
-.I DESC
-file or with command-line options.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
-It is also case insensitive.
 .
+.TP
+.BI \-c " num-copies"
+.TQ
+.BI \-\-copies= num-copies
+Produce
+.I num-copies
+copies of each page.
 .
-.PP
-To set the orientation in the
-.I DESC
-file, insert a line with the following content:
-.sp 1
-.in +2m
-.B orientation
-.RB  portrait | landscape 
-.in -2m
-.sp 1
 .
-Only the first valid orientation command in the
-.I DESC
-file is used.
+.TP
+.BI \-F " font-directory"
+.TQ
+.BI \-\-fontdir= font-directory
+Prepend directory
+.RI font-directory /dev name
+to the search path for font and device description files;
+.I name
+is the name of the device,
+usually
+.BR lbp .
 .
 .
-.PP
-To set the page orientation with command-line options you can use the
-.B \-o
-or
-.B \-\-orientation
-option with the same parameters
-.RB ( portrait
-or
-.BR landscape )
-as in the
-.I DESC
-file.
-Or you can use the
+.TP
 .B \-l
-option to force the pages to be printed in landscape.
-.
+.TQ
+.B \-\-landscape
+Format the document in landscape orientation.
 .
-.\" ====================================================================
-.SH FONT FILE FORMAT
-.\" ====================================================================
 .
-In addition to the usual commands described in
-.BR groff_font (@MAN5EXT@),
-.B grolbp
-provides the command
-.I lbpname
-which sets the font name sent to the printer when requesting this font.
-.
-The syntax of this command is:
-.sp 1
-.in +2m
-.B lbpname
-.I printer_font_name
-.in -2m
-.
-.IP \(bu
-For bitmapped fonts,
-.I printer_font_name
-has the form
-.sp 1
-.in +2m
-.RI N\(la base_fontname \(ra\(la font_style \(ra
-.in -2m
-.sp 1
-.I base_fontname
-is the font name as it appears in the printers font listings without the
-first letter, up to (but not including) the font size.
-.I font_style
-can be one of the letters
-.BR R ,
-.BR I ,
+.TP
+.BI \-o " orientation"
+.TQ
+.BI \-\-orientation= orientation
+Format the document in the given
+.IR orientation ,
+which must be
+.RB \%\lq portrait \rq
 or
-.BR B ,
-indicating the font styles Roman, Italic and Bold respectively.
+.RB \%\lq landscape \rq.
 .
-.IP
-For instance, if the printer's
-.I font listing A
-shows font \(oqNelite12I.ISO_USA\(cq, the corresponding entry in the
-font description file is
-.sp 1
-.in +2m
-.B lbpname NeliteI
-.in -2m
-.
-.IP
-Note that you may need to modify
-.B grolbp
-to add support for new bitmapped fonts, since the available font names
-and font sizes of bitmapped fonts (as documented above) are hard-coded
-into the program.
-.
-.IP \(bu
-For scalable fonts,
-.I printer_font_name
-is identical to the font name as it appears in the printer's
-.IR "font listing A" .
-.
-.IP
-For instance, to select the \(oqSwiss\(cq font in bold style, which
-appears in the printer's
-.I font listing A
-as \(oqSwiss-Bold\(cq, the required
-.B lbpname
-command line is
-.sp 1
-.in +2m
-.B lbpname Swiss-Bold
-.in -2m
-.sp 1
-.
-.PP
-The argument of
-.B lbpname
-is case sensitive.
+.
+.TP
+.BI \-p " paper-format"
+.TQ
+.BI \-\-papersize= paper-format
+Set the paper format to
+.IR paper-format ,
+which must be a valid paper format as described above.
+.
+.
+.TP
+.BI \-w " width"
+.TQ
+.BI \-\-linewidth= width
+Set the default line thickness to
+.I width
+thousandths of an em;
+the default is
+.B 40
+(0.04\~em).
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+lists directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.MR groff_font @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devlbp/DESC
-Device description file.
+.I @FONTDIR@/\:\%devlbp/\:DESC
+describes the
+.B lbp
+output device.
+.
 .
 .TP
-.IR @FONTDIR@/devlbp/ F
-Font description file for font
-.IR F .
+.IR @FONTDIR@/\:\%devlbp/ F
+describes the font known
+.RI as\~ F
+on device
+.BR lbp .
+.
 .
 .TP
-.I @MACRODIR@/lbp.tmac
-Macros for use with
-.BR grolbp .
+.I @MACRODIR@/\:lbp\:.tmac
+defines macros for use with the
+.B lbp
+output device.
+.
+It is automatically loaded by
+.I troffrc
+when the
+.B lbp
+output device is selected.
 .
 .
 .\" ====================================================================
-.SH SEE ALSO
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@)
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_char @MAN7EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngrolbp_C
+.cp \n*groff_grolbp_1_man_C
+.do rr *groff_grolbp_1_man_C
 .
 .
-.\"
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolbp/grolbp.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolbp/grolbp.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolbp/lbp.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolbp/lbp.cpp Changed

@@ -1,7 +1,6 @@
-// -*- C++ -*-
-/* Copyright (C) 1994-2018 Free Software Foundation, Inc.
-     Written by Francisco Andrés Verdú <pandres@dragonet.es> with many ideas
-     taken from the other groff drivers.
+/* Copyright (C) 1994-2020 Free Software Foundation, Inc.
+     Written by Francisco Andrés Verdú <pandres@dragonet.es> with many
+     ideas taken from the other groff drivers.
 
 This file is part of groff.
 
@@ -24,6 +23,8 @@
  - Add X command to include bitmaps
 */
 
+#include <assert.h>
+
 #include "driver.h"
 #include "lbp.h"
 #include "charset.h"
@@ -33,11 +34,14 @@
 
 extern "C" const char *Version_string;
 
-static int user_papersize = -1;		// papersize
-static int orientation = -1;		// orientation
-static double user_paperlength = 0;	// Custom Paper size
+static int user_papersize = -1;
+static int orientation = -1;
+
+// custom paper format
+static double user_paperlength = 0;
 static double user_paperwidth = 0;
-static int ncopies = 1;			// Number of copies
+
+static int ncopies = 1;
 
 #define DEFAULT_LINEWIDTH_FACTOR 40	// 0.04em
 static int linewidth_factor = DEFAULT_LINEWIDTH_FACTOR;
@@ -83,8 +87,9 @@
   unsigned short cur_symbol_set;
   int line_thickness;
   int req_linethickness; // requested line thickness
+  // custom paper format
   int papersize;
-  int paperlength;	// custom paper size
+  int paperlength;
   int paperwidth;
 };
 
@@ -154,10 +159,10 @@
   lbpputs("\033c\033;\0332&z\0337 I\033?32h\033?33h\03311h");
   wp54charset(); // Define the new symbol set
   lbpputs("\0337 I\033?32h\033?33h\03311h");
-  // Paper size handling
+  // Paper format handling
   if (orientation < 0)
     orientation = 0;	// Default orientation is portrait
-  papersize = 14;	// Default paper size is A4
+  papersize = 14;	// Default paper format is A4
   if (font::papersize) {
     papersize = set_papersize(font::papersize);
     paperlength = font::paperlength;
@@ -570,15 +575,15 @@
 static int set_papersize(const char *paperformat)
 {
   unsigned int i;
-  // First test for a standard (i.e. supported directly by the printer)
-  // paper size
+  // First, test for a standard (i.e. supported directly by the printer)
+  // paper format.
   for (i = 0 ; i < sizeof(lbp_papersizes) / sizeof(lbp_papersizes0); i++)
   {
     if (strcasecmp(lbp_papersizesi.name,paperformat) == 0)
       return lbp_papersizesi.code;
   }
-  // Otherwise, we assume a custom paper size
-  return 82;
+  // Otherwise, we assume a custom paper format.
+  return 82; // XXX: magic number
 }
 
 static void handle_unknown_desc_command(const char *command, const char *arg,
@@ -621,18 +626,20 @@
 static void usage(FILE *stream)
 {
   fprintf(stream,
-	  "usage: %s -lvh -c n -p paper_size -F dir -o or\n"
-	  "       -w width files ...\n"
-	  "\n"
-	  "  -o --orientation=portrait|landscape\n"
-	  "  -v --version\n"
-	  "  -c --copies=numcopies\n"
-	  "  -l --landscape\n"
-	  "  -p --papersize=paper_size\n"
-	  "  -w --linewidth=width\n"
-	  "  -F --fontdir=dir\n"
-	  "  -h --help\n",
-	  program_name);
+"usage: %s -l -c num-copies -F font-directory -o orientation"
+" -p paper-format -w width file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n",
+	  program_name, program_name, program_name);
+  if (stdout == stream) {
+    fputs(
+"\n"
+"Translate the output of troff(1) into a CaPSL and VDM format suitable"
+"\n"
+"for Canon LBP-4 and LBP-8 printers.  See the grolbp(1) manual page.\n",
+	  stream);
+    exit(EXIT_SUCCESS);
+  }
 }
 
 int main(int argc, char **argv)
@@ -641,11 +648,11 @@
     program_name = strsave(argv0);
   font::set_unknown_desc_command_handler(handle_unknown_desc_command);
   // command line parsing
-  int c = 0;
+  int c;
   int option_index = 0;
-  while (c >= 0) {
-    c = getopt_long (argc, argv, "c:F:hI:lo:p:vw:",
-		     long_options, &option_index);
+  while ((c = getopt_long(argc, argv, "c:F:hI:lo:p:vw:", long_options,
+			  &option_index))
+	 != EOF) {
     switch (c) {
     case 'F':
       font::command_line_font_dir(optarg);
@@ -658,7 +665,7 @@
 	const char *s;
 	if (!font::scan_papersize(optarg, &s,
 				  &user_paperlength, &user_paperwidth))
-	  error("invalid paper size '%1' ignored", optarg);
+	  error("ignoring invalid paper format '%1'", optarg);
 	else
 	  user_papersize = set_papersize(s);
 	break;
@@ -668,7 +675,7 @@
       break;
     case 'v':
       printf("GNU grolbp (groff) version %s\n", Version_string);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case 'o':
       if (strcasecmp(optarg, "portrait") == 0)
@@ -706,12 +713,13 @@
       }
     case 'h':
       usage(stdout);
-      exit(0);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(EXIT_FAILURE);
       break;
+    default:
+      assert(0 == "unhandled getopt_long return value");
     }
   }
   if (optind >= argc)
@@ -722,3 +730,9 @@
     lbpputs("\033c\033<");
   return 0;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolbp/lbp.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolbp/lbp.h Changed

@@ -1,5 +1,5 @@
 // -*- C -*-
-/* Copyright (C) 1994-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1994-2020 Free Software Foundation, Inc.
      Written by Francisco Andrés Verdú <pandres@dragonet.es>
 
 groff is free software; you can redistribute it and/or modify it under
@@ -15,7 +15,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-/*  This file contains a set of utility functions to use canon CAPSL printers
+/*  This file contains a set of utility functions to use canon CaPSL printers
  *  (lbp-4 and lbp-8 series printers) */
 
 #ifndef LBP_H
@@ -346,8 +346,8 @@
 
 
 /************************************************************************
- *		Highter level auxiliary functions			*
- ************************************************************************/		
+ *		Higher level auxiliary functions			*
+ ************************************************************************/
 static inline int
 vdminited()
 {

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolj4/grolj4.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolj4/grolj4.1.man Changed

@@ -1,13 +1,15 @@
-.TH GROLJ4 @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grolj4 \- groff driver for HP LaserJet 4 family
+.TH grolj4 @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grolj4 \-
+.I groff
+output driver for HP LaserJet 4 and compatible printers
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1994-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1994-2020, 2022 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
@@ -25,112 +27,748 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grolj4_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.\" This macro definition is poor style from a portability standpoint,
+.\" but it's a good test and demonstration of the standard font
+.\" repertoire for the devices where it has any effect at all, and so
+.\" should be retained.
+.de FT
+.  if '\\*(.T'lj4' .ft \\$1
+..
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grolj4
-.OP \-l
-.OP \-c num-copies
+.RB  \-l 
+.RB  \-c\~\c
+.IR num-copies 
 .RB  \-d
 .RI  n 
-.OP \-F font-directory
-.OP \-p paper-size
-.OP \-w line-width
-.RI  file
-\&.\|.\|.\&
+.RB  \-F\~\c
+.IR font-directory 
+.RB  \-p\~\c
+.IR paper-format 
+.RB  \-w\~\c
+.IR line-width 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY grolj4
 .B \-\-help
 .YS
 .
+.
 .SY grolj4
 .B \-v
+.
 .SY grolj4
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B grolj4
-is a driver for
-.B groff
-that produces output in PCL5 format suitable for an HP LaserJet 4
-printer.
+This GNU
+.I roff
+output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into a PCL5 format suitable for an HP LaserJet 4 printer.
+.
+Normally,
+.I grolj4
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given the
+.RB \lq \-T\~lj4 \rq
+option.
+.
+(In this installation,
+.B @DEVICE@
+is the default output device.)
+.
+Use
+.IR groff 's
+.B \-P
+option to pass any options shown above to
+.IR grolj4 .
+.
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I grolj4
+reads the standard input stream.
+.
+Output is written to the standard output stream.
+.
 .
+.\" ====================================================================
+.SS Typefaces
+.\" ====================================================================
 .
-.LP
-There is an additional drawing command available:
+.I grolj4
+supports the standard four styles:
+.B R
+(roman),
+.B I
+.RI ( italic ),
+.B B
+.RB ( bold ),
+and
+.B BI
+(\fBIbold-italic\f).
+.
+Fonts are grouped into families
+.BR A ,
+.BR C ,
+.BR G ,
+.BR O ,
+.BR T ,
+.BR TN ,
+.BR U ,
+and
+.B UC
+having members in each style.
 .
-.TP
-.BI \eD'R\  dh\ dv '
-Draw a rule (solid black rectangle), with one corner at the current
-position, and the diagonally opposite corner at the current position
-.RI +( dh , dv ).
 .
-Afterwards the current position will be at the opposite corner.
+.RS
+.TP 14n
+.B AB
+.FT AB
+Arial Bold
+.FT
 .
-This generates a PCL fill rectangle command, and so will work on
-printers that do not support HPGL/2 unlike the other
-.B \eD
-commands.
+.TQ
+.B ABI
+.FT ABI
+Arial Bold Italic
+.FT
+.
+.TQ
+.B AI
+.FT AI
+Arial Italic
+.FT
+.
+.TQ
+.B AR
+.FT AR
+Arial Roman
+.FT
+.
+.TQ
+.B CB
+.FT CB
+Courier Bold
+.FT
+.
+.TQ
+.B CBI
+.FT CBI
+Courier Bold Italic
+.FT
+.
+.TQ
+.B CI
+.FT CI
+Courier Italic
+.FT
+.
+.TQ
+.B CR
+.FT CR
+Courier Roman
+.FT
+.
+.TQ
+.B GB
+.FT GB
+Garamond Halbfett
+.FT
+.
+.TQ
+.B GBI
+.FT GBI
+Garamond Kursiv Halbfett
+.FT
+.
+.TQ
+.B GI
+.FT GI
+Garamond Kursiv
+.FT
+.
+.TQ
+.B GR
+.FT GR
+Garamond Antiqua
+.FT
+.
+.TQ
+.B OB
+.FT OB
+CG Omega Bold
+.FT
+.
+.TQ
+.B OBI
+.FT OBI
+CG Omega Bold Italic
+.FT
+.
+.TQ
+.B OI
+.FT OI
+CG Omega Italic
+.FT
+.
+.TQ
+.B OR
+.FT OR
+CG Omega Roman
+.
+.TQ
+.B OB
+.FT OB
+CG Omega Bold
+.FT
+.
+.TQ
+.B OBI
+.FT OBI
+CG Omega Bold Italic
+.FT
+.
+.TQ
+.B OI
+.FT OI
+CG Omega Italic
+.FT
+.
+.TQ
+.B OR
+.FT OR
+CG Omega Roman
+.FT
+.
+.TQ
+.B TB
+.FT TB
+CG Times Bold
+.FT
+.
+.TQ
+.B TBI
+.FT TBI
+CG Times Bold Italic
+.FT
+.
+.TQ
+.B TI
+.FT TI
+CG Times Italic
+.FT
+.
+.TQ
+.B TR
+.FT TR
+CG Times Roman
+.FT
+.
+.TQ
+.B TNRB
+.FT TNRB
+M Times Bold
+.FT
+.
+.TQ
+.B TNRBI
+.FT TNRBI
+M Times Bold Italic
+.FT
+.
+.TQ
+.B TNRI
+.FT TNRI
+M Times Italic
+.FT
+.
+.TQ
+.B TNRR
+.FT TNRR
+M Times Roman
+.FT
+.
+.TQ
+.B UB
+.FT UB
+Univers Bold
+.FT
+.
+.TQ
+.B UBI
+.FT UBI
+Univers Bold Italic
+.FT
+.
+.TQ
+.B UI
+.FT UI
+Univers Medium Italic
+.FT
+.
+.TQ
+.B UR
+.FT UR
+Univers Medium
+.FT
+.
+.TQ
+.B UCB
+.FT UCB
+Univers Condensed Bold
+.FT
+.
+.TQ
+.B UCBI
+.FT UCBI
+Univers Condensed Bold Italic
+.FT
+.
+.TQ
+.B UCI
+.FT UCI
+Univers Condensed Medium Italic
+.FT
+.
+.TQ
+.B UCR
+.FT UCR
+Univers Condensed Medium
+.FT
+.RE
+.
+.
+.P
+The following fonts are not members of a family.
+.
+.
+.RS
+.TP 14n
+.B ALBB
+.FT ALBB
+Albertus Extra Bold
+.FT
+.
+.TQ
+.B ALBR
+.FT ALBR
+Albertus Medium
+.FT
+.
+.TQ
+.B AOB
+.FT AOB
+Antique Olive Bold
+.
+.TQ
+.B AOI
+.FT AOI
+Antique Olive Italic
+.
+.TQ
+.B AOR
+.FT AOR
+Antique Olive Roman
+.
+.TQ
+.B CLARENDON
+.FT CLARENDON
+Clarendon
+.
+.TQ
+.B CORONET
+.FT CORONET
+Coronet
+.
+.TQ
+.B LGB
+.FT LGB
+Letter Gothic Bold
+.
+.TQ
+.B LGI
+.FT LGI
+Letter Gothic Italic
+.
+.TQ
+.B LGR
+.FT LGR
+Letter Gothic Roman
+.
+.TQ
+.B MARIGOLD
+.FT MARIGOLD
+Marigold
+.RE
+.
+.
+.P
+The special font is
+.B S
+(PostScript Symbol);
+.B SYMBOL
+(M Symbol),
+and
+.B WINGDINGS
+(Wingdings)
+are also available but not mounted by default.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SS "Paper format and device description file"
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.I grolj4
+supports paper formats
+.RB \lq A4 \rq,
+.RB \lq B5 \rq,
+.RB \lq C5 \rq,
+.RB \lq com10 \rq,
+.RB \lq DL \rq,
+.RB \%\lq executive \rq,
+.RB \%\lq legal \rq,
+.RB \%\lq letter \rq,
+and
+.RB \lq monarch \rq.
+.
+These are matched case-insensitively.
+.
+The
+.B \-p
+option overrides any setting in the device description file
+.IR DESC .
+.
+If neither specifies a paper format,
+\lqletter\rq is assumed.
+.
+.
+.\" ====================================================================
+.SS "Font description files"
+.\" ====================================================================
+.
+.I grolj4
+recognizes four font description file directives in addition to those
+documented in
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
-.BI \-c " num-copies"
-Print
-.I num-copies
-copies of each page.
+.BI pclweight\~ n
+Set the stroke weight to
+.IR n ,
+an integer in the range \-7 to +7;
+the default is\~0.
 .
 .
 .TP
-.B \-l
-Print the document with a landscape orientation.
+.BI pclstyle\~ n
+Set the style to
+.IR n ,
+an integer in the range 0 to 32767;
+the default is\~0.
 .
 .
 .TP
-.B \-d\c
-.RI " " n 
-Use duplex mode
-.IR n :
-1\ is long-side binding; 2\ is short-side binding;
-default is\ 1.
+.BI pclproportional\~ n
+Set the proportional spacing Boolean flag to
+.IR n ,
+which can be either 0 or\~1;
+the default is\~0.
 .
 .
 .TP
-.BI \-p " paper-size"
-Set the paper size to
-.IR paper-size ,
-which must be one of
-letter, legal, executive, a4, com10, monarch, c5, b5, dl.
+.BI pcltypeface\~ n
+Set the typeface family to
+.IR n ,
+an integer in the range 0 to 65535;
+the default is\~0.
+.
+.
+.\" ====================================================================
+.SS "Drawing commands"
+.\" ====================================================================
+.
+An additional drawing command is recognized as an extension to those
+documented in
+.MR groff @MAN7EXT@ .
 .
 .
 .TP
+.BI \rsD\aqR\~ "dh dv" \aq
+Draw a rule
+(solid black rectangle)
+with one corner at the drawing position,
+and the diagonally opposite corner at the drawing position
+.RI +( dh , dv ),
+at which the drawing position will be afterward.
+.
+This generates a PCL fill rectangle command,
+and so will work on printers that do not support HP-GL/2,
+unlike the other
+.B \rsD
+commands.
+.
+.
+.\" ====================================================================
+.SS Fonts
+.\" ====================================================================
+.
+Nominally,
+all Hewlett-Packard LaserJet\~\%4-series and newer printers have the
+same internal fonts:
+45 scalable fonts and one bitmapped Lineprinter font.
+.
+The scalable fonts are available in sizes between 0.25 points and 999.75
+points,
+in 0.25-point increments;
+the Lineprinter font is available only in 8.5-point size.
+.
+.
+.P
+The LaserJet font files included with
+.I groff
+assume that all printers since the LaserJet\~4 are identical.
+.
+There are some differences between fonts in the earlier and more recent
+printers,
+however.
+.
+The LaserJet\~4 printer used Agfa Intellifont technology for 35 of the
+internal scalable fonts;
+the remaining 10 scalable fonts were TrueType.
+.
+Beginning with the LaserJet\~\%4000-series printers introduced in 1997,
+all scalable internal fonts have been TrueType.
+.
+The number of printable glyphs differs slightly between Intellifont and
+TrueType fonts
+(generally,
+the TrueType fonts include more glyphs),
+and
+there are some minor differences in glyph metrics.
+.
+Differences among printer models are described in the
+.I "PCL\~5 Comparison Guide"
+and the
+.I "PCL\~5 Comparison Guide Addendum"
+(for printers introduced since approximately 2001).
+.
+.
+.P
+LaserJet printers reference a glyph by a combination of a 256-glyph
+symbol set and an index within that symbol set.
+.
+Many glyphs appear in more than one symbol set;
+all combinations of symbol set and index that reference the same glyph
+are equivalent.
+.
+For each glyph,
+.MR hpftodit @MAN1EXT@
+searches a list of symbol sets,
+and selects the first set that contains the glyph.
+.
+The printing code generated by
+.I hpftodit
+is an integer that encodes a numerical value for the symbol set in the
+high byte(s),
+and the index in the low byte.
+.
+See
+.MR groff_font @MAN5EXT@
+for a complete description of the font file format;
+symbol sets are described in greater detail in the
+.IR "PCL\~5 Printer Language Technical Reference Manual" .
+.
+.
+.P
+Two of the scalable fonts,
+Symbol and Wingdings,
+are bound to 256-glyph symbol sets;
+the remaining scalable fonts,
+as well as the Lineprinter font,
+support numerous symbol sets,
+sufficient to enable printing of more than 600 glyphs.
+.
+.
+.P
+The metrics generated by
+.I hpftodit
+assume that the
+.I DESC
+file contains values of 1200 for
+.I res
+and 6350 for
+.IR unitwidth ,
+or any combination
+(e.g.,
+2400 and 3175)
+for which
+.IR res \~\tmu\~ unitwidth \~=\~7\|620\|000.
+.
+Although HP PCL\~5 LaserJet printers support an internal resolution of
+7200 units per inch,
+they use a 16-bit signed integer for positioning;
+if
+.B devlj4
+is to support U.S.\& ledger paper (11\~in\~\mu\~17\~in;
+in = inch),
+the maximum usable resolution is 32\|767\~\di\~17,
+or 1927 units per inch,
+which rounds down to 1200 units per inch.
+.
+If the largest required paper dimension is less
+(e.g.,
+8.5\~in\~\mu\~11\~in,
+or A5),
+a greater
+.I res
+(and lesser
+.IR unitwidth )
+can be specified.
+.
+.
+.P
+Font metrics for Intellifont fonts were provided by Tagged Font Metric
+(TFM) files originally developed by Agfa/Compugraphic.
+.
+The TFM files provided for these fonts supported 600+ glyphs and
+contained extensive lists of kerning pairs.
+.
+.
+.P
+To accommodate developers who had become accustomed to TFM files,
+HP also provided TFM files for the 10 TrueType fonts included in the
+LaserJet\~4.
+.
+The TFM files for TrueType fonts generally included less information
+than the Intellifont TFMs,
+supporting fewer glyphs,
+and in most cases,
+providing no kerning information.
+.
+By the time the LaserJet\~4000 printer was introduced,
+most developers had migrated to other means of obtaining font metrics,
+and support for new TFM files was very limited.
+.
+The TFM files provided for the TrueType fonts in the LaserJet\~4000
+support only the Latin 2 (ISO 8859-2) symbol set,
+and include no kerning information;
+consequently,
+they are of little value for any but the most rudimentary documents.
+.
+.
+.P
+Because the Intellifont TFM files contain considerably more information,
+they generally are preferable to the TrueType TFM files even for use
+with the TrueType fonts in the newer printers.
+.
+The metrics for the TrueType fonts are very close,
+though not identical,
+to those for the earlier Intellifont fonts of the same names.
+.
+Although most output using the Intellifont metrics with the newer
+printers is quite acceptable,
+a few glyphs may fail to print as expected.
+.
+The differences in glyph metrics may be particularly noticeable with
+composite parentheses,
+brackets,
+and braces used by
+.MR eqn @MAN1EXT@ .
+.
+A script,
+located in
+.IR @FONTDIR@/\:\%devlj4/\:generate ,
+can be used to adjust the metrics for these glyphs in the special font
+\lqS\rq for use with printers that have all TrueType fonts.
+.
+.
+.P
+At the time HP last supported TFM files,
+only version 1.0 of the Unicode standard was available.
+.
+Consequently,
+many glyphs lacking assigned code points were assigned by HP to the
+Private Use Area (PUA).
+.
+Later versions of the Unicode standard included code points outside the
+PUA for many of these glyphs.
+.
+The HP-supplied TrueType TFM files use the PUA assignments;
+TFM files generated from more recent TrueType font files require the
+later Unicode values to access the same glyphs.
+.
+Consequently,
+two different mapping files may be required:
+one for the HP-supplied TFM files,
+and one for more recent TFM files.
+.
+.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
 .B \-v
-.TQ
+and
 .B \-\-version
-Print the version number.
+show version information;
+all exit afterward.
 .
 .
 .TP
-.BI \-w " line-width"
-Set the default line thickness to
-.I line-width
-thousandths of an em.
+.BI \-c\~ num-copies
+Format
+.I num-copies
+copies of each page.
 .
-If this option isn't specified, the line thickness defaults to
-0.04\~em.
+.
+.TP
+.BR \-d \~\c
+.IR n 
+Use duplex mode
+.IR n :
+1\~is long-side binding (default),
+and 2\~is short-side binding.
 .
 .
 .TP
@@ -139,94 +777,120 @@
 .IR font-directory /dev name
 to the search path for font and device description files;
 .I name
-is the name of the device, usually
+is the name of the device,
+usually
 .BR lj4 .
 .
 .
-.LP
-The following four commands are available additionally in the
-font description files:
-.
-.
-.TP
-.BI pclweight \ N
-The integer value
-.I N
-must be in the range \-7 to +7; default is\~0.
-.
-.
 .TP
-.BI pclstyle \ N
-The integer value
-.I N
-must be in the range 0 to 32767; default is\~0.
+.B \-l
+Format the document in landscape orientation.
 .
 .
 .TP
-.BI pclproportional \ N
-A boolean flag which can be either 0 or\~1; default is\~0.
+.BI \-p " paper-format"
+Set the paper format to
+.IR paper-format ,
+which must be a valid paper format as described above.
 .
 .
 .TP
-.BI pcltypeface \ N
-The integer value
-.I N
-must be in the range 0 to 65535; default is\~0.
+.BI \-w " line-width"
+Set the default line thickness to
+.I line-width
+thousandths of an em;
+the default is
+.B 40
+(0.04\~em).
 .
 .
+.br
+.ne 4v \" Keep section heading and paragraph together.
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+lists directories in which to seek the selected output device's
+directory of device and font description files.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.MR groff_font @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devlj4/DESC
-Device description file.
+.I @FONTDIR@/\:\%devlj4/\:DESC
+describes the
+.B lj4
+output device.
+.
 .
 .TP
-.IR @FONTDIR@/devlj4/ F
-Font description file for font
-.IR F .
+.IR @FONTDIR@/\:\%devlj4/ F
+describes the font known
+.RI as\~ F
+on device
+.BR lj4 .
+.
 .
 .TP
-.I @MACRODIR@/lj4.tmac
-Macros for use with
-.BR grolj4 .
+.I @MACRODIR@/\:lj4\:.tmac
+defines macros for use with the
+.B lj4
+output device.
+.
+It is automatically loaded by
+.I troffrc
+when the
+.B lj4
+output device is selected.
 .
 .
-.SH BUGS
+.\" ====================================================================
+.SH Bugs
+.\" ====================================================================
+.
+.\" XXX: What does this mean?  The period/full stop glyph?  Flyspecks?
 Small dots.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR lj4_font (@MAN5EXT@),
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@)
+.UR http://\:www\:.hp\:.com/\:ctg/\:Manual/\:bpl13210\:.pdf
+.I HP PCL/PJL Reference:
+.I PCL\~5 Printer Language Technical Reference Manual,
+.I Part I
+.UE
+.
+.
+.P
+.MR hpftodit @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_char @MAN7EXT@
+.
+.
+.\" Clean up.
+.rm FT
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_grolj4_1_man_C
+.do rr *groff_grolj4_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolj4/grolj4.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolj4/grolj4.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grolj4/lj4.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grolj4/lj4.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1994-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1994-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -31,6 +30,8 @@
 X command to include bitmap graphics
 */
 
+#include <assert.h>
+
 #include "driver.h"
 #include "nonposix.h"
 
@@ -58,7 +59,7 @@
 static int landscape_flag = 0;
 static int duplex_flag = 0;
 
-// An upper limit on the paper size in centipoints,
+// An upper limit on the paper dimensions in centipoints,
 // used for setting HPGL picture frame.
 #define MAX_PAPER_WIDTH (12*720)
 #define MAX_PAPER_HEIGHT (17*720)
@@ -230,13 +231,13 @@
   if (font::papersize) {
     int n = lookup_paper_size(font::papersize);
     if (n < 0)
-      error("unknown paper size '%1'", font::papersize);
+      error("ignoring invalid paper format '%1'", font::papersize);
     else
       paper_size = n;
   }
   if (ps >= 0)
     paper_size = ps;
-  printf("\033&l%dA"		// paper size
+  printf("\033&l%dA"		// paper format
 	 "\033&l%dO"		// orientation
 	 "\033&l0E",		// no top margin
 	 paper_tablepaper_size.code,
@@ -640,7 +641,7 @@
       {
 	int n = lookup_paper_size(optarg);
 	if (n < 0)
-	  error("unknown paper size '%1'", optarg);
+	  error("ignoring invalid paper format '%1'", font::papersize);
 	else
 	  user_paper_size = n;
 	break;
@@ -700,7 +701,15 @@
 static void usage(FILE *stream)
 {
   fprintf(stream,
-	  "usage: %s -lv -d n -c n -p paper_size\n"
-	  "       -w n -F dir files ...\n",
-	  program_name);
+	  "usage: %s -l -c n -d n -F dir -p paper-format"
+	  " -w n file ...\n"
+	  "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/TODO -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/TODO Changed

@@ -1,14 +1,14 @@
 pspic.tmac
 ----------
 
-Equiv for gropdf is pdfpic (which is dependant on a program
-pdfbb (to extract MediaBox (etc.) from the pdf) which is not written yet!
-Meanwhile you could use \X'pdf: pdfpic filename -L|R|C wid (hgt) (linelen)'
-(-R and -C require a linelen) Wid or hgt may be zero (in which case the same
-scaling as the other axis is used).  The disadvantage of this call (over
-pdfpic macro) is that it is transparent to groff, after placing the image
-the current X/Y position remains what it was, so you need to do your own
-'motion control' (like a .sp) to "step over" the image you just placed.
+Equiv for gropdf is pdfpic (which is dependent on a program pdfbb (to
+extract MediaBox (etc.) from the pdf) which is not written yet!  Meanwhile
+you could use \X'pdf: pdfpic filename -L|R|C wid (hgt) (linelen)' (-R and -C
+require a linelen) Wid or hgt may be zero (in which case the same scaling as
+the other axis is used).  The disadvantage of this call (over pdfpic macro)
+is that it is transparent to groff, after placing the image the current X/Y
+position remains what it was, so you need to do your own 'motion control'
+(like a .sp) to "step over" the image you just placed.
 
 psfig.tmac
 ----------

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/gropdf.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/gropdf.1.man Changed

@@ -1,18 +1,15 @@
-.TH GROPDF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-gropdf \- PDF driver for groff
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr gropdf_C \n.C
-.cp 0
+.TH gropdf @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+gropdf \-
+.I groff
+output driver for Portable Document Format
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2011-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2011-2022 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
@@ -30,85 +27,128 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_gropdf_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" This macro definition is poor style from a portability standpoint,
+.\" but it's a good test and demonstration of the standard font
+.\" repertoire for the devices where it has any effect at all, and so
+.\" should be retained.
 .de FT
 .  if '\\*(.T'ps' .ft \\$1
 .  if '\\*(.T'pdf' .ft \\$1
 ..
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY gropdf
-.OP \-dels
-.OP \-F dir
-.OP \-I dir
-.OP \-p paper-size
-\#.OP \-w n
+.RB  \-dels 
+.RB  \-F\~\c
+.IR font-directory 
+.RB  \-I\~\c
+.IR inclusion-directory 
+.RB  \-p\~\c
+.IR paper-format 
+\#.RB  \-w\~\c
+\#.IR n 
 .RB  \-u
-.RI  cmapfile 
-.OP \-y foundry
-.RI  file
-\&.\|.\|.\&
+.RI  cmap-file 
+.RB  \-y\~\c
+.IR foundry 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
+.SY gropdf
+.B \-\-help
+.YS
+.
+.
 .SY gropdf
 .B \-v
+.
 .SY gropdf
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B gropdf
-translates the output of GNU
-.B troff
-to PDF.
-.
-Normally
-.B gropdf
-should be invoked by using the groff command
-with a
-.B \-Tpdf
+The GNU
+.I roff
+PDF output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into Portable Document Format.
+.
+Normally,
+.I gropdf
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given the
+.RB \lq \-T\~pdf \rq
 option.
 .
-If no files are given,
-.B gropdf
-reads the standard input.
-.
-A filename of
-.B \-
-also causes
-.B gropdf
-to read the standard input.
-.
-PDF output is written to the standard output.
-.
-When
-.B gropdf
-is run by
-.B groff
-options can be passed to
-.B gropdf
-using
-.BR groff 's
+(In this installation,
+.B @DEVICE@
+is the default output device.)
+.
+Use
+.IR groff 's
 .B \-P
-option.
+option to pass any options shown above to
+.IR gropdf .
 .
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I gropdf
+reads the standard input stream.
 .
-.LP
-See section \lqFont Installation\rq below for a guide how to install
+Output is written to the standard output stream.
+.
+.
+.P
+See section \lqFont installation\rq below for a guide to installing
 fonts for
-.BR gropdf .
+.IR gropdf .
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
@@ -121,7 +161,7 @@
 .TP
 .B \-e
 Forces
-.B gropdf
+.I gropdf
 to embed
 .I all
 fonts (even the 14 base PDF fonts).
@@ -137,41 +177,48 @@
 .BR pdf .
 .
 .TP
-.BI \-I " dir"
-This option may be used to add a directory to the search path for
-files named in
-.B \rsX'pdf: pdfpic'
-escape.
-.
-The current directory is always searched first.
+.BI \-I\~ dir
+Search the directory
+.I dir
+for files named in
+.B \rsX\aqpdf: pdfpic\aq
+device control commands.
+.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
+.
+To search the current working directory before others,
+add
+.RB \lq "\-I .\&" \rq
+at the desired place;
+it is otherwise searched last.
 .
-This option may be specified more than once; the directories are then
-searched in the order specified.
-.
-.IP
-No directory search is performed for files with an absolute file name.
 .
 .TP
 .B \-l
 Orient the document in landscape format.
 .
 .TP
-.BI \-p " paper-size"
-Set physical dimension of output medium.
+.BI \-p " paper-format"
+Set the physical dimensions of the output medium.
 .
 This overrides the
 .BR papersize ,
 .BR paperlength ,
 and
 .B paperwidth
-commands in the
+directives in the
 .I DESC
-file; it accepts the same arguments as the
+file;
+it accepts the same arguments as the
 .B papersize
-command.
+directive.
 .
 See
-.BR groff_font (@MAN5EXT@)
+.MR groff_font @MAN5EXT@
 for details.
 .
 .
@@ -186,33 +233,27 @@
 .
 .
 .TP
-.B \-u\c
-.RI " " cmapfile 
-.B Gropdf
+.BR \-u \~\c
+.IR cmap-file 
+.I gropdf
 normally includes a ToUnicode CMap with any font created using
 .I text.enc
 as the encoding file,
 this makes it easier to search for words which contain ligatures.
 .
 You can include your own CMap by specifying a
-.I cmapfile
+.I cmap-file
 or have no CMap at all by omitting the argument.
 .
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Print the version number and exit.
-.
-.
 .\" .TP
 .\" .BI \-w n
 .\" Lines should be drawn using a thickness of
 .\" .IR n \~\c
 .\" thousandths of an em.
 .\" .
-.\" If this option is not given, the line thickness defaults to 0.04\~em.
+.\" If this option is not given, the line thickness defaults to
+.\" 0.04\~em.
 .\" .
 .\" .
 .TP
@@ -221,19 +262,17 @@
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
 The input to
-.B gropdf
+.I gropdf
 must be in the format output by
-.BR @g@troff (@MAN1EXT@).
+.MR @g@troff @MAN1EXT@ .
 .
 This is described in
-.BR groff_out (@MAN5EXT@).
+.MR groff_out @MAN5EXT@ .
 .
-.
-.LP
 In addition, the device and font description files for the device used
 must meet certain requirements:
 .
@@ -246,11 +285,11 @@
 .
 .
 .LP
-The device description file must contain a valid paper size; see
-.BR groff_font (@MAN5EXT@)
-for more information.
+The device description file must contain a valid paper format;
+see
+.MR groff_font @MAN5EXT@ .
 .
-.B gropdf
+.I gropdf
 uses the same Type\~1 Adobe PostScript fonts as the
 .B grops
 device driver.
@@ -268,14 +307,14 @@
 .
 .
 .LP
-.B gropdf
-supports the concept of foundries, that is different versions of basically
-the same font.
+.I gropdf
+supports the concept of foundries,
+that is different versions of basically the same font.
 .
 During install a
 .I Foundry
 file controls where fonts are found and builds
-.B groff
+.I groff
 fonts from the files it discovers on your system.
 .
 .
@@ -301,7 +340,9 @@
 escape sequence in
 .B troff
 to select the character,
-even if the character does not have a groff name.
+even if the character does not have a
+.I groff
+name.
 .
 Every character in the font file must exist in the PostScript font, and
 the widths given in the font file must match the widths used
@@ -310,7 +351,7 @@
 .
 .LP
 Note that
-.B gropdf
+.I gropdf
 is currently only able to display the first 256 glyphs in any font.
 This restriction will be lifted in a later version.
 .
@@ -320,15 +361,15 @@
 .\" .B grops
 .\" is able to display all glyphs in a PostScript font, not only 256.
 .\" .I enc_file
-.\" (or the default encoding if no encoding file specified) just defines the
-.\" order of glyphs for the first 256 characters; all other glyphs are
-.\" accessed with additional encoding vectors which
+.\" (or the default encoding if no encoding file specified) just defines
+.\" the order of glyphs for the first 256 characters;
+.\" all other glyphs are accessed with additional encoding vectors which
 .\" .B grops
 .\" produces on the fly.
 .
 .
 .LP
-.B gropdf
+.I gropdf
 can automatically include the downloadable fonts necessary
 to print the document.
 .
@@ -336,9 +377,9 @@
 .LP
 .
 Any downloadable fonts which should, when required, be included by
-.B gropdf
+.I gropdf
 must be listed in the file
-.IR @FONTDIR@/devpdf/download ;
+.IR @FONTDIR@/\:\%devpdf/\:\%download ;
 this should consist of lines of the form
 .
 .IP
@@ -364,18 +405,20 @@
 allowed);
 .I filename
 is searched for using the same mechanism that is used
-for groff font metric files.
+for
+.I groff
+font metric files.
 .
 The
 .I download
-file itself is also searched for using this mechanism;
-currently, only the first found file in the font path is used.
+file itself is also sought using this mechanism.
 .
-Foundry names are usually a single character (such as \oqU\cq for
-the URW Foundry) or blank for the default foundry.
+Foundry names are usually a single character
+(such as \oqU\cq for the URW foundry)
+or empty for the default foundry.
 .
 This default uses the same fonts as
-.B ghostscript
+.I ghostscript
 uses when it embeds fonts in a PDF file.
 .
 .
@@ -616,10 +659,13 @@
 the SymbolSlanted font (SS) available to PostScript).
 .
 Zapf Dingbats is available as
-.BR ZD ,
-the "hand pointing left" glyph (\rslh) is available since it has
-been defined using the \rsX'pdf: xrev' extension which reverses the
-direction of letters within words.
+.BR ZD ;
+the \lqhand pointing left\rq glyph
+.RB ( \rslh )
+is available since it has been defined using the
+.B \rsX\aqpdf: xrev\aq
+device control command,
+which reverses the direction of letters within words.
 .
 .
 .LP
@@ -629,43 +675,50 @@
 .B \rsM
 is black.
 .
+.
 .LP
-.B gropdf
-understands some of the X\~commands produced using the
-.B \rsX
-escape sequences supported by
-.B grops.
-Specifically, the following is supported.
+.I gropdf
+understands some of the device control commands supported by
+.MR grops 1 .
+.
 .
 .TP
-.B "\rsX'ps: invis'"
+.B \rsX\aqps: invis\aq
 Suppress output.
 .
+.
 .TP
-.B "\rsX'ps: endinvis'"
+.B \rsX\aqps: endinvis\aq
 Stop suppressing output.
 .
+.
 .TP
-.B "\rsX'ps: exec gsave currentpoint 2 copy translate \fIn\fP rotate neg exch neg exch translate'"
+.BI "\rsX\aqps: exec gsave currentpoint 2 copy translate\~" n\~\c
+.B rotate neg exch neg exch translate\aq
 where
 .I n
 is the angle of rotation.
+.
 This is to support the
-.I align
+.B align
 command in
-.BR gpic .
+.MR @g@pic 1 .
+.
 .
 .TP
-.B "\rsX'ps: exec grestore'"
-Again used by
-.B gpic
-to restore after rotation.
+.B \rsX\aqps: exec grestore\aq
+Used by
+.MR @g@pic 1
+to restore state after rotation.
+.
 .
 .TP
-.BI "\rsX'ps: exec " "n " "setlinejoin'"
+.BI "\rsX\aqps: exec " "n\~" "setlinejoin\aq"
 where
 .I n
 can be one of the following values.
+.
+.
 .IP
 0 = Miter join
 .br
@@ -673,11 +726,14 @@
 .br
 2 = Bevel join
 .
+.
 .TP
-.BI "\rsX'ps: exec " "n " "setlinecap'"
+.BI "\rsX\aqps: exec " "n " "setlinecap\aq"
 where
 .I n
 can be one of the following values.
+.
+.
 .IP
 0 = Butt cap
 .br
@@ -688,7 +744,7 @@
 .
 .LP
 .TP
-.B "\rsX'ps: ... pdfmark'"
+.BR "\rsX\aqps:\~" .\|.\|.\& "\~pdfmark\aq"
 All the
 .I pdfmark
 macros installed by using
@@ -700,13 +756,19 @@
 .
 A subset of these macros are installed automatically when you use
 .B \-Tpdf
-so you should not need to use \oq\-m pdfmark\cq for using most of
-the PDF functionality.
+so you should not need to use
+.RB \lq "\-m pdfmark" \rq
+to access most PDF functionality.
+.
 .
 .LP
-.B gropdf
-also supports a subset of the commands introduced in present.tmac.
+.I gropdf
+also supports a subset of the commands introduced in
+.IR present.tmac .
+.
 Specifically it supports:-
+.
+.
 .IP
 PAUSE
 .br
@@ -714,48 +776,69 @@
 .br
 BLOCKE
 .
+.
 .LP
 Which allows you to create presentation type PDFs.
+.
 Many of the other
 commands are already available in other macro packages.
+.
+.
 .LP
 These commands are implemented with
-.B groff
+.I groff
 X commands:-
+.
+.
 .LP
 .TP
-.B "\rsX'ps: exec %%%%PAUSE"
-The section before this is treated as a block and is introduced using the
-current BLOCK transition setting (see \oqpdf: transition\cq below).
-This command
-can be introduced using the macro
-.BR .pdfpause .
+.B \rsX\aqps: exec %%%%PAUSE\aq
+The section before this is treated as a block and is introduced using
+the current
+.B BLOCK
+transition setting
+(see
+.RB \lq "\rsX\aqpdf: transition\aq" \rq
+below).
+.
+Equivalently,
+.B \%.pdfpause
+is available as a macro.
 .TP
-.B "\rsX'ps: exec %%%%BEGINONCE"
+.B \rsX\aqps: exec %%%%BEGINONCE\aq
 Any text following this command (up to %%%%ENDONCE) is shown only once,
 the next %%%%PAUSE will remove it.
-If producing a non presentation pdf, i.e.\&
+If producing a non-presentation PDF, i.e.\&
 ignoring the pauses, see
 .I \%GROPDF_NOSLIDE
 below, this text is ignored.
 .LP
 .TP
-.B "\rsX'ps: exec %%%%ENDONCE"
+.B \rsX\aqps: exec %%%%ENDONCE\aq
 This terminates the block defined by %%%%BEGINONCE.
 This pair of commands
-is what implements the .BLOCKS Once/.BLOCKE commands in present.tmac.
+is what implements the \&.BLOCKS Once/.BLOCKE commands in
+.IR present.tmac .
+.
+.
 .LP
 The
-.B mom
-macro set already has integration with these extensions so you can build
-slides with
-.BR mom .
+.I mom
+macro package already integrates these extensions,
+so you can build slides with
+.IR mom .
+.
+.
 .LP
-If you use present.tmac with
-.B gropdf
+If you use
+.I present.tmac
+with
+.I gropdf
 there is no need to run the program
-.BR presentps (@MAN1EXT@)
-since the output will already be a presentation pdf.
+.MR presentps @MAN1EXT@
+since the output will already be a presentation PDF.
+.
+.
 .LP
 All other
 .B ps:
@@ -765,38 +848,42 @@
 .LP
 One
 .B \rsX
-special used by the DVI driver is also recognised:
+device control command used by the DVI driver is also recognised.
+.
 .
 .TP
-.BI \rsX'papersize= paper-size '
+.BI \rsX\aqpapersize= paper-format \aq
 where the
-.I paper-size
-parameter is the same as the
+.I paper-format
+parameter is the same as that to the
 .B papersize
-command.
+directive.
 .
 See
-.BR groff_font (@MAN5EXT@)
-for details.
+.MR groff_font @MAN5EXT@ .
 .
 This means that you can alter the page size at will within the PDF file
 being created by
-.BR gropdf .
+.IR gropdf .
+.
+If you do want to change the paper format,
+it must be done before you start creating the page.
 .
-If you do want to change the paper size, it must be done before you start
-creating the page.
 .
 .LP
-In addition,
-.B gropdf
-supports its own suite of
+.I gropdf
+supports several more device control features using the
 .B pdf:
-tags.
+tag.
+.
+Some have counterpart
+.I convenience macros
+that take the same arguments and behave equivalently.
 .
-The following tags are supported:
 .
 .TP
-.BI "\rsX'pdf: pdfpic " "file alignment width height line-length" '
+.BI "\rsX\aqpdf: pdfpic\~" file\~\c
+.IR "alignment width height line-length" \aq
 Place an image of the specified
 .I width
 containing the PDF drawing from file
@@ -813,83 +900,131 @@
 .I alignment
 is
 .B \-L
-the drawing is left aligned.
+the drawing is left-aligned.
 .
 If it is
 .B \-C
 or
 .B \-R
 a
-.I linelength
+.I line-length
 greater than the width of the drawing is required as well.
 .
 If
 .I width
-is specified as zero then the width is scaled in proportion to the height.
+is specified as zero then the width is scaled in proportion to the
+height.
 .
 .\" .IP
 .\" See
 .\" .BR groff_tmac (@MAN7EXT@)
 .\" for a description of the
 .\" .B PSPIC
-.\" macro which provides a convenient high-level interface for inclusion of
-.\" PostScript graphics.
+.\" macro which provides a convenient high-level interface for inclusion
+.\" of PostScript graphics.
 .
 .TP
-.B \rsX'pdf: xrev'
-This toggles a flag which reverses the direction of printing
-.IR "letter by letter" ,
-i.e., each separate letter is reversed, not the entire word.
+.B \rsX\aqpdf: xrev\aq
+Toggle the reversal of glyph direction.
 .
-This is useful for reversing the direction of glyphs in the Dingbats font.
+This feature works \lqletter by letter\rq,
+that is,
+each letter in a word is reversed left-to-right,
+not the entire word.
 .
-To return to normal printing repeat the command again.
+One application is the reversal of glyphs in the Zapf Dingbats font.
 .
-.TP
-.BI "\rsX'pdf: markstart " "/ANN definition" '
-The macros which support PDF Bookmarks use this call internally to
-start the definition of bookmark hotspot (user will have called
-\oq.pdfhref\~L\cq with the text which will become the \oqhot
-spot\cq region).
+To restore the normal glyph orientation,
+repeat the command.
 .
-Normally this is never used except from within the pdfmark macros.
 .
 .TP
-.B \rsX'pdf: markend'
-The macros which support PDF Bookmarks use this call internally to
-stop the definition of bookmark hotspot (user will have called
-\oq.pdfhref\~L\cq with the text which will become the \oqhot
-spot\cq region).
+.BI "\rsX\aqpdf: markstart " "/ANN-definition" \aq
+.TQ
+.B \rsX\aqpdf: markend\aq
+Macros that support PDF bookmarks use these calls internally to
+start and stop (respectively) the placement of the bookmark's
+.I hot spot;
+the user will have called
+.RB \lq .pdfhref\~L \rq
+with the text of the hot spot.
+.
+Normally,
+these are never used except from within the
+.I pdfmark
+macros.
 .
-Normally this is never used except from within the pdfmark macros.
 .
 .TP
-.B \rsX'pdf: marksuspend'
+.B \rsX\aqpdf: marksuspend\aq
 .TQ
-.B \rsX'pdf: markrestart'
-If you are using page traps to produce headings, footings, etc., you
-need to use these in case a \oqhot spot\cq crosses a page
-boundary, otherwise any text output by the heading or footing macro
-will be marked as part of the \oqhot spot\cq.
-.
-To stop this happening just place \oq.pdfmarksuspend\cq and
-\oq.pdfmarkrestart\cq at the start and end of the page trap macro,
+.B \rsX\aqpdf: markrestart\aq
+If you use a page location trap to produce a header or footer,
+or otherwise interrupt a document's text,
+you need to use these commands if a PDF
+.I hot spot
+crosses a trap boundary;
+otherwise any text output by the trap will be marked as part of the hot
+spot.
+.
+To prevent this error,
+place these device control commands or their corresponding
+convenience macros
+.B \%.pdfmarksuspend
+and
+.B \%.pdfmarkrestart
+at the start and end of the trap macro,
 respectively.
 .
-(These are just convenience macros which emit the \rsX code.
 .
-These macros must only be used within page traps.)
+.TP
+.BI "\rsX\aqpdf: pagename\~" name \aq
+Assign the current page a
+.IR name .
+.
+All documents bear two default names,
+.RB \oq top "\cq and \oq" bottom \cq.
+.
+The convenience macro for this command is
+.BR \%.pdfpagename .
+.
+.
+.TP
+.BI "\rsX'pdf: switchtopage\~" "when name" \aq
+Normally each new page is appended to the end of the document,
+this command allows following pages to be inserted at a
+.I \oqnamed\cq
+position within the document (see pagename command above).
+.I \oqwhen\cq
+can be either
+.RI \oq after "\cq or \oq" before \cq.
+If it is omitted it defaults to
+.RI \oq before \cq.
+.
+It should be used at the end of the page before you want the switch to
+happen.
+.
+This allows pages such as a TOC to be moved to elsewhere in the
+document,
+but more esoteric uses are possible.
+.
+The convenience macro for this command is
+.BR \%.pdfswitchtopage .
+.
 .
 .TP
-.BR "\rsX'pdf: transition'" "feature mode duration dimension motion direction scale bool"
+.BI \rsX\aqpdf:\~transition\~ feature\~\c
+.IB "mode duration dimension motion direction scale bool" \aq
 where
-.IP
 .I feature
 can be either SLIDE or BLOCK.
 When it is SLIDE the transition is used
-when a new slide is introduced to the screen, if BLOCK then this transition
-is used for the individual blocks which make up the slide.
-.br
+when a new slide is introduced to the screen,
+if BLOCK then this transition is used for the individual blocks which
+make up the slide.
+.
+.
+.IP
 .I mode
 is the transition type between slides:-
 .RS
@@ -910,7 +1045,7 @@
 The lines may be
 either horizontal or vertical, as specified by the
 .I dimension
- entry.
+entry.
 Horizontal
 lines move downward; vertical lines move to the right.
 .br
@@ -930,9 +1065,9 @@
 - The old page dissolves gradually to reveal the new one.
 .br
 .B Glitter
-- Similar to Dissolve, except that the effect sweeps across the page in a
-wide band moving from one side of the screen to the other in the
-direction specified by the
+- Similar to Dissolve,
+except that the effect sweeps across the page in a wide band moving from
+one side of the screen to the other in the direction specified by the
 .I direction
 entry.
 .br
@@ -1014,8 +1149,9 @@
 .BR Cover ,
 .BR Uncover " and " Push
 transition styles only)
-The direction in which the specified transition effect shall moves, expressed in
-degrees counterclockwise starting from a left-to-right direction.
+The direction in which the specified transition effect shall moves,
+expressed in degrees counterclockwise starting from a left-to-right
+direction.
 If the value is a number, it shall be one of:
 .B 0
 = Left to right,
@@ -1077,251 +1213,562 @@
 not all PDF Readers support any or all these transitions.
 .LP
 .
+.
+.TP
+.BI "\eX\aqpdf: background\~" "cmd left top right bottom weight" \aq
+.TQ
+.B "\eX\aqpdf: background off\aq"
+.TQ
+.BI "\eX\aqpdf: background footnote\~" bottom \aq
+produces a background rectangle on the page,
+where
+.RS
+.TP
+.I cmd
+is the command,
+which can be any of
+.RB \lq page | fill | box \rq
+in combination.
+.
+Thus,
+.RB \lq pagefill \rq
+would draw a rectangle which covers the whole current page size
+(in which case the rest of the parameters can be omitted because the box
+dimensions are taken from the current media size).
+.
+.RB \lq boxfill \rq,
+on the other hand,
+requires the given dimensions to place the box.
+.
+Including
+.RB \lq fill \rq
+in the command will paint the rectangle with the current fill colour
+(as with
+.BR \rsM )
+and including
+.RB \lq box \rq
+will give the rectangle a border in the current stroke colour
+(as with
+.BR \rsm ).
+.
+.
+.IP
+.I cmd
+may also be
+.RB \lq off \rq
+on its own,
+which will terminate drawing the current box.
+.
+If you have specified a page colour with
+.RB \lq pagefill \rq,
+it is always the first box in the stack,
+and if you specify it again,
+it will replace the first entry.
+.
+Be aware that the
+.RB \lq  pagefill \rq
+box renders the page opaque,
+so tools that \lqwatermark\rq PDF pages are unlikely to be
+successful.
+.
+To return the background to transparent,
+issue an
+.RB \lq off \rq
+command with no other boxes open.
+.
+.
+.IP
+Finally,
+.I cmd
+may be
+.RB \lq footnote \rq
+followed by a new value for
+.IR bottom ,
+which will be used for all open boxes on the current page.
+This is to allow room for footnote areas that grow while a page is
+processed
+(to accommodate multiple footnotes,
+for instance).
+.
+(If the value is negative,
+it is used as an offset from the bottom of the page.)
+.
+.
+.TP
+.I left
+.TQ
+.I top
+.TQ
+.I right
+.TQ
+.I bottom
+are the coordinates of the box.
+.
+The
+.I top
+and
+.I bottom
+coordinates are the minimum and maximum for the box,
+since the actual start of the box is
+.IR groff 's
+drawing position when you issue the command,
+and the bottom of the box is the point where you turn the box
+.RB \lq off \rq.
+.
+The top and bottom coordinates are used only if the box drawing extends
+onto the next page;
+ordinarily,
+they would be set to the header and footer margins.
+.
+.
+.TP
+.I weight
+provides the line width for the border if
+.RB \lq box \rq
+is included in the command.
+.
+.
+.P
+The convenience macro for this escape sequence is
+.BR .pdfbackground .
+.
+An
+.I sboxes
+macro file is also available;
+see
+.MR groff_tmac @MAN5EXT@ .
+.RE
+.
+.
+.\" ====================================================================
+.SS Macros
+.\" ====================================================================
+.
+.IR gropdf 's
+support macros in
+.I pdf\.tmac
+define the convenience macros described above.
+.
+Some features have no direct device control command counterpart.
+.
+.
+.\" pdfhref
+.
+.
+.TP
+.BI ".pdfinfo /" "field content"\~\c
+\&.\|.\|.
+Define PDF metadata.
+.
+.I field
+may be be one of
+.BR Title ,
+.BR Author ,
+.BR Subject ,
+.BR Keywords ,
+or another datum supported by the PDF standard or your reader.
+.
+.I field
+must be prefixed with a slash.
+.
+.
 .\" ====================================================================
-.SS Importing graphics
+.SS "Importing graphics"
 .\" ====================================================================
 .
-.B gropdf
-only supports importing other PDF files as graphics.
+.I gropdf
+supports only the inclusion of other PDF files for inline images.
 .
-But that PDF file may contain any of the graphic formats supported by
-the PDF standard (such as JPEG, PNG, GIF, etc.).
+Such a PDF file may,
+however,
+contain any of the graphic formats supported by
+the PDF standard,
+such as JPEG/JFIF,
+PNG,
+and GIF.
 .
-So any application which outputs PDF can be used as an embedded file
-in
-.BR gropdf .
+Any application that outputs PDF can thus be used to prepare files for
+embedding in documents processed by
+.I groff
+and
+.IR gropdf .
 .
+.
+.P
 The PDF file you wish to insert must be a single page and the drawing
 must just fit inside the media size of the PDF file.
 .
-So, in
-.BR inkscape (1)
+In
+.MR inkscape 1
 or
-.BR gimp (1)
-(for example) make sure the canvas size just fits the image.
-.
+.MR gimp 1 ,
+for example,
+make sure the canvas size just fits the image.
 .
-.LP
-The PDF parser used in
-.B gropdf
-has not been rigorously tested with all possible applications which
-produce PDFs.
 .
-If you find a single page PDF which fails to import properly, it is
-worth running it through the
+.P
+The PDF parser
+.I gropdf
+implements has not been rigorously tested with all applications that
+produce PDF.
 .
-.BR pdftk (1)
-program by issuing the command:
+If you find a single-page PDF which fails to import properly,
+try processing it with the
+.MR pdftk 1
+program.
 .
 .
 .RS
-.LP
-.B pdftk
-.I oldfile.pdf
-.B output
-.I newfile.pdf
+.EX
+pdftk\~\c
+.I existing-file\~\c
+output\~\c
+.I new-file
+.EE
 .RE
 .
-.
-.LP
 You may find that
-.I newfile.pdf
-will now load successfully.
+.I new-file
+imports successfully.
 .
 .
 .\" ====================================================================
-.SS TrueType and other font formats
+.SS "TrueType and other font formats"
 .\" ====================================================================
 .
-.B gropdf
-does not support any other fonts except Adobe Type 1 (PFA or PFB).
+.I gropdf
+does not yet support any font formats besides Adobe Type 1
+(PFA or PFB).
 .
 .
 .\" ====================================================================
-.SH FONT INSTALLATION
+.SH "Font installation"
 .\" ====================================================================
 .
-This section gives a summary of the above explanations; it can serve
-as a step-by-step font installation guide for
-.BR gropdf .
+The following is a step-by-step font installation guide for
+.I gropdf.
 .
-.ds BU \bu\ \ \"
-.de LI
-.IP "" 4
-\h'-\w'\*BU'u'\*BU\c
-..
-.LI
-Convert your font to something groff understands.
 .
-This is either a PostScript Type\~1 font in either PFA or PFB,
+.IP \bu 2n
+Convert your font to something
+.I groff
+understands.
+.
+This is a PostScript Type\~1 font in PFA or PFB format,
 together with an AFM file.
 .
-.IP
-The very first line in a PFA/PFB file contains this:
+A PFA file begins as follows.
 .
 .RS
-.IP
-.B %!PS\-AdobeFont\-1.0:
-.RE
-.
-.IP
-A PFB file has this also in the first line, but the string is
-preceded with some binary bytes.
-.
-.LI
-Convert the AFM file to a groff font description file with the
-.BR \%afmtodit (@MAN1EXT@)
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+%!PS\-AdobeFont\-1.0:
+.EE
+.RE \" but only one to get back to it
+.
+A PFB file contains this string as well,
+preceded by some non-printing bytes.
+.
+In the following steps,
+we will consider the use of CTAN's
+.UR https://\:ctan.org/\:tex\-archive/\:fonts/\:brushscr
+BrushScriptX-Italic
+.UE
+font in PFA format.
+.RE \" now restore left margin
+.
+.
+.IP \bu
+Convert the AFM file to a
+.I groff
+font description file with the
+.MR afmtodit @MAN1EXT@
 program.
 .
-An example call is
+For instance,
 .
 .RS
-.IP
-afmtodit Foo\-Bar\-Bold.afm map/textmap FBB
-.RE
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+$ \c
+.B afmtodit BrushScriptX\-Italic.afm text.map BSI
+.EE
+.RE \" but only one to get back to it
+.
+converts the Adobe Font Metric file
+.I BrushScriptX\-Italic.afm
+to the
+.I groff
+font description file
+.IR BSI .
+.RE \" now restore left margin
 .
-.IP
-which converts the metric file \oqFoo\-Bar\-Bold.afm\cq to the groff
-font \oqFBB\cq.
 .
-If you have a font family which comes with normal, bold, italic, and
-bold italic faces, it is recommended to use the letters
+.IP
+If you have a font family which provides regular upright (roman),
+bold,
+italic,
+and
+bold-italic styles,
+(where \lqitalic\rq may be \lqoblique\rq or \lqslanted\rq),
+we recommend using
 .BR R ,
 .BR B ,
 .BR I ,
 and
 .BR BI ,
-respectively, as postfixes in the groff font names to make groff's
-\oq.fam\cq request work.
-.
-An example is groff's built-in Times-Roman font: The font family
-name is
+respectively,
+as suffixes to the
+.I groff
+font family name to enable
+.IR groff 's
+font family and style selection features.
+.
+An example is
+.IR groff 's
+built-in support for Times:
+the font family
+name is abbreviated as
 .BR T ,
-and the groff font names are
+and the
+.I groff
+font names are therefore
 .BR TR ,
 .BR TB ,
 .BR TI ,
 and
 .BR TBI .
 .
-.LI
-Install both the groff font description files and the fonts in a
-\oqdevpdf\cq subdirectory of the font path which groff finds.
+In our example,
+however,
+the BrushScriptX font is available in a single style only,
+italic.
 .
-See section \lqEnvironment\rq in
-.BR @g@troff (@MAN1EXT@)
-for the actual value of the font path.
 .
-Note that groff doesn't use the AFM files (but it is a good idea to
-store them anyway).
+.IP \bu
+Install the
+.I groff
+font description file(s) in a
+.I devpdf
+subdirectory in the search path that
+.I groff
+uses for device and font file descriptions.
+.
+See the
+.I GROFF_FONT_PATH
+entry in section \lqEnvironment\rq of
+.MR @g@troff @MAN1EXT@
+for the current value of the font search path.
 .
-.LI
-Register all fonts which must be downloaded to the printer in the
+While
+.I groff
+doesn't directly use AFM files,
+it is a good idea to store them alongside its font description files.
+.
+.
+.IP \bu
+Register fonts in the
 .I devpdf/download
-file.
+file so they can be located for embedding in PDF files
+.I gropdf
+generates.
 .
-Only the first occurrence of this file in the font path is read.
+Only the first
+.I download
+file encountered in the font search path is read.
 .
-This means that you should copy the default
+If in doubt,
+copy the default
 .I download
-file to the first directory in your font path and add your fonts there.
+file
+(see section \lqFiles\rq below)
+to the first directory in the font search path and add your fonts there.
 .
-To continue the above example we assume that the PS font name for
-Foo\-Bar\-Bold.pfa is \oqXY\-Foo\-Bar\-Bold\cq (the PS font name is
-stored in the
+The PostScript font name used by
+.I gropdf
+is stored in the
 .B internalname
 field in the
-.I FBB
-file) and belongs to foundry \oqF\cq
-thus the following line should be added to
-.IR download :
+.I groff
+font description file.
+.
+(This name does not necessarily resemble the font's file name.)
+.
+If the font in our example had originated from a foundry named
+.BR Z ,
+we would add the following line to
+.IR download .
 .
 .RS
-.IP
-.B F XY\-Foo\-Bar\-Bold Foo\-Bar\-Bold.pfa
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+Z\->BrushScriptX\-Italic\->BrushScriptX\-Italic.pfa
+.EE
+.RE \" but only one to get back to it
 .
+A tab character,
+depicted as \->,
+separates the fields.
 .
-.LP
-Use a tab character to separate the fields, and the \oqfoundry\cq
-field should be null for the default foundry.
+The default foundry has no name:
+its field is empty and
+entries corresponding to it start with a tab character,
+as will the one in our example.
+.RE \" now restore left margin
+.
+.
+.IP \bu
+Test the selection and embedding of the new font.
+.
+.RS
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+printf "\rs\rsfBSIHello, world!\rsn" \
+| groff \-T pdf \-P \-e >hello.pdf
+see hello.pdf
+.EE
+.RE
 .RE
 .
 .
+.br
+.ne 5v
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
-If, in the
+If,
+in the
 .I download
 file,
 the font file has been specified with a full path,
 no directories are searched.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
 .I GROPDF_NOSLIDE
-If this is set true,
-.B gropdf
-will ignore all commands which produce a presentation pdf,
-and produce a normal pdf instead.
+If set and evaluates to a true value
+(to Perl),
+.\" XXX: The above is inconsistent with the way grotty(1) handles
+.\" "GROFF_NO_SGR".
+.I gropdf
+ignores commands specific to presentation PDFs,
+producing a normal PDF instead.
+.
+.
 .TP
 .I SOURCE_DATE_EPOCH
-A timestamp (expressed as seconds since the Unix epoch) to use as the
-creation timestamp in place of the current time.
+A timestamp
+(expressed as seconds since the Unix epoch)
+to use as the output creation timestamp in place of the current time.
+.
+The time is converted to human-readable form using Perl's
+.I \%localtime()
+function and recorded in a PDF comment.
+.
+.
+.TP
+.I TZ
+The time zone to use when converting the current time
+(or value of
+.IR SOURCE_DATE_EPOCH )
+to human-readable form;
+see
+.MR tzset 3 .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devpdf/DESC
-Device description file.
+.I @FONTDIR@/\:\%devpdf/\:DESC
+describes the
+.B pdf
+output device.
+.
 .
 .TP
-.IR @FONTDIR@/devpdf/ F
-Font description file for font\~\c
-.IR F .
+.IR @FONTDIR@/\:\%devpdf/ F
+describes the font known
+.RI as\~ F
+on device
+.BR pdf .
+.
 .
 .TP
-.IR @FONTDIR@/devpdf/ U\-F
-Font description file for font\~\c
-.I F
-(using foundry\~\c
-.I U
-rather than the default foundry).
+.IR @FONTDIR@/\:\%devpdf/\:U\- F
+describes the font
+from the URW foundry
+(versus the Adobe default)
+known
+.RI as\~ F
+on device
+.BR pdf .
+.
 .
 .TP
-.I @FONTDIR@/devpdf/download
-List of downloadable fonts.
+.I @FONTDIR@/\:\%devpdf/\%download
+lists fonts available for embedding within the PDF document
+(by analogy to the
+.B ps
+device's downloadable font support).
 .
+.
+.\" XXX: Why are we shipping this but not BuildFoundries.pl?
 .TP
-.I @FONTDIR@/devpdf/Foundry
-A Perl script used during install to locate suitable fonts.
+.I @FONTDIR@/\:\%devpdf/\%Foundry
+is a data file used by the
+.I groff
+build system to locate PostScript Type\~1 fonts.
+.
 .
 .TP
-.I @FONTDIR@/devpdf/enc/text.enc
-Encoding used for text fonts.
+.I @FONTDIR@/\:\%devpdf/\:enc/\:\%text\:.enc
+describes the encoding scheme used by most PostScript Type\~1 fonts;
+the
+.B \%encoding
+directive of
+font description files for the
+.B pdf
+device refers to it.
+.
 .
 .TP
-.I @MACRODIR@/pdf.tmac
-Macros for use with
-.BR gropdf ;
-automatically loaded by
-.BR troffrc .
+.I @MACRODIR@/\:pdf\:.tmac
+defines macros for use with the
+.B pdf
+output device.
+.
+It is automatically loaded by
+.I troffrc
+when the
+.B pdf
+output device is selected.
+.
 .
+.TP
+.I @MACRODIR@/\:\%pdfpic\:.tmac
+defines the
+.B PDFPIC
+macro for embedding images in a document;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+It is automatically loaded by
+.I troffrc.
+.\"
+.\"
 .\" .TP
 .\" .B @MACRODIR@/pspic.tmac
 .\" Definition of
@@ -1333,24 +1780,66 @@
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH Authors
+.\" ====================================================================
+.
+.I gropdf
+was written and is maintained by
+.MT deri@\:chuzzlewit\:.myzen\:.co\:.uk
+Deri James
+.ME .
+.
+.
+.\" ====================================================================
+.SH "See also"
 .\" ====================================================================
 .
-.BR \%afmtodit (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR \%groff_font (@MAN5EXT@),
-.BR \%groff_out (@MAN5EXT@)
+.TP
+.I @DOCDIR@/\:\%sboxes/\:\%msboxes\:.ms
+.TQ
+.I @DOCDIR@/\:\%sboxes/\:\%msboxes\:.pdf
+\lqUsing PDF boxes with
+.I groff
+and the
+.I ms
+macros\rq,
+by Deri James.
+.
+.
+.TP
+.I present.tmac
+is part of
+.UR https://\:bob\:.diertens\:.org/\:corner/\:useful/\:gpresent/
+.I gpresent
+.UE ,
+a software package by Bob Diertens that works with
+.I groff
+to produce presentations
+(\lqfoils\rq,
+or \lqslide decks\rq).
+.
+.
+.P
+.MR afmtodit @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_out @MAN5EXT@
 .\" Not actually referenced in above discussion.
 .\" .BR \%pfbtops (@MAN1EXT@),
 .\" .BR \%groff_tmac (@MAN5EXT@),
 .
 .
+.\" Clean up.
+.rm FT
+.
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngropdf_C
+.cp \n*groff_gropdf_1_man_C
+.do rr *groff_gropdf_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/gropdf.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/gropdf.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/gropdf.pl -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/gropdf.pl Changed

@@ -1,8 +1,8 @@
-#!@PERL@ -w
+#!@PERL@
 #
-#	gropdf		: PDF post processor for groff
+#       gropdf          : PDF post processor for groff
 #
-# Copyright (C) 2011-2018 Free Software Foundation, Inc.
+# Copyright (C) 2011-2020 Free Software Foundation, Inc.
 #      Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 #
 # This file is part of groff.
@@ -12,8 +12,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -21,6 +21,7 @@
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 
 use strict;
+use warnings;
 use Getopt::Long qw(:config bundling);
 
 use constant
@@ -29,9 +30,11 @@
     CHRCODE		=> 1,
     PSNAME		=> 2,
     ASSIGNED		=> 3,
-    USED		=> 4,
+    USED                => 4,
 };
 
+my $prog=$0;
+
 my $gotzlib=0;
 
 my $rc = eval
@@ -47,7 +50,8 @@
 }
 else
 {
-    Msg(0,"Perl module Compress::Zlib not available - cannot compress this pdf");
+    Warn("Perl module 'Compress::Zlib' not available; cannot compress"
+         . " this PDF");
 }
 
 my %cfg;
@@ -57,7 +61,7 @@
 $cfg{RT_SEP}='@RT_SEP@';
 binmode(STDOUT);
 
-my @obj;	# Array of PDF objects
+my @obj;        # Array of PDF objects
 my $objct=0;	# Count of Objects
 my $fct=0;	# Output count
 my %fnt;	# Used fonts
@@ -109,18 +113,20 @@
 my $nomove=0;
 my $pendmv=0;
 my $gotT=0;
-my $suppress=0;	# Suppress processing?
-my %incfil;	# Included Files
-my @outlev=(0,undef,0,0);	# Structure pdfmark /OUT entries
+my $suppress=0; # Suppress processing?
+my %incfil;     # Included Files
+my @outlev=(0,undef,0,0);     # Structure pdfmark /OUT entries
 my $curoutlev=\@outlev;
-my $curoutlevno=0;	# Growth point for @curoutlev
+my $curoutlevno=0;      # Growth point for @curoutlev
 my $Foundry='';
-my $xrev=0;	# Reverse x direction of font
+my $xrev=0;     # Reverse x direction of font
 my $matrixchg=0;
 my $wt=-1;
 my $thislev=1;
 my $mark=undef;
 my $suspendmark=undef;
+my $boxmax=0;
+my %missing;    # fonts in download files which are not found/readable
 
 
 
@@ -137,10 +143,13 @@
 		BLOCK => {Type => '/Trans', S => '', D => 1, Dm => '/H', M => '/I', Di => 0, SS => 1.0, B => 0}};
 my $firstpause=0;
 my $present=0;
+my @bgstack;		# Stack of background boxes
+my $bgbox='';		# Draw commands for boxes on this page
 
 $noslide=1 if exists($ENV{GROPDF_NOSLIDE}) and $ENV{GROPDF_NOSLIDE};
 
-my %ppsz=(	'ledger'=>1224,792,
+my %ppsz=(
+	'ledger'=>1224,792,
 	'legal'=>612,1008,
 	'letter'=>612,792,
 	'a0'=>2384,3370,
@@ -154,20 +163,22 @@
 	'a8'=>148,210,
 	'a9'=>105,148,
 	'a10'=>73,105,
-	'isob0'=>2835,4008,
-	'isob1'=>2004,2835,
-	'isob2'=>1417,2004,
-	'isob3'=>1001,1417,
-	'isob4'=>709,1001,
-	'isob5'=>499,709,
-	'isob6'=>354,499,
+	'b0'=>2835,4008,
+	'b1'=>2004,2835,
+	'b2'=>1417,2004,
+	'b3'=>1001,1417,
+	'b4'=>709,1001,
+	'b5'=>499,709,
+	'b6'=>354,499,
 	'c0'=>2599,3677,
 	'c1'=>1837,2599,
 	'c2'=>1298,1837,
 	'c3'=>918,1298,
 	'c4'=>649,918,
 	'c5'=>459,649,
-	'c6'=>323,459 );
+	'c6'=>323,459,
+	'com10'=>297,684,
+);
 
 my $ucmap=<<'EOF';
 /CIDInit /ProcSet findresource begin
@@ -193,22 +204,49 @@
 end
 EOF
 
+sub usage
+{
+    my $stream = *STDOUT;
+    my $had_error = shift;
+    $stream = *STDERR if $had_error;
+    print $stream
+"usage: $prog -dels -F font-directory -I inclusion-directory" .
+" -p paper-format -u cmap-file -y foundry file ...\n" .
+"usage: $prog {-v | --version}\n" .
+"usage: $prog --help\n";
+    if (!$had_error)
+    {
+	print $stream "\n" .
+"Translate the output of troff(1) into Portable Document Format.\n" .
+"See the gropdf(1) manual page.\n";
+    }
+    exit($had_error);
+}
+
 my $fd;
 my $frot;
 my $fpsz;
 my $embedall=0;
 my $debug=0;
+my $want_help=0;
 my $version=0;
 my $stats=0;
 my $unicodemap;
 my @idirs;
 
-#Load_Config();
-
-GetOptions("F=s" => \$fd, 'I=s' => \@idirs, 'l' => \$frot, 'p=s' => \$fpsz, 'd!' => \$debug, 'v' => \$version, 'version' => \$version, 'e' => \$embedall, 'y=s' => \$Foundry, 's' => \$stats, 'u:s' => \$unicodemap);
+if (!GetOptions('F=s' => \$fd, 'I=s' => \@idirs, 'l' => \$frot,
+		'p=s' => \$fpsz, 'd!' => \$debug, 'help' => \$want_help,
+		'v' => \$version, 'version' => \$version,
+		'e' => \$embedall, 'y=s' => \$Foundry, 's' => \$stats,
+		'u:s' => \$unicodemap))
+{
+    &usage(1);
+}
 
 unshift(@idirs,'.');
 
+&usage(0) if ($want_help);
+
 if ($version)
 {
     print "GNU gropdf (groff) version $cfg{GROFF_VERSION}\n";
@@ -223,18 +261,19 @@
     }
     elsif (-r $unicodemap)
     {
-	local $/;
-	open(F,"<$unicodemap") or die "gropdf: Failed to open '$unicodemap'";
-	($ucmap)=(<F>);
-	close(F);
+        local $/;
+        open(F,"<$unicodemap") or Die("failed to open '$unicodemap'");
+        ($ucmap)=(<F>);
+        close(F);
     }
     else
     {
-	Msg(0,"Failed to find '$unicodemap' - ignoring");
+        Warn("failed to find '$unicodemap'; ignoring");
     }
 }
 
-# Search for 'font directory': paths in -f opt, shell var GROFF_FONT_PATH, default paths
+# Search for 'font directory': paths in -f opt, shell var
+# GROFF_FONT_PATH, default paths
 
 my $fontdir=$cfg{GROFF_FONT_PATH};
 $fontdir=$ENV{GROFF_FONT_PATH}.$cfg{RT_SEP}.$fontdir if exists($ENV{GROFF_FONT_PATH});
@@ -247,37 +286,61 @@
 LoadDesc();
 
 my $unitwidth=$desc{unitwidth};
-my $papersz=$desc{papersize};
-$papersz=lc($fpsz) if $fpsz;
 
 $env{FontHT}=0;
 $env{FontSlant}=0;
 MakeMatrix();
 
-if (substr($papersz,0,1) eq '/' and -r $papersz)
+my $possiblesizes = $desc{papersize};
+$possiblesizes = $fpsz if $fpsz;
+my $papersz;
+for $papersz ( split(" ", lc($possiblesizes).' #duff#') )
 {
-    if (open(P,"<$papersz"))
+    # No valid papersize found?
+    if ($papersz eq '#duff#')
     {
-	while (<P>)
-	{
-	    chomp;
-	    s/# .*//;
-	    next if $_ eq '';
-	    $papersz=$_;
-	    last
-	}
+	Warn("ignoring unrecognized paper format(s) '$possiblesizes'");
+	last;
+    }
 
-	close(P);
+    # Check for "/etc/papersize"
+    elsif (substr($papersz,0,1) eq '/' and -r $papersz)
+    {
+        if (open(P,"<$papersz"))
+        {
+            while (<P>)
+            {
+                chomp;
+                s/# .*//;
+                next if $_ eq '';
+                $papersz=lc($_);
+                last;
+            }
+            close(P);
+        }
     }
-}
 
-if ($papersz=~m/(\d.+)(cipP),(\d.+)(cipP)/)
-{
-    @defaultmb=@mediabox=(0,0,ToPoints($3,$4),ToPoints($1,$2));
-}
-elsif (exists($ppsz{$papersz}))
-{
-    @defaultmb=@mediabox=(0,0,$ppsz{$papersz}->0,$ppsz{$papersz}->1);
+    # Allow height,width specified directly in centimeters, inches, or points.
+    if ($papersz=~m/(\d.+)(cipP),(\d.+)(cipP)/)
+    {
+        @defaultmb=@mediabox=(0,0,ToPoints($3,$4),ToPoints($1,$2));
+        last;
+    }
+    # Look $papersz up as a name such as "a4" or "letter".
+    elsif (exists($ppsz{$papersz}))
+    {
+        @defaultmb=@mediabox=(0,0,$ppsz{$papersz}->0,$ppsz{$papersz}->1);
+        last;
+    }
+    # Check for a landscape version
+    elsif (substr($papersz,-1) eq 'l' and exists($ppsz{substr($papersz,0,-1)}))
+    {
+	# Note 'legal' ends in 'l' but will be caught above
+	@defaultmb=@mediabox=(0,0,$ppsz{substr($papersz,0,-1)}->1,$ppsz{substr($papersz,0,-1)}->0);
+	last;
+    }
+
+    # If we get here, $papersz was invalid, so try the next one.
 }
 
 my (@dt)=localtime($ENV{SOURCE_DATE_EPOCH} || time);
@@ -287,6 +350,7 @@
 				'Producer' => "(gropdf version $cfg{GROFF_VERSION})",
 				'ModDate' => "($dt)",
 				'CreationDate' => "($dt)");
+map { $_="< ".$_."\0" } @ARGV;
 
 while (<>)
 {
@@ -294,7 +358,7 @@
     s/\r$//;
     $lct++;
 
-    do 	# The ahead buffer behaves like 'ungetc'
+    do	# The ahead buffer behaves like 'ungetc'
     {{
 	if (scalar(@ahead))
 	{
@@ -363,6 +427,32 @@
 	    @{$cpage->{Annots}}=@PageAnnots;
 	}
 
+	if ($#bgstack > -1 or $bgbox)
+	{
+	    my $box="q 1 0 0 1 0 0 cm ";
+
+	    foreach my $bg (@bgstack)
+	    {
+		# 0=$bgtype # 1=stroke 2=fill. 4=page
+		# 1=$strkcol
+		# 2=$fillcol
+		# 3=(Left,Top,Right,bottom,LineWeight)
+		# 4=Start ypos
+		# 5=Endypos
+		# 6=Line Weight
+
+		my $pg=$bg->3 || \@mediabox;
+
+		$bg->5=$pg->3;	# box is continuing to next page
+		$box.=DrawBox($bg);
+		$bg->4=$pg->1;	# will continue from page top
+	    }
+
+	    $stream=$box.$bgbox."Q\n".$stream;
+	    $bgbox='';
+	}
+
+    $boxmax=0;
 	PutObj($cpageno);
 	OutStream($cpageno+1);
 }
@@ -377,7 +467,7 @@
 
 PutObj($objct);
 
-foreach my $fontno (keys %fontlst)
+foreach my $fontno (sort keys %fontlst)
 {
     my $o=$fontlst{$fontno}->{FNT};
 
@@ -388,7 +478,7 @@
 
 	push(@{$o->{DIFF}},$psname);
 	push(@{$o->{WIDTH}},$wid);
-	last if $#{$o->{DIFF}} >= 255;
+	last if $#{$o->{DIFF}} >= 256;
     }
     unshift(@{$o->{DIFF}},0);
     my $p=GetObj($fontlst{$fontno}->{OBJ});
@@ -396,8 +486,8 @@
     if (exists($p->{LastChar}) and $p->{LastChar} > 255)
     {
 	$p->{LastChar} = 255;
-	splice(@{$o->{DIFF}},256);
-	splice(@{$o->{WIDTH}},256);
+	splice(@{$o->{DIFF}},257);
+	splice(@{$o->{WIDTH}},257);
     }
 }
 
@@ -443,13 +533,13 @@
 	    $slant*=$env{FontHT}/$cftsz if $env{FontHT} != 0;
 	    my $ang=rad($slant);
 
-	    $mat2=sprintf('%.3f',sin($ang)/cos($ang));
-	}
+            $mat2=sprintf('%.3f',sin($ang)/cos($ang));
+        }
 
-	if ($fontxrev)
-	{
-	    $mat0=-$mat0;
-	}
+        if ($fontxrev)
+        {
+            $mat0=-$mat0;
+        }
     }
 
     $matrix=join(' ',@mat);
@@ -572,25 +662,10 @@
     }
     else
     {
-	Msg(1,"Unknown scaling factor '$unit'");
+        Die("invalid scaling unit '$unit'");
     }
 }
 
-sub Load_Config
-{
-    open(CFG,"<gropdf_config") or die "Can't open config file: $!";
-
-    while (<CFG>)
-    {
-	chomp;
-	my ($key,$val)=split(/ ?= ?/);
-
-	$cfg{$key}=$val;
-    }
-
-    close(CFG);
-}
-
 sub LoadDownload
 {
     my $f;
@@ -617,13 +692,22 @@
 		$file=substr($file,1);
 	    }
 
-	    $download{"$foundry $name"}=$file;
+            my $pth=$file;
+            $pth=$dir."/$devnm/$file" if substr($file,0,1) ne '/';
+
+            if (!-r $pth)
+            {
+                $missing{"$foundry $name"}="$dir/$devnm";
+                next;
+            }
+
+            $download{"$foundry $name"}=$file if !exists($download{"$foundry $name"});
 	}
 
-	close($f);
+        close($f);
     }
 
-    Msg(1,"Failed to open 'download'") if !$found;
+    Die("failed to open 'download' file") if !$found;
 }
 
 sub OpenFile
@@ -650,7 +734,8 @@
     my $f;
 
     OpenFile(\$f,$fontdir,"DESC");
-    Msg(1,"Failed to open 'DESC'") if !defined($f);
+    Die("failed to open device description file 'DESC'")
+        if !defined($f);
 
     while (<$f>)
     {
@@ -662,6 +747,38 @@
     }
 
     close($f);
+
+    foreach my $directive ('unitwidth', 'res', 'sizescale')
+    {
+        Die("device description file 'DESC' missing mandatory directive"
+            . " '$directive'") if !exists($desc{$directive});
+    }
+
+    foreach my $directive ('unitwidth', 'res', 'sizescale')
+    {
+        my $val=$desc{$directive};
+        Die("device description file 'DESC' directive '$directive'"
+            . " value must be positive; got '$val'")
+            if ($val !~ m/^\d+$/ or $val <= 0);
+    }
+
+    if (exists($desc{'hor'}))
+    {
+        my $hor=$desc{'hor'};
+        Die("device horizontal motion quantum must be 1, got '$hor'")
+            if ($hor != 1);
+    }
+
+    if (exists($desc{'vert'}))
+    {
+        my $vert=$desc{'vert'};
+        Die("device vertical motion quantum must be 1, got '$vert'")
+            if ($vert != 1);
+    }
+
+    my ($res,$ss)=($desc{'res'},$desc{'sizescale'});
+    Die("device resolution must be a multiple of 72*sizescale, got"
+        . " '$res' ('sizescale'=$ss)") if (($res % ($ss * 72)) != 0);
 }
 
 sub rad  { $_0*3.14159/180 }
@@ -676,9 +793,10 @@
 
     if ($xcmd eq 'T')
     {
-	Msg(0,"Expecting a pdf pipe (got $xprm0)") if $xprm0 ne substr($devnm,3);
+        Warn("expecting a PDF pipe (got $xprm0)")
+            if $xprm0 ne substr($devnm,3);
     }
-    elsif ($xcmd eq 'f')	# Register Font
+    elsif ($xcmd eq 'f')        # Register Font
     {
 	$xprm1="${Foundry}-$xprm1" if $Foundry ne '';
 	LoadFont($xprm0,$xprm1);
@@ -767,7 +885,12 @@
 		IsGraphic();
 		my ($curangle,$hyp)=RtoP($xpos,GraphY($ypos));
 		my ($x,$y)=PtoR($theta+$curangle,$hyp);
-		$stream.="q\n".sprintf("%.3f %.3f %.3f %.3f %.3f %.3f cm",cos($theta),sin($theta),-sin($theta),cos($theta),$xpos-$x,GraphY($ypos)-$y)."\n";
+		my ($tx, $ty) = ($xpos - $x, GraphY($ypos) - $y);
+		if ($frot) {
+		  ($tx, $ty) = ($tx *  sin($theta) + $ty * -cos($theta),
+				$tx * -cos($theta) + $ty * -sin($theta));
+		}
+		$stream.="q\n".sprintf("%.3f %.3f %.3f %.3f %.3f %.3f cm",cos($theta),sin($theta),-sin($theta),cos($theta),$tx,$ty)."\n";
 		$InPicRotate=1;
 	    }
 	    elsif ($par=~m/exec grestore/ and $InPicRotate)
@@ -840,38 +963,36 @@
 		my $pdfmark=$1;
 		$pdfmark=~s((\d{4,6}) u)(sprintf("%.1f",$1/$desc{sizescale}))eg;
 		$pdfmark=~s(\\\u00(..)\)(chr(hex($1)))eg;
+                $pdfmark=~s/\\n/\n/g;
 
-		if ($pdfmark=~m/(.+) \/DOCINFO/)
+		if ($pdfmark=~m/(.+) \/DOCINFO\s*$/s)
 		{
-		    my @xwds=split(' ',"<< $1 >>");
+		    my @xwds=split(/ /,"<< $1 >>");
 		    my $docinfo=ParsePDFValue(\@xwds);
 
-		    foreach my $k (keys %{$docinfo})
+		    foreach my $k (sort keys %{$docinfo})
 		    {
 			$info{$k}=$docinfo->{$k} if $k ne 'Producer';
 		    }
 		}
-		elsif ($pdfmark=~m/(.+) \/DOCVIEW/)
+		elsif ($pdfmark=~m/(.+) \/DOCVIEW\s*$/)
 		{
 		    my @xwds=split(' ',"<< $1 >>");
 		    my $docview=ParsePDFValue(\@xwds);
 
-		    foreach my $k (keys %{$docview})
+		    foreach my $k (sort keys %{$docview})
 		    {
 			$cat->{$k}=$docview->{$k} if !exists($cat->{$k});
 		    }
 		}
-		elsif ($pdfmark=~m/(.+) \/DEST/)
+		elsif ($pdfmark=~m/(.+) \/DEST\s*$/)
 		{
-		    my @xwds=split(' ',"<< $1 >>");
-		    my $dest=ParsePDFValue(\@xwds);
-		    foreach my $v (@{$dest->{View}})
-		    {
-			$v=GraphY(abs($v)) if substr($v,0,1) eq '-';
-		    }
-		    unshift(@{$dest->{View}},"$cpageno 0 R");
+                    my @xwds=split(' ',"<< $1 >>");
+                    my $dest=ParsePDFValue(\@xwds);
+                    $dest->{View}->1=GraphY($dest->{View}->1*-1);
+                    unshift(@{$dest->{View}},"$cpageno 0 R");
 
-		    if (!defined($dests))
+                    if (!defined($dests))
 		    {
 			$cat->{Dests}=BuildObj(++$objct,{});
 			$dests=$obj$objct->{DATA};
@@ -880,7 +1001,7 @@
 		    my $k=substr($dest->{Dest},1);
 		    $dests->{$k}=$dest->{View};
 		}
-		elsif ($pdfmark=~m/(.+) \/ANN/)
+		elsif ($pdfmark=~m/(.+) \/ANN\s*$/)
 		{
 		    my $l=$1;
 		    $l=~s/Color/C/;
@@ -895,7 +1016,7 @@
 		    FixPDFColour($annot->{DATA});
 		    push(@PageAnnots,$annotno);
 		}
-		elsif ($pdfmark=~m/(.+) \/OUT/)
+		elsif ($pdfmark=~m/(.+) \/OUT\s*$/)
 		{
 		    my $t=$1;
 		    $t=~s/\\\) /\\\\\) /g;
@@ -936,10 +1057,10 @@
 				$thislev--;
 			    }
 
-    			    $curoutlevno=$#{$curoutlev};
+			    $curoutlevno=$#{$curoutlev};
 			}
 
-# 			push(@{$curoutlev},$this);
+#			push(@{$curoutlev},$this);
 			splice(@{$curoutlev},++$curoutlevno,0,$this);
 			$curoutlev->0->2++;
 		    }
@@ -985,8 +1106,8 @@
 		my $lly=$xprm4;
 		my $urx=$xprm5;
 		my $ury=$xprm6;
-		my $wid=$xprm7;
-		my $hgt=$xprm8||-1;
+		my $wid=GetPoints($xprm7);
+		my $hgt=GetPoints($xprm8)||-1;
 		my $mat=1,0,0,1,0,0;
 
 		if (!exists($incfil{$fil}))
@@ -1013,13 +1134,13 @@
 			}
 
 			$incfil{$fil}=LoadSWF($fil,$llx,$lly,$urx,$ury,$mat);
-		    }
-		    else
-		    {
-			Msg(0,"Unknown filetype '$fil'");
-			return undef;
-		    }
-		}
+                    }
+                    else
+                    {
+                        Warn("unrecognized 'import' file type '$fil'");
+                        return undef;
+                    }
+                }
 
 		if (defined($incfil{$fil}))
 		{
@@ -1071,11 +1192,11 @@
 
 		    if ($flag eq '-C' and $ll > $wid)
 		    {
-			$xpos=int(($ll-$wid)/2);
+			$xpos+=int(($ll-$wid)/2);
 		    }
 		    elsif ($flag eq '-R' and $ll > $wid)
 		    {
-			$xpos=$ll-$wid;
+			$xpos+=$ll-$wid;
 		    }
 
 		    $ypos+=$hgt;
@@ -1085,12 +1206,12 @@
 		}
 	    }
 	    elsif (lc($xprm1) eq 'xrev')
-	    {
-		$xrev=!$xrev;
-	    }
-	    elsif (lc($xprm1) eq 'markstart')
-	    {
-		$mark={'rst' => ($xprm2+$xprm4)/$unitwidth, 'rsb' => ($xprm3-$xprm4)/$unitwidth, 'xpos' => $xpos-($xprm4/$unitwidth),
+            {
+                $xrev=!$xrev;
+            }
+            elsif (lc($xprm1) eq 'markstart')
+            {
+                $mark={'rst' => ($xprm2+$xprm4)/$unitwidth, 'rsb' => ($xprm3-$xprm4)/$unitwidth, 'xpos' => $xpos-($xprm4/$unitwidth),
 			    'ypos' => $ypos, 'lead' => $xprm4/$unitwidth, 'pdfmark' => join(' ',@xprm5..$#xprm)};
 	    }
 	    elsif (lc($xprm1) eq 'markend')
@@ -1168,27 +1289,30 @@
 					    {
 						$pginsert=$j;
 						last FIND;
-					    }
-					    else
-					    {
-						Msg(0,"Parameter must be top|bottom|before|after not '$ba'");
-						last FIND;
-					    }
-					}
-
-				    }
-
-				    Msg(0,"Can't find page ref '$ref'");
-				    last FIND
-
-				}
+                                            }
+                                            else
+                                            {
+                                                # XXX: indentation wince
+                                                Warn(
+"expected 'switchtopage' parameter to be one of"
+. "'top|bottom|before|after', got '$ba'");
+                                                last FIND;
+                                            }
+                                        }
+
+                                    }
+
+                                    Warn("cannot find page ref '$ref'");
+                                    last FIND
+
+                                }
 			    }
-			}
-			else
-			{
-			    Msg(0,"Can't find page named '$want'");
-			}
-		    }
+                        }
+                        else
+                        {
+                            Warn("cannot find page named '$want'");
+                        }
+                    }
 
 		    if ($pginsert < 0)
 		    {
@@ -1227,6 +1351,74 @@
 
 		$present=1;
 	    }
+	    elsif (lc($xprm1) eq 'background')
+	    {
+		splice(@xprm,0,2);
+		my $type=shift(@xprm);
+#		print STDERR "ypos=$ypos\n";
+
+		if (lc($type) eq 'off')
+		{
+		    my $sptr=$#bgstack;
+		    if ($sptr > -1)
+		    {
+                        if ($sptr == 0 and $bgstack0->0 & 4)
+                        {
+                            pop(@bgstack);
+                        }
+                        else
+                        {
+                            $bgstack$sptr->5=GraphY($ypos);
+			$bgbox=DrawBox(pop(@bgstack)).$bgbox;
+		    }
+		}
+		}
+		elsif (lc($type) eq 'footnote')
+		{
+                    my $t=GetPoints($xprm0);
+                    $boxmax=($t<0)?abs($t):GraphY($t);
+                }
+		else
+		{
+		    my $bgtype=0;
+
+		    foreach (@xprm)
+		    {
+			$_=GetPoints($_);
+		    }
+
+		    $bgtype|=2 if $type=~m/box/i;
+		    $bgtype|=1 if $type=~m/fill/i;
+		    $bgtype|=4 if $type=~m/page/i;
+		    $bgtype=5 if $bgtype==4;
+		    my $bgwt=$xprm4;
+		    $bgwt=$xprm0 if !defined($bgwt) and $#xprm == 0;
+		    my (@bg)=(@xprm);
+		    my $bg=\@bg;
+
+		    if (!defined($bg3) or $bgtype & 4)
+		    {
+			$bg=undef;
+		    }
+		    else
+		    {
+			FixRect($bg);
+		    }
+
+		    if ($bgtype)
+		    {
+                        if ($bgtype & 4)
+                        {
+                            shift(@bgstack) if $#bgstack >= 0 and $bgstack0->0 & 4;
+                            unshift(@bgstack,$bgtype,$strkcol,$fillcol,$bg,GraphY($ypos),GraphY($bg3||0),$bgwt || 0.4);
+                        }
+                        else
+                        {
+			push(@bgstack,$bgtype,$strkcol,$fillcol,$bg,GraphY($ypos),GraphY($bg3||0),$bgwt || 0.4);
+		    }
+		}
+	    }
+	}
 	}
 	elsif (lc(substr($xprm0,0,9)) eq 'papersize')
 	{
@@ -1316,6 +1508,22 @@
     return if !defined($rect);
     $rect->1=GraphY($rect->1);
     $rect->3=GraphY($rect->3);
+
+    if ($rot)
+    {
+	($rect->0,$rect->1)=Rotate($rect->0,$rect->1);
+	($rect->2,$rect->3)=Rotate($rect->2,$rect->3);
+    }
+}
+
+sub Rotate
+{
+    my ($tx,$ty)=(@_);
+    my $theta=rad($rot);
+
+    ($tx,$ty)=(d3($tx * cos(-$theta) - $ty * sin(-$theta)),
+	       d3($tx * sin( $theta) + $ty * cos( $theta)));
+    return($tx,$ty);
 }
 
 sub GetPoints
@@ -1327,46 +1535,48 @@
     return $val;
 }
 
-# Although the PDF reference mentions XObject/Form as a way of incorporating an external PDF page into
-# the current PDF, it seems not to work with any current PDF reader (although I am told (by Leonard Rosenthol,
-# who helped author the PDF ISO standard) that Acroread 9 does support it, empiorical observation shows otherwise!!).
-# So... do it the hard way - full PDF parser and merge required objects!!!
+# Although the PDF reference mentions XObject/Form as a way of
+# incorporating an external PDF page into the current PDF, it seems not
+# to work with any current PDF reader (although I am told (by Leonard
+# Rosenthol, who helped author the PDF ISO standard) that Acroread 9
+# does support it, empirical observation shows otherwise!!).  So... do
+# it the hard way - full PDF parser and merge required objects!!!
 
 # sub BuildRef
 # {
-# 	my $fil=shift;
-# 	my $bbox=shift;
-# 	my $mat=shift;
-# 	my $wid=($bbox->2-$bbox->0)*$mat->0;
-# 	my $hgt=($bbox->3-$bbox->1)*$mat->3;
+#	my $fil=shift;
+#	my $bbox=shift;
+#	my $mat=shift;
+#	my $wid=($bbox->2-$bbox->0)*$mat->0;
+#	my $hgt=($bbox->3-$bbox->1)*$mat->3;
 #
-# 	if (!open(PDF,"<$fil"))
-# 	{
-# 		Msg(0,"Failed to open '$fil'");
-# 		return(undef);
-# 	}
+#       if (!open(PDF,"<$fil"))
+#       {
+#               Warn("failed to open '$fil'");
+#               return(undef);
+#       }
 #
-# 	my (@f)=(<PDF>);
+#	my (@f)=(<PDF>);
 #
-# 	close(PDF);
+#	close(PDF);
 #
-# 	$objct++;
-# 	my $xonm="XO$objct";
+#	$objct++;
+#	my $xonm="XO$objct";
 #
-# 	$pages->{'Resources'}->{'XObject'}->{$xonm}=BuildObj($objct,{'Type' => '/XObject',
-# 								    'Subtype' => '/Form',
-# 								    'BBox' => $bbox,
-# 								    'Matrix' => $mat,
-# 								    'Resources' => $pages->{'Resources'},
-# 								    'Ref' => {'Page' => '1',
-# 										'F' => BuildObj($objct+1,{'Type' => '/Filespec',
-# 													  'F' => "($fil)",
-# 													  'EF' => {'F' => BuildObj($objct+2,{'Type' => '/EmbeddedFile'})}
-# 										})
-# 								    }
-# 								});
+#	$pages->{'Resources'}->{'XObject'}->{$xonm}=BuildObj($objct,{'Type' => '/XObject',
+#								    'Subtype' => '/Form',
+#								    'BBox' => $bbox,
+#								    'Matrix' => $mat,
+#								    'Resources' => $pages->{'Resources'},
+#								    'Ref' => {'Page' => '1',
+#										'F' => BuildObj($objct+1,{'Type' => '/Filespec',
+#													  'F' => "($fil)",
+#													  'EF' => {'F' => BuildObj($objct+2,{'Type' => '/EmbeddedFile'})}
+#										})
+#								    }
+#								});
 #
-# 	$obj$objct->{STREAM}="q 1 0 0 1 0 0 cm
+#	$obj$objct->{STREAM}="q 1 0 0 1 0 0 cm
 # q BT
 # 1 0 0 1 0 0 Tm
 # .5 g .5 G
@@ -1377,12 +1587,12 @@
 # Q\n";
 #
 # #	$obj$objct->{STREAM}=PutXY($xpos,$ypos)." m ".PutXY($xpos+$wid,$ypos)." l ".PutXY($xpos+$wid,$ypos+$hgt)." l ".PutXY($xpos,$ypos+$hgt)." l f\n";
-# 	$obj$objct+2->{STREAM}=join('',@f);
-# 	PutObj($objct);
-# 	PutObj($objct+1);
-# 	PutObj($objct+2);
-# 	$objct+=2;
-# 	return($xonm);
+#	$obj$objct+2->{STREAM}=join('',@f);
+#	PutObj($objct);
+#	PutObj($objct+1);
+#	PutObj($objct+2);
+#	$objct+=2;
+#	return($xonm);
 # }
 
 sub LoadSWF
@@ -1397,8 +1607,8 @@
 
     if (!open(PDF,"<$fil"))
     {
-	Msg(0,"Failed to open '$fil'");
-	return(undef);
+        Warn("failed to open SWF '$fil'");
+        return(undef);
     }
 
     my (@f)=(<PDF>);
@@ -1436,7 +1646,7 @@
 			'P' => "$cpageno 0 R",
 			'RichMediaSettings' => { 'Deactivation' => { 'Condition' => '/PI',
 						'Type' => '/RichMediaDeactivation'},
-				    'Activation' => { 	'Condition' => '/PV',
+				    'Activation' => {	'Condition' => '/PV',
 						'Type' => '/RichMediaActivation'}},
 			'F' => 68,
 			'Subtype' => '/RichMedia',
@@ -1498,8 +1708,8 @@
 
     if (!defined($PD))
     {
-	Msg(0,"Failed to open PDF '$pdfnm'");
-	return undef;
+        Warn("failed to open PDF '$pdfnm'");
+        return undef;
     }
 
     my $hdr=<$PD>;
@@ -1546,14 +1756,15 @@
 		$pdf->$curobj->{STREAMPOS}=tell($PD)+$adj,$strmlen;
 		seek($PD,$strmlen,1);
 		$instream=1;
-	    }
-	    else
-	    {
-		Msg(0,"Parsing PDF '$pdfnm' failed");
-		return undef;
-	    }
-	}
-
+            }
+            else
+            {
+                Warn("parsing PDF '$pdfnm' failed");
+                return undef;
+            }
+        }
+
+	s/%.*?$//;
 	$pdftxt.=$_.' ';
     }
 
@@ -1563,6 +1774,7 @@
 #	$pdftxt=~s/\/ \/g;
     my (@pdfwds)=split(' ',$pdftxt);
     my $wd;
+    my $root;
 
     while ($wd=nextwd(\@pdfwds),length($wd))
     {
@@ -1572,6 +1784,27 @@
 	    shift(@pdfwds); shift(@pdfwds);
 	    unshift(@pdfwds,$1) if defined($1) and length($1);
 	    $pdf->$curobj->{OBJ}=ParsePDFObj(\@pdfwds);
+            my $o=$pdf->$curobj;
+
+            if (ref($o->{OBJ}) eq 'HASH' and exists($o->{OBJ}->{Type}) and $o->{OBJ}->{Type} eq '/ObjStm')
+            {
+                LoadStream($o,$pdf);
+                my $pos=$o->{OBJ}->{First};
+                my $s=$o->{STREAM};
+                my @o=split(' ',substr($s,0,$pos));
+                substr($s,0,$pos)='';
+                push(@o,-1,length($s));
+
+                for (my $j=0; $j<=$#o-2; $j+=2)
+                {
+                    my @w=split(' ',substr($s,$o$j+1,$o$j+3-$o$j+1));
+                    $pdf->$o$j->{OBJ}=ParsePDFObj(\@w);
+                }
+
+                $pdf->$curobj=undef;
+            }
+
+            $root=$curobj if ref($pdf->$curobj->{OBJ}) eq 'HASH' and exists($pdf->$curobj->{OBJ}->{Type}) and $pdf->$curobj->{OBJ}->{Type} eq '/XRef';
 	}
 	elsif ($wd eq 'trailer' and !exists($pdf->0->{OBJ}))
 	{
@@ -1583,6 +1816,7 @@
 	}
     }
 
+    $pdf->0=$pdf->$root if !defined($pdf->0);
     my $catalog=${$pdf->0->{OBJ}->{Root}};
     my $page=FindPage(1,$pdf);
     my $xobj=++$objct;
@@ -1591,25 +1825,10 @@
 
     foreach my $o (@{$pdf})
     {
-	if (exists($o->{STREAMPOS}))
+	if (exists($o->{STREAMPOS}) and !exists($o->{STREAM}))
 	{
-	    my $l;
-
-	    $l=$o->{OBJ}->{Length} if exists($o->{OBJ}->{Length});
-
-	    $l=$pdf->$$l->{OBJ} if (defined($l) && ref($l) eq 'OBJREF');
-
-	    Msg(1,"Unable to determine length of stream \@$o->{STREAMPOS}->0") if !defined($l);
-
-	    sysseek(PD,$o->{STREAMPOS}->0,0);
-	    Msg(0,'Failed to read all the stream') if $l != sysread(PD,$o->{STREAM},$l);
-
-	    if ($gotzlib and exists($o->{OBJ}->{'Filter'}) and $o->{OBJ}->{'Filter'} eq '/FlateDecode')
-	    {
-		$o->{STREAM}=Compress::Zlib::uncompress($o->{STREAM});
-		delete($o->{OBJ }->{'Filter'});
-	    }
-	}
+            LoadStream($o,$pdf);
+        }
     }
 
     close(PD);
@@ -1618,7 +1837,7 @@
     my $BBox;
     my $insmap={};
 
-    foreach my $k (qw( MediaBox ArtBox TrimBox BleedBox CropBox ))
+    foreach my $k (qw( ArtBox TrimBox BleedBox CropBox MediaBox ))
     {
 	$BBox=FindKey($pdf,$page,$k);
 	last if $BBox;
@@ -1660,12 +1879,42 @@
     ($mat->4,$mat->5)=split(' ',PutXY($xpos,$ypos));
     $pages->{'Resources'}->{'XObject'}->{$xonm}=BuildObj($xobj,{'Type' => '/XObject', 'BBox' => $BBox, 'Name' => "/$xonm", 'FormType' => 1, 'Subtype' => '/Form', 'Length' => 0, 'Type' => "/XObject", 'Resources' => \%incres});
 
+    if ($BBox->0 != 0 or $BBox->1 != 0)
+    {
+        my (@matrix)=(1,0,0,1,-$BBox->0,-$BBox->1);
+        $obj$xobj->{DATA}->{Matrix}=\@matrix;
+    }
+
     BuildStream($xobj,$pdf,$pdf->$page->{OBJ}->{Contents});
 
     $/=$keepsep;
     return($xonm,$BBox );
 }
 
+sub LoadStream
+{
+    my $o=shift;
+    my $pdf=shift;
+    my $l;
+
+    $l=$o->{OBJ}->{Length} if exists($o->{OBJ}->{Length});
+
+    $l=$pdf->$$l->{OBJ} if (defined($l) && ref($l) eq 'OBJREF');
+
+    Die("unable to determine length of stream \@$o->{STREAMPOS}->0")
+        if !defined($l);
+
+    sysseek(PD,$o->{STREAMPOS}->0,0);
+    Warn("failed to read all of the stream")
+        if $l != sysread(PD,$o->{STREAM},$l);
+
+    if ($gotzlib and exists($o->{OBJ}->{'Filter'}) and $o->{OBJ}->{'Filter'} eq '/FlateDecode')
+    {
+        $o->{STREAM}=Compress::Zlib::uncompress($o->{STREAM});
+        delete($o->{OBJ }->{'Filter'});
+    }
+}
+
 sub BuildStream
 {
     my $xobj=shift;
@@ -1685,7 +1934,7 @@
     }
     else
     {
-	Msg(0,"unexpected 'Contents'");
+        Warn("unexpected 'Contents'");
     }
 
     foreach my $o (@{$objs})
@@ -1707,7 +1956,7 @@
     my $val=shift;
 
 
-    foreach my $k (keys(%{$val}))
+    foreach my $k (sort keys(%{$val}))
     {
 	MapInsValue($pdf,$o,$k,$insmap,$parent,$val->{$k}) if $k ne 'Contents';
     }
@@ -1883,12 +2132,12 @@
 
 	my (@w)=split('/',$wd,3);
 
-	if ($w0)
-	{
-	    Msg(0,"PDF Dict Key '$wd' does not start with '/'");
-	    exit 1;
-	}
-	else
+        if ($w0)
+        {
+            Warn("PDF Dict Key '$wd' does not start with '/'");
+            exit 1;
+        }
+        else
 	{
 	    unshift(@{$pdfwds},"/$w2") if $w2;
 	    $wd=$w1;
@@ -2037,13 +2286,35 @@
     return($rtn);
 }
 
+sub Warn
+{
+    Msg(0,(@_));
+}
+
+sub Die
+{
+    Msg(1,(@_));
+}
+
 sub Msg
 {
-    my ($lev,$msg)=@_;
+    my ($fatal,$msg)=@_;
+
+    print STDERR "$prog:";
+    print STDERR "$env{SourceFile}:" if exists($env{SourceFile});
+    print STDERR " ";
+
+    if ($fatal)
+    {
+        print STDERR "fatal error: ";
+    }
+    else
+    {
+        print STDERR "warning: ";
+    }
 
-    print STDERR "$env{SourceFile}: " if exists($env{SourceFile});
     print STDERR "$msg\n";
-    exit 1 if $lev;
+    exit 1 if $fatal;
 }
 
 sub PutXY
@@ -2173,10 +2444,10 @@
     {
 	# Try with no foundry
 	$fontnm=~s/.*?-//;
-	OpenFile(\$f,$fontdir,$fontnm);
+        OpenFile(\$f,$fontdir,$fontnm);
     }
 
-    Msg(1,"Failed to open font '$ofontnm'") if !defined($f);
+    Die("unable to open font '$ofontnm' for mounting") if !defined($f);
 
     my $foundry='';
     $foundry=$1 if $fontnm=~m/^(.*?)-/;
@@ -2214,7 +2485,7 @@
 	    $stg=3,next if lc($_) eq 'charset';
 
 	    my ($ch1,$ch2,$k)=split;
-# 	    $fnt{KERN}->{$ch1}->{$ch2}=$k;
+#	    $fnt{KERN}->{$ch1}->{$ch2}=$k;
 	}
 	else
 	{
@@ -2223,17 +2494,19 @@
 
 	    if ($r1 eq '"')
 	    {
-		$fnt{NAM}->{$r0}=$fnt{NAM}->{$lastnm};
+		$fnt{NAM}->{$r0}=@{$fnt{NAM}->{$lastnm}};
 		next;
 	    }
 
+	    $r3=oct($r3) if substr($r3,0,1) eq '0';
 	    $r0='u0020' if $r3 == 32;
-	    $r0="u00".hex($r3) if $r0 eq '---';
-#	    next if $r3 >255;
-	    $fnt{NAM}->{$r0}=$p0,$r3,'/'.$r4,$r3,0;
-	    $fnt{NO}->$r3=$r0,$r0;
-	    $lastnm=$r0;
-	    $lastchr=$r3 if $r3 > $lastchr;
+            $r0="u00".hex($r3) if $r0 eq '---';
+#           next if $r3 >255;
+            $r4=$r0 if !defined($r4);
+            $fnt{NAM}->{$r0}=$p0,$r3,'/'.$r4,$r3,0;
+            $fnt{NO}->$r3=$r0,$r0;
+            $lastnm=$r0;
+            $lastchr=$r3 if $r3 > $lastchr;
 	    $fixwid=$p0 if $fixwid == -1;
 	    $fixwid=-2 if $fixwid > 0 and $p0 != $fixwid;
 
@@ -2268,12 +2541,13 @@
 
     if (exists($download{$fontkey}))
     {
-	# Not a Base Font
-	my ($l1,$l2,$l3,$t1stream)=GetType1($download{$fontkey});
-	Msg(0,"Incorrect font format for '$fontkey' ($l1)") if !defined($t1stream);
-	$fno=++$objct;
-	$fontlst{$fontno}->{OBJ}=BuildObj($objct,
-			{'Type' => '/Font',
+        # Not a Base Font
+        my ($l1,$l2,$l3,$t1stream)=GetType1($download{$fontkey});
+        Warn("incorrect font format for '$fontkey' ($l1)")
+            if !defined($t1stream);
+        $fno=++$objct;
+        $fontlst{$fontno}->{OBJ}=BuildObj($objct,
+                        {'Type' => '/Font',
 			'Subtype' => '/Type1',
 			'BaseFont' => '/'.$fnt{internalname},
 			'Widths' => $fnt{WIDTH},
@@ -2315,9 +2589,20 @@
     }
     else
     {
-	$fno=++$objct;
-	$fontlst{$fontno}->{OBJ}=BuildObj($objct,
-			{'Type' => '/Font',
+        if (exists($missing{$fontkey}))
+        {
+            Warn("The download file in '$missing{$fontkey}' "
+            . " has erroneous entry for '$fnt{internalname} ($ofontnm)'");
+        }
+        else
+        {
+            Warn("unable to embed font file for '$fnt{internalname}'"
+            . " ($ofontnm) (missing entry in 'download' file?)")
+            if $embedall;
+        }
+        $fno=++$objct;
+        $fontlst{$fontno}->{OBJ}=BuildObj($objct,
+                        {'Type' => '/Font',
 			'Subtype' => '/Type1',
 			'BaseFont' => '/'.$fnt{internalname},
 			'Widths' => $fnt{WIDTH},
@@ -2375,7 +2660,7 @@
     my $f;
 
     OpenFile(\$f,$fontdir,"$file");
-    Msg(1,"Failed to open '$file'") if !defined($f);
+    Die("unable to open font '$file' for embedding") if !defined($f);
 
     $head=GetChunk($f,1,"currentfile eexec");
     $body=GetChunk($f,2,"00000000") if !eof($f);
@@ -2419,21 +2704,17 @@
 		}
 
 		$type=$chunktype;
-		return if $chunktype == 3;
-
-		$ct=read($F,$hdr,4);
-
-		Msg(1,"Failed to read binary segment length"), return if $ct != 4;
-
-		my $sl=unpack('V',$hdr);
-		my $data;
-		my $chk=read($F,$data,$sl);
-
-		Msg(1 ,"Failed to read binary segment"), return if $chk != $sl;
-
-		$chunk.=$data;
-	    }
-	    else
+                return if $chunktype == 3;
+
+                $ct=read($F,$hdr,4);
+                Die("failed to read binary segment length") if $ct != 4;
+                my $sl=unpack('V',$hdr);
+                my $data;
+                my $chk=read($F,$data,$sl);
+                Die("failed to read binary segment") if $chk != $sl;
+                $chunk.=$data;
+            }
+            else
 	    {
 		# ascii chunk
 
@@ -2540,6 +2821,32 @@
 	    @{$cpage->{Annots}}=@PageAnnots;
 	}
 
+	if ($#bgstack > -1 or $bgbox)
+	{
+	    my $box="q 1 0 0 1 0 0 cm ";
+
+	    foreach my $bg (@bgstack)
+	    {
+		# 0=$bgtype # 1=stroke 2=fill. 4=page
+		# 1=$strkcol
+		# 2=$fillcol
+		# 3=(Left,Top,Right,bottom,LineWeight)
+		# 4=Start ypos
+		# 5=Endypos
+		# 6=Line Weight
+
+		my $pg=$bg->3 || \@defaultmb;
+
+		$bg->5=$pg->3;	# box is continuing to next page
+		$box.=DrawBox($bg);
+		$bg->4=$pg->1;	# will continue from page top
+	    }
+
+	    $stream=$box.$bgbox."Q\n".$stream;
+	    $bgbox='';
+	    $boxmax=0;
+	}
+
 	PutObj($cpageno);
 	OutStream($cpageno+1);
     }
@@ -2569,6 +2876,23 @@
 #    @mediabox=@defaultmb;
 }
 
+sub DrawBox
+{
+    my $bg=shift;
+    my $res='';
+    my $pg=$bg->3 || \@mediabox;
+    $bg->4=$pg->1, $bg->5=$pg->3 if $bg->0 & 4;
+    my $bot=$bg->5;
+    $bot=$boxmax if $boxmax > $bot;
+    my $wid=$pg->2-$pg->0;
+    my $dep=$bot-$bg->4;
+
+    $res="$bg->1 $bg->2 $bg->6 w\n";
+    $res.="$pg->0 $bg->4 $wid $dep re f " if $bg->0 & 1;
+    $res.="$pg->0 $bg->4 $wid $dep re s " if $bg->0 & 2;
+    return("$res\n");
+}
+
 sub MakeXO
 {
     $stream.="%mode=$mode\n";
@@ -2720,7 +3044,7 @@
     # PDF uses G/RG/K for graphic stroke, and g/rg/k for text & graphic fill.
     #
     # This means that we must maintain g/rg/k state separately for text colour & graphic fill (this is
-    # probably why 'gs' maintains seperate graphic states for text & graphics when distilling PS -> PDF).
+    # probably why 'gs' maintains separate graphic states for text & graphics when distilling PS -> PDF).
     #
     # To facilitate this:-
     #
@@ -3177,22 +3501,22 @@
 	    }
 	    else
 	    {
-    # 			$stream.="\%dg  0 Tw ";
+    #			$stream.="\%dg  0 Tw ";
     #
-    # 			foreach my $wd (@lin)
-    # 			{
-    #  				$stream.="($wd->0) " if defined($wd->0);
-    # 				$stream.="$wd->1 " if defined($wd->1) and $wd->1 != 0;
-    # 			}
+    #			foreach my $wd (@lin)
+    #			{
+    #				$stream.="($wd->0) " if defined($wd->0);
+    #				$stream.="$wd->1 " if defined($wd->1) and $wd->1 != 0;
+    #			}
     #
-    # 			$stream.=" TJ\n";
+    #			$stream.=" TJ\n";
     #
     #				my $wt=$lin0->1||0;
 
-    # 			while ($wt < -$whtsz/$cftsz)
-    # 			{
-    # 				$wt+=$whtsz/$cftsz;
-    # 			}
+    #			while ($wt < -$whtsz/$cftsz)
+    #			{
+    #				$wt+=$whtsz/$cftsz;
+    #			}
 
 		$stream.=sprintf( "%.3f Tw ",-($whtsz+$wt*$cftsz)/$unitwidth-$curkern );
 		if (!defined($lin0->0) and defined($lin0->1))
@@ -3397,12 +3721,12 @@
 
     $stream.="% --- wht=$whtsz, pend=$pendmv, nomv=$nomove\n" if $debug;
 
-# 	if ($w_flg && $#lin > -1)
-# 	{
-# 		$lin$#lin->0.=' ';
-# 		$pendmv-=$whtsz;
-# 		$dontglue=1 if $pendmv==0;
-# 	}
+#	if ($w_flg && $#lin > -1)
+#	{
+#		$lin$#lin->0.=' ';
+#		$pendmv-=$whtsz;
+#		$dontglue=1 if $pendmv==0;
+#	}
 
     $wt=-$pendmv/$cftsz if $w_flg and $wt==-1;
     $pendmv-=$nomove;
@@ -3413,15 +3737,15 @@
     {
 	PutLine(0) if $#lin > -1;
 	MakeMatrix(1);
-	$stream.="$matrix ".PutXY($xpos,$ypos)." Tm\n", $poschg=0;
-	$stream.="$curkern Tc\n";
-	$stream.="0 Tw ";
-	$stream.="($par) Tj\n";
-	MakeMatrix();
-	$stream.="$matrix ".PutXY($xpos,$ypos)." Tm\n", $poschg=0;
-	$matrixchg=0;
-	$stream.="$curkern Tc\n";
-	return;
+        $stream.="$matrix ".PutXY($xpos,$ypos)." Tm\n", $poschg=0;
+        $stream.="$curkern Tc\n";
+        $stream.="0 Tw ";
+        $stream.="($par) Tj\n";
+        MakeMatrix();
+        $stream.="$matrix ".PutXY($xpos,$ypos)." Tm\n", $poschg=0;
+        $matrixchg=0;
+        $stream.="$curkern Tc\n";
+        return;
     }
 
     if ($pendmv)
@@ -3541,11 +3865,12 @@
 
     if ($unused && $unused <= 255)
     {
-	my $glyph=$fnt->{NO}->$unused->1;
-	delete($fontlst{$cft}->{CACHE}->{$cftsz});
-	$fnt->{NAM}->{$chnm}->ASSIGNED=$unused;
-	$fnt->{NO}->$unused->1=$chnm;
-	$widtbl=CacheWid($cft);
+        my $glyph=$fnt->{NO}->$unused->1;
+        delete($fontlst{$cft}->{CACHE}->{$cftsz});
+        $fnt->{NAM}->{$chnm}->ASSIGNED=$unused;
+        $fnt->{NAM}->{$chnm}->USED=1;
+        $fnt->{NO}->$unused->1=$chnm;
+        $widtbl=CacheWid($cft);
 
 	$stream.="% AAA Assign $chnm ($ch) to $unused\n" if $debug;
 
@@ -3554,8 +3879,8 @@
     }
     else
     {
-	Msg(0,"Too many glyphs used in font '$cft'");
-	return(32);
+        Warn("too many glyphs used in font '$cft'");
+        return(32);
     }
 }
 
@@ -3576,8 +3901,8 @@
 
     if (!defined($fnt->{NO}->$par))
     {
-	Msg(0,"No chr($par) in font $fnt->{internalname}");
-	return;
+        Warn("no chr($par) in font $fnt->{internalname}");
+        return;
     }
 
     my $chnm=$fnt->{NO}->$par->0;
@@ -3594,10 +3919,10 @@
     PutHotSpot($xpos) if defined($mark);
 }
 
-
 1;
-########################################################################
-### Emacs settings
+
 # Local Variables:
+# fill-column: 72
 # mode: CPerl
 # End:
+# vim: set cindent noexpandtab shiftwidth=4 softtabstop=4 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/pdfmom.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/pdfmom.1.man Changed

@@ -1,13 +1,16 @@
-.TH PDFMOM @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-pdfmom \- produce PDF documents using the mom macro package for groff
+.TH pdfmom @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+pdfmom \- produce PDF documents using the
+.I mom
+macro package for
+.I groff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2012-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2012-2020 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
@@ -25,37 +28,60 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_pdfmom_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY pdfmom
-.OP \-Tpdf
+.RB  \-Tpdf 
 .RI  groff-options 
-.I file
-\&.\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY pdfmom
 .B \-Tps
 .RI  pdfroff-options 
 .RI  groff-options 
-.I file
-\&.\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY pdfmom
 .B \-v
+.
+.SY pdfmom
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I pdfmom
 is a wrapper around
-.IR groff (@MAN1EXT@)
+.MR groff @MAN1EXT@
 that facilitates the production of PDF documents from files
 formatted with the
 .I mom
@@ -66,9 +92,10 @@
 .I pdfmom
 prints to the standard output,
 so output must usually be redirected to a destination file.
+.
 The size of the final PDF can be reduced by piping the output
 through
-.IR ps2pdf (1).
+.MR ps2pdf 1 .
 .
 .
 .P
@@ -76,43 +103,47 @@
 .B \-Tpdf
 option (which is the default),
 .I pdfmom
-processes files using groff's native PDF driver,
-.IR gropdf (@MAN1EXT@).
+processes files using
+.IR groff 's
+native PDF driver,
+.MR gropdf @MAN1EXT@ .
 .
 If
 .B \-Tps
-is given, processing is passed over to
+is given,
+processing is passed over to
 .IR pdfroff ,
 which uses
 .IR groff 's
 PostScript driver.
 .
-In either case, multiple runs of the source file are performed in
-order to satisfy any forward references in the document.
+In either case,
+multiple runs of the source file are performed in order to satisfy any
+forward references in the document.
 .
 .
 .P
 .I pdfmom
 accepts all the same options as
 .IR groff .
+.
 If
 .B \-Tps
-is given, the options associated with
+is given,
+the options associated with
 .I pdfroff
 are accepted as well.
 .
-Please note that when
+When
 .I pdfmom
 calls
 .IR pdfroff ,
-the
-.RS
-.B \-mpdfmark \-mom \-\-no-toc
-.RE
-options are implied and should not be given on the
-command line.
-.
-Equally, it is not necessary to supply the
+the options
+.RB \lq "\-mpdfmark \-mom \-\-no\-toc" \rq
+options are implied and should not be given on the command line.
+.
+Equally,
+it is not necessary to supply the
 .B \-mom
 or
 .B "\-m\~mom"
@@ -125,7 +156,10 @@
 PDF integration with the
 .I mom
 macros is discussed in full in the manual
-.IR "Producing PDFs with groff and mom" ,
+\lqProducing PDFs with
+.I groff
+and
+.IR mom \rq,
 which was itself produced with
 .IR pdfmom .
 .
@@ -133,58 +167,63 @@
 .P
 If called with the
 .B \-v
-option,
+or
+.B \-\-version
+options,
 .I pdfmom
-simply displays its version information and exits.
+displays its version information and exits.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Authors
 .\" ====================================================================
 .
 .I pdfmom
-sometimes issues warnings of the type
-.RS
-\&.\|.\|.:
-can't transparently output node at top level
-.RE
-.
-but this is more of an annoyance than a bug, and may safely be ignored.
-.
-.
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.
-.I pfdmom
 was written by
-.MT deri@\:chuzzlewit.demon.co.uk
+.MT deri@\:chuzzlewit\:.myzen\:.co\:.uk
 Deri James
 .ME
 and
-.MT peter@\:schaffter.ca
+.MT peter@\:schaffter\:.ca
 Peter Schaffter
-.ME .
+.ME ,
+and is maintained by James.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR "Producing PDFs with groff and mom" ,
-by Deri James and Peter Schaffter;
-a copy is installed at
-.IR \%@PDFDOCDIR@/\:mom\-pdf.pdf .
+.TP
+.I @PDFDOCDIR@/\:mom\-pdf.pdf
+\lqProducing PDFs with
+.I groff
+and
+.IR mom \rq,
+by Deri James and Peter Schaffter.
+.
+This file,
+together with its source,
+.IR mom\-pdf.mom ,
+is part of the
+.I groff
+distribution.
 .
 .
 .P
-.IR groff (@MAN1EXT@),
-.IR gropdf (@MAN1EXT@),
-.IR pdfroff (@MAN1EXT@),
-.IR ps2pdf (1)
+.MR groff @MAN1EXT@ ,
+.MR gropdf @MAN1EXT@ ,
+.MR pdfroff @MAN1EXT@ ,
+.MR ps2pdf 1
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_pdfmom_1_man_C
+.do rr *groff_pdfmom_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/gropdf/pdfmom.pl -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/gropdf/pdfmom.pl Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grops/grops.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grops/grops.1.man Changed

@@ -1,18 +1,15 @@
-.TH GROPS @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grops \- PostScript driver for groff
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grops_C \n.C
-.cp 0
+.TH grops @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grops \-
+.I groff
+output driver for PostScript
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2018, 2020 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
@@ -30,118 +27,185 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grops_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" This macro definition is poor style from a portability standpoint,
+.\" but it's a good test and demonstration of the standard font
+.\" repertoire for the devices where it has any effect at all, and so
+.\" should be retained.
 .de FT
 .  if '\\*(.T'ps' .ft \\$1
 .  if '\\*(.T'pdf' .ft \\$1
 ..
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grops
-.OP \-glmv
-.OP \-b n
-.OP \-c n
-.OP \-F dir
-.OP \-I dir
-.OP \-p papersize
-.OP \-P prologue
-.OP \-w n
-.RI  file
-\&.\|.\|.\&
+.RB  \-glm 
+.RB  \-b\~\c
+.IR  brokenness-flags 
+.RB  \-c\~\c
+.IR num-copies 
+.RB  \-F\~\c
+.IR font-directory 
+.RB  \-I\~\c
+.IR inclusion-directory 
+.RB  \-p\~\c
+.IR paper-format 
+.RB  \-P\~\c
+.IR prologue-file 
+.RB  \-w\~\c
+.IR rule-thickness 
+.RI  file\~ .\|.\|.
 .YS
 .
 .
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
-.
-.B grops
-translates the output of GNU
-.B troff
-to PostScript.
+.SY grops
+.B \-\-help
+.YS
 .
-Normally
-.B grops
-should be invoked by using the groff command with a
-.B \-Tps
-option.
 .
-.if '@DEVICE@'ps' (Actually, this is the default for groff.)
+.SY grops
+.B \-v
 .
-If no files are given,
-.B grops
-reads the standard input.
+.SY grops
+.B \-\-version
+.YS
 .
-A filename of
-.B \-
-also causes
-.B grops
-to read the standard input.
 .
-PostScript output is written to the standard output.
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
 .
-When
-.B grops
-is run by
-.B groff
-options can be passed to
-.B grops
-using
-.BR groff 's
-.B \-P
+The GNU
+.I roff
+PostScript output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into PostScript.
+.
+Normally,
+.I grops
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given the
+.RB \lq \-T\~ps \rq
 option.
 .
+(In this installation,
+.B @DEVICE@
+is the default output device.)
 .
-.LP
-Note that
-.B grops
-doesn't produce a valid document structure (conforming to the
-Document Structuring Convention) if called with multiple file
-arguments.
+Use
+.IR groff 's
+.B \-P
+option to pass any options shown above to
+.IR grops .
+.
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I grotty
+reads the standard input stream.
+.
+Output is written to the standard output stream.
+.
+.
+.P
+When called with multiple
+.I file
+arguments,
+.I grops
+doesn't produce a valid document structure
+(one conforming to the Document Structuring Conventions).
+.
+To print such concatenated output,
+it is necessary to deactivate DSC handling in the printing program or
+previewer.
 .
-To print such concatenated output it is necessary to deactivate DSC
-handling in the printing program or previewer.
 .
-See section \lqFont Installation\rq below for a guide how to install
+.P
+See section \lqFont installation\rq below for a guide to installing
 fonts for
-.BR grops .
+.IR grops .
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
-.BI \-b n
-Provide workarounds for older printers, broken spoolers, and previewers.
+.BI \-b\~ n
+Work around problems with spoolers,
+previewers,
+and older printers.
 .
-Normally
-.B grops
-produces output at PostScript LanguageLevel\~2 that conforms to the
-Document Structuring Conventions version 3.0.
+Normally,
+.I grops
+produces output at PostScript \%LanguageLevel\~2 that conforms to
+version 3.0 of the Document Structuring Conventions.
 .
-Some older printers, spoolers, and previewers can't handle such
-output.
+Some software and devices can't handle such a data stream.
 .
-The value of\~\c
+The value
+.RI of\~ n
+determines what
+.I grops
+does to make its output acceptable to such consumers.
+.
+If
 .I n
-controls what
-.B grops
-does to make its output acceptable to such programs.
+is
+.BR 0 ,
+.I grops
+employs no workarounds,
+which is the default;
+it can be changed by modifying the
+.B broken
+directive in
+.IR grops 's
+.I DESC
+file.
 .
-A value of\~0 causes grops not to employ any workarounds.
 .
 .IP
-Add\~1 if no
+Add\~1 to suppress generation of
 .B %%Begin\%Document\%Setup
 and
 .B %%End\%Document\%Setup
-comments should be generated;
+comments;
 this is needed for early versions of TranScript that get confused by
 anything between the
 .B %%End\%Prolog
@@ -149,308 +213,327 @@
 .B %%Page
 comment.
 .
+.
 .IP
-Add\~2 if lines in included files beginning with
-.B %!\&
-should be stripped out; this is needed for Sun's pageview
+Add\~2 to omit lines in included files beginning with
+.BR %!\& ,
+which confuse Sun's
+.I pageview
 previewer.
 .
+.
 .IP
-Add\~4 if
+Add\~4 to omit lines in included files beginning with
 .BR %%Page ,
 .B %%Trailer
 and
-.B %%End\%Prolog
-comments should be
-stripped out of included files; this is needed for spoolers that
-don't understand the
+.BR %%End\%Prolog ;
+this is needed for spoolers that don't understand
 .B %%Begin\%Document
 and
 .B %%End\%Document
 comments.
 .
+.
 .IP
-Add\~8 if the first line of the PostScript output should be
-.B %!PS-Adobe-2.0
+Add\~8 to write
+.B %!PS\-Adobe\-2.0
 rather than
-.BR %!PS-Adobe-3.0 ;
-this is needed when using Sun's Newsprint with a printer that
-requires page reversal.
+.B %!PS\-Adobe\-3.0
+as the first line of the PostScript output;
+this is needed when using Sun's Newsprint with a printer that requires
+page reversal.
+.
 .
 .IP
-Add\~16 if no media size information should be included in the
-document (this is, neither use
+Add\~16 to omit media size information
+(that is,
+output neither a
 .B %%Document\%Media
-nor the
+comment nor the
 .B setpagedevice
 PostScript command).
 .
-This was the behaviour of groff version 1.18.1 and earlier; it is
-needed for older printers which don't understand PostScript
-LanguageLevel\~2.
+This was the behavior of
+.I groff
+1.18.1 and earlier;
+it is
+needed for older printers that don't understand PostScript
+\%LanguageLevel\~2,
+and is also necessary if the output is further processed to produce an
+EPS file;
+see subsection \lqEscapsulated PostScript\rq below.
 .
-It is also necessary if the output is further processed to get an
-encapsulated PS (EPS) file \en see below.
-.
-.IP
-The default value can be specified by a
-.
-.RS
-.IP
-.BI broken\  n
-.
-.LP
-command in the
-.I DESC
-file.
-.
-Otherwise the default value is\~0.
-.RE
 .
 .TP
-.BI \-c n
-Print
+.BI \-c\~ n
+Output
 .I n
 copies of each page.
 .
+.
 .TP
-.BI \-F dir
+.BI \-F\~ dir
 Prepend directory
 .RI dir /dev name
-to the search path for prologue, font, and device description files;
+to the search path for
+font and device description and PostScript prologue files;
 .I name
-is the name of the device, usually
+is the name of the device,
+usually
 .BR ps .
 .
+.
 .TP
 .B \-g
-Guess the page length.
+Generate PostScript code to guess the page length.
 .
-This generates PostScript code that guesses the page length.
+The guess is correct only if the imageable area is vertically centered
+on the page.
 .
-The guess is correct only if the imageable area is vertically
-centered on the page.
+This option allows you to generate documents that can be printed on both
+U.S.\& letter and A4 paper formats without change.
 .
-This option allows you to generate documents that can be printed
-both on letter (8.5\mu11) paper and on A4 paper without change.
 .
 .TP
-.BI \-I dir
-This option may be used to add a directory to the search path for
-files on the command line and files named in
-.B \rsX'ps: import'
+.BI \-I\~ dir
+Search the directory
+.I dir
+for files named in
+.B \rsX\aqps: file\aq
 and
-.B \rsX'ps: file'
-escapes.
-.
-The search path is initialized with the current directory.
+.B \rsX\aqps: import\aq
+escape sequences.
 .
-This option may be specified more than once; the directories are then
-searched in the order specified (but before the current directory).
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-If you want to make the current directory be read before other directories,
+To search the current working directory before others,
 add
-.B \-I.\&
-at the appropriate place.
+.RB \lq "\-I .\&" \rq
+at the desired place;
+it is otherwise searched last.
 .
-.IP
-No directory search is performed for files with an absolute file name.
 .
 .TP
 .B \-l
-Print the document in landscape format.
+Use landscape orientation rather than portrait.
+.
 .
 .TP
 .B \-m
-Turn manual feed on for the document.
+Turn on manual feed for the document.
 .
-.TP
-.BI \-p paper-size
-Set physical dimension of output medium.
 .
-This overrides the
-.BR papersize ,
-.BR paperlength ,
+.TP
+.BI \-p\~ fmt
+Set physical dimensions of output medium,
+overriding the
+.BR \%papersize ,
+.BR \%paperlength ,
 and
-.B paperwidth
-commands in the
+.B \%paperwidth
+directives in the
 .I DESC
-file; it accepts the same arguments as the
-.B papersize
-command.
+file.
+.
+.I fmt
+can be any argument accepted by the
+.B \%papersize
+directive;
+see
+.MR groff_font @MAN5EXT@ .
 .
-See
-.B groff_font (@MAN5EXT@)
-for details.
 .
 .TP
-.BI \-P prologue-file
+.BI \-P\~ prologue
 Use the file
-.I prologue-file
-(in the font path) as the prologue instead of the default prologue file
-.BR prologue .
-.
-This option overrides the environment variable
+.IR prologue ,
+sought in the
+.I groff
+font search path,
+as the PostScript prologue,
+overriding the default
+(see section \lqFiles\rq below)
+and the environment variable
 .I GROPS_PROLOGUE.
 .
-.TP
-.BI \-w n
-Lines should be drawn using a thickness of
-.IR n \~\c
-thousandths of an em.
-.
-If this option is not given, the line thickness defaults to 0.04\~em.
 .
 .TP
-.B \-v
-Print the version number.
+.BI \-w\~ n
+Draw rules (lines) with a thickness of
+.IR n \~thousandths
+of an em.
+.
+The default thickness is
+.B 40
+(0.04\~em).
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
 The input to
-.B grops
+.I grops
 must be in the format output by
-.BR @g@troff (@MAN1EXT@).
-.
-This is described in
-.BR groff_out (@MAN5EXT@).
+.MR @g@troff @MAN1EXT@ ,
+described in
+.MR groff_out @MAN5EXT@ .
 .
-.LP
-In addition, the device and font description files for the device used
-must meet certain requirements:
+In addition,
+the device and font description files for the device used must meet
+certain requirements.
 .
-The resolution must be an integer multiple of\~72 times the
+The device resolution must be an integer multiple of\~72 times the
 .BR sizescale .
 .
-The
-.B ps
-device uses a resolution of 72000 and a sizescale of 1000.
-.
+The device description file must contain a valid paper format;
+see
+.MR groff_font @MAN5EXT@ .
 .
-.LP
-The device description file must contain a valid paper size; see
-.BR groff_font (@MAN5EXT@)
-for more information.
+Each font description file must contain a directive
 .
+.RS
+.EX
+.RI internalname\~ psname
+.EE
+.RE
 .
-.LP
-Each font description file must contain a command
-.IP
-.BI internalname\  psname
-.LP
 which says that the PostScript name of the font is
 .IR psname .
 .
-It may also contain a command
-.IP
-.BI encoding\  enc_file
-.LP
+.
+.P
+A font description file may also contain a directive
+.
+.RS
+.EX
+.RI encoding\~ enc-file
+.EE
+.RE
+.
 which says that
 the PostScript font should be reencoded using the encoding described in
-.IR enc_file ;
-this file should consist of a sequence of lines of the form:
-.IP
-.I
-pschar code
-.LP
+.IR enc-file ;
+this file should consist of a sequence of lines of the form
+.
+.
+.RS
+.EX
+.I pschar code
+.EE
+.RE
+.
 where
 .I pschar
 is the PostScript name of the character,
 and
 .I code
-is its position in the encoding expressed as a decimal integer; valid
-values are in the range 0 to\~255.
+is its position in the encoding expressed as a decimal integer;
+valid values are in the range 0 to\~255.
 .
 Lines starting with
 .B #
 and blank lines are ignored.
 .
-The code for each character given in the font file must correspond
-to the code for the character in encoding file, or to the code in the default
-encoding for the font if the PostScript font is not to be reencoded.
+The code for each character given in the font description file must
+correspond to the code for the character in encoding file,
+or to the code in the default encoding for the font if the PostScript
+font is not to be reencoded.
 .
 This code can be used with the
 .B \rsN
 escape sequence in
-.B troff
+.I @g@troff
 to select the character,
-even if the character does not have a groff name.
-.
-Every character in the font file must exist in the PostScript font, and
-the widths given in the font file must match the widths used
-in the PostScript font.
-.
-.B grops
-assumes that a character with a groff name of
+even if it does not have a
+.I groff
+glyph name.
+.
+Every character in the font description file must exist in the
+PostScript font,
+and the widths given in the font description file must match the widths
+used in the PostScript font.
+.
+.I grops
+assumes that a character with a
+.I groff
+name of
 .B space
-is blank (makes no marks on the page);
+is blank
+(makes no marks on the page);
 it can make use of such a character to generate more efficient and
 compact PostScript output.
 .
 .
-.LP
-Note that
-.B grops
-is able to display all glyphs in a PostScript font, not only 256.
-.I enc_file
-(or the default encoding if no encoding file specified) just defines the
-order of glyphs for the first 256 characters; all other glyphs are
-accessed with additional encoding vectors which
-.B grops
+.P
+.I grops
+is able to display all glyphs in a PostScript font;
+it is not limited to 256 of them.
+.
+.I enc-file
+(or the default encoding if no encoding file is specified)
+just defines the
+order of glyphs for the first 256 characters;
+all other glyphs are accessed with additional encoding vectors which
+.I grops
 produces on the fly.
 .
 .
-.LP
-.B grops
-can automatically include the downloadable fonts necessary
-to print the document.
+.P
+.I grops
+can embed fonts in a document that are necessary to render it;
+this is called \lqdownloading\rq.
 .
 Such fonts must be in PFA format.
 .
 Use
-.BR \%pfbtops (@MAN1EXT@)
+.MR pfbtops @MAN1EXT@
 to convert a Type\~1 font in PFB format.
 .
-Any downloadable fonts which should, when required, be included by
-.B grops
-must be listed in the file
-.IR @FONTDIR@/devps/download ;
-this should consist of lines of the form
-.
-.IP
-.I
-font filename
+Downloadable fonts must be listed a
+.I download
+file containing lines of the form
 .
+.RS
+.EX
+.I psname file
+.EE
+.RE
 .
-.LP
 where
-.I font
+.I psname
 is the PostScript name of the font,
 and
-.I filename
-is the name of the file containing the font;
+.I file
+is the name of the file containing it;
 lines beginning with
 .B #
 and blank lines are ignored;
-fields may be separated by tabs or spaces;
-.I filename
-is searched for using the same mechanism that is used
-for groff font metric files.
+fields may be separated by tabs or spaces.
+.
+.I file
+is sought using the same mechanism as that for
+.I groff
+font description files.
 .
 The
 .I download
-file itself is also searched for using this mechanism;
-currently, only the first found file in the font path is used.
+file itself is also sought using this mechanism;
+currently,
+only the first matching file found in the device and font description
+search path is used.
 .
 .
-.LP
+.P
 If the file containing a downloadable font or imported document
 conforms to the Adobe Document Structuring Conventions,
 then
-.B grops
+.I grops
 interprets any comments in the files sufficiently to ensure that its
 own output is conforming.
 .
@@ -461,35 +544,32 @@
 .
 It is also able to handle inter-resource dependencies.
 .
-For example, suppose that you have a downloadable font called
-Garamond, and also a downloadable font called Garamond-Outline which
-depends on Garamond (typically it would be defined to copy
-Garamond's font dictionary, and change the PaintType), then it is
-necessary for Garamond to appear before Garamond-Outline in the
-PostScript document.
-.
-.B grops
+For example,
+suppose that you have a downloadable font called Garamond,
+and also a downloadable font called Garamond-Outline which depends on
+Garamond
+(typically it would be defined to copy Garamond's font dictionary,
+and change the PaintType),
+then it is necessary for Garamond to appear before Garamond-Outline in
+the PostScript document.
+.
+.I grops
 handles this automatically provided that the downloadable font file
 for Garamond-Outline indicates its dependence on Garamond by means of
-the Document Structuring Conventions, for example by beginning with
-the following lines
+the Document Structuring Conventions,
+for example by beginning with the following lines.
 .
-.IP
-.B
-%!PS-Adobe-3.0 Resource-Font
-.br
-.B
+.RS
+.EX
+%!PS\-Adobe\-3.0 Resource\-Font
 %%DocumentNeededResources: font Garamond
-.br
-.B
 %%EndComments
-.br
-.B
 %%IncludeResource: font Garamond
+.EE
+.RE
 .
-.
-.LP
-In this case both Garamond and Garamond-Outline would need to be listed
+In this case,
+both Garamond and Garamond-Outline would need to be listed
 in the
 .I download
 file.
@@ -499,8 +579,8 @@
 comment.
 .
 .
-.LP
-.B grops
+.P
+.I grops
 does not interpret
 .B %%Document\%Fonts
 comments.
@@ -524,9 +604,28 @@
 should be used.
 .
 .
-.LP
-In the default setup
-there are styles called
+.P
+The default stroke and fill color is black.
+.
+For colors defined in the \lqrgb\rq color space,
+.B setrgbcolor
+is used;
+for \lqcmy\rq and \lqcmyk\rq,
+.BR setcmykcolor ;
+and for \lqgray\rq,
+.BR setgray .
+.
+.B setcmykcolor
+is a PostScript \%LanguageLevel\~2 command and thus not available on
+some older printers.
+.
+.
+.\" ====================================================================
+.SS Typefaces
+.\" ====================================================================
+.
+.P
+Styles called
 .BR R ,
 .BR I ,
 .BR B ,
@@ -534,7 +633,7 @@
 .B BI
 mounted at font positions 1 to\~4.
 .
-The fonts are grouped into families
+Text fonts are grouped into families
 .BR A ,
 .BR BM ,
 .BR C ,
@@ -542,9 +641,9 @@
 .BR HN ,
 .BR N ,
 .BR P ,
-and\~\c
-.B T
-having members in each of these styles:
+.RB and\~ T ,
+each having members in each of these styles.
+.
 .
 .RS
 .TP
@@ -741,8 +840,11 @@
 .RE
 .
 .
-.LP
-There is also the following font which is not a member of a family:
+.br
+.ne 2v
+.P
+Another text font is not a member of a family.
+.
 .
 .RS
 .TP
@@ -753,81 +855,85 @@
 .RE
 .
 .
-.LP
-There are also some special fonts called
-.B S
-for the PS Symbol font, and
-.BR SS ,
-containing slanted lowercase Greek letters taken from PS Symbol.
-.
-Zapf Dingbats is available as
+.P
+Special fonts include
+.BR S ,
+the PostScript Symbol font;
 .BR ZD ,
-and a reversed version of ZapfDingbats (with symbols pointing in the opposite
-direction) is available as
-.BR ZDR ;
-most characters in these fonts are unnamed and must be accessed using
-.BR \rsN .
+Zapf Dingbats;
+.B SS
+(slanted symbol),
+which contains oblique forms of lowercase Greek letters derived from
+Symbol;
+.BR EURO ,
+which offers a Euro glyph for use with old devices lacking it;
+and
+.BR ZDR ,
+a reversed version of ZapfDingbats
+(with symbols flipped about the vertical axis).
 .
+Most glyphs in these fonts are unnamed and must be accessed using
+.BR \rsN .
 .
-.LP
-The default color for
-.B \rsm
-and
-.B \rsM
-is black; for colors defined in the \oqrgb\cq color space
-.B setrgbcolor
-is used, for \oqcmy\cq and \oqcmyk\cq
-.BR setcmykcolor ,
-and for \oqgray\cq
-.BR setgray .
+The last three are not standard PostScript fonts,
+but supplied by
+.I groff
+and therefore included in the default
+.I download
+file.
 .
-Note that
-.B setcmykcolor
-is a PostScript LanguageLevel\~2 command and thus not available on some
-older printers.
 .
+.\" ====================================================================
+.SS "Device control commands"
+.\" ====================================================================
 .
-.LP
-.B grops
-understands various X\~commands produced using the
+.I grops
+recognizes device control commands produced by the
 .B \rsX
-escape sequence;
-.B grops
-only interprets commands that begin with a
-.B ps:
+escape sequence,
+but interprets only those that begin with a
+.RB \lq ps: \rq
 tag.
 .
+.
 .TP
-.BI \rsX'ps:\ exec\  code '
-This executes the arbitrary PostScript commands in
+.BI "\rsX\aqps: exec\~" code \aq
+.RS
+Execute the arbitrary PostScript commands
 .IR code .
 .
-The PostScript currentpoint is set to the position of the
+The PostScript
+.I \%currentpoint
+is set to the
+.I groff
+drawing position when the
 .B \rsX
-command before executing
+escape sequence is interpreted before executing
 .IR code .
 .
-The origin is at the top left corner of the page,
-and y\~coordinates increase down the page.
+The origin is at the top left corner of the page;
+.IR x \~coordinates
+increase to the right,
+and
+.IR y \~coordinates
+down the page.
 .
-A procedure\~\c
-.B u
-is defined that converts groff units to the coordinate system in
-effect (provided the user doesn't change the scale).
+A
+.RB procedure\~ u
+is defined that converts
+.I groff
+basic units to the coordinate system in effect
+(provided the user doesn't change the scale).
 .
 For example,
 .
 .RS
-.IP
-.B
+.EX
 \&.nr x 1i
-.br
-.B
-\rsX'ps: exec \rsnx u 0 rlineto stroke'
-.br
+\rsX\aqps: exec \rsnx u 0 rlineto stroke\aq
+.EE
 .RE
 .
-.IP
 draws a horizontal line one inch long.
 .
 .I code
@@ -838,11 +944,13 @@
 .B def
 and
 .B mdef
-is on top of the dictionary stack.
+commands is on top of the dictionary stack.
 .
 If your code adds definitions to this dictionary,
 you should allocate space for them using
-.BI \rsX'ps\ mdef \ n '\fR.
+.RB \lq "\rsX\aqps: mdef\~"
+.IB n \aq\c
+\rq.
 .
 Any definitions persist only until the end of the page.
 .
@@ -855,9 +963,7 @@
 For example,
 .
 .RS
-.IP
-.nf
-.ft B
+.EX
 \&.nr x 1i
 \&.de y
 \&ps: exec
@@ -865,43 +971,51 @@
 \&stroke
 \&..
 \&\rsYy
-.ft R
-.fi
+.EE
+.RE
 .
-.LP
 is another way to draw a horizontal line one inch long.
 .
-Note the single backslash before \oqnx\cq \en the only reason to
-use a number register while defining the macro \oqy\cq is to
-convert a user-specified dimension \oq1i\cq to internal groff
-units which are in turn converted to PS units with the
+The single backslash before
+.RB \lq nx \rq\emthe
+only reason to use a register while defining the macro
+.RB \lq y \rq\emis
+to convert a user-specified dimension
+.RB \lq 1i \rq
+to
+.I groff
+basic units which are in turn converted to PostScript units with the
 .B u
 procedure.
 .
 .
-.LP
-.B grops
-wraps user-specified PostScript code into a dictionary, nothing more.
+.P
+.I grops
+wraps user-specified PostScript code into a dictionary,
+nothing more.
 .
-In particular, it doesn't start and end the inserted code with
+In particular,
+it doesn't start and end the inserted code with
 .B save
 and
 .BR restore ,
 respectively.
 .
-This must be supplied by the user, if necessary.
-.
+This must be supplied by the user,
+if necessary.
 .RE
 .
+.
 .TP
-.BI \rsX'ps:\ file\  name '
+.BI "\rsX\aqps: file\~" name \aq
 This is the same as the
 .B exec
 command except that the PostScript code is read from file
 .IR name .
 .
+.
 .TP
-.BI \rsX'ps:\ def\  code '
+.BI "\rsX\aqps: def\~" code \aq
 Place a PostScript definition contained in
 .I code
 in the prologue.
@@ -928,25 +1042,28 @@
 .I code
 can extend over multiple lines.
 .
+.
 .TP
-.BI \rsX'ps:\ mdef\  n\ code  '
+.BI "\rsX\aqps: mdef\~" "n code" \aq
 Like
 .BR def ,
 except that
 .I code
 may contain up to
-.IR n \~\c
-definitions.
+.IR n \~definitions.
 .
-.B grops
+.I grops
 needs to know how many definitions
 .I code
 contains
 so that it can create an appropriately sized PostScript dictionary
 to contain them.
 .
+.
 .TP
-.BI \rsX'ps:\ import\  file\ llx\ lly\ urx\ ury\ width\ \fR\fP\ height\ \fR\fP '
+.BI "\rsX\aqps: import\~" "file llx lly urx ury width\~"\c
+.RI  height \c
+.B \aq
 Import a PostScript graphic from
 .IR file .
 .
@@ -957,21 +1074,32 @@
 and
 .I ury
 give the bounding box of the graphic in the default PostScript
-coordinate system; they should all be integers;
+coordinate system.
+.
+They should all be integers:
 .I llx
 and
 .I lly
-are the x and y\~coordinates of the lower left
-corner of the graphic;
+are the
+.I x
+and
+.IR y \~coordinates
+of the lower left corner of the graphic;
 .I urx
 and
 .I ury
-are the x and y\~coordinates of the upper right corner of the graphic;
+are the
+.I x
+and
+.IR y \~coordinates
+of the upper right corner of the graphic;
 .I width
 and
 .I height
-are integers that give the desired width and height in groff
-units of the graphic.
+are integers that give the desired width and height in
+.I groff
+basic units of the graphic.
+.
 .
 .IP
 The graphic is scaled so that it has this width and height
@@ -981,13 +1109,17 @@
 command.
 .
 If the height argument is omitted it is scaled uniformly in the
-x and y\~directions so that it has the specified width.
+.I x
+and
+.IR y \~axes
+so that it has the specified width.
+.
 .
 .IP
-Note that the contents of the
+The contents of the
 .B \rsX
 command are not interpreted by
-.BR troff ;
+.IR @g@troff ,
 so vertical space for the graphic is not automatically added,
 and the
 .I width
@@ -995,99 +1127,111 @@
 .I height
 arguments are not allowed to have attached scaling indicators.
 .
+.
 .IP
 If the PostScript file complies with the Adobe Document Structuring
 Conventions and contains a
 .B %%Bounding\%Box
-comment, then the bounding box can be automatically
-extracted from within groff by using the
+comment,
+then the bounding box can be automatically extracted from within
+.I groff
+input by using the
 .B psbb
 request.
 .
+.
 .IP
 See
-.BR groff_tmac (@MAN5EXT@)
+.MR groff_tmac @MAN5EXT@
 for a description of the
 .B PSPIC
 macro which provides a convenient high-level interface for inclusion of
 PostScript graphics.
 .
+.
 .TP
-.B \rsX'ps:\ invis'
+.B \rsX\aqps: invis\aq
 .TQ
-.B \rsX'ps:\ endinvis'
+.B \rsX\aqps: endinvis\aq
 No output is generated for text and drawing commands
 that are bracketed with these
 .B \rsX
 commands.
 .
 These commands are intended for use when output from
-.B troff
+.I @g@troff
 is previewed before being processed with
-.BR grops ;
+.IR grops ;
 if the previewer is unable to display certain characters
-or other constructs, then other substitute characters or constructs
-can be used for previewing by bracketing them with these
+or other constructs,
+then other substitute characters or constructs can be used for
+previewing by bracketing them with these
 .B \rsX
 commands.
 .
 .
 .RS
-.LP
+.P
 For example,
-.B \%gxditview
+.I \%gxditview
 is not able to display a proper
-.B \rs(em
+.B \rsem
 character because the standard X11 fonts do not provide it;
 this problem can be overcome by executing the following
 request
 .
+.
 .IP
-.ft B
-.nf
-\&.char \rs(em \rsX'ps: invis'\rs
-\rsZ'\rsv'-.25m'\rsh'.05m'\rsD'l .9m 0'\rsh'.05m''\rs
-\rsX'ps: endinvis'\rs(em
-.ft
-.fi
+.EX
+\&.char \rsem \rsX\aqps: invis\aq\rs
+\rsZ\aq\rsv\aq-.25m\aq\rsh\aq.05m\aq\c
+\rsD\aql .9m 0\aq\rsh\aq.05m\aq\aq\rs
+\rsX\aqps: endinvis\aq\rsem
+.EE
 .
 .
-.LP
+.P
 In this case,
-.B \%gxditview
+.I \%gxditview
 is unable to display the
-.B \rs(em
+.B \rsem
 character and draws the line,
 whereas
-.B grops
+.I grops
 prints the
-.B \rs(em
+.B \rsem
 character
-and ignores the line (this code is already in file
-.B Xps.tmac
+and ignores the line
+(this code is already in file
+.IR Xps.tmac ,
 which is loaded if a document intended for
-.B grops
+.I grops
 is previewed with
-.BR \%gxditview ).
+.IR \%gxditview ).
 .RE
 .
 .
-.LP
+.P
 If a PostScript procedure
 .B BPhook
 has been defined via a
-.RB \oq ps:\ def \cq
+.RB \lq "ps: def" \rq
 or
-.RB \oq ps:\ mdef \cq
-device command, it is executed at the beginning of every page (before
-anything is drawn or written by groff).
+.RB \lq "ps: mdef" \rq
+device control command,
+it is executed at the beginning of every page
+(before anything is drawn or written by
+.IR groff ).
+.
+For example,
+to underlay the page contents with the word \lqDRAFT\rq in light
+gray,
+you might use
+.
 .
-For example, to underlay the page contents with the word
-\oqDRAFT\cq in light gray, you might use
 .RS
-.LP
-.nf
-.ft B
+.P
+.EX
 \&.de XX
 ps: def
 /BPhook
@@ -1099,312 +1243,446 @@
 def
 \&..
 \&.devicem XX
-.ft R
-.fi
+.EE
 .RE
-.LP
-Or, to cause lines and polygons to be drawn with square linecaps
-and mitered linejoins instead of the round linecaps and linejoins
-normally used by
-.BR grops ,
+.
+.
+.P
+Or,
+to cause lines and polygons to be drawn with square linecaps and mitered
+linejoins instead of the round linecaps and linejoins normally used by
+.IR grops ,
 use
+.
 .RS
-.LP
-.nf
-.ft B
+.EX
 \&.de XX
 ps: def
 /BPhook { 2 setlinecap 0 setlinejoin } def
 \&..
 \&.devicem XX
-.ft R
-.fi
+.EE
 .RE
-.LP
-(square linecaps, as opposed to butt linecaps (0 setlinecap),
-give true corners in boxed tables even though the lines are
-drawn unconnected).
+.
+(square linecaps,
+as opposed to butt linecaps
+.RB (\lq "0 setlinecap" \rq),
+give true corners in boxed tables even though the lines are drawn
+unconnected).
 .
 .
 .\" ====================================================================
-.SS Encapsulated PostScript
+.SS "Encapsulated PostScript"
 .\" ====================================================================
 .
-.B grops
+.I grops
 itself doesn't emit bounding box information.
 .
-With the help of Ghostscript the following simple script,
-.BR groff2eps ,
-produces an encapsulated PS file.
+The following script,
+.IR groff2eps ,
+produces an EPS file.
 .
 .
 .RS
-.LP
-.nf
-.ft B
+.P
+.EX
 #! /bin/sh
-groff \-P\-b16 $1 > $1.ps
-gs \-dNOPAUSE \-sDEVICE=bbox \-\- $1.ps 2> $1.bbox
+groff \-P\-b16 "$1" > "$1".ps
+gs \-dNOPAUSE \-sDEVICE=bbox \-\- "$1".ps 2> "$1".bbox
 sed \-e "/\ha%%Orientation/r $1.bbox" \rs
-    \-e "/\ha%!PS-Adobe-3.0/s/$/ EPSF-3.0/" $1.ps > $1.eps
-rm $1.ps $1.bbox
-.ft R
-.fi
+    \-e "/\ha%!PS\-Adobe\-3.0/s/$/ EPSF\-3.0/" "$1".ps > "$1".eps
+rm "$1".ps "$1".bbox
+.EE
 .RE
 .
 .
-.LP
-Just say
-.
-.IP
-.B
-groff2eps foo
-.
-.LP
+.P
+You can then use
+.RB \lq "groff2eps foo" \rq
 to convert file
-.B foo
+.I foo
 to
-.BR foo.eps .
+.IR foo.eps .
 .
 .
 .\" ====================================================================
-.SS TrueType and other font formats
+.SS "TrueType and other font formats"
 .\" ====================================================================
 .
 TrueType fonts can be used with
-.B grops
-if converted first to
-.B "Type\~42"
-format, a special PostScript wrapper equivalent to the PFA format
-mentioned in
-.BR \%pfbtops (@MAN1EXT@).
-.
-There are several different methods to generate a type42 wrapper and
-most of them involve the use of a PostScript interpreter such as
-Ghostscript \en see
-.BR gs (1).
-.
-.
-.LP
-Yet, the easiest method involves the use of the application
-.BR ttftot42 (1).
-.
-This program uses
-.BR freetype (3)
-(version 1.3.1) to generate type42
-font wrappers and well-formed AFM files that can be fed to
-the
-.BR \%afmtodit (@MAN1EXT@)
-script to create appropriate metric files.
+.I grops
+if converted first to Type\~42 format,
+a PostScript wrapper equivalent to the PFA format described in
+.MR pfbtops @MAN1EXT@ .
+.
+Several methods exist to generate a Type\~42 wrapper;
+some of them involve the use of a PostScript interpreter such as
+Ghostscript\emsee
+.MR gs 1 .
+.
+.
+.P
+One approach is to use
+.UR https://fontforge.org/
+FontForge
+.UE ,
+a font editor that can convert most outline font formats.
+.
+Here's an example of using the Roboto Slab Serif font with
+.IR groff .
+.
+Several variables are used so that you can more easily adapt it into
+your own script.
+.
+.
+.RS 4
+.P
+.EX
+MAP=@FONTDIR@/devps/generate/text.map
+TTF=/usr/share/fonts/truetype/roboto/slab/RobotoSlab\-Regular.ttf
+BASE=$(basename \dq$TTF\dq)
+INT=${BASE%.ttf}
+PFA=$INT.pfa
+AFM=$INT.afm
+GFN=RSR
+DIR=$HOME/.local/groff/font
+mkdir \-p \dq$DIR\dq/devps
+fontforge \-lang=ff \-c \dqOpen(\rs\dq$TTF\rs\dq);\rs
+\tGenerate(\rs\dq$DIR/devps/$PFA\rs\dq);\dq
+afmtodit \dq$DIR/devps/$AFM\dq \dq$MAP\dq \
+\dq$DIR/devps/$GFN\dq
+printf \dq$BASE\rst$PFA\rsn\dq >> \dq$DIR/devps/download\dq
+.EE
+.RE
 .
-The resulting font wrappers should be added to the
-.I download
-file.
-.B ttftot42
-source code can be downloaded from
-.UR ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/
-ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/
-.UE .
+.
+.P
+.I fontforge
+and
+.I afmtodit
+may generate warnings depending on the attributes of the font.
+.
+The test procedure is simple.
+.
+.
+.RS 4
+.P
+.EX
+printf \dq.ft RSR\rsnHello, world!\rsn\dq | groff \-F \
+\dq$DIR\dq > hello.ps
+.EE
+.RE
 .
 .
-.LP
-Another solution for creating type42 wrappers is to use FontForge,
-available from
-.UR http://\:fontforge.sf.net
-http://\:fontforge.sf.net
-.UE .
-This font editor can convert most outline font formats.
+.P
+Once you're satisfied that the font works,
+you may want to generate any available related styles
+(for instance,
+Roboto Slab
+also has \lqBold\rq,
+\lqLight\rq,
+and
+\lqThin\rq
+styles)
+and set up
+.I GROFF_FONT_PATH
+in your environment to include the directory you keep the generated
+fonts in so that you don't have to use the
+.B \-F
+option.
 .
 .
 .\" ====================================================================
-.SH "FONT INSTALLATION"
+.SH "Font installation"
 .\" ====================================================================
 .
-This section gives a summary of the above explanations; it can serve
-as a step-by-step font installation guide for
-.BR grops .
+The following is a step-by-step font installation guide for
+.I grops.
 .
-.ds BU \bu\ \ \"
-.de LI
-.IP "" 4
-\h'-\w'\*BU'u'\*BU\c
-..
-.LI
-Convert your font to something groff understands.
 .
-This is either a PostScript Type\~1 font in PFA format or a PostScript
-Type\~42 font, together with an AFM file.
+.IP \bu 2n
+Convert your font to something
+.I groff
+understands.
 .
-.IP
-The very first characters in a PFA file look like this:
+This is a PostScript Type\~1 font in PFA format or a PostScript
+Type\~42 font,
+together with an AFM file.
+.
+A PFA file begins as follows.
 .
 .RS
-.IP
-.B %!PS-AdobeFont-1.0:
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+%!PS\-AdobeFont\-1.0:
+.EE
 .RE
 .
-.IP
-A PFB file has this also in the first line, but the string is
-preceded with some binary bytes.
+A PFB file contains this string as well,
+preceded by some non-printing bytes.
 .
-.IP
-The very first characters in a Type\~42 font file look like this:
+If your font is in PFB format,
+use
+.IR groff 's
+.MR pfbtops @MAN1EXT@
+program to convert it to PFA.
+.
+For TrueType and other font formats,
+we recommend
+.IR fontforge ,
+which can convert most outline font formats.
+.
+A Type\~42 font file begins as follows.
 .
 .RS
-.IP
-.B %!PS-TrueTypeFont
+.EX
+%!PS\-TrueTypeFont
+.EE
 .RE
 .
-.IP
 This is a wrapper format for TrueType fonts.
 .
-Old PS printers might not support it (this is, they don't have a
-built-in TrueType font interpreter).
+Old PostScript printers might not support them
+(that is,
+they might not have a built-in TrueType font interpreter).
 .
-.IP
-If your font is in PFB format (such fonts normally have
-.I .pfb
-as the file extension), you might use groff's
-.BR \%pfbtops (@MAN1EXT@)
-program to convert it to PFA.
+In the following steps,
+we will consider the use of CTAN's
+.UR https://\:ctan.org/\:tex\-archive/\:fonts/\:brushscr
+BrushScriptX-Italic
+.UE
+font in PFA format.
+.RE \" now restore left margin
 .
-For TrueType fonts, try
-.B ttftot42
-or
-.BR fontforge .
-For all other font formats use
-.B fontforge
-which can convert most outline font formats.
 .
-.LI
-Convert the AFM file to a groff font description file with the
-.BR \%afmtodit (@MAN1EXT@)
+.IP \bu
+Convert the AFM file to a
+.I groff
+font description file with the
+.MR afmtodit @MAN1EXT@
 program.
 .
-An example call is
+For instance,
 .
 .RS
-.IP
-afmtodit Foo-Bar-Bold.afm textmap FBB
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+$ \c
+.B afmtodit BrushScriptX\-Italic.afm text.map BSI
+.EE
 .RE
 .
+converts the Adobe Font Metric file
+.I BrushScriptX\-Italic.afm
+to the
+.I groff
+font description file
+.IR BSI .
+.RE \" now restore left margin
+.
+.
 .IP
-which converts the metric file
-.I Foo-Bar-Bold.afm
-to the groff
-font
-.IR FBB .
-.
-If you have a font family which comes with normal, bold, italic,
-and bold italic faces, it is recommended to use the letters
+If you have a font family which provides regular upright (roman),
+bold,
+italic,
+and
+bold-italic styles
+(where \lqitalic\rq may be \lqoblique\rq or \lqslanted\rq),
+we recommend using the letters
 .BR R ,
 .BR B ,
 .BR I ,
 and
 .BR BI ,
-respectively, as postfixes in the groff font names to make groff's
-\oq.fam\cq request work.
-.
-An example is groff's built-in Times-Roman font: The font family
-name is
+respectively,
+as suffixes to the
+.I groff
+font family name to enable
+.IR groff 's
+font family and style selection features.
+.
+An example is
+.IR groff 's
+built-in support for Times:
+the font family
+name is abbreviated as
 .BR T ,
-and the groff font names are
+and the
+.I groff
+font names are therefore
 .BR TR ,
 .BR TB ,
 .BR TI ,
 and
 .BR TBI .
 .
-.LI
-Install both the groff font description files and the fonts in a
+In our example,
+however,
+the BrushScriptX font is available in a single style only,
+italic.
+.
+.
+.IP \bu
+Install the
+.I groff
+font description file(s) in a
 .I devps
-subdirectory of the font path which groff finds.
+subdirectory in the search path that
+.I groff
+uses for device and font file descriptions.
 .
-See section \lqEnvironment\rq in
-.BR troff (@MAN1EXT@)
-for the actual value of the font path.
+See the
+.I GROFF_FONT_PATH
+entry in section \lqEnvironment\rq of
+.MR @g@troff @MAN1EXT@
+for the current value of the font search path.
 .
-Note that groff doesn't use the AFM files (but it is a good idea
-to store them anyway).
+While
+.I groff
+doesn't directly use AFM files,
+it is a good idea to store them alongside its font description files.
 .
-.LI
-Register all fonts which must be downloaded to the printer in the
+.
+.IP \bu
+Register fonts in the
 .I devps/download
-file.
+file so they can be located for embedding in PostScript files
+.I grops
+generates.
 .
-Only the first occurrence of this file in the font path is read.
+Only the first
+.I download
+file encountered in the font search path is read.
 .
-This means that you should copy the default
+If in doubt,
+copy the default
 .I download
-file to the first directory in your font path and add your fonts there.
+file
+(see section \lqFiles\rq below)
+to the first directory in the font search path and add your fonts there.
 .
-To continue the above example we assume that the PS font name for
-.I Foo-Bar-Bold.pfa
-is \oqXY-Foo-Bar-Bold\cq (the PS font name is stored in the
+The PostScript font name used by
+.I grops
+is stored in the
 .B internalname
 field in the
-.I FBB
-file),
-thus the following line should be added to
+.I groff
+font description file.
+.
+(This name does not necessarily resemble the font's file name.)
+.
+We add the following line to
 .IR download .
 .
 .RS
-.IP
-.B XY-Foo-Bar-Bold Foo-Bar-Bold.pfa
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+BrushScriptX\-Italic\->BrushScriptX\-Italic.pfa
+.EE
+.RE \" but only one to get back to it
+.
+A tab character,
+depicted as \->,
+separates the fields.
+.RE \" now restore left margin
+.
+.
+.IP \bu
+Test the selection and embedding of the new font.
 .
+.RS
+.RS \" two RS calls to get inboard of IP indentation
+.EX
+printf "\rs\rsfBSIHello, world!\rsn" \
+| groff \-T ps \-P \-e >hello.ps
+see hello.pdf
+.EE
 .RE
+.RE \" now restore left margin
 .
 .
 .\" ====================================================================
-.SH OLD FONTS
+.SH "Old fonts"
 .\" ====================================================================
 .
-groff versions 1.19.2 and earlier contain a slightly different set of
-the 35 Adobe core fonts; the difference is mainly the lack of the
-\oqEuro\cq glyph and a reduced set of kerning pairs.
-.
-For backwards compatibility, these old fonts are installed also in the
+.I groff
+versions 1.19.2 and earlier contained descriptions of a slightly
+different set of the base 35 PostScript level 2 fonts defined by Adobe.
 .
-.IP
-.I @OLDFONTDIR@/devps
+The older set has 229 glyphs and a larger set of kerning pairs;
+the newer one has 314 glyphs and includes the Euro glyph.
 .
-.LP
+For backwards compatibility,
+these old font descriptions are also installed in the
+.I @OLDFONTDIR@/\:\%devps
 directory.
 .
 .
-.LP
-To use them, make sure that
-.B grops
-finds the fonts before the default system fonts (with the same names):
-Either add command-line option
+.P
+To use them,
+make sure that
+.I grops
+finds the fonts before the default system fonts
+(with the same names):
+either give
+.I grops
+the
 .B \-F
-to
-.B grops
+command-line option,
 .
-.IP
-.B groff \-Tps \-P\-F \-P@OLDFONTDIR@ .\|.\|.
+.RS
+.EX
+$ \c
+.B groff \-Tps \-P\-F \-P@OLDFONTDIR@ \c
+\&.\|.\|.
+.EE
+.RE
 .
-.LP
-or add the directory to groff's font path environment variable
+or add the directory to
+.IR groff 's
+font and device description search path environment variable,
 .
-.IP
-.B GROFF_FONT_PATH=@OLDFONTDIR@
+.RS
+.EX
+$ \c
+.B GROFF_FONT_PATH=\:@OLDFONTDIR@ \rs
+.RS
+.B groff \-Tps \c
+\&.\|.\|.
+.RE
+.EE
+.RE
+.
+when the command runs.
 .
 .
+.br
+.ne 3v
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
+.I GROFF_FONT_PATH
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
+.
+See
+.MR @g@troff @MAN1EXT@
+and
+.MR groff_font @MAN5EXT@ .
+.
+.
+.TP
 .I GROPS_PROLOGUE
 If this is set to
 .IR foo ,
 then
-.B grops
+.I grops
 uses the file
 .I foo
 (in the font path) instead of the default prologue file
-.BR prologue .
+.IR prologue .
 .
 The option
 .B \-P
@@ -1412,98 +1690,142 @@
 .
 .
 .TP
-.I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+.I SOURCE_DATE_EPOCH
+A timestamp
+(expressed as seconds since the Unix epoch)
+to use as the output creation timestamp in place of the current time.
 .
-See
-.BR @g@troff (@MAN1EXT@)
-and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+The time is converted to human-readable form using
+.MR ctime 3
+and recorded in a PostScript comment.
 .
 .
 .TP
-.I SOURCE_DATE_EPOCH
-A timestamp (expressed as seconds since the Unix epoch) to use as the
-creation timestamp in place of the current time.
+.I TZ
+The time zone to use when converting the current time
+(or value of
+.IR SOURCE_DATE_EPOCH )
+to human-readable form;
+see
+.MR tzset 3 .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devps/DESC
-Device description file.
+.I @FONTDIR@/\:\%devps/\:DESC
+describes the
+.B ps
+output device.
+.
+.
+.TP
+.IR @FONTDIR@/\:\%devps/ F
+describes the font known
+.RI as\~ F
+on device
+.BR ps .
+.
 .
 .TP
-.IR @FONTDIR@/devps/ F
-Font description file for font
-.IR F .
+.I @FONTDIR@/\:\%devps/\:\%download
+lists fonts available for embedding within the PostScript document
+(or download to the device).
+.
 .
 .TP
-.I @FONTDIR@/devps/download
-List of downloadable fonts.
+.I @FONTDIR@/\:\%devps/\:\%prologue
+is the default PostScript prologue prefixed to every output file.
+.
 .
 .TP
-.I @FONTDIR@/devps/text.enc
-Encoding used for text fonts.
+.I @FONTDIR@/\:\%devps/\:text.enc
+describes the encoding scheme used by most PostScript Type\~1 fonts;
+the
+.B \%encoding
+directive of
+font description files for the
+.B ps
+device refers to it.
+.
 .
 .TP
-.I @MACRODIR@/ps.tmac
-Macros for use with
-.BR grops ;
-automatically loaded by
-.B troffrc
+.I @MACRODIR@/\:ps.tmac
+defines macros for use with the
+.B ps
+output device.
+.
+It is automatically loaded by
+.I troffrc
+when the
+.B ps
+output device is selected.
+.
 .
 .TP
-.I @MACRODIR@/pspic.tmac
-Definition of
+.I @MACRODIR@/\:pspic.tmac
+defines the
 .B PSPIC
-macro,
-automatically loaded by
-.IR ps.tmac .
+macro for embedding images in a document;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+It is automatically loaded by
+.I troffrc.
+.
 .
 .TP
 .I @MACRODIR@/psold.tmac
-Macros to disable use of characters not present in older
-PostScript printers (e.g., \oqeth\cq or \oqthorn\cq).
+provides replacement glyphs for text fonts that lack complete coverage
+of the ISO Latin-1 character set;
+using it,
+.I groff
+can produce glyphs like eth (\Sd) and thorn (\Tp) that older
+PostScript printers do not natively support.
 .
-.TP
-.IR /tmp/grops XXXXXX
-Temporary file.
-See
-.BR groff (@MAN1EXT@)
-for details on the location of temporary files.
+.
+.P
+.I grops
+creates temporary files using the template
+.RI \lq grops XXXXXX\rq;
+see
+.MR groff @MAN1EXT@
+for details on their storage location.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR \%afmtodit (@MAN1EXT@),
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR \%pfbtops (@MAN1EXT@),
-.BR \%groff_out (@MAN5EXT@),
-.BR \%groff_font (@MAN5EXT@),
-.BR \%groff_char (@MAN7EXT@),
-.BR \%groff_tmac (@MAN5EXT@)
-.
-.
-.LP
-.UR http://\:partners.adobe.com/\:public/\:developer/\:en/\:ps/\:5001.DSC_Spec.pdf
+.UR http://\:partners\:.adobe\:.com/\:public/\:developer/\:en/\:ps/\
+\:5001\:.DSC_Spec\:.pdf
 PostScript Language Document Structuring Conventions Specification
 .UE
 .
 .
+.P
+.MR afmtodit @MAN1EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR pfbtops @MAN1EXT@ ,
+.MR groff_char @MAN7EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR groff_tmac @MAN5EXT@
+.
+.
+.\" Clean up.
+.rm FT
+.
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngrops_C
+.cp \n*groff_grops_1_man_C
+.do rr *groff_grops_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grops/grops.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grops/grops.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grops/ps.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grops/ps.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -23,6 +22,7 @@
  *   http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf
  */
 
+#include "lib.h" // PI
 #include "driver.h"
 #include "stringclass.h"
 #include "cset.h"
@@ -371,7 +371,7 @@
 ps_output &ps_output::put_color(unsigned int c)
 {
   char buf128;
-  sprintf(buf, "%.3g", double(c) / color::MAX_COLOR_VAL);
+  sprintf(buf, "%.3g", double(c) / double(color::MAX_COLOR_VAL));
   int len = strlen(buf);
   if (col > 0 && col + len + need_space > max_line_length) {
     putc('\n', fp);
@@ -432,7 +432,7 @@
 ps_font::~ps_font()
 {
   free(encoding);
-  a_delete reencoded_name;
+  delete reencoded_name;
 }
 
 void ps_font::handle_unknown_font_command(const char *command, const char *arg,
@@ -480,7 +480,7 @@
 
 subencoding::~subencoding()
 {
-  a_delete subfont;
+  delete subfont;
 }
 
 struct style {
@@ -615,11 +615,14 @@
   if (linewidth < 0)
     linewidth = DEFAULT_LINEWIDTH;
   if (font::hor != 1)
-    fatal("horizontal resolution must be 1");
+    fatal("device horizontal motion quantum must be 1, got %1",
+	font::hor);
   if (font::vert != 1)
-    fatal("vertical resolution must be 1");
+    fatal("device vertical motion quantum must be 1, got %1",
+	font::vert);
   if (font::res % (font::sizescale*72) != 0)
-    fatal("res must be a multiple of 72*sizescale");
+    fatal("device resolution must be a multiple of 72*'sizescale', got"
+	" %1 ('sizescale'=%2)", font::res, font::sizescale);
   int r = font::res;
   int point = 0;
   while (r % 10 == 0) {
@@ -812,7 +815,7 @@
       out.put_literal_symbol(".notdef");
     else {
       out.put_literal_symbol(veci);
-      a_delete veci;
+      delete veci;
     }
   }
   out.put_delimiter('')
@@ -846,12 +849,12 @@
       reencode_font((ps_font *)f->p);
     }
   }
-  a_delete done_encoding;
+  delete done_encoding;
 }
 
 void ps_printer::encode_subfont(subencoding *sub)
 {
-  assert(sub->glyphs != 0);
+  assert(sub != 0);
   out.put_literal_symbol(make_subencoding_name(sub->idx))
      .put_delimiter('');
   for (int i = 0; i < 256; i++)
@@ -1258,13 +1261,14 @@
 {
   /*
    *  NOTE:
-   *  Although paper size is defined as real numbers, it seems to be
-   *  a common convention to round to the nearest postscript unit.
-   *  For example, a4 is really 595.276 by 841.89 but we use 595 by 842.
+   *  Although paper dimensions are defined as a pair of real numbers,
+   *  it seems to be a common convention to round to the nearest
+   *  PostScript unit.  For example, A4 is really 595.276 by 841.89 but
+   *  we use 595 by 842.
    *
    *  This is probably a good compromise, especially since the
-   *  Postscript definition specifies that media
-   *  matching should be done within a tolerance of 5 units.
+   *  PostScript definition specifies that media matching should be done
+   *  within a tolerance of 5 units.
    */
   return int(user_paper_width ? user_paper_width*72.0 + 0.5
 			      : font::paperwidth*72.0/font::res + 0.5);
@@ -1522,7 +1526,7 @@
   if (type != 'p')
     return;
   typedef void (ps_printer::*SPECIAL_PROCP)(char *, const environment *);
-  static struct {
+  static const struct {
     const char *name;
     SPECIAL_PROCP proc;
   } proc_table = {
@@ -1693,7 +1697,7 @@
     p = end;
   }
   if (csalpha(*p) && (p1 == '\0' || p1 == ' ' || p1 == '\n')) {
-    error("scaling indicators not allowed in arguments for X import command");
+    error("scaling units not allowed in arguments for X import command");
     return;
   }
   while (*p == ' ' || *p == '\n')
@@ -1824,7 +1828,7 @@
     case 'p':
       if (!font::scan_papersize(optarg, 0,
 				&user_paper_length, &user_paper_width))
-	error("invalid custom paper size '%1' ignored", optarg);
+	error("ignoring invalid custom paper format '%1'", optarg);
       break;
     case 'P':
       env = "GROPS_PROLOGUE";
@@ -1840,7 +1844,7 @@
       break;
     case 'w':
       if (sscanf(optarg, "%d", &linewidth) != 1 || linewidth < 0) {
-	error("bad linewidth '%1'", optarg);
+	error("invalid line width '%1' ignored", optarg);
 	linewidth = -1;
       }
       break;
@@ -1869,7 +1873,22 @@
 static void usage(FILE *stream)
 {
   fprintf(stream,
-"usage: %s -glmv -b n -c n -w n -I dir -P prologue\n"
-"       -F dir files ...\n",
-    program_name);
-}
+"usage: %s -glm -b brokenness-flags -c num-copies"
+" -F font-directory -I inclusion-directory -p paper-format"
+" -P prologue-file -w rule-thickness file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
+  if (stdout == stream)
+    fputs(
+"\n"
+"Translate the output of troff(1) into PostScript.  See the grops(1)\n"
+"manual page.\n",
+	  stream);
+}
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grops/ps.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grops/ps.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grops/psrm.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grops/psrm.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -259,8 +258,8 @@
 	*taili = resource_list;
 	resource_list = headi;
       }
-    a_delete head;
-    a_delete tail;
+    delete head;
+    delete tail;
     // check it
     for (r = resource_list; r; r = r->next)
       if (r->next)
@@ -271,7 +270,8 @@
   }
 }
 
-void resource_manager::print_resources_comment(unsigned flag, FILE *outfp)
+void resource_manager::print_resources_comment(unsigned flag,
+					       FILE *outfp)
 {
   int continued = 0;
   for (resource *r = resource_list; r; r = r->next)
@@ -317,7 +317,8 @@
   char *prologue = getenv("GROPS_PROLOGUE");
   FILE *fp = font::open_file(prologue, &path);
   if (!fp)
-    fatal("can't find '%1'", prologue);
+    fatal("failed to open PostScript prologue '%1': %2", prologue,
+	  strerror(errno));
   fputs("%%BeginResource: ", outfp);
   procset_resource->print_type_and_name(outfp);
   putc('\n', outfp);
@@ -335,8 +336,8 @@
   supply_resource(r, -1, out.get_file(), 1);
 }
 
-void resource_manager::supply_resource(resource *r, int rank, FILE *outfp,
-				       int is_document)
+void resource_manager::supply_resource(resource *r, int rank,
+				       FILE *outfp, int is_document)
 {
   if (r->flags & resource::BUSY) {
     r->name += '\0';
@@ -347,15 +348,16 @@
   r->flags |= resource::BUSY;
   if (rank > r->rank)
     r->rank = rank;
-  char *path = 0;		// pacify compiler
-  FILE *fp = 0;
-  if (r->filename != 0) {
+  char *path = 0 /* nullptr */;
+  FILE *fp = 0 /* nullptr */;
+  if (r->filename != 0 /* nullptr */) {
     if (r->type == RESOURCE_FONT) {
       fp = font::open_file(r->filename, &path);
       if (!fp) {
-	error("can't find '%1'", r->filename);
-	a_delete r->filename;
-	r->filename = 0;
+	error("failed to open PostScript resource '%1': %2",
+	      r->filename, strerror(errno));
+	delete r->filename;
+	r->filename = 0 /* nullptr */;
       }
     }
     else {
@@ -363,8 +365,8 @@
       fp = include_search_path.open_file_cautious(r->filename);
       if (!fp) {
 	error("can't open '%1': %2", r->filename, strerror(errno));
-	a_delete r->filename;
-	r->filename = 0;
+	delete r->filename;
+	r->filename = 0 /* nullptr */;
       }
       else
 	path = r->filename;
@@ -608,8 +610,8 @@
   return 1;
 }
 
-int resource_manager::do_include_resource(const char *ptr, int rank, FILE *,
-					  FILE *outfp)
+int resource_manager::do_include_resource(const char *ptr, int rank,
+					  FILE *, FILE *outfp)
 {
   resource *r = read_resource_arg(&ptr);
   if (r) {
@@ -634,8 +636,8 @@
   return 1;
 }
 
-int resource_manager::do_include_document(const char *ptr, int rank, FILE *,
-					  FILE *outfp)
+int resource_manager::do_include_document(const char *ptr, int rank,
+					  FILE *, FILE *outfp)
 {
   resource *r = read_file_arg(&ptr);
   if (r)
@@ -658,8 +660,8 @@
   return 0;
 }
 
-int resource_manager::do_include_procset(const char *ptr, int rank, FILE *,
-					  FILE *outfp)
+int resource_manager::do_include_procset(const char *ptr, int rank,
+					 FILE *, FILE *outfp)
 {
   resource *r = read_procset_arg(&ptr);
   if (r)
@@ -682,8 +684,8 @@
   return 0;
 }
 
-int resource_manager::do_include_file(const char *ptr, int rank, FILE *,
-				      FILE *outfp)
+int resource_manager::do_include_file(const char *ptr, int rank,
+				      FILE *, FILE *outfp)
 {
   resource *r = read_file_arg(&ptr);
   if (r)
@@ -727,7 +729,8 @@
   return 0;
 }
 
-int resource_manager::do_begin_preview(const char *, int, FILE *fp, FILE *)
+int resource_manager::do_begin_preview(const char *, int, FILE *fp,
+				       FILE *)
 {
   string buf;
   do {
@@ -934,18 +937,19 @@
   return flags;
 }
 
-// XXX if it has not been surrounded with {Begin,End}Document need to strip
-// out Page: Trailer {Begin,End}Prolog {Begin,End}Setup sections.
+// XXX if it has not been surrounded with {Begin,End}Document need to
+// strip out Page: Trailer {Begin,End}Prolog {Begin,End}Setup sections.
 
 // XXX Perhaps the decision whether to use BeginDocument or
 // BeginResource: file should be postponed till we have seen
 // the first line of the file.
 
-void resource_manager::process_file(int rank, FILE *fp, const char *filename,
-				    FILE *outfp)
+void resource_manager::process_file(int rank, FILE *fp,
+				    const char *filename, FILE *outfp)
 {
   // If none of these comments appear in the header section, and we are
-  // just analyzing the file (ie outfp is 0), then we can return immediately.
+  // just analyzing the file (i.e., outfp is 0), then we can return
+  // immediately.
   static const char *header_comment_table = {
     "DocumentNeededResources:",
     "DocumentSuppliedResources:",
@@ -956,7 +960,7 @@
     "DocumentNeededFiles:",
     "DocumentSuppliedFiles:",
   };
-  
+
   const int NHEADER_COMMENTS = sizeof(header_comment_table)
 			       / sizeof(header_comment_table0);
   struct comment_info {
@@ -964,7 +968,7 @@
     int (resource_manager::*proc)(const char *, int, FILE *, FILE *);
   };
 
-  static comment_info comment_table = {
+  static const comment_info comment_table = {
     { "BeginResource:", &resource_manager::do_begin_resource },
     { "IncludeResource:", &resource_manager::do_include_resource },
     { "BeginDocument:", &resource_manager::do_begin_document },
@@ -1074,20 +1078,21 @@
 
 void resource_manager::read_download_file()
 {
-  char *path = 0;
+  char *path = 0 /* nullptr */;
   FILE *fp = font::open_file("download", &path);
-  if (!fp)
-    fatal("can't find 'download'");
+  if (0 /* nullptr */ == fp)
+    fatal("failed to open 'download' file: %1", strerror(errno));
   char buf512;
   int lineno = 0;
   while (fgets(buf, sizeof(buf), fp)) {
     lineno++;
     char *p = strtok(buf, " \t\r\n");
-    if (p == 0 || *p == '#')
+    if (p == 0 /* nullptr */ || *p == '#')
       continue;
-    char *q = strtok(0, " \t\r\n");
+    char *q = strtok(0 /* nullptr */, " \t\r\n");
     if (!q)
-      fatal_with_file_and_line(path, lineno, "missing filename");
+      fatal_with_file_and_line(path, lineno, "file name missing for"
+			       " font '%1'", p);
     lookup_font(p)->filename = strsave(q);
   }
   free(path);
@@ -1176,3 +1181,9 @@
   if (language_level)
     fprintf(outfp, "%%%%LanguageLevel: %u\n", language_level);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grotty/grotty.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/grotty.1.man Changed

@@ -1,13 +1,15 @@
-.TH GROTTY @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-grotty \- groff driver for typewriter-like devices
+.TH grotty @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grotty \-
+.I groff
+output driver for typewriter-like (terminal) devices
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 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
@@ -26,182 +28,328 @@
 .
 .
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grotty_C \n.C
+.do nr *groff_grotty_1_man_C \n.cp
 .cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY grotty
-.OP \-bBcdfhioruUv
-.OP \-F dir
-.RI  file
-\&.\|.\|.\&
+.RB  \-dfho 
+.RB  \-i | \-r 
+.RB  \-F\~\c
+.IR dir 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY "grotty \-c"
+.RB  \-bBdfhouU 
+.RB  \-F\~\c
+.IR dir 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY grotty
+.B \-\-help
+.YS
+.
+.
+.SY grotty
+.B \-v
+.
+.SY grotty
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B grotty
-translates the output of GNU
-.B troff
-into a form suitable for typewriter-like devices.
-.
-Normally
-.B grotty
-should be invoked by using the
-.B groff
-command with a
-.BR \-Tascii ,
-.B \-Tlatin1
+The GNU
+.I roff
+TTY
+(\lqTeletype\rq)
+output driver translates the output of
+.MR @g@troff @MAN1EXT@
+into a form suitable for typewriter-like devices,
+including terminal emulators.
+.
+Normally,
+.I grotty
+is invoked by
+.MR groff @MAN1EXT@
+when the latter is given one of the
+.RB \lq \-T\~ascii \rq,
+.RB \lq \-T\~latin1 \rq,
+.BR \-Tlatin1 ,
 or
-.B \-Tutf8
-option on ASCII based systems, and with
-.B \-Tcp1047
-and
-.B \-Tutf8
-on EBCDIC based hosts.
+.RB \lq \-T\~utf8 \rq
+options on systems using ISO character encoding standards,
+or with
+.RB \lq \-T\~cp1047 \rq
+or
+.RB \lq \-T\~utf8 \rq
+on EBCDIC-based hosts.
 .
-If no files are given,
-.B grotty
-reads the standard input.
+(In this installation,
+.B @DEVICE@
+is the default output device.)
 .
-A filename of
-.B \-
-also causes
-.B grotty
-to read the standard input.
+Use
+.IR groff 's
+.B \-P
+option to pass any options shown above to
+.IR grotty .
 .
-Output is written to the standard output.
+If no
+.I file
+arguments are given,
+or if
+.I file
+is \lq\-\rq,
+.I grotty
+reads the standard input stream.
 .
+Output is written to the standard output stream.
 .
-.LP
+.
+.P
 By default,
-.B grotty
-emits SGR escape sequences (from ISO 6429, also called ANSI color
-escapes) to change text attributes (bold, italic, colors).
+.I grotty
+emits SGR escape sequences
+(from ISO\~6429,
+popularly called \lqANSI escapes\rq)
+to change text attributes
+(bold,
+italic,
+underline,
+reverse video
+.\" ECMA-48, 2nd edition (1979) calls it "negative image".
+\lqnegative image\rq
+and colors).
+.
+Devices supporting the appropriate sequences can view
+.I roff
+documents using eight different background and foreground colors.
+.
+Following ISO\~6429,
+the following colors are defined in
+.IR tty.tmac :
+black,
+white,
+red,
+green,
+blue,
+yellow,
+magenta,
+and cyan.
+.
+Unrecognized colors are mapped to the default color,
+which is dependent on the settings of the terminal.
+.
+OSC\~8 hyperlinks are produced for these devices.
+.
+.
+.P
+In keeping with long-standing practice and the rarity of terminals
+(and emulators)
+that support oblique or italic fonts,
+italicized text is represented with underlining by default\embut see
+the
+.B \-i
+option below.
 .
-This makes it possible to have eight different background and
-foreground colors; additionally, bold and italic attributes can be
-used \fBIat the same time\f (by using the BI font).
 .
+.\" ====================================================================
+.SS "SGR and OSC support in pagers"
+.\" ====================================================================
 .
-.LP
-The following colors are defined in
-.BR tty.tmac :
-black, white, red, green, blue, yellow, magenta, cyan.
+When paging
+.IR grotty 's
+output with
+.MR less 1 ,
+the latter program must be instructed to pass SGR and OSC sequences
+through to the device;
+its
+.B \-R
+option is one way to achieve this
+.RI ( less
+version 566 or later is required for OSC\~8 support).
 .
-Unknown colors are mapped to the default color (which is dependent on
-the settings of the terminal; in most cases, this is black for the
-foreground and white for the background).
+Consequently,
+programs like
+.MR man 1
+that page
+.I roff
+documents with
+.I less
+must call it with an appropriate option.
 .
 .
-.LP
-Use the
+.\" ====================================================================
+.SS "Legacy output format"
+.\" ====================================================================
+.
+The
 .B \-c
-switch to revert to the old behaviour, printing a bold character
+option tells
+.I grotty
+to use an output format compatible with paper terminals,
+like the Teletype machines for which
+.I roff
+and
+.I nroff
+were first developed but which are no longer in wide use.
+.
+SGR escape sequences are not emitted;
+bold,
+italic,
+and underlining character attributes are thus not manipulated.
+.
+Instead,
+.I grotty
+overstrikes,
+representing a bold character
 .I c
 with the sequence
-.RI \lq c
-BACKSPACE
-.IR c \rq
-and an italic character
+.RI \lq c\~\c
+BACKSPACE\~\c
+.IR c \rq,
+an italic character
 .I c
-by the sequence
-.RB \lq _
-BACKSPACE
+with the sequence
+.RB \lq _\~\c
+BACKSPACE\~\c
+.IR c \rq,
+and bold italics with
+.RB \lq _\~\c
+BACKSPACE\~\c
+.I c
+BACKSPACE\~\c
 .IR c \rq.
 .
-At the same time, color output is disabled.
+This rendering is inherently ambiguous when the character
+.I c
+is itself the underscore.
+.
+.
+.P
+The legacy output format can be rendered on a video terminal
+(or emulator)
+by piping
+.IR grotty 's
+output through
+.MR ul 1 ,
+.\" from bsdmainutils 11.1.2+b1 (on Debian Buster)
+which may render bold italics as reverse video.
+.
+.\" 'more' from util-linux 2.33.1 (on Debian Buster) neither renders
+.\" double-struck characters as bold nor supports -b, but does render
+.\" SGR sequences (including color) with no flags required.
+Some implementations of
+.MR more 1
+are also able to display these sequences;
+you may wish to experiment with that command's
+.B \-b
+option.
 .
-The same effect can be achieved by setting either the
-.I GROFF_NO_SGR
-environment variable or using the \oqsgr\cq X command (see below).
+.\" Version 487 of...
+.I less
+renders legacy bold and italics without requiring options.
 .
+In contrast to the terminal output drivers of some other
+.I roff
+implementations,
+.I grotty
+never outputs reverse line feeds.
 .
-.LP
-For SGR support, it is necessary to use the
-.B \-R
-option of
-.BR less (1)
-to disable the interpretation of
-.BR grotty 's
-old output format.
-.
-Consequently, all programs which use
-.B less
-as the pager program have to pass this option to it.
-.
-For
-.BR man (1)
-in particular, either add
-.B \-R
-to the
-.I PAGER
-environment variable, e.g.\&
+There is therefore no need to filter its output through
+.MR col 1 .
 .
-.RS
-.LP
-.B PAGER="/usr/bin/less \-R"
-.br
-.B export PAGER
-.RE
-.LP
 .
-or use the
-.B \-P
-option of
-.B man
-to set the pager executable and its options, or modify the
-configuration file of
-.B man
-in a similar fashion.
-.
-Note that with some
-.BR man (1)
-versions, you have to use the
-.I \%MANPAGER
-environment variable instead.
-.
-.
-.LP
-.BR grotty 's
-old output format can be displayed on a terminal
-by piping through
-.BR ul (1).
-Pagers such as
-.BR more (1)
-or
-.BR less (1)
-are also able to display these sequences.
-Use either
-.B \-B
+.\" ====================================================================
+.SS "Device control commands"
+.\" ====================================================================
+.
+.I grotty
+understands one device control function produced by the
+.I roff
+.B \rsX
+escape sequence in a document.
+.
+.
+.TP
+.BR "\rsX\aqtty: link " \c
+.IR uri \~ key\c
+.BI = value\c
+ \|.\|.\|.\|\c
+.B \aq
+.
+Embed a hyperlink using the OSC 8 terminal escape sequence.
+.
+Specifying
+.I uri
+starts hyperlinked text,
+and omitting it ends the hyperlink.
+.
+When
+.I uri
+is present,
+any number of additional key/value pairs can be specified;
+their interpretation is the responsibility of the pager or terminal.
+.
+Spaces or tabs cannot appear literally in
+.IR uri ,
+.IR key ,
 or
-.B \-U
-when piping into
-.BR less (1);
-use
-.B \-b
-when piping into
-.BR more (1).
-There is no need to filter the output through
-.BR col (1)
-since
-.B grotty
-never outputs reverse line feeds.
+.IR value ;
+they must be represented in an alternate form.
 .
 .
-.LP
-The font description file may contain a command
+.\" ====================================================================
+.SS "Device description files"
+.\" ====================================================================
+.
+If the
+.I DESC
+file for the character encoding contains the
+.RB \lq unicode \rq
+directive,
+.I grotty
+emits Unicode characters in UTF-8 encoding.
+.
+Otherwise,
+it emits characters in a single-byte encoding depending on the data in
+the font description files.
 .
-.IP
-.BI internalname\  n
-.LP
+See
+.MR groff_font @MAN5EXT@ .
 .
+.
+.P
+A font description file may contain a directive
+.RB \lq internalname\~\c
+.IR n \rq
 where
 .I n
 is a decimal integer.
@@ -213,330 +361,450 @@
 if the 02 bit is set,
 then it is treated as a bold font.
 .
-The code field in the font description field gives the code which is
-used to output the character.
+.\" The following seems to say nothing that is not true of font
+.\" description files in general; if so, it belongs in groff_font(5).
+.\"The code field in the font description field gives the code which is
+.\"used to output the character.
+.\".
+.\"This code can also be used in the
+.\".I groff
+.\".B \rsN
+.\"escape sequence in a document.
 .
-This code can also be used in the
-.B \rsN
-escape sequence in
-.BR troff .
 .
+.\" ====================================================================
+.SS Typefaces
+.\" ====================================================================
 .
-.LP
-If the
-.I DESC
-file contains the keyword
-.BR unicode ,
-.B grotty
-emits Unicode characters in UTF-8 encoding.
+.I grotty
+supports the standard four styles:
+.B R
+(roman),
+.B I
+.RI ( italic ),
+.B B
+.RB ( bold ),
+and
+.B BI
+(\fBIbold-italic\f).
 .
-Otherwise, it emits characters in a single-byte encoding depending on
-the data in the font description files.
+Because the output driver operates in
+.I nroff
+mode,
+attempts to set or change the font family or type size are ignored.
 .
-See the
-.BR groff_font (@MAN5EXT@)
-man page for more details.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
 .B \-b
-Suppress the use of overstriking for bold characters.
+Suppress the use of overstriking for bold characters in legacy output
+format.
 .
-Ignored if
-.B \-c
-isn't used.
 .
 .TP
 .B \-B
-Use only overstriking for bold-italic characters.
-Ignored if
-.B \-c
-isn't used.
+Use only overstriking for bold-italic characters in legacy output
+format.
+.
 .
 .TP
 .B \-c
 Use
-.BR grotty 's
-old output format (see above).
-This also disables color output.
+.IR grotty 's
+legacy output format
+(see subsection \lqLegacy output format\rq above).
+.
+SGR and OSC escape sequences are not emitted.
+.
 .
 .TP
 .B \-d
 Ignore all
 .B \rsD
-commands.
+drawing escape sequences in the input.
 .
-Without this
-.B grotty
+By default,
+.I grotty
 renders
-.B \rsD'l\|.\|.\|.\&'
-commands that have at least one zero argument
+.BR \rsD\aql \|.\|.\|.\& \aq
+escape sequences that have at least one zero argument
 (and so are either horizontal or vertical)
-using
+using Unicode box drawing characters
+(for the
+.B utf8
+device)
+or the
 .BR \- ,
 .BR | ,
 and
 .B +
-characters.
+characters
+(for all other devices).
 .
-In a similar way,
-.B grotty
+.I grotty
 handles
-.B \rsD'p\|.\|.\|.\&'
-commands which consist entirely of horizontal and vertical lines.
+.BR \rsD\aqp \|.\|.\|.\& \aq
+escape sequences that consist entirely of horizontal and vertical
+lines similarly.
 .
 .
 .TP
 .B \-f
-Use form feeds in the output.
+Emit a form feed at the end of each page having no output on its last
+line.
 .
-A form feed is output at the end of each page that has no output on
-its last line.
 .
 .TP
-.BI \-F dir
+.BI \-F\~ dir
 Prepend directory
 .RI dir /dev name
 to the search path for font and device description files;
 .I name
-is the name of the device, usually
+describes the output device's character encoding,
+one of
 .BR ascii ,
 .BR latin1 ,
 .BR utf8 ,
 or
 .BR cp1047 .
 .
+.
 .TP
 .B \-h
-Use horizontal tabs in the output.
+Use literal horizontal tab characters in the output.
 .
 Tabs are assumed to be set every 8 columns.
 .
+.
 .TP
 .B \-i
-Use escape sequences to set the italic text attribute instead of the
-underline attribute for italic fonts (\oqI\cq and \oqBI\cq).
+Render oblique-styled fonts
+.RB ( I
+and
+.BR BI )
+with the SGR attribute for italic text
+rather than underlined text.
 .
-Note that most terminals (including xterm) don't support this.
+Many terminals don't support this attribute;
+however,
+.MR xterm 1 ,
+since patch\~#314 (2014-12-28),
+does.
 .
 Ignored if
 .B \-c
-is active.
+is also specified.
+.
 .
 .TP
 .B \-o
-Suppress overstriking (other than for bold or underlined characters in
-case the old output format has been activated with
-.BR \-c ).
+Suppress overstriking
+(other than for bold and/or underlined characters when the legacy output
+format is in use).
+.
 .
 .TP
 .B \-r
-Use escape sequences to set the reverse text attribute instead of the
-underline attribute for italic fonts (\oqI\cq and \oqBI\cq).
+Render oblique-styled fonts
+.RB ( I
+and
+.BR BI )
+with the SGR attribute for reverse video text
+rather than underlined text.
 .
 Ignored if
 .B \-c
-is active.
+or
+.B \-i
+is also specified.
+.
 .
 .TP
 .B \-u
-Suppress the use of underlining for italic characters.
+Suppress the use of underlining for italic characters in legacy output
+format.
 .
-Ignored if
-.B \-c
-isn't used.
 .
 .TP
 .B \-U
-Use only underlining for bold-italic characters.
-.
-Ignored if
-.B \-c
-isn't used.
-.
-.TP
-.B \-v
-Print the version number.
+Use only underlining for bold-italic characters in legacy output format.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Environment
 .\" ====================================================================
 .
-.B grotty
-understands a single X command produced using the
-.B \rsX
-escape sequence.
-.
 .TP
-.BI \rsX'tty:\ sgr\  n '
+.I GROFF_FONT_PATH
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
-If
-.I n
-is non-zero or missing, enable SGR output (this is the default),
-otherwise use the old drawing scheme for bold and underline.
+See
+.MR @g@troff @MAN1EXT@
+and
+.MR groff_font @MAN5EXT@ .
 .
 .
-.\" ====================================================================
-.SH ENVIRONMENT
-.\" ====================================================================
-.
 .TP
 .I GROFF_NO_SGR
-If set, the old drawing scheme for bold and underline (using the
-backspace character) is active.
+If set,
+.IR grotty 's
+legacy output format is used just as if the
+.B \-c
+option were specified;
+see subsection \lqLegacy output format\rq above.
 .
-Colors are disabled.
 .
+.br
+.ne 3v \" Keep section heading and paragraph tag together.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
 .
 .TP
-.I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+.I @FONTDIR@/\:\%devascii/\:DESC
+describes the
+.B ascii
+output device.
 .
-See
-.BR @g@troff (@MAN1EXT@)
-and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
 .
+.TP
+.IR @FONTDIR@/\:\%devascii/ F
+describes the font known
+.RI as\~ F
+on device
+.BR ascii .
 .
-.\" ====================================================================
-.SH FILES
-.\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devascii/DESC
-Device description file for the
-.B ascii
-device.
+.I @FONTDIR@/\:\%devcp1047/\:DESC
+describes the
+.B cp1047
+output device.
 .
-.TP
-.IR @FONTDIR@/devascii/ F
-Font description file for font
-.I F
-of the
-.B ascii
-device.
 .
 .TP
-.I @FONTDIR@/devlatin1/DESC
-Device description file for the
-.B latin1
-device.
+.IR @FONTDIR@/\:\%devcp1047/ F
+describes the font known
+.RI as\~ F
+on device
+.BR cp1047 .
+.
 .
 .TP
-.IR @FONTDIR@/devlatin1/ F
-Font description file for font
-.I F
-of the
+.I @FONTDIR@/\:\%devlatin1/\:DESC
+describes the
 .B latin1
-device.
+output device.
+.
 .
 .TP
-.I @FONTDIR@/devutf8/DESC
-Device description file for the
-.B utf8
-device.
+.IR @FONTDIR@/\:\%devlatin1/ F
+describes the font known
+.RI as\~ F
+on device
+.BR latin1 .
+.
 .
 .TP
-.IR @FONTDIR@/devutf8/ F
-Font description file for font
-.I F
-of the
+.I @FONTDIR@/\:\%devutf8/\:DESC
+describes the
 .B utf8
-device.
+output device.
 .
-.TP
-.I @FONTDIR@/devcp1047/DESC
-Device description file for the
-.B cp1047
-device.
 .
 .TP
-.IR @FONTDIR@/devcp1047/ F
-Font description file for font
-.I F
-of the
-.B cp1047
-device.
+.IR @FONTDIR@/\:\%devutf8/ F
+describes the font known
+.RI as\~ F
+on device
+.BR utf8 .
+.
 .
 .TP
-.I @MACRODIR@/tty.tmac
-Macros for use with
-.BR grotty .
+.I @MACRODIR@/\:tty\:.tmac
+defines macros for use with the
+.BR ascii ,
+.BR cp1047 ,
+.BR latin1 ,
+and
+.B utf8
+output devices.
+.
+It is automatically loaded by
+.I troffrc
+when any of those output devices is selected.
+.
 .
 .TP
-.I @MACRODIR@/tty\-char.tmac
-Additional character definitions for use with
-.BR grotty .
+.I @MACRODIR@/\:tty\-char\:.tmac
+defines fallback characters for use with
+.I grotty.
+.
+See
+.MR nroff @MAN1EXT@ .
 .
-.LP
-Note that on EBCDIC hosts, only files for the
-.B cp1047
-device is installed.
+.
+.\" XXX: The following no longer seems to be true; an inspection of the
+.\" font/*/dev*.am files suggests no evidence of it, at any rate.
+.\".P
+.\"Note that on EBCDIC hosts,
+.\"only files for the
+.\".B cp1047
+.\"device are installed.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Limitations
 .\" ====================================================================
 .
-.B grotty
+.I grotty
 is intended only for simple documents.
 .
 .
-.LP
+.IP \bu 2n
 There is no support for fractional horizontal or vertical motions.
 .
 .
-.LP
-There is no support for
+.IP \bu
+.I roff
 .B \rsD
-commands other than horizontal and vertical lines.
+escape sequences producing anything other than horizontal and vertical
+lines are not supported.
+.
+.
+.IP \bu
+Characters above the first line
+(that is,
+with a vertical drawing position of\~0)
+cannot be rendered.
+.
+.
+.IP \bu
+Color handling differs from other output drivers.
 .
+The
+.I groff
+requests and escape sequences that set the stroke and fill colors
+instead set the foreground and background character cell colors,
+respectively.
 .
-.LP
-Characters above the first line (i.e.\& with a vertical position
-of\~0) cannot be printed.
 .
+.\" ====================================================================
+.SH Examples
+.\" ====================================================================
+.
+The following
+.I groff
+document exercises several features for which output device support
+varies:
+(1)\~bold style;
+(2)\~italic (underline) style;
+(3)\~bold-italic style;
+(4)\~character composition by overstriking (\lqco\:operate\rq);
+(5)\~foreground color;
+(6)\~background color;
+and
+(7)\~horizontal and vertical line-drawing.
+.
+.
+.P
+.RS
+.EX
+You might see \efBbold\ef and \efIitalic\ef.
+Some people see \efBIboth\ef.
+If the output device does (not) co\ez\eadoperate,
+you might see \emredred\em.
+Black on cyan can have a \eMcyan\emblackprominent\em\eM
+\eD\aql 1i 0\aq\eD\aql 0 2i\aq\eD\aql 1i 0\aq look.
+\&.\e" If in nroff mode, end page now.
+\&.if n .pl \ennlu
+.EE
+.RE
+.
+.
+.P
+Given the foregoing input,
+compare and contrast the output of the following.
 .
-.LP
-Color handling differs from
-.BR grops (@MAN1EXT@).
-.B \rsM
-doesn't set the fill color for closed graphic objects (which
-.B grotty
-doesn't support anyway) but changes the background color of the
-character cell, affecting all subsequent operations.
+.
+.P
+.RS
+.EX
+$ \c
+.B groff \-T ascii \c
+.I file
+$ \c
+.B groff \-T utf8 \-P \-i \c
+.I file
+$ \c
+.B groff \-T utf8 \-P \-c \c
+.I file \c
+.B | ul
+.EE
+.RE
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR groff_char (@MAN7EXT@),
-.BR ul (1),
-.BR more (1),
-.BR man (1),
-.BR less (1)
+.
+\lqControl Functions for Coded Character Sets\rq
+(ECMA-48)
+5th\~edition,
+Ecma International,
+June\~1991.
+.
+A gratis version of ISO\~6429,
+this document includes a normative description of SGR escape sequences.
+.
+Available at
+.UR http://\:www\:.ecma\-international\:.org/\:publications/\:files/\:\
+ECMA\-ST/\:Ecma\-048\:.pdf
+.UE .
+.
+.
+.P
+.UR https://\:gist\:.github\:.com/\:egmontkob/\:\
+eb114294efbcd5ad\:b1944c9f3cb5feda
+\lqHyperlinks in Terminal Emulators\rq
+.UE ,
+Egmont Koblinger.
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR groff_font @MAN5EXT@ ,
+.MR groff_char @MAN7EXT@ ,
+.MR ul 1 ,
+.MR more 1 ,
+.MR less 1 ,
+.MR man 1
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngrotty_C
+.cp \n*groff_grotty_1_man_C
+.do rr *groff_grotty_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grotty/grotty.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/grotty.am Changed

_service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/tests/basic_latin_glyphs_map_correctly.sh Added

@@ -0,0 +1,205 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+grotty="${abs_top_builddir:-.}/grotty"
+
+fail=
+
+wail () {
+    printf "FAILED " >&2
+    fail=YES
+}
+
+# Ensure that characters are mapped to glyphs normatively.
+
+input='x T @DEVICE@
+x res 240 24 40
+x init
+p1
+x font 1 R
+f1
+s10
+V40
+H0
+md
+DFd
+t!#$%&()*+,./0123456789:;<=>?@
+n40 0
+V80
+H0
+tABCDEFGHIJKLMNOPQRSTUVWXYZ_
+n40 0
+V120
+H0
+tabcdefghijklmnopqrstuvwxyz{|}
+n40 0
+V160
+H0
+tneutral
+wh24
+tdouble
+wh24
+tquote:
+wh24
+Cdq
+h24
+n40 0
+V200
+H0
+tclosing
+wh24
+tsingle
+wh24
+tquote:
+wh24
+t'"'"'
+n40 0
+V240
+H0
+thyphen:
+wh24
+t-
+n40 0
+V280
+H0
+tbackslash:
+wh24
+Crs
+h24
+n40 0
+V320
+H0
+tmodifier
+wh24
+tcircumflex:
+wh24
+t^
+n40 0
+V360
+H0
+topening
+wh24
+tsingle
+wh24
+tquote:
+wh24
+t`
+n40 0
+V400
+H0
+tmodifier
+wh24
+ttilde:
+wh24
+t~
+n40 0
+x trailer
+V2640
+x stop'
+
+# TODO: Test cp1047 when we have access to a host environment using it.
+
+for D in ascii latin1 utf8
+do
+    if  "$D" = "utf8" 
+    then
+        # We can't test UTF-8 if the environment doesn't support it.
+        if  "$(locale charmap)" != UTF-8 
+        then
+            # If we've already seen a failure case, report it.
+            if  -n "$fail" 
+            then
+                exit 1 # fail
+            else
+                exit 77 # skip
+            fi
+        fi
+    fi
+
+    printf 'checking "%s" output device...' $D >&2
+    output=$(echo "$input" | sed s/@DEVICE@/$D/ \
+        | "$grotty" -F font -F build/font)
+    printf 'group1 ' >&2
+    echo "$output" | grep -Fqx '!#$%&()*+,./0123456789:;<=>?@' || wail
+    printf 'group2 ' >&2
+    echo "$output" | grep -Fqx 'ABCDEFGHIJKLMNOPQRSTUVWXYZ_' || wail
+    printf 'group3 ' >&2
+    echo "$output" | grep -Fqx 'abcdefghijklmnopqrstuvwxyz{|}' || wail
+    printf '" ' >&2
+    echo "$output" | grep -Fqx 'neutral double quote: "' || wail
+    printf '\\ ' >&2
+    echo "$output" | grep -Fqx 'backslash: \' || wail
+    case $D in
+    (utf8)
+# Expected:
+#0000000   !   #   $   %   &   (   )   *   +   ,   .   /   0   1   2   3
+#0000020   4   5   6   7   8   9   :   ;   <   =   >   ?   @  \n   A   B
+#0000040   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R
+#0000060   S   T   U   V   W   X   Y   Z         _  \n   a   b   c   d
+#0000100   e   f   g   h   i   j   k   l   m   n   o   p   q   r   s   t
+#0000120   u   v   w   x   y   z   {   |   }  \n   n   e   u   t   r   a
+#0000140   l       d   o   u   b   l   e       q   u   o   t   e   :
+#0000160   "  \n   c   l   o   s   i   n   g       s   i   n   g   l   e
+#0000200       q   u   o   t   e   :     342 200 231  \n   h   y   p   h
+#0000220   e   n   :     342 200 220  \n   b   a   c   k   s   l   a   s
+#0000240   h   :       \  \n   m   o   d   i   f   i   e   r       c   i
+#0000260   r   c   u   m   f   l   e   x   :     313 206  \n   o   p   e
+#0000300   n   i   n   g       s   i   n   g   l   e       q   u   o   t
+#0000320   e   :     342 200 230  \n   m   o   d   i   f   i   e   r
+#0000340   t   i   l   d   e   :     313 234  \n
+#0000352
+        output_od=$(echo "$output" | LC_ALL=C od -t c)
+        printf "' " >&2
+        printf '%s\n' "$output_od" \
+            | grep -Eq '0000200 +q +u +o +t +e +: +342 +200 +231' \
+            || wail
+        printf '` ' >&2
+        printf '%s\n' "$output_od" \
+            | grep -Eq '0000320 +e +: +342 +200 +230' || wail
+        printf "%s " '-' >&2
+        printf '%s\n' "$output_od" \
+            | grep -Eq '0000220 +e +n +: +342 +200 +220' || wail
+        printf '^ ' >&2
+        printf '%s\n' "$output_od" \
+            | grep -Eq '0000260 +r +c +u +m +f +l +e +x +: +313 +206' \
+            || wail
+        printf "~ " >&2
+        printf '%s\n' "$output_od" \
+            | grep -Eq '0000340 +t +i +l +d +e +: +313 +234' || wail
+        ;;
+    (*)
+        printf '` ' >&2
+        echo "$output" | grep -Fqx 'opening single quote: `' || wail
+        printf "' " >&2
+        echo "$output" | grep -Fqx "closing single quote: '" || wail
+        printf "%s " '-' >&2
+        echo "$output" | grep -Fqx "hyphen: -" || wail
+        printf '^ ' >&2
+        echo "$output" | grep -Fqx "modifier circumflex: ^" || wail
+        printf "~ " >&2
+        echo "$output" | grep -Fqx "modifier tilde: ~" || wail
+        ;;
+    esac
+    echo >&2
+done
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/tests/osc8_works.sh Added

@@ -0,0 +1,119 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+set -e
+
+grotty="${abs_top_builddir:-.}/grotty"
+
+input="x T utf8
+x res 240 24 40
+x init
+p1
+x font 1 R
+f1
+s10
+V40
+H0
+md
+DFd
+tA
+n40 0
+x X tty: link
+x X tty: link h
+x X tty: link http://example.com/1
+x X tty: link
+x X tty: link http://example.com/2
+tB
+x X tty: link
+x X tty: link mailto:g.branden.robinson@gmail.com
+tBranden
+x X tty: link
+x trailer
+V2640
+x stop"
+
+# We expect diagnostics from the first few "x X tty: link" lines.  The
+# first should complain about a link ending without having been started.
+# The second is bogus ("h") but it's not grotty's job to validate the
+# structure of a URI.  The third should draw complaint because we didn't
+# end the (bogus) URI that we started with the second.
+
+# The remaining input is well-formed.  The URI ending in "1" is
+# effectively hidden because no character cells are drawn while it is
+# active.
+echo "expect two diagnostic messages regarding ill-formed links" >&2
+output=$(echo "$input" | "$grotty" -F font -F build/font | od -t c)
+
+# Expected:
+#0000000   A 033      8   ;   ; 033   \ 033      8   ;   ;   h 033   \
+#0000020 033      8   ;   ; 033   \ 033      8   ;   ;   h   t   t   p
+#0000040   :   /   /   e   x   a   m   p   l   e   .   c   o   m   /   1
+#0000060 033   \ 033      8   ;   ; 033   \ 033      8   ;   ;   h   t
+#0000100   t   p   :   /   /   e   x   a   m   p   l   e   .   c   o   m
+#0000120   /   2 033   \   B 033      8   ;   ; 033   \ 033      8   ;
+#0000140   ;   m   a   i   l   t   o   :   g   .   b   r   a   n   d   e
+#0000160   n   .   r   o   b   i   n   s   o   n   @   g   m   a   i   l
+#0000200   .   c   o   m 033   \   B   r   a   n   d   e   n 033      8
+#0000220   ;   ; 033   \  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n
+#0000240  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n  \n
+#*
+#0000320  \n  \n  \n  \n  \n  \n
+#0000326
+
+echo "testing for URI that corresponds to no character cells" >&2
+echo "$output" | grep -Eq 'A 033 + +8 +; +; +033 +\\'
+
+echo "testing http URI (1)" >&2
+echo "$output" | grep -Eq '0000020 +.*033 + +8 +; +; +h + t +t +p'
+
+echo "testing http URI (2)" >&2
+echo "$output" | grep -Eq '0000040 +: +/ +/ +e +x +a +m +p +l +e +\. +c'
+
+echo "testing http URI (3)" >&2
+echo "$output" | grep -Eq '0000040.* +o +m +/ +1'
+
+echo "testing http URI (4)" >&2
+echo "$output" | grep -Eq '0000060 +033 +\\'
+
+echo "testing mailto URI (1)" >&2
+echo "$output" | grep -Eq '0000120 +.* +033 + +8 +;$'
+
+echo "testing mailto URI (2)" >&2
+echo "$output" | grep -Eq '0000140 +; +m +a +i +l +t +o +: +g +\. +b'
+
+echo "testing mailto URI (3)" >&2
+echo "$output" | grep -Eq '0000140.* +r +a +n +d +e$'
+
+echo "testing mailto URI (4)" >&2
+echo "$output" | grep -Eq '0000160 +n +\. +r +o +b +i +n +s +o +n +@'
+
+echo "testing mailto URI (5)" >&2
+echo "$output" | grep -Eq '0000160.* +g +m +a +i +l$'
+
+echo "testing mailto URI (6)" >&2
+echo "$output" | grep -Eq '0000200 +\. +c +o +m +033 +\\ +B +r +a +n +d'
+
+echo "testing mailto URI (7)" >&2
+echo "$output" | grep -Eq '0000200.* +e +n +033 + +8$'
+
+echo "testing mailto URI (8)" >&2
+echo "$output" | grep -Eq '0000220 +; +; +033 +\\'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/grotty/tty.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/grotty/tty.cpp Changed

@@ -1,6 +1,6 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2021 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
+     OSC 8 support by G. Branden Robinson
 
 This file is part of groff.
 
@@ -43,19 +43,19 @@
 // A character of the output device fits in a 32-bit word.
 typedef unsigned int output_character;
 
-static int horizontal_tab_flag = 0;
-static int form_feed_flag = 0;
-static int bold_flag_option = 1;
-static int bold_flag;
-static int underline_flag_option = 1;
-static int underline_flag;
-static int overstrike_flag = 1;
-static int draw_flag = 1;
-static int italic_flag_option = 0;
-static int italic_flag;
-static int reverse_flag_option = 0;
-static int reverse_flag;
-static int old_drawing_scheme = 0;
+static bool want_horizontal_tabs = false;
+static bool want_form_feeds = false;
+static bool want_emboldening_by_overstriking = true;
+static bool do_bold;
+static bool want_italics_by_underlining = true;
+static bool do_underline;
+static bool want_glyph_composition_by_overstriking = true;
+static bool allow_drawing_commands = true;
+static bool want_sgr_italics = false;
+static bool do_sgr_italics;
+static bool want_reverse_video_for_italics = false;
+static bool do_reverse_video;
+static bool use_overstriking_drawing_scheme = false;
 
 static void update_options();
 static void usage(FILE *stream);
@@ -80,8 +80,12 @@
 
 #ifndef IS_EBCDIC_HOST
 #define CSI "\033"
+#define OSC8 "\0338"
+#define ST "\033\\"
 #else
 #define CSI "\047"
+#define OSC8 "\0478"
+#define ST "\047\\"
 #endif
 
 // SGR handling (ISO 6429)
@@ -123,9 +127,9 @@
   long n;
   if (num != 0 && (n = strtol(num, 0, 0)) != 0)
     f->mode = (unsigned char)(n & (BOLD_MODE|UNDERLINE_MODE));
-  if (!underline_flag)
+  if (!do_underline)
     f->mode &= ~UNDERLINE_MODE;
-  if (!bold_flag)
+  if (!do_bold)
     f->mode &= ~BOLD_MODE;
   if ((f->mode & (BOLD_MODE|UNDERLINE_MODE)) == (BOLD_MODE|UNDERLINE_MODE))
     f->mode = (unsigned char)((f->mode & ~(BOLD_MODE|UNDERLINE_MODE))
@@ -174,21 +178,23 @@
   int cached_vpos;
   schar curr_fore_idx;
   schar curr_back_idx;
-  int is_underline;
-  int is_bold;
-  int cu_flag;
+  bool is_underlining;
+  bool is_boldfacing;
+  bool is_continuously_underlining;
   PTABLE(schar) tty_colors;
   void make_underline(int);
   void make_bold(output_character, int);
   schar color_to_idx(color *);
   void add_char(output_character, int, int, int, color *, color *,
 		unsigned char);
+  void simple_add_char(const output_character, const environment *);
   char *make_rgb_string(unsigned int, unsigned int, unsigned int);
-  int tty_color(unsigned int, unsigned int, unsigned int, schar *,
-		schar = DEFAULT_COLOR_IDX);
+  bool tty_color(unsigned int, unsigned int, unsigned int, schar *,
+		 schar = DEFAULT_COLOR_IDX);
   void line(int, int, int, int, color *, color *);
   void draw_line(int *, int, const environment *);
   void draw_polygon(int *, int, const environment *);
+  void special_link(const char *, const environment *);
 public:
   tty_printer();
   ~tty_printer();
@@ -226,22 +232,22 @@
   return s;
 }
 
-int tty_printer::tty_color(unsigned int r,
-			   unsigned int g,
-			   unsigned int b, schar *idx, schar value)
+bool tty_printer::tty_color(unsigned int r,
+			    unsigned int g,
+			    unsigned int b, schar *idx, schar value)
 {
-  int unknown_color = 0;
+  bool is_known_color = true;
   char *s = make_rgb_string(r, g, b);
   schar *i = tty_colors.lookup(s);
   if (!i) {
-    unknown_color = 1;
+    is_known_color = false;
     i = new schar1;
     *i = value;
     tty_colors.define(s, i);
   }
   *idx = *i;
-  a_delete s;
-  return unknown_color;
+  delete s;
+  return is_known_color;
 }
 
 tty_printer::tty_printer() : cached_v(0)
@@ -268,17 +274,17 @@
   lines = new tty_glyph *nlines;
   for (int i = 0; i < nlines; i++)
     linesi = 0;
-  cu_flag = 0;
+  is_continuously_underlining = false;
 }
 
 tty_printer::~tty_printer()
 {
-  a_delete lines;
+  delete lines;
 }
 
 void tty_printer::make_underline(int w)
 {
-  if (old_drawing_scheme) {
+  if (use_overstriking_drawing_scheme) {
     if (!w)
       warning("can't underline zero-width character");
     else {
@@ -287,21 +293,21 @@
     }
   }
   else {
-    if (!is_underline) {
-      if (italic_flag)
+    if (!is_underlining) {
+      if (do_sgr_italics)
 	putstring(SGR_ITALIC);
-      else if (reverse_flag)
+      else if (do_reverse_video)
 	putstring(SGR_REVERSE);
       else
 	putstring(SGR_UNDERLINE);
     }
-    is_underline = 1;
+    is_underlining = true;
   }
 }
 
 void tty_printer::make_bold(output_character c, int w)
 {
-  if (old_drawing_scheme) {
+  if (use_overstriking_drawing_scheme) {
     if (!w)
       warning("can't print zero-width character in bold");
     else {
@@ -310,9 +316,9 @@
     }
   }
   else {
-    if (!is_bold)
+    if (!is_boldfacing)
       putstring(SGR_BOLD);
-    is_bold = 1;
+    is_boldfacing = true;
   }
 }
 
@@ -323,10 +329,10 @@
   unsigned int r, g, b;
   col->get_rgb(&r, &g, &b);
   schar idx;
-  if (tty_color(r, g, b, &idx)) {
+  if (!tty_color(r, g, b, &idx)) {
     char *s = col->print_color();
-    error("Unknown color (%1) mapped to default", s);
-    a_delete s;
+    error("unrecognized color '%1' mapped to default", s);
+    delete s;
   }
   return idx;
 }
@@ -335,7 +341,7 @@
 			   int w, const char *)
 {
   if (w % font::hor != 0)
-    fatal("width of character not a multiple of horizontal resolution");
+    fatal("glyph width is not a multiple of horizontal motion quantum");
   add_char(f->get_code(g), w,
 	   env->hpos, env->vpos,
 	   env->col, env->fill,
@@ -350,7 +356,7 @@
 #if 0
   // This is too expensive.
   if (h % font::hor != 0)
-    fatal("horizontal position not a multiple of horizontal resolution");
+    fatal("horizontal position not a multiple of horizontal motion quantum");
 #endif
   int hpos = h / font::hor;
   if (hpos < SHRT_MIN || hpos > SHRT_MAX) {
@@ -362,7 +368,8 @@
     vpos = cached_vpos;
   else {
     if (v % font::vert != 0)
-      fatal("vertical position not a multiple of vertical resolution");
+      fatal("vertical position not a multiple of vertical motion"
+	    " quantum");
     vpos = v / font::vert;
     if (vpos > nlines) {
       tty_glyph **old_lines = lines;
@@ -370,13 +377,13 @@
       memcpy(lines, old_lines, nlines * sizeof(tty_glyph *));
       for (int i = nlines; i <= vpos; i++)
 	linesi = 0;
-      a_delete old_lines;
+      delete old_lines;
       nlines = vpos + 1;
     }
     // Note that the first output line corresponds to groff
     // position font::vert.
     if (vpos <= 0) {
-      error("character above first line discarded");
+      error("output above first line discarded");
       return;
     }
     cached_v = v;
@@ -404,6 +411,12 @@
   *pp = g;
 }
 
+void tty_printer::simple_add_char(const output_character c,
+				  const environment *env)
+{
+  add_char(c, 0, env->hpos, env->vpos, env->col, env->fill, 0);
+}
+
 void tty_printer::special(char *arg, const environment *env, char type)
 {
   if (type == 'u') {
@@ -433,16 +446,80 @@
     error("empty X command ignored");
     return;
   }
-  if (strncmp(command, "sgr", p - command) == 0) {
-    for (; *p == ' ' || *p == '\n'; p++)
-      ;
-    int n;
-    if (*p != '\0' && sscanf(p, "%d", &n) == 1 && n == 0)
-      old_drawing_scheme = 1;
-    else
-      old_drawing_scheme = 0;
-    update_options();
+  if (strncmp(command, "link", p - command) == 0)
+    special_link(p, env);
+  else
+    warning("unrecognized X command '%1' ignored", command);
+}
+
+// Produce an OSC 8 hyperlink.  Given ditroff input of the form:
+//   x X tty: link URI KEY=VALUE ...
+// produce "OSC 8 ;KEY=VALUE;URI ST".  KEY/VALUE pairs can be
+// repeated arbitrarily and are separated by colons.  Omission of the
+// URI ends the hyperlink that was begun by specifying it.  See
+// <https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda>.
+void tty_printer::special_link(const char *arg, const environment *env)
+{
+  static bool is_link_active = false;
+  if (use_overstriking_drawing_scheme)
+    return;
+  for (const char *s = OSC8; *s != '\0'; s++)
+    simple_add_char(*s, env);
+  simple_add_char(';', env);
+  char c = *arg;
+  if ('\0' == c || '\n' == c) {
+    simple_add_char(';', env);
+    if (!is_link_active)
+      warning("ending hyperlink when none was started");
+    is_link_active = false;
   }
+  else {
+    // Our caller ensures that we see white space after 'link'.
+    assert(c == ' ' || c == '\t');
+    if (is_link_active) {
+      warning("new hyperlink started without ending previous one;"
+	      " recovering");
+      simple_add_char(';', env);
+	for (const char *s = ST OSC8; *s != '\0'; s++)
+	  simple_add_char(*s, env);
+	simple_add_char(';', env);
+    }
+    is_link_active = true;
+    do
+      c = *arg++;
+    while (c == ' ' || c == '\t');
+    arg--;
+    // The first argument is the URI.
+    const char *uri = arg;
+    do
+      c = *arg++;
+    while (c != '\0' && c != ' ' && c != '\t');
+    arg--;
+    ptrdiff_t uri_len = arg - uri;
+    // Any remaining arguments are "key=value" pairs.
+    const char *pair = 0;
+    bool done = false;
+    do {
+      if (pair != 0)
+	simple_add_char(':', env);
+      pair = arg;
+      bool in_pair = true;
+      do {
+	c = *arg++;
+	if ('\0' == c)
+	  done = true;
+	else if (' ' == c || '\t' == c)
+	  in_pair = false;
+	else
+	  simple_add_char(c, env);
+      } while (!done && in_pair);
+    } while (!done);
+    simple_add_char(';', env);
+    for (size_t i = uri_len; i > 0; i--)
+      simple_add_char(*uri++, env);
+  }
+  for (const char *s = ST; *s != '\0'; s++)
+    simple_add_char(*s, env);
 }
 
 void tty_printer::change_color(const environment * const env)
@@ -457,12 +534,14 @@
 
 void tty_printer::draw(int code, int *p, int np, const environment *env)
 {
-  if (!draw_flag)
+  if (!allow_drawing_commands)
     return;
   if (code == 'l')
     draw_line(p, np, env);
-  if (code == 'p')
+  else if (code == 'p')
     draw_polygon(p, np, env);
+  else
+    warning("ignoring unsupported drawing command '%1'", char(code));
 }
 
 void tty_printer::draw_polygon(int *p, int np, const environment *env)
@@ -512,6 +591,23 @@
 void tty_printer::line(int hpos, int vpos, int dx, int dy,
 		       color *col, color *fill)
 {
+  // XXX: zero-length lines get drawn as '+' crossings in nroff, even
+  // when there is no crossing, but they nevertheless occur frequently
+  // in input.  Does tbl produce them?
+#if 0
+  if (0 == dx)
+    fatal("cannot draw zero-length horizontal line");
+  if (0 == dy)
+    fatal("cannot draw zero-length vertical line");
+#endif
+  if ((dx != 0) && (dy != 0))
+    warning("cannot draw diagonal line");
+  if (dx % font::hor != 0)
+    fatal("length of horizontal line %1 is not a multiple of horizontal"
+	" motion quantum %2", dx, font::hor);
+  if (dy % font::vert != 0)
+    fatal("length of vertical line %1 is not a multiple of vertical"
+	" motion quantum %2", dy, font::vert);
   if (dx == 0) {
     // vertical line
     int v = vpos;
@@ -598,12 +694,12 @@
   if (color_index == DEFAULT_COLOR_IDX) {
     putstring(SGR_DEFAULT);
     // set bold and underline again
-    if (is_bold)
+    if (is_boldfacing)
       putstring(SGR_BOLD);
-    if (is_underline) {
-      if (italic_flag)
+    if (is_underlining) {
+      if (do_sgr_italics)
 	putstring(SGR_ITALIC);
-      else if (reverse_flag)
+      else if (do_reverse_video)
 	putstring(SGR_REVERSE);
       else
 	putstring(SGR_UNDERLINE);
@@ -640,7 +736,8 @@
 void tty_printer::end_page(int page_length)
 {
   if (page_length % font::vert != 0)
-    error("vertical position at end of page not multiple of vertical resolution");
+    error("vertical position at end of page not multiple of vertical"
+	  " motion quantum");
   int lines_per_page = page_length / font::vert;
   int last_line;
   for (last_line = nlines; last_line > 0; last_line--)
@@ -673,12 +770,12 @@
     tty_glyph *nextp;
     curr_fore_idx = DEFAULT_COLOR_IDX;
     curr_back_idx = DEFAULT_COLOR_IDX;
-    is_underline = 0;
-    is_bold = 0;
+    is_underlining = false;
+    is_boldfacing = false;
     for (p = g; p; delete p, p = nextp) {
       nextp = p->next;
       if (p->mode & CU_MODE) {
-	cu_flag = (p->code != 0);
+	is_continuously_underlining = (p->code != 0);
 	continue;
       }
       if (nextp && p->hpos == nextp->hpos) {
@@ -696,7 +793,7 @@
 	  nextp->code = p->code;
 	  continue;
 	}
-	if (!overstrike_flag)
+	if (!want_glyph_composition_by_overstriking)
 	  continue;
       }
       if (hpos > p->hpos) {
@@ -706,44 +803,45 @@
 	} while (hpos > p->hpos);
       }
       else {
-	if (horizontal_tab_flag) {
+	if (want_horizontal_tabs) {
 	  for (;;) {
 	    int next_tab_pos = ((hpos + TAB_WIDTH) / TAB_WIDTH) * TAB_WIDTH;
 	    if (next_tab_pos > p->hpos)
 	      break;
-	    if (cu_flag)
+	    if (is_continuously_underlining)
 	      make_underline(p->w);
-	    else if (!old_drawing_scheme && is_underline) {
-	      if (italic_flag)
+	    else if (!use_overstriking_drawing_scheme
+		     && is_underlining) {
+	      if (do_sgr_italics)
 		putstring(SGR_NO_ITALIC);
-	      else if (reverse_flag)
+	      else if (do_reverse_video)
 		putstring(SGR_NO_REVERSE);
 	      else
 		putstring(SGR_NO_UNDERLINE);
-	      is_underline = 0;
+	      is_underlining = false;
 	    }
 	    putchar('\t');
 	    hpos = next_tab_pos;
 	  }
 	}
 	for (; hpos < p->hpos; hpos++) {
-	  if (cu_flag)
+	  if (is_continuously_underlining)
 	    make_underline(p->w);
-	  else if (!old_drawing_scheme && is_underline) {
-	    if (italic_flag)
+	  else if (!use_overstriking_drawing_scheme && is_underlining) {
+	    if (do_sgr_italics)
 	      putstring(SGR_NO_ITALIC);
-	    else if (reverse_flag)
+	    else if (do_reverse_video)
 	      putstring(SGR_NO_REVERSE);
 	    else
 	      putstring(SGR_NO_UNDERLINE);
-	    is_underline = 0;
+	    is_underlining = false;
 	  }
 	  putchar(' ');
 	}
       }
       assert(hpos == p->hpos);
       if (p->mode & COLOR_CHANGE) {
-	if (!old_drawing_scheme) {
+	if (!use_overstriking_drawing_scheme) {
 	  if (p->fore_color_idx != curr_fore_idx) {
 	    put_color(p->fore_color_idx, 0);
 	    curr_fore_idx = p->fore_color_idx;
@@ -757,22 +855,22 @@
       }
       if (p->mode & UNDERLINE_MODE)
 	make_underline(p->w);
-      else if (!old_drawing_scheme && is_underline) {
-	if (italic_flag)
+      else if (!use_overstriking_drawing_scheme && is_underlining) {
+	if (do_sgr_italics)
 	  putstring(SGR_NO_ITALIC);
-	else if (reverse_flag)
+	else if (do_reverse_video)
 	  putstring(SGR_NO_REVERSE);
 	else
 	  putstring(SGR_NO_UNDERLINE);
-	is_underline = 0;
+	is_underlining = false;
       }
       if (p->mode & BOLD_MODE)
 	make_bold(p->code, p->w);
-      else if (!old_drawing_scheme && is_bold) {
+      else if (!use_overstriking_drawing_scheme && is_boldfacing) {
 	putstring(SGR_NO_BOLD);
-	is_bold = 0;
+	is_boldfacing = false;
       }
-      if (!old_drawing_scheme) {
+      if (!use_overstriking_drawing_scheme) {
 	if (p->fore_color_idx != curr_fore_idx) {
 	  put_color(p->fore_color_idx, 0);
 	  curr_fore_idx = p->fore_color_idx;
@@ -785,14 +883,14 @@
       put_char(p->code);
       hpos += p->w / font::hor;
     }
-    if (!old_drawing_scheme
-	&& (is_bold || is_underline
+    if (!use_overstriking_drawing_scheme
+	&& (is_boldfacing || is_underlining
 	    || curr_fore_idx != DEFAULT_COLOR_IDX
 	    || curr_back_idx != DEFAULT_COLOR_IDX))
       putstring(SGR_DEFAULT);
     putchar('\n');
   }
-  if (form_feed_flag) {
+  if (want_form_feeds) {
     if (last_line < lines_per_page)
       putchar('\f');
   }
@@ -814,19 +912,19 @@
 
 static void update_options()
 {
-  if (old_drawing_scheme) {
-    italic_flag = 0;
-    reverse_flag = 0;
+  if (use_overstriking_drawing_scheme) {
+    do_sgr_italics = false;
+    do_reverse_video = false;
     bold_underline_mode = bold_underline_mode_option;
-    bold_flag = bold_flag_option;
-    underline_flag = underline_flag_option;
+    do_bold = want_emboldening_by_overstriking;
+    do_underline = want_italics_by_underlining;
   }
   else {
-    italic_flag = italic_flag_option;
-    reverse_flag = reverse_flag_option;
+    do_sgr_italics = want_sgr_italics;
+    do_reverse_video = want_reverse_video_for_italics;
     bold_underline_mode = BOLD_MODE|UNDERLINE_MODE;
-    bold_flag = 1;
-    underline_flag = 1;
+    do_bold = true;
+    do_underline = true;
   }
 }
 
@@ -835,7 +933,7 @@
   program_name = argv0;
   static char stderr_bufBUFSIZ;
   if (getenv("GROFF_NO_SGR"))
-    old_drawing_scheme = 1;
+    use_overstriking_drawing_scheme = true;
   setbuf(stderr, stderr_buf);
   setlocale(LC_CTYPE, "");
   int c;
@@ -849,34 +947,34 @@
     switch(c) {
     case 'v':
       printf("GNU grotty (groff) version %s\n", Version_string);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case 'i':
       // Use italic font instead of underlining.
-      italic_flag_option = 1;
+      want_sgr_italics = true;
       break;
     case 'I':
       // ignore include search path
       break;
     case 'b':
       // Do not embolden by overstriking.
-      bold_flag_option = 0;
+      want_emboldening_by_overstriking = false;
       break;
     case 'c':
       // Use old scheme for emboldening and underline.
-      old_drawing_scheme = 1;
+      use_overstriking_drawing_scheme = true;
       break;
     case 'u':
       // Do not underline.
-      underline_flag_option = 0;
+      want_italics_by_underlining = false;
       break;
     case 'o':
       // Do not overstrike (other than emboldening and underlining).
-      overstrike_flag = 0;
+      want_glyph_composition_by_overstriking = false;
       break;
     case 'r':
       // Use reverse mode instead of underlining.
-      reverse_flag_option = 1;
+      want_reverse_video_for_italics = true;
       break;
     case 'B':
       // Do bold-underlining as bold.
@@ -888,28 +986,27 @@
       break;
     case 'h':
       // Use horizontal tabs.
-      horizontal_tab_flag = 1;
+      want_horizontal_tabs = true;
       break;
     case 'f':
-      form_feed_flag = 1;
+      want_form_feeds = true;
       break;
     case 'F':
       font::command_line_font_dir(optarg);
       break;
     case 'd':
       // Ignore \D commands.
-      draw_flag = 0;
+      allow_drawing_commands = false;
       break;
     case CHAR_MAX + 1: // --help
       usage(stdout);
-      exit(0);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(EXIT_FAILURE);
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled getopt_long return value");
     }
   update_options();
   if (optind >= argc)
@@ -923,6 +1020,24 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -bBcdfhioruUv -F dir files ...\n",
-	  program_name);
+  fprintf(stream,
+"usage: %s -bBcdfhioruU -F font-directory file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
+  if (stdout == stream) {
+    fputs(
+"\n"
+"Translate the output of troff(1) into a form suitable for\n"
+"typewriter‐like devices, including terminal emulators.  See the\n"
+"grotty(1) manual page.\n",
+	  stream);
+    exit(EXIT_SUCCESS);
+  }
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/ChangeLog -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/ChangeLog Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/Dvi.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/Dvi.c Changed

_service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/FontMap-X11 Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/GXditview.ad -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/GXditview.ad Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/font.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/font.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/gxditview.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/gxditview.1.man Changed

@@ -1,6 +1,8 @@
-.TH GXDITVIEW @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-gxditview \- display groff intermediate output files
+.TH gxditview @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+gxditview \- display
+.I groff
+intermediate output files in X11
 .
 .
 .\" ====================================================================
@@ -29,187 +31,228 @@
 .\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_gxditview_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY gxditview
-.RI  X-toolkit-option \&.\|.\|.\&
-.OP \-backingStore backing-store-type
-.OP \-filename string
-.OP \-page n
-.OP \-printCommand string
-.OP \-resolution res
-.RI  file 
+.RI  X-toolkit-option \~.\|.\|.\&
+.RB  \-backingStore\~\c
+.IR backing-store-type 
+.RB  \-filename\~\c
+.IR file 
+.\" While recognized, the relevant logic is "#if 0"ed out in draw.c.
+.\" .RB  \-noPolyText 
+.RB  \-page\~\c
+.IR page-number 
+.RB  \-printCommand\~\c
+.IR command 
+.RB  \-resolution\~\c
+.IR resolution 
+.I file
 .YS
 .
+.
 .SY gxditview
 .B \-help
+.
 .SY gxditview
 .B \-\-help
 .YS
 .
 .
+.SY gxditview
+.B \-version
+.
+.SY gxditview
+.B \-\-version
+.YS
+.
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The
-.B \%gxditview
-program displays the
-.I groff intermediate
-.IR output ,
-see
-.BR groff_out (@MAN5EXT@),
-on an X\~display.
+.I gxditview
+interprets and displays the intermediate output format of
+.MR groff @MAN1EXT@
+on an X11\~display.
 .
-It uses the standard X11 fonts, so it does not require access to the
-server machine for font loading.
+It uses the standard X11 fonts,
+so it does not require access to the server machine for font loading.
 .
 There are several ways to use
-.BR \%gxditview .
+.IR gxditview .
 .
 .
 .PP
 The
-.I groff intermediate output
-can be generated by
-.BR groff\~\-Z .
-This can be viewed by explicitly calling
-.B \%gxditview
-.IR \%filename .
-.
-If
-.I filename
-is
-.BR \- ,
-.B \%gxditview
-will read the standard input;
-.I \%filename
+intermediate output format of
+.IR groff ,
+documented in
+.MR groff_out @MAN5EXT@ ,
+is produced by
+.I @g@troff
+or the
+.B \-Z
+option to
+.IR groff .
+.
+.
+It can be viewed by explicitly calling
+.RB \lq gxditview
+.IR file \rq.
+.
+If the
+.I file
+operand is
+.RB \lq \- \rq,
+.I gxditview
+will read the standard input stream;
+.I file
 cannot be omitted.
 .
-The
-.I groff intermediate output
-is different for all devices.
+The intermediate output format of
+.I groff
+is device-independent but not device-agnostic.
+.
+.I gxditview
+can view it for all typesetter devices,
+but the quality is device-dependent.
 .
-.B \%gxditview
-can view it for all devices, but the quality is device dependent.
+.I gxditview
+will not display output for terminal
+.RI ( nroff )
+devices.
 .
 .
 .PP
 The best results are achieved with the
 .BR X *
 devices for
-.BR groff 's
-option
-.BR \-T .
+.IR groff 's
+.B \-T
+option,
+of which there are four:
+.BR \-TX75 ,
+.BR \-TX75\-12 ,
+.BR \-TX100 ,
+and
+.BR \-TX100\-12 .
 .
-There are four
-.BR X *
-devices:
-.BR \%\-TX75 ,
-.BR \%\-TX75\-12 ,
-.BR \%\-TX100 ,
-.BR \%\-TX100\-12 .
-They differ by the X\~resolution (75dpi or 100dpi) and the used base font
-size (10pt or 12pt).
+They differ by the X\~resolution
+(75 or 100 dots per inch)
+and the base point size
+(10 or 12 points).
 .
 They are especially built for
-.BR \%gxditview .
-.
-When using one of them
-.B groff
-generates the
-.I intermediate output
-for this device and calls
-.B \%gxditview
-automatically for viewing.
-.
-For example, to view this man page with a base resolution of 12pt, say
+.IR gxditview .
 .
-.IP
-.B groff \-TX100\-12 \-man \-rS12 gxditview.@MAN1EXT@
-.
-.
-.PP
-(option
-.BI \-rS XX
-is documented in the
-.BR groff_man (@MAN7EXT@)
-man page).
+When using one of these,
+.I groff
+generates the intermediate output for this device and calls
+.I gxditview
+automatically for viewing.
 .
 .
-.PP
-.BR groff 's
-option
+.P
 .B \-X
-produces
-.I intermediate output
-for the
-.I PostScript
-device and subsequently uses
-.B \%gxditview
-as a viewer for it.
-.
-The quality of the result depends mainly on the chosen point size and
-display resolution; for rapid previewing, however, something like
+produces good results only with
+.BR \-Tps ,
+.BR \-TX75 ,
+.BR \-TX75\-12 ,
+.BR \-TX100 ,
+and
+.BR \-TX100\-12 .
 .
-.IP
-.BI "groff \-X \-P\-resolution \-P100 " document
+The default resolution for previewing
+.B \-Tps
+output is 75\|dpi;
+this can be changed with the
+.B \-resolution
+option.
 .
 .
 .PP
-yields acceptable results.
-.
+While
+.I gxditview
+is running,
+the left mouse button brings up a menu with several entries.
 .
-.PP
-During the run of
-.BR \%gxditview ,
-the left mouse button brings up a menu with the following entries:
 .
-.TP 8
-.B "Next Page"
+.TP 13n
+.B Next Page
 Display the next page.
 .
+.
 .TP
-.B "Previous Page"
+.B Previous Page
 Display the previous page.
 .
+.
 .TP
-.B "Select Page"
+.B Select Page
 Select a particular numbered page specified by a dialog box.
 .
+.
 .TP
 .B Print
 Print the
-.I groff intermediate output
-using a command specified by a dialog box.
+.I groff
+intermediate output using a command specified by a dialog box.
 .
 The default command initially displayed is controlled by the
 .B printCommand
-application resource, and by the
+application resource,
+and by the
 .B \-printCommand
 option.
 .
+.
 .TP
 .B Open
 Open for display a new file specified by a dialog box.
 .
-The file should contain some
-.I groff intermediate
-.IR output .
+The file should contain
+.I groff
+intermediate output.
+.
+If the filename starts with a bar or pipe symbol,
+.RB \lq | \rq
+it will be interpreted as a command from which to read.
 .
-If the filename starts with
-.B |
-it will be taken to be a command to read from.
 .
 .TP
 .B Quit
 Exit from
-.BR \%gxditview .
+.BR gxditview .
 .
 .
 .PP
+The menu entries correspond to actions with similar but not identical
+names,
+which can also be accessed with keyboard accelerators.
+.
 The
 .IR n ,
 .IR Space ,
@@ -218,7 +261,7 @@
 .I Next
 .RI ( PgDn )
 keys are bound to the
-.B Next\ Page
+.B NextPage
 action.
 .
 The
@@ -230,7 +273,7 @@
 .I Prior
 .RI ( PgUp )
 keys are bound to the
-.B Previous\ Page
+.B PreviousPage
 action.
 .
 The
@@ -253,11 +296,12 @@
 .
 The
 .I r
-key is bound to the
+key is bound to a
 .B Rerasterize
-action which rereads the current file, and redisplays the current
-page; if the current file is a command, the command will be
-reexecuted.
+action which rereads the current file,
+and redisplays the current page;
+if the current file is a command,
+the command will be re-executed.
 .
 Vertical scrolling can be done with the
 .I k
@@ -286,36 +330,151 @@
 .B paperwidth
 commands in the
 .I DESC
-file specify the length and width in machine units of the virtual page
-displayed by
-.BR \%gxditview .
+file describing a
+.I groff
+output device specify the length and width in machine units of the
+virtual page displayed by
+.IR gxditview ;
+see
+.MR groff_font @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SS "X defaults"
 .\" ====================================================================
 .
-The
-.B \%gxditview
-program accepts all of the standard X\~Toolkit command-line options
-along with the additional options listed below:
+This program uses the
+.I Dvi
+widget from the X\~Toolkit.
+.
+It understands all of the core resource names and classes as well as:
+.
+.
+.TP
+.BR width\~ (class\~ Width )
+Specifies the width of the window.
+.
+.
+.TP
+.BR height\~ (class\~ Height )
+Specifies the height of the window.
+.
+.
+.TP
+.BR foreground\~ (class\~ Foreground )
+Specifies the default foreground color.
+.
+.
+.TP
+.BR font\~ (class\~ Font )
+Specifies the font to be used for error messages.
+.
+.
+.TP
+.BR fontMap\~ (class\~ FontMap )
+Specifies the mapping from
+.I groff
+font names to X\~font names.
+.
+This must be a string containing a sequence of lines.
+.
+Each line contains two whitespace-separated fields:
+firstly the
+.I groff
+font name,
+and secondly the XLFD
+(X Logical Font Description).
+.
+The default is shown in subsection \lqDefault font map\rq below.
+.
+.
+.\" ====================================================================
+.SS "Default font map"
+.\" ====================================================================
+.
+XLFDs are long and unwieldy,
+so some lines are shown broken and indented below.
+.\" Break them after the POINT_SIZE field (in "decipoints", so "100").
+.
+.
+.PP
+.EX
+TR  \-adobe\-times\-medium\-r\-normal\-\-*\-100\
+\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+TI  \-adobe\-times\-medium\-i\-normal\-\-*\-100\
+\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+TB  \-adobe\-times\-bold\-r\-normal\-\-*\-100\
+\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+TBI \-adobe\-times\-bold\-i\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+CR  \-adobe\-courier\-medium\-r\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-iso8859\-1\rsn\rs
+CI  \-adobe\-courier\-medium\-o\-normal\" break
+        \-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+CB  \-adobe\-courier\-bold\-r\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+CBI \-adobe\-courier\-bold\-o\-normal\
+\-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+HR  \-adobe\-helvetica\-medium\-r\-normal\" break
+        \-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+HI  \-adobe\-helvetica\-medium\-o\-normal\" break
+        \-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+HB  \-adobe\-helvetica\-bold\-r\-normal\" break
+        \-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+HBI \-adobe\-helvetica\-bold\-o\-normal\" break
+        \-\-*\-100\-*\-*\-*\-*\-iso8859\-1\rsn\rs
+NR  \-adobe\-new century schoolbook\-medium\-r\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-iso8859\-1\rsn\rs
+NI  \-adobe\-new century schoolbook\-medium\-i\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-iso8859\-1\rsn\rs
+NB  \-adobe\-new century schoolbook\-bold\-r\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-iso8859\-1\rsn\rs
+NBI \-adobe\-new century schoolbook\-bold\-i\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-iso8859\-1\rsn\rs
+S   \-adobe\-symbol\-medium\-r\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-adobe\-fontspecific\rsn\rs
+SS  \-adobe\-symbol\-medium\-r\-normal\-\-*\-100\" break
+        \-*\-*\-*\-*\-adobe\-fontspecific\rsn\rs
+.EE
+.
+.
+.br
+.ne 3v
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
 .
-.TP 8
 .B \-help
-This option indicates that a brief summary of the allowed options should be
-printed.
+and
+.B \-\-help
+display a usage message,
+while
+.B \-version
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.P
+.I gxditview
+accepts all of the standard X\~Toolkit command-line options along with
+the additional options listed below.
+.
 .
 .TP
 .B \-page
 This option specifies the page number of the document to be displayed.
 .
+.
 .TP
-.BI \-backingStore\  backing-store-type
-Redisplay of the
-.I groff intermediate output
-window can take up to a second or so, this option causes the server to
-save the window contents so that when it is scrolled around the
-viewport, the window is painted from contents saved in backing store.
+.BI \-backingStore\~ backing-store-type
+Because redisplay of the
+.I groff
+intermediate output window can take a perceiptible amount of time,
+this option causes the server to save the window contents so that when
+it is scrolled around the viewport,
+the window is painted from contents saved in backing store.
 .
 .I backing-store-type
 can be one of
@@ -324,24 +483,28 @@
 or
 .BR NotUseful .
 .
+.
 .TP
-.BI \-printCommand\  command
+.BI \-printCommand\~ command
 The default command displayed in the dialog box for the
 .B Print
 menu entry will be
 .IR command .
 .
+.
 .TP
-.BI \-resolution\  res
+.BI \-resolution\~ res
 The
-.I groff intermediate output
-file will be displayed at a resolution of
+.I groff
+intermediate output file will be displayed at a resolution of
 .I res
-dpi, unless the
+dots per inch,
+unless the
 .I DESC
 file contains the
 .B X11
-command, in which case the device resolution will be used.
+command,
+in which case the device resolution will be used.
 .
 This corresponds to the
 .I Dvi
@@ -349,179 +512,257 @@
 .B resolution
 resource.
 .
-The default is 75.
+The default is
+.BR 75 .
+.
 .
 .TP
-.BI \-filename\  string
+.BI \-filename\~ string
 The default filename displayed in the dialog box for the
 .B Open
 menu entry will be
 .IR string .
-This can be either a filename, or a command starting with
-.BR | .
+.
+This can be either a filename,
+or a command starting with
+.RB \lq | \rq.
 .
 .
 .PP
 The following standard X\~Toolkit command-line arguments are commonly
 used with
-.BR \%gxditview :
+.IR gxditview .
 .
-.TP 8
-.BI \-bg\  color
+.
+.TP
+.BI \-bg\~ color
 This option specifies the color to use for the background of the window.
 .
-The default is \fIwhite\fP.
+The default is
+.RB \lq white \rq.
+.
 .
 .TP
-.BI \-bd\  color
+.BI \-bd\~ color
 This option specifies the color to use for the border of the window.
 .
-The default is \fIblack\fP.
+The default is
+.RB \lq black \rq.
+.
 .
 .TP
-.BI \-bw\  number
+.BI \-bw\~ number
 This option specifies the width in pixels of the border surrounding the
 window.
 .
+.
 .TP
-.BI \-fg\  color
+.BI \-fg\~ color
 This option specifies the color to use for displaying text.
 .
 The default is
-\fIblack\fP.
+.RB \lq black \rq.
+.
 .
 .TP
-.BI \-fn\  font
+.BI \-fn\~ font
 This option specifies the font to be used for displaying widget text.
 .
-The default is \fIfixed\fP.
+The default is
+.RB \lq fixed \rq.
+.
 .
 .TP
 .B \-rv
 This option indicates that reverse video should be simulated by swapping
 the foreground and background colors.
 .
+.
 .TP
-.BI \-geometry\  geometry
+.BI \-geometry\~ geometry
 This option specifies the preferred size and position of the window.
 .
+.
 .TP
-.BI \-display\  host : display
+.BI \-display\~ host : display
 This option specifies the X\~server to contact.
 .
+.
 .TP
-.BI \-xrm\  resourcestring
+.BI \-xrm\~ resourcestring
 This option specifies a resource string to be used.
 .
 .
 .\" ====================================================================
-.SH X DEFAULTS
+.SH Environment
 .\" ====================================================================
 .
-This program uses the
-.I Dvi
-widget in the X\~Toolkit.
+.TP
+.I GROFF_FONT_PATH
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
 .
-It understands all of the core resource names and classes as well as:
+See
+.MR @g@troff @MAN1EXT@
+and
+.MR groff_font @MAN5EXT@ .
 .
-.TP 8
-.BR width\  (class\  Width )
-Specifies the width of the window.
+.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
 .
 .TP
-.BR height\  (class\  Height )
-Specifies the height of the window.
+.I @APPDEFDIR@/\:\%GXditview
+.TQ
+.I @APPDEFDIR@/\:\%GXditview\-color
+define X application defaults for
+.IR gxditview .
+.
+Users can override these values in the
+.I .Xdefaults
+file,
+normally located in the user's home directory.
+.
+See
+.MR appres 1
+and
+.MR xrdb 1 .
+.
 .
 .TP
-.BR foreground\  (class\  Foreground )
-Specifies the default foreground color.
+.I @FONTDIR@/\:\%devX100/\:DESC
+describes the
+.B X100
+output device.
+.
 .
 .TP
-.BR font\  (class\  Font )
-Specifies the font to be used for error messages.
+.IR @FONTDIR@/\:\%devX100/ F
+describes the font known
+.RI as\~ F
+on device
+.BR X100 .
+.
 .
 .TP
-.BR fontMap\  (class\  FontMap )
-Specifies the mapping from
-.I groff
-font names to X\~font names.
+.I @FONTDIR@/\:\%devX100\-12/\:DESC
+describes the
+.B X100\-12
+output device.
 .
-This must be a string containing a sequence of lines.
 .
-Each line contains two whitespace separated fields: first the
-.I groff
-font name, and secondly the X\~font name.
+.TP
+.IR @FONTDIR@/\:\%devX100\-12/ F
+describes the font known
+.RI as\~ F
+on device
+.BR X100\-12 .
 .
-The default is
-.nf
-"\e
-TR	-adobe-times-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-TI	-adobe-times-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-TB	-adobe-times-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-TBI	-adobe-times-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-CR	-adobe-courier-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-CI	-adobe-courier-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-CB	-adobe-courier-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-CBI	-adobe-courier-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-HR	-adobe-helvetica-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-HI	-adobe-helvetica-medium-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-HB	-adobe-helvetica-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-HBI	-adobe-helvetica-bold-o-normal--*-100-*-*-*-*-iso8859-1\en\e
-NR	-adobe-new century schoolbook-medium-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-NI	-adobe-new century schoolbook-medium-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-NB	-adobe-new century schoolbook-bold-r-normal--*-100-*-*-*-*-iso8859-1\en\e
-NBI	-adobe-new century schoolbook-bold-i-normal--*-100-*-*-*-*-iso8859-1\en\e
-S	-adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
-SS	-adobe-symbol-medium-r-normal--*-100-*-*-*-*-adobe-fontspecific\en\e
-"
-.fi
 .
+.TP
+.I @FONTDIR@/\:\%devX75/\:DESC
+describes the
+.B X75
+output device.
 .
-.\" ====================================================================
-.SH ENVIRONMENT
-.\" ====================================================================
 .
 .TP
-.I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+.IR @FONTDIR@/\:\%devX75/ F
+describes the font known
+.RI as\~ F
+on device
+.BR X75 .
 .
-See
-.BR @g@troff (@MAN1EXT@)
+.
+.TP
+.I @FONTDIR@/\:\%devX75\-12/\:DESC
+describes the
+.B X75\-12
+output device.
+.
+.
+.TP
+.IR @FONTDIR@/\:\%devX75\-12/ F
+describes the font known
+.RI as\~ F
+on device
+.BR X75\-12 .
+.
+.
+.TP
+.I @MACRODIR@/\:X.tmac
+defines macros for use with the
+.BR X100 ,
+.BR X100\-12 ,
+.BR X75 ,
+and
+.B X75\-12
+output devices.
+.
+It is automatically loaded by
+.I troffrc
+when any of those output devices is selected.
+.
+.
+.TP
+.I @MACRODIR@/\:Xps\:.tmac
+sets up
+.I @g@troff
+to use
+.I \%gxditview
+as a previewer for device-independent output targeting the
+.B ps
+output device.
+.
+It is automatically loaded by
+.I troffrc
+when
+.I @g@troff
+is given the options
+.B \-X
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.BR \-Tps .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Examples
 .\" ====================================================================
 .
-.TP
-.I @APPRESDIR@/GXditview
-.TQ
-.I @APPRESDIR@/GXditview\-color
-The default resource files of
-.BR \%gxditview .
+The following command views this man page with a base point size of 12.
 .
-Users should override these values in the
-.I .Xdefaults
-file, normally located in the user's home directory.
 .
-See
-.BR xrdb (1)
-and
-.BR appres (1)
-for more.
+.RS
+.P
+.EX
+groff \-TX100\-12 \-man gxditview.1
+.EE
+.RE
+.
+.
+.P
+The quality of the result depends mainly on the chosen point size and
+display resolution;
+for rapid previewing,
+however,
+something like
+.
+.RS
+.EX
+.RI "groff \-X \-P\-resolution \-P100\~" document
+.EE
+.RE
+.
+yields acceptable results.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
-.B gxditview
+.
+.I gxditview
 and its predecessor
-.B xditview
+.I xditview
 were written by
 Keith Packard (MIT X Consortium),
 Richard L.\& Hyde (Purdue),
@@ -532,32 +773,43 @@
 James Clark.
 .
 .
+.PP
+This program is derived from
+.IR xditview ;
+portions of
+.I xditview
+originated in
+.IR xtroff ,
+which was derived from
+.IR \%suntroff .
+.
+.
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR X (7),
-.BR xrdb (1),
-.BR xditview (1),
-.BR groff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@)
+.UR https://\:www\:.x\:.org/\:releases/\:X11R7.6/\:doc/\:xorg\-docs/\
+\:specs/\:XLFD/xlfd\:.html
+\lqX Logical Font Description Conventions\rq
+.UE ,
+by Jim Flowers and Stephen Gildea.
 .
 .
-.\" ====================================================================
-.SH ORIGIN
-.\" ====================================================================
+.PP
+.MR X 7 ,
+.MR xrdb 1 ,
+.MR xditview 1 ,
+.MR groff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@
 .
-This program is derived from
-.BR \%xditview ;
-portions of
-.B \%xditview
-originated in
-.B \%xtroff
-which was derived from
-.BR \%suntroff .
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_gxditview_1_man_C
+.do rr *groff_gxditview_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/lex.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/lex.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/page.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/page.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/parse.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/parse.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/xditview.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/xditview.am Changed

@@ -1,16 +1,14 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Last update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -36,37 +34,48 @@
   src/devices/xditview/Menu.h \
   src/devices/xditview/Dvi.h
 
+GXDITVIEW_GROFF_VERSION_H=src/devices/xditview/groff_version.h
+
+$(GXDITVIEW_GROFF_VERSION_H): $(top_srcdir)/.version
+	$(AM_V_at)$(MKDIR_P) `dirname $@`
+	$(AM_V_GEN)printf \
+	  'const char *Version_string = "%s";\n' '@VERSION@' > $@
+
 if WITHOUT_X11
+GXDITVIEW_MAN1 =
 EXTRA_DIST += $(GXDITVIEWSOURCES)
 else
+GXDITVIEW_MAN1 = src/devices/xditview/gxditview.1
 xditview_srcdir = $(top_srcdir)/src/devices/xditview
 bin_PROGRAMS += gxditview
 gxditview_CPPFLAGS = $(AM_CPPFLAGS) $(X_CFLAGS) -Dlint \
   -I$(top_builddir)/src/devices/xditview
 gxditview_LDADD = $(X_LIBS) $(X_PRE_LIBS) -lXaw -lXmu -lXt -lX11 \
   $(X_EXTRA_LIBS) $(LIBM) libxutil.a lib/libgnu.a
-XDITVIEW_GENHDRS = src/devices/xditview/GXditview-ad.h
+XDITVIEW_GENHDRS = \
+ src/devices/xditview/GXditview-ad.h \
+ $(GXDITVIEW_GROFF_VERSION_H)
 gxditview_SOURCES = $(GXDITVIEWSOURCES)
 nodist_gxditview_SOURCES = $(XDITVIEW_GENHDRS)
 CLEANFILES += $(XDITVIEW_GENHDRS)
 
-man1_MANS += src/devices/xditview/gxditview.1
+man1_MANS += $(GXDITVIEW_MAN1)
 
-# Because we defined gxditview_CPPFLAGS, automake renames all the xditview's 
-# objects, adding an "gxditview-" prefix. 
+# Because we defined gxditview_CPPFLAGS, automake renames all of
+# xditview's objects, adding an "gxditview-" prefix.
 src/devices/xditview/gxditview-device.$(OBJEXT): defs.h
 src/devices/xditview/gxditview-xditview.$(OBJEXT): $(XDITVIEW_GENHDRS)
 
 src/devices/xditview/GXditview-ad.h: $(xditview_srcdir)/GXditview.ad
-	@echo Making $@
-	$(SHELL) $(xditview_srcdir)/ad2c $(xditview_srcdir)/GXditview.ad > $@
+	$(AM_V_GEN)$(SHELL) $(xditview_srcdir)/ad2c \
+	  $(xditview_srcdir)/GXditview.ad > $@
 endif
 
 EXTRA_DIST += \
   src/devices/xditview/ad2c \
   src/devices/xditview/ChangeLog \
   src/devices/xditview/DESC.in \
-  src/devices/xditview/FontMap \
+  src/devices/xditview/FontMap-X11 \
   src/devices/xditview/GXditview-color.ad \
   src/devices/xditview/GXditview.ad \
   src/devices/xditview/README \
@@ -91,31 +100,31 @@
 install_xditview:
 uninstall_xditview:
 else
-install_xditview: $(xditview_srcdir)/GXditview.ad $(xditview_srcdir)/GXditview-color.ad
-	-test -d $(DESTDIR)$(appresdir) \
-	  || $(mkinstalldirs) $(DESTDIR)$(appresdir)
-	if test -f $(DESTDIR)$(appresdir)/GXditview; then \
-	  mv $(DESTDIR)$(appresdir)/GXditview \
-	    $(DESTDIR)$(appresdir)/GXditview.old; \
-	fi
-	if test -f $(DESTDIR)$(appresdir)/GXditview-color; then \
-	  mv $(DESTDIR)$(appresdir)/GXditview-color \
-	    $(DESTDIR)$(appresdir)/GXditview-color.old; \
-	fi
+install_xditview: \
+  $(xditview_srcdir)/FontMap-X11 \
+  $(xditview_srcdir)/GXditview.ad \
+  $(xditview_srcdir)/GXditview-color.ad
+	$(MKDIR_P) $(DESTDIR)$(fontdir)
+	$(INSTALL_DATA) $(xditview_srcdir)/FontMap-X11 \
+	  $(DESTDIR)$(fontdir)/FontMap-X11
+	-test -d $(DESTDIR)$(appdefdir) \
+	  || $(mkinstalldirs) $(DESTDIR)$(appdefdir)
 	$(INSTALL_DATA) $(xditview_srcdir)/GXditview.ad \
-	  $(DESTDIR)$(appresdir)/GXditview
+	  $(DESTDIR)$(appdefdir)/GXditview
 	$(INSTALL_DATA) $(xditview_srcdir)/GXditview-color.ad \
-	  $(DESTDIR)$(appresdir)/GXditview-color
+	  $(DESTDIR)$(appdefdir)/GXditview-color
 
 uninstall_xditview:
-	rm -f $(DESTDIR)$(appresdir)/GXditview
-	rm -f $(DESTDIR)$(appresdir)/GXditview-color
+	rm -f $(DESTDIR)$(appdefdir)/GXditview
+	rm -f $(DESTDIR)$(appdefdir)/GXditview-color
+	rm -f $(DESTDIR)$(fontdir)/FontMap-X11
+	-rmdir $(DESTDIR)$(fontdir) 2>/dev/null
 
 endif
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/devices/xditview/xditview.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/devices/xditview/xditview.c Changed

@@ -50,11 +50,13 @@
 #include <X11/Xaw/SimpleMenu.h>
 #include <X11/Xaw/SmeBSB.h>
 
+#include <stdbool.h>
 #include <stdlib.h>
 #include <signal.h>
 #include <stdio.h>
 
 #include "Dvi.h"
+#include "groff_version.h"
 
 #include "xdit.bm"
 #include "xdit_mask.bm"
@@ -93,7 +95,7 @@
 #undef offset
 
 /* Command line options table.  Only resources are entered here...there is a
-   pass over the remaining options after XtParseCommand is let loose. */
+   pass over the remaining options after XrmParseCommand is let loose. */
 
 static XrmOptionDescRec options = {
 {(char *)"-page", (char *)"*dvi.pageNumber",
@@ -120,15 +122,30 @@
  */
 
 static void
-Syntax(const char *call)
+Syntax(const char *progname, bool had_error)
 {
-	(void) printf ("Usage: %s -fg <color> -bg <color>\n", call);
-	(void) printf ("       -bd <color> -bw <pixels> -help\n");
-	(void) printf ("       -display displayname -geometry geom\n");
-	(void) printf ("       -page <page-number> -backing <backing-store>\n");
-	(void) printf ("       -resolution <res> -print <command>\n");
-	(void) printf ("       -filename <file> filename\n\n");
-	exit(1);
+	FILE *stream = stdout;
+	if (had_error)
+		stream = stderr;
+	(void) fprintf (stream, "usage: %s X-toolkit-option"
+			" -backingStore backing-store-type"
+			" -filename file"
+// See draw.c:FlushCharCache().
+#if 0
+			" -noPolyText"
+#endif
+			" -page page-number"
+			" -printCommand command"
+			" -resolution resolution"
+			" file\n", progname);
+	(void) fprintf (stream, "usage: %s {-version | --version}\n",
+			progname);
+	(void) fprintf (stream, "usage: %s {-help | --help}\n",
+			progname);
+	if (had_error)
+		exit(EXIT_FAILURE);
+	else
+		exit(EXIT_SUCCESS);
 }
 
 static void	NewFile (const char *);
@@ -205,10 +222,19 @@
     toplevel = XtAppInitialize(&xtcontext, "GXditview",
 			    options, XtNumber (options),
  			    &argc, argv, fallback_resources, NULL, 0);
-    if (argc > 2
-	|| (argc == 2 && (!strcmp(argv1, "-help")
-			  || !strcmp(argv1, "--help"))))
-	Syntax(argv0);
+    if (argc > 2)
+	Syntax(argv0, true /* had error */);
+    else if (argc == 2) {
+	if ((strcmp(argv1, "-help") == 0)
+	    || (strcmp(argv1, "--help") == 0))
+		Syntax(argv0, false /* did not have error */);
+	else if ((strcmp(argv1, "-version") == 0)
+	    || (strcmp(argv1, "--version") == 0)) {
+		(void) printf("GNU gxditview (groff) version %s\n",
+			      Version_string);
+		exit(EXIT_SUCCESS);
+	}
+    }
 
     XtGetApplicationResources(toplevel, (XtPointer)&app_resources,
 			      resources, XtNumber(resources),
@@ -444,7 +470,7 @@
     FILE *print_file;
     RETSIGTYPE (*handler)(int);
 
-    /* Avoid dieing because of an invalid command. */
+    /* Avoid dying because of an invalid command. */
     handler = signal(SIGPIPE, SIG_IGN);
 
     print_file = popen(name, "w");

_service:tar_scm:groff-1.22.4.tar.gz/src/include/DviChar.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/DviChar.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/cmap.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/cmap.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/color.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/color.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/config.hin -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/config.hin Changed

@@ -1,119 +1,8 @@
 /* src/include/config.hin.  Generated from configure.ac by autoheader.  */
 
-/* CPU and C ABI indicator */
-#ifndef __i386__
-#undef __i386__
-#endif
-#ifndef __x86_64_x32__
-#undef __x86_64_x32__
-#endif
-#ifndef __x86_64__
-#undef __x86_64__
-#endif
-#ifndef __alpha__
-#undef __alpha__
-#endif
-#ifndef __arm__
-#undef __arm__
-#endif
-#ifndef __armhf__
-#undef __armhf__
-#endif
-#ifndef __arm64_ilp32__
-#undef __arm64_ilp32__
-#endif
-#ifndef __arm64__
-#undef __arm64__
-#endif
-#ifndef __hppa__
-#undef __hppa__
-#endif
-#ifndef __hppa64__
-#undef __hppa64__
-#endif
-#ifndef __ia64_ilp32__
-#undef __ia64_ilp32__
-#endif
-#ifndef __ia64__
-#undef __ia64__
-#endif
-#ifndef __m68k__
-#undef __m68k__
-#endif
-#ifndef __mips__
-#undef __mips__
-#endif
-#ifndef __mipsn32__
-#undef __mipsn32__
-#endif
-#ifndef __mips64__
-#undef __mips64__
-#endif
-#ifndef __powerpc__
-#undef __powerpc__
-#endif
-#ifndef __powerpc64__
-#undef __powerpc64__
-#endif
-#ifndef __powerpc64_elfv2__
-#undef __powerpc64_elfv2__
-#endif
-#ifndef __riscv32__
-#undef __riscv32__
-#endif
-#ifndef __riscv64__
-#undef __riscv64__
-#endif
-#ifndef __riscv32_ilp32__
-#undef __riscv32_ilp32__
-#endif
-#ifndef __riscv32_ilp32f__
-#undef __riscv32_ilp32f__
-#endif
-#ifndef __riscv32_ilp32d__
-#undef __riscv32_ilp32d__
-#endif
-#ifndef __riscv64_ilp32__
-#undef __riscv64_ilp32__
-#endif
-#ifndef __riscv64_ilp32f__
-#undef __riscv64_ilp32f__
-#endif
-#ifndef __riscv64_ilp32d__
-#undef __riscv64_ilp32d__
-#endif
-#ifndef __riscv64_lp64__
-#undef __riscv64_lp64__
-#endif
-#ifndef __riscv64_lp64f__
-#undef __riscv64_lp64f__
-#endif
-#ifndef __riscv64_lp64d__
-#undef __riscv64_lp64d__
-#endif
-#ifndef __s390__
-#undef __s390__
-#endif
-#ifndef __s390x__
-#undef __s390x__
-#endif
-#ifndef __sh__
-#undef __sh__
-#endif
-#ifndef __sparc__
-#undef __sparc__
-#endif
-#ifndef __sparc64__
-#undef __sparc64__
-#endif
-
-
 /* Define if building universal (internal helper macro) */
 #undef AC_APPLE_UNIVERSAL_BUILD
 
-/* Define if your C++ doesn't understand 'delete '. */
-#undef ARRAY_DELETE_NEEDS_SIZE
-
 /* Define to the number of bits in type 'ptrdiff_t'. */
 #undef BITSIZEOF_PTRDIFF_T
 
@@ -133,12 +22,7 @@
    non-IEEE-754 'long double' values. */
 #undef CHECK_PRINTF_SAFE
 
-/* Define to one of `_getb67', `GETB67', `getb67' for Cray-2 and Cray-YMP
-   systems. This function is required for `alloca.c' support on those systems.
-   */
-#undef CRAY_STACKSEG_END
-
-/* Define to 1 if using `alloca.c'. */
+/* Define to 1 if using 'alloca.c'. */
 #undef C_ALLOCA
 
 /* Define as the bit index in the word where to find bit 0 of the exponent of
@@ -183,24 +67,78 @@
    whether the gnulib module snprintf shall be considered present. */
 #undef GNULIB_SNPRINTF
 
+/* Define to 1 when the gnulib module fgetc should be tested. */
+#undef GNULIB_TEST_FGETC
+
+/* Define to 1 when the gnulib module fgets should be tested. */
+#undef GNULIB_TEST_FGETS
+
+/* Define to 1 when the gnulib module fprintf should be tested. */
+#undef GNULIB_TEST_FPRINTF
+
 /* Define to 1 when the gnulib module fprintf-posix should be tested. */
 #undef GNULIB_TEST_FPRINTF_POSIX
 
+/* Define to 1 when the gnulib module fputc should be tested. */
+#undef GNULIB_TEST_FPUTC
+
+/* Define to 1 when the gnulib module fputs should be tested. */
+#undef GNULIB_TEST_FPUTS
+
+/* Define to 1 when the gnulib module fread should be tested. */
+#undef GNULIB_TEST_FREAD
+
+/* Define to 1 when the gnulib module free-posix should be tested. */
+#undef GNULIB_TEST_FREE_POSIX
+
 /* Define to 1 when the gnulib module frexp should be tested. */
 #undef GNULIB_TEST_FREXP
 
 /* Define to 1 when the gnulib module frexpl should be tested. */
 #undef GNULIB_TEST_FREXPL
 
+/* Define to 1 when the gnulib module fscanf should be tested. */
+#undef GNULIB_TEST_FSCANF
+
+/* Define to 1 when the gnulib module fwrite should be tested. */
+#undef GNULIB_TEST_FWRITE
+
+/* Define to 1 when the gnulib module getc should be tested. */
+#undef GNULIB_TEST_GETC
+
+/* Define to 1 when the gnulib module getchar should be tested. */
+#undef GNULIB_TEST_GETCHAR
+
 /* Define to 1 when the gnulib module memchr should be tested. */
 #undef GNULIB_TEST_MEMCHR
 
+/* Define to 1 when the gnulib module printf should be tested. */
+#undef GNULIB_TEST_PRINTF
+
+/* Define to 1 when the gnulib module putc should be tested. */
+#undef GNULIB_TEST_PUTC
+
+/* Define to 1 when the gnulib module putchar should be tested. */
+#undef GNULIB_TEST_PUTCHAR
+
+/* Define to 1 when the gnulib module puts should be tested. */
+#undef GNULIB_TEST_PUTS
+
+/* Define to 1 when the gnulib module scanf should be tested. */
+#undef GNULIB_TEST_SCANF
+
 /* Define to 1 when the gnulib module signbit should be tested. */
 #undef GNULIB_TEST_SIGNBIT
 
 /* Define to 1 when the gnulib module snprintf should be tested. */
 #undef GNULIB_TEST_SNPRINTF
 
+/* Define to 1 when the gnulib module vfprintf should be tested. */
+#undef GNULIB_TEST_VFPRINTF
+
+/* Define to 1 when the gnulib module vprintf should be tested. */
+#undef GNULIB_TEST_VPRINTF
+
 /* Define to 1 when the gnulib module vsnprintf should be tested. */
 #undef GNULIB_TEST_VSNPRINTF
 
@@ -211,8 +149,7 @@
    may be supplied by this distribution. */
 #undef HAVE_ALLOCA
 
-/* Define to 1 if you have <alloca.h> and it should be used (not on Ultrix).
-   */
+/* Define to 1 if <alloca.h> works. */
 #undef HAVE_ALLOCA_H
 
 /* Define to 1 if you have the <bp-sym.h> header file. */
@@ -242,6 +179,9 @@
 /* Define to 1 if you have the <crtdefs.h> header file. */
 #undef HAVE_CRTDEFS_H
 
+/* Define to 1 if the static_assert keyword works. */
+#undef HAVE_C_STATIC_ASSERT
+
 /* Define to 1 if you have the declaration of `alarm', and to 0 if you don't.
    */
 #undef HAVE_DECL_ALARM
@@ -258,14 +198,46 @@
    don't. */
 #undef HAVE_DECL_COPYSIGNL
 
+/* Define to 1 if you have the declaration of `ecvt', and to 0 if you don't.
+   */
+#undef HAVE_DECL_ECVT
+
+/* Define to 1 if you have the declaration of `execvpe', and to 0 if you
+   don't. */
+#undef HAVE_DECL_EXECVPE
+
+/* Define to 1 if you have the declaration of `fcloseall', and to 0 if you
+   don't. */
+#undef HAVE_DECL_FCLOSEALL
+
+/* Define to 1 if you have the declaration of `fcvt', and to 0 if you don't.
+   */
+#undef HAVE_DECL_FCVT
+
+/* Define to 1 if you have the declaration of `gcvt', and to 0 if you don't.
+   */
+#undef HAVE_DECL_GCVT
+
 /* Define to 1 if you have the declaration of `getc_unlocked', and to 0 if you
    don't. */
 #undef HAVE_DECL_GETC_UNLOCKED
 
+/* Define to 1 if you have the declaration of `getw', and to 0 if you don't.
+   */
+#undef HAVE_DECL_GETW
+
+/* Define to 1 if you have the declaration of `putw', and to 0 if you don't.
+   */
+#undef HAVE_DECL_PUTW
+
 /* Define to 1 if you have the declaration of `snprintf', and to 0 if you
    don't. */
 #undef HAVE_DECL_SNPRINTF
 
+/* Define to 1 if you have the declaration of `strsignal', and to 0 if you
+   don't. */
+#undef HAVE_DECL_STRSIGNAL
+
 /* Define to 1 if you have the declaration of `sys_siglist', and to 0 if you
    don't. */
 #undef HAVE_DECL_SYS_SIGLIST
@@ -278,6 +250,10 @@
    don't. */
 #undef HAVE_DECL_VSNPRINTF
 
+/* Define to 1 if you have the declaration of `wcsdup', and to 0 if you don't.
+   */
+#undef HAVE_DECL_WCSDUP
+
 /* Define to 1 if you have the declaration of `wcwidth', and to 0 if you
    don't. */
 #undef HAVE_DECL_WCWIDTH
@@ -298,6 +274,9 @@
 /* Define to 1 if you have the `fmod' function. */
 #undef HAVE_FMOD
 
+/* Define if the 'free' function is guaranteed to preserve errno. */
+#undef HAVE_FREE_POSIX
+
 /* Define if the frexpl function is available in libc. */
 #undef HAVE_FREXPL_IN_LIBC
 
@@ -369,8 +348,8 @@
 /* Define to 1 if you have the `mbrtowc' function. */
 #undef HAVE_MBRTOWC
 
-/* Define to 1 if you have the <memory.h> header file. */
-#undef HAVE_MEMORY_H
+/* Define to 1 if you have the <minix/config.h> header file. */
+#undef HAVE_MINIX_CONFIG_H
 
 /* Define if you have mkstemp(). */
 #undef HAVE_MKSTEMP
@@ -416,6 +395,13 @@
    buffer had been large enough. */
 #undef HAVE_SNPRINTF_RETVAL_C99
 
+/* Define if the string produced by the snprintf function is always NUL
+   terminated. */
+#undef HAVE_SNPRINTF_TRUNCATION_C99
+
+/* Define to 1 if you have the <stdbool.h> header file. */
+#undef HAVE_STDBOOL_H
+
 /* Define to 1 if you have the <stddef.h> header file. */
 #undef HAVE_STDDEF_H
 
@@ -426,12 +412,18 @@
    uintmax_t. */
 #undef HAVE_STDINT_H_WITH_UINTMAX
 
+/* Define to 1 if you have the <stdio.h> header file. */
+#undef HAVE_STDIO_H
+
 /* Define to 1 if you have the <stdlib.h> header file. */
 #undef HAVE_STDLIB_H
 
 /* Define to 1 if you have the `strcasecmp' function. */
 #undef HAVE_STRCASECMP
 
+/* Define to 1 if you have the `strdup' function. */
+#undef HAVE_STRDUP
+
 /* Define to 1 if you have the `strerror' function. */
 #undef HAVE_STRERROR
 
@@ -537,9 +529,120 @@
 /* Define to 1 if O_NOFOLLOW works. */
 #undef HAVE_WORKING_O_NOFOLLOW
 
+/* Define to 1 if the system has the type `_Bool'. */
+#undef HAVE__BOOL
+
 /* Define to 1 if you have the `__fseterr' function. */
 #undef HAVE___FSETERR
 
+/* Define to 1 if ctype.h defines __header_inline. */
+#undef HAVE___HEADER_INLINE
+
+/* Please see the Gnulib manual for how to use these macros.
+
+   Suppress extern inline with HP-UX cc, as it appears to be broken; see
+   <https://lists.gnu.org/r/bug-texinfo/2013-02/msg00030.html>.
+
+   Suppress extern inline with Sun C in standards-conformance mode, as it
+   mishandles inline functions that call each other.  E.g., for 'inline void f
+   (void) { } inline void g (void) { f (); }', c99 incorrectly complains
+   'reference to static identifier "f" in extern inline function'.
+   This bug was observed with Oracle Developer Studio 12.6
+   (Sun C 5.15 SunOS_sparc 2017/05/30).
+
+   Suppress extern inline (with or without __attribute__ ((__gnu_inline__)))
+   on configurations that mistakenly use 'static inline' to implement
+   functions or macros in standard C headers like <ctype.h>.  For example,
+   if isdigit is mistakenly implemented via a static inline function,
+   a program containing an extern inline function that calls isdigit
+   may not work since the C standard prohibits extern inline functions
+   from calling static functions (ISO C 99 section 6.7.4.(3).
+   This bug is known to occur on:
+
+     OS X 10.8 and earlier; see:
+     https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html
+
+     DragonFly; see
+     http://muscles.dragonflybsd.org/bulk/clang-master-potential/20141111_102002/logs/ah-tty-0.3.12.log
+
+     FreeBSD; see:
+     https://lists.gnu.org/r/bug-gnulib/2014-07/msg00104.html
+
+   OS X 10.9 has a macro __header_inline indicating the bug is fixed for C and
+   for clang but remains for g++; see <https://trac.macports.org/ticket/41033>.
+   Assume DragonFly and FreeBSD will be similar.
+
+   GCC 4.3 and above with -std=c99 or -std=gnu99 implements ISO C99
+   inline semantics, unless -fgnu89-inline is used.  It defines a macro
+   __GNUC_STDC_INLINE__ to indicate this situation or a macro
+   __GNUC_GNU_INLINE__ to indicate the opposite situation.
+   GCC 4.2 with -std=c99 or -std=gnu99 implements the GNU C inline
+   semantics but warns, unless -fgnu89-inline is used:
+     warning: C99 inline functions are not supported; using GNU89
+     warning: to disable this warning use -fgnu89-inline or the gnu_inline function attribute
+   It defines a macro __GNUC_GNU_INLINE__ to indicate this situation.
+ */
+#if (((defined __APPLE__ && defined __MACH__) \
+      || defined __DragonFly__ || defined __FreeBSD__) \
+     && (defined HAVE___HEADER_INLINE \
+         ? (defined __cplusplus && defined __GNUC_STDC_INLINE__ \
+            && ! defined __clang__) \
+         : ((! defined _DONT_USE_CTYPE_INLINE_ \
+             && (defined __GNUC__ || defined __cplusplus)) \
+            || (defined _FORTIFY_SOURCE && 0 < _FORTIFY_SOURCE \
+                && defined __GNUC__ && ! defined __cplusplus))))
+# define _GL_EXTERN_INLINE_STDHEADER_BUG
+#endif
+#if ((__GNUC__ \
+      ? defined __GNUC_STDC_INLINE__ && __GNUC_STDC_INLINE__ \
+      : (199901L <= __STDC_VERSION__ \
+         && !defined __HP_cc \
+         && !defined __PGI \
+         && !(defined __SUNPRO_C && __STDC__))) \
+     && !defined _GL_EXTERN_INLINE_STDHEADER_BUG)
+# define _GL_INLINE inline
+# define _GL_EXTERN_INLINE extern inline
+# define _GL_EXTERN_INLINE_IN_USE
+#elif (2 < __GNUC__ + (7 <= __GNUC_MINOR__) && !defined __STRICT_ANSI__ \
+       && !defined _GL_EXTERN_INLINE_STDHEADER_BUG)
+# if defined __GNUC_GNU_INLINE__ && __GNUC_GNU_INLINE__
+   /* __gnu_inline__ suppresses a GCC 4.2 diagnostic.  */
+#  define _GL_INLINE extern inline __attribute__ ((__gnu_inline__))
+# else
+#  define _GL_INLINE extern inline
+# endif
+# define _GL_EXTERN_INLINE extern
+# define _GL_EXTERN_INLINE_IN_USE
+#else
+# define _GL_INLINE _GL_UNUSED static
+# define _GL_EXTERN_INLINE _GL_UNUSED static
+#endif
+
+/* In GCC 4.6 (inclusive) to 5.1 (exclusive),
+   suppress bogus "no previous prototype for 'FOO'"
+   and "no previous declaration for 'FOO'" diagnostics,
+   when FOO is an inline function in the header; see
+   <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=54113> and
+   <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=63877>.  */
+#if __GNUC__ == 4 && 6 <= __GNUC_MINOR__
+# if defined __GNUC_STDC_INLINE__ && __GNUC_STDC_INLINE__
+#  define _GL_INLINE_HEADER_CONST_PRAGMA
+# else
+#  define _GL_INLINE_HEADER_CONST_PRAGMA \
+     _Pragma ("GCC diagnostic ignored \"-Wsuggest-attribute=const\"")
+# endif
+# define _GL_INLINE_HEADER_BEGIN \
+    _Pragma ("GCC diagnostic push") \
+    _Pragma ("GCC diagnostic ignored \"-Wmissing-prototypes\"") \
+    _Pragma ("GCC diagnostic ignored \"-Wmissing-declarations\"") \
+    _GL_INLINE_HEADER_CONST_PRAGMA
+# define _GL_INLINE_HEADER_END \
+    _Pragma ("GCC diagnostic pop")
+#else
+# define _GL_INLINE_HEADER_BEGIN
+# define _GL_INLINE_HEADER_END
+#endif
+
 /* Define as const if the declaration of iconv() needs const. */
 #undef ICONV_CONST
 
@@ -668,9 +771,6 @@
 /* Define to the version of this package. */
 #undef PACKAGE_VERSION
 
-/* Define if the printer's page size is A4. */
-#undef PAGEA4
-
 /* Define to l, ll, u, ul, ull, etc., as suitable for constants of type
    'ptrdiff_t'. */
 #undef PTRDIFF_T_SUFFIX
@@ -710,12 +810,11 @@
 	STACK_DIRECTION = 0 => direction of growth unknown */
 #undef STACK_DIRECTION
 
-/* Define to 1 if you have the ANSI C header files. */
+/* Define to 1 if all of the C90 standard headers exist (not just the ones
+   required in a freestanding environment). This macro is provided for
+   backward compatibility; new code need not use it. */
 #undef STDC_HEADERS
 
-/* Define if your C++ compiler uses a traditional (Reiser) preprocessor. */
-#undef TRADITIONAL_CPP
-
 /* Enable extensions on AIX 3, Interix.  */
 #ifndef _ALL_SOURCE
 # undef _ALL_SOURCE
@@ -724,19 +823,44 @@
 #ifndef _DARWIN_C_SOURCE
 # undef _DARWIN_C_SOURCE
 #endif
+/* Enable general extensions on Solaris.  */
+#ifndef __EXTENSIONS__
+# undef __EXTENSIONS__
+#endif
 /* Enable GNU extensions on systems that have them.  */
 #ifndef _GNU_SOURCE
 # undef _GNU_SOURCE
 #endif
-/* Enable NetBSD extensions on NetBSD.  */
+/* Enable X/Open compliant socket functions that do not require linking
+   with -lxnet on HP-UX 11.11.  */
+#ifndef _HPUX_ALT_XOPEN_SOCKET_API
+# undef _HPUX_ALT_XOPEN_SOCKET_API
+#endif
+/* Identify the host operating system as Minix.
+   This macro does not affect the system headers' behavior.
+   A future release of Autoconf may stop defining this macro.  */
+#ifndef _MINIX
+# undef _MINIX
+#endif
+/* Enable general extensions on NetBSD.
+   Enable NetBSD compatibility extensions on Minix.  */
 #ifndef _NETBSD_SOURCE
 # undef _NETBSD_SOURCE
 #endif
-/* Enable OpenBSD extensions on NetBSD.  */
+/* Enable OpenBSD compatibility extensions on NetBSD.
+   Oddly enough, this does nothing on OpenBSD.  */
 #ifndef _OPENBSD_SOURCE
 # undef _OPENBSD_SOURCE
 #endif
-/* Enable threading extensions on Solaris.  */
+/* Define to 1 if needed for POSIX-compatible behavior.  */
+#ifndef _POSIX_SOURCE
+# undef _POSIX_SOURCE
+#endif
+/* Define to 2 if needed for POSIX-compatible behavior.  */
+#ifndef _POSIX_1_SOURCE
+# undef _POSIX_1_SOURCE
+#endif
+/* Enable POSIX-compatible threading on Solaris.  */
 #ifndef _POSIX_PTHREAD_SEMANTICS
 # undef _POSIX_PTHREAD_SEMANTICS
 #endif
@@ -752,11 +876,15 @@
 #ifndef __STDC_WANT_IEC_60559_DFP_EXT__
 # undef __STDC_WANT_IEC_60559_DFP_EXT__
 #endif
+/* Enable extensions specified by C23 Annex F.  */
+#ifndef __STDC_WANT_IEC_60559_EXT__
+# undef __STDC_WANT_IEC_60559_EXT__
+#endif
 /* Enable extensions specified by ISO/IEC TS 18661-4:2015.  */
 #ifndef __STDC_WANT_IEC_60559_FUNCS_EXT__
 # undef __STDC_WANT_IEC_60559_FUNCS_EXT__
 #endif
-/* Enable extensions specified by ISO/IEC TS 18661-3:2015.  */
+/* Enable extensions specified by C23 Annex H and ISO/IEC TS 18661-3:2015.  */
 #ifndef __STDC_WANT_IEC_60559_TYPES_EXT__
 # undef __STDC_WANT_IEC_60559_TYPES_EXT__
 #endif
@@ -772,21 +900,11 @@
 #ifndef _TANDEM_SOURCE
 # undef _TANDEM_SOURCE
 #endif
-/* Enable X/Open extensions if necessary.  HP-UX 11.11 defines
-   mbstate_t only if _XOPEN_SOURCE is defined to 500, regardless of
-   whether compiling with -Ae or -D_HPUX_SOURCE=1.  */
+/* Enable X/Open extensions.  Define to 500 only if necessary
+   to make mbstate_t available.  */
 #ifndef _XOPEN_SOURCE
 # undef _XOPEN_SOURCE
 #endif
-/* Enable X/Open compliant socket functions that do not require linking
-   with -lxnet on HP-UX 11.11.  */
-#ifndef _HPUX_ALT_XOPEN_SOCKET_API
-# undef _HPUX_ALT_XOPEN_SOCKET_API
-#endif
-/* Enable general extensions on Solaris.  */
-#ifndef __EXTENSIONS__
-# undef __EXTENSIONS__
-#endif
 
 
 /* Version number of package */
@@ -819,19 +937,47 @@
 /* Define to 1 if the X Window System is missing or not being used. */
 #undef X_DISPLAY_MISSING
 
-/* Define to 1 if on MINIX. */
-#undef _MINIX
+/* True if the compiler says it groks GNU C version MAJOR.MINOR.  */
+#if defined __GNUC__ && defined __GNUC_MINOR__
+# define _GL_GNUC_PREREQ(major, minor) \
+    ((major) < __GNUC__ + ((minor) <= __GNUC_MINOR__))
+#else
+# define _GL_GNUC_PREREQ(major, minor) 0
+#endif
+
 
-/* Define to 1 to make NetBSD features available. MINIX 3 needs this. */
-#undef _NETBSD_SOURCE
+/* Define to enable the declarations of ISO C 11 types and functions. */
+#undef _ISOC11_SOURCE
 
 /* The _Noreturn keyword of C11.  */
-#if ! (defined _Noreturn \
-       || (defined __STDC_VERSION__ && 201112 <= __STDC_VERSION__))
-# if (3 <= __GNUC__ || (__GNUC__ == 2 && 8 <= __GNUC_MINOR__) \
-      || 0x5110 <= __SUNPRO_C)
+#ifndef _Noreturn
+# if (defined __cplusplus \
+      && ((201103 <= __cplusplus && !(__GNUC__ == 4 && __GNUC_MINOR__ == 7)) \
+          || (defined _MSC_VER && 1900 <= _MSC_VER)) \
+      && 0)
+    /* noreturn is not practically usable, because with it the syntax
+         extern _Noreturn void func (...);
+       would not be valid; such a declaration would only be valid with 'extern'
+       and '_Noreturn' swapped, or without the 'extern' keyword.  However, some
+       AIX system header files and several gnulib header files use precisely
+       this syntax with 'extern'.  */
+#  define _Noreturn noreturn
+# elif (defined __clang__ && __clang_major__ < 16 \
+        && defined _GL_WORK_AROUND_LLVM_BUG_59792)
+   /* Compile with -D_GL_WORK_AROUND_LLVM_BUG_59792 to work around
+      that rare LLVM bug, though you may get many false-alarm warnings.  */
+#  define _Noreturn
+# elif ((!defined __cplusplus || defined __clang__) \
+        && (201112 <= (defined __STDC_VERSION__ ? __STDC_VERSION__ : 0) \
+            || (!defined __STRICT_ANSI__ \
+                && (_GL_GNUC_PREREQ (4, 7) \
+                    || (defined __apple_build_version__ \
+                        ? 6000000 <= __apple_build_version__ \
+                        : 3 < __clang_major__ + (5 <= __clang_minor__))))))
+   /* _Noreturn works as-is.  */
+# elif _GL_GNUC_PREREQ (2, 8) || defined __clang__ || 0x5110 <= __SUNPRO_C
 #  define _Noreturn __attribute__ ((__noreturn__))
-# elif defined _MSC_VER && 1200 <= _MSC_VER
+# elif 1200 <= (defined _MSC_VER ? _MSC_VER : 0)
 #  define _Noreturn __declspec (noreturn)
 # else
 #  define _Noreturn
@@ -839,10 +985,6 @@
 #endif
 
 
-/* Define to 2 if the system does not provide POSIX.1 features except with
-   this defined. */
-#undef _POSIX_1_SOURCE
-
 /* Define if -D_POSIX_SOURCE is necessary. */
 #undef _POSIX_SOURCE
 
@@ -858,110 +1000,489 @@
 /* Define to 1 if the system <stdint.h> predates C++11. */
 #undef __STDC_LIMIT_MACROS
 
-/* Please see the Gnulib manual for how to use these macros.
+/* The _GL_ASYNC_SAFE marker should be attached to functions that are
+   signal handlers (for signals other than SIGABRT, SIGPIPE) or can be
+   invoked from such signal handlers.  Such functions have some restrictions:
+     * All functions that it calls should be marked _GL_ASYNC_SAFE as well,
+       or should be listed as async-signal-safe in POSIX
+       <https://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_04>
+       section 2.4.3.  Note that malloc(), sprintf(), and fwrite(), in
+       particular, are NOT async-signal-safe.
+     * All memory locations (variables and struct fields) that these functions
+       access must be marked 'volatile'.  This holds for both read and write
+       accesses.  Otherwise the compiler might optimize away stores to and
+       reads from such locations that occur in the program, depending on its
+       data flow analysis.  For example, when the program contains a loop
+       that is intended to inspect a variable set from within a signal handler
+           while (!signal_occurred)
+             ;
+       the compiler is allowed to transform this into an endless loop if the
+       variable 'signal_occurred' is not declared 'volatile'.
+   Additionally, recall that:
+     * A signal handler should not modify errno (except if it is a handler
+       for a fatal signal and ends by raising the same signal again, thus
+       provoking the termination of the process).  If it invokes a function
+       that may clobber errno, it needs to save and restore the value of
+       errno.  */
+#define _GL_ASYNC_SAFE
+
+
+/* Attributes.  */
+#if (defined __has_attribute \
+     && (!defined __clang_minor__ \
+         || (defined __apple_build_version__ \
+             ? 6000000 <= __apple_build_version__ \
+             : 5 <= __clang_major__)))
+# define _GL_HAS_ATTRIBUTE(attr) __has_attribute (__##attr##__)
+#else
+# define _GL_HAS_ATTRIBUTE(attr) _GL_ATTR_##attr
+# define _GL_ATTR_alloc_size _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_always_inline _GL_GNUC_PREREQ (3, 2)
+# define _GL_ATTR_artificial _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_cold _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_const _GL_GNUC_PREREQ (2, 95)
+# define _GL_ATTR_deprecated _GL_GNUC_PREREQ (3, 1)
+# define _GL_ATTR_diagnose_if 0
+# define _GL_ATTR_error _GL_GNUC_PREREQ (4, 3)
+# define _GL_ATTR_externally_visible _GL_GNUC_PREREQ (4, 1)
+# define _GL_ATTR_fallthrough _GL_GNUC_PREREQ (7, 0)
+# define _GL_ATTR_format _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_leaf _GL_GNUC_PREREQ (4, 6)
+# define _GL_ATTR_malloc _GL_GNUC_PREREQ (3, 0)
+# ifdef _ICC
+#  define _GL_ATTR_may_alias 0
+# else
+#  define _GL_ATTR_may_alias _GL_GNUC_PREREQ (3, 3)
+# endif
+# define _GL_ATTR_noinline _GL_GNUC_PREREQ (3, 1)
+# define _GL_ATTR_nonnull _GL_GNUC_PREREQ (3, 3)
+# define _GL_ATTR_nonstring _GL_GNUC_PREREQ (8, 0)
+# define _GL_ATTR_nothrow _GL_GNUC_PREREQ (3, 3)
+# define _GL_ATTR_packed _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_pure _GL_GNUC_PREREQ (2, 96)
+# define _GL_ATTR_returns_nonnull _GL_GNUC_PREREQ (4, 9)
+# define _GL_ATTR_sentinel _GL_GNUC_PREREQ (4, 0)
+# define _GL_ATTR_unused _GL_GNUC_PREREQ (2, 7)
+# define _GL_ATTR_warn_unused_result _GL_GNUC_PREREQ (3, 4)
+#endif
 
-   Suppress extern inline with HP-UX cc, as it appears to be broken; see
-   <https://lists.gnu.org/r/bug-texinfo/2013-02/msg00030.html>.
+/* Disable GCC -Wpedantic if using __has_c_attribute and this is not C23+.  */
+#if (defined __has_c_attribute && _GL_GNUC_PREREQ (4, 6) \
+     && (defined __STDC_VERSION__ ? __STDC_VERSION__ : 0) <= 201710)
+# pragma GCC diagnostic ignored "-Wpedantic"
+#endif
 
-   Suppress extern inline with Sun C in standards-conformance mode, as it
-   mishandles inline functions that call each other.  E.g., for 'inline void f
-   (void) { } inline void g (void) { f (); }', c99 incorrectly complains
-   'reference to static identifier "f" in extern inline function'.
-   This bug was observed with Sun C 5.12 SunOS_i386 2011/11/16.
 
-   Suppress extern inline (with or without __attribute__ ((__gnu_inline__)))
-   on configurations that mistakenly use 'static inline' to implement
-   functions or macros in standard C headers like <ctype.h>.  For example,
-   if isdigit is mistakenly implemented via a static inline function,
-   a program containing an extern inline function that calls isdigit
-   may not work since the C standard prohibits extern inline functions
-   from calling static functions (ISO C 99 section 6.7.4.(3).
-   This bug is known to occur on:
+/* _GL_ATTRIBUTE_ALLOC_SIZE ((N)) declares that the Nth argument of the function
+   is the size of the returned memory block.
+   _GL_ATTRIBUTE_ALLOC_SIZE ((M, N)) declares that the Mth argument multiplied
+   by the Nth argument of the function is the size of the returned memory block.
+ */
+/* Applies to: function, pointer to function, function types.  */
+#ifndef _GL_ATTRIBUTE_ALLOC_SIZE
+# if _GL_HAS_ATTRIBUTE (alloc_size)
+#  define _GL_ATTRIBUTE_ALLOC_SIZE(args) __attribute__ ((__alloc_size__ args))
+# else
+#  define _GL_ATTRIBUTE_ALLOC_SIZE(args)
+# endif
+#endif
 
-     OS X 10.8 and earlier; see:
-     https://lists.gnu.org/r/bug-gnulib/2012-12/msg00023.html
+/* _GL_ATTRIBUTE_ALWAYS_INLINE tells that the compiler should always inline the
+   function and report an error if it cannot do so.  */
+/* Applies to: function.  */
+#ifndef _GL_ATTRIBUTE_ALWAYS_INLINE
+# if _GL_HAS_ATTRIBUTE (always_inline)
+#  define _GL_ATTRIBUTE_ALWAYS_INLINE __attribute__ ((__always_inline__))
+# else
+#  define _GL_ATTRIBUTE_ALWAYS_INLINE
+# endif
+#endif
 
-     DragonFly; see
-     http://muscles.dragonflybsd.org/bulk/bleeding-edge-potential/latest-per-pkg/ah-tty-0.3.12.log
+/* _GL_ATTRIBUTE_ARTIFICIAL declares that the function is not important to show
+    in stack traces when debugging.  The compiler should omit the function from
+    stack traces.  */
+/* Applies to: function.  */
+#ifndef _GL_ATTRIBUTE_ARTIFICIAL
+# if _GL_HAS_ATTRIBUTE (artificial)
+#  define _GL_ATTRIBUTE_ARTIFICIAL __attribute__ ((__artificial__))
+# else
+#  define _GL_ATTRIBUTE_ARTIFICIAL
+# endif
+#endif
 
-     FreeBSD; see:
-     https://lists.gnu.org/r/bug-gnulib/2014-07/msg00104.html
+/* _GL_ATTRIBUTE_COLD declares that the function is rarely executed.  */
+/* Applies to: functions.  */
+/* Avoid __attribute__ ((cold)) on MinGW; see thread starting at
+   <https://lists.gnu.org/r/emacs-devel/2019-04/msg01152.html>.
+   Also, Oracle Studio 12.6 requires 'cold' not '__cold__'.  */
+#ifndef _GL_ATTRIBUTE_COLD
+# if _GL_HAS_ATTRIBUTE (cold) && !defined __MINGW32__
+#  ifndef __SUNPRO_C
+#   define _GL_ATTRIBUTE_COLD __attribute__ ((__cold__))
+#  else
+#   define _GL_ATTRIBUTE_COLD __attribute__ ((cold))
+#  endif
+# else
+#  define _GL_ATTRIBUTE_COLD
+# endif
+#endif
 
-   OS X 10.9 has a macro __header_inline indicating the bug is fixed for C and
-   for clang but remains for g++; see <https://trac.macports.org/ticket/41033>.
-   Assume DragonFly and FreeBSD will be similar.
+/* _GL_ATTRIBUTE_CONST declares that it is OK for a compiler to omit duplicate
+   calls to the function with the same arguments.
+   This attribute is safe for a function that neither depends on nor affects
+   observable state, and always returns exactly once - e.g., does not loop
+   forever, and does not call longjmp.
+   (This attribute is stricter than _GL_ATTRIBUTE_PURE.)  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_CONST
+# if _GL_HAS_ATTRIBUTE (const)
+#  define _GL_ATTRIBUTE_CONST __attribute__ ((__const__))
+# else
+#  define _GL_ATTRIBUTE_CONST
+# endif
+#endif
 
-   GCC 4.3 and above with -std=c99 or -std=gnu99 implements ISO C99
-   inline semantics, unless -fgnu89-inline is used.  It defines a macro
-   __GNUC_STDC_INLINE__ to indicate this situation or a macro
-   __GNUC_GNU_INLINE__ to indicate the opposite situation.
-   GCC 4.2 with -std=c99 or -std=gnu99 implements the GNU C inline
-   semantics but warns, unless -fgnu89-inline is used:
-     warning: C99 inline functions are not supported; using GNU89
-     warning: to disable this warning use -fgnu89-inline or the gnu_inline function attribute
-   It defines a macro __GNUC_GNU_INLINE__ to indicate this situation.
+/* _GL_ATTRIBUTE_DEALLOC (F, I) declares that the function returns pointers
+   that can be freed by passing them as the Ith argument to the
+   function F.
+   _GL_ATTRIBUTE_DEALLOC_FREE declares that the function returns pointers that
+   can be freed via 'free'; it can be used only after declaring 'free'.  */
+/* Applies to: functions.  Cannot be used on inline functions.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC
+# if _GL_GNUC_PREREQ (11, 0)
+#  define _GL_ATTRIBUTE_DEALLOC(f, i) __attribute__ ((__malloc__ (f, i)))
+# else
+#  define _GL_ATTRIBUTE_DEALLOC(f, i)
+# endif
+#endif
+/* If gnulib's <string.h> or <wchar.h> has already defined this macro, continue
+   to use this earlier definition, since <stdlib.h> may not have been included
+   yet.  */
+#ifndef _GL_ATTRIBUTE_DEALLOC_FREE
+# if defined __cplusplus && defined __GNUC__ && !defined __clang__
+/* Work around GCC bug <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=108231> */
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC ((void (*) (void *)) free, 1)
+# else
+#  define _GL_ATTRIBUTE_DEALLOC_FREE \
+     _GL_ATTRIBUTE_DEALLOC (free, 1)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_DEPRECATED: Declares that an entity is deprecated.
+   The compiler may warn if the entity is used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: namespace, class, template specialization.  */
+#ifndef _GL_ATTRIBUTE_DEPRECATED
+# ifdef __has_c_attribute
+#  if __has_c_attribute (__deprecated__)
+#   define _GL_ATTRIBUTE_DEPRECATED __deprecated__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_DEPRECATED && _GL_HAS_ATTRIBUTE (deprecated)
+#  define _GL_ATTRIBUTE_DEPRECATED __attribute__ ((__deprecated__))
+# endif
+# ifndef _GL_ATTRIBUTE_DEPRECATED
+#  define _GL_ATTRIBUTE_DEPRECATED
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_ERROR(msg) requests an error if a function is called and
+   the function call is not optimized away.
+   _GL_ATTRIBUTE_WARNING(msg) requests a warning if a function is called and
+   the function call is not optimized away.  */
+/* Applies to: functions.  */
+#if !(defined _GL_ATTRIBUTE_ERROR && defined _GL_ATTRIBUTE_WARNING)
+# if _GL_HAS_ATTRIBUTE (error)
+#  define _GL_ATTRIBUTE_ERROR(msg) __attribute__ ((__error__ (msg)))
+#  define _GL_ATTRIBUTE_WARNING(msg) __attribute__ ((__warning__ (msg)))
+# elif _GL_HAS_ATTRIBUTE (diagnose_if)
+#  define _GL_ATTRIBUTE_ERROR(msg) __attribute__ ((__diagnose_if__ (1, msg, "error")))
+#  define _GL_ATTRIBUTE_WARNING(msg) __attribute__ ((__diagnose_if__ (1, msg, "warning")))
+# else
+#  define _GL_ATTRIBUTE_ERROR(msg)
+#  define _GL_ATTRIBUTE_WARNING(msg)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_EXTERNALLY_VISIBLE declares that the entity should remain
+   visible to debuggers etc., even with '-fwhole-program'.  */
+/* Applies to: functions, variables.  */
+#ifndef _GL_ATTRIBUTE_EXTERNALLY_VISIBLE
+# if _GL_HAS_ATTRIBUTE (externally_visible)
+#  define _GL_ATTRIBUTE_EXTERNALLY_VISIBLE __attribute__ ((externally_visible))
+# else
+#  define _GL_ATTRIBUTE_EXTERNALLY_VISIBLE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_FALLTHROUGH declares that it is not a programming mistake if
+   the control flow falls through to the immediately following 'case' or
+   'default' label.  The compiler should not warn in this case.  */
+/* Applies to: Empty statement (;), inside a 'switch' statement.  */
+/* Always expands to something.  */
+#ifndef _GL_ATTRIBUTE_FALLTHROUGH
+# ifdef __has_c_attribute
+#  if __has_c_attribute (__fallthrough__)
+#   define _GL_ATTRIBUTE_FALLTHROUGH __fallthrough__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_FALLTHROUGH && _GL_HAS_ATTRIBUTE (fallthrough)
+#  define _GL_ATTRIBUTE_FALLTHROUGH __attribute__ ((__fallthrough__))
+# endif
+# ifndef _GL_ATTRIBUTE_FALLTHROUGH
+#  define _GL_ATTRIBUTE_FALLTHROUGH ((void) 0)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_FORMAT ((ARCHETYPE, STRING-INDEX, FIRST-TO-CHECK))
+   declares that the STRING-INDEXth function argument is a format string of
+   style ARCHETYPE, which is one of:
+     printf, gnu_printf
+     scanf, gnu_scanf,
+     strftime, gnu_strftime,
+     strfmon,
+   or the same thing prefixed and suffixed with '__'.
+   If FIRST-TO-CHECK is not 0, arguments starting at FIRST-TO_CHECK
+   are suitable for the format string.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_FORMAT
+# if _GL_HAS_ATTRIBUTE (format)
+#  define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec))
+# else
+#  define _GL_ATTRIBUTE_FORMAT(spec)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_LEAF declares that if the function is called from some other
+   compilation unit, it executes code from that unit only by return or by
+   exception handling.  This declaration lets the compiler optimize that unit
+   more aggressively.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_LEAF
+# if _GL_HAS_ATTRIBUTE (leaf)
+#  define _GL_ATTRIBUTE_LEAF __attribute__ ((__leaf__))
+# else
+#  define _GL_ATTRIBUTE_LEAF
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MALLOC declares that the function returns a pointer to freshly
+   allocated memory.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_MALLOC
+# if _GL_HAS_ATTRIBUTE (malloc)
+#  define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
+# else
+#  define _GL_ATTRIBUTE_MALLOC
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MAY_ALIAS declares that pointers to the type may point to the
+   same storage as pointers to other types.  Thus this declaration disables
+   strict aliasing optimization.  */
+/* Applies to: types.  */
+/* Oracle Studio 12.6 mishandles may_alias despite __has_attribute OK.  */
+#ifndef _GL_ATTRIBUTE_MAY_ALIAS
+# if _GL_HAS_ATTRIBUTE (may_alias) && !defined __SUNPRO_C
+#  define _GL_ATTRIBUTE_MAY_ALIAS __attribute__ ((__may_alias__))
+# else
+#  define _GL_ATTRIBUTE_MAY_ALIAS
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_MAYBE_UNUSED declares that it is not a programming mistake if
+   the entity is not used.  The compiler should not warn if the entity is not
+   used.  */
+/* Applies to:
+     - function, variable,
+     - struct, union, struct/union member,
+     - enumeration, enumeration item,
+     - typedef,
+   in C++ also: class.  */
+/* In C++ and C23, this is spelled __maybe_unused__.
+   GCC's syntax is __attribute__ ((__unused__)).
+   clang supports both syntaxes.  Except that with clang ≥ 6, < 10, in C++ mode,
+   __has_c_attribute (__maybe_unused__) yields true but the use of
+   __maybe_unused__ nevertheless produces a warning.  */
+#ifndef _GL_ATTRIBUTE_MAYBE_UNUSED
+# if defined __clang__ && defined __cplusplus
+#  if __clang_major__ >= 10
+#   define _GL_ATTRIBUTE_MAYBE_UNUSED __maybe_unused__
+#  endif
+# elif defined __has_c_attribute
+#  if __has_c_attribute (__maybe_unused__)
+#   define _GL_ATTRIBUTE_MAYBE_UNUSED __maybe_unused__
+#  endif
+# endif
+# ifndef _GL_ATTRIBUTE_MAYBE_UNUSED
+#  define _GL_ATTRIBUTE_MAYBE_UNUSED _GL_ATTRIBUTE_UNUSED
+# endif
+#endif
+/* Alternative spelling of this macro, for convenience and for
+   compatibility with glibc/include/libc-symbols.h.  */
+#define _GL_UNUSED _GL_ATTRIBUTE_MAYBE_UNUSED
+/* Earlier spellings of this macro.  */
+#define _UNUSED_PARAMETER_ _GL_ATTRIBUTE_MAYBE_UNUSED
+
+/* _GL_ATTRIBUTE_NODISCARD declares that the caller of the function should not
+   discard the return value.  The compiler may warn if the caller does not use
+   the return value, unless the caller uses something like ignore_value.  */
+/* Applies to: function, enumeration, class.  */
+#ifndef _GL_ATTRIBUTE_NODISCARD
+# if defined __clang__ && defined __cplusplus
+  /* With clang up to 15.0.6 (at least), in C++ mode, __nodiscard__ produces
+     a warning.
+     The 1000 below means a yet unknown threshold.  When clang++ version X
+     starts supporting __nodiscard__ without warning about it, you can
+     replace the 1000 with X.  */
+#  if __clang_major__ >= 1000
+#   define _GL_ATTRIBUTE_NODISCARD __nodiscard__
+#  endif
+# elif defined __has_c_attribute
+#  if __has_c_attribute (__nodiscard__)
+#   define _GL_ATTRIBUTE_NODISCARD __nodiscard__
+#  endif
+# endif
+# if !defined _GL_ATTRIBUTE_NODISCARD && _GL_HAS_ATTRIBUTE (warn_unused_result)
+#  define _GL_ATTRIBUTE_NODISCARD __attribute__ ((__warn_unused_result__))
+# endif
+# ifndef _GL_ATTRIBUTE_NODISCARD
+#  define _GL_ATTRIBUTE_NODISCARD
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NOINLINE tells that the compiler should not inline the
+   function.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NOINLINE
+# if _GL_HAS_ATTRIBUTE (noinline)
+#  define _GL_ATTRIBUTE_NOINLINE __attribute__ ((__noinline__))
+# else
+#  define _GL_ATTRIBUTE_NOINLINE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NONNULL ((N1, N2,...)) declares that the arguments N1, N2,...
+   must not be NULL.
+   _GL_ATTRIBUTE_NONNULL () declares that all pointer arguments must not be
+   null.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NONNULL
+# if _GL_HAS_ATTRIBUTE (nonnull)
+#  define _GL_ATTRIBUTE_NONNULL(args) __attribute__ ((__nonnull__ args))
+# else
+#  define _GL_ATTRIBUTE_NONNULL(args)
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_NONSTRING declares that the contents of a character array is
+   not meant to be NUL-terminated.  */
+/* Applies to: struct/union members and variables that are arrays of element
+   type 'unsigned char'.  */
+#ifndef _GL_ATTRIBUTE_NONSTRING
+# if _GL_HAS_ATTRIBUTE (nonstring)
+#  define _GL_ATTRIBUTE_NONSTRING __attribute__ ((__nonstring__))
+# else
+#  define _GL_ATTRIBUTE_NONSTRING
+# endif
+#endif
+
+/* There is no _GL_ATTRIBUTE_NORETURN; use _Noreturn instead.  */
+
+/* _GL_ATTRIBUTE_NOTHROW declares that the function does not throw exceptions.
  */
-#if (((defined __APPLE__ && defined __MACH__) \
-      || defined __DragonFly__ || defined __FreeBSD__) \
-     && (defined __header_inline \
-         ? (defined __cplusplus && defined __GNUC_STDC_INLINE__ \
-            && ! defined __clang__) \
-         : ((! defined _DONT_USE_CTYPE_INLINE_ \
-             && (defined __GNUC__ || defined __cplusplus)) \
-            || (defined _FORTIFY_SOURCE && 0 < _FORTIFY_SOURCE \
-                && defined __GNUC__ && ! defined __cplusplus))))
-# define _GL_EXTERN_INLINE_STDHEADER_BUG
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_NOTHROW
+# if _GL_HAS_ATTRIBUTE (nothrow) && !defined __cplusplus
+#  define _GL_ATTRIBUTE_NOTHROW __attribute__ ((__nothrow__))
+# else
+#  define _GL_ATTRIBUTE_NOTHROW
+# endif
 #endif
-#if ((__GNUC__ \
-      ? defined __GNUC_STDC_INLINE__ && __GNUC_STDC_INLINE__ \
-      : (199901L <= __STDC_VERSION__ \
-         && !defined __HP_cc \
-         && !defined __PGI \
-         && !(defined __SUNPRO_C && __STDC__))) \
-     && !defined _GL_EXTERN_INLINE_STDHEADER_BUG)
-# define _GL_INLINE inline
-# define _GL_EXTERN_INLINE extern inline
-# define _GL_EXTERN_INLINE_IN_USE
-#elif (2 < __GNUC__ + (7 <= __GNUC_MINOR__) && !defined __STRICT_ANSI__ \
-       && !defined _GL_EXTERN_INLINE_STDHEADER_BUG)
-# if defined __GNUC_GNU_INLINE__ && __GNUC_GNU_INLINE__
-   /* __gnu_inline__ suppresses a GCC 4.2 diagnostic.  */
-#  define _GL_INLINE extern inline __attribute__ ((__gnu_inline__))
+
+/* _GL_ATTRIBUTE_PACKED declares:
+   For struct members: The member has the smallest possible alignment.
+   For struct, union, class: All members have the smallest possible alignment,
+   minimizing the memory required.  */
+/* Applies to: struct members, struct, union,
+   in C++ also: class.  */
+#ifndef _GL_ATTRIBUTE_PACKED
+# if _GL_HAS_ATTRIBUTE (packed)
+#  define _GL_ATTRIBUTE_PACKED __attribute__ ((__packed__))
 # else
-#  define _GL_INLINE extern inline
+#  define _GL_ATTRIBUTE_PACKED
 # endif
-# define _GL_EXTERN_INLINE extern
-# define _GL_EXTERN_INLINE_IN_USE
-#else
-# define _GL_INLINE static _GL_UNUSED
-# define _GL_EXTERN_INLINE static _GL_UNUSED
 #endif
 
-/* In GCC 4.6 (inclusive) to 5.1 (exclusive),
-   suppress bogus "no previous prototype for 'FOO'"
-   and "no previous declaration for 'FOO'" diagnostics,
-   when FOO is an inline function in the header; see
-   <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=54113> and
-   <https://gcc.gnu.org/bugzilla/show_bug.cgi?id=63877>.  */
-#if __GNUC__ == 4 && 6 <= __GNUC_MINOR__
-# if defined __GNUC_STDC_INLINE__ && __GNUC_STDC_INLINE__
-#  define _GL_INLINE_HEADER_CONST_PRAGMA
+/* _GL_ATTRIBUTE_PURE declares that It is OK for a compiler to omit duplicate
+   calls to the function with the same arguments if observable state is not
+   changed between calls.
+   This attribute is safe for a function that does not affect
+   observable state, and always returns exactly once.
+   (This attribute is looser than _GL_ATTRIBUTE_CONST.)  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_PURE
+# if _GL_HAS_ATTRIBUTE (pure)
+#  define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
 # else
-#  define _GL_INLINE_HEADER_CONST_PRAGMA \
-     _Pragma ("GCC diagnostic ignored \"-Wsuggest-attribute=const\"")
+#  define _GL_ATTRIBUTE_PURE
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_RETURNS_NONNULL declares that the function's return value is
+   a non-NULL pointer.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_RETURNS_NONNULL
+# if _GL_HAS_ATTRIBUTE (returns_nonnull)
+#  define _GL_ATTRIBUTE_RETURNS_NONNULL __attribute__ ((__returns_nonnull__))
+# else
+#  define _GL_ATTRIBUTE_RETURNS_NONNULL
+# endif
+#endif
+
+/* _GL_ATTRIBUTE_SENTINEL(pos) declares that the variadic function expects a
+   trailing NULL argument.
+   _GL_ATTRIBUTE_SENTINEL () - The last argument is NULL (requires C99).
+   _GL_ATTRIBUTE_SENTINEL ((N)) - The (N+1)st argument from the end is NULL.  */
+/* Applies to: functions.  */
+#ifndef _GL_ATTRIBUTE_SENTINEL
+# if _GL_HAS_ATTRIBUTE (sentinel)
+#  define _GL_ATTRIBUTE_SENTINEL(pos) __attribute__ ((__sentinel__ pos))
+# else
+#  define _GL_ATTRIBUTE_SENTINEL(pos)
 # endif
-# define _GL_INLINE_HEADER_BEGIN \
-    _Pragma ("GCC diagnostic push") \
-    _Pragma ("GCC diagnostic ignored \"-Wmissing-prototypes\"") \
-    _Pragma ("GCC diagnostic ignored \"-Wmissing-declarations\"") \
-    _GL_INLINE_HEADER_CONST_PRAGMA
-# define _GL_INLINE_HEADER_END \
-    _Pragma ("GCC diagnostic pop")
-#else
-# define _GL_INLINE_HEADER_BEGIN
-# define _GL_INLINE_HEADER_END
 #endif
 
+/* A helper macro.  Don't use it directly.  */
+#ifndef _GL_ATTRIBUTE_UNUSED
+# if _GL_HAS_ATTRIBUTE (unused)
+#  define _GL_ATTRIBUTE_UNUSED __attribute__ ((__unused__))
+# else
+#  define _GL_ATTRIBUTE_UNUSED
+# endif
+#endif
+
+
+/* _GL_UNUSED_LABEL; declares that it is not a programming mistake if the
+   immediately preceding label is not used.  The compiler should not warn
+   if the label is not used.  */
+/* Applies to: label (both in C and C++).  */
+/* Note that g++ < 4.5 does not support the '__attribute__ ((__unused__)) ;'
+   syntax.  But clang does.  */
+#ifndef _GL_UNUSED_LABEL
+# if !(defined __cplusplus && !_GL_GNUC_PREREQ (4, 5)) || defined __clang__
+#  define _GL_UNUSED_LABEL _GL_ATTRIBUTE_UNUSED
+# else
+#  define _GL_UNUSED_LABEL
+# endif
+#endif
+
+
 /* Define to `__inline__' or `__inline' if that's what the C compiler
    calls it, or to nothing if 'inline' is not supported under any name.  */
 #ifndef __cplusplus
@@ -981,10 +1502,26 @@
 # define __GNUC_STDC_INLINE__ 1
 #endif
 
+/* _GL_CMP (n1, n2) performs a three-valued comparison on n1 vs. n2, where
+   n1 and n2 are expressions without side effects, that evaluate to real
+   numbers (excluding NaN).
+   It returns
+     1  if n1 > n2
+     0  if n1 == n2
+     -1 if n1 < n2
+   The naïve code   (n1 > n2 ? 1 : n1 < n2 ? -1 : 0)  produces a conditional
+   jump with nearly all GCC versions up to GCC 10.
+   This variant     (n1 < n2 ? -1 : n1 > n2)  produces a conditional with many
+   GCC versions up to GCC 9.
+   The better code  (n1 > n2) - (n1 < n2)  from Hacker's Delight § 2-9
+   avoids conditional jumps in all GCC versions >= 3.4.  */
+#define _GL_CMP(n1, n2) (((n1) > (n2)) - ((n1) < (n2)))
+
+
 /* Define to `int' if <sys/types.h> does not define. */
 #undef mode_t
 
-/* Define to `int' if <sys/types.h> does not define. */
+/* Define as a signed integer type capable of holding a process identifier. */
 #undef pid_t
 
 /* Define as the type of the result of subtracting two pointers, if the system
@@ -993,14 +1530,15 @@
 
 /* Define to the equivalent of the C99 'restrict' keyword, or to
    nothing if this is not supported.  Do not define if restrict is
-   supported directly.  */
+   supported only directly.  */
 #undef restrict
-/* Work around a bug in Sun C++: it does not support _Restrict or
-   __restrict__, even though the corresponding Sun C compiler ends up with
-   "#define restrict _Restrict" or "#define restrict __restrict__" in the
-   previous line.  Perhaps some future version of Sun C++ will work with
-   restrict; if so, hopefully it defines __RESTRICT like Sun C does.  */
-#if defined __SUNPRO_CC && !defined __RESTRICT
+/* Work around a bug in older versions of Sun C++, which did not
+   #define __restrict__ or support _Restrict or __restrict__
+   even though the corresponding Sun C compiler ended up with
+   "#define restrict _Restrict" or "#define restrict __restrict__"
+   in the previous line.  This workaround can be removed once
+   we assume Oracle Developer Studio 12.5 (2016) or later.  */
+#if defined __SUNPRO_CC && !defined __RESTRICT && !defined __restrict__
 # define _Restrict
 # define __restrict__
 #endif
@@ -1015,46 +1553,32 @@
    does not exist. */
 #undef uintmax_t
 
-/* Define as a marker that can be attached to declarations that might not
-    be used.  This helps to reduce warnings, such as from
-    GCC -Wunused-parameter.  */
-#if __GNUC__ >= 3 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7)
-# define _GL_UNUSED __attribute__ ((__unused__))
-#else
-# define _GL_UNUSED
-#endif
-/* The name _UNUSED_PARAMETER_ is an earlier spelling, although the name
-   is a misnomer outside of parameter lists.  */
-#define _UNUSED_PARAMETER_ _GL_UNUSED
-
-/* gcc supports the "unused" attribute on possibly unused labels, and
-   g++ has since version 4.5.  Note to support C++ as well as C,
-   _GL_UNUSED_LABEL should be used with a trailing ;  */
-#if !defined __cplusplus || __GNUC__ > 4 \
-    || (__GNUC__ == 4 && __GNUC_MINOR__ >= 5)
-# define _GL_UNUSED_LABEL _GL_UNUSED
-#else
-# define _GL_UNUSED_LABEL
-#endif
-
-/* The __pure__ attribute was added in gcc 2.96.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96)
-# define _GL_ATTRIBUTE_PURE __attribute__ ((__pure__))
-#else
-# define _GL_ATTRIBUTE_PURE /* empty */
-#endif
-
-/* The __const__ attribute was added in gcc 2.95.  */
-#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
-# define _GL_ATTRIBUTE_CONST __attribute__ ((__const__))
-#else
-# define _GL_ATTRIBUTE_CONST /* empty */
-#endif
 
-/* The __malloc__ attribute was added in gcc 3.  */
-#if 3 <= __GNUC__
-# define _GL_ATTRIBUTE_MALLOC __attribute__ ((__malloc__))
-#else
-# define _GL_ATTRIBUTE_MALLOC /* empty */
+  /* This definition is a duplicate of the one in unitypes.h.
+     It is here so that we can cope with an older version of unitypes.h
+     that does not contain this definition and that is pre-installed among
+     the public header files.  */
+  # if defined __restrict \
+       || 2 < __GNUC__ + (95 <= __GNUC_MINOR__) \
+       || __clang_major__ >= 3
+  #  define _UC_RESTRICT __restrict
+  # elif 199901L <= __STDC_VERSION__ || defined restrict
+  #  define _UC_RESTRICT restrict
+  # else
+  #  define _UC_RESTRICT
+  # endif
+  
+
+#if (!defined HAVE_C_STATIC_ASSERT && !defined assert \
+     && (!defined __cplusplus \
+         || (__cpp_static_assert < 201411 \
+             && __GNUG__ < 6 && __clang_major__ < 6)))
+ #include <assert.h>
+ #undef/**/assert
+ /* Solaris 11.4 <assert.h> defines static_assert as a macro with 2 arguments.
+    We need it also to be invocable with a single argument.  */
+ #if defined __sun && (__STDC_VERSION__ - 0 >= 201112L) && !defined __cplusplus
+  #undef/**/static_assert
+  #define static_assert _Static_assert
+ #endif
 #endif
-

_service:tar_scm:groff-1.22.4.tar.gz/src/include/cset.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/cset.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/curtime.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/curtime.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/device.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/device.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/driver.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/driver.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/errarg.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/errarg.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/error.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/error.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,41 +16,54 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-extern void fatal_with_file_and_line(const char *filename, int lineno,
-				     const char *format,
-				     const errarg &arg1 = empty_errarg,
-				     const errarg &arg2 = empty_errarg,
-				     const errarg &arg3 = empty_errarg);
+void fatal_with_file_and_line(const char *, int, const char *,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg);
 
-extern void error_with_file_and_line(const char *filename, int lineno,
-				     const char *format,
-				     const errarg &arg1 = empty_errarg,
-				     const errarg &arg2 = empty_errarg,
-				     const errarg &arg3 = empty_errarg);
+void error_with_file_and_line(const char *, int, const char *,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg);
 
-extern void warning_with_file_and_line(const char *filename, int lineno,
-				     const char *format,
-				     const errarg &arg1 = empty_errarg,
-				     const errarg &arg2 = empty_errarg,
-				     const errarg &arg3 = empty_errarg);
+void warning_with_file_and_line(const char *, int, const char *,
+				const errarg & = empty_errarg,
+				const errarg & = empty_errarg,
+				const errarg & = empty_errarg);
 
-extern void fatal(const char *,
-		  const errarg &arg1 = empty_errarg,
-		  const errarg &arg2 = empty_errarg,
-		  const errarg &arg3 = empty_errarg);
+void debug_with_file_and_line(const char *, int, const char *,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg,
+			      const errarg & = empty_errarg);
 
-extern void error(const char *,
-		  const errarg &arg1 = empty_errarg,
-		  const errarg &arg2 = empty_errarg,
-		  const errarg &arg3 = empty_errarg);
+void fatal(const char *,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg);
 
-extern void warning(const char *,
-		    const errarg &arg1 = empty_errarg,
-		    const errarg &arg2 = empty_errarg,
-		    const errarg &arg3 = empty_errarg);
+void error(const char *,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg);
+
+void warning(const char *,
+	     const errarg & = empty_errarg,
+	     const errarg & = empty_errarg,
+	     const errarg & = empty_errarg);
+
+void debug(const char *,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg,
+	   const errarg & = empty_errarg);
 
 
 extern "C" const char *program_name;
 extern int current_lineno;
 extern const char *current_filename;
 extern const char *current_source_filename;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/font.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/font.h Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -24,8 +24,8 @@
 				     const char *,	// file
 				     int);		// lineno
 
-// A glyph is represented by a font-independent 'glyph *' pointer.
-// The functions name_to_glyph and number_to_glyph return such a pointer.
+// A glyph is represented by a font-independent 'glyph *' pointer.  The
+// functions name_to_glyph and number_to_glyph return such a pointer.
 //
 // There are two types of glyphs:
 //
@@ -38,9 +38,10 @@
 
 // The statically allocated information about a glyph.
 //
-// This is an abstract class; only its subclass 'charinfo' is instantiated.
-// 'charinfo' exists in two versions: one in roff/troff/input.cpp for troff,
-// and one in libs/libgroff/nametoindex.cpp for the preprocessors and the
+// This is an abstract class; only its subclass 'charinfo' is
+// instantiated.  'charinfo' exists in two versions: one in
+// roff/troff/input.cpp for troff, and one in
+// libs/libgroff/nametoindex.cpp for the preprocessors and the
 // postprocessors.
 struct glyph {
   int index;			// A font-independent integer value.
@@ -48,7 +49,7 @@
   friend class character_indexer;
 };
 
-#define UNDEFINED_GLYPH ((glyph *) NULL)
+#define UNDEFINED_GLYPH ((glyph *) 0)
 
 // The next three functions exist in two versions: one in
 // roff/troff/input.cpp for troff, and one in
@@ -64,9 +65,9 @@
 			// object.  This has the same semantics as the groff
 			// escape sequence \N'number'.  If such a 'glyph'
 			// object does not yet exist, a new one is allocated.
-extern const char *glyph_to_name(glyph *);	// Convert the given glyph
-			// back to its name.  Return NULL if the glyph
-			// doesn't have a name.
+extern const char *glyph_to_name(glyph *);	// Convert the given
+			// glyph back to its name.  Return null pointer
+			// if the glyph doesn't have a name.
 inline int glyph_to_number(glyph *);	// Convert the given glyph back to
 			// its number.  Return -1 if it does not designate
 			// a numbered character.
@@ -105,11 +106,11 @@
   };
 
   virtual ~font();	// Destructor.
-  int contains(glyph *);	// Return 1 if this font contains the given
-			// glyph, 0 otherwise.
-  int is_special();	// Return 1 if this font is special, 0 otherwise.
-			// See section 'Special Fonts' in the info file of
-			// groff.  Used by make_glyph_node().
+  bool contains(glyph *);	// This font contains the given glyph.
+  bool is_special();	// This font is searched for glyphs not defined
+			// in the current font.  See section 'Special
+			// Fonts' in the groff Texinfo manual.  Used by
+			// make_glyph_node().
   int get_width(glyph *, int);	// A rectangle represents the shape of the
 			// given glyph (arg1) at the given point size
 			// (arg2).  Return the horizontal dimension of this
@@ -119,14 +120,14 @@
 			// (arg2).  Return the distance between the base
 			// line and the top of this rectangle.
 			// This is often also called the 'ascent' of the
-			// glyph.  If the top is above the base line, this
+			// glyph.  If the top is above the baseline, this
 			// value is positive.
   int get_depth(glyph *, int);	// A rectangle represents the shape of the
 			// given glyph (arg1) at the given point size
 			// (arg2).  Return the distance between the base
 			// line and the bottom of this rectangle.
 			// This is often also called the 'descent' of the
-			// glyph.  If the bottom is below the base line,
+			// glyph.  If the bottom is below the baseline,
 			// this value is positive.
   int get_space_width(int);	// Return the normal width of a space at the
 			// given point size.
@@ -158,9 +159,8 @@
 			// natural and artificial slant.  It basically means
 			// how much an accent must be shifted horizontally
 			// to put it on the optical axis of the glyph.
-  int has_ligature(int);	// Return a non-zero value if this font has
-			// the given ligature type (one of LIG_ff, LIG_fi,
-			// etc.), 0 otherwise.
+  bool has_ligature(int);	// This font has the given ligature type
+			// (one of LIG_ff, LIG_fi, ...).
   int get_italic_correction(glyph *, int);	// If the given glyph (arg1)
 			// at the given point size (arg2) is followed by an
 			// unslanted glyph, some horizontal white space may
@@ -184,46 +184,46 @@
   int get_zoom();	// Return the font's zoom factor * 1000.
   int get_code(glyph *);	// Return the code point in the physical
 			// font of the given glyph.
-  const char *get_special_device_encoding(glyph *);	// Return special
-			// device dependent information about the given
-			// glyph.  Return NULL if there is no special
-			// information.
+  const char *get_special_device_encoding(glyph *);	// Return
+			// special device-dependent information about
+			// the given glyph.  Return null pointer if
+			// there is no special information.
   const char *get_name();	// Return the name of this font.
   const char *get_internal_name();	// Return the 'internalname'
-			// attribute of this font.  Return NULL if it has
-			// none.
+			// attribute of this font or null pointer if it
+			// has none.
   const char *get_image_generator();	// Return the 'image_generator'
-			// attribute of this font.  Return NULL if it has
-			// none.
-  static int scan_papersize(const char *, const char **,
-			    double *, double *);	// Parse the
-			// 'papersize' attribute in a DESC file (given in
-			// arg1).  Return the name of the size (in arg2),
-			// and the length and width (in arg3 and arg4).
-			// Return 1 in case of success, 0 otherwise.
-  static font *load_font(const char *, int * = 0, int = 0);	// Load the
-			// font description file with the given name (arg1)
-			// and return it as a 'font' class.  If arg2 points
-			// to an integer variable, set it to 1 if the file
-			// is not found, without emitting an error message.
-			// If arg2 is NULL, print an error message if the
-			// file is not found.  If arg3 is nonzero, only the
-			// part of the font description file before the
-			// 'charset' and 'kernpairs' sections is loaded.
-			// Return NULL in case of failure.
+			// attribute of this font or null pointer if it
+			// has none.
+  static bool scan_papersize(const char *, const char **,
+			     double *, double *); // Parse the
+			// 'papersize' directive in the DESC file name
+			// given in arg1.  Update arg2 with the name
+			// of the paper format and arg3 and arg4 with
+			// its length and width, respectively.  Return
+			// whether paper size was successfully set.
+  static font *load_font(const char *, bool = false); // Load the font
+			// description file with the given name (arg1)
+			// and return a pointer to a 'font' object.  If
+			// arg2 is true, only the part of the font
+			// description file before the 'charset' and
+			// 'kernpairs' sections is loaded.  Return null
+			// pointer in case of failure.
   static void command_line_font_dir(const char *);	// Prepend given
 			// path (arg1) to the list of directories in which
 			// to look up fonts.
-  static FILE *open_file(const char *, char **);	// Open a font file
-			// with the given name (arg1), searching along the
-			// current font path.  If arg2 points to a string
-			// pointer, set it to the found file name (this
-			// depends on the device also).  Return the opened
-			// file.  If not found, arg2 is unchanged, and NULL
-			// is returned.
-  static int load_desc();	// Open the DESC file (depending on the
-			// device) and initialize some static variables with
-			// info from there.
+  static FILE *open_file(const char *, char **);	// Open
+			// a font file with the given name (arg1),
+			// searching along the current font path.  If
+			// arg2 points to a string pointer, set it to
+			// the found file name (this depends on the
+			// device also).  Return the opened file.  If
+			// not found, arg2 is unchanged, and a null
+			// pointer is returned.
+
+  // Open the DESC file (depending on the device) and initialize some
+  // static variables with info from there.
+  static const char *load_desc();
   static FONT_COMMAND_HANDLER
     set_unknown_desc_command_handler(FONT_COMMAND_HANDLER);	// Register
 			// a function which defines the semantics of
@@ -244,24 +244,22 @@
 			// DESC file.
   static int spare2;
   static int sizescale;	// The 'sizescale' attribute given in the DESC file.
-  static int tcommand;  // Nonzero if the DESC file has the 'tcommand'
-			// attribute.
-  static int unscaled_charwidths;	// Nonzero if the DESC file has the
-			// 'unscaled_charwidths' attribute.
-  static int pass_filenames;	// Nonzero if the DESC file has the
-			// 'pass_filenames' attribute.
-  static int use_charnames_in_special;	// Nonzero if the DESC file has the
-			// 'use_charnames_in_special' attribute.
-  static int is_unicode; // Nonzero if the DESC file has the 'unicode'
-			// attribute.
+  static bool has_tcommand;	// DESC file has 'tcommand' directive.
+  static bool use_unscaled_charwidths;	// DESC file has
+			// 'unscaled_charwidths' directive.
+  static bool pass_filenames;	// DESC file has 'pass_filenames'
+			// directive.
+  static bool use_charnames_in_special;	// DESC file has
+			// 'use_charnames_in_special' directive.
+  static bool is_unicode; // DESC file has the 'unicode' directive.
   static const char *image_generator;	// The 'image_generator' attribute
 			// given in the DESC file.
-  static const char **font_name_table;	// The 'fonts' attribute given in
-			// the DESC file, as a NULL-terminated array of
-			// strings.
-  static const char **style_table;	// The 'styles' attribute given in
-			// the DESC file, as a NULL-terminated array of
-			// strings.
+  static const char **font_name_table;	// The 'fonts' attribute given
+			// in the DESC file, as a null
+			// pointer-terminated array of strings.
+  static const char **style_table;	// The 'styles' attribute given
+			// in the DESC file, as a null
+			// pointer-terminated array of strings.
   static const char *family;	// The 'family' attribute given in the DESC
 			// file.
   static int *sizes;	// The 'sizes' attribute given in the DESC file, as
@@ -275,11 +273,10 @@
 			// Used by get_kern().
   int space_width;	// The normal width of a space.  Used by
 			// get_space_width().
-  int special;		// 1 if this font is special, 0 otherwise.  Used by
-			// is_special().
+  bool special;		// See public is_special() above.
   char *name;		// The name of this font.  Used by get_name().
   char *internalname;	// The 'internalname' attribute of this font, or
-			// NULL.  Used by get_internal_name().
+			// a null pointer.  Used by get_internal_name().
   double slant;		// The natural slant angle (in degrees) of this font.
   int zoom;		// The font's magnification, multiplied by 1000.
 			// Used by scale().  A zero value means 'no zoom'.
@@ -318,12 +315,12 @@
 
   /* Returns w * pointsize / unitwidth, rounded to the nearest integer.  */
   int scale(int w, int pointsize);
-  static int unit_scale(double *, char); // Convert value in arg1 from the
-			// given unit (arg2; possible values are 'i', 'c',
-			// 'p', and 'P' as documented in the info file of
-			// groff, section 'Measurements') to inches.  Store
-			// the result in arg1 and return 1.  If the unit is
-			// invalid, return 0.
+  static bool unit_scale(double *, char); // Convert value in arg1 from
+			// the given unit (arg2; possible values are
+			// 'i', 'c', 'p', and 'P' as documented in the
+			// info file of groff, section 'Measurements')
+			// to inches.  Store result in arg1 and return
+			// whether conversion was successful.
   virtual void handle_unknown_font_command(const char *,	// command
 					   const char *,	// arg
 					   const char *,	// file
@@ -332,16 +329,15 @@
 protected:
   font(const char *);	// Initialize a font with the given name.
 
-  int load(int * = 0, int = 0);	// Load the font description file with the
-			// given name (in member variable NAME) into this
-			// object.  If arg1 points to an integer variable,
-			// set it to 1 if the file is not found, without
-			// emitting an error message.  If arg1 is NULL,
-			// print an error message if the file is not found.
-			// If arg2 is nonzero, only the part of the font
-			// description file before the 'charset' and
-			// 'kernpairs' sections is loaded.  Return NULL in
-			// case of failure.
+  // Load the font description file with the name in member variable
+  // `name` into this object.  If arg1 is true, only the part of the
+  // font description file before the 'charset' and 'kernpairs' sections
+  // is loaded.  Return success/failure status of load.
+  bool load(bool = false);
 };
 
-// end of font.h
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/geometry.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/geometry.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/getopt.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/getopt.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/getopt_int.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/getopt_int.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/gettext.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/gettext.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/html-strings.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/html-strings.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/htmlhint.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/htmlhint.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/include.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/include.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/index.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/index.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/itable.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/itable.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,14 +18,6 @@
 
 #include <assert.h>
 
-// name2(a,b) concatenates two C identifiers.
-#ifdef TRADITIONAL_CPP
-# define name2(a,b) a/**/b
-#else /* not TRADITIONAL_CPP */
-# define name2(a,b) name2x(a,b)
-# define name2x(a,b) a ## b
-#endif /* not TRADITIONAL_CPP */
-
 // 'class ITABLE(T)' is the type of a hash table mapping an integer (int >= 0)
 // to an object of type T.
 //
@@ -38,9 +29,9 @@
 //
 // Nowadays one would use templates for this; this code predates the addition
 // of templates to C++.
-#define ITABLE(T) name2(T,_itable)
-#define IASSOC(T) name2(T,_iassoc)
-#define ITABLE_ITERATOR(T) name2(T,_itable_iterator)
+#define ITABLE(T) T ## _itable
+#define IASSOC(T) T ## _iassoc
+#define ITABLE_ITERATOR(T) T ## _itable_iterator
 
 // ptable.h declares this too
 #ifndef NEXT_PTABLE_SIZE_DEFINED
@@ -118,8 +109,8 @@
 ITABLE(T)::~ITABLE(T)()							      \
 {									      \
   for (unsigned i = 0; i < size; i++)					      \
-    a_delete vi.val;							      \
-  a_delete v;								      \
+    delete vi.val;							      \
+  delete v;								      \
 }									      \
 									      \
 void ITABLE(T)::define(int key, T *val)					      \
@@ -131,7 +122,7 @@
        vn.key >= 0;							      \
        n = (n == 0 ? size - 1 : n - 1))					      \
     if (vn.key == key) {						      \
-      a_delete vn.val;						      \
+      delete vn.val;						      \
       vn.val = val;							      \
       return;								      \
     }									      \
@@ -158,7 +149,7 @@
 	 vn.key >= 0;							      \
 	 n = (n == 0 ? size - 1 : n - 1))				      \
       ;									      \
-    a_delete oldv;							      \
+    delete oldv;							      \
   }									      \
   vn.key = key;							      \
   vn.val = val;							      \
@@ -195,4 +186,8 @@
   return 0;								      \
 }
 
-// end of itable.h
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/lf.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/lf.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/lib.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/lib.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,9 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifndef GROFF_LIB_H
+#define GROFF_LIB_H
+
 #ifdef HAVE_CONFIG_H
 #include <config.h>
 #endif
@@ -25,14 +27,18 @@
 #define _ALL_SOURCE
 #endif
 
+#ifdef __cplusplus
 extern "C" {
+#endif
 #ifndef HAVE_STRERROR
   char *strerror(int);
 #endif
   const char *i_to_a(int);
   const char *ui_to_a(unsigned int);
   const char *if_to_a(int, int);
+#ifdef __cplusplus
 }
+#endif
 
 #define __GETOPT_PREFIX groff_
 #include <getopt.h>
@@ -47,8 +53,10 @@
 #define getlocale(category) ((void)(category), (char *)"C")
 #endif /* !HAVE_SETLOCALE */
 
+#include <stdbool.h>
+
 char *strsave(const char *s);
-int is_prime(unsigned);
+bool is_prime(unsigned);
 double groff_hypot(double, double);
 
 #include <stdio.h>
@@ -59,9 +67,13 @@
 
 #include <stdarg.h>
 
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 /* LynxOS 4.0.0 doesn't declare vfprintf() */
 #ifdef NEED_DECLARATION_VFPRINTF
-extern "C" { int vfprintf(FILE *, const char *, va_list); }
+  int vfprintf(FILE *, const char *, va_list);
 #endif
 
 #ifndef HAVE_MKSTEMP
@@ -72,93 +84,78 @@
 
 int mksdir(char *tmpl);
 
-FILE *xtmpfile(char **namep = 0,
-	       const char *postfix_long = 0, const char *postfix_short = 0,
-	       int do_unlink = 1);
-char *xtmptemplate(const char *postfix_long, const char *postfix_short);
+#ifdef __cplusplus
+  FILE *xtmpfile(char **namep = 0,
+		 const char *postfix_long = 0,
+		 const char *postfix_short = 0,
+		 int do_unlink = 1);
+  char *xtmptemplate(const char *postfix_long,
+		     const char *postfix_short);
+#endif
 
 #ifdef NEED_DECLARATION_POPEN
-extern "C" { FILE *popen(const char *, const char *); }
+  FILE *popen(const char *, const char *);
 #endif /* NEED_DECLARATION_POPEN */
 
 #ifdef NEED_DECLARATION_PCLOSE
-extern "C" { int pclose (FILE *); }
+  int pclose (FILE *);
 #endif /* NEED_DECLARATION_PCLOSE */
 
-size_t file_name_max(const char *fname);
-size_t path_name_max();
+  size_t file_name_max(const char *fname);
+  size_t path_name_max(void);
 
-extern char invalid_char_table;
+  extern char invalid_char_table;
 
-inline int invalid_input_char(int c)
-{
-  return c >= 0 && invalid_char_tablec;
-}
+  inline bool is_invalid_input_char(int c)
+  {
+    return (c >= 0 && invalid_char_tablec);
+  }
 
 #ifdef HAVE_STRCASECMP
 #ifdef NEED_DECLARATION_STRCASECMP
 // Ultrix4.3's string.h fails to declare this.
-extern "C" { int strcasecmp(const char *, const char *); }
+  int strcasecmp(const char *, const char *); }
 #endif /* NEED_DECLARATION_STRCASECMP */
 #else /* !HAVE_STRCASECMP */
-extern "C" { int strcasecmp(const char *, const char *); }
+  int strcasecmp(const char *, const char *);
 #endif /* HAVE_STRCASECMP */
 
 #if !defined(_AIX) && !defined(sinix) && !defined(__sinix__)
 #ifdef HAVE_STRNCASECMP
 #ifdef NEED_DECLARATION_STRNCASECMP
 // SunOS's string.h fails to declare this.
-extern "C" { int strncasecmp(const char *, const char *, int); }
+  int strncasecmp(const char *, const char *, int);
 #endif /* NEED_DECLARATION_STRNCASECMP */
 #else /* !HAVE_STRNCASECMP */
-extern "C" { int strncasecmp(const char *, const char *, size_t); }
+  int strncasecmp(const char *, const char *, size_t);
 #endif /* HAVE_STRNCASECMP */
 #endif /* !_AIX && !sinix && !__sinix__ */
 
+#ifdef __cplusplus
+}
+#endif
+
 #ifdef HAVE_CC_LIMITS_H
 #include <limits.h>
 #else /* !HAVE_CC_LIMITS_H */
 #define INT_MAX 2147483647
 #endif /* !HAVE_CC_LIMITS_H */
 
-/* It's not safe to rely on people getting INT_MIN right (ie signed). */
-
-#ifdef INT_MIN
-#undef INT_MIN
-#endif
-
-#ifdef CFRONT_ANSI_BUG
-
-/* This works around a bug in cfront 2.0 used with ANSI C compilers. */
-
-#define INT_MIN ((long)(-INT_MAX-1))
-
-#else /* !CFRONT_ANSI_BUG */
-
-#define INT_MIN (-INT_MAX-1)
-
-#endif /* !CFRONT_ANSI_BUG */
-
-/* Maximum number of digits in the decimal representation of an int
-   (not including the -). */
-
-#define INT_DIGITS 10
+/* Maximum number of digits in decimal representations of `int` types
+   not including a leading minus sign. */
+#define INT_DIGITS 19		/* enough for 64 bit integer */
+#define UINT_DIGITS 20
 
 #ifdef PI
 #undef PI
 #endif
 
-const double PI = 3.14159265358979323846;
+static const double PI = 3.14159265358979323846;
 
-/* ad_delete deletes an array of objects with destructors;
-   a_delete deletes an array of objects without destructors */
+#endif /* GROFF_LIB_H */
 
-#ifdef ARRAY_DELETE_NEEDS_SIZE
-/* for 2.0 systems */
-#define ad_delete(size) delete size
-#define a_delete delete
-#else /* !ARRAY_DELETE_NEEDS_SIZE */
-/* for ARM systems */
-#define ad_delete(size) delete 
-#define a_delete delete 
-#endif /* !ARRAY_DELETE_NEEDS_SIZE */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/localcharset.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/localcharset.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/macropath.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/macropath.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/nonposix.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/nonposix.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/paper.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/paper.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/posix.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/posix.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/printer.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/printer.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/ptable.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/ptable.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -20,14 +19,6 @@
 #include <assert.h>
 #include <string.h>
 
-// name2(a,b) concatenates two C identifiers.
-#ifdef TRADITIONAL_CPP
-# define name2(a,b) a/**/b
-#else /* not TRADITIONAL_CPP */
-# define name2(a,b) name2x(a,b)
-# define name2x(a,b) a ## b
-#endif /* not TRADITIONAL_CPP */
-
 // 'class PTABLE(T)' is the type of a hash table mapping a string
 // (const char *) to an object of type T.
 //
@@ -39,9 +30,9 @@
 //
 // Nowadays one would use templates for this; this code predates the addition
 // of templates to C++.
-#define PTABLE(T) name2(T,_ptable)
-#define PASSOC(T) name2(T,_passoc)
-#define PTABLE_ITERATOR(T) name2(T,_ptable_iterator)
+#define PTABLE(T) T ## _ptable
+#define PASSOC(T) T ## _passoc
+#define PTABLE_ITERATOR(T) T ## _ptable_iterator
 
 // itable.h declares this too
 #ifndef NEXT_PTABLE_SIZE_DEFINED
@@ -136,9 +127,9 @@
     free(vi.key);							      \
     /* XXX leak, because we don't know whether */			      \
     /* 'free', 'delete', or 'delete' should be used */		      \
-    /* a_delete vi.val; */						      \
+    /* delete vi.val; */						      \
   }									      \
-  a_delete v;								      \
+  delete v;								      \
 }									      \
 									      \
 const char *PTABLE(T)::define(const char *key, T *val)			      \
@@ -152,7 +143,7 @@
     if (strcmp(vn.key, key) == 0) {					      \
       /* XXX leak, because we don't know whether */			      \
       /* 'free', 'delete', or 'delete' should be used */		      \
-      /* a_delete vn.val; */						      \
+      /* delete vn.val; */						      \
       vn.val = val;							      \
       return vn.key;							      \
     }									      \
@@ -181,7 +172,7 @@
 	 vn.key != 0;							      \
 	 n = (n == 0 ? size - 1 : n - 1))				      \
       ;									      \
-    a_delete oldv;							      \
+    delete oldv;							      \
   }									      \
   char *temp = (char*)malloc(strlen(key)+1);				      \
   strcpy(temp, key);							      \
@@ -235,4 +226,8 @@
   return 0;								      \
 }
 
-// end of ptable.h
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/refid.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/refid.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/relocate.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/relocate.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/search.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/search.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/searchpath.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/searchpath.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/stringclass.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/stringclass.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/include/symbol.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/symbol.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2023 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,8 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#include <stdint.h> // uintptr_t
+
 #define DONT_STORE 1
 #define MUST_ALREADY_EXIST 2
 
@@ -30,7 +31,7 @@
 public:
   symbol(const char *p, int how = 0);
   symbol();
-  unsigned long hash() const;
+  uintptr_t hash() const;
   int operator ==(symbol) const;
   int operator !=(symbol) const;
   const char *contents() const;
@@ -56,9 +57,9 @@
   return s != p.s;
 }
 
-inline unsigned long symbol::hash() const
+inline uintptr_t symbol::hash() const
 {
-  return (unsigned long)s;
+  return reinterpret_cast<uintptr_t>(s);
 }
 
 inline const char *symbol::contents() const
@@ -79,3 +80,9 @@
 symbol concat(symbol, symbol);
 
 extern symbol default_symbol;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/include/unicode.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/include/unicode.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/common.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/common.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/index.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/index.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -46,7 +45,7 @@
 #endif
 int minus_one = -1;
 
-int verify_flag = 0;
+bool do_verify = false;
 
 struct word_list;
 
@@ -68,7 +67,7 @@
   const char *ignore_fields;
   time_t mtime;
 
-  const char *do_verify();
+  const char *get_invalidity_reason();
   const int *search1(const char **pp, const char *end);
   const int *search(const char *ptr, int length, int **temp_listp);
   const char *munge_filename(const char *);
@@ -77,9 +76,10 @@
 public:
   index_search_item(const char *, int);
   ~index_search_item();
-  int load(int fd);
+  const char *check_header(index_header *, unsigned);
+  bool load(int fd);
   search_item_iterator *make_search_item_iterator(const char *);
-  int verify();
+  bool is_valid();
   void check_files();
   int next_filename_id() const;
   friend class index_search_item_iterator;
@@ -124,12 +124,12 @@
     out_of_date_files = out_of_date_files->next;
     delete tem;
   }
-  a_delete filename_buffer;
-  a_delete key_buffer;
+  delete filename_buffer;
+  delete key_buffer;
   if (common_words_table) {
     for (int i = 0; i < common_words_table_size; i++)
-      a_delete common_words_tablei;
-    a_delete common_words_table;
+      delete common_words_tablei;
+    delete common_words_table;
   }
 }
 
@@ -139,28 +139,70 @@
   file_closer(int &fd) : fdp(&fd) { }
   ~file_closer() { close(*fdp); }
 };
- 
+
 // Tell the compiler that a variable is intentionally unused.
 inline void unused(void *) { }
 
-int index_search_item::load(int fd)
+// Validate the data reported in the header so that we don't overread on
+// the heap in the load() member function.  Return null pointer if no
+// problems are detected.
+const char *index_search_item::check_header(index_header *file_header,
+					    unsigned file_size)
+{
+  if (file_header->tags_size < 0)
+    return "tag list length negative";
+  if (file_header->lists_size < 0)
+    return "reference list length negative";
+  // The table and string pool sizes will not be zero, even in an empty
+  // index.
+  if (file_header->table_size < 1)
+    return "table size nonpositive";
+  if (file_header->strings_size < 1)
+    return "string pool size nonpositive";
+  size_t sz = (file_header->tags_size * sizeof(tag)
+	       + file_header->lists_size * sizeof(int)
+	       + file_header->table_size * sizeof(int)
+	       + file_header->strings_size
+	       + sizeof(file_header));
+  if (sz != file_size)
+    return("size mismatch between header and data");
+  unsigned size_remaining = file_size;
+  unsigned chunk_size = file_header->tags_size * sizeof(tag);
+  if (chunk_size > size_remaining)
+    return "claimed tag list length exceeds file size";
+  size_remaining -= chunk_size;
+  chunk_size = file_header->lists_size * sizeof(int);
+  if (chunk_size > size_remaining)
+    return "claimed reference list length exceeds file size";
+  size_remaining -= chunk_size;
+  chunk_size = file_header->table_size * sizeof(int);
+  if (chunk_size > size_remaining)
+    return "claimed table size exceeds file size";
+  size_remaining -= chunk_size;
+  chunk_size = file_header->strings_size;
+  if (chunk_size > size_remaining)
+    return "claimed string pool size exceeds file size";
+  return 0;
+}
+
+bool index_search_item::load(int fd)
 {
   file_closer fd_closer(fd);	// close fd on return
   unused(&fd_closer);
   struct stat sb;
   if (fstat(fd, &sb) < 0) {
-    error("can't fstat '%1': %2", name, strerror(errno));
-    return 0;
+    error("can't fstat index '%1': %2", name, strerror(errno));
+    return false;
   }
   if (!S_ISREG(sb.st_mode)) {
-    error("'%1' is not a regular file", name);
-    return 0;
+    error("index '%1' is not a regular file", name);
+    return false;
   }
   mtime = sb.st_mtime;
-  int size = int(sb.st_size);
+  unsigned size = unsigned(sb.st_size); // widening conversion
   if (size == 0) {
-    error("'%1' is an empty file", name);
-    return 0;
+    error("index '%1' is an empty file", name);
+    return false;
   }
   char *addr;
   map_addr = mapread(fd, size);
@@ -171,20 +213,20 @@
   else {
     addr = buffer = (char *)malloc(size);
     if (buffer == 0) {
-      error("can't allocate buffer for '%1'", name);
-      return 0;
+      error("can't allocate memory to process index '%1'", name);
+      return false;
     }
     char *ptr = buffer;
     int bytes_to_read = size;
     while (bytes_to_read > 0) {
       int nread = read(fd, ptr, bytes_to_read);
       if (nread == 0) {
-	error("unexpected EOF on '%1'", name);
-	return 0;
+	error("unexpected end-of-file while reading index '%1'", name);
+	return false;
       }
       if (nread < 0) {
-	error("read error on '%1': %2", name, strerror(errno));
-	return 0;
+	error("read error on index '%1': %2", name, strerror(errno));
+	return false;
       }
       bytes_to_read -= nread;
       ptr += nread;
@@ -193,22 +235,20 @@
   header = *(index_header *)addr;
   if (header.magic != INDEX_MAGIC) {
     error("'%1' is not an index file: wrong magic number", name);
-    return 0;
+    return false;
   }
   if (header.version != INDEX_VERSION) {
-    error("version number in '%1' is wrong: was %2, should be %3",
+    error("version number in index '%1' is wrong: was %2, should be %3",
 	  name, header.version, INDEX_VERSION);
-    return 0;
+    return false;
   }
-  int sz = (header.tags_size * sizeof(tag)
-	    + header.lists_size * sizeof(int)
-	    + header.table_size * sizeof(int)
-	    + header.strings_size
-	    + sizeof(header));
-  if (sz != size) {
-    error("size of '%1' is wrong: was %2, should be %3",
-	  name, size, sz);
-    return 0;
+  const char *problem = check_header(&header, size);
+  if (problem != 0) {
+    if (do_verify)
+      error("corrupt header in index file '%1': %2", name, problem);
+    else
+      error("corrupt header in index file '%1'", name);
+    return false;
   }
   tags = (tag *)(addr + sizeof(header));
   lists = (int *)(tags + header.tags_size);
@@ -217,14 +257,14 @@
   ignore_fields = strchr(strchr(pool, '\0') + 1, '\0') + 1;
   key_buffer = new charheader.truncate;
   read_common_words_file();
-  return 1;
+  return true;
 }
 
-const char *index_search_item::do_verify()
+const char *index_search_item::get_invalidity_reason()
 {
   if (tags == 0)
     return "not loaded";
-  if (listsheader.lists_size - 1 >= 0)
+  if ((header.lists_size > 0) && (listsheader.lists_size - 1 >= 0))
     return "last list element not negative";
   int i;
   for (i = 0; i < header.table_size; i++) {
@@ -249,17 +289,17 @@
       return "bad start in tags";
   }
   if (poolheader.strings_size - 1 != '\0')
-    return "last character in pool not nul";
+    return "last character in string pool is not null";
   return 0;
 }
 
-int index_search_item::verify()
+bool index_search_item::is_valid()
 {
-  const char *reason = do_verify();
+  const char *reason = get_invalidity_reason();
   if (!reason)
-    return 1;
+    return true;
   error("'%1' is bad: %2", name, reason);
-  return 0;
+  return false;
 }
 
 int index_search_item::next_filename_id() const
@@ -282,13 +322,13 @@
   if (fd < 0)
     return 0;
   index_search_item *item = new index_search_item(index_filename, fid);
-  a_delete index_filename;
+  delete index_filename;
   if (!item->load(fd)) {
     close(fd);
     delete item;
     return 0;
   }
-  else if (verify_flag && !item->verify()) {
+  else if (do_verify && !item->is_valid()) {
     delete item;
     return 0;
   }
@@ -316,9 +356,9 @@
 
 index_search_item_iterator::~index_search_item_iterator()
 {
-  a_delete temp_list;
-  a_delete buf;
-  a_delete query;
+  delete temp_list;
+  delete buf;
+  delete query;
   delete out_of_date_files_iter;
 }
 
@@ -405,7 +445,7 @@
     }
     if (!err) {
       if (length + 2 > buflen) {
-	a_delete buf;
+	delete buf;
 	buflen = length + 2;
 	buf = new charbuflen;
       }
@@ -448,7 +488,7 @@
 		    && strchr(DIR_SEPS, strchr(cwd, '\0')-1) == 0);
   int len = strlen(cwd) + strlen(filename) + need_slash + 1;
   if (len > filename_buflen) {
-    a_delete filename_buffer;
+    delete filename_buffer;
     filename_buflen = len;
     filename_buffer = new charlen;
   }
@@ -515,7 +555,7 @@
 {
   const char *end = ptr + length;
   if (*temp_listp) {
-    a_delete *temp_listp;
+    delete *temp_listp;
     *temp_listp = 0;
   }
   const int *first_list = 0;
@@ -546,12 +586,12 @@
     const int *list = search1(&ptr, end);
     if (list != 0) {
       if (*list < 0) {
-	a_delete matches;
+	delete matches;
 	return list;
       }
       merge(matches, matches, list);
       if (*matches < 0) {
-	a_delete matches;
+	delete matches;
 	return &minus_one;
       }
     }
@@ -573,7 +613,7 @@
   }
   common_words_table_size = 2*header.common + 1;
   while (!is_prime(common_words_table_size))
-    common_words_table_size++;
+    common_words_table_size += 2;
   common_words_table = new char *common_words_table_size;
   for (int i = 0; i < common_words_table_size; i++)
     common_words_tablei = 0;
@@ -618,7 +658,7 @@
     if ((*pp)->is_named(filename))
       return;
   *pp = make_linear_search_item(fd, filename, fid);
-  warning("'%1' modified since '%2' created", filename, name);
+  warning("'%1' modified since index '%2' created", filename, name);
 }
 
 void index_search_item::check_files()
@@ -640,3 +680,9 @@
     }
   }
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/libbib.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/libbib.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/linear.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/linear.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,8 +18,8 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
 #include <assert.h>
+#include <stdlib.h>
 #include <errno.h>
 
 #include "posix.h"
@@ -142,7 +141,7 @@
 
 bmpattern::~bmpattern()
 {
-  a_delete pat;
+  delete pat;
 }
 
 inline int bmpattern::length() const
@@ -286,7 +285,7 @@
 
 file_buffer::~file_buffer()
 {
-  a_delete buffer;
+  delete buffer;
 }
 
 const char *file_buffer::get_start() const
@@ -348,7 +347,7 @@
 	return 1;
       }
     }
-    a_delete buffer;
+    delete buffer;
     buffer = 0;
   }
   close(fd);
@@ -382,7 +381,7 @@
   }
   assert(nkeys <= nk);
   if (nkeys == 0) {
-    a_delete keys;
+    delete keys;
     keys = 0;
   }
 }
@@ -391,7 +390,7 @@
 {
   for (int i = 0; i < nkeys; i++)
     delete keysi;
-  a_delete keys;
+  delete keys;
 }
 
 int linear_searcher::search(const char *buffer, const char *bufend,
@@ -499,3 +498,9 @@
   else
     return 0;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/map.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/map.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libbib/search.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libbib/search.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libdriver/input.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libdriver/input.cpp Changed

@@ -1,8 +1,4 @@
-// -*- C++ -*-
-
-// <groff_src_dir>/src/libs/libdriver/input.cpp
-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
 
    Written by James Clark (jjc@jclark.com)
    Major rewrite 2001 by Bernd Warken <groff-bernd.warken-72@web.de>
@@ -135,7 +131,7 @@
      independence by scaling the intermediate output to the resolution
      of the postprocessor device if different from the one specified
      with 'x T', groff have not.  So implement full quasi device
-     indepedence, including the mapping of the strange classical
+     independence, including the mapping of the strange classical
      devices to the postprocessor device (seems to be reasonably
      easy).
    - The external, global pointer variables are not optimally handled.
@@ -509,7 +505,7 @@
 
 IntArray::~IntArray(void)
 {
-  a_delete data;
+  delete data;
 }
 
 void
@@ -521,7 +517,7 @@
     data = new IntArgnum_allocated;
     for (size_t i = 0; i < num_stored; i++)
       datai = old_datai;
-    a_delete old_data;
+    delete old_data;
   }
   datanum_stored = x;
   num_stored++;
@@ -536,7 +532,7 @@
 
 StringBuf::~StringBuf(void)
 {
-  a_delete data;
+  delete data;
 }
 
 void
@@ -548,7 +544,7 @@
     data = new Charnum_allocated;
     for (size_t i = 0; i < num_stored; i++)
       datai = old_datai;
-    a_delete old_data;
+    delete old_data;
   }
   datanum_stored = c;
   num_stored++;
@@ -801,7 +797,7 @@
     error("integer argument too large");
     number = 0;
   }
-  a_delete s;
+  delete s;
   return (IntArg) number;
 }
 
@@ -853,7 +849,7 @@
 	x = 0;
       }
       args->append((IntArg) x);
-      a_delete s;
+      delete s;
     }
     // Here, c is not a digit.
     // Terminate on comment, end of line, or end of file, while
@@ -1456,7 +1452,7 @@
       IntArg n = get_integer_arg();
       char *name = get_string_arg();
       pr->load_font(n, name);
-      a_delete name;
+      delete name;
       skip_line_x();
       break;
     }
@@ -1467,7 +1463,7 @@
 	warning("empty argument for 'x F' command");
       else {
 	remember_source_filename(str_arg);
-	a_delete str_arg;
+	delete str_arg;
       }
       break;
     }
@@ -1507,7 +1503,7 @@
     {
       char *str_arg = get_string_arg();
       pr->special(str_arg, current_env, 'u');
-      a_delete str_arg;
+      delete str_arg;
       skip_line_x();
       break;
     }
@@ -1521,14 +1517,14 @@
 	pr->devtag(str_arg, current_env);
       else
 	pr->special(str_arg, current_env);
-      a_delete str_arg;
+      delete str_arg;
       break;
     }
   default:			// ignore unknown x commands, but warn
     warning("unknown command 'x %1'", subcmd);
     skip_line();
   }
-  a_delete subcmd_str;
+  delete subcmd_str;
   return stopped;
 }
 
@@ -1597,17 +1593,17 @@
     str_arg = get_string_arg();
     if (str_arg0 != 'T')
       fatal("the first command must be 'x T'");
-    a_delete str_arg;
+    delete str_arg;
     char *tmp_dev = get_string_arg();
     if (pr == 0) {		// note: 'pr' initialized after prologue
       device = tmp_dev;
-      if (!font::load_desc())
-	fatal("couldn't load DESC file, can't continue");
+      if (0 /* nullptr */ == font::load_desc())
+	fatal("cannot load description of '%1' device", tmp_dev);
     }
     else {
       if (device == 0 || strcmp(device, tmp_dev) != 0)
 	fatal("all files must use the same device");
-      a_delete tmp_dev;
+      delete tmp_dev;
     }
     skip_line_x();		// ignore further arguments
     current_env->size = 10 * font::sizescale;
@@ -1619,7 +1615,7 @@
     str_arg = get_string_arg();
     if (str_arg0 != 'r')
       fatal("the second command must be 'x res'");
-    a_delete str_arg;
+    delete str_arg;
     int_arg = get_integer_arg();
     EnvInt font_res = font::res;
     if (int_arg != font_res)
@@ -1639,7 +1635,7 @@
     str_arg = get_string_arg();
     if (str_arg0 != 'i')
       fatal("the third command must be 'x init'");
-    a_delete str_arg;
+    delete str_arg;
     skip_line_x();
   }
 
@@ -1716,7 +1712,7 @@
 	  fatal_command(command);
 	char *str_arg = get_string_arg();
 	pr->set_special_char(str_arg, current_env);
-	a_delete str_arg;
+	delete str_arg;
 	break;
       }
     case 'D':			// drawing commands
@@ -1731,13 +1727,17 @@
       {
 	char *str_arg = get_extended_arg();
 	remember_source_filename(str_arg);
-	a_delete str_arg;
+	delete str_arg;
 	break;
       }
     case 'h':			// h: relative horizontal move
+      if (npages <= 0)
+	fatal_command(command);
       current_env->hpos += (EnvInt) get_integer_arg();
       break;
     case 'H':			// H: absolute horizontal positioning
+      if (npages <= 0)
+	fatal_command(command);
       current_env->hpos = (EnvInt) get_integer_arg();
       break;
     case 'm':			// m: glyph color
@@ -1781,7 +1781,7 @@
 	  pr->set_ascii_char((unsigned char) c, current_env, &w);
 	  current_env->hpos += w;
 	}
-	a_delete str_arg;
+	delete str_arg;
 	break;
       }
     case 'u':			// u: print spaced word
@@ -1797,13 +1797,17 @@
 	  pr->set_ascii_char((unsigned char) c, current_env, &w);
 	  current_env->hpos += w + kern;
 	}
-	a_delete str_arg;
+	delete str_arg;
 	break;
       }
     case 'v':			// v: relative vertical move
+      if (npages <= 0)
+	fatal_command(command);
       current_env->vpos += (EnvInt) get_integer_arg();
       break;
     case 'V':			// V: absolute vertical positioning
+      if (npages <= 0)
+	fatal_command(command);
       current_env->vpos = (EnvInt) get_integer_arg();
       break;
     case 'w':			// w: inform about paddable space
@@ -1829,3 +1833,9 @@
     warning("no final 'x stop' command");
   delete_current_env();
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libdriver/libdriver.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libdriver/libdriver.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libdriver/printer.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libdriver/printer.cpp Changed

@@ -1,8 +1,4 @@
-// -*- C++ -*-
-
-// <groff_src_dir>/src/libs/libdriver/printer.cpp
-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
    Written by James Clark (jjc@jclark.com)
 
    This file is part of groff.
@@ -21,14 +17,16 @@
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
+#include <assert.h>
+
 #include "driver.h"
 
 /* If we are sending output to an onscreen pager (as is the normal case
    when reading man pages), then we may get an error state on the output
    stream, if the user does not read all the way to the end.
 
-   We normally expect to catch this, and clean up the error context, when
-   the pager exits, because we should get, and handle, a SIGPIPE.
+   We normally expect to catch this, and clean up the error context,
+   when the pager exits, because we should get, and handle, a SIGPIPE.
 
    However ...
 */
@@ -36,10 +34,11 @@
 #if (defined(_MSC_VER) || defined(_WIN32)) \
     && !defined(__CYGWIN__) && !defined(_UWIN)
 
-  /* Native MS-Windows doesn't know about SIGPIPE, so we cannot detect the
-     early exit from the pager, and therefore, cannot clean up the error
-     context; thus we use the following static function to identify this
-     particular error context, and so suppress unwanted diagnostics.
+  /* Native MS-Windows doesn't know about SIGPIPE, so we cannot detect
+     the early exit from the pager, and therefore, cannot clean up the
+     error context; thus we use the following static function to
+     identify this particular error context, and so suppress unwanted
+     diagnostics.
   */
 
   static int
@@ -50,14 +49,14 @@
       clearerr (stream);
     /* Clear errno, in case clearerr() and fflush() don't */
     errno = 0;
-    /* Flush the output stream, so we can capture any error context, other
-       than the specific case we wish to suppress.
-       
-       Microsoft doesn't document it, but the error code for the specific
-       context we are trying to suppress seems to be EINVAL -- a strange
-       choice, since it is not normally associated with fflush(); of course,
-       it *should* be EPIPE, but this *definitely* is not used, and *is* so
-       documented.
+    /* Flush the output stream, so we can capture any error context,
+       other than the specific case we wish to suppress.
+
+       Microsoft doesn't document it, but the error code for the
+       specific context we are trying to suppress seems to be EINVAL --
+       a strange choice, since it is not normally associated with
+       fflush(); of course, it *should* be EPIPE, but this *definitely*
+       is not used, and *is* so documented.
     */
     return ((fflush(stream) < 0) && (errno != EINVAL));
   }
@@ -84,7 +83,7 @@
 
 printer::~printer()
 {
-  a_delete font_table;
+  delete font_table;
   while (font_list) {
     font_pointer_list *tem = font_list;
     font_list = font_list->next;
@@ -119,7 +118,7 @@
 	font_tablei = old_font_tablei;
       for (i = old_nfonts; i < nfonts; i++)
 	font_tablei = 0;
-      a_delete old_font_table;
+      delete old_font_table;
     }
   }
   font *f = find_font(nm);
@@ -132,8 +131,8 @@
     if (strcmp(p->p->get_name(), nm) == 0)
       return p->p;
   font *f = make_font(nm);
-  if (!f)
-    fatal("sorry, I can't continue");
+  if (0 /* nullptr */ == f)
+    fatal("cannot find font '%1'", nm);
   font_list = new font_pointer_list(f, font_list);
   return f;
 }
@@ -178,9 +177,11 @@
   buf1 = '\0';
 
   glyph *g = set_char_and_width(buf, env, &w, &f);
-  set_char(g, f, env, w, 0);
-  if (widthp) {
-    *widthp = w;
+
+  if (g != UNDEFINED_GLYPH) {
+    set_char(g, f, env, w, 0);
+    if (widthp)
+      *widthp = w;
   }
 }
 
@@ -197,29 +198,28 @@
   }
 }
 
-glyph *printer::set_char_and_width(const char *nm, const environment *env,
-				   int *widthp, font **f)
+glyph *printer::set_char_and_width(const char *nm,
+				   const environment *env, int *widthp,
+				   font **f)
 {
   glyph *g = name_to_glyph(nm);
   int fn = env->fontno;
   if (fn < 0 || fn >= nfonts) {
-    error("bad font position '%1'", fn);
+    error("invalid font position '%1'", fn);
     return UNDEFINED_GLYPH;
   }
   *f = font_tablefn;
   if (*f == 0) {
-    error("no font mounted at '%1'", fn);
+    error("no font mounted at position %1", fn);
     return UNDEFINED_GLYPH;
   }
   if (!(*f)->contains(g)) {
     if (nm0 != '\0' && nm1 == '\0')
-      error("font '%1' does not contain ascii character '%2'",
-	    (*f)->get_name(),
-	    nm0);
+      error("font '%1' does not contain ordinary character '%2'",
+	    (*f)->get_name(), nm0);
     else
       error("font '%1' does not contain special character '%2'",
-	    (*f)->get_name(),
-	    nm);
+	    (*f)->get_name(), nm);
     return UNDEFINED_GLYPH;
   }
   int w = (*f)->get_width(g, env->size);
@@ -228,23 +228,23 @@
   return g;
 }
 
-void printer::set_numbered_char(int num, const environment *env, int *widthp)
+void printer::set_numbered_char(int num, const environment *env, int
+				*widthp)
 {
   glyph *g = number_to_glyph(num);
   int fn = env->fontno;
   if (fn < 0 || fn >= nfonts) {
-    error("bad font position '%1'", fn);
+    error("invalid font position '%1'", fn);
     return;
   }
   font *f = font_tablefn;
   if (f == 0) {
-    error("no font mounted at '%1'", fn);
+    error("no font mounted at position %1", fn);
     return;
   }
   if (!f->contains(g)) {
     error("font '%1' does not contain numbered character %2",
-	  f->get_name(),
-	  num);
+	  f->get_name(), num);
     return;
   }
   int w = f->get_width(g, env->size);
@@ -256,7 +256,13 @@
 font *printer::get_font_from_index(int fontno)
 {
   if ((fontno >= 0) && (fontno < nfonts))
-    return(font_tablefontno);
+    return font_tablefontno;
   else
-    return(0);
+    return 0;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/assert.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/assert.cpp Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -16,18 +16,23 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <assert.h>
 #include <stdio.h>
 #include <stdlib.h>
-#include "assert.h"
 
 extern "C" const char *program_name;
 
-void assertion_failed(int lineno, const char *filename)
+void assertion_failed(int lineno, const char *filename,
+                      const char *function, const char *msg)
 {
   if (program_name != 0)
     fprintf(stderr, "%s: ", program_name);
-  fprintf(stderr, "Failed assertion at line %d, file '%s'.\n",
-	  lineno, filename);
+  fprintf(stderr, "%s:%d: %s(): assertion failed: '%s'\n", filename,
+	  lineno, function, msg);
   fflush(stderr);
   abort();
 }

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/change_lf.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/change_lf.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/cmap.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/cmap.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/color.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/color.cpp Changed

@@ -1,9 +1,5 @@
-// -*- C++ -*-
-
-/* <groff_src_dir>/src/libs/libgroff/color.cpp
-
-Copyright (C) 2001-2018 Free Software Foundation, Inc.
-    Written by Gaius Mulley <gaius@glam.ac.uk>
+/* Copyright (C) 2001-2020 Free Software Foundation, Inc.
+     Written by Gaius Mulley <gaius@glam.ac.uk>
 
 This file is part of groff.
 
@@ -23,14 +19,15 @@
 #include "lib.h"
 #include "color.h"
 #include "cset.h"
-#ifdef HAVE_UNISTD_H
-#include <unistd.h>
-#endif
 
 #include <assert.h>
-#include <stdio.h>
 #include <fcntl.h>
+#include <stdio.h>
 #include <stdlib.h>
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+
 #include "errarg.h"
 #include "error.h"
 
@@ -373,29 +370,35 @@
     break;
   case RGB:
     sprintf(s, "rgb %.2ff %.2ff %.2ff",
-	    double(Red) / MAX_COLOR_VAL,
-	    double(Green) / MAX_COLOR_VAL,
-	    double(Blue) / MAX_COLOR_VAL);
+	    double(Red) / double(MAX_COLOR_VAL),
+	    double(Green) / double(MAX_COLOR_VAL),
+	    double(Blue) / double(MAX_COLOR_VAL));
     break;
   case CMY:
     sprintf(s, "cmy %.2ff %.2ff %.2ff",
-	    double(Cyan) / MAX_COLOR_VAL,
-	    double(Magenta) / MAX_COLOR_VAL,
-	    double(Yellow) / MAX_COLOR_VAL);
+	    double(Cyan) / double(MAX_COLOR_VAL),
+	    double(Magenta) / double(MAX_COLOR_VAL),
+	    double(Yellow) / double(MAX_COLOR_VAL));
     break;
   case CMYK:
     sprintf(s, "cmyk %.2ff %.2ff %.2ff %.2ff",
-	    double(Cyan) / MAX_COLOR_VAL,
-	    double(Magenta) / MAX_COLOR_VAL,
-	    double(Yellow) / MAX_COLOR_VAL,
-	    double(Black) / MAX_COLOR_VAL);
+	    double(Cyan) / double(MAX_COLOR_VAL),
+	    double(Magenta) / double(MAX_COLOR_VAL),
+	    double(Yellow) / double(MAX_COLOR_VAL),
+	    double(Black) / double(MAX_COLOR_VAL));
     break;
   case GRAY:
     sprintf(s, "gray %.2ff",
-	    double(Gray) / MAX_COLOR_VAL);
+	    double(Gray) / double(MAX_COLOR_VAL));
     break;
   }
   return s;
 }
 
 color default_color;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/config.charset -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/config.charset Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/cset.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/cset.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/curtime.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/curtime.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/device.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/device.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/errarg.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/errarg.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,8 +16,13 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <assert.h>
 #include <stdio.h>
-#include "assert.h"
+
 #include "errarg.h"
 
 errarg::errarg(const char *p) : type(STRING)
@@ -64,7 +68,7 @@
   const char *i_to_a(int);
   const char *ui_to_a(unsigned int);
 }
-	    
+
 void errarg::print() const
 {
   switch (type) {
@@ -90,7 +94,7 @@
 
 errarg empty_errarg;
 
-void errprint(const char *format, 
+void errprint(const char *format,
 	      const errarg &arg1,
 	      const errarg &arg2,
 	      const errarg &arg3)
@@ -117,10 +121,16 @@
 	arg3.print();
 	break;
       default:
-	assert(0);
+	assert(0 == "unsupported argument conversion (not in %123)");
       }
     }
     else
       putc(c, stderr);
   }
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/error.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/error.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,10 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -25,69 +28,83 @@
 
 extern void fatal_error_exit();
 
-enum error_type { WARNING, ERROR, FATAL };
+enum error_type { DEBUG, WARNING, ERROR, FATAL };
 
 static void do_error_with_file_and_line(const char *filename,
 					const char *source_filename,
 					int lineno,
-					error_type type, 
-					const char *format, 
+					error_type type,
+					const char *format,
 					const errarg &arg1,
 					const errarg &arg2,
 					const errarg &arg3)
 {
-  int need_space = 0;
-  if (program_name) {
-    fprintf(stderr, "%s:", program_name);
-    need_space = 1;
+  bool need_space = false;
+  if (program_name != 0 /* nullptr */) {
+    fputs(program_name, stderr);
+    fputc(':', stderr);
+    need_space = true;
   }
-  if (lineno >= 0 && filename != 0) {
+  if (filename != 0 /* nullptr */) {
     if (strcmp(filename, "-") == 0)
       filename = "<standard input>";
-    if (source_filename != 0)
-      fprintf(stderr, "%s (%s):%d:", filename, source_filename, lineno);
-    else
-      fprintf(stderr, "%s:%d:", filename, lineno);
-    need_space = 1;
+    fputs(filename, stderr);
+    if (source_filename != 0 /* nullptr */) {
+      fputs(":(", stderr);
+      fputs(source_filename, stderr);
+      fputc(')', stderr);
+    }
+    if (lineno > 0) {
+      fputc(':', stderr);
+      errprint("%1", lineno);
+    }
+    fputc(':', stderr);
+    need_space = true;
   }
-  if (need_space) {
+  if (need_space)
     fputc(' ', stderr);
-    need_space = 0;
-  }
   switch (type) {
   case FATAL:
-    fputs("fatal error:", stderr);
-    need_space = 1;
+    fputs("fatal error", stderr);
     break;
   case ERROR:
+    fputs("error", stderr);
     break;
   case WARNING:
-    fputs("warning:", stderr);
-    need_space = 1;
+    fputs("warning", stderr);
+    break;
+  case DEBUG:
+    fputs("debug", stderr);
     break;
   }
-  if (need_space)
-    fputc(' ', stderr);
+  fputs(": ", stderr);
   errprint(format, arg1, arg2, arg3);
   fputc('\n', stderr);
   fflush(stderr);
   if (type == FATAL)
     fatal_error_exit();
 }
-      
 
-static void do_error(error_type type, 
-		     const char *format, 
+static void do_error(error_type type,
+		     const char *format,
 		     const errarg &arg1,
 		     const errarg &arg2,
 		     const errarg &arg3)
 {
   do_error_with_file_and_line(current_filename, current_source_filename,
-			      current_lineno, type, format, arg1, arg2, arg3);
+			      current_lineno, type, format, arg1, arg2,
+			      arg3);
 }
 
+void debug(const char *format,
+	   const errarg &arg1,
+	   const errarg &arg2,
+	   const errarg &arg3)
+{
+  do_error(DEBUG, format, arg1, arg2, arg3);
+}
 
-void error(const char *format, 
+void error(const char *format,
 	   const errarg &arg1,
 	   const errarg &arg2,
 	   const errarg &arg3)
@@ -95,7 +112,7 @@
   do_error(ERROR, format, arg1, arg2, arg3);
 }
 
-void warning(const char *format, 
+void warning(const char *format,
 	     const errarg &arg1,
 	     const errarg &arg2,
 	     const errarg &arg3)
@@ -103,7 +120,7 @@
   do_error(WARNING, format, arg1, arg2, arg3);
 }
 
-void fatal(const char *format, 
+void fatal(const char *format,
 	   const errarg &arg1,
 	   const errarg &arg2,
 	   const errarg &arg3)
@@ -111,35 +128,58 @@
   do_error(FATAL, format, arg1, arg2, arg3);
 }
 
+// Use the functions below when it's more costly to save and restore the
+// globals current_filename, current_source_filename, and current_lineno
+// than to specify additional arguments.  For instance, a function that
+// would need to temporarily change their values and has multiple return
+// paths might prefer these to the simpler variants above.
+
+void debug_with_file_and_line(const char *filename,
+			      int lineno,
+			      const char *format,
+			      const errarg &arg1,
+			      const errarg &arg2,
+			      const errarg &arg3)
+{
+  do_error_with_file_and_line(filename, 0 /* nullptr */, lineno,
+			      DEBUG, format, arg1, arg2, arg3);
+}
+
 void error_with_file_and_line(const char *filename,
 			      int lineno,
-			      const char *format, 
+			      const char *format,
 			      const errarg &arg1,
 			      const errarg &arg2,
 			      const errarg &arg3)
 {
-  do_error_with_file_and_line(filename, 0, lineno, 
+  do_error_with_file_and_line(filename, 0 /* nullptr */, lineno,
 			      ERROR, format, arg1, arg2, arg3);
 }
 
 void warning_with_file_and_line(const char *filename,
 				int lineno,
-				const char *format, 
+				const char *format,
 				const errarg &arg1,
 				const errarg &arg2,
 				const errarg &arg3)
 {
-  do_error_with_file_and_line(filename, 0, lineno, 
+  do_error_with_file_and_line(filename, 0 /* nullptr */, lineno,
 			      WARNING, format, arg1, arg2, arg3);
 }
 
 void fatal_with_file_and_line(const char *filename,
 			      int lineno,
-			      const char *format, 
+			      const char *format,
 			      const errarg &arg1,
 			      const errarg &arg2,
 			      const errarg &arg3)
 {
-  do_error_with_file_and_line(filename, 0, lineno, 
+  do_error_with_file_and_line(filename, 0 /* nullptr */, lineno,
 			      FATAL, format, arg1, arg2, arg3);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/fatal.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/fatal.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/filename.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/filename.cpp Changed

@@ -1,10 +1,10 @@
-/* Copyright (C) 2014-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2014-2022 Free Software Foundation, Inc.
 
 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 the Free
-Software Foundation, either version 2 of the License, or
+Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 
 groff is distributed in the hope that it will be useful, but WITHOUT ANY
@@ -12,8 +12,20 @@
 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 for more details.
 
-The GNU General Public License version 2 (GPL2) is available in the
-internet at <http://www.gnu.org/licenses/gpl-2.0.txt>. */
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-const char *current_filename = 0;
-const char *current_source_filename = 0;
+// This global stores the name of the input file being processed by
+// troff, an output driver, or other program.
+const char *current_filename = 0 /* nullptr */;
+
+// This global stores the name of the troff input file corresponding to
+// the part of a device-independent troff output being processed; it is
+// used only by output drivers.
+const char *current_source_filename = 0 /* nullptr */;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/fmod.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/fmod.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/font.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/font.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2021 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,11 +18,12 @@
 
 #include "lib.h"
 
-#include <ctype.h>
 #include <assert.h>
+#include <ctype.h>
 #include <math.h>
 #include <stdlib.h>
 #include <wchar.h>
+
 #include "errarg.h"
 #include "error.h"
 #include "cset.h"
@@ -69,75 +69,77 @@
   FILE *fp;
   char *path;
   int lineno;
-  int size;
-  int skip_comments;
-  int silent;
+  int linebufsize;
+  bool recognize_comments;
+  bool silent;
   char *buf;
   text_file(FILE *fp, char *p);
   ~text_file();
-  int next();
-  void error(const char *format, 
+  bool next_line();
+  void error(const char *format,
+	     const errarg &arg1 = empty_errarg,
+	     const errarg &arg2 = empty_errarg,
+	     const errarg &arg3 = empty_errarg);
+  void fatal(const char *format,
 	     const errarg &arg1 = empty_errarg,
 	     const errarg &arg2 = empty_errarg,
 	     const errarg &arg3 = empty_errarg);
 };
 
-text_file::text_file(FILE *p, char *s) 
-: fp(p), path(s), lineno(0), size(0), skip_comments(1), silent(0), buf(0)
+text_file::text_file(FILE *p, char *s) : fp(p), path(s), lineno(0),
+  linebufsize(128), recognize_comments(true), silent(false), buf(0)
 {
 }
 
 text_file::~text_file()
 {
-  a_delete buf;
+  delete buf;
   free(path);
   if (fp)
     fclose(fp);
 }
 
-int text_file::next()
+bool text_file::next_line()
 {
   if (fp == 0)
-    return 0;
-  if (buf == 0) {
-    buf = new char128;
-    size = 128;
-  }
+    return false;
+  if (buf == 0)
+    buf = new charlinebufsize;
   for (;;) {
-    int i = 0;
+    lineno++;
+    int length = 0;
     for (;;) {
       int c = getc(fp);
       if (c == EOF)
 	break;
-      if (invalid_input_char(c))
-	error("invalid input character code '%1'", int(c));
+      if (is_invalid_input_char(c))
+	error("invalid input character code %1", int(c));
       else {
-	if (i + 1 >= size) {
+	if (length + 1 >= linebufsize) {
 	  char *old_buf = buf;
-	  buf = new charsize*2;
-	  memcpy(buf, old_buf, size);
-	  a_delete old_buf;
-	  size *= 2;
+	  buf = new charlinebufsize * 2;
+	  memcpy(buf, old_buf, linebufsize);
+	  delete old_buf;
+	  linebufsize *= 2;
 	}
-	bufi++ = c;
+	buflength++ = c;
 	if (c == '\n')
 	  break;
       }
     }
-    if (i == 0)
+    if (length == 0)
       break;
-    bufi = '\0';
-    lineno++;
+    buflength = '\0';
     char *ptr = buf;
     while (csspace(*ptr))
       ptr++;
-    if (*ptr != 0 && (!skip_comments || *ptr != '#'))
-      return 1;
+    if (*ptr != 0 && (!recognize_comments || *ptr != '#'))
+      return true;
   }
-  return 0;
+  return false;
 }
 
-void text_file::error(const char *format, 
+void text_file::error(const char *format,
 		      const errarg &arg1,
 		      const errarg &arg2,
 		      const errarg &arg3)
@@ -146,10 +148,19 @@
     error_with_file_and_line(path, lineno, format, arg1, arg2, arg3);
 }
 
+void text_file::fatal(const char *format,
+		      const errarg &arg1,
+		      const errarg &arg2,
+		      const errarg &arg3)
+{
+  if (!silent)
+    fatal_with_file_and_line(path, lineno, format, arg1, arg2, arg3);
+}
+
 int glyph_to_unicode(glyph *g)
 {
   const char *nm = glyph_to_name(g);
-  if (nm != NULL) {
+  if (nm != 0) {
     // ASCII character?
     if (nm0 == 'c' && nm1 == 'h' && nm2 == 'a' && nm3 == 'r'
 	&& (nm4 >= '0' && nm4 <= '9')) {
@@ -180,7 +191,7 @@
     }
     // groff glyphs that map to Unicode?
     const char *unicode = glyph_name_to_unicode(nm);
-    if (unicode != NULL && strchr(unicode, '_') == NULL) {
+    if (unicode != 0 && strchr(unicode, '_') == 0) {
       char *ignore;
       return (int)strtol(unicode, &ignore, 16);
     }
@@ -190,25 +201,22 @@
 
 /* font functions */
 
-font::font(const char *s)
-: ligatures(0), kern_hash_table(0), space_width(0), special(0),
-  ch_index(0), nindices(0), ch(0), ch_used(0), ch_size(0), widths_cache(0)
+font::font(const char *s) : ligatures(0), kern_hash_table(0),
+  space_width(0), special(false), internalname(0), slant(0.0), zoom(0),
+  ch_index(0), nindices(0), ch(0), ch_used(0), ch_size(0),
+  widths_cache(0)
 {
   name = new charstrlen(s) + 1;
   strcpy(name, s);
-  internalname = 0;
-  slant = 0.0;
-  zoom = 0;
-  // load();			// for testing
 }
 
 font::~font()
 {
   for (int i = 0; i < ch_used; i++)
     if (chi.special_device_coding)
-      a_delete chi.special_device_coding;
-  a_delete ch;
-  a_delete ch_index;
+      delete chi.special_device_coding;
+  delete ch;
+  delete ch_index;
   if (kern_hash_table) {
     for (int i = 0; i < KERN_HASH_TABLE_SIZE; i++) {
       font_kern_list *kerns = kern_hash_tablei;
@@ -218,10 +226,10 @@
 	delete tem;
       }
     }
-    a_delete kern_hash_table;
+    delete kern_hash_table;
   }
-  a_delete name;
-  a_delete internalname;
+  delete name;
+  delete internalname;
   while (widths_cache) {
     font_widths_cache *tem = widths_cache;
     widths_cache = widths_cache->next;
@@ -266,9 +274,11 @@
     return sz == unitwidth ? w : scale_round(w, sz, unitwidth);
 }
 
-int font::unit_scale(double *value, char unit)
+// Returns whether scaling by arguments was successful.  Used for paper
+// size conversions.
+bool font::unit_scale(double *value, char unit)
 {
-  // we scale everything to inch
+  // Paper sizes are handled in inches.
   double divisor = 0;
   switch (unit) {
   case 'i':
@@ -284,14 +294,14 @@
     divisor = 2.54;
     break;
   default:
-    assert(0);
+    assert(0 == "unit not in cipP");
     break;
   }
   if (divisor) {
     *value /= divisor;
-    return 1;
+    return true;
   }
-  return 0;
+  return false;
 }
 
 int font::get_skew(glyph *g, int point_size, int sl)
@@ -300,26 +310,26 @@
   return int(h * tan((slant + sl) * PI / 180.0) + .5);
 }
 
-int font::contains(glyph *g)
+bool font::contains(glyph *g)
 {
   int idx = glyph_to_index(g);
   assert(idx >= 0);
   // Explicitly enumerated glyph?
   if (idx < nindices && ch_indexidx >= 0)
-    return 1;
+    return true;
   if (is_unicode) {
     // Unicode font
     // ASCII or Unicode character, or groff glyph name that maps to Unicode?
     if (glyph_to_unicode(g) >= 0)
-      return 1;
+      return true;
     // Numbered character?
     if (glyph_to_number(g) >= 0)
-      return 1;
+      return true;
   }
-  return 0;
+  return false;
 }
 
-int font::is_special()
+bool font::is_special()
 {
   return special;
 }
@@ -335,7 +345,7 @@
 
 font_widths_cache::~font_widths_cache()
 {
-  a_delete width;
+  delete width;
 }
 
 int font::get_width(glyph *g, int point_size)
@@ -343,7 +353,7 @@
   int idx = glyph_to_index(g);
   assert(idx >= 0);
   int real_size;
-  if (!zoom)
+  if (zoom == 0) // 0 means "don't zoom"
     real_size = point_size;
   else
   {
@@ -355,7 +365,7 @@
   if (idx < nindices && ch_indexidx >= 0) {
     // Explicitly enumerated glyph
     int i = ch_indexidx;
-    if (real_size == unitwidth || font::unscaled_charwidths)
+    if (real_size == unitwidth || font::use_unscaled_charwidths)
       return chi.width;
 
     if (!widths_cache)
@@ -386,12 +396,13 @@
     int w = wcwidth(get_code(g));
     if (w > 1)
       width *= w;
-    if (real_size == unitwidth || font::unscaled_charwidths)
+    if (real_size == unitwidth || font::use_unscaled_charwidths)
       return width;
     else
       return scale(width, point_size);
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_height(glyph *g, int point_size)
@@ -406,7 +417,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_depth(glyph *g, int point_size)
@@ -421,7 +433,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_italic_correction(glyph *g, int point_size)
@@ -436,7 +449,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_left_italic_correction(glyph *g, int point_size)
@@ -451,7 +465,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_subscript_correction(glyph *g, int point_size)
@@ -466,7 +481,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 void font::set_zoom(int factor)
@@ -522,9 +538,9 @@
   return 0;
 }
 
-int font::has_ligature(int mask)
+bool font::has_ligature(int mask)
 {
-  return mask & ligatures;
+  return (bool) (mask & ligatures);
 }
 
 int font::get_character_type(glyph *g)
@@ -539,7 +555,8 @@
     // Unicode font
     return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 int font::get_code(glyph *g)
@@ -562,7 +579,8 @@
       return n;
   }
   // The caller must check 'contains(g)' before calling get_code(g).
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 const char *font::get_name()
@@ -585,9 +603,10 @@
   }
   if (is_unicode) {
     // Unicode font
-    return NULL;
+    return 0;
   }
-  abort();
+  assert(0 == "glyph is not indexed and device lacks Unicode support");
+  abort(); // -Wreturn-type
 }
 
 const char *font::get_image_generator()
@@ -612,10 +631,10 @@
       nindices = idx + 10;
     int *old_ch_index = ch_index;
     ch_index = new intnindices;
-    memcpy(ch_index, old_ch_index, sizeof(int)*old_nindices);
+    memcpy(ch_index, old_ch_index, sizeof(int) * old_nindices);
     for (int i = old_nindices; i < nindices; i++)
       ch_indexi = -1;
-    a_delete old_ch_index;
+    delete old_ch_index;
   }
 }
 
@@ -628,8 +647,8 @@
     ch_size *= 2;
     font_char_metric *old_ch = ch;
     ch = new font_char_metricch_size;
-    memcpy(ch, old_ch, old_ch_size*sizeof(font_char_metric));
-    a_delete old_ch;
+    memcpy(ch, old_ch, old_ch_size * sizeof(font_char_metric));
+    delete old_ch;
   }
 }
 
@@ -644,14 +663,14 @@
     int *old_ch_index = ch_index;
     ch_index = new inti;
     memcpy(ch_index, old_ch_index, i*sizeof(int));
-    a_delete old_ch_index;
+    delete old_ch_index;
     nindices = i;
   }
   if (ch_used < ch_size) {
     font_char_metric *old_ch = ch;
     ch = new font_char_metricch_used;
     memcpy(ch, old_ch, ch_used*sizeof(font_char_metric));
-    a_delete old_ch;
+    delete old_ch;
     ch_size = ch_used;
   }
 }
@@ -680,10 +699,10 @@
   ch_indexnew_index = ch_indexold_index;
 }
 
-font *font::load_font(const char *s, int *not_found, int head_only)
+font *font::load_font(const char *s, bool load_header_only)
 {
   font *f = new font(s);
-  if (!f->load(not_found, head_only)) {
+  if (!f->load(load_header_only)) {
     delete f;
     return 0;
   }
@@ -692,7 +711,7 @@
 
 static char *trim_arg(char *p)
 {
-  if (!p)
+  if (0 == p)
     return 0;
   while (csspace(*p))
     p++;
@@ -703,13 +722,13 @@
   return p;
 }
 
-int font::scan_papersize(const char *p,
-			 const char **size, double *length, double *width)
+bool font::scan_papersize(const char *p, const char **size,
+			  double *length, double *width)
 {
   double l, w;
   char lu2, wu2;
   const char *pp = p;
-  int test_file = 1;
+  bool attempt_file_open = true;
   char line255;
 again:
   if (csdigit(*pp)) {
@@ -722,7 +741,7 @@
 	*width = w;
       if (size)
 	*size = "custom";
-      return 1;
+      return true;
     }
   }
   else {
@@ -735,81 +754,91 @@
 	  *width = papersizesi.width;
 	if (size)
 	  *size = papersizesi.name;
-	return 1;
+	return true;
       }
-    if (test_file) {
-      FILE *f = fopen(p, "r");
-      if (f) {
-	fgets(line, 254, f);
-	fclose(f);
-	test_file = 0;
-	char *linep = strchr(line, '\0');
-	// skip final newline, if any
-	if (*(--linep) == '\n')
-	  *linep = '\0';
-	pp = line;
+    if (attempt_file_open) {
+      FILE *fp = fopen(p, "r");
+      if (fp != 0) {
+	if (fgets(line, 254, fp)) {
+	  // Don't recurse on file names.
+	  attempt_file_open = false;
+	  char *linep = strchr(line, '\0');
+	  // skip final newline, if any
+	  if (*(--linep) == '\n')
+	    *linep = '\0';
+	  pp = line;
+	}
+	fclose(fp);
 	goto again;
       }
     }
   }
-  return 0;
+  return false;
 }
 
-// If the font can't be found, then if not_found is non-NULL, it will be set
-// to 1 otherwise a message will be printed.
-
-int font::load(int *not_found, int head_only)
+bool font::load(bool load_header_only)
 {
-  if (strcmp(name, "DESC") == 0) {
-    if (not_found)
-      *not_found = 1;
-    else
-      error("'DESC' is not a valid font file name");
-    return 0;
-  }
-  char *path;
   FILE *fp;
-  if ((fp = open_file(name, &path)) == NULL) {
-    if (not_found)
-      *not_found = 1;
-    else
-      error("can't find font file '%1'", name);
-    return 0;
-  }
+  char *path;
+  if ((fp = open_file(name, &path)) == 0)
+    return false;
   text_file t(fp, path);
-  t.skip_comments = 1;
-  t.silent = head_only;
-  char *p;
-  for (;;) {
-    if (!t.next()) {
-      p = 0;
-      break;
-    }
+  t.silent = load_header_only;
+  char *p = 0;
+  bool saw_name_directive = false;
+  while (t.next_line()) {
     p = strtok(t.buf, WS);
     if (strcmp(p, "name") == 0) {
+      p = strtok(0, WS);
+      if (0 == p) {
+	t.error("'name' directive requires an argument");
+	return false;
+      }
+      if (strcmp(p, name) != 0) {
+	t.error("font description file name '%1' does not match 'name'"
+		" argument '%2'", name, p);
+	return false;
+      }
+      saw_name_directive = true;
     }
     else if (strcmp(p, "spacewidth") == 0) {
       p = strtok(0, WS);
       int n;
-      if (p == 0 || sscanf(p, "%d", &n) != 1 || n <= 0) {
-	t.error("bad argument for 'spacewidth' command");
-	return 0;
+      if (0 == p) {
+	t.error("missing argument to 'spacewidth' directive");
+	return false;
+      }
+      if (sscanf(p, "%d", &n) != 1) {
+	t.error("invalid argument '%1' to 'spacewidth' directive", p);
+	return false;
+      }
+      if (n <= 0) {
+	t.error("'spacewidth' argument '%1' out of range", n);
+	return false;
       }
       space_width = n;
     }
     else if (strcmp(p, "slant") == 0) {
       p = strtok(0, WS);
       double n;
-      if (p == 0 || sscanf(p, "%lf", &n) != 1 || n >= 90.0 || n <= -90.0) {
-	t.error("bad argument for 'slant' command", p);
-	return 0;
+      if (0 == p) {
+	t.error("missing argument to 'slant' directive");
+	return false;
+      }
+      if (sscanf(p, "%lf", &n) != 1) {
+	t.error("invalid argument '%1' to 'slant' directive", p);
+	return false;
+      }
+      if (n >= 90.0 || n <= -90.0) {
+	t.error("'slant' directive argument '%1' out of range", n);
+	return false;
       }
       slant = n;
     }
     else if (strcmp(p, "ligatures") == 0) {
       for (;;) {
 	p = strtok(0, WS);
-	if (p == 0 || strcmp(p, "0") == 0)
+	if (0 == p || strcmp(p, "0") == 0)
 	  break;
 	if (strcmp(p, "ff") == 0)
 	  ligatures |= LIG_ff;
@@ -822,198 +851,203 @@
 	else if (strcmp(p, "ffl") == 0)
 	  ligatures |= LIG_ffl;
 	else {
-	  t.error("unrecognised ligature '%1'", p);
-	  return 0;
+	  t.error("unrecognized ligature '%1'", p);
+	  return false;
 	}
       }
     }
     else if (strcmp(p, "internalname") == 0) {
       p = strtok(0, WS);
-      if (!p) {
-	t.error("'internalname' command requires argument");
-	return 0;
+      if (0 == p) {
+	t.error("missing argument to 'internalname' directive");
+	return false;
       }
       internalname = new charstrlen(p) + 1;
       strcpy(internalname, p);
     }
     else if (strcmp(p, "special") == 0) {
-      special = 1;
+      special = true;
     }
     else if (strcmp(p, "kernpairs") != 0 && strcmp(p, "charset") != 0) {
-      char *command = p;
+      char *directive = p;
       p = strtok(0, "\n");
-      handle_unknown_font_command(command, trim_arg(p), t.path, t.lineno);
+      handle_unknown_font_command(directive, trim_arg(p), t.path,
+				  t.lineno);
     }
     else
       break;
   }
-  int had_charset = 0;
-  if (p == 0) {
-    if (!is_unicode) {
-      t.error("missing charset command");
-      return 0;
+  bool saw_charset_directive = false;
+  char *directive = p;
+  t.recognize_comments = false;
+  while (directive) {
+    if (strcmp(directive, "kernpairs") == 0) {
+      if (load_header_only)
+	return true;
+      for (;;) {
+	if (!t.next_line()) {
+	  directive = 0;
+	  break;
+	}
+	char *c1 = strtok(t.buf, WS);
+	if (0 == c1)
+	  continue;
+	char *c2 = strtok(0, WS);
+	if (0 == c2) {
+	  directive = c1;
+	  break;
+	}
+	p = strtok(0, WS);
+	if (0 == p) {
+	  t.error("missing kern amount for kerning pair '%1 %2'", c1,
+		  c2);
+	  return false;
+	}
+	int n;
+	if (sscanf(p, "%d", &n) != 1) {
+	  t.error("invalid kern amount '%1' for kerning pair '%2 %3'",
+		  p, c1, c2);
+	  return false;
+	}
+	glyph *g1 = name_to_glyph(c1);
+	glyph *g2 = name_to_glyph(c2);
+	add_kern(g1, g2, n);
+      }
     }
-  } else {
-    char *command = p;
-    t.skip_comments = 0;
-    while (command) {
-      if (strcmp(command, "kernpairs") == 0) {
-	if (head_only)
-	  return 1;
-	for (;;) {
-	  if (!t.next()) {
-	    command = 0;
-	    break;
+    else if (strcmp(directive, "charset") == 0) {
+      if (load_header_only)
+	return true;
+      saw_charset_directive = true;
+      glyph *last_glyph = 0;
+      for (;;) {
+	if (!t.next_line()) {
+	  directive = 0;
+	  break;
+	}
+	char *nm = strtok(t.buf, WS);
+	assert(nm != 0);
+	p = strtok(0, WS);
+	if (0 == p) {
+	  directive = nm;
+	  break;
+	}
+	if (p0 == '"') {
+	  if (last_glyph == 0) {
+	    t.error("the first entry ('%1') in 'charset' subsection"
+		    " cannot be an alias", nm);
+	    return false;
 	  }
-	  char *c1 = strtok(t.buf, WS);
-	  if (c1 == 0)
-	    continue;
-	  char *c2 = strtok(0, WS);
-	  if (c2 == 0) {
-	    command = c1;
-	    break;
+	  if (strcmp(nm, "---") == 0) {
+	    t.error("an unnamed character ('---') cannot be an alias");
+	    return false;
+	  }
+	  glyph *g = name_to_glyph(nm);
+	  copy_entry(g, last_glyph);
+	}
+	else {
+	  font_char_metric metric;
+	  metric.height = 0;
+	  metric.depth = 0;
+	  metric.pre_math_space = 0;
+	  metric.italic_correction = 0;
+	  metric.subscript_correction = 0;
+	  int nparms = sscanf(p, "%d,%d,%d,%d,%d,%d",
+			      &metric.width, &metric.height,
+			      &metric.depth,
+			      &metric.italic_correction,
+			      &metric.pre_math_space,
+			      &metric.subscript_correction);
+	  if (nparms < 1) {
+	    t.error("missing or invalid width for glyph '%1'", nm);
+	    return false;
 	  }
 	  p = strtok(0, WS);
-	  if (p == 0) {
-	    t.error("missing kern amount");
-	    return 0;
+	  if (0 == p) {
+	    t.error("missing character type for '%1'", nm);
+	    return false;
 	  }
-	  int n;
-	  if (sscanf(p, "%d", &n) != 1) {
-	    t.error("bad kern amount '%1'", p);
-	    return 0;
+	  int type;
+	  if (sscanf(p, "%d", &type) != 1) {
+	    t.error("invalid character type for '%1'", nm);
+	    return false;
 	  }
-	  glyph *g1 = name_to_glyph(c1);
-	  glyph *g2 = name_to_glyph(c2);
-	  add_kern(g1, g2, n);
-	}
-      }
-      else if (strcmp(command, "charset") == 0) {
-	if (head_only)
-	  return 1;
-	had_charset = 1;
-	glyph *last_glyph = NULL;
-	for (;;) {
-	  if (!t.next()) {
-	    command = 0;
-	    break;
+	  if (type < 0 || type > 255) {
+	    t.error("character type '%1' out of range for '%2'", type,
+		    nm);
+	    return false;
 	  }
-	  char *nm = strtok(t.buf, WS);
-	  if (nm == 0)
-	    continue;			// I dont think this should happen
+	  metric.type = type;
 	  p = strtok(0, WS);
-	  if (p == 0) {
-	    command = nm;
-	    break;
+	  if (0 == p) {
+	    t.error("missing code for '%1'", nm);
+	    return false;
+	  }
+	  char *ptr;
+	  metric.code = (int)strtol(p, &ptr, 0);
+	  if (metric.code == 0 && ptr == p) {
+	    t.error("invalid code '%1' for character '%2'", p, nm);
+	    return false;
+	  }
+	  if (is_unicode) {
+	    int w = wcwidth(metric.code);
+	    if (w > 1)
+	      metric.width *= w;
 	  }
-	  if (p0 == '"') {
-	    if (last_glyph == NULL) {
-	      t.error("first charset entry is duplicate");
-	      return 0;
-	    }
-	    if (strcmp(nm, "---") == 0) {
-	      t.error("unnamed character cannot be duplicate");
-	      return 0;
-	    }
-	    glyph *g = name_to_glyph(nm);
-	    copy_entry(g, last_glyph);
+	  p = strtok(0, WS);
+	  if ((0 == p) || (strcmp(p, "--") == 0)) {
+	    metric.special_device_coding = 0;
 	  }
 	  else {
-	    font_char_metric metric;
-	    metric.height = 0;
-	    metric.depth = 0;
-	    metric.pre_math_space = 0;
-	    metric.italic_correction = 0;
-	    metric.subscript_correction = 0;
-	    int nparms = sscanf(p, "%d,%d,%d,%d,%d,%d",
-				&metric.width, &metric.height, &metric.depth,
-				&metric.italic_correction,
-				&metric.pre_math_space,
-				&metric.subscript_correction);
-	    if (nparms < 1) {
-	      t.error("bad width for '%1'", nm);
-	      return 0;
-	    }
-	    p = strtok(0, WS);
-	    if (p == 0) {
-	      t.error("missing character type for '%1'", nm);
-	      return 0;
-	    }
-	    int type;
-	    if (sscanf(p, "%d", &type) != 1) {
-	      t.error("bad character type for '%1'", nm);
-	      return 0;
-	    }
-	    if (type < 0 || type > 255) {
-	      t.error("character type '%1' out of range", type);
-	      return 0;
-	    }
-	    metric.type = type;
-	    p = strtok(0, WS);
-	    if (p == 0) {
-	      t.error("missing code for '%1'", nm);
-	      return 0;
-	    }
-	    char *ptr;
-	    metric.code = (int)strtol(p, &ptr, 0);
-	    if (metric.code == 0 && ptr == p) {
-	      t.error("bad code '%1' for character '%2'", p, nm);
-	      return 0;
-	    }
-	    if (is_unicode) {
-	      int w = wcwidth(metric.code);
-	      if (w > 1)
-	        metric.width *= w;
-	    }
-	    p = strtok(0, WS);
-	    if ((p == NULL) || (strcmp(p, "--") == 0)) {
-	      metric.special_device_coding = NULL;
-	    }
-	    else {
-	      char *nam = new charstrlen(p) + 1;
-	      strcpy(nam, p);
-	      metric.special_device_coding = nam;
-	    }
-	    if (strcmp(nm, "---") == 0) {
-	      last_glyph = number_to_glyph(metric.code);
-	      add_entry(last_glyph, metric);
-	    }
-	    else {
-	      last_glyph = name_to_glyph(nm);
-	      add_entry(last_glyph, metric);
-	      copy_entry(number_to_glyph(metric.code), last_glyph);
-	    }
+	    char *nam = new charstrlen(p) + 1;
+	    strcpy(nam, p);
+	    metric.special_device_coding = nam;
+	  }
+	  if (strcmp(nm, "---") == 0) {
+	    last_glyph = number_to_glyph(metric.code);
+	    add_entry(last_glyph, metric);
+	  }
+	  else {
+	    last_glyph = name_to_glyph(nm);
+	    add_entry(last_glyph, metric);
+	    copy_entry(number_to_glyph(metric.code), last_glyph);
 	  }
-	}
-	if (last_glyph == NULL) {
-	  t.error("I didn't seem to find any characters");
-	  return 0;
 	}
       }
-      else {
-	t.error("unrecognised command '%1' "
-		"after 'kernpairs' or 'charset' command",
-		  command);
-	return 0;
+      if (0 == last_glyph) {
+	t.error("no glyphs defined in font description");
+	return false;
       }
     }
-    compact();
+    else {
+      t.error("unrecognized font description directive '%1' (missing"
+	      " 'kernpairs' or 'charset'?)", directive);
+      return false;
+    }
   }
-  if (!is_unicode && !had_charset) {
-    t.error("missing 'charset' command");
-    return 0;
+  compact();
+  t.lineno = 0;
+  if (!saw_name_directive) {
+    t.error("font description 'name' directive missing");
+    return false;
+  }
+  if (!is_unicode && !saw_charset_directive) {
+    t.error("font description 'charset' subsection missing");
+    return false;
   }
   if (space_width == 0) {
+    t.error("font description 'spacewidth' directive missing");
+    // _Don't_ return false; compute a typical one for Western glyphs.
     if (zoom)
-      space_width = scale_round(unitwidth, res, 72 * 3 * sizescale, zoom);
+      space_width = scale_round(unitwidth, res, 72 * 3 * sizescale,
+				zoom);
     else
       space_width = scale_round(unitwidth, res, 72 * 3 * sizescale);
   }
-  return 1;
+  return true;
 }
 
 static struct {
-  const char *command;
+  const char *numeric_directive;
   int *ptr;
 } table = {
   { "res", &font::res },
@@ -1028,43 +1062,55 @@
   { "sizescale", &font::sizescale },
   };
 
-int font::load_desc()
+// Return file specification of DESC file for selected output device if
+// it can be located and is valid, and a null pointer otherwise.
+const char *font::load_desc()
 {
   int nfonts = 0;
   FILE *fp;
   char *path;
-  if ((fp = open_file("DESC", &path)) == 0) {
-    error("can't find 'DESC' file");
-    return 0;
-  }
+  if ((fp = open_file("DESC", &path)) == 0)
+    return 0 /* nullptr */;
   text_file t(fp, path);
-  t.skip_comments = 1;
-  res = 0;
-  while (t.next()) {
+  while (t.next_line()) {
     char *p = strtok(t.buf, WS);
-    int found = 0;
+    assert(p != 0);
+    bool numeric_directive_found = false;
     unsigned int idx;
-    for (idx = 0; !found && idx < sizeof(table)/sizeof(table0); idx++)
-      if (strcmp(tableidx.command, p) == 0)
-	found = 1;
-    if (found) {
+    for (idx = 0; !numeric_directive_found
+		  && idx < sizeof(table) / sizeof(table0); idx++)
+      if (strcmp(tableidx.numeric_directive, p) == 0)
+	numeric_directive_found = true;
+    if (numeric_directive_found) {
       char *q = strtok(0, WS);
-      if (!q) {
-	t.error("missing value for command '%1'", p);
-	return 0;
+      if (0 == q) {
+	t.error("missing value for directive '%1'", p);
+	return 0 /* nullptr */;
+      }
+      int val;
+      if (sscanf(q, "%d", &val) != 1) {
+	t.error("'%1' directive given invalid number '%2'", p, q);
+	return 0 /* nullptr */;
       }
-      //int *ptr = &(this->*(tableidx-1.ptr));
-      int *ptr = tableidx-1.ptr;
-      if (sscanf(q, "%d", ptr) != 1) {
-	t.error("bad number '%1'", q);
-	return 0;
+      if ((strcmp(p, "res") == 0
+	   || strcmp(p, "hor") == 0
+	   || strcmp(p, "vert") == 0
+	   || strcmp(p, "unitwidth") == 0
+	   || strcmp(p, "paperwidth") == 0
+	   || strcmp(p, "paperlength") == 0
+	   ||  strcmp(p, "sizescale") == 0)
+	  && val < 1) {
+	t.error("expected argument to '%1' directive to be a"
+		" positive number, got '%2'", p, val);
+	return 0 /* nullptr */;
       }
+      *(tableidx-1.ptr) = val;
     }
     else if (strcmp("family", p) == 0) {
       p = strtok(0, WS);
-      if (!p) {
-	t.error("family command requires an argument");
-	return 0;
+      if (0 == p) {
+	t.error("'family' directive requires an argument");
+	return 0 /* nullptr */;
       }
       char *tem = new charstrlen(p)+1;
       strcpy(tem, p);
@@ -1072,17 +1118,22 @@
     }
     else if (strcmp("fonts", p) == 0) {
       p = strtok(0, WS);
-      if (!p || sscanf(p, "%d", &nfonts) != 1 || nfonts <= 0) {
-	t.error("bad number of fonts '%1'", p);
-	return 0;
+      if (0 == p) {
+	t.error("'fonts' directive requires arguments");
+	return 0 /* nullptr */;
       }
-      font_name_table = (const char **)new char *nfonts+1; 
+      if (sscanf(p, "%d", &nfonts) != 1 || nfonts <= 0) {
+	t.error("expected first argument to 'fonts' directive to be a"
+		" non-negative number, got '%1'", p);
+	return 0 /* nullptr */;
+      }
+      font_name_table = (const char **)new char *nfonts+1;
       for (int i = 0; i < nfonts; i++) {
 	p = strtok(0, WS);
-	while (p == 0) {
-	  if (!t.next()) {
-	    t.error("end of file while reading list of fonts");
-	    return 0;
+	while (0 == p) {
+	  if (!t.next_line()) {
+	    t.error("unexpected end of file while reading font list");
+	    return 0 /* nullptr */;
 	  }
 	  p = strtok(t.buf, WS);
 	}
@@ -1092,48 +1143,61 @@
       }
       p = strtok(0, WS);
       if (p != 0) {
-	t.error("font count does not match number of fonts");
-	return 0;
+	t.error("font count does not match declared number of fonts"
+		" ('%1')", nfonts);
+	return 0 /* nullptr */;
       }
       font_name_tablenfonts = 0;
     }
     else if (strcmp("papersize", p) == 0) {
+      if (0 == res) {
+	t.error("'res' directive must precede 'papersize' in device"
+		" description file");
+	return 0 /* nullptr */;
+      }
       p = strtok(0, WS);
-      if (!p) {
-	t.error("papersize command requires an argument");
-	return 0;
+      if (0 == p) {
+	t.error("'papersize' directive requires an argument");
+	return 0 /* nullptr */;
       }
-      int found_paper = 0;
+      bool found_paper = false;
+      char *savedp = strdup(p);
+      if (0 == savedp)
+	t.fatal("memory allocation failure while processing 'papersize'"
+		" directive");
       while (p) {
 	double unscaled_paperwidth, unscaled_paperlength;
 	if (scan_papersize(p, &papersize, &unscaled_paperlength,
 			   &unscaled_paperwidth)) {
 	  paperwidth = int(unscaled_paperwidth * res + 0.5);
 	  paperlength = int(unscaled_paperlength * res + 0.5);
-	  found_paper = 1;
+	  found_paper = true;
 	  break;
 	}
 	p = strtok(0, WS);
       }
+      assert(savedp != 0);
       if (!found_paper) {
-	t.error("bad paper size");
-	return 0;
+	t.error("unable to determine a paper format from '%1'", savedp);
+	free(savedp);
+	return 0 /* nullptr */;
       }
+      free(savedp);
     }
     else if (strcmp("unscaled_charwidths", p) == 0)
-      unscaled_charwidths = 1;
+      use_unscaled_charwidths = true;
     else if (strcmp("pass_filenames", p) == 0)
-      pass_filenames = 1;
+      pass_filenames = true;
     else if (strcmp("sizes", p) == 0) {
       int n = 16;
       sizes = new intn;
       int i = 0;
       for (;;) {
 	p = strtok(0, WS);
-	while (p == 0) {
-	  if (!t.next()) {
+	while (0 == p) {
+	  if (!t.next_line()) {
 	    t.error("list of sizes must be terminated by '0'");
-	    return 0;
+	    return 0 /* nullptr */;
 	  }
 	  p = strtok(t.buf, WS);
 	}
@@ -1147,15 +1211,15 @@
 	    break;
 	  // fall through
 	default:
-	  t.error("bad size range '%1'", p);
-	  return 0;
+	  t.error("invalid size range '%1'", p);
+	  return 0 /* nullptr */;
 	}
 	if (i + 2 > n) {
 	  int *old_sizes = sizes;
 	  sizes = new intn*2;
 	  memcpy(sizes, old_sizes, n*sizeof(int));
 	  n *= 2;
-	  a_delete old_sizes;
+	  delete old_sizes;
 	}
 	sizesi++ = lower;
 	if (lower == 0)
@@ -1164,7 +1228,7 @@
       }
       if (i == 1) {
 	t.error("must have some sizes");
-	return 0;
+	return 0 /* nullptr */;
       }
     }
     else if (strcmp("styles", p) == 0) {
@@ -1176,7 +1240,7 @@
       int i = 0;
       for (;;) {
 	p = strtok(0, WS);
-	if (p == 0)
+	if (0 == p)
 	  break;
 	// leave room for terminating 0
 	if (i + 1 >= style_table_size) {
@@ -1187,7 +1251,7 @@
 	    style_tablej = old_style_tablej;
 	  for (; j < style_table_size; j++)
 	    style_tablej = 0;
-	  a_delete old_style_table;
+	  delete old_style_table;
 	}
 	char *tem = new charstrlen(p) + 1;
 	strcpy(tem, p);
@@ -1195,57 +1259,47 @@
       }
     }
     else if (strcmp("tcommand", p) == 0)
-      tcommand = 1;
+      has_tcommand = true;
     else if (strcmp("use_charnames_in_special", p) == 0)
-      use_charnames_in_special = 1;
+      use_charnames_in_special = true;
     else if (strcmp("unicode", p) == 0)
-      is_unicode = 1;
+      is_unicode = true;
     else if (strcmp("image_generator", p) == 0) {
       p = strtok(0, WS);
-      if (!p) {
-	t.error("image_generator command requires an argument");
-	return 0;
+      if (0 == p) {
+	t.error("'image_generator' directive requires an argument");
+	return 0 /* nullptr */;
       }
       image_generator = strsave(p);
     }
     else if (strcmp("charset", p) == 0)
       break;
     else if (unknown_desc_command_handler) {
-      char *command = p;
+      char *directive = p;
       p = strtok(0, "\n");
-      (*unknown_desc_command_handler)(command, trim_arg(p), t.path, t.lineno);
+      (*unknown_desc_command_handler)(directive, trim_arg(p), t.path,
+				      t.lineno);
     }
   }
+  t.lineno = 0;
   if (res == 0) {
-    t.error("missing 'res' command");
-    return 0;
+    t.error("device description file missing 'res' directive");
+    return 0 /* nullptr */;
   }
   if (unitwidth == 0) {
-    t.error("missing 'unitwidth' command");
-    return 0;
+    t.error("device description file missing 'unitwidth' directive");
+    return 0 /* nullptr */;
   }
   if (font_name_table == 0) {
-    t.error("missing 'fonts' command");
-    return 0;
+    t.error("device description file missing 'fonts' directive");
+    return 0 /* nullptr */;
   }
   if (sizes == 0) {
-    t.error("missing 'sizes' command");
-    return 0;
+    t.error("device description file missing 'sizes' directive");
+    return 0 /* nullptr */;
   }
-  if (sizescale < 1) {
-    t.error("bad 'sizescale' value");
-    return 0;
-  }
-  if (hor < 1) {
-    t.error("bad 'hor' value");
-    return 0;
-  }
-  if (vert < 1) {
-    t.error("bad 'vert' value");
-    return 0;
-  }
-  return 1;
-}      
+  return path;
+}
 
 void font::handle_unknown_font_command(const char *, const char *,
 				       const char *, int)
@@ -1259,3 +1313,9 @@
   unknown_desc_command_handler = func;
   return prev;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/fontfile.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/fontfile.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,7 +18,6 @@
 
 #include "lib.h"
 
-#include <assert.h>
 #include <stdlib.h>
 #include <errno.h>
 #include "font.h"
@@ -41,12 +39,12 @@
 int font::biggestfont = 0;
 int font::spare2 = 0;
 int font::sizescale = 1;
-int font::tcommand = 0;
-int font::pass_filenames = 0;
-int font::unscaled_charwidths = 0;
-int font::use_charnames_in_special = 0;
-int font::is_unicode = 0;
-const char *font::image_generator = NULL;
+bool font::has_tcommand = false;
+bool font::pass_filenames = false;
+bool font::use_unscaled_charwidths = false;
+bool font::use_charnames_in_special = false;
+bool font::is_unicode = false;
+const char *font::image_generator = 0;
 const char **font::font_name_table = 0;
 int *font::sizes = 0;
 const char *font::family = 0;
@@ -60,9 +58,23 @@
 
 FILE *font::open_file(const char *nm, char **pathp)
 {
-  char *filename = new charstrlen(nm) + strlen(device) + 5;
-  sprintf(filename, "dev%s/%s", device, nm);
-  FILE *fp = font_path.open_file(filename, pathp);
-  a_delete filename;
+  FILE *fp = 0 /* nullptr */;
+  // Do not traverse user-specified directories; Savannah #61424.
+  if (0 /* nullptr */ == strchr(nm, '/')) {
+    // Allocate enough for nm + device + 'dev' '/' '\0'.
+    int expected_size = strlen(nm) + strlen(device) + 5;
+    char *filename = new charexpected_size;
+    const int actual_size = sprintf(filename, "dev%s/%s", device, nm);
+    expected_size--; // sprintf() doesn't count the null terminator.
+    if (actual_size == expected_size)
+      fp = font_path.open_file(filename, pathp);
+    delete filename;
+  }
   return fp;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/geometry.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/geometry.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/getcwd.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/getcwd.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/getopt.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/getopt.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/getopt1.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/getopt1.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/glyphuni.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/glyphuni.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/htmlhint.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/htmlhint.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/hypot.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/hypot.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/iftoa.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/iftoa.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -16,19 +16,15 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-#define INT_DIGITS 19		/* enough for 64-bit integer */
+#include "lib.h"
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/* Prototype */
-char *if_to_a(int, int);
-
-char *if_to_a(int i, int decimal_point)
+const char *if_to_a(int i, int decimal_point)
 {
-  /* room for a -, INT_DIGITS digits, a decimal point, and a terminating '\0' */
-  static char bufINT_DIGITS + 3;
+  static char bufINT_DIGITS + 3; // INT_DIGITS + '-', '.', '\0'
   char *p = buf + INT_DIGITS + 2;
   int point = 0;
   bufINT_DIGITS + 2 = '\0';
@@ -72,3 +68,9 @@
 #ifdef __cplusplus
 }
 #endif
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/invalid.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/invalid.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/itoa.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/itoa.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -16,18 +16,13 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-#define INT_DIGITS 19		/* enough for 64 bit integer */
-#define UINT_DIGITS 20
+#include "lib.h"
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/* Prototypes */
-char *i_to_a(int);
-char *ui_to_a(unsigned int);
-
-char *i_to_a(int i)
+const char *i_to_a(int i)
 {
   /* Room for INT_DIGITS digits, - and '\0' */
   static char bufINT_DIGITS + 2;
@@ -49,7 +44,7 @@
   return p;
 }
 
-char *ui_to_a(unsigned int i)
+const char *ui_to_a(unsigned int i)
 {
   /* Room for UINT_DIGITS digits and '\0' */
   static char bufUINT_DIGITS + 1;
@@ -64,3 +59,9 @@
 #ifdef __cplusplus
 }
 #endif
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/lf.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/lf.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/libgroff.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/libgroff.am Changed

@@ -1,16 +1,14 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 13 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -58,7 +56,6 @@
   src/libs/libgroff/maxpathname.cpp \
   src/libs/libgroff/mksdir.cpp \
   src/libs/libgroff/nametoindex.cpp \
-  src/libs/libgroff/new.cpp \
   src/libs/libgroff/paper.cpp \
   src/libs/libgroff/prime.cpp \
   src/libs/libgroff/progname.c \
@@ -76,6 +73,10 @@
   src/libs/libgroff/uniglyph.cpp \
   src/libs/libgroff/uniuni.cpp \
   src/libs/libgroff/relocatable.h
+if USE_GROFF_ALLOCATOR
+libgroff_a_SOURCES += \
+  src/libs/libgroff/new.cpp
+endif
 nodist_libgroff_a_SOURCES = src/libs/libgroff/version.cpp
 
 # TODO: these .c files could be removed (use gnulib instead).
@@ -99,20 +100,22 @@
   ref-add.sed \
   ref-del.sed
 
-# .o files have a 'libgroff_a-' prefix because we set libgroff_a_CPPFLAGS
+# .o files have a 'libgroff_a-' prefix because we set
+# libgroff_a_CPPFLAGS.
 src/libs/libgroff/libgroff_a-device.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-fontfile.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-macropath.$(OBJEXT): defs.h
 src/libs/libgroff/libgroff_a-relocate.$(OBJEXT): defs.h
 
 src/libs/libgroff/version.cpp: $(top_srcdir)/.version
-	@echo Making version.cpp
-	@echo const char \*version_string = \"$(MAJOR_VERSION).$(MINOR_VERSION)\"\; >$@
-	@echo const char \*revision_string = \"$(REVISION)\"\; >>$@
-	@echo extern \"C\" { >>$@
-	@echo const char \*Version_string = \"$(VERSION)\"\; >>$@
-	@echo } >>$@ \
-	  | sed -e 's/\.0\"/\"/' >>$@
+	$(AM_V_at)printf 'const char *version_string = "%s.%s";\n' \
+	  $(MAJOR_VERSION) $(MINOR_VERSION) > $@.tmp
+	$(AM_V_at)printf 'const char *revision_string = "%s";\n' \
+	  $(REVISION) >> $@.tmp
+	$(AM_V_at)printf \
+	  'extern "C" {\nconst char *Version_string = "%s";\n}\n' \
+	  $(VERSION) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
 
 # Data for localcharset.c.  Taken from libiconv/libcharset.
 
@@ -121,18 +124,21 @@
 all: charset.alias ref-add.sed ref-del.sed
 
 charset.alias: $(libgroff_srcdir)/config.charset
-	$(SHELL) $(libgroff_srcdir)/config.charset '$(HOST)' > t-$@
-	mv t-$@ $@
-
-ref-add.sed : $(libgroff_srcdir)/ref-add.sin
-	sed -e '/^#/d' \
-	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' $(libgroff_srcdir)/ref-add.sin > t-$@
-	mv t-$@ $@
-
-ref-del.sed : $(libgroff_srcdir)/ref-del.sin
-	sed -e '/^#/d' \
-	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' $(libgroff_srcdir)/ref-del.sin > t-$@
-	mv t-$@ $@
+	$(AM_V_GEN)$(SHELL) $(libgroff_srcdir)/config.charset \
+	    '$(HOST)' > t-$@ \
+	  && mv t-$@ $@
+
+ref-add.sed: $(libgroff_srcdir)/ref-add.sin
+	$(AM_V_GEN)sed -e '/^#/d' \
+	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' \
+	    $(libgroff_srcdir)/ref-add.sin > t-$@ \
+	  && mv t-$@ $@
+
+ref-del.sed: $(libgroff_srcdir)/ref-del.sin
+	$(AM_V_GEN)sed -e '/^#/d' \
+	    -e 's/@''PACKAGE''@/$(LIBGROFF_PACKAGE)/g' \
+	    $(libgroff_srcdir)/ref-del.sin > t-$@ \
+	  && mv t-$@ $@
 
 install-data-local: install_charset_data
 install_charset_data:
@@ -169,12 +175,8 @@
 	fi
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/lineno.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/lineno.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/localcharset.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/localcharset.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/macropath.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/macropath.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/make-uniuni -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/make-uniuni Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/matherr.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/matherr.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/maxfilename.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/maxfilename.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/maxpathname.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/maxpathname.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/mksdir.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/mksdir.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/mkstemp.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/mkstemp.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/nametoindex.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/nametoindex.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,9 +18,10 @@
 
 #include "lib.h"
 
-#include <ctype.h>
 #include <assert.h>
+#include <ctype.h>
 #include <stdlib.h>
+
 #include "errarg.h"
 #include "error.h"
 #include "font.h"
@@ -31,7 +31,7 @@
 // Every glyphinfo is actually a charinfo.
 class charinfo : glyph {
 public:
-  const char *name;	// The glyph name, or NULL.
+  const char *name;	// The glyph name, or a null pointer.
   friend class character_indexer;
 };
 
@@ -104,7 +104,7 @@
       return ascii_char_glyph((unsigned char)n);
   }
   charinfo *ci = table.lookupassoc(&s);
-  if (ci == NULL) {
+  if (0 == ci) {
     ci = new charinfo1;
     ci->index = next_index++;
     ci->number = -1;
@@ -120,17 +120,17 @@
       charinfo *ci = new charinfo;
       ci->index = next_index++;
       ci->number = n;
-      ci->name = NULL;
+      ci->name = 0;
       small_number_glyphn = ci;
     }
     return small_number_glyphn;
   }
   charinfo *ci = ntable.lookup(n);
-  if (ci == NULL) {
+  if (0 == ci) {
     ci = new charinfo1;
     ci->index = next_index++;
     ci->number = n;
-    ci->name = NULL;
+    ci->name = 0;
     ntable.define(n, ci);
   }
   return ci;
@@ -159,3 +159,9 @@
   charinfo *ci = (charinfo *)g; // Every glyph is actually a charinfo.
   return ci->name;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/new.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/new.cpp Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -36,11 +36,7 @@
   // Avoid relying on the behaviour of malloc(0).
   if (size == 0)
     size++;
-#ifdef COOKIE_BUG
-  char *p = (char *)malloc(unsigned(size + 8));
-#else /* not COOKIE_BUG */
   char *p = (char *)malloc(unsigned(size));
-#endif /* not COOKIE_BUG */
   if (p == 0) {
     if (program_name) {
       ewrite(program_name);
@@ -49,23 +45,13 @@
     ewrite("out of memory\n");
     _exit(-1);
   }
-#ifdef COOKIE_BUG
-  ((unsigned *)p)1 = 0;
-  return p + 8;
-#else /* not COOKIE_BUG */
   return p;
-#endif /* not COOKIE_BUG */
 }
 
-void operator delete(void *p)
+void operator delete(void *p) throw()
 {
-#ifdef COOKIE_BUG
-  if (p)
-    free((void *)((char *)p - 8));
-#else
   if (p)
     free(p);
-#endif /* COOKIE_BUG */
 }
 
 void operator delete(void *p,
@@ -78,11 +64,12 @@
   // In function 'void operator delete(void*, long unsigned int)':
   //   warning: deleting 'void*' is undefined -Wdelete-incomplete
   //delete p;
-#ifdef COOKIE_BUG
-  if (p)
-    free((void *)((char *)p - 8));
-#else
   if (p)
     free(p);
-#endif /* COOKIE_BUG */
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/paper.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/paper.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/prime.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/prime.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/progname.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/progname.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/ptable.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/ptable.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/putenv.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/putenv.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/quotearg.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/quotearg.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/ref-add.sin -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/ref-add.sin Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/ref-del.sin -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/ref-del.sin Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/relocatable.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/relocatable.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/relocate.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/relocate.cpp Changed

@@ -1,6 +1,5 @@
-// -*- C++ -*-
 /* Provide relocation for macro and font files.
-   Copyright (C) 2005-2018 Free Software Foundation, Inc.
+   Copyright (C) 2005-2020 Free Software Foundation, Inc.
 
    This program is free software; you can redistribute it and/or modify it
    under the terms of the GNU Library General Public License as published
@@ -19,6 +18,7 @@
 
 #include "lib.h"
 
+#include <assert.h>
 #include <errno.h>
 #include <stdlib.h>
 
@@ -115,7 +115,7 @@
 #endif
       return path;
     }
-    a_delete path;
+    delete path;
     if (*end == '\0')
       break;
     p = end + 1;
@@ -135,12 +135,12 @@
     strcpy(namex, name);
     strcat(namex, ext);
     found = searchpath(namex, pathp);
-    a_delete namex;
+    delete namex;
     if (found)
        break;
     ext = strtok(0, PATH_SEP);
   }
-  a_delete tmpathext;
+  delete tmpathext;
   return found;
 }
 
@@ -159,27 +159,27 @@
 // Compute the current prefix.
 void set_current_prefix()
 {
-  char *pathextstr;
-  curr_prefix = new charpath_name_max();
   // Obtain the full path of the current binary;
   // using GetModuleFileName on MS-Windows,
   // and searching along PATH on other systems.
 #ifdef _WIN32
+  char *pathextstr;
+  curr_prefix = new charpath_name_max();
   int len = GetModuleFileName(0, curr_prefix, path_name_max());
   if (len)
     len = GetShortPathName(curr_prefix, curr_prefix, path_name_max());
 # if DEBUG
   fprintf(stderr, "curr_prefix: %s\n", curr_prefix);
 # endif /* DEBUG */
-#else /* !_WIN32 */
-  curr_prefix = searchpath(program_name, getenv("PATH"));
   if (!curr_prefix && !strchr(program_name, '.')) {	// try with extensions
     pathextstr = strsave(getenv("PATHEXT"));
     if (!pathextstr)
       pathextstr = strsave(PATH_EXT);
     curr_prefix = searchpathext(program_name, pathextstr, getenv("PATH"));
-    a_delete pathextstr;
+    delete pathextstr;
   }
+#else /* !_WIN32 */
+  curr_prefix = searchpath(program_name, getenv("PATH"));
   if (!curr_prefix)
     return;
 #endif /* !_WIN32 */
@@ -211,7 +211,9 @@
     return strsave(path);
   char *relative_path = (char *)path + INSTALLPATHLEN;
   size_t relative_path_len = strlen(relative_path);
-  char *relocated_path = new charcurr_prefix_len + relative_path_len + 1;
+  char *relocated_path = (char *)malloc(curr_prefix_len
+					+ relative_path_len + 1);
+  assert(0 != curr_prefix);
   strcpy(relocated_path, curr_prefix);
   strcat(relocated_path, relative_path);
 #if DEBUG
@@ -234,3 +236,9 @@
 #endif
   return p;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/searchpath.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/searchpath.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,9 +18,9 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
 #include <assert.h>
 #include <errno.h>
+#include <stdlib.h>
 
 #include "searchpath.h"
 #include "nonposix.h"
@@ -67,7 +66,7 @@
 search_path::~search_path()
 {
   // dirs is always allocated
-  a_delete dirs;
+  delete dirs;
 }
 
 void search_path::command_line_dir(const char *s)
@@ -89,7 +88,7 @@
     p += init_len;
   }
   *p++ = '\0';
-  a_delete old;
+  delete old;
 }
 
 FILE *search_path::open_file(const char *name, char **pathp)
@@ -121,19 +120,23 @@
     fprintf(stderr, "origpath '%s'\n", origpath);
 #endif
     char *path = relocate(origpath);
-    a_delete origpath;
+    delete origpath;
 #if 0
     fprintf(stderr, "trying '%s'\n", path);
 #endif
     FILE *fp = fopen(path, "r");
+    int err = errno;
     if (fp) {
       if (pathp)
 	*pathp = path;
-      else
+      else {
 	free(path);
+	errno = err;
+      }
       return fp;
     }
     free(path);
+    errno = err;
     if (*end == '\0')
       break;
     p = end + 1;
@@ -178,25 +181,25 @@
     fprintf(stderr, "origpath '%s'\n", origpath);
 #endif
     char *path = relocate(origpath);
-    a_delete origpath;
+    delete origpath;
 #if 0
     fprintf(stderr, "trying '%s'\n", path);
 #endif
     FILE *fp = fopen(path, mode);
+    int err = errno;
     if (fp) {
       if (pathp)
 	*pathp = path;
-      else
+      else {
 	free(path);
+	errno = err;
+      }
       return fp;
     }
-    int err = errno;
     free(path);
+    errno = err;
     if (err != ENOENT)
-    {
-      errno = err;
       return 0;
-    }
     if (*end == '\0')
       break;
     p = end + 1;
@@ -204,3 +207,9 @@
   errno = ENOENT;
   return 0;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/spawnvp.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/spawnvp.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/strcasecmp.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/strcasecmp.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/strerror.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/strerror.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/string.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/string.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,10 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
 #include <stdlib.h>
 
 #include "lib.h"
@@ -40,7 +43,7 @@
 
 static void sfree(char *ptr, int)
 {
-  a_delete ptr;
+  delete ptr;
 }
 
 static char *sfree_alloc(char *ptr, int oldsz, int len, int *sizep)
@@ -49,7 +52,7 @@
     *sizep = oldsz;
     return ptr;
   }
-  a_delete ptr;
+  delete ptr;
   if (len == 0) {
     *sizep = 0;
     return 0;
@@ -65,7 +68,7 @@
     return ptr;
   }
   if (newlen == 0) {
-    a_delete ptr;
+    delete ptr;
     *sizep = 0;
     return 0;
   }
@@ -73,7 +76,7 @@
     char *p = new char*sizep = newlen*2;
     if (oldlen < newlen && oldlen != 0)
       memcpy(p, ptr, oldlen);
-    a_delete ptr;
+    delete ptr;
     return p;
   }
 }
@@ -273,7 +276,7 @@
 
 int string::search(char c) const
 {
-  char *p = ptr ? (char *)memchr(ptr, c, len) : NULL;
+  char *p = ptr ? (char *)memchr(ptr, c, len) : 0;
   return p ? p - ptr : -1;
 }
 
@@ -289,11 +292,13 @@
     if (pi == '\0')
       nnuls++;
   char *q =(char*)malloc(n + 1 - nnuls);
-  char *r = q;
-  for (i = 0; i < n; i++)
-    if (pi != '\0')
-      *r++ = pi;
-  *r = '\0';
+  if (q != 0 /* nullptr */) {
+    char *r = q;
+    for (i = 0; i < n; i++)
+      if (pi != '\0')
+	*r++ = pi;
+    *r = '\0';
+  }
   return q;
 }
 
@@ -313,13 +318,13 @@
       len = l + 1;
       char *tmp = new charsz;
       memcpy(tmp, p, len);
-      a_delete ptr;
+      delete ptr;
       ptr = tmp;
     }
     else {
       len = 0;
       if (ptr) {
-	a_delete ptr;
+	delete ptr;
 	ptr = 0;
 	sz = 0;
       }
@@ -342,3 +347,8 @@
   return string(buf);
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/strncasecmp.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/strncasecmp.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/strsave.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/strsave.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/strtol.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/strtol.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/symbol.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/symbol.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/tmpfile.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/tmpfile.cpp Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -64,22 +64,22 @@
   const char *tem;
   // using the first match for any of the environment specs in listed order.
   if (
-      (tem = getenv(GROFF_TMPDIR_ENVVAR)) == NULL
-      && (tem = getenv(TMPDIR_ENVVAR)) == NULL
+      (tem = getenv(GROFF_TMPDIR_ENVVAR)) == 0
+      && (tem = getenv(TMPDIR_ENVVAR)) == 0
 #if defined(__MSDOS__) || defined(_WIN32)
       // If we didn't find a match for either of the above
       // (which are preferred, regardless of the host operating system),
       // and we are hosted on either MS-Windows or MS-DOS,
       // then try the Microsoft conventions.
-      && (tem = getenv(WIN32_TMPDIR_ENVVAR)) == NULL
-      && (tem = getenv(MSDOS_TMPDIR_ENVVAR)) == NULL
+      && (tem = getenv(WIN32_TMPDIR_ENVVAR)) == 0
+      && (tem = getenv(MSDOS_TMPDIR_ENVVAR)) == 0
 #endif
      )
     // If we didn't find an environment spec fall back to this default.
     tem = DEFAULT_TMPDIR;
   size_t tem_len = strlen(tem);
   const char *tem_end = tem + tem_len - 1;
-  int need_slash = strchr(DIR_SEPS, *tem_end) == NULL ? 1 : 0;
+  int need_slash = (strchr(DIR_SEPS, *tem_end) == 0) ? 1 : 0;
   char *tem2 = new chartem_len + need_slash + 1;
   strcpy(tem2, tem);
   if (need_slash)
@@ -93,12 +93,12 @@
   tmpfile_prefix = new chartmpfile_prefix_len + 1;
   strcpy(tmpfile_prefix, tem2);
   strcat(tmpfile_prefix, tem3);
-  a_delete tem2;
+  delete tem2;
 }
 
 temp_init::~temp_init()
 {
-  a_delete tmpfile_prefix;
+  delete tmpfile_prefix;
 }
 
 /*
@@ -149,7 +149,7 @@
       error("cannot unlink '%1': %2", x->fname, strerror(errno));
     xtmpfile_list *tmp = x;
     x = x->next;
-    a_delete tmp->fname;
+    delete tmp->fname;
     delete tmp;
   }
 }
@@ -183,6 +183,6 @@
   if (namep)
     *namep = templ;
   else
-    a_delete templ;
+    delete templ;
   return fp;
 }

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/tmpname.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/tmpname.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/unicode.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/unicode.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/uniglyph.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/uniglyph.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libgroff/uniuni.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libgroff/uniuni.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libxutil/DviChar.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libxutil/DviChar.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libxutil/XFontName.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libxutil/XFontName.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libxutil/libxutil.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libxutil/libxutil.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/libs/libxutil/xmalloc.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/libs/libxutil/xmalloc.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/box.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/box.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,8 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#include <assert.h>
+
 #include "eqn.h"
 #include "pbox.h"
 
@@ -203,19 +204,19 @@
 
 void set_gfont(const char *s)
 {
-  a_delete gfont;
+  delete gfont;
   gfont = strsave(s);
 }
 
 void set_grfont(const char *s)
 {
-  a_delete grfont;
+  delete grfont;
   grfont = strsave(s);
 }
 
 void set_gbfont(const char *s)
 {
-  a_delete gbfont;
+  delete gbfont;
   gbfont = strsave(s);
 }
 
@@ -457,7 +458,7 @@
     maxlen *= 2;
     p = new box*maxlen;
     memcpy(p, oldp, sizeof(box*)*len);
-    a_delete oldp;
+    delete oldp;
   }
   plen++ = pp;
 }
@@ -466,7 +467,7 @@
 {
   for (int i = 0; i < len; i++)
     delete pi;
-  a_delete p;
+  delete p;
 }
 
 void box_list::list_check_tabs(int level)
@@ -642,3 +643,9 @@
 {
   fprintf(stderr, "<tab>");
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/box.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/box.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/delim.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/delim.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +16,8 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#include <assert.h>
+
 #include "eqn.h"
 #include "pbox.h"
 
@@ -176,11 +177,11 @@
 box *make_delim_box(char *l, box *pp, char *r)
 {
   if (l != 0 && *l == '\0') {
-    a_delete l;
+    delete l;
     l = 0;
   }
   if (r != 0 && *r == '\0') {
-    a_delete r;
+    delete r;
     r = 0;
   }
   return new delim_box(l, pp, r);
@@ -193,8 +194,8 @@
 
 delim_box::~delim_box()
 {
-  a_delete left;
-  a_delete right;
+  delete left;
+  delete right;
   delete p;
 }
 
@@ -314,9 +315,14 @@
 	 "\\{",
 	 current_roman_font, d->small, axis_height,
 	 current_roman_font, d->small);
-	 
+
   char buf256;
+// The format string in the sprintf below comes from a struct
+// initializer above, and is not subject to external influence.
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wformat-nonliteral"
   sprintf(buf, d->chain_format, "\\\\n" INDEX_REG "");
+#pragma GCC diagnostic pop
   printf(".nr " INDEX_REG " 0\n"
 	 ".de " TEMP_MACRO "\n"
 	 ".ie c%s \\{\\\n"
@@ -405,3 +411,8 @@
     fprintf(stderr, " right \"%s\"", right);
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.1.man Changed

@@ -1,19 +1,16 @@
-'\" t
-.TH @G@EQN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@eqn \- format equations for troff or MathML
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr eqn_C \n.C
-.cp 0
+'\" et
+.TH @g@eqn @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@eqn \- format mathematics (equations) for
+.I groff
+or MathML
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -31,6 +28,26 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_eqn_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .ie \n(.V<\n(.v \
 .  ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
 .el \
@@ -38,450 +55,593 @@
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@eqn
-.OP \-rvCNR
-.OP \-d xy
-.OP \-T name
-.OP \-M dir
-.OP \-f F
-.OP \-s n
-.OP \-p n
-.OP \-m n
-.RI  file
-\&.\|.\|.\&
+.RB  \-CNrR 
+.RB  \- d
+.IR xy 
+.RB  \-f
+.IR F 
+.RB  \-m
+.IR n 
+.RB  \-M
+.IR dir 
+.RB  \-p
+.IR n 
+.RB  \-s
+.IR n 
+.RB  \-T
+.IR dev 
+.RI  file\~ .\|.\|.
 .YS
 .
 .
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
+.SY @g@eqn
+.B \-\-help
+.YS
 .
-This manual page describes the GNU version of
-.BR eqn ,
-which is part of the groff document formatting system.
 .
-.B eqn
-compiles descriptions of equations embedded within
-.B troff
-input files into commands that are understood by
-.BR troff .
+.SY @g@eqn
+.B \-v
 .
-Normally, it should be invoked using the
-.B \-e
-option of
-.BR groff .
+.SY @g@eqn
+.B \-\-version
+.YS
 .
-The syntax is quite compatible with Unix eqn.
 .
-The output of GNU
-.B eqn
-cannot be processed with Unix troff;
-it must be processed with GNU troff.
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
+.
+The GNU implementation of
+.I eqn \" GNU
+is part of the
+.MR groff @MAN7EXT@
+document formatting system.
+.
+.I @g@eqn
+is a
+.MR @g@troff @MAN1EXT@
+preprocessor that translates expressions in its own language,
+embedded in
+.MR roff @MAN7EXT@
+input files,
+into mathematical notation typeset by
+.MR @g@troff @MAN1EXT@ .
+.
+It copies each
+.IR file 's
+contents to the standard output stream,
+translating each
+.I equation
+between lines starting with
+.B .EQ
+and
+.BR .EN ,
+or within a pair of user-specified delimiters.
 .
-If no files are given on the command line, the standard input is read.
+Normally,
+.I @g@eqn
+is not executed directly by the user,
+but invoked by specifying the
+.B \-e
+option to
+.MR groff @MAN1EXT@ .
+.
+While GNU
+.IR eqn 's \" GNU
+input syntax is highly compatible with AT&T
+.IR eqn , \" AT&T
+the output
+.I @g@eqn
+produces cannot be processed by AT&T
+.IR troff ; \" AT&T
+GNU
+.I troff \" GNU
+(or a
+.I troff \" generic
+implementing relevant GNU extensions)
+must be used.
 .
-A filename of
-.B \-
-causes the standard input to be read.
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I @g@eqn
+reads the standard input stream.
 .
 .
-.LP
-.B eqn
+.P
+Unless the
+.B \-R
+option is used,
+.I @g@eqn
 searches for the file
 .I eqnrc
 in the directories given with the
 .B \-M
-option first, then in
-.IR @SYSTEMMACRODIR@ ,
+option first,
+then in
+.if !'@COMPATIBILITY_WRAPPERS@'no' .IR @SYSTEMMACRODIR@ ,
 .IR @LOCALMACRODIR@ ,
 and finally in the standard macro directory
 .IR @MACRODIR@ .
 .
-If it exists,
-.B eqn
-processes it before the other input files.
+If it exists and is readable,
+.I @g@eqn
+processes it before any input files.
 .
-The
-.B \-R
-option prevents this.
+.
+.P
+This man page primarily discusses the differences between GNU
+.I eqn \" GNU
+and AT&T
+.IR eqn .\" AT&T
+.
+Most of the new features of the GNU
+.I eqn \" GNU
+input language are based on \*tx.
+.
+There are some references to the differences between \*tx and GNU
+.I eqn \" GNU
+below;
+these may safely be ignored if you do not know \*tx.
 .
 .
-.LP
+.P
+Three points are worth special note. \" good, bad, and different
+.
+.
+.IP \bu 2n
 GNU
-.B eqn
-does not provide the functionality of neqn:
-it does not support low-resolution, typewriter-like devices
-(although it may work adequately for very simple input).
+.I eqn \" GNU
+emits Presentation MathML output when invoked with the
+.RB \lq "\-T\~MathML" \rq
+option.
 .
 .
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
+.IP \bu
+GNU
+.I eqn \" GNU
+does not support terminal devices well,
+though it may suffice for simple inputs.
 .
-Whitespace is permitted between a command-line option and its argument.
 .
+.IP \bu
+GNU
+.I eqn
+sets the input token
+.RB \lq .\|.\|.\& \rq
+as an ellipsis on the text baseline,
+not the three centered dots of AT&T
+.IR eqn . \" AT&T
 .
-.TP
-.BI \-d xy
-Specify delimiters
-.I x
-and\~\c
-.I y
-for the left and right end, respectively, of in-line equations.
+Set an ellipsis on the math axis with the GNU extension macro
+.BR cdots .
 .
-Any
-.B delim
-statements in the source file overrides this.
 .
-.TP
-.B \-C
-Recognize
-.B .EQ
-and
-.B .EN
-even when followed by a character other than space or newline.
+.\" ====================================================================
+.SS "Anatomy of an equation"
+.\" ====================================================================
 .
-Also, the statement
-.RB \oq "delim on" \cq
-is not handled specially.
+.I eqn
+input consists of tokens.
 .
-.TP
-.B \-N
-Don't allow newlines within delimiters.
+Consider a form of Newton's second law of motion.
 .
-This option allows
-.B eqn
-to recover better from missing closing delimiters.
+The input
 .
-.TP
-.B \-v
-Print the version number.
 .
-.TP
-.B \-r
-Only one size reduction.
+.P
+.RS
+.EX
+\&.EQ
+F =
+m a
+\&.EN
+.EE
+.RE
 .
-.TP
-.BI \-m n
-The minimum point-size is\~\c
-.IR n .
 .
-.B eqn
-does not reduce the size of subscripts or superscripts to
-a smaller size than\~\c
-.IR n .
+.P
+becomes
+.EQ
+F =
+m a.
+.EN
 .
-.TP
-.BI \-T name
-The output is for device
-.IR name .
+Each of
+.BR F ,
+.BR = ,
+.BR m ,
+and
+.B a
+is a token.
 .
-Normally, the only effect of this is to define a macro
-.I name
-with a value of\~\c
-.BR 1 ;
-.I eqnrc
-uses this to provide definitions appropriate for the output device.
 .
-However, if the specified device is \lqMathML\rq, the output is
-MathML markup rather than troff commands, and
-.I eqnrc
-is not loaded at all.
+Spaces and newlines are interchangeable;
+they separate tokens but do not break lines or produce space in
+the output.
 .
-The default output device is
-.BR @DEVICE@ .
 .
-.TP
-.BI \-M dir
-Search
-.I dir
-for
-.I eqnrc
-before the default directories.
+.P
+The following input characters not only separate tokens,
+but manage their grouping and spacing as well.
 .
-.TP
-.B \-R
-Don't load
-.IR eqnrc .
 .
 .TP
-.BI \-f F
-This is equivalent to a
-.BI gfont\  F
-command.
+.B "{ }"
+Braces perform grouping.
 .
-.TP
-.BI \-s n
-This is equivalent to a
-.BI gsize\  n
-command.
+Whereas
+.RB \lq "e sup a b" \rq
+expresses
+.ie n .RI \lq( e "\~to the\~" a )\~times\~ b \rq,
+.el \{\
+.EQ
+e sup a b ,
+.EN
+.\}
+.RB \lq "e sup { a b }" \rq
+means
+.ie n .RI \lq e "\~to the\~(" a \~times\~ b )\rq.
+.el \{\
+.EQ
+e sup { a b } .
+.EN
+.\}
 .
-This option is deprecated.
-.B eqn
-normally sets equations at whatever the current point size
-is when the equation is encountered.
+When immediately preceded by a
+.RB \lq left \rq
+or
+.RB \lq right \rq
+primitive,
+a brace loses its special meaning.
 .
-.TP
-.BI \-p n
-This says that subscripts and superscripts should be
-.IR n \~points
-smaller than the surrounding text.
 .
-This option is deprecated.
+.TP
+.B "\ha \ti
+are the
+.I "half space"
+and
+.I "full space,"
+respectively.
 .
-Normally
-.B eqn
-sets subscripts and superscripts at 70% of the size of the surrounding
-text.
+Use them to tune the appearance of the output.
 .
 .
-.\" ====================================================================
-.SH USAGE
-.\" ====================================================================
+.P
+Tab and leader characters separate tokens as well as advancing the
+drawing position to the next tab stop,
+but are seldom used in
+.I eqn
+input.
 .
-Only the differences between GNU
-.B eqn
-and Unix eqn are described here.
+When they occur,
+they must appear at the outermost lexical scope.
 .
+This roughly means that they can't appear within braces that are
+necessary to disambiguate the input;
+.I @g@eqn
+will diagnose an error in this event.
 .
-.LP
-GNU
-.B eqn
-emits Presentation MathML output when invoked with the
-.B "-T\~MathML"
-option.
+(See subsection \lqMacros\rq below for additional token separation
+rules.)
 .
 .
-.LP
-GNU eqn sets the input token
-.B \&"..."
-as three periods or low dots, rather than the three centered dots of
-classic eqn.  To get three centered dots, write
-.B "cdots"
-or
-.BR "cdot cdot cdot".
+.P
+Other tokens are primitives,
+macros,
+an argument to either of the foregoing,
+or components of an equation.
 .
 .
-.LP
-Most of the new features of the GNU
-.B eqn
-input language are based on \*(tx.
+.br
+.ne 4v
+.P
+.I Primitives
+are fundamental keywords of the
+.I eqn
+language.
+.
+They can configure an aspect of the preprocessor's state,
+as when setting a \lqglobal\rq font selection or type size
+.RB ( gfont
+and
+.BR gsize ),
+or declaring or deleting macros
+.RB \%(\lq define \rq
+and
+.BR undef );
+these are termed
+.I commands.
+.
+Other primitives perform formatting operations on the tokens after them
+(as with
+.BR fat ,
+.BR over ,
+.BR sqrt ,
+or
+.BR up ).
 .
-There are some references to the differences between \*(tx and GNU
-.B eqn
-below;
-these may safely be ignored if you do not know \*(tx.
 .
+.P
+Equation
+.I components
+include mathematical variables,
+constants,
+numeric literals,
+and operators.
 .
-.\" ====================================================================
-.SS Controlling delimiters
-.\" ====================================================================
+.I @g@eqn
+remaps some input character sequences to
+.I groff
+special character escape sequences for economy in equation entry and to
+ensure that glyphs from an unstyled font are used;
+see
+.MR groff_char @MAN7EXT@ .
 .
-If not in compatibility mode,
-.B eqn
-recognizes
 .
+.P
 .RS
-.LP
-.B delim on
+.TS
+tab(@);
+Lf(CR) Lf(CR) Lw(1i) Lf(CR) Lf(CR).
++@\rspl@\&@\aq@\rsfm
+-@\rsmi@\&@<=@\rs<=
+\&=@\rseq@\&@>=@\rs>=
+.TE
 .RE
 .
-.LP
-to restore the delimiters which have been previously disabled
-with a call to
-.RB \oq "delim off" \cq.
 .
-If delimiters haven't been specified, the call has no effect.
+.P
+.I Macros
+permit primitives,
+components,
+and other macros to be collected and referred to by a single token.
+.
+Predefined macros make convenient the preparation of
+.I eqn
+input in a form resembling its spoken expression;
+for example,
+consider
+.BR cos ,
+.BR hat ,
+.BR inf ,
+and
+.BR lim .
 .
 .
 .\" ====================================================================
-.SS Automatic spacing
+.SS "Spacing and typeface"
 .\" ====================================================================
 .
-.B eqn
-gives each component of an equation a type, and adjusts the spacing
-between components using that type.
+GNU
+.I eqn
+imputes types to the components of an equation,
+adjusting the spacing between them accordingly.
 .
-Possible types are described in the table below.
+Recognized types are as follows;
+most affect spacing only,
+whereas the
+.RB \%\lq letter \rq
+subtype of
+.RB \%\lq ordinary \rq
+also assigns a style.
 .
 .
+.RS 2n \" we need quite a bit of horizontal space for this table
+.P
 .TS
-lB l.
+Lf(CR) Lx
+Af(CR) Lx
+Af(CR) Lx
+Lf(CR) Lx.
 ordinary	T{
-an ordinary character such as \oq1\cq or
-.RI \oq x \cq
+character such as \lq1\rq,
+\lqa\rq,
+or
+\lq!\&\rq
 T}
+letter	character to be italicized by default
+digit	\fIn/a\f
 operator	T{
-a large operator such as
-.ds Su \oq\s+5\(*S\s0\cq
-.if \n(.g .if !c\(*S .ds Su the summation operator
-\*(Su
+large operator such as
+.ds Su \lq\s+5\*S\s0\rq
+.if \n(.g .if !c\*S .ds Su the summation operator
+\*Su
+.rm Su
 T}
-binary	a binary operator such as \oq\pl\cq
-relation	a relation such as \oq=\cq
-opening	a opening bracket such as \oq(\cq
-closing	a closing bracket such as \oq)\cq
-punctuation	a punctuation character such as \oq,\cq
-inner	a subformula contained within brackets
-suppress	a type that suppresses automatic spacing adjustment
+binary	binary operator such as \lq\pl\rq
+relation	relational operator such as \lq=\rq
+opening	opening bracket such as \lq(\rq
+closing	closing bracket such as \lq)\rq
+punctuation	punctuation character such as \lq,\rq
+inner	sub-formula contained within brackets
+suppress	component to which automatic spacing is not applied
 .TE
+.RE
 .
 .
-.LP
-Components of an equation
-get a type in one of two ways.
-.
-.TP
-.BI type\  t\ e
-This yields an equation component that contains\~\c
-.I e
-but that has type\~\c
-.IR t ,
-where
-.I t
-is one of the types mentioned above.
+.P
+Two primitives apply types to equation components.
 .
-For example,
-.B times
-is defined as
 .
-.RS
-.IP
-.B
-type "binary" \e(mu
-.RE
+.TP
+.BI type\~ "t e"
+Apply
+.RI type\~ t
+to
+.RI expression\~ e .
 .
-.IP
-The name of the type doesn't have to be quoted, but quoting protects
-from macro expansion.
 .
 .TP
-.BI chartype\  t\ text
-Unquoted groups of characters are split up into individual characters,
-and the type of each character is looked up;
-this changes the type that is stored for each character;
-it says that the characters in
+.BI chartype\~ "t text"
+Assign each character in (unquoted)
 .I text
-from now on have type\~\c
-.IR t .
-For example,
+.RI type\~ t ,
+persistently.
+.
+.
+.P
+.I @g@eqn \" GNU
+sets up spacings and styles as if by the following commands.
 .
+.P
 .RS
-.IP
-.B
-chartype "punctuation" .,;:
+.TS
+tab(@);
+Lf(CR)1 Lf(CR).
+chartype \dqletter\dq@abcdefghiklmnopqrstuvwxyz
+chartype \dqletter\dq@ABCDEFGHIKLMNOPQRSTUVWXYZ
+chartype \dqletter\dq@\rs*a\rs*b\rs*g\rs*d\rs*e\
+\rs*z
+chartype \dqletter\dq@\rs*y\rs*h\rs*i\rs*k\rs*l\
+\rs*m
+chartype \dqletter\dq@\rs*n\rs*c\rs*o\rs*p\rs*r\
+\rs*s
+chartype \dqletter\dq@\rs*t\rs*u\rs*f\rs*x\rs*q\
+\rs*w
+chartype \dqbinary\dq@*\rspl\rsmi
+chartype \dqrelation\dq@<>\rseq\rs<=\rs>=
+chartype \dqopening\dq@{(
+chartype \dqclosing\dq@})
+chartype \dqpunctuation\dq@,;:.
+chartype \dqsuppress\dq@\ha\ti
+.TE
 .RE
 .
-.IP
-would make the characters \oq.,;:\cq have type punctuation
-whenever they subsequently appeared in an equation.
 .
-The type\~\c
-.I t
-can also be
-.B letter
-or
-.BR digit ;
-in these cases
-.B chartype
-changes the font type of the characters.
+.P
+.I @g@eqn
+assigns all other ordinary and special
+.I roff
+characters,
+including numerals 0\en9,
+the
+.RB \%\lq ordinary \rq
+type.
 .
-See subsection \lqFonts\rq below.
+(The
+.RB \lq digit \rq
+type is not used,
+but is available for customization.)
+.\" XXX: How would you actually customize it, though?  There doesn't
+.\" seem to be a means of replacing the font associated with a type.
+.\" Is the "digit" type just cruft?
+.
+In keeping with common practice in mathematical typesetting,
+lowercase,
+but not uppercase,
+Greek letters are assigned the
+.RB \%\lq letter \rq
+type to style them in italics.
+.
+The macros for producing ellipses,
+.RB \lq .\|.\|. \rq,
+.BR cdots ,
+and
+.BR ldots ,
+use the
+.RB \%\lq inner \rq
+type.
 .
 .
 .\" ====================================================================
-.SS New primitives
+.SS Primitives
 .\" ====================================================================
 .
-.TP
-.BI big\  e
-Enlarges the expression it modifies; intended to have semantics like
-CSS \oqlarge\cq.
-.
-In troff output, the point size is increased by\~5; in MathML output,
-the expression uses
-.
-.RS
-.IP
-.EX
-<mstyle \%mathsize='big'>
-.EE
-.RE
-.
-.TP
-.IB e1\  smallover\  e2
-This is similar to
-.BR over ;
-.B smallover
-reduces the size of
-.I e1
+.I @g@eqn
+supports without alteration the AT&T
+.I eqn \" AT&T
+primitives
+.BR above ,
+.BR back ,
+.BR bar ,
+.BR bold ,
+.BR \%define ,
+.BR down ,
+.BR fat ,
+.BR font ,
+.BR from ,
+.BR fwd ,
+.BR gfont ,
+.BR gsize ,
+.BR italic ,
+.BR left ,
+.BR lineup ,
+.BR mark ,
+.BR \%matrix ,
+.BR \%ndefine ,
+.BR over ,
+.BR right ,
+.BR roman ,
+.BR size ,
+.BR sqrt ,
+.BR sub ,
+.BR sup ,
+.BR \%tdefine ,
+.BR to ,
+.BR \%under ,
 and
-.IR e2 ;
-it also puts less vertical space between
-.I e1
-or
-.I e2
-and the fraction bar.
-.
-The
-.B over
-primitive corresponds to the \*(tx
-.B \eover
-primitive in display styles;
-.B smallover
-corresponds to
-.B \eover
-in non-display styles.
+.BR up .
 .
-.TP
-.BI vcenter\  e
-This vertically centers
-.I e
-about the math axis.
 .
-The math axis is the vertical position about which characters such as
-\oq\pl\cq and \oq\mi\cq are centered; also it is the
-vertical position used for the bar of fractions.
+.\" ====================================================================
+.SS "New primitives"
+.\" ====================================================================
 .
-For example,
-.B sum
-is defined as
+The GNU extension primitives
+.RB \lq type \rq
+and
+.B \%chartype
+are discussed in subsection \lqSpacing and typeface\rq above;
+.RB \lq set \rq
+in subsection \lqCustomization\rq below;
+and
+.B grfont
+and
+.B gbfont
+in subsection \lqFonts\rq below.
 .
-.RS
-.IP
-.B
-{ type "operator" vcenter size +5 \e(*S }
-.RE
+In the following synopses,
+.I X
+can be any character not appearing in the parameter thus bracketed.
 .
-.IP
-(Note that vcenter is silently ignored when generating MathML.)
 .
 .TP
-.IB e1\  accent\  e2
-This sets
+.IB e1 \~accent\~ e2
+Set
 .I e2
 as an accent over
 .IR e1 .
+.
 .I e2
-is assumed to be at the correct height for a lowercase letter;
-.I e2
-is moved down according to whether
-.I e1
-is taller or shorter than a lowercase letter.
+is assumed to be at the appropriate height for a lowercase letter
+without an ascender;
+.I @g@ eqn
+vertically shifts it depending on
+.IR e1 's
+height.
 .
 For example,
 .B hat
-is defined as
+is defined as follows.
+.
 .
 .RS
 .IP
-.B
-accent { "^" }
+.EX
+accent { "\ha" }
+.EE
 .RE
 .
+.
 .IP
 .BR dotdot ,
 .BR dot ,
@@ -490,273 +650,438 @@
 and
 .B dyad
 are also defined using the
-.B accent
+.B \%accent
 primitive.
 .
+.
 .TP
-.IB e1\  uaccent\  e2
-This sets
-.I e2
-as an accent under
-.IR e1 .
-.I e2
-is assumed to be at the correct height for a character without a descender;
-.I e2
-is moved down if
-.I e1
-has a descender.
+.BI big\~ e
+Enlarge the expression
+.IR e ;
+semantics like those of CSS \lqlarge\rq are intended.
 .
-.B utilde
-is pre-defined using
-.B uaccent
-as a tilde accent below the baseline.
+In
+.I @g@troff
+output,
+the type size is increased by\~5 scaled points.
+.
+MathML output emits the following.
 .
-.TP
-.BI split\ \dq text \dq
-This has the same effect as simply
 .
 .RS
 .IP
-.I text
+.EX
+<mstyle \%mathsize=\aqbig\aq>
+.EE
 .RE
 .
-.IP
-but
-.I text
-is not subject to macro expansion because it is quoted;
-.I text
-is split up and the spacing between individual characters is adjusted.
 .
 .TP
-.BI nosplit\  text
-This has the same effect as
+.BI copy\~ file
+.TQ
+.BI include\~ file
+Interpolate the contents of
+.IR file ,
+omitting lines
+beginning with
+.B .EQ
+or
+.BR .EN .
 .
-.RS
-.IP
-.BI \dq text \dq
-.RE
+If a relative path name,
+.I file
+is sought relative to the current working directory.
 .
-.IP
-but because
+.
+.TP
+.BI ifdef\~ "name X anything X"
+If
+.I name
+is defined as a primitive or macro,
+interpret
+.IR anything .
+.
+.
+.TP
+.BI nosplit\~ text
+As
+.RI \dq text \dq,
+but since
 .I text
 is not quoted it is subject to macro expansion;
-.I text
-is not split up
-and the spacing between individual characters is not adjusted.
+it is not split up and the spacing between characters not adjusted per
+subsection \lqSpacing and typeface\rq above.
+.
 .
 .TP
-.IB e\  opprime
-This is a variant of
-.B prime
-that acts as an operator on\~\c
-.IR e .
+.IB e\~ opprime
+As
+.BR prime ,
+but set the prime symbol as an operator
+.RI on\~ e .
 .
-It produces a different result from
-.B prime
-in a case such as
-.BR A\ opprime\ sub\ 1 :
-with
-.B opprime
-the\~\c
-.B 1
-is tucked under the prime as a subscript to the\~\c
-.B A
+In the input
+.RB \lq "A opprime sub 1" \rq,
+the\~\lq1\rq is tucked under the prime as a subscript to
+the\~\lqA\rq
 (as is conventional in mathematical typesetting),
-whereas with
+whereas when
 .B prime
-the\~\c
-.B 1
-is a subscript to the prime character.
+is used,
+the\~\lq1\rq is a subscript to the prime character.
 .
 The precedence of
-.B opprime
+.B \%opprime
 is the same as that of
 .B bar
 and
-.BR under ,
-which is higher than that of everything except
-.B accent
+.RB \%\lq under \rq,
+and higher than that of other primitives except
+.B \%accent
 and
 .BR uaccent .
 .
-In unquoted text a\~\c
-.B \aq
-that is not the first character is treated like
-.BR opprime .
+In unquoted text,
+a neutral apostrophe
+.RB ( \aq )
+that is not the first character on the input line is treated like
+.BR \%opprime .
+.
 .
 .TP
-.BI special\  text\ e
-This constructs a new object from\~\c
-.I e
-using a
-.BR @g@troff (@MAN1EXT@)
-macro named
-.IR text .
+.BI sdefine\~ "name X anything X"
+As
+.RB \%\lq define \rq,
+but
+.I name
+is not recognized as a macro if called with arguments.
+.
+.
+.TP
+.IB e1 \~smallover\~ e2
+As
+.BR over ,
+but reduces the type size of
+.I e1
+and
+.IR e2 ,
+and puts less vertical space between
+.I e1
+and
+.I e2
+and the fraction bar.
+.
+The
+.B over
+primitive corresponds to the \*tx
+.B \rsover
+primitive in displayed equation styles;
+.B smallover
+corresponds to
+.B \rsover
+in non-display (\lqinline\rq) styles.
+.
+.
+.br
+.ne 5v
+.TP
+.BI space\~ n
+Set extra vertical spacing around the equation,
+replacing the default values,
+where
+.IR n \~is
+an integer in hundredths of an em.
+.
+If positive,
+.IR n \~increases
+vertical spacing before the equation;
+if negative,
+it does so after the equation.
+.
+This primitive provides an interface to
+.IR groff 's
+.B \rsx
+escape sequence,
+but with the opposite sign convention.
+.
+It has no effect if the equation is part of a
+.MR @g@pic @MAN1EXT@
+picture.
 .
-When the macro is called,
-the string
+.
+.TP
+.BI special\~ "troff-macro e"
+Construct an object by calling
+.I troff-macro
+.RI on\~ e .
+.
+The
+.I troff \" generic
+string
 .B 0s
-contains the output for\~\c
-.IR e ,
-and the number registers
+contains the
+.I eqn \" generic
+output
+.RI for\~ e ,
+and the registers
 .BR 0w ,
 .BR 0h ,
 .BR 0d ,
 .BR 0skern ,
 and
 .B 0skew
-contain the width, height, depth, subscript kern, and skew of\~\c
-.IR e .
+the width,
+height,
+depth,
+subscript kern,
+and skew
+.RI of\~ e ,
+respectively.
 .
 (The
-.I "subscript kern"
-of an object says how much a subscript on that object should be tucked in;
-the
+.I subscript kern
+of an object indicates how much a subscript on that object should be
+\lqtucked in\rq,
+or placed to the left relative to a non-subscripted glyph of the same
+size.
+.
+The
 .I skew
-of an object says how far to the right of the center of the object an
-accent over the object should be placed.)
+of an object is how far to the right of the center of the object an
+accent over it should be placed.)
 .
 The macro must modify
 .B 0s
-so that it outputs the desired result with its origin at the current
-point, and increase the current horizontal position by the width
-of the object.
+so that it outputs the desired result,
+returns the drawing position to the text baseline at the beginning of
+.IR e ,
+and updates the foregoing registers to correspond to the new dimensions
+of the result.
 .
-The number registers must also be modified so that they correspond to the
-result.
 .
 .IP
-For example, suppose you wanted a construct that \oqcancels\cq an
-expression by drawing a diagonal line through it.
+Suppose you want a construct that \lqcancels\rq an expression by
+drawing a diagonal line through it.
 .
+.
+.br
+.ne 11v
 .RS
 .IP
-.ft B
-.if t .ne 6+\n(.Vu
-.br
-\&.EQ
-.br
-define cancel 'special Ca'
-.br
-\&.EN
-.br
+.EX
 \&.de Ca
-.br
-\&.\ \ ds 0s \e
-.br
-\eZ'\e\e*(0s'\e
-.br
-\ev'\e\en(0du'\e
-.br
-\eD'l \e\en(0wu -\e\en(0hu-\e\en(0du'\e
-.br
-\ev'\e\en(0hu'
-.br
+\&.  ds 0s \rs
+\rsZ\aq\rs\rs*(0s\aq\rs
+\rsv\aq\rs\rsn(0du\aq\rs
+\rsD\aql \rs\rsn(0wu \-\rs\rsn(0hu\-\rs\
+\rsn(0du\aq\rs
+\rsv\aq\rs\rsn(0hu\aq
 \&..
-.ft
+\&.EQ
+special Ca "x \rsmi 3 \rspl x" \ti 3
+\&.EN
+.EE
 .RE
 .
-.IP
-Then you could cancel an expression\~\c
-.I e
-with
-.BI \%cancel\ {\  e\  }
 .
 .IP
-Here's a more complicated construct that draws a box round an
-expression:
+We use the
+.B \rsmi
+and
+.B \rspl
+special characters instead of + and \-
+because they are part of the argument to a
+.I @g@troff
+macro,
+so
+.I @g@eqn
+does not transform them to mathematical glyphs for us.
+.
+Here's a more complicated construct that draws a box around an
+expression;
+the bottom of the box rests on the text baseline.
+.
+We define the
+.I eqn \" generic
+macro
+.B box
+to wrap the call of the
+.I @g@troff
+macro
+.BR Bx .
 .
+.
+.br
+.ne 17v
 .RS
 .IP
-.ft B
-.if t .ne 11+\n(.Vu
-\&.EQ
-.br
-define box 'special Bx'
-.br
-\&.EN
-.br
+.EX
 \&.de Bx
-.br
-\&.\ \ ds 0s \e
-.br
-\eZ'\eh'1n'\e\e*(0s'\e
-.br
-\eZ'\e
-.br
-\ev'\e\en(0du+1n'\e
-.br
-\eD'l \e\en(0wu+2n 0'\e
-.br
-\eD'l 0 -\e\en(0hu-\e\en(0du-2n'\e
-.br
-\eD'l -\e\en(0wu-2n 0'\e
-.br
-\eD'l 0 \e\en(0hu+\e\en(0du+2n'\e
-.br
-\&'\e
-.br
-\eh'\e\en(0wu+2n'
-.br
-\&.\ \ nr 0w +2n
-.br
-\&.\ \ nr 0d +1n
-.br
-\&.\ \ nr 0h +1n
-.br
+\&.ds 0s \rs
+\rsZ\aq\rs\rsh\aq1n\aq\rs\rs*0s\aq\rs
+\rsv\aq\rs\rsn(0du+1n\aq\rs
+\rsD\aql \rs\rsn(0wu+2n 0\aq\rs
+\rsD\aql 0 \-\rs\rsn(0hu\-\rs\rsn(0du\-2n\aq\rs
+\rsD\aql \-\rs\rsn(0wu\-2n 0\aq\rs
+\rsD\aql 0 \rs\rsn(0hu+\rs\rsn(0du+2n\aq\rs
+\rsh\aq\rs\rsn(0wu+2n\aq
+\&.nr 0w +2n
+\&.nr 0d +1n
+\&.nr 0h +1n
 \&..
-.ft
+\&.EQ
+define box \aq special Bx $1 \aq
+box(foo) \ti "bar"
+\&.EN
+.EE
 .RE
 .
+.
 .TP
-.BI space\  n
-A positive value of the integer\~\c
-.I n
-(in hundredths of an em) sets the vertical spacing before the
-equation, a negative value sets the spacing after the equation,
-replacing the default values.
+.BI "split \dq" text \dq
+As
+.IR text ,
+but since
+.I text
+is quoted,
+it is not subject to macro expansion;
+it is split up and the spacing between characters adjusted per
+subsection \lqSpacing and typeface\rq above.
+.
+.
+.TP
+.IB e1 \~uaccent\~ e2
+Set
+.I e2
+as an accent under
+.IR e1 .
+.
+.I e2
+is assumed to be at the appropriate height for a letter without a
+descender;
+.I @g@ eqn
+vertically shifts it depending on whether
+.I e1
+has a descender.
+.
+.B utilde
+is predefined using
+.B uaccent
+as a tilde accent below the baseline.
+.
+.
+.TP
+.BI undef\~ name
+Remove definition of macro or primitive
+.IR name ,
+making it undefined.
 .
-This primitive provides an interface to
-.BR groff 's
-.B \ex
-escape (but with opposite sign).
 .
+.TP
+.BI vcenter\~ e
+Vertically center
+.I e
+about the
+.IR "math axis" ,
+a horizontal line upon which fraction bars and characters such as
+\lq\pl\rq and \lq\mi\rq are aligned.
+.
+MathML already behaves this way,
+so
+.I @g@eqn
+ignores this primitive when producing that output format.
+.
+The built-in
+.B sum
+macro is defined as if by the following.
+.
+.RS
 .IP
-This keyword has no effect if the equation is part of a
-.B pic
-picture.
+.EX
+define sum ! { type "operator" vcenter size +5 \rs(*S } !
+.EE
+.RE
 .
 .
+.br
+.ne 8v
 .\" ====================================================================
-.SS Extended primitives
+.SS "Extended primitives"
 .\" ====================================================================
 .
+GNU
+.I eqn \" GNU
+extends the syntax of some AT&T
+.I eqn \" AT&T
+primitives,
+introducing one deliberate incompatibility.
+.
+.
+.TP
+.B "delim on"
+.I @g@eqn
+recognizes an
+.RB \lq on \rq
+argument to the
+.B \%delim
+primitive specially,
+restoring any delimiters previously disabled with
+.RB \%\lq "delim off" \rq.
+.
+If delimiters haven't been specified,
+neither command has effect.
+.
+Few
+.I eqn \" generic
+documents are expected to use \lqo\rq and \lqn\rq as left and
+right delimiters,
+respectively.
+.
+If yours does,
+consider swapping them,
+or select others.
+.
+.
 .TP
-.BI col\  n\  {\  .\|.\|.\  }
+.BI col\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI ccol\  n\  {\  .\|.\|.\  }
+.BI ccol\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI lcol\  n\  {\  .\|.\|.\  }
+.BI lcol\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI rcol\  n\  {\  .\|.\|.\  }
+.BI rcol\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI pile\  n\  {\  .\|.\|.\  }
+.BI pile\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI cpile\  n\  {\  .\|.\|.\  }
+.BI cpile\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI lpile\  n\  {\  .\|.\|.\  }
+.BI lpile\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
 .TQ
-.BI rpile\  n\  {\  .\|.\|.\  }
-The integer value\~\c
-.I n
-(in hundredths of an em) increases the vertical spacing between rows,
+.BI rpile\~ n\~\c
+.BR {\~ .\|.\|.\& \~}
+The integer
+.RI value\~ n
+(in hundredths of an em)
+increases the vertical spacing between rows,
 using
-.BR groff 's
-.B \ex
-escape (the value has no effect in MathML mode).
-Negative values are possible but have no effect.
-If there is more than a single value given in a matrix, the biggest one
-is used.
+.IR groff 's
+.B \rsx
+escape sequence
+(the value has no effect in MathML mode).
+.
+Negative values are accepted but have no effect.
+.
+If more than one
+.I n
+occurs in a matrix or pile,
+the largest is used.
 .
 .
 .\" ====================================================================
@@ -764,96 +1089,114 @@
 .\" ====================================================================
 .
 When
-.B eqn
-is generating troff markup, the appearance of equations is controlled
-by a large number of parameters.
+.I @g@eqn
+generates
+.I @g@troff
+input,
+the appearance of equations is controlled by a large number of
+parameters.
 .
-They have no effect when generating MathML mode, which pushes
-typesetting and fine motions downstream to a MathML rendering engine.
+They have no effect when generating MathML,
+which delegates typesetting to a MathML rendering engine.
 .
-These parameters can be set using the
+Configure these parameters with the
 .B set
-command.
+primitive.
+.
 .
 .TP
-.BI set\  p\ n
-This sets parameter\~\c
-.I p
-to value\~\c
-.IR n ;
+.BI set\~ "p n"
+assigns
+.RI parameter\~ p
+the integer
+.RI value\~ n ;
 .IR n \~is
-an integer.
+interpreted in units of hundredths of an em unless otherwise stated.
 .
 For example,
 .
+.
 .RS
 .IP
-.B
+.EX
 set x_height 45
+.EE
 .RE
 .
+.
 .IP
 says that
-.B eqn
-should assume an x\~height of 0.45\~ems.
+.I @g@eqn
+should assume that the font's x-height is 0.45\~ems.
 .
 .
 .RS
-.LP
-Possible parameters are as follows.
+.P
+Available parameters are as follows;
+defaults are shown in parentheses.
 .
-Values are in units of hundredths of an em unless otherwise stated.
+We intend these descriptions to be expository rather than rigorous.
 .
-These descriptions are intended to be expository rather than
-definitive.
 .
-.TP
+.TP 17n
 .B minimum_size
-.B eqn
-doesn't set anything at a smaller point-size than this.
+sets a floor for the type size
+(in scaled points)
+at which equations are set
+.RB ( 5 ).
 .
-The value is in points.
 .
 .TP
 .B fat_offset
 The
 .B fat
 primitive emboldens an equation by overprinting two copies of the
-equation horizontally offset by this amount.
+equation horizontally offset by this amount
+.RB ( 4 ).
 .
-This parameter is not used in MathML mode; instead, fat text uses
+In MathML mode,
+components to which
+.B \%fat_offset
+applies instead use the following.
 .
 .RS
-.IP
+.RS
 .EX
-<mstyle mathvariant='double-struck'>
+<mstyle mathvariant=\aqdouble\-struck\aq>
 .EE
 .RE
+.RE
+.
 .
 .TP
 .B over_hang
 A fraction bar is longer by twice this amount than
 the maximum of the widths of the numerator and denominator;
-in other words, it overhangs the numerator and
-denominator by at least this amount.
+in other words,
+it overhangs the numerator and denominator by at least this amount
+.RB ( 0 ).
+.
 .
 .TP
 .B accent_width
 When
 .B bar
 or
-.B under
+.B \%under
 is applied to a single character,
-the line is this long.
+the line is this long
+.RB ( 31 ).
 .
 Normally,
 .B bar
 or
-.B under
-produces a line whose length is the width of the object to which it applies;
+.B \%under
+produces a line whose length is the width of the object to which it
+applies;
 in the case of a single character,
 this tends to produce a line that looks too long.
 .
+.
 .TP
 .B delimiter_factor
 Extensible delimiters produced with the
@@ -862,7 +1205,9 @@
 .B right
 primitives have a combined height and depth of at least this many
 thousandths of twice the maximum amount by which the sub-equation that
-the delimiters enclose extends away from the axis.
+the delimiters enclose extends away from the axis
+.RB ( 900 ).
+.
 .
 .TP
 .B delimiter_shortfall
@@ -872,223 +1217,313 @@
 .B right
 primitives have a combined height and depth not less than the
 difference of twice the maximum amount by which the sub-equation that
-the delimiters enclose extends away from the axis and this amount.
+the delimiters enclose extends away from the axis and this amount
+.RB ( 50 ).
+.
 .
 .TP
 .B null_delimiter_space
-This much horizontal space is inserted on each side of a fraction.
+This much horizontal space is inserted on each side of a fraction
+.RB ( 12 ).
+.
 .
 .TP
 .B script_space
-The width of subscripts and superscripts is increased by this amount.
+The width of subscripts and superscripts is increased by this amount
+.RB ( 5 ).
+.
 .
 .TP
 .B thin_space
 This amount of space is automatically inserted after punctuation
 characters.
 .
+It also configures the width of the space produced by the
+.B \ha
+token
+.RB ( 17 ).
+.
+.
 .TP
 .B medium_space
 This amount of space is automatically inserted on either side of
-binary operators.
+binary operators
+.RB ( 22 ).
+.
 .
 .TP
 .B thick_space
 This amount of space is automatically inserted on either side of
 relations.
 .
+It also configures the width of the space produced by the
+.B \ti
+token
+.RB ( 28 ).
+.
+.
 .TP
 .B x_height
-The height of lowercase letters without ascenders such as \oqx\cq.
+The height of lowercase letters without ascenders such as \lqx\rq
+.RB ( 45 ).
+.
 .
 .TP
 .B axis_height
 The height above the baseline of the center of characters such as
-\oq\pl\cq and \oq\mi\cq.
+\lq\pl\rq and \lq\mi\rq
+.RB ( 26 ).
 .
 It is important that this value is correct for the font
 you are using.
 .
+.
 .TP
 .B default_rule_thickness
-This should set to the thickness of the
-.B \e(ru
-character, or the thickness of horizontal lines produced with the
-.B \eD
-escape sequence.
+This should be set to the thickness of the
+.B \rsru
+character,
+or the thickness of horizontal lines produced with the
+.B \rsD
+escape sequence
+.RB ( 4 ).
+.
 .
 .TP
 .B num1
 The
 .B over
-command shifts up the numerator by at least this amount.
+primitive shifts up the numerator by at least this amount
+.RB ( 70 ).
+.
 .
 .TP
 .B num2
 The
 .B smallover
-command shifts up the numerator by at least this amount.
+primitive shifts up the numerator by at least this amount
+.RB ( 36 ).
+.
 .
 .TP
 .B denom1
 The
 .B over
-command shifts down the denominator by at least this amount.
+primitive shifts down the denominator by at least this amount
+.RB ( 70 ).
+.
 .
 .TP
 .B denom2
 The
 .B smallover
-command shifts down the denominator by at least this amount.
+primitive shifts down the denominator by at least this amount
+.RB ( 36 ).
+.
 .
 .TP
 .B sup1
-Normally superscripts are shifted up by at least this amount.
+Normally superscripts are shifted up by at least this amount
+.RB ( 42 ).
+.
 .
 .TP
 .B sup2
 Superscripts within superscripts or upper limits
 or numerators of
 .B smallover
-fractions are shifted up by at least this amount.
+fractions are shifted up by at least this amount
+.RB ( 37 ).
+.
+Conventionally,
+this is less than
+.BR sup1 .
 .
-This is usually less than sup1.
 .
 .TP
 .B sup3
 Superscripts within denominators or square roots
 or subscripts or lower limits are shifted up by at least
-this amount.
+this amount
+.RB ( 28 ).
+.
+Conventionally,
+this is less than
+.BR sup2 .
 .
-This is usually less than sup2.
 .
 .TP
 .B sub1
-Subscripts are normally shifted down by at least this amount.
+Subscripts are normally shifted down by at least this amount
+.RB ( 20 ).
+.
 .
 .TP
 .B sub2
-When there is both a subscript and a superscript, the subscript is
-shifted down by at least this amount.
+When there is both a subscript and a superscript,
+the subscript is shifted down by at least this amount
+.RB ( 23 ).
+.
 .
 .TP
 .B sup_drop
-The baseline of a superscript is no more than this much amount below
-the top of the object on which the superscript is set.
+The baseline of a superscript is no more than this much below the top of
+the object on which the superscript is set
+.RB ( 38 ).
+.
 .
 .TP
 .B sub_drop
 The baseline of a subscript is at least this much below the bottom of
-the object on which the subscript is set.
+the object on which the subscript is set
+.RB ( 5 ).
+.
 .
 .TP
 .B big_op_spacing1
 The baseline of an upper limit is at least this much above the top of
-the object on which the limit is set.
+the object on which the limit is set
+.RB ( 11 ).
+.
 .
 .TP
 .B big_op_spacing2
 The baseline of a lower limit is at least this much below the bottom
-of the object on which the limit is set.
+of the object on which the limit is set
+.RB ( 17 ).
+.
 .
 .TP
 .B big_op_spacing3
 The bottom of an upper limit is at least this much above the top of
-the object on which the limit is set.
+the object on which the limit is set
+.RB ( 20 ).
+.
 .
 .TP
 .B big_op_spacing4
 The top of a lower limit is at least this much below the bottom of the
-object on which the limit is set.
+object on which the limit is set
+.RB ( 60 ).
+.
 .
 .TP
 .B big_op_spacing5
-This much vertical space is added above and below limits.
+This much vertical space is added above and below limits
+.RB ( 10 ).
+.
 .
 .TP
 .B baseline_sep
 The baselines of the rows in a pile or matrix are normally this far
-apart.
+apart
+.RB ( 140 ).
 .
-In most cases this should be equal to the sum of
+Usually equal to the sum of
 .B num1
 and
 .BR denom1 .
 .
+.
 .TP
 .B shift_down
 The midpoint between the top baseline and the bottom baseline in a
-matrix or pile is shifted down by this much from the axis.
+matrix or pile is shifted down by this much from the axis
+.RB ( 26 ).
 .
-In most cases this should be equal to
+Usually equal to
 .BR axis_height .
 .
+.
 .TP
 .B column_sep
-This much space is added between columns in a matrix.
+This much space is added between columns in a matrix
+.RB ( 100 ).
+.
 .
 .TP
 .B matrix_side_sep
-This much space is added at each side of a matrix.
+This much space is added at each side of a matrix
+.RB ( 17 ).
 .
+.
+.br
+.ne 4v
 .TP
 .B draw_lines
-If this is non-zero, lines are drawn using the
-.B \eD
-escape sequence, rather than with the
-.B \el
+If non-zero,
+.I @g@eqn
+draws lines using the
+.I troff \" generic
+.B \rsD
+escape sequence,
+rather than the
+.B \rsl
 escape sequence and the
-.B \e(ru
-character.
+.B \rsru
+special character.
+.
+The
+.I eqnrc
+file sets the default:
+.BR 1 \~on
+.BR ps ,
+.BR html ,
+and the X11 devices,
+.RB otherwise\~ 0 .
+.
 .
 .TP
 .B body_height
-The amount by which the height of the equation exceeds this is added
-as extra space before the line containing the equation (using
-.BR \ex ).
+is the presumed height of an equation above the text baseline;
+.I @g@eqn
+adds any excess as extra pre-vertical line spacing with
+.IR troff 's\" generic
+.B \rsx
+escape sequence
+.RB ( 85 ).
 .
-The default value is 85.
 .
 .TP
 .B body_depth
-The amount by which the depth of the equation exceeds this is added as
-extra space after the line containing the equation (using
-.BR \ex ).
+is the presumed depth of an equation below the text baseline;
+.I @g@eqn
+adds any excess as extra post-vertical line spacing with
+.IR troff 's\" generic
+.B \rsx
+escape sequence
+.RB ( 35 ).
 .
-The default value is 35.
 .
 .TP
 .B nroff
-If this is non-zero,
+If non-zero,
 then
-.B ndefine
+.B \%ndefine
 behaves like
-.B define
+.B \%define
 and
-.B tdefine
-is ignored, otherwise
-.B tdefine
+.B \%tdefine
+is ignored,
+otherwise
+.B \%tdefine
 behaves like
-.B define
+.B \%define
 and
-.B ndefine
+.B \%ndefine
 is ignored.
 .
-The default value is\~0 (This is typically changed to\~1 by the
+The
 .I eqnrc
-file for the
+file sets the default:
+.BR 1 \~on
 .BR ascii ,
 .BR latin1 ,
 .BR utf8 ,
 and
 .B cp1047
-devices.)
-.
-.
-.LP
-A more precise description of the role of many of these
-parameters can be found in Appendix\~H of
-.IR "The \*(txbook" .
+devices,
+.RB otherwise\~ 0 .
 .RE
 .
 .
@@ -1096,280 +1531,710 @@
 .SS Macros
 .\" ====================================================================
 .
-Macros can take arguments.
+In GNU
+.IR eqn , \" GNU
+macros can take arguments.
+.
+A word defined by any of the
+.BR \%define ,
+.BR \%ndefine ,
+or
+.B \%tdefine
+primitives followed immediately by a left parenthesis is treated as a
+.I "parameterized macro call:"
+subsequent tokens up to a matching right parenthesis are treated as
+comma-separated arguments.
+.
+In this context only,
+commas and parentheses also serve as token separators.
 .
-In a macro body,
-.BI $ n
+A macro argument is not terminated by a comma inside parentheses nested
+within it.
+.
+In a macro definition,
+.BI $ n\c
+,
 where
 .I n
-is between 1 and\~9, is replaced by the
+is between 1 and\~9 inclusive,
+is replaced by the
 .IR n th
-argument if the macro is called with arguments;
+argument;
 if there are fewer than
 .IR n \~arguments,
 it is replaced by nothing.
 .
-A word containing a left parenthesis where the part of the word
-before the left parenthesis has been defined using the
-.B define
-command is recognized as a macro call with arguments; characters
-following the left parenthesis up to a matching right parenthesis are
-treated as comma-separated arguments; commas inside nested parentheses
-do not terminate an argument.
+.
+.\" ====================================================================
+.SS "Predefined macros"
+.\" ====================================================================
+.
+GNU
+.I eqn \" GNU
+supports the predefined macros offered by AT&T
+.IR eqn : \" AT&T
+.BR and ,
+.BR \%approx ,
+.BR arc ,
+.BR cos ,
+.BR cosh ,
+.BR del ,
+.BR det ,
+.BR dot ,
+.BR \%dotdot ,
+.BR dyad ,
+.BR exp ,
+.BR for ,
+.BR grad ,
+.BR half ,
+.BR hat ,
+.BR if ,
+.BR \%inter ,
+.BR Im ,
+.BR inf ,
+.BR int ,
+.BR lim ,
+.BR ln ,
+.BR log ,
+.BR max ,
+.BR min ,
+.BR \%nothing ,
+.BR \%partial ,
+.BR prime ,
+.BR prod ,
+.BR Re ,
+.BR sin ,
+.BR sinh ,
+.BR sum ,
+.BR tan ,
+.BR tanh ,
+.BR tilde ,
+.BR times ,
+.BR union ,
+.BR vec ,
+.BR == ,
+.BR != ,
+.BR += ,
+.BR \-> ,
+.BR <\- ,
+.BR << ,
+.BR >> ,
+and
+.RB \lq .\|.\|. \rq.
+.
+The lowercase classical Greek letters are available as
+.BR \%alpha ,
+.BR beta ,
+.BR chi ,
+.BR delta ,
+.BR \%epsilon ,
+.BR eta ,
+.BR gamma ,
+.BR iota ,
+.BR kappa ,
+.BR lambda ,
+.BR mu ,
+.BR nu ,
+.BR omega ,
+.BR \%omicron ,
+.BR phi ,
+.BR pi ,
+.BR psi ,
+.BR rho ,
+.BR sigma ,
+.BR tau ,
+.BR theta ,
+.BR \%upsilon ,
+.BR xi ,
+and
+.BR zeta .
+.
+Spell them with an initial capital letter
+.RB \%( Alpha )
+or in full capitals
+.RB \%( ALPHA )
+to obtain uppercase forms.
+.
+.
+.P
+GNU
+.I eqn \" GNU
+further defines the macros
+.BR cdot ,
+.BR cdots ,
+and
+.B utilde
+(all discussed above),
+.BR \%dollar ,
+which sets a dollar sign,
+and
+.BR ldots ,
+which sets an ellipsis on the text baseline.
+.
+.
+.\" ====================================================================
+.SS Fonts
+.\" ====================================================================
+.
+.I @g@eqn
+uses up to three typefaces to set an equation:
+italic (oblique),
+roman (upright),
+and bold.
+.
+Assign each a
+.I groff
+typeface with the primitives
+.BR gfont ,
+.BR \%grfont ,
+and
+.B \%gbfont.
+.
+The defaults are the styles
+.BR I ,
+.BR R ,
+and
+.B B
+(applied to the current font family).
+.
+The
+.B \%chartype
+primitive
+(see above)
+sets a character's type,
+which determines the face used to set it.
+.
+The
+.RB \%\lq letter \rq
+type is set in italics;
+others are set in roman.
+.
+Use the
+.B bold
+primitive to select an (upright) bold style.
+.
 .
 .TP
-.BI sdefine\  name\ X\ anything\ X
-This is like the
-.B define
-command, but
-.I name
-is not recognized if called with arguments.
+.BI gbfont\~ f
+.RI Select\~ f
+as the bold font.
+.
+This is a GNU extension.
+.
 .
 .TP
-.BI include\ \dq file \dq
-.TQ
-.BI copy\ \dq file \dq
-Include the contents of
-.I file
-.RB ( include
+.BI gfont\~ f
+.RI Select\~ f
+as the italic font.
+.
+.
+.TP
+.BI grfont\~ f
+.RI Select\~ f
+as the roman font.
+.
+This is a GNU extension.
+.
+.
+.br
+.ne 4v
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
 and
-.B copy
-are synonyms).
+.B \-\-version
+show version information;
+all exit afterward.
 .
-Lines of
-.I file
-beginning with
+.
+.TP
+.B \-C
+Recognize
 .B .EQ
-or
+and
 .B .EN
-are ignored.
+even when followed by a character other than space or newline.
+.
 .
 .TP
-.BI ifdef\  name\ X\ anything\ X
-If
-.I name
-has been defined by
-.B define
-(or has been automatically defined because
-.I name
-is the output device) process
-.IR anything ;
-otherwise ignore
-.IR anything .
+.BI \-d\~ xy
+Specify delimiters
+.I x
+for left
+.RI and\~ y
+for right ends
+of equations not bracketed by
+.BR .EQ / .EN .
+.
+.I x
+and
+.I y
+need not be distinct.
+.
+Any
+.RB \%\lq delim
+.IR xy \rq
+statements in the source file override this option.
 .
-.I X
-can be any character not appearing in
-.IR anything .
 .
 .TP
-.BI undef\  name
-Remove definition of
-.IR name ,
-making it undefined.
+.BI \-f\~ F
+is equivalent to
+.RB \lq gfont
+.IR F \rq.
 .
 .
-.LP
-Besides the macros mentioned above, the following definitions are available:
-.BR Alpha ,
-.BR Beta ,
-\&.\|.\|.,
-.B Omega
-(this is the same as
-.BR ALPHA ,
-.BR BETA ,
-\&.\|.\|.,
-.BR OMEGA ),
-.B ldots
-(three dots on the base line), and
-.BR dollar .
+.TP
+.BI \-m\~ n
+is equivalent to
+.RB \lq "set \%minimum_size"
+.IR n \rq.
 .
 .
-.\" ====================================================================
-.SS Fonts
-.\" ====================================================================
+.TP
+.BI \-M\~ dir
+Search
+.I dir
+for
+.I eqnrc
+before those listed in section \lqDescription\rq above.
 .
-.B eqn
-normally uses at least two fonts to set an equation:
-an italic font for letters,
-and a roman font for everything else.
 .
-The existing
-.B gfont
-command
-changes the font that is used as the italic font.
+.TP
+.B \-N
+Prohibit newlines within delimiters.
+.
+This option allows
+.I @g@eqn
+to recover better from missing closing delimiters.
 .
-By default this is\~\c
-.BR I .
-The font that is used as the roman font can be changed using the new
-.B grfont
-command.
 .
 .TP
-.BI grfont\  f
-Set the roman font to\~\c
-.IR f .
+.BI \-p\~ n
+Set sub- and superscripts
+.IR n \~points
+smaller than the surrounding text.
 .
+This option is deprecated.
 .
-.LP
-The
-.B italic
-primitive uses the current italic font set by
-.BR gfont ;
-the
-.B roman
-primitive uses the current roman font set by
-.BR grfont .
+.I @g@eqn
+normally sets sub- and superscripts at 70% of the type size of the
+surrounding text.
 .
-There is also a new
-.B gbfont
-command, which changes the font used by the
-.B bold
-primitive.
 .
-If you only use the
-.BR roman ,
-.B italic
-and
-.B bold
-primitives to changes fonts within an equation, you can change all the
-fonts used by your equations just by using
-.BR gfont ,
-.B grfont
-and
-.B gbfont
-commands.
+.TP
+.B \-r
+Reduce the type size of subscripts at most once relative to the base
+type size for the equation.
+.
+.
+.TP
+.B \-R
+Don't load
+.IR eqnrc .
+.
+.
+.TP
+.BI \-s\~ n
+is equivalent to
+.RB \lq gsize
+.IR n \rq.
+.
+This option is deprecated.
 .
 .
-.LP
-You can control which characters are treated as letters
-(and therefore set in italics) by using the
-.B chartype
-command described above.
+.TP
+.BI \-T\~ dev
+Prepare output for the device
+.IR dev .
+.
+In most cases,
+the effect of this is to define a macro
+.I dev
+with a value
+.RB of\~ 1 ;
+.I eqnrc
+uses this to provide definitions appropriate for the device.
 .
-A type of
-.B letter
-causes a character to be set in italic type.
+However,
+if the specified driver is \lqMathML\rq,
+the output is MathML markup rather than
+.I @g@troff
+input,
+and
+.I eqnrc
+is not loaded at all.
 .
-A type of
-.B digit
-causes a character to be set in roman type.
+The default output device is
+.BR @DEVICE@ .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @MACRODIR@/eqnrc
+.I @MACRODIR@/\:\%eqnrc
 Initialization file.
 .
 .
 .\" ====================================================================
-.SH MATHML MODE LIMITATIONS
+.SH "MathML mode limitations"
 .\" ====================================================================
 .
 MathML is designed on the assumption that it cannot know the exact
 physical characteristics of the media and devices on which it will
 be rendered.
 .
-It does not support fine control of motions and sizes to the same
-degree troff does.
+It does not support control of motions and sizes to the same
+degree
+.I @g@troff
+does.
 .
-Thus:
 .
-.IP *
-.B eqn
-parameters have no effect on the generated MathML.
+.IP \bu 2n
+.I @g@eqn
+customization parameters have no effect on generated MathML.
 .
-.IP *
+.
+.IP \bu
 The
-.BR special ,
+.BR \%special ,
 .BR up ,
 .BR down ,
 .BR fwd ,
 and
 .B back
-operations cannot be implemented, and yield a MathML
-\oq<merror>\cq message instead.
+primitives cannot be implemented,
+and yield a MathML \%\lq<merror>\rq message instead.
+.
 .
-.IP *
+.IP \bu
 The
 .B vcenter
-keyword is silently ignored, as centering on the math axis is the
-MathML default.
-.
-.IP *
-Characters that
-.B eqn
-over troff sets extra large \(en notably the integral sign \(en may
-appear too small and need to have their \oq<mstyle>\cq wrappers
-adjusted by hand.
+primitive is silently ignored,
+as centering on the math axis is the MathML default.
 .
 .
-.LP
-As in its troff mode,
-.B eqn
+.IP \bu
+Characters that
+.I @g@eqn
+sets extra large in
+.I troff \" mode
+mode\emnotably the integral sign\emmay appear too small and need to
+have their \lq<mstyle>\rq wrappers adjusted by hand.
+.
+.
+.P
+As in its
+.I troff \" mode
+mode,
+.I @g@eqn
 in MathML mode leaves the
 .B .EQ
 and
 .B .EN
-delimiters in place for displayed equations, but emits no explicit
-delimiters around inline equations.
+tokens in place,
+but emits nothing corresponding to
+.B \%delim
+delimiters.
+.
+They can,
+however,
+be recognized as character sequences that begin with \lq<math>\rq,
+end with \lq</math>\rq,
+and do not cross line boundaries.
+.
+.
+.\" ====================================================================
+.SH Caveats
+.\" ====================================================================
+.
+Tokens must be double-quoted in
+.I eqn \" generic
+input if they are not to be recognized as names of macros or primitives,
+or if they are to be interpreted by
+.IR troff . \" generic
+.
+In particular,
+short ones,
+like
+.RB \lq pi \rq
+and
+.RB \lq PI \rq,
+can collide with
+.I troff \" generic
+identifiers.
 .
-They can, however, be recognized as strings that begin with
-\oq<math>\cq and end with \oq</math>\cq and do not cross line
-boundaries.
+For instance,
+the
+.I eqn \" generic
+command
+.RB \%\lq\^ "gfont PI" \^\rq
+does not select
+.IR groff 's
+Palatino italic font for the global italic face;
+you must use
+.RB \%\lq\^ "gfont \dqPI\dq" \^\rq
+instead.
+.
+.
+.P
+Delimited equations are set at the type size current at the beginning of
+the input line,
+not necessarily that immediately preceding the opening delimiter.
+.
+.
+.P
+Unlike \*tx,
+.I eqn \" generic
+does not inherently distinguish displayed and inline equation styles;
+see the
+.B smallover
+primitive above.
 .
+However,
+macro packages frequently define
+.B EQ
+and
+.B EN
+macros such that the equation within is displayed.
 .
-.LP
-See section \lqBugs\rq below for translation limits specific to
-.BR eqn .
+These macros may accept arguments permitting the equation to be labeled
+or captioned;
+see the package's documentation.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
 .
-Inline equations are set at the point size that is current at the
-beginning of the input line.
+.I eqn \" generic
+abuses terminology\emits
+\lqequations\rq
+can be inequalities,
+bare expressions,
+or unintelligible gibberish.
+.
+But there's no changing it now.
+.
+.
+.P
+In
+.I nroff \" mode
+mode,
+lowercase Greek letters are rendered in roman instead of italic style.
 .
 .
-.LP
-In MathML mode, the
+.P
+In MathML mode,
+the
 .B mark
 and
 .B lineup
 features don't work.
 .
-These could, in theory, be implemented with \oq<maligngroup>\cq
-elements.
+These could,
+in theory,
+be implemented with \%\lq<maligngroup>\rq elements.
+.
+.
+.P
+In MathML mode,
+each digit of a numeric literal gets a separate \lq<mn>\:</mn>\rq
+pair,
+and decimal points are tagged with \lq<mo>\:</mo>\rq.
+.
+This is allowed by the specification,
+but inefficient.
+.
+.
+.\" ====================================================================
+.SH Examples
+.\" ====================================================================
+.
+We first illustrate
+.I @g@eqn
+usage with a trigonometric identity.
+.
+.
+.RS
+.P
+.EX
+\&.EQ
+sin ( alpha + beta ) = sin alpha cos beta + cos alpha sin beta
+\&.EN
+.EE
+.if t \{\
+.
+.
+.P
+.RS
+.EQ
+sin ( alpha + beta ) = sin alpha cos beta + cos alpha sin beta
+.EN
+.RE
+.\}
+.RE
+.
+.
+.P
+It can be convenient to set up delimiters if mathematical content will
+appear frequently in running text.
+.
+.
+.RS
+.P
+.EX
+\&.EQ
+delim $$
+\&.EN
+.
+Having cached a table of logarithms,
+the property $ln ( x y ) = ln x + ln y$ sped calculations.
+.EE
+.if t \{\
+.
+.
+.P
+.RS
+.EQ
+delim $$
+.EN
+.
+Having cached a table of logarithms,
+the property $ln ( x y ) = ln x + ln y$ sped calculations.
+.
+.\" We _must_ shut delimiters back off when serially processing man
+.\" pages, or subsequent documents cannot safely use those characters.
+.EQ
+delim off
+.EN
+.RE
+.\}
+.RE
+.
+.
+.P
+The quadratic formula illustrates use of fractions and radicals,
+and affords an opportunity to use the full space token
+.BR \ti .
+.
+.
+.RS
+.P
+.EX
+\&.EQ
+x = { \- b \ti \rs+\- \ti sqrt { b sup 2 \- 4 a c } } \
+over { 2 a }
+\&.EN
+.EE
+.if t \{\
+.
+.
+.P
+.RS
+.EQ
+x = { - b ~ \+- ~ sqrt { b sup 2 - 4 a c } } over { 2 a }
+.EN
+.RE
+.\}
+.RE
+.
+.
+.P
+Alternatively,
+we could define the plus-minus sign as a binary operator.
+.
+Automatic spacing puts 0.06\~em less space on either side of the
+plus-minus than \ti does,
+this being the difference between the widths of the
+.B medium_space
+parameter used by binary operators and that of the full space.
+.
+Independently,
+we can define a macro \lqfrac\rq for setting fractions.
+.
 .
+.RS
+.P
+.EX
+\&.EQ
+chartype "binary" \rs+\-
+define frac ! { $1 } over { $2 } !
+x = frac(\- b \rs+\- sqrt { b sup 2 \- 4 a c }, 2 a)
+\&.EN
+.EE
+.if t \{\
 .
-.LP
-In MathML mode, each digit of a numeric literal gets a separate
-\oq<mn>\:</mn>\cq pair, and decimal points are tagged with
-\oq<mo>\:</mo>\cq.
 .
-This is allowed by the specification, but inefficient.
+.P
+.RS
+.EQ
+chartype "binary" \+-
+define frac ! { $1 } over { $2 } !
+x = frac(- b \+- sqrt { b sup 2 - 4 a c }, 2 a)
+.EN
+.RE
+.\}
+.RE
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR groff_font (@MAN5EXT@),
-.I The\ \*txbook
+\lqTypesetting Mathematics\emUser's Guide\rq
+(2nd edition),
+by Brian W.\& Kernighan
+and Lorinda L.\& Cherry,
+1978,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 17.
+.
+.
+.P
+.IR The\~\*txbook ,
+by Donald E.\& Knuth,
+1984,
+Addison-Wesley Professional.
+.
+Appendix\~G
+discusses many of the parameters from section \lqCustomization\rq
+above in greater detail.
+.
+.
+.P
+.MR groff_char @MAN7EXT@ ,
+particularly subsections \lqLogical symbols\rq,
+\lqMathematical symbols\rq,
+and \lqGreek glyphs\rq,
+documents a variety of special character escape sequences useful in
+mathematical typesetting.
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@
+.
 .
+.\" Clean up.
+.rm tx
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \neqn_C
+.cp \n*groff_eqn_1_man_C
+.do rr *groff_eqn_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" tab-width: 12
 .\" End:
-.\" vim: set filetype=groff tabstop=12:
+.\" vim: set filetype=groff tabstop=12 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.am Changed

@@ -1,16 +1,14 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -47,28 +45,35 @@
 PREFIXMAN1 += src/preproc/eqn/eqn.1 src/preproc/eqn/neqn.1
 EXTRA_DIST += \
   src/preproc/eqn/TODO \
-  src/preproc/eqn/neqn.sh \
   src/preproc/eqn/eqn.1.man \
-  src/preproc/eqn/neqn.1.man
+  src/preproc/eqn/neqn.1.man \
+  src/preproc/eqn/neqn.sh
 
+# Since eqn_CPPFLAGS was set, all .o files have an 'eqn-' prefix.
 src/preproc/eqn/eqn-lex.$(OBJEXT): src/preproc/eqn/eqn.hpp
-CLEANFILES += \
+
+MAINTAINERCLEANFILES += \
   src/preproc/eqn/eqn.hpp \
   src/preproc/eqn/eqn.cpp \
   src/preproc/eqn/eqn.output
 
 neqn: $(top_srcdir)/src/preproc/eqn/neqn.sh $(SH_DEPS_SED_SCRIPT)
-	$(AM_V_GEN)$(RM) $@ \
-	&& sed -e 's/@g@/$(g)/g' \
+	$(AM_V_GEN)sed -e 's/@g@/$(g)/g' \
 	       -f $(SH_DEPS_SED_SCRIPT) \
 	       -e $(SH_SCRIPT_SED_CMD) \
 	       $(top_srcdir)/src/preproc/eqn/neqn.sh \
-	       >$@ \
-	&& chmod +x $@
+	       >$@.tmp \
+	&& chmod +x $@.tmp \
+	&& mv $@.tmp $@
+
+eqn_TESTS = \
+  src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh
+TESTS += $(eqn_TESTS)
+EXTRA_DIST += $(eqn_TESTS)
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.hpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.hpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/eqn.ypp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/eqn.ypp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/lex.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/lex.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -258,7 +257,7 @@
   { "vec", "accent { vec_def }" },
   { "dyad_def", "up 52 size -5 { \\(<> }" },
   { "dyad", "accent { dyad_def }" },
-  { "...", "type \"inner\" vcenter { . . . }" },
+  { "...", "type \"inner\" { . . . }" },
 };
 
 /* equivalent definitions for MathML mode */
@@ -402,8 +401,9 @@
 
 file_input::~file_input()
 {
-  a_delete filename;
-  fclose(fp);
+  if (fclose(fp) < 0)
+    fatal("unable to close '%1': %2", filename, strerror(errno));
+  delete filename;
 }
 
 int file_input::read_line()
@@ -420,7 +420,7 @@
       }
       if (c == EOF)
 	break;
-      else if (invalid_input_char(c))
+      else if (is_invalid_input_char(c))
 	lex_error("invalid input character code %1", c);
       else {
 	line += char(c);
@@ -542,8 +542,8 @@
 argument_macro_input::~argument_macro_input()
 {
   for (int i = 0; i < argc; i++)
-    a_delete argvi;
-  a_delete s;
+    delete argvi;
+  delete s;
 }
 
 int argument_macro_input::get()
@@ -690,7 +690,7 @@
 
 void init_lex(const char *str, const char *filename, int lineno)
 {
- while (current_input != 0) {
+  while (current_input != 0) {
     input *tem = current_input;
     current_input = current_input->next;
     delete tem;
@@ -702,30 +702,36 @@
 
 void get_delimited_text()
 {
-  char *filename;
+  char *filename, *last_seen_filename;
   int lineno;
   int got_location = get_location(&filename, &lineno);
+  // `filename` gets invalidated if we iterate off the end of the file.
+  last_seen_filename = strdup(filename);
   int start = get_char();
   while (start == ' ' || start == '\t' || start == '\n')
     start = get_char();
   token_buffer.clear();
   if (start == EOF) {
+    current_lineno = 0;
     if (got_location)
-      error_with_file_and_line(filename, lineno,
+      error_with_file_and_line(last_seen_filename, lineno,
 			       "end of input while defining macro");
     else
       error("end of input while defining macro");
+    free(last_seen_filename);
     return;
   }
   for (;;) {
     int c = get_char();
     if (c == EOF) {
+      current_lineno = 0;
       if (got_location)
-	error_with_file_and_line(filename, lineno,
+	error_with_file_and_line(last_seen_filename, lineno,
 				 "end of input while defining macro");
       else
 	error("end of input while defining macro");
       add_context(start + token_buffer);
+      free(last_seen_filename);
       return;
     }
     if (c == start)
@@ -733,6 +739,7 @@
     token_buffer += char(c);
   }
   add_context(start + token_buffer + start);
+  free(last_seen_filename);
 }
 
 void interpolate_macro_with_args(const char *body)
@@ -1079,7 +1086,7 @@
       end_delim_saved = end_delim;
       start_delim = end_delim = '\0';
     }
-    else if (c == 'o' && d == 'n' && !compatible_flag) {
+    else if (c == 'o' && d == 'n') {
       start_delim = start_delim_saved;
       end_delim = end_delim_saved;
     }
@@ -1222,3 +1229,8 @@
   show_context();
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/limit.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/limit.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/list.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/list.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/main.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/main.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -47,20 +46,49 @@
 int xhtml = 0;
 eqnmode_t output_format;
 
-int read_line(FILE *fp, string *p)
+static const char *input_char_description(int c)
+{
+  switch (c) {
+  case '\001':
+    return "a leader character";
+  case '\n':
+    return "a newline character";
+  case '\b':
+    return "a backspace character";
+  case '\t':
+    return "a tab character";
+  case ' ':
+    return "a space character";
+  case '\177':
+    return "a delete character";
+  }
+  size_t bufsz = sizeof "character code " + INT_DIGITS + 1;
+  // repeat expression; no VLAs in ISO C++
+  static char bufsizeof "character code " + INT_DIGITS + 1;
+  (void) memset(buf, 0, bufsz);
+  if (csprint(c)) {
+    buf0 = '\'';
+    buf1 = c;
+    buf2 = '\'';
+    return buf;
+  }
+  (void) sprintf(buf, "character code %d", c);
+  return buf;
+}
+
+static bool read_line(FILE *fp, string *p)
 {
   p->clear();
   int c = -1;
   while ((c = getc(fp)) != EOF) {
-    if (!invalid_input_char(c))
+    if (!is_invalid_input_char(c))
       *p += char(c);
     else
-      error("invalid input character code '%1'", c);
+      error("invalid input (%1)", input_char_description(c));
     if (c == '\n')
       break;
   }
-  current_lineno++;
-  return p->length() > 0;
+  return (p->length() > 0);
 }
 
 void do_file(FILE *fp, const char *filename)
@@ -73,13 +101,15 @@
   current_filename = fn.contents();
   if (output_format == troff)
     printf(".lf 1 %s\n", current_filename);
-  current_lineno = 0;
+  current_lineno = 1;
   while (read_line(fp, &linebuf)) {
     if (linebuf.length() >= 4
 	&& linebuf0 == '.' && linebuf1 == 'l' && linebuf2 == 'f'
-	&& (linebuf3 == ' ' || linebuf3 == '\n' || compatible_flag)) {
+	&& (linebuf3 == ' ' || linebuf3 == '\n' || compatible_flag))
+    {
       put_string(linebuf, stdout);
       linebuf += '\0';
+      // In GNU roff, `lf` assigns the number of the _next_ line.
       if (interpret_lf_args(linebuf.contents() + 3))
 	current_lineno--;
     }
@@ -93,17 +123,23 @@
       int start_lineno = current_lineno + 1;
       str.clear();
       for (;;) {
-	if (!read_line(fp, &linebuf))
+	if (!read_line(fp, &linebuf)) {
+	  current_lineno = 0; // suppress report of line number
 	  fatal("end of file before .EN");
-	if (linebuf.length() >= 3 && linebuf0 == '.' && linebuf1 == 'E') {
+	}
+	if (linebuf.length() >= 3
+	    && linebuf0 == '.'
+	    && linebuf1 == 'E') {
 	  if (linebuf2 == 'N'
 	      && (linebuf.length() == 3 || linebuf3 == ' '
 		  || linebuf3 == '\n' || compatible_flag))
 	    break;
 	  else if (linebuf2 == 'Q' && linebuf.length() > 3
 		   && (linebuf3 == ' ' || linebuf3 == '\n'
-		       || compatible_flag))
-	    fatal("nested .EQ");
+		       || compatible_flag)) {
+	    current_lineno++; // We just read another line.
+	    fatal("equations cannot be nested (.EQ within .EQ)");
+	  }
 	}
 	str += linebuf;
       }
@@ -118,12 +154,15 @@
 	if (output_format == mathml)
 	  putchar('\n');
         else {
-	  printf(".lf %d\n", current_lineno - 1);
+	  current_lineno++;
+	  printf(".lf %d\n", current_lineno);
 	  output_string();
 	}
       }
-      if (output_format == troff)
+      if (output_format == troff) {
+	current_lineno++;
 	printf(".lf %d\n", current_lineno);
+      }
       put_string(linebuf, stdout);
     }
     else if (start_delim != '\0' && linebuf.search(start_delim) >= 0
@@ -131,6 +170,7 @@
       ;
     else
       put_string(linebuf, stdout);
+    current_lineno++;
   }
   current_filename = 0;
   current_lineno = 0;
@@ -152,7 +192,9 @@
   inline_flag = 1;
   for (;;) {
     if (no_newline_in_delim_flag && strchr(start + 1, end_delim) == 0) {
-      error("missing '%1'", end_delim);
+      error("unterminated inline equation; started with %1,"
+	    " expecting %2", input_char_description(start_delim),
+	    input_char_description(end_delim));
       char *nl = strchr(start + 1, '\n');
       if (nl != 0)
 	*nl = '\0';
@@ -174,8 +216,9 @@
       }
       str += ptr;
       if (!read_line(fp, &linebuf))
-	fatal("unterminated '%1' at line %2, looking for '%3'",
-	      start_delim, start_lineno, end_delim);
+	fatal("unterminated inline equation; started with %1,"
+	      " expecting %2", input_char_description(start_delim),
+	      input_char_description(end_delim));
       linebuf += '\0';
       ptr = &linebuf0;
     }
@@ -267,8 +310,11 @@
 void usage(FILE *stream)
 {
   fprintf(stream,
-    "usage: %s  -rvDCNR  -dxx -fn -sn -pn -mn -Mdir -Ts  files ... \n",
-    program_name);
+    "usage: %s -CNrR -d xy -f font -m n -M dir -p n -s n"
+    " -T name file ...\n"
+    "usage: %s {-v | --version}\n"
+    "usage: %s --help\n",
+    program_name, program_name, program_name);
 }
 
 int main(int argc, char **argv)
@@ -283,8 +329,8 @@
     { "version", no_argument, 0, 'v' },
     { NULL, 0, 0, 0 }
   };
-  while ((opt = getopt_long(argc, argv, "DCRvd:f:p:s:m:T:M:rN", long_options,
-			    NULL))
+  while ((opt = getopt_long(argc, argv, "CNrRd:f:m:M:p:s:T:v",
+			    long_options, NULL))
 	 != EOF)
     switch (opt) {
     case 'C':
@@ -298,15 +344,17 @@
       break;
     case 'v':
       printf("GNU eqn (groff) version %s\n", Version_string);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case 'd':
       if (optarg0 == '\0' || optarg1 == '\0')
-	error("-d requires two character argument");
-      else if (invalid_input_char(optarg0))
-	error("bad delimiter '%1'", optarg0);
-      else if (invalid_input_char(optarg1))
-	error("bad delimiter '%1'", optarg1);
+	error("'-d' option requires a two-character argument");
+      else if (is_invalid_input_char(optarg0))
+	error("invalid delimiter (%1) in '-d' option argument",
+	      input_char_description(optarg0));
+      else if (is_invalid_input_char(optarg1))
+	error("invalid delimiter (%1) in '-d' option argument",
+	      input_char_description(optarg1));
       else {
 	start_delim = optarg0;
 	end_delim = optarg1;
@@ -333,16 +381,20 @@
       }
       break;
     case 's':
-      if (!set_gsize(optarg))
-	error("invalid size '%1'", optarg);
+      if (set_gsize(optarg))
+	warning("option '-s' is deprecated");
+      else
+	error("invalid size '%1' in '-s' option argument ", optarg);
       break;
     case 'p':
       {
 	int n;
-	if (sscanf(optarg, "%d", &n) == 1)
+	if (sscanf(optarg, "%d", &n) == 1) {
+	  warning("option '-p' is deprecated");
 	  set_script_reduction(n);
+	}
 	else
-	  error("bad size '%1'", optarg);
+	  error("invalid size '%1' in '-p' option argument ", optarg);
       }
       break;
     case 'm':
@@ -351,34 +403,30 @@
 	if (sscanf(optarg, "%d", &n) == 1)
 	  set_minimum_size(n);
 	else
-	  error("bad size '%1'", optarg);
+	  error("invalid size '%1' in '-n' option argument", optarg);
       }
       break;
     case 'r':
       one_size_reduction_flag = 1;
       break;
-    case 'D':
-      warning("-D option is obsolete: use 'set draw_lines 1' instead");
-      draw_flag = 1;
-      break;
     case 'N':
       no_newline_in_delim_flag = 1;
       break;
     case CHAR_MAX + 1: // --help
       usage(stdout);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(EXIT_FAILURE);
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled getopt_long return value");
     }
   init_table(device);
   init_char_table();
-  printf(".if !dEQ .ds EQ\n"
-	 ".if !dEN .ds EN\n");
+  printf(".do if !dEQ .ds EQ\n"
+	 ".do if !dEN .ds EN\n");
   if (output_format == troff) {
     printf(".if !'\\*(.T'%s' "
 	   ".if !'\\*(.T'html' "	// the html device uses '-Tps' to render
@@ -399,7 +447,9 @@
     FILE *fp = config_macro_path.open_file(STARTUP_FILE, &path);
     if (fp) {
       do_file(fp, path);
-      fclose(fp);
+      if (fclose(fp) < 0)
+	fatal("unable to close '%1': %2", STARTUP_FILE,
+	      strerror(errno));
       free(path);
     }
   }
@@ -413,13 +463,23 @@
 	errno = 0;
 	FILE *fp = fopen(argvi, "r");
 	if (!fp)
-	  fatal("can't open '%1': %2", argvi, strerror(errno));
+	  fatal("unable to open '%1': %2", argvi, strerror(errno));
 	else {
 	  do_file(fp, argvi);
-	  fclose(fp);
+	  if (fclose(fp) < 0)
+	    fatal("unable to close '%1': %2", argvi, strerror(errno));
 	}
       }
-  if (ferror(stdout) || fflush(stdout) < 0)
-    fatal("output error");
-  return 0;
+  if (ferror(stdout))
+    fatal("standard output stream is in an error state");
+  if (fflush(stdout) < 0)
+    fatal("unable to flush standard output stream: %1",
+	  strerror(errno));
+  exit(EXIT_SUCCESS);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/mark.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/mark.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/neqn.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/neqn.1.man Changed

@@ -1,13 +1,13 @@
-.TH @G@NEQN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@neqn \- format equations for ASCII output
+.TH @g@neqn @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@neqn \- format equations for character-cell terminal output
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2001-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2001-2020 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
@@ -25,42 +25,68 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_neqn_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@neqn
-.RI  @g@eqn-options 
+.RI  @g@eqn-argument \~.\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I @g@neqn
 invokes the
-.IR @g@eqn (@MAN1EXT@)
+.MR @g@eqn @MAN1EXT@
 command with the
 .B ascii
 output device.
 .
 .
 .LP
-Note that
 .I @g@eqn
-does not support low-resolution, typewriter-like devices (although it
-may work adequately for very simple input).
+does not support low-resolution,
+typewriter-like devices,
+although it may work adequately for very simple input.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR @g@eqn (@MAN1EXT@)
+.MR @g@eqn @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_neqn_1_man_C
+.do rr *groff_neqn_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=nroff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/neqn.sh -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/neqn.sh Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/other.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/other.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/over.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/over.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/pbox.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/pbox.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/pile.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/pile.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -16,8 +15,11 @@
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
+
 // piles and matrices
 
+#include <assert.h>
+
 #include "eqn.h"
 #include "pbox.h"
 
@@ -38,7 +40,7 @@
   for (i = 1; i < col.len; i++)
     printf(">?(\\n" DEPTH_FORMAT "+\\n" HEIGHT_FORMAT "+%dM)",
 	   col.pi-1->uid, col.pi->uid, default_rule_thickness*5);
-  // round it so that it's a multiple of the vertical resolution
+  // round it so that it's a multiple of the vertical motion quantum
   printf("+(\\n(.V/2)/\\n(.V*\\n(.V\n");
 
   printf(".nr " SUP_RAISE_FORMAT " \\n" BASELINE_SEP_FORMAT "*%d/2"
@@ -165,7 +167,7 @@
     for (j = 1; j < pi->len; j++)
       printf(">?(\\n" DEPTH_FORMAT "+\\n" HEIGHT_FORMAT "+%dM)",
 	   pi->pj-1->uid, pi->pj->uid, default_rule_thickness*5);
-  // round it so that it's a multiple of the vertical resolution
+  // round it so that it's a multiple of the vertical motion quantum
   printf("+(\\n(.V/2)/\\n(.V*\\n(.V\n");
   printf(".nr " SUP_RAISE_FORMAT " \\n" BASELINE_SEP_FORMAT "*%d/2"
 	 "+%dM\n",
@@ -278,7 +280,7 @@
 {
   for (int i = 0; i < len; i++)
     delete pi;
-  a_delete p;
+  delete p;
 }
 
 void matrix_box::append(column *pp)
@@ -288,7 +290,7 @@
     maxlen *= 2;
     p = new column*maxlen;
     memcpy(p, oldp, sizeof(column*)*len);
-    a_delete oldp;
+    delete oldp;
   }
   plen++ = pp;
 }
@@ -345,3 +347,8 @@
   fprintf(stderr, " }");
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/script.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/script.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/special.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/special.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/sqrt.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/sqrt.cpp Changed

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/tests/diagnostics-report-correct-line-numbers.sh Added

@@ -0,0 +1,55 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+eqn="${abs_top_builddir:-.}/eqn"
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    echo "$error"
+    fail=yes
+}
+
+# Verify that correct input file line numbers are reported.
+
+echo "checking for absent line number in early EOF diagnostic" >&2
+input='.EQ'
+error=$(printf "%s\n" "$input" | "$eqn" 2>&1 > /dev/null)
+echo "$error" | grep -Eq '^^:+:^:+: fatal' || wail
+
+echo "checking for correct line number in nested 'EQ' diagnostic" >&2
+input='.EQ
+.EQ'
+error=$(printf "%s\n" "$input" | "$eqn" 2>&1 > /dev/null)
+echo "$error" | grep -Eq '^^:+:^:+:2: fatal' || wail
+
+echo "checking for correct line number in invalid input character" \
+    "diagnostic" >&2
+error=$(printf ".EQ\nx\n.EN\n\200\n" | "$eqn" 2>&1 > /dev/null)
+echo "$error" | grep -Eq '^^:+:^:+:4: error' || wail
+
+echo "checking for correct line number in invalid input character" \
+    "diagnostic when 'lf' request used beforehand" >&2
+error=$(printf ".EQ\nx\n.EN\n.lf 99\n\200\n" | "$eqn" 2>&1 > /dev/null)
+echo "$error" | grep -Eq '^^:+:^:+:99: error' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/eqn/text.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/eqn/text.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/README -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/README Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/gprint.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/gprint.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/grn.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/grn.1.man Changed

@@ -1,14 +1,16 @@
 '\" t
-.TH @G@GRN @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@grn \- groff preprocessor for gremlin files
+.TH @g@grn @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@grn \- embed Gremlin images in
+.I groff
+documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2020 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
@@ -27,64 +29,107 @@
 .
 .
 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr grn_C \n.C
+.do nr *groff_grn_1_man_C \n.cp
 .cp 0
 .
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@grn
-.OP \-Cv
-.OP \-T dev
-.OP \-M dir
-.OP \-F dir
-.RI  file
-\&.\|.\|.\&
+.RB  \-C 
+.RB  \-T\~\c
+.IR dev 
+.RB  \-M\~\c
+.IR dir 
+.RB  \-F\~\c
+.IR dir 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY @g@grn
+.B \-?
+.
+.SY @g@grn
+.B \-\-help
+.YS
+.
+.
+.SY @g@grn
+.B \-v
+.
+.SY @g@grn
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I @g@grn
 is a preprocessor for including
 .I gremlin
 pictures in
-.I groff
+.MR @g@troff @MAN1EXT@
 input.
 .
 .I @g@grn
-writes to standard output, processing only input lines between two
-that start with
+writes to standard output,
+processing only input lines between two that start with
 .B .GS
 and
 .BR .GE .
 .
 Those lines must contain
 .I @g@grn
-commands (see below).
+commands
+(see below).
 .
-These commands request a
+These macros request a
 .I gremlin
-file, and the picture in that file is converted and placed in the
+file;
+the picture in that file is converted and placed in the
 .I @g@troff
 input stream.
 .
-The
 .B .GS
-request may be followed by a C, L, or R to center, left, or right
-justify the whole
+may be called with a
+.BR C ,
+.BR L ,
+or
+.B R
+argument to center,
+left-,
+or right-justify the whole
 .I gremlin
-picture (default justification is center).
+picture
+(the default is to center).
 .
 If no
 .I file
-is mentioned, the standard input is read.
+is mentioned,
+the standard input is read.
 .
-At the end of the picture, the position on the page is the bottom of the
+At the end of the picture,
+the position on the page is the bottom of the
 .I gremlin
 picture.
 .
@@ -98,86 +143,27 @@
 .
 .
 .PP
-Please note that currently only the \-me macro package has support for
+Currently only the
+.I me
+macro package has support for
 .BR .GS ,
 .BR .GE ,
 and
 .BR .GF .
 .
 .
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
-.BI \-T dev
-Prepare output for printer
-.IR dev .
-The default device is
-.BR @DEVICE@ .
-See
-.BR groff (@MAN1EXT@)
-for acceptable devices.
-.
-.TP
-.BI \-M dir
-Prepend
-.I dir
-to the default search path for
-.I gremlin
-files.
-.
-The default path is (in that order) the current directory, the home
-directory,
-.IR @SYSTEMMACRODIR@ ,
-.IR @LOCALMACRODIR@ ,
-and
-.IR @MACRODIR@ .
-.
-.TP
-.BI \-F dir
-Search
-.I dir
-for subdirectories
-.IR dev name
-.RI ( name
-is the name of the device) for the
-.I DESC
-file before the default font directories
-.IR @LOCALFONTDIR@ ,
-.IR @FONTDIR@ ,
-and
-.IR @LEGACYFONTDIR@ .
-.
-.TP
-.B \-C
-Recognize
-.B .GS
-and
-.B .GE
-(and
-.BR .GF )
-even when followed by a character other than space or newline.
-.\".TP
-.\".B \-s
-.\"This switch causes the picture to be traversed twice:
-.\"The first time, only the interiors of filled polygons (as borderless
-.\"polygons) are printed.
-.\"The second time, the outline is printed as a series of line segments.
-.\"This way, postprocessors that overwrite rather than merge picture elements
-.\"(such as PostScript) can still have text and graphics on a shaded
-.\"background.
-.
-.TP
-.B \-v
-Print the version number.
+.PP
+.I @g@grn
+produces drawing escape sequences that use
+.IR groff 's
+color scheme extension
+.RB ( \rsD\aqF \~.\|.\|.\& \aq ),
+and thus may not work with other
+.IR troff s.
 .
 .
 .\" ====================================================================
-.SH "GRN COMMANDS"
+.SS "\fIgrn\f commands"
 .\" ====================================================================
 .
 Each input line between
@@ -188,57 +174,80 @@
 .I @g@grn
 command.
 .
-Commands consist of one or two strings separated by white space, the first
-string being the command and the second its operand.
-Commands may be upper or lower case and abbreviated down to one character.
+Commands consist of one or two strings separated by white space,
+the first string being the command and the second its operand.
+.
+Commands may be upper- or lowercase and abbreviated down to one
+character.
 .
 .
 .PP
-Commands that affect a picture's environment (those listed before
-.BR default ,
-see below) are only in effect for the current picture:
+Commands that affect a picture's environment
+(those listed before
+.RB \%\lq default \rq,
+see below)
+are only in effect for the current picture:
+the environment is reinitialized to the defaults at the start of the
+next picture.
+.
+The commands are as follows.
 .
-The environment is reinitialized to the defaults at the start of the next
-picture.
 .
-The commands are as follows:
 .TP
-.BI 1\  N
+.BI 1\~ N
 .TQ
-.BI 2\  N
+.BI 2\~ N
 .TQ
-.BI 3\  N
+.BI 3\~ N
 .TQ
-.BI 4\  N
+.BI 4\~ N
 .
 Set
 .IR gremlin 's
-text size number 1 (2, 3, or 4) to
+text size number 1
+(2,
+3,
+or 4)
+to
 .I N
 points.
 .
-The default is 12 (16, 24, and 36, respectively).
+The default is 12
+(16,
+24,
+and 36,
+respectively).
+.
 .
 .TP
-.BI roman\  f
+.BI roman\~ f
 .TQ
-.BI italics\  f
+.BI italics\~ f
 .TQ
-.BI bold\  f
+.BI bold\~ f
 .TQ
-.BI special\  f
-Set the roman (italics, bold, or special) font to
+.BI special\~ f
+Set the roman
+(italics,
+bold,
+or special)
+font to
 .IR @g@troff 's
 font
 .I f
 (either a name or number).
 .
-The default is R (I, B, and S, respectively).
+The default is R
+(I,
+B,
+and S,
+respectively).
+.
 .
 .TP
-.BI l\  f
+.BI l\~ f
 .TQ
-.BI stipple\  f
+.BI stipple\~ f
 Set the stipple font to
 .IR @g@troff 's
 stipple font
@@ -246,54 +255,71 @@
 (name or number).
 .
 The command
-.B stipple
-may be abbreviated down as far as \oqst\cq (to avoid confusion
-with
-.BR special ).
+.B \%stipple
+may be abbreviated down as far as
+.RB \lq st \rq
+(to avoid confusion with
+.RB \%\lq special \rq).
 .
 There is
 .I no
-default for stipples (unless one is set by the default command), and
-it is invalid to include a
+default for stipples
+(unless one is set by the
+.RB \%\lq default \rq
+command),
+and it is invalid to include a
 .I gremlin
-picture with polygons without specifying a
-stipple font.
+picture with polygons without specifying a stipple font.
+.
 .
 .TP
-.BI x\  N
+.BI x\~ N
 .TQ
-.BI scale\  N
-Magnify the picture (in addition to any default magnification) by
+.BI scale\~ N
+Magnify the picture
+(in addition to any default magnification)
+by
 .IR N ,
-a floating point number larger than zero.
+a floating-point number larger than zero.
 .
 The command
 .B scale
-may be abbreviated down to \oqsc\cq.
+may be abbreviated down to
+.RB \lq sc \rq.
+.
 .
 .TP
-.BI narrow\  N
+.BI narrow\~ N
 .TQ
-.BI medium\  N
+.BI medium\~ N
 .TQ
-.BI thick\  N
+.BI thick\~ N
 .
 Set the thickness of
 .IR gremlin 's
-narrow (medium and thick, respectively) lines to
+narrow
+(medium and thick,
+respectively)
+lines to
 .I N
-times 0.15pt (this value can be changed at compile time).
+times 0.15pt
+(this value can be changed at compile time).
 .
-The default is 1.0 (3.0 and 5.0, respectively), which corresponds to 0.15pt
-(0.45pt and 0.75pt, respectively).
+The default is 1.0
+(3.0 and 5.0,
+respectively),
+which corresponds to 0.15pt
+(0.45pt and 0.75pt,
+respectively).
 .
 A thickness value of zero selects the smallest available line thickness.
 .
 Negative values cause the line thickness to be proportional to the
 current point size.
 .
+.
 .TP
-.BI pointscale\  <off/on>
+.BR pointscale\~  off | on 
 Scale text to match the picture.
 .
 Gremlin text is usually printed in the point size specified with the
@@ -306,14 +332,17 @@
 .
 Setting
 .B pointscale
-will cause the point sizes to scale with the picture (within
+will cause the point sizes to scale with the picture
+(within
 .IR @g@troff 's
-limitations, of course).
+limitations,
+of course).
 .
 An operand of anything but
-.I off
+.B off
 will turn text scaling on.
 .
+.
 .TP
 .B default
 Reset the picture environment defaults to the settings in the current
@@ -322,125 +351,158 @@
 This is meant to be used as a global parameter setting mechanism at
 the beginning of the
 .I @g@troff
-input file, but can be used at any time to reset the
-default settings.
+input file,
+but can be used at any time to reset the default settings.
+.
 .
 .TP
-.BI width\  N
-Forces the picture to be
+.BI width\~ N
+Force the picture to be
 .I N
 inches wide.
 .
 This overrides any scaling factors present in the same picture.
-.RB \oq width
-.IR 0 \cq
+.
+.RB \lq "width 0" \rq
 is ignored.
 .
+.
 .TP
-.BI height\  N
-Forces picture to be
+.BI height\~ N
+Force the picture to be
 .I N
-inches high, overriding other scaling factors.
+inches high,
+overriding other scaling factors.
+.
+If both
+.B width
+and
+.B height
+are specified,
+the tighter constraint will determine the scale of the picture.
 .
-If both \oqwidth\cq and \oqheight\cq are specified the tighter
-constraint will determine the scale of the picture.
-.B Height
+.B height
 and
 .B width
 commands are not saved with a
-.B default
+.RB \%\lq default \rq
 command.
 .
-They will, however, affect point size scaling if that option is set.
+They will,
+however,
+affect point size scaling if that option is set.
+.
 .
 .TP
-.BI file\  name
+.BI file\~ name
 Get picture from
 .I gremlin
 file
 .I name
-located the current directory (or in the library directory; see the
+located the current directory
+(or in the library directory;
+see the
 .B \-M
 option above).
 .
-If two
+If multiple
 .B file
-commands are given, the second one overrides the first.
+commands are given,
+the last one controls.
 .
 If
 .I name
-doesn't exist, an error message is reported and processing
-continues from the
+doesn't exist,
+an error message is reported and processing continues from the
 .B .GE
 line.
 .
 .
 .\" ====================================================================
-.SH "NOTES ABOUT GROFF"
+.SS "Usage with \fIgroff\f"
 .\" ====================================================================
 .
 Since
 .I @g@grn
-is a preprocessor, it doesn't know about current indents, point
-sizes, margins, number registers, etc.  Consequently, no
+is a preprocessor,
+it has no access to elements of formatter state,
+such as
+indentation,
+line length,
+type size,
+or
+register values.
+.
+Consequently,
+no
 .I @g@troff
 input can be placed between the
 .B .GS
 and
 .B .GE
-requests.
+macros.
 .
 However,
 .I gremlin
-text is now processed by
+text elements are subsequently processed by
 .IR @g@troff ,
 so anything valid in a single line of
 .I @g@troff
 input is valid in a line of
 .I gremlin
-text (barring \oq.\cq directives at the beginning of a line).
+text
+(barring the dot control character \lq.\rq at the beginning of a
+line).
 .
-Thus, it is possible to have equations within a
+Thus,
+it is possible to have equations within a
 .I gremlin
 figure by including in the
 .I gremlin
 file
-.I eqn
-expressions enclosed by previously defined delimiters (e.g.\&
-.IR $$ ).
+.I eqn \" language
+expressions enclosed by previously defined delimiters
+(e.g.,
+\lq$$\rq).
 .
 .
 .PP
 When using
 .I @g@grn
-along with other preprocessors, it is best to run
-.I tbl
+along with other preprocessors,
+it is best to run
+.MR @g@tbl @MAN1EXT@
 before
 .IR @g@grn ,
-.IR pic ,
+.MR @g@pic @MAN1EXT@ ,
 and/or
-.I ideal
+.I ideal \" no GNU version yet
 to avoid overworking
-.IR tbl .
+.IR @g@tbl .
 .
-.I Eqn
+.MR @g@eqn @MAN1EXT@
 should always be run last.
 .
+.MR groff @MAN1EXT@
+will automatically run preprocessors in the correct order.
+.
 .
 .PP
-A picture is considered an entity, but that doesn't stop
+A picture is considered an entity,
+but that doesn't stop
 .I @g@troff
 from trying to break it up if it falls off the end of a page.
 .
-Placing the picture between \oqkeeps\cq in \-me macros will ensure
-proper placement.
+Placing the picture between \lqkeeps\rq in the
+.I me
+macros will ensure proper placement.
 .
 .
 .PP
 .I @g@grn
 uses
 .IR @g@troff 's
-number registers
+registers
 .B g1
 through
 .B g9
@@ -450,48 +512,50 @@
 .B g2
 to the width and height of the
 .I gremlin
-figure (in device units) before entering the
+figure
+(in device units)
+before entering the
 .B .GS
-request (this is for those who want to rewrite these macros).
+macro
+(this is for those who want to rewrite these macros).
 .
 .
 .\" ====================================================================
-.SH "GREMLIN FILE FORMAT"
+.SS "Gremlin file format"
 .\" ====================================================================
 .
 There exist two distinct
 .I gremlin
-file formats, the original format from the
-.I AED
-graphic terminal version, and the
-.I SUN
-or
-.I X11
-version.
+file formats:
+the original format for AED graphic terminals,
+and the Sun or X11 version.
 .
-An extension to the
-.IR SUN / X11
-version allowing reference points with negative coordinates is
-.B not
-compatible with the
-.I AED
-version.
+An extension used by the Sun/X11 version allowing reference points with
+negative coordinates is
+.I not
+compatible with the AED version.
 .
 As long as a
 .I gremlin
-file does not contain negative coordinates, either format will be read
-correctly by either version of
+file does not contain negative coordinates,
+either format will be read correctly by either version of
 .I gremlin
 or
 .IR @g@grn .
 .
-The other difference from
-.IR SUN / X11
-format is the use of names for picture objects (e.g., POLYGON, CURVE)
+The other difference in
+Sun/X11 format is the use of names for picture objects
+(e.g.,
+.BR POLYGON ,
+.BR CURVE )
 instead of numbers.
 .
-Files representing the same picture are shown in Table 1 in each format.
-.sp
+Files representing the same picture are shown below.
+.
+.
+.PP
+.ie t .ne 18v
+.el   .ne 19v
 .TS
 center, tab(@);
 l lw(0.1i) l.
@@ -513,88 +577,92 @@
 5 1@@5 1
 0@@0
 \-1@@\-1
-.T&
-css.
-.sp
-Table 1.  File examples
 .TE
-.sp
-.IP \(bu
+.
+.
+.IP \bu 2n
 The first line of each
 .I gremlin
 file contains either the string
-.B gremlinfile
-.RI ( AED
-version) or
-.B sungremlinfile
-.RI ( SUN / X11 )
-.IP \(bu
-The second line of the file contains an orientation, and
-.B x
+.RB \lq gremlinfile \rq
+(AED)
+or
+.RB \lq sungremlinfile \rq
+(Sun/X11).
+.
+.
+.IP \bu
+The second line of the file contains an orientation and
+.I x
 and
-.B y
-values for a positioning point, separated by spaces.
-The orientation, either
+.I y
+values for a positioning point,
+separated by spaces.
+.
+The orientation,
+either
 .B 0
 or
 .BR 1 ,
-is ignored by the
-.IR SUN / X11
-version.
+is ignored by the Sun/X11 version.
 .
 .B 0
 means that
 .I gremlin
-will display things in horizontal format (drawing area wider than it is
-tall, with menu across top).
+will display things in horizontal format
+(a drawing area wider than it is tall,
+with a menu across the top).
 .
 .B 1
 means that
 .I gremlin
-will display things in vertical format (drawing area taller than it is
-wide, with menu on left side).
+will display things in vertical format
+(a drawing area taller than it is wide,
+with a menu on the left side).
 .
-.B x
+.I x
 and
-.B y
-are floating point values giving a positioning point to be used when
+.I y
+are floating-point values giving a positioning point to be used when
 this file is read into another file.
 .
-The stuff on this line really isn't all that important; a value of
-\lq1 0.00 0.00\rq is suggested.
+The stuff on this line really isn't all that important;
+a value of
+.RB \lq "1 0.00 0.00" \rq
+is suggested.
 .
-.IP \(bu
+.
+.IP \bu
 The rest of the file consists of zero or more element specifications.
 .
 After the last element specification is a line containing the string
-\lq\-1\rq.
+.RB \lq \-1 \rq.
+.
 .
-.IP \(bu
-Lines longer than 127 characters are chopped to this limit.
+.IP \bu
+Lines longer than 127 characters are truncated to that length.
 .
 .
 .\" ====================================================================
-.SH "ELEMENT SPECIFICATIONS"
+.SS "Element specifications"
 .\" ====================================================================
 .
-.IP \(bu
+.IP \bu 2n
 The first line of each element contains a single decimal number giving
-the type of the element
-.RI ( AED
-version) or its ASCII name
-.RI ( SUN / X11
-version).
-.
-See Table 2.
-.sp
+the type of the element (AED) or its name (Sun/X11).
+.
+.
+.IP
+.ie t .ne 18v
+.el   .ne 19v
 .TS
 center, tab(@);
 css
 ccc
-nll.
-\fIgremlin\fP File Format \(mi Object Type Specification
-.sp
-\fIAED\fP Number@\fISUN\/\fP/\,\fIX11\fP Name@Description
+nBlBl.
+\fIgremlin\f File Format: Object Type Specification
+_
+AED Number@Sun/X11 Name@Description
 0@BOTLEFT@bottom-left-justified text
 1@BOTRIGHT@bottom-right-justified text
 2@CENTCENT@center-justified text
@@ -610,152 +678,277 @@
 13@CENTLEFT@left-center-justified text
 14@CENTRIGHT@right-center-justified text
 15@BOTCENT@bottom-center-justified text
-.T&
-css.
-.sp
-Table 2.
-Type Specifications in \fIgremlin\fP Files
 .TE
-.sp
-.IP \(bu
-After the object type comes a variable number of lines, each specifying a
-point used to display the element.
-Each line contains an x-coordinate and a y-coordinate in floating point
-format, separated by spaces.
-The list of points is terminated by a line containing the string \lq\-1.0
-\-1.0\rq
-.RI ( AED
-version) or a single asterisk, \lq*\rq
-.RI ( SUN / X11
-version).
-.
-.IP \(bu
-After the points comes a line containing two decimal values, giving the
-brush and size for the element.
+.
+.
+.IP \bu
+After the object type comes a variable number of lines,
+each specifying a point used to display the element.
+.
+Each line contains an x-coordinate and a y-coordinate in floating-point
+format,
+separated by spaces.
+.
+The list of points is terminated by a line containing the string
+.RB \lq "\-1.0 \-1.0" \rq
+(AED) or a single asterisk,
+.RB \lq * \rq
+(Sun/X11).
+.
+.
+.IP \bu
+After the points comes a line containing two decimal values,
+giving the brush and size for the element.
 .
 The brush determines the style in which things are drawn.
 .
-For vectors, arcs, and curves there are six valid brush values:
-.sp
+For vectors,
+arcs,
+and curves there are six valid brush values.
+.
+.
+.IP
 .TS
 center, tab(@);
-ncw(0.1i)l.
-1 \(mi@@thin dotted lines
-2 \(mi@@thin dot-dashed lines
-3 \(mi@@thick solid lines
-4 \(mi@@thin dashed lines
-5 \(mi@@thin solid lines
-6 \(mi@@medium solid lines
+nB l.
+1@thin dotted lines
+2@thin dot-dashed lines
+3@thick solid lines
+4@thin dashed lines
+5@thin solid lines
+6@medium solid lines
 .TE
-.sp
-For polygons, one more value, 0, is valid.
+.
+.
+.IP
+For polygons,
+one more value,
+0,
+is valid.
+.
 It specifies a polygon with an invisible border.
-For text, the brush selects a font as follows:
-.sp
+.
+For text,
+the brush selects a font as follows.
+.
+.
+.IP
 .TS
 center, tab(@);
-ncw(0.1i)l.
-1 \(mi@@roman (R font in groff)
-2 \(mi@@italics (I font in groff)
-3 \(mi@@bold (B font in groff)
-4 \(mi@@special (S font in groff)
+nB l.
+1@roman (R font in \fI@g@troff\f)
+2@italics (I font in \fI@g@troff\f)
+3@bold (B font in \fI@g@troff\f)
+4@special (S font in \fI@g@troff\f)
 .TE
-.sp
+.
+.
+.IP
 If you're using
 .I @g@grn
 to run your pictures through
 .IR groff ,
-the font is really just a starting font:
+the font is really just a starting font.
 .
 The text string can contain formatting sequences like
-\lq\efI\rq
+\lq\rsfI\rq
 or
-\lq\ed\rq
-which may change the font (as well as do many other things).
+\lq\rsd\rq
+which may change the font
+(as well as do many other things).
 .
-For text, the size field is a decimal value between 1 and 4.
+For text,
+the size field is a decimal value between 1 and 4.
 .
 It selects the size of the font in which the text will be drawn.
 .
-For polygons, this size field is interpreted as a stipple number to
-fill the polygon with.
+For polygons,
+this size field is interpreted as a stipple number to fill the polygon
+with.
 .
 The number is used to index into a stipple font at print time.
 .
-.IP \(bu
+.
+.IP \bu
 The last line of each element contains a decimal number and a string of
-characters, separated by a single space.
+characters,
+separated by a single space.
 .
 The number is a count of the number of characters in the string.
 .
-This information is only used for text elements, and contains the text
-string.
+This information is used only for text elements,
+and contains the text string.
 .
 There can be spaces inside the text.
 .
-For arcs, curves, and vectors, this line of the element contains the
-string \lq0\rq.
+For arcs,
+curves,
+and vectors,
+the character count is zero
+.RB ( 0 ),
+followed by exactly one space before the newline.
 .
 .
 .\" ====================================================================
-.SH "NOTES ON COORDINATES"
+.SS Coordinates
 .\" ====================================================================
 .
 .I gremlin
-was designed for
-.IR AED s,
-and its coordinates reflect the
-.I AED
-coordinate space.
+was designed for AED terminals,
+and its coordinates reflect the AED coordinate space.
 .
-For vertical pictures, x-values range 116 to 511, and y-values from 0
-to 483.
+For vertical pictures,
+.IR x \~values
+range 116 to 511,
+and
+.IR y \~values
+from 0 to 483.
 .
-For horizontal pictures, x-values range from 0 to 511 and y-values
-range from 0 to 367.
+For horizontal pictures,
+.IR x \~values
+range from 0 to 511,
+and
+.IR y \~values
+from 0 to 367.
 .
-Although you needn't absolutely stick to this range, you'll
-get best results if you at least stay in this vicinity.
+Although you needn't absolutely stick to this range,
+you'll get better results if you at least stay in this vicinity.
 .
-Also, point lists are terminated by a point of (\-1, \-1), so you
-shouldn't ever use negative coordinates.
+Also,
+point lists are terminated by a point of
+(\-1,
+\-1),
+so you shouldn't ever use negative coordinates.
 .
 .I gremlin
-writes out coordinates using format \lq%f1.2\rq; it's probably
-a good idea to use the same format if you want to modify the
+writes out coordinates using the
+.MR printf 3
+format \lq%f1.2\rq;
+it's probably a good idea to use the same format if you want to modify
+the
 .I @g@grn
 code.
 .
 .
 .\" ====================================================================
-.SH "NOTES ON SUN/X11 COORDINATES"
+.SS "Sun/X11 coordinates"
 .\" ====================================================================
 .
-There is no longer a restriction on the range of coordinates used to
-create objects in the
-.IR SUN / X11
-version of
+There is no restriction on the range of coordinates used to create
+objects in the Sun/X11 version of
 .IR gremlin .
 .
-However, files with negative coordinates
-.B will
-cause problems if displayed on the
-.IR AED .
+However,
+files with negative coordinates
+.I will
+cause problems if displayed on the AED.
+.
+.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-?\&
+and
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-C
+Recognize
+.B .GS
+and
+.B .GE
+(and
+.BR .GF )
+even when followed by a character other than space or newline.
+.
+.
+.TP
+.BI \-F\~ dir
+Search
+.I dir
+for subdirectories
+.IR dev name
+.RI ( name
+is the name of the output driver)
+for the
+.I DESC
+file before the default font directories
+.IR @LOCALFONTDIR@ ,
+.IR @FONTDIR@ ,
+and
+.IR @LEGACYFONTDIR@ .
+.
+.
+.TP
+.BI \-M\~ dir
+Prepend
+.I dir
+to the search path for
+.I gremlin
+files.
+.
+The default search path is the current directory,
+the home directory,
+.if !'@COMPATIBILITY_WRAPPERS@'no' .IR @SYSTEMMACRODIR@ ,
+.IR @LOCALMACRODIR@ ,
+and
+.IR @MACRODIR@ ,
+in that order.
+.\".
+.\".
+.\".TP
+.\".B \-s
+.\"This switch causes the picture to be traversed twice:
+.\"The first time,
+.\"only the interiors of filled polygons
+.\"(as borderless polygons)
+.\"are printed.
+.\".
+.\"The second time,
+.\"the outline is printed as a series of line segments.
+.\".
+.\"This way,
+.\"postprocessors that overwrite rather than merge picture elements
+.\"(such as PostScript)
+.\"can still have text and graphics on a shaded background.
+.
+.
+.TP
+.BI \-T\~ dev
+Prepare device output using output driver
+.IR dev .
+.
+The default is
+.BR @DEVICE@ .
+.
+See
+.MR groff @MAN1EXT@
+for a list of valid devices.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.IR @FONTDIR@/dev name /DESC
-Device description file for device
+.IR @FONTDIR@/\:\%dev name /\:DESC
+describes the output device
 .IR name .
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 David Slattengren and Barry Roitblat wrote the original Berkeley
 .IR grn .
 .
@@ -764,20 +957,22 @@
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR gremlin (1),
-.BR groff (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR ideal (1)
+.MR gremlin 1 ,
+.MR groff @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR ideal 1
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngrn_C
+.cp \n*groff_grn_1_man_C
+.do rr *groff_grn_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/grn.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/grn.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/hdb.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/hdb.cpp Changed

@@ -2,8 +2,8 @@
  *
  * Copyright -C- 1982 Barry S. Roitblat
  *
- * This file contains database routines for the hard copy programs of the
- * gremlin picture editor.
+ * This file contains database routines for the hard copy programs of
+ * the gremlin picture editor.
  */
 
 #ifdef HAVE_CONFIG_H
@@ -23,10 +23,10 @@
 
 /* imports from main.cpp */
 
-extern int linenum;		/* current line number in input file */
 extern char gremlinfile;	/* name of file currently reading */
 extern int SUNFILE;		/* TRUE if SUN gremlin file */
 extern int compatibility_flag;	/* TRUE if in compatibility mode */
+extern void *grnmalloc(size_t size, const char *what);
 extern void savebounds(double x, double y);
 
 /* imports from hpoint.cpp */
@@ -35,12 +35,13 @@
 extern POINT *PTMakePoint(double x, double y, POINT ** pplist);
 
 
-int DBGetType(register char *s);
+int DBGetType(char *s);
 
+static long lineno = 0;		/* line number of gremlin file */
 
 /*
- * This routine returns a pointer to an initialized database element which
- * would be the only element in an empty list.
+ * This routine returns a pointer to an initialized database element
+ * which would be the only element in an empty list.
  */
 ELT *
 DBInit()
@@ -61,9 +62,9 @@
 	    char *text,
 	    ELT **db)
 {
-  register ELT *temp;
+  ELT *temp = 0;
 
-  temp = (ELT *) malloc(sizeof(ELT));
+  temp = (ELT *) grnmalloc(sizeof(ELT), "picture element");
   temp->nextelt = *db;
   temp->type = type;
   temp->ptlist = pointlist;
@@ -80,11 +81,11 @@
  * pointer to that database.
  */
 ELT *
-DBRead(register FILE *file)
+DBRead(FILE *file)
 {
-  register int i;
-  register int done;		/* flag for input exhausted */
-  register double nx;		/* x holder so x is not set before orienting */
+  int i;
+  int done;		/* flag for input exhausted */
+  double nx;		/* x holder so x is not set before orienting */
   int type;			/* element type */
   ELT *elist;			/* pointer to the file's elements */
   POINT *plist;			/* pointer for reading in points */
@@ -95,16 +96,32 @@
 
   SUNFILE = FALSE;
   elist = DBInit();
-  (void) fscanf(file, "%" MAXSTRING_S "s%*^\n\n", string);
+  int nitems = fscanf(file, "%" MAXSTRING_S "s%*^\n\n", string);
+  if (nitems != 1) {
+    error_with_file_and_line(gremlinfile, lineno,
+			     "malformed input; giving up on this"
+			     " picture");
+    return (elist);
+  }
+  lineno++;
   if (strcmp(string, "gremlinfile")) {
     if (strcmp(string, "sungremlinfile")) {
-      error("'%1' is not a gremlin file", gremlinfile);
+      error_with_file_and_line(gremlinfile, lineno,
+			       "not a gremlin file; giving up on this"
+			       " picture");
       return (elist);
     }
     SUNFILE = TRUE;
   }
 
-  (void) fscanf(file, "%d%lf%lf\n", &size, &x, &y);
+  nitems = fscanf(file, "%d%lf%lf\n", &size, &x, &y);
+  if (nitems != 3) {
+    error_with_file_and_line(gremlinfile, lineno,
+			     "malformed input; giving up on this"
+			     " picture");
+    return (elist);
+  }
+  lineno++;
   /* ignore orientation and file positioning point */
 
   done = FALSE;
@@ -112,28 +129,42 @@
     /* if (fscanf(file,"%" MAXSTRING_S "s\n", string) == EOF) */
     /* I changed the scanf format because the element */
     /* can have two words (e.g. CURVE SPLINE)         */
-    if (fscanf(file, "\n%" MAXSTRING_S "^\n%*^\n\n", string) == EOF) {
-      error("'%1', error in file format", gremlinfile);
+    if (fscanf(file, "\n%"
+		      MAXSTRING_S
+		     "^\n%*^\n\n", string) == EOF) {
+      lineno++;
+      error_with_file_and_line(gremlinfile, lineno, "error in format;"
+			       " giving up on this picture");
       return (elist);
     }
+    lineno++;
 
     type = DBGetType(string);	/* interpret element type */
     if (type < 0) {		/* no more data */
       done = TRUE;
     } else {
+      /* always one point */
 #ifdef UW_FASTSCAN
-      (void) xscanf(file, &x, &y);		/* always one point */
+      (void) xscanf(file, &x, &y);
 #else
-      (void) fscanf(file, "%lf%lf\n", &x, &y);	/* always one point */
+      nitems = fscanf(file, "%lf%lf\n", &x, &y);
+      if (nitems != 2) {
+	error_with_file_and_line(gremlinfile, lineno,
+				 "malformed input; giving up on this"
+				 " picture");
+	return (elist);
+      }
+      lineno++;
 #endif	/* UW_FASTSCAN */
       plist = PTInit();		/* NULL point list */
 
       /*
        * Files created on the SUN have point lists terminated by a line
-       * containing only an asterik ('*').  Files created on the AED have
-       * point lists terminated by the coordinate pair (-1.00 -1.00).
+       * containing only an asterisk ('*').  Files created on the AED
+       * have point lists terminated by the coordinate pair (-1.00
+       * -1.00).
        */
-      if (TEXT(type)) {		/* read only first point for TEXT elements */
+      if (TEXT(type)) {	/* read only first point for TEXT elements */
 	nx = xorn(x, y);
 	y = yorn(x, y);
 	(void) PTMakePoint(nx, y, &plist);
@@ -144,11 +175,25 @@
 #else
 	lastpoint = FALSE;
 	do {
-	  fgets(string, MAXSTRING, file);
+	  char *cp = fgets(string, MAXSTRING, file);
+	  if (0 /* nullptr */ == cp) {
+	    error_with_file_and_line(gremlinfile, lineno,
+				     "premature end-of-file or error"
+				     " reading input; giving up on this"
+				     " picture");
+	    return(elist);
+	  }
+	  lineno++;
 	  if (string0 == '*') {	/* SUN gremlin file */
 	    lastpoint = TRUE;
 	  } else {
-	    (void) sscanf(string, "%lf%lf", &x, &y);
+	    if (!sscanf(string, "%lf%lf", &x, &y)) {
+	      error_with_file_and_line(gremlinfile, lineno,
+				       "expected coordinate pair, got"
+				       " '%1'; giving up on this"
+				       " picture", string);
+	      return(elist);
+	    }
 	    if ((x == -1.00 && y == -1.00) && (!SUNFILE))
 	      lastpoint = TRUE;
 	    else {
@@ -174,7 +219,15 @@
 	  (void) PTMakePoint(nx, y, &plist);
 	  savebounds(nx, y);
 
-	  fgets(string, MAXSTRING, file);
+	  char *cp = fgets(string, MAXSTRING, file);
+	  if (0 /* nullptr */ == cp) {
+	    error_with_file_and_line(gremlinfile, lineno,
+				     "premature end-of-file or error"
+				     " reading input; giving up on this"
+				     " picture");
+	    return(elist);
+	  }
+	  lineno++;
 	  if (string0 == '*') {	/* SUN gremlin file */
 	    lastpoint = TRUE;
 	  } else {
@@ -185,16 +238,44 @@
 	}
 #endif	/* UW_FASTSCAN */
       }
-      (void) fscanf(file, "%d%d\n", &brush, &size);
-      (void) fscanf(file, "%d", &len);	/* text length */
+      nitems = fscanf(file, "%d%d\n", &brush, &size);
+      if (nitems != 2) {
+	error_with_file_and_line(gremlinfile, lineno,
+				 "malformed input; giving up on this"
+				 " picture");
+	return (elist);
+      }
+      lineno++;
+      nitems = fscanf(file, "%d", &len);	/* text length */
+      if (nitems != 1) {
+	error_with_file_and_line(gremlinfile, lineno,
+				 "malformed input; giving up on this"
+				 " picture");
+	return (elist);
+      }
       (void) getc(file);		/* eat blank */
-      txt = (char *) malloc((unsigned) len + 1);
+      lineno++;				/* advance line counter early */
+      if (len < 0) {
+	error_with_file_and_line(gremlinfile, lineno,
+				 "length claimed for text is nonsense:"
+				 " '%1'; giving up on this picture",
+				 len);
+	return (elist);
+      }
+      txt = (char *) grnmalloc((unsigned) len + 1, "element text");
       for (i = 0; i < len; ++i) {	/* read text */
         int c = getc(file);
         if (c == EOF)
           break;
 	txti = c;
       }
+      if (feof(file)) {
+	error_with_file_and_line(gremlinfile, lineno,
+				 "end of file while reading text of"
+				 " length %1; giving up on this"
+				 " picture", len);
+	return (elist);
+      }
       txtlen = '\0';
       (void) DBCreateElt(type, plist, brush, size, txt, &elist);
     }				/* end else */
@@ -209,7 +290,7 @@
  * New file format has literal names for element types.
  */
 int
-DBGetType(register char *s)
+DBGetType(char *s)
 {
   if (isdigit(s0) || (s0 == '-'))	/* old element format or EOF */
     return (atoi(s));
@@ -226,11 +307,11 @@
       if (s5 == '\n')
 	return (CURVE);
       switch (s7) {
-      case 'S': 
+      case 'S':
 	return(BSPLINE);
       case 'E':
-	fprintf(stderr,
-		"Warning: Bezier Curves will be printed as B-Splines\n");
+	warning_with_file_and_line(gremlinfile, lineno,
+				   "using B-spline for Bezier curve");
 	return(BSPLINE);
       default:
 	return(CURVE);
@@ -244,8 +325,9 @@
     case 'R':
       return (CENTRIGHT);
     default:
-      fatal("unknown element type");
-      // fatal() does not return
+      error_with_file_and_line(gremlinfile, lineno,
+			       "unknown element type '%1'", s);
+      return -1;
     }
   case 'B':
     switch (s3) {
@@ -256,8 +338,9 @@
     case 'R':
       return (BOTRIGHT);
     default:
-      fatal("unknown element type");
-      // fatal() does not return
+      error_with_file_and_line(gremlinfile, lineno,
+			       "unknown element type '%1'", s);
+      return -1;
     }
   case 'T':
     switch (s3) {
@@ -268,22 +351,23 @@
     case 'R':
       return (TOPRIGHT);
     default:
-      fatal("unknown element type");
-      // fatal() does not return
+      error_with_file_and_line(gremlinfile, lineno,
+			       "unknown element type '%1'", s);
+      return -1;
     }
   default:
-    fatal("unknown element type");
+    error_with_file_and_line(gremlinfile, lineno,
+			     "unknown element type '%1'", s);
+    return -1;
   }
-
-  return 0;				/* never reached */
 }
 
 #ifdef UW_FASTSCAN
 /*
  * Optimization hack added by solomon@crys.wisc.edu, 12/2/86.
- * A huge fraction of the time was spent reading floating point numbers from
- * the input file, but the numbers always have the format 'ddd.dd'.  Thus
- * the following special-purpose version of fscanf.
+ * A huge fraction of the time was spent reading floating point numbers
+ * from the input file, but the numbers always have the format 'ddd.dd'.
+ * Thus the following special-purpose version of fscanf.
  *
  * xscanf(f,xp,yp) does roughly what fscanf(f,"%f%f",xp,yp) does except:
  *   -the next piece of input must be of the form
@@ -298,7 +382,7 @@
        double *xp,
        double *yp)
 {
-  register int c, i, j, m, frac;
+  int c, i, j, m, frac;
   int iscale = 1, jscale = 1;	/* x = i/scale, y=j/jscale */
 
   while ((c = getc(f)) == ' ');
@@ -350,4 +434,8 @@
 }
 #endif	/* UW_FASTSCAN */
 
-/* EOF */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/hgraph.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/hgraph.cpp Changed

@@ -1,7 +1,7 @@
 /* Last non-groff version: hgraph.c  1.14 (Berkeley) 84/11/27
  *
- * This file contains the graphics routines for converting gremlin pictures
- * to troff input.
+ * This file contains the graphics routines for converting gremlin
+ * pictures to troff input.
  */
 
 #include "lib.h"
@@ -14,7 +14,8 @@
 #define PointsPerInterval 64
 #define pi		3.14159265358979324
 #define twopi		(2.0 * pi)
-#define len(a, b)	groff_hypot((double)(b.x-a.x), (double)(b.y-a.y))
+#define len(a, b)	groff_hypot((double)(b.x-a.x), \
+			            (double)(b.y-a.y))
 
 
 extern int dotshifter;		/* for the length of dotted curves */
@@ -23,7 +24,7 @@
 extern double thick;
 extern char *tfont;
 extern int tsize;
-extern int stipple_index;	/* stipple font index for stipples 0 - 16 */
+extern int stipple_index;	/* stipple font idx for stipples 0-16 */
 extern char *stipple;		/* stipple type (cf or ug) */
 
 
@@ -48,7 +49,7 @@
 extern int res;
 
 void HGSetFont(int font, int size);
-void HGPutText(int justify, POINT pnt, register char *string);
+void HGPutText(int justify, POINT pnt, char *string);
 void HGSetBrush(int mode);
 void tmove2(int px, int py);
 void doarc(POINT cp, POINT sp, int angle);
@@ -58,10 +59,10 @@
 void HGtline(int x1, int y1);
 void deltax(double x);
 void deltay(double y);
-void HGArc(register int cx, register int cy, int px, int py, int angle);
-void picurve(register int *x, register int *y, int npts);
+void HGArc(int cx, int cy, int px, int py, int angle);
+void picurve(int *x, int *y, int npts);
 void HGCurve(int *x, int *y, int numpoints);
-void Paramaterize(int x, int y, double h, int n);
+void Parameterize(int x, int y, double h, int n);
 void PeriodicSpline(double h, int z,
 		    double dz, double d2z, double d3z,
 		    int npoints);
@@ -71,22 +72,22 @@
 
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	HGPrintElt (element_pointer, baseline)
  |
  | Results:	Examines a picture element and calls the appropriate
- |		routine(s) to print them according to their type.  After the
- |		picture is drawn, current position is (lastx, lasty).
- *----------------------------------------------------------------------------*/
+ |		routine(s) to print them according to their type.  After
+ |		the picture is drawn, current position is (lastx,lasty).
+ *--------------------------------------------------------------------*/
 
 void
 HGPrintElt(ELT *element,
 	   int /* baseline */)
 {
-  register POINT *p1;
-  register POINT *p2;
-  register int length;
-  register int graylevel;
+  POINT *p1;
+  POINT *p2;
+  int length;
+  int graylevel;
 
   if (!DBNullelt(element) && !Nullpoint((p1 = element->ptlist))) {
     /* p1 always has first point */
@@ -153,11 +154,11 @@
 	  /* brushf = style of outline; size = color of fill:
 	   * on first pass (polyfill=FILL), do the interior using 'P'
 	   *    unless size=0
-	   * on second pass (polyfill=OUTLINE), do the outline using a series
-	   *    of vectors. It might make more sense to use \D'p ...',
-	   *    but there is no uniform way to specify a 'fill character'
-	   *    that prints as 'no fill' on all output devices (and
-	   *    stipple fonts).
+	   * on second pass (polyfill=OUTLINE), do the outline using a
+	   *    series of vectors. It might make more sense to use \D'p
+	   *    ...', but there is no uniform way to specify a 'fill
+	   *    character' that prints as 'no fill' on all output
+	   *    devices (and stipple fonts).
 	   * If polyfill=BOTH, just use the \D'p ...' command.
 	   */
 	  double firstx = p1->x;
@@ -168,7 +169,8 @@
 
 	  if (polyfill == FILL || polyfill == BOTH) {
 	    /* do the interior */
-	    char command = (polyfill == BOTH && element->brushf) ? 'p' : 'P';
+	    char command = (polyfill == BOTH && element->brushf)
+			   ? 'p' : 'P';
 
 	    /* include outline, if there is one and */
 	    /* the -p flag was set                  */
@@ -264,21 +266,21 @@
 }				/* end PrintElt */
 
 
-/*----------------------------------------------------------------------------*
+/*---------------------------------------------------------------------*
  | Routine:	HGPutText (justification, position_point, string)
  |
  | Results:	Given the justification, a point to position with, and a
  |		string to put, HGPutText first sends the string into a
  |		diversion, moves to the positioning point, then outputs
- |		local vertical and horizontal motions as needed to justify
- |		the text.  After all motions are done, the diversion is
- |		printed out.
- *----------------------------------------------------------------------------*/
+ |		local vertical and horizontal motions as needed to
+ |		justify the text.  After all motions are done, the
+ |		diversion is printed out.
+ *--------------------------------------------------------------------*/
 
 void
 HGPutText(int justify,
 	  POINT pnt,
-	  register char *string)
+	  char *string)
 {
   int savelasty = lasty;	/* vertical motion for text is to be */
 				/* ignored.  Save current y here     */
@@ -298,8 +300,8 @@
   tmove(&pnt);			/* move to positioning point */
 
   switch (justify) {
-    /* local vertical motions                                            */
-    /* (the numbers here are used to be somewhat compatible with gprint) */
+    /* local vertical motions--the numbers here are used to be
+       somewhat compatible with gprint */
   case CENTLEFT:
   case CENTCENT:
   case CENTRIGHT:
@@ -328,18 +330,18 @@
 
   printf("\\&\\*(g9\n");	/* now print the text. */
   printf(".sp |\\n(g8u\n");	/* restore vertical position */
-  lasty = savelasty;		/* vertical position restored to where it */
-  lastx = xleft;		/* was before text, also horizontal is at */
-				/* left                                   */
+  lasty = savelasty;		/* vertical position restored to */
+  lastx = xleft;		/* where it was before text, also */
+				/* horizontal is at left */
 }				/* end HGPutText */
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	doarc (center_point, start_point, angle)
  |
  | Results:	Produces either drawarc command or a drawcircle command
  |		depending on the angle needed to draw through.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 doarc(POINT cp,
@@ -355,14 +357,14 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	HGSetFont (font_number, Point_size)
  |
- | Results:	ALWAYS outputs a .ft and .ps directive to troff.  This is
- |		done because someone may change stuff inside a text string. 
- |		Changes thickness back to default thickness.  Default
- |		thickness depends on font and pointsize.
- *----------------------------------------------------------------------------*/
+ | Results:	ALWAYS outputs a .ft and .ps directive to troff.  This
+ |		is done because someone may change stuff inside a text
+ |		string.  Changes thickness back to default thickness.
+ |		Default thickness depends on font and point size.
+ *--------------------------------------------------------------------*/
 
 void
 HGSetFont(int font,
@@ -374,20 +376,20 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	HGSetBrush (line_mode)
  |
- | Results:	Generates the troff commands to set up the line width and
- |		style of subsequent lines.  Does nothing if no change is
- |              needed.
+ | Results:	Generates the troff commands to set up the line width
+ |		and style of subsequent lines.  Does nothing if no
+ |		change is needed.
  |
- | Side Efct:	Sets 'linmode' and 'linethicknes'.
- *----------------------------------------------------------------------------*/
+ | Side Efct:	Sets 'linmode' and 'linethickness'.
+ *--------------------------------------------------------------------*/
 
 void
 HGSetBrush(int mode)
 {
-  register int printed = 0;
+  int printed = 0;
 
   if (linmod != style--mode) {
     /* Groff doesn't understand \Ds, so we take it out */
@@ -405,60 +407,61 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	deltax (x_destination)
  |
  | Results:	Scales and outputs a number for delta x (with a leading
  |		space) given 'lastx' and x_destination.
  |
  | Side Efct:	Resets 'lastx' to x_destination.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 deltax(double x)
 {
-  register int ix = (int) (x * troffscale);
+  int ix = (int) (x * troffscale);
 
   printf(" %du", ix - lastx);
   lastx = ix;
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	deltay (y_destination)
  |
  | Results:	Scales and outputs a number for delta y (with a leading
  |		space) given 'lastyline' and y_destination.
  |
- | Side Efct:	Resets 'lastyline' to y_destination.  Since 'line' vertical
- |		motions don't affect 'page' ones, 'lasty' isn't updated.
- *----------------------------------------------------------------------------*/
+ | Side Efct:	Resets 'lastyline' to y_destination.  Since 'line'
+ |		vertical motions don't affect 'page' ones, 'lasty' isn't
+ |		updated.
+ *--------------------------------------------------------------------*/
 
 void
 deltay(double y)
 {
-  register int iy = (int) (y * troffscale);
+  int iy = (int) (y * troffscale);
 
   printf(" %du", iy - lastyline);
   lastyline = iy;
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	tmove2 (px, py)
  |
- | Results:	Produces horizontal and vertical moves for troff given the
- |		pair of points to move to and knowing the current position. 
- |		Also puts out a horizontal move to start the line.  This is
- |		a variation without the .sp command.
- *----------------------------------------------------------------------------*/
+ | Results:	Produces horizontal and vertical moves for troff given
+ |		the pair of points to move to and knowing the current
+ |		position.  Also puts out a horizontal move to start the
+ |		line.  This is a variation without the .sp command.
+ *--------------------------------------------------------------------*/
 
 void
 tmove2(int px,
        int py)
 {
-  register int dx;
-  register int dy;
+  int dx;
+  int dy;
 
   if ((dy = py - lasty)) {
     printf("\\v'%du'", dy);
@@ -471,22 +474,22 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	tmove (point_pointer)
  |
- | Results:	Produces horizontal and vertical moves for troff given the
- |		pointer of a point to move to and knowing the current
- |		position.  Also puts out a horizontal move to start the
- |		line.
- *----------------------------------------------------------------------------*/
+ | Results:	Produces horizontal and vertical moves for troff given
+ |		the pointer of a point to move to and knowing the
+ |		current position.  Also puts out a horizontal move to
+ |		start the line.
+ *--------------------------------------------------------------------*/
 
 void
 tmove(POINT * ptr)
 {
-  register int ix = (int) (ptr->x * troffscale);
-  register int iy = (int) (ptr->y * troffscale);
-  register int dx;
-  register int dy;
+  int ix = (int) (ptr->x * troffscale);
+  int iy = (int) (ptr->y * troffscale);
+  int dx;
+  int dy;
 
   if ((dy = iy - lasty)) {
     printf(".sp %du\n", dy);
@@ -499,14 +502,16 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	cr ( )
  |
- | Results:	Ends off an input line.  '.sp -1' is also added to counteract
- |		the vertical move done at the end of text lines.
+ | Results:	Ends off an input line.  '.sp -1' is also added to
+ |		counteract the vertical move done at the end of text
+ |		lines.
  |
- | Side Efct:	Sets 'lastx' to 'xleft' for troff's return to left margin.
- *----------------------------------------------------------------------------*/
+ | Side Efct:	Sets 'lastx' to 'xleft' for troff's return to left
+ |		margin.
+ *--------------------------------------------------------------------*/
 
 void
 cr()
@@ -516,11 +521,11 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	line ( )
  |
  | Results:	Draws a single solid line to (x,y).
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 line(int px,
@@ -534,20 +539,20 @@
 }
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	drawwig (ptr, type)
  |
- | Results:	The point sequence found in the structure pointed by ptr is
- |		placed in integer arrays for further manipulation by the
- |		existing routing.  With the corresponding type parameter,
- |		either picurve or HGCurve are called.
- *----------------------------------------------------------------------------*/
+ | Results:	The point sequence found in the structure pointed by ptr
+ |		is placed in integer arrays for further manipulation by
+ |		the existing routing.  With the corresponding type
+ |		parameter, either picurve or HGCurve are called.
+ *--------------------------------------------------------------------*/
 
 void
 drawwig(POINT * ptr,
 	int type)
 {
-  register int npts;			/* point list index */
+  int npts;			/* point list index */
   int xMAXPOINTS, yMAXPOINTS;	/* point list */
 
   for (npts = 1; !Nullpoint(ptr); ptr = PTNextPoint(ptr), npts++) {
@@ -563,31 +568,32 @@
 }
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	HGArc (xcenter, ycenter, xstart, ystart, angle)
  |
- | Results:	This routine plots an arc centered about (cx, cy) counter
- |		clockwise starting from the point (px, py) through 'angle'
- |		degrees.  If angle is 0, a full circle is drawn.  It does so
- |		by creating a draw-path around the arc whose density of
- |		points depends on the size of the arc.
- *----------------------------------------------------------------------------*/
+ | Results:	This routine plots an arc centered about (cx, cy)
+ |		counter-clockwise starting from the point (px, py)
+ |		through 'angle' degrees.  If angle is 0, a full circle
+ |		is drawn.  It does so by creating a draw-path around the
+ |		arc whose density of points depends on the size of the
+ |		arc.
+ *--------------------------------------------------------------------*/
 
 void
-HGArc(register int cx,
-      register int cy,
+HGArc(int cx,
+      int cy,
       int px,
       int py,
       int angle)
 {
   double xs, ys, resolution, fullcircle;
   int m;
-  register int mask;
-  register int extent;
-  register int nx;
-  register int ny;
-  register int length;
-  register double epsilon;
+  int mask;
+  int extent;
+  int nx;
+  int ny;
+  int length;
+  double epsilon;
 
   xs = px - cx;
   ys = py - cy;
@@ -596,7 +602,7 @@
 
   resolution = (1.0 + groff_hypot(xs, ys) / res) * PointsPerInterval;
   /* mask = (1 << (int) log10(resolution + 1.0)) - 1; */
-  (void) frexp(resolution, &m);		/* A bit more elegant than log10 */
+  (void) frexp(resolution, &m);		/* more elegant than log10 */
   for (mask = 1; mask < m; mask = mask << 1);
   mask -= 1;
 
@@ -624,24 +630,24 @@
 }				/* end HGArc */
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	picurve (xpoints, ypoints, num_of_points)
  |
- | Results:	Draws a curve delimited by (not through) the line segments
- |		traced by (xpoints, ypoints) point list.  This is the 'Pic'
- |		style curve.
- *----------------------------------------------------------------------------*/
+ | Results:	Draws a curve delimited by (not through) the line
+ |		segments traced by (xpoints, ypoints) point list.  This
+ |		is the 'Pic'-style curve.
+ *--------------------------------------------------------------------*/
 
 void
-picurve(register int *x,
-	register int *y,
+picurve(int *x,
+	int *y,
 	int npts)
 {
-  register int nseg;		/* effective resolution for each curve */
-  register int xp;		/* current point (and temporary) */
-  register int yp;
-  int pxp, pyp;			/* previous point (to make lines from) */
-  int i;			/* inner curve segment traverser */
+  int nseg;		/* effective resolution for each curve */
+  int xp;		/* current point (and temporary) */
+  int yp;
+  int pxp, pyp;		/* previous point (to make lines from) */
+  int i;		/* inner curve segment traverser */
   int length = 0;
   double w;			/* position factor */
   double t1, t2, t3;		/* calculation temps */
@@ -671,7 +677,8 @@
 				/* 'nseg' is the number of line    */
 				/* segments that will be drawn for */
 				/* each curve segment.             */
-    nseg = (int) ((double) (nseg + (int) groff_hypot((double) xp, (double) yp)) /
+    nseg = (int) ((double) (nseg + (int) groff_hypot((double) xp,
+						     (double) yp)) /
 		  res * PointsPerInterval);
 
     for (i = 1; i < nseg; i++) {
@@ -692,15 +699,15 @@
 }
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	HGCurve(xpoints, ypoints, num_points)
  |
  | Results:	This routine generates a smooth curve through a set of
- |		points.  The method used is the parametric spline curve on
- |		unit knot mesh described in 'Spline Curve Techniques' by
- |		Patrick Baudelaire, Robert Flegal, and Robert Sproull --
- |		Xerox Parc.
- *----------------------------------------------------------------------------*/
+ |		points.  The method used is the parametric spline curve
+ |		on unit knot mesh described in 'Spline Curve Techniques'
+ |		by Patrick Baudelaire, Robert Flegal, and Robert Sproull
+ |		-- Xerox Parc.
+ *--------------------------------------------------------------------*/
 
 void
 HGCurve(int *x,
@@ -710,10 +717,10 @@
   double hMAXPOINTS, dxMAXPOINTS, dyMAXPOINTS;
   double d2xMAXPOINTS, d2yMAXPOINTS, d3xMAXPOINTS, d3yMAXPOINTS;
   double t, t2, t3;
-  register int j;
-  register int k;
-  register int nx;
-  register int ny;
+  int j;
+  int k;
+  int nx;
+  int ny;
   int lx, ly;
   int length = 0;
 
@@ -722,10 +729,10 @@
   tmove2(lx, ly);
 
   /*
-   * Solve for derivatives of the curve at each point separately for x and y
-   * (parametric).
+   * Solve for derivatives of the curve at each point separately for x
+   * and y (parametric).
    */
-  Paramaterize(x, y, h, numpoints);
+  Parameterize(x, y, h, numpoints);
 
   /* closed curve */
   if ((x1 == xnumpoints) && (y1 == ynumpoints)) {
@@ -737,8 +744,8 @@
   }
 
   /*
-   * generate the curve using the above information and PointsPerInterval
-   * vectors between each specified knot.
+   * Generate the curve using the above information and
+   * PointsPerInterval vectors between each specified knot.
    */
 
   for (j = 1; j < numpoints; ++j) {
@@ -760,26 +767,26 @@
 }				/* end HGCurve */
 
 
-/*----------------------------------------------------------------------------
- | Routine:	Paramaterize (xpoints, ypoints, hparams, num_points)
+/*--------------------------------------------------------------------*
+ | Routine:	Parameterize (xpoints, ypoints, hparams, num_points)
  |
- | Results:	This routine calculates parameteric values for use in
+ | Results:	This routine calculates parametric values for use in
  |		calculating curves.  The parametric values are returned
  |		in the array h.  The values are an approximation of
  |		cumulative arc lengths of the curve (uses cord length).
  |		For additional information, see paper cited below.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
-Paramaterize(int x,
+Parameterize(int x,
 	     int y,
 	     double h,
 	     int n)
 {
-  register int dx;
-  register int dy;
-  register int i;
-  register int j;
+  int dx;
+  int dy;
+  int i;
+  int j;
   double uMAXPOINTS;
 
   for (i = 1; i <= n; ++i) {
@@ -794,21 +801,21 @@
   }
   for (i = 1; i < n; ++i)
     hi = ui + 1 - ui;
-}				/* end Paramaterize */
+}				/* end Parameterize */
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	PeriodicSpline (h, z, dz, d2z, d3z, npoints)
  |
- | Results:	This routine solves for the cubic polynomial to fit a spline
- |		curve to the points specified by the list of values.
- |		The Curve generated is periodic.  The algorithms for this
- |		curve are from the 'Spline Curve Techniques' paper cited
- |		above.
- *----------------------------------------------------------------------------*/
+ | Results:	This routine solves for the cubic polynomial to fit a
+ |		spline curve to the points specified by the list of
+ |		values.  The curve generated is periodic.  The
+ |		algorithms for this curve are from the 'Spline Curve
+ |		Techniques' paper cited above.
+ *--------------------------------------------------------------------*/
 
 void
-PeriodicSpline(double h,	/* paramaterization  */
+PeriodicSpline(double h,	/* parameterization  */
 	       int z,		/* point list */
 	       double dz,	/* to return the 1st derivative */
 	       double d2z,	/* 2nd derivative */
@@ -870,14 +877,14 @@
 }				/* end PeriodicSpline */
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------
  | Routine:	NaturalEndSpline (h, z, dz, d2z, d3z, npoints)
  |
- | Results:	This routine solves for the cubic polynomial to fit a spline
- |		curve the points specified by the list of values.  The
- |		algorithms for this curve are from the 'Spline Curve
+ | Results:	This routine solves for the cubic polynomial to fit a
+ |		spline curve the points specified by the list of values.
+ |		The algorithms for this curve are from the 'Spline Curve
  |		Techniques' paper cited above.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 NaturalEndSpline(double h,	/* parameterization */
@@ -926,20 +933,20 @@
 }				/* end NaturalEndSpline */
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	change (x_position, y_position, visible_flag)
  |
  | Results:	As HGtline passes from the invisible to visible (or vice
- |		versa) portion of a line, change is called to either draw
- |		the line, or initialize the beginning of the next one.
- |		Change calls line to draw segments if visible_flag is set
- |		(which means we're leaving a visible area).
- *----------------------------------------------------------------------------*/
+ |		versa) portion of a line, change is called to either
+ |		draw the line, or initialize the beginning of the next
+ |		one.  Change calls line to draw segments if visible_flag
+ |		is set (which means we're leaving a visible area).
+ *--------------------------------------------------------------------*/
 
 void
-change(register int x,
-       register int y,
-       register int vis)
+change(int x,
+       int y,
+       int vis)
 {
   static int length = 0;
 
@@ -949,35 +956,36 @@
       length = 0;
       printf("\\\n");
     }
-  } else {			/* otherwise, we're entering one, remember */
-				/* beginning                               */
+  } else {			/* otherwise entering one; remember */
+				/* beginning                        */
     tmove2(x, y);
   }
 }
 
 
-/*----------------------------------------------------------------------------
+/*--------------------------------------------------------------------*
  | Routine:	HGtline (xstart, ystart, xend, yend)
  |
- | Results:	Draws a line from current position to (x1,y1) using line(x1,
- |		y1) to place individual segments of dotted or dashed lines.
- *----------------------------------------------------------------------------*/
+ | Results:	Draws a line from current position to (x1,y1) using
+ |		line(x1, y1) to place individual segments of dotted or
+ |		dashed lines.
+ *--------------------------------------------------------------------*/
 
 void
 HGtline(int x_1,
 	int y_1)
 {
-  register int x_0 = lastx;
-  register int y_0 = lasty;
-  register int dx;
-  register int dy;
-  register int oldcoord;
-  register int res1;
-  register int visible;
-  register int res2;
-  register int xinc;
-  register int yinc;
-  register int dotcounter;
+  int x_0 = lastx;
+  int y_0 = lasty;
+  int dx;
+  int dy;
+  int oldcoord;
+  int res1;
+  int visible;
+  int res2;
+  int xinc;
+  int yinc;
+  int dotcounter;
 
   if (linmod == SOLID) {
     line(x_1, y_1);
@@ -1045,4 +1053,8 @@
     change(x_1, y_1, 0);
 }
 
-/* EOF */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/hpoint.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/hpoint.cpp Changed

@@ -1,8 +1,8 @@
 /* Last non-groff version: hpoint.c  1.1  84/10/08 */
 
 /*
- * This file contains routines for manipulating the point data structures
- * for the gremlin picture editor.
+ * This file contains routines for manipulating the point data
+ * structures for the gremlin picture editor.
  */
 
 #ifdef HAVE_CONFIG_H
@@ -12,6 +12,8 @@
 #include <stdlib.h>
 #include "gprint.h"
 
+/* imports from main.cpp */
+extern void *grnmalloc(size_t size, const char *what);
 
 /*
  * Return pointer to empty point list.
@@ -24,23 +26,23 @@
 
 
 /*
- * This routine creates a new point with coordinates x and y and links it
- * into the pointlist.
+ * This routine creates a new point with coordinates x and y and links
+ * it into the point list.
  */
 POINT *
 PTMakePoint(double x,
 	    double y,
 	    POINT **pplist)
 {
-  register POINT *pt;
+  POINT *pt;
 
   if (Nullpoint(pt = *pplist)) {	/* empty list */
-    *pplist = (POINT *) malloc(sizeof(POINT));
+    *pplist = (POINT *) grnmalloc(sizeof(POINT), "initial point");
     pt = *pplist;
   } else {
     while (!Nullpoint(pt->nextpt))
       pt = pt->nextpt;
-    pt->nextpt = (POINT *) malloc(sizeof(POINT));
+    pt->nextpt = (POINT *) grnmalloc(sizeof(POINT), "subsequent point");
     pt = pt->nextpt;
   }
 
@@ -50,4 +52,8 @@
   return (pt);
 }				/* end PTMakePoint */
 
-/* EOF */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/grn/main.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/grn/main.cpp Changed

@@ -6,64 +6,70 @@
  *
  *
  * This file contains the main and file system dependent routines for
- * processing gremlin files into troff input.  The program watches input go
- * by to standard output, only interpreting things between .GS and .GE
- * lines.  Default values (font, size, scale, thickness) may be overridden
- * with a 'default' command and are further overridden by commands in the
- * input.
+ * processing gremlin files into troff input.  The program watches input
+ * go by to standard output, only interpreting things between .GS and
+ * .GE lines.  Default values (font, size, scale, thickness) may be
+ * overridden with a 'default' command and are further overridden by
+ * commands in the input.
  *
- * Inside the GS and GE, commands are accepted to reconfigure the picture.
- * At most one command may reside on each line, and each command is followed
- * by a parameter separated by white space.  The commands are as follows,
- * and may be abbreviated down to one character (with exception of 'scale'
- * and 'stipple' down to "sc" and "st") and may be upper or lower case.
+ * Inside the GS and GE, commands are accepted to reconfigure the
+ * picture.  At most one command may reside on each line, and each
+ * command is followed by a parameter separated by white space.  The
+ * commands are as follows, and may be abbreviated down to one character
+ * (with exception of 'scale' and 'stipple' down to "sc" and "st") and
+ * may be upper or lower case.
  *
  *                        default  -  Make all settings in the current
- *                                    .GS/.GE the global defaults.  Height,
- *                                    width and file are NOT saved.
- *                     1, 2, 3, 4  -  Set size 1, 2, 3, or 4 (followed by an
- *                                    integer point size).
- *  roman, italics, bold, special  -  Set gremlin's fonts to any other troff
- *                                    font (one or two characters).
- *                     stipple, l  -  Use a stipple font for polygons.  Arg
- *                                    is troff font name.  No Default.  Can
- *                                    use only one stipple font per picture.
- *                                    (See below for stipple font index.)
+ *                                    .GS/.GE the global defaults.
+ *                                    Height, width and file are NOT
+ *                                    saved.
+ *                     1, 2, 3, 4  -  Set size 1, 2, 3, or 4 (followed
+ *                                    by an integer point size).
+ *  roman, italics, bold, special  -  Set gremlin's fonts to any other
+ *                                    troff font (1 or 2 characters).
+ *                     stipple, l  -  Use a stipple font for polygons.
+ *                                    Arg is troff font name.  No
+ *                                    default.  Can use only one stipple
+ *                                    font per picture.  (See below for
+ *                                    stipple font index.)
  *                       scale, x  -  Scale is IN ADDITION to the global
  *                                    scale factor from the default.
- *                     pointscale  -  Turn on scaling point sizes to match
- *                                    'scale' commands.  (Optional operand
- *                                    'off' to turn it off.)
+ *                     pointscale  -  Turn on scaling point sizes to
+ *                                    match 'scale' commands.  (Optional
+ *                                    operand 'off' to turn it off.)
  *          narrow, medium, thick  -  Set widths of lines.
- *                           file  -  Set the file name to read the gremlin
- *                                    picture from.  If the file isn't in
- *                                    the current directory, the gremlin
- *                                    library is tried.
+ *                           file  -  Set the file name to read the
+ *                                    gremlin picture from.  If the file
+ *                                    isn't in the current directory,
+ *                                    the gremlin library is tried.
  *                  width, height  -  These two commands override any
- *                                    scaling factor that is in effect, and
- *                                    forces the picture to fit into either
- *                                    the height or width specified,
- *                                    whichever makes the picture smaller.
- *                                    The operand for these two commands is
- *                                    a floating-point number in units of
+ *                                    scaling factor that is in effect,
+ *                                    and forces the picture to fit into
+ *                                    either the height or width
+ *                                    specified, whichever makes the
+ *                                    picture smaller.  The operand for
+ *                                    these two commands is a
+ *                                    floating-point number in units of
  *                                    inches.
- *            l<nn> (integer <nn>) -  Set association between stipple <nn>
- *                                    and a stipple 'character'.  <nn> must
- *                                    be in the range 0 to NSTIPPLES (16)
- *                                    inclusive.  The integer operand is an
- *                                    index in the stipple font selected.
- *                                    Valid cf (cifplot) indices are 1-32
- *                                    (although 24 is not defined), valid ug
- *                                    (unigrafix) indices are 1-14, and
- *                                    valid gs (gray scale) indices are
- *                                    0-16.  Nonetheless, any number between
- *                                    0 and 255 is accepted since new
- *                                    stipple fonts may be added.  An
- *                                    integer operand is required.
+ *            l<nn> (integer <nn>) -  Set association between stipple
+ *                                    <nn> and a stipple 'character'.
+ *                                    <nn> must be in the range 0 to
+ *                                    NSTIPPLES (16) inclusive.  The
+ *                                    integer operand is an index in the
+ *                                    stipple font selected.  Valid cf
+ *                                    (cifplot) indices are 1-32
+ *                                    (although 24 is not defined),
+ *                                    valid ug (unigrafix) indices are
+ *                                    1-14, and valid gs (gray scale)
+ *                                    indices are 0-16.  Nonetheless,
+ *                                    any number between 0 and 255 is
+ *                                    accepted since new stipple fonts
+ *                                    may be added.  An integer operand
+ *                                    is required.
  *
- * Troff number registers used:  g1 through g9.  g1 is the width of the
- * picture, and g2 is the height.  g3, and g4, save information, g8 and g9
- * are used for text processing and g5-g7 are reserved.
+ * Troff number registers used: g1 through g9.  g1 is the width of the
+ * picture, and g2 is the height.  g3, and g4, save information, g8 and
+ * g9 are used for text processing and g5-g7 are reserved.
  */
 
 
@@ -71,6 +77,7 @@
 
 #include <ctype.h>
 #include <stdlib.h>
+#include <errno.h> // errno
 #include "gprint.h"
 
 #include "device.h"
@@ -88,11 +95,11 @@
 
 extern void HGPrintElt(ELT *element, int baseline);
 extern ELT *DBInit();
-extern ELT *DBRead(register FILE *file);
+extern ELT *DBRead(FILE *file);
 extern POINT *PTInit();
 extern POINT *PTMakePoint(double x, double y, POINT **pplist);
 
-#define INIT_FILE_SIZE 50  /* Initial size of array of files from cmd line. */
+#define INIT_FILE_SIZE 50  /* Initial sz of file array from cmd line. */
 #define FILE_SIZE_INCR 50  /* Amount to increase array of files by. */
 
 #define SUN_SCALEFACTOR 0.70
@@ -100,13 +107,13 @@
 /* #define DEFSTIPPLE    "gs" */
 #define DEFSTIPPLE	"cf"
 /*
- * This grn implementation emits '.st' requests to control stipple effects,
- * but groff does not (currently) support any such request.
+ * This grn implementation emits '.st' requests to control stipple
+ * effects, but groff does not (currently) support any such request.
  *
- * This hack disables the emission of such requests, without destroying the
- * infrastructure necessary to support the feature in the future; to enable
- * the emission of '.st' requests, at a future date when groff can support
- * them, simply rewrite the following #define as:
+ * This hack disables the emission of such requests, without destroying
+ * the infrastructure necessary to support the feature in the future; to
+ * enable the emission of '.st' requests, at a future date when groff
+ * can support them, simply rewrite the following #define as:
  *
  *   #define USE_ST_REQUEST  stipple
  *
@@ -118,7 +125,7 @@
 
 #define SCREENtoINCH	0.02	/* scaling factor, screen to inches */
 
-#define BIG	999999999999.0	/* unweildly large floating number */
+#define BIG	999999999999.0	/* unwieldy large floating number */
 
 
 /* static char sccsid = "@(#) (Berkeley) 8/5/85, 12/28/99"; */
@@ -129,12 +136,13 @@
 
 double linethickness;		/* brush styles */
 int linmod;
-int lastx;			/* point registers for printing elements */
-int lasty;
-int lastyline;			/* A line's vertical position is NOT the  */
-				/* same after that line is over, so for a */
-				/* line of drawing commands, vertical     */
-				/* spacing is kept in lastyline           */
+int lastx;			/* point registers for printing */
+int lasty;			/* elements                     */
+int lastyline;			/* A line's vertical position is NOT  */
+				/* the same after that line is over,  */
+				/* so for a line of drawing commands, */
+				/* vertical spacing is kept in        */
+				/* lastyline.                         */
 
 /* These are the default fonts, sizes, line styles, */
 /* and thicknesses.  They can be modified from a    */
@@ -155,12 +163,12 @@
  1 * BASE_THICKNESS,
  3 * BASE_THICKNESS};
 
-/* int cf_stipple_indexNSTIPPLES + 1 =                                  */
-/* {0, 1, 3, 12, 14, 16, 19, 21, 23};                                     */
-/* a logarithmic scale looks better than a linear one for the gray shades */
-/*                                                                        */
-/* int other_stipple_indexNSTIPPLES + 1 =                               */
-/* {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16};            */
+/* int cf_stipple_indexNSTIPPLES + 1 =                              */
+/* {0, 1, 3, 12, 14, 16, 19, 21, 23};                                 */
+/* a logarithmic scale looks better than a linear one for gray shades */
+/*                                                                    */
+/* int other_stipple_indexNSTIPPLES + 1 =                           */
+/* {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16};        */
 
 int cf_stipple_indexNSTIPPLES + 1 =
 {0, 18, 32, 56, 100, 178, 316, 562, 1000};	/* only 1-8 used */
@@ -174,50 +182,49 @@
 int styleSTYLES =
 {DOTTED, DOTDASHED, SOLID, DASHED, SOLID, SOLID};
 double scale = 1.0;		/* no scaling, default */
-int defpoint = 0;		/* flag for pointsize scaling */
+int defpoint = 0;		/* flag for point size scaling */
 char *defstipple = (char *) 0;
 enum E {
   OUTLINE, FILL, BOTH
 } polyfill;
 
-/* flag to controll filling of polygons */
+/* flag to control filling of polygons */
 
 double adj1 = 0.0;
 double adj2 = 0.0;
 double adj3 = 0.0;
 double adj4 = 0.0;
 
-double thickSTYLES;		/* thicknesses set by defaults, then by */
-				/* commands                             */
-char *tfontFONTS;		/* fonts originally set to deffont values, */
-				/* then                                    */
-int tsizeSIZES;		/* optionally changed by commands inside */
-				/* grn                                   */
-int stipple_indexNSTIPPLES + 1;	/* stipple font file indices */
+double thickSTYLES;		/* thicknesses set by defaults, then  */
+				/* by commands                        */
+char *tfontFONTS;		/* fonts originally set to deffont    */
+				/* values, then optionally changed by */
+int tsizeSIZES;		/* commands inside grn                */
+int stipple_indexNSTIPPLES + 1;	/* stipple font file indices  */
 char *stipple;
 
-double xscale;			/* scaling factor from individual pictures */
-double troffscale;		/* scaling factor at output time */
+double xscale;		/* scaling factor from individual pictures */
+double troffscale;	/* scaling factor at output time */
 
-double width;			/* user-request maximum width for picture */
-				/* (in inches)                            */
-double height;			/* user-request height */
-int pointscale;			/* flag for pointsize scaling */
-int setdefault;			/* flag for a .GS/.GE to remember all */
-				/* settings                           */
-int sflag;			/* -s flag: sort order (do polyfill first) */
+double width;		/* user-request maximum width for picture */
+			/* (in inches)                            */
+double height;		/* user-request height */
+int pointscale;		/* flag for point size scaling */
+int setdefault;		/* flag for a .GS/.GE to remember all */
+			/* settings                           */
+int sflag;		/* -s flag: sort order (do polyfill first) */
 
-double toppoint;		/* remember the picture */
-double bottompoint;		/* bounds in these variables */
+double toppoint;	/* remember the picture */
+double bottompoint;	/* bounds in these variables */
 double leftpoint;
 double rightpoint;
 
-int ytop;			/* these are integer versions of the above */
-int ybottom;			/* so not to convert each time they're used */
+int ytop;		/* these are integer versions of the above */
+int ybottom;		/* so not to convert each time they're used */
 int xleft;
 int xright;
 
-int linenum = 0;		/* line number of input file */
+static int linenum = 0;		/* line number of troff input file */
 char inputlineMAXINLINE;	/* spot to filter through the file */
 char *c1 = inputline;		/* c1, c2, and c3 will be used to */
 char *c2 = inputline + 1;	/* hunt for lines that begin with */
@@ -231,18 +238,31 @@
 
 void getres();
 int doinput(FILE *fp);
-void conv(register FILE *fp, int baseline);
+void conv(FILE *fp, int baseline);
 void savestate();
-int has_polygon(register ELT *elist);
+int has_polygon(ELT *elist);
 void interpret(char *line);
 
+void *
+grnmalloc(size_t size,
+	  const char *what)
+{
+  void *ptr = 0;
+  ptr = malloc(size);
+  if (!ptr) {
+    fatal("memory allocation failed for %1: %2", what, strerror(errno));
+  }
+  return ptr;
+}
 
 void
 usage(FILE *stream)
 {
   fprintf(stream,
-	  "usage: %s  -vCs   -M dir   -F dir   -T dev   file \n",
-	  program_name);
+	  "usage: %s -Cs -M dir -F dir -T dev file ...\n"
+	  "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 
@@ -256,7 +276,7 @@
 {
   if (*count >= *cur_size) {
     *cur_size += FILE_SIZE_INCR;
-    file = (char **) realloc((char **) file, *cur_size * sizeof(char *));
+    file = (char **) realloc(file, *cur_size * sizeof(char *));
     if (file == NULL) {
       fatal("unable to extend file array");
     }
@@ -268,14 +288,14 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	main (argument_count, argument_pointer)
  |
- | Results:	Parses the command line, accumulating input file names, then
- |		reads the inputs, passing it directly to output until a '.GS'
- |		line is read.  Main then passes control to 'conv' to do the
- |		gremlin file conversions.
- *----------------------------------------------------------------------------*/
+ | Results:	Parses the command line, accumulating input file names,
+ |		then reads the inputs, passing it directly to output
+ |		until a '.GS' line is read.  Main then passes control to
+ |		'conv' to do the gremlin file conversions.
+ *--------------------------------------------------------------------*/
 
 int
 main(int argc,
@@ -283,17 +303,16 @@
 {
   setlocale(LC_NUMERIC, "C");
   program_name = argv0;
-  register FILE *fp;
-  register int k;
-  register char c;
+  FILE *fp;
+  int k;
+  char c;
   int gfil = 0;
   char **file = NULL;
   int file_cur_size = INIT_FILE_SIZE;
   char *operand(int *argcp, char ***argvp);
 
-  if ((file = (char **) malloc(file_cur_size * sizeof(char *))) == NULL) {
-    fatal("unable to create file array");
-  }
+  file = (char **) grnmalloc(file_cur_size * sizeof(char *),
+			     "file array");
   while (--argc) {
     if (**++argv != '-')
       file = add_file(file, *argv, &gfil, &file_cur_size);
@@ -345,7 +364,7 @@
       }
   }
 
-  getres();			/* set the resolution for an output device */
+  getres();		/* set the resolution for an output device */
 
   if (gfil == 0) {		/* no filename, use standard input */
     file0 = NULL;
@@ -375,16 +394,16 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	char  * operand (& argc, & argv)
  |
  | Results:	Returns address of the operand given with a command-line
- |		option.  It uses either '-Xoperand' or '-X operand', whichever
- |		is present.  The program is terminated if no option is
- |		present.
+ |		option.  It uses either '-Xoperand' or '-X operand',
+ |		whichever is present.  The program is terminated if no
+ |		option is present.
  |
  | Side Efct:	argc and argv are updated as necessary.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 char *
 operand(int *argcp,
@@ -400,19 +419,20 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	getres ()
  |
  | Results:	Sets 'res' to the resolution of the output device.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 getres()
 {
   int linepiece;
 
-  if (!font::load_desc())
-    fatal("sorry, I can't continue");
+  if (0 /* nullptr */ == font::load_desc())
+    fatal("cannot load 'DESC' description file for device '%1'",
+	  device);
 
   res = font::res;
 
@@ -432,7 +452,7 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	int  doinput (file_pointer)
  |
  | Results:	A line of input is read into 'inputline'.
@@ -441,7 +461,7 @@
  |
  | Bugs:	Lines longer than MAXINLINE are NOT checked, except for
  |		updating 'linenum'.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 int
 doinput(FILE *fp)
@@ -454,19 +474,19 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	initpic ( )
  |
  | Results:	Sets all parameters to the normal defaults, possibly
- |		overridden by a setdefault command.  Initialize the picture
- |		variables, and output the startup commands to troff to begin
- |		the picture.
- *----------------------------------------------------------------------------*/
+ |		overridden by a setdefault command.  Initialize the
+ |		picture variables, and output the startup commands to
+ |		troff to begin the picture.
+ *--------------------------------------------------------------------*/
 
 void
 initpic()
 {
-  register int i;
+  int i;
 
   for (i = 0; i < STYLES; i++) {	/* line thickness defaults */
     thicki = defthicki;
@@ -477,22 +497,23 @@
   for (i = 0; i < SIZES; i++) {		/* font size defaults */
     tsizei = defsizei;
   }
-  for (i = 0; i <= NSTIPPLES; i++) {	/* stipple font file default indices */
+  for (i = 0; i <= NSTIPPLES; i++) {	/* stipple font file default */
+					/* indices                   */
     stipple_indexi = defstipple_indexi;
   }
   stipple = defstipple;
 
   gremlinfile0 = 0;		/* filename is 'null' */
-  setdefault = 0;		/* this is not the default settings (yet) */
+  setdefault = 0;		/* not the default settings (yet) */
 
   toppoint = BIG;		/* set the picture bounds out */
   bottompoint = -BIG;		/* of range so they'll be set */
   leftpoint = BIG;		/* by 'savebounds' on input */
   rightpoint = -BIG;
 
-  pointscale = defpoint;	/* flag for scaling point sizes default */
-  xscale = scale;		/* default scale of individual pictures */
-  width = 0.0;			/* size specifications input by user */
+  pointscale = defpoint;/* flag for scaling point sizes default */
+  xscale = scale;	/* default scale of individual pictures */
+  width = 0.0;		/* size specifications input by user */
   height = 0.0;
 
   linethickness = DEFTHICK;	/* brush styles */
@@ -500,30 +521,30 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	conv (file_pointer, starting_line)
  |
  | Results:	At this point, we just passed a '.GS' line in the input
- |		file.  conv reads the input and calls 'interpret' to process
- |		commands, gathering up information until a '.GE' line is
- |		found.  It then calls 'HGPrint' to do the translation of the
- |		gremlin file to troff commands.
- *----------------------------------------------------------------------------*/
+ |		file.  conv reads the input and calls 'interpret' to
+ |		process commands, gathering up information until a '.GE'
+ |		line is found.  It then calls 'HGPrint' to do the
+ |		translation of the gremlin file to troff commands.
+ *--------------------------------------------------------------------*/
 
 void
-conv(register FILE *fp,
+conv(FILE *fp,
      int baseline)
 {
-  register FILE *gfp = NULL;	/* input file pointer */
-  register int done = 0;	/* flag to remember if finished */
-  register ELT *e;		/* current element pointer */
-  ELT *PICTURE;			/* whole picture data base pointer */
-  double temp;			/* temporary calculating area */
-  /* POINT ptr; */		/* coordinates of a point to pass to 'mov' */
-				/* routine                                 */
-  int flyback;			/* flag 'want to end up at the top of the */
-				/* picture?'                              */
-  int compat;			/* test character after .GE or .GF */
+  FILE *gfp = NULL;	/* input file pointer */
+  int done = 0;	/* flag to remember if finished */
+  ELT *e;		/* current element pointer */
+  ELT *PICTURE;		/* whole picture data base pointer */
+  double temp;		/* temporary calculating area */
+  /* POINT ptr; */	/* coordinates of a point to pass to 'mov' */
+			/* routine                                 */
+  int flyback;		/* flag 'want to end up at the top of the */
+			/* picture?'                              */
+  int compat;		/* test character after .GE or .GF */
 
 
   initpic();			/* set defaults, ranges, etc. */
@@ -543,13 +564,15 @@
 
       if (!gremlinfile0) {
 	if (!setdefault)
-	  error("at line %1: no picture filename.\n", baseline);
+	  error("no picture file name at line %1", baseline);
 	return;
       }
       char *path;
       gfp = macro_path.open_file(gremlinfile, &path);
-      if (!gfp)
+      if (0 /* nullptr */ == gfp) {
+	error("cannot open picture file '%1'", gremlinfile);
 	return;
+      }
       PICTURE = DBRead(gfp);	/* read picture file */
       fclose(gfp);
       free(path);
@@ -560,7 +583,7 @@
 
       if (stipple == (char *) NULL)	/* if user forgot stipple    */
 	if (has_polygon(PICTURE))	/* and picture has a polygon */
-	  stipple = (char *)DEFSTIPPLE;		/* then set the default      */
+	  stipple = (char *)DEFSTIPPLE;	/* then set the default      */
 
       if ((temp = bottompoint - toppoint) < 0.1)
 	temp = 0.1;
@@ -574,21 +597,22 @@
       else {
 	if (temp < troffscale)
 	  troffscale = temp;
-      }				/* here, troffscale is the */
+      }				/* here, troffscale is the  */
 				/* picture's scaling factor */
       if (pointscale) {
-	register int i;		/* do pointscaling here, when */
+	int i;			/* do point scaling here, when   */
 				/* scale is known, before output */
 	for (i = 0; i < SIZES; i++)
 	  tsizei = (int) (troffscale * (double) tsizei + 0.5);
       }
 
-						/* change to device units */
-      troffscale *= SCREENtoINCH * res;		/* from screen units */
+					/* change to device units */
+      troffscale *= SCREENtoINCH * res;	/* from screen units      */
 
-      ytop = (int) (toppoint * troffscale);		/* calculate integer */
-      ybottom = (int) (bottompoint * troffscale);	/* versions of the   */
-      xleft = (int) (leftpoint * troffscale);		/* picture limits    */
+      /* Calculate integer versions of the picture limits. */
+      ytop = (int) (toppoint * troffscale);
+      ybottom = (int) (bottompoint * troffscale);
+      xleft = (int) (leftpoint * troffscale);
       xright = (int) (rightpoint * troffscale);
 
       /* save stuff in number registers,    */
@@ -619,11 +643,11 @@
        * print only the interiors of filled polygons (as borderless
        * polygons).  Second time, print the outline as series of line
        * segments.  This way, postprocessors that overwrite rather than
-       * merge picture elements (such as Postscript) can still have text and
-       * graphics on a shaded background.
+       * merge picture elements (such as Postscript) can still have text
+       * and graphics on a shaded background.
        */
       /* if (sflag) */
-      if (!sflag) {		/* changing the default for filled polygons */
+      if (!sflag) {	/* changing the default for filled polygons */
 	e = PICTURE;
 	polyfill = FILL;
 	while (!DBNullelt(e)) {
@@ -639,7 +663,7 @@
       e = PICTURE;
 
       /* polyfill = !sflag ? BOTH : OUTLINE; */
-      polyfill = sflag ? BOTH : OUTLINE;	/* changing the default */
+      polyfill = sflag ? BOTH : OUTLINE;	/* changing default */
       while (!DBNullelt(e)) {
 	printf(".mk\n");
 	HGPrintElt(e, baseline);
@@ -651,9 +675,9 @@
 
       /* decide where to end picture */
 
-      /* I changed everything here.  I always use the combination .mk and */
-      /* .rt so once finished I just space down the heigth of the picture */
-      /* that is \n(g2u                                                   */
+      /* I Senderowicz? changed everything here.  I always use the */
+      /* combination .mk and .rt, so once finished I just space down */
+      /* height of the picture that is \n(g2u.                       */
       if (flyback) {		/* end picture at upper left */
 	/* ptr.x = leftpoint;
 	   ptr.y = toppoint; */
@@ -665,8 +689,8 @@
 
       /* tmove(&ptr); */	/* restore default line parameters */
 
-      /* restore everything to the way it was before the .GS, then put */
-      /* out the '.GE' line from user                                  */
+      /* Restore everything to the way it was before the .GS, then */
+      /* put out the '.GE' line from user                          */
 
       /* printf("\\D't %du'\\D's %du'\n", DEFTHICK, DEFSTYLE); */
       /* groff doesn't understand the \Ds command */
@@ -686,21 +710,21 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	savestate  ( )
  |
- | Results:	all the current  scaling / font size / font name / thickness
- |		/ pointscale settings are saved to be the defaults.  Scaled
- |		point sizes are NOT saved.  The scaling is done each time a
- |		new picture is started.
+ | Results:	All the current scaling/font size/font name/thickness/
+ |		pointscale settings are made the defaults.  Scaled
+ |		point sizes are NOT saved.  The scaling is done each
+ |		time a new picture is started.
  |
  | Side Efct:	scale, and def* are modified.
- *----------------------------------------------------------------------------*/
+ *--------------------------------------------------------------------*/
 
 void
 savestate()
 {
-  register int i;
+  int i;
 
   for (i = 0; i < STYLES; i++)	/* line thickness defaults */
     defthicki = thicki;
@@ -708,24 +732,25 @@
     deffonti = tfonti;
   for (i = 0; i < SIZES; i++)	/* font size defaults */
     defsizei = tsizei;
-  for (i = 0; i <= NSTIPPLES; i++)	/* stipple font file default indices */
+  /* stipple font file default indices */
+  for (i = 0; i <= NSTIPPLES; i++)
     defstipple_indexi = stipple_indexi;
 
-  defstipple = stipple;		/* if stipple has been set, it's remembered */
-  scale *= xscale;		/* default scale of individual pictures */
-  defpoint = pointscale;	/* flag for scaling pointsizes from x factors */
+  defstipple = stipple;	/* if stipple has been set, it's remembered */
+  scale *= xscale;	/* default scale of individual pictures */
+  defpoint = pointscale;/* flag to scale point sizes from x factors */
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	savebounds (x_coordinate, y_coordinate)
  |
- | Results:	Keeps track of the maximum and minimum extent of a picture
- |		in the global variables: left-, right-, top- and
- |		bottompoint.  'savebounds' assumes that the points have been
- |		oriented to the correct direction.  No scaling has taken
- |		place, though.
- *----------------------------------------------------------------------------*/
+ | Results:	Keeps track of the maximum and minimum extent of a
+ |		picture in the global variables: left-, right-, top- and
+ |		bottompoint.  'savebounds' assumes that the points have
+ |		been oriented to the correct direction.  No scaling has
+ |		taken place, though.
+ *--------------------------------------------------------------------*/
 
 void
 savebounds(double x,
@@ -742,27 +767,26 @@
 }
 
 
-/*----------------------------------------------------------------------------*
+/*--------------------------------------------------------------------*
  | Routine:	interpret (character_string)
  |
  | Results:	Commands are taken from the input string and performed.
- |		Commands are separated by the endofline, and are of the
+ |		Commands are separated by newlines, and are of the
  |		format:
  |			string1 string2
+ |		where string1 is the command, string2 the argument.
  |
- |		where string1 is the command and string2 is the argument.
- |
- | Side Efct:	Font and size strings, plus the gremlin file name and the
- |		width and height variables are set by this routine.
- *----------------------------------------------------------------------------*/
+ | Side Efct:	Font and size strings, plus the gremlin file name and
+ |		the width and height variables are set by this routine.
+ *--------------------------------------------------------------------*/
 
 void
 interpret(char *line)
 {
   char str1MAXINLINE;
   char str2MAXINLINE;
-  register char *chr;
-  register int i;
+  char *chr;
+  int i;
   double par;
 
   str20 = '\0';
@@ -787,21 +811,21 @@
   case 'r':			/* roman */
     if (str20 < '0')
       goto nofont;
-    tfont0 = (char *) malloc(strlen(str2) + 1);
+    tfont0 = (char *) grnmalloc(strlen(str2) + 1, "roman command");
     strcpy(tfont0, str2);
     break;
 
   case 'i':			/* italics */
     if (str20 < '0')
       goto nofont;
-    tfont1 = (char *) malloc(strlen(str2) + 1);
+    tfont1 = (char *) grnmalloc(strlen(str2) + 1, "italics command");
     strcpy(tfont1, str2);
     break;
 
   case 'b':			/* bold */
     if (str20 < '0')
       goto nofont;
-    tfont2 = (char *) malloc(strlen(str2) + 1);
+    tfont2 = (char *) grnmalloc(strlen(str2) + 1, "bold command");
     strcpy(tfont2, str2);
     break;
 
@@ -811,13 +835,13 @@
 
     if (str20 < '0') {
   nofont:
-      error("no fontname specified in line %1", linenum);
+      error("no font name specified in line %1", linenum);
       break;
     }
     if (str11 == 't')
       goto stipplecommand;	/* or stipple */
 
-    tfont3 = (char *) malloc(strlen(str2) + 1);
+    tfont3 = (char *) grnmalloc(strlen(str2) + 1, "special command");
     strcpy(tfont3, str2);
     break;
 
@@ -840,7 +864,7 @@
     }
 
   stipplecommand:		/* set stipple name */
-    stipple = (char *) malloc(strlen(str2) + 1);
+    stipple = (char *) grnmalloc(strlen(str2) + 1, "stipple command");
     strcpy(stipple, str2);
     /* if it's a 'known' font (currently only 'cf'), set indices    */
     if (strcmp(stipple, "cf") == 0)
@@ -935,7 +959,7 @@
  */
 
 int
-has_polygon(register ELT *elist)
+has_polygon(ELT *elist)
 {
   while (!DBNullelt(elist)) {
     if (elist->type == POLYGON)
@@ -946,4 +970,8 @@
   return (0);
 }
 
-/* EOF */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/html/html.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/html/html.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/html/pre-html.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/html/pre-html.cpp Changed

@@ -1,33 +1,34 @@
-// -*- C++ -*-
-/* Copyright (C) 2000-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2000-2021 Free Software Foundation, Inc.
  * Written by Gaius Mulley (gaius@glam.ac.uk).
  *
  * 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 the Free
- * Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
+ * 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 (at
+ * your option) any later version.
  *
- * groff is distributed in the hope that it will be useful, but WITHOUT ANY
- * WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * 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 file COPYING.  If not, write to the Free Software
- * Foundation, 51 Franklin St - Fifth Floor, Boston, MA 02110-1301, USA. 
+ * You should have received a copy of the GNU General Public License
+ * along with groff; see the file COPYING.  If not, write to the Free
+ * Software Foundation, 51 Franklin St - Fifth Floor, Boston, MA
+ * 02110-1301, USA.
  */
 
 #define PREHTMLC
 
 #include "lib.h"
 
-#include <signal.h>
-#include <ctype.h>
 #include <assert.h>
-#include <stdlib.h>
+#include <ctype.h>
 #include <errno.h>
+#include <signal.h>
+#include <stdlib.h>
+
 #include "errarg.h"
 #include "error.h"
 #include "stringclass.h"
@@ -67,8 +68,8 @@
 
 #if defined(__MSDOS__) || defined(_WIN32)
 
-// Most MS-DOS and Win32 environments will be missing the 'fork' capability
-// (some like Cygwin have it, but it is best avoided).
+// Most MS-DOS and Win32 environments will be missing the 'fork'
+// capability (some, like Cygwin, have it, but it is better avoided).
 
 # define MAY_FORK_CHILD_PROCESS 0
 
@@ -133,8 +134,8 @@
 
 #ifdef DEBUGGING
 // For a DEBUGGING version, we need some additional macros,
-// to direct the captured debug mode output to appropriately named files
-// in the specified DEBUG_FILE_DIR.
+// to direct the captured debugging mode output to appropriately named
+// files in the specified DEBUG_FILE_DIR.
 
 # define DEBUG_TEXT(text) #text
 # define DEBUG_NAME(text) DEBUG_TEXT(text)
@@ -149,7 +150,7 @@
 
 #define DEFAULT_LINE_LENGTH 7	// inches wide
 #define DEFAULT_IMAGE_RES 100	// number of pixels per inch resolution
-#define IMAGE_BOARDER_PIXELS 0
+#define IMAGE_BORDER_PIXELS 0
 #define INLINE_LEADER_CHAR '\\'
 
 // Don't use colour names here!  Otherwise there is a dependency on
@@ -165,57 +166,61 @@
 #define REGION_TEMPLATE_SHORT "rg"
 #define REGION_TEMPLATE_LONG "-regions-"
 
-#if !defined(TRUE)
-# define TRUE (1==1)
-#endif
-#if !defined(FALSE)
-# define FALSE (1==0)
-#endif
-
 typedef enum {
   CENTERED, LEFT, RIGHT, INLINE
 } IMAGE_ALIGNMENT;
 
 typedef enum {xhtml, html4} html_dialect;
 
-static int postscriptRes = -1;		// postscript resolution,
+static int postscriptRes = -1;		// PostScript resolution,
 					// dots per inch
 static int stdoutfd = 1;		// output file descriptor -
 					// normally 1 but might move
 					// -1 means closed
-static char *psFileName = NULL;		// name of postscript file
-static char *psPageName = NULL;		// name of file containing
-					// postscript current page
-static char *regionFileName = NULL;	// name of file containing all
-					// image regions
-static char *imagePageName = NULL;	// name of bitmap image containing
-					// current page
+static char *psFileName = 0 /* nullptr */;	// PostScript file name
+static char *psPageName = 0 /* nullptr */;	// name of file
+						// containing current
+						// PostScript page
+static char *regionFileName = 0 /* nullptr */;	// name of file
+						// containing all image
+						// regions
+static char *imagePageName = 0 /* nullptr */;	// name of bitmap image
+						// file containing
+						// current page
 static const char *image_device = "pnmraw";
 static int image_res = DEFAULT_IMAGE_RES;
 static int vertical_offset = 0;
-static char *image_template = NULL;	// image template filename
-static char *macroset_template= NULL;	// image template passed to troff
-					// by -D
+static char *image_template = 0 /* nullptr */;	// image file name
+						// template
+static char *macroset_template= 0 /* nullptr */;	// image file
+							// name template
+							// passed to
+							// troff by -D
 static int troff_arg = 0;		// troff arg index
-static char *image_dir = NULL;		// user specified image directory
+static char *image_dir = 0 /* nullptr */;	// user-specified image
+						// directory
 static int textAlphaBits = MAX_ALPHA_BITS;
 static int graphicAlphaBits = MAX_ALPHA_BITS;
-static char *antiAlias = NULL;		// antialias arguments we pass to gs
-static int show_progress = FALSE;	// should we display page numbers as
-					// they are processed?
+static char *antiAlias = 0 /* nullptr */;	// anti-alias arguments
+						// to be passed to gs
+static bool want_progress_report = false;	// display page numbers
+						// as they are processed
 static int currentPageNo = -1;		// current image page number
 #if defined(DEBUGGING)
-static int debug = FALSE;
-static char *troffFileName = NULL;	// output of pre-html output which
-					// is sent to troff -Tps
-static char *htmlFileName = NULL;	// output of pre-html output which
-					// is sent to troff -Thtml
+static bool debugging = false;
+static char *troffFileName = 0 /* nullptr */;	// pre-html output sent
+						// to troff -Tps
+static char *htmlFileName = 0 /* nullptr */;	// pre-html output sent
+						// to troff -Thtml
 #endif
-static int eqn_flag = FALSE;            // must we preprocess via eqn?
+static bool need_eqn = false;		// must we preprocess via eqn?
 
-static char *linebuf = NULL;		// for scanning devps/DESC
+static char *linebuf = 0 /* nullptr */;	// for scanning devps/DESC
 static int linebufsize = 0;
-static const char *image_gen = NULL;    // the 'gs' program
+static const char *image_gen = 0 /* nullptr */;	// the 'gs' program
+
+static const char devhtml_desc = "devhtml/DESC";
+static const char devps_desc = "devps/DESC";
 
 const char *const FONT_ENV_VAR = "GROFF_FONT_PATH";
 static search_path font_path(FONT_ENV_VAR, FONTPATH, 0, 0);
@@ -223,14 +228,11 @@
 
 
 /*
- *  Images are generated via postscript, gs, and the pnm utilities.
+ *  Images are generated via PostScript, gs, and the pnm utilities.
  */
 #define IMAGE_DEVICE "-Tps"
 
 
-static int do_file(const char *filename);
-
-
 /*
  *  sys_fatal - Write a fatal error message.
  *              Taken from src/roff/groff/pipeline.c.
@@ -273,7 +275,7 @@
       char *old_linebuf = linebuf;
       linebuf = new charlinebufsize * 2;
       memcpy(linebuf, old_linebuf, linebufsize);
-      a_delete old_linebuf;
+      delete old_linebuf;
       linebufsize *= 2;
     }
     linebufi++ = c;
@@ -287,27 +289,66 @@
 }
 
 /*
- *  get_resolution - Return the postscript resolution from devps/DESC.
+ *  get_resolution - Return the PostScript device resolution.
  */
 
 static unsigned int get_resolution(void)
 {
   char *pathp;
   FILE *f;
-  unsigned int res;
-  f = font_path.open_file("devps/DESC", &pathp);
+  unsigned int res = 0;
+  f = font_path.open_file(devps_desc, &pathp);
+  if (0 == f)
+    fatal("cannot open file '%1'", devps_desc);
   free(pathp);
-  if (f == 0)
-    fatal("can't open devps/DESC");
+  // XXX: We should break out of this loop if we hit a "charset" line.
+  // "This line and everything following it in the file are ignored."
+  // (groff_font(5))
+  while (get_line(f))
+    (void) sscanf(linebuf, "res %u", &res);
+  fclose(f);
+  return res;
+}
+
+
+/*
+ *  get_image_generator - Return the declared program from the HTML
+ *                        device description.
+ */
+
+static char *get_image_generator(void)
+{
+  char *pathp;
+  FILE *f;
+  char *generator = 0;
+  const char keyword = "image_generator";
+  const size_t keyword_len = strlen(keyword);
+  f = font_path.open_file(devhtml_desc, &pathp);
+  if (0 == f)
+    fatal("cannot open file '%1'", devhtml_desc);
+  free(pathp);
+  // XXX: We should break out of this loop if we hit a "charset" line.
+  // "This line and everything following it in the file are ignored."
+  // (groff_font(5))
   while (get_line(f)) {
-    int n = sscanf(linebuf, "res %u", &res);
-    if (n >= 1) {
-      fclose(f);
-      return res;
+    char *cursor = linebuf;
+    size_t limit = strlen(linebuf);
+    char *end = linebuf + limit;
+    if (0 == (strncmp(linebuf, keyword, keyword_len))) {
+      cursor += keyword_len;
+      // At least one space or tab is required.
+      if(!(' ' == *cursor) || ('\t' == *cursor))
+	continue;
+      cursor++;
+      while((cursor < end) && ((' ' == *cursor) || ('\t' == *cursor)))
+	cursor++;
+      if (cursor == end)
+	continue;
+      generator = cursor;
     }
   }
-  fatal("can't find 'res' keyword in devps/DESC");
-  return 0;
+  fclose(f);
+  return generator;
 }
 
 /*
@@ -317,80 +358,63 @@
 void html_system(const char *s, int redirect_stdout)
 {
 #if defined(DEBUGGING)
-  if (debug) {
+  if (debugging) {
     fprintf(stderr, "executing: ");
     fwrite(s, sizeof(char), strlen(s), stderr);
     fflush(stderr);
   }
 #endif
   {
-    // Redirect standard error to the null device.  This is more
-    // portable than using "2> /dev/null", since it doesn't require a
-    // Unixy shell.
-    int save_stderr = dup(2);
-    int save_stdout = dup(1);
+    int saved_stdout = dup(1);
     int fdnull = open(NULL_DEV, O_WRONLY|O_BINARY, 0666);
-    if (save_stderr > 2 && fdnull > 2)
-      dup2(fdnull, 2);
-    if (redirect_stdout && save_stdout > 1 && fdnull > 1)
+    if (redirect_stdout && saved_stdout > 1 && fdnull > 1)
       dup2(fdnull, 1);
     if (fdnull >= 0)
       close(fdnull);
     int status = system(s);
-    dup2(save_stderr, 2);
     if (redirect_stdout)
-      dup2(save_stdout, 1);
+      dup2(saved_stdout, 1);
     if (status == -1)
       fprintf(stderr, "Calling '%s' failed\n", s);
     else if (status)
       fprintf(stderr, "Calling '%s' returned status %d\n", s, status);
-    close(save_stderr);
-    close(save_stdout);
+    close(saved_stdout);
   }
 }
 
 /*
- *  make_message - Create a string via malloc and place the result of the
- *                 va args into string.  Finally the new string is returned.
- *                 Taken from man page of printf(3).
+ *  make_string - Create a string via `malloc()`, place the variadic
+ *                arguments as formatted by `fmt` into it, and return
+ *                it.  Adapted from Linux man-pages' printf(3) example.
+ *                We never return a null pointer, instead treating
+ *                failure as invariably fatal.
  */
 
-char *make_message(const char *fmt, ...)
+char *make_string(const char *fmt, ...)
 {
-  /* Guess we need no more than 100 bytes. */
-  int n, size = 100;
-  char *p;
-  char *np;
+  size_t size = 0;
+  char *p = 0 /* nullptr */;
   va_list ap;
-  if ((p = (char *)malloc(size)) == NULL)
-    return NULL;
-  while (1) {
-    /* Try to print in the allocated space. */
-    va_start(ap, fmt);
-    n = vsnprintf(p, size, fmt, ap);
-    va_end(ap);
-    /* If that worked, return the string. */
-    if (n > -1 && n < size - 1) { /* glibc 2.1 and pre-ANSI C 99 */
-      if (size > n + 1) {
-	np = strsave(p);
-	free(p);
-	return np;
-      }
-      return p;
-    }
-    /* Else try again with more space. */
-    else		/* glibc 2.0 */
-      size *= 2;	/* twice the old size */
-    if ((np = (char *)realloc(p, size)) == NULL) {
-      free(p);		/* realloc failed, free old, p. */
-      return NULL;
-    }
-    p = np;		/* use realloc'ed, p */
-  }
+  va_start(ap, fmt);
+  int n = vsnprintf(p, size, fmt, ap);
+  va_end(ap);
+  if (n < 0)
+    sys_fatal("vsnprintf");
+  size = static_cast<size_t>(n) + 1 /* '\0' */;
+  p = static_cast<char *>(malloc(size));
+  if (0 /* nullptr */ == p)
+    sys_fatal("vsnprintf");
+  va_start(ap, fmt);
+  n = vsnprintf(p, size, fmt, ap);
+  va_end(ap);
+  if (n < 0)
+    sys_fatal("vsnprintf");
+  assert(p != 0 /* nullptr */);
+  return p;
 }
 
 /*
- *  the class and methods for retaining ascii text
+ *  classes and methods for retaining ascii text
  */
 
 struct char_block {
@@ -402,10 +426,6 @@
   char_block();
 };
 
-/*
- *  char_block - Constructor.  Set the, used, and, next, fields to zero.
- */
-
 char_block::char_block()
 : used(0), next(0)
 {
@@ -417,36 +437,28 @@
 public:
   char_buffer();
   ~char_buffer();
-  int read_file(FILE *fp);
+  void read_file(FILE *fp);
   int do_html(int argc, char *argv);
   int do_image(int argc, char *argv);
   void emit_troff_output(int device_format_selector);
   void write_upto_newline(char_block **t, int *i, int is_html);
-  int can_see(char_block **t, int *i, const char *string);
-  int skip_spaces(char_block **t, int *i);
+  bool can_see(char_block **t, int *i, const char *string);
   void skip_until_newline(char_block **t, int *i);
 private:
   char_block *head;
   char_block *tail;
-  int run_output_filter(int device_format_selector, int argc, char *argv);
+  int run_output_filter(int device_format_selector, int argc,
+			char *argv);
 };
 
-/*
- *  char_buffer - Constructor.
- */
-
 char_buffer::char_buffer()
 : head(0), tail(0)
 {
 }
 
-/*
- *  char_buffer - Destructor.  Throw away the whole buffer list.
- */
-
 char_buffer::~char_buffer()
 {
-  while (head != NULL) {
+  while (head != 0 /* nullptr */) {
     char_block *temp = head;
     head = head->next;
     delete temp;
@@ -454,15 +466,14 @@
 }
 
 /*
- *  read_file - Read in a complete file, fp, placing the contents inside
- *              char_blocks.
+ *  read_file - Read file `fp` into char_blocks.
  */
 
-int char_buffer::read_file(FILE *fp)
+void char_buffer::read_file(FILE *fp)
 {
   int n;
   while (!feof(fp)) {
-    if (tail == NULL) {
+    if (0 /* nullptr */ == tail) {
       tail = new char_block;
       head = tail;
     }
@@ -472,16 +483,13 @@
 	tail = tail->next;
       }
     }
-    // at this point we have a tail which is ready for the next SIZE
-    // bytes of the file
-    n = fread(tail->buffer, sizeof(char), char_block::SIZE-tail->used, fp);
-    if (n <= 0)
-      // error
-      return 0;
-    else
-      tail->used += n * sizeof(char);
+    // We now have a tail ready for the next `SIZE` bytes of the file.
+    n = fread(tail->buffer, sizeof(char), char_block::SIZE-tail->used,
+	      fp);
+    if ((n < 0) || ((0 == n) && !feof(fp)))
+      sys_fatal("fread");
+    tail->used += n * sizeof(char);
   }
-  return 1;
 }
 
 /*
@@ -518,40 +526,31 @@
 
 static void makeFileName(void)
 {
-  if ((image_dir != NULL) && (strchr(image_dir, '%') != NULL)) {
-    error("cannot use a '%%' within the image directory name");
-    exit(1);
-  }
-
-  if ((image_template != NULL) && (strchr(image_template, '%') != NULL)) {
-    error("cannot use a '%%' within the image template");
-    exit(1);
-  }
-
-  if (image_dir == NULL)
+  if ((image_dir != 0 /* nullptr */)
+      && (strchr(image_dir, '%') != 0 /* nullptr */))
+    fatal("'%%' is prohibited within the image directory name");
+  if ((image_template != 0 /* nullptr */)
+      && (strchr(image_template, '%') != 0 /* nullptr */))
+    fatal("'%%' is prohibited within the image template");
+  if (0 /* nullptr */ == image_dir)
     image_dir = (char *)"";
   else if (strlen(image_dir) > 0
-	   && image_dirstrlen(image_dir) - 1 != '/') {
-    image_dir = make_message("%s/", image_dir);
-    if (image_dir == NULL)
-      sys_fatal("make_message");
-  }
-
-  if (image_template == NULL)
-    macroset_template = make_message("%sgrohtml-%d", image_dir,
-				     (int)getpid());
+	   && image_dirstrlen(image_dir) - 1 != '/')
+    image_dir = make_string("%s/", image_dir);
+  if (0 /* nullptr */ == image_template)
+    macroset_template = make_string("%sgrohtml-%d-", image_dir,
+				     int(getpid()));
   else
-    macroset_template = make_message("%s%s", image_dir, image_template);
-
-  if (macroset_template == NULL)
-    sys_fatal("make_message");
-
-  image_template =
-    (char *)malloc(strlen("-%d") + strlen(macroset_template) + 1);
-  if (image_template == NULL)
+    macroset_template = make_string("%s%s-", image_dir,
+				     image_template);
+  size_t mtlen = strlen(macroset_template);
+  image_template = (char *)malloc(strlen("%d") + mtlen + 1);
+  if (0 /* nullptr */ == image_template)
     sys_fatal("malloc");
-  strcpy(image_template, macroset_template);
-  strcat(image_template, "-%d");
+  char *s = strcpy(image_template, macroset_template);
+  s += mtlen;
+  // Keep this format string synced with troff:suppress_node::tprint().
+  strcpy(s, "%d");
 }
 
 /*
@@ -561,14 +560,16 @@
 static void setupAntiAlias(void)
 {
   if (textAlphaBits == 0 && graphicAlphaBits == 0)
-    antiAlias = make_message(" ");
+    antiAlias = make_string(" ");
   else if (textAlphaBits == 0)
-    antiAlias = make_message("-dGraphicsAlphaBits=%d ", graphicAlphaBits);
+    antiAlias = make_string("-dGraphicsAlphaBits=%d ",
+			    graphicAlphaBits);
   else if (graphicAlphaBits == 0)
-    antiAlias = make_message("-dTextAlphaBits=%d ", textAlphaBits);
+    antiAlias = make_string("-dTextAlphaBits=%d ", textAlphaBits);
   else
-    antiAlias = make_message("-dTextAlphaBits=%d -dGraphicsAlphaBits=%d ",
-			     textAlphaBits, graphicAlphaBits);
+    antiAlias = make_string("-dTextAlphaBits=%d"
+			    " -dGraphicsAlphaBits=%d ", textAlphaBits,
+			    graphicAlphaBits);
 }
 
 /*
@@ -577,11 +578,10 @@
 
 static void checkImageDir(void)
 {
-  if (image_dir != NULL && strcmp(image_dir, "") != 0)
-    if (!(mkdir(image_dir, 0777) == 0 || errno == EEXIST)) {
-      error("cannot create directory '%1'", image_dir);
-      exit(1);
-    }
+  if (image_dir != 0 /* nullptr */ && strcmp(image_dir, "") != 0)
+    if (!(mkdir(image_dir, 0777) == 0 || errno == EEXIST))
+      fatal("cannot create directory '%1': %2", image_dir,
+	    strerror(errno));
 }
 
 /*
@@ -610,8 +610,8 @@
  *  write_start_image - Write troff code which will:
  *
  *                      (i)  disable html output for the following image
- *                      (ii) reset the max/min x/y registers during postscript
- *                           rendering.
+ *                      (ii) reset the max/min x/y registers during
+ *                           Postscript Rendering.
  */
 
 static void write_start_image(IMAGE_ALIGNMENT pos, int is_html)
@@ -642,13 +642,15 @@
 }
 
 /*
- *  write_upto_newline - Write the contents of the buffer until a newline
- *                       is seen.  Check for HTML_IMAGE_INLINE_BEGIN and
+ *  write_upto_newline - Write the contents of the buffer until a
+ *                       newline is seen.  Check for
+ *                       HTML_IMAGE_INLINE_BEGIN and
  *                       HTML_IMAGE_INLINE_END; process them if they are
  *                       present.
  */
 
-void char_buffer::write_upto_newline(char_block **t, int *i, int is_html)
+void char_buffer::write_upto_newline(char_block **t, int *i,
+				     int is_html)
 {
   int j = *i;
 
@@ -687,10 +689,10 @@
 }
 
 /*
- *  can_see - Return TRUE if we can see string in t->bufferi onwards.
+ *  can_see - Return true if we can see string in t->bufferi onwards.
  */
 
-int char_buffer::can_see(char_block **t, int *i, const char *str)
+bool char_buffer::can_see(char_block **t, int *i, const char *str)
 {
   int j = 0;
   int l = strlen(str);
@@ -705,39 +707,14 @@
     if (j == l) {
       *i = k;
       *t = s;
-      return TRUE;
+      return true;
     }
     else if (k < s->used && s->bufferk != strj)
-      return( FALSE );
+      return false;
     s = s->next;
     k = 0;
   }
-  return FALSE;
-}
-
-/*
- *  skip_spaces - Return TRUE if we have not run out of data.
- *                Consume spaces also.
- */
-
-int char_buffer::skip_spaces(char_block **t, int *i)
-{
-  char_block *s = *t;
-  int k = *i;
-
-  while (s) {
-    while (k < s->used && isspace(s->bufferk))
-      k++;
-    if (k == s->used) {
-      k = 0;
-      s = s->next;
-    }
-    else {
-      *i = k;
-      return TRUE;
-    }
-  }
-  return FALSE;
+  return false;
 }
 
 /*
@@ -786,12 +763,13 @@
   //
   //   HTML_FORMAT(IMAGE_OUTPUT_FILTER)
   //     Buffer data is written to the output stream
-  //     with no translation, for image file creation in the post-processor.
+  //     with no translation, for image file creation in the
+  //     post-processor.
 
   int idx = 0;
   char_block *element = head;
 
-  while (element != NULL)
+  while (element != 0 /* nullptr */)
     write_upto_newline(&element, &idx, device_format_selector);
 
 #if 0
@@ -808,7 +786,7 @@
 
 /*
  *  The image class remembers the position of all images in the
- *  postscript file and assigns names for each image.
+ *  PostScript file and assigns names for each image.
  */
 
 struct imageItem {
@@ -842,7 +820,7 @@
   resolution = res;
   maxx = max_width;
   imageName = name;
-  next = NULL;
+  next = 0 /* nullptr */;
 }
 
 /*
@@ -890,7 +868,7 @@
 
 imageList::~imageList()
 {
-  while (head != NULL) {
+  while (head != 0 /* nullptr */) {
     imageItem *i = head;
     head = head->next;
     delete i;
@@ -898,7 +876,7 @@
 }
 
 /*
- *  createPage - Create one image of, page pageno, from the postscript file.
+ *  createPage - Create image of page `pageno` from PostScript file.
  */
 
 int imageList::createPage(int pageno)
@@ -911,46 +889,41 @@
   if (currentPageNo >= 1) {
     /*
      *  We need to unlink the files which change each time a new page is
-     *  processed.  The final unlink is done by xtmpfile when pre-grohtml
-     *  exits.
+     *  processed.  The final unlink is done by xtmpfile when
+     *  pre-grohtml exits.
      */
     unlink(imagePageName);
     unlink(psPageName);
   }
 
-  if (show_progress) {
+  if (want_progress_report) {
     fprintf(stderr, "%d ", pageno);
     fflush(stderr);
   }
 
 #if defined(DEBUGGING)
-  if (debug)
+  if (debugging)
     fprintf(stderr, "creating page %d\n", pageno);
 #endif
 
-  s = make_message("psselect -q -p%d %s %s\n",
+  s = make_string("psselect -q -p%d %s %s\n",
 		   pageno, psFileName, psPageName);
-
-  if (s == NULL)
-    sys_fatal("make_message");
   html_system(s, 1);
-
-  s = make_message("echo showpage | "
-		   "%s%s -q -dBATCH -dSAFER "
-		   "-dDEVICEHEIGHTPOINTS=792 "
-		   "-dDEVICEWIDTHPOINTS=%d -dFIXEDMEDIA=true "
-		   "-sDEVICE=%s -r%d %s "
-		   "-sOutputFile=%s %s -\n",
-		   image_gen,
-		   EXE_EXT,
-		   (getMaxX(pageno) * image_res) / postscriptRes,
-		   image_device,
-		   image_res,
-		   antiAlias,
-		   imagePageName,
-		   psPageName);
-  if (s == NULL)
-    sys_fatal("make_message");
+  assert(strlen(image_gen) > 0);
+  s = make_string("echo showpage | "
+		  "%s%s -q -dBATCH -dSAFER "
+		  "-dDEVICEHEIGHTPOINTS=792 "
+		  "-dDEVICEWIDTHPOINTS=%d -dFIXEDMEDIA=true "
+		  "-sDEVICE=%s -r%d %s "
+		  "-sOutputFile=%s %s -\n",
+		  image_gen,
+		  EXE_EXT,
+		  (getMaxX(pageno) * image_res) / postscriptRes,
+		  image_device,
+		  image_res,
+		  antiAlias,
+		  imagePageName,
+		  psPageName);
   html_system(s, 1);
   free(s);
   currentPageNo = pageno;
@@ -983,7 +956,7 @@
 
 /*
  *  getMaxX - Return the largest right-hand position for any image
- *            on, pageno.
+ *            on `pageno`.
  */
 
 int imageList::getMaxX(int pageno)
@@ -991,7 +964,7 @@
   imageItem *h = head;
   int x = postscriptRes * DEFAULT_LINE_LENGTH;
 
-  while (h != NULL) {
+  while (h != 0 /* nullptr */) {
     if (h->pageNo == pageno)
       x = max(h->X2, x);
     h = h->next;
@@ -1000,7 +973,8 @@
 }
 
 /*
- *  createImage - Generate a minimal png file from the set of page images.
+ *  createImage - Generate a minimal PNG file from the set of page
+ *                images.
  */
 
 void imageList::createImage(imageItem *i)
@@ -1008,40 +982,40 @@
   if (i->X1 != -1) {
     char *s;
     int x1 = max(min(i->X1, i->X2) * image_res / postscriptRes
-		   - IMAGE_BOARDER_PIXELS,
+		   - IMAGE_BORDER_PIXELS,
 		 0);
     int y1 = max(image_res * vertical_offset / 72
 		   + min(i->Y1, i->Y2) * image_res / postscriptRes
-		   - IMAGE_BOARDER_PIXELS,
+		   - IMAGE_BORDER_PIXELS,
 		 0);
     int x2 = max(i->X1, i->X2) * image_res / postscriptRes
-	     + IMAGE_BOARDER_PIXELS;
+	     + IMAGE_BORDER_PIXELS;
     int y2 = image_res * vertical_offset / 72
 	     + max(i->Y1, i->Y2) * image_res / postscriptRes
-	     + 1 + IMAGE_BOARDER_PIXELS;
+	     + 1 + IMAGE_BORDER_PIXELS;
     if (createPage(i->pageNo) == 0) {
-      s = make_message("pnmcut%s %d %d %d %d < %s "
-		       "| pnmcrop -quiet | pnmtopng%s %s > %s\n",
-		       EXE_EXT,
-		       x1, y1, x2 - x1 + 1, y2 - y1 + 1,
-		       imagePageName,
-		       EXE_EXT,
-		       TRANSPARENT,
-		       i->imageName);
-      if (s == NULL)
-	sys_fatal("make_message");
-
+      s = make_string("pnmcut%s %d %d %d %d < %s "
+		      "| pnmcrop%s -quiet | pnmtopng%s -quiet %s"
+		      "> %s\n",
+		      EXE_EXT,
+		      x1, y1, x2 - x1 + 1, y2 - y1 + 1,
+		      imagePageName,
+		      EXE_EXT,
+		      EXE_EXT,
+		      TRANSPARENT,
+		      i->imageName);
       html_system(s, 0);
       free(s);
     }
     else {
-      fprintf(stderr, "failed to generate image of page %d\n", i->pageNo);
+      fprintf(stderr, "failed to generate image of page %d\n",
+	      i->pageNo);
       fflush(stderr);
     }
 #if defined(DEBUGGING)
   }
   else {
-    if (debug) {
+    if (debugging) {
       fprintf(stderr, "ignoring image as x1 coord is -1\n");
       fflush(stderr);
     }
@@ -1058,7 +1032,7 @@
 {
   imageItem *i = new imageItem(x1, y1, x2, y2, page, res, maxx, name);
 
-  if (head == NULL) {
+  if (0 /* nullptr */ == head) {
     head = i;
     tail = i;
   }
@@ -1077,19 +1051,18 @@
 {
   imageItem *h = head;
 
-  while (h != NULL) {
+  while (h != 0 /* nullptr */) {
     createImage(h);
     h = h->next;
   }
 }
 
-static imageList listOfImages;	// List of images defined by the region file.
+static imageList listOfImages;	// list of images defined by region file
 
 /*
- *  generateImages - Parse the region file and generate images
- *                   from the postscript file.  The region file
- *                   contains the x1,y1--x2,y2 extents of each
- *                   image.
+ *  generateImages - Parse the region file and generate images from the
+ *                   PostScript file.  The region file contains the
+ *                   x1,y1--x2,y2 extents of each image.
  */
 
 static void generateImages(char *region_file_name)
@@ -1118,9 +1091,10 @@
       fputc(f->getPB(), stderr);
     }
   }
+  fflush(stderr);
 
   listOfImages.createImages();
-  if (show_progress) {
+  if (want_progress_report) {
     fprintf(stderr, "done\n");
     fflush(stderr);
   }
@@ -1128,8 +1102,8 @@
 }
 
 /*
- *  set_redirection - Set up I/O Redirection for handle, was, to refer to
- *                    stream on handle, willbe.
+ *  set_redirection - Redirect file descriptor `was` to file descriptor
+ *                    `willbe`.
  */
 
 static void set_redirection(int was, int willbe)
@@ -1137,7 +1111,7 @@
   // Nothing to do if 'was' and 'willbe' already have same handle.
   if (was != willbe) {
     // Otherwise attempt the specified redirection.
-    if (dup2 (willbe, was) < 0) {
+    if (dup2(willbe, was) < 0) {
       // Redirection failed, so issue diagnostic and bail out.
       fprintf(stderr, "failed to replace fd=%d with %d\n", was, willbe);
       if (willbe == STDOUT_FILENO)
@@ -1155,14 +1129,14 @@
 }
 
 /*
- *  save_and_redirect - Get duplicate handle for stream, was, then
- *                      redirect, was, to refer to, willbe.
+ *  save_and_redirect - Duplicate file descriptor for `was` on file
+ *                      descriptor `willbe`.
  */
 
 static int save_and_redirect(int was, int willbe)
 {
   if (was == willbe)
-    // No redirection specified so don't do anything but silently bailing out.
+    // No redirection specified; silently bail out.
     return (was);
 
   // Proceeding with redirection so first save and verify our duplicate
@@ -1176,15 +1150,15 @@
   // Duplicate handle safely established so complete redirection.
   set_redirection(was, willbe);
 
-  // Finally return the saved duplicate descriptor for the
-  // original 'was' stream.
+  // Finally return the saved duplicate descriptor for the original
+  // 'was' descriptor.
   return saved;
 }
 
 /*
- *  alterDeviceTo - If, toImage, is set
+ *  alterDeviceTo - If toImage is set
  *                     the argument list is altered to include
- *                     IMAGE_DEVICE and we invoke groff rather than troff.
+ *                     IMAGE_DEVICE; we invoke groff rather than troff.
  *                  Else
  *                     set -Thtml and groff.
  */
@@ -1225,7 +1199,7 @@
   char **new_argv = (char **)malloc((argc + 2) * sizeof(char *));
   int i = 0;
 
-  if (new_argv == NULL)
+  if (0 /* nullptr */ == new_argv)
     sys_fatal("malloc");
 
   if (argc > 0) {
@@ -1238,7 +1212,7 @@
     i++;
   }
   argc++;
-  new_argvargc = NULL;
+  new_argvargc = 0 /* nullptr */;
   return new_argv;
 }
 
@@ -1252,7 +1226,7 @@
   char **new_argv = (char **)malloc((argc + 2) * sizeof(char *));
   int i = 0;
 
-  if (new_argv == NULL)
+  if (0 /* nullptr */ == new_argv)
     sys_fatal("malloc");
 
   while (i < argc) {
@@ -1261,7 +1235,7 @@
   }
   new_argvargc = strsave(numReg);
   argc++;
-  new_argvargc = NULL;
+  new_argvargc = 0 /* nullptr */;
   return new_argv;
 }
 
@@ -1278,14 +1252,14 @@
 }
 
 /*
- *  print_args - print arguments as if they were issued on the command line.
+ *  print_args - Print arguments as if issued on the command line.
  */
 
 #if defined(DEBUGGING)
 
 void print_args(int argc, char *argv)
 {
-  if (debug) {
+  if (debugging) {
     fprintf(stderr, "executing: ");
     for (int i = 0; i < argc; i++)
       fprintf(stderr, "%s ", argvi);
@@ -1305,7 +1279,7 @@
 {
   int pipedes2;
   PID_T child_pid;
-  int status;
+  int wstatus;
 
   print_args(argc, argv);
   if (pipe(pipedes) < 0)
@@ -1319,14 +1293,14 @@
     sys_fatal("fork");
 
   else if (child_pid == 0) {
-    // This is the child process fork.  We redirect its 'stdin' stream
-    // to read data emerging from our pipe.  There is no point in saving,
-    // since we won't be able to restore later!
+    // This is the child process.  We redirect its input file descriptor
+    // to read data emerging from our pipe.  There is no point in
+    // saving, since we won't be able to restore later!
 
     set_redirection(STDIN_FILENO, pipedes0);
 
-    // The parent process will be writing this data, so we should release
-    // the child's writeable handle on the pipe, since we have no use for it.
+    // The parent process will be writing this data; release the child's
+    // writeable handle on the pipe since we have no use for it.
 
     if (close(pipedes1) < 0)
       sys_fatal("close");
@@ -1334,7 +1308,9 @@
     // The IMAGE_OUTPUT_FILTER needs special output redirection...
 
     if (filter == IMAGE_OUTPUT_FILTER) {
-      // with BOTH 'stdout' AND 'stderr' diverted to files.
+      // ...with BOTH 'stdout' AND 'stderr' diverted to files, the
+      // latter so that `generateImages()` can scrape "grohtml-info"
+      // from it.
 
       set_redirection(STDOUT_FILENO, PS_OUTPUT_STREAM);
       set_redirection(STDERR_FILENO, REGION_OUTPUT_STREAM);
@@ -1342,26 +1318,20 @@
 
     // Now we are ready to launch the output filter.
 
-    execvp(argv0, argv);
-
-    // If we get to here then the 'exec...' request for the output filter
-    // failed.  Diagnose it and bail out.
-
-    error("couldn't exec %1: %2", argv0, strerror(errno), ((char *)0));
-    fflush(stderr);	// just in case error() didn't
-    exit(1);
+    execvp(argv0, argv); // does not return unless it fails
+    fatal("cannot execute '%1': %2", argv0, strerror(errno));
   }
 
   else {
-    // This is the parent process fork.  We will be writing data to the
-    // filter pipeline, and the child will be reading it.  We have no further
-    // use for our read handle on the pipe, and should close it.
+    // This is the parent process.  We write data to the filter pipeline
+    // where the child will read it.  We have no need to read from the
+    // input side ourselves, so close it.
 
     if (close(pipedes0) < 0)
       sys_fatal("close");
 
-    // Now we redirect the 'stdout' stream to the inlet end of the pipe,
-    // and push out the appropiately formatted data to the filter.
+    // Now redirect the standard output file descriptor to the inlet end
+    // of the pipe, and push the formatted data to the filter.
 
     pipedes1 = save_and_redirect(STDOUT_FILENO, pipedes1);
     emit_troff_output(DEVICE_FORMAT(filter));
@@ -1373,24 +1343,24 @@
 
     // Finally, we must wait for the child process to complete.
 
-    if (WAIT(&status, child_pid, _WAIT_CHILD) != child_pid)
+    if (WAIT(&wstatus, child_pid, _WAIT_CHILD) != child_pid)
       sys_fatal("wait");
   }
 
 #elif MAY_SPAWN_ASYNCHRONOUS_CHILD
 
-  // We do not have 'fork', (or we prefer not to use it),
-  // but asynchronous processes are allowed, passing data through pipes.
-  // This should be ok for most Win32 systems and is preferred to 'fork'
-  // for starting child processes under Cygwin.
+  // We do not have `fork` (or we prefer not to use it), but
+  // asynchronous processes are allowed, passing data through pipes.
+  // This should be okay for most Win32 systems and is preferred to
+  // `fork` for starting child processes under Cygwin.
 
-  // Before we start the post-processor we bind its inherited 'stdin'
-  // stream to the readable end of our pipe, saving our own 'stdin' stream
-  // in 'pipedes0'.
+  // Before we start the post-processor we bind its inherited standard
+  // input file descriptor to the readable end of our pipe, saving our
+  // own standard input file descriptor in `pipedes0`.
 
   pipedes0 = save_and_redirect(STDIN_FILENO, pipedes0);
 
-  // for the Win32 model,
+  // For the Win32 model,
   // we need special provision for saving BOTH 'stdout' and 'stderr'.
 
   int saved_stdout = dup(STDOUT_FILENO);
@@ -1403,16 +1373,14 @@
     // duplicate handle for 'stderr'.
 
     set_redirection(STDOUT_FILENO, PS_OUTPUT_STREAM);
-    saved_stderr = save_and_redirect(STDERR_FILENO, REGION_OUTPUT_STREAM);
+    saved_stderr = save_and_redirect(STDERR_FILENO,
+				     REGION_OUTPUT_STREAM);
   }
 
-  // We then use an asynchronous spawn request to start the post-processor.
+  // Use an asynchronous spawn request to start the post-processor.
 
   if ((child_pid = spawnvp(_P_NOWAIT, argv0, argv)) < 0) {
-    // Should the spawn request fail we issue a diagnostic and bail out.
-
-    error("cannot spawn %1: %2", argv0, strerror(errno), ((char *)0));
-    exit(1);
+    fatal("cannot spawn %1: %2", argv0, strerror(errno));
   }
 
   // Once the post-processor has been started we revert our 'stdin'
@@ -1427,8 +1395,8 @@
   if (filter == IMAGE_OUTPUT_FILTER)
     set_redirection(STDERR_FILENO, saved_stderr);
 
-  // Now we redirect the 'stdout' stream to the inlet end of the pipe,
-  // and push out the appropiately formatted data to the filter.
+  // Now we redirect the standard output to the inlet end of the pipe,
+  // and push out the appropriately formatted data to the filter.
 
   set_redirection(STDOUT_FILENO, pipedes1);
   emit_troff_output(DEVICE_FORMAT(filter));
@@ -1440,17 +1408,17 @@
 
   // And finally, we must wait for the child process to complete.
 
-  if (WAIT(&status, child_pid, _WAIT_CHILD) != child_pid)
+  if (WAIT(&wstatus, child_pid, _WAIT_CHILD) != child_pid)
     sys_fatal("wait");
 
 #else /* can't do asynchronous pipes! */
 
-  // TODO: code to support an MS-DOS style process model
-  //        should go here
+  // TODO: code to support an MS-DOS style process model should go here
+  fatal("output filtering not supported on this platform");
 
 #endif /* MAY_FORK_CHILD_PROCESS or MAY_SPAWN_ASYNCHRONOUS_CHILD */
 
-  return 0;
+  return wstatus;
 }
 
 /*
@@ -1469,16 +1437,16 @@
   argc++;
 
   s = (char *)"-dwww-image-template=";
-  s += macroset_template;	// do not combine these statements,
-				// otherwise they will not work
-  s += '\0';                	// the trailing '\0' is ignored
+  s += macroset_template;	// Do not combine these statements,
+				// otherwise they will not work.
+  s += '\0';			// The trailing '\0' is ignored.
   argv = addRegDef(argc, argv, s.contents());
   argc++;
 
   if (dialect == xhtml) {
     argv = addRegDef(argc, argv, "-rxhtml=1");
     argc++;
-    if (eqn_flag) {
+    if (need_eqn) {
       argv = addRegDef(argc, argv, "-e");
       argc++;
     }
@@ -1486,9 +1454,10 @@
 
 #if defined(DEBUGGING)
 # define HTML_DEBUG_STREAM  OUTPUT_STREAM(htmlFileName)
-  // slight security risk so only enabled if compiled with defined(DEBUGGING)
-  if (debug) {
-    int saved_stdout = save_and_redirect(STDOUT_FILENO, HTML_DEBUG_STREAM);
+  // slight security risk: only enabled if defined(DEBUGGING)
+  if (debugging) {
+    int saved_stdout = save_and_redirect(STDOUT_FILENO,
+					 HTML_DEBUG_STREAM);
     emit_troff_output(DEVICE_FORMAT(HTML_OUTPUT_FILTER));
     set_redirection(STDOUT_FILENO, saved_stdout);
   }
@@ -1517,12 +1486,13 @@
   argv = addRegDef(argc, argv, s.contents());
   argc++;
 
-  // override local settings and produce a page size letter postscript file
+  // Override local settings and produce a letter-size PostScript page
+  // file.
   argv = addRegDef(argc, argv, "-P-pletter");
   argc++;
 
   if (dialect == xhtml) {
-    if (eqn_flag) {
+    if (need_eqn) {
       argv = addRegDef(argc, argv, "-rxhtml=1");
       argc++;
     }
@@ -1532,9 +1502,10 @@
 
 #if defined(DEBUGGING)
 # define IMAGE_DEBUG_STREAM  OUTPUT_STREAM(troffFileName)
-  // slight security risk so only enabled if compiled with defined(DEBUGGING)
-  if (debug) {
-    int saved_stdout = save_and_redirect(STDOUT_FILENO, IMAGE_DEBUG_STREAM);
+  // slight security risk: only enabled if defined(DEBUGGING)
+  if (debugging) {
+    int saved_stdout = save_and_redirect(STDOUT_FILENO,
+					 IMAGE_DEBUG_STREAM);
     emit_troff_output(DEVICE_FORMAT(IMAGE_OUTPUT_FILTER));
     set_redirection(STDOUT_FILENO, saved_stdout);
   }
@@ -1546,20 +1517,34 @@
 static char_buffer inputFile;
 
 /*
- *  usage - Emit usage arguments.
+ *  usage - Emit usage message.
  */
 
 static void usage(FILE *stream)
 {
   fprintf(stream,
-    "\n"
-    "This program is not intended to be called stand-alone;\n"
-    "it is part of the groff pipeline to produce HTML output.\n"
-    "\n"
-    "If there is ever the need to call it manually (e.g., for\n"
-    "debugging purposes), add command-line option '-V' while calling\n"
-    "the 'groff' program to see which arguments are passed to it.\n"
-    "\n");
+"usage: %s -epV -a anti-aliasing-text-bits -D image-directory"
+" -F font-directory -g anti-aliasing-graphics-bits -i resolution"
+" -I image-stem -o image-vertical-offset -x html-dialect"
+" troff-command troff-argument ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	 program_name, program_name, program_name);
+  if (stdout == stream) {
+    fputs(
+"\n"
+"Prepare a troff(1) document for HTML formatting.\n"
+"\n"
+"This program is not intended to be executed standalone; it is\n"
+"normally part of a groff pipeline.  If your need to run it manually\n"
+"(e.g., for debugging purposes), give the 'groff' program the\n"
+"command-line option '-V' to inspect the arguments with which\n",
+	  stream);
+    fprintf(stream,
+"'%s' is called.  See the grohtml(1) manual page.\n",
+	  program_name);
+    exit(EXIT_SUCCESS);
+  }
 }
 
 /*
@@ -1570,43 +1555,47 @@
 
 static int scanArguments(int argc, char **argv)
 {
-  const char *command_prefix = getenv("GROFF_COMMAND_PREFIX");
-  if (!command_prefix)
-    command_prefix = PROG_PREFIX;
-  char *troff_name = new charstrlen(command_prefix) + strlen("troff") + 1;
-  strcpy(troff_name, command_prefix);
-  strcat(troff_name, "troff");
+  const char *cmdprefix = getenv("GROFF_COMMAND_PREFIX");
+  if (!cmdprefix)
+    cmdprefix = PROG_PREFIX;
+  size_t pfxlen = strlen(cmdprefix);
+  char *troff_name = new charpfxlen + strlen("troff") + 1;
+  char *s = strcpy(troff_name, cmdprefix);
+  s += pfxlen;
+  strcpy(s, "troff");
   int c, i;
   static const struct option long_options = {
     { "help", no_argument, 0, CHAR_MAX + 1 },
     { "version", no_argument, 0, 'v' },
-    { NULL, 0, 0, 0 }
+    { 0 /* nullptr */, 0, 0, 0 }
   };
-  while ((c = getopt_long(argc, argv, "+a:bdD:eF:g:hi:I:j:lno:prs:S:vVx:y",
-			  long_options, NULL))
+  while ((c = getopt_long(argc, argv,
+	  "+a:bCdD:eF:g:Ghi:I:j:lno:prs:S:vVx:y", long_options,
+	  0 /* nullptr */))
 	 != EOF)
     switch(c) {
     case 'a':
       textAlphaBits = min(max(MIN_ALPHA_BITS, atoi(optarg)),
 			  MAX_ALPHA_BITS);
-      if (textAlphaBits == 3) {
-	error("cannot use 3 bits of antialiasing information");
-	exit(1);
-      }
+      if (textAlphaBits == 3)
+	fatal("cannot use 3 bits of antialiasing information");
       break;
     case 'b':
       // handled by post-grohtml (set background color to white)
       break;
+    case 'C':
+      // handled by post-grohtml (don't write Creator HTML comment)
+      break;
     case 'd':
 #if defined(DEBUGGING)
-      debug = TRUE;
+      debugging = true;
 #endif
       break;
     case 'D':
       image_dir = optarg;
       break;
     case 'e':
-      eqn_flag = TRUE;
+      need_eqn = true;
       break;
     case 'F':
       font_path.command_line_dir(optarg);
@@ -1614,13 +1603,14 @@
     case 'g':
       graphicAlphaBits = min(max(MIN_ALPHA_BITS, atoi(optarg)),
 			     MAX_ALPHA_BITS);
-      if (graphicAlphaBits == 3) {
-	error("cannot use 3 bits of antialiasing information");
-	exit(1);
-      }
+      if (graphicAlphaBits == 3)
+	fatal("cannot use 3 bits of antialiasing information");
+      break;
+    case 'G':
+      // handled by post-grohtml (don't write CreationDate HTML comment)
       break;
     case 'h':
-      // handled by post-grohtml
+      // handled by post-grohtml (write headings with font size changes)
       break;
     case 'i':
       image_res = atoi(optarg);
@@ -1641,20 +1631,20 @@
       vertical_offset = atoi(optarg);
       break;
     case 'p':
-      show_progress = TRUE;
+      want_progress_report = true;
       break;
     case 'r':
       // handled by post-grohtml (no header and footer lines)
       break;
     case 's':
-      // handled by post-grohtml (use font size n as the html base font size)
+      // handled by post-grohtml (use font size n as the HTML base size)
       break;
     case 'S':
       // handled by post-grohtml (set file split level)
       break;
     case 'v':
       printf("GNU pre-grohtml (groff) version %s\n", Version_string);
-      exit(0);
+      exit(EXIT_SUCCESS);
     case 'V':
       // handled by post-grohtml (create validator button)
       break;
@@ -1665,18 +1655,17 @@
       else if (strcmp(optarg, "4") == 0)
 	dialect = html4;
       else
-	printf("unsupported html dialect %s (defaulting to html4)\n", optarg);
+	warning("unsupported HTML dialect: '%1'", optarg);
       break;
     case 'y':
       // handled by post-grohtml (create groff signature)
       break;
     case CHAR_MAX + 1: // --help
       usage(stdout);
-      exit(0);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(EXIT_FAILURE);
       break;
     default:
       break;
@@ -1690,7 +1679,7 @@
       return i;
     i++;
   }
-  a_delete troff_name;
+  delete troff_name;
 
   return argc;
 }
@@ -1699,7 +1688,7 @@
  *  makeTempFiles - Name the temporary files.
  */
 
-static int makeTempFiles(void)
+static void makeTempFiles(void)
 {
 #if defined(DEBUGGING)
   psFileName = DEBUG_FILE("prehtml-ps");
@@ -1711,124 +1700,120 @@
 #else /* not DEBUGGING */
   FILE *f;
 
-  /* psPageName contains a single page of postscript */
-  f = xtmpfile(&psPageName,
-	       PS_TEMPLATE_LONG, PS_TEMPLATE_SHORT,
-	       TRUE);
-  if (f == NULL) {
+  // psPageName contains a single page of PostScript.
+  f = xtmpfile(&psPageName, PS_TEMPLATE_LONG, PS_TEMPLATE_SHORT, true);
+  if (0 /* nullptr */ == f)
     sys_fatal("xtmpfile");
-    return -1;
-  }
   fclose(f);
 
-  /* imagePageName contains a bitmap image of the single postscript page */
-  f = xtmpfile(&imagePageName,
-	       PAGE_TEMPLATE_LONG, PAGE_TEMPLATE_SHORT,
-	       TRUE);
-  if (f == NULL) {
+  // imagePageName contains a bitmap image of a single PostScript page.
+  f = xtmpfile(&imagePageName, PAGE_TEMPLATE_LONG, PAGE_TEMPLATE_SHORT,
+	       true);
+  if (0 /* nullptr */ == f)
     sys_fatal("xtmpfile");
-    return -1;
-  }
   fclose(f);
 
-  /* psFileName contains a postscript file of the complete document */
-  f = xtmpfile(&psFileName,
-	       PS_TEMPLATE_LONG, PS_TEMPLATE_SHORT,
-	       TRUE);
-  if (f == NULL) {
+  // psFileName contains a PostScript file of the complete document.
+  f = xtmpfile(&psFileName, PS_TEMPLATE_LONG, PS_TEMPLATE_SHORT, true);
+  if (0 /* nullptr */ == f)
     sys_fatal("xtmpfile");
-    return -1;
-  }
   fclose(f);
 
-  /* regionFileName contains a list of the images and their boxed coordinates */
+  // regionFileName contains a list of the images and their boxed
+  // coordinates.
   f = xtmpfile(&regionFileName,
-	       REGION_TEMPLATE_LONG, REGION_TEMPLATE_SHORT,
-	       TRUE);
-  if (f == NULL) {
+	       REGION_TEMPLATE_LONG, REGION_TEMPLATE_SHORT, true);
+  if (0 /* nullptr */ == f)
     sys_fatal("xtmpfile");
-    return -1;
-  }
   fclose(f);
-
 #endif /* not DEBUGGING */
-  return 0;
 }
 
-int main(int argc, char **argv)
+static bool do_file(const char *filename)
 {
-  program_name = argv0;
-  int i;
-  int found = 0;
-  int ok = 1;
+  FILE *fp;
 
+  current_filename = filename;
+  if (strcmp(filename, "-") == 0)
+    fp = stdin;
+  else {
+    fp = fopen(filename, "r");
+    if (0 /* nullptr*/ == fp) {
+      error("unable to open '%1': %2", filename, strerror(errno));
+      return false;
+    }
+  }
+  inputFile.read_file(fp);
+  if (fp != stdin)
+    if (fclose(fp) != 0)
+      sys_fatal("fclose");
+  current_filename = 0 /* nullptr */;
+  return true;
+}
+
+static void cleanup(void)
+{
+  free(const_cast<char *>(image_gen));
+}
+
+int main(int argc, char **argv)
+{
 #ifdef CAPTURE_MODE
-  FILE *dump;
   fprintf(stderr, "%s: invoked with %d arguments ...\n", argv0, argc);
-  for (i = 0; i < argc; i++)
+  for (int i = 0; i < argc; i++)
     fprintf(stderr, "%2d: %s\n", i, argvi);
-  if ((dump = fopen(DEBUG_FILE("pre-html-data"), "wb")) != NULL) {
-    while((i = fgetc(stdin)) >= 0)
-      fputc(i, dump);
+  FILE *dump = fopen(DEBUG_FILE("pre-html-data"), "wb");
+  if (dump != 0 /* nullptr */) {
+    while((int ch = fgetc(stdin)) >= 0)
+      fputc(ch, dump);
     fclose(dump);
   }
-  exit(1);
+  exit(EXIT_FAILURE);
 #endif /* CAPTURE_MODE */
-  device = "html";
-  if (!font::load_desc())
-    fatal("cannot find devhtml/DESC exiting");
-  image_gen = font::image_generator;
-  if (image_gen == NULL || (strcmp(image_gen, "") == 0))
-    fatal("devhtml/DESC must set the image_generator field, exiting");
+  program_name = argv0;
+  if (atexit(&cleanup) != 0)
+    sys_fatal("atexit");
+  int operand_index = scanArguments(argc, argv);
+  image_gen = strsave(get_image_generator());
+  if (0 == image_gen)
+    fatal("'image_generator' directive not found in file '%1'",
+	  devhtml_desc);
   postscriptRes = get_resolution();
-  i = scanArguments(argc, argv);
+  if (postscriptRes < 1) // TODO: what's a more sane minimum value?
+    fatal("'res' directive missing or invalid in file '%1'",
+	  devps_desc);
   setupAntiAlias();
   checkImageDir();
   makeFileName();
-  while (i < argc) {
-    if (argvi0 != '-') {
-      /* found source file */
-      ok = do_file(argvi);
-      if (!ok)
-	return 0;
-      found = 1;
+  bool have_file_operand = false;
+  while (operand_index < argc) {
+    if (argvoperand_index0 != '-') {
+      if(!do_file(argvoperand_index))
+	exit(EXIT_FAILURE);
+      have_file_operand = true;
     }
-    i++;
+    operand_index++;
   }
 
-  if (!found)
+  if (!have_file_operand)
     do_file("-");
-  if (makeTempFiles())
-    return 1;
-  ok = inputFile.do_image(argc, argv);
-  if (ok == 0) {
+  makeTempFiles();
+  int wstatus = inputFile.do_image(argc, argv);
+  if (wstatus == 0) {
     generateImages(regionFileName);
-    ok = inputFile.do_html(argc, argv);
+    wstatus = inputFile.do_html(argc, argv);
   }
-  return ok;
+  else
+    if (WEXITSTATUS(wstatus) != 0)
+      // XXX: This is a crappy suggestion.  See Savannah #62673.
+      fatal("'%1' exited with status %2; re-run with a different output"
+	    " driver to see diagnostic messages", argv0,
+	    WEXITSTATUS(wstatus));
+  exit(EXIT_SUCCESS);
 }
 
-static int do_file(const char *filename)
-{
-  FILE *fp;
-
-  current_filename = filename;
-  if (strcmp(filename, "-") == 0)
-    fp = stdin;
-  else {
-    fp = fopen(filename, "r");
-    if (fp == 0) {
-      error("can't open '%1': %2", filename, strerror(errno));
-      return 0;
-    }
-  }
-
-  if (inputFile.read_file(fp)) {
-    // XXX
-  }
-
-  if (fp != stdin)
-    fclose(fp);
-  current_filename = NULL;
-  return 1;
-}
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/html/pre-html.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/html/pre-html.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/html/pushback.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/html/pushback.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/html/pushback.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/html/pushback.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/common.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/common.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/common.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/common.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/lex.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/lex.cpp Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -97,7 +97,7 @@
       }
       if (c == EOF)
 	break;
-      else if (invalid_input_char(c))
+      else if (is_invalid_input_char(c))
 	lex_error("invalid input character code %1", c);
       else {
 	line += char(c);
@@ -1555,8 +1555,8 @@
 
 copy_thru_input::~copy_thru_input()
 {
-  a_delete body;
-  a_delete until;
+  delete body;
+  delete until;
 }
 
 int copy_thru_input::get()
@@ -1677,7 +1677,7 @@
 int simple_file_input::get()
 {
   int c = getc(fp);
-  while (invalid_input_char(c)) {
+  while (is_invalid_input_char(c)) {
     error("invalid input character code %1", c);
     c = getc(fp);
   }
@@ -1689,7 +1689,7 @@
 int simple_file_input::peek()
 {
   int c = getc(fp);
-  while (invalid_input_char(c)) {
+  while (is_invalid_input_char(c)) {
     error("invalid input character code %1", c);
     c = getc(fp);
   }

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/main.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/main.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -25,7 +24,9 @@
 output *out;
 char *graphname;		// the picture box name in TeX mode
 
-int flyback_flag;
+bool want_flyback = false;
+// groff pic supports '.PY' to work around mm package stepping on 'PF'.
+bool want_alternate_flyback = false;
 int zero_length_line_flag = 0;
 // Non-zero means we're using a groff driver.
 int driver_extension_flag = 1;
@@ -80,7 +81,7 @@
     return c;
   }
   int c = getc(fp);
-  while (invalid_input_char(c)) {
+  while (is_invalid_input_char(c)) {
     error("invalid input character code %1", int(c));
     c = getc(fp);
     bol = 0;
@@ -89,13 +90,14 @@
     c = getc(fp);
     if (c == 'P') {
       c = getc(fp);
-      if (c == 'F' || c == 'E') {
+      if (c == 'E' || c == 'F' || c == 'Y') {
 	int d = getc(fp);
 	if (d != EOF)
 	  ungetc(d, fp);
 	if (d == EOF || d == ' ' || d == '\n' || compatible_flag) {
 	  eof = 1;
-	  flyback_flag = c == 'F';
+	  want_flyback = (c == 'F');
+	  want_alternate_flyback = (c == 'Y');
 	  return EOF;
 	}
 	push_back0 = c;
@@ -134,7 +136,7 @@
   bol = 0;
   if (c == EOF) {
     eof = 1;
-    error("end of file before .PE or .PF");
+    error("end of file before .PE, .PF, or .PY");
     error_with_file_and_line(current_filename, start_lineno - 1,
 			     ".PS was here");
   }
@@ -152,7 +154,7 @@
   if (push_back0 != EOF)
     return push_back0;
   int c = getc(fp);
-  while (invalid_input_char(c)) {
+  while (is_invalid_input_char(c)) {
     error("invalid input character code %1", int(c));
     c = getc(fp);
     bol = 0;
@@ -161,13 +163,14 @@
     c = getc(fp);
     if (c == 'P') {
       c = getc(fp);
-      if (c == 'F' || c == 'E') {
+      if (c == 'E' || c == 'F' || c == 'Y') {
 	int d = getc(fp);
 	if (d != EOF)
 	  ungetc(d, fp);
 	if (d == EOF || d == ' ' || d == '\n' || compatible_flag) {
 	  eof = 1;
-	  flyback_flag = c == 'F';
+	  want_flyback = (c == 'F');
+	  want_alternate_flyback = (c == 'Y');
 	  return EOF;
 	}
 	push_back0 = c;
@@ -218,7 +221,7 @@
 
 void do_picture(FILE *fp)
 {
-  flyback_flag = 0;
+  want_flyback = false;
   int c;
   if (!graphname)
     free(graphname);
@@ -288,7 +291,7 @@
     parse_cleanup();
     lex_cleanup();
 
-    // skip the rest of the .PF/.PE line
+    // skip the rest of the .PE/.PF/.PY line
     while ((c = getc(fp)) != EOF && c != '\n')
       ;
     if (c == '\n')
@@ -319,7 +322,7 @@
   enum { START, MIDDLE, HAD_DOT, HAD_P, HAD_PS, HAD_l, HAD_lf } state = START;
   for (;;) {
     int c = getc(fp);
-    while (invalid_input_char(c)) {
+    while (is_invalid_input_char(c)) {
       error("invalid input character code %1", int(c));
       c = getc(fp);
     }
@@ -479,13 +482,15 @@
 
 void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s  -nvCSU   filename ... \n", program_name);
+  fprintf(stream, "usage: %s -CnSU file ...\n", program_name);
 #ifdef TEX_SUPPORT
-  fprintf(stream, "       %s -t  -cvzCSU   filename ... \n", program_name);
+  fprintf(stream, "usage: %s -t -cCSUz file ...\n", program_name);
 #endif
 #ifdef FIG_SUPPORT
-  fprintf(stream, "       %s -f  -v   filename \n", program_name);
+  fprintf(stream, "usage: %s -f -v file\n", program_name);
 #endif
+  fprintf(stream, "usage: %s {-v | --version}\n", program_name);
+  fprintf(stream, "usage: %s --help\n", program_name);
 }
 
 #if defined(__MSDOS__) || defined(__EMX__)
@@ -621,8 +626,10 @@
 #endif
   {
     out = make_troff_output();
-    printf(".if !dPS .ds PS\n"
-	   ".if !dPE .ds PE\n");
+    printf(".do if !dPS .ds PS\n"
+	   ".do if !dPE .ds PE\n"
+	   ".do if !dPF .ds PF\n"
+	   ".do if !dPY .ds PY\n");
   }
 #ifdef FIG_SUPPORT
   if (whole_file_flag) {
@@ -650,3 +657,8 @@
   return had_parse_error;
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/object.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/object.cpp Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,6 +17,10 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
 #include <stdlib.h>
 
 #include "pic.h"
@@ -36,7 +40,7 @@
 
 output::~output()
 {
-  a_delete args;
+  delete args;
 }
 
 void output::set_desired_width_height(double wid, double ht)
@@ -47,7 +51,7 @@
 
 void output::set_args(const char *s)
 {
-  a_delete args;
+  delete args;
   if (s == 0 || *s == '\0')
     args = 0;
   else
@@ -400,7 +404,7 @@
 
 text_item::~text_item()
 {
-  a_delete text;
+  delete text;
 }
 
 object_spec::object_spec(object_type t) : type(t)
@@ -439,8 +443,8 @@
     delete tem;
   }
   delete with;
-  a_delete shaded;
-  a_delete outlined;
+  delete shaded;
+  delete outlined;
 }
 
 class command_object : public object {
@@ -461,7 +465,7 @@
 
 command_object::~command_object()
 {
-  a_delete s;
+  delete s;
 }
 
 void command_object::print()
@@ -665,7 +669,7 @@
 graphic_object::~graphic_object()
 {
   if (text)
-    ad_delete(ntext) text;
+    delete text;
 }
 
 class rectangle_object : public graphic_object {
@@ -1441,7 +1445,7 @@
 
 line_object::~line_object()
 {
-  a_delete v;
+  delete v;
 }
 
 linear_object *object_spec::make_line(position *curpos, direction *dirp)

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/object.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/object.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/output.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/output.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.1.man Changed

@@ -1,18 +1,15 @@
-.TH @G@PIC @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@pic \- compile pictures for troff or TeX
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr pic_C \n.C
-.cp 0
+.TH @g@pic @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@pic \- compile pictures for
+.I troff
+or TeX
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -30,13 +27,33 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_pic_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Definitions
 .\" ====================================================================
 .
 .ie t \{\
 .  ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
-.  ds lx L\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\*(tx
+.  ds lx L\h'-0.36m'\v'-0.22v'\s-2A\s0\h'-0.15m'\v'0.22v'\*tx
 .\}
 .el \{\
 .  ds tx TeX
@@ -46,299 +63,412 @@
 .ie \n(.g .ds ic \/
 .el       .ds ic \^
 .
-.\" The BSD man macros can't handle " in arguments to font change macros,
-.\" so use \(ts instead of ".
-.tr \(ts"\""
-.
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@pic
-.OP \-nvCSU
-.RI  file
-\&.\|.\|.\&
+.RB  \-CnSU 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY @g@pic
 .B \-t
-.OP \-cvzCSU
-.RI  file
-\&.\|.\|.\&
+.RB  \-cCSUz 
+.RI  file\~ .\|.\|.
 .YS
 .
 .
-.\" ====================================================================
-.SH DESCRIPTION
-.\" ====================================================================
+.SY @g@pic
+.B \-\-help
+.YS
 .
-This manual page describes the GNU version of
-.BR pic ,
-which is part of the groff document formatting system.
 .
-.B pic
-compiles descriptions of pictures embedded within
-.B troff
-or \*(tx input files into commands that are understood by \*(tx or
-.BR troff .
+.SY @g@pic
+.B \-v
+.
+.SY @g@pic
+.B \-\-version
+.YS
 .
-Each picture starts with a line beginning with
-.B .PS
-and ends with a line beginning with
-.BR .PE .
 .
-Anything outside of
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
+.
+The GNU implementation of
+.I pic \" generic
+is part of the
+.MR groff @MAN1EXT@
+document formatting system.
+.
+.I @g@pic
+is a
+.MR @g@troff @MAN1EXT@
+preprocessor that translates descriptions of diagrammatic pictures
+embedded in
+.MR roff @MAN7EXT@
+or \*tx input files into the language understood by \*tx or
+.IR @g@troff .
+.
+It copies the contents of each
+.I file
+to the standard output stream,
+except that lines between
 .B .PS
-and
+and any of
+.BR .PE ,
+.BR .PF ,
+or
+.B .PY
+are interpreted as picture descriptions in the
+.I pic
+language.
+.
+End a
+.I @g@pic
+picture with
 .B .PE
-is passed through without change.
+to leave the drawing position at the bottom of the picture,
+and with
+.B .PF
+or
+.B .PY
+to leave it at the top.
 .
+Normally,
+.I @g@pic
+is not executed directly by the user,
+but invoked by specifying the
+.B \-p
+option to
+.MR groff @MAN1EXT@ .
 .
-.LP
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+the standard input stream is read.
+.
+.
+.P
 It is the user's responsibility to provide appropriate definitions
 of the
-.B PS
+.BR PS ,
+.BR PE ,
+and one or both of the
+.B PF
 and
-.B PE
+.B PY
 macros.
 .
-When the macro package being used does not supply such definitions
-(for example, old versions of \-ms), appropriate definitions can be
-obtained with
-.BR \-mpic :
-.
-These will center each picture.
+When a macro package does not supply these,
+obtain simple definitions with the
+.I groff
+option
+.BR \-mpic ;
+these will center each picture.
 .
 .
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
+.P
+GNU
+.I pic \" GNU
+supports
+.B PY
+as a synonym of
+.B PF
+to work around a name space collision with the
+.I mm
+macro package,
+which defines
+.B PF
+as a page footer management macro.
 .
-Options that do not take arguments may be grouped behind a single
-.BR \- .
+Use
+.B PF
+preferentially unless a similar problem faces your document.
 .
-The special option
-.B \-\^\-
-can be used to mark the end of the options.
 .
-A filename of
-.B \-
-refers to the standard input.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
 .
-.TP
-.B \-C
-Recognize
-.B .PS
+.B \-\-help
+displays a usage message,
+while
+.B \-v
 and
-.B .PE
-even when followed by a character other than space or newline.
+.B \-\-version
+show version information;
+all exit afterward.
 .
-.TP
-.B \-S
-Safer mode; do not execute
-.B sh
-commands.
-.
-This can be useful when operating on untrustworthy input (enabled by
-default).
-.
-.TP
-.B \-U
-Unsafe mode; revert the default option
-.BR \-S .
-.
-.TP
-.B \-n
-Don't use the groff extensions to the troff drawing commands.
-.
-You should use this if you are using a postprocessor that doesn't
-support these extensions.
-.
-The extensions are described in
-.BR groff_out (@MAN5EXT@).
-.
-The
-.B \-n
-option also causes
-.B pic
-not to use zero-length lines to draw dots in troff mode.
-.
-.TP
-.B \-t
-\*(tx mode.
 .
 .TP
 .B \-c
 Be more compatible with
-.BR tpic .
-.
-Implies
+.IR tpic ;
+implies
 .BR \-t .
+.
 Lines beginning with
-.B \e
+.B \rs
 are not passed through transparently.
 .
 Lines beginning with
-.B .
+.B .\&
 are passed through with the initial
-.B .
+.B .\&
 changed to
-.BR \e .
+.BR \rs .
 .
 A line beginning with
 .B .ps
 is given special treatment:
-it takes an optional integer argument specifying
-the line thickness (pen size) in milliinches;
+it takes an optional integer argument specifying the line thickness
+(pen size)
+in milliinches;
 a missing argument restores the previous line thickness;
-the default line thickness is 8 milliinches.
+the default line thickness is 8\~milliinches.
 .
 The line thickness thus specified takes effect only when a
 non-negative line thickness has not been specified by use of the
-.B thickness
+.B \%thickness
 attribute or by setting the
-.B linethick
+.B \%linethick
 variable.
 .
+.
 .TP
-.B \-v
-Print the version number.
+.B \-C
+Recognize
+.BR .PS ,
+.BR .PE ,
+.BR .PF ,
+and
+.B .PY
+even when followed by a character other than space or newline.
+.
+.
+.TP
+.B \-n
+Don't use
+.I groff
+extensions to the
+.I troff \" generic
+drawing commands.
+.
+Specify this option if a postprocessor you're using doesn't support
+these extensions,
+described in
+.MR groff_out @MAN5EXT@ .
+.
+This option also causes
+.I @g@pic
+not to use zero-length lines to draw dots in
+.I troff \" generic
+mode.
+.
+.
+.TP
+.B \-S
+Operate in
+.I safer mode;
+.B sh
+commands are ignored.
+.
+This mode,
+enabled by default,
+can be useful when operating on untrustworthy input.
+.
+.
+.TP
+.B \-t
+Produce \*tx output.
+.
+.
+.TP
+.B \-U
+Operate in
+.I unsafe mode;
+.B sh
+commands are interpreted.
+.
 .
 .TP
 .B \-z
-In \*(tx mode draw dots using zero-length lines.
+In \*tx mode,
+draw dots using zero-length lines.
 .
 .
-.LP
+.P
 The following options supported by other versions of
-.B pic
-are ignored:
+.I pic \" generic
+are ignored.
+.
 .
 .TP
 .B \-D
-Draw all lines using the \eD escape sequence.
-.B pic
+Draw all lines using the \rsD escape sequence.
+GNU
+.I pic \" GNU
 always does this.
 .
 .TP
-.BI \-T \ dev
+.BI \-T\~ dev
 Generate output for the
-.B troff
+.I troff \" generic
 device
 .IR dev .
 .
 This is unnecessary because the
-.B troff
+.I troff \" generic
 output generated by
-.B pic
+GNU
+.I pic \" GNU
 is device-independent.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
-This section describes only the differences between GNU
-.B pic
-and the original version of
-.BR pic .
-.
-Many of these differences also apply to newer versions of Unix
-.BR pic .
-.
-A complete documentation is available in the file
+This section primarily discusses the differences between GNU
+.I pic \" GNU
+and the Eighth Edition Research Unix version of AT&T
+.I pic \" AT&T
+(1985).
 .
-.
-.LP
-.RS
-.I @DOCDIR@/pic.ms
-.RE
+Many of these differences also apply to later versions of AT&T
+.IR pic .
 .
 .
 .\" ====================================================================
-.SS \*(tx mode
+.SS "\*tx mode"
 .\" ====================================================================
 .
-\*(tx mode is enabled by the
+\*tx-compatible output is produced when the
 .B \-t
+option is specified.
+.
+You must use a \*tx driver that supports
+.I tpic
+version 2 specials.
+.
+.RI ( tpic
+was a fork of AT&T
+.I pic \" AT&T
+by Tim Morgan of the University of California at Irvine that diverged
+from its source around 1984.
+.
+It is best known today for lending its name to a group of
+.B \rsspecial
+commands it produced for \*tx.)
+.\" http://ftp.cs.stanford.edu/tex/texhax/texhax90.019
+.
+.
+.P
+Lines beginning with
+.B \rs
+are passed through transparently;
+a
+.B %
+is added to the end of the line to avoid unwanted spaces.
+.
+You can safely use this feature to change fonts or the value of
+.BR \rsbaselineskip .
+.
+Anything else may well produce undesirable results;
+use at your own risk.
+.
+By default,
+lines beginning with a dot are not treated specially\embut see the
+.B \-c
 option.
 .
-In \*(tx mode,
-.B pic
+.
+.P
+In \*tx mode,
+.I @g@pic
 will define a vbox called
-.B \egraph
+.B \rsgraph
 for each picture.
 .
-Use the
+Use GNU
+.IR pic 's \" GNU
 .B figname
 command to change the name of the vbox.
 .
-You must yourself print that vbox using, for example, the command
-.
+You must print that vbox yourself using the command
 .
 .RS
-.LP
-.B
-\ecenterline{\ebox\egraph}
+.EX
+\rscenterline{\rsbox\rsgraph}
+.EE
 .RE
 .
+for instance.
+.
+Since the vbox has a height of zero
+(it is defined with
+.BR \rsvtop )
+this will produce slightly more vertical space above the picture than
+below it;
 .
-.LP
-Actually, since the vbox has a height of zero (it is defined with
-\evtop) this will produce slightly more vertical space above the
-picture than below it;
 .RS
-.LP
-.B
-\ecenterline{\eraise 1em\ebox\egraph}
+.EX
+\rscenterline{\rsraise 1em\rsbox\rsgraph}
+.EE
 .RE
-.LP
+.
 would avoid this.
 .
+To give the vbox a positive height and a depth of zero
+(as used by \*lx's
+.IR \%graphics.sty ,
+for example)
+define the following macro in your document.
 .
-.LP
-To make the vbox having a positive height and a depth of zero
-(as used e.g.\& by \*lx's
-.BR \%graphics.sty ),
-define the following macro in your document:
 .RS
-.LP
-.B \edef\egpicbox#1{%
-.br
-.B "   \evbox{\eunvbox\ecsname #1\eendcsname\ekern 0pt}}"
+.EX
+\rsdef\rsgpicbox#1{%
+  \rsvbox{\rsunvbox\rscsname #1\rsendcsname\rskern 0pt}}
+.EE
 .RE
-.LP
-Now you can simply say
-.B \egpicbox{graph}
-instead of \ebox\egraph.
 .
-.
-.LP
-You must use a \*(tx driver that supports the
-.B tpic
-specials, version 2.
+You can then simply say
+.B \rsgpicbox{graph}
+instead of
+.BR \rsbox\rsgraph .
 .
 .
-.LP
-Lines beginning with
-.B \e
-are passed through transparently; a
-.B %
-is added to the end of the line to avoid unwanted spaces.
+.\" ====================================================================
+.SS Commands
+.\" ====================================================================
 .
-You can safely use this feature to change fonts or to
-change the value of
-.BR \ebaselineskip .
+Several commands new to GNU
+.I pic \" GNU
+accept delimiters,
+shown in their synopses as braces
+.BR "{ }" .
 .
-Anything else may well produce undesirable results; use at your own risk.
+Nesting of braces is supported.
 .
-Lines beginning with a period are not given any special treatment.
+Any other characters
+(except a space,
+tab,
+or newline)
+.\" XXX even crazy control characters, ugh--src/preproc/pic/lex.cpp:1266
+may be used as alternative delimiters,
+in which case the members of a given pair must be identical.
 .
+Strings are recognized within delimiters of either kind;
+they may contain the delimiter character or unbalanced braces.
 .
-.\" ====================================================================
-.SS Commands
-.\" ====================================================================
 .
 .TP
 \fBfor\fR \fIvariable\fR \fB=\fR \fIexpr1\fR \fBto\fR \fIexpr2\fR \
@@ -360,7 +490,8 @@
 .IR expr3 ;
 if
 .B by
-is not given, increment
+is not given,
+increment
 .I variable
 by 1.
 .
@@ -384,7 +515,8 @@
 .I expr3
 must be greater than zero.
 .
-If the constraints aren't met, the loop isn't executed.
+If the constraints aren't met,
+the loop isn't executed.
 .
 .I X
 can be any character not occurring in
@@ -409,59 +541,70 @@
 .IR if-false .
 .
 .TP
-\fBprint\fR \fIarg\fR\|.\|.\|.
-Concatenate the arguments and print as a line on stderr.
+.BI print\~ arg\c
+\~.\|.\|.
+Concatenate and write arguments to the standard error stream followed by
+a newline.
 .
 Each
 .I arg
-must be an expression, a position, or text.
+must be an expression,
+a position,
+or text.
 .
 This is useful for debugging.
 .
 .TP
-\fBcommand\fR \fIarg\fR\|.\|.\|.
-Concatenate the arguments
-and pass them through as a line to troff or \*(tx.
+.BI command\~ arg\c
+\~.\|.\|.
+.\" Move right margin to indentation since we must indent more later.
+.RS
+Concatenate arguments
+and pass them as a line to
+.I troff \" generic
+or \*tx.
 .
 Each
 .I arg
-must be an expression, a position, or text.
+must be an expression,
+a position,
+or text.
 .
-This has a similar effect to a line beginning with
-.B .\&
-or
-.BR \e ,
-but allows the values of variables to be passed through.
+.B command
+allows the values of
+.I pic
+variables to be passed to the formatter.
 .
 For example,
+.
 .RS
-.IP
-.ft B
-.nf
+.EX
 \&.PS
 x = 14
 command ".ds string x is " x "."
 \&.PE
-\e*string
-.ft
-.fi
+\rs*string
+.EE
 .RE
-.IP
-prints
+.
+produces
+.
 .RS
-.IP
-.B x is 14.
+.EX
+x is 14.
+.EE
+.RE
+when formatted with
+.IR troff . \" generic
 .RE
 .
+.
 .TP
 \fBsh\fR \fIX\fR \fIcommand\fR \fIX\fR
 Pass
 .I command
 to a shell.
 .
-.I X
-can be any character not occurring in
-.IR command .
 .
 .TP
 \fBcopy\fR \fB"\,\fIfilename\/\fB"\fR
@@ -469,13 +612,25 @@
 .I filename
 at this point in the file.
 .
+.
 .TP
-\fBcopy\fR \fB"\,\fIfilename\/\fB"\fR \fBthru\fR \fIX\fR \fIbody\fR \fIX\fR \
-\fBuntil\fR \fB"\,\fIword\*(ic\fB"\fR
-.ns
-.TP
-\fBcopy\fR \fB"\,\fIfilename\/\fB"\fR \fBthru\fR \fImacro\fR \
-\fBuntil\fR \fB"\,\fIword\*(ic\fB"\fR
+.BR copy\~  \dq\c
+.IB filename \dq\c
+.RB \~ thru\~\c
+.IR "X body X" \~\c \" space in roman: we must use 2-font macro with \c
+.RB  until\~ \dq\c
+.IB word \dq\c
+
+.TQ
+.BR copy\~  \dq\c
+.IB filename \dq\c
+.RB \~ thru\~\c
+.IR macro \~\c \" space roman because we must use 2-font macro with \c
+.RB  until\~ \dq\c
+.IB word \dq\c
+
+.\" Move right margin to indentation since we must indent more later.
+.RS
 This construct does
 .I body
 once for each line of
@@ -494,7 +649,8 @@
 .
 If
 .I filename
-is not given, lines are taken from the current input up to
+is not given,
+lines are taken from the current input up to
 .BR .PE .
 .
 If an
@@ -509,10 +665,9 @@
 .IR body .
 .
 For example,
-.RS
-.IP
-.ft B
-.nf
+.
+.RS \" now move further
+.EX
 \&.PS
 copy thru % circle at ($1,$2) % until "END"
 1 2
@@ -521,50 +676,59 @@
 END
 box
 \&.PE
-.ft
-.fi
+.EE
 .RE
-.IP
-is equivalent to
+.
+and
+.
 .RS
-.IP
-.ft B
-.nf
+.EX
 \&.PS
 circle at (1,2)
 circle at (3,4)
 circle at (5,6)
 box
 \&.PE
-.ft
-.fi
+.EE
 .RE
 .
-.IP
-The commands to be performed for each line can also be taken
-from a macro defined earlier by giving the name of the macro
-as the argument to
-.BR thru .
+are equivalent.
 .
+The commands to be performed for each line can also be taken from a
+macro defined earlier by giving the name of the macro as the argument to
+.BR thru .
 .
-.LP
-.B reset
-.br
-.ns
-.TP
-\fBreset\fI variable1\/\fR\fB,\fR\fI variable2 .\^.\^.
-Reset pre-defined variables
-.IR variable1 ,
-.I variable2
-\&.\^.\^.\& to their default values.
+The argument after
+.B thru
+is looked up as a macro name first;
+if not defined,
+its first character is interpreted as a delimiter.
+.RE
 .
-If no arguments are given, reset all pre-defined variables to their
-default values.
 .
-Note that assigning a value to
+.TP
+.B reset
+.TQ
+.BI reset\~ pvar1\c
+.RB  , \~\c
+.IR pvar2 \~.\|.\|.
+Reset predefined variables
+.IR pvar1 ,
+.I pvar2
+\&.\|.\|.\& to their default values;
+if no arguments are given,
+reset all predefined variables to their default values.
+.
+Variable names may be separated by commas,
+spaces,
+or both.
+.
+Assigning a value to
 .B scale
-also causes all pre-defined variables that control dimensions to be
-reset to their default values times the new value of scale.
+also causes all predefined variables that control dimensions to be reset
+to their default values times the new value of
+.BR scale .
+.
 .
 .TP
 \fBplot\fR \fIexpr\fR \fB"\,\fItext\*(ic\fB"\fR
@@ -577,94 +741,76 @@
 If
 .I text
 is omitted a format string of
-.B "\(ts%g\(ts"
+.B \dq%g\dq
 is used.
 .
 Attributes can be specified in the same way as for a normal text
 object.
 Be very careful that you specify an appropriate format string;
-.B pic
+.I @g@pic
 does only very limited checking of the string.
+.
 This is deprecated in favour of
 .BR sprintf .
 .
 .TP
-.IB variable\  := \ expr
-This is similar to
+.IB var \~:=\~ expr
+.RS
+This syntax resembles variable assignment with
 .B =
-except
-.I variable
+except that
+.I var
 must already be defined,
 and
 .I expr
 will be assigned to
-.I variable
+.I var
 without creating a variable local to the current block.
 .
 (By contrast,
 .B =
-defines the variable in the current block if it is not already defined
-there, and then changes the value in the current block only.)
+defines
+.I var
+in the current block if it is not already defined there,
+and then changes the value in the current block only.)
+.
+For example,
 .
-For example, the following:
-.RS
-.IP
-.ft B
-.nf
-\&.PS
-x = 3
-y = 3
-
-  x := 5
-  y = 5
-
-print x " " y
-\&.PE
-.ft
-.fi
-.RE
-.IP
-prints
 .RS
-.IP
-.B 5 3
+.EX
+.B .PS
+.B x = 3
+.B y = 3
+.B 
+.B   x := 5
+.B   y = 5
+.B 
+.B print x " " y
+.B .PE
+.EE
 .RE
 .
+writes
 .
-.LP
-Arguments of the form
-.IP
-.I X anything X
-.LP
-are also allowed to be of the form
-.IP
-.BI {\  anything\  }
-.
+.RS
+.EX
+5 3
+.EE
+.RE
 .
-.LP
-In this case
-.I anything
-can contain balanced occurrences of
-.B {
-and
-.BR } .
-Strings may contain
-.I X
-or imbalanced occurrences of
-.B {
-and
-.BR } .
+to the standard error stream.
+.RE
 .
 .
 .\" ====================================================================
 .SS Expressions
 .\" ====================================================================
 .
-The syntax for expressions has been significantly extended:
+The syntax for expressions has been significantly extended.
 .
 .
-.LP
-.IB  x\  ^\  y
+.P
+.IB  x\  \ha\  y
 (exponentiation)
 .br
 .BI sin( x )
@@ -679,7 +825,7 @@
 .BI exp( x )
 (base 10, i.e.\&
 .ie t 10\v'-.4m'\fIx\*(ic\fR\v'.4m')
-.el   10^\fIx\fR)
+.el   10\ha\fIx\fR)
 .br
 .BI sqrt( x )
 .br
@@ -730,7 +876,7 @@
 .
 .
 .\" ====================================================================
-.SS Other Changes
+.SS "Other changes"
 .\" ====================================================================
 .
 A bare expression,
@@ -750,8 +896,11 @@
 .LP
 means draw a line 2\ inches long in the current direction.
 .
-The \oqi\cq (or \oqI\cq) character is ignored; to use another
-measurement unit, set the
+The \oqi\cq
+(or \oqI\cq)
+character is ignored;
+to use another measurement unit,
+set the
 .I scale
 variable to an appropriate value.
 .
@@ -762,12 +911,15 @@
 and
 .BR maxpsht .
 .
-Initially these have values 8.5 and 11.
+Initially,
+these have values 8.5 and 11.
 .
 .
 .LP
 Scientific notation is allowed for numbers.
 For example
+.
+.
 .RS
 .LP
 .B
@@ -779,11 +931,14 @@
 Text attributes can be compounded.
 .
 For example,
+.
 .RS
 .LP
 .B
 "foo" above ljust
 .RE
+.
+.
 .LP
 is valid.
 .
@@ -794,12 +949,13 @@
 For example,
 .RS
 .LP
-.B
+.EX
 A: B: C: box  with .A.B.C.sw at 1,2
-.br
-.B
 circle at last \^.A.B.C
+.EE
 .RE
+.
+.
 .LP
 is acceptable.
 .
@@ -810,9 +966,11 @@
 .
 .
 .LP
-Circles, ellipses, and arcs can be dotted or dashed.
+Circles,
+ellipses,
+and arcs can be dotted or dashed.
 .
-In \*(tx mode splines can be dotted or dashed also.
+In \*tx mode splines can be dotted or dashed also.
 .
 .
 .LP
@@ -825,7 +983,8 @@
 .B rad
 or
 .B diam
-attribute is given, a radius of
+attribute is given,
+a radius of
 .B boxrad
 is used.
 .
@@ -859,14 +1018,13 @@
 If the width of zero is specified the width will be ignored in computing
 the scaling factor for the picture.
 .
-Note that GNU
-.B pic
+GNU
+.I pic \" GNU
 will always scale a picture by the same amount vertically as well as
 horizontally.
 .
-This is different from the DWB
-2.0
-.B pic
+This is different from DWB 2.0
+.I pic \" foreign
 which may scale a picture by a different amount vertically than
 horizontally if a height is specified.
 .
@@ -879,15 +1037,16 @@
 The implicit motion associated with the object is also determined
 by this box.
 .
-The dimensions of this box are taken from the width and height attributes;
-if the width attribute is not supplied then the width will be taken to be
+The dimensions of this box are taken from the width and height
+attributes;
+if the width attribute is not supplied then the width will be taken to
+be
 .BR textwid ;
-if the height attribute is not supplied then the height will be taken to be
-the number of text strings associated with the object
-times
+if the height attribute is not supplied then the height will be taken to
+be the number of text strings associated with the object times
 .BR textht .
 .
-Initially
+Initially,
 .B textwid
 and
 .B textht
@@ -895,18 +1054,41 @@
 .
 .
 .LP
-In (almost all) places where a quoted text string can be used,
+In
+(almost all)
+places where a quoted text string can be used,
 an expression of the form
+.
+.
 .IP
-.BI sprintf(\(ts format \(ts,\  arg ,\fR.\|.\|.\fB)
+.BI sprintf(\dq format \dq,\~ arg ,\fR\~.\|.\|.\fB)
+.
+.
 .LP
 can also be used;
 this will produce the arguments formatted according to
 .IR format ,
 which should be a string as described in
-.BR printf (3)
+.MR printf 3
 appropriate for the number of arguments supplied.
 .
+Only the modifiers
+.RB \lq # \rq,
+.RB \lq \- \rq,
+.RB \lq + \rq,
+and \lq\~\rq space),
+a minimum field width,
+an optional precision,
+and the conversion specifiers
+.BR %e ,
+.BR %E ,
+.BR %f ,
+.BR %g ,
+.BR %G ,
+and
+.B %%
+are supported.
+.
 .
 .LP
 The thickness of the lines used to draw objects is controlled by the
@@ -916,103 +1098,120 @@
 This gives the thickness of lines in points.
 .
 A negative value means use the default thickness:
-in \*(tx output mode, this means use a thickness of 8 milliinches;
-in \*(tx output mode with the
+in \*tx output mode,
+this means use a thickness of 8 milliinches;
+in \*tx output mode with the
 .B \-c
-option, this means use the line thickness specified by
+option,
+this means use the line thickness specified by
 .B .ps
 lines;
-in troff output mode, this means use a thickness proportional
-to the pointsize.
+in
+.I troff
+output mode,
+this means use a thickness proportional to the pointsize.
 .
 A zero value means draw the thinnest possible line supported by
 the output device.
 .
-Initially it has a value of \-1.
+Initially,
+it has a value of \-1.
 .
 There is also a
 .BR thick  ness 
 attribute.
 .
 For example,
+.
+.
 .RS
 .LP
 .B circle thickness 1.5
 .RE
+.
+.
 .LP
 would draw a circle using a line with a thickness of 1.5 points.
 .
 The thickness of lines is not affected by the
 value of the
 .B scale
-variable, nor by the width or height given in the
+variable,
+nor by the width or height given in the
 .B .PS
 line.
 .
 .
 .LP
-Boxes (including boxes with rounded corners or slanted sides),
+Boxes
+(including boxes with rounded corners or slanted sides),
 circles and ellipses can be filled by giving them an attribute of
 .BR fill  ed .
 .
 This takes an optional argument of an expression with a value between
-0 and 1; 0 will fill it with white, 1 with black, values in between
-with a proportionally gray shade.
+0 and 1;
+0 will fill it with white,
+1 with black,
+values in between with a proportionally gray shade.
 .
 A value greater than 1 can also be used:
 this means fill with the
 shade of gray that is currently being used for text and lines.
 .
-Normally this will be black, but output devices may provide
-a mechanism for changing this.
+Normally this will be black,
+but output devices may provide a mechanism for changing this.
 .
-Without an argument, then the value of the variable
-.B fillval
+Without an argument,
+then the value of the variable
+.B \%fillval
 will be used.
 .
-Initially this has a value of 0.5.
+Initially,
+this has a value of 0.5.
 .
 The invisible attribute does not affect the filling of objects.
 .
-Any text associated with a filled object will be added after the
-object has been filled, so that the text will not be obscured
-by the filling.
+Any text associated with a filled object will be added after the object
+has been filled,
+so that the text will not be obscured by the filling.
 .
 .
-.LP
-Three additional modifiers are available to specify colored objects:
-.BR outline  d 
+.P
+Additional modifiers are available to draw colored objects:
+.BR \%outline  d 
 sets the color of the outline,
 .B shaded
-the fill color, and
-.B colo\fR\fPu\fR\fPr\fR\fPed\fR
+the fill color,
+and
+.BR colo  u  r  ed 
 sets both.
 .
-All three keywords expect a suffix specifying the color, for example
+All expect a subsequent string argument specifying the color.
+.
 .RS
-.LP
-.B circle shaded """green""" outline """black"""
+.EX
+circle shaded \dqgreen\dq outline \dqblack\dq
+.EE
 .RE
 .
+Color is not yet supported in \*tx mode.
 .
-.LP
-Currently, color support isn't available in \*(tx mode.
-.
-Predefined color names for
-.B groff
-are in the device macro files, for example
-.BR ps.tmac ;
-additional colors can be defined with the
-.B .defcolor
-request (see the manual page of
-.BR @g@troff (@MAN1EXT@)
-for more details).
+Device macro files like
+.I ps.tmac
+declare color names;
+you can define additional ones with the
+.B \%defcolor
+request
+(see
+.MR groff @MAN7EXT@ ).
 .
 .
 .LP
-To change the name of the vbox in \*(tx mode, set the pseudo-variable
-.B figname
-(which is actually a specially parsed command) within a picture.
+To change the name of the vbox in \*tx mode,
+set the pseudo-variable
+.B \%figname
+(which is actually a specially parsed command)
+within a picture.
 .
 Example:
 .RS
@@ -1029,11 +1228,11 @@
 .
 .LP
 The picture is then available in the box
-.BR \efoobar .
+.BR \rsfoobar .
 .
 .
 .LP
-.B pic
+.I @g@pic
 assumes that at the beginning of a picture both glyph and fill color are
 set to the default value.
 .
@@ -1041,29 +1240,32 @@
 .LP
 Arrow heads will be drawn as solid triangles if the variable
 .B arrowhead
-is non-zero and either \*(tx mode is enabled or the
+is non-zero and either \*tx mode is enabled or the
 .B \-n
 option has not been given.
 .
-Initially
+Initially,
 .B arrowhead
 has a value of\ 1.
 .
-Note that solid arrow heads are always filled with the current outline
-color.
+Solid arrow heads are always filled with the current outline color.
 .
 .
 .LP
-The troff output of
-.B pic
+The
+.I troff
+output of
+.I @g@pic
 is device-independent.
 .
 The
 .B \-T
 option is therefore redundant.
 .
-All numbers are taken to be in inches; numbers are never interpreted
-to be in troff machine units.
+All numbers are taken to be in inches;
+numbers are never interpreted to be in
+.I troff
+machine units.
 .
 .
 .LP
@@ -1072,9 +1274,9 @@
 attribute.
 .
 This will only work if the postprocessor is
-.BR grops ,
+.MR grops @MAN1EXT@
 or
-.BR gropdf .
+.MR gropdf @MAN1EXT@ .
 .
 Any text associated with an object having the
 .B aligned
@@ -1082,92 +1284,99 @@
 so that it is aligned in the direction from the start point
 to the end point of the object.
 .
-Note that this attribute will have no effect for objects whose start
-and end points are coincident.
+This attribute will have no effect on objects whose start and end points
+are coincident.
 .
 .
 .LP
 In places where
 .IB n th
-is allowed
-.BI \oq expr \cqth
+is allowed,
+.BI \aq expr \aqth
 is also allowed.
 .
-Note that
-.B \cqth
-is a single token: no space is allowed between the
-.B \cq
-and the
-.BR th .
+.RB \lq \aqth \lq
+is a single token:
+no space is allowed between the apostrophe and the
+.RB \lq th \rq.
+.
 .
 For example,
 .IP
-.ft B
-.nf
+.EX
 for i = 1 to 4 do {
-   line from \oqi\cqth box.nw to \oqi+1\cqth box.se
+   line from \aqi\aqth box.nw to \aqi+1\aqth box.se
 }
-.ft
-.fi
+.EE
 .
 .
 .\" ====================================================================
-.SH CONVERSION
+.SH Conversion
 .\" ====================================================================
 .
 To obtain a stand-alone picture from a
-.B pic
-file, enclose your
-.B pic
+.I @g@pic
+file,
+enclose your
+.I pic \" language
 code with
 .B .PS
 and
 .B .PE
 requests;
-.B roff
-configuration commands may be added at the beginning of the file, but no
-.B roff
+.I roff
+configuration commands may be added at the beginning of the file,
+but no
+.I roff
 text.
 .
 .
 .LP
 It is necessary to feed this file into
-.B groff
-without adding any page information, so you must check which
+.I groff
+without adding any page information,
+so you must check which
 .B .PS
 and
 .B .PE
 requests are actually called.
 .
-For example, the mm macro package adds a page number, which is very
-annoying.
-.
-At the moment, calling standard
-.B groff
+For example,
+the
+.I mm
+macro package adds a page number,
+which is very annoying.
+.
+At the moment,
+calling standard
+.I groff
 without any macro package works.
 .
-Alternatively, you can define your own requests, e.g.\& to do nothing:
+Alternatively,
+you can define your own requests,
+e.g.,
+to do nothing:
+.
+.
 .LP
 .RS
-.nf
-.ft B
+.EX
 \&.de PS
 \&..
 \&.de PE
 \&..
-.ft
-.fi
+.EE
 .RE
 .
 .
 .LP
-.B groff
+.I groff
 itself does not provide direct conversion into other graphics file
 formats.
 .
 But there are lots of possibilities if you first transform your
 picture into PostScript\*R format using the
-.B groff
+.I groff
 option
 .BR \-Tps .
 .
@@ -1180,20 +1389,28 @@
 .BI psto other
 or the like.
 .
-Moreover, the PostScript interpreter
-.B ghostscript
-.RB ( gs )
+Moreover,
+the PostScript interpreter Ghostscript
+.RI ( gs (1))
 has built-in graphics conversion devices that are called with the option
+.
+.
 .LP
 .RS
 .BI "gs \-sDEVICE=" <devname>
 .RE
+.
+.
 .LP
 Call
+.
+.
 .LP
 .RS
 .B gs \-\-help
 .RE
+.
+.
 .LP
 for a list of the available devices.
 .
@@ -1207,29 +1424,33 @@
 .
 The MediaBox of the file produced can be controlled by passing a
 .B \-P\-p
-papersize to groff.
+papersize to
+.IR groff .
 .
 .
-.LP
+.br
+.ne 3v
+.P
 As the Encapsulated PostScript File Format
 .B EPS
-is getting more and more important, and the conversion wasn't
-regarded trivial in the past you might be interested to know that
-there is a conversion tool named
-.B ps2eps
+is getting more and more important,
+and the conversion wasn't regarded trivial in the past you might be
+interested to know that there is a conversion tool named
+.I ps2eps
 which does the right job.
 .
 It is much better than the tool
-.B ps2epsi
+.I ps2epsi
 packaged with
-.BR gs .
+.IR gs .
 .
 .
 .LP
-For bitmapped graphic formats, you should use
-.BR pstopnm ;
+For bitmapped graphic formats,
+you should use
+.IR pstopnm ;
 the resulting (intermediate)
-.B PNM
+.MR pnm 5
 file can be then converted to virtually any graphics format using the
 tools of the
 .B netpbm
@@ -1237,100 +1458,112 @@
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
 .I @MACRODIR@/pic.tmac
-Example definitions of the
-.B PS
+offers simple definitions of the
+.BR PS ,
+.BR PE ,
+.BR PF ,
 and
-.B PE
+.B PY
 macros.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH Bugs
 .\" ====================================================================
 .
-.BR @g@troff (@MAN1EXT@),
-.BR groff_out (@MAN5EXT@),
-.BR tex (1),
-.BR gs (1),
-.BR ps2eps (1),
-.BR pstopnm (1),
-.BR ps2epsi (1),
-.BR pnm (5)
+Characters that are invalid as input to GNU
+.I troff \" GNU
+(see the
+.I groff
+Texinfo manual or
+.MR groff_char @MAN7EXT@
+for a list)
+are rejected even in \*tx mode.
 .
 .
 .LP
-Eric S.\& Raymond,
-.I Making Pictures With GNU PIC.
-.br
-.I @DOCDIR@/pic.ps
-(this file, together with its source file, pic.ms, is part
-of the groff documentation)
-.
+The interpretation of
+.B \%fillval
+is incompatible with the
+.I pic \" AT&T
+in Tenth Edition Research Unix,
+which interprets 0 as black and 1 as white.
 .
-.LP
-Tpic: Pic for \*(tx
-.LP
-Brian W.\& Kernighan,
-.UR http://\:cm.bell\-labs.com/\:cm/\:cs/\:cstr/\:116.ps.gz
-.I PIC \(em A Graphics Language for Typesetting (User Manual)
-.UE .
-AT&T Bell Laboratories, Computing Science Technical Report No.\ 116
-(revised May, 1991).
 .
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
 .
-.LP
-.B ps2eps
-is available from CTAN mirrors, e.g.\&
-.UR ftp://\:ftp.dante.de/\:tex\-archive/\:support/\:ps2eps/
+.TP
+.I @DOCDIR@/\:pic\:.ps
+\lqMaking Pictures with GNU pic\rq,
+by Eric S.\& Raymond.
+.
+This file,
+together with its source,
+.IR pic.ms ,
+is part of the
+.I groff
+distribution.
+.
+.
+.P
+\lqPIC\emA Graphics Language for Typesetting: User Manual\rq,
+by Brian W.\& Kernighan,
+1984
+(revised 1991),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 116
+.
+.
+.P
+.I ps2eps
+is available from CTAN mirrors, e.g.,
+.UR ftp://\:ftp\:.dante\:.de/\:tex\-archive/\:support/\:ps2eps/
 .UE
 .
 .
 .LP
 W.\& Richard Stevens,
-.UR http://\:www.kohala.com/\:start/\:troff/\:pic2html.html
+.UR http://\:www\:.kohala\:.com/\:start/\:troff/\:pic2html\:.html
 .I Turning PIC into HTML
 .UE
 .
 .
 .LP
 W.\& Richard Stevens,
-.UR http://\:www.kohala.com/\:start/\:troff/\:pic.examples.ps
+.UR http://\:www\:.kohala\:.com/\:start/\:troff/\:pic\:.examples\:.ps
 .IR "Examples of " pic " Macros"
 .UE
 .
 .
-.\" ====================================================================
-.SH BUGS
-.\" ====================================================================
-.
-Input characters that are invalid for
-.B groff
-(i.e., those with ASCII code 0,
-or 013 octal, or between 015 and 037 octal, or between 0200 and 0237
-octal) are rejected even in \*(tx mode.
-.
-.
 .LP
-The interpretation of
-.B fillval
-is incompatible with the pic in 10th edition Unix,
-which interprets 0 as black and 1 as white.
+.MR @g@troff @MAN1EXT@ ,
+.MR groff_out @MAN5EXT@ ,
+.MR tex 1 ,
+.MR gs 1 ,
+.MR ps2eps 1 ,
+.MR pstopnm 1 ,
+.MR ps2epsi 1 ,
+.MR pnm 5
 .
 .
-.LP
-PostScript\*R is a registered trademark of Adobe Systems Incorporation.
-.
+.\" Clean up.
+.rm tx
+.rm lx
+.rm ic
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \npic_C
+.cp \n*groff_pic_1_man_C
+.do rr *groff_pic_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -18,6 +16,9 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 prefixexecbin_PROGRAMS += pic
+pic_CPPFLAGS = $(AM_CPPFLAGS) \
+  -I $(top_srcdir)/src/preproc/pic \
+  -I $(top_builddir)/src/preproc/pic
 pic_LDADD = libgroff.a $(LIBM) lib/libgnu.a
 pic_SOURCES = \
   src/preproc/pic/pic.ypp \
@@ -34,23 +35,22 @@
   src/preproc/pic/output.h \
   src/preproc/pic/object.h
 
-pic_CPPFLAGS = $(AM_CPPFLAGS) \
-  -I $(top_srcdir)/src/preproc/pic \
-  -I $(top_builddir)/src/preproc/pic
 PREFIXMAN1 += src/preproc/pic/pic.1
+EXTRA_DIST += \
+  src/preproc/pic/TODO \
+  src/preproc/pic/pic.1.man
 
+# Since pic_CPPFLAGS was set, all .o files have a 'pic-' prefix.
 src/preproc/pic/pic-lex.$(OBJEXT): src/preproc/pic/pic.hpp
-EXTRA_DIST += \
-  src/preproc/pic/pic.1.man \
-  src/preproc/pic/TODO
-CLEANFILES += \
+
+MAINTAINERCLEANFILES += \
   src/preproc/pic/pic.cpp \
   src/preproc/pic/pic.hpp \
   src/preproc/pic/pic.output
 
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.cpp Changed

@@ -1,8 +1,9 @@
-/* A Bison parser, made by GNU Bison 3.2.  */
+/* A Bison parser, made by GNU Bison 3.8.2.  */
 
 /* Bison implementation for Yacc-like parsers in C
 
-   Copyright (C) 1984, 1989-1990, 2000-2015, 2018 Free Software Foundation, Inc.
+   Copyright (C) 1984, 1989-1990, 2000-2015, 2018-2021 Free Software Foundation,
+   Inc.
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -15,7 +16,7 @@
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
-   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* As a special exception, you may create a larger work that contains
    part or all of the Bison parser skeleton and distribute that work
@@ -33,6 +34,10 @@
 /* C LALR(1) parser skeleton written by Richard Stallman, by
    simplifying the original so-called "semantic" parser.  */
 
+/* DO NOT RELY ON FEATURES THAT ARE NOT DOCUMENTED in the manual,
+   especially those whose name start with YY_ or yy_.  They are
+   private implementation details that can be changed or removed.  */
+
 /* All symbols defined below should begin with yy or YY, to avoid
    infringing on user name space.  This should be done even for local
    variables, as they might otherwise be expanded by user macros.
@@ -40,14 +45,11 @@
    define necessary library symbols; they are noted "INFRINGES ON
    USER NAME SPACE" below.  */
 
-/* Undocumented macros, especially those whose name start with YY_,
-   are private implementation details.  Do not rely on them.  */
-
-/* Identify Bison output.  */
-#define YYBISON 1
+/* Identify Bison output, and Bison version.  */
+#define YYBISON 30802
 
-/* Bison version.  */
-#define YYBISON_VERSION "3.2"
+/* Bison version string.  */
+#define YYBISON_VERSION "3.8.2"
 
 /* Skeleton name.  */
 #define YYSKELETON_NAME "yacc.c"
@@ -65,7 +67,7 @@
 
 
 /* First part of user prologue.  */
-#line 19 "../src/preproc/pic/pic.ypp" /* yacc.c:338  */
+#line 19 "../src/preproc/pic/pic.ypp"
 
 #include "pic.h"
 #include "ptable.h"
@@ -105,11 +107,21 @@
 
 const char *ordinal_postfix(int n);
 const char *object_type_name(object_type type);
-char *format_number(const char *form, double n);
-char *do_sprintf(const char *form, const double *v, int nv);
+char *format_number(const char *fmt, double n);
+char *do_sprintf(const char *fmt, const double *v, int nv);
 
 
-#line 113 "src/preproc/pic/pic.cpp" /* yacc.c:338  */
+#line 115 "src/preproc/pic/pic.cpp"
+
+# ifndef YY_CAST
+#  ifdef __cplusplus
+#   define YY_CAST(Type, Val) static_cast<Type> (Val)
+#   define YY_REINTERPRET_CAST(Type, Val) reinterpret_cast<Type> (Val)
+#  else
+#   define YY_CAST(Type, Val) ((Type) (Val))
+#   define YY_REINTERPRET_CAST(Type, Val) ((Type) (Val))
+#  endif
+# endif
 # ifndef YY_NULLPTR
 #  if defined __cplusplus
 #   if 201103L <= __cplusplus
@@ -122,16 +134,8 @@
 #  endif
 # endif
 
-/* Enabling verbose error messages.  */
-#ifdef YYERROR_VERBOSE
-# undef YYERROR_VERBOSE
-# define YYERROR_VERBOSE 1
-#else
-# define YYERROR_VERBOSE 0
-#endif
-
-/* In a future release of Bison, this section will be replaced
-   by #include "y.tab.h".  */
+/* Use api.header.include to #include this header
+   instead of duplicating it here.  */
 #ifndef YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED
 # define YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED
 /* Debug traces.  */
@@ -142,136 +146,145 @@
 extern int yydebug;
 #endif
 
-/* Token type.  */
+/* Token kinds.  */
 #ifndef YYTOKENTYPE
 # define YYTOKENTYPE
   enum yytokentype
   {
-    LABEL = 258,
-    VARIABLE = 259,
-    NUMBER = 260,
-    TEXT = 261,
-    COMMAND_LINE = 262,
-    DELIMITED = 263,
-    ORDINAL = 264,
-    TH = 265,
-    LEFT_ARROW_HEAD = 266,
-    RIGHT_ARROW_HEAD = 267,
-    DOUBLE_ARROW_HEAD = 268,
-    LAST = 269,
-    BOX = 270,
-    CIRCLE = 271,
-    ELLIPSE = 272,
-    ARC = 273,
-    LINE = 274,
-    ARROW = 275,
-    MOVE = 276,
-    SPLINE = 277,
-    HEIGHT = 278,
-    RADIUS = 279,
-    FIGNAME = 280,
-    WIDTH = 281,
-    DIAMETER = 282,
-    UP = 283,
-    DOWN = 284,
-    RIGHT = 285,
-    LEFT = 286,
-    FROM = 287,
-    TO = 288,
-    AT = 289,
-    WITH = 290,
-    BY = 291,
-    THEN = 292,
-    SOLID = 293,
-    DOTTED = 294,
-    DASHED = 295,
-    CHOP = 296,
-    SAME = 297,
-    INVISIBLE = 298,
-    LJUST = 299,
-    RJUST = 300,
-    ABOVE = 301,
-    BELOW = 302,
-    OF = 303,
-    THE = 304,
-    WAY = 305,
-    BETWEEN = 306,
-    AND = 307,
-    HERE = 308,
-    DOT_N = 309,
-    DOT_E = 310,
-    DOT_W = 311,
-    DOT_S = 312,
-    DOT_NE = 313,
-    DOT_SE = 314,
-    DOT_NW = 315,
-    DOT_SW = 316,
-    DOT_C = 317,
-    DOT_START = 318,
-    DOT_END = 319,
-    DOT_X = 320,
-    DOT_Y = 321,
-    DOT_HT = 322,
-    DOT_WID = 323,
-    DOT_RAD = 324,
-    SIN = 325,
-    COS = 326,
-    ATAN2 = 327,
-    LOG = 328,
-    EXP = 329,
-    SQRT = 330,
-    K_MAX = 331,
-    K_MIN = 332,
-    INT = 333,
-    RAND = 334,
-    SRAND = 335,
-    COPY = 336,
-    THRU = 337,
-    TOP = 338,
-    BOTTOM = 339,
-    UPPER = 340,
-    LOWER = 341,
-    SH = 342,
-    PRINT = 343,
-    CW = 344,
-    CCW = 345,
-    FOR = 346,
-    DO = 347,
-    IF = 348,
-    ELSE = 349,
-    ANDAND = 350,
-    OROR = 351,
-    NOTEQUAL = 352,
-    EQUALEQUAL = 353,
-    LESSEQUAL = 354,
-    GREATEREQUAL = 355,
-    LEFT_CORNER = 356,
-    RIGHT_CORNER = 357,
-    NORTH = 358,
-    SOUTH = 359,
-    EAST = 360,
-    WEST = 361,
-    CENTER = 362,
-    END = 363,
-    START = 364,
-    RESET = 365,
-    UNTIL = 366,
-    PLOT = 367,
-    THICKNESS = 368,
-    FILL = 369,
-    COLORED = 370,
-    OUTLINED = 371,
-    SHADED = 372,
-    XSLANTED = 373,
-    YSLANTED = 374,
-    ALIGNED = 375,
-    SPRINTF = 376,
-    COMMAND = 377,
-    DEFINE = 378,
-    UNDEF = 379
+    YYEMPTY = -2,
+    YYEOF = 0,                     /* "end of file"  */
+    YYerror = 256,                 /* error  */
+    YYUNDEF = 257,                 /* "invalid token"  */
+    LABEL = 258,                   /* LABEL  */
+    VARIABLE = 259,                /* VARIABLE  */
+    NUMBER = 260,                  /* NUMBER  */
+    TEXT = 261,                    /* TEXT  */
+    COMMAND_LINE = 262,            /* COMMAND_LINE  */
+    DELIMITED = 263,               /* DELIMITED  */
+    ORDINAL = 264,                 /* ORDINAL  */
+    TH = 265,                      /* TH  */
+    LEFT_ARROW_HEAD = 266,         /* LEFT_ARROW_HEAD  */
+    RIGHT_ARROW_HEAD = 267,        /* RIGHT_ARROW_HEAD  */
+    DOUBLE_ARROW_HEAD = 268,       /* DOUBLE_ARROW_HEAD  */
+    LAST = 269,                    /* LAST  */
+    BOX = 270,                     /* BOX  */
+    CIRCLE = 271,                  /* CIRCLE  */
+    ELLIPSE = 272,                 /* ELLIPSE  */
+    ARC = 273,                     /* ARC  */
+    LINE = 274,                    /* LINE  */
+    ARROW = 275,                   /* ARROW  */
+    MOVE = 276,                    /* MOVE  */
+    SPLINE = 277,                  /* SPLINE  */
+    HEIGHT = 278,                  /* HEIGHT  */
+    RADIUS = 279,                  /* RADIUS  */
+    FIGNAME = 280,                 /* FIGNAME  */
+    WIDTH = 281,                   /* WIDTH  */
+    DIAMETER = 282,                /* DIAMETER  */
+    UP = 283,                      /* UP  */
+    DOWN = 284,                    /* DOWN  */
+    RIGHT = 285,                   /* RIGHT  */
+    LEFT = 286,                    /* LEFT  */
+    FROM = 287,                    /* FROM  */
+    TO = 288,                      /* TO  */
+    AT = 289,                      /* AT  */
+    WITH = 290,                    /* WITH  */
+    BY = 291,                      /* BY  */
+    THEN = 292,                    /* THEN  */
+    SOLID = 293,                   /* SOLID  */
+    DOTTED = 294,                  /* DOTTED  */
+    DASHED = 295,                  /* DASHED  */
+    CHOP = 296,                    /* CHOP  */
+    SAME = 297,                    /* SAME  */
+    INVISIBLE = 298,               /* INVISIBLE  */
+    LJUST = 299,                   /* LJUST  */
+    RJUST = 300,                   /* RJUST  */
+    ABOVE = 301,                   /* ABOVE  */
+    BELOW = 302,                   /* BELOW  */
+    OF = 303,                      /* OF  */
+    THE = 304,                     /* THE  */
+    WAY = 305,                     /* WAY  */
+    BETWEEN = 306,                 /* BETWEEN  */
+    AND = 307,                     /* AND  */
+    HERE = 308,                    /* HERE  */
+    DOT_N = 309,                   /* DOT_N  */
+    DOT_E = 310,                   /* DOT_E  */
+    DOT_W = 311,                   /* DOT_W  */
+    DOT_S = 312,                   /* DOT_S  */
+    DOT_NE = 313,                  /* DOT_NE  */
+    DOT_SE = 314,                  /* DOT_SE  */
+    DOT_NW = 315,                  /* DOT_NW  */
+    DOT_SW = 316,                  /* DOT_SW  */
+    DOT_C = 317,                   /* DOT_C  */
+    DOT_START = 318,               /* DOT_START  */
+    DOT_END = 319,                 /* DOT_END  */
+    DOT_X = 320,                   /* DOT_X  */
+    DOT_Y = 321,                   /* DOT_Y  */
+    DOT_HT = 322,                  /* DOT_HT  */
+    DOT_WID = 323,                 /* DOT_WID  */
+    DOT_RAD = 324,                 /* DOT_RAD  */
+    SIN = 325,                     /* SIN  */
+    COS = 326,                     /* COS  */
+    ATAN2 = 327,                   /* ATAN2  */
+    LOG = 328,                     /* LOG  */
+    EXP = 329,                     /* EXP  */
+    SQRT = 330,                    /* SQRT  */
+    K_MAX = 331,                   /* K_MAX  */
+    K_MIN = 332,                   /* K_MIN  */
+    INT = 333,                     /* INT  */
+    RAND = 334,                    /* RAND  */
+    SRAND = 335,                   /* SRAND  */
+    COPY = 336,                    /* COPY  */
+    THRU = 337,                    /* THRU  */
+    TOP = 338,                     /* TOP  */
+    BOTTOM = 339,                  /* BOTTOM  */
+    UPPER = 340,                   /* UPPER  */
+    LOWER = 341,                   /* LOWER  */
+    SH = 342,                      /* SH  */
+    PRINT = 343,                   /* PRINT  */
+    CW = 344,                      /* CW  */
+    CCW = 345,                     /* CCW  */
+    FOR = 346,                     /* FOR  */
+    DO = 347,                      /* DO  */
+    IF = 348,                      /* IF  */
+    ELSE = 349,                    /* ELSE  */
+    ANDAND = 350,                  /* ANDAND  */
+    OROR = 351,                    /* OROR  */
+    NOTEQUAL = 352,                /* NOTEQUAL  */
+    EQUALEQUAL = 353,              /* EQUALEQUAL  */
+    LESSEQUAL = 354,               /* LESSEQUAL  */
+    GREATEREQUAL = 355,            /* GREATEREQUAL  */
+    LEFT_CORNER = 356,             /* LEFT_CORNER  */
+    RIGHT_CORNER = 357,            /* RIGHT_CORNER  */
+    NORTH = 358,                   /* NORTH  */
+    SOUTH = 359,                   /* SOUTH  */
+    EAST = 360,                    /* EAST  */
+    WEST = 361,                    /* WEST  */
+    CENTER = 362,                  /* CENTER  */
+    END = 363,                     /* END  */
+    START = 364,                   /* START  */
+    RESET = 365,                   /* RESET  */
+    UNTIL = 366,                   /* UNTIL  */
+    PLOT = 367,                    /* PLOT  */
+    THICKNESS = 368,               /* THICKNESS  */
+    FILL = 369,                    /* FILL  */
+    COLORED = 370,                 /* COLORED  */
+    OUTLINED = 371,                /* OUTLINED  */
+    SHADED = 372,                  /* SHADED  */
+    XSLANTED = 373,                /* XSLANTED  */
+    YSLANTED = 374,                /* YSLANTED  */
+    ALIGNED = 375,                 /* ALIGNED  */
+    SPRINTF = 376,                 /* SPRINTF  */
+    COMMAND = 377,                 /* COMMAND  */
+    DEFINE = 378,                  /* DEFINE  */
+    UNDEF = 379                    /* UNDEF  */
   };
+  typedef enum yytokentype yytoken_kind_t;
 #endif
-/* Tokens.  */
+/* Token kinds.  */
+#define YYEMPTY -2
+#define YYEOF 0
+#define YYerror 256
+#define YYUNDEF 257
 #define LABEL 258
 #define VARIABLE 259
 #define NUMBER 260
@@ -397,10 +410,9 @@
 
 /* Value type.  */
 #if ! defined YYSTYPE && ! defined YYSTYPE_IS_DECLARED
-
 union YYSTYPE
 {
-#line 65 "../src/preproc/pic/pic.ypp" /* yacc.c:353  */
+#line 65 "../src/preproc/pic/pic.ypp"
 
 	char *str;
 	int n;
@@ -419,9 +431,9 @@
 	graphics_state state;
 	object_type obtype;
 
-#line 423 "src/preproc/pic/pic.cpp" /* yacc.c:353  */
-};
+#line 435 "src/preproc/pic/pic.cpp"
 
+};
 typedef union YYSTYPE YYSTYPE;
 # define YYSTYPE_IS_TRIVIAL 1
 # define YYSTYPE_IS_DECLARED 1
@@ -430,9 +442,213 @@
 
 extern YYSTYPE yylval;
 
+
 int yyparse (void);
 
+
 #endif /* !YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED  */
+/* Symbol kind.  */
+enum yysymbol_kind_t
+{
+  YYSYMBOL_YYEMPTY = -2,
+  YYSYMBOL_YYEOF = 0,                      /* "end of file"  */
+  YYSYMBOL_YYerror = 1,                    /* error  */
+  YYSYMBOL_YYUNDEF = 2,                    /* "invalid token"  */
+  YYSYMBOL_LABEL = 3,                      /* LABEL  */
+  YYSYMBOL_VARIABLE = 4,                   /* VARIABLE  */
+  YYSYMBOL_NUMBER = 5,                     /* NUMBER  */
+  YYSYMBOL_TEXT = 6,                       /* TEXT  */
+  YYSYMBOL_COMMAND_LINE = 7,               /* COMMAND_LINE  */
+  YYSYMBOL_DELIMITED = 8,                  /* DELIMITED  */
+  YYSYMBOL_ORDINAL = 9,                    /* ORDINAL  */
+  YYSYMBOL_TH = 10,                        /* TH  */
+  YYSYMBOL_LEFT_ARROW_HEAD = 11,           /* LEFT_ARROW_HEAD  */
+  YYSYMBOL_RIGHT_ARROW_HEAD = 12,          /* RIGHT_ARROW_HEAD  */
+  YYSYMBOL_DOUBLE_ARROW_HEAD = 13,         /* DOUBLE_ARROW_HEAD  */
+  YYSYMBOL_LAST = 14,                      /* LAST  */
+  YYSYMBOL_BOX = 15,                       /* BOX  */
+  YYSYMBOL_CIRCLE = 16,                    /* CIRCLE  */
+  YYSYMBOL_ELLIPSE = 17,                   /* ELLIPSE  */
+  YYSYMBOL_ARC = 18,                       /* ARC  */
+  YYSYMBOL_LINE = 19,                      /* LINE  */
+  YYSYMBOL_ARROW = 20,                     /* ARROW  */
+  YYSYMBOL_MOVE = 21,                      /* MOVE  */
+  YYSYMBOL_SPLINE = 22,                    /* SPLINE  */
+  YYSYMBOL_HEIGHT = 23,                    /* HEIGHT  */
+  YYSYMBOL_RADIUS = 24,                    /* RADIUS  */
+  YYSYMBOL_FIGNAME = 25,                   /* FIGNAME  */
+  YYSYMBOL_WIDTH = 26,                     /* WIDTH  */
+  YYSYMBOL_DIAMETER = 27,                  /* DIAMETER  */
+  YYSYMBOL_UP = 28,                        /* UP  */
+  YYSYMBOL_DOWN = 29,                      /* DOWN  */
+  YYSYMBOL_RIGHT = 30,                     /* RIGHT  */
+  YYSYMBOL_LEFT = 31,                      /* LEFT  */
+  YYSYMBOL_FROM = 32,                      /* FROM  */
+  YYSYMBOL_TO = 33,                        /* TO  */
+  YYSYMBOL_AT = 34,                        /* AT  */
+  YYSYMBOL_WITH = 35,                      /* WITH  */
+  YYSYMBOL_BY = 36,                        /* BY  */
+  YYSYMBOL_THEN = 37,                      /* THEN  */
+  YYSYMBOL_SOLID = 38,                     /* SOLID  */
+  YYSYMBOL_DOTTED = 39,                    /* DOTTED  */
+  YYSYMBOL_DASHED = 40,                    /* DASHED  */
+  YYSYMBOL_CHOP = 41,                      /* CHOP  */
+  YYSYMBOL_SAME = 42,                      /* SAME  */
+  YYSYMBOL_INVISIBLE = 43,                 /* INVISIBLE  */
+  YYSYMBOL_LJUST = 44,                     /* LJUST  */
+  YYSYMBOL_RJUST = 45,                     /* RJUST  */
+  YYSYMBOL_ABOVE = 46,                     /* ABOVE  */
+  YYSYMBOL_BELOW = 47,                     /* BELOW  */
+  YYSYMBOL_OF = 48,                        /* OF  */
+  YYSYMBOL_THE = 49,                       /* THE  */
+  YYSYMBOL_WAY = 50,                       /* WAY  */
+  YYSYMBOL_BETWEEN = 51,                   /* BETWEEN  */
+  YYSYMBOL_AND = 52,                       /* AND  */
+  YYSYMBOL_HERE = 53,                      /* HERE  */
+  YYSYMBOL_DOT_N = 54,                     /* DOT_N  */
+  YYSYMBOL_DOT_E = 55,                     /* DOT_E  */
+  YYSYMBOL_DOT_W = 56,                     /* DOT_W  */
+  YYSYMBOL_DOT_S = 57,                     /* DOT_S  */
+  YYSYMBOL_DOT_NE = 58,                    /* DOT_NE  */
+  YYSYMBOL_DOT_SE = 59,                    /* DOT_SE  */
+  YYSYMBOL_DOT_NW = 60,                    /* DOT_NW  */
+  YYSYMBOL_DOT_SW = 61,                    /* DOT_SW  */
+  YYSYMBOL_DOT_C = 62,                     /* DOT_C  */
+  YYSYMBOL_DOT_START = 63,                 /* DOT_START  */
+  YYSYMBOL_DOT_END = 64,                   /* DOT_END  */
+  YYSYMBOL_DOT_X = 65,                     /* DOT_X  */
+  YYSYMBOL_DOT_Y = 66,                     /* DOT_Y  */
+  YYSYMBOL_DOT_HT = 67,                    /* DOT_HT  */
+  YYSYMBOL_DOT_WID = 68,                   /* DOT_WID  */
+  YYSYMBOL_DOT_RAD = 69,                   /* DOT_RAD  */
+  YYSYMBOL_SIN = 70,                       /* SIN  */
+  YYSYMBOL_COS = 71,                       /* COS  */
+  YYSYMBOL_ATAN2 = 72,                     /* ATAN2  */
+  YYSYMBOL_LOG = 73,                       /* LOG  */
+  YYSYMBOL_EXP = 74,                       /* EXP  */
+  YYSYMBOL_SQRT = 75,                      /* SQRT  */
+  YYSYMBOL_K_MAX = 76,                     /* K_MAX  */
+  YYSYMBOL_K_MIN = 77,                     /* K_MIN  */
+  YYSYMBOL_INT = 78,                       /* INT  */
+  YYSYMBOL_RAND = 79,                      /* RAND  */
+  YYSYMBOL_SRAND = 80,                     /* SRAND  */
+  YYSYMBOL_COPY = 81,                      /* COPY  */
+  YYSYMBOL_THRU = 82,                      /* THRU  */
+  YYSYMBOL_TOP = 83,                       /* TOP  */
+  YYSYMBOL_BOTTOM = 84,                    /* BOTTOM  */
+  YYSYMBOL_UPPER = 85,                     /* UPPER  */
+  YYSYMBOL_LOWER = 86,                     /* LOWER  */
+  YYSYMBOL_SH = 87,                        /* SH  */
+  YYSYMBOL_PRINT = 88,                     /* PRINT  */
+  YYSYMBOL_CW = 89,                        /* CW  */
+  YYSYMBOL_CCW = 90,                       /* CCW  */
+  YYSYMBOL_FOR = 91,                       /* FOR  */
+  YYSYMBOL_DO = 92,                        /* DO  */
+  YYSYMBOL_IF = 93,                        /* IF  */
+  YYSYMBOL_ELSE = 94,                      /* ELSE  */
+  YYSYMBOL_ANDAND = 95,                    /* ANDAND  */
+  YYSYMBOL_OROR = 96,                      /* OROR  */
+  YYSYMBOL_NOTEQUAL = 97,                  /* NOTEQUAL  */
+  YYSYMBOL_EQUALEQUAL = 98,                /* EQUALEQUAL  */
+  YYSYMBOL_LESSEQUAL = 99,                 /* LESSEQUAL  */
+  YYSYMBOL_GREATEREQUAL = 100,             /* GREATEREQUAL  */
+  YYSYMBOL_LEFT_CORNER = 101,              /* LEFT_CORNER  */
+  YYSYMBOL_RIGHT_CORNER = 102,             /* RIGHT_CORNER  */
+  YYSYMBOL_NORTH = 103,                    /* NORTH  */
+  YYSYMBOL_SOUTH = 104,                    /* SOUTH  */
+  YYSYMBOL_EAST = 105,                     /* EAST  */
+  YYSYMBOL_WEST = 106,                     /* WEST  */
+  YYSYMBOL_CENTER = 107,                   /* CENTER  */
+  YYSYMBOL_END = 108,                      /* END  */
+  YYSYMBOL_START = 109,                    /* START  */
+  YYSYMBOL_RESET = 110,                    /* RESET  */
+  YYSYMBOL_UNTIL = 111,                    /* UNTIL  */
+  YYSYMBOL_PLOT = 112,                     /* PLOT  */
+  YYSYMBOL_THICKNESS = 113,                /* THICKNESS  */
+  YYSYMBOL_FILL = 114,                     /* FILL  */
+  YYSYMBOL_COLORED = 115,                  /* COLORED  */
+  YYSYMBOL_OUTLINED = 116,                 /* OUTLINED  */
+  YYSYMBOL_SHADED = 117,                   /* SHADED  */
+  YYSYMBOL_XSLANTED = 118,                 /* XSLANTED  */
+  YYSYMBOL_YSLANTED = 119,                 /* YSLANTED  */
+  YYSYMBOL_ALIGNED = 120,                  /* ALIGNED  */
+  YYSYMBOL_SPRINTF = 121,                  /* SPRINTF  */
+  YYSYMBOL_COMMAND = 122,                  /* COMMAND  */
+  YYSYMBOL_DEFINE = 123,                   /* DEFINE  */
+  YYSYMBOL_UNDEF = 124,                    /* UNDEF  */
+  YYSYMBOL_125_ = 125,                     /* '.'  */
+  YYSYMBOL_126_ = 126,                     /* '('  */
+  YYSYMBOL_127_ = 127,                     /* '`'  */
+  YYSYMBOL_128_ = 128,                     /* ''  */
+  YYSYMBOL_129_ = 129,                     /* ','  */
+  YYSYMBOL_130_ = 130,                     /* '<'  */
+  YYSYMBOL_131_ = 131,                     /* '>'  */
+  YYSYMBOL_132_ = 132,                     /* '+'  */
+  YYSYMBOL_133_ = 133,                     /* '-'  */
+  YYSYMBOL_134_ = 134,                     /* '*'  */
+  YYSYMBOL_135_ = 135,                     /* '/'  */
+  YYSYMBOL_136_ = 136,                     /* '%'  */
+  YYSYMBOL_137_ = 137,                     /* '!'  */
+  YYSYMBOL_138_ = 138,                     /* '^'  */
+  YYSYMBOL_139_ = 139,                     /* ';'  */
+  YYSYMBOL_140_ = 140,                     /* '='  */
+  YYSYMBOL_141_ = 141,                     /* ':'  */
+  YYSYMBOL_142_ = 142,                     /* '{'  */
+  YYSYMBOL_143_ = 143,                     /* '}'  */
+  YYSYMBOL_144_ = 144,                     /* ''  */
+  YYSYMBOL_145_ = 145,                     /* ')'  */
+  YYSYMBOL_YYACCEPT = 146,                 /* $accept  */
+  YYSYMBOL_top = 147,                      /* top  */
+  YYSYMBOL_element_list = 148,             /* element_list  */
+  YYSYMBOL_middle_element_list = 149,      /* middle_element_list  */
+  YYSYMBOL_optional_separator = 150,       /* optional_separator  */
+  YYSYMBOL_separator = 151,                /* separator  */
+  YYSYMBOL_placeless_element = 152,        /* placeless_element  */
+  YYSYMBOL_153_1 = 153,                    /* $@1  */
+  YYSYMBOL_154_2 = 154,                    /* $@2  */
+  YYSYMBOL_155_3 = 155,                    /* $@3  */
+  YYSYMBOL_156_4 = 156,                    /* $@4  */
+  YYSYMBOL_157_5 = 157,                    /* $@5  */
+  YYSYMBOL_158_6 = 158,                    /* $@6  */
+  YYSYMBOL_159_7 = 159,                    /* $@7  */
+  YYSYMBOL_macro_name = 160,               /* macro_name  */
+  YYSYMBOL_reset_variables = 161,          /* reset_variables  */
+  YYSYMBOL_print_args = 162,               /* print_args  */
+  YYSYMBOL_print_arg = 163,                /* print_arg  */
+  YYSYMBOL_simple_if = 164,                /* simple_if  */
+  YYSYMBOL_165_8 = 165,                    /* $@8  */
+  YYSYMBOL_until = 166,                    /* until  */
+  YYSYMBOL_any_expr = 167,                 /* any_expr  */
+  YYSYMBOL_text_expr = 168,                /* text_expr  */
+  YYSYMBOL_optional_by = 169,              /* optional_by  */
+  YYSYMBOL_element = 170,                  /* element  */
+  YYSYMBOL_171_9 = 171,                    /* @9  */
+  YYSYMBOL_172_10 = 172,                   /* $@10  */
+  YYSYMBOL_optional_element = 173,         /* optional_element  */
+  YYSYMBOL_object_spec = 174,              /* object_spec  */
+  YYSYMBOL_175_11 = 175,                   /* @11  */
+  YYSYMBOL_text = 176,                     /* text  */
+  YYSYMBOL_sprintf_args = 177,             /* sprintf_args  */
+  YYSYMBOL_position = 178,                 /* position  */
+  YYSYMBOL_position_not_place = 179,       /* position_not_place  */
+  YYSYMBOL_between = 180,                  /* between  */
+  YYSYMBOL_expr_pair = 181,                /* expr_pair  */
+  YYSYMBOL_place = 182,                    /* place  */
+  YYSYMBOL_label = 183,                    /* label  */
+  YYSYMBOL_ordinal = 184,                  /* ordinal  */
+  YYSYMBOL_optional_ordinal_last = 185,    /* optional_ordinal_last  */
+  YYSYMBOL_nth_primitive = 186,            /* nth_primitive  */
+  YYSYMBOL_object_type = 187,              /* object_type  */
+  YYSYMBOL_label_path = 188,               /* label_path  */
+  YYSYMBOL_relative_path = 189,            /* relative_path  */
+  YYSYMBOL_path = 190,                     /* path  */
+  YYSYMBOL_corner = 191,                   /* corner  */
+  YYSYMBOL_expr = 192,                     /* expr  */
+  YYSYMBOL_expr_lower_than = 193,          /* expr_lower_than  */
+  YYSYMBOL_expr_not_lower_than = 194       /* expr_not_lower_than  */
+};
+typedef enum yysymbol_kind_t yysymbol_kind_t;
+
 
 
 
@@ -440,28 +656,87 @@
 # undef short
 #endif
 
-#ifdef YYTYPE_UINT8
-typedef YYTYPE_UINT8 yytype_uint8;
-#else
-typedef unsigned char yytype_uint8;
+/* On compilers that do not define __PTRDIFF_MAX__ etc., make sure
+   <limits.h> and (if available) <stdint.h> are included
+   so that the code can choose integer types of a good width.  */
+
+#ifndef __PTRDIFF_MAX__
+# include <limits.h> /* INFRINGES ON USER NAME SPACE */
+# if defined __STDC_VERSION__ && 199901 <= __STDC_VERSION__
+#  include <stdint.h> /* INFRINGES ON USER NAME SPACE */
+#  define YY_STDINT_H
+# endif
 #endif
 
-#ifdef YYTYPE_INT8
-typedef YYTYPE_INT8 yytype_int8;
+/* Narrow types that promote to a signed type and that can represent a
+   signed or unsigned integer of at least N bits.  In tables they can
+   save space and decrease cache pressure.  Promoting to a signed type
+   helps avoid bugs in integer arithmetic.  */
+
+#ifdef __INT_LEAST8_MAX__
+typedef __INT_LEAST8_TYPE__ yytype_int8;
+#elif defined YY_STDINT_H
+typedef int_least8_t yytype_int8;
 #else
 typedef signed char yytype_int8;
 #endif
 
-#ifdef YYTYPE_UINT16
-typedef YYTYPE_UINT16 yytype_uint16;
+#ifdef __INT_LEAST16_MAX__
+typedef __INT_LEAST16_TYPE__ yytype_int16;
+#elif defined YY_STDINT_H
+typedef int_least16_t yytype_int16;
 #else
-typedef unsigned short yytype_uint16;
+typedef short yytype_int16;
 #endif
 
-#ifdef YYTYPE_INT16
-typedef YYTYPE_INT16 yytype_int16;
+/* Work around bug in HP-UX 11.23, which defines these macros
+   incorrectly for preprocessor constants.  This workaround can likely
+   be removed in 2023, as HPE has promised support for HP-UX 11.23
+   (aka HP-UX 11i v2) only through the end of 2022; see Table 2 of
+   <https://h20195.www2.hpe.com/V2/getpdf.aspx/4AA4-7673ENW.pdf>.  */
+#ifdef __hpux
+# undef UINT_LEAST8_MAX
+# undef UINT_LEAST16_MAX
+# define UINT_LEAST8_MAX 255
+# define UINT_LEAST16_MAX 65535
+#endif
+
+#if defined __UINT_LEAST8_MAX__ && __UINT_LEAST8_MAX__ <= __INT_MAX__
+typedef __UINT_LEAST8_TYPE__ yytype_uint8;
+#elif (!defined __UINT_LEAST8_MAX__ && defined YY_STDINT_H \
+       && UINT_LEAST8_MAX <= INT_MAX)
+typedef uint_least8_t yytype_uint8;
+#elif !defined __UINT_LEAST8_MAX__ && UCHAR_MAX <= INT_MAX
+typedef unsigned char yytype_uint8;
 #else
-typedef short yytype_int16;
+typedef short yytype_uint8;
+#endif
+
+#if defined __UINT_LEAST16_MAX__ && __UINT_LEAST16_MAX__ <= __INT_MAX__
+typedef __UINT_LEAST16_TYPE__ yytype_uint16;
+#elif (!defined __UINT_LEAST16_MAX__ && defined YY_STDINT_H \
+       && UINT_LEAST16_MAX <= INT_MAX)
+typedef uint_least16_t yytype_uint16;
+#elif !defined __UINT_LEAST16_MAX__ && USHRT_MAX <= INT_MAX
+typedef unsigned short yytype_uint16;
+#else
+typedef int yytype_uint16;
+#endif
+
+#ifndef YYPTRDIFF_T
+# if defined __PTRDIFF_TYPE__ && defined __PTRDIFF_MAX__
+#  define YYPTRDIFF_T __PTRDIFF_TYPE__
+#  define YYPTRDIFF_MAXIMUM __PTRDIFF_MAX__
+# elif defined PTRDIFF_MAX
+#  ifndef ptrdiff_t
+#   include <stddef.h> /* INFRINGES ON USER NAME SPACE */
+#  endif
+#  define YYPTRDIFF_T ptrdiff_t
+#  define YYPTRDIFF_MAXIMUM PTRDIFF_MAX
+# else
+#  define YYPTRDIFF_T long
+#  define YYPTRDIFF_MAXIMUM LONG_MAX
+# endif
 #endif
 
 #ifndef YYSIZE_T
@@ -469,7 +744,7 @@
 #  define YYSIZE_T __SIZE_TYPE__
 # elif defined size_t
 #  define YYSIZE_T size_t
-# elif ! defined YYSIZE_T
+# elif defined __STDC_VERSION__ && 199901 <= __STDC_VERSION__
 #  include <stddef.h> /* INFRINGES ON USER NAME SPACE */
 #  define YYSIZE_T size_t
 # else
@@ -477,7 +752,20 @@
 # endif
 #endif
 
-#define YYSIZE_MAXIMUM ((YYSIZE_T) -1)
+#define YYSIZE_MAXIMUM                                  \
+  YY_CAST (YYPTRDIFF_T,                                 \
+           (YYPTRDIFF_MAXIMUM < YY_CAST (YYSIZE_T, -1)  \
+            ? YYPTRDIFF_MAXIMUM                         \
+            : YY_CAST (YYSIZE_T, -1)))
+
+#define YYSIZEOF(X) YY_CAST (YYPTRDIFF_T, sizeof (X))
+
+
+/* Stored state numbers (used for stacks). */
+typedef yytype_int16 yy_state_t;
+
+/* State numbers in computations.  */
+typedef int yy_state_fast_t;
 
 #ifndef YY_
 # if defined YYENABLE_NLS && YYENABLE_NLS
@@ -491,38 +779,43 @@
 # endif
 #endif
 
-#ifndef YY_ATTRIBUTE
-# if (defined __GNUC__                                               \
-      && (2 < __GNUC__ || (__GNUC__ == 2 && 96 <= __GNUC_MINOR__)))  \
-     || defined __SUNPRO_C && 0x5110 <= __SUNPRO_C
-#  define YY_ATTRIBUTE(Spec) __attribute__(Spec)
-# else
-#  define YY_ATTRIBUTE(Spec) /* empty */
-# endif
-#endif
 
 #ifndef YY_ATTRIBUTE_PURE
-# define YY_ATTRIBUTE_PURE   YY_ATTRIBUTE ((__pure__))
+# if defined __GNUC__ && 2 < __GNUC__ + (96 <= __GNUC_MINOR__)
+#  define YY_ATTRIBUTE_PURE __attribute__ ((__pure__))
+# else
+#  define YY_ATTRIBUTE_PURE
+# endif
 #endif
 
 #ifndef YY_ATTRIBUTE_UNUSED
-# define YY_ATTRIBUTE_UNUSED YY_ATTRIBUTE ((__unused__))
+# if defined __GNUC__ && 2 < __GNUC__ + (7 <= __GNUC_MINOR__)
+#  define YY_ATTRIBUTE_UNUSED __attribute__ ((__unused__))
+# else
+#  define YY_ATTRIBUTE_UNUSED
+# endif
 #endif
 
 /* Suppress unused-variable warnings by "using" E.  */
 #if ! defined lint || defined __GNUC__
-# define YYUSE(E) ((void) (E))
+# define YY_USE(E) ((void) (E))
 #else
-# define YYUSE(E) /* empty */
+# define YY_USE(E) /* empty */
 #endif
 
-#if defined __GNUC__ && ! defined __ICC && 407 <= __GNUC__ * 100 + __GNUC_MINOR__
 /* Suppress an incorrect diagnostic about yylval being uninitialized.  */
-# define YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN \
-    _Pragma ("GCC diagnostic push") \
-    _Pragma ("GCC diagnostic ignored \"-Wuninitialized\"")\
+#if defined __GNUC__ && ! defined __ICC && 406 <= __GNUC__ * 100 + __GNUC_MINOR__
+# if __GNUC__ * 100 + __GNUC_MINOR__ < 407
+#  define YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN                           \
+    _Pragma ("GCC diagnostic push")                                     \
+    _Pragma ("GCC diagnostic ignored \"-Wuninitialized\"")
+# else
+#  define YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN                           \
+    _Pragma ("GCC diagnostic push")                                     \
+    _Pragma ("GCC diagnostic ignored \"-Wuninitialized\"")              \
     _Pragma ("GCC diagnostic ignored \"-Wmaybe-uninitialized\"")
-# define YY_IGNORE_MAYBE_UNINITIALIZED_END \
+# endif
+# define YY_IGNORE_MAYBE_UNINITIALIZED_END      \
     _Pragma ("GCC diagnostic pop")
 #else
 # define YY_INITIAL_VALUE(Value) Value
@@ -535,8 +828,22 @@
 # define YY_INITIAL_VALUE(Value) /* Nothing. */
 #endif
 
+#if defined __cplusplus && defined __GNUC__ && ! defined __ICC && 6 <= __GNUC__
+# define YY_IGNORE_USELESS_CAST_BEGIN                          \
+    _Pragma ("GCC diagnostic push")                            \
+    _Pragma ("GCC diagnostic ignored \"-Wuseless-cast\"")
+# define YY_IGNORE_USELESS_CAST_END            \
+    _Pragma ("GCC diagnostic pop")
+#endif
+#ifndef YY_IGNORE_USELESS_CAST_BEGIN
+# define YY_IGNORE_USELESS_CAST_BEGIN
+# define YY_IGNORE_USELESS_CAST_END
+#endif
+
 
-#if ! defined yyoverflow || YYERROR_VERBOSE
+#define YY_ASSERT(E) ((void) (0 && (E)))
+
+#if !defined yyoverflow
 
 /* The parser invokes alloca or malloc; define the necessary symbols.  */
 
@@ -601,8 +908,7 @@
 #   endif
 #  endif
 # endif
-#endif /* ! defined yyoverflow || YYERROR_VERBOSE */
-
+#endif /* !defined yyoverflow */
 
 #if (! defined yyoverflow \
      && (! defined __cplusplus \
@@ -611,17 +917,17 @@
 /* A type that is properly aligned for any stack member.  */
 union yyalloc
 {
-  yytype_int16 yyss_alloc;
+  yy_state_t yyss_alloc;
   YYSTYPE yyvs_alloc;
 };
 
 /* The size of the maximum gap between one aligned stack and the next.  */
-# define YYSTACK_GAP_MAXIMUM (sizeof (union yyalloc) - 1)
+# define YYSTACK_GAP_MAXIMUM (YYSIZEOF (union yyalloc) - 1)
 
 /* The size of an array large to enough to hold all stacks, each with
    N elements.  */
 # define YYSTACK_BYTES(N) \
-     ((N) * (sizeof (yytype_int16) + sizeof (YYSTYPE)) \
+     ((N) * (YYSIZEOF (yy_state_t) + YYSIZEOF (YYSTYPE)) \
       + YYSTACK_GAP_MAXIMUM)
 
 # define YYCOPY_NEEDED 1
@@ -634,11 +940,11 @@
 # define YYSTACK_RELOCATE(Stack_alloc, Stack)                           \
     do                                                                  \
       {                                                                 \
-        YYSIZE_T yynewbytes;                                            \
+        YYPTRDIFF_T yynewbytes;                                         \
         YYCOPY (&yyptr->Stack_alloc, Stack, yysize);                    \
         Stack = &yyptr->Stack_alloc;                                    \
-        yynewbytes = yystacksize * sizeof (*Stack) + YYSTACK_GAP_MAXIMUM; \
-        yyptr += yynewbytes / sizeof (*yyptr);                          \
+        yynewbytes = yystacksize * YYSIZEOF (*Stack) + YYSTACK_GAP_MAXIMUM; \
+        yyptr += yynewbytes / YYSIZEOF (*yyptr);                        \
       }                                                                 \
     while (0)
 
@@ -650,12 +956,12 @@
 # ifndef YYCOPY
 #  if defined __GNUC__ && 1 < __GNUC__
 #   define YYCOPY(Dst, Src, Count) \
-      __builtin_memcpy (Dst, Src, (Count) * sizeof (*(Src)))
+      __builtin_memcpy (Dst, Src, YY_CAST (YYSIZE_T, (Count)) * sizeof (*(Src)))
 #  else
 #   define YYCOPY(Dst, Src, Count)              \
       do                                        \
         {                                       \
-          YYSIZE_T yyi;                         \
+          YYPTRDIFF_T yyi;                      \
           for (yyi = 0; yyi < (Count); yyi++)   \
             (Dst)yyi = (Src)yyi;            \
         }                                       \
@@ -678,16 +984,19 @@
 /* YYNSTATES -- Number of states.  */
 #define YYNSTATES  454
 
-/* YYTRANSLATEYYX -- Symbol number corresponding to YYX as returned
-   by yylex, with out-of-bounds checking.  */
-#define YYUNDEFTOK  2
+/* YYMAXUTOK -- Last valid token kind.  */
 #define YYMAXUTOK   379
 
-#define YYTRANSLATE(YYX)                                                \
-  ((unsigned) (YYX) <= YYMAXUTOK ? yytranslateYYX : YYUNDEFTOK)
+
+/* YYTRANSLATE(TOKEN-NUM) -- Symbol number corresponding to TOKEN-NUM
+   as returned by yylex, with out-of-bounds checking.  */
+#define YYTRANSLATE(YYX)                                \
+  (0 <= (YYX) && (YYX) <= YYMAXUTOK                     \
+   ? YY_CAST (yysymbol_kind_t, yytranslateYYX)        \
+   : YYSYMBOL_YYUNDEF)
 
 /* YYTRANSLATETOKEN-NUM -- Symbol number corresponding to TOKEN-NUM
-   as returned by yylex, without out-of-bounds checking.  */
+   as returned by yylex.  */
 static const yytype_uint8 yytranslate =
 {
        0,     2,     2,     2,     2,     2,     2,     2,     2,     2,
@@ -731,111 +1040,101 @@
 };
 
 #if YYDEBUG
-  /* YYRLINEYYN -- Source line where rule number YYN was defined.  */
-static const yytype_uint16 yyrline =
+/* YYRLINEYYN -- Source line where rule number YYN was defined.  */
+static const yytype_int16 yyrline =
 {
        0,   275,   275,   276,   285,   290,   292,   296,   298,   302,
      303,   307,   315,   320,   332,   334,   336,   338,   340,   345,
-     350,   357,   356,   367,   375,   377,   374,   388,   390,   387,
-     400,   399,   408,   417,   416,   430,   431,   436,   437,   441,
-     446,   451,   459,   461,   480,   487,   489,   500,   499,   511,
-     512,   517,   519,   524,   530,   536,   538,   540,   542,   544,
-     546,   548,   555,   559,   564,   572,   586,   592,   600,   607,
-     613,   606,   622,   632,   633,   638,   640,   642,   644,   649,
-     656,   663,   670,   677,   682,   687,   695,   694,   721,   727,
-     733,   739,   745,   764,   771,   778,   785,   792,   799,   806,
-     813,   820,   827,   842,   854,   860,   869,   876,   901,   905,
-     911,   917,   923,   929,   934,   940,   946,   952,   959,   968,
-     975,   991,  1008,  1013,  1018,  1023,  1028,  1033,  1038,  1043,
-    1051,  1061,  1071,  1081,  1091,  1097,  1105,  1107,  1119,  1124,
-    1154,  1156,  1162,  1171,  1173,  1178,  1183,  1188,  1193,  1198,
-    1203,  1209,  1214,  1222,  1223,  1227,  1232,  1238,  1240,  1246,
-    1252,  1258,  1267,  1277,  1279,  1288,  1290,  1298,  1300,  1305,
-    1320,  1338,  1340,  1342,  1344,  1346,  1348,  1350,  1352,  1354,
-    1359,  1361,  1369,  1373,  1375,  1383,  1385,  1391,  1397,  1403,
-    1409,  1418,  1420,  1422,  1424,  1426,  1428,  1430,  1432,  1434,
-    1436,  1438,  1440,  1442,  1444,  1446,  1448,  1450,  1452,  1454,
-    1456,  1458,  1460,  1462,  1464,  1466,  1468,  1470,  1472,  1474,
-    1476,  1478,  1480,  1485,  1487,  1492,  1497,  1505,  1507,  1514,
-    1521,  1528,  1535,  1542,  1544,  1546,  1548,  1556,  1564,  1577,
-    1579,  1581,  1590,  1599,  1612,  1621,  1630,  1639,  1641,  1643,
-    1645,  1647,  1653,  1658,  1660,  1662,  1664,  1666,  1668,  1670,
-    1672
+     350,   357,   356,   372,   380,   382,   379,   393,   395,   392,
+     405,   404,   413,   422,   421,   435,   436,   441,   442,   446,
+     451,   456,   464,   466,   485,   492,   494,   505,   504,   516,
+     517,   522,   524,   529,   535,   541,   543,   545,   547,   549,
+     551,   553,   560,   564,   569,   577,   591,   597,   605,   612,
+     618,   611,   627,   637,   638,   643,   645,   647,   649,   654,
+     661,   668,   675,   682,   687,   694,   702,   701,   728,   734,
+     740,   746,   752,   771,   778,   785,   792,   799,   806,   813,
+     820,   827,   834,   849,   861,   867,   876,   883,   908,   912,
+     918,   924,   930,   936,   941,   947,   953,   959,   966,   975,
+     982,   998,  1015,  1020,  1025,  1030,  1035,  1040,  1045,  1050,
+    1058,  1068,  1078,  1088,  1098,  1104,  1112,  1114,  1126,  1131,
+    1161,  1163,  1169,  1178,  1180,  1185,  1190,  1195,  1200,  1205,
+    1210,  1216,  1221,  1229,  1230,  1234,  1239,  1245,  1247,  1253,
+    1259,  1265,  1274,  1284,  1286,  1295,  1297,  1305,  1307,  1312,
+    1327,  1345,  1347,  1349,  1351,  1353,  1355,  1357,  1359,  1361,
+    1366,  1368,  1376,  1380,  1382,  1390,  1392,  1398,  1404,  1410,
+    1416,  1425,  1427,  1429,  1431,  1433,  1435,  1437,  1439,  1441,
+    1443,  1445,  1447,  1449,  1451,  1453,  1455,  1457,  1459,  1461,
+    1463,  1465,  1467,  1469,  1471,  1473,  1475,  1477,  1479,  1481,
+    1483,  1485,  1487,  1492,  1494,  1499,  1504,  1512,  1514,  1521,
+    1528,  1535,  1542,  1549,  1551,  1553,  1555,  1563,  1571,  1584,
+    1586,  1588,  1597,  1606,  1619,  1628,  1637,  1646,  1648,  1650,
+    1652,  1659,  1665,  1670,  1672,  1674,  1676,  1678,  1680,  1682,
+    1684
 };
 #endif
 
-#if YYDEBUG || YYERROR_VERBOSE || 0
+/** Accessing symbol of state STATE.  */
+#define YY_ACCESSING_SYMBOL(State) YY_CAST (yysymbol_kind_t, yystosState)
+
+#if YYDEBUG || 0
+/* The user-facing name of the symbol whose (internal) number is
+   YYSYMBOL.  No bounds checking.  */
+static const char *yysymbol_name (yysymbol_kind_t yysymbol) YY_ATTRIBUTE_UNUSED;
+
 /* YYTNAMESYMBOL-NUM -- String name of the symbol SYMBOL-NUM.
    First, the terminals, then, starting at YYNTOKENS, nonterminals.  */
 static const char *const yytname =
 {
-  "$end", "error", "$undefined", "LABEL", "VARIABLE", "NUMBER", "TEXT",
-  "COMMAND_LINE", "DELIMITED", "ORDINAL", "TH", "LEFT_ARROW_HEAD",
-  "RIGHT_ARROW_HEAD", "DOUBLE_ARROW_HEAD", "LAST", "BOX", "CIRCLE",
-  "ELLIPSE", "ARC", "LINE", "ARROW", "MOVE", "SPLINE", "HEIGHT", "RADIUS",
-  "FIGNAME", "WIDTH", "DIAMETER", "UP", "DOWN", "RIGHT", "LEFT", "FROM",
-  "TO", "AT", "WITH", "BY", "THEN", "SOLID", "DOTTED", "DASHED", "CHOP",
-  "SAME", "INVISIBLE", "LJUST", "RJUST", "ABOVE", "BELOW", "OF", "THE",
-  "WAY", "BETWEEN", "AND", "HERE", "DOT_N", "DOT_E", "DOT_W", "DOT_S",
-  "DOT_NE", "DOT_SE", "DOT_NW", "DOT_SW", "DOT_C", "DOT_START", "DOT_END",
-  "DOT_X", "DOT_Y", "DOT_HT", "DOT_WID", "DOT_RAD", "SIN", "COS", "ATAN2",
-  "LOG", "EXP", "SQRT", "K_MAX", "K_MIN", "INT", "RAND", "SRAND", "COPY",
-  "THRU", "TOP", "BOTTOM", "UPPER", "LOWER", "SH", "PRINT", "CW", "CCW",
-  "FOR", "DO", "IF", "ELSE", "ANDAND", "OROR", "NOTEQUAL", "EQUALEQUAL",
-  "LESSEQUAL", "GREATEREQUAL", "LEFT_CORNER", "RIGHT_CORNER", "NORTH",
-  "SOUTH", "EAST", "WEST", "CENTER", "END", "START", "RESET", "UNTIL",
-  "PLOT", "THICKNESS", "FILL", "COLORED", "OUTLINED", "SHADED", "XSLANTED",
-  "YSLANTED", "ALIGNED", "SPRINTF", "COMMAND", "DEFINE", "UNDEF", "'.'",
-  "'('", "'`'", "''", "','", "'<'", "'>'", "'+'", "'-'", "'*'", "'/'",
-  "'%'", "'!'", "'^'", "';'", "'='", "':'", "'{'", "'}'", "''", "')'",
-  "$accept", "top", "element_list", "middle_element_list",
-  "optional_separator", "separator", "placeless_element", "$@1", "$@2",
-  "$@3", "$@4", "$@5", "$@6", "$@7", "macro_name", "reset_variables",
-  "print_args", "print_arg", "simple_if", "$@8", "until", "any_expr",
-  "text_expr", "optional_by", "element", "@9", "$@10", "optional_element",
-  "object_spec", "@11", "text", "sprintf_args", "position",
-  "position_not_place", "between", "expr_pair", "place", "label",
-  "ordinal", "optional_ordinal_last", "nth_primitive", "object_type",
-  "label_path", "relative_path", "path", "corner", "expr",
+  "\"end of file\"", "error", "\"invalid token\"", "LABEL", "VARIABLE",
+  "NUMBER", "TEXT", "COMMAND_LINE", "DELIMITED", "ORDINAL", "TH",
+  "LEFT_ARROW_HEAD", "RIGHT_ARROW_HEAD", "DOUBLE_ARROW_HEAD", "LAST",
+  "BOX", "CIRCLE", "ELLIPSE", "ARC", "LINE", "ARROW", "MOVE", "SPLINE",
+  "HEIGHT", "RADIUS", "FIGNAME", "WIDTH", "DIAMETER", "UP", "DOWN",
+  "RIGHT", "LEFT", "FROM", "TO", "AT", "WITH", "BY", "THEN", "SOLID",
+  "DOTTED", "DASHED", "CHOP", "SAME", "INVISIBLE", "LJUST", "RJUST",
+  "ABOVE", "BELOW", "OF", "THE", "WAY", "BETWEEN", "AND", "HERE", "DOT_N",
+  "DOT_E", "DOT_W", "DOT_S", "DOT_NE", "DOT_SE", "DOT_NW", "DOT_SW",
+  "DOT_C", "DOT_START", "DOT_END", "DOT_X", "DOT_Y", "DOT_HT", "DOT_WID",
+  "DOT_RAD", "SIN", "COS", "ATAN2", "LOG", "EXP", "SQRT", "K_MAX", "K_MIN",
+  "INT", "RAND", "SRAND", "COPY", "THRU", "TOP", "BOTTOM", "UPPER",
+  "LOWER", "SH", "PRINT", "CW", "CCW", "FOR", "DO", "IF", "ELSE", "ANDAND",
+  "OROR", "NOTEQUAL", "EQUALEQUAL", "LESSEQUAL", "GREATEREQUAL",
+  "LEFT_CORNER", "RIGHT_CORNER", "NORTH", "SOUTH", "EAST", "WEST",
+  "CENTER", "END", "START", "RESET", "UNTIL", "PLOT", "THICKNESS", "FILL",
+  "COLORED", "OUTLINED", "SHADED", "XSLANTED", "YSLANTED", "ALIGNED",
+  "SPRINTF", "COMMAND", "DEFINE", "UNDEF", "'.'", "'('", "'`'", "''",
+  "','", "'<'", "'>'", "'+'", "'-'", "'*'", "'/'", "'%'", "'!'", "'^'",
+  "';'", "'='", "':'", "'{'", "'}'", "''", "')'", "$accept", "top",
+  "element_list", "middle_element_list", "optional_separator", "separator",
+  "placeless_element", "$@1", "$@2", "$@3", "$@4", "$@5", "$@6", "$@7",
+  "macro_name", "reset_variables", "print_args", "print_arg", "simple_if",
+  "$@8", "until", "any_expr", "text_expr", "optional_by", "element", "@9",
+  "$@10", "optional_element", "object_spec", "@11", "text", "sprintf_args",
+  "position", "position_not_place", "between", "expr_pair", "place",
+  "label", "ordinal", "optional_ordinal_last", "nth_primitive",
+  "object_type", "label_path", "relative_path", "path", "corner", "expr",
   "expr_lower_than", "expr_not_lower_than", YY_NULLPTR
 };
-#endif
 
-# ifdef YYPRINT
-/* YYTOKNUMNUM -- (External) token number corresponding to the
-   (internal) symbol number NUM (which must be that of a token).  */
-static const yytype_uint16 yytoknum =
+static const char *
+yysymbol_name (yysymbol_kind_t yysymbol)
 {
-       0,   256,   257,   258,   259,   260,   261,   262,   263,   264,
-     265,   266,   267,   268,   269,   270,   271,   272,   273,   274,
-     275,   276,   277,   278,   279,   280,   281,   282,   283,   284,
-     285,   286,   287,   288,   289,   290,   291,   292,   293,   294,
-     295,   296,   297,   298,   299,   300,   301,   302,   303,   304,
-     305,   306,   307,   308,   309,   310,   311,   312,   313,   314,
-     315,   316,   317,   318,   319,   320,   321,   322,   323,   324,
-     325,   326,   327,   328,   329,   330,   331,   332,   333,   334,
-     335,   336,   337,   338,   339,   340,   341,   342,   343,   344,
-     345,   346,   347,   348,   349,   350,   351,   352,   353,   354,
-     355,   356,   357,   358,   359,   360,   361,   362,   363,   364,
-     365,   366,   367,   368,   369,   370,   371,   372,   373,   374,
-     375,   376,   377,   378,   379,    46,    40,    96,    91,    44,
-      60,    62,    43,    45,    42,    47,    37,    33,    94,    59,
-      61,    58,   123,   125,    93,    41
-};
-# endif
+  return yytnameyysymbol;
+}
+#endif
 
-#define YYPACT_NINF -240
+#define YYPACT_NINF (-240)
 
-#define yypact_value_is_default(Yystate) \
-  (!!((Yystate) == (-240)))
+#define yypact_value_is_default(Yyn) \
+  ((Yyn) == YYPACT_NINF)
 
-#define YYTABLE_NINF -206
+#define YYTABLE_NINF (-206)
 
-#define yytable_value_is_error(Yytable_value) \
+#define yytable_value_is_error(Yyn) \
   0
 
-  /* YYPACTSTATE-NUM -- Index in YYTABLE of the portion describing
-     STATE-NUM.  */
+/* YYPACTSTATE-NUM -- Index in YYTABLE of the portion describing
+   STATE-NUM.  */
 static const yytype_int16 yypact =
 {
     -114,  -240,    20,  -240,   757,  -107,  -240,   -98,  -123,  -240,
@@ -886,10 +1185,10 @@
     -240,  2282,   354,  -240
 };
 
-  /* YYDEFACTSTATE-NUM -- Default reduction number in state STATE-NUM.
-     Performed when YYTABLE does not specify something else to do.  Zero
-     means the default is an error.  */
-static const yytype_uint16 yydefact =
+/* YYDEFACTSTATE-NUM -- Default reduction number in state STATE-NUM.
+   Performed when YYTABLE does not specify something else to do.  Zero
+   means the default is an error.  */
+static const yytype_int16 yydefact =
 {
        7,     9,     0,     3,     2,     8,     1,     0,     0,   136,
       18,    75,    76,    77,    78,    79,    80,    81,    82,     0,
@@ -939,7 +1238,7 @@
      152,    64,     0,    31
 };
 
-  /* YYPGOTONTERM-NUM.  */
+/* YYPGOTONTERM-NUM.  */
 static const yytype_int16 yypgoto =
 {
     -240,  -240,    17,  -240,    12,   329,  -240,  -240,  -240,  -240,
@@ -949,19 +1248,19 @@
     -240,  -104,  -240,  -239,  -240,   -50,   -26,  -240,    61
 };
 
-  /* YYDEFGOTONTERM-NUM.  */
+/* YYDEFGOTONTERM-NUM.  */
 static const yytype_int16 yydefgoto =
 {
-      -1,     2,     3,    35,   264,     5,    36,    49,   313,   415,
+       0,     2,     3,    35,   264,     5,    36,    49,   313,   415,
      178,   386,   452,   268,   176,    37,    97,    98,    38,   360,
      417,   199,   116,   443,    39,   126,   410,   432,    40,   125,
      117,   371,   100,   101,   249,   102,   118,   104,   105,   106,
      107,   228,   287,   288,   289,   108,   119,   110,   120
 };
 
-  /* YYTABLEYYPACTSTATE-NUM -- What to do in state STATE-NUM.  If
-     positive, shift that token.  If negative, reduce the rule whose
-     number is the opposite.  If YYTABLE_NINF, syntax error.  */
+/* YYTABLEYYPACTSTATE-NUM -- What to do in state STATE-NUM.  If
+   positive, shift that token.  If negative, reduce the rule whose
+   number is the opposite.  If YYTABLE_NINF, syntax error.  */
 static const yytype_int16 yytable =
 {
      109,   266,   229,   404,   122,   424,   109,   129,   231,    41,
@@ -1458,8 +1757,8 @@
      130,   131,   132,   133,   134,   135,   136,    -1,   138
 };
 
-  /* YYSTOSSTATE-NUM -- The (internal number of the) accessing
-     symbol of state STATE-NUM.  */
+/* YYSTOSSTATE-NUM -- The symbol kind of the accessing symbol of
+   state STATE-NUM.  */
 static const yytype_uint8 yystos =
 {
        0,   139,   147,   148,   150,   151,     0,     3,     4,     6,
@@ -1510,7 +1809,7 @@
      145,   192,   158,     8
 };
 
-  /* YYR1YYN -- Symbol number of symbol that rule YYN derives.  */
+/* YYR1RULE-NUM -- Symbol kind of the left-hand side of rule RULE-NUM.  */
 static const yytype_uint8 yyr1 =
 {
        0,   146,   147,   147,   148,   149,   149,   150,   150,   151,
@@ -1542,8 +1841,8 @@
      194
 };
 
-  /* YYR2YYN -- Number of symbols on the right hand side of rule YYN.  */
-static const yytype_uint8 yyr2 =
+/* YYR2RULE-NUM -- Number of symbols on the right-hand side of rule RULE-NUM.  */
+static const yytype_int8 yyr2 =
 {
        0,     2,     1,     1,     3,     1,     3,     0,     1,     1,
        2,     3,     3,     4,     1,     1,     1,     1,     1,     2,
@@ -1575,39 +1874,39 @@
 };
 
 
+enum { YYENOMEM = -2 };
+
 #define yyerrok         (yyerrstatus = 0)
 #define yyclearin       (yychar = YYEMPTY)
-#define YYEMPTY         (-2)
-#define YYEOF           0
 
 #define YYACCEPT        goto yyacceptlab
 #define YYABORT         goto yyabortlab
 #define YYERROR         goto yyerrorlab
+#define YYNOMEM         goto yyexhaustedlab
 
 
 #define YYRECOVERING()  (!!yyerrstatus)
 
-#define YYBACKUP(Token, Value)                                  \
-do                                                              \
-  if (yychar == YYEMPTY)                                        \
-    {                                                           \
-      yychar = (Token);                                         \
-      yylval = (Value);                                         \
-      YYPOPSTACK (yylen);                                       \
-      yystate = *yyssp;                                         \
-      goto yybackup;                                            \
-    }                                                           \
-  else                                                          \
-    {                                                           \
-      yyerror (YY_("syntax error: cannot back up")); \
-      YYERROR;                                                  \
-    }                                                           \
-while (0)
-
-/* Error token number */
-#define YYTERROR        1
-#define YYERRCODE       256
-
+#define YYBACKUP(Token, Value)                                    \
+  do                                                              \
+    if (yychar == YYEMPTY)                                        \
+      {                                                           \
+        yychar = (Token);                                         \
+        yylval = (Value);                                         \
+        YYPOPSTACK (yylen);                                       \
+        yystate = *yyssp;                                         \
+        goto yybackup;                                            \
+      }                                                           \
+    else                                                          \
+      {                                                           \
+        yyerror (YY_("syntax error: cannot back up")); \
+        YYERROR;                                                  \
+      }                                                           \
+  while (0)
+
+/* Backward compatibility with an undocumented macro.
+   Use YYerror or YYUNDEF. */
+#define YYERRCODE YYUNDEF
 
 
 /* Enable debugging if requested.  */
@@ -1624,19 +1923,16 @@
     YYFPRINTF Args;                             \
 } while (0)
 
-/* This macro is provided for backward compatibility. */
-#ifndef YY_LOCATION_PRINT
-# define YY_LOCATION_PRINT(File, Loc) ((void) 0)
-#endif
 
 
-# define YY_SYMBOL_PRINT(Title, Type, Value, Location)                    \
+
+# define YY_SYMBOL_PRINT(Title, Kind, Value, Location)                    \
 do {                                                                      \
   if (yydebug)                                                            \
     {                                                                     \
       YYFPRINTF (stderr, "%s ", Title);                                   \
       yy_symbol_print (stderr,                                            \
-                  Type, Value); \
+                  Kind, Value); \
       YYFPRINTF (stderr, "\n");                                           \
     }                                                                     \
 } while (0)
@@ -1647,17 +1943,16 @@
 `-----------------------------------*/
 
 static void
-yy_symbol_value_print (FILE *yyo, int yytype, YYSTYPE const * const yyvaluep)
+yy_symbol_value_print (FILE *yyo,
+                       yysymbol_kind_t yykind, YYSTYPE const * const yyvaluep)
 {
   FILE *yyoutput = yyo;
-  YYUSE (yyoutput);
+  YY_USE (yyoutput);
   if (!yyvaluep)
     return;
-# ifdef YYPRINT
-  if (yytype < YYNTOKENS)
-    YYPRINT (yyo, yytoknumyytype, *yyvaluep);
-# endif
-  YYUSE (yytype);
+  YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN
+  YY_USE (yykind);
+  YY_IGNORE_MAYBE_UNINITIALIZED_END
 }
 
 
@@ -1666,12 +1961,13 @@
 `---------------------------*/
 
 static void
-yy_symbol_print (FILE *yyo, int yytype, YYSTYPE const * const yyvaluep)
+yy_symbol_print (FILE *yyo,
+                 yysymbol_kind_t yykind, YYSTYPE const * const yyvaluep)
 {
   YYFPRINTF (yyo, "%s %s (",
-             yytype < YYNTOKENS ? "token" : "nterm", yytnameyytype);
+             yykind < YYNTOKENS ? "token" : "nterm", yysymbol_name (yykind));
 
-  yy_symbol_value_print (yyo, yytype, yyvaluep);
+  yy_symbol_value_print (yyo, yykind, yyvaluep);
   YYFPRINTF (yyo, ")");
 }
 
@@ -1681,7 +1977,7 @@
 `------------------------------------------------------------------*/
 
 static void
-yy_stack_print (yytype_int16 *yybottom, yytype_int16 *yytop)
+yy_stack_print (yy_state_t *yybottom, yy_state_t *yytop)
 {
   YYFPRINTF (stderr, "Stack now");
   for (; yybottom <= yytop; yybottom++)
@@ -1704,21 +2000,21 @@
 `------------------------------------------------*/
 
 static void
-yy_reduce_print (yytype_int16 *yyssp, YYSTYPE *yyvsp, int yyrule)
+yy_reduce_print (yy_state_t *yyssp, YYSTYPE *yyvsp,
+                 int yyrule)
 {
-  unsigned long yylno = yyrlineyyrule;
+  int yylno = yyrlineyyrule;
   int yynrhs = yyr2yyrule;
   int yyi;
-  YYFPRINTF (stderr, "Reducing stack by rule %d (line %lu):\n",
+  YYFPRINTF (stderr, "Reducing stack by rule %d (line %d):\n",
              yyrule - 1, yylno);
   /* The symbols being reduced.  */
   for (yyi = 0; yyi < yynrhs; yyi++)
     {
       YYFPRINTF (stderr, "   $%d = ", yyi + 1);
       yy_symbol_print (stderr,
-                       yystosyysspyyi + 1 - yynrhs,
-                       &(yyvsp(yyi + 1) - (yynrhs))
-                                              );
+                       YY_ACCESSING_SYMBOL (+yysspyyi + 1 - yynrhs),
+                       &yyvsp(yyi + 1) - (yynrhs));
       YYFPRINTF (stderr, "\n");
     }
 }
@@ -1733,8 +2029,8 @@
    multiple parsers can coexist.  */
 int yydebug;
 #else /* !YYDEBUG */
-# define YYDPRINTF(Args)
-# define YY_SYMBOL_PRINT(Title, Type, Value, Location)
+# define YYDPRINTF(Args) ((void) 0)
+# define YY_SYMBOL_PRINT(Title, Kind, Value, Location)
 # define YY_STACK_PRINT(Bottom, Top)
 # define YY_REDUCE_PRINT(Rule)
 #endif /* !YYDEBUG */
@@ -1757,250 +2053,30 @@
 #endif
 
 
-#if YYERROR_VERBOSE
-
-# ifndef yystrlen
-#  if defined __GLIBC__ && defined _STRING_H
-#   define yystrlen strlen
-#  else
-/* Return the length of YYSTR.  */
-static YYSIZE_T
-yystrlen (const char *yystr)
-{
-  YYSIZE_T yylen;
-  for (yylen = 0; yystryylen; yylen++)
-    continue;
-  return yylen;
-}
-#  endif
-# endif
-
-# ifndef yystpcpy
-#  if defined __GLIBC__ && defined _STRING_H && defined _GNU_SOURCE
-#   define yystpcpy stpcpy
-#  else
-/* Copy YYSRC to YYDEST, returning the address of the terminating '\0' in
-   YYDEST.  */
-static char *
-yystpcpy (char *yydest, const char *yysrc)
-{
-  char *yyd = yydest;
-  const char *yys = yysrc;
-
-  while ((*yyd++ = *yys++) != '\0')
-    continue;
-
-  return yyd - 1;
-}
-#  endif
-# endif
-
-# ifndef yytnamerr
-/* Copy to YYRES the contents of YYSTR after stripping away unnecessary
-   quotes and backslashes, so that it's suitable for yyerror.  The
-   heuristic is that double-quoting is unnecessary unless the string
-   contains an apostrophe, a comma, or backslash (other than
-   backslash-backslash).  YYSTR is taken from yytname.  If YYRES is
-   null, do not copy; instead, return the length of what the result
-   would have been.  */
-static YYSIZE_T
-yytnamerr (char *yyres, const char *yystr)
-{
-  if (*yystr == '"')
-    {
-      YYSIZE_T yyn = 0;
-      char const *yyp = yystr;
-
-      for (;;)
-        switch (*++yyp)
-          {
-          case '\'':
-          case ',':
-            goto do_not_strip_quotes;
-
-          case '\\':
-            if (*++yyp != '\\')
-              goto do_not_strip_quotes;
-            /* Fall through.  */
-          default:
-            if (yyres)
-              yyresyyn = *yyp;
-            yyn++;
-            break;
-
-          case '"':
-            if (yyres)
-              yyresyyn = '\0';
-            return yyn;
-          }
-    do_not_strip_quotes: ;
-    }
-
-  if (! yyres)
-    return yystrlen (yystr);
-
-  return (YYSIZE_T) (yystpcpy (yyres, yystr) - yyres);
-}
-# endif
-
-/* Copy into *YYMSG, which is of size *YYMSG_ALLOC, an error message
-   about the unexpected token YYTOKEN for the state stack whose top is
-   YYSSP.
-
-   Return 0 if *YYMSG was successfully written.  Return 1 if *YYMSG is
-   not large enough to hold the message.  In that case, also set
-   *YYMSG_ALLOC to the required number of bytes.  Return 2 if the
-   required number of bytes is too large to store.  */
-static int
-yysyntax_error (YYSIZE_T *yymsg_alloc, char **yymsg,
-                yytype_int16 *yyssp, int yytoken)
-{
-  YYSIZE_T yysize0 = yytnamerr (YY_NULLPTR, yytnameyytoken);
-  YYSIZE_T yysize = yysize0;
-  enum { YYERROR_VERBOSE_ARGS_MAXIMUM = 5 };
-  /* Internationalized format string. */
-  const char *yyformat = YY_NULLPTR;
-  /* Arguments of yyformat. */
-  char const *yyargYYERROR_VERBOSE_ARGS_MAXIMUM;
-  /* Number of reported tokens (one for the "unexpected", one per
-     "expected"). */
-  int yycount = 0;
-
-  /* There are many possibilities here to consider:
-     - If this state is a consistent state with a default action, then
-       the only way this function was invoked is if the default action
-       is an error action.  In that case, don't check for expected
-       tokens because there are none.
-     - The only way there can be no lookahead present (in yychar) is if
-       this state is a consistent state with a default action.  Thus,
-       detecting the absence of a lookahead is sufficient to determine
-       that there is no unexpected or expected token to report.  In that
-       case, just report a simple "syntax error".
-     - Don't assume there isn't a lookahead just because this state is a
-       consistent state with a default action.  There might have been a
-       previous inconsistent state, consistent state with a non-default
-       action, or user semantic action that manipulated yychar.
-     - Of course, the expected token list depends on states to have
-       correct lookahead information, and it depends on the parser not
-       to perform extra reductions after fetching a lookahead from the
-       scanner and before detecting a syntax error.  Thus, state merging
-       (from LALR or IELR) and default reductions corrupt the expected
-       token list.  However, the list is correct for canonical LR with
-       one exception: it will still contain any token that will not be
-       accepted due to an error action in a later state.
-  */
-  if (yytoken != YYEMPTY)
-    {
-      int yyn = yypact*yyssp;
-      yyargyycount++ = yytnameyytoken;
-      if (!yypact_value_is_default (yyn))
-        {
-          /* Start YYX at -YYN if negative to avoid negative indexes in
-             YYCHECK.  In other words, skip the first -YYN actions for
-             this state because they are default actions.  */
-          int yyxbegin = yyn < 0 ? -yyn : 0;
-          /* Stay within bounds of both yycheck and yytname.  */
-          int yychecklim = YYLAST - yyn + 1;
-          int yyxend = yychecklim < YYNTOKENS ? yychecklim : YYNTOKENS;
-          int yyx;
-
-          for (yyx = yyxbegin; yyx < yyxend; ++yyx)
-            if (yycheckyyx + yyn == yyx && yyx != YYTERROR
-                && !yytable_value_is_error (yytableyyx + yyn))
-              {
-                if (yycount == YYERROR_VERBOSE_ARGS_MAXIMUM)
-                  {
-                    yycount = 1;
-                    yysize = yysize0;
-                    break;
-                  }
-                yyargyycount++ = yytnameyyx;
-                {
-                  YYSIZE_T yysize1 = yysize + yytnamerr (YY_NULLPTR, yytnameyyx);
-                  if (! (yysize <= yysize1
-                         && yysize1 <= YYSTACK_ALLOC_MAXIMUM))
-                    return 2;
-                  yysize = yysize1;
-                }
-              }
-        }
-    }
 
-  switch (yycount)
-    {
-# define YYCASE_(N, S)                      \
-      case N:                               \
-        yyformat = S;                       \
-      break
-    default: /* Avoid compiler warnings. */
-      YYCASE_(0, YY_("syntax error"));
-      YYCASE_(1, YY_("syntax error, unexpected %s"));
-      YYCASE_(2, YY_("syntax error, unexpected %s, expecting %s"));
-      YYCASE_(3, YY_("syntax error, unexpected %s, expecting %s or %s"));
-      YYCASE_(4, YY_("syntax error, unexpected %s, expecting %s or %s or %s"));
-      YYCASE_(5, YY_("syntax error, unexpected %s, expecting %s or %s or %s or %s"));
-# undef YYCASE_
-    }
 
-  {
-    YYSIZE_T yysize1 = yysize + yystrlen (yyformat);
-    if (! (yysize <= yysize1 && yysize1 <= YYSTACK_ALLOC_MAXIMUM))
-      return 2;
-    yysize = yysize1;
-  }
 
-  if (*yymsg_alloc < yysize)
-    {
-      *yymsg_alloc = 2 * yysize;
-      if (! (yysize <= *yymsg_alloc
-             && *yymsg_alloc <= YYSTACK_ALLOC_MAXIMUM))
-        *yymsg_alloc = YYSTACK_ALLOC_MAXIMUM;
-      return 1;
-    }
-
-  /* Avoid sprintf, as that infringes on the user's name space.
-     Don't have undefined behavior even if the translation
-     produced a string with the wrong number of "%s"s.  */
-  {
-    char *yyp = *yymsg;
-    int yyi = 0;
-    while ((*yyp = *yyformat) != '\0')
-      if (*yyp == '%' && yyformat1 == 's' && yyi < yycount)
-        {
-          yyp += yytnamerr (yyp, yyargyyi++);
-          yyformat += 2;
-        }
-      else
-        {
-          yyp++;
-          yyformat++;
-        }
-  }
-  return 0;
-}
-#endif /* YYERROR_VERBOSE */
 
 /*-----------------------------------------------.
 | Release the memory associated to this symbol.  |
 `-----------------------------------------------*/
 
 static void
-yydestruct (const char *yymsg, int yytype, YYSTYPE *yyvaluep)
+yydestruct (const char *yymsg,
+            yysymbol_kind_t yykind, YYSTYPE *yyvaluep)
 {
-  YYUSE (yyvaluep);
+  YY_USE (yyvaluep);
   if (!yymsg)
     yymsg = "Deleting";
-  YY_SYMBOL_PRINT (yymsg, yytype, yyvaluep, yylocationp);
+  YY_SYMBOL_PRINT (yymsg, yykind, yyvaluep, yylocationp);
 
   YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN
-  YYUSE (yytype);
+  YY_USE (yykind);
   YY_IGNORE_MAYBE_UNINITIALIZED_END
 }
 
 
-
-
-/* The lookahead symbol.  */
+/* Lookahead token kind.  */
 int yychar;
 
 /* The semantic value of the lookahead symbol.  */
@@ -2009,6 +2085,8 @@
 int yynerrs;
 
 
+
+
 /*----------.
 | yyparse.  |
 `----------*/
@@ -2016,43 +2094,36 @@
 int
 yyparse (void)
 {
-    int yystate;
+    yy_state_fast_t yystate = 0;
     /* Number of tokens to shift before error messages enabled.  */
-    int yyerrstatus;
-
-    /* The stacks and their tools:
-       'yyss': related to states.
-       'yyvs': related to semantic values.
+    int yyerrstatus = 0;
 
-       Refer to the stacks through separate pointers, to allow yyoverflow
+    /* Refer to the stacks through separate pointers, to allow yyoverflow
        to reallocate them elsewhere.  */
 
-    /* The state stack.  */
-    yytype_int16 yyssaYYINITDEPTH;
-    yytype_int16 *yyss;
-    yytype_int16 *yyssp;
+    /* Their size.  */
+    YYPTRDIFF_T yystacksize = YYINITDEPTH;
 
-    /* The semantic value stack.  */
-    YYSTYPE yyvsaYYINITDEPTH;
-    YYSTYPE *yyvs;
-    YYSTYPE *yyvsp;
+    /* The state stack: array, bottom, top.  */
+    yy_state_t yyssaYYINITDEPTH;
+    yy_state_t *yyss = yyssa;
+    yy_state_t *yyssp = yyss;
 
-    YYSIZE_T yystacksize;
+    /* The semantic value stack: array, bottom, top.  */
+    YYSTYPE yyvsaYYINITDEPTH;
+    YYSTYPE *yyvs = yyvsa;
+    YYSTYPE *yyvsp = yyvs;
 
   int yyn;
+  /* The return value of yyparse.  */
   int yyresult;
-  /* Lookahead token as an internal (translated) token number.  */
-  int yytoken = 0;
+  /* Lookahead symbol kind.  */
+  yysymbol_kind_t yytoken = YYSYMBOL_YYEMPTY;
   /* The variables used to return semantic value and location from the
      action routines.  */
   YYSTYPE yyval;
 
-#if YYERROR_VERBOSE
-  /* Buffer for error messages, and its allocated size.  */
-  char yymsgbuf128;
-  char *yymsg = yymsgbuf;
-  YYSIZE_T yymsg_alloc = sizeof yymsgbuf;
-#endif
+
 
 #define YYPOPSTACK(N)   (yyvsp -= (N), yyssp -= (N))
 
@@ -2060,70 +2131,75 @@
      Keep to zero when no symbol should be popped.  */
   int yylen = 0;
 
-  yyssp = yyss = yyssa;
-  yyvsp = yyvs = yyvsa;
-  yystacksize = YYINITDEPTH;
-
   YYDPRINTF ((stderr, "Starting parse\n"));
 
-  yystate = 0;
-  yyerrstatus = 0;
-  yynerrs = 0;
   yychar = YYEMPTY; /* Cause a token to be read.  */
+
   goto yysetstate;
 
+
 /*------------------------------------------------------------.
-| yynewstate -- Push a new state, which is found in yystate.  |
+| yynewstate -- push a new state, which is found in yystate.  |
 `------------------------------------------------------------*/
- yynewstate:
+yynewstate:
   /* In all cases, when you get here, the value and location stacks
      have just been pushed.  So pushing a state here evens the stacks.  */
   yyssp++;
 
- yysetstate:
-  *yyssp = (yytype_int16) yystate;
+
+/*--------------------------------------------------------------------.
+| yysetstate -- set current state (the top of the stack) to yystate.  |
+`--------------------------------------------------------------------*/
+yysetstate:
+  YYDPRINTF ((stderr, "Entering state %d\n", yystate));
+  YY_ASSERT (0 <= yystate && yystate < YYNSTATES);
+  YY_IGNORE_USELESS_CAST_BEGIN
+  *yyssp = YY_CAST (yy_state_t, yystate);
+  YY_IGNORE_USELESS_CAST_END
+  YY_STACK_PRINT (yyss, yyssp);
 
   if (yyss + yystacksize - 1 <= yyssp)
+#if !defined yyoverflow && !defined YYSTACK_RELOCATE
+    YYNOMEM;
+#else
     {
       /* Get the current used size of the three stacks, in elements.  */
-      YYSIZE_T yysize = (YYSIZE_T) (yyssp - yyss + 1);
+      YYPTRDIFF_T yysize = yyssp - yyss + 1;
 
-#ifdef yyoverflow
+# if defined yyoverflow
       {
         /* Give user a chance to reallocate the stack.  Use copies of
            these so that the &'s don't force the real ones into
            memory.  */
+        yy_state_t *yyss1 = yyss;
         YYSTYPE *yyvs1 = yyvs;
-        yytype_int16 *yyss1 = yyss;
 
         /* Each stack pointer address is followed by the size of the
            data in use in that stack, in bytes.  This used to be a
            conditional around just the two extra args, but that might
            be undefined if yyoverflow is a macro.  */
         yyoverflow (YY_("memory exhausted"),
-                    &yyss1, yysize * sizeof (*yyssp),
-                    &yyvs1, yysize * sizeof (*yyvsp),
+                    &yyss1, yysize * YYSIZEOF (*yyssp),
+                    &yyvs1, yysize * YYSIZEOF (*yyvsp),
                     &yystacksize);
         yyss = yyss1;
         yyvs = yyvs1;
       }
-#else /* no yyoverflow */
-# ifndef YYSTACK_RELOCATE
-      goto yyexhaustedlab;
-# else
+# else /* defined YYSTACK_RELOCATE */
       /* Extend the stack our own way.  */
       if (YYMAXDEPTH <= yystacksize)
-        goto yyexhaustedlab;
+        YYNOMEM;
       yystacksize *= 2;
       if (YYMAXDEPTH < yystacksize)
         yystacksize = YYMAXDEPTH;
 
       {
-        yytype_int16 *yyss1 = yyss;
+        yy_state_t *yyss1 = yyss;
         union yyalloc *yyptr =
-          (union yyalloc *) YYSTACK_ALLOC (YYSTACK_BYTES (yystacksize));
+          YY_CAST (union yyalloc *,
+                   YYSTACK_ALLOC (YY_CAST (YYSIZE_T, YYSTACK_BYTES (yystacksize))));
         if (! yyptr)
-          goto yyexhaustedlab;
+          YYNOMEM;
         YYSTACK_RELOCATE (yyss_alloc, yyss);
         YYSTACK_RELOCATE (yyvs_alloc, yyvs);
 #  undef YYSTACK_RELOCATE
@@ -2131,30 +2207,31 @@
           YYSTACK_FREE (yyss1);
       }
 # endif
-#endif /* no yyoverflow */
 
       yyssp = yyss + yysize - 1;
       yyvsp = yyvs + yysize - 1;
 
-      YYDPRINTF ((stderr, "Stack size increased to %lu\n",
-                  (unsigned long) yystacksize));
+      YY_IGNORE_USELESS_CAST_BEGIN
+      YYDPRINTF ((stderr, "Stack size increased to %ld\n",
+                  YY_CAST (long, yystacksize)));
+      YY_IGNORE_USELESS_CAST_END
 
       if (yyss + yystacksize - 1 <= yyssp)
         YYABORT;
     }
+#endif /* !defined yyoverflow && !defined YYSTACK_RELOCATE */
 
-  YYDPRINTF ((stderr, "Entering state %d\n", yystate));
 
   if (yystate == YYFINAL)
     YYACCEPT;
 
   goto yybackup;
 
+
 /*-----------.
 | yybackup.  |
 `-----------*/
 yybackup:
-
   /* Do appropriate processing given the current state.  Read a
      lookahead token if we need one and don't already have one.  */
 
@@ -2165,18 +2242,29 @@
 
   /* Not known => get a lookahead token if don't already have one.  */
 
-  /* YYCHAR is either YYEMPTY or YYEOF or a valid lookahead symbol.  */
+  /* YYCHAR is either empty, or end-of-input, or a valid lookahead.  */
   if (yychar == YYEMPTY)
     {
-      YYDPRINTF ((stderr, "Reading a token: "));
+      YYDPRINTF ((stderr, "Reading a token\n"));
       yychar = yylex ();
     }
 
   if (yychar <= YYEOF)
     {
-      yychar = yytoken = YYEOF;
+      yychar = YYEOF;
+      yytoken = YYSYMBOL_YYEOF;
       YYDPRINTF ((stderr, "Now at end of input.\n"));
     }
+  else if (yychar == YYerror)
+    {
+      /* The scanner already issued an error message, process directly
+         to error recovery.  But do not keep the error token as
+         lookahead, it is too special and may lead us to an endless
+         loop in error recovery. */
+      yychar = YYUNDEF;
+      yytoken = YYSYMBOL_YYerror;
+      goto yyerrlab1;
+    }
   else
     {
       yytoken = YYTRANSLATE (yychar);
@@ -2204,15 +2292,13 @@
 
   /* Shift the lookahead token.  */
   YY_SYMBOL_PRINT ("Shifting", yytoken, &yylval, &yylloc);
-
-  /* Discard the shifted token.  */
-  yychar = YYEMPTY;
-
   yystate = yyn;
   YY_IGNORE_MAYBE_UNINITIALIZED_BEGIN
   *++yyvsp = yylval;
   YY_IGNORE_MAYBE_UNINITIALIZED_END
 
+  /* Discard the shifted token.  */
+  yychar = YYEMPTY;
   goto yynewstate;
 
 
@@ -2227,7 +2313,7 @@
 
 
 /*-----------------------------.
-| yyreduce -- Do a reduction.  |
+| yyreduce -- do a reduction.  |
 `-----------------------------*/
 yyreduce:
   /* yyn is the number of a rule to reduce with.  */
@@ -2247,56 +2333,56 @@
   YY_REDUCE_PRINT (yyn);
   switch (yyn)
     {
-        case 3:
-#line 277 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 3: /* top: element_list  */
+#line 277 "../src/preproc/pic/pic.ypp"
+                {
 		  if (olist.head)
 		    print_picture(olist.head);
 		}
-#line 2257 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2343 "src/preproc/pic/pic.cpp"
     break;
 
-  case 4:
-#line 286 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pl) = (yyvsp-1.pl); }
-#line 2263 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 4: /* element_list: optional_separator middle_element_list optional_separator  */
+#line 286 "../src/preproc/pic/pic.ypp"
+                { (yyval.pl) = (yyvsp-1.pl); }
+#line 2349 "src/preproc/pic/pic.cpp"
     break;
 
-  case 5:
-#line 291 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pl) = (yyvsp0.pl); }
-#line 2269 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 5: /* middle_element_list: element  */
+#line 291 "../src/preproc/pic/pic.ypp"
+                { (yyval.pl) = (yyvsp0.pl); }
+#line 2355 "src/preproc/pic/pic.cpp"
     break;
 
-  case 6:
-#line 293 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pl) = (yyvsp-2.pl); }
-#line 2275 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 6: /* middle_element_list: middle_element_list separator element  */
+#line 293 "../src/preproc/pic/pic.ypp"
+                { (yyval.pl) = (yyvsp-2.pl); }
+#line 2361 "src/preproc/pic/pic.cpp"
     break;
 
-  case 11:
-#line 308 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
-		  a_delete graphname;
+  case 11: /* placeless_element: FIGNAME '=' macro_name  */
+#line 308 "../src/preproc/pic/pic.ypp"
+                {
+		  delete graphname;
 		  graphname = new charstrlen((yyvsp0.str)) + 1;
 		  strcpy(graphname, (yyvsp0.str));
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp0.str);
 		}
-#line 2286 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2372 "src/preproc/pic/pic.cpp"
     break;
 
-  case 12:
-#line 316 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 12: /* placeless_element: VARIABLE '=' any_expr  */
+#line 316 "../src/preproc/pic/pic.ypp"
+                {
 		  define_variable((yyvsp-2.str), (yyvsp0.x));
 		  free((yyvsp-2.str));
 		}
-#line 2295 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2381 "src/preproc/pic/pic.cpp"
     break;
 
-  case 13:
-#line 321 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 13: /* placeless_element: VARIABLE ':' '=' any_expr  */
+#line 321 "../src/preproc/pic/pic.ypp"
+                {
 		  place *p = lookup_label((yyvsp-3.str));
 		  if (!p) {
 		    lex_error("variable '%1' not defined", (yyvsp-3.str));
@@ -2307,178 +2393,183 @@
 		  p->y = 0.0;
 		  free((yyvsp-3.str));
 		}
-#line 2311 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2397 "src/preproc/pic/pic.cpp"
     break;
 
-  case 14:
-#line 333 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { current_direction = UP_DIRECTION; }
-#line 2317 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 14: /* placeless_element: UP  */
+#line 333 "../src/preproc/pic/pic.ypp"
+                { current_direction = UP_DIRECTION; }
+#line 2403 "src/preproc/pic/pic.cpp"
     break;
 
-  case 15:
-#line 335 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { current_direction = DOWN_DIRECTION; }
-#line 2323 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 15: /* placeless_element: DOWN  */
+#line 335 "../src/preproc/pic/pic.ypp"
+                { current_direction = DOWN_DIRECTION; }
+#line 2409 "src/preproc/pic/pic.cpp"
     break;
 
-  case 16:
-#line 337 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { current_direction = LEFT_DIRECTION; }
-#line 2329 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 16: /* placeless_element: LEFT  */
+#line 337 "../src/preproc/pic/pic.ypp"
+                { current_direction = LEFT_DIRECTION; }
+#line 2415 "src/preproc/pic/pic.cpp"
     break;
 
-  case 17:
-#line 339 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { current_direction = RIGHT_DIRECTION; }
-#line 2335 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 17: /* placeless_element: RIGHT  */
+#line 339 "../src/preproc/pic/pic.ypp"
+                { current_direction = RIGHT_DIRECTION; }
+#line 2421 "src/preproc/pic/pic.cpp"
     break;
 
-  case 18:
-#line 341 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 18: /* placeless_element: COMMAND_LINE  */
+#line 341 "../src/preproc/pic/pic.ypp"
+                {
 		  olist.append(make_command_object((yyvsp0.lstr).str, (yyvsp0.lstr).filename,
 						   (yyvsp0.lstr).lineno));
 		}
-#line 2344 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2430 "src/preproc/pic/pic.cpp"
     break;
 
-  case 19:
-#line 346 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 19: /* placeless_element: COMMAND print_args  */
+#line 346 "../src/preproc/pic/pic.ypp"
+                {
 		  olist.append(make_command_object((yyvsp0.lstr).str, (yyvsp0.lstr).filename,
 						   (yyvsp0.lstr).lineno));
 		}
-#line 2353 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2439 "src/preproc/pic/pic.cpp"
     break;
 
-  case 20:
-#line 351 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 20: /* placeless_element: PRINT print_args  */
+#line 351 "../src/preproc/pic/pic.ypp"
+                {
 		  fprintf(stderr, "%s\n", (yyvsp0.lstr).str);
-		  a_delete (yyvsp0.lstr).str;
+		  delete (yyvsp0.lstr).str;
 		  fflush(stderr);
 		}
-#line 2363 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2449 "src/preproc/pic/pic.cpp"
     break;
 
-  case 21:
-#line 357 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 1; }
-#line 2369 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 21: /* $@1: %empty  */
+#line 357 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 1; }
+#line 2455 "src/preproc/pic/pic.cpp"
     break;
 
-  case 22:
-#line 359 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 22: /* placeless_element: SH $@1 DELIMITED  */
+#line 359 "../src/preproc/pic/pic.ypp"
+                {
 		  delim_flag = 0;
 		  if (safer_flag)
-		    lex_error("unsafe to run command '%1'", (yyvsp0.str));
-		  else
-		    system((yyvsp0.str));
-		  a_delete (yyvsp0.str);
+		    lex_error("unsafe to run command '%1'; ignoring",
+			      (yyvsp0.str));
+		  else {
+		    int retval = system((yyvsp0.str));
+		    if (retval < 0)
+		      lex_error("error running command '%1': system()"
+			" returned %2", (yyvsp0.str), retval);
+		  }
+		  delete (yyvsp0.str);
 		}
-#line 2382 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2473 "src/preproc/pic/pic.cpp"
     break;
 
-  case 23:
-#line 368 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 23: /* placeless_element: COPY TEXT  */
+#line 373 "../src/preproc/pic/pic.ypp"
+                {
 		  if (yychar < 0)
 		    do_lookahead();
 		  do_copy((yyvsp0.lstr).str);
 		  // do not delete the filename
 		}
-#line 2393 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2484 "src/preproc/pic/pic.cpp"
     break;
 
-  case 24:
-#line 375 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 2; }
-#line 2399 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 24: /* $@2: %empty  */
+#line 380 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 2; }
+#line 2490 "src/preproc/pic/pic.cpp"
     break;
 
-  case 25:
-#line 377 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 0; }
-#line 2405 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 25: /* $@3: %empty  */
+#line 382 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 0; }
+#line 2496 "src/preproc/pic/pic.cpp"
     break;
 
-  case 26:
-#line 379 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 26: /* placeless_element: COPY TEXT THRU $@2 DELIMITED $@3 until  */
+#line 384 "../src/preproc/pic/pic.ypp"
+                {
 		  if (yychar < 0)
 		    do_lookahead();
 		  copy_file_thru((yyvsp-5.lstr).str, (yyvsp-2.str), (yyvsp0.str));
 		  // do not delete the filename
-		  a_delete (yyvsp-2.str);
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp-2.str);
+		  delete (yyvsp0.str);
 		}
-#line 2418 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2509 "src/preproc/pic/pic.cpp"
     break;
 
-  case 27:
-#line 388 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 2; }
-#line 2424 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 27: /* $@4: %empty  */
+#line 393 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 2; }
+#line 2515 "src/preproc/pic/pic.cpp"
     break;
 
-  case 28:
-#line 390 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 0; }
-#line 2430 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 28: /* $@5: %empty  */
+#line 395 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 0; }
+#line 2521 "src/preproc/pic/pic.cpp"
     break;
 
-  case 29:
-#line 392 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 29: /* placeless_element: COPY THRU $@4 DELIMITED $@5 until  */
+#line 397 "../src/preproc/pic/pic.ypp"
+                {
 		  if (yychar < 0)
 		    do_lookahead();
 		  copy_rest_thru((yyvsp-2.str), (yyvsp0.str));
-		  a_delete (yyvsp-2.str);
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp-2.str);
+		  delete (yyvsp0.str);
 		}
-#line 2442 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2533 "src/preproc/pic/pic.cpp"
     break;
 
-  case 30:
-#line 400 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 1; }
-#line 2448 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 30: /* $@6: %empty  */
+#line 405 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 1; }
+#line 2539 "src/preproc/pic/pic.cpp"
     break;
 
-  case 31:
-#line 402 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 31: /* placeless_element: FOR VARIABLE '=' expr TO expr optional_by DO $@6 DELIMITED  */
+#line 407 "../src/preproc/pic/pic.ypp"
+                {
 		  delim_flag = 0;
 		  if (yychar < 0)
 		    do_lookahead();
 		  do_for((yyvsp-8.str), (yyvsp-6.x), (yyvsp-4.x), (yyvsp-3.by).is_multiplicative, (yyvsp-3.by).val, (yyvsp0.str)); 
 		}
-#line 2459 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2550 "src/preproc/pic/pic.cpp"
     break;
 
-  case 32:
-#line 409 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 32: /* placeless_element: simple_if  */
+#line 414 "../src/preproc/pic/pic.ypp"
+                {
 		  if (yychar < 0)
 		    do_lookahead();
 		  if ((yyvsp0.if_data).x != 0.0)
 		    push_body((yyvsp0.if_data).body);
-		  a_delete (yyvsp0.if_data).body;
+		  delete (yyvsp0.if_data).body;
 		}
-#line 2471 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2562 "src/preproc/pic/pic.cpp"
     break;
 
-  case 33:
-#line 417 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 1; }
-#line 2477 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 33: /* $@7: %empty  */
+#line 422 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 1; }
+#line 2568 "src/preproc/pic/pic.cpp"
     break;
 
-  case 34:
-#line 419 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 34: /* placeless_element: simple_if ELSE $@7 DELIMITED  */
+#line 424 "../src/preproc/pic/pic.ypp"
+                {
 		  delim_flag = 0;
 		  if (yychar < 0)
 		    do_lookahead();
@@ -2489,56 +2580,56 @@
 		  free((yyvsp-3.if_data).body);
 		  free((yyvsp0.str));
 		}
-#line 2493 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2584 "src/preproc/pic/pic.cpp"
     break;
 
-  case 36:
-#line 432 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { define_variable("scale", 1.0); }
-#line 2499 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 36: /* placeless_element: RESET  */
+#line 437 "../src/preproc/pic/pic.ypp"
+                { define_variable("scale", 1.0); }
+#line 2590 "src/preproc/pic/pic.cpp"
     break;
 
-  case 39:
-#line 442 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 39: /* reset_variables: RESET VARIABLE  */
+#line 447 "../src/preproc/pic/pic.ypp"
+                {
 		  reset((yyvsp0.str));
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp0.str);
 		}
-#line 2508 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2599 "src/preproc/pic/pic.cpp"
     break;
 
-  case 40:
-#line 447 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 40: /* reset_variables: reset_variables VARIABLE  */
+#line 452 "../src/preproc/pic/pic.ypp"
+                {
 		  reset((yyvsp0.str));
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp0.str);
 		}
-#line 2517 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2608 "src/preproc/pic/pic.cpp"
     break;
 
-  case 41:
-#line 452 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 41: /* reset_variables: reset_variables ',' VARIABLE  */
+#line 457 "../src/preproc/pic/pic.ypp"
+                {
 		  reset((yyvsp0.str));
-		  a_delete (yyvsp0.str);
+		  delete (yyvsp0.str);
 		}
-#line 2526 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2617 "src/preproc/pic/pic.cpp"
     break;
 
-  case 42:
-#line 460 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.lstr) = (yyvsp0.lstr); }
-#line 2532 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 42: /* print_args: print_arg  */
+#line 465 "../src/preproc/pic/pic.ypp"
+                { (yyval.lstr) = (yyvsp0.lstr); }
+#line 2623 "src/preproc/pic/pic.cpp"
     break;
 
-  case 43:
-#line 462 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 43: /* print_args: print_args print_arg  */
+#line 467 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.lstr).str = new charstrlen((yyvsp-1.lstr).str) + strlen((yyvsp0.lstr).str) + 1;
 		  strcpy((yyval.lstr).str, (yyvsp-1.lstr).str);
 		  strcat((yyval.lstr).str, (yyvsp0.lstr).str);
-		  a_delete (yyvsp-1.lstr).str;
-		  a_delete (yyvsp0.lstr).str;
+		  delete (yyvsp-1.lstr).str;
+		  delete (yyvsp0.lstr).str;
 		  if ((yyvsp-1.lstr).filename) {
 		    (yyval.lstr).filename = (yyvsp-1.lstr).filename;
 		    (yyval.lstr).lineno = (yyvsp-1.lstr).lineno;
@@ -2548,169 +2639,169 @@
 		    (yyval.lstr).lineno = (yyvsp0.lstr).lineno;
 		  }
 		}
-#line 2552 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2643 "src/preproc/pic/pic.cpp"
     break;
 
-  case 44:
-#line 481 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 44: /* print_arg: expr  */
+#line 486 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.lstr).str = new charGDIGITS + 1;
 		  sprintf((yyval.lstr).str, "%g", (yyvsp0.x));
 		  (yyval.lstr).filename = 0;
 		  (yyval.lstr).lineno = 0;
 		}
-#line 2563 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2654 "src/preproc/pic/pic.cpp"
     break;
 
-  case 45:
-#line 488 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.lstr) = (yyvsp0.lstr); }
-#line 2569 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 45: /* print_arg: text  */
+#line 493 "../src/preproc/pic/pic.ypp"
+                { (yyval.lstr) = (yyvsp0.lstr); }
+#line 2660 "src/preproc/pic/pic.cpp"
     break;
 
-  case 46:
-#line 490 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 46: /* print_arg: position  */
+#line 495 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.lstr).str = new charGDIGITS + 2 + GDIGITS + 1;
 		  sprintf((yyval.lstr).str, "%g, %g", (yyvsp0.pair).x, (yyvsp0.pair).y);
 		  (yyval.lstr).filename = 0;
 		  (yyval.lstr).lineno = 0;
 		}
-#line 2580 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2671 "src/preproc/pic/pic.cpp"
     break;
 
-  case 47:
-#line 500 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { delim_flag = 1; }
-#line 2586 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 47: /* $@8: %empty  */
+#line 505 "../src/preproc/pic/pic.ypp"
+                { delim_flag = 1; }
+#line 2677 "src/preproc/pic/pic.cpp"
     break;
 
-  case 48:
-#line 502 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 48: /* simple_if: IF any_expr THEN $@8 DELIMITED  */
+#line 507 "../src/preproc/pic/pic.ypp"
+                {
 		  delim_flag = 0;
 		  (yyval.if_data).x = (yyvsp-3.x);
 		  (yyval.if_data).body = (yyvsp0.str);
 		}
-#line 2596 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2687 "src/preproc/pic/pic.cpp"
     break;
 
-  case 49:
-#line 511 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.str) = 0; }
-#line 2602 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 49: /* until: %empty  */
+#line 516 "../src/preproc/pic/pic.ypp"
+                { (yyval.str) = 0; }
+#line 2693 "src/preproc/pic/pic.cpp"
     break;
 
-  case 50:
-#line 513 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.str) = (yyvsp0.lstr).str; }
-#line 2608 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 50: /* until: UNTIL TEXT  */
+#line 518 "../src/preproc/pic/pic.ypp"
+                { (yyval.str) = (yyvsp0.lstr).str; }
+#line 2699 "src/preproc/pic/pic.cpp"
     break;
 
-  case 51:
-#line 518 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp0.x); }
-#line 2614 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 51: /* any_expr: expr  */
+#line 523 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp0.x); }
+#line 2705 "src/preproc/pic/pic.cpp"
     break;
 
-  case 52:
-#line 520 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp0.x); }
-#line 2620 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 52: /* any_expr: text_expr  */
+#line 525 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp0.x); }
+#line 2711 "src/preproc/pic/pic.cpp"
     break;
 
-  case 53:
-#line 525 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 53: /* text_expr: text EQUALEQUAL text  */
+#line 530 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.x) = strcmp((yyvsp-2.lstr).str, (yyvsp0.lstr).str) == 0;
-		  a_delete (yyvsp-2.lstr).str;
-		  a_delete (yyvsp0.lstr).str;
+		  delete (yyvsp-2.lstr).str;
+		  delete (yyvsp0.lstr).str;
 		}
-#line 2630 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2721 "src/preproc/pic/pic.cpp"
     break;
 
-  case 54:
-#line 531 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 54: /* text_expr: text NOTEQUAL text  */
+#line 536 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.x) = strcmp((yyvsp-2.lstr).str, (yyvsp0.lstr).str) != 0;
-		  a_delete (yyvsp-2.lstr).str;
-		  a_delete (yyvsp0.lstr).str;
+		  delete (yyvsp-2.lstr).str;
+		  delete (yyvsp0.lstr).str;
 		}
-#line 2640 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2731 "src/preproc/pic/pic.cpp"
     break;
 
-  case 55:
-#line 537 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
-#line 2646 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 55: /* text_expr: text_expr ANDAND text_expr  */
+#line 542 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
+#line 2737 "src/preproc/pic/pic.cpp"
     break;
 
-  case 56:
-#line 539 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
-#line 2652 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 56: /* text_expr: text_expr ANDAND expr  */
+#line 544 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
+#line 2743 "src/preproc/pic/pic.cpp"
     break;
 
-  case 57:
-#line 541 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
-#line 2658 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 57: /* text_expr: expr ANDAND text_expr  */
+#line 546 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
+#line 2749 "src/preproc/pic/pic.cpp"
     break;
 
-  case 58:
-#line 543 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
-#line 2664 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 58: /* text_expr: text_expr OROR text_expr  */
+#line 548 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
+#line 2755 "src/preproc/pic/pic.cpp"
     break;
 
-  case 59:
-#line 545 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
-#line 2670 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 59: /* text_expr: text_expr OROR expr  */
+#line 550 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
+#line 2761 "src/preproc/pic/pic.cpp"
     break;
 
-  case 60:
-#line 547 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
-#line 2676 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 60: /* text_expr: expr OROR text_expr  */
+#line 552 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
+#line 2767 "src/preproc/pic/pic.cpp"
     break;
 
-  case 61:
-#line 549 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp0.x) == 0.0); }
-#line 2682 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 61: /* text_expr: '!' text_expr  */
+#line 554 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp0.x) == 0.0); }
+#line 2773 "src/preproc/pic/pic.cpp"
     break;
 
-  case 62:
-#line 555 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 62: /* optional_by: %empty  */
+#line 560 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.by).val = 1.0;
 		  (yyval.by).is_multiplicative = 0;
 		}
-#line 2691 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2782 "src/preproc/pic/pic.cpp"
     break;
 
-  case 63:
-#line 560 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 63: /* optional_by: BY expr  */
+#line 565 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.by).val = (yyvsp0.x);
 		  (yyval.by).is_multiplicative = 0;
 		}
-#line 2700 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2791 "src/preproc/pic/pic.cpp"
     break;
 
-  case 64:
-#line 565 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 64: /* optional_by: BY '*' expr  */
+#line 570 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.by).val = (yyvsp0.x);
 		  (yyval.by).is_multiplicative = 1;
 		}
-#line 2709 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2800 "src/preproc/pic/pic.cpp"
     break;
 
-  case 65:
-#line 573 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 65: /* element: object_spec  */
+#line 578 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl).obj = (yyvsp0.spec)->make_object(&current_position,
 					   &current_direction);
 		  if ((yyval.pl).obj == 0)
@@ -2723,194 +2814,196 @@
 		    (yyval.pl).y = current_position.y;
 		  }
 		}
-#line 2727 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2818 "src/preproc/pic/pic.cpp"
     break;
 
-  case 66:
-#line 587 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 66: /* element: LABEL ':' optional_separator element  */
+#line 592 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl) = (yyvsp0.pl);
 		  define_label((yyvsp-3.str), & (yyval.pl));
 		  free((yyvsp-3.str));
 		}
-#line 2737 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2828 "src/preproc/pic/pic.cpp"
     break;
 
-  case 67:
-#line 593 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 67: /* element: LABEL ':' optional_separator position_not_place  */
+#line 598 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl).obj = 0;
 		  (yyval.pl).x = (yyvsp0.pair).x;
 		  (yyval.pl).y = (yyvsp0.pair).y;
 		  define_label((yyvsp-3.str), & (yyval.pl));
 		  free((yyvsp-3.str));
 		}
-#line 2749 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2840 "src/preproc/pic/pic.cpp"
     break;
 
-  case 68:
-#line 601 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 68: /* element: LABEL ':' optional_separator place  */
+#line 606 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl) = (yyvsp0.pl);
 		  define_label((yyvsp-3.str), & (yyval.pl));
 		  free((yyvsp-3.str));
 		}
-#line 2759 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2850 "src/preproc/pic/pic.cpp"
     break;
 
-  case 69:
-#line 607 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 69: /* @9: %empty  */
+#line 612 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.state).x = current_position.x;
 		  (yyval.state).y = current_position.y;
 		  (yyval.state).dir = current_direction;
 		}
-#line 2769 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2860 "src/preproc/pic/pic.cpp"
     break;
 
-  case 70:
-#line 613 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 70: /* $@10: %empty  */
+#line 618 "../src/preproc/pic/pic.ypp"
+                {
 		  current_position.x = (yyvsp-2.state).x;
 		  current_position.y = (yyvsp-2.state).y;
 		  current_direction = (yyvsp-2.state).dir;
 		}
-#line 2779 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2870 "src/preproc/pic/pic.cpp"
     break;
 
-  case 71:
-#line 619 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 71: /* element: '{' @9 element_list '}' $@10 optional_element  */
+#line 624 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl) = (yyvsp-3.pl);
 		}
-#line 2787 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2878 "src/preproc/pic/pic.cpp"
     break;
 
-  case 72:
-#line 623 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 72: /* element: placeless_element  */
+#line 628 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl).obj = 0;
 		  (yyval.pl).x = current_position.x;
 		  (yyval.pl).y = current_position.y;
 		}
-#line 2797 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2888 "src/preproc/pic/pic.cpp"
     break;
 
-  case 73:
-#line 632 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {}
-#line 2803 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 73: /* optional_element: %empty  */
+#line 637 "../src/preproc/pic/pic.ypp"
+                {}
+#line 2894 "src/preproc/pic/pic.cpp"
     break;
 
-  case 74:
-#line 634 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {}
-#line 2809 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 74: /* optional_element: element  */
+#line 639 "../src/preproc/pic/pic.ypp"
+                {}
+#line 2900 "src/preproc/pic/pic.cpp"
     break;
 
-  case 75:
-#line 639 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.spec) = new object_spec(BOX_OBJECT); }
-#line 2815 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 75: /* object_spec: BOX  */
+#line 644 "../src/preproc/pic/pic.ypp"
+                { (yyval.spec) = new object_spec(BOX_OBJECT); }
+#line 2906 "src/preproc/pic/pic.cpp"
     break;
 
-  case 76:
-#line 641 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.spec) = new object_spec(CIRCLE_OBJECT); }
-#line 2821 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 76: /* object_spec: CIRCLE  */
+#line 646 "../src/preproc/pic/pic.ypp"
+                { (yyval.spec) = new object_spec(CIRCLE_OBJECT); }
+#line 2912 "src/preproc/pic/pic.cpp"
     break;
 
-  case 77:
-#line 643 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.spec) = new object_spec(ELLIPSE_OBJECT); }
-#line 2827 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 77: /* object_spec: ELLIPSE  */
+#line 648 "../src/preproc/pic/pic.ypp"
+                { (yyval.spec) = new object_spec(ELLIPSE_OBJECT); }
+#line 2918 "src/preproc/pic/pic.cpp"
     break;
 
-  case 78:
-#line 645 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 78: /* object_spec: ARC  */
+#line 650 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(ARC_OBJECT);
 		  (yyval.spec)->dir = current_direction;
 		}
-#line 2836 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2927 "src/preproc/pic/pic.cpp"
     break;
 
-  case 79:
-#line 650 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 79: /* object_spec: LINE  */
+#line 655 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(LINE_OBJECT);
 		  lookup_variable("lineht", & (yyval.spec)->segment_height);
 		  lookup_variable("linewid", & (yyval.spec)->segment_width);
 		  (yyval.spec)->dir = current_direction;
 		}
-#line 2847 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2938 "src/preproc/pic/pic.cpp"
     break;
 
-  case 80:
-#line 657 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 80: /* object_spec: ARROW  */
+#line 662 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(ARROW_OBJECT);
 		  lookup_variable("lineht", & (yyval.spec)->segment_height);
 		  lookup_variable("linewid", & (yyval.spec)->segment_width);
 		  (yyval.spec)->dir = current_direction;
 		}
-#line 2858 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2949 "src/preproc/pic/pic.cpp"
     break;
 
-  case 81:
-#line 664 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 81: /* object_spec: MOVE  */
+#line 669 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(MOVE_OBJECT);
 		  lookup_variable("moveht", & (yyval.spec)->segment_height);
 		  lookup_variable("movewid", & (yyval.spec)->segment_width);
 		  (yyval.spec)->dir = current_direction;
 		}
-#line 2869 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2960 "src/preproc/pic/pic.cpp"
     break;
 
-  case 82:
-#line 671 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 82: /* object_spec: SPLINE  */
+#line 676 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(SPLINE_OBJECT);
 		  lookup_variable("lineht", & (yyval.spec)->segment_height);
 		  lookup_variable("linewid", & (yyval.spec)->segment_width);
 		  (yyval.spec)->dir = current_direction;
 		}
-#line 2880 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2971 "src/preproc/pic/pic.cpp"
     break;
 
-  case 83:
-#line 678 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 83: /* object_spec: text  */
+#line 683 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(TEXT_OBJECT);
 		  (yyval.spec)->text = new text_item((yyvsp0.lstr).str, (yyvsp0.lstr).filename, (yyvsp0.lstr).lineno);
 		}
-#line 2889 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2980 "src/preproc/pic/pic.cpp"
     break;
 
-  case 84:
-#line 683 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 84: /* object_spec: PLOT expr  */
+#line 688 "../src/preproc/pic/pic.ypp"
+                {
+		  lex_warning("'plot' is deprecated; use 'sprintf'"
+			      " instead");
 		  (yyval.spec) = new object_spec(TEXT_OBJECT);
 		  (yyval.spec)->text = new text_item(format_number(0, (yyvsp0.x)), 0, -1);
 		}
-#line 2898 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 2991 "src/preproc/pic/pic.cpp"
     break;
 
-  case 85:
-#line 688 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 85: /* object_spec: PLOT expr text  */
+#line 695 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = new object_spec(TEXT_OBJECT);
 		  (yyval.spec)->text = new text_item(format_number((yyvsp0.lstr).str, (yyvsp-1.x)),
 					   (yyvsp0.lstr).filename, (yyvsp0.lstr).lineno);
-		  a_delete (yyvsp0.lstr).str;
+		  delete (yyvsp0.lstr).str;
 		}
-#line 2909 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3002 "src/preproc/pic/pic.cpp"
     break;
 
-  case 86:
-#line 695 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 86: /* @11: %empty  */
+#line 702 "../src/preproc/pic/pic.ypp"
+                {
 		  saved_state *p = new saved_state;
 		  (yyval.pstate) = p;
 		  p->x = current_position.x;
@@ -2924,12 +3017,12 @@
 		  current_saved_state = p;
 		  olist.append(make_mark_object());
 		}
-#line 2928 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3021 "src/preproc/pic/pic.cpp"
     break;
 
-  case 87:
-#line 710 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 87: /* object_spec: '' @11 element_list ''  */
+#line 717 "../src/preproc/pic/pic.ypp"
+                {
 		  current_position.x = (yyvsp-2.pstate)->x;
 		  current_position.y = (yyvsp-2.pstate)->y;
 		  current_direction = (yyvsp-2.pstate)->dir;
@@ -2940,52 +3033,52 @@
 		  current_saved_state = (yyvsp-2.pstate)->prev;
 		  delete (yyvsp-2.pstate);
 		}
-#line 2944 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3037 "src/preproc/pic/pic.cpp"
     break;
 
-  case 88:
-#line 722 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 88: /* object_spec: object_spec HEIGHT expr  */
+#line 729 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->height = (yyvsp0.x);
 		  (yyval.spec)->flags |= HAS_HEIGHT;
 		}
-#line 2954 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3047 "src/preproc/pic/pic.cpp"
     break;
 
-  case 89:
-#line 728 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 89: /* object_spec: object_spec RADIUS expr  */
+#line 735 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->radius = (yyvsp0.x);
 		  (yyval.spec)->flags |= HAS_RADIUS;
 		}
-#line 2964 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3057 "src/preproc/pic/pic.cpp"
     break;
 
-  case 90:
-#line 734 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 90: /* object_spec: object_spec WIDTH expr  */
+#line 741 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->width = (yyvsp0.x);
 		  (yyval.spec)->flags |= HAS_WIDTH;
 		}
-#line 2974 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3067 "src/preproc/pic/pic.cpp"
     break;
 
-  case 91:
-#line 740 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 91: /* object_spec: object_spec DIAMETER expr  */
+#line 747 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->radius = (yyvsp0.x)/2.0;
 		  (yyval.spec)->flags |= HAS_RADIUS;
 		}
-#line 2984 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3077 "src/preproc/pic/pic.cpp"
     break;
 
-  case 92:
-#line 746 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 92: /* object_spec: object_spec expr  */
+#line 753 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  switch ((yyval.spec)->dir) {
@@ -3003,111 +3096,111 @@
 		    break;
 		  }
 		}
-#line 3007 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3100 "src/preproc/pic/pic.cpp"
     break;
 
-  case 93:
-#line 765 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 93: /* object_spec: object_spec UP  */
+#line 772 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->dir = UP_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.y += (yyval.spec)->segment_height;
 		}
-#line 3018 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3111 "src/preproc/pic/pic.cpp"
     break;
 
-  case 94:
-#line 772 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 94: /* object_spec: object_spec UP expr  */
+#line 779 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->dir = UP_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.y += (yyvsp0.x);
 		}
-#line 3029 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3122 "src/preproc/pic/pic.cpp"
     break;
 
-  case 95:
-#line 779 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 95: /* object_spec: object_spec DOWN  */
+#line 786 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->dir = DOWN_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.y -= (yyval.spec)->segment_height;
 		}
-#line 3040 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3133 "src/preproc/pic/pic.cpp"
     break;
 
-  case 96:
-#line 786 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 96: /* object_spec: object_spec DOWN expr  */
+#line 793 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->dir = DOWN_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.y -= (yyvsp0.x);
 		}
-#line 3051 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3144 "src/preproc/pic/pic.cpp"
     break;
 
-  case 97:
-#line 793 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 97: /* object_spec: object_spec RIGHT  */
+#line 800 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->dir = RIGHT_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.x += (yyval.spec)->segment_width;
 		}
-#line 3062 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3155 "src/preproc/pic/pic.cpp"
     break;
 
-  case 98:
-#line 800 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 98: /* object_spec: object_spec RIGHT expr  */
+#line 807 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->dir = RIGHT_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.x += (yyvsp0.x);
 		}
-#line 3073 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3166 "src/preproc/pic/pic.cpp"
     break;
 
-  case 99:
-#line 807 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 99: /* object_spec: object_spec LEFT  */
+#line 814 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->dir = LEFT_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.x -= (yyval.spec)->segment_width;
 		}
-#line 3084 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3177 "src/preproc/pic/pic.cpp"
     break;
 
-  case 100:
-#line 814 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 100: /* object_spec: object_spec LEFT expr  */
+#line 821 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->dir = LEFT_DIRECTION;
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.x -= (yyvsp0.x);
 		}
-#line 3095 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3188 "src/preproc/pic/pic.cpp"
     break;
 
-  case 101:
-#line 821 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 101: /* object_spec: object_spec FROM position  */
+#line 828 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_FROM;
 		  (yyval.spec)->from.x = (yyvsp0.pair).x;
 		  (yyval.spec)->from.y = (yyvsp0.pair).y;
 		}
-#line 3106 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3199 "src/preproc/pic/pic.cpp"
     break;
 
-  case 102:
-#line 828 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 102: /* object_spec: object_spec TO position  */
+#line 835 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  if ((yyval.spec)->flags & HAS_SEGMENT)
 		    (yyval.spec)->segment_list = new segment((yyval.spec)->segment_pos,
@@ -3121,12 +3214,12 @@
 		  (yyval.spec)->to.x = (yyvsp0.pair).x;
 		  (yyval.spec)->to.y = (yyvsp0.pair).y;
 		}
-#line 3125 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3218 "src/preproc/pic/pic.cpp"
     break;
 
-  case 103:
-#line 843 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 103: /* object_spec: object_spec AT position  */
+#line 850 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_AT;
 		  (yyval.spec)->at.x = (yyvsp0.pair).x;
@@ -3137,22 +3230,22 @@
 		    (yyval.spec)->from.y = (yyvsp0.pair).y;
 		  }
 		}
-#line 3141 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3234 "src/preproc/pic/pic.cpp"
     break;
 
-  case 104:
-#line 855 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 104: /* object_spec: object_spec WITH path  */
+#line 862 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_WITH;
 		  (yyval.spec)->with = (yyvsp0.pth);
 		}
-#line 3151 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3244 "src/preproc/pic/pic.cpp"
     break;
 
-  case 105:
-#line 861 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 105: /* object_spec: object_spec WITH position  */
+#line 868 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_WITH;
 		  position pos;
@@ -3160,23 +3253,23 @@
 		  pos.y = (yyvsp0.pair).y;
 		  (yyval.spec)->with = new path(pos);
 		}
-#line 3164 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3257 "src/preproc/pic/pic.cpp"
     break;
 
-  case 106:
-#line 870 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 106: /* object_spec: object_spec BY expr_pair  */
+#line 877 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_SEGMENT;
 		  (yyval.spec)->segment_pos.x += (yyvsp0.pair).x;
 		  (yyval.spec)->segment_pos.y += (yyvsp0.pair).y;
 		}
-#line 3175 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3268 "src/preproc/pic/pic.cpp"
     break;
 
-  case 107:
-#line 877 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 107: /* object_spec: object_spec THEN  */
+#line 884 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  if (!((yyval.spec)->flags & HAS_SEGMENT))
 		    switch ((yyval.spec)->dir) {
@@ -3200,110 +3293,110 @@
 		  (yyval.spec)->segment_pos.x = (yyval.spec)->segment_pos.y = 0.0;
 		  (yyval.spec)->segment_is_absolute = 0;
 		}
-#line 3204 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3297 "src/preproc/pic/pic.cpp"
     break;
 
-  case 108:
-#line 902 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 108: /* object_spec: object_spec SOLID  */
+#line 909 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);	// nothing
 		}
-#line 3212 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3305 "src/preproc/pic/pic.cpp"
     break;
 
-  case 109:
-#line 906 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 109: /* object_spec: object_spec DOTTED  */
+#line 913 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_DOTTED;
 		  lookup_variable("dashwid", & (yyval.spec)->dash_width);
 		}
-#line 3222 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3315 "src/preproc/pic/pic.cpp"
     break;
 
-  case 110:
-#line 912 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 110: /* object_spec: object_spec DOTTED expr  */
+#line 919 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_DOTTED;
 		  (yyval.spec)->dash_width = (yyvsp0.x);
 		}
-#line 3232 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3325 "src/preproc/pic/pic.cpp"
     break;
 
-  case 111:
-#line 918 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 111: /* object_spec: object_spec DASHED  */
+#line 925 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_DASHED;
 		  lookup_variable("dashwid", & (yyval.spec)->dash_width);
 		}
-#line 3242 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3335 "src/preproc/pic/pic.cpp"
     break;
 
-  case 112:
-#line 924 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 112: /* object_spec: object_spec DASHED expr  */
+#line 931 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_DASHED;
 		  (yyval.spec)->dash_width = (yyvsp0.x);
 		}
-#line 3252 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3345 "src/preproc/pic/pic.cpp"
     break;
 
-  case 113:
-#line 930 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 113: /* object_spec: object_spec FILL  */
+#line 937 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_DEFAULT_FILLED;
 		}
-#line 3261 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3354 "src/preproc/pic/pic.cpp"
     break;
 
-  case 114:
-#line 935 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 114: /* object_spec: object_spec FILL expr  */
+#line 942 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_FILLED;
 		  (yyval.spec)->fill = (yyvsp0.x);
 		}
-#line 3271 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3364 "src/preproc/pic/pic.cpp"
     break;
 
-  case 115:
-#line 941 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 115: /* object_spec: object_spec XSLANTED expr  */
+#line 948 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_XSLANTED;
 		  (yyval.spec)->xslanted = (yyvsp0.x);
 		}
-#line 3281 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3374 "src/preproc/pic/pic.cpp"
     break;
 
-  case 116:
-#line 947 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 116: /* object_spec: object_spec YSLANTED expr  */
+#line 954 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_YSLANTED;
 		  (yyval.spec)->yslanted = (yyvsp0.x);
 		}
-#line 3291 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3384 "src/preproc/pic/pic.cpp"
     break;
 
-  case 117:
-#line 953 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 117: /* object_spec: object_spec SHADED text  */
+#line 960 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= (IS_SHADED | IS_FILLED);
 		  (yyval.spec)->shaded = new charstrlen((yyvsp0.lstr).str)+1;
 		  strcpy((yyval.spec)->shaded, (yyvsp0.lstr).str);
 		}
-#line 3302 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3395 "src/preproc/pic/pic.cpp"
     break;
 
-  case 118:
-#line 960 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 118: /* object_spec: object_spec COLORED text  */
+#line 967 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= (IS_SHADED | IS_OUTLINED | IS_FILLED);
 		  (yyval.spec)->shaded = new charstrlen((yyvsp0.lstr).str)+1;
@@ -3311,23 +3404,23 @@
 		  (yyval.spec)->outlined = new charstrlen((yyvsp0.lstr).str)+1;
 		  strcpy((yyval.spec)->outlined, (yyvsp0.lstr).str);
 		}
-#line 3315 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3408 "src/preproc/pic/pic.cpp"
     break;
 
-  case 119:
-#line 969 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 119: /* object_spec: object_spec OUTLINED text  */
+#line 976 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= IS_OUTLINED;
 		  (yyval.spec)->outlined = new charstrlen((yyvsp0.lstr).str)+1;
 		  strcpy((yyval.spec)->outlined, (yyvsp0.lstr).str);
 		}
-#line 3326 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3419 "src/preproc/pic/pic.cpp"
     break;
 
-  case 120:
-#line 976 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 120: /* object_spec: object_spec CHOP  */
+#line 983 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  // line chop chop means line chop 0 chop 0
 		  if ((yyval.spec)->flags & IS_DEFAULT_CHOPPED) {
@@ -3342,12 +3435,12 @@
 		    (yyval.spec)->flags |= IS_DEFAULT_CHOPPED;
 		  }
 		}
-#line 3346 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3439 "src/preproc/pic/pic.cpp"
     break;
 
-  case 121:
-#line 992 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 121: /* object_spec: object_spec CHOP expr  */
+#line 999 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  if ((yyval.spec)->flags & IS_DEFAULT_CHOPPED) {
 		    (yyval.spec)->flags |= IS_CHOPPED;
@@ -3363,87 +3456,87 @@
 		    (yyval.spec)->flags |= IS_CHOPPED;
 		  }
 		}
-#line 3367 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3460 "src/preproc/pic/pic.cpp"
     break;
 
-  case 122:
-#line 1009 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 122: /* object_spec: object_spec SAME  */
+#line 1016 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_SAME;
 		}
-#line 3376 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3469 "src/preproc/pic/pic.cpp"
     break;
 
-  case 123:
-#line 1014 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 123: /* object_spec: object_spec INVISIBLE  */
+#line 1021 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_INVISIBLE;
 		}
-#line 3385 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3478 "src/preproc/pic/pic.cpp"
     break;
 
-  case 124:
-#line 1019 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 124: /* object_spec: object_spec LEFT_ARROW_HEAD  */
+#line 1026 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= HAS_LEFT_ARROW_HEAD;
 		}
-#line 3394 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3487 "src/preproc/pic/pic.cpp"
     break;
 
-  case 125:
-#line 1024 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 125: /* object_spec: object_spec RIGHT_ARROW_HEAD  */
+#line 1031 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= HAS_RIGHT_ARROW_HEAD;
 		}
-#line 3403 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3496 "src/preproc/pic/pic.cpp"
     break;
 
-  case 126:
-#line 1029 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 126: /* object_spec: object_spec DOUBLE_ARROW_HEAD  */
+#line 1036 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= (HAS_LEFT_ARROW_HEAD|HAS_RIGHT_ARROW_HEAD);
 		}
-#line 3412 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3505 "src/preproc/pic/pic.cpp"
     break;
 
-  case 127:
-#line 1034 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 127: /* object_spec: object_spec CW  */
+#line 1041 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_CLOCKWISE;
 		}
-#line 3421 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3514 "src/preproc/pic/pic.cpp"
     break;
 
-  case 128:
-#line 1039 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 128: /* object_spec: object_spec CCW  */
+#line 1046 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags &= ~IS_CLOCKWISE;
 		}
-#line 3430 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3523 "src/preproc/pic/pic.cpp"
     break;
 
-  case 129:
-#line 1044 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 129: /* object_spec: object_spec text  */
+#line 1051 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  text_item **p;
 		  for (p = & (yyval.spec)->text; *p; p = &(*p)->next)
 		    ;
 		  *p = new text_item((yyvsp0.lstr).str, (yyvsp0.lstr).filename, (yyvsp0.lstr).lineno);
 		}
-#line 3442 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3535 "src/preproc/pic/pic.cpp"
     break;
 
-  case 130:
-#line 1052 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 130: /* object_spec: object_spec LJUST  */
+#line 1059 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  if ((yyval.spec)->text) {
 		    text_item *p;
@@ -3452,12 +3545,12 @@
 		    p->adj.h = LEFT_ADJUST;
 		  }
 		}
-#line 3456 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3549 "src/preproc/pic/pic.cpp"
     break;
 
-  case 131:
-#line 1062 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 131: /* object_spec: object_spec RJUST  */
+#line 1069 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  if ((yyval.spec)->text) {
 		    text_item *p;
@@ -3466,12 +3559,12 @@
 		    p->adj.h = RIGHT_ADJUST;
 		  }
 		}
-#line 3470 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3563 "src/preproc/pic/pic.cpp"
     break;
 
-  case 132:
-#line 1072 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 132: /* object_spec: object_spec ABOVE  */
+#line 1079 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  if ((yyval.spec)->text) {
 		    text_item *p;
@@ -3480,12 +3573,12 @@
 		    p->adj.v = ABOVE_ADJUST;
 		  }
 		}
-#line 3484 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3577 "src/preproc/pic/pic.cpp"
     break;
 
-  case 133:
-#line 1082 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 133: /* object_spec: object_spec BELOW  */
+#line 1089 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  if ((yyval.spec)->text) {
 		    text_item *p;
@@ -3494,59 +3587,59 @@
 		    p->adj.v = BELOW_ADJUST;
 		  }
 		}
-#line 3498 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3591 "src/preproc/pic/pic.cpp"
     break;
 
-  case 134:
-#line 1092 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 134: /* object_spec: object_spec THICKNESS expr  */
+#line 1099 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-2.spec);
 		  (yyval.spec)->flags |= HAS_THICKNESS;
 		  (yyval.spec)->thickness = (yyvsp0.x);
 		}
-#line 3508 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3601 "src/preproc/pic/pic.cpp"
     break;
 
-  case 135:
-#line 1098 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 135: /* object_spec: object_spec ALIGNED  */
+#line 1105 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.spec) = (yyvsp-1.spec);
 		  (yyval.spec)->flags |= IS_ALIGNED;
 		}
-#line 3517 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3610 "src/preproc/pic/pic.cpp"
     break;
 
-  case 136:
-#line 1106 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.lstr) = (yyvsp0.lstr); }
-#line 3523 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 136: /* text: TEXT  */
+#line 1113 "../src/preproc/pic/pic.ypp"
+                { (yyval.lstr) = (yyvsp0.lstr); }
+#line 3616 "src/preproc/pic/pic.cpp"
     break;
 
-  case 137:
-#line 1108 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 137: /* text: SPRINTF '(' TEXT sprintf_args ')'  */
+#line 1115 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.lstr).filename = (yyvsp-2.lstr).filename;
 		  (yyval.lstr).lineno = (yyvsp-2.lstr).lineno;
 		  (yyval.lstr).str = do_sprintf((yyvsp-2.lstr).str, (yyvsp-1.dv).v, (yyvsp-1.dv).nv);
-		  a_delete (yyvsp-1.dv).v;
+		  delete (yyvsp-1.dv).v;
 		  free((yyvsp-2.lstr).str);
 		}
-#line 3535 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3628 "src/preproc/pic/pic.cpp"
     break;
 
-  case 138:
-#line 1119 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 138: /* sprintf_args: %empty  */
+#line 1126 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.dv).v = 0;
 		  (yyval.dv).nv = 0;
 		  (yyval.dv).maxv = 0;
 		}
-#line 3545 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3638 "src/preproc/pic/pic.cpp"
     break;
 
-  case 139:
-#line 1125 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 139: /* sprintf_args: sprintf_args ',' expr  */
+#line 1132 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.dv) = (yyvsp-2.dv);
 		  if ((yyval.dv).nv >= (yyval.dv).maxv) {
 		    if ((yyval.dv).nv == 0) {
@@ -3566,192 +3659,192 @@
 		      memcpy(foo, oldv, (yyval.dv).nv*sizeof(double));
 		      (yyval.dv).v = foo;
 #endif
-		      a_delete oldv;
+		      delete oldv;
 		    }
 		  }
 		  (yyval.dv).v(yyval.dv).nv = (yyvsp0.x);
 		  (yyval.dv).nv += 1;
 		}
-#line 3576 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3669 "src/preproc/pic/pic.cpp"
     break;
 
-  case 140:
-#line 1155 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pair) = (yyvsp0.pair); }
-#line 3582 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 140: /* position: position_not_place  */
+#line 1162 "../src/preproc/pic/pic.ypp"
+                { (yyval.pair) = (yyvsp0.pair); }
+#line 3675 "src/preproc/pic/pic.cpp"
     break;
 
-  case 141:
-#line 1157 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 141: /* position: place  */
+#line 1164 "../src/preproc/pic/pic.ypp"
+                {
 		  position pos = (yyvsp0.pl);
 		  (yyval.pair).x = pos.x;
 		  (yyval.pair).y = pos.y;
 		}
-#line 3592 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3685 "src/preproc/pic/pic.cpp"
     break;
 
-  case 142:
-#line 1163 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 142: /* position: '(' place ')'  */
+#line 1170 "../src/preproc/pic/pic.ypp"
+                {
 		  position pos = (yyvsp-1.pl);
 		  (yyval.pair).x = pos.x;
 		  (yyval.pair).y = pos.y;
 		}
-#line 3602 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3695 "src/preproc/pic/pic.cpp"
     break;
 
-  case 143:
-#line 1172 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pair) = (yyvsp0.pair); }
-#line 3608 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 143: /* position_not_place: expr_pair  */
+#line 1179 "../src/preproc/pic/pic.ypp"
+                { (yyval.pair) = (yyvsp0.pair); }
+#line 3701 "src/preproc/pic/pic.cpp"
     break;
 
-  case 144:
-#line 1174 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 144: /* position_not_place: position '+' expr_pair  */
+#line 1181 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-2.pair).x + (yyvsp0.pair).x;
 		  (yyval.pair).y = (yyvsp-2.pair).y + (yyvsp0.pair).y;
 		}
-#line 3617 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3710 "src/preproc/pic/pic.cpp"
     break;
 
-  case 145:
-#line 1179 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 145: /* position_not_place: '(' position '+' expr_pair ')'  */
+#line 1186 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-3.pair).x + (yyvsp-1.pair).x;
 		  (yyval.pair).y = (yyvsp-3.pair).y + (yyvsp-1.pair).y;
 		}
-#line 3626 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3719 "src/preproc/pic/pic.cpp"
     break;
 
-  case 146:
-#line 1184 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 146: /* position_not_place: position '-' expr_pair  */
+#line 1191 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-2.pair).x - (yyvsp0.pair).x;
 		  (yyval.pair).y = (yyvsp-2.pair).y - (yyvsp0.pair).y;
 		}
-#line 3635 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3728 "src/preproc/pic/pic.cpp"
     break;
 
-  case 147:
-#line 1189 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 147: /* position_not_place: '(' position '-' expr_pair ')'  */
+#line 1196 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-3.pair).x - (yyvsp-1.pair).x;
 		  (yyval.pair).y = (yyvsp-3.pair).y - (yyvsp-1.pair).y;
 		}
-#line 3644 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3737 "src/preproc/pic/pic.cpp"
     break;
 
-  case 148:
-#line 1194 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 148: /* position_not_place: '(' position ',' position ')'  */
+#line 1201 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-3.pair).x;
 		  (yyval.pair).y = (yyvsp-1.pair).y;
 		}
-#line 3653 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3746 "src/preproc/pic/pic.cpp"
     break;
 
-  case 149:
-#line 1199 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 149: /* position_not_place: expr between position AND position  */
+#line 1206 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (1.0 - (yyvsp-4.x))*(yyvsp-2.pair).x + (yyvsp-4.x)*(yyvsp0.pair).x;
 		  (yyval.pair).y = (1.0 - (yyvsp-4.x))*(yyvsp-2.pair).y + (yyvsp-4.x)*(yyvsp0.pair).y;
 		}
-#line 3662 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3755 "src/preproc/pic/pic.cpp"
     break;
 
-  case 150:
-#line 1204 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 150: /* position_not_place: '(' expr between position AND position ')'  */
+#line 1211 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (1.0 - (yyvsp-5.x))*(yyvsp-3.pair).x + (yyvsp-5.x)*(yyvsp-1.pair).x;
 		  (yyval.pair).y = (1.0 - (yyvsp-5.x))*(yyvsp-3.pair).y + (yyvsp-5.x)*(yyvsp-1.pair).y;
 		}
-#line 3671 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3764 "src/preproc/pic/pic.cpp"
     break;
 
-  case 151:
-#line 1210 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 151: /* position_not_place: expr_not_lower_than '<' position ',' position '>'  */
+#line 1217 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (1.0 - (yyvsp-5.x))*(yyvsp-3.pair).x + (yyvsp-5.x)*(yyvsp-1.pair).x;
 		  (yyval.pair).y = (1.0 - (yyvsp-5.x))*(yyvsp-3.pair).y + (yyvsp-5.x)*(yyvsp-1.pair).y;
 		}
-#line 3680 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3773 "src/preproc/pic/pic.cpp"
     break;
 
-  case 152:
-#line 1215 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 152: /* position_not_place: '(' expr_not_lower_than '<' position ',' position '>' ')'  */
+#line 1222 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (1.0 - (yyvsp-6.x))*(yyvsp-4.pair).x + (yyvsp-6.x)*(yyvsp-2.pair).x;
 		  (yyval.pair).y = (1.0 - (yyvsp-6.x))*(yyvsp-4.pair).y + (yyvsp-6.x)*(yyvsp-2.pair).y;
 		}
-#line 3689 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3782 "src/preproc/pic/pic.cpp"
     break;
 
-  case 155:
-#line 1228 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 155: /* expr_pair: expr ',' expr  */
+#line 1235 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pair).x = (yyvsp-2.x);
 		  (yyval.pair).y = (yyvsp0.x);
 		}
-#line 3698 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3791 "src/preproc/pic/pic.cpp"
     break;
 
-  case 156:
-#line 1233 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pair) = (yyvsp-1.pair); }
-#line 3704 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 156: /* expr_pair: '(' expr_pair ')'  */
+#line 1240 "../src/preproc/pic/pic.ypp"
+                { (yyval.pair) = (yyvsp-1.pair); }
+#line 3797 "src/preproc/pic/pic.cpp"
     break;
 
-  case 157:
-#line 1239 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pl) = (yyvsp0.pl); }
-#line 3710 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 157: /* place: label  */
+#line 1246 "../src/preproc/pic/pic.ypp"
+                { (yyval.pl) = (yyvsp0.pl); }
+#line 3803 "src/preproc/pic/pic.cpp"
     break;
 
-  case 158:
-#line 1241 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 158: /* place: label corner  */
+#line 1248 "../src/preproc/pic/pic.ypp"
+                {
 		  path pth((yyvsp0.crn));
 		  if (!pth.follow((yyvsp-1.pl), & (yyval.pl)))
 		    YYABORT;
 		}
-#line 3720 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3813 "src/preproc/pic/pic.cpp"
     break;
 
-  case 159:
-#line 1247 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 159: /* place: corner label  */
+#line 1254 "../src/preproc/pic/pic.ypp"
+                {
 		  path pth((yyvsp-1.crn));
 		  if (!pth.follow((yyvsp0.pl), & (yyval.pl)))
 		    YYABORT;
 		}
-#line 3730 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3823 "src/preproc/pic/pic.cpp"
     break;
 
-  case 160:
-#line 1253 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 160: /* place: corner OF label  */
+#line 1260 "../src/preproc/pic/pic.ypp"
+                {
 		  path pth((yyvsp-2.crn));
 		  if (!pth.follow((yyvsp0.pl), & (yyval.pl)))
 		    YYABORT;
 		}
-#line 3740 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3833 "src/preproc/pic/pic.cpp"
     break;
 
-  case 161:
-#line 1259 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 161: /* place: HERE  */
+#line 1266 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pl).x = current_position.x;
 		  (yyval.pl).y = current_position.y;
 		  (yyval.pl).obj = 0;
 		}
-#line 3750 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3843 "src/preproc/pic/pic.cpp"
     break;
 
-  case 162:
-#line 1268 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 162: /* label: LABEL  */
+#line 1275 "../src/preproc/pic/pic.ypp"
+                {
 		  place *p = lookup_label((yyvsp0.str));
 		  if (!p) {
 		    lex_error("there is no place '%1'", (yyvsp0.str));
@@ -3760,55 +3853,55 @@
 		  (yyval.pl) = *p;
 		  free((yyvsp0.str));
 		}
-#line 3764 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3857 "src/preproc/pic/pic.cpp"
     break;
 
-  case 163:
-#line 1278 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pl).obj = (yyvsp0.obj); }
-#line 3770 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 163: /* label: nth_primitive  */
+#line 1285 "../src/preproc/pic/pic.ypp"
+                { (yyval.pl).obj = (yyvsp0.obj); }
+#line 3863 "src/preproc/pic/pic.cpp"
     break;
 
-  case 164:
-#line 1280 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 164: /* label: label '.' LABEL  */
+#line 1287 "../src/preproc/pic/pic.ypp"
+                {
 		  path pth((yyvsp0.str));
 		  if (!pth.follow((yyvsp-2.pl), & (yyval.pl)))
 		    YYABORT;
 		}
-#line 3780 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3873 "src/preproc/pic/pic.cpp"
     break;
 
-  case 165:
-#line 1289 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.n) = (yyvsp0.n); }
-#line 3786 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 165: /* ordinal: ORDINAL  */
+#line 1296 "../src/preproc/pic/pic.ypp"
+                { (yyval.n) = (yyvsp0.n); }
+#line 3879 "src/preproc/pic/pic.cpp"
     break;
 
-  case 166:
-#line 1291 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 166: /* ordinal: '`' any_expr TH  */
+#line 1298 "../src/preproc/pic/pic.ypp"
+                {
 		  // XXX Check for overflow (and non-integers?).
 		  (yyval.n) = (int)(yyvsp-1.x);
 		}
-#line 3795 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3888 "src/preproc/pic/pic.cpp"
     break;
 
-  case 167:
-#line 1299 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.n) = 1; }
-#line 3801 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 167: /* optional_ordinal_last: LAST  */
+#line 1306 "../src/preproc/pic/pic.ypp"
+                { (yyval.n) = 1; }
+#line 3894 "src/preproc/pic/pic.cpp"
     break;
 
-  case 168:
-#line 1301 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.n) = (yyvsp-1.n); }
-#line 3807 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 168: /* optional_ordinal_last: ordinal LAST  */
+#line 1308 "../src/preproc/pic/pic.ypp"
+                { (yyval.n) = (yyvsp-1.n); }
+#line 3900 "src/preproc/pic/pic.cpp"
     break;
 
-  case 169:
-#line 1306 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 169: /* nth_primitive: ordinal object_type  */
+#line 1313 "../src/preproc/pic/pic.ypp"
+                {
 		  int count = 0;
 		  object *p;
 		  for (p = olist.head; p != 0; p = p->next)
@@ -3822,12 +3915,12 @@
 		    YYABORT;
 		  }
 		}
-#line 3826 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3919 "src/preproc/pic/pic.cpp"
     break;
 
-  case 170:
-#line 1321 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 170: /* nth_primitive: optional_ordinal_last object_type  */
+#line 1328 "../src/preproc/pic/pic.ypp"
+                {
 		  int count = 0;
 		  object *p;
 		  for (p = olist.tail; p != 0; p = p->prev)
@@ -3841,482 +3934,482 @@
 		    YYABORT;
 		  }
 		}
-#line 3845 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 3938 "src/preproc/pic/pic.cpp"
     break;
 
-  case 171:
-#line 1339 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = BOX_OBJECT; }
-#line 3851 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 171: /* object_type: BOX  */
+#line 1346 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = BOX_OBJECT; }
+#line 3944 "src/preproc/pic/pic.cpp"
     break;
 
-  case 172:
-#line 1341 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = CIRCLE_OBJECT; }
-#line 3857 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 172: /* object_type: CIRCLE  */
+#line 1348 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = CIRCLE_OBJECT; }
+#line 3950 "src/preproc/pic/pic.cpp"
     break;
 
-  case 173:
-#line 1343 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = ELLIPSE_OBJECT; }
-#line 3863 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 173: /* object_type: ELLIPSE  */
+#line 1350 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = ELLIPSE_OBJECT; }
+#line 3956 "src/preproc/pic/pic.cpp"
     break;
 
-  case 174:
-#line 1345 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = ARC_OBJECT; }
-#line 3869 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 174: /* object_type: ARC  */
+#line 1352 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = ARC_OBJECT; }
+#line 3962 "src/preproc/pic/pic.cpp"
     break;
 
-  case 175:
-#line 1347 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = LINE_OBJECT; }
-#line 3875 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 175: /* object_type: LINE  */
+#line 1354 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = LINE_OBJECT; }
+#line 3968 "src/preproc/pic/pic.cpp"
     break;
 
-  case 176:
-#line 1349 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = ARROW_OBJECT; }
-#line 3881 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 176: /* object_type: ARROW  */
+#line 1356 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = ARROW_OBJECT; }
+#line 3974 "src/preproc/pic/pic.cpp"
     break;
 
-  case 177:
-#line 1351 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = SPLINE_OBJECT; }
-#line 3887 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 177: /* object_type: SPLINE  */
+#line 1358 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = SPLINE_OBJECT; }
+#line 3980 "src/preproc/pic/pic.cpp"
     break;
 
-  case 178:
-#line 1353 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = BLOCK_OBJECT; }
-#line 3893 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 178: /* object_type: '' ''  */
+#line 1360 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = BLOCK_OBJECT; }
+#line 3986 "src/preproc/pic/pic.cpp"
     break;
 
-  case 179:
-#line 1355 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.obtype) = TEXT_OBJECT; }
-#line 3899 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 179: /* object_type: TEXT  */
+#line 1362 "../src/preproc/pic/pic.ypp"
+                { (yyval.obtype) = TEXT_OBJECT; }
+#line 3992 "src/preproc/pic/pic.cpp"
     break;
 
-  case 180:
-#line 1360 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pth) = new path((yyvsp0.str)); }
-#line 3905 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 180: /* label_path: '.' LABEL  */
+#line 1367 "../src/preproc/pic/pic.ypp"
+                { (yyval.pth) = new path((yyvsp0.str)); }
+#line 3998 "src/preproc/pic/pic.cpp"
     break;
 
-  case 181:
-#line 1362 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 181: /* label_path: label_path '.' LABEL  */
+#line 1369 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pth) = (yyvsp-2.pth);
 		  (yyval.pth)->append((yyvsp0.str));
 		}
-#line 3914 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4007 "src/preproc/pic/pic.cpp"
     break;
 
-  case 182:
-#line 1370 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pth) = new path((yyvsp0.crn)); }
-#line 3920 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 182: /* relative_path: corner  */
+#line 1377 "../src/preproc/pic/pic.ypp"
+                { (yyval.pth) = new path((yyvsp0.crn)); }
+#line 4013 "src/preproc/pic/pic.cpp"
     break;
 
-  case 183:
-#line 1374 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pth) = (yyvsp0.pth); }
-#line 3926 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 183: /* relative_path: label_path  */
+#line 1381 "../src/preproc/pic/pic.ypp"
+                { (yyval.pth) = (yyvsp0.pth); }
+#line 4019 "src/preproc/pic/pic.cpp"
     break;
 
-  case 184:
-#line 1376 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 184: /* relative_path: label_path corner  */
+#line 1383 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pth) = (yyvsp-1.pth);
 		  (yyval.pth)->append((yyvsp0.crn));
 		}
-#line 3935 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4028 "src/preproc/pic/pic.cpp"
     break;
 
-  case 185:
-#line 1384 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.pth) = (yyvsp0.pth); }
-#line 3941 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 185: /* path: relative_path  */
+#line 1391 "../src/preproc/pic/pic.ypp"
+                { (yyval.pth) = (yyvsp0.pth); }
+#line 4034 "src/preproc/pic/pic.cpp"
     break;
 
-  case 186:
-#line 1386 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 186: /* path: '(' relative_path ',' relative_path ')'  */
+#line 1393 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.pth) = (yyvsp-3.pth);
 		  (yyval.pth)->set_ypath((yyvsp-1.pth));
 		}
-#line 3950 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4043 "src/preproc/pic/pic.cpp"
     break;
 
-  case 187:
-#line 1392 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 187: /* path: ORDINAL LAST object_type relative_path  */
+#line 1399 "../src/preproc/pic/pic.ypp"
+                {
 		  lex_warning("'%1%2 last %3' in 'with' argument ignored",
 			      (yyvsp-3.n), ordinal_postfix((yyvsp-3.n)), object_type_name((yyvsp-1.obtype)));
 		  (yyval.pth) = (yyvsp0.pth);
 		}
-#line 3960 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4053 "src/preproc/pic/pic.cpp"
     break;
 
-  case 188:
-#line 1398 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 188: /* path: LAST object_type relative_path  */
+#line 1405 "../src/preproc/pic/pic.ypp"
+                {
 		  lex_warning("'last %1' in 'with' argument ignored",
 			      object_type_name((yyvsp-1.obtype)));
 		  (yyval.pth) = (yyvsp0.pth);
 		}
-#line 3970 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4063 "src/preproc/pic/pic.cpp"
     break;
 
-  case 189:
-#line 1404 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 189: /* path: ORDINAL object_type relative_path  */
+#line 1411 "../src/preproc/pic/pic.ypp"
+                {
 		  lex_warning("'%1%2 %3' in 'with' argument ignored",
 			      (yyvsp-2.n), ordinal_postfix((yyvsp-2.n)), object_type_name((yyvsp-1.obtype)));
 		  (yyval.pth) = (yyvsp0.pth);
 		}
-#line 3980 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4073 "src/preproc/pic/pic.cpp"
     break;
 
-  case 190:
-#line 1410 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 190: /* path: LABEL relative_path  */
+#line 1417 "../src/preproc/pic/pic.ypp"
+                {
 		  lex_warning("initial '%1' in 'with' argument ignored", (yyvsp-1.str));
-		  a_delete (yyvsp-1.str);
+		  delete (yyvsp-1.str);
 		  (yyval.pth) = (yyvsp0.pth);
 		}
-#line 3990 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4083 "src/preproc/pic/pic.cpp"
     break;
 
-  case 191:
-#line 1419 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north; }
-#line 3996 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 191: /* corner: DOT_N  */
+#line 1426 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north; }
+#line 4089 "src/preproc/pic/pic.cpp"
     break;
 
-  case 192:
-#line 1421 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::east; }
-#line 4002 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 192: /* corner: DOT_E  */
+#line 1428 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::east; }
+#line 4095 "src/preproc/pic/pic.cpp"
     break;
 
-  case 193:
-#line 1423 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::west; }
-#line 4008 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 193: /* corner: DOT_W  */
+#line 1430 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::west; }
+#line 4101 "src/preproc/pic/pic.cpp"
     break;
 
-  case 194:
-#line 1425 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south; }
-#line 4014 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 194: /* corner: DOT_S  */
+#line 1432 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south; }
+#line 4107 "src/preproc/pic/pic.cpp"
     break;
 
-  case 195:
-#line 1427 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_east; }
-#line 4020 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 195: /* corner: DOT_NE  */
+#line 1434 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_east; }
+#line 4113 "src/preproc/pic/pic.cpp"
     break;
 
-  case 196:
-#line 1429 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object:: south_east; }
-#line 4026 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 196: /* corner: DOT_SE  */
+#line 1436 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object:: south_east; }
+#line 4119 "src/preproc/pic/pic.cpp"
     break;
 
-  case 197:
-#line 1431 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_west; }
-#line 4032 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 197: /* corner: DOT_NW  */
+#line 1438 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_west; }
+#line 4125 "src/preproc/pic/pic.cpp"
     break;
 
-  case 198:
-#line 1433 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south_west; }
-#line 4038 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 198: /* corner: DOT_SW  */
+#line 1440 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south_west; }
+#line 4131 "src/preproc/pic/pic.cpp"
     break;
 
-  case 199:
-#line 1435 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::center; }
-#line 4044 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 199: /* corner: DOT_C  */
+#line 1442 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::center; }
+#line 4137 "src/preproc/pic/pic.cpp"
     break;
 
-  case 200:
-#line 1437 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::start; }
-#line 4050 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 200: /* corner: DOT_START  */
+#line 1444 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::start; }
+#line 4143 "src/preproc/pic/pic.cpp"
     break;
 
-  case 201:
-#line 1439 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::end; }
-#line 4056 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 201: /* corner: DOT_END  */
+#line 1446 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::end; }
+#line 4149 "src/preproc/pic/pic.cpp"
     break;
 
-  case 202:
-#line 1441 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north; }
-#line 4062 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 202: /* corner: TOP  */
+#line 1448 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north; }
+#line 4155 "src/preproc/pic/pic.cpp"
     break;
 
-  case 203:
-#line 1443 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south; }
-#line 4068 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 203: /* corner: BOTTOM  */
+#line 1450 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south; }
+#line 4161 "src/preproc/pic/pic.cpp"
     break;
 
-  case 204:
-#line 1445 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::west; }
-#line 4074 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 204: /* corner: LEFT  */
+#line 1452 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::west; }
+#line 4167 "src/preproc/pic/pic.cpp"
     break;
 
-  case 205:
-#line 1447 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::east; }
-#line 4080 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 205: /* corner: RIGHT  */
+#line 1454 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::east; }
+#line 4173 "src/preproc/pic/pic.cpp"
     break;
 
-  case 206:
-#line 1449 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_west; }
-#line 4086 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 206: /* corner: UPPER LEFT  */
+#line 1456 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_west; }
+#line 4179 "src/preproc/pic/pic.cpp"
     break;
 
-  case 207:
-#line 1451 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south_west; }
-#line 4092 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 207: /* corner: LOWER LEFT  */
+#line 1458 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south_west; }
+#line 4185 "src/preproc/pic/pic.cpp"
     break;
 
-  case 208:
-#line 1453 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_east; }
-#line 4098 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 208: /* corner: UPPER RIGHT  */
+#line 1460 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_east; }
+#line 4191 "src/preproc/pic/pic.cpp"
     break;
 
-  case 209:
-#line 1455 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south_east; }
-#line 4104 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 209: /* corner: LOWER RIGHT  */
+#line 1462 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south_east; }
+#line 4197 "src/preproc/pic/pic.cpp"
     break;
 
-  case 210:
-#line 1457 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::west; }
-#line 4110 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 210: /* corner: LEFT_CORNER  */
+#line 1464 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::west; }
+#line 4203 "src/preproc/pic/pic.cpp"
     break;
 
-  case 211:
-#line 1459 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::east; }
-#line 4116 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 211: /* corner: RIGHT_CORNER  */
+#line 1466 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::east; }
+#line 4209 "src/preproc/pic/pic.cpp"
     break;
 
-  case 212:
-#line 1461 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_west; }
-#line 4122 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 212: /* corner: UPPER LEFT_CORNER  */
+#line 1468 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_west; }
+#line 4215 "src/preproc/pic/pic.cpp"
     break;
 
-  case 213:
-#line 1463 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south_west; }
-#line 4128 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 213: /* corner: LOWER LEFT_CORNER  */
+#line 1470 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south_west; }
+#line 4221 "src/preproc/pic/pic.cpp"
     break;
 
-  case 214:
-#line 1465 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north_east; }
-#line 4134 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 214: /* corner: UPPER RIGHT_CORNER  */
+#line 1472 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north_east; }
+#line 4227 "src/preproc/pic/pic.cpp"
     break;
 
-  case 215:
-#line 1467 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south_east; }
-#line 4140 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 215: /* corner: LOWER RIGHT_CORNER  */
+#line 1474 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south_east; }
+#line 4233 "src/preproc/pic/pic.cpp"
     break;
 
-  case 216:
-#line 1469 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::north; }
-#line 4146 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 216: /* corner: NORTH  */
+#line 1476 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::north; }
+#line 4239 "src/preproc/pic/pic.cpp"
     break;
 
-  case 217:
-#line 1471 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::south; }
-#line 4152 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 217: /* corner: SOUTH  */
+#line 1478 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::south; }
+#line 4245 "src/preproc/pic/pic.cpp"
     break;
 
-  case 218:
-#line 1473 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::east; }
-#line 4158 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 218: /* corner: EAST  */
+#line 1480 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::east; }
+#line 4251 "src/preproc/pic/pic.cpp"
     break;
 
-  case 219:
-#line 1475 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::west; }
-#line 4164 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 219: /* corner: WEST  */
+#line 1482 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::west; }
+#line 4257 "src/preproc/pic/pic.cpp"
     break;
 
-  case 220:
-#line 1477 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::center; }
-#line 4170 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 220: /* corner: CENTER  */
+#line 1484 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::center; }
+#line 4263 "src/preproc/pic/pic.cpp"
     break;
 
-  case 221:
-#line 1479 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::start; }
-#line 4176 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 221: /* corner: START  */
+#line 1486 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::start; }
+#line 4269 "src/preproc/pic/pic.cpp"
     break;
 
-  case 222:
-#line 1481 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.crn) = &object::end; }
-#line 4182 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 222: /* corner: END  */
+#line 1488 "../src/preproc/pic/pic.ypp"
+                { (yyval.crn) = &object::end; }
+#line 4275 "src/preproc/pic/pic.cpp"
     break;
 
-  case 223:
-#line 1486 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp0.x); }
-#line 4188 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 223: /* expr: expr_lower_than  */
+#line 1493 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp0.x); }
+#line 4281 "src/preproc/pic/pic.cpp"
     break;
 
-  case 224:
-#line 1488 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp0.x); }
-#line 4194 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 224: /* expr: expr_not_lower_than  */
+#line 1495 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp0.x); }
+#line 4287 "src/preproc/pic/pic.cpp"
     break;
 
-  case 225:
-#line 1493 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) < (yyvsp0.x)); }
-#line 4200 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 225: /* expr_lower_than: expr '<' expr  */
+#line 1500 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) < (yyvsp0.x)); }
+#line 4293 "src/preproc/pic/pic.cpp"
     break;
 
-  case 226:
-#line 1498 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 226: /* expr_not_lower_than: VARIABLE  */
+#line 1505 "../src/preproc/pic/pic.ypp"
+                {
 		  if (!lookup_variable((yyvsp0.str), & (yyval.x))) {
 		    lex_error("there is no variable '%1'", (yyvsp0.str));
 		    YYABORT;
 		  }
 		  free((yyvsp0.str));
 		}
-#line 4212 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4305 "src/preproc/pic/pic.cpp"
     break;
 
-  case 227:
-#line 1506 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp0.x); }
-#line 4218 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 227: /* expr_not_lower_than: NUMBER  */
+#line 1513 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp0.x); }
+#line 4311 "src/preproc/pic/pic.cpp"
     break;
 
-  case 228:
-#line 1508 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 228: /* expr_not_lower_than: place DOT_X  */
+#line 1515 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp-1.pl).obj != 0)
 		    (yyval.x) = (yyvsp-1.pl).obj->origin().x;
 		  else
 		    (yyval.x) = (yyvsp-1.pl).x;
 		}
-#line 4229 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4322 "src/preproc/pic/pic.cpp"
     break;
 
-  case 229:
-#line 1515 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 229: /* expr_not_lower_than: place DOT_Y  */
+#line 1522 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp-1.pl).obj != 0)
 		    (yyval.x) = (yyvsp-1.pl).obj->origin().y;
 		  else
 		    (yyval.x) = (yyvsp-1.pl).y;
 		}
-#line 4240 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4333 "src/preproc/pic/pic.cpp"
     break;
 
-  case 230:
-#line 1522 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 230: /* expr_not_lower_than: place DOT_HT  */
+#line 1529 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp-1.pl).obj != 0)
 		    (yyval.x) = (yyvsp-1.pl).obj->height();
 		  else
 		    (yyval.x) = 0.0;
 		}
-#line 4251 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4344 "src/preproc/pic/pic.cpp"
     break;
 
-  case 231:
-#line 1529 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 231: /* expr_not_lower_than: place DOT_WID  */
+#line 1536 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp-1.pl).obj != 0)
 		    (yyval.x) = (yyvsp-1.pl).obj->width();
 		  else
 		    (yyval.x) = 0.0;
 		}
-#line 4262 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4355 "src/preproc/pic/pic.cpp"
     break;
 
-  case 232:
-#line 1536 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 232: /* expr_not_lower_than: place DOT_RAD  */
+#line 1543 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp-1.pl).obj != 0)
 		    (yyval.x) = (yyvsp-1.pl).obj->radius();
 		  else
 		    (yyval.x) = 0.0;
 		}
-#line 4273 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4366 "src/preproc/pic/pic.cpp"
     break;
 
-  case 233:
-#line 1543 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-2.x) + (yyvsp0.x); }
-#line 4279 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 233: /* expr_not_lower_than: expr '+' expr  */
+#line 1550 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-2.x) + (yyvsp0.x); }
+#line 4372 "src/preproc/pic/pic.cpp"
     break;
 
-  case 234:
-#line 1545 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-2.x) - (yyvsp0.x); }
-#line 4285 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 234: /* expr_not_lower_than: expr '-' expr  */
+#line 1552 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-2.x) - (yyvsp0.x); }
+#line 4378 "src/preproc/pic/pic.cpp"
     break;
 
-  case 235:
-#line 1547 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-2.x) * (yyvsp0.x); }
-#line 4291 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 235: /* expr_not_lower_than: expr '*' expr  */
+#line 1554 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-2.x) * (yyvsp0.x); }
+#line 4384 "src/preproc/pic/pic.cpp"
     break;
 
-  case 236:
-#line 1549 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 236: /* expr_not_lower_than: expr '/' expr  */
+#line 1556 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp0.x) == 0.0) {
 		    lex_error("division by zero");
 		    YYABORT;
 		  }
 		  (yyval.x) = (yyvsp-2.x)/(yyvsp0.x);
 		}
-#line 4303 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4396 "src/preproc/pic/pic.cpp"
     break;
 
-  case 237:
-#line 1557 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 237: /* expr_not_lower_than: expr '%' expr  */
+#line 1564 "../src/preproc/pic/pic.ypp"
+                {
 		  if ((yyvsp0.x) == 0.0) {
 		    lex_error("modulus by zero");
 		    YYABORT;
 		  }
 		  (yyval.x) = fmod((yyvsp-2.x), (yyvsp0.x));
 		}
-#line 4315 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4408 "src/preproc/pic/pic.cpp"
     break;
 
-  case 238:
-#line 1565 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 238: /* expr_not_lower_than: expr '^' expr  */
+#line 1572 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = pow((yyvsp-2.x), (yyvsp0.x));
 		  if (errno == EDOM) {
@@ -4328,24 +4421,24 @@
 		    YYABORT;
 		  }
 		}
-#line 4332 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4425 "src/preproc/pic/pic.cpp"
     break;
 
-  case 239:
-#line 1578 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = -(yyvsp0.x); }
-#line 4338 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 239: /* expr_not_lower_than: '-' expr  */
+#line 1585 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = -(yyvsp0.x); }
+#line 4431 "src/preproc/pic/pic.cpp"
     break;
 
-  case 240:
-#line 1580 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-1.x); }
-#line 4344 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 240: /* expr_not_lower_than: '(' any_expr ')'  */
+#line 1587 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-1.x); }
+#line 4437 "src/preproc/pic/pic.cpp"
     break;
 
-  case 241:
-#line 1582 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 241: /* expr_not_lower_than: SIN '(' any_expr ')'  */
+#line 1589 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = sin((yyvsp-1.x));
 		  if (errno == ERANGE) {
@@ -4353,12 +4446,12 @@
 		    YYABORT;
 		  }
 		}
-#line 4357 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4450 "src/preproc/pic/pic.cpp"
     break;
 
-  case 242:
-#line 1591 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 242: /* expr_not_lower_than: COS '(' any_expr ')'  */
+#line 1598 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = cos((yyvsp-1.x));
 		  if (errno == ERANGE) {
@@ -4366,12 +4459,12 @@
 		    YYABORT;
 		  }
 		}
-#line 4370 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4463 "src/preproc/pic/pic.cpp"
     break;
 
-  case 243:
-#line 1600 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 243: /* expr_not_lower_than: ATAN2 '(' any_expr ',' any_expr ')'  */
+#line 1607 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = atan2((yyvsp-3.x), (yyvsp-1.x));
 		  if (errno == EDOM) {
@@ -4383,12 +4476,12 @@
 		    YYABORT;
 		  }
 		}
-#line 4387 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4480 "src/preproc/pic/pic.cpp"
     break;
 
-  case 244:
-#line 1613 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 244: /* expr_not_lower_than: LOG '(' any_expr ')'  */
+#line 1620 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = log10((yyvsp-1.x));
 		  if (errno == ERANGE) {
@@ -4396,12 +4489,12 @@
 		    YYABORT;
 		  }
 		}
-#line 4400 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4493 "src/preproc/pic/pic.cpp"
     break;
 
-  case 245:
-#line 1622 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 245: /* expr_not_lower_than: EXP '(' any_expr ')'  */
+#line 1629 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = pow(10.0, (yyvsp-1.x));
 		  if (errno == ERANGE) {
@@ -4409,12 +4502,12 @@
 		    YYABORT;
 		  }
 		}
-#line 4413 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4506 "src/preproc/pic/pic.cpp"
     break;
 
-  case 246:
-#line 1631 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 246: /* expr_not_lower_than: SQRT '(' any_expr ')'  */
+#line 1638 "../src/preproc/pic/pic.ypp"
+                {
 		  errno = 0;
 		  (yyval.x) = sqrt((yyvsp-1.x));
 		  if (errno == EDOM) {
@@ -4422,102 +4515,108 @@
 		    YYABORT;
 		  }
 		}
-#line 4426 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4519 "src/preproc/pic/pic.cpp"
     break;
 
-  case 247:
-#line 1640 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-3.x) > (yyvsp-1.x) ? (yyvsp-3.x) : (yyvsp-1.x); }
-#line 4432 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 247: /* expr_not_lower_than: K_MAX '(' any_expr ',' any_expr ')'  */
+#line 1647 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-3.x) > (yyvsp-1.x) ? (yyvsp-3.x) : (yyvsp-1.x); }
+#line 4525 "src/preproc/pic/pic.cpp"
     break;
 
-  case 248:
-#line 1642 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-3.x) < (yyvsp-1.x) ? (yyvsp-3.x) : (yyvsp-1.x); }
-#line 4438 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 248: /* expr_not_lower_than: K_MIN '(' any_expr ',' any_expr ')'  */
+#line 1649 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-3.x) < (yyvsp-1.x) ? (yyvsp-3.x) : (yyvsp-1.x); }
+#line 4531 "src/preproc/pic/pic.cpp"
     break;
 
-  case 249:
-#line 1644 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = (yyvsp-1.x) < 0 ? -floor(-(yyvsp-1.x)) : floor((yyvsp-1.x)); }
-#line 4444 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 249: /* expr_not_lower_than: INT '(' any_expr ')'  */
+#line 1651 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = (yyvsp-1.x) < 0 ? -floor(-(yyvsp-1.x)) : floor((yyvsp-1.x)); }
+#line 4537 "src/preproc/pic/pic.cpp"
     break;
 
-  case 250:
-#line 1646 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = 1.0 + floor(((rand()&0x7fff)/double(0x7fff))*(yyvsp-1.x)); }
-#line 4450 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 250: /* expr_not_lower_than: RAND '(' any_expr ')'  */
+#line 1653 "../src/preproc/pic/pic.ypp"
+                {
+		  lex_error("use of 'rand' with an argument is"
+			    " deprecated; shift and scale 'rand()' with"
+			    " arithmetic instead");
+		  (yyval.x) = 1.0 + floor(((rand()&0x7fff)/double(0x7fff))*(yyvsp-1.x));
+		}
+#line 4548 "src/preproc/pic/pic.cpp"
     break;
 
-  case 251:
-#line 1648 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 251: /* expr_not_lower_than: RAND '(' ')'  */
+#line 1660 "../src/preproc/pic/pic.ypp"
+                {
 		  /* return a random number in the range 0,1) */
 		  /* portable, but not very random */
 		  (yyval.x) = (rand() & 0x7fff) / double(0x8000);
 		}
-#line 4460 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4558 "src/preproc/pic/pic.cpp"
     break;
 
-  case 252:
-#line 1654 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    {
+  case 252: /* expr_not_lower_than: SRAND '(' any_expr ')'  */
+#line 1666 "../src/preproc/pic/pic.ypp"
+                {
 		  (yyval.x) = 0;
 		  srand((unsigned int)(yyvsp-1.x));
 		}
-#line 4469 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4567 "src/preproc/pic/pic.cpp"
     break;
 
-  case 253:
-#line 1659 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) <= (yyvsp0.x)); }
-#line 4475 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 253: /* expr_not_lower_than: expr LESSEQUAL expr  */
+#line 1671 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) <= (yyvsp0.x)); }
+#line 4573 "src/preproc/pic/pic.cpp"
     break;
 
-  case 254:
-#line 1661 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) > (yyvsp0.x)); }
-#line 4481 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 254: /* expr_not_lower_than: expr '>' expr  */
+#line 1673 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) > (yyvsp0.x)); }
+#line 4579 "src/preproc/pic/pic.cpp"
     break;
 
-  case 255:
-#line 1663 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) >= (yyvsp0.x)); }
-#line 4487 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 255: /* expr_not_lower_than: expr GREATEREQUAL expr  */
+#line 1675 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) >= (yyvsp0.x)); }
+#line 4585 "src/preproc/pic/pic.cpp"
     break;
 
-  case 256:
-#line 1665 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) == (yyvsp0.x)); }
-#line 4493 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 256: /* expr_not_lower_than: expr EQUALEQUAL expr  */
+#line 1677 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) == (yyvsp0.x)); }
+#line 4591 "src/preproc/pic/pic.cpp"
     break;
 
-  case 257:
-#line 1667 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != (yyvsp0.x)); }
-#line 4499 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 257: /* expr_not_lower_than: expr NOTEQUAL expr  */
+#line 1679 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != (yyvsp0.x)); }
+#line 4597 "src/preproc/pic/pic.cpp"
     break;
 
-  case 258:
-#line 1669 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
-#line 4505 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 258: /* expr_not_lower_than: expr ANDAND expr  */
+#line 1681 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 && (yyvsp0.x) != 0.0); }
+#line 4603 "src/preproc/pic/pic.cpp"
     break;
 
-  case 259:
-#line 1671 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
-#line 4511 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 259: /* expr_not_lower_than: expr OROR expr  */
+#line 1683 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp-2.x) != 0.0 || (yyvsp0.x) != 0.0); }
+#line 4609 "src/preproc/pic/pic.cpp"
     break;
 
-  case 260:
-#line 1673 "../src/preproc/pic/pic.ypp" /* yacc.c:1645  */
-    { (yyval.x) = ((yyvsp0.x) == 0.0); }
-#line 4517 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+  case 260: /* expr_not_lower_than: '!' expr  */
+#line 1685 "../src/preproc/pic/pic.ypp"
+                { (yyval.x) = ((yyvsp0.x) == 0.0); }
+#line 4615 "src/preproc/pic/pic.cpp"
     break;
 
 
-#line 4521 "src/preproc/pic/pic.cpp" /* yacc.c:1645  */
+#line 4619 "src/preproc/pic/pic.cpp"
+
       default: break;
     }
   /* User semantic actions sometimes alter yychar, and that requires
@@ -4531,11 +4630,10 @@
      case of YYERROR or YYBACKUP, subsequent parser actions might lead
      to an incorrect destructor call or verbose syntax error message
      before the lookahead is translated.  */
-  YY_SYMBOL_PRINT ("-> $$ =", yyr1yyn, &yyval, &yyloc);
+  YY_SYMBOL_PRINT ("-> $$ =", YY_CAST (yysymbol_kind_t, yyr1yyn), &yyval, &yyloc);
 
   YYPOPSTACK (yylen);
   yylen = 0;
-  YY_STACK_PRINT (yyss, yyssp);
 
   *++yyvsp = yyval;
 
@@ -4559,50 +4657,14 @@
 yyerrlab:
   /* Make sure we have latest lookahead translation.  See comments at
      user semantic actions for why this is necessary.  */
-  yytoken = yychar == YYEMPTY ? YYEMPTY : YYTRANSLATE (yychar);
-
+  yytoken = yychar == YYEMPTY ? YYSYMBOL_YYEMPTY : YYTRANSLATE (yychar);
   /* If not already recovering from an error, report this error.  */
   if (!yyerrstatus)
     {
       ++yynerrs;
-#if ! YYERROR_VERBOSE
       yyerror (YY_("syntax error"));
-#else
-# define YYSYNTAX_ERROR yysyntax_error (&yymsg_alloc, &yymsg, \
-                                        yyssp, yytoken)
-      {
-        char const *yymsgp = YY_("syntax error");
-        int yysyntax_error_status;
-        yysyntax_error_status = YYSYNTAX_ERROR;
-        if (yysyntax_error_status == 0)
-          yymsgp = yymsg;
-        else if (yysyntax_error_status == 1)
-          {
-            if (yymsg != yymsgbuf)
-              YYSTACK_FREE (yymsg);
-            yymsg = (char *) YYSTACK_ALLOC (yymsg_alloc);
-            if (!yymsg)
-              {
-                yymsg = yymsgbuf;
-                yymsg_alloc = sizeof yymsgbuf;
-                yysyntax_error_status = 2;
-              }
-            else
-              {
-                yysyntax_error_status = YYSYNTAX_ERROR;
-                yymsgp = yymsg;
-              }
-          }
-        yyerror (yymsgp);
-        if (yysyntax_error_status == 2)
-          goto yyexhaustedlab;
-      }
-# undef YYSYNTAX_ERROR
-#endif
     }
 
-
-
   if (yyerrstatus == 3)
     {
       /* If just tried and failed to reuse lookahead token after an
@@ -4631,12 +4693,11 @@
 | yyerrorlab -- error raised explicitly by YYERROR.  |
 `---------------------------------------------------*/
 yyerrorlab:
-
-  /* Pacify compilers like GCC when the user code never invokes
-     YYERROR and the label yyerrorlab therefore never appears in user
-     code.  */
-  if (/*CONSTCOND*/ 0)
-     goto yyerrorlab;
+  /* Pacify compilers when the user code never invokes YYERROR and the
+     label yyerrorlab therefore never appears in user code.  */
+  if (0)
+    YYERROR;
+  ++yynerrs;
 
   /* Do not reclaim the symbols of the rule whose action triggered
      this YYERROR.  */
@@ -4653,13 +4714,14 @@
 yyerrlab1:
   yyerrstatus = 3;      /* Each real token shifted decrements this.  */
 
+  /* Pop stack until we find a state that shifts the error token.  */
   for (;;)
     {
       yyn = yypactyystate;
       if (!yypact_value_is_default (yyn))
         {
-          yyn += YYTERROR;
-          if (0 <= yyn && yyn <= YYLAST && yycheckyyn == YYTERROR)
+          yyn += YYSYMBOL_YYerror;
+          if (0 <= yyn && yyn <= YYLAST && yycheckyyn == YYSYMBOL_YYerror)
             {
               yyn = yytableyyn;
               if (0 < yyn)
@@ -4673,7 +4735,7 @@
 
 
       yydestruct ("Error: popping",
-                  yystosyystate, yyvsp);
+                  YY_ACCESSING_SYMBOL (yystate), yyvsp);
       YYPOPSTACK (1);
       yystate = *yyssp;
       YY_STACK_PRINT (yyss, yyssp);
@@ -4685,7 +4747,7 @@
 
 
   /* Shift the error token.  */
-  YY_SYMBOL_PRINT ("Shifting", yystosyyn, yyvsp, yylsp);
+  YY_SYMBOL_PRINT ("Shifting", YY_ACCESSING_SYMBOL (yyn), yyvsp, yylsp);
 
   yystate = yyn;
   goto yynewstate;
@@ -4696,26 +4758,30 @@
 `-------------------------------------*/
 yyacceptlab:
   yyresult = 0;
-  goto yyreturn;
+  goto yyreturnlab;
+
 
 /*-----------------------------------.
 | yyabortlab -- YYABORT comes here.  |
 `-----------------------------------*/
 yyabortlab:
   yyresult = 1;
-  goto yyreturn;
+  goto yyreturnlab;
+
 
-#if !defined yyoverflow || YYERROR_VERBOSE
-/*-------------------------------------------------.
-| yyexhaustedlab -- memory exhaustion comes here.  |
-`-------------------------------------------------*/
+/*-----------------------------------------------------------.
+| yyexhaustedlab -- YYNOMEM (memory exhaustion) comes here.  |
+`-----------------------------------------------------------*/
 yyexhaustedlab:
   yyerror (YY_("memory exhausted"));
   yyresult = 2;
-  /* Fall through.  */
-#endif
+  goto yyreturnlab;
 
-yyreturn:
+
+/*----------------------------------------------------------.
+| yyreturnlab -- parsing is finished, clean up and return.  |
+`----------------------------------------------------------*/
+yyreturnlab:
   if (yychar != YYEMPTY)
     {
       /* Make sure we have latest lookahead translation.  See comments at
@@ -4731,20 +4797,18 @@
   while (yyssp != yyss)
     {
       yydestruct ("Cleanup: popping",
-                  yystos*yyssp, yyvsp);
+                  YY_ACCESSING_SYMBOL (+*yyssp), yyvsp);
       YYPOPSTACK (1);
     }
 #ifndef yyoverflow
   if (yyss != yyssa)
     YYSTACK_FREE (yyss);
 #endif
-#if YYERROR_VERBOSE
-  if (yymsg != yymsgbuf)
-    YYSTACK_FREE (yymsg);
-#endif
+
   return yyresult;
 }
-#line 1677 "../src/preproc/pic/pic.ypp" /* yacc.c:1903  */
+
+#line 1689 "../src/preproc/pic/pic.ypp"
 
 
 /* bison defines const to be empty unless __STDC__ is defined, which it
@@ -4823,7 +4887,7 @@
   p->y = 0.0;
   current_table->define(name, p);
   if (strcmp(name, "scale") == 0) {
-    // When the scale changes, reset all scaled pre-defined variables to
+    // When the scale changes, reset all scaled predefined variables to
     // their default values.
     for (unsigned int i = 0;
 	 i < sizeof(defaults_table)/sizeof(defaults_table0); i++) 
@@ -4862,9 +4926,9 @@
 
 void reset_all()
 {
-  // We only have to explicitly reset the pre-defined variables that
+  // We only have to explicitly reset the predefined variables that
   // aren't scaled because 'scale' is not scaled, and changing the
-  // value of 'scale' will reset all the pre-defined variables that
+  // value of 'scale' will reset all the predefined variables that
   // are scaled.
   for (unsigned int i = 0;
        i < sizeof(defaults_table)/sizeof(defaults_table0); i++)
@@ -4952,53 +5016,65 @@
 
 static char sprintf_buf1024;
 
-char *format_number(const char *form, double n)
+char *format_number(const char *fmt, double n)
 {
-  if (form == 0)
-    form = "%g";
-  return do_sprintf(form, &n, 1);
+  if (0 /* nullptr */ == fmt)
+    fmt = "%g";
+  return do_sprintf(fmt, &n, 1);
 }
 
-char *do_sprintf(const char *form, const double *v, int nv)
+char *do_sprintf(const char *fmt, const double *v, int nv)
 {
+  // Define valid conversion specifiers and modifiers.
+  static const char spcs = "eEfgG%";
+  static const char mods = "#-+ 0123456789.";
   string result;
   int i = 0;
   string one_format;
-  while (*form) {
-    if (*form == '%') {
-      one_format += *form++;
-      for (; *form != '\0' && strchr("#-+ 0123456789.", *form) != 0; form++)
-	one_format += *form;
-      if (*form == '\0' || strchr("eEfgG%", *form) == 0) {
-	lex_error("bad sprintf format");
+  while (*fmt) {
+    if ('%' == *fmt) {
+      one_format += *fmt++;
+      for (; *fmt != '\0' && strchr(mods, *fmt) != 0; fmt++)
+	one_format += *fmt;
+      if ('\0' == *fmt || strchr(spcs, *fmt) == 0) {
+	lex_error("invalid sprintf conversion specifier '%1'", *fmt);
 	result += one_format;
-	result += form;
+	result += fmt;
 	break;
       }
-      if (*form == '%') {
-	one_format += *form++;
-	one_format += '\0';
-	snprintf(sprintf_buf, sizeof(sprintf_buf),
-		 "%s", one_format.contents());
+      if ('%' == *fmt) {
+	fmt++;
+	snprintf(sprintf_buf, sizeof(sprintf_buf), "%%");
       }
       else {
 	if (i >= nv) {
-	  lex_error("too few arguments to snprintf");
+	  lex_error("too few arguments to sprintf");
 	  result += one_format;
-	  result += form;
+	  result += fmt;
 	  break;
 	}
-	one_format += *form++;
+	one_format += *fmt++;
 	one_format += '\0';
+// We validated the format string above.  Most conversion specifiers are
+// rejected, including `n`.
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wformat-nonliteral"
 	snprintf(sprintf_buf, sizeof(sprintf_buf),
 		 one_format.contents(), vi++);
+#pragma GCC diagnostic pop
       }
       one_format.clear();
       result += sprintf_buf;
     }
     else
-      result += *form++;
+      result += *fmt++;
   }
   result += '\0';
   return strsave(result.contents());
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.hpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.hpp Changed

@@ -1,8 +1,9 @@
-/* A Bison parser, made by GNU Bison 3.2.  */
+/* A Bison parser, made by GNU Bison 3.8.2.  */
 
 /* Bison interface for Yacc-like parsers in C
 
-   Copyright (C) 1984, 1989-1990, 2000-2015, 2018 Free Software Foundation, Inc.
+   Copyright (C) 1984, 1989-1990, 2000-2015, 2018-2021 Free Software Foundation,
+   Inc.
 
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
@@ -15,7 +16,7 @@
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
-   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
+   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
 
 /* As a special exception, you may create a larger work that contains
    part or all of the Bison parser skeleton and distribute that work
@@ -30,8 +31,9 @@
    This special exception was added by the Free Software Foundation in
    version 2.2 of Bison.  */
 
-/* Undocumented macros, especially those whose name start with YY_,
-   are private implementation details.  Do not rely on them.  */
+/* DO NOT RELY ON FEATURES THAT ARE NOT DOCUMENTED in the manual,
+   especially those whose name start with YY_ or yy_.  They are
+   private implementation details that can be changed or removed.  */
 
 #ifndef YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED
 # define YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED
@@ -43,136 +45,145 @@
 extern int yydebug;
 #endif
 
-/* Token type.  */
+/* Token kinds.  */
 #ifndef YYTOKENTYPE
 # define YYTOKENTYPE
   enum yytokentype
   {
-    LABEL = 258,
-    VARIABLE = 259,
-    NUMBER = 260,
-    TEXT = 261,
-    COMMAND_LINE = 262,
-    DELIMITED = 263,
-    ORDINAL = 264,
-    TH = 265,
-    LEFT_ARROW_HEAD = 266,
-    RIGHT_ARROW_HEAD = 267,
-    DOUBLE_ARROW_HEAD = 268,
-    LAST = 269,
-    BOX = 270,
-    CIRCLE = 271,
-    ELLIPSE = 272,
-    ARC = 273,
-    LINE = 274,
-    ARROW = 275,
-    MOVE = 276,
-    SPLINE = 277,
-    HEIGHT = 278,
-    RADIUS = 279,
-    FIGNAME = 280,
-    WIDTH = 281,
-    DIAMETER = 282,
-    UP = 283,
-    DOWN = 284,
-    RIGHT = 285,
-    LEFT = 286,
-    FROM = 287,
-    TO = 288,
-    AT = 289,
-    WITH = 290,
-    BY = 291,
-    THEN = 292,
-    SOLID = 293,
-    DOTTED = 294,
-    DASHED = 295,
-    CHOP = 296,
-    SAME = 297,
-    INVISIBLE = 298,
-    LJUST = 299,
-    RJUST = 300,
-    ABOVE = 301,
-    BELOW = 302,
-    OF = 303,
-    THE = 304,
-    WAY = 305,
-    BETWEEN = 306,
-    AND = 307,
-    HERE = 308,
-    DOT_N = 309,
-    DOT_E = 310,
-    DOT_W = 311,
-    DOT_S = 312,
-    DOT_NE = 313,
-    DOT_SE = 314,
-    DOT_NW = 315,
-    DOT_SW = 316,
-    DOT_C = 317,
-    DOT_START = 318,
-    DOT_END = 319,
-    DOT_X = 320,
-    DOT_Y = 321,
-    DOT_HT = 322,
-    DOT_WID = 323,
-    DOT_RAD = 324,
-    SIN = 325,
-    COS = 326,
-    ATAN2 = 327,
-    LOG = 328,
-    EXP = 329,
-    SQRT = 330,
-    K_MAX = 331,
-    K_MIN = 332,
-    INT = 333,
-    RAND = 334,
-    SRAND = 335,
-    COPY = 336,
-    THRU = 337,
-    TOP = 338,
-    BOTTOM = 339,
-    UPPER = 340,
-    LOWER = 341,
-    SH = 342,
-    PRINT = 343,
-    CW = 344,
-    CCW = 345,
-    FOR = 346,
-    DO = 347,
-    IF = 348,
-    ELSE = 349,
-    ANDAND = 350,
-    OROR = 351,
-    NOTEQUAL = 352,
-    EQUALEQUAL = 353,
-    LESSEQUAL = 354,
-    GREATEREQUAL = 355,
-    LEFT_CORNER = 356,
-    RIGHT_CORNER = 357,
-    NORTH = 358,
-    SOUTH = 359,
-    EAST = 360,
-    WEST = 361,
-    CENTER = 362,
-    END = 363,
-    START = 364,
-    RESET = 365,
-    UNTIL = 366,
-    PLOT = 367,
-    THICKNESS = 368,
-    FILL = 369,
-    COLORED = 370,
-    OUTLINED = 371,
-    SHADED = 372,
-    XSLANTED = 373,
-    YSLANTED = 374,
-    ALIGNED = 375,
-    SPRINTF = 376,
-    COMMAND = 377,
-    DEFINE = 378,
-    UNDEF = 379
+    YYEMPTY = -2,
+    YYEOF = 0,                     /* "end of file"  */
+    YYerror = 256,                 /* error  */
+    YYUNDEF = 257,                 /* "invalid token"  */
+    LABEL = 258,                   /* LABEL  */
+    VARIABLE = 259,                /* VARIABLE  */
+    NUMBER = 260,                  /* NUMBER  */
+    TEXT = 261,                    /* TEXT  */
+    COMMAND_LINE = 262,            /* COMMAND_LINE  */
+    DELIMITED = 263,               /* DELIMITED  */
+    ORDINAL = 264,                 /* ORDINAL  */
+    TH = 265,                      /* TH  */
+    LEFT_ARROW_HEAD = 266,         /* LEFT_ARROW_HEAD  */
+    RIGHT_ARROW_HEAD = 267,        /* RIGHT_ARROW_HEAD  */
+    DOUBLE_ARROW_HEAD = 268,       /* DOUBLE_ARROW_HEAD  */
+    LAST = 269,                    /* LAST  */
+    BOX = 270,                     /* BOX  */
+    CIRCLE = 271,                  /* CIRCLE  */
+    ELLIPSE = 272,                 /* ELLIPSE  */
+    ARC = 273,                     /* ARC  */
+    LINE = 274,                    /* LINE  */
+    ARROW = 275,                   /* ARROW  */
+    MOVE = 276,                    /* MOVE  */
+    SPLINE = 277,                  /* SPLINE  */
+    HEIGHT = 278,                  /* HEIGHT  */
+    RADIUS = 279,                  /* RADIUS  */
+    FIGNAME = 280,                 /* FIGNAME  */
+    WIDTH = 281,                   /* WIDTH  */
+    DIAMETER = 282,                /* DIAMETER  */
+    UP = 283,                      /* UP  */
+    DOWN = 284,                    /* DOWN  */
+    RIGHT = 285,                   /* RIGHT  */
+    LEFT = 286,                    /* LEFT  */
+    FROM = 287,                    /* FROM  */
+    TO = 288,                      /* TO  */
+    AT = 289,                      /* AT  */
+    WITH = 290,                    /* WITH  */
+    BY = 291,                      /* BY  */
+    THEN = 292,                    /* THEN  */
+    SOLID = 293,                   /* SOLID  */
+    DOTTED = 294,                  /* DOTTED  */
+    DASHED = 295,                  /* DASHED  */
+    CHOP = 296,                    /* CHOP  */
+    SAME = 297,                    /* SAME  */
+    INVISIBLE = 298,               /* INVISIBLE  */
+    LJUST = 299,                   /* LJUST  */
+    RJUST = 300,                   /* RJUST  */
+    ABOVE = 301,                   /* ABOVE  */
+    BELOW = 302,                   /* BELOW  */
+    OF = 303,                      /* OF  */
+    THE = 304,                     /* THE  */
+    WAY = 305,                     /* WAY  */
+    BETWEEN = 306,                 /* BETWEEN  */
+    AND = 307,                     /* AND  */
+    HERE = 308,                    /* HERE  */
+    DOT_N = 309,                   /* DOT_N  */
+    DOT_E = 310,                   /* DOT_E  */
+    DOT_W = 311,                   /* DOT_W  */
+    DOT_S = 312,                   /* DOT_S  */
+    DOT_NE = 313,                  /* DOT_NE  */
+    DOT_SE = 314,                  /* DOT_SE  */
+    DOT_NW = 315,                  /* DOT_NW  */
+    DOT_SW = 316,                  /* DOT_SW  */
+    DOT_C = 317,                   /* DOT_C  */
+    DOT_START = 318,               /* DOT_START  */
+    DOT_END = 319,                 /* DOT_END  */
+    DOT_X = 320,                   /* DOT_X  */
+    DOT_Y = 321,                   /* DOT_Y  */
+    DOT_HT = 322,                  /* DOT_HT  */
+    DOT_WID = 323,                 /* DOT_WID  */
+    DOT_RAD = 324,                 /* DOT_RAD  */
+    SIN = 325,                     /* SIN  */
+    COS = 326,                     /* COS  */
+    ATAN2 = 327,                   /* ATAN2  */
+    LOG = 328,                     /* LOG  */
+    EXP = 329,                     /* EXP  */
+    SQRT = 330,                    /* SQRT  */
+    K_MAX = 331,                   /* K_MAX  */
+    K_MIN = 332,                   /* K_MIN  */
+    INT = 333,                     /* INT  */
+    RAND = 334,                    /* RAND  */
+    SRAND = 335,                   /* SRAND  */
+    COPY = 336,                    /* COPY  */
+    THRU = 337,                    /* THRU  */
+    TOP = 338,                     /* TOP  */
+    BOTTOM = 339,                  /* BOTTOM  */
+    UPPER = 340,                   /* UPPER  */
+    LOWER = 341,                   /* LOWER  */
+    SH = 342,                      /* SH  */
+    PRINT = 343,                   /* PRINT  */
+    CW = 344,                      /* CW  */
+    CCW = 345,                     /* CCW  */
+    FOR = 346,                     /* FOR  */
+    DO = 347,                      /* DO  */
+    IF = 348,                      /* IF  */
+    ELSE = 349,                    /* ELSE  */
+    ANDAND = 350,                  /* ANDAND  */
+    OROR = 351,                    /* OROR  */
+    NOTEQUAL = 352,                /* NOTEQUAL  */
+    EQUALEQUAL = 353,              /* EQUALEQUAL  */
+    LESSEQUAL = 354,               /* LESSEQUAL  */
+    GREATEREQUAL = 355,            /* GREATEREQUAL  */
+    LEFT_CORNER = 356,             /* LEFT_CORNER  */
+    RIGHT_CORNER = 357,            /* RIGHT_CORNER  */
+    NORTH = 358,                   /* NORTH  */
+    SOUTH = 359,                   /* SOUTH  */
+    EAST = 360,                    /* EAST  */
+    WEST = 361,                    /* WEST  */
+    CENTER = 362,                  /* CENTER  */
+    END = 363,                     /* END  */
+    START = 364,                   /* START  */
+    RESET = 365,                   /* RESET  */
+    UNTIL = 366,                   /* UNTIL  */
+    PLOT = 367,                    /* PLOT  */
+    THICKNESS = 368,               /* THICKNESS  */
+    FILL = 369,                    /* FILL  */
+    COLORED = 370,                 /* COLORED  */
+    OUTLINED = 371,                /* OUTLINED  */
+    SHADED = 372,                  /* SHADED  */
+    XSLANTED = 373,                /* XSLANTED  */
+    YSLANTED = 374,                /* YSLANTED  */
+    ALIGNED = 375,                 /* ALIGNED  */
+    SPRINTF = 376,                 /* SPRINTF  */
+    COMMAND = 377,                 /* COMMAND  */
+    DEFINE = 378,                  /* DEFINE  */
+    UNDEF = 379                    /* UNDEF  */
   };
+  typedef enum yytokentype yytoken_kind_t;
 #endif
-/* Tokens.  */
+/* Token kinds.  */
+#define YYEMPTY -2
+#define YYEOF 0
+#define YYerror 256
+#define YYUNDEF 257
 #define LABEL 258
 #define VARIABLE 259
 #define NUMBER 260
@@ -298,10 +309,9 @@
 
 /* Value type.  */
 #if ! defined YYSTYPE && ! defined YYSTYPE_IS_DECLARED
-
 union YYSTYPE
 {
-#line 65 "../src/preproc/pic/pic.ypp" /* yacc.c:1906  */
+#line 65 "../src/preproc/pic/pic.ypp"
 
 	char *str;
 	int n;
@@ -320,9 +330,9 @@
 	graphics_state state;
 	object_type obtype;
 
-#line 324 "src/preproc/pic/pic.hpp" /* yacc.c:1906  */
-};
+#line 334 "src/preproc/pic/pic.hpp"
 
+};
 typedef union YYSTYPE YYSTYPE;
 # define YYSTYPE_IS_TRIVIAL 1
 # define YYSTYPE_IS_DECLARED 1
@@ -331,6 +341,8 @@
 
 extern YYSTYPE yylval;
 
+
 int yyparse (void);
 
+
 #endif /* !YY_YY_SRC_PREPROC_PIC_PIC_HPP_INCLUDED  */

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/pic.ypp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/pic.ypp Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2022 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -55,8 +55,8 @@
 
 const char *ordinal_postfix(int n);
 const char *object_type_name(object_type type);
-char *format_number(const char *form, double n);
-char *do_sprintf(const char *form, const double *v, int nv);
+char *format_number(const char *fmt, double n);
+char *do_sprintf(const char *fmt, const double *v, int nv);
 
 %}
 
@@ -306,10 +306,10 @@
 placeless_element:
 	FIGNAME '=' macro_name
 		{
-		  a_delete graphname;
+		  delete graphname;
 		  graphname = new charstrlen($3) + 1;
 		  strcpy(graphname, $3);
-		  a_delete $3;
+		  delete $3;
 		}
 	|
 	VARIABLE '=' any_expr
@@ -350,7 +350,7 @@
 	| PRINT print_args
 		{
 		  fprintf(stderr, "%s\n", $2.str);
-		  a_delete $2.str;
+		  delete $2.str;
 		  fflush(stderr);
 		}
 	| SH
@@ -359,10 +359,15 @@
 		{
 		  delim_flag = 0;
 		  if (safer_flag)
-		    lex_error("unsafe to run command '%1'", $3);
-		  else
-		    system($3);
-		  a_delete $3;
+		    lex_error("unsafe to run command '%1'; ignoring",
+			      $3);
+		  else {
+		    int retval = system($3);
+		    if (retval < 0)
+		      lex_error("error running command '%1': system()"
+			" returned %2", $3, retval);
+		  }
+		  delete $3;
 		}
 	| COPY TEXT
 		{
@@ -381,8 +386,8 @@
 		    do_lookahead();
 		  copy_file_thru($2.str, $5, $7);
 		  // do not delete the filename
-		  a_delete $5;
-		  a_delete $7;
+		  delete $5;
+		  delete $7;
 		}
 	| COPY THRU
 		{ delim_flag = 2; }
@@ -393,8 +398,8 @@
 		  if (yychar < 0)
 		    do_lookahead();
 		  copy_rest_thru($4, $6);
-		  a_delete $4;
-		  a_delete $6;
+		  delete $4;
+		  delete $6;
 		}
 	| FOR VARIABLE '=' expr TO expr optional_by DO
 	  	{ delim_flag = 1; }
@@ -411,7 +416,7 @@
 		    do_lookahead();
 		  if ($1.x != 0.0)
 		    push_body($1.body);
-		  a_delete $1.body;
+		  delete $1.body;
 		}
 	| simple_if ELSE
 		{ delim_flag = 1; }
@@ -441,17 +446,17 @@
 	RESET VARIABLE
 		{
 		  reset($2);
-		  a_delete $2;
+		  delete $2;
 		}
 	| reset_variables VARIABLE
 		{
 		  reset($2);
-		  a_delete $2;
+		  delete $2;
 		}
 	| reset_variables ',' VARIABLE
 		{
 		  reset($3);
-		  a_delete $3;
+		  delete $3;
 		}
 	;
 
@@ -463,8 +468,8 @@
 		  $$.str = new charstrlen($1.str) + strlen($2.str) + 1;
 		  strcpy($$.str, $1.str);
 		  strcat($$.str, $2.str);
-		  a_delete $1.str;
-		  a_delete $2.str;
+		  delete $1.str;
+		  delete $2.str;
 		  if ($1.filename) {
 		    $$.filename = $1.filename;
 		    $$.lineno = $1.lineno;
@@ -524,14 +529,14 @@
 	text EQUALEQUAL text
 		{
 		  $$ = strcmp($1.str, $3.str) == 0;
-		  a_delete $1.str;
-		  a_delete $3.str;
+		  delete $1.str;
+		  delete $3.str;
 		}
 	| text NOTEQUAL text
 		{
 		  $$ = strcmp($1.str, $3.str) != 0;
-		  a_delete $1.str;
-		  a_delete $3.str;
+		  delete $1.str;
+		  delete $3.str;
 		}
 	| text_expr ANDAND text_expr
 		{ $$ = ($1 != 0.0 && $3 != 0.0); }
@@ -681,6 +686,8 @@
 		}
 	| PLOT expr
 		{
+		  lex_warning("'plot' is deprecated; use 'sprintf'"
+			      " instead");
 		  $$ = new object_spec(TEXT_OBJECT);
 		  $$->text = new text_item(format_number(0, $2), 0, -1);
 		}
@@ -689,7 +696,7 @@
 		  $$ = new object_spec(TEXT_OBJECT);
 		  $$->text = new text_item(format_number($3.str, $2),
 					   $3.filename, $3.lineno);
-		  a_delete $3.str;
+		  delete $3.str;
 		}
 	| '' 
 		{
@@ -1109,7 +1116,7 @@
 		  $$.filename = $3.filename;
 		  $$.lineno = $3.lineno;
 		  $$.str = do_sprintf($3.str, $4.v, $4.nv);
-		  a_delete $4.v;
+		  delete $4.v;
 		  free($3.str);
 		}
 	;
@@ -1142,7 +1149,7 @@
 		      memcpy(foo, oldv, $$.nv*sizeof(double));
 		      $$.v = foo;
 #endif
-		      a_delete oldv;
+		      delete oldv;
 		    }
 		  }
 		  $$.v$$.nv = $3;
@@ -1409,7 +1416,7 @@
 	| LABEL relative_path
 		{
 		  lex_warning("initial '%1' in 'with' argument ignored", $1);
-		  a_delete $1;
+		  delete $1;
 		  $$ = $2;
 		}
 	;
@@ -1643,7 +1650,12 @@
 	| INT '(' any_expr ')'
 		{ $$ = $3 < 0 ? -floor(-$3) : floor($3); }
 	| RAND '(' any_expr ')'
-		{ $$ = 1.0 + floor(((rand()&0x7fff)/double(0x7fff))*$3); }
+		{
+		  lex_error("use of 'rand' with an argument is"
+			    " deprecated; shift and scale 'rand()' with"
+			    " arithmetic instead");
+		  $$ = 1.0 + floor(((rand()&0x7fff)/double(0x7fff))*$3);
+		}
 	| RAND '(' ')'
 		{
 		  /* return a random number in the range 0,1) */
@@ -1752,7 +1764,7 @@
   p->y = 0.0;
   current_table->define(name, p);
   if (strcmp(name, "scale") == 0) {
-    // When the scale changes, reset all scaled pre-defined variables to
+    // When the scale changes, reset all scaled predefined variables to
     // their default values.
     for (unsigned int i = 0;
 	 i < sizeof(defaults_table)/sizeof(defaults_table0); i++) 
@@ -1791,9 +1803,9 @@
 
 void reset_all()
 {
-  // We only have to explicitly reset the pre-defined variables that
+  // We only have to explicitly reset the predefined variables that
   // aren't scaled because 'scale' is not scaled, and changing the
-  // value of 'scale' will reset all the pre-defined variables that
+  // value of 'scale' will reset all the predefined variables that
   // are scaled.
   for (unsigned int i = 0;
        i < sizeof(defaults_table)/sizeof(defaults_table0); i++)
@@ -1881,53 +1893,65 @@
 
 static char sprintf_buf1024;
 
-char *format_number(const char *form, double n)
+char *format_number(const char *fmt, double n)
 {
-  if (form == 0)
-    form = "%g";
-  return do_sprintf(form, &n, 1);
+  if (0 /* nullptr */ == fmt)
+    fmt = "%g";
+  return do_sprintf(fmt, &n, 1);
 }
 
-char *do_sprintf(const char *form, const double *v, int nv)
+char *do_sprintf(const char *fmt, const double *v, int nv)
 {
+  // Define valid conversion specifiers and modifiers.
+  static const char spcs = "eEfgG%";
+  static const char mods = "#-+ 0123456789.";
   string result;
   int i = 0;
   string one_format;
-  while (*form) {
-    if (*form == '%') {
-      one_format += *form++;
-      for (; *form != '\0' && strchr("#-+ 0123456789.", *form) != 0; form++)
-	one_format += *form;
-      if (*form == '\0' || strchr("eEfgG%", *form) == 0) {
-	lex_error("bad sprintf format");
+  while (*fmt) {
+    if ('%' == *fmt) {
+      one_format += *fmt++;
+      for (; *fmt != '\0' && strchr(mods, *fmt) != 0; fmt++)
+	one_format += *fmt;
+      if ('\0' == *fmt || strchr(spcs, *fmt) == 0) {
+	lex_error("invalid sprintf conversion specifier '%1'", *fmt);
 	result += one_format;
-	result += form;
+	result += fmt;
 	break;
       }
-      if (*form == '%') {
-	one_format += *form++;
-	one_format += '\0';
-	snprintf(sprintf_buf, sizeof(sprintf_buf),
-		 "%s", one_format.contents());
+      if ('%' == *fmt) {
+	fmt++;
+	snprintf(sprintf_buf, sizeof(sprintf_buf), "%%");
       }
       else {
 	if (i >= nv) {
-	  lex_error("too few arguments to snprintf");
+	  lex_error("too few arguments to sprintf");
 	  result += one_format;
-	  result += form;
+	  result += fmt;
 	  break;
 	}
-	one_format += *form++;
+	one_format += *fmt++;
 	one_format += '\0';
+// We validated the format string above.  Most conversion specifiers are
+// rejected, including `n`.
+#pragma GCC diagnostic push
+#pragma GCC diagnostic ignored "-Wformat-nonliteral"
 	snprintf(sprintf_buf, sizeof(sprintf_buf),
 		 one_format.contents(), vi++);
+#pragma GCC diagnostic pop
       }
       one_format.clear();
       result += sprintf_buf;
     }
     else
-      result += *form++;
+      result += *fmt++;
   }
   result += '\0';
   return strsave(result.contents());
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/position.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/position.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/tex.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/tex.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/text.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/text.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/pic/troff.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/pic/troff.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -254,6 +253,7 @@
 
 troff_output::~troff_output()
 {
+  free((char *)last_filename);
 }
 
 inline position troff_output::transform(const position &pos)
@@ -298,14 +298,19 @@
   line_thickness(BAD_THICKNESS);
   last_fill = -1.0;		// force it to be reset for each picture
   reset_color();
-  if (!flyback_flag)
+  if (!(want_flyback || want_alternate_flyback))
     printf(".sp %.3fi+1\n", height);
   printf(".if \\n(" FILL_REG " .fi\n");
   printf(".br\n");
   printf(".nr " EQN_NO_EXTRA_SPACE_REG " 0\n");
   // this is a little gross
   set_location(current_filename, current_lineno);
-  fputs(flyback_flag ? ".PF\n" : ".PE\n", stdout);
+  if (want_flyback)
+    fputs(".PF\n", stdout);
+  else if (want_alternate_flyback)
+    fputs(".PY\n", stdout);
+  else
+    fputs(".PE\n", stdout);
 }
 
 void troff_output::command(const char *s,
@@ -560,6 +565,15 @@
     printf(".lf %d\n", n);
   else {
     printf(".lf %d %s\n", n, s);
-    last_filename = s;
+    char *lfn = strdup(s);
+    if (0 == lfn)
+      fatal("memory allocation failure while copying file name");
+    last_filename = lfn;
   }
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/preconv/preconv.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/preconv.1.man Changed

@@ -1,19 +1,14 @@
-.TH PRECONV @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-preconv \- convert encoding of input files to something GNU troff \
-understands
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr preconv_C \n.C
-.cp 0
+.TH preconv @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+preconv \- prepare files for typesetting with
+.I groff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2020 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
@@ -31,344 +26,534 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_preconv_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY preconv
-.OP \-dr
-.OP \-D default_encoding
-.OP \-e encoding
-.RI  file
-\&.\|.\|.\&
+.RB  \-dr 
+.RB  \-D\~\c
+.IR fallback-encoding 
+.RB  \-e\~\c
+.IR encoding 
+.RI  file\~ .\|.\|.
+.YS
+.
 .
 .SY preconv
 .B \-h
+.
 .SY preconv
 .B \-\-help
 .YS
 .
+.
 .SY preconv
 .B \-v
+.
 .SY preconv
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B preconv
-reads
-.I files
-and converts its encoding(s) to a form GNU
-.BR troff (@MAN1EXT@)
-can process, sending the data to standard output.
+.I preconv
+reads each
+.IR file ,
+converts its encoded characters to a form
+.MR @g@troff @MAN1EXT@
+can interpret,
+and sends the result to the standard output stream.
+.
+Currently,
+this means that code points in the range 0\en127
+(in US-ASCII,
+ISO\~8859,
+or Unicode)
+remain as-is and the remainder are converted to the
+.I groff
+special character form
+.RB \lq \rs\c
+.BI u XXXX \c
+\rq,
+where
+.I XXXX
+is a hexadecimal number of four to six digits corresponding to a Unicode
+code point.
+.
+By default,
+.I preconv
+also inserts a
+.I roff
+.B .lf
+request at the beginning of each
+.IR file ,
+identifying it for the benefit of later processing
+(including diagnostic messages);
+the
+.B \-r
+option suppresses this behavior.
 .
-Currently, this means ASCII characters and \oq\euXXXX\cq
-entities, where \oqXXXX\cq is a hexadecimal number with four to
-six digits, representing a Unicode input code.
 .
-Normally,
-.B preconv
-should be invoked with the
+.PP
+In typical usage scenarios,
+.I preconv
+need not be run directly;
+instead it should be invoked with the
 .B \-k
-and
+or
 .B \-K
 options of
-.BR groff .
-.
-.
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
-.B \-d
-Emit debugging messages to standard error (mainly the used encoding).
-.
-.TP
-.BI \-D encoding
-Specify default encoding if everything fails (see below).
-.
-.TP
-.BI \-e encoding
-Specify input encoding explicitly, overriding all other methods.
-.
-This corresponds to
-.BR groff 's
-.BI \-K encoding
-option.
+.IR groff .
 .
-Without this switch,
-.B preconv
-uses the algorithm described below to select the input encoding.
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+the standard input stream is read.
 .
-.TP
-.B \-\-help
-.TQ
-.B \-h
-Print a help message and exit.
 .
-.TP
-.B \-r
-Do not add \&.lf requests.
-.
-.TP
-.B \-\-version
-.TQ
-.B \-v
-Print the version number and exit.
-.
-.
-.\" ====================================================================
-.SH USAGE
-.\" ====================================================================
+.PP
+.I preconv
+tries to find the input encoding with the following algorithm,
+stopping at the first success.
 .
-.B preconv
-tries to find the input encoding with the following algorithm.
 .
-.IP 1.
+.IP 1. 4n
 If the input encoding has been explicitly specified with option
 .BR \-e ,
 use it.
 .
+.
 .IP 2.
-Otherwise, check whether the input starts with a
-.I Byte Order Mark
-(BOM, see below).
+If the input starts with a Unicode Byte Order Mark,
+determine the encoding as UTF-8,
+UTF-16,
+or UTF-32 accordingly.
 .
-If found, use it.
 .
 .IP 3.
-Otherwise, check whether there is a known
-.I coding tag
-(see below) in either the first or second input line.
+If the input stream is seekable,
+check the first and second input lines for a recognized GNU\~Emacs
+file-local variable identifying the character encoding,
+here referred to as the \lqcoding tag\rq for brevity.
+.
+If found,
+use it.
+.
 .
-If found, use it.
+.IP 4.
+If the input stream is seekable,
+and if the
+.I uchardet
+library is available on the system,
+use it to try to infer the encoding of the file.
 .
-.IP 4
-Finally, if the
-.B uchardet
-library
-(an encoding detector library available on most major distributions)
-is available on the system, use it to try to detect the encoding of the file.
 .
 .IP 5.
-If everything fails, use a default encoding as given with option
-.BR \-D ,
-by the current locale, or \oqlatin1\cq if the locale is set to
-\oqC\cq, \oqPOSIX\cq, or empty (in that order).
+If the
+.B \-D
+option specifies an encoding,
+use it.
+.
+.
+.IP 6.
+Use the encoding specified by the current locale
+.RI ( LC_CTYPE ),
+unless the locale is
+\lqC\rq,
+\lqPOSIX\rq,
+or empty,
+in which case assume Latin-1
+(ISO\~8859-1).
 .
 .
 .PP
-Note that the
-.B groff
-program supports a
+The coding tag and
+.I uchardet
+methods in the above procedure rely upon a seekable input stream;
+when
+.I preconv
+reads from a pipe,
+the stream is not seekable,
+and these detection methods are skipped.
+.
+If character encoding detection of your input files is unreliable,
+arrange for one of the other methods to succeed by using
+.IR preconv 's
+.B \-D
+or
+.B \-e
+options,
+or by configuring your locale appropriately.
+.
+.I groff
+also supports a
 .I \%GROFF_ENCODING
-environment variable which is eventually expanded to option
-.BR \-k .
+environment variable,
+which can be overridden by its
+.B \-K
+option.
+.
+Valid values for
+(or parameters to)
+all of these are enumerated in the lists of recognized coding tags in
+the next subsection,
+and are further influenced by
+.I iconv
+library support.
 .
 .
 .\" ====================================================================
-.SS "Byte Order Mark"
+.SS "Coding tags"
 .\" ====================================================================
 .
-The Unicode Standard defines character U+FEFF as the Byte Order Mark
-(BOM).
+Text editors that support more than a single character encoding need
+tags within the input files to mark the file's encoding.
 .
-On the other hand, value U+FFFE is guaranteed not be a Unicode character at
-all.
+While it is possible to guess the right input encoding with the help of
+heuristics that are reliable for a preponderance of natural language
+texts,
+they are not absolutely reliable.
 .
-This allows detection of the byte order within the data stream (either
-big-endian or little-endian), and the MIME encodings \%\oqUTF-16\cq
-and \%\oqUTF-32\cq mandate that the data stream starts with U+FEFF.
+Heuristics can fail on inputs that are too short or don't represent a
+natural language.
 .
-Similarly, the data stream encoded as \%\oqUTF-8\cq might start
-with a BOM (to ease the conversion from and to \%UTF-16 and \%UTF-32).
 .
-In all cases, the byte order mark is
-.I not
-part of the data but part of the encoding protocol; in other words,
-.BR preconv 's
-output doesn't contain it.
+.PP
+Consequently,
+.I preconv
+supports the coding tag convention used by GNU\~Emacs
+(with some restrictions).
 .
+This notation appears in specially marked regions of an input file
+designated for \lqfile-local variables\rq.
 .
-.PP
-Note that U+FEFF not at the start of the input data actually is
-emitted; it has then the meaning of a \oqzero width no-break
-space\cq character \en something not needed normally in
-.BR groff .
 .
+.PP
+.I preconv
+interprets the following syntax if it occurs in a
+.I roff
+comment
+in the first or second line of the input file.
 .
-.\" ====================================================================
-.SS "Coding Tags"
-.\" ====================================================================
+Both \lq\rs"\rq and \lq\rs#\rq comment forms are recognized,
+but the control
+(or no-break control)
+character must be the default and must begin the line.
 .
-Editors which support more than a single character encoding need tags
-within the input files to mark the file's encoding.
+Similarly,
+the escape character must be the default.
 .
-While it is possible to guess the right input encoding with the help of
-heuristic algorithms for data which represents a greater amount of a natural
-language, it is still just a guess.
 .
-Additionally, all algorithms fail easily for input which is either too short
-or doesn't represent a natural language.
+.RS
+.EX
+.B \-*\- \c
+.RB .\|.\|. ; \~\c
+.B coding: \c
+.I encoding\c
+.RB  ;\~ .\|.\|.\&\~\c
+.B \-*\-
+.EE
+.RE
 .
 .
 .PP
-For these reasons,
-.B preconv
-supports the coding tag convention (with some restrictions) as used by
-.B "GNU Emacs"
-and
-.B XEmacs
-(and probably other programs too).
+The only variable
+.I preconv
+interprets is \lqcoding\rq,
+which can take the values listed below.
 .
 .
 .PP
-Coding tags in
-.B "GNU Emacs"
-and
-.B XEmacs
-are stored in so-called
-.IR "File Variables" .
-.
-.B preconv
-recognizes the following syntax form which must be put into a troff comment
-in the first or second line.
+The following list comprises all MIME \lqcharset\rq parameter values
+recognized,
+case-insensitively,
+by
+.IR preconv .
 .
 .RS
-.PP
-\-*\-
-.IR tag1 :
-.IR value1 ;
-.IR tag2 :
-.IR value2 ;
-\&.\|.\|.\& \-*\-
+\%big5,
+\%cp1047,
+\%euc\-jp,
+\%euc\-kr,
+\%gb2312,
+\%iso\-8859\-1,
+\%iso\-8859\-2,
+\%iso\-8859\-5,
+\%iso\-8859\-7,
+\%iso\-8859\-9,
+\%iso\-8859\-13,
+\%iso\-8859\-15,
+\%koi8\-r,
+\%us\-ascii,
+\%utf\-8,
+\%utf\-16,
+\%utf\-16be,
+\%utf\-16le
 .RE
 .
 .
 .PP
-The only relevant tag for
-.B preconv
-is \oqcoding\cq which can take the values listed below.
-.
-Here an example line which tells
-.B Emacs
-to edit a file in troff mode, and to use \%latin2 as its encoding.
+In addition,
+the following list of other coding tags is recognized,
+each of which is mapped to an appropriate value from the list above.
 .
 .RS
-.PP
-.EX
-\&.\rs" \-*\- mode: troff; coding: latin-2 \-*\-
-.EE
+\%ascii,
+\%chinese\-big5,
+\%chinese\-euc,
+\%chinese\-iso\-8bit,
+\%cn\-big5,
+\%cn\-gb,
+\%cn\-gb\-2312,
+\%cp878,
+\%csascii,
+\%csisolatin1,
+\%cyrillic\-iso\-8bit,
+\%cyrillic\-koi8,
+\%euc\-china,
+\%euc\-cn,
+\%euc\-japan,
+\%euc\-japan\-1990,
+\%euc\-korea,
+\%greek\-iso\-8bit,
+\%iso\-10646/utf8,
+\%iso\-10646/utf\-8,
+\%iso\-latin\-1,
+\%iso\-latin\-2,
+\%iso\-latin\-5,
+\%iso\-latin\-7,
+\%iso\-latin\-9,
+\%japanese\-euc,
+\%japanese\-iso\-8bit,
+\%jis8,
+\%koi8,
+\%korean\-euc,
+\%korean\-iso\-8bit,
+\%latin\-0,
+\%latin1,
+\%latin\-1,
+\%latin\-2,
+\%latin\-5,
+\%latin\-7,
+\%latin\-9,
+\%mule\-utf\-8,
+\%mule\-utf\-16,
+\%mule\-utf\-16be,
+\%mule\-utf\-16\-be,
+\%mule\-utf\-16be\-with\-signature,
+\%mule\-utf\-16le,
+\%mule\-utf\-16\-le,
+\%mule\-utf\-16le\-with\-signature,
+\%utf8,
+\%utf\-16\-be,
+\%utf\-16\-be\-with\-signature,
+\%utf\-16be\-with\-signature,
+\%utf\-16\-le,
+\%utf\-16\-le\-with\-signature,
+\%utf\-16le\-with\-signature
 .RE
 .
 .
 .PP
-The following list gives all MIME coding tags (either lowercase or
-uppercase) supported by
-.BR preconv ;
-this list is hard-coded in the source.
+Trailing
+\lq\-dos\rq,
+\lq\-unix\rq,
+and
+\lq\-mac\rq
+suffixes on coding tags
+(which indicate the end-of-line convention used in the file)
+are disregarded for the purpose of comparison with the above tags.
 .
-.RS
-.PP
-.ad l
-\%big5, \%cp1047, \%euc-jp, \%euc-kr, \%gb2312, \%iso-8859-1,
-\%iso-8859-2, \%iso-8859-5, \%iso-8859-7, \%iso-8859-9, \%iso-8859-13,
-\%iso-8859-15, \%koi8-r, \%us-ascii, \%utf-8, \%utf-16, \%utf-16be,
-\%utf-16le
-.ad
-.RE
+.
+.\" ====================================================================
+.SS "\fIiconv\f support"
+.\" ====================================================================
+.
+While
+.I preconv
+recognizes all of the coding tags listed above,
+it is capable on its own of interpreting only three encodings:
+Latin-1,
+code page 1047,
+and UTF-8.
+.
+If
+.I iconv
+support is configured at compile time and available at run time,
+all others are passed to
+.I iconv
+library functions,
+which may recognize many additional encoding strings.
+.
+The command
+.RB \lq preconv\~\-v \rq
+discloses whether
+.I iconv
+support is configured.
 .
 .
 .PP
-In addition, the following hard-coded list of other tags is recognized
-which eventually map to values from the list above.
+The use of
+.I iconv
+means that characters in the input that encode invalid code points for
+that encoding may be dropped from the output stream or mapped to the
+Unicode replacement character
+(U+FFFD).
+.
+Compare the following examples using the input \lqcaf\'e\rq
+(note the \lqe\rq with an acute accent),
+which due to its short length challenges inference of the encoding used.
 .
 .RS
-.PP
-.ad l
-\%ascii, \%chinese-big5, \%chinese-euc, \%chinese-iso-8bit, \%cn-big5,
-\%\%cn-gb, \%cn-gb-2312, \%cp878, \%csascii, \%csisolatin1,
-\%cyrillic-iso-8bit, \%cyrillic-koi8, \%euc-china, \%euc-cn,
-\%euc-japan, \%euc-japan-1990, \%euc-korea, \%greek-iso-8bit,
-\%iso-10646/utf8, \%iso-10646/utf-8, \%iso-latin-1, \%iso-latin-2,
-\%iso-latin-5, \%iso-latin-7, \%iso-latin-9, \%japanese-euc,
-\%japanese-iso-8bit, \%jis8, \%koi8, \%korean-euc, \%korean-iso-8bit,
-\%latin-0, \%latin1, \%latin-1, \%latin-2, \%latin-5, \%latin-7,
-\%latin-9, \%mule-utf-8, \%mule-utf-16, \%mule-utf-16be,
-\%mule-utf-16-be, \%mule-utf-16be-with-signature, \%mule-utf-16le,
-\%mule-utf-16-le, \%mule-utf-16le-with-signature, \%utf8, \%utf-16-be,
-\%utf-16-be-with-signature, \%utf-16be-with-signature, \%utf-16-le,
-\%utf-16-le-with-signature, \%utf-16le-with-signature
-.ad
+.EX
+printf \aqcaf\rs351\rsn\aq | LC_ALL=en_US.UTF\-8 preconv
+printf \aqcaf\rs351\rsn\aq | preconv \-e us\-ascii
+printf \aqcaf\rs351\rsn\aq | preconv \-e latin\-1
+.EE
 .RE
 .
+The fate of the accented \lqe\rq differs in each case.
 .
-.PP
-Those tags are taken from
-.B "GNU Emacs"
+In the first,
+.I uchardet
+fails to detect an encoding
+(though the library on your system may behave differently)
 and
-.BR XEmacs ,
-together with some aliases.
-.
-Trailing \%\oq-dos\cq, \%\oq-unix\cq, and \%\oq-mac\cq
-suffixes of coding tags (which give the end-of-line convention used in
-the file) are stripped off before the comparison with the above tags
-happens.
+.I preconv
+falls back to the locale settings,
+where octal 351 starts an incomplete UTF-8 sequence and results in the
+Unicode replacement character.
 .
-.SS "Iconv Issues"
-.B preconv
-by itself only supports three encodings: \%latin-1, cp1047, and \%UTF-8;
-all other encodings are passed to the
-.B iconv
-library functions.
+In the second,
+it is not a representable character in the declared input encoding of
+US-ASCII and is discarded by
+.IR iconv .
 .
-At compile time it is searched and checked for a valid
-.B iconv
-implementation; a call to \oqpreconv \-\-version\cq shows whether
-.B iconv
-is used.
+In the last,
+it is correctly detected and mapped.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SS Limitations
 .\" ====================================================================
 .
-.B preconv
-doesn't support
-.I "local variable lists"
-yet.
+.I preconv
+cannot perform any transformation on input that it cannot see.
+.
+Examples include files that are interpolated by preprocessors that run
+subsequently,
+including
+.MR @g@soelim @MAN1EXT@ ;
+files included by
+.I @g@troff
+itself through
+.RB \lq so \rq
+and similar requests;
+and string definitions passed to
+.I @g@troff
+through its
+.B \-d
+command-line option.
+.
 .
-This is a different syntax form to specify local variables at the end of a
-file.
+.P
+.I preconv
+assumes that its input uses the default escape character,
+a backslash
+.BR \rs ,
+and writes special character escape sequences accordingly.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH Options
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@)
-.br
-the
-.B "GNU Emacs"
+.B \-h
 and
-.B XEmacs
-info pages
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-d
+Emit debugging messages to the standard error stream.
+.
+.
+.TP
+.BI \-D\~ fallback-encoding
+Report
+.I fallback-encoding
+if all detection methods fail.
+.
+.
+.TP
+.BI \-e\~ encoding
+Skip detection and assume
+.IR encoding ;
+see
+.IR groff 's
+.B \-K
+option.
+.
+.
+.TP
+.B \-r
+Write files \lqraw\rq;
+do not add
+.B .lf
+requests.
+.
+.
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
+.
+.MR groff @MAN1EXT@ ,
+.MR iconv 3 ,
+.MR locale 7
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \npreconv_C
+.cp \n*groff_preconv_1_man_C
+.do rr *groff_preconv_1_man_C
 .
 .
-.\" Emacs setting
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/preconv/preconv.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/preconv.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -9,8 +7,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -18,15 +16,22 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
 bin_PROGRAMS += preconv
-preconv_LDADD = libgroff.a $(LIBM) $(LIBICONV) $(UCHARDET_LIBS) lib/libgnu.a
+preconv_LDADD = libgroff.a $(LIBM) $(LIBICONV) $(UCHARDET_LIBS) \
+  lib/libgnu.a
 preconv_SOURCES = src/preproc/preconv/preconv.cpp
 preconv_CPPFLAGS = $(AM_CPPFLAGS) $(UCHARDET_CFLAGS)
 man1_MANS += src/preproc/preconv/preconv.1
 EXTRA_DIST += src/preproc/preconv/preconv.1.man
 
+preconv_TESTS = \
+  src/preproc/preconv/tests/do-not-seek-the-unseekable.sh \
+  src/preproc/preconv/tests/smoke-test.sh
+TESTS += $(preconv_TESTS)
+EXTRA_DIST += $(preconv_TESTS)
+
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/preconv/preconv.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/preconv.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 2005-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2005-2020 Free Software Foundation, Inc.
      Written by Werner Lemberg (wl@gnu.org)
 
 This file is part of groff.
@@ -26,6 +25,7 @@
 #ifdef HAVE_UCHARDET
 #include <uchardet/uchardet.h>
 #endif
+
 #include "errarg.h"
 #include "error.h"
 #include "localcharset.h"
@@ -48,10 +48,10 @@
 
 extern "C" const char *Version_string;
 
-char default_encodingMAX_VAR_LEN;
+char fallback_encodingMAX_VAR_LEN;
 char user_encodingMAX_VAR_LEN;
 char encoding_stringMAX_VAR_LEN;
-int debug_flag = 0;
+bool is_debugging = false;
 int raw_flag = 0;
 
 struct conversion {
@@ -405,9 +405,13 @@
   if (u < 0x80)
     putchar(u);
   else {
-    // Handle soft hyphen specially -- it is an input character only,
-    // not a glyph.
-    if (u == 0xAD) {
+    // Handle no-break space and soft hyphen specially--they are input
+    // characters only, not glyphs.  See groff_char(7).
+    if (u == 0xA0) {
+      putchar('\\');
+      putchar('~');
+    }
+    else if (u == 0xAD) {
       putchar('\\');
       putchar('%');
     }
@@ -449,9 +453,9 @@
     FIFTH,
     SIXTH
   } byte;
-  int expected_bytes;
-  int invalid_warning;
-  int incomplete_warning;
+  int expected_byte_count;
+  bool emit_invalid_utf8_warning;
+  bool emit_incomplete_utf8_warning;
   utf8(FILE *);
   ~utf8();
   void add(unsigned char);
@@ -459,8 +463,9 @@
   void incomplete();
 };
 
-utf8::utf8(FILE *f) : fp(f), byte(FIRST), expected_bytes(1),
-		      invalid_warning(1), incomplete_warning(1)
+utf8::utf8(FILE *f) : fp(f), byte(FIRST), expected_byte_count(1),
+		      emit_invalid_utf8_warning(true),
+		      emit_incomplete_utf8_warning(true)
 {
   // empty
 }
@@ -481,23 +486,23 @@
     else if (c < 0xC0)
       invalid();
     else if (c < 0xE0) {
-      expected_bytes = 2;
+      expected_byte_count = 2;
       byte = SECOND;
     }
     else if (c < 0xF0) {
-      expected_bytes = 3;
+      expected_byte_count = 3;
       byte = SECOND;
     }
     else if (c < 0xF8) {
-      expected_bytes = 4;
+      expected_byte_count = 4;
       byte = SECOND;
     }
     else if (c < 0xFC) {
-      expected_bytes = 5;
+      expected_byte_count = 5;
       byte = SECOND;
     }
     else if (c < 0xFE) {
-      expected_bytes = 6;
+      expected_byte_count = 6;
       byte = SECOND;
     }
     else
@@ -514,7 +519,7 @@
     // can't happen
     break;
   case SECOND:
-    if (expected_bytes == 2) {
+    if (expected_byte_count == 2) {
       if (s0 < 0xC2)
 	invalid();
       else
@@ -526,7 +531,7 @@
       byte = THIRD;
     break;
   case THIRD:
-    if (expected_bytes == 3) {
+    if (expected_byte_count == 3) {
       if (!(s0 >= 0xE1 || s1 >= 0xA0))
 	invalid();
       else
@@ -540,7 +545,7 @@
     break;
   case FOURTH:
     // We reject everything greater than 0x10FFFF.
-    if (expected_bytes == 4) {
+    if (expected_byte_count == 4) {
       if (!((s0 >= 0xF1 || s1 >= 0x90)
 	    && (s0 < 0xF4 || (s0 == 0xF4 && s1 < 0x90))))
 	invalid();
@@ -555,7 +560,7 @@
       byte = FIFTH;
     break;
   case FIFTH:
-    if (expected_bytes == 5) {
+    if (expected_byte_count == 5) {
       invalid();
       byte = FIRST;
     }
@@ -569,13 +574,16 @@
   }
 }
 
+// We use fprintf(stderr) instead of libgroff's debug() because we need
+// to output longs, and libgroff's errprint() doesn't support that.
+
 void
 utf8::invalid()
 {
-  if (debug_flag && invalid_warning) {
-    fprintf(stderr, "  invalid byte(s) found in input stream --\n"
-		    "  each such sequence replaced with 0xFFFD\n");
-    invalid_warning = 0;
+  if (is_debugging && emit_invalid_utf8_warning) {
+    fprintf(stderr, "  invalid UTF-8 sequence(s) in input stream:"
+		    " replacing each such sequence with 0xFFFD\n");
+    emit_invalid_utf8_warning = false;
   }
   unicode_entity(0xFFFD);
   byte = FIRST;
@@ -584,10 +592,10 @@
 void
 utf8::incomplete()
 {
-  if (debug_flag && incomplete_warning) {
-    fprintf(stderr, "  incomplete sequence(s) found in input stream --\n"
-		    "  each such sequence replaced with 0xFFFD\n");
-    incomplete_warning = 0;
+  if (is_debugging && emit_incomplete_utf8_warning) {
+    fprintf(stderr, "  incomplete UTF-8 sequence(s) in input stream:"
+		    " replacing each such sequence with 0xFFFD\n");
+    emit_incomplete_utf8_warning = false;
   }
   unicode_entity(0xFFFD);
   byte = FIRST;
@@ -829,14 +837,13 @@
   }
   if (newline_count > 1)
     return NULL;
-  int emit_warning = 1;
+  bool emit_warning = true;
   for (int lines = newline_count; lines < 2; lines++) {
     while ((c = getc(fp)) != EOF) {
-      if (c == '\0' && debug_flag && emit_warning) {
-	fprintf(stderr,
-		"  null byte(s) found in input stream --\n"
-		"  search for coding tag might return false result\n");
-	emit_warning = 0;
+      if (c == '\0' && is_debugging && emit_warning) {
+	warning("null byte(s) found in input stream:"
+		" search for coding tag might return false result");
+	emit_warning = false;
       }
       data += char(c);
       if (c == '\n' || c == '\r')
@@ -965,8 +972,6 @@
 // Note that null bytes in the data are skipped before applying
 // the algorithm.  This should work even with files encoded as
 // UTF-16 or UTF-32 (or its siblings) in most cases.
-//
-// XXX Add support for tag at the end of buffer.
 // ---------------------------------------------------------
 char *
 check_coding_tag(FILE *fp, string &data)
@@ -1014,39 +1019,41 @@
   char *ret = NULL;
 
   current_position = ftell(fp);
-  /* due to BOM and tag detection we are not at the begining of the file */
+  /* Due to BOM and tag detection, we are not at the beginning of the
+     file. */
   rewind(fp);
   if (fstat(fileno(fp), &stat_buf) != 0) {
-    fprintf(stderr, "fstat: %s\n", strerror(errno));
+    error("fstat: %1", strerror(errno));
     goto end;
   }
   len = stat_buf.st_size;
-  if (debug_flag)
-    fprintf(stderr, "  len: %zu\n", len);  
+  if (is_debugging)
+    fprintf(stderr, "  len: %lu\n", (unsigned long)len);
   if (len == 0)
     goto end;
   data = (char *)calloc(len, 1);
   read_bytes = fread(data, 1, len, fp);
   if (read_bytes == 0) {
-    fprintf(stderr, "fread: %s\n", strerror(errno));
+    error("fread: %1", strerror(errno));
     goto end;
   }
   /* We rewind back to the original position */
   if (fseek(fp, current_position, SEEK_SET) != 0) {
-    fprintf(stderr, "Fatal error: fseek: %s\n", strerror(errno));
+    fatal("fseek: %1", strerror(errno));
     goto end;
   }
   ud = uchardet_new();
   res = uchardet_handle_data(ud, data, len);
   if (res != 0) {
-    fprintf(stderr, "uchardet_handle_data: %d\n", res);
+    debug("  uchardet_handle_data: error %1\n", res);
     goto end;
   }
-  if (debug_flag)
-    fprintf(stderr, "  uchardet read: %zu bytes\n", read_bytes);
+  if (is_debugging)
+    fprintf(stderr, "  uchardet read: %lu bytes\n",
+	    (unsigned long)read_bytes);
   uchardet_data_end(ud);
   charset = uchardet_get_charset(ud);
-  if (debug_flag) {
+  if (is_debugging) {
     if (charset)
        fprintf(stderr, "  charset: %s\n", charset);
     else
@@ -1071,7 +1078,8 @@
 }
 
 // ---------------------------------------------------------
-// Handle an input file.  If filename is '-' handle stdin.
+// Handle an input file.  If `filename` is "-", read the
+// standard input stream.
 //
 // Return 1 on success, 0 otherwise.
 // ---------------------------------------------------------
@@ -1080,27 +1088,40 @@
 {
   FILE *fp;
   string BOM, data;
-  if (strcmp(filename, "-")) {
-    if (debug_flag)
-      fprintf(stderr, "file '%s':\n", filename);
+  bool is_seekable = false;
+  string reported_filename;
+
+  // TODO: Consider moving some of this into a `quoted_file_name`
+  // function in libgroff.
+  if (strcmp(filename, "-") == 0) {
+    fp = stdin;
+    reported_filename = string("<standard input>");
+  }
+  else {
     fp = fopen(filename, FOPEN_RB);
-    if (!fp) {
-      error("can't open '%1': %2", filename, strerror(errno));
-      return 0;
-    }
+    reported_filename = "'" + string(filename) + "'";
+  }
+  if (!fp) {
+    error("can't open %1: %2", reported_filename.contents(),
+	  strerror(errno));
+    return 0;
   }
+  if (is_debugging)
+    fprintf(stderr, "processing %s\n", reported_filename.contents());
+  if (fseek(fp, 0L, SEEK_SET) == 0)
+    is_seekable = true;
   else {
-    if (debug_flag)
-      fprintf(stderr, "standard input:\n");
-    SET_BINARY(fileno(stdin));
-    fp = stdin;
+    SET_BINARY(fileno(fp));
+    if (is_debugging)
+      fprintf(stderr, "  stream is not seekable: %s\n",
+	      strerror(errno));
   }
   const char *BOM_encoding = get_BOM(fp, BOM, data);
   // Determine the encoding.
   char *encoding;
   int must_free_encoding = 0;
   if (user_encoding0) {
-    if (debug_flag) {
+    if (is_debugging) {
       fprintf(stderr, "  user-specified encoding '%s', "
 		      "no search for coding tag\n",
 		      user_encoding);
@@ -1111,7 +1132,7 @@
     encoding = (char *)user_encoding;
   }
   else if (BOM_encoding) {
-    if (debug_flag)
+    if (is_debugging)
       fprintf(stderr, "  found BOM, no search for coding tag\n");
     encoding = (char *)BOM_encoding;
   }
@@ -1119,20 +1140,21 @@
     // 'check_coding_tag' returns a pointer to a static array (or NULL).
     char *file_encoding = check_coding_tag(fp, data);
     if (!file_encoding) {
-      if (debug_flag)
-	fprintf(stderr, "  no encoding tag\n");
-      file_encoding = detect_file_encoding(fp);
+      if (is_debugging)
+	fprintf(stderr, "  no coding tag\n");
+      if (is_seekable)
+         file_encoding = detect_file_encoding(fp);
       if (!file_encoding) {
-        if (debug_flag)
+        if (is_debugging)
           fprintf(stderr, "  could not detect encoding with uchardet\n");
-        file_encoding = default_encoding;
+        file_encoding = fallback_encoding;
       }
       else
         must_free_encoding = 1;
     }
     else
-      if (debug_flag)
-	fprintf(stderr, "  file encoding: '%s'\n", file_encoding);
+      if (is_debugging)
+	fprintf(stderr, "  coding tag: '%s'\n", file_encoding);
     encoding = file_encoding;
   }
   strncpy(encoding_string, encoding, MAX_VAR_LEN - 1);
@@ -1147,7 +1169,7 @@
 	  encoding_string);
     return 0;
   }
-  if (debug_flag)
+  if (is_debugging)
     fprintf(stderr, "  encoding used: '%s'\n", encoding);
   if (!raw_flag) {
     string fn(filename);
@@ -1182,17 +1204,22 @@
 void
 usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s  option   files \n"
-		  "\n"
-		  "-d           show debugging messages\n"
-		  "-D encoding  specify default encoding\n"
-		  "-e encoding  specify input encoding\n"
-		  "-h           print this message\n"
-		  "-r           don't add .lf requests\n"
-		  "-v           print version number\n"
-		  "\n"
-		  "The default encoding is '%s'.\n",
-		  program_name, default_encoding);
+  fprintf(stream,
+"usage: %s -dr -D fallback-encoding -e encoding file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n",
+	  program_name, program_name, program_name);
+  if (stdout == stream) {
+    fprintf(stream,
+"\n"
+"Read each file, convert its encoded characters to a form GNU"
+" troff(1)\n"
+"can interpret, and send the result to the standard output stream.\n"
+"The default fallback encoding is '%s'.  See the preconv(1) manual"
+" page.\n",
+	  fallback_encoding);
+    exit(EXIT_SUCCESS);
+  }
 }
 
 // ---------------------------------------------------------
@@ -1202,16 +1229,16 @@
 main(int argc, char **argv)
 {
   program_name = argv0;
-  // Determine the default encoding.  This must be done before
-  // getopt() is called since the usage message shows the default
+  // Determine the fallback encoding.  This must be done before
+  // getopt() is called since the usage message shows the fallback
   // encoding.
   setlocale(LC_ALL, "");
   char *locale = getlocale(LC_CTYPE);
   if (!locale || !strcmp(locale, "C") || !strcmp(locale, "POSIX"))
-    strcpy(default_encoding, "latin1");
+    strcpy(fallback_encoding, "latin1");
   else {
-    strncpy(default_encoding, locale_charset(), MAX_VAR_LEN - 1);
-    default_encodingMAX_VAR_LEN - 1 = 0;
+    strncpy(fallback_encoding, locale_charset(), MAX_VAR_LEN - 1);
+    fallback_encodingMAX_VAR_LEN - 1 = 0;
   }
 
   program_name = argv0;
@@ -1242,7 +1269,7 @@
       exit(0);
       break;
     case 'd':
-      debug_flag = 1;
+      is_debugging = true;
       break;
     case 'e':
       if (optarg) {
@@ -1254,8 +1281,8 @@
       break;
     case 'D':
       if (optarg) {
-	strncpy(default_encoding, optarg, MAX_VAR_LEN - 1);
-	default_encodingMAX_VAR_LEN - 1 = 0;
+	strncpy(fallback_encoding, optarg, MAX_VAR_LEN - 1);
+	fallback_encodingMAX_VAR_LEN - 1 = 0;
       }
       break;
     case 'r':
@@ -1263,7 +1290,6 @@
       break;
     case 'h':
       usage(stdout);
-      exit(0);
       break;
     case '?':
       usage(stderr);
@@ -1273,8 +1299,8 @@
       assert(0);
     }
   int nbad = 0;
-  if (debug_flag)
-    fprintf(stderr, "default encoding: '%s'\n", default_encoding);
+  if (is_debugging)
+    fprintf(stderr, "fallback encoding: '%s'\n", fallback_encoding);
   if (optind >= argc)
     nbad += !do_file("-");
   else
@@ -1285,4 +1311,8 @@
   return nbad != 0;
 }
 
-/* end of preconv.cpp */
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/tests/do-not-seek-the-unseekable.sh Added

@@ -0,0 +1,59 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+set -e
+
+preconv="${abs_top_builddir:-.}/preconv"
+
+fail=
+
+wail () {
+    echo FAILED >&2
+    fail=YES
+}
+
+# Scrape debugging output to see if we're skipping unseekable streams.
+# This is fragile, but we don't want to lock the language of diagnostic
+# messages (especially debugging ones).  If this test fails, check the
+# text of the command's debugging output for a mismatch before
+# investigating deeper problems.
+
+echo "testing seekability of file operand '-'" >&2
+output=$(printf '' | "$preconv" -d - 2>&1)
+echo "$output" | grep -q "stream is not seekable" || wail
+
+# /dev/stdin might not exist in a chroot.  Or, if it's not (a symbolic
+# link to) a character special device, the next test will not be valid,
+# as when using GNU Make's `-j` option.
+#
+# Similarly, we must have a controlling terminal.
+test -z "$fail"
+echo "skipping if /dev/stdin is not a character device" >&2
+test -c /dev/stdin || exit 77 # skip
+echo "skipping if there is no controlling terminal" >&2
+test "$(tty)" != "not a tty" || exit 77 # skip
+
+echo "testing seekability of standard input stream" >&2
+output=$(printf '' | "$preconv" -d /dev/stdin 2>&1)
+echo "$output" | grep -q "stream is not seekable" || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/preconv/tests/smoke-test.sh Added

@@ -0,0 +1,88 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+# Ensure a predictable character encoding.
+export LC_ALL=C
+
+set -e
+
+preconv="${abs_top_builddir:-.}/preconv"
+
+echo "testing -e flag override of BOM detection" >&2
+printf '\376\377\0\100\0\n' \
+    | "$preconv" -d -e euc-kr 2>&1 > /dev/null \
+    | grep -q "no search for coding tag"
+
+echo "testing detection of UTF-32BE BOM" >&2
+printf '\0\0\376\377\0\0\0\100\0\0\0\n' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "found BOM"
+
+echo "testing detection of UTF-32LE BOM" >&2
+printf '\377\376\0\0\100\0\0\0\n\0\0\0' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "found BOM"
+
+echo "testing detection of UTF-16BE BOM" >&2
+printf '\376\377\0\100\0\n' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "found BOM"
+
+echo "testing detection of UTF-16LE BOM" >&2
+printf '\377\376\100\0\n\0' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "found BOM"
+
+echo "testing detection of UTF-8 BOM" >&2
+printf '\357\273\277@\n' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "found BOM"
+
+# We do not find a coding tag on piped input because it isn't seekable.
+echo "testing detection of Emacs coding tag in piped input" >&2
+printf '.\\" -*- coding: euc-kr; -*-\\n' \
+    | "$preconv" -d 2>&1 >/dev/null \
+    | grep -q "no coding tag"
+
+# We need uchardet to work to get past this point.
+echo "testing uchardet detection of encoding" >&2
+"$preconv" -v | grep -q 'with uchardet support' || exit 77
+
+# Instead of using temporary files, which in all fastidiousness means
+# cleaning them up even if we're interrupted, which in turn means
+# setting up signal handlers, we use files in the build tree.
+
+doc=contrib/mm/groff_mmse.7
+echo "testing uchardet detection on Latin-1 document $doc" >&2
+"$preconv" -d -D us-ascii 2>&1 >/dev/null $doc \
+    | grep -q 'charset: ISO-8859-1'
+
+# uchardet can't seek on a pipe either.
+echo "testing uchardet detection on pipe (expect fallback to -D)" >&2
+printf 'Eat at the caf\351.\n' \
+    | "$preconv" -d -D euc-kr 2>&1 > /dev/null \
+    | grep -q "encoding used: 'EUC-KR'"
+
+# Fall back to the locale.  preconv assumes Latin-1 for C instead of
+# US-ASCII.
+echo "testing fallback to locale setting in environment" >&2
+printf 'Eat at the caf\351.\n' \
+    | "$preconv" -d 2>&1 > /dev/null \
+    | grep -q "encoding used: 'ISO-8859-1'"

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/command.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/command.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -37,7 +36,7 @@
   int get_char();
   int peek_char();
   void skip_char();
-  int get_location(const char **, int *);
+  void get_location(const char **, int *);
 
   friend class input_stack;
 };
@@ -52,7 +51,7 @@
 
 input_item::~input_item()
 {
-  a_delete filename;
+  delete filename;
 }
 
 inline int input_item::peek_char()
@@ -76,7 +75,7 @@
   ptr++;
 }
 
-int input_item::get_location(const char **filenamep, int *linenop)
+void input_item::get_location(const char **filenamep, int *linenop)
 {
   *filenamep = filename;
   if (ptr == buffer.contents())
@@ -87,9 +86,10 @@
     for (const char *p = buffer.contents(); p < e; p++)
       if (*p == '\n')
 	ln++;
+    ln--; // Back up to identify line number _before_ last seen newline.
     *linenop = ln;
   }
-  return 1;
+  return;
 }
 
 class input_stack {
@@ -160,11 +160,11 @@
     }
   }
   string buf;
-  int bol = 1;
+  bool is_at_beginning_of_line = true;
   int lineno = 1;
   for (;;) {
     int c = getc(fp);
-    if (bol && c == '.') {
+    if (is_at_beginning_of_line && c == '.') {
       // replace lines beginning with .R1 or .R2 with a blank line
       c = getc(fp);
       if (c == 'R') {
@@ -192,17 +192,17 @@
     }
     if (c == EOF)
       break;
-    if (invalid_input_char(c))
+    if (is_invalid_input_char(c))
       error_with_file_and_line(fn, lineno,
-			       "invalid input character code %1", int(c));
+			       "invalid input character code %1", c);
     else {
       buf += c;
       if (c == '\n') {
-	bol = 1;
+	is_at_beginning_of_line = true;
 	lineno++;
       }
       else
-	bol = 0;
+	is_at_beginning_of_line = false;
     }
   }
   if (fp != stdin)
@@ -226,11 +226,11 @@
 {
   const char *filename;
   int lineno;
-  for (input_item *it = top; it; it = it->next)
-    if (it->get_location(&filename, &lineno)) {
-      error_with_file_and_line(filename, lineno, format, arg1, arg2, arg3);
-      return;
-    }
+  for (input_item *it = top; it; it = it->next) {
+    it->get_location(&filename, &lineno);
+    error_with_file_and_line(filename, lineno, format, arg1, arg2, arg3);
+    return;
+  }
   ::error(format, arg1, arg2, arg3);
 }
 
@@ -787,22 +787,28 @@
     for (int i = 0; i < argc; i++)
       argvi.s = ptr = strchr(ptr, '\0') + 1;
     execute_command(command.contents(), argc, argv);
-    a_delete argv;
+    delete argv;
     if (res == -1)
       break;
   }
 }
 
-void process_commands(const char *file)
-{
-  input_stack::init();
-  input_stack::push_file(file);
-  command_loop();
-}
-
 void process_commands(string &s, const char *file, int lineno)
 {
+  const char *saved_filename = current_filename;
+  int saved_lineno = current_lineno;
   input_stack::init();
+  current_filename = file;
+  // Report diagnostics with respect to line _before_ last newline seen.
+  current_lineno = lineno - 1;
   input_stack::push_string(s, file, lineno);
   command_loop();
+  current_filename = saved_filename;
+  current_lineno = saved_lineno;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/command.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/command.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/label.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/label.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/label.hpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/label.hpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/label.ypp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/label.ypp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/ref.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/ref.cpp Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
 Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -152,7 +152,7 @@
 reference::~reference()
 {
   if (nfields > 0)
-    ad_delete(nfields) field;
+    delete field;
 }
 
 // ref is the inline, this is the database ref
@@ -175,7 +175,7 @@
       nfields++;
   if (nfields != old_nfields) {
     if (old_nfields > 0)
-      ad_delete(old_nfields) field;
+      delete field;
     field = new stringnfields;
   }
   int j = 0;
@@ -209,7 +209,7 @@
   for (i = pos; i < nfields; i++)
     fieldi + 1.move(old_fieldi);
   if (nfields > 0)
-    ad_delete(nfields) old_field;
+    delete old_field;
   nfields++;
   field_indexc = pos;
   for (i = c + 1; i < 256; i++)
@@ -229,14 +229,14 @@
   for (i = field_indexc; i < nfields - 1; i++)
     fieldi.move(old_fieldi + 1);
   if (nfields > 0)
-    ad_delete(nfields) old_field;
+    delete old_field;
   nfields--;
   field_indexc = NULL_FIELD_INDEX;
   for (i = c + 1; i < 256; i++)
     if (field_indexi != NULL_FIELD_INDEX)
       field_indexi -= 1;
 }
-    
+
 void reference::compute_hash_code()
 {
   if (!rid.is_null())

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/ref.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/ref.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/refer.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/refer.1.man Changed

@@ -1,13 +1,14 @@
-.TH @G@REFER @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@refer \- preprocess bibliographic references for groff
+.TH @g@refer @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@refer \- process bibliographic references for
+.I groff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 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
@@ -25,104 +26,170 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_refer_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@refer
-.OP \-benCPRS
-.OP \-a n
-.OP \-c fields
-.OP \-f n
-.OP \-i fields
-.OP \-k field
-.OP \-l m,n
-.OP \-p filename
-.OP \-s fields
-.OP \-t n
-.BI "\-B " field . macro
-.RI  file
-\&.\|.\|.\&
+.RB  \-bCenPRS 
+.RB  \-a\~\c
+.IR n 
+.RB  \-B
+.IB field . macro\c
+
+.RB  \-c\~\c
+.IR fields 
+.RB  \-f\~\c
+.IR n 
+.RB  \-i\~\c
+.IR fields 
+.RB  \-k\~\c
+.IR field 
+.RB  \-l\~\c
+.IR range-expression 
+.RB  \-p\~\c
+.IR database-file 
+.RB  \-s\~\c
+.IR fields 
+.RB  \-t\~\c
+.IR n 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY @g@refer
 .B \-\-help
 .YS
 .
+.
 .SY @g@refer
 .B \-v
+.
 .SY @g@refer
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This file documents the GNU version of
-.BR refer ,
-which is part of the groff document formatting system.
-.
-.B refer
-copies the contents of
-.IR filename \|.\|.\|.\&
-to the standard output,
-except that lines between
+The GNU implementation of
+.I \%refer \" generic
+is part of the
+.MR groff @MAN1EXT@
+document formatting system.
+.
+.I @g@refer
+is a
+.MR @g@troff @MAN1EXT@
+preprocessor that prepares bibilographic citations by looking up
+keywords specified in a
+.MR roff @MAN7EXT@
+input document,
+obviating the need to type such annotations,
+and permitting the citation style in formatted output to be altered
+independently and systematically.
+.
+It copies the contents of each
+.I file
+to the standard output stream,
+except that it interprets lines between
 .B .
 and
 .B .\&
-are interpreted as citations,
+as citations to be translated into
+.I groff
+input,
 and lines between
 .B .R1
 and
 .B .R2
-are interpreted as commands about how citations are to be processed.
+as instructions regarding how citations are to be processed.
+.
+Normally,
+.I @g@refer
+is not executed directly by the user,
+but invoked by specifying the
+.B \-R
+option to
+.MR groff @MAN1EXT@ .
+.
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+the standard input stream is read.
 .
 .
 .LP
 Each citation specifies a reference.
 .
-The citation can specify a reference that is contained in
-a bibliographic database by giving a set of keywords
-that only that reference contains.
+The citation can specify a reference that is contained in a
+bibliographic database by giving a set of keywords that only that
+reference contains.
 .
-Alternatively it can specify a reference by supplying a database
-record in the citation.
+Alternatively it can specify a reference by supplying a database record
+in the citation.
 .
 A combination of these alternatives is also possible.
 .
 .
 .LP
 For each citation,
-.B refer
+.I @g@refer
 can produce a mark in the text.
 .
-This mark consists of some label which can be separated from
-the text and from other labels in various ways.
+This mark consists of some label which can be separated from the text
+and from other labels in various ways.
 .
 For each reference it also outputs
-.B groff
-commands that can be used by a macro package to produce a formatted
-reference for each citation.
+.MR groff @MAN7EXT@
+language commands that can be used by a macro package to produce a
+formatted reference for each citation.
 .
 The output of
-.B refer
-must therefore be processed using a suitable macro package.
-.
-The
-.B \-ms
-and
-.B \-me
-macros are both suitable.
+.I @g@refer
+must therefore be processed using a suitable macro package,
+such as
+.\" .IR man ,
+.IR me ,
+.IR mm ,
+.IR mom ,
+or
+.IR ms .
 .
-The commands to format a citation's reference can be output immediately after
-the citation,
+The commands to format a citation's reference can be output immediately
+after the citation,
 or the references may be accumulated,
 and the commands output at some later point.
 .
-If the references are accumulated, then multiple citations of the same
-reference will produce a single formatted reference.
+If the references are accumulated,
+then multiple citations of the same reference will produce a single
+formatted reference.
 .
 .
 .LP
@@ -130,27 +197,25 @@
 .B .R1
 and
 .B .R2
-as commands is a new feature of GNU
-.BR refer .
+as prepreocessor commands is a feature of GNU
+.IR \%refer . \" GNU
 .
-Documents making use of this feature can still be processed by
-Unix refer just by adding the lines
+Documents making use of this feature can still be processed by AT&T
+.I \%refer \" AT&T
+just by adding the lines
 .
 .RS
-.LP
-.nf
-.ft B
+.EX
 \&.de R1
 \&.ig R2
 \&..
-.ft
-.fi
+.EE
 .RE
 .
 to the beginning of the document.
 .
 This will cause
-.B troff
+.MR @g@troff @MAN1EXT@
 to ignore everything between
 .B .R1
 and
@@ -158,195 +223,31 @@
 .
 The effect of some commands can also be achieved by options.
 .
-These options are supported mainly for compatibility with Unix refer.
+These options are supported mainly for compatibility with AT&T
+.IR \%refer . \" AT&T
 .
 It is usually more convenient to use commands.
 .
 .
 .LP
-.B refer
+.I @g@refer
 generates
 .B .lf
-lines so that filenames and line numbers in messages produced
-by commands that read
-.B refer
+requests so that file names and line numbers in messages produced by
+commands that read
+.I @g@refer
 output will be correct;
 it also interprets lines beginning with
 .B .lf
-so that filenames and line numbers in the messages and
+so that file names and line numbers in the messages and
 .B .lf
 lines that it produces will be accurate even if the input has been
 preprocessed by a command such as
-.BR @g@soelim (@MAN1EXT@).
+.MR @g@soelim @MAN1EXT@ .
 .
 .
 .\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.LP
-Most options are equivalent to commands
-(for a description of these commands,
-see subsection \(lqCommands\(rq below).
-.
-.
-.nr a \n(.j
-.ad l
-.TP
-.B \-b
-.B "no-label-in-text; no-label-in-reference"
-.
-.
-.TP
-.B \-e
-.B accumulate
-.
-.
-.TP
-.B \-n
-.B no-default-database
-.
-.
-.TP
-.B \-C
-.B compatible
-.
-.
-.TP
-.B \-P
-.B move-punctuation
-.
-.
-.TP
-.B \-S
-.B
-label\ "(A.n|Q)\ ',\ '\ (D.y|D)"; \%bracket-label\ "\ ("\ )\ ";\ "
-.
-.
-.TP
-.BI \-a n
-.B reverse
-.BI A n
-.
-.
-.TP
-.BI \-c fields
-.B capitalize
-.I fields
-.
-.
-.TP
-.BI \-f n
-.B label
-.BI % n
-.
-.
-.TP
-.BI \-i fields
-.B search-ignore
-.I fields
-.
-.
-.TP
-.B \-k
-.B label
-.B L\(ti%a
-.
-.
-.TP
-.BI \-k field
-.B label
-.IB field \(ti%a
-.
-.
-.TP
-.B \-l
-.B label
-.B A.nD.y%a
-.
-.
-.TP
-.BI \-l m
-.B label
-.BI A.n+ m D.y%a
-.
-.
-.TP
-.BI \-l, n
-.B label
-.BI A.nD.y\- n %a
-.
-.
-.TP
-.BI \-l m , n
-.B label
-.BI A.n+ m D.y\- n %a
-.
-.
-.TP
-.BI \-p filename
-.B database
-.I filename
-.
-.
-.TP
-.BI \-s spec
-.B sort
-.I spec
-.
-.
-.TP
-.BI \-t n
-.B search-truncate
-.I n
-.ad \na
-.
-.
-.LP
-These options are equivalent to the following commands with the
-addition that the filenames specified on the command line are
-processed as if they were arguments to the
-.B bibliography
-command instead of in the normal way:
-.
-.
-.TP
-.B \-B
-.B "annotate X AP; no-label-in-reference"
-.
-.
-.TP
-.BI \-B field . macro
-.B annotate
-.I field
-.IB macro ;
-.B no-label-in-reference
-.
-.
-.LP
-The following options have no equivalent commands:
-.
-.
-.TP
-.B \-v
-Print the version number.
-.
-.
-.TP
-.B \-R
-Don't recognize lines beginning with
-.BR .R1 / .R2 .
-.
-.
-.\" ====================================================================
-.SH USAGE
-.\" ====================================================================
-.
-.\" ====================================================================
-.SS Bibliographic databases
+.SS "Bibliographic databases"
 .\" ====================================================================
 .
 The bibliographic database is a text file consisting of records
@@ -373,9 +274,7 @@
 .B %A
 The name of an author.
 .
-If the name contains a title such as
-.B Jr.\&
-at the end,
+If the name contains a suffix such as \lqJr.\&\rq,
 it should be separated from the last name by a comma.
 .
 There can be multiple occurrences of the
@@ -393,7 +292,8 @@
 .
 .TP
 .B %B
-For an article that is part of a book, the title of the book.
+For an article that is part of a book,
+the title of the book.
 .
 .
 .TP
@@ -407,13 +307,15 @@
 .
 The year should be specified in full.
 .
-If the month is specified, the name rather than the number of the month
-should be used, but only the first three letters are required.
+If the month is specified,
+the name rather than the number of the month should be used,
+but only the first three letters are required.
 .
 It is a good idea always to supply a
 .B %D
 field;
-if the date is unknown, a value such as
+if the date is unknown,
+a value such as
 .B in press
 or
 .B unknown
@@ -422,21 +324,22 @@
 .
 .TP
 .B %E
-For an article that is part of a book, the name of an editor of the book.
+For an article that is part of a book,
+the name of an editor of the book.
 .
 Where the work has editors and no authors,
 the names of the editors should be given as
 .B %A
 fields and
-.B ,\ (ed)
+.RB \lq ,\~(ed.)\& \rq
 or
-.B ,\ (eds)
+.RB \lq ,\~(eds.)\& \rq
 should be appended to the last author.
 .
 .
 .TP
 .B %G
-US Government ordering number.
+U.S. government ordering number.
 .
 .
 .TP
@@ -475,13 +378,16 @@
 .TP
 .B %P
 Page number.
+.
 A range of pages can be specified as
-.IB m \- n\fR.
+.IB m \- \c
+.IR n .
 .
 .
 .TP
 .B %Q
-The name of the author, if the author is not a person.
+The name of the author,
+if the author is not a person.
 .
 This will only be used if there are no
 .B %A
@@ -529,34 +435,46 @@
 only the last such field will be used.
 .
 .
-.LP
-If accent strings are used, they should follow the character to be accented.
-This means that the
-.B AM
-macro must be used with the
-.B \-ms
-macros.
+.P
+If accent strings are used,
+they should follow the character to be accented.
+.
+This means that an
+.I ms
+document must call the
+.B .AM
+macro when it initializes.
 .
 Accent strings should not be quoted:
 use one
 .B \e
 rather than two.
 .
+Accent strings are an obsolescent feature of the
+.I me
+and
+.I ms
+macro packages;
+modern documents should use
+.I groff
+special character escape sequences instead;
+see
+.MR groff_char @MAN7EXT@ .
+.
 .
 .\" ====================================================================
 .SS Citations
 .\" ====================================================================
 .
-The format of a citation is
+Citations have a characteristic format.
 .
 .RS
+.EX
 .BI . opening-text
-.br
-.I "flags keywords"
-.br
+.I flags keywords
 .I fields
-.br
 .BI . closing-text
+.EE
 .RE
 .
 .
@@ -582,73 +500,78 @@
 that contains all the words in
 .IR keywords .
 .
-It is an error if more than one reference if found.
+It is an error if more than one reference is found.
 .
 .
 .LP
 The
 .I fields
-components specifies additional fields to replace or supplement
-those specified in the reference.
+components specifies additional fields to replace or supplement those
+specified in the reference.
 .
 When references are being accumulated and the
 .I keywords
 component is non-empty,
-then additional fields should be specified only on the first
-occasion that a particular reference is cited,
+then additional fields should be specified only on the first occasion
+that a particular reference is cited,
 and will apply to all citations of that reference.
 .
 .
+.br
+.ne 2v
 .LP
 The
 .I opening-text
 and
 .I closing-text
-component specifies strings to be used to bracket the label instead
-of the strings specified in the
-.B bracket-label
+components specify strings to be used to bracket the label instead of
+those in the
+.B \%bracket\-label
 command.
 .
 If either of these components is non-empty,
 the strings specified in the
-.B bracket-label
+.B \%bracket\-label
 command will not be used;
-this behaviour can be altered using the
+this behavior can be altered using the
 .B 
 and
 .B 
 flags.
-Note that leading and trailing spaces are significant for these components.
+.
+Leading and trailing spaces are significant for these components.
 .
 .
 .LP
 The
 .I flags
-component is a list of
-non-alphanumeric characters each of which modifies the treatment
-of this particular citation.
+component is a list of non-alphanumeric characters each of which
+modifies the treatment of this particular citation.
 .
-Unix refer will treat these flags as part of the keywords and
-so will ignore them since they are non-alphanumeric.
+AT&T
+.I \%refer \" AT&T
+will treat these flags as part of the keywords and so will ignore them
+since they are non-alphanumeric.
 .
-The following flags are currently recognized:
+The following flags are currently recognized.
 .
 .
 .TP
 .B #
-This says to use the label specified by the
-.B short-label
+Use the label specified by the
+.B \%short\-label
 command,
 instead of that specified by the
-.B label
+.B \%label
 command.
 .
-If no short label has been specified, the normal label will be used.
+If no short label has been specified,
+the normal label will be used.
 .
-Typically the short label is used with author-date labels
-and consists of only the date and possibly a disambiguating letter;
+Typically the short label is used with author-date labels and consists
+of only the date and possibly a disambiguating letter;
 the
-.B #
+.RB \lq # \rq
 is supposed to be suggestive of a numeric type of label.
 .
 .
@@ -657,7 +580,7 @@
 Precede
 .I opening-text
 with the first string specified in the
-.B bracket-label
+.B \%bracket\-label
 command.
 .
 .
@@ -666,12 +589,12 @@
 Follow
 .I closing-text
 with the second string specified in the
-.B bracket-label
+.B \%bracket\-label
 command.
 .
 .
 .LP
-One advantages of using the
+An advantage of using the
 .B 
 and
 .B 
@@ -680,12 +603,14 @@
 and
 .I closing-text
 is that
-you can change the style of bracket used in the document just by changing the
-.B bracket-label
+.
+you can change the style of bracket used in the document just by
+changing the
+.B \%bracket\-label
 command.
 .
-Another advantage is that sorting and merging of citations
-will not necessarily be inhibited if the flags are used.
+Another is that sorting and merging of citations will not necessarily be
+inhibited if the flags are used.
 .
 .
 .LP
@@ -694,14 +619,18 @@
 .B .
 line.
 .
-If there is no such line, then an extra line will be inserted before the
+If there is no such line,
+then an extra line will be inserted before the
 .B .
 line and a warning will be given.
 .
 .
 .LP
-There is no special notation for making a citation to multiple references.
-Just use a sequence of citations, one for each reference.
+There is no special notation for making a citation to multiple
+references.
+.
+Just use a sequence of citations,
+one for each reference.
 .
 Don't put anything between the citations.
 .
@@ -712,11 +641,13 @@
 .
 See the description of the
 .B <>
-label expression, and of the
-.B sort-adjacent-labels
+label expression,
+and of the
+.B \%sort\-adjacent\-labels
 and
-.B abbreviate-label-ranges
-command.
+.B \%abbreviate\-label\-ranges
+commands.
+.
 A label will not be merged if its citation has a non-empty
 .I opening-text
 or
@@ -738,9 +669,11 @@
 .I closing-text
 is non-empty.
 .
-(If you wish to prevent this just make the first citation's
-.I closing-text
-.BR \e& .)
+(If you wish to prevent this,
+use the dummy character escape sequence
+.B \rs&
+as the first citation's
+.IR closing-text .)
 .
 .
 .\" ====================================================================
@@ -765,63 +698,53 @@
 nor
 .B .R2
 lines,
-nor anything between them
+nor anything between them,
 is output.
 .
 .
-.LP
-Commands are separated by newlines or
-.BR ; s.
-.B #
-introduces a comment that extends to the end of the line
-(but does not conceal the newline).
+.P
+Commands are separated by newlines or semicolons.
+.
+A number sign
+.RB ( # )
+introduces a comment that extends to the end of the line,
+but does not conceal the newline.
 .
 Each command is broken up into words.
 .
 Words are separated by spaces or tabs.
 .
-A word that begins with
-.B \dq
-extends to the next
-.B \dq
-that is not followed by another
-.BR \dq .
+A word that begins with a (neutral) double quote
+.RB ( \dq )
+extends to the next double quote that is not followed by another double
+quote.
 .
-If there is no such
-.B \dq
+If there is no such double quote,
 the word extends to the end of the line.
 .
-Pairs of
-.B \dq
-in a word beginning with
-.B \dq
-collapse to a single
-.BR \dq .
+Pairs of double quotes in a word beginning with a double quote collapse
+to one double quote.
 .
-Neither
-.B #
-nor
-.B ;
-are recognized inside
-.BR \dq s.
+Neither a number sign nor a semicolon is recognized inside double
+quotes.
 .
-A line can be continued by ending it with
-.BR \e ;
-this works everywhere except after a
-.BR # .
+A line can be continued by ending it with a backslash
+.RB \lq \rs \rq;
+this works everywhere except after a number sign.
 .
 .
 .LP
-.ds n \fR*
+.ds n \fR*\fP\"
 Each command
 .I name
 that is marked with \*n has an associated negative command
-.BI no- name
+.BI no\- name
 that undoes the effect of
 .IR name .
 .
-For example, the
-.B no-sort
+For example,
+the
+.B no\-sort
 command specifies that references should not be sorted.
 .
 The negative commands take no arguments.
@@ -839,12 +762,12 @@
 are used for a non-negative numbers;
 .I string
 is used for an arbitrary string;
-.I filename
+.I file
 is used for the name of a file.
 .
 .
 .TP
-.BI abbreviate\*n\  fields\ string1\ string2\ string3\ string4
+.BI abbreviate\*n\~ fields\~string1\~string2\~string3\~string4
 Abbreviate the first names of
 .IR fields .
 .
@@ -853,10 +776,7 @@
 from the last name by
 .IR string2 ,
 and from anything else
-(such as a
-.B von
-or
-.BR de )
+(such as \lqvon\rq or \lqde\rq)
 by
 .IR string3 .
 .
@@ -875,20 +795,21 @@
 .
 .
 .TP
-.BI abbreviate-label-ranges\*n\  string
+.BI abbreviate\-label\-ranges\*n\~ string
 .
 Three or more adjacent labels that refer to consecutive references
 will be abbreviated to a label consisting of the first label,
 followed by
-.I string
+.IR string ,
 followed by the last label.
 .
 This is mainly useful with numeric labels.
 .
 If
 .I string
-is omitted it defaults to
-.BR \- .
+is omitted,
+it defaults to
+.RB \lq \- \rq.
 .
 .
 .TP
@@ -900,25 +821,24 @@
 of the form
 .
 .RS
-.IP
+.RS
+.EX
 .B .
-.br
 .B $LIST$
-.br
 .B .
+.EE
+.RE
 .
-.
-.LP
 is encountered,
 after all input files have been processed,
-and whenever
+and whenever a
 .B .R1
 line is recognized.
 .RE
 .
 .
 .TP
-.BI annotate\*n\  field\ string
+.BI annotate\*n\~ "field string"
 .I field
 is an annotation;
 print it at the end of the reference as a paragraph preceded by the line
@@ -931,7 +851,8 @@
 .LP
 If
 .I string
-is omitted it will default to
+is omitted,
+it will default to
 .BR AP ;
 if
 .I field
@@ -943,35 +864,38 @@
 .
 .
 .TP
-.BI articles\  string \fR\|.\|.\|.
-.IR string \|.\|.\|.\&
-are definite or indefinite articles, and should be ignored at the beginning of
+.BI articles\~ string\~\c
+\&.\|.\|.
+Each
+.I string
+is a definite or indefinite article,
+and should be ignored at the beginning of
 .B T
 fields when sorting.
 .
 Initially,
-.BR the ,
-.B a
+\lqa\rq,
+\lqan\rq,
 and
-.B an
-are recognized as articles.
+\lqthe\rq are recognized as articles.
 .
 .
 .TP
-.BI bibliography\  filename \fR\|.\|.\|.
+.BI bibliography\~ file\~\c
+\&.\|.\|.
 .
-Write out all the references contained in the bibliographic databases
-.IR filename \|.\|.\|.
+Write out all the references contained in each bibliographic database
+.IR file .
 .
-This command should come last in a
+This command should come last in an
 .BR .R1 / .R2
 block.
 .
 .
 .TP
-.BI bracket-label\  string1\ string2\ string3
-In the text, bracket each label
-with
+.BI bracket\-label\~ "string1 string2 string3"
+In the text,
+bracket each label with
 .I string1
 and
 .IR string2 .
@@ -983,17 +907,19 @@
 will be turned into
 .IR string3 .
 .
-The default behaviour is
+The default behavior is as follows.
 .
+.RS \" RS twice to get inboard of the tagged paragraph indentation.
 .RS
-.IP
-.B
-bracket-label \e*(. \e*(. ", "
+.EX
+.B bracket\-label \e*(. \e*(. \dq, \dq
+.EE
+.RE
 .RE
 .
 .
 .TP
-.BI capitalize\  fields
+.BI capitalize\~ fields
 Convert
 .I fields
 to caps and small caps.
@@ -1009,28 +935,30 @@
 .
 .
 .TP
-.BI database\  filename \fR\|.\|.\|.
-Search the bibliographic databases
-.IR filename \|.\|.\|.
+.BI database\~ file\~\c
+\&.\|.\|.
+Search each bibliographic database
+.IR file .
 .
 For each
-.I filename
+.IR file ,
 if an index
-.IB filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
-.BR @g@indxbib (@MAN1EXT@)
-exists, then it will be searched instead;
+.MR @g@indxbib @MAN1EXT@
+exists,
+then it will be searched instead;
 each index can cover multiple databases.
 .
 .
 .TP
-.BI date-as-label\*n\  string
+.BI date\-as\-label\*n\~ string
 .I string
 is a label expression that specifies a string with which to replace the
 .B D
 field after constructing the label.
 .
-See subsection \(lqLabel expressions\(rq below for a description of
+See subsection \lqLabel expressions\rq below for a description of
 label expressions.
 .
 This command is useful if you do not want explicit labels in the
@@ -1042,16 +970,18 @@
 author and date.
 .
 In most cases you should also use the
-.B no-label-in-reference
+.B \%no\-label\-in\-reference
 command.
+.
 For example,
 .
+.RS \" RS twice to get inboard of the tagged paragraph indentation.
 .RS
-.IP
-.B "date-as-label D.+yD.y%a*D.-y"
-.
+.EX
+.B date\-as\-label D.+yD.y%a*D.\-y
+.EE
+.RE
 .
-.LP
 would attach a disambiguating letter to the year part of the
 .B D
 field in the reference.
@@ -1059,24 +989,24 @@
 .
 .
 .TP
-.B default-database\*n
+.B default\-database\*n
 The default database should be searched.
 .
-This is the default behaviour,
+This is the default behavior,
 so the negative version of this command is more useful.
 .
-.B refer
+.I @g@refer
 determines whether the default database should be searched
 on the first occasion that it needs to do a search.
 .
 Thus a
-.B no-default-database
+.B \%no\-default\-database
 command must be given before then,
 in order to be effective.
 .
 .
 .TP
-.BI discard\*n\  fields
+.BI discard\*n\~ fields
 When the reference is read,
 .I fields
 should be discarded;
@@ -1091,15 +1021,15 @@
 .
 .
 .TP
-.BI et-al\*n\  string\ m\ n
+.BI et\-al\*n\~ "string m n"
 Control use of
-.B "et al"
+.B et al.\&
 in the evaluation of
 .B @
 expressions in label expressions.
 .
-If the number of authors needed to make the author sequence
-unambiguous is
+If the number of authors needed to make the author sequence unambiguous
+is
 .I u
 and the total number of authors is
 .I t
@@ -1116,27 +1046,42 @@
 is not less than
 .IR n .
 .
-The default behaviour is
+The default behavior is as follows.
 .
+.RS \" RS twice to get inboard of the tagged paragraph indentation.
 .RS
-.IP
-.B
-et-al " et al" 2 3
+.EX
+.B et\-al \dq et al\dq 2 3
+.EE
+.RE
+.
+Note the absence of a dot from the end of the abbreviation,
+which is arguably not correct.
+.
+.RI ( "Et al" .
+is short for
+.IR "et alli" ,
+as
+.I etc.\&
+is short for
+.IR "et cetera".)
 .RE
 .
 .
 .TP
-.BI include\  filename
+.BI include\~ file
 Include
-.I filename
+.I file
 and interpret the contents as commands.
 .
 .
 .TP
-.BI join-authors\  string1\ string2\ string3
-This says how authors should be joined together.
+.BI join\-authors\~ "string1 string2 string3"
+Join multiple authors together with
+.IR string s.
 .
-When there are exactly two authors, they will be joined with
+When there are exactly two authors,
+they will be joined with
 .IR string1 .
 .
 When there are more than two authors,
@@ -1158,49 +1103,50 @@
 For example,
 .
 .RS
-.IP
-.B
-join-authors " and " ", " ", and "
-.
+.RS
+.EX
+join\-authors \dq and \dq \dq, \dq \dq, and \dq
+.EE
+.RE
 .
-.LP
 will restore the default method for joining authors.
 .RE
 .
 .
 .TP
-.B label-in-reference\*n
+.B label\-in\-reference\*n
 When outputting the reference,
 define the string
 .B F
 to be the reference's label.
 .
-This is the default behaviour; so the negative version
-of this command is more useful.
+This is the default behavior,
+so the negative version of this command is more useful.
 .
 .
 .TP
-.B label-in-text\*n
+.B label\-in\-text\*n
 For each reference output a label in the text.
 .
-The label will be separated from the surrounding text as described in the
-.B bracket-label
+The label will be separated from the surrounding text as described in
+the
+.B \%bracket\-label
 command.
 .
-This is the default behaviour; so the negative version
-of this command is more useful.
+This is the default behavior,
+so the negative version of this command is more useful.
 .
 .
 .TP
-.BI label\  string
+.BI label\~ string
 .I string
 is a label expression describing how to label each reference.
 .
 .
 .TP
-.BI separate-label-second-parts\  string
-When merging two-part labels, separate the second part of the second
-label from the first label with
+.BI separate\-label\-second\-parts\~ string
+When merging two-part labels,
+separate the second part of the second label from the first label with
 .IR string .
 .
 See the description of the
@@ -1209,7 +1155,7 @@
 .
 .
 .TP
-.B move-punctuation\*n
+.B move\-punctuation\*n
 In the text,
 move any punctuation at the end of line past the label.
 .
@@ -1218,30 +1164,32 @@
 .
 .
 .TP
-.BI reverse\*n\  string
+.BI reverse\*n\~ string
 Reverse the fields whose names
 are in
 .IR string .
 .
-Each field name can be followed by a number which says
-how many such fields should be reversed.
+Each field name can be followed by a number which says how many such
+fields should be reversed.
 .
-If no number is given for a field, all such fields will be reversed.
+If no number is given for a field,
+all such fields will be reversed.
 .
 .
 .TP
-.BI search-ignore\*n\  fields
+.BI search\-ignore\*n\~ fields
 While searching for keys in databases for which no index exists,
 ignore the contents of
 .IR fields .
 .
-Initially, fields
+Initially,
+fields
 .B XYZ
 are ignored.
 .
 .
 .TP
-.BI search-truncate\*n\  n
+.BI search\-truncate\*n\~ n
 Only require the first
 .I n
 characters of keys to be given.
@@ -1251,35 +1199,37 @@
 .I n
 and the length of the key.
 .
-Initially
+Initially,
 .I n
-is\ 6.
+is\~6.
 .
 .
 .TP
-.BI short-label\*n\  string
+.BI short\-label\*n\~ string
 .I string
-is a label expression that specifies an alternative (usually shorter)
+is a label expression that specifies an alternative
+(usually shorter)
 style of label.
 .
 This is used when the
 .B #
 flag is given in the citation.
 .
-When using author-date style labels, the identity of the author
-or authors is sometimes clear from the context, and so it
-may be desirable to omit the author or authors from the label.
+When using author-date style labels,
+the identity of the author or authors is sometimes clear from the
+context,
+and so it may be desirable to omit the author or authors from the label.
 .
 The
-.B short-label
+.B \%short\-label
 command will typically be used to specify a label containing just
 a date and possibly a disambiguating letter.
 .
 .
 .TP
-.BI sort\*n\  string
+.BI sort\*n\~ string
 Sort references according to
-.BR string .
+.IR string .
 .
 References will automatically be accumulated.
 .
@@ -1288,25 +1238,26 @@
 each followed by a number,
 indicating how many fields with the name should be used for sorting.
 .
-.B +
-can be used to indicate that all the fields with the name should be used.
+.RB \lq + \rq
+can be used to indicate that all the fields with the name should be
+used.
 .
 Also
 .B .\&
 can be used to indicate the references should be sorted using the
 (tentative) label.
 .
-(Subsection \(lqLabel expressions\(rq below describes the concept of a
+(Subsection \lqLabel expressions\rq below describes the concept of a
 tentative label.)
 .
 .
 .TP
-.B sort-adjacent-labels\*n
+.B sort\-adjacent\-labels\*n
 Sort labels that are adjacent in the text according to their position
 in the reference list.
 .
 This command should usually be given if the
-.B abbreviate-label-ranges
+.B \%abbreviate\-label\-ranges
 command has been given,
 or if the label expression contains a
 .B <>
@@ -1316,26 +1267,27 @@
 .
 .
 .\" ====================================================================
-.SS Label expressions
+.SS "Label expressions"
 .\" ====================================================================
 .
 Label expressions can be evaluated both normally and tentatively.
 .
 The result of normal evaluation is used for output.
 .
-The result of tentative evaluation, called the
+The result of tentative evaluation,
+called the
 .IR "tentative label" ,
 is used to gather the information that normal evaluation needs to
 disambiguate the label.
 .
 Label expressions specified by the
-.B date-as-label
+.B \%date\-as\-label
 and
-.B short-label
+.B \%short\-label
 commands are not evaluated tentatively.
 .
-Normal and tentative evaluation are the same for all types of
-expression other than
+Normal and tentative evaluation are the same for all types of expression
+other than
 .BR @ ,
 .BR * ,
 and
@@ -1349,7 +1301,7 @@
 .TP
 .I field
 .TQ
-.I field\ n
+.I field\~n
 The
 .IR n -th
 part of
@@ -1357,11 +1309,12 @@
 .
 If
 .I n
-is omitted, it defaults to\ 1.
+is omitted,
+it defaults to\~1.
 .
 .
 .TP
-.BI ' string '
+.BI \aq string \aq
 The characters in
 .I string
 literally.
@@ -1370,15 +1323,17 @@
 .TP
 .B @
 All the authors joined as specified by the
-.B join-authors
+.B \%join\-authors
 command.
 .
 The whole of each author's name will be used.
 .
-However, if the references are sorted by author (that is the sort
-specification starts with
-.BR A+ ),
-then authors last names will be used instead,
+However,
+if the references are sorted by author
+(that is,
+the sort specification starts with
+.RB \lq A+ \rq),
+then authors' last names will be used instead,
 provided that this does not introduce ambiguity,
 and also an initial subsequence of the authors may be used instead of
 all the authors,
@@ -1404,9 +1359,9 @@
 some other sequence of authors which also has that subsequence as a
 proper initial subsequence.
 .
-When an initial subsequence of authors is used, the remaining authors
-are replaced by the string specified by the
-.B et-al
+When an initial subsequence of authors is used,
+the remaining authors are replaced by the string specified by the
+.B \%et\-al
 command;
 this command may also specify additional requirements that must be
 met before an initial subsequence can be used.
@@ -1430,7 +1385,7 @@
 The serial number of the reference formatted according to the
 character following the
 .BR % .
-The serial number of a reference is\ 1 plus the number of earlier
+The serial number of a reference is\~1 plus the number of earlier
 references with same tentative label as this reference.
 .
 These expressions tentatively evaluate to an empty string.
@@ -1458,8 +1413,10 @@
 upper or lower case letters or digits of
 .IR expr .
 .
-Troff special characters (such as
-.BR \e('a )
+.I roff
+special characters
+(such as
+.BR \e(\aqa )
 count as a single letter.
 .
 Accent strings are retained but do not count towards the total.
@@ -1494,8 +1451,8 @@
 .I expr
 with first names abbreviated.
 .
-Note that fields specified in the
-.B abbreviate
+Fields specified in the
+.B \%abbreviate
 command are abbreviated before any labels are evaluated.
 .
 Thus
@@ -1537,7 +1494,7 @@
 .
 .
 .TP
-.IB expr1 \(ti expr2
+.IB expr1 \ti expr2
 .I expr1
 except that if the last character of
 .I expr1
@@ -1548,7 +1505,7 @@
 .
 .
 .TP
-.I expr1\ expr2
+.I expr1 expr2
 The concatenation of
 .I expr1
 and
@@ -1588,22 +1545,24 @@
 .
 .TP
 .BI < expr >
-The label is in two parts, which are separated by
+The label is in two parts,
+which are separated by
 .IR expr .
 .
 Two adjacent two-part labels which have the same first part will be
 merged by appending the second part of the second label onto the first
 label separated by the string specified in the
-.B separate-label-second-parts
-command (initially,
+.B \%separate\-label\-second\-parts
+command
+(initially,
 a comma followed by a space);
 the resulting label will also be a two-part label with the same first
 part as before merging,
 and so additional labels can be merged into it.
 .
-Note that it is permissible for the first part to be empty;
-this maybe desirable for expressions used in the
-.B short-label
+It is permissible for the first part to be empty;
+this may be desirable for expressions used in the
+.B \%short\-label
 command.
 .
 .
@@ -1625,17 +1584,17 @@
 .
 .
 .\" ====================================================================
-.SS Macro interface
+.SS "Macro interface"
 .\" ====================================================================
 .
 Each reference starts with a call to the macro
-.BR - .
+.BR \- .
 .
 The string
 .B F
 will be defined to be the label for this reference,
 unless the
-.B no-label-in-reference
+.B \%no\-label\-in\-reference
 command has been given.
 .
 There then follows a series of string definitions,
@@ -1645,9 +1604,9 @@
 corresponds to field
 .IR X .
 .
-The number register
+The register
 .B P
-is set to\ 1 if the
+is set to\~1 if the
 .B P
 field contains a range of pages.
 .
@@ -1656,17 +1615,18 @@
 .B A
 and
 .B O
-number registers are set to\ 1 according as the
+registers are set to\~1 according as the
 .BR T ,
 .B A
 and
 .B O
-fields end with one of the characters
-.BR .?! .
+fields end with any of
+.B .?!\&
+(an end-of-sentence character).
 .
 The
 .B E
-number register will be set to\ 1 if the
+register will be set to\~1 if the
 .B E
 string contains more than one name.
 .
@@ -1679,30 +1639,32 @@
 .
 If a reference contains a
 .B J
-field, it will be classified as type\ 1,
+field,
+it will be classified as type\~1,
 otherwise if it contains a
 .B B
-field, it will type\ 3,
+field,
+it will be type\~3,
 otherwise if it contains a
 .B G
 or
 .B R
-field it will be type\ 4,
+field it will be type\~4,
 otherwise if it contains an
 .B I
-field it will be type\ 2,
-otherwise it will be type\ 0.
+field it will be type\~2,
+otherwise it will be type\~0.
 .
 The second argument is a symbolic name for the type:
 .BR other ,
-.BR journal-article ,
+.BR \%journal\-article ,
 .BR book ,
-.B article-in-book
+.BR \%article\-in\-book ,
 or
-.BR tech-report .
+.BR \%tech\-report .
 .
 Groups of references that have been accumulated or are produced by the
-.B bibliography
+.B \%bibliography
 command are preceded by a call to the
 .B <
 macro and followed by a call to the
@@ -1710,50 +1672,213 @@
 macro.
 .
 .
+.br
+.ne 4v
 .\" ====================================================================
-.SH FILES
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
 .TP
-.I @DEFAULT_INDEX@
-Default database.
+.B \-R
+Don't recognize lines beginning with
+.BR .R1 / .R2 .
+.
+.
+.P
+Other options are equivalent to
+.I @g@refer
+commands.
+.
+.
+.TP 16n
+.BI \-a\~ n
+.B reverse
+.BI A n
 .
 .
 .TP
-.RI file @INDEX_SUFFIX@
-Index files.
+.B \-b
+.B "\%no\-label\-in\-text; \%no\-label\-in\-reference"
 .
 .
-.LP
-.B refer
-uses temporary files.
+.TP
+.B \-B
+See below.
 .
-See the
-.BR groff (@MAN1EXT@)
-man page for details where such files are created.
+.
+.TP
+.BI \-c\~ fields
+.B capitalize
+.I fields
+.
+.
+.TP
+.B \-C
+.B compatible
+.
+.
+.TP
+.B \-e
+.B accumulate
+.
+.
+.TP
+.BI \-f\~ n
+.B \%label
+.BI % n
+.
+.
+.TP
+.BI \-i\~ fields
+.B search\-ignore
+.I fields
+.
+.
+.TP
+.B \-k
+.B \%label
+.B L\ti%a
+.
+.
+.TP
+.BI \-k\~ field
+.B \%label
+.IB field \ti%a
+.
+.
+.TP
+.B \-l
+.B \%label
+.B A.nD.y%a
+.
+.
+.TP
+.BI \-l\~ m
+.B \%label
+.BI A.n+ m D.y%a
+.
+.
+.TP
+.BI \-l\~, n
+.B \%label
+.BI A.nD.y\- n %a
+.
+.
+.TP
+.BI \-l\~ m , n
+.B \%label
+.BI A.n+ m D.y\- n %a
+.
+.
+.TP
+.B \-n
+.B \%no\-default\-database
+.
+.
+.TP
+.BI \-p\~ db-file
+.B database
+.I db-file
+.
+.
+.TP
+.B \-P
+.B move\-punctuation
+.
+.
+.TP
+.BI \-s\~ spec
+.B sort
+.I spec
+.
+.
+.TP
+.B \-S
+.B \%label \dq(A.n|Q) \aq, \aq (D.y|D)\dq; \
+\%bracket-\%label \dq\~(\dq\~)\~\dq;\~\dq
+.
+.
+.TP
+.BI \-t\~ n
+.B search\-truncate
+.I n
+.
+.
+.P
+The
+.B B
+option has command equivalents with the addition that the file names
+specified on the command line are processed as if they were arguments to
+the
+.B \%bibliography
+command instead of in the normal way.
+.
+.
+.TP 16n
+.B \-B
+.B "annotate X AP; \%no\-label\-in\-reference"
+.
+.
+.TP
+.BI \-B\~ field . macro
+.B annotate
+.I field
+.IB macro ;
+.B \%no\-label\-in\-reference
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
 .I REFER
-If set, overrides the default database.
+If set,
+overrides the default database.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH Files
 .\" ====================================================================
 .
-.BR @g@indxbib (@MAN1EXT@),
-.BR @g@lookbib (@MAN1EXT@),
-.BR lkbib (@MAN1EXT@)
-.br
+.TP
+.I @DEFAULT_INDEX@
+Default database.
+.
+.
+.TP
+.RI file @INDEX_SUFFIX@
+Index files.
+.
+.
+.TP
+.I @MACRODIR@/\:refer\:.tmac
+defines macros and strings facilitating integration with macro packages
+that wish to support
+.IR @g@refer .
+.
+.
+.LP
+.I @g@refer
+uses temporary files.
+.
+See the
+.MR groff @MAN1EXT@
+man page for details of where such files are created.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
 .
 In label expressions,
@@ -1763,7 +1888,133 @@
 expressions.
 .
 .
+.\" ====================================================================
+.SH Examples
+.\" ====================================================================
+.
+We can illustrate the operation of
+.I @g@refer
+with a sample bibliographic database containing one entry and a simple
+.I roff
+document to cite that entry.
+.
+.
+.P
+.RS
+.EX
+$ \c
+.B cat > my\-db\-file
+.B %A Daniel P.\rs& Friedman
+.B %A Matthias Felleisen
+.B %C Cambridge, Massachusetts
+.B %D 1996
+.B %I The MIT Press
+.B %T The Little Schemer, Fourth Edition
+$ \c
+.B refer -p my\-db\-file
+.B Read the book
+.B .
+.B friedman
+.B .
+.B on your summer vacation.
+.I <Control+D>
+\&.lf 1 \-
+Read the book\rs*(.1\rs*(.
+\&.ds F 1
+\&.\-
+\&.ds A Daniel P. Friedman and Matthias Felleisen
+\&.ds C Cambridge, Massachusetts
+\&.ds D 1996
+\&.ds I The MIT Press
+\&.ds T The Little Schemer, Fourth Edition
+\&.nr T 0
+\&.nr A 0
+\&. 2 book
+\&.lf 5 \-
+on your summer vacation.
+.EE
+.RE
+.
+.
+.P
+The foregoing shows us that
+.I @g@refer
+(a) produces a label \lq1\rq;
+(b) brackets that label with interpolations of the
+.RB \lq . \rq
+and
+.RB \lq . \rq
+strings;
+(c) calls a macro
+.RB \lq \- \rq;
+(d) defines strings and registers containing the label and bibliographic
+data for the reference;
+(e) calls a macro
+.RB \lq  \rq;
+and (f) uses the
+.B lf
+request to restore the line numbers of the original input.
+.
+As discussed in subsection \lqMacro interface\rq above,
+it is up to the document or a macro package to employ and format this
+information usefully.
+.
+Let us see how we might turn
+.MR groff_ms @MAN7EXT@
+to this task.
+.
+.
+.P
+.RS
+.EX
+$ \c
+.B REFER=my\-db\-file groff \-R \-ms
+.B .LP
+.B Read the book
+.B .
+.B friedman
+.B .
+.B on your summer vacation.
+.B Commentary is available.\rs*{*\rs*}
+.B .FS \rs*{*\rs*}
+.B Space reserved for penetrating insight.
+.B .FE
+.EE
+.RE
+.
+.
+.LP
+.IR ms 's
+automatic footnote numbering mechanism is not aware of
+.IR @g@refer 's
+label numbering,
+so we have manually specified a (superscripted) symbolic footnote for
+our non-bibliographic aside.
+.
+.
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
+.
+\lqSome Applications of Inverted Indexes on the Unix System\rq,
+by M.\& E.\& Lesk,
+1978,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
+.
+.
+.LP
+.MR @g@indxbib @MAN1EXT@ ,
+.MR @g@lookbib @MAN1EXT@ ,
+.MR lkbib @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_refer_1_man_C
+.do rr *groff_refer_1_man_C
+.
+.
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/refer.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/refer.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -9,8 +7,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -30,22 +28,34 @@
   src/preproc/refer/ref.h \
   src/preproc/refer/token.h \
   src/preproc/refer/command.h
+
 PREFIXMAN1 += src/preproc/refer/refer.1
-EXTRA_DIST += src/preproc/refer/TODO src/preproc/refer/refer.1.man
-CLEANFILES += \
-  src/preproc/refer/label.cpp \
-  src/preproc/refer/label.hpp \
-  src/preproc/refer/label.output
-# As refer_CPPFLAGS was set, all the .o have a 'refer-' prefix
+EXTRA_DIST += \
+  src/preproc/refer/TODO \
+  src/preproc/refer/refer.1.man
+
+# Since refer_CPPFLAGS was set, all .o files have a 'refer-' prefix.
 src/preproc/refer/refer-command.$(OBJEXT): defs.h
 src/preproc/refer/refer-ref.$(OBJEXT): defs.h
 src/preproc/refer/refer-refer.$(OBJEXT): defs.h
 src/preproc/refer/refer-token.$(OBJEXT): defs.h
 src/preproc/refer/refer-label.$(OBJEXT): defs.h
 
+MAINTAINERCLEANFILES += \
+  src/preproc/refer/label.cpp \
+  src/preproc/refer/label.hpp \
+  src/preproc/refer/label.output
+
+refer_TESTS = \
+  src/preproc/refer/tests/report-correct-line-numbers.sh
+TESTS += $(refer_TESTS)
+EXTRA_DIST += \
+  $(refer_TESTS) \
+  src/preproc/refer/tests/artifacts/62124.bib
+
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/refer.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/refer.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -77,7 +76,7 @@
 
 int short_label_flag = 0;
 
-static int recognize_R1_R2 = 1;
+static bool recognize_R1_R2 = true;
 
 search_list database_list;
 int search_default = 1;
@@ -104,7 +103,8 @@
 static void usage(FILE *stream);
 static void do_file(const char *);
 static void split_punct(string &line, string &punct);
-static void output_citation_group(reference **v, int n, label_type, FILE *fp);
+static void output_citation_group(reference **v, int n, label_type,
+				  FILE *fp);
 static void possibly_load_default_database();
 
 int main(int argc, char **argv)
@@ -117,11 +117,12 @@
   int bib_flag = 0;
   int done_spec = 0;
 
+  // TODO: Migrate to getopt_long; see, e.g., src/preproc/eqn/main.cpp.
   for (--argc, ++argv;
        !finished_options && argc > 0 && argv00 == '-'
        && argv01 != '\0';
        argv++, argc--) {
-    const char *opt = argv0 + 1; 
+    const char *opt = argv0 + 1;
     while (opt != 0 && *opt != '\0') {
       switch (*opt) {
       case 'C':
@@ -148,7 +149,7 @@
 	opt++;
 	break;
       case 'R':
-	recognize_R1_R2 = 0;
+	recognize_R1_R2 = false;
 	opt++;
 	break;
       case 'S':
@@ -161,7 +162,7 @@
 	opt++;
 	break;
       case 'V':
-	verify_flag = 1;
+	do_verify = true;
 	opt++;
 	break;
       case 'f':
@@ -173,7 +174,7 @@
 	      --argc;
 	    }
 	    else {
-	      error("option 'f' requires an argument");
+	      error("'f' option requires an argument");
 	      usage(stderr);
 	      exit(1);
 	    }
@@ -185,7 +186,8 @@
 	  const char *ptr;
 	  for (ptr = num; *ptr; ptr++)
 	    if (!csdigit(*ptr)) {
-	      error("bad character '%1' in argument to -f option", *ptr);
+	      error("invalid character '%1' in argument to 'f' option",
+		    *ptr);
 	      break;
 	    }
 	  if (*ptr == '\0') {
@@ -218,7 +220,8 @@
 	    buf0 = *opt++;
 	  else {
 	    if (*opt != '\0')
-	      error("bad field name '%1'", *opt++);
+	      error("invalid field name '%1' in argument to 'k' option",
+		    *opt++);
 	    buf0 = 'L';
 	  }
 	  buf1 = '~';
@@ -234,7 +237,7 @@
 	  const char *ptr;
 	  for (ptr = ++opt; *ptr; ptr++)
 	    if (!csdigit(*ptr)) {
-	      error("argument to 'a' option not a number");
+	      error("'a' option argument must be an integer");
 	      break;
 	    }
 	  if (*ptr == '\0') {
@@ -256,7 +259,7 @@
 	    char *ptr;
 	    long n = strtol(opt, &ptr, 10);
 	    if (n == 0 && ptr == opt) {
-	      error("bad integer '%1' in 'l' option", opt);
+	      error("invalid integer '%1' in 'l' option argument", opt);
 	      opt = 0;
 	      break;
 	    }
@@ -272,7 +275,7 @@
 	    char *ptr;
 	    long n = strtol(opt, &ptr, 10);
 	    if (n == 0 && ptr == opt) {
-	      error("bad integer '%1' in 'l' option", opt);
+	      error("invalid integer '%1' in 'l' option argument", opt);
 	      opt = 0;
 	      break;
 	    }
@@ -285,7 +288,7 @@
 	  }
 	  strcat(buf, "%a");
 	  if (!set_label_spec(buf))
-	    assert(0);
+	    assert(0 == "set_label_spec() failed");
 	  done_spec = 1;
 	}
 	break;
@@ -328,7 +331,7 @@
 	  char *ptr;
 	  long n = strtol(opt, &ptr, 10);
 	  if (n == 0 && ptr == opt) {
-	    error("bad integer '%1' in 't' option", opt);
+	    error("invalid integer '%1' in 't' option argument", opt);
 	    opt = 0;
 	    break;
 	  }
@@ -344,20 +347,20 @@
 	  opt++;
 	  break;
 	}
-	if (strcmp(opt,"-version")==0) {
+	if (strcmp(opt, "-version") == 0) {
       case 'v':
 	  printf("GNU refer (groff) version %s\n", Version_string);
 	  exit(0);
 	  break;
 	}
-	if (strcmp(opt,"-help")==0) {
+	if (strcmp(opt, "-help") == 0) {
 	  usage(stdout);
 	  exit(0);
 	  break;
 	}
 	// fall through
       default:
-	error("unrecognized option '%1'", *opt);
+	error("unrecognized option '%1'", opt);
 	usage(stderr);
 	exit(1);
 	break;
@@ -383,16 +386,18 @@
   if (accumulate)
     output_references();
   if (fflush(stdout) < 0)
-    fatal("output error");
+    fatal("output error: %1", strerror(errno));
   return 0;
 }
 
 static void usage(FILE *stream)
 {
   fprintf(stream,
-"usage: %s -benvCPRS -aN -cXYZ -fN -iXYZ -kX -lM,N -p file\n"
-"       -sXYZ -tN -BL.M files ...\n",
-	  program_name);
+"usage: %s -bCenPRS -aN -cXYZ -fN -iXYZ -kX -lM,N"
+" -p db-file -sXYZ -tN -Bl.m file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 static void possibly_load_default_database()
@@ -407,7 +412,7 @@
   }
 }
 
-static int is_list(const string &str)
+static bool is_list(const string &str)
 {
   const char *start = str.contents();
   const char *end = start + str.length();
@@ -437,22 +442,22 @@
   normalize_for_lf(fn);
   current_filename = fn.contents();
   fprintf(outfp, ".lf 1 %s\n", current_filename);
+  current_lineno = 1;
   string line;
-  current_lineno = 0;
   for (;;) {
     line.clear();
     for (;;) {
       int c = getc(fp);
-      if (c == EOF) {
+      if (EOF == c) {
 	if (line.length() > 0)
 	  line += '\n';
 	break;
       }
-      if (invalid_input_char(c))
+      if (is_invalid_input_char(c))
 	error("invalid input character code %1", c);
       else {
 	line += c;
-	if (c == '\n')
+	if ('\n' == c)
 	  break;
       }
     }
@@ -462,24 +467,24 @@
     current_lineno++;
     if (len >= 2 && line0 == '.' && line1 == '') {
       int start_lineno = current_lineno;
-      int start_of_line = 1;
+      bool at_start_of_line = true;
       string str;
       string post;
       string pre(line.contents() + 2, line.length() - 3);
       for (;;) {
 	int c = getc(fp);
-	if (c == EOF) {
+	if (EOF == c) {
 	  error_with_file_and_line(current_filename, start_lineno,
 				   "missing '.' line");
 	  break;
 	}
-	if (start_of_line)
+	if (at_start_of_line)
 	  current_lineno++;
-	if (start_of_line && c == '.') {
+	if (at_start_of_line && '.' == c) {
 	  int d = getc(fp);
 	  if (d == '') {
 	    while ((d = getc(fp)) != '\n' && d != EOF) {
-	      if (invalid_input_char(d))
+	      if (is_invalid_input_char(d))
 		error("invalid input character code %1", d);
 	      else
 		post += d;
@@ -489,11 +494,11 @@
 	  if (d != EOF)
 	    ungetc(d, fp);
 	}
-	if (invalid_input_char(c))
+	if (is_invalid_input_char(c))
 	  error("invalid input character code %1", c);
 	else
 	  str += c;
-	start_of_line = (c == '\n');
+	at_start_of_line = ('\n' == c);
       }
       if (is_list(str)) {
 	output_pending_line();
@@ -535,8 +540,9 @@
       need_syncing = 1;
     }
     else if (len >= 4
-	     && line0 == '.' && line1 == 'l' && line2 == 'f'
-	     && (compatible_flag || line3 == '\n' || line3 == ' ')) {
+	     && '.' == line0 && 'l' == line1 && 'f' == line2
+	     && (compatible_flag || '\n' == line3 || ' ' == line3))
+    {
       pending_lf_lines += line;
       line += '\0';
       if (interpret_lf_args(line.contents() + 3))
@@ -544,22 +550,24 @@
     }
     else if (recognize_R1_R2
 	     && len >= 4
-	     && line0 == '.' && line1 == 'R' && line2 == '1'
-	     && (compatible_flag || line3 == '\n' || line3 == ' ')) {
+	     && '.' == line0 && 'R' == line1 && '1' == line2
+	     && (compatible_flag || '\n' == line3 || ' ' == line3))
+    {
       line.clear();
-      int start_of_line = 1;
       int start_lineno = current_lineno;
+      bool at_start_of_line = true;
       for (;;) {
 	int c = getc(fp);
-	if (c != EOF && start_of_line)
+	if (c != EOF && at_start_of_line)
 	  current_lineno++;
-	if (start_of_line && c == '.') {
+	if (at_start_of_line && '.' == c) {
 	  c = getc(fp);
-	  if (c == 'R') {
+	  if ('R' == c) {
 	    c = getc(fp);
-	    if (c == '2') {
+	    if ('2' == c) {
 	      c = getc(fp);
-	      if (compatible_flag || c == ' ' || c == '\n' || c == EOF) {
+	      if (compatible_flag || ' ' == c || '\n' == c || EOF == c)
+	      {
 		while (c != EOF && c != '\n')
 		  c = getc(fp);
 		break;
@@ -578,16 +586,18 @@
 	  else
 	    line += '.';
 	}
-	if (c == EOF) {
+	if (EOF == c) {
 	  error_with_file_and_line(current_filename, start_lineno,
 				   "missing '.R2' line");
 	  break;
 	}
-	if (invalid_input_char(c))
-	  error("invalid input character code %1", int(c));
+	if (is_invalid_input_char(c))
+	  error_with_file_and_line(current_filename, start_lineno,
+				   "invalid input character code %1",
+				   c);
 	else {
 	  line += c;
-	  start_of_line = c == '\n';
+	  at_start_of_line = ('\n' == c);
 	}
       }
       output_pending_line();
@@ -663,7 +673,8 @@
       break;
     last_token_start = ptr;
     if (*ptr == PRE_LABEL_MARKER || *ptr == POST_LABEL_MARKER
-	|| (*ptr >= LABEL_MARKER && *ptr < LABEL_MARKER + N_LABEL_TYPES))
+	|| (*ptr >= LABEL_MARKER
+	    && *ptr < LABEL_MARKER + N_LABEL_TYPES))
       ptr++;
     else if (!get_token(&ptr, end))
       break;
@@ -692,7 +703,7 @@
       citation_max *= 2;
       citation = new reference *citation_max;
       memcpy(citation, old_citation, ncitations*sizeof(reference *));
-      a_delete old_citation;
+      delete old_citation;
     }
   }
   citationncitations++ = ref;
@@ -743,7 +754,7 @@
 	if (old_tablei) {
 	  reference **p;
 	  for (p = (reference_hash_table
-				+ (old_tablei->hash() % hash_table_size));
+		    + (old_tablei->hash() % hash_table_size));
 	       *p;
 	       ((p == reference_hash_table)
 		? (p = reference_hash_table + hash_table_size - 1)
@@ -751,7 +762,7 @@
 	    ;
 	  *p = old_tablei;
 	}
-      a_delete old_table;
+      delete old_table;
     }
   }
   if (label_in_text)
@@ -817,7 +828,8 @@
   }
   string merged_label;
   for (int i = 0; i < n; i++) {
-    int nmerged = vi->merge_labels(v + i + 1, n - i - 1, type, merged_label);
+    int nmerged = vi->merge_labels(v + i + 1, n - i - 1, type,
+	merged_label);
     if (nmerged > 0) {
       put_string(merged_label, fp);
       i += nmerged;
@@ -830,7 +842,8 @@
 }
 
 
-label_processing_state::label_processing_state(reference **p, int n, FILE *f)
+label_processing_state::label_processing_state(reference **p, int n,
+					       FILE *f)
 : state(NORMAL), count(0), rptr(p), rcount(n), fp(f)
 {
 }
@@ -848,7 +861,7 @@
   case NORMAL:
     break;
   case PENDING_LABEL:
-    if (c == POST_LABEL_MARKER) {
+    if (POST_LABEL_MARKER == c) {
       state = PENDING_LABEL_POST;
       return 1;
     }
@@ -860,7 +873,7 @@
     }
     break;
   case PENDING_LABEL_POST:
-    if (c == PRE_LABEL_MARKER) {
+    if (PRE_LABEL_MARKER == c) {
       state = PENDING_LABEL_POST_PRE;
       return 1;
     }
@@ -889,7 +902,7 @@
     }
     break;
   case PENDING_POST:
-    if (c == PRE_LABEL_MARKER) {
+    if (PRE_LABEL_MARKER == c) {
       put_string(sep_label, fp);
       state = NORMAL;
       return 1;
@@ -943,7 +956,8 @@
   assert(accumulate);
   if (!hash_table_size) {
     if (have_bibliography)
-      error("nothing to reference (probably 'bibliography' before 'sort')");
+      error("nothing to reference (probably 'bibliography' before"
+	    " 'sort')");
     accumulate = 0;
     nreferences = 0;
     return;
@@ -957,7 +971,8 @@
     assert(j == nreferences);
     for (; j < hash_table_size; j++)
       reference_hash_tablej = 0;
-    qsort(reference_hash_table, nreferences, sizeof(reference*), rcompare);
+    qsort(reference_hash_table, nreferences, sizeof(reference*),
+	  rcompare);
     for (i = 0; i < nreferences; i++)
       reference_hash_tablei->set_number(i);
     compute_labels(reference_hash_table, nreferences);
@@ -981,7 +996,8 @@
 	reference_hash_tablei->print_sort_key_comment(outfp);
       if (label_in_reference) {
 	fputs(".ds F ", outfp);
-	const string &label = reference_hash_tablei->get_label(NORMAL_LABEL);
+	const string &label
+	  = reference_hash_tablei->get_label(NORMAL_LABEL);
 	if (label.length() > 0
 	    && (label0 == ' ' || label0 == '\\' || label0 == '"'))
 	  putc('"', outfp);
@@ -1115,21 +1131,22 @@
     }
     current_filename = filename;
   }
+  current_lineno = 1;
   enum {
     START, MIDDLE, BODY, BODY_START, BODY_BLANK, BODY_DOT
     } state = START;
   string body;
   for (;;) {
     int c = getc(fp);
-    if (c == EOF)
+    if (EOF == c)
       break;
-    if (invalid_input_char(c)) {
+    if (is_invalid_input_char(c)) {
       error("invalid input character code %1", c);
       continue;
     }
     switch (state) {
     case START:
-      if (c == '%') {
+      if ('%' == c) {
 	body = c;
 	state = BODY;
       }
@@ -1137,20 +1154,20 @@
 	state = MIDDLE;
       break;
     case MIDDLE:
-      if (c == '\n')
+      if ('\n' == c)
 	state = START;
       break;
     case BODY:
       body += c;
-      if (c == '\n')
+      if ('\n' == c)
 	state = BODY_START;
       break;
     case BODY_START:
-      if (c == '\n') {
+      if ('\n' == c) {
 	do_ref(body);
 	state = START;
       }
-      else if (c == '.')
+      else if ('.' == c)
 	state = BODY_DOT;
       else if (csspace(c)) {
 	state = BODY_BLANK;
@@ -1162,7 +1179,7 @@
       }
       break;
     case BODY_BLANK:
-      if (c == '\n') {
+      if ('\n' == c) {
 	trim_blanks(body);
 	do_ref(body);
 	state = START;
@@ -1175,20 +1192,20 @@
       }
       break;
     case BODY_DOT:
-      if (c == '') {
+      if ('' == c) {
 	do_ref(body);
 	state = MIDDLE;
       }
       else {
 	body += '.';
 	body += c;
-	state = c == '\n' ? BODY_START : BODY;
+	state = ('\n' == c) ? BODY_START : BODY;
       }
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled case while parsing bibliography file");
     }
-    if (c == '\n')
+    if ('\n' == c)
       current_lineno++;
   }
   switch (state) {
@@ -1230,10 +1247,10 @@
 
 int next_size(int n)
 {
-  static const int table_sizes = { 
+  static const int table_sizes = {
     101, 503, 1009, 2003, 3001, 4001, 5003, 10007, 20011, 40009,
     80021, 160001, 500009, 1000003, 2000003, 4000037, 8000009,
-    16000057, 32000011, 64000031, 128000003, 0 
+    16000057, 32000011, 64000031, 128000003, 0
   };
 
   const int *p;
@@ -1243,3 +1260,8 @@
   return *p;
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/refer.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/refer.h Changed

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/tests/artifacts Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/tests/artifacts/62124.bib Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/tests/report-correct-line-numbers.sh Added

@@ -0,0 +1,136 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+refer="${abs_top_builddir:-.}/refer"
+
+fail=
+
+wail () {
+    echo FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #62124.  Ensure correct line numbers in
+# diagnostics on bibliography files.
+
+# Locate directory containing our test artifacts.
+artifact_dir=
+
+for buildroot in . .. ../..
+do
+    d=$buildroot/src/preproc/refer/tests/artifacts
+    if  -d "$d" 
+    then
+        artifact_dir=$d
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+test -z "$artifact_dir" && exit 77 # skip
+
+input=".
+.R1
+bibliography $artifact_dir/62124.bib
+cattywumpus
+.R2
+.
+.R1
+bibliography $artifact_dir/62124.bib
+cattywumpus
+.R2"
+
+# We want standard error _only_.
+output=$(echo "$input" | "$refer" -e -p "$artifact_dir"/62124.bib \
+    2>&1 >/dev/null)
+
+# We should get every complaint about the bibliography twice because it
+# is dumped twice; the line numbers should not change because they're
+# problems with the bibliography file, not the input file.
+
+# We're pattern-matching diagnostic output here, which is a delicate
+# thing to do.  If a test failure occurs, ensure the diagnostic message
+# text hasn't changed before assuming a deeper logic problem.
+
+echo "checking line number of invalid character on bibliography line 1"
+count=$(echo "$output" | grep -c "refer:.*/62124.bib:1:.*code 129")
+test $count -eq 2 || wail
+
+echo "checking line number of first invalid character on bibliography" \
+  "line 2"
+count=$(echo "$output" | grep -c "refer:.*/62124.bib:2:.*code 136")
+test $count -eq 2 || wail
+
+echo "checking line number of second invalid character on" \
+  "bibliography line 2"
+count=$(echo "$output" | grep -c "refer:.*/62124.bib:2:.*code 137")
+test $count -eq 2 || wail
+
+echo "checking line number of first invalid character on" \
+  "bibliography line 3"
+count=$(echo "$output" | grep -c "refer:.*/62124.bib:3:.*code 136")
+test $count -eq 2 || wail
+
+echo "checking line number of second invalid character on" \
+  "bibliography line 3"
+count=$(echo "$output" | grep -c "refer:.*/62124.bib:3:.*code 137")
+test $count -eq 2 || wail
+
+# Problems with the input file should also be accurately located.
+
+echo "checking line number of invalid refer(1) command on input line 4"
+echo "$output"
+echo "$output" | grep -q "refer:.*:4:.*unknown command" || wail
+
+echo "checking line number of invalid refer(1) command on input line 9"
+echo "$output"
+echo "$output" | grep -q "refer:.*:9:.*unknown command" || wail
+
+# Regression-test Savannah #62391.
+
+output=$(printf '\0201\n' | "$refer" 2>&1 >/dev/null)
+
+echo "checking line number of invalid input character on input line 1"
+echo "$output" | grep -q "refer:.*:1:.*invalid input character" \
+  || wail
+
+output=$(printf '.R1\nbogus \0200\n.R2\n' | "$refer" 2>&1 >/dev/null)
+
+echo "checking line number of invalid input character after refer(1)" \
+  "command on input line 2"
+echo "$output" | grep -q "refer:.*:2:.*invalid input character" \
+  || wail
+
+output=$(printf '.R1\ndatabase nonexistent.bib\n.R2\n' | "$refer" 2>&1 \
+  >/dev/null)
+
+echo "checking line number of attempt to load nonexistent database"
+echo "$output" | grep -q "refer:.*:2:.*can't open 'nonexistent\.bib':" \
+  || wail
+
+output=$(printf '.R1\ninclude nonexistent.bib\n.R2\n' | "$refer" 2>&1 \
+  >/dev/null)
+
+echo "checking line number of attempt to load nonexistent inclusion"
+echo "$output" | grep -q "refer:.*:2:.*can't open 'nonexistent\.bib':" \
+  || wail
+test -z "$fail" || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/token.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/token.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/refer/token.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/refer/token.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/soelim/soelim.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/soelim/soelim.1.man Changed

@@ -1,20 +1,16 @@
 '\" p
-.TH @G@SOELIM @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@soelim \- interpret .so requests in groff input
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr soelim_C \n.C
-.cp 0
-.mso pic.tmac
+.TH @g@soelim @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@soelim \- recursively interpolate source requests in
+.I roff
+or other text files
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -32,126 +28,222 @@
 .\" instead of in the original English.
 .
 .
-.\" ====================================================================
-.SH SYNOPSIS
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_soelim_1_man_C \n.cp
+.cp 0
 .
-.SY @g@soelim
-.OP \-Crtv
-.OP \-I dir
-.RI  file
-\&.\|.\|.\&
-.YS
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.\" Man pages are seldom preprocessed with pic(1).
+.mso pic.tmac
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.\" Definitions
 .\" ====================================================================
 .
-.B @g@soelim
-reads
-.I files
-and replaces lines of the form
-.IP
-.BI .so\~ file
-.LP
-by the contents of
-.IR file .
-.
-It is useful if files included with
-.B .so
-need to be preprocessed.
+.ie t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
+.el   .ds tx TeX
 .
-Normally,
-.B @g@soelim
-should be invoked with the
-.B \-s
-option of
-.BR groff .
 .
+.\" ====================================================================
+.SH Synopsis
+.\" ====================================================================
 .
-.PP
-To embed \oq\rs\cq in the file name, write \oq\rs\rs\cq
-or \oq\rse\cq.
+.SY @g@soelim
+.RB  \-Crt 
+.RB  \-I
+.IR dir 
+.RI  input-file\~ .\|.\|.
+.YS
 .
-To embed a space, write \oq\rs\ \cq.
 .
-Any other escape sequence in
-.I file
-makes
-.B soelim
-ignore the whole line.
+.SY @g@soelim
+.B \-\-help
+.YS
 .
 .
-.PP
-Note that there must be no whitespace between the leading dot and the two
-characters \oqs\cq and \oqo\cq.
+.SY @g@soelim
+.B \-v
 .
-Otherwise, only
-.B groff
-interprets the
-.B .so
-request (and
-.B soelim
-ignores it).
+.SY @g@soelim
+.B \-\-version
+.YS
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Description
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+GNU
+.I soelim \" GNU
+is a preprocessor for the
+.MR groff @MAN7EXT@
+document formatting system.
+.
+.I @g@soelim
+works as a filter to eliminate source requests in
+.MR roff @MAN7EXT@
+input files;
+that is,
+it replaces lines of the form
+.RB \lq .so
+.IR included-file \rq
+within each text
+.I input-file
+with the contents of
+.IR included-file ,
+recursively.
+.
+By default,
+it writes
+.B lf
+requests as well to record the name and line number of each
+.I input-file
+and
+.IR included-file ,
+so that any diagnostics produced by later processing can be accurately
+traced to the original input.
+.
+Options allow this information to be suppressed
+.RB ( \-r )
+or supplied in \*tx comments instead
+.RB ( \-t ).
+.
+In the absence of
+.I input-file
+arguments,
+.I @g@soelim
+reads the standard input stream.
+.
+Output is written to the standard output stream.
 .
 .
-.TP
-.B \-C
-Recognize
-.B .so
-even when followed by a character other than space or newline.
+.PP
+If the name of a
+.I macro-file
+contains a backslash,
+use
+.B \rs\rs
+or
+.B \rse
+to embed it.
+.
+To embed a space,
+write
+.RB \lq \rs\~ \rq
+(backslash followed by a space).
 .
-.TP
-.BI \-I dir
-This option may be used to add a directory to the search path for
-files (both those on the command line and those named in
-.B .so
-requests).
+Any other escape sequence in
+.IR macro-file ,
+including
+.RB \lq \rsrs \rq,
+prevents
+.I @g@soelim
+from replacing the source request.
 .
-The search path is initialized with the current directory.
 .
-This option may be specified more than once; the directories are then
-searched in the order specified (but before the current directory).
+.PP
+The dot must be at the beginning of a line and must be followed by
+.RB \lq so \rq
+without intervening spaces or tabs for
+.I @g@soelim
+to handle it.
 .
-If you want to make the current directory be read before other
-directories, add
-.B \-I.\&
-at the appropriate place.
+This convention allows source requests to be \lqprotected\rq from
+processing by
+.IR @g@soelim ,
+for instance as part of macro definitions or
+.RB \lq if \rq
+requests.
 .
-.IP
-No directory search is performed for files with an absolute file name.
 .
-.TP
-.B \-r
-Do not add
-.B .lf
-requests (for general use, with non-groff files).
+.PP
+There must also be at least one space between
+.RB \lq so \rq
+and its
+.I macro-file
+argument.
 .
-.TP
-.B \-t
-Don't emit
-.B .lf
-requests but TeX comment lines (starting with \oq%\cq) giving the
-current file and line number.
+The
+.B \-C
+option overrides this requirement.
 .
-.TP
-.B \-v
-Print the version number.
 .
+.PP
+The foregoing is the limit of
+.IR @g@soelim 's
+understanding of the
+.I roff
+language;
+it does not,
+for example,
+replace the input line
+.
+.RS
+.EX
+\&.if 1 .so otherfile
+.EE
+.RE
+.
+with the contents of
+.IR otherfile .
+.
+With its
+.B \-r
+option,
+therefore,
+.I @g@soelim
+can be used to process text files in general,
+to flatten a tree of input documents.
 .
-.\" ====================================================================
-.SH USAGE
-.\" ====================================================================
 .
-The normal processing sequence of groff is this:
+.PP
+.I soelim \" generic
+was designed to handle situations where the target of a
+.I roff \" generic
+source request requires a preprocessor such as
+.MR @g@eqn @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@refer @MAN1EXT@ ,
+or
+.MR @g@tbl @MAN1EXT@ .
+.
+The usual processing sequence of
+.MR groff @MAN1EXT@
+is as follows.
+.
+.\" Does this groff installation use a command prefix?  In installed
+.\" pages, this comparison will not look like it needs to be dynamically
+.\" decided.
+.\"
+.\" This is done so that the box sizes (in the pic(1) diagram) and arrow
+.\" alignments (in the text alternative) can remain fixed.
+.if !'@g@'\%' \{\
+In the diagrams below,
+the traditional names for
+.I soelim
+and
+.I troff
+are used;
+on this system,
+the GNU versions are installed as
+.I @g@soelim
+and
+.IR @g@troff .
+.\}
 .
 .
 .PP
@@ -186,43 +278,48 @@
 .PE
 .\}
 .el \{\
-.nf
+.EX
           input        sourced
           file          file
-            |             |
-            v             v
-        preprocessor -> troff -> postprocessor
-                                      |
-                                      v
+            \bv             \bv
+            \da             \da
+        preprocessor \an\-> troff \an\-> postprocessor
+                                      \bv
+                                      \da
                                    output
                                     file
-.fi
+.EE
 .\}
 .PP
-.
-That is, files sourced with
-.B .so
+That is,
+files sourced with
+.RB \lq so \rq
 are normally read
 .I only
-by
-.B troff
-(the actual formatter).
+by the formatter,
+.IR @g@troff .
 .
-.B soelim
+.I @g@soelim
 is
 .I not
 required for
-.B troff
+.I @g@troff
 to source files.
 .
 .
 .PP
-If a file to be sourced should also be preprocessed, it must already be read
+If a file to be sourced should also be preprocessed,
+it must already be read
 .I before
 the input file passes through the preprocessor.
 .
-This is handled by
-.BR soelim :
+.IR @g@soelim ,
+normally invoked via
+.IR groff 's
+.B \-s
+option,
+handles this.
+.
 .
 .PP
 .ie t \{\
@@ -253,31 +350,107 @@
 .PE
 .\}
 .el \{\
-.nf
+.EX
           input
           file
-            |
-            v
-          soelim -> preprocessor -> troff -> postprocessor
-            ^                                     |
-            |                                     v
+            \bv
+            \da
+          soelim \an\-> preprocessor \an\-> troff \an\-> \
+postprocessor
+            \ua                                     \bv
+            \bv                                     \da
          sourced                               output
           file                                  file
-.fi
+.EE
 .\}
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH Options
+.\" ====================================================================
+.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-C
+Recognize an input line starting with
+.B .so
+even if a character other than a space or newline follows.
+.
+.TP
+.BI \-I\~ dir
+Search the directory
+.I dir
+path for
+.I input-
+and
+.I included-files.
+.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
+.
+To search the current working directory before others,
+add
+.RB \lq "\-I .\&" \rq
+at the desired place;
+it is otherwise searched last.
+.
+.
+.TP
+.B \-r
+Write files \lqraw\rq;
+do not add
+.B lf
+requests.
+.
+.
+.TP
+.B \-t
+Emit \*tx comment lines starting with
+.RB \lq % \rq
+indicating the current file and line number,
+rather than
+.B lf
+requests for the same purpose.
+.
+.
+.PP
+If both
+.B \-r
+and
+.B \-t
+are given,
+the last one specified controls.
+.
+.
+.\" ====================================================================
+.SH "See also"
 .\" ====================================================================
-.BR groff (@MAN1EXT@)
 .
+.MR groff @MAN1EXT@
+.
+.
+.\" Clean up.
+.rm tx
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \nsoelim_C
+.cp \n*groff_soelim_1_man_C
+.do rr *groff_soelim_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/soelim/soelim.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/soelim/soelim.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/soelim/soelim.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/soelim/soelim.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/tbl/main.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/main.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -121,8 +120,10 @@
       // handle line continuation and uninterpreted leader character
       if ((c = getc(fp)) == '\\') {
 	c = getc(fp);
-	if (c == '\n')
-	  c = getc(fp);		// perhaps state ought to be START now
+	if (c == '\n') {
+	  current_lineno++;
+	  c = getc(fp);
+	}
 	else if (c == 'a' && compatible_flag) {
 	  state = LEADER_1;
 	  return '\\';
@@ -313,7 +314,7 @@
       }
       break;
     default:
-      assert(0);
+      assert(0 == "invalid `state` in switch");
     }
   switch(state) {
   case START:
@@ -367,8 +368,8 @@
   return 0;
 }
 
-// return 0 if we should give up in this table
-
+// Handle region options.  Return a null pointer if we should give up on
+// this table.
 options *process_options(table_input &in)
 {
   options *opt = new options;
@@ -393,7 +394,7 @@
       level++;
     else if (c == ')')
       level--;
-    else if (c == ';' && level == 0) {
+    else if (c == ';' && 0 == level) {
       line += '\0';
       break;
     }
@@ -421,39 +422,43 @@
       while (*q != ')' && *q != '\0')
 	q++;
       if (*q == '\0')
-	error("missing ')'");
+	error("'%1' region option argument missing closing parenthesis",
+	      arg);
       else
 	*q++ = '\0';
     }
     if (*p == '\0') {
       if (arg)
-	error("argument without option");
+	error("'%1' region option argument cannot be empty", arg);
     }
     else if (strieq(p, "tab")) {
       if (!arg)
-	error("'tab' option requires argument in parentheses");
+	error("'tab' region option requires argument in parentheses");
       else {
 	if (arg0 == '\0' || arg1 != '\0')
-	  error("argument to 'tab' option must be a single character");
+	  error("'tab' region option argument must be a single"
+		" character");
 	else
 	  opt->tab_char = arg0;
       }
     }
     else if (strieq(p, "linesize")) {
       if (!arg)
-	error("'linesize' option requires argument in parentheses");
+	error("'linesize' region option requires argument in"
+	      " parentheses");
       else {
 	if (sscanf(arg, "%d", &opt->linesize) != 1)
-	  error("bad linesize '%s'", arg);
+	  error("invalid argument to 'linesize' region option: '%1'",
+		arg);
 	else if (opt->linesize <= 0) {
-	  error("linesize must be positive");
+	  error("'linesize' region option argument must be positive");
 	  opt->linesize = 0;
 	}
       }
     }
     else if (strieq(p, "delim")) {
       if (!arg)
-	error("'delim' option requires argument in parentheses");
+	error("'delim' region option requires argument in parentheses");
       else if (arg0 == '\0' || arg1 == '\0' || arg2 != '\0')
 	error("argument to 'delim' option must be two characters");
       else {
@@ -463,50 +468,53 @@
     }
     else if (strieq(p, "center") || strieq(p, "centre")) {
       if (arg)
-	error("'center' option does not take an argument");
+	error("'center' region option does not take an argument");
       opt->flags |= table::CENTER;
     }
     else if (strieq(p, "expand")) {
       if (arg)
-	error("'expand' option does not take an argument");
+	error("'expand' region option does not take an argument");
       opt->flags |= table::EXPAND;
+      opt->flags |= table::GAP_EXPAND;
     }
     else if (strieq(p, "box") || strieq(p, "frame")) {
       if (arg)
-	error("'box' option does not take an argument");
+	error("'box' region option does not take an argument");
       opt->flags |= table::BOX;
     }
     else if (strieq(p, "doublebox") || strieq(p, "doubleframe")) {
       if (arg)
-	error("'doublebox' option does not take an argument");
+	error("'doublebox' region option does not take an argument");
       opt->flags |= table::DOUBLEBOX;
     }
     else if (strieq(p, "allbox")) {
       if (arg)
-	error("'allbox' option does not take an argument");
+	error("'allbox' region option does not take an argument");
       opt->flags |= table::ALLBOX;
     }
     else if (strieq(p, "nokeep")) {
       if (arg)
-	error("'nokeep' option does not take an argument");
+	error("'nokeep' region option does not take an argument");
       opt->flags |= table::NOKEEP;
     }
     else if (strieq(p, "nospaces")) {
       if (arg)
-	error("'nospaces' option does not take an argument");
+	error("'nospaces' region option does not take an argument");
       opt->flags |= table::NOSPACES;
     }
     else if (strieq(p, "nowarn")) {
       if (arg)
-	error("'nowarn' option does not take an argument");
+	error("'nowarn' region option does not take an argument");
       opt->flags |= table::NOWARN;
     }
     else if (strieq(p, "decimalpoint")) {
       if (!arg)
-	error("'decimalpoint' option requires argument in parentheses");
+	error("'decimalpoint' region option requires argument in"
+	      " parentheses");
       else {
 	if (arg0 == '\0' || arg1 != '\0')
-	  error("argument to 'decimalpoint' option must be a single character");
+	  error("'decimalpoint' region option argument must be a single"
+		" character");
 	else
 	  opt->decimal_point_char = arg0;
       }
@@ -515,7 +523,7 @@
       opt->flags |= table::EXPERIMENTAL;
     }
     else {
-      error("unrecognised global option '%1'", p);
+      error("unrecognized region option '%1'", p);
       // delete opt;
       // return 0;
     }
@@ -574,7 +582,7 @@
     putc('=', stderr);
     break;
   default:
-    assert(0);
+    assert(0 == "invalid column classifier in switch");
     break;
   }
   if (point_size.val != 0) {
@@ -665,7 +673,7 @@
   vline = new char*nrows + n;
   for (i = 0; i < nrows; i++)
     vlinei = old_vlinei;
-  a_delete old_vline;
+  delete old_vline;
   for (i = 0; i < n; i++) {
     vlinenrows + i = new charncolumns + 1;
     for (int j = 0; j < ncolumns + 1; j++)
@@ -675,7 +683,7 @@
   entry = new entry_format *nrows + n;
   for (i = 0; i < nrows; i++)
     entryi = old_entryi;
-  a_delete old_entry;
+  delete old_entry;
   for (i = 0; i < n; i++)
     entrynrows + i = new entry_formatncolumns;
   nrows += n;
@@ -683,16 +691,16 @@
 
 format::~format()
 {
-  a_delete separation;
-  ad_delete(ncolumns) width;
-  a_delete equal;
-  a_delete expand;
+  delete separation;
+  delete width;
+  delete equal;
+  delete expand;
   for (int i = 0; i < nrows; i++) {
-    a_delete vlinei;
-    ad_delete(ncolumns) entryi;
+    delete vlinei;
+    delete entryi;
   }
-  a_delete vline;
-  a_delete entry;
+  delete vline;
+  delete entry;
 }
 
 struct input_entry_format : public entry_format {
@@ -700,9 +708,9 @@
   string width;
   int separation;
   int vline;
-  int pre_vline;
-  int last_column;
-  int equal;
+  int vline_count;
+  bool is_last_column;
+  bool is_equal_width;
   int expand;
   input_entry_format(format_type, input_entry_format * = 0);
   ~input_entry_format();
@@ -713,10 +721,10 @@
 : entry_format(t), next(p)
 {
   separation = -1;
-  last_column = 0;
+  is_last_column = false;
   vline = 0;
-  pre_vline = 0;
-  equal = 0;
+  vline_count = 0;
+  is_equal_width = false;
   expand = 0;
 }
 
@@ -736,7 +744,7 @@
 void input_entry_format::debug_print()
 {
   int i;
-  for (i = 0; i < pre_vline; i++)
+  for (i = 0; i < vline_count; i++)
     putc('|', stderr);
   entry_format::debug_print();
   if (!width.empty()) {
@@ -745,7 +753,7 @@
     put_string(width, stderr);
     putc(')', stderr);
   }
-  if (equal)
+  if (is_equal_width)
     putc('e', stderr);
   if (expand)
     putc('x', stderr);
@@ -753,80 +761,88 @@
     fprintf(stderr, "%d", separation); 
   for (i = 0; i < vline; i++)
     putc('|', stderr);
-  if (last_column)
+  if (is_last_column)
     putc(',', stderr);
 }
 
-// Return zero if we should give up on this table.
-// If this is a continuation format line, current_format will be the current
-// format line.
-
+// Interpret a table format specification, like "CC,LR.".  Return null
+// pointer if we should give up on this table.  If this is a
+// continuation format line, `current_format` will be the current format
+// line.
 format *process_format(table_input &in, options *opt,
 		       format *current_format = 0)
 {
-  input_entry_format *list = 0;
-  int have_expand = 0;
+  input_entry_format *list = 0 /* nullptr */;
+  bool have_expand = false;
+  bool is_first_row = true;
   int c = in.get();
   for (;;) {
-    int pre_vline = 0;
-    int got_format = 0;
-    int got_period = 0;
+    int vline_count = 0;
+    bool got_format = false;
+    bool got_period = false;
     format_type t = FORMAT_LEFT;
     for (;;) {
       if (c == EOF) {
-	error("end of input while processing format");
+	error("end of input while processing table format"
+	      " specification");
 	free_input_entry_format_list(list);
-	return 0;
+	list = 0 /* nullptr */;
+	return 0 /* nullptr */;
       }
       switch (c) {
       case 'n':
       case 'N':
 	t = FORMAT_NUMERIC;
-	got_format = 1;
+	got_format = true;
 	break;
       case 'a':
       case 'A':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_ALPHABETIC;
 	break;
       case 'c':
       case 'C':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_CENTER;
 	break;
       case 'l':
       case 'L':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_LEFT;
 	break;
       case 'r':
       case 'R':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_RIGHT;
 	break;
       case 's':
       case 'S':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_SPAN;
 	break;
       case '^':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_VSPAN;
 	break;
       case '_':
       case '-':			// tbl also accepts this
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_HLINE;
+	if (is_first_row)
+	  opt->flags |= table::HAS_TOP_HLINE;
 	break;
       case '=':
-	got_format = 1;
+	got_format = true;
 	t = FORMAT_DOUBLE_HLINE;
 	break;
       case '.':
-	got_period = 1;
+	got_period = true;
 	break;
       case '|':
-	pre_vline++;
+	// leading vertical line in row
+	opt->flags |= table::HAS_TOP_VLINE;
+	vline_count++;
+	// list->vline_count is updated later
 	break;
       case ' ':
       case '\t':
@@ -835,9 +851,10 @@
       default:
 	if (c == opt->tab_char)
 	  break;
-	error("unrecognised format '%1'", char(c));
+	error("invalid column classifier '%1'", char(c));
 	free_input_entry_format_list(list);
-	return 0;
+	list = 0 /* nullptr */;
+	return 0 /* nullptr */;
       }
       if (got_period)
 	break;
@@ -848,9 +865,14 @@
     if (got_period)
       break;
     list = new input_entry_format(t, list);
-    if (pre_vline)
-      list->pre_vline = pre_vline;
-    int success = 1;
+    if (vline_count > 2) {
+      vline_count = 2;
+      error("more than 2 vertical lines at beginning of row description");
+    }
+    list->vline_count = vline_count;
+    // Now handle modifiers.
+    vline_count = 0;
+    bool is_valid_modifier_sequence = true;
     do {
       switch (c) {
       case '0':
@@ -885,7 +907,7 @@
       case 'e':
       case 'E':
 	c = in.get();
-	list->equal = 1;
+	list->is_equal_width = true;
 	// 'e' and 'x' are mutually exclusive
 	list->expand = 0;
 	break;
@@ -895,14 +917,15 @@
 	  c = in.get();
 	} while (c == ' ' || c == '\t');
 	if (c == EOF) {
-	  error("missing font name");
+	  error("'f' column modifier missing font name or mounting"
+		" position");
 	  break;
 	}
 	if (c == '(') {
 	  for (;;) {
 	    c = in.get();
 	    if (c == EOF || c == ' ' || c == '\t') {
-	      error("missing ')'");
+	      error("'f' column modifier missing closing parenthesis");
 	      break;
 	    }
 	    if (c == ')') {
@@ -934,14 +957,14 @@
 	  c = in.get();
 	} while (c == ' ' || c == '\t');
 	if (c == EOF) {
-	  error("missing macro name");
+	  error("'m' column modifier missing macro name");
 	  break;
 	}
 	if (c == '(') {
 	  for (;;) {
 	    c = in.get();
 	    if (c == EOF || c == ' ' || c == '\t') {
-	      error("missing ')'");
+	      error("'m' column modifier missing closing parenthesis");
 	      break;
 	    }
 	    if (c == ')') {
@@ -964,31 +987,36 @@
 	break;
       case 'p':
       case 'P':
-	c = in.get();
-	list->point_size.val = 0;
-	list->point_size.inc = 0;
-	if (c == '+' || c == '-') {
-	  list->point_size.inc = (c == '+' ? 1 : -1);
+	{
+	  inc_number &ps = list->point_size;
+	  ps.val = 0;
+	  ps.inc = 0;
 	  c = in.get();
-	}
-	if (c == EOF || !csdigit(c)) {
-	  error("'p' modifier must be followed by number");
-	  list->point_size.inc = 0;
-	}
-	else {
-	  do {
-	    list->point_size.val *= 10;
-	    list->point_size.val += c - '0';
+	  if (c == '+' || c == '-') {
+	    ps.inc = (c == '+' ? 1 : -1);
 	    c = in.get();
-	  } while (c != EOF && csdigit(c));
-	}
-	if (list->point_size.val > MAX_POINT_SIZE
-	    || list->point_size.val < -MAX_POINT_SIZE) {
-	  error("unreasonable point size");
-	  list->point_size.val = 0;
-	  list->point_size.inc = 0;
+	  }
+	  if (c == EOF || !csdigit(c)) {
+	    warning("'p' column modifier must be followed by"
+		    " (optionally signed) integer; ignoring");
+	    ps.inc = 0;
+	  }
+	  else {
+	    do {
+	      ps.val *= 10;
+	      ps.val += c - '0';
+	      c = in.get();
+	    } while (c != EOF && csdigit(c));
+	  }
+	  if (ps.val > MAX_POINT_SIZE || ps.val < -MAX_POINT_SIZE) {
+	    warning("'p' column modifier argument magnitude of %1"
+		    " points out of range (> %2); ignoring", ps.val,
+		    MAX_POINT_SIZE);
+	    ps.val = 0;
+	    ps.inc = 0;
+	  }
+	  break;
 	}
-	break;
       case 't':
       case 'T':
 	c = in.get();
@@ -1001,31 +1029,37 @@
 	break;
       case 'v':
       case 'V':
-	c = in.get();
-	list->vertical_spacing.val = 0;
-	list->vertical_spacing.inc = 0;
-	if (c == '+' || c == '-') {
-	  list->vertical_spacing.inc = (c == '+' ? 1 : -1);
+	{
+	  inc_number &vs = list->vertical_spacing;
+	  vs.val = 0;
+	  vs.inc = 0;
 	  c = in.get();
-	}
-	if (c == EOF || !csdigit(c)) {
-	  error("'v' modifier must be followed by number");
-	  list->vertical_spacing.inc = 0;
-	}
-	else {
-	  do {
-	    list->vertical_spacing.val *= 10;
-	    list->vertical_spacing.val += c - '0';
+	  if (c == '+' || c == '-') {
+	    vs.inc = (c == '+' ? 1 : -1);
 	    c = in.get();
-	  } while (c != EOF && csdigit(c));
-	}
-	if (list->vertical_spacing.val > MAX_VERTICAL_SPACING
-	    || list->vertical_spacing.val < -MAX_VERTICAL_SPACING) {
-	  error("unreasonable vertical spacing");
-	  list->vertical_spacing.val = 0;
-	  list->vertical_spacing.inc = 0;
+	  }
+	  if (c == EOF || !csdigit(c)) {
+	    warning("'v' column modifier must be followed by"
+		    " (optionally signed) integer; ignoring");
+	    vs.inc = 0;
+	  }
+	  else {
+	    do {
+	      vs.val *= 10;
+	      vs.val += c - '0';
+	      c = in.get();
+	    } while (c != EOF && csdigit(c));
+	  }
+	  if (vs.val > MAX_VERTICAL_SPACING
+	      || vs.val < -MAX_VERTICAL_SPACING) {
+	    warning("'v' column modifier argument magnitude of %1"
+		    " points out of range (> %2); ignoring", vs.val,
+		    MAX_VERTICAL_SPACING);
+	    vs.val = 0;
+	    vs.inc = 0;
+	  }
+	  break;
 	}
-	break;
       case 'w':
       case 'W':
 	c = in.get();
@@ -1036,9 +1070,10 @@
 	  c = in.get();
 	  while (c != ')') {
 	    if (c == EOF || c == '\n') {
-	      error("missing ')'");
+	      error("'w' column modifier missing closing parenthesis");
 	      free_input_entry_format_list(list);
-	      return 0;
+	      list = 0 /* nullptr */;
+	      return 0 /* nullptr */;
 	    }
 	    list->width += c;
 	    c = in.get();
@@ -1053,7 +1088,7 @@
 	  else
 	    list->width = "";
 	  if (c == EOF || !csdigit(c))
-	    error("bad argument for 'w' modifier");
+	    error("invalid argument to 'w' modifier");
 	  else {
 	    do {
 	      list->width += char(c);
@@ -1069,7 +1104,7 @@
 	c = in.get();
 	list->expand = 1;
 	// 'x' and 'e' are mutually exclusive
-	list->equal = 0;
+	list->is_equal_width = false;
 	// 'x' and 'w' are mutually exclusive
 	list->width = "";
 	break;
@@ -1079,8 +1114,10 @@
 	list->zero_width = 1;
 	break;
       case '|':
+	if (is_first_row)
+	  opt->flags |= table::HAS_TOP_VLINE;
 	c = in.get();
-	list->vline++;
+	vline_count++;
 	break;
       case ' ':
       case '\t':
@@ -1090,17 +1127,20 @@
 	if (c == opt->tab_char)
 	  c = in.get();
 	else
-	  success = 0;
+	  is_valid_modifier_sequence = false;
 	break;
       }
-    } while (success);
-    if (list->vline > 2) {
-      list->vline = 2;
-      error("more than 2 vertical bars between key letters");
+    } while (is_valid_modifier_sequence);
+    if (vline_count > 2) {
+      vline_count = 2;
+      error("more than 2 vertical lines after column descriptor");
     }
+    list->vline += vline_count;
     if (c == '\n' || c == ',') {
+      vline_count = 0;
+      is_first_row = false;
       c = in.get();
-      list->last_column = 1;
+      list->is_last_column = true;
     }
   }
   if (c == '.') {
@@ -1108,17 +1148,19 @@
       c = in.get();
     } while (c == ' ' || c == '\t');
     if (c != '\n') {
-      error("'.' not last character on line");
+      error("'.' is not the last character of the table format");
       free_input_entry_format_list(list);
-      return 0;
+      list = 0 /* nullptr */;
+      return 0 /* nullptr */;
     }
   }
   if (!list) {
-    error("no format");
+    error("table format specification is empty");
     free_input_entry_format_list(list);
-    return 0;
+    list = 0 /* nullptr */;
+    return 0 /* nullptr */;
   }
-  list->last_column = 1;
+  list->is_last_column = true;
   // now reverse the list so that the first row is at the beginning
   input_entry_format *rev = 0;
   while (list != 0) {
@@ -1140,7 +1182,7 @@
   int nrows = 0;
   int col = 0;
   for (tem = list; tem; tem = tem->next) {
-    if (tem->last_column) {
+    if (tem->is_last_column) {
       if (col >= ncolumns)
 	ncolumns = col + 1;
       col = 0;
@@ -1155,7 +1197,8 @@
     if (ncolumns > current_format->ncolumns) {
       error("cannot increase the number of columns in a continued format");
       free_input_entry_format_list(list);
-      return 0;
+      list = 0 /* nullptr */;
+      return 0 /* nullptr */;
     }
     f = current_format;
     row = f->nrows;
@@ -1179,7 +1222,7 @@
     }
     else if (tem->separation >= 0)
       error("column separation specified for last column");
-    if (tem->equal && !f->equalcol) {
+    if (tem->is_equal_width && !f->equalcol) {
       if (current_format)
 	error("cannot change which columns are equal in continued format");
       else
@@ -1190,7 +1233,7 @@
 	error("cannot change which columns are expanded in continued format");
       else {
 	f->expandcol = 1;
-	have_expand = 1;
+	have_expand = true;
       }
     }
     if (!tem->width.empty()) {
@@ -1199,12 +1242,10 @@
 	error("multiple widths for column %1", col + 1);
       f->widthcol = tem->width;
     }
-    if (tem->pre_vline) {
-      assert(col == 0);
-      f->vlinerowcol = tem->pre_vline;
-    }
+    if (tem->vline_count)
+      f->vlinerowcol = tem->vline_count;
     f->vlinerowcol + 1 = tem->vline;
-    if (tem->last_column) {
+    if (tem->is_last_column) {
       row++;
       col = 0;
     }
@@ -1212,6 +1253,7 @@
       col++;
   }
   free_input_entry_format_list(list);
+  list = 0 /* nullptr */;
   for (col = 0; col < ncolumns; col++) {
     entry_format *e = f->entryf->nrows - 1 + col;
     if (e->type != FORMAT_HLINE
@@ -1222,10 +1264,11 @@
   if (col >= ncolumns) {
     error("last row of format is all lines");
     delete f;
-    return 0;
+    return 0 /* nullptr */;
   }
   if (have_expand && (opt->flags & table::EXPAND)) {
-    error("ignoring global 'expand' option because of 'x' specifiers");
+    error("'x' column modifier encountered; ignoring region option"
+	  " 'expand'");
     opt->flags &= ~table::EXPAND;
   }
   return f;
@@ -1237,7 +1280,7 @@
   int ncolumns = f->ncolumns;
   int current_row = 0;
   int format_index = 0;
-  int give_up = 0;
+  bool give_up = false;
   enum { DATA_INPUT_LINE, TROFF_INPUT_LINE, SINGLE_HLINE, DOUBLE_HLINE } type;
   table *tbl = new table(ncolumns, opt->flags, opt->linesize,
 			 opt->decimal_point_char);
@@ -1266,6 +1309,8 @@
 	  type = SINGLE_HLINE;
 	else
 	  type = DOUBLE_HLINE;
+	if (0 == current_row)
+	  tbl->flags |= table::HAS_TOP_HLINE;
       }
       else {
 	in.unget(d);
@@ -1305,7 +1350,7 @@
 	}
 	entry_format *line_format = f->entryformat_index;
 	int col = 0;
-	int row_comment = 0;
+	bool seen_row_comment = false;
 	for (;;) {
 	  if (c == tab_char || c == '\n') {
 	    int ln = current_lineno;
@@ -1416,12 +1461,12 @@
 		  break;
 		case END:
 		default:
-		  assert(0);
+		  assert(0 == "invalid `state` in switch");
 		}
 	      }
 	      if (c == EOF) {
 		error("end of data in middle of text block");
-		give_up = 1;
+		give_up = true;
 		break;
 	      }
 	    }
@@ -1430,12 +1475,12 @@
 		if (input_entry.length() >= 2
 		    && input_entry0 == '\\'
 		    && input_entry1 == '"')
-		  row_comment = 1;
-		else if (!row_comment) {
+		  seen_row_comment = true;
+		else if (!seen_row_comment) {
 		  if (c == '\n')
 		    in.unget(c);
 		  input_entry += '\0';
-		  error("excess data entry '%1' discarded",
+		  error("excess table entry '%1' discarded",
 			input_entry.contents());
 		  if (c == '\n')
 		    (void)in.get();
@@ -1485,7 +1530,7 @@
 	    && line0 == '.' && line1 == 'T' && line2 == '&') {
 	  format *newf = process_format(in, opt, f);
 	  if (newf == 0)
-	    give_up = 1;
+	    give_up = true;
 	  else
 	    f = newf;
 	}
@@ -1503,14 +1548,14 @@
       tbl->add_double_hline(current_row);
       break;
     default:
-      assert(0);
+      assert(0 == "invalid `type` in switch");
     }
     if (give_up)
       break;
   }
   if (!give_up && current_row == 0) {
     error("no real data");
-    give_up = 1;
+    give_up = true;
   }
   if (give_up) {
     delete tbl;
@@ -1536,29 +1581,33 @@
 
 void process_table(table_input &in)
 {
-  options *opt = 0;
-  format *form = 0;
-  table *tbl = 0;
-  if ((opt = process_options(in)) != 0 
-      && (form = process_format(in, opt)) != 0
-      && (tbl = process_data(in, form, opt)) != 0) {
+  options *opt = 0 /* nullptr */;
+  format *fmt = 0 /* nullptr */;
+  table *tbl = 0 /* nullptr */;
+  if ((opt = process_options(in)) != 0 /* nullptr */
+      && (fmt = process_format(in, opt)) != 0 /* nullptr */
+      && (tbl = process_data(in, fmt, opt)) != 0 /* nullptr */) {
     tbl->print();
     delete tbl;
   }
   else {
-    error("giving up on this table");
+    error("giving up on this table region");
     while (in.get() != EOF)
       ;
   }
   delete opt;
-  delete form;
+  delete fmt;
   if (!in.ended())
     error("premature end of file");
 }
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s  -vC   files... \n", program_name);
+  fprintf(stream,
+"usage: %s -C file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	 program_name, program_name, program_name);
 }
 
 int main(int argc, char **argv)
@@ -1572,7 +1621,8 @@
     { "version", no_argument, 0, 'v' },
     { NULL, 0, 0, 0 }
   };
-  while ((opt = getopt_long(argc, argv, "vCT:", long_options, NULL)) != EOF)
+  while ((opt = getopt_long(argc, argv, "vC", long_options, NULL))
+         != EOF)
     switch (opt) {
     case 'C':
       compatible_flag = 1;
@@ -1580,26 +1630,24 @@
     case 'v':
       {
 	printf("GNU tbl (groff) version %s\n", Version_string);
-	exit(0);
+	exit(EXIT_SUCCESS);
 	break;
       }
-    case 'T':
-      // I'm sick of getting bug reports from IRIX users
-      break;
     case CHAR_MAX + 1: // --help
       usage(stdout);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(EXIT_FAILURE);
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled getopt_long return value");
     }
-  printf(".if !\\n(.g .ab GNU tbl requires GNU troff.\n"
-	 ".if !dTS .ds TS\n"
-	 ".if !dTE .ds TE\n");
+  printf(".if !\\n(.g .ab GNU tbl requires groff extensions; aborting\n"
+	 ".do if !dTS .ds TS\n"
+	 ".do if !dT& .ds T&\n"
+	 ".do if !dTE .ds TE\n");
   if (argc > optind) {
     for (int i = optind; i < argc; i++) 
       if (argvi0 == '-' && argvi1 == '\0') {
@@ -1611,8 +1659,10 @@
       else {
 	errno = 0;
 	FILE *fp = fopen(argvi, "r");
-	if (fp == 0)
+	if (fp == 0) {
+	  current_filename = 0 /* nullptr */;
 	  fatal("can't open '%1': %2", argvi, strerror(errno));
+	}
 	else {
 	  current_lineno = 1;
 	  string fn(argvi);
@@ -1635,3 +1685,8 @@
   return 0;
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/tbl/table.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/table.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2023 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -29,6 +28,7 @@
 
 #define DELIMITER_CHAR "\\tbl"
 #define SEPARATION_FACTOR_REG PREFIX "sep"
+#define LEFTOVER_FACTOR_REG PREFIX "leftover"
 #define BOTTOM_REG PREFIX "bot"
 #define RESET_MACRO_NAME PREFIX "init"
 #define LINESIZE_REG PREFIX "lps"
@@ -41,6 +41,7 @@
 #define SECTION_DIVERSION_FLAG_REG PREFIX "sflag"
 #define SAVED_VERTICAL_POS_REG PREFIX "vert"
 #define NEED_BOTTOM_RULE_REG PREFIX "brule"
+#define USE_KEEPS_REG PREFIX "usekeeps"
 #define KEEP_MACRO_NAME PREFIX "keep"
 #define RELEASE_MACRO_NAME PREFIX "release"
 #define SAVED_FONT_REG PREFIX "fnt"
@@ -48,6 +49,9 @@
 #define SAVED_FILL_REG PREFIX "fll"
 #define SAVED_INDENT_REG PREFIX "ind"
 #define SAVED_CENTER_REG PREFIX "cent"
+#define SAVED_TABS_NAME PREFIX "tabs"
+#define SAVED_INTER_WORD_SPACE_SIZE PREFIX "ss"
+#define SAVED_INTER_SENTENCE_SPACE_SIZE PREFIX "sss"
 #define TABLE_DIVERSION_NAME PREFIX "table"
 #define TABLE_DIVERSION_FLAG_REG PREFIX "tflag"
 #define TABLE_KEEP_MACRO_NAME PREFIX "tkeep"
@@ -57,16 +61,25 @@
 #define REPEATED_VPT_MACRO PREFIX "rvpt"
 #define SUPPRESS_BOTTOM_REG PREFIX "supbot"
 #define SAVED_DN_REG PREFIX "dn"
-#define ROW_START_LINE_REG PREFIX "lnst"
-#define ROW_SAVE_LINE_REG PREFIX "lnsv"
-#define ROW_MAX_LINE_REG PREFIX "lnmx"
-#define REPEATED_NM_SET_MACRO PREFIX "rlns"
-#define REPEATED_NM_SUS_MACRO PREFIX "rlnx"
+#define SAVED_HYPHENATION_MODE_REG PREFIX "hyphmode"
+#define SAVED_HYPHENATION_LANG_NAME PREFIX "hyphlang"
+#define SAVED_HYPHENATION_MAX_LINES_REG PREFIX "hyphmaxlines"
+#define SAVED_HYPHENATION_MARGIN_REG PREFIX "hyphmargin"
+#define SAVED_HYPHENATION_SPACE_REG PREFIX "hyphspace"
+#define SAVED_NUMBERING_LINENO PREFIX "linenumber"
+#define SAVED_NUMBERING_SUPPRESSION_COUNT PREFIX "linenumbersuppresscnt"
+#define STARTING_PAGE_REG PREFIX "starting-page"
+#define IS_BOXED_REG PREFIX "is-boxed"
+#define PREVIOUS_PAGE_REG PREFIX "previous-page"
 
 // this must be one character
 #define COMPATIBLE_REG PREFIX "c"
 
-#define EXPAND_REG PREFIX "expand"
+// for use with `ig` requests embedded inside macro definitions
+#define NOP_NAME PREFIX "nop"
+
+#define AVAILABLE_WIDTH_REG PREFIX "available-width"
+#define EXPAND_REG PREFIX "expansion-amount"
 
 #define LEADER_REG PREFIX LEADER
 
@@ -410,18 +423,19 @@
       printfs(".sp |\\n%1u\n", row_start_reg(start_row));
       break;
     case entry_modifier::CENTER:
-      // Peform the motion in two stages so that the center is rounded
+      // Perform the motion in two stages so that the center is rounded
       // vertically upwards even if net vertical motion is upwards.
       printfs(".sp |\\n%1u\n", row_start_reg(start_row));
-      printfs(".sp \\n" BOTTOM_REG "u-\\n%1u-1v/2u\n", 
+      printfs(".sp \\n" BOTTOM_REG "u-\\n%1u-1v/2u\n",
 	      row_start_reg(start_row));
       break;
     case entry_modifier::BOTTOM:
-      printfs(".sp |\\n%1u+\\n" BOTTOM_REG "u-\\n%1u-1v\n", 
+      printfs(".sp |\\n%1u+\\n" BOTTOM_REG "u-\\n%1u-1v\n",
 	      row_start_reg(start_row));
       break;
     default:
-      assert(0);
+      assert(0 == "simple entry vertical position modifier not TOP,"
+		  " CENTER, or BOTTOM");
     }
 }
 
@@ -635,7 +649,7 @@
 
 block_entry::~block_entry()
 {
-  a_delete contents;
+  delete contents;
 }
 
 void block_entry::position_vertically()
@@ -646,20 +660,21 @@
       printfs(".sp |\\n%1u\n", row_start_reg(start_row));
       break;
     case entry_modifier::CENTER:
-      // Peform the motion in two stages so that the center is rounded
+      // Perform the motion in two stages so that the center is rounded
       // vertically upwards even if net vertical motion is upwards.
       printfs(".sp |\\n%1u\n", row_start_reg(start_row));
-      printfs(".sp \\n" BOTTOM_REG "u-\\n%1u-\\n%2u/2u\n", 
+      printfs(".sp \\n" BOTTOM_REG "u-\\n%1u-\\n%2u/2u\n",
 	      row_start_reg(start_row),
 	      block_height_reg(start_row, start_col));
       break;
     case entry_modifier::BOTTOM:
-      printfs(".sp |\\n%1u+\\n" BOTTOM_REG "u-\\n%1u-\\n%2u\n", 
+      printfs(".sp |\\n%1u+\\n" BOTTOM_REG "u-\\n%1u-\\n%2u\n",
 	      row_start_reg(start_row),
 	      block_height_reg(start_row, start_col));
       break;
     default:
-      assert(0);
+      assert(0 == "block entry vertical position modifier not TOP,"
+		  " CENTER, or BOTTOM");
     }
   if (mod->stagger)
     prints(".sp -.5v\n");
@@ -711,13 +726,15 @@
   else
     // Assign each column with a block entry 1/(n+1) of the line
     // width, where n is the column count.
-    printfs("(u;\\n%1>?(\\n.l*%2/%3))", 
-	    span_width_reg(start_col, end_col), 
+    printfs("(u;\\n%1>?(\\n.l*%2/%3))",
+	    span_width_reg(start_col, end_col),
 	    as_string(end_col - start_col + 1),
 	    as_string(ncols + 1));
   if (alphabetic)
     prints("-2n");
   prints("\n");
+  prints(".ss \\n" SAVED_INTER_WORD_SPACE_SIZE ""
+      " \\n" SAVED_INTER_SENTENCE_SPACE_SIZE "\n");
   prints(".cp \\n(" COMPATIBLE_REG "\n");
   set_modifier(mod);
   set_location();
@@ -865,13 +882,14 @@
   if (!dont_move)
     prints("\\v'" BAR_HEIGHT "'");
 }
-  
+
 single_line_entry *single_line_entry::to_single_line_entry()
 {
   return this;
 }
 
-double_line_entry::double_line_entry(const table *p, const entry_modifier *m)
+double_line_entry::double_line_entry(const table *p,
+				     const entry_modifier *m)
 : line_entry(p, m)
 {
 }
@@ -1151,8 +1169,8 @@
   if (end_row != tbl->get_nrows() - 1)
     printfs("&(\\n" CURRENT_ROW_REG "<%1)",
 	    as_string(end_row));
-  prints(" \\{");
-  printfs(".if %1<=\\n" LAST_PASSED_ROW_REG " .nr %2 \\n#T\n",
+  prints(" \\{\\\n");
+  printfs(".  if %1<=\\n" LAST_PASSED_ROW_REG " .nr %2 \\n#T\n",
 	  as_string(start_row),
 	  row_top_reg(start_row));
   const char *offset_table3;
@@ -1166,7 +1184,7 @@
     offset_table1 = 0;
   }
   for (const char **offsetp = offset_table; *offsetp; offsetp++) {
-    prints(".sp -1\n"
+    prints(".  sp -1\n"
 	   "\\v'" BODY_DEPTH);
     if (!bot_adjust.empty())
       printfs("+%1", bot_adjust);
@@ -1233,8 +1251,8 @@
 : nrows(0), ncolumns(nc), linesize(ls), decimal_point_char(dpc),
   vrule_list(0), stuff_list(0), span_list(0),
   entry_list(0), entry_list_tailp(&entry_list), entry(0),
-  vline(0), row_is_all_lines(0), left_separation(0), right_separation(0),
-  total_separation(0), allocated_rows(0), flags(f)
+  vline(0), row_is_all_lines(0), left_separation(0),
+  right_separation(0), total_separation(0), allocated_rows(0), flags(f)
 {
   minimum_width = new stringncolumns;
   column_separation = ncolumns > 1 ? new intncolumns - 1 : 0;
@@ -1253,20 +1271,20 @@
 table::~table()
 {
   for (int i = 0; i < nrows; i++) {
-    a_delete entryi;
-    a_delete vlinei;
+    delete entryi;
+    delete vlinei;
   }
-  a_delete entry;
-  a_delete vline;
+  delete entry;
+  delete vline;
   while (entry_list) {
     table_entry *tem = entry_list;
     entry_list = entry_list->next;
     delete tem;
   }
-  ad_delete(ncolumns) minimum_width;
-  a_delete column_separation;
-  a_delete equal;
-  a_delete expand;
+  delete minimum_width;
+  delete column_separation;
+  delete equal;
+  delete expand;
   while (stuff_list) {
     stuff *tem = stuff_list;
     stuff_list = stuff_list->next;
@@ -1277,7 +1295,7 @@
     vrule_list = vrule_list->next;
     delete tem;
   }
-  a_delete row_is_all_lines;
+  delete row_is_all_lines;
   while (span_list) {
     horizontal_span *tem = span_list;
     span_list = span_list->next;
@@ -1359,11 +1377,11 @@
 	  allocated_rows = r + 1;
 	entry = new PPtable_entryallocated_rows;
 	memcpy(entry, old_entry, sizeof(table_entry**)*old_allocated_rows);
-	a_delete old_entry;
+	delete old_entry;
 	char **old_vline = vline;
 	vline = new char*allocated_rows;
 	memcpy(vline, old_vline, sizeof(char*)*old_allocated_rows);
-	a_delete old_vline;
+	delete old_vline;
       }
     }
     assert(allocated_rows > r);
@@ -1403,7 +1421,8 @@
     /*
       l l
       ^ s */
-    error("impossible horizontal span at row %1, column %2", r + 1, c + 1);
+    error("impossible horizontal span at row %1, column %2", r + 1,
+	  c + 1);
   }
   else {
     e->end_col = c;
@@ -1414,26 +1433,29 @@
 void table::do_vspan(int r, int c)
 {
   assert(r >= 0 && c >= 0 && r < nrows && c < ncolumns);
-  if (r == 0) {
+  if (0 == r) {
     error("first row cannot be vertically spanned");
     return;
   }
   table_entry *e = entryrc;
   if (e) {
-    assert(e->start_row <= r && r <= e->end_row
-	   && e->start_col <= c && c <= e->end_col
-	   && e->end_row - e->start_row > 0
-	   && e->end_col - e->start_col > 0);
+    assert(e->start_row <= r);
+    assert(r <= e->end_row);
+    assert(e->start_col <= c);
+    assert(c <= e->end_col);
+    assert((e->end_row - e->start_row) > 0);
+    assert((e->end_col - e->start_col) > 0);
     return;
   }
   e = entryr-1c;
-  // e can be 0 if we had an empty entry or an error
-  if (e == 0)
+  // e can be a null pointer if we had an empty entry or an error
+  if (0 == e)
     return;
   if (e->start_col != c) {
     /* l s
        l ^ */
-    error("impossible vertical span at row %1, column %2", r + 1, c + 1);
+    error("impossible vertical span at row %1, column %2", r + 1,
+	  c + 1);
   }
   else {
     for (int i = c; i <= e->end_col; i++) {
@@ -1487,11 +1509,23 @@
   return possible_pos;
 }
 
-void table::add_entry(int r, int c, const string &str, const entry_format *f,
-		      const char *fn, int ln)
+void table::add_entry(int r, int c, const string &str,
+		      const entry_format *f, const char *fn, int ln)
 {
   allocate(r);
   table_entry *e = 0;
+  char *s = str.extract();
+  if (str.search('\n') >= 0) {
+    bool was_changed = false;
+    for (int i = 0; si != '\0'; i++)
+      if ((i > 0) && (s(i - 1) == '\\') && (si == 'R')) {
+	si = '&';
+	was_changed = true;
+      }
+    if (was_changed)
+      error_with_file_and_line(fn, ln, "repeating a glyph with '\\R'"
+			       " is not allowed in a text block");
+  }
   if (str == "\\_") {
     e = new short_line_entry(this, f);
   }
@@ -1523,19 +1557,15 @@
       e = new double_line_entry(this, f);
   }
   else if (str == "\\^") {
-    do_vspan(r, c);
-  }
-  else if (str.length() > 2 && str0 == '\\' && str1 == 'R') {
-    if (str.search('\n') >= 0)
-      error_with_file_and_line(fn, ln, "bad repeated character");
-    else {
-      char *s = str.substring(2, str.length() - 2).extract();
-      e = new repeated_char_entry(this, f, s);
+    if (r == 0) {
+      error("first row cannot contain a vertical span entry '\\^'");
+      e = new empty_entry(this, f);
     }
+    else
+      do_vspan(r, c);
   }
   else {
     int is_block = str.search('\n') >= 0;
-    char *s;
     switch (f->type) {
     case FORMAT_SPAN:
       assert(str.empty());
@@ -1543,7 +1573,6 @@
       break;
     case FORMAT_LEFT:
       if (!str.empty()) {
-	s = str.extract();
 	if (is_block)
 	  e = new left_block_entry(this, f, s);
 	else
@@ -1554,7 +1583,6 @@
       break;
     case FORMAT_CENTER:
       if (!str.empty()) {
-	s = str.extract();
 	if (is_block)
 	  e = new center_block_entry(this, f, s);
 	else
@@ -1565,7 +1593,6 @@
       break;
     case FORMAT_RIGHT:
       if (!str.empty()) {
-	s = str.extract();
 	if (is_block)
 	  e = new right_block_entry(this, f, s);
 	else
@@ -1576,7 +1603,6 @@
       break;
     case FORMAT_NUMERIC:
       if (!str.empty()) {
-	s = str.extract();
 	if (is_block) {
 	  error_with_file_and_line(fn, ln, "can't have numeric text block");
 	  e = new left_block_entry(this, f, s);
@@ -1594,7 +1620,6 @@
       break;
     case FORMAT_ALPHABETIC:
       if (!str.empty()) {
-	s = str.extract();
 	if (is_block)
 	  e = new alphabetic_block_entry(this, f, s);
 	else
@@ -1607,19 +1632,22 @@
       do_vspan(r, c);
       break;
     case FORMAT_HLINE:
-      if (str.length() != 0)
+      if ((str.length() != 0) && (str != "\\&"))
 	error_with_file_and_line(fn, ln,
-				 "non-empty data entry for '_' format ignored");
+				 "ignoring non-empty data entry using"
+				 " '_' column classifier");
       e = new single_line_entry(this, f);
       break;
     case FORMAT_DOUBLE_HLINE:
-      if (str.length() != 0)
+      if ((str.length() != 0) && (str != "\\&"))
 	error_with_file_and_line(fn, ln,
-				 "non-empty data entry for '=' format ignored");
+				 "ignoring non-empty data entry using"
+				 " '=' column classifier");
       e = new double_line_entry(this, f);
       break;
     default:
-      assert(0);
+      assert(0 == "table column format not in FORMAT_{SPAN,LEFT,CENTER,"
+		  "RIGHT,NUMERIC,ALPHABETIC,VSPAN,HLINE,DOUBLE_HLINE}");
     }
   }
   if (e) {
@@ -1627,7 +1655,8 @@
     if (preve) {
       /* c s
          ^ l */
-      error_with_file_and_line(fn, ln, "row %1, column %2 already spanned",
+      error_with_file_and_line(fn, ln, "row %1, column %2 already"
+				       " spanned",
 			       r + 1, c + 1);
       delete e;
     }
@@ -1648,8 +1677,23 @@
 void table::add_vlines(int r, const char *v)
 {
   allocate(r);
-  for (int i = 0; i < ncolumns+1; i++)
-    vlineri = vi;
+  bool lwarned = false;
+  bool twarned = false;
+  for (int i = 0; i < ncolumns+1; i++) {
+    assert(vi < 3);
+    if (vi && (flags & (BOX | ALLBOX | DOUBLEBOX)) && (i == 0)
+	&& (!lwarned)) {
+      error("ignoring vertical line at leading edge of boxed table");
+      lwarned = true;
+    }
+    else if (vi && (flags & (BOX | ALLBOX | DOUBLEBOX))
+	     && (i == ncolumns) && (!twarned)) {
+      error("ignoring vertical line at trailing edge of boxed table");
+      twarned = true;
+    }
+    else
+      vlineri = vi;
+  }
 }
 
 void table::check()
@@ -1672,9 +1716,9 @@
   determine_row_type();
   compute_widths();
   if (!(flags & CENTER))
-    prints(".if \\n" SAVED_CENTER_REG " \\{");
-  prints(".in +(u;\\n.l-\\n.i-\\nTW/2>?-\\n.i)\n"
-	 ".nr " SAVED_INDENT_REG " \\n.i\n");
+    prints(".if \\n" SAVED_CENTER_REG " \\{\\\n");
+  prints(".  in +(u;\\n.l-\\n.i-\\nTW/2>?-\\n.i)\n"
+	 ".  nr " SAVED_INDENT_REG " \\n.i\n");
   if (!(flags & CENTER))
     prints(".\\}\n");
   build_vrule_list();
@@ -1689,9 +1733,9 @@
 {
   row_is_all_lines = new charnrows;
   for (int i = 0; i < nrows; i++) {
-    int had_single = 0;
-    int had_double = 0;
-    int had_non_line = 0;
+    bool had_single = false;
+    bool had_double = false;
+    bool had_non_line = false;
     for (int c = 0; c < ncolumns; c++) {
       table_entry *e = entryic;
       if (e != 0) {
@@ -1699,19 +1743,19 @@
 	  int t = e->line_type();
 	  switch (t) {
 	  case -1:
-	    had_non_line = 1;
+	    had_non_line = true;
 	    break;
 	  case 0:
 	    // empty
 	    break;
 	  case 1:
-	    had_single = 1;
+	    had_single = true;
 	    break;
 	  case 2:
-	    had_double = 1;
+	    had_double = true;
 	    break;
 	  default:
-	    assert(0);
+	    assert(0 == "table entry line type not in {-1, 0, 1, 2}");
 	  }
 	  if (had_non_line)
 	    break;
@@ -1741,6 +1785,7 @@
 
 void table::init_output()
 {
+  prints(".\\\" initialize output\n");
   prints(".nr " COMPATIBLE_REG " \\n(.C\n"
 	 ".cp 0\n");
   if (linesize > 0)
@@ -1751,22 +1796,40 @@
     prints(".nr " SAVED_CENTER_REG " \\n.ce\n");
   if (compatible_flag)
     prints(".ds " LEADER_REG " \\a\n");
+  if (!(flags & NOKEEP))
+    prints(".if !r " USE_KEEPS_REG " .nr " USE_KEEPS_REG " 1\n");
   prints(".de " RESET_MACRO_NAME "\n"
-	 ".ft \\n.f\n"
-	 ".ps \\n.s\n"
-	 ".vs \\n.vu\n"
-	 ".in \\n.iu\n"
-	 ".ll \\n.lu\n"
-	 ".ls \\n.L\n"
-	 ".ad \\n.j\n"
-	 ".ie \\n.u .fi\n"
-	 ".el .nf\n"
-	 ".ce \\n.ce\n"
+	 ".  ft \\n.f\n"
+	 ".  ps \\n.s\n"
+	 ".  vs \\n.vu\n"
+	 ".  in \\n.iu\n"
+	 ".  ll \\n.lu\n"
+	 ".  ls \\n.L\n"
+	 ".  hy \\\\n" SAVED_HYPHENATION_MODE_REG "\n"
+	 ".  hla \\\\*" SAVED_HYPHENATION_LANG_NAME "\n"
+	 ".  hlm \\\\n" SAVED_HYPHENATION_MAX_LINES_REG "\n"
+	 ".  hym \\\\n" SAVED_HYPHENATION_MARGIN_REG "\n"
+	 ".  hys \\\\n" SAVED_HYPHENATION_SPACE_REG "\n"
+	 ".  ad \\n.j\n"
+	 ".  ie \\n.u .fi\n"
+	 ".  el .nf\n"
+	 ".  ce \\n.ce\n"
+	 ".  ta \\\\*" SAVED_TABS_NAME "\n"
+	 ".  ss \\\\n" SAVED_INTER_WORD_SPACE_SIZE ""
+	 " \\\\n" SAVED_INTER_SENTENCE_SPACE_SIZE "\n"
 	 "..\n"
 	 ".nr " SAVED_INDENT_REG " \\n.i\n"
 	 ".nr " SAVED_FONT_REG " \\n.f\n"
 	 ".nr " SAVED_SIZE_REG " \\n.s\n"
 	 ".nr " SAVED_FILL_REG " \\n.u\n"
+	 ".ds " SAVED_TABS_NAME " \\n.tabs\n"
+	 ".nr " SAVED_INTER_WORD_SPACE_SIZE " \\n.ss\n"
+	 ".nr " SAVED_INTER_SENTENCE_SPACE_SIZE " \\n.sss\n"
+	 ".nr " SAVED_HYPHENATION_MODE_REG " \\n.hy\n"
+	 ".ds " SAVED_HYPHENATION_LANG_NAME " \\n.hla\n"
+	 ".nr " SAVED_HYPHENATION_MAX_LINES_REG " (\\n.hlm)\n"
+	 ".nr " SAVED_HYPHENATION_MARGIN_REG " \\n.hym\n"
+	 ".nr " SAVED_HYPHENATION_SPACE_REG " \\n.hys\n"
 	 ".nr T. 0\n"
 	 ".nr " CURRENT_ROW_REG " 0-1\n"
 	 ".nr " LAST_PASSED_ROW_REG " 0-1\n"
@@ -1777,83 +1840,62 @@
 	 ".nr " SUPPRESS_BOTTOM_REG " 0\n"
 	 ".eo\n"
 	 ".de " REPEATED_MARK_MACRO "\n"
-	 ".mk \\$1\n"
-	 ".if !'\\n(.z'' \\!." REPEATED_MARK_MACRO " \"\\$1\"\n"
+	 ".  mk \\$1\n"
+	 ".  if !'\\n(.z'' \\!." REPEATED_MARK_MACRO " \"\\$1\"\n"
 	 "..\n"
 	 ".de " REPEATED_VPT_MACRO "\n"
-	 ".vpt \\$1\n"
-	 ".if !'\\n(.z'' \\!." REPEATED_VPT_MACRO " \"\\$1\"\n"
-	 "..\n"
-	 ".de " REPEATED_NM_SET_MACRO "\n"
-	 ".ie !'\\n(.z'' \\{.nm\n"
-	 "\\!." REPEATED_NM_SET_MACRO " \"\\$1\"\n"
-	 ".\\}\n"
-	 ".el .if \\nln \\{\\\n"
-	 ".if '\\$1'd' .nr " ROW_START_LINE_REG " \\nln\n"
-	 ".if '\\$1's' .nm \\n" ROW_START_LINE_REG "\n"
-	 ".if '\\$1'm' .nr " ROW_MAX_LINE_REG " \\nln>?\\n" ROW_MAX_LINE_REG "\n"
-	 ".\\}\n"
-	 "..\n"
-	 ".de " REPEATED_NM_SUS_MACRO "\n"
-	 ".ie !'\\n(.z'' \\{.nm\n"
-	 "\\!." REPEATED_NM_SUS_MACRO " \"\\$1\"\n"
-	 ".\\}\n"
-	 ".el .if \\nln \\{\\\n"
-	 ".ie '\\$1's' \\{\\\n"
-	 ".nr " ROW_SAVE_LINE_REG " \\n(ln<?\\n" ROW_MAX_LINE_REG "\n"
-	 ".nm +0 \\nln+42\n"
-	 ".\\}\n"
-	 ".el \\{\\\n"
-	 ".nr ln \\n" ROW_SAVE_LINE_REG "\n"
-	 ".nm \\nln 1\n"
-	 ".\\}\n"
-	 ".\\}\n"
+	 ".  vpt \\$1\n"
+	 ".  if !'\\n(.z'' \\!." REPEATED_VPT_MACRO " \"\\$1\"\n"
 	 "..\n");
-  if (!(flags & NOKEEP))
+  if (!(flags & NOKEEP)) {
     prints(".de " KEEP_MACRO_NAME "\n"
-	   ".if '\\n.z'' \\{.ds " QUOTE_STRING_NAME " \\\\\n"
-	   ".ds " TRANSPARENT_STRING_NAME " \\!\n"
-	   ".di " SECTION_DIVERSION_NAME "\n"
-	   ".nr " SECTION_DIVERSION_FLAG_REG " 1\n"
-	   ".in 0\n"
-	   ".\\}\n"
+	   ".  if '\\n.z'' \\{\\\n"
+	   ".    ds " QUOTE_STRING_NAME " \\\\\n"
+	   ".    ds " TRANSPARENT_STRING_NAME " \\!\n"
+	   ".    di " SECTION_DIVERSION_NAME "\n"
+	   ".    nr " SECTION_DIVERSION_FLAG_REG " 1\n"
+	   ".    in 0\n"
+	   ".  \\}\n"
 	   "..\n"
-	   // protect # in macro name against eqn
+	   // Protect '#' in macro name from being interpreted by eqn.
 	   ".ig\n"
 	   ".EQ\n"
 	   "delim off\n"
 	   ".EN\n"
 	   "..\n"
 	   ".de " RELEASE_MACRO_NAME "\n"
-	   ".if \\n" SECTION_DIVERSION_FLAG_REG " \\{"
-	   ".di\n"
-	   ".in \\n" SAVED_INDENT_REG "u\n"
-	   ".nr " SAVED_DN_REG " \\ndn\n"
-	   ".ds " QUOTE_STRING_NAME "\n"
-	   ".ds " TRANSPARENT_STRING_NAME "\n"
-	   ".nr " SECTION_DIVERSION_FLAG_REG " 0\n"
-	   ".if \\n.t<=\\ndn \\{"
-	   ".nr T. 1\n"
-	   ".T#\n"
-	   ".nr " SUPPRESS_BOTTOM_REG " 1\n"
-	   ".sp \\n.tu\n"
-	   ".nr " SUPPRESS_BOTTOM_REG " 0\n"
-	   ".mk #T\n"
-	   ".\\}\n"
-	   ".if \\n.t<=\\n" SAVED_DN_REG " "
-	   /* Since we turn off traps, it won't get into an infinite loop
-	   when we try and print it; it will just go off the bottom of the
-	   page. */
-	   ".tm warning: page \\n%: table text block will not fit on one page\n"
-	   ".nf\n"
-	   ".if \\nln .nm \\nln\n"
-	   ".nr " ROW_MAX_LINE_REG " \\nln\n"
-	   ".ls 1\n"
-	   "." SECTION_DIVERSION_NAME "\n"
-	   ".ls\n"
-	   ".if \\nln .nm\n"
-	   ".rm " SECTION_DIVERSION_NAME "\n"
-	   ".\\}\n"
+	   ".  if \\n" SECTION_DIVERSION_FLAG_REG " \\{\\\n"
+	   ".    di\n"
+	   ".    in \\n" SAVED_INDENT_REG "u\n"
+	   ".    nr " SAVED_DN_REG " \\ndn\n"
+	   ".    ds " QUOTE_STRING_NAME "\n"
+	   ".    ds " TRANSPARENT_STRING_NAME "\n"
+	   ".    nr " SECTION_DIVERSION_FLAG_REG " 0\n"
+	   ".    if \\n.t<=\\ndn \\{\\\n"
+	   ".      nr T. 1\n"
+	   ".      T#\n"
+	   ".      nr " SUPPRESS_BOTTOM_REG " 1\n"
+	   ".      sp \\n.tu\n"
+	   ".      nr " SUPPRESS_BOTTOM_REG " 0\n"
+	   ".      mk #T\n"
+	   ".    \\}\n");
+    if (!(flags & NOWARN)) {
+      prints(".    if \\n.t<=\\n" SAVED_DN_REG " \\{\\\n");
+      // eqn(1) delimiters have already been switched off.
+      entry_list->set_location();
+      // Since we turn off traps, troff won't go into an infinite loop
+      // when we output the table row; it will just flow off the bottom
+      // of the page.
+      prints(".      tmc \\n.F:\\n.c: warning:\n"
+	     ".      tm1 \" table row does not fit on page \\n%\n");
+      prints(".    \\}\n");
+    }
+    prints(".    nf\n"
+	   ".    ls 1\n"
+	   ".    " SECTION_DIVERSION_NAME "\n"
+	   ".    ls\n"
+	   ".    rm " SECTION_DIVERSION_NAME "\n"
+	   ".  \\}\n"
 	   "..\n"
 	   ".ig\n"
 	   ".EQ\n"
@@ -1862,34 +1904,57 @@
 	   "..\n"
 	   ".nr " TABLE_DIVERSION_FLAG_REG " 0\n"
 	   ".de " TABLE_KEEP_MACRO_NAME "\n"
-	   ".if '\\n.z'' \\{"
-	   ".di " TABLE_DIVERSION_NAME "\n"
-	   ".nr " TABLE_DIVERSION_FLAG_REG " 1\n"
-	   ".\\}\n"
+	   ".  if '\\n.z'' \\{\\\n"
+	   ".    di " TABLE_DIVERSION_NAME "\n"
+	   ".    nr " TABLE_DIVERSION_FLAG_REG " 1\n"
+	   ".  \\}\n"
 	   "..\n"
 	   ".de " TABLE_RELEASE_MACRO_NAME "\n"
-	   ".if \\n" TABLE_DIVERSION_FLAG_REG " \\{.br\n"
-	   ".di\n"
-	   ".nr " SAVED_DN_REG " \\ndn\n"
-	   ".ne \\ndnu+\\n.Vu\n"
-	   ".ie \\n.t<=\\n" SAVED_DN_REG " "
-	   ".tm error: page \\n%: table will not fit on one page; use .TS H/.TH with a supporting macro package\n"
-	   ".el \\{"
-	   ".in 0\n"
-	   ".ls 1\n"
-	   ".nf\n"
-	   ".if \\nln .nm \\nln\n"
-	   "." TABLE_DIVERSION_NAME "\n"
-	   ".\\}\n"
-	   ".rm " TABLE_DIVERSION_NAME "\n"
-	   ".\\}\n"
-	   ".if \\nln \\{.nm\n"
-	   ".nr ln \\n" ROW_MAX_LINE_REG "\n"
-	   ".\\}\n"
+	   ".  if \\n" TABLE_DIVERSION_FLAG_REG " \\{\\\n"
+	   ".    br\n"
+	   ".    di\n"
+	   ".    nr " SAVED_DN_REG " \\ndn\n"
+	   ".    ne \\ndnu+\\n.Vu\n"
+	   ".    ie \\n.t<=\\n" SAVED_DN_REG " \\{\\\n");
+    // Protect characters in diagnostic message (especially :, , )
+    // from being interpreted by eqn.
+    prints(".      ds " NOP_NAME " \\\" empty\n");
+    prints(".      ig " NOP_NAME "\n"
+	   ".EQ\n"
+	   "delim off\n"
+	   ".EN\n"
+	   ".      " NOP_NAME "\n");
+    entry_list->set_location();
+    prints(".      nr " PREVIOUS_PAGE_REG " (\\n% - 1)\n"
+	   ".      tmc \\n.F:\\n.c: error:\n"
+	   ".      tmc \" boxed table does not fit on page"
+	   " \\n" PREVIOUS_PAGE_REG ";\n"
+	   ".      tm1 \" use .TS H/.TH with a supporting macro package"
+	   "\n"
+	   ".      rr " PREVIOUS_PAGE_REG "\n");
+    prints(".      ig " NOP_NAME "\n"
+	   ".EQ\n"
+	   "delim on\n"
+	   ".EN\n"
+	   ".      " NOP_NAME "\n");
+    prints(".    \\}\n"
+	   ".  el \\{\\\n"
+	   ".    in 0\n"
+	   ".    ls 1\n"
+	   ".    nf\n"
+	   ".    " TABLE_DIVERSION_NAME "\n"
+	   ".  \\}\n"
+	   ".  rm " TABLE_DIVERSION_NAME "\n"
+	   ".  \\}\n"
 	   "..\n");
+  }
   prints(".ec\n"
-	 ".ce 0\n"
-	 ".nf\n");
+	 ".ce 0\n");
+  prints(".nr " SAVED_NUMBERING_LINENO " \\nln\n"
+	 ".nr ln 0\n"
+	 ".nr " SAVED_NUMBERING_SUPPRESSION_COUNT " \\n.nn\n"
+	 ".nn 2147483647\n"); // 2^31-1; inelegant but effective
+  prints(".nf\n");
 }
 
 string block_width_reg(int r, int c)
@@ -1961,14 +2026,14 @@
   static char namesizeof(ROW_START_PREFIX)+INT_DIGITS;
   sprintf(name, ROW_START_PREFIX "%d", row);
   return string(name);
-}  
+}
 
 string column_start_reg(int col)
 {
   static char namesizeof(COLUMN_START_PREFIX)+INT_DIGITS;
   sprintf(name, COLUMN_START_PREFIX "%d", col);
   return string(name);
-}  
+}
 
 string column_end_reg(int col)
 {
@@ -2003,21 +2068,21 @@
 void compute_span_width(int start_col, int end_col)
 {
   printfs(".nr %1 \\n%1>?(\\n%2+\\n%3)\n"
-	  ".if \\n%4 .nr %1 \\n%1>?(\\n%4+2n)\n", 
+	  ".if \\n%4 .nr %1 \\n%1>?(\\n%4+2n)\n",
 	  span_width_reg(start_col, end_col),
 	  span_left_numeric_width_reg(start_col, end_col),
 	  span_right_numeric_width_reg(start_col, end_col),
 	  span_alphabetic_width_reg(start_col, end_col));
 }
 
-// Increase the widths of columns so that the width of any spanning entry
-// is not greater than the sum of the widths of the columns that it spans.
-// Ensure that the widths of columns remain equal.
+// Increase the widths of columns so that the width of any spanning
+// entry is not greater than the sum of the widths of the columns that
+// it spans.  Ensure that the widths of columns remain equal.
 
 void table::divide_span(int start_col, int end_col)
 {
   assert(end_col > start_col);
-  printfs(".nr " NEEDED_REG " \\n%1-(\\n%2", 
+  printfs(".nr " NEEDED_REG " \\n%1-(\\n%2",
 	  span_width_reg(start_col, end_col),
 	  span_width_reg(start_col, start_col));
   int i;
@@ -2030,9 +2095,9 @@
   prints(")\n");
   printfs(".nr " NEEDED_REG " \\n" NEEDED_REG "/%1\n",
 	  as_string(end_col - start_col + 1));
-  prints(".if \\n" NEEDED_REG " \\{");
+  prints(".if \\n" NEEDED_REG " \\{\\\n");
   for (i = start_col; i <= end_col; i++)
-    printfs(".nr %1 +\\n" NEEDED_REG "\n", 
+    printfs(".  nr %1 +\\n" NEEDED_REG "\n",
 	    span_width_reg(i, i));
   int equal_flag = 0;
   for (i = start_col; i <= end_col && !equal_flag; i++)
@@ -2041,7 +2106,7 @@
   if (equal_flag) {
     for (i = 0; i < ncolumns; i++)
       if (i < start_col || i > end_col)
-	printfs(".nr %1 +\\n" NEEDED_REG "\n", 
+	printfs(".  nr %1 +\\n" NEEDED_REG "\n",
 	    span_width_reg(i, i));
   }
   prints(".\\}\n");
@@ -2062,7 +2127,7 @@
     if (!do_expand)
       return;
   }
-  printfs(".nr %1 \\n%2", 
+  printfs(".nr %1 \\n%2",
 	  span_width_reg(start_col, end_col),
 	  span_width_reg(start_col, start_col));
   for (i = start_col + 1; i <= end_col; i++)
@@ -2112,42 +2177,75 @@
   }
 }
 
-void table::compute_expand_width()
+void table::compute_overall_width()
 {
-  int i;
-  int colcount = count_expand_columns();
-  prints(".nr " EXPAND_REG " \\n.l-\\n.i");
-  for (i = 0; i < ncolumns; i++)
-    if (!expandi)
-      printfs("-\\n%1", span_width_reg(i, i));
+  prints(".\\\" compute overall width\n");
+  if (!(flags & GAP_EXPAND)) {
+    if (left_separation)
+      printfs(".if n .ll -%1n\n", as_string(left_separation));
+    if (right_separation)
+      printfs(".if n .ll -%1n\n", as_string(right_separation));
+  }
+  // Compute the amount of horizontal space available for expansion,
+  // measuring every column _including_ those eligible for expansion.
+  // This is the minimum required to set the table without compression.
+  prints(".nr " EXPAND_REG " 0\n");
+  prints(".nr " AVAILABLE_WIDTH_REG " \\n.l-\\n.i");
+  for (int i = 0; i < ncolumns; i++)
+    printfs("-\\n%1", span_width_reg(i, i));
   if (total_separation)
     printfs("-%1n", as_string(total_separation));
   prints("\n");
-  prints(".if \\n" EXPAND_REG "<0 \\{\\\n");
-  entry_list->set_location();
-  if (!(flags & NOWARN)) {
-    // protect ` and ' in warning message against eqn
-    prints(".ig\n"
+  // If the "expand" region option was given, a different warning will
+  // be issued later (if "nowarn" was not also specified).
+  if ((!(flags & NOWARN)) && (!(flags & EXPAND))) {
+    prints(".if \\n" AVAILABLE_WIDTH_REG "<0 \\{\\\n");
+    // Protect characters in diagnostic message (especially :, , )
+    // from being interpreted by eqn.
+    prints(".  ig\n"
 	   ".EQ\n"
 	   "delim off\n"
 	   ".EN\n"
-	   "..\n");
-    prints(".tm1 \"warning: file '\\n.F', around line \\n.c:\n"
-	   ".tm1 \"  table wider than line width\n");
-    prints(".ig\n"
+	   ".  .\n");
+    entry_list->set_location();
+    prints(".  tmc \\n.F:\\n.c: warning:\n"
+	   ".  tm1 \" table wider than line length minus indentation"
+	   "\n");
+    prints(".  ig\n"
 	   ".EQ\n"
 	   "delim on\n"
 	   ".EN\n"
-	   "..\n");
-    prints(".nr " EXPAND_REG " 0\n");
+	   ".  .\n");
+    prints(".  nr " AVAILABLE_WIDTH_REG " 0\n");
+    prints(".\\}\n");
+  }
+  // Now do a similar computation, this time omitting columns that
+  // _aren't_ undergoing expansion.  The difference is the amount of
+  // space we have to distribute among the expanded columns.
+  bool do_expansion = false;
+  for (int i = 0; i < ncolumns; i++)
+    if (expandi) {
+      do_expansion = true;
+      break;
+    }
+  if (do_expansion) {
+    prints(".if \\n" AVAILABLE_WIDTH_REG " \\\n");
+    prints(".  nr " EXPAND_REG " \\n.l-\\n.i");
+    for (int i = 0; i < ncolumns; i++)
+      if (!expandi)
+	printfs("-\\n%1", span_width_reg(i, i));
+    if (total_separation)
+      printfs("-%1n", as_string(total_separation));
+    prints("\n");
+    int colcount = count_expand_columns();
+    if (colcount > 1)
+      printfs(".nr " EXPAND_REG " \\n" EXPAND_REG "/%1\n",
+	      as_string(colcount));
+    for (int i = 0; i < ncolumns; i++)
+      if (expandi)
+	printfs(".nr %1 \\n%1>?\\n" EXPAND_REG "\n",
+		span_width_reg(i, i));
   }
-  prints(".\\}\n");
-  if (colcount > 1)
-    printfs(".nr " EXPAND_REG " \\n" EXPAND_REG "/%1\n",
-	    as_string(colcount));
-  for (i = 0; i < ncolumns; i++)
-    if (expandi)
-      printfs(".nr %1 \\n%1>?\\n" EXPAND_REG "\n", span_width_reg(i, i));
 }
 
 void table::compute_total_separation()
@@ -2155,45 +2253,55 @@
   if (flags & (ALLBOX | BOX | DOUBLEBOX))
     left_separation = right_separation = 1;
   else {
-    for (int i = 0; i < nrows; i++) {
-      if (vlinei0 > 0)
+    for (int r = 0; r < nrows; r++) {
+      if (vliner0 > 0)
 	left_separation = 1;
-      if (vlineincolumns > 0)
+      if (vlinerncolumns > 0)
 	right_separation = 1;
     }
   }
   total_separation = left_separation + right_separation;
-  int i;
-  for (i = 0; i < ncolumns - 1; i++)
-    total_separation += column_separationi;
+  for (int c = 0; c < ncolumns - 1; c++)
+    total_separation += column_separationc;
 }
 
 void table::compute_separation_factor()
 {
+  prints(".\\\" compute column separation factor\n");
   // Don't let the separation factor be negative.
   prints(".nr " SEPARATION_FACTOR_REG " \\n.l-\\n.i");
   for (int i = 0; i < ncolumns; i++)
     printfs("-\\n%1", span_width_reg(i, i));
   printfs("/%1\n", as_string(total_separation));
+  // Store the remainder for use in compute_column_positions().
+  if (flags & GAP_EXPAND) {
+    prints(".if n \\\n");
+    prints(".  nr " LEFTOVER_FACTOR_REG " \\n.l-\\n.i");
+    for (int i = 0; i < ncolumns; i++)
+      printfs("-\\n%1", span_width_reg(i, i));
+    printfs("%%%1\n", as_string(total_separation));
+  }
   prints(".ie \\n" SEPARATION_FACTOR_REG "<=0 \\{\\\n");
-  entry_list->set_location();
   if (!(flags & NOWARN)) {
-    // protect ` and ' in warning message against eqn
+    // Protect characters in diagnostic message (especially :, , )
+    // from being interpreted by eqn.
     prints(".ig\n"
 	   ".EQ\n"
 	   "delim off\n"
 	   ".EN\n"
 	   "..\n");
-    prints(".tm1 \"warning: file '\\n.F', around line \\n.c:\n"
-	   ".tm1 \"  column separation set to zero\n"
+    entry_list->set_location();
+    prints(".tmc \\n.F:\\n.c: warning:\n"
+	   ".tm1 \" table column separation reduced to zero\n"
 	   ".nr " SEPARATION_FACTOR_REG " 0\n");
   }
   prints(".\\}\n"
 	 ".el .if \\n" SEPARATION_FACTOR_REG "<1n \\{\\\n");
-  entry_list->set_location();
   if (!(flags & NOWARN)) {
-    prints(".tm1 \"warning: file '\\n.F', around line \\n.c:\n"
-	   ".tm1 \"  table squeezed horizontally to fit line length\n");
+    entry_list->set_location();
+    prints(".tmc \\n.F:\\n.c: warning:\n"
+	   ".tm1 \" table column separation reduced to fit line"
+	   " length\n");
     prints(".ig\n"
 	   ".EQ\n"
 	   "delim on\n"
@@ -2205,10 +2313,13 @@
 
 void table::compute_column_positions()
 {
+  prints(".\\\" compute column positions\n");
   printfs(".nr %1 0\n", column_divide_reg(0));
-  printfs(".nr %1 %2*\\n" SEPARATION_FACTOR_REG "\n",
-	  column_start_reg(0),
+  printfs(".nr %1 %2n\n", column_start_reg(0),
 	  as_string(left_separation));
+  // In nroff mode, compensate for width of vertical rule.
+  if (left_separation)
+    printfs(".if n .nr %1 +1n\n", column_start_reg(0));
   int i;
   for (i = 1;; i++) {
     printfs(".nr %1 \\n%2+\\n%3\n",
@@ -2221,12 +2332,19 @@
 	    column_start_reg(i),
 	    column_end_reg(i-1),
 	    as_string(column_separationi-1));
+    // If we have leftover expansion room in a table using the "expand"
+    // region option, put it prior to the last column so that the table
+    // looks as if expanded to the available line length.
+    if ((ncolumns > 2) && (flags & GAP_EXPAND) && (i == (ncolumns - 1)))
+      printfs(".if n .if \\n" LEFTOVER_FACTOR_REG " .nr %1 +(1n>?\\n"
+	      LEFTOVER_FACTOR_REG ")\n",
+	      column_start_reg(i));
     printfs(".nr %1 \\n%2+\\n%3/2\n",
 	    column_divide_reg(i),
 	    column_end_reg(i-1),
 	    column_start_reg(i));
   }
-  printfs(".nr %1 \\n%2+(%3*\\n" SEPARATION_FACTOR_REG ")\n",
+  printfs(".nr %1 \\n%2+%3n\n",
 	  column_divide_reg(ncolumns),
 	  column_end_reg(i-1),
 	  as_string(right_separation));
@@ -2255,7 +2373,7 @@
     prints('\n');
     for (i = first + 1; i < ncolumns; i++)
       if (equali)
-	printfs(".nr %1 \\n%2\n", 
+	printfs(".nr %1 \\n%2\n",
 		span_width_reg(i, i),
 		span_width_reg(first, first));
   }
@@ -2263,6 +2381,7 @@
 
 void table::compute_widths()
 {
+  prints(".\\\" compute column widths\n");
   build_span_list();
   int i;
   horizontal_span *p;
@@ -2295,16 +2414,16 @@
   for (p = span_list; p; p = p->next)
     sum_columns(p->start_col, p->end_col, 0);
   // Now handle unexpanded blocks.
-  int had_spanning_block = 0;
-  int had_equal_block = 0;
+  bool had_spanning_block = false;
+  bool had_equal_block = false;
   for (q = entry_list; q; q = q->next)
     if (q->divert(ncolumns, minimum_width,
 		  (flags & EXPAND) ? column_separation : 0, 0)) {
       if (q->end_col > q->start_col)
-	had_spanning_block = 1;
+	had_spanning_block = true;
       for (i = q->start_col; i <= q->end_col && !had_equal_block; i++)
 	if (equali)
-	  had_equal_block = 1;
+	  had_equal_block = true;
     }
   // Adjust widths.
   if (had_equal_block)
@@ -2312,7 +2431,7 @@
   if (had_spanning_block)
     for (p = span_list; p; p = p->next)
       divide_span(p->start_col, p->end_col);
-  compute_expand_width();
+  compute_overall_width();
   if ((flags & EXPAND) && total_separation != 0) {
     compute_separation_factor();
     for (p = span_list; p; p = p->next)
@@ -2325,7 +2444,7 @@
     for (q = entry_list; q; q = q->next)
       if (q->divert(ncolumns, minimum_width, 0, 1)) {
 	if (q->end_col > q->start_col)
-	  had_spanning_block = 1;
+	  had_spanning_block = true;
       }
     // Adjust widths again.
     if (had_spanning_block)
@@ -2339,7 +2458,6 @@
 {
   prints(".vs " LINE_SEP ">?\\n.Vu\n"
 	 ".ls 1\n"
-	 "." REPEATED_NM_SUS_MACRO " s\n"
 	 "\\v'" BODY_DEPTH "'"
 	 "\\s\\n" LINESIZE_REG "");
   if (r > nrows - 1)
@@ -2347,7 +2465,7 @@
   else {
     int start_col = 0;
     for (;;) {
-      while (start_col < ncolumns 
+      while (start_col < ncolumns
 	     && entryrstart_col != 0
 	     && entryrstart_col->start_row != r)
 	start_col++;
@@ -2376,8 +2494,7 @@
     }
   }
   prints("\\s0\n");
-  prints("." REPEATED_NM_SUS_MACRO " r\n"
-	 ".ls\n"
+  prints(".ls\n"
 	 ".vs\n");
 }
 
@@ -2386,7 +2503,6 @@
   prints(".vs " LINE_SEP "+" DOUBLE_LINE_SEP
 	 ">?\\n.Vu\n"
 	 ".ls 1\n"
-	 "." REPEATED_NM_SUS_MACRO " s\n"
 	 "\\v'" BODY_DEPTH "'"
 	 "\\s\\n" LINESIZE_REG "");
   if (r > nrows - 1)
@@ -2398,7 +2514,7 @@
   else {
     int start_col = 0;
     for (;;) {
-      while (start_col < ncolumns 
+      while (start_col < ncolumns
 	     && entryrstart_col != 0
 	     && entryrstart_col->start_row != r)
 	start_col++;
@@ -2445,7 +2561,6 @@
     }
   }
   prints("\\s0\n"
-	 "." REPEATED_NM_SUS_MACRO " r\n"
 	 ".ls\n"
 	 ".vs\n");
 }
@@ -2464,7 +2579,7 @@
     if (start_row == 0)
       return;
     for (stuff *p = stuff_list; p && p->row <= start_row; p = p->next)
-      if (p->row == start_row 
+      if (p->row == start_row
 	  && (p->is_single_line() || p->is_double_line()))
 	return;
   }
@@ -2605,7 +2720,7 @@
     for (col = 0; col < ncolumns+1; col++)
       if (vlineend_rowcol > 0
 	  && !vline_spanned(end_row, col)
-	  && (end_row == nrows - 1 
+	  && (end_row == nrows - 1
 	      || vlineend_row+1col != vlineend_rowcol
 	      || vline_spanned(end_row+1, col))) {
 	int start_row;
@@ -2636,6 +2751,7 @@
 
 void table::define_bottom_macro()
 {
+  prints(".\\\" define bottom macro\n");
   prints(".eo\n"
 	 // protect # in macro name against eqn
 	 ".ig\n"
@@ -2644,38 +2760,43 @@
 	 ".EN\n"
 	 "..\n"
 	 ".de T#\n"
-	 ".if !\\n" SUPPRESS_BOTTOM_REG " \\{"
-	 "." REPEATED_VPT_MACRO " 0\n"
-	 ".mk " SAVED_VERTICAL_POS_REG "\n");
+	 ".  if !\\n" SUPPRESS_BOTTOM_REG " \\{\\\n"
+	 ".    " REPEATED_VPT_MACRO " 0\n"
+	 ".    mk " SAVED_VERTICAL_POS_REG "\n");
   if (flags & (BOX | ALLBOX | DOUBLEBOX)) {
-    prints(".if \\nT.&\\n" NEED_BOTTOM_RULE_REG " \\{");
+    prints(".    if \\nT.&\\n" NEED_BOTTOM_RULE_REG " \\{\\\n");
     print_single_hline(0);
-    prints(".\\}\n");
+    prints(".    \\}\n");
   }
-  prints("." REPEATED_NM_SUS_MACRO " s\n"
-	 ".ls 1\n");
+  prints(".    ls 1\n");
   for (vertical_rule *p = vrule_list; p; p = p->next)
     p->contribute_to_bottom_macro(this);
   if (flags & DOUBLEBOX)
-    prints(".if \\nT. \\{.vs " DOUBLE_LINE_SEP ">?\\n.Vu\n"
+    prints(".  if \\nT. \\{\\\n"
+	   ".    vs " DOUBLE_LINE_SEP ">?\\n.Vu\n"
 	   "\\v'" BODY_DEPTH "'\\s\\n" LINESIZE_REG ""
 	   "\\D'l \\nTWu 0'\\s0\n"
-	   ".vs\n"
-	   ".\\}\n"
-	   ".if \\n" LAST_PASSED_ROW_REG ">=0 "
+	   ".    vs\n"
+	   ".  \\}\n"
+	   ".  if \\n" LAST_PASSED_ROW_REG ">=0 "
 	   ".nr " TOP_REG " \\n#T-" DOUBLE_LINE_SEP "\n"
-	   ".sp -1\n"
+	   ".  sp -1\n"
 	   "\\v'" BODY_DEPTH "'\\s\\n" LINESIZE_REG ""
 	   "\\D'l 0 |\\n" TOP_REG "u-1v'\\s0\n"
-	   ".sp -1\n"
+	   ".  sp -1\n"
 	   "\\v'" BODY_DEPTH "'\\h'|\\nTWu'\\s\\n" LINESIZE_REG ""
 	   "\\D'l 0 |\\n" TOP_REG "u-1v'\\s0\n");
-  prints("." REPEATED_NM_SUS_MACRO " r\n"
-	 ".ls\n");
-  prints(".nr " LAST_PASSED_ROW_REG " \\n" CURRENT_ROW_REG "\n"
-	 ".sp |\\n" SAVED_VERTICAL_POS_REG "u\n"
-	 "." REPEATED_VPT_MACRO " 1\n"
-	 ".\\}\n"
+  prints(".    ls\n");
+  prints(".    nr " LAST_PASSED_ROW_REG " \\n" CURRENT_ROW_REG "\n"
+	 ".    sp |\\n" SAVED_VERTICAL_POS_REG "u\n"
+	 ".    " REPEATED_VPT_MACRO " 1\n");
+  if ((flags & NOKEEP) && (flags & (BOX | DOUBLEBOX | ALLBOX)))
+    prints(".    if (\\n% > \\n" STARTING_PAGE_REG ") \\{\\\n"
+	   ".      tmc \\n.F:\\n.c: warning:\n"
+	   ".      tmc \" boxed, unkept table does not fit on page\n"
+	   ".      tm1 \" \\n" STARTING_PAGE_REG "\n"
+	   ".    \\}\n");
+  prints(".  \\}\n"
 	 "..\n"
 	 ".ig\n"
 	 ".EQ\n"
@@ -2717,26 +2838,27 @@
 
 void table::do_row(int r)
 {
+  printfs(".\\\" do row %1\n", i_to_a(r));
   if (!(flags & NOKEEP) && row_begins_section(r))
-    prints("." KEEP_MACRO_NAME "\n");
-  int had_line = 0;
+    prints(".if \\n" USE_KEEPS_REG " ." KEEP_MACRO_NAME "\n");
+  bool had_line = false;
   stuff *p;
   for (p = stuff_list; p && p->row < r; p = p->next)
     ;
   for (stuff *p1 = p; p1 && p1->row == r; p1 = p1->next)
     if (!p1->printed && (p1->is_single_line() || p1->is_double_line())) {
-      had_line = 1;
+      had_line = true;
       break;
     }
   if (!had_line && !row_is_all_linesr)
     printfs("." REPEATED_MARK_MACRO " %1\n", row_top_reg(r));
-  had_line = 0;
+  had_line = false;
   for (; p && p->row == r; p = p->next)
     if (!p->printed) {
       p->print(this);
       if (!had_line && (p->is_single_line() || p->is_double_line())) {
 	printfs("." REPEATED_MARK_MACRO " %1\n", row_top_reg(r));
-	had_line = 1;
+	had_line = true;
       }
     }
   // change the row *after* printing the stuff list (which might contain .TH)
@@ -2746,9 +2868,7 @@
     printfs("." REPEATED_MARK_MACRO " %1\n", row_top_reg(r));
   // we might have had a .TH, for example,  since we last tried
   if (!(flags & NOKEEP) && row_begins_section(r))
-    prints("." KEEP_MACRO_NAME "\n");
-  prints("." REPEATED_NM_SET_MACRO " d\n"
-	 ".nr " ROW_MAX_LINE_REG " \\nln\n");
+    prints(".if \\n" USE_KEEPS_REG " ." KEEP_MACRO_NAME "\n");
   printfs(".mk %1\n", row_start_reg(r));
   prints(".mk " BOTTOM_REG "\n"
 	 "." REPEATED_VPT_MACRO " 0\n");
@@ -2845,7 +2965,6 @@
     table_entry *e = entryrc;
     if (e) {
       if (e->end_row == r && e->to_simple_entry() == 0) {
-	prints("." REPEATED_NM_SET_MACRO " s\n");
 	e->position_vertically();
 	e->print();
 	prints(".nr " BOTTOM_REG " \\n" BOTTOM_REG ">?\\n.d\n");
@@ -2854,8 +2973,7 @@
       c = e->end_col;
     }
   }
-  prints("." REPEATED_NM_SET_MACRO " m\n"
-	 "." REPEATED_VPT_MACRO " 1\n"
+  prints("." REPEATED_VPT_MACRO " 1\n"
 	 ".sp |\\n" BOTTOM_REG "u\n"
 	 "\\*" TRANSPARENT_STRING_NAME ".nr " NEED_BOTTOM_RULE_REG " 1\n");
   if (r != nrows - 1 && (flags & ALLBOX)) {
@@ -2881,19 +2999,23 @@
     if (printed_one)
       prints("." REPEATED_VPT_MACRO " 1\n");
     if (!(flags & NOKEEP) && row_ends_section(r))
-      prints("." RELEASE_MACRO_NAME "\n");
+      prints(".if \\n" USE_KEEPS_REG " ." RELEASE_MACRO_NAME "\n");
   }
-  prints(".if \\nln .nr ln \\n" ROW_MAX_LINE_REG "\n");
 }
 
 void table::do_top()
 {
+  prints(".\\\" do top\n");
+  prints(".ss \\n" SAVED_INTER_WORD_SPACE_SIZE "\n");
   prints(".fc \002\003\n");
+  if (flags & (BOX | DOUBLEBOX | ALLBOX))
+    prints(".nr " IS_BOXED_REG " 1\n");
+  else
+    prints(".nr " IS_BOXED_REG " 0\n");
   if (!(flags & NOKEEP) && (flags & (BOX | DOUBLEBOX | ALLBOX)))
     prints("." TABLE_KEEP_MACRO_NAME "\n");
   if (flags & DOUBLEBOX) {
-    prints("." REPEATED_NM_SUS_MACRO " s\n"
-	   ".ls 1\n"
+    prints(".ls 1\n"
 	   ".vs " LINE_SEP ">?\\n.Vu\n"
 	   "\\v'" BODY_DEPTH "'\\s\\n" LINESIZE_REG "\\D'l \\nTWu 0'\\s0\n"
 	   ".vs\n"
@@ -2907,24 +3029,31 @@
 	    "\n",
 	    column_divide_reg(0),
 	    column_divide_reg(ncolumns));
-    prints("." REPEATED_NM_SUS_MACRO " r\n"
-	   ".ls\n"
+    prints(".ls\n"
 	   ".vs\n");
   }
-  else if (flags & (ALLBOX | BOX)) {
+  else if (flags & (ALLBOX | BOX))
     print_single_hline(0);
-  }
+  // On terminal devices, a vertical rule on the first row of the table
+  // will stick out 1v above it if it the table is unboxed or lacks a
+  // horizontal rule on the first row.  This is necessary for grotty's
+  // rule intersection detection.  We must make room for it so that the
+  // vertical rule is not drawn above the top of the page.
+  else if ((flags & HAS_TOP_VLINE) && !(flags & HAS_TOP_HLINE))
+    prints(".if n .sp\n");
+  prints(".nr " STARTING_PAGE_REG " \\n%\n");
   //printfs(".mk %1\n", row_top_reg(0));
 }
 
 void table::do_bottom()
 {
+  prints(".\\\" do bottom\n");
   // print stuff after last row
   for (stuff *p = stuff_list; p; p = p->next)
     if (p->row > nrows - 1)
       p->print(this);
   if (!(flags & NOKEEP))
-    prints("." RELEASE_MACRO_NAME "\n");
+    prints(".if \\n" USE_KEEPS_REG " ." RELEASE_MACRO_NAME "\n");
   printfs(".mk %1\n", row_top_reg(nrows));
   prints(".nr " NEED_BOTTOM_RULE_REG " 1\n"
 	 ".nr T. 1\n"
@@ -2942,13 +3071,22 @@
 	 "..\n");
   if (!(flags & NOKEEP) && (flags & (BOX | DOUBLEBOX | ALLBOX)))
     prints("." TABLE_RELEASE_MACRO_NAME "\n");
-  else
-    prints(".if \\nln \\{.nm\n"
-	   ".nr ln \\n" ROW_MAX_LINE_REG "\n"
-	   ".\\}\n");
   if (flags & DOUBLEBOX)
     prints(".sp " DOUBLE_LINE_SEP "\n");
+  // Horizontal box lines take up an entire row on nroff devices (maybe
+  // a half-row if we ever support emulators of devices like the
+  // Teletype Model 37 with half-line motions).
+  if (flags & (BOX | DOUBLEBOX | ALLBOX))
+    prints(".if n .sp\n");
+  // Space again for the doublebox option, until we can draw that more
+  // attractively; see Savannah #43637.
+  if (flags & DOUBLEBOX)
+    prints(".if n .sp\n");
   prints("." RESET_MACRO_NAME "\n"
+	 ".nn \\n" SAVED_NUMBERING_SUPPRESSION_COUNT "\n"
+	 ".ie \\n" SAVED_NUMBERING_LINENO " "
+	 ".nm \\n" SAVED_NUMBERING_LINENO "\n"
+	 ".el .nm\n"
 	 ".fc\n"
 	 ".cp \\n(" COMPATIBLE_REG "\n");
 }
@@ -3007,12 +3145,17 @@
 	  prints('%');
 	  break;
 	default:
-	  assert(0);
+	  assert(0 == "printfs format character not in 1-9%");
 	}
       }
       else
 	prints(c);
     }
   }
-}  
+}
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/tbl/table.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/table.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -20,7 +19,6 @@
 #include "lib.h"
 
 #include <stdlib.h>
-#include <assert.h>
 #include <ctype.h>
 #include <errno.h>
 
@@ -99,12 +97,12 @@
   string *minimum_width;
   int *column_separation;
   char *equal;
-  int left_separation;
-  int right_separation;
+  int left_separation; // from a vertical rule or box border, in ens
+  int right_separation; // from a vertical rule or box border, in ens
   int total_separation;
   int allocated_rows;
   void build_span_list();
-  void compute_expand_width();
+  void compute_overall_width();
   void do_hspan(int r, int c);
   void do_vspan(int r, int c);
   void allocate(int r);
@@ -134,15 +132,19 @@
 public:
   unsigned flags;
   enum {
-    CENTER       = 0x00000001,
-    EXPAND       = 0x00000002,
-    BOX          = 0x00000004,
-    ALLBOX       = 0x00000008,
-    DOUBLEBOX    = 0x00000010,
-    NOKEEP       = 0x00000020,
-    NOSPACES     = 0x00000040,
-    NOWARN       = 0x00000080,
-    EXPERIMENTAL = 0x80000000	// undocumented; use as a hook for experiments
+    CENTER        = 0x00000001,
+    EXPAND        = 0x00000002,
+    BOX           = 0x00000004,
+    ALLBOX        = 0x00000008,
+    DOUBLEBOX     = 0x00000010,
+    NOKEEP        = 0x00000020,
+    NOSPACES      = 0x00000040,
+    NOWARN        = 0x00000080,
+    // The next few properties help manage nroff mode output.
+    HAS_TOP_VLINE = 0x00000100,
+    HAS_TOP_HLINE = 0x00000200,
+    GAP_EXPAND    = 0x00000400,
+    EXPERIMENTAL  = 0x80000000 // undocumented
     };
   char *expand;
   table(int nc, unsigned flags, int linesize, char decimal_point_char);
@@ -169,3 +171,9 @@
 void set_troff_location(const char *, int);
 
 extern int compatible_flag;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/tbl/tbl.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tbl.1.man Changed

@@ -1,19 +1,16 @@
 '\" t
-.TH @G@TBL @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@tbl \- format tables for troff
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr tbl_C \n.C
-.cp 0
+.TH @g@tbl @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@tbl \- prepare tables for
+.I groff
+documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -31,1203 +28,1991 @@
 .\" instead of in the original English.
 .
 .
-.\" Bernd Warken <groff-bernd.warken-72@web.de> added simple examples.
-.\" ====================================================================
-.SH SYNOPSIS
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_tbl_1_man_C \n.cp
+.cp 0
 .
-.SY @g@tbl
-.OP \-Cv
-.RI  file
-\&.\|.\|.\&
-.YS
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Synopsis
 .\" ====================================================================
 .
-This manual page describes the GNU version of
-.BR tbl ,
-which is part of the groff document formatting system.
+.SY @g@tbl
+.RB  \-C 
+.RI  file\~ .\|.\|.
+.YS
 .
-.B tbl
-compiles descriptions of tables embedded within
-.B troff
-input files into commands that are understood by
-.BR troff .
 .
-Normally, it should be invoked using the
-.B \-t
-option of
-.B groff.
+.SY @g@tbl
+.B \-\-help
+.YS
 .
-It is highly compatible with Unix
-.BR tbl .
 .
-The output generated by GNU
-.B tbl
-cannot be processed with Unix
-.BR troff ;
-it must be processed with GNU
-.BR troff .
+.SY @g@tbl
+.B \-v
 .
-If no files are given on the command line or a filename of
-.B \-
-is given, the standard input is read.
+.SY @g@tbl
+.B \-\-version
+.YS
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Description
 .\" ====================================================================
 .
-.TP
-.B \-C
-Enable compatibility mode to
-recognize
+The GNU implementation of
+.I tbl \" generic
+is part of the
+.MR groff @MAN1EXT@
+document formatting system.
+.
+.I @g@tbl
+is a
+.MR @g@troff @MAN1EXT@
+preprocessor that translates descriptions of tables embedded in
+.MR roff @MAN7EXT@
+input files into the language understood by
+.IR @g@troff .
+.
+It copies the contents of each
+.I file
+to the standard output stream,
+except that lines between
 .B .TS
 and
 .B .TE
-even when followed by a character other than space or newline.
-.
-Leader characters (\rsa) are handled as interpreted.
+are interpreted as table descriptions.
+.
+While GNU
+.IR tbl 's \" GNU
+input syntax is highly compatible with AT&T
+.IR tbl , \" AT&T
+the output GNU
+.I tbl \" GNU
+produces cannot be processed by AT&T
+.IR troff ; \" AT&T
+GNU
+.I troff \" GNU
+(or a
+.I troff \" generic
+implementing any GNU extensions employed)
+must be used.
+.
+Normally,
+.I @g@tbl
+is not executed directly by the user,
+but invoked by specifying the
+.B \-t
+option to
+.MR groff @MAN1EXT@ .
 .
-.TP
-.B \-v
-Print the version number.
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I @g@tbl
+reads the standard input stream.
 .
 .
 .\" ====================================================================
-.SH "LANGUAGE OVERVIEW"
+.SS Overview
 .\" ====================================================================
 .
-.B tbl
-expects to find table descriptions wrapped in the
+.I @g@tbl
+expects to find table descriptions between input lines that begin with
 .B .TS
-(table start) and
+(table start)
+and
 .B .TE
-(table end) macros.
-.
-Within each such table sections, another table can be defined by
-using the request
-.B .T&
-before the final command
-.BR .TE .
-.
-Each table definition has the following structure:
+(table end).
 .
-.TP
-.I Global options
-This is optional.
-.
-This table part can use several of these options distributed in 1 or
-more lines.
-.
-The
-.I global option part
-must always be finished by a
-.B "semi-colon ;" .
+Each such
+.I table region
+encloses one or more table descriptions.
 .
-.TP
-.I Table format specification
-.
-This part must be given, it is not optional.
+Within a table region,
+table descriptions beyond the first must each be preceded
+by an input line beginning with
+.BR .T& .
 .
-It determines the number of columns (cells) of the table.
+This mechanism does not start a new table region;
+all table descriptions are treated as part of their
+.BR .TS / .TE
+enclosure,
+even if they are boxed or have column headings that repeat on subsequent
+pages
+(see below).
 .
-Moreover each cell is classified by being central, left adjusted, or
-numerical, etc.
 .
-This specification can have several lines, but must be finished by a
-.B dot .
-at the end of the last line.
+.P
+(Experienced
+.I roff
+users should observe that
+.I @g@tbl
+is not a
+.I roff
+language interpreter:
+the default control character must be used,
+and no spaces or tabs are permitted between the control character and
+the macro name.
+.
+These
+.I @g@tbl
+input tokens remain as-is in the output,
+where they become ordinary macro calls.
+.
+Macro packages often define
+.BR TS ,
+.BR T& ,
+and
+.B TE
+macros to handle issues of table placement on the page.
 .
-After each cell definition,
-.I column specifiers
-can be appended, but that's optional.
+.I @g@tbl
+produces
+.I groff
+code to define these macros as empty if their definitions do not exist
+when the formatter encounters a table region.)
 .
 .
 .P
-Cells are separated by a tab character by default.
+Each table region may begin with
+.I region options,
+and must contain one or more
+.I table definitions;
+each table definition contains a
+.I format specification
+followed by one or more input lines (rows) of
+.I entries.
+.
+These entries comprise the
+.I table data.
 .
-That can be changed by the
-.I global option
-.BI tab( c )\c
-,
-where
-.I c
-is an arbitrary character.
 .
 .
 .\" ====================================================================
-.SH "SIMPLE EXAMPLES"
+.SS "Region options"
 .\" ====================================================================
 .
-The easiest table definition is.
-.RS
-.EX
-\&.TS
-c c c .
-This	is	centered
-Well,	this	also
-\&.TE
-.EE
-.RE
-.
-.
-By using
-.B c c
-.BR c ,
-each cell in the whole table will be centered.
-.
-The separating character is here the default
-.IR tab .
-.
+The line immediately following the
+.B .TS
+token may specify region options,
+keywords that influence the interpretation or rendering of the region as
+a whole or all table entries within it indiscriminately.
 .
-.P
-The result is
-.RS
-.TS
-c c c .
-This	is	centered
-Well,	this	also
-.TE
-.RE
+They must be separated by commas,
+spaces,
+or tabs.
 .
+Those that require a parenthesized argument permit spaces and tabs
+between the option's name and the opening parenthesis.
 .
-.P
-This definition is identical to
-.RS
-.EX
-\&.TS
-tab(@);
-ccc.
-This@is@centered
-Well,@this@also
-\&.TE
-.EE
-.RE
+Options accumulate and cannot be unset within a region once declared;
+if an option that takes a parameter is repeated,
+the last occurrence controls.
 .
-Here, the separating tab character is changed to the letter
-.BR @ .
+If present,
+the set of region options must be terminated with a semicolon
+.RB ( ; ).
 .
 .
 .P
-Moreover a title can be added and the centering directions can be
-changed to many other formats:
-.RS
-.EX
-\&.TS
-tab(@);
-c s s
-l c n .
-Title
-left@centers@123
-another@number@75
-\&.TE
-.EE
-.RE
-.
-The result is
-.RS
-.TS
-tab(@);
-c s s
-l c n .
-Title
-left@centers@123
-another@number@75
-.TE
-.RE
-.
-Here
-.B l
-means
-.IR left\-justified ,
+Any of the
+.BR allbox ,
+.BR box ,
+.BR doublebox ,
+.BR frame ,
 and
-.B n
-means
-.IR numerical ,
-which is here
-.IR right\-justified .
-.
-.
-.\" ====================================================================
-.SH USAGE
-.
-.\" ====================================================================
-.SS Global options
-.\" ====================================================================
+.B doubleframe
+region options makes a table \lqboxed\rq for the purpose of later
+discussion.
 .
-The line immediately following the
-.B .TS
-macro may contain any of the following global options (ignoring the
-case of characters \en Unix tbl only accepts options with all
-characters lowercase or all characters uppercase), separated by
-spaces, tabs, or commas:
 .
 .TP
 .B allbox
-Enclose each item of the table in a box.
+Enclose each table entry in a box;
+implies
+.BR box .
+.
 .
 .TP
 .B box
-Enclose the table in a box.
+Enclose the entire table region in a box.
+.
+As a GNU extension,
+the alternative option name
+.B frame
+is also recognized.
+.
 .
 .TP
 .B center
-Center the table (default is left-justified).
+Center the table region with respect to the current indentation and line
+length;
+the default is to left-align it.
 .
-The alternative keyword name
+As a GNU extension,
+the alternative option name
 .B centre
-is also recognized (this is a GNU tbl extension).
+is also recognized.
+.
 .
 .TP
 .BI decimalpoint( c )
-Set the character to be recognized as the decimal point in numeric
-columns (GNU tbl only).
+Recognize character
+.I c
+as the decimal separator in columns using the
+.B N
+(numeric) classifier
+(see subsection \lqColumn classifiers\rq below).
+.
+This is a GNU extension.
+.
 .
 .TP
 .BI delim( xy )
-Use
+Recognize characters
+.I x
+.RI and\~ y
+as start and end delimiters,
+respectively,
+for
+.MR @g@eqn @MAN1EXT@
+input,
+and ignore input between them.
+.
 .I x
-and\~\c
-.I y
-as start and end delimiters for
-.BR @g@eqn (@MAN1EXT@).
+.RI and\~ y
+need not be distinct.
+.
 .
 .TP
 .B doublebox
-Enclose the table in a double box.
+Enclose the entire table region in a double box;
+implies
+.BR box .
+.
+As a GNU extension,
+the alternative option name
+.B \%doubleframe
+is also recognized.
 .
-.TP
-.B doubleframe
-Same as doublebox (GNU tbl only).
 .
 .TP
 .B expand
-Make the table as wide as the current line length (providing a column
-separation factor).
+Spread the table horizontally to fill the available space
+(line length minus indentation)
+by increasing column separation.
 .
-Ignored if one or more \oqx\cq column specifiers are used (see
-below).
+Ordinarily,
+a table is made only as wide as necessary to accommodate the widths of
+its entries and its column separations
+(whether specified or default).
 .
-.IP
-In case the sum of the column widths is larger than the current line length,
-the column separation factor is set to zero; such tables extend into the
-right margin, and there is no column separation at all.
+When
+.B expand
+applies to a table that exceeds the available horizontal space,
+column separation is reduced as far as necessary
+(even to zero).
+.
+.I @g@tbl
+produces
+.I groff
+input that issues a diagnostic if such compression occurs.
+.
+The column modifier
+.B x
+(see below)
+overrides this option.
 .
-.TP
-.B frame
-Same as box (GNU tbl only).
 .
 .TP
 .BI linesize( n )
-Set lines or rules (e.g.\& from
+Draw lines or rules
+(e.g.,
+from
 .BR box )
-in
-.IR n -point
-type.
+with a thickness of
+.IR n \~points.
+.
+The default is the current type size when the region begins.
+.
+This option is ignored on terminal devices.
+.
 .
 .TP
 .B nokeep
-Don't use diversions to prevent page breaks (GNU tbl only).
+Don't use
+.I roff
+diversions to manage page breaks.
 .
-Normally
-.B tbl
-attempts to prevent undesirable breaks in boxed tables by using diversions.
+Normally,
+.I @g@tbl
+employs them to avoid breaking a page within a table row.
+.
+This usage can sometimes interact badly with macro packages' own use of
+diversions\emwhen footnotes,
+for example,
+are employed.
+.
+This is a GNU extension.
 .
-This can sometimes interact badly with macro packages' own use of
-diversions\emwhen footnotes, for example, are used.
 .
 .TP
 .B nospaces
-Ignore leading and trailing spaces in data items (GNU tbl only).
+Ignore leading and trailing spaces in table entries.
+.
+This is a GNU extension.
+.
 .
 .TP
 .B nowarn
-Turn off warnings related to tables exceeding the current line width
-(GNU tbl only).
+Suppress diagnostic messages produced at document formatting time when
+the line or page lengths are inadequate to contain a table row.
 .
+This is a GNU extension.
+.
+.
+.\" TODO: How about "right"?  (and "left" for symmetry)
 .TP
-.BI tab( x )
+.BI tab( c )
 Use the character
-.I x
-instead of a tab to separate items in a line of input data.
+.I c
+instead of a tab to separate entries in a row of table data.
 .
 .
-.LP
-The global options must end with a semicolon.
+.\" ====================================================================
+.SS "Table format specification"
+.\" ====================================================================
 .
-There might be whitespace between an option and its argument in
-parentheses.
+The table format specification is mandatory:
+it determines the number of columns in the table and directs how the
+entries within it are to be typeset.
 .
+The format specification is a series of column
+.I descriptors.
 .
-.\" ====================================================================
-.SS Table format specification
-.\" ====================================================================
+Each descriptor encodes a
+.I classifier
+followed by zero or more
+.I modifiers.
 .
-After global options come lines describing the format of each line of
-the table.
+Classifiers are letters
+(recognized case-insensitively)
+or punctuation symbols;
+modifiers consist of or begin with letters or numerals.
 .
-Each such format line describes one line of the table itself, except
-that the last format line (which you must end with a period) describes
-all remaining lines of the table.
+Spaces,
+tabs,
+newlines,
+and commas separate descriptors.
 .
-A single-key character describes each column of each line of the table.
-Key characters can be separated by spaces or tabs.
+Newlines and commas are special;
+they apply the descriptors following them to a subsequent row of the
+table.
 .
-You may run format specifications for multiple lines together on the
-same line by separating them with commas.
+(This enables column headings to be centered or emboldened while the
+table entries for the data are not,
+for instance.)
 .
+We term the resulting group of column descriptors a
+.I row definition.
 .
-.LP
-You may follow each key character with specifiers that determine the
-font and point size of the corresponding item, that determine column
-width, inter-column spacing, etc.
+Within a row definition,
+separation between column descriptors
+(by spaces or tabs)
+is often optional;
+only some modifiers,
+described below,
+make separation necessary.
 .
 .
-.LP
-The longest format line defines the number of columns in the table;
-missing format descriptors at the end of format lines are assumed to
-be\~\c
-.BR L .
+.P
+Each column descriptor begins with a mandatory
+.I classifier,
+a character that selects from one of several arrangements.
+.
+Some determine the positioning of table entries within a rectangular
+cell:
+centered,
+left-aligned,
+numeric
+(aligned to a configurable decimal separator),
+and so on.
+.
+Others perform special operations like drawing lines or spanning entries
+from adjacent cells in the table.
+.
+Except for
+.RB \lq | \rq,
+any classifier can be followed by one or more
+.I modifiers;
+some of these accept an argument,
+which in GNU
+.I tbl \" GNU
+can be parenthesized.
+.\" AT&T tbl allowed parentheses only after 'w'.
+.\" TODO: Accept parentheses after 'p' and 'v'.
+.
+Modifiers select fonts,
+set the type size,
+.\"define the column width,
+.\"adjust inter-column spacing, \" slack text for window/orphan control
+and perform other tasks described below.
 .
-Extra columns in the data (which have no corresponding format entry)
-are ignored.
 .
+.P
+The format specification can occupy multiple input lines,
+but must conclude with a dot
+.RB \lq .\& \rq
+followed by a newline.
 .
-.LP
-The available key characters are:
+Each row definition is applied in turn to one row of the table.
 .
-.TP
-.BR a , A
-Center longest line in this column and then left-justifies all other
-lines in this column with respect to that centered line.
-.
-The idea is to use such alphabetic subcolumns (hence the name of the
-key character) in combination with\~
-.BR L ;
-they are called subcolumns because
-.BR A \~items
-are indented by\~1n relative to
-.BR L \~entries.
-.
-Example:
-.RS
-.IP
-.EX
-\&.TS
-\&tab(;);
-\&ln,an.
-\&item one;1
-\&subitem two;2
-\&subitem three;3
-\&.T&
-\&ln,an.
-\&item eleven;11
-\&subitem twentytwo;22
-\&subitem thirtythree;33
-\&.TE
-.EE
-.RE
+The last row definition is applied to rows of table data in excess of
+the row definitions.
 .
-.IP
-Result:
 .
-.RS
-.IP
-.TS
-tab(;);
-ln,an.
-item one;1
-subitem two;2
-subitem three;3
-.T&
-ln,an.
-item eleven;11
-subitem twentytwo;22
-subitem thirtythree;33
-.TE
-.RE
+.P
+For clarity in this document's examples,
+we shall write classifiers in uppercase and modifiers in lowercase.
+.
+Thus,
+.RB \lq CbCb,LR.\& \rq
+defines two rows of two columns.
+.
+The first row's entries are centered and boldfaced;
+the second and any further rows' first and second columns are left- and
+right-aligned,
+respectively.
+.
+.\" slack text for window/orphan control
+.\"If more rows of entries are added to the table data,
+.\"they reuse the row definition
+.\".RB \lq LR \rq.
+.
+.
+.P
+The row definition with the most column descriptors determines the
+number of columns in the table;
+any row definition with fewer is implicitly extended on the right-hand
+side with
+.B L
+classifiers as many times as necessary to make the table rectangular.
+.
+.
+.\" ====================================================================
+.SS "Column classifiers"
+.\" ====================================================================
+.
+The
+.BR L ,
+.BR R ,
+and
+.B C
+classifiers are the easiest to understand and use.
+.
 .
 .TP
-.BR c , C
-Center item within the column.
+.BR A ,\~ a
+Center longest entry in this column,
+left-align remaining entries in the column with respect to the centered
+entry,
+then indent all entries by one en.
+.
+Such \lqalphabetic\rq entries
+(hence the name of the classifier)
+can be used in the same column as
+.BR L -classified
+entries,
+as in
+.RB \lq LL,AR.\& \rq.
+.
+The
+.B A
+entries are often termed \lqsub-columns\rq due to their indentation.
+.
 .
 .TP
-.BR l , L
-Left-justify item within the column.
+.BR C ,\~ c
+Center entry within the column.
+.
 .
 .TP
-.BR n , N
-Numerically justify item in the column: Units positions of numbers are
-aligned vertically.
+.BR L ,\~ l
+Left-align entry within the column.
 .
-If there is one or more dots adjacent to a digit, use the rightmost one for
-vertical alignment.
 .
-If there is no dot, use the rightmost digit for vertical alignment;
-otherwise, center the item within the column.
+.TP
+.BR N ,\~ n
+Numerically align entry in the column.
 .
-Alignment can be forced to a certain position using \oq\rs&\cq;
-if there is one or more instances of this special (non-printing)
-character present within the data, use the leftmost one for alignment.
+.I @g@tbl
+aligns columns of numbers vertically at the units place.
 .
-Example:
-.RS
-.IP
-.EX
-\&.TS
-\&n.
-\&1
-\&1.5
-\&1.5.3
-\&abcde
-\&a\rs&bcde
-\&.TE
-.EE
-.RE
+If multiple decimal separators are adjacent to a digit,
+it uses the rightmost one for vertical alignment.
 .
-.IP
-Result:
+If there is no decimal separator,
+the rightmost digit is used for vertical alignment;
+otherwise,
+.I @g@tbl
+centers the entry within the column.
+.
+The
+.I roff
+dummy character
+.B \rs&
+in an entry marks the glyph preceding it
+(if any)
+as the units place;
+if multiple instances occur in the data,
+the leftmost is used for alignment.
 .
-.RS
-.IP
-.TS
-n.
-1
-1.5
-1.5.3
-abcde
-a\&bcde
-.TE
-.RE
 .
 .IP
-If numerical entries are combined with
+If
+.BR N -classified
+entries share a column with
 .B L
 or
-.BR R \~entries
-\en this can happen if the table format is changed with
-.B .T&
-\%\en
-center the widest
-.I number
-(of the data entered under the
-.BR N \~specifier
-regime) relative to the widest
+.BR R \~entries,
+.I @g@tbl
+centers the widest
+.BR N \~entry
+with respect to the widest
 .B L
 or
 .BR R \~entry,
-preserving the alignment of all numerical entries.
+preserving the alignment of
+.BR N \~entries
+with respect to each other.
 .
-Contrary to
-.BR A \~type
-entries, there is no extra indentation.
 .
 .IP
-Using equations (to be processed with
-.BR eqn )
-within columns which use the
-.BR N \~specifier
-is problematic in most cases due to
-.BR tbl 's
-algorithm for finding the vertical alignment, as described above.
-.
-Using the global
-.B delim
-option, however, it is possible to make
-.B tbl
+The appearance of
+.I @g@eqn
+equations
+within
+.BR N -classified
+columns
+can be troublesome due to the foregoing textual scan for a decimal
+separator.
+.
+Use the
+.B \%delim
+region option to make
+.I @g@tbl
 ignore the data within
-.B eqn
+.I eqn
 delimiters for that purpose.
 .
 .
 .TP
-.BR r , R
-Right-justify item within the column.
+.BR R ,\~ r
+Right-align entry within the column.
+.
 .
 .TP
-.BR s , S
-Span previous item on the left into this column.
+.BR S ,\~ s
+Span previous entry on the left into this column.
 .
-Not allowed for the first column.
 .
 .TP
-.B ^
-Span down entry from previous row in this column.
+.B \ha
+Span entry in the same column from the previous row into this row.
 .
-Not allowed for the first row.
 .
 .TP
-.BR _ , -
-Replace this entry with a horizontal line.
+.BR _ ,\~ \-
+Replace table entry with a horizontal rule.
+.
+An empty table entry is expected to correspond to this classifier;
+if data are found there,
+.I @g@tbl
+issues a diagnostic message.
 .
-Note that \oq_\cq and \oq-\cq can be used for table fields only,
-not for column separator lines.
 .
 .TP
 .B =
+Replace table entry with a double horizontal rule.
 .
-Replace this entry with a double horizontal line.
+An empty table entry is expected to correspond to this classifier;
+if data are found there,
+.I @g@tbl
+issues a diagnostic message.
 .
-Note that \oq=\cq can be used for table fields only,
-not for column separator lines.
 .
 .TP
 .B |
-The corresponding column becomes a vertical rule (if two of these are
-adjacent, a double vertical rule).
+Place a vertical rule (line) on the corresponding row of the table
+(if two of these are adjacent,
+a double vertical rule).
 .
+This classifier does not contribute to the column count and no table
+entries correspond to it.
 .
-.LP
-A vertical bar to the left of the first key letter or to the right of
-the last one produces a line at the edge of the table.
+A
+.B |
+to the left of the first column descriptor or to the right of the last
+one produces a vertical rule at the edge of the table;
+these are redundant
+(and ignored)
+in boxed tables.
 .
 .
-.LP
-To change the data format within a table, use the
+.P
+To change the table format within a
+.I @g@tbl
+region,
+use the
 .B .T&
-command (at the start of a line).
+token at the start of a line.
+.
+It is followed by a format specification and table data,
+but
+.I not
+region options.
+.
+The quantity of columns in a new table format thus introduced cannot
+increase relative to the previous table format;
+in that case,
+you must end the table region and start another.
+.
+If that will not serve because the region uses box options or the
+columns align in an undesirable manner,
+you must design the initial table format specification to include the
+maximum quantity of columns required,
+and use the
+.B S
+horizontal spanning classifier where necessary to achieve the desired
+columnar alignment.
 .
-It is followed by format and data lines (but no global options)
-similar to the
-.B .TS
-request.
+.
+.P
+Attempting to horizontally span in the first column or vertically span
+on the first row is an error.
+.
+Non-rectangular span areas are also not supported.
 .
 .
 .\" ====================================================================
-.SS Column specifiers
+.SS "Column modifiers"
 .\" ====================================================================
 .
-Here are the specifiers that can appear in suffixes to column key
-letters (in any order):
+Any number of modifiers can follow a column classifier.
 .
-.TP
-.BR b , B
-Short form of
-.B fB
-(make affected entries bold).
+Arguments to modifiers,
+where accepted,
+are case-sensitive.
 .
-.TP
-.BR d , D
-Start an item that vertically spans rows,
-using the \oq^\cq column specifier or \oq\rs^\cq data item,
-at the bottom of its range rather
-than vertically centering it (GNU tbl only).
+If the same modifier is applied to a column specifier more than once,
+or if conflicting modifiers are applied,
+only the last occurrence has effect.
 .
-Example:
-.RS
-.IP
-.EX
-\&.TS
-\&tab(;) allbox;
-\&l l
-\&l ld
-\&r ^
-\&l rd.
-\&0000;foobar
-\&T{
-\&1111
-\&.br
-\&2222
-\&T};foo
-\&r;
-\&T{
-\&3333
-\&.br
-\&4444
-\&T};bar
-\&\rs^;\rs^
-\&.TE
-.EE
-.RE
+The
+.RB modifier\~ x
+is mutually exclusive with
+.B e
+.RB and\~ w ,
+but
+.B e
+is not mutually exclusive
+.RB with\~ w ;
+if these are used in combination,
+.BR x \~unsets
+both
+.B e
+.RB and\~ w ,
+while either
+.B e
+or
+.B w
+.RB overrides\~ x .
 .
-.IP
-Result:
 .
-.RS
-.IP
-.TS
-tab(;) allbox;
-l l
-l ld
-r ^
-l rd.
-0000;foobar
-T{
-1111
-.br
-2222
-T};foo
-r;
-T{
-3333
 .br
-4444
-T};bar
-\^;\^
-.TE
-.RE
+.ne 4v \" Keep next two tagged paragraphs together.
+.TP
+.BR b ,\~ B
+Typeset entry in boldface,
+abbreviating
+.BR f(B) .
+.
 .
 .TP
-.BR e , E
-Make equally-spaced columns.
+.BR d ,\~ D
+Align a vertically spanned table entry to the bottom
+(\lqdown\rq),
+instead of the center,
+of its range.
+.
+This is a GNU extension.
 .
-All columns marked with this specifier get the same width; this happens
-after the affected column widths have been computed (this means that the
-largest width value rules).
 .
 .TP
-.BR f , F
-Either of these specifiers may be followed by a font name (either one or two
-characters long), font number (a single digit), or long name in parentheses
-(the last form is a GNU tbl extension).
+.BR e ,\~ E
+Equalize the widths of columns with this modifier.
+.
+The column with the largest width controls.
+.
+This modifier sets the default line length used in a text block.
 .
-A one-letter font name must be separated by one or more blanks from whatever
-follows.
 .
 .TP
-.BR i , I
-Short form of
-.B fI
-(make affected entries italic).
+.BR f ,\~ F
+Select the typeface for the table entry.
+.
+This modifier must be followed by a font or style name
+(one or two characters not starting with a digit),
+font mounting position
+(a single digit),
+or a name or mounting position of any length in parentheses.
+.
+The last form is a GNU extension.
+.
+(The parameter corresponds to that accepted by the
+.I troff \" generic
+.B ft
+request.)
+.
+A one-character argument not in parentheses must be separated by one or
+more spaces or tabs from what follows.
+.
 .
 .TP
-.BR m , M
-This is a GNU tbl extension.
+.BR i ,\~ I
+Typeset entry in an oblique or italic face,
+abbreviating
+.BR f(I) .
 .
-Either of these specifiers may be followed by a macro name
-(either one or two characters long),
-or long name in parentheses.
 .
-A one-letter macro name must be separated by one or more blanks from
-whatever follows.
+.TP
+.BR m ,\~ M
+Call a
+.I groff
+macro before typesetting a text block
+(see subsection \lqText blocks\rq below).
+.
+This is a GNU extension.
 .
-The macro which name can be specified here must be defined before
-creating the table.
+This modifier must be followed by a macro name of one or two characters
+or a name of any length in parentheses.
 .
-It is called just before the table's cell text is output.
+A one-character macro name not in parentheses must be separated by one
+or more spaces or tabs from what follows.
 .
-As implemented currently, this macro is only called if block input is
-used, that is, text between \oqT{\cq and \oqT}\cq.
+The named macro must be defined before the table region containing this
+column modifier is encountered.
 .
 The macro should contain only simple
-.B troff
-requests to change the text block formatting, like text adjustment,
-hyphenation, size, or font.
+.I groff
+requests to change text formatting,
+like adjustment or hyphenation.
 .
 The macro is called
 .I after
-other cell modifications like
+the column modifiers
 .BR b ,
-.B f
-or
+.BR f ,
+.BR i ,
+.BR p ,
+and
 .B v
-are output.
+take effect;
+it can thus override other column modifiers.
 .
-Thus the macro can overwrite other modification specifiers.
 .
 .TP
-.BR p , P
-Followed by a number, this does a point size change for the affected fields.
+.BR p ,\~ P
+Set the type size for the table entry.
+.
+This modifier must be followed by an
+.RI integer\~ n
+with an optional leading sign.
+.
+If unsigned,
+the type size is set to
+.IR n \~scaled
+points.
+.
+Otherwise,
+the type size is incremented or decremented per the sign by
+.IR n \~scaled
+points.
+.
+The use of a signed multi-digit number is a GNU extension.
 .
-If signed, the current point size is incremented or decremented (using
-a signed number instead of a signed digit is a GNU tbl extension).
+(The parameter corresponds to that accepted by the
+.I troff \" generic
+.B ps
+request.)
+.
+If a type size modifier is followed by a column separation modifier
+(see below),
+they must be separated by at least one space or tab.
+.\" TODO: Allow parentheses so scaling units and fractional values can
+.\" be used?
 .
-A point size specifier followed by a column separation number must be
-separated by one or more blanks.
 .
 .TP
-.BR t , T
-Start an item vertically spanning rows at the top of its range rather than
-vertically centering it.
+.BR t ,\~ T
+Align a vertically spanned table entry to the top,
+instead of the center,
+of its range.
+.
 .
 .TP
-.BR u , U
-Move the corresponding column up one half-line.
+.BR u ,\~ U
+Move the column up one half-line,
+\lqstaggering\rq the rows.
+.
+This is a GNU extension.
+.
 .
 .TP
-.BR v , V
-Followed by a number, this indicates the vertical line spacing to be
-used in a multi-line table entry.
+.BR v ,\~ V
+Set the vertical spacing to be used in a text block.
+.
+This modifier must be followed by an
+.RI integer\~ n
+with an optional leading sign.
+.
+If unsigned,
+the vertical spacing is set to
+.IR n\~ points.
+.
+Otherwise,
+the vertical spacing is incremented or decremented per the sign by
+.IR n\~ points.
+.
+The use of a signed multi-digit number is a GNU extension.
 .
-If signed, the current vertical line spacing is incremented or
-decremented (using a signed number instead of a signed digit is a GNU
-tbl extension).
+(This parameter corresponds to that accepted by the
+.I troff \" generic
+.B vs
+request.)
 .
-A vertical line spacing specifier followed by a column separation
-number must be separated by one or more blanks.
+If a vertical spacing modifier is followed by a column separation
+modifier
+(see below),
+they must be separated by at least one space or tab.
+.\" TODO: Allow parentheses so scaling units and fractional values can
+.\" be used?
 .
-No effect if the corresponding table entry isn't a text block.
 .
 .TP
-.BR w , W
-Minimum column width value.
-Must be followed either by a
-.BR @g@troff (@MAN1EXT@)
-width expression in parentheses or a unitless integer.
+.BR w ,\~ W
+Set the column's minimum width.
 .
-If no unit is given, en units are used.
+This modifier must be followed by a number,
+which is either a unitless integer,
+or a
+.I roff
+horizontal measurement in parentheses.
 .
-Also used as the default line length for included text blocks.
+Parentheses are required if the width is to be followed immediately by
+an explicit column separation
+(alternatively,
+follow the width with one or more spaces or tabs).
+.
+If no unit is specified,
+ens are assumed.
+.
+This modifier sets the default line length used in a text block.
 .
-If used multiple times to specify the width for a particular column,
-the last entry takes effect.
 .
 .TP
-.BR x , X
-An expanded column.
+.BR x ,\~ X
+Expand the column.
 .
-After computing all column widths without an
-.BR x \~specifier,
-use the remaining line width for this column.
+After computing the column widths,
+distribute any remaining line length evenly over all columns bearing
+this modifier.
 .
-If there is more than one expanded column, distribute the remaining
-horizontal space evenly among the affected columns (this is a GNU
-extension).
+Applying the
+.BR x \~modifier
+to more than one column is a GNU extension.
+.\" 'x' wasn't documented at all in Lesk 1979.
+.
+This modifier sets the default line length used in a text block.
 .
-This feature has the same effect as specifying a minimum column width.
 .
 .TP
-.BR z , Z
-Ignore the corresponding column for width-calculation purposes, this
-is, don't use the fields but only the specifiers of this column to
-compute its width.
+.BR z ,\~ Z
+Ignore the table entries corresponding to this column for width
+calculation purposes;
+that is,
+compute the column's width using only the information in its descriptor.
 .
 .
-.LP
-A number suffix on a key character is interpreted as a column
-separation in en units (multiplied in proportion if the
+.TP
+.I n
+A numeric suffix on a column descriptor sets the separation distance
+(in ens)
+from the succeeding column;
+the default separation is
+.BR 3n .
+.
+This separation is
+proportionally multiplied if the
 .B expand
-option is on \en in case of overfull tables this might be zero).
+region option is in effect;
+in the case of tables wider than the output line length,
+this separation might be zero.
 .
-Default separation is 3n.
+A negative separation cannot be specified.
 .
-.
-.LP
-The column
-.RB specifier\~ x
-is mutually exclusive with
-.B e
-.RB and\~ w
-(but
-.B e
-is not mutually exclusive
-.RB with\~ w );
-if specified multiple times for a particular column, the last entry takes
-effect:
-.BR x \~unsets
-both
-.B e
-.RB and\~ w ,
-while either
-.B e
-or
-.B w
-.RB overrides\~ x .
+A separation amount after the last column in a row is nonsensical and
+provokes a diagnostic from
+.IR @g@tbl .
 .
 .
 .\" ====================================================================
-.SS Table data
+.SS "Table data"
 .\" ====================================================================
 .
-The format lines are followed by lines containing the actual data for the
-table, followed finally by
-.BR .TE .
+The table data come after the format specification.
 .
-Within such data lines, items are normally separated by tab characters
-(or the character specified with the
+Each input line corresponds to a table row,
+except that a backslash at the end of a line of table data continues an
+entry on the next input line.
+.
+(Text blocks,
+discussed below,
+also spread table entries across multiple input lines.)
+.
+Table entries within a row are separated in the input by a tab character
+by default;
+see the
 .B tab
-option).
+region option above.
 .
-Long input lines can be broken across multiple lines if the last
-character on the line is \oq\rs\cq (which vanishes after
-concatenation).
+Excess entries in a row of table data
+(those that have no corresponding column descriptor,
+not even an implicit one arising from rectangularization of the table)
+are discarded with a diagnostic message.
 .
+.I roff
+control lines are accepted between rows of table data and within text
+blocks.
 .
-.LP
-Note that
-.B @g@tbl
-computes the column widths line by line, applying \rsw on each entry
-which isn't a text block.
+If you wish to visibly mark an empty table entry in the document source,
+populate it with the
+.B \rs&
+.I roff
+dummy character.
 .
-As a consequence, constructions like
-.IP
-.EX
-\&.TS
-\&c,l.
-\&\rss20MM
-\&MMMM
-\&.TE
-.EE
+The table data are interrupted by a line consisting of the
+.B .T&
+input token,
+and conclude with the line
+.BR .TE .
+.
+.
+.P
+Ordinarily,
+a table entry is typeset rigidly.
+.
+It is not filled,
+broken,
+hyphenated,
+adjusted,
+or populated with additional inter-sentence space.
+.
+.I @g@tbl
+instructs the formatter to measure each table entry as it occurs in the
+input,
+updating the width required by its corresponding column.
+.
+If the
+.B z
+modifier applies to the column,
+this measurement is ignored;
+if
+.B w
+applies and its argument is larger than this width,
+that argument is used instead.
+.
+In contrast to conventional
+.I roff
+input
+(within a paragraph,
+say),
+changes to text formatting,
+such as font selection or vertical spacing,
+do not persist between entries.
+.
+.
+.P
+Several forms of table entry are interpreted specially.
 .
-.LP
-fail; you must either say
-.IP
-.EX
-\&.TS
-\&cp20,lp20.
-\&MM
-\&MMMM
-\&.TE
-.EE
 .
-.LP
+.IP \bu 2n
+If a table row contains only an underscore or equals sign
+.RB ( _
 or
+.BR = ),
+a single or double horizontal rule (line),
+respectively,
+is drawn across the table at that point.
 .
-.IP
-.EX
-\&.TS
-\&c,l.
-\&\rss20MM
-\&\rss20MMMM
-\&.TE
-.EE
+.
+.IP \bu 2n
+A table entry containing only
+.B _
+or
+.B =
+on an otherwise populated row is replaced by a single or double
+horizontal rule,
+respectively,
+joining its
+neighbors.
 .
 .
-.LP
-A dot starting a line, followed by anything but a digit is handled as
-a troff command, passed through without changes.
+.IP \bu 2n
+Prefixing a lone underscore or equals sign with a backslash also has
+meaning.
+.
+If a table entry consists only of
+.B \rs_
+or
+.B \rs=
+on an otherwise populated row,
+it is replaced by a single or double horizontal rule,
+respectively,
+that does
+.I not
+(quite) join its neighbors.
+.
+.
+.IP \bu
+A table entry consisting of
+.BI \rsR x\c
+,
+where
+.IR x \~is
+any
+.I roff
+ordinary or special character,
+is replaced by enough repetitions of the glyph corresponding
+.RI to\~ x
+to fill the column,
+albeit without joining its neighbors.
+.\" TODO: Bad things happen if there's garbage in the entry after 'x',
+.\" which can be a *roff special character escape sequence, so
+.\" validation is not trivial.
+.
+.
+.IP \bu
+On any row but the first,
+a table entry of
+.B \rs\ha
+causes the entry above it to span down into the current one.
 .
-The table position is unchanged in this case.
 .
+.P
+On occasion,
+these special tokens may be required as literal table data.
 .
-.LP
-If a data line consists of only \oq_\cq or \oq=\cq, a single
-or double line, respectively, is drawn across the table at that point;
-if a single item in a data line consists of only \oq_\cq or
-\oq=\cq, then that item is replaced by a single or double line,
-joining its neighbours.
+To use either
+.B _
+or
+.B =
+literally and alone in an entry,
+prefix or suffix it with the
+.I roff
+dummy character
+.BR \rs& .
+.
+To express
+.BR \rs_ ,
+.BR \rs= ,
+or
+.BR \rsR ,
+use a
+.I roff
+escape sequence to interpolate the backslash
+.RB ( \rse
+or
+.BR \rsrs ).
 .
-If a data item consists only of \oq\rs_\cq or \oq\rs=\cq,
-a single or double line, respectively, is drawn across the field at
-that point which does not join its neighbours.
+A reliable way to emplace the
+.B \rs\ha
+glyph sequence within a table entry is to use a pair of
+.I groff
+special character escape sequences
+.RB ( \rsrs\rsha ).
 .
 .
-.LP
-A data item consisting only of \oq\rsRx\cq (\oqx\cq any
-character) is replaced by repetitions of character \oqx\cq as wide
-as the column (not joining its neighbours).
+.P
+Rows of table entries can be interleaved with
+.I groff
+control lines;
+these do not count as table data.
 .
+On such lines the default control character
+.RB ( .\& )
+must be used
+(and not changed);
+the no-break control character is not recognized.
 .
-.LP
-A data item consisting only of \oq\rs^\cq indicates that the
-field immediately above spans downward over this row.
+To start the first table entry in a row with a dot,
+precede it with the
+.I roff
+dummy character
+.BR \rs& .
 .
 .
 .\" ====================================================================
-.SS Text blocks
+.SS "Text blocks"
 .\" ====================================================================
 .
-A text block can be used to enter data as a single entry which would
-be too long as a simple string between tabs.
+An ordinary table entry's contents can make a column,
+and therefore the table,
+excessively wide;
+the table then exceeds the line length of the page,
+and becomes ugly or is exposed to truncation by the output device.
 .
-It is started with \oqT{\cq and closed with \oqT}\cq.
+When a table entry requires more conventional typesetting,
+breaking across more than one output line
+(and thereby increasing the height of its row),
+it can be placed within a
+.I text block.
 .
-The former must end a line, and the latter must start a line, probably
-followed by other data columns (separated with tabs or the character
-given with the
-.B tab
-global option).
 .
+.P
+.I @g@tbl
+interprets a table entry beginning with
+.RB \lq T{ \rq
+at the end of an input line not as table data,
+but as a token starting a text block.
 .
-.LP
-By default, the text block is formatted with the settings which were
-active before entering the table, possibly overridden by the
-.BR m ,
-.BR v ,
-and
-.B w
-tbl specifiers.
+Similarly,
+.RB \lq T} \rq
+at the start of an input line ends a text block;
+it must also end the table entry.
 .
-For example, to make all text blocks ragged-right, insert
-.B .na
-right before the starting
-.B .TS
-(and
-.B .ad
-after the table).
+Text block tokens can share an input line with other table data
+(preceding
+.B T{
+and following
+.BR T} ).
 .
+Input lines between these tokens are formatted in a diversion by
+.IR troff . \" generic
 .
-.LP
-If either \oqw\cq or \oqx\cq specifiers are not given for
-.I all
-columns of a text block span, the default length of the text block (to
-be more precise, the line length used to process the text block
-diversion) is computed as L\tmuC/(N+1), where \oqL\cq is the
-current line length, \oqC\cq the number of columns spanned by the
-text block, and \oqN\cq the total number of columns in the table.
+Text blocks cannot be nested.
+.
+Multiple text blocks can occur in a table row.
+.
+.
+.P
+Text blocks are formatted as was the text prior to the table,
+modified by applicable column descriptors.
+.
+Specifically,
+the classifiers
+.BR A ,
+.BR C ,
+.BR L ,
+.BR N ,
+.BR R ,
+and
+.B S
+determine a text block's
+.I alignment
+within its cell,
+but not its
+.I adjustment.
+.
+Add
+.B na
+or
+.B ad
+requests to the beginning of a text block to alter its adjustment
+distinctly from other text in the document.
 .
-Note, however, that the actual diversion width as returned in register
-.B \rsndl
-is used eventually as the text block width.
+As with other table entries,
+when a text block ends,
+any alterations to formatting parameters are discarded.
 .
-If necessary, you can also control the text block width with a direct
-insertion of a
-.B .ll
-request right after \oqT{\cq.
+They do not affect subsequent table entries,
+not even other text blocks.
+.
+.
+.P
+.ne 2v
+If
+.B w
+or
+.B x
+modifiers are not specified for
+.I all
+columns of a text block's span,
+the default length of the text block
+(more precisely,
+the line length used to process the text block diversion)
+is computed as
+.IR L \tmu C /( N +1),
+.\" ...and rounded to the horizontal motion quantum of the output device
+where
+.I L
+is the current line length,
+.I C
+the number of columns spanned by the text block,
+and
+.I N
+the number of columns in the table.
+.
+If necessary,
+you can also control a text block's width by including an
+.B ll
+(line length)
+request in it prior to any text to be formatted.
+.
+Because a diversion is used to format the text block,
+its height and width are subsequently available in the registers
+.B dn
+and
+.BR dl ,
+respectively.
 .
 .
 .\" ====================================================================
-.SS Miscellaneous
+.SS \fIroff\f interface
 .\" ====================================================================
 .
-The number register
-.B \rsnTW
-holds the table width; it can't be used within the table itself
-but is defined right before calling
+The register
+.B TW
+stores the width of the table region in basic units;
+it can't be used within the region itself,
+but is defined before the
 .B .TE
-so that this macro can make use of it.
+token is output so that a
+.I groff
+macro named
+.B TE
+can make use of it.
+.
+.B T.\&
+is a Boolean-valued register indicating whether the bottom of the table
+is being processed.
+.
+The
+.B #T
+register marks the top of the table.
 .
+Avoid using these names for any other purpose.
 .
-.LP
-.B tbl
+.
+.P
+.I @g@tbl
 also defines a macro
-.B .T#
-which produces the bottom and side lines of a boxed table.
+.B T#
+to produce the bottom and side lines of a boxed table.
 .
 While
-.B tbl
-does call this macro itself at the end of the table, it can be used by
-macro packages to create boxes for multi-page tables by calling it within the
-page footer.
-.
-An example of this is shown by the
-.B \-ms
-macros which provide this functionality if a table starts with
-.B .TS\ H
-instead of the standard call to the
-.B .TS
-macro.
+.I @g@tbl
+itself arranges for the output to include a call of this macro at the
+end of such a table,
+it can also be used by macro packages to create boxes for multi-page
+tables by calling it from a page footer macro that is itself called by
+a trap planted near the bottom of the page.
+.
+See section \lqLimitations\rq below for more on multi-page tables.
+.
+.
+.P
+GNU
+.I tbl \" GNU
+.\" AT&T tbl used all kinds of registers; many began with "3".
+internally employs register,
+string,
+macro,
+and diversion names beginning with the
+.RB numeral\~ 3 .
+.
+A document to be preprocessed with GNU
+.I tbl \" GNU
+should not use any such identifiers.
+.\" XXX: Why are they not named starting with "gtbl*" or something?  GNU
+.\" tbl turns AT&T troff compatibility mode off anyway.
 .
 .
 .\" ====================================================================
-.SH "INTERACTION WITH @G@EQN"
+.SS "Interaction with \fI@g@eqn\f"
 .\" ====================================================================
 .
-.BR @g@tbl (@MAN1EXT@)
+.I @g@tbl
 should always be called before
-.BR @g@eqn (@MAN1EXT@)
-.RB ( groff (@MAN1EXT@)
-automatically takes care of the correct order of preprocessors).
+.MR @g@eqn @MAN1EXT@ .
+.
+(\c
+.MR groff @MAN1EXT@
+automatically arranges preprocessors in the correct order.)
+.
+Don't call the
+.B EQ
+and
+.B EN
+macros within tables;
+instead,
+set up delimiters in your
+.I eqn \" generic
+input and use the
+.B \%delim
+region option so that
+.I @g@tbl
+will recognize them.
 .
 .
+.br
+.ne 5v \" Keep enough space for heading, intro sentence, and first item.
 .\" ====================================================================
-.SH "GNU TBL ENHANCEMENTS"
+.SS "GNU \fItbl\f enhancements"
 .\" ====================================================================
 .
-There is no limit on the number of columns in a table, nor any limit on the
-number of text blocks.
+In addition to extensions noted above,
+GNU
+.I tbl \" GNU
+removes constraints endured by users of AT&T
+.IR tbl .\" AT&T
 .
-All the lines of a table are considered in deciding column widths, not just
-the first 200.
 .
-Table continuation
-.RB ( .T& )
-lines are not restricted to the first 200 lines.
+.IP \bu 2n
+Region options can be specified in any lettercase.
 .
 .
-.LP
-Numeric and alphabetic items may appear in the same column.
+.IP \bu
+There is no limit on the number of columns in a table,
+regardless of their classification,
+nor any limit on the number of text blocks.
 .
 .
-.LP
-Numeric and alphabetic items may span horizontally.
+.IP \bu
+All table rows are considered when deciding column widths,
+not just those occurring in the first 200 input lines of a region.
+.
+Similarly,
+table continuation
+.RB ( .T& )
+tokens are recognized outside a region's first 200 input lines.
 .
 .
-.LP
-.B @g@tbl
-uses register, string, macro and diversion names beginning with the digit\~\c
-.BR 3 .
+.IP \bu
+Numeric and alphabetic entries may appear in the same column.
 .
-When using
-.B @g@tbl
-you should avoid using any names beginning with a\~\c
-.BR 3 .
+.
+.IP \bu
+Numeric and alphabetic entries may span horizontally.
 .
 .
 .\" ====================================================================
-.SH "GNU TBL WITHIN MACROS"
+.SS "Using GNU \fItbl\f within macros"
 .\" ====================================================================
 .
-Since
-.B @g@tbl
-defines its own macros (right before each table) it is necessary to use
-an \oqend-of-macro\cq macro.
+You can embed a table region inside a macro definition.
 .
-Additionally, the escape character has to be switched off.
+However,
+since
+.I @g@tbl
+writes its own macro definitions at the beginning of each table region,
+it is necessary to call end macros instead of ending macro definitions
+with
+.RB \lq ..\& \rq.
+.\" XXX: Why don't we fix that by ending all of tbl's own macro
+.\" definitions with a call to a macro in its own reserved name space?
 .
-Here an example.
-.IP
-.EX
-\&.eo
-\&.de ATABLE ..
-\&.TS
-\&allbox tab(;);
-\&cl.
-\&\rs$1;\rs$2
-\&.TE
-\&...
-\&.ec
-\&.ATABLE A table
-\&.ATABLE Another table
-\&.ATABLE And \dqanother one\dq
-.EE
+Additionally,
+the escape character must be disabled. \" XXX: Why?
 .
 .
-.LP
-Note, however, that not all features of
-.B @g@tbl
-can be wrapped into a macro because
-.B @g@tbl
-sees the input earlier than
-.BR @g@troff .
+.P
+Not all
+.I @g@tbl
+features can be exercised from such macros because
+.I @g@tbl
+is a
+.I roff
+preprocessor:
+it sees the input earlier than
+.I @g@troff
+does.
+.
+For example,
+vertically aligning decimal separators fails if the numbers containing
+them occur as macro or string parameters;
+the alignment is performed by
+.I @g@tbl
+itself,
+which sees only
+.BR \rs$1 ,
+.BR \rs$2 ,
+and so on,
+and therefore can't recognize a decimal separator that only appears
+later when
+.I @g@troff
+interpolates a macro or string definition.
+.
+.
+.\" XXX: The following is a general caveat about preprocessors; move it.
+.P
+Using
+.I @g@tbl
+macros within conditional input
+(that is,
+contingent upon an
+.BR if ,
+.BR ie ,
+.BR el ,
+or
+.B while
+request)
+can result in misleading line numbers in subsequent diagnostics.
+.
+.I @g@tbl
+unconditionally injects its output into the source document,
+but the conditional branch containing it may not be taken,
+and if it is not,
+the
+.B lf
+requests that
+.I @g@tbl
+injects to restore the source line number cannot take effect.
+.
+Consider copying the input line counter register
+.B c.\&
+and restoring its value at a convenient location after applicable
+arithmetic.
+.
+.
+.br
+.ne 5v
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
 .
-For example, number formatting with vertically aligned decimal points
-fails if those numbers are passed on as macro parameters because
-decimal point alignment is handled by
-.B @g@tbl
-itself: It only sees \oq\rs$1\cq, \oq\rs$2\cq, etc., and
-therefore can't recognize the decimal point.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
+.TP
+.B \-C
+Enable AT&T compatibility mode:
+recognize
+.B .TS
+and
+.B .TE
+even when followed by a character other than space or newline.
+.
+Furthermore,
+interpret the uninterpreted leader escape sequence
+.BR \rsa .
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Limitations
 .\" ====================================================================
 .
-You should use
-.BR .TS\ H / .TH
-in conjunction with a supporting macro package for
-.I all
-multi-page boxed tables.
+Multi-page tables,
+if boxed and/or if you want their column headings repeated after page
+breaks,
+require support at the time the document is formatted.
 .
-If there is no header that you wish to appear at the top of each page
-of the table, place the
-.B .TH
-line immediately after the format section.
+A convention for such support has arisen in macro packages such as
+.IR ms ,
+.IR mm ,
+and
+.IR me .
 .
-Do not enclose a multi-page table within keep/release macros,
+To use it,
+follow the
+.B .TS
+token with a space and then
+.RB \lq H \rq;
+this will be interpreted by the formatter
+as a
+.B TS
+macro call with an
+.B H
+argument.
+.
+Then,
+within the table data,
+call the
+.B TH
+macro;
+this informs the macro package where the headings end.
+.
+If your table has no such heading rows,
+or you do not desire their repetition,
+call
+.B TH
+immediately after the table format specification.
+.
+If a multi-page table is boxed or has repeating column headings,
+do not enclose it with keep/release macros,
 or divert it in any other way.
 .
+Further,
+the
+.B bp
+request will not cause a page break in a
+.RB \lq "TS H" \rq
+table.
+.
+Define a macro to wrap
+.BR bp :
+invoke it normally if there is no current diversion.
+.
+Otherwise,
+pass the macro call to the enclosing diversion using the transparent
+line escape sequence
+.BR \rs!\& ;
+this will \lqbubble up\rq the page break to the output device.
+.
+See section \lqExamples\rq below for a demonstration.
+.
+.
+.P
+Double horizontal rules are not supported by
+.MR grotty @MAN1EXT@ ;
+single rules are used instead.
+.
+.I \%grotty
+also ignores half-line motions,
+so the
+.B u
+column modifier has no effect.
+.
+On terminal devices
+.RI (\lq nroff\~ mode\rq),
+horizontal rules and box borders occupy a full vee of space;
+this amount is doubled for
+.B doublebox
+tables.
+.
+Tables using these features thus require more vertical space in
+.I nroff
+mode than in
+.I troff
+mode:
+write
+.B ne
+requests accordingly.
+.
+Vertical rules between columns are drawn in the space between columns in
+.I nroff
+mode;
+using double vertical rules and/or reducing the column separation below
+the default can make them ugly or overstrike them with table data.
 .
-.LP
+.
+.P
 A text block within a table must be able to fit on one page.
 .
 .
-.LP
-The
-.B bp
-request cannot be used to force a page-break in a multi-page table.
+.P
+Using
+.B \rsa
+to put leaders in table entries does not work
+in GNU
+.IR tbl , \" GNU
+except in compatibility mode.
+.
+This is correct behavior:
+.B \rsa
+is an
+.I uninterpreted
+leader.
 .
-Instead, define
-.B BP
-as follows
+You can still use the
+.I roff
+leader character (Control+A) or define a string to use
+.B \rsa
+as it was designed:
+to be interpreted only in copy mode.
 .
-.IP
+.
+.RS
+.P
 .EX
-\&.de BP
-\&.  ie '\rs\rsn(.z'' .bp \rs\rs$1
-\&.  el \rs!.BP \rs\rs$1
-\&..
+\&.ds a \rsa
+\&.TS
+\&box center tab(;);
+\&Lw(2i)0 L.
+\&Population\rs*a;6,327,119
+\&.TE
 .EE
+.RE
 .
 .
-.LP
-and use
-.B BP
-instead of
-.BR bp .
+.\" We use a real leader to avoid defining a string in a man page.
+.P
+.TS
+box center tab(;);
+Lw(2i)0 L.
+Population&#x1;;6,327,119
+.TE
 .
 .
-.LP
-Using \rsa directly in a table to get leaders does not work (except in
-compatibility mode).
+.P
+A leading and/or trailing
+.B |
+in a format specification,
+such as
+.RB \lq |LCR|.\& \rq,
+produces an en space between the vertical rules and the content of the
+adjacent columns.
 .
-This is correct behaviour: \rsa is an
-.B uninterpreted
-leader.
+If no such space is desired
+(so that the rule abuts the content),
+you can introduce \lqdummy\rq columns with zero separation and empty
+corresponding table entries before and/or after.
 .
-To get leaders use a real leader, either by using a control A or like
-this:
 .
-.IP
+.RS
+.P
 .EX
-\&.ds a \rsa
 \&.TS
-\&tab(;);
-\&lw(1i) l.
-\&A\rs*a;B
+\&center tab(#);
+\&R0|L C R0|L.
+_
+\&#levulose#glucose#dextrose#
+_
 \&.TE
 .EE
+.RE
+.
 .
+.P
+These dummy columns have zero width and are therefore invisible;
+unfortunately they usually don't work as intended on terminal devices.
 .
-.LP
-A leading and/or trailing \oq|\cq in a format line, such as
 .
-.IP
+.if t \{\
+.TS
+center tab(#);
+R0|L C R0|L.
+_
+#levulose#glucose#dextrose#
+_
+.TE
+.\}
+.
+.
+.\" ====================================================================
+.SH Examples
+.\" ====================================================================
+.
+It can be easier to acquire the language of
+.I tbl \" generic
+through examples than formal description,
+especially at first.
+.
+.
+.\" Note: This example is nearly at the column limit (78n) for nroff
+.\" output.  Recast with care.
+.RS
+.P
 .EX
-|l r|.
+\&.TS
+box center tab(#);
+Cb Cb
+L L.
+Ability#Application
+Strength#crushes a tomato
+Dexterity#dodges a thrown tomato
+Constitution#eats a month-old tomato without becoming ill
+Intelligence#knows that a tomato is a fruit
+Wisdom#chooses \rsfInot\rsf to put tomato in a fruit salad
+Charisma#sells obligate carnivores tomato-based fruit salads
+\&.TE
 .EE
+.RE
 .
 .
-.LP
-gives output which has a 1n\~space between the resulting
-bordering vertical rule and the content of the adjacent column,
-as in
+.P
+.TS
+box center tab(#);
+Cb Cb
+L L.
+Ability#Application
+Strength#crushes a tomato
+Dexterity#dodges a thrown tomato
+Constitution#eats a month-old tomato without becoming ill
+Intelligence#knows that a tomato is a fruit
+Wisdom#chooses \fInot\f to put tomato in a fruit salad
+Charisma#sells obligate carnivores tomato-based fruit salads
+.TE
 .
-.IP
+.
+.P
+The
+.B A
+and
+.B N
+column classifiers can be easier to grasp in visual rendering than in
+description.
+.
+.
+.RS
+.P
 .EX
 \&.TS
-\&tab(#);
-\&|l r|.
-\&left column#right column
+center tab(;);
+CbS,LN,AN.
+Daily energy intake (in MJ)
+Macronutrients
+\&.\rs" assume 3 significant figures of precision
+Carbohydrates;4.5
+Fats;2.25
+Protein;3
+\&.T&
+LN,AN.
+Mineral
+Pu\-239;14.6
+_
+\&.T&
+LN.
+Total;\rsti24.4
 \&.TE
 .EE
+.RE
 .
 .
-.LP
-If it is desired to have zero space (so that the rule touches
-the content), this can be achieved by introducing extra \lqdummy\rq
-columns, with no content and zero separation, before and/or after,
-as in
+.RS
+.P
+.TS
+center tab(;);
+CbS,LN,AN.
+Daily energy intake (in MJ)
+.\" assume 3 significant figures of precision
+Macronutrients
+Carbohydrates;4.5
+Fats;2.25
+Protein;3
+.T&
+LN,AN.
+Mineral
+Pu-239;14.6
+_
+.T&
+LN.
+Total;\ti24.4
+.TE
+.RE
 .
-.IP
+.
+.br
+.ne 12v
+.P
+Next,
+we'll lightly adapt a compact presentation of spanning,
+vertical alignment,
+and zero-width column modifiers from the
+.I mandoc
+reference for its
+.I tbl \" generic
+interpreter.
+.
+It rewards close study.
+.
+.
+.RS
+.P
 .EX
 \&.TS
-\&tab(#);
-\&r0|l r0|l.
-\&#left column#right column#
+box center tab(:);
+Lz  S | Rt
+Ld| Cb| \ha
+\ha | Rz  S.
+left:r
+l:center:
+:right
 \&.TE
 .EE
+.RE
 .
 .
-.LP
-The resulting \lqdummy\rq columns are invisible and have zero width;
-note that such columns usually don't work with TTY devices.
+.RS
+.P
+.TS
+box center tab(:);
+Lz  S | Rt
+Ld| Cb| ^
+^ | Rz  S.
+left:r
+l:center:
+:right
+.TE
+.RE
 .
 .
-.\" ====================================================================
-.SH REFERENCE
-.\" ====================================================================
-Lesk, M.E.: "TBL \en A Program to Format Tables".
-For copyright reasons it cannot be included in the groff distribution,
-but copies can be found with a title search on the World Wide Web.
+.P
+.ne 2v
+Row staggering is not visually achievable on terminal devices,
+but a table using it can remain comprehensible nonetheless.
+.
+.
+.RS
+.P
+.EX
+\&.TS
+center tab(|);
+Cf(BI) Cf(BI) Cf(B), C C Cu.
+n|n\rsfB\rstmu\rsfn|difference
+1|1
+2|4|3
+3|9|5
+4|16|7
+5|25|9
+6|36|11
+\&.TE
+.EE
+.RE
+.
+.
+.RS
+.P
+.TS
+center tab(|);
+Cf(BI) Cf(BI) Cf(B), C C Cu.
+n|n\fB\tmu\fn|difference
+1|1
+2|4|3
+3|9|5
+4|16|7
+5|25|9
+6|36|11
+.TE
+.RE
+.
+.
+.P
+Some
+.I @g@tbl
+features cannot be illustrated in the limited environment of a portable
+man page.
+.
+.
+.\" TODO: Find a better example than this.
+.\".P
+.\"As noted above,
+.\"we can embed a table region in a
+.\".I groff
+.\"macro definition.
+.\".
+.\".IR @g@tbl ,
+.\"however,
+.\"cannot know what will result from any macro argument interpolations,
+.\"so we might confine such interpolations to one column of the table and
+.\"apply the
+.\".B x
+.\"modifier to it.
+.\".
+.\".
+.\".RS
+.\".P
+.\".EX
+.\"\&.de END
+.\"\&..
+.\"\&.eo
+.\"\&.de MYTABLE END
+.\"\&.TS
+.\"\&allbox tab(;);
+.\"\&C Lx.
+.\"\&This is table \rs$1.;\rs$2
+.\"\&.TE
+.\"\&.END
+.\"\&.ec
+.\"\&.MYTABLE 1 alpha
+.\"\&.MYTABLE 2 beta
+.\"\&.MYTABLE 3 "gamma delta"
+.\".EE
+.\".RE
+.\"
+.\"
+.P
+We can define a macro outside of a
+.I tbl \" generic
+region that we can call from within it to cause a page break inside a
+multi-page boxed table.
+.
+You can choose a different name;
+be sure to change both occurrences of \lqBP\rq.
+.
+.
+.RS
+.P
+.ne 4v
+.EX
+\&.de BP
+\&.\&  ie \aq\rs\rsn(.z\aq\aq \&.bp \rs\rs$1
+\&.\&  el \rs!.BP \rs\rs$1
+\&..
+.EE
+.RE
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@)
+.
+\lqTbl\emA Program to Format Tables\rq,
+by M.\& E.\& Lesk,
+1976
+(revised 16 January 1979),
+AT&T Bell Laboratories Computing Science Technical Report No.\& 49.
+.
+.
+.P
+The spanning example above was taken from
+.UR https://man.openbsd.org/tbl.7
+.IR mandoc 's
+man page for its
+.I tbl \" mandoc
+implementation
+.UE .
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ntbl_C
+.cp \n*groff_tbl_1_man_C
+.do rr *groff_tbl_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/preproc/tbl/tbl.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tbl.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -9,8 +7,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -26,9 +24,31 @@
 PREFIXMAN1 += src/preproc/tbl/tbl.1
 EXTRA_DIST += src/preproc/tbl/tbl.1.man
 
+tbl_TESTS = \
+  src/preproc/tbl/tests/boxes-and-vertical-rules.sh \
+  src/preproc/tbl/tests/check-horizontal-line-length.sh \
+  src/preproc/tbl/tests/check-line-intersections.sh \
+  src/preproc/tbl/tests/check-vertical-line-length.sh \
+  src/preproc/tbl/tests/cooperate-with-nm-request.sh \
+  src/preproc/tbl/tests/count-continued-input-lines.sh \
+  src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh \
+  src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh \
+  src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh \
+  src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh \
+  src/preproc/tbl/tests/expand-region-option-works.sh \
+  src/preproc/tbl/tests/format-time-diagnostics-work.sh \
+  src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh \
+  src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh \
+  src/preproc/tbl/tests/save-and-restore-line-numbering.sh \
+  src/preproc/tbl/tests/save-and-restore-tab-stops.sh \
+  src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh \
+  src/preproc/tbl/tests/x-column-modifier-works.sh
+TESTS += $(tbl_TESTS)
+EXTRA_DIST += $(tbl_TESTS)
+
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/boxes-and-vertical-rules.sh Added

@@ -0,0 +1,174 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Test behavior of unexpanded tables using boxes and/or vertical rules.
+
+# Case 1: "naked" table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table without vertical rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '2p' \
+    | grep -qx 'abcdef   abcdef   abcdef   abcdef   abcdef' || wail
+
+# Case 2: left-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with left-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx '| abcdef   abcdef   abcdef   abcdef   abcdef' || wail
+
+# Case 3: right-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+L L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with right-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx 'abcdef   abcdef   abcdef   abcdef   abcdef |' || wail
+
+# Case 4: vertical rule on both ends
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| L L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx '| abcdef   abcdef   abcdef   abcdef   abcdef |' || wail
+
+# Case 5: vertical rule on both ends and interior rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| L L L | L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both edge and interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx '| abcdef   abcdef   abcdef | abcdef   abcdef |' || wail
+
+# Case 6: boxed table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box tab(@);
+L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table without interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx '| abcdef   abcdef   abcdef   abcdef   abcdef |' || wail
+
+# Case 7: boxed table with interior vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box tab(@);
+L L L | L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table with interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+# 3 spaces between table entries
+echo "$output" | sed -n '3p' \
+    | grep -qx '| abcdef   abcdef   abcdef | abcdef   abcdef |' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/check-horizontal-line-length.sh Added

@@ -0,0 +1,78 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    echo "$output"
+    fail=yes
+}
+
+# GNU tbl draws horizontal lines 1n wider than they need to be on nroff
+# devices to enable them to cross a vertical line on the right-hand
+# side.
+
+input='.ll 10n
+.TS
+L.
+_
+1234567890
+.TE
+.pl \n(nlu
+'
+
+echo "checking length of plain horizontal rule" >&2
+output=$(printf "%s" "$input" | "$groff" -Tascii -t)
+echo "$output" | grep -Eqx -- '-{11}' || wail
+
+input='.ll 12n
+.TS
+| L |.
+_
+1234567890
+_
+.TE
+.pl \n(nlu
+'
+
+echo "checking intersection of vertical and horizontal rules" >&2
+output=$(printf "%s" "$input" | "$groff" -Tascii -t)
+echo "$output" | sed -n '1p' | grep -Eqx '\+-{12}\+' || wail
+echo "$output" | sed -n '3p' | grep -Eqx '\+-{12}\+' || wail
+
+input='.ll 12n
+.TS
+box;
+L.
+1234567890
+.TE
+.pl \n(nlu
+'
+
+echo "checking width of boxed table" >&2
+output=$(printf "%s" "$input" | "$groff" -Tascii -t)
+echo "$output" | sed -n '1p' | grep -Eqx '\+-{12}\+' || wail
+echo "$output" | sed -n '3p' | grep -Eqx '\+-{12}\+' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/check-line-intersections.sh Added

@@ -0,0 +1,52 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    echo "$output"
+    fail=yes
+}
+
+input='.TS
+allbox tab(@);
+L L L.
+a@b@c
+d@e@f
+g@h@i
+.TE
+'
+
+output=$(printf "%s" "$input" | "$groff" -Tascii -t)
+echo "$output"
+
+for l in 1 3 5 7
+do
+    echo "checking intersections on line $l"
+    echo "$output" | sed -n ${l}p | grep -Fqx '+---+---+---+' || wail
+done
+
+# TODO: Check `-Tutf8` output for correct crossing glyph identities.
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/check-vertical-line-length.sh Added

@@ -0,0 +1,49 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    echo "$output"
+    fail=yes
+}
+
+# GNU tbl draws vertical lines 1v taller than they need to be on nroff
+# devices to enable them to cross a potential horizontal line in the
+# table.
+
+input='.ll 12n
+.TS
+| L |.
+_
+1234567890
+.TE
+.pl \n(nlu
+'
+
+echo "checking length of plain vertical rule" >&2
+output=$(printf "%s" "$input" | "$groff" -Tascii -t)
+echo "$output" | sed -n '2p' | grep -Fqx -- '| 1234567890 |' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/cooperate-with-nm-request.sh Added

@@ -0,0 +1,47 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Regression-test Savannah #59812.
+#
+# A nonzero value of \nln should not cause spurious numbering of table
+# rows.
+
+DOC='\
+.nf
+foo
+.nm 1
+bar
+.nm
+baz
+.TS
+l.
+qux
+.TE
+'
+
+OUTPUT=$(printf "%s" "$DOC" | "$groff" -Tascii -t)
+
+echo "$OUTPUT" | grep -Fqx qux
+
+# vim:set ai noet sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/count-continued-input-lines.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Regression-test Savannah #62191.
+#
+# Line continuation in a row of table data should not make the input
+# line counter inaccurate.
+
+input='.this-is-line-1
+.TS
+L.
+foo\
+bar\
+baz\
+qux
+.TE
+.this-is-line-9'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -t -ww -z 2>&1)
+echo "$output" | grep -q '^troff.*:9:.*this-is-line-9'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/do-not-overdraw-page-top-in-nroff-mode.sh Added

@@ -0,0 +1,225 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+grotty="${abs_top_builddir:-.}/grotty"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #63449.
+#
+# In nroff mode, a table at the top of the page (i.e., one starting at
+# the first possible output line, with no vertical margin) that has
+# vertical rules should not overdraw the page top and provoke a warning
+# from grotty about "character(s) above the first line being
+# discarded".
+
+# Case 1: No horizontal rules; vertical rule at leading column.
+input='.TS
+| L.
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (1)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that a lone vertical rule starts the first output line"
+echo "$output" | sed -n '1p' | grep -Fqx '|' || wail
+
+# Case 2: No horizontal rules; vertical rule between columns.
+input='.TS
+tab(@);
+L | L.
+foo@bar
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (2)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that a lone vertical rule ends the first output line"
+echo "$output" | sed -n '1p' | grep -Eqx ' +\|' || wail
+
+# Case 3: No horizontal rules; vertical rule at trailing column.
+input='.TS
+L |.
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (3)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that a lone vertical rule ends the first output line"
+echo "$output" | sed -n '1p' | grep -Eqx ' +\|' || wail
+
+# Case 4: Vertical rule with horizontal rule in row description.
+input='.TS
+_
+L |.
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (4)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that intersection is placed on the first output line"
+echo "$output" | sed -n '1p' | grep -q '+' || wail
+
+# Case 5: Vertical rule with horizontal rule as first table datum.
+input='.TS
+L |.
+_
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (5)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that intersection is placed on the first output line"
+echo "$output" | sed -n '1p' | grep -q '+' || wail
+
+# Case 6: Horizontal rule as non-first row description with vertical
+# rule.
+input='.TS
+L,_,L |.
+foo
+bar
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (6)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that table data begin on first output line"
+echo "$output" | sed -n '1p' | grep -q 'foo' || wail
+
+# Also ensure that no collateral damage arises in related cases.
+
+# Case 7: Horizontal rule as first table datum with no vertical rule.
+input='.TS
+L.
+_
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (7)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that horizontal rule is placed on the first output line"
+echo "$output" | sed -n '1p' | grep -q '^---' || wail
+
+# Case 8: Horizontal rule as last table datum with no vertical rule.
+input='.TS
+L.
+foo
+_
+.TE
+.ec @
+.pl @n(nlu'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (8)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that horizontal rule is placed on the last output line"
+echo "$output" | sed -n '$p' | grep -q '^---' || wail
+
+# Case 9: Horizontal rule in row description with no vertical rule.
+input='.TS
+_
+L.
+foo
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (9)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that intersection is placed on the first output line"
+echo "$output" | sed -n '1p' | grep -q '^---' || wail
+
+# Case 10: Horizontal rule as non-first row description with no vertical
+# rule.
+input='.TS
+L,_,L.
+foo
+bar
+.TE'
+
+tmp=$(printf "%s\n" "$input" | "$groff" -t -Z -Tascii -P-cbou)
+output=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>/dev/null)
+error=$(printf "%s" "$tmp" | "$grotty" -F ./font 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that no diagnostic messages are produced by grotty (10)"
+echo "$error" | grep -q 'grotty:' && wail
+
+echo "checking that table data begin on first output line"
+echo "$output" | sed -n '1p' | grep -q 'foo' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/do-not-overlap-bottom-border-in-nroff.sh Added

@@ -0,0 +1,62 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=yes
+}
+
+# Regression-test Savannah #49390.
+
+input='foo
+.TS
+box;
+L.
+bar
+.TE
+baz
+.pl \n(nlu
+'
+
+echo "checking for post-table text non-overlap of (single) box border"
+output=$(printf "%s" "$input" | "$groff" -t -Tascii)
+echo "$output" | grep -q baz || wail
+
+input='foo
+.TS
+doublebox;
+L.
+bar
+.TE
+baz
+.pl \n(nlu
+'
+
+echo "checking for post-table text non-overlap of double box border"
+output=$(printf "%s" "$input" | "$groff" -t -Tascii)
+echo "$output" | grep -q baz || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/do-not-segv-on-invalid-vertical-span-entry.sh Added

@@ -0,0 +1,41 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+tbl="${abs_top_builddir:-.}/tbl"
+
+# Regression-test Savannah #61417.
+#
+# Don't segfault because we tried to span down from an invalid span that
+# tbl neglected to replace with an empty table entry.
+
+test -f core && exit 77 # skip
+
+input=$(cat <<EOF
+.TS
+l.
+\^
+\^
+.TE
+EOF
+)
+output=$(printf "%s" "$input" | "$tbl")
+! test -f core
+
+# vim:set ai noet sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/do-not-segv-when-backslash-R-in-text-block.sh Added

@@ -0,0 +1,75 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=yes
+}
+
+# Regression-test Savannah #62366.
+#
+# Do not SEGV when a text block begins with a repeating glyph token, and
+# do not malformat the output if it ends with one.
+
+test -f core && exit 77 # skip
+
+input='.TS
+L.
+T{
+\Ra
+T}
+.TE
+.TS
+L.
+T{
+foo
+\Ra
+T}
+.TE
+.TS
+L.
+T{
+foo
+\Ra
+bar
+T}
+.TE'
+
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii -P-cbou)
+
+echo "checking that tbl doesn't segfault" >&2
+test -f core && wail
+
+echo "checking text block starting with repeating glyph" >&2
+echo "$output" | sed -n 1p | grep -qx 'a' || wail
+
+echo "checking text block ending with repeating glyph" >&2
+echo "$output" | sed -n 2p | grep -qx 'foo a' || wail
+
+echo "checking text block containing repeating glyph" >&2
+echo "$output" | sed -n 3p | grep -qx 'foo a bar' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/expand-region-option-works.sh Added

@@ -0,0 +1,173 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Ensure that the "expand" region option expands to the line length.
+
+# Case 1: "naked" table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+expand tab(@);
+L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table without vertical rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '2p' \
+    | grep -Eqx '(abcdef {8,9}){4}abcdef' || wail
+
+# Case 2: left-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+expand tab(@);
+| L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with left-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {8}abcdef {7}abcdef {8}abcdef {9}abcdef' \
+    || wail
+
+# Case 3: right-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+expand tab(@);
+L L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with right-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx 'abcdef {8}abcdef {7}abcdef {8}abcdef {9}abcdef \|' \
+    || wail
+
+# Case 4: vertical rule on both ends
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+expand tab(@);
+| L L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {7}abcdef {7}abcdef {8}abcdef {8}abcdef \|' \
+    || wail
+
+# Case 5: vertical rule on both ends and interior rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+expand tab(@);
+| L L L | L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both edge and interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx \
+    '\| abcdef {7}abcdef {7}abcdef {4}\| {3}abcdef {8}abcdef \|' || wail
+
+# Case 6: boxed table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box expand tab(@);
+L L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table without interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {7}abcdef {7}abcdef {8}abcdef {8}abcdef \|' \
+    || wail
+
+# Case 7: boxed table with interior vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box expand tab(@);
+L L L | L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table with interior rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx \
+    '\| abcdef {7}abcdef {7}abcdef {4}\| {3}abcdef {8}abcdef \|' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/format-time-diagnostics-work.sh Added

@@ -0,0 +1,268 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Ensure we get diagnostics when we expect to, and not when we don't.
+#
+# Do NOT pattern-match the text of the diagnostic messages; those should
+# be left flexible.  (Some day they might even be localized.)
+
+# As of this writing, there are 5 distinct format-time diagnostic
+# messages that tbl writes roff code to generate, one of which can be
+# produced two different ways.
+
+# Diagnostic #1: a row overruns the page bottom
+input='.pl 2v
+.TS
+;
+L.
+T{
+.nf
+1
+2
+3
+T}
+.TE
+'
+
+echo "checking for diagnostic when row with text box overruns page" \
+    "bottom"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of  diagnostic when row with text" \
+    "box overruns page bottom"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+echo "checking 'nokeep' suppression of diagnostic when row with text" \
+    "box overruns page bottom"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# The other way to get "diagnostic #1" is to have a row that is too
+# tall _without_ involving a text block, for instance by having a font
+# or vertical spacing that is too high.
+input='.pl 2v
+.vs 3v
+.TS
+;
+L.
+1
+.TE
+'
+
+echo "checking for diagnostic when row with large vertical spacing" \
+    "overruns page bottom"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of diagnostic when row with large" \
+    "vertical spacing overruns page bottom"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+echo "checking 'nokeep' suppression of diagnostic when row with large" \
+    "vertical spacing overruns page bottom"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# Diagnostic #2: a boxed table won't fit on a page
+
+input='.pl 2v
+.vs 3v
+.TS
+box;
+L.
+1
+.TE
+'
+
+echo "checking for diagnostic when boxed table won't fit on page"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+# The above is an error, so the "nowarn" region option won't shut it up.
+#
+# However, "nokeep" does--but arguably shouldn't.  See
+# <https://savannah.gnu.org/bugs/?61878>.  If that gets fixed, we should
+# test that we still get a diagnostic even with the option given.
+
+# Diagnostic #3: unexpanded columns overrun the line length
+#
+# Case 1: no 'x' column modifiers used
+
+input='.pl 2v
+.ll 10n
+.TS
+;
+L.
+12345678901
+.TE
+'
+
+echo "checking for diagnostic when unexpanded columns overrun line" \
+    "length (1)"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of diagnostic when unexpanded" \
+    "columns overrun line length (1)"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# Avoiding keeps won't get you out of this one.
+echo "checking 'nokeep' NON-suppression of diagnostic when unexpanded" \
+    "columns overrun line length (1)"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+# Case 2: 'x' column modifier used
+#
+# This worked as a "get out of jail (warning) free" card in groff 1.22.4
+# and earlier; i.e., it incorrectly suppressed the warning.  See
+# Savannah #61854.
+
+input='.pl 2v
+.ll 10n
+.TS
+;
+Lx.
+12345678901
+.TE
+'
+
+echo "checking for diagnostic when unexpanded columns overrun line" \
+    "length (2)"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of diagnostic when unexpanded" \
+    "columns overrun line length (2)"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# Avoiding keeps won't get you out of this one.
+echo "checking 'nokeep' NON-suppression of diagnostic when unexpanded" \
+    "columns overrun line length (2)"
+input_nowarn=$(printf "%s" "$input" | sed 's/;/nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+# Diagnostic #4: expanded table gets all column separation squashed out
+
+input='.pl 3v
+.ll 10n
+.TS
+tab(;) expand;
+L L.
+abcde;fghij
+.TE
+'
+
+echo "checking for diagnostic when region-expanded table has column" \
+    "separation eliminated"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of diagnostic when" \
+    "region-expanded table has column separation eliminated"
+input_nowarn=$(printf "%s" "$input" | sed 's/;$/ nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# Avoiding keeps won't get you out of this one.
+echo "checking 'nokeep' NON-suppression of diagnostic when" \
+    "region-expanded table has column separation eliminated"
+input_nowarn=$(printf "%s" "$input" | sed 's/;$/ nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+# Diagnostic #5: expanded table gets column separation reduced
+
+input='.pl 3v
+.ll 10n
+.TS
+tab(;) expand;
+L L.
+abcd;efgh
+.TE
+'
+
+echo "checking for diagnostic when region-expanded table has column" \
+    "separation reduced"
+output=$(printf "%s" "$input" | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+echo "checking 'nowarn' suppression of diagnostic when" \
+    "region-expanded table has column separation reduced"
+input_nowarn=$(printf "%s" "$input" | sed 's/;$/ nowarn;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 0
+
+# Avoiding keeps won't get you out of this one.
+echo "checking 'nokeep' NON-suppression of diagnostic when" \
+    "region-expanded table has column separation reduced"
+input_nowarn=$(printf "%s" "$input" | sed 's/;$/ nokeep;/')
+output=$(printf "%s" "$input_nowarn" \
+    | "$groff" -Tascii -t 2>&1 >/dev/null)
+nlines=$(echo "$output" | grep . | wc -l)
+test $nlines -eq 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/save-and-restore-hyphenation-parameters.sh Added

@@ -0,0 +1,58 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Regression-test Savannah #59971.
+#
+# Hyphenation needs to be restored between (and after) text blocks just
+# as adjustment is.
+
+EXAMPLE='.nr LL 78n
+.hw a-bc-def-ghij-klmno-pqrstu-vwxyz
+.LP
+Here is a table with hyphenation disabled in its text block.
+.
+.TS
+l lx.
+foo	T{
+.nh
+abcdefghijklmnopqrstuvwxyz
+abcdefghijklmnopqrstuvwxyz
+abcdefghijklmnopqrstuvwxyz
+T}
+.TE
+.
+Let us see if hyphenation is enabled again as it should be.
+abcdefghijklmnopqrstuvwxyz'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -t -ms)
+
+echo "$OUTPUT"
+
+echo "testing whether hyphenation disabled in table text block" >&2
+! echo "$OUTPUT" | grep '^foo' | grep -- '-$'
+
+echo "testing whether hyphenation enabled after table" >&2
+echo "$OUTPUT" | grep -qx 'Let us see.*lmno-'
+
+# vim:set ai noet sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/save-and-restore-inter-sentence-space.sh Added

@@ -0,0 +1,79 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #61909.
+#
+# Inter-sentence space should not be applied to the content of ordinary
+# table entries.  They are set "rigidly" (tbl(1)), also without filling,
+# adjustment, hyphenation or breaking.  If you want those things, use a
+# text block.
+
+input='.ss 12 120
+Before one.
+Before two.
+.TS
+L.
+.\" two spaces
+Foo.  Bar.
+.\" four spaces
+Baz.    Qux.
+.\" two spaces
+T{
+Ack.  Nak.
+T}
+.TE
+After one.
+After two.
+'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -t)
+echo "$output"
+
+echo "checking that inter-sentence space is altered too early"
+echo "$output" \
+    | grep -Fqx 'Before one.           Before two.' || wail # 11 spaces
+
+echo "checking that inter-sentence space is not applied to ordinary" \
+    "table entries (1)"
+echo "$output" | grep -Fqx 'Foo.  Bar.' || wail # 2 spaces
+
+echo "checking that inter-sentence space is not applied to ordinary" \
+    "table entries (2)"
+echo "$output" | grep -Fqx 'Baz.    Qux.' || wail # 4 spaces
+
+echo "checking that inter-sentence space is applied to text blocks"
+echo "$output" | grep -Fqx 'Ack.           Nak.' || wail # 11 spaces
+
+echo "checking that inter-sentence space is restored after table"
+echo "$output" \
+    | grep -Fqx 'After one.           After two.' || wail # 11 spaces
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/save-and-restore-line-numbering.sh Added

@@ -0,0 +1,85 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #60140.
+#
+# Line numbering needs to be suspended within a table and restored
+# afterward.  Historical implementations handled line numbering in
+# tables badly when text blocks were used.
+
+input='.nm 1
+Here is a line of output.
+Sic transit adispicing meatballs.
+We pad it out with more content to ensure that the line breaks.
+.TS
+L.
+This is my table.
+There are many like it but this one is mine.
+T{
+Ut enim ad minima veniam,
+quis nostrum exercitationem ullam corporis suscipitlaboriosam,
+nisi ut aliquid ex ea commodi consequatur?
+T}
+.TE
+What is the line number now?'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -t)
+echo "$output"
+
+echo "testing that line numbering is suppressed in table" >&2
+echo "$output" | grep -Fqx 'This is my table.' || wail
+
+echo "testing that line numbering is restored after table" >&2
+echo "$output" | grep -Eq '3 +What is the line number now\?' || wail
+
+input='.nf
+.nm 1
+test of line numbering suppression
+five
+four
+.nn 3
+three
+.TS
+L.
+I am a table.
+I have two rows.
+.TE
+two
+one
+numbering returns here'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -t)
+echo "$output"
+
+echo "testing that suppressed numbering is restored correctly" >&2
+echo "$output" | grep -Eq '4 +numbering returns here' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/save-and-restore-tab-stops.sh Added

@@ -0,0 +1,84 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #42978.
+#
+# When tbl changes the tab stops, it needs to restore them.
+#
+# Based on an example by Bjarni Igni Gislason.
+
+EXAMPLE='.TH tbl\-tabs\-test 1 2020-10-20 "groff test suite"
+.SH Name
+tbl\-tabs\-test \- see if tbl messes up the tab stops
+.SH Description
+Do not use tabs in man pages outside of
+.BR .TS / .TE
+regions.
+.PP
+But	if	you	do.\|.\|.
+.PP
+.TS
+l l l.
+table entries	long enough	to change the tab stops
+.TE
+.PP
+.EX
+#!/bin/sh
+case $#
+1)
+	if foo
+	then
+		bar
+	else
+		if baz
+		then
+			qux
+		fi
+	fi
+;;
+esac
+.EE'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -t -man)
+FAIL=
+
+if ! echo "$OUTPUT" | grep -Eq '^ {12}if foo$'
+then
+    FAIL=yes
+    echo "first tab stop is wrong" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -Eq '^ {17}bar$'
+then
+    FAIL=yes
+    echo "second tab stop is wrong" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -Eq '^ {22}qux$'
+then
+    FAIL=yes
+    echo "third tab stop is wrong" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai noet sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/warn-on-long-boxed-unkept-table.sh Added

@@ -0,0 +1,56 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #61878.
+#
+# A boxed, unkept table that overruns the page bottom will produce ugly
+# output; it looks especially bizarre in nroff mode.
+#
+# We set the page length to 2v to force a problem (any boxed table in
+# nroff mode needs 3 vees minimum), and put a page break at the start to
+# catch an incorrectly initialized starting page number for the table.
+
+input='.pl 2v
+.bp
+.TS
+box nokeep;
+L.
+Z
+.TE'
+
+output=$(printf "%s" "$input" | "$groff" -t -Tascii 2>/dev/null)
+error=$(printf "%s" "$input" | "$groff" -t -Tascii 2>&1 >/dev/null)
+echo "$output"
+
+echo "checking that a diagnostic message is produced"
+echo "$error" | grep -q 'warning: boxed.*page 2$' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/preproc/tbl/tests/x-column-modifier-works.sh Added

@@ -0,0 +1,172 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Ensure that the "x" column modifier causes table expansion to the line
+# length.
+
+# Case 1: "naked" table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+Lx L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table without vertical rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '2p' \
+    | grep -Eqx 'abcdef {25}(abcdef {3}){3}abcdef' || wail
+
+# Case 2: left-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| Lx L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with left-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {23}(abcdef {3}){3}abcdef' || wail
+
+# Case 3: right-hand vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+Lx L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with right-hand rule" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx 'abcdef {23}(abcdef {3}){3}abcdef \|' || wail
+
+# Case 4: vertical rule on both ends
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| Lx L L L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {21}(abcdef {3}){3}abcdef \|' || wail
+
+# Case 5: vertical rule on both ends and interior rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+tab(@);
+| Lx L L | L L |.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking unboxed table with both edge and interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx \
+    '\| abcdef {21}abcdef {3}abcdef \| abcdef {3}abcdef \|' \
+    || wail
+
+# Case 6: boxed table
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box tab(@);
+Lx L L L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table without interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx '\| abcdef {21}(abcdef {3}){3}abcdef \|' || wail
+
+# Case 7: boxed table with interior vertical rule
+
+input='.ll 64n
+.nf
+1234567890123456789012345678901234567890123456789012345678901234
+.fi
+.TS
+box tab(@);
+Lx L L | L L.
+abcdef@abcdef@abcdef@abcdef@abcdef
+.TE
+.pl \n(nlu'
+
+echo "checking boxed table with interior rules" >&2
+output=$(printf "%s\n" "$input" | "$groff" -t -Tascii)
+echo "$output"
+echo "$output" | sed -n '3p' \
+    | grep -Eqx \
+    '\| abcdef {21}abcdef {3}abcdef \| abcdef {3}abcdef \|' \
+    || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/groff/groff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/groff.1.man Changed

@@ -1,20 +1,15 @@
-.TH GROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff \- front-end for the groff document formatting system
-.
-.\" groff.man -> groff.1
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_1_C \n.C
-.cp 0
+.TH groff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff \- front end to the GNU
+.I roff
+document formatting system
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2022 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -28,243 +23,292 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
-.\" ====================================================================
-.\" Definitions
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_1_man_C \n.cp
+.cp 0
 .
-.\" ====================================================================
-.\" 'char or string'
-.de Quoted
-.  ft CR
-\oq\\$*\cq
-.  ft
-..
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.\" Define a string for the TeX logo.
+.ie t .ds TeX T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
+.el   .ds TeX TeX
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY groff
-.OP \-abcegijklpstzCEGNRSUVXZ
-.OP \-d cs
-.OP \-D arg
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-K arg
-.OP \-L arg
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-P arg
-.OP \-r cn
-.OP \-T dev
-.OP \-w name
-.OP \-W name
-.RI  file
-\&.\|.\|.\&
+.RB  \-abcCeEgGijklNpRsStUVXzZ 
+.RB  \-d\~\c
+.IR ctext 
+.RB  \-d\~\c
+.IB string =\c
+.IR text 
+.RB  \-D\~\c
+.IR fallback-encoding 
+.RB  \-f\~\c
+.IR font-family 
+.RB  \-F\~\c
+.IR font-directory 
+.RB  \-I\~\c
+.IR inclusion-directory 
+.RB  \-K\~\c
+.IR input-encoding 
+.RB  \-L\~\c
+.IR spooler-argument 
+.RB  \-m\~\c
+.IR macro-package 
+.RB  \-M\~\c
+.IR macro-directory 
+.RB  \-n\~\c
+.IR page-number 
+.RB  \-o\~\c
+.IR page-list 
+.RB  \-P\~\c
+.IR postprocessor-argument 
+.RB  \-r\~\c
+.IR cnumeric-expression 
+.RB  \-r\~\c
+.IB register =\c
+.IR numeric-expression 
+.RB  \-T\~\c
+.IR output-device 
+.RB  \-w\~\c
+.IR warning-category 
+.RB  \-W\~\c
+.IR warning-category 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY groff
 .B \-h
+.
 .SY groff
 .B \-\-help
 .YS
 .
+.
 .SY groff
 .B \-v
-.RI  option
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
 .SY groff
 .B \-\-version
-.RI  option
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This document describes the
-.B groff
-program, the main front-end for the
 .I groff
+is the primary front end to the GNU
+.I roff
 document formatting system.
 .
-The
-.I groff
-program and macro suite is the implementation of a
-.BR roff (@MAN7EXT@)
-system within the free software collection
-.UR http://\:www.gnu.org
+.\" BEGIN Keep parallel with groff.texi node "What Is groff?".
+.\" This language is slightly expanded from that in the "ANNOUNCE" file
+.\" and on the groff home page.
 GNU
-.UE .
-.
-The
+.I roff
+is a typesetting system that reads plain text input files that include
+formatting commands to produce output in PostScript,
+PDF,
+HTML,
+DVI,
+or other formats,
+or for display to a terminal.
+.
+Formatting commands can be low-level typesetting primitives,
+macros from a supplied package,
+or user-defined macros.
+.
+All three approaches can be combined.
+.
+If no
+.I file
+operands are specified,
+or if
+.I file
+is
+.RB \lq \- \rq,
 .I groff
-system has all features of the classical
-.IR roff ,
-but adds many extensions.
+reads the standard input stream.
 .
 .
 .P
-The
-.B groff
-program allows control of the whole
+A reimplementation and extension of the typesetter from AT&T Unix,
 .I groff
-system by command-line options.
+is present on most POSIX systems owing to its long association with Unix
+manuals
+(including man pages).
 .
-This is a great simplification in comparison to the classical case (which
-uses pipes only).
+It and its predecessor are notable for their production of several
+best-selling software engineering texts.
 .
+.I groff
+is capable of producing typographically sophisticated documents while
+consuming minimal system resources.
+.\" END Keep parallel with groff.texi node "What Is groff?".
 .
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
 .
-The command line is parsed according to the usual \fCRGNU\f
-convention.
+.P
+The
+.I groff
+command orchestrates the execution of preprocessors,
+the transformation of input documents into a device-independent page
+description language,
+and the production of output from that language.
 .
-Whitespace is permitted between a command-line option and its argument.
 .
-Options can be grouped behind a single \oq\-\cq (minus character).
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
 .
-A filename of
-.B \-
-(minus character) denotes the standard input.
+.B \-h
+and
+.B \-\-help
+display a usage message and exit.
 .
 .
 .P
-As
-.B groff
-is a wrapper program for
-.B @g@troff
-both programs share a set of options.
+Because
+.I groff
+is intended to subsume most users' direct invocations of the
+.MR @g@troff @MAN1EXT@
+formatter,
+the two programs share a set of options.
 .
-But the
-.B groff
-program has some additional, native options and gives a new meaning to
-some
-.B @g@troff
-options.
+However,
+.I groff
+has some options that
+.I @g@troff
+does not share,
+and others which
+.I groff
+interprets differently.
 .
-On the other hand, not all
-.B @g@troff
-options can be fed into
-.BR groff .
+At the same time,
+not all valid
+.I @g@troff
+options can be given to
+.IR groff .
 .
 .
 .\" ====================================================================
-.SS Native groff Options
+.SS "\fIgroff\f-specific options"
 .\" ====================================================================
 .
-The following options either do not exist for
-.B @g@troff
-or are differently interpreted by
-.BR groff .
+The following options either do not exist in
+GNU
+.I troff \" GNU
+or are interpreted differently by
+.IR groff .
 .
 .
 .TP
-.BI \-D\  arg
-Set default input encoding used by
-.B preconv
+.BI \-D\~ enc
+Set fallback input encoding used by
+.MR preconv @MAN1EXT@
 to
-.IR arg .
-.
-Implies
+.IR enc ;
+implies
 .BR \-k .
 .
 .
 .TP
 .B \-e
-Preprocess with
-.BR @g@eqn .
+Run
+.MR @g@eqn @MAN1EXT@
+preprocessor.
 .
 .
 .TP
 .B \-g
-Preprocess with
-.BR @g@grn .
+Run
+.MR @g@grn @MAN1EXT@
+preprocessor.
 .
 .
 .TP
 .B \-G
-Preprocess with
-.BR grap .
-.
-Implies
+Run
+.MR grap 1
+preprocessor;
+implies
 .BR \-p .
 .
 .
 .TP
-.B \-h
-.TQ
-.B \-\-help
-Print a help message.
-.
-.
-.TP
-.BI \-I\  dir
-This option may be used to specify a directory to search for
-files (both those on the command line and those named in
-.B .psbb
-and
-.B .so
-requests, and
-.B \eX'ps: import'
-,
-.B \eX'ps: file'
+.BI \-I\~ dir
+Works as
+.IR @g@troff 's
+option
+(see below),
+but also implies
+.B \-g
 and
-.B \eX'pdf: pdfpic'
-escapes).
-.
-The current directory is always searched first.
+.BR \-s .
 .
-This option may be specified more than once;
-the directories are searched in the order specified.
-.
-No directory search is performed for files specified using an absolute path.
-.
-This option implies the
-.B \-s
-option.
+It is passed to
+.MR @g@soelim @MAN1EXT@
+and the output driver,
+and
+.I @g@grn
+is passed an
+.B \-M
+option with
+.I dir
+as its argument.
 .
 .
 .TP
 .B \-j
-Preprocess with
-.BR @g@chem .
-.
-Implies
+Run
+.MR @g@chem @MAN1EXT@
+preprocessor;
+implies
 .BR \-p .
 .
 .
 .TP
 .B \-k
-Preprocess with
-.BR preconv .
-.
-This is run before any other preprocessor.
+Run
+.MR preconv @MAN1EXT@
+preprocessor.
 .
-Please refer to
-.BR preconv 's
-manual page for its behaviour if no
+Refer to its man page for its behavior if neither of
+.IR groff 's
 .B \-K
-(or
-.BR \-D )
-option is specified.
+or
+.B \-D
+options is also specified.
 .
 .
 .TP
-.BI \-K\  arg
+.BI \-K\~ enc
 Set input encoding used by
-.B preconv
+.MR preconv @MAN1EXT@
 to
-.IR arg .
-.
-Implies
+.IR enc ;
+implies
 .BR \-k .
 .
 .
@@ -272,14 +316,21 @@
 .B \-l
 Send the output to a spooler program for printing.
 .
-The command that should be used for this is specified by the
-.B print
-command in the device description file, see
-.BR \%groff_font (@MAN5EXT@).
+The
+.RB \lq print \rq
+directive in the device description file
+specifies the default command to be used;
+see
+.MR groff_font @MAN5EXT@ .
 .
-If this command is not present, the output is piped into the
-.BR lpr (1)
-program by default.
+If no such directive is present for the output device,
+.ie '@PSPRINT@'' \{\
+this option is ignored.
+.\}
+.el \{\
+output is piped to
+.MR @PSPRINT@ 1 .
+.\}
 .
 See options
 .B \-L
@@ -288,1359 +339,1724 @@
 .
 .
 .TP
-.BI \-L\  arg
+.BI \-L\~ arg
 Pass
 .I arg
-to the spooler program.
+to the print spooler program.
 .
-Several arguments should be passed with a separate
-\-L
-option each.
+If multiple
+.IR arg s
+are required,
+pass each with a separate
+.B \-L
+option.
 .
-Note that
-.B groff
-does not prepend
-\oq\-\cq
-(a minus sign) to
+.I groff
+does not prefix an option dash to
 .I arg
 before passing it to the spooler program.
 .
 .
 .TP
-.B \-N
-Don't allow newlines within
-.I eqn
-delimiters.
+.B \-M
+Works as
+.IR @g@troff 's
+option
+(see below),
+but is also passed to
+.MR @g@eqn @MAN1EXT@ ,
+.MR grap @MAN1EXT@ ,
+and
+.MR @g@grn @MAN1EXT@ .
+.
 .
-This is the same as the
+.TP
+.B \-N
+Prohibit newlines between
+.I eqn \" language
+delimiters:
+pass
 .B \-N
-option in
-.BR @g@eqn .
+to
+.MR @g@eqn @MAN1EXT@ .
 .
 .
 .TP
 .B \-p
-Preprocess with
-.BR @g@pic .
+Run
+.MR @g@pic @MAN1EXT@
+preprocessor.
 .
 .
 .TP
-.BI \-P\  \-option
-.TQ
-.BI \-P\  \-option \ \-P\  arg
+.BI \-P\~ arg
 Pass
-.I \-option
-or
-.I "\-option\~arg"
+.I arg
 to the postprocessor.
 .
-The option must be specified with the necessary preceding minus
-sign(s)
-.Quoted \-
-or
-.Quoted \-\-
-because
-.B groff
-does not prepend any dashes before passing it to the postprocessor.
-.
-For example, to pass a title to the
-.B \%gxditview
-postprocessor, the shell command
-.
-.RS
-.IP
-.EX
-groff \-X \-P \-title \-P 'groff it' \fIfoo\f
-.EE
-.RE
-.
-.IP
-is equivalent to
+If multiple
+.IR arg s
+are required,
+pass each with a separate
+.B \-P
+option.
 .
-.RS
-.IP
-.EX
-groff \-X \-Z \fIfoo\f | \
-gxditview \-title 'groff it' \-
-.EE
-.RE
+.I groff
+does not prefix an option dash to
+.I arg
+before passing it to the postprocessor.
 .
 .
 .TP
 .B \-R
-Preprocess with
-.BR @g@refer .
+Run
+.MR @g@refer @MAN1EXT@
+preprocessor.
 .
 No mechanism is provided for passing arguments to
-.B @g@refer
+.I @g@refer
 because most
-.B @g@refer
+.I @g@refer
 options have equivalent language elements that can be specified within
 the document.
 .
-See
-.BR \%@g@refer (@MAN1EXT@)
-for more details.
-.
 .
 .TP
 .B \-s
-Preprocess with
-.BR @g@soelim .
+Run
+.MR @g@soelim @MAN1EXT@
+preprocessor.
 .
 .
 .TP
 .B \-S
-Safer mode.
-.
-Pass the
-.B \-S
-option to
-.B @g@pic
-and disable the following
-.B @g@troff
-requests:
-.BR .open ,
-.BR .opena ,
-.BR .pso ,
-.BR .sy ,
-and
-.BR .pi .
+Operate in \lqsafer\rq mode;
+see
+.B \-U
+below for its opposite.
 .
-For security reasons, safer mode is enabled by default.
+For security reasons,
+safer mode is enabled by default.
 .
 .
 .TP
 .B \-t
-Preprocess with
-.BR @g@tbl .
+Run
+.MR @g@tbl @MAN1EXT@
+preprocessor.
 .
 .
 .TP
-.BI \-T\  dev
-Set output device to
+.BI \-T\~ dev
+Direct
+.I @g@troff
+to format the input for the output device
 .IR dev .
 .
-For this device,
-.B @g@troff
-generates the
-.I intermediate
-.IR output ;
-see
-.BR \%groff_out (@MAN5EXT@).
-.
-Then
-.B groff
-calls a postprocessor to convert
-.BR @g@troff 's
-.I intermediate output
-to its final format.
-.
-Real devices in
-.B groff
-are
-.
-.RS
-.RS
-.TP
-dvi
-TeX DVI format (postprocessor is
-.BR grodvi ).
-.
-.TP
-html
-.TQ
-xhtml
-HTML and XHTML output (preprocessors are
-.B @g@soelim
-and
-.BR \%pre-grohtml ,
-postprocessor is
-.BR \%post-grohtml ).
-.
-.TP
-lbp
-Canon CAPSL printers (\%LBP-4 and \%LBP-8 series laser printers;
-postprocessor is
-.BR grolbp ).
-.
-.TP
-lj4
-HP LaserJet4 compatible (or other PCL5 compatible) printers (postprocessor
-is
-.BR grolj4 ).
-.
-.TP
-ps
-PostScript output (postprocessor is
-.BR grops ).
-.
-.TP
-pdf
-Portable Document Format (PDF) output (postprocessor is
-.BR gropdf ).
-.RE
-.RE
-.
-.
-.IP
-For the following TTY output devices (postprocessor is always
-.BR grotty ),
-.B \-T
-selects the output encoding:
-.
-.RS
-.RS
-.TP
-ascii
-7bit \fCRASCII\f.
-.
-.TP
-cp1047
-\%Latin-1 character set for EBCDIC hosts.
-.
-.TP
-latin1
-ISO \%8859-1.
-.
-.TP
-utf8
-Unicode character set in \%UTF-8 encoding.
-.
-This mode has the most useful fonts for TTY mode, so it is the best
-mode for TTY output.
-.RE
-.RE
-.
-.
-.IP
-The following arguments select
-.B \%gxditview
-as the \oqpostprocessor\cq (it is rather a viewing program):
-.
-.RS
-.RS
-.TP
-X75
-75\|dpi resolution, 10\|pt document base font.
-.TP
-X75\-12
-75\|dpi resolution, 12\|pt document base font.
-.TP
-X100
-100\|dpi resolution, 10\|pt document base font.
-.TP
-X100\-12
-100\|dpi resolution, 12\|pt document base font.
-.RE
-.RE
-.
-.IP
-The default device is
-.BR @DEVICE@ .
+.I groff
+then calls an output driver to convert
+.IR @g@troff 's
+output to a form appropriate for
+.IR dev ;
+see subsection \lqOutput devices\rq below.
 .
 .
 .TP
 .B \-U
-Unsafe mode.
-.
-Reverts to the (old) unsafe behaviour; see option
-.BR \-S .
+Operate in unsafe mode:
+pass the
+.B \-U
+option to
+.I @g@pic
+and
+.IR @g@troff .
 .
 .
 .TP
 .B \-v
 .TQ
 .B \-\-version
-Output version information of
-.B groff
-and of all programs that are run by it; that is, the given command line
-is parsed in the usual way, passing
+Write version information for
+.I groff
+and all programs run by it to the standard output stream;
+that is,
+the given command line is processed in the usual way,
+passing
 .B \-v
-to all subprograms.
+to the formatter and any pre- or postprocessors invoked.
 .
 .
 .TP
 .B \-V
-Output the pipeline that would be run by
-.B groff
-(as a wrapper program) on the standard output, but do not execute it.
+Output the pipeline that
+.I groff
+would run to the standard output stream,
+but do not execute it.
 .
 If given more than once,
-the commands are both printed on the standard error and run.
+.I groff
+both writes and runs the pipeline.
 .
 .
 .TP
 .B \-X
 Use
-.B \%gxditview
-instead of using the usual postprocessor to (pre)view a document.
+.MR gxditview @MAN1EXT@
+instead of the usual postprocessor to (pre)view a document on an X11
+display.
 .
-The printing spooler behavior as outlined with options
-.B \-l
-and
-.B \-L
-is carried over to
-.BR \%gxditview (@MAN1EXT@)
-by determining an argument for the
-.B \-printCommand
-option of
-.BR \%gxditview (@MAN1EXT@).
-.
-This sets the default
-.B Print
-action and the corresponding menu entry to that value.
-.
-.B \-X
-only produces good results with
-.BR \-Tps ,
-.BR \-TX75 ,
-.BR \-TX75\-12 ,
-.BR \-TX100 ,
-and
-.BR \-TX100\-12 .
-.
-The default resolution for previewing
+Combining this option with
 .B \-Tps
-output is 75\|dpi; this can be changed by passing the
-.B \-resolution
-option to
-.BR \%gxditview ,
-for example
-.
-.RS
-.IP
-.EX
-groff \-X \-P\-resolution \-P100 \-man foo.1
-.EE
-.RE
-.
-.
-.TP
-.B \-z
-Suppress output generated by
-.BR @g@troff .
-.
-Only error messages are printed.
+uses the font metrics of the PostScript device,
+whereas the
+.B \-TX75
+and
+.B \-TX100
+options use the metrics of X11 fonts.
 .
 .
 .TP
 .B \-Z
-Do not automatically postprocess
-.I groff intermediate output
-in the usual manner.
+Disable postprocessing.
 .
-This will cause the
-.B @g@troff
-.I output
-to appear on standard output,
-replacing the usual postprocessor output; see
-.BR \%groff_out (@MAN5EXT@).
+.I @g@troff
+output will appear on the standard output stream
+(unless suppressed with
+.BR \-z );
+see
+.MR groff_out @MAN5EXT@
+for a description of this format.
 .
 .
 .\" ====================================================================
-.SS Transparent Options
+.SS "Transparent options"
 .\" ====================================================================
 .
-The following options are transparently handed over to the formatter
-program
-.B @g@troff
-that is called by
-.B groff
-subsequently.
+The following options are passed as-is to the formatter program
+.MR @g@troff @MAN1EXT@
+and described in more detail in its man page.
 .
-These options are described in more detail in
-.BR @g@troff (@MAN1EXT@).
 .
 .TP
 .B \-a
-\fCRASCII\f approximation of output.
+Generate a plain text approximation of the typeset output.
+.
 .
 .TP
 .B \-b
-Backtrace on error or warning.
+Write a backtrace to the standard error stream on each error or warning.
+.
 .
 .TP
 .B \-c
-Disable color output.
+Start with color output disabled.
 .
-Please consult the
-.BR \%grotty (@MAN1EXT@)
-man page for more details.
 .
 .TP
 .B \-C
-Enable compatibility mode.
+Enable AT&T
+.I troff \" AT&T
+compatibility mode;
+implies
+.BR \-c .
+.
 .
 .TP
-.BI \-d\  cs
+.BI \-d\~ cs
 .TQ
-.BI \-d\  name = s
+.BI \-d\~ name = string
 Define string.
 .
+.
 .TP
 .B \-E
-Disable
-.B @g@troff
-error messages.
+Inhibit
+.I @g@troff
+error messages;
+implies
+.BR \-Ww .
+.
 .
 .TP
-.BI \-f\  fam
+.BI \-f\~ fam
 Set default font family.
 .
+.
 .TP
-.BI \-F\  dir
-Set path for device
-.I DESC
-files.
+.BI \-F\~ dir
+Search in directory
+.I dir
+for the selected output device's directory of device and font
+description files.
+.
 .
 .TP
 .B \-i
 Process standard input after the specified input files.
 .
+.
 .TP
-.BI \-m\  name
-Include macro file
+.BI \-I\~ dir
+Search
+.I dir
+for input files.
+.
+.
+.TP
+.BI \-m\~ name
+Process
 .RI name .tmac
-(or
-.IR tmac. name);
-see also
-.BR \%groff_tmac (@MAN5EXT@).
+before input files.
+.
 .
 .TP
-.BI \-M\  dir
-Path for macro files.
+.BI \-M\~ dir
+Search directory
+.I dir
+for macro files.
+.
 .
 .TP
-.BI \-n\  num
+.BI \-n\~ num
 Number the first page
 .IR num .
 .
+.
 .TP
-.BI \-o\  list
+.BI \-o\~ list
 Output only pages in
 .IR list .
 .
+.
 .TP
-.BI \-r\  cn
+.BI \-r\~ cnumeric-expression
 .TQ
-.BI \-r\  name = n
-Set number register.
+.BI \-r\~ register = numeric-expression
+Define register.
+.
 .
 .TP
-.BI \-w\  name
-Enable warning
+.BI \-w\~ name
+.TQ
+.BI \-W\~ name
+Enable
+.RB ( \-w )
+or inhibit
+.RB ( \-W )
+emission of warnings in category
 .IR name .
 .
-See
-.BR @g@troff (@MAN1EXT@)
-for names.
 .
 .TP
-.BI \-W\  name
-disable warning
-.IR name .
-.
-See
-.BR @g@troff (@MAN1EXT@)
-for names.
+.B \-z
+Suppress formatted device-independent output of
+.IR @g@troff .
 .
 .
 .\" ====================================================================
-.SH "USING GROFF"
+.SH Usage
 .\" ====================================================================
 .
-The
-.I groff system
-implements the infrastructure of classical roff; see
-.BR roff (@MAN7EXT@)
-for a survey on how a
+The architecture of the GNU
 .I roff
-system works in general.
+system
+follows that of other device-independent
+.I roff
+implementations,
+comprising preprocessors,
+macro packages,
+output drivers
+(or \lqpostprocessors\rq),
+a suite of utilities,
+and the formatter
+.I @g@troff
+at its heart.
 .
-Due to the front-end programs available within the
-.I groff
-system, using
-.I groff
-is much easier than
-.IR "classical roff" .
+See
+.MR roff @MAN7EXT@
+for a survey of how a
+.I roff
+system works.
 .
-This section gives an overview of the parts that constitute the
-.I groff
+.
+.P
+The front end programs available in the GNU
+.I roff
+system make it easier to use than traditional
+.IR roff s
+that required the construction of pipelines or use of temporary files to
+carry a source document from maintainable form to device-ready output.
+.
+The discussion below summarizes the constituent parts of the GNU
+.I roff
 system.
 .
 It complements
-.BR roff (@MAN7EXT@)
+.MR roff @MAN7EXT@
 with
 .IR groff -specific
-features.
+information.
 .
-This section can be regarded as a guide to the documentation around
-the
+.
+.\" ====================================================================
+.SS "Getting started"
+.\" ====================================================================
+.
+Those who prefer to learn by experimenting or are desirous of rapid
+feedback from the system may wish to start with a \lqHello,
+world!\&\rq document.
+.
+.
+.P
+.EX
+$ \c
+.B echo \dqHello, world!\dq | groff \-Tascii \
+| sed \aq/\ha$/d\aq
+Hello, world!
+.EE
+.
+.
+.P
+We used a
+.I sed
+command only to eliminate the 65 blank lines that would otherwise flood
+the terminal screen.
+.
+.RI ( roff
+systems were developed in the days of paper-based terminals with 66
+lines to a page.)
+.
+.
+.P
+Today's users may prefer output to a UTF-8-capable terminal.
+.
+.
+.P
+.EX
+$ \c
+.B echo \dqHello, world!\dq | groff \-Tutf8 \
+| sed \aq/\ha$/d\aq
+.EE
+.
+.
+.P
+Producing PDF,
+HTML,
+or \*TeX's DVI is also straightforward.
+.
+The hard part may be selecting a viewer program for the output.
+.
+.
+.P
+.EX
+$ \c
+.B echo \dqHello, world!\dq | groff \-Tpdf > hello.pdf
+$ \c
+.B evince hello.pdf
+$ \c
+.B echo \dqHello, world!\dq | groff \-Thtml > hello.html
+$ \c
+.B firefox hello.html
+$ \c
+.B echo \dqHello, world!\dq | groff \-Tdvi > hello.dvi
+$ \c
+.B xdvi hello.html
+.EE
+.
+.
+.\" ====================================================================
+.SS "Using \fIgroff\f as a REPL"
+.\" ====================================================================
+.
+Those with a programmer's bent may be pleased to know that they can use
 .I groff
-system.
+in a read-evaluate-print loop (REPL).
+.
+Doing so can be handy to verify one's understanding of the formatter's
+behavior and/or the syntax it accepts.
+.
+Turning on all warnings with
+.B \-ww
+can aid this goal.
+.
+.
+.P
+.EX
+$ \c
+.B groff \-ww \-Tutf8
+.B \rs# This is a comment.  Let\aqs define a register.
+.B .nr a 1
+.B \rs# Do integer arithmetic with operators evaluated left-to-right.
+.B .nr b \rsna+5/2
+.ne 2v
+.B \rs# Let\aqs get the result on the standard error stream.
+.B .tm \rsnb
+3
+.B \rs# Now we\aqll define a string.
+.B .ds name Leslie\rs" This is another form of comment.
+.B .nr b (\rsna + (7/2))
+.B \rs# Center the next two text input lines.
+.B .ce 2
+.B Hi, \rs*name.
+.B Your secret number is \rsnb.
+.B \rs# We will see that the division rounded toward zero.
+.B It is
+.B \rs# Here\aqs an if-else control structure.
+.B .ie (\rsnb % 2) odd.
+.B .el even.
+.B \rs# This trick sets the page length to the current vertical
+.B \rs# position, so that blank lines don\aqt spew when we\aqre \
+done.
+.B .pl \rsnnlu
+.I <Control-D>
+                           Hi, Leslie.
+                    Your secret number is 4.
+It is even.
+.EE
 .
 .
 .\" ====================================================================
-.SS Paper Size
+.SS "Paper format"
 .\" ====================================================================
 .
+In GNU
+.IR roff ,
+the page dimensions for the formatter
+.I @g@troff
+and for output devices are handled separately.
+.
+In the formatter,
+requests are used to set the page length
+.RB ( .pl ),
+page offset
+(or left margin,
+.BR .po ),
+and line length
+.RB ( .ll ).
+.
+The right margin is not explicitly configured;
+the combination of page offset and line length provides the information
+necessary to derive it.
+.
 The
-.I virtual
-paper size used by
-.B troff
-to format the input is controlled globally with the requests
-.BR .po ,
-.BR .pl ,
-and
-.BR .ll .
+.I papersize
+macro package,
+automatically loaded by
+.IR @g@troff ,
+provides an interface for configuring page dimensions by convenient
+names,
+like \lqletter\rq or
+\lqA4\rq;
+see
+.MR groff_tmac @MAN5EXT@ .
 .
-See
-.BR groff_tmac (@MAN5EXT@)
-for the \oqpapersize\cq macro package which provides a convenient
-interface.
+The formatter's default in this installation is
+.RB \lq @PAGE@ \rq.
 .
 .
 .P
-The
-.I physical
-paper size, giving the actual dimensions of the paper sheets, is
-controlled by output devices like
-.B grops
-with the command-line options
+It is up to each macro package to respect the page dimensions configured
+in this way.
+.
+Some offer alternative mechanisms.
+.
+.
+.P
+For each output device,
+the size of the output medium can be set in its
+.I DESC
+file.
+.
+Most output drivers also recognize a command-line option
 .B \-p
-and
-.BR \-l .
+to override the default dimensions and an option
+.B \-l
+to use landscape orientation.
 .
 See
-.BR groff_font (@MAN5EXT@)
-and the man pages of the output devices for more details.
+.MR groff_font @MAN5EXT@
+for a description of the
+.B papersize
+directive,
+which takes an argument of the same form as
+.BR \-p .
 .
-.B groff
+The output driver's man page,
+such as
+.MR grops @MAN1EXT@ ,
+may also be helpful.
+.
+.I groff
 uses the command-line option
 .B \-P
-to pass options to output devices; for example, the following selects
-A4 paper in landscape orientation for the PS device:
+to pass options to output devices;
+for example,
+use the following for PostScript output on A4 paper in landscape
+orientation.
+.
 .
 .IP
 .EX
-groff \-Tps \-P\-pa4 \-P\-l ...
+groff \-Tps \-dpaper=a4l \-P\-pa4 \-P\-l \-ms foo.ms > foo.ps
 .EE
 .
 .
 .\" ====================================================================
-.SS Front-ends
+.SS "Front end"
 .\" ====================================================================
 .
 The
-.B groff
+.I groff
 program is a wrapper around the
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 program.
 .
-It allows one to specify the preprocessors by command-line options and
-automatically runs the postprocessor that is appropriate for the
-selected device.
+It allows one to specify preprocessors via command-line options and
+automatically runs the appropriate postprocessor for the selected
+output device.
 .
-Doing so, the sometimes tedious piping mechanism of classical
-.BR roff (@MAN7EXT@)
-can be avoided.
+Doing so,
+the manual construction of pipelines or management of temporary files
+required of users of traditional
+.MR roff @MAN7EXT@
+systems can be avoided.
 .
-.
-.P
-The
-.BR grog (@MAN1EXT@)
-program can be used for guessing the correct
+Use the
+.MR grog @MAN1EXT@
+program to infer an appropriate
 .I groff
-command line to format a file.
-.
-.
-.P
-The
-.BR \%groffer (@MAN1EXT@)
-program is an all-around viewer for
-.I groff
-files and man pages.
+command line to format a document.
 .
 .
 .\" ====================================================================
-.SS Preprocessors
+.SS Language
 .\" ====================================================================
 .
-The
-.I groff
-preprocessors are reimplementations of the classical preprocessors
-with moderate extensions.
+Input to a
+.I roff
+system is in plain text interleaved with control lines and escape
+sequences.
 .
-The standard preprocessors distributed with the
-.I groff
-package are
+The combination constitutes a document in one of a family of languages
+we also call
+.IR roff ;
+see
+.MR roff @MAN7EXT@
+for background.
 .
-.TP
-.BR @g@eqn (@MAN1EXT@)
-for mathematical formulae,
+An overview of GNU
+.I roff
+language syntax and features,
+including lists of all supported escape sequences,
+requests,
+and predefined registers,
+can be found in
+.MR groff @MAN7EXT@ .
 .
-.TP
-.BR @g@grn (@MAN1EXT@)
-for including
-.BR gremlin (1)
-pictures,
+GNU
+.I roff
+extensions to the AT&T
+.I troff
+language,
+a common subset of
+.I roff
+dialects extant today,
+are detailed in
+.MR groff_diff @MAN7EXT@ .
 .
-.TP
-.BR @g@pic (@MAN1EXT@)
-for drawing diagrams,
 .
-.TP
-.BR @g@chem (@MAN1EXT@)
-for chemical structure diagrams,
+.\" ====================================================================
+.SS Preprocessors
+.\" ====================================================================
 .
-.TP
-.BR \%@g@refer (@MAN1EXT@)
-for bibliographic references,
+A preprocessor interprets a domain-specific language that produces
+.I roff
+language output.
 .
-.TP
-.BR \%@g@soelim (@MAN1EXT@)
-for including macro files from standard locations,
+Frequently,
+such input is confined to sections or regions of a
+.I roff
+input file
+(bracketed with macro calls specific to each preprocessor),
+which it replaces.
 .
+Preprocessors therefore often interpret a subset of
+.I roff
+syntax along with their own language.
+.
+GNU
+.I roff
+provides reimplementations of most preprocessors familiar to users of
+AT&T
+.IR troff ; \" AT&T
+these routinely have extended features and/or require GNU
+.I troff \" GNU
+to format their output.
+.
+.
+.br
+.ne 10v
 .P
+.RS
+.TS
+tab($);
+Li Lx.
+@g@tbl$lays out tables;
+@g@eqn$typesets mathematics;
+@g@pic$draws diagrams;
+@g@refer$processes bibliographic references;
+@g@soelim$preprocesses \lqsourced\rq input files;
+@g@grn$T{
+renders
+.MR gremlin 1
+diagrams;
+T}
+@g@chem$T{
+draws chemical structural formul\ae
+using
+.IR pic ; \" generic
+T}
+gperl$T{
+populates
+.I groff
+registers and strings using
+.MR perl 1 ;
+T}
+glilypond$T{
+embeds
+.I LilyPond
+sheet music;
 and
+T}
+gpinyin$T{
+eases Mandarin Chinese input using Hanyu Pinyin.
+T}
+.TE
+.RE
 .
-.TP
-.BR @g@tbl (@MAN1EXT@)
-for tables.
 .
 .P
-A new preprocessor not available in classical
-.I troff
+A preprocessor unique to GNU
+.I roff
 is
-.BR \%preconv (@MAN1EXT@)
-which converts various input encodings to something
-.B groff
+.MR preconv @MAN1EXT@ ,
+which converts various input encodings to something GNU
+.I troff \" GNU
 can understand.
 .
-It is always run first before any other preprocessor.
+When used,
+it is run before any other preprocessors.
+.
 .
 .P
-Besides these, there are some internal preprocessors that are
-automatically run with some devices.
+Most preprocessors enclose content between a pair of characteristic
+tokens.
+.
+Such a token must occur at the beginning of an input line and use the
+dot control character.
 .
-These aren't visible to the user.
+Spaces and tabs must not follow the control character or precede the
+end of the input line.
+.
+Deviating from these rules defeats a token's recognition by the
+preprocessor.
+.
+Tokens are generally preserved in preprocessor output and interpreted as
+macro calls subsequently by
+.IR @g@troff .
+.
+The
+.I @g@ideal
+preprocessor is not yet available in
+.IR groff .
+.
+.
+.P
+.TS
+box, center, tab (^);
+c | c | c
+CfCR | CfCR | CfCR.
+preprocessor^starting token^ending token
+=
+@g@chem^.cstart^.cend
+@g@eqn^.EQ^.EN
+grap^.G1^.G2
+@g@grn^.GS^.GE
+.\" Keep the .IF line below the @g@ideal line.
+@g@ideal^.IS^.IE
+^^.IF
+.\" Keep the .PF line below the @g@pic line.
+@g@pic^.PS^.PE
+^^.PF
+^^.PY
+@g@refer^.R1^.R2
+@g@tbl^.TS^.TE
+_
+glilypond^.lilypond start^.lilypond stop
+gperl^.Perl start^.Perl stop
+gpinyin^.pinyin start^.pinyin stop
+.TE
 .
 .
 .\" ====================================================================
-.SS "Macro Packages"
+.SS "Macro packages"
 .\" ====================================================================
 .
-Macro packages can be included by option
-.BR \-m .
+Macro files are
+.I roff
+input files designed to produce no output themselves but instead ease
+the preparation of other
+.I roff
+documents.
 .
-The
-.I groff
-system implements and extends all classical macro packages in a
-compatible way and adds some packages of its own.
+When a macro file is installed at a standard location and suitable for
+use by a general audience,
+it is termed a
+.IR "macro package" .
+.
+.
+.P
+Macro packages can be loaded prior to any
+.I roff
+input documents with the
+.BR \-m \~option.
+.
+The GNU
+.I roff
+system implements most well-known macro packages for AT&T
+.I troff \" AT&T
+.\" exceptions: mpm, mv
+in a compatible way and extends them.
+.
+These have one- or two-letter names arising from intense practices of
+naming economy in early Unix culture,
+a laconic approach that led to many of the packages being identified in
+general usage with the
+.I nroff
+and
+.I troff
+option letter used to invoke them,
+sometimes to punning effect,
+as with \lqman\rq
+(short for \lqmanual\rq),
+and even with the option dash,
+as in the case of the
+.I s
+package,
+much better known as
+.I ms
+or even
+.IR \-ms .
+.
+.
+.P
+Macro packages serve a variety of purposes.
+.
+Some are \lqfull-service\rq packages,
+adopting responsibility for page layout among other fundamental tasks,
+and defining their own lexicon of macros for document composition;
+each such package stands alone and a given document can use at most one.
 .
-Actually, the following macro packages come with
-.IR groff :
 .
 .TP
-.B man
-The traditional man page format; see
-.BR \%groff_man (@MAN7EXT@).
+.I an
+is used to compose man pages in the format originating in Version\~7
+Unix (1979);
+see
+.MR groff_man @MAN7EXT@ .
+.
 It can be specified on the command line as
-.B \-man
-or
-.BR \-m\~man .
+.BR \-man .
+.
 .
 .TP
-.B mandoc
-The general package for man pages; it automatically recognizes
-whether the documents uses the
-.I man
-or the
-.I mdoc
-format and branches to the corresponding macro package.
+.I doc
+is used to compose man pages in the format originating in 4.3BSD-Reno
+(1990);
+see
+.MR groff_mdoc @MAN7EXT@ .
 .
 It can be specified on the command line as
-.B \%\-mandoc
-or
-.BR \-m\~\%mandoc .
+.BR \-mdoc .
+.
 .
 .TP
-.B mdoc
-The \fCRBSD\f-style man page format; see
-.BR \%groff_mdoc (@MAN7EXT@).
+.I e
+is the Berkeley general-purpose macro suite,
+developed as an alternative to AT&T's
+.IR s ;
+see
+.MR groff_me @MAN7EXT@ .
 .
 It can be specified on the command line as
-.B \-mdoc
-or
-.BR \-m\~mdoc .
+.BR \-me .
+.
 .
 .TP
-.B me
-The classical
-.I me
-document format; see
-.BR \%groff_me (@MAN7EXT@).
+.I m
+implements the format used by the
+second-generation AT&T macro suite for general documents,
+a successor to
+.IR s ;
+see
+.MR groff_mm @MAN7EXT@ .
 .
 It can be specified on the command line as
-.B \-me
-or
-.BR \-m\~me .
+.BR \-mm .
+.
 .
 .TP
-.B mm
-The classical
-.I mm
-document format; see
-.BR \%groff_mm (@MAN7EXT@).
+.I om
+(invariably called \lqmom\rq)
+is a modern package written by Peter Schaffter specifically for GNU
+.IR roff .
+.
+Consult the
+.UR file://\:@HTMLDOCDIR@/\:mom/\:toc\:.html
+.I mom
+HTML manual
+.UE
+for extensive documentation.
+.
+She\emfor
+.I mom
+takes the female pronoun\emcan be specified on the command line as
+.BR \-mom .
 .
-It can be specified on the command line as
-.B \-mm
-or
-.BR \-m\~mm .
 .
 .TP
-.B ms
-The classical
-.I ms
-document format; see
-.BR \%groff_ms (@MAN7EXT@).
+.I s
+is the original AT&T general-purpose document format;
+see
+.MR groff_ms @MAN7EXT@ .
+.
 It can be specified on the command line as
-.B \-ms
-or
-.BR \-m\~ms .
+.BR \-ms .
 .
-.TP
-.B www
-HTML-like macros for inclusion in arbitrary
-.I groff
-documents; see
-.BR \%groff_www (@MAN7EXT@).
 .
 .P
-Details on the naming of macro files and their placement can be found
-in
-.BR \%groff_tmac (@MAN5EXT@);
-this man page also documents some other, minor auxiliary macro packages
-not mentioned here.
-.
+Others are supplemental.
 .
-.\" ====================================================================
-.SS "Programming Language"
-.\" ====================================================================
+For instance,
 .
-General concepts common to all
+.I \%andoc
+is a wrapper package specific to GNU
 .I roff
-programming languages are described in
-.BR roff (@MAN7EXT@).
-.
+that recognizes whether a document uses
+.I man
+or
+.I mdoc
+format and loads the corresponding macro package.
 .
-.P
-The
-.I groff
-extensions to the classical
-.I troff
-language are documented in
-.BR \%groff_diff (@MAN7EXT@).
+It can be specified on the command line as
+.BR \%\-mandoc .
+.
+A
+.MR man 1
+librarian program \" such as man-db, since 2001
+may use this macro file to delegate loading of the correct macro
+package;
+it is thus unnecessary for
+.I man
+itself to scan the contents of a document to decide the issue.
 .
 .
 .P
-An overview of language features,
-including all supported escapes and requests,
-can be found in
-.BR groff (@MAN7EXT@).
+Many macro files augment the function of the full-service packages,
+or of
+.I roff
+documents that do not employ such a package\emthe latter are sometimes
+characterized as \lqraw\rq.
+.
+These auxiliary packages are described,
+along with
+details of macro file naming and placement,
+in
+.MR groff_tmac @MAN5EXT@ .
 .
 .
 .\" ====================================================================
 .SS Formatters
 .\" ====================================================================
 .
-The central
+The formatter,
+the program that interprets
 .I roff
-formatter within the
-.I groff
-system is
-.BR @g@troff (@MAN1EXT@).
+language input,
+is
+.MR @g@troff @MAN1EXT@ .
 .
-It provides the features of both the classical
-.I troff
+It provides the features of the AT&T
+.I troff \" AT&T
 and
-.IR nroff ,
-as well as the
-.I groff
-extensions.
+.I nroff \" AT&T
+programs as well as many extensions.
 .
 The command-line option
 .B \-C
 switches
-.B @g@troff
+.I @g@troff
 into
-.I "compatibility mode"
-which tries to emulate classical
-.I roff
-as much as possible.
+.IR "compatibility mode" ,
+which tries to emulate AT&T
+.I troff \" AT&T
+as closely as is practical to enable the formatting of documents written
+for the older system.
 .
 .
 .P
-There is a shell script
-.BR @g@nroff (@MAN1EXT@)
-that emulates the behavior of classical
-.BR nroff .
+A shell script,
+.MR @g@nroff @MAN1EXT@ ,
+emulates the behavior of AT&T
+.IR nroff . \" AT&T
 .
-It tries to automatically select the proper output encoding, according to
-the current locale.
+It attempts to correctly encode the output based on the locale,
+relieving the user of the need to specify an output device with the
+.B \-T
+option and is therefore convenient for use with terminal output devices,
+described in the next subsection.
 .
 .
 .P
-The formatter program generates
-.IR "intermediate output" ;
-see
-.BR \%groff_out (@MAN7EXT@).
+GNU
+.I troff \" GNU
+generates output in a device-independent,
+but not device-agnostic,
+page description language detailed in
+.MR groff_out @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SS Devices
+.SS "Output devices"
 .\" ====================================================================
 .
-In
-.IR roff ,
-the output targets are called
-.IR devices .
-A device can be a piece of hardware, e.g., a printer, or a software
-file format.
+.I @g@troff
+output is formatted for a particular
+.IR "output device" ,
+typically specified by the
+.B \-T
+option to the formatter or a front end.
 .
-A device is specified by the option
-.BR \-T .
+If neither this option nor the
+.I \%GROFF_TYPESETTER
+environment variable is used,
+the default output device is
+.BR @DEVICE@ .
 .
-The
-.I groff
-devices are as follows.
+An output device may be any of the following.
 .
-.TP
+.
+.TP 9n \" to fit "X100\-12" even on troff devices
 .B ascii
-Text output using the
-.BR ascii (7)
-character set.
+for terminals using the ISO 646 1991:IRV character set and encoding,
+also known as US-ASCII.
+.
 .
 .TP
 .B cp1047
-Text output using the EBCDIC code page IBM cp1047 (e.g., OS/390 Unix).
+for terminals using the IBM code page 1047 character set and encoding.
+.
 .
 .TP
 .B dvi
-TeX DVI format.
+for TeX DVI format.
+.
 .
 .TP
 .B html
-HTML output.
+.TQ
+.B xhtml
+for HTML and XHTML output,
+respectively.
+.
 .
 .TP
 .B latin1
-Text output using the ISO \%Latin-1 (ISO \%8859-1) character set; see
-.BR \%iso_8859_1 (7).
+for terminals using the ISO Latin-1
+(ISO 8859-1)
+character set and encoding.
+.
 .
 .TP
 .B lbp
-Output for Canon CAPSL printers (\%LBP-4 and \%LBP-8 series laser
-printers).
+for Canon CaPSL printers
+(LBP-4 and LBP-8 series laser printers).
+.
 .
 .TP
 .B lj4
-HP LaserJet4-compatible (or other PCL5-compatible) printers.
+for HP LaserJet4-compatible
+(or other PCL5-compatible)
+printers.
+.
+.
+.TP
+.B pdf
+for PDF output.
+.
 .
 .TP
 .B ps
-PostScript output; suitable for printers and previewers like
-.BR gv (1).
+for PostScript output.
+.
 .
 .TP
-.B pdf
-PDF files; suitable for viewing with tools such as
-.BR evince (1)
+.B utf8
+for terminals using the ISO 10646 (\lqUnicode\rq) character set in
+UTF-8 encoding.
+.
+.
+.TP
+.B X75
+for previewing with
+.I \%gxditview
+using
+75 dpi resolution and a
+10-point base type size.
+.
+.
+.TP
+.B X75\-12
+for previewing with
+.I \%gxditview
+using
+75 dpi resolution and a
+12-point base type size.
+.
+.
+.TP
+.B X100
+for previewing with
+.I \%gxditview
+using
+100 dpi resolution and a
+10-point base type size.
+.
+.
+.TP
+.B X100\-12
+for previewing with
+.I \%gxditview
+using
+100 dpi resolution
+and a
+12-point base type size.
+.
+.
+.\" ====================================================================
+.SS Postprocessors
+.\" ====================================================================
+.
+Any program that interprets the output of
+GNU
+.I troff \" GNU
+is a
+postprocessor.
+.
+The postprocessors provided by GNU
+.I roff
+are
+.IR "output drivers" ,
+which prepare a document for viewing or printing.
+.
+Postprocessors for other purposes,
+such as page resequencing or statistical measurement of a document,
+are conceivable.
+.
+.
+.P
+An output driver supports one or more output devices,
+each with its own device description file.
+.
+A device determines its postprocessor with the
+.B postpro
+directive in its device description file;
+see
+.MR groff_font @MAN5EXT@ .
+.
+The
+.B \-X
+option overrides this selection,
+causing
+.I \%gxditview
+to serve as the output driver.
+.
+.
+.TP
+.MR grodvi @MAN1EXT@
+provides
+.BR dvi .
+.
+.
+.TP
+.MR grohtml @MAN1EXT@
+provides
+.B html
 and
-.BR okular (1).
+.BR xhtml .
+.
 .
 .TP
-.B utf8
-Text output using the Unicode (ISO 10646) character set with \%UTF-8
-encoding; see
-.BR unicode (7).
+.MR grolbp @MAN1EXT@
+provides
+.BR lbp .
 .
-.TP
-.B xhtml
-XHTML output.
 .
 .TP
-.B X75
-75dpi X Window System output suitable for the previewers
-.BR \%xditview (1x)
-and
-.BR \%gxditview (@MAN1EXT@).
+.MR grolj4 @MAN1EXT@
+provides
+.BR lj4 .
 .
-A variant for a 12\|pt document base font is
-.BR \%X75-12 .
 .
 .TP
-.B X100
-100dpi X Window System output suitable for the previewers
-.BR \%xditview (1x)
-and
-.BR \%gxditview (@MAN1EXT@).
+.MR gropdf @MAN1EXT@
+provides
+.BR pdf .
 .
-A variant for a 12\|pt document base font is
-.BR \%X100-12 .
 .
+.TP
+.MR grops @MAN1EXT@
+provides
+.BR ps .
 .
-.P
-The postprocessor to be used for a device is specified by the
-.B postpro
-command in the device description file; see
-.BR \%groff_font (@MAN5EXT@).
 .
-This can be overridden with the
-.B \-X
-option.
+.TP
+.MR grotty @MAN1EXT@
+provides
+.BR ascii ,
+.BR cp1047 ,
+.BR latin1 ,
+and
+.BR utf8 .
 .
-.P
-The default device is
-.BR @DEVICE@ .
+.
+.TP
+.MR gxditview @MAN1EXT@
+provides
+.BR X75 ,
+.BR X75\-12 ,
+.BR X100 ,
+and
+.BR X100\-12 ,
+and additionally can preview
+.BR ps .
 .
 .
 .\" ====================================================================
-.SS Postprocessors
+.SS Utilities
 .\" ====================================================================
 .
-.I groff
-provides 3\~hardware postprocessors:
+GNU
+.I roff
+includes a suite of utilities.
 .
-.TP
-.BR \%grolbp (@MAN1EXT@)
-for some Canon printers,
 .
 .TP
-.BR \%grolj4 (@MAN1EXT@)
-for printers compatible to the HP LaserJet\~4 and PCL5,
+.MR gdiffmk @MAN1EXT@
+marks differences between a pair of
+.I roff
+input files.
+.
 .
 .TP
-.BR \%grotty (@MAN1EXT@)
-for text output using various encodings, e.g., on text-oriented
-terminals or line printers.
+.MR grog @MAN1EXT@
+infers the
+.I groff
+command a document requires.
 .
 .
 .P
-Today, most printing or drawing hardware is handled by the operating
-system, by device drivers, or by software interfaces, usually
-accepting PostScript.
+Several utilities prepare descriptions of fonts,
+enabling the formatter to use them when producing output for a given
+device.
 .
-Consequently, there isn't an urgent need for more hardware device
-postprocessors.
 .
+.TP
+.MR addftinfo @MAN1EXT@
+adds information to AT&T
+.I troff \" AT&T
+font description files to enable their use with
+GNU
+.IR troff .\" GNU
 .
-.P
-The
-.I groff
-software devices for conversion into other document file formats are
 .
 .TP
-.BR \%grodvi (@MAN1EXT@)
-for the DVI format,
+.MR afmtodit @MAN1EXT@
+creates font description files for PostScript Type\~1 fonts.
+.
 .
 .TP
-.BR \%grohtml (@MAN1EXT@)
-for HTML and XHTML formats,
+.MR pfbtops @MAN1EXT@
+translates a PostScript Type\~1 font in PFB
+(Printer Font Binary)
+format to PFA
+(Printer Font ASCII),
+which can then be interpreted by
+.IR \%afmtodit .
+.
 .
 .TP
-.BR grops (@MAN1EXT@)
-for PostScript.
+.MR hpftodit @MAN1EXT@
+creates font description files for the HP LaserJet\~4 family of
+printers.
+.
 .
 .TP
-.BR gropdf (@MAN1EXT@)
-for PDF.
+.MR tfmtodit @MAN1EXT@
+creates font description files for the TeX DVI device.
 .
 .
-.P
-Combined with the many existing free conversion tools this should
-be sufficient to convert a
-.I troff
-document into virtually any existing data format.
+.TP
+.MR xtotroff @MAN1EXT@
+creates font description files for X Window System core fonts.
 .
 .
-.\" ====================================================================
-.SS Utilities
-.\" ====================================================================
+.P
+A trio of tools transform material constructed using
+.I roff
+preprocessor languages into graphical image files.
 .
-The following utility programs around
-.I groff
-are available.
 .
 .TP
-.BR \%addftinfo (@MAN1EXT@)
-Add information to
-.I troff
-font description files for use with
-.IR groff .
+.MR eqn2graph @MAN1EXT@
+converts an
+.I eqn
+equation into a cropped image.
 .
-.TP
-.BR \%afmtodit (@MAN1EXT@)
-Create font description files for PostScript device.
 .
 .TP
-.BR \%eqn2graph (@MAN1EXT@)
-Convert an
-.B eqn
-image into a cropped image.
+.MR grap2graph @MAN1EXT@
+converts a
+.I grap
+diagram into a cropped image.
 .
-.TP
-.BR \%gdiffmk (@MAN1EXT@)
-Mark differences between
-.IR groff ,
-.IR nroff ,
-or
-.I troff
-files.
 .
 .TP
-.BR \%grap2graph (@MAN1EXT@)
-Convert a
-.B grap
-diagram into a cropped bitmap image.
+.MR pic2graph @MAN1EXT@
+converts a
+.I pic
+diagram into a cropped image.
 .
-.TP
-.BR \%groffer (@MAN1EXT@)
-General viewer program for
-.I groff
-files and man pages.
 .
-.TP
-.BR \%gxditview (@MAN1EXT@)
-The
-.I groff
-X viewer, the \fCRGNU\f version of
-.BR xditview .
+.P
+Another set of programs works with the bibliographic data files used
+by the
+.MR refer @MAN1EXT@
+preprocessor.
 .
-.TP
-.BR \%hpftodit (@MAN1EXT@)
-Create font description files for lj4 device.
 .
 .TP
-.BR \%@g@indxbib (@MAN1EXT@)
-Make inverted index for bibliographic databases.
+.MR @g@indxbib @MAN1EXT@
+makes inverted indices for bibliographic databases,
+speeding lookup operations on them.
 .
-.TP
-.BR lkbib (@MAN1EXT@)
-Search bibliographic databases.
 .
 .TP
-.BR \%@g@lookbib (@MAN1EXT@)
-Interactively search bibliographic databases.
+.MR lkbib @MAN1EXT@
+searches the databases.
 .
-.TP
-.BR \%pdfroff (@MAN1EXT@)
-Create PDF documents using
-.BR groff .
 .
 .TP
-.BR \%pfbtops (@MAN1EXT@)
-Translate a PostScript font in \&.pfb format to \fCRASCII\f.
+.MR @g@lookbib @MAN1EXT@
+interactively searches
+the databases.
 .
-.TP
-.BR \%pic2graph (@MAN1EXT@)
-Convert a
-.B pic
-diagram into a cropped image.
 .
-.TP
-.BR \%tfmtodit (@MAN1EXT@)
-Create font description files for TeX DVI device.
+.\" ====================================================================
+.SH "Exit status"
+.\" ====================================================================
 .
-.TP
-.BR \%xditview (1x)
-.I roff
-viewer historically distributed with the X Window System.
-.\" Nowadays (2017) it's its own module as X.Org does not do monolithic
-.\" releases anymore (since 2012).  Development on "app/xditview" is
-.\" close to moribund, though.
+.I groff
+exits with a failure status if there was a problem parsing its arguments
+and a successful status if either of the options
+.B \-h
+or
+.B \-\-help
+was specified.
 .
-.TP
-.BR \%xtotroff (@MAN1EXT@)
-Convert X font metrics into \fCRGNU\f
-.I troff
-font metrics.
+Otherwise,
+.I groff
+runs a pipeline to process its input;
+if all commands within the pipeline exit successfully,
+.I groff
+does likewise.
+.
+If not,
+.IR groff 's
+exit status encodes a summary of problems encountered,
+setting bit\~0 if a command exited with a failure status,
+bit\~1 if a command was terminated with a signal,
+and bit\~2 if a command could not be executed.
+.
+(Thus,
+if all three misfortunes befell one's pipeline,
+.I groff
+would exit with status 2\ha0 + 2\ha1 + 2\ha2 = 1+2+4 = 7.)
+.
+To troubleshoot pipeline problems,
+you may wish to re-run the
+.I groff
+command with the
+.B \-V
+option and break the reported pipeline down into separate stages,
+inspecting the exit status of and diagnostic messages emitted by each
+command.
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
-Normally, the path separator in the following environment variables is
-the colon; this may vary depending on the operating system.
+Normally,
+the path separator in environment variables ending with
+.I PATH
+is the colon;
+this may vary depending on the operating system.
 .
-For example, DOS and Windows use a semicolon instead.
+For example,
+Windows uses a semicolon instead.
 .
 .
 .TP
 .I GROFF_BIN_PATH
-This search path, followed by
+This search path,
+followed by
 .IR PATH ,
-is used for commands that are executed by
-.BR groff .
+is used to locate commands executed by
+.IR groff .
 .
-If it is not set then the directory where the
-.I groff
-binaries were installed is prepended to
+If it is not set,
+the installation directory of the GNU
+.I roff
+executables,
+.IR @BINDIR@ ,
+is searched before
 .IR PATH .
 .
 .
 .TP
 .I GROFF_COMMAND_PREFIX
-When there is a need to run different
+GNU
 .I roff
-implementations at the same time
-.I groff
-provides the facility to prepend a prefix to most of its programs that
-could provoke name clashings at run time (default is to have none).
+can be configured at compile time to apply a prefix to the names of the
+programs it provides that had a counterpart in AT&T
+.IR troff , \" AT&T
+so that name collisions are avoided at run time.
 .
-Historically, this prefix was the character
-.BR g ,
-but it can be anything.
+The default prefix is empty.
 .
-For example,
-.B gtroff
-stood for
-.IR groff 's
-.BR troff ,
-.B gtbl
-for the
-.I groff
-version of
-.BR tbl .
 .
-By setting
-.I \%GROFF_COMMAND_PREFIX
-to different values, the different
-.I roff
-installations can be addressed.
-.
-More exactly, if it is set to prefix
-.I xxx
-then
-.B groff
-as a wrapper program internally calls
-.IB xxx troff
-instead of
-.BR troff .
-.
-This also applies to the preprocessors
-.BR eqn ,
-.BR grn ,
-.BR pic ,
-.BR \%refer ,
-.BR tbl ,
-.BR \%soelim ,
-and to the utilities
-.B \%@g@indxbib
-and
-.BR \%@g@lookbib .
+.IP
+When used,
+this prefix is conventionally the letter \lqg\rq.
 .
-This feature does not apply to any programs different from the ones
-above (most notably
-.B groff
-itself) since they are unique to the
-.I groff
-package.
+For example,
+GNU
+.I troff \" GNU
+would be installed as
+.IR gtroff .
+.
+Besides
+.IR troff , \" GNU
+the prefix applies to
+the formatter
+.IR nroff ; \" GNU
+the preprocessors
+.IR eqn , \" generic
+.IR grn , \" generic
+.IR pic , \" generic
+.IR \%refer , \" generic
+.IR tbl , \" generic
+and
+.IR \%soelim ; \" generic
+and the utilities
+.I \%indxbib \" generic
+and
+.IR \%lookbib . \" generic
 .
 .
 .TP
 .I GROFF_ENCODING
-The value of this environment value is passed to the
-.B preconv
-preprocessor to select the encoding of input files.
+The value of this variable is passed to the
+.IR preconv (@MAN1EXT@)
+preprocessor's
+.B \-e
+option to select the character encoding of input files.
 .
-Setting this option implies
-.BR groff 's
-command-line option
-.B \-k
-(this is,
-.B groff
-actually always calls
-.BR preconv ).
+This variable's existence implies
+the
+.I groff
+option
+.BR \-k .
 .
-If set without a value,
-.B groff
+If set but empty,
+.I groff
 calls
-.B preconv
-without arguments.
+.I preconv
+without an
+.B \-e
+option.
 .
-An explicit
+.IR groff 's
 .B \-K
-command-line option overrides the value of
+option overrides
 .IR \%GROFF_ENCODING .
 .
-See
-.BR preconv (@MAN1EXT@)
-for details.
-.
 .
 .TP
 .I GROFF_FONT_PATH
-A list of directories in which to search for the
-.IR dev name
-directory in addition to the default ones.
+Seek the selected output device's directory of device and font
+description files in this list of directories.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_font (@MAN5EXT@)
-for more details.
+.MR groff_font @MAN5EXT@ .
 .
 .
 .TP
 .I GROFF_TMAC_PATH
-A list of directories in which to search for macro files in addition
-to the default directories.
+Seek macro files in this list of directories.
 .
 See
-.BR @g@troff (@MAN1EXT@)
+.MR @g@troff @MAN1EXT@
 and
-.BR \%groff_tmac (@MAN5EXT@)
-for more details.
+.MR groff_tmac @MAN5EXT@ .
 .
 .
 .TP
 .I GROFF_TMPDIR
-The directory in which temporary files are created.
+Create temporary files in this directory.
 .
-If this is not set but the environment variable
+If not set,
+but the environment variable
 .I \%TMPDIR
-instead, temporary files are created in the directory
-.IR \%TMPDIR .
+is set,
+temporary files are created there instead.
 .
-On MS-DOS and Windows platforms, the environment variables
+On Windows systems,
+if neither of the foregoing are set,
+the environment variables
 .I TMP
 and
 .I TEMP
-(in that order) are searched also, after
-.I \%GROFF_TMPDIR
-and
-.IR \%TMPDIR .
+(in that order)
+are checked also.
 .
-Otherwise, temporary files are created in
+Otherwise,
+temporary files are created in
 .IR /tmp .
 .
 The
-.BR \%@g@refer (@MAN1EXT@),
-.BR \%groffer (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
+.MR @g@refer @MAN1EXT@ ,
+.MR grohtml @MAN1EXT@ ,
 and
-.BR grops (@MAN1EXT@)
+.MR grops @MAN1EXT@
 commands use temporary files.
 .
 .
 .TP
 .I GROFF_TYPESETTER
-Preset the default device.
+Set the default output device.
 .
-If this is not set the
+If empty or not set,
 .B @DEVICE@
-device is used as default.
+is used.
+.
+The
+.B \-T
+option overrides
+.IR \%GROFF_TYPESETTER .
+.
 .
-This device name is overwritten by the option
-.BR \-T .
+.TP
+.I SOURCE_DATE_EPOCH
+A time stamp
+(expressed as seconds since the Unix epoch)
+to use as the output creation time stamp in place of the current time.
+.
+The time is converted to human-readable form using
+.MR localtime 3
+when the formatter starts up and stored in registers usable by documents
+and macro packages.
+.
+.
+.TP
+.I TZ
+The time zone to use when converting the current time
+(or value of
+.IR SOURCE_DATE_EPOCH )
+to human-readable form;
+see
+.MR tzset 3 .
 .
 .
 .\" ====================================================================
-.SH EXAMPLES
+.SH Examples
 .\" ====================================================================
 .
-The following example illustrates the power of the
-.B groff
-program as a wrapper around
-.BR @g@troff .
+.I roff
+systems are best known for formatting man pages.
+.
+Once a
+.MR man 1
+librarian program has located a man page,
+it may execute a
+.I groff
+command much like the following.
+.
+.RS
+.EX
+groff \-t \-man \-Tutf8 /usr/share/man/man1/groff.1
+.EE
+.RE
+.
+The librarian will also pipe the output through a pager,
+which might not interpret the SGR terminal escape sequences
+.I groff
+emits for boldface,
+underlining,
+or italics;
+see section \lqLimitations\rq below.
 .
 .
 .P
 To process a
 .I roff
-file using the preprocessors
-.B tbl
+input file using the preprocessors
+.I @g@tbl
 and
-.B pic
+.I @g@pic
 and the
-.B me
-macro set, classical
-.I troff
-had to be called by
+.I me
+macro package in the way to which AT&T
+.I troff \" AT&T
+users were accustomed,
+one would type
+(or script)
+a pipeline.
+.
 .
 .IP
 .EX
-pic foo.me | tbl | troff \-me \-Tlatin1 | grotty
+@g@pic foo.me | @g@tbl | @g@troff \-me \-Tutf8 | grotty
 .EE
 .
 .
 .P
 Using
-.BR groff ,
-this pipe can be shortened to the equivalent command
+.IR groff ,
+this pipe can be shortened to an equivalent command.
 .
 .IP
 .EX
-groff \-p \-t \-me \-T latin1 foo.me
+groff \-p \-t \-me \-T utf8 foo.me
 .EE
 .
 .
 .P
-An even easier way to call this is to use
-.BR grog (@MAN1EXT@)
-to guess the preprocessor and macro options and execute the generated
-command (by using backquotes to specify shell command substitution)
+An even easier way to do this is to use
+.MR grog @MAN1EXT@
+to guess the preprocessor and macro options and execute the result by
+using the command substitution feature of the shell.
 .
 .IP
 .EX
-\gagrog \-Tlatin1 foo.me\ga
+$(grog \-Tutf8 foo.me)
 .EE
 .
 .
 .P
-The simplest way is to view the contents in an automated way by
-calling
+Each command-line option to a postprocessor must be specified with any
+required leading dashes
+.RB \lq \- \rq
+.\" No GNU roff postprocessor uses long options for anything except
+.\" --help or --version.
+.\"or
+.\".RB \lq \-\- \rq
+because
+.I groff
+passes the arguments as-is to the postprocessor;
+this permits arbitrary arguments to be transmitted.
 .
-.IP
+For example,
+to pass a title to the
+.I gxditview
+postprocessor,
+the shell commands
+.
+.RS
+.EX
+groff \-X \-P \-title \-P \aqtrial run\aq mydoc.t
+.EE
+.RE
+.
+and
+.
+.RS
 .EX
-groffer foo.me
+groff \-X \-Z mydoc.t | gxditview \-title \aqtrial run\aq \-
 .EE
+.RE
+.
+are equivalent.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Limitations
 .\" ====================================================================
 .
-On \fCREBCDIC\f hosts (e.g., \fCROS/390 Unix\f), output
-devices
+When paging output for the
+.BR ascii ,
+.BR cp1047 ,
+.BR latin1 ,
+and
+.B utf8
+devices,
+programs like
+.MR more 1
+and
+.MR less 1
+may require command-line options to correctly handle some terminal
+escape sequences;
+see
+.MR grotty @MAN1EXT@ .
+.
+.
+.P
+On EBCDIC hosts such as OS/390 Unix,
+the output devices
 .B ascii
 and
 .B latin1
 aren't available.
 .
-Similarly, output for \fCREBCDIC\f code page
+Conversely,
+the output device
 .B cp1047
-is not available on \fCRASCII\f based operating systems.
+is not available on systems based on the ISO\~646 or ISO\~8859 character
+encoding standards.
 .
 .
 .\" ====================================================================
-.SH "INSTALLATION DIRECTORIES"
+.SH "Installation directories"
 .\" ====================================================================
 .
-.I groff
+GNU
+.I roff
 installs files in varying locations depending on its compile-time
 configuration.
 .
-On this installation, the following locations are used.
+On this installation,
+the following locations are used.
 .
 .
+.if !'@APPDEFDIR@'' \{\
 .TP
-.I @APPRESDIR@
+.I @APPDEFDIR@
 Application defaults directory for
-.IR gxditview (@MAN1EXT@).
+.MR gxditview @MAN1EXT@ .
+.\}
 .
 .
 .TP
@@ -1653,7 +2069,7 @@
 .TP
 .I @COMMON_WORDS_FILE@
 List of common words for
-.IR indxbib (@MAN1EXT@).
+.MR indxbib @MAN1EXT@ .
 .
 .
 .TP
@@ -1664,9 +2080,9 @@
 .TP
 .I @DEFAULT_INDEX@
 Default index for
-.IR lkbib (@MAN1EXT@)
+.MR lkbib @MAN1EXT@
 and
-.IR refer (@MAN1EXT@).
+.MR refer @MAN1EXT@ .
 .
 .
 .TP
@@ -1718,7 +2134,7 @@
 Font directory for compatibility with old versions of
 .IR groff ;
 see
-.IR grops (@MAN1EXT@).
+.MR grops @MAN1EXT@ .
 .
 .
 .TP
@@ -1726,179 +2142,121 @@
 PDF documentation directory.
 .
 .
+.if !'@COMPATIBILITY_WRAPPERS@'no' \{\
 .TP
 .I @SYSTEMMACRODIR@
 System macro package
 .RI ( tmac
 file) directory.
+.\}
 .
 .
 .\" ====================================================================
-.SS "groff Macro Directory"
+.SS "\fIgroff\f macro directory"
 .\" ====================================================================
 .
-This contains all information related to macro packages.
-.
-Note that more than a single directory is searched for those files
-as documented in
-.BR \%groff_tmac (@MAN5EXT@).
-.
-For the
-.I groff
-installation corresponding to this document, it is located at
-.IR @MACRODIR@ .
-.
-The following files contained in the
-.I groff macro directory
-have a special meaning:
-.
-.
-.TP
-.I troffrc
-Initialization file for
-.IR troff .
-.
-This is interpreted by
-.B @g@troff
-before reading the macro sets and any input.
-.
-.
-.TP
-.I troffrc\-end
-Final startup file for
-.IR troff .
-.
-It is parsed after all macro sets have been read.
+Most macro files supplied with GNU
+.I roff
+are stored in
+.I @MACRODIR@
+for the installation corresponding to this document.
 .
+As a rule,
+multiple directories are searched for macro files;
+see
+.MR @g@troff @MAN1EXT@ .
 .
-.TP
-.RI name .tmac
-.TQ
-.IR tmac. name
-Macro file for macro package
-.IR name .
+For a catalog of macro files GNU
+.I roff
+provides,
+see
+.MR groff_tmac @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SS "groff Font Directory"
+.SS "\fIgroff\f device and font description directory"
 .\" ====================================================================
 .
-This contains all information related to output devices.
-.
-Note that more than a single directory is searched for those files; see
-.BR @g@troff (@MAN1EXT@).
-.
-For the
-.I groff
-installation corresponding to this document, it is located at
-.IR @FONTDIR@ .
-.
-The following files contained in the
-.I "groff font directory"
-have a special meaning:
-.
+Device and font description files supplied with GNU
+.I roff
+are stored in
+.I @FONTDIR@
+for the installation corresponding to this document.
 .
-.TP
-.IR dev name /DESC
-Device description file for device
-.IR name ,
+As a rule,
+multiple directories are searched for device and font description files;
 see
-.BR \%groff_font (@MAN5EXT@).
+.MR @g@troff @MAN1EXT@ .
 .
-.
-.TP
-.IR dev name / F
-Font file for font
-.I F
-of device
-.IR name .
+For the formats of these files,
+see
+.MR groff_font @MAN5EXT@ .
 .
 .
 .\" ====================================================================
-.SH AVAILABILITY
+.SH Availability
 .\" ====================================================================
 .
-Information on how to get
-.I groff
-and related information is available at the
-.UR http://\:www.gnu.org/\:software/\:groff
-groff page of the GNU website
-.UE .
-.
-.
-.P
-Three
+Obtain links to
 .I groff
-mailing lists are available:
-.
-.
-.IP
-.MT bug\-groff@\:gnu.org
-bug tracker activity (read-only)
-.ME ;
-.
-.
-.IP
-.MT groff@\:gnu.org
-general discussion
-.ME ;
-and
-.
-.
-.IP
-.MT groff\-commit@\:gnu.org
-commit activity (read-only)
-.ME ,
-which reports changes to
-.IR groff 's
-source code repository by its developers.
-.
-.
-.P
-Details on repository access and much more can be found in the file
-.I README
-at the top directory of the
+releases for download,
+its source repository,
+discussion mailing lists,
+a support ticket tracker,
+and further information from the
+.UR http://\:www\:.gnu\:.org/\:software/\:groff
 .I groff
-source package.
+page of the GNU website
+.UE .
 .
 .
 .P
 A free implementation of the
-.B grap
-preprocessor, written by
-.MT faber@\:lunabase.org
+.I grap
+preprocessor,
+written by
+.MT faber@\:lunabase\:.org
 Ted Faber
 .ME ,
 can be found at the
-.UR http://\:www.lunabase.org/\:\|\tifaber/\:Vault/\:software/\:grap/
-grap website
+.UR http://\:www\:.lunabase\:.org/\:\tifaber/\:Vault/\:software/\
+\:grap/
+.I grap
+website
 .UE .
 .
-This is the only
-.I grap
-supported by
-.IR groff .
+.I groff
+supports only this
+.IR grap .
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
-.B groff
-was written by
-.MT jjc@\:jclark.com
+.I groff
+(both the front-end command and the overall system)
+was primarily written by
+.MT jjc@\:jclark\:.com
 James Clark
 .ME .
 .
-This document was rewritten, enhanced, and put under the FDL license in
-2002 by
-.MT groff\-bernd.warken\-72@\:web.de
+Contributors to this document include Clark,
+Trent A.\& Fisher,
+.MT wl@gnu.org
+Werner Lemberg
+.ME ,
+.MT groff\-bernd.warken\-72@\:web\:.de
 Bernd Warken
+.ME ,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -1910,146 +2268,136 @@
 You can browse it interactively with \lqinfo groff\rq.
 .
 .
-.P
-Due to its complex structure, the
-.I groff
-system has many man pages.
+.\" groff ships 59 man pages generated from 58 source files.  The
+.\" numbered comments refer to their sorting order in the source tree,
+.\" so that it is easier to tell that we've enumerated all of them.
+.TP
+Introduction, \c
+history, \c
+and further reading:
+.MR roff @MAN7EXT@ \" #23
 .
-They can be read with
-.BR man (1)
-or
-.BR \%groffer (@MAN1EXT@).
 .
-.P
-But there are special sections of
-.IR "man pages" .
+.TP
+.RI "Viewer for\~" groff "\~(and AT&T device-independent\~" troff \
+)\~documents:
+.MR gxditview @MAN1EXT@ \" #33
 .
-.I groff
-has man pages in sections
-.BR 1 , " 5" , and " 7" .
 .
-When there are several
-.I man pages
-with the same name in the same
-.I man
-section, the one with the lowest section is should as first.
+.TP
+Preprocessors:
+.MR @g@chem @MAN1EXT@ , \" #1
+.MR @g@eqn @MAN1EXT@ , \" #34
+.MR @g@neqn @MAN1EXT@ , \" #35
+.MR glilypond @MAN1EXT@ , \" #4
+.MR @g@grn @MAN1EXT@ , \" #36
+.MR preconv @MAN1EXT@ , \" #38
+.MR gperl @MAN1EXT@ , \" #5
+.MR @g@pic @MAN1EXT@ , \" #37
+.MR gpinyin @MAN1EXT@ , \" #6
+.MR @g@refer @MAN1EXT@ , \" #39
+.MR @g@soelim @MAN1EXT@ , \" #40
+.MR @g@tbl @MAN1EXT@ \" #41
 .
-The other man pages can be shown anyway by adding the section number
-as argument before the man page name.
 .
-Reading the man page about the
-.I groff
-language is done by one of
-.RS
-.nf
-.nh
-.EX
-.B man 7 groff
-.B groffer 7 groff
-.EE
-.hy
-.fi
-.RE
+.TP
+Macro packages and package-specific utilities:
+.MR groff_hdtbl @MAN7EXT@ , \" #9
+.MR groff_man @MAN7EXT@ , \" #55a
+.MR groff_man_style @MAN7EXT@ , \" #55b
+.MR groff_mdoc @MAN7EXT@ , \" #56
+.MR groff_me @MAN7EXT@ , \" #57
+.MR groff_mm @MAN7EXT@ , \" # 10
+.MR groff_mmse @MAN7EXT@ , \" # 11
+.MR mmroff @MAN1EXT@ , \" #12
+.MR groff_mom @MAN7EXT@ , \" #13
+.MR pdfmom @MAN1EXT@ , \" #30
+.MR groff_ms @MAN7EXT@ , \" #58
+.MR groff_rfc1345 @MAN7EXT@ , \" 16
+.MR groff_trace @MAN7EXT@ , \" #59
+.MR groff_www @MAN7EXT@ \" #60
+.
 .
-.ad l
 .TP
-Introduction, history and further readings:
-.BR roff (@MAN7EXT@).
+Bibliographic database management tools:
+.MR @g@indxbib @MAN1EXT@ , \" #49
+.MR lkbib @MAN1EXT@ , \" #50
+.MR @g@lookbib @MAN1EXT@ \" #51
+.
 .
 .TP
-Viewer for groff files:
-.BR \%groffer (@MAN1EXT@),
-.BR \%gxditview (@MAN1EXT@),
-.BR \%xditview (1x).
+Language, \c
+conventions, \c
+and GNU extensions:
+.MR groff @MAN7EXT@ , \" #17
+.MR groff_char @MAN7EXT@ , \" #18
+.MR groff_diff @MAN7EXT@ , \" #19
+.MR groff_font @MAN5EXT@ , \" #20
+.MR groff_tmac @MAN5EXT@ \" #22
+.
 .
 .TP
-Wrapper programs for formatters:
-.BR \%groff (@MAN1EXT@),
-.BR \%grog (@MAN1EXT@).
+Intermediate output language:
+.MR groff_out @MAN5EXT@ \" #21
+.
 .
 .TP
-Roff preprocessors:
-.BR \%@g@eqn (@MAN1EXT@),
-.BR \%@g@grn (@MAN1EXT@),
-.BR \%@g@pic (@MAN1EXT@),
-.BR \%@g@chem (@MAN1EXT@),
-.BR \%preconv (@MAN1EXT@),
-.BR \%@g@refer (@MAN1EXT@),
-.BR \%@g@soelim (@MAN1EXT@),
-.BR \%@g@tbl (@MAN1EXT@),
-.BR grap (1).
+Formatter program:
+.MR @g@troff @MAN1EXT@ \" #45
+.
 .
 .TP
-Roff language with the groff extensions:
-.BR \%groff (@MAN7EXT@),
-.BR \%groff_char (@MAN7EXT@),
-.BR \%groff_diff (@MAN7EXT@),
-.BR \%groff_font (@MAN5EXT@).
+Formatter wrappers:
+.\".MR groff @MAN1EXT@ , \" 42 -- this page
+.MR @g@nroff @MAN1EXT@ , \" #44
+.MR pdfroff @MAN1EXT@ \" #14
+.
 .
 .TP
-Roff formatter programs:
-.BR \%@g@nroff (@MAN1EXT@),
-.BR \%@g@troff (@MAN1EXT@),
-.BR ditroff (@MAN7EXT@).
+Postprocessors for output devices:
+.MR grodvi @MAN1EXT@ , \" #24
+.MR grohtml @MAN1EXT@ , \" #25
+.MR grolbp @MAN1EXT@ , \" #26
+.MR grolj4 @MAN1EXT@ , \" #27
+.MR gropdf @MAN1EXT@ , \" #29
+.MR grops @MAN1EXT@ , \" #31
+.MR grotty @MAN1EXT@ \" #32
+.
 .
 .TP
-The intermediate output language:
-.BR \%groff_out (@MAN7EXT@).
+Font support utilities:
+.MR addftinfo @MAN1EXT@ , \" #46
+.MR afmtodit @MAN1EXT@ , \" #47
+.MR hpftodit @MAN1EXT@ , \" #48
+.MR pfbtops @MAN1EXT@ , \" #52
+.MR tfmtodit @MAN1EXT@ , \" #53
+.MR xtotroff @MAN1EXT@ \" #54
+.
 .
 .TP
-Postprocessors for the output devices:
-.BR \%grodvi (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
-.BR \%grolbp (@MAN1EXT@),
-.BR \%grolj4 (@MAN1EXT@),
-.BR \%lj4_font (@MAN5EXT@),
-.BR \%grops (@MAN1EXT@),
-.BR \%gropdf (@MAN1EXT@),
-.BR \%grotty (@MAN1EXT@).
+Graphics conversion utilities:
+.MR eqn2graph @MAN1EXT@ , \" #2
+.MR grap2graph @MAN1EXT@ , \" #7
+.MR pic2graph @MAN1EXT@ \" #15
+.
 .
 .TP
-Groff macro packages and macro-specific utilities:
-.BR \%groff_tmac (@MAN5EXT@),
-.BR \%groff_man (@MAN7EXT@),
-.BR \%groff_mdoc (@MAN7EXT@),
-.BR \%groff_me (@MAN7EXT@),
-.BR \%groff_mm (@MAN7EXT@),
-.BR \%groff_mmse (@MAN7EXT@),
-.BR \%groff_mom (@MAN7EXT@),
-.BR \%groff_ms (@MAN7EXT@),
-.BR \%groff_www (@MAN7EXT@),
-.BR \%groff_trace (@MAN7EXT@),
-.BR \%mmroff (@MAN7EXT@).
+Difference-marking utility:
+.MR gdiffmk @MAN1EXT@ \" #3
+.
 .
 .TP
-The following utilities are available:
-.BR \%addftinfo (@MAN1EXT@),
-.BR \%afmtodit (@MAN1EXT@),
-.BR \%eqn2graph (@MAN1EXT@),
-.BR \%gdiffmk (@MAN1EXT@),
-.BR \%grap2graph (@MAN1EXT@),
-.BR \%groffer (@MAN1EXT@),
-.BR \%gxditview (@MAN1EXT@),
-.BR \%hpftodit (@MAN1EXT@),
-.BR \%@g@indxbib (@MAN1EXT@),
-.BR \%lkbib (@MAN1EXT@),
-.BR \%@g@lookbib (@MAN1EXT@),
-.BR \%pdfroff (@MAN1EXT@),
-.BR \%pfbtops (@MAN1EXT@),
-.BR \%pic2graph (@MAN1EXT@),
-.BR \%tfmtodit (@MAN1EXT@),
-.BR \%xtotroff (@MAN1EXT@).
+\lqgroff guess\rq utility:
+.MR grog @MAN1EXT@ \" #43
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_1_C
-.
+.cp \n*groff_groff_1_man_C
+.do rr *groff_groff_1_man_C
 .
-.\" ====================================================================
-.\" Emacs setup
-.\" ====================================================================
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/groff/groff.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/groff.am Changed

@@ -1,20 +1,20 @@
-# Copyright (C) 1993-2018 Free Software Foundation, Inc.
+# Copyright (C) 1993-2020 Free Software Foundation, Inc.
 #
-#   Original Makefile.sub rewritten by 
+#   Original Makefile.sub rewritten by
 #   Bernd Warken <groff-bernd.warken-72@web.de>
 #   and Werner LEMBERG <wl@gnu.org>
 #
-#   Automake migration by 
+#   Automake migration by
 #   Bertrand Garrigues <bertrand.garrigues@laposte.net>
 #
-# Latest update: 22 Aug 2015
+# This file is part of groff.
 #
-# 'groff' is free software; you can redistribute it and/or modify it
+# 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
 # (at your option) any later version.
 #
-# 'groff' is distributed in the hope that it will be useful, but
+# 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.
@@ -22,8 +22,6 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-########################################################################
-
 bin_PROGRAMS += groff
 groff_LDADD = \
   libgroff.a \
@@ -36,37 +34,54 @@
 src/roff/groff/groff.$(OBJEXT): defs.h
 man1_MANS += src/roff/groff/groff.1
 EXTRA_DIST += src/roff/groff/groff.1.man
-GROFF_OPTS_OUTPUT = \
-  groff_opts_no_arg.txt \
-  groff_opts_with_arg.txt
-groffoptsdir = $(libprogramdir)
-groffopts_DATA = $(GROFF_OPTS_OUTPUT)
-
-MOSTLYCLEANFILES += groff_opts.tmp $(GROFF_OPTS_OUTPUT)
 
-groff_opts.tmp: src/roff/groff/groff.cpp
-	@$(GREP) -e ':.*:.*:' $? | sed -e 's/ \t",//g' > $@
-	@echo -n 'groff options: '
-	@cat $@
+groff_TESTS = \
+  src/roff/groff/tests/ab_works.sh \
+  src/roff/groff/tests/adjustment_works.sh \
+  src/roff/groff/tests/break_zero-length_output_line_sanely.sh \
+  src/roff/groff/tests/device_control_escapes_express_basic_latin.sh \
+  src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh \
+  src/roff/groff/tests/dot-cp_register_works.sh \
+  src/roff/groff/tests/dot-nm_register_works.sh \
+  src/roff/groff/tests/dot-nn_register_works.sh \
+  src/roff/groff/tests/evc_produces_no_output_if_invalid.sh \
+  src/roff/groff/tests/fp_should_not_traverse_directories.sh \
+  src/roff/groff/tests/handle_special_input_code_points.sh \
+  src/roff/groff/tests/html_works_with_grn_and_eqn.sh \
+  src/roff/groff/tests/initialization_is_quiet.sh \
+  src/roff/groff/tests/localization_works.sh \
+  src/roff/groff/tests/msoquiet_works.sh \
+  src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh \
+  src/roff/groff/tests/output_driver_C_and_G_options_work.sh \
+  src/roff/groff/tests/recognize_end_of_sentence.sh \
+  src/roff/groff/tests/regression_savannah_56555.sh \
+  src/roff/groff/tests/regression_savannah_58153.sh \
+  src/roff/groff/tests/regression_savannah_58162.sh \
+  src/roff/groff/tests/regression_savannah_58337.sh \
+  src/roff/groff/tests/regression_savannah_59202.sh \
+  src/roff/groff/tests/smoke-test_html_device.sh \
+  src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh \
+  src/roff/groff/tests/soquiet_works.sh \
+  src/roff/groff/tests/string_case_xform_errors.sh \
+  src/roff/groff/tests/string_case_xform_requests.sh \
+  src/roff/groff/tests/string_case_xform_unicode_escape.sh \
+  src/roff/groff/tests/substring_works.sh \
+  src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh
+TESTS += $(groff_TESTS)
+EXTRA_DIST += $(groff_TESTS)
 
-groff_opts_no_arg.txt: groff_opts.tmp
-	@sed -e 's/a-zA-Z://g' $? > $@
-	@echo -n 'no arg: '
-	@cat $@
+# required test artifacts
+EXTRA_DIST += \
+  src/roff/groff/tests/artifacts/HONEYPOT \
+  src/roff/groff/tests/artifacts/devascii/README
 
-groff_opts_with_arg.txt: groff_opts_no_arg.txt
-	@rm -f $@
-	@sed "s/`cat $?`://g" groff_opts.tmp > $@
-	@echo -n 'with arg: '
-	@cat $@
+groff_XFAIL_TESTS = \
+  src/roff/groff/tests/string_case_xform_unicode_escape.sh
+XFAIL_TESTS += $(groff_XFAIL_TESTS)
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/groff/groff.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/groff.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -21,11 +20,11 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
-#include <signal.h>
+#include <assert.h>
 #include <errno.h>
+#include <signal.h>
+#include <stdlib.h>
 
-#include "assert.h"
 #include "errarg.h"
 #include "error.h"
 #include "stringclass.h"
@@ -49,7 +48,8 @@
 }
 #endif /* NEED_DECLARATION_PUTENV */
 
-// The number of commands must be in sync with MAX_COMMANDS in pipeline.h
+// The number of commands must be in sync with MAX_COMMANDS in
+// pipeline.h.
 
 // grap, chem, and ideal must come before pic;
 // tbl must come before eqn
@@ -82,7 +82,7 @@
   void set_name(const char *);
   void set_name(const char *, const char *);
   const char *get_name();
-  void append_arg(const char *, const char * = 0);
+  void append_arg(const char *, const char * = 0 /* nullptr */);
   void insert_arg(const char *);
   void insert_args(string s);
   void clear_args();
@@ -93,9 +93,13 @@
 extern "C" const char *Version_string;
 
 int lflag = 0;
-char *spooler = 0;
-char *postdriver = 0;
-char *predriver = 0;
+char *spooler = 0 /* nullptr */;
+char *postdriver = 0 /* nullptr */;
+char *predriver = 0 /* nullptr */;
+bool need_postdriver = true;
+char *saved_path = 0 /* nullptr */;
+char *groff_bin_path = 0 /* nullptr */;
+char *groff_font_path = 0 /* nullptr */;
 
 possible_command commandsNCOMMANDS;
 
@@ -107,7 +111,31 @@
 const char *xbasename(const char *);
 
 void usage(FILE *stream);
-void help();
+
+static char *xstrdup(const char *s) {
+  if (0 /* nullptr */ == s)
+    return const_cast<char *>(s);
+  char *str = strdup(s);
+  if (0 /* nullptr */ == str)
+    fatal("unable to copy string: %1", strerror(errno));
+  return str;
+}
+
+static void xputenv(const char *s) {
+  if (putenv(const_cast<char *>(s)) != 0)
+    fatal("unable to write to environment: %1", strerror(errno));
+  return;
+}
+
+static void xexit(int status) {
+  free(spooler);
+  free(predriver);
+  free(postdriver);
+  free(saved_path);
+  free(groff_bin_path);
+  free(groff_font_path);
+  exit(status);
+}
 
 int main(int argc, char **argv)
 {
@@ -140,7 +168,8 @@
   };
   while ((opt = getopt_long(
 		  argc, argv,
-		  "abcCd:D:eEf:F:gGhiI:jJkK:lL:m:M:n:No:pP:r:RsStT:UvVw:W:XzZ",
+		  "abcCd:D:eEf:F:gGhiI:jJkK:lL:m:M:"
+		  "n:No:pP:r:RsStT:UvVw:W:XzZ",
 		  long_options, NULL))
 	 != EOF) {
     char buf3;
@@ -152,6 +181,8 @@
       iflag = 1;
       break;
     case 'I':
+      commandsGRN_INDEX.set_name(command_prefix, "grn");
+      commandsGRN_INDEX.append_arg("-M", optarg);
       commandsSOELIM_INDEX.set_name(command_prefix, "soelim");
       commandsSOELIM_INDEX.append_arg(buf, optarg);
       // .psbb may need to search for files
@@ -176,7 +207,7 @@
       commandsTBL_INDEX.set_name(command_prefix, "tbl");
       break;
     case 'J':
-      commandsIDEAL_INDEX.set_name(command_prefix, "gideal");
+      // commandsIDEAL_INDEX.set_name(command_prefix, "gideal");
       // need_pic = 1;
       break;
     case 'j':
@@ -209,6 +240,7 @@
       // fall through
     case 'Z':
       zflag++;
+      need_postdriver = false;
       break;
     case 'l':
       lflag++;
@@ -220,7 +252,7 @@
       vflag = 1;
       printf("GNU groff version %s\n", Version_string);
       printf(
-	"Copyright (C) 2018 Free Software Foundation, Inc.\n"
+	"Copyright (C) 2022 Free Software Foundation, Inc.\n"
 	"GNU groff comes with ABSOLUTELY NO WARRANTY.\n"
 	"You may redistribute copies of groff and its subprograms\n"
 	"under the terms of the GNU General Public License.\n"
@@ -228,6 +260,10 @@
 	"named COPYING.\n");
       printf("\ncalled subprograms:\n\n");
       fflush(stdout);
+      // Pass -v to all possible subprograms
+      commandsPRECONV_INDEX.append_arg(buf);
+      commandsCHEM_INDEX.append_arg(buf);
+      commandsIDEAL_INDEX.append_arg(buf);
       commandsPOST_INDEX.append_arg(buf);
       // fall through
     case 'C':
@@ -244,7 +280,7 @@
       commandsEQN_INDEX.append_arg(buf);
       break;
     case 'h':
-      help();
+      usage(stdout);
       break;
     case 'E':
     case 'b':
@@ -318,13 +354,14 @@
       break;
     case 'X':
       Xflag++;
+      need_postdriver = false;
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      xexit(EXIT_FAILURE);
       break;
     default:
-      assert(0);
+      assert(0 == "no case to handle option character");
       break;
     }
   }
@@ -340,10 +377,13 @@
     commandsPIC_INDEX.append_arg("-U");
   }
   font::set_unknown_desc_command_handler(handle_unknown_desc_command);
-  if (!font::load_desc())
-    fatal("invalid device '%1'", device);
-  if (!postdriver)
-    fatal("no 'postpro' command in DESC file for device '%1'", device);
+  const char *desc = font::load_desc();
+  if (0 /* nullptr */ == desc)
+    fatal("cannot load 'DESC' description file for device '%1'",
+	  device);
+  if (need_postdriver && (0 /* nullptr */ == postdriver))
+    fatal_with_file_and_line(desc, 0, "device description file missing"
+			     " 'postpro' directive");
   if (predriver && !zflag) {
     commandsTROFF_INDEX.insert_arg(commandsTROFF_INDEX.get_name());
     commandsTROFF_INDEX.set_name(predriver);
@@ -354,10 +394,10 @@
     if (vflag)
       commandsTROFF_INDEX.insert_arg("-v");
   }
-  const char *real_driver = 0;
+  const char *real_driver = 0 /* nullptr */;
   if (Xflag) {
     real_driver = postdriver;
-    postdriver = (char *)GXDITVIEW;
+    postdriver = xstrdup(GXDITVIEW); // so we can free() it in xexit()
     commandsTROFF_INDEX.append_arg("-r" XREG "=", "1");
   }
   if (postdriver)
@@ -405,8 +445,8 @@
     commandsSPOOL_INDEX.append_arg(Largs.contents());
   }
   if (zflag) {
-    commandsPOST_INDEX.set_name(0);
-    commandsSPOOL_INDEX.set_name(0);
+    commandsPOST_INDEX.set_name(0 /* nullptr */);
+    commandsSPOOL_INDEX.set_name(0 /* nullptr */);
   }
   commandsTROFF_INDEX.append_arg("-T", device);
   if (strcmp(device, "html") == 0) {
@@ -432,7 +472,7 @@
 
   int first_index;
   for (first_index = 0; first_index < TROFF_INDEX; first_index++)
-    if (commandsfirst_index.get_name() != 0)
+    if (commandsfirst_index.get_name() != 0 /* nullptr */)
       break;
   if (optind < argc) {
     if (argvoptind0 == '-' && argvoptind1 != '\0')
@@ -452,20 +492,20 @@
       e += fontpath;
     }
     e += '\0';
-    if (putenv(strsave(e.contents())))
-      fatal("putenv failed");
+    groff_font_path = xstrdup(e.contents());
+    xputenv(groff_font_path);
   }
   {
     // we save the original path in GROFF_PATH__ and put it into the
     // environment -- troff will pick it up later.
     char *path = getenv("PATH");
-    string e = "GROFF_PATH__";
-    e += '=';
+    string g = "GROFF_PATH__";
+    g += '=';
     if (path && *path)
-      e += path;
-    e += '\0';
-    if (putenv(strsave(e.contents())))
-      fatal("putenv failed");
+      g += path;
+    g += '\0';
+    saved_path = xstrdup(g.contents());
+    xputenv(saved_path);
     char *binpath = getenv("GROFF_BIN_PATH");
     string f = "PATH";
     f += '=';
@@ -480,22 +520,22 @@
       f += path;
     }
     f += '\0';
-    if (putenv(strsave(f.contents())))
-      fatal("putenv failed");
+    groff_bin_path = xstrdup(f.contents());
+    xputenv(groff_bin_path);
   }
   if (Vflag)
     print_commands(Vflag == 1 ? stdout : stderr);
   if (Vflag == 1)
-    exit(0);
-  return run_commands(vflag);
+    xexit(EXIT_SUCCESS);
+  xexit(run_commands(vflag));
 }
 
 const char *xbasename(const char *s)
 {
   if (!s)
-    return 0;
-  // DIR_SEPS are possible directory separator characters, see nonposix.h
-  // We want the rightmost separator of all possible ones.
+    return 0 /* nullptr */;
+  // DIR_SEPS are possible directory separator characters; see
+  // nonposix.h.  We want the rightmost separator of all possible ones.
   // Example: d:/foo\\bar.
   const char *p = strrchr(s, DIR_SEPS0), *p1;
   const char *sep = &DIR_SEPS1;
@@ -514,41 +554,42 @@
 				 const char *filename, int lineno)
 {
   if (strcmp(command, "print") == 0) {
-    if (arg == 0)
-      error_with_file_and_line(filename, lineno,
-			       "'print' command requires an argument");
+    if (arg == 0 /* nullptr */)
+      error_with_file_and_line(filename, lineno, "'print' directive"
+			       " requires an argument");
     else
-      spooler = strsave(arg);
+      spooler = xstrdup(arg);
+    return;
   }
   if (strcmp(command, "prepro") == 0) {
-    if (arg == 0)
-      error_with_file_and_line(filename, lineno,
-			       "'prepro' command requires an argument");
+    if (arg == 0 /* nullptr */)
+      error("'prepro' directive requires an argument");
     else {
       for (const char *p = arg; *p; p++)
 	if (csspace(*p)) {
-	  error_with_file_and_line(filename, lineno,
-				   "invalid 'prepro' argument '%1'"
-				   ": program name required", arg);
-	  return;
+	  error_with_file_and_line(filename, lineno, "invalid 'prepro'"
+				   " directive argument '%1': program"
+				   " name required", arg);
 	}
-      predriver = strsave(arg);
+      predriver = xstrdup(arg);
     }
+    return;
   }
   if (strcmp(command, "postpro") == 0) {
-    if (arg == 0)
-      error_with_file_and_line(filename, lineno,
-			       "'postpro' command requires an argument");
+    if (arg == 0 /* nullptr */)
+      error_with_file_and_line(filename, lineno, "'postpro' directive"
+			       " requires an argument");
     else {
       for (const char *p = arg; *p; p++)
 	if (csspace(*p)) {
-	  error_with_file_and_line(filename, lineno,
-				   "invalid 'postpro' argument '%1'"
-				   ": program name required", arg);
+	  error_with_file_and_line(filename, lineno, "invalid 'postpro'"
+				   " directive argument '%1': program"
+				   " name required", arg);
 	  return;
 	}
-      postdriver = strsave(arg);
+      postdriver = xstrdup(arg);
     }
+    return;
   }
 }
 
@@ -556,10 +597,10 @@
 {
   int last;
   for (last = SPOOL_INDEX; last >= 0; last--)
-    if (commandslast.get_name() != 0)
+    if (commandslast.get_name() != 0 /* nullptr */)
       break;
   for (int i = 0; i <= last; i++)
-    if (commandsi.get_name() != 0)
+    if (commandsi.get_name() != 0 /* nullptr */)
       commandsi.print(i == last, fp);
 }
 
@@ -567,12 +608,12 @@
 
 int run_commands(int no_pipe)
 {
-  char **vNCOMMANDS;
-  int j = 0;
+  char **vNCOMMANDS; // vector of argv arrays to pipe together
+  int ncommands = 0;
   for (int i = 0; i < NCOMMANDS; i++)
-    if (commandsi.get_name() != 0)
-      vj++ = commandsi.get_argv();
-  return run_pipeline(j, v, no_pipe);
+    if (commandsi.get_name() != 0 /* nullptr */)
+      vncommands++ = commandsi.get_argv();
+  return run_pipeline(ncommands, v, no_pipe);
 }
 
 possible_command::possible_command()
@@ -583,19 +624,19 @@
 possible_command::~possible_command()
 {
   free(name);
-  a_delete argv;
+  delete argv;
 }
 
 void possible_command::set_name(const char *s)
 {
   free(name);
-  name = strsave(s);
+  name = xstrdup(s);
 }
 
 void possible_command::clear_name()
 {
-  a_delete name;
-  a_delete argv;
+  delete name;
+  delete argv;
   name = NULL;
   argv = NULL;
 }
@@ -662,7 +703,7 @@
   // Count the number of arguments.
   int len = args.length();
   int argc = 1;
-  char *p = 0;
+  char *p = 0 /* nullptr */;
   if (len > 0) {
     p = &args0;
     for (int i = 0; i < len; i++)
@@ -676,20 +717,21 @@
     argvi = p;
     p = strchr(p, '\0') + 1;
   }
-  argvargc = 0;
+  argvargc = 0 /* nullptr */;
 }
 
 void possible_command::print(int is_last, FILE *fp)
 {
   build_argv();
   if (IS_BSHELL(argv0)
-      && argv1 != 0 && strcmp(argv1, BSHELL_DASH_C) == 0
-      && argv2 != 0 && argv3 == 0)
+      && argv1 != 0 /* nullptr */
+      && strcmp(argv1, BSHELL_DASH_C) == 0
+      && argv2 != 0 /* nullptr */ && argv3 == 0 /* nullptr */)
     fputs(argv2, fp);
   else {
     fputs(argv0, fp);
     string str;
-    for (int i = 1; argvi != 0; i++) {
+    for (int i = 1; argvi != 0 /* nullptr */; i++) {
       str.clear();
       append_arg_to_string(argvi, str);
       put_string(str, fp);
@@ -774,70 +816,31 @@
   return argv;
 }
 
-void synopsis(FILE *stream)
-{
-  fprintf(stream,
-"usage: %s -abceghijklpstvzCEGNRSUVXZ -dcs -ffam -mname -nnum\n"
-"       -olist -rcn -wname -Darg -Fdir -Idir -Karg -Larg\n"
-"       -Mdir -Parg -Tdev -Wname files...\n",
-	  program_name);
-}
-
-void help()
-{
-  synopsis(stdout);
-  fputs("\n"
-"-h\tprint this message\n"
-"-v\tprint version number\n"
-"-e\tpreprocess with eqn\n"
-"-g\tpreprocess with grn\n"
-"-j\tpreprocess with chem\n"
-"-k\tpreprocess with preconv\n"
-"-p\tpreprocess with pic\n"
-"-s\tpreprocess with soelim\n"
-"-t\tpreprocess with tbl\n"
-"-G\tpreprocess with grap\n"
-"-J\tpreprocess with gideal\n"
-"-R\tpreprocess with refer\n"
-"-a\tproduce ASCII description of output\n"
-"-b\tprint backtraces with errors or warnings\n"
-"-c\tdisable color output\n"
-"-dcs\tdefine a string c as s\n"
-"-ffam\tuse fam as the default font family\n"
-"-i\tread standard input after named input files\n"
-"-l\tspool the output\n"
-"-mname\tread macros tmac.name\n"
-"-nnum\tnumber first page n\n"
-"-olist\toutput only pages in list\n"
-"-rcn\tdefine a number register c as n\n"
-"-wname\tenable warning name\n"
-"-z\tsuppress formatted output\n"
-"-C\tenable compatibility mode\n"
-"-Darg\tuse arg as default input encoding.  Implies -k\n"
-"-E\tinhibit all errors\n"
-"-Fdir\tsearch dir for device directories\n"
-"-Idir\tsearch dir for soelim, troff, and grops.  Implies -s\n"
-"-Karg\tuse arg as input encoding.  Implies -k\n"
-"-Larg\tpass arg to the spooler\n"
-"-Mdir\tsearch dir for macro files\n"
-"-N\tdon't allow newlines within eqn delimiters\n"
-"-Parg\tpass arg to the postprocessor\n"
-"-S\tenable safer mode (the default)\n"
-"-Tdev\tuse device dev\n"
-"-U\tenable unsafe mode\n"
-"-V\tprint commands on stdout instead of running them\n"
-"-Wname\tinhibit warning name\n"
-"-X\tuse X11 previewer rather than usual postprocessor\n"
-"-Z\tdon't postprocess\n"
-"\n",
-	stdout);
-  exit(0);
-}
-
 void usage(FILE *stream)
 {
-  synopsis(stream);
-  fprintf(stream, "%s -h gives more help\n", program_name);
+  // Add `J` to the cluster if we ever get ideal(1) support.
+  fprintf(stream,
+"usage: %s -abcCeEgGijklNpRsStUVXzZ -d ctext -d string=text"
+" -D fallback-encoding -f font-family -F font-directory"
+" -I inclusion-directory -K input-encoding -L spooler-argument"
+" -m macro-package -M macro-directory -n page-number"
+" -o page-list -P postprocessor-argument -r cnumeric-expression"
+" -r register=numeric-expression -T output-device"
+" -w warning-category -W warning-category"
+" file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n",
+	  program_name, program_name, program_name);
+  if (stdout == stream) {
+    fputs(
+"\n"
+"groff (GNU roff) is a typesetting system that reads plain text input\n"
+"files that include formatting commands to produce output in\n"
+"PostScript, PDF, HTML, or DVI formats or for display to a terminal.\n"
+"See the groff(1) manual page.\n",
+	  stream);
+    exit(EXIT_SUCCESS);
+  }
 }
 
 extern "C" {
@@ -855,3 +858,9 @@
 }
 
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/groff/pipeline.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/pipeline.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -75,8 +75,6 @@
 
 #include "pipeline.h"
 
-#define error c_error
-
 /* Prototype */
 int run_pipeline(int, char ***, int);
 
@@ -84,8 +82,10 @@
 extern "C" {
 #endif
 
-extern void error(const char *, const char *, const char *, const char *);
-extern void c_fatal(const char *, const char *, const char *, const char *);
+extern void c_error(const char *, const char *, const char *,
+		    const char *);
+extern void c_fatal(const char *, const char *, const char *,
+		    const char *);
 extern const char *i_to_a(int);		/* from libgroff */
 
 #ifdef __cplusplus
@@ -305,9 +305,8 @@
       }
     }
     if ((pid = spawnvp(_P_NOWAIT, commandsi0, commandsi)) < 0) {
-      error("couldn't exec %1: %2",
-	    commandsi0, strerror(errno), (char *)0);
-      fflush(stderr);			/* just in case error() doesn't */
+      c_error("couldn't exec %1: %2",
+	      commandsi0, strerror(errno), (char *)0);
       _exit(EXEC_FAILED_EXIT_STATUS);
     }
     pidsi = pid;
@@ -343,9 +342,9 @@
 
 #else  /* not _WIN32 */
 
-/* MSDOS doesn't have 'fork', so we need to simulate the pipe by running
-   the programs in sequence with standard streams redirected to and
-   from temporary files.
+/* MS-DOS doesn't have 'fork', so we need to simulate the pipe by
+   running the programs in sequence with standard streams redirected to
+   and from temporary files.
 */
 
 
@@ -415,13 +414,12 @@
     exit_status = spawnvp(P_WAIT, commandsi0, commandsi);
     signal(SIGINT, prev_handler);
     if (child_interrupted) {
-      error("%1: Interrupted", commandsi0, (char *)0, (char *)0);
+      c_error("%1: Interrupted", commandsi0, (char *)0, (char *)0);
       ret |= 2;
     }
     else if (exit_status < 0) {
-      error("couldn't exec %1: %2",
-	    commandsi0, strerror(errno), (char *)0);
-      fflush(stderr);			/* just in case error() doesn't */
+      c_error("couldn't exec %1: %2",
+	      commandsi0, strerror(errno), (char *)0);
       ret |= 4;
     }
     if (exit_status != 0)
@@ -485,9 +483,8 @@
 	  sys_fatal("close");
       }
       execvp(commandsi0, commandsi);
-      error("couldn't exec %1: %2",
-	    commandsi0, strerror(errno), (char *)0);
-      fflush(stderr);			/* just in case error() doesn't */
+      c_error("couldn't exec %1: %2",
+	      commandsi0, strerror(errno), (char *)0);
       _exit(EXEC_FAILED_EXIT_STATUS);
     }
     /* in the parent */
@@ -535,10 +532,10 @@
 	  else
 #endif /* SIGPIPE */
 	  {
-	    error("%1: %2%3",
-		  commandsi0,
-		  xstrsignal(sig),
-		  WCOREDUMP(status) ? " (core dumped)" : "");
+	    c_error("%1: %2%3",
+		    commandsi0,
+		    xstrsignal(sig),
+		    WCOREDUMP(status) ? " (core dumped)" : "");
 	    ret |= 2;
 	  }
 	}
@@ -551,7 +548,8 @@
 	    ret |= 1;
 	}
 	else
-	  error("unexpected status %1",	i_to_a(status), (char *)0, (char *)0);
+	  c_error("unexpected status %1", i_to_a(status), (char *)0,
+		  (char *)0);
 	break;
       }
   }
@@ -570,11 +568,22 @@
   static char bufsizeof("Signal ") + 1 + sizeof(int) * 3;
 
 #ifdef NSIG
+#if HAVE_DECL_STRSIGNAL
+  if (n >= 0 && n < NSIG && strsignal(n) != 0)
+    return strsignal(n);
+#else
 #if HAVE_DECL_SYS_SIGLIST
   if (n >= 0 && n < NSIG && sys_siglistn != 0)
     return sys_siglistn;
 #endif /* HAVE_DECL_SYS_SIGLIST */
+#endif /* HAVE_DECL_STRSIGNAL */
 #endif /* NSIG */
   sprintf(buf, "Signal %d", n);
   return buf;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/groff/pipeline.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/pipeline.h Changed

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/ab_works.sh Added

@@ -0,0 +1,46 @@
+#!/bin/sh
+#
+# Copyright (C) 2021-2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Verify exit status and regression-test Savannah #60782.
+#
+# We don't test the X11 devices because groff launches an X client,
+# which has to be killed.  Using "-z" to avoid this masks the bug.
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+for d in ascii cp1047 dvi html latin1 lbp lj4 pdf ps utf8
+do
+  echo "verifying exit status of .ab request using $d device" >&2
+  printf '.ab\n' | "$groff" -Z -T$d
+  test $? -eq 1 || exit 1
+done
+
+echo "verifying empty output of .ab request with no arguments" >&2
+OUT=$(printf '.ab\n' | "$groff" -Z -Tascii 2>&1)
+test "$OUT" = "" || exit 1
+
+echo "verifying that arguments to .ab request go to stderr" >&2
+OUT=$(printf '.ab foo\n' | "$groff" -Z -Tascii 2>&1 > /dev/null)
+test "$OUT" = "foo" || exit 1
+
+# vim:set autoindent expandtab shiftwidth=2 tabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/adjustment_works.sh Added

@@ -0,0 +1,92 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+DOC='.pl 1v
+.ll 9n
+foo bar\p
+.na
+foo bar\p
+.ad l
+foo bar\p
+.na
+foo bar\p
+.ad b
+foo bar\p
+.na
+foo bar\p
+.ad c
+foo bar\p
+.na
+foo bar\p
+.ad r
+foo bar\p
+.na
+foo bar\p
+.ad
+foo bar\p
+.ad b
+.ad 100
+foo bar\p'
+
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii)
+B='foo   bar' # 3 spaces
+L='foo bar' # left or off
+C=' foo bar' # trailing space truncated
+R='  foo bar' # 2 leading spaces
+
+echo "verifying default adjustment mode 'b'" >&2
+echo "$OUTPUT" | sed -n '1p' | grep -Fqx "$B"
+
+echo "verifying that .na works" >&2
+echo "$OUTPUT" | sed -n '2p' | grep -Fqx "$L"
+
+echo "verifying adjustment mode 'l'" >&2
+echo "$OUTPUT" | sed -n '3p' | grep -Fqx "$L"
+
+echo "verifying that .na works after '.ad l'" >&2
+echo "$OUTPUT" | sed -n '4p' | grep -Fqx "$L"
+
+echo "verifying adjustment mode 'b'" >&2
+echo "$OUTPUT" | sed -n '5p' | grep -Fqx "$B"
+
+echo "verifying that .na works after '.ad b'" >&2
+echo "$OUTPUT" | sed -n '6p' | grep -Fqx "$L"
+
+echo "verifying adjustment mode 'c'" >&2
+echo "$OUTPUT" | sed -n '7p' | grep -Fqx "$C"
+
+echo "verifying that .na works after '.ad c'" >&2
+echo "$OUTPUT" | sed -n '8p' | grep -Fqx "$L"
+
+echo "verifying adjustment mode 'r'" >&2
+echo "$OUTPUT" | sed -n '9p' | grep -Fqx "$R"
+
+echo "verifying that .na works after '.ad r'" >&2
+echo "$OUTPUT" | sed -n '10p' | grep -Fqx "$L"
+
+echo "verifying that '.ad' restores previous adjustment mode" >&2
+echo "$OUTPUT" | sed -n '11p' | grep -Fqx "$R"
+
+echo "verifying that out-of-range adjustment mode 100 is ignored" >&2
+echo "$OUTPUT" | sed -n '12p' | grep -Fqx "$B"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/artifacts Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/artifacts/HONEYPOT Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/artifacts/devascii Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/artifacts/devascii/README Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/break_zero-length_output_line_sanely.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Do not core dump when attempting to distribute a space amount of zero
+# if someone sets the line length to zero.  See Savannah #61089.
+# Reproducer courtesy of John Gardner.
+
+INPUT='.de _
+.	na
+.	nh
+.	ll 0
+.	di A
+\&\\$1
+.	di
+.	br
+..
+._ " XYZ"
+.A
+'
+
+OUTPUT=$(printf "%s" "$INPUT" | "$groff" -Tascii)
+echo "$OUTPUT" | grep -qx XYZ

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/device_control_escapes_express_basic_latin.sh Added

@@ -0,0 +1,60 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+fail=
+
+# Confirm translation of a groff special character escape sequence to a
+# basic Latin character when used in a device control escape sequence.
+#
+# $1 is the special character escape _without_ the leading backslash.
+# $2 is the expected output character _shell-quoted as necessary_.
+# $3 is a human-readable glyph description for the test log.
+# $4 is the groff -T device name under test.
+check_char () {
+  sc=$1
+  output=$2
+  description=$3
+  device=$4
+  printf 'checking conversion of \\%s to %s (%s) on device %s' \
+    "$sc" "$output" "$description" "$device" >&2
+  if ! printf '\\X#\\%s %s#\n' "$sc" "$desc" | "$groff" -T$device -Z \
+    | grep -Fqx 'x X '$output' '
+  then
+    printf '...FAILED' >&2
+    fail=yes
+  fi
+  printf '\n' >&2
+}
+
+for device in utf8 html
+do
+  check_char - - "minus sign" $device
+  check_char 'aq' "'" "neutral apostrophe" $device
+  check_char 'dq' '"' "double quote" $device
+  check_char 'ga' '`' "grave accent" $device
+  check_char 'ha' ^ "caret/hat" $device
+  check_char 'rs' '\' "reverse solidus/backslash" $device
+  check_char 'ti' '~' "tilde" $device
+done
+
+test -z "$fail" || exit 1
+
+# vim:set autoindent expandtab shiftwidth=2 tabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/do_not_loop_infinitely_when_breaking_cjk.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/dot-cp_register_works.sh Added

@@ -0,0 +1,48 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOC='.pl 1v
+A
+.do if 1 \n.cp \" Get initial compatibility state (depends on -C).
+B
+.do if 1 \n.cp \" Did observing the state change it?
+.cp 1
+C
+.do if 1 \n.cp \" Saved compatibility state should be 1 now.
+.cp 0
+D
+.do if 1 \n.cp \" Verify 1->0 transition.
+.cp 1
+E
+.do if 1 \n.cp \" Verify 0->1 transition.
+.cp 0
+F
+.if !\n.C \n.cp \" Outside of .do context, should return -1.
+'
+
+set -e
+
+printf "%s" "$DOC" | "$groff" -Tascii \
+    | grep -x "A 0 B 0 C 1 D 0 E 1 F -1"
+
+printf "%s" "$DOC" | "$groff" -C -Tascii \
+    | grep -x "A 1 B 1 C 1 D 0 E 1 F -1"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/dot-nm_register_works.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOC='\
+.nf
+foo (\n.nm)
+.nm 1
+bar (\n.nm)
+.nn
+baz (\n.nm)
+.nm
+qux (\n.nm)
+.fi
+'
+
+set -e
+
+printf '%s' "$DOC" | "$groff" -T utf8 | grep -Fqx 'foo (0)'
+printf '%s' "$DOC" | "$groff" -T utf8 | grep -Fqx '  1 bar (1)'
+printf '%s' "$DOC" | "$groff" -T utf8 | grep -Fqx 'baz (1)'
+printf '%s' "$DOC" | "$groff" -T utf8 | grep -Fqx 'qux (0)'

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/dot-nn_register_works.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/evc_produces_no_output_if_invalid.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/fp_should_not_traverse_directories.sh Added

@@ -0,0 +1,63 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #61424.
+#
+# The `fp` request should not be able to access font description files
+# outside of the device and font description search path (configurable
+# with the -F option and GROFF_FONT_PATH environment variable).
+#
+# An absolute file name _won't_ work: it gets dev\*.T/ stuck on the
+# front of it by libgroff.
+#
+# Locate directory containing our test artifacts.
+artifact_dir=
+base=src/roff/groff/tests
+device=artifacts
+
+for buildroot in . .. ../..
+do
+    d=$buildroot/$base/$device
+    if  -d "$d" 
+    then
+        artifact_dir=$d
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+test -z "$artifact_dir" && exit 77 # skip
+
+input='.fp 5 ../HONEYPOT
+.ft 5
+word
+.fp 5 HONEYPOT ../HONEYPOT
+.ft HONEYPOT
+.br
+my word is able
+.pl \nnlu'
+
+output=$(printf "%s" "$input" | "$groff" -b -ww -F "$artifact_dir" \
+    -Tascii)
+echo "$output" | grep -Fx word
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/handle_special_input_code_points.sh Added

@@ -0,0 +1,47 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #58962.
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+input='.if " "\~" .tm input no-break space matches \\~
+.if ""\%" .tm input soft hyphen matches \\%'
+
+fail=
+
+wail () {
+   echo "...FAILED"
+   fail=yes
+}
+
+output=$(printf "%s\n" "$input" | "$groff" -Z 2>&1)
+echo "$output"
+
+printf "checking that input no-break space is mapped to \\~\n"
+echo "$output" | grep -qx 'input no-break space matches \\~' || wail
+
+printf "checking that input soft hyphen is mapped to \\%%\n"
+echo "$output" | grep -qx 'input soft hyphen matches \\%' || wail
+
+test -z "$fail"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/html_works_with_grn_and_eqn.sh Added

@@ -0,0 +1,46 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Keep this list of programs in sync with GROFF_CHECK_GROHTML_PROGRAMS
+# in m4/groff.m4.
+for cmd in pnmcrop pnmcut pnmtopng pnmtops psselect
+do
+    if ! command -v $cmd >/dev/null
+    then
+        echo "cannot locate '$cmd' command; skipping test" >&2
+        exit 77 # skip
+    fi
+done
+
+# Commit c71b4ef4aa provoked an infinite loop in post-grohtml with these
+# preprocessors.
+
+input='.EQ
+gsize 12
+delim $$
+.EN
+.pp
+.pp
+The faster clocks are $ PN $'
+
+output=$("$groff" -b -ww -Thtml -eg -me "$input")
+test -n "$output"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/initialization_is_quiet.sh Added

@@ -0,0 +1,59 @@
+#!/bin/sh
+#
+# Copyright (C) 2021-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+# Regression-test Savannah #60874.
+#
+# groff should start up in any supported locale, in compatibility mode
+# or not, without producing diagnostics.
+
+# Keep preconv from being run.
+#
+# The "unset" in Solaris /usr/xpg4/bin/sh can actually fail.
+if ! unset GROFF_ENCODING
+then
+    echo "unable to clear environment; skipping" >&2
+    exit 77
+fi
+
+for compat in "" " -C"
+do
+  for locale in cs de en fr it ja sv zh
+  do
+    echo testing \"-m $locale$compat\" >&2
+    output=$("$groff" -ww -m $locale$compat -a </dev/null 2>/dev/null)
+    error=$("$groff" -ww -m $locale$compat -z </dev/null 2>&1)
+    test -n "$error" && echo "$error"
+    test -n "$output" && echo "$output"
+    test -n "$error$output" && wail
+  done
+done
+
+test -z "$fail"
+
+# vim:set autoindent expandtab shiftwidth=4 tabstop=4 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/localization_works.sh Added

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+DOC='\*locale'
+
+echo "testing default localization (English)" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii)
+echo "$OUTPUT" | grep -qx english
+
+echo "testing Czech localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m cs)
+echo "$OUTPUT" | grep -qx czech
+
+echo "testing German localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m de)
+echo "$OUTPUT" | grep -qx german
+
+echo "testing English localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m en)
+echo "$OUTPUT" | grep -qx english
+
+echo "testing French localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m fr)
+echo "$OUTPUT" | grep -qx french
+
+echo "testing Italian localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m it)
+echo "$OUTPUT" | grep -qx italian
+
+echo "testing Japanese localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m ja)
+echo "$OUTPUT" | grep -qx japanese
+
+echo "testing Swedish localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m sv)
+echo "$OUTPUT" | grep -qx swedish
+
+echo "testing Chinese localization" >&2
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii -m zh)
+echo "$OUTPUT" | grep -qx chinese

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/msoquiet_works.sh Added

@@ -0,0 +1,35 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+DOC='.msoquiet nonexistent'
+
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii 2>&1)
+echo "$OUTPUT"
+
+echo "testing that .msoquiet of nonexistent file produces no warning" \
+  >&2
+test -z "$OUTPUT"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/on_latin1_device_oq_is_0x27.sh Added

@@ -0,0 +1,30 @@
+#!/bin/sh
+#
+# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# This test fails with some versions of GNU Bash, such as 3.2; the here
+# document nested within a command substitution confuses it.
+#
+# https://lists.gnu.org/archive/html/bug-bash/2017-02/msg00024.html
+
+expected="' = '"
+actual=$(printf '.pl 1v\n\\oq = '"'"'\n' | "$groff" -Tlatin1)
+test "$actual" = "$expected"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/output_driver_C_and_G_options_work.sh Added

@@ -0,0 +1,50 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Feed groff empty input documents and verify that expected comments
+# emerge from the output drivers.
+
+# Expect Creator: and CreationDate: comments.
+echo "testing presence of Creator: comment in HTML output" >&2
+echo | "$groff" -Thtml | grep -Fq '<!-- Creator:'
+
+echo "testing presence of CreationDate: comment in HTML output" >&2
+echo | "$groff" -Thtml | grep -Fq '<!-- CreationDate:'
+
+# Make sure the options are recognized so we can distinguish a match
+# failure.  We can't use -Z or -z because they keep the output driver
+# from running at all.
+for OPT in -C -G
+do
+    if ! echo | "$groff" -Thtml -P$OPT > /dev/null
+    then
+        echo "option $OPT not recognized!" >&2
+        exit 2
+    fi
+done
+
+# Now shut them off.
+echo "testing absence of Creator: comment in HTML output" >&2
+! echo | "$groff" -Thtml -P-G | grep -Fq '<!-- Creator:'
+
+echo "testing absence of CreationDate: comment in HTML output" >&2
+! echo | "$groff" -Thtml -P-C | grep -Fq '<!-- CreationDate:'

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/recognize_end_of_sentence.sh Added

@@ -0,0 +1,33 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Verify that the characters trailing the period are all transparent for
+# purposes of end-of-sentence recognition.  We use UTF-8 so we won't get
+# warnings about \dg and \dd missing from other encodings.
+#
+# Also confirm that we get _two_ spaces after the end of a sentence.
+
+"$groff" -Tutf8 <<EOF | grep -qE 'Eat\.^ +  Drink\.'
+.pl 1v
+Eat."')*\dg\dd\rq\cq
+Drink.
+EOF

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/regression_savannah_56555.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/regression_savannah_58153.sh Added

@@ -0,0 +1,34 @@
+#!/bin/sh
+#
+# Copyright (C) 2020-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure that we get backtrace output across file and pipe boundaries.
+# Savannah #58153.
+OUT=$("$groff" -b -ww -U 2>&1 >/dev/null <<EOF
+.ec @
+.pso printf '@s-20'
+EOF
+)
+
+set -e
+
+printf "%s\n" "$OUT" | grep -qw 'backtrace: pipe'
+printf "%s\n" "$OUT" | grep -qw 'backtrace: file'

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/regression_savannah_58162.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/regression_savannah_58337.sh Added

@@ -0,0 +1,32 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# groff should ignore negative inter-word and inter-sentence space
+# sizes.  And certainly not fail an assertion.  Savannah #58337.
+"$groff" -Tascii <<EOF | grep -Fqx 'A B.  C.'
+.pl 1v
+.ss -1 -1
+A B.
+C.
+EOF

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/regression_savannah_59202.sh Added

@@ -0,0 +1,29 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# troff should not segfault when its standard output is closed.
+# Savannah #59202.
+
+# If a core file already exists, it should be dealt with; skip test.
+test -e core && exit 77
+echo | "$groff" >&-
+! test -e core

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/smoke-test_html_device.sh Added

@@ -0,0 +1,90 @@
+#!/bin/sh
+#
+# Copyright (C) 2020, 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Keep this list of programs in sync with GROFF_CHECK_GROHTML_PROGRAMS
+# in m4/groff.m4.
+for cmd in pnmcrop pnmcut pnmtopng pnmtops psselect
+do
+    if ! command -v $cmd >/dev/null
+    then
+        echo "cannot locate '$cmd' command; skipping test" >&2
+        exit 77 # skip
+    fi
+done
+
+fail=
+
+wail () {
+  echo ...FAILED >&2
+  fail=yes
+}
+
+cleanup () {
+  rm -f grohtml-0-9*-12.png
+  trap - HUP INT QUIT TERM
+}
+
+trap 'trap "" HUP INT QUIT TERM; cleanup; kill -s INT $$' \
+  HUP INT QUIT TERM
+
+input='.TS
+L.
+foobar
+.TE'
+
+# Inline images are named grohtml-$$-<image sequence number>.png.
+
+echo "checking production of inline image for tbl(1) table" >&2
+output=$(echo "$input" | "$groff" -t -Thtml)
+echo "$output" | grep -q '<img src="grohtml-0-9\+-1.png"' || wail
+
+input='.EQ
+x sup 2 + y sup 2 = z sup 2
+.EN'
+
+echo "checking production of inline image for eqn(1) equation" >&2
+output=$(echo "$input" | "$groff" -e -Thtml)
+echo "$output" | grep -q '<img src="grohtml-0-9\+-2.png"' || wail
+
+cleanup
+
+# We can't run remaining tests if the environment doesn't support UTF-8.
+test "$(locale charmap)" = UTF-8 || exit 77 # skip
+
+# Check two forms of character transformation.
+#
+# dash's built-in printf doesn't support \x or \u escapes, so likely
+# other shells don't either, and expecting one that does to be in the
+# $PATH seems optimistic.  So use UTF-8 octal bytes directly.
+echo "checking -k -Thtml" >&2
+printf '\303\241' | "$groff" -k -Thtml | grep -qx '<p>&aacute;</p>' \
+  || wail
+
+# We test compatibility-mode HTML output somewhat differently since
+# preconv only emits groffish \uXXXX escapes for non-ASCII codepoints.
+echo "checking -C -k -Thtml" >&2
+printf "\('a" | "$groff" -C -k -Thtml | grep -qx '<p>&aacute;</p>' \
+  || wail
+
+test -z "$fail"
+
+# vim:set autoindent expandtab shiftwidth=2 tabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh Added

@@ -0,0 +1,128 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+  echo "...FAILED" >&2
+  fail=yes
+}
+
+# Regression-test Savannah #63011.
+#
+# A handful of escape sequences bizarrely accept newlines as argument
+# delimiters.  Don't throw diagnostics if they are used.
+
+input="\A
+ABC
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'A' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+echo "checking correct handling of newline delimiter to 'A' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww)
+test "$output" = "1 D" || wail
+
+input=".sp
+\b
+ABC
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'b' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+echo "checking correct handling of newline delimiter to 'b' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww)
+echo "$output" | grep -Fqx "B D" || wail
+
+input="\o
+ABC
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'o' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+echo "checking correct handling of newline delimiter to 'o' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww \
+  | LC_ALL=C od -t c)
+# 7 spaces between C and D.
+printf "%s\n" "$output" \
+  | grep -Eqx '0000000 +A +\\b +B +\\b +C       D +\\n *' || wail
+
+input="\w
+ABC
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'w' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+echo "checking correct handling of newline delimiter to 'w' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww)
+test "$output" = "72 D" || wail
+
+input="\X
+tty: link http://example.com
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'X' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+echo "checking correct handling of newline delimiter to 'X' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -P -c)
+test "$output" = ' D' || wail
+
+input="\Z
+ABC
+D
+.pl \n(nlu"
+
+echo "checking that newline is accepted as delimiter to 'Z' escape" >&2
+error=$(printf "%s\n" "$input" | "$groff" -Tascii -ww -z 2>&1)
+test -z "$error" || wail
+
+# This looks really weird but is consistent.  A newline used as a
+# delimiter still gets interpreted as an input line ending.  What we see
+# here is: 'ABC' is formatted, the drawing position is reset to the
+# beginning of the line, a word space (from filling, overstriking 'A')
+# goes on the output, followed by 'D', so it appears as 'ADC'.
+#
+# `printf '\\Z@ABC@\nD\n'` produces the same output.
+echo "checking correct handling of newline delimiter to 'Z' escape" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -ww \
+  | LC_ALL=C od -t c)
+printf "%s\n" "$output" | grep -Eqx '0000000 +A +B +\\b +D +C +\\n *' \
+  || wail
+
+test -z "$fail"
+
+# vim:set autoindent expandtab shiftwidth=2 tabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/soquiet_works.sh Added

@@ -0,0 +1,34 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+DOC='.soquiet nonexistent'
+
+OUTPUT=$(echo "$DOC" | "$groff" -Tascii 2>&1)
+echo "$OUTPUT"
+
+echo "testing that .soquiet of nonexistent file produces no error" >&2
+test -z "$OUTPUT"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/string_case_xform_errors.sh Added

@@ -0,0 +1,30 @@
+#!/bin/sh
+#
+# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+expected="troff:<standard input>:1: error: cannot apply string case transformation to a request ('br')"
+
+actual=$("$groff" -Tutf8 2>&1 <<EOF
+.stringdown br
+EOF
+)
+
+echo "$actual" | grep -qx "$expected"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/string_case_xform_requests.sh Added

@@ -0,0 +1,32 @@
+#!/bin/sh
+#
+# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input=".pl 1v
+.ds resume R\\'esum\\'e\\\"
+\\*resume
+.stringdown resume
+\\*resume
+.stringup resume
+\\*resume"
+expected="Résumé résumé RÉSUMÉ"
+actual=$(echo "$input" | "$groff" -Tutf8)
+test "$actual" = "$expected"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/string_case_xform_unicode_escape.sh Added

@@ -0,0 +1,42 @@
+#!/bin/sh
+#
+# Copyright (C) 2019-2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# The following is what we expect in the future when we support Unicode
+# case transformations.
+expected="attaché ATTACHÉ"
+
+# For now, we expect problems like this:
+# troff: backtrace: '<standard input>':4: string 'attache'
+# troff: backtrace: file '<standard input>':5
+# troff: <standard input>:5: warning: can't find special character
+#     'U0065_0301'
+
+actual=$("$groff" -Tutf8 2>&1 <<EOF
+.pl 1v
+.ds attache attach\\u0065_0301\\\"
+\\*attache
+.stringup attache
+\\*attache
+EOF
+)
+
+echo "$actual" | grep -Fqx "$expected"

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/substring_works.sh Added

@@ -0,0 +1,120 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# This test is based on a contribution by Jim Avera; see
+# <https://savannah.gnu.org/bugs/?60802>.
+
+"$groff" -z -ww <<'EOF'
+.
+.nr debug 1
+.de debugmsg
+.  if \\ndebug .tm \\$*
+..
+.de errormsg
+.  tm ERROR: \\$*
+.  nr nerrors (\\nnerrors+1)
+..
+.nr nerrors 0
+.
+.\" .substring xx n1 n2
+.\"    Replace contents of string named xx with the substring bounded by
+.\"    zero-based indices indices n1 and n2.  Negative indices count
+.\"    backwards from the end of the string.  If omitted, n2 is `-1`.
+.\"
+.\"    If n1 > n2, n1 and n2 are swapped.  If n1 equals or exceeds the
+.\"    string length, it is set to `-1`.
+.\"
+.\"  NOT YET IMPLEMENTED:
+.\"    If n1 > n2, or if n1 equals or exceeds the string length, then
+.\"    any contents of xx are replaced with the empty string.
+.\"
+.de jtest \" input_string n1 n2 expected_result
+.  if \\n.$<4 .ab jtest: expected at least 4 arguments, got \\n.$
+.  ds t*input "\\$1
+.  ds t*n1 \\$2
+.  ds t*n2 \\$3
+.  ds t*expected "\\$4
+.  shift 4
+.  ds t*comment "\\$*
+.
+.  ds t*str "\\*t*input
+.  ie '\\*t*n2'' .substring t*str \\*t*n1
+.  el              .substring t*str \\*t*n1 \\*t*n2
+.  ie '\\*t*str'\\*t*expected' \{\
+.    debugmsg .substring '\\*t*input' \\*t*n1 \\*t*n2 -> \
+'\\*t*str' (OK) \\*t*comment
+.  \}
+.  el \{\
+.    errormsg .substring '\\*t*input' \\*t*n1 \\*t*n2 yielded \
+'\\*t*str', EXPECTED '\\*t*expected' \\*t*comment
+.  \}
+..
+.
+.debugmsg --- Pick a single character from non-empty ---
+.jtest "abc" 0 0 "a"
+.jtest "abc" 1 1 "b"
+.jtest "abc" 2 2 "c"
+.
+.debugmsg --- Pick multiple characters from non-empty ---
+.jtest "abcd" 0 1 "ab"
+.jtest "abcd" 1 1 "b"
+.jtest "abcd" 0 3 "abcd"
+.jtest "abcd" 0 -1 "abcd"
+.jtest "abcd" 0 "" "abcd"
+.jtest "abcd" 1 3 "bcd"
+.jtest "abcd" 2 3 "cd"
+.jtest "abcd" 3 3 "d"
+.
+.debugmsg --- Omit n2 with non-empty input and non-empty result ---
+.jtest "abc" 0 "" "abc"
+.jtest "abc" 1 "" "bc"
+.jtest "abc" 2 "" "c"
+.jtest "a"   0 "" "a"
+.
+.\"debugmsg --- Specify empty substring with n2==(n1-1) ---
+.\"jtest "abcd" 3 2 ""
+.\"jtest "abcd" 2 1 ""
+.\"jtest "abcd" 1 0 ""
+.debugmsg --- Pick multiple characters from non-empty using inverted \
+range ---
+.jtest "abcd" 3 2 "cd"
+.jtest "abcd" 2 1 "bc"
+.jtest "abcd" 1 0 "ab"
+.
+.\"debugmsg --- Specify empty substring with n1==length and n2 omitted ---
+.\"jtest "abcd" 4 "" ""
+.\"jtest "abc" 3 "" ""
+.\"jtest "ab" 2 "" ""
+.\"jtest "a" 1 "" ""
+.\"jtest "" 0 "" ""
+.debugmsg --- Pick single character using out-of-bounds start index \
+(unless string empty) ---
+.jtest "abcd" 4 "" "d"
+.jtest "abc" 3 "" "c"
+.jtest "ab" 2 "" "b"
+.jtest "a" 1 "" "a"
+.jtest "" 0 "" ""
+.jtest "" 0 -1 ""
+.jtest "" 0 -2 ""
+.
+.if \nnerrors .ab Aborting, got \nnerrors errors.
+EOF

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/groff/tests/use_point_size_escape_with_single_digit_arg.sh Added

@@ -0,0 +1,44 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+export GROFF_TYPESETTER=
+
+# The vertical space is so that the 36-point 'A' won't be truncated by
+# the top of the page.  That could be confusing and misleading to anyone
+# who ever has to troubleshoot this test case.
+DOC=".vs 10v
+\s36A"
+
+set -e
+
+# Verify that the idiosyncratic behavior of \sN is supported in
+# compatibility mode...
+echo "testing \s36A in compatibility mode (36-point 'A')" >&2
+echo "$DOC" | "$groff" -C -Z | grep -qx 's36000'
+
+# ...and not in regular mode.
+echo "testing \s36A in non-compatibility mode (3-point '6A')" >&2
+echo "$DOC" | "$groff" -Z | grep -qx 's3000'
+
+# Check that we get a diagnostic when relying on the ambiguous form.
+echo "testing for diagnostic on \s36 in compatibility mode" >&2
+echo "$DOC" | "$groff" -C -Z 2>&1 >/dev/null \
+    | grep -q 'ambiguous type size in escape sequence'

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/nroff/nroff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/nroff/nroff.1.man Changed

@@ -1,13 +1,15 @@
-.TH @G@NROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@nroff \- use groff to format documents for TTY devices
+.TH @g@nroff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@nroff \- format documents with
+.I groff
+for TTY (terminal) devices
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 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
@@ -25,76 +27,99 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_nroff_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@nroff
-.RB  \-CchipStUv 
-\c
-.BI \-d cs\c
-
-\c
-.BI \-M dir\c
-
-\c
-.BI \-m name\c
-
-\c
-.BI \-n num\c
-
-\c
-.BI \-o list\c
-
-\c
-.BI \-r cn\c
-
-\c
-.BI \-T name\c
-
-\c
-.BI \-W warning\c
-
-\c
-.BI \-w warning\c
-
-.RI  file
-\&.\|.\|.\&
+.RB  \-bcCEhikpRStUVz 
+.RB  \-d\~\c
+.IR ctext 
+.RB  \-d\~\c
+.IB string =\c
+.IR text 
+.RB  \-K\~\c
+.IR fallback-encoding 
+.RB  \-m\~\c
+.IR macro-package 
+.RB  \-M\~\c
+.IR macro-directory 
+.RB  \-n\~\c
+.IR page-number 
+.RB  \-o\~\c
+.IR page-list 
+.RB  \-P\~\c
+.IR postprocessor-argument 
+.RB  \-r\~\c
+.IR cnumeric-expression 
+.RB  \-r\~\c
+.IB register =\c
+.IR numeric-expression 
+.RB  \-T\~\c
+.IR output-device 
+.RB  \-w\~\c
+.IR warning-category 
+.RB  \-W\~\c
+.IR warning-category 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY @g@nroff
 .B \-\-help
 .YS
 .
+.
 .SY @g@nroff
 .B \-v
+.
 .SY @g@nroff
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I @g@nroff
 formats documents written in the
-.IR roff (@MAN7EXT@)
+.MR groff @MAN7EXT@
 language for typewriter-like devices such as terminal emulators.
 .
-.P
 GNU
-.I @g@nroff
-emulates the traditional Unix
-.I nroff
+.I nroff \" GNU
+emulates the AT&T
+.I nroff \" AT&T
 command using
-.IR groff (@MAN1EXT@).
+.MR groff @MAN1EXT@ .
 .
 .I @g@nroff
 generates output via
-.IR grotty (@MAN1EXT@),
+.MR grotty @MAN1EXT@ ,
 .IR groff 's
-TTY output device,
-which needs to know the character encoding scheme used by the terminal.
+terminal output driver,
+which needs to know the character encoding scheme used by the device.
 .
 Consequently,
 acceptable arguments to the
@@ -111,16 +136,17 @@
 .I \%GROFF_TYPESETTER
 environment variable nor the
 .B \-T
-command-line option (which overrides the environment variable)
+command-line option
+(which overrides the environment variable)
 specifies a (valid) device,
 .I @g@nroff
 consults the locale to select an appropriate output device.
 .
 It first tries the
-.IR locale (1)
+.MR locale 1
 program,
 then checks several locale-related environment variables;
-see \(lqENVIRONMENT\(rq, below.
+see section \lqEnvironment\rq below.
 .
 If all of the foregoing fail,
 .B \-Tascii
@@ -128,61 +154,75 @@
 .
 .
 .P
-Whitespace is not permitted between an option and its argument.
-.
-The
-.B \-h
-and
-.B \-c
-options
-are equivalent to
-.IR grotty 's
-options
-.B \-h
-(using tabs in the output) and
-.B \-c
-(using the old output scheme instead of SGR escape sequences).
-.
 The
-.BR \-d ,
+.BR \-b ,
+.BR \-c ,
 .BR \-C ,
+.BR \-d ,
+.BR \-E ,
 .BR \-i ,
-.BR \-M ,
 .BR \-m ,
+.BR \-M ,
 .BR \-n ,
 .BR \-o ,
 .BR \-r ,
+.BR \-U ,
 .BR \-w ,
+.BR \-W ,
+and
+.B \-z
+options have the effects described in
+.MR @g@troff @MAN1EXT@ .
+.
+.B \-c
+and
+.B \-h
+imply
+.RB \lq \-P\-c \rq
 and
-.B \-W
-options have the effect described in
-.IR @g@troff (@MAN1EXT@).
+.RB \lq \-P\-h \rq,
+respectively;
+.B \-c
+is also interpreted directly by
+.IR @g@troff .
 .
 In addition,
-.I @g@nroff
-ignores
+this implementation ignores the AT&T
+.I nroff \" AT&T
+options
 .BR \-e ,
 .BR \-q ,
 and
 .B \-s
 (which are not implemented in
-.IR @g@troff ).
+.IR groff ).
 .
 The options
-.B \-p
-(pic),
-.B \-t
-(tbl),
+.BR \-k ,
+.BR \-K ,
+.BR \-p ,
+.BR \-P ,
+.BR \-R ,
+.BR \-t ,
+and
 .B \-S
-(safer), and
-.B \-U
-(unsafe) are passed to
-.IR groff .
+are documented in
+.MR groff @MAN1EXT@ .
+.
+.B \-V
+causes
+.I @g@nroff
+to display the constructed
+.I groff
+command on the standard output stream,
+but does not execute it.
 .
 .B \-v
 and
 .B \-\-version
-show version information,
+show version information about
+.I @g@nroff
+and the programs it runs,
 while
 .B \-\-help
 displays a usage message;
@@ -190,13 +230,39 @@
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH "Exit status"
 .\" ====================================================================
 .
-.TP
-.I GROFF_TYPESETTER
-specifies the default output device for
-.IR groff .
+.I @g@nroff
+exits with error
+.RB status\~ 2
+if there was a problem parsing its arguments,
+with
+.RB status\~ 0
+if any of the options
+.BR \-V ,
+.BR \-v ,
+.BR \-\-version ,
+or
+.B \-\-help
+were specified,
+and with the status of
+.I groff
+otherwise.
+.
+.
+.\" ====================================================================
+.SH Environment
+.\" ====================================================================
+.
+Normally,
+the path separator in environment variables ending with
+.I PATH
+is the colon;
+this may vary depending on the operating system.
+.
+For example,
+Windows uses a semicolon instead.
 .
 .
 .TP
@@ -212,6 +278,12 @@
 .
 .
 .TP
+.I GROFF_TYPESETTER
+specifies the default output device for
+.IR groff .
+.
+.
+.TP
 .I LC_ALL
 .TQ
 .I LC_CTYPE
@@ -219,37 +291,68 @@
 .I LANG
 .TQ
 .I LESSCHARSET
-are pattern-matched in this order for standard character encodings
-supported by
+are pattern-matched in this order for contents matching standard
+character encodings supported by
 .I groff
 in the event no
 .B \-T
 option is given and
-.I GROFF_TYPESETTER
-is unset.
+.I \%GROFF_TYPESETTER
+is unset,
+or the values specified are invalid.
+.
+.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
+.
+.TP
+.I @MACRODIR@/\:\%tty\-char\:.tmac
+defines fallback definitions of
+.I roff
+special characters.
+.
+These definitions more poorly optically approximate typeset output
+than those of
+.I tty.tmac
+in favor of communicating semantic information.
+.
+.I nroff
+loads it automatically.
 .
 .
 .\" ====================================================================
-.SH NOTES
+.SH Notes
 .\" ====================================================================
 .
-Character definitions in the file
-.I @MACRODIR@/\:tty\-char.tmac
-are loaded to replace unrepresentable glyphs.
+Pager programs like
+.MR more 1
+and
+.MR less 1
+may require command-line options to correctly handle some output
+sequences;
+see
+.MR grotty @MAN1EXT@ .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR groff (@MAN1EXT@),
-.IR @g@troff (@MAN1EXT@),
-.IR grotty (@MAN1EXT@),
-.IR locale (1),
-.IR roff (@MAN7EXT@)
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR grotty @MAN1EXT@ ,
+.MR locale 1 ,
+.MR roff @MAN7EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_nroff_1_man_C
+.do rr *groff_nroff_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/nroff/nroff.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/nroff/nroff.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/nroff/nroff.sh -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/nroff/nroff.sh Changed

@@ -1,97 +1,82 @@
 #! /bin/sh
 # Emulate nroff with groff.
 #
-# Copyright (C) 1992-2018 Free Software Foundation, Inc.
+# Copyright (C) 1992-2021 Free Software Foundation, Inc.
+#
+# Written by James Clark, Werner Lemberg, and G. Branden Robinson.
+#
+# This file is part of 'groff'.
 #
-# Written by James Clark.
-
-# This file is of 'groff'.
-
 # 'groff' is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License (GPL) as published
 # by the Free Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
-
+#
 # '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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
 prog="$0"
 
-# Default device.
-
-# Check the GROFF_TYPESETTER environment variable.
-Tenv=$GROFF_TYPESETTER
-
-# Try the 'locale charmap' command first because it is most reliable.
-# On systems where it doesn't exist, look at the environment variables.
-case "`exec 2>/dev/null ; locale charmap`" in
-  UTF-8)
-    Tloc=utf8 ;;
-  ISO-8859-1 | ISO-8859-15)
-    Tloc=latin1 ;;
-  IBM-1047)
-    Tloc=cp1047 ;;
-  *)
-    case "${LC_ALL-${LC_CTYPE-${LANG}}}" in
-      *.UTF-8)
-        Tloc=utf8 ;;
-      iso_8859_1 | *.ISO-8859-1 | *.ISO8859-1 | \
-      iso_8859_15 | *.ISO-8859-15 | *.ISO8859-15)
-        Tloc=latin1 ;;
-      *.IBM-1047)
-        Tloc=cp1047 ;;
-      *)
-        case "$LESSCHARSET" in
-          utf-8)
-            Tloc=utf8 ;;
-          latin1)
-            Tloc=latin1 ;;
-          cp1047)
-            Tloc=cp1047 ;;
-          *)
-            Tloc=ascii ;;
-        esac ;;
-    esac ;;
-esac
-
-# 'for i; do' doesn't work with some versions of sh
-
+T=
 Topt=
 opts=
-for i
-  do
-  case $1 in
+dry_run=
+is_option_argument_pending=
+
+usage="usage: $prog -bcCEhikpRStUVz -d ctext -d string=text \
+-K fallback-encoding -m macro-package -M macro-directory \
+-n page-number -o page-list -P postprocessor-argument \
+-r cnumeric-expression -r register=numeric-expression \
+-T output-device -w warning-category -W warning-category \
+file ...
+usage: $prog {-v | --version}
+usage: $prog --help"
+
+for arg
+do
+  if  -n "$is_option_argument_pending" 
+  then
+    is_option_argument_pending=
+    opts="$opts $arg"
+    shift
+    continue
+  fi
+
+  case $arg in
     -c)
-      opts="$opts -P-c" ;;
+      opts="$opts $arg -P-c" ;;
     -h)
       opts="$opts -P-h" ;;
     -eq | -s*)
       # ignore these options
       ;;
-    -dMmrnoTwW)
-      echo "$prog: option $1 requires an argument" >&2
-      exit 1 ;;
-    -iptSUC | -dMmrnowW*)
-      opts="$opts $1" ;;
+    -dKmMnoPrTwW)
+      is_option_argument_pending=yes
+      opts="$opts $arg" ;;
+    -bCEikpRStUz | -dKMmrnoPwW*)
+      opts="$opts $arg" ;;
     -T*)
-      Topt=$1 ;;
+      Topt=$arg ;;
     -u*)
+      # -u is for Solaris compatibility and not otherwise documented.
+      #
       # Solaris 2.2 through at least Solaris 9 'man' invokes
-      # 'nroff -u0 ... | col -x'.  Ignore the -u0,
-      # since 'less' and 'more' can use the emboldening info.
-      # However, disable SGR, since Solaris 'col' mishandles it.
+      # 'nroff -u0 ... | col -x'.  Ignore the -u0, since 'less' and
+      # 'more' can use the emboldening info.  But disable SGR, since
+      # Solaris 'col' mishandles it.
       opts="$opts -P-c" ;;
+    -V)
+      dry_run=yes ;;
     -v | --version)
       echo "GNU nroff (groff) version @VERSION@"
-      exit 0 ;;
+      opts="$opts $arg" ;;
     --help)
-      echo "usage: nroff -CchipStUv -dCS -MDIR -mNAME -nNUM -oLIST"
-      echo "             -rCN -Tname -WNAME -wNAME FILE..."
+      echo "$usage"
       exit 0 ;;
     --)
       shift
@@ -99,38 +84,121 @@
     -)
       break ;;
     -*)
-      echo "$prog: invalid option $1" >&2
-      exit 1 ;;
+      echo "$prog: usage error: invalid option '$arg'" >&2
+      echo "$usage" >&2
+      exit 2 ;;
     *)
       break ;;
   esac
   shift
 done
 
-if test "x$Topt" != x ; then
-  T=$Topt
-else
-  if test "x$Tenv" != x ; then
-    T=-T$Tenv
-  fi
+if  -n "$is_option_argument_pending" 
+then
+    echo "$prog: usage error: option '$arg' requires an argument" >&2
+    exit 2
 fi
 
-case $T in
+# Determine the -T option.  Was a valid one specified?
+case "$Topt" in
   -Tascii | -Tlatin1 | -Tutf8 | -Tcp1047)
-    ;;
-  *)
-    # ignore other devices and use locale fallback
-    T=-T$Tloc ;;
+    T=$Topt ;;
 esac
 
-# Set up the 'GROFF_BIN_PATH' variable
-# to be exported in the current 'GROFF_RUNTIME' environment.
+# -T option absent or invalid; try environment.
+if  -z "$T" 
+then
+  Tenv=-T$GROFF_TYPESETTER
+  case "$Tenv" in
+    -Tascii | -Tlatin1 | -Tutf8 | -Tcp1047)
+      T=$Tenv ;;
+  esac
+fi
 
+# Finally, infer a -T option from the locale.  Try 'locale charmap'
+# first because it is the most reliable, then look at environment
+# variables.
+if  -z "$T" 
+then
+  # The separate `exec` is to work around a ~2004 bug in Cygwin sh.exe.
+  case "`exec 2>/dev/null ; locale charmap`" in
+    UTF-8)
+      Tloc=utf8 ;;
+    ISO-8859-1 | ISO-8859-15)
+      Tloc=latin1 ;;
+    IBM-1047)
+      Tloc=cp1047 ;;
+    *)
+      # Some old shells don't support ${FOO:-bar} expansion syntax.  We
+      # should switch to it when it is safe to abandon support for them.
+      case "${LC_ALL-${LC_CTYPE-${LANG}}}" in
+        *.UTF-8)
+          Tloc=utf8 ;;
+        iso_8859_1 | *.ISO-8859-1 | *.ISO8859-1 | \
+        iso_8859_15 | *.ISO-8859-15 | *.ISO8859-15)
+          Tloc=latin1 ;;
+        *.IBM-1047)
+          Tloc=cp1047 ;;
+        *)
+          case "$LESSCHARSET" in
+            utf-8)
+              Tloc=utf8 ;;
+            latin1)
+              Tloc=latin1 ;;
+            cp1047)
+              Tloc=cp1047 ;;
+            *)
+              Tloc=ascii ;;
+          esac ;;
+      esac ;;
+  esac
+  T=-T$Tloc
+fi
+
+# Load nroff-style character definitions too.
+opts="-mtty-char$opts"
+
+# Set up the 'GROFF_BIN_PATH' variable to be exported in the current
+# 'GROFF_RUNTIME' environment.
 @GROFF_BIN_PATH_SETUP@
 export GROFF_BIN_PATH
 
-# Load nroff-style character definitions too.
+# Let our test harness redirect us.  See LC_ALL comment above.
+groff=${GROFF_TEST_GROFF-groff}
 
-PATH="$GROFF_RUNTIME$PATH" groff -mtty-char $T $opts ${1+"$@"}
+# Note 1: It would be nice to apply the DRY ("Don't Repeat Yourself")
+# principle here and store the entire command string to be executed into
+# a variable, and then either display it or execute it.  For example:
+#
+#   cmd="PATH=... groff ... $@"
+#   ...
+#   printf "%s\n" "$cmd"
+#   ...
+#   eval $cmd
+#
+# Unfortunately, the shell is a nightmarish hellscape of quoting issues.
+# Naïve attempts to solve the problem fail when arguments to nroff
+# contain embedded whitespace or shell metacharacters.  The solution
+# below works with those, but there is insufficient quoting in -V (dry
+# run) mode, such that you can't copy-and-paste the output of 'nroff -V'
+# if you pass it a filename like foo"bar (with the embedded quotation
+# mark) and expect it to run without further quoting.
+#
+# If POSIX adopts Bash's ${var@Q} or an equivalent, this issue can be
+# revisited.
+#
+# Note 2: The construction '${1+"@$"}' preserves the absence of
+# arguments in old shells; see "Shell Substitutions" in the GNU Autoconf
+# manual.  We don't want 'nroff' to become 'groff ... ""' if $# equals
+# zero.
+if  -n "$dry_run" 
+then
+  echo PATH="$GROFF_RUNTIME$PATH" $groff $T $opts ${1+"$@"}
+else
+  PATH="$GROFF_RUNTIME$PATH" $groff $T $opts ${1+"$@"}
+fi
 
-# eof
+# Local Variables:
+# fill-column: 72
+# End:
+# vim: set autoindent expandtab shiftwidth=2 softtabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/nroff/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/roff/nroff/tests/verbose_option_works.sh Added

@@ -0,0 +1,68 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+# Ensure a predictable character encoding.
+export LC_ALL=C
+export LESSCHARSET=
+export GROFF_TYPESETTER=
+
+set -e
+
+export GROFF_TEST_GROFF=${abs_top_builddir:-.}/test-groff
+
+# The $PATH used by an installed nroff at runtime does not match what
+# we're trying to test, which should be using the groff and runtime
+# support from the build tree.  Therefore the $PATH that nroff -V
+# reports will _always_ be wrong for test purposes.  Skip over it.
+#
+# If the build environment has a directory in the $PATH matching
+# "test-groff " (with the trailing space), failure may result if sed
+# doesn't match greedily.  POSIX says it should.
+sedexpr='s/^PATH=.*test-groff /test-groff /'
+PATH=${abs_top_builddir:-.}:$PATH
+
+nroff_ver=$(nroff -v | awk 'NR == 1 {print $NF}')
+groff_ver=$(nroff -v | awk 'NR == 2 {print $NF}')
+
+echo nroff: $nroff_ver >&2
+echo groff: $groff_ver >&2
+test "$nroff_ver" = "$groff_ver"
+
+echo "testing 'nroff -V'" >&2
+nroff -V | sed "$sedexpr" | grep -x "test-groff -Tascii -mtty-char"
+
+echo "testing 'nroff -V 1'" >&2
+nroff -V 1 | sed "$sedexpr" | grep -x "test-groff -Tascii -mtty-char 1"
+
+echo "testing 'nroff -V \"1a 1b\"'" >&2
+nroff -V \"1a 1b\" | sed "$sedexpr" \
+    | grep -x "test-groff -Tascii -mtty-char \"1a 1b\""
+
+echo "testing 'nroff -V \"1a 1b\" 2'" >&2
+nroff -V \"1a 1b\" 2 | sed "$sedexpr" \
+    | grep -x "test-groff -Tascii -mtty-char \"1a 1b\" 2"
+
+echo "testing 'nroff -V 1a\\\"1b 2'" >&2
+nroff -V 1a\"1b 2 | sed "$sedexpr" \
+    | grep -x "test-groff -Tascii -mtty-char 1a\"1b 2"
+
+echo "testing 'nroff -V -d FOO=BAR 1'" >&2
+nroff -V -d FOO=BAR 1 | sed "$sedexpr" \
+    | grep -x "test-groff -Tascii -mtty-char -d FOO=BAR 1"

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/TODO -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/TODO Changed

@@ -40,7 +40,8 @@
 but we won't be able to because we will look for the hyphen only in
 font S and not in font R.
 
-Perhaps the current input level should be accessible in a number register.
+Perhaps the current interpolation depth should be accessible in a number
+register.
 
 Should \w deal with a newline like \X?
 
@@ -70,8 +71,6 @@
 
 Request to set character slant.
 
-Provide some way to upcase or downcase strings.
-
 Support non-uniformly scalable fonts. Perhaps associate a suffix with
 a particular range of sizes.  E.g.,
   sizesuffix .display 14-512
@@ -96,7 +95,7 @@
 optionally print the contents of a macro.
 
 Provide some way to round numbers to multiples of the current
-horizontal or vertical resolution.
+horizontal or vertical motion quantum.
 
 Better string-processing support (search).
 
@@ -107,7 +106,7 @@
 or environment stack.)
 
 Perhaps in the nr request a leading '-' should only be recognized as a
-decrement when it's at the same input level as the request.
+decrement when it's at the same interpolation depth as the request.
 
 Don't ever change a charinfo.  Create new variants instead and chain
 them together.

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/charinfo.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/charinfo.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/column.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/column.cpp Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -463,8 +463,8 @@
 
 justification_spec::~justification_spec()
 {
-  a_delete type;
-  a_delete amount;
+  delete type;
+  delete amount;
 }
 
 void justification_spec::append(symbol t, vunits v)
@@ -485,12 +485,12 @@
     int i;
     for (i = 0; i < n; i++)
       typei = old_typei;
-    a_delete old_type;
+    delete old_type;
     vunits *old_amount = amount;
     amount = new vunitsmaxn;
     for (i = 0; i < n; i++)
       amounti = old_amounti;
-    a_delete old_amount;
+    delete old_amount;
   }
   assert(n < maxn);
   typen = t;
@@ -554,14 +554,14 @@
     error("can't justify column - column not active");
   else if (get_vunits(&height, 'v')) {
     justification_spec js(height);
-    symbol nm = get_long_name(1);
+    symbol nm = get_long_name(true /* required */);
     if (!nm.is_null()) {
       vunits v;
       if (get_vunits(&v, 'v')) {
 	js.append(nm, v);
 	int err = 0;
 	while (has_arg()) {
-	  nm = get_long_name(1);
+	  nm = get_long_name(true /* required */);
 	  if (nm.is_null()) {
 	    err = 1;
 	    break;
@@ -721,11 +721,11 @@
   init_request("colt", column_trim);
   init_request("nvj", no_vjustify);
   init_request("rvj", restore_vjustify);
-  number_reg_dictionary.define(".colb", new column_bottom_reg);
-  number_reg_dictionary.define(".colx", new column_extra_space_reg);
-  number_reg_dictionary.define(".cola", new column_active_reg);
-  number_reg_dictionary.define(".nvj",
-			       new constant_int_reg(&no_vjustify_mode));
+  register_dictionary.define(".colb", new column_bottom_reg);
+  register_dictionary.define(".colx", new column_extra_space_reg);
+  register_dictionary.define(".cola", new column_active_reg);
+  register_dictionary.define(".nvj",
+			       new readonly_register(&no_vjustify_mode));
 }
 
 #endif /* COLUMN */

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/dictionary.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/dictionary.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/dictionary.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/dictionary.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/div.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/div.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -34,12 +33,12 @@
 
 #include "nonposix.h"
 
-int exit_started = 0;		// the exit process has started
-int done_end_macro = 0;		// the end macro (if any) has finished
-int seen_last_page_ejector = 0;	// seen the LAST_PAGE_EJECTOR cookie
+bool is_exit_underway = false;
+bool is_eoi_macro_finished = false;
+bool seen_last_page_ejector = false;
+static bool began_page_in_eoi_macro = false;
 int last_page_number = 0;	// if > 0, the number of the last page
 				// specified with -o
-static int began_page_in_end_macro = 0;	// a new page was begun during the end macro
 
 static int last_post_line_extra_space = 0; // needed for \n(.a
 static int nl_reg_contents = -1;
@@ -49,7 +48,7 @@
 static vunits truncated_space;
 static vunits needed_space;
 
-diversion::diversion(symbol s) 
+diversion::diversion(symbol s)
 : prev(0), nm(s), vertical_position(V0), high_water_mark(V0),
   any_chars_added(0), no_space_mode(0), needs_push(0), saved_seen_break(0),
   saved_seen_space(0), saved_seen_eol(0), saved_suppress_next_eol(0),
@@ -152,7 +151,7 @@
 {
   do_divert(1, 0);
 }
-  
+
 void box()
 {
   do_divert(0, 1);
@@ -247,7 +246,7 @@
   if (!diversion_trap.is_null() && diversion_trap_pos > vertical_position)
     return diversion_trap_pos - vertical_position;
   else
-    // Substract vresolution so that vunits::vunits does not overflow.
+    // Subtract vresolution so that vunits::vunits does not overflow.
     return vunits(INT_MAX - vresolution);
 }
 
@@ -343,7 +342,7 @@
   for (trap *pt = page_trap_list; pt != 0; pt = pt->next)
     if (!pt->nm.is_null()) {
       if (pt->position >= V0) {
-	if (pt->position > vertical_position 
+	if (pt->position > vertical_position
 	    && pt->position < page_length
 	    && (next_trap == 0 || pt->position < *next_trap_pos)) {
 	  next_trap = pt;
@@ -379,7 +378,7 @@
   no_space_mode = 0;
   vunits next_trap_pos;
   trap *next_trap = find_next_trap(&next_trap_pos);
-  if (before_first_page && begin_page()) 
+  if (before_first_page && begin_page())
     fatal("sorry, I didn't manage to begin the first page in time: use an explicit .br request");
   vertical_size v(vs, post_vs);
   for (node *tem = nd; tem != 0; tem = tem->next)
@@ -434,7 +433,8 @@
 
 void top_level_diversion::transparent_output(node * /*n*/)
 {
-  error("can't transparently output node at top level");
+  if (getenv("GROFF_ENABLE_TRANSPARENCY_WARNINGS") != 0 /* nullptr */)
+    error("can't transparently output node at top level");
 }
 
 void top_level_diversion::copy_file(const char *filename)
@@ -505,7 +505,7 @@
   }
   else
     *p = new trap(nam, pos, 0);
-}  
+}
 
 void top_level_diversion::remove_trap(symbol nam)
 {
@@ -524,7 +524,7 @@
       return;
     }
 }
-      
+
 void top_level_diversion::change_trap(symbol nam, vunits pos)
 {
   for (trap *p = page_trap_list; p; p = p->next)
@@ -532,6 +532,8 @@
       p->position = pos;
       return;
     }
+  warning(WARN_MAC, "cannot move unplanted trap macro '%1'",
+	  nam.contents());
 }
 
 void top_level_diversion::print_traps()
@@ -559,7 +561,10 @@
 {
   if (the_output) {
     the_output->trailer(topdiv->get_page_length());
-    delete the_output;
+    // If we're already dying, don't call the_output's destructor.  See
+    // node.cpp:real_output_file::~real_output_file().
+    if (!the_output->is_dying)
+      delete the_output;
   }
   FLUSH_INPUT_PIPE(STDIN_FILENO);
   exit(exit_code);
@@ -569,16 +574,17 @@
 // The optional parameter is for the .trunc register.
 int top_level_diversion::begin_page(vunits n)
 {
-  if (exit_started) {
+  if (is_exit_underway) {
     if (page_count == last_page_count
 	? curenv->is_empty()
-	: (done_end_macro && (seen_last_page_ejector || began_page_in_end_macro)))
-      cleanup_and_exit(0);
-    if (!done_end_macro)
-      began_page_in_end_macro = 1;
+	: (is_eoi_macro_finished && (seen_last_page_ejector
+				      || began_page_in_eoi_macro)))
+      cleanup_and_exit(EXIT_SUCCESS);
+    if (!is_eoi_macro_finished)
+      began_page_in_eoi_macro = true;
   }
   if (last_page_number > 0 && page_number == last_page_number)
-    cleanup_and_exit(0);
+    cleanup_and_exit(EXIT_SUCCESS);
   if (!the_output)
     init_output();
   ++page_count;
@@ -689,7 +695,7 @@
   int n = 0;		/* pacify compiler */
   if (has_arg() && get_integer(&n, topdiv->get_page_number()))
     got_arg = 1;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (curdiv == topdiv) {
     if (topdiv->before_first_page) {
@@ -768,14 +774,14 @@
   vunits n;
   if (!has_arg() || !get_vunits(&n, 'v'))
     n = curenv->get_vertical_spacing();
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (!unpostpone_traps() && !curdiv->no_space_mode)
     curdiv->space(n);
   else
     // The line might have had line spacing that was truncated.
     truncated_space += n;
-  
+
   tok.next();
 }
 
@@ -796,7 +802,7 @@
   vunits n;
   if (!has_arg() || !get_vunits(&n, 'v'))
     n = curenv->get_vertical_spacing();
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   curdiv->need(n);
   tok.next();
@@ -808,7 +814,9 @@
 
   // the ps4html register is set if we are using -Tps
   // to generate images for html
-  reg *r = (reg *)number_reg_dictionary.lookup("ps4html");
+  // XXX: Yuck!  Get rid of this; macro packages already test the
+  // register before invoking .pn.
+  reg *r = (reg *)register_dictionary.lookup("ps4html");
   if (r == NULL)
     if (has_arg() && get_integer(&n, topdiv->get_page_number()))
       topdiv->set_next_page_number(n);
@@ -831,7 +839,7 @@
 
 void output_saved_vertical_space()
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (saved_space > V0)
     curdiv->space(saved_space, 1);
@@ -841,7 +849,7 @@
 
 void flush_output()
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -868,7 +876,7 @@
 
 void top_level_diversion::clear_diversion_trap()
 {
-  error("can't set diversion trap when no current diversion");
+  error("can't clear diversion trap when no current diversion");
 }
 
 void diversion_trap()
@@ -888,7 +896,7 @@
 
 void change_trap()
 {
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!s.is_null()) {
     vunits x;
     if (has_arg() && get_vunits(&x, 'v'))
@@ -952,14 +960,14 @@
 
 class page_offset_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
-  
-int page_offset_reg::get_value(units *res)
+
+bool page_offset_reg::get_value(units *res)
 {
   *res = topdiv->get_page_offset().to_units();
-  return 1;
+  return true;
 }
 
 const char *page_offset_reg::get_string()
@@ -969,14 +977,14 @@
 
 class page_length_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
-  
-int page_length_reg::get_value(units *res)
+
+bool page_length_reg::get_value(units *res)
 {
   *res = topdiv->get_page_length().to_units();
-  return 1;
+  return true;
 }
 
 const char *page_length_reg::get_string()
@@ -986,17 +994,17 @@
 
 class vertical_position_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
-  
-int vertical_position_reg::get_value(units *res)
+
+bool vertical_position_reg::get_value(units *res)
 {
   if (curdiv == topdiv && topdiv->before_first_page)
     *res = -1;
   else
     *res = curdiv->get_vertical_position().to_units();
-  return 1;
+  return true;
 }
 
 const char *vertical_position_reg::get_string()
@@ -1009,14 +1017,14 @@
 
 class high_water_mark_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
-  
-int high_water_mark_reg::get_value(units *res)
+
+bool high_water_mark_reg::get_value(units *res)
 {
   *res = curdiv->get_high_water_mark().to_units();
-  return 1;
+  return true;
 }
 
 const char *high_water_mark_reg::get_string()
@@ -1026,14 +1034,14 @@
 
 class distance_to_next_trap_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
-  
-int distance_to_next_trap_reg::get_value(units *res)
+
+bool distance_to_next_trap_reg::get_value(units *res)
 {
   *res = curdiv->distance_to_next_trap().to_units();
-  return 1;
+  return true;
 }
 
 const char *distance_to_next_trap_reg::get_string()
@@ -1054,7 +1062,7 @@
 class page_number_reg : public general_reg {
 public:
   page_number_reg();
-  int get_value(units *);
+  bool get_value(units *);
   void set_value(units);
 };
 
@@ -1067,10 +1075,10 @@
   topdiv->set_page_number(n);
 }
 
-int page_number_reg::get_value(units *res)
+bool page_number_reg::get_value(units *res)
 {
   *res = topdiv->get_page_number();
-  return 1;
+  return true;
 }
 
 class next_page_number_reg : public reg {
@@ -1135,14 +1143,14 @@
 
 class no_space_mode_reg : public reg {
 public:
-  int get_value(units *);
+  bool get_value(units *);
   const char *get_string();
 };
 
-int no_space_mode_reg::get_value(units *val)
+bool no_space_mode_reg::get_value(units *val)
 {
   *val = curdiv->no_space_mode;
-  return 1;
+  return true;
 }
 
 const char *no_space_mode_reg::get_string()
@@ -1174,25 +1182,31 @@
   init_request("sv", save_vertical_space);
   init_request("vpt", vertical_position_traps);
   init_request("wh", when_request);
-  number_reg_dictionary.define(".a",
-		       new constant_int_reg(&last_post_line_extra_space));
-  number_reg_dictionary.define(".d", new vertical_position_reg);
-  number_reg_dictionary.define(".h", new high_water_mark_reg);
-  number_reg_dictionary.define(".ne",
+  register_dictionary.define(".a",
+		       new readonly_register(&last_post_line_extra_space));
+  register_dictionary.define(".d", new vertical_position_reg);
+  register_dictionary.define(".h", new high_water_mark_reg);
+  register_dictionary.define(".ne",
 			       new constant_vunits_reg(&needed_space));
-  number_reg_dictionary.define(".ns", new no_space_mode_reg);
-  number_reg_dictionary.define(".o", new page_offset_reg);
-  number_reg_dictionary.define(".p", new page_length_reg);
-  number_reg_dictionary.define(".pe", new page_ejecting_reg);
-  number_reg_dictionary.define(".pn", new next_page_number_reg);
-  number_reg_dictionary.define(".t", new distance_to_next_trap_reg);
-  number_reg_dictionary.define(".trunc",
+  register_dictionary.define(".ns", new no_space_mode_reg);
+  register_dictionary.define(".o", new page_offset_reg);
+  register_dictionary.define(".p", new page_length_reg);
+  register_dictionary.define(".pe", new page_ejecting_reg);
+  register_dictionary.define(".pn", new next_page_number_reg);
+  register_dictionary.define(".t", new distance_to_next_trap_reg);
+  register_dictionary.define(".trunc",
 			       new constant_vunits_reg(&truncated_space));
-  number_reg_dictionary.define(".vpt", 
-		       new constant_int_reg(&vertical_position_traps_flag));
-  number_reg_dictionary.define(".z", new diversion_name_reg);
-  number_reg_dictionary.define("dl", new variable_reg(&dl_reg_contents));
-  number_reg_dictionary.define("dn", new variable_reg(&dn_reg_contents));
-  number_reg_dictionary.define("nl", new nl_reg);
-  number_reg_dictionary.define("%", new page_number_reg);
-}
+  register_dictionary.define(".vpt",
+		       new readonly_register(&vertical_position_traps_flag));
+  register_dictionary.define(".z", new diversion_name_reg);
+  register_dictionary.define("dl", new variable_reg(&dl_reg_contents));
+  register_dictionary.define("dn", new variable_reg(&dn_reg_contents));
+  register_dictionary.define("nl", new nl_reg);
+  register_dictionary.define("%", new page_number_reg);
+}
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/div.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/div.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/env.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/env.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -36,7 +35,12 @@
 
 symbol default_family("T");
 
-enum { ADJUST_LEFT = 0, ADJUST_BOTH = 1, ADJUST_CENTER = 3, ADJUST_RIGHT = 5 };
+enum { ADJUST_LEFT = 0,
+  ADJUST_BOTH = 1,
+  ADJUST_CENTER = 3,
+  ADJUST_RIGHT = 5,
+  ADJUST_MAX = 5
+};
 
 enum {
   // Not all combinations are valid; see hyphenate_request() below.
@@ -47,18 +51,16 @@
   HYPHEN_NOT_FIRST_CHARS = 8,
   HYPHEN_LAST_CHAR = 16,
   HYPHEN_FIRST_CHAR = 32,
-  HYPHEN_MAX = 63,
+  HYPHEN_MAX = 63
 };
 
-struct env_list {
+struct env_list_node {
   environment *env;
-  env_list *next;
-  env_list(environment *e, env_list *p) : env(e), next(p) {}
+  env_list_node *next;
+  env_list_node(environment *e, env_list_node *p) : env(e), next(p) {}
 };
 
-env_list *env_stack;
-const int NENVIRONMENTS = 10;
-environment *env_tableNENVIRONMENTS;
+env_list_node *env_stack;
 dictionary env_dictionary(10);
 environment *curenv;
 static int next_line_number = 0;
@@ -263,9 +265,12 @@
 // we can't do this in a static constructor because various dictionaries
 // have to get initialized first
 
+static symbol default_environment_name("0");
+
 void init_environments()
 {
-  curenv = env_table0 = new environment("0");
+  curenv = new environment(default_environment_name);
+  (void)env_dictionary.lookup(default_environment_name, curenv);
 }
 
 void tab_character()
@@ -412,6 +417,11 @@
   return right_justify_lines;
 }
 
+int environment::get_no_number_count()
+{
+  return no_number_count;
+}
+
 void environment::add_italic_correction()
 {
   if (current_tab) {
@@ -483,15 +493,23 @@
   spread_flag = 0;
 }
 
-node *do_underline_special(int);
+static node *do_underline_special(bool do_underline_spaces)
+{
+  macro m;
+  m.append_str("x u ");
+  m.append(do_underline_spaces ? '1' : '0');
+  return new special_node(m, 1);
+}
 
-void environment::set_font(symbol nm)
+bool environment::set_font(symbol nm)
 {
-  if (interrupted)
-    return;
+  if (interrupted) {
+    warning(WARN_FONT, "ignoring font selection on interrupted line");
+    return true; // "no operation" is successful
+  }
   if (nm == symbol("P") || nm.is_empty()) {
     if (family->make_definite(prev_fontno) < 0)
-      return;
+      return false;
     int tem = fontno;
     fontno = prev_fontno;
     prev_fontno = tem;
@@ -502,30 +520,34 @@
     if (n < 0) {
       n = next_available_font_position();
       if (!mount_font(n, nm))
-	return;
+	return false;
     }
     if (family->make_definite(n) < 0)
-      return;
+      return false;
     fontno = n;
   }
   if (underline_spaces && fontno != prev_fontno) {
     if (fontno == get_underline_fontno())
-      add_node(do_underline_special(1));
+      add_node(do_underline_special(true));
     if (prev_fontno == get_underline_fontno())
-      add_node(do_underline_special(0));
+      add_node(do_underline_special(false));
   }
+  return true;
 }
 
-void environment::set_font(int n)
+bool environment::set_font(int n)
 {
   if (interrupted)
-    return;
+    return false;
   if (is_good_fontno(n)) {
     prev_fontno = fontno;
     fontno = n;
   }
-  else
-    warning(WARN_FONT, "bad font number");
+  else {
+    warning(WARN_FONT, "no font mounted at position %1", n);
+    return false;
+  }
+  return true;
 }
 
 void environment::set_family(symbol fam)
@@ -533,7 +555,9 @@
   if (interrupted)
     return;
   if (fam.is_null() || fam.is_empty()) {
-    if (prev_family->make_definite(fontno) < 0)
+    int previous_mounting_position = prev_family->make_definite(fontno);
+    assert(previous_mounting_position >= 0);
+    if (previous_mounting_position < 0)
       return;
     font_family *tem = family;
     family = prev_family;
@@ -541,8 +565,17 @@
   }
   else {
     font_family *f = lookup_family(fam);
-    if (f->make_definite(fontno) < 0)
+    // If the family isn't already in the dictionary, looking it up will
+    // create an entry for it.  That doesn't mean that it will be
+    // resolvable to a real font when combined with a style name.
+    assert((f != 0 /* nullptr */) &&
+	   (0 != "font family dictionary lookup"));
+    if (0 /* nullptr */ == f)
+      return;
+    if (f->make_definite(fontno) < 0) {
+      error("no font family named '%1' exists", fam.contents());
       return;
+    }
     prev_family = family;
     family = f;
   }
@@ -703,9 +736,10 @@
   prev_family = family = lookup_family(default_family);
   prev_fontno = fontno = 1;
   if (!is_good_fontno(1))
-    fatal("font number 1 not a valid font");
+    fatal("font mounted at position 1 is not valid");
   if (family->make_definite(1) < 0)
-    fatal("invalid default family '%1'", default_family.contents());
+    fatal("invalid default font family '%1'",
+	  default_family.contents());
   prev_fontno = fontno;
 }
 
@@ -945,7 +979,7 @@
 hunits environment::get_digit_width()
 {
   return env_digit_width(this);
-} 
+}
 
 int environment::get_adjust_mode()
 {
@@ -1096,90 +1130,56 @@
 
 void environment_switch()
 {
-  int pop = 0;	// 1 means pop, 2 means pop but no error message on underflow
-  if (curenv->is_dummy())
-    error("can't switch environments when current environment is dummy");
-  else if (!has_arg())
-    pop = 1;
+  if (curenv->is_dummy()) {
+    error("cannot switch out of dummy environment");
+  }
   else {
-    symbol nm;
-    if (!tok.delimiter()) {
-      // It looks like a number.
-      int n;
-      if (get_integer(&n)) {
-	if (n >= 0 && n < NENVIRONMENTS) {
-	  env_stack = new env_list(curenv, env_stack);
-	  if (env_tablen == 0)
-	    env_tablen = new environment(i_to_a(n));
-	  curenv = env_tablen;
-	}
-	else
-	  nm = i_to_a(n);
+    symbol nm = get_long_name();
+    if (nm.is_null()) {
+      if (env_stack == 0)
+	error("environment stack underflow");
+      else {
+	int seen_space = curenv->seen_space;
+	int seen_eol   = curenv->seen_eol;
+	int suppress_next_eol = curenv->suppress_next_eol;
+	curenv = env_stack->env;
+	curenv->seen_space = seen_space;
+	curenv->seen_eol   = seen_eol;
+	curenv->suppress_next_eol = suppress_next_eol;
+	env_list_node *tem = env_stack;
+	env_stack = env_stack->next;
+	delete tem;
       }
-      else
-	pop = 2;
     }
     else {
-      nm = get_long_name(1);
-      if (nm.is_null())
-	pop = 2;
-    }
-    if (!nm.is_null()) {
       environment *e = (environment *)env_dictionary.lookup(nm);
       if (!e) {
 	e = new environment(nm);
 	(void)env_dictionary.lookup(nm, e);
       }
-      env_stack = new env_list(curenv, env_stack);
+      env_stack = new env_list_node(curenv, env_stack);
       curenv = e;
     }
   }
-  if (pop) {
-    if (env_stack == 0) {
-      if (pop == 1)
-	error("environment stack underflow");
-    }
-    else {
-      int seen_space = curenv->seen_space;
-      int seen_eol   = curenv->seen_eol;
-      int suppress_next_eol = curenv->suppress_next_eol;
-      curenv = env_stack->env;
-      curenv->seen_space = seen_space;
-      curenv->seen_eol   = seen_eol;
-      curenv->suppress_next_eol = suppress_next_eol;
-      env_list *tem = env_stack;
-      env_stack = env_stack->next;
-      delete tem;
-    }
-  }
   skip_line();
 }
 
 void environment_copy()
 {
-  symbol nm;
   environment *e=0;
   tok.skip();
-  if (!tok.delimiter()) {
-    // It looks like a number.
-    int n;
-    if (get_integer(&n)) {
-      if (n >= 0 && n < NENVIRONMENTS)
-	e = env_tablen;
-      else
-	nm = i_to_a(n);
-    }
+  symbol nm = get_long_name();
+  if (nm.is_null()) {
+    error("no environment specified to copy from");
   }
-  else
-    nm = get_long_name(1);
-  if (!e && !nm.is_null())
+  else {
     e = (environment *)env_dictionary.lookup(nm);
-  if (e == 0) {
-    error("No environment to copy from");
-    return;
-  }
-  else
+  if (e)
     curenv->copy(e);
+  else
+    error("cannot copy from nonexistent environment '%1'",
+	  nm.contents());
+  }
   skip_line();
 }
 
@@ -1208,22 +1208,25 @@
 void font_change()
 {
   symbol s = get_name();
-  int is_number = 1;
+  bool is_number = true;
   if (s.is_null() || s == P_symbol) {
     s = P_symbol;
-    is_number = 0;
+    is_number = false;
   }
   else {
     for (const char *p = s.contents(); p != 0 && *p != 0; p++)
       if (!csdigit(*p)) {
-	is_number = 0;
+	is_number = false;
 	break;
       }
   }
+  // environment::set_font warns if a bogus mounting position is
+  // requested.  We must warn here if a bogus font name is selected.
   if (is_number)
-    curenv->set_font(atoi(s.contents()));
+    (void) curenv->set_font(atoi(s.contents()));
   else
-    curenv->set_font(s);
+    if (!curenv->set_font(s))
+      warning(WARN_FONT, "cannot select font '%1'", s.contents());
   skip_line();
 }
 
@@ -1277,7 +1280,7 @@
       sizes = new intn*2;
       memcpy(sizes, old_sizes, n*sizeof(int));
       n *= 2;
-      a_delete old_sizes;
+      delete old_sizes;
     }
     sizesi++ = lower;
     if (lower == 0)
@@ -1292,9 +1295,16 @@
 {
   int n;
   if (get_integer(&n)) {
-    curenv->space_size = n;
+    if (n < 0)
+      warning(WARN_RANGE, "negative word space size ignored: '%1'", n);
+    else
+      curenv->space_size = n;
     if (has_arg() && get_integer(&n))
-      curenv->sentence_space_size = n;
+      if (n < 0)
+	warning(WARN_RANGE, "negative sentence space size ignored: "
+		"'%1'", n);
+      else
+	curenv->sentence_space_size = n;
     else
       curenv->sentence_space_size = curenv->space_size;
   }
@@ -1303,7 +1313,7 @@
 
 void fill()
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1313,7 +1323,7 @@
 
 void no_fill()
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1329,7 +1339,7 @@
     n = 1;
   else if (n < 0)
     n = 0;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1346,7 +1356,7 @@
     n = 1;
   else if (n < 0)
     n = 0;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1359,10 +1369,12 @@
 void line_length()
 {
   hunits temp;
+  hunits minimum_length = font::hor;
   if (has_arg() && get_hunits(&temp, 'm', curenv->line_length)) {
-    if (temp < H0) {
-      warning(WARN_RANGE, "bad line length %1u", temp.to_units());
-      temp = H0;
+    if (temp < minimum_length) {
+      warning(WARN_RANGE, "invalid line length %1u rounded to device"
+			  " horizontal motion quantum", temp.to_units());
+      temp = minimum_length;
     }
   }
   else
@@ -1376,10 +1388,12 @@
 void title_length()
 {
   hunits temp;
+  hunits minimum_length = font::hor;
   if (has_arg() && get_hunits(&temp, 'm', curenv->title_length)) {
-    if (temp < H0) {
-      warning(WARN_RANGE, "bad title length %1u", temp.to_units());
-      temp = H0;
+    if (temp < minimum_length) {
+      warning(WARN_RANGE, "invalid title length %1u rounded to device"
+			  " horizontal motion quantum", temp.to_units());
+      temp = minimum_length;
     }
   }
   else
@@ -1449,7 +1463,7 @@
   }
   else
     temp = curenv->prev_indent;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1466,7 +1480,7 @@
   hunits temp;
   if (!get_hunits(&temp, 'm', curenv->get_indent()))
     err = 1;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -1482,14 +1496,6 @@
   tok.next();
 }
 
-node *do_underline_special(int underline_spaces)
-{
-  macro m;
-  m.append_str("x u ");
-  m.append(underline_spaces + '0');
-  return new special_node(m, 1);
-}
-
 void do_underline(int underline_spaces)
 {
   int n;
@@ -1501,7 +1507,7 @@
       curenv->fontno = curenv->pre_underline_fontno;
       if (underline_spaces) {
 	curenv->underline_spaces = 0;
-	curenv->add_node(do_underline_special(0));
+	curenv->add_node(do_underline_special(false));
       }
     }
     curenv->underline_lines = 0;
@@ -1512,7 +1518,7 @@
     curenv->fontno = get_underline_fontno();
     if (underline_spaces) {
       curenv->underline_spaces = 1;
-      curenv->add_node(do_underline_special(1));
+      curenv->add_node(do_underline_special(true));
     }
   }
   skip_line();
@@ -1554,7 +1560,7 @@
 
 void margin_character()
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
   charinfo *ci = tok.get_char();
   if (ci) {
@@ -1601,7 +1607,7 @@
     curenv->numbering_nodes = nd;
     curenv->line_number_digit_width = env_digit_width(curenv);
     int n;
-    if (!tok.delimiter()) {
+    if (!tok.usable_as_delimiter()) {
       if (get_integer(&n, next_line_number)) {
 	next_line_number = n;
 	if (next_line_number < 0) {
@@ -1611,10 +1617,10 @@
       }
     }
     else
-      while (!tok.space() && !tok.newline() && !tok.eof())
+      while (!tok.is_space() && !tok.is_newline() && !tok.is_eof())
 	tok.next();
     if (has_arg()) {
-      if (!tok.delimiter()) {
+      if (!tok.usable_as_delimiter()) {
 	if (get_integer(&n)) {
 	  if (n <= 0) {
 	    warning(WARN_RANGE, "negative or zero line number multiple");
@@ -1624,17 +1630,17 @@
 	}
       }
       else
-	while (!tok.space() && !tok.newline() && !tok.eof())
+	while (!tok.is_space() && !tok.is_newline() && !tok.is_eof())
 	  tok.next();
       if (has_arg()) {
-	if (!tok.delimiter()) {
+	if (!tok.usable_as_delimiter()) {
 	  if (get_integer(&n))
 	    curenv->number_text_separation = n;
 	}
 	else
-	  while (!tok.space() && !tok.newline() && !tok.eof())
+	  while (!tok.is_space() && !tok.is_newline() && !tok.is_eof())
 	    tok.next();
-	if (has_arg() && !tok.delimiter() && get_integer(&n))
+	if (has_arg() && !tok.usable_as_delimiter() && get_integer(&n))
 	  curenv->line_number_indent = n;
       }
     }
@@ -1713,7 +1719,7 @@
       fontno = pre_underline_fontno;
       if (underline_spaces) {
 	underline_spaces = 0;
-	add_node(do_underline_special(0));
+	add_node(do_underline_special(false));
       }
     }
   }
@@ -1737,7 +1743,7 @@
   else if (interrupted) {
     interrupted = 0;
     // see environment::final_break
-    prev_line_interrupted = exit_started ? 2 : 1;
+    prev_line_interrupted = is_exit_underway ? 2 : 1;
   }
   else if (center_lines > 0) {
     --center_lines;
@@ -1990,7 +1996,7 @@
   }
   if (best_bp) {
     if (!best_bp_fits)
-      output_warning(WARN_BREAK, "can't break line");
+      output_warning(WARN_BREAK, "cannot break line");
     return best_bp;
   }
   return 0;
@@ -2073,12 +2079,26 @@
 }
 
 static void distribute_space(node *n, int nspaces, hunits desired_space,
-			     int force_reverse = 0)
+			     bool force_reverse_node_list = false)
 {
-  static int reverse = 0;
-  if (force_reverse || reverse)
+  if (desired_space.is_zero() || nspaces == 0)
+    return;
+  // Positive desired space is the typical case.  Negative desired space
+  // is possible if we have overrun an unbreakable line.  But we should
+  // not get here if there are no adjustable space nodes to adjust.
+  assert(nspaces > 0);
+  // Space cannot always be distributed evenly among all of the space
+  // nodes in the node list: there are limits to device resolution.  We
+  // add space until we run out, which might happen before the end of
+  // the line.  To achieve uniform typographical grayness and avoid
+  // rivers, we switch the end from which space is initially distributed
+  // with each line requiring it, unless compelled to reverse it.  The
+  // node list's natural ordering is in the direction of text flow, so
+  // we distribute space initially from the left, unlike AT&T troff.
+  static bool do_reverse_node_list = false;
+  if (force_reverse_node_list || do_reverse_node_list)
     n = node_list_reverse(n);
-  if (!force_reverse && nspaces > 0 && spread_limit >= 0
+  if (!force_reverse_node_list && spread_limit >= 0
       && desired_space.to_units() > 0) {
     hunits em = curenv->get_size();
     double Ems = (double)desired_space.to_units() / nspaces
@@ -2088,11 +2108,10 @@
   }
   for (node *tem = n; tem; tem = tem->next)
     tem->spread_space(&nspaces, &desired_space);
-  if (force_reverse || reverse)
+  if (force_reverse_node_list || do_reverse_node_list)
     (void)node_list_reverse(n);
-  if (!force_reverse)
-    reverse = !reverse;
-  assert(desired_space.is_zero() && nspaces == 0);
+  if (!force_reverse_node_list)
+    do_reverse_node_list = !do_reverse_node_list;
 }
 
 void environment::possibly_break_line(int start_here, int forced)
@@ -2135,6 +2154,14 @@
     }
     distribute_space(pre, bp->nspaces, extra_space_width);
     hunits output_width = bp->width + extra_space_width;
+    // This should become an assert() when we can get reliable width
+    // data from CJK glyphs.  See Savannah #44018.
+    if (output_width <= 0) {
+      double output_width_in_ems = output_width.to_units();
+      output_warning(WARN_BREAK, "line has non-positive width %1m",
+		     output_width_in_ems);
+      return;
+    }
     input_line_start -= output_width;
     if (bp->hyphenated)
       hyphen_line_count++;
@@ -2241,7 +2268,7 @@
     macro m;
     m.append_str("devtag:");
     for (const char *p = nm; *p; p++)
-      if (!invalid_input_char((unsigned char)*p))
+      if (!is_invalid_input_char((unsigned char)*p))
 	m.append(*p);
     m.append(' ');
     m.append_int(i);
@@ -2410,7 +2437,7 @@
 
 void do_break_request(int spread)
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break(spread);
@@ -2484,7 +2511,7 @@
 		       curenv->total_post_vertical_spacing(), length_title);
   curenv->hyphen_line_count = 0;
   tok.next();
-}  
+}
 
 void adjust()
 {
@@ -2509,10 +2536,9 @@
       if (get_integer(&n)) {
 	if (n < 0)
 	  warning(WARN_RANGE, "negative adjustment mode");
-	else if (n > 5) {
-	  curenv->adjust_mode = 5;
-	  warning(WARN_RANGE, "adjustment mode '%1' out of range", n);
-	}
+	else if (n > ADJUST_MAX)
+	  warning(WARN_RANGE, "out-of-range adjustment mode ignored: "
+		  "%1", n);
 	else
 	  curenv->adjust_mode = n;
       }
@@ -2540,7 +2566,7 @@
       warning(WARN_RANGE,
 	      "number of lines for input trap must be greater than zero");
     else {
-      symbol s = get_name(1);
+      symbol s = get_name(true /* required */);
       if (!s.is_null()) {
 	curenv->input_trap_count = n;
 	curenv->input_trap = s;
@@ -2577,7 +2603,7 @@
 {
 }
 
-tab_stops::tab_stops(hunits distance, tab_type type) 
+tab_stops::tab_stops(hunits distance, tab_type type)
 : initial_list(0)
 {
   repeated_list = new tab(distance, type);
@@ -2595,7 +2621,8 @@
   return distance_to_next_tab(curpos, distance, &nextpos);
 }
 
-tab_type tab_stops::distance_to_next_tab(hunits curpos, hunits *distance,
+tab_type tab_stops::distance_to_next_tab(hunits curpos,
+					 hunits *distance,
 					 hunits *nextpos)
 {
   hunits lastpos = 0;
@@ -2611,14 +2638,16 @@
     return TAB_NONE;
   hunits base = lastpos;
   for (;;) {
-    for (tem = repeated_list; tem && tem->pos + base <= curpos; tem = tem->next)
+    for (tem = repeated_list; tem && tem->pos + base <= curpos;
+	 tem = tem->next)
       lastpos = tem->pos;
     if (tem) {
       *distance = tem->pos + base - curpos;
       *nextpos  = tem->pos + base;
       return tem->type;
     }
-    assert(lastpos > 0);
+    if (lastpos < 0)
+      lastpos = 0;
     base += lastpos;
   }
   return TAB_NONE;
@@ -2639,7 +2668,7 @@
   int need = count*12 + 3;
   if (buf == 0 || need > buf_size) {
     if (buf)
-      a_delete buf;
+      delete buf;
     buf_size = need;
     buf = new charbuf_size;
   }
@@ -2692,7 +2721,7 @@
 {
 }
 
-tab_stops::tab_stops(const tab_stops &ts) 
+tab_stops::tab_stops(const tab_stops &ts)
 : initial_list(0), repeated_list(0)
 {
   tab **p = &initial_list;
@@ -2752,18 +2781,18 @@
     p = &(*p)->next;
   }
 }
-    
+
 void set_tabs()
 {
   hunits pos;
   hunits prev_pos = 0;
-  int first = 1;
-  int repeated = 0;
+  bool is_first_stop = true;
+  bool is_repeating_stop = false;
   tab_stops tabs;
   while (has_arg()) {
     if (tok.ch() == TAB_REPEAT_CHAR) {
       tok.next();
-      repeated = 1;
+      is_repeating_stop = true;
       prev_pos = 0;
     }
     if (!get_hunits(&pos, 'm', prev_pos))
@@ -2780,13 +2809,13 @@
     else if (tok.ch() == 'L') {
       tok.next();
     }
-    if (pos <= prev_pos && !first)
+    if (pos <= prev_pos && ((!is_first_stop) || is_repeating_stop))
       warning(WARN_RANGE,
 	      "positions of tab stops must be strictly increasing");
     else {
-      tabs.add_tab(pos, type, repeated);
+      tabs.add_tab(pos, type, is_repeating_stop);
       prev_pos = pos;
-      first = 0;
+      is_first_stop = false;
     }
   }
   curenv->tabs = tabs;
@@ -2958,16 +2987,18 @@
     add_padding();
   hunits padding = field_distance - (get_text_length() - pre_field_width);
   if (current_tab && tab_field_spaces != 0) {
-    hunits tab_padding = scale(padding, 
-			       tab_field_spaces, 
+    hunits tab_padding = scale(padding,
+			       tab_field_spaces,
 			       field_spaces + tab_field_spaces);
     padding -= tab_padding;
-    distribute_space(tab_contents, tab_field_spaces, tab_padding, 1);
+    distribute_space(tab_contents, tab_field_spaces, tab_padding,
+		     true /* force reversal of node list */);
     tab_field_spaces = 0;
     tab_width += tab_padding;
   }
   if (field_spaces != 0) {
-    distribute_space(line, field_spaces, padding, 1);
+    distribute_space(line, field_spaces, padding,
+		     true /* force reversal of node list */);
     width_total += padding;
     if (current_tab) {
       // the start of the tab has been moved to the right by padding, so
@@ -3025,7 +3056,7 @@
  public:
   int_env_reg(INT_FUNCP);
   const char *get_string();
-  int get_value(units *val);
+  bool get_value(units *val);
 };
 
 class vunits_env_reg : public reg {
@@ -3033,7 +3064,7 @@
  public:
   vunits_env_reg(VUNITS_FUNCP f);
   const char *get_string();
-  int get_value(units *val);
+  bool get_value(units *val);
 };
 
 
@@ -3042,7 +3073,7 @@
  public:
   hunits_env_reg(HUNITS_FUNCP f);
   const char *get_string();
-  int get_value(units *val);
+  bool get_value(units *val);
 };
 
 class string_env_reg : public reg {
@@ -3056,25 +3087,25 @@
 {
 }
 
-int int_env_reg::get_value(units *val)
+bool int_env_reg::get_value(units *val)
 {
   *val = (curenv->*func)();
-  return 1;
+  return true;
 }
 
 const char *int_env_reg::get_string()
 {
   return i_to_a((curenv->*func)());
 }
- 
+
 vunits_env_reg::vunits_env_reg(VUNITS_FUNCP f) : func(f)
 {
 }
 
-int vunits_env_reg::get_value(units *val)
+bool vunits_env_reg::get_value(units *val)
 {
   *val = (curenv->*func)().to_units();
-  return 1;
+  return true;
 }
 
 const char *vunits_env_reg::get_string()
@@ -3086,10 +3117,10 @@
 {
 }
 
-int hunits_env_reg::get_value(units *val)
+bool hunits_env_reg::get_value(units *val)
 {
   *val = (curenv->*func)().to_units();
-  return 1;
+  return true;
 }
 
 const char *hunits_env_reg::get_string()
@@ -3109,7 +3140,7 @@
 class horizontal_place_reg : public general_reg {
 public:
   horizontal_place_reg();
-  int get_value(units *);
+  bool get_value(units *);
   void set_value(units);
 };
 
@@ -3117,10 +3148,10 @@
 {
 }
 
-int horizontal_place_reg::get_value(units *res)
+bool horizontal_place_reg::get_value(units *res)
 {
   *res = curenv->get_input_line_position().to_units();
-  return 1;
+  return true;
 }
 
 void horizontal_place_reg::set_value(units n)
@@ -3133,6 +3164,11 @@
   return env_get_zoom(this);
 }
 
+int environment::get_numbering_nodes()
+{
+  return (curenv->numbering_nodes ? 1 : 0);
+}
+
 const char *environment::get_font_family_string()
 {
   return family->nm.contents();
@@ -3355,15 +3391,6 @@
 {
   errprint("Current Environment:\n");
   curenv->print_env();
-  for (int i = 0; i < NENVIRONMENTS; i++) {
-    if (env_tablei) {
-      errprint("Environment %1:\n", i);
-      if (env_tablei != curenv)
-	env_tablei->print_env();
-      else
-	errprint("  current\n");
-    }
-  }
   dictionary_iterator iter(env_dictionary);
   symbol s;
   environment *e;
@@ -3380,16 +3407,16 @@
 }
 
 #define init_int_env_reg(name, func) \
-  number_reg_dictionary.define(name, new int_env_reg(&environment::func))
+  register_dictionary.define(name, new int_env_reg(&environment::func))
 
 #define init_vunits_env_reg(name, func) \
-  number_reg_dictionary.define(name, new vunits_env_reg(&environment::func))
+  register_dictionary.define(name, new vunits_env_reg(&environment::func))
 
 #define init_hunits_env_reg(name, func) \
-  number_reg_dictionary.define(name, new hunits_env_reg(&environment::func))
+  register_dictionary.define(name, new hunits_env_reg(&environment::func))
 
 #define init_string_env_reg(name, func) \
-  number_reg_dictionary.define(name, new string_env_reg(&environment::func))
+  register_dictionary.define(name, new string_env_reg(&environment::func))
 
 void init_env_requests()
 {
@@ -3470,6 +3497,8 @@
   init_string_env_reg(".M", get_fill_color_string);
   init_string_env_reg(".m", get_glyph_color_string);
   init_hunits_env_reg(".n", get_prev_text_length);
+  init_int_env_reg(".nm", get_numbering_nodes);
+  init_int_env_reg(".nn", get_no_number_count);
   init_int_env_reg(".ps", get_point_size);
   init_int_env_reg(".psr", get_requested_point_size);
   init_vunits_env_reg(".pvs", get_post_vertical_spacing);
@@ -3485,15 +3514,15 @@
   init_vunits_env_reg(".v", get_vertical_spacing);
   init_hunits_env_reg(".w", get_prev_char_width);
   init_int_env_reg(".zoom", get_zoom);
-  number_reg_dictionary.define("ct", new variable_reg(&ct_reg_contents));
-  number_reg_dictionary.define("hp", new horizontal_place_reg);
-  number_reg_dictionary.define("ln", new variable_reg(&next_line_number));
-  number_reg_dictionary.define("rsb", new variable_reg(&rsb_reg_contents));
-  number_reg_dictionary.define("rst", new variable_reg(&rst_reg_contents));
-  number_reg_dictionary.define("sb", new variable_reg(&sb_reg_contents));
-  number_reg_dictionary.define("skw", new variable_reg(&skw_reg_contents));
-  number_reg_dictionary.define("ssc", new variable_reg(&ssc_reg_contents));
-  number_reg_dictionary.define("st", new variable_reg(&st_reg_contents));
+  register_dictionary.define("ct", new variable_reg(&ct_reg_contents));
+  register_dictionary.define("hp", new horizontal_place_reg);
+  register_dictionary.define("ln", new variable_reg(&next_line_number));
+  register_dictionary.define("rsb", new variable_reg(&rsb_reg_contents));
+  register_dictionary.define("rst", new variable_reg(&rst_reg_contents));
+  register_dictionary.define("sb", new variable_reg(&sb_reg_contents));
+  register_dictionary.define("skw", new variable_reg(&skw_reg_contents));
+  register_dictionary.define("ssc", new variable_reg(&ssc_reg_contents));
+  register_dictionary.define("st", new variable_reg(&st_reg_contents));
 }
 
 // Hyphenation - TeX's hyphenation algorithm with a less fancy implementation.
@@ -3541,7 +3570,7 @@
 
 static void set_hyphenation_language()
 {
-  symbol nm = get_name(1);
+  symbol nm = get_name(true /* required */);
   if (!nm.is_null()) {
     current_language = (hyphenation_language *)language_dictionary.lookup(nm);
     if (!current_language) {
@@ -3566,12 +3595,13 @@
   unsigned char posWORD_MAX + 2;
   for (;;) {
     tok.skip();
-    if (tok.newline() || tok.eof())
+    if (tok.is_newline() || tok.is_eof())
       break;
     int i = 0;
     int npos = 0;
-    while (i < WORD_MAX && !tok.space() && !tok.newline() && !tok.eof()) {
-      charinfo *ci = tok.get_char(1);
+    while (i < WORD_MAX && !tok.is_space() && !tok.is_newline()
+	   && !tok.is_eof()) {
+      charinfo *ci = tok.get_char(true /* required */);
       if (ci == 0) {
 	skip_line();
 	return;
@@ -3596,7 +3626,7 @@
       tem = (unsigned char *)current_language->exceptions.lookup(symbol(buf),
 								 tem);
       if (tem)
-	a_delete tem;
+	delete tem;
     }
   }
   skip_line();
@@ -3610,7 +3640,7 @@
   trie_node(char, trie_node *);
 };
 
-trie_node::trie_node(char ch, trie_node *p) 
+trie_node::trie_node(char ch, trie_node *p)
 : c(ch), down(0), right(p), val(0)
 {
 }
@@ -3718,7 +3748,7 @@
     memcpy(tem, pos, npos + 1);
     tem = (unsigned char *)ex->lookup(symbol(buf), tem);
     if (tem)
-      a_delete tem;
+      delete tem;
   }
 }
 
@@ -3887,7 +3917,7 @@
 	  c = hpf_getc(fp);
 	if (c == '{') {
 	  if (have_patterns || have_hyphenation)
-	    error("\\patterns not allowed inside of %1 group",
+	    error("\\patterns is not allowed inside of %1 group",
 		  have_patterns ? "\\patterns" : "\\hyphenation");
 	  else {
 	    have_patterns = 1;
@@ -3902,7 +3932,7 @@
 	  c = hpf_getc(fp);
 	if (c == '{') {
 	  if (have_patterns || have_hyphenation)
-	    error("\\hyphenation not allowed inside of %1 group",
+	    error("\\hyphenation is not allowed inside of %1 group",
 		  have_patterns ? "\\patterns" : "\\hyphenation");
 	  else {
 	    have_hyphenation = 1;
@@ -3933,7 +3963,7 @@
       }
       else if (c == '{') {
 	if (have_patterns || have_hyphenation)
-	  error("'{' not allowed within %1 group",
+	  error("'{' is not allowed within %1 group",
 		have_patterns ? "\\patterns" : "\\hyphenation");
 	c = hpf_getc(fp);		// skipped if not starting \patterns
 					// or \hyphenation
@@ -4058,9 +4088,9 @@
   }
 }
 
-static void do_hyphenation_patterns_file(int append)
+static void do_hyphenation_patterns_file(bool append)
 {
-  symbol name = get_long_name(1);
+  symbol name = get_long_name(true /* required */);
   if (!name.is_null()) {
     if (!current_language)
       error("no current hyphenation language");
@@ -4074,12 +4104,12 @@
 
 static void hyphenation_patterns_file()
 {
-  do_hyphenation_patterns_file(0);
+  do_hyphenation_patterns_file(false /* append */);
 }
 
 static void hyphenation_patterns_file_append()
 {
-  do_hyphenation_patterns_file(1);
+  do_hyphenation_patterns_file(true /* append */);
 }
 
 class hyphenation_language_reg : public reg {
@@ -4098,5 +4128,11 @@
   init_request("hla", set_hyphenation_language);
   init_request("hpf", hyphenation_patterns_file);
   init_request("hpfa", hyphenation_patterns_file_append);
-  number_reg_dictionary.define(".hla", new hyphenation_language_reg);
+  register_dictionary.define(".hla", new hyphenation_language_reg);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/env.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/env.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -140,8 +139,6 @@
 void widow_control_request();
 #endif /* WIDOW_CONTROL */
 
-void do_divert(int append, int boxing);
-
 class environment {
   int dummy;			// dummy environment used for \w
   hunits prev_line_length;
@@ -281,6 +278,7 @@
   hunits get_digit_width();
   int get_font() { return fontno; };	// .f
   int get_zoom();			// .zoom
+  int get_numbering_nodes();		// .nm
   font_family *get_family() { return family; }
   int get_bold();			// .b
   int get_adjust_mode();		// .j
@@ -313,6 +311,7 @@
   hunits get_hyphenation_margin();
   int get_center_lines();
   int get_right_justify_lines();
+  int get_no_number_count();
   int get_prev_line_interrupted() { return prev_line_interrupted; }
   color *get_fill_color();
   color *get_glyph_color();
@@ -324,8 +323,8 @@
   node *extract_output_line();
   void width_registers();
   void wrap_up_tab();
-  void set_font(int);
-  void set_font(symbol);
+  bool set_font(int);
+  bool set_font(symbol);
   void set_family(symbol);
   void set_size(int);
   void set_char_height(int);
@@ -414,3 +413,9 @@
 extern int translate_space_to_dummy;
 
 extern unsigned char hpf_code_table;
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/hvunits.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/hvunits.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/input.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/input.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2022 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -17,8 +16,6 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-#define DEBUGGING
-
 #include "troff.h"
 #include "dictionary.h"
 #include "hvunits.h"
@@ -99,10 +96,11 @@
 static void disable_warning(const char *);
 
 static int escape_char = '\\';
-static symbol end_macro_name;
+static symbol end_of_input_macro_name;
 static symbol blank_line_macro_name;
 static symbol leading_spaces_macro_name;
 static int compatible_flag = 0;
+static int do_old_compatible_flag = -1;	// for .do request
 int ascii_output_flag = 0;
 int suppress_output_flag = 0;
 int is_html = 0;
@@ -112,10 +110,10 @@
 				// \O345, \R, \s, or \S has been processed
 				// in token::next()
 int old_have_input = 0;		// value of have_input right before \n
-int tcommand_flag = 0;
+bool device_has_tcommand = false;	// 't' output command supported
 int unsafe_flag = 0;		// safer by default
 
-int have_string_arg = 0;	// whether we have \*foo bar...
+bool have_multiple_params = false;	// e.g., \e aa, \*foo bar
 
 double spread_limit = -3.0 - 1.0;	// negative means deactivated
 
@@ -128,18 +126,18 @@
 // Defaults to the current directory.
 search_path include_search_path(0, 0, 0, 1);
 
-static int get_copy(node**, int = 0, int = 0);
+static int get_copy(node**, bool = false, bool = false);
 static void copy_mode_error(const char *,
 			    const errarg & = empty_errarg,
 			    const errarg & = empty_errarg,
 			    const errarg & = empty_errarg);
 
 enum read_mode { ALLOW_EMPTY, WITH_ARGS, NO_ARGS };
-static symbol read_escape_name(read_mode = NO_ARGS);
-static symbol read_long_escape_name(read_mode = NO_ARGS);
+static symbol read_escape_parameter(read_mode = NO_ARGS);
+static symbol read_long_escape_parameters(read_mode = NO_ARGS);
 static void interpolate_string(symbol);
 static void interpolate_string_with_args(symbol);
-static void interpolate_macro(symbol, int = 0);
+static void interpolate_macro(symbol, bool = false);
 static void interpolate_number_format(symbol);
 static void interpolate_environment_variable(symbol);
 
@@ -148,29 +146,26 @@
 static request_or_macro *lookup_request(symbol);
 static int get_delim_number(units *, unsigned char);
 static int get_delim_number(units *, unsigned char, units);
-static symbol do_get_long_name(int, char);
+static symbol do_get_long_name(bool, char);
 static int get_line_arg(units *res, unsigned char si, charinfo **cp);
-static int read_size(int *);
+static bool read_size(int *);
 static symbol get_delim_name();
 static void init_registers();
 static void trapping_blank_line();
 
-// this is for gcc 2.95 with old versions of libstdc++
-#define input_iterator my_input_iterator
-
 class input_iterator;
 input_iterator *make_temp_iterator(const char *);
 const char *input_char_description(int);
 
 void process_input_stack();
-void chop_macro();		// declare to avoid friend name injection
+void chop_macro();	// declare to avoid friend name injection
 
 
 void set_escape_char()
 {
   if (has_arg()) {
     if (tok.ch() == 0) {
-      error("bad escape character");
+      error("cannot select invalid escape character; using '\\'");
       escape_char = '\\';
     }
     else
@@ -354,7 +349,7 @@
     int c = getc(fp);
     if (c == EOF)
       break;
-    if (invalid_input_char(c))
+    if (is_invalid_input_char(c))
       warning(WARN_INPUT, "invalid input character code %1", int(c));
     else {
       *p++ = c;
@@ -379,7 +374,7 @@
 int file_iterator::peek()
 {
   int c = getc(fp);
-  while (invalid_input_char(c)) {
+  while (is_invalid_input_char(c)) {
     warning(WARN_INPUT, "invalid input character code %1", int(c));
     c = getc(fp);
   }
@@ -401,8 +396,13 @@
 
 void file_iterator::backtrace()
 {
-  errprint("%1:%2: backtrace: %3 '%1'\n", filename, lineno,
-	   popened ? "process" : "file");
+  const char *f;
+  int n;
+  // Get side effect of filename rewrite if stdin.
+  (void) get_location(0, &f, &n);
+  if (program_name)
+    fprintf(stderr, "%s: ", program_name);
+  errprint("backtrace: %3 '%1':%2\n", f, n, popened ? "pipe" : "file");
 }
 
 int file_iterator::set_location(const char *f, int ln)
@@ -433,7 +433,6 @@
   static int get_location(int, const char **, int *);
   static int set_location(const char *, int);
   static void backtrace();
-  static void backtrace_all();
   static void next_file(FILE *, const char *);
   static void end_file();
   static void shift(int n);
@@ -465,7 +464,7 @@
 int input_stack::level = 0;
 int input_stack::limit = DEFAULT_INPUT_STACK_LIMIT;
 int input_stack::div_level = 0;
-statem *input_stack::diversion_state = NULL;
+statem *input_stack::diversion_state = 0;
 int suppress_push=0;
 
 
@@ -622,8 +621,8 @@
 
 statem *input_stack::get_diversion_state()
 {
-  if (diversion_state == NULL)
-    return NULL;
+  if (0 == diversion_state)
+    return 0;
   else
     return new statem(diversion_state);
 }
@@ -696,17 +695,6 @@
 
 void input_stack::backtrace()
 {
-  const char *f;
-  int n;
-  // only backtrace down to (not including) the topmost file
-  for (input_iterator *p = top;
-       p && !p->get_location(0, &f, &n);
-       p = p->next)
-    p->backtrace();
-}
-
-void input_stack::backtrace_all()
-{
   for (input_iterator *p = top; p; p = p->next)
     p->backtrace();
 }
@@ -794,7 +782,7 @@
 
 void backtrace_request()
 {
-  input_stack::backtrace_all();
+  input_stack::backtrace();
   fflush(stderr);
   skip_line();
 }
@@ -802,7 +790,7 @@
 void next_file()
 {
   symbol nm = get_long_name();
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (nm.is_null())
     input_stack::end_file();
@@ -826,15 +814,16 @@
   skip_line();
 }
 
-static char get_char_for_escape_name(int allow_space = 0)
+static char get_char_for_escape_parameter(bool allow_space = false)
 {
-  int c = get_copy(0, 0, 1);
+  int c = get_copy(0 /* nullptr */, false /* is defining */,
+		   true /* handle \E */);
   switch (c) {
   case EOF:
-    copy_mode_error("end of input in escape name");
+    copy_mode_error("end of input in escape sequence");
     return '\0';
   default:
-    if (!invalid_input_char(c))
+    if (!is_invalid_input_char(c))
       break;
     // fall through
   case '\n':
@@ -848,19 +837,19 @@
   case '\t':
   case '\001':
   case '\b':
-    copy_mode_error("%1 is not allowed in an escape name",
+    copy_mode_error("%1 is not allowed in an escape sequence parameter",
 		    input_char_description(c));
     return '\0';
   }
   return c;
 }
 
-static symbol read_two_char_escape_name()
+static symbol read_two_char_escape_parameter()
 {
   char buf3;
-  buf0 = get_char_for_escape_name();
+  buf0 = get_char_for_escape_parameter();
   if (buf0 != '\0') {
-    buf1 = get_char_for_escape_name();
+    buf1 = get_char_for_escape_parameter();
     if (buf1 == '\0')
       buf0 = 0;
     else
@@ -869,7 +858,7 @@
   return symbol(buf);
 }
 
-static symbol read_long_escape_name(read_mode mode)
+static symbol read_long_escape_parameters(read_mode mode)
 {
   int start_level = input_stack::get_level();
   char abufABUF_SIZE;
@@ -879,10 +868,10 @@
   char c;
   int have_char = 0;
   for (;;) {
-    c = get_char_for_escape_name(have_char && mode == WITH_ARGS);
+    c = get_char_for_escape_parameter(have_char && mode == WITH_ARGS);
     if (c == 0) {
       if (buf != abuf)
-	a_delete buf;
+	delete buf;
       return NULL_SYMBOL;
     }
     have_char = 1;
@@ -899,7 +888,7 @@
 	buf = new charbuf_size*2;
 	memcpy(buf, old_buf, buf_size);
 	buf_size *= 2;
-	a_delete old_buf;
+	delete old_buf;
       }
     }
     if (c == '' && input_stack::get_level() == start_level)
@@ -908,7 +897,7 @@
   }
   bufi = 0;
   if (c == ' ')
-    have_string_arg = 1;
+    have_multiple_params = true;
   if (buf == abuf) {
     if (i == 0) {
       if (mode != ALLOW_EMPTY)
@@ -919,46 +908,46 @@
   }
   else {
     symbol s(buf);
-    a_delete buf;
+    delete buf;
     return s;
   }
 }
 
-static symbol read_escape_name(read_mode mode)
+static symbol read_escape_parameter(read_mode mode)
 {
-  char c = get_char_for_escape_name();
+  char c = get_char_for_escape_parameter();
   if (c == 0)
     return NULL_SYMBOL;
   if (c == '(')
-    return read_two_char_escape_name();
+    return read_two_char_escape_parameter();
   if (c == '' && !compatible_flag)
-    return read_long_escape_name(mode);
+    return read_long_escape_parameters(mode);
   char buf2;
   buf0 = c;
   buf1 = '\0';
   return symbol(buf);
 }
 
-static symbol read_increment_and_escape_name(int *incp)
+static symbol read_increment_and_escape_parameter(int *incp)
 {
-  char c = get_char_for_escape_name();
+  char c = get_char_for_escape_parameter();
   switch (c) {
   case 0:
     *incp = 0;
     return NULL_SYMBOL;
   case '(':
     *incp = 0;
-    return read_two_char_escape_name();
+    return read_two_char_escape_parameter();
   case '+':
     *incp = 1;
-    return read_escape_name();
+    return read_escape_parameter();
   case '-':
     *incp = -1;
-    return read_escape_name();
+    return read_escape_parameter();
   case '':
     if (!compatible_flag) {
       *incp = 0;
-      return read_long_escape_name();
+      return read_long_escape_parameters();
     }
     break;
   }
@@ -969,7 +958,7 @@
   return symbol(buf);
 }
 
-static int get_copy(node **nd, int defining, int handle_escape_E)
+static int get_copy(node **nd, bool is_defining, bool handle_escape_E)
 {
   for (;;) {
     int c = input_stack::get(nd);
@@ -1000,7 +989,7 @@
     if (c == ESCAPE_E && handle_escape_E)
       c = escape_char;
     if (c == ESCAPE_NEWLINE) {
-      if (defining)
+      if (is_defining)
 	return c;
       do {
 	c = input_stack::get(nd);
@@ -1027,7 +1016,7 @@
     case '$':
       {
 	(void)input_stack::get(0);
-	symbol s = read_escape_name();
+	symbol s = read_escape_parameter();
 	if (!(s.is_null() || s.is_empty()))
 	  interpolate_arg(s);
 	break;
@@ -1035,10 +1024,10 @@
     case '*':
       {
 	(void)input_stack::get(0);
-	symbol s = read_escape_name(WITH_ARGS);
+	symbol s = read_escape_parameter(WITH_ARGS);
 	if (!(s.is_null() || s.is_empty())) {
-	  if (have_string_arg) {
-	    have_string_arg = 0;
+	  if (have_multiple_params) {
+	    have_multiple_params = false;
 	    interpolate_string_with_args(s);
 	  }
 	  else
@@ -1061,7 +1050,7 @@
       {
 	(void)input_stack::get(0);
 	int inc;
-	symbol s = read_increment_and_escape_name(&inc);
+	symbol s = read_increment_and_escape_parameter(&inc);
 	if (!(s.is_null() || s.is_empty()))
 	  interpolate_number_reg(s, inc);
 	break;
@@ -1069,7 +1058,7 @@
     case 'g':
       {
 	(void)input_stack::get(0);
-	symbol s = read_escape_name();
+	symbol s = read_escape_parameter();
 	if (!(s.is_null() || s.is_empty()))
 	  interpolate_number_format(s);
 	break;
@@ -1080,14 +1069,14 @@
     case 'V':
       {
 	(void)input_stack::get(0);
-	symbol s = read_escape_name();
+	symbol s = read_escape_parameter();
 	if (!(s.is_null() || s.is_empty()))
 	  interpolate_environment_variable(s);
 	break;
       }
     case '\n':
       (void)input_stack::get(0);
-      if (defining)
+      if (is_defining)
 	return ESCAPE_NEWLINE;
       break;
     case ' ':
@@ -1140,7 +1129,7 @@
       return ESCAPE_RIGHT_PARENTHESIS;
     case '.':
       (void)input_stack::get(0);
-      return c;			
+      return c;
     case '%':
       (void)input_stack::get(0);
       return ESCAPE_PERCENT;
@@ -1283,7 +1272,8 @@
   color *col = new color;
   if (*s == '#') {
     if (!col->read_rgb(s)) {
-      warning(WARN_COLOR, "expecting rgb color definition not '%1'", s);
+      warning(WARN_COLOR, "expecting rgb color definition,"
+	      " not '%1'", s);
       delete col;
       return 0;
     }
@@ -1312,7 +1302,8 @@
   color *col = new color;
   if (*s == '#') {
     if (!col->read_cmy(s)) {
-      warning(WARN_COLOR, "expecting cmy color definition not '%1'", s);
+      warning(WARN_COLOR, "expecting cmy color definition,"
+	      " not '%1'", s);
       delete col;
       return 0;
     }
@@ -1341,7 +1332,8 @@
   color *col = new color;
   if (*s == '#') {
     if (!col->read_cmyk(s)) {
-      warning(WARN_COLOR, "expecting a cmyk color definition not '%1'", s);
+      warning(WARN_COLOR, "expecting cmyk color definition,"
+	      " not '%1'", s);
       delete col;
       return 0;
     }
@@ -1364,14 +1356,15 @@
 {
   symbol component = do_get_long_name(0, end);
   if (component.is_null()) {
-    warning(WARN_COLOR, "missing gray values");
+    warning(WARN_COLOR, "missing gray value");
     return 0;
   }
   const char *s = component.contents();
   color *col = new color;
   if (*s == '#') {
     if (!col->read_gray(s)) {
-      warning(WARN_COLOR, "expecting a gray definition not '%1'", s);
+      warning(WARN_COLOR, "expecting gray definition,"
+	      " not '%1'", s);
       delete col;
       return 0;
     }
@@ -1399,7 +1392,7 @@
 
 static void define_color()
 {
-  symbol color_name = get_long_name(1);
+  symbol color_name = get_long_name(true /* required */);
   if (color_name.is_null()) {
     skip_line();
     return;
@@ -1409,7 +1402,7 @@
     skip_line();
     return;
   }
-  symbol style = get_long_name(1);
+  symbol style = get_long_name(true /* required */);
   if (style.is_null()) {
     skip_line();
     return;
@@ -1426,9 +1419,8 @@
   else if (strcmp(style.contents(), "cmy") == 0)
     col = read_cmy();
   else {
-    warning(WARN_COLOR,
-	    "unknown color space '%1'; use rgb, cmyk, gray or cmy",
-	    style.contents());
+    warning(WARN_COLOR, "unknown color space '%1';"
+	    " use 'rgb', 'cmyk', 'gray' or 'cmy'", style.contents());
     skip_line();
     return;
   }
@@ -1441,30 +1433,36 @@
 
 node *do_overstrike()
 {
-  token start;
   overstrike_node *on = new overstrike_node;
   int start_level = input_stack::get_level();
+  token start;
   start.next();
   for (;;) {
     tok.next();
-    if (tok.newline() || tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline()) {
+      input_stack::push(make_temp_iterator("\n"));
+      break;
+    }
+    if (tok.is_eof()) {
+      warning(WARN_DELIM, "missing closing delimiter in overstrike"
+	     " escape sequence (got %1)", tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
     if (tok == start
 	&& (compatible_flag || input_stack::get_level() == start_level))
       break;
-    if (tok.horizontal_space())
+    if (tok.is_horizontal_space())
       on->overstrike(tok.nd->copy());
-    else if (tok.unstretchable_space())
+    else if (tok.is_unstretchable_space())
     {
       node *n = new hmotion_node(curenv->get_space_width(),
 				 curenv->get_fill_color());
       on->overstrike(n);
     }
     else {
-      charinfo *ci = tok.get_char(1);
+      charinfo *ci = tok.get_char(true /* required */);
       if (ci) {
 	node *n = curenv->make_char_node(ci);
 	if (n)
@@ -1477,25 +1475,28 @@
 
 static node *do_bracket()
 {
-  token start;
   bracket_node *bn = new bracket_node;
-  start.next();
   int start_level = input_stack::get_level();
+  token start;
+  start.next();
   for (;;) {
     tok.next();
-    if (tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline()) {
+      input_stack::push(make_temp_iterator("\n"));
       break;
     }
-    if (tok.newline()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_eof()) {
+      warning(WARN_DELIM, "missing closing delimiter in"
+	      " bracket-building escape sequence (got %1)",
+	      tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
     if (tok == start
 	&& (compatible_flag || input_stack::get_level() == start_level))
       break;
-    charinfo *ci = tok.get_char(1);
+    charinfo *ci = tok.get_char(true /* required */);
     if (ci) {
       node *n = curenv->make_char_node(ci);
       if (n)
@@ -1507,15 +1508,19 @@
 
 static int do_name_test()
 {
+  int start_level = input_stack::get_level();
   token start;
   start.next();
-  int start_level = input_stack::get_level();
-  int bad_char = 0;
-  int some_char = 0;
+  bool got_bad_char = false;
+  bool got_some_char = false;
   for (;;) {
     tok.next();
-    if (tok.newline() || tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline() || tok.is_eof()) {
+      if (tok != start)
+	warning(WARN_DELIM, "missing closing delimiter in identifier"
+		" validation escape sequence (got %1)",
+		tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
@@ -1523,10 +1528,10 @@
 	&& (compatible_flag || input_stack::get_level() == start_level))
       break;
     if (!tok.ch())
-      bad_char = 1;
-    some_char = 1;
+      got_bad_char = true;
+    got_some_char = true;
   }
-  return some_char && !bad_char;
+  return (got_some_char && !got_bad_char);
 }
 
 static int do_expr_test()
@@ -1534,7 +1539,7 @@
   token start;
   start.next();
   int start_level = input_stack::get_level();
-  if (!start.delimiter(1))
+  if (!start.usable_as_delimiter(true /* report error */))
     return 0;
   tok.next();
   // disable all warning and error messages temporarily
@@ -1551,8 +1556,10 @@
   // ignore everything up to the delimiter in case we aren't right there
   for (;;) {
     tok.next();
-    if (tok.newline() || tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline() || tok.is_eof()) {
+      warning(WARN_DELIM, "missing closing delimiter in"
+	      " expression test escape sequence (got %1)",
+	      tok.description());
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
@@ -1573,7 +1580,7 @@
   curenv = &env;
   for (;;) {
     tok.next();
-    if (tok.newline() || tok.eof()) {
+    if (tok.is_newline() || tok.is_eof()) {
       error("missing closing delimiter");
       break;
     }
@@ -1602,21 +1609,25 @@
 static node *do_zero_width()
 {
   node *rev = new dummy_node;
+  int start_level = input_stack::get_level();
   token start;
   start.next();
-  int start_level = input_stack::get_level();
   for (;;) {
     tok.next();
-    if (tok.newline() || tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline() || tok.is_eof()) {
+      if (tok != start)
+	warning(WARN_DELIM, "missing closing delimiter in"
+		" zero-width escape sequence (got %1)",
+		tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
     if (tok == start
 	&& (compatible_flag || input_stack::get_level() == start_level))
       break;
-    if (!tok.add_to_node_list(&rev))
-      error("invalid token in argument to \\Z");
+    if (!tok.add_to_zero_width_node_list(&rev))
+      error("invalid token in argument to escaped 'Z'");
   }
   node *n = 0;
   while (rev) {
@@ -1713,15 +1724,15 @@
 
 void token::skip()
 {
-  while (space())
+  while (is_space())
     next();
 }
 
-int has_arg()
+bool has_arg()
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
-  return !tok.newline();
+  return !tok.is_newline();
 }
 
 void token::make_space()
@@ -1745,8 +1756,14 @@
     node *n = 0;
     int cc = input_stack::get(&n);
     if (cc != escape_char || escape_char == 0) {
-    handle_normal_char:
+    handle_ordinary_char:
       switch(cc) {
+      case INPUT_NO_BREAK_SPACE:
+	  type = TOKEN_STRETCHABLE_SPACE;
+	  return;
+      case INPUT_SOFT_HYPHEN:
+	  type = TOKEN_HYPHEN_INDICATOR;
+	  return;
       case PUSH_GROFF_MODE:
 	input_stack::save_compatible_flag(compatible_flag);
 	compatible_flag = 0;
@@ -1919,7 +1936,7 @@
       cc = input_stack::get(&n);
       switch(cc) {
       case '(':
-	nm = read_two_char_escape_name();
+	nm = read_two_char_escape_parameter();
 	type = TOKEN_SPECIAL;
 	return;
       case EOF:
@@ -1983,17 +2000,17 @@
 	break;
       case '$':
 	{
-	  symbol s = read_escape_name();
+	  symbol s = read_escape_parameter();
 	  if (!(s.is_null() || s.is_empty()))
 	    interpolate_arg(s);
 	  break;
 	}
       case '*':
 	{
-	  symbol s = read_escape_name(WITH_ARGS);
+	  symbol s = read_escape_parameter(WITH_ARGS);
 	  if (!(s.is_null() || s.is_empty())) {
-	    if (have_string_arg) {
-	      have_string_arg = 0;
+	    if (have_multiple_params) {
+	      have_multiple_params = false;
 	      interpolate_string_with_args(s);
 	    }
 	    else
@@ -2042,24 +2059,30 @@
 	goto handle_escape_char;
       case 'f':
 	{
-	  symbol s = read_escape_name(ALLOW_EMPTY);
+	  symbol s = read_escape_parameter(ALLOW_EMPTY);
 	  if (s.is_null())
 	    break;
 	  const char *p;
 	  for (p = s.contents(); *p != '\0'; p++)
 	    if (!csdigit(*p))
 	      break;
-	  if (*p || s.is_empty())
-	    curenv->set_font(s);
+	  // environment::set_font warns if a bogus mounting position is
+	  // requested.  We must warn here if a bogus font name is
+	  // selected.
+	  if (*p != '\0' || s.is_empty()) {
+	    if (!curenv->set_font(s))
+	      warning(WARN_FONT, "cannot select font '%1'",
+		      s.contents());
+	  }
 	  else
-	    curenv->set_font(atoi(s.contents()));
+	    (void) curenv->set_font(atoi(s.contents()));
 	  if (!compatible_flag)
 	    have_input = 1;
 	  break;
 	}
       case 'F':
 	{
-	  symbol s = read_escape_name(ALLOW_EMPTY);
+	  symbol s = read_escape_parameter(ALLOW_EMPTY);
 	  if (s.is_null())
 	    break;
 	  curenv->set_family(s);
@@ -2068,7 +2091,7 @@
 	}
       case 'g':
 	{
-	  symbol s = read_escape_name();
+	  symbol s = read_escape_parameter();
 	  if (!(s.is_null() || s.is_empty()))
 	    interpolate_number_format(s);
 	  break;
@@ -2094,7 +2117,7 @@
 	  have_input = 1;
 	break;
       case 'k':
-	nm = read_escape_name();
+	nm = read_escape_parameter();
 	if (nm.is_null() || nm.is_empty())
 	  break;
 	type = TOKEN_MARK_INPUT;
@@ -2116,19 +2139,19 @@
 	  return;
 	}
       case 'm':
-	do_glyph_color(read_escape_name(ALLOW_EMPTY));
+	do_glyph_color(read_escape_parameter(ALLOW_EMPTY));
 	if (!compatible_flag)
 	  have_input = 1;
 	break;
       case 'M':
-	do_fill_color(read_escape_name(ALLOW_EMPTY));
+	do_fill_color(read_escape_parameter(ALLOW_EMPTY));
 	if (!compatible_flag)
 	  have_input = 1;
 	break;
       case 'n':
 	{
 	  int inc;
-	  symbol s = read_increment_and_escape_name(&inc);
+	  symbol s = read_increment_and_escape_parameter(&inc);
 	  if (!(s.is_null() || s.is_empty()))
 	    interpolate_number_reg(s, inc);
 	  break;
@@ -2147,7 +2170,7 @@
 	type = TOKEN_NODE;
 	return;
       case 'O':
-	nd = do_suppress(read_escape_name());
+	nd = do_suppress(read_escape_parameter());
 	if (!nd)
 	  break;
 	type = TOKEN_NODE;
@@ -2193,7 +2216,7 @@
 	return;
       case 'V':
 	{
-	  symbol s = read_escape_name();
+	  symbol s = read_escape_parameter();
 	  if (!(s.is_null() || s.is_empty()))
 	    interpolate_environment_variable(s);
 	  break;
@@ -2215,7 +2238,7 @@
 	return;
       case 'Y':
 	{
-	  symbol s = read_escape_name();
+	  symbol s = read_escape_parameter();
 	  if (s.is_null() || s.is_empty())
 	    break;
 	  request_or_macro *p = lookup_request(s);
@@ -2234,7 +2257,7 @@
 	  if (type == TOKEN_NODE || type == TOKEN_HORIZONTAL_SPACE)
 	    nd = new zero_width_node(nd);
 	  else {
-  	    charinfo *ci = get_char(1);
+	    charinfo *ci = get_char(true /* required */);
 	    if (ci == 0)
 	      break;
 	    node *gn = curenv->make_char_node(ci);
@@ -2259,11 +2282,11 @@
 	break;
       case '':
 	if (!compatible_flag) {
-	  symbol s = read_long_escape_name(WITH_ARGS);
+	  symbol s = read_long_escape_parameters(WITH_ARGS);
 	  if (s.is_null() || s.is_empty())
 	    break;
-	  if (have_string_arg) {
-	    have_string_arg = 0;
+	  if (have_multiple_params) {
+	    have_multiple_params = false;
 	    nm = composite_glyph_name(s);
 	  }
 	  else {
@@ -2280,7 +2303,7 @@
 		strcpy(buf, "u");
 		strcat(buf, gn);
 		nm = symbol(buf);
-		a_delete buf;
+		delete buf;
 	      }
 	    }
 	    else
@@ -2289,12 +2312,12 @@
 	  type = TOKEN_SPECIAL;
 	  return;
 	}
-	goto handle_normal_char;
+	goto handle_ordinary_char;
       default:
 	if (cc != escape_char && cc != '.')
 	  warning(WARN_ESCAPE, "escape character ignored before %1",
 		  input_char_description(cc));
-	goto handle_normal_char;
+	goto handle_ordinary_char;
       }
     }
   }
@@ -2323,7 +2346,7 @@
 
 // is token a suitable delimiter (like ')?
 
-int token::delimiter(int err)
+bool token::usable_as_delimiter(bool report_error)
 {
   switch(type) {
   case TOKEN_CHAR:
@@ -2351,28 +2374,29 @@
     case '(':
     case ')':
     case '.':
-      if (err)
-        error("cannot use character '%1' as a starting delimiter", char(c));
-      return 0;
+      if (report_error)
+        error("character '%1' is not allowed as a starting delimiter",
+	      char(c));
+      return false;
     default:
-      return 1;
+      return true;
     }
   case TOKEN_NODE:
     // the user doesn't know what a node is
-    if (err)
+    if (report_error)
       error("missing argument or invalid starting delimiter");
-    return 0;
+    return false;
   case TOKEN_SPACE:
   case TOKEN_STRETCHABLE_SPACE:
   case TOKEN_UNSTRETCHABLE_SPACE:
   case TOKEN_HORIZONTAL_SPACE:
   case TOKEN_TAB:
   case TOKEN_NEWLINE:
-    if (err)
-      error("cannot use %1 as a starting delimiter", description());
-    return 0;
+    if (report_error)
+      error("%1 is not allowed as a starting delimiter", description());
+    return false;
   default:
-    return 1;
+    return true;
   }
 }
 
@@ -2383,55 +2407,59 @@
   case TOKEN_BACKSPACE:
     return "a backspace character";
   case TOKEN_CHAR:
-    buf0 = '\'';
-    buf1 = c;
-    buf2 = '\'';
-    buf3 = '\0';
-    return buf;
+    if (c == INPUT_DELETE)
+      return "a delete character";
+    else {
+      buf0 = '\'';
+      buf1 = c;
+      buf2 = '\'';
+      buf3 = '\0';
+      return buf;
+    }
   case TOKEN_DUMMY:
-    return "'\\&'";
+    return "an escaped '&'";
   case TOKEN_ESCAPE:
-    return "'\\e'";
+    return "an escaped 'e'";
   case TOKEN_HYPHEN_INDICATOR:
-    return "'\\%'";
+    return "an escaped '%'";
   case TOKEN_INTERRUPT:
-    return "'\\c'";
+    return "an escaped 'c'";
   case TOKEN_ITALIC_CORRECTION:
-    return "'\\/'";
+    return "an escaped '/'";
   case TOKEN_LEADER:
     return "a leader character";
   case TOKEN_LEFT_BRACE:
-    return "'\\{'";
+    return "an escaped '{'";
   case TOKEN_MARK_INPUT:
-    return "'\\k'";
+    return "an escaped 'k'";
   case TOKEN_NEWLINE:
-    return "newline";
+    return "a newline";
   case TOKEN_NODE:
     return "a node";
   case TOKEN_NUMBERED_CHAR:
-    return "'\\N'";
+    return "an escaped 'N'";
   case TOKEN_RIGHT_BRACE:
-    return "'\\}'";
+    return "an escaped '}'";
   case TOKEN_SPACE:
     return "a space";
   case TOKEN_SPECIAL:
     return "a special character";
   case TOKEN_SPREAD:
-    return "'\\p'";
+    return "an escaped 'p'";
   case TOKEN_STRETCHABLE_SPACE:
-    return "'\\~'";
+    return "an escaped '~'";
   case TOKEN_UNSTRETCHABLE_SPACE:
-    return "'\\ '";
+    return "an escaped ' '";
   case TOKEN_HORIZONTAL_SPACE:
-    return "a horizontal space";
+    return "a horizontal motion";
   case TOKEN_TAB:
     return "a tab character";
   case TOKEN_TRANSPARENT:
-    return "'\\!'";
+    return "an escaped '!'";
   case TOKEN_TRANSPARENT_DUMMY:
-    return "'\\)'";
+    return "an escaped ')'";
   case TOKEN_ZERO_WIDTH_BREAK:
-    return "'\\:'";
+    return "an escaped ':'";
   case TOKEN_EOF:
     return "end of input";
   default:
@@ -2442,8 +2470,8 @@
 
 void skip_line()
 {
-  while (!tok.newline())
-    if (tok.eof())
+  while (!tok.is_newline())
+    if (tok.is_eof())
       return;
     else
       tok.next();
@@ -2460,38 +2488,39 @@
   skip_line();
 }
 
-static void empty_name_warning(int required)
+static void diagnose_missing_identifier(bool required)
 {
-  if (tok.newline() || tok.eof()) {
+  if (tok.is_newline() || tok.is_eof()) {
     if (required)
-      warning(WARN_MISSING, "missing name");
+      warning(WARN_MISSING, "missing identifier");
   }
-  else if (tok.right_brace() || tok.tab()) {
+  else if (tok.is_right_brace() || tok.is_tab()) {
     const char *start = tok.description();
     do {
       tok.next();
-    } while (tok.space() || tok.right_brace() || tok.tab());
-    if (!tok.newline() && !tok.eof())
+    } while (tok.is_space() || tok.is_right_brace() || tok.is_tab());
+    if (!tok.is_newline() && !tok.is_eof())
       error("%1 is not allowed before an argument", start);
     else if (required)
-      warning(WARN_MISSING, "missing name");
+      warning(WARN_MISSING, "missing identifier");
   }
   else if (required)
-    error("name expected (got %1)", tok.description());
+    error("expected identifier, got %1", tok.description());
   else
-    error("name expected (got %1): treated as missing", tok.description());
+    error("expected identifier, got %1; treated as missing",
+	  tok.description());
 }
 
-static void non_empty_name_warning()
+static void diagnose_invalid_identifier()
 {
-  if (!tok.newline() && !tok.eof() && !tok.space() && !tok.tab()
-      && !tok.right_brace()
+  if (!tok.is_newline() && !tok.is_eof() && !tok.is_space()
+      && !tok.is_tab() && !tok.is_right_brace()
       // We don't want to give a warning for .el\{
-      && !tok.left_brace())
-    error("%1 is not allowed in a name", tok.description());
+      && !tok.is_left_brace())
+    error("%1 is not allowed in an identifier", tok.description());
 }
 
-symbol get_name(int required)
+symbol get_name(bool required)
 {
   if (compatible_flag) {
     char buf3;
@@ -2503,11 +2532,11 @@
 	tok.make_space();
       }
       else
-	non_empty_name_warning();
+	diagnose_invalid_identifier();
       return symbol(buf);
     }
     else {
-      empty_name_warning(required);
+      diagnose_missing_identifier(required);
       return NULL_SYMBOL;
     }
   }
@@ -2515,14 +2544,14 @@
     return get_long_name(required);
 }
 
-symbol get_long_name(int required)
+symbol get_long_name(bool required)
 {
   return do_get_long_name(required, 0);
 }
 
-static symbol do_get_long_name(int required, char end)
+static symbol do_get_long_name(bool required, char end)
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
   char abufABUF_SIZE;
   char *buf = abuf;
@@ -2541,7 +2570,7 @@
 	buf = new charbuf_size*2;
 	memcpy(buf, old_buf, buf_size);
 	buf_size *= 2;
-	a_delete old_buf;
+	delete old_buf;
       }
     }
     if ((bufi = tok.ch()) == 0 || bufi == end)
@@ -2550,28 +2579,28 @@
     tok.next();
   }
   if (i == 0) {
-    empty_name_warning(required);
+    diagnose_missing_identifier(required);
     return NULL_SYMBOL;
   }
   if (end && bufi == end)
     bufi+1 = '\0';
   else
-    non_empty_name_warning();
+    diagnose_invalid_identifier();
   if (buf == abuf)
     return symbol(buf);
   else {
     symbol s(buf);
-    a_delete buf;
+    delete buf;
     return s;
   }
 }
 
 void exit_troff()
 {
-  exit_started = 1;
+  is_exit_underway = true;
   topdiv->set_last_page();
-  if (!end_macro_name.is_null()) {
-    spring_trap(end_macro_name);
+  if (!end_of_input_macro_name.is_null()) {
+    spring_trap(end_of_input_macro_name);
     tok.next();
     process_input_stack();
   }
@@ -2580,7 +2609,7 @@
   process_input_stack();
   end_diversions();
   if (topdiv->get_page_length() > 0) {
-    done_end_macro = 1;
+    is_eoi_macro_finished = true;
     topdiv->set_ejecting();
     static unsigned char buf2 = { LAST_PAGE_EJECTOR, '\0' };
     input_stack::push(make_temp_iterator((char *)buf));
@@ -2594,9 +2623,7 @@
     tok.next();
     process_input_stack();
   }
-  // This will only happen if a trap-invoked macro starts a diversion,
-  // or if vertical position traps have been disabled.
-  cleanup_and_exit(0);
+  cleanup_and_exit(EXIT_SUCCESS);
 }
 
 // This implements .ex.  The input stack must be cleared before calling
@@ -2605,7 +2632,7 @@
 void exit_request()
 {
   input_stack::clear();
-  if (exit_started)
+  if (is_exit_underway)
     tok.next();
   else
     exit_troff();
@@ -2619,9 +2646,9 @@
   tok.next();
 }
 
-void end_macro()
+void eoi_macro()
 {
-  end_macro_name = get_name();
+  end_of_input_macro_name = get_name();
   skip_line();
 }
 
@@ -2647,14 +2674,16 @@
 
 void do_request()
 {
-  int old_compatible_flag = compatible_flag;
+  assert(do_old_compatible_flag == -1);
+  do_old_compatible_flag = compatible_flag;
   compatible_flag = 0;
   symbol nm = get_name();
   if (nm.is_null())
     skip_line();
   else
-    interpolate_macro(nm, 1);
-  compatible_flag = old_compatible_flag;
+    interpolate_macro(nm, true /* don't want next token */);
+  compatible_flag = do_old_compatible_flag;
+  do_old_compatible_flag = -1;
   request_or_macro *p = lookup_request(nm);
   macro *m = p->to_macro();
   if (m)
@@ -2673,7 +2702,7 @@
 
 static int transparent_translate(int cc)
 {
-  if (!invalid_input_char(cc)) {
+  if (!is_invalid_input_char(cc)) {
     charinfo *ci = charset_tablecc;
     switch (ci->get_special_translation(1)) {
     case charinfo::TRANSLATE_SPACE:
@@ -2691,10 +2720,12 @@
       int c = ci->get_ascii_code();
       if (c != '\0')
 	return c;
-      error("can't translate %1 to special character '%2'"
-	    " in transparent throughput",
-	    input_char_description(cc),
-	    ci->nm.contents());
+      if (getenv("GROFF_ENABLE_TRANSPARENCY_WARNINGS")
+	  != 0 /* nullptr */)
+	error("can't translate %1 to special character '%2'"
+	      " in transparent throughput",
+	      input_char_description(cc),
+	      ci->nm.contents());
     }
   }
   return cc;
@@ -2822,7 +2853,7 @@
 	  // skip tabs as well as spaces here
 	  do {
 	    tok.next();
-	  } while (tok.white_space());
+	  } while (tok.is_white_space());
 	  symbol nm = get_name();
 #if defined(DEBUGGING)
 	  if (debug_state) {
@@ -2947,8 +2978,8 @@
 	  do {
 	    nspaces += tok.nspaces();
 	    tok.next();
-	  } while (tok.space());
-	  if (tok.newline())
+	  } while (tok.is_space());
+	  if (tok.is_newline())
 	    trapping_blank_line();
 	  else {
 	    push_token(tok);
@@ -3052,7 +3083,7 @@
 
 void flush_pending_lines()
 {
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   curenv->output_pending_lines();
   tok.next();
@@ -3073,7 +3104,7 @@
 {
 }
 
-void request::invoke(symbol, int)
+void request::invoke(symbol, bool)
 {
   (*p)();
 }
@@ -3571,7 +3602,10 @@
 void string_iterator::backtrace()
 {
   if (mac.filename) {
-    errprint("%1:%2: backtrace", mac.filename, mac.lineno + lineno - 1);
+    if (program_name)
+      fprintf(stderr, "%s: ", program_name);
+    errprint("backtrace: '%1':%2", mac.filename,
+	     mac.lineno + lineno - 1);
     if (how_invoked) {
       if (!nm.is_null())
 	errprint(": %1 '%2'\n", how_invoked, nm.contents());
@@ -3605,7 +3639,7 @@
 
 temp_iterator::~temp_iterator()
 {
-  a_delete base;
+  delete base;
 }
 
 
@@ -3769,7 +3803,7 @@
   return 1;
 }
 
-static void interpolate_macro(symbol nm, int no_next)
+static void interpolate_macro(symbol nm, bool do_not_want_next_token)
 {
   request_or_macro *p = (request_or_macro *)request_dictionary.lookup(nm);
   if (p == 0) {
@@ -3798,7 +3832,7 @@
     }
   }
   if (p)
-    p->invoke(nm, no_next);
+    p->invoke(nm, do_not_want_next_token);
   else {
     skip_line();
     return;
@@ -3807,7 +3841,7 @@
 
 static void decode_args(macro_iterator *mi)
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     node *n;
     int c = get_copy(&n);
     for (;;) {
@@ -3907,14 +3941,14 @@
   }
 }
 
-void macro::invoke(symbol nm, int no_next)
+void macro::invoke(symbol nm, bool do_not_want_next_token)
 {
   macro_iterator *mi = new macro_iterator(nm, *this);
   decode_args(mi);
   input_stack::push(mi);
   // we must delay tok.next() in case the function has been called by
   // do_request to assure proper handling of compatible_flag
-  if (!no_next)
+  if (!do_not_want_next_token)
     tok.next();
 }
 
@@ -3958,7 +3992,7 @@
 
 void composite_request()
 {
-  symbol from = get_name(1);
+  symbol from = get_name(true /* required */);
   if (!from.is_null()) {
     const char *from_gn = glyph_name_to_unicode(from.contents());
     if (!from_gn) {
@@ -3972,7 +4006,7 @@
     const char *from_decomposed = decompose_unicode(from_gn);
     if (from_decomposed)
       from_gn = &from_decomposed1;
-    symbol to = get_name(1);
+    symbol to = get_name(true /* required */);
     if (to.is_null())
       composite_dictionary.remove(symbol(from_gn));
     else {
@@ -4066,11 +4100,14 @@
   static char buf22 = { END_TRAP, '\0' };
   input_stack::push(make_temp_iterator(buf2));
   request_or_macro *p = lookup_request(nm);
+  // We don't perform this validation at the time the trap is planted
+  // because a request name might be replaced by a macro by the time the
+  // trap springs.
   macro *m = p->to_macro();
   if (m)
-    input_stack::push(new macro_iterator(nm, *m, "trap-invoked macro"));
+    input_stack::push(new macro_iterator(nm, *m, "trap-called macro"));
   else
-    error("you can't invoke a request with a trap");
+    error("trap failed to spring: '%1' is a request", nm.contents());
   input_stack::push(make_temp_iterator(buf));
 }
 
@@ -4096,12 +4133,12 @@
   macro_iterator *mi = new macro_iterator;
   int reading_from_terminal = isatty(fileno(stdin));
   int had_prompt = 0;
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     int c = get_copy(0);
     while (c == ' ')
       c = get_copy(0);
     while (c != EOF && c != '\n' && c != ' ') {
-      if (!invalid_input_char(c)) {
+      if (!is_invalid_input_char(c)) {
 	if (reading_from_terminal)
 	  fputc(c, stderr);
 	had_prompt = 1;
@@ -4122,7 +4159,7 @@
   int nl = 0;
   int c;
   while ((c = getchar()) != EOF) {
-    if (invalid_input_char(c))
+    if (is_invalid_input_char(c))
       warning(WARN_INPUT, "invalid input character code %1", int(c));
     else {
       if (c == '\n') {
@@ -4151,16 +4188,16 @@
   symbol nm;
   node *n = 0;		// pacify compiler
   int c;
-  nm = get_name(1);
+  nm = get_name(true /* required */);
   if (nm.is_null()) {
     skip_line();
     return;
   }
-  if (tok.newline())
+  if (tok.is_newline())
     c = '\n';
-  else if (tok.tab())
+  else if (tok.is_tab())
     c = '\t';
-  else if (!tok.space()) {
+  else if (!tok.is_space()) {
     error("bad string definition");
     skip_line();
     return;
@@ -4224,7 +4261,7 @@
   node *n = 0;		// pacify compiler
   int c;
   tok.skip();
-  charinfo *ci = tok.get_char(1);
+  charinfo *ci = tok.get_char(true /* required */);
   if (ci == 0) {
     skip_line();
     return;
@@ -4237,11 +4274,11 @@
     ci = get_charinfo(symbol(s.contents()));
   }
   tok.next();
-  if (tok.newline())
+  if (tok.is_newline())
     c = '\n';
-  else if (tok.tab())
+  else if (tok.is_tab())
     c = '\t';
-  else if (!tok.space()) {
+  else if (!tok.is_space()) {
     error("bad character definition");
     skip_line();
     return;
@@ -4284,9 +4321,9 @@
 static void remove_character()
 {
   tok.skip();
-  while (!tok.newline() && !tok.eof()) {
-    if (!tok.space() && !tok.tab()) {
-      charinfo *ci = tok.get_char(1);
+  while (!tok.is_newline() && !tok.is_eof()) {
+    if (!tok.is_space() && !tok.is_tab()) {
+      charinfo *ci = tok.get_char(true /* required */);
       if (!ci)
 	break;
       macro *m = ci->set_macro(0);
@@ -4303,7 +4340,7 @@
   request_or_macro *p = lookup_request(nm);
   macro *m = p->to_macro();
   if (!m)
-    error("you can only invoke a string or macro using \\*");
+    error("cannot interpolate request '%1'", nm.contents());
   else {
     if (m->is_string()) {
       string_iterator *si = new string_iterator(*m, "string", nm);
@@ -4318,14 +4355,14 @@
   }
 }
 
-static void interpolate_string_with_args(symbol s)
+static void interpolate_string_with_args(symbol nm)
 {
-  request_or_macro *p = lookup_request(s);
+  request_or_macro *p = lookup_request(nm);
   macro *m = p->to_macro();
   if (!m)
-    error("you can only invoke a string or macro using \\*");
+    error("cannot interpolate request '%1'", nm.contents());
   else {
-    macro_iterator *mi = new macro_iterator(s, *m);
+    macro_iterator *mi = new macro_iterator(nm, *m);
     decode_string_args(mi);
     input_stack::push(mi);
   }
@@ -4335,7 +4372,7 @@
 {
   const char *s = nm.contents();
   if (!s || *s == '\0')
-    copy_mode_error("missing argument name");
+    copy_mode_error("missing positional argument number");
   else if (s1 == 0 && csdigit(s0))
     input_stack::push(input_stack::get_arg(s0 - '0'));
   else if (s0 == '*' && s1 == '\0') {
@@ -4403,7 +4440,7 @@
     for (p = s; *p && csdigit(*p); p++)
       ;
     if (*p)
-      copy_mode_error("bad argument name '%1'", s);
+      copy_mode_error("invalid positional argument number '%1'", s);
     else
       input_stack::push(input_stack::get_arg(atoi(s)));
   }
@@ -4449,14 +4486,11 @@
   handle_initial_request(TITLE_REQUEST);
 }
 
-// this should be local to define_macro, but cfront 1.2 doesn't support that
-static symbol dot_symbol(".");
-
 void do_define_macro(define_mode mode, calling_mode calling, comp_mode comp)
 {
-  symbol nm, term;
+  symbol nm, term, dot_symbol(".");
   if (calling == CALLING_INDIRECT) {
-    symbol temp1 = get_name(1);
+    symbol temp1 = get_name(true /* required */);
     if (temp1.is_null()) {
       skip_line();
       return;
@@ -4472,7 +4506,7 @@
     tok.next();
   }
   if (mode == DEFINE_NORMAL || mode == DEFINE_APPEND) {
-    nm = get_name(1);
+    nm = get_name(true /* required */);
     if (nm.is_null()) {
       skip_line();
       return;
@@ -4481,7 +4515,7 @@
   term = get_name();	// the request that terminates the definition
   if (term.is_null())
     term = dot_symbol;
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   const char *start_filename;
   int start_lineno;
@@ -4489,7 +4523,7 @@
 						      &start_lineno);
   node *n;
   // doing this here makes the line numbers come out right
-  int c = get_copy(&n, 1);
+  int c = get_copy(&n, true /* is defining*/);
   macro mac;
   macro *mm = 0;
   if (mode == DEFINE_NORMAL || mode == DEFINE_APPEND) {
@@ -4511,7 +4545,7 @@
     while (c == ESCAPE_NEWLINE) {
       if (mode == DEFINE_NORMAL || mode == DEFINE_APPEND)
 	mac.append(c);
-      c = get_copy(&n, 1);
+      c = get_copy(&n, true /* is defining */);
     }
     if (bol && c == '.') {
       const char *s = term.contents();
@@ -4587,7 +4621,7 @@
 	mac.append(c);
     }
     bol = (c == '\n');
-    c = get_copy(&n, 1);
+    c = get_copy(&n, true /* is defining */);
   }
 }
 
@@ -4655,9 +4689,9 @@
 
 void rename_macro()
 {
-  symbol s1 = get_name(1);
+  symbol s1 = get_name(true /* required */);
   if (!s1.is_null()) {
-    symbol s2 = get_name(1);
+    symbol s2 = get_name(true /* required */);
     if (!s2.is_null())
       request_dictionary.rename(s1, s2);
   }
@@ -4666,9 +4700,9 @@
 
 void alias_macro()
 {
-  symbol s1 = get_name(1);
+  symbol s1 = get_name(true /* required */);
   if (!s1.is_null()) {
-    symbol s2 = get_name(1);
+    symbol s2 = get_name(true /* required */);
     if (!s2.is_null()) {
       if (!request_dictionary.alias(s1, s2))
 	warning(WARN_MAC, "macro '%1' not defined", s2.contents());
@@ -4679,7 +4713,7 @@
 
 void chop_macro()
 {
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!s.is_null()) {
     request_or_macro *p = lookup_request(s);
     macro *m = p->to_macro();
@@ -4717,10 +4751,61 @@
   skip_line();
 }
 
+enum case_xform_mode { STRING_UPCASE, STRING_DOWNCASE };
+
+// Case-transform each byte of the string argument's contents.
+void do_string_case_transform(case_xform_mode mode)
+{
+  assert((mode == STRING_DOWNCASE) || (mode == STRING_UPCASE));
+  symbol s = get_name(true /* required */);
+  if (s.is_null()) {
+    skip_line();
+    return;
+  }
+  request_or_macro *p = lookup_request(s);
+  macro *m = p->to_macro();
+  if (!m) {
+    error("cannot apply string case transformation to a request ('%1')",
+	  s.contents());
+    skip_line();
+    return;
+  }
+  string_iterator iter1(*m);
+  macro *mac = new macro;
+  int len = m->macro::length();
+  for (int l = 0; l < len; l++) {
+    int nc, c = iter1.get(0);
+    if (c == PUSH_GROFF_MODE
+	|| c == PUSH_COMP_MODE
+	|| c == POP_GROFFCOMP_MODE)
+      nc = c;
+    else if (c == EOF)
+      break;
+    else
+      if (mode == STRING_DOWNCASE)
+	nc = tolower(c);
+      else
+	nc = toupper(c);
+    mac->append(nc);
+  }
+  request_dictionary.define(s, mac);
+  tok.next();
+}
+
+// Uppercase-transform each byte of the string argument's contents.
+void stringdown_request() {
+  do_string_case_transform(STRING_DOWNCASE);
+}
+
+// Lowercase-transform each byte of the string argument's contents.
+void stringup_request() {
+  do_string_case_transform(STRING_UPCASE);
+}
+
 void substring_request()
 {
   int start;				// 0, 1, ..., n-1  or  -1, -2, ...
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!s.is_null() && get_integer(&start)) {
     request_or_macro *p = lookup_request(s);
     macro *m = p->to_macro();
@@ -4809,18 +4894,18 @@
 void length_request()
 {
   symbol ret;
-  ret = get_name(1);
+  ret = get_name(true /* required */);
   if (ret.is_null()) {
     skip_line();
     return;
   }
   int c;
   node *n;
-  if (tok.newline())
+  if (tok.is_newline())
     c = '\n';
-  else if (tok.tab())
+  else if (tok.is_tab())
     c = '\t';
-  else if (!tok.space()) {
+  else if (!tok.is_space()) {
     error("bad string definition");
     skip_line();
     return;
@@ -4836,7 +4921,7 @@
     ++len;
     c = get_copy(&n);
   }
-  reg *r = (reg*)number_reg_dictionary.lookup(ret);
+  reg *r = (reg*)register_dictionary.lookup(ret);
   if (r)
     r->set_value(len);
   else
@@ -4846,7 +4931,7 @@
 
 void asciify_macro()
 {
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!s.is_null()) {
     request_or_macro *p = lookup_request(s);
     macro *m = p->to_macro();
@@ -4873,7 +4958,7 @@
 
 void unformat_macro()
 {
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!s.is_null()) {
     request_or_macro *p = lookup_request(s);
     macro *m = p->to_macro();
@@ -4919,7 +5004,7 @@
 
 static void interpolate_number_format(symbol nm)
 {
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   if (r)
     input_stack::push(make_temp_iterator(r->get_format()));
 }
@@ -4928,7 +5013,7 @@
 {
   token start;
   start.next();
-  if (start.delimiter(1)) {
+  if (start.usable_as_delimiter(true /* report error */)) {
     tok.next();
     if (get_number(n, si, prev_value)) {
       if (start != tok)
@@ -4943,7 +5028,7 @@
 {
   token start;
   start.next();
-  if (start.delimiter(1)) {
+  if (start.usable_as_delimiter(true /* report error */)) {
     tok.next();
     if (get_number(n, si)) {
       if (start != tok)
@@ -4959,14 +5044,14 @@
   token start;
   start.next();
   int start_level = input_stack::get_level();
-  if (!start.delimiter(1))
+  if (!start.usable_as_delimiter(true /* report error */))
     return 0;
   tok.next();
   if (get_number(n, si)) {
-    if (tok.dummy() || tok.transparent_dummy())
+    if (tok.is_dummy() || tok.is_transparent_dummy())
       tok.next();
     if (!(start == tok && input_stack::get_level() == start_level)) {
-      *cp = tok.get_char(1);
+      *cp = tok.get_char(true /* required */);
       tok.next();
     }
     if (!(start == tok && input_stack::get_level() == start_level))
@@ -4976,7 +5061,7 @@
   return 0;
 }
 
-static int read_size(int *x)
+static bool read_size(int *x)
 {
   tok.next();
   int c = tok.ch();
@@ -4992,7 +5077,7 @@
     c = tok.ch();
   }
   int val = 0;		// pacify compiler
-  int bad = 0;
+  bool contains_invalid_digit = false;
   if (c == '(') {
     tok.next();
     c = tok.ch();
@@ -5010,13 +5095,13 @@
       }
     }
     if (!csdigit(c))
-      bad = 1;
+      contains_invalid_digit = true;
     else {
       val = c - '0';
       tok.next();
       c = tok.ch();
       if (!csdigit(c))
-	bad = 1;
+	contains_invalid_digit = true;
       else {
 	val = val*10 + (c - '0');
 	val *= sizescale;
@@ -5025,18 +5110,23 @@
   }
   else if (csdigit(c)) {
     val = c - '0';
-    if (!inc && c != '0' && c < '4') {
+    if (compatible_flag && !inc && c != '0' && c < '4') {
+      // Support legacy \sNN syntax.
       tok.next();
       c = tok.ch();
       if (!csdigit(c))
-	bad = 1;
-      else
+	contains_invalid_digit = true;
+      else {
 	val = val*10 + (c - '0');
+	error("ambiguous type size in escape sequence; rewrite to use"
+	      " '%1s(%2' or similar", static_cast<char>(escape_char),
+	      val);
+      }
     }
     val *= sizescale;
   }
-  else if (!tok.delimiter(1))
-    return 0;
+  else if (!tok.usable_as_delimiter(true /* report error */))
+    return false;
   else {
     token start(tok);
     tok.next();
@@ -5046,22 +5136,30 @@
       tok.next();
     }
     if (!get_number(&val, 'z'))
-      return 0;
+      return false;
     if (!(start.ch() == '' && tok.ch() == '') && start != tok) {
       if (start.ch() == '')
-	error("missing ''");
+	error("missing '' in type size escape sequence");
       else
-	error("missing closing delimiter");
-      return 0;
+	error("missing closing delimiter in type size escape sequence");
+      return false;
     }
   }
-  if (!bad) {
+  if (contains_invalid_digit) {
+    if (c)
+      error("expected valid digit in type size escape sequence, got %1",
+	    input_char_description(c));
+    else
+      error("invalid digit in type size escape sequence");
+    return false;
+  }
+  else {
     switch (inc) {
     case 0:
       if (val == 0) {
-	// special case -- \s0 and \s0 means to revert to previous size
+	// special case -- point size 0 means "revert to previous size"
 	*x = 0;
-	return 1;
+	return true;
       }
       *x = val;
       break;
@@ -5076,14 +5174,11 @@
     }
     if (*x <= 0) {
       warning(WARN_RANGE,
-	      "\\s escape results in non-positive point size; set to 1");
+	      "type size escape sequence results in non-positive size"
+	      " %1u; setting it to 1u", *x);
       *x = 1;
     }
-    return 1;
-  }
-  else {
-    error("bad digit in point size");
-    return 0;
+    return true;
   }
 }
 
@@ -5091,11 +5186,11 @@
 {
   token start;
   start.next();
-  if (start.eof()) {
+  if (start.is_eof()) {
     error("end of input at start of delimited name");
     return NULL_SYMBOL;
   }
-  if (start.newline()) {
+  if (start.is_newline()) {
     error("can't delimit name with a newline");
     return NULL_SYMBOL;
   }
@@ -5116,7 +5211,7 @@
 	buf = new charbuf_size*2;
 	memcpy(buf, old_buf, buf_size);
 	buf_size *= 2;
-	a_delete old_buf;
+	delete old_buf;
       }
     }
     tok.next();
@@ -5126,7 +5221,7 @@
     if ((bufi = tok.ch()) == 0) {
       error("missing delimiter (got %1)", tok.description());
       if (buf != abuf)
-	a_delete buf;
+	delete buf;
       return NULL_SYMBOL;
     }
     i++;
@@ -5142,7 +5237,7 @@
   }
   else {
     symbol s(buf);
-    a_delete buf;
+    delete buf;
     return s;
   }
 }
@@ -5153,15 +5248,15 @@
 {
   token start;
   start.next();
-  if (!start.delimiter(1))
+  if (!start.usable_as_delimiter(true /* report error */))
     return;
   tok.next();
-  symbol nm = get_long_name(1);
+  symbol nm = get_long_name(true /* required */);
   if (nm.is_null())
     return;
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   int prev_value;
   if (!r || !r->get_value(&prev_value))
     prev_value = 0;
@@ -5180,20 +5275,20 @@
 
 static void do_width()
 {
+  int start_level = input_stack::get_level();
   token start;
   start.next();
-  int start_level = input_stack::get_level();
   environment env(curenv);
   environment *oldenv = curenv;
   curenv = &env;
   for (;;) {
     tok.next();
-    if (tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
-      break;
-    }
-    if (tok.newline()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline() || tok.is_eof()) {
+      if (tok != start)
+	warning(WARN_DELIM, "missing closing delimiter in"
+		" width computation escape sequence (got %1)",
+		tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
@@ -5223,13 +5318,13 @@
 void read_title_parts(node **part, hunits *part_width)
 {
   tok.skip();
-  if (tok.newline() || tok.eof())
+  if (tok.is_newline() || tok.is_eof())
     return;
   token start(tok);
   int start_level = input_stack::get_level();
   tok.next();
   for (int i = 0; i < 3; i++) {
-    while (!tok.newline() && !tok.eof()) {
+    while (!tok.is_newline() && !tok.is_eof()) {
       if (tok == start
 	  && (compatible_flag || input_stack::get_level() == start_level)) {
 	tok.next();
@@ -5245,7 +5340,7 @@
     part_widthi = curenv->get_input_line_position();
     parti = curenv->extract_output_line();
   }
-  while (!tok.newline() && !tok.eof())
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
 }
 
@@ -5323,7 +5418,7 @@
     else
       mac.append(c);
   if (c == EOF || c == '\n') {
-    error("missing \\?");
+    error("unterminated transparent embedding escape sequence");
     return 0;
   }
   return new non_interpreted_node(mac);
@@ -5332,28 +5427,55 @@
 static void encode_char(macro *mac, char c)
 {
   if (c == '\0') {
-    if ((font::use_charnames_in_special) && tok.special()) {
-      charinfo *ci = tok.get_char(1);
-      const char *s = ci->get_symbol()->contents();
-      if (s0 != (char)0) {
+    if (tok.is_stretchable_space()
+	     || tok.is_unstretchable_space())
+      mac->append(' ');
+    else if (tok.is_special()) {
+      const char *sc;
+      if (font::use_charnames_in_special) {
+	charinfo *ci = tok.get_char(true /* required */);
+	sc = ci->get_symbol()->contents();
+      }
+      else
+	sc = tok.get_char()->get_symbol()->contents();
+      if (strcmp("-", sc) == 0)
+	mac->append('-');
+      else if (strcmp("aq", sc) == 0)
+	mac->append('\'');
+      else if (strcmp("dq", sc) == 0)
+	mac->append('"');
+      else if (strcmp("ga", sc) == 0)
+	mac->append('`');
+      else if (strcmp("ha", sc) == 0)
+	mac->append('^');
+      else if (strcmp("rs", sc) == 0)
 	mac->append('\\');
-	mac->append('');
-	int i = 0;
-	while (si != (char)0) {
-	  mac->append(si);
-	  i++;
+      else if (strcmp("ti", sc) == 0)
+	mac->append('~');
+      else {
+	if (font::use_charnames_in_special) {
+	  if (sc0 != (char)0) {
+	    mac->append('\\');
+	    mac->append('');
+	    int i = 0;
+	    while (sci != (char)0) {
+	      mac->append(sci);
+	      i++;
+	    }
+	    mac->append('');
+	  }
+	  else
+	      error("special character '%1' cannot be used within"
+		    " device control escape sequence", sc);
 	}
-	mac->append('');
       }
     }
-    else if (tok.stretchable_space()
-	     || tok.unstretchable_space())
-      mac->append(' ');
-    else if (!(tok.hyphen_indicator()
-	       || tok.dummy()
-	       || tok.transparent_dummy()
-	       || tok.zero_width_break()))
-      error("%1 is invalid within \\X", tok.description());
+    else if (!(tok.is_hyphen_indicator()
+	       || tok.is_dummy()
+	       || tok.is_transparent_dummy()
+	       || tok.is_zero_width_break()))
+      error("%1 is invalid within device control escape sequence",
+	    tok.description());
   }
   else {
     if ((font::use_charnames_in_special) && (c == '\\')) {
@@ -5366,32 +5488,36 @@
   }
 }
 
-node *do_special()
+static node *do_special()
 {
+  int start_level = input_stack::get_level();
   token start;
   start.next();
-  int start_level = input_stack::get_level();
   macro mac;
-  for (tok.next();
-       tok != start || input_stack::get_level() != start_level;
-       tok.next()) {
-    if (tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
-      return 0;
+  for (;;) {
+    tok.next();
+    if (tok.is_newline()) {
+      input_stack::push(make_temp_iterator("\n"));
+      break;
     }
-    if (tok.newline()) {
+    if (tok.is_eof()) {
+      warning(WARN_DELIM, "missing closing delimiter in device control"
+	      " escape sequence (got %1)", tok.description());
+      // Synthesize an input line ending.
       input_stack::push(make_temp_iterator("\n"));
-      warning(WARN_DELIM, "missing closing delimiter");
       break;
     }
+    if (tok == start
+	&& (compatible_flag || input_stack::get_level() == start_level))
+      break;
     unsigned char c;
-    if (tok.space())
+    if (tok.is_space())
       c = ' ';
-    else if (tok.tab())
+    else if (tok.is_tab())
       c = '\t';
-    else if (tok.leader())
+    else if (tok.is_leader())
       c = '\001';
-    else if (tok.backspace())
+    else if (tok.is_backspace())
       c = '\b';
     else
       c = tok.ch();
@@ -5402,7 +5528,7 @@
 
 void device_request()
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     int c;
     macro mac;
     for (;;) {
@@ -5423,13 +5549,13 @@
 
 void device_macro_request()
 {
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (!(s.is_null() || s.is_empty())) {
     request_or_macro *p = lookup_request(s);
     macro *m = p->to_macro();
     if (m)
       curenv->add_node(new special_node(*m));
-    else 
+    else
       error("can't transparently throughput a request");
   }
   skip_line();
@@ -5437,7 +5563,7 @@
 
 void output_request()
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     int c;
     for (;;) {
       c = get_copy(0);
@@ -5460,7 +5586,7 @@
 static node *do_suppress(symbol nm)
 {
   if (nm.is_null() || nm.is_empty()) {
-    error("expecting an argument to escape \\O");
+    error("output suppression escape sequence requires an argument");
     return 0;
   }
   const char *s = nm.contents();
@@ -5492,19 +5618,22 @@
       s++;			// move over '5'
       char position = *s;
       if (*s == (char)0) {
-	error("missing position and filename in \\O");
+	error("missing position and filename in output suppression"
+	      " escape sequence");
 	return 0;
       }
       if (!(position == 'l'
 	    || position == 'r'
 	    || position == 'c'
 	    || position == 'i')) {
-	error("l, r, c, or i position expected (got %1 in \\O)", position);
+	error("expected position 'l', 'r', 'c', or 'i' in output"
+	      " suppression escape sequence, got '%1'", position);
 	return 0;
       }
       s++;			// onto image name
       if (s == (char *)0) {
-	error("missing image name for \\O");
+	error("missing image name in output suppression escape"
+	      " sequence");
 	return 0;
       }
       image_no++;
@@ -5515,7 +5644,8 @@
     }
     break;
   default:
-    error("'%1' is an invalid argument to \\O", *s);
+    error("invalid argument '%1' to output suppression escape sequence",
+	  *s);
   }
   return 0;
 }
@@ -5571,7 +5701,7 @@
 {
   int level = 0;
   // ensure that ".if 0\{" works as expected
-  if (tok.left_brace())
+  if (tok.is_left_brace())
     level++;
   int c;
   for (;;) {
@@ -5596,7 +5726,7 @@
       }
     /*
       Note that the level can properly be < 0, e.g.
-	
+
 	.if 1 \{\
 	.if 0 \{\
 	.\}\}
@@ -5611,13 +5741,13 @@
 
 static void begin_alternative()
 {
-  while (tok.space() || tok.left_brace())
+  while (tok.is_space() || tok.is_left_brace())
     tok.next();
 }
 
 void nop_request()
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
 }
 
@@ -5626,7 +5756,7 @@
 int do_if_request()
 {
   int invert = 0;
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
   while (tok.ch() == '!') {
     tok.next();
@@ -5634,6 +5764,21 @@
   }
   int result;
   unsigned char c = tok.ch();
+  if (compatible_flag)
+    switch (c) {
+    case 'F':
+    case 'S':
+    case 'c':
+    case 'd':
+    case 'm':
+    case 'r':
+      warning(WARN_SYNTAX,
+	      "conditional operator '%1' used in compatibility mode",
+	      c);
+      break;
+    default:
+      break;
+    }
   if (c == 't') {
     tok.next();
     result = !nroff_mode;
@@ -5656,18 +5801,18 @@
   }
   else if (c == 'd' || c == 'r') {
     tok.next();
-    symbol nm = get_name(1);
+    symbol nm = get_name(true /* required */);
     if (nm.is_null()) {
       skip_alternative();
       return 0;
     }
     result = (c == 'd'
 	      ? request_dictionary.lookup(nm) != 0
-	      : number_reg_dictionary.lookup(nm) != 0);
+	      : register_dictionary.lookup(nm) != 0);
   }
   else if (c == 'm') {
     tok.next();
-    symbol nm = get_long_name(1);
+    symbol nm = get_long_name(true /* required */);
     if (nm.is_null()) {
       skip_alternative();
       return 0;
@@ -5678,7 +5823,7 @@
   else if (c == 'c') {
     tok.next();
     tok.skip();
-    charinfo *ci = tok.get_char(1);
+    charinfo *ci = tok.get_char(true /* required */);
     if (ci == 0) {
       skip_alternative();
       return 0;
@@ -5688,7 +5833,7 @@
   }
   else if (c == 'F') {
     tok.next();
-    symbol nm = get_long_name(1);
+    symbol nm = get_long_name(true /* required */);
     if (nm.is_null()) {
       skip_alternative();
       return 0;
@@ -5697,16 +5842,16 @@
   }
   else if (c == 'S') {
     tok.next();
-    symbol nm = get_long_name(1);
+    symbol nm = get_long_name(true /* required */);
     if (nm.is_null()) {
       skip_alternative();
       return 0;
     }
     result = check_style(nm);
   }
-  else if (tok.space())
+  else if (tok.is_space())
     result = 0;
-  else if (tok.delimiter()) {
+  else if (tok.usable_as_delimiter()) {
     token delim = tok;
     int delim_level = input_stack::get_level();
     environment env1(curenv);
@@ -5717,8 +5862,9 @@
     for (int i = 0; i < 2; i++) {
       for (;;) {
 	tok.next();
-	if (tok.newline() || tok.eof()) {
-	  warning(WARN_DELIM, "missing closing delimiter");
+	if (tok.is_newline() || tok.is_eof()) {
+	  warning(WARN_DELIM, "missing closing delimiter in output"
+		  " comparison operator (got %1)", tok.description());
 	  tok.next();
 	  curenv = oldenv;
 	  return 0;
@@ -5771,7 +5917,7 @@
 void else_request()
 {
   if (if_else_stack.is_empty()) {
-    warning(WARN_EL, "unbalanced .el request");
+    warning(WARN_EL, "unbalanced 'el' request");
     skip_alternative();
   }
   else {
@@ -5821,7 +5967,7 @@
     }
   }
   if (level != 0)
-    error("unbalanced \\{ \\}");
+    error("unbalanced brace escape sequences");
   else {
     while_depth++;
     input_stack::add_boundary();
@@ -5872,32 +6018,48 @@
   }
 }
 
-// .so
-
-void source()
+void do_source(bool quietly)
 {
-  symbol nm = get_long_name(1);
+  symbol nm = get_long_name(true /* required */);
   if (nm.is_null())
     skip_line();
   else {
-    while (!tok.newline() && !tok.eof())
+    while (!tok.is_newline() && !tok.is_eof())
       tok.next();
     errno = 0;
     FILE *fp = include_search_path.open_file_cautious(nm.contents());
     if (fp)
       input_stack::push(new file_iterator(fp, nm.contents()));
     else
-      error("can't open '%1': %2", nm.contents(), strerror(errno));
+      // Suppress diagnostic only if we're operating quietly and it's an
+      // expected problem.
+      if (!(quietly && (ENOENT == errno)))
+	error("can't open '%1': %2", nm.contents(), strerror(errno));
     tok.next();
   }
 }
 
+// .so
+
+void source()
+{
+  do_source(false /* not quietly*/ );
+}
+
+// .soquiet: like .so, but silently ignore files that can't be opened
+// due to their nonexistence
+
+void source_quietly()
+{
+  do_source(true /* quietly */ );
+}
+
 // like .so but use popen()
 
 void pipe_source()
 {
   if (!unsafe_flag) {
-    error(".pso request not allowed in safer mode");
+    error("'pso' request is not allowed in safer mode");
     skip_line();
   }
   else {
@@ -5905,7 +6067,7 @@
     error("pipes not available on this system");
     skip_line();
 #else /* not POPEN_MISSING */
-    if (tok.newline() || tok.eof())
+    if (tok.is_newline() || tok.is_eof())
       error("missing command");
     else {
       int c;
@@ -5923,7 +6085,7 @@
 	  buf_size *= 2;
 	  buf = new charbuf_size;
 	  memcpy(buf, old_buf, old_buf_size);
-	  a_delete old_buf;
+	  delete old_buf;
 	}
 	strcpy(buf + buf_used, s);
 	buf_used += slen;
@@ -5935,7 +6097,7 @@
 	input_stack::push(new file_iterator(fp, symbol(buf).contents(), 1));
       else
 	error("can't open pipe to process '%1': %2", buf, strerror(errno));
-      a_delete buf;
+      delete buf;
     }
     tok.next();
 #endif /* not POPEN_MISSING */
@@ -6079,7 +6241,8 @@
 		  // ...we must ensure it is not a further attempt to defer
 		  // assignment to a trailer, (which we are already parsing).
 		  //
-		  error("'(atend)' not allowed in trailer of '%1'", filename);
+		  error("'(atend)' is not allowed in trailer of '%1'",
+			filename);
 	      }
 	    }
 	    else
@@ -6391,7 +6554,7 @@
 {
   // Parse input line, to extract file name.
   //
-  symbol nm = get_long_name(1);
+  symbol nm = get_long_name(true /* required */);
   if (nm.is_null())
     //
     // No file name specified: ignore the entire request.
@@ -6400,7 +6563,7 @@
   else {
     // File name acquired: swallow the rest of the line.
     //
-    while (!tok.newline() && !tok.eof())
+    while (!tok.is_newline() && !tok.is_eof())
       tok.next();
     errno = 0;
 
@@ -6486,7 +6649,7 @@
     buf0 = '\0';
     break;
   default:
-    if (invalid_input_char(c))
+    if (is_invalid_input_char(c))
       buf0 = '\0';
     else
       buf0 = c;
@@ -6511,8 +6674,11 @@
   case '\0':
     return "a node";
   }
-  static char bufsizeof("magic character code ") + 1 + INT_DIGITS;
-  if (invalid_input_char(c)) {
+  size_t bufsz = sizeof "magic character code " + INT_DIGITS + 1;
+  // repeat expression; no VLAs in ISO C++
+  static char bufsizeof "magic character code " + INT_DIGITS + 1;
+  (void) memset(buf, 0, bufsz);
+  if (is_invalid_input_char(c)) {
     const char *s = asciify(c);
     if (*s) {
       buf0 = '\'';
@@ -6535,7 +6701,7 @@
 
 void tag()
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     string s;
     int c;
     for (;;) {
@@ -6558,7 +6724,7 @@
 
 void taga()
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     string s;
     int c;
     for (;;) {
@@ -6583,7 +6749,7 @@
 
 void do_terminal(int newline, int string_like)
 {
-  if (!tok.newline() && !tok.eof()) {
+  if (!tok.is_newline() && !tok.is_eof()) {
     int c;
     for (;;) {
       c = get_copy(0);
@@ -6622,9 +6788,9 @@
 
 void do_open(int append)
 {
-  symbol stream = get_name(1);
+  symbol stream = get_name(true /* required */);
   if (!stream.is_null()) {
-    symbol filename = get_long_name(1);
+    symbol filename = get_long_name(true /* required */);
     if (!filename.is_null()) {
       errno = 0;
       FILE *fp = fopen(filename.contents(), append ? "a" : "w");
@@ -6647,7 +6813,7 @@
 void open_request()
 {
   if (!unsafe_flag) {
-    error(".open request not allowed in safer mode");
+    error("'open' request is not allowed in safer mode");
     skip_line();
   }
   else
@@ -6657,7 +6823,7 @@
 void opena_request()
 {
   if (!unsafe_flag) {
-    error(".opena request not allowed in safer mode");
+    error("'opena' request is not allowed in safer mode");
     skip_line();
   }
   else
@@ -6666,7 +6832,7 @@
 
 void close_request()
 {
-  symbol stream = get_name(1);
+  symbol stream = get_name(true /* required */);
   if (!stream.is_null()) {
     FILE *fp = (FILE *)stream_dictionary.remove(stream);
     if (!fp)
@@ -6681,7 +6847,7 @@
 
 void do_write_request(int newline)
 {
-  symbol stream = get_name(1);
+  symbol stream = get_name(true /* required */);
   if (stream.is_null()) {
     skip_line();
     return;
@@ -6717,7 +6883,7 @@
 
 void write_macro_request()
 {
-  symbol stream = get_name(1);
+  symbol stream = get_name(true /* required */);
   if (stream.is_null()) {
     skip_line();
     return;
@@ -6728,7 +6894,7 @@
     skip_line();
     return;
   }
-  symbol s = get_name(1);
+  symbol s = get_name(true /* required */);
   if (s.is_null()) {
     skip_line();
     return;
@@ -6766,7 +6932,7 @@
       warn_scale = (double)units_per_inch / 6.0;
     else {
       warning(WARN_SCALE,
-	      "invalid scaling indicator '%1', using 'i' instead", c);
+	      "scaling unit '%1' invalid; using 'i' instead", c);
       c = 'i';
     }
     warn_scaling_indicator = c;
@@ -6812,6 +6978,7 @@
   charset_table''->set_flags(charinfo::TRANSPARENT);
   charset_table'*'->set_flags(charinfo::TRANSPARENT);
   get_charinfo(symbol("dg"))->set_flags(charinfo::TRANSPARENT);
+  get_charinfo(symbol("dd"))->set_flags(charinfo::TRANSPARENT);
   get_charinfo(symbol("rq"))->set_flags(charinfo::TRANSPARENT);
   get_charinfo(symbol("cq"))->set_flags(charinfo::TRANSPARENT);
   get_charinfo(symbol("em"))->set_flags(charinfo::BREAK_AFTER);
@@ -6834,39 +7001,40 @@
 static void do_translate(int translate_transparent, int translate_input)
 {
   tok.skip();
-  while (!tok.newline() && !tok.eof()) {
-    if (tok.space()) {
+  while (!tok.is_newline() && !tok.is_eof()) {
+    if (tok.is_space()) {
       // This is a really bizarre troff feature.
       tok.next();
-      translate_space_to_dummy = tok.dummy();
-      if (tok.newline() || tok.eof())
+      translate_space_to_dummy = tok.is_dummy();
+      if (tok.is_newline() || tok.is_eof())
 	break;
+      error("cannot translate space character; ignoring");
       tok.next();
       continue;
     }
-    charinfo *ci1 = tok.get_char(1);
+    charinfo *ci1 = tok.get_char(true /* required */);
     if (ci1 == 0)
       break;
     tok.next();
-    if (tok.newline() || tok.eof()) {
+    if (tok.is_newline() || tok.is_eof()) {
       ci1->set_special_translation(charinfo::TRANSLATE_SPACE,
 				   translate_transparent);
       break;
     }
-    if (tok.space())
+    if (tok.is_space())
       ci1->set_special_translation(charinfo::TRANSLATE_SPACE,
 				   translate_transparent);
-    else if (tok.stretchable_space())
+    else if (tok.is_stretchable_space())
       ci1->set_special_translation(charinfo::TRANSLATE_STRETCHABLE_SPACE,
 				   translate_transparent);
-    else if (tok.dummy())
+    else if (tok.is_dummy())
       ci1->set_special_translation(charinfo::TRANSLATE_DUMMY,
 				   translate_transparent);
-    else if (tok.hyphen_indicator())
+    else if (tok.is_hyphen_indicator())
       ci1->set_special_translation(charinfo::TRANSLATE_HYPHEN_INDICATOR,
 				   translate_transparent);
     else {
-      charinfo *ci2 = tok.get_char(1);
+      charinfo *ci2 = tok.get_char(true /* required */);
       if (ci2 == 0)
 	break;
       if (ci1 == ci2)
@@ -6899,7 +7067,7 @@
   int flags;
   if (get_integer(&flags))
     while (has_arg()) {
-      charinfo *ci = tok.get_char(1);
+      charinfo *ci = tok.get_char(true /* required */);
       if (ci) {
 	charinfo *tem = ci->get_translation();
 	if (tem)
@@ -6914,8 +7082,8 @@
 void hyphenation_code()
 {
   tok.skip();
-  while (!tok.newline() && !tok.eof()) {
-    charinfo *ci = tok.get_char(1);
+  while (!tok.is_newline() && !tok.is_eof()) {
+    charinfo *ci = tok.get_char(true /* required */);
     if (ci == 0)
       break;
     tok.next();
@@ -6942,7 +7110,7 @@
 void hyphenation_patterns_file_code()
 {
   tok.skip();
-  while (!tok.newline() && !tok.eof()) {
+  while (!tok.is_newline() && !tok.is_eof()) {
     int n1, n2;
     if (get_integer(&n1) && (0 <= n1 && n1 <= 255)) {
       if (!has_arg()) {
@@ -6971,18 +7139,18 @@
 void define_class()
 {
   tok.skip();
-  symbol nm = get_name(1);
+  symbol nm = get_name(true /* required */);
   if (nm.is_null()) {
     skip_line();
     return;
   }
   charinfo *ci = get_charinfo(nm);
   charinfo *child1 = 0, *child2 = 0;
-  while (!tok.newline() && !tok.eof()) {
+  while (!tok.is_newline() && !tok.is_eof()) {
     tok.skip();
     if (child1 != 0 && tok.ch() == '-') {
       tok.next();
-      child2 = tok.get_char(1);
+      child2 = tok.get_char(true /* required */);
       if (!child2) {
 	warning(WARN_MISSING,
 		"missing end of character range in class '%1'",
@@ -6992,7 +7160,8 @@
       }
       if (child1->is_class() || child2->is_class()) {
 	warning(WARN_SYNTAX,
-		"nested character class is not allowed in range definition");
+		"a nested character class is not allowed in a range"
+		" definition");
 	skip_line();
 	return;
       }
@@ -7035,10 +7204,10 @@
       }
       child1 = 0;
     }
-    child1 = tok.get_char(1);
+    child1 = tok.get_char(true /* required */);
     tok.next();
     if (!child1) {
-      if (!tok.newline())
+      if (!tok.is_newline())
 	skip_line();
       break;
     }
@@ -7076,7 +7245,7 @@
   skip_line();
 }
 
-charinfo *token::get_char(int required)
+charinfo *token::get_char(bool required)
 {
   if (type == TOKEN_CHAR)
     return charset_tablec;
@@ -7088,22 +7257,27 @@
     if (escape_char != 0)
       return charset_tableescape_char;
     else {
-      error("'\\e' used while no current escape character");
+      // XXX: Is this possible?  token::add_to_zero_width_node_list()
+      // and token::process() don't add this token type if the escape
+      // character is null.  If not, this should be an assert().  Also
+      // see escape_off().
+      error("escaped 'e' used while escape sequences disabled");
       return 0;
     }
   }
   if (required) {
     if (type == TOKEN_EOF || type == TOKEN_NEWLINE)
-      warning(WARN_MISSING, "missing normal or special character");
+      warning(WARN_MISSING, "missing ordinary or special character");
     else
-      error("normal or special character expected (got %1)", description());
+      error("expected ordinary or special character, got %1",
+	    description());
   }
   return 0;
 }
 
 charinfo *get_optional_char()
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
   charinfo *ci = tok.get_char();
   if (!ci)
@@ -7115,15 +7289,15 @@
 
 void check_missing_character()
 {
-  if (!tok.newline() && !tok.eof() && !tok.right_brace() && !tok.tab())
-    error("normal or special character expected (got %1): "
-	  "treated as missing",
-	  tok.description());
+  if (!tok.is_newline() && !tok.is_eof() && !tok.is_right_brace()
+      && !tok.is_tab())
+    error("expected ordinary or special character, got %1; treated as"
+	  " missing", tok.description());
 }
 
 // this is for \Z
 
-int token::add_to_node_list(node **pp)
+int token::add_to_zero_width_node_list(node **pp)
 {
   hunits w;
   int s;
@@ -7322,21 +7496,21 @@
 public:
   writable_lineno_reg();
   void set_value(units);
-  int get_value(units *);
+  bool get_value(units *);
 };
 
 writable_lineno_reg::writable_lineno_reg()
 {
 }
 
-int writable_lineno_reg::get_value(units *res)
+bool writable_lineno_reg::get_value(units *res)
 {
   int line;
   const char *file;
   if (!input_stack::get_location(0, &file, &line))
-    return 0;
+    return false;
   *res = line;
-  return 1;
+  return true;
 }
 
 void writable_lineno_reg::set_value(units n)
@@ -7369,27 +7543,27 @@
   return i_to_a(input_stack::get_break_flag());
 }
 
-class constant_reg : public reg {
+class readonly_text_register : public reg {
   const char *s;
 public:
-  constant_reg(const char *);
+  readonly_text_register(const char *);
   const char *get_string();
 };
 
-constant_reg::constant_reg(const char *p) : s(p)
+readonly_text_register::readonly_text_register(const char *p) : s(p)
 {
 }
 
-const char *constant_reg::get_string()
+const char *readonly_text_register::get_string()
 {
   return s;
 }
 
-constant_int_reg::constant_int_reg(int *q) : p(q)
+readonly_register::readonly_register(int *q) : p(q)
 {
 }
 
-const char *constant_int_reg::get_string()
+const char *readonly_register::get_string()
 {
   return i_to_a(*p);
 }
@@ -7397,22 +7571,21 @@
 void abort_request()
 {
   int c;
-  if (tok.eof())
+  if (tok.is_eof())
     c = EOF;
-  else if (tok.newline())
+  else if (tok.is_newline())
     c = '\n';
   else {
     while ((c = get_copy(0)) == ' ')
       ;
   }
-  if (c == EOF || c == '\n')
-    fputs("User Abort.", stderr);
-  else {
+  if (!(c == EOF || c == '\n')) {
     for (; c != '\n' && c != EOF; c = get_copy(0))
       fputs(asciify(c), stderr);
+    fputc('\n', stderr);
   }
-  fputc('\n', stderr);
-  cleanup_and_exit(1);
+  fflush(stderr);
+  cleanup_and_exit(EXIT_FAILURE);
 }
 
 char *read_string()
@@ -7424,13 +7597,13 @@
     ;
   int i = 0;
   while (c != '\n' && c != EOF) {
-    if (!invalid_input_char(c)) {
+    if (!is_invalid_input_char(c)) {
       if (i + 2 > len) {
 	char *tem = s;
 	s = new charlen*2;
 	memcpy(s, tem, len);
 	len *= 2;
-	a_delete tem;
+	delete tem;
       }
       si++ = c;
     }
@@ -7439,7 +7612,7 @@
   si = '\0';
   tok.next();
   if (i == 0) {
-    a_delete s;
+    delete s;
     return 0;
   }
   return s;
@@ -7448,7 +7621,7 @@
 void pipe_output()
 {
   if (!unsafe_flag) {
-    error(".pi request not allowed in safer mode");
+    error("'pi' request is not allowed in safer mode");
     skip_line();
   }
   else {
@@ -7469,8 +7642,8 @@
 	strcpy(s, pipe_command);
 	strcat(s, "|");
 	strcat(s, pc);
-	a_delete pipe_command;
-	a_delete pc;
+	delete pipe_command;
+	delete pc;
 	pipe_command = s;
       }
       else
@@ -7485,7 +7658,7 @@
 void system_request()
 {
   if (!unsafe_flag) {
-    error(".sy request not allowed in safer mode");
+    error("'sy' request is not allowed in safer mode");
     skip_line();
   }
   else {
@@ -7494,7 +7667,7 @@
       error("empty command");
     else {
       system_status = system(command);
-      a_delete command;
+      delete command;
     }
   }
 }
@@ -7505,8 +7678,8 @@
     handle_initial_request(COPY_FILE_REQUEST);
     return;
   }
-  symbol filename = get_long_name(1);
-  while (!tok.newline() && !tok.eof())
+  symbol filename = get_long_name(true /* required */);
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -7523,7 +7696,7 @@
     handle_initial_request(VJUSTIFY_REQUEST);
     return;
   }
-  symbol type = get_long_name(1);
+  symbol type = get_long_name(true /* required */);
   if (!type.is_null())
     curdiv->vjustify(type);
   skip_line();
@@ -7537,8 +7710,8 @@
     handle_initial_request(TRANSPARENT_FILE_REQUEST);
     return;
   }
-  symbol filename = get_long_name(1);
-  while (!tok.newline() && !tok.eof())
+  symbol filename = get_long_name(true /* required */);
+  while (!tok.is_newline() && !tok.is_eof())
     tok.next();
   if (break_flag)
     curenv->do_break();
@@ -7553,7 +7726,7 @@
 	int c = getc(fp);
 	if (c == EOF)
 	  break;
-	if (invalid_input_char(c))
+	if (is_invalid_input_char(c))
 	  warning(WARN_INPUT, "invalid input character code %1", int(c));
 	else {
 	  curdiv->transparent_output(c);
@@ -7642,18 +7815,22 @@
 
 static FILE *open_mac_file(const char *mac, char **path)
 {
-  // Try first FOOBAR.tmac, then tmac.FOOBAR
+  // Try `mac`.tmac first, then tmac.`mac`.  Expect ENOENT errors.
   char *s1 = new charstrlen(mac)+strlen(MACRO_POSTFIX)+1;
   strcpy(s1, mac);
   strcat(s1, MACRO_POSTFIX);
   FILE *fp = mac_path->open_file(s1, path);
-  a_delete s1;
+  if (!fp && ENOENT != errno)
+    error("can't open macro file '%1': %2", s1, strerror(errno));
+  delete s1;
   if (!fp) {
     char *s2 = new charstrlen(mac)+strlen(MACRO_PREFIX)+1;
     strcpy(s2, MACRO_PREFIX);
     strcat(s2, mac);
     fp = mac_path->open_file(s2, path);
-    a_delete s2;
+  if (!fp && ENOENT != errno)
+      error("can't open macro file '%1': %2", s2, strerror(errno));
+    delete s2;
   }
   return fp;
 }
@@ -7663,9 +7840,9 @@
   char *path;
   FILE *fp = open_mac_file(mac, &path);
   if (!fp)
-    fatal("can't find macro file %1", mac);
+    fatal("unable to open macro file for -m argument '%1'", mac);
   const char *s = symbol(path).contents();
-  a_delete path;
+  free(path);
   input_stack::push(new file_iterator(fp, s));
   tok.next();
   process_input_stack();
@@ -7679,26 +7856,27 @@
   FILE *fp = mac_path->open_file(filename, &path);
   if (fp) {
     input_stack::push(new file_iterator(fp, symbol(path).contents()));
-    a_delete path;
+    free(path);
     tok.next();
     process_input_stack();
   }
   mac_path = orig_mac_path;
 }
 
-void macro_source()
+void do_macro_source(bool quietly)
 {
-  symbol nm = get_long_name(1);
+  symbol nm = get_long_name(true /* required */);
   if (nm.is_null())
     skip_line();
   else {
-    while (!tok.newline() && !tok.eof())
+    while (!tok.is_newline() && !tok.is_eof())
       tok.next();
     char *path;
     FILE *fp = mac_path->open_file(nm.contents(), &path);
-    // .mso doesn't (and cannot) go through open_mac_file, so we
-    // need to do it here manually: If we have tmac.FOOBAR, try
-    // FOOBAR.tmac and vice versa
+    // .mso cannot go through open_mac_file, which handles the -m option
+    // and expects only an identifier like "s" or "an", not a file name.
+    // We need to do it here manually: If we have tmac.FOOBAR, try
+    // FOOBAR.tmac and vice versa.
     if (!fp) {
       const char *fn = nm.contents();
       size_t fnlen = strlen(fn);
@@ -7707,7 +7885,7 @@
 	strcpy(s, fn + sizeof(MACRO_PREFIX) - 1);
 	strcat(s, MACRO_POSTFIX);
 	fp = mac_path->open_file(s, &path);
-	a_delete s;
+	delete s;
       }
       if (!fp) {
 	if (strncasecmp(fn + fnlen - sizeof(MACRO_POSTFIX) + 1,
@@ -7716,20 +7894,39 @@
 	  strcpy(s, MACRO_PREFIX);
 	  strncat(s, fn, fnlen - sizeof(MACRO_POSTFIX) + 1);
 	  fp = mac_path->open_file(s, &path);
-	  a_delete s;
+	  delete s;
 	}
       }
     }
     if (fp) {
       input_stack::push(new file_iterator(fp, symbol(path).contents()));
-      a_delete path;
+      free(path);
     }
     else
-      warning(WARN_FILE, "can't find macro file '%1'", nm.contents());
+      // Suppress diagnostic only if we're operating quietly and it's an
+      // expected problem.
+      if (!quietly && (ENOENT == errno))
+	warning(WARN_FILE, "can't open macro file '%1': %2",
+		nm.contents(), strerror(errno));
     tok.next();
   }
 }
 
+// .mso
+
+void macro_source()
+{
+  do_macro_source(false /* not quietly (if WARN_FILE enabled) */ );
+}
+
+// .msoquiet: like .mso, but silently ignore files that can't be opened
+// due to their nonexistence
+
+void macro_source_quietly()
+{
+  do_macro_source(true /* quietly */ );
+}
+
 static void process_input_file(const char *name)
 {
   FILE *fp;
@@ -7778,7 +7975,7 @@
     units n;
     if (evaluate_expression(p + 1, &n))
       set_number_reg(buf, n);
-    a_delete buf;
+    delete buf;
   }
 }
 
@@ -7786,7 +7983,7 @@
 {
   macro *m = new macro;
   for (const char *p = value; *p; p++)
-    if (!invalid_input_char((unsigned char)*p))
+    if (!is_invalid_input_char((unsigned char)*p))
       m->append(*p);
   request_dictionary.define(name, m);
 }
@@ -7805,7 +8002,7 @@
     memcpy(buf, s, p - s);
     bufp - s = 0;
     set_string(buf, p + 1);
-    a_delete buf;
+    delete buf;
   }
 }
 
@@ -7834,9 +8031,15 @@
 void usage(FILE *stream, const char *prog)
 {
   fprintf(stream,
-"usage: %s -abcivzCERU -wname -Wname -dcs -ffam -mname -nnum -olist\n"
-"       -rcn -Tname -Fdir -Idir -Mdir files...\n",
-	  prog);
+"usage: %s -abcCEiRUz -d ct -d string=text -f font-family"
+" -F font-directory -I inclusion-directory -m macro-package"
+" -M macro-directory -n page-number -o page-list"
+" -r cnumeric-expression -r register=numeric-expression"
+" -T output-device -w warning-category -W warning-category"
+" file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s {-h | --help}\n",
+	  prog, prog, prog);
 }
 
 int main(int argc, char **argv)
@@ -7875,6 +8078,8 @@
   };
 #if defined(DEBUGGING)
 #define DEBUG_OPTION "D"
+#else
+#define DEBUG_OPTION ""
 #endif
   while ((c = getopt_long(argc, argv,
 			  "abciI:vw:W:zCEf:m:n:o:r:d:F:M:T:tqs:RU"
@@ -7950,12 +8155,18 @@
     case 'd':
       if (*optarg == '\0')
 	error("'-d' requires non-empty argument");
+      else if (*optarg == '=')
+	error("malformed argument to '-d'; string name cannot be empty"
+	      " or contain an equals sign");
       else
 	add_string(optarg, &string_assignments);
       break;
     case 'r':
       if (*optarg == '\0')
 	error("'-r' requires non-empty argument");
+      else if (*optarg == '=')
+	error("malformed argument to '-r'; register name cannot be"
+	      " empty or contain an equals sign");
       else
 	add_string(optarg, &register_assignments);
       break;
@@ -7992,13 +8203,14 @@
   set_string(".T", device);
   init_charset_table();
   init_hpf_code_table();
-  if (!font::load_desc())
-    fatal("sorry, I can't continue");
+  if (0 /* nullptr */ == font::load_desc())
+    fatal("cannot load 'DESC' description file for device '%1'",
+	  device);
   units_per_inch = font::res;
   hresolution = font::hor;
   vresolution = font::vert;
   sizescale = font::sizescale;
-  tcommand_flag = font::tcommand;
+  device_has_tcommand = font::has_tcommand;
   warn_scale = (double)units_per_inch;
   warn_scaling_indicator = 'i';
   if (!fflag && font::family != 0 && *font::family != '\0')
@@ -8006,15 +8218,23 @@
   font_size::init_size_table(font::sizes);
   int i;
   int j = 1;
-  if (font::style_table) {
+  if (font::style_table)
     for (i = 0; font::style_tablei; i++)
-      mount_style(j++, symbol(font::style_tablei));
-  }
+      // Mounting a style can't actually fail due to a bad style name;
+      // that's not determined until the full font name is resolved.
+      // The DESC file also can't provoke a problem by requesting over a
+      // thousand slots in the style table.
+      if (!mount_style(j++, symbol(font::style_tablei)))
+	warning(WARN_FONT, "cannot mount style '%1' directed by 'DESC'"
+		" file for device '%2'", font::style_tablei, device);
   for (i = 0; font::font_name_tablei; i++, j++)
-    // In the DESC file a font name of 0 (zero) means leave this
-    // position empty.
+    // In the DESC file, a font name of 0 (zero) means "leave this
+    // position empty".
     if (strcmp(font::font_name_tablei, "0") != 0)
-      mount_font(j, symbol(font::font_name_tablei));
+      if (!mount_font(j, symbol(font::font_name_tablei)))
+	warning(WARN_FONT, "cannot mount font '%1' directed by 'DESC'"
+		" file for device '%2'", font::font_name_tablei,
+		device);
   curdiv = topdiv = new top_level_diversion;
   if (nflag)
     topdiv->set_next_page_number(next_page_number);
@@ -8025,7 +8245,7 @@
   init_column_requests();
 #endif /* COLUMN */
   init_node_requests();
-  number_reg_dictionary.define(".T", new constant_reg(tflag ? "1" : "0"));
+  register_dictionary.define(".T", new readonly_text_register(tflag ? "1" : "0"));
   init_registers();
   init_reg_requests();
   init_hyphen_requests();
@@ -8083,7 +8303,6 @@
   time_t
 #endif /* not LONG_FOR_TIME_T */
     t = current_time();
-  // Use struct here to work around misfeature in old versions of g++.
   struct tm *tt = localtime(&t);
   set_number_reg("seconds", int(tt->tm_sec));
   set_number_reg("minutes", int(tt->tm_min));
@@ -8094,8 +8313,8 @@
   set_number_reg("year", int(1900 + tt->tm_year));
   set_number_reg("yr", int(tt->tm_year));
   set_number_reg("$$", getpid());
-  number_reg_dictionary.define(".A",
-			       new constant_reg(ascii_output_flag
+  register_dictionary.define(".A",
+			       new readonly_text_register(ascii_output_flag
 						? "1"
 						: "0"));
 }
@@ -8175,7 +8394,7 @@
   init_request("ecr", restore_escape_char);
   init_request("ecs", save_escape_char);
   init_request("el", else_request);
-  init_request("em", end_macro);
+  init_request("em", eoi_macro);
   init_request("eo", escape_off);
   init_request("ex", exit_request);
   init_request("fchar", define_fallback_character);
@@ -8191,6 +8410,7 @@
   init_request("lf", line_file);
   init_request("lsm", leading_spaces_macro);
   init_request("mso", macro_source);
+  init_request("msoquiet", macro_source_quietly);
   init_request("nop", nop_request);
   init_request("nroff", nroff_request);
   init_request("nx", next_file);
@@ -8212,7 +8432,10 @@
   init_request("schar", define_special_character);
   init_request("shift", shift);
   init_request("so", source);
+  init_request("soquiet", source_quietly);
   init_request("spreadwarn", spreadwarn_request);
+  init_request("stringdown", stringdown_request);
+  init_request("stringup", stringup_request);
   init_request("substring", substring_request);
   init_request("sy", system_request);
   init_request("tag", tag);
@@ -8235,43 +8458,44 @@
   init_request("write", write_request);
   init_request("writec", write_request_continue);
   init_request("writem", write_macro_request);
-  number_reg_dictionary.define(".$", new nargs_reg);
-  number_reg_dictionary.define(".br", new break_flag_reg);
-  number_reg_dictionary.define(".C", new constant_int_reg(&compatible_flag));
-  number_reg_dictionary.define(".O", new variable_reg(&begin_level));
-  number_reg_dictionary.define(".c", new lineno_reg);
-  number_reg_dictionary.define(".color", new constant_int_reg(&color_flag));
-  number_reg_dictionary.define(".F", new filename_reg);
-  number_reg_dictionary.define(".g", new constant_reg("1"));
-  number_reg_dictionary.define(".H", new constant_int_reg(&hresolution));
-  number_reg_dictionary.define(".R", new constant_reg("10000"));
-  number_reg_dictionary.define(".U", new constant_int_reg(&unsafe_flag));
-  number_reg_dictionary.define(".V", new constant_int_reg(&vresolution));
-  number_reg_dictionary.define(".warn", new constant_int_reg(&warning_mask));
+  register_dictionary.define(".$", new nargs_reg);
+  register_dictionary.define(".br", new break_flag_reg);
+  register_dictionary.define(".C", new readonly_register(&compatible_flag));
+  register_dictionary.define(".cp", new readonly_register(&do_old_compatible_flag));
+  register_dictionary.define(".O", new variable_reg(&begin_level));
+  register_dictionary.define(".c", new lineno_reg);
+  register_dictionary.define(".color", new readonly_register(&color_flag));
+  register_dictionary.define(".F", new filename_reg);
+  register_dictionary.define(".g", new readonly_text_register("1"));
+  register_dictionary.define(".H", new readonly_register(&hresolution));
+  register_dictionary.define(".R", new readonly_text_register("10000"));
+  register_dictionary.define(".U", new readonly_register(&unsafe_flag));
+  register_dictionary.define(".V", new readonly_register(&vresolution));
+  register_dictionary.define(".warn", new readonly_register(&warning_mask));
   extern const char *major_version;
-  number_reg_dictionary.define(".x", new constant_reg(major_version));
+  register_dictionary.define(".x", new readonly_text_register(major_version));
   extern const char *revision;
-  number_reg_dictionary.define(".Y", new constant_reg(revision));
+  register_dictionary.define(".Y", new readonly_text_register(revision));
   extern const char *minor_version;
-  number_reg_dictionary.define(".y", new constant_reg(minor_version));
-  number_reg_dictionary.define("c.", new writable_lineno_reg);
-  number_reg_dictionary.define("llx", new variable_reg(&llx_reg_contents));
-  number_reg_dictionary.define("lly", new variable_reg(&lly_reg_contents));
-  number_reg_dictionary.define("lsn", new variable_reg(&leading_spaces_number));
-  number_reg_dictionary.define("lss", new variable_reg(&leading_spaces_space));
-  number_reg_dictionary.define("opmaxx",
+  register_dictionary.define(".y", new readonly_text_register(minor_version));
+  register_dictionary.define("c.", new writable_lineno_reg);
+  register_dictionary.define("llx", new variable_reg(&llx_reg_contents));
+  register_dictionary.define("lly", new variable_reg(&lly_reg_contents));
+  register_dictionary.define("lsn", new variable_reg(&leading_spaces_number));
+  register_dictionary.define("lss", new variable_reg(&leading_spaces_space));
+  register_dictionary.define("opmaxx",
 			       new variable_reg(&output_reg_maxx_contents));
-  number_reg_dictionary.define("opmaxy",
+  register_dictionary.define("opmaxy",
 			       new variable_reg(&output_reg_maxy_contents));
-  number_reg_dictionary.define("opminx",
+  register_dictionary.define("opminx",
 			       new variable_reg(&output_reg_minx_contents));
-  number_reg_dictionary.define("opminy",
+  register_dictionary.define("opminy",
 			       new variable_reg(&output_reg_miny_contents));
-  number_reg_dictionary.define("slimit",
+  register_dictionary.define("slimit",
 			       new variable_reg(&input_stack::limit));
-  number_reg_dictionary.define("systat", new variable_reg(&system_status));
-  number_reg_dictionary.define("urx", new variable_reg(&urx_reg_contents));
-  number_reg_dictionary.define("ury", new variable_reg(&ury_reg_contents));
+  register_dictionary.define("systat", new variable_reg(&system_status));
+  register_dictionary.define("urx", new variable_reg(&urx_reg_contents));
+  register_dictionary.define("ury", new variable_reg(&ury_reg_contents));
 }
 
 object_dictionary request_dictionary(501);
@@ -8315,11 +8539,11 @@
   // requests
   for (;;) {
     tok.next();
-    if (tok.eof())
+    if (tok.is_eof())
       break;
-    if (tok.newline()) {
+    if (tok.is_newline()) {
       error("composite character mustn't contain newline");
-      while (!tok.eof())
+      while (!tok.is_eof())
 	tok.next();
       break;
     }
@@ -8341,10 +8565,10 @@
 {
   token start;
   start.next();
-  if (!start.delimiter(1)){
+  if (!start.usable_as_delimiter(true /* report error */)){
     do {
       tok.next();
-    } while (tok != start && !tok.newline() && !tok.eof());
+    } while (tok != start && !tok.is_newline() && !tok.is_eof());
   }
   else {
     tok.next();
@@ -8361,7 +8585,7 @@
       hvpair *point = new hvpairmaxpoints;
       int npoints = 0;
       int no_last_v = 0;
-      int err = 0;
+      bool err = false;
       int i;
       for (i = 0; tok != start; i++) {
 	if (i == maxpoints) {
@@ -8370,11 +8594,17 @@
 	  for (int j = 0; j < maxpoints; j++)
 	    pointj = oldpointj;
 	  maxpoints *= 2;
-	  a_delete oldpoint;
+	  delete oldpoint;
+	}
+	if (tok.is_newline() || tok.is_eof()) {
+	  warning(WARN_DELIM, "missing closing delimiter in drawing"
+		  " escape sequence (got %1)", tok.description());
+	  err = true;
+	  break;
 	}
 	if (!get_hunits(&pointi.h,
 			type == 'f' || type == 't' ? 'u' : 'm')) {
-	  err = 1;
+	  err = true;
 	  break;
 	}
 	++npoints;
@@ -8385,12 +8615,12 @@
 	  break;
 	}
 	if (!get_vunits(&pointi.v, 'v')) {
-	  err = 1;
+	  err = false;
 	  break;
 	}
 	tok.skip();
       }
-      while (tok != start && !tok.newline() && !tok.eof())
+      while (tok != start && !tok.is_newline() && !tok.is_eof())
 	tok.next();
       if (!err) {
 	switch (type) {
@@ -8437,11 +8667,11 @@
 				      curenv->get_font_size(),
 				      curenv->get_glyph_color(),
 				      curenv->get_fill_color());
-	a_delete point;
+	delete point;
 	return dn;
       }
       else {
-	a_delete point;
+	delete point;
       }
     }
   }
@@ -8479,8 +8709,9 @@
   if (col)
     curenv->set_fill_color(col);
   while (tok != start) {
-    if (tok.newline() || tok.eof()) {
-      warning(WARN_DELIM, "missing closing delimiter");
+    if (tok.is_newline() || tok.is_eof()) {
+      warning(WARN_DELIM, "missing closing delimiter in color space"
+	      " drawing escape sequence (got %1)", tok.description());
       input_stack::push(make_temp_iterator("\n"));
       break;
     }
@@ -8535,7 +8766,7 @@
   if (mask)
     warning_mask |= mask;
   else
-    error("unknown warning '%1'", name);
+    error("unrecognized warning category '%1'", name);
 }
 
 static void disable_warning(const char *name)
@@ -8544,7 +8775,7 @@
   if (mask)
     warning_mask &= ~mask;
   else
-    error("unknown warning '%1'", name);
+    error("unrecognized warning category '%1'", name);
 }
 
 static void copy_mode_error(const char *format,
@@ -8558,13 +8789,13 @@
     strcpy(s, prefix);
     strcat(s, format);
     warning(WARN_IG, s, arg1, arg2, arg3);
-    a_delete s;
+    delete s;
   }
   else
     error(format, arg1, arg2, arg3);
 }
 
-enum error_type { WARNING, OUTPUT_WARNING, ERROR, FATAL };
+enum error_type { DEBUG, WARNING, OUTPUT_WARNING, ERROR, FATAL };
 
 static void do_error(error_type type,
 		     const char *format,
@@ -8580,11 +8811,11 @@
     input_stack::backtrace();
   if (!get_file_line(&filename, &lineno))
     filename = 0;
-  if (filename)
+  if (filename) {
     if (program_name)
-      errprint("%1: %2:%3: ", program_name, filename, lineno);
-    else
-      errprint("%1:%2: ", filename, lineno);
+      errprint("%1:", program_name);
+    errprint("%1:%2: ", filename, lineno);
+  }
   else if (program_name)
     fprintf(stderr, "%s: ", program_name);
   switch (type) {
@@ -8592,10 +8823,14 @@
     fputs("fatal error: ", stderr);
     break;
   case ERROR:
+    fputs("error: ", stderr);
     break;
   case WARNING:
     fputs("warning: ", stderr);
     break;
+  case DEBUG:
+    fputs("debug: ", stderr);
+    break;
   case OUTPUT_WARNING:
     double fromtop = topdiv->get_vertical_position().to_units() / warn_scale;
     fprintf(stderr, "warning p %d, %.1f%c",
@@ -8613,7 +8848,15 @@
   fputc('\n', stderr);
   fflush(stderr);
   if (type == FATAL)
-    cleanup_and_exit(1);
+    cleanup_and_exit(EXIT_FAILURE);
+}
+
+void debug(const char *format,
+	   const errarg &arg1,
+	   const errarg &arg2,
+	   const errarg &arg3)
+{
+  do_error(DEBUG, format, arg1, arg2, arg3);
 }
 
 int warning(warning_type t,
@@ -8666,11 +8909,16 @@
 			      const errarg &arg2,
 			      const errarg &arg3)
 {
-  fprintf(stderr, "%s:%d: fatal error: ", filename, lineno);
+  if (program_name)
+    fprintf(stderr, "%s:", program_name);
+  fprintf(stderr, "%s:", filename);
+  if (lineno > 0)
+    fprintf(stderr, "%d:", lineno);
+  fputs(" fatal error: ", stderr);
   errprint(format, arg1, arg2, arg3);
   fputc('\n', stderr);
   fflush(stderr);
-  cleanup_and_exit(1);
+  cleanup_and_exit(EXIT_FAILURE);
 }
 
 void error_with_file_and_line(const char *filename, int lineno,
@@ -8679,7 +8927,30 @@
 			      const errarg &arg2,
 			      const errarg &arg3)
 {
-  fprintf(stderr, "%s:%d: error: ", filename, lineno);
+  if (program_name)
+    fprintf(stderr, "%s:", program_name);
+  fprintf(stderr, "%s:", filename);
+  if (lineno > 0)
+    fprintf(stderr, "%d:", lineno);
+  fputs(" error: ", stderr);
+  errprint(format, arg1, arg2, arg3);
+  fputc('\n', stderr);
+  fflush(stderr);
+}
+
+void debug_with_file_and_line(const char *filename,
+			      int lineno,
+			      const char *format,
+			      const errarg &arg1,
+			      const errarg &arg2,
+			      const errarg &arg3)
+{
+  if (program_name)
+    fprintf(stderr, "%s:", program_name);
+  fprintf(stderr, "%s:", filename);
+  if (lineno > 0)
+    fprintf(stderr, "%d:", lineno);
+  fputs(" debug: ", stderr);
   errprint(format, arg1, arg2, arg3);
   fputc('\n', stderr);
   fflush(stderr);
@@ -8855,7 +9126,7 @@
     return false;
   }
   const char *unicode = glyph_name_to_unicode(s.contents());
-  if (unicode != NULL && strchr(unicode, '_') == NULL) {
+  if (unicode != 0 && strchr(unicode, '_') == 0) {
     char *ignore;
     int c = (int)strtol(unicode, &ignore, 16);
     return contains(c, true);
@@ -8903,9 +9174,10 @@
 }
 
 // This overrides the same function from libgroff; while reading font
-// definition files it puts single-letter glyph names into 'charset_table'
-// and converts glyph names of the form '\x' ('x' a single letter) into 'x'.
-// Consequently, symbol("x") refers to glyph name '\x', not 'x'.
+// definition files it puts single-letter glyph names into
+// 'charset_table' and converts glyph names of the form '\x' ('x' a
+// single letter) into 'x'.  Consequently, symbol("x") refers to glyph
+// name '\x', not 'x'.
 
 glyph *name_to_glyph(const char *nm)
 {
@@ -8927,5 +9199,11 @@
 const char *glyph_to_name(glyph *g)
 {
   charinfo *ci = (charinfo *)g; // Every glyph is actually a charinfo.
-  return (ci->nm != UNNAMED_SYMBOL ? ci->nm.contents() : NULL);
+  return (ci->nm != UNNAMED_SYMBOL ? ci->nm.contents() : 0);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/input.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/input.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 2001-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2001-2022 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -42,6 +41,8 @@
 const int ESCAPE_PERCENT = 036;
 const int ESCAPE_SPACE = 037;
 
+const int INPUT_DELETE = 0177;
+
 const int TITLE_REQUEST = 0200;
 const int COPY_FILE_REQUEST = 0201;
 const int TRANSPARENT_FILE_REQUEST = 0202;
@@ -59,9 +60,13 @@
 const int BEGIN_QUOTE = 0214;
 const int END_QUOTE = 0215;
 const int DOUBLE_QUOTE = 0216;
+const int INPUT_NO_BREAK_SPACE = 0240;
+const int INPUT_SOFT_HYPHEN= 0255;
 
 #else /* IS_EBCDIC_HOST */
 
+const int INPUT_DELETE = 007;
+
 const int ESCAPE_QUESTION = 010;
 const int BEGIN_TRAP = 011;
 const int END_TRAP = 013;
@@ -100,7 +105,16 @@
 const int END_QUOTE = 075;
 const int DOUBLE_QUOTE = 076;
 
+const int INPUT_NO_BREAK_SPACE = 0101;
+const int INPUT_SOFT_HYPHEN= 0312;
+
 #endif /* IS_EBCDIC_HOST */
 
 extern void do_glyph_color(symbol);
 extern void do_fill_color(symbol);
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/mtsm.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/mtsm.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 2003-2018 Free Software Foundation, Inc.
+/* Copyright (C) 2003-2020 Free Software Foundation, Inc.
      Written by Gaius Mulley (gaius@glam.ac.uk)
 
 This file is part of groff.
@@ -17,7 +16,7 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>. */
 
-#define DEBUGGING
+// mtsm: minimum troff state machine
 
 extern int debug_state;
 
@@ -27,7 +26,9 @@
 #include "mtsm.h"
 #include "env.h"
 
-static int no_of_statems = 0;	// debugging aid
+#if defined(DEBUGGING)
+static int no_of_statems = 0;
+#endif
 
 int_value::int_value()
 : value(0), is_known(0)
@@ -173,8 +174,10 @@
 
 statem::statem()
 {
+#if defined(DEBUGGING)
   issue_no = no_of_statems;
   no_of_statems++;
+#endif
 }
 
 statem::statem(statem *copy)
@@ -188,7 +191,9 @@
     units_valuesi = copy->units_valuesi;
   for (i = 0; i < LAST_STRING; i++)
     string_valuesi = copy->string_valuesi;
+#if defined(DEBUGGING)
   issue_no = copy->issue_no;
+#endif
 }
 
 statem::~statem()
@@ -219,10 +224,12 @@
 			     compare->bool_valuesMTSM_EOL);
   bool_valuesMTSM_BR.diff(fp, "devtag:.br",
 			    compare->bool_valuesMTSM_BR);
+#if defined(DEBUGGING)
   if (debug_state) {
     fprintf(stderr, "compared state %d\n", compare->issue_no);
     fflush(stderr);
   }
+#endif
 }
 
 void statem::add_tag(int_value_state t, int v)
@@ -424,9 +431,11 @@
       if (reset_bool)
 	sp->state->bool_valuesMTSM_BR.set(0);
       s->bool_valuesMTSM_BR.set(1);
+#if defined(DEBUGGING)
       if (debug_state)
 	fprintf(stderr, "inherited br from pushed state %d\n",
 		sp->state->issue_no);
+#endif
     }
     else if (s->bool_valuesMTSM_BR.is_known
 	     && s->bool_valuesMTSM_BR.value)
@@ -634,3 +643,9 @@
 {
   return unitsset;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/mtsm.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/mtsm.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/node.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/node.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -109,6 +108,18 @@
   hunits compute(int point_size);
 };
 
+struct font_lookup_info {
+  int position;
+  int requested_position;
+  char *requested_name;
+  font_lookup_info();
+};
+
+font_lookup_info::font_lookup_info() : position(-1),
+  requested_position(-1), requested_name(0)
+{
+}
+
 // embolden fontno when this is the current font
 
 struct conditional_bold {
@@ -714,7 +725,7 @@
   int piped;
 #endif
   int printing;		// decision via optional page list
-  int output_on;	// \O0 or \O1 escape calls
+  int output_on;	// \O0 or \O1 escape sequences
   virtual void really_transparent_char(unsigned char) = 0;
   virtual void really_print_line(hunits x, vunits y, node *n,
 				 vunits before, vunits after, hunits width) = 0;
@@ -1078,7 +1089,7 @@
     put('\n');
     hpos += w.to_units() + kk;
   }
-  else if (tcommand_flag) {
+  else if (device_has_tcommand) {
     if (tbuf_len > 0 && hpos == output_hpos && vpos == output_vpos
 	&& (!gcol || gcol == current_glyph_color)
 	&& (!fcol || fcol == current_fill_color)
@@ -1201,7 +1212,7 @@
       font_position = new symbolnfont_positions;
       memcpy(font_position, old_font_position,
 	     old_nfont_positions*sizeof(symbol));
-      a_delete old_font_position;
+      delete old_font_position;
     }
     font_positionn = nm;
   }
@@ -1574,7 +1585,7 @@
 
 troff_output_file::~troff_output_file()
 {
-  a_delete font_position;
+  delete font_position;
 }
 
 void troff_output_file::trailer(vunits page_length)
@@ -1614,6 +1625,7 @@
 
 output_file::output_file()
 {
+	is_dying = false;
 }
 
 output_file::~output_file()
@@ -1656,17 +1668,23 @@
 {
   if (!fp)
     return;
+  // Prevent destructor from recursing; see div.cpp:cleanup_and_exit().
+  is_dying = true;
   // To avoid looping, set fp to 0 before calling fatal().
-  if (ferror(fp) || fflush(fp) < 0) {
+  if (ferror(fp)) {
+    fp = 0;
+    fatal("error on output file stream");
+  }
+  else if (fflush(fp) < 0) {
     fp = 0;
-    fatal("error writing output file");
+    fatal("unable to flush output file: %1", strerror(errno));
   }
 #ifndef POPEN_MISSING
   if (piped) {
     int result = pclose(fp);
     fp = 0;
     if (result < 0)
-      fatal("pclose failed");
+      fatal("unable to close pipe: %1", strerror(errno));
     if (!WIFEXITED(result))
       error("output process '%1' got fatal signal %2",
 	    pipe_command,
@@ -1682,14 +1700,17 @@
 #endif /* not POPEN MISSING */
   if (fclose(fp) < 0) {
     fp = 0;
-    fatal("error closing output file");
+    fatal("unable to close output file: %1", strerror(errno));
   }
 }
 
 void real_output_file::flush()
 {
-  if (fflush(fp) < 0)
-    fatal("error writing output file");
+  // To avoid looping, set fp to 0 before calling fatal().
+  if (fflush(fp) < 0) {
+    fp = 0;
+    fatal("unable to flush output file: %1", strerror(errno));
+  }
 }
 
 int real_output_file::is_printing()
@@ -4009,25 +4030,26 @@
   return 2;
 }
 
-int get_reg_int(const char *p)
-{
-  reg *r = (reg *)number_reg_dictionary.lookup(p);
-  units prev_value;
-  if (r && (r->get_value(&prev_value)))
-    return (int)prev_value;
-  else
-    warning(WARN_REG, "number register '%1' not defined", p);
-  return 0;
-}
-
-const char *get_reg_str(const char *p)
-{
-  reg *r = (reg *)number_reg_dictionary.lookup(p);
-  if (r)
-    return r->get_string();
-  else
-    warning(WARN_REG, "register '%1' not defined", p);
-  return 0;
+// Get contents of register `p` as integer.
+// Used only by suppress_node::tprint().
+static int get_register(const char *p)
+{
+  assert(p != 0 /* nullptr */);
+  reg *r = (reg *)register_dictionary.lookup(p);
+  assert(r != 0 /* nullptr */);
+  units value;
+  assert(r->get_value(&value));
+  return int(value);
+}
+
+// Get contents of register `p` as string.
+// Used only by suppress_node::tprint().
+static const char *get_string(const char *p)
+{
+  assert(p != 0 /* nullptr */);
+  reg *r = (reg *)register_dictionary.lookup(p);
+  assert(r != 0 /* nullptr */);
+  return r->get_string();
 }
 
 void suppress_node::put(troff_output_file *out, const char *s)
@@ -4040,17 +4062,15 @@
 }
 
 /*
- *  We need to remember the start of the image and its name.
+ *  We need to remember the start of the image and its name (\O5).  But
+ *  we won't always need this information; for instance, \O2 is used to
+ *  produce a bounding box with no associated image or position thereof.
  */
 
 static char last_position = 0;
-static const char *last_image_filename = 0;
-static int last_image_id = 0;
-
-inline int min(int a, int b)
-{
-  return a < b ? a : b;
-}
+static const char *image_filename = "";
+static size_t image_filename_len = 0;
+static int subimage_counter = 0;
 
 /*
  *  tprint - if (is_on == 2)
@@ -4072,28 +4092,66 @@
 void suppress_node::tprint(troff_output_file *out)
 {
   int current_page = topdiv->get_page_number();
-  // firstly check to see whether this suppress node contains
-  // an image filename & position.
+  // Does the node have an associated position and file name?
   if (is_on == 2) {
-    // remember position and filename
+    // Save them for future bounding box limits.
     last_position = position;
-    char *tem = (char *)last_image_filename;
-    last_image_filename = strsave(filename.contents());
-    if (tem)
-      free(tem);
-    last_image_id = image_id;
-    // printf("start of image and page = %d\n", current_page);
+    image_filename = strsave(filename.contents());
+    image_filename_len = strlen(image_filename);
   }
-  else {
-    // now check whether the suppress node requires us to issue limits.
+  else { // is_on = 0 or 1
+    // Now check whether the suppress node requires us to issue limits.
     if (emit_limits) {
-      char name8192;
-      // remember that the filename will contain a %d in which the
-      // last_image_id is placed
-      if (last_image_filename == (char *) 0)
-	*name = '\0';
-      else
-	sprintf(name, last_image_filename, last_image_id);
+      const size_t namebuflen = 8192;
+      char namenamebuflen = { '\0' };
+      // Jump through a flaming hoop to avoid a "format nonliteral"
+      // warning from blindly using sprintf...and avoid trouble from
+      // mischievous image stems.
+      //
+      // Keep this format string synced with pre-html:makeFileName().
+      const char format = "%d";
+      const size_t format_len = strlen(format);
+      const char *percent_position = strstr(image_filename, format);
+      if (percent_position) {
+	subimage_counter++;
+	assert(sizeof subimage_counter <= 8);
+	// A 64-bit signed int produces up to 19 decimal digits.
+	char *subimage_number = (char *)malloc(20); // 19 digits + \0
+	if (0 == subimage_number)
+	  fatal("memory allocation failure");
+	// Replace the %d in the filename with this number.
+	size_t enough = image_filename_len + 19 - format_len;
+	char *new_name = (char *)malloc(enough);
+	if (0 == new_name)
+	  fatal("memory allocation failure");
+	ptrdiff_t prefix_length = percent_position - image_filename;
+	strncpy(new_name, image_filename, prefix_length);
+	sprintf(subimage_number, "%d", subimage_counter);
+	size_t number_length = strlen(subimage_number);
+	strcpy(new_name + prefix_length, subimage_number);
+	// Skip over the format in the source string.
+	const char *suffix_src = image_filename + prefix_length
+	  + format_len;
+	char *suffix_dst = new_name + prefix_length + number_length;
+	strcpy(suffix_dst, suffix_src);
+	// Ensure the new string fits with room for a terminal '\0'.
+	const size_t len = strlen(new_name);
+	if (len > (namebuflen - 1))
+	  error("constructed file name in suppressed output escape"
+		" sequence is too long (>= %1 bytes); skipping image",
+		(int)namebuflen);
+	else
+	  strncpy(name, new_name, (namebuflen - 1));
+	free(new_name);
+	free(subimage_number);
+      }
+      else {
+	if (image_filename_len > (namebuflen - 1))
+	  error("file name in suppressed output escape sequence is too"
+		" long (>= %1 bytes); skipping image", (int)namebuflen);
+	else
+	  strcpy(name, image_filename);
+      }
       if (is_html) {
 	switch (last_position) {
 	case 'c':
@@ -4121,37 +4179,39 @@
       }
       else {
 	// postscript (or other device)
-	if (suppress_start_page > 0 && current_page != suppress_start_page)
-	  error("suppression limit registers span more than one page;\n"
-		"image description %1 will be wrong", image_no);
+	if (suppress_start_page > 0
+	    && (current_page != suppress_start_page))
+	  error("suppression limit registers span more than a page;"
+		" grohtml-info for image %1 will be wrong", image_no);
 	// if (topdiv->get_page_number() != suppress_start_page)
-	//  fprintf(stderr, "end of image and topdiv page = %d   and  suppress_start_page = %d\n",
+	//  fprintf(stderr, "end of image and topdiv page = %d   and"
+	//		      " suppress_start_page = %d\n",
 	//	  topdiv->get_page_number(), suppress_start_page);
 
-	// remember that the filename will contain a %d in which the
-	// image_no is placed
+	// `name` will contain a "%d" in which the image_no is placed.
 	fprintf(stderr,
-		"grohtml-info:page %d  %d  %d  %d  %d  %d  %s  %d  %d  %s\n",
+		"grohtml-info:page %d  %d  %d  %d  %d  %d  %s  %d  %d"
+		"  %s:%s\n",
 		topdiv->get_page_number(),
-		get_reg_int("opminx"), get_reg_int("opminy"),
-		get_reg_int("opmaxx"), get_reg_int("opmaxy"),
+		get_register("opminx"), get_register("opminy"),
+		get_register("opmaxx"), get_register("opmaxy"),
 		// page offset + line length
-		get_reg_int(".o") + get_reg_int(".l"),
-		name, hresolution, vresolution, get_reg_str(".F"));
+		get_register(".o") + get_register(".l"),
+		name, hresolution, vresolution, get_string(".F"),
+		get_string(".c"));
 	fflush(stderr);
       }
     }
-    else {
+    else { // We are not emitting limits.
       if (is_on) {
 	out->on();
-	// lastly we reset the output registers
 	reset_output_registers();
       }
       else
 	out->off();
       suppress_start_page = current_page;
     }
-  }
+  } // is_on
 }
 
 int suppress_node::force_tprint()
@@ -4380,7 +4440,7 @@
 {
   n += h;
   assert(orig_width != 0);
-  width_list *w = orig_width; 
+  width_list *w = orig_width;
   for (; w->next; w = w->next)
     ;
   w->next = new width_list(sw, ssw);
@@ -4487,7 +4547,7 @@
 draw_node::~draw_node()
 {
   if (point)
-    a_delete point;
+    delete point;
 }
 
 hunits draw_node::width()
@@ -4831,11 +4891,11 @@
     out->right(track_kern);
 }
 
-node *make_composite_node(charinfo *s, environment *env)
+static node *make_composite_node(charinfo *s, environment *env)
 {
   int fontno = env_definite_font(env);
   if (fontno < 0) {
-    error("no current font");
+    error("cannot format composite glyph: no current font");
     return 0;
   }
   assert(fontno < font_table_size && font_tablefontno != 0);
@@ -4850,11 +4910,12 @@
   return new composite_node(n, s, tf, 0, 0, 0);
 }
 
-node *make_glyph_node(charinfo *s, environment *env, int no_error_message = 0)
+static node *make_glyph_node(charinfo *s, environment *env,
+			     bool want_warnings = true)
 {
   int fontno = env_definite_font(env);
   if (fontno < 0) {
-    error("no current font");
+    error("cannot format glyph: no current font");
     return 0;
   }
   assert(fontno < font_table_size && font_tablefontno != 0);
@@ -4865,9 +4926,9 @@
     if (mac && s->is_fallback())
       return make_composite_node(s, env);
     if (s->numbered()) {
-      if (!no_error_message)
-	warning(WARN_CHAR, "can't find numbered character %1",
-		s->get_number());
+      if (want_warnings)
+	warning(WARN_CHAR, "character code %1 not defined in current"
+		" font", s->get_number());
       return 0;
     }
     special_font_list *sf = font_tablefontno->sf;
@@ -4909,19 +4970,20 @@
 	}
     }
     if (!found) {
-      if (!no_error_message && s->first_time_not_found()) {
+      if (want_warnings && s->first_time_not_found()) {
 	unsigned char input_code = s->get_ascii_code();
 	if (input_code != 0) {
 	  if (csgraph(input_code))
-	    warning(WARN_CHAR, "can't find character '%1'", input_code);
+	    warning(WARN_CHAR, "character '%1' not defined",
+		    input_code);
 	  else
-	    warning(WARN_CHAR, "can't find character with input code %1",
-		    int(input_code));
+	    warning(WARN_CHAR, "character with input code %1 not"
+		    " defined", int(input_code));
 	}
 	else if (s->nm.contents()) {
 	  const char *nm = s->nm.contents();
 	  const char *backslash = (nm1 == 0) ? "\\" : "";
-	  warning(WARN_CHAR, "can't find special character '%1%2'",
+	  warning(WARN_CHAR, "special character '%1%2' not defined",
 		  backslash, nm);
 	}
       }
@@ -4964,21 +5026,21 @@
     return make_glyph_node(ci, env);
 }
 
-int character_exists(charinfo *ci, environment *env)
+bool character_exists(charinfo *ci, environment *env)
 {
   if (ci->get_special_translation() != charinfo::TRANSLATE_NONE)
-    return 1;
+    return true;
   charinfo *tem = ci->get_translation();
   if (tem)
     ci = tem;
   if (ci->get_macro())
-    return 1;
-  node *nd = make_glyph_node(ci, env, 1);
+    return true;
+  node *nd = make_glyph_node(ci, env, false /* don't want warnings */);
   if (nd) {
     delete nd;
-    return 1;
+    return true;
   }
-  return 0;
+  return false;
 }
 
 node *node::add_char(charinfo *ci, environment *env,
@@ -5868,7 +5930,7 @@
   if (old_font_table_size)
     memcpy(font_table, old_font_table,
 	   old_font_table_size*sizeof(font_info *));
-  a_delete old_font_table;
+  delete old_font_table;
   for (int i = old_font_table_size; i < font_table_size; i++)
     font_tablei = 0;
 }
@@ -5883,53 +5945,48 @@
 
 dictionary font_dictionary(50);
 
-static int mount_font_no_translate(int n, symbol name, symbol external_name,
-				   int check_only = 0)
+static bool mount_font_no_translate(int n, symbol name,
+				    symbol external_name,
+				    bool check_only = false)
 {
   assert(n >= 0);
-  // We store the address of this char in font_dictionary to indicate
+  // We store the address of this char in `font_dictionary` to indicate
   // that we've previously tried to mount the font and failed.
   static char a_char;
-  font *fm = 0;
+  font *fm = 0 /* nullptr */;
   void *p = font_dictionary.lookup(external_name);
-  if (p == 0) {
-    int not_found;
-    fm = font::load_font(external_name.contents(), &not_found, check_only);
+  if (0 /* nullptr */ == p) {
+    fm = font::load_font(external_name.contents(), check_only);
     if (check_only)
-      return fm != 0;
-    if (!fm) {
-      if (not_found)
-	warning(WARN_FONT, "can't find font '%1'", external_name.contents());
+      return fm != 0 /* nullptr */;
+    if (0 /* nullptr */ == fm) {
       (void)font_dictionary.lookup(external_name, &a_char);
-      return 0;
+      return false;
     }
     (void)font_dictionary.lookup(name, fm);
   }
   else if (p == &a_char) {
-#if 0
-    error("invalid font '%1'", external_name.contents());
-#endif
-    return 0;
+    return false;
   }
   else
     fm = (font*)p;
   if (check_only)
-    return 1;
+    return true;
   if (n >= font_table_size) {
     if (n - font_table_size > 1000) {
       error("font position too much larger than first unused position");
-      return 0;
+      return false;
     }
     grow_font_table(n);
   }
-  else if (font_tablen != 0)
+  else if (font_tablen != 0 /* nullptr */)
     delete font_tablen;
   font_tablen = new font_info(name, n, external_name, fm);
   font_family::invalidate_fontno(n);
-  return 1;
+  return true;
 }
 
-int mount_font(int n, symbol name, symbol external_name)
+bool mount_font(int n, symbol name, symbol external_name)
 {
   assert(n >= 0);
   name = get_font_translation(name);
@@ -5944,7 +6001,7 @@
 {
   if (check_style(name))
     name = concat(fam, name);
-  return mount_font_no_translate(0, name, name, 1);
+  return mount_font_no_translate(0, name, name, true /* check only */);
 }
 
 int check_style(symbol s)
@@ -5953,27 +6010,29 @@
   return i < 0 ? 0 : font_tablei->is_style();
 }
 
-void mount_style(int n, symbol name)
+bool mount_style(int n, symbol name)
 {
   assert(n >= 0);
   if (n >= font_table_size) {
     if (n - font_table_size > 1000) {
       error("font position too much larger than first unused position");
-      return;
+      return false;
     }
     grow_font_table(n);
   }
   else if (font_tablen != 0)
     delete font_tablen;
-  font_tablen = new font_info(get_font_translation(name), n, NULL_SYMBOL, 0);
+  font_tablen = new font_info(get_font_translation(name), n,
+				NULL_SYMBOL, 0);
   font_family::invalidate_fontno(n);
+  return true;
 }
 
 /* global functions */
 
 void font_translate()
 {
-  symbol from = get_name(1);
+  symbol from = get_name(true /* required */);
   if (!from.is_null()) {
     symbol to = get_name();
     if (to.is_null() || from == to)
@@ -5991,10 +6050,18 @@
     if (n < 0)
       error("negative font position");
     else {
-      symbol internal_name = get_name(1);
+      symbol internal_name = get_name(true /* required */);
       if (!internal_name.is_null()) {
 	symbol external_name = get_long_name();
-	mount_font(n, internal_name, external_name); // ignore error
+	if (!mount_font(n, internal_name, external_name)) {
+	  string msg;
+	  if (external_name != 0 /* nullptr */)
+	    msg += string(" from file '") + external_name.contents()
+	      + string("'");
+	  msg += '\0';
+	  error("cannot load font '%1'%2 for mounting",
+		internal_name.contents(), msg.contents());
+	}
       }
     }
   }
@@ -6011,55 +6078,53 @@
 
 font_family::~font_family()
 {
-  a_delete map;
+  delete map;
 }
 
-int font_family::make_definite(int i)
-{
-  if (i >= 0) {
-    if (i < map_size && mapi >= 0)
-      return mapi;
-    else {
-      if (i < font_table_size && font_tablei != 0) {
-	if (i >= map_size) {
-	  int old_map_size = map_size;
-	  int *old_map = map;
-	  map_size *= 3;
-	  map_size /= 2;
-	  if (i >= map_size)
-	    map_size = i + 10;
-	  map = new intmap_size;
-	  memcpy(map, old_map, old_map_size*sizeof(int));
-	  a_delete old_map;
-	  for (int j = old_map_size; j < map_size; j++)
-	    mapj = -1;
-	}
-	if (font_tablei->is_style()) {
-	  symbol sty = font_tablei->get_name();
-	  symbol f = concat(nm, sty);
-	  int n;
-	  // don't use symbol_fontno, because that might return a style
-	  // and because we don't want to translate the name
-	  for (n = 0; n < font_table_size; n++)
-	    if (font_tablen != 0 && font_tablen->is_named(f)
-		&& !font_tablen->is_style())
-	      break;
-	  if (n >= font_table_size) {
-	    n = next_available_font_position();
-	    if (!mount_font_no_translate(n, f, f))
-	      return -1;
-	  }
-	  return mapi = n;
-	}
-	else
-	  return mapi = i;
-      }
-      else
-	return -1;
-    }
-  }
-  else
+// Resolve a requested font mounting position to a mounting position
+// usable by the output driver.  (Positions 1 through 4 are typically
+// allocated to styles, and are not usable thus.)  A return value of
+// `-1` indicates failure.
+int font_family::make_definite(int mounting_position)
+{
+  assert(mounting_position >= 0);
+  int pos = mounting_position;
+  if (pos < 0)
     return -1;
+  if (pos < map_size && mappos >= 0)
+    return mappos;
+  if (!(pos < font_table_size && font_tablepos != 0))
+    return -1;
+  if (pos >= map_size) {
+    int old_map_size = map_size;
+    int *old_map = map;
+    map_size *= 3;
+    map_size /= 2;
+    if (pos >= map_size)
+      map_size = pos + 10;
+    map = new intmap_size;
+    memcpy(map, old_map, old_map_size * sizeof (int));
+    delete old_map;
+    for (int j = old_map_size; j < map_size; j++)
+      mapj = -1;
+  }
+  if (!(font_tablepos->is_style()))
+    return mappos = pos;
+  symbol sty = font_tablepos->get_name();
+  symbol f = concat(nm, sty);
+  int n;
+  // Don't use symbol_fontno, because that might return a style and
+  // because we don't want to translate the name.
+  for (n = 0; n < font_table_size; n++)
+    if (font_tablen != 0 && font_tablen->is_named(f)
+	&& !font_tablen->is_style())
+      break;
+  if (n >= font_table_size) {
+    n = next_available_font_position();
+    if (!mount_font_no_translate(n, f, f))
+      return -1;
+  }
+  return mappos = n;
 }
 
 dictionary family_dictionary(5);
@@ -6097,46 +6162,62 @@
     if (n < 0)
       error("negative font position");
     else {
-      symbol internal_name = get_name(1);
+      symbol internal_name = get_name(true /* required */);
       if (!internal_name.is_null())
-	mount_style(n, internal_name);
+	(void) mount_style(n, internal_name);
     }
   }
   skip_line();
 }
 
-static int get_fontno()
+static void font_lookup_error(font_lookup_info& finfo,
+			      const char *msg)
+{
+  if (finfo.requested_name)
+    error("cannot load font '%1' %2", finfo.requested_name, msg);
+  else
+    error("cannot load font at position %1 %2",
+	  finfo.requested_position, msg);
+}
+
+// Read the next token and look it up as a font name or position number.
+// Return lookup success.  Store, in the supplied struct argument, the
+// requested name or position, and the position actually resolved; -1
+// means not found (see `font_lookup_info` constructor).
+static bool has_font(font_lookup_info *finfo)
 {
   int n;
   tok.skip();
-  if (tok.delimiter()) {
-    symbol s = get_name(1);
+  if (tok.usable_as_delimiter()) {
+    symbol s = get_name(true /* required */);
+    finfo->requested_name = (char *)s.contents();
     if (!s.is_null()) {
       n = symbol_fontno(s);
       if (n < 0) {
 	n = next_available_font_position();
-	if (!mount_font(n, s))
-	  return -1;
+	if (mount_font(n, s))
+	  finfo->position = n;
       }
-      return curenv->get_family()->make_definite(n);
+      finfo->position = curenv->get_family()->make_definite(n);
     }
   }
   else if (get_integer(&n)) {
-    if (n < 0 || n >= font_table_size || font_tablen == 0)
-      error("bad font number");
-    else
-      return curenv->get_family()->make_definite(n);
+    finfo->requested_position = n;
+    if (!(n < 0 || n >= font_table_size || font_tablen == 0))
+      finfo->position = curenv->get_family()->make_definite(n);
   }
-  return -1;
+  return (finfo->position != -1);
 }
 
 static int underline_fontno = 2;
 
 void underline_font()
 {
-  int n = get_fontno();
-  if (n >= 0)
-    underline_fontno = n;
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "to make it the underline font");
+  else
+    underline_fontno = finfo.position;
   skip_line();
 }
 
@@ -6147,38 +6228,43 @@
 
 void define_font_special_character()
 {
-  int n = get_fontno();
-  if (n < 0) {
+  font_lookup_info finfo;
+  if (!has_font(&finfo)) {
+    font_lookup_error(finfo, "to define font-specific fallback glyph");
+    // Normally we skip the remainder of the line unconditionally at the
+    // end of a request-implementing function, but do_define_character()
+    // will eat the rest of it for us.
     skip_line();
-    return;
   }
-  symbol f = font_tablen->get_name();
-  do_define_character(CHAR_FONT_SPECIAL, f.contents());
+  else {
+    symbol f = font_tablefinfo.position->get_name();
+    do_define_character(CHAR_FONT_SPECIAL, f.contents());
+  }
 }
 
 void remove_font_special_character()
 {
-  int n = get_fontno();
-  if (n < 0) {
-    skip_line();
-    return;
-  }
-  symbol f = font_tablen->get_name();
-  while (!tok.newline() && !tok.eof()) {
-    if (!tok.space() && !tok.tab()) {
-      charinfo *s = tok.get_char(1);
-      string gl(f.contents());
-      gl += ' ';
-      gl += s->nm.contents();
-      gl += '\0';
-      charinfo *ci = get_charinfo(symbol(gl.contents()));
-      if (!ci)
-	break;
-      macro *m = ci->set_macro(0);
-      if (m)
-	delete m;
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "to remove font-specific fallback glyph");
+  else {
+    symbol f = font_tablefinfo.position->get_name();
+    while (!tok.is_newline() && !tok.is_eof()) {
+      if (!tok.is_space() && !tok.is_tab()) {
+	charinfo *s = tok.get_char(true /* required */);
+	string gl(f.contents());
+	gl += ' ';
+	gl += s->nm.contents();
+	gl += '\0';
+	charinfo *ci = get_charinfo(symbol(gl.contents()));
+	if (!ci)
+	  break;
+	macro *m = ci->set_macro(0);
+	if (m)
+	  delete m;
+      }
+      tok.next();
     }
-    tok.next();
   }
   skip_line();
 }
@@ -6194,10 +6280,12 @@
   }
   special_font_list **p = sp;
   while (has_arg()) {
-    int i = get_fontno();
-    if (i >= 0) {
+    font_lookup_info finfo;
+    if (!has_font(&finfo))
+      font_lookup_error(finfo, "to mark it as special");
+    else {
       special_font_list *tem = new special_font_list;
-      tem->n = i;
+      tem->n = finfo.position;
       tem->next = 0;
       *p = tem;
       p = &(tem->next);
@@ -6207,9 +6295,12 @@
 
 void font_special_request()
 {
-  int n = get_fontno();
-  if (n >= 0)
-    read_special_fonts(&font_tablen->sf);
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "to mark other fonts as special"
+			     " contingently upon it"); // a mouthful :-/
+  else
+    read_special_fonts(&font_tablefinfo.position->sf);
   skip_line();
 }
 
@@ -6221,8 +6312,11 @@
 
 void font_zoom_request()
 {
-  int n = get_fontno();
-  if (n >= 0) {
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "to set a zoom factor for it");
+  else {
+    int n = finfo.position;
     if (font_tablen->is_style())
       warning(WARN_FONT, "can't set zoom factor for a style");
     else {
@@ -6329,12 +6423,23 @@
 
 void bold_font()
 {
-  int n = get_fontno();
-  if (n >= 0) {
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "for emboldening");
+  else {
+    int n = finfo.position;
     if (has_arg()) {
-      if (tok.delimiter()) {
-	int f = get_fontno();
-	if (f >= 0) {
+      // This is a bit non-orthogonal, but faithful to CSTR #54.  We can
+      // only conditionally embolden a font specified by name, not
+      // position, so ".bd S B 4" works but ".bd 5 3 4" does not.  The
+      // latter bolds the font at position 5 unconditionally, and
+      // ignores the third argument.
+      if (tok.usable_as_delimiter()) {
+      font_lookup_info finfo2;
+	if (!has_font(&finfo2))
+	  font_lookup_error(finfo2, "for conditional emboldening");
+	else {
+	  int f = finfo2.position;
 	  units offset;
 	  if (has_arg() && get_number(&offset, 'u') && offset >= 1)
 	    font_tablef->set_conditional_bold(n, hunits(offset - 1));
@@ -6343,6 +6448,9 @@
 	}
       }
       else {
+	font_lookup_info finfo2;
+	  if (!has_font(&finfo2))
+	    font_lookup_error(finfo2, "for conditional emboldening");
 	units offset;
 	if (get_number(&offset, 'u') && offset >= 1)
 	  font_tablen->set_bold(hunits(offset - 1));
@@ -6410,9 +6518,11 @@
 
 void track_kern()
 {
-  int n = get_fontno();
-  if (n >= 0) {
-    int min_s, max_s;
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "for track kerning");
+  else {
+    int n = finfo.position, min_s, max_s;
     hunits min_a, max_a;
     if (has_arg()
 	&& get_number(&min_s, 'z')
@@ -6432,9 +6542,11 @@
 
 void constant_space()
 {
-  int n = get_fontno();
-  if (n >= 0) {
-    int x, y;
+  font_lookup_info finfo;
+  if (!has_font(&finfo))
+    font_lookup_error(finfo, "for constant spacing");
+  else {
+    int n = finfo.position, x, y;
     if (!has_arg() || !get_integer(&x))
       font_tablen->set_constant_space(CONSTANT_SPACE_NONE);
     else {
@@ -6528,11 +6640,17 @@
   init_request("sty", style);
   init_request("tkf", track_kern);
   init_request("uf", underline_font);
-  number_reg_dictionary.define(".fp", new next_available_font_position_reg);
-  number_reg_dictionary.define(".kern",
-			       new constant_int_reg(&global_kern_mode));
-  number_reg_dictionary.define(".lg",
-			       new constant_int_reg(&global_ligature_mode));
-  number_reg_dictionary.define(".P", new printing_reg);
+  register_dictionary.define(".fp", new next_available_font_position_reg);
+  register_dictionary.define(".kern",
+			       new readonly_register(&global_kern_mode));
+  register_dictionary.define(".lg",
+			       new readonly_register(&global_ligature_mode));
+  register_dictionary.define(".P", new printing_reg);
   soft_hyphen_char = get_charinfo(HYPHEN_SYMBOL);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/node.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/node.h Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -597,7 +597,7 @@
 
 class charinfo;
 node *make_node(charinfo *, environment *);
-int character_exists(charinfo *, environment *);
+bool character_exists(charinfo *, environment *);
 
 int same_node_list(node *, node *);
 node *reverse_node_list(node *);
@@ -612,10 +612,10 @@
 }
 
 extern void read_desc();
-extern int mount_font(int, symbol, symbol = NULL_SYMBOL);
+extern bool mount_font(int, symbol, symbol = NULL_SYMBOL);
 extern int check_font(symbol, symbol);
 extern int check_style(symbol);
-extern void mount_style(int, symbol);
+extern bool mount_style(int, symbol);
 extern int is_good_fontno(int);
 extern int symbol_fontno(symbol);
 extern int next_available_font_position();
@@ -626,6 +626,7 @@
   char make_g_plus_plus_shut_up;
 public:
   output_file();
+  bool is_dying;
   virtual ~output_file();
   virtual void trailer(vunits);
   virtual void flush() = 0;

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/number.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/number.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -26,24 +25,25 @@
 #include "token.h"
 #include "div.h"
 
-vunits V0;
-hunits H0;
+const vunits V0; // zero in vertical units
+const hunits H0; // zero in horizontal units
 
 int hresolution = 1;
 int vresolution = 1;
 int units_per_inch;
 int sizescale;
 
-static int parse_expr(units *v, int scale_indicator,
-		      int parenthesised, int rigid = 0);
-static int start_number();
+static bool is_valid_expression(units *v, int scaling_unit,
+				bool is_parenthesized,
+				bool is_mandatory = false);
+static bool is_valid_expression_start();
 
 int get_vunits(vunits *res, unsigned char si)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return 0;
   units x;
-  if (parse_expr(&x, si, 0)) {
+  if (is_valid_expression(&x, si, false /* is_parenthesized */)) {
     *res = vunits(x);
     return 1;
   }
@@ -53,10 +53,10 @@
 
 int get_hunits(hunits *res, unsigned char si)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return 0;
   units x;
-  if (parse_expr(&x, si, 0)) {
+  if (is_valid_expression(&x, si, false /* is_parenthesized */)) {
     *res = hunits(x);
     return 1;
   }
@@ -68,10 +68,11 @@
 
 int get_number_rigidly(units *res, unsigned char si)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return 0;
   units x;
-  if (parse_expr(&x, si, 0, 1)) {
+  if (is_valid_expression(&x, si, false /* is_parenthesized */,
+			  true /* is_mandatory */)) {
     *res = x;
     return 1;
   }
@@ -81,10 +82,10 @@
 
 int get_number(units *res, unsigned char si)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return 0;
   units x;
-  if (parse_expr(&x, si, 0)) {
+  if (is_valid_expression(&x, si, false /* is_parenthesized */)) {
     *res = x;
     return 1;
   }
@@ -94,10 +95,10 @@
 
 int get_integer(int *res)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return 0;
   units x;
-  if (parse_expr(&x, 0, 0)) {
+  if (is_valid_expression(&x, 0, false /* is_parenthesized */)) {
     *res = x;
     return 1;
   }
@@ -125,7 +126,7 @@
     *res = prev_value - v;
     break;
   default:
-    assert(0);
+    assert(0 == "unhandled switch case returned by get_incr_number()");
   }
   return 1;
 }
@@ -146,7 +147,7 @@
     *res = prev_value - v;
     break;
   default:
-    assert(0);
+    assert(0 == "unhandled switch case returned by get_incr_number()");
   }
   return 1;
 }
@@ -167,7 +168,7 @@
     *res = prev_value - v;
     break;
   default:
-    assert(0);
+    assert(0 == "unhandled switch case returned by get_incr_number()");
   }
   return 1;
 }
@@ -188,7 +189,7 @@
     *res = prev_value - int(v);
     break;
   default:
-    assert(0);
+    assert(0 == "unhandled switch case returned by get_incr_number()");
   }
   return 1;
 }
@@ -196,7 +197,7 @@
 
 static incr_number_result get_incr_number(units *res, unsigned char si)
 {
-  if (!start_number())
+  if (!is_valid_expression_start())
     return BAD;
   incr_number_result result = ABSOLUTE;
   if (tok.ch() == '+') {
@@ -207,44 +208,48 @@
     tok.next();
     result = DECREMENT;
   }
-  if (parse_expr(res, si, 0))
+  if (is_valid_expression(res, si, false /* is_parenthesized */))
     return result;
   else
     return BAD;
 }
 
-static int start_number()
+static bool is_valid_expression_start()
 {
-  while (tok.space())
+  while (tok.is_space())
     tok.next();
-  if (tok.newline()) {
-    warning(WARN_MISSING, "missing number");
-    return 0;
+  if (tok.is_newline()) {
+    warning(WARN_MISSING, "numeric expression missing");
+    return false;
   }
-  if (tok.tab()) {
-    warning(WARN_TAB, "tab character where number expected");
-    return 0;
+  if (tok.is_tab()) {
+    warning(WARN_TAB, "expected numeric expression, got %1",
+	    tok.description());
+    return false;
   }
-  if (tok.right_brace()) {
-    warning(WARN_RIGHT_BRACE, "'\\}' where number expected");
-    return 0;
+  if (tok.is_right_brace()) {
+    warning(WARN_RIGHT_BRACE, "expected numeric expression, got right"
+	    "brace escape sequence");
+    return false;
   }
-  return 1;
+  return true;
 }
 
 enum { OP_LEQ = 'L', OP_GEQ = 'G', OP_MAX = 'X', OP_MIN = 'N' };
 
-#define SCALE_INDICATOR_CHARS "icfPmnpuvMsz"
+#define SCALING_UNITS "icfPmnpuvMsz"
 
-static int parse_term(units *v, int scale_indicator,
-		      int parenthesised, int rigid);
+static bool is_valid_term(units *v, int scaling_unit,
+			  bool is_parenthesized, bool is_mandatory);
 
-static int parse_expr(units *v, int scale_indicator,
-		      int parenthesised, int rigid)
+static bool is_valid_expression(units *v, int scaling_unit,
+				bool is_parenthesized,
+				bool is_mandatory)
 {
-  int result = parse_term(v, scale_indicator, parenthesised, rigid);
+  int result = is_valid_term(v, scaling_unit, is_parenthesized,
+			     is_mandatory);
   while (result) {
-    if (parenthesised)
+    if (is_parenthesized)
       tok.skip();
     int op = tok.ch();
     switch (op) {
@@ -288,8 +293,9 @@
       return result;
     }
     units v2;
-    if (!parse_term(&v2, scale_indicator, parenthesised, rigid))
-      return 0;
+    if (!is_valid_term(&v2, scaling_unit, is_parenthesized,
+		       is_mandatory))
+      return false;
     int overflow = 0;
     switch (op) {
     case '<':
@@ -332,7 +338,7 @@
       }
       if (overflow) {
 	error("addition overflow");
-	return 0;
+	return false;
       }
       *v += v2;
       break;
@@ -347,7 +353,7 @@
       }
       if (overflow) {
 	error("subtraction overflow");
-	return 0;
+	return false;
       }
       *v -= v2;
       break;
@@ -370,37 +376,37 @@
       }
       if (overflow) {
 	error("multiplication overflow");
-	return 0;
+	return false;
       }
       *v *= v2;
       break;
     case '/':
       if (v2 == 0) {
 	error("division by zero");
-	return 0;
+	return false;
       }
       *v /= v2;
       break;
     case '%':
       if (v2 == 0) {
 	error("modulus by zero");
-	return 0;
+	return false;
       }
       *v %= v2;
       break;
     default:
-      assert(0);
+      assert(0 == "unhandled switch case while processing operator");
     }
   }
   return result;
 }
 
-static int parse_term(units *v, int scale_indicator,
-		      int parenthesised, int rigid)
+static bool is_valid_term(units *v, int scaling_unit,
+			  bool is_parenthesized, bool is_mandatory)
 {
   int negative = 0;
   for (;;)
-    if (parenthesised && tok.space())
+    if (is_parenthesized && tok.is_space())
       tok.next();
     else if (tok.ch() == '+')
       tok.next();
@@ -416,78 +422,79 @@
     // | is not restricted to the outermost level
     // tbl uses this
     tok.next();
-    if (!parse_term(v, scale_indicator, parenthesised, rigid))
-      return 0;
+    if (!is_valid_term(v, scaling_unit, is_parenthesized, is_mandatory))
+      return false;
     int tem;
-    tem = (scale_indicator == 'v'
+    tem = (scaling_unit == 'v'
 	   ? curdiv->get_vertical_position().to_units()
 	   : curenv->get_input_line_position().to_units());
     if (tem >= 0) {
       if (*v < INT_MIN + tem) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
     }
     else {
       if (*v > INT_MAX + tem) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
     }
     *v -= tem;
     if (negative) {
       if (*v == INT_MIN) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
       *v = -*v;
     }
-    return 1;
+    return true;
   case '(':
     tok.next();
     c = tok.ch();
     if (c == ')') {
-      if (rigid)
-	return 0;
+      if (is_mandatory)
+	return false;
       warning(WARN_SYNTAX, "empty parentheses");
       tok.next();
       *v = 0;
-      return 1;
+      return true;
     }
-    else if (c != 0 && strchr(SCALE_INDICATOR_CHARS, c) != 0) {
+    else if (c != 0 && strchr(SCALING_UNITS, c) != 0) {
       tok.next();
       if (tok.ch() == ';') {
 	tok.next();
-	scale_indicator = c;
+	scaling_unit = c;
       }
       else {
-	error("expected ';' after scale-indicator (got %1)",
+	error("expected ';' after scaling unit, got %1",
 	      tok.description());
-	return 0;
+	return false;
       }
     }
     else if (c == ';') {
-      scale_indicator = 0;
+      scaling_unit = 0;
       tok.next();
     }
-    if (!parse_expr(v, scale_indicator, 1, rigid))
-      return 0;
+    if (!is_valid_expression(v, scaling_unit,
+			     true /* is_parenthesized */, is_mandatory))
+      return false;
     tok.skip();
     if (tok.ch() != ')') {
-      if (rigid)
-	return 0;
-      warning(WARN_SYNTAX, "missing ')' (got %1)", tok.description());
+      if (is_mandatory)
+	return false;
+      warning(WARN_SYNTAX, "expected ')', got %1", tok.description());
     }
     else
       tok.next();
     if (negative) {
       if (*v == INT_MIN) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
       *v = -*v;
     }
-    return 1;
+    return true;
   case '.':
     *v = 0;
     break;
@@ -505,12 +512,12 @@
     do {
       if (*v > INT_MAX/10) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
       *v *= 10;
       if (*v > INT_MAX - (int(c) - '0')) {
 	error("numeric overflow");
-	return 0;
+	return false;
       }
       *v += c - '0';
       tok.next();
@@ -525,13 +532,13 @@
   case '>':
   case '<':
   case '=':
-    warning(WARN_SYNTAX, "empty left operand");
+    warning(WARN_SYNTAX, "empty left operand to '%1' operator", c);
     *v = 0;
-    return rigid ? 0 : 1;
+    return is_mandatory ? false : true;
   default:
-    warning(WARN_NUMBER, "numeric expression expected (got %1)",
+    warning(WARN_NUMBER, "expected numeric expression, got %1",
 	    tok.description());
-    return 0;
+    return false;
   }
   int divisor = 1;
   if (tok.ch() == '.') {
@@ -549,34 +556,34 @@
       tok.next();
     }
   }
-  int si = scale_indicator;
+  int si = scaling_unit;
   int do_next = 0;
-  if ((c = tok.ch()) != 0 && strchr(SCALE_INDICATOR_CHARS, c) != 0) {
-    switch (scale_indicator) {
+  if ((c = tok.ch()) != 0 && strchr(SCALING_UNITS, c) != 0) {
+    switch (scaling_unit) {
+    case 0:
+      warning(WARN_SCALE, "scaling unit invalid in context");
+      break;
     case 'z':
       if (c != 'u' && c != 'z') {
-	warning(WARN_SCALE,
-		"only 'z' and 'u' scale indicators valid in this context");
+	warning(WARN_SCALE, "'%1' scaling unit invalid in context;"
+		" convert to 'z' or 'u'", c);
 	break;
       }
       si = c;
       break;
-    case 0:
-      warning(WARN_SCALE, "scale indicator invalid in this context");
-      break;
     case 'u':
       si = c;
       break;
     default:
       if (c == 'z') {
-	warning(WARN_SCALE, "'z' scale indicator invalid in this context");
+	warning(WARN_SCALE, "'z' scaling unit invalid in context");
 	break;
       }
       si = c;
       break;
     }
-    // Don't do tok.next() here because the next token might be \s, which
-    // would affect the interpretation of m.
+    // Don't do tok.next() here because the next token might be \s,
+    // which would affect the interpretation of m.
     do_next = 1;
   }
   switch (si) {
@@ -604,20 +611,23 @@
     {
       // Convert to hunits so that with -Tascii 'm' behaves as in nroff.
       hunits em = curenv->get_size();
-      *v = scale(*v, em.is_zero() ? hresolution : em.to_units(), divisor);
+      *v = scale(*v, em.is_zero() ? hresolution : em.to_units(),
+		 divisor);
     }
     break;
   case 'M':
     {
       hunits em = curenv->get_size();
-      *v = scale(*v, em.is_zero() ? hresolution : em.to_units(), divisor*100);
+      *v = scale(*v, em.is_zero() ? hresolution : em.to_units(),
+		 (divisor * 100));
     }
     break;
   case 'n':
     {
       // Convert to hunits so that with -Tascii 'n' behaves as in nroff.
-      hunits en = curenv->get_size()/2;
-      *v = scale(*v, en.is_zero() ? hresolution : en.to_units(), divisor);
+      hunits en = curenv->get_size() / 2;
+      *v = scale(*v, en.is_zero() ? hresolution : en.to_units(),
+		 divisor);
     }
     break;
   case 'v':
@@ -634,18 +644,18 @@
     *v = scale(*v, sizescale, divisor);
     break;
   default:
-    assert(0);
+    assert(0 == "unhandled switch case when processing scaling unit");
   }
   if (do_next)
     tok.next();
   if (negative) {
     if (*v == INT_MIN) {
       error("numeric overflow");
-      return 0;
+      return false;
     }
     *v = -*v;
   }
-  return 1;
+  return true;
 }
 
 units scale(units n, units x, units y)
@@ -675,22 +685,28 @@
 
 vunits::vunits(units x)
 {
-  // don't depend on the rounding direction for division of negative integers
+  // Don't depend on rounding direction when dividing negative integers.
   if (vresolution == 1)
     n = x;
   else
     n = (x < 0
-	 ? -((-x + vresolution/2 - 1)/vresolution)
-	 : (x + vresolution/2 - 1)/vresolution);
+	 ? -((-x + (vresolution / 2) - 1) / vresolution)
+	 : (x + (vresolution / 2) - 1) / vresolution);
 }
 
 hunits::hunits(units x)
 {
-  // don't depend on the rounding direction for division of negative integers
+  // Don't depend on rounding direction when dividing negative integers.
   if (hresolution == 1)
     n = x;
   else
     n = (x < 0
-	 ? -((-x + hresolution/2 - 1)/hresolution)
-	 : (x + hresolution/2 - 1)/hresolution);
+	 ? -((-x + (hresolution / 2) - 1) / hresolution)
+	 : (x + (hresolution / 2) - 1) / hresolution);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/reg.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/reg.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -23,11 +22,11 @@
 #include "request.h"
 #include "reg.h"
 
-object_dictionary number_reg_dictionary(101);
+object_dictionary register_dictionary(101);
 
-int reg::get_value(units * /*d*/)
+bool reg::get_value(units * /*d*/)
 {
-  return 0;
+  return false;
 }
 
 void reg::increment()
@@ -42,12 +41,12 @@
 
 void reg::set_increment(units /*n*/)
 {
-  error("can't auto increment read-only register");
+  error("can't automatically increment read-only register");
 }
 
 void reg::alter_format(char /*f*/, int /*w*/)
 {
-  error("can't alter format of read-only register");
+  error("can't assign format of read-only register");
 }
 
 const char *reg::get_format()
@@ -265,7 +264,7 @@
   units value;
 public:
   number_reg();
-  int get_value(units *);
+  bool get_value(units *);
   void set_value(units);
 };
 
@@ -273,10 +272,10 @@
 {
 }
 
-int number_reg::get_value(units *res)
+bool number_reg::get_value(units *res)
 {
   *res = value;
-  return 1;
+  return true;
 }
 
 void number_reg::set_value(units n)
@@ -293,20 +292,20 @@
   *ptr = n;
 }
 
-int variable_reg::get_value(units *res)
+bool variable_reg::get_value(units *res)
 {
   *res = *ptr;
-  return 1;
+  return true;
 }
 
 void define_number_reg()
 {
-  symbol nm = get_name(1);
+  symbol nm = get_name(true /* required */);
   if (nm.is_null()) {
     skip_line();
     return;
   }
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   units v;
   units prev_value;
   if (!r || !r->get_value(&prev_value))
@@ -314,10 +313,10 @@
   if (get_number(&v, 'u', prev_value)) {
     if (r == 0) {
       r = new number_reg;
-      number_reg_dictionary.define(nm, r);
+      register_dictionary.define(nm, r);
     }
     r->set_value(v);
-    if (tok.space() && has_arg() && get_number(&v, 'u'))
+    if (tok.is_space() && has_arg() && get_number(&v, 'u'))
       r->set_increment(v);
   }
   skip_line();
@@ -328,16 +327,16 @@
 {
   token start;
   start.next();
-  if (!start.delimiter(1))
+  if (!start.delimiter(true /* report error */))
     return;
   tok.next();
-  symbol nm = get_name(1);
+  symbol nm = get_name(true /* required */);
   if (nm.is_null())
     return;
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   if (r == 0) {
     r = new number_reg;
-    number_reg_dictionary.define(nm, r);
+    register_dictionary.define(nm, r);
   }
   units v;
   units prev_value;
@@ -358,36 +357,36 @@
 
 void set_number_reg(symbol nm, units n)
 {
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   if (r == 0) {
     r = new number_reg;
-    number_reg_dictionary.define(nm, r);
+    register_dictionary.define(nm, r);
   }
   r->set_value(n);
 }
 
 reg *lookup_number_reg(symbol nm)
 {
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   if (r == 0) {
-    warning(WARN_REG, "number register '%1' not defined", nm.contents());
+    warning(WARN_REG, "register '%1' not defined", nm.contents());
     r = new number_reg;
-    number_reg_dictionary.define(nm, r);
+    register_dictionary.define(nm, r);
   }
   return r;
 }
 
 void alter_format()
 {
-  symbol nm = get_name(1);
+  symbol nm = get_name(true /* required */);
   if (nm.is_null()) {
     skip_line();
     return;
   }
-  reg *r = (reg *)number_reg_dictionary.lookup(nm);
+  reg *r = (reg *)register_dictionary.lookup(nm);
   if (r == 0) {
     r = new number_reg;
-    number_reg_dictionary.define(nm, r);
+    register_dictionary.define(nm, r);
   }
   tok.skip();
   char c = tok.ch();
@@ -401,10 +400,13 @@
   }
   else if (c == 'i' || c == 'I' || c == 'a' || c == 'A')
     r->alter_format(c);
-  else if (tok.newline() || tok.eof())
-    warning(WARN_MISSING, "missing number register format");
+  else if (tok.is_newline() || tok.is_eof())
+    warning(WARN_MISSING, "missing register format");
   else
-    error("bad number register format (got %1)", tok.description());
+    if (!cscntrl(c))
+      error("invalid register format '%1'", c);
+    else
+      error("invalid register format (got %1)", tok.description());
   skip_line();
 }
 
@@ -414,19 +416,19 @@
     symbol s = get_name();
     if (s.is_null())
       break;
-    number_reg_dictionary.remove(s);
+    register_dictionary.remove(s);
   }
   skip_line();
 }
 
 void alias_reg()
 {
-  symbol s1 = get_name(1);
+  symbol s1 = get_name(true /* required */);
   if (!s1.is_null()) {
-    symbol s2 = get_name(1);
+    symbol s2 = get_name(true /* required */);
     if (!s2.is_null()) {
-      if (!number_reg_dictionary.alias(s1, s2))
-	warning(WARN_REG, "number register '%1' not defined", s2.contents());
+      if (!register_dictionary.alias(s1, s2))
+	warning(WARN_REG, "register '%1' not defined", s2.contents());
     }
   }
   skip_line();
@@ -434,18 +436,18 @@
 
 void rename_reg()
 {
-  symbol s1 = get_name(1);
+  symbol s1 = get_name(true /* required */);
   if (!s1.is_null()) {
-    symbol s2 = get_name(1);
+    symbol s2 = get_name(true /* required */);
     if (!s2.is_null())
-      number_reg_dictionary.rename(s1, s2);
+      register_dictionary.rename(s1, s2);
   }
   skip_line();
 }
 
 void print_number_regs()
 {
-  object_dictionary_iterator iter(number_reg_dictionary);
+  object_dictionary_iterator iter(register_dictionary);
   reg *r;
   symbol s;
   while (iter.get(&s, (object **)&r)) {
@@ -469,3 +471,9 @@
   init_request("rnn", rename_reg);
   init_request("pnr", print_number_regs);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/reg.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/reg.h Changed

@@ -1,5 +1,5 @@
 // -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -21,7 +21,7 @@
 class reg : public object {
 public:
   virtual const char *get_string() = 0;
-  virtual int get_value(units *);
+  virtual bool get_value(units *);
   virtual void increment();
   virtual void decrement();
   virtual void set_increment(units);
@@ -30,10 +30,10 @@
   virtual void set_value(units);
 };
 
-class constant_int_reg : public reg {
+class readonly_register : public reg {
   int *p;
 public:
-  constant_int_reg(int *);
+  readonly_register(int *);
   const char *get_string();
 };
 
@@ -52,7 +52,7 @@
   void add_value(units);
 
   void set_value(units) = 0;
-  int get_value(units *) = 0;
+  bool get_value(units *) = 0;
 };
 
 class variable_reg : public general_reg {
@@ -60,10 +60,10 @@
 public:
   variable_reg(int *);
   void set_value(units);
-  int get_value(units *);
+  bool get_value(units *);
 };
 
-extern object_dictionary number_reg_dictionary;
+extern object_dictionary register_dictionary;
 extern void set_number_reg(symbol nm, units n);
 extern void check_output_limits(int x, int y);
 extern void reset_output_registers();

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/request.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/request.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -24,14 +23,14 @@
 class request_or_macro : public object {
 public:
   request_or_macro();
-  virtual void invoke(symbol, int) = 0;
+  virtual void invoke(symbol, bool) = 0;
   virtual macro *to_macro();
 };
 
 class request : public request_or_macro {
   REQUEST_FUNCP p;
 public:
-  void invoke(symbol, int);
+  void invoke(symbol, bool);
   request(REQUEST_FUNCP);
 };
 
@@ -64,7 +63,7 @@
   void set(unsigned char, int);
   unsigned char get(int);
   int length();
-  void invoke(symbol, int);
+  void invoke(symbol, bool);
   macro *to_macro();
   void print_size();
   int empty();
@@ -90,3 +89,9 @@
 class environment;
 
 node *charinfo_to_node_list(charinfo *, const environment *);
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/token.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/token.h Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -68,33 +67,32 @@
   void next();
   void process();
   void skip();
-  int eof();
-  int nspaces();		// 1 if space, 2 if double space, 0 otherwise
-  int space();			// is the current token a space?
-  int stretchable_space();	// is the current token a stretchable space?
-  int unstretchable_space();	// is the current token an unstretchable space?
-  int horizontal_space();	// is the current token a horizontal space?
-  int white_space();		// is the current token space or tab?
-  int special();		// is the current token a special character?
-  int newline();		// is the current token a newline?
-  int tab();			// is the current token a tab?
-  int leader();
-  int backspace();
-  int delimiter(int warn = 0);	// is it suitable for use as a delimiter?
-  int dummy();
-  int transparent_dummy();
-  int transparent();
-  int left_brace();
-  int right_brace();
-  int page_ejector();
-  int hyphen_indicator();
-  int zero_width_break();
+  int nspaces();		// 1 if space, 0 otherwise
+  bool is_eof();
+  bool is_space();
+  bool is_stretchable_space();
+  bool is_unstretchable_space();
+  bool is_horizontal_space();
+  bool is_white_space();
+  bool is_special();
+  bool is_newline();
+  bool is_tab();
+  bool is_leader();
+  bool is_backspace();
+  bool usable_as_delimiter(bool = false);
+  bool is_dummy();
+  bool is_transparent_dummy();
+  bool is_transparent();
+  bool is_left_brace();
+  bool is_right_brace();
+  bool is_page_ejector();
+  bool is_hyphen_indicator();
+  bool is_zero_width_break();
   int operator==(const token &); // need this for delimiters, and for conditions
   int operator!=(const token &); // ditto
   unsigned char ch();
-  charinfo *get_char(int required = 0);
-  int add_to_node_list(node **);
-  int title();
+  charinfo *get_char(bool = false);
+  int add_to_zero_width_node_list(node **);
   void make_space();
   void make_newline();
   const char *description();
@@ -105,8 +103,8 @@
 
 extern token tok;		// the current token
 
-extern symbol get_name(int required = 0);
-extern symbol get_long_name(int required = 0);
+extern symbol get_name(bool = false);
+extern symbol get_long_name(bool = false);
 extern charinfo *get_optional_char();
 extern char *read_string();
 extern void check_missing_character();
@@ -137,55 +135,52 @@
 
 const char *asciify(int c);
 
-inline int token::newline()
-{ 
-  return type == TOKEN_NEWLINE; 
+inline bool token::is_newline()
+{
+  return type == TOKEN_NEWLINE;
 }
 
-inline int token::space()
-{ 
+inline bool token::is_space()
+{
   return type == TOKEN_SPACE;
 }
 
-inline int token::stretchable_space()
+inline bool token::is_stretchable_space()
 {
   return type == TOKEN_STRETCHABLE_SPACE;
 }
 
-inline int token::unstretchable_space()
+inline bool token::is_unstretchable_space()
 {
   return type == TOKEN_UNSTRETCHABLE_SPACE;
 }
 
-inline int token::horizontal_space()
+inline bool token::is_horizontal_space()
 {
   return type == TOKEN_HORIZONTAL_SPACE;
 }
 
-inline int token::special()
-{ 
+inline bool token::is_special()
+{
   return type == TOKEN_SPECIAL;
 }
 
 inline int token::nspaces()
 {
-  if (type == TOKEN_SPACE)
-    return 1;
-  else
-    return 0;
+  return (int)(type == TOKEN_SPACE);
 }
 
-inline int token::white_space()
+inline bool token::is_white_space()
 {
   return type == TOKEN_SPACE || type == TOKEN_TAB;
 }
 
-inline int token::transparent()
+inline bool token::is_transparent()
 {
   return type == TOKEN_TRANSPARENT;
 }
 
-inline int token::page_ejector()
+inline bool token::is_page_ejector()
 {
   return type == TOKEN_PAGE_EJECTOR;
 }
@@ -193,56 +188,62 @@
 inline unsigned char token::ch()
 {
   return type == TOKEN_CHAR ? c : 0;
-} 
+}
 
-inline int token::eof()
+inline bool token::is_eof()
 {
   return type == TOKEN_EOF;
 }
 
-inline int token::dummy()
+inline bool token::is_dummy()
 {
   return type == TOKEN_DUMMY;
 }
 
-inline int token::transparent_dummy()
+inline bool token::is_transparent_dummy()
 {
   return type == TOKEN_TRANSPARENT_DUMMY;
 }
 
-inline int token::left_brace()
+inline bool token::is_left_brace()
 {
   return type == TOKEN_LEFT_BRACE;
 }
 
-inline int token::right_brace()
+inline bool token::is_right_brace()
 {
   return type == TOKEN_RIGHT_BRACE;
 }
 
-inline int token::tab()
+inline bool token::is_tab()
 {
   return type == TOKEN_TAB;
 }
 
-inline int token::leader()
+inline bool token::is_leader()
 {
   return type == TOKEN_LEADER;
 }
 
-inline int token::backspace()
+inline bool token::is_backspace()
 {
   return type == TOKEN_BACKSPACE;
 }
 
-inline int token::hyphen_indicator()
+inline bool token::is_hyphen_indicator()
 {
   return type == TOKEN_HYPHEN_INDICATOR;
 }
 
-inline int token::zero_width_break()
+inline bool token::is_zero_width_break()
 {
   return type == TOKEN_ZERO_WIDTH_BREAK;
 }
 
-int has_arg();
+bool has_arg();
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/troff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/troff.1.man Changed

@@ -1,16 +1,16 @@
 '\" t
-.TH @G@TROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-@g@troff \- the troff processor of the groff text formatting system
-.
-.\" troff.man -> troff.1
+.TH @g@troff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+@g@troff \- GNU
+.I roff
+typesetter and document formatter
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -24,221 +24,430 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_troff_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@troff
-.OP \-abcivzCERU
-.OP \-d cs
-.OP \-f fam
-.OP \-F dir
-.OP \-I dir
-.OP \-m name
-.OP \-M dir
-.OP \-n num
-.OP \-o list
-.OP \-r cn
-.OP \-T name
-.OP \-w name
-.OP \-W name
-.RI  file
-\&.\|.\|.\&
+.RB  \-abcCEiRUz 
+.RB  \-d\~\c
+.IR ctext 
+.RB  \-d\~\c
+.IB string =\c
+.IR text 
+.RB  \-f\~\c
+.IR  font-family 
+.RB  \-F\~\c
+.IR  font-directory 
+.RB  \-I\~\c
+.IR  inclusion-directory 
+.RB  \-m\~\c
+.IR  macro-package 
+.RB  \-M\~\c
+.IR  macro-directory 
+.RB  \-n\~\c
+.IR  page-number 
+.RB  \-o\~\c
+.IR  page-list 
+.RB  \-r\~\c
+.IR  cnumeric-expression 
+.RB  \-r\~\c
+.IB register =\c
+.IR numeric-expression 
+.RB  \-T\~\c
+.IR  output-device 
+.RB  \-w\~\c
+.IR  warning-category 
+.RB  \-W\~\c
+.IR  warning-category 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY @g@troff
+.B \-\-help
+.YS
+.
+.
+.SY @g@troff
+.B \-v
+.
+.SY @g@troff
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This manual page describes the GNU version of
-.BR troff .
+GNU
+.I troff \" GNU
+transforms
+.MR groff @MAN7EXT@
+language input into the device-independent output format described in
+.MR groff_out @MAN5EXT@ ;
+.I @g@troff
+is thus the heart of the GNU
+.I roff
+document formatting system.
 .
-It is part of the groff document formatting system.
+If no
+.I file
+operands are given on the command line,
+or if
+.I file
+is
+.RB \lq \- \rq,
+the standard input stream is read.
 .
-It is functionally compatible with Unix troff, but has many
-extensions, see
-.BR \%groff_diff (@MAN7EXT@).
 .
-Usually it should be invoked using the
-.BR groff (@MAN1EXT@)
-command which will also run preprocessors and postprocessors in the
-appropriate order and with the appropriate options.
+.P
+GNU
+.I troff \" GNU
+is functionally compatible with the AT&T
+.I troff \" AT&T
+typesetter and features numerous extensions.
+.
+Many people prefer to use the
+.MR groff @MAN1EXT@
+command,
+a front end which also runs preprocessors and output drivers in the
+appropriate order and with appropriate options.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
 .B \-a
-Generate an ASCII approximation of the typeset output.
+Generate a plain text approximation of the typeset output.
+.
+The read-only register
+.B .A
+is set to\~1.
+.
+This option produces a sort of abstract preview of the formatted output.
+.
+.
+.RS
+.IP \bu 2n
+Page breaks are marked by a phrase in angle brackets;
+for example,
+\lq<beginning of page>\rq.
+.
+.
+.IP \bu
+Lines are broken where they would be in the formatted output.
+.
+.
+.IP \bu
+A horizontal motion of any size is represented as one space.
+.
+Adjacent horizontal motions are not combined.
+.
+Inter-sentence space nodes
+(those arising from the second argument to the
+.B .ss
+request)
+are not represented.
+.
+.
+.IP \bu
+Vertical motions are not represented.
+.
+.
+.IP \bu
+Special characters are rendered in angle brackets;
+for example,
+the default soft hyphen character appears as
+\lq<hy>\rq.
+.RE
+.
+.
+.IP
+The above description should not be considered a specification;
+the details of
+.B \-a
+output are subject to change.
+.
 .
 .TP
 .B \-b
-Print a backtrace with each warning or error message.
+Write a backtrace reporting the state of
+.IR @g@troff 's
+input parser to the standard error stream with each diagnostic message.
 .
-This backtrace should help track down the cause of the error.
+The line numbers given in the backtrace might not always be correct,
+because
+.IR @g@troff 's
+idea of line numbers can be confused by requests that append to
+.\" strings or (??? strings never contain newlines)
+macros.
 .
-The line numbers given in the backtrace may not always be correct, for
-.BR @g@troff 's
-idea of line numbers gets confused by
-.B as
-or
-.B am
-requests.
 .
 .TP
 .B \-c
-Disable color output (always disabled in compatibility mode).
+Start with color output disabled.
+.
 .
 .TP
 .B \-C
-Enable compatibility mode.
+Enable AT&T
+.I troff \" AT&T
+compatibility mode;
+implies
+.BR \-c .
+.
+See
+.MR groff_diff @MAN7EXT@ .
+.
 .
 .TP
-.BI \-d cs
+.BI \-d\~ ctext
 .TQ
-.BI \-d name = s
+.BI \-d\~ string = text
 Define
-.I c
+.I roff
+.RI string\~ c
 or
-.I name
-to be a string
-.IR s ;
-.I c
-must be a one letter name.
+.I string
+as
+.I text.
+.
+.IR c \~must
+be one character;
+.I string
+can be of arbitrary length.
+.
+Such string assignments happen before any macro file is loaded,
+including the startup file.
+.
+Due to
+.MR getopt_long 3
+limitations,
+.IR c\~ cannot
+be,
+and
+.I string
+cannot contain,
+an equals sign,
+even though that is a valid character in a
+.I roff
+identifier.
+.
 .
 .TP
 .B \-E
-Inhibit all error messages of
-.BR @g@troff .
-.
-Note that this doesn't affect messages output to standard error by
-macro packages using the
+Inhibit
+.I @g@troff
+error messages;
+implies
+.BR \-Ww .
+.
+This option does
+.I not
+suppress messages sent to the standard error stream by documents or
+macro packages using
 .B tm
-or
-.B tm1
-requests.
+or related requests.
+.
 .
 .TP
-.BI \-f fam
+.BI \-f\~ fam
 Use
 .I fam
 as the default font family.
 .
+.
 .TP
-.BI \-F dir
-Search in directory (or directory path)
+.BI \-F\~ dir
+Search in directory
 .I dir
-for subdirectories
-.IR dev name
-.RI ( name
-is the name of the device) and there for the
-.I DESC
-file and font files.
+for the selected output device's directory of device and font
+description files.
+.
+See the description of
+.I GROFF_FONT_PATH
+in section \lqEnvironment\rq below for the default search locations
+and ordering.
 .
-.I dir
-is scanned before all other font directories.
 .
 .TP
 .B \-i
-Read the standard input after all the named input files have been
+Read the standard input stream after all named input files have been
 processed.
 .
+.
 .TP
-.BI \-I dir
-This option may be used to add a directory to the search path for
-files (both those on the command line and those named in
-.B \&.psbb
-requests).
+.BI \-I\~ dir
+Search the directory
+.I dir
+for files
+(those named on the command line;
+in
+.BR psbb ,
+.BR so ,
+and
+.B soquiet
+requests;
+and in
+.RB \lq "\rsX\aqps: import\aq" \rq,
+.RB \lq "\rsX\aqps: file\aq" \rq,
+and
+.RB \lq "\rsX\aqpdf: pdfpic\aq" \rq
+device control escape sequences).
 .
-The search path is initialized with the current directory.
+.B \-I
+may be specified more than once;
+each
+.I dir
+is searched in the given order.
 .
-This option may be specified more than once; the directories are then
-searched in the order specified (but before the current directory).
+To search the current working directory before others,
+add
+.RB \lq "\-I .\&" \rq
+at the desired place;
+it is otherwise searched last.
 .
-If you want to make the current directory be read before other
-directories, add
-.B \-I.\&
-at the appropriate place.
+.B \-I
+works similarly to,
+and is named for,
+the \lqinclude\rq
+option of Unix C compilers.
 .
-.IP
-No directory search is performed for files with an absolute file name.
 .
 .TP
-.BI \-m name
-Read in the file
-.RI name .tmac .
+.BI \-m\~ name
+Process the file
+.RI name .tmac
+prior to any input files.
 .
-If it isn't found, try
+If not found,
 .IR tmac. name
-instead.
+is attempted.
 .
-It will be first searched for in directories given with the
-.B \-M
-command-line option, then in directories given in the
+.I name
+(in both arrangements)
+is presumed to be a macro file;
+see the description of
 .I GROFF_TMAC_PATH
-environment variable, then in the current directory (only if in unsafe
-mode), the home directory,
-.IR @SYSTEMMACRODIR@ ,
-.IR @LOCALMACRODIR@ ,
-and
-.IR @MACRODIR@ .
+in section \lqEnvironment\rq below for the default search locations
+and ordering.
+.
 .
 .TP
-.BI \-M dir
-Search directory (or directory path)
+.BI \-M\~ dir
+Search directory
 .I dir
 for macro files.
 .
-This is scanned before all other macro directories.
+See the description of
+.I GROFF_TMAC_PATH
+in section \lqEnvironment\rq below for the default search locations
+and ordering.
+.
 .
 .TP
-.BI \-n num
-Number the first page
-.IR num .
+.BI \-n\~ num
+Begin numbering pages at
+.I num.
+.
+The default
+.RB is\~ 1 .
+.
 .
 .TP
-.BI \-o list
+.BI \-o\~ list
 Output only pages in
-.IR list ,
-which is a comma-separated list of page ranges;
+.I list,
+which is a comma-separated list of inclusive page ranges;
 .I n
-means print page
-.IR n ,
+means page
+.I n,
 .IB m \- n
-means print every page between
-.I m
-and
-.IR n ,
+means every page
+.RI between\~ m
+.RI and\~ n ,
 .BI \- n
-means print every page up to
-.IR n ,
+means every page up
+.RI to\~ n ,
+and
 .IB n \-
-means print every page from
-.IR n .
+means every page from
+.IR n \~on.
+.
+.I @g@troff
+stops processing and exits after formatting the last page enumerated in
+.I list.
 .
-.B @g@troff
-will exit after printing the last page in the list.
 .
 .TP
-.BI \-r cn
+.BI \-r\~ cnumeric-expression
 .TQ
-.BI \-r name = n
-Set number register
-.I c
+.BI \-r\~ register = numeric-expression
+Define
+.I roff
+.RI register\~ c
 or
-.I name
-to
-.IR n ;
-.I c
-must be a one character name;
-.I n
-can be any troff numeric expression.
+.I register
+as
+.I numeric-expression.
+.
+.IR c \~must
+be a one-character name;
+.I register
+can be of arbitrary length.
+.
+Such register assignments happen before any macro file is loaded,
+including the startup file.
+.
+Due to
+.MR getopt_long 3
+limitations,
+.IR c\~ cannot
+be,
+and
+.I register
+cannot contain,
+an equals sign,
+even though that is a valid character in a
+.I roff
+identifier.
+.
 .
 .TP
 .B \-R
@@ -247,61 +456,55 @@
 and
 .IR troffrc\-end .
 .
+.
 .TP
-.BI \-T name
+.BI \-T\~ dev
 Prepare output for device
-.IR name ,
-rather than the default
+.I dev.
+.
+The default is
 .BR @DEVICE@ ;
 see
-.BR groff (@MAN1EXT@)
-for a more detailed description.
+.MR groff @MAN1EXT@ .
+.
 .
 .TP
 .B \-U
-Unsafe mode.
-.
-This will enable the following requests:
+Operate in
+.I unsafe mode,
+enabling the
 .BR open ,
 .BR opena ,
+.BR pi ,
 .BR pso ,
-.BR sy ,
 and
-.BR pi .
-For security reasons, these potentially dangerous requests are
-disabled otherwise.
-.
-It will also add the current directory to the macro search path.
+.B sy
+requests,
+which are disabled by default because they allow an untrusted input
+document to write to arbitrary file names and run arbitrary commands.
+.
+This option also adds the current directory to the macro package search
+path;
+see the
+.B \-m
+and
+.B \-M
+options above.
 .
-.TP
-.B \-v
-Print the version number.
 .
 .TP
-.BI \-w name
-Enable warning
-.IR  name .
-.
-Available warnings are described in section \(lqWarnings\(rq below.
-.
-To enable most useful warnings use
-.B \-w
-.BR all .
-To enable absolutely all warnings use
-.B \-w w
-instead.
-Multiple
-.B \-w
-options are allowed.
+.BI \-w\~ name
+.TQ
+.BI \-W\~ name
+Enable
+.RB ( \-w )
+or inhibit
+.RB ( \-W )
+warnings in category
+.I name.
 .
-.TP
-.BI \-W name
-Inhibit warning
-.IR name .
+See section \lqWarnings\rq below.
 .
-Multiple
-.B \-W
-options are allowed.
 .
 .TP
 .B \-z
@@ -309,33 +512,43 @@
 .
 .
 .\" ====================================================================
-.SH WARNINGS
+.SH Warnings
 .\" ====================================================================
 .
-The warnings that can be given by
-.B @g@troff
-are divided into the following categories.
+.\" BEGIN Keep parallel with groff.texi node "Warnings".
+.\" Caveat: the Texinfo manual sorts them by number, not name.
+Warning diagnostics emitted by
+.I @g@troff
+are divided into named,
+numbered categories.
 .
-The name associated with each warning is used by the
+The name associated with each warning category is used by the
 .B \-w
 and
 .B \-W
-options; the number is used by the
+options.
+.
+Each category is also assigned a power of two;
+the sum of enabled category codes is used by the
 .B warn
-request, and by the
+request and the
 .B .warn
-register; it is always a power of 2 to allow bitwise composition.
+register.
+.
+Warnings of each category are produced under the following
+circumstances.
+.
 .
 .P
 .TS
 tab(@), center, box;
 c c c | c c c
 r rI lB | r rI lB.
-Bit@Code@Warning@Bit@Code@Warning
+Bit@Code@Category@Bit@Code@Category
 _
 0@1@char@10@1024@reg
 1@2@number@11@2048@tab
-2@4@break@12@4096@right-brace
+2@4@break@12@4096@right\-brace
 3@8@delim@13@8192@missing
 4@16@el@14@16384@input
 5@32@scale@15@32768@escape
@@ -346,249 +559,376 @@
 @@@20@1048576@file
 .TE
 .
+.
 .P
-.nr x \w'\fBright-brace'+1n+\w'00000'u
+.nr x \w'\fBright\-brace'+1n+\w'00000'u
 .ta \nxuR
 .
+.
 .TP \nxu+3n
 .BR break "\t4"
-In fill mode, lines which could not be broken so that their length was
-less than the line length.
+A filled output line could not be broken such that its length was less
+than the output line length
+.BR \rsn.l .
+.
+This category is enabled by default.
 .
-This is enabled by default.
 .
 .TP
 .BR char "\t1"
-Non-existent characters.
+No mounted font defines a glyph for the requested character.
+.
+This category is enabled by default.
 .
-This is enabled by default.
 .
 .TP
 .BR color "\t524288"
-Color-related warnings.
+An undefined color name was selected,
+an attempt was made to define a color using an unrecognized color space,
+an invalid component in a color definition was encountered,
+or an attempt was made to redefine a default color.
+.
 .
 .TP
 .BR delim "\t8"
-Missing or mismatched closing delimiters.
+The closing delimiter in an escape sequence was missing or mismatched.
+.
 .
 .TP
 .BR di "\t256"
-Use of
-.B di
+A
+.BR di ,
+.BR da ,
+.BR box ,
 or
-.B da
-without an argument when there is no current diversion.
+.B boxa
+request was invoked without an argument when there was no current
+diversion.
+.
 .
 .TP
 .BR el "\t16"
-Use of the
+The
 .B el
-request with no matching
+request was encountered with no prior corresponding
 .B ie
 request.
 .
+.
 .TP
 .BR escape "\t32768"
-Unrecognized escape sequences.
+An unsupported escape sequence was encountered.
 .
-When an unrecognized escape sequence is encountered, the escape
-character is ignored.
 .
 .TP
 .BR file "\t1048576"
-Indicates a missing file for the
-.B mso
-request.
+An attempt was made to load a file that does not exist.
+.
+This category is enabled by default.
 .
-Enabled by default.
 .
 .TP
 .BR font "\t131072"
-Non-existent fonts.
+A non-existent font was selected,
+or the selection was ignored because a font selection escape sequence
+was used after the output line continuation escape sequence on an input
+line.
+.
+This category is enabled by default.
 .
-This is enabled by default.
 .
 .TP
 .BR ig "\t262144"
-Invalid escapes in text ignored with the
+An invalid escape sequence occurred in input ignored using the
 .B ig
 request.
 .
-These are conditions that are errors when they do not occur in ignored
-text.
+This warning category diagnoses a condition that is an error when it
+occurs in non-ignored input.
+.
 .
 .TP
 .BR input "\t16384"
-Invalid input characters.
+An invalid character occurred on the input stream.
+.
 .
 .TP
 .BR mac "\t512"
-Use of undefined strings, macros and diversions.
+An undefined string,
+macro,
+or diversion was used.
+.
+When such an object is dereferenced,
+an empty one of that name is automatically created.
 .
-When an undefined string, macro or diversion is used, that string is
-automatically defined as empty.
+So,
+unless it is later deleted,
+at most one warning is given for each.
+.
+.
+.IP
+This warning is also emitted upon an attempt to move an unplanted trap
+macro.
+.
+In such cases,
+the unplanted macro is
+.I not
+dereferenced,
+so it is not created if it does not exist.
 .
-So, in most cases, at most one warning will be given for each name.
 .
 .TP
 .BR missing "\t8192"
-Requests that are missing non-optional arguments.
+A request was invoked with a mandatory argument absent.
+.
 .
 .TP
 .BR number "\t2"
-Invalid numeric expressions.
+An invalid numeric expression was encountered.
+.
+This category is enabled by default.
 .
-This is enabled by default.
 .
 .TP
 .BR range "\t64"
-Out of range arguments.
+A numeric expression was out of range for its context.
+.
 .
 .TP
 .BR reg "\t1024"
-Use of undefined number registers.
+An undefined register was used.
+.
+When an undefined register is dereferenced,
+it is automatically defined with a value of\~0.
 .
-When an undefined number register is used, that register is
-automatically defined to have a value of\~0.
+So,
+unless it is later deleted,
+at most one warning is given for each.
 .
-So, in most cases, at most one warning will be given for use of a
-particular name.
 .
 .TP
-.BR right-brace "\t4096"
-Use of
-.B \(rs}
-where a number was expected.
+.BR right\-brace "\t4096"
+A right brace escape sequence
+.B \rs}
+was encountered where a number was expected.
+.
 .
 .TP
 .BR scale "\t32"
-Meaningless scaling indicators.
+A scaling unit inappropriate to its context was used in a numeric
+expression.
+.
 .
 .TP
 .BR space "\t65536"
-Missing space between a request or macro and its argument.
+A space was missing between a request or macro and its argument.
 .
-This warning will be given when an undefined name longer than two
-characters is encountered, and the first two characters of the name
-make a defined name.
+This warning is produced when an undefined name longer than two
+characters is encountered and the first two characters of the name
+constitute a defined name.
 .
-The request or macro will not be invoked.
+No request is invoked,
+no macro called,
+and an empty macro is not defined.
 .
-When this warning is given, no macro is automatically defined.
+This category is enabled by default.
 .
-This is enabled by default.
+It never occurs in compatibility mode.
 .
-This warning will never occur in compatibility mode.
 .
 .TP
 .BR syntax "\t128"
-Dubious syntax in numeric expressions.
+A self-contradictory hyphenation mode was requested;
+an empty or incomplete numeric expression was encountered;
+an operand to a numeric operator was missing;
+an attempt was made to define a recursive,
+empty,
+or nonsensical character class;
+or a
+.I groff
+extension conditional expression operator was used while in
+compatibility mode.
+.
 .
 .TP
 .BR tab "\t2048"
-Inappropriate use of a tab character.
+A tab character was encountered where a number was expected,
+or appeared in an unquoted macro argument.
 .
-Either use of a tab character where a number was expected, or use of tab
-character in an unquoted macro argument.
 .
 .P
-There are also names that can be used to refer to groups of warnings:
+Two warning names group other warning categories for convenience.
+.
 .
 .TP
 .B all
-All warnings except
+All warning categories except
 .BR di ,
 .BR mac ,
 and
 .BR reg .
 .
-It is intended that this covers all warnings that are useful with
-traditional macro packages.
+This shorthand is intended to produce all warnings that are useful with
+macro packages and documents written for AT&T
+.I troff \" AT&T
+and its descendants,
+which have less fastidious diagnostics than GNU
+.IR troff . \" GNU
+.
 .
 .TP
 .B w
-All warnings.
+All warning categories.
+.
+Authors of documents and macro packages targeting
+.I groff
+are encouraged to use this setting.
+.\" END Keep parallel with groff.texi node "Warnings".
 .
 .
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
+.I GROFF_FONT_PATH
+and
+.I GROFF_TMAC_PATH
+each accept a search path of directories;
+that is,
+a list of directory names separated by the system's path component
+separator character.
+.
+On Unix systems,
+this character is a colon (:);
+on Windows systems,
+it is a semicolon (;).
+.
+.
+.TP
+.I GROFF_FONT_PATH
+A list of directories in which to seek the selected output device's
+directory of device and font description files.
+.
+.I @g@troff
+will scan directories given as arguments to any specified
+.B \-F
+options before these,
+then in a site-specific directory
+.RI ( @LOCALFONTDIR@ ),
+a standard location
+.RI ( @FONTDIR@ ),
+and a compatibility directory
+.RI ( @LEGACYFONTDIR@ )
+after them.
+.
+.
 .TP
 .I GROFF_TMAC_PATH
-A colon separated list of directories in which to search for
-macro files.
+A list of directories in which to search for macro files.
 .
-.B @g@troff
-will scan directories given in the
+.I @g@troff
+will scan directories given as arguments to any specified
 .B \-M
-option before these, and in standard directories (current directory if
-in unsafe mode, home directory,
-.IR @SYSTEMMACRODIR@ ,
-.IR @LOCALMACRODIR@ ,
-.IR @MACRODIR@ )
-after these.
+options before these,
+then the current directory
+(only if in unsafe mode),
+the user's home directory,
+.if !'@COMPATIBILITY_WRAPPERS@'no' \{\
+a platform-specific directory
+.RI ( @SYSTEMMACRODIR@ ),
+.\}
+a site-specific directory
+.RI ( @LOCALMACRODIR@ ),
+and a standard location
+.RI ( @MACRODIR@ )
+after them.
+.
 .
 .TP
 .I GROFF_TYPESETTER
-Default device.
+Set the default output device.
+.
+If empty or not set,
+.B @DEVICE@
+is used.
+.
+The
+.B \-T
+option overrides
+.IR \%GROFF_TYPESETTER .
+.
 .
 .TP
-.I GROFF_FONT_PATH
-A colon separated list of directories in which to search for the
-.IR dev name
-directory.
+.I SOURCE_DATE_EPOCH
+A timestamp
+(expressed as seconds since the Unix epoch)
+to use as the output creation timestamp in place of the current time.
 .
-.B @g@troff
-will scan directories given in the
-.B \-F
-option before these, and in standard directories
-.RI ( @LOCALFONTDIR@ ,
-.IR @FONTDIR@ ,
-.IR @LEGACYFONTDIR@ )
-after these.
+The time is converted to human-readable form using
+.MR localtime 3
+when the formatter starts up and stored in registers usable by documents
+and macro packages.
+.
+.
+.TP
+.I TZ
+The timezone to use when converting the current time
+(or value of
+.IR SOURCE_DATE_EPOCH )
+to human-readable form;
+see
+.MR tzset 3 .
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @MACRODIR@/troffrc
-Initialization file (called before any other macro package).
+.I @MACRODIR@/\:\%troffrc
+is an initialization macro file loaded before any macro packages
+specified with
+.B \-m
+options.
+.
 .
 .TP
-.I @MACRODIR@/troffrc\-end
-Initialization file (called after any other macro package).
+.I @MACRODIR@/\:\%troffrc\-end
+is an initialization macro file loaded after all macro packages
+specified with
+.B \-m
+options.
+.
 .
 .TP
-.IR @MACRODIR@/ name .tmac
-.TQ
-.IR @MACRODIR@/tmac. name
-Macro files
+.IR @MACRODIR@/\: name \:.tmac
+are macro files distributed with
+.IR groff .
+.
 .
 .TP
-.IR @FONTDIR@/dev name /DESC
-Device description file for device
+.IR @FONTDIR@/\:\%dev name /\:DESC
+describes the output device
 .IR name .
 .
+.
 .TP
-.IR @FONTDIR@/dev name / F
-Font file for font
+.IR @FONTDIR@/\:\%dev name / F
+describes the font
 .I F
 of device
-.IR name .
+.I name.
 .
 .
 .P
-Note that
 .I troffrc
 and
 .I troffrc\-end
-are searched for neither in the current nor the home directory by
-default for security reasons (even if the
+are sought neither in the current nor the home directory by default for
+security reasons,
+even if the
 .B \-U
-option is given).
+option is specified.
 .
 Use the
 .B \-M
@@ -599,84 +939,109 @@
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
 The GNU version of
-.I troff
+.I troff \" generic
 was originally written by James Clark;
 he also wrote the original version of this document,
-which was modified by
-.MT wl@\:gnu.org
+which was updated by
+.MT wl@\:gnu\:.org
 Werner Lemberg
-.ME
-and
-.MT groff\-bernd.warken\-72@\:web.de
+.ME ,
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
+.ME ,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \lqinfo groff\rq.
+.
+.
+.TP
+.MR groff @MAN1EXT@
+offers an overview of the GNU
+.I roff
+system
+and describes its front end executable.
+.
+.
 .TP
-.BR groff (@MAN1EXT@)
-The main program of the
+.MR groff @MAN7EXT@
+details the
 .I groff
-system, a wrapper around
-.IR @g@troff .
+language,
+including a short but complete reference of all predefined requests,
+registers,
+and escape sequences.
+.
 .
 .TP
-.BR groff (@MAN7EXT@)
-A description of the
+.MR groff_char @MAN7EXT@
+explains the syntax of
 .I groff
-language, including a short but complete reference of all predefined
-requests, registers, and escapes of plain
+special character escape sequences,
+and lists all special characters predefined by the language.
+.
+.
+.TP
+.MR groff_diff @MAN7EXT@
+enumerates the differences between
+AT&T device-independent
+.I troff \" AT&T
+and
 .IR groff .
 .
-From the command line, this is called by
-.RS
-.IP
-.B man 7 groff
-.RE
 .
 .TP
-.BR \%groff_diff (@MAN7EXT@)
-The differences of the
+.MR groff_font @MAN5EXT@
+covers the format of
 .I groff
-language and the
-.I classical troff
-language.
+device and font description files.
 .
-Currently, this is the most actual document of the
-.I groff
-system.
 .
 .TP
-.BR roff (@MAN7EXT@)
-An overview over
-.I groff
-and other
-.I roff
-systems, including pointers to further related documentation.
+.MR groff_out @MAN5EXT@
+describes the format of
+.IR @g@troff 's
+output.
 .
 .
-.P
-.IR "Groff: The GNU Implementation of troff" ,
-by Trent A.\& Fisher and Werner Lemberg,
-is the primary
-.I groff
-manual.
+.TP
+.MR groff_tmac @MAN5EXT@
+includes information about macro files that ship with
+.IR groff .
 .
-You can browse it interactively with \(lqinfo groff\(rq.
 .
+.TP
+.MR roff @MAN7EXT@
+supplies background on
+.I roff
+systems in general,
+including pointers to further related documentation.
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_troff_1_man_C
+.do rr *groff_troff_1_man_C
 .
-.\" ====================================================================
-.\" Emacs variables
-.\" ====================================================================
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/troff.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/troff.am Changed

@@ -1,16 +1,14 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # 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 the Free
-# Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -52,19 +50,17 @@
 CLEANFILES += src/roff/troff/majorminor.cpp
 
 src/roff/troff/majorminor.cpp: $(top_srcdir)/.version
-	@echo Making $@
-	@$(RM) $@
-	@echo const char \*major_version = \"$(MAJOR_VERSION)\"\; >$@
-	@echo const char \*minor_version = \"$(MINOR_VERSION)\"\; >>$@
-	@echo const char \*revision = \"$(REVISION)\"\; >>$@
+	$(AM_V_at)printf 'const char *major_version = "%s";\n' \
+	  $(MAJOR_VERSION) > $@.tmp
+	$(AM_V_at)printf 'const char *minor_version = "%s";\n' \
+	  $(MINOR_VERSION) >> $@.tmp
+	$(AM_V_at)printf 'const char *revision = "%s";\n' \
+	  $(REVISION) >> $@.tmp
+	$(AM_V_GEN)mv $@.tmp $@
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/roff/troff/troff.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/roff/troff/troff.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/addftinfo/addftinfo.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/addftinfo/addftinfo.1.man Changed

@@ -1,13 +1,16 @@
-.TH ADDFTINFO @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-addftinfo \- add information to troff font files for use with groff
+.TH addftinfo @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+addftinfo \- add font metrics to
+.I troff
+fonts for use with
+.I groff
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,171 +28,209 @@
 .\" instead of in the original English.
 .
 .
-.\" ====================================================================
-.\" Characters
-.\" ====================================================================
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_addftinfo_1_man_C \n.cp
+.cp 0
 .
-.\" Ellipsis ...
-.ie t .ds EL \fS\N'188'\fP\"
-.el .ds EL \&.\|.\|.\&\"
-.\" called with \*(EL
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY addftinfo
-.OP \-asc\-height n
-.OP \-body\-depth n
-.OP \-body\-height n
-.OP \-cap\-height n
-.OP \-comma\-depth n
-.OP \-desc\-depth n
-.OP \-fig\-height n
-.OP \-x\-height n
-.I res
-.I unitwidth
+.RB  \-asc\-height\~\c
+.IR n 
+.RB  \-body\-depth\~\c
+.IR n 
+.RB  \-body\-height\~\c
+.IR n 
+.RB  \-cap\-height\~\c
+.IR n 
+.RB  \-comma\-depth\~\c
+.IR n 
+.RB  \-desc\-depth\~\c
+.IR n 
+.RB  \-fig\-height\~\c
+.IR n 
+.RB  \-x\-height\~\c
+.IR n 
+.I resolution
+.I unit-width
 .I font
 .YS
 .
+.
 .SY addftinfo
 .B \-\-help
 .YS
 .
+.
 .SY addftinfo
 .B \-v
+.
 .SY addftinfo
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B addftinfo
-reads a troff font file and adds some additional font-metric
-information that is used by the groff system.
-.
-The font file with the information added is written on the standard
-output.
+.I addftinfo
+reads an
+.RI AT&T \~troff
+font description file
+.IR font ,
+adds additional font metric information required by
+.\" We need the "GNU" below because the @g@ prefix might be empty.
+.RI GNU \~@g@troff (@MAN1EXT@),
+and writes the combined result to the standard output.
 .
-The information added is guessed using some parametric information
-about the font and assumptions about the traditional troff names for
-characters.
+The information added is derived from the font's existing parameters and
+assumptions about traditional
+.I troff
+names for characters.
 .
-The main information added is the heights and depths of characters.
+Among the font metrics added are the heights and depths of characters
+(how far each extends vertically above and below the baseline).
 .
 The
-.I res
+.I resolution
 and
-.I unitwidth
+.I unit-width
 arguments should be the same as the corresponding parameters in the
-DESC file;
+.I DESC
+file.
+.
 .I font
 is the name of the file describing the font;
 if
 .I font
 ends with
-.B I
-the font will be assumed to be italic.
+.RB \lq I \rq,
+the font is assumed to be oblique
+(or italic).
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
 .B \-v
-prints the version number.
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
-.LP
-All other options change one of the parameters that are used to derive
-the heights and depths.
+.P
+All other options change parameters that are used to derive the heights
+and depths.
 .
-Like the existing quantities in the font file, each
-.I value
+Like the existing quantities in the font description file,
+each
+.RI value\~ n
 is in
-.RI inches/ res
-for a font whose point size is
-.IR unitwidth .
+.I "scaled points,"
+.RI inches/ resolution
+for a font whose type size is
+.IR unit-width ;
+see
+.MR groff_font @MAN5EXT@ .
 .
-.I param-option
-must be one of:
 .
 .TP
-.B \-x\-height
-The height of lowercase letters without ascenders such as x.
+.BI \-asc\-height \~n
+height of characters with ascenders,
+such as \lqb\rq,
+\lqd\rq,
+or \lql\rq
+.
 .
 .TP
-.B \-fig\-height
-The height of figures (digits).
+.BI \-body\-depth \~n
+depth of characters such as parentheses
+.
 .
 .TP
-.B \-asc\-height
-The height of characters with ascenders, such as b, d or l.
+.BI \-body\-height \~n
+height of characters such as parentheses
+.
 .
 .TP
-.B \-body\-height
-The height of characters such as parentheses.
+.BI \-cap\-height \~n
+height of uppercase letters such as \lqA\rq
+.
 .
 .TP
-.B \-cap\-height
-The height of uppercase letters such as A.
+.BI \-comma\-depth \~n
+depth of a comma
+.
 .
 .TP
-.B \-comma\-depth
-The depth of a comma.
+.BI \-desc\-depth \~n
+depth of characters with descenders,
+such as \lqp\rq,
+\lqq\rq,
+or \lqy\rq
+.
 .
 .TP
-.B \-desc\-depth
-The depth of characters with descenders, such as p, q, or y.
+.B \-fig\-height
+height of figures (numerals)
+.
 .
 .TP
-.B \-body\-depth
-The depth of characters such as parentheses.
+.BI \-x\-height \~n
+height of lowercase letters without ascenders such as \lqx\rq
 .
 .
-.LP
-.B addftinfo
-makes no attempt to use the specified parameters to guess the
-unspecified parameters.
+.P
+.I addftinfo
+makes no attempt to use the specified parameters to infer unspecified
+parameters.
 .
-If a parameter is not specified the default will be used.
+If a parameter is not specified,
+the default will be used.
 .
-The defaults are chosen to have the reasonable values for a Times
-font.
+The defaults are chosen to produce reasonable values for a Times font.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff_font (@MAN5EXT@),
-.BR groff (@MAN1EXT@),
-.BR groff_char (@MAN7EXT@)
+.MR groff_font @MAN5EXT@ ,
+.MR groff @MAN1EXT@ ,
+.MR groff_char @MAN7EXT@
 .
 .
-.P
-You can view a man page
-.IB name ( n )
-with
-.RS
-.EX
-.BI "man" " n name"
-.EE
-.RE
-in text mode and with
-.RS
-.EX
-.BI "groffer" " n name"
-.EE
-.RE
-in graphical mode (PDF, etc.).
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_addftinfo_1_man_C
+.do rr *groff_addftinfo_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/addftinfo/addftinfo.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/addftinfo/addftinfo.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/addftinfo/addftinfo.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/addftinfo/addftinfo.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -20,7 +19,6 @@
 #include "lib.h"
 
 #include <ctype.h>
-#include <assert.h>
 #include <stdlib.h>
 #include <errno.h>
 #include "errarg.h"
@@ -33,6 +31,7 @@
 
 static void usage(FILE *stream);
 static void usage();
+static void usage(const char *problem);
 static void version();
 static void convert_font(const font_params &, FILE *, FILE *);
 
@@ -42,14 +41,14 @@
   const char *name;
   param_t par;
 } param_table = {
-  { "x-height", &font_params::x_height },
-  { "fig-height", &font_params::fig_height },
   { "asc-height", &font_params::asc_height },
+  { "body-depth", &font_params::body_depth },
   { "body-height", &font_params::body_height },
   { "cap-height", &font_params::cap_height },
   { "comma-depth", &font_params::comma_depth },
   { "desc-depth", &font_params::desc_depth },
-  { "body-depth", &font_params::body_depth },
+  { "fig-height", &font_params::fig_height },
+  { "x-height", &font_params::x_height },
 };
 
 // These are all in thousandths of an em.
@@ -77,17 +76,20 @@
     }
   }
   if (argc < 4)
-    usage();
+    usage("insufficient arguments");
+  /* The next couple of usage() calls cannot provide a meaningful
+     diagnostic because we don't know whether sscanf() failed on a
+     required parameter or an option.  A refactor could fix this. */
   int resolution;
   if (sscanf(argvargc-3, "%d", &resolution) != 1)
     usage();
   if (resolution <= 0)
-    fatal("resolution must be > 0");
+    fatal("resolution must be positive");
   int unitwidth;
   if (sscanf(argvargc-2, "%d", &unitwidth) != 1)
     usage();
   if (unitwidth <= 0)
-    fatal("unitwidth must be > 0");
+    fatal("unit width must be positive");
   font_params param;
   const char *font = argvargc-1;
   param.italic = (font0 != '\0' && strchr(font, '\0')-1 == 'I');
@@ -106,7 +108,7 @@
       break;
     }
     if (i + 1 >= argc)
-      usage();
+      usage("option requires argument");
     size_t j;
     for (j = 0;; j++) {
       if (j >= sizeof(param_table)/sizeof(param_table0))
@@ -115,11 +117,11 @@
 	break;
     }
     if (sscanf(argvi+1, "%d", &(param.*(param_tablej.par))) != 1)
-      fatal("invalid argument '%1'", argvi+1);
+      fatal("invalid option argument '%1'", argvi+1);
     i++;
-  }    
+  }
   if (argc - i != 3)
-    usage();
+    usage("insufficient arguments");
   errno = 0;
   FILE *infp = fopen(font, "r");
   if (infp == 0)
@@ -130,16 +132,27 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -v -param value ... "
-		  "resolution unitwidth font\n",
-	  program_name);
+  fprintf(stream, "usage: %s", program_name);
+  size_t len = sizeof(param_table)/sizeof(param_table0);
+  for (size_t i = 0; i < len; i++)
+    fprintf(stream, " -%s n", param_tablei.name);
+  fputs(" resolution unit-width font\n", stream);
+  fprintf(stream, "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n", program_name, program_name);
 }
+
 static void usage()
 {
   usage(stderr);
   exit(1);
 }
 
+static void usage(const char *problem)
+{
+  error("%1", problem);
+  usage();
+}
+
 static void version()
 {
   printf("GNU addftinfo (groff) version %s\n", Version_string);
@@ -157,8 +170,9 @@
   }
   return p->length() > 0;
 }
-  
-static void convert_font(const font_params &param, FILE *infp, FILE *outfp)
+
+static void convert_font(const font_params &param, FILE *infp,
+			 FILE *outfp)
 {
   string s;
   while (get_line(infp, &s)) {
@@ -200,18 +214,24 @@
 		printf(",%d,%d", metric.height, metric.depth);
 	    }
 	    else
-	      printf(",%d,%d,%d", metric.height, metric.depth, metric.ic);
+	      printf(",%d,%d,%d", metric.height, metric.depth,
+		     metric.ic);
 	  }
 	  else
-	    printf(",%d,%d,%d,%d", metric.height, metric.depth, metric.ic,
-		   metric.left_ic);
+	    printf(",%d,%d,%d,%d", metric.height, metric.depth,
+		   metric.ic, metric.left_ic);
 	}
 	else
-	  printf(",%d,%d,%d,%d,%d", metric.height, metric.depth, metric.ic,
-		 metric.left_ic, metric.sk);
+	  printf(",%d,%d,%d,%d,%d", metric.height, metric.depth,
+		 metric.ic, metric.left_ic, metric.sk);
       }
     }
     fputs(p, outfp);
   }
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/addftinfo/guess.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/addftinfo/guess.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/addftinfo/guess.h -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/addftinfo/guess.h Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/afmtodit/afmtodit.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/afmtodit/afmtodit.1.man Changed

@@ -1,13 +1,15 @@
-.TH AFMTODIT @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-afmtodit \- create font files for use with groff \-Tps and \-Tpdf
+.TH afmtodit @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+afmtodit \- adapt Adobe Font Metrics files for
+.I groff
+PostScript and PDF output
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,227 +27,318 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_afmtodit_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY afmtodit
-.OP \-ckmnsx
-.OP \-a n
-.OP \-d desc-file
-.OP \-e enc-file
-.OP \-f internal-name
-.OP \-i n
-.OP \-o output-file
+.RB  \-ckmnsx 
+.RB  \-a\~\c
+.IR slant 
+.RB  \-d\~\c
+.IR device-description-file 
+.RB  \-e\~\c
+.IR encoding-file 
+.RB  \-f\~\c
+.IR internal-name 
+.RB  \-i\~\c
+.IR italic-correction-factor 
+.RB  \-o\~\c
+.IR output-file 
+.RB  \-w\~\c
+.IR space-width 
 .I afm-file
 .I map-file
-.I font
+.I font-description-file
+.YS
+.
+.
+.SY afmtodit
+.B \-\-help
 .YS
 .
+.
 .SY afmtodit
 .B \-v
+.
+.SY afmtodit
+.B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.I afmtodit
-creates a font file for use with
-.IR groff ,
-.IR grops ,
+.I \%afmtodit
+adapts an
+Adobe Font Metric
+file,
+.IR afm-file ,
+for use with the
+.B ps
 and
-.IR gropdf .
-.
-.I afmtodit
-is written in Perl;
-you must have Perl version 5.004 or newer installed in order to run
-.IR afmtodit .
+.B pdf
+output devices of
+.MR @g@troff @MAN1EXT@ .
 .
+.I map-file
+associates a
+.I groff
+ordinary or special character name with a PostScript glyph name.
 .
-.LP
-.I afm-file
-is the AFM (Adobe Font Metric) file for the font.
+Output is written in
+.MR groff_font @MAN5EXT@
+format to
+.I font-description-file,
+a file named for the intended
+.I groff
+font name
+(but see the
+.B \-o
+option).
 .
 .
 .LP
 .I map-file
-is a file that says which
-.I groff
-character names map onto each PostScript character name;
-this file should contain a sequence of lines of the form
+should contain a sequence of lines of the form
 .
 .RS
-.I
-ps-char groff-char
+.EX
+.I ps-glyph groff-char
+.EE
 .RE
 .
 where
-.I ps-char
-is the PostScript name of the character and
+.I ps-glyph
+is the PostScript glyph name and
 .I groff-char
-is the groff name of the character (as used in the
+is a
 .I groff
-font file).
+ordinary
+(if of unit length)
+or special
+(if longer)
+character identifier.
 .
 The same
-.I ps-char
+.I ps-glyph
 can occur multiple times in the file;
 each
 .I groff-char
 must occur at most once.
 .
-Lines starting with \(oq#\(cq and blank lines are ignored.
+Lines starting with \lq#\rq and blank lines are ignored.
 .
 If the file isn't found in the current directory,
-it is searched for in the
+it is sought in the
 .I devps/generate
 subdirectory of the default font directory.
 .
 .
 .LP
-If a PostScript character is not mentioned in
+If a PostScript glyph is not mentioned in
 .IR map-file ,
-and a generic
+and a
 .I groff
-glyph name can't be deduced using the Adobe Glyph List
-(AGL, built into
+character name can't be deduced using the Adobe Glyph List
+(AGL,
+built into
 .IR afmtodit ),
 then
-.I afmtodit
-puts the PostScript character into the
+.I \%afmtodit
+puts the PostScript glyph into the
 .I groff
-font file as an unnamed character which can only be accessed by the
-\(oq\eN\(cq escape sequence in a
+font description file as an unnamed glyph which can only be accessed
+by the \lq\eN\rq escape sequence in a
 .I roff
 document.
 .
 In particular,
-this is true for glyph variants named in the form \(lqfoo.bar\(rq;
+this is true for glyph variants named in the form
+.RI \lq foo . bar \rq;
 all glyph names containing one or more periods are mapped to unnamed
 entities.
 .
-If option
+Unless
 .B \-e
-is not specified, the encoding defined in the AFM file (i.e., entries
-with non-negative character codes) is used.
-.
-Refer to section \(lqUsing Symbols\(rq in
+is specified,
+the encoding defined in the AFM file
+(i.e.,
+entries
+with non-negative codes)
+is used.
+.
+Refer to section \lqUsing Symbols\rq in
 .IR "Groff: The GNU Implementation of troff" ,
 the
 .I groff
 Texinfo manual,
-which describes how
+or
+.MR groff_char @MAN7EXT@ ,
+which describe how
 .I groff
-glyph names are constructed.
+character identifiers are constructed.
 .
 .
 .LP
-Characters not encoded in the AFM file (i.e., entries which have
-\(oq\-1\(cq as the character code) are still available in
+Glyphs not encoded in the AFM file
+(i.e.,
+entries indexed as \lq\-1\rq)
+are still available in
 .IR groff ;
-they get glyph index values greater than 255 (or greater than the
-biggest character code used in the AFM file in the unlikely case that it
-is greater than 255) in the
+they get glyph index values greater than 255
+(or greater than the biggest code used in the AFM file in the unlikely
+case that it is greater than 255)
+in the
 .I groff
-font file.
+font description file.
 .
-Glyph indices of unencoded characters don't have a specific order;
-it is best to access them with glyph names only.
+Unencoded glyph indices don't have a specific order;
+it is best to access them only via special character identifiers.
 .
 .
-.LP
-The
-.I groff
-font file will be output to a file called
-.IR font ,
-unless the
-.B \-o
-option is used.
-.
-.
-.LP
-If there is a downloadable font file for the font, it may be listed in
-the file
-.IR @FONTDIR@/\:devps/\:download ;
-see
-.IR grops (@MAN1EXT@).
+.P
+If the font file proper
+(not just its metrics)
+is available,
+listing it in the files
+.I @FONTDIR@/\:\%devps/\:\%download
+and
+.I @FONTDIR@/\:\%devpdf/\:\%download
+enables it to be embedded in the output produced by
+.MR grops @MAN1EXT@
+and
+.MR gropdf @MAN1EXT@ ,
+respectively.
 .
 .
-.LP
+.P
 If the
 .B \-i
 option is used,
-.I afmtodit
-will automatically generate an italic correction,
-a left italic correction and a subscript correction
-for each character
-(the significance of these parameters is explained in
-.IR groff_font (@MAN5EXT@));
-these parameters may be specified for individual characters by
+.I \%afmtodit
+automatically generates an italic correction,
+a left italic correction,
+and a subscript correction for each glyph
+(the significance of these is explained in
+.MR groff_font @MAN5EXT@ );
+they can be specified for individual glyphs by
 adding to the
 .I afm-file
 lines of the form:
 .
 .RS
 .EX
-.BI italicCorrection \~ps-char\~n
-.BI leftItalicCorrection \~ps-char\~n
-.BI subscriptCorrection \~ps-char\~n
+.RI italicCorrection \~ps-glyph\~n
+.RI leftItalicCorrection \~ps-glyph\~n
+.RI subscriptCorrection \~ps-glyph\~n
 .EE
 .RE
 .
 where
-.I ps-char
-is the PostScript name of the character,
+.I ps-glyph
+is the PostScript glyph name,
 and
 .I n
 is the desired value of the corresponding parameter in thousandths of an
 em.
 .
-These parameters are normally needed only for italic (or oblique) fonts.
+Such parameters are normally needed only for italic
+(or oblique)
+fonts.
 .
 .
+.P
+The
+.B \-s
+option should be given if the font is \lqspecial\rq,
+meaning that
+.I groff
+should search it whenever a glyph is not found in the current font.
+.
+In that case,
+.I font-description-file
+should be listed as an argument to the
+.B fonts
+directive in the output device's
+.I DESC
+file;
+if it is not special,
+there is no need to do so,
+since
+.MR @g@troff @MAN1EXT@
+will automatically mount it when it is first used.
+.
+.
+.br
+.ne 7v
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \%\-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
-.BI \-a n
+.BI \-a\~ slant
 Use
-.I n
-as the slant parameter in the font file;
+.I slant
+as the slant (\lqangle\rq) parameter in the font description file;
 this is used by
 .I groff
 in the positioning of accents.
 .
 By default
-.I afmtodit
+.I \%afmtodit
 uses the negative of the
-.B ItalicAngle
+.B \%ItalicAngle
 specified in the AFM file;
 with true italic fonts it is sometimes desirable to use a slant that is
 less than this.
 .
-If you find that characters from an italic font have accents placed too
-far to the right over them,
-then use the
+If you find that an italic font places accents over base glyphs
+too far to the right,
+use
 .B \-a
-option to give the font a smaller slant.
+to give it a smaller slant.
 .
 .
 .TP
 .B \-c
-Include comments in the font file in order to identify the PostScript
+Include comments in the font description file identifying the PostScript
 font.
 .
 .
 .TP
-.BI \-d desc-file
+.BI \-d\~ device-description-file
 The device description file is
 .I desc-file
 rather than the default
@@ -254,13 +347,14 @@
 If not found in the current directory,
 the
 .I devps
-subdirectory of the default font directory is searched (this is true for
-both the default device description file and a file given with option
+subdirectory of the default font directory is searched
+(this is true for both the default device description file and a file
+given with option
 .BR \-d ).
 .
 .
 .TP
-.BI \-e enc-file
+.BI \-e\~ encoding-file
 The PostScript font should be reencoded to use the encoding described
 in
 .IR enc-file .
@@ -268,7 +362,7 @@
 The format of
 .I enc-file
 is described in
-.IR grops (@MAN1EXT@).
+.MR grops @MAN1EXT@ .
 .
 If not found in the current directory,
 the
@@ -277,7 +371,7 @@
 .
 .
 .TP
-.BI \-f name
+.BI \-f\~ internal-name
 The internal name of the
 .I groff
 font is set to
@@ -285,16 +379,16 @@
 .
 .
 .TP
-.BI \-i n
-Generate an italic correction for each character so that the
-character's width plus the character's italic correction is equal to
-.I n
+.BI \-i\~ italic-correction-factor
+Generate an italic correction for each glyph so that its width plus its
+italic correction is equal to
+.I italic-correction-factor
 thousandths of an em
-plus the amount by which the right edge of the character's bounding box
-is to the right of the character's origin.
+plus the amount by which the right edge of the glyph's bounding box is
+to the right of its origin.
 .
-If this would result in a negative italic correction, use a zero
-italic correction instead.
+If this would result in a negative italic correction,
+use a zero italic correction instead.
 .
 .
 .IP
@@ -303,17 +397,16 @@
 four fifths of the x-height of the font.
 .
 If this would result in a subscript correction greater than the italic
-correction, use a subscript correction equal to the italic correction
-instead.
+correction,
+use a subscript correction equal to the italic correction instead.
 .
 .
 .IP
-Also generate a left italic correction for each character
-equal to
-.I n
+Also generate a left italic correction for each glyph equal to
+.I italic-correction-factor
 thousandths of an em
-plus the amount by which the left edge of the character's bounding box
-is to the left of the character's origin.
+plus the amount by which the left edge of the glyph's bounding box is to
+the left of its origin.
 .
 The left italic correction may be negative unless option
 .B \-m
@@ -321,9 +414,11 @@
 .
 .
 .IP
-This option is normally needed only with italic (or oblique) fonts.
+This option is normally needed only with italic
+(or oblique)
+fonts.
 .
-The font files distributed with
+The font description files distributed with
 .I groff
 were created using an option of
 .B \-i50
@@ -331,11 +426,11 @@
 .
 .
 .TP
-.BI \-o output-file
-The output file is
+.BI \-o\~ output-file
+Write to
 .I output-file
 instead of
-.IR font .
+.I font-description-file.
 .
 .
 .TP
@@ -350,12 +445,12 @@
 .B \-m
 Prevent negative left italic correction values.
 .
-Roman font files distributed with
+Font description files for roman styles distributed with
 .I groff
 were created with
-.B \-i0\ \-m
+.RB \lq \-i0\~\-m \rq
 to improve spacing with
-.IR @g@eqn (@MAN1EXT@).
+.MR @g@eqn @MAN1EXT@ .
 .
 .
 .TP
@@ -368,16 +463,16 @@
 .
 .TP
 .B \-s
-The font is special.
-.
-The effect of this option is to add the
+Add the
 .B special
-command to the font file.
+directive to the font description file.
 .
 .
 .TP
-.B \-v
-Print version and exit.
+.BI \-w\~ space-width
+Use
+.I space-width
+as the with of inter-word spaces.
 .
 .
 .TP
@@ -386,37 +481,127 @@
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/\:devps/\:DESC
-Device description file.
+.I @FONTDIR@/\:\%devps/\:DESC
+describes the
+.B ps
+output device.
 .
 .
 .TP
-.IR @FONTDIR@/\:devps/\: F
-Font description file for font
-.IR F .
+.IR @FONTDIR@/\:\%devps/ F
+describes the font known
+.RI as\~ F
+on device
+.BR ps .
 .
 .
 .TP
-.I @FONTDIR@/\:devps/\:download
-List of downloadable fonts.
+.I @FONTDIR@/\:\%devps/\:\%download
+lists fonts available for embedding within the PostScript document
+(or download to the device).
 .
 .
 .TP
-.I @FONTDIR@/\:devps/\:text.enc
-Encoding used for text fonts.
+.I @FONTDIR@/\:\%devps/\:\%generate/\:\%dingbats.map
+.TQ
+.I @FONTDIR@/\:\%devps/\:\%generate/\:\%dingbats\-reversed.map
+.TQ
+.I @FONTDIR@/\:\%devps/\:\%generate/\:\%slanted\-symbol.map
+.TQ
+.I @FONTDIR@/\:\%devps/\:\%generate/\:\%symbol.map
+.TQ
+.I @FONTDIR@/\:\%devps/\:\%generate/\:\%text.map
+map names in the Adobe Glyph List to
+.I groff
+special character identifiers for Zapf Dingbats
+.RB ( ZD ),
+reversed Zapf Dingbats
+.RB ( ZDR ),
+slanted symbol
+.RB ( SS ),
+symbol
+.RB ( S ),
+and text fonts,
+respectively.
+.
+These
+.IR map-file s
+are used to produce the font description files provided with
+.I groff
+for the
+.I \%grops
+output driver.
 .
 .
+.\" ====================================================================
+.SH Diagnostics
+.\" ====================================================================
+.
 .TP
-.I @FONTDIR@/\:devps/\:generate/\:textmap
-Standard mapping.
+.RI "AGL name \aq" x "\aq already mapped to groff name \aq" y\c
+.RI "\aq; ignoring AGL name \aquni" XXXX \aq
+You can disregard these if they're in the form shown,
+where the ignored AGL name contains four hexadecimal digits
+.IR XXXX .
+.
+The Adobe Glyph List (AGL) has its own names for glyphs;
+they are often
+different from
+.IR groff 's
+special character names.
+.
+.I \%afmtodit
+is constructing a mapping from
+.I groff
+special character names to AGL names;
+this can be a one-to-one or many-to-one mapping,
+but one-to-many will not work,
+so
+.I \%afmtodit
+discards the excess mappings.
+.
+For example,
+if
+.I x
+is
+.BR *D ,
+.I y
+is
+.BR \%Delta ,
+and
+.I z
+is
+.BR uni0394 ,
+.I \%afmtodit
+is telling you that the
+.I groff
+font description that it is writing cannot map the
+.I groff
+special character
+.B \rs*D
+to AGL glyphs
+.B \%Delta
+and
+.B uni0394
+at the same time.
+.
+.
+.IP
+If you get a message like this but are unhappy with which mapping is
+ignored,
+a remedy is to craft an alternative
+.I map-file
+and re-run
+.I \%afmtodit
+using it.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -425,24 +610,26 @@
 .I groff
 manual.
 .
-Section \(lqUsing Symbols\(rq may be of particular note.
+Section \lqUsing Symbols\rq may be of particular note.
 .
-You can browse it interactively with \(lqinfo \(aq(groff)Using
-Symbols\(aq\(rq.
+You can browse it interactively with \lqinfo \aq(groff)Using
+\%Symbols\aq\rq.
 .
 .
 .LP
-.IR groff (@MAN1EXT@),
-.IR gropdf (@MAN1EXT@),
-.IR grops (@MAN1EXT@),
-.IR groff_font (@MAN5EXT@),
-.IR perl (1)
+.MR groff @MAN1EXT@ ,
+.MR gropdf @MAN1EXT@ ,
+.MR grops @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_afmtodit_1_man_C
+.do rr *groff_afmtodit_1_man_C
 .
 .
-.\" ====================================================================
-.\" ### Emacs settings:
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/afmtodit/afmtodit.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/afmtodit/afmtodit.am Changed

@@ -1,10 +1,6 @@
 # Automake rules for 'src utils afmtodit'
 #
-# File position: <groff-source>/src/utils/afmtodit/afmtdodit.am
-#
-# Copyright (C) 2013-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2013-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -35,7 +31,7 @@
 
 afmtodit: $(afmtodit_srcdir)/afmtodit.pl $(afmtodit_srcdir)/afmtodit.tables
 	$(AM_V_GEN)if test -n "$(PERL)"; then \
-	  sed -e "s|/usr/bin/perl|$(PERL)|" \
+	  sed -e "s|@PERL@|$(PERL)|" \
 	      -e "s|@VERSION@|$(VERSION)|" \
 	      -e "s|@FONTDIR@|$(fontdir)|" \
 	      -e "/@afmtodit.tables@/ r $(afmtodit_srcdir)/afmtodit.tables" \
@@ -53,12 +49,8 @@
 	&& chmod +x afmtodit
 
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/afmtodit/afmtodit.pl -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/afmtodit/afmtodit.pl Changed

@@ -1,6 +1,5 @@
-#! /usr/bin/perl -w
-# -*- Perl -*-
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
+#!@PERL@
+# Copyright (C) 1989-2020 Free Software Foundation, Inc.
 #      Written by James Clark (jjc@jclark.com)
 #
 # This file is part of groff.
@@ -10,43 +9,79 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
 
+use warnings;
 use strict;
 
 @afmtodit.tables@
 
 my $prog = $0;
-$prog =~ s@.*/@@;
-
 my $groff_sys_fontdir = "@FONTDIR@";
-
-use Getopt::Std;
-getopts('a:cd:e:f:i:kmno:svx');
+my $want_help;
+my $space_width = 0;
 
 our ($opt_a, $opt_c, $opt_d, $opt_e, $opt_f, $opt_i, $opt_k,
      $opt_m, $opt_n, $opt_o, $opt_s, $opt_v, $opt_x);
 
+use Getopt::Long qw(:config gnu_getopt);
+GetOptions( "a=s", "c", "d=s", "e=s", "f=s", "i=s", "k", "m", "n",
+  "o=s", "s", "v", "w=i" => \$space_width, "x", "version" => \$opt_v,
+  "help" => \$want_help
+);
+
+my $afmtodit_version = "GNU afmtodit (groff) version @VERSION@";
+
 if ($opt_v) {
-    print "GNU afmtodit (groff) version @VERSION@\n";
+    print "$afmtodit_version\n";
     exit 0;
 }
 
+sub croak {
+  my $msg = shift;
+  print STDERR "$prog: error: $msg";
+  exit(1);
+}
+
+sub usage {
+    my $stream = *STDOUT;
+    my $had_error = shift;
+    $stream = *STDERR if $had_error;
+    print $stream "usage: $prog -ckmnsx -a slant" .
+	" -d device-description-file -e encoding-file" .
+	" -f internal-name -i italic-correction-factor" .
+	" -o output-file -w space-width afm-file map-file" .
+	" font-description-file\n" .
+	"usage: $prog {-v | --version}\n" .
+	"usage: $prog --help\n";
+    unless ($had_error) {
+	print $stream "\n" .
+"Adapt an Adobe Font Metric file, afm-file, for use with the 'ps'\n" .
+"and 'pdf' output devices of groff(1).  See the afmtodit(1) manual " .
+"page.\n";
+    }
+    my $status = 0;
+    $status = 2 if ($had_error);
+    exit($status);
+}
+
+&usage(0) if ($want_help);
+
 if ($#ARGV != 2) {
-    die "usage: $prog -ckmnsvx -a angle -d DESC -e encoding\n" .
-	"       -f name -i n -o outfile afmfile mapfile font\n";
+    print STDERR "$prog: usage error: insufficient arguments\n";
+    &usage(1);
 }
 
 my $afm = $ARGV0;
 my $map = $ARGV1;
-my $font = $ARGV2;
-my $outfile = $opt_o || $font;
+my $fontfile = $ARGV2;
+my $outfile = $opt_o || $fontfile;
 my $desc = $opt_d || "DESC";
 my $sys_map = $groff_sys_fontdir . "/devps/generate/" . $map;
 my $sys_desc = $groff_sys_fontdir . "/devps/" . $desc;
@@ -65,7 +100,7 @@
 my (%width, %height, %depth);
 my (%left_side_bearing, %right_side_bearing);
 
-open(AFM, $afm) || die "$prog: can't open '$ARGV0': $!\n";
+open(AFM, $afm) || croak("unable to open '$ARGV0': $!\n");
 
 while (<AFM>) {
     chomp;
@@ -164,8 +199,8 @@
 		$depth{$n} = -$lly;
 		$left_side_bearing{$n} = -$llx;
 		$right_side_bearing{$n} = $urx - $w;
-#		while ((my $lig, my $glyph2) = each %ligs) {
-#		    $ligatures{$lig} = $n . " " . $glyph2;
+#		foreach my $lig (sort keys %ligs) {
+#		    $ligatures{$lig} = $n . " " . $ligs{$lig};
 #		}
 	    }
 	}
@@ -179,7 +214,7 @@
 $sizescale = 1;
 
 open(DESC, $desc) || open(DESC, $sys_desc) ||
-    die "$prog: can't open '$desc' or '$sys_desc': $!\n";
+    croak("unable to open '$desc' or '$sys_desc': $!\n");
 while (<DESC>) {
     next if /^#/;
     chop;
@@ -203,7 +238,7 @@
 
     my $sys_opt_e = $groff_sys_fontdir . "/devps/" . $opt_e;
     open(ENCODING, $opt_e) || open(ENCODING, $sys_opt_e) ||
-	die "$prog: can't open '$opt_e' or '$sys_opt_e': $!\n";
+	croak("unable to open '$opt_e' or '$sys_opt_e': $!\n");
     while (<ENCODING>) {
 	next if /^#/;
 	chop;
@@ -224,7 +259,7 @@
 my (%nmap, %map);
 
 open(MAP, $map) || open(MAP, $sys_map) ||
-    die "$prog: can't open '$map' or '$sys_map': $!\n";
+    croak("unable to open '$map' or '$sys_map': $!\n");
 while (<MAP>) {
     next if /^#/;
     chop;
@@ -234,11 +269,11 @@
 	if ($field1 eq "space") {
 	    # The PostScript character "space" is automatically mapped
 	    # to the groff character "space"; this is for grops.
-	    warn "you are not allowed to map to " .
+	    warn "$prog: you are not allowed to map to " .
 		 "the groff character 'space'";
 	}
 	elsif ($field0 eq "space") {
-	    warn "you are not allowed to map " .
+	    warn "$prog: you are not allowed to map " .
 		 "the PostScript character 'space'";
 	}
 	else {
@@ -267,7 +302,7 @@
 if (!$opt_x) {
     my %mapped;
     my $i = ($#encoding > 256) ? ($#encoding + 1) : 256;
-    while (my $ch = each %width) {
+    foreach my $ch (sort keys %width) {
 	# add unencoded characters
 	if (!$in_encoding{$ch}) {
 	    $encoding$i = $ch;
@@ -276,8 +311,10 @@
 	if ($nmap{$ch}) {
 	    for (my $j = 0; $j < $nmap{$ch}; $j++) {
 		if (defined $mapped{$map{$ch, $j}}) {
-		    warn "both $mapped{$map{$ch, $j}} and $ch " .
-			 "map to $map{$ch, $j}";
+		    print STDERR "$prog: AGL name"
+			 . " '$mapped{$map{$ch, $j}}' already mapped to"
+			 . " groff name '$map{$ch, $j}'; ignoring AGL"
+			 . " name '$ch'\n";
 		}
 		else {
 		    $mapped{$map{$ch, $j}} = $ch;
@@ -384,7 +421,7 @@
 	    $u =~ s/^_/u/;
 	    if ($u) {
 		if (defined $mapped{$u}) {
-		    warn "both $mapped{$u} and $ch map to $u";
+		    warn "$prog: both $mapped{$u} and $ch map to $u";
 		}
 		else {
 		    $mapped{$u} = $ch;
@@ -407,19 +444,19 @@
   "ffl", "ff l",
 );
 
-while (my ($lig, $components) = each %default_ligatures) {
+foreach my $lig (sort keys %default_ligatures) {
     if (defined $width{$lig} && !defined $ligatures{$lig}) {
-	$ligatures{$lig} = $components;
+	$ligatures{$lig} = $default_ligatures{$lig};
     }
 }
 
 # print it all out
 
-open(FONT, ">$outfile") || die "$prog: can't open '$outfile' for output: $!\n";
+open(FONT, ">$outfile") ||
+  croak("unable to open '$outfile' for writing: $!\n");
 select(FONT);
 
-print("# This file has been generated with " .
-      "GNU afmtodit (groff) version @VERSION@\n");
+print("# This file was generated with $afmtodit_version.\n");
 print("#\n");
 print("#   $fullname\n") if defined $fullname;
 print("#   $version\n") if defined $version;
@@ -442,11 +479,18 @@
 
 print("\n");
 
-print("name $font\n");
+my $name = $fontfile;
+$name =~ s@.*/@@;
+
+my $sw = 0;
+$sw = conv($width{"space"}) if defined $width{"space"};
+$sw = $space_width if ($space_width);
+
+print("name $name\n");
 print("internalname $psname\n") if $psname;
 print("special\n") if $opt_s;
 printf("slant %g\n", $italic_angle) if $italic_angle != 0;
-printf("spacewidth %d\n", conv($width{"space"})) if defined $width{"space"};
+printf("spacewidth %d\n", $sw) if $sw;
 
 if ($opt_e) {
     my $e = $opt_e;
@@ -456,7 +500,7 @@
 
 if (!$opt_n && %ligatures) {
     print("ligatures");
-    while (my $lig = each %ligatures) {
+    foreach my $lig (sort keys %ligatures) {
 	print(" $lig");
     }
     print(" 0\n");
@@ -590,7 +634,12 @@
 }
 
 sub conv {
-    $_0*$unitwidth*$resolution/(72*1000*$sizescale) + ($_0 < 0 ? -.5 : .5);
+    $_0*$unitwidth*$resolution/(72*1000*$sizescale) +
+      ($_0 < 0 ? -.5 : .5);
 }
 
-# eof
+# Local Variables:
+# fill-column: 72
+# mode: CPerl
+# End:
+# vim: set cindent noexpandtab shiftwidth=2 softtabstop=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/afmtodit/afmtodit.tables -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/afmtodit/afmtodit.tables Changed

@@ -1,6 +1,6 @@
-# This table has been algorithmically derived from the file
-# UnicodeData.txt, version 4.1.0, available from unicode.org,
-# on 2005-12-09.
+# This table was algorithmically derived from the file 'UnicodeData.txt'
+# for Unicode 15.0.0, available from unicode.org,
+# on 2022-10-09.
 my %unicode_decomposed = (
   "00C0", "0041_0300",
   "00C1", "0041_0301",
@@ -406,6 +406,17 @@
   "0FAC", "0FAB_0FB7",
   "0FB9", "0F90_0FB5",
   "1026", "1025_102E",
+  "1B06", "1B05_1B35",
+  "1B08", "1B07_1B35",
+  "1B0A", "1B09_1B35",
+  "1B0C", "1B0B_1B35",
+  "1B0E", "1B0D_1B35",
+  "1B12", "1B11_1B35",
+  "1B3B", "1B3A_1B35",
+  "1B3D", "1B3C_1B35",
+  "1B40", "1B3E_1B35",
+  "1B41", "1B3F_1B35",
+  "1B43", "1B42_1B35",
   "1E00", "0041_0325",
   "1E01", "0061_0325",
   "1E02", "0042_0307",
@@ -1280,6 +1291,8 @@
   "FA2B", "98FC",
   "FA2C", "9928",
   "FA2D", "9DB4",
+  "FA2E", "90DE",
+  "FA2F", "96B7",
   "FA30", "4FAE",
   "FA31", "50E7",
   "FA32", "514D",
@@ -1339,6 +1352,9 @@
   "FA68", "96E3",
   "FA69", "97FF",
   "FA6A", "983B",
+  "FA6B", "6075",
+  "FA6C", "242EE",
+  "FA6D", "8218",
   "FA70", "4E26",
   "FA71", "51B5",
   "FA72", "5168",
@@ -1479,6 +1495,19 @@
   "FB4C", "05D1_05BF",
   "FB4D", "05DB_05BF",
   "FB4E", "05E4_05BF",
+  "1109A", "11099_110BA",
+  "1109C", "1109B_110BA",
+  "110AB", "110A5_110BA",
+  "1112E", "11131_11127",
+  "1112F", "11132_11127",
+  "1134B", "11347_1133E",
+  "1134C", "11347_11357",
+  "114BB", "114B9_114BA",
+  "114BC", "114B9_114B0",
+  "114BE", "114B9_114BD",
+  "115BA", "115B8_115AF",
+  "115BB", "115B9_115AF",
+  "11938", "11935_11930",
   "1D15E", "1D157_1D165",
   "1D15F", "1D158_1D165",
   "1D160", "1D158_1D165_1D16E",
@@ -2036,10 +2065,11 @@
   "2FA1D", "2A600",
 );
 
-# This table has been algorithmically derived from the file glyphlist.txt,
-# version 2.0, available from partners.adobe.com, on 2005-12-09.  For glyphs
-# 'Delta', 'Omega', and 'mu', the values have been manually changed to the
-# ones from aglfn.txt, version 1.6.
+# This table was algorithmically derived from the Adobe Glyph List (AGL)
+# file 'glyphlist.txt' from the GitHub Adobe Type Tools agl-aglfn
+# project, on 2022-10-09.
+#
+# See "groff:" comments for altered mappings.
 my %AGL_to_unicode = (
   "A", "0041",
   "AE", "00C6",
@@ -2130,7 +2160,7 @@
   "Ddotbelow", "1E0C",
   "Decyrillic", "0414",
   "Deicoptic", "03EE",
-  "Delta", "0394",
+  "Delta", "0394", # groff: not U+2206
   "Deltagreek", "0394",
   "Dhook", "018A",
   "Digammagreek", "03DC",
@@ -2419,7 +2449,7 @@
   "Omacron", "014C",
   "Omacronacute", "1E52",
   "Omacrongrave", "1E50",
-  "Omega", "03A9",
+  "Omega", "03A9", # groff: not U+2126
   "Omegacyrillic", "0460",
   "Omegagreek", "03A9",
   "Omegaroundcyrillic", "047A",
@@ -4544,7 +4574,7 @@
   "mpasquare", "33AB",
   "mssquare", "33B3",
   "mturned", "026F",
-  "mu", "03BC",
+  "mu", "03BC", # groff: not U+00B5
   "mu1", "00B5",
   "muasquare", "3382",
   "muchgreater", "226B",

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/afmtodit/make-afmtodit-tables -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/afmtodit/make-afmtodit-tables Changed

@@ -3,7 +3,7 @@
 # make-afmtodit-tables -- script for creating the 'unicode_decomposed'
 #                         and 'AGL_to_unicode' tables
 #
-# Copyright (C) 2005-2018 Free Software Foundation, Inc.
+# Copyright (C) 2005-2020 Free Software Foundation, Inc.
 #      Written by Werner Lemberg <wl@gnu.org>
 #
 # This file is part of groff.
@@ -13,8 +13,8 @@
 # Software Foundation, either version 3 of the License, or
 # (at your option) any later version.
 #
-# groff is distributed in the hope that it will be useful, but WITHOUT ANY
-# WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# 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.
 #
@@ -27,36 +27,34 @@
 #   make-afmtodit-tables \
 #     UnicodeData.txt version-string glyphlist.txt > afmtodit.in
 #
-# 'UnicodeData.txt' is the central database file from the Unicode standard.
-# Unfortunately, it doesn't contain a version number which must be thus
-# provided manually as an additional parameter.
+# 'UnicodeData.txt' is the central database file from the Unicode
+# standard.  Unfortunately, it doesn't contain a version number, which
+# must be thus provided manually as an additional parameter.
 #
 # 'glyphlist.txt' holds the Adobe Glyph List (AGL).
 #
 # This program needs a C preprocessor.
 #
 
-CPP=cpp
-
-prog="$0"
-
-if test $# -ne 3; then
-  echo "usage: $0 UnicodeData.txt <version-string> glyphlist.txt > afmtodit.in"
-  exit 1
+if  $# -ne 3 
+then
+  echo "usage: $0 UnicodeData.txt UNICODE-VERSION-STRING" \
+    "glyphlist.txt > afmtodit.tables"
+  exit 2
 fi
 
 unicode_data="$1"
-version_string="$2"
+unicode_version="$2"
 glyph_list="$3"
 
-if test ! -f "$1"; then
-  echo "File '$1' doesn't exist" >&2
-  exit 2
-fi
-if test ! -f "$3"; then
-  echo "File '$3' doesn't exist" >&2
-  exit 2
-fi
+for f in "$1" "$3"
+do
+  if !  -r "$f" 
+  then
+    echo "$0: '$f' does not exist or is not readable" >&2
+    exit 1
+  fi
+done
 
 # Handle UnicodeData.txt.
 #
@@ -78,7 +76,7 @@
 | sed -e 's/^$^;*$;.*$/\1 u\1/' >> $$2
 
 # Run C preprocessor to recursively decompose.
-$CPP $$2 $$3
+"${CPP:-cpp}" $$2 $$3
 
 # Convert it back to original format.
 cat $$3 \
@@ -91,8 +89,8 @@
 
 # Write comment.
 cat <<END
-# This table has been algorithmically derived from the file
-# UnicodeData.txt, version $version_string, available from unicode.org,
+# This table was algorithmically derived from the file 'UnicodeData.txt'
+# for Unicode $unicode_version, available from unicode.org,
 # on `date '+%Y-%m-%d'`.
 END
 
@@ -106,21 +104,36 @@
 
 # Write comment.
 cat <<END
-# This table has been algorithmically derived from the file
-# glyphlist.txt, version 2.0, available from partners.adobe.com,
-# on `date '+%Y-%m-%d'`.
+# This table was algorithmically derived from the Adobe Glyph List (AGL)
+# file 'glyphlist.txt' from the GitHub Adobe Type Tools agl-aglfn
+# project, on `date '+%Y-%m-%d'`.
+#
+# See "groff:" comments for altered mappings.
 END
 
-# Emit second table.
-echo 'my %AGL_to_unicode = ('
+# Convert AGL syntax to a chunk of Perl.
 cat "$3" \
 | sed -e '/#/d' \
       -e 's/ /_/g' \
       -e '/;$E\|F0-8$/d' \
-      -e 's/$.*$;$.*$/  "\1", "\2",/'
+      -e 's/$.*$;$.*$/  "\1", "\2",/' > $$5
+
+# Perform groff replacements.
+sed \
+  -e 's/$"Delta"$, "2206",$/\1, "0394", # groff: not U+2206/' \
+  -e 's/$"Omega"$, "2126",$/\1, "03A9", # groff: not U+2126/' \
+  -e 's/$"mu"$, "00B5",$/\1, "03BC", # groff: not U+00B5/' \
+  < $$5 > $$6
+
+# Emit second table.
+echo 'my %AGL_to_unicode = ('
+cat $$6
 echo ');'
 
 # Remove temporary files.
-rm $$1 $$2 $$3 $$4
+rm $$1 $$2 $$3 $$4 $$5 $$6
 
-# EOF
+# Local Variables:
+# fill-column: 72
+# End:
+# vim: set textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog Added

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/grog.1.man Added

@@ -0,0 +1,628 @@
+.TH grog @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+grog \- \(lqgroff guess\(rq\(eminfer the
+.I groff
+command a document requires
+.
+.
+.\" ====================================================================
+.\" Legal Terms
+.\" ====================================================================
+.\"
+.\" Copyright (C) 1989-2021 Free Software Foundation, Inc.
+.\"
+.\" This file is part of grog, which is part of groff, a free software
+.\" project.  You can redistribute it and/or modify it under the terms
+.\" of the GNU General Public License version 2 (GPL2) as published by
+.\" the Free Software Foundation.
+.\"
+.\" 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.
+.\"
+.\" The text for GPL2 is available in the internet at
+.\" <http://www.gnu.org/licenses/gpl2.0.txt>.
+.
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_grog_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" ====================================================================
+.SH Synopsis
+.\" ====================================================================
+.
+.SY grog
+.RB  \-\-run 
+.RB  \-\-ligatures 
+.RI  groff-option\~ .\|.\|.\&
+.RB  \-\- 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY grog
+.B \-h
+.
+.SY grog
+.B \-\-help
+.YS
+.
+.
+.SY grog
+.B \-v
+.
+.SY grog
+.B \-\-version
+.YS
+.
+.
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
+.
+.I grog
+reads its input
+and guesses which
+.MR groff @MAN1EXT@
+options are needed to render it.
+.
+If no operands are given,
+or if
+.I file
+is
+.RB \lq \- \rq,
+.I grog
+reads the standard input stream.
+.
+The corresponding
+.I groff
+command is normally written to the standard output stream.
+.
+With the option
+.BR \-\-run ,
+the inferred command is written to the standard error stream and then
+executed.
+.
+.
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+.B \-h
+and
+.B \-\-help
+display a usage message,
+whereas
+.B \-v
+and
+.B \-\-version
+display version information;
+all exit afterward.
+.
+.
+.TP
+.B \-\-ligatures
+includes the arguments
+.B \-P\-y \-PU
+in the inferred
+.I groff
+command.
+.
+These are supported only by the
+.B pdf
+output device.
+.
+.
+.TP
+.B \-\-run
+writes the inferred command to the standard error stream and then
+executes it.
+.
+.
+.P
+All other specified short options
+(that is,
+arguments beginning with a minus sign
+.RB \lq \- \rq
+followed by a letter)
+are interpreted as
+.I groff
+options or option clusters with or without an option argument.
+.
+Such options are included in the constructed
+.I groff
+command line.
+.
+.
+.\" ====================================================================
+.SH Details
+.\" ====================================================================
+.
+.I grog
+reads each
+.I file
+operand,
+pattern-matching strings that are statistically likely to be
+characteristic of
+.MR roff @MAN7EXT@
+documents.
+.
+It tries to guess which of the following
+.I groff
+options are required to correctly render the input:
+.BR \-e ,
+.BR \-g ,
+.BR \-G ,
+.BR \-j ,
+.\" gideal is not implemented yet.
+.\" .BR \-J ,
+.BR \-p ,
+.BR \-R ,
+.\".BR \-s ,
+.B \-t
+(preprocessors);
+and
+.BR \-man ,
+.BR \-mdoc ,
+.BR \-mdoc\-old ,
+.BR \-me ,
+.BR \-mm ,
+.BR \-mom ,
+and
+.B \-ms
+(macro packages).
+.
+The inferred
+.I groff
+command including these options and any
+.I file
+parameters is written to the standard output stream.
+.
+.
+.P
+It is possible to specify arbitrary
+.I groff
+options on the command line.
+.
+These are included in the inferred command without change.
+.
+Choices of
+.I groff
+options include
+.B \-C
+to enable AT&T
+.I troff
+compatibility mode and
+.B \-T
+to select a non-default output device.
+.
+If the input is not encoded in US-ASCII,
+ISO 8859-1,
+or IBM code page 1047,
+specification of a
+.I groff
+option to run the
+.MR preconv @MAN1EXT@
+preprocessor is advised;
+see the
+.BR \-D ,
+.BR \-k ,
+and
+.B \-K
+options of
+.MR groff @MAN1EXT@ .
+.
+For UTF-8 input,
+.B \-k
+is a good choice.
+.
+.
+.P
+.I groff
+may issue diagnostic messages when an inappropriate
+.B \-m
+option,
+or multiple conflicting ones,
+are specified.
+.
+Consequently,
+it is best to specify no
+.B \-m
+options to
+.I grog
+unless it cannot correctly infer all of the
+.B \-m
+arguments a document requires.
+.
+A
+.I roff
+document can also be written without recourse to any macro package.
+.
+In such cases,
+.I grog
+will infer a
+.I groff
+command without an
+.B \-m
+option.
+.
+.
+.\" ====================================================================
+.SS Limitations
+.\" ====================================================================
+.
+.I grog
+presumes that the input does not change the escape,
+control,
+or no-break control characters.
+.
+.I grog
+does not parse
+.I roff
+input line continuation or control structures
+(brace escape sequences and the
+.RB \lq if \rq,
+.RB \lq ie \rq,
+and
+.RB \lq el \rq
+requests)
+nor
+.IR groff 's
+.RB \lq while \rq.
+.
+Thus the input
+.
+.RS
+.EX
+\&.if \rs
+t .NH 1
+\&.if n .SH
+Introduction
+.EE
+.RE
+.
+will conceal the use of the
+.I ms
+macros
+.B NH
+and
+.B SH
+from
+.IR grog .
+.
+Such constructions are regarded by
+.IR grog 's
+implementors as insufficiently common to cause many inference problems.
+.
+Preprocessors can be even stricter when matching macro calls that
+bracket the regions of an input file they replace.
+.
+.IR pic ,
+for example,
+requires
+.BR PS ,
+.BR PE ,
+and
+.B PF
+calls to immediately follow the default control character at the
+beginning of a line.
+.
+.
+.P
+Detection of the
+.B \-s
+option
+(the
+.MR @g@soelim @MAN1EXT@
+preprocessor)
+is tricky;
+to correctly infer its necessity would require
+.I grog
+to recursively open all files given as arguments to the
+.B .so
+request under the same conditions that
+.I @g@soelim
+itself does so;
+see its man page.
+.
+Recall that
+.I @g@soelim
+is necessary only if sourced files need to be preprocessed.
+.
+Therefore,
+as a workaround,
+you may want to run the input through
+.I @g@soelim
+manually,
+piping it to
+.IR grog ,
+and compare the output to running
+.I grog
+on the input directly.
+.
+If the
+.RI \lq @g@soelim \rqed
+input causes
+.I grog
+to infer additional preprocessor options,
+then
+.B \-s
+is likely necessary.
+.
+.
+.RS
+.P
+.EX
+$ \c
+.B printf \dq.TS\rsnl.\rsnI\aqm a table.\rsn.TE\rsn\dq > \
+3.roff
+$ \c
+.B printf \dq.so 3.roff\rsn\dq > 2.roff
+$ \c
+.B printf \dq.XP\rsn.so 2.roff\rsn\dq > 1.roff
+$ \c
+.B grog 1.roff
+groff \-ms 1.roff
+$ \c
+.B @g@soelim 1.roff | grog
+groff \-t \-ms \-
+.EE
+.RE
+.
+.
+.P
+In the foregoing example,
+we see that this procedure enabled
+.I grog
+to detect
+.MR @g@tbl @MAN1EXT@
+macros,
+so we would add
+.B \-s
+as well as the detected
+.B \-t
+option to a revised
+.I grog
+or
+.I groff
+command.
+.
+.
+.RS
+.P
+.EX
+$ \c
+.B grog \-st 1.roff
+groff \-st \-ms 1.roff
+.EE
+.RE
+.
+.
+.\" ====================================================================
+.SH "Exit status"
+.\" ====================================================================
+.
+.I grog
+exits with error status
+.B 1
+if a macro package appears to be in use by the input document,
+but
+.I grog
+was unable to infer which one,
+or
+.B 2
+if there were problems handling an option or operand.
+.
+It otherwise exits with status
+.BR 0 .
+.
+(If the
+.B \-\-run
+option is specified,
+.IR groff 's
+exit status is discarded.)
+.
+Inferring no preprocessors or macro packages is not an error condition;
+a valid
+.I roff
+document need not use either.
+.
+Even plain text is valid input,
+if one is mindful of the syntax of the control and escape characters.
+.
+.
+.\" ====================================================================
+.SH Examples
+.\" ====================================================================
+.
+Running
+.
+.RS
+.EX
+.B grog @DOCDIR@/meintro.me
+.EE
+.RE
+at the command line results in
+.RS
+.EX
+groff \-me @DOCDIR@/meintro.me
+.EE
+.RE
+.
+because
+.I grog
+recognizes that the file
+.I meintro.me
+is written using macros from the
+.I me
+package.
+.
+The command
+.
+.RS
+.EX
+.B grog @DOCDIR@/pic.ms
+.EE
+.RE
+.
+outputs
+.
+.RS
+.EX
+groff \-e \-p \-t \-ms @DOCDIR@/pic.ms
+.EE
+.RE
+.
+on the other hand.
+.
+Besides discerning the
+.I ms
+macro package,
+.I grog
+recognizes that the file
+.I pic.ms
+additionally needs the combination of
+.B \-t
+for
+.IR tbl ,
+.B \-e
+for
+.IR eqn ,
+and
+.B \-p
+for
+.IR pic .
+.
+.
+.\" XXX: grog no longer (June 2021) attempts to detect this scenario.
+.\" It's also not a practical one; full-service macro packages don't
+.\" generally support being "unloaded" for subsequent processing of
+.\" another document using a different one.  We do achieve it, with
+.\" care, in groff with man(7) and mdoc(7) (see andoc.tmac).
+.\" .P
+.\" If both of the former example files are combined in the command
+.\" .
+.\" .RS
+.\" .EX
+.\" .B grog meintro.me pic.ms
+.\" .EE
+.\" .RE
+.\" .
+.\" a diagnostic message is sent to the standard error stream because
+.\" some macro packages cannot be combined.
+.\" .
+.\" Nevertheless the corresponding output with the wrong options is
+.\" written to standard output:
+.\" .
+.\" .RS
+.\" .EX
+.\" groff \-t \-e \-p \-ms meintro.me pic.ms
+.\" .EE
+.\" .RE
+.\" .
+.\" and
+.\" .I grog
+.\" terminates with an error exit status.
+.
+.
+.P
+Consider a file
+.IR \%doc/\:\%grnexampl.me ,
+which uses the
+.I @g@grn
+preprocessor to include a
+.MR gremlin 1
+picture file in an
+.I me \" generic
+document.
+.
+Let's say we want to suppress color output,
+produce a DVI file,
+and get backtraces for any errors that
+.I @g@troff
+encounters.
+.
+The command
+.
+.RS
+.EX
+.B grog \-bc \-Idoc \-Tdvi doc/grnexmpl.me
+.EE
+.RE
+.
+is processed by
+.I grog
+into
+.
+.RS
+.EX
+groff \-bc \-Idoc \-Tdvi \-e \-g \-me doc/grnexmpl.me
+.EE
+.RE
+.
+where we can see that
+.I grog
+has inferred the
+.I me \" generic
+macro package along with the
+.I eqn \" generic
+and
+.I grn \" generic
+preprocessors.
+.
+(The input file is located in
+.I @DOCDIR@
+if you'd like to try this example yourself.)
+.
+.
+.\" ====================================================================
+.SH Authors
+.\" ====================================================================
+.
+.I grog
+was originally written in Bourne shell by James Clark.
+.
+The current implementation in Perl was written by
+.MT groff\-bernd\:.warken\-72@\:web\:.de
+Bernd Warken
+.ME
+and heavily revised by
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
+.ME .
+.
+.
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
+.
+.MR groff @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_grog_1_man_C
+.do rr *groff_grog_1_man_C
+.
+.
+.\" Local Variables:
+.\" fill-column: 72
+.\" mode: nroff
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/grog.am Added

@@ -0,0 +1,50 @@
+# Copyright (C) 1993-2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+
+grog_srcdir = $(top_srcdir)/src/utils/grog
+bin_SCRIPTS += grog
+man1_MANS += src/utils/grog/grog.1
+EXTRA_DIST += \
+  src/utils/grog/grog.1.man \
+  src/utils/grog/grog.pl \
+  src/utils/grog/tests/foo.man
+
+grog: $(grog_srcdir)/grog.pl $(SH_DEPS_SED_SCRIPT)
+	$(AM_V_GEN)$(RM) $@ \
+	&& sed -f "$(SH_DEPS_SED_SCRIPT)" \
+	       -e "s|@PERL@|$(PERL)|" \
+	       -e "s|@VERSION@|$(VERSION)|" \
+	       -e "$(SH_SCRIPT_SED_CMD)" \
+	       $(grog_srcdir)/grog.pl \
+	       >$@ \
+	&& chmod +x $@
+
+grog_TESTS = \
+  src/utils/grog/tests/PF-does-not-start-pic-region.sh \
+  src/utils/grog/tests/avoid-refer-fakeout.sh \
+  src/utils/grog/tests/preserve-groff-options.sh \
+  src/utils/grog/tests/recognize-perl-pod.sh \
+  src/utils/grog/tests/smoke-test.sh
+TESTS += $(grog_TESTS)
+EXTRA_DIST += $(grog_TESTS)
+
+
+# Local Variables:
+# mode: makefile-automake
+# fill-column: 72
+# End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/grog.pl Added

@@ -0,0 +1,721 @@
+#!@PERL@
+# grog - guess options for groff command
+# Inspired by doctype script in Kernighan & Pike, Unix Programming
+# Environment, pp 306-8.
+
+# Copyright (C) 1993-2021 Free Software Foundation, Inc.
+# Written by James Clark.
+# Rewritten in Perl by Bernd Warken <groff-bernd.warken-72@web.de>.
+# Hacked up by G. Branden Robinson, 2021.
+
+# This file is part of 'grog', 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 2 of the License, or
+# (at your option) any later version.
+
+# '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 this program.  If not, see
+# <http://www.gnu.org/licenses/gpl-2.0.html>.
+
+use warnings;
+use strict;
+
+use File::Spec;
+
+my $groff_version = 'DEVELOPMENT';
+
+my @command = ();		# the constructed groff command
+my @requested_package = ();	# arguments to '-m' grog options
+my @inferred_preprocessor = ();	# preprocessors the document uses
+my @inferred_main_package = ();	# full-service package(s) detected
+my $main_package;		# full-service package we go with
+my $do_run = 0;			# run generated 'groff' command
+my $use_compatibility_mode = 0;	# is -C being passed to groff?
+
+my %preprocessor_for_macro = (
+  'EQ', 'eqn',
+  'G1', 'grap',
+  'GS', 'grn',
+  'PS', 'pic',
+  '',  'refer',
+  #'so', 'soelim', # Can't be inferred this way; see grog man page.
+  'TS', 'tbl',
+  'cstart',   'chem',
+  'lilypond', 'glilypond',
+  'Perl',     'gperl',
+  'pinyin',   'gpinyin',
+);
+
+my $program_name = $0;
+{
+  my ($v, $d, $f) = File::Spec->splitpath($program_name);
+  $program_name = $f;
+}
+
+my %user_macro;
+my %score = ();
+
+my @input_file;
+
+# .TH is both a man(7) macro and often used with tbl(1).  We expect to
+# find .TH in ms(7) documents only between .TS and .TE calls, and in
+# man(7) documents only as the first macro call.
+my $have_seen_first_macro_call = 0;
+# man(7) and ms(7) use many of the same macro names; do extra checking.
+my $man_score = 0;
+my $ms_score = 0;
+
+my $had_inference_problem = 0;
+my $had_processing_problem = 0;
+my $have_any_valid_arguments = 0;
+
+
+sub fail {
+  my $text = shift;
+  print STDERR "$program_name: error: $text\n";
+  $had_processing_problem = 1;
+}
+
+
+sub warn {
+  my $text = shift;
+  print STDERR "$program_name: warning: $text\n";
+}
+
+
+sub process_arguments {
+  my $no_more_options = 0;
+  my $delayed_option = '';
+  my $was_minus = 0;
+  my $optarg = 0;
+  my $pdf_with_ligatures = 0;
+
+  foreach my $arg (@ARGV) {
+    if ( $optarg ) {
+      push @command, $arg;
+      $optarg = 0;
+      next;
+    }
+
+    if ($no_more_options) {
+      push @input_file, $arg;
+      next;
+    }
+
+    if ($delayed_option) {
+      if ($delayed_option eq '-m') {
+	push @requested_package, $arg;
+	$arg = '';
+      } else {
+	push @command, $delayed_option;
+      }
+
+      push @command, $arg if $arg;
+      $delayed_option = '';
+      next;
+    }
+
+    unless ( $arg =~ /^-/ ) { # file name, no opt, no optarg
+      push @input_file, $arg;
+      next;
+    }
+
+    # now $arg starts with '-'
+
+    if ($arg eq '-') {
+      unless ($was_minus) {
+	push @input_file, $arg;
+	$was_minus = 1;
+      }
+      next;
+    }
+
+    if ($arg eq '--') {
+      $no_more_options = 1;
+      next;
+    }
+
+    # Handle options that cause an early exit.
+    &version() if ($arg eq '-v' || $arg eq '--version');
+    &usage(0) if ($arg eq '-h' || $arg eq '--help');
+
+    if ($arg =~ '^--.') {
+      if ($arg =~ '^--(run|with-ligatures)$') {
+	$do_run = 1             if ($arg eq '--run');
+	$pdf_with_ligatures = 1 if ($arg eq '--with-ligatures');
+      } else {
+        &fail("unrecognized grog option '$arg'; ignored");
+	&usage(1);
+      }
+      next;
+    }
+
+    # Handle groff options that take an argument.
+
+    # Handle the option argument being separated by whitespace.
+    if ($arg =~ /^-dfFIKLmMnoPrTwW$/) {
+      $delayed_option = $arg;
+      next;
+    }
+
+    # Handle '-m' option without subsequent whitespace.
+    if ($arg =~ /^-m/) {
+      my $package = $arg;
+      $package =~ s/-m//;
+      push @requested_package, $package;
+      next;
+    }
+
+    # Treat anything else as (possibly clustered) groff options that
+    # take no arguments.
+
+    # Our do_line() needs to know if it should do compatibility parsing.
+    $use_compatibility_mode = 1 if ($arg =~ /C/);
+
+    push @command, $arg;
+  }
+
+  if ($pdf_with_ligatures) {
+    push @command, '-P-y';
+    push @command, '-PU';
+  }
+
+  @input_file = ('-') unless (@input_file);
+} # process_arguments()
+
+
+sub process_input {
+  foreach my $file (@input_file) {
+    unless ( open(FILE, $file eq "-" ? $file : "< $file") ) {
+      &fail("cannot open '$file': $!");
+      next;
+    }
+
+    $have_any_valid_arguments = 1;
+
+    while (my $line = <FILE>) {
+      chomp $line;
+      &do_line($line);
+    }
+
+    close(FILE);
+  } # end foreach
+} # process_input()
+
+
+# Push item onto inferred full-service list only if not already present.
+sub push_main_package {
+  my $pkg = shift;
+  if (!grep(/^$pkg/, @inferred_main_package)) {
+    push @inferred_main_package, $pkg;
+  }
+} # push_main_package()
+
+
+sub do_line {
+  my $command;			# request or macro name
+  my $args;			# request or macro arguments
+
+  my $line = shift;
+
+  # Check for a Perl Pod::Man comment.
+  #
+  # An alternative to this kludge is noted below: if a "standard" macro
+  # is redefined, we could delete it from the relevant lists and
+  # hashes.
+  if ($line =~ /\\\" Automatically generated by Pod::Man/) {
+    $man_score += 100;
+  }
+
+  # Strip comments.
+  $line =~ s/\\".*//;
+  $line =~ s/\\#.*// unless $use_compatibility_mode;
+
+  return unless ($line =~ /^.'/);	# Ignore text lines.
+
+  # Perform preprocessor checks; they scan their inputs using a rump
+  # interpretation of roff(7) syntax that requires the default control
+  # character and no space between it and the macro name.  In AT&T
+  # compatibility mode, no space (or newline!) is required after the
+  # macro name, either.  We mimic the preprocessors themselves; eqn(1),
+  # for instance, does not recognize '.EN' if '.EQ' has not been seen.
+  my $boundary = '\\b';
+  $boundary = '' if ($use_compatibility_mode);
+
+  if ($line =~ /^\.(\S\S)$boundary/ || $line =~ /^\.(\)/) {
+    my $macro = $1;
+    # groff identifiers can have extremely weird characters in them.
+    # The ones we care about are conventionally named, but me(7)
+    # documents can call macros like '+c', so quote carefully.
+    if (grep(/^\Q$macro\E$/, keys %preprocessor_for_macro)) {
+      my $preproc = $preprocessor_for_macro{$macro};
+      if (!grep(/$preproc/, @inferred_preprocessor)) {
+	push @inferred_preprocessor, $preproc;
+      }
+    }
+  }
+
+  # Normalize control lines; convert no-break control character to the
+  # regular one and remove unnecessary whitespace.
+  $line =~ s/^'.\s*/./;
+  $line =~ s/\s+$//;
+
+  return if ($line =~ /^\.$/);		# Ignore empty request.
+  return if ($line =~ /^\.\\?\.$/);	# Ignore macro definition ends.
+
+  # Split control line into a request or macro call and its arguments.
+
+  # Handle single-letter macro names.
+  if ($line =~ /^\.(\S)(\s+(.*))?$/) {
+    $command = $1;
+    $args = $2;
+  # Handle two-letter macro/request names in compatibility mode.
+  } elsif ($use_compatibility_mode) {
+    $line =~ /^\.(\S\S)\s*(.*)$/;
+    $command = $1;
+    $args = $2;
+  # Handle multi-letter macro/request names in groff mode.
+  } else {
+    $line =~ /^\.(\S+)(\s+(.*))?$/;
+    $command = $1;
+    $args = $3;
+  }
+
+  $command = '' unless ($command);
+  $args = '' unless ($args);
+
+  ######################################################################
+  # user-defined macros
+
+  # If the line calls a user-defined macro, skip it.
+  return if (exists $user_macro{$command});
+
+  # These are all requests supported by groff 1.23.0.
+  my @request = ('ab', 'ad', 'af', 'aln', 'als', 'am', 'am1', 'ami',
+		 'ami1', 'as', 'as1', 'asciify', 'backtrace', 'bd',
+		 'blm', 'box', 'boxa', 'bp', 'br', 'brp', 'break', 'c2',
+		 'cc', 'ce', 'cf', 'cflags', 'ch', 'char', 'chop',
+		 'class', 'close', 'color', 'composite', 'continue',
+		 'cp', 'cs', 'cu', 'da', 'de', 'de1', 'defcolor', 'dei',
+		 'dei1', 'device', 'devicem', 'di', 'do', 'ds', 'ds1',
+		 'dt', 'ec', 'ecr', 'ecs', 'el', 'em', 'eo', 'ev',
+		 'evc', 'ex', 'fam', 'fc', 'fchar', 'fcolor', 'fi',
+		 'fp', 'fschar', 'fspecial', 'ft', 'ftr', 'fzoom',
+		 'gcolor', 'hc', 'hcode', 'hla', 'hlm', 'hpf', 'hpfa',
+		 'hpfcode', 'hw', 'hy', 'hym', 'hys', 'ie', 'if', 'ig',
+		 'in', 'it', 'itc', 'kern', 'lc', 'length', 'linetabs',
+		 'lf', 'lg', 'll', 'lsm', 'ls', 'lt', 'mc', 'mk', 'mso',
+		 'msoquiet', 'na', 'ne', 'nf', 'nh', 'nm', 'nn', 'nop',
+		 'nr', 'nroff', 'ns', 'nx', 'open', 'opena', 'os',
+		 'output', 'pc', 'pev', 'pi', 'pl', 'pm', 'pn', 'pnr',
+		 'po', 'ps', 'psbb', 'pso', 'ptr', 'pvs', 'rchar', 'rd',
+		 'return', 'rfschar', 'rj', 'rm', 'rn', 'rnn', 'rr',
+		 'rs', 'rt', 'schar', 'shc', 'shift', 'sizes', 'so',
+		 'soquiet', 'sp', 'special', 'spreadwarn', 'ss',
+		 'stringdown', 'stringup', 'sty', 'substring', 'sv',
+		 'sy', 'ta', 'tc', 'ti', 'tkf', 'tl', 'tm', 'tm1',
+		 'tmc', 'tr', 'trf', 'trin', 'trnt', 'troff', 'uf',
+		 'ul', 'unformat', 'vpt', 'vs', 'warn', 'warnscale',
+		 'wh', 'while', 'write', 'writec', 'writem');
+
+  # Add user-defined macro names to %user_macro.
+  #
+  # Macros can also be defined with .dei{,1}, ami{,1}, but supporting
+  # that would be a heavy lift for the benefit of users that probably
+  # don't require grog's help.  --GBR
+  if ($command =~ /^(de|am)1?$/) {
+    my $name = $args;
+    # Strip off any end macro.
+    $name =~ s/\s+.*$//;
+    # Handle special cases of macros starting with '' or ''.
+    if ($name =~ /^/) {
+      delete $preprocessor_for_macro{''};
+    }
+    # XXX: If the macro name shadows a standard macro name, maybe we
+    # should delete the latter from our lists and hashes.  This might
+    # depend on whether the document is trying to remain compatible
+    # with an existing interface, or simply colliding with names they
+    # don't care about (consider a raw roff document that defines 'PP').
+    # --GBR
+    $user_macro{$name} = 0 unless (exists $user_macro{$name});
+    return;
+  }
+
+  # XXX: Handle .rm as well?
+
+  # Ignore all other requests.  Again, macro names can contain Perl
+  # regex metacharacters, so be careful.
+  return if (grep(/^\Q$command\E$/, @request));
+  # What remains must be a macro name.
+  my $macro = $command;
+
+  $have_seen_first_macro_call = 1;
+  $score{$macro}++;
+
+
+  ######################################################################
+  # macro package (tmac)
+  ######################################################################
+
+  # man and ms share too many macro names for the following approach to
+  # be fruitful for many documents; see &infer_man_or_ms_package.
+  #
+  # We can put one thumb on the scale, however.
+  if ((!$have_seen_first_macro_call) && ($macro eq 'TH')) {
+    # TH as the first call in a document screams man(7).
+    $man_score += 100;
+  }
+
+  ##########
+  # mdoc
+  if ($macro =~ /^Dd$/) {
+    &push_main_package('doc');
+    return;
+  }
+
+  ##########
+  # old mdoc
+  if ($macro =~ /^(Tp|Dp|De|Cx|Cl)$/) {
+    &push_main_package('doc-old');
+    return;
+  }
+
+  ##########
+  # me
+
+  if ($macro =~ /^(
+		   ilnpp|
+		   n12|
+		   sh
+		  )$/x) {
+    &push_main_package('e');
+    return;
+  }
+
+
+  #############
+  # mm and mmse
+
+  if ($macro =~ /^(
+		   H|
+		   MULB|
+		   LO|
+		   LT|
+		   NCOL|
+		   PH|
+		   SA
+		  )$/x) {
+    if ($macro =~ /^LO$/) {
+      if ( $args =~ /^(DNAMN|MDAT|BIL|KOMP|DBET|BET|SIDOR)/ ) {
+	&push_main_package('mse');
+	return;
+      }
+    } elsif ($macro =~ /^LT$/) {
+      if ( $args =~ /^(SVV|SVH)/ ) {
+	&push_main_package('mse');
+	return;
+      }
+    }
+    &push_main_package('m');
+    return;
+  }
+
+  ##########
+  # mom
+
+  if ($macro =~ /^(
+		   ALD|
+		   AUTHOR|
+		   CHAPTER_TITLE|
+		   CHAPTER|
+		   COLLATE|
+		   DOCHEADER|
+		   DOCTITLE|
+		   DOCTYPE|
+		   DOC_COVER|
+		   FAMILY|
+		   FAM|
+		   FT|
+		   LEFT|
+		   LL|
+		   LS|
+		   NEWPAGE|
+		   NO_TOC_ENTRY|
+		   PAGENUMBER|
+		   PAGE|
+		   PAGINATION|
+		   PAPER|
+		   PRINTSTYLE|
+		   PT_SIZE|
+		   START|
+		   TITLE|
+		   TOC_AFTER_HERE
+		   TOC|
+		   T_MARGIN|
+		  )$/x) {
+    &push_main_package('om');
+    return;
+  }
+} # do_line()
+
+my @preprocessor = ();
+
+
+sub infer_preprocessors {
+  my %option_for_preprocessor =  (
+    'eqn', '-e',
+    'grap', '-G',
+    'grn', '-g',
+    'pic', '-p',
+    'refer', '-R',
+    #'soelim', '-s', # Can't be inferred this way; see grog man page.
+    'tbl', '-t',
+    'chem', '-j'
+  );
+
+  # Use a temporary list we can sort later.  We want the options to show
+  # up in a stable order for testing purposes instead of the order their
+  # macros turn up in the input.  groff doesn't care about the order.
+  my @opt = ();
+
+  foreach my $preproc (@inferred_preprocessor) {
+    my $preproc_option = $option_for_preprocessor{$preproc};
+
+    if ($preproc_option) {
+      push @opt, $preproc_option;
+    } else {
+      push @preprocessor, $preproc;
+    }
+  }
+  push @command, sort @opt;
+} # infer_preprocessors()
+
+
+# Return true (1) if either the man or ms package is inferred.
+sub infer_man_or_ms_package {
+  my @macro_ms = ('RP', 'TL', 'AU', 'AI', 'DA', 'ND', 'AB', 'AE',
+		  'QP', 'QS', 'QE', 'XP',
+		  'NH',
+		  'R',
+		  'CW',
+		  'BX', 'UL', 'LG', 'NL',
+		  'KS', 'KF', 'KE', 'B1', 'B2',
+		  'DS', 'DE', 'LD', 'ID', 'BD', 'CD', 'RD',
+		  'FS', 'FE',
+		  'OH', 'OF', 'EH', 'EF', 'P1',
+		  'TA', '1C', '2C', 'MC',
+		  'XS', 'XE', 'XA', 'TC', 'PX',
+		  'IX', 'SG');
+
+  my @macro_man = ('BR', 'IB', 'IR', 'RB', 'RI', 'P', 'TH', 'TP', 'SS',
+		   'HP', 'PD',
+		   'AT', 'UC',
+		   'SB',
+		   'EE', 'EX',
+		   'OP',
+		   'MT', 'ME', 'SY', 'YS', 'TQ', 'UR', 'UE');
+
+  my @macro_man_or_ms = ('B', 'I', 'BI',
+			 'DT',
+			 'RS', 'RE',
+			 'SH',
+			 'SM',
+			 'IP', 'LP', 'PP');
+
+  for my $key (@macro_man_or_ms, @macro_man, @macro_ms) {
+    $score{$key} = 0 unless exists $score{$key};
+  }
+
+  # Compute a score for each package by counting occurrences of their
+  # characteristic macros.
+  foreach my $key (@macro_man_or_ms) {
+    $man_score += $score{$key};
+    $ms_score += $score{$key};
+  }
+
+  foreach my $key (@macro_man) {
+    $man_score += $score{$key};
+  }
+
+  foreach my $key (@macro_ms) {
+    $ms_score += $score{$key};
+  }
+
+  if (!$ms_score && !$man_score) {
+    # The input may be a "raw" roff document; this is not a problem,
+    # but it does mean no package was inferred.
+    return 0;
+  } elsif ($ms_score == $man_score) {
+    # If there was no TH call, it's not a (valid) man(7) document.
+    if (!$score{'TH'}) {
+      &push_main_package('s');
+    } else {
+      &warn("document ambiguous; disambiguate with -man or -ms option");
+      $had_inference_problem = 1;
+    }
+    return 0;
+  } elsif ($ms_score > $man_score) {
+    &push_main_package('s');
+  } else {
+    &push_main_package('an');
+  }
+
+  return 1;
+} # infer_man_or_ms_package()
+
+
+sub construct_command {
+  my @main_package = ('an', 'doc', 'doc-old', 'e', 'm', 'om', 's');
+  my $file_args_included;	# file args now only at 1st preproc
+  unshift @command, 'groff';
+  if (@preprocessor) {
+    my @progs;
+    $progs0 = shift @preprocessor;
+    push(@progs, @input_file);
+    for (@preprocessor) {
+      push @progs, '|';
+      push @progs, $_;
+    }
+    push @progs, '|';
+    unshift @command, @progs;
+    $file_args_included = 1;
+  } else {
+    $file_args_included = 0;
+  }
+
+  foreach (@command) {
+    next unless /\s/;
+    # when one argument has several words, use accents
+    $_ = "'" . $_ . "'";
+  }
+
+  my $have_ambiguous_main_package = 0;
+  my $inferred_main_package_count = scalar @inferred_main_package;
+
+  # Did we infer multiple full-service packages?
+  if ($inferred_main_package_count > 1) {
+    $have_ambiguous_main_package = 1;
+    # For each one the user explicitly requested...
+    for my $pkg (@requested_package) {
+      # ...did it resolve the ambiguity for us?
+      if (grep(/$pkg/, @inferred_main_package)) {
+	@inferred_main_package = ($pkg);
+	$have_ambiguous_main_package = 0;
+	last;
+      }
+    }
+  } elsif ($inferred_main_package_count == 1) {
+    $main_package = shift @inferred_main_package;
+  }
+
+  if ($have_ambiguous_main_package) {
+    # TODO: Alphabetical is probably not the best ordering here.  We
+    # should tally up scores on a per-package basis generally, not just
+    # for an and s.
+    for my $pkg (@main_package) {
+      if (grep(/$pkg/, @inferred_main_package)) {
+	$main_package = $pkg;
+	&warn("document ambiguous (choosing '$main_package'"
+	      . " from '@inferred_main_package'); disambiguate with -m"
+	      . " option");
+	$had_inference_problem = 1;
+	last;
+      }
+    }
+  }
+
+  # If a full-service package was explicitly requested, warn if the
+  # inference differs from the request.  This also ensures that all -m
+  # arguments are placed in the same order that the user gave them;
+  # caveat dictator.
+  my @auxiliary_package_argument = ();
+  for my $pkg (@requested_package) {
+    my $is_auxiliary_package = 1;
+    if (grep(/$pkg/, @main_package)) {
+      $is_auxiliary_package = 0;
+      if ($pkg ne $main_package) {
+	&warn("overriding inferred package '$main_package'"
+	      . " with requested package '$pkg'");
+	$main_package = $pkg;
+      }
+    }
+    if ($is_auxiliary_package) {
+      push @auxiliary_package_argument, "-m" . $pkg;
+    }
+  }
+
+  push @command, '-m' . $main_package if ($main_package);
+  push @command, @auxiliary_package_argument;
+  push @command, @input_file unless ($file_args_included);
+
+  #########
+  # execute the 'groff' command here with option '--run'
+  if ( $do_run ) { # with --run
+    print STDERR "@command\n";
+    my $cmd = join ' ', @command;
+    system($cmd);
+  } else {
+    print "@command\n";
+  }
+} # construct_command()
+
+
+sub usage {
+  my $stream = *STDOUT;
+  my $had_error = shift;
+  $stream = *STDERR if $had_error;
+  my $grog = $program_name;
+  print $stream "usage: $grog --ligatures --run" .
+    " groff-option ... -- file ...\n" .
+    "usage: $grog {-v | --version}\n" .
+    "usage: $grog {-h | --help}\n";
+  unless ($had_error) {
+    print $stream "\n" .
+"Read each roff(7) input FILE and attempt to infer an appropriate\n" .
+"groff(1) command to format it.  See the grog(1) manual page.\n";
+  }
+  exit $had_error;
+}
+
+
+sub version {
+  print "GNU $program_name (groff) $groff_version\n";
+  exit 0;
+} # version()
+
+
+# initialize
+
+my $in_unbuilt_source_tree = 0;
+{
+  my $at = '@';
+  $in_unbuilt_source_tree = 1 if ('@VERSION@' eq "${at}VERSION${at}");
+}
+
+$groff_version = '@VERSION@' unless ($in_unbuilt_source_tree);
+
+&process_arguments();
+&process_input();
+
+if ($have_any_valid_arguments) {
+  &infer_preprocessors();
+  &infer_man_or_ms_package() if (scalar @inferred_main_package != 1);
+  &construct_command();
+}
+
+exit 2 if ($had_processing_problem);
+exit 1 if ($had_inference_problem);
+exit 0;
+
+# Local Variables:
+# fill-column: 72
+# mode: CPerl
+# End:
+# vim: set cindent noexpandtab shiftwidth=2 softtabstop=2 textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/PF-does-not-start-pic-region.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/avoid-refer-fakeout.sh Added

@@ -0,0 +1,34 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+grog="${abs_top_builddir:-.}/grog"
+
+# Regression-test Savannah #61520.
+#
+# Don't be fooled by documents (like xterm's ctlseqs.ms) that define
+# macros with names that start with '' or ''.
+
+input=".de 
+..
+. foo"
+
+echo "$input" | "$grog" | grep -Fqx 'groff -'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/foo.man Added

@@ -0,0 +1,146 @@
+.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds # \f1
+.    ds # \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds # \&
+.    ds # \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#\z\(de\v'.3n'\h'|\\n:u'\*(#
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#
+.ds Th \*(#\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm # # #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "FOO 1"
+.TH FOO 1 "2021-06-30" "perl v5.28.1" "User Contributed Perl Documentation"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "Name"
+.IX Header "Name"
+foo \- a frobnicator
+.SH "Description"
+.IX Header "Description"
+This is my program.

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/preserve-groff-options.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/recognize-perl-pod.sh Added

@@ -0,0 +1,31 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+grog="${abs_top_builddir:-.}/grog"
+doc="${abs_top_srcdir:-..}/src/utils/grog/tests/foo.man"
+
+# Regression test Savannah #59622.
+#
+# Recognize the strongly-accented dialect of man(7) produced by
+# pod2man(1).
+
+"$grog" "$doc" | grep '^groff -man .*/src/utils/grog/tests/foo\.man'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/src/utils/grog/tests/smoke-test.sh Added

@@ -0,0 +1,153 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+set -e
+
+grog="${abs_top_builddir:-.}/grog"
+src="${abs_top_srcdir:-..}"
+
+doc=src/preproc/eqn/neqn.1
+echo "testing simple man(7) page $doc" >&2
+"$grog" "$doc" | \
+	    grep -Fqx 'groff -man '"$doc"
+
+doc=src/preproc/tbl/tbl.1
+echo "testing tbl(1)-using man(7) page $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -t -man '"$doc"
+
+doc=man/groff_diff.7
+echo "testing eqn(1)-using man(7) page $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -e -man '"$doc"
+
+# BUG: grog doesn't yet handle .if, .ie, .while.
+#doc=src/preproc/soelim/soelim.1
+#echo "testing pic(1)-using man(7) page $doc" >&2
+#"$grog" "$doc" | \
+#    grep -Fqx 'groff -p -man '"$doc"
+
+doc=tmac/groff_mdoc.7
+echo "testing tbl(1)-using mdoc(7) page $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -t -mdoc '"$doc"
+
+doc=$src/doc/meintro.me.in
+echo "testing me(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -me '"$doc"
+
+doc=$src/doc/meintro_fr.me.in
+echo "testing tbl(1)-using me(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -t -me '"$doc"
+
+doc=$src/doc/meref.me.in
+echo "testing me(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -me '"$doc"
+
+doc=$src/doc/grnexmpl.me
+echo "testing grn(1)- and eqn(1)-using me(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -e -g -me '"$doc"
+
+doc=$src/contrib/mm/examples/letter.mm
+echo "testing mm(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mm '"$doc"
+
+doc=$src/contrib/mom/examples/copyright-chapter.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/copyright-default.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/letter.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/mom-pdf.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/mon_premier_doc.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/sample_docs.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/mom/examples/slide-demo.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -e -p -t -mom '"$doc"
+
+doc=$src/contrib/mom/examples/typesetting.mom
+echo "testing mom(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -mom '"$doc"
+
+doc=$src/contrib/pdfmark/cover.ms
+echo "testing ms(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -ms '"$doc"
+
+doc=$src/contrib/pdfmark/pdfmark.ms
+echo "testing ms(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -ms '"$doc"
+
+doc=$src/doc/ms.ms
+echo "testing eqn(1)- and tbl(1)-using ms(7) document $doc" >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -e -t -ms '"$doc"
+
+doc=$src/doc/pic.ms
+echo "testing tbl(1)-, eqn(1)-, and pic(1)-using ms(7) document $doc" \
+    >&2
+"$grog" "$doc" | \
+    grep -Fqx 'groff -e -p -t -ms '"$doc"
+
+doc=$src/doc/webpage.ms
+echo "testing ms(7) document $doc" >&2
+# BUG: Should detect -mwww (and -mpspic?) too.
+"$grog" "$doc" | \
+    grep -Fqx 'groff -ms '"$doc"
+
+# Test manual specification of auxiliary macro packages.
+echo "testing ms(7) document $doc with '-m www' option" >&2
+"$grog" "$doc" -m www | \
+    grep -Fqx 'groff -ms -mwww '"$doc"
+
+echo "testing ms(7) document $doc with '-mwww' option" >&2
+"$grog" "$doc" -mwww | \
+    grep -Fqx 'groff -ms -mwww '"$doc"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/hpftodit/hpftodit.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/hpftodit/hpftodit.1.man Changed

@@ -1,18 +1,16 @@
-.TH HPFTODIT @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-hpftodit \- create font description files for use with groff \-Tlj4
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr hpftodit_C \n.C
-.cp 0
+.TH hpftodit @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+hpftodit \- create font description files for use with
+.I groff
+and
+.I grolj4
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1994-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1994-2020 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
@@ -30,55 +28,84 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_hpftodit_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY hpftodit
-.OP \-aqs
-.OP \-i n
+.RB  \-aqs 
+.RB  \-i\~\c
+.IR n 
 .I tfm-file
 .I map-file
-.I output-font
+.I font-description
 .YS
 .
+.
 .SY hpftodit
 .B \-d
 .I tfm-file
 .RI  map-file 
 .YS
 .
+.
 .SY hpftodit
 .B \-\-help
 .YS
 .
+.
 .SY hpftodit
 .B \-v
+.
 .SY hpftodit
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B hpftodit
-creates a font file for use with a Hewlett-Packard LaserJet\~\%4-series
-(or newer) printer with
-.BR "groff \-Tlj4" ,
+.I hpftodit
+creates a font description file for use with a Hewlett-Packard
+LaserJet\~4-\%series
+(or newer)
+printer with the
+.MR grolj4 @MAN1EXT@
+output driver of
+.MR groff @MAN1EXT@ ,
 using data from an HP tagged font metric (TFM) file.
 .
 .I tfm-file
-is the name of the TFM file for the font;
+is the name of the font's TFM file;
 Intellifont and TrueType TFM files are supported,
 but symbol set TFM files are not.
 .
 .I map-file
 is a file giving the
 .I groff
-names for characters in the font;
-this file should consist of a sequence of lines of the form:
+special character identifiers for glyphs in the font;
+this file should consist of a sequence of lines of the form
 .RS
 .EX
 .IR "m u c1 c2 " "\&.\|.\|.\& #" " comment" ""
@@ -86,74 +113,76 @@
 .RE
 where
 .I m
-is a decimal integer giving the MSL (Master Symbol List) number of the
-character,
+is a decimal integer giving the glyph's MSL
+(Master Symbol List)
+number,
 .I u
-is a hexadecimal integer giving the Unicode value of the character,
+is a hexadecimal integer giving its Unicode character code,
 and
 .IR c1 ,
 .IR c2 ", .\|.\|."
-are the
+are its
 .I groff
-names of the character
+glyph names
 (see
-.BR groff_char (7)
+.MR groff_char @MAN7EXT@
 for a list).
 .
-The values can be separated by any whitespace;
-the Unicode value must use uppercase digits A\^\en\^F,
-and must be without a leading
-.RB \oq 0x \cq,
-.RB \oq u \cq,
+The values can be separated by any number of spaces and/or tabs.
+.
+The Unicode value must use uppercase hexadecimal digits A\^\en\^F,
+and must lack a leading
+.RB \lq 0x \rq,
+.RB \lq u \rq,
 or
-.RB \oq U+ \cq.
+.RB \lq U+ \rq.
+.
 Unicode values corresponding to composite glyphs are decomposed;
-e.g.,
-.RB \oq u00C0 \cq
+that is
+.RB \lq u00C0 \rq
 becomes
-.RB \oq u0041_0300 \cq.
+.RB \lq u0041_0300 \rq.
 .
-The name for a glyph without a
+A glyph without a
 .I groff
-name may be given as
+special character identifier may be named
 .BI u XXXX
 if the glyph corresponds to a Unicode value,
 or as an unnamed glyph
-.RB \oq \-\-\- \cq.
+.RB \lq \-\-\- \rq.
 .
-If the given Unicode value is in the Private Use Area
+If the given Unicode value is in the Private Use Area (PUA)
 (0xE000\^\en\^0xF8FF),
 the glyph is included as an unnamed glyph.
 .
 Refer to
-.BR groff_diff (@MAN1EXT@)
+.MR groff_diff @MAN1EXT@
 for additional information about unnamed glyphs and how to access them.
 .
 .
-.LP
+.P
 Blank lines and lines beginning with
-.RB \oq # \cq
+.RB \lq # \rq
 are ignored.
 .
 A
-.RB \oq # \cq
+.RB \lq # \rq
 following one or more
 .I groff
 names begins a comment.
 .
 Because
-.RB \oq # \cq
+.RB \lq # \rq
 is a valid
 .I groff
 name,
 it must appear first in a list of
 .I groff
 names if a comment is included,
-e.g.,
+as in
 .
 .RS
 .EX
-.B
 3   0023   #   # number sign
 .EE
 .RE
@@ -162,82 +191,75 @@
 .
 .RS
 .EX
-.B
 3   0023   # sh   # number sign
 .EE
 .RE
 .
-rather than
+whereas in
 .
 .RS
 .EX
-.B
 3   0023   sh #   # number sign
 .EE
 .RE
 .
-which will treat the first
-.RB \oq # \cq
-as the beginning of the comment.
+the first
+.RB \lq # \rq
+is interpreted as the beginning of the comment.
 .
 .
-.LP
-The
+.P
+Output is written in
+.MR groff_font @MAN5EXT@
+format to
+.I font-description,
+a file named for the intended
 .I groff
-font file is written to the specified
-.IR output-font ;
+font name;
 if this operand is
-.RB \oq \- \cq,
-the font file is written to the standard output.
-.
-.
-.LP
-The
-.B \-s
-option should be given if the font is special
-(a font is \lqspecial\rq if
-.I groff
-should search it whenever a character is not found in the current font).
-.
-If the font is special,
-it should be listed in the
-.B fonts
-command in the DESC file;
-if it is not special,
-there is no need to list it,
-since
-.I groff
-can automatically mount it when it's first used.
+.RB \lq \- \rq,
+the font description is written to the standard output stream.
 .
 .
 .LP
 If the
 .B \-i
 option is used,
-.B hpftodit
+.I hpftodit
 automatically will generate an italic correction,
-a left italic correction and a subscript correction
-for each character
+a left italic correction,
+and a subscript correction for each glyph
 (the significance of these parameters is explained in
-.BR groff_font (@MAN5EXT@)).
+.MR groff_font @MAN5EXT@ ).
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
+.
 .TP
 .B \-a
-Include characters in the TFM file that are not included in
+Include glyphs in the TFM file that are not included in
 .IR map-file .
 .
 A glyph with corresponding Unicode value is given the name
 .RI u XXXX ;
 a glyph without a Unicode value is included as an unnamed glyph
-\oq\-\^\-\^\-\cq.
+\lq\-\^\-\^\-\rq.
 .
 A glyph with a Unicode value in the Private Use Area
-(0xE000\^\en\^0xF8FF) also is included as an unnamed glyph.
+(0xE000\^\en\^0xF8FF)
+is also included as an unnamed glyph.
 .
 .
 .IP
@@ -249,13 +271,9 @@
 The presence or absence of the
 .B \-s
 option has some effect on which glyphs are included:
-without the
-.B \-s
-option,
+without it,
 only the \lqtext\rq symbol sets are searched for matching glyphs;
-with the
-.B \-s
-option,
+with it,
 only the \lqmathematical\rq symbol sets are searched.
 .
 Nonetheless,
@@ -263,23 +281,22 @@
 glyphs are placed in both regular and special fonts.
 .
 Normally,
-the
 .B \-a
-option should be used only as a last resort.
+should be used only as a last resort.
 .
 .
 .TP
 .B \-d
-Dump information about the TFM file to the standard output;
-this option can be useful for ensuring that a TFM file is a proper match
-for a font,
-and that the contents of the TFM file are suitable.
+Dump information about the TFM file to the standard output stream;
+use this to ensure that a TFM file is a proper match for a font,
+and that its contents are suitable.
 .
-The information includes the values of important TFM tags,
-and a listing (by MSL number for Intellifont TFM files or by Unicode
-value for TrueType TFM files) of the glyphs included in the TFM file.
+The information includes the values of important TFM tags and a listing
+(by MSL number for Intellifont TFM files or by Unicode value for
+TrueType TFM files)
+of the glyphs included in the TFM file.
 .
-The unit of measure \oqDU\cq for some tags indicates design units;
+The unit of measure \lqDU\rq for some tags indicates design units;
 there are 8782\~design units per em for Intellifont fonts,
 and 2048\~design units per em for TrueType fonts.
 .
@@ -287,6 +304,7 @@
 symbol set;
 some TFM files list many glyphs but only a few symbol sets.
 .
+.
 .IP
 The glyph listing includes the glyph index within the TFM file,
 the MSL or Unicode value,
@@ -303,6 +321,7 @@
 the glyph does not appear in any supported symbol set and cannot be
 printed.
 .
+.
 .IP
 With the
 .B \-d
@@ -313,116 +332,145 @@
 .I output-font
 is ignored if given.
 .
-.TP
-.B \-q
-Suppress warnings about characters in the map file that were not found
-in the TFM file.
-.
-Warnings never are given for unnamed glyphs or by glyphs named by their
-Unicode values.
-.
-This option is useful when sending the output of
-.B hpftodit
-to the standard output.
-.
-.TP
-.B \-v
-Print the
-.B hpftodit
-version number and exit.
 .
 .TP
-.B \-s
-The font is special.
-.
-This option adds the
-.B special
-command to the font file,
-and affects the order in which HP symbol sets are searched for each
-glyph.
-.
-Without the
-.B \-s
-option,
-the \lqtext\rq sets are searched before the \lqmathematical\rq
-symbol sets.
-With the
-.B \-s
-option,
-the search order is reversed.
-.
-.TP
-.BI \-i n
-Generate an italic correction for each character so that the character's
-width plus the character's italic correction is equal to
+.BI \-i\~ n
+Generate an italic correction for each glyph so that its width plus its
+italic correction is equal to
 .I n
 thousandths of an em plus the amount by which the right edge of the
-character's bounding is to the right of the character's origin.
+glyphs's bounding box is to the right of its origin.
 .
-If this would result in a negative italic correction,
+If a negative italic correction would result,
 use a zero italic correction instead.
 .
+.
 .IP
 Also generate a subscript correction equal to the product of the tangent
 of the slant of the font and four fifths of the x-height of the font.
 .
-If this would result in a subscript correction greater than the italic
-correction,
+If a subscript correction greater than the italic correction would
+result,
 use a subscript correction equal to the italic correction instead.
 .
+.
 .IP
-Also generate a left italic correction for each character equal to
+Also generate a left italic correction for each glyph equal to
 .I n
 thousandths of an em plus the amount by which the left edge of the
-character's bounding box is to the left of the character's origin.
+glyphs's bounding box is to the left of its origin.
 .
 The left italic correction may be negative.
 .
+.
 .IP
 This option normally is needed only with italic or oblique fonts;
-a value of 50 (0.05\~em) usually is a reasonable choice.
+a value of 50
+(0.05\~em)
+usually is a reasonable choice.
+.
+.
+.TP
+.B \-q
+Suppress warnings about glyphs in the map file that were not found in
+the TFM file.
+.
+Warnings never are given for unnamed glyphs or by glyphs named by their
+Unicode values.
+.
+This option is useful when sending the output of
+.I hpftodit
+to the standard output stream.
+.
+.
+.TP
+.B \-s
+Add the
+.B special
+directive to the font description file,
+affecting the order in which HP symbol sets are searched for each glyph.
+.
+Without this option,
+the \lqtext\rq sets are searched before the \lqmathematical\rq
+symbol sets.
+.
+With it,
+the search order is reversed.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/\:devlj4/\:DESC
-device description file
+.I @FONTDIR@/\:\%devlj4/\:DESC
+describes the
+.B lj4
+output device.
 .
 .
 .TP
-.IR @FONTDIR@/\:devlj4/\: F
-Font description file for font
-.I F
+.IR @FONTDIR@/\:\%devlj4/ F
+describes the font known
+.RI as\~ F
+on device
+.BR lj4 .
 .
 .
 .TP
-.IR @FONTDIR@/\:devlj4/\:generate/\: * .map
-symbol mapping files
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:\%Makefile
+is a
+.MR make 1
+script that uses
+.MR hpftodit @MAN1EXT@
+to prepare the
+.I groff
+font description files above from HP TFM data;
+in can be used to regenerate them in the event the TFM files are
+updated.
 .
 .
-.\" ====================================================================
-.SH "SEE ALSO"
-.\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR groff_diff (@MAN1EXT@),
-.BR grolj4 (@MAN1EXT@),
-.BR groff_font (@MAN5EXT@),
-.BR lj4_font (@MAN5EXT@)
+.TP
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:\%special\:.awk
+is an
+.MR awk 1
+script that corrects the Intellifont-based height metrics for several
+glyphs in the
+.B S
+(special) font for TrueType CG Times used in the HP LaserJet\~4000 and
+later.
 .
 .
-.\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \nhpftodit_C
+.TP
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:\%special\:.map
+.TQ
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:\%symbol\:.map
+.TQ
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:text\:.map
+.TQ
+.I @FONTDIR@/\:\%devlj4/\:\%generate/\:\%wingdings.map
+map MSL indices and HP Unicode PUA assignments to
+.I groff
+special character identifiers.
 .
 .
 .\" ====================================================================
-.\" Editor settings
+.SH "See also"
 .\" ====================================================================
 .
+.MR groff @MAN1EXT@ ,
+.MR groff_diff @MAN1EXT@ ,
+.MR grolj4 @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_hpftodit_1_man_C
+.do rr *groff_hpftodit_1_man_C
+.
+.
 .\" Local Variables:
-.\" mode: nroff
 .\" fill-column: 72
+.\" mode: nroff
 .\" End:
 .\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/hpftodit/hpftodit.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/hpftodit/hpftodit.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/hpftodit/hpftodit.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/hpftodit/hpftodit.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1994-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1994-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -26,13 +25,14 @@
 
 #include "lib.h"
 
+#include <assert.h>
+#include <ctype.h>
+#include <errno.h>
+#include <math.h>
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
-#include <ctype.h>
-#include <math.h>
-#include <errno.h>
-#include "assert.h"
+
 #include "posix.h"
 #include "errarg.h"
 #include "error.h"
@@ -179,7 +179,7 @@
   char *name;
   name_list *next;
   name_list(const char *s, name_list *p) : name(strsave(s)), next(p) { }
-  ~name_list() { a_delete name; }
+  ~name_list() { delete name; }
 };
 
 struct symbol_set {
@@ -385,9 +385,11 @@
 usage(FILE *stream)
 {
   fprintf(stream,
-	  "usage: %s -s -a -q -i n tfm_file map_file output_font\n"
-	  "       %s -d tfm_file map_file\n",
-	  program_name, program_name);
+"usage: %s -aqs -i n tfm-file map-file output-font\n"
+"usage: %s -d tfm-file map-file\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name, program_name);
 }
 
 static void
@@ -574,7 +576,7 @@
     ;
   *(p + 1) = '\0';
   printf("# %s\n", font_name);
-  delete font_name;
+  delete font_name;
 }
 
 static void
@@ -1256,17 +1258,19 @@
 static char *
 show_symset(unsigned int symset)
 {
-   static char symset_str8;
-
-   sprintf(symset_str, "%d%c", symset / 32, (symset & 31) + 64);
-   return symset_str;
+  // A 64-bit unsigned int produces up to 20 decimal digits.
+  assert(sizeof(unsigned int) <= 8);
+  static char symset_str22; // 20 digits + symset char + \0
+  sprintf(symset_str, "%u%c", symset / 32, (symset & 31) + 64);
+  return symset_str;
 }
 
 static char *
 hp_msl_to_ucode_name(int msl)
 {
-  char codestr8;
-
+  // A 64-bit signed int produces up to 19 decimal digits plus a sign.
+  assert(sizeof(int) <= 8);
+  char codestr21; // 19 digits + possible sign + \0
   sprintf(codestr, "%d", msl);
   const char *ustr = hp_msl_to_unicode_code(codestr);
   if (ustr == NULL)
@@ -1285,15 +1289,17 @@
       ustr = uname_decomposed + 1;
   }
   char *value = new charstrlen(ustr) + 1;
-  sprintf(value, equal(ustr, UNNAMED) ? ustr : "u%s", ustr);
+  sprintf(value, equal(ustr, UNNAMED) ? UNNAMED : "u%s", ustr);
   return value;
 }
 
 static char *
 unicode_to_ucode_name(int ucode)
 {
+  // A 64-bit signed int produces up to 16 hexadecimal digits.
+  assert(sizeof(int) <= 8);
   const char *ustr;
-  char codestr8;
+  char codestr17; // 16 hex digits + \0
 
   // don't allow PUA code points as Unicode names
   if (ucode >= 0xE000 && ucode <= 0xF8FF)
@@ -1309,7 +1315,7 @@
       ustr = uname_decomposed + 1;
   }
   char *value = new charstrlen(ustr) + 1;
-  sprintf(value, equal(ustr, UNNAMED) ? ustr : "u%s", ustr);
+  sprintf(value, equal(ustr, UNNAMED) ? UNNAMED : "u%s", ustr);
   return value;
 }
 
@@ -1416,7 +1422,7 @@
       charcode_name_table = new name_list *charcode_name_table_size;
       if (old_table) {
 	memcpy(charcode_name_table, old_table, old_size*sizeof(name_list *));
-	a_delete old_table;
+	delete old_table;
       }
       for (size_t i = old_size; i < charcode_name_table_size; i++)
 	charcode_name_tablei = NULL;
@@ -1451,3 +1457,9 @@
     }
   return b ? b + 1 : s;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/hpftodit/hpuni.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/hpftodit/hpuni.cpp Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/indxbib/indxbib.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/indxbib/indxbib.1.man Changed

@@ -1,5 +1,5 @@
-.TH @G@INDXBIB @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
+.TH @g@indxbib @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
 @g@indxbib \- make inverted index for bibliographic databases
 .
 .
@@ -7,7 +7,7 @@
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,69 +25,107 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_indxbib_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@indxbib
-.OP \-w
-.OP \-c file
-.OP \-d dir
-.OP \-f file
-.OP \-h n
-.OP \-i string
-.OP \-k n
-.OP \-l n
-.OP \-n n
-.OP \-o file
-.OP \-t n
-.RI  filename
-\&.\|.\|.\&
+.RB  \-w 
+.RB  \-c\~\c
+.IR \%common-words-file 
+.RB  \-d\~\c
+.IR dir 
+.RB  \-f\~\c
+.IR \%list-file 
+.RB  \-h\~\c
+.IR \%min-hash-table-size 
+.RB  \-i\~\c
+.IR \%excluded-fields 
+.RB  \-k\~\c
+.IR \%max-keys-per-record 
+.RB  \-l\~\c
+.IR \%min-key-length 
+.RB  \-n\~\c
+.IR \%threshold 
+.RB  \-o\~\c
+.IR file 
+.RB  \-t\~\c
+.IR \%max-key-length 
+.RI  file\~ .\|.\|.
 .YS
 .
+.
 .SY @g@indxbib
 .B \-\-help
 .YS
 .
+.
 .SY @g@indxbib
 .B \-v
+.
 .SY @g@indxbib
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B @g@indxbib
-makes an inverted index for the bibliographic databases in
-.IR filename \|.\|.\|.
+.I @g@indxbib
+makes an inverted index for the bibliographic databases in each
+.I file
 for use with
-.BR @g@refer (@MAN1EXT@),
-.BR @g@lookbib (@MAN1EXT@),
+.MR @g@refer @MAN1EXT@ ,
+.MR @g@lookbib @MAN1EXT@ ,
 and
-.BR lkbib (@MAN1EXT@).
+.MR lkbib @MAN1EXT@ .
 .
-The index will be named
-.RI filename @INDEX_SUFFIX@ ;
-the index is written to a temporary file which is then renamed to
-this.
+Each created index is named
+.RI file @INDEX_SUFFIX@ ;
+writing is done to a temporary file which is then renamed to this.
 .
-If no filenames are given on the command line because the
+If no
+.I file
+operands are given on the command line because the
 .B \-f
-option has been used, and no
+option has been used,
+and no
 .B \-o
-option is given, the index will be named
-.IR @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@ .
+option is given,
+the index will be named
+.IR \%@DEFAULT_INDEX_NAME@@INDEX_SUFFIX@ .
 .
 .
 .LP
 Bibliographic databases are divided into records by blank lines.
-Within a record, each fields starts with a
+.
+Within a record,
+each field starts with a
 .B %
 character at the beginning of a line.
 .
-Fields have a one letter name which follows the
+Fields have a one letter name that follows the
 .B %
 character.
 .
@@ -95,12 +133,13 @@
 .LP
 The values set by the
 .BR \-c ,
-.BR \-n ,
 .BR \-l ,
+.BR \-n ,
 and
 .B \-t
-options are stored in the index;
-when the index is searched, keys will be discarded and truncated in a
+options are stored in the index:
+when the index is searched,
+keys will be discarded and truncated in a
 manner appropriate to these options;
 the original keys will be used for verifying that any record
 found using the index actually contains the keys.
@@ -119,158 +158,190 @@
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
+.B \-\-help
+displays a usage message,
+while
 .B \-v
-Print the version number.
-.
-.TP
-.B \-w
-Index whole files.
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
-Each file is a separate record.
 .
 .TP
-.BI \-c file
+.BI \-c\~ common-words-file
 Read the list of common words from
-.I file
+.I common-words-file
 instead of
-.IR @COMMON_WORDS_FILE@ .
+.IR \%@COMMON_WORDS_FILE@ .
+.
 .
 .TP
-.BI \-d dir
+.BI \-d\~ dir
 Use
 .I dir
-as the pathname of the current working directory to store in the index,
-instead of the path printed by
-.BR pwd (1).
+as the name of the directory to store in the index,
+instead of that returned by
+.MR getcwd 2 .
 .
-Usually
+Typically,
 .I dir
-will be a symbolic link that points to the directory printed by
-.BR pwd (1).
+will be a symbolic link whose target is the current working directory.
+.
 .
 .TP
-.BI \-f file
+.BI \-f\~ list-file
 Read the files to be indexed from
-.IR file .
+.IR list-file .
 .
 If
-.I file
+.I list-file
 is
 .BR \- ,
-files will be read from the standard input.
+files will be read from the standard input stream.
+.
 The
 .B \-f
 option can be given at most once.
 .
+.
 .TP
-.BI \-i string
-Don't index the contents of fields whose names are in
-.IR string .
+.BI \-h\~ min-hash-table-size
+Use the first prime number greater than or equal to
+the argument for the size of the hash table.
+.
+Larger values
+will usually make searching faster,
+but will make the index file larger
+and cause
+.I @g@indxbib
+to use more memory.
+.
+The default hash table size is 997.
 .
-Initially
-.I string
-is
-.BR XYZ .
 .
 .TP
-.BI \-h n
-Use the first prime greater than or equal to
-.I n
-for the size of the hash table.
+.BI \-i\~ excluded-fields
+Don't index the contents of fields whose names are in
+.IR excluded-fields .
 .
-Larger values of
-.I n
-will usually make searching faster,
-but will make the index larger
+Field names are one character each.
+.
+If this option is not present,
+.I @g@indxbib
+excludes fields
+.BR X ,
+.BR Y ,
 and
-.B @g@indxbib
-use more memory.
+.BR Z .
 .
-Initially
-.I n
-is 997.
 .
 .TP
-.BI \-k n
-Use at most
-.I n
-keys per input record.
+.BI \-k\~ max-keys-per-record
+Use no more keys per input record than specified in the argument.
+.
+If this option is not present,
+the maximum is 100.
 .
-Initially
-.I n
-is 100.
 .
 .TP
-.BI \-l n
-Discard keys that are shorter than
-.IR n .
+.BI \-l\~ min-key-length
+Discard any key whose length in characters is shorter than the value of
+the argument.
 .
-Initially
-.I n
+If this option is not present,
+the minimum key length
 is 3.
 .
+.
 .TP
-.BI \-n n
+.BI \-n\~ threshold
 Discard the
-.I n
-most common words.
+.I threshold
+most common words from the common words file.
+.
+If this option is not present,
+the 100 most common words are discarded.
 .
-Initially
-.I n
-is 100.
 .
 .TP
-.BI \-o basename
-The index should be named
+.BI \-o\~ basename
+Name the index
 .RI basename @INDEX_SUFFIX@ .
 .
+.
 .TP
-.BI \-t n
+.BI \-t\~ max-key-length
 Truncate keys to
-.IR n .
+.I max-key-length
+in characters.
+.
+If this option is not present,
+keys are truncated to 6 characters.
 .
-Initially
-.I n
-is 6.
+.
+.TP
+.B \-w
+Index whole files.
+.
+Each file is a separate record.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.RI filename @INDEX_SUFFIX@
-Index.
+.RI \%file @INDEX_SUFFIX@
+index for
+.I file
+.
 .
 .TP
-.I @DEFAULT_INDEX_NAME@@INDEX_SUFFIX@
-Default index name.
+.I \%@DEFAULT_INDEX_NAME@@INDEX_SUFFIX@
+default index name
+.
 .
 .TP
-.I @COMMON_WORDS_FILE@
-List of common words.
+.I \%@COMMON_WORDS_FILE@
+contains the list of common words.
+.
+The traditional name,
+.RI \lq eign \rq,
+is an abbreviation of \lqEnglish ignored word list\rq.
+.
 .
 .TP
-.IR indxbib XXXXXX
-Temporary file.
+.IR \%indxbib XXXXXX
+temporary file
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.BR @g@refer (@MAN1EXT@),
-.BR lkbib (@MAN1EXT@),
-.BR @g@lookbib (@MAN1EXT@)
+.
+\lqSome Applications of Inverted Indexes on the Unix System\rq,
+by M.\& E.\& Lesk,
+1978,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
+.
+.
+.LP
+.MR @g@refer @MAN1EXT@ ,
+.MR lkbib @MAN1EXT@ ,
+.MR @g@lookbib @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_indxbib_1_man_C
+.do rr *groff_indxbib_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/indxbib/indxbib.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/indxbib/indxbib.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/indxbib/indxbib.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/indxbib/indxbib.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,9 +18,9 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
 #include <assert.h>
 #include <errno.h>
+#include <stdlib.h>
 
 #include "posix.h"
 #include "errarg.h"
@@ -142,11 +141,17 @@
       foption = optarg;
       break;
     case 'h':
-      check_integer_arg('h', optarg, 1, &hash_table_size);
-      if (!is_prime(hash_table_size)) {
-	while (!is_prime(++hash_table_size))
-	  ;
-	warning("%1 not prime: using %2 instead", optarg, hash_table_size);
+      {
+	int requested_hash_table_size;
+	check_integer_arg('h', optarg, 1, &requested_hash_table_size);
+	hash_table_size = requested_hash_table_size;
+	if ((hash_table_size > 2) && (hash_table_size % 2) == 0)
+		hash_table_size++;
+	while (!is_prime(hash_table_size))
+	  hash_table_size += 2;
+	if (hash_table_size != requested_hash_table_size)
+	  warning("requested hash table size %1 is not prime: using %2"
+		  " instead", optarg, hash_table_size);
       }
       break;
     case 'i':
@@ -191,7 +196,7 @@
   if (!directory) {
     char *path = get_cwd();
     store_filename(path);
-    a_delete path;
+    delete path;
   }
   else
     store_filename(directory);
@@ -215,7 +220,7 @@
     char *dir = strsave(base_name);
     dirp - base_name = '\0';
     name_max = file_name_max(dir);
-    a_delete dir;
+    delete dir;
   }
   else
     name_max = file_name_max(".");
@@ -289,7 +294,7 @@
 #endif /* __EMX__ */
   if (rename(temp_index_file, index_file) < 0) {
 #ifdef __MSDOS__
-    // RENAME could fail on plain MSDOS filesystems because
+    // RENAME could fail on plain MS-DOS filesystems because
     // INDEX_FILE is an invalid filename, e.g. it has multiple dots.
     char *fname = p ? index_file + (p - base_name) : 0;
     char *dot = 0;
@@ -321,9 +326,13 @@
 static void usage(FILE *stream)
 {
   fprintf(stream,
-"usage: %s -vw -c file -d dir -f file -h n -i XYZ -k n\n"
-"       -l n -n n -o base -t n files...\n",
-	  program_name);
+"usage: %s -w -c common-words-file -d dir -f list-file"
+" -h min-hash-table-size -i excluded-fields"
+" -k max-keys-per-record -l min-key-length"
+" -n threshold -o file -t max-key-length file ...\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 static void check_integer_arg(char opt, const char *arg, int min, int *res)
@@ -354,7 +363,7 @@
       break;
     if (errno != ERANGE)
       fatal("cannot get current working directory: %1", strerror(errno));
-    a_delete buf;
+    delete buf;
     if (size == INT_MAX)
       fatal("current working directory longer than INT_MAX");
     if (size > INT_MAX/2)
@@ -786,3 +795,9 @@
 }
 
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/indxbib/signal.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/indxbib/signal.c Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lkbib/lkbib.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lkbib/lkbib.1.man Changed

@@ -1,5 +1,5 @@
-.TH LKBIB @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
+.TH lkbib @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
 lkbib \- search bibliographic databases
 .
 .
@@ -7,7 +7,7 @@
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,43 +25,75 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_lkbib_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY lkbib
-.OP \-n
-.OP \-i fields
-.OP \-p filename
-.OP \-t n
-.I key
+.RB  \-n 
+.RB  \-i\~\c
+.IR fields 
+.RB  \-p\~\c
+.IR file 
 \&.\|.\|.\&
+.RB  \-t\~\c
+.IR n 
+.I key
+\&.\|.\|.
 .YS
 .
+.
 .SY lkbib
 .B \-\-help
 .YS
 .
+.
 .SY lkbib
 .B \-v
+.
 .SY lkbib
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.I lkbib
-searches bibliographic databases for references that contain the keys
+.I \%lkbib
+searches bibliographic databases for references containing keywords
 .I key
-\&.\|.\|.\& and prints any references found on the standard output.
+and writes any references found to the standard output
+stream.
 .
-.I lkbib
-will search any databases given by
+It reads databases given by
 .B \-p
-options, and then a default database.
+options
+and then
+(unless
+.B \-n
+is given)
+a default database.
 .
 The default database is taken from the
 .I \%REFER
@@ -70,39 +102,47 @@
 .IR @DEFAULT_INDEX@ .
 .
 For each database
-.I filename
+.I file
 to be searched,
 if an index
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
-.IR @g@indxbib (@MAN1EXT@)
-exists, then it will be searched instead;
+.MR @g@indxbib @MAN1EXT@
+exists,
+then it will be searched instead;
 each index can cover multiple databases.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
 .B \-\-help
-Display a usage message and exit.
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
-.BI \-i string
+.BI \-i\~ string
 When searching files for which no index exists,
 ignore the contents of fields whose names are in
 .IR string .
 .
 .
 .TP
-.BI \-p filename
+.B \-n
+Suppress search of default database.
+.
+.
+.TP
+.BI \-p\~ file
 Search
-.IR filename .
+.IR file .
 .
 Multiple
 .B \-p
@@ -110,25 +150,17 @@
 .
 .
 .TP
-.BI \-t n
-Only require the first
+.BI \-t\~ n
+Require only the first
 .I n
 characters of keys to be given.
 .
-Initially
-.I n
+The default
 is\~6.
 .
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
-.
-.
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Environment
 .\" ====================================================================
 .
 .TP
@@ -137,30 +169,44 @@
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @DEFAULT_INDEX@
+.I \%@DEFAULT_INDEX@
 Default database to be used if the
 .I \%REFER
 environment variable is not set.
 .
 .
 .TP
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 Index files.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.IR @g@refer (@MAN1EXT@),
-.IR @g@lookbib (@MAN1EXT@),
-.IR @g@indxbib (@MAN1EXT@)
+.
+\lqSome Applications of Inverted Indexes on the Unix System\rq,
+by M.\& E.\& Lesk,
+1978,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
+.
+.
+.LP
+.MR @g@refer @MAN1EXT@ ,
+.MR @g@lookbib @MAN1EXT@ ,
+.MR @g@indxbib @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_lkbib_1_man_C
+.do rr *groff_lkbib_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lkbib/lkbib.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lkbib/lkbib.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lkbib/lkbib.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lkbib/lkbib.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,9 +18,9 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
-#include <errno.h>
 #include <assert.h>
+#include <errno.h>
+#include <stdlib.h>
 
 #include "errarg.h"
 #include "error.h"
@@ -34,8 +33,11 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -nv -p database -i XYZ -t N keys ...\n",
-	  program_name);
+  fprintf(stream,
+          "usage: %s -n -p database -i XYZ -t N key ...\n"
+          "usage: %s {-v | --version}\n"
+          "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 int main(int argc, char **argv)
@@ -55,7 +57,7 @@
 	 != EOF)
     switch (opt) {
     case 'V':
-      verify_flag = 1;
+      do_verify = true;
       break;
     case 'n':
       search_default = 0;
@@ -134,3 +136,9 @@
   }
   return !count;
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lookbib/lookbib.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lookbib/lookbib.1.man Changed

@@ -1,5 +1,5 @@
-.TH @G@LOOKBIB @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
+.TH @g@lookbib @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
 @g@lookbib \- search bibliographic databases
 .
 .
@@ -7,7 +7,7 @@
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,107 +25,142 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_lookbib_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY @g@lookbib
-.OP \-i string
-.OP \-t n
-.I filename
+.RB  \-i\~\c
+.IR string 
+.RB  \-t\~\c
+.IR n 
+.I file
 \&.\|.\|.\&
 .YS
 .
+.
 .SY @g@lookbib
 .B \-\-help
 .YS
 .
+.
 .SY @g@lookbib
 .B \-v
+.
 .SY @g@lookbib
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I @g@lookbib
-prints a prompt on the standard error (unless the standard input is not
+writes a prompt to the standard error stream
+(unless the standard input stream is not
 a terminal),
 reads from the standard input a line containing a set of keywords,
-searches the bibliographic databases
-.I filename
-\&.\|.\|.\& for references containing those keywords,
-prints any references found on the standard output,
+searches each bibliographic database
+.I file
+for references containing those keywords,
+writes any references found to the standard output stream,
 and repeats this process until the end of input.
 .
 For each database
-.I filename
+.I file
 to be searched,
 if an index
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 created by
-.IR @g@indxbib (@MAN1EXT@)
-exists, then it will be searched instead;
+.MR @g@indxbib @MAN1EXT@
+exists,
+then it will be searched instead;
 each index can cover multiple databases.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
 .B \-\-help
-Display a usage message and exit.
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
-.BI \-i string
+.BI \-i\~ string
 When searching files for which no index exists,
 ignore the contents of fields whose names are in
 .IR string .
 .
 .
 .TP
-.BI \-t n
-Only require the first
+.BI \-t\~ n
+Require only the first
 .I n
 characters of keys to be given.
-Initially
-.I n
-is\~6.
-.
 .
-.TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
+The default
+is\~6.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.RI filename @INDEX_SUFFIX@
+.RI file @INDEX_SUFFIX@
 Index files.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.IR @g@refer (@MAN1EXT@),
-.IR lkbib (@MAN1EXT@),
-.IR @g@indxbib (@MAN1EXT@)
 .
+\lqSome Applications of Inverted Indexes on the Unix System\rq,
+by M.\& E.\& Lesk,
+1978,
+AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
+.
+.
+.LP
+.MR @g@refer @MAN1EXT@ ,
+.MR lkbib @MAN1EXT@ ,
+.MR @g@indxbib @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_lookbib_1_man_C
+.do rr *groff_lookbib_1_man_C
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lookbib/lookbib.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lookbib/lookbib.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/lookbib/lookbib.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/lookbib/lookbib.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -19,9 +18,9 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
 #include <assert.h>
 #include <errno.h>
+#include <stdlib.h>
 
 #include "errarg.h"
 #include "error.h"
@@ -38,8 +37,11 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -v -i XYZ -t N database ...\n",
-	  program_name);
+  fprintf(stream,
+	  "usage: %s -i XYZ -t N database ...\n"
+	  "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 int main(int argc, char **argv)
@@ -56,7 +58,7 @@
   while ((opt = getopt_long(argc, argv, "vVi:t:", long_options, NULL)) != EOF)
     switch (opt) {
     case 'V':
-      verify_flag = 1;
+      do_verify = true;
       break;
     case 'i':
       linear_ignore_fields = optarg;
@@ -137,3 +139,8 @@
   return 0;
 }
 
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/pfbtops/pfbtops.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/pfbtops/pfbtops.1.man Changed

@@ -1,13 +1,14 @@
-.TH PFBTOPS @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-pfbtops \- translate Printer Font Binary files to PostScript ASCII
+.TH pfbtops @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+pfbtops \- translate PostScript Printer Font Binary files to Printer
+Font ASCII
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,74 +26,104 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_pfbtops_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY pfbtops
 .RI  pfb-file 
 .YS
 .
+.
 .SY pfbtops
 .B \-\-help
 .YS
 .
+.
 .SY pfbtops
 .B \-v
+.
 .SY pfbtops
 .B \-\-version
 .YS
 .
+.
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I pfbtops
-translates a PostScript font in Printer Font Binary (PFB) format to
-ASCII, splitting overlong lines in text packets into smaller chunks.
+translates a PostScript Type\~1 font in Printer Font Binary (PFB) format
+to Printer Font ASCII (PFA) format,
+splitting overlong lines in text packets into smaller chunks.
 .
 If
 .I pfb-file
-is omitted, the PFB file will be read from the standard input.
+is omitted,
+the PFB file will be read from the standard input stream.
 .
-The ASCII format PostScript font will be written on the standard output.
+The PFA font will be written on the standard output stream.
 .
-PostScript fonts for MS-DOS are normally supplied in PFB format.
+PostScript fonts for MS-DOS were historically supplied in PFB format.
 .
-.
-.LP
-The resulting ASCII format PostScript font can be used with groff,
-if it is first listed in
-.I @FONTDIR@/\:devps/\:download
-and
-.IR @FONTDIR@/\:devpdf/\:download .
+Use of a PostScript Type\~1 font with
+.I groff
+requires conversion of its metrics
+(AFM file)
+to a
+.I groff
+font description file;
+see
+.MR afmtodit @MAN1EXT@ .
 .
 .
-.\" ====================================================================
-.SH OPTIONS
-.\" ====================================================================
-.
-.TP
+.P
+The
 .B \-\-help
-Display a usage message and exit.
-.
-.
-.TP
+option displays a usage message,
+while
 .B \-v
-.TQ
+and
 .B \-\-version
-Display version information and exit.
+show version information;
+all exit afterward.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.IR grops (@MAN1EXT@),
-.IR gropdf (@MAN1EXT@)
+.MR grops @MAN1EXT@ ,
+.MR gropdf @MAN1EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_pfbtops_1_man_C
+.do rr *groff_pfbtops_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/pfbtops/pfbtops.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/pfbtops/pfbtops.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/pfbtops/pfbtops.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/pfbtops/pfbtops.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1992-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1992-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -24,8 +24,10 @@
 
 #define __GETOPT_PREFIX groff_
 
+#include <errno.h> // errno
 #include <stdio.h>
-#include <stdlib.h>
+#include <stdlib.h> // exit(), EXIT_FAILURE, EXIT_SUCCESS
+#include <string.h> // strerror()
 #include <limits.h>
 
 #include <getopt.h>
@@ -43,13 +45,16 @@
 
 static void error(const char *s)
 {
-  fprintf(stderr, "%s: %s\n", program_name, s);
-  exit(2);
+  fprintf(stderr, "%s: error: %s\n", program_name, s);
+  exit(EXIT_FAILURE);
 }
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -v pfb_file\n", program_name);
+  fprintf(stream, "usage: %s pfb-file\n"
+	  "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 static void get_text(int n)
@@ -178,26 +183,28 @@
     switch (opt) {
     case 'v':
       printf("GNU pfbtops (groff) version %s\n", Version_string);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case CHAR_MAX + 1: /* --help */
       usage(stdout);
-      exit(0);
+      exit(EXIT_SUCCESS);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      exit(2);
       break;
     }
   }
 
   if (argc - optind > 1) {
     usage(stderr);
-    exit(1);
+    exit(2);
   }
-  if (argc > optind && !freopen(argvoptind, "r", stdin)) {
-    perror(argvoptind);
-    exit(1);
+  const char *file = argvoptind;
+  if (argc > optind && !freopen(file, "r", stdin)) {
+    fprintf(stderr, "%s: error: unable to open file '%s': %s\n",
+	    program_name, file, strerror(errno));
+    exit(EXIT_FAILURE);
   }
   SET_BINARY(fileno(stdin));
   for (;;) {
@@ -226,5 +233,11 @@
     else
       get_binary(n);
   }
-  exit(0);
+  exit(EXIT_SUCCESS);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/tfmtodit/tfmtodit.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/tfmtodit/tfmtodit.1.man Changed

@@ -1,13 +1,16 @@
-.TH TFMTODIT @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-tfmtodit \- create font files for use with groff \-Tdvi
+.TH tfmtodit @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+tfmtodit \- adapt TeX Font Metrics files for use with
+.I groff
+and
+.I grodvi
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2020 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
@@ -25,6 +28,26 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_tfmtodit_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
 .\" Definitions
 .\" ====================================================================
@@ -34,218 +57,359 @@
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY tfmtodit
-.OP \-s
-.OP \-g gf_file
-.OP \-k skewchar
-.I tfm_file
-.I map_file
-.I font
+.RB  \-s 
+.RB  \-g\~\c
+.IR gf-file 
+.RB  \-k\~\c
+.IR skew-char 
+.I tfm-file
+.I map-file
+.I font-description
 .YS
 .
+.
 .SY tfmtodit
 .B \-\-help
 .YS
 .
+.
 .SY tfmtodit
 .B \-v
+.
 .SY tfmtodit
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-.B tfmtodit
-creates a font file for use with
-.B
-groff \-Tdvi\fR.
+.I tfmtodit
+creates a font description file for use with
+.MR groff @MAN1EXT@ 's
+.B dvi
+output device.
 .
-.I tfm_file
+.I tfm-file
 is the name of the \*(tx font metric file for the font.
 .
-.I map_file
-is a file giving the groff names for characters in the font;
-this file should consist of a sequence of lines of the form:
-.IP
-.I
-n c1 c2 \fR.\|.\|.
+.I map-file
+assigns
+.I groff
+ordinary or special character identifiers to glyph indices in the font;
+it should consist of a sequence of lines of the form
 .
+.RS
+.IR "i c1" \~\&.\|.\|.\&\~ cn
+.RE
 .
-.LP
 where
-.I n
-is a decimal integer giving the position of the character in the font,
+.I i
+is a position of the glyph in the font in decimal,
 and
-.IR c1 ,
-.IR c2 ,.\|.\|.
-are the groff names of the character.
-.
-If a character has no groff names but exists in the tfm file,
-then it will be put in the groff font file as an unnamed character.
-.
-.I font
-is the name of the groff font file.
-.
-The groff font file is written to
-.IR font .
-.
-.
-.LP
-The
+.I c1
+through
+.I cn
+are glyph identifiers in the form used by
+.I groff
+font descriptions.
+.
+If a glyph has no
+.I groff
+names but exists in
+.I tfm-file,
+it is put in the
+.I groff
+font description file as an unnamed glyph.
+.
+Output is written in
+.MR groff_font @MAN5EXT@
+format to
+.I font-description,
+a file named for the intended
+.I groff
+font name.
+.
+.
+.P
+If the font is \lqspecial\rq,
+meaning that
+.I groff
+should search it whenever a glyph is not found in the current font,
+use the
 .B \-s
-option should be given if the font is special
-(a font is
-.I special
-if
-.B troff
-should search it whenever
-a character is not found in the current font.)
-.
-If the font is special,
-it should be listed in the
+option and name
+.I font-description
+in the
 .B fonts
-command in the DESC file;
-if it is not special, there is no need to list it, since
-.B troff
-can automatically mount it when it's first used.
+directive in the output device's
+.I DESC
+file.
 .
 .
-.LP
-To do a good job of math typesetting, groff requires font metric
-information not present in the tfm file.
+.P
+To do a good job of math typesetting,
+.I groff
+requires font metric information not present in
+.I tfm-file.
 .
-The reason for this is that \*(tx has separate math italic fonts
-whereas groff uses normal italic fonts for math.
+This is because \*(tx has separate math italic fonts,
+whereas
+.I groff
+uses normal italic fonts for math.
 .
-The additional information required by groff is given by the two
-arguments to the
+The additional information required by
+.I groff
+is given by the two arguments to the
 .B math_fit
 macro in the Metafont programs for the Computer Modern fonts.
 .
 In a text font (a font for which
-.B math_fitting
-is false), Metafont normally ignores these two arguments.
+.B math_fit
+is false),
+Metafont normally ignores these two arguments.
 .
-Metafont can be made to put this information in the gf file by loading
-the following definition after
+Metafont can be made to put this information into the GF
+(\lqgeneric font\rq)
+files it produces by loading the following definition after
 .B cmbase
 when creating
-.IR cm.base :
-.IP
-.nf
-.ft B
+.IR cm.base .
+.
+.RS
+.EX
 def ignore_math_fit(expr left_adjustment,right_adjustment) =
     special "adjustment";
     numspecial left_adjustment*16/designsize;
     numspecial right_adjustment*16/designsize;
     enddef;
-.fi
-.ft R
-.LP
-For the EC font family, load the following definition after
-.B exbase
-(it is probably easiest to patch
+.EE
+.RE
+.
+For the EC font family,
+load the following definition after
+.BR exbase ;
+consider patching
 .I exbase.mf
-locally):
-.IP
-.nf
-.ft B
+locally.
+.
+.RS
+.EX
 def ignore_math_fit(expr left_adjustment,right_adjustment) =
     ori_special "adjustment";
     ori_numspecial left_adjustment*16/designsize;
     ori_numspecial right_adjustment*16/designsize;
     enddef;
-.fi
-.ft R
-.LP
-The gf file created using this modified
+.EE
+.RE
+.
+The only difference from the previous example is the \lqori_\rq
+prefix to \lqspecial\rq and \lqnumspecial\rq.
+.
+The GF file created using this modified
 .I cm.base
 or
-.I exbase
+.I exbase.mf
 should be specified with the
 .B \-g
-option.
-.
-The
-.B \-g
-option should not be given for a font for which
-.B math_fitting
+option,
+which should
+.I not
+be given for a font for which
+.B math_fit
 is true.
 .
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
-.
-.
-.TP
+.B \-\-help
+displays a usage message,
+while
 .B \-v
-Print the version number.
+and
+.B \-\-version
+show version information;
+all exit afterward.
+.
 .
 .TP
-.B \-s
-The font is special.
+.BI \-g \~gf-file
+Use the
+.I gf-file
+produced by Metafont containing
+.RB \lq special \rq
+and
+.RB \lq numspecial \rq
+commands to obtain additional font metric information.
 .
-The effect of this option is to add the
-.B special
-command to the font file.
 .
 .TP
-.BI \-k n
-The skewchar of this font is at position
-.IR n .
+.BI \-k \~skew-char
+The skew character of this font is at position
+.I skew-char.
 .
-.I n
+.I skew-char
 should be an integer;
 it may be given in decimal,
-or with a leading
-.B 0
-in octal,
-or with a leading
-.B 0x
-in hexadecimal.
+with a leading 0 in octal,
+or with a leading 0x in hexadecimal.
+.
+Any kerns whose second component is
+.I skew-char
+are ignored.
 .
-The effect of this option is to ignore any kerns whose second
-component is the specified character.
 .
 .TP
-.BI \-g gf_file
-.I gf_file
-is a gf file produced by Metafont containing special and numspecial
-commands giving additional font metric information.
+.B \-s
+Add the
+.B special
+directive to the font description file.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I @FONTDIR@/devdvi/DESC
-Device description file.
+.I @FONTDIR@/\:\%devdvi/\:DESC
+describes the
+.B dvi
+output device.
+.
+.
+.TP
+.IR @FONTDIR@/\:\%devdvi/ F
+describes the font known
+.RI as\~ F
+on device
+.BR dvi .
+.
 .
 .TP
-.IR @FONTDIR@/devdvi/ F
-Font description file for font
-.IR F .
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%ec.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%msam.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%msbm.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%tc.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texb.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texex.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texi.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texitt.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texmi.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texr.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%texsy.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%textex.map
+.TQ
+.I @FONTDIR@/\:\%devdvi/\:\%generate/\:\%textt.map
+map glyph indices in \*tx fonts to
+.I groff
+ordinary and special character identifiers.
+.
+.I \%ec.map
+is used for
+.BR TREC ,
+.BR TIEC ,
+.BR TBEC ,
+.BR TBIEC ,
+.BR HREC ,
+.BR HIEC ,
+.BR HBEC ,
+.BR HBIEC ,
+.BR CWEC ,
+and
+.BR CWIEC ;
+.I \%msam.map
+for
+.BR SA ;
+.I \%msbm.map
+for
+.BR SB ;
+.I \%tc.map
+for
+.BR TRTC ,
+.BR TITC ,
+.BR TBTC ,
+.BR TBITC ,
+.BR HRTC ,
+.BR HITC ,
+.BR HBTC ,
+.BR HBITC ,
+.BR CWTC ,
+and
+.BR CWITC ;
+.I \%texb.map
+for
+.BR TB ,
+.BR HR ,
+.BR HI ,
+.BR HB ,
+and
+.BR HBI ;
+.I \%texex.map
+for
+.BR EX ;
+.I \%texi.map
+for
+.B TI
+and
+.BR TBI ;
+.I \%texitt.map
+for
+.BR CWI ;
+.I \%texmi.map
+for
+.BR MI ;
+.I \%texr.map
+for
+.BR TR ;
+.I \%texsy.map
+for
+.BR S ;
+.I \%textex.map
+for
+.BR SC ;
+and
+.I \%textt.map
+for
+.BR CW .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR grodvi (@MAN1EXT@),
-.BR groff_font (@MAN5EXT@)
+.
+.MR groff @MAN1EXT@ ,
+.MR grodvi @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@
+.
+.
+.\" Clean up.
+.rm tx
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_tfmtodit_1_man_C
+.do rr *groff_tfmtodit_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/tfmtodit/tfmtodit.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/tfmtodit/tfmtodit.am Changed

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/tfmtodit/tfmtodit.cpp -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/tfmtodit/tfmtodit.cpp Changed

@@ -1,5 +1,4 @@
-// -*- C++ -*-
-/* Copyright (C) 1989-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1989-2020 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -29,7 +28,8 @@
 are normally ignored by Metafont. We need to get hold of these two
 parameters and put them in the groff font file.
 
-We do this by loading this definition after cmbase when creating cm.base.
+We do this by loading this definition after cmbase when creating
+cm.base.
 
 def ignore_math_fit(expr left_adjustment,right_adjustment) =
  special "adjustment";
@@ -48,12 +48,13 @@
 
 #include "lib.h"
 
-#include <stdlib.h>
-#include <math.h>
+#include <assert.h>
 #include <errno.h>
+#include <math.h>
+#include <stdlib.h>
+
 #include "errarg.h"
 #include "error.h"
-#include "assert.h"
 #include "cset.h"
 #include "nonposix.h"
 
@@ -163,7 +164,7 @@
     }
   return 0;
 }
-	  
+
 tfm::tfm()
 : char_info(0), width(0), height(0), depth(0), italic(0), lig_kern(0),
   kern(0), param(0)
@@ -242,16 +243,16 @@
 
 tfm::~tfm()
 {
-  a_delete char_info;
-  a_delete width;
-  a_delete height;
-  a_delete depth;
-  a_delete italic;
-  a_delete lig_kern;
-  a_delete kern;
-  a_delete param;
+  delete char_info;
+  delete width;
+  delete height;
+  delete depth;
+  delete italic;
+  delete lig_kern;
+  delete kern;
+  delete param;
 }
-  
+
 int read2(unsigned char *&s)
 {
   int n;
@@ -270,7 +271,6 @@
   return n;
 }
 
-
 int tfm::load(const char *file)
 {
   errno = 0;
@@ -294,14 +294,14 @@
       error("unexpected end of file on '%1'", file);
     else
       error("error on file '%1'", file);
-    a_delete buf;
+    delete buf;
     fclose(fp);
     return 0;
   }
   fclose(fp);
   if (lf < 6) {
-    error("bad tfm file '%1': impossibly short", file);
-    a_delete buf;
+    error("bad TFM file '%1': impossibly short", file);
+    delete buf;
     return 0;
   }
   unsigned char *ptr = buf;
@@ -316,14 +316,15 @@
   nk = read2(ptr);
   int ne = read2(ptr);
   np = read2(ptr);
-  if (6 + lh + (ec - bc + 1) + nw + nh + nd + ni + nl + nk + ne + np != lf) {
-    error("bad tfm file '%1': lengths do not sum", file);
-    a_delete buf;
+  if ((6 + lh + (ec - bc + 1) + nw + nh + nd + ni + nl + nk + ne + np)
+      != lf) {
+    error("bad TFM file '%1': lengths do not sum", file);
+    delete buf;
     return 0;
   }
   if (lh < 2) {
-    error("bad tfm file '%1': header too short", file);
-    a_delete buf;
+    error("bad TFM file '%1': header too short", file);
+    delete buf;
     return 0;
   }
   char_info = new char_info_wordec - bc + 1;
@@ -368,7 +369,7 @@
   for (i = 0; i < np; i++)
     parami = read4(ptr);
   assert(ptr == buf + lf*4 - 2);
-  a_delete buf;
+  delete buf;
   return 1;
 }
 
@@ -592,7 +593,8 @@
   char_list(const char *, char_list * = 0);
 };
 
-char_list::char_list(const char *s, char_list *p) : ch(strsave(s)), next(p)
+char_list::char_list(const char *s, char_list *p) : ch(strsave(s)),
+		     next(p)
 {
 }
 
@@ -626,7 +628,7 @@
       return 0;
     }
     if (n < 0 || n > 255) {
-      error("%1:%2: code out of range", file, lineno);
+      error("%1:%2: code %3 out of range", file, lineno, n);
       fclose(fp);
       return 0;
     }
@@ -681,7 +683,7 @@
   };
 
 static void usage(FILE *stream);
-  
+
 int main(int argc, char **argv)
 {
   program_name = argv0;
@@ -694,7 +696,8 @@
     { "version", no_argument, 0, 'v' },
     { NULL, 0, 0, 0 }
   };
-  while ((opt = getopt_long(argc, argv, "svg:k:", long_options, NULL)) != EOF)
+  while ((opt = getopt_long(argc, argv, "svg:k:", long_options, NULL))
+	 != EOF)
     switch (opt) {
     case 'g':
       gf_file = optarg;
@@ -710,7 +713,7 @@
 	    || *ptr != '\0'
 	    || n < 0
 	    || n > UCHAR_MAX)
-	  error("invalid skewchar");
+	  error("invalid skew character position '%1'", optarg);
 	else
 	  skewchar = (int)n;
 	break;
@@ -730,9 +733,10 @@
       exit(1);
       break;
     case EOF:
-      assert(0);
+      assert(0 == "EOF encountered in option processing");
     }
   if (argc - optind != 3) {
+    error("insufficient arguments");
     usage(stderr);
     exit(1);
   }
@@ -752,7 +756,8 @@
     return 1;
   errno = 0;
   if (!freopen(font_file, "w", stdout)) {
-    error("can't open '%1' for writing: %2", font_file, strerror(errno));
+    error("can't open '%1' for writing: %2", font_file,
+	  strerror(errno));
     return 1;
   }
   printf("name %s\n", font_file);
@@ -762,8 +767,8 @@
   int len = strlen(internal_name);
   if (len > 4 && strcmp(internal_name + len - 4, ".tfm") == 0)
     internal_namelen - 4 = '\0';
-  // DIR_SEPS are possible directory separator characters, see nonposix.h.
-  // We want the rightmost separator of all possible ones.
+  // DIR_SEPS are possible directory separator characters, see
+  // nonposix.h.  We want the rightmost separator of all possible ones.
   // Example: d:/foo\\bar.
   const char *s = strrchr(internal_name, DIR_SEPS0), *s1;
   const char *sep = &DIR_SEPS1;
@@ -789,8 +794,10 @@
   // Print the list of ligatures.
   // First find the indices of each character that can participate in
   // a ligature.
+  size_t lig_char_entries = sizeof(lig_chars)/sizeof(lig_chars0);
+  size_t lig_table_entries = sizeof(lig_table)/sizeof(lig_table0);
   for (i = 0; i < 256; i++)
-    for (unsigned int j = 0; j < sizeof(lig_chars)/sizeof(lig_chars0); j++)
+    for (unsigned int j = 0; j < lig_char_entries; j++)
       for (char_list *p = tablei; p; p = p->next)
 	if (strcmp(lig_charsj.ch, p->ch) == 0)
 	  lig_charsj.i = i;
@@ -798,7 +805,7 @@
   // and it appears as a ligature in the tfm file, include in
   // the list of ligatures.
   int started = 0;
-  for (i = 0; i < sizeof(lig_table)/sizeof(lig_table0); i++) {
+  for (i = 0; i < lig_table_entries; i++) {
     int i1 = lig_charslig_tablei.c1.i;
     int i2 = lig_charslig_tablei.c2.i;
     int r = lig_charslig_tablei.res.i;
@@ -837,7 +844,7 @@
     }
   printf("charset\n");
   char_list unnamed("---");
-  for (i = 0; i < 256; i++) 
+  for (i = 0; i < 256; i++)
     if (t.contains(i)) {
       char_list *p = tablei ? tablei : &unnamed;
       int m6;
@@ -868,6 +875,15 @@
 
 static void usage(FILE *stream)
 {
-  fprintf(stream, "usage: %s -sv -g gf_file -k skewchar tfm_file map_file font\n",
-	  program_name);
+  fprintf(stream,
+"usage: %s -s -g gf-file -k skew-char tfm-file map-file font\n"
+"usage: %s {-v | --version}\n"
+"usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C++
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/xtotroff/xtotroff.1.man -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/xtotroff/xtotroff.1.man Changed

@@ -1,13 +1,15 @@
-.TH XTOTROFF @MAN1EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-xtotroff \- convert X font metrics into GNU troff font metrics
+.TH xtotroff @MAN1EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+xtotroff \- convert X font metrics into
+.I groff
+font metrics
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2004-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2004-2022 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
@@ -25,125 +27,211 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_xtotroff_1_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY xtotroff
-.OP \-r resolution
-.OP \-s point-size
+.RB  \-d\~\c
+.IR destination-directory 
+.RB  \-r\~\c
+.IR resolution 
+.RB  \-s\~\c
+.IR type-size 
 .I font-map
 .YS
 .
+.
 .SY xtotroff
 .B \-\-help
 .YS
 .
+.
 .SY xtotroff
 .B \-v
+.
 .SY xtotroff
 .B \-\-version
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
 .I xtotroff
-takes a
-.IR font-map ,
-which maps
-.IR groff (@MAN1EXT@)
-fonts to X11 fonts,
-creates GNU
-.IR troff (@MAN1EXT@)
-metric files for all fonts listed.
+uses
+.I font-map
+to create
+.MR groff @MAN1EXT@
+font description files from X11 fonts.
 .
 Each line in
 .I font-map
-consists of a
+consists of a series of lines of paired
 .I groff
-font name and an X font name as a X Logical Font Description (XLFD)
-pattern,
-separated by whitespace.
-.
-Example:
+font names and X font names as X Logical Font Description (XLFD)
+patterns,
+with the pair members separated by spaces and/or tabs.
 .
+For example,
+an input
+.I font-map
+file consisting of the line
 .
-.PP
 .RS
 .EX
 TB \-adobe\-times\-bold\-r\-normal\-\-*\-*\-*\-*\-p\-*\-iso8859\-1
 .EE
 .RE
 .
+maps the XLFD on the right to the
+.I groff
+font name
+.BR TB ,
+conventionally \lqTimes bold\rq.
+.
 .
 .PP
-The wildcards in the patterns are filled with the arguments to the
+.I xtotroff
+opens a connection to the running X server to query its font catalog,
+and aborts if it cannot.
+.
+If necessary,
+the wildcards in the XLFD patterns are populated with the arguments to
+the
 .B \-r
 and
 .B \-s
-switches.
+options.
 .
 If a font name is still ambiguous,
 .I xtotroff
 aborts.
 .
+For each successful mapping,
+.I xtotroff
+creates a
+.I groff
+font description file in the current working directory
+(or that specified by the
+.B -d
+option)
+named for each
+.I groff
+font,
+and reports the mapping to the standard output stream.
+.
 .
 .\" ====================================================================
-.SH OPTIONS
+.SH Options
 .\" ====================================================================
 .
-Whitespace is permitted between a command-line option and its argument.
+.B \-\-help
+displays a usage message,
+while
+.B \-v
+and
+.B \-\-version
+show version information;
+all exit afterward.
 .
 .
 .TP
-.B \-\-help
-Display a usage message and exit.
+.BI \-d\~ destination-directory
+Write font descriptions to
+.I destination-directory
+rather than the current working directory.
 .
 .
 .TP
-.BI \-r resolution
+.BI \-r\~ resolution
 Set the resolution for all font patterns in
 .IR font-map .
 .
-The value is used for both the horizontal and vertical resolution.
+The value is used for both the horizontal and vertical motion quanta.
 .
-If not specified, a resolution of 75dpi is assumed.
+If not specified,
+a resolution of 75dpi is assumed.
 .
 .
 .TP
-.BI \-s point-size
-Set the point size for all font patterns in
+.BI \-s\~ type-size
+Set the type size in points for all font patterns in
 .IR font-map .
 .
-If not specified, a size of 10pt is assumed.
+If not specified,
+a size of 10 points is assumed.
+.
 .
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
 .
 .TP
-.B \-v
-.TQ
-.B \-\-version
-Display version information and exit.
+.I @FONTDIR@/\:\%FontMap\-X11
+is the font mapping file used to produce the pre-generated font
+description files,
+supplied with
+.IR groff ,
+of X11 core fonts corresponding to the 13 base Type\~1 fonts for
+PostScript level 1.
 .
 .
 .\" ====================================================================
-.SH BUGS
+.SH Bugs
 .\" ====================================================================
-The only supported font encodings are \(lqiso8859\-1\(rq and
-\(lqadobe\-fontspecific\(rq.
+.
+The only supported font encodings are \lqiso8859\-1\rq and
+\%\lqadobe\-\:fontspecific\rq.
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.IR groff (@MAN1EXT@),
-.IR gxditview (@MAN1EXT@),
-.IR troff (@MAN1EXT@)
+.
+.UR https://\:www\:.x\:.org/\:releases/\:X11R7.6/\:doc/\:xorg\-docs/\
+\:specs/\:XLFD/xlfd\:.html
+\lqX Logical Font Description Conventions\rq
+.UE ,
+by Jim Flowers and Stephen Gildea.
+.
+.
+.PP
+.MR X 7 ,
+.MR groff @MAN1EXT@ ,
+.MR gxditview @MAN1EXT@ ,
+.MR troff @MAN1EXT@ ,
+.MR groff_font @MAN5EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_xtotroff_1_man_C
+.do rr *groff_xtotroff_1_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/xtotroff/xtotroff.am -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/xtotroff/xtotroff.am Changed

@@ -1,6 +1,4 @@
-# Copyright (C) 2014-2018 Free Software Foundation, Inc.
-#
-# Latest update: 22 Aug 2015
+# Copyright (C) 2014-2020 Free Software Foundation, Inc.
 #
 # This file is part of groff.
 #
@@ -17,9 +15,12 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
-if !WITHOUT_X11
+if WITHOUT_X11
+XTOTROFF_MAN1 =
+else
+XTOTROFF_MAN1 = src/utils/xtotroff/xtotroff.1
 bin_PROGRAMS += xtotroff
-man1_MANS += src/utils/xtotroff/xtotroff.1
+man1_MANS += $(XTOTROFF_MAN1)
 xtotroff_SOURCES = src/utils/xtotroff/xtotroff.c
 XLIBS=$(LIBXUTIL) $(LIBGROFF)
 xtotroff_LDADD = libxutil.a libgroff.a $(X_LIBS) $(X_PRE_LIBS) \
@@ -28,9 +29,13 @@
 endif
 EXTRA_DIST += src/utils/xtotroff/xtotroff.1.man
 
+# Define variable needed only for the targets that regenerate
+# descriptions of X11 core fonts (used in "maintainer mode").
+xtotroff=$(top_builddir)/xtotroff
+
 
-########################################################################
-### Emacs settings
 # Local Variables:
+# fill-column: 72
 # mode: makefile-automake
 # End:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/src/utils/xtotroff/xtotroff.c -> _service:tar_scm:groff-1.23.0.tar.gz/src/utils/xtotroff/xtotroff.c Changed

@@ -1,4 +1,4 @@
-/* Copyright (C) 1992-2018 Free Software Foundation, Inc.
+/* Copyright (C) 1992-2022 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -29,8 +29,10 @@
 #define __GETOPT_PREFIX groff_
 
 #include <X11/Xlib.h>
+#include <stdbool.h>
 #include <stdio.h>
 #include <ctype.h>
+#include <errno.h>
 #include <unistd.h>
 #include <stdlib.h>
 #include <string.h>
@@ -59,15 +61,16 @@
 Display *dpy;
 unsigned resolution = 75;
 unsigned point_size = 10;
+char *destdir = NULL;
 
-static int charExists(XFontStruct * fi, int c)
+static bool charExists(XFontStruct * fi, int c)
 {
   XCharStruct *p;
 
   /* 'c' is always >= 0 */
   if ((unsigned int) c < fi->min_char_or_byte2
       || (unsigned int) c > fi->max_char_or_byte2)
-    return 0;
+    return false;
   p = fi->per_char + (c - fi->min_char_or_byte2);
   return p->lbearing != 0 || p->rbearing != 0 || p->width != 0
 	 || p->ascent != 0 || p->descent != 0 || p->attributes != 0;
@@ -75,48 +78,57 @@
 
 /* Canonicalize the font name by replacing scalable parts by *s. */
 
-static int CanonicalizeFontName(char *font_name, char *canon_font_name)
+static bool CanonicalizeFontName(char *font_name, char *canon_font_name)
 {
   unsigned int attributes;
   XFontName parsed;
 
   if (!XParseFontName(font_name, &parsed, &attributes)) {
-    fprintf(stderr, "not a standard name: %s\n", font_name);
-    return 0;
+    fprintf(stderr, "%s: not a standard font name: \"%s\"\n",
+	    program_name, font_name);
+    return false;
   }
 
   attributes &= ~(FontNamePixelSize | FontNameAverageWidth
 		  | FontNamePointSize
 		  | FontNameResolutionX | FontNameResolutionY);
   XFormatFontName(&parsed, attributes, canon_font_name);
-  return 1;
+  return true;
 }
 
-static int
+static bool
 FontNamesAmbiguous(const char *font_name, char **names, int count)
 {
   char name12048, name22048;
   int i;
 
-  if (count == 1)
-    return 0;
+  if (1 == count)
+    return false;
 
   for (i = 0; i < count; i++) {
-    if (!CanonicalizeFontName(namesi, i == 0 ? name1 : name2)) {
-      fprintf(stderr, "bad font name: %s\n", namesi);
-      return 1;
+    if (!CanonicalizeFontName(namesi, 0 == i ? name1 : name2)) {
+      fprintf(stderr, "%s: invalid font name: \"%s\"\n", program_name,
+	      namesi);
+      return true;
     }
     if (i > 0 && strcmp(name1, name2) != 0) {
-      fprintf(stderr, "ambiguous font name: %s\n", font_name);
-      fprintf(stderr, "  matches %s\n", names0);
-      fprintf(stderr, "  and %s\n", namesi);
-      return 1;
+      fprintf(stderr, "%s: ambiguous font name: \"%s\"", program_name,
+	      font_name);
+      fprintf(stderr, " matches \"%s\"", names0);
+      fprintf(stderr, " and \"%s\"", namesi);
+      return true;
     }
   }
-  return 0;
+  return false;
 }
 
-static int MapFont(char *font_name, const char *troff_name)
+static void xtotroff_exit(int status)
+{
+  free(destdir);
+  exit(status);
+}
+
+static bool MapFont(char *font_name, const char *troff_name)
 {
   XFontStruct *fi;
   int count;
@@ -127,14 +139,17 @@
   XFontName parsed;
   int j, k;
   DviCharNameMap *char_map;
-  char encoding256;
+  /* 'encoding' needs to hold a CharSetRegistry (256), a CharSetEncoding
+     (256) both from XFontName.h, a dash, and a null terminator. */
+  char encoding256 * 2 + 1 + 1;
   char *s;
   int wid;
   char name_string2048;
 
   if (!XParseFontName(font_name, &parsed, &attributes)) {
-    fprintf(stderr, "not a standard name: %s\n", font_name);
-    return 0;
+    fprintf(stderr, "%s: not a standard font name: \"%s\"\n",
+	    program_name, font_name);
+    return false;
   }
 
   attributes &= ~(FontNamePixelSize | FontNameAverageWidth);
@@ -148,43 +163,64 @@
 
   names = XListFonts(dpy, name_string, 100000, &count);
   if (count < 1) {
-    fprintf(stderr, "bad font name: %s\n", font_name);
-    return 0;
+    fprintf(stderr, "%s: invalid font name: \"%s\"\n", program_name,
+	    font_name);
+    return false;
   }
 
   if (FontNamesAmbiguous(font_name, names, count))
-    return 0;
+    return false;
 
   XParseFontName(names0, &parsed, &attributes);
-  sprintf(encoding, "%s-%s", parsed.CharSetRegistry,
+  size_t sz = sizeof encoding;
+  snprintf(encoding, sz, "%s-%s", parsed.CharSetRegistry,
 	  parsed.CharSetEncoding);
   for (s = encoding; *s; s++)
     if (isupper(*s))
       *s = tolower(*s);
   char_map = DviFindMap(encoding);
   if (!char_map) {
-    fprintf(stderr, "not a standard encoding: %s\n", encoding);
-    return 0;
+    fprintf(stderr, "%s: not a standard encoding: \"%s\"\n",
+	    program_name, encoding);
+    return false;
   }
 
   fi = XLoadQueryFont(dpy, names0);
   if (!fi) {
-    fprintf(stderr, "font does not exist: %s\n", names0);
-    return 0;
+    fprintf(stderr, "%s: font does not exist: \"%s\"\n", program_name,
+	    names0);
+    return false;
   }
 
   printf("%s -> %s\n", names0, troff_name);
+  char *file_name = (char *)troff_name;
+  size_t dirlen = strlen(destdir);
+
+  if (dirlen > 0) {
+    size_t baselen = strlen(troff_name);
+    file_name = malloc(dirlen + baselen + 2 /* '/' and '\0' */);
+    if (NULL == file_name) {
+      fprintf(stderr, "%s: fatal error: unable to allocate memory\n",
+	      program_name);
+      xtotroff_exit(EXIT_FAILURE);
+    }
+    (void) strcpy(file_name, destdir);
+    file_namedirlen = '/';
+    (void) strcpy((file_name + dirlen + 1), troff_name);
+  }
 
   {				/* Avoid race while opening file */
     int fd;
-    (void) unlink(troff_name);
-    fd = open(troff_name, O_WRONLY | O_CREAT | O_EXCL, 0600);
+    (void) unlink(file_name);
+    fd = open(file_name, O_WRONLY | O_CREAT | O_EXCL, 0600);
     out = fdopen(fd, "w");
   }
 
-  if (!out) {
-    perror(troff_name);
-    return 0;
+  if (NULL == out) {
+    fprintf(stderr, "%s: unable to create '%s': %s\n", program_name,
+	    file_name, strerror(errno));
+    free(file_name);
+    return false;
   }
   fprintf(out, "name %s\n", troff_name);
   if (!strcmp(char_map->encoding, "adobe-fontspecific"))
@@ -227,14 +263,18 @@
   }
   XUnloadFont(dpy, fi->fid);
   fclose(out);
-  return 1;
+  free(file_name);
+  return true;
 }
 
 static void usage(FILE *stream)
 {
   fprintf(stream,
-	  "usage: %s -r resolution -s pointsize FontMap\n",
-	  program_name);
+	  "usage: %s -d destination-directory -r resolution"
+	  " -s type-size font-map\n"
+	  "usage: %s {-v | --version}\n"
+	  "usage: %s --help\n",
+	  program_name, program_name, program_name);
 }
 
 int main(int argc, char **argv)
@@ -253,9 +293,12 @@
 
   program_name = argv0;
 
-  while ((opt = getopt_long(argc, argv, "gr:s:v", long_options,
+  while ((opt = getopt_long(argc, argv, "d:gr:s:v", long_options,
 			    NULL)) != EOF) {
     switch (opt) {
+    case 'd':
+      destdir = strdup(optarg);
+      break;
     case 'g':
       /* unused; just for compatibility */
       break;
@@ -266,53 +309,60 @@
       sscanf(optarg, "%u", &point_size);
       break;
     case 'v':
-      printf("xtotroff (groff) version %s\n", Version_string);
-      exit(0);
+      printf("GNU xtotroff (groff) version %s\n", Version_string);
+      xtotroff_exit(EXIT_SUCCESS);
       break;
     case CHAR_MAX + 1: /* --help */
       usage(stdout);
-      exit(0);
+      xtotroff_exit(EXIT_SUCCESS);
       break;
     case '?':
       usage(stderr);
-      exit(1);
+      xtotroff_exit(EXIT_FAILURE);
       break;
     }
   }
   if (argc - optind != 1) {
     usage(stderr);
-    exit(1);
+    xtotroff_exit(EXIT_FAILURE);
   }
 
   dpy = XOpenDisplay(0);
   if (!dpy) {
-    fprintf(stderr, "Can't connect to the X server.\n");
-    fprintf(stderr,
-	    "Make sure the DISPLAY environment variable is set correctly.\n");
-    exit(1);
+    fprintf(stderr, "%s: fatal error: can't connect to the X server;"
+	    " make sure the DISPLAY environment variable is set"
+	    " correctly\n", program_name);
+    xtotroff_exit(EXIT_FAILURE);
   }
 
   map = fopen(argvoptind, "r");
-  if (map == NULL) {
-    perror(argvoptind);
-    exit(1);
+  if (NULL == map) {
+    fprintf(stderr, "%s: fatal error: unable to open map file '%s':"
+	    " %s\n", program_name, argvoptind, strerror(errno));
+    xtotroff_exit(EXIT_FAILURE);
   }
 
   while (fgets(line, sizeof(line), map)) {
     for (a = line, b = troff_name; *a; a++, b++) {
       c = (*b = *a);
-      if (c == ' ' || c == '\t')
+      if (' ' == c || '\t' == c)
 	break;
     }
     *b = '\0';
-    while (*a && (*a == ' ' || *a == '\t'))
+    while (*a && (' ' == *a || '\t' == *a))
       ++a;
     for (b = font_name; *a; a++, b++)
       if ((*b = *a) == '\n')
 	break;
     *b = '\0';
     if (!MapFont(font_name, troff_name))
-      exit(1);
+      xtotroff_exit(EXIT_FAILURE);
   }
-  exit(0);
+  xtotroff_exit(EXIT_SUCCESS);
 }
+
+// Local Variables:
+// fill-column: 72
+// mode: C
+// End:
+// vim: set cindent noexpandtab shiftwidth=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/test-groff.in -> _service:tar_scm:groff-1.23.0.tar.gz/test-groff.in Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/62bit.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/62bit.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/LOCALIZATION -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/LOCALIZATION Changed

@@ -1,54 +1,60 @@
-
 Localization
 ------------
 
-The localization process involves two files.
-
-  - A locale dependent file (for example, fr.tmac for French) where all
-    locale specific strings are (re)defined.
-
-  - A locale independent file (trans.tmac) responsible for activating those
-    localized strings.
-
-All you have to do is to create a new file named 'LL.tmac' where 'LL' is
-your country code ('de' for Germany, 'el' for Greece, ...), maybe using
-'fr.tmac' as a template.
-
-The first thing to do is to redefine the string 'locale' to your language.
-
-  .ds locale german\"
-
-Then change all the translations in the predefined strings.  Don't forget
-the \" at the end of each string, preventing spaces from lurking around.
-
-After 'trans.tmac' has been called by
-
-  .mso trans.tmac
-
-you must redefine the date strings in order to use the day and month names
-translated earlier.  If you don't feel comfortable with groff maybe you
-should use the definitions used in 'fr.tmac'.  Nevertheless, you should take
-care of the order of the date elements.
-
-  - If your date format is MM/DD/YY:
-
-      for ms: .ds DY \*MO \ndy \nyear
-      for mm: .ds cov*new-date \\*MO\\nmo \\ndy \\nyear
-      for me: .ds td \*(mo \n(dy \n(y4
-
-  - If your date format is DD/MM/YY:
-
-      for ms: .ds DY \ndy \*MO \nyear
-      for mm: .ds cov*new-date \\ndy \\*MO\\nmo \\nyear
-      for me: .ds td \n(dy \*(mo \n(y4
+The localization process involves two groff files and zero or more
+hyphenation pattern files.
+
+1.  A locale-dependent file (for example, fr.tmac for French) does one
+    or several of the following.
+
+    A.  A string identifying the groff locale (e.g., "english") is set.
+    B.  Locale-specific strings used by macro packages are (re)defined.
+    C.  Other tweaks to macro package configuration are performed, such
+        as altering the ordering of the components of a date string.
+    D.  Additional inter-sentence space is set to a language-appropriate
+        amount with the .ss request.
+    E.  A hyphenation mode appropriate to the hyphenation pattern files
+        for the locale is set with the .hy request.  Here's a mapping
+        from TeX hyphenation pattern minimums to groff hyphenation
+        modes.
+            \lefthyphenmin=2, \righthyphenmin=2 => 1
+            \lefthyphenmin=2, \righthyphenmin=3 => 4
+            \lefthyphenmin=1, \righthyphenmin=2 => 32
+    F.  Hyphenation codes appropriate to the hyphenation pattern files
+        for the locale are set with the .hcode request.
+    G.  The hyphenation language is set with the .hla request.
+    H.  Support for the character encoding used by the hyphenation
+        pattern files is loaded with the .mso request.
+    I.  Hyphenation pattern and exception files are loaded with the .hpf
+        and .hpfa requests.
+
+2.  A locale-independent file (trans.tmac) activates the localized
+    strings set up in item B above.
+
+See the groff Texinfo manual in doc/groff.texi for descriptions of the
+requests referred to above.
+
+Localization files are named using ISO 639-1 language identifiers.
+Further specialization of locales by ISO 3166 territory codes is
+tentatively planned as of groff 1.23.0, awaiting expressions of demand.
+
+After 'trans.tmac' has been loaded, you must redefine the date strings
+in order to use the day and month names translated earlier.  The date
+format also may need to be changed.
+
+- If the locale's date format is MM/DD/YYYY, use the following.
+
+    for ms: .ds DY \*MO \ndy \nyear\"
+    for mm: .ds cov*new-date \\*MO\\nmo \\ndy \\nyear\"
+    for me: .ds td \*(mo \n(dy \n(y4\"
+
+- If the locale's date format is DD/MM/YYYY, use the following.
+
+    for ms: .ds DY \ndy \*MO \nyear\"
+    for mm: .ds cov*new-date \\ndy \\*MO\\nmo \\nyear\"
+    for me: .ds td \n(dy \*(mo \n(y4\"
 
 Other date formats can be handled similarly.
 
-NOTE: For the mm package, in the 'ISODATE' macro, only the first definition
-      of 'cov*new-date' must be changed (see 'fr.tmac').
-
-Finally, change groff behaviour in order to comply with your locale.  For
-example, 'fr.tmac' changes the default encoding, sets the sentence spaces,
-and final activates hyphenation, provided there are hyphenation patterns
-available (which should be put into files named 'hyphen.LL' for
-consistency).
+Note: For the mm package, in the 'ISODATE' macro, only the first
+definition of 'cov*new-date' must be changed (see 'fr.tmac').

_service:tar_scm:groff-1.22.4.tar.gz/tmac/X.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/X.tmac Changed

@@ -1,6 +1,6 @@
 .\" X.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_X_tmac_C \n.cp
 .cp 0
 .ftr CW CR
 .ftr C CR
@@ -32,8 +32,8 @@
 \D'l .39m 0''\h'.5m'
 .fchar \dd \Z'\h'.25m'\v'.15m'\D'l 0 -.8m'\v'.2m'\h'-.195m'\
 \D'l .39m 0'\v'.4m'\D'l -.39m 0''\h'.5m'
-.fchar \lq ``
-.fchar \rq ''
+.fchar \lq \dq
+.fchar \rq \dq
 .fchar \Bq ,,
 .fchar \OE O\h'-.25m'E
 .fchar \oe o\h'-.14m'e
@@ -43,7 +43,6 @@
 .fchar \lh \lA
 .fchar \rh \rA
 .fchar \bq ,
-.fchar \aq '
 .fchar \IJ IJ
 .fchar \ij ij
 .fchar \fo <
@@ -122,16 +121,13 @@
 .  char \radicalex \h'-\w'\sr'u'\radicalex\h'\w'\sr'u'
 .fchar \sqrtex \radicalex
 .
-.cp \n_C
-.
-.do ie '\char97'a' \
-.  do mso latin1.tmac
+.ie '\char97'a' \
+.  mso latin1.tmac
 .el \
-.  do mso cp1047.tmac
+.  mso cp1047.tmac
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_X_tmac_C
+.do rr *groff_X_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/Xps.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/Xps.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/an-ext.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/an-ext.tmac Changed

@@ -1,9 +1,10 @@
-.\" an-ext.tmac
+.\" groff extension macros for man(7) package
 .\"
-.\" Copyright (C) 2007-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2007-2022 Free Software Foundation, Inc.
 .\"
 .\" Written by Eric S. Raymond <esr@thyrsus.com>
 .\"            Werner Lemberg <wl@gnu.org>
+.\"            G. Branden Robinson <g.branden.robinson@gmail.com>
 .\"
 .\" You may freely use, modify and/or distribute this file.
 .\"
@@ -20,44 +21,42 @@
 .\" Convention: Auxiliary macros and registers start with 'm' followed
 .\"             by an uppercase letter or digit.
 .
+.\" Setting the `mG` register to a positive value (e.g., on the command
+.\" line) enables usage of macros defined here that have alternative
+.\" definitions in the main groff man macro file.  This is for testing.
+.\" The logic uses subtraction due to frustrating, AT&T troff-compatible
+.\" limitations on the '!' operator.
+.
 .
 .\" Protect against being sourced twice.
-.nr mX +1
-.if \n(mX>1 \
+.nr mZ +1
+.if \n(mZ>1 \
 .  nx
 .
-.\" Check whether we are using grohtml.
-.nr mH 0
-.if \n(.g \
-.  if '\*(.T'html' \
-.    nr mH 1
-.
-.
-.\" Map mono-width fonts to standard fonts for groff's TTY device.
-.if n \{\
-.  do ftr CR R
-.  do ftr CI I
-.  do ftr CB B
-.\}
+.\" Define this to your implementation's constant-width typeface.
+.ds mC CW
+.if n .ds mC R
 .
-.\" groff has glyph entities for angle brackets.
-.ie \n(.g \{\
-.  ds la \(la\"
-.  ds ra \(ra\"
-.\}
-.el \{\
-.  ds la <\"
-.  ds ra >\"
-.  \" groff's man macros control hyphenation with this register.
-.  nr HY 1
-.\}
+.\" Save the automatic hyphenation mode.
+.\"
+.\" In AT&T troff, there was no register exposing the hyphenation mode,
+.\" and no way to save and restore it.  Set `mH` to a reasonable value
+.\" for your implementation and preference.
+.de mY
+.  ie !\\n(.g \
+.    nr mH 14
+.  el \
+.    do nr mH \\n.hy \" groff extension register
+..
 .
-.nr mS 0
+.nr mS 0 \" in a synopsis (SY/YS)?
+.nr mE 0 \" in an example (EX/EE)?
 .
 .
 .\" Declare start of command synopsis.  Sets up hanging indentation.
 .de SY
 .  ie !\\n(mS \{\
+.    mY
 .    nh
 .    nr mS 1
 .    nr mA \\n(.j
@@ -71,6 +70,7 @@
 .
 .  nr mT \w'\fB\\$1\fP\ '
 .  HP \\n(mTu
+.  rr mT
 .  B "\\$1"
 ..
 .
@@ -79,96 +79,74 @@
 .de YS
 .  in \\n(mIu
 .  ad \\n(mA
-.  hy \\n(HY
+.  hy \\n(mH
+.  rr mA
+.  rr mI
 .  nr mS 0
 ..
 .
 .
-.\" Declare optional option.
-.de OP
-.  ie \\n(.$-1 \
-.    RI "\fB\\$1\fP" "\ \\$2" ""
-.  el \
-.    RB "" "\\$1" ""
+.\" Prepare link text for mail/web hyperlinks.  `MT` and `UR` call this.
+.de mV
+.  ds m1 \\$1\"
+..
+.
+.
+.\" Emit hyperlink.  The optional argument supplies trailing punctuation
+.\" after link text.  `ME` and `UE` call this.
+.de mQ
+.  mY
+.  nh
+<\\*(m1>\\$1
+.  hy \\n(mH
 ..
 .
 .
 .\" Start URL.
+.if \n(.g-\n(mG \{\
 .de UR
-.  ds m1 \\$1\"
-.  nh
-.  if \\n(mH \{\
-.    \" Start diversion in a new environment.
-.    do ev URL-div
-.    do di URL-div
-.  \}
+.  mV \\$1
 ..
+.\}
 .
 .
 .\" End URL.
+.if \n(.g-\n(mG \{\
 .de UE
-.  ie \\n(mH \{\
-.    br
-.    di
-.    ev
-.
-.    \" Has there been one or more input lines for the link text?
-.    ie \\n(dn \{\
-.      do HTML-NS "<a href=""\\*(m1"">"
-.      \" Yes, strip off final newline of diversion and emit it.
-.      do chop URL-div
-.      do URL-div
-\c
-.      do HTML-NS </a>
-.    \}
-.    el \
-.      do HTML-NS "<a href=""\\*(m1"">\\*(m1</a>"
-\&\\$*\"
-.  \}
-.  el \
-\\*(la\\*(m1\\*(ra\\$*\"
-.
-.  hy \\n(HY
+.  mQ \\$1
 ..
+.\}
 .
 .
 .\" Start email address.
+.if \n(.g-\n(mG \{\
 .de MT
-.  ds m1 \\$1\"
-.  nh
-.  if \\n(mH \{\
-.    \" Start diversion in a new environment.
-.    do ev URL-div
-.    do di URL-div
-.  \}
+.  mV \\$1
 ..
+.\}
 .
 .
 .\" End email address.
+.if \n(.g-\n(mG \{\
 .de ME
-.  ie \\n(mH \{\
-.    br
-.    di
-.    ev
-.
-.    \" Has there been one or more input lines for the link text?
-.    ie \\n(dn \{\
-.      do HTML-NS "<a href=""mailto:\\*(m1"">"
-.      \" Yes, strip off final newline of diversion and emit it.
-.      do chop URL-div
-.      do URL-div
-\c
-.      do HTML-NS </a>
-.    \}
-.    el \
-.      do HTML-NS "<a href=""mailto:\\*(m1"">\\*(m1</a>"
-\&\\$*\"
-.  \}
-.  el \
-\\*(la\\*(m1\\*(ra\\$*\"
+.  mQ \\$1
+..
+.\}
+.
 .
-.  hy \\n(HY
+.\" Set a man page cross reference.
+.\" .MR page-topic page-section trailing-text
+.if \n(.g-\n(mG \{\
+.de MR
+.  mY
+.  nh
+.  ie \\n(.$=1 \
+.    I \\$1
+.  el \
+.    IR \\$1 (\\$2)\\$3
+.  hy \\n(mH
 ..
+.\}
 .
 .
 .\" Continuation line for .TP header.
@@ -180,23 +158,33 @@
 .
 .
 .\" Start example.
+.if \n(.g-\n(mG \{\
 .de EX
-.  do ds mF \\n.fam
-.  nr mE \\n(.f
-.  nf
-.  nh
-.  do fam C
-.  ft CW
+.  br
+.  if !\\n(mE \{\
+.    nr mF \\n(.f
+.    nr mP \\n(PD
+.    nr PD 1v
+.    nf
+.    ft \\*(mC
+.    nr mE 1
+.  \}
 ..
+.\}
 .
 .
 .\" End example.
+.if \n(.g-\n(mG \{\
 .de EE
-.  do fam \\*(mF
-.  ft \\n(mE
-.  fi
-.  hy \\n(HY
+.  br
+.  if \\n(mE \{\
+.    ft \\n(mF
+.    nr PD \\n(mP
+.    fi
+.    nr mE 0
+.  \}
 ..
+.\}
 .
 .
 .\" Start display.
@@ -210,10 +198,6 @@
 .  \" XXX to be written
 ..
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/tmac/an.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/an.tmac Changed

@@ -1,10 +1,1571 @@
-.\" an.tmac
+.\" groff implementation of man(7) package
 .\"
-.do mso andoc.tmac
+.\" Copyright (C) 1989-2023 Free Software Foundation, Inc.
+.\"      Written by James Clark (jjc@jclark.com)
+.\" Enhanced by: Werner Lemberg <wl@gnu.org>
+.\"              Larry Kollar <kollar@alltel.net>
+.\"              G. Branden Robinson <g.branden.robinson@gmail.com>
+.\"
+.\" Thanks to Deri James for illustrating PDF bookmark features.
+.\"
+.\" 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
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" 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 this program.  If not, see
+.\" <http://www.gnu.org/licenses/>.
+.
+.
+.\" Put site additions in the file man.local, loaded near the end of
+.\" this file.  To add things to TH, use '.am1 TH'.
+.
+.if !\n(.g \
+.  ab groff man macros require groff extensions; aborting
+.
+.do if d TH .nx
+.
+.do nr *groff_an_tmac_C \n.cp
+.cp 0
+.
+.\" Package-internal names start with "an-" and are subject to change,
+.\" such as migration to "an*" (in progress).
+.
+.\" Define a string for use in diagnostic messages.
+.ds an an.tmac\"
+.
+.\" We use the .stringup request from groff 1.23, but nothing breaks if
+.\" it is undefined; the output is unchanged in appearance from earlier
+.\" releases.
+.if (\n.x\n.y < 118) \{\
+.  ds an-msg \*an: groff man macros require groff 1.18 or later,\"
+.  as an-msg " but found groff \n.x.\n.y; aborting\"
+.  ab \*an-msg
+.\}
+.
+.\" === Define macros. ===
+.\"
+.\" Macros that are part of the external interface (TH, SH, P, etc.) or
+.\" that are called by traps of any kind must be defined with `de1`
+.\" because they might be called from a context where compatibility mode
+.\" is enabled.  For other macros, `de` suffices.
+.
+.de an-warn
+.  tm \*an:\\n.F:\\n.c: warning: \\$*
+..
+.
+.de an-style-warn
+.  if \\nCHECKSTYLE \
+.    tm \*an:\\n.F:\\n.c: style: \\$*
+..
+.
+.de an-deprecation-warn
+.  if (\\nCHECKSTYLE > 1) \
+.    an-style-warn use of deprecated macro: .\\$0
+..
+.
+.de1 an-blank-line-trap
+.  if (\\nCHECKSTYLE > 2) \
+.    an-style-warn blank line in input
+.  sp
+..
+.
+.de1 an-leading-space-trap
+.  if (\\nCHECKSTYLE > 2) \
+.    if \\n.u \
+.      an-style-warn \\nlsn leading space(s) on input line
+.  br
+.  nop \h'\\nlssu'\c
+..
+.
+.\" Define alternate requests to handle continuous rendering.
+.\"
+.\" This .ne replacement avoids page breaks; instead, the page length is
+.\" increased to the necessary amount.
+.de an-ne
+.  ie \\n.$ .nr an-amount (v;\\$*)
+.  el         .nr an-amount 1v
+.  if (\\nan-amount >= \\n.t) \
+.    pl +(\\nan-amountu - \\n.tu + 1v)
+.  rr an-amount
+..
+.
+.\" This .bp replacement for continuous rendering mode adjusts the page
+.\" length to the current position so that no empty lines are inserted.
+.de an-bp
+.  pl \\nnlu
+..
+.
+.\" We need an end-of-input macro to flush any pending output line and
+.\" write the footer for the final man page rendered.  We can also be
+.\" called by andoc when switching to an mdoc(7) page, irrespective of
+.\" continuous rendering mode.
+.de1 an-end
+.  if !r an-TH-was-called .return
+.  if \\ncR \{\
+.    \" We might have a pending output line that is not yet broken, and
+.    \" also be 1v from the bottom of the page.  If we break (or flush)
+.    \" the output line now, the page will get ejected afterward and
+.    \" troff will exit because we're in an end-of-input macro--our
+.    \" footer will never be output.  So, if that is the case, further
+.    \" extend the page length by 1v.
+.    if ((\\n.p - \\nnl) <= \\n.V) .pl +1v
+.    br
+.    pl +1v
+.    sp 1v
+.    an-footer
+.    \" If we're processing multiple documents and have started a new
+.    \" one, draw a line between this footer and the next header.
+.    if !'\\n.F'' \{\
+.      pl +1v
+.      nf
+.      ti 0
+.      nop \D'l \\nLLu 0'
+.      fi
+.    \}
+.  \}
+.  rr an-TH-was-called
+.  ch an-header
+.  an*break-page-with-new-number
+..
+.
+.\" Move macros into place for continuous rendering.
+.de an-set-up-continuous-rendering
+.  rn ne an-real-ne
+.  rn bp an-real-bp
+.  rn an-ne ne
+.  rn an-bp bp
+.  em an-end
+..
+.
+.de an*reset-hyphenation-mode
+.  ie \\nHY \{\
+.    \" No page breaks occur in continuous rendering.
+.    ie \\ncR \
+.      nr an*hyphenation-mode \\n\\*locale*hyphenation-mode-base
+.    el \
+.      nr an*hyphenation-mode \\n\\*locale*hyphenation-mode-trap
+.  \}
+.  el \
+.    nr an*hyphenation-mode 0
+.  hy \\nan*hyphenation-mode
+..
+.
+.de an-reset-tab-stops
+.  ta T .5i
+..
+.
+.de an-reset-paragraph-spacing
+.  ie \\n.$ .nr PD (v;\\$1)
+.  el         .nr PD (.4v >? \n.V)
+..
+.
+.de an-reset-margin-and-inset-level
+.  nr an-inset-level 1
+.  nr an-margin \\nIN
+.  nr an-saved-margin1 \\nIN
+.  nr an-prevailing-indent \\nIN
+.  nr an-saved-prevailing-indent1 \\nIN
+..
+.
+.\" Break the page and update its number depending on the C (consecutive
+.\" numbering) register.
+.\"
+.\" Corner case: if formatting multiple documents and P (starting page
+.\" number) is defined but C is not set, start numbering each document
+.\" at \nP.  Not strictly necessary if not switching macro packages.
+.de an*break-page-with-new-number
+.  ie \\nC .bp (\\n% + 1) \" argument NOT redundant before page 1
+.  el \{\
+.    ie r P .bp \\nP
+.    el     .bp 1
+.  \}
+..
+.
+.\" Localize manual section titles for English.
+.de an*localize-strings
+.  ds an*section1 General Commands Manual\"
+.  ds an*section2 System Calls Manual\"
+.  ds an*section3 Library Functions Manual\"
+.  ds an*section4 Kernel Interfaces Manual\"
+.  ds an*section5 File Formats Manual\"
+.  ds an*section6 Games Manual\"
+.  ds an*section7 Miscellaneous Information Manual\"
+.  ds an*section8 System Manager's Manual\"
+.  ds an*section9 Kernel Developer's Manual\"
+..
+.
+.\" Write a bookmark/anchor/link target $2 at hierarchical depth $1.
+.de an*bookmark
+.  if \\nan*is-output-pdf .pdfbookmark \\$1 \\$2
+..
+.
+.\" Begin man page.
+.\" .TH topic section extra1 extra2 extra3
+.de1 TH
+.  if ((\\n.$ < 2) : (\\n.$ > 5)) \
+.    an-style-warn .\\$0 expects 2 to 5 arguments, got \\n.$
+.
+.  blm an-blank-line-trap
+.  lsm an-leading-space-trap
+.
+.  \" If batch processing (rendering multiple) man page documents, we
+.  \" must handle the end of a previous document.
+.  if \\nan*need-titles-reset \{\
+.    if \\ncR .an-end
+.
+.    \" Clear the page header trap so it is not sprung with stale
+.    \" information.
+.    ch an-header
+.    an*break-page-with-new-number
+.  \}
+.  if \\nC .rr P
+.
+.  nr an-TH-was-called 1 \" an-end can make certain assumptions.
+.
+.  \" Set up rendering parameters.  We do this in TH instead of only
+.  \" once when initializing the package because when rendering multiple
+.  \" pages, a previous page might have changed them.
+.
+.  fam \\*an*body-family
+.  ft R
+.
+.  nr PS    10z \" default type size
+.  nr PS-SS 10z
+.  nr PS-SH 10.95z
+.  nr VS    12p
+.
+.  \" use sizes similar to LaTeX
+.  if t \{\
+.    ie (\\nS == 11) \{\
+.      nr PS    10.95z
+.      nr PS-SS 10.95z
+.      nr PS-SH 12z
+.      nr VS    13.6p
+.    \}
+.    el \{\
+.      if (\\nS == 12) \{\
+.        nr PS    12z
+.        nr PS-SS 12z
+.        nr PS-SH 14.4z
+.        nr VS    14.5p
+.      \}
+.    \}
+.  \}
+.
+.  \" The previous document rendered in a batch may have been in a
+.  \" different language.  If this one is in English, (re-)init strings.
+.  if '\\*locale'english' .an*localize-strings
+.
+.  ps \\nPSu
+.  vs \\nVSu
+.  ad \\*AD
+.  ll \\nLLu
+.
+.  \" We've seen no tbl(1) tables yet in this document.
+.  rr TW
+.  nr an-was-tbl-failure-reported 0
+.
+.  an*reset-hyphenation-mode
+.  an-reset-tab-stops
+.  an-reset-paragraph-spacing
+.  an-reset-margin-and-inset-level
+.
+.  nr an-tag-separation 1n
+.  nr an-need-no-space-mode 0
+.  nr an-need-break 0
+.  nr an-is-in-diversion 0
+.  nr an*is-in-example 0
+.
+.  ds an*topic "\\$1\"
+.  if \\nCT .stringup an*topic
+.  ds an*section "\\$2\"
+.  ie (\\n.$ > 4) .ds an-extra3 "\\$5\"
+.  el \{\
+.    \" Simulate switch/case in roff.
+.          ie '\\$2'1' .ds an-extra3 \\*an*section1\"
+.    el \{.ie '\\$2'2' .ds an-extra3 \\*an*section2\"
+.    el \{.ie '\\$2'3' .ds an-extra3 \\*an*section3\"
+.    el \{.ie '\\$2'4' .ds an-extra3 \\*an*section4\"
+.    el \{.ie '\\$2'5' .ds an-extra3 \\*an*section5\"
+.    el \{.ie '\\$2'6' .ds an-extra3 \\*an*section6\"
+.    el \{.ie '\\$2'7' .ds an-extra3 \\*an*section7\"
+.    el \{.ie '\\$2'8' .ds an-extra3 \\*an*section8\"
+.    el \{.ie '\\$2'9' .ds an-extra3 \\*an*section9\"
+.    el                .ds an-extra3 \" empty
+.    \}\}\}\}\}\}\}\}
+.  \}
+.
+.  ds an-extra1 "\\$3\"
+.  ie (\\n.$ > 3)    .ds an-extra2 "\\$4\"
+.  el                  .ds an-extra2 \" empty; but .AT/.UC can override
+.
+.  if '\\*an-extra1'' \{\
+.    ds an-msg .\\$0 missing third argument; suggest document\"
+.    as an-msg " modification date in ISO 8601 format (YYYY-MM-DD)\"
+.    an-style-warn \\*an-msg
+.    rm an-msg
+.  \}
+.
+.  if '\\*an-extra2'' \{\
+.    ds an-msg .\\$0 missing fourth argument; suggest package/project\"
+.    \" Yes, that's one double quote, then three, then two.
+.    as an-msg " name and version (e.g., """groff 1.23.0"")\"
+.    an-style-warn \\*an-msg
+.    rm an-msg
+.  \}
+.
+.  if '\\$5\\*an-extra3'' \{\
+.    ds an-msg .\\$0 missing fifth argument and second argument '\\$2'\"
+.    as an-msg " not a recognized manual section; specify its title\"
+.    an-style-warn \\*an-msg
+.    rm an-msg
+.  \}
+.
+.  \" Initialize environment for headers and footers.
+.  ev an*env-header-and-footer
+.  ps \\nPSu
+.  vs \\nVSu
+.  lt \\nLTu
+.  an*abbreviate-page-topic
+.  \" If AT or UC is called, we will need to abbreviate again.
+.  an*abbreviate-inner-footer
+.  ev
+.
+.  \" HTML gets the topic without any abbreviation, since it's metadata.
+.  if \\nan*is-output-html \{\
+.    DEVTAG-TL
+.    nop \\*an*topic
+.    DEVTAG-EO-TL
+.  \}
+.
+.  \" A bookmark is attached to the page header, but only on the first
+.  \" page of the document.
+.  nr an*was-TH-bookmark-emitted 0
+.  an-header
+.
+.  if !\\ncR \{\
+.    wh 0 an-header
+.    ie r FT .nr an*footer-location \\nFT
+.    el      .nr an*footer-location (-.5i)
+.    wh \\nan*footer-locationu an-footer
+.    wh (\\nan*footer-locationu - .5i) an-break-body-text
+.    rr an*footer-location
+.    \}
+.  \}
+.
+.  nr an*need-titles-reset 1
+..
+.
+.\" Support legacy AT&T and BSD Unix man pages.
+.
+.\" Designate an AT&T Unix man page.
+.\" .AT system-id release-id
+.de1 AT
+.  nop \\*an-deprecation-warn\\
+.  ds an-extra2 "7th Edition\"
+.  if "\\$1"3" .ds an-extra2 "7th Edition\"
+.  if "\\$1"4" .ds an-extra2 "System III\"
+.  if "\\$1"5" \{\
+.    ie "\\$2"" .ds an-extra2 "System V\"
+.    el         .ds an-extra2 "System V Release \\$2\"
+.  \}
+.  ev an*env-header-and-footer
+.  an*abbreviate-inner-footer
+.  ev
+..
+.
+.\" Designate a BSD Unix man page.
+.\" .UC system-id
+.de1 UC
+.  nop \\*an-deprecation-warn\\
+.  ds an-extra2 "3rd Berkeley Distribution\"
+.  if "\\$1"3" .ds an-extra2 "3rd Berkeley Distribution\"
+.  if "\\$1"4" .ds an-extra2 "4th Berkeley Distribution\"
+.  if "\\$1"5" .ds an-extra2 "4.2 Berkeley Distribution\"
+.  if "\\$1"6" .ds an-extra2 "4.3 Berkeley Distribution\"
+.  if "\\$1"7" .ds an-extra2 "4.4 Berkeley Distribution\"
+.  ev an*env-header-and-footer
+.  an*abbreviate-inner-footer
+.  ev
+..
+.
+.\" Restore tab stops to defaults.
+.de1 DT
+.  nop \\*an-deprecation-warn\\
+.  an-reset-tab-stops
+..
+.
+.\" Restore inter-paragraph spacing to default (or set it to argument).
+.\" .PD distance
+.de1 PD
+.  nop \\*an-deprecation-warn\\
+.  nop \\*an-reset-paragraph-spacing\\
+..
+.
+.\" Write the page header; can be redefined by man.local.
+.\"
+.\" In continuous rendering mode, we need to extend the page length to
+.\" accommodate the vertical size of our header (plus any spacing).
+.if d PT .ig
+.de1 PT
+.  ie \\ncR .pl +1v
+.  el         .sp .5i
+.  if !\\nan*was-TH-bookmark-emitted \{\
+.    an*bookmark 1 \E*an*page-ref-string
+.    nr an*was-TH-bookmark-emitted 1
+.  \}
+.  tl '\\*an-pageref'\\*an-extra3'\\*an-pageref'
+.  ie \\ncR \{\
+.    pl +1v
+.    sp 1v
+.  \}
+.  el .sp |1i
+..
+.
+.\" Write the page footer; can be redefined by man.local.
+.\"
+.\" In continuous rendering mode, we need to extend the page length to
+.\" accommodate the vertical size of our footer (plus any spacing).
+.if d BT .ig
+.de1 BT
+.  if \\ncR .pl +1v
+.  ie \\nD \{\
+.    if o .tl '\\*an*ifoot'\\*an-extra1'\\*an*ofoot'
+.    if e .tl '\\*an*ofoot'\\*an-extra1'\\*an*ifoot'
+.  \}
+.  el \
+.    tl '\\*an*ifoot'\\*an-extra1'\\*an*ofoot'
+..
+.
+.\" Abbreviate the page topic if it's too long for the header.  Leaves
+.\" string an-pageref defined for use in .PT and .an-footer.  Also
+.\" leaves an*topic-abbv for possible use by .PT and .BT re-definers.
+.\" Call this only from within the header/footer environment.
+.de an*abbreviate-page-topic
+.  ds an*topic-abbv \\*an*topic\" might not get abbreviated at all
+.  ds an*topic-string \\*an*topic\"
+.  ds an-ellipsis \|.\|.\|.\|\"
+.  \" an*page-ref-string is left unmodified for internal use, such as
+.  \" PDF bookmarks.
+.  ds an*page-ref-string \\*an*topic(\\*an*section)\"
+.  ds an-pageref \\*an*topic-abbv(\\*an*section)\"
+.  nr an-header-width \\w'\\*an-pageref\\*an-extra3\\*an-pageref'
+.  while (\\nan-header-width >= \\n.lt) \{\
+.    \" The page topic is too long; trim some bits out of the middle.
+.    length an*topic-length \\*an*topic-string
+.    \" roff uses truncating division.  Remove an additional character
+.    \" on each side of the midpoint to account for the ellipsis we add
+.    \" later.
+.    nr an-mark1 (\\nan*topic-length / 2 - 2)
+.    nr an-mark2 (\\nan*topic-length / 2 + 2)
+.    ds an-prefix \\*an*topic-string\"
+.    ds an-suffix \\*an*topic-string\"
+.    \" Use extremum operators to ensure that the first and last
+.    \" characters of the topic remain intact (in cases of pathological
+.    \" shortening).
+.    substring an-prefix 0 (\\nan-mark1 >? 1)
+.    substring an-suffix (\\nan-mark2 <? \\nan*topic-length - 1) -1
+.    ds an*topic-string \\*an-prefix\\*an-suffix\"
+.    ds an*topic-abbv \\*an-prefix\\*an-ellipsis\\*an-suffix\"
+.    \" Remeasure the formatted topic; give up if we made no progress.
+.    length an*topic-new-length \\*an*topic-string
+.    ie (\\nan*topic-new-length >= \\nan*topic-length) \
+.      break
+.    ds an-pageref \\*an*topic-abbv(\\*an*section)\"
+.    nr an-header-width \
+       \\w'\\*an-pageref\\*an-extra3\\*an-pageref'
+.  \}
+.  ds an-pageref \\*an-lic\f\\*MF\\*an*topic-abbv\\*an-ic\
+\fR(\\*an*section)\"
+.  rr an*topic-length-prev
+.  rr an-mark1
+.  rr an-mark2
+.  rm an-prefix
+.  rm an-suffix
+.  rm an*topic-string
+.  rr an*topic-length
+.  rr an-header-width
+.  rm an-ellipsis
+..
+.
+.\" Iterate through concatenation of arguments as a string.  If a bare
+.\" backslash is found, make `an*string-contains-backslash` true.  Our
+.\" caller should delete this register when done with it.
+.de an*scan-string-for-backslash
+.  nr an*string-contains-backslash 0
+.  nr an*index 0
+.  length an*max-index \\$*
+.  while (\\nan*index < \\nan*max-index) \{\
+.    ds an*char \\$*
+.    substring an*char \\nan*index \\nan*index
+.    ec @
+.    \" Use a weird delimiter to reduce lexical colorizer confusion.
+.    if _@*an*char_\\_ .nr an*string-contains-backslash 1
+.    ec
+.    if \\nan*string-contains-backslash .break
+.    nr an*index +1
+.  \}
+.  rm an*char
+.  rr an*max-index
+.  rr an*index
+..
+.
+.\" Abbreviate the `an-extra2` string (set by .TH) if it's too long for
+.\" the footer.  The formatted width of the inner footer plus half that
+.\" of the center footer must be less than half the title width or we
+.\" must abbreviate.  By default, `an-extra2` is placed as the inner
+.\" footer.  We call its (potential) abbreviation `an*ifoot` here and
+.\" leave it defined for .BT use.  (`an*ofoot` is not treated the same
+.\" way.  `an-footer` regenerates it on every page because the page
+.\" number changes if present.)  Shorten the inner footer if necessary
+.\" by trimming characters off the end, replacing them with an ellipsis.
+.de an*abbreviate-inner-footer
+.  ds an*ifoot \\*an-extra2\"
+.  nr an*half-title-width (\\n.lt / 2u)
+.  nr an*half-cfoot-width (\w'\\*an-extra1' / 2u)
+.  nr an*half-footer-width \
+     (\w'\\*an*ifoot' + \\nan*half-cfoot-width)
+.  if (\\nan*half-footer-width < \\nan*half-title-width) \{\
+.    rr an*half-footer-width
+.    rr an*half-cfoot-width
+.    rr an*half-title-width
+.    return
+.  \}
+.  an*scan-string-for-backslash \\*an*ifoot
+.  if \\nan*string-contains-backslash \{\
+.    an-warn not abbreviating fourth argument to 'TH' '\\*an*ifoot': \
+contains unsupported escape sequence
+.    rr an*string-contains-backslash
+.    rr an*half-footer-width
+.    rr an*half-cfoot-width
+.    rr an*half-title-width
+.    return
+.  \}
+.  ds an*saved-ifoot \\*an*ifoot
+.  ds an*ellipsis \|.\|.\|.\|\"
+.  \" Remeasure with ellipsis added to inner footer so that henceforth,
+.  \" the measured width strictly decreases.
+.  nr an*half-footer-width \
+     (\w'\\*an*ifoot\\*an*ellipsis' + \\nan*half-cfoot-width)
+.  nr an*end-index (-2)
+.  while (\\nan*half-footer-width >= \\nan*half-title-width) \{\
+.    ds an*ifoot \\*an*saved-ifoot
+.    substring an*ifoot 0 \\nan*end-index
+.    \" Measure the string again and give up if we made no progress.
+.    nr an*new-half-footer-width \
+       (\w'\\*an*ifoot\\*an*ellipsis' + \\nan*half-cfoot-width)
+.    ie (\\nan*new-half-footer-width >= \\nan*half-footer-width) \
+.      break
+.    nr an*half-footer-width \\nan*new-half-footer-width
+.    nr an*end-index -1
+.  \}
+.  ds an*ifoot \\*an*ifoot\\*an*ellipsis\"
+.  rr an*end-index
+.  rr an*new-half-footer-width
+.  rm an*ellipsis
+.  rm an*saved-ifoot
+.  rr an*string-contains-backslash
+.  rr an*half-footer-width
+.  rr an*half-cfoot-width
+.  rr an*half-title-width
+..
+.
+.\" Prepare the header for a page of the document.
+.de1 an-header
+.  if \\nan-suppress-header-and-footer .return
+.  ev an*env-header-and-footer
+.  PT
+.  ev
+.  ns
+..
+.
+.\" Schedule a page break when the next output line is written (not
+.\" called if continuously rendering).
+.de1 an-break-body-text
+'  bp
+..
+.
+.\" Prepare the footer for a page of the document.
+.de1 an-footer
+.  if \\nan-suppress-header-and-footer .return
+.  ev an*env-header-and-footer
+.  ie \\ncR \
+.    ds an*ofoot "\\*an-pageref\"
+.  el \{\
+.    ds an*ofoot \\n%\"
+.    if r X \{\
+.      if (\\n% > \\nX) \{\
+.        nr an-page-letter (\\n% - \\nX)
+.        ds an*ofoot \\nX\\nan-page-letter\"
+.      \}
+.    \}
+.  \}
+.  BT
+.  rm an*ofoot
+.  ev
+..
+.
+.\" Output the tag of a tagged paragraph, or of an indented paragraph
+.\" (IP) that has a tag.  Whether we break depends on the tag width.
+.de an-write-paragraph-tag
+.  br
+.  di
+.  ad \\*AD
+.  nr an-is-in-diversion 0
+.  ll
+.  \" We must emit the diversion in a separate environment to ensure
+.  \" that a possible margin character is printed correctly.
+.  ev an-env-paragraph-tag
+.  evc 0
+.  mc
+.  nf
+.  in \\nan-marginu
+.  \" Prevent page break between the tag and the rest of the paragraph.
+.  ne (2v + 1u)
+.  \" Does the tag fit within the paragraph indentation?
+.  nr an-tag-fits \
+     (\\ndl + \\nan-tag-separation <= \\nan-prevailing-indent)
+.  if \\nan-tag-fits .DEVTAG-COL 1
+.  an-div
+.  if \\nan-tag-fits .sp -1v
+.  ev
+.  in (\\nan-marginu + \\nan-prevailing-indentu)
+.  if \\nan-tag-fits .DEVTAG-COL 2
+.  rr an-tag-fits
+..
+.
+.\" Handle macros that may take an "argument" on the next input line
+.\" producing written or drawn output: .SH, .SS, .B, .I, .SM, .SB--and
+.\" .TP, which does so mandatorily.
+.de1 an-input-trap
+.  if \\nan-devtag-needs-end-of-heading .DEVTAG-EO-H
+.  nr an-devtag-needs-end-of-heading 0
+.  if \\nan-devtag-needs-second-column .DEVTAG-COL 2
+.  nr an-devtag-needs-second-column 0
+.  ft R
+.  ps \\nPSu
+.  vs \\nVSu
+.  if \\nan-need-break \{\
+.    br
+.    nr an-need-break 0
+.  \}
+.  if \\nan-need-no-space-mode \{\
+.    ns
+.    nr an-need-no-space-mode 0
+.  \}
+.  if \\nan-is-in-diversion .an-write-paragraph-tag
+..
+.
+.\" Break a paragraph.  Restore defaults, except for indentation.
+.de an-break-paragraph
+.  ft R
+.  ps \\nPSu
+.  vs \\nVSu
+.  sp \\nPDu
+.  ns
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) as a section heading.
+.de1 SH
+.  fam \\*an*body-family
+.  an-break-paragraph
+.  an-reset-margin-and-inset-level
+.  fi
+.  in \\nan-marginu
+.  ti 0
+.  nr an-devtag-needs-end-of-heading 1
+.  DEVTAG-SH 1
+.  it 1 an-input-trap
+.  nr an-need-no-space-mode 1
+.  nr an-need-break 1
+.  ps \\nPS-SHu
+.  ne (2v + 1u)
+.  ft \\*HF
+.  if \\nan-remap-I-style-in-headings .ftr I \\*an-heading-familyBI
+.  if \\n.$ \{\
+.    ds an-section-heading \\$*\"
+.    if \\nCS .stringup an-section-heading
+.    an*bookmark 2 \E*an-section-heading
+.    nop \&\\*an-section-heading
+.  \}
+.  if \\nan-remap-I-style-in-headings .ftr I I
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) as a subsection heading.
+.de1 SS
+.  fam \\*an*body-family
+.  an-break-paragraph
+.  an-reset-margin-and-inset-level
+.  fi
+.  in \\nINu
+.  ti \\nSNu
+.  nr an-devtag-needs-end-of-heading 1
+.  DEVTAG-SH 2
+.  it 1 an-input-trap
+.  nr an-need-no-space-mode 1
+.  nr an-need-break 1
+.  ps \\nPS-SSu
+.  ne (2v + 1u)
+.  ft \\*HF
+.  if \\nan-remap-I-style-in-headings .ftr I \\*an-heading-familyBI
+.  if \\n.$ \{\
+.    ds an*subsection-heading \\$*\"
+.    an*bookmark 3 \E*an*subsection-heading
+.    nop \&\\$*
+.  \}
+.  if \\nan-remap-I-style-in-headings .ftr I I
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) in bold style.
+.de1 B
+.  it 1 an-input-trap
+.  ft B
+.  if \\n.$ \&\\$*
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) in italic style.
+.de1 I
+.  it 1 an-input-trap
+.  ft I
+.  if \\n.$ \,\\$*\/
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) at smaller type size.
+.de1 SM
+.  it 1 an-input-trap
+.  ps -1
+.  if \\n.$ \&\\$*
+..
+.
+.\" Set arguments (or next input line producing written or drawn output
+.\" if none) in bold style at smaller type size.
+.de1 SB
+.  it 1 an-input-trap
+.  ps -1
+.  ft B
+.  if \\n.$ \&\\$*
+..
+.
+.\" Set an ordinary paragraph.
+.de1 P
+.  an-break-paragraph
+.  in \\nan-marginu
+.  nr an-prevailing-indent \\nIN
+..
+.
+.\" Accommodate ms(7) paragraphing refugees.
+.als LP P
+.als PP P
+.
+.\" Set a tagged paragraph.  The tag must be on the next input line
+.\" producing written or drawn output.
+.\" .TP indent
+.de1 TP
+.  an-break-paragraph
+.  if \\n.$ .nr an-prevailing-indent (n;\\$1)
+.  itc 1 an-input-trap
+.  in 0
+.  if !\\nan-is-in-diversion \{\
+.    ll -\\nan-marginu
+.    di an-div
+.    na
+.  \}
+.  nr an-is-in-diversion 1
+..
+.
+.\" Set an indented paragraph.
+.\" .IP marker indentation-amount
+.de1 IP
+.  an-break-paragraph
+.  ie !\\n.$ \{\
+.    ne (1v + 1u)
+.    in (\\nan-marginu + \\nan-prevailing-indentu)
+.  \}
+.  el \{\
+.    ie (\\n.$ > 1) .TP "\\$2"
+.    el               .TP
+.    nop \&\\$1
+.  \}
+..
+.
+.\" Set a paragraph with a hanging indentation.
+.\" .HP indent
+.de1 HP
+.  if !\\nmS \\*an-deprecation-warn\c
+.  an-break-paragraph
+.  ne (1v + 1u)
+.  if \\n.$ .nr an-prevailing-indent (n;\\$1)
+.  in (\\nan-marginu + \\nan-prevailing-indentu)
+.  ti \\nan-marginu
+.  DEVTAG-COL 1
+.  nr an-devtag-needs-second-column 1
+..
+.
+.\" === Define alternating font macros. ===
+.\"
+.\" Implementation notes:
+.\"
+.\" We always emit a dummy character \& before the first argument.  This
+.\" is necessary only when the calling man page is in compatibility
+.\" mode; it works around the surprising AT&T semantics of \f escapes at
+.\" the beginning of an input line.  See "Implementation differences" in
+.\" groff_diff(7) or the groff Texinfo manual.
+.\"
+.\" The italic correction escapes can be visually confusing.  We apply
+.\" the following rules, always on the same input line.
+.\"   (1) Before any italic argument, emit a left italic correction \,
+.\"       before switching to the italic style.
+.\"   (2) After any italic argument, emit an italic correction \/
+.\"       before switching to another style.
+.\" It is true that these macros cannot know what style is used in the
+.\" input stream before or after they are called.  We can make
+.\" assumptions based on pragmatics.  In most cases, the caller will not
+.\" precede a call to one of these macros with \c, or add it to the
+.\" final argument given to one of these calls; when \c is absent, what
+.\" is adjacent must be a word space or output line boundary, so italic
+.\" corrections don't matter.  If \c _is_ used by the caller, we can
+.\" assume that the adjacent glyphs before an IB or IR call, or the
+.\" following ones after a BI or RI call, will not be italic (and thus
+.\" will benefit from the italic correction we provide); otherwise the
+.\" caller would simply have added the relevant characters to the
+.\" arguments of the macro call.
+.\"
+.
+.\" Set each argument in bold and italics, alternately.
+.de1 BI
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \fB\\$1\,\fI\\$2\/\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \fB\\$1\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Set each argument in bold and roman, alternately.
+.de1 BR
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \fB\\$1\fR\\$2\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \fB\\$1\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Set each argument in italics and bold, alternately.
+.de1 IB
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \,\fI\\$1\/\fB\\$2\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \,\fI\\$1\/\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Set each argument in italics and roman, alternately.
+.de1 IR
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \,\fI\\$1\/\fR\\$2\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \,\fI\\$1\/\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Set each argument in roman and bold, alternately.
+.de1 RB
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \fR\\$1\fB\\$2\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \fR\\$1\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Set each argument in roman and italics, alternately.
+.de1 RI
+.  if (\\n.$ < 2) \
+.    an-style-warn .\\$0 expects at least 2 arguments, got \\n.$
+.  if \\n.$ \{\
+.    ds an-result \&\"
+.    while (\\n.$ >= 2) \{\
+.      as an-result \fR\\$1\,\fI\\$2\/\"
+.      shift 2
+.    \}
+.    if \\n.$ .as an-result \fR\\$1\"
+.    nop \\*an-result
+.    rm an-result
+.    ft R
+.  \}
+..
+.
+.\" Start a relative inset level (by the amount given in the argument).
+.\" .RS inset-amount
+.de1 RS
+.  nr an-saved-margin\\nan-inset-level \\nan-margin
+.  nr an-saved-prevailing-indent\\nan-inset-level \
+     \\nan-prevailing-indent
+.  ie \\n.$ .nr an-margin +(n;\\$1)
+.  el         .nr an-margin +\\nan-prevailing-indent
+.  in \\nan-marginu
+.  nr an-prevailing-indent \\nIN
+.  nr an-inset-level +1
+..
+.
+.\" End relative inset level, backing up by one level (or to the level
+.\" given by the argument).
+.\" .RE inset-level
+.de1 RE
+.  ie \\n.$ .nr an-RE-requested-level \\$1
+.  el         .nr an-RE-requested-level (\\nan-inset-level - 1)
+.  ie \\n.$ \{\
+.    if (\\nan-RE-requested-level = \\nan-inset-level) \
+.      ds an-RE-problem already at level \\nan-inset-level\"
+.    if (\\nan-RE-requested-level > \\nan-inset-level) \
+.      ds an-RE-problem too large\"
+.    if (\\nan-RE-requested-level < 1) \
+.      ds an-RE-problem too small\"
+.    if d an-RE-problem \
+.      an-style-warn argument """\\$1""" to .\\$0 \\*an-RE-problem
+.    rm an-RE-problem
+.  \}
+.  el .if !(\\nan-RE-requested-level) .an-style-warn unbalanced .\\$0
+.  rr an-RE-requested-level
+.  ie \\n.$ .nr an-inset-level ((;\\$1) <? \\nan-inset-level)
+.  el         .nr an-inset-level -1
+.  nr an-inset-level (1 >? \\nan-inset-level)
+.  nr an-margin \\nan-saved-margin\\nan-inset-level
+.  nr an-prevailing-indent \
+     \\nan-saved-prevailing-indent\\nan-inset-level
+.  in \\nan-marginu
+..
+.
+.\" Deprecated: Style an option with an argument (mandatory if
+.\" specified) for a command synopsis.
+.\" .OP flag option-parameter
+.de1 OP
+.  nop \\*an-deprecation-warn\\
+.  if ((\\n.$ < 1) : (\\n.$ > 2)) \
+.    an-style-warn .\\$0 expects 1 or 2 arguments, got \\n.$
+.  ie (\\n.$ > 1) \
+.    RI \\fB\\$1\f \~\\$2 
+.  el \
+.    RB  \\$1 
+..
+.
+.\" Begin an example (typically of source code or shell input).
+.de1 EX
+.  br
+.  if \\nan*is-in-example \{\
+.    an-style-warn ignoring .\\$0 while already in example
+.    return
+.  \}
+.  ds an*saved-family \\n.fam
+.  nr an*saved-font \\n.f
+.  nr an*saved-paragraph-distance \\nPD
+.  nr PD 1v
+.  nf
+.  \" If using the DVI output device, we have no constant-width fonts of
+.  \" bold weight and, relatedly, no constant-width family (because that
+.  \" requires all four styles).  Remap the bold styles to normal ones.
+.  ie '\*.T'dvi' \{\
+.    ftr R CW
+.    ftr B CW
+.    ftr I CWI
+.    ftr BI CWI
+.  \}
+.  el .fam \\*an*example-family
+.  ft R
+.  nr an*is-in-example 1
+..
+.
+.\" End example.
+.de EE
+.  br
+.  if !\\nan*is-in-example \{\
+.    an-style-warn ignoring .\\$0 while not in example
+.    return
+.  \}
+.  \" Undo the remappings from `EX`.
+.  ie '\*.T'dvi' \{\
+.    ftr R
+.    ftr B
+.    ftr I
+.    ftr BI
+.  \}
+.  fam \\*an*saved-family
+.  ft \\nan*saved-font
+.  nr PD \\nan*saved-paragraph-distance
+.  fi
+.  rr an*saved-paragraph-distance
+.  rr an*saved-font
+.  rm an*saved-family
+.  nr an*is-in-example 0
+..
+.
+.\" Store the argument and begin a diversion for link text.
+.de an*begin-hyperlink
+.  ds an*hyperlink \\$1\"
+.  \" We want the diversion to format as if it has an indentation of
+.  \" zero (that comes for free when we switch environments), and we
+.  \" want the line length reduced by the amount of indentation that
+.  \" obtains when we output it.
+.  nr an*saved-line-length \\n.l
+.  nr an*saved-indentation \\n.i
+.  \" We can only hyperlink if we're not in a diversion.
+.  \" XXX: There's no fundamental reason for that, just a simple matter
+.  \" of macro programming.
+.  nr an*is-in-link-text-diversion 0
+.  if '\\n(.z'' .nr an*is-in-link-text-diversion 1
+.  if (\\nan*is-in-link-text-diversion & \\nan*do-hyperlink) \{\
+.    \" Start diversion in a new environment.
+.    ev an*link-text-env
+.    di an*link-text-div
+.    ll (\\nan*saved-line-lengthu - \\nan*saved-indentationu)
+.  \}
+.  rr an*saved-indentation
+.  rr an*saved-line-length
+..
+.
+.\" Emit hyperlinked text with optional trailing text.
+.\"
+.\" The caller should set the `an*prefix` string if the hyperlink should
+.\" be prefixed with a scheme; for example, email addresses get
+.\" "mailto:", but this need not be visible when rendering an email
+.\" address on a device incapable of hyperlinking.
+.de an*end-hyperlink
+.  ie (\\nan*is-in-link-text-diversion & \\nan*do-hyperlink) \{\
+.    br
+.    di
+.    ev
+.
+.    \" Was any link text present?
+.    ie \\ndn \{\
+.      if \\nan*is-output-html \
+.        nop \X^html:<a href="\\*an*prefix\\*an*hyperlink">^\c
+.      if \\nan*is-output-terminal \
+.        nop \X^tty: link \\*an*prefix\\*an*hyperlink^\c
+.      \" Strip off the final newline of the diversion and emit it.
+.      chop an*link-text-div
+.      an*link-text-div
+\c\" XXX: If we .nop this, HTML output is corrupted (Savannah #63470).
+.      if \\nan*is-output-html \
+.        nop \X^html:</a>^\c
+.      if \\nan*is-output-terminal \
+.        nop \X^tty: link^\c
+.    \}
+.    \" If there was no link text, format URI as its own link text.  We
+.    \" don't add angle brackets here.
+.    el \{\
+.      if \\nan*is-output-html \
+.        nop \X^html:<a href="\\*an*prefix\\*an*hyperlink">\
+\\*an*hyperlink</a>^\c
+.      if \\nan*is-output-terminal \
+.        nop \X^tty: link \\*an*prefix\\*an*hyperlink^\
+\\*an*hyperlink\X^tty: link^\c
+.    \}
+.    nop \&\\$1\"
+.  \}
+.  \" If not hyperlinking, format URI in angle brackets.  There was no
+.  \" diversion, so the link text has already been formatted normally.
+.  el \{\
+.    nh
+.    nop \\la\\*an*hyperlink\\ra\\$1
+.    hy \\nan*hyphenation-mode
+.  \}
+.
+.  rr an*is-in-link-text-diversion
+..
+.
+.\" Begin email hyperlink.  Input until the next `ME` call is stored in
+.\" a diversion; it becomes the link text for the hyperlinked address.
+.\" .MT nobody@example.com
+.de1 MT
+.  if !(\\n.$ = 1) \
+.    an-style-warn .\\$0 expects 1 argument, got \\n.$
+.  ds an*prefix mailto:
+.  an*begin-hyperlink \\$1
+..
+.
+.\" End email hyperlink.  The optional argument supplies trailing
+.\" punctuation (or, rarely, other text) after link text.
+.\" .ME trailing-text
+.de1 ME
+.  an*end-hyperlink \\$1
+.  rm an*prefix
+..
+.
+.\" Begin web hyperlink.  Input until the next `UE` call is stored in
+.\" a diversion; it becomes the link text for the hyperlinked address.
+.\" .UR nobody@example.com
+.de1 UR
+.  if !(\\n.$ = 1) \
+.    an-style-warn .\\$0 expects 1 argument, got \\n.$
+.  ds an*prefix \" empty
+.  an*begin-hyperlink \\$1
+..
+.
+.\" End web hyperlink.  The optional argument supplies trailing
+.\" punctuation (or, rarely, other text) after link text.
+.\" .UE trailing-text
+.de1 UE
+.  an*end-hyperlink \\$1
+.  rm an*prefix
+..
+.
+.\" There is no standardized format for man page URLs, but the default
+.\" is expected to work (or be harmlessly ignored) everywhere except
+.\" macOS.  Override in man.local if desired.
+.nr an*MR-URL-format 1
+.
+.\" Set a man page cross reference.
+.\" .MR page-topic page-section trailing-text
+.de1 MR
+.  if ((\\n.$ < 2) : (\\n.$ > 3)) \
+.    an-style-warn .\\$0 expects 2 or 3 arguments, got \\n.$
+.  ds an*url man:\\$1(\\$2)\" used everywhere but macOS
+.  if (\\nan*MR-URL-format = 2) \
+.    ds an*url x-man-page://\\$2/\\$1\" macOS/Mac OS X since 10.3
+.  if (\\nan*MR-URL-format = 3) \
+.    ds an*url man:\\$1.\\$2\" Bwana (Mac OS X)
+.  if (\\nan*MR-URL-format = 4) \
+.    ds an*url x-man-doc://\\$2/\\$1\" ManOpen (Mac OS X pre-2005)
+.  nh
+.  if \\nan*do-hyperlink \{\
+.    if \\nan*is-output-html \
+.      nop \X^html:<a href="\\*an*url">^\c
+.    if \\nan*is-output-terminal \
+.      nop \X^tty: link \\*an*url^\c
+.  \}
+.      nop \&\\*an-lic\f\\*MF\\$1\\*an-ic\fR(\\$2)\c
+.  if \\nan*do-hyperlink \{\
+.    if \\nan*is-output-html \
+.      nop \X^html:</a>^\c
+.    if \\nan*is-output-terminal \
+.      nop \X^tty: link^\c
+.  \}
+.  nop \&\\$3
+.  hy \\nan*hyphenation-mode
+..
+.
+.\" tbl(1) table support
+.
+.\" Start table.
+.de1 TS
+.  \" If continuous rendering, tell tbl not to use keeps.
+.  ie \\ncR .nr 3usekeeps 0
+.  el         .nr 3usekeeps 1
+.  if \\nan*is-output-html \{\
+.    nr an-TS-ll \\n.l
+.    ll 1000n
+.  \}
+.  HTML-IMAGE
+..
+.
+.\" Start another table in the same region (ignored).
+.de1 T&
+..
+.
+.\" End table.
+.de1 TE
+.  HTML-IMAGE-END
+.  if \\nan*is-output-html .ll \\nan-TS-llu
+.  if !r TW .if !\\nan-was-tbl-failure-reported \{\
+.    ds an-msg tbl preprocessor failed, or it or soelim was not run;\"
+.    as an-msg " table(s) likely not rendered\"
+.    as an-msg " (TE macro called with TW register undefined)\"
+.    an-warn \\*an-msg
+.    rm an-msg
+.    nr an-was-tbl-failure-reported 1
+.  \}
+..
+.
+.\" eqn(1) equation support
+.
+.\" Start equation.
+.de1 EQ
+.  if \\nan*is-output-html \{\
+.    nr an-EQ-ll \\n.l
+.    ll 1000n
+.  \}
+.  HTML-IMAGE
+..
+.
+.\" End equation.
+.de1 EN
+.  HTML-IMAGE-END
+.  if \\nan*is-output-html .ll \\nan-EQ-llu
+..
+.
+.
+.\" === Define strings. ===
+.\"
+.\" These strings must work in compatibility mode also.
+.
+.ds S \s'\\n(PSu'\"
+.ie c\rg .ds R \(rg\"
+.el        .ds R (Reg.)\"
+.ie c\tm .ds Tm \(tm\"
+.el        .ds Tm (TM)\"
+.ie c\lq .ds lq \(lq\"
+.el        .ds lq ""\"
+.ie c\rq .ds rq \(rq\"
+.el        .ds rq ""\"
+.
+.\" === Define/remap characters. ===
+.
+.\" For UTF-8, map the minus sign to the hyphen-minus to facilitate
+.\" copy and paste of code examples, file names, and URLs embedding it.
+.if '\*.T'utf8' \
+.  char \- \N'45'
+.
+.\" === Initialize. ===
+.
+.mso devtag.tmac
+.nr an-devtag-needs-end-of-heading 0
+.nr an-devtag-needs-second-column 0
+.
+.\" Track whether the strings that set header and footer text need to be
+.\" reconfigured.  This happens when batch-rendering and starting a new
+.\" page.
+.nr an*need-titles-reset 0
+.
+.nr an*is-output-html 0
+.if '\*.T'html' .nr an*is-output-html 1
+.nr an*is-output-pdf 0
+.if '\*.T'pdf' .nr an*is-output-pdf 1
+.nr an*is-output-terminal 0
+.if '\*(.T'ascii'  .nr an*is-output-terminal 1
+.if '\*(.T'cp1047' .nr an*is-output-terminal 1
+.if '\*(.T'latin1' .nr an*is-output-terminal 1
+.if '\*(.T'utf8'   .nr an*is-output-terminal 1
+.
+.nr an*can-hyperlink 0
+.if (  \nan*is-output-html \
+     : \nan*is-output-pdf \
+     : \nan*is-output-terminal) \
+.  nr an*can-hyperlink 1
+.
+.ds an*body-family T \" Times
+.ds an*example-family C \" Courier
+.
+.\" Map monospaced fonts to standard styles for groff's nroff devices.
+.if n \{\
+.  ftr CR R
+.  ftr CI I
+.  ftr CB B
+.  ftr CBI BI
+.\}
+.
+.\" undocumented register; unset to test an-ext.tmac extension macros
+.if !r mG \
+.  nr mG 1
+.
+.\" Load man macro extensions.
+.mso an-ext.tmac
+.
+.\" Load site modifications.
+.msoquiet man.local
+.
+.\" Set each rendering parameter only if its -dr option or man.local
+.\" did not.
+.
+.if \nan*is-output-pdf \{\
+.  \" FIXME: The following registers are documented only in pdf.tmac.
+.  if !r PDFOUTLINE.FOLDLEVEL .nr PDFOUTLINE.FOLDLEVEL 1
+.  if !r PDFHREF.VIEW.LEADING .nr PDFHREF.VIEW.LEADING 10p
+.\}
+.
+.\" continuous rendering (one long page)
+.if !r cR \{\
+.  ie n .nr cR 1
+.  el   .nr cR 0
+.\}
+.
+.\" consecutive page numbering across multiple documents
+.\"
+.\" We must use consecutive page numbers when using PostScript to
+.\" generate HTML images; we must not reset the page number at the
+.\" beginning of each document (the 'ps4html' register is automatically
+.\" added to the command line by the pre-HTML preprocessor).
+.ie !r C \
+.  nr C 0
+.el \
+.  if !\nC \
+.    if \nan*is-output-html \{\
+.       tm \*an: consecutive page numbering required for HTML output
+.       nr C 1
+.    \}
+.if \nan*is-output-html \
+.  nr C 1
+.if r ps4html \
+.  nr C 1
+.
+.\" diagnostics desired for man page style problems
+.if !r CHECKSTYLE \
+.  nr CHECKSTYLE 0
+.
+.\" full capitalization of section headings
+.if !r CS \
+.  nr CS 0
+.
+.\" full capitalization of page topic
+.if !r CT \
+.  nr CT 0
+.
+.\" double-sided layout
+.ie !r D \
+.  nr D 0
+.el \
+.  if \nD \
+.    if \nan*is-output-html \{\
+.       tm \*an: ignoring double-sided layout in HTML output
+.       nr D 0
+.    \}
+.
+.\" footer distance
+.\"
+.\" Unlike most of these parameters, we do not set a default for FT; the
+.\" TH macro places page location traps only if not continuously
+.\" rendering.
+.if r FT \{\
+.  \" Validate it.  Continuous rendering ignores FT.  Measuring a footer
+.  \" distance from the page top isn't done.  A footer distance of over
+.  \" half the page length is unlikely.  A footer distance of less than
+.  \" one line height is too.
+.  ie \ncR \
+.    ds an-msg footer distance when continuously rendering\"
+.  el \{\
+.    nr an*tmp 1v
+.    ds an*help " (1v=\nan*tmpu)\"
+.    ie (\nFT : (\nFT = 0)) \
+.      ds an-msg non-negative footer distance: \nFTu\*an*help\"
+.    el \{\
+.      ie (-(\nFT) > (\n.p / 2)) \{\
+.        ds an-msg implausibly large footer distance:\"
+.        as an-msg " \nFTu\*an*help\"
+.      \}
+.      el \
+.        if (-(\nFT) < 1v) \{\
+.          ds an-msg implausibly small footer distance:\"
+.          as an-msg " \nFTu\*an*help\"
+.        \}
+.    rm an*help
+.    rr an*tmp
+.    \}
+.  \}
+.  if d an-msg \{\
+.    tm \*an: ignoring \*an-msg
+.    rr FT
+.    rm an-msg
+.  \}
+.\}
+.
+.\" hyphenation enablement
+.if !r HY \
+.  nr HY 1
+.
+.\" standard indentation
+.if !r IN \{\
+.  \" We select an integer indentation value in nroff mode because this
+.  \" value is used additively for multiple purposes; rounding of
+.  \" accumulating fractions would produce inconsistent results.
+.  ie t .nr IN 7.2n
+.  el   .nr IN 7n
+.\}
+.
+.\" line length
+.if !r LL \{\
+.  \" If in troff mode, respect device default.
+.  ie t .nr LL \n.l
+.  \" Otherwise, override nroff mode default of 65n.
+.  el   .nr LL 78n
+.\}
+.
+.\" title (header, footer) length
+.if !r LT \
+.  nr LT \nLLu
+.
+.\" starting page number
+.\"
+.\" Unlike most of these parameters, we do not set a default for P;
+.\" troff supplies a default starting page number (1).  When rendering
+.\" for the HTML output device, page numbers are concealed and used for
+.\" internal purposes like image embedding.  Page numbers are not
+.\" rendered at all in continuous rendering mode.
+.if r P \{\
+.  if \nan*is-output-html \
+.    if !(\nP = 1) \
+.      ds an-msg in HTML output\"
+.  if \ncR \
+.    ds an-msg when continuously rendering
+.\}
+.if d an-msg \{\
+.  tm \*an: ignoring starting page number \*an-msg
+.  rr P
+.  rm an-msg
+.\}
+.
+.\" Setting the page number turns out to be tricky when batch rendering
+.\" and switching macro packages.  We must use different techniques
+.\" depending on whether the transition to the first output page has
+.\" happened yet.  If it has not, `nl` will be `-1` and we use `pn`.  If
+.\" it has, we set `%`.  Technically this is fragile since in theory a
+.\" page could assign a negative value to `nl`.  We might then be
+.\" justified in saying they've broken the macro package and they get to
+.\" keep both pieces.  But if not, consider using a nonce register,
+.\" initially set but then permanently cleared adjacent to this logic,
+.\" and whose state is shared with mdoc (and andoc.tmac, if necessary).
+.\"
+.\" Also, we can't use the `P` register with grohtml at all.
+.ie r ps4html \{\
+.  if r P \{\
+.     tm \*an: ignoring starting page number in HTML output
+.     rr P
+.  \}
+.\}
+.el \{\
+.  if r P \{\
+.    ie (\nnl = -1) .pn 0\nP
+.    el               .nr % 0\nP
+.  \}
+.\}
+.
+.\" type size
+.if !r S \{\
+.  nr S 10
+.  if '\*.T'X75-12' \
+.    nr S 12
+.  if '\*.T'X100-12' \
+.    nr S 12
+.\}
+.
+.\" subsection indentation
+.if !r SN \
+.  nr SN 3n
+.
+.\" URI enablement desired
+.if !r U \
+.  nr U 1
+.
+.nr an*do-hyperlink 0
+.if (\nU & \nan*can-hyperlink) .nr an*do-hyperlink 1
+.
+.\" page number after which to apply letter suffixes
+.\"
+.\" Unlike most of these parameters, we do not set a default for X; only
+.\" the macro an-footer uses it.  Page numbers are not rendered at all
+.\" in continuous rendering mode.
+.if r X \{\
+.  af an-page-letter a
+.  if \nan*is-output-html \
+.    ds an-msg in HTML output\"
+.  if \ncR \
+.    ds an-msg when continuously rendering
+.\}
+.if d an-msg \{\
+.  tm \*an: ignoring page number suffix \*an-msg
+.  rr X
+.  rm an-msg
+.\}
+.
+.\" adjustment mode
+.if !d AD \
+.  ds AD b\"
+.
+.\" (sub)section heading font
+.if !d HF \
+.  ds HF B\"
+.
+.\" If HF is a bold style, use bold italics for italics in headings.
+.ds an-heading-style \*HF\"
+.substring an-heading-style -1 -1
+.ds an-heading-family \" empty
+.length an-HF-length \*HF
+.if (\nan-HF-length > 1) \{\
+.  as an-heading-family \*HF\"
+.  substring an-heading-family 0 -2
+.\}
+.if '\*an-heading-style'B' \
+.  if F \*an-heading-familyBI \
+.    nr an-remap-I-style-in-headings 1
+.rr an-HF-length
+.rm an-heading-style
+.
+.\" man page topic font
+.if !d MF \
+.  ds MF I\"
+.
+.\" Define italic correction strings.  Initially, they are empty.  If MF
+.\" is an oblique style, append the corrections.
+.ds an-lic \" left italic correction
+.ds an-ic \" italic correction
+.ds an*topic-style \*MF\"
+.substring an*topic-style -1 -1
+.if '\*an*topic-style'I' \{\
+.  as an-lic \,\"
+.  as an-ic \/\"
+.\}
+.rm an*topic-style
+.
+.if \ncR \
+.  an-set-up-continuous-rendering
+.
+.\" If rendering HTML, suppress headers and footers.
+.nr an-suppress-header-and-footer 0
+.if \nan*is-output-html .nr an-suppress-header-and-footer 1
+.if r ps4html             .nr an-suppress-header-and-footer 1
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_an_tmac_C
+.do rr *groff_an_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/andoc.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/andoc.tmac Changed

@@ -1,11 +1,11 @@
 .\" andoc.tmac
 .\"
-.\" Load either an-old.tmac or doc.tmac.  Multiple man pages can be
-.\" handled.
+.\" Load either an.tmac or doc.tmac.  Multiple man pages can be handled.
 .\"
 .\"
-.\" Copyright (C) 1991-2018 Free Software Foundation, Inc.
-.\"      Written by James Clark (jjc@jclark.com)
+.\" Copyright (C) 1991-2020 Free Software Foundation, Inc.
+.\"      Written by Werner Lemberg (wl@gnu.org),
+.\"      based on a patch from Tadziu Hoffmann.
 .\"
 .\" This file is part of groff.
 .\"
@@ -25,13 +25,14 @@
 .\"
 .
 .if !\n(.g \
-.  ab These macros require groff.
+.  ab andoc.tmac: macros require groff extensions; aborting
 .
-.nr _C \n(.C
+.do nr *groff_andoc_tmac_C \n.cp
 .cp 0
 .
 .als andoc-em em
 .als andoc-bp bp
+.als andoc-ne ne
 .
 .
 .\" We must not use '.de1' for 'reload-doc' or 'reload-man'!  'doc.tmac'
@@ -45,14 +46,24 @@
 .
 .
 .de reload-doc
-.  do ch an-header   \" remove trap set by an-old.tmac
-.  do ch an-footer   \" remove trap set by an-old.tmac
-.  do ch an-p-footer \" remove trap set by an-old.tmac
+.  \" Flush any partially collected output line and write page footer in
+.  \" continuous rendering mode.
+.  do if d an-end \
+.    do an-end
+.
+.  \" Remove traps planted by an.tmac.
+.  do ch an-header
+.  do ch an-break-body-text
+.  do ch an-footer
 .
 .  do als em andoc-em
 .  do als bp andoc-bp
-.  do rm Dd          \" disable load-only-once, see doc.tmac
+.  do als ne andoc-ne
+.  do blm            \" no blank line trap
+.  do lsm            \" no leading space trap
+.  em                \" no end-of-input trap
 .
+.  do rm Dd          \" force reinitialization of doc.tmac
 .  do mso doc.tmac
 .
 .  do als TH reload-man
@@ -61,18 +72,24 @@
 ..
 .
 .de reload-man
-.  do cp \n(.C       \" restore original compatibility mode
+.  \" Flush any partially collected output line and write page footer in
+.  \" continuous rendering mode.
+.  do if d doc-end-macro \
+.    do doc-end-macro
 .
-.  do ch header      \" remove trap set by doc.tmac
-.  do ch footer      \" remove trap set by doc.tmac
+.  \" Remove traps planted by mdoc/doc-{common,{n,dit}roff}.
+.  do ch doc-break-body-text
+.  do ch doc-header
+.  do ch doc-footer
 .
 .  do als em andoc-em
 .  do als bp andoc-bp
-.  do rm RI          \" disable load-only-once, see an-old.tmac
-.  do blm            \" no blank line macro
-.  do rm TH
+.  do als ne andoc-ne
+.  do blm            \" no blank line trap
+.  em                \" no end-of-input trap
 .
-.  do mso an-old.tmac
+.  do rm TH          \" force reinitialization of an.tmac
+.  do mso an.tmac
 .
 .  do als Dd reload-doc
 .
@@ -88,11 +105,8 @@
 .de EN
 ..
 .
-.cp \n_C
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_andoc_tmac_C
+.do rr *groff_andoc_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/composite.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/composite.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/cp1047.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/cp1047.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/cs.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/cs.tmac Changed

@@ -1,6 +1,6 @@
 .\" Czech localization for groff
 .\"
-.\" Copyright (C) 2007-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2007-2022 Free Software Foundation, Inc.
 .\"   Written by Marcela Ma¹láòová (mmaslano@redhat.com)
 .\"
 .\" This file is part of groff.
@@ -21,8 +21,17 @@
 .\"
 .\" Please send comments to mmaslano@redhat.com.
 .
+.do nr *groff_cs_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
 .
-.\" Locale string
 .
 .ds locale czech\"
 .
@@ -31,6 +40,7 @@
 .
 .ds \*locale-abstract ABSTRAKT\"
 .ds \*locale-app DODATEK\"
+.ds \*locale-appendix_string Dodatek\"
 .ds \*locale-april Duben\"
 .ds \*locale-attribute_string z\"
 .ds \*locale-august Øíjen\"
@@ -78,6 +88,15 @@
 .ds \*locale-litb Tabulka\"
 .ds \*locale-lt REJSTØÍK TABULEK\"
 .ds \*locale-lx REJSTØÍK DOKUMENTÙ\"
+.ds \*locale-man-section1 Manuál u¾ivatelských pøíkazù\"
+.ds \*locale-man-section2 Manuál systémových volání\"
+.ds \*locale-man-section3 Manuál funkcí knihovny\"
+.ds \*locale-man-section4 Manuál rozhraní jádra\"
+.ds \*locale-man-section5 Manuál pro formáty souborù\"
+.ds \*locale-man-section6 Herní manuál\"
+.ds \*locale-man-section7 Rùzné informaèní manuál\"
+.ds \*locale-man-section8 Manuál správce systému\"
+.ds \*locale-man-section9 Manuál vývojáøe jádra\"
 .ds \*locale-march Bøezen\"
 .ds \*locale-may Kvìten\"
 .ds \*locale-monday Pondìlí\"
@@ -108,7 +127,7 @@
 .	\" update the date
 .	ds DY \ndy \*MO \nyear
 .	\" set hyphenation flags
-.	nr HY 1
+.	nr HY 2
 .\}
 .
 .
@@ -133,20 +152,24 @@
 .\}
 .
 .
-.\" me package
-.if d @R \{\
-.	\" date update
-.	ds td \n(dy \*(mo \n(y4
-.\}
-.
-.
 .\" Default encoding
 .mso latin2.tmac
 .
+.ss 12 0
+.
+.\" Set up hyphenation.
 .
 .\" Czech hyphenation (\lefthyphenmin=2, \righthyphenmin=2)
-.ss 12 0
-.hy 1
+.nr \*locale*hyphenation-mode-base 1
+.nr \*locale*hyphenation-mode-trap 2
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
+.
 .hcode á á  Á á
 .hcode è è  È è
 .hcode ï ï  Ï ï
@@ -168,16 +191,24 @@
 .hpfa hyphenex.cs
 .
 .
-.\" man, mdoc and mdoc-old are intentionally left untouched: usually
-.\" these packages are translated in the sources of the documents.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \En(dy \E*(mo \En(y4
+.	ld
+.\}
+.
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_cs_tmac_C
+.do rr *groff_cs_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff
 .\" coding: latin-2
 .\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff textwidth=72:
+.\" vim: set fileencoding=iso-8859-2 filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/de.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/de.tmac Changed

@@ -1,6 +1,6 @@
 .\" German localization for groff
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2022 Free Software Foundation, Inc.
 .\"   Written by Werner Lemberg (wl@gnu.org)
 .\"
 .\" This file is part of groff.
@@ -21,8 +21,17 @@
 .\"
 .\" Please send comments to groff@gnu.org.
 .
+.do nr *groff_de_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
 .
-.\" Locale string
 .
 .ds locale german\"
 .
@@ -31,6 +40,7 @@
 .
 .ds \*locale-abstract Zusammenfassung\"
 .ds \*locale-app Anhang\"
+.ds \*locale-appendix_string Anhang\"
 .ds \*locale-april April\"
 .ds \*locale-attribute_string von\"
 .ds \*locale-august August\"
@@ -78,6 +88,15 @@
 .ds \*locale-litb Tabelle\"
 .ds \*locale-lt Verzeichnis der Tabellen\"
 .ds \*locale-lx Verzeichnis der Belege\"
+.ds \*locale-man-section1 Handbuch für allgemeine Befehle\"
+.ds \*locale-man-section2 Handbuch für Systemaufrufe\"
+.ds \*locale-man-section3 Handbuch zu Bibliotheksfunktionen\"
+.ds \*locale-man-section4 Handbuch zu Kernel-Schnittstellen\"
+.ds \*locale-man-section5 Handbuch zu Dateiformaten\"
+.ds \*locale-man-section6 Spielehandbuch\"
+.ds \*locale-man-section7 Sonstiges Informationshandbuch\"
+.ds \*locale-man-section8 Handbuch des Systemmanagers\"
+.ds \*locale-man-section9 Handbuch für Kernel-Entwickler\"
 .ds \*locale-march März\"
 .ds \*locale-may Mai\"
 .ds \*locale-monday Montag\"
@@ -108,7 +127,7 @@
 .	\" update the date
 .	ds DY \ndy.\~\*MO \nyear
 .	\" set hyphenation flags
-.	nr HY 1
+.	nr HY 2
 .\}
 .
 .
@@ -133,20 +152,23 @@
 .\}
 .
 .
-.\" me package
-.if d @R \{\
-.	\" date update
-.	ds td \n(dy.\~\*(mo.\& \n(y4
-.\}
-.
-.
 .\" Default encoding
 .mso latin1.tmac
 .
+.ss 12 0
+.
+.\" Set up hyphenation.
 .
 .\" German hyphenation (\lefthyphenmin=2, \righthyphenmin=2)
-.ss 12 0
-.hy 1
+.nr \*locale*hyphenation-mode-base 1
+.nr \*locale*hyphenation-mode-trap 2
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
 .
 .hcode ä ä  â â  à à  á á  ã ã  å å  æ æ
 .hcode ç ç
@@ -173,12 +195,20 @@
 .  hpf hyphen.det
 .
 .
-.\" man, mdoc and mdoc-old are intentionally left untouched: usually
-.\" these packages are translated in the sources of the documents.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \En(dy.\~\E*(mo.\& \En(y4
+.	ld
+.\}
+.
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_de_tmac_C
+.do rr *groff_de_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/den.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/den.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/devtag.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/devtag.tmac Changed

@@ -1,16 +1,13 @@
 .ig
 devtag.tmac - macro package for adding tags to roff documents.
 
-File position: <groff_source_top>/tmac/devtag.tmac
-Installed position: groff's main macro directory.
-
 ------------------------------------------------------------------------
     Legalese
 ------------------------------------------------------------------------
 
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2004-2018 Free Software Foundation, Inc.
+Copyright (C) 2004-2020 Free Software Foundation, Inc.
 written by Gaius Mulley <gaius@glam.ac.uk>.
 
 groff is free software; you can redistribute it and/or modify it under
@@ -31,20 +28,20 @@
     Description
 ------------------------------------------------------------------------
 
-A simple set of macros to provide markup devices (currently only grohtml)
-with tags that define the meaning of the formatted text and also
-basic formatting instructions.  It generalizes the tag concept used within
-grohtml and in the future it is hoped that more markup based devices
-can capitalize on this work.  It also clearly defines those tags which are
-honoured by grohtml.  Note that not all tags are included here.  Some
-of the grohtml specific tags (header specific and jobname, etc.) are
-called directly from within www.tmac.  The tags defined here are
-reasonably generic and could be applied to other devices.
+A simple set of macros to provide markup devices (currently only
+grohtml) with tags that define the meaning of the formatted text and
+also basic formatting instructions.  It generalizes the tag concept used
+within grohtml and in the future it is hoped that more markup based
+devices can capitalize on this work.  It also clearly defines those tags
+which are honoured by grohtml.  Note that not all tags are included
+here.  Some of the grohtml specific tags (header specific and jobname,
+etc.) are called directly from within www.tmac.  The tags defined here
+are reasonably generic and could be applied to other devices.
 ..
 .
 .do if d DEVTAG-NH .nx
 .
-.nr _C \n(.C
+.do nr *groff_devtag_tmac_C \n.cp
 .cp 0
 .
 .\" --------------------------------------------------------------------
@@ -52,7 +49,7 @@
 .\"
 .\"   Emit a tag <name>
 .\"
-.de DEVTAG
+.de1 DEVTAG
 .  tag devtag:\\$*
 ..
 .\" --------------------------------------------------------------------
@@ -60,7 +57,7 @@
 .\"
 .\"   When the troff state changes, emit tag <name>
 .\"
-.de DEVTAG-NEXT
+.de1 DEVTAG-NEXT
 .  taga devtag:\\$*
 ..
 .
@@ -71,7 +68,7 @@
 .\"       Takes a single parameter <level>. <level> 1
 .\"       is the outer most level.
 .
-.de DEVTAG-NH
+.de1 DEVTAG-NH
 .   DEVTAG ".NH \\$1"
 ..
 .als DEVTAG-SH DEVTAG-NH
@@ -81,7 +78,7 @@
 .\"     indicate that the following text is aligned for the column <n>
 .\"     n: 1..MAX(n)
 .
-.de DEVTAG-COL
+.de1 DEVTAG-COL
 .   DEVTAG ".col \\$1"
 ..
 .
@@ -89,21 +86,21 @@
 .\"  EO-H
 .\"     indicate that a header has finished.
 .
-.de DEVTAG-EO-H
+.de1 DEVTAG-EO-H
 .   DEVTAG ".eo.h"
 ..
 .\" --------------------------------------------------------------------
 .\"  EO-TL
 .\"     indicate that a title has finished.
 .
-.de DEVTAG-EO-TL
+.de1 DEVTAG-EO-TL
 .   DEVTAG ".eo.tl"
 ..
 .\" --------------------------------------------------------------------
 .\"  TL
 .\"     indicate that the following text forms a title.
 .
-.de DEVTAG-TL
+.de1 DEVTAG-TL
 .   DEVTAG ".tl"
 ..
 .
@@ -111,17 +108,14 @@
 .\"  COL-NEXT <n>
 .\"     emit a column tag just before the next glyph.
 .
-.de DEVTAG-COL-NEXT
+.de1 DEVTAG-COL-NEXT
 .   DEVTAG-NEXT ".col \\$1"
 ..
 .
 .
-.cp \n_C
-.
+.cp \n*groff_devtag_tmac_C
+.do rr *groff_devtag_tmac_C
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.23.0.tar.gz/tmac/doc-old.tmac Added

@@ -0,0 +1,1862 @@
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc-old.tmac	5.2 (Berkeley) 3/13/91
+.\"     Slightly modified by jjc@jclark.com to work with groff as well.
+.\"
+.\" Assume nroff on crt's only if cR==1
+.if n .nr cR 1
+.\"	STRING CONSTANTS
+.\" 	DITROFF
+.if t \{\
+.\"	Address Style
+.ds aD \fI
+.\"	Argument Reference Style
+.ds aR \f(CO
+.\"	Interactive Command Modifier (flag)
+.ds cM \f(CB
+.\"	Emphasis (in the English sense - usually italics)
+.ds eM \fI
+.\"	Errno Style
+.ds eR \fC
+.\"	Environment Variable Style
+.ds eV \fC
+.\"	Command Line Flag Style
+.ds fL \f(CB
+.\"	Header String Style
+.ds Hs \fR
+.\"	Interactive Command Style
+.ds iC \f(CB
+.\"	Literal Style
+.ds lI \fC
+.\"	Left Parenthesis Style
+.ds lP \fR\|(\|\fP
+.\"	Right Parenthesis Style
+.ds rP \fR\|)\|\fP
+.\"	Options Open Bracket Style
+.ds lB \fR\^\^\fP
+.\"	Options Open Bracket Style
+.ds rB \fR\^\fP
+.\"	Name (subject of manpage) Style
+.ds nM \f(CB
+.\"	Pathname Style
+.ds pA \fC
+.\"	Accepted punctuation string for -mdoc syntax
+.ds Pu \fR.,:;(\^)\^\fR
+.\"	Section Header Style
+.ds Sp \s12\fB
+.\" .ds sT \s-2\fR
+.\"	Symbolic Emphasis (boldface)
+.ds sY \f(CB
+.\"	Generic Variable Style
+.ds vA \fI
+.\"	Volume Title Style
+.ds Vs \fR
+.\"	Cross Reference STyle (man page only)
+.ds xR \fC
+.\"	Math *
+.tr *\(**
+.\}
+.\"	NROFF
+.if n \{\
+.\"	Address Style
+.ds aD \fI
+.\"	Argument Reference Style
+.ds aR \fI
+.\"	Interactive Command Modifier (flag)
+.ds cM \fB
+.\"	Emphasis (in the English sense - usually italics)
+.ds eM \fI
+.\"	Errno Style
+.ds eR \fR
+.\"	Environment Variable Style
+.ds eV \fR
+.\"	Command Line Flag Style
+.ds fL \fB
+.\"	Header String Style
+.ds Hs \fR
+.\"	Interactive Command Style
+.ds iC \fB
+.\"	Literal Style
+.ds lI \fR
+.\"	Left Parenthesis Style
+.ds lP \fR\|(\fP
+.\"	Right Parenthesis Style
+.ds rP \fR\|)\fP
+.\"	Options Open Bracket Style
+.ds lB \fR\|\|\fP
+.\"	Options Open Bracket Style
+.ds rB \fR\|\fP
+.\"	Name (subject of manpage) Style
+.ds nM \fB
+.\"	Pathname Style
+.ds pA \fI
+.\"	Accepted punctuation string for -mdoc syntax
+.ds Pu .,;:()
+.\"	Section Header Style
+.ds Sp \s12\fB
+.\"	.ds sT \s-2\fR
+.\" .ds sT \s-2\fR
+.\"	Symbol, Mode or Mask Style
+.ds sY \fB
+.\"	Generic Variable Style
+.ds vA \fI
+.\"	Volume Title Style
+.ds Vs \fR
+.\"	Cross Reference Style (man page only)
+.ds xR \fR
+.\}
+.\"	INDENTS - Subheaders(sI), Text(Ti) between Section Headers and Subsects
+.if t \{\
+.	nr sI \w'\fC,'u*5
+.	nr Ti \n(sIu
+.\}
+.if n \{\
+.	nr sI .5i
+.	nr Ti .5i
+.\}
+.\"	Flags for macros names which are used only for .Ds
+.nr dI 6n
+.nr dC 1
+.nr dL 1
+.nr dR 1
+.\"	INDENT WIDTHS (for Lists)
+.\"	Width Needed for Address Tag (indented amount)
+.nr Ad 12n
+.\"	Angle Quote Width
+.nr Aq 12n
+.\"	Width Needed for Argument
+.nr Ar 12n
+.\"	Width Needed for Column offset
+.nr Cl 15n
+.\"	Width needed for Interactive Command Modifier
+.nr Cm 10n
+.\"	Width Needed for Complex Expressions
+.nr Cx 20n
+.\"	Indent Width Needed for Display (right and left margins)
+.nr Ds 6n
+.\"	Double Quote Width
+.nr Dq 12n
+.\"	tI is dependent on Ds and used by .Dp
+.nr tI \n(Dsu
+.\"	Width Needed for Display
+.nr Em 10n
+.\"	Width Needed for Errno Types
+.nr Er 15n
+.\"	Width Needed for Environment Variables
+.nr Ev 15n
+.\"	Width Needed for Example Indent
+.nr Ex 10n
+.\"	Width Needed for Flag
+.nr Fl 10n
+.\"	Width Needed for Function
+.nr Fn 16n
+.\"	Width needed for Interactive Command Name
+.nr Ic 10n
+.\"	Width Needed for Constant
+.nr Li 16n
+.\"	Width Needed for Math Symbol ? not sure if needed
+.nr Ms 6n
+.\"	Width Needed for Name
+.nr Nm 10n
+.\"	Width Needed for Option Begin
+.nr Ob 14n
+.\"	Width Needed for Option End
+.nr Oe 14n
+.\"	Width Needed for Option (one line)
+.nr Op 14n
+.\"	Width Needed for Pathname
+.nr Pa 32n
+.\"	Parenthesis Quote Width
+.nr Pq 12n
+.\"	Single Quote Width
+.nr Sq 12n
+.\"	Width Needed for Symbols, Modes or Masks
+.nr Sy 6n
+.\"	Width needed for default or unknown text width
+.nr Tx 22n
+.\"	Width Needed for Generic Variable
+.nr Va 12n
+.\"	Width Needed for Cross Reference, should the cross ref be annotated.
+.nr Xr 10n
+.\" PARAGRAPH SPACE
+.if t \{\
+.	nr Pp .5v
+.\}
+.if n \{\
+.	nr Pp 1v
+.\}
+.\"	PAGE LAYOUT
+.\" .Li Tagged Paragraph Style - zero if break on oversized tag
+.\" one if add em space and continue filling line.
+.nr tP 0
+.\" Page Layout Macro
+.de pL
+.\"	DITROFF
+.ie t \{\
+.\" Header Margin
+.	nr Hm .5i
+.\" Footer Margin
+.	nr Fm .5i
+.\" Line length
+.	nr ll 5.5i
+.\" Line length
+.	ll 5.5i
+.\" Title length
+.	nr lt 5.5i
+.\" Title length
+.	lt 5.5i
+.\" Page offset
+.	nr po 1.56i
+.\" Page offset
+.	po 1.56i
+.\" Vertical space distance (from Section headers/Lists/Subsections)
+.	nr vV .5v
+.\" em space
+.	ds tP \|\|\|\|\|\|
+.\}
+.el \{\
+.\" Line length
+.	nr ll 78n
+.	ll 78n
+.\" Title length
+.	nr lt 78n
+.\" Title length
+.	lt 78n
+.\" Page offset
+.	nr po 0i
+.\" Page offset
+.	po 0i
+.\" Vertical space distance (from Section headers/Lists/Subsections)
+.	nr vV 1v
+.\" em space
+.	ds tP \0\0
+.\" Test for crt
+.	ie \\n(cR .nr Hm 0
+.	el .nr Hm .5i
+.\" Footer Margin
+.	nr Fm .5i
+.\}
+..
+.\" Adjustment mode
+.if n \{\
+.ad l
+.na
+..
+.\}
+.\" PREDEFINED STRINGS
+.if t \{\
+.	ds <= \(<=
+.	ds >= \(>=
+.	ds Lq \&``
+.	ds Rq \&''
+.	ds ua \(ua
+.	ds aa \(aa
+.	ds ga \(ga
+.	ds sR \(aa
+.	ds sL \(ga
+.\}
+.if n \{\
+.	ds <= \&<\&=
+.	ds >= \&>\&=
+.       ds Rq ''
+.       ds Lq ``
+.	ds ua ^
+.	ds aa '
+.	ds ga `
+.	ds sL `
+.	ds sR '
+.\}
+.\" Note: The distances from the bottom or top of the page are set
+.\" in headers (macro .hK): to -1.25 for troff, and -1.167 for nroff
+.\" bottoms, and top is 0.
+.\"
+.\"	.Dt Document/manpage_title section/chapter volume
+.\"		The \{ and \} is necessary as roff doesn't nest if-elses
+.\"		properly, especially with .ds.
+.\"	TODO: separate Dt into Dt, Ch and Vt for supp docs.
+.de Dt
+.ds dT UNTITLED
+.ds vT Local
+.ds cH Null
+.\" 	Volume and Section Number or Chapter Number
+.if !"\\$1"" .ds dT \\$1
+.if !"\\$2"" \{\
+.	ds cH \\$2
+.	if "\\$3"" \{\
+.		\" Volume Title if none given
+.		if \\$2>=1 .if \\$2<=8 \{\
+.			ds vT UNIX Reference Manual
+.			if \\$2>1 .if \\$2<6 .ds vT UNIX Programmer's Manual
+.			if "\\$2"8" .ds vT UNIX System Manager's Manual
+.		\}
+.		if "\\$2"unass"  .ds vT DRAFT
+.		if "\\$2"draft"  .ds vT DRAFT
+.		if "\\$2"paper"  .ds vT Null
+.	\}
+.\}
+.if !"\\$3"" \{\
+.	\" Volume Title if given
+.	if "\\$3"USD"   .ds vT UNIX User's Supplementary Documents
+.	if "\\$3"PS1"   .ds vT UNIX Programmers's Supplementary Documents
+.	if "\\$3"AMD"   .ds vT UNIX Ancestral Manual Documents
+.	if "\\$3"SMM"   .ds vT UNIX System Manager's Manual
+.	if "\\$3"URM"   .ds vT UNIX Reference Manual
+.	if "\\$3"PRM"   .ds vT UNIX Programmers's Manual
+.	if "\\$3"IND"   .ds vT UNIX Manual Master Index
+.	if "\\$3"CON"   .ds vT UNIX Contributed Software Manual
+.	if "\\$3"IMP"	.ds vT UNIX Implementation Notes
+.	if "\\$3"HOW"	.ds vT UNIX How Pocket Manual
+.	if "\\$3"LOCAL" .ds vT UNIX Local Manual
+.	if "\\*(vT"Local" .ds vT \\$3
+.\}
+..
+.\"
+.\"	.Os Operating System/Standard and Release or Version Number
+.\"
+.de Os
+.ds oS Null
+.if "\\$1"" \{\
+.	ds oS \fIBSD Experimental\fP
+.\" .	ds oS (\fIBag o' Bits\fP)
+.\}
+.if "\\$2"" \{\
+.	ds o1 Non-Null
+.\}
+.if "\\$1"ATT"   \{\
+.	ds oS AT&T
+.	if "\\$2""    .as oS \0UNIX
+.	if "\\$2"7th" .as oS \07th Edition
+.	if "\\$2"7"   .as oS \07th Edition
+.	if "\\$2"III" .as oS \0System III
+.	if "\\$2"3"   .as oS \0System III
+.	if "\\$2"V"   .as oS \0System V
+.	if "\\$2"V.2" .as oS \0System V Release 2
+.	if "\\$2"V.3" .as oS \0System V Release 3
+.	if "\\$2"V.4" .as oS \0System V Release 4
+.\}
+.if "\\$1"BSD" \{\
+.	if "\\$2"3"    .ds oS 3rd Berkeley Distribution
+.	if "\\$2"4"    .ds oS 4th Berkeley Distribution
+.	if "\\$2"4.1"  .ds oS 4.1 Berkeley Distribution
+.	if "\\$2"4.2"  .ds oS 4.2 Berkeley Distribution
+.	if "\\$2"4.3"  .ds oS 4.3 Berkeley Distribution
+.	if "\\$2"4.3+" .ds oS 4.3+tahoe Berkeley Distribution
+.\}
+.if "\\*(oS"Null" .ds oS \\$1
+.if "\\*(o1"Non-Null" .as oS \0\\$2
+.rm o1
+..
+.\"
+.\" Standards
+.\"
+.\" .de St
+.\" .ds sT Null
+.\" .if "\\$1"POSIX" \{\
+.\" .	ds sT IEEE Standard POSIX
+.\" .	if \\$2 .as sT \0\\$2
+.\" .\}
+.\" .if "\\$1"ANSI" \{\
+.\" .	ds sT ANSI Standard
+.\" .	if \\$2 .as sT \0\\$2
+.\" .\}
+.\" .if "\\$1"ISO" \{\
+.\" .	ds sT ISO Standard
+.\" .	if \\$2 .as sT \0\\$2
+.\" .\}
+.\" .if "\\*(sT"Null" .ds sR \\$3
+.\" ..
+.\"
+.\" .de Gp
+.\" .ie !"\\$1"" .ds gP \&\\$1 \\$2 \\$3 \\$4 \\$5
+.\" .el .ds gP Null
+.\" ..
+.\"
+.\"
+.de Dd
+.nr aa 0
+.ie \\n(.$>0 \{\
+.	ie \\n(.$<4 \{\
+.		ds dD \\$1 \\$2 \\$3
+.	\}
+.	el .tm Usage: .Dd Month Day, Year (e.g July 4, 1977).
+.\}
+.el \{\
+.	ds dD Epoch
+.\}
+..
+.\"
+.\"	House Keeping Macro - Make sense of dT, cH, vT, sT, gP and dS
+.\"	TODO: Try to get else's for efficiency
+.\"	TODO: GET RID OF .wh -1.167i (its in v7)
+.\"
+.\"
+.de hK
+.nr % 1
+.ds hT \\*(dT
+.if !"\\*(cH"Null" \{\
+.	ie !"\\*(gP"Null" .as hT \|(\|\\*(cH\\*(gP\|)
+.	el .as hT \\|(\\|\\*(cH\\|)
+.\}
+.if "\\*(cH"Null" .if !"\\*(gP"Null" .as hT \&\|(\|\\*(gP\|)
+.if t \{\
+.	wh 0 hM
+.	wh -1.25i fM
+.\}
+.if n \{\
+.	ie \\n(cR \{\
+.		hM
+.		wh -0v fM
+.	\}
+.	el \{\
+.		wh 0 hM
+.		wh -1.167i fM
+.	\}
+.\}
+.if n \{\
+.	if \\n(nl==0:\\n(nl==-1 'bp
+.\}
+.if t 'bp
+.em lM
+..
+.\"	Header Macro
+.\"
+.de hM
+.ev 1
+.pL
+.if !\\n(cR 'sp \\n(Hmu
+.tl @\\*(Hs\\*(hT\fP@\\*(Vs\\*(vT\fP@\\*(Hs\\*(hT\fP@
+'sp \\n(Hmu
+.ev
+..
+.\"
+.de fM
+.ev 1
+.pL
+.if !\\n(cR \{\
+'	sp \\n(Fmu
+.	tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
+'	bp
+.\}
+.if \\n(cR \{\
+.\" .	tl @\\*(Hs\\*(oS\fP@\\*(Vs\\*(dD\fP@%@
+.\" '	bp
+.\}
+.ev
+..
+.de lM
+.fl
+.if \\n(cR \{\
+.       fM
+.       pl \\n(nlu
+.\}
+..
+.de Pp
+.sp \\n(Ppu
+.ne 2
+.ns
+..
+.de Lp
+.Pp
+..
+.de LP
+.tm Not a \-mdoc command: .LP
+..
+.de PP
+.tm Not a \-mdoc command: .PP
+..
+.de pp
+.tm Not a \-mdoc command: .pp
+..
+.de Co
+.tm Not a \-mdoc command: .Co
+..
+.nr z. 1
+.nr z, 1
+.nr z: 1
+.nr z; 1
+.nr z) 1
+.nr z( 1
+.nr z 1
+.nr z 1
+.\" This is disgusting, troff not parse if stmt properly
+.nr z1 0
+.nr z2 0
+.nr z3 0
+.nr z4 0
+.nr z5 0
+.nr z6 0
+.nr z7 0
+.nr z8 0
+.nr z9 0
+.nr z0 0
+.nr z# 0
+.\"
+.de Ad
+.ie \\n(.$==0 \{\
+.       tm Usage: .Ad address ... \\*(Pu
+.\}
+.el \{\
+.       ds sV \\*(aD
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.\" Command Line Argument Macro
+.\"
+.de Ar
+.ie \\n(.$==0 \{\
+.       ie !"\\*(iM"" .as f1 \&\|\\*(aRfile\ ...\fP\|
+.       el \&\|\\*(aRfile\ ...\fP\|
+.\}
+.el \{\
+.       ds sV \\*(aR
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Em
+.ie \\n(.$==0 \{\
+.       tm Usage: .Em text ... \\*(Pu
+.\}
+.el \{\
+.       ds sV \\*(eM
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Er
+.ie \\n(.$==0 \{\
+.       tm Usage: .Er ERRNOTYPE ... \\*(Pu
+.       \}
+.el \{\
+.       ds sV \\*(eR
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Ev
+.ie \\n(.$==0 \{\
+.	tm Usage: .Ev ENVIRONMENT_VARIABLE(s) ... \\*(Pu
+.	\}
+.el \{\
+.	ds sV \\*(eV
+.	nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	ft \\n(cF
+.\}
+..
+.\"
+.\" Flag Name Macro
+.\"
+.de Fl
+.ie \\n(.$==0 \{\
+.       ie !"\\*(iM"" .as f1 \&\\*(fL\-\fP
+.       el \&\\*(fL\-\fP
+.\}
+.el \{\
+.       nr rZ 0
+.       sW \\$1
+.       if (\\n(sW==1&\\n(.$==1) .rZ \\$1
+.       ds sV \\*(fL
+.       nr cF \\n(.f
+.       ie \\n(rZ \{\
+.               ie "\\*(iM"" .ds f1 \&\\*(sV\-\f\\n(cF\\$1
+.               el \&\\*(sV\-\f\\n(cF\\$1
+.       \}
+.	el \{\
+.	       ie "\\*(iM"" .ds f1 \&\\*(sV
+.	       el .as f1 \&\\*(sV
+.	       fB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	       ft \\n(cF
+.	\}
+.\}
+..
+.\"	Interactive Commands Macro
+.\"
+.de Ic
+.ie \\n(.$==0 \{\
+.	tm Usage: .Ic Interactive Commands(s) ... \\*(Pu
+.\}
+.el \{\
+.       ds sV \\*(iC
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.\" Interactive Command Modifiers (flags)
+.\"
+.de Cm
+.ie \\n(.$==0 \{\
+.	tm Usage: .Cm Interactive Command Modifier(s) ... \\*(Pu
+.\}
+.el \{\
+.       ds sV \\*(cM
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Li
+.ie \\n(.$==0 \{\
+.       tm Usage: .Li literal ... \\*(Pu
+.       \}
+.el \{\
+.       ds sV \\*(lI
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\" If in nroff or any other case where the default font
+.\" is constant width, and literal means zilch, single quote instead.
+.ie n \{\
+.de Ql
+.	ie \\n(.$==0 \{\
+.	       tm Usage: .Ql literal ... \\*(Pu
+.       \}
+.	el \{\
+.		Sq \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+..
+.\}
+.el \{\
+.de Ql
+.	ie \\n(.$==0 \{\
+.	       tm Usage: .Ql literal ... \\*(Pu
+.       \}
+.	el \{\
+.		Li \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+..
+.\}
+.\"
+.de Nm
+.ie \\n(.$==0 \{\
+.	if "\\*(n1"" .tm Usage: .Nm Name(s) ... \\*(Pu
+.	ie !"\\*(iM"" .as f1 \&\\*(nM\\*(n1\\$1\fP
+.	el \&\\*(nM\\*(n1\\$1\fP
+.\}
+.el \{\
+.	ds sV \\*(nM
+.	nr cF \\n(.f
+.	if \\n(nS \{\
+.		rs
+.		in -\\n(iSu
+.		ie \\n(nS>1 .br
+.		el \{\
+.			sW \\$1
+.			nr iS ((\\n(sW+1)*\\n(fW)u
+.		\}
+.		in +\\n(iSu
+.		ti -\\n(iSu
+.		nr nS \\n(nS+1
+.	\}
+.	if "\\*(n1"" .ds n1 \\$1
+.	ie "\\*(iM"" .ds f1 \&\\*(sV
+.	el .as f1 \&\\*(sV
+.	nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	ft \\n(cF
+.\}
+..
+.\"
+.de Pa
+.ie \\n(.$==0 \{\
+\&\\*(pA~\fP
+.\}
+.el \{\
+.       ds sV \\*(pA
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Sy
+.ie \\n(.$==0 \{\
+.       tm Usage: .Sy Symbolic Text ... \\*(Pu
+.       \}
+.el \{\
+.       ds sV \\*(sY
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Ms
+.ie \\n(.$==0 \{\
+.       tm Usage: .Ms Math Symbol ... \\*(Pu
+.       \}
+.el \{\
+.       ds sV \\*(sY
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de Va
+.ie \\n(.$==0 \{\
+.       tm Usage: .Va variable_name(s) ... \\*(Pu
+.\}
+.el \{\
+.       ds sV \\*(vA
+.       nr cF \\n(.f
+.       ie "\\*(iM"" .ds f1 \&\\*(sV
+.       el .as f1 \&\\*(sV
+.       nB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ft \\n(cF
+.\}
+..
+.\"
+.de nB
+.hy 0
+.if \\n(.$==0 .tm Usage error: called with empty arguments (empty quotes)?
+.ie \\n(.$>1 \{\
+.	rZ \\$1
+.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1\fP
+.	el .as f1 \&\\$1
+.	rZ \\$2
+.	if !\\n(rZ \{\
+.		ie !"\\*(iM""\{\
+.\"			I surrender
+.			if "\\*(iM"Tp" .as f1 \&\ \&
+.			if "\\*(iM"Dp" .as f1 \&\ \&
+.			if "\\*(iM"Op" .as f1 \&\ \&
+.			if "\\*(iM"Cx" .as f1 \&\ \&
+.			if "\\*(iM"Dq" .as f1 \& \&
+.			if "\\*(iM"Sq" .as f1 \& \&
+.			if "\\*(iM"Pq" .as f1 \& \&
+.			if "\\*(iM"Aq" .as f1 \& \&
+.		\}
+.		el .as f1 \& \&
+.	\}
+.	nB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.\}
+.el \{\
+.	rZ \\$1
+.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1
+.	el .as f1 \&\\$1\f\\n(cF
+.	if "\\*(iM"" \{\&\\*(f1
+.		ds f1
+.	\}
+.	hy
+.\}
+..
+.de fB
+.hy 0
+.if \\n(.$==0 .tm Usage error: called with empty arguments (empty quotes)?
+.ie \\n(.$>1 \{\
+.	rZ \\$1
+.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1\fP
+.	el \{\
+.		ie "\\$1"-" .as f1 \&\-\-
+.		el .as f1 \&\-\\$1
+.	\}
+.	rZ \\$2
+.	if !\\n(rZ \{\
+.		ie !"\\*(iM""\{\
+.\"			I surrender
+.			if "\\*(iM"Tp" .as f1 \&\ \&
+.			if "\\*(iM"Dp" .as f1 \&\ \&
+.			if "\\*(iM"Op" .as f1 \&\ \&
+.			if "\\*(iM"Cx" .as f1 \&\ \&
+.			if "\\*(iM"Dq" .as f1 \& \&
+.			if "\\*(iM"Sq" .as f1 \& \&
+.			if "\\*(iM"Pq" .as f1 \& \&
+.			if "\\*(iM"Aq" .as f1 \& \&
+.		\}
+.		el .as f1 \& \&
+.	\}
+.	fB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.\}
+.el \{\
+.	rZ \\$1
+.	ie \\n(rZ .as f1 \&\f\\n(cF\\$1
+.	el \{\
+.		ie "\\$1"-" .as f1 \&\-\-\f\\n(cF
+.		el .as f1 \&\-\\$1\f\\n(cF
+.	\}
+.	if "\\*(iM"" \{\&\\*(f1
+.		ds f1
+.	\}
+.	hy
+.\}
+..
+.\"
+.\" Single quoted Items
+.\" eF, sB g0-9 and f2
+.de Sq
+.nr eF 0
+.ie \\n(.$==0 \{\
+.       ie "\\*(iM"" \&\\*(sL\&\\*sR
+.       el .as f1 \&\\*(sL\&\\*(sR
+.\}
+.el \{\
+.       ie "\\*(iM"" \{\
+.		ds f1 \&\\*(sL
+.		ds iM Sq
+.	\}
+.       el .as f1 \&\\*(sL
+.       sB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	ie \\n(eF>0 .\\*(g1 \\*(g2 \\*(g3 \\*(g4 \\*(g5 \\*(g6 \\*(g7 \\*(g8
+.	el .as f1 \\*(g0
+.	as f1 \\*(sR
+.	if !"\\*(f2"" .as f1 \\*(f2
+.	if "\\*(iM"Sq" \{\
+\&\\*(f1
+.		ds f1
+.		ds iM
+.	\}
+.	ds f2
+.	rm  g0 g1 g2 g3 g4 g5 g6 g7 g8 g9
+.	nr eF 0
+.\}
+..
+.\"
+.\" Double quoted Items
+.de Dq
+.nr Ef 0
+.ie \\n(.$==0 \{\
+.       ie "\\*(iM"" \&\\*(Lq\&\\*(Rq
+.       el .as f1 \&\\*(Lq\&\\*(Rq
+.\}
+.el \{\
+.       ie "\\*(iM"" \{\
+.               ds f1 \&\\*(Lq
+.               ds iM Dq
+.       \}
+.       el .as f1 \&\\*(Lq
+.       Sb \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ie \\n(Ef>0 .\\*(k1 \\*(k2 \\*(k3 \\*(k4 \\*(k5 \\*(k6 \\*(k7 \\*(k8
+.       el .as f1 \\*(k0
+.       as f1 \\*(Rq
+.       if !"\\*(f4"" .as f1 \\*(f4
+.       if "\\*(iM"Dq" \{\
+\&\\*(f1
+.               ds f1
+.               ds iM
+.       \}
+.       ds f4
+.       rm  k0 k1 k2 k3 k4 k5 k6 k7 k8 k9
+.       nr Ef 0
+.\}
+..
+.\"
+.\" Parenthesis quoted Items
+.de Pq
+.nr pQ 0
+.ie \\n(.$==0 \{\
+.       ie "\\*(iM"" \&(\&)
+.       el .as f1 \&(\&)
+.\}
+.el \{\
+.       ie "\\*(iM"" \{\
+.               ds f1 \&(
+.               ds iM Pq
+.       \}
+.       el .as f1 \&(
+.       pB \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       ie \\n(pQ>0 .\\*(y1 \\*(y2 \\*(y3 \\*(y4 \\*(y5 \\*(y6 \\*(y7 \\*(y8
+.       el .as f1 \\*(y0
+.       as f1 \&)
+.       if !"\\*(f3"" .as f1 \\*(f3
+.       if "\\*(iM"Pq" \{\
+\&\\*(f1
+.               ds f1
+.               ds iM
+.       \}
+.       ds f3
+.       rm  y0 y1 y2 y3 y4 y5 y6 y7 y8 y9
+.       nr pQ 0
+.\}
+..
+.\" eF, sB g0-9 and f2
+.de sB
+.hy 0
+.ie \\n(.$==0 .tm Sick Logic: macro sB
+.el \{\
+.	ie \\n(eF>=1 .nr eF \\n(eF+1
+.	el \{\
+.		mN \\$1
+.		if \\n(mN .nr eF \\n(eF+1
+.	\}
+.       rZ \\$1
+.       ie \\n(rZ .as f2 \\$1
+.       el \{\
+.		ie \\n(eF<1 .as g\\n(eF \\$1
+.		el .as g\\n(eF \\$1
+.	\}
+.       if \\n(.$>1 \{\
+.		rZ \\$2
+.	        if \\n(rZ==0 \{\
+.			if \\n(eF<1 \{\
+.				as g\\n(eF \& \&
+.			\}
+.		\}
+.		sB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+.\}
+..
+.de Sb
+.hy 0
+.ie \\n(.$==0 .tm Sick Logic: macro Sb
+.el \{\
+.       ie \\n(Ef>=1 .nr Ef \\n(Ef+1
+.	el \{\
+.		mN \\$1
+.	        if \\n(mN .nr Ef \\n(Ef+1
+.	\}
+.       rZ \\$1
+.       ie \\n(rZ .as f4 \\$1
+.       el \{\
+.               ie \\n(Ef<1 .as k\\n(Ef \\$1
+.               el .as k\\n(Ef \\$1
+.       \}
+.       if \\n(.$>1 \{\
+.               rZ \\$2
+.               if \\n(rZ==0 \{\
+.                       if \\n(Ef<1 \{\
+.                               as k\\n(Ef \& \&
+.                       \}
+.               \}
+.               Sb \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       \}
+.\}
+..
+.de pB
+.hy 0
+.ie \\n(.$==0 .tm Sick Logic: macro pB
+.el \{\
+.       ie \\n(pQ>=1 .nr pQ \\n(pQ+1
+.       el \{\
+.               mN \\$1
+.               if \\n(mN .nr pQ \\n(pQ+1
+.       \}
+.       rZ \\$1
+.       ie \\n(rZ .as f3 \\$1
+.       el \{\
+.               ie \\n(pQ<1 .as y\\n(pQ \\$1
+.               el .as y\\n(pQ \\$1
+.       \}
+.       if \\n(.$>1 \{\
+.               rZ \\$2
+.               if \\n(rZ==0 \{\
+.                       if \\n(pQ<1 \{\
+.                               as y\\n(pQ \& \&
+.                       \}
+.               \}
+.               pB \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       \}
+.\}
+..
+.de aQ
+.hy 0
+.ie \\n(.$==0 .tm Bad Syntax: .Aq
+.el \{\
+.       ie \\n(aQ>=1 .nr aQ \\n(aQ+1
+.       el \{\
+.               mN \\$1
+.               if \\n(mN .nr aQ \\n(aQ+1
+.       \}
+.       rZ \\$1
+.       ie \\n(rZ .as aZ \\$1
+.       el \{\
+.               ie \\n(aQ<1 .as a\\n(aQ \\$1
+.               el .as a\\n(aQ \\$1
+.       \}
+.       if \\n(.$>1 \{\
+.               rZ \\$2
+.               if \\n(rZ==0 \{\
+.                       if \\n(aQ<1 \{\
+.                               as a\\n(aQ \& \&
+.                       \}
+.               \}
+.               aQ \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.       \}
+.\}
+..
+.\" Angle Bracket Quoted Items
+.de Aq
+.nr aQ 0
+.ie \\n(.$==0 \{\
+.       ie "\\*(iM"" \&<\&>
+.       el .as f1 \&<\&>
+.\}
+.el \{\
+.       ie "\\*(iM"" \{\
+.               ds f1 \&<
+.               ds iM Aq
+.       \}
+.       el .as f1 \&<
+.       aQ \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+.       ie \\n(aQ>0 .\\*(a1 \\*(a2 \\*(a3 \\*(a4 \\*(a5 \\*(a6 \\*(a7 \\*(a8
+.       el .as f1 \\*(a0
+.       as f1 \&>
+.       if !"\\*(aZ"" .as f1 \\*(aZ
+.       if "\\*(iM"Aq" \{\
+\&\\*(f1
+.               ds f1
+.               ds iM
+.       \}
+.       ds aZ
+.       rm  a0 a1 a2 a3 a4 a5 a6 a7 a8
+.       nr aQ 0
+.\}
+..
+.\" macro Name test, return macro register value if true
+.if \n(.g .ig
+.de mN
+.nr mN 0
+.sW \\$1
+.if \\n(sW==2 \{\
+.	if \\n(\\$1 .nr mN \\n(\\$1
+.\}
+..
+.if !\n(.g .ig
+.de mN
+.nr mN 0
+.if \A'\\$1' \{\
+.	sW \\$1
+.	if \\n(sW==2 \{\
+.		if \\n(\\$1 .nr mN \\n(\\$1
+.	\}
+.\}
+..
+.\" Punctuation test (using z registers), return 1 if true
+.if \n(.g .ig
+.de rZ
+.nr rZ 0
+.sW \\$1
+.if \\n(sW==1 \{\
+.	if \\n(z\\$1==1 \{\
+.		nr rZ 1
+.	\}
+.\}
+..
+.if !\n(.g .ig
+.de rZ
+.nr rZ 0
+.if \A'\\$1' \{\
+.	sW \\$1
+.	if \\n(sW==1 \{\
+.		if \\n(z\\$1==1 \{\
+.			nr rZ 1
+.		\}
+.	\}
+.\}
+..
+.\"
+.\" sW returns number of characters in a string
+.if t \{\
+.nr fW \w'\fC,'
+.de sW
+.nr sW \w'\fC\\$1'
+.\}
+.if n \{\
+.nr fW \w'0'
+.de sW
+.nr sW \w'\\$1'
+.\}
+.ie \\n(sW>=\\n(fW \{\
+.	ie \\n(sW%\\n(fW .nr sW (\\n(sW/\\n(fW)+1
+.	el .nr sW \\n(sW/\\n(fW
+.\}
+.el .nr sW 0
+..
+.\"	Option Expression -
+.\"	TODO - add line overflow check (right!)
+.nr eP 0
+.ds e1
+.nr oE 0
+.nr hP 0
+.ds hP
+.nr Ep 0
+.de Op
+.hy 0
+.if "\\*(iM"" \{\
+.	ds iM Op
+.       ds f1 \&
+.\}
+.as f1 \&\\*(lB
+.\" .tm Op:  \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.dO \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.ie !"\\$1"Cx" .oE
+.el .nr oE \\n(oE+1
+..
+.\"
+.\" just for mike, with every bite of garlic in mind (oops, i mean burp).
+.\" dO: go dOwn an argument vector and test each argument to see if
+.\" a macro name or punctuation. stash in respective place along
+.\" with its arguments.
+.nr oO 0
+.nr oP 0
+.nr aO 0
+.de dO
+.mN \\$1
+.ie \\n(mN \{\
+.       if \\n(oP  \{\
+.               if \\n(hP \{\
+.                       nr oZ 1
+.                       oZ
+.                       Oz
+.               \}
+.               if \\n(e1==1 \{\
+.\\*(e1 \\*(e2 \\*(e3 \\*(e4 \\*(e5 \\*(e6 \\*(e7 \\*(e8 \\*(e9
+.               \}
+.               uO
+.		if !(\\n(oO:\\n(aO) .as f1 \& \&
+.	\}
+.       ie "\\$1"Op" \{\
+.               as f1 \&\\*(lB
+.               nr aO \\n(aO+1
+.       \}
+.	el \{\
+.               nr eP \\n(eP+1
+.               ds e\\n(eP \\$1
+.               nr e\\n(eP 1
+.       \}
+.\}
+.el \{\
+.\" .tm dO: $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(ePEE
+.	rZ \\$1
+.	ie \\n(rZ \{\
+.\" .tm dO:rZ: $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(eP
+.		nr hP \\n(hP+1
+.		ds h\\n(hP \\$1
+.	\}
+.	el \{\
+.\" .tm dO:word $1: \\$1: eP \\n(eP e\\n(eP: \\*(e\\n(ePEE
+.		if \\n(eP==0:\\n(e\\n(eP==1 .nr eP \\n(eP+1
+.		if \\n(eZ .as e\\n(eP \& \&
+.		as e\\n(eP " \&\\$1
+.\" .		ds e\\n(eP \&\\$1
+.		nr eZ \\n(eZ+1
+.	\}
+.\}
+.nr oP 1
+.ie \\n(.$>1 \{\
+.	dO \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.\}
+.el \{\
+.     ie \\n(e1 \{\
+.\\*(e1 \\*(e2 \\*(e3 \\*(e4 \\*(e5 \\*(e6 \\*(e7 \\*(e8 \\*(e9
+.	\}
+.     el \{\
+.	as f1 \\*(e1
+.	\}
+.\}
+..
+.\" handle old style arguments such as the arg -Idir
+.\" in adb, .Oo is a toggle.
+.de Oo
+.ie \\n(oO .nr oO 0
+.el .nr oO 1
+..
+.\" stash punctuation
+.de oZ
+.if \\n(hP>=\\n(oZ \{\
+.	nr eP \\n(eP+1
+.	ds e\\n(eP \\*(h\\n(oZ
+.	nr oZ \\n(oZ+1
+.	oZ
+.\}
+..
+.\" clean up punctuation vector
+.de Oz
+.if \\n(hP>0 \{\
+.	rm h\\n(hP
+.	nr hP \\n(hP-1
+.	Oz
+.\}
+..
+.\" uO: go back up created vector cleaning it up along the way
+.de uO
+.if \\n(eP>0 \{\
+.	rm e\\n(eP
+.	rr e\\n(eP
+.	nr eP \\n(eP-1
+.	nr oP 0
+.	nr eZ 0
+.	uO
+.\}
+..
+.\" option end
+.de oE
+.uO
+.ie \\n(hP \{\
+.       as f1 \\*(rB\\*(h1\\*(h2\\*(h3
+.	Oz
+.	nr oZ 0
+.\}
+.el \{\
+.	as f1 \\*(rB
+.\}
+.ie "\\*(iM"Op" \{\
+.	if \\n(aO .aO
+.if t \{\
+.	if (\\n(.lu-\\n(.ku-\\n(.ou-(2*\\n(fWu))<\w'\fC\\*(f1'u .br
+.\}
+.if n \{\
+.	nr aa \w'\\*(f1'u
+.\" .	nr qq \\n(.lu-\\n(.ku-\\n(.ou
+.\" \&aa == \\n(aa, f1==\\*(f1, qq==\\n(qq
+.	if (\\n(.lu-\\n(.ku-\\n(.ou-\\n(aau)<=(8*\\n(fWu) .br
+.\}
+\&\\*(f1
+.	ds iM
+.	ds f1
+.	hy
+.\}
+.el .nr oE \\n(oE-1
+..
+.de aO
+.as f1 \\*(rB
+.nr aO \\n(aO-1
+.if \\n(aO >0 .aO
+..
+.\"
+.de Xr
+.if \\n(.$<=1 \{\
+.	ie \\n(.$==1 \{\
+.		if !"\\*(iM"" .as f1 \&\\*(xR\\$1\fP
+.		if "\\*(iM"" \&\\*(xR\\$1\fP
+.	\}
+.	el .tm Xr Usage: .Xr manpage_name section# \\*(Pu
+.\}
+.if \\n(.$==2 \{\
+.	rZ \\$2
+.	ie "\\*(iM"" \{\
+.		ie \\n(rZ \&\\*(xR\\$1\fP\\$2
+.		el \&\\*(xR\\$1\fP(\\$2)
+.	\}
+.	el \{\
+.		ie \\n(rZ .as f1 \&\\*(xR\\$1\fP\\$2
+.		el .as f1 \&\\*(xR\\$1\fP(\\$2)
+.	\}
+.\}
+.if \\n(.$>=3 \{\
+.	rZ \\$2
+.	ie \\n(rZ \{\
+.		ie !"\\*(iM"" .as f1 \&\\*(xR\\$1\fP\\$2\\$3\\$4\\$5\\$6\\$7\\$8
+.		el \&\\*(xR\\$1\fP\\$2\\$3\\$4\\$5\\$6\\$7\\$8
+.	\}
+.	el \{\
+.		rZ \\$3
+.		ie \\n(rZ \{\
+.			if !"\\*(iM"" \{\
+.			     as f1 \&\\*(xR\\$1\fP(\\$2)\\$3\\$4\\$5\\$6\\$7\\$8
+.			\}
+.			if "\\*(iM"" \{\
+\&\\*(xR\\$1\fP(\\$2)\\$3\\$4\\$5\\$6\\$7\\$8
+.			\}
+.		\}
+.		el \{\
+.			tm rZ = \\n(rZ  the arg is \\$3
+.			tm Xr-XX Usage: .Xr manpage_name section# \\*(Pu
+.		\}
+.	\}
+.\}
+..
+.\"
+.\"
+.de Ex
+.tm Ex defunct, Use .Dl: \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+..
+.\" Display (one) Line of text.
+.de Dl
+.ie "\\*(iM"" \{\
+'	ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
+.	in \\n(.iu+\\n(Dsu
+.	mN \\$1
+.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	el \{\
+.		nr cF \\n(.f
+.\"	 Literal font is none specified
+\&\\*(lI\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.		ft \\n(cF
+.	\}
+.	in \\n(.iu-\\n(Dsu
+.\}
+.el \{\
+.	mN \\$1
+.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+.	el \{\
+.		nr cF \\n(.f
+.		ds f1 \&\\*(lI\\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+.		as f1 \&\f\\n(cF
+.	\}
+.\}
+..
+.\"
+.\"
+.\" user set Tagged Paragraph Width (used in both Dp and Tp)
+.de Tw
+.ie \\n(.$==0 \{\
+.	nr aa 0
+.\}
+.el \{\
+.	mN \\$1
+.	ie \\n(sW>2 \{\
+.		nr tW (\\n(sW+3)*\\n(fWu)
+.	\}
+.	el \{\
+.		ie \\n(mN .nr tW \\n(mN
+.		el .nr tW \\$1
+.	\}
+.	nr tF 1
+.\}
+..
+.\"
+.de Dw
+.Tw \\$1
+..
+.\"
+.de Di
+.ie \\n(.$==0 \{\
+.	nr tI \\n(Dsu
+.\}
+.el \{\
+.	sW \\$1
+.	if \\n(sW>=2 \{\
+.		nr tI \\$1u
+.	\}
+.	if \\n(sW<2 \{\
+.		if "\\$1"L" \{\
+.			nr tI 0
+.		\}
+.	\}
+.\}
+..
+.\" tagged paragraph
+.\" initialize baby stack variables
+.nr np 0
+.nr p1 0
+.ds s\n(np
+.\"
+.de Tp
+.ie "\\$1"" .pE p s np
+.el \{\
+.	ds iM Tp
+.	mN \\$1
+.	ie \\n(tF \{\
+.		ds tC Tw
+.		nr tC 1
+.		nr tF 0
+.	\}
+.	el \{\
+.		if !"Tw"\\*(s\\n(np" \{\
+.			ie \\n(mN \{\
+.				ds tC \\$1
+.				nr tW \\n(mN
+.			\}
+.			el \{\
+.				ds tC Tx
+.				nr tW \\n(Tx
+.			\}
+.			if !"\\*(tC"\\*(s\\n(np" .nr tC 1
+.		\}
+.	\}
+.	sp \\n(vVu
+.	if !\\n(cR .ne 2
+.	if \\n(tC \{\
+.		nr np \\n(np+1
+.		nr p\\n(np \\n(tW
+.		ds s\\n(np \\*(tC
+.		nr tC 0
+.		ds tC
+.		in \\n(.iu+\\n(p\\n(npu
+.	\}
+.	ie \\n(mN \{\
+.		ds f1
+.		\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.		if !"\\$1"Cx" .pT st p np
+.	\}
+.	el \{\
+.		br
+.		ev 1
+.		fi
+.		di Td
+\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.		br
+.		di
+.		ev
+.		na
+.		ds tD \\*(Td\\
+.		pT di p np
+.	\}
+.\}
+..
+.\"
+.\"
+.\" Complex Expression Macro
+.\"
+.\"	 TODO: add length across line boundary check (like Li)
+.de Cx
+.hy 0
+.ie \\n(.$==0 \{\
+.	if "\\*(iM"Cx" \{\
+.		ds iM
+.		if \\n(oE .oE
+\&\\*(f1
+.		ds f1
+.	\}
+.	if "\\*(iM"Tp" .pT st p np
+.	if "\\*(iM"Dp" .pT st q mp
+.\}
+.el \{\
+.	if "\\*(iM"" \{\
+.		ds iM Cx
+.		ds f1 \&
+.	\}
+.	mN \\$1
+.\" Here are the args: '\\$1'  '\\$2'  '\\$3'  '\\$4'
+.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	el \{\
+.		as f1 \&\\$1
+.		if \\n(.$>1 .Cx \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+.\}
+..
+.\" Prefix string in default font to content specified string
+.de Pf
+.Cx \\$1
+.\\$2 \\$3 \\$4 \\$5
+.Cx
+..
+.\" Suffix string in default font to content specified string
+.de Sf
+.Cx \\$1 \\$2
+.Cx \\$3
+.Cx
+..
+.\" Simple Option Begin
+.de Ob
+.hy 0
+.ie "\\*(iM"" \{\
+.	ev 2
+.	fi
+.	di oB
+.\}
+.el \{\
+.tm shouldn't be here
+.	as f1 \&
+.	mN \\$1
+.	ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	el \{\
+.		as f1 \&\\$1
+.		if \\n(.$>1 .Oc \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+.\}
+..
+.de Oc
+.as f1 \&\\$1
+.if \\n(.$>1 .Oc \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+..
+.de Oe
+.hy 0
+.ie "\\*(iM"" \{\
+.	br
+.	di
+.	ev
+.	ds bO \\*(oB\\
+\&\\*(bO\&
+.\}
+.el \{\
+.	as f1 \&
+.\}
+..
+.\" White space for Cx
+.de Ws
+.Cx \&\ \&
+..
+.\" tagged paragraph
+.\" initialize baby stack variables
+.nr mp 0
+.nr q1 0
+.ds r\n(np
+.\"
+.\" Complex Dp tag
+.de Dc
+.Dp Cx \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+..
+.\" Complex Tp tag
+.de Tc
+.Tp Cx \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+..
+.\" Tag with a flag and an argument with a space
+.de Ta
+.if "\\$2"" \{\
+.	Tp Fl \\$1
+.\}
+.el \{\
+.	Tp Fl \\$1
+.	Cx \&\ \&
+.	Ar \\$2 \\$3
+.	Cx
+.\}
+..
+.de Da
+.Dp Cx Fl \\$1
+.Ws
+.Ar \\$2 \\$3
+.Cx
+..
+.de To
+.Tp Cx Fl \\$1
+.Ar \\$2 \\$3
+.Cx
+..
+.de Do
+.Dp Cx Fl \\$1
+.Ar \\$2 \\$3
+.Cx
+..
+.\" Blended tag toggle
+.de Bt
+.ie \\n(tP==0 .nr tP 1
+.el .nr tP 0
+..
+.\" Bullet paragraph
+.de Bu
+.Tp Sy \&\(bu
+..
+.\" Display tagged paragraph
+.de Dp
+.ie "\\$1"" \{\
+.	pE q r mp
+.	sp \\n(vVu
+.\}
+.el \{\
+.       ds iM Dp
+.       mN \\$1
+.       ie \\n(tF \{\
+.               ds tC Tw
+.               nr tC 1
+.               nr tF 0
+.       \}
+.       el \{\
+.               if !"Tw"\\*(r\\n(mp" \{\
+.                       ie \\n(mN \{\
+.                               ds tC \\$1
+.                               nr tW \\n(mN
+.                       \}
+.                       el \{\
+.                               ds tC Tx
+.                               nr tW \\n(Tx
+.                       \}
+.                       if !"\\*(tC"\\*(r\\n(mp" .nr tC 1
+.               \}
+.       \}
+.       if !\\n(cR .ne 2
+.       if \\n(tC \{\
+.               nr mp \\n(mp+1
+.               nr q\\n(mp \\n(tW
+.               ds r\\n(mp \\*(tC
+.               nr tC 0
+.               ds tC
+.		ie \\n(tIu==\\n(Dsu .nr i\\n(mp \\n(Dsu
+.		el \{\
+.			nr i\\n(mp \\n(tIu
+.			nr tI \\n(Dsu
+.		\}
+.              	in \\n(.iu+\\n(i\\n(mpu
+.		sp \\n(vVu
+.		in \\n(.iu+\\n(\\q\\n(mpu
+.       \}
+.       ie \\n(mN \{\
+.               \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.               if !"\\$1"Cx" .pT st q mp
+.       \}
+.       el \{\
+.               br
+.               ev 1
+.               fi
+.               di Td
+\&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.               br
+.               di
+.               ev
+.               na
+.               ds tD \\*(Td\\
+.               pT di q mp
+.       \}
+.\}
+..
+.\"
+.\" .pE number_stack string_stack counter
+.de pE
+.ie "\\$3"mp" \{\
+.	in \\n(.iu-(\\n(\\$1\\n(\\$3u)-(\\n(i\\n(mpu)
+.	rr i\\n(mp
+.\}
+.el .in \\n(.iu-\\n(\\$1\\n(\\$3u
+.\" .in \\n(.iu-\\n(\\$1\\n(\\$3u
+.if \\n(\\$3<=0 .tm Extraneous call .Tp or .Dp
+.rr \\$1\\n(\\$3
+.rm \\$2\\n(\\$3
+.nr \\$3 \\n(\\$3-1
+.ds iM
+..
+.\"
+.\" .pT st or di number_stack counter
+.de pT
+.ie "\\$1"st" \{\
+.	nr bb \\n(\\$2\\n(\\$3u
+.	ti -\\n(bbu
+.	ie (\\n(\\$2\\n(\\$3u-2n)<=\w'\\*(f1'u \{\&\\*(f1\\*(tP
+.		if \\n(tP==0 .br
+.	\}
+.	el \\*(f1\h'|\\n(\\$2\\n(\\$3u'\c
+.\}
+.el \{\
+.       ti -\\n(\\$2\\n(\\$3u
+.	ie (\\n(\\$2\\n(\\$3u-2n)<=\\n(dlu \{\&\\*(tD\\*(tP
+.	       if !\\n(tP .br
+.	\}
+.	el \\*(tD\h'|\\n(\\$2\\n(\\$3u'\c
+.	if t 'ad
+.\}
+.	ds iM
+.	ds f1
+'fi
+..
+.\"
+.\" The new SH
+.\"
+.de Sh
+.\" set Sh state off, check for list state before calling indent (.In)
+.nr nS 0
+.nr sE 0
+.ie "\\$1"NAME" \{\
+.\"	name state on, housekeep (headers & footers)
+.	hK
+'	in 0
+.\}
+.el \{\
+.	if "\\$1"SYNOPSIS" .nr nS 1
+.	in 0
+.\}
+.pL
+'sp
+.ns
+.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
+.if !\\n(cR .ne 3
+'fi
+\&\fB\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
+\&\fP\&
+.in \\n(.iu+\\n(Tiu
+.if "\\$1"SEE" .nr sE 1
+.ns
+..
+.\"
+.\" Nd minus sign for an en dash used in .Sh Name
+.de Nd
+\&\-\& \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+..
+.de Ss
+.sp
+.ti -.25i
+\&\fB\\$1 \|\\$2 \|\\$3 \|\\$4 \|\\$5 \|\\$6 \|\\$7 \|\\$8 \|\\$9
+\&\fP\&
+.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
+.if !\\n(cR .ne 2
+.br
+..
+.\"	.if "\\$1"Ss" .in \\n(.iu+\\n(sIu
+.\"..
+.\"
+.\"
+.\" Column Macro
+.\"
+.hy 0
+.de Cw
+.ie \\n(.$==0 \{\
+.	br
+.	in \\n(.iu-\\n(eWu
+.	ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
+.\}
+.el \{\
+.	Pp
+.	if \\n(.$==1 \{\
+.		ta \w'\\$1    'u
+.		nr eW \w'\\$1    'u
+'		in \\n(.iu+\\n(eWu
+.	\}
+.	if \\n(.$==2 \{\
+.		ta \w'\\$1    'u +\w'\\$2    'u
+.		nr eW \w'\\$1    'u+\w'\\$2    'u
+'		in \\n(.iu+\\n(eWu
+.	\}
+.	if \\n(.$==3 \{\
+.		ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u
+.		nr eW \w'\\$1    'u+\w'\\$2    'u+\w'\\$3    'u
+'		in \\n(.iu+\\n(eWu
+.	\}
+.	if \\n(.$==4 \{\
+.	ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u
+.	nr eW \w'\\$1    'u+\w'\\$2    'u+\w'\\$3    'u +\w'\\$4    'u
+'	in \\n(.iu+\\n(eWu
+.	\}
+.	if \\n(.$==5 \{\
+.ta \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u +\w'\\$5    'u
+.nr eW \w'\\$1    'u +\w'\\$2    'u +\w'\\$3    'u +\w'\\$4    'u +\w'\\$5    'u
+'	in \\n(.iu+\\n(eWu
+.	\}
+.\}
+..
+.de Cl
+.ti -\\n(eWu
+.mN \\$1
+.ie \\n(mN .\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.el \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+..
+.nr dQ 0
+.de Ds
+.ie !"\\$1"" \{\
+.	mN d\\$1
+.	if \\n(mN \{\
+.		nr dQ \\n(dQ+1
+.		d\\$1
+.	\}
+.\}
+.el .br
+.nf
+..
+.de Df
+.ie !"\\$1"" \{\
+.       mN d\\$1
+.       if \\n(mN \{\
+.               nr dQ \\n(dQ+1
+.               d\\$1
+.       \}
+.\}
+.el .br
+..
+.de Dn
+\\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.nf
+..
+.de dI
+.nr d\\n(dQ \\n(dIu
+.in \\n(.iu+\\n(dIu
+..
+.de dC
+.nr d\\n(dQ (\\n(.l-\\n(.i)/4u
+.in \\n(.iu+\\n(d\\n(dQu
+..
+.de dR
+.nr d\\n(dQ (\\n(.l/3)u
+.in \\n(.iu+\\n(d\\n(dQu
+..
+.de dL
+.nr aa 0
+..
+.de De
+.br
+.if \\n(d\\n(dQ \{\
+.	in \\n(.iu-\\n(d\\n(dQu
+.	rr d\\n(dQ
+.	nr dQ \\n(dQ-1
+.\}
+.fi
+..
+.\"
+.de Fn
+.ie \\n(.$==0 \{\
+.	tm Usage: .Fn function_name function_arg(s) ... \\*(Pu
+.\}
+.el \{\
+.	nr cF \\n(.f
+.	ie \\n(.$==1 .ds f1 \&\\*(nM\\$1\fP\\*(lP\fP\\*(rP\fP
+.	el \{\
+.		ds f1 \\*(nM\\$1\fP\\*(lP
+.		nr aa 0
+.		rC \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
+.	\}
+.	if "\\*(iM"" \{\\&\\*(f1
+.		ds f1
+.	\}
+.\}
+..
+.\"
+.de rC
+.rZ \\$1
+.ie \\n(rZ \{\
+.	as f1 \f\\n(cF\\*(rP\f\\n(cF\\$1\\$2\\$3\\$4\\$5\\$6\\$7
+.\}
+.el \{\
+.	ie \\n(aa .as f1 \fP, \\*(aR\\$1
+.	el .as f1 \\*(aR\\$1
+.	nr aa 1
+.	ie \\n(.$>1 .rC \\$2 \\$3 \\$4 \\$5 \\$6 \\$7
+.	el .as f1 \fP\\*(rP\fP
+.\}
+..
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=nroff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/doc.tmac Added

@@ -0,0 +1,6957 @@
+.\" Copyright (c) 1991, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc	8.1 (Berkeley) 06/08/93
+.\"
+.\" Modified by jjc@jclark.com as follows: the doc-* files are assumed
+.\" to be installed as mdoc/doc-* rather than tmac.doc-* (the filename
+.\" 'tmac.doc-common' would be too long); when using groff, the doc-*
+.\" files are loaded using the 'mso' request.
+.\"
+.\" Modified by
+.\"
+.\"   Werner LEMBERG <wl@gnu.org>      and
+.\"   Ruslan Ermilov <ru@freebsd.org>
+.\"
+.\" to make it more readable: using long names and many groff features,
+.\" updating and extending documentation, etc.
+.
+.
+.if !\n(.g \
+.  ab groff mdoc macros require groff extensions; aborting
+.
+.
+.do if d Dd .nx
+.
+.
+.cp 0
+.
+.
+.if (\n.x\n.y < 118) \{\
+.  ds doc-msg doc.tmac: groff mdoc macros require groff 1.18 or later,
+.  as doc-msg " but found groff \n.x.\n.y; aborting
+.  ab \*doc-msg
+.\}
+.
+.\" Handle most rendering options.
+.
+.nr doc-is-output-html 0
+.if '\*.T'html' .nr doc-is-output-html 1
+.
+.\" Use -dAD to set the adjustment mode for ordinary body text.
+.if !d AD \
+.  ds AD b\"
+.
+.\" Use -rC1 to consecutively number pages across multiple documents.
+.\"
+.\" We must use consecutive page numbers when using PostScript to
+.\" generate HTML images; we must not reset the page number at the
+.\" beginning of each document (the 'ps4html' register is automatically
+.\" added to the command line by the pre-HTML preprocessor).
+.ie !r C \
+.  nr C 0
+.el \
+.  if !\nC \
+.    if \ndoc-is-output-html \{\
+.       tm mdoc: consecutive page numbering required for HTML output
+.       nr C 1
+.    \}
+.if \ndoc-is-output-html \
+.  nr C 1
+.if r ps4html \
+.  nr C 1
+.
+.\" Use -rCS=1 to force capitalization of section headings.
+.if !r CS .nr CS 0
+.
+.\" Use -rCT=1 to force capitalization of page titles in headers.
+.if !r CT .nr CT 0
+.
+.\" Use -rcR=0 for multiple pages instead of a single, very long page.
+.if !r cR \{\
+.  if t .nr cR 0
+.  if n .nr cR 1
+.\}
+.
+.\" If continuous rendering, tell tbl not to use keeps.
+.ie \ncR \
+.  nr 3usekeeps 0
+.el \
+.  nr 3usekeeps 1
+.
+.\" double-sided layout
+.ie !r D \
+.  nr D 0
+.el \
+.  if \nD \
+.    if \ndoc-is-output-html \{\
+.       tm mdoc: ignoring double-sided layout in HTML output
+.       nr D 0
+.    \}
+.
+.\" footer distance
+.\"
+.\" Unlike most of these parameters, we do not set a default for FT; the
+.\" doc-set-up-titles macro places page location traps only if not
+.\" continuously rendering.
+.if r FT \{\
+.  \" Validate it.  Continuous rendering ignores FT.  Measuring a footer
+.  \" distance from the page top isn't done.  A footer distance of over
+.  \" half the page length is unlikely.  A footer distance of less than
+.  \" one line height is too.
+.  ie \ncR \
+.    ds doc-msg footer distance when continuously rendering\"
+.  el \{\
+.    nr doc-tmp 1v
+.    ds doc-help " (1v=\ndoc-tmpu)\"
+.    ie (\nFT : (\nFT = 0)) \
+.      ds doc-msg non-negative footer distance: \nFTu\*doc-help\"
+.    el \{\
+.      ie (-(\nFT) > (\n.p / 2)) \{\
+.        ds doc-msg implausibly large footer distance:\"
+.        as doc-msg " \nFTu\*doc-help\"
+.      \}
+.      el \
+.        if (-(\nFT) < 1v) \{\
+.          ds doc-msg implausibly small footer distance:\"
+.          as doc-msg " \nFTu\*doc-help\"
+.        \}
+.    rm doc-help
+.    rr doc-tmp
+.    \}
+.  \}
+.  if d doc-msg \{\
+.    tm mdoc: ignoring \*doc-msg
+.    rr FT
+.    rm doc-msg
+.  \}
+.\}
+.
+.\" (sub)section heading font
+.if !d HF \
+.  ds HF B\"
+.
+.\" If HF is a bold style, use bold italics for italics in headings.
+.ds doc-heading-style \*HF\"
+.substring doc-heading-style -1 -1
+.ds doc-heading-family \" empty
+.length doc-HF-length \*HF
+.if (\ndoc-HF-length > 1) \{\
+.  as doc-heading-family \*HF\"
+.  substring doc-heading-family 0 -2
+.\}
+.if '\*doc-heading-style'B' \
+.  if F \*doc-heading-familyBI \
+.    nr doc-remap-I-style-in-headings 1
+.rr doc-HF-length
+.rm doc-heading-style
+.
+.\" \nHY is recognized for groff_man(7) compatibility, particularly
+.\" via andoc.tmac and man(1); see \ndoc-hyphen-flags in doc-common.
+.if !r HY .nr HY 1
+.
+.\" Use -rIN=<xxx> to set the paragraph indentation amount.
+.if !r IN \{\
+.  \" We select an integer indentation value in nroff mode because this
+.  \" value is used additively for multiple purposes; rounding of
+.  \" accumulating fractions would produce inconsistent results.
+.  ie t .nr IN 7.2n
+.  el   .nr IN 7n
+.\}
+.
+.\" LL and LT registers are handled by the doc-setup-page-layout macro.
+.
+.\" TODO: Implement MF string.
+.
+.\" starting page number
+.\"
+.\" Unlike most of these parameters, we do not set a default for P;
+.\" troff supplies a default starting page number (1).  When rendering
+.\" for the HTML output device, page numbers are concealed and used for
+.\" internal purposes like image embedding.  Page numbers are not
+.\" rendered at all in continuous rendering mode.
+.if r P \{\
+.  if \ndoc-is-output-html \
+.    if !(\nP = 1) \
+.      ds doc-msg in HTML output\"
+.  if \ncR \
+.    ds doc-msg when continuously rendering
+.\}
+.if d doc-msg \{\
+.  tm mdoc: ignoring starting page number \*doc-msg
+.  rr P
+.  rm doc-msg
+.\}
+.
+.\" Setting the page number turns out to be tricky when batch rendering
+.\" and switching macro packages.  We must use different techniques
+.\" depending on whether the transition to the first output page has
+.\" happened yet.  If it has not, `nl` will be `-1` and we use `pn`.  If
+.\" it has, we set `%`.  Technically this is fragile since in theory a
+.\" page could assign a negative value to `nl`.  We might then be
+.\" justified in saying they've broken the macro package and they get to
+.\" keep both pieces.  But if not, consider using a nonce register,
+.\" initially set but then permanently cleared adjacent to this logic,
+.\" and whose state is shared with man (and andoc.tmac, if necessary).
+.\"
+.\" Also, we can't use the `P` register with grohtml at all.
+.ie r ps4html \{\
+.  if r P \{\
+.     tm mdoc: ignoring starting page number in HTML output
+.     rr P
+.  \}
+.\}
+.el \{\
+.  if r P \{\
+.    ie (\nnl = -1) .pn 0\nP
+.    el               .nr % 0\nP
+.  \}
+.\}
+.
+.\" Use -rSN=<xxx> to set the subsection heading indentation amount.
+.if !r SN .nr SN 3n
+.
+.\" TODO: Implement U register.
+.
+.\" page number after which to apply letter suffixes
+.\"
+.\" Unlike most of these parameters, we do not set a default for X; only
+.\" the macro an-footer uses it.  Page numbers are not rendered at all
+.\" in continuous rendering mode.
+.if r X \{\
+.  af doc-page-letter a
+.  if \ndoc-is-output-html \
+.    ds doc-msg in HTML output\"
+.  if \ncR \
+.    ds doc-msg when continuously rendering
+.\}
+.if d doc-msg \{\
+.  tm mdoc: ignoring page number suffix \*doc-msg
+.  rr X
+.  rm doc-msg
+.\}
+.
+.
+.\" Load startup files.
+.ie t \
+.  mso mdoc/doc-ditroff
+.el \
+.  mso mdoc/doc-nroff
+.
+.mso mdoc/doc-common
+.mso mdoc/doc-syms
+.
+.
+.\" NS doc-macro-name global string
+.\" NS   name of calling request (set in each user-requestable macro)
+.
+.ds doc-macro-name
+.als doc-arg0 doc-macro-name
+.
+.
+.\" NS doc-arg-count global register
+.\" NS   total number of arguments
+.\" XXX: This register name and description aren't quite right, but its
+.\" old name `doc-arg-limit` doesn't seem accurate either.  Demystify.
+.
+.nr doc-arg-count 0
+.
+.
+.\" NS doc-num-args global register
+.\" NS   number of arguments to handle (must be set to \n.$ prior to
+.\" NS   'doc-parse-arg-vector' request)
+.
+.nr doc-num-args 0
+.
+.
+.\" NS doc-arg-ptr global register
+.\" NS   argument pointer
+.
+.nr doc-arg-ptr 0
+.
+.
+.\" NS doc-argXXX global string
+.\" NS   argument vector
+.\" NS
+.\" NS limit:
+.\" NS   doc-arg-count
+.
+.ds doc-arg1
+.
+.
+.\" NS doc-typeXXX global register
+.\" NS   argument type vector (macro=1, string=2, punctuation suffix=3,
+.\" NS   punctuation prefix=4)
+.\" NS
+.\" NS limit:
+.\" NS   doc-arg-count
+.
+.nr doc-type1 0
+.
+.
+.\" NS doc-spaceXXX global string
+.\" NS   space vector
+.\" NS
+.\" NS limit:
+.\" NS   doc-arg-count
+.
+.ds doc-space1
+.
+.
+.\" NS doc-parse-args macro
+.\" NS   parse arguments (recursively) ('.doc-parse-args arg ...')
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-spaceXXX
+.\" NS   doc-typeXXX
+.\" NS   doc-arg-ptr
+.\" NS   doc-have-space
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dpa
+.\" NS   doc-reg-dpa1
+.\" NS   doc-str-dpa
+.
+.eo
+.de doc-parse-args
+.  if !\ndoc-arg-count \
+.    doc-set-spacing-1
+.
+.  nr doc-have-space 0
+.
+.  if !\n.$ \
+.    return
+.
+.  nr doc-arg-count +1
+.
+.  \" handle '|' and '...' specially
+.  ie        "\$1"|" \
+.    ds doc-arg\ndoc-arg-count \fR|\f
+.  el \{ .ie "\$1"..." \
+.    ds doc-arg\ndoc-arg-count \|.\|.\|.
+.  el \
+.    ds doc-arg\ndoc-arg-count "\$1
+.  \}
+.
+.  \" get argument type and set spacing
+.  doc-get-arg-type* \ndoc-arg-count
+.  nr doc-type\ndoc-arg-count \ndoc-arg-type
+.  doc-set-spacing-\ndoc-arg-type
+.
+.  \" check whether we have processed the last parameter
+.  ie (\n.$ == 1) \
+.    nr doc-arg-ptr 0
+.  el \{\
+.    shift
+.    doc-parse-args \$@
+.  \}
+.
+.  nh
+..
+.ec
+.
+.
+.\" NS doc-parse-arg-vector macro
+.\" NS   parse argument vector (recursive)
+.\" NS
+.\" NS   cf. comments in doc-parse-args
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-num-args
+.\" NS   doc-spaceXXX
+.\" NS   doc-typeXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dpav
+.\" NS   doc-reg-dpav1
+.\" NS   doc-str-dpav
+.
+.eo
+.de doc-parse-arg-vector
+.  if !\ndoc-arg-count \
+.    doc-set-spacing-1
+.
+.  nr doc-arg-count +1
+.
+.  ie        "\*doc-arg\ndoc-arg-count"|" \
+.    ds doc-arg\ndoc-arg-count \fR|\f
+.  el \{ .if "\*doc-arg\ndoc-arg-count"..." \
+.    ds doc-arg\ndoc-arg-count \|.\|.\|.
+.  \}
+.
+.  doc-get-arg-type* \ndoc-arg-count
+.  nr doc-type\ndoc-arg-count \ndoc-arg-type
+.  doc-set-spacing-\ndoc-arg-type
+.
+.  ie (\ndoc-num-args == 1) \{\
+.    nr doc-arg-ptr 0
+.    nr doc-num-args 0
+.  \}
+.  el \{\
+.    nr doc-num-args -1
+.    doc-parse-arg-vector
+.  \}
+.
+.  nh
+..
+.ec
+.
+.
+.\" NS doc-parse-space-vector macro
+.\" NS   parse space vector (recursive)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-num-args
+.\" NS   doc-spaceXXX
+.
+.eo
+.de doc-parse-space-vector
+.  nr doc-arg-count +1
+.
+.  doc-set-spacing-\ndoc-type\ndoc-arg-count
+.
+.  ie (\ndoc-num-args == 1) \
+.    nr doc-num-args 0
+.  el \{\
+.    nr doc-num-args -1
+.    doc-parse-space-vector
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-remaining-args macro
+.\" NS   output remaining arguments as-is, separated by spaces (until
+.\" NS   'doc-num-args' is exhausted)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-num-args
+.
+.eo
+.de doc-remaining-args
+.  nr doc-arg-ptr +1
+.  nop \)\*doc-arg\ndoc-arg-ptr\c
+.
+.  ie (\ndoc-num-args == 1) \{\
+.    nr doc-arg-ptr 0
+.    nr doc-num-args 0
+.  \}
+.  el \{\
+.    nop \)\*doc-space\c
+.    nr doc-num-args -1
+.    doc-remaining-args
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-append-arg macro
+.\" NS   append one argument to argument vector:
+.\" NS   '.doc-append-arg arg type'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-argXXX
+.\" NS   doc-typeXXX
+.
+.eo
+.de doc-append-arg
+.  nr doc-arg-count +1
+.  ds doc-arg\ndoc-arg-count "\$1
+.  nr doc-type\ndoc-arg-count \$2
+.  doc-set-spacing-\$2
+..
+.ec
+.
+.
+.\" NS doc-print-and-reset macro
+.\" NS   finish input line and clean up argument vectors
+.
+.eo
+.de doc-print-and-reset
+.  if \ndoc-space-mode \
+.    nop \)
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-reset-args macro
+.\" NS   reset argument counters
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-arg-ptr
+.\" NS   doc-have-slot
+.
+.eo
+.de doc-reset-args
+.  nr doc-arg-count 0
+.  nr doc-arg-ptr 0
+.  nr doc-have-slot 0
+.
+.  hy \ndoc-hyphen-flags
+..
+.ec
+.
+.
+.\" NS doc-curr-font global register
+.\" NS   saved current font
+.
+.nr doc-curr-font \n.f
+.
+.
+.\" NS Fl user macro
+.\" NS   handle flags (appends '-' and prints flags): '.Fl arg ...'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Fl (for communication with doc-flag-recursion)
+.\" NS
+.\" NS width register 'Fl' set in doc-common
+.
+.eo
+.de Fl
+.  nr doc-curr-font \n.f
+.  nop \*doc-Fl-font\c
+.
+.  if !\ndoc-arg-count \{\
+.    ds doc-macro-name Fl
+.    doc-parse-args \$@
+.
+.    \" no arguments
+.    if !\n.$ \
+.      nop \|\-\|\f
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    \" last argument
+.    nop \|\-\f\c
+.    doc-print-and-reset
+.  \}
+.  el \{\
+.    ie (\ndoc-type\ndoc-arg-ptr == 1) \{\
+.      nop \|\-\f\c
+.      \*doc-arg\ndoc-arg-ptr
+.    \}
+.    el \{\
+.      if (\ndoc-type\ndoc-arg-ptr == 3) \
+.        nop \|\-\|\c
+.
+.      nr doc-reg-Fl 1
+.      doc-flag-recursion
+.  \}\}
+..
+.ec
+.
+.
+.\" NS doc-flag-recursion macro
+.\" NS   'Fl' flag recursion routine (special handling)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dfr
+.\" NS   doc-reg-dfr1
+.\" NS   doc-str-dfr
+.
+.eo
+.de doc-flag-recursion
+.  nr doc-reg-dfr1 \ndoc-type\ndoc-arg-ptr
+.  ds doc-str-dfr "\*doc-arg\ndoc-arg-ptr
+.
+.  ie (\ndoc-reg-dfr1 == 1) \{\
+.    nop \f\c
+.    \*doc-str-dfr
+.  \}
+.  el \{\
+.    nr doc-reg-dfr \ndoc-arg-ptr
+.
+.    ie (\ndoc-reg-dfr1 == 2) \{\
+.      \" handle vertical bar -- doc-reg-Fl is set for the first call of
+.      \" doc-flag-recursion only; we need this to make '.Fl | ...' work
+.      \" correctly
+.      ie "\*doc-str-dfr"\*Ba" \{\
+.        if \ndoc-reg-Fl \
+.          nop \|\-\*doc-space\c
+.        nop \)\*Ba\c
+.      \}
+.      el \{\
+.        ie "\*doc-str-dfr"\fR|\f" \{\
+.          if \ndoc-reg-Fl \
+.            nop \|\-\*doc-space\c
+.          nop \fR|\f\c
+.        \}
+.        el \{\
+.          \" two consecutive hyphen characters?
+.          ie "\*doc-str-dfr"-" \
+.            nop \|\-\^\-\|\c
+.          el \
+.            nop \|\%\-\*doc-str-dfr\&\c
+.    \}\}\}
+.    el \{\
+.      nop \f\ndoc-curr-font\c
+.      nop \)\*doc-str-dfr\f\c
+.    \}
+.
+.    ie (\ndoc-arg-count == \ndoc-arg-ptr) \{\
+.      \" last argument
+.      if (\ndoc-reg-dfr1 == 4) \
+.        nop \|\-\c
+.      nop \f\ndoc-curr-font\c
+.      doc-print-and-reset
+.    \}
+.    el \{\
+.      nr doc-arg-ptr +1
+.      ie (\ndoc-type\ndoc-arg-ptr == 3) \{\
+.        ie (\ndoc-type\ndoc-reg-dfr == 4) \
+.          nop \|\-\c
+.        el \
+.          nop \)\*doc-space\ndoc-reg-dfr\c
+.      \}
+.      el \
+.        nop \)\*doc-space\ndoc-reg-dfr\c
+.
+.      shift
+.      nr doc-reg-Fl 0
+.      doc-flag-recursion \$@
+.  \}\}
+..
+.ec
+.
+.
+.\" NS doc-print-recursive macro
+.\" NS   general name recursion routine (print remaining arguments)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dpr
+.\" NS   doc-reg-dpr1
+.\" NS   doc-str-dpr
+.
+.eo
+.de doc-print-recursive
+.  nr doc-reg-dpr1 \ndoc-type\ndoc-arg-ptr
+.  ds doc-str-dpr "\*doc-arg\ndoc-arg-ptr
+.
+.  if \ndoc-do-capitalize .stringup doc-str-dpr
+.
+.  ie (\ndoc-reg-dpr1 == 1) \{\
+.    nop \f\ndoc-curr-font\c
+.    \*doc-str-dpr
+.  \}
+.  el \{\
+.    nr doc-reg-dpr \ndoc-arg-ptr
+.
+.    \" the '\%' prevents hyphenation on a dash ('-')
+.    ie (\ndoc-reg-dpr1 == 2) \
+.      nop \%\*doc-str-dpr\&\c
+.    el \{\
+.      \" punctuation character
+.      nop \f\ndoc-curr-font\c
+.      nop \)\*doc-str-dpr\f\c
+.    \}
+.
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.      \" last argument
+.      nop \f\ndoc-curr-font\c
+.      doc-print-and-reset
+.    \}
+.    el \{\
+.      nop \)\*doc-space\ndoc-reg-dpr\c
+.      doc-print-recursive
+.  \}\}
+..
+.ec
+.
+.
+.\" NS doc-print-prefixes macro
+.\" NS   print leading prefixes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.
+.eo
+.de doc-print-prefixes
+.  while (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    if !(\ndoc-type\ndoc-arg-ptr == 4) \
+.      break
+.    nop \f\ndoc-curr-font\c
+.    nop \)\*doc-arg\ndoc-arg-ptr\f\c
+.    nr doc-arg-ptr +1
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-generic-macro macro
+.\" NS   this is the skeleton for most simple macros
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.
+.eo
+.de doc-generic-macro
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name \$0
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .\$0 \*doc-\$0-usage ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    if (\ndoc-type\ndoc-arg-ptr == 1) \{\
+.      tmc mdoc warning: Using a macro as first argument
+.      tm1 " cancels effect of .\$0 (#\n.c)
+.
+.      \" the right action here would be to reset the argument counters
+.      \" and bail out -- unfortunately, a small number of manual pages
+.      \" (less than 2% for FreeBSD which has been used for testing)
+.      \" relied on the old behaviour (silently ignore this error),
+.      \" so it is commented out
+.
+.\"    doc-reset-args
+.    \}
+.\"  el \{\
+.      nr doc-curr-font \n.f
+.      nop \*doc-\$0-font\c
+.      doc-print-recursive
+.\"  \}
+.  \}
+.  el \{\
+.    tm Usage: .\$0 \*doc-\$0-usage ... (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Ar user macro
+.\" NS   command-line 'argument' macro: '.Ar args ...'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Ar-default
+.\" NS
+.\" NS width register 'Ar' set in doc-common
+.
+.ds doc-str-Ar-default "file\ .\|.\|.
+.
+.eo
+.de Ar
+.  nr doc-curr-font \n.f
+.  nop \*doc-Ar-font\c
+.
+.  if !\ndoc-arg-count \{\
+.    ds doc-macro-name Ar
+.    doc-parse-args \$@
+.
+.    \" no argument
+.    if !\n.$ \
+.      nop \)\*doc-str-Ar-default\&\f
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  ie (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    nop \)\*doc-str-Ar-default\&\f\c
+.    doc-print-and-reset
+.  \}
+.  el \{\
+.    if !(\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      \" replace previous argument (Ar) with default value
+.      nr doc-arg-ptr -1
+.      ds doc-arg\ndoc-arg-ptr "\*doc-str-Ar-default
+.      nr doc-type\ndoc-arg-ptr 2
+.      ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.      \" recompute space vector for remaining arguments
+.      nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.      nr doc-arg-count \ndoc-arg-ptr
+.      doc-parse-space-vector
+.    \}
+.    doc-print-recursive
+.  \}
+..
+.ec
+.
+.
+.\" NS Ad user macro
+.\" NS   Addresses
+.\" NS
+.\" NS width register 'Ad' set in doc-common
+.
+.als Ad doc-generic-macro
+.ds doc-Ad-usage address
+.
+.
+.\" NS doc-indent-synopsis global register
+.\" NS   indentation in synopsis
+.
+.nr doc-indent-synopsis 0
+.
+.
+.\" NS doc-indent-synopsis-active global register (bool)
+.\" NS   indentation in synopsis active
+.
+.nr doc-indent-synopsis-active 0
+.
+.
+.\" NS Cd user macro
+.\" NS   config declaration (for section 4 SYNOPSIS)
+.\" NS
+.\" NS   this function causes a break; it uses the 'Nm' font
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-indent-synopsis
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Cd' set in doc-common
+.
+.eo
+.de Cd
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Cd
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Cd configuration_file_declaration ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.
+.    ie \ndoc-in-synopsis-section \{\
+.      ie "\*doc-macro-name"Cd" \{\
+.        br
+.        if !\ndoc-indent-synopsis \
+.          nr doc-indent-synopsis \ndoc-display-indentu
+.        if !\ndoc-indent-synopsis-active \
+.          in +\ndoc-indent-synopsisu
+.        ti -\ndoc-indent-synopsisu
+.        nop \*doc-Nm-font\c
+.        doc-print-recursive
+.        if !\ndoc-indent-synopsis-active \
+.          in -\ndoc-indent-synopsisu
+.      \}
+.      el \{\
+.        nop \*doc-Nm-font\c
+.        doc-print-recursive
+.    \}\}
+.    el \{\
+.      nop \*doc-Nm-font\c
+.      doc-print-recursive
+.  \}\}
+.  el \{\
+.    tm Usage: .Cd configuration_file_declaration ... (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Cm user macro
+.\" NS   interactive command modifier (flag)
+.\" NS
+.\" NS width register 'Cm' set in doc-common
+.
+.als Cm doc-generic-macro
+.ds doc-Cm-usage interactive_command_modifier
+.
+.
+.\" NS Dv user macro
+.\" NS   defined variable
+.\" NS
+.\" NS   this function uses the 'Er' font
+.\" NS
+.\" NS width register 'Dv' set in doc-common
+.
+.als Dv doc-generic-macro
+.ds doc-Dv-usage defined_variable
+.als doc-Dv-font doc-Er-font
+.
+.
+.\" NS Em user macro
+.\" NS   emphasis
+.\" NS
+.\" NS width register 'Em' set in doc-common
+.
+.als Em doc-generic-macro
+.ds doc-Em-usage text
+.
+.
+.\" NS Er user macro
+.\" NS   errno type
+.\" NS
+.\" NS width register 'Er' set in doc-common
+.
+.als Er doc-generic-macro
+.ds doc-Er-usage text
+.
+.
+.\" NS Ev user macro
+.\" NS   environment variable
+.\" NS
+.\" NS width register 'Ev' set in doc-common
+.
+.als Ev doc-generic-macro
+.ds doc-Ev-usage text
+.
+.
+.\" NS doc-have-decl global register (bool)
+.\" NS   subroutine test (in synopsis only)
+.
+.nr doc-have-decl 0
+.
+.
+.\" NS doc-have-var global register (bool)
+.\" NS   whether last type is a variable type
+.
+.nr doc-have-var 0
+.
+.
+.\" NS doc-do-func-decl macro
+.\" NS   do something special while in SYNOPSIS
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS   doc-have-decl
+.\" NS   doc-have-var
+.
+.eo
+.de doc-do-func-decl
+.  if \ndoc-in-synopsis-section \{\
+.    \" if a variable type was the last thing given, want vertical space
+.    if \ndoc-have-var \{\
+.      doc-paragraph
+.      nr doc-have-var 0
+.    \}
+.    \" if a subroutine was the last thing given, want vertical space
+.    if \ndoc-have-func \{\
+.      ie \ndoc-have-decl \
+.        br
+.      el \
+.        doc-paragraph
+.    \}
+.    nr doc-have-decl 1
+.  \}
+.
+.  nr doc-curr-font \n.f
+..
+.ec
+.
+.
+.\" NS Fd user macro
+.\" NS   function declaration -- not callable
+.\" NS
+.\" NS   this function causes a break
+.\" NS
+.\" NS width register 'Fd' set in doc-common
+.
+.eo
+.de Fd
+.  ie ((\n.$ >= 1) & (\ndoc-arg-count == 0)) \{\
+.    doc-do-func-decl
+.    nop \*doc-Fd-font\$*
+.    br
+.    ft \ndoc-curr-font
+.  \}
+.  el \{\
+.    tm Usage: .Fd function_declaration -- Fd is not callable (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS In user macro
+.\" NS   #include statement in SYNOPSIS
+.\" NS   <header.h> if not in SYNOPSIS
+.\" NS
+.\" NS   this function causes a break; it uses the 'Fd' font
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-indent-synopsis
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'In' set in doc-common
+.
+.eo
+.de In
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name In
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .In include_file ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  ie ((\ndoc-arg-count >= \ndoc-arg-ptr) & (\ndoc-type\ndoc-arg-ptr == 2)) \{\
+.    nr doc-curr-font \n.f
+.
+.    ie \ndoc-in-synopsis-section \{\
+.      ie "\*doc-macro-name"In" \{\
+.        doc-do-func-decl
+.        nop \*doc-Fd-font#include <\*doc-arg\ndoc-arg-ptr>
+.        ft \ndoc-curr-font
+.        br
+.        nr doc-arg-ptr +1
+.        ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.          doc-print-recursive
+.        el \
+.          doc-reset-args
+.      \}
+.      el \{\
+.        ds doc-arg\ndoc-arg-ptr "<\*doc-Pa-font\*doc-arg\ndoc-arg-ptr
+.        as doc-arg\ndoc-arg-ptr \f\ndoc-curr-font>
+.        doc-print-recursive
+.    \}\}
+.    el \{\
+.      ds doc-arg\ndoc-arg-ptr "<\*doc-Pa-font\*doc-arg\ndoc-arg-ptr
+.      as doc-arg\ndoc-arg-ptr \f\ndoc-curr-font>
+.      doc-print-recursive
+.  \}\}
+.  el \{\
+.    tm Usage: .In include_file ... (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Fr user macro
+.\" NS   function return value
+.\" NS
+.\" NS   this function uses the 'Ar' font
+.\" NS
+.\" NS width register 'Fr' set in doc-common
+.
+.als Fr doc-generic-macro
+.ds doc-Fr-usage function_return_value
+.als doc-Fr-font doc-Ar-font
+.
+.
+.\" NS Ic user macro
+.\" NS   interactive command
+.\" NS
+.\" NS width register 'Ic' set in doc-common
+.
+.als Ic doc-generic-macro
+.ds doc-Ic-usage interactive_command
+.
+.
+.\" NS Li user macro
+.\" NS   literals
+.\" NS
+.\" NS width register 'Li' set in doc-common
+.
+.als Li doc-generic-macro
+.ds doc-Li-usage argument
+.
+.
+.\" NS Ms user macro
+.\" NS   math symbol
+.\" NS
+.\" NS   this function uses the 'Sy' font
+.\" NS
+.\" NS width register 'Ms' set in doc-common
+.
+.als Ms doc-generic-macro
+.ds doc-Ms-usage math_symbol
+.als doc-Ms-font doc-Sy-font
+.
+.
+.\" NS doc-topic-name global string
+.\" NS   save first invocation of .Nm
+.
+.ds doc-topic-name \" empty
+.
+.
+.\" NS Nm user macro
+.\" NS   name of command or page topic
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-topic-name
+.\" NS   doc-curr-font
+.\" NS   doc-indent-synopsis
+.\" NS   doc-indent-synopsis-active
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Nm' set in doc-common
+.
+.eo
+.de Nm
+.  if !\ndoc-arg-count \{\
+.    ds doc-macro-name Nm
+.    ie \n.$ \{\
+.      \" Handle '.Nm ...' in "Name" section: don't use a special font.
+.      ie \ndoc-in-name-section \{\
+.        if "\*doc-topic-name"" \
+.          ds doc-topic-name "\$1\"
+.        No \$@
+.      \}
+.      el \
+.        doc-parse-args \$@
+.    \}
+.    el \{\
+.      ie "\*doc-topic-name"" \
+.        tm Usage: .Nm name ... (#\n.c)
+.      el \
+.        doc-parse-args \*doc-topic-name
+.  \}\}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  ie (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    \" last argument
+.    ie "\*doc-topic-name"" \{\
+.      tm Usage: .Nm name ... (#\n.c)
+.      doc-reset-args
+.    \}
+.    el \{\
+.      nop \*doc-Nm-font\*doc-topic-name\f\c
+.      doc-print-and-reset
+.  \}\}
+.  el \{\
+.    nr doc-curr-font \n.f
+.
+.    ie !(\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie "\*doc-topic-name"" \
+.        tm Usage: .Nm name ... (#\n.c)
+.      el \{\
+.        \" replace previous argument (Nm) with default value
+.        nr doc-arg-ptr -1
+.        ds doc-arg\ndoc-arg-ptr "\*doc-Nm-font\*doc-topic-name\f
+.        nr doc-type\ndoc-arg-ptr 2
+.        ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.        \" recompute space vector for remaining arguments
+.        nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.        nr doc-arg-count \ndoc-arg-ptr
+.        doc-parse-space-vector
+.    \}\}
+.    el \{\
+.      \" Handle '.Nm ...' in "Synopsis" section.
+.      if \ndoc-in-synopsis-section \{\
+.        if "\*doc-macro-name"Nm" \{\
+.          br
+.          if !\ndoc-indent-synopsis \{\
+.            doc-get-width "\*doc-arg\ndoc-arg-ptr"
+.            nr doc-indent-synopsis ((\ndoc-widthu + 1u) * \ndoc-fixed-widthu)
+.          \}
+.          if !\ndoc-indent-synopsis-active \{\
+.            in +\ndoc-indent-synopsisu
+.            nr doc-indent-synopsis-active 1
+.          \}
+.          ti -\ndoc-indent-synopsisu
+.      \}\}
+.
+.      nop \*doc-Nm-font\c
+.    \}
+.    doc-print-recursive
+.  \}
+..
+.ec
+.
+.
+.\" NS Pa user macro
+.\" NS   pathname: '.Pa arg ...'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Pa' set in doc-common
+.
+.eo
+.de Pa
+.  if !\ndoc-arg-count \{\
+.    ds doc-macro-name Pa
+.    doc-parse-args \$@
+.
+.    \" default value
+.    if !\n.$ \
+.      nop \*doc-Pa-font\ti\f
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.    nop \*doc-Pa-font\c
+.    if !(\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      \" replace previous argument (Pa) with default value
+.      nr doc-arg-ptr -1
+.      ds doc-arg\ndoc-arg-ptr \ti
+.      nr doc-type\ndoc-arg-ptr 2
+.      ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.      \" recompute space vector for remaining arguments
+.      nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.      nr doc-arg-count \ndoc-arg-ptr
+.      doc-parse-space-vector
+.    \}
+.    doc-print-recursive
+.  \}
+.  el \{\
+.    nop \*doc-Pa-font\ti\f\c
+.    doc-print-and-reset
+.  \}
+..
+.ec
+.
+.
+.\" NS Sy user macro
+.\" NS   symbolics
+.\" NS
+.\" NS width register 'Sy' set in doc-common
+.
+.als Sy doc-generic-macro
+.ds doc-Sy-usage symbolic_text
+.
+.
+.\" NS Me user macro
+.\" NS   menu entries
+.\" NS
+.\" NS width register 'Me' set in doc-common
+.
+.als Me doc-generic-macro
+.ds doc-Me-usage menu_entry
+.
+.
+.\" NS Tn user macro
+.\" NS   trade name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Tn' set in doc-common
+.
+.eo
+.de Tn
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Tn
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Tn trade_name ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.    nop \)\c
+.    ie !\ndoc-is-reference \{\
+.      nop \)\*doc-Tn-font\c
+.      doc-print-recursive
+.    \}
+.    el \
+.      doc-do-references
+.  \}
+.  el \{\
+.    tm Usage: .Tn trade_name ... (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Va user macro
+.\" NS   variable name
+.\" NS
+.\" NS width register 'Va' set in doc-common
+.
+.als Va doc-generic-macro
+.ds doc-Va-usage variable_name
+.
+.
+.\" NS No user macro
+.\" NS   normal text macro (default text style if mess up)
+.\" NS
+.\" NS width register 'No' set in doc-common
+.
+.als No doc-generic-macro
+.ds doc-No-usage normal_text
+.
+.
+.\" NS doc-quote-left global string
+.\" NS   left quotation character for 'doc-enclose-string' and
+.\" NS   'doc-enclose-open'
+.
+.ds doc-quote-left
+.
+.
+.\" NS doc-quote-right global string
+.\" NS   right quotation character for 'doc-enclose-string' and
+.\" NS   'doc-enclose-close'
+.
+.ds doc-quote-right
+.
+.
+.\" NS Op user macro
+.\" NS   option expression (i.e., enclose string in square brackets)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Op' set in doc-common
+.
+.eo
+.de Op
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Op
+.
+.  ds doc-quote-left "\*doc-left-bracket
+.  ds doc-quote-right "\*doc-right-bracket
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Aq user macro
+.\" NS   enclose string in angle brackets
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Aq' set in doc-common
+.
+.eo
+.de Aq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Aq
+.
+.  ie "\*doc-macro-name"An" \{\
+.    ds doc-quote-left <
+.    ds doc-quote-right >
+.  \}
+.  el \{\
+.    ds doc-quote-left \la
+.    ds doc-quote-right \ra
+.  \}
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Bq user macro
+.\" NS   enclose string in square brackets
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Bq' set in doc-common
+.
+.eo
+.de Bq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Bq
+.
+.  ds doc-quote-left "\*doc-left-bracket
+.  ds doc-quote-right "\*doc-right-bracket
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Brq user macro
+.\" NS   enclose string in braces
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Brq' set in doc-common
+.
+.eo
+.de Brq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Brq
+.
+.  ds doc-quote-left {
+.  ds doc-quote-right }
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Dq user macro
+.\" NS   enclose string in double quotes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Dq' set in doc-common
+.
+.eo
+.de Dq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Dq
+.
+.  ds doc-quote-left "\*Lq
+.  ds doc-quote-right "\*Rq
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Eq user macro
+.\" NS   enclose string in user-defined quotes (args 1 and 2)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Eq' set in doc-common
+.
+.eo
+.de Eq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Eq
+.
+.  ds doc-quote-left "\$1
+.  ds doc-quote-right "\$2
+.
+.  shift 2
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Pq user macro
+.\" NS   enclose string in parentheses
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Pq' set in doc-common
+.
+.eo
+.de Pq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Pq
+.
+.  ds doc-quote-left "\*doc-left-parenthesis
+.  ds doc-quote-right "\*doc-right-parenthesis
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Ql user macro
+.\" NS   quoted literal
+.\"
+.\"   is in file doc-dit|nroff
+.
+.
+.\" NS Qq user macro
+.\" NS   enclose string in straight double quotes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Qq' set in doc-common
+.
+.eo
+.de Qq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Qq
+.
+.  ds doc-quote-left "\*q
+.  ds doc-quote-right "\*q
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Sq user macro
+.\" NS   enclose string in single quotes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Sq' set in doc-common
+.
+.eo
+.de Sq
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Sq
+.
+.  ds doc-quote-left "\*doc-left-singlequote
+.  ds doc-quote-right "\*doc-right-singlequote
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS Es user macro
+.\" NS   set up arguments (i.e., the left and right quotation character
+.\" NS   as first and second argument) for .En call
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.
+.eo
+.de Es
+.  if !\ndoc-arg-count \{\
+.    ie (\n.$ > 2) \{\
+.      ds doc-macro-name Es
+.      doc-parse-args \$@
+.    \}
+.    el \{\
+.      ds doc-quote-left "\$1
+.      ds doc-quote-right "\$2
+.  \}\}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ds doc-quote-left "\*doc-arg\ndoc-arg-ptr
+.  nr doc-arg-ptr +1
+.  ds doc-quote-right "\*doc-arg\ndoc-arg-ptr
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.    doc-do-\ndoc-type\ndoc-arg-ptr
+.  el \
+.    doc-print-and-reset
+..
+.ec
+.
+.
+.\" NS doc-have-slot global register (bool)
+.\" NS   set if 'doc-enclose-string' has created a slot for closing
+.\" NS   delimiter
+.
+.nr doc-have-slot 0
+.
+.
+.\" NS doc-enclose-string macro
+.\" NS   enclose string with given args (e.g.  and )
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-have-slot
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-des
+.\" NS   doc-reg-des1
+.\" NS   doc-reg-des2
+.\" NS
+.\" NS requires:
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.
+.eo
+.de doc-enclose-string
+.  if \ndoc-in-synopsis-section \
+.    doc-set-hard-space
+.
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \
+.      doc-parse-args \$@
+.    el \{\
+.      nop \)\*doc-quote-left\*doc-quote-right
+.  \}\}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-curr-font \n.f
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  \" the final '\)' prevents hyphenation in case next character is '\%'
+.  nop \)\*doc-quote-left\)\c
+.  ie (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    \" last argument
+.    nop \)\*doc-quote-right\)\c
+.    doc-print-and-reset
+.  \}
+.  el \{\
+.    \" test whether last arguments are of type closing punctuation
+.    \" resp. suffix
+.    ie (\ndoc-type\ndoc-arg-count == 3) \{\
+.      nr doc-reg-des (\ndoc-arg-count - 1)
+.      while (\ndoc-type\ndoc-reg-des == 3) \
+.        nr doc-reg-des -1
+.
+.      \" prepend closing delimiter
+.      nr doc-reg-des +1
+.      ds doc-arg\ndoc-reg-des "\*doc-quote-right\)\*doc-arg\ndoc-reg-des
+.    \}
+.    el \{\
+.      \" test whether last arguments are macros which continue the line
+.      \" logically
+.      nr doc-reg-des \ndoc-arg-count
+.      while (\ndoc-reg-des >= \ndoc-arg-ptr) \{\
+.        if !\A'\*doc-arg\ndoc-reg-des' \
+.          break
+.        if !d doc-after-\*doc-arg\ndoc-reg-des \
+.          break
+.        nr doc-reg-des -1
+.      \}
+.
+.      \" if there are no trailing macros to be skipped, append argument
+.      ie (\ndoc-reg-des == \ndoc-arg-count) \
+.        doc-append-arg "\)\*doc-quote-right\)" 3
+.      el \{\
+.        \" if a previous call to 'doc-enclose-string' has already
+.        \" created a slot, prepend argument
+.        ie \ndoc-have-slot \
+.          ds doc-arg\ndoc-reg-des "\*doc-quote-right\)\*doc-arg\ndoc-reg-des
+.        el \{\
+.          \" we have to shift all arguments to the right
+.          nr doc-reg-des +1
+.          nr doc-reg-des1 \ndoc-arg-count
+.          nr doc-reg-des2 (\ndoc-arg-count + 1)
+.          while (\ndoc-reg-des1 >= \ndoc-reg-des) \{\
+.            rn doc-arg\ndoc-reg-des1 doc-arg\ndoc-reg-des2
+.            rnn doc-type\ndoc-reg-des1 doc-type\ndoc-reg-des2
+.            rn doc-space\ndoc-reg-des1 doc-space\ndoc-reg-des2
+.            nr doc-reg-des1 -1
+.            nr doc-reg-des2 -1
+.          \}
+.          nr doc-arg-count +1
+.
+.          \" finally, insert closing delimiter into the freed slot and
+.          \" recompute spacing vector
+.          ds doc-arg\ndoc-reg-des "\)\*doc-quote-right\)
+.          nr doc-type\ndoc-reg-des 3
+.          nr doc-num-args (\ndoc-arg-count - \ndoc-reg-des + 1)
+.          nr doc-arg-count (\ndoc-reg-des - 1)
+.          doc-parse-space-vector
+.          nr doc-have-slot 1
+.    \}\}\}
+.
+.    doc-do-\ndoc-type\ndoc-arg-ptr
+.  \}
+.
+.  if \ndoc-in-synopsis-section \
+.    doc-set-soft-space
+..
+.ec
+.
+.
+.\" NS En user macro
+.\" NS   enclose arguments with quotation characters set up with '.Es'
+.
+.als En doc-enclose-string
+.
+.
+.\" NS Ao user macro
+.\" NS   angle open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Ao' set in doc-common
+.
+.eo
+.de Ao
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Ao
+.
+.  ie "\*doc-macro-name"An" \
+.    ds doc-quote-left <
+.  el \
+.    ds doc-quote-left \la
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Ac user macro
+.\" NS   angle close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Ac' set in doc-common
+.
+.eo
+.de Ac
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Ac
+.
+.  ie "\*doc-macro-name"An" \
+.    ds doc-quote-right >
+.  el \
+.    ds doc-quote-right \ra
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Bo user macro
+.\" NS   bracket open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Bo' set in doc-common
+.
+.eo
+.de Bo
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Bo
+.
+.  ds doc-quote-left "\*doc-left-bracket
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Bc user macro
+.\" NS   bracket close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Bc' set in doc-common
+.
+.eo
+.de Bc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Bc
+.
+.  ds doc-quote-right "\*doc-right-bracket
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Bro user macro
+.\" NS   brace open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Bro' set in doc-common
+.
+.eo
+.de Bro
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Bo
+.
+.  ds doc-quote-left {
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Brc user macro
+.\" NS   brace close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Brc' set in doc-common
+.
+.eo
+.de Brc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Bc
+.
+.  ds doc-quote-right }
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Do user macro
+.\" NS   double quote open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Do' set in doc-common
+.
+.eo
+.de Do
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Do
+.
+.  ds doc-quote-left "\*Lq
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Dc user macro
+.\" NS   double quote close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Dc' set in doc-common
+.
+.eo
+.de Dc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Dc
+.
+.  ds doc-quote-right "\*Rq
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Eo user macro
+.\" NS   enclose open (using first argument as beginning of enclosure)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Eo' set in doc-common
+.
+.eo
+.de Eo
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Eo
+.
+.  ds doc-quote-left "\$1
+.
+.  shift
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Ec user macro
+.\" NS   enclose close (using first argument as end of enclosure)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Ec' set in doc-common
+.
+.eo
+.de Ec
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Ec
+.
+.  ds doc-quote-right "\$1
+.
+.  shift
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Oo user macro
+.\" NS   option open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Oo' set in doc-common
+.
+.eo
+.de Oo
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Oo
+.
+.  ds doc-quote-left 
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Oc user macro
+.\" NS   option close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Oc' set in doc-common
+.
+.eo
+.de Oc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Oc
+.
+.  ds doc-quote-right 
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Po user macro
+.\" NS   parenthesis open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Po' set in doc-common
+.
+.eo
+.de Po
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Po
+.
+.  ds doc-quote-left "\*doc-left-parenthesis
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Pc user macro
+.\" NS   parenthesis close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Pc' set in doc-common
+.
+.eo
+.de Pc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Pc
+.
+.  ds doc-quote-right "\*doc-right-parenthesis
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Qo user macro
+.\" NS   straight double quote open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Qo' set in doc-common
+.
+.eo
+.de Qo
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Qo
+.
+.  ds doc-quote-left "\*q
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Qc user macro
+.\" NS   straight double quote close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Qc' set in doc-common
+.
+.eo
+.de Qc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Qc
+.
+.  ds doc-quote-right "\*q
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS So user macro
+.\" NS   single quote open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'So' set in doc-common
+.
+.eo
+.de So
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name So
+.
+.  ds doc-quote-left "\*doc-left-singlequote
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Sc user macro
+.\" NS   single quote close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Sc' set in doc-common
+.
+.eo
+.de Sc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Sc
+.
+.  ds doc-quote-right "\*doc-right-singlequote
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS Xo user macro
+.\" NS   extend open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Xo' set in doc-common
+.
+.eo
+.de Xo
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Xo
+.
+.  ds doc-quote-left
+.
+.  doc-enclose-open \$@
+..
+.ec
+.
+.
+.\" NS Xc user macro
+.\" NS   extend close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Xc' set in doc-common
+.
+.eo
+.de Xc
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Xc
+.
+.  ds doc-quote-right
+.
+.  doc-enclose-close \$@
+..
+.ec
+.
+.
+.\" NS doc-nesting-level global register
+.\" NS   used by 'doc-enclose-open' and 'doc-enclose-close'
+.
+.nr doc-nesting-level 0
+.
+.
+.\" NS doc-in-list global register (bool)
+.\" NS   whether we are in (logical) .It
+.
+.nr doc-in-list 0
+.
+.
+.\" NS doc-enclose-open macro
+.\" NS   enclose string open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-nesting-level
+.
+.eo
+.de doc-enclose-open
+.  if !\ndoc-arg-count \
+.    doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  nr doc-arg-ptr -1
+.
+.  nop \)\*doc-quote-left\)\c
+.
+.  \" start enclosure box
+.  box doc-enclosure-box\ndoc-nesting-level
+.  ev doc-enclosure-env\ndoc-nesting-level
+.  evc 0
+.  in 0
+.  nf
+.  \" we insert something to make .chop always work
+.  nop \&\c
+.
+.  \" increase nesting level *after* parsing of arguments
+.  nr doc-nesting-level +1
+.
+.  if \ndoc-arg-count \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.      doc-print-recursive
+.    el \
+.      doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-enclose-close macro
+.\" NS   enclose string close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-nesting-level
+.
+.eo
+.de doc-enclose-close
+.  nr doc-nesting-level -1
+.
+.  \" finish enclosure box
+.  br
+.  ev
+.  box
+.  chop doc-enclosure-box\ndoc-nesting-level
+.  unformat doc-enclosure-box\ndoc-nesting-level
+.
+.  nh
+.  nop \*doc-enclosure-box\ndoc-nesting-level\c
+.  nop \)\*doc-quote-right\)\c
+.
+.  if !\ndoc-arg-count \{\
+.    doc-parse-args \$@
+.
+.    if !\n.$ \
+.      doc-print-and-reset
+.  \}
+.
+.  if \ndoc-arg-count \{\
+.    ie (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.      nop \)\*doc-space\ndoc-arg-ptr\c
+.      nr doc-arg-ptr +1
+.      doc-print-recursive
+.    \}
+.    el \
+.      doc-print-and-reset
+.  \}
+.
+.  \" shall we finish .It macro?
+.  if !"\*doc-macro-name"It" \
+.    if \ndoc-in-list \
+.      if !\ndoc-nesting-level \
+.        doc-\*doc-list-type-stack\ndoc-list-depth
+..
+.ec
+.
+.
+.\" NS Pf user macro
+.\" NS   prefix: '.Pf prefix arg ...'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS
+.\" NS width register 'Pf' set in doc-common
+.
+.eo
+.de Pf
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Pf
+.
+.  ie \ndoc-arg-count \{\
+.    ie ((\ndoc-arg-count - \ndoc-arg-ptr) > 1) \{\
+.      nr doc-arg-ptr +1
+.      nop \)\*doc-arg\ndoc-arg-ptr\c
+.    \}
+.    el \
+.      tm mdoc warning: .Pf: trailing prefix (#\n.c)
+.  \}
+.  el \{\
+.    nop \)\$1\)\c
+.    shift
+.    ie \n.$ \
+.      doc-parse-args \$@
+.    el \{\
+.      tm mdoc warning: .Pf: missing arguments (#\n.c)
+.      nop \)
+.  \}\}
+.
+.  if \ndoc-arg-count \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count < \ndoc-arg-ptr) \
+.      doc-print-and-reset
+.    el \
+.      doc-do-\ndoc-type\ndoc-arg-ptr
+.  \}
+..
+.ec
+.
+.
+.\" NS Ns user macro
+.\" NS   remove space (space removal done by 'doc-parse-args')
+.\" NS
+.\" NS modifies:
+.\" NS   doc-argXXX
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Ns' set in doc-common
+.
+.eo
+.de Ns
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Ns
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Ns must be called with arguments (#\n.c)
+.  \}
+.
+.  if \ndoc-arg-count \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.      doc-print-recursive
+.    el \
+.      doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Ap user macro
+.\" NS   append an apostrophe
+.\" NS
+.\" NS width register 'Ap' set in doc-common
+.
+.eo
+.de Ap
+.  ie !\ndoc-arg-count \
+.    tm Usage: 'Ap' cannot be first macro on a line (no '.Ap') (#\n.c)
+.  el \{\
+.    nop \)'\)\c
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.      doc-print-recursive
+.    el \
+.      doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-space global string
+.\" NS   current inter-argument space
+.
+.ds doc-space "\*doc-soft-space
+.
+.
+.\" NS doc-soft-space constant string
+.\" NS   soft (stretchable) space (defined in doc-common)
+.
+.
+.\" NS doc-hard-space constant string
+.\" NS   hard (unpaddable) space (defined in doc-common)
+.
+.
+.\" NS doc-set-hard-space macro
+.\" NS   set current space string to hard (unpaddable) space.
+.\" NS
+.\" NS modifies:
+.\" NS   doc-saved-space
+.\" NS   doc-space
+.
+.eo
+.de doc-set-hard-space
+.  ie "\*doc-space"" \
+.    ds doc-saved-space "\*doc-hard-space
+.  el \
+.    ds doc-space "\*doc-hard-space
+..
+.ec
+.
+.
+.\" NS doc-set-soft-space macro
+.\" NS   set current space string to soft space
+.\" NS
+.\" NS modifies:
+.\" NS   doc-saved-space
+.\" NS   doc-space
+.
+.eo
+.de doc-set-soft-space
+.  ie "\*doc-space"" \
+.    ds doc-saved-space "\*doc-soft-space
+.  el \
+.    ds doc-space "\*doc-soft-space
+..
+.ec
+.
+.
+.\" NS doc-space-mode global register (bool)
+.\" NS   default is one (space mode on)
+.
+.nr doc-space-mode 1
+.
+.
+.\" NS doc-saved-space global string
+.\" NS   saved value of 'doc-space'
+.
+.ds doc-saved-space "\*doc-space
+.
+.
+.\" NS doc-have-space global register (bool)
+.\" NS   set if last command was horizontal space
+.
+.nr doc-have-space 0
+.
+.
+.\" NS Sm user macro
+.\" NS   space mode ('.Sm'/'.Sm on'/'.Sm off')
+.\" NS
+.\" NS   without argument, toggle space mode
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-count
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-macro-name
+.\" NS   doc-num-args
+.\" NS   doc-saved-space
+.\" NS   doc-space
+.\" NS   doc-space-mode
+.\" NS   doc-spaceXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Sm
+.\" NS
+.\" NS width register 'Sm' set in doc-common
+.
+.eo
+.de Sm
+.  ie \ndoc-have-space \
+.    nr doc-reg-Sm 0
+.  el \
+.    nr doc-reg-Sm 1
+.
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Sm
+.      doc-parse-args \$@
+.    \}
+.    el \{\
+.      ie \ndoc-space-mode \{\
+.        ds doc-saved-space "\*doc-space
+.        ds doc-space
+.        nr doc-space-mode 0
+.      \}
+.      el \{\
+.        ds doc-space "\*doc-saved-space
+.        nr doc-space-mode 1
+.
+.        \" finish line only if it is interrupted and 'doc-have-space'
+.        \" isn't set
+.        if \ndoc-reg-Sm \
+.          if \n.int \
+.            nop \)
+.      \}
+.  \}\}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.
+.  \" avoid a warning message in case 'Sm' is the last parameter
+.  if !d doc-arg\ndoc-arg-ptr \
+.    ds doc-arg\ndoc-arg-ptr
+.
+.  ie "\*doc-arg\ndoc-arg-ptr"on" \{\
+.    ds doc-space "\*doc-saved-space
+.    nr doc-space-mode 1
+.  \}
+.  el \{\
+.    ie "\*doc-arg\ndoc-arg-ptr"off" \{\
+.      ds doc-saved-space "\*doc-space
+.      ds doc-space
+.      nr doc-space-mode 0
+.    \}
+.    el \{\
+.      \" no argument for Sm
+.      nr doc-arg-ptr -1
+.      ie \ndoc-space-mode \{\
+.        ds doc-saved-space "\*doc-space
+.        ds doc-space
+.        nr doc-space-mode 0
+.      \}
+.      el \{\
+.        ds doc-space "\*doc-saved-space
+.        nr doc-space-mode 1
+.      \}
+.  \}\}
+.
+.  ie \ndoc-space-mode \{\
+.    \" recompute space vector for remaining arguments
+.    nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.    nr doc-arg-count \ndoc-arg-ptr
+.    if \ndoc-num-args \
+.      doc-parse-space-vector
+.
+.    \" finish line only if it is interrupted and 'doc-have-space'
+.    \" isn't set
+.    if \ndoc-reg-Sm \
+.      if \n.int \
+.        nop \)
+.  \}
+.  el \{\
+.    \" reset remaining space vector elements
+.    nr doc-reg-Sm (\ndoc-arg-ptr + 1)
+.    while (\ndoc-reg-Sm <= \ndoc-arg-count) \{\
+.      ds doc-space\ndoc-reg-Sm
+.      nr doc-reg-Sm +1
+.      \" the body of a 'while' request must end with the fitting '\}'!
+.    \}
+.  \}
+.
+.  \" do we have parameters to print?
+.  ie (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    \" skip 'Sm' argument
+.    nr doc-arg-ptr +1
+.    doc-print-recursive
+.  \}
+.  el \
+.    doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-arg-type immediate register
+.\" NS   argument type (macro=1, string=2, punctuation suffix=3,
+.\" NS   punctuation prefix=4)
+.
+.nr doc-arg-type 0
+.
+.
+.\" NS doc-get-arg-type macro
+.\" NS   get argument type
+.\" NS
+.\" NS   this macro expects the width of the argument in 'doc-width'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-type
+.
+.eo
+.de doc-get-arg-type
+.  nr doc-arg-type 2
+.
+.  if ((\ndoc-width < 4) & \A'\$1') \{\
+.    ie (\ndoc-width == 1) \{\
+.      if r doc-punct\$1 \
+.        nr doc-arg-type \ndoc-punct\$1
+.    \}
+.    el \
+.      if r \$1 \
+.        if d \$1 \
+.          nr doc-arg-type 1
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-get-arg-type* macro
+.\" NS   similar to as 'doc-get-arg-type' but uses doc-argXXX strings
+.\" NS
+.\" NS   this macro sets the 'doc-width' register using the 'length'
+.\" NS   request to get the number of characters in a string literally
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-type
+.\" NS   doc-width
+.
+.eo
+.de doc-get-arg-type*
+.  nr doc-arg-type 2
+.  length doc-width "\*doc-arg\$1
+.
+.  if ((\ndoc-width < 4) & \A'\*doc-arg\$1') \{\
+.    ie (\ndoc-width == 1) \{\
+.      if r doc-punct\*doc-arg\$1 \
+.        nr doc-arg-type \ndoc-punct\*doc-arg\$1
+.    \}
+.    el \
+.      if r \*doc-arg\$1 \
+.        if d \*doc-arg\$1 \
+.          nr doc-arg-type 1
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-set-spacing-1 macro
+.\" NS   set spacing for macros
+.\" NS
+.\" NS modifies:
+.\" NS   doc-spaceXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dssfm
+.\" NS   doc-reg-dssfm1
+.
+.eo
+.de doc-set-spacing-1
+.  nr doc-reg-dssfm1 \n\*doc-arg\ndoc-arg-count
+.
+.  \" closing macros like .Ac, Bc., etc. have value 3 (remove space
+.  \" before argument)
+.  ie (\ndoc-reg-dssfm1 == 3) \{\
+.    if \ndoc-arg-count \{\
+.      nr doc-reg-dssfm (\ndoc-arg-count - 1)
+.      ds doc-space\ndoc-reg-dssfm
+.    \}
+.    ds doc-space\ndoc-arg-count "\*doc-space
+.  \}
+.  el \{\
+.    \" macros like .Ap and .Ns have value 2 (remove space before and
+.    \" after argument)
+.    ie (\ndoc-reg-dssfm1 == 2) \{\
+.      if \ndoc-arg-count \{\
+.        nr doc-reg-dssfm (\ndoc-arg-count - 1)
+.        ds doc-space\ndoc-reg-dssfm
+.      \}
+.      ds doc-space\ndoc-arg-count
+.    \}
+.    el \
+.      ds doc-space\ndoc-arg-count
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-set-spacing-2 macro
+.\" NS   set spacing for strings
+.\" NS
+.\" NS modifies:
+.\" NS   doc-spaceXXX
+.
+.eo
+.de doc-set-spacing-2
+.  ds doc-space\ndoc-arg-count "\*doc-space
+..
+.ec
+.
+.
+.\" NS doc-set-spacing-3 macro
+.\" NS   set spacing for punctuation suffixes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-spaceXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dssfps
+.
+.eo
+.de doc-set-spacing-3
+.  if \ndoc-arg-count \{\
+.    nr doc-reg-dssfps (\ndoc-arg-count - 1)
+.    ds doc-space\ndoc-reg-dssfps
+.  \}
+.
+.  ds doc-space\ndoc-arg-count "\*doc-space
+..
+.ec
+.
+.
+.\" NS doc-set-spacing-4 macro
+.\" NS   set spacing for punctuation prefixes
+.\" NS
+.\" NS modifies:
+.\" NS   doc-spaceXXX
+.
+.eo
+.de doc-set-spacing-4
+.  ds doc-space\ndoc-arg-count
+..
+.ec
+.
+.
+.\" type switches (on current argument doc-arg-ptr)
+.
+.
+.\" NS doc-do-1 macro
+.\" NS   call request if macro
+.
+.eo
+.de doc-do-1
+.  \*doc-arg\ndoc-arg-ptr
+..
+.ec
+.
+.
+.\" NS doc-do-2 macro
+.\" NS   call .doc-print-recursive if string
+.
+.als doc-do-2 doc-print-recursive
+.
+.
+.\" NS doc-do-3 macro
+.\" NS   call .doc-print-recursive if punctuation suffix
+.
+.als doc-do-3 doc-print-recursive
+.
+.
+.\" NS doc-do-4 macro
+.\" NS   call .doc-print-recursive if punctuation prefix
+.
+.als doc-do-4 doc-print-recursive
+.
+.
+.\" NS doc-fontmode-depth global register
+.\" NS   font mode level
+.
+.nr doc-fontmode-depth 0
+.
+.
+.\" NS doc-fontmode-font-stackXXX global register
+.\" NS   stack of saved current font values from 'Bf' macro
+.\" NS
+.\" NS limit:
+.\" NS   doc-fontmode-depth
+.
+.nr doc-fontmode-font-stack0 0
+.
+.
+.\" NS doc-fontmode-size-stackXXX global register
+.\" NS   stack of saved current size values from 'Bf' macro
+.\" NS
+.\" NS limit:
+.\" NS   doc-fontmode-depth
+.
+.nr doc-fontmode-size-stack0 0
+.
+.
+.\" NS Bf user macro
+.\" NS   begin font mode (will be begin-mode/end-mode in groff & TeX)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-fontmode-depth
+.\" NS   doc-fontmode-font-stackXXX
+.\" NS   doc-fontmode-size-stackXXX
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Bf' set in doc-common
+.
+.eo
+.de Bf
+.  ds doc-macro-name Bf
+.
+.  ie \n.$ \{\
+.    nr doc-fontmode-depth +1
+.
+.    \" save current font and size
+.    nr doc-fontmode-font-stack\ndoc-fontmode-depth \n.f
+.    nr doc-fontmode-size-stack\ndoc-fontmode-depth \n.ps
+.
+.    ie        "\$1"Em" \
+.      nop \*doc-Em-font\c
+.    el \{ .ie "\$1"Li" \
+.      nop \*doc-Li-font\c
+.    el \{ .ie "\$1"Sy" \
+.      nop \*doc-Sy-font\c
+.    el \{ .ie "\$1"-emphasis" \
+.      nop \*doc-Em-font\c
+.    el \{ .ie "\$1"-literal" \
+.      nop \*doc-Li-font\c
+.    el \{ .ie "\$1"-symbolic" \
+.      nop \*doc-Sy-font\c
+.    el \{\
+.      tmc mdoc warning: Unknown keyword '\$1' in .Bf macro
+.      tm1 " (#\n.c)
+.  \}\}\}\}\}\}\}
+.  el \
+.    tm Usage: .Bf Em | -emphasis | Li | -literal | Sy | -symbolic (#\n.c)
+..
+.ec
+.
+.
+.\" NS Ef user macro
+.\" NS   end font mode
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Ef' set in doc-common
+.
+.eo
+.de Ef
+.  ds doc-macro-name Ef
+.
+.  ie \ndoc-fontmode-depth \{\
+.    \" restore saved font and size
+.    nop \)\f\ndoc-fontmode-font-stack\ndoc-fontmode-depth\c
+.    nop \)\s\ndoc-fontmode-size-stack\ndoc-fontmode-depthu\c
+.
+.    nr doc-fontmode-font-stack\ndoc-fontmode-depth 0
+.    nr doc-curr-font \n.f
+.    nr doc-fontmode-size-stack\ndoc-fontmode-depth 0
+.    nr doc-fontmode-depth -1
+.  \}
+.  el \
+.    tm mdoc warning: Extraneous .Ef (#\n.c)
+..
+.ec
+.
+.
+.\" NS doc-keep-type global register
+.\" NS   current keep type; 1 is '-words', 2 is '-lines', 3 is unknown
+.
+.nr doc-keep-type 0
+.
+.
+.\" NS Bk user macro
+.\" NS   begin keep
+.\" NS
+.\" NS modifies:
+.\" NS   doc-keep-type
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Bk' set in doc-common
+.
+.eo
+.de Bk
+.  ds doc-macro-name Bk
+.
+.  if \ndoc-keep-type \
+.    tm .Bk: nesting keeps not implemented yet. (#\n.c)
+.
+.  ie        "\$1"-lines" \{\
+.    nr doc-keep-type 2
+.    tm .Bk -lines: Not implemented yet. (#\n.c)
+.  \}
+.  el \{ .ie "\$1"-words" \{\
+.    nr doc-keep-type 1
+.    doc-set-hard-space
+.  \}
+.  el \{ .ie "\$1"" \{\
+.    \" default
+.    nr doc-keep-type 1
+.    doc-set-hard-space
+.  \}
+.  el \{\
+.    tm mdoc warning: Unknown keyword '\$1' in .Bk macro (#\n.c)
+.    nr doc-keep-type 3
+.  \}\}\}
+.
+\#.  nr doc-nesting-level +1
+..
+.ec
+.
+.
+.\" NS Ek user macro
+.\" NS   end keep
+.\" NS
+.\" NS modifies:
+.\" NS   doc-keep-type
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Ek' set in doc-common
+.
+.eo
+.de Ek
+.  ds doc-macro-name Ek
+.
+\#.  nr doc-nesting-level -1
+.
+.  ie \n.$ \
+.    tm Usage: .Ek (does not take arguments) (#\n.c)
+.  el \{\
+.    if !\ndoc-keep-type \
+.      tm mdoc warning: .Ek found without .Bk before (#\n.c)
+.
+.    ie        (\ndoc-keep-type == 1) \
+.      doc-set-soft-space
+.    el \{ .if (\ndoc-keep-type == 2) \
+.      tm .Bk -lines: Not implemented yet. (#\n.c)
+.  \}\}
+.
+.  nr doc-keep-type 0
+.
+\#.  if !"\*doc-out-string"" \
+\#.    doc-print-out-string
+..
+.ec
+.
+.
+.\" NS doc-display-depth global register
+.\" NS   display level
+.
+.nr doc-display-depth 0
+.
+.
+.\" NS doc-is-compact global register (bool)
+.\" NS   set if the 'compact' keyword is given
+.
+.nr doc-is-compact 0
+.
+.
+.\" NS doc-display-type-stackXXX global string
+.\" NS   the display type stack
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.ds doc-display-type-stack0
+.
+.
+.\" NS doc-display-indent-stackXXX global register
+.\" NS   stack of display indentation values
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.nr doc-display-indent-stack0 0
+.
+.
+.\" NS doc-display-ad-stackXXX global register
+.\" NS   stack of saved adjustment modes
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.nr doc-display-ad-stack0 0
+.
+.
+.\" NS doc-display-fi-stackXXX global register
+.\" NS   stack of saved fill modes
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.nr doc-display-fi-stack0 0
+.
+.
+.\" NS doc-display-ft-stackXXX global register
+.\" NS   stack of saved fonts
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.nr doc-display-ft-stack0 0
+.
+.
+.\" NS doc-display-ps-stackXXX global register
+.\" NS   stack of saved font sizes
+.\" NS
+.\" NS limit:
+.\" NS   doc-display-depth
+.
+.nr doc-display-ps-stack0 0
+.
+.
+.\" NS Bd user macro
+.\" NS   begin display
+.\" NS
+.\" NS width register 'Bd' set in doc-common
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS   doc-display-depth
+.\" NS   doc-display-ad-stackXXX
+.\" NS   doc-display-fi-stackXXX
+.\" NS   doc-display-ft-stackXXX
+.\" NS   doc-display-ps-stackXXX
+.\" NS   doc-display-file
+.\" NS   doc-display-indent-stackXXX
+.\" NS   doc-display-type-stackXXX
+.\" NS   doc-is-compact
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Bd
+.
+.eo
+.de Bd
+.  ds doc-macro-name Bd
+.
+.  if !\n.$ \{\
+.    tm1 "Usage: .Bd {-literal | -filled | -ragged | -centered | -unfilled}
+.    tm1 "           -offset string -compact -file name (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-is-compact 0
+.  ds doc-display-file
+.  nr doc-reg-Bd 1
+.  nr doc-display-depth +1
+.
+.  \" save current adjustment and fill modes
+.  nr doc-display-ad-stack\ndoc-display-depth \n.j
+.  nr doc-display-fi-stack\ndoc-display-depth \n.u
+.
+.  ie        "\$1"-literal" \{\
+.    ds doc-display-type-stack\ndoc-display-depth literal
+.    nr doc-display-ft-stack\ndoc-display-depth \n.f
+.    nr doc-display-ps-stack\ndoc-display-depth \n.ps
+.
+.    ie t \
+.      ta T 9n
+.    el \
+.      ta T 8n
+.    nf
+.  \}
+.  el \{ .ie "\$1"-filled" \{\
+.    ds doc-display-type-stack\ndoc-display-depth filled
+.    ad b
+.    fi
+.  \}
+.  el \{ .ie "\$1"-ragged" \{\
+.    ds doc-display-type-stack\ndoc-display-depth ragged
+.    na
+.    fi
+.  \}
+.  el \{ .ie "\$1"-centered" \{\
+.    ds doc-display-type-stack\ndoc-display-depth centered
+.    ad c
+.    fi
+.  \}
+.  el \{ .ie "\$1"-unfilled" \{\
+.    ds doc-display-type-stack\ndoc-display-depth unfilled
+.    nf
+.  \}
+.  el \{\
+.    tm1 "mdoc warning: Unknown keyword '\$1' (or missing display type)
+.    tm1 "              in .Bd macro (#\n.c)
+.    nr doc-reg-Bd 0
+.  \}\}\}\}\}
+.
+.  \" have we seen an argument?
+.  if \ndoc-reg-Bd \{\
+.    shift
+.    \" check other arguments
+.    if \n.$ \
+.      doc-do-Bd-args \$@
+.  \}
+.
+.  \" avoid warning about non-existent register
+.  if !r doc-display-indent-stack\ndoc-display-depth \
+.    nr doc-display-indent-stack\ndoc-display-depth 0
+.
+.  if \ndoc-display-indent-stack\ndoc-display-depth \
+.    in +\ndoc-display-indent-stack\ndoc-display-depthu
+.
+.  if !\ndoc-is-compact \
+.    sp \ndoc-display-verticalu
+.
+.  if "\*doc-display-type-stack\ndoc-display-depth"literal" \
+.    if t \
+.      nop \*doc-Li-font\c
+.
+.  if !\ncR \
+.    ne 2v
+.
+.  if !"\*doc-display-file"" \
+.    so \*doc-display-file
+.
+.  nr doc-is-compact 0
+.  ds doc-display-file
+..
+.ec
+.
+.
+.\" NS doc-do-Bd-args macro
+.\" NS   resolve remaining .Bd arguments
+.\" NS
+.\" NS modifies:
+.\" NS   doc-display-file
+.\" NS   doc-display-indent-stackXXX
+.\" NS   doc-is-compact
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-ddBa
+.\" NS   doc-reg-ddBa1
+.\" NS   doc-reg-ddBa2
+.\" NS   doc-reg-ddBa3
+.\" NS   doc-reg-ddBa4
+.\" NS   doc-str-ddBa
+.
+.eo
+.de doc-do-Bd-args
+.  nr doc-reg-ddBa 1
+.
+.  ie        "\$1"-offset" \{\
+.    nr doc-reg-ddBa 2
+.
+.    ie        "\$2"left" \
+.      nr doc-display-indent-stack\ndoc-display-depth 0
+.    el \{ .ie "\$2"right" \
+.      nr doc-display-indent-stack\ndoc-display-depth (\n.lu / 3u)
+.    el \{ .ie "\$2"center" \
+.      nr doc-display-indent-stack\ndoc-display-depth ((\n.lu - \n.iu) / 4u)
+.    el \{ .ie "\$2"indent" \
+.      nr doc-display-indent-stack\ndoc-display-depth \ndoc-display-indentu
+.    el \{ .ie "\$2"indent-two" \
+.      nr doc-display-indent-stack\ndoc-display-depth (\ndoc-display-indentu + \ndoc-display-indentu)
+.    el \
+.      nr doc-reg-ddBa 1
+.    \}\}\}\}
+.
+.    \" not a known keyword
+.    if (\ndoc-reg-ddBa == 1) \{\
+.      nr doc-reg-ddBa 2
+.
+.      nr doc-reg-ddBa1 0
+.      if \B'(\$2)' \{\
+.        \" disable warnings related to scaling indicators (32)
+.        nr doc-reg-ddBa2 \n.warn
+.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
+.
+.        \" values without a scaling indicator are taken as strings;
+.        \" we test whether the parameter string with and without the
+.        \" last character yields identical numerical results (ignoring
+.        \" the scaling indicator)
+.        ds doc-str-ddBa "\$2
+.        substring doc-str-ddBa 0 -2
+.        if \B'(\*doc-str-ddBa)' \{\
+.          nr doc-reg-ddBa3 (;(\$2))
+.          nr doc-reg-ddBa4 (\*doc-str-ddBa)
+.          if (\ndoc-reg-ddBa3 == \ndoc-reg-ddBa4) \
+.            nr doc-reg-ddBa1 1
+.        \}
+.
+.        \" enable all warnings again
+.        warn \ndoc-reg-ddBa2
+.      \}
+.
+.      ie \ndoc-reg-ddBa1 \
+.        nr doc-display-indent-stack\ndoc-display-depth \$2
+.      el \{\
+.        doc-get-width "\$2"
+.        ie (\ndoc-width <= 3) \{\
+.          \" if the offset parameter is a macro, use the macro's
+.          \" width as specified in doc-common
+.          doc-get-arg-type "\$2"
+.          ie (\ndoc-arg-type == 1) \
+.            nr doc-display-indent-stack\ndoc-display-depth \n\$2
+.          el \
+.            nr doc-display-indent-stack\ndoc-display-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.        \}
+.        el \
+.          nr doc-display-indent-stack\ndoc-display-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.    \}\}
+.  \}
+.  el \{ .ie "\$1"-compact" \
+.    nr doc-is-compact 1
+.  el \{ .ie "\$1"-file" \{\
+.    ie !"\$2"" \{\
+.      ds doc-display-file "\$2
+.      nr doc-reg-ddBa 2
+.    \}
+.    el \
+.      tm mdoc warning: .Bd '-file' keyword requires argument (#\n.c)
+.  \}
+.  el \
+.      tm mdoc warning: Unknown keyword '\$1' in .Bd macro (#\n.c)
+.  \}\}
+.
+.  if (\ndoc-reg-ddBa < \n.$) \{\
+.    shift \ndoc-reg-ddBa
+.    doc-do-Bd-args \$@
+.  \}
+..
+.ec
+.
+.
+.\" NS Ed user macro
+.\" NS   end display
+.\" NS
+.\" NS modifies:
+.\" NS   doc-display-depth
+.\" NS   doc-display-indent-stackXXX
+.\" NS   doc-display-type-stackXXX
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Ed' set in doc-common
+.
+.eo
+.de Ed
+.  ds doc-macro-name Ed
+.
+.  br
+.
+.  if !\ndoc-display-depth \{\
+.    tm mdoc warning: Extraneous .Ed (#\n.c)
+.    nr doc-display-depth 1
+.  \}
+.
+.  if "\*doc-display-type-stack\ndoc-display-depth"literal" \{\
+.    ft \ndoc-display-ft-stack\ndoc-display-depth
+.    ps \ndoc-display-ps-stack\ndoc-display-depthu
+.  \}
+.
+.  in -\ndoc-display-indent-stack\ndoc-display-depthu
+.
+.  \" restore saved adjustment and fill modes
+.  ie \ndoc-display-fi-stack\ndoc-display-depth \
+.    fi
+.  el \
+.    nf
+.  ad \ndoc-display-ad-stack\ndoc-display-depth
+.
+.  nr doc-display-indent-stack\ndoc-display-depth 0
+.  ds doc-display-type-stack\ndoc-display-depth
+.  nr doc-display-depth -1
+..
+.ec
+.
+.
+.\" NS doc-list-type-stackXXX global string
+.\" NS   stack of list types
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.ds doc-list-type-stack1
+.
+.
+.\" NS doc-list-indent-stackXXX global register
+.\" NS   stack of list indentation values
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.nr doc-list-indent-stack1 0
+.
+.
+.\" NS doc-list-have-indent-stackXXX global register (bool)
+.\" NS   an indentation value is active
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.nr doc-list-have-indent-stack1 0
+.
+.
+.\" NS Bl user macro
+.\" NS   begin list
+.\" NS
+.\" NS width register 'Bl' set in doc-common
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-list-depth
+.\" NS   doc-list-have-indent-stackXXX
+.\" NS   doc-list-indent-stackXXX
+.\" NS   doc-list-type-stackXXX
+.\" NS   doc-macro-name
+.\" NS   doc-num-args
+.\" NS   doc-num-columns
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Bl
+.
+.eo
+.de Bl
+.  if !\n.$ \{\
+.    doc-Bl-usage
+.    return
+.  \}
+.
+.  ds doc-macro-name Bl
+.  nr doc-list-depth +1
+.  nr doc-arg-ptr 1
+.
+.  ie        "\$1"-hang" \{\
+.    ds doc-list-type-stack\ndoc-list-depth hang-list
+.    nr doc-list-indent-stack\ndoc-list-depth 6n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-tag" \{\
+.    ds doc-list-type-stack\ndoc-list-depth tag-list
+.    nr doc-list-indent-stack\ndoc-list-depth 6n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-item" \{\
+.    ds doc-list-type-stack\ndoc-list-depth item-list
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-enum" \{\
+.    ds doc-list-type-stack\ndoc-list-depth enum-list
+.    nr doc-list-indent-stack\ndoc-list-depth 3n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-bullet" \{\
+.    ds doc-list-type-stack\ndoc-list-depth bullet-list
+.    nr doc-list-indent-stack\ndoc-list-depth 2n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-dash" \{\
+.    ds doc-list-type-stack\ndoc-list-depth dash-list
+.    nr doc-list-indent-stack\ndoc-list-depth 2n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-hyphen" \{\
+.    ds doc-list-type-stack\ndoc-list-depth dash-list
+.    nr doc-list-indent-stack\ndoc-list-depth 2n
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-inset" \{\
+.    ds doc-list-type-stack\ndoc-list-depth inset-list
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-diag" \{\
+.    ds doc-list-type-stack\ndoc-list-depth diag-list
+.  \}
+.  el \{ .ie "\$1"-ohang" \{\
+.    ds doc-list-type-stack\ndoc-list-depth ohang-list
+.    nr doc-list-have-indent-stack\ndoc-list-depth 1
+.  \}
+.  el \{ .ie "\$1"-column" \{\
+.    ds doc-list-type-stack\ndoc-list-depth column-list
+.    linetabs 1
+.  \}
+.  el \{\
+.    tm1 "mdoc warning: Unknown list type '\$1' (or missing list type)
+.    tm1 "              in .Bl macro
+.    tm
+.    nr doc-arg-ptr 0
+.  \}\}\}\}\}\}\}\}\}\}\}
+.
+.  \" we have seen a list type
+.  if !\ndoc-arg-ptr \{\
+.    doc-Bl-usage
+.    doc-reset-args
+.    nr doc-list-depth -1
+.    return
+.  \}
+.
+.  shift
+.
+.  \" fill argument vector
+.  nr doc-reg-Bl 1
+.  while (\ndoc-reg-Bl <= \n.$) \{\
+.    ds doc-arg\ndoc-reg-Bl "\$\ndoc-reg-Bl
+.    \" dummy type and space so that doc-save-global-vars() doesn't warn
+.    nr doc-type\ndoc-reg-Bl 0
+.    ds doc-space\ndoc-reg-Bl
+.    nr doc-reg-Bl +1
+.  \}
+.
+.  doc-increment-list-stack
+.
+.  if \n.$ \{\
+.    nr doc-arg-count \n.$
+.    nr doc-arg-ptr 0
+.    doc-do-Bl-args
+.
+.    in +\ndoc-list-offset-stack\ndoc-list-depthu
+.
+.    \" initialize column list
+.    if "\*doc-list-type-stack\ndoc-list-depth"column-list" \{\
+.      doc-set-column-tab \ndoc-num-columns
+'      in -\ndoc-column-indent-widthu
+.      if !\ndoc-compact-list-stack\ndoc-list-depth \
+.        sp \ndoc-display-verticalu
+.
+.      nf
+.      nr doc-num-columns 0
+.  \}\}
+.
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-Bl-usage macro
+.
+.eo
+.de doc-Bl-usage
+.  tm1 "Usage: .Bl {-hang | -ohang | -tag | -diag | -inset}
+.  tm1 "             -width <string>
+.  tm1 "             -offset <string> -compact
+.  tm1 "       .Bl -column -offset <string> <string1> <string2> ...
+.  tm1 "       .Bl {-item | -enum -nested | -bullet | -hyphen | -dash}
+.  tm1 "             -offset <string> -compact (#\n.c)
+..
+.ec
+.
+.
+.\" NS doc-do-Bl-args macro
+.\" NS   resolve remaining .Bl arguments
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-compact-list-stackXXX
+.\" NS   doc-list-indent-stackXXX
+.\" NS   doc-list-offset-stackXXX
+.\" NS   doc-num-columns
+.\" NS   doc-tag-prefix-stackXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-box-dBla
+.\" NS   doc-env-dBla
+.\" NS   doc-reg-dBla
+.\" NS   doc-reg-dBla1
+.\" NS   doc-reg-dBla2
+.\" NS   doc-reg-dBla3
+.\" NS   doc-reg-dBla4
+.\" NS   doc-str-dBla
+.\" NS   doc-str-dBla1
+.
+.eo
+.de doc-do-Bl-args
+.  nr doc-arg-ptr +1
+.
+.  if (\ndoc-arg-count < \ndoc-arg-ptr) \
+.    return
+.
+.  \" avoid a warning message in case e.g. '-offset' has no parameter
+.  nr doc-reg-dBla (\ndoc-arg-ptr + 1)
+.  if (\ndoc-arg-count < \ndoc-reg-dBla) \
+.    ds doc-arg\ndoc-reg-dBla
+.
+.  nr doc-reg-dBla 1
+.
+.  ie        "\*doc-arg\ndoc-arg-ptr"-compact" \
+.    nr doc-compact-list-stack\ndoc-list-depth 1
+.
+.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-nested" \{\
+.    ie (\ndoc-list-depth > 1) \{\
+.      nr doc-reg-dBla1 (\ndoc-list-depth - 1)
+.      ds doc-tag-prefix-stack\ndoc-list-depth "\*doc-tag-prefix-stack\ndoc-reg-dBla1
+.      as doc-tag-prefix-stack\ndoc-list-depth \ndoc-enum-list-count-stack\ndoc-reg-dBla1.
+.      length doc-reg-dBla1 "\*doc-tag-prefix-stack\ndoc-list-depth
+.      nr doc-list-indent-stack\ndoc-list-depth +\ndoc-reg-dBla1n
+.    \}
+.    el \
+.      tm mdoc warning: '-nested' allowed with nested .Bl macros only (#\n.c)
+.  \}
+.
+.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-width" \{\
+.    nr doc-arg-ptr +1
+.    ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.    substring doc-str-dBla 0 0
+.    ie '.'\*doc-str-dBla' \{\
+.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.      substring doc-str-dBla 1
+.      doc-first-parameter \*doc-str-dBla
+.      doc-get-width "\*doc-str-dfp
+.      doc-get-arg-type "\*doc-str-dfp
+.      ie (\ndoc-arg-type == 1) \
+.        nr doc-reg-dBla1 1
+.      el \
+.        nr doc-reg-dBla1 0
+.    \}
+.    el \
+.      nr doc-reg-dBla1 0
+.    ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.
+.    ie \ndoc-reg-dBla1 \{\
+.      \" execute string in a box to get the width of the diversion
+.      ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
+.      doc-save-global-vars
+.      doc-reset-args
+.      box doc-box-dBla
+.      ev doc-env-dBla
+.      evc 0
+.      in 0
+.      nf
+.      nop \*doc-str-dBla
+.      br
+.      ev
+.      box
+.      doc-restore-global-vars
+.      doc-get-width \h'\ndlu'
+.      nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.    \}
+.    el \{\
+.      \" test whether argument is a valid numeric expression
+.      nr doc-reg-dBla1 0
+.      if \B'(\*doc-str-dBla)' \{\
+.        \" disable warnings related to scaling indicators (32)
+.        nr doc-reg-dBla2 \n.warn
+.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
+.
+.        \" values without a scaling indicator are taken as strings;
+.        \" we test whether the parameter string with and without the
+.        \" last character yields identical numerical results (ignoring
+.        \" the scaling indicator)
+.        ds doc-str-dBla1 "\*doc-str-dBla
+.        substring doc-str-dBla1 0 -2
+.        if \B'(\*doc-str-dBla1)' \{\
+.          nr doc-reg-dBla3 (;(\*doc-str-dBla))
+.          nr doc-reg-dBla4 (\*doc-str-dBla1)
+.          if (\ndoc-reg-dBla3 == \ndoc-reg-dBla4) \
+.            nr doc-reg-dBla1 1
+.        \}
+.
+.        \" enable all warnings again
+.        warn \ndoc-reg-dBla2
+.      \}
+.
+.      ie \ndoc-reg-dBla1 \
+.        nr doc-list-indent-stack\ndoc-list-depth (\*doc-str-dBla)
+.      el \{\
+.        doc-get-arg-width \ndoc-arg-ptr
+.        ie (\ndoc-width == 2) \{\
+.          \" if the width parameter is a macro, use the macro's
+.          \" width as specified in doc-common
+.          doc-get-arg-type \*doc-str-dBla
+.          ie (\ndoc-arg-type == 1) \
+.            nr doc-list-indent-stack\ndoc-list-depth \n\*doc-str-dBla
+.          el \
+.            nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.        \}
+.        el \
+.          nr doc-list-indent-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.  \}\}\}
+.
+.  el \{ .ie "\*doc-arg\ndoc-arg-ptr"-offset" \{\
+.    nr doc-arg-ptr +1
+.
+.    ie "\*doc-arg\ndoc-arg-ptr"indent" \
+.      nr doc-list-offset-stack\ndoc-list-depth \ndoc-display-indentu
+.    el \{\
+.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.      nr doc-reg-dBla1 0
+.      if \B'(\*doc-str-dBla)' \{\
+.        nr doc-reg-dBla2 \n.warn
+.        warn (\n.warn - (\n.warn / 32 % 2 * 32))
+.
+.        ds doc-str-dBla1 "\*doc-str-dBla
+.        substring doc-str-dBla1 0 -2
+.        if \B'(\*doc-str-dBla1)' \{\
+.          nr doc-reg-dBla3 (;(\*doc-str-dBla))
+.          nr doc-reg-dBla4 (\*doc-str-dBla1)
+.          if (\ndoc-reg-dBla3 == \ndoc-reg-dBla4) \
+.            nr doc-reg-dBla1 1
+.        \}
+.
+.        warn \ndoc-reg-dBla2
+.      \}
+.
+.      ie \ndoc-reg-dBla1 \
+.        nr doc-list-offset-stack\ndoc-list-depth \*doc-str-dBla
+.      el \{\
+.        doc-get-arg-width \ndoc-arg-ptr
+.        ie (\ndoc-width <= 3) \{\
+.          \" if the offset parameter is a macro, use the macro's
+.          \" width as specified in doc-common
+.          doc-get-arg-type \*doc-str-dBla
+.          ie (\ndoc-arg-type == 1) \
+.            nr doc-list-offset-stack\ndoc-list-depth \n\*doc-str-dBla
+.          el \
+.            nr doc-list-offset-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.        \}
+.        el \
+.          nr doc-list-offset-stack\ndoc-list-depth (\ndoc-widthu * \ndoc-fixed-widthu)
+.  \}\}\}
+.  el \
+.    nr doc-reg-dBla 0
+.  \}\}\}
+.
+.  \" not a known keyword, so it specifies the width of the next column
+.  \" (if it is a column list)
+.  if !\ndoc-reg-dBla \{\
+.    ie "\*doc-list-type-stack\ndoc-list-depth"column-list" \{\
+.      nr doc-num-columns +1
+.      ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
+.      substring doc-str-dBla 0 0
+.      ie '.'\*doc-str-dBla' \{\
+.        ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.        substring doc-str-dBla 1
+.        doc-first-parameter \*doc-str-dBla
+.        doc-get-width "\*doc-str-dfp
+.        doc-get-arg-type "\*doc-str-dfp
+.        ie (\ndoc-arg-type == 1) \
+.          nr doc-reg-dBla1 1
+.        el \
+.          nr doc-reg-dBla1 0
+.      \}
+.      el \
+.        nr doc-reg-dBla1 0
+.      ds doc-str-dBla "\*doc-arg\ndoc-arg-ptr
+.
+.      ie \ndoc-reg-dBla1 \{\
+.        \" execute string in a box to get the width of the diversion
+.        ds doc-str-dBla \*doc-arg\ndoc-arg-ptr
+.        doc-save-global-vars
+.        doc-reset-args
+.        box doc-box-dBla
+.        ev doc-env-dBla
+.        evc 0
+.        in 0
+.        nf
+.        nop \*doc-str-dBla
+.        br
+.        ev
+.        box
+.        doc-restore-global-vars
+.        ds doc-arg\ndoc-num-columns "\h'\ndlu'
+.      \}
+.      el \
+.        ds doc-arg\ndoc-num-columns "\*doc-arg\ndoc-arg-ptr
+.    \}
+.    el \{\
+.      tmc mdoc warning: Unknown keyword '\*doc-arg\ndoc-arg-ptr'
+.      tm1 " in .Bl macro (#\n.c)
+.  \}\}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \
+.    doc-do-Bl-args
+..
+.ec
+.
+.
+.\" NS doc-save-global-vars macro
+.\" NS   save all global variables
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dsgv
+.
+.eo
+.de doc-save-global-vars
+.  ds doc-macro-name-saved "\*doc-macro-name
+.  nr doc-arg-count-saved \ndoc-arg-count
+.  nr doc-num-args-saved \ndoc-num-args
+.  nr doc-arg-ptr-saved \ndoc-arg-ptr
+.
+.  nr doc-reg-dsgv 1
+.  while (\ndoc-reg-dsgv <= \ndoc-arg-count) \{\
+.    ds doc-arg\ndoc-reg-dsgv-saved "\*doc-arg\ndoc-reg-dsgv
+.    nr doc-type\ndoc-reg-dsgv-saved \ndoc-type\ndoc-reg-dsgv
+.    ds doc-space\ndoc-reg-dsgv-saved "\*doc-space\ndoc-reg-dsgv
+.    nr doc-reg-dsgv +1
+.  \}
+.
+.  nr doc-curr-font-saved \ndoc-curr-font
+.  nr doc-in-name-section-saved \ndoc-in-name-section
+.  nr doc-in-synopsis-section-saved \ndoc-in-synopsis-section
+.  nr doc-in-library-section-saved \ndoc-in-library-section
+.  nr doc-indent-synopsis-saved \ndoc-indent-synopsis
+.  nr doc-indent-synopsis-active-saved \ndoc-indent-synopsis-active
+.  nr doc-have-decl-saved \ndoc-have-decl
+.  nr doc-have-var-saved \ndoc-have-var
+.  ds doc-topic-name-saved "\*doc-topic-name
+.  ds doc-quote-left-saved "\*doc-quote-left
+.  ds doc-quote-right-saved "\*doc-quote-right
+.  nr doc-nesting-level-saved \ndoc-nesting-level
+.  nr doc-in-list-saved \ndoc-in-list
+.  ds doc-space-saved "\*doc-space
+.  ds doc-saved-space-saved "\*doc-saved-space
+.  nr doc-space-mode-saved \ndoc-space-mode
+.  nr doc-have-space-saved \ndoc-have-space
+.  nr doc-have-slot-saved \ndoc-have-slot
+.  nr doc-keep-type-saved \ndoc-keep-type
+.  nr doc-display-depth-saved \ndoc-display-depth
+.  nr doc-is-compact-saved \ndoc-is-compact
+.
+.  nr doc-reg-dsgv 0
+.  while (\ndoc-reg-dsgv <= \ndoc-display-depth) \{\
+.    ds doc-display-type-stack\ndoc-reg-dsgv-saved "\*doc-display-type-stack\ndoc-reg-dsgv
+.    nr doc-display-indent-stack\ndoc-reg-dsgv-saved \ndoc-display-indent-stack\ndoc-reg-dsgv
+.    nr doc-display-ad-stack\ndoc-reg-dsgv-saved \ndoc-display-ad-stack\ndoc-reg-dsgv
+.    nr doc-display-fi-stack\ndoc-reg-dsgv-saved \ndoc-display-fi-stack\ndoc-reg-dsgv
+.    nr doc-display-ft-stack\ndoc-reg-dsgv-saved \ndoc-display-ft-stack\ndoc-reg-dsgv
+.    nr doc-display-ps-stack\ndoc-reg-dsgv-saved \ndoc-display-ps-stack\ndoc-reg-dsgv
+.    nr doc-reg-dsgv +1
+.  \}
+.
+.  nr doc-fontmode-depth-saved \ndoc-fontmode-depth
+.
+.  nr doc-reg-dsgv 1
+.  while (\ndoc-reg-dsgv <= \ndoc-fontmode-depth) \{\
+.    nr doc-fontmode-font-stack\ndoc-reg-dsgv-saved \ndoc-fontmode-font-stack\ndoc-reg-dsgv
+.    nr doc-fontmode-size-stack\ndoc-reg-dsgv-saved \ndoc-fontmode-size-stack\ndoc-reg-dsgv
+.    nr doc-reg-dsgv +1
+.  \}
+.
+.  nr doc-list-depth-saved \ndoc-list-depth
+.
+.  nr doc-reg-dsgv 1
+.  while (\ndoc-reg-dsgv <= \ndoc-list-depth) \{\
+.    ds doc-list-type-stack\ndoc-reg-dsgv-saved "\*doc-list-type-stack\ndoc-reg-dsgv
+.    nr doc-list-have-indent-stack\ndoc-reg-dsgv-saved \ndoc-list-have-indent-stack\ndoc-reg-dsgv
+.    nr doc-list-indent-stack\ndoc-reg-dsgv-saved \ndoc-list-indent-stack\ndoc-reg-dsgv
+.    nr doc-compact-list-stack\ndoc-reg-dsgv-saved \ndoc-compact-list-stack\ndoc-reg-dsgv
+.    ds doc-tag-prefix-stack\ndoc-reg-dsgv-saved "\*doc-tag-prefix-stack\ndoc-reg-dsgv
+.    nr doc-list-offset-stack\ndoc-reg-dsgv-saved \ndoc-list-offset-stack\ndoc-reg-dsgv
+.    nr doc-enum-list-count-stack\ndoc-reg-dsgv-saved \ndoc-enum-list-count-stack\ndoc-reg-dsgv
+.    nr doc-reg-dsgv +1
+.  \}
+.
+.  nr doc-curr-type-saved \ndoc-curr-type
+.  ds doc-curr-arg-saved "\*doc-curr-arg
+.  nr doc-diag-list-input-line-count-saved \ndoc-diag-list-input-line-count
+.  nr doc-num-columns-saved \ndoc-num-columns
+.  nr doc-column-indent-width-saved \ndoc-column-indent-width
+.  nr doc-is-func-saved \ndoc-is-func
+.  nr doc-have-old-func-saved \ndoc-have-old-func
+.  nr doc-func-arg-count-saved \ndoc-func-arg-count
+.  ds doc-func-arg-saved "\*doc-func-arg
+.  nr doc-num-func-args-saved \ndoc-num-func-args
+.  nr doc-func-args-processed-saved \ndoc-func-args-processed
+.  nr doc-have-func-saved \ndoc-have-func
+.  nr doc-is-reference-saved \ndoc-is-reference
+.  nr doc-reference-count-saved \ndoc-reference-count
+.  nr doc-author-count-saved \ndoc-author-count
+.
+.  nr doc-reg-dsgv 0
+.  while (\ndoc-reg-dsgv <= \ndoc-author-count) \{\
+.    ds doc-author-name\ndoc-reg-dsgv-saved "\*doc-author-name\ndoc-reg-dsgv
+.    nr doc-reg-dsgv +1
+.  \}
+.
+.  nr doc-book-count-saved \ndoc-book-count
+.  ds doc-book-name-saved "\*doc-book-name
+.  nr doc-city-count-saved \ndoc-city-count
+.  ds doc-city-name-saved "\*doc-city-name
+.  nr doc-date-count-saved \ndoc-date-count
+.  ds doc-date-saved "\*doc-date
+.  nr doc-publisher-count-saved \ndoc-publisher-count
+.  ds doc-publisher-name-saved "\*doc-publisher-name
+.  nr doc-journal-count-saved \ndoc-journal-count
+.  ds doc-journal-name-saved "\*doc-journal-name
+.  nr doc-issue-count-saved \ndoc-issue-count
+.  ds doc-issue-name-saved "\*doc-issue-name
+.  nr doc-optional-count-saved \ndoc-optional-count
+.  ds doc-optional-string-saved "\*doc-optional-string
+.  nr doc-page-number-count-saved \ndoc-page-number-count
+.  ds doc-page-number-string-saved "\*doc-page-number-string
+.  nr doc-corporate-count-saved \ndoc-corporate-count
+.  ds doc-corporate-name-saved "\*doc-corporate-name
+.  nr doc-report-count-saved \ndoc-report-count
+.  ds doc-report-name-saved "\*doc-report-name
+.  nr doc-reference-title-count-saved \ndoc-reference-title-count
+.  ds doc-reference-title-name-saved "\*doc-reference-title-name
+.  ds doc-reference-title-name-for-book-saved "\*doc-reference-title-name-for-book
+.  nr doc-url-count-saved \ndoc-url-count
+.  ds doc-url-name-saved "\*doc-url-name
+.  nr doc-volume-count-saved \ndoc-volume-count
+.  ds doc-volume-name-saved "\*doc-volume-name
+.  nr doc-have-author-saved \ndoc-have-author
+.
+.  ds doc-page-topic-saved "\*doc-page-topic
+.  ds doc-volume-saved "\*doc-volume
+.  ds doc-section-saved "\*doc-section
+.  ds doc-operating-system-saved "\*doc-operating-system
+.  ds doc-date-string-saved "\*doc-date-string
+.  nr doc-display-vertical-saved \ndoc-display-vertical
+.  nr doc-in-see-also-section-saved \ndoc-in-see-also-section
+.  nr doc-in-files-section-saved \ndoc-in-files-section
+.  nr doc-in-authors-section-saved \ndoc-in-authors-section
+..
+.ec
+.
+.
+.\" NS doc-restore-global-vars macro
+.\" NS   restore all global variables
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-drgv
+.
+.eo
+.de doc-restore-global-vars
+.  ds doc-macro-name "\*doc-macro-name-saved
+.  nr doc-arg-count \ndoc-arg-count-saved
+.  nr doc-num-args \ndoc-num-args-saved
+.  nr doc-arg-ptr \ndoc-arg-ptr-saved
+.
+.  nr doc-reg-drgv 1
+.  while (\ndoc-reg-drgv <= \ndoc-arg-count) \{\
+.    ds doc-arg\ndoc-reg-drgv "\*doc-arg\ndoc-reg-drgv-saved
+.    nr doc-type\ndoc-reg-drgv \ndoc-type\ndoc-reg-drgv-saved
+.    ds doc-space\ndoc-reg-drgv "\*doc-space\ndoc-reg-drgv-saved
+.    nr doc-reg-drgv +1
+.  \}
+.
+.  nr doc-curr-font \ndoc-curr-font-saved
+.  nr doc-in-name-section \ndoc-in-name-section-saved
+.  nr doc-in-synopsis-section \ndoc-in-synopsis-section-saved
+.  nr doc-in-library-section \ndoc-in-library-section-saved
+.  nr doc-indent-synopsis \ndoc-indent-synopsis-saved
+.  nr doc-indent-synopsis-active \ndoc-indent-synopsis-active-saved
+.  nr doc-have-decl \ndoc-have-decl-saved
+.  nr doc-have-var \ndoc-have-var-saved
+.  ds doc-topic-name "\*doc-topic-name-saved
+.  ds doc-quote-left "\*doc-quote-left-saved
+.  ds doc-quote-right "\*doc-quote-right-saved
+.  nr doc-nesting-level \ndoc-nesting-level-saved
+.  nr doc-in-list \ndoc-in-list-saved
+.  ds doc-space "\*doc-space-saved
+.  ds doc-saved-space "\*doc-saved-space-saved
+.  nr doc-space-mode \ndoc-space-mode-saved
+.  nr doc-have-space \ndoc-have-space-saved
+.  nr doc-have-slot \ndoc-have-slot-saved
+.  nr doc-keep-type \ndoc-keep-type-saved
+.  nr doc-display-depth \ndoc-display-depth-saved
+.  nr doc-is-compact \ndoc-is-compact-saved
+.
+.  nr doc-reg-drgv 0
+.  while (\ndoc-reg-drgv <= \ndoc-display-depth) \{\
+.    ds doc-display-type-stack\ndoc-reg-drgv "\*doc-display-type-stack\ndoc-reg-drgv-saved
+.    nr doc-display-indent-stack\ndoc-reg-drgv \ndoc-display-indent-stack\ndoc-reg-drgv-saved
+.    nr doc-display-ad-stack\ndoc-reg-drgv \ndoc-display-ad-stack\ndoc-reg-drgv-saved
+.    nr doc-display-fi-stack\ndoc-reg-drgv \ndoc-display-fi-stack\ndoc-reg-drgv-saved
+.    nr doc-display-ft-stack\ndoc-reg-drgv \ndoc-display-ft-stack\ndoc-reg-drgv-saved
+.    nr doc-display-ps-stack\ndoc-reg-drgv \ndoc-display-ps-stack\ndoc-reg-drgv-saved
+.    nr doc-reg-drgv +1
+.  \}
+.
+.  nr doc-fontmode-depth \ndoc-fontmode-depth-saved
+.
+.  nr doc-reg-drgv 1
+.  while (\ndoc-reg-drgv <= \ndoc-fontmode-depth) \{\
+.    nr doc-fontmode-font-stack\ndoc-reg-drgv \ndoc-fontmode-font-stack\ndoc-reg-drgv-saved
+.    nr doc-fontmode-size-stack\ndoc-reg-drgv \ndoc-fontmode-size-stack\ndoc-reg-drgv-saved
+.    nr doc-reg-drgv +1
+.  \}
+.
+.  nr doc-list-depth \ndoc-list-depth-saved
+.
+.  nr doc-reg-drgv 1
+.  while (\ndoc-reg-drgv <= \ndoc-list-depth) \{\
+.    ds doc-list-type-stack\ndoc-reg-drgv "\*doc-list-type-stack\ndoc-reg-drgv-saved
+.    nr doc-list-have-indent-stack\ndoc-reg-drgv \ndoc-list-have-indent-stack\ndoc-reg-drgv-saved
+.    nr doc-list-indent-stack\ndoc-reg-drgv \ndoc-list-indent-stack\ndoc-reg-drgv-saved
+.    nr doc-compact-list-stack\ndoc-reg-drgv \ndoc-compact-list-stack\ndoc-reg-drgv-saved
+.    ds doc-tag-prefix-stack\ndoc-reg-drgv "\*doc-tag-prefix-stack\ndoc-reg-drgv-saved
+.    nr doc-list-offset-stack\ndoc-reg-drgv \ndoc-list-offset-stack\ndoc-reg-drgv-saved
+.    nr doc-enum-list-count-stack\ndoc-reg-drgv \ndoc-enum-list-count-stack\ndoc-reg-drgv-saved
+.    nr doc-reg-drgv +1
+.  \}
+.
+.  nr doc-curr-type \ndoc-curr-type-saved
+.  ds doc-curr-arg "\*doc-curr-arg-saved
+.  nr doc-diag-list-input-line-count \ndoc-diag-list-input-line-count-saved
+.  nr doc-num-columns \ndoc-num-columns-saved
+.  nr doc-column-indent-width \ndoc-column-indent-width-saved
+.  nr doc-is-func \ndoc-is-func-saved
+.  nr doc-have-old-func \ndoc-have-old-func-saved
+.  nr doc-func-arg-count \ndoc-func-arg-count-saved
+.  ds doc-func-arg "\*doc-func-arg-saved
+.  nr doc-num-func-args \ndoc-num-func-args-saved
+.  nr doc-func-args-processed \ndoc-func-args-processed-saved
+.  nr doc-have-func \ndoc-have-func-saved
+.  nr doc-is-reference \ndoc-is-reference-saved
+.  nr doc-reference-count \ndoc-reference-count-saved
+.  nr doc-author-count \ndoc-author-count-saved
+.
+.  nr doc-reg-drgv 0
+.  while (\ndoc-reg-drgv <= \ndoc-author-count) \{\
+.    ds doc-author-name\ndoc-reg-drgv "\*doc-author-name\ndoc-reg-drgv-saved
+.    nr doc-reg-drgv +1
+.  \}
+.
+.  nr doc-book-count \ndoc-book-count-saved
+.  ds doc-book-name "\*doc-book-name-saved
+.  nr doc-city-count \ndoc-city-count-saved
+.  ds doc-city-name "\*doc-city-name-saved
+.  nr doc-date-count \ndoc-date-count-saved
+.  ds doc-date "\*doc-date-saved
+.  nr doc-publisher-count \ndoc-publisher-count-saved
+.  ds doc-publisher-name "\*doc-publisher-name-saved
+.  nr doc-journal-count \ndoc-journal-count-saved
+.  ds doc-journal-name "\*doc-journal-name-saved
+.  nr doc-issue-count \ndoc-issue-count-saved
+.  ds doc-issue-name "\*doc-issue-name-saved
+.  nr doc-optional-count \ndoc-optional-count-saved
+.  ds doc-optional-string "\*doc-optional-string-saved
+.  nr doc-page-number-count \ndoc-page-number-count-saved
+.  ds doc-page-number-string "\*doc-page-number-string-saved
+.  nr doc-corporate-count \ndoc-corporate-count-saved
+.  ds doc-corporate-name "\*doc-corporate-name-saved
+.  nr doc-report-count \ndoc-report-count-saved
+.  ds doc-report-name "\*doc-report-name-saved
+.  nr doc-reference-title-count \ndoc-reference-title-count-saved
+.  ds doc-reference-title-name "\*doc-reference-title-name-saved
+.  ds doc-reference-title-name-for-book "\*doc-reference-title-name-for-book-saved
+.  nr doc-url-count \ndoc-url-count-saved
+.  ds doc-url-name "\*doc-url-name-saved
+.  nr doc-volume-count \ndoc-volume-count-saved
+.  ds doc-volume-name "\*doc-volume-name-saved
+.  nr doc-have-author \ndoc-have-author-saved
+.
+.  ds doc-page-topic "\*doc-page-topic-saved
+.  ds doc-volume "\*doc-volume-saved
+.  ds doc-section "\*doc-section-saved
+.  ds doc-operating-system "\*doc-operating-system-saved
+.  ds doc-date-string "\*doc-date-string-saved
+.  nr doc-display-vertical \ndoc-display-vertical-saved
+.  nr doc-in-see-also-section \ndoc-in-see-also-section-saved
+.  nr doc-in-files-section \ndoc-in-files-section-saved
+.  nr doc-in-authors-section \ndoc-in-authors-section-saved
+..
+.ec
+.
+.
+.\" NS El user macro
+.\" NS   end list
+.\" NS
+.\" NS modifies:
+.\" NS   doc-list-depth
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variables:
+.\" NS   doc-str-El
+.\" NS
+.\" NS width register 'El' set in doc-common
+.
+.eo
+.de El
+.  if \n.$ \{\
+.    tm Usage: .El (does not take arguments) (#\n.c)
+.    return
+.  \}
+.
+.  ds doc-macro-name El
+.  ds doc-str-El \*doc-list-type-stack\ndoc-list-depth
+.
+.  ie        "\*doc-str-El"diag-list" \
+.    doc-end-list 0
+.  el \{ .ie "\*doc-str-El"column-list" \
+.    doc-end-column-list
+.  el \{ .ie "\*doc-str-El"item-list" \
+.    doc-end-list 0
+.  el \{ .ie "\*doc-str-El"ohang-list" \
+.    doc-end-list 0
+.  el \{ .ie "\*doc-str-El"inset-list" \
+.    doc-end-list 0
+.  el \
+.    doc-end-list 1
+.  \}\}\}\}
+.
+.  br
+..
+.ec
+.
+.
+.\" NS doc-curr-type global register
+.\" NS   current argument type
+.
+.nr doc-curr-type 0
+.
+.
+.\" NS doc-curr-arg global string
+.\" NS   current argument
+.
+.ds doc-curr-arg
+.
+.
+.\" NS doc-item-boxXXX global box
+.\" NS   item boxes associated list depth
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.
+.\" NS It user macro
+.\" NS   list item
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-curr-arg
+.\" NS   doc-curr-type
+.\" NS   doc-in-list
+.\" NS   doc-macro-name
+.\" NS   doc-num-args
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-It
+.\" NS   doc-str-It
+.\" NS   doc-XXX-list-type
+.\" NS
+.\" NS width register 'It' set in doc-common
+.
+.nr doc-bullet-list-type 1
+.nr doc-column-list-type 0
+.nr doc-dash-list-type 1
+.nr doc-diag-list-type 0
+.nr doc-enum-list-type 1
+.nr doc-hang-list-type 2
+.nr doc-inset-list-type 2
+.nr doc-item-list-type 1
+.nr doc-ohang-list-type 2
+.nr doc-tag-list-type 2
+.
+.eo
+.de It
+.  ds doc-str-It \*doc-list-type-stack\ndoc-list-depth
+.
+.  if "\*doc-str-It"" \
+.    tm mdoc error: .It without preceding .Bl (#\n.c)
+.
+.  if \ndoc-nesting-level \{\
+.    tmc "mdoc error: .It found in enclosing (e.g. .Ac ... .It ... .Ao)
+.    tm1 " (#\n.c)
+.  \}
+.
+.  br
+.  if !\ncR \
+.    ne 3v
+.
+.  if \n.$ \{\
+.    ds doc-macro-name It
+.
+.    \" fill argument vector
+.    nr doc-reg-It 1
+.    while (\ndoc-reg-It <= \n.$) \{\
+.      ds doc-arg\ndoc-reg-It "\$\ndoc-reg-It
+.      nr doc-reg-It +1
+.    \}
+.
+.    nr doc-num-args \n.$
+.    nr doc-arg-ptr 0
+.  \}
+.
+.  nr doc-reg-It \ndoc-\*doc-str-It-type
+.
+.  if \ndoc-reg-It \{\
+.    \" start item box
+.    box doc-item-box\ndoc-list-depth
+.    ev doc-item-env\ndoc-list-depth
+.    evc 0
+.    in 0
+.    nf
+.  \}
+.
+.  ie (\ndoc-reg-It == 1) \{\
+.    if \n.$ \{\
+.      tm1 "mdoc warning: .It macros in lists of type '\*doc-str-It'
+.      tm1 "              don't take arguments (#\n.c)
+.  \}\}
+.  el \{\
+.    ie \n.$ \{\
+.      if (\ndoc-reg-It == 2) \{\
+.        \" handle list types with arguments
+.        doc-parse-arg-vector
+.
+.        nr doc-in-list 1
+.        nr doc-arg-ptr 1
+.        nr doc-curr-type \ndoc-type1
+.        ds doc-curr-arg "\*doc-arg1
+.
+.        ie (\ndoc-type1 == 1) \
+.          \*doc-arg1
+.        el \{\
+.          nr doc-arg-ptr 1
+.          doc-print-recursive
+.    \}\}\}
+.    el \{\
+.      tm1 "mdoc warning: .It macros in lists of type '\*doc-str-It'
+.      tm1 "              require arguments (#\n.c)
+.    \}
+.  \}
+.
+.  \" the previous call of '.doc-print-recursive' can contain calls to
+.  \" opening macros like '.Ao'; we then defer the call of
+.  \" 'doc-xxx-list'
+.  if !\ndoc-nesting-level \
+.    doc-\*doc-str-It
+..
+.ec
+.
+.
+.\" NS doc-inset-list macro
+.\" NS   .It item of list-type inset
+.\" NS
+.\" NS modifies:
+.\" NS   doc-in-list
+.
+.eo
+.de doc-inset-list
+.  \" finish item box
+.  br
+.  ev
+.  box
+.  unformat doc-item-box\ndoc-list-depth
+.
+.  doc-set-vertical-and-indent 0
+.  br
+.
+.  nh
+.  doc-item-box\ndoc-list-depth
+.
+.  nr doc-in-list 0
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-hang-list macro
+.\" NS   .It item of list-type hanging tag (as opposed to tagged)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-have-space
+.\" NS   doc-in-list
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dhl
+.\" NS   doc-reg-dhl1
+.
+.eo
+.de doc-hang-list
+.  \" finish item box
+.  br
+.  ev
+.  box
+.  unformat doc-item-box\ndoc-list-depth
+.
+.  doc-set-vertical-and-indent 1
+.  nr doc-reg-dhl (\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
+.  ti -\ndoc-reg-dhlu
+.
+.  nh
+.  ie (\ndlu > \ndoc-list-indent-stack\ndoc-list-depthu) \
+.    doc-item-box\ndoc-list-depth
+.  el \{\
+.    chop doc-item-box\ndoc-list-depth
+.    nr doc-reg-dhl1 \n.ku
+.    nop \*doc-item-box\ndoc-list-depth\c
+.    nop \h'|(\ndoc-reg-dhl1u - \n.ku + \ndoc-reg-dhlu)'\c
+.    nr doc-have-space 1
+.  \}
+.
+.  nr doc-in-list 0
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-ohang-list macro
+.\" NS   .It item of list-type overhanging tag
+.\" NS
+.\" NS modifies:
+.\" NS   doc-in-list
+.
+.eo
+.de doc-ohang-list
+.  \" finish item box
+.  br
+.  ev
+.  box
+.  unformat doc-item-box\ndoc-list-depth
+.
+.  doc-set-vertical-and-indent 0
+.  nh
+.  doc-item-box\ndoc-list-depth
+.  br
+.
+.  nr doc-in-list 0
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-item-list macro
+.\" NS   .It item of list-type empty tag
+.
+.eo
+.de doc-item-list
+.  \" finish (dummy) item box
+.  br
+.  ev
+.  box
+.
+.  doc-set-vertical-and-indent 0
+.  br
+.
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-enum-list-count-stackXXX global register
+.\" NS   stack of current enum count values
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.nr doc-enum-list-count-stack1 0
+.
+.
+.\" NS doc-enum-list macro
+.\" NS   enumerated list
+.\" NS
+.\" NS modifies:
+.\" NS   doc-enum-list-count-stackXXX
+.\" NS   doc-in-list
+.
+.eo
+.de doc-enum-list
+.  nr doc-in-list 1
+.  nr doc-enum-list-count-stack\ndoc-list-depth +1
+\# XXX
+\#.ll \ndoc-list-indent-stack\ndoc-list-depthu
+\#.rj
+.  nop \*doc-tag-prefix-stack\ndoc-list-depth\c
+.  nop \ndoc-enum-list-count-stack\ndoc-list-depth.\&
+.  doc-do-list
+..
+.ec
+.
+.
+.\" NS doc-bullet-list macro
+.\" NS   bullet paragraph list
+.\" NS
+.\" NS modifies:
+.\" NS   doc-in-list
+.
+.eo
+.de doc-bullet-list
+.  nr doc-in-list 1
+.  nop \)\*doc-Sy-font\bu\f
+.  doc-do-list
+..
+.ec
+.
+.
+.\" NS doc-dash-list macro
+.\" NS   hyphen paragraph list (sub bullet list)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-in-list
+.
+.eo
+.de doc-dash-list
+.  nr doc-in-list 1
+.  nop \)\*doc-Sy-font\-\f
+.  doc-do-list
+..
+.ec
+.
+.
+.\" NS doc-do-list macro
+.\" NS   .It item of list-type enum/bullet/hyphen
+.
+.als doc-do-list doc-hang-list
+.
+.
+.\" NS doc-diag-list-input-line-count global register
+.\" NS   saved line number to be checked in next diag-list item
+.
+.nr doc-diag-list-input-line-count 0
+.
+.
+.\" NS doc-diag-list macro
+.\" NS   .It item of list-type diagnostic-message
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS   doc-diag-list-input-line-count
+.
+.eo
+.de doc-diag-list
+.  nr doc-curr-font \n.f
+.
+.  ie ((\n.c - \ndoc-diag-list-input-line-count) > 1) \{\
+.    ie !\ndoc-compact-list-stack\ndoc-list-depth \
+.      doc-paragraph
+.    el \
+.      br
+.  \}
+.  el \
+.    br
+.  nr doc-diag-list-input-line-count \n.c
+.
+.  nh
+.  nop \*doc-Sy-font\c
+.  if \ndoc-num-args \
+.    doc-remaining-args
+.  nop \f\ndoc-curr-font\*doc-hard-space\c
+.
+.  doc-print-and-reset
+..
+.ec
+.
+.
+.\" NS doc-tag-list macro
+.\" NS   .It item of list-type 'tag'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-have-space
+.\" NS   doc-in-list
+.\" NS
+.\" NS local variables:
+.\" NS   doc-box-dtl
+.\" NS   doc-reg-dtl
+.\" NS   doc-reg-dtl1
+.
+.eo
+.de doc-tag-list
+.  \" finish item box
+.  br
+.  ev
+.  box
+.  unformat doc-item-box\ndoc-list-depth
+.
+.  \" we use a box without '.nf' to compute the tag width (via 'dl' register)
+.  box doc-box-dtl
+.  ev doc-env-dtl
+.  evc 0
+.  fi
+.  ad l
+.  in 0
+.  doc-item-box\ndoc-list-depth
+.  br
+.  ev
+.  box
+.
+.  doc-set-vertical-and-indent 1
+.  nr doc-reg-dtl (\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
+.  ti -\ndoc-reg-dtlu
+.
+.  nh
+.  doc-item-box\ndoc-list-depth
+.  ie (\ndlu > \ndoc-list-indent-stack\ndoc-list-depthu) \
+.    br
+.  el \{\
+.    \" format the tag separately to prevent stretching of spaces
+.    vpt 0
+.    br
+.    sp -1
+.    vpt 1
+.    nop \&\c
+.    nr doc-have-space 1
+.  \}
+.
+.  nr doc-in-list 0
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS doc-set-vertical-and-indent macro
+.\" NS   set up vertical spacing (if not compact) and indentation (with
+.\" NS   offset if argument is non-zero)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-list-have-indent-stackXXX
+.
+.eo
+.de doc-set-vertical-and-indent
+.  if !\ndoc-compact-list-stack\ndoc-list-depth \
+.    sp \ndoc-display-verticalu
+.
+.  if \ndoc-list-have-indent-stack\ndoc-list-depth \{\
+.    nr doc-list-have-indent-stack\ndoc-list-depth 0
+.    if \$1 \
+.      in +(\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
+.  \}
+.
+.  if !\ncR \
+.    ne 2v
+..
+.ec
+.
+.
+.\" NS doc-list-depth global register
+.\" NS   list type stack counter
+.
+.nr doc-list-depth 0
+.
+.
+.\" NS doc-num-columns global register
+.\" NS   number of columns
+.
+.nr doc-num-columns 0
+.
+.
+.\" NS doc-compact-list-stackXXX global register (bool)
+.\" NS   stack of flags to indicate whether a particular list is compact
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.nr doc-compact-list-stack1 0
+.
+.
+.\" NS doc-tag-prefix-stackXXX global string
+.\" NS   stack of tag prefixes (currently used for -nested -enum lists)
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.ds doc-tag-prefix-stack1
+.
+.
+.\" NS doc-list-offset-stackXXX global register
+.\" NS   stack of list offsets
+.\" NS
+.\" NS limit:
+.\" NS   doc-list-depth
+.
+.nr doc-list-offset-stack1 0
+.
+.
+.\" NS doc-end-list macro
+.\" NS   list end function; resets indentation (and offset if argument
+.\" NS   is non-zero)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-list-depth
+.\" NS   doc-list-offset-stackXXX
+.
+.eo
+.de doc-end-list
+.  if \$1 \
+'    in -(\ndoc-list-indent-stack\ndoc-list-depthu + \ndoc-digit-widthu)
+.
+'  in -\ndoc-list-offset-stack\ndoc-list-depthu
+.
+.  if (\ndoc-list-depth <= 0) \
+.    tm mdoc warning: extraneous .El call (#\n.c)
+.
+.  doc-decrement-list-stack
+.  nr doc-list-depth -1
+..
+.ec
+.
+.
+.\" NS doc-increment-list-stack macro
+.\" NS   set up next block for list
+.\" NS
+.\" NS modifies:
+.\" NS   doc-compact-list-stackXXX
+.\" NS   doc-list-have-indent-stackXXX
+.\" NS   doc-list-indent-stackXXX
+.\" NS   doc-list-offset-stackXXX
+.\" NS   doc-list-type-stackXXX
+.\" NS   doc-tag-prefix-stackXXX
+.\" NS   doc-enum-list-count-stackXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dils
+.
+.eo
+.de doc-increment-list-stack
+.  nr doc-reg-dils (\ndoc-list-depth + 1)
+.  nr doc-list-have-indent-stack\ndoc-reg-dils 0
+.  nr doc-list-indent-stack\ndoc-reg-dils 0
+.  nr doc-list-offset-stack\ndoc-reg-dils 0
+.  ds doc-tag-prefix-stack\ndoc-reg-dils
+.  ds doc-list-type-stack\ndoc-reg-dils
+.  nr doc-compact-list-stack\ndoc-reg-dils 0
+.  nr doc-enum-list-count-stack\ndoc-reg-dils 0
+..
+.ec
+.
+.
+.\" NS doc-decrement-list-stack macro
+.\" NS   decrement stack
+.\" NS
+.\" NS modifies:
+.\" NS   doc-compact-list-stackXXX
+.\" NS   doc-list-have-indent-stackXXX
+.\" NS   doc-list-indent-stackXXX
+.\" NS   doc-list-offset-stackXXX
+.\" NS   doc-list-type-stackXXX
+.\" NS   doc-tag-prefix-stackXXX
+.\" NS   doc-enum-list-count-stackXXX
+.
+.eo
+.de doc-decrement-list-stack
+.  ds doc-list-type-stack\ndoc-list-depth
+.  nr doc-list-have-indent-stack\ndoc-list-depth 0
+.  nr doc-list-indent-stack\ndoc-list-depth 0
+.  nr doc-list-offset-stack\ndoc-list-depth 0
+.  ds doc-tag-prefix-stack\ndoc-list-depth
+.  nr doc-compact-list-stack\ndoc-list-depth 0
+.  nr doc-enum-list-count-stack\ndoc-list-depth 0
+..
+.ec
+.
+.
+.\" NS Xr user macro
+.\" NS   cross reference (for man pages only)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Xr
+.\" NS
+.\" NS width register 'Xr' set in doc-common
+.
+.eo
+.de Xr
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Xr
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      doc-Xr-usage
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    \" first argument must be a string
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      nr doc-curr-font \n.f
+.      ds doc-arg\ndoc-arg-ptr \*doc-Xr-font\*doc-arg\ndoc-arg-ptr\f
+.
+.      if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.        nr doc-reg-Xr (\ndoc-arg-ptr + 1)
+.        \" modify second argument if it is a string and
+.        \" remove space in between
+.        if (\ndoc-type\ndoc-reg-Xr == 2) \{\
+.          ds doc-arg\ndoc-reg-Xr \*lp\*doc-arg\ndoc-reg-Xr\*rp
+.          ds doc-space\ndoc-arg-ptr
+.        \}
+.      \}
+.      doc-print-recursive
+.    \}
+.    el \
+.      doc-Xr-usage
+.  \}
+.  el \
+.    doc-Xr-usage
+..
+.ec
+.
+.
+.\" NS doc-Xr-usage macro
+.
+.eo
+.de doc-Xr-usage
+.  tm Usage: .Xr manpage_name section# ... (#\n.c)
+.  doc-reset-args
+..
+.ec
+.
+.
+.\" NS Sx user macro
+.\" NS   cross section reference
+.\" NS
+.\" NS width register 'Sx' set in doc-common
+.\"
+.\" TODO: This duplicates the definition of `Dq`; figure out how to
+.\" simply wrap that macro if possible.  (It's not trivial to do so
+.\" because of mdoc's design feature of recursively calling macro
+.\" arguments as macros.)
+.
+.eo
+.de Sx
+.  if !\ndoc-arg-count \
+.    ds doc-macro-name Sx
+.
+.  ds doc-quote-left "\*Lq
+.  ds doc-quote-right "\*Rq
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" NS doc-end-column-list macro
+.\" NS   column-list end-list
+.\" NS
+.\" NS modifies:
+.\" NS   doc-list-depth
+.
+.eo
+.de doc-end-column-list
+.  linetabs 0
+'  in -(\ndoc-list-offset-stack\ndoc-list-depthu + \ndoc-list-indent-stack\ndoc-list-depthu)
+.  ta T .5i
+.  fi
+.  doc-decrement-list-stack
+.  nr doc-list-depth -1
+..
+.ec
+.
+.
+.\" NS doc-column-indent-width global register
+.\" NS   holds the indent width for a column list
+.
+.nr doc-column-indent-width 0
+.
+.
+.\" NS doc-set-column-tab macro
+.\" NS   establish tabs for list-type column: '.doc-set-column-tab num_cols'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-column-indent-width
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dsct
+.\" NS   doc-str-dsct
+.\" NS   doc-str-dsct1
+.
+.eo
+.de doc-set-column-tab
+.  ds doc-str-dsct
+.  nr doc-reg-dsct 1
+.  nr doc-column-indent-width 0
+.
+.  ie (\$1 < 5) \
+.    ds doc-str-dsct1 "    \"
+.  el \{\
+.    ie (\$1 == 5) \
+.      ds doc-str-dsct1 "   \"
+.    el \{\
+.      \" XXX: this is packed abnormally close -- intercolumn width
+.      \"      should be configurable
+.      ds doc-str-dsct1 " \"
+.  \}\}
+.
+.  while (\ndoc-reg-dsct <= \$1) \{\
+.    as doc-str-dsct " +\w'\*doc-arg\ndoc-reg-dsct\*doc-str-dsct1'u
+.    nr doc-column-indent-width +\w'\*doc-arg\ndoc-reg-dsct\*doc-str-dsct1'u
+.    nr doc-reg-dsct +1
+.  \}
+.
+.  ta \*doc-str-dsct
+'  in +\ndoc-column-indent-widthu
+..
+.ec
+.
+.
+.\" NS doc-column-list macro
+.\" NS   column items
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-list-indent-stackXXX
+.\" NS   doc-spaceXXX
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dcl
+.
+.eo
+.de doc-column-list
+.  if \ndoc-num-args \
+.    doc-parse-arg-vector
+.  nr doc-arg-ptr +1
+.
+.  if (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    tm Usage: .It column_string Ta column_string ...  (#\n.c)
+.    return
+.  \}
+.
+.  if "\*doc-arg\ndoc-arg-ptr"Ta" \{\
+.    nr doc-reg-dcl (\ndoc-arg-ptr - 1)
+.    ds doc-space\ndoc-reg-dcl
+.  \}
+.
+.  if !\ndoc-list-indent-stack\ndoc-list-depth \
+.    nr doc-list-indent-stack\ndoc-list-depth \ndoc-column-indent-widthu
+.  if !\n.u \{\
+.    fi
+.    in +\ndoc-column-indent-widthu
+.  \}
+.  ti -\ndoc-column-indent-widthu
+.
+.  doc-do-\ndoc-type\ndoc-arg-ptr
+..
+.ec
+.
+.
+.\" NS Ta user macro
+.\" NS   append tab (\t)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS
+.\" NS width register 'Ta' set in doc-common
+.
+.eo
+.de Ta
+.  ie \ndoc-arg-count \{\
+.    nr doc-arg-ptr +1
+.    nop \*doc-tab\c
+.    ie (\ndoc-arg-count >= \ndoc-arg-ptr) \
+.      doc-do-\ndoc-type\ndoc-arg-ptr
+.    el \
+.      doc-reset-args
+.  \}
+.  el \{\
+.    tm1 "Usage: Ta must follow column entry: e.g.
+.    tm1 "         .It column_string Ta column_string ... (#\n.c)
+.  \}
+..
+.ec
+.
+.
+.\" NS Dl user macro
+.\" NS   display (one line) literal
+.\" NS
+.\" NS   this function uses the 'Li' font
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Dl' set in doc-common
+.
+.eo
+.de Dl
+.  ta T .5i
+.  in +\ndoc-display-indentu
+.
+.  ie \ndoc-arg-count \{\
+.    tm Usage: .Dl not callable by other macros (#\n.c)
+.    doc-reset-args
+.  \}
+.  el \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Dl
+.      doc-parse-args \$@
+.      nr doc-arg-ptr 1
+.      nr doc-curr-font \n.f
+.      nop \*doc-Li-font\c
+.      doc-print-recursive
+.    \}
+.    el \
+.      tm Usage: .Dl argument ... (#\n.c)
+.  \}
+.
+.  in -\ndoc-display-indentu
+..
+.ec
+.
+.
+.\" NS D1 user macro
+.\" NS   display (one line)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'D1' set in doc-common
+.
+.eo
+.de D1
+.  ta T .5i
+.  in +\ndoc-display-indentu
+.
+.  ie \ndoc-arg-count \{\
+.    tm Usage: .D1 not callable by other macros (#\n.c)
+.    doc-reset-args
+.  \}
+.  el \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name D1
+.      doc-parse-args \$@
+.      nr doc-arg-ptr 1
+.      doc-print-recursive
+.    \}
+.    el \
+.      tm Usage: .D1 argument ... (#\n.c)
+.  \}
+.
+.  in -\ndoc-display-indentu
+..
+.ec
+.
+.
+.\" NS Vt user macro
+.\" NS   variable type (for forcing old style variable declarations);
+.\" NS   this is not done in the same manner as .Ot for fortrash --
+.\" NS   clean up later
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS   doc-have-decl
+.\" NS   doc-have-var
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Vt' set in doc-common
+.
+.eo
+.de Vt
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Vt
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Vt variable_type ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  if (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    tm Usage: .Vt variable_type ... (#\n.c)
+.    doc-reset-args
+.    return
+.  \}
+.
+.  if \ndoc-in-synopsis-section \{\
+.    \" if a function declaration was the last thing given,
+.    \" want vertical space
+.    if \ndoc-have-decl \{\
+.      doc-paragraph
+.      nr doc-have-decl 0
+.    \}
+.
+.    \" if a subroutine was the last thing given, want vertical space
+.    if \ndoc-have-func \{\
+.      ie \ndoc-have-var \
+.        br
+.      el \
+.        doc-paragraph
+.    \}
+.
+.    nr doc-have-var 1
+.  \}
+.
+.  nr doc-curr-font \n.f
+.  nop \*doc-Ft-font\c
+.  doc-print-recursive
+.
+.  if \ndoc-in-synopsis-section \{\
+.    ie \ndoc-have-old-func \
+.      nop \*doc-soft-space\c
+.    el \
+.      br
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-is-func global register (bool)
+.\" NS   set if subroutine (in synopsis only) (fortran only)
+.
+.nr doc-is-func 0
+.
+.
+.\" NS Ft user macro
+.\" NS   function type
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS   doc-have-decl
+.\" NS   doc-have-var
+.\" NS   doc-is-func
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Ft' set in doc-common
+.
+.eo
+.de Ft
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Ft
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Ft function_type ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  if (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    tm Usage: .Ft function_type ... (#\n.c)
+.    doc-reset-args
+.    return
+.  \}
+.
+.  if \ndoc-in-synopsis-section \{\
+.    if (\ndoc-have-func : \ndoc-have-decl) \{\
+.      doc-paragraph
+.      nr doc-have-decl 0
+.      nr doc-have-var 0
+.    \}
+.
+.    if \ndoc-have-var \{\
+.      doc-paragraph
+.      nr doc-have-var 0
+.    \}
+.
+.    nr doc-is-func 1
+.  \}
+.
+.  nr doc-curr-font \n.f
+.  nop \*doc-Ft-font\c
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS doc-have-old-func global register (bool)
+.\" NS   set if 'Ot' has been called
+.
+.nr doc-have-old-func 0
+.
+.
+.\" NS Ot user macro
+.\" NS   old function type (fortran -- no newline)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-have-decl
+.\" NS   doc-have-old-func
+.\" NS   doc-have-var
+.\" NS   doc-is-func
+.\" NS
+.\" NS width register 'Ot' set in doc-common
+.
+.eo
+.de Ot
+.  nr doc-have-old-func 1
+.
+.  if \ndoc-in-synopsis-section \{\
+.    if (\ndoc-have-func : \ndoc-have-decl) \{\
+.      doc-paragraph
+.      nr doc-have-decl 0
+.      nr doc-have-var 0
+.    \}
+.
+.    if \ndoc-have-var \{\
+.      doc-paragraph
+.      nr doc-have-var 0
+.    \}
+.
+.    nr doc-is-func 1
+.  \}
+.
+.  if \n.$ \
+.    nop \*doc-Ft-font\$*\c
+.  nop \ \f\c
+..
+.ec
+.
+.
+.\" NS Fa user macro
+.\" NS   function arguments
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Fa' set in doc-common
+.
+.eo
+.de Fa
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Fa
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Fa function_arguments ... (#\n.c)
+.  \}
+.
+.  ie \ndoc-func-arg-count \
+.    doc-do-func
+.  el \{\
+.    nr doc-arg-ptr +1
+.    if (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.      nr doc-curr-font \n.f
+.      nop \*doc-Fa-font\c
+.      doc-print-recursive
+.
+.      if \ndoc-in-synopsis-section \
+.        if \ndoc-have-func \
+.          br
+.  \}\}
+..
+.ec
+.
+.
+.\" NS doc-func-arg-count global register
+.\" NS   how many function arguments have been processed so far
+.
+.nr doc-func-arg-count 0
+.
+.
+.\" NS doc-func-arg global string
+.\" NS   work buffer for function name strings
+.
+.ds doc-func-arg
+.
+.
+.\" NS doc-num-func-args global register
+.\" NS   number of function arguments
+.
+.nr doc-num-func-args 0
+.
+.
+.\" NS doc-func-args-processed global register
+.\" NS   function arguments processed so far
+.
+.nr doc-func-args-processed 0
+.
+.
+.\" NS doc-do-func macro
+.\" NS   internal .Fa for .Fc
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-func-arg
+.\" NS   doc-func-arg-count
+.\" NS   doc-func-args-processed
+.\" NS   doc-num-func-args
+.
+.eo
+.de doc-do-func
+.  if (\ndoc-arg-count <= \ndoc-arg-ptr) \{\
+.    doc-reset-args
+.    return
+.  \}
+.
+.  nr doc-arg-ptr +1
+.
+.  ds doc-func-arg
+.  nr doc-num-func-args 0
+.  nr doc-func-args-processed 0
+.
+.  doc-build-func-string \*doc-arg\ndoc-arg-ptr
+.  if (\ndoc-num-func-args > 1) \
+.    ds doc-arg\ndoc-arg-ptr "\*doc-func-arg
+.
+.  if (\ndoc-func-arg-count > 1) \{\
+.    nop \f\ndoc-curr-font\|\c
+.    if !"\*doc-arg\ndoc-arg-ptr"/*" \
+.      if !"\*doc-arg\ndoc-arg-ptr"*/" \
+.        nop ,\)\c
+.    nop \)\*doc-space\ndoc-arg-ptr\*doc-Fa-font\c
+.    nop \)\*doc-arg\ndoc-arg-ptr\f\c
+.  \}
+.
+.  if (\ndoc-func-arg-count == 1) \{\
+.    nop \)\*doc-Fa-font\*doc-arg\ndoc-arg-ptr\c
+.    nop \f\c
+.  \}
+.  nr doc-func-arg-count +1
+.  doc-do-func
+..
+.ec
+.
+.
+.\" NS doc-have-func global register (bool)
+.\" NS   whether we have more than one function in synopsis
+.
+.nr doc-have-func 0
+.
+.
+.\" NS Fn user macro
+.\" NS   functions
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-have-decl
+.\" NS   doc-have-func
+.\" NS   doc-have-var
+.\" NS   doc-indent-synopsis
+.\" NS   doc-is-func
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Fn' set in doc-common
+.
+.eo
+.de Fn
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Fn
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Fn function_name function_arg ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  if \ndoc-in-synopsis-section \{\
+.    \" if there is/has been more than one subroutine declaration
+.    ie \ndoc-is-func \{\
+.      br
+.      nr doc-have-var 0
+.      nr doc-have-decl 0
+.      nr doc-is-func 0
+.    \}
+.    el \{\
+.      if \ndoc-have-func \{\
+.        doc-paragraph
+.        nr doc-have-var 0
+.        nr doc-have-decl 0
+.    \}\}
+.
+.    if \ndoc-have-decl \{\
+.      doc-paragraph
+.      nr doc-have-var 0
+.    \}
+.
+.    if \ndoc-have-var \{\
+.      doc-paragraph
+.      nr doc-have-decl 0
+.    \}
+.
+.    nr doc-have-func 1
+.    nr doc-is-func 0
+.
+.    br
+.    if !\ndoc-indent-synopsis \
+.      nr doc-indent-synopsis (4u * \ndoc-fixed-widthu)
+.    if !\ndoc-indent-synopsis-active \
+.      in +\ndoc-indent-synopsisu
+.    ti -\ndoc-indent-synopsisu
+.  \}
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  if (\ndoc-arg-count < \ndoc-arg-ptr) \{\
+.    tm Usage: .Fn function_name function_arg ... (#\n.c)
+.    doc-reset-args
+.    return
+.  \}
+.
+.  nr doc-curr-font \n.f
+.  nop \*doc-Fn-font\*doc-arg\ndoc-arg-ptr\c
+.  nop \f\*lp\)\c
+.
+.  nr doc-arg-ptr +1
+.  if (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    if (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      nop \*doc-Fa-font\c
+.      doc-do-func-args
+.      nop \f\ndoc-curr-font\c
+.  \}\}
+.
+.  nop \)\*rp\)\c
+.  if \ndoc-in-synopsis-section \
+.    nop \);\)\c
+.
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    \" output the space (if needed)
+.    nr doc-arg-ptr -1
+.    nop \)\*doc-space\ndoc-arg-ptr\c
+.    nr doc-arg-ptr +1
+.
+.    doc-print-recursive
+.  \}
+.  el \
+.    doc-print-and-reset
+.
+.  if \ndoc-in-synopsis-section \
+.    if !\ndoc-indent-synopsis-active \
+.      in -\ndoc-indent-synopsisu
+..
+.ec
+.
+.
+.\" NS doc-do-func-args macro
+.\" NS   handle function arguments
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-argXXX
+.\" NS   doc-func-arg
+.\" NS   doc-func-args-processed
+.\" NS   doc-num-func-args
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-ddfa
+.
+.eo
+.de doc-do-func-args
+.  if \ndoc-in-synopsis-section \{\
+.    ds doc-func-arg
+.    nr doc-num-func-args 0
+.    nr doc-func-args-processed 0
+.
+.    doc-build-func-string \*doc-arg\ndoc-arg-ptr
+.    if (\ndoc-num-func-args > 1) \
+.      ds doc-arg\ndoc-arg-ptr "\*doc-func-arg
+.  \}
+.
+.  nop \)\*doc-arg\ndoc-arg-ptr\c
+.  nr doc-arg-ptr +1
+.
+.  if (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    if (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      nr doc-reg-ddfa (\ndoc-arg-ptr - 1)
+.      nop \f\ndoc-curr-font\|\c
+.      if !"\*doc-arg\ndoc-arg-ptr"/*" \
+.        if !"\*doc-arg\ndoc-arg-ptr"*/" \
+.          nop ,\)\c
+.      nop \)\*doc-space\ndoc-reg-ddfa\f\|\c
+.      doc-do-func-args
+.  \}\}
+..
+.ec
+.
+.
+.\" NS doc-saved-nesting-level global register
+.
+.nr doc-saved-nesting-level 0
+.
+.
+.\" NS doc-in-func-enclosure global register (bool)
+.
+.nr doc-in-func-enclosure 0
+.
+.
+.\" NS Fo user macro
+.\" NS   function open
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-func-arg-count
+.\" NS   doc-have-decl
+.\" NS   doc-have-func
+.\" NS   doc-have-var
+.\" NS   doc-in-func-enclosure
+.\" NS   doc-indent-synopsis
+.\" NS   doc-is-func
+.\" NS   doc-macro-name
+.\" NS   doc-saved-nesting-level
+.\" NS
+.\" NS width register 'Fo' set in doc-common
+.
+.eo
+.de Fo
+.  if (\ndoc-in-func-enclosure) \{\
+.    tm mdoc error: .Fo/.Fc can't be nested (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-saved-nesting-level \ndoc-nesting-level
+.  nr doc-in-func-enclosure 1
+.
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Fo
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Fo function_name (#\n.c)
+.  \}
+.
+.  if \ndoc-in-synopsis-section \{\
+.    \" if there is/has been more than one subroutine declaration
+.    ie \ndoc-is-func \{\
+.      br
+.      nr doc-have-var 0
+.      nr doc-have-decl 0
+.      nr doc-is-func 0
+.    \}
+.    el \{\
+.      if \ndoc-have-func \{\
+.        doc-paragraph
+.        nr doc-have-var 0
+.        nr doc-have-decl 0
+.    \}\}
+.
+.    if \ndoc-have-decl \{\
+.      doc-paragraph
+.      nr doc-have-var 0
+.    \}
+.
+.    if \ndoc-have-var \{\
+.      doc-paragraph
+.      nr doc-have-decl 0
+.    \}
+.
+.    nr doc-have-func 1
+.    nr doc-is-func 0
+.
+.    br
+.    if !\ndoc-indent-synopsis \
+.      nr doc-indent-synopsis (4u * \ndoc-fixed-widthu)
+.  \}
+.
+.  \" start function box
+.  box doc-func-box
+.  ev doc-func-env
+.  evc 0
+.  in 0
+.  nf
+.
+.  nr doc-arg-ptr +1
+.  doc-print-prefixes
+.  if (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-func-arg-count 1
+.    nr doc-curr-font \n.f
+.
+.    nop \*doc-Fn-font\*doc-arg\ndoc-arg-ptr\c
+.    nop \f\*lp\)\c
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS Fc user macro
+.\" NS   function close
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-func-arg-count
+.\" NS   doc-in-func-enclosure
+.\" NS   doc-saved-nesting-level
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'Fc' set in doc-common
+.
+.eo
+.de Fc
+.  if !\ndoc-in-func-enclosure \{\
+.    tm mdoc warning: Extraneous .Fc (#\n.c)
+.    return
+.  \}
+.
+.  if \n.$ \{\
+.    ds doc-macro-name Fc
+.    \" the first (dummy) argument is used to get the correct spacing
+.    doc-parse-args \) \$@
+.  \}
+.
+.  if !(\ndoc-saved-nesting-level == \ndoc-nesting-level) \
+.    tm mdoc warning: Unbalanced enclosure commands within .Fo/.Fc
+.
+.  nr doc-func-arg-count 0
+.  nr doc-in-func-enclosure 0
+.
+.  ie \ndoc-in-synopsis-section \
+.    nop \|\*rp;\)
+.  el \
+.    nop \|\*rp\)
+.
+.  \" finish function box
+.  br
+.  ev
+.  box
+.  chop doc-func-box
+.  unformat doc-func-box
+.
+.  if \ndoc-in-synopsis-section \{\
+.    if !\ndoc-indent-synopsis-active \
+.      in +\ndoc-indent-synopsisu
+.    ti -\ndoc-indent-synopsisu
+.  \}
+.
+.  nh
+.  nop \*doc-func-box\c
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.    doc-print-recursive
+.  \}
+.  el \
+.    doc-print-and-reset
+.
+.  if \ndoc-in-synopsis-section \
+.    if !\ndoc-indent-synopsis-active \
+.      in -\ndoc-indent-synopsisu
+..
+.ec
+.
+.
+.\" NS doc-build-func-string macro
+.\" NS   collect function arguments and set hard spaces in between
+.\" NS
+.\" NS modifies:
+.\" NS   doc-func-arg
+.\" NS   doc-func-args-processed
+.\" NS   doc-num-func-args
+.
+.eo
+.de doc-build-func-string
+.  if !\ndoc-num-func-args \{\
+.    nr doc-num-func-args \n.$
+.    nr doc-func-args-processed 0
+.    ds doc-func-arg
+.  \}
+.
+.  nr doc-func-args-processed +1
+.  as doc-func-arg "\$1
+.
+.  if (\ndoc-func-args-processed < \ndoc-num-func-args) \{\
+.    as doc-func-arg "\*doc-hard-space
+.
+.    shift
+.    doc-build-func-string \$@
+.  \}
+..
+.ec
+.
+.
+.\" Very crude references: Stash all reference info into boxes, print
+.\" out reference on .Re macro and clean up.  Ordering very limited, no
+.\" fancy citations, but can do articles, journals, and books -- need to
+.\" add several missing options (like city etc).  Should be able to grab
+.\" a refer entry, massage it a wee bit (prefix a '.' to the %A-Z) and
+.\" not worry (ha!).
+.
+.
+.\" NS doc-is-reference global register (bool)
+.\" NS   set if in reference
+.
+.nr doc-is-reference 0
+.
+.
+.\" NS doc-reference-count global register
+.\" NS   reference element counter
+.
+.nr doc-reference-count 0
+.
+.
+.\" NS Rs user macro
+.\" NS   reference start
+.\" NS
+.\" NS modifies:
+.\" NS   doc-is-reference
+.\" NS   doc-reference-count
+.\" NS
+.\" NS width register 'Rs' set in doc-common
+.
+.eo
+.de Rs
+.  ie \n.$ \
+.    tm Usage: .Rs (does not take arguments) (#\n.c)
+.  el \{\
+.    nr doc-is-reference 1
+.    doc-reset-reference
+.    if \ndoc-in-see-also-section \
+.      doc-paragraph
+.    nr doc-reference-count 0
+.  \}
+..
+.ec
+.
+.
+.\" NS Re user macro
+.\" NS   reference end
+.\" NS
+.\" NS modifies:
+.\" NS   doc-is-reference
+.\" NS
+.\" NS width register 'Re' set in doc-common
+.
+.eo
+.de Re
+.  ie \n.$ \
+.    tm Usage: .Re (does not take arguments) (#\n.c)
+.  el \{\
+.    if !\ndoc-is-reference \{\
+.      tm mdoc warning: Extraneous .Re (#\n.c)
+.      return
+.    \}
+.    doc-print-reference
+.    doc-reset-reference
+.    nr doc-is-reference 0
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-reset-reference macro
+.\" NS   reference cleanup
+.\" NS
+.\" NS modifies:
+.\" NS   doc-author-count
+.\" NS   doc-author-nameXXX
+.\" NS   doc-book-count
+.\" NS   doc-book-name
+.\" NS   doc-city-count
+.\" NS   doc-city-name
+.\" NS   doc-corporate-count
+.\" NS   doc-corporate-name
+.\" NS   doc-date
+.\" NS   doc-date-count
+.\" NS   doc-issue-count
+.\" NS   doc-issue-name
+.\" NS   doc-journal-count
+.\" NS   doc-journal-name
+.\" NS   doc-optional-count
+.\" NS   doc-optional-string
+.\" NS   doc-page-number-count
+.\" NS   doc-page-number-string
+.\" NS   doc-publisher-count
+.\" NS   doc-publisher-name
+.\" NS   doc-reference-count
+.\" NS   doc-reference-title-count
+.\" NS   doc-reference-title-name
+.\" NS   doc-reference-title-name-for-book
+.\" NS   doc-report-count
+.\" NS   doc-report-name
+.\" NS   doc-url-count
+.\" NS   doc-url-name
+.\" NS   doc-volume-count
+.\" NS   doc-volume-name
+.
+.eo
+.de doc-reset-reference
+.  while (\ndoc-author-count) \{\
+.    ds doc-author-name\ndoc-author-count
+.    nr doc-author-count -1
+.  \}
+.  nr doc-journal-count 0
+.  nr doc-issue-count 0
+.  nr doc-optional-count 0
+.  nr doc-corporate-count 0
+.  nr doc-report-count 0
+.  nr doc-reference-title-count 0
+.  nr doc-url-count 0
+.  nr doc-volume-count 0
+.  nr doc-city-count 0
+.  nr doc-date-count 0
+.  nr doc-page-number-count 0
+.  nr doc-book-count 0
+.  nr doc-publisher-count 0
+.  nr doc-reference-count 0
+.
+.  ds doc-journal-name
+.  ds doc-issue-name
+.  ds doc-optional-string
+.  ds doc-corporate-name
+.  ds doc-report-name
+.  ds doc-reference-title-name
+.  ds doc-reference-title-name-for-book
+.  ds doc-url-name
+.  ds doc-volume-name
+.  ds doc-city-name
+.  ds doc-date
+.  ds doc-page-number-string
+.  ds doc-book-name
+.  ds doc-publisher-name
+..
+.ec
+.
+.
+.\" NS doc-finish-reference macro
+.\" NS   auxiliary macro for doc-print-reference
+.\" NS
+.\" NS modifies:
+.\" NS   doc-reference-count
+.
+.eo
+.de doc-finish-reference
+.  nr doc-reference-count -\$1
+.  ie \ndoc-reference-count \
+.    nop \),
+.  el \
+.    nop \).
+..
+.ec
+.
+.
+.\" NS doc-print-reference macro
+.\" NS   reference print
+.\" NS
+.\" NS modifies:
+.\" NS   doc-reference-count
+.
+.eo
+.de doc-print-reference
+.
+.  nh
+.
+.  if \ndoc-author-count \{\
+.    doc-print-reference-authors
+.    nr doc-reference-count -\ndoc-author-count
+.  \}
+.
+.  if \ndoc-reference-title-count \{\
+.    unformat doc-reference-title-name
+.    chop doc-reference-title-name
+.    unformat doc-reference-title-name-for-book
+.    chop doc-reference-title-name-for-book
+.    ie ((\ndoc-journal-count == 1) : (\ndoc-book-count == 1)) \{\
+.      nop \)\*Lq\)\*doc-reference-title-name-for-book\)\*Rq\c
+.      doc-finish-reference \ndoc-reference-title-count
+.    \}
+.    el \{\
+.      nop \*doc-reference-title-name\c
+.      doc-finish-reference \ndoc-reference-title-count
+.  \}\}
+.
+.  if \ndoc-book-count \{\
+.    unformat doc-book-name
+.    chop doc-book-name
+.    nop \*doc-book-name\c
+.    doc-finish-reference \ndoc-book-count
+.  \}
+.
+.  if \ndoc-publisher-count \{\
+.    unformat doc-publisher-name
+.    chop doc-publisher-name
+.    nop \*doc-publisher-name\c
+.    doc-finish-reference \ndoc-publisher-count
+.  \}
+.
+.  if \ndoc-journal-count \{\
+.    unformat doc-journal-name
+.    chop doc-journal-name
+.    nop \*doc-journal-name\c
+.    doc-finish-reference \ndoc-journal-count
+.  \}
+.
+.  if \ndoc-report-count \{\
+.    unformat doc-report-name
+.    chop doc-report-name
+.    nop \*doc-report-name\c
+.    doc-finish-reference \ndoc-report-count
+.  \}
+.
+.  if \ndoc-issue-count \{\
+.    unformat doc-issue-name
+.    chop doc-issue-name
+.    nop \*doc-issue-name\c
+.    doc-finish-reference \ndoc-issue-count
+.  \}
+.
+.  if \ndoc-volume-count \{\
+.    unformat doc-volume-name
+.    chop doc-volume-name
+.    nop \*doc-volume-name\c
+.    doc-finish-reference \ndoc-volume-count
+.  \}
+.
+.  if \ndoc-url-count \{\
+.    unformat doc-url-name
+.    chop doc-url-name
+.    nop \*doc-url-name\c
+.    doc-finish-reference \ndoc-url-count
+.  \}
+.
+.  if \ndoc-page-number-count \{\
+.    unformat doc-page-number-string
+.    chop doc-page-number-string
+.    nop \*doc-page-number-string\c
+.    doc-finish-reference \ndoc-page-number-count
+.  \}
+.
+.  if \ndoc-corporate-count \{\
+.    unformat doc-corporate-name
+.    chop doc-corporate-name
+.    nop \*doc-corporate-name\c
+.    doc-finish-reference \ndoc-corporate-count
+.  \}
+.
+.  if \ndoc-city-count \{\
+.    unformat doc-city-name
+.    chop doc-city-name
+.    nop \*doc-city-name\c
+.    doc-finish-reference \ndoc-city-count
+.  \}
+.
+.  if \ndoc-date-count \{\
+.    unformat doc-date
+.    chop doc-date
+.    nop \*doc-date\c
+.    doc-finish-reference \ndoc-date-count
+.  \}
+.
+.  if \ndoc-optional-count \{\
+.    unformat doc-optional-string
+.    chop doc-optional-string
+.    nop \*doc-optional-string\c
+.    doc-finish-reference \ndoc-optional-count
+.  \}
+.
+.  if \ndoc-reference-count \
+.    tm mdoc warning: unresolved reference problem
+.
+.  hy \ndoc-hyphen-flags
+..
+.ec
+.
+.
+.\" NS doc-print-reference-authors macro
+.\" NS   print out reference authors
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-dpra
+.\" NS   doc-str-dpra
+.
+.ds doc-str-dpra "and
+.
+.eo
+.de doc-print-reference-authors
+.  nr doc-reg-dpra 1
+.
+.  while (\ndoc-reg-dpra < \ndoc-author-count) \{\
+.    unformat doc-author-name\ndoc-reg-dpra
+.    chop doc-author-name\ndoc-reg-dpra
+.    ie (\ndoc-author-count > 2) \
+.      nop \)\*doc-author-name\ndoc-reg-dpra,
+.    el \
+.      nop \)\*doc-author-name\ndoc-reg-dpra
+.    nr doc-reg-dpra +1
+.  \}
+.
+.  unformat doc-author-name\ndoc-reg-dpra
+.  chop doc-author-name\ndoc-reg-dpra
+.  if (\ndoc-author-count > 1) \
+.    nop \)\*doc-str-dpra
+.  nop \)\*doc-author-name\ndoc-reg-dpra,
+..
+.ec
+.
+.
+.\" NS doc-author-count global register
+.\" NS   counter of author references
+.
+.nr doc-author-count 0
+.
+.
+.\" NS doc-author-nameXXX global box
+.\" NS   array of author names
+.\" NS
+.\" NS limit:
+.\" NS   doc-author-count
+.
+.ds doc-author-name0
+.
+.
+.\" NS %A user macro
+.\" NS   reference author(s)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-author-count
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%A
+.\" NS
+.\" NS width register '%A' set in doc-common
+.
+.eo
+.de %A
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%A author_name ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-author-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %A
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" save to reference box
+.  box doc-author-name\ndoc-author-count
+.  ev doc-env-%A
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-book-count global register
+.\" NS   counter of book references
+.
+.nr doc-book-count 0
+.
+.
+.\" NS doc-book-name global box
+.\" NS   string of collected book references
+.
+.ds doc-book-name
+.
+.
+.\" NS %B user macro
+.\" NS   reference book name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-book-count
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%B
+.\" NS
+.\" NS width register '%B' set in doc-common
+.
+.eo
+.de %B
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%B book_name ... (#\n.c)
+.    return
+.  \}
+.
+.  if \ndoc-is-reference \{\
+.    nr doc-book-count +1
+.    nr doc-reference-count +1
+.  \}
+.
+.  ds doc-macro-name %B
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  ie \ndoc-is-reference \{\
+.    \" append to reference box
+.    boxa doc-book-name
+.    ev doc-env-%B
+.    evc 0
+.    in 0
+.    nf
+.    nop \*doc-Em-font\c
+.    doc-do-references
+.  \}
+.  el \{\
+.    nop \*doc-Em-font\c
+.    doc-print-recursive
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-city-count global register
+.\" NS   counter of city references
+.
+.nr doc-city-count 0
+.
+.
+.\" NS doc-city-name global box
+.\" NS   string of collected city references
+.
+.ds doc-city-name
+.
+.
+.\" NS %C user macro
+.\" NS   reference city
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-city-count
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%C
+.\" NS
+.\" NS width register '%C' set in doc-common
+.
+.eo
+.de %C
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%C city_name ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-city-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %C
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-city-name
+.  ev doc-env-%C
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-date-count global register
+.\" NS   counter of date references
+.
+.nr doc-date-count 0
+.
+.
+.\" NS doc-date global box
+.\" NS   string of collected date references
+.
+.ds doc-date
+.
+.
+.\" NS %D user macro
+.\" NS   reference date
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-date-count
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%D
+.\" NS
+.\" NS width register '%D' set in doc-common
+.
+.eo
+.de %D
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%D date ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-date-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %D
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-date
+.  ev doc-env-%D
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-publisher-count global register
+.\" NS   counter of publisher references
+.
+.nr doc-publisher-count 0
+.
+.
+.\" NS doc-publisher-name global box
+.\" NS   string of collected publisher references
+.
+.ds doc-publisher-name
+.
+.
+.\" NS %I user macro
+.\" NS   reference issuer/publisher name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-publisher-count
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%I
+.\" NS
+.\" NS width register '%I' set in doc-common
+.
+.eo
+.de %I
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%I issuer/publisher_name ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-publisher-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %I
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-publisher-name
+.  ev doc-env-%I
+.  evc 0
+.  in 0
+.  nf
+.  nop \*doc-Em-font\c
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-journal-count global register
+.\" NS   counter of journal references
+.
+.nr doc-journal-count 0
+.
+.
+.\" NS doc-journal-name global box
+.\" NS   string of collected journal references
+.
+.ds doc-journal-name
+.
+.
+.\" NS %J user macro
+.\" NS   reference Journal Name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-journal-count
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%J
+.\" NS
+.\" NS width register '%J' set in doc-common
+.
+.eo
+.de %J
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%J journal_name ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-journal-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %J
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-journal-name
+.  ev doc-env-%J
+.  evc 0
+.  in 0
+.  nf
+.  nop \*doc-Em-font\c
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-issue-count global register
+.\" NS   counter of issue number references
+.
+.nr doc-issue-count 0
+.
+.
+.\" NS doc-issue-name global box
+.\" NS   string of collected issue number references
+.
+.ds doc-issue-name
+.
+.
+.\" NS %N user macro
+.\" NS   reference issue number
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-issue-count
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%N
+.\" NS
+.\" NS width register '%N' set in doc-common
+.
+.eo
+.de %N
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%N issue_number ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-issue-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %N
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-issue-name
+.  ev doc-env-%N
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-optional-count global register
+.\" NS   counter of optional information references
+.
+.nr doc-optional-count 0
+.
+.
+.\" NS doc-optional-string global box
+.\" NS   string of collected optional information references
+.
+.ds doc-optional-string
+.
+.
+.\" NS %O user macro
+.\" NS   reference optional information
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-optional-count
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%O
+.\" NS
+.\" NS width register '%O' set in doc-common
+.
+.eo
+.de %O
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%O optional_information ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-optional-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %O
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-optional-string
+.  ev doc-env-%O
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-page-number-count global register
+.\" NS   counter of page number references
+.
+.nr doc-page-number-count 0
+.
+.
+.\" NS doc-page-number-string global box
+.\" NS   string of collected page number references
+.
+.ds doc-page-number-string
+.
+.
+.\" NS %P user macro
+.\" NS   reference page numbers
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-page-number-count
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%P
+.\" NS
+.\" NS width register '%P' set in doc-common
+.
+.eo
+.de %P
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%P page_number ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-page-number-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %P
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-page-number-string
+.  ev doc-env-%P
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-corporate-count global register
+.\" NS   counter of corporate references
+.
+.nr doc-corporate-count 0
+.
+.
+.\" NS doc-corporate-name global box
+.\" NS   string of collected corporate references
+.
+.ds doc-corporate-name
+.
+.
+.\" NS %Q user macro
+.\" NS   corporate or foreign author
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-corporate-count
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%Q
+.\" NS
+.\" NS width register '%Q' set in doc-common
+.
+.eo
+.de %Q
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%Q corporate_or_foreign_author ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-corporate-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %Q
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-corporate-name
+.  ev doc-env-%Q
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-report-count global register
+.\" NS   counter of report references
+.
+.nr doc-report-count 0
+.
+.
+.\" NS doc-report-name global box
+.\" NS   string of collected report references
+.
+.ds doc-report-name
+.
+.
+.\" NS %R user macro
+.\" NS   reference report name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS   doc-report-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%R
+.\" NS
+.\" NS width register '%R' set in doc-common
+.
+.eo
+.de %R
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%R reference_report ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-report-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %R
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-report-name
+.  ev doc-env-%R
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-reference-title-count global register
+.\" NS   counter of reference title references
+.
+.nr doc-reference-title-count 0
+.
+.
+.\" NS doc-reference-title-name global box
+.\" NS   string of collected reference title references
+.
+.ds doc-reference-title-name
+.
+.
+.\" NS doc-reference-title-name-for-book global box
+.\" NS   string of collected reference title references
+.\" NS   (saved with another font; this is a shortcoming of groff)
+.
+.ds doc-reference-title-name-for-book
+.
+.
+.\" NS %T user macro
+.\" NS   reference title
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-title-count
+.\" NS   doc-report-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%T
+.\" NS
+.\" NS width register '%T' set in doc-common
+.
+.eo
+.de %T
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%T reference_title ... (#\n.c)
+.    return
+.  \}
+.
+.  if \ndoc-is-reference \{\
+.    nr doc-reference-title-count +1
+.    nr doc-reference-count +1
+.  \}
+.
+.  ds doc-macro-name %T
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.  ie \ndoc-is-reference \{\
+.    \" append to reference box
+.    boxa doc-reference-title-name-for-book
+.    ev doc-env-%T
+.    evc 0
+.    in 0
+.    nf
+.    nop \*doc-No-font\c
+.    doc-do-references
+.
+.    \" do it a second time with another font
+.    ds doc-macro-name %T
+.    doc-parse-args \$@
+.
+.    nr doc-arg-ptr +1
+.    nr doc-curr-font \n.f
+.    boxa doc-reference-title-name
+.    ev doc-env-%T
+.    evc 0
+.    in 0
+.    nf
+.    nop \*doc-Em-font\c
+.    doc-do-references
+.  \}
+.  el \{\
+.    nop \*doc-Em-font\c
+.    doc-print-recursive
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-url-count global register
+.\" NS   counter of hypertext references
+.
+.nr doc-url-count 0
+.
+.
+.\" NS doc-url-name global box
+.\" NS   string of collected hypertext references
+.
+.ds doc-url-name
+.
+.
+.\" NS doc-volume-count global register
+.\" NS   counter of reference title references
+.
+.nr doc-volume-count 0
+.
+.
+.\" NS doc-volume-name global box
+.\" NS   string of collected volume references
+.
+.ds doc-volume-name
+.
+.
+.\" NS %U user macro
+.\" NS   hypertext reference
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS   doc-url-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%U
+.\" NS
+.\" NS width register '%U' set in doc-common
+.
+.eo
+.de %U
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%U URL ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-url-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %U
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-url-name
+.  ev doc-env-%U
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS %V user macro
+.\" NS   reference volume
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS   doc-reference-count
+.\" NS   doc-volume-count
+.\" NS
+.\" NS local variables:
+.\" NS   doc-env-%V
+.\" NS
+.\" NS width register '%V' set in doc-common
+.
+.eo
+.de %V
+.  if (\ndoc-arg-count : (\n.$ == 0)) \{\
+.    tm Usage: .%V volume ... (#\n.c)
+.    return
+.  \}
+.
+.  nr doc-volume-count +1
+.  nr doc-reference-count +1
+.
+.  ds doc-macro-name %V
+.  doc-parse-args \$@
+.
+.  nr doc-arg-ptr +1
+.  nr doc-curr-font \n.f
+.
+.  \" append to reference box
+.  boxa doc-volume-name
+.  ev doc-env-%V
+.  evc 0
+.  in 0
+.  nf
+.  doc-do-references
+..
+.ec
+.
+.
+.\" NS doc-do-references macro
+.\" NS   reference recursion routine
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-ddr
+.\" NS   doc-reg-ddr1
+.
+.eo
+.de doc-do-references
+.  if !\ndoc-is-reference \
+.    tm mdoc error: .\*doc-macro-name found outside of .Rs ... .Re (#\n.c)
+.
+.  nr doc-reg-ddr1 \ndoc-type\ndoc-arg-ptr
+.
+.  ie (\ndoc-reg-ddr1 == 1) \{\
+.    \" .nop \f\ndoc-curr-font\c
+.    doc-append-arg \c 3
+.    \*doc-arg\ndoc-arg-ptr
+.  \}
+.  el \{\
+.    nop \)\*doc-arg\ndoc-arg-ptr\c
+.
+.    ie (\ndoc-arg-count == \ndoc-arg-ptr) \{\
+.      \" finish reference box
+.      br
+.      ev
+.      boxa
+.
+.      doc-reset-args
+.    \}
+.    el \{\
+.      nr doc-reg-ddr \ndoc-arg-ptr
+.      nr doc-arg-ptr +1
+.      nop \)\*doc-space\ndoc-reg-ddr\c
+.      doc-do-references
+.  \}\}
+..
+.ec
+.
+.
+.\" NS Hf user macro
+.\" NS   source include header files.
+.\" NS
+.\" NS modifies:
+.\" NS   doc-curr-font
+.\" NS
+.\" NS width register 'Hf' set in doc-common
+.
+.eo
+.de Hf
+.  ie ((\n.$ == 1) & (\ndoc-arg-count == 0)) \{\
+.    doc-paragraph
+.    nop File:
+.    Pa \$1
+.
+.    Bd -literal
+.    so \$1
+.    Ed
+.
+.    doc-paragraph
+.  \}
+.  el \
+.    Usage: .Hf file (#\n.c)
+..
+.ec
+.
+.
+.\" NS doc-have-author global register (bool)
+.\" NS   set in 'An'
+.
+.nr doc-have-author 0
+.
+.
+.\" NS An user macro
+.\" NS   author name
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-have-author
+.\" NS   doc-macro-name
+.\" NS
+.\" NS width register 'An' set in doc-common
+.
+.eo
+.de An
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ie        "\$1"-nosplit" \
+.        nr doc-in-authors-section 0
+.      el \{ .ie "\$1"-split" \
+.        nr doc-in-authors-section 1
+.      el \{\
+.        ds doc-macro-name An
+.        doc-parse-args \$@
+.    \}\}\}
+.    el \{\
+.      tm1 "Usage: .An {-nosplit | -split}
+.      tm1 "       .An author_name ... (#\n.c)
+.  \}\}
+.
+.  if \ndoc-in-authors-section \{\
+.    ie \ndoc-have-author \
+.      br
+.    el \
+.      nr doc-have-author 1
+.  \}
+.
+.  if \ndoc-arg-count \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.      nr doc-curr-font \n.f
+.      doc-print-recursive
+.    \}
+.    el \{\
+.      tm Usage: .An author_name ... (#\n.c)
+.      doc-reset-args
+.  \}\}
+..
+.ec
+.
+.
+.\" NS Rv user macro
+.\" NS   return values
+.\" NS
+.\" NS width register 'Rv' set in doc-common
+.\" NS
+.\" NS local variables:
+.\" NS   doc-str-Rv-std-prefix
+.\" NS   doc-str-Rv-std-suffix
+.\" NS   doc-str-Rv-stds-prefix
+.\" NS   doc-str-Rv-stds-and
+.\" NS   doc-str-Rv-stds-suffix
+.\" NS   doc-str-Rv-std0
+.
+.eo
+.ds doc-str-Rv-std-prefix "The
+.ds doc-str-Rv-std-suffix "function returns the value\~0 if successful;
+.as doc-str-Rv-std-suffix " otherwise the value\~\-1 is returned and
+.as doc-str-Rv-std-suffix " the global variable \*doc-Va-fonterrno\f
+.as doc-str-Rv-std-suffix " is set to indicate the error.
+.
+.ds doc-str-Rv-stds-prefix "The
+.ds doc-str-Rv-stds-and    "and
+.ds doc-str-Rv-stds-suffix "functions return the value\~0 if successful;
+.as doc-str-Rv-stds-suffix " otherwise the value\~\-1 is returned and
+.as doc-str-Rv-stds-suffix " the global variable \*doc-Va-fonterrno\f
+.as doc-str-Rv-stds-suffix " is set to indicate the error.
+.
+.ds doc-str-Rv-std0 "Upon successful completion, the value\~0 is returned;
+.as doc-str-Rv-std0 " otherwise the value\~\-1 is returned and
+.as doc-str-Rv-std0 " the global variable \*doc-Va-fonterrno\f
+.as doc-str-Rv-std0 " is set to indicate the error.
+.ec
+.
+.eo
+.de Rv
+.
+.\" XXX: what does this function without '-std'?
+.
+.  if \ndoc-arg-count \{\
+.    tm Usage: .Rv not callable by other macros (#\n.c)
+.    doc-reset-args
+.    return
+.  \}
+.
+.  if !\n.$ \{\
+.    tm Usage: .Rv -std <function> ... (#\n.c)
+.    return
+.  \}
+.
+.  if "\$1"-std" \{\
+.    nr doc-reg-Rv \*doc-section
+.    if ((\ndoc-reg-Rv < 2) : (\ndoc-reg-Rv > 3)) \
+.      tm Usage: .Rv -std in sections 2 and 3 only (#\n.c)
+.    br
+.    shift
+.    ie (\n.$ > 1) \{\
+.      nop \)\*doc-str-Rv-stds-prefix
+.      nr doc-reg-Rv 1
+.      while (\ndoc-reg-Rv < \n.$) \{\
+.        ie (\n.$ > 2) \
+.          Fn \$\ndoc-reg-Rv ,
+.        el \
+.          Fn \$\ndoc-reg-Rv
+.        nr doc-reg-Rv +1
+.      \}
+.      nop \)\*doc-str-Rv-stds-and
+.      Fn \$\n.$
+.      nop \)\*doc-str-Rv-stds-suffix
+.    \}
+.    el \{ .ie (\n.$ == 1) \{\
+.      nop \)\*doc-str-Rv-std-prefix
+.      Fn \$1
+.      nop \)\*doc-str-Rv-std-suffix
+.    \}
+.    el \{\
+.      nop \)\*doc-str-Rv-std0
+.  \}\}\}
+..
+.ec
+.
+.
+.\" NS Ex user macro
+.\" NS   exit status
+.\" NS
+.\" NS width register 'Ex' set in doc-common
+.\" NS
+.\" NS local variables:
+.\" NS   doc-str-Ex-std-prefix
+.\" NS   doc-str-Ex-std-suffix
+.
+.ds doc-str-Ex-std-prefix "The
+.ds doc-str-Ex-std-suffix "utility exits\~0 on success,
+.as doc-str-Ex-std-suffix " and\~>0 if an error occurs.
+.
+.ds doc-str-Ex-stds-prefix "The
+.als doc-str-Ex-stds-and doc-str-Rv-stds-and
+.ds doc-str-Ex-stds-suffix "utilities exit\~0 on success,
+.as doc-str-Ex-stds-suffix " and\~>0 if an error occurs.
+.
+.eo
+.de Ex
+.
+.\" XXX: what does this function without '-std'?
+.
+.  if \ndoc-arg-count \{\
+.    tm Usage: .Ex not callable by other macros (#\n.c)
+.    doc-reset-args
+.    return
+.  \}
+.
+.  if !\n.$ \{\
+.    tm Usage: .Ex -std <utility> ... (#\n.c)
+.    return
+.  \}
+.
+.  if "\$1"-std" \{\
+.    nr doc-reg-Ex \*doc-section
+.    if !((\ndoc-reg-Ex == 1) : (\ndoc-reg-Ex == 6) : (\ndoc-reg-Ex == 8)) \
+.      tm Usage: .Ex -std in sections 1, 6 and 8 only (#\n.c)
+.    br
+.    shift
+.    ie (\n.$ > 1) \{\
+.      nop \)\*doc-str-Ex-stds-prefix
+.      nr doc-reg-Ex 1
+.      while (\ndoc-reg-Ex < \n.$) \{\
+.        ie (\n.$ > 2) \
+.          Nm \$\ndoc-reg-Ex ,
+.        el \
+.          Nm \$\ndoc-reg-Ex
+.        nr doc-reg-Ex +1
+.      \}
+.      nop \)\*doc-str-Ex-stds-and
+.      Nm \$\n.$
+.      nop \)\*doc-str-Ex-stds-suffix
+.    \}
+.    el \{\
+.      nop \)\*doc-str-Ex-std-prefix
+.      Nm \$1
+.      nop \)\*doc-str-Ex-std-suffix
+.  \}\}
+..
+.ec
+.
+.
+.\" NS Mt user macro
+.\" NS   mailto (for conversion to HTML)
+.
+.eo
+.de Mt
+.  \" XXX: error handling missing
+.  Pa \$@
+..
+.ec
+.
+.
+.\" NS Lk user macro
+.\" NS   link (for conversion to HTML)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variables:
+.\" NS   doc-lasttext-Lk
+.\" NS   doc-target-Lk
+.
+.eo
+.de Lk
+.  if !\ndoc-arg-count \{\
+.    ds doc-macro-name Lk
+.    doc-parse-args \$@
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  \" The first argument is the target URI.
+.  nr doc-arg-ptr +1
+.  ds doc-target-Lk "\*doc-arg\ndoc-arg-ptr
+.  nr doc-arg-ptr +1
+.
+.  \" Search backwards for the first closing punctuation.
+.  nr doc-lasttext-Lk \ndoc-arg-count
+.  while (\ndoc-lasttext-Lk >= \ndoc-arg-ptr) \{\
+.    if !(\ndoc-type\ndoc-lasttext-Lk == 3) \
+.      break
+.    nr doc-lasttext-Lk -1
+.  \}
+.
+.  \" Format the link text, if any.
+.  \" XXX: The forced use of the emphasis font and a trailing colon
+.  \" seems intrusive.
+.  nr doc-curr-font \n.f
+.  if (\ndoc-arg-ptr <= \ndoc-lasttext-Lk) \{\
+.    nop \*doc-Em-font\c
+.    while (\ndoc-arg-ptr < \ndoc-lasttext-Lk) \{\
+.      nop \&\*doc-arg\ndoc-arg-ptr
+.      nr doc-arg-ptr +1
+.    \}
+.    nop \&\*doc-arg\ndoc-arg-ptr\c
+.    nop \f\ndoc-curr-font:
+.    nr doc-arg-ptr +1
+.  \}
+.
+.  \" Format the link target.
+.  nop \*doc-Lk-font\*doc-target-Lk\c
+.  nop \f\ndoc-curr-font\c
+.
+.  \" Format trailing arguments, like punctuation, if any.
+.  ie (\ndoc-arg-ptr <= \ndoc-arg-count) \
+.    doc-print-recursive
+.  el \{\
+.    nop \&
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-defunct-macro macro
+.\" NS   this is the skeleton for defunct macros
+.\" NS
+.
+.eo
+.de doc-defunct-macro
+.  tmc mdoc error: .\$0 defunct
+.  if d doc-\$0-usage \
+.    tmc , \*doc-\$0-usage
+.  tm1 " (#\n.c)
+..
+.ec
+.
+.
+.\" obsolete macros
+.
+.als Db doc-defunct-macro
+.
+.als Ds doc-defunct-macro
+.
+.als Or doc-defunct-macro
+.ds doc-Or-usage use '|'
+.
+.als Sf doc-defunct-macro
+.ds doc-Sf-usage use .Pf or .Ns
+.
+.
+.rn em e@
+.
+.eo
+.de em
+.  tm1 "mdoc error: end-macro (.em) respecification is not allowed. (#\n.c)
+.  tm1 "            Should this have been '.Em ...'?
+.  ab
+..
+.ec
+.
+.
+.\" NS doc-empty-line macro
+.\" NS   emit warning and print empty line
+.
+.eo
+.de doc-empty-line
+.  if !\ndoc-display-depth \
+.    tm mdoc warning: Empty input line #\n.c
+.  sp
+..
+.ec
+.
+.blm doc-empty-line
+.
+.
+.ec
+.
+.
+.\" For UTF-8, map the minus sign to the hyphen-minus to facilitate
+.\" copy and paste of code examples, file names, and URLs embedding it.
+.if '\*.T'utf8' \
+.  char \- \N'45'
+.
+.
+.\" load local modifications
+.mso mdoc.local
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/dvi.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/dvi.tmac Changed

@@ -1,6 +1,6 @@
 .\" dvi.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_dvi_tmac_C \n.cp
 .cp 0
 .
 .ftr CR CW
@@ -8,6 +8,7 @@
 .ftr CO CWI
 .ftr CI CWI
 .ftr CB CW
+.ftr CBI CWI
 .ftr TT CW
 .ftr H HR
 .
@@ -81,7 +82,16 @@
 .fchar \=~ \v'.1m'\Z'\eq'\v'-.4m'\ap\v'.3m'
 .fchar \tm \v'-.3m'\s\En.s/2uTM\s0\v'.3m'
 .\" TC fonts contain real \aq glyphs
-.schar \aq '
+.fschar TR \aq \fTRTC\aq
+.fschar TI \aq \fTITC\aq
+.fschar TB \aq \fTBTC\aq
+.fschar TBI \aq \fTBITC\aq
+.fschar HR \aq \fHRTC\aq
+.fschar HI \aq \fHITC\aq
+.fschar HB \aq \fHBTC\aq
+.fschar HBI \aq \fHBITC\aq
+.fschar CW \aq \fCWTC\aq
+.fschar CWI \aq \fCWITC\aq
 .fchar \bq ,
 .fchar \Bq ,\h'\w'\rq'u-(2u*\w"'"u)',
 .fchar \ho \s\En.s/2u\v'.4m'c\v'-.4m'\s0
@@ -777,16 +787,13 @@
 .defcolor yellow3 rgb #cdcd00
 .defcolor yellow4 rgb #8b8b00
 .
-.cp \n(_C
-.
-.do ie '\char97'a' \
-.  do mso latin1.tmac
+.ie '\char97'a' \
+.  mso latin1.tmac
 .el \
-.  do mso cp1047.tmac
+.  mso cp1047.tmac
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_dvi_tmac_C
+.do rr *groff_dvi_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.23.0.tar.gz/tmac/e.tmac Added

@@ -0,0 +1,2255 @@
+.\" Copyright (c) 1988, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"	@(#)e.tmac	8.1 (Berkeley) 06/05/93
+.\"
+.\"	Modified by James Clark for use with groff.
+.\"	Further modifications by Werner Lemberg, George Helffrich, and
+.\"	G. Branden Robinson.
+.\"
+.\"**************************************************************
+.\"*								*
+.\"*	****  - M E   N R O F F / T R O F F   M A C R O S  ****	*
+.\"*								*
+.\"*	Produced for your edification and enjoyment by:		*
+.\"*		Eric Allman					*
+.\"*		Electronics Research Laboratory			*
+.\"*		U.C. Berkeley.					*
+.\"*								*
+.\"*	VERSION 8.1	First Release: 11 Sept 1978		*
+.\"*								*
+.\"*	Documentation is available.				*
+.\"*								*
+.\"**************************************************************
+.\"
+.\"	Macro definitions are annotated with a code:
+.\"		***	user interface macro
+.\"		$$$	macro which may be redefined by the user
+.\"			to provide variant functions
+.\"		---	internal macro; not to be called by user
+.\"
+.
+.do nr devtag-needs-end-of-heading 0
+.do nr devtag-needs-end-of-title 0
+.do nr devtag-needs-title 1
+.
+.do mso devtag.tmac
+.
+.if !\n(.g .ig
+.de @R		\" --- initialize number register to 0, if undefined
+.do if !r\\$1 .nr \\$1 0
+..
+.
+.ds _e e.tmac\" name of macro package, for diagnostic messages
+.
+.\" emit error diagnostic
+.do de1 @err
+.ds @file \" empty
+.ds @line \" empty
+.if !'\\n.F'' .ds @file \\n.F:\"
+.if !'\\n.c'0' .ds @line \\n.c:\"
+.tm \\*(_e:\\*@file\\*@line \\$*
+.rm @file
+.rm @line
+..
+.
+.\" --- check whether grohtml needs end of title/heading
+.do de1 @html_check_need_title
+.if \\ndevtag-needs-end-of-title \
+\{\
+.	nr devtag-needs-end-of-title 0
+.	DEVTAG-EO-TL
+.\}
+.if \\ndevtag-needs-title \
+\{\
+.	DEVTAG-TL
+.	nr devtag-needs-title 0
+.	nr devtag-needs-end-of-title 1
+.\}
+.if \\ndevtag-needs-end-of-heading .DEVTAG-EO-H
+.nr devtag-needs-end-of-heading 0
+..
+.
+.\" If this macro were non-empty, we'd want to define it with .de1.
+.do de @check_need_title
+..
+.
+.ie '\*(.T'html' \
+.	do als check_need_title @html_check_need_title
+.el \
+.	do als check_need_title @check_need_title
+.
+.@R pf
+.if \n(pf .nx
+.
+.if !\n(.g .ig
+.de @S		\" --- initialize string/macro to empty, if undefined
+.do if !d\\$1 .ds \\$1\" empty
+..
+.
+.@R @\"			\" debugging level
+.
+.
+.\"		*** INTERNAL GP MACROS ***
+.
+.
+.de @C			\" --- change environments, taking info with us
+.nr _S \\n(.s
+.nr _V \\n(.v
+.nr _F \\n(.f
+.nr _J \\n(.j
+.do ds _A \\n.fam
+.nr _I \\n(.i
+.ev \\$1
+.ps \\n(_S
+.vs \\n(_Vu
+.ft \\n(_F
+.ad \\n(_J
+.do @fam \\*(_A
+'in \\n(_Iu
+.xl \\n($lu
+.lt \\n($lu
+.rr _S
+.rr _V
+.rr _F
+.rr _I
+.rr _J
+.ls 1
+'ce 0
+..
+.
+.de @D		\" --- determine display type (Indent, Left, Center)
+.ds |p "\\$3
+.nr _d 0
+.if "\\$2"C" \
+.	nr _d 1
+.if "\\$2"L" \
+.	nr _d 2
+.if "\\$2"I" \
+.	nr _d 3
+.if "\\$2"M" \
+.	nr _d 4
+.if !\\n(_d \
+\{\
+.	nr _d \\$1
+.	ds |p "\\$2
+.\}
+.
+..
+.
+.rn nm @#		\" --- save troff request
+.de nm			\" --- turn on number mode, preserving font info
+.ie \\n(.$ \
+\{\
+.	nr _S \\n(.s
+.	nr _F \\n(.f
+.	do if r _#p .do ps \\n_#p
+.	do if r _#f .do ft \\n_#f
+.	@# \\$1 \\$2 \\$3 \\$4
+.	ft \\n(_F
+.	ps \\n(_S
+.	rr _F
+.	rr _S
+.\}
+.el .@#
+..
+.
+.de @z			\" --- end macro
+.if \n@>1 .tm >> @z, .z=\\n(.z ?a=\\n(?a
+.if !"\\n(.z"" \
+\{\
+.	do @err unclosed block, footnote, or other diversion (\\n(.z)
+.	di
+.	ex
+.\}
+.if \\n(?a \
+.	bp\"			\" force out final table
+.ds bp
+.ds @b\"			\" don't start another page
+.br
+.if \n@>1 .tm << @z
+..
+.
+.
+.\"		*** STANDARD HEADERS AND FOOTERS ***
+.
+.
+.ie \n(.g .ds $* \\\\$*
+.el .ds $* \\\\$1 \\\\$2 \\\\$3 \\\\$4 \\\\$5 \\\\$6 \\\\$7 \\\\$8 \\\\$9
+.
+.de he			\" *** define header
+.ie !\\n(.$ \
+\{\
+.	rm |4
+.	rm |5
+.\}
+.el \
+\{\
+.	ds |4 "\*($*
+.	ds |5 "\*($*
+.\}
+..
+.
+.de eh			\" *** define even header
+.ie !\\n(.$ \
+.	rm |4
+.el \
+.	ds |4 "\*($*
+..
+.
+.de oh			\" *** define odd header
+.ie !\\n(.$ \
+.	rm |5
+.el \
+.	ds |5 "\*($*
+..
+.
+.de fo			\" *** define footer
+.ie !\\n(.$ \
+\{\
+.	rm |6
+.	rm |7
+.\}
+.el \
+\{\
+.	ds |6 "\*($*
+.	ds |7 "\*($*
+.\}
+..
+.
+.de ef			\" *** define even footer
+.ie !\\n(.$ \
+.	rm |6
+.el \
+.	ds |6 "\*($*
+..
+.
+.de of			\" *** define odd footer
+.ie !\\n(.$ \
+.	rm |7
+.el \
+.	ds |7 "\*($*
+..
+.
+.de ep			\" *** end page (must be followed by a .bp)
+.if \\n(nl>0 \
+\{\
+.	wh 0
+.	rs
+.	@b
+.\}
+..
+.
+.
+.\"		*** INTERNAL HEADER AND FOOTER MACROS ***
+.
+.
+.de @h			\" --- header
+.if \n@>1 .tm >> @h %=\\n% ?a=\\n(?a ?b=\\n(?b ?w=\\n(?w
+.do if (u;\\n(tm+\\n(bm+\\n(.V>\\n(.p) \{\
+.	do @err insufficient page length; aborting
+.	pl \\n(nlu
+.	ab
+.\}
+.do if (u;\\n(.i+\\n(.o>=\\n(.l) \
+.	do @err page offset plus indentation exceeds line length
+.\" initialize a pile of junk
+.nr ?h \\n(?H			\" transfer "next page" to "this page"
+.nr ?H 0
+.nr ?c \\n(?C
+.nr ?C 0
+.do if d |4 .rn |4 |0
+.do if d |5 .rn |5 |1
+.do if d |6 .rn |6 |2
+.do if d |7 .rn |7 |3
+.nr _w 0			\" reset max footnote width
+.nr ?W 0			\" no wide floats this page (yet)
+.nr ?I 1
+.\" begin actual header stuff
+.ev 2
+.rs
+.if \\n(hm>0 \
+.	if !'\*(.T'html' \
+.		sp |\\n(hmu	\" move to header position
+.@t $h\"			\" output header title
+.if \\n(tm<=0 \
+.	nr tm \n(.Vu
+.if !'\*(.T'html' \
+.	sp |\\n(tmu		\" move to top of text
+.ev
+.mk _k				\" for columned output
+.if \\n(?n=1 .nm 1\"		restore line numbering if n1 mode
+.nr $c 1			\" set first column
+.if \n@>4 .tm -- @h >> .ns nl=\\n(nl %=\\n% _k=\\n(_k tm=\\n(tm
+.ie \\n(?s \
+\{\
+.	nr ?s 0
+.	rs
+'	@b
+.\}
+.el \
+.	@n\"			\" begin the column
+.if \n@>2 .tm << @h
+..
+.
+.de @n			\" --- new column or page
+.if \n@>3 .tm >> @n nl=\\n(nl %=\\n% ?f=\\n(?f ?o=\\n(?o
+.if \\n(bm<=0 \
+.	nr bm \\n(.Vu
+.if (\\n(_w<=\\n($l)&(\\n(?W=0) \
+\{\
+.	\" Compute fudge factor (must be < 1P).
+.	nr _b (\\n(ppp*\\n(tvu)/200u
+.	if \\n(_bu>((\\n(bmu-\\n(fmu-((\\n(tpp*\\n(tvu)/100u))/2u) \
+.		nr _b (\\n(ppp*\\n(tvu)/100u-\n(.Vu
+.	nr _b +\\n(bmu
+.\}
+.nr _B \\n(_bu
+.ch @f
+.wh -\\n(_bu @f
+.nr _b +(\\n(ppp*\\n(tvu)/100u \" add 1 paragraph v in case sweep past
+.if \n@>2 .tm @n .p=\\n(.p bm=\\n(bm _b=\\n(_b _B=\\n(_B
+.nr ?f 0			\" reset footnote flag
+.if \\n(?o \
+\{\
+.	(f _\"		\" reprocess footnotes which run off page
+.	nf
+.	|o
+.	fi
+.	)f
+.	rm |o
+.\}
+.nr ?o 0
+.if \\n(?T \
+\{\
+.	nr _i \\n(.i
+.	if \\n(?n \
+.		nm \\n(ln
+.	in 0
+.	|h\"			\" output the table header
+.	in \\n(_iu
+.	if \\n(?n \
+.		nm
+.	rr _i
+.	mk #T			\" for tbl commands
+.	ns
+.\}
+.if (\\n(?a)&((\\n($c<2):(\\n(?w=0)) \
+\{\
+.	nr ?a 0			\" output floating keep
+.	@k |t
+.	if \\n(?w \
+.		mk _k		\" don't overstrike wide keeps
+.	nr ?w 0
+.\}
+.os
+.$H\"				\" special column header macro
+.ns
+..
+.
+.de @f			\" --- footer
+.if \n@>1 .tm >> @f %=\\n% nl=\\n(nl ?a=\\n(?a ?b=\\n(?b ?f=\\n(?f
+.if \n@>2 .nr __ \\n(.pu-\\n(nlu
+.if \n@>2 .tm @f bm=\\n(bm _B=\\n(_B _b=\\n(_b .p-nl=\\n(__
+.if \n@>2 .rr __
+.if \\n(?T \
+\{\
+.	nr T. 1		\" for tbl commands (to output bottom line)
+.	T# 1\"		\" output the sides and bottom lines
+.	br
+.\}
+.ev 2
+.ce 0
+.if \\n(?b \
+\{\
+.	nr ?b 0
+.	@k |b\"			\" output bottom of page tables
+.\}
+.if \\n(?f \
+.	@o\"			\" output footnote if present
+.ie \\n($c<\\n($m \
+.	@c\"			\" handle new column
+.el \
+.	@e\"			\" new page
+.ev
+.if \n@>2 .tm << @f
+..
+.
+.de @o			\" --- output footnote
+.nf
+.ls 1
+.in 0
+.if \n@>2 .tm @o last printed text = \\n(nl placing @r trap at -\\n(_B
+.wh -\\n(_Bu @r
+.if \\n(?n \
+.	nm \\n(ln
+.if \\n(_f \
+.	if !\\n(_f=\\n($m \
+.		do @err writing \\n($m-column footnote in \
+\\n(_f-column layout
+.|f
+.nr _f 0
+.if \\n(?n \
+.	nm
+.fi
+.if \n@>2 .tm @o triggered @r (?o) = \\n(?o
+.if \\n(?o \
+\{\
+.	di			\" just in case triggered @r
+.	if \\n(dn=0 \
+\{\
+.		rm |o
+.		nr ?o 0
+.	\}
+.	nr dn \\n(_D
+.	rr _D
+.\}
+.rm |f
+.ch @r
+..
+.
+.de @c			\" --- new column
+.if \n@>2 .tm	>> @c %=\\n%
+.rs
+.sp |\\n(_ku
+.@O +\\n($lu+\\n($su
+.nr $c +1
+.@n
+..
+.
+.de @e			\" --- end page
+.if \n@>2 .tm	>> @e
+.@O \\n(_ou
+.rs
+.\" Move to footer position.
+.sp |\\n(.pu-\\n(fmu-((\\n(tpp*\\n(tvu)/100u)
+.@t $f\"			\" output footer title
+.nr ?h 0
+.bp
+..
+.
+.de @t			\" --- output header or footer title
+.if !\\n(?h \
+\{\
+.	sz \\n(tp\"		\" set header/footer type fonts, etc.
+.	@F \\n(tf
+.	lt \\n(_Lu		\" make title span entire page
+.	if \\n(?n \
+.		nm \\n(ln
+.	nf
+.	\\$1
+.	br
+.	if \\n(?n \
+.		nm
+.\}
+..
+.
+.de $h			\" $$$ print header
+.ds |z
+.if !\\n(?c \
+\{\
+.	if e .ds |z "\\*(|0
+.	if o .ds |z "\\*(|1
+.\}
+.if !\(ts\\*(|z\(ts\(ts \
+'	tl \\*(|z
+.rm |z
+..
+.
+.de $f			\" $$$ print footer
+.ds |z
+.if \\n(?c \
+\{\
+.	if e .ds |z "\\*(|0
+.	if o .ds |z "\\*(|1
+.\}
+.if \(ts\\*(|z\(ts\(ts \
+\{\
+.	if e .ds |z "\\*(|2
+.	if o .ds |z "\\*(|3
+.\}
+.if !\(ts\\*(|z\(ts\(ts \
+'	tl \\*(|z
+.rm |z
+..
+.
+.de @r			\" --- reprocess overflow footnotes
+.if \n@>3 .tm		>> @r .z=\\n(.z ?f=\\n(?f ?a=\\n(?a ?b=\\n(?b _b=\\n(_b
+.di |o				\" save overflow footnote
+.nr ?o 1
+.nr _D \\n(dn
+.ns
+..
+.
+.
+.\"		*** COMMANDS WITH VARIANT DEFINITIONS ***
+.
+.
+.ie '\*(.T'html' .ds @b \" empty
+.el              .rn bp @b	\" --- begin page
+.
+.de bp			\" *** begin new page (overrides columns)
+.nr $c \\n($m			\" force new page, not new column
+.ie \\n(nl>0 \
+.	@b \\$1
+.el \
+\{\
+.	if \\n(.$>0 \
+.		pn \\$1
+.	if \\n(?I \
+.		@h\"		\" 'spring' the header trap
+.\}
+.br
+.wh 0 @h			\" reset header
+..
+.
+.rn ll xl		\" *** special line length (local)
+.de ll
+.xl \\$1
+.lt \\$1
+.nr $l \\n(.l		\" *** line length (copied among ev 0, 1, and 2)
+.if (\\n($m<=1):(\\n($l>\\n(_L) \
+.	nr _L \\n(.l
+..
+.
+.rn po @O		\" --- local page offset
+.
+.de po			\" *** page offset
+.@O \\$1
+.if \\n(.o<0 \
+.	do @err page offset is negative (\\n(.ou)
+.nr _o \\n(.o
+..
+.
+.\" Redefine the groff fam request to set the family in
+.\" environment 2 as well as the current environment.
+.if !\n(.g .ig
+.do rn fam @fam		\" --- set family in current environment
+.do de fam		\" *** set font family in ev 2 and current ev
+.do @fam \\$1
+.ev 2
+.do @fam \\$1
+.ev
+..
+.
+.
+.\"		*** MISCELLANEOUS ROFF COMMANDS ***
+.
+.
+.de hx			\" *** suppress headers and footers next page
+.nr ?H 1
+..
+.
+.de ix			\" *** indent, no break
+'in \\$1
+..
+.
+.de bl			\" *** contiguous blank lines
+.br
+.@s \\$1
+.sp \\$1
+..
+.
+.de @s			\" --- diversion-surviving space test
+.ne \\$1
+.rs
+.if !'\\n(.z'' \!.@s \\$1
+..
+.
+.\" Even with the following facilities, this package's simulation of
+.\" roff(1) line numbering features does not exhibit complete fidelity
+.\" to that program's Unix V7 behavior.  roff(1) always increased the
+.\" page offset by 5n and set a three-digit line number, leaving _two_
+.\" spaces between the number and the start of unindented text.  This
+.\" package indents by \n(no instead.  Further, roff(1) did _not_ reduce
+.\" the line length to compensate for the increase in page offset.  GBR
+.\" presumes that the document author was expected to use an `ll`
+.\" request to perform that action if desired, but has no corpus of
+.\" idiomatic, line-numbered roff(1) documents to examine.
+.\"
+.de n1			\" *** line numbering 1
+.ie \\n(.$ \
+.	if '\\$1'C' \
+\{\
+.		nr ?N 1
+.		nr _l \\n(.l
+.		ll -\\n(nou
+.\}
+.if !\\n(?N \
+.	po -\\n(nou
+.nr ?n 1
+.do nr _#p \\n(.s
+.do nr _#f \\n(.f
+.nm 1
+..
+.
+.de n2			\" *** line numbering 2
+.nr _n \\n(ln-1\"	save last line number that may have been output
+.ie \\n(.$ \
+\{\
+.	do ie \\B`\\$1` \
+\{\
+.		ds |i \\$1
+.		ds |j \\$1
+.		nr |l 0
+.		\" Pick off leading char and rest to check.
+.		do substring |i 0 0  \"
+.		do length |l \\$1
+.		if \\n(|l>1 .do substring |j 1\"	\" for +N / -N
+.		ie `\\*(|i`+` \
+.			nr ln (\\n(_n)+\\*(|j
+.\" This file's brace style doesn't permit indentation of \{. --GBR
+.		el \
+\{\
+.			ie `\\*(|i`-` \
+.				nr ln (\\n(_n)-\\*(|j
+.			el \
+.				nr ln \\$1	\" unsigned N
+.		\}
+.		do nr _#p \\n(.s
+.		do nr _#f \\n(.f
+.		nm \\n(ln
+.		nr ?n 2
+.		rm |i |j
+.		rr |l
+.\}
+.	el \
+.		do @err invalid numeric argument to 'n2': '\\$1'
+.\}
+.el \
+\{\
+.	nm
+.	ie \\n(?N \
+\{\
+.		ll \\n(_lu
+.		rr _l
+.		nr ?N 0
+.\}
+.	el \
+.		po +\\n(nou
+.	nr ?n 0
+.	nr ln 0
+.\}
+.rr _n
+..
+.
+.de pa			\" *** new page
+.bp \\$1
+..
+.
+.de ro			\" *** roman page numbers
+.af % i
+..
+.
+.de ar			\" *** arabic page numbers
+.af % 1
+..
+.
+.de m1			\" *** position one space
+.nr _0 \\n(hmu
+.nr hm \\$1v
+.nr tm +\\n(hmu-\\n(_0u
+.rr _0
+..
+.
+.de m2			\" *** position two space
+.nr tm \\n(hmu+\\n(tpp+\\$1v
+..
+.
+.de m3			\" *** position three space
+.nr bm \\n(fmu+\\n(tpp+\\$1v
+..
+.
+.de m4			\" *** position four space
+.nr _0 \\n(fmu
+.nr fm \\$1v
+.nr bm +\\n(fmu-\\n(_0u
+..
+.
+.de sk			\" *** leave a blank page (next page)
+.if \\n(.$>0 \
+.	do @err ignoring argument(s) to 'sk'
+.nr ?s 1
+..
+.
+.
+.\"		*** MISCELLANEOUS USER SUPPORT COMMANDS ***
+.
+.
+.if !\n(.g .ig
+.de re		\" *** reset tabs (TROFF defines 15 stops default)
+.ta T 0.5i
+..
+.
+.if \n(.g .ig
+.de re
+.ta 0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i +0.5i
+..
+.
+.de ba			\" *** set base indent
+.ie \\n(.$ \
+.	nr $i \\$1n
+.el \
+.	nr $i \\n(siu*\\n($0u
+..
+.
+.de hl			\" *** draw horizontal line
+.br
+.if '\*(.T'html' \
+\{\
+.	HR
+.	do return
+.\}
+.ie \n(.g .do nr _I \\n.in
+.el .nr _I \\n(.i
+\l'\\n(.lu-\\n(_Iu'
+.sp
+..
+.
+.
+.\"		*** PARAGRAPHING ***
+.
+.
+.de pp			\" *** paragraph
+.lp \\n(piu
+..
+.
+.de lp			\" *** left aligned paragraph
+.@p
+.if \\n(.$ \
+.	ti +\\$1
+.nr $p 0 1
+..
+.
+.de ip			\" *** indented paragraph w/ optional tag
+.if (\\n(ii>0)&(\\n(ii<1n) \
+.	nr ii \\n(iin
+.nr _0 \\n(ii
+.if \\n(.$>1 \
+.	nr _0 \\$2n
+.@p \\n(_0u
+.nr _I \\n(.iu
+.in 0
+.nm
+.di |i
+\&\\$1
+.br
+.di
+.if \\n(?n \
+.	nm \\n(ln
+.in \\n(_Iu
+.ds |j \\*(|i\\
+.ie \\w"\\*(|j" \
+\{\
+.	ti -\\n(_0u
+.	ie \\w"\\*(|j">=\\n(_0 \
+\{\
+.		do DEVTAG-COL 1
+\\*(|j
+.		do DEVTAG-COL-NEXT 2
+.		br
+.	\}
+.	el \
+\{\
+.		do DEVTAG-COL 1
+\\*(|j\h'|\\n(_0u'\c
+.		do DEVTAG-COL 2
+.       \}
+.\}
+.el .do DEVTAG-COL 2
+.rr _0
+.rm |i |j
+..
+.
+.de np			\" *** numbered paragraph
+.\" use output comparison in case user has changed format of $p
+.if '\\n($p'-1' \
+.	nr $p 0			\" reset number after .bu
+.nr $p +1			\" increment paragraph number
+.@p \w'\0(000)\0'u
+.ti -\w'\0(000)\0'u
+\0(\\n($p)\h'|\w'\0(000)\0'u'\c
+..
+.
+.de bu			\" *** bulleted paragraph
+.br
+.\" use output comparison in case user has changed format of $p
+.if '\\n($p'-1' \
+.	ns			\" don't space between .bu paragraphs
+.nr $p 0-1			\" mark "bulleted paragraph" mode
+.@p \w'\0\(bu\0'u
+.ti -\w'\0\(bu\0'u
+\0\(bu\0\c
+..
+.
+.de @p			\" --- initialize for paragraph
+.do check_need_title
+.if "\\n(.z"|e" .do @err eqn equation continuation unfulfilled
+.in \\n($iu+\\n(pou
+.if \\n(.$ \
+.	in +\\$1n
+.ce 0
+.rj 0
+.fi
+.@F \\n(pf
+.sz \\n(pp
+.sp \\n(psu
+.ne \\n(.Lv+\\n(.Vu
+.ns
+..
+.
+.
+.\"		*** SECTION HEADINGS ***
+.
+.
+.de sh			\" *** section heading
+.fi
+.do check_need_title
+.if (\\n(si>0)&(\\n(si<1n) \
+.	nr si \\n(sin
+.if '\*(.T'html' .nr si 0
+.ce 0
+.if '\*(.T'html' \
+\{\
+.	do DEVTAG-SH \\$1
+.	do nr devtag-needs-end-of-heading 1
+.\}
+.@d "\\$1" +1 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
+.if !"\\$2"_" \
+\{\
+.	ds |n \&\\$2
+.	$p "\\*(|n" "\\*($n" \\n($0
+.	$0 "\\*(|n" "\\*($n" \\n($0
+.	rm |n
+.\}
+.nr $p 0 1			\" reset .np count
+..
+.
+.de @d			\" --- change section depth
+.if !""\\$1" \
+.	nr $0 \\$1
+.if \\n($0&(\\n(.$>1) \
+.	nr $\\n($0 \\$2
+.ds $n \&\"
+.ie \\n($0>=1 \
+\{\
+.	if '\\n($1'0' \
+.		nr $1 1
+.	if (\\n(.$>=3) .if !"\\$3"-" \
+.		nr $1 \\$3
+.	as $n \\n($1
+.\}
+.el \
+.	nr $1 0
+.ie \\n($0>=2 \
+\{\
+.	if '\\n($2'0' \
+.		nr $2 1
+.	if (\\n(.$>=4) .if !"\\$4"-" \
+.		nr $2 \\$4
+.	as $n .\\n($2
+.\}
+.el \
+.	nr $2 0
+.ie \\n($0>=3 \
+\{\
+.	if '\\n($3'0' \
+.		nr $3 1
+.	if (\\n(.$>=5) .if !"\\$5"-" \
+.		nr $3 \\$5
+.	as $n .\\n($3
+.\}
+.el \
+.	nr $3 0
+.ie \\n($0>=4 \
+\{\
+.	if '\\n($4'0' \
+.		nr $4 1
+.	if (\\n(.$>=6) .if !"\\$6"-" \
+.		nr $4 \\$6
+.	as $n .\\n($4
+.\}
+.el \
+.	nr $4 0
+.ie \\n($0>=5 \
+\{\
+.	if '\\n($5'0' \
+.		nr $5 1
+.	if (\\n(.$>=7) .if !"\\$7"-" \
+.		nr $5 \\$7
+.	as $n .\\n($5
+.\}
+.el \
+.	nr $5 0
+.ie \\n($0>=6 \
+\{\
+.	if '\\n($6'0' \
+.		nr $6 1
+.	if (\\n(.$>=8) .if !"\\$8"-" \
+.		nr $6 \\$8
+.	as $n .\\n($6
+.\}
+.el \
+.	nr $6 0
+..
+.
+.de sx			\" *** heading up, no increment (2.1.1 -> 2.1)
+.ce 0
+.ul 0
+.nr _0 \\n($0-1
+.if \\n(.$ .nr _0 +1
+.if \\n(.$ .nr _0 \\$1
+.@d \\n(_0
+.rr _0
+.$p "" "" \\n($0
+.nr $p 0 1			\" reset .np count
+..
+.
+.de uh			\" *** unnumbered section heading
+.$p "\\$1"
+.$0 "\\$1"
+..
+.
+.de $p			\" $$$ print section heading
+.if (\\n(si>0)&(\\n(.$>2) \
+.	nr $i \\$3*\\n(si
+.in \\n($iu
+.ie !"\\$1\\$2"" \
+\{\
+.	sp \\n(ssu 		\" one of them is non-null
+.	ne \\n(.Lv+\\n(.Vu+\\n(psu+((\\n(spp*\\n(tvu*\\n(.Lu)/100u)
+.	\" exdent if \\$3 > 0
+.	ie 0\\$3 \
+.		ti -(\\n(siu-\\n(sou)
+.	el \
+.		ti +\\n(sou
+.	@F \\n(sf
+.	sz \\n(sp
+.	if 0\\$3 \
+.		$\\$3
+.	if \w"\\$2">0 \\$2.
+.	if \w"\\$1">0 \\$1\f1\ \ \&
+.\}
+.el \
+.	sp \\n(psu
+.@F \\n(pf
+.sz \\n(pp
+..
+.
+.
+.\"		*** COLUMNED OUTPUT ***
+.
+.
+.de 2c			\" *** double columned output
+.do if d |f .do @err changing columnation with footnote pending
+.br
+.if \\n($m>1 \
+.	1c\"				\" revert to 1c if already 2c
+.nr $c 1
+.nr $m 2
+.if \\n(.$>1 \
+.	nr $m \\$2			\" param 2: column quantity
+.if \\n(.$>0 \
+.	if !'\\$1'' \
+.		nr $s \\$1n		\" param 1: column separation
+.nr $l (\\n(.l-((\\n($m-1)*\\n($s))/\\n($m
+.xl \\n($lu
+.mk _k
+.ns
+..
+.
+.de 1c			\" *** single columned output
+.do if d |f .do @err changing columnation with footnote pending
+.br
+.nr $c 1
+.nr $m 1
+.ll \\n(_Lu\"			return to normal output
+.sp |\\n(.hu
+.@O \\n(_ou
+..
+.
+.de bc			\" *** begin column
+.sp \\n(.pu
+..
+.
+.
+.\"		*** FLOATING TABLES AND NONFLOATING BLOCKS ***
+.
+.
+.de (z			\" *** begin floating keep
+.if \n@>4 .tm >> (z, .z=\n(.z
+.@D 4 \\$1 \\$2
+.@(
+..
+.
+.de )z			\" *** end floating keep
+.if \n@>4 .tm >> )z, .z=\n(.z
+.sp \\n(zsu
+.@)
+.if \n@>4 .tm -- )z << @), .z=\n(.z
+.rr _0
+.if !\\n(?b \
+.	nr dn +(\\n(ppp*\\n(tvu)/200u+\\n(zsu
+.nr dl -\n(.H		\" fudge factor necessary to make it work
+.ie ((\\n(dn+\n(.V)>=\\n(.t):(\\n(?a):((\\n(dl>\\n($l)&(\\n($c>1)) \
+\{\
+.	nr ?a 1
+.	if (\\n(dl>\\n($l)&(\\n($m>1) \
+.		nr ?w 1		\" mark wider than one column (top)
+.	ds |x |t
+.\}
+.el \
+\{\
+.	nr ?b 1
+.	if (\\n(dl>\\n($l)&(\\n($m>1) \
+.		nr ?W 1		\" mark wider than one column (bottom)
+.	nr _b +\\n(dnu
+.	\" avoid moving @f back past the current position
+.	if \\n(.p-\\n(nl-\n(.V<\\n(_b \
+.		nr _b \\n(.p-\\n(nl-\n(.V
+.	ch @f -\\n(_bu
+.	ds |x |b
+.\}
+.da \\*(|x			\" copy to save macro
+.nf
+.ls 1
+.nr ?k 1
+.if \n@>4 .tm -- )z >> \\*(|x
+\!.if \\\\n(nl>(\\\\n(tm+2v) .ne \\n(dnu-\\n(zsu
+.|k\"				\" and the body
+.if \n@>4 .tm -- )z << \\*(|x, .z=\\n(.z
+.nr ?k 0
+.rm |k\"			\" remove the temp macro
+.da
+.in 0
+.ls 1
+.xl \\n($lu
+.ev
+.if \n@>4 .tm << )z, .z=\\n(.z
+..
+.
+.de @k			\" --- output keep
+.if \n@>4 .tm >> @k, $1=\\$1, .z=\\n(.z
+.ev 1
+.nf
+.ls 1
+.in 0
+.if !`\\$2`ns` .sp \\n(zsu	\" no pre-spacing if (b .. )b
+.if \\n(?n \
+.	nm \\n(ln
+.\\$1
+.if \\n(?n \
+.	nm
+.br
+.rm \\$1
+.ev
+..
+.
+.de (t			\" XXX temp ref to (z
+.(z \\$1 \\$2
+..
+.
+.de )t			\" XXX temp ref to )t
+.)z \\$1 \\$2
+..
+.
+.de (b			\" *** begin block
+.br
+.@D 3 \\$1 \\$2
+.sp \\n(bsu
+.@(
+.if '\*(.T'html' .sp \\n(bsu
+..
+.
+.de )b			\" *** end block
+.br
+.@)
+.if (\\n(bt=0):(\\n(.t<\\n(bt) \
+.	ne \\n(dnu		\" make it all on one page
+.@k |k ns
+.ev                             \" return from display environment
+.sp \\n(bsu+\\n(.Lv-1v
+..
+.
+.de @(			\" --- begin keep
+.if !"\\n(.z"" .do @err invalid nested keep (\\n(.z)
+.@M
+.di |k
+\!'rs
+..
+.
+.de @M			\" --- set modes for display
+.nr ?k 1
+.@C 1
+.@F \\n(df
+.if \\n($R .@V
+.vs \\n(.sp*\\n(dvu/100u
+.nf
+.if "\\*(|p"F" \
+.	fi			\" set fill mode if "F" parameter
+.if \\n(_d=4 \
+.	in 0
+.if \\n(_d=3 \
+\{\
+.	in +\\n(biu
+.	xl -\\n(biu
+.\}
+.if \\n(_d=1 \
+.	ce 10000
+..
+.
+.de @)			\" --- end keep
+.br
+.if !"\\n(.z"|k" .do @err attempted close of never-opened keep
+.nr ?k 0
+.di
+.in 0
+.ce 0
+..
+.
+.de (c			\" *** begin block centered text
+.br
+.if "\\n(.z"|c" .do @err block centering calls cannot be nested
+.if \\n(?n .nm
+.if ``\\n(.z` \
+\{\
+.	@C 1\"		\" Ensure env. set up for centering in open text
+.	ev
+.\}
+.di |c
+..
+.
+.de )c			\" *** end block centered text
+.if !"\\n(.z"|c" .do @err unmatched block centering call
+.br				\" force out final line
+.di
+.if \n@>4 .tm >> .)c .l=\\n(.l .i=\\n(.i $i=\\n($i dl=\\n(dl
+.ev 1
+.ls 1
+.nr __ (\\n(.lu-\\n(.iu-\\n(dlu)/2u
+.if \\n(__u<0 .nr __ 0
+.in \\n(__u
+.rr __
+.if \n@>4 .tm -- .)c << .in .l=\\n(.l .i=\\n(.i dl=\\n(dl
+.if \\n(?n \
+.	nm \\n(ln
+.nf
+.|c
+.in
+.ls
+.if \\n(?n \
+.	nm
+.ev
+.rm |c
+.if \\n(?n \
+.	nm \\n(ln
+..
+.
+.
+.\"		*** BLOCK QUOTES (OR WHATEVER) AND LISTS ***
+.
+.
+.de (q			\" *** begin block quote
+.br
+.@C 1
+.fi
+.sp \\n(qsu
+.in +\\n(qiu
+.xl -\\n(qiu
+.sz \\n(qp
+.if \\n(?n \
+.	nm \\n(ln
+..
+.
+.de )q			\" *** end block quote
+.br
+.if \\n(?n \
+.	nm
+.ev
+.sp \\n(qsu+\\n(.Lv-1v
+.nr ?k 0
+..
+.
+.de (l			\" *** begin list
+.br
+.sp \\n(bsu
+.@D 3 \\$1 \\$2
+.@M
+.if \\n(?n \
+.	nm \\n(ln
+.if '\*(.T'html' .sp \\n(bsu
+..
+.
+.de )l			\" *** end list
+.\" XXX: Check for keep underflow here.
+.br
+.ev
+.if \\n(?n \
+.	nm \\n(ln
+.sp \\n(bsu+\\n(.Lv-1v
+.nr ?k 0
+..
+.
+.
+.\"		*** PREPROCESSOR SUPPORT ***
+.
+.
+.\"
+.\"	EQN
+.\"
+.de EQ			\" *** equation start
+.do if \\ndevtag-needs-end-of-heading .do DEVTAG-EO-H
+.do nr devtag-needs-end-of-heading 0
+.if "\*(.T"html" \
+\{\
+.	do nr e-EQ-ll \\n(.l
+.	ll 1000n
+.\}
+.do HTML-IMAGE
+.if !\\n(?e \
+\{\
+.	if "\\n(.z"|e" .do @err nested eqn equation start
+.	@D 1 "\\$1" "\\$2"
+.	@C 2
+.	di |e
+.\}
+.ls 1
+.in 0
+.nf
+..
+.
+.de EN			\" *** equation end
+.br
+.do HTML-IMAGE-END
+.if "\*(.T"html" \
+.	do ll \\ne-EQ-llu
+.ie "\\$1"C" \
+\{\
+.	nr ?e 1
+.	sp \\n(esu
+.\}
+.el \
+\{\
+.	nr ?e 0
+.	di
+.	if \\n(dn \
+.		@q\"		\" actual equation output
+.	rm |e
+.	ev
+.\}
+..
+.
+.de @q			\" --- equation output
+.nr _Q \\n(dnu
+.ev
+.sp \\n(esu			\" output rest of preceding text
+.if !"\\n(.z"" \!.ne \\n(_Qu
+.ne \\n(_Qu+\n(.Vu		\" keep it on one page
+.@C 2\"				\" .ev 2 may be jumbled from header
+.if \\n(_d=1 \
+.	in (\\n(.lu+\\n($iu-\\n(dlu)/2u
+.if \\n(_d=2 \
+.	in \\n($iu
+.if \\n(_d=3 \
+.	in \\n(biu+\\n($iu
+.if \\n(_d=4 \
+.	in 0
+.mk _q
+.if \n@>1 .tm --@q: _Q=\\n(_Q _q=\\n(_q nl=\\n(nl |p=\\*(|p
+.if !"\\*(|p"" \
+\{\
+.	rs
+.	sp (\\n(_Qu-\\n(.vu)/2u
+.	tl """\\*(|p"
+.	rt \\n(_qu
+.\}
+.if \\n(?n \
+.	nm \\n(ln
+.|e
+.if \\n(?n \
+.	nm
+.sp |\\n(_qu+\\n(_Qu
+.sp \\n(esu+\\n(.Lv-1v
+.rr _q
+.rr _Q
+..
+.
+.\"
+.\"	TBL
+.\"
+.de TS			\" *** table start
+.sp \\n(bsu
+.if "\*(.T"html" \
+\{\
+.	do nr e-TS-ll \\n(.l
+.	ll 1000n
+.\}
+.do HTML-IMAGE
+.@C 1
+.fi				\" drop into fill mode for text boxes
+.if "\\$1"H" \
+\{\
+.	di |h			\" save header part
+.	nr ?T 1
+.\}
+.ls 1
+.ch @f -(\\n(_bu+1v)		\" set pseudo-trap for bottom line
+.if \\n(.p-\\n(_b-1v<=\\n(nl \
+.	ch @f \\n(nlu+\n(.Vu
+..
+.
+.de TH			\" *** end header part of table
+.nr T. 0
+.T# 0
+.if \\n(?n \!.nm
+.di
+.nr _T \\n(?T
+.nr ?T 0
+.ne \\n(dnu+1v
+.nr ?T \\n(_T
+.nr _i \\n(.i
+.if \\n(?n .nm \\n(ln
+.in 0
+.|h\"				\" put in the initial header
+.in \\n(_iu
+.rr _i
+.mk #T
+..
+.
+.de TE			\" *** table end
+.nr ?T 0
+.ch @f -\\n(_bu			\" reset pseudo-trap
+.if \\n(.p-\\n(_b<=\\n(nl \
+.	ch @f \\n(nlu+\n(.Vu
+.ev
+.do HTML-IMAGE-END
+.if "\*(.T"html" \
+.	do ll \\ne-TS-llu
+.sp \\n(bsu+\\n(.Lv-1v
+.re
+..
+.
+.de T&
+..
+.
+.\"
+.\"	REFER
+.\"
+.do mso refer-me.tmac
+.
+.\"
+.\"	IDEAL
+.\"
+.de IS			\" *** start ideal picture
+.nr g7 \\n(.u
+.ls 1
+..
+.
+.de IF
+.if \\n(g7 .fi
+.ls
+..
+.
+.de IE			\" *** end ideal picture
+.if \\n(g7 .fi
+.ls
+..
+.
+.de && \" no-op so we can define and end one macro inside another
+..
+.
+.\"
+.\"	PIC
+.\"
+.de PS	\" *** start picture: $1=height, $2=width in units or inches
+.sp 0.3
+.do HTML-IMAGE
+.nr g7 \\$2
+.in (u;\\n(.l-\\n(g7>?0/2)
+.ne \\$1u
+.nr g7 \\n(.u
+.ls 1
+.ie \\n(?n \
+\{\
+.	do nr PS_nm_cnt 0
+.	do de PS_nm_check && \" define macro to emit .nm at top diversion
+.	if \n@>4 .tm -- PS: \\\\$1 \\\\$2 .z=\\\\n(.z PS_nm_cnt=\\\\nPS_nm_cnt
+.	\" Multiple .PS/.PE in a keep.
+.	if `\\\\$2`init` \
+.		do nr PS_nm_cnt \\\\nPS_nm_cnt+1
+.	ie `\\\\n(.z`` \
+\{\
+.		if `\\\\$1`suspend` \
+.			nm
+.		if `\\\\$1`resume` \
+\{\
+.			nm \\\\n(ln
+.			do nr PS_nm_cnt \\\\nPS_nm_cnt-1
+.			do if !\\\\nPS_nm_cnt \
+\{\
+.				do rm PS_nm_check
+.				do rr PS_nm_cnt
+.\}
+.\}
+.\}
+.el \!.PS_nm_check \\\\$1
+.	&&
+.	mk _q		\" emit a single numbered line for PS picture
+.	rs
+\&\ \" space
+.	br
+.	rt \\n(_qu
+.	do PS_nm_check suspend init
+.\}
+..
+.
+.rm &&
+.
+.de PF			\" *** end picture; "fly back" to top
+.if \\n(?n .do PS_nm_check resume
+.ls
+.in
+.if \\n(g7 .fi
+.do HTML-IMAGE-END
+..
+.
+.de PE			\" *** end picture
+.PF
+.sp .6
+..
+.
+.\"
+.\"	GREMLIN
+.\"
+.de GS			\" *** start gremlin picture
+.ie '\*(.T'html' \
+\{\
+.	ie "\\$1"L" .do HTML-IMAGE-LEFT
+.	el .ie "\\$1"R" .do HTML-IMAGE-RIGHT
+.	el .do HTML-IMAGE
+.\}
+.el \
+\{\
+.	nr g7 (\\n(.lu-\\n(g1u)/2u
+.	if "\\$1"L" .nr g7 \\n(.iu
+.	if "\\$1"R" .nr g7 \\n(.lu-\\n(g1u
+.	in \\n(g7u
+.	nr g7 \\n(.u
+.	ls 1
+.	nf
+.	ne \\n(g2u
+.\}
+..
+.
+.de GE			\" *** end gremlin picture
+.ie '\*(.T'html' .do HTML-IMAGE-END
+.el \
+\{\
+.	GF
+.	sp .6
+.\}
+..
+.
+.de GF			\" *** finish gremlin picture; stay at top
+.ls
+.in
+.if \\n(g7 .fi
+..
+.
+.
+.\"		*** FONT AIDS ***
+.
+.
+.de sz			\" *** set point size and vertical spacing
+.ps \\$1
+.if \\n($r .@v
+.vs \\n(.sp*\\n(tvu/100u	\" default vs at pointsize + 20%
+..
+.
+.de @v			\" --- possibly set tv from $r
+.if (1i>=240u)&(1p<=\\n($r)&(\\n($r<=4p) .nr tv \\n($r00/1p
+..
+.
+.de @V			\" --- possibly set dv from $R
+.if (1i>=240u)&(1p<=\\n($R)&(\\n($R<=4p) .nr dv \\n($R00/1p
+..
+.
+.de @E		\" --- store in _F argument to \f for restoring font
+.ie \\n(.f<10 \
+.	ds _F \\n(.f
+.el \
+\{\
+.	ie \\n(.f<100&\n(.g \
+.		ds _F (\\n(.f
+.	el \
+.		ds _F P
+.\}
+..
+.
+.de r			\" *** enter roman font
+.do check_need_title
+.@E
+.ft 1
+.if \\n(.$ \&\\$1\f\\*(_F\\$2
+.do check_need_title
+..
+.
+.de i			\" *** enter italic
+.do check_need_title
+.@E
+.ft 2
+.if \\n(.$ \&\,\\$1\/\f\\*(_F\\$2
+.do check_need_title
+..
+.
+.de b			\" *** enter boldface
+.do check_need_title
+.@E
+.ft 3
+.if \\n(.$ \&\\$1\f\\*(_F\\$2
+.do check_need_title
+..
+.
+.de rb			\" *** enter real boldface
+.do check_need_title
+.@E
+.ft 3
+.if \\n(.$ \&\\$1\f\\*(_F\\$2
+.do check_need_title
+..
+.
+.de bi			\" *** enter bold italic
+.do check_need_title
+.@E
+.ft 4
+.if \\n(.$ \&\,\\$1\/\f\\*(_F\\$2
+.do check_need_title
+..
+.
+.de u			\" *** enter underlined word
+.\" If the first argument would break, then (in troff mode), this
+.\" underlines only the words appearing only the last output line, with
+.\" the underline extending all the way into the left margin.
+.ie t \\$1\l'|0\(ul'\\$2
+.el \(ul\\$1\(ul\\$2
+..
+.
+.\" This alternative version of the `u` macro uses the groff \Z
+.\" extension to get the underlining to accurately fit under the words
+.\" at the expense of no longer adjusting them.  If the first argument
+.\" would break, the output line is overset.
+.if !\n(.g .ig
+.de u
+.ie t .do nop \Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'\\$2
+.el \(ul\\$1\(ul\\$2
+..
+.
+.de q			\" *** enter quoted word
+\&\\*(lq\\$1\\*(rq\\$2
+..
+.
+.de bx			\" *** enter boxed word
+.ie t \
+\{\
+.	ie '\\*(.T'html' \\$1\\$2
+.	el \k~\(br\|\\$1\|\(br\l'|\\n~u\(rn'\l'|\\n~u\(ul'\^\\$2
+.\}
+.el \
+\{\
+.	ie \\n(.g .do nop \mblack\Mwhite\Z'\\$1'\h'\w'\\$1'u'\
+\m\M\\$2
+.	el |\\$1|\\$2
+.\}
+..
+.
+.de sm			\" *** print in smaller font
+\s-1\\$1\\s+1\\$2
+..
+.
+.de @F			\" --- change font (0 -> no change)
+.nr ~ \\$1
+.if \\n~>0 \
+.	ft \\n~
+.rr ~
+..
+.
+.
+.\"		*** FOOTNOTING ***
+.
+.
+.de (f			\" *** begin footnote
+.if "\\n(.z"|f" .do @err footnotes cannot be nested
+.if \\n(_f \
+.	if !\\n(_f=\\n($m \
+.		do @err queueing \\n($m-column footnote after \
+\\n(_f-column footnote
+.nr _f \\n($m
+.ie "\\n(.z"" \
+\{\
+.	nr _D \\n(dn
+.	nr _0 1v+\\n(nlu
+.	ev 2
+.	nm
+.	da |f
+.	in 0
+.	xl \\n($lu-\\n(fuu
+.	@F \\n(ff
+.	sz \\n(fp
+.	vs \\n(.sp*\\n(dvu/100u
+.	if !\\n(?f \
+\{\
+.		nr _b +1v	\" allow space for $s
+.		$s
+.	\}
+.	br
+.	if \\n(.p-\\n(_b-\\n(_0-\\n(.h-1v-\\n(fs<0 \
+\{\
+.		da\"		\" won't fit on page at all
+.		bc
+.		if !\\n(?f \
+.			rm |f
+.		da |f
+.\" Next 5 lines could be dropped if headers had their own environment.
+.		in 0		\" reset everything from .bc
+.		xl \\n($lu-\\n(fuu
+.		@F \\n(ff
+.		sz \\n(fp
+.		vs \\n(.sp*\\n(dvu/100u
+.		if !\\n(?f \
+.			$s
+.		br
+.	\}
+.	rr _0
+.	sp \\n(fsu
+.	nr ?f 1
+.	fi
+.	if !"\\$1"_" \
+.		ti \\n(fiu
+.	if \n@>2 .tm	<< (f $f=\\n($f
+.\}
+.el \
+\{\
+.	ev 2
+.	nm
+.	in 0
+.	xl \\n($lu-\\n(fuu
+.	@F \\n(ff
+.	sz \\n(fp
+.	vs \\n(.sp*\\n(dvu/100u
+.	fi
+\!.(f \\$1
+\!.@N
+.\}
+..
+.
+.de @N		\" --- set no fill mode in the top-level diversion
+.ie "\\n(.z"" .nf
+.el \!.@N
+..
+.
+.de )f			\" *** end footnote
+.ie "\\n(.z"|f" \
+\{\
+.	if \\n* .nr $f +1
+.	nr * 0
+.	in 0
+.	da
+.	ev
+.	if \\n(_w<\\n(dl \
+.		nr _w \\n(dl	\" compute maximum fn width
+.	nr _b +\\n(dn
+.	ch @f -\\n(_bu
+.	if \\n(.p-\\n(_b<=\\n(nl \
+.		ch @f \\n(nlu+\n(.Vu
+.	nr dn \\n(_D
+.	rr _D
+.\}
+.el \
+\{\
+.	br
+\!.)f
+.	ev
+.\}
+..
+.
+.@R ff
+.if \n(ff<=0 \
+.	nr ff 1			\" footnote font: Times Roman
+.@R fp
+.if \n(fp<=0 \
+.	nr fp 8			\" footnote pointsize
+.
+.de $s			\" $$$ footnote separator
+.nr __ 2i
+.if \\n($lu<\\n(__u .nr __ \\n($lu
+\l'\\n(__u'
+.rr __
+..
+.
+.
+.\"		*** DELAYED TEXT ***
+.
+.
+.de (d			\" *** begin delayed text
+.am |d )d
+.sp \\n(bsu
+.vs \\n(.sp*\\n(dvu/100u
+..
+.
+.de )d			\" *** end delayed text
+.vs \\n(.sp*\\n(tvu/100u
+.nr $d +1
+..
+.
+.de pd			\" *** print delayed text
+.|d
+.rm |d
+.nr $d 1
+..
+.
+.
+.\"		*** INDEXES (TABLE OF CONTENTS) ***
+.
+.
+.nr _x 0 1
+.do nr _xn 0
+.af _x a
+.
+.de (x			\" *** begin index entry
+.if \n@>4 .tm >> (x, .z=\\n(.z
+.ds |X x
+.if \\n(.$>0 \
+.	ds |X \\$1
+.ie "\\n(.z"" \
+.	nr _z 0
+.el \
+.	nr _z 1
+.@\\n(_z
+..
+.
+.de @0			\" --- finish (x if no current diversion
+.am %\\*(|X )x
+.sp \\n(xsu
+.ti -\\n(piu
+..
+.
+.de @1			\" --- finish (x if current diversion
+.if "\\n(_x"z" .nr _x 0
+.de =\\n+(_x )x
+..
+.
+.de )x			\" *** end index entry
+.if \n@>4 .tm >> )x, .z=\\n(.z
+.ie "\\n(.z"" \
+\{\
+.	ds |x \\n%
+.	if \\n(.$>0 \
+.		ds |x \\$1
+.	if "\\*(|x"_" \
+.		ig ..
+.	am %\\*(|X ..
+.	if \w"\\$2">(\\n(.l-\\n(.i-\\n(.k) \
+.		ti +\\n(xuu
+\\\\a\\\\t\\$2\\*(|x
+...
+.	rm |x
+.	rm |X
+.\}
+.el \
+\{\
+\!.(x \\*(|X
+\!\\\\*(=\\n(_x\\\\
+\!.)x \\$1 \\$2
+\!.rm =\\n(_x
+.\}
+..
+.
+.de xp			\" *** print the index
+.br
+.@C 2
+.ls 1
+.vs \\n(.sp*\\n(dvu/100u
+.fi
+.in +\\n(piu
+.ds |X x
+.if \\n(.$>0 \
+.	ds |X \\$1
+.xl -(\\n(xuu+\w'...'u)
+.di |x
+.%\\*(|X
+.br
+.di
+.rm %\\*(|X
+.xl \\n($lu
+.rm |X
+.ev
+.nf
+.in 0
+.ta \\n(.lu-\\n(xuuR \\n(.luR
+.|x
+.fi
+.in
+.rm |x
+..
+.
+.
+.\"		*** HTML VERSIONS OF .x(, .x), AND .xp ***
+.
+.
+.do de1 (x-html    \" --- create TAG and divert text
+.nr _x +1
+.nr _xn +1
+.TAG "_x\\n_x
+.br
+.di |x\\n_xn
+.br
+..
+.
+.do de1 )x-html    \" --- end diversion
+.br
+.di
+..
+.
+.do de1 xp-html    \" --- create list of links
+.nr _xx 1
+.br
+.ev xp-html-ev
+.sp
+.ULS
+.while \\n_xx<=\\n_xn \
+\{\
+.	br
+.	unformat |x\\n_xx
+.	di xp-html-div
+.	br
+.	ll 100i
+.	fi
+.	|x\\n_xx
+.	br
+.	di
+.	asciify xp-html-div
+.	rm xp-html-as
+.	as xp-html-as #
+.	as xp-html-as _x\\n_xx
+.	ll
+.	LI
+.	URL \\*xp-html-as "\\*xp-html-div
+.	rm xp-html-as
+.	nr _xx +1
+.\}
+.ULE
+.sp
+.ev
+..
+.
+.if '\*(.T'html' \
+\{\
+.	rm (x
+.	do als (x (x-html
+.	rm )x
+.	do als )x )x-html
+.	rm xp
+.	do als xp xp-html
+.\}
+.
+.
+.\"		*** CHAPTERS AND TITLES ***
+.
+.
+.de +c				\" *** begin chapter
+.ep\"				\" force out footnotes
+.if \\n(?o:\\n(?a \
+\{\
+.	bp			\" force out a table or more footnote
+.	rs
+.	ep
+.\}
+.nr ?C 1
+.nr $f 1
+.if \\n(?R \
+.	pn 1
+.bp
+.in \\n($iu			\" reset the indent
+.rs
+.ie \\n(.$ \
+.	$c "\\$1"
+.el \
+.	sp 3
+..
+.
+.de ++			\" *** declare chapter type
+.nr _0 0
+.if "\\$1"C" \
+.	nr _0 1			\" chapter
+.if "\\$1"RC" \
+.	nr _0 11		\" renumbered chapter
+.if "\\$1"A" \
+.	nr _0 2			\" appendix
+.if "\\$1"RA" \
+.	nr _0 12		\" renumbered appendix
+.if "\\$1"P" \
+.	nr _0 3			\" preliminary material
+.if "\\$1"B" \
+.	nr _0 4			\" bibliographic material
+.if "\\$1"AB" \
+.	nr _0 5			\" abstract
+.if \\n(_0=0 \
+.	do @err invalid segment type to '++': '\\$1'
+.nr ?R 0
+.if \\n(_0>10 \
+\{\
+.	nr ?R 1
+.	nr _0 -10
+.\}
+.nr ch 0 1
+.if (\\n(_0=3):(\\n(_0=5) \
+.	pn 1			\" must do before .ep
+.if !\\n(_0=\\n(_M .if \\n(_M=3 \
+.	pn 1			\" must do before .ep
+.ep\"			\" end page for correct page number types
+.if \\n(_0=1 \
+\{\
+.	af ch 1
+.	af % 1
+.\}
+.if \\n(_0=2 \
+\{\
+.	af ch A
+.	af % 1
+.\}
+.if \\n(_0=3 \
+.	af % i
+.if \\n(_0=4 \
+.	af % 1
+.if \\n(_0=5 \
+.	af % 1
+.if \\n(.$>1 \
+.	he \\$2
+.nr _M \\n(_0
+.rr _0
+..
+.
+.de $c			\" $$$ print chapter title
+.sz 12
+.ft 3
+.ce 1000
+.if \\n(_M<3 \
+.	nr ch +1
+.ie \\n(_M=1 \\*(wc\~\\n(ch
+.el .if \\n(_M=2 \\*(wa\~\\n(ch
+.if \w"\\$1" .sp 3-\\n(.L
+.if \w"\\$1" \\$1
+.if (\\n(_M<3):(\w"\\$1") \
+.	sp 4-\\n(.L
+.ce 0
+.ft
+.sz
+.ie \\n(_M=1 \
+.	$C "\\*(wc" \\n(ch "\\$1"
+.el .if \\n(_M=2 \
+.	$C "\\*(wa" \\n(ch "\\$1"
+..
+.
+.de tp			\" *** title page
+.hx
+.bp
+.br
+.rs
+.pn \\n%
+..
+.
+.\"		*** DATE AND LOCALIZATION ***
+.ds wa Appendix\"
+.ds wc Chapter\"
+.do ds _mo1 January\"
+.do ds _mo2 February\"
+.do ds _mo3 March\"
+.do ds _mo4 April\"
+.do ds _mo5 May\"
+.do ds _mo6 June\"
+.do ds _mo7 July\"
+.do ds _mo8 August\"
+.do ds _mo9 September\"
+.do ds _mo10 October\"
+.do ds _mo11 November\"
+.do ds _mo12 December\"
+.do ds _dw1 Sunday\"
+.do ds _dw2 Monday\"
+.do ds _dw3 Tuesday\"
+.do ds _dw4 Wednesday\"
+.do ds _dw5 Thursday\"
+.do ds _dw6 Friday\"
+.do ds _dw7 Saturday\"
+.do ds _td_format \\*(mo \\n(dy, \\n(y4\"
+.
+.de ld			\" *** (re-)initialize date and localization
+.\" Work around troff `yr` register's y2k problem.
+.nr y2 \\n(yr%100
+.af y2 00
+.nr y4 \\n(yr+1900
+.
+.do ds dw \\*_dw\\n(dw
+.do ds mo \\*_mo\\n(mo
+.do ds td \\*_td_format
+.
+.\" Set package default hyphenation mode, but override it with groff's
+.\" localized value if available.
+.hy 6
+.do if r \\*locale*hyphenation-mode-trap \
+.  do hy \\n\\*locale*hyphenation-mode-trap
+..
+.
+.ld
+.
+.\"		*** PARAMETRIC INITIALIZATIONS ***
+.
+.
+.\" In groff 1.23, we keep $v and $V to maintain 30 years of continuity,
+.\" but expose new names `tv` and `dv`, respectively, making it more
+.\" obvious that user alteration of these register values is supported.
+.\" See discussion of `$R` and `$r` below.
+.nr tv \n(.v00+\n(.sp-1/\n(.sp	\" vs as % of ps for .sz request
+.nr dv \n(tv			\" same for displays & footnotes
+.do aln $v tv
+.do aln $V dv
+.nr hm 4v			\" header margin
+.nr tm 7v			\" top margin
+.nr bm 6v			\" bottom margin
+.nr fm 3v			\" footer margin
+.nr tf 3			\" title font: (real) Times Bold
+.nr tp 10			\" title point size
+.nr bi 4m			\" indent for blocks
+.nr pi 5n			\" indent for paragraphs
+.nr pf 1			\" normal text font
+.nr pp 10			\" normal text point size
+.nr qi 4n			\" indent for quotes
+.nr qp -1			\" down one point
+.nr ii 5n			\" indent for .ip's and .np's
+.nr $m 1			\" max number of columns
+.nr $s 4n			\" column separation
+.nr sf 3			\" section font -- Times Bold
+.nr sp 10			\" section title pointsize
+.nr ss 12p			\" section prespacing
+.nr si 0			\" section indent
+.nr sx 0.2m			\" super/subscript x-height adjustment
+.nr no \w'0000'u		\" offset for line numbers
+.
+.@R 0x\" set by GNU pic to _disable_ \x in super/scripting
+.
+.\"		*** OTHER INITIALIZATION ***
+.
+.\" Define strings for super- and subscripting.  groff me does not
+.\" bother with half-line motions in nroff mode, since we have no output
+.\" driver (for that mode) that supports them; consequently we don't
+.\" emit \x escape sequences in that case either.  If someone implements
+.\" a Model 37 or line printer emulator we can target, this decision
+.\" could be revisited.
+.\"
+.\" Adjust the line height with \x if the `0x` register is zero (a
+.\" pic(1) convention) by the amount in `sx` (a groff 1.23 extension).
+.ie t \
+\{\
+.ds { \v'-0.4m'\x'\\n(0x=0*-1u*\\n(sxu'\s-3
+.ds } \s+3\v'0.4m'
+.\}
+.el \
+\{\
+.ds { \"
+.ds } \"
+.\}
+.\" for compatibility with traditional -me
+.\" (the first will work only in compatibility mode)
+.ds  \*{
+.ds  \*}
+.ds @< <\"
+.ds @> >\"
+.if \n(.g \
+\{\
+.do if c \(la .ds @< \(la\"
+.do if c \(ra .ds @> \(ra\"
+.\}
+.ie t \
+\{\
+.ds < \v'0.4m'\x'\\n(0x=0*\\n(sxu'\s-3
+.ds > \s+3\v'-0.4m'
+.\}
+.el \
+\{\
+.ds < \*(@<
+.ds > \*(@>
+.\}
+.ds - \(em
+.\" Avoid warnings from groff -ww.
+.@S |0
+.@S |1
+.@S |2
+.@S |3
+.@S $C
+.@S $H
+.@S $0
+.@S $1
+.@S $2
+.@S $3
+.@S $4
+.@S $5
+.@S $6
+.@S $7
+.@S $8
+.@S $9
+.@S ..
+.
+.@R po\"		\" simulated page offset
+.@R $0\"		\" section depth
+.@R $1\"		\" section numbers a.b.c.d.e.f
+.@R $2\"
+.@R $3\"
+.@R $4\"
+.@R $5\"
+.@R $6\"
+.@R $i\"		\" paragraph base indent
+.@R $p\"		\" numbered paragraph number
+.\" Before groff 1.06 the groff -me macros treated the $r and $R
+.\" number registers in a way that was incompatible with the BSD -me
+.\" macros.  The reason for this was that the approach used by the BSD
+.\" -me macros does not work with low resolution devices such as -TX75
+.\" and -TX100.  However, this caused problems with existing -me
+.\" documents.  In groff 1.06, the vertical spacing is controlled by
+.\" the $v and $V registers which have the same meaning as $r and $R in
+.\" earlier groff releases.  In addition, if the $r or $R register is
+.\" set to a value that would be correct for the BSD -me macros and a
+.\" low resolution device is not being used, then an appropriate value
+.\" for the $v or $V register is derived from the $r or $R register.
+.\"
+.\" Thirty years later, we rename `$v` to `tv` and `$V` to `dv`.
+.@R $r\"		\" ratio of vs to ps (may override tv)
+.@R $R\"		\" same for displays (may override dv)
+.@R df\"		\" display font: same as surrounding text
+.@R so\"		\" additional section title offset
+.@R fu\"		\" footnote undent
+.@R bt\"		\" block keep threshold
+.@R *\"			\" has \** been referenced?
+.@R ?a\"		\" pending floating keep at page top?
+.@R ?b\"		\" pending floating keep at page bottom?
+.@R ?C\"		\" at chapter header?
+.@R ?e\"		\" in equation?
+.@R ?f\"		\" inside footnote?
+.@R _f\"		\" column count of previous footnote
+.@R ?H\"		\" suppress headers and footers next page?
+.@R ?I\"		\" has the header trap been sprung?
+.@R ?N\"		\" numbering with shorter line length?
+.@R ?n\"		\" n1 mode?
+.@R ?o\"		\" footnote overflow?
+.@R ?R\"		\" renumbered chapter?
+.@R ?s\"		\" skip next page?
+.@R ?T\"		\" inside .TS H?
+.@R ?W\"		\" wide floating keep at page bottom?
+.@R ?w\"		\" wide floating keep at page top?
+.
+.nr fi 0.3i
+.nr _o \n(.o
+.nr $b 3			\" bold
+.nr ps 0.35v
+.if \n(ps<\n(.V .nr ps \n(.V
+.nr bs \n(ps			\" block pre/post spacing
+.nr qs \n(ps			\" quote pre/post spacing
+.nr zs 1v			\" float-block pre/postspacing
+.nr xs 0.2v			\" index prespacing
+.nr xu 0.5i			\" index undent
+.nr fs 0.2v			\" footnote prespacing
+.nr es 0.5v			\" equation pre/postspacing
+.if \n(es<\n(.V .nr es \n(.V
+.wh 0 @h			\" set header
+.nr $l \n(.lu			\" line length (of column)
+.nr _L \n(.lu			\" line length of page
+.nr $c 1			\" current column number
+.nr $f 1			\" footnote number
+.ds * \\*{\\n($f\\*}\k*\"	\" footnote mark
+.nr $d 1			\" delayed text number
+.ds # \\n($d\"		\" delayed text mark
+.nr _M 1			\" encoded document segment type
+.ds lq \(lq\"			\" left quote
+.ds rq \(rq\"			\" right quote
+.em @z
+.
+.\" Set line length and get .lt side effect.
+.if t .ll \n(_Lu
+.if n .ll 6.0i
+.
+.\"		*** FOREIGN LETTERS AND SPECIAL CHARACTERS ***
+.
+.
+.ds #h ((1u-(\\\\n(.fu%2u))*0.13m)
+.ds #v 0.6m
+.
+.\"			\" accents
+.ds ' \h'0'\k_\h'-(\\n(.wu*8/10-\*(#h)'\(aa\h'|\\n_u'
+.ds ` \h'0'\k_\h'-(\\n(.wu*7/10-\*(#h)'\(ga\h'|\\n_u'
+.
+.\"			\" umlaut
+.ds : \h'0'\k_\h'-(\\n(.wu*8/10-\*(#h+0.1m)'\v'-\*(#v'\z.\h'0.2m'.\h'|\\n_u'\v'\*(#v'
+.
+.\"			\" circumflex and tilde
+.ds ^ \h'0'\k_\h'-(\\n(.wu-\*(#h-0.05m)'^\h'|\\n_u'
+.ds ~ \h'0'\k_\h'-(\\n(.wu-\*(#h-0.05m)'~\h'|\\n_u'
+.
+.\"			\" cedilla and czech
+.ds , \h'0'\k_\h'-(\\n(.wu)',\h'|\\n_u'
+.ds v \h'0'\k_\h'-(\\n(.wu*9/10-\*(#h)'\v'-\*(#v'\s-4v\s0\v'\*(#v'\h'|\\n_u'
+.
+.\"			\" Norwegian A or angstrom
+.ds o \h'0'\k_\h'-(\\n(.wu+\w'\(de'u-\*(#h)/2u'\v'-0.4n'\z\(de\v'0.4n'\h'|\\n_u'
+.
+.\"			\" there exists, for all
+.ds qe \s-2\v'0.45m'\z\(em\v'-0.625m'\z\(em\v'-0.625m'\(em\v'0.8m'\s0\h'-0.1m'\v'-0.05m'\(br\v'0.05m'\h'0.1m'
+.ds qa \z\e\h'0.35m'\z\(sl\h'-0.33m'\v'-0.3m'\s-4\(em\s0\v'0.3m'\h'0.15m'
+.rm #h #v
+.
+.de @U
+.do @err the '\\$1' macro is not supported by this version of 'me'
+..
+.
+.de lo
+.@U lo
+..
+.
+.de th
+.@U th
+..
+.
+.de ac
+.@U ac
+..
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=nroff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/ec.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/ec.tmac Changed

_service:tar_scm:groff-1.23.0.tar.gz/tmac/en.tmac Added

@@ -0,0 +1,77 @@
+.\" English localization for groff
+.\"
+.\" Copyright (C) 2021-2022 Free Software Foundation, Inc.
+.\"   Written by G. Branden Robinson <g.branden.robinson.@gmail.com>
+.\"
+.\" 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
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" 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 this program.  If not, see
+.\" <http://www.gnu.org/licenses/>.
+.\"
+.\" Please send comments to groff@gnu.org.
+.
+.do nr *groff_en_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
+.
+.
+.ds locale english\"
+.
+.ss 12
+.
+.\" Set up hyphenation.
+.
+.\" English hyphenation (\lefthyphenmin=2, \righthyphenmin=3)
+.nr \*locale*hyphenation-mode-base 4
+.nr \*locale*hyphenation-mode-trap 6
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
+.
+.hla en
+.hpf hyphen.en
+.hpfa hyphenex.en
+.
+.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \\*(mo \\n(dy, \\n(y4\"
+.	ld
+.\}
+.
+.
+.cp \n*groff_en_tmac_C
+.do rr *groff_en_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/eqnrc -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/eqnrc Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/europs.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/europs.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/fallbacks.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/fallbacks.tmac Changed

@@ -1,13 +1,26 @@
-.\" -*- nroff -*-
+.\" Define device-independent fallbacks for unavailable glyphs.
 .\"
-.\" fallbacks.tmac
-.\"
-.\" This file contains generic fallback characters.
+.\" These are designed such that "troffrc" loads them early, after
+.\" composite glyph setup but before any device-specific fallbacks.
+.\" Macro files specific to an output device can therefore override the
+.\" definitions below as necessary.
 .
-.nr _C \n(.C
+.do nr *groff_fallbacks_tmac_C \n.cp
 .cp 0
 .
-.\" fall back to GREEK CAPITAL LETTER DELTA for INCREMENT
+.\" The early loading observation above also means that the conditional
+.\" expressions 'n' and 't' are not reliable.  Define ersatz substitute.
+.nr fallbacks*troff-mode 1
+.if '\*.T'ascii'  .nr fallbacks*troff-mode 0
+.if '\*.T'cp1047' .nr fallbacks*troff-mode 0
+.if '\*.T'latin1' .nr fallbacks*troff-mode 0
+.if '\*.T'utf8'   .nr fallbacks*troff-mode 0
+.
+.\" MODIFIER LETTER CIRCUMFLEX ACCENT -> CIRCUMFLEX ACCENT
+.fchar \u02C6 ^
+.\" SMALL TILDE -> TILDE
+.fchar \u02DC ~
+.\" INCREMENT -> GREEK CAPITAL LETTER DELTA
 .fchar \u2206 \u0394
 .
 .
@@ -62,6 +75,140 @@
 .fchar \u217e d
 .fchar \u217f m
 .
-.cp \n_C
+.\" Fonts often lack precomposed glyphs for accented Latin letters that
+.\" were not defined in ISO 8859-1 (Latin-1).
+.\"
+.\" Some of these can be ugly; on typesetter devices, much depends on
+.\" the design of the fonts used.
+.\"
+.\" groff defines no dot-above accent so we cannot construct some
+.\" composite glyphs in this way.  Turkish is an especial challenge
+.\" because dotting an I (or not) results in a different base glyph.
+.\" In any case, dotless 'i' base glyphs are rare in old fonts.
+.\"
+.\" Latin-2 fallbacks
+.fchar \A ab \z\abA
+.fchar \A ho \z\hoA
+.fchar \C aa \z\aaC
+.fchar \C ah \z\ahC
+.fchar \D ah \z\ahD
+.fchar \u110 \z-D\" capital letter d with stroke
+.fchar \E ah \z\ahE
+.fchar \E ho \z\hoE
+.fchar \/L   \z/L
+.fchar \L aa \z\aaL
+.fchar \L ho \z\hoL
+.fchar \N aa \z\aaN
+.fchar \N ah \z\ahN
+.fchar \O a" \z\a"O
+.fchar \R aa \z\aaR
+.fchar \R ah \z\ahR
+.fchar \S aa \z\aaS
+.fchar \S ac \z\acS
+.fchar \vS   \z\ahS
+.fchar \T ac \z\acT
+.fchar \T ah \z\ahT
+.fchar \U ao \z\aoU
+.fchar \U a" \z\a"U
+.fchar \Z aa \z\aaZ
+.fchar \Z a. \z\a.Z
+.fchar \vZ   \z\ahZ
+.
+.fchar \a ab \z\aba
+.fchar \a ho \z\hoa
+.fchar \c aa \z\aac
+.fchar \c ah \z\ahc
+.fchar \d ah \z\ahd
+.fchar \u110 \z-d\" small letter d with stroke
+.fchar \e ah \z\ahe
+.fchar \e ho \z\hoe
+.fchar \/l   \z/l
+.fchar \l aa \z\aal
+.fchar \l ho \z\hol
+.fchar \n aa \z\aan
+.fchar \n ah \z\ahn
+.fchar \o a" \z\a"o
+.fchar \r aa \z\aar
+.fchar \r ah \z\ahr
+.fchar \s aa \z\aas
+.fchar \s ac \z\acs
+.fchar \vs   \z\ahs
+.fchar \t ac \z\act
+.fchar \t ah \z\aht
+.fchar \u ao \z\aou
+.fchar \u a" \z\a"u
+.fchar \z aa \z\aaz
+.fchar \z a. \z\a.z
+.fchar \vz   \z\ahz
+.
+.\" Latin-5 fallbacks
+.fchar \G ab \z\abG
+.fchar \g ab \z\abg
+.
+.\" Latin-9 fallbacks
+.fchar \OE OE
+.fchar \oe oe
+.fchar \:Y \z\adY
+.
+.fchar \u2000 \u2002\" en quad
+.fchar \u2001 \u2003\" em quad
+.fchar \u2002 \h'1/2u'\" en space
+.fchar \u2003 \h'1'\" em space
+.fchar \u2004 \h'1/3u'\" three-per-em space
+.fchar \u2005 \h'1/4u'\" four-per-em space
+.fchar \u2006 \h'1/6u'\" six-per-em space
+.fchar \u2007 \0\" figure space
+.fchar \u2008 \^\" punctuation space
+.fchar \u2009 \|\" thin space
+.fchar \u200A \^\" hair space
+.\" Mapping U+200B awaits resolution of Savannah #58958.
+.\"fchar \u200B \h'0'\" zero-width space
+.\" \u2010 is always defined thanks to uniglyph.cpp.
+.\"fchar \u2010 -\:\" hyphen
+.\" Mapping U+2011 awaits resolution of Savannah #63354.
+.\"fchar \u2011 -\" non-breaking hyphen (won't break w/o .hcode or \:)
+.ie \nfallbacks*troff-mode \
+.  fchar \u2012 \^\v'-.3m'\l'\w"\0"u'\v'+.3m'\^\" figure dash
+.el \
+.  fchar \u2012 \-
+.fchar \u2013 \en\" en dash
+.fchar \u2014 \em\" em dash
+.fchar \u2015 \em\" horizontal bar (quotation dash)
+.fchar \u2016 \ba\ba\" double vertical line (matrix norm)
+.if \nfallbacks*troff-mode \
+.  fchar \u2017 \Z'\ul'\v'+.1m'\ul\v'-.1m'\" double low line
+.\" Mapping U+20189CD awaits resolution of Savannah #59932.
+.\"fchar \u2018 \oq\" left single quotation mark
+.\"fchar \u2019 \cq\" right single quotation mark
+.\"fchar \u201C \lq\" left double quotation mark
+.\"fchar \u201D \rq\" right double quotation mark
+.\" XXX: The next two are troublesome; see Savannah #63332.
+.\"fchar \u2020 \dg\" dagger
+.\"fchar \u2021 \dd\" double dagger
+.fchar \u2022 \bu\" bullet
+.fchar \u2024 .\" one dot leader
+.fchar \u2025 .\|.\" two dot leader
+.fchar \u2026 .\|.\|.\" horizontal ellipsis
+.fchar \u2027 \pc\" hyphenation point
+.\"fchar \u2030 \%0\" per mille sign \" Savannah #63332 again
+.fchar \u2032 \fm\" prime
+.fchar \u2033 \sd\" double prime
+.fchar \u2039 \fo\" left single chevron
+.fchar \u203A \fc\" right single chevron
+.if \nfallbacks*troff-mode \
+.  fchar \u203D \o'?!'\" interrobang
+.\"fchar \u203E \rn\" overline \" Savannah #63332 again
+.fchar \u2044 \f/\" fraction slash
+.fchar \u2052 %\" commercial minus sign
+.fchar \u2053 \ti\" swung dash
+.
+.rr fallbacks*troff-mode
+.
+.cp \n*groff_fallbacks_tmac_C
+.do rr *groff_fallbacks_tmac_C
 .
-.\" EOF
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/fr.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/fr.tmac Changed

@@ -1,6 +1,6 @@
 .\" French localization for groff
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2022 Free Software Foundation, Inc.
 .\"   Written by Fabrice Ménard (menard.fabrice@wanadoo.fr)
 .\"
 .\" This file is part of groff.
@@ -21,8 +21,17 @@
 .\"
 .\" Please send comments to menard.fabrice@wanadoo.fr.
 .
+.do nr *groff_fr_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
 .
-.\" Locale string
 .
 .ds locale french\"
 .
@@ -31,6 +40,7 @@
 .
 .ds \*locale-abstract R\E 'SUM\E '\"
 .ds \*locale-app ANNEXE\"
+.ds \*locale-appendix_string Annexe\"
 .ds \*locale-april Avril\"
 .ds \*locale-attribute_string par\"
 .ds \*locale-august Ao\u ^t\"
@@ -78,6 +88,15 @@
 .ds \*locale-litb Tableau\"
 .ds \*locale-lt LISTE DES TABLEAUX\"
 .ds \*locale-lx LISTE DES DOCUMENTS\"
+.ds \*locale-man-section1 Manuel des commandes générales\"
+.ds \*locale-man-section2 Manuel des appels système\"
+.ds \*locale-man-section3 Manuel des fonctions de la bibliothèque\"
+.ds \*locale-man-section4 Manuel des interfaces du noyau\"
+.ds \*locale-man-section5 Manuel des formats de fichiers\"
+.ds \*locale-man-section6 Manuel des jeux\"
+.ds \*locale-man-section7 Manuel d'informations diverses\"
+.ds \*locale-man-section8 Manuel du gestionnaire de système\"
+.ds \*locale-man-section9 Manuel du développeur de noyau\"
 .ds \*locale-march Mars\"
 .ds \*locale-may Mai\"
 .ds \*locale-monday Lundi\"
@@ -108,7 +127,7 @@
 .	\" update the date
 .	ds DY \ndy \*MO \nyear
 .	\" set hyphenation flags
-.	nr HY 4
+.	nr HY 6
 .\}
 .
 .
@@ -133,41 +152,24 @@
 .\}
 .
 .
-.\" me package
-.if d @R \{\
-.	\" date update
-.	ds td \n(dy \*(mo \n(y4
-.	\" Redefinition for the chapter system
-.	de $c
-.	sz 12
-.	ft 3
-.	ce 1000
-.	if \\n(_M<3 \
-.	nr ch +1
-.	ie \\n(_M=1 CHAPITRE\ \ \\n(ch
-.	el .if \\n(_M=2 ANNEXE\ \ \\n(ch
-.	if \w"\\$1" .sp 3-\\n(.L
-.	if \w"\\$1" \\$1
-.	if (\\n(_M<3):(\w"\\$1") \
-.	sp 4-\\n(.L
-.	ce 0
-.	ft
-.	sz
-.	ie \\n(_M=1 \
-.	$C Chapitre \\n(ch "\\$1"
-.	el .if \\n(_M=2 \
-.	$C Annexe \\n(ch "\\$1"
-..
-.\}
-.
-.
 .\" Default encoding
 .mso latin9.tmac
 .
+.ss 12 0
+.
+.\" Set up hyphenation.
 .
 .\" French hyphenation (\lefthyphenmin=2, \righthyphenmin=3)
-.ss 12 0
-.hy 4
+.nr \*locale*hyphenation-mode-base 4
+.nr \*locale*hyphenation-mode-trap 6
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
+.
 .hcode à à  À à
 .hcode â â  Â â
 .hcode ç ç  Ç ç
@@ -188,16 +190,24 @@
 .hpf hyphen.fr
 .
 .
-.\" man, mdoc and mdoc-old are intentionally left untouched: usually
-.\" these packages are translated in the sources of the documents.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \En(dy \E*(mo \En(y4
+.	ld
+.\}
+.
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_fr_tmac_C
+.do rr *groff_fr_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff
 .\" coding: latin-9
 .\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff textwidth=72:
+.\" vim: set fileencoding=iso-8859-15 filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_man.7.man.in Added

@@ -0,0 +1,4287 @@
+divert(-1)
+Note to maintainers of this document: while it is desirable to bracket
+material that differs between groff_man(7) and groff_man_style(7) as
+tightly as possible to honor the Don't Repeat Yourself principle, in
+GBR's opinion this maxim has limits.
+
+Consider this ghastly example:
+
+If no scaling unit is given,
+the
+.I man
+package assumes \(lqn\(rq\c
+_ifstyle()dnl
+; that is,
+approximately the width of the letter \(lqn\(rq in the font current when
+the macro is called
+(see section \(lqMeasurements\(rq in
+.MR groff @MAN7EXT@ )\c
+_endif()dnl
+\&.
+
+These man pages serve multiple goals, one of which is to serve as a
+model for good man page writing by people who examine their sources.
+
+After processing by m4, both child pages in the above case will carry \c
+escape sequences followed by text lines starting with punctuation one
+normally does not find in that position (and in the case of the period,
+which has to be protected from interpretation as a control line).
+
+This is ugly, fragile, and unnecessary; all of these traits are
+offensive to good pedagogy.
+
+Consequently, it is better to repeat a small amount of material than
+write a man page that looks like the output of docbook-to-man.
+
+define(`_ifstyle',`ifdef(`_groff_man_style',,`divert(-1)')')
+define(`_ifnotstyle',`ifdef(`_groff_man_style',`divert(-1)')')
+define(`_endif',`divert`'')
+divert`'dnl
+'\" t
+.\" This page is generated by m4 from tmac/groff_man.7.man.in.
+_ifnotstyle()dnl
+.TH groff_man @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+_endif()dnl
+_ifstyle()dnl
+.TH groff_man_style @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+_endif()dnl
+.SH Name
+_ifnotstyle()dnl
+groff_man \- compose manual pages with GNU
+.I roff
+_endif()dnl
+_ifstyle()dnl
+groff_man_style \- GNU
+.I roff
+man page tutorial and style guide
+_endif()dnl
+.
+.
+.\" ====================================================================
+.\" Legal Terms
+.\" ====================================================================
+.\"
+.\" Copyright (C) 1999-2018, 2020-2021 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.
+.\"
+.\" 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.
+.\"
+.\" 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.
+.
+.
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_man_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
+.\" ====================================================================
+.SH Synopsis
+.\" ====================================================================
+.
+.SY "groff \-man"
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
+.SY "groff \-m man"
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.\" ====================================================================
+.SH Description
+.\" ====================================================================
+.
+The GNU implementation of the
+.I man
+macro package is part of the
+.I groff
+document formatting system.
+.
+It is used to produce manual pages
+.\" We use an unbreakable space \~ here to keep the phrase intact for
+.\" its introduction; in subsequent discussion, that is not important.
+(\(lqman\~pages\(rq)
+like the one you are reading.
+.
+.
+.P
+This document presents the macros thematically;
+for those needing only a quick reference,
+the following table lists them alphabetically,
+with cross references to appropriate subsections below.
+.
+.
+_ifnotstyle()dnl
+.P
+Man page authors and maintainers who are not already experienced
+.I groff
+users should consult
+.MR groff_man_style @MAN7EXT@ ,
+an expanded version of this document,
+for additional explanations and advice.
+.
+It covers only those concepts required for man page document
+maintenance,
+and not the full breadth of the
+.I groff
+typesetting system.
+.
+.
+_endif()dnl
+.P
+.TS
+l l l.
+Macro	Meaning	Subsection
+.T&
+lB l l.
+_
+\&.B	Bold	Font style macros
+\&.BI	Bold, italic alternating	Font style macros
+\&.BR	Bold, roman alternating	Font style macros
+\&.EE	Example end	Document structure macros
+\&.EX	Example begin	Document structure macros
+\&.I	Italic	Font style macros
+\&.IB	Italic, bold alternating	Font style macros
+\&.IP	Indented paragraph	Paragraphing macros
+\&.IR	Italic, roman alternating	Font style macros
+\&.LP	Begin paragraph	Paragraphing macros
+\&.ME	Mail-to end	Hyperlink macros
+\&.MR	Man page cross reference	Hyperlink macros
+\&.MT	Mail-to start	Hyperlink macros
+\&.P	Begin paragraph	Paragraphing macros
+\&.PP	Begin paragraph	Paragraphing macros
+\&.RB	Roman, bold alternating	Font style macros
+\&.RE	Relative inset end	Document structure macros
+\&.RI	Roman, italic alternating	Font style macros
+\&.RS	Relative inset start	Document structure macros
+\&.SB	Small bold	Font style macros
+\&.SH	Section heading	Document structure macros
+\&.SM	Small	Font style macros
+\&.SS	Subsection heading	Document structure macros
+\&.SY	Synopsis start	Command synopsis macros
+\&.TH	Title heading	Document structure macros
+\&.TP	Tagged paragraph	Paragraphing macros
+\&.TQ	Supplemental paragraph tag	Paragraphing macros
+\&.UE	URI end	Hyperlink macros
+\&.UR	URI start	Hyperlink macros
+\&.YS	Synopsis end	Command synopsis macros
+.TE
+.
+.
+.P
+We discuss other macros
+.RB ( .AT ,
+.BR .DT ,
+.BR .HP ,
+.BR .OP ,
+.BR .PD ,
+and
+.BR .UC )
+in subsection \(lqDeprecated features\(rq below.
+.
+.
+.P
+Throughout Unix documentation,
+a manual entry is referred to simply as a \(lqman page\(rq,
+regardless of its length,
+without gendered implication,
+and irrespective of the macro package selected for its composition.
+_ifstyle()dnl
+.
+.
+.\" ====================================================================
+.\" .SS "Input file format"
+.\" ====================================================================
+.P
+Man pages should be encoded using Unicode basic Latin code points
+exclusively,
+and employ the Unix line-ending convention
+(U+000A only).
+.\" What about rare English words that require diacritics, and
+.\" proper names that require more than basic Latin?
+.\"
+.\" sentence (including end-of-sentence detection)
+.\" The above distinction works well with filling.
+.\" Don't fill your input text yourself; let groff do the work.
+.\" Also good for diffs.
+.\" escape sequences--pretty much just "see Portability"
+.
+.\" ====================================================================
+.SS "Fundamental concepts"
+.\" ====================================================================
+.\" font (family, style elsewhere known as face)
+.\" type size
+.\" typesetter (troff device, PostScript, PDF)
+.\" terminal (nroff device, emulator, typewriter, TTY)
+.I groff
+is a programming system for typesetting:
+we thus often use the verb \(lqto set\(rq in the sense
+\(lqto typeset\(rq.
+.
+The formatter
+.MR @g@troff @MAN1EXT@
+collects words from the input and
+.I fills
+output lines with as many as will fit.
+.
+.I Words
+are separated by spaces and newlines.
+.\" Also tabs and leaders, but let's not discuss those in man(7).
+.
+A transition to a new output line is called a
+.I break.
+.
+When formatted,
+a word may be broken at hyphens,
+at
+.B \e%
+or
+.B \e:
+escape sequences
+(see subsection \(lqPortability\(rq below),
+or at predetermined locations
+if automatic hyphenation is enabled
+(see the
+.B \-rHY
+option in section \(lqOptions\(rq below).
+.
+An output line may be supplemented with
+.I inter-sentence space,
+and then optionally
+.I adjusted
+with more space to a consistent line length
+(see the
+.B \-dAD
+option).
+.
+.MR roff @MAN7EXT@
+details these processes.
+.
+.
+.P
+An input line that starts with a dot (.\&)
+or neutral apostrophe (\(aq)
+is a
+.I control line.
+.
+To call a macro,
+put its name after a dot on a control line.
+.\" You never need to indent macro calls in man(7), or call them with
+.\" the no-break control character.
+.
+We refer to macros in this document using this leading dot.
+.
+Some macros interpret
+.I arguments,
+words that follow the macro name.
+.
+A newline,
+unless escaped
+(see subsection \(lqPortability\(rq below),
+marks the end of the macro call.
+.
+An input line consisting of a dot followed by a newline
+is called the
+.I empty request;
+it does nothing.
+.
+.I Text lines
+are input lines that are not control lines.
+.
+.
+.P
+We describe below several
+.I man
+macros that plant one-line
+.I input traps:
+the next input line that directly produces formatted output is treated
+specially.
+.
+For
+.I man
+documents that follow the advice in section
+\lqPortability\rq below,
+this means that control lines using the empty request
+and uncommented input lines ending with an escaped newline
+do not spring the trap;
+anything else does
+(but see the
+.B .TP
+macro description).
+.
+.
+.\" ====================================================================
+.\" .SS "Why have a tutorial and style guide?"
+.\" ====================================================================
+.\" the processing pipeline in brief
+.\"   preprocessors, roff itself, various output devices
+.\" Things that aren't groff--why you want the man page language to be
+.\" small (mandoc, Kerrisk's man7.org, manpages.debian.org, non-expert
+.\" humans).
+.\" possibly exhibit a horrorshow docbook-to-man example
+_endif()dnl
+.
+.
+.br
+.ne 6v
+.\" ====================================================================
+.SS "Macro reference preliminaries"
+.\" ====================================================================
+.
+A tagged paragraph describes each macro.
+.
+We present coupled pairs together,
+as with
+.B .EX
+and
+.BR .EE .
+.
+.
+.br
+.ne 2v
+.P
+_ifstyle()dnl
+Optional macro arguments are indicated by surrounding them with square
+brackets.
+.
+If a macro accepts multiple arguments,
+those containing space \" or tab (in Plan 9 troff only?)
+characters must be double-quoted to be interpreted correctly.
+.
+_endif()dnl
+An empty macro argument can be specified with a pair of double-quotes
+(""),
+but the
+.I man
+package is designed such that this should seldom be necessary.
+_ifstyle()dnl
+.
+See section \(lqNotes\(rq below for examples of cases where better
+alternatives to empty arguments in macro calls are available.
+_endif()dnl
+.
+Most macro arguments will be formatted as text in the output;
+exceptions are noted.
+.
+.
+.\" ====================================================================
+.SS "Document structure macros"
+.\" ====================================================================
+.
+Document structure macros organize a man page's content.
+.
+All of them break the output line.
+.
+.B .TH
+(title heading)
+identifies the document as a man page and configures the page headers
+and footers.
+.
+Section headings
+.RB ( .SH ),
+one of which is mandatory and many of which are conventionally expected,
+facilitate location of material by the reader and aid the man page
+writer to discuss all essential aspects of the topic.
+.
+Subsection headings
+.RB ( .SS )
+are optional and permit sections that grow long to develop in a
+controlled way.
+.
+Many technical discussions benefit from examples;
+lengthy ones,
+especially those reflecting multiple lines of input to or output from
+the system,
+are usefully bracketed by
+.B .EX
+and
+.BR .EE .
+.
+When none of the foregoing meets a structural demand,
+use
+.BR .RS / .RE
+to inset a region within a (sub)section.
+.
+.
+.TP
+.BI .TH " topic section"\c
+.RI " " footer-middle \c
+.RI " " footer-inside \c
+.RI " " header-middle 
+Determine the contents of the page header and footer.
+_ifstyle()dnl
+.
+.I roff
+systems refer to these collectively as \(lqtitles\(rq.
+_endif()dnl
+.
+The subject of the man page is
+.I topic
+and the section of the manual to which it belongs is
+.I section.
+_ifstyle()dnl
+.
+This use of \(lqsection\(rq has nothing to do with the section headings
+otherwise discussed in this page;
+it arises from the organizational scheme of printed and bound Unix
+manuals.
+_endif()dnl
+.
+See
+.MR man 1
+or
+.MR intro 1
+for the manual sectioning applicable to your system.
+.
+.I topic
+and
+.I section
+are positioned together at the left and right in the header
+(with
+.I section
+in parentheses immediately appended to
+.IR topic ).
+.
+.I footer-middle
+is centered in the footer.
+.
+The arrangement of the rest of the footer depends on whether
+double-sided layout is enabled with the option
+.BR \-rD1 .
+.
+When disabled (the default),
+.I footer-inside
+is positioned at the bottom left.
+.
+Otherwise,
+.I footer-inside
+appears at the bottom left on recto (odd-numbered) pages,
+and at the bottom right on verso (even-numbered) pages.
+.
+The outside footer is the page number,
+except in the continuous-rendering mode enabled by the option
+.BR \-rcR=1 ,
+in which case it is the
+.I topic
+and
+.I section,
+as in the header.
+.
+.I header-middle
+is centered in the header.
+.
+If
+.I section
+is an integer between 1 and\~9 (inclusive),
+there is no need to specify
+.I header-middle;
+.I an.tmac
+will supply text for it.
+.
+The macro package may also abbreviate
+.I topic
+and
+.I footer-inside
+with ellipses
+_ifstyle()dnl
+.RB ( .\|.\|.\& )
+_endif()dnl
+if they would overrun the space available in the header and footer,
+respectively.
+.
+For HTML output,
+headers and footers are suppressed.
+.
+.
+.IP
+Additionally,
+this macro breaks the page,
+resetting the number to\~1
+(unless the
+.B \-rC1
+option is given).
+.
+This feature is intended only for formatting multiple
+.I man
+documents in sequence.
+.
+.
+.IP
+A valid
+.I man
+document calls
+.B .TH
+once,
+early in the file,
+prior to any other macro calls.
+_ifstyle()dnl
+.
+.
+.IP
+By convention,
+.I footer-middle
+is the date of the most recent modification to the man page source
+document,
+and
+.I footer-inside
+is the name and version or release of the project providing it.
+_endif()dnl
+.
+.
+.TP
+.BR .SH " "\c
+.IR heading-text 
+Set
+.I heading-text
+as a section heading.
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line
+.\", which can be formatted with a macro, \" true but discouraged
+becomes
+.I heading-text.
+.
+The left margin is reset to zero to set the heading text in bold
+(or the font specified by the string
+.BR HF ),
+and,
+on typesetting devices,
+slightly larger than the base type size.
+.
+If the heading font
+.B \rs*HF
+is bold,
+use of an italic style in
+.I heading-text
+is mapped to the bold-italic style if available in the font family.
+.
+The inset level is reset to 1,
+setting the left margin to the value of the
+.B IN \" TODO: future: BP or BI register ("base paragraph indentation")
+register.
+.
+Text after
+.I heading-text
+is set as an ordinary paragraph
+.RB ( .P ).
+.
+.
+.IP
+The content of
+.I heading-text
+and ordering of sections follows a set of common practices,
+as has much of the layout of material within sections.
+.
+For example,
+a section called \(lqName\(rq or \(lqNAME\(rq must exist,
+must be the first section after the
+.B .TH
+call,
+and must contain only text of the form
+.RS \" Invisibly move left margin to current .IP indentation.
+.RS \" Now indent further, visibly.
+.IR topic \c
+.BI , " another-topic"\c
+.RB ".\|.\|.\& \e\- "\c
+.I summary-description
+.RE \" Move left margin back to .IP indentation.
+for a man page to be properly indexed.
+.
+See
+_ifnotstyle()dnl
+.MR groff_man_style @MAN7EXT@
+for suggestions and
+_endif()dnl
+.MR man 7
+for the conventions prevailing on your system.
+.RE \" Move left margin back to standard position.
+.
+.
+.TP
+.BR .SS " "\c
+.IR subheading-text 
+Set
+.I subheading-text
+as a subsection heading indented between a section heading and an
+ordinary paragraph
+.RB ( .P ).
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line
+.\", which can be formatted with a macro, \" true but discouraged
+becomes
+.I subheading-text.
+.
+The left margin is reset to the value of the
+.B SN
+register to set the heading text in bold
+(or the font specified by the string
+.BR HF ).
+.
+If the heading font
+.B \rs*HF
+is bold,
+use of an italic style in
+.I subheading-text
+is mapped to the bold-italic style if available in the font family.
+.
+The inset level is reset to 1,
+setting the left margin to the value of the
+.B IN \" TODO: future: BP or BI register ("base paragraph indentation")
+register.
+.
+Text after
+.I subheading-text
+is set as an ordinary paragraph
+.RB ( .P ).
+.
+.
+.TP
+.B .EX
+.TQ
+.B .EE
+Begin and end example.
+.
+After
+.BR .EX ,
+filling is disabled and a constant-width (monospaced) font is selected.
+.
+Calling
+.B .EE
+enables filling and restores the previous font.
+.
+.
+_ifstyle()dnl
+.IP
+Example regions are useful for formatting code,
+shell sessions,
+and text file contents.
+.
+An example region is not
+a \(lqliteral mode\(rq
+of any sort:
+special character escape sequences must still be used to produce correct
+glyphs for
+.BR \(aq ,
+.BR \- ,
+.BR \(rs ,
+.BR \(ha ,
+.BR \(ga ,
+and
+.BR \(ti ,
+and sentence endings are still detected and additional inter-sentence
+space applied.
+.
+If the amount of additional inter-sentence spacing is altered,
+the rendering of,
+for instance,
+regular expressions using
+.B .\&
+or
+.B ?\&
+followed by multiple spaces can change.
+.
+Use the dummy character escape sequence
+.B \(rs&
+before the spaces.
+.
+.
+_endif()dnl
+.IP
+.\" Also see subsection "History" below...
+These macros are extensions introduced in Ninth Edition Research Unix.
+.
+Systems running that
+.IR troff , \" AT&T Research Unix
+or those from
+Documenter's Workbench,
+Heirloom Doctools,
+or Plan\~9
+.I troff
+support them.
+.\" Solaris 10 troff does not support .EX/.EE.  Neatroff doesn't ship
+.\" (m)an macros.
+.
+To be certain your page will be portable to systems that do not,
+copy their definitions from the
+.I \%an\-ext.tmac
+file of a
+.I groff
+installation.
+.
+.
+.TP
+.BR .RS " "\c
+.IR inset-amount 
+Start a new relative inset level.
+.
+The position of the left margin is saved,
+then moved right by
+.I inset-amount,
+if specified,
+and by the amount of the
+.B IN
+register otherwise.
+.
+Calls to
+.B .RS
+can be nested;
+each increments by\~1
+the inset level used by
+.BR .RE .
+.
+The level prior to any
+.B .RS
+calls is\~1.
+.
+.
+.TP
+.BR .RE " "\c
+.IR level 
+End a relative inset.
+.
+The left margin corresponding to inset level
+.I level
+is restored.
+.
+If no argument is given,
+the inset level is reduced by\~1.
+.
+.
+.\" ====================================================================
+.SS "Paragraphing macros"
+.\" ====================================================================
+.
+An ordinary paragraph
+.RB ( .P )
+_ifstyle()dnl
+like this one
+_endif()dnl
+is set without a first-line indentation at the current left margin.
+.
+In man pages and other technical literature,
+definition lists are frequently encountered;
+these can be set as \(lqtagged paragraphs\(rq,
+which have one
+.RB ( .TP )
+or more
+.RB ( .TQ )
+leading tags followed by a paragraph that has an additional indentation.
+.
+The indented paragraph
+.RB ( .IP )
+macro is useful to continue the indented content of a narrative started
+with
+.BR .TP ,
+or to present an itemized or ordered list.
+.
+All of these macros break the output line.
+.
+If another paragraph macro has occurred since the previous
+.B .SH
+or
+.BR .SS ,
+they
+(except for
+.BR .TQ )
+follow the break with a default amount of vertical space,
+which can be changed by the deprecated
+.B .PD
+macro;
+see subsection \(lqHorizontal and vertical spacing\(rq below.
+.
+They also reset the type size and font style to defaults
+.RB ( .TQ
+again excepted);
+see subsection \(lqFont style macros\(rq below.
+.
+.
+.br
+.ne 4v
+.TP
+.B .P
+.TQ
+.B .LP
+.TQ
+.B .PP
+Begin a new paragraph;
+these macros are synonymous.
+.
+The indentation is reset to the default value;
+the left margin,
+as affected by
+.B .RS
+and
+.BR .RE ,
+is not.
+.
+.
+.TP
+.BR .TP " "\c
+.IR indentation 
+Set a paragraph with a leading tag,
+and the remainder of the paragraph indented.
+.
+A one-line input trap is planted;
+text on the next line,
+which can be formatted with a macro,
+becomes the tag,
+which is placed at the current left margin.
+.
+The tag can be extended with the
+.B \(rsc
+escape sequence.
+.
+Subsequent text is indented by
+.I indentation,
+if specified,
+and by the amount of the
+.B IN
+register otherwise.
+.
+If the tag is not as wide as the indentation,
+the paragraph starts on the same line as the tag,
+at the applicable indentation,
+and continues on the following lines.
+.
+Otherwise,
+the descriptive part of the paragraph begins on the line following the
+tag.
+_ifstyle()dnl
+.
+.
+.IP
+The line containing the tag can `include' a macro call,
+for instance to set the tag in bold with
+.BR .B .
+.
+.B .TP
+was used to write the first paragraph of this description of
+.BR .TP ,
+and
+.B .IP
+the subsequent one.
+_endif()dnl
+.
+.
+.TP
+.B .TQ
+Set an additional tag for a paragraph tagged with
+.BR .TP .
+.
+An input trap is planted as with
+.BR .TP .
+.
+.
+.IP
+This macro is a GNU extension not defined on systems running
+AT&T,
+Plan\~9,
+or
+Solaris
+.IR troff ;
+see
+.I \%an\-ext.tmac
+in section \(lqFiles\(rq below.
+_ifstyle()dnl
+.
+.
+.IP
+The descriptions of
+.BR .P ,
+.BR .LP ,
+and
+.B .PP
+above were written using
+.B .TP
+and
+.BR .TQ .
+_endif()dnl
+.
+.
+.TP
+.BR .IP " "\c
+.IR tag " "\c
+.RI  indentation 
+Set an indented paragraph with an optional tag.
+.
+The
+.I tag
+and
+.I indentation
+arguments,
+if present,
+are handled as with
+.BR .TP ,
+with the exception that the
+.I tag
+argument to
+.B .IP
+cannot `include' a macro call.
+.
+.
+_ifstyle()dnl
+.IP
+Two convenient uses for
+.B .IP
+are
+.
+.
+.RS \" Invisibly move left margin to current .IP indentation.
+.RS 4n \" Now indent further, visibly.
+.IP (1) 4n
+to start a new paragraph with the same indentation as an immediately
+preceding
+.B .IP
+or
+.B .TP
+paragraph,
+if no
+.I indentation
+argument is given;
+and
+.
+.
+.IP (2)
+to set a paragraph with a short
+.I tag
+that is not semantically important,
+such as a bullet (\(bu)\(emobtained with the
+.B \e(bu
+special character escape sequence\(emor list enumerator,
+as seen in this very paragraph.
+.RE \" Move left margin back to .IP indentation.
+.RE \" Move left margin back to standard position.
+.
+.
+_endif()dnl
+.\" ====================================================================
+.SS "Command synopsis macros"
+.\" ====================================================================
+.
+.B .SY
+and
+.B .YS
+aid you to construct a command synopsis that has the classical Unix
+appearance.
+.
+They break the output line.
+.
+.\" TODO: Determine whether this (is still? was ever?) true.
+.\" Furthermore,
+.\" some tools are able to interpret these macros semantically and treat
+.\" them appropriately for localization and/or presentation.
+.
+.
+.P
+These macros are GNU extensions not defined on systems running
+AT&T,
+Plan\~9,
+or
+Solaris
+.IR troff ;
+see
+.I \%an\-ext.tmac
+in section \(lqFiles\(rq below.
+.
+.
+.TP
+.BI .SY " command"
+Begin synopsis.
+.
+A new paragraph begins at the left margin
+_ifstyle()dnl
+(as with
+.BR .P )
+_endif()dnl
+unless
+.B .SY
+has already been called without a corresponding
+.BR .YS ,
+in which case only a break is performed.
+.
+Adjustment and automatic hyphenation are disabled.
+.
+.I command
+is set in bold.
+.
+If a break is required,
+lines after the first are indented by the width of
+.I command
+plus a space.
+.
+.
+.TP
+.B .YS
+End synopsis.
+.
+Indentation,
+adjustment,
+and hyphenation
+are restored to their previous states.
+_ifstyle()dnl
+.
+.
+.P
+Multiple
+.BR .SY / .YS
+blocks can be specified,
+for instance to distinguish differing modes of operation of a complex
+command like
+.MR tar 1 ;
+each will be vertically separated as paragraphs are.
+.
+.
+.P
+.B .SY
+can be repeated before
+.B .YS
+to indicate synonymous ways of invoking a particular mode of operation.
+.
+.
+.br
+.ne 2v
+.P
+.IR groff 's
+own command-line interface serves to illustrate most of the specimens
+of synopsis syntax one is likely to encounter.
+.
+.
+.IP
+.\" from src/roff/groff/groff.1.man
+.EX
+\&.SY groff
+\&.RB  \e-abcCeEgGijklNpRsStUVXzZ 
+\&.RB  \e-d\e\(ti\ec
+\&.IR cs 
+\&.RB  \e-d\e\(ti\ec
+\&.IB name =\ec
+\&.IR string 
+\&.RB  \e-D\e\(ti\ec
+\&.IR enc 
+.EE
+.
+.I (and so on similarly)
+.
+.EX
+\&.RI  file\e\(ti .\e|.\e|.
+\&.YS
+\&.
+\&.
+\&.SY groff
+\&.B \e-h
+\&.
+\&.SY groff
+\&.B \e-\e-help
+\&.YS
+\&.
+\&.
+\&.SY groff
+\&.B \e-v
+\&.RI  option\e\(ti .\e|.\e|.\e&
+\&.RI  file\e\(ti .\e|.\e|.
+\&.
+\&.SY groff
+\&.B \e-\e-version
+\&.RI  option\e\(ti .\e|.\e|.\e&
+\&.RI  file\e\(ti .\e|.\e|.
+\&.YS
+.EE
+.
+.
+.P
+produces the following output.
+.
+.
+.RS
+.SY groff
+.RB  \-abcCeEgGijklNpRsStUVXzZ 
+.RB  \-d\~\c
+.IR cs 
+.RB  \-d\~\c
+.IB name =\c
+.IR string 
+.RB  \-D\~\c
+.IR enc 
+.RB  \-f\~\c
+.IR fam 
+.RB  \-F\~\c
+.IR dir 
+.RB  \-I\~\c
+.IR dir 
+.RB  \-K\~\c
+.IR enc 
+.RB  \-L\~\c
+.IR arg 
+.RB  \-m\~\c
+.IR name 
+.RB  \-M\~\c
+.IR dir 
+.RB  \-n\~\c
+.IR num 
+.RB  \-o\~\c
+.IR list 
+.RB  \-P\~\c
+.IR arg 
+.RB  \-r\~\c
+.IR cn 
+.RB  \-r\~\c
+.IB reg =\c
+.IR expr 
+.RB  \-T\~\c
+.IR dev 
+.RB  \-w\~\c
+.IR name 
+.RB  \-W\~\c
+.IR name 
+.RI  file\~ .\|.\|.
+.YS
+.
+.
+.SY groff
+.B \-h
+.
+.SY groff
+.B \-\-help
+.YS
+.
+.
+.SY groff
+.B \-v
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
+.SY groff
+.B \-\-version
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.YS
+.RE
+.
+.
+.P
+Several features of the above example are of note.
+.
+.
+.IP \(bu 2n
+The empty request (.),
+which does nothing,
+is used to vertically space the input file for readability by the
+document maintainer.
+.
+Do not put blank (empty) lines in a man page source document.
+.
+.
+.IP \(bu
+Command and option names are presented in
+.B bold
+to cue the user that they should be input literally.
+.
+.
+.IP \(bu
+Option dashes are specified with the
+.B \e\-
+escape sequence;
+this is an important practice to make them clearly visible and to
+facilitate copy-and-paste from the rendered man page to a shell prompt
+or text file.
+.
+.
+.IP \(bu
+Option arguments and command operands are presented in
+.I italics
+(but see subsection \(lqFont style macros\(rq below regarding terminals)
+to cue the user that they must be replaced with appropriate text.
+.
+.
+.IP \(bu
+Symbols that are neither to be typed literally nor replaced at the
+user's discretion appear in the roman style;
+brackets surround optional arguments,
+and an ellipsis indicates that the previous syntactical element may be
+repeated arbitrarily.
+.
+.
+.IP \(bu
+The non-breaking adjustable space escape sequence
+.B \e\(ti
+is used to prevent the output line from being broken within the option
+brackets;
+see subsection \(lqPortability\(rq below.
+.
+.
+.IP \(bu
+The output line continuation escape sequence
+.B \ec
+is used with font style alternation macros to allow all three font
+styles to be set without (breakable) space among them;
+see subsection \(lqPortability\(rq below.
+.
+.
+.IP \(bu
+The dummy character escape sequence
+.B \e&
+follows the ellipsis when further text will follow after space on the
+output line,
+keeping its last period from being interpreted as the end of a
+sentence
+.\" ...because it is followed by characters that are transparent to
+.\" end-of-sentence detection, and a newline...
+and causing additional inter-sentence space to be placed after it.
+.
+See subsection \(lqPortability\(rq below.
+_endif()dnl
+.
+.
+.\" ====================================================================
+.SS "Hyperlink macros"
+.\" ====================================================================
+.
+Man page cross references
+_ifstyle()dnl
+like
+.MR ls 1
+_endif()dnl
+are best presented with
+.BR .MR .
+.
+Text may be hyperlinked to email addresses with
+.BR .MT / .ME
+or other URIs with
+.BR .UR / .UE .
+.
+Hyperlinked text is supported on HTML
+.\", PDF,
+and terminal output devices;
+terminals and pager programs must support ECMA-48 OSC\~8 escape
+sequences
+(see
+.MR grotty @MAN1EXT@ ).
+.
+When device support is unavailable or disabled with the
+.B U
+register
+(see section \lqOptions\rq below),
+.B .MT
+and
+.B .UR
+URIs are rendered between angle brackets after the linked text.
+.
+.
+.P
+.BR .MT ,
+.BR .ME ,
+.BR .UR ,
+and
+.B .UE
+are GNU extensions not defined on systems running
+AT&T,
+Plan\~9,
+or
+Solaris
+.IR troff ; \" Solaris
+see
+.I \%an\-ext.tmac
+in section \(lqFiles\(rq below.
+.
+Plan\~9 from User Space's
+.I troff \" plan9port
+implements
+.BR .MR .
+.
+.
+.P
+The arguments to
+.BR .MR ,
+.BR .MT ,
+and
+.B .UR
+should be prepared for typesetting since they can appear in the
+output.
+.
+Use special character escape sequences to encode Unicode basic Latin
+characters where necessary,
+particularly the hyphen-minus.
+_ifstyle()dnl
+.
+(See section \lqPortability\rq below.)
+.
+URIs can be lengthy;
+rendering them can result in jarring adjustment or variations in line
+length,
+or
+.I @g@troff
+warnings when a hyperlink is longer than an output line.
+.
+The application of non-printing break point escape sequences
+.B \e:
+after each slash
+(or series thereof),
+and before each dot
+(or series thereof)
+is recommended as a rule of thumb.
+.
+The former practice avoids forcing a trailing slash in a URI onto a
+separate output line,
+and the latter helps the reader to avoid mistakenly interpreting a dot
+at the end of a line as a period
+(or multiple dots as an ellipsis).
+.
+Thus,
+.RS
+.EX
+\&.UR http://\e:example\e:.com/\e:fb8afcfbaebc74e\e:.cc
+.EE
+.RE
+has several potential break points in the URI shown.
+.
+Consider adding break points before or after at signs in email
+addresses,
+and question marks,
+ampersands,
+and number signs in HTTP(S) URIs.
+.
+_endif()dnl
+The formatter removes
+.B \e:
+escape sequences from hyperlinks when supplying device control commands
+to output drivers.
+.
+.
+.TP
+.BI .MR "\~topic manual-section"\c
+.RI \~ trailing-text 
+.IR (since\~ groff \~1.23) \" TODO: remove note once novelty dies down
+Set a man page cross reference as
+\lq\c
+.IB topic ( manual-section )\c
+\rq.
+.
+If
+.I trailing-text
+(typically punctuation)
+is specified,
+it follows the closing parenthesis without intervening space.
+.
+Hyphenation is disabled while the cross reference is set.
+.
+.I topic
+is set in the font specified by the
+.B MF
+string.
+.
+The cross reference hyperlinks to a URI of the form
+.RB \lq man:\c
+.IR topic ( manual-section )\rq.
+_ifstyle()dnl
+.
+.
+.RS
+.IP
+.EX
+The output driver
+\&.MR grops @MAN1EXT@
+produces PostScript from
+\&.I troff
+output.
+\&.
+The Ghostscript program (\rsc
+\&.MR gs 1 )
+interprets PostScript and PDF.
+.EE
+.RE
+_endif()dnl
+.
+.
+.TP
+.BI .MT " address"
+.TQ
+.BR .ME " "\c
+.IR trailing-text 
+Identify
+.I address
+as an RFC 6068
+.I addr-spec
+for a \(lqmailto:\(rq URI with the text between the two macro
+calls as the link text.
+.
+An argument to
+.B .ME
+is placed after the link text without intervening space.
+.
+.I address
+may not be visible in the rendered document if hyperlinks are enabled
+and supported by the output driver.
+.
+If they are not,
+.I address
+is set in angle brackets after the link text and before
+.I trailing-text.
+.
+If hyperlinking is enabled but there is no link text,
+.I address
+is formatted and hyperlinked
+.I without
+angle brackets.
+_ifstyle()dnl
+.
+.
+.br
+.ne 6v
+.IP
+When rendered by
+.I groff
+to a PostScript device,
+.RS
+.IP
+.EX
+Contact
+\&.MT fred\e:.foonly@\e:fubar\e:.net
+Fred Foonly
+\&.ME
+for more information.
+.EE
+.RE
+.
+.
+.IP
+displays as \(lqContact Fred Foonly \(lafred\:.foonly@\:fubar\:.net\(ra
+for more information.\(rq.
+_endif()dnl
+.
+.
+.TP
+.BI .UR " uri"
+.TQ
+.BR .UE " "\c
+.IR trailing-text 
+Identify
+.I uri
+as an RFC 3986 URI hyperlink with the text between the two macro calls
+as the link text.
+.
+An argument to
+.B .UE
+is placed after the link text without intervening space.
+.
+.I uri
+may not be visible in the rendered document if hyperlinks are enabled
+and supported by the output driver.
+.
+If they are not,
+.I uri
+is set in angle brackets after the link text and before
+.I trailing-text.
+.
+If hyperlinking is enabled but there is no link text,
+.I uri
+is formatted and hyperlinked
+.I without
+angle brackets.
+_ifstyle()dnl
+.
+.
+.IP
+When rendered by
+.I groff
+to a PostScript device,
+.RS
+.IP
+.EX
+The GNU Project of the Free Software Foundation
+hosts the
+\&.UR https://\e:www\e:.gnu\e:.org/\e:software/\e:groff/
+\&.I groff
+home page
+\&.UE .
+.EE
+.RE
+.
+.
+.IP
+displays as \(lqThe GNU Project of the Free Software Foundation hosts
+the
+.I groff
+home page
+\(lahttps://\:www\:.gnu\:.org/\:software/\:groff/\(ra.\(rq.
+_endif()dnl
+.
+.
+.P
+The hyperlinking of
+.B .TP
+paragraph tags with
+.BR .UR / .UE
+and
+.BR .MT / .ME
+is not yet supported;
+if attempted,
+the hyperlink will be typeset at the beginning of the indented paragraph
+even on hyperlink-supporting devices.
+.
+.
+.\" ====================================================================
+.SS "Font style macros"
+.\" ====================================================================
+.
+The
+.I man
+macro package is limited in its font styling options,
+offering only
+.BR bold \~( .B ),
+.I italic\c
+.RB \~( .I ),
+and roman.
+.
+Italic text is usually set underscored instead on terminal devices.
+.
+The
+.B .SM
+and
+.B .SB
+macros set text in roman or bold,
+respectively,
+at a smaller type size;
+these differ visually from regular-sized roman or bold text only on
+typesetting devices.
+.
+It is often necessary to set text in different styles without
+intervening space.
+.
+The macros
+.BR .BI ,
+.BR .BR ,
+.BR .IB ,
+.BR .IR ,
+.BR .RB ,
+and
+.BR .RI ,
+where \(lqB\(rq,
+\(lqI\(rq,
+and \(lqR\(rq indicate bold,
+italic,
+and roman,
+respectively,
+set their odd- and even-numbered arguments in alternating styles,
+with no space separating them.
+_ifstyle()dnl
+.
+.
+.P
+Because font styles are presentational rather than semantic,
+conflicting traditions have arisen regarding which font styles should be
+used to mark file or path names,
+environment variables,
+and inlined literals.
+_endif()dnl
+.
+.
+.br
+.ne 2v
+.P
+The default type size and family for typesetting devices is 10-point
+Times,
+except on the
+.B \%X75\-12
+and
+.B \%X100\-12
+devices where the type size is 12 points.
+.
+The default style is roman.
+.
+.
+.TP
+.BR .B \~\c
+.IR text 
+Set
+.I text
+in bold.
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line,
+which can be further formatted with a macro,
+is set in bold.
+.
+.
+_ifstyle()dnl
+.IP
+Use bold
+for literal portions of syntax synopses,
+for command-line options in running text,
+and for literals that are major topics of the subject under discussion;
+for example,
+this page uses bold for macro,
+string,
+and register names.
+.
+In an
+.BR .EX / .EE
+example of interactive I/O
+(such as a shell session),
+set only user input in bold.
+.
+.
+.
+_endif()dnl
+.TP
+.BR .I \~\c
+.IR text 
+Set
+.I text
+in an italic or oblique face.
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line,
+which can be further formatted with a macro,
+is set in an italic or oblique face.
+.
+.
+_ifstyle()dnl
+.IP
+Use italics
+for file and path names,
+for environment variables,
+for C data types,
+for enumeration or preprocessor constants in C,
+for variant (user-replaceable) portions of syntax synopses,
+for the first occurrence (only) of a technical concept being introduced,
+for names of journals and of literary works longer than an article,
+and anywhere a parameter requiring replacement by the user is
+encountered.
+.
+An exception involves variant text in a context already typeset in
+italics,
+such as file or path names with replaceable components;
+in such cases,
+follow the convention of mathematical typography:
+set the file or path name in italics as usual
+but use roman for the variant part
+(see
+.B .IR
+and
+.B .RI
+below),
+and italics again in running roman text when referring to the variant
+material.
+.
+.
+_endif()dnl
+.TP
+.BR .SM \~\c
+.IR text 
+Set
+.I text
+one point smaller than the default type size on typesetting devices.
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line,
+which can be further formatted with a macro,
+is set smaller.
+.
+.
+_ifstyle()dnl
+.IP
+.I Note:
+terminals will render
+.I text
+at normal size instead.
+.
+Do not rely upon
+.B .SM
+to communicate semantic information distinct from using roman style at
+normal size;
+it will be hidden from readers using such devices.
+.
+.
+_endif()dnl
+.TP
+.BR .SB \~\c
+.IR text 
+Set
+.I text
+in bold and
+(on typesetting devices)
+one point smaller than the default type size.
+.
+If no argument is given,
+a one-line input trap is planted;
+text on the next line,
+which can be further formatted with a macro,
+is set smaller and in bold.
+.
+This macro is an extension introduced in SunOS\~4.0.
+.
+.
+_ifstyle()dnl
+.IP
+.I Note:
+terminals will render
+.I text
+in bold at the normal size instead.
+.
+Do not rely upon
+.B .SB
+to communicate semantic information distinct from using bold style at
+normal size;
+it will be hidden from readers using such devices.
+.
+.
+.P
+Observe what is
+.I not
+prescribed for setting in bold or italics above:
+elements of \(lqsynopsis language\(rq such as ellipses and brackets
+around options;
+proper names and adjectives;
+titles of anything other than major works of literature;
+identifiers for standards documents or technical reports such as
+CSTR\~#54,
+RFC\~1918,
+Unicode\~13.0,
+or
+POSIX.1-2017;
+acronyms;
+and occurrences after the first of a technical term.
+.
+.
+.P
+Be frugal with italics for emphasis,
+and particularly with bold.
+.
+Article titles and brief runs of literal text,
+such as references to individual characters or short strings,
+including section and subsection headings of man pages,
+are suitable objects for quotation;
+see the
+.BR \e(lq ,
+.BR \e(rq ,
+.BR \e(oq ,
+and
+.B \e(cq
+escape sequences in subsection \(lqPortability\(rq below.
+.
+.
+_endif()dnl
+.P
+Unlike the above font style macros,
+the font style alternation macros below set no input traps;
+they must be given arguments to have effect.
+.
+Italic corrections are applied as appropriate.
+.
+_ifstyle()dnl
+If a space is required within an argument,
+first consider whether the same result could be achieved with as much
+clarity by using single-style macros on separate input lines.
+.
+When it cannot,
+double-quote an argument containing embedded space characters.
+.
+Setting all three different styles within a word
+presents challenges;
+it is possible with the
+.B \ec
+and/or
+.B \ef
+escape sequences.
+.
+See subsection \(lqPortability\(rq
+below for approaches.
+_endif()dnl
+.
+.
+.TP
+.BI .BI " bold-text italic-text "\c
+\&.\|.\|.\&
+Set each argument in bold and italics,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from src/roff/troff/troff.1.man
+.EX
+\&.BI \-r\~ register = numeric-expression
+.EE
+.RE
+.
+.
+_endif()dnl
+.TP
+.BI .BR " bold-text roman-text "\c
+\&.\|.\|.\&
+Set each argument in bold and roman,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from tmac/groff_ms.7.man
+.EX
+After
+\&.B .NH
+is called,
+.EE
+.RE
+.
+.
+_endif()dnl
+.TP
+.BI .IB " italic-text bold-text "\c
+\&.\|.\|.\&
+Set each argument in italics and bold,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from src/preproc/pic/pic.1.man
+.EX
+In places where
+\&.IB n th
+is allowed,
+.EE
+.RE
+.
+.
+_endif()dnl
+.TP
+.BI .IR " italic-text roman-text "\c
+\&.\|.\|.\&
+Set each argument in italics and roman,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from src/preproc/pic/pic.1.man
+.EX
+Use GNU
+\&.IR pic \aqs
+\&.B figname
+command to change the name of the vbox.
+.EE
+.RE
+.
+.
+_endif()dnl
+.TP
+.BI .RB " roman-text bold-text "\c
+\&.\|.\|.\&
+Set each argument in roman and bold,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from src/preproc/pic/pic.1.man
+.EX
+if
+\&.I file
+is
+\&.RB \rslq \rs\- \rsrq,
+the standard input stream is read.
+.RE
+.EE
+.
+.
+_endif()dnl
+.TP
+.BI .RI " roman-text italic-text "\c
+\&.\|.\|.\&
+Set each argument in roman and italics,
+alternately.
+.
+.
+_ifstyle()dnl
+.RS
+.IP
+.\" from src/preproc/pic/pic.1.man
+.EX
+\&.RI ( tpic
+was a fork of AT&T
+\&.I pic \" AT&T
+by Tim Morgan of the University of California at Irvine
+.EE
+.RE
+.
+.
+_endif()dnl
+.\" ====================================================================
+.SS "Horizontal and vertical spacing"
+.\" ====================================================================
+.
+The
+.I indentation
+argument accepted by
+.BR .IP ,
+.BR .TP ,
+and the deprecated
+.B .HP
+is a number plus an optional scaling unit,
+as is
+.BR .RS 's
+.IR inset-amount .
+.
+If no scaling unit is given,
+the
+.I man
+_ifstyle()dnl
+package assumes \(lqn\(rq;
+that is,
+the width of a letter \(lqn\(rq in the font current when the macro is
+called
+(see section \(lqMeasurements\(rq in
+.MR groff @MAN7EXT@ ).
+_endif()dnl
+_ifnotstyle()dnl
+package assumes \(lqn\(rq.
+_endif()dnl
+.
+An indentation specified in a call to
+.BR .IP ,
+.BR .TP ,
+or the deprecated
+.B .HP
+persists until
+(1) another of these macros is called with an
+.I indentation
+argument,
+or
+(2)
+.BR .SH ,
+.BR .SS ,
+or
+.B .P
+or its synonyms is called;
+these clear the indentation entirely.
+.
+.
+.P
+The left margin used by ordinary paragraphs set with
+.B .P
+(and its synonyms)
+not within an
+.BR .RS / .RE
+relative inset
+.\" TODO: future: BP or BI register ("base paragraph indentation")
+is 7.2n for typesetting devices
+and 7n for terminal devices
+(but see the
+.B \-rIN
+option).
+.
+Headers,
+footers
+(both set with
+.BR .TH ),
+and section headings
+.RB ( .SH )
+are set at the page offset
+(see
+.MR groff @MAN7EXT@ )
+and subsection headings
+.RB ( .SS )
+indented from it by 3n
+(but see the
+.B \-rSN
+option).
+.
+.\" XXX: This is not true, but they do handle it badly.
+.\" HTML output devices ignore indentation.
+_ifstyle()dnl
+.
+.
+.P
+It may be helpful to think of the left margin and indentation as related
+but distinct concepts;
+.IR groff 's
+implementation of the
+.I man
+macro package tracks them separately.
+.
+The left margin is manipulated by
+.B .RS
+and
+.B .RE
+(and by
+.\".BR .TH ,\" True but not to be encouraged within a document.
+.B .SH
+and
+.BR .SS ,
+which reset it to the default).
+.
+Indentation is controlled by the paragraphing macros
+(though,
+again,
+.\".BR .TH ,
+.B .SH
+and
+.B .SS
+reset it);
+it is imposed by the
+.BR .TP ,
+.BR .IP ,
+and deprecated
+.B .HP
+macros,
+and cancelled by
+.B .P
+and its synonyms.
+.
+An extensive example follows.
+.
+.
+.P
+This ordinary
+.RB ( .P )
+paragraph is not in a relative inset nor does it possess an indentation.
+.
+.
+.RS
+.P
+Now we have created a relative inset
+(in other words,
+moved the left margin)
+with
+.B .RS
+and started another ordinary paragraph with
+.BR .P .
+.
+.
+.TP
+.B tag
+This tagged paragraph,
+set with
+.BR .TP ,
+is still within the
+.B .RS
+region,
+but lines after the first have a supplementary indentation that the
+tag lacks.
+.
+.
+.IP
+A paragraph like this one,
+set with
+.BR .IP ,
+will appear to the reader as also associated with the tag above,
+because
+.B .IP
+re-uses the previous paragraph's indentation unless given an argument
+to change it.
+.
+This paragraph is affected both by the moved left margin
+.RB ( .RS )
+and indentation
+.RB ( .IP ).
+.
+.TS
+box;
+l.
+This table is affected both by
+the left margin and indentation.
+.TE
+.
+.
+.IP \(bu
+This indented paragraph has a bullet for a tag,
+making it more obvious that the left margin and indentation are
+distinct;
+only the former affects the tag,
+but both affect the text of the paragraph.
+.
+.
+.br
+.ne 3v
+.P
+This ordinary
+.RB ( .P )
+paragraph resets the indentation,
+but the left margin is still inset.
+.
+.TS
+box;
+l.
+This table is affected only
+by the left margin.
+.TE
+.RE
+.
+.
+.P
+Finally,
+we have ended the relative inset by using
+.BR .RE ,
+which
+(because we used only one
+.BR .RS / .RE
+pair)
+has reset the left margin to the default.
+.
+This is an ordinary
+.B .P
+paragraph.
+.
+.
+.P
+Resist the temptation to mock up tabular or multi-column output with
+tab characters or the indentation arguments to
+.BR .IP ,
+.BR .TP ,
+.BR .RS ,
+or the deprecated
+.BR .HP ;
+the result may not render comprehensibly on an output device you fail to
+check,
+or which is developed in the future.
+.
+The table preprocessor
+.MR @g@tbl @MAN1EXT@
+can likely meet your needs.
+_endif()dnl
+.
+.
+.P
+Several macros insert vertical space:
+.BR .SH ,
+.BR .SS ,
+.BR .TP ,
+.B .P
+(and its synonyms),
+.BR .IP ,
+and the deprecated
+.BR .HP .
+.
+The default inter-section and inter-paragraph spacing is
+is 1v for terminal devices
+_ifstyle()dnl
+and 0.4v for typesetting devices
+(\(lqv\(rq is a unit of vertical distance,
+where 1v is the distance between adjacent text baselines in a
+single-spaced document).
+_endif()dnl
+_ifnotstyle()dnl
+and 0.4v for typesetting devices.
+_endif()dnl
+.
+(The deprecated macro
+.B .PD
+can change this vertical spacing,
+but its use is discouraged.)
+.
+Between
+.B .EX
+and
+.B .EE
+calls,
+the inter-paragraph spacing is 1v regardless of output
+device.
+.
+.
+.\" ====================================================================
+.SS Registers
+.\" ====================================================================
+.
+Registers are described in section \(lqOptions\(rq below.
+.
+They can be set not only on the command line but in the site
+.I man.local
+file as well;
+see section \(lqFiles\(rq below.
+.
+.
+.br
+.ne 7v
+.\" ====================================================================
+.SS Strings
+.\" ====================================================================
+.
+The following strings are defined for use in man pages.
+.
+_ifnotstyle()dnl
+None of these is necessary in a contemporary man page;
+see
+.MR groff_man_style @MAN7EXT@ .
+_endif()dnl
+.
+Others are supported for configuration of rendering parameters;
+see section \(lqOptions\(rq below.
+.
+.
+.TP
+.B \e*R
+interpolates a special character escape sequence for the \(lqregistered
+sign\(rq glyph,
+.BR \e(rg ,
+if available,
+and \(lq(Reg.)\(rq otherwise.
+.
+.
+.
+.TP
+.B \e*S
+interpolates an escape sequence setting the type size to the document
+default.
+.
+.
+.TP
+.B \e*(lq
+.TQ
+.B \e*(rq
+interpolate special character escape sequences for left and right
+double-quotation marks,
+.B \e(lq
+and
+.BR \e(rq ,
+respectively.
+.
+.
+.TP
+.B \e*(Tm
+interpolates a special character escape sequence for the \(lqtrade mark
+sign\(rq glyph,
+.BR \e(tm ,
+if available,
+and \(lq(TM)\(rq otherwise.
+_ifstyle()dnl
+.
+.
+.P
+None of the above is necessary in a contemporary man page.
+.
+.B \e*S
+is superfluous,
+since type size changes are invisible on terminal devices and macros
+that change it restore its original value afterward.
+.
+Better alternatives exist for the rest;
+simply use the
+.BR \(rs(rg , \" Heirloom Doctools, mandoc, neatmkfn, Plan 9, Solaris
+.BR \(rs(lq , \" Heirloom Doctools, mandoc, neatmkfn, Plan 9
+.BR \(rs(rq , \" Heirloom Doctools, mandoc, neatmkfn, Plan 9
+and
+.B \(rs(tm \" Heirloom Doctools, mandoc, neatmkfn, Plan 9
+special character escape sequences directly.
+.
+Unless a man page author is aiming for a pathological level of
+portability,
+such as the composition of pages for consumption on simulators of 1980s
+Unix systems
+(or Solaris
+.IR troff ,
+though even it supports
+.BR \(rs(rg ),
+the above strings should be avoided.
+.
+.
+.\" ====================================================================
+.SS Portability
+.\" ====================================================================
+.
+It is wise to quote multi-word section and subsection headings;
+the
+.B .SH
+and
+.B .SS
+macros of
+.MR man 7
+implementations descended from Seventh Edition Unix supported six
+arguments at most.
+.
+A similar restriction applied to the
+.BR .B ,
+.BR .I ,
+.BR .SM ,
+and font style alternation macros.
+.
+.
+.P
+The two major syntactical categories for formatting control in the
+.I roff
+language are requests and escape sequences.
+.
+Since the
+.I man
+macros are implemented in terms of
+.I groff
+requests and escape sequences,
+one can,
+in principle,
+supplement the functionality of
+.I man
+with these lower-level elements where necessary.
+.
+.
+.br
+.ne 2v
+.P
+However,
+using raw
+.I groff
+requests
+(apart from the empty request
+.RB \(lq . \(rq)\&
+is likely to make your page render poorly when processed by other tools;
+many of these attempt to interpret page sources directly for conversion
+to HTML.
+.
+Some requests make implicit assumptions about things like character
+and page sizes that may not hold in an HTML environment;
+also,
+many of these viewers don't interpret the full
+.I groff
+vocabulary,
+a problem that can lead to portions of your text being omitted
+or presented incomprehensibly.
+.
+.
+.P
+For portability to modern viewers,
+it is best to write your page solely with the macros described in this
+page
+(except for the ones identified as deprecated,
+which should be avoided).
+.
+The macros we have described as extensions
+.RB ( .EX / .EE ,
+.BR .SY / .YS ,
+.BR .TQ ,
+.BR .UR / .UE ,
+.BR .MT / .ME ,
+.BR .MR ,
+and
+.BR .SB )
+should be used with caution,
+as they may not be built in to some viewer that is important to your
+audience.
+.
+See
+.I \%an\-ext.tmac
+in section \(lqFiles\(rq below.
+.
+.
+.P
+Similar caveats apply to escape sequences.
+.
+Some escape sequences are however required for correct typesetting
+even in man pages and usually do not cause portability problems.
+.
+Several of these render glyphs corresponding to punctuation code points
+in the Unicode basic Latin range
+(U+0000\(enU+007F)
+that are handled specially in
+.I roff
+input;
+the escape sequences below must be used to render them correctly and
+portably when documenting material that uses them
+syntactically\(emnamely,
+any of the set
+.B \(aq \- \(rs \(ha \(ga \(ti
+(apostrophe,
+dash or minus,
+backslash,
+caret,
+grave accent,
+tilde).
+.
+.
+.br
+.ne 2v
+.TP
+.B \e\(dq
+Comment.
+.
+Everything after the double-quote to the end of the input line is
+ignored.
+.
+Whole-line comments should be placed immediately after the empty request
+.RB (\(lq . \(rq).
+.
+.
+.TP
+.BI \e newline
+Join the next input line to the current one.
+.
+Except for the update of the input line counter
+(used for diagnostic messages and related purposes),
+a series of lines ending in backslash-newline appears to
+.I groff
+as a single input line.
+.
+Use this escape sequence to split excessively long input lines for
+document maintenance.
+.
+.
+.TP
+.B \e%
+Control hyphenation.
+.
+The location of this escape sequence within a word marks a hyphenation
+point,
+supplementing
+.IR groff 's
+automatic hyphenation patterns.
+.
+At the beginning of a word,
+it suppresses any hyphenation breaks within
+.I except
+those specified with
+.BR \e% .
+.
+.
+.TP
+.B \e:
+Insert a non-printing break point.
+.
+A word can break at such a point,
+but a hyphen glyph is not written to the output if it does.
+.
+This escape sequence is an input word boundary,
+so the remainder of the word is subject to hyphenation as normal.
+.
+You can use
+.B \e:
+and
+.B \e%
+in combination to control breaking of a file name or URI or to permit
+hyphenation only after certain explicit hyphens within a word.
+.
+See subsection \lqHyperlink macros\rq above for an example.
+.
+.
+.IP
+This escape sequence is a
+.I groff
+extension also supported by Heirloom Doctools
+.I troff \" Heirloom
+050915 (September 2005),
+.I mandoc
+1.14.5 (2019-03-10),
+and
+.I neatroff
+(commit 399a4936,
+2014-02-17),
+but not by Plan\~9,
+Solaris,
+or Documenter's Workbench
+.IR troff s. \" Plan 9, Solaris, DWB
+.\" as of this writing, 2022-08-13
+.
+.
+.TP
+.B \e\(ti
+Adjustable non-breaking space.
+.
+Use this escape sequence to prevent a break inside a short phrase or
+between a numerical quantity and its corresponding unit(s).
+.
+.
+.RS
+.IP
+.EX
+Before starting the motor,
+set the output speed to\e\(ti1.
+There are 1,024\e\(tibytes in 1\e\(tiKiB.
+CSTR\e\(ti#8 documents the B\e\(tilanguage.
+.EE
+.RE
+.
+.
+.\" BEGIN Keep in sync with groff.texi node "Other Differences" and
+.\" groff_diff(7).
+.IP
+This escape sequence is a
+.I groff
+extension also supported by Heirloom Doctools
+.I troff \" Heirloom
+050915 (September 2005),
+.I mandoc
+1.9.5 (2009-09-21),
+.I neatroff
+(commit 1c6ab0f6e,
+2016-09-13),
+and
+Plan\~9 from User Space
+.I troff \" Plan 9
+(commit 93f8143600,
+2022-08-12),
+but not by Solaris
+or Documenter's Workbench
+.IR troff s. \" Solaris, DWB
+.\" as of this writing, 2022-08-13
+.\" END Keep in sync with groff.texi node "Other Differences" and
+.\" groff_diff(7).
+.
+.
+.TP
+.B \e&
+Dummy character.
+.
+Insert at the beginning of an input line to prevent a dot or apostrophe
+from being interpreted as beginning a
+.I roff
+control line.
+.
+Append to an end-of-sentence punctuation sequence to keep it from being
+recognized as such.
+.
+.
+.TP
+.B \e|
+Thin space
+(one-sixth em on typesetters,
+zero-width on terminals);
+a non-breaking space.
+.
+Used primarily in ellipses
+(\(lq.\e|.\e|.\(rq)
+to space the dots more pleasantly on typesetting devices like
+.BR dvi ,
+.BR pdf ,
+and
+.BR ps .
+.
+.
+.TP
+.B \ec
+End a text line without inserting space or attempting a break.
+.
+.\" TODO: When we explain what a "sentence" is, move this parenthetical
+.\" there.
+Normally,
+if filling is enabled,
+the end of a text line is treated like a space;
+.\" end-of-sentence detection is performed, and...
+an output line
+.I may
+be broken there
+(if not,
+an adjustable space is inserted);
+if filling is disabled,
+the line
+.I will
+be broken there,
+as in
+.BR .EX / .EE
+examples.
+.
+The next line is interpreted as usual and can `include' a macro call
+(contrast with
+.BI \e newline\/\c
+).
+.
+.B \(rsc
+is useful when three font styles are
+needed in a single word,
+as in a command synopsis.
+.
+.
+.RS
+.IP
+.\" from contrib/pdfmark/pdfroff.1.man
+.EX
+\&.RB  \e\-\e\-stylesheet=\ec
+\&.IR name 
+.EE
+.RE
+.
+.
+.IP
+It also helps when changing font styles in
+.BR .EX / .EE
+examples,
+since they are not filled.
+.
+.
+.RS
+.IP
+.\" from src/devices/grotty/grotty.1.man
+.EX
+\&.EX
+$ \ec
+\&.B groff \e\-T utf8 \e\-Z \ec
+\&.I file \ec
+\&.B | grotty \e\-i
+\&.EE
+.EE
+.RE
+.
+.
+.IP
+Alternatively,
+and perhaps with better portability,
+the
+.B \ef
+font selection escape sequence can be used;
+see below.
+.
+Using
+.B \ec
+to continue a
+.B .TP
+paragraph tag across multiple input lines will render incorrectly with
+.I groff
+1.22.3,
+.I mandoc
+1.14.1,
+older versions of these programs,
+and perhaps with some other formatters.
+.
+.
+.TP
+.B \ee
+Format the current escape character on the output;
+widely used in man pages to render a backslash glyph.
+.
+.\" Don't bold the .ec request in this discussion; it's not a major
+.\" topic of _this_ page as it would be in groff(7).  Also, we don't
+.\" want to encourage people to mess with this old kludge by drawing
+.\" attention to it.
+It works reliably as long as the \lq.ec\rq request is not used,
+which should never happen in man pages,
+and it is slightly more portable than the more explicit
+.B \e(rs
+(\(lqreverse solidus\(rq) special character escape sequence.
+.
+.
+.TP
+.BR \efB ,\~ \efI ,\~ \efR ,\~ \efP
+Switch to bold,
+italic,
+roman,
+or back to the previous style,
+respectively.
+.
+Either
+.B \ef
+or
+.B \ec
+is needed when three different font styles are required in a word.
+.
+.
+.RS
+.IP
+.\" second example from contrib/pdfmark/pdfroff.1.man
+.EX
+\&.RB  \e\-\e\-reference\e\-dictionary=\efI\e,name\e/\efP 
+.IP
+\&.RB  \e\-\e\-reference\e\-dictionary=\ec
+\&.IR name 
+.EE
+.RE
+.
+.
+.IP
+Style escape sequences may be more portable than
+.BR \ec .
+.
+As shown above,
+it is up to you to account for italic corrections with
+.\" Normally we don't quote escape sequences, but these use
+.\" potentially-confusing prose punctuation.
+.RB \(lq \^\e\|/\^ \(rq
+and
+.RB \(lq \^\e\^, \(rq,
+which are themselves GNU extensions,
+if desired and if supported by your implementation.
+.
+.
+.IP
+.B \efP
+reliably returns to the style in use immediately preceding the
+previous
+.B \ef
+escape sequence only if no
+sectioning,
+paragraph,
+or style macro calls have intervened.
+.
+.
+.IP
+As long as at most two styles are needed in a word,
+style macros like
+.B .B
+and
+.B .BI
+usually result in more readable
+.I roff
+source than
+.B \ef
+escape sequences do.
+.
+.
+.P
+Several special characters are also widely portable.
+.\" meaning: groff, Heirloom Doctools troff, neatroff, mandoc
+.
+Except for
+.BR \rs\- ,
+.BR \rs(em ,
+and
+.BR \rs(ga ,
+AT&T
+.I troff
+did not consistently `define' the characters listed below,
+.\" Only \-, \(em, and \(ga were documented in CSTR #54 (1976).  CSTR
+.\" #54 (1992) offers no _comprehensive_ list but shows \(en in its
+.\" PostScript DESC file example.  In DWB 3.3, \(aq was supported by the
+.\" "post" device, and \(dq by "pcl" and "Latin1".
+but its descendants,
+like Plan\~9 or Solaris
+.IR troff , \" Plan 9, Solaris
+can be made to support them by defining them in font description files,
+making them aliases of existing glyphs if necessary;
+see
+.MR groff_font @MAN5EXT@ .
+.
+.
+.TP
+.B \e\-
+Minus sign or basic Latin hyphen-minus.
+.
+This escape sequence produces the Unix command-line option dash in the
+output.
+.
+.RB \(lq \- \(rq
+is a hyphen in the
+.I roff
+language;
+some output devices replace it with U+2010
+(hyphen)
+or similar.
+.
+.
+.TP
+.B \e(aq
+Basic Latin neutral apostrophe.
+.
+Some output devices format
+.RB \(lq\| \(aq \|\(rq
+as a right single quotation mark.
+.
+.
+.br
+.ne 3v
+.TP
+.B \e(oq
+.TQ
+.B \e(cq
+Opening (left) and closing (right) single quotation marks.
+.
+Use these for paired directional single quotes,
+\(oqlike this\(cq.
+.
+.
+.TP
+.B \e(dq
+Basic Latin quotation mark
+(double quote).
+.
+Use in macro calls to prevent
+.\" This page prefers double quotes, but not here because they are more
+.\" confusing to the eye when another double quote is what is quoted!
+.RB \(oq\| \(dq \|\(rq
+.\" AT&T: .RB ` """'
+from being interpreted as beginning a quoted argument,
+or simply for readability.
+.
+.
+.RS
+.IP
+.\" from src/preproc/eqn/eqn.1.man
+.EX
+\&.TP
+\&.BI \(dqsplit \e(dq\(dq text \e(dq
+.EE
+.RE
+.
+.
+.br
+.\" XXX: We need only 2v, but 2v more are necessary due to bad
+.\" interaction with TP's own use of the ne request.
+.ne 4v
+.TP
+.B \e(lq
+.TQ
+.B \e(rq
+Left and right double quotation marks.
+.
+Use these for paired directional double quotes,
+\(lqlike this\(rq.
+.
+.
+.TP
+.B \e(em
+Em-dash.
+.
+Use for an interruption\(emsuch as this one\(emin a sentence.
+.
+.
+.TP
+.B \e(en
+En-dash.
+.
+Use to separate the ends of a range,
+particularly between numbers;
+for example,
+\(lqthe digits 1\(en9\(rq.
+.
+.
+.TP
+.B \e(ga
+Basic Latin grave accent.
+.
+Some output devices format
+.RB \(lq\| \(ga \|\(rq
+as a left single quotation mark.
+.
+.
+.TP
+.B \e(ha
+Basic Latin circumflex accent
+(\(lqhat\(rq).
+.
+Some output devices format
+.RB \(lq \(ha \(rq
+as U+02C6
+(modifier letter circumflex accent)
+or similar.
+.
+.
+.TP
+.B \e(rs
+Reverse solidus
+(backslash).
+.
+The backslash is the default escape character in the
+.I roff
+language,
+so it does not represent itself in output.
+.
+Also see
+.B \ee
+above.
+.
+.
+.TP
+.B \e(ti
+Basic Latin tilde.
+.
+Some output devices format
+.RB \(lq \(ti \(rq
+as U+02DC
+(small tilde)
+or similar.
+.
+.
+.P
+For maximum portability,
+escape sequences and special characters not listed above are better
+avoided in man pages.
+_endif()dnl
+.
+.
+.\" ====================================================================
+.SS Hooks
+.\" ====================================================================
+.
+Two macros,
+both GNU extensions,\" from groff 1.19
+are called internally by the
+.I groff man
+package to format page headers and footers and can be redefined by the
+administrator in a site's
+.I man.local
+file
+(see section \(lqFiles\(rq below).
+.
+The presentation of
+.B .TH
+above describes the default headers and footers.
+.
+Because these macros are hooks for
+.I groff man
+internals,
+man pages have no reason to call them.
+.
+Such hook definitions will likely consist of \lq.sp\rq and
+\lq.tl\rq requests.
+.
+They must also increase the page length with \lq.pl\rq requests in
+continuous rendering mode;
+.B .PT
+furthermore has the responsibility of emitting a PDF bookmark after
+writing the first page header in a document.
+.
+Consult the existing implementations in
+.I an.tmac
+when drafting replacements.
+.
+.
+.TP
+.B .BT
+Set the page footer text
+(\(lqbottom trap\(rq).
+.
+.
+.TP
+.B .PT
+Set the page header text
+(\(lqpage trap\(rq).
+.
+.
+.P
+To remove a page header or footer entirely,
+`define' the appropriate macro as empty rather than deleting it.
+.
+.
+.\" ====================================================================
+.SS "Deprecated features"
+.\" ====================================================================
+.
+Use of the following in man pages for public distribution is
+discouraged.
+.
+.
+.TP
+.BR .AT " "\c
+.IR system " " release 
+Alter the footer for use with legacy AT&T man pages,
+overriding any definition of the
+.I footer-inside
+argument to
+.BR .TH .
+.
+This macro exists only to render man pages from historical systems.
+.
+.
+.IP
+.I system
+can be any of the following.
+.
+.
+.RS \" Invisibly move left margin to current .IP indentation.
+.RS \" Now indent further, visibly.
+.TP
+3
+7th edition
+.I (default)
+.
+.
+.TP
+4
+System III
+.
+.
+.TP
+5
+System V
+.RE \" Move left margin back to .IP indentation.
+.RE \" Move left margin back to standard position.
+.
+.
+.IP
+The optional
+.I release
+argument specifies the release number,
+as in \(lqSystem\~V Release\~3\(rq.
+.
+.
+.TP
+.B .DT
+Reset tab stops to the default
+_ifnotstyle()dnl
+(every 0.5i).
+_endif()dnl
+_ifstyle()dnl
+(every 0.5i inches).
+_endif()dnl
+.
+.IP
+Use of this presentation-oriented macro is deprecated.
+.
+It translates poorly to HTML,
+under which exact space control and tabulation are not readily
+available.
+.
+Thus,
+information or distinctions that you use tab stops to express are likely
+to be lost.
+.
+If you feel tempted to change the tab stops such that calling this macro
+later is desirable to restore them,
+you should probably be composing a table using
+.MR @g@tbl @MAN1EXT@
+instead.
+.
+.
+.TP
+.BR .HP " "\c
+.IR indentation 
+Set up a paragraph with a hanging left indentation.
+.
+The
+.I indentation
+argument,
+if present,
+is handled as with
+.BR .TP .
+.
+.
+.IP
+Use of this presentation-oriented macro is deprecated.
+.
+A hanging indentation cannot be expressed naturally under HTML,
+and
+.RI non- roff -based
+man page interpreters may treat
+.B .HP
+as an ordinary paragraph.
+.
+Thus,
+information or distinctions you mean to express with indentation may be
+lost.
+.
+.
+.TP
+.BI .OP " option-name"\/\c
+.RI " " option-argument 
+Indicate an optional command parameter called
+.IR option-name ,
+which is set in bold.
+.
+If the option takes an argument,
+specify
+.I option-argument
+using a noun,
+abbreviation,
+or hyphenated noun phrase.
+.
+If present,
+.I option-argument
+is preceded by a space and set in italics.
+.
+Square brackets in roman surround both arguments.
+.
+.
+.IP
+Use of this quasi-semantic macro,
+.\" https://github.com/n-t-roff/DWB3.3/blob/master/macros/man/an.sr#L37
+an extension originating in Documenter's Workbench
+.IR troff ,\" DWB
+is deprecated.
+.
+It cannot easily be used to annotate options that take optional
+arguments or options whose arguments have internal structure
+(such as a mixture of literal and variable components).
+.
+One could work around these limitations with font selection escape
+sequences,
+but it is preferable to use font style alternation macros,
+which afford greater flexibility.
+.
+.
+.TP
+.BR .PD " "\c
+.IR vertical-space 
+Define the vertical space between paragraphs or (sub)sections.
+.
+The optional argument
+.I vertical-space
+specifies the amount;
+the default scaling unit is \(lqv\(rq.
+.
+Without an argument,
+the spacing is reset to its default value;
+see subsection \(lqHorizontal and vertical spacing\(rq above.
+.
+.
+.IP
+Use of this presentation-oriented macro is deprecated.
+.
+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
+to express are likely to be lost.
+.
+.
+.TP
+.BR .UC " "\c
+.IR version 
+Alter the footer for use with legacy BSD man pages,
+overriding any definition of the
+.I footer-inside
+argument to
+.BR .TH .
+.
+This macro exists only to render man pages from historical systems.
+.
+.
+.IP
+.I version
+can be any of the following.
+.
+.
+.RS \" Invisibly move left margin to current .IP indentation.
+.RS \" Now indent further, visibly.
+.TP
+3
+3rd Berkeley Distribution
+.I (default)
+.
+.
+.TP
+4
+4th Berkeley Distribution
+.
+.
+.TP
+5
+4.2 Berkeley Distribution
+.
+.
+.TP
+6
+4.3 Berkeley Distribution
+.
+.
+.TP
+7
+4.4 Berkeley Distribution
+.RE \" Move left margin back to .IP indentation.
+.RE \" Move left margin back to standard position.
+.
+.
+.\" ====================================================================
+.SS History
+.\" ====================================================================
+.
+.MT m.douglas.mcilroy@dartmouth.edu
+M.\& Douglas McIlroy
+.ME
+designed,
+implemented,
+and documented the AT&T
+.I man
+macros
+for
+Unix Version\~7 (1979) and employed them
+to edit the first volume of its
+.IR "Programmer's Manual" ,
+a compilation of all man pages supplied by the system.
+.
+That
+.I man
+supported the macros listed in this page not described as extensions,
+except
+.B .P
+.\" .SS was implemented in tmac.an but not documented in man(7).
+and the deprecated
+.B .AT
+and
+.BR .UC .
+.
+The only strings defined were
+.B R
+and
+.BR S ;
+no registers were documented.
+.
+.
+.P
+.B .UC
+appeared in 3BSD (1980).
+.
+.\" per https://archive.org/details/\
+.\" bitsavers_attunixSysalRelease3Jun80_33886798
+Unix System\~III (1980) introduced
+.B .P
+.\" ...and de-documented .LP...
+and exposed the registers
+.B IN
+and
+.BR LL ,
+.\" ...as well as \nPD, which we implement but don't expose.
+which had been internal to Seventh Edition Unix
+.IR man .
+.
+.\" This inference is based on RCS idents of "PWB Manual Entry Macros"
+.\" from various forms of "an.src" distributed with System III (an.src
+.\" 1.35, dated 5/6/80, lacks the Tm string), Research Unix Version 10
+.\" (1.36, dated 11/11/80, has it), Ultrix 3.1 (1.37, dated 12/19/80,
+.\" retains it) and "pdp11v" (also 1.37).  One source (S. S. Pirzada)
+.\" says PWB 2.0 was released in June 1979.  I found no record of later
+.\" releases and cannot account for the discrepancy (field updates?).
+.\" -- GBR
+PWB/UNIX 2.0 (1980) added the
+.B Tm
+string.
+.
+4BSD (1980) added
+.\" undocumented .VS and .VE macros to mark regions with 12-point box
+.\" rules (\br) as margin characters, as well as...
+.B lq
+and
+.B rq
+strings.
+.
+.\" The SunOS inferences here and below are based on inspection of SunOS
+.\" 2.0 (May 1985), 3.2 (September 1986), 3.5 (January 1988), and 4.0
+.\" (December 1988) tape archives (only).
+SunOS\~2.0 (1985) recognized
+.BR C ,
+.BR D ,
+.BR P ,
+and
+.B X
+registers.
+.
+4.3BSD (1986) added
+.\" undocumented .DS and .DE macros for "displays", which are .RS/.RE
+.\" wrappers with filling disabled and vertical space of 1v before and
+.\" .5v after, as well as...
+.B .AT
+and
+.BR .P .
+.
+.\" Per Doug McIlroy in
+.\" <https://lists.gnu.org/archive/html/groff/2019-07/msg00038.html>...
+Ninth Edition Research Unix (1986) introduced
+.B .EX
+and
+.BR .EE .
+.
+SunOS\~4.0 (1988) added
+.BR .SB .
+.
+.
+.P
+The foregoing features were what James Clark implemented in early
+versions of
+.IR groff .
+.
+.
+Later,
+.I groff
+1.20 (2009) originated
+.BR .SY / .YS ,
+.BR .TQ ,
+.BR .MT / .ME ,
+and
+.BR .UR / .UE .
+.\" ...along with implementations of OP, EX, and EE.
+.
+Plan\~9 from User Space's
+.I troff \" plan9port
+introduced
+.B .MR
+in 2020.
+.\" https://github.com/9fans/plan9port/commit/\
+.\"  977b25a76ae8263e53fb4eb1abfc395769f23e3d
+.\"  d32deab17bfffa5bffc5fab3e6577558e40888c5
+.\"  36cd4c58c1346375b98f517fb8568be5bb47618d
+.
+.
+.br
+.ne 4v
+.\" ====================================================================
+.SH Options
+.\" ====================================================================
+.
+The following
+.I groff
+options set registers
+(with
+.BR \-r )
+and strings
+(with
+.BR \-d )
+recognized and used by the
+.I man
+macro package.
+.
+To ensure rendering consistent with output device capabilities and
+reader preferences,
+man pages should never manipulate them.
+.
+.
+.TP
+.BI \-dAD= adjustment-mode
+Set line adjustment to
+.I adjustment-mode,
+which is typically
+.RB \lq b \rq
+for adjustment to both margins
+(the default),
+or
+.RB \lq l \rq
+for left alignment
+(ragged right margin).
+.
+Any valid argument to
+.IR groff 's
+\lq.ad\rq request may be used.
+.
+See
+.MR groff @MAN7EXT@
+for less-common choices.
+.
+.
+.TP
+.B \-rcR=1
+Enable continuous rendering.
+.
+Output is not paginated;
+instead,
+one
+(potentially very long)
+page is produced.
+.
+This is the default for terminal and HTML devices.
+.
+Use
+.B \-rcR=0
+to disable it on terminal devices;
+on HTML devices,
+it cannot be disabled.
+.
+.
+.TP
+.B \-rC1
+Number output pages consecutively,
+in strictly increasing sequence,
+rather than resetting the page number to\~1
+(or the value of register
+.BR P )
+with each new
+.I man
+document.
+.
+.
+.TP
+.B \-rCS=1
+Set section headings
+(the argument(s) to
+.BR .SH )
+in full capitals.
+.
+This transformation is off by default because it discards case
+distinction information.
+.
+.
+.TP
+.B \-rCT=1
+Set the man page topic
+(the first argument to
+.BR .TH )
+in full capitals in headers and footers.
+.
+This transformation is off by default because it discards case
+distinction information.
+.
+.
+.TP
+.B \-rD1
+Enable double-sided layout,
+formatting footers for even and odd pages differently;
+see the description of
+.B .TH
+in subsection \(lqDocument structure macros\(rq above.
+.
+.
+.TP
+.BI \-rFT= footer-distance
+Set distance of the footer relative to the bottom of the page to
+.I footer-distance;
+this amount is always negative.
+.
+At one half-inch above this location,
+the page text is broken before writing the footer.
+.
+Ignored if continuous rendering is enabled.
+.
+The default is \-0.5i.
+.
+.
+.TP
+.BI \-dHF= heading-font
+Set the font used for section and subsection headings;
+the default is
+.RB \(lq B \(rq
+(bold style of the default family).
+.
+Any valid argument to
+.IR groff 's
+\lq.ft\rq request may be used.
+.
+See
+.MR groff @MAN7EXT@ .
+.
+.
+.TP
+.B \-rHY=0
+Disable automatic hyphenation.
+.
+Normally,
+it is enabled\~(1).
+.
+The hyphenation mode is determined by the
+.I groff
+locale;
+see section \lqLocalization\lq of
+.MR groff @MAN7EXT@ .
+.
+.
+.TP
+.BI \-rIN= standard-indentation
+Set the amount of indentation used for ordinary paragraphs
+.RB ( .P
+and its synonyms)
+and the default indentation amount used by
+.BR .IP ,
+.BR .RS ,
+.BR .TP ,
+.\" .TQ inherits its indentation from the preceding .TP.
+and the deprecated
+.BR .HP .
+.
+See subsection \(lqHorizontal and vertical spacing\(rq above for the
+default.
+.
+For
+terminal devices,
+.I standard-indentation
+should always be an integer multiple of unit \(lqn\(rq to get consistent
+indentation.
+.
+.
+.TP
+.BI \-rLL= line-length
+Set line length;
+the default is 78n for terminal devices
+and 6.5i for typesetting devices.
+.
+.
+.TP
+.BI \-rLT= title-length
+Set the line length for titles.
+_ifstyle()dnl
+.
+(\(lqTitles\(rq is the
+.I roff
+term for headers and footers.)
+_endif()dnl
+.
+By default,
+it is set to the line length
+(see
+.B \-rLL
+above).
+.
+.
+.TP
+.BI \-dMF= man-page-topic-font
+Set the font used for man page topics named in
+.B .TH
+and
+.B .MR
+calls;
+the default is
+.RB \(lq I \(rq
+(italic style of the default family).
+.
+Any valid argument to
+.IR groff 's
+\lq.ft\rq request may be used.
+.
+If the
+.B MF
+string ends in \lqI\rq,
+it is assumed to be an oblique typeface,
+and italic corrections are applied before and after man page topics.
+.
+.
+.TP
+.BI \-rP n
+Start enumeration of pages at
+.IR n .
+.
+The default is\~1.
+.
+.
+.TP
+.BI \-rS type-size
+Use
+.I type-size
+for the document's body text;
+acceptable values are 10,
+11,
+or 12 points.
+.
+See subsection \(lqFont style macros\(rq above for the default.
+.
+.
+.TP
+.BI \-rSN= subsection-indentation
+Set indentation of subsection headings to
+.I subsection-indentation.
+.
+See subsection \(lqHorizontal and vertical spacing\(rq above for the
+default.
+.
+.
+.br
+.ne 4v
+.TP
+.B \-rU1
+Enable generation of URI hyperlinks in the
+.I grohtml
+and
+.I grotty
+output drivers.
+.
+.I grohtml
+enables them by default;
+.I grotty
+does not,
+pending more widespread pager support for OSC\~8 escape sequences.
+.
+Use
+.B \-rU0
+to disable hyperlinks;
+this will make the arguments to
+.B MT
+and
+.B UR
+calls visible in the document text produced by link-capable drivers.
+.
+.
+.TP
+.BI \-rX p
+Number successors of
+.RI page\~ p
+as
+.IR p a,
+.IR p b,
+.IR p c,
+and so forth.
+.
+The register tracking the suffixed page letter uses format \(lqa\(rq
+(see the \(lq.af\(rq request in
+.MR groff @MAN7EXT@ ).
+.
+_ifstyle()dnl
+For example,
+the option
+.B \-rX2
+produces the following page
+numbers: 1,
+2,
+2a,
+2b,
+\&.\|.\|.\|,
+2aa,
+2ab,
+and so on.
+_endif()dnl
+.
+.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
+.
+.TP
+.I @MACRODIR@/\:an\:.tmac
+Most
+.I man
+macros are defined in this file.
+.
+It also loads extensions from
+.I \%an\-ext.tmac
+(see below).
+.
+.
+.TP
+.I @MACRODIR@/\:\%andoc\:.tmac
+This brief
+.I groff
+program detects whether the
+.I man
+or
+.I mdoc
+macro package is being used by a document and loads the correct macro
+definitions,
+taking advantage of the fact that pages using them must call
+.B .TH
+or
+.BR .Dd ,
+respectively,
+before any other macros.
+.
+A
+.I man
+program or user typing,
+for example,
+.RB \lq "groff \-mandoc page.1" \rq,
+need not know which package the file
+.I page.1
+uses.
+.
+Multiple man pages,
+in either format,
+can be handled;
+.I \%andoc
+reloads each macro package as necessary.
+.
+.
+.TP
+.I @MACRODIR@/\:\%an\-ext\:.tmac
+Except for
+.BR .SB ,
+definitions of macros described above as extensions
+are contained in this file;
+in some cases,
+they are simpler versions of definitions appearing in
+.IR an.tmac ,
+and are ignored if the formatter is GNU
+.IR troff .\" GNU
+.
+They are written to be compatible with AT&T
+.I troff \" AT&T
+and permissively licensed\(emnot copylefted.
+.
+To reduce the risk of name space collisions,
+string and register names begin only with
+.RB \lq m \rq .
+.
+We encourage man page authors
+who are concerned about portability to legacy Unix systems
+to copy these definitions into their pages,
+and maintainers of
+.I troff \" generic
+implementations or work-alike systems that format man pages
+to re-use them.
+.
+.
+.IP
+The definitions for these macros are read after a page calls
+.BR .TH ,
+so they will replace any macros of the same names preceding it in your
+file.
+.
+If you use your own implementations of these macros,
+they must be defined after
+.B .TH
+is called to have any effect.
+.
+Furthermore,
+it is wise to `define' such page-local macros
+(if at all)
+after the \(lqName\(rq section to accommodate timid
+.I makewhatis
+or
+.I mandb
+implementations that may give up their scan for indexing material early.
+.
+.
+.TP
+.I @MACRODIR@/\:man\:.tmac
+This is a wrapper that loads
+.IR an.tmac .
+.
+.
+.TP
+.I @MACRODIR@/\:\%mandoc\:.tmac
+This is a wrapper that loads
+.IR \%andoc.tmac .
+.
+.
+.TP
+.I @LOCALMACRODIR@/\:\%man\:\%.local
+Put site-local changes and customizations into this file.
+_ifstyle()dnl
+.
+.
+.RS
+.RS
+.P
+.EX
+\&.\e" Use narrower indentation on terminals and similar.
+\&.if n .nr IN 4n
+\&.\e" Put only one space after the end of a sentence.
+\&.ss 12 0 \e" See groff(@MAN7EXT@).
+\&.\e" Keep pages narrow even on wide terminals.
+\&.if n .if \(rsnLL>78n .nr LL 78n
+\&.\e" Ensure hyperlinks are enabled for terminals.
+\&.nr U 1
+.EE
+.RE
+.RE
+.
+.
+.IP
+On multi-user systems,
+it is more considerate to users whose preferences may differ from the
+administrator's to be less aggressive with such settings,
+or to permit their override with a user-specific
+.I man.local
+file.
+.
+Place the requests below at the end of the site-local file to
+manifest courtesy.
+.
+.br
+.ne 3v
+.RS
+.RS
+.EX
+\&.soquiet \eVXDG_CONFIG_HOME/man.local
+\&.soquiet \eVHOME/.man.local
+.EE
+.RE
+.
+However,
+a security-sandboxed
+.MR man 1 \" such as man-db 2.8.5
+program may lack permission to open such files.
+.RE
+.
+.
+.\" ====================================================================
+.SH Notes
+.\" ====================================================================
+.
+Some tips on troubleshooting your man pages follow.
+.
+.
+.TP
+\(bu Some ASCII characters look funny or copy and paste wrong.
+.
+On devices with large glyph repertoires,
+like UTF-8-capable terminals and PDF,
+several keyboard glyphs are mapped to code points outside the Unicode
+basic Latin range because that usually results in better typography in
+the general case.
+.
+When documenting GNU/Linux command or C language syntax,
+however,
+this translation is sometimes not desirable.
+.
+.
+.IP
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
+.TS
+c c
+rfCB lfCB.
+To get a \(lqliteral\(rq.\|.\|.	.\|.\|.should be input.
+_
+\(aq	\(rs(aq
+\-	\(rs\-
+\(rs	\(rs(rs
+\(ha	\(rs(ha
+\(ga	\(rs(ga
+\(ti	\(rs(ti
+_
+.TE
+.
+.
+.IP
+Additionally,
+if a neutral double quote (") is needed in a macro argument,
+you can use
+.B \(rs(dq
+to get it.
+.
+You should
+.I not
+use
+.B \(rs(aq
+for an ordinary apostrophe
+(as in \(lqcan't\(rq)
+or
+.B \(rs\-
+for an ordinary hyphen
+(as in \(lqword-aligned\(rq).
+.
+Review subsection \(lqPortability\(rq above.
+.
+.
+.TP
+\(bu Do I ever need to use an empty macro argument ("")?
+.
+Probably not.
+.
+When this seems necessary,
+often a shorter or clearer alternative is available.
+.
+.
+.IP
+.if t .ne 10v
+.if n .ne 16v \" account for horizontal rules
+.TS
+c c
+lfCB lfCB.
+Instead of.\|.\|.	.\|.\|.should be considered.
+_
+\&.TP \(dq\(dq	.TP
+_
+\&.BI \(dq\(dq \fIitalic-text bold-text	.IB \fIitalic-text bold-text
+_
+\&.TH foo 1 \(dq\(dq \(dqfoo 1.2.3\(dq	.TH foo 1 \
+\f(CIyyyy\fP-\f(CImm\fP-\f(CIdd\fP \(dqfoo 1.2.3\(dq
+_
+\&.IP \(dq\(dq 4n	.IP
+_
+\&.IP \(dq\(dq 4n	.RS 4n
+\fIparagraph	.P
+\fR.\|.\|.	\fIparagraph
+\fR.\|.\|.	.RE
+_
+\&.B one two \(dq\(dq three	.B one two three
+.TE
+.
+.
+.IP
+In the title heading
+.RB ( .TH ),
+the date of the page's last revision is more important than packaging
+information;
+it should not be omitted.
+.
+Ideally,
+a page maintainer will keep both up to date.
+.
+.
+.IP
+.B .IP
+is sometimes ill-understood and misused,
+especially when no marker argument is supplied\(eman indentation
+argument is not required.
+.
+By setting an explicit indentation,
+you may be overriding the reader's preference as set with the
+.B \-rIN
+option.
+.
+If your page renders adequately without one,
+use the simpler form.
+.
+If you need to indent multiple (unmarked) paragraphs,
+consider setting an inset region with
+.B .RS
+and
+.B .RE
+instead.
+.
+.
+.IP
+In the last example,
+the empty argument does have a subtly different effect than its
+suggested replacement:
+the empty argument causes an additional space character to be
+interpolated between the arguments \(lqtwo\(rq and \(lqthree\(rq\(embut
+it is a regular breaking space,
+so it can be discarded at the end of an output line.
+.
+It is better not to be subtle,
+particularly with space,
+which can be overlooked in source and rendered forms.
+.
+.
+.TP
+.RB \(bu " .RS" " doesn't indent relative to my indented paragraph."
+.
+The
+.B .RS
+macro sets the left margin;
+that is,
+the position at which an
+.I ordinary
+paragraph
+.RB ( .P
+and its synonyms)
+will be set.
+.
+.BR .IP ,
+.BR .TP ,
+and the deprecated
+.B .HP
+use the same default indentation.
+.
+If not given an argument,
+.B .RS
+moves the left margin by this same amount.
+.
+To create an inset relative to an indented paragraph,
+call
+.B .RS
+repeatedly until an acceptable indentation is achieved,
+or give
+.B .RS
+an indentation argument that is at least as much as the paragraph's
+indentation amount relative to an adjacent
+.B .P
+paragraph.
+.
+See subsection \(lqHorizontal and vertical spacing\(rq above for the
+values.
+.
+.
+.IP
+Another approach you can use with tagged paragraphs is to place an
+.B .RS
+call immediately after the paragraph tag;
+this will also force a break regardless of the width of the tag,
+which some authors prefer.
+.
+Follow-up paragraphs under the tag can then be set with
+.B .P
+instead of
+.BR .IP .
+.
+Remember to use
+.B .RE
+to end the indented region before starting the next tagged paragraph
+(at the appropriate nesting level).
+.
+.
+.TP
+.RB \(bu " .RE" " doesn't move the inset back to the expected level."
+.TQ
+\(bu warning: scaling unit invalid in context
+.TQ
+\(bu warning: register \(aqan\-saved\-margin\c
+.IR n "\(aq not defined"
+.TQ
+\(bu warning: register \(aqan\-saved\-prevailing\-indent\c
+.IR n "\(aq not defined"
+.
+The
+.B .RS
+macro takes an
+.I indentation amount
+as an argument;
+the
+.B .RE
+macro's argument is a specific
+.I inset level.
+.
+.B .RE\~1
+goes to the level before any
+.B .RS
+macros were called,
+.B .RE\~2
+goes to the level of the first
+.B .RS
+call you made,
+and so forth.
+.
+If you desire symmetry in your macro calls,
+simply issue one
+.B .RE
+without an argument
+for each
+.B .RS
+that precedes it.
+.
+.
+.IP
+After calls to the
+.B .SH
+and
+.B .SS
+sectioning macros,
+all relative insets are cleared and calls to
+.B .RE
+have no effect until
+.B .RS
+is used again.
+.
+.
+.TP
+\(bu Do I need to keep typing the indentation in a series of \c
+.BR .IP " calls?"
+.
+Not if you don't want to change it.
+.
+Review subsection \(lqHorizontal and vertical spacing\(rq above.
+.
+.
+.IP
+.if t .ne 5v
+.if n .ne 7v \" account for horizontal rules
+.TS
+c c
+lfCB lfCB.
+Instead of.\|.\|.	.\|.\|.should be considered.
+_
+\&.IP \(rs(bu 4n	.IP \(rs(bu 4n
+\fIparagraph	\fIparagraph
+\&.IP \(rs(bu 4n	.IP \(rs(bu
+\fIanother-paragraph	\fIanother-paragraph
+_
+.TE
+.
+.
+.TP
+\(bu Why doesn't the package provide a string to insert an ellipsis?
+.
+Examples of ellipsis usage are shown above,
+in subsection \lqCommand synopsis macros\rq.
+.
+The idiomatic
+.I roff
+ellipsis is three dots (periods)
+with thin space escape sequences
+.B \rs|
+internally separating them.
+.
+Since dots both begin control lines and are candidate end-of-sentence
+characters,
+however,
+it is sometimes necessary to prefix and/or suffix an ellipsis with the
+dummy character escape sequence
+.BR \rs& .
+.
+That fact stands even if a string is defined to contain the sequence;
+further,
+if the string ends with
+.BR \rs& ,
+end-of-sentence detection is defeated when you use the string at the end
+of an actual sentence.
+.
+(Ending a sentence with an ellipsis is often poor style,
+but not always.)
+.
+A hypothetical string
+.B EL
+that contained an ellipsis,
+but not the trailing dummy character
+.BR \rs& ,
+would then need to be suffixed with the latter
+when not ending a sentence.
+.
+.
+.IP
+.if t .ne 5v
+.if n .ne 7v \" account for horizontal rules
+.TS
+C C
+LfCB LfCB.
+Instead of.\|.\|.	.\|.\|.do this.
+_
+\&.ds EL \rs&.\rs|.\rs|.	Arguments are
+Arguments are	.IR src-file\rs\ti .\rs|.\rs|.\rs&
+\&.IR src-file\rs\ti \rs*(EL\rs&	.IR dest-dir .
+\&.IR dest-dir .
+_
+.TE
+.
+.
+.IP
+The first column practices a false economy;
+the savings in typing is offset by the cost of obscuring even the
+suggestion of an ellipsis to a casual reader of the source document,
+and reduced portability to
+.RI non- roff
+man page formatters that cannot handle string definitions.
+.
+.
+.IP
+There is an ellipsis code point in Unicode,
+and some fonts have an ellipsis glyph,
+which some man pages have accessed in a non-portable way with the
+font-dependent
+.B \rsN
+escape sequence.
+.
+We discourage the use of these;
+on terminals,
+they may crowd the dots into a half-width character cell,
+and will not render at all if the output device doesn't have the glyph.
+.
+In syntax synopses,
+missing ellipses can cause great confusion.
+.
+Dots and space are universally supported.
+.\" XXX: Does an unconditional _preceding_ dummy character cause
+.\" problems?
+_endif()dnl
+.
+.
+.\" ====================================================================
+.SH Authors
+.\" ====================================================================
+.
+The initial GNU implementation of the
+.I man
+macro package was written by James Clark. \" by 1.01
+.
+Later,
+.MT wl@\:gnu\:.org
+Werner Lemberg
+.ME
+supplied the
+.BR S , \" 1.16
+.BR LT , \" 1.18
+and
+.B cR \" 1.17
+registers,
+the last a 4.3BSD-Reno
+.IR mdoc (7)
+feature.
+.\" "Assume nroff on crt's sic only if cR==1"
+.\" https://minnie.tuhs.org/cgi-bin/utree.pl
+.\"   ?file=4.3BSD-Reno/share/tmac/tmac.doc
+.
+.MT kollar@\:alltel\:.net
+Larry Kollar
+.ME
+added the
+.BR FT ,
+.BR HY ,
+and
+.B SN
+registers;
+the
+.B HF
+string;
+and the
+.B PT
+and
+.B BT
+macros.
+.
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
+.ME
+implemented the
+.B AD
+and
+.B MF
+strings;
+.BR CS ,
+.BR CT ,
+and
+.B U
+registers;
+and the
+.B MR
+macro. \" all 1.23
+.
+.
+Except for
+.BR .SB , \" Clark, as noted above
+the extension macros were written by
+Lemberg,
+.MT esr@\:thyrsus\:.com
+Eric S.\& Raymond
+.ME ,
+and
+Robinson. \" 1.23: MR
+.
+.
+.br
+.ne 3v
+.P
+This document was originally written for the Debian GNU/Linux system by
+.MT sgk@\:debian\:.org
+Susan G.\& Kleinmann
+.ME .
+.
+It was corrected and updated by Lemberg and Robinson.
+.
+The extension macros were documented by Raymond and Robinson.
+_ifstyle()dnl
+Raymond also originated the portability section,
+to which
+.MT schwarze@\:usta\:.de
+Ingo Schwarze
+.ME
+contributed most of the material on escape sequences.
+_endif()dnl
+.
+.
+.\" ====================================================================
+.SH "See also"
+.\" ====================================================================
+.
+.MR @g@tbl @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+and
+.MR @g@refer @MAN1EXT@
+are preprocessors used with man pages.
+.
+.MR man 1
+describes the man page librarian on your system.
+.
+.MR groff_mdoc @MAN7EXT@
+details the
+.I groff
+version of the BSD-originated alternative macro package for man pages.
+.
+.
+.P
+_ifstyle()dnl
+.MR groff_man @MAN7EXT@ ,
+_endif()dnl
+_ifnotstyle()dnl
+.MR groff_man_style @MAN7EXT@ ,
+_endif()dnl
+.MR groff @MAN7EXT@ ,
+.MR groff_char @MAN7EXT@ ,
+.MR man 7
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_man_7_man_C
+.do rr *groff_groff_man_7_man_C
+.
+.
+.\" Local Variables:
+.\" fill-column: 72
+.\" mode: nroff
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_mdoc.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_mdoc.7.man Changed

@@ -43,465 +43,556 @@
 .\"     @(#)mdoc.samples.7 8.2 (Berkeley) 12/30/93
 .\"
 .\" This reference invokes every macro in the package several times and
-.\" is guaranteed to give a worst case performance for an already
+.\" is guaranteed to give worst-case performance for an already
 .\" extremely slow package.
-.\"
 .
-.Dd November 2, 2010
-.Dt GROFF_MDOC 7
-.Os
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_mdoc_7_man_C \n.cp
+.cp 0
+.
+.
+.Dd @MDATE@
+.Dt groff_mdoc 7
+.Os groff @VERSION@
 .
-.Sh NAME
+.
+.Sh Name
 .
 .Nm groff_mdoc
-.Nd reference for groff's mdoc implementation
+.Nd compose BSD-style manual (man) pages with GNU
+.Xr roff
 .
 .
-.Sh SYNOPSIS
+.Sh Synopsis
 .
-.Nm groff Fl m Ns Cm doc Ar
+.Nm groff Fl m Ns Cm doc Ar file No ...
 .
 .
-.Sh DESCRIPTION
+.Sh Description
 .
-A complete reference for writing
+The GNU implementation of the
+.Xr mdoc
+macro package is part of the
+.Xr groff @MAN1EXT@
+document formatting system.
+.
+.Xr mdoc
+is a
+structurally- and semantically-oriented package for writing
 .Ux
-manual pages with the
-.Nm \-mdoc
-macro package; a
-.Em content Ns -based
-and
-.Em domain Ns -based
-formatting package for
-.Tn GNU
-.Xr troff 1 .
-Its predecessor, the
-.Xr \-man 7
-package, addressed page layout leaving the manipulation of fonts and other
-typesetting details to the individual author.
-In
-.Nm \-mdoc ,
-page layout macros make up the
+manual pages with
+.Xr @g@troff @MAN1EXT@ .
+.
+Its predecessor,
+the
+.Xr man 7
+package,
+primarily addressed page layout and presentational concerns,
+leaving the selection of fonts and other typesetting details to the
+individual author.
+.
+This discretion has led to divergent styling practices among authors
+using it.
+.
+.
+.Pp
+.Xr mdoc
+organizes its macros into
+.Em domains .
+.
+The
 .Em "page structure domain"
-which consists of macros for titles, section headers, displays and lists
-\(en essentially items which affect the physical position of text on a
-formatted page.
-In addition to the page structure domain, there are two more domains, the
-.Em manual
-domain and the
-.Em general
-text domain.
-The general text domain is defined as macros which perform tasks such as
-quoting or emphasizing pieces of text.
-The manual domain is defined as macros that are a subset of the day to day
-informal language used to describe commands, routines and related
+lays out the page and
+comprises titles,
+section headings,
+displays,
+and lists.
+.
+The
+.Em "general text domain"
+supplies macros to quote or style text,
+or to interpolate common noun phrases.
+.
+The
+.Em "manual domain"
+offers semantic macros corresponding to the terminology used by
+practitioners in discussion of
 .Ux
-files.
-Macros in the manual domain handle command names, command-line arguments and
-options, function names, function parameters, pathnames, variables, cross
-references to other manual pages, and so on.
-These domain items have value for both the author and the future user of the
+commands,
+routines,
+and files.
+.
+Manual domain macros distinguish
+command-line arguments and options,
+function names,
+function parameters,
+pathnames,
+variables,
+cross references to other manual pages,
+and so on.
+.
+These terms are meaningful both to the author and the readers of a
 manual page.
-Hopefully, the consistency gained across the manual set will provide easier
-translation to future documentation tools.
+.
+It is hoped that the resulting increased consistency of the man page
+corpus will enable easier translation to future documentation tools.
+.
+.
 .Pp
-Throughout the
+Throughout
 .Ux
-manual pages, a manual entry is simply referred to as a man page, regardless
-of actual length and without sexist intention.
+documentation,
+a manual entry is referred to simply as a
+.Dq "man page" ,
+regardless of its length,
+without gendered implication,
+and irrespective of the macro package selected for its composition.
 .
 .
-.Sh "GETTING STARTED"
+.Sh "Getting started"
 .
-The material presented in the remainder of this document is outlined
-as follows:
+The
+.Xr mdoc
+package attempts to simplify man page authorship and maintenance without
+requiring mastery of the
+.Xr roff
+language.
+.
+This document presents only essential facts about
+.Xr roff.
+.
+For further background,
+including a discussion of basic typographical concepts like
+.Dq breaking ,
+.Dq filling ,
+and
+.Dq adjustment ,
+see
+.Xr roff @MAN7EXT@ .
+.
+Specialized units of measurement also arise,
+namely
+ens,
+vees,
+inches,
+and points,
+abbreviated
+.Dq n ,
+.Dq v ,
+.Dq i ,
+and
+.Dq p ,
+respectively;
+see section
+.Sx Measurements
+of
+.Xr groff @MAN7EXT@ .
 .
-.Bl -enum -width 3n -offset indent
-.  It
-.  Tn "TROFF IDIOSYNCRASIES"
-.
-.  Bl -tag -width 2n -compact
-.    It "Macro Usage"
-.    It "Passing Space Characters in an Argument"
-.    It "Trailing Blank Space Characters"
-.    It "Escaping Special Characters"
-.    It "Other Possible Pitfalls"
-.  El
-.
-.  It
-.  Tn "A MANUAL PAGE TEMPLATE"
-.
-.  It
-.  Tn "CONVENTIONS"
-.
-.  It
-.  Tn "TITLE MACROS"
-.
-.  It
-.  Tn "INTRODUCTION OF MANUAL AND GENERAL TEXT DOMAINS"
-.
-.  Bl -tag -width 2n -compact
-.    It "What's in a Name" Ns ...
-.    It "General Syntax"
-.  El
-.
-.  It
-.  Tn "MANUAL DOMAIN"
-.
-.  Bl -tag -width 2n -compact
-.    It "Addresses"
-.    It "Author Name"
-.    It "Arguments"
-.    It "Configuration Declarations (Section Four Only)"
-.    It "Command Modifiers"
-.    It "Defined Variables"
-.    It "Errno's"
-.    It "Environment Variables"
-.    It "Flags"
-.    It "Function Declarations"
-.    It "Function Types"
-.    It "Functions (Library Routines)"
-.    It "Function Arguments"
-.    It "Return Values"
-.    It "Exit Status"
-.    \" .It "Header File (including source code)"
-.    It "Interactive Commands"
-.    It "Library Names"
-.    It "Literals"
-.    It "Names"
-.    It "Options"
-.    It "Pathnames"
-.    It "Standards"
-.    It "Variable Types"
-.    It "Variables"
-.    It "Manual Page Cross References"
-.  El
-.
-.  It
-.  Tn "GENERAL TEXT DOMAIN"
-.
-.  Bl -tag -width 2n -compact
-.    It "AT&T Macro"
-.    It "BSD Macro"
-.    It "NetBSD Macro"
-.    It "FreeBSD Macro"
-.    It "DragonFly Macro"
-.    It "OpenBSD Macro"
-.    It "BSD/OS Macro"
-.    It "UNIX Macro"
-.    It "Emphasis Macro"
-.    It "Font Mode"
-.    It "Enclosure and Quoting Macros"
-.    It "No-Op or Normal Text Macro"
-.    It "No-Space Macro"
-.    It "Section Cross References"
-.    It "Symbolics"
-.    It "Mathematical Symbols"
-.    It "References and Citations"
-.    It "Trade Names (or Acronyms and Type Names)"
-.    It "Extended Arguments"
-.  El
-.
-.  It
-.  Tn "PAGE STRUCTURE DOMAIN"
-.
-.  Bl -tag -width 2n -compact
-.    It "Section Headers"
-.    It "Subsection Headers"
-.    It "Paragraphs and Line Spacing"
-.    It "Keeps"
-.    It "Examples and Displays"
-.    It "Lists and Columns"
-.  El
-.
-.  It
-.  Tn "MISCELLANEOUS MACROS"
-.
-.  It
-.  Tn "PREDEFINED STRINGS"
-.
-.  It
-.  Tn "DIAGNOSTICS"
-.
-.  It
-.  Tn "FORMATTING WITH GROFF, TROFF, AND NROFF"
 .
-.  It
-.  Tn "FILES"
+.Pp
+For brief examples,
+we employ an arrow notation illustrating a transformation of input on
+the left to rendered output on the right.
 .
-.  It
-.  Tn "SEE ALSO"
+Consider the
+.Pf . Ic \&Dq
+macro,
+which double-quotes its arguments.
 .
-.  It
-.  Tn "BUGS"
+.Bl -tag -width ".Dq\ man page" -offset indent -compact
+.It Li ".Dq man page"
+\->
+.Dq man page
 .El
 .
-.\" XXX
-.if t \
-.  ne 7
 .
+.Ss Usage
+.
+An
+.Xr mdoc
+.Em macro
+is
+.Em called
+by placing the
+.Xr roff
+control character,
+.Ql .\&
+(dot)
+at the beginning of a line followed by its name.
+.\" XXX; All mdoc macro names except Brq, Bro, Brc are 2 characters long
+.\" and thus portable to old troffs.  Why the innovation here, when
+.\" `Cq`, `Co`, and `Cc` were available?  Try to sell this reform to
+.\" Ingo Schwarze.
+.
+In this document,
+we often discuss a macro name with this leading dot to identify it
+clearly,
+but the dot is
+.Em not
+part of its name.
 .
-.Sh "TROFF IDIOSYNCRASIES"
+Space or tab characters can separate the dot from the macro name.
 .
-The
-.Nm \-mdoc
-package attempts to simplify the process of writing a man page.
-Theoretically, one should not have to learn the tricky details of
-.Tn GNU
-.Xr troff 1
-to use
-.Nm \-mdoc ;
-however, there are a few limitations which are unavoidable and best gotten
-out of the way.
-And, too, be forewarned, this package is
+Arguments may follow,
+separated from the macro name and each other by spaces,
+but
 .Em not
-fast.
+tabs.
 .
-.Ss "Macro Usage"
+The dot at the beginning of the line prepares the formatter to expect a
+macro name.
 .
-As in
-.Tn GNU
-.Xr troff 1 ,
-a macro is called by placing a
-.Ql .\&
-(dot character) at the beginning of a line followed by the two-character
-(or three-character) name for the macro.
-There can be space or tab characters between the dot and the macro name.
-Arguments may follow the macro separated by spaces (but
-.Em no
-tabs).
-It is the dot character at the beginning of the line which causes
-.Tn GNU
-.Xr troff 1
-to interpret the next two (or more) characters as a macro name.
-A single starting dot followed by nothing is ignored.
-To place a
-.Ql .\&
-(dot character) at the beginning of an input line in some context other than
-a macro invocation, precede the
-.Ql .\&
-(dot) with the
+A dot followed immediately by a newline is ignored;
+this is called the
+.Em "empty request" .
+.
+To begin an input line with a dot
+(or a neutral apostrophe
+.Ql \aq )
+in some context other than a macro call,
+precede it with the
 .Ql \e&
-escape sequence which translates literally to a zero-width space, and is
-never displayed in the output.
+escape sequence;
+this is a dummy character,
+not formatted for output.
+.
+The backslash is the
+.Xr roff
+escape character;
+it can appear anywhere and it always followed by at least one more
+character.
+.
+If followed by a newline,
+the backslash escapes the input line break;
+you can thus keep input lines to a reasonable length without affecting
+their interpretation.
+.
+.
 .Pp
-In general,
-.Tn GNU
-.Xr troff 1
-macros accept an unlimited number of arguments (contrary to other versions
-of troff which can't handle more than nine arguments).
-In limited cases, arguments may be continued or extended on the next
-line (See
-.Sx Extended Arguments
-below).
-Almost all macros handle quoted arguments (see
-.Sx Passing Space Characters in an Argument
-below).
+Macros in GNU
+.Xr troff
+accept an unlimited number of arguments,
+in contrast to other
+.Xr troff Ns No s
+that often can't handle more than nine.
+.
+In limited cases,
+arguments may be continued or extended on the next input line without
+resort to the
+.Ql \rs Ns Em newline
+escape sequence;
+see subsection
+.Sx "Extended arguments"
+below.
+.
+Neutral double quotes
+.Li \dq
+can be used to group multiple words into an argument;
+see subsection
+.Sx "Passing space characters in an argument"
+below.
+.
+.
 .Pp
-Most of the
-.Nm \-mdoc
-general text domain and manual domain macros are special in that their
-argument lists are
-.Em parsed
-for callable macro names.
-This means an argument on the argument list which matches a general text or
-manual domain macro name (and which is defined to be callable) will be
-executed or called when it is processed.
-In this case the argument, although the name of a macro, is not preceded by
-a
-.Ql .\&
-(dot).
-This makes it possible to nest macros; for example the option macro,
-.Ql .Op ,
-may
-.Em call
-the flag and argument macros,
-.Ql \&Fl
+Most of
+.Xr mdoc Ns No 's
+general text and manual domain macros
+.Em parse
+their argument lists
+for
+.Em callable
+macro names.
+.
+This means that an argument in the list matching a general text or
+manual domain macro name
+(and defined to be callable)
+will be called with the remaining arguments when it is encountered.
+.
+In such cases,
+the argument,
+although the name of a macro,
+is not preceded by a dot.
+.
+Macro calls can thus be nested.
+.
+This approach to macro argument processing is a unique characteristic of
+the
+.Xr mdoc
+package,
+not a general feature of
+.Xr roff
+syntax.
+.
+.
+.Pp
+For example,
+the option macro,
+.Pf . Ic \&Op ,
+may call the flag and argument macros,
+.Pf . Ic \&Fl
 and
-.Ql \&Ar ,
-to specify an optional flag with an argument:
+.Pf . Ic \&Ar ,
+to specify an optional flag with an argument.
 .
-.Bl -tag -width ".Op Fl s Ar bytes" -offset indent
-.It Op Fl s Ar bytes
-is produced by
-.Ql ".Op Fl s Ar bytes"
+.\" Use width of second example below.
+.Bl -tag -width ".Op\ \e&Fl\ s\ \e&Ar bytes" -offset indent -compact
+.It Li ".Op Fl s Ar bytes"
+\->
+.Op Fl s Ar bytes
 .El
 .
-.Pp
-To prevent a string from being interpreted as a macro name, precede the
-string with the escape sequence
-.Ql \e& :
+To prevent a word from being interpreted as a macro name,
+precede it with the dummy character.
 .
-.Bl -tag -width ".Op \&Fl s \&Ar bytes" -offset indent
-.It Op \&Fl s \&Ar bytes
-is produced by
-.Ql ".Op \e&Fl s \e&Ar bytes"
+.Bl -tag -width ".Op\ \e&Fl\ s\ \e&Ar bytes" -offset indent -compact
+.It Li ".Op \e&Fl s \e&Ar bytes"
+\->
+.Op \&Fl s \&Ar bytes
 .El
 .
+.
 .Pp
-Here the strings
-.Ql \&Fl
-and
-.Ql \&Ar
-are not interpreted as macros.
-Macros whose argument lists are parsed for callable arguments are referred
-to as
-.Em parsed
-and macros which may be called from an argument list are referred to as
-.Em callable
-throughout this document.
-This is a technical
-.Em faux pas
-as almost all of the macros in
-.Nm \-mdoc
-are parsed, but as it was cumbersome to constantly refer to macros as
-being callable and being able to call other macros, the term parsed
-has been used.
+In this document,
+macros whose argument lists are parsed for callable arguments are
+referred to as
+.Em parsed ,
+and those that may be called from an argument list are referred to as
+.Em callable .
+.
+This usage is a technical
+.Em "faux pas" ,
+since all
+.Xr mdoc
+macros are in fact interpreted
+(unless prevented with
+.Ql \e& ) ,
+but as it is cumbersome to constantly refer to macros as
+.Dq "being able to call other macros" ,
+we employ the term
+.Dq parsed
+instead.
+.
+Except where explicitly stated,
+all
+.Xr mdoc
+macros are parsed and callable.
+.
 .
 .Pp
-In the following, we call an
-.Nm \-mdoc
-macro which starts a line (with a leading dot) a
+In the following,
+we term an
+.Xr mdoc
+macro that starts a line
+(with a leading dot)
+a
 .Em command
-if this distinction is necessary.
+if a distinction from those appearing as arguments of other macros is
+necessary.
 .
-.Ss "Passing Space Characters in an Argument"
 .
-Sometimes it is desirable to give as an argument a string containing one or
-more blank space characters, say, to specify arguments to commands which
-expect particular arrangement of items in the argument list.
-Additionally, it makes
-.Nm \-mdoc
-working faster.
-For example, the function command
-.Ql .Fn
-expects the first argument to be the name of a function and any remaining
-arguments to be function parameters.
-As
-.Tn ANSI\~C
-stipulates the declaration of function parameters in the parenthesized
-parameter list, each parameter is guaranteed to be at minimum a two word
-string.
+.Ss "Passing space characters in an argument"
+.
+Sometimes it is desirable to give a macro an argument containing one or
+more space characters,
+for instance to specify a particular arrangement of arguments demanded
+by the macro.
+.
+Additionally,
+quoting multi-word arguments that are to be treated the same makes
+.Xr mdoc
+work faster;
+macros that parse arguments do so once
+(at most)
+for each.
+.
 For example,
-.Fa int foo .
+the function command
+.Pf . Ic \&Fn
+expects its first argument to be the name of a function and any
+remaining arguments to be function parameters.
+.
+Because C language standards mandate the inclusion of types
+.Em and
+identifiers in the parameter lists of function definitions,
+each
+.Ql \&Fn
+parameter after the first will be at least two words in length,
+as in
+.Dq Ar "int foo" .
+.
+.
 .Pp
-There are two possible ways to pass an argument which contains
-an embedded space.
-One way of passing a string containing blank spaces is to use the hard or
-unpaddable space character
-.Ql \e\  ,
-that is, a blank space preceded by the escape character
-.Ql \e .
-This method may be used with any macro but has the side effect of
-interfering with the adjustment of text over the length of a line.
-.Xr Troff
-sees the hard space as if it were any other printable character and cannot
-split the string into blank or newline separated pieces as one would expect.
-This method is useful for strings which are not expected to overlap a line
-boundary.
-An alternative is to use
-.Ql \e\ti ,
-a paddable (i.e.\& stretchable), unbreakable space (this is a
-.Tn GNU
-.Xr troff 1
-extension).
-The second method is to enclose the string with double quotes.
-.Pp
-For example:
-.
-.Bl -tag -width ".Fn fetch char\ *str" -offset indent
-.It Fn fetch char\ *str
-is created by
-.Ql ".Fn fetch char\e *str"
-.It Fn fetch "char *str"
-can also be created by
-.Ql ".Fn fetch \*qchar *str\*q"
+There are a few ways to embed a space in a macro argument.
+.
+One is to use the unadjustable space escape sequence
+.Li \rs Ns Em space .
+.
+The formatter treats this escape sequence as if it were any other
+printable character,
+and will not break a line there as it would a word space when the
+output line is full.
+.
+This method is useful for macro arguments that are not expected to
+straddle an output line boundary,
+but has a drawback:
+this space does not adjust as others do when the output line is
+formatted.
+.
+An alternative is to use the unbreakable space escape sequence,
+.Ql \rs\ti ,
+which cannot break but does adjust.
+.
+This
+.Xr groff
+extension is widely but not perfectly portable.
+.
+Another method is to enclose the string in double quotes.
+.
+.Bl -tag -width ".Fn\ fetch\ \dqchar\ *str\dq" -offset indent \
+-compact
+.It Li ".Fn fetch char\e *str"
+\->
+.Fn fetch char\ *str
+.It Li ".Fn fetch char\e\ti*str"
+\->
+.Fn fetch char\~*str
+.It Li ".Fn fetch \dqchar *str\dq"
+\->
+.Fn fetch "char *str"
 .El
 .
-.Pp
 If the
-.Ql \e
+.Ql \rs
 before the space in the first example
-or double quotes in the second example
+or the double quotes in the third example
 were omitted,
 .Ql .Fn
-would see three arguments, and the result would be:
-.Pp
-.Dl Fn fetch char *str
-.Pp
-.\" For an example of what happens when the parameter list overlaps a newline
-.\" boundary, see the
-.\" .Sx BUGS
+would see three arguments,
+and the result would contain an undesired comma.
+.
+.\" Use same width as before so it's easier to see the discrepancy.
+.Bl -tag -width ".Fn\ fetch\ \dqchar\ *str\dq" -offset indent \
+-compact
+.It Li ".Fn fetch char *str"
+\->
+.Fn fetch char *str
+.El
+.
+.
+.\".Pp
+.\" For an example of what happens when the parameter list overlaps a
+.\" newline boundary,
+.\" see the
+.\" .Sx Bugs
 .\" section.
 .
-.Ss "Trailing Blank Space Characters"
 .
-.Xr Troff
-can be confused by blank space characters at the end of a line.
-It is a wise preventive measure to globally remove all blank spaces
-from
-.Ao blank-space Ac Ns Ao end-of-line Ac
-character sequences.
-Should the need arise to use a blank character at the end of a line, it
-may be forced with an unpaddable space and the
-.Ql \e&
-escape character.
-For example,
-.Ql string\e\ \e& .
+.Ss "Trailing space characters"
 .
-.Ss "Escaping Special Characters"
+.\" XXX: This claim of confusion is nonsense.  The formatter ignores
+.\" them.  If mdoc doesn't, that's a bug or design flaw.  It's still
+.\" good style not to have them.  Whitespace churn makes diff(1) and
+.\" revision control users unhappy.
+.\"
+.\".Xr @g@troff
+.\"can be confused by space characters at the end of a line.
 .
-Special characters like the newline character
-.Ql \en
-are handled by replacing the
-.Ql \e
-with
-.Ql \ee
-(e.g.\&
-.Ql \een )
-to preserve the backslash.
+It is wise to remove trailing spaces from the ends of input lines.
 .
-.Ss "Other Possible Pitfalls"
+Should the need arise to put a formattable space at the end of a line,
+do so with the unadjustable or unbreakable space escape sequences.
 .
-A warning is emitted when an empty input line is found outside of displays
-(see below).
-Use
-.Ql .sp
+.
+.Ss "Formatting the backslash glyph"
+.
+When you need the
+.Xr roff
+escape character
+.Ql \rs
+to appear in the output,
+use
+.Ql \rse
+or
+.Ql \rs(rs
 instead.
-(Well, it is even better to use
-.Nm \-mdoc
-macros to avoid the usage of low-level commands.)
+.
+Technically,
+.Ql \rse
+formats the current escape character;
+it works reliably as long as no
+.Xr roff
+request is used to change it,
+which should never happen in man pages.
+.
+.Ql \rs(rs
+is a
+.Xr groff
+special character escape sequence that explicitly formats the
+.Dq "reverse solidus"
+(backslash) glyph.
+.
+.
+.Ss "Other possible pitfalls"
+.
+.Xr "groff mdoc"
+warns when an empty input line is found outside of a
+.Em display ,
+a topic presented in subsection
+.Sx "Examples and displays"
+below.
+.
+Use empty requests to space the source document for maintenance.
+.
+.
 .Pp
-Leading spaces will cause a break and are output directly.
+Leading spaces cause a break and are formatted.
+.
 Avoid this behaviour if possible.
-Similarly, do not use more than one space character between words in an
-ordinary text line; contrary to other text formatters, they are
-.Em not
-replaced with a single space.
+.
+Similarly,
+do not put more than one space between words in an ordinary text line;
+they are not
+.Dq normalized
+to a single space as other text formatters might do.
+.
+.
 .Pp
-You can't pass
-.Ql \*q
-directly as an argument.
-Use
-.Ql \e*q
-(or
-.Ql \e*q )
-instead.
+Don't try to use the neutral double quote character
+.Ql \dq
+to represent itself in an argument.
+.
+Use the special character escape sequence
+.Ql \rs(dq
+to format it.
+.\" That's NOT a groffism, but showed up in the "post" and "Latin1"
+.\" devices of Tenth Edition Research Unix.
+.
+Further,
+this glyph should not be used for conventional quotation;
+.Xr mdoc
+offers several quotation macros.
+.
+See subsection
+.Sx "Enclosure and quoting macros"
+below.
+.
+.
 .Pp
-By default,
-.Xr troff 1
-inserts two space characters after a punctuation mark closing a sentence;
-characters like
-.Ql \&)
-or
-.Ql \&'
-are treated transparently, not influencing the sentence-ending behaviour.
-To change this, insert
+The formatter attempts to detect the ends of sentences and by default
+puts the equivalent of two spaces between sentences on the same output
+line;
+see
+.Xr roff @MAN7EXT@ .
+.
+To defeat this detection in a parsed list of macro arguments,
+put
 .Ql \e&
-before or after the dot:
+before the punctuation mark.
 .
-.Bd -literal -offset indent
+Thus,
+.
+.Bd -literal -offset indent -compact
 The
 \&.Ql .
 character.
@@ -516,238 +607,372 @@
 \&.No test.
 test
 .Ed
-.Pp
 .
 gives
 .
-.Bd -filled -offset indent
+.Bd -filled -offset indent -compact
 The
 .Ql .
 character
+.
+.
 .Pp
 The
 .Ql \&.
 character.
+.
+.
 .Pp
 .No test .
 test
+.
+.
 .Pp
 .No test.
 test
 .Ed
-.Pp
 .
-As can be seen in the first and third line,
-.Nm \-mdoc
+as output.
+.
+As can be seen in the first and third output lines,
+.Xr mdoc
 handles punctuation characters specially in macro arguments.
+.
 This will be explained in section
-.Sx General Syntax
+.Sx "General syntax"
 below.
-In the same way, you have to protect trailing full stops of abbreviations
-with a trailing zero-width space:
-.Ql e.g.\e& .
-.Pp
-A comment in the source file of a man page can be either started with
-.Ql .\e"
-on a single line,
-.Ql \e"
-after some input, or
-.Ql \e#
-anywhere (the latter is a
-.Tn GNU
-.Xr troff 1
-extension); the rest of such a line is ignored.
 .
 .
-.Sh "A MANUAL PAGE TEMPLATE"
+.Pp
+A comment in the source file of a man page can begin with
+.Sq Li .\e"
+at the start of an input line,
+.Sq Li \e"
+after other input,
+or
+.Sq Li \e#
+anywhere
+(the last is a
+.Xr groff
+extension);
+the remainder of any such line is ignored.
+.
+.
+.Sh "A man page template"
 .
-The body of a man page is easily constructed from a basic template:
+Use
+.Xr mdoc
+to construct a man page from the following template.
 .
 .Bd -literal -offset indent
-\&.\e" The following commands are required for all man pages.
-\&.Dd Month day, year
-\&.Dt DOCUMENT_TITLE section number architecture/volume
-\&.Os OPERATING_SYSTEM version/release
-\&.Sh NAME
-\&.Nm name
-\&.Nd one line description of name
-\&.\e" This next command is for sections 2 and 3 only.
-\&.\e" .Sh LIBRARY
-\&.Sh SYNOPSIS
-\&.Sh DESCRIPTION
-\&.\e" The following commands should be uncommented and
-\&.\e" used where appropriate.
-\&.\e" .Sh IMPLEMENTATION NOTES
-\&.\e" This next command is for sections 2, 3, and 9 only
-\&.\e"     (function return values).
-\&.\e" .Sh RETURN VALUES
-\&.\e" This next command is for sections 1, 6, 7, and 8 only.
-\&.\e" .Sh ENVIRONMENT
-\&.\e" .Sh FILES
-\&.\e" This next command is for sections 1, 6, and 8 only
-\&.\e"     (command return values to the shell).
-\&.\e" .Sh EXIT STATUS
-\&.\e" .Sh EXAMPLES
-\&.\e" This next command is for sections 1, 4, 6, 7, 8, and 9 only
-\&.\e"     (fprintf/stderr type diagnostics).
-\&.\e" .Sh DIAGNOSTICS
-\&.\e" .Sh COMPATIBILITY
-\&.\e" This next command is for sections 2, 3, 4, and 9 only
-\&.\e"     (settings of the errno variable).
-\&.\e" .Sh ERRORS
-\&.\e" .Sh SEE ALSO
-\&.\e" .Sh STANDARDS
-\&.\e" .Sh HISTORY
-\&.\e" .Sh AUTHORS
-\&.\e" .Sh CAVEATS
-\&.\e" .Sh BUGS
+\&.\e" The following three macro calls are required.
+\&.Dd date
+\&.Dt topic section-identifier section-keyword-or-title
+\&.Os package-or-operating system version-or-release
+\&.Sh Name
+\&.Nm topic
+\&.Nd summary-description
+\&.\e" The next heading is used in sections 2 and 3.
+\&.\e" .Sh Library
+\&.\e" The next heading is used in sections 1-4, 6, 8, and 9.
+\&.Sh Synopsis
+\&.Sh Description
+\&.\e" Uncomment and populate the following sections as needed.
+\&.\e" .Sh \dqImplementation notes\dq
+\&.\e" The next heading is used in sections 2, 3, and 9.
+\&.\e" .Sh \dqReturn values\dq
+\&.\e" The next heading is used in sections 1, 3, 6, and 8.
+\&.\e" .Sh Environment
+\&.\e" .Sh Files
+\&.\e" The next heading is used in sections 1, 6, and 8.
+\&.\e" .Sh \dqExit status\dq
+\&.\e" .Sh Examples
+\&.\e" The next heading is used in sections 1, 4, 6, 8, and 9.
+\&.\e" .Sh Diagnostics
+\&.\e" .Sh Compatibility
+\&.\e" The next heading is used in sections 2, 3, 4, and 9.
+\&.\e" .Sh Errors
+\&.\e" .Sh \dqSee also\dq
+\&.\e" .Sh Standards
+\&.\e" .Sh History
+\&.\e" .Sh Authors
+\&.\e" .Sh Caveats
+\&.\e" .Sh Bugs
 .Ed
-.Pp
 .
+.
+.Pp
 The first items in the template are the commands
-.Ql .Dd ,
-.Ql .Dt ,
+.Pf . Ic \&Dd ,
+.Pf . Ic \&Dt ,
 and
-.Ql .Os ;
-the document date, the operating system the man page or subject source is
-developed or modified for, and the man page title (in
-.Em upper case )
-along with the section of the manual the page belongs in.
-These commands identify the page and are discussed below in
-.Sx TITLE MACROS .
+.Pf . Ic \&Os .
+.
+They identify the page and are discussed below in section
+.Sx "Title macros" .
+.
+.
 .Pp
-The remaining items in the template are section headers
-.Pf ( Li .Sh ) ;
+The remaining items in the template are section headings
+.Pf ( Pf . Ic \&Sh ) ;
 of which
-.Em NAME ,
-.Em SYNOPSIS ,
+.Sx Name
 and
-.Em DESCRIPTION
+.Sx Description
 are mandatory.
-The headers are discussed in
-.Sx "PAGE STRUCTURE DOMAIN" ,
-after presentation of
-.Sx "MANUAL DOMAIN" .
-Several content macros are used to demonstrate page layout macros; reading
-about content macros before page layout macros is recommended.
+.
+These headings are discussed in section
+.Sx "Page structure domain" ,
+which follows section
+.Sx "Manual domain" .
+.
+Familiarize yourself with manual domain macros first;
+we use them to illustrate the use of page structure domain macros.
 .
 .
-.Sh CONVENTIONS
+.Sh Conventions
+.
+In the descriptions of macros below,
+square brackets surround optional arguments.
 .
-In the description of all macros below, optional arguments are put into
-brackets.
 An ellipsis
 .Pf ( Sq ... )
-represents zero or more additional arguments.
-Alternative values for a parameter are separated with
+represents repetition of the preceding argument zero or more times.
+.
+Alternative values of a parameter are separated with
 .Ql | .
-If there are alternative values for a mandatory parameter, braces are used
-(together with
-.Ql | )
-to enclose the value set.
-Meta-variables are specified within angles.
-.Pp
-Example:
 .
-.Bl -tag -width 6n -offset indent
-.It Li .Xx Xo
-.Aq foo
-.Brq bar1 | bar2
-.Op \-test1 Op \-test2 | \-test3
-.No ...
+If a mandatory parameter can take one of several alternative values,
+use braces to enclose the set,
+with spaces and
+.Ql |
+separating the items.
+.
+.\" XXX: Angle brackets should only be necessary when space doesn't
+.\" separate parameters.
+.\" .
+.\" Metasyntactic variables are specified within angle brackets.
+.\"Bl -tag -width 6n -offset indent -compact
+.Bl -tag -offset indent -compact
+.It Nm ztar Xo
+.Brq Cm c | Cm x
+.Op Fl w Op Fl y | Fl z
+.Op Fl f Ar archive
+.Ar member No ...
 .Xc
 .El
 .
+An alternative to using braces is to separately synopsize distinct
+operation modes,
+particularly if the list of valid optional arguments is dependent on the
+user's choice of a mandatory parameter.
+.
+.Bl -tag -offset indent -compact
+.It Nm ztar Xo
+.Cm c
+.Op Fl w Op Fl y | Fl z
+.Op Fl f Ar archive
+.Ar member No ...
+.Xc
+.It Nm ztar Xo
+.Cm x
+.Op Fl w Op Fl y | Fl z
+.Op Fl f Ar archive
+.Ar member No ...
+.Xc
+.El
+.
+.
 .Pp
-Except stated explicitly, all macros are parsed and callable.
-.Pp
-Note that a macro takes effect up to the next nested macro.
+Most macros affect subsequent arguments until another macro or a newline
+is encountered.
+.
 For example,
-.Ql ".Ic foo Aq bar"
+.Sq Li ".Li ls Bq Ar file"
 doesn't produce
-.Sq Ic "foo <bar>"
+.Sq Li "ls file" ,
 but
-.Sq Ic foo Aq bar .
-Consequently, a warning message is emitted for most commands if the first
-argument is a macro itself since it cancels the effect of the calling
-command completely.
-Another consequence is that quoting macros never insert literal quotes;
-.Sq Ic "foo <bar>"
-has been produced by
-.Ql ".Ic \*qfoo <bar>\*q" .
-.Pp
-Most macros have a default width value which can be used to specify a label
-width
-.Pf ( Fl width )
-or offset
-.Pf ( Fl offset )
-for the
-.Ql .Bl
-and
-.Ql .Bd
-macros.
-It is recommended not to use this rather obscure feature to avoid
-dependencies on local modifications of the
-.Nm \-mdoc
+.Sq Li ls Bq Ar file .
+.
+Consequently,
+a warning message is emitted for many commands if the first argument is
+itself a macro,
+since it cancels the effect of the preceding one.
+.\" XXX: I don't think it is made clear which macros eat only one
+.\" argument and which ones devour tokens until another macro is
+.\" encountered. -- GBR
+.
+On rare occasions,
+you might want to format a word along with surrounding brackets as a
+literal.
+.
+.\" XXX: Why do we need the extra "\ " for the width parameter?  Without
+.\" it, the line breaks before the arrow on a 78n terminal.  But there
+.\" should be room anyway...bug?
+.\"
+.\" XXX: Arguably, Bq should respect the altered font family in a `Bl`,
+.\" but it sets the brackets and argument in Times roman.  Maybe all the
+.\" enclosures work this way.
+.Bl -tag -width "Li\ \dqls\ file\dq\ " -offset indent -compact
+.It Li ".Li \dqls file\dq"
+\->
+.Li "ls file"
+.Em "# list any files named e, f, i, or l"
+.El
+.
+.
+.Pp
+Many macros possess an implicit width,
+used when they are contained in lists and displays.
+.
+If you avoid relying on these default measurements,
+you escape potential conflicts with site-local modifications of the
+.Xr mdoc
 package.
 .
+Explicit
+.Fl width
+and
+.Fl offset
+arguments to the
+.Pf . Ic \&Bl
+and
+.Pf . Ic \&Bd
+macros are preferable.
+.
+.
+.Sh "Title macros"
 .
-.Sh "TITLE MACROS"
+We present the
+.Sy mandatory
+title macros first due to their importance even though they formally
+belong to the page structure domain macros.
+.\" XXX: This was formerly "...for someone who wishes to start writing a
+.\" man page yesterday."
+.\"
+.\" Cute joke, but we're 800+ lines into this page source and four pages
+.\" into the document when formatted for U.S. letter paper.  We lost
+.\" that kind of reader last _week_.
+.
+They designate the
+topic,
+date of last revision,
+and the operating system or software project associated with the page.
+.
+Call each once at the beginning of the document.
+.
+They populate the page headers and footers,
+which are in
+.Xr roff
+parlance termed
+.Dq titles .
 .
-The title macros are part of the page structure domain but are presented
-first and separately for someone who wishes to start writing a man page
-yesterday.
-Three header macros designate the document title or manual page title, the
-operating system, and the date of authorship.
-These macros are called once at the very beginning of the document and are
-used to construct headers and footers only.
 .
 .Bl -tag -width 6n
-.It Li .Dt Xo
-.Op Aq document title
-.Op Aq section number
-.Op Aq volume
+.It Li .Dd Xo
+.Ar date
 .Xc
-The document title is the subject of the man page and must be in
-.Tn CAPITALS
-due to troff limitations.
-If omitted,
-.Sq Tn UNTITLED
-is used.
-The section number may be a number in the range
-.No 1,\~ Ns ... Ns ,\~9
-or
+This first macro of any
+.Xr mdoc
+manual records the last modification date of the document source.
+.
+Arguments are concatenated and separated with space characters.
+.
+.
+.Pp
+Historically,
+.Ar date
+was written in U.S.\& traditional format,
+.Do
+.\" XXX: Em -> Ar when we de-Courierize .Ar.
+.Em Month day Li , Em year
+.Dc
+where
+.Em Month
+is the full month name in English,
+.Em day
+an integer without a leading zero,
+and
+.Em year
+the four-digit year.
+.
+This localism is not enforced,
+however.
+.
+You may prefer ISO 8601 format,
+.Em YYYY-MM-DD.
+.
+A
+.Ar date
+of the form
+.Sq Li $Mdocdate: Ar Month day year Li $
+is also recognized.
+.
+It is used in
+.Ox
+manuals to automatically insert the current date when committing.
+.
+.
+.Pp
+This macro is neither callable nor parsed.
+.
+.
+.br
+.ne 5v
+.It Li .Dt Ar topic Op Ar section-identifier \
+Op Ar section-keyword-or-title
+.
+.Ar topic
+is the subject of the man page.
+.
+A
+.Ar section-identifier
+that begins with an integer in the range 1\en9
+or is one of the words
 .Ql unass ,
 .Ql draft ,
 or
-.Ql paper .
-If it is specified, and no volume name is given, a default volume name is
-used.
+.Ql paper
+selects a predefined section title.
 .
+This use of
+.Dq section
+has nothing to do with the section headings otherwise discussed in this
+page;
+it arises from the organizational scheme of printed and bound Unix
+manuals.
+.
+.
+.br
+.ne 3v
 .Pp
-Under
-.Tn \*doc-operating-system ,
-the following sections are defined:
-.Pp
+In this implementation,
+the following titles are defined for integral section numbers.
+.
+.
+.Bd -unfilled -offset indent
 .TS
-l l l.
-1	\*doc-volume-operating-system \*doc-volume-ds-1
-2	\*doc-volume-operating-system \*doc-volume-ds-2
-3	\*doc-volume-operating-system \*doc-volume-ds-3
-4	\*doc-volume-operating-system \*doc-volume-ds-4
-5	\*doc-volume-operating-system \*doc-volume-ds-5
-6	\*doc-volume-operating-system \*doc-volume-ds-6
-7	\*doc-volume-operating-system \*doc-volume-ds-7
-8	\*doc-volume-operating-system \*doc-volume-ds-8
-9	\*doc-volume-operating-system \*doc-volume-ds-9
+Lf(CR) L.
+1	\*doc-volume-ds-1
+2	\*doc-volume-ds-2
+3	\*doc-volume-ds-3
+4	\*doc-volume-ds-4
+5	\*doc-volume-ds-5
+6	\*doc-volume-ds-6
+7	\*doc-volume-ds-7
+8	\*doc-volume-ds-8
+9	\*doc-volume-ds-9
 .TE
-.Pp
+.Ed
 .
-A volume name may be arbitrary or one of the following:
 .
 .Pp
+A section title may be arbitrary or one of the following abbreviations.
+.
+.
+.Bd -unfilled -offset indent
 .TS
-l l.
+Lf(CR) L.
 USD	\*doc-volume-ds-USD
 PS1	\*doc-volume-ds-PS1
 AMD	\*doc-volume-ds-AMD
@@ -759,8 +984,10 @@
 LOCAL	\*doc-volume-ds-LOCAL
 CON	\*doc-volume-ds-CON
 .TE
-.Pp
+.Ed
+.
 .
+.Pp
 For compatibility,
 .Ql MMI
 can be used for
@@ -769,104 +996,139 @@
 .Ql LOC
 for
 .Ql LOCAL .
-Values from the previous table will specify a new volume name.
-If the third parameter is a keyword designating a computer architecture,
-its value is prepended to the default volume name as specified by the
+.
+Values from the previous table will specify a new section title.
+.
+If
+.Ar section-keyword-or-title
+designates a computer architecture recognized by
+.Xr "groff mdoc" ,
+its value is prepended to the default section title as specified by the
 second parameter.
-By default, the following architecture keywords are defined:
+.\" mandoc(1) appears to put the architecture string after (or in place
+.\" of) the section title, in parentheses.
+.
+By default,
+the following architecture keywords are defined.
 .
 \# we use 'No' to avoid hyphenation
-.Bd -ragged -offset indent
+.\" Resort to ps/vs violence if necessary because this macro package is
+.\" obsessed with dumping gigantic piles of identifiers on users, and I
+.\" need the space to keep this macro description to a single page in
+.\" PS/PDF(!).  Lists of information like this simply beg to bit-rot.
+.\" -- GBR
+.br
+.ps -2
+.vs -2
+.Bd -ragged -offset 4n
 .No acorn26 , acorn32 , algor , alpha , amd64 , amiga , amigappc ,
 .No arc , arm , arm26 , arm32 , armish , atari , aviion ,
 .No beagle , bebox , cats , cesfic , cobalt , dreamcast ,
 .No emips , evbarm , evbmips , evbppc , evbsh3 , ews4800mips ,
 .No hp300 , hp700 , hpcarm , hpcmips , hpcsh , hppa , hppa64 ,
-.No i386 , ia64 , ibmnws , iyonix , landisk , loongson , luna68k , luna88k ,
-.No m68k , mac68k , macppc , mips , mips64 , mipsco , mmeye ,
-.No mvme68k , mvme88k , mvmeppc , netwinder , news68k , newsmips , next68k ,
-.No ofppc , palm , pc532 , playstation2 , pmax , pmppc , powerpc , prep ,
-.No rs6000 , sandpoint , sbmips , sgi , sgimips , sh3 , shark ,
-.No socppc , solbourne , sparc , sparc64 , sun2 , sun3 ,
+.No i386 , ia64 , ibmnws , iyonix , landisk , loongson , luna68k ,
+.No luna88k , m68k , mac68k , macppc , mips , mips64 , mipsco , mmeye ,
+.No mvme68k , mvme88k , mvmeppc , netwinder , news68k , newsmips ,
+.No next68k , ofppc , palm , pc532 , playstation2 , pmax , pmppc ,
+.No powerpc , prep , rs6000 , sandpoint , sbmips , sgi , sgimips , sh3 ,
+.No shark , socppc , solbourne , sparc , sparc64 , sun2 , sun3 ,
 .No tahoe , vax , x68k , x86_64 , xen , zaurus
 .Ed
+.vs
+.ps
+.
+.
 .Pp
+If a section title is not determined after the above matches have been
+attempted,
+.Ar section-keyword-or-title
+is used.
 .
-If the section number is neither a numeric expression in the range 1 to\~9
-nor one of the above described keywords, the third parameter is used
-verbatim as the volume name.
-.Pp
-In the following examples, the left (which is identical to the right) and
-the middle part of the manual page header strings are shown.
-Note how
-.Ql \e&
-prevents the digit\~7 from being a valid numeric expression.
 .
-.Bd -ragged
-.Bl -tag -width ".Li .Dt\ FOO\ 2\ i386" -compact -offset indent
-.It Li ".Dt FOO 7"
-.Ql FOO(7)
-.Ql \*doc-volume-operating-system \*doc-volume-ds-7
-.It Li ".Dt FOO 7 bar"
-.Ql FOO(7)
-.Ql \*doc-volume-operating-system \*doc-volume-ds-7
-.It Li ".Dt FOO \e&7 bar"
-.Ql FOO(7)
-.Ql bar
-.It Li ".Dt FOO 2 i386"
-.Ql FOO(2)
-.Ql \*doc-volume-operating-system/\*doc-volume-as-i386 \*doc-volume-ds-2
-.It Li ".Dt FOO \*q\*q bar"
-.Ql FOO
-.Ql bar
-.El
+.br
+.ne 10v \" Keep explanatory paragraph with the following table.
+.Pp
+The effects of varying
+.Ql .Dt
+arguments on the page header content
+are shown below.
+.
+Observe how
+.Ql \rs&
+prevents the numeral\~2 from being used to look up a predefined section
+title.
+.
+.
+.Pp
+.\" On terminals, 2n is as far as we can offset without overrunning a
+.\" 78n width.
+.Bd -unfilled -offset 2n
+.TS
+tab(@);
+Lf(CR)1 L2 L C R.
+\&.Dt foo 2@\->@foo(2)@System Calls Manual@foo(2)
+\&.Dt foo 2 m68k@\->@foo(2)@m68k System Calls Manual@foo(2)
+\&.Dt foo 2 baz@\->@foo(2)@System Calls Manual@foo(2)
+\&.Dt foo \rs&2 baz@\->@foo(2)@baz@foo(2)
+\&.Dt foo \dq\dq baz@\->@foo@baz@foo
+\&.Dt foo M Z80@\->@foo(M)@Z80@foo(M)
+.TE
 .Ed
+.
+.
 .Pp
+.Xr roff
+strings define section titles and architecture identifiers.
 .
-Local, OS-specific additions might be found in the file
+Site-specific additions might be found in the file
 .Pa mdoc.local ;
-look for strings named
-.Ql volume\-ds\-XXX
-(for the former type) and
-.Ql volume\-as\-XXX
-(for the latter type);
-.Ql XXX
-then denotes the keyword to be used with the
-.Ql .Dt
-macro.
+see section
+.Sx Files
+below.
+.
+.
 .Pp
 This macro is neither callable nor parsed.
 .
-.It Li .Os Xo
-.Op Aq operating system
-.Op Aq release
-.Xc
-If the first parameter is empty,
-the default
-.Sq Tn "\*doc-operating-system"
-is used.
-This may be overridden in the local configuration file,
-.Pa mdoc.local .
-In general, the name of the operating system should be the common acronym,
-e.g.\&
-.Tn BSD
-or
-.Tn ATT .
-The release should be the standard release nomenclature for the system
-specified.
-In the following table, the possible second arguments for some predefined
-operating systems are listed.
-Similar to
-.Ql .Dt ,
-local additions might be defined in
+.
+.It Li .Os Op Ar operating-system-or-package-name \
+Op Ar version-or-release
+.
+This macro associates the document with a software distribution.
+.
+When composing a man page to be included in the base installation of an
+operating system,
+do not provide an argument;
+.Xr mdoc
+will supply it.
+.
+In this implementation,
+that default is
+.Dq "\*doc-default-operating-system" .
+.
+It may be overridden in the site configuration file,
 .Pa mdoc.local ;
-look for strings named
-.Ql operating\-system\-XXX\-YYY ,
-where
-.Ql XXX
-is the acronym for the operating system and
-.Ql YYY
-the release ID.
+see section
+.Sx Files
+below.
+.
+A portable software package maintaining its own man pages can supply
+its name and version number or release identifier as optional arguments.
+.
+A
+.Em version-or-release
+argument should use the standard nomenclature for the software
+specified.
+.
+In the following table,
+recognized
+.Em version-or-release
+arguments for some predefined operating systems are listed.
+.
+As with
+.Pf . Ic \&Dt ,
+site additions might be defined in
+.Pa mdoc.local .
 .
 .Bd -ragged -compact
 .Bl -tag -width ".No DragonFly" -offset indent
@@ -876,127 +1138,116 @@
 3, 4, 4.1, 4.2, 4.3, 4.3t, 4.3T, 4.3r, 4.3R, 4.4
 .It NetBSD
 0.8, 0.8a, 0.9, 0.9a, 1.0, 1.0a, 1.1, 1.2, 1.2a, 1.2b, 1.2c, 1.2d, 1.2e,
-1.3, 1.3a, 1.4, 1.4.1, 1.4.2, 1.4.3, 1.5, 1.5.1, 1.5.2, 1.5.3, 1.6, 1.6.1,
-1.6.2, 1.6.3, 2.0, 2.0.1, 2.0.2, 2.0.3, 2.1, 3.0, 3.0.1, 3.0.2, 3.0.3,
-3.1, 3.1.1, 4.0, 4.0.1, 5.0, 5.0.1, 5.0.2, 5.1, 5.1.2, 5.1.3, 5.1.4,
-5.2, 5.2.1, 5.2.2, 6.0, 6.0.1, 6.0.2, 6.0.3, 6.0.4, 6.0.5, 6.1, 6.1.1,
-6.1.2, 6.1.3, 6.1.4
+1.3, 1.3a, 1.4, 1.4.1, 1.4.2, 1.4.3, 1.5, 1.5.1, 1.5.2, 1.5.3, 1.6,
+1.6.1, 1.6.2, 1.6.3, 2.0, 2.0.1, 2.0.2, 2.0.3, 2.1, 3.0, 3.0.1, 3.0.2,
+3.0.3, 3.1, 3.1.1, 4.0, 4.0.1, 5.0, 5.0.1, 5.0.2, 5.1, 5.1.2, 5.1.3,
+5.1.4, 5.2, 5.2.1, 5.2.2, 6.0, 6.0.1, 6.0.2, 6.0.3, 6.0.4, 6.0.5, 6.0.6,
+6.1, 6.1.1, 6.1.2, 6.1.3, 6.1.4, 6.1.5, 7.0, 7.0.1, 7.0.2, 7.1, 7.1.1,
+7.1.2, 7.2, 8.0, 8.1
 .It FreeBSD
-1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5, 2.1.6, 2.1.7, 2.2, 2.2.1,
-2.2.2, 2.2.5, 2.2.6, 2.2.7, 2.2.8, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 4.0, 4.1,
-4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7, 4.8, 4.9, 4.10, 4.11, 5.0, 5.1,
-5.2, 5.2.1, 5.3, 5.4, 5.5, 6.0, 6.1, 6.2, 6.3, 6.4, 7.0, 7.1, 7.2, 7.3, 7.4,
-8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, 9.2, 9.3, 10.0
+1.0, 1.1, 1.1.5, 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5, 2.1.6, 2.1.7, 2.2,
+2.2.1, 2.2.2, 2.2.5, 2.2.6, 2.2.7, 2.2.8, 2.2.9, 3.0, 3.1, 3.2, 3.3,
+3.4, 3.5, 4.0, 4.1, 4.1.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.6.2, 4.7, 4.8,
+4.9, 4.10, 4.11, 5.0, 5.1, 5.2, 5.2.1, 5.3, 5.4, 5.5, 6.0, 6.1, 6.2,
+6.3, 6.4, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1,
+9.2, 9.3, 10.0, 10.1, 10.2, 10.3, 10.4, 11.0, 11.1, 11.2, 11.3, 12.0,
+12.1
 .It OpenBSD
-2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1, 3.2, 3.3, 3.4,
-3.5, 3.6, 3.7, 3.8, 3.9, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9,
-5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6
+2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1, 3.2, 3.3,
+3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7,
+4.8, 4.9, 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 5.9, 6.0, 6.1,
+6.2, 6.3, 6.4, 6.5, 6.6
 .It DragonFly
-1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.8, 1.8.1, 1.9, 1.10, 1.12, 1.12.2,
-1.13, 2.0, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 2.9.1, 2.10, 2.10.1,
-2.11, 2.12, 2.13, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8
+1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8, 1.8.1, 1.9, 1.10, 1.11,
+1.12, 1.12.2, 1.13, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9,
+2.9.1, 2.10, 2.10.1, 2.11, 2.12, 2.13, 3.0, 3.0.1, 3.0.2, 3.1, 3.2,
+3.2.1, 3.2.2, 3.3, 3.4, 3.4.1, 3.4.2, 3.4.3, 3.5, 3.6, 3.6.1, 3.6.2,
+3.7, 3.8, 3.8.1, 3.8.2, 4.0, 4.0.1, 4.0.2, 4.0.3, 4.0.4, 4.0.5, 4.0.6,
+4.1, 4.2, 4.2.1, 4.2.2, 4.2.3, 4.2.4, 4.3, 4.4, 4.4.1, 4.4.2, 4.4.3,
+4.5, 4.6, 4.6.1, 4.6.2, 4.7, 4.8, 4.8.1, 4.9, 5.0, 5.0.1, 5.0.2, 5.1,
+5.2, 5.2.1, 5.2.2, 5.3, 5.4, 5.4.1, 5.4.2, 5.4.3, 5.5, 5.6, 5.6.1, 5.6.2
 .It Darwin
 8.0.0, 8.1.0, 8.2.0, 8.3.0, 8.4.0, 8.5.0, 8.6.0, 8.7.0, 8.8.0, 8.9.0,
 8.10.0, 8.11.0, 9.0.0, 9.1.0, 9.2.0, 9.3.0, 9.4.0, 9.5.0, 9.6.0, 9.7.0,
-9.8.0, 10.1.0, 10.2.0, 10.3.0, 10.4.0, 10.5.0, 10.6.0, 10.7.0, 10.8.0,
-11.0.0, 11.1.0, 11.2.0, 11.3.0, 11.4.0, 11.5.0, 12.0.0, 12.1.0, 12.2.0,
-13.0.0, 13.1.0, 13.2.0, 13.3.0, 13.4.0, 14.0.0
+9.8.0, 10.0.0, 10.1.0, 10.2.0, 10.3.0, 10.4.0, 10.5.0, 10.6.0, 10.7.0,
+10.8.0, 11.0.0, 11.1.0, 11.2.0, 11.3.0, 11.4.0, 11.5.0, 12.0.0, 12.1.0,
+12.2.0, 13.0.0, 13.1.0, 13.2.0, 13.3.0, 13.4.0, 14.0.0, 14.1.0, 14.2.0,
+14.3.0, 14.4.0, 14.5.0, 15.0.0, 15.1.0, 15.2.0, 15.3.0, 15.4.0, 15.5.0,
+15.6.0, 16.0.0, 16.1.0, 16.2.0, 16.3.0, 16.4.0, 16.5.0, 16.6.0, 17.0.0,
+17.1.0, 17.2.0, 17.3.0, 17.4.0, 17.5.0, 17.6.0, 17.7.0, 18.0.0, 18.1.0,
+18.2.0, 18.3.0, 18.4.0, 18.5.0, 18.6.0, 18.7.0, 19.0.0, 19.1.0, 19.2.0
 .El
 .Ed
-.Pp
 .
-For
-.Tn ATT ,
-an unknown second parameter will be replaced with the string
-.Tn UNIX ;
-for the other predefined acronyms it will be ignored and a warning message
-emitted.
-Unrecognized arguments are displayed as given in the page footer.
-For instance, a typical footer might be:
-.Pp
-.Dl .Os BSD 4.3
-.Pp
-giving
-.Ql 4.3\~Berkeley Distribution ,
-or for a locally produced set
-.Pp
-.Dl .Os CS Department
-.Pp
-which will produce
-.Ql CS\~Department .
-.Pp
-If the
-.Ql .Os
-macro is not present, the bottom left corner of the manual page will be
-ugly.
-.Pp
-This macro is neither callable nor parsed.
 .
-.It Li .Dd Oo
-.Aq month
-.Aq day ,
-.Aq year
-.Oc
-If
-.Ql Dd
-has no arguments,
-.Ql Epoch
-is used for the date string.
-If it has exactly three arguments, they are concatenated, separated with
-unbreakable space:
-.Pp
-.Dl .Dd January 25, 2001
-.Pp
-The month's name shall not be abbreviated.
-.Pp
-With any other number of arguments, the current date is used, ignoring
-the parameters.
-.Pp
-As a special exception, the format
-.Bd -filled -offset indent
-.Li .Dd $Mdocdate:
-.Aq month
-.Aq day
-.Aq year
-.Li $
-.Ed
 .Pp
-is also recognized.
-It is used in
-.Ox
-manuals to automatically insert the current date when committing.
+Historically,
+the first argument used with
+.Pf . Ic \&Dt
+was
+.Li BSD
+or
+.Li ATT .
+.
+An unrecognized version argument after
+.Li ATT
+is replaced with
+.Dq Ux ;
+for other predefined abbreviations,
+it is ignored and a warning diagnostic emitted.
+.
+Otherwise,
+unrecognized arguments are displayed verbatim in the page footer.
+.
+For instance,
+this page uses
+.Dq Li .Os groff @VERSION@
+whereas a locally produced page might employ
+.Dq Li .Os \dqUXYZ CS Department\dq ,
+omitting versioning.
+.
+.
 .Pp
 This macro is neither callable nor parsed.
 .El
 .
 .
-.Sh "INTRODUCTION OF MANUAL AND GENERAL TEXT DOMAINS"
+.br
+.ne 4v
+.Sh "Introduction to manual and general text domains"
 .
-.Ss "What's in a Name" Ns ...
+.
+.Ss "What's in a Name" Ns ... \" XXX: Ns not scrubbed for PDF bookmark
 .
 The manual domain macro names are derived from the day to day informal
 language used to describe commands, subroutines and related files.
 Slightly different variations of this language are used to describe the
 three different aspects of writing a man page.
 First, there is the description of
-.Nm \-mdoc
+.Xr mdoc
 macro command usage.
 Second is the description of a
 .Ux
 command
 .Em with
-.Nm \-mdoc
+.Xr mdoc
 macros, and third, the description of a command to a user in the verbal
 sense; that is, discussion of a command in the text of a man page.
+.
+.
 .Pp
 In the first case,
-.Xr troff 1
-macros are themselves a type of command; the general syntax for a troff
+.Xr @g@troff
+macros are themselves a type of command;
+the general syntax for a
+.Xr troff
 command is:
 .
 .Bd -filled -offset indent
 .Li ".Xx argument1 argument2" ...
 .Ed
+.
+.
 .Pp
 .
 .Ql .Xx
@@ -1004,8 +1255,9 @@
 be processed.
 In the second case, the description of a
 .Ux
-command using the content macros is a bit more involved; a typical
-.Sx SYNOPSIS
+command using the manual domain macros is a bit more involved;
+a typical
+.Sx Synopsis
 command line might be displayed as:
 .
 .Bd -filled -offset indent
@@ -1013,8 +1265,9 @@
 .Op Fl flag
 .Ao Ar infile Ac Ao Ar outfile Ac
 .Ed
-.Pp
 .
+.
+.Pp
 Here,
 .Nm filter
 is the command name and the
@@ -1024,7 +1277,7 @@
 .Em flag
 argument designated as optional by the option brackets.
 In
-.Nm \-mdoc
+.Xr mdoc
 terms,
 .Ao Ar infile Ac
 and
@@ -1034,20 +1287,24 @@
 in this example, the user has to replace the meta expressions given in angle
 brackets with real file names.
 Note that in this document meta arguments are used to describe
-.Nm \-mdoc
+.Xr mdoc
 commands; in most man pages, meta variables are not specifically written
 with angle brackets.
-The macros which formatted the above example:
+.
+The macros that formatted the above example:
 .
 .Bd -literal -offset indent
 \&.Nm filter
 \&.Op Fl flag
 \&.Ao Ar infile Ac Ao Ar outfile Ac
 .Ed
+.
+.
 .Pp
+In the third case,
+discussion of commands and command syntax includes both examples above,
+but may add more detail.
 .
-In the third case, discussion of commands and command syntax includes both
-examples above, but may add more detail.
 The arguments
 .Ao Ar infile Ac
 and
@@ -1056,6 +1313,7 @@
 .Em operands
 or
 .Em file arguments .
+.
 Some command-line argument lists are quite long:
 .
 .Bd -ragged
@@ -1069,14 +1327,15 @@
 .Op Fl j Ar max_jobs
 .Op Ar variable Ns = Ns Ar value
 .Bk
-.Op Ar target ...
+.Op Ar target No ...
 .Ek
 .El
 .Ed
-.Pp
 .
+.
+.Pp
 Here one might talk about the command
-.Nm make
+.Xr make
 and qualify the argument,
 .Ar makefile ,
 as an argument to the flag,
@@ -1084,7 +1343,7 @@
 or discuss the optional file operand
 .Ar target .
 In the verbal context, such detail can prevent confusion, however the
-.Nm \-mdoc
+.Xr mdoc
 package does not have a macro for an argument
 .Em to
 a flag.
@@ -1109,8 +1368,9 @@
 \&.Op Ar target ...
 \&.Ek
 .Ed
-.Pp
 .
+.
+.Pp
 The
 .Ql .Bk
 and
@@ -1118,10 +1378,12 @@
 macros are explained in
 .Sx Keeps .
 .
+.
 .Ss "General Syntax"
 .
-The manual domain and general text domain macros share a similar syntax with
-a few minor deviations; most notably,
+The manual domain and general text domain macros share a similar syntax
+with a few minor deviations;
+most notably,
 .Ql .Ar ,
 .Ql .Fl ,
 .Ql .Nm ,
@@ -1132,68 +1394,105 @@
 and
 .Ql .Xr
 impose an order on their argument lists.
-All content macros are capable of recognizing and properly handling
-punctuation, provided each punctuation character is separated by a leading
-space.
+.
+All manual domain macros are capable of recognizing and properly
+handling punctuation,
+provided each punctuation character is separated by a leading space.
+.
 If a command is given:
+.
+.
 .Pp
 .Dl \&.Ar sptr, ptr),
+.
+.
 .Pp
 The result is:
+.
+.
 .Pp
 .Dl Ar sptr, ptr),
+.
+.
 .Pp
 The punctuation is not recognized and all is output in the
 font used by
 .Ql .Ar .
 If the punctuation is separated by a leading white space:
+.
+.
 .Pp
 .Dl \&.Ar "sptr , ptr ) ,"
+.
+.
 .Pp
 The result is:
+.
+.
 .Pp
 .Dl Ar sptr , ptr ) ,
+.
+.
 .Pp
 The punctuation is now recognized and output in the default font
 distinguishing it from the argument strings.
-To remove the special meaning from a punctuation character escape it with
+.
+To remove the special meaning from a punctuation character,
+escape it with
 .Ql \e& .
+.
+.
 .Pp
 The following punctuation characters are recognized by
-.Nm \-mdoc :
+.Xr mdoc :
 .
 .Bl -column -offset indent-two XXXXXX XXXXXX XXXXXX XXXXXX
 .It Li .\& Ta Li ,\& Ta Li :\& Ta Li ;\& Ta Li (\&
 .It Li )\& Ta Li \& Ta Li \& Ta Li ?\& Ta Li !\&
 .El
+.
+.
 .Pp
 .
-.Xr Troff
-is limited as a macro language, and has difficulty when presented with a
-string containing a member of the mathematical, logical or quotation set:
+.Xr troff
+is limited as a macro language,
+and has difficulty when presented with a string containing certain
+mathematical,
+logical,
+or quotation character sequences:
 .
 .Bd -literal -offset indent-two
-{+,\-,/,*,%,<,>,<=,>=,=,==,&,`,',"}
+{+,\-,/,*,%,<,>,<=,>=,=,==,&,\ga,\aq,"}
 .Ed
-.Pp
 .
+.
+.Pp
 The problem is that
 .Xr troff
-may assume it is supposed to actually perform the operation or evaluation
-suggested by the characters.
-To prevent the accidental evaluation of these characters, escape them with
+may assume it is supposed to actually perform the operation or
+evaluation suggested by the characters.
+.
+To prevent the accidental evaluation of these characters,
+escape them with
 .Ql \e& .
-Typical syntax is shown in the first content macro displayed below,
+.
+Typical syntax is shown in the first manual domain macro displayed
+below,
 .Ql .Ad .
 .
 .
-.Sh "MANUAL DOMAIN"
+.Sh "Manual domain"
+.
 .
 .Ss Addresses
 .
 The address macro identifies an address construct.
+.
+.
 .Pp
 .Dl Usage: .Ad Ao address Ac ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Ad\ f1\ ,\ f2\ ,\ f3\ :" -compact -offset 15n
 .It Li ".Ad addr1"
@@ -1207,8 +1506,9 @@
 .It Li ".Ad addr ) ) ,"
 .Ad addr ) ) ,
 .El
-.Pp
 .
+.
+.Pp
 The default width is 12n.
 .
 .Ss "Author Name"
@@ -1217,34 +1517,43 @@
 .Ql .An
 macro is used to specify the name of the author of the item being
 documented, or the name of the author of the actual manual page.
+.
+.
 .Pp
 .Dl Usage: .An Ao author name Ac ...
+.
+.
 .Pp
-.Bl -tag -width ".Li .An\ \*qJoe\ Author\*q\ )\ )\ ," -offset 15n
-.It Li ".An \*qJoe Author\*q"
+.Bl -tag -width ".Li .An\ \dqJoe\ Author\dq\ )\ )\ ," -offset 15n
+.It Li ".An \dqJoe Author\dq"
 .An "Joe Author"
-.It Li ".An \*qJoe Author\*q ,"
+.It Li ".An \dqJoe Author\dq ,"
 .An "Joe Author" ,
-.It Li ".An \*qJoe Author\*q Aq nobody@FreeBSD.org"
+.It Li ".An \dqJoe Author\dq Aq nobody@FreeBSD.org"
 .An "Joe Author" Aq nobody@FreeBSD.org
-.It Li ".An \*qJoe Author\*q ) ) ,"
+.It Li ".An \dqJoe Author\dq ) ) ,"
 .An "Joe Author" ) ) ,
 .El
-.Pp
 .
+.
+.Pp
 The default width is 12n.
+.
+.
 .Pp
-In the
-.Em AUTHORS
-section, the
-.Ql .An
-command causes a line break allowing each new name to appear on its own
-line.
+In a section titled
+.Dq Authors ,
+.Ql \&An
+causes a break,
+allowing each new name to appear on its own line.
+.
 If this is not desirable,
 .
 .Bd -literal -offset indent
 \&.An \-nosplit
 .Ed
+.
+.
 .Pp
 .
 call will turn this off.
@@ -1254,20 +1563,37 @@
 \&.An \-split
 .Ed
 .
-.Ss "Arguments"
+.
+.Ss Arguments
 .
 The
 .Li .Ar
 argument macro may be used whenever an argument is referenced.
-If called without arguments, the
+.
+If called without arguments,
 .Sq Ar
-string is output.
+is output.
+.
+This places the ellipsis in italics,
+which is ugly and incorrect,
+and will be noticed on terminals that underline text instead of using an
+oblique typeface.
+.
+We recommend using
+.Ql ".Ar file \&No ..."
+instead.
+.
+.
 .Pp
-.Dl Usage: .Ar Oo Ao argument Ac Oc ...
+.Dl Usage: .Ar Oo Ao argument Ac Oc No ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Ar\ file1\ file2" -compact -offset 15n
 .It Li .Ar
 .Ar
+.It Li .Ar file \&No ...
+.Ar file No ...
 .It Li ".Ar file1"
 .Ar file1
 .It Li ".Ar file1 ."
@@ -1279,10 +1605,13 @@
 .It Li ".Ar file ) ) ,"
 .Ar file ) ) ,
 .El
+.
+.
 .Pp
 .
 The default width is 12n.
 .
+.
 .Ss "Configuration Declaration (Section Four Only)"
 .
 The
@@ -1290,23 +1619,30 @@
 macro is used to demonstrate a
 .Xr config 8
 declaration for a device interface in a section four manual.
+.
+.
 .Pp
 .Dl Usage: .Cd Ao argument Ac ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Cd\ Xdevice\ le0\ at\ scode?X" -offset 15n
-.It Li ".Cd \*qdevice le0 at scode?\*q"
+.It Li ".Cd \dqdevice le0 at scode?\dq"
 .Cd "device le0 at scode?"
 .El
+.
+.
 .Pp
-In the
-.Sx SYNOPSIS
-section a
-.Ql .Cd
-command causes a line break before and after its arguments are printed.
-.Pp
+In a section titled
+.Dq Synopsis ,
+.Ql \&Cd
+causes a break before and after its arguments.
+.
 .
+.Pp
 The default width is 12n.
 .
+.
 .Ss "Command Modifiers"
 .
 The command modifier is identical to the
@@ -1320,16 +1656,24 @@
 commands such as editor commands.
 See
 .Sx Flags .
+.
+.
 .Pp
 The default width is 10n.
 .
+.
 .Ss "Defined Variables"
 .
-A variable (or constant) which is defined in an include file
-is specified by the macro
+A variable
+(or constant)
+that is defined in an include file is specified by the macro
 .Ql .Dv .
+.
+.
 .Pp
-.Dl Usage: .Dv Ao defined variable Ac ...
+.Dl Usage: .Dv Ao defined-variable Ac ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Dv\ MAXHOSTNAMELEN" -compact -offset 15n
 .It Li ".Dv MAXHOSTNAMELEN"
@@ -1337,21 +1681,29 @@
 .It Li ".Dv TIOCGPGRP )"
 .Dv TIOCGPGRP )
 .El
+.
+.
 .Pp
 .
 The default width is 12n.
 .
-.Ss Errno's
+.
+.Ss Errnos
 .
 The
 .Ql .Er
-errno macro specifies the error return value for section 2, 3, and\~9 library
-routines.
+errno macro specifies the error return value for section 2,
+3,
+and\~9 library routines.
+.
 The second example below shows
 .Ql .Er
 used with the
 .Ql .Bq
-general text domain macro, as it would be used in a section two manual page.
+general text domain macro,
+as it would be used in a section two manual page.
+.
+.
 .Pp
 .Dl Usage: .Er Ao errno type Ac ...
 .Pp
@@ -1367,6 +1719,7 @@
 .
 The default width is 17n.
 .
+.
 .Ss "Environment Variables"
 .
 The
@@ -1387,6 +1740,7 @@
 .
 The default width is 15n.
 .
+.
 .Ss Flags
 .
 The
@@ -1395,10 +1749,15 @@
 It prepends a dash,
 .Ql \- ,
 to the flag.
-For interactive command flags, which are not prepended with a dash, the
+.
+For interactive command flags that are not prepended with a dash,
+the
 .Ql .Cm
 (command modifier)
-macro is identical, but without the dash.
+macro is identical,
+but without the dash.
+.
+.
 .Pp
 .Dl Usage: .Fl Ao argument Ac ...
 .Pp
@@ -1430,47 +1789,60 @@
 .Pp
 The default width is 12n.
 .
+.
 .Ss "Function Declarations"
 .
 The
 .Ql .Fd
 macro is used in the
-.Sx SYNOPSIS
+.Sx Synopsis
 section with section two or three functions.
 It is neither callable nor parsed.
 .Pp
 .Dl Usage: .Fd Ao argument Ac ...
 .Pp
 .Bl -tag -width ".Li .Fd\ X#include\ <sys/types.h>X" -compact -offset 15n
-.It Li ".Fd \*q#include <sys/types.h>\*q"
+.It Li ".Fd \dq#include <sys/types.h>\dq"
 .Fd "#include <sys/types.h>"
 .El
+.
+.
 .Pp
-In the
-.Sx SYNOPSIS
-section a
-.Ql .Fd
-command causes a line break if a function has already been presented and a
-break has not occurred.
-This leaves a nice vertical space in between the previous function call and
-the declaration for the next function.
+In a section titled
+.Dq Synopsis ,
+.Ql \&Fd
+causes a break if a function has already been presented and a break has
+not occurred,
+leaving vertical space between one function declaration and the next.
+.\" XXX: that's not what "break" means
+.
 .
 .Pp
-The
-.Ql .In
-macro, while in the
-.Sx SYNOPSIS
-section, represents the
+In a section titled
+.Dq Synopsis ,
+the
+.Ql \&In
+macro represents the
 .Li #include
-statement, and is the short form of the above example.
+statement,
+and is the short form of the above example.
+.
 It specifies the C\~header file as being included in a C\~program.
-It also causes a line break.
+.
+It also causes a break.
+.
+.
 .Pp
 While not in the
-.Sx SYNOPSIS
-section, it represents the header file enclosed in angle brackets.
+.Dq Synopsis
+section,
+it represents the header file enclosed in angle brackets.
+.
+.
 .Pp
 .Dl Usage: .In Ao header file Ac
+.
+.
 .Pp
 .Bl -tag -width ".Li .In\ stdio.h" -compact -offset 15n
 .nr in-synopsis-section 1
@@ -1481,16 +1853,24 @@
 .In stdio.h
 .El
 .
+.
 .Ss "Function Types"
 .
 This macro is intended for the
-.Sx SYNOPSIS
+.Dq Synopsis
 section.
-It may be used anywhere else in the man page without problems, but its main
-purpose is to present the function type in kernel normal form for the
-.Sx SYNOPSIS
-of sections two and three (it causes a line break, allowing the function
-name to appear on the next line).
+.
+It may be used anywhere else in the man page without problems,
+but its main purpose is to present the function type
+(in BSD kernel normal form)
+for the
+.Dq Synopsis
+of sections two and three.
+.
+(It causes a break,
+allowing the function name to appear on the next line.)
+.
+.
 .Pp
 .Dl Usage: .Ft Ao type Ac ...
 .Pp
@@ -1499,6 +1879,7 @@
 .Ft struct stat
 .El
 .
+.
 .Ss "Functions (Library Routines)"
 .
 The
@@ -1514,15 +1895,19 @@
 .Fn getchar
 .It Li ".Fn strlen ) ,"
 .Fn strlen ) ,
-.It Li ".Fn align \*qchar *ptr\*q ,"
+.It Li ".Fn align \dqchar *ptr\dq ,"
 .Fn align "char *ptr" ,
 .El
 .Pp
 Note that any call to another macro signals the end of the
 .Ql .Fn
 call (it will insert a closing parenthesis at that point).
+.
+.
 .Pp
-For functions with many parameters (which is rare), the macros
+For functions with many parameters
+(which is rare),
+the macros
 .Ql .Fo
 (function open)
 and
@@ -1566,31 +1951,40 @@
 .Fa "int buflen"
 .Fc
 .Ed
+.
+.
 .Pp
+Typically,
+in a
+.Dq Synopsis
+section,
+the function delcaration will begin the line.
+.
+If more than one function is presented in the
+.Dq Synopsis
+section and a function type has not been given,
+a break will occur,
+leaving vertical space between the current and prior function names.
+.\" XXX: that's not what "break" means
+.
 .
-In the
-.Sx SYNOPSIS
-section, the function will always begin at the beginning of line.
-If there is more than one function presented in the
-.Sx SYNOPSIS
-section and a function type has not been given, a line break will occur,
-leaving a nice vertical space between the current function name and the one
-prior.
 .Pp
 The default width values of
 .Ql .Fn
 and
 .Ql .Fo
-are 12n and 16n, respectively.
+are 12n and 16n,
+respectively.
+.
 .
 .Ss "Function Arguments"
 .
 The
 .Ql .Fa
 macro is used to refer to function arguments (parameters) outside of the
-.Sx SYNOPSIS
+.Sx Synopsis
 section of the manual or inside the
-.Sx SYNOPSIS
+.Sx Synopsis
 section if the enclosure macros
 .Ql .Fo
 and
@@ -1613,12 +2007,13 @@
 .
 The default width is 12n.
 .
+.
 .Ss "Return Values"
 .
 The
 .Ql .Rv
 macro generates text for use in the
-.Sx RETURN VALUES
+.Sx Return values
 section.
 .Pp
 .Dl Usage: .Rv Oo \-std Oc Op Ao function Ac ...
@@ -1643,12 +2038,13 @@
 .Fl std
 flag.
 .
+.
 .Ss "Exit Status"
 .
 The
 .Ql .Ex
 macro generates text for use in the
-.Sx DIAGNOSTICS
+.Sx Diagnostics
 section.
 .Pp
 .Dl Usage: .Ex Oo \-std Oc Op Ao utility Ac ...
@@ -1673,6 +2069,7 @@
 .Fl std
 flag.
 .
+.
 .Ss "Interactive Commands"
 .
 The
@@ -1684,7 +2081,7 @@
 .Bl -tag -width ".Li .Ic\ setenv\ ,\ unsetenv" -compact -offset 15n
 .It Li ".Ic :wq"
 .Ic :wq
-.It Li ".Ic \*qdo while {...}\*q"
+.It Li ".Ic \dqdo while {...}\dq"
 .Ic "do while {...}"
 .It Li ".Ic setenv , unsetenv"
 .Ic setenv , unsetenv
@@ -1693,6 +2090,7 @@
 .
 The default width is 12n.
 .
+.
 .Ss "Library Names"
 .
 The
@@ -1849,30 +2247,32 @@
 .It Li libz
 .Lb libz
 .El
-.Pp
 .
-Local, OS-specific additions might be found in the file
-.Pa mdoc.local ;
-look for strings named
-.Ql str\-Lb\-XXX .
-.Ql XXX
-then denotes the keyword to be used with the
-.Ql .Lb
-macro.
+.
 .Pp
-In the
-.Em LIBRARY
-section an
-.Ql .Lb
-command causes a line break before and after its arguments are printed.
+Site-specific additions might be found in the file
+.Pa mdoc.local ;
+see section
+.Sx Files
+below.
+.
+.
 .Pp
+In a section titled
+.Dq Library ,
+.Ql \&Lb
+causes a break before and after its arguments.
+.
 .
 .Ss Literals
 .
 The
-.Ql .Li
-literal macro may be used for special characters, variable constants, etc.\&
-\- anything which should be displayed as it would be typed.
+.Ql \&Li
+literal macro may be used for special characters,
+symbolic constants,
+and other syntactical items that should be typed exactly as displayed.
+.
+.
 .Pp
 .Dl Usage: .Li Ao argument Ac ...
 .Pp
@@ -1890,50 +2290,38 @@
 .
 The default width is 16n.
 .
+.
 .Ss Names
 .
 The
-.Ql .Nm
-macro is used for the document title or subject name.
-It has the peculiarity of remembering the first argument it was called with,
-which should always be the subject name of the page.
-When called without arguments,
-.Ql .Nm
-regurgitates this initial name for the sole purpose of making less work for
-the author.
-.Ql .Nm
-causes a line break within the
-.Sx SYNOPSIS
-section.
-.Pp
-Note: A section two or three document function name is addressed with the
-.Ql .Nm
-in the
-.Em NAME
-section, and with
-.Ql .Fn
-in the
-.Sx SYNOPSIS
-and remaining sections.
-For interactive commands, such as the
-.Ql while
-command keyword in
-.Xr csh 1 ,
-the
-.Ql .Ic
-macro should be used.
-While
-.Ql .Ic
-is nearly identical
-to
-.Ql .Nm ,
-it can not recall the first argument it was invoked with.
-.Pp
-.Dl Usage: .Nm Oo Ao argument Ac Oc ...
+.Ql \&Nm
+macro is used for the document title or page topic.
+.
+Upon its first call,
+it has the peculiarity of remembering its argument,
+which should always be the topic of the man page.
+.
+When subsequently called without arguments,
+.Ql \&Nm
+regurgitates this initial name for the sole purpose of making less work
+for the author.
+.
+Use of
+.Ql \&Nm
+is also appropriate when presenting a command synopsis for the topic of
+a man page in section 1,
+6,
+or 8.
+.
+Its behavior changes when presented with arguments of various forms.
+.
+.
 .Pp
 .Bl -tag -width ".Li .Nm\ groff_mdoc" -compact -offset 15n
 .It Li ".Nm groff_mdoc"
 .Nm groff_mdoc
+.It Li ".Nm"
+.Nm
 .It Li ".Nm \e\-mdoc"
 .Nm \-mdoc
 .It Li ".Nm foo ) ) ,"
@@ -1941,23 +2329,44 @@
 .It Li ".Nm :"
 .Nm :
 .El
+.
+.
 .Pp
+By default,
+the topic is set in boldface to reflect its prime importance in the
+discussion.
+.
+Cross references to other man page topics should use
+.Ql \&Xr ;
+including a second argument for the section number enables them to be
+hyperlinked.
+.
+By default,
+cross-referenced topics are set in italics to avoid cluttering the page
+with boldface.
+.
 .
+.Pp
 The default width is 10n.
 .
-.Ss Options
 .
+.Ss Options
 The
 .Ql .Op
 macro places option brackets around any remaining arguments on the
-command line, and places any trailing punctuation outside the brackets.
+command line,
+and places any trailing punctuation outside the brackets.
+.
 The macros
 .Ql .Oo
 and
 .Ql .Oc
-(which produce an opening and a closing option bracket respectively) may be used
-across one or more lines or to specify the exact position of the closing
-parenthesis.
+(which produce an opening and a closing option bracket,
+respectively)
+may be used across one or more lines or to specify the exact position of
+the closing parenthesis.
+.
+.
 .Pp
 .Dl Usage: .Op Oo Ao option Ac Oc ...
 .Pp
@@ -2014,14 +2423,20 @@
 .Ql .Oo
 are 14n and 10n, respectively.
 .
+.
 .Ss Pathnames
 .
 The
 .Ql .Pa
-macro formats path or file names.
-If called without arguments, the
+macro formats file specifications.
+.
+If called without arguments,
 .Sq Pa
-string is output, which represents the current user's home directory.
+(recognized by many shells)
+is output,
+representing the user's home directory.
+.
+.
 .Pp
 .Dl Usage: .Pa Oo Ao pathname Ac Oc ...
 .Pp
@@ -2037,6 +2452,7 @@
 .
 The default width is 32n.
 .
+.
 .Ss Standards
 .
 The
@@ -2119,10 +2535,14 @@
 X/Open
 .Pp
 .Bl -tag -width ".Li \-p1003.1g\-2000" -compact -offset indent
+.It Li \-susv1
+.St -susv1
 .It Li \-susv2
 .St -susv2
 .It Li \-susv3
 .St -susv3
+.It Li \-susv4
+.St -susv4
 .It Li \-svid4
 .St -svid4
 .It Li \-xbd5
@@ -2157,14 +2577,19 @@
 .St -iso8802-3
 .El
 .
-.Ss "Variable Types"
 .
+.Ss "Variable Types"
 The
 .Ql .Vt
 macro may be used whenever a type is referenced.
-In the
-.Sx SYNOPSIS
-section, it causes a line break (useful for old style variable declarations).
+.
+In a section titled
+.Dq Synopsis ,
+.Ql \&Vt
+causes a break
+(useful for old-style C variable declarations).
+.
+.
 .Pp
 .Dl Usage: .Vt Ao type Ac ...
 .Pp
@@ -2175,6 +2600,7 @@
 .Vt FILE *
 .El
 .
+.
 .Ss Variables
 .
 Generic variable reference.
@@ -2186,24 +2612,33 @@
 .Va count
 .It Li ".Va settimer ,"
 .Va settimer ,
-.It Li ".Va \*qint *prt\*q ) :"
+.It Li ".Va \dqint *prt\dq ) :"
 .Va "int *prt" ) :
-.It Li ".Va \*qchar s\*q  ) ) ,"
+.It Li ".Va \dqchar s\dq  ) ) ,"
 .Va "char s"  ) ) ,
 .El
 .Pp
 .
 The default width is 12n.
 .
+.
 .Ss "Manual Page Cross References"
 .
 The
 .Ql .Xr
 macro expects the first argument to be a manual page name.
-The optional second argument, if a string (defining the manual section), is
+.
+The optional second argument,
+if a string
+(defining the manual section),
+is
 put into parentheses.
+.
+.
 .Pp
 .Dl Usage: .Xr Ao man page name Ac Oo Ao section Ac Oc ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Xr\ xinit\ 1x\ ;" -compact -offset 15n
 .It Li ".Xr mdoc"
@@ -2215,12 +2650,14 @@
 .It Li ".Xr xinit 1x ;"
 .Xr xinit 1x ;
 .El
-.Pp
 .
+.
+.Pp
 The default width is 10n.
 .
 .
-.Sh "GENERAL TEXT DOMAIN"
+.Sh "General text domain"
+.
 .
 .Ss "AT&T Macro"
 .
@@ -2240,6 +2677,7 @@
 .Pp
 .Dl 32v, v1, v2, v3, v4, v5, v6, v7, III, V, V.1, V.2, V.3, V.4
 .
+.
 .Ss "BSD Macro"
 .
 .Pp
@@ -2264,6 +2702,7 @@
 .Pp
 .Dl Reno, reno, Tahoe, tahoe, Lite, lite, Lite2, lite2
 .
+.
 .Ss "NetBSD Macro"
 .
 .Pp
@@ -2281,7 +2720,8 @@
 see the description of the
 .Ql .Os
 command above in section
-.Sx "TITLE MACROS" .
+.Sx "Title macros" .
+.
 .
 .Ss "FreeBSD Macro"
 .
@@ -2300,7 +2740,8 @@
 see the description of the
 .Ql .Os
 command above in section
-.Sx "TITLE MACROS" .
+.Sx "Title macros" .
+.
 .
 .Ss "DragonFly Macro"
 .
@@ -2319,7 +2760,8 @@
 see the description of the
 .Ql .Os
 command above in section
-.Sx "TITLE MACROS" .
+.Sx "Title macros" .
+.
 .
 .Ss "OpenBSD Macro"
 .
@@ -2331,6 +2773,7 @@
 .Ox 1.0
 .El
 .
+.
 .Ss "BSD/OS Macro"
 .
 .Pp
@@ -2341,7 +2784,8 @@
 .Bsx 1.0
 .El
 .
-.Ss "UNIX Macro"
+.
+.Ss "Unix Macro"
 .
 .Pp
 .Dl Usage: .Ux ...
@@ -2351,6 +2795,7 @@
 .Ux
 .El
 .
+.
 .Ss "Emphasis Macro"
 .
 Text may be stressed or emphasized with the
@@ -2372,6 +2817,7 @@
 .
 The default width is 10n.
 .
+.
 .Ss "Font Mode"
 .
 The
@@ -2406,6 +2852,7 @@
 .Pp
 Both macros are neither callable nor parsed.
 .
+.
 .Ss "Enclosure and Quoting Macros"
 .
 The concept of enclosure is similar to quoting.
@@ -2416,8 +2863,10 @@
 Most of the one-line enclosure macros end in small letter
 .Ql q
 to give a hint of quoting, but there are a few irregularities.
-For each enclosure macro there is also a pair of open and close macros which
-end in small letters
+.
+For each enclosure macro,
+there is a pair of opening and closing macros that end with the
+lowercase letters
 .Ql o
 and
 .Ql c
@@ -2434,12 +2883,12 @@
 \&.Aq	.Ao	.Ac	Angle Bracket Enclosure	<string>
 \&.Bq	.Bo	.Bc	Bracket Enclosure	string
 \&.Brq	.Bro	.Brc	Brace Enclosure	{string}
-\&.Dq	.Do	.Dc	Double Quote	"string"
-\&.Eq	.Eo	.Ec	Enclose String (in XX)	XXstring
+\&.Dq	.Do	.Dc	Double Quote	\lqstring\rq
+\&.Eq	.Eo	.Ec	Enclose String (in XY)	XstringY
 \&.Pq	.Po	.Pc	Parenthesis Enclosure	(string)
-\&.Ql			Quoted Literal	\*Lqstring\*Rq or string
+\&.Ql			Quoted Literal	\lqstring\rq or string
 \&.Qq	.Qo	.Qc	Straight Double Quote	"string"
-\&.Sq	.So	.Sc	Single Quote	'string'
+\&.Sq	.So	.Sc	Single Quote	\oqstring\cq
 .TE
 .Pp
 All macros ending with
@@ -2450,30 +2899,50 @@
 .
 .Bl -tag -width ".Li .Ec , .Eo"
 .It Li .Eo , .Ec
-These macros expect the first argument to be the opening and closing strings
+These macros expect the first argument to be the opening and closing
+strings,
 respectively.
+.
 .It Li .Es , .En
-Due to the nine-argument limit in the original troff program two other
-macros have been implemented which are now rather obsolete:
+To work around the nine-argument limit in the original
+.Xr troff \" generic
+program,
+.Xr mdoc
+supports two other macros that are now obsolete.
+.
 .Ql .Es
-takes the first and second parameter as the left and right enclosure string,
-which are then used to enclose the arguments of
+uses its first and second parameters as opening and closing marks which
+are then used to enclose the arguments of
 .Ql .En .
+.
 The default width value is 12n for both macros.
+.
 .It Li .Eq
 The first and second arguments of this macro are the opening and
 closing strings respectively, followed by the arguments to be enclosed.
 .It Li .Ql
-The quoted literal macro behaves differently in troff and nroff mode.
+The quoted literal macro behaves differently in
+.Xr troff \" mode
+and
+.Xr nroff \" mode
+modes.
+.
 If formatted with
-.Xr nroff ,
+.Xr @g@nroff @MAN1EXT@ ,
 a quoted literal is always quoted.
-If formatted with troff, an item is only quoted if the width of the item is
-less than three constant width characters.
-This is to make short strings more visible where the font change to literal
-(constant width) is less noticeable.
+.
+If formatted with
+.Xr @g@troff ,
+an item is only quoted if the width of the item is less than three
+constant-width characters.
+.
+This is to make short strings more visible where the font change to
+literal (constant-width) is less noticeable.
+.
+.
 .Pp
 The default width is 16n.
+.
 .It Li .Pf
 The prefix macro suppresses the whitespace between its first and second
 argument:
@@ -2514,8 +2983,8 @@
 .Dq
 .It Li ".Dq string abc ."
 .Dq string abc .
-.It Li ".Dq \'^A\-Z\'"
-.Dq \'^A-Z\'
+.It Li ".Dq \aq\rshaA\-Z\aq"
+.Dq '\haA-Z'
 .It Li ".Ql man mdoc"
 .Ql man mdoc
 .It Li .Qq
@@ -2544,29 +3013,52 @@
 .Ql .Xc
 extended argument list macros are discussed below.
 .
-.Ss "No-Op or Normal Text Macro"
 .
-The
-.Ql .No
-macro can be used in a macro command line for parameters which should
+.Ss "Normal text macro"
+.
+.Ql \&No
+formats subsequent argument(s) normally,
+ending the effect of
+.Ql \&Em
+and similar.
+.
+Parsing is
 .Em not
-be formatted.
-Be careful to add
-.Ql \e&
-to the word
+suppressed,
+so you must prefix words like
 .Ql \&No
-if you really want that English word (and not the macro) as a parameter.
+with
+.Ql \e&
+to avoid their interpretation as
+.Xr mdoc
+macros.
+.
+.
 .Pp
-.Dl Usage: .No Ao argument Ac ...
+.Dl Usage: .No Ar argument No ...
+.
+.
 .Pp
-.Bl -tag -width ".Li .No\ test\ Ta\ with\ Ta\ tabs" -compact -offset 15n
-.It Li ".No test Ta with Ta tabs"
-.No test Ta with Ta tabs
+.Bl -tag -width ".Li .Em\ Use\ caution\ No\ here\ ." \
+-compact -offset 15n
+.It Li ".Em Use caution No here ."
+\->
+.Em Use caution No here .
+.It Li ".Em No dogs allowed ."
+\->
+.\" We cheat here to prevent a diagnostic warning.  We want to
+.\" illustrate output that may surprise the novice.
+.Em \&No No dogs allowed .
+.It Li ".Em \e&No dogs allowed ."
+\->
+.Em \&No dogs allowed .
 .El
-.Pp
 .
+.
+.Pp
 The default width is 12n.
 .
+.
 .Ss "No-Space Macro"
 .
 The
@@ -2596,65 +3088,95 @@
 is identical to
 .Ql .No .
 .
-.Ss "Section Cross References"
 .
-The
+.Ss "(Sub)section cross references"
+.
+Use the
 .Ql .Sx
-macro designates a reference to a section header within the same document.
+macro to cite a (sub)section heading within the given document.
+.
+.
 .Pp
-.Dl Usage: .Sx Ao section reference Ac ...
+.Dl Usage: .Sx Ao section-reference Ac ...
+.
+.
 .Pp
-.Bl -tag -width ".Li .Sx\ FILES" -offset 15n
-.It Li ".Sx FILES"
-.Sx FILES
+.Bl -tag -width ".Li .Sx\ Files" -offset 15n
+.It Li ".Sx Files"
+\->
+.Sx Files
 .El
-.Pp
 .
+.
+.Pp
 The default width is 16n.
 .
+.
 .Ss Symbolics
 .
 The symbolic emphasis macro is generally a boldface macro in either the
 symbolic sense or the traditional English usage.
+.
+.
 .Pp
 .Dl Usage: .Sy Ao symbol Ac ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Sy\ Important\ Notice" -compact -offset 15n
 .It Li ".Sy Important Notice"
+\->
 .Sy Important Notice
 .El
-.Pp
 .
+.
+.Pp
 The default width is 6n.
 .
-.Ss Mathematical Symbols
+.
+.Ss "Mathematical Symbols"
 .
 Use this macro for mathematical symbols and similar things.
+.
+.
 .Pp
 .Dl Usage: .Ms Ao math symbol Ac ...
+.
+.
 .Pp
 .Bl -tag -width ".Li .Ms\ sigma" -compact -offset 15n
 .It Li ".Ms sigma"
+\->
 .Ms sigma
 .El
-.Pp
 .
+.
+.Pp
 The default width is 6n.
 .
+.
 .Ss "References and Citations"
 .
 The following macros make a modest attempt to handle references.
-At best, the macros make it convenient to manually drop in a subset of
-.Xr refer 1
+.
+At best,
+the macros make it convenient to manually drop in a subset of
+.Xr @g@refer @MAN1EXT@
 style references.
+.
+.
 .Pp
 .Bl -tag -width 6n -offset indent -compact
 .It Li .Rs
-Reference start (does not take arguments).
-Causes a line break in the
-.Sx "SEE ALSO"
-section and begins collection of reference information until the reference
-end macro is read.
+Reference start
+(does not take arguments).
+.
+In a section titled
+.Dq "See also" ,
+it causes a break
+and begins collection of reference information until the reference end
+macro is read.
+.
 .It Li .Re
 Reference end (does not take arguments).
 The reference is printed.
@@ -2730,10 +3252,14 @@
 .Re
 .Ed
 .
-.Ss "Trade Names (or Acronyms and Type Names)"
+.Ss "Trade Names or Acronyms"
+.
+The trade name macro prints its arguments at a smaller type size.
+.
+It is intended to imitate a small caps fonts for fully capitalized
+acronyms.
+.
 .
-The trade name macro prints its arguments in a smaller font.
-Its intended use is to imitate a small caps fonts for uppercase acronyms.
 .Pp
 .Dl Usage: .Tn Ao symbol Ac ...
 .Pp
@@ -2747,6 +3273,7 @@
 .
 The default width is 10n.
 .
+.
 .Ss "Extended Arguments"
 .
 The
@@ -2769,11 +3296,13 @@
 using the space mode macro to turn spacing off:
 .
 .Bd -literal -offset indent
+\&.Bd \-literal \-offset indent
 \&.Sm off
 \&.It Xo Sy I Ar operation
 \&.No \een Ar count No \een
 \&.Xc
 \&.Sm on
+\&.Ed
 .Ed
 .Pp
 .
@@ -2793,12 +3322,14 @@
 Another one:
 .
 .Bd -literal -offset indent
+\&.Bd \-literal \-offset indent
 \&.Sm off
 \&.It Cm S No / Ar old_pattern Xo
 \&.No / Ar new_pattern
 \&.No / Op Cm g
 \&.Xc
 \&.Sm on
+\&.Ed
 .Ed
 .Pp
 .
@@ -2821,11 +3352,13 @@
 and enclosure macros: Test the value of a variable.
 .
 .Bd -literal -offset indent
+\&.Bd \-literal \-offset indent
 \&.It Xo
 \&.Ic .ifndef
 \&.Oo \e&! Oc Ns Ar variable Oo
-\&.Ar operator variable ...
+\&.Ar operator variable No ...
 \&.Oc Xc
+\&.Ed
 .Ed
 .Pp
 .
@@ -2836,21 +3369,23 @@
 .It Xo
 .Ic .ifndef
 .Oo \&! Oc Ns Ar variable Oo
-.Ar operator variable ...
+.Ar operator variable No ...
 .Oc Xc
 .El
 .Ed
 .Pp
 .
 .
-.Sh "PAGE STRUCTURE DOMAIN"
+.Sh "Page structure domain"
+.
 .
-.Ss "Section Headers"
+.Ss "Section headings"
 .
 The following
 .Ql .Sh
-section header macros are required in every man page.
-The remaining section headers are recommended at the discretion of the
+section heading macros are required in every man page.
+.
+The remaining section headings are recommended at the discretion of the
 author writing the manual page.
 The
 .Ql .Sh
@@ -2862,15 +3397,20 @@
 .Pp
 The default width is 8n.
 .
-.Bl -tag -width ".Li .Sh\ RETURN\ VALUES"
-.It Li ".Sh NAME"
+.Bl -tag -width ".Li .Sh\ Return\ values"
+.It Li ".Sh Name"
 The
-.Ql ".Sh NAME"
+.Ql ".Sh Name"
 macro is mandatory.
-If not specified, headers, footers and page layout defaults will not be set
-and things will be rather unpleasant.
+.
+If not specified,
+headers,
+footers,
+and page layout defaults will not be set and things will be rather
+unpleasant.
+.
 The
-.Em NAME
+.Em Name
 section consists of at least three items.
 The first is the
 .Ql .Nm
@@ -2887,7 +3427,7 @@
 .Ql \- ,
 then all its arguments.
 .
-.It Li ".Sh LIBRARY"
+.It Li ".Sh Library"
 This section is for section two and three function calls.
 It should consist of a single
 .Ql .Lb
@@ -2895,9 +3435,9 @@
 see
 .Sx "Library Names" .
 .
-.It Li ".Sh SYNOPSIS"
+.It Li ".Sh Synopsis"
 The
-.Sx SYNOPSIS
+.Sx Synopsis
 section describes the typical usage of the subject of a man page.
 The macros required are either
 .Ql .Nm ,
@@ -2929,7 +3469,7 @@
 .Nm cat
 .Op Fl benstuv
 .Op Fl
-.Ar
+.Ar file No ...
 .Ed
 .Pp
 .
@@ -2938,11 +3478,11 @@
 .Dl ".Nm cat"
 .Dl ".Op Fl benstuv"
 .Dl ".Op Fl"
-.Dl .Ar
+.Dl ".Ar file No ..."
 .
-.It Li ".Sh DESCRIPTION"
+.It Li ".Sh Description"
 In most cases the first text in the
-.Sx DESCRIPTION
+.Sx Description
 section is a brief paragraph on the command, function or file, followed by a
 lexical list of options and respective explanations.
 To create such a list, the
@@ -2956,15 +3496,15 @@
 .Sx Lists and Columns
 below).
 .
-.It Li ".Sh IMPLEMENTATION NOTES"
+.It Li ".Sh Implementation notes"
 Implementation specific information should be placed here.
 .
-.It Li ".Sh RETURN VALUES"
+.It Li ".Sh Return values"
 Sections 2, 3 and\~9 function return values should go here.
 The
 .Ql .Rv
 macro may be used to generate text for use in the
-.Sx RETURN VALUES
+.Sx Return values
 section for most section 2 and 3 library functions;
 see
 .Sx "Return Values" .
@@ -2973,100 +3513,111 @@
 .
 The following
 .Ql .Sh
-section headers are part of the preferred manual page layout and must be
-used appropriately to maintain consistency.
+section headings are part of the preferred manual page layout and must
+be used appropriately to maintain consistency.
 They are listed in the order in which they would be used.
 .
-.Bl -tag -width ".Li .Sh\ COMPATIBILITY"
-.It Li ".Sh ENVIRONMENT"
+.Bl -tag -width ".Li .Sh\ Compatibility"
+.It Li ".Sh Environment"
 The
-.Em ENVIRONMENT
+.Em Environment
 section should reveal any related environment variables and clues to their
 behavior and/or usage.
 .
-.It Li ".Sh FILES"
+.It Li ".Sh Files"
 Files which are used or created by the man page subject should be listed via
 the
 .Ql .Pa
 macro in the
-.Sx FILES
+.Sx Files
 section.
 .
-.It Li ".Sh EXAMPLES"
+.It Li ".Sh Examples"
 There are several ways to create examples.
-See the
+See subsection
 .Sx "Examples and Displays"
-section below for details.
+below for details.
 .
-.It Li ".Sh DIAGNOSTICS"
+.It Li ".Sh Diagnostics"
 Diagnostic messages from a command should be placed in this section.
 The
 .Ql .Ex
 macro may be used to generate text for use in the
-.Sx DIAGNOSTICS
+.Sx Diagnostics
 section for most section 1, 6 and\~8 commands;
 see
 .Sx "Exit Status" .
 .
-.It Li ".Sh COMPATIBILITY"
+.It Li ".Sh Compatibility"
 Known compatibility issues (e.g.\& deprecated options or parameters)
 should be listed here.
 .
-.It Li ".Sh ERRORS"
+.It Li ".Sh Errors"
 Specific error handling, especially from library functions (man page
 sections 2, 3, and\~9) should go here.
 The
 .Ql .Er
 macro is used to specify an error (errno).
 .
-.It Li ".Sh SEE ALSO"
-References to other material on the man page topic and cross references to
-other relevant man pages should be placed in the
-.Sx "SEE ALSO"
+.It Li ".Sh See also"
+References to other material on the man page topic and cross references
+to other relevant man pages should be placed in the
+.Sx "See also"
 section.
+.
 Cross references are specified using the
 .Ql .Xr
 macro.
+.
 Currently
-.Xr refer 1
+.Xr @g@refer @MAN1EXT@
 style references are not accommodated.
+.
+.
 .Pp
-It is recommended that the cross references are sorted on the section
-number, then alphabetically on the names within a section, and placed
-in that order and comma separated.
+It is recommended that the cross references be sorted by section number,
+then alphabetically by name within each section,
+then separated by commas.
+.
 Example:
+.
+.
 .Pp
 .Xr ls 1 ,
 .Xr ps 1 ,
 .Xr group 5 ,
 .Xr passwd 5
 .
-.It Li ".Sh STANDARDS"
-If the command, library function or file adheres to a specific
-implementation such as
+.It Li ".Sh Standards"
+If the command,
+library function,
+or file adheres to a specific implementation such as
 .St -p1003.2
 or
 .St -ansiC
 this should be noted here.
-If the command does not adhere to any standard, its history should be noted
-in the
-.Em HISTORY
+.
+If the command does not adhere to any standard,
+its history should be noted in the
+.Em History
 section.
 .
-.It Li ".Sh HISTORY"
+.It Li ".Sh History"
 Any command which does not adhere to any specific standards should be
 outlined historically in this section.
 .
-.It Li ".Sh AUTHORS"
+.It Li ".Sh Authors"
 Credits should be placed here.
+.
 Use the
 .Ql .An
 macro for names and the
 .Ql .Aq
-macro for e-mail addresses within optional contact information.
+macro for email addresses within optional contact information.
+.
 Explicitly indicate whether the person authored the initial manual page
 or the software or whatever the person is being credited for.
-.It Li ".Sh BUGS"
+.It Li ".Sh Bugs"
 Blatant problems with the topic go here.
 .El
 .Pp
@@ -3076,12 +3627,13 @@
 sections may be added; for example, this section was set with:
 .
 .Bd -literal -offset 15n
-\&.Sh "PAGE STRUCTURE DOMAIN"
+\&.Sh "Page structure domain"
 .Ed
 .
-.Ss "Subsection Headers"
 .
-Subsection headers have exactly the same syntax as section headers:
+.Ss "Subsection headings"
+.
+Subsection headings have exactly the same syntax as section headings:
 .Ql .Ss
 is parsed but not generally callable.
 It can be used as an argument in a call to
@@ -3091,6 +3643,7 @@
 .Pp
 The default width is 8n.
 .
+.
 .Ss "Paragraphs and Line Spacing"
 .
 .Bl -tag -width ".Li .Pp"
@@ -3236,44 +3789,64 @@
 .\" .De
 .\" .Pp
 .
+.
 .Ss Keeps
 .
 The only keep that is implemented at this time is for words.
+.
 The macros are
 .Ql .Bk
 (begin keep)
 and
 .Ql .Ek
 (end keep).
+.
 The only option that
 .Ql .Bk
-accepts currently is
+currently accepts is
 .Fl words
-(this is also the default if no option is given) which is useful for
-preventing line breaks in the middle of options.
-In the example for the make command-line arguments (see
+(also the default);
+this prevents breaks in the middle of options.
+.
+In the example for
+.Nm make
+command-line arguments
+(see
 .Sx What's in a Name ) ,
-the keep prevented
-.Xr nroff
-from placing up the flag and the argument on separate lines.
+the keep prevents
+.Xr @g@nroff
+from placing the flag and the argument on separate lines.
+.
+.
 .Pp
-Both macros are neither callable nor parsed.
+Neither macro is callable or parsed.
+.
+.
 .Pp
-More work needs to be done with the keep macros; specifically, a
+More work needs to be done on the keep macros;
+specifically,
+a
 .Fl line
 option should be added.
 .
+.
 .Ss "Examples and Displays"
 .
 There are seven types of displays.
+.
+.
 .Pp
 .Bl -tag -width ".Li .D1"
 .It Li .D1
 (This is D-one.)
 Display one line of indented text.
 This macro is parsed but not callable.
+.
+.
 .Pp
 .D1 Fl ldghfstru
+.
+.
 .Pp
 The above was produced by:
 .Li ".D1 Fl ldghfstru" .
@@ -3290,8 +3863,12 @@
 Its default font is set to constant width (literal).
 .Ql .Dl
 is parsed but not callable.
+.
+.
 .Pp
 .Dl % ls \-ldg /usr/local/bin
+.
+.
 .Pp
 The above was produced by:
 .Li ".Dl % ls \e\-ldg /usr/local/bin" .
@@ -3304,6 +3881,8 @@
 .Ql .Ed
 macro.
 It has the following syntax:
+.
+.
 .Pp
 .Bd -ragged -compact
 .Bl -tag -width ".Li .Bd" -offset indent
@@ -3312,25 +3891,34 @@
 .Oo \-offset Ao string Ac Oc Oo \-file Ao file name Ac Oc Oo \-compact Oc Xc
 .El
 .Ed
-.Pp
 .
+.
+.Pp
 .Bl -tag -width ".Fl file Ao Ar file name Ac " -compact
 .It Fl ragged
 Fill, but do not adjust the right margin (only left-justify).
+.
 .It Fl centered
 Center lines between the current left and right margin.
+.
 Note that each single line is centered.
+.
 .It Fl unfilled
-Do not fill; display a block of text as typed, using line breaks as
-specified by the user.
+Do not fill;
+break lines where their input lines are broken.
+.
 This can produce overlong lines without warning messages.
+.
 .It Fl filled
 Display a filled block.
 The block of text is formatted (i.e., the text is justified on both the left
 and right side).
+.
 .It Fl literal
 Display block with literal font (usually fixed-width).
+.
 Useful for source code or simple tabbed or spaced text.
+.
 .It Fl file Ao Ar file name Ac
 The file whose name follows the
 .Fl file
@@ -3339,15 +3927,18 @@
 and
 .Ql .Ed ,
 using the selected display type.
+.
 Any
-.Xr troff/ Ns Nm \-mdoc
+.Xr @g@troff/ Ns Xr mdoc
 commands in the file will be processed.
+.
 .It Fl offset Ao Ar string Ac
 If
 .Fl offset
 is specified with one of the following strings, the string is interpreted to
 indicate the level of indentation for the forthcoming block of text:
 .
+.
 .Pp
 .Bl -tag -width ".Ar indent-two" -compact
 .It Ar left
@@ -3373,17 +3964,18 @@
 .Em left
 aligns the block about two inches from the right side of the page.
 This macro needs work and perhaps may never do the right thing within
-.Xr troff .
+.Xr @g@troff .
 .El
-.Pp
 .
+.
+.Pp
 If
 .Ao string Ac
 is a valid numeric expression instead
-.Pf ( Em with a scale indicator other than
+.Pf ( Em with a scaling indicator other than
 .Sq Em u ) ,
 use that value for indentation.
-The most useful scale indicators are
+The most useful scaling indicators are
 .Sq m
 and
 .Sq n ,
@@ -3391,17 +3983,22 @@
 .Em \&Em
 and
 .Em "En square" .
+.
 This is approximately the width of the letters
 .Sq m
 and
 .Sq n
 respectively
-of the current font (for nroff output, both scale indicators give the same
-values).
+of the current font
+(for
+.Xr nroff
+output,
+both scaling indicators give the same values).
+.
 If
 .Ao string Ac
 isn't a numeric expression, it is tested whether it is an
-.Nm \-mdoc
+.Xr mdoc
 macro name, and the default offset value associated with this macro is used.
 Finally, if all tests fail,
 the width of
@@ -3415,27 +4012,41 @@
 End display (takes no arguments).
 .El
 .
+.
 .Ss "Lists and Columns"
 .
 There are several types of lists which may be initiated with the
 .Ql .Bl
 begin-list macro.
+.
 Items within the list are specified with the
 .Ql .It
-item macro, and each list must end with the
+item macro,
+and each list must end with the
 .Ql .El
 macro.
+.
 Lists may be nested within themselves and within displays.
-The use of columns inside of lists or lists inside of columns is unproven.
+.
+The use of columns inside of lists or lists inside of columns is
+untested.
+.
+.
 .Pp
-In addition, several list attributes may be specified such as the width of a
-tag, the list offset, and compactness (blank lines between items allowed or
-disallowed).
+In addition,
+several list attributes may be specified such as the width of a tag,
+the list offset,
+and compactness
+(blank lines between items allowed or disallowed).
+.
 Most of this document has been formatted with a tag style list
 .Pf ( Fl tag ) .
+.
+.
 .Pp
 It has the following syntax forms:
 .
+.
 .Pp
 .Bd -ragged -compact
 .Bl -tag -width ".Li .Bl" -offset indent -compact
@@ -3451,10 +4062,12 @@
 .Oo \-offset Ao string Ac Oc Oo \-compact Oc Xc
 .El
 .Ed
-.Pp
 .
+.
+.Pp
 And now a detailed description of the list types.
 .
+.
 .Pp
 .Bl -tag -width ".Fl column" -compact
 .It Fl bullet
@@ -3468,10 +4081,12 @@
 Bullet two here.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 Produces:
 .
+.
 .Pp
 .Bl -bullet -offset indent -compact
 .It
@@ -3479,6 +4094,8 @@
 .It
 Bullet two here.
 .El
+.
+.
 .Pp
 .
 .It Fl dash No ( or Fl hyphen )
@@ -3492,10 +4109,12 @@
 Dash two here.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 Produces:
 .
+.
 .Pp
 .Bl -dash -offset indent -compact
 .It
@@ -3503,8 +4122,9 @@
 .It
 Dash two here.
 .El
-.Pp
 .
+.
+.Pp
 .It Fl enum
 An enumerated list.
 .
@@ -3516,10 +4136,12 @@
 And item two here.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 The result:
 .
+.
 .Pp
 .Bl -enum -offset indent -compact
 .It
@@ -3527,11 +4149,14 @@
 .It
 And item two here.
 .El
-.Pp
 .
-If you want to nest enumerated lists, use the
+.
+.Pp
+If you want to nest enumerated lists,
+use the
 .Fl nested
-flag (starting with the second-level list):
+flag
+(starting with the second-level list):
 .
 .Bd -literal -offset indent
 \&.Bl \-enum \-offset indent \-compact
@@ -3547,10 +4172,12 @@
 And item four here.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 Result:
 .
+.
 .Pp
 .Bl -enum -offset indent -compact
 .It
@@ -3564,6 +4191,8 @@
 .It
 And item four here.
 .El
+.
+.
 .Pp
 .
 .It Fl item
@@ -3583,10 +4212,12 @@
 Item two here.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 Produces:
 .
+.
 .Pp
 .Bl -item -offset indent
 .It
@@ -3598,22 +4229,22 @@
 Item two here.
 Item two here.
 .El
-.Pp
 .
+.
+.Pp
 .It Fl tag
 A list with tags.
 Use
 .Fl width
 to specify the tag width.
 .
+.
 .Pp
 .Bl -tag -width "PPID" -compact -offset indent
 .It SL
 sleep time of the process (seconds blocked)
 .It PAGEIN
-number of disk
-.Tn I/O Ns 's
-resulting from references by the process
+number of disk I/O operations resulting from references by the process
 to pages not loaded in core.
 .It UID
 numerical user-id of process owner
@@ -3621,8 +4252,9 @@
 numerical id of parent of process priority
 (non-positive when in non-interruptible wait)
 .El
-.Pp
 .
+.
+.Pp
 The raw text:
 .
 .Bd -literal -offset indent
@@ -3630,10 +4262,8 @@
 \&.It SL
 sleep time of the process (seconds blocked)
 \&.It PAGEIN
-number of disk
-\&.Tn I/O Ns 's
-resulting from references by the process
-to pages not loaded in core.
+number of disk I/O operations resulting from references
+by the process to pages not loaded in core.
 \&.It UID
 numerical user\-id of process owner
 \&.It PPID
@@ -3641,14 +4271,17 @@
 (non\-positive when in non\-interruptible wait)
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 .It Fl diag
 Diag lists create section four diagnostic lists and are similar to inset
 lists except callable macros are ignored.
 The
 .Fl width
 flag is not meaningful in this context.
+.
+.
 .Pp
 Example:
 .
@@ -3658,16 +4291,18 @@
 The message says all.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 produces
 .
 .Bl -diag
 .It You can't use Sy here.
 The message says all.
 .El
-.Pp
 .
+.
+.Pp
 .It Fl hang
 A list with hanging tags.
 .
@@ -3679,6 +4314,8 @@
 blend into the paragraph unlike
 tagged paragraph labels.
 .El
+.
+.
 .Pp
 And the unformatted text which created it:
 .
@@ -3692,19 +4329,20 @@
 tagged paragraph labels.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 .It Fl ohang
-Lists with overhanging tags do not use indentation for the items; tags are
-written to a separate line.
+Lists with overhanging tags do not use indentation for the items;
+tags are written to a separate line.
+.
+.
 .Pp
 .Bl -ohang -offset indent
 .It Sy SL
 sleep time of the process (seconds blocked)
 .It Sy PAGEIN
-number of disk
-.Tn I/O Ns 's
-resulting from references by the process
+number of disk I/O operations resulting from references by the process
 to pages not loaded in core.
 .It Sy UID
 numerical user-id of process owner
@@ -3712,8 +4350,9 @@
 numerical id of parent of process priority
 (non-positive when in non-interruptible wait)
 .El
-.Pp
 .
+.
+.Pp
 The raw text:
 .
 .Bd -literal -offset indent
@@ -3721,10 +4360,8 @@
 \&.It Sy SL
 sleep time of the process (seconds blocked)
 \&.It Sy PAGEIN
-number of disk
-\&.Tn I/O Ns 's
-resulting from references by the process
-to pages not loaded in core.
+number of disk I/O operations resulting from references
+by the process to pages not loaded in core.
 \&.It Sy UID
 numerical user\-id of process owner
 \&.It Sy PPID
@@ -3732,8 +4369,9 @@
 (non\-positive when in non\-interruptible wait)
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 .It Fl inset
 Here is an example of inset labels:
 .Bl -inset -offset indent
@@ -3755,9 +4393,11 @@
 .It Em Inset
 Inset labels are useful for controlling blocks of
 paragraphs and are valuable for converting
-.Nm \-mdoc
+.Xr mdoc
 manuals to other formats.
 .El
+.
+.
 .Pp
 Here is the source text which produced the above example:
 .
@@ -3778,10 +4418,12 @@
 \&.It Em Inset
 Inset labels are useful for controlling blocks of
 paragraphs and are valuable for converting
-\&.Nm \-mdoc
+\&.Xr mdoc
 manuals to other formats.
 \&.El
 .Ed
+.
+.
 .Pp
 .
 .It Fl column
@@ -3798,7 +4440,7 @@
 starts with a
 .Ql .\&
 (dot) immediately followed by a valid
-.Nm \-mdoc
+.Xr mdoc
 macro name, interpret
 .Aq Ar stringN
 and use the width of the result.
@@ -3807,6 +4449,8 @@
 (typeset with a fixed-width font) is taken as the
 .Ar N Ns th
 column width.
+.
+.
 .Pp
 Each
 .Ql .It
@@ -3814,6 +4458,8 @@
 argument separated by a tab or the
 .Ql .Ta
 macro.
+.
+.
 .Pp
 The table:
 .
@@ -3822,8 +4468,9 @@
 .It Li <= Ta <= Ta \*(<=
 .It Li >= Ta >= Ta \*(>=
 .El
-.Pp
 .
+.
+.Pp
 was produced by:
 .
 .Bd -literal
@@ -3833,15 +4480,18 @@
 \&.It Li >= Ta >= Ta \e*(>=
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 Don't abuse this list type!
+.
 For more complicated cases it might be far better and easier to use
-.Xr tbl 1 ,
+.Xr @g@tbl @MAN1EXT@ ,
 the table preprocessor.
 .El
-.Pp
 .
+.
+.Pp
 Other keywords:
 .
 .Bl -tag -width ".Fl indent Ao Ar string Ac"
@@ -3851,11 +4501,14 @@
 starts with a
 .Ql .\&
 (dot) immediately followed by a valid
-.Nm \-mdoc
+.Xr mdoc
 macro name, interpret
 .Aq Ar string
 and use the width of the result.
+.
 Almost all lists in this document use this option.
+.
+.
 .Pp
 Example:
 .
@@ -3867,8 +4520,9 @@
 flag works in combination with a tag list.
 \&.El
 .Ed
-.Pp
 .
+.
+.Pp
 gives:
 .
 .Bl -tag -width ".Fl test Ao Ar string Ac"
@@ -3877,32 +4531,45 @@
 .Fl width
 flag works in combination with a tag list.
 .El
-.Pp
 .
+.
+.Pp
 (Note that the current state of
-.Nm \-mdoc
+.Xr mdoc
 is saved before
 .Aq Ar string
-is interpreted; afterwards, all variables are restored again.
-However, boxes (used for enclosures) can't be saved in
+is interpreted;
+afterwards,
+all variables are restored again.
+.
+However,
+boxes
+(used for enclosures)
+can't be saved in
 .Tn GNU
-.Xr troff 1 ;
-as a consequence, arguments must always be
+.Xr @g@troff @MAN1EXT@ ;
+as a consequence,
+arguments must always be
 .Em balanced
 to avoid nasty errors.
-For example, do not write
+.
+For example,
+do not write
 .Ql ".Ao Ar string"
 but
 .Ql ".Ao Ar string Xc"
 instead if you really need only an opening angle bracket.)
+.
+.
 .Pp
-Otherwise, if
+Otherwise,
+if
 .Aq Ar string
 is a valid numeric expression
-.Em ( with a scale indicator other than
+.Em ( with a scaling indicator other than
 .Sq Em u ) ,
 use that value for indentation.
-The most useful scale indicators are
+The most useful scaling indicators are
 .Sq m
 and
 .Sq n ,
@@ -3915,17 +4582,23 @@
 and
 .Sq n
 respectively
-of the current font (for nroff output, both scale indicators give the same
-values).
+of the current font
+(for
+.Xr @g@nroff
+output,
+both scaling indicators give the same values).
+.
 If
 .Aq Ar string
 isn't a numeric expression, it is tested whether it is an
-.Nm \-mdoc
+.Xr mdoc
 macro name, and the default width value associated with this macro is used.
 Finally, if all tests fail,
 the width of
 .Aq Ar string
 (typeset with a fixed-width font) is taken as the width.
+.
+.
 .Pp
 If a width is not specified for the tag list type,
 .Sq 6n
@@ -3935,7 +4608,8 @@
 .Aq Ar string
 is
 .Ar indent ,
-a default indent value (normally set to\~6n, similar to the value used in
+a default indent value (normally set to\~6n,
+similar to the value used in
 .Ql .Dl
 or
 .Ql .Bd )
@@ -3943,10 +4617,10 @@
 If
 .Aq Ar string
 is a valid numeric expression instead
-.Pf ( Em with a scale indicator other than
+.Pf ( Em with a scaling indicator other than
 .Sq Em u ) ,
 use that value for indentation.
-The most useful scale indicators are
+The most useful scaling indicators are
 .Sq m
 and
 .Sq n ,
@@ -3954,17 +4628,22 @@
 .Em \&Em
 and
 .Em "En square" .
+.
 This is approximately the width of the letters
 .Sq m
 and
 .Sq n
 respectively
-of the current font (for nroff output, both scale indicators give the same
-values).
+of the current font
+(for
+.Xr nroff
+output,
+both scaling indicators give the same values).
+.
 If
 .Aq Ar string
 isn't a numeric expression, it is tested whether it is an
-.Nm \-mdoc
+.Xr mdoc
 macro name, and the default offset value associated with this macro is used.
 Finally, if all tests fail,
 the width of
@@ -3975,299 +4654,690 @@
 .El
 .
 .
-.Sh "MISCELLANEOUS MACROS"
+.Sh "Miscellaneous macros"
+.
+A double handful of macros fit only uncomfortably into one of the above
+sections.
+.
+Of these,
+we couldn't find attested examples for
+.Ql \&Me
+or
+.Ql \&Ot .
 .
-Here a list of the remaining macros which do not fit well into one of the
-above sections.
-We couldn't find real examples for the following macros:
-.Ql .Me
-and
-.Ql .Ot .
-They are documented here for completeness \- if you know how to use them
-properly please send a mail to
+They are documented here for completeness\emif you know their proper
+usage,
+please send a mail to
 .Mt groff@gnu.org
-(including an example).
+and include a specimen with its provenance.
+.
 .
 .Bl -tag -width ".Li .Bt"
 .It Li .Bt
-prints
+formats boilerplate text.
 .
-.Bd -ragged -offset indent
+.\" XXX: .Bt gets parsed (i.e., called) _and_ measured even _with_ a
+.\" leading dot.  See Savannah #63672.
+.Bl -tag -width \&.Bt -offset indent
+.It Li .Bt
+\->
 .Bt
-.Ed
+.El
+.
+.
 .Pp
 It is neither callable nor parsed and takes no arguments.
 .
+Its default width is 6n.
+.
+.
 .It Li .Fr
+is an obsolete means of specifying a function return value.
+.
+.
 .Pp
-.Dl Usage: .Fr Ao function return value Ac ...
+.D1 Usage: Pf . Ic \&Fr Ar return-value No ...
+.
+.
 .Pp
-Don't use this macro.
-It allows a break right before the return value (usually a single digit)
+.Ql \&Fr
+allows a break right before the return value
+(usually a single digit)
 which is bad typographical behaviour.
-Use
-.Ql \e\ti
+.
+Instead,
+set the return value with the rest of the code,
+using
+.Ql \rs\ti
 to tie the return value to the previous word.
 .
+.
+.Pp
+Its default width is 12n.
+.
+.
 .It Li .Hf
-Use this macro to include a (header) file literally.
-It first prints
-.Ql File:
-followed by the file name, then the contents of
-.Ao file Ac .
+Inlines the contents of a (header) file into the document.
+.
+.
 .Pp
-.Dl Usage: .Hf Ao file Ac
+.D1 Usage: Pf . Ic \&Hf Ar file
+.
+.
 .Pp
+It first prints
+.Ql File:
+followed by the file name,
+then the contents of
+.Ar file .
+.
 It is neither callable nor parsed.
 .
+.
 .It Li .Lk
-To be written.
+Embed hyperlink.
+.
+.
+.Pp
+.D1 Usage: Pf . Ic \&Lk Ar uri Op Ar link-text
+.
+.
+.Pp
+Its default width is 6n.
+.
 .
 .It Li .Me
-Exact usage unknown.
-The documentation in the
-.Nm \-mdoc
-source file describes it as a macro for
+Usage unknown.
+.
+The
+.Xr mdoc
+sources describe it as a macro for
 .Dq "menu entries" .
+.
+.
 .Pp
 Its default width is 6n.
 .
+.
 .It Li .Mt
-To be written.
+Embed email address.
+.
+.
+.Pp
+.D1 Usage: Pf . Ic \&Mt Ar email-address
+.
+.
+.Pp
+Its default width is 6n.
+.
 .
 .It Li .Ot
-Exact usage unknown.
-The documentation in the
-.Nm \-mdoc
-source file describes it as
-.Dq old function type (fortran) .
+Usage unknown.
+The
+.Xr mdoc
+sources describe it as
+.Dq "old function type (fortran)" .
+.
 .
 .It Li .Sm
-Activate (toggle) space mode.
+Manipulate or toggle argument-spacing mode.
+.
+.
 .Pp
-.Dl Usage: .Sm Oo on | off Oc ...
+.D1 Usage: Pf . Ic \&Sm Oo Li on | Li off Oc ...
+.
+.
 .Pp
-If space mode is off, no spaces between macro arguments are inserted.
-If called without a parameter (or if the next parameter is neither
+If argument-spacing mode is off,
+no spaces between macro arguments are inserted.
+.
+If called without a parameter
+(or if the next parameter is neither
 .Ql on
 nor
-.Ql off ,
-.Ql .Sm
-toggles space mode.
+.Ql off ) ,
+.Ql \&Sm
+toggles argument-spacing mode.
+.
+.
+.Pp
+Its default width is 8n.
+.\" XXX: The package demands it, but how is that meaningful?
+.
 .
 .It Li .Ud
-prints
+formats boilerplate text.
 .
-.Bd -ragged -offset indent
+.\" XXX: .Ud gets parsed (i.e., called) _and_ measured even _with_ a
+.\" leading dot.  See Savannah #63672.
+.Bl -tag -width \&.Ud -offset indent
+.It Li .Ud
+\->
 .Ud
-.Ed
+.El
+.
+.
 .Pp
 It is neither callable nor parsed and takes no arguments.
+.
+Its default width is 8n.
 .El
 .
 .
-.Sh "PREDEFINED STRINGS"
+.Sh "Predefined strings"
+.
+The following strings are predefined for compatibility with legacy
+.Xr mdoc
+documents.
+.
+Contemporary ones should use the alternatives shown in the
+.Dq Prefer
+column below.
+.
+See
+.Xr groff_char @MAN7EXT@
+for a full discussion of these special character escape sequences.
+.
 .
-The following strings are predefined:
 .Pp
+.\" Note: This table pushes 80-column ASCII and Latin-1 terminals to
+.\" the limits of their capacity.  Observe the spacing parameters of the
+.\" 2nd and 3rd columns; we had to steal a character cell from each (the
+.\" default is 3) because in the UCS column, the word "infinity" gets
+.\" written out in full, which in turn pushes the >= and Ge rows past
+.\" the 78n norm.  Update with caution.  See Savannah #59424.
 .TS
-lb lb lb lb
-l l l l.
-String	Nroff	Troff	Meaning
-<=	<=  	\*<=	less equal
->=	>=  	\*>=	greater equal
-Rq	''  	\*Rq	right double quote
-Lq	``  	\*Lq	left double quote
-ua	^   	\*ua	upwards arrow
-aa	\'  	\*aa	acute accent
-ga	\`  	\*ga	grave accent
-q 	\&" 	\*q 	straight double quote
-Pi	pi  	\*Pi	greek pi
-Ne	!=  	\*Ne	not equal
-Le	<=  	\*Le	less equal
-Ge	>=  	\*Ge	greater equal
-Lt	<   	\*Lt	less than
-Gt	>   	\*Gt	greater than
-Pm	+\- 	\*Pm	plus minus
-If	infinity	\*If	infinity
-Am	\*Am	\*Am	ampersand
-Na	\*Na	\*Na	not a number
-Ba	\*Ba	\*Ba	vertical bar
+Cb Lb2 Lb2 Lb Lb Lb
+Lf(CR) L2 L2 L Lf(CR) L.
+String	7-bit	8-bit	UCS	Prefer	Meaning
+\rs*(<=	<=  	<=	\*<=	\rs(<=	less than or equal to
+\rs*(>=	>=  	>=	\*>=	\rs(>=	greater than or equal to
+\rs*(Rq	"  	"	\*Rq	\rs(rq	right double quote
+\rs*(Lq	"  	"	\*Lq	\rs(lq	left double quote
+\rs*(ua	\ha	\ha	\*ua	\rs(ua	vertical arrow up
+\rs*(aa	\aq	\'	\*aa	\rs(aa	acute accent
+\rs*(ga	\`  	\`	\*ga	\rs(ga	grave accent
+\rs*(q 	\&" 	\&"	\*q 	\rs(dq	neutral double quote
+\rs*(Pi	pi  	pi	\*Pi	\rs(*p	lowercase pi
+\rs*(Ne	!=  	!=	\*Ne	\rs(!=	not equals
+\rs*(Le	<=  	<=	\*Le	\rs(<=	less than or equal to
+\rs*(Ge	>=  	>=	\*Ge	\rs(>=	greater than or equal to
+\rs*(Lt	<   	<	\*Lt	<	less than
+\rs*(Gt	>   	>	\*Gt	>	greater than
+\rs*(Pm	+\- 	\+-	\*Pm	\rs(+\-	plus or minus
+\rs*(If	infinity	infinity	\*If	\rs(if	infinity
+\rs*(Am	\*Am	\*Am	\*Am	&	ampersand
+\rs*(Na	\*Na	\*Na	\*Na	NaN	not a number
+\rs*(Ba	\*Ba	\*Ba	\*Ba	|	bar
 .TE
+.
+.
 .Pp
-The names of the columns
-.Sy Nroff
+Some column headings are shorthand for standardized character encodings;
+\lq7-bit\rq for ISO 646:1991 IRV (US-ASCII),
+\lq8-bit\rq for ISO 8859-1 (Latin-1) and IBM code page 1047,
 and
-.Sy Troff
-are a bit misleading;
-.Sy Nroff
-shows the
-.Tn ASCII
-representation, while
-.Sy Troff
-gives the best glyph form available.
-For example, a Unicode enabled
-.Tn TTY Ns - Ns
-device will have proper glyph representations for all strings, whereas the
-enhancement for a Latin1
-.Tn TTY Ns - Ns
-device is only the plus-minus sign.
-.Pp
-String names which consist of two characters can be written as
-.Ql \e*(xx ;
-string names which consist of one character can be written as
-.Ql \e*x .
-A generic syntax for a string name of any length is
-.Ql \e*xxx
-(this is a
-.Tn GNU
-.Xr troff 1
-extension).
+\lqUCS\rq for ISO 10646 (Unicode character set).
+.
+Historically, \" (\ti1989)
+.Xr mdoc
+configured the string definitions to fit the capabilities expected of
+the output device.
+.
+Old typesetters \" like the C/A/T
+lacked directional double quotes,
+producing repeated directional single quotes
+\oq\oqlike this\cq\cq;
+early versions of
+.Xr mdoc
+in fact defined the
+.Ql Lq
+and
+.Ql Rq
+strings this way. \" thanks to Ingo Schwarze for the research
 .
+Nowadays,
+output drivers \" technically, their macro files or font descriptions
+take on the responsibility of glyph substitution,
+as they possess relevant knowledge of their available repertoires.
 .
-\#
-\#=====================================================================
-\#
-.Sh DIAGNOSTICS
+.
+.Sh Diagnostics
 .
 The debugging macro
 .Ql .Db
-available in previous versions of
-.Nm \-mdoc
-has been removed since
+offered by
+previous versions of
+.Xr mdoc
+is unavailable in
 .Tn GNU
-.Xr troff 1
-provides better facilities to check parameters; additionally, many error and
-warning messages have been added to this macro package, making it both more
-robust and verbose.
-.Pp
-The only remaining debugging macro is
-.Ql .Rd
-which yields a register dump of all global registers and strings.
+.Xr @g@troff @MAN1EXT@
+since the latter provides better facilities to check parameters;
+additionally,
+.Xr "groff mdoc"
+implements many error and warning messages,
+making the package more robust and more verbose.
+.
+.
+.Pp
+The remaining debugging macro is
+.Ql .Rd ,
+which dumps the package's global register and string contents to the
+standard error stream.
+.
 A normal user will never need it.
 .
 .
-.Sh "FORMATTING WITH GROFF, TROFF, AND NROFF"
+.Sh Options
+.
+The following
+.Xr groff
+options set registers
+(with
+.Fl r )
+and strings
+(with
+.Fl d )
+recognized and used by the
+.Xr mdoc
+macro package.
+.
+To ensure rendering consistent with output device capabilities and
+reader preferences,
+man pages should never manipulate them.
+.
 .
-By default, the package inhibits page breaks, headers, and footers if
-displayed with a
-.Tn TTY
-device like
+.Pp
+Setting string
+.Ql AD
+configures the adjustment mode for most formatted text.
+.
+Typical values are
+.Ql b
+for adjustment to both margins
+(the default),
+or
+.Ql l
+for left alignment
+(ragged right margin).
+.
+Any valid argument to
+.Xr groff Ns 's
+.Ql ad
+request may be used.
+.
+See
+.Xr groff @MAN7EXT@
+for less-common choices.
+.
+.Dl groff \-Tutf8 \-dAD=l \-mdoc groff_mdoc.7 | less \-R
+.
+.
+.Pp
+Setting register
+.Ql C
+to\~1 numbers output pages consecutively,
+rather than resetting the page number to\~1
+(or the value of register
+.Ql P )
+with each new
+.Xr mdoc
+document.
+.
+.
+.Pp
+By default,
+the package inhibits page breaks,
+headers,
+and footers in the midst of the document text if it is being displayed
+with a terminal device such as
 .Sq latin1
 or
-.Sq unicode ,
-to make the manual more efficient for viewing on-line.
-This behaviour can be changed (e.g.\& to create a hardcopy of the
-.Tn TTY
-output) by setting the register
+.Sq utf8 ,
+to enable more efficient viewing of the page.
+.
+This behavior can be changed to format the page as if for 66-line
+Teletype output by setting the continuous rendering register
 .Ql cR
 to zero while calling
-.Xr groff 1 ,
-resulting in multiple pages instead of a single, very long page:
-.Pp
+.Xr groff @MAN1EXT@ .
+.
 .Dl groff \-Tlatin1 \-rcR=0 \-mdoc foo.man > foo.txt
+.
+On HTML devices,
+it cannot be disabled.
+.
+.
 .Pp
-For double-sided printing, set register
-.Ql D
-to\~1:
+Section headings
+(defined with
+.Ql .Sh )
+and page titles in headers
+(defined with
+.Ql .Dt )
+can be presented in full capitals by setting the registers
+.Ql CS
+and
+.Ql CT ,
+respectively,
+to 1.
+.
+These transformations are off by default because they discard case
+distinction information.
+.
+.
 .Pp
+Setting register
+.Ql D
+to\~1 enables double-sided page layout,
+which is only distinct when not continuously rendering.
+.
+It places the page number at the bottom right on odd-numbered (recto)
+pages,
+and at the bottom left on even-numbered (verso) pages,
+swapping places with the arguments to
+.Ql .Os .
+.
 .Dl groff \-Tps \-rD1 \-mdoc foo.man > foo.ps
+.
+.
 .Pp
-To change the document font size to 11pt or 12pt, set register
-.Ql S
-accordingly:
+The value of the
+.Ql FT
+register determines the footer's distance from the page bottom;
+this amount is always negative and should specify a scaling unit.
+.
+At one half-inch above this location,
+the page text is broken before writing the footer.
+.
+It is ignored if continuous rendering is enabled.
+.
+The default is \-0.5i.
+.
+.
 .Pp
-.Dl groff \-Tdvi \-rS11 \-mdoc foo.man > foo.dvi
+The
+.Ql HF
+string sets
+the font used for section and subsection headings;
+the default is
+.Ql B
+(bold style of the default family).
+.
+Any valid argument to
+.Xr groff Ns 's
+.Ql ft
+request may be used.
+.
+.
 .Pp
-Register
-.Ql S
-is ignored for
-.Tn TTY
-devices.
+Normally,
+automatic hyphenation is enabled using a mode appropriate to the
+.Xr groff
+locale;
+see section \lqLocalization\lq of
+.Xr groff @MAN7EXT@ .
+.
+It can be disabled by setting the
+.Ql HY
+register to zero.
+.
+.Dl groff \-Tutf8 \-rHY=0 \-mdoc foo.man | less \-R
+.
+.
+.Pp
+The paragraph and subsection heading indentation amounts can be changed
+by setting the registers
+.Ql IN
+and
+.Ql SN .
+.
+.Dl groff \-Tutf8 \-rIN=5n \-rSN=2n \-mdoc foo.man | less \-R
+.
+The default paragraph indentation is 7.2n on typesetters and 7n on
+terminals.
+.
+The default subsection heading indentation amount is 3n;
+section headings are set with an indentation of zero.
+.
+.
 .Pp
-The line and title length can be changed by setting the registers
+The line and title lengths can be changed by setting the registers
 .Ql LL
 and
 .Ql LT ,
 respectively:
+.
+.Dl groff \-Tutf8 \-rLL=100n \-rLT=100n \-mdoc foo.man | less \-R
+.
+If not set,
+both registers default to 78n for terminal devices and 6.5i otherwise.
+.
+.
 .Pp
-.Dl groff \-Tutf8 \-rLL=100n \-rLT=100n \-mdoc foo.man | less
+Setting the
+.Ql P
+register starts enumeration of pages at its value.
+.
+The default is\~1.
+.
+.
 .Pp
-If not set, both registers default to 78n for TTY devices and 6.5i
-otherwise.
+To change the document font size to 11p or 12p,
+set register
+.Ql S
+accordingly:
+.
+.Dl groff \-Tdvi \-rS11 \-mdoc foo.man > foo.dvi
+.
+Register
+.Ql S
+is ignored when formatting for terminal devices.
 .
 .
-.Sh FILES
+.Pp
+Setting the
+.Ql X
+register to a page number
+.Ar p
+numbers its successors as
+.Ar p Ns Li a ,
+.Ar p Ns Li b ,
+.Ar p Ns Li c ,
+and so forth.
+.
+The register tracking the suffixed page letter uses format
+.Ql a
+(see the
+.Ql af
+request in
+.Xr groff @MAN7EXT@ ) .
+.
+.
+.br
+.ne 4v
+.Sh Files
+.
+.Bl -tag
+.It Pa @MACRODIR@/\:andoc\:.tmac
+This brief
+.Xr groff
+program detects whether the
+.Xr man
+or
+.Xr mdoc
+macro package is being used by a document and loads the correct macro
+definitions,
+taking advantage of the fact that pages using them must call
+.Li TH
+or
+.Li Dd ,
+respectively,
+before any other macros.
+.
+A user typing,
+for example,
+.Dl groff \-mandoc page.1
+need not know which package the file
+.Pa page.1
+uses.
+.
+Multiple man pages,
+in either format,
+can be handled;
+.Pa \%andoc\:.tmac
+reloads each macro package as necessary.
+.
+.
+.It Pa @MACRODIR@/\:doc\:.tmac
+implements the bulk of the
+.Xr groff Xr mdoc
+package and loads further components as needed from the
+.Pa mdoc
+subdirectory.
+.
 .
-.Bl -tag -width mdoc/doc-ditroff -compact
-.It Pa doc.tmac
-The main manual macro package.
-.It Pa mdoc.tmac
-A wrapper file to call
+.It Pa @MACRODIR@/\:mdoc\:.tmac
+is a wrapper that loads
 .Pa doc.tmac .
-.It Pa mdoc/doc-common
-Common strings, definitions, stuff related typographic output.
-.It Pa mdoc/doc-nroff
-Definitions used for a
-.Tn TTY
-output device.
-.It Pa mdoc/doc-ditroff
-Definitions used for all other devices.
-.It Pa mdoc.local
-Local additions and customizations.
-.It Pa andoc.tmac
-Use this file if you don't know whether the
-.Nm \-mdoc
-or the
-.Nm \-man
-package should be used.
-Multiple man pages (in either format) can be handled.
+.
+.
+.It Pa @MACRODIR@/\:mdoc/\:doc\-common
+defines macros,
+registers,
+and strings
+concerned with the production of formatted output.
+.\" XXX: This is a weak explanation.  The boundary between doc.tmac's
+.\" concerns and doc-common's is not at all clear to GBR.  Should some
+.\" of these files be merged?
+.
+It includes strings of the form
+.Ql doc\-volume\-ds\- Ns Ar X
+and
+.Ql doc\-volume\-as\- Ns Ar X
+for manual section titles and architecture identifiers,
+respectively,
+where
+.Ar X
+is an argument recognized by
+.Pf . Ic \&Dt .
+.
+.
+.It Pa @MACRODIR@/\:mdoc/\:doc\-nroff
+defines parameters appropriate for rendering to terminal devices.
+.
+.
+.It Pa @MACRODIR@/\:mdoc/\:doc\-ditroff
+defines parameters appropriate for rendering to typesetter devices.
+.
+.
+.It Pa @MACRODIR@/\:mdoc/\:doc\-syms
+defines many strings and macros that interpolate formatted text,
+such as names of operating system releases,
+*BSD libraries,
+and standards documents.
+.
+The string names are of the form
+.Ql doc\-str\- Ns Ar O Ns Li \- Ns Ar V ,
+.Ql doc\-str\-St Ns Li \-\- Ns Ar S Ns Li \- Ns Ar I
+(observe the double dashes),
+or
+.Ql doc\-str\-Lb\- Ns Ar L ,
+where
+.Ar O
+is one of the operating system macros from section
+.Sx "General text domain"
+above,
+.Ar V
+is an encoding of an operating system release
+(sometimes omitted along with the
+.Ql \-
+preceding it),
+.Ar S
+an identifier for a standards body or committee,
+.Ar I
+one for an issue of a standard promulgated by
+.Ar S ,
+and
+.Ar L
+a keyword identifying a *BSD library.
+.
+.
+.It Pa @LOCALMACRODIR@/\:mdoc\:.local
+This file houses local additions and customizations to the package.
+.
+It can be empty.
 .El
 .
 .
-.Sh "SEE ALSO"
+.Sh "See also"
+.
+The
+.Lk https://mandoc.bsd.lv/ mandoc
+project maintains an independent implementation of the
+.Xr mdoc
+language and a renderer that directly parses its markup as well as that
+of
+.Xr man .
+.
 .
-.Xr groff 1 ,
+.Pp
+.Xr groff @MAN1EXT@ ,
 .Xr man 1 ,
-.Xr troff 1 ,
-.Xr groff_man 7
+.Xr @g@troff @MAN1EXT@ ,
+.Xr groff_man @MAN7EXT@ ,
+.Xr mdoc 7
 .
 .
-.Sh BUGS
+.Sh Bugs
 .
 Section 3f has not been added to the header routines.
+.
+.
 .Pp
-.Ql \&.Nm
-font should be changed in
-.Em NAME
-section.
+.Ql .Fn
+needs to have a check to prevent splitting up the line if its length is
+too short.
+.
+Occasionally it separates the last parenthesis,
+and sometimes looks ridiculous if output lines are being filled.
+.
+.
 .Pp
-.Ql \&.Fn
-needs to have a check to prevent splitting up
-if the line length is too short.
-Occasionally it
-separates the last parenthesis, and sometimes
-looks ridiculous if a line is in fill mode.
+The list and display macros do not do any keeps and certainly should be
+able to.
+.
+.
 .Pp
-The list and display macros do not do any keeps
-and certainly should be able to.
+As of
+.Xr groff
+1.23,
+.Ql \&Tn
+no longer changes the type size;
+this functionality may return in the next release.
 .\" Note what happens if the parameter list overlaps a newline
 .\" boundary.
 .\" to make sure a line boundary is crossed:
 .\" .Bd -literal
 .\" \&.Fn struct\e\ dictionarytable\e\ *dictionarylookup struct\e\ dictionarytable\e\ *tab
 .\" .Ed
+.\" .
+.\" .
 .\" .Pp
 .\" produces, nudge nudge,
 .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab ,
 .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab ,
 .\" nudge
 .\" .Fn struct\ dictionarytable\ *dictionarylookup char\ *h struct\ dictionarytable\ *tab .
+.\" .
+.\" .
 .\" .Pp
 .\" If double quotes are used, for example:
 .\" .Bd -literal
 .\" \&.Fn \*qstruct dictionarytable *dictionarylookup\*q \*qchar *h\*q \*qstruct dictionarytable *tab\*q
 .\" .Ed
+.\" .
+.\" .
 .\" .Pp
 .\" produces, nudge nudge,
 .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab" ,
@@ -4275,24 +5345,28 @@
 .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab" ,
 .\" nudge
 .\" .Fn "struct dictionarytable *dictionarylookup" "char *h" "struct dictionarytable *tab" .
+.\" .
+.\" .
 .\" .Pp
 .\" Not a pretty sight...
 .\" In a paragraph, a long parameter containing unpaddable spaces as
 .\" in the former example will cause
-.\" .Xr troff
+.\" .Xr @g@troff
 .\" to break the line and spread
 .\" the remaining words out.
 .\" The latter example will adjust nicely to
 .\" justified margins, but may break in between an argument and its
 .\" declaration.
 .\" In
-.\" .Xr nroff
-.\" the right margin adjustment is normally ragged and the problem is
-.\" not as severe.
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.\" .Xr @g@nroff
+.\" the right margin is normally ragged and the problem is not as
+.\" severe.
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_mdoc_7_man_C
+.do rr *groff_groff_mdoc_7_man_C
+.
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_me.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_me.7.man Changed

@@ -1,58 +1,97 @@
 '\" t
-.TH GROFF_ME @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_me \- \(lqme\(rq macro package for formatting documents with GNU \
-roff
+.TH groff_me @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_me \- \(lqme\(rq macro package for formatting
+.I roff
+documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1980 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (C) 1980, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
 .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
 .\"
-.\"	@(#)me.7	6.4 (Berkeley) 4/13/90
+.\"	@(#)me.7	8.1 (Berkeley) 06/05/93
 .\"
 .\" Modified for groff by jjc@jclark.com
 .\" Changed to use TBL and eliminate low-level troff hackery by ESR
 .\" (this enables it to be lifted to structural markup).
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_me_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY "groff \-me"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
-.YS
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
 .SY "groff \-m me"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
+The GNU implementation of the
+.I me
+macro package is part of the
+.I groff
+document formatting system.
+.
 The
 .I me
 package of macro definitions for the
@@ -60,398 +99,402 @@
 language provides a convenient facility for preparing technical papers
 in various formats.
 .
-This manual page describes the GNU version of the
+This version is based on the
 .I me
-macros, which is
-part of the
-.I groff
-document formatting system.
-.
-This version can be used with both GNU
+distributed with 4.4BSD and can be used with the GNU
 .I troff
-and Unix
+formatter as well as those descended from AT&T
 .IR troff .
 .
 .
-.PP
-Many
-.I roff
-requests are unsafe in conjunction with this package; however, the
-following requests may be used with impunity after the first
-.BR .pp :
+.P
+Some formatter requests affect page layout unpredictably when used in
+conjunction with this package;
+however,
+the following may be used with impunity after the first call to a
+paragraphing macro like
+.B lp
+or
+.BR pp .
+.
+Some arguments are optional;
+see
+.MR groff @MAN7EXT@
+for details,
+particularly of requests whose argument list is designated with an
+ellipsis.
+.
+An asterisk
+.B *
+marks
+.I groff
+extensions.
+.
+.
+.P
 .TS
-l l.
-\fB.bp\fP	begin new page
-\fB.br\fP	break output line here
-\fB.sp\fP \fIn\fP	insert \fIn\fP spacing lines
-\fB.ls\fP \fIn\fP	(line spacing) \fIn\fP=1 single, \fIn\fP=2 double space
-\fB.na\fP	no alignment of right margin
-\fB.ce\fP \fIn\fP	center next \fIn\fP lines
-\fB.ul\fP \fIn\fP	underline next \fIn\fP lines
+Lb1 Li L.
+ad	c	set text adjustment mode to \fIc
+af	r f	assign format \fIf\fP to register \fIr
+am	m e	append to macro \fIm\fP until \fIe\fP called
+as	s t	append rest of line \fIt\fP to string \fIs
+bp	n	begin new page numbered \fIn
+br	\&	break output line
+ce	n	center next \fIn\fP output lines
+cp	n	en-/disable AT&T \fItroff\fP compatibility mode\fB*
+de	m e	define macro \fIm\fP until \fIe\fP called
+do	t	interpret input \fIt\fP with compatibility mode off\fB*
+ds	s t	define rest of line \fIt\fP as string \fIs
+el	t	interpret \fIt\fP if corresponding \fBie\fP false
+fc	c d	set field delimiter \fIc\fP and padding glyph \fId
+fi	\&	enable filling
+hc	c	set hyphenation character to \fIc
+hy	m	set automatic hyphenation mode to \fIm
+ie	p t	as \fBif\fP, but enable interpretation of later \fBel
+if	p t	if condition \fIp\/\fP, interpret rest of line \fIt
+in	h	set indentation to distance \fIh\fP
+lc	c	set leader repetition glyph to \fIc
+ls	n	set line spacing to \fIn
+mc	c h	set (right) margin glyph to \fIc\fP at distance \fIh
+mk	r	mark vertical position in register \fIr\fP
+na	\&	disable adjustment of text
+ne	v	need vertical space of distance \fIv
+nf	\&	disable filling
+nh	\&	disable automatic hyphenation
+nr	r n i	assign register \fIr\fP value \fIn\fP with \
+auto-increment \fIi
+ns	\&	begin no-space mode
+pl	v	set page length to \fIv
+pn	n	set next page number to \fIn
+po	h	set page offset to \fIh
+rj	n	right-align next \fIn\fP output lines\fB*
+rm	m	remove macro, string, or request \fIm
+rn	m n	rename macro, string, or request \fIm\fP to \fIn
+rr	r	remove register \fIr
+rs	\&	resume spacing (end no-space mode)
+rt	v	return to vertical position set by \fBmk\fP, or \fIv
+so	f	source (interpolate) input file \fIf
+sp	n	insert \fIn\fP lines of vertical space
+ta	\fR.\|.\|.	set tab stops
+tc	c	set tab repetition glyph to \fIc
+ti	h	set temporary indentation (next line only) to \fIh
+tl	\fR.\|.\|.	output three-part title
+tr	\fR.\|.\|.	translate characters
+ul	n	underline next \fIn\fP output lines
 .TE
-.PP
-.I Note:
-In contrast to its behavior with other macro packages and \(lqraw\(rq
-.IR roff ,
-when using the
+.
+.
+.P
+Except on title pages
+(produced by calling
+.BR tp ),
 .I me
-package,
+suppresses the output of vertical space at the tops of pages
+(after the output of any page header);
 the
-.B .sp
-request will
-.I not
-put space at the top of a page.
+.B sp
+request will thus not work there.
+.
+You can instead call
+.B bl
+or enclose the desired spacing request in a diversion,
+for instance by calling
+.B (b
+and
+.BR )b .
 .
+.I me
+also intercepts the
+.B ll
+request;
+see the
+.RI \lq me
+Reference Manual\rq
+for details.
 .
-.PP
-Output of the
-.IR pic ,
-.IR eqn ,
-.IR refer ,
-and
-.I tbl
-preprocessors
-is acceptable as input.
+.
+.\" ====================================================================
+.SS "Name space"
+.\" ====================================================================
+.
+Objects in
+.I me
+follow a rigid naming convention.
+.
+To avoid conflict,
+any user-defined register,
+string,
+or macro
+names should be single numerals or uppercase letters,
+or any longer sequence of letters and numerals
+with at least one uppercase letter.
+.
+(For portability between BSD and
+.I groff
+.IR me ,
+limit names to
+two characters,
+and avoid the name
+.B 
+(left square bracket).)
+.
+The names employed
+by any preprocessors in use
+should also not be repurposed.
 .
 .
 .\" ====================================================================
-.SS Macro Reference
+.SS Macros
 .\" ====================================================================
 .
-Numeric arguments to macros are denoted with lowercase letters and
-string arguments with uppercase.
-.
-An optional macro argument such as
-.I x
-appears in brackets,
-.BI  x \/\c
-.BR  .
-.
-Note that arguments to macros generally must be quoted if they contain
-whitespace.
-.
-An exception is the argument to header and footer macros, which require
-some explanation.
-They take the form
-.RI \(lq c
-.I left c middle c right
-.IR c \(rq,
-with spaces added here for clarity.
-The strings
-.IR left ,
-.IR middle ,
-and
-.I right
-correspond to their page placement and can contain unprotected
-whitespace, but must not contain the (non-space) character
-.IR c ,
-which delimits them.
-For brevity, the table presents header and footer arguments as
-.IR clcmcrc .
-Popular choices for
-.I c
-are the ASCII apostrophe
-.RB \(lq \(aq \(rq
-and the ASCII double quote
-.RB \(lq \(dq \(rq.
-.
-.
-.PP
-This list is incomplete;
-some requests are too complex to summarize in a table, and some that
-are listed below accept additional arguments not shown.
-See the
-.I \-me Reference Manual
-for interesting details.
-.
-.
-.PP
-.na
+.ne 2v \" Keep at least the first entry together with the heading.
 .TS
-l l l lx.
-Request	Initial	Causes	Explanation
-	Value	Break
-_
-\&.(c	\-	yes	T{
-Begin centered block.
-T}
-\&.(d	\-	no	T{
-Begin delayed text.
-T}
-\&.(f	\-	no	T{
-Begin footnote.
-T}
-\&.(l	\-	yes	Begin list.
-\&.(q	\-	yes	T{
-Begin major quote.
-T}
-\&.(x \fIX\fP	\-	no	T{
-Begin item in index (named
-.IR X ).
-T}
-\&.(z	\-	no	T{
-Begin floating keep.
-T}
-\&.)c	\-	yes	T{
-End centered block.
-T}
-\&.)d	\-	yes	T{
-End delayed text.
-T}
-\&.)f	\-	yes	T{
-End footnote.
-T}
-\&.)l	\-	yes	End list.
-\&.)q	\-	yes	T{
-End major quote.
-T}
-\&.)x	\-	yes	T{
-End index item.
-T}
-\&.)z	\-	yes	T{
-End floating keep.
-T}
-\&.++ \fIM\fP \fIclcmcrc\fP	\-	no	T{
-Define paper section as
-.IR M ,
-which must be one of
-.B C
-(chapter),
-.B A
-(appendix),
-.B P
-(preliminary, i.e., front matter or table of contents),
-.B AB
-(abstract),
-.B B
-(bibliography),
-.B RC
-(chapters renumbered from page one each chapter),
-or
-.B RA
-(appendix renumbered from page one)
-(and set page header to
-.IR clcmcrc ).
-T}
-\&.+c \fIT\fP	\-	yes	T{
-Begin chapter (or appendix, etc., as set by
-.BR .++ )
-(with title
-.IR T ).
-T}
-\&.1c	1	yes	T{
-One-column format on a new page.
-T}
-\&.2c	1	yes	T{
-Two-column format.
-T}
-\&.EN	\-	yes	T{
-Space after equation
-produced by
-.I eqn
-or
-.IR neqn .
-T}
-\&.EQ \fIM\fP \fIT\fP	\-	yes	T{
-Begin displayed equation (with indentation
-.IR M ,
-which must be one of
-.B C
-(centered, default),
-.B I
-(indented),
-or
-.B L
-(justified left) (and title
-.I T
-in right margin)).
-T}
-\&.GE	\-	yes	T{
-End \fIgremlin\fP picture.
-T}
-\&.GS	\-	yes	T{
-Begin \fIgremlin\fP picture.
-T}
-\&.PE	\-	yes	T{
-End \fIpic\fP picture.
-T}
-\&.PS	\-	yes	T{
-Begin \fIpic\fP picture.
-T}
-\&.TE	\-	yes	T{
-End
-.I tbl
-table.
-T}
-\&.TH	\-	yes	T{
-End heading of
-.I tbl
-table.
-T}
-\&.TS \fBH\fP	\-	yes	T{
-Begin
-.I tbl
-table; if
-.BR H ,
-table repeats heading on each page.
-T}
-\&.b \fIX\fP \fIY\fP	\-	no	T{
-Print
-.I X
-in bold (appending
-.I Y
-in the previous font); if no arguments, switch to bold.
-T}
-\&.ba \fIn\fP	0	yes	T{
-Augment the base indent (for regular text, like paragraphs)
-by
-.IR n .
-T}
-\&.bc	\-	yes	T{
-Begin new column.
-T}
-\&.bi \fIX\fP \fIY\fP	\-	no	T{
-Print
-.I X
-in bold italics (appending
-.I Y
-in the previous font); if no arguments, switch to bold italics.
-T}
-\&.bu	\-	yes	T{
-Begin bulleted paragraph.
-T}
-\&.bx \fIX\fP \fIY\fP	\-	no	T{
-Print \fIX\fP in a box (with Y appended).
-Renders reliably only in no-fill mode.
-T}
-\&.ef \fIclcmcrc\fP	""""	no	T{
-Set even-numbered page footer.
-T}
-\&.eh \fIclcmcrc\fP	""""	no	T{
-Set even-numbered page header.
-T}
-\&.fo \fIclcmcrc\fP	""""	no	T{
-Set page footer.
-T}
-\&.hx	\-	no	T{
-Suppress headers and footers on next page.
-T}
-\&.he \fIclcmcrc\fP	""""	no	T{
-Set page header.
-T}
-\&.hl	\-	yes	T{
-Draw a horizontal line.
-T}
-\&.i \fIX\fP \fIY\fP	\-	no	T{
-Print
-.I X
-in italics (appending
-.I Y
-in the previous font); if no arguments, switch to italics.
-T}
-\&.ip \fIX\fP \fIn\fP	\fIn\fP=5n	yes	T{
-Start indented paragraph (with hanging tag
-.I X
-(and indentation
-.IR n )).
-T}
-\&.lp	\-	yes	T{
-Begin paragraph with first line flush left.
-T}
-\&.np	1	yes	T{
-Start numbered paragraph.
-T}
-\&.of \fIclcmcrc\fP	""""	no	T{
-Set odd-numbered page footer.
-T}
-\&.oh \fIclcmcrc\fP	""""	no	T{
-Set odd-numbered page header.
-T}
-\&.pd	\-	yes	T{
-Print delayed text.
-T}
-\&.pp	\-	yes	T{
-Begin paragraph with indented first line.
-T}
-\&.r \fIX\fP \fIY\fP	\-	no	T{
-Print
-.I X
-in roman (appending
-.I Y
-in the previous font); if no arguments, switch to roman.
-T}
-\&.re	0.5i	no	T{
-Reset tabs to default values.
-T}
-\&.sh \fIn\fP \fIT\fP	\fIn\fP=1	yes	T{
-Start numbered section; print section number (set to
-.I n
-(and title
-.IR T ))
-in bold.
-T}
-\&.sk	\-	no	T{
-Leave the next page blank.
-Only one page is remembered ahead.
-T}
-\&.sm \fIX\fP \fIY\fP	\-	no	T{
-Print
-.I X
-in a smaller point size (appending
-.I Y
-at the previous size).
-T}
-\&.sz \fIn\fP	10p	no	T{
-Augment the point size by
-.I n
-points.
-T}
-\&.tp	\-	yes	T{
-Begin title page.
-T}
-\&.u \fIX\fP \fIY\fP	\-	no	T{
-Underline
-.I X
-(appending
-.I Y
-without underlining).
-Renders reliably only in no-fill mode.
-T}
-\&.uh \fIT\fP	\-	yes	T{
-Start unnumbered section (and print title
-.I T
-in bold).
-T}
-\&.xp \fIX\fP	\-	no	T{
-Print index (named
-.IR X ).
-T}
+Lb L.
+$0	post-section heading hook
+$1	pre-section depth 1 hook
+$2	pre-section depth 2 hook
+$3	pre-section depth 3 hook
+$4	pre-section depth 4 hook
+$5	pre-section depth 5 hook
+$6	pre-section depth 6 hook
+$C	post-chapter title hook
+$H	page/column heading hook
+$c	output chapter number and title
+$f	output footer
+$h	output header
+$p	output section heading
+$s	output footnote area separator
+(b	begin block
+(c	begin centered block
+(d	begin delayed text
+(f	begin footnote
+(l	begin list
+(q	begin long quotation
+(x	begin index entry
+(z	begin floating keep
+)b	end block
+)c	end centered block
+)d	end delayed text
+)f	end footnote
+)l	end list
+)q	end long quotation
+)x	end index entry
+)z	end floating keep
+++	set document segment type
++c	begin chapter
+1c	end multi-column layout
+2c	begin multi-column layout
+EN	end \fI@g@eqn\fP equation
+EQ	begin \fI@g@eqn\fP equation
+GE	end \fI@g@grn\fP picture with drawing position at bottom
+GF	end \fI@g@grn\fP picture with drawing position at top
+GS	start \fI@g@grn\fP picture
+IE	end \fIideal\fP picture with drawing position at bottom
+IF	end \fIideal\fP picture with drawing position at top
+IS	start \fIideal\fP picture
+PE	end \fI@g@pic\fP picture with drawing position at bottom
+PF	end \fI@g@pic\fP picture with drawing position at top
+PS	start \fI@g@pic\fP picture
+TE	end \fI@g@tbl\fP table
+TH	end heading for multi-page \fI@g@tbl\fP table
+TS	start \fI@g@tbl\fP table
+b	embolden argument
+ba	set base indentation
+bc	begin new column
+bi	embolden and italicize argument
+bx	box argument
+ef	set even-numbered page footer
+eh	set even-numbered page header
+ep	end page
+fo	set footer
+he	set header
+hl	draw horizontal line
+hx	suppress next page's headers/footers
+i	italicize argument
+ip	begin indented paragraph
+ld	reset localization and date registers and strings\fB*
+ll	set line length
+lp	begin fully left-aligned paragraph
+np	begin numbered paragraph
+of	set odd-numbered page footer
+oh	set odd-numbered page header
+pd	output delayed text
+pp	begin first-line indented paragraph
+q	quote argument
+r	set argument in roman
+re	reset tab stops
+sh	begin numbered section
+sm	set argument at smaller type size
+sx	change section depth
+sz	set type size and vertical spacing
+tp	begin title page
+u	underline argument
+uh	begin unnumbered section
+xl	set line length (local)
+xp	output index
+.TE
+.
+.
+.P
+Some macros are provided for \(lqold\(rq
+.MR roff 1
+compatibility.
+.
+The
+.RI \(lq me
+Reference Manual\(rq
+describes alternatives for modern documents.
+.
+.
+.P
+.ne 2v \" Keep at least the first entry together with the heading.
+.TS
+Lb L.
+ar	use Arabic numerals for page numbers
+bl	insert space (even at page top; cf.\& \fBsp\fP)
+ix	set indentation without break
+m1	set page top to header distance
+m2	set header to text distance
+m3	set text to footer distance
+m4	set footer to page bottom distance
+n1	begin output line numbering
+n2	end or alter output line numbering
+pa	begin page
+ro	use Roman numerals for page numbers
+sk	skip next page
 .TE
 .
 .
 .\" ====================================================================
-.SH FILES
+.SS Registers
 .\" ====================================================================
 .
-.I @MACRODIR@/me.tmac
-(a wrapper file for
-.IR e.tmac )
-.br
+.ne 2v \" Keep at least the first entry together with the heading.
+.TS
+Lb L.
+$0	section depth
+$1	first section number component
+$2	second section number component
+$3	third section number component
+$4	fourth section number component
+$5	fifth section number component
+$6	sixth section number component
+$c	current column number
+$d	delayed text number
+$f	footnote number
+$i	paragraph base indentation
+$l	column width
+$m	number of available columns
+$p	numbered paragraph number
+$s	column spacing (indentation)
+bi	display (block) indentation
+bm	distance from text area to page bottom
+bs	display (block) pre/post space
+bt	block threshold for keeps
+ch	current chapter number
+df	display font
+dv	vertical spacing of displayed text (as percentage)\fB*
+es	equation pre/post space
+ff	footnote font
+fi	footnote indentation (first line only)
+fm	footer margin
+fp	footnote type size in points
+fs	footnote prespace
+fu	footnote undent (right indentation)
+hm	header margin
+ii	indented paragraph indentation
+no	line numbering offset\fB*
+pf	paragraph font
+pi	paragraph indentation
+po	page offset
+pp	paragraph type size in points
+ps	paragraph prespace
+qi	long quotation left/right indentation
+qp	long quotation type size in points
+qs	long quotation pre/post space
+sf	section title font
+si	section indentation per level of depth
+so	additional section title offset
+sp	section title type size in points
+ss	section prespace
+sx	super/subscript line height increase\fB*
+tf	title font
+tm	distance from page top to text area
+tp	title type size in points
+tv	vertical spacing of text (as percentage)\fB*
+xs	index entry prespace
+xu	index undent (right indentation)
+y2	year of the century\fB*
+y4	year\fB*
+yr	year minus 1900
+zs	floating keep pre/post space
+.TE
+.
+.
+.\" ====================================================================
+.SS Strings
+.\" ====================================================================
+.
+.ne 2v \" Keep at least the first entry together with the heading.
+.TS
+Lb L.
+#	delayed text marker
+$n	concatenated section number
+*	footnote marker
+\-	em dash
+<	begin subscripting
+>	end subscripting
+dw	weekday name
+lq	left double quotation mark
+mo	month name
+rq	right double quotation mark
+td	date
+wa	term for \(lqappendix\(rq used by \fB.$c*
+wc	term for \(lqchapter\(rq used by \fB.$c*
+{	begin superscripting
+}	end superscripting
+.TE
+.
+.
+.\" ====================================================================
+.SH Files
+.\" ====================================================================
+.
+.TP
 .I @MACRODIR@/e.tmac
+implements the package.
+.
+.
+.TP
+.I @MACRODIR@/refer\-me.tmac
+implements
+.MR @g@refer @MAN1EXT@
+support for
+.IR me .
+.
+.
+.TP
+.I @MACRODIR@/me.tmac
+is a wrapper enabling the package to be loaded with
+.RB \lq "groff \-m me" \rq.
 .
 .
 .\" ====================================================================
-.SH NOTES
+.SH Notes
 .\" ====================================================================
 .
 Early
 .I roff
-macro packages limited themselves to a single-letter namespace
-.RI ( mm ,
+macro packages often limited their names to a single letter,
+which followed the formatter's
+.B m
+flag letter,
+resulting in
+.IR mm ,
 .IR ms ,
 .IR mv ,
 .IR mn ,
-etc.).
+and so on.
 .
 .\" 'When I started writing the -me macros it began as something in my
 .\" private tree (I don't remember what I called it).  Then some other
@@ -468,7 +511,7 @@
 .\" package, nroff/troff is basically unusable; -me stepped into the
 .\" vacuum.' -- Eric Allman
 .\"
-.\" https://minnie.tuhs.org//pipermail/tuhs/2018-November/015412.html
+.\" https://minnie.tuhs.org/pipermail/tuhs/2018-November/017033.html
 .
 The \(lqe\(rq in \(lqme\(rq stands for \(lqEric P.\& Allman\(rq,
 who wrote the macro package and the original technical papers
@@ -476,52 +519,83 @@
 .
 .
 .\" ====================================================================
-.SH SEE ALSO
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (1),
-.BR troff (1)
-.
 .
-.PP
 Two manuals are available in source and rendered form.
 .
 On your system,
 they may be compressed and/or available in additional formats.
 .
 .
+.br
+.ne 3v
 .TP
 .I @DOCDIR@/meintro.me
 .TQ
 .I @DOCDIR@/meintro.ps
 is
-.IR "Writing Papers with Groff Using \-me" ,
-by Eric P.\& Allman and James Clark.
+\lqWriting Papers with
+.I Groff
+Using
+.RI \- me \rq,
+by Eric P.\& Allman,
+adapted for
+.I groff
+by James Clark.
 .
 .
+.br
+.ne 4v
 .TP
 .I @DOCDIR@/meref.me
 .TQ
 .I @DOCDIR@/meref.ps
 is the
-.IR "\-me Reference Manual" ,
-by Eric P.\& Allman and James Clark.
+.RI \lq me
+Reference Manual\rq,
+by Eric P.\& Allman,
+adapted for
+.I groff
+by James Clark and G.\& Branden Robinson.
+.
+.
+.P
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
 .
+You can browse it interactively with \lqinfo groff\rq.
 .
-.PP
+.
+.P
 For preprocessors supported by
 .IR me ,
 see
-.BR eqn (1),
-.BR grn (1),
-.BR pic (1),
-.BR refer (1),
+.MR @g@eqn @MAN1EXT@ ,
+.MR @g@grn @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@refer @MAN1EXT@ ,
 and
-.BR tbl (1).
+.MR @g@tbl @MAN1EXT@ .
+.
+.
+.P
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR groff @MAN7EXT@
+.
+.
+.\" Restore compatibility mode (for, e.g., Solaris 10/11).
+.cp \n*groff_groff_me_7_man_C
+.do rr *groff_groff_me_7_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
-.\" tab-with: 20
 .\" End:
-.\" vim: set filetype=nroff tabstop=20:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_ms.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_ms.7.man Changed

@@ -1,19 +1,16 @@
 '\" t
-.TH GROFF_MS @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_ms \- GNU roff manuscript macro package for formatting documents
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_ms_C \n.C
-.cp 0
+.TH groff_ms @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_ms \- GNU
+.I roff
+manuscript macro package for formatting documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -31,1015 +28,1442 @@
 .\" instead of in the original English.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_ms_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
-.SY "groff -ms"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
-.SY "groff -m ms"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
+.SY "groff \-m@TMAC_S_PREFIX@s"
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.
+.SY "groff \-m m@TMAC_S_PREFIX@s"
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This manual page describes the GNU version of the
+The GNU implementation of the
 .I ms
-macros,
-part of the
+macro package is part of the
 .I groff
-typesetting system.
+document formatting system.
 .
 The
 .I ms
-macros are mostly compatible with the documented behavior of the 4.3
-BSD Unix
-.I ms
-macros (see
-.I Differences from troff ms
-below for details).
+package is suitable for the composition of
+letters,
+memoranda,
+reports,
+and books.
+.
+.
+.LP
+These
+.I groff
+macros support cover page and table of contents generation,
+automatically numbered headings,
+several paragraph styles,
+a variety of text styling options,
+footnotes,
+and multi-column page layouts.
 .
-The
 .I ms
-macros are suitable for reports, letters, books, and technical
-documentation.
+supports the
+.MR @g@tbl @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+and
+.MR @g@refer @MAN1EXT@
+preprocessors for inclusion of tables,
+mathematical equations,
+diagrams,
+and standardized bibliographic citations.
+.
+.
+.LP
+This implementation is mostly compatible with the documented interface
+and behavior of AT&T Unix Version\~7
+.IR ms .
+.
+Many extensions from 4.2BSD (Berkeley)
+.\" Few changes were made in 4.3, Reno, Tahoe, or 4.4.
+and Tenth Edition Research Unix have been recreated.
 .
 .
 .\" ====================================================================
-.SH USAGE
+.SH Usage
 .\" ====================================================================
 .
 The
 .I ms
-macro package expects files to have a certain amount of structure.
+macro package expects a certain amount of structure:
+a well-formed document contains at least one paragraphing or heading
+macro call.
+.
+.\" This sentence is unique to the man page because we omit the "Basic
+.\" information" section from ms.ms.
+To compose a simple document from scratch,
+begin it by calling
+.B .LP
+or
+.BR .PP .
 .
-The simplest documents can begin with a paragraph macro and consist of
-text separated by paragraph macros or even blank lines.
+Longer documents have a structure as follows.
 .
-Longer documents have a structure as follows:
 .
 .TP
-.B "Document type"
-If you use the
+.B Document type
+Calling the
 .B RP
-(report) macro at the beginning of the document,
-.I groff
-prints the cover page information on its own page;
-otherwise it prints the information on the
-first page with your document text immediately following.
+macro at the beginning of your document puts the document description
+(see below)
+on a cover page.
 .
-Other document formats found in AT&T
-.I troff
-are specific to AT&T or Berkeley, and are not supported in
+Otherwise,
+.I ms
+places this information
+on the first page,
+followed immediately by the body text.
+.
+Some document types found in other
+.I ms
+implementations are specific to AT&T or Berkeley,
+and are not supported in
 .IR "groff ms" .
 .
+.
 .TP
 .B "Format and layout"
-By setting number registers,
-you can change your document's
-margins, spacing, headers and footers, footnotes,
-and the base point size for the text.
+By setting registers and strings,
+you can configure your document's typeface,
+margins,
+spacing,
+headers and footers,
+and footnote arrangement.
+.
+See subsection \lqDocument control settings\rq below.
 .
-See
-.I "Document control registers"
-below for more details.
 .
 .TP
-.B "Cover page"
-A cover page consists of a title,
-and optionally the author's name and institution,
-an abstract, and the date.
+.B Document description
+A document description consists of any of:
+a title,
+one or more authors' names and affiliated institutions,
+an abstract,
+and a date or other identifier.
+.
+See subsection \lqDocument description macros\rq below.
 .
-See
-.I "Cover page macros"
-below for more details.
 .
 .TP
-.B "Body"
-Following the cover page is your document.
-It consists of paragraphs, headings, and lists.
+.B Body text
+The main matter of your document follows its description
+(if any).
+.
+.I ms
+supports highly structured text consisting of paragraphs interspersed
+with multi-level headings
+(chapters,
+sections,
+subsections,
+and so forth)
+and augmented by lists,
+footnotes,
+tables,
+diagrams,
+and similar material.
+.
+The preponderance of subsections below covers these matters.
+.
 .
 .TP
 .B "Table of contents"
-Longer documents usually include a table of contents,
-which you can add by placing the
-.B TC
-macro at the end of your document.
+Macros enable the collection of entries for a table of contents
+(or index)
+as the material they discuss appears in the document.
+.
+You then call a macro to emit the table of contents at the end of
+your document.
+.
+The table of contents must necessarily follow the rest of the text since
+GNU
+.I troff \" GNU
+is a single-pass formatter;
+it thus cannot determine the page number of a division of the text until
+it has been set and output.
+.
+Since
+.I ms
+output was designed for the production of hard copy,
+the traditional procedure was to manually relocate the pages containing
+the table of contents between the cover page and the body text.
+.
+Today,
+page resequencing is more often done in the digital domain.
+.
+An index works similarly,
+but because it typically needs to be sorted after collection,
+its preparation requires separate processing.
 .
 .
 .\" ====================================================================
-.SS "Document control registers"
+.SS "Document control settings"
 .\" ====================================================================
 .
-The following table lists the document control
-number registers.
+The following tables list the document control registers,
+strings,
+and special characters.
 .
-For the sake of consistency,
-set registers related to margins at the beginning of your document,
-or just after the
-.B RP
-macro.
+For any parameter whose default is unsatisfactory,
+define it before calling any
+.I ms
+macro other than
+.BR RP .
 .
 .
 .LP
-.ne 12
-.B Margin settings
-.RS
+.ne 7v
 .TS
+cb    s  s  s
 cb   cb cb cb
-lfCW l  l  l.
-Reg.	Definition	Effective	Default
+lf(CR) lx  l  lf(CR).
+Margin settings
+Parameter	Definition	Effective	Default
 _
-PO	Page offset (left margin)	next page	1i
-LL	Line length	next paragraph	6i
-LT	Header/footer length	next paragraph	6i
-HM	Top (header) margin	next page	1i
-FM	Bottom (footer) margin	next page	1i
+\rsnPO	Page offset (left margin)	next page	1i (0)
+\rsnLL	Line length	next paragraph	6.5i (65n)
+\rsnLT	Title line length	next paragraph	6.5i (65n)
+\rsnHM	Top (header) margin	next page	1i
+\rsnFM	Bottom (footer) margin	next page	1i
 _
 .TE
-.RE
+.
 .
 .LP
-.ne 12
-.B Text settings
-.RS
+.ne 8v
 .TS
+cb    s  s  s
 cb   cb cb cb
-lfCW lx l  l.
-Reg.	Definition	Effective	Default
+lf(CR) lx  l  lf(CR).
+Titles (headers, footers)
+Parameter	Definition	Effective	Default
 _
-PS	T{
-Point size
-T}	next paragraph	10p
-VS	T{
-Line spacing (leading)
-T}	next paragraph	12p
-PSINCR	T{
-Point size increment
-for section headings of
-increasing importance
-T}	next heading	1p
-GROWPS	T{
-Heading level
-beyond which PSINCR
-is ignored
-T}	next heading	0
+\rs*LH	Left header text	next header	\fIempty
+\rs*CH	Center header text	next header	\-\rsn%\-
+\rs*RH	Right header text	next header	\fIempty
+\rs*LF	Left footer text	next footer	\fIempty
+\rs*CF	Center footer text	next footer	\fIempty
+\rs*RF	Right footer text	next footer	\fIempty
 _
 .TE
-.RE
+.
 .
 .LP
-.ne 11
-.B Paragraph settings
-.RS
+.ne 6v
 .TS
+cb   s  s  s
 cb   cb cb cb
-lfCW lx l  l.
-Reg.	Definition	Effective	Default
+lf(CR) lx l  lf(CR).
+Text settings
+Parameter	Definition	Effective	Default
 _
-PI	T{
-Initial indent
-T}	next paragraph	5n
-PD	T{
-Space between paragraphs
-T}	next paragraph	0.3v
-QI	T{
-Quoted paragraph indent
-T}	next paragraph	5n
-PORPHANS	T{
-Number of initial lines
-to be kept together
-T}	next paragraph	1
-HORPHANS	T{
-Number of initial lines
-to be kept with heading
-T}	next heading	1
+\rsnPS	Point size	next paragraph	10p
+\rsnVS	Vertical spacing (leading)	next paragraph	12p
+\rsnHY	Hyphenation mode	next paragraph	6
+\rs*FAM	Font family	next paragraph	T
 _
 .TE
-.RE
+.
 .
 .LP
-.ne 7
-.B Footnote settings
-.RS
+.ne 6v
 .TS
+cb   s  s  s
 cb   cb cb cb
-lfCW l  l  l.
-Reg.	Definition	Effective	Default
+lf(CR)2 lx l  lf(CR).
+Paragraph settings
+Parameter	Definition	Effective	Default
 _
-FL	Footnote length	next footnote	\rsnLL*5/6
-FI	Footnote indent	next footnote	2n
-FF	Footnote format	next footnote	0
-FPS	Point size	next footnote	\rsnPS\-2
-FVS	Vert.\& spacing	next footnote	\rsnFPS+2
-FPD	Para.\& spacing	next footnote	\rsnPD/2
+\rsnPI	Indentation	next paragraph	5n
+\rsnPD	Paragraph distance (spacing)	next paragraph	0.3v\
+ \fR(\f1v\fR)
+\rsnQI	Quotation indentation	next paragraph	5n
+\rsnPORPHANS	# of initial lines kept	next paragraph	1
 _
 .TE
-.RE
 .
+.
+.ne 10v \" Keep table and subsequent paragraph together.
 .LP
-.ne 6
-.B Other settings
-.RS
 .TS
+cb   s  s  s
 cb   cb cb cb
-lfCW l  l  l.
-Reg.	Definition	Effective	Default
+lf(CR) lx l  lf(CR).
+Heading settings
+Parameter	Definition	Effective	Default
 _
-DD	Display, table, eqn, pic spacing	next para.	0.5v
-MINGW	Minimum width between columns	next page	2n
+\rsnPSINCR	Point size increment	next heading	1p
+\rsnGROWPS	Size increase depth limit	next heading	0
+\rsnHORPHANS	# of following lines kept	next heading	1
+\rs*SN\-STYLE	Numbering style (alias)	next heading	\rs*SN\-DOT
 _
 .TE
-.RE
+.
+.
+.LP
+.B \rs*SN\-STYLE
+can alternatively be made an alias of
+.B \rs*SN\-NO\-DOT
+with the
+.B als
+request.
+.
+.
+.LP
+.ne 8v
+.TS
+cb   s  s  s
+cb   cb cb cb
+lf(CR) lx  l  lf(CR).
+Footnote settings
+Parameter	Definition	Effective	Default
+_
+\rsnFI	Indentation	next footnote	2n
+\rsnFF	Format	next footnote	0
+\rsnFPS	Point size	next footnote	\rsnPS\-2p
+\rsnFVS	Vertical spacing (leading)	next footnote	\rsnFPS+2p
+\rsnFPD	Paragraph distance (spacing)	next footnote	\rsnPD/2
+\rs*FR	Line length ratio	\fIspecial	11/12
+_
+.TE
+.
+.
+.LP
+.ne 4v
+.TS
+cb   s  s  s
+cb   cb cb cb
+lf(CR) lx  l  lf(CR).
+Display settings
+Parameter	Definition	Effective	Default
+_
+\rsnDD	Display distance (spacing)	\fIspecial	0.5v\
+ \fR(\f1v\fR)
+\rsnDI	Display indentation	\fIspecial	0.5i
+_
+.TE
+.
+.
+.LP
+.ne 3v
+.TS
+cb   s  s  s
+cb   cb cb cb
+lf(CR) lx  l  lf(CR).
+Other settings
+Parameter	Definition	Effective	Default
+_
+\rsnMINGW	Minimum gutter width	next page	2n
+\rsnTC\-MARGIN	TOC page number margin width	\
+next \fBPX\f call	\rsw\aq000\aq
+\rsTC\-LEADER	TOC leader character	next \fBPX\f call\
+	.\rsh\aq1m\aq
+_
+.TE
+.
+.
+.LP
+For entries marked
+.RI \lq special \rq
+in the \lqEffective\rq column,
+see the discussion in the applicable section below.
+.
+The
+.BR PO ,
+.BR LL ,
+and
+.B LT
+register defaults vary by output device and paper format;
+the values shown are for typesetters using U.S.\& letter paper,
+and then terminals.
+.
+See section \lqPaper format\rq of
+.MR groff @MAN1EXT@ .
+.
+The
+.B PD
+and
+.B DD
+registers use the larger value if the vertical motion quantum of the
+output device is too coarse for the smaller one;
+usually,
+this is the case only for output to terminals and emulators thereof.
+.
+The \lqgutter\rq affected by
+.B \rsnMINGW
+is the gap between columns in multiple-column page arrangements.
+.
+The
+.B TC\-MARGIN
+register and
+.B TC\-LEADER
+special character affect the formatting of tables of contents assembled
+by the
+.BR XS ,
+.BR XA ,
+and
+.B XE
+macros.
 .
 .
 .\" ====================================================================
-.SS "Cover page macros"
+.SS "Document description macros"
 .\" ====================================================================
 .
-Use the following macros to create a cover page for your document
-in the order shown.
+Define information describing the document by calling the macros below
+in the order shown;
+.B .DA
+or
+.B .ND
+can be called to set the document date
+(or other identifier)
+at any time before (a) the abstract,
+if present,
+or (b) its information is required in a header or footer.
+.
+Use of these macros is optional,
+except that
+.B .TL
+is mandatory if any of
+.BR .RP ,
+.BR .AU ,
+.BR .AI ,
+or
+.B .AB
+is called,
+and
+.B .AE
+is mandatory if
+.B .AB
+is called.
+.
 .
 .TP
-.BR ".RP "  no 
-Specifies the report format for your document.
+.BR .RP\~  no\-repeat\-info \~ no\-renumber 
+Use the \lqreport\rq
+(AT&T: \lqreleased paper\rq)
+format for your document,
+creating a separate cover page.
+.
+The default arrangement is to place most of the document description
+(title,
+author names and institutions,
+and abstract,
+but not the date)
+at the top of the first page.
+.
+If the optional
+.B no\-\:\%repeat\-\:\%info
+argument is given,
+.I ms
+produces a cover page but does not repeat any of its information on
+subsequently
+(but see the
+.B DA
+macro below regarding the date).
 .
-The report format creates a separate cover page.
+Normally,
+.B .RP
+sets the page number following the cover page to\~1.
 .
-With no
-.B RP
-macro,
-.I groff
-prints a subset of the
-cover page on page\~1 of your document.
+Specifying the optional
+.B no\-\:\%renumber
+argument suppresses this alteration.
 .
-.IP
-If you use the optional
-.B no
-argument,
-.I groff
-prints a title page but
-does not repeat any of the title page information
-(title, author, abstract, etc.\&)
-on page\~1 of the document.
+Optional arguments can occur in any order.
 .
-.TP
-.B .P1
-(P-one) Prints the header on page\~1.
+.RB \lq no \rq
+is recognized as a synonym of
+.B no\-\:\%repeat\-\:\%info
+for AT&T compatibility.
 .
-The default is to suppress the header.
 .
 .TP
-.B .DA\c
-.RI " " xxx 
-(optional) Print the current date,
-or the arguments to the macro if any,
-on the title page (if specified)
-and in the footers.
+.B .TL
+Specify the document title.
+.
+.I ms
+collects text on input lines following this call into the title until
+reaching
+.BR .AU ,
+.BR .AB ,
+or a heading or paragraphing macro call.
 .
-This is the default for
-.IR nroff .
 .
 .TP
-.B .ND\c
-.RI " " xxx 
-(optional) Print the current date,
-or the arguments to the macro if any,
-on the title page (if specified)
-but not in the footers.
+.B .AU
+Specify an author's name.
 .
-This is the default for
-.IR troff .
+.I ms
+collects text on input lines following this call into the author's name
+until reaching
+.BR .AI ,
+.BR .AB ,
+another
+.BR .AU ,
+or a heading or paragraphing macro call.
 .
-.TP
-.B .TL
-Specifies the document title.
+Call it repeatedly to specify multiple authors.
 .
-.I Groff
-collects text following the
-.B TL
-macro into the title, until reaching the author name or abstract.
 .
 .TP
+.B .AI
+Specify the preceding author's institution.
+.
+An
 .B .AU
-Specifies the author's name.
+call is usefully followed by at most one
+.B .AI
+call;
+if there are more,
+the last
+.B .AI
+call controls.
+.
+.I ms
+collects text on input lines following this call into the author's
+institution until reaching
+.BR .AU ,
+.BR .AB ,
+or a heading or paragraphing macro call.
 .
-You can specify multiple authors by using an
-.B AU
-macro for each author.
 .
 .TP
-.B .AI
-Specifies the author's institution.
+.BR .DA \~\c
+.IR x \~.\|.\|.
+Typeset the current date,
+or any
+.RI arguments\~ x ,
+in the center footer,
+and,
+if
+.B .RP
+is also called,
+left-aligned at the end of the document description on the cover page.
+.
+.
+.TP
+.BR .ND \~\c
+.IR x \~.\|.\|.
+Typeset the current date,
+or any
+.RI arguments\~ x ,
+if
+.B .RP
+is also called,
+left-aligned at the end of the document description on the cover page.
+.
+This is
+.IR "groff ms" 's
+default.
 .
-You can specify multiple institutions.
 .
 .TP
 .BR ".AB "  no 
-Begins the abstract.
+Begin the abstract.
+.
+.I ms
+collects text on input lines following this call into the abstract until
+reaching an
+.B .AE
+call.
 .
-The default is to print the word
-.BR ABSTRACT ,
-centered and in italics, above the text of the abstract.
+By default,
+.I ms
+places the word \lqABSTRACT\rq centered and in italics above the
+text of the abstract.
 .
-The option
-.B no
+The optional argument
+.RB \lq no \rq
 suppresses this heading.
 .
+.
 .TP
 .B .AE
 End the abstract.
 .
 .
 .\" ====================================================================
-.SS Paragraphs
+.SS "Text settings"
 .\" ====================================================================
 .
-Use the
-.B PP
-macro to create indented paragraphs,
-and the
-.B LP
-macro to create paragraphs with no initial indent.
-.
+The
+.B FAM
+string,
+a GNU extension,
+sets the font family for body text;
+the default is
+.RB \lq T \rq.
 .
-.PP
 The
-.B QP
-macro indents all text at both left and right margins
-by the amount of the register
-.BR QI .
+.B PS
+and
+.B VS
+registers set the type size and vertical spacing
+(distance between text baselines),
+respectively.
 .
-The effect is reminiscent of the HTML
-.B <BLOCKQUOTE>
-tag.
+The font family and type size are ignored on terminal devices.
 .
-The next paragraph or heading returns the margins to normal.
+Setting these parameters before the first call of a heading,
+paragraphing,
+or (non-date) document description macro also applies them to headers,
+footers,
+and
+(for
+.BR FAM )
+footnotes.
 .
-.B QP
-inserts the vertical space specified in register
-.B PD
-as inter-paragraph spacing.
 .
+.br
+.ne 2v
+.P
+The
+.B HY
+register defines the automatic hyphenation mode used with the
+.B hy
+request.
 .
-.PP
-A paragraph bracketed between the macros
-.B QS
-and
-.B QE
-has the same appearance as a paragraph started with
-.B QP
-and a following paragraph started with
-.BR LP .
-.
-Both
-.B QS
-and
-.B QE
-insert the inter-paragraph spacing specified in
-.B PD
-and the text is indented on both sides by the amount of register
-.BR QI .
+Setting
+.B \rsnHY
+.RB to\~ 0
+is equivalent to using the
+.B nh
+request.
 .
-The text between
-.B QS
-and
-.B QE
-can be split into further paragraphs by using
-.B \&.LP
-or
-.BR \&.PP .
+This is a Tenth Edition Research Unix extension.
 .
 .
-.PP
-The
-.B XP
-macro produces an \(lqexdented\(rq paragraph; that is, one with a
-hanging indent.
+.\" ====================================================================
+.SS "Typographical symbols"
+.\" ====================================================================
 .
-The first line of the paragraph begins at
-the left margin,
-and subsequent lines are indented
-(the opposite of
-.BR PP ).
+.I ms
+provides a few strings to obtain typographical symbols not easily
+entered with the keyboard.
 .
+These and many others are available as special character escape
+sequences\emsee
+.MR groff_char @MAN7EXT@ .
 .
-.PP
-For each of the above paragraph types,
-and also for any list entry introduced by the
-.B IP
-macro
-(described later),
-the document control register
-.BR PORPHANS ,
-sets the
-.I minimum
-number of lines which must be printed,
-after the start of the paragraph,
-and before any page break occurs.
 .
-If there is insufficient space remaining on the current page
-to accommodate this number of lines,
-then a page break is forced
-.I before
-the first line of the paragraph is printed.
+.TP
+.B \rs*\-
+Interpolate an em dash.
 .
 .
-.PP
-Similarly,
-when a section heading
-(see subsection \lqHeadings\rq below)
-precedes any of these paragraph types,
-the
-.B HORPHANS
-document control register specifies the
-.I minimum
-number of lines of the paragraph
-which must be kept on the same page as the heading.
+.TP
+.B \rs*Q
+.TQ
+.B \rs*U
+Interpolate typographer's quotation marks where available,
+and neutral double quotes otherwise.
 .
-If insufficient space remains on the current page
-to accommodate the heading and this number of lines of paragraph text,
-then a page break is forced
-.I before
-the heading is printed.
+.B \rs*Q
+is the left quote and
+.B \rs*U
+the right.
 .
 .
 .\" ====================================================================
-.SS Headings
+.SS Paragraphs
 .\" ====================================================================
 .
-Use headings to create a hierarchical structure
-for your document.
+Paragraphing macros
+.IR break ,
+or terminate,
+any pending output line so that a new paragraph can begin.
+.
+Several paragraph types are available,
+differing in how indentation
+applies to them:
+to left,
+right,
+or both margins;
+to the first output line of the paragraph,
+all output lines,
+or all but the first.
+.
+All paragraphing macro calls cause the insertion of vertical space in
+the amount stored in the
+.B PD
+register,
+except at page or column breaks,
+or adjacent to displays.
 .
-By default,
-the
-.I ms
-macros print headings in
-.B bold
-using the same font family and point size as the body text.
 .
-For output devices which support scalable fonts,
-this behaviour may be modified by defining the document control
-registers
-.B GROWPS
-and
-.BR PSINCR .
+.PP
+The
+.B PORPHANS
+register defines the minimum number of initial lines of any paragraph
+that must be kept together to avoid isolated lines at the bottom of a
+page.
 .
+If a new paragraph is started close to the bottom of a page,
+and there is insufficient space to accommodate
+.B \rsnPORPHANS
+lines before an automatic page break,
+then a page break is forced before the start of the paragraph.
+.
+This is a GNU extension.
 .
-.PP
-The following heading macros are available:
 .
 .TP
-.BI .NH\  xx
-Numbered heading.
+.B .LP
+Set a paragraph without any (additional) indentation.
 .
-The argument
-.I xx
-is either a numeric argument to indicate the
-level of the heading, or
-.B S\~\c
-.IR "xx\~xx\~" .\|.\|.\&
-to set the section number explicitly.
 .
-If you specify heading levels out of sequence,
-such as invoking
-.B ".NH\ 3"
-after
-.BR ".NH\ 1" ,
-.I groff
-prints a warning on standard error.
+.TP
+.B .PP
+Set a paragraph with a first-line left indentation in the amount stored
+in the
+.B PI
+register.
 .
-.IP
-If the
-.B GROWPS
-register is set to a value
-greater than the level of the heading,
-then the point size of the heading will be increased by
-.B PSINCR
-units over the text size specified by the
-.B PS
-register,
-for each level by which the heading level is less than
-the value of
-.BR GROWPS .
 .
-For example,
-the sequence:
+.TP
+.BR .IP \~\c
+.IR marker \~ width 
+Set a paragraph with a left indentation.
 .
-.RS
-.ne 12
-.nf
-.IP
-\&.nr PS 10
-\&.nr GROWPS 3
-\&.nr PSINCR 1.5p
-\&.
-\&.NH 1
-Top Level Heading
-\&.
-\&.NH 2
-Second Level Heading
-\&.
-\&.NH 3
-Third Level Heading
-.fi
-.RE
+The optional
+.I marker
+is not indented and is empty by default.
 .
-.IP
-will cause
-.RI \*(lq 1.\ Top\ Level\ Heading \*(rq
-to be printed in 13pt
-.B bold
-text, followed by
-.RI \*(lq 1.1.\ Second\ Level\ Heading \*(rq
-in 11.5pt
-.B bold
-text, while
-.RI \*(lq 1.1.1.\ Third\ Level\ Heading \*(rq,
-and all more deeply nested heading levels,
-will remain in the 10pt
-.B bold
-text which is specified by the
-.B PS
-register.
+.I width
+overrides the indentation amount in
+.BR \rsnPI ;
+its default unit is
+.RB \lq n \rq.
 .
-.IP
-Note that the value stored in
-.B PSINCR
-is interpreted in
-.I groff
-basic units;
-the
-.I p
-scaling factor should be employed when assigning a value specified in
-points.
-.
-.IP
-The style used to represent the section number,
-within a numbered heading,
-is controlled by the
-.B SN\-STYLE
-string;
-this may be set to either the
-.B SN\-DOT
-or the
-.B SN\-NO\-DOT
-style,
-(described below),
-by aliasing
-.B SN\-STYLE
-accordingly.
+Once specified,
+.I width
+applies to further
+.B .IP
+calls until specified again or a heading or different paragraphing macro
+is called.
 .
-By default,
-.B SN\-STYLE
-is initialised by defining the alias
-.RS
-.nf
-.IP
-\&.als SN\-STYLE SN\-DOT
-.fi
-.RE
-.IP
-it may be changed to the
-.B SN\-NO\-DOT
-style,
-if preferred,
-by defining the alternative alias
-.RS
-.nf
-.IP
-\&.als SN\-STYLE SN\-NO\-DOT
-.fi
-.RE
-.IP
-Any such change becomes effective with the first use of
-.BR .NH ,
-.I after
-the new alias is defined.
-.
-.IP
-After invoking
-.BR .NH ,
-the assigned heading number is available in the strings
-.B SN\-DOT
-(as it appears in the default formatting style for numbered headings,
-with a terminating period following the number),
-and
-.B SN\-NO\-DOT
-(with this terminating period omitted).
-.
-The string
-.B SN
-is also defined,
-as an alias for
-.BR SN\-DOT ;
-if preferred,
-the user may redefine it as an alias for
-.BR SN\-NO\-DOT ,
-'ne 10
-by including the initialisation:
 .
-.RS
-.nf
-.IP
-\&.als SN SN\-NO\-DOT
-.fi
-.RE
+.TP
+.B .QP
+Set a paragraph indented from both left and right margins by
+.BR \rsnQI .
 .
-.IP
-at any time;
-the change becomes effective with the next use of
-.BR .NH ,
-.I after
-the new alias is defined.
 .
 .TP
-.B .SH\c
-.RI " " xx 
-Unnumbered subheading.
-.
-The use of the optional
-.I xx
-argument is a GNU extension,
-which adjusts the point size of the unnumbered subheading
-to match that of a numbered heading,
-introduced using
-.BI .NH\  xx
-with the same value of
-.IR xx .
+.B .QS
+.TQ
+.B .QE
+Begin
+.RB ( QS )
+and end
+.RB ( QE )
+a region where each paragraph is indented from both margins by
+.BR \rsnQI .
 .
-For example,
-given the same settings for
-.BR PS ,
-.B GROWPS
+The text between
+.B .QS
 and
-.BR PSINCR ,
-as used in the preceding
-.B .NH
-example,
-the sequence:
+.B .QE
+can be structured further by use of other paragraphing macros.
 .
-.RS
-.ne
-.nf
-.IP
-\&.SH 2
-An Unnumbered Subheading
-.fi
-.RE
 .
-.IP
-will print
-.RI \*(lq "An Unnumbered Subheading" \*(rq
-in 11.5pt
-.B bold
-text.
+.TP
+.B .XP
+Set an \lqexdented\rq paragraph\emone with a left indentation of
+.B \rsnPI
+on every line
+.I except
+the first
+(also known as a hanging indent).
+.
+This is a Berkeley extension.
 .
 .
 .\" ====================================================================
-.SS Highlighting
+.SS Headings
 .\" ====================================================================
 .
+Use headings to create a hierarchical structure for your document.
+.
 The
 .I ms
-macros provide a variety of methods to highlight
-or emphasize text:
+macros print headings in
+.B bold
+using the same font family and,
+by default,
+type size as the body text.
+.
+Headings are available with and without automatic numbering.
+.
+Text on input lines following the macro call becomes the heading's
+title.
+.
+Call a paragraphing macro to end the heading text and start the
+section's content.
+.
 .
 .TP
-.B .B\c
-.RI " " txt " " post " " pre 
-Sets its first argument in
-.BR "bold type" .
+.BR .NH \~\c
+.IR depth 
+Set an automatically numbered heading.
 .
-If you specify a second argument,
-.I groff
-prints it in the previous font after
-the bold text, with no intervening space
-(this allows you to set punctuation after
-the highlighted text without highlighting
-the punctuation).
+.I ms
+produces a numbered heading in the form
+.IR a . b . c .\|.\|.,
+to any level desired,
+with the numbering of each depth increasing automatically and being
+reset to zero when a more significant depth is increased.
+.
+.RB \lq 1 \rq\~is
+the most significant or coarsest division of the document.
+.
+Only non-zero values are output.
+.
+If
+.I depth
+is omitted,
+it is taken to be
+.BR 1 .
+.
+If you specify
+.I depth
+such that an ascending gap occurs relative to the previous
+.B NH
+call\emthat is,
+you \lqskip a depth\rq,
+as by
+.RB \lq ".NH\~1" \rq
+and then
+.RB \lq ".NH\~3" \rq,
+.I groff ms
+emits a warning on the standard error stream.
 .
-Similarly, it prints the third argument (if any)
-in the previous font
-.B before
-the first argument.
 .
-For example,
-.RS
+.TP
+.BI ".NH S\~" heading-depth-index\~\c
+\&.\|.\|.
+Alternatively,
+you can give
+.B NH
+a first argument
+.RB of\~\lq S \rq,
+followed by integers to number the heading depths explicitly.
 .
-.IP
-\&.B foo ) (
-.RE
+Further automatic numbering,
+if used,
+resumes using the specified indices as their predecessors.
 .
-.IP
-prints
-.RB \(lq( foo )\(rq.
+.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+This feature is a Berkeley extension.
+.
+.
+.P
+After
+.B .NH
+is called,
+the assigned number is made available in the strings
+.B SN\-DOT
+(as it appears in a printed heading with default formatting,
+followed by a terminating period)
+and
+.B SN\-NO\-DOT
+(with the terminating period omitted).
+.
+These are GNU extensions.
+.
+.
+.P
+You can control the style used to print numbered headings by defining an
+appropriate alias for the string
+.BR SN\-STYLE .
+.
+By default,
+.B \rs*SN\-STYLE
+is aliased to
+.BR \rs*SN\-DOT .
+.
+If you prefer to omit the terminating period from numbers appearing in
+numbered headings,
+you may alias it to
+.BR \rs*SN\-NO\-DOT .
+.
+Any such change in numbering style becomes effective from the next use
+of
+.B .NH
+following redefinition of the alias for
+.BR \rs*SN\-STYLE .
+.
+The formatted number of the current heading is available in
+.B \rs*SN
+(a feature first documented by Berkeley);
+this string facilitates its inclusion in,
+for example,
+table captions,
+equation labels,
+and
+.BR .XS / .XA / .XE
+table of contents entries.
 .
-.IP
-If you give this macro no arguments,
-.I groff
-prints all text following in bold until
-the next highlighting, paragraph, or heading macro.
 .
 .TP
-.B .R\c
-.RI " " txt " " post " " pre 
-Sets its first argument in
-roman (or regular) type.
+.BR .SH \~\c
+.IR depth 
+Set an unnumbered heading.
+.
+The optional
+.I depth
+argument is a GNU extension indicating the heading depth corresponding
+to the
+.I depth
+argument of
+.BR .NH .
+.
+It matches the type size at which the heading is set to that of a
+numbered heading at the same depth when the
+.B \rsnGROWPS
+and
+.B \rsnPSINCR
+heading size adjustment mechanism is in effect.
+.
+.
+.P
+The
+.B PSINCR
+register defines an increment in type size to be applied to a heading at
+a lesser depth than that specified in
+.BR \rsnGROWPS .
+.
+The value of
+.B \rsnPSINCR
+should be specified in points with the
+.RB \lq p \rq
+scaling unit and may include a fractional component.
+.
+.
+.P
+The
+.B GROWPS
+register defines the heading depth above which the type size increment
+set by
+.B \rsnPSINCR
+becomes effective.
+.
+For each heading depth less than the value of
+.BR \rsnGROWPS ,
+the type size is increased by
+.BR \rsnPSINCR .
+.
+Setting
+.B \rsnGROWPS
+to a value less than\~2 disables the incremental heading size feature.
+.
+.
+.P
+In other words,
+if the value of
+.B GROWPS
+register is greater than the
+.I depth
+argument to a
+.B .NH
+or
+.B .SH
+call,
+the type size of a heading produced by these macros increases by
+.B \rsnPSINCR
+units over
+.B \rsnPS
+multiplied by the difference of
+.B \rsnGROWPS
+and
+.IR depth .
+.
+.
+.P
+The
+.B \rsnHORPHANS
+register operates in conjunction with the
+.B NH
+and
+.B SH
+macros to inhibit the printing of isolated headings at the bottom of a
+page;
+it specifies the minimum number of lines of the subsequent paragraph
+that must be kept on the same page as the heading.
+.
+If insufficient space remains on the current page to accommodate the
+heading and this number of lines of paragraph text,
+a page break is forced before the heading is printed.
+.
+Any display macro call or
+.IR tbl ,
+.IR pic ,
+or
+.I eqn
+region between the heading and the subsequent paragraph suppresses this
+grouping.
+.
+.
+.\" ====================================================================
+.SS "Typeface and decoration"
+.\" ====================================================================
+.
+.
+.P
+The
+.I ms
+macros provide a variety of ways to style text.
+.
+Attend closely to the ordering of arguments labeled
+.I pre
+and
+.I post,
+which is not intuitive.
+.
+Support for
+.I pre
+arguments is a GNU extension.
 .
-It operates similarly to the
-.B B
-macro otherwise.
 .
 .TP
-.B .I\c
-.RI " " txt " " post " " pre 
-Sets its first argument in
-.IR "italic type" .
-It operates similarly to the
-.B B
-macro otherwise.
+.BR .B \~\c
+.IR text \~ post \~ pre 
+Style
+.I text
+in bold,
+followed by
+.I post
+in the previous font style without intervening space,
+and preceded by
+.I pre
+similarly.
+.
+Without arguments,
+.I ms
+styles subsequent text in bold
+until the next
+paragraphing,
+heading,
+or no-argument typeface macro call.
+.
 .
 .TP
-.B .CW\c
-.RI " " txt " " post " " pre 
-Sets its first argument in a constant-width face.
+.BR .R \~\c
+.IR text \~ post \~ pre 
+As
+.BR .B ,
+but use the roman style
+(upright text of normal weight)
+instead of bold.
+.
+Argument recognition is a GNU extension.
 .
-It operates similarly to the
-.B B
-macro otherwise.
 .
 .TP
-.B .BI\c
-.RI " " txt " " post " " pre 
-Sets its first argument in bold italic type.
+.BR .I \~\c
+.IR text \~ post \~ pre 
+As
+.BR .B ,
+but use an italic or oblique style instead of bold.
 .
-It operates similarly to the
-.B B
-macro otherwise.
 .
 .TP
-.B .BX\c
-.RI " " txt 
-Prints its argument and draws a box around it.
+.BR .BI \~\c
+.IR text \~ post \~ pre 
+As
+.BR .B ,
+but use a bold italic or bold oblique style instead of upright bold.
+.
+This is a Tenth Edition Research Unix extension.
+.\" possibly 9th, but definitely not Berkeley
 .
-If you want to box a string that contains spaces,
-use a digit-width space (\rs0).
 .
 .TP
-.B .UL\c
-.RI " " txt " " post 
-Prints its first argument with an underline.
+.BR .CW \~\c
+.IR text \~ post \~ pre 
+As
+.BR .B ,
+but use a constant-width (monospaced) roman typeface instead of bold.
+.
+This is a Tenth Edition Research Unix extension.
+.\" possibly 9th, but definitely not Berkeley
 .
-If you specify a second argument,
-.I groff
-prints it in the previous font after the underlined text, with no
-intervening space.
 .
 .TP
-.B .LG
-Prints all text following in larger type
-(2\~points larger than the current point size) until
-the next font size, highlighting, paragraph, or heading macro.
+.BR .BX \~\c
+.IR text 
+Typeset
+.I text
+and draw a box around it.
+.
+On terminal devices,
+reverse video is used instead.
 .
-You can specify this macro multiple times to enlarge the point size as
+If you want
+.I text
+to contain space,
+use unbreakable space or horizontal motion escape sequences
+.RB ( \rs\ti ,
+.BI \rs space\c
+,
+.BR \rs\ha ,
+.BR \rs| ,
+.BR \rs0 ,
+or
+.BR \rsh ).
+.
+.
+.TP
+.BR .UL \~\c
+.IR text \~ post 
+Typeset
+.I text
+with an underline.
+.
+.I post,
+if present,
+is set after
+.I text
+with no intervening space.
+.
+.
+.TP
+.B .LG
+Set subsequent text in larger type
+(2\~points larger than the current size)
+until the next
+type size,
+paragraphing,
+or heading macro call.
+.
+You can specify this macro multiple times to enlarge the type size as
 needed.
 .
+.
 .TP
 .B .SM
-Prints all text following in
-smaller type
-(2\~points smaller than the current point size) until
-the next type size, highlighting, paragraph, or heading macro.
-.
-You can specify this macro multiple times to reduce the point size as
+Set subsequent text in smaller type
+(2\~points smaller than the current size)
+until the next
+type size,
+paragraphing,
+or heading macro call.
+.
+You can specify this macro multiple times to reduce the type size as
 needed.
 .
+.
 .TP
 .B .NL
-Prints all text following in
-the normal point size
-(that is, the value of the
-.B PS
-register).
+Set subsequent text at the normal type size
+.RB ( \rsnPS ).
 .
-.TP
-.BI \rs*{ text \rs*}
-Print the enclosed
+.
+.P
+When
+.I pre
+is used,
+a hyphenation control escape sequence
+.B \rs%
+that would ordinarily start
 .I text
-as a superscript.
+must start
+.I pre
+instead.
+.
+.
+.P
+.I groff ms
+also offers strings to begin and end super- and subscripting.
+.
+These are GNU extensions.
+.
+.
+.TP
+.B \rs*{
+.TQ
+.B \rs*}
+Begin and end superscripting,
+respectively.
+.
+.
+.TP
+.B \rs*<
+.TQ
+.B \rs*>
+Begin and end subscripting,
+respectively.
 .
 .
 .\" ====================================================================
-.SS Indents
+.SS "Indented regions"
 .\" ====================================================================
 .
-You may need to indent sections of text.
+You may need to indent a region of text while otherwise formatting it
+normally.
 .
-A typical use for indents is to create nested lists and sublists.
+Indented regions can be nested.
 .
 .
-.PP
-Use the
-.B RS
-and
-.B RE
-macros to start and end a section of indented text, respectively.
-.
-The
-.B PI
-register controls the amount of indent.
+.TP
+.B .RS
+Begin a region where headings,
+paragraphs,
+and displays are indented (further) by
+.BR \rsnPI .
 .
 .
-.PP
-You can nest indented sections as deeply as needed by using multiple,
-nested pairs of
-.B RS
-and
-.BR RE .
+.TP
+.B .RE
+End the (next) most recent indented region.
 .
 .
 .\" ====================================================================
-.SS Lists
+.SS "Keeps, boxed keeps, and displays"
 .\" ====================================================================
 .
-The
-.B IP
-macro handles duties for all lists.
+On occasion,
+you may want to
+.I keep
+several lines of text,
+or a region of a document,
+together on a single page,
+preventing an automatic page break within certain boundaries.
+.
+This can cause a page break to occur earlier than it normally would.
+.
+.
+.P
+You can alternatively specify a
+.I floating keep:
+if a keep cannot fit on the current page,
+.I ms
+holds its contents and allows text following the keep
+(in the source document)
+to fill in the remainder of the current page.
+.
+When the page breaks,
+whether by reaching the end or
+.B bp
+request,
+.I ms
+puts the floating keep at the beginning of the next page.
 .
-Its syntax is as follows:
 .
 .TP
-.B .IP\c
-.RI " " marker " " width 
-The
-.I marker
-is usually a bullet character
-.B \rs(bu
-for unordered lists,
-a number (or auto-incrementing number register) for numbered lists,
-or a word or phrase for indented (glossary-style) lists.
+.B .KS
+Begin a keep.
 .
-.IP
-The
-.I width
-specifies the indent for the body of each list item.
 .
-Once specified, the indent remains the same for all list items in the
-document until specified again.
-.\" =====
-.br
-.ne 15
+.TP
+.B .KF
+Begin a floating keep.
 .
 .
-.\" ====================================================================
-.SS "Tab stops"
-.\" ====================================================================
+.TP
+.B .KE
+End (floating) keep.
 .
-Use the
-.B ta
-request to set tab stops as needed.
 .
-Use the
-.B TA
-macro to reset tabs to the default (every 5n).
+.P
+As an alternative to the keep mechanism,
+the
+.B ne
+request forces a page break if there is not at least the amount of
+vertical space specified in its argument remaining on the page.
 .
-You can redefine the
-.B TA
-macro to create a different set of default tab stops.
 .
+.PP
+A
+.I boxed keep
+has a frame drawn around it.
 .
-.\" ====================================================================
-.SS "Displays and keeps"
-.\" ====================================================================
 .
-Use displays to show text-based examples or figures
-(such as code listings).
+.TP
+.B .B1
+Begin a keep with a box drawn around it.
 .
-Displays turn off filling, so lines of code can be displayed as-is
-without inserting
-.B br
-requests in between each line.
 .
-Displays can be
-.I kept
-on a single page, or allowed to break across pages.
+.TP
+.B .B2
+End boxed keep.
 .
-The following table shows the display types available.
-.RS
-.ne 11
-.na
-.TS
-cb   s    cbt
-cb   cb   ^
-lfCW lfCW lx.
-Display macro	Type of display
-With keep	No keep
-_
-\&.DS L	\&.LD	Left-justified.
-\&.DS I \,\fIindent\/\fP	\&.ID	T{
-Indented (default indent in the \fBDI\fP register).
-T}
-\&.DS B	\&.BD	T{
-Block-centered (left-justified, longest line centered).
-T}
-\&.DS C	\&.CD	Centered.
-\&.DS R	\&.RD	Right-justified.
-_
-.TE
-.RE
-.ad
 .
-.LP
-Use the
-.B DE
-macro to end any display type.
+.P
+Boxed keep macros cause breaks;
+if you need to box a word or phrase within a line,
+see the
+.B BX
+macro in section \lqHighlighting\rq above.
+.
+Box lines are drawn as close as possible to the text they enclose so
+that they are usable within paragraphs.
+.
+If you wish to place one or more paragraphs in a boxed keep,
+you may improve their appearance by calling
+.B .B1
+after the first paragraphing macro,
+and by adding a small amount of vertical space before calling
+.BR .B2 .
+.
 .
-The macros
-.B Ds
+.br
+.ne 2v
+.P
+If you want a boxed keep to float,
+you will need to enclose the
+.B .B1
 and
-.B De
-were formerly provided as aliases for
-.B DS
+.B .B2
+calls within a pair of
+.B .KF
 and
-.BR DE ,
-respectively, but they have been removed, and should no longer be used.
+.B .KE
+calls.
 .
-X11 documents which actually use
-.B Ds
-and
-.B De
-always load a specific macro file from the X11 distribution
-.RI ( macros.t )
-which provides proper definitions for the two macros.
 .
-.PP
-To
-.I keep
-text together on a page,
-such as
-a paragraph that refers to a table (or list, or other item)
-immediately following, use the
-.B KS
-and
-.B KE
-macros.
+.P
+.I Displays
+turn off filling;
+lines of verse or program code are shown with their lines broken as in
+the source document without requiring
+.B br
+requests between lines.
+.
+Displays can be kept on a single page or allowed to break across pages.
 .
 The
-.B KS
-macro begins a block of text to be kept on a single page,
-and the
-.B KE
-macro ends the block.
+.B DS
+macro begins a kept display of the layout specified in its first
+argument;
+non-kept displays are begun with dedicated macros corresponding to their
+layout.
 .
 .
-.PP
-You can specify a
-.I "floating keep"
-using the
-.B KF
-and
-.B KE
-macros.
+.TP
+.B .DS L
+.TQ
+.B .LD
+Begin
+.RB ( DS ": kept)"
+left-aligned display.
 .
-If the keep cannot fit on the current page,
-.I groff
-holds the contents of the keep and allows text following
-the keep (in the source file) to fill in the remainder of
-the current page.
 .
-When the page breaks,
-whether by an explicit
-.B bp
-request or by reaching the end of the page,
-.I groff
-prints the floating keep at the top of the new page.
+.TP
+.BR .DS \~\c
+.RB  I \~\c
+.RI  indent 
+.TQ
+.BR .ID \~\c
+.RI  indent 
+Begin
+.RB ( DS ": kept)"
+display indented by
+.I indent
+if specified,
+.B \rsnDI
+otherwise.
 .
-This is useful for printing large graphics or tables
-that do not need to appear exactly where specified.
 .
+.TP
+.B .DS B
+.TQ
+.B .BD
+Begin
+.RB ( DS ": kept)"
+block display:
+the entire display is left-aligned,
+but indented such that the longest line in the display is centered on
+the page.
 .
-.PP
-The macros
-.B B1
+.
+.TP
+.B .DS C
+.TQ
+.B .CD
+Begin
+.RB ( DS ": kept)"
+centered display:
+each line in the display is centered.
+.
+.
+.TP
+.B .DS R
+.TQ
+.B .RD
+Begin
+.RB ( DS ": kept)"
+right-aligned display.
+.
+This is a GNU extension.
+.
+.
+.TP
+.B .DE
+End any display.
+.
+.
+.P
+The distance stored in
+.B \rsnDD
+is inserted before and after each pair of display macros;
+this is a Berkeley extension.
+.
+In
+.IR "groff ms" ,
+this distance replaces any adjacent inter-paragraph distance
+or subsequent spacing prior to a section heading.
+.
+The
+.B DI
+register is a GNU extension;
+its value is an indentation applied to displays created with
+.B .DS
 and
-.B B2
-can be used to enclose a text within a box;
-.B .B1
-begins the box, and
-.B .B2
-ends it.
+.B .ID
+without arguments,
+to
+.RB \lq .DS\~I \rq
+without an indentation argument,
+and to equations set with
+.RB \lq .EQ\~I \rq.
 .
-Text in the box is automatically placed in a diversion
-(keep).
+Changes to either register take effect at the next display boundary.
 .
 .
 .\" ====================================================================
@@ -1048,306 +1472,570 @@
 .
 The
 .I ms
-macros support the standard
-.I groff
-preprocessors:
-.IR tbl ,
-.IR pic ,
-.IR eqn ,
+package is often used with the
+.IR @g@tbl ,
+.IR @g@pic ,
+.IR @g@eqn ,
 and
-.IR refer .
+.I @g@refer
+preprocessors.
+.
+The
+.B \rsnDD
+distance is also applied to regions of the document preprocessed with
+.IR @g@eqn ,
+.IR @g@pic ,
+and
+.IR @g@tbl .
+.
+Mark text meant for preprocessors by enclosing it in pairs of tokens as
+follows,
+with nothing between the dot and the macro name.
+.
+The preprocessors match these tokens only at the start of an input line.
 .
-Mark text meant for preprocessors by enclosing it
-in pairs of tags as follows:
 .
 .TP
-.BR .TS " " H " and " .TE
-Denote a table to be processed by the
+.BR .TS " " H "
+.TQ
+.B .TE
+Demarcate a table to be processed by the
 .I tbl
 preprocessor.
 .
 The optional
 .BR H "\~argument"
 instructs
-.I groff
-to create a running header with the information
-up to the
+.I ms
+to repeat table rows
+(often column headings)
+at the top of each new page the table spans,
+if applicable;
+calling the
 .B TH
-macro.
+macro marks the end of such rows.
+.
+.MR @g@tbl @MAN1EXT@
+provides a comprehensive reference to the preprocessor and offers
+examples of its use.
 .
-.I Groff
-prints the header at the beginning of the table;
-if the table runs onto another page,
-.I groff
-prints the header on the next page as well.
 .
 .TP
-.BR .PS " and " .PE
-Denote a graphic to be processed by the
+.B .PS
+.TQ
+.B .PE
+.TQ
+.B .PF
+.B .PS
+begins a picture to be processed by the
 .I pic
-preprocessor.
+preprocessor;
+either of
+.B .PE
+or
+.B .PF
+ends it,
+the latter with \lqflyback\rq to the vertical position at its top.
 .
-You can create a
-.I pic
-file by hand, using the
-AT&T
-.I pic
-manual available on the Web as a reference,
-or by using a graphics program such as
-.IR xfig .
 .
 .TP
-.B .EQ\c
-.RI " " align " and "\c
+.BR .EQ \~\c
+.IR align \~\c
+.IR label 
+.TQ
 .B .EN
-Denote an equation to be processed by the
+Demarcate an equation to be processed by the
 .I eqn
 preprocessor.
 .
-The optional
+The equation is centered by default;
 .I align
-argument can be
+can be
 .BR C ,
 .BR L ,
-or\~\c
-.B I
-to center (the default), left-justify, or indent
-the equation, respectively.
+.RB or\~ I
+to (explicitly) center,
+left-align,
+or indent it by
+.BR \rsnDI ,
+respectively.
+.
+If specified,
+.I label
+is set right-aligned.
+.
 .
 .TP
-.BR . " and " .
-Denote a reference to be processed by the
+.B .
+.TQ
+.B .
+Demarcate a bibliographic citation to be processed by the
 .I refer
 preprocessor.
 .
-The GNU
-.IR @g@refer (@MAN1EXT@)
-manual page provides a comprehensive reference
-to the preprocessor and the format of the
-bibliographic database.
+.MR @g@refer @MAN1EXT@
+provides a comprehensive reference to the preprocessor and the format of
+its bibliographic database.
+.
+.
+.P
+When
+.I @g@refer
+emits collected references
+(as might be done on a \lqWorks Cited\rq page),
+it interpolates the string
+.B \rs*REFERENCES
+as an unnumbered heading
+.RB ( .SH ).
+.
+.
+.br
+.ne 2v
+.P
+Attempting to place a multi-page table inside a keep can lead to
+unpleasant results,
+particularly if the
+.I tbl \" generic
+.RB \lq allbox \rq
+option is used.
 .
 .
 .\" ====================================================================
 .SS Footnotes
 .\" ====================================================================
 .
-The
-.I ms
-macros provide a flexible footnote system.
+A footnote is typically anchored to a place in the text with a
+.I marker,
+which is a small integer,
+a symbol,
+or arbitrary user-specified text.
+.
 .
-You can specify a numbered footnote by using the
+.TP
 .B \rs**
-escape, followed by the text of the footnote
-enclosed by
+Place an
+.I automatic number,
+an automatically generated numeric footnote marker,
+in the text.
+.
+Each time this string is interpolated,
+the number it produces increments by one.
+.
+Automatic numbers start at 1.
+.
+This is a Berkeley extension.
+.
+.
+.P
+Enclose the footnote text in
 .B FS
 and
 .B FE
-macros.
+macro calls to set it at the nearest available \lqfoot\rq,
+or bottom,
+of a text column or page.
 .
 .
-.PP
-You can specify symbolic footnotes
-by placing the mark character (such as
-.B \rs(dg
-for the dagger character) in the body text,
-followed by the text of the footnote
-enclosed by
-.B FS\ \rs(dg
+.TP
+.BR .FS \~\c
+.IR marker 
+Begin a footnote.
+.
+The
+.B .FS\-MARK
+hook
+(see below)
+is called with any supplied
+.I marker
+argument,
+which is then also placed at the beginning of the footnote text.
+.
+If
+.I marker
+is omitted,
+the next pending automatic number enqueued by interpolation of the
+.B *
+string is used,
+and if none exists,
+nothing is prefixed.
+.
+.
+.TP
+.B .FE
+End footnote text.
+.
+.
+.P
+.I groff ms
+provides a hook macro,
+.BR FS\-MARK ,
+for user-determined operations to be performed when the
+.B FS
+macro is called.
+.
+It is passed the same arguments as
+.B .FS
+itself.
+.
+By default,
+this macro has an empty definition.
+.
+.B .FS\-MARK
+is a GNU extension.
+.
+.
+.P
+Footnote text is formatted as paragraphs are,
+using analogous parameters.
+.
+The registers
+.BR FI ,
+.BR FPD ,
+.BR FPS ,
 and
-.B FE
-macros.
+.B FVS
+correspond to
+.BR PI ,
+.BR PD ,
+.BR PS ,
+and
+.BR VS ,
+respectively;
+.BR FPD ,
+.BR FPS ,
+and
+.B FVS
+are GNU extensions.
 .
 .
-.PP
-You can control how
-.I groff
-prints footnote numbers by changing the value of the
+.P
+The
 .B FF
-register as follows:
-.RS
-.ne 7
+register controls the formatting of automatically numbered footnote
+paragraphs,
+and those for which
+.B .FS
+is given a
+.I marker
+argument,
+at the bottom of a column or page as follows.
 .
+.
+.RS
 .TP
 0
-Prints the footnote number as a superscript; indents the footnote
-(default).
+Set an automatic number,
+or a specified
+.B FS
+.I marker
+argument,
+as a superscript
+(on typesetter devices)
+or surrounded by square brackets
+(on terminals).
+.
+The footnote paragraph is indented as with
+.B .PP
+if there is an
+.B .FS
+argument or an automatic number,
+and as with
+.B .LP
+otherwise.
+.
+This is the default.
+.
 .
 .TP
 1
-Prints the number followed by a period (that is,\~\(lq1.\(rq\&)
-and indents the footnote.
+As
+.BR 0 ,
+but set the marker as regular text,
+and follow an automatic number with a period.
+.
 .
 .TP
 2
-Like\~1, without an indent.
+As
+.BR 1 ,
+but without indentation
+(like
+.BR .LP ).
+.
 .
 .TP
 3
-Like\~1, but prints the footnote number as a paragraph with a hanging
-indent.
+As
+.BR 1 ,
+but set the footnote paragraph with the marker hanging
+(like
+.BR .IP ).
+.RE
+.
 .
+.\" ====================================================================
+.SS "Language and localization"
+.\" ====================================================================
+.
+.I groff ms
+provides several strings that you can customize for your own purposes,
+or redefine to adapt the macro package to languages other than English.
+.
+It is already localized for
+.\" cs, de, fr, it, sv
+Czech,
+German,
+French,
+Italian,
+and
+Swedish.
+.
+Load the desired localization macro package after
+.IR ms ;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+.
+.P
+.RS
+.TS
+cb   cb
+lf(CR) lf(CR).
+String	Default
+_
+\rs*REFERENCES	References
+\rs*ABSTRACT	\rsfIABSTRACT\rsf
+\rs*TOC	Table of Contents
+\rs*MONTH1	January
+\rs*MONTH2	February
+\rs*MONTH3	March
+\rs*MONTH4	April
+\rs*MONTH5	May
+\rs*MONTH6	June
+\rs*MONTH7	July
+\rs*MONTH8	August
+\rs*MONTH9	September
+\rs*MONTH10	October
+\rs*MONTH11	November
+\rs*MONTH12	December
+_
+.TE
 .RE
-.LP
-You can use footnotes safely within keeps and displays,
-but avoid using numbered footnotes within floating keeps.
 .
-You can set a second
-.B \rs**
-between a
-.B \rs**
-and its corresponding
-.BR .FS ;
-as long as each
-.B .FS
-occurs
-.I after
-the corresponding
-.B \rs**
-and the occurrences of
-.B .FS
-are in the same order as the corresponding occurrences of
-.BR \rs** .
+The default for
+.B ABSTRACT
+includes font selection escape sequences to set the word in italics.
 .
 .
 .\" ====================================================================
 .SS "Headers and footers"
 .\" ====================================================================
 .
-There are three ways to define headers and footers:
+There are multiple ways to produce headers and footers.
 .
-.IP \(bu 3n
-Use the strings
+One is to define the strings
 .BR LH ,
 .BR CH ,
 and
 .B RH
-to set the left, center, and right headers.
-Use
+to set the left,
+center,
+and right headers,
+respectively;
+and
 .BR LF ,
 .BR CF ,
 and
 .B RF
-to set the left, center, and right footers.
+to set the left,
+center,
+and right footers.
 .
-The string-setting approach works best for documents that do not
-distinguish between odd and even pages.
+This approach suffices for documents that do not distinguish odd- and
+even-numbered pages.
 .
-.IP \(bu
-Use the
+.
+.P
+Another method is to call macros that set headers or footers for odd- or
+even-numbered pages.
+.
+Each such macro takes a delimited argument separating the left,
+center,
+and right header or footer texts from each other.
+.
+You can replace the neutral apostrophes (\aq) shown below with any
+character not appearing in the header or footer text.
+.
+These macros are Berkeley extensions.
+.
+.
+.br
+.ne 5v
+.TP
+.BR .OH \~\aq\c
+.IR left \aq center \aq right \aq
+.TQ
+.BR .OF \~\aq\c
+.IR left \aq center \aq right \aq
+.TQ
+.BR .EH \~\aq\c
+.IR left \aq center \aq right \aq
+.TQ
+.BR .EF \~\aq\c
+.IR left \aq center \aq right \aq
+The
 .B OH
 and
 .B EH
-macros to define headers for the odd and even pages,
-and
+macros define headers for odd- (recto) and even-numbered (verso) pages,
+respectively;
+the
 .B OF
 and
 .B EF
-macros to define footers for the odd and even pages.
+macros define footers for them.
 .
-This is more flexible than defining the individual strings.
 .
-The syntax for these macros is as follows:
-.RS
+.P
+With either method,
+a percent sign
+.B %
+in header or footer text is replaced by the current page number.
 .
-.IP
-.BI . XX " \aq" left \aq center \aq right \aq
-.RE
+By default,
+.I ms
+places no header on a page numbered \lq1\rq
+(regardless of its number format).
 .
-.IP
-where
-.I XX
-is one of the foregoing four macros and each of
-.IR left ,
-.IR center ,
-and
-.I right
-is text of your choice.
 .
-You can replace the quote (\aq) marks with any character not
-appearing in the header or footer text.
+.TP
+.B .P1
+Typeset the header even on page\~1.
 .
+To be effective,
+this macro must be called before the header trap is sprung on any page
+numbered \lq1\rq.
+.
+This is a Berkeley extension.
+.
+.
+.P
+For even greater flexibility,
+.I ms
+permits redefinition of the macros called when the page header and
+footer traps are sprung.
 .
-.IP \(bu
-You can redefine the
 .B PT
+(\lqpage trap\rq)
+is called by
+.I ms
+when the header is to be written,
 and
 .B BT
-macros to change the behavior of
-the header and footer, respectively.
+(\lqbottom trap\rq)
+when the footer is to be.
 .
-The header process also calls the (undefined)
+The
+.I groff
+page location trap that
+.I ms
+sets up to format the header also calls the
+(normally undefined)
 .B HD
 macro after
-.BR PT ;
-you can define this macro if you need additional processing
-after printing the header
-(for example, to draw a line below the header).
+.BR .PT ;
+you can define
+.B .HD
+if you need additional processing after setting the header.
+.
+.\" Although undocumented in Tuthill's 4.2BSD ms.diffs paper...
+The
+.B HD
+hook is a Berkeley extension.
+.
+Any such macros you (re)define must implement any desired specialization
+for odd-,
+even-,
+or first numbered pages.
 .
 .
 .\" ====================================================================
-.SS Margins
+.SS "Tab stops"
 .\" ====================================================================
 .
-You control margins using a set of number registers.
+Use the
+.B ta
+request to set tab stops as needed.
+.
+.
+.TP
+.B .TA
+Reset the tab stops to the
+.I ms
+default
+(every 5 ens).
+.
+Redefine this macro to create a different set of default tab stops.
+.
+.
+.\" ====================================================================
+.SS Margins
+.\" ====================================================================
 .
-The following table lists the register names and defaults:
-.RS
-.ne 8
-.na
-.TS
-cb   cb cb cb
-lfCW l  l  l.
-Reg.	Definition	Effective	Default
-_
-PO	Page offset (left margin)	next page	1i
-LL	Line length	next paragraph	6i
-LT	Header/footer length	next paragraph	6i
-HM	Top (header) margin	next page	1i
-FM	Bottom (footer) margin	next page	1i
-_
-.TE
-.RE
-.ad
+Control margins using the registers summarized in the \lqMargins\rq
+portion of the table in section \lqDocument control settings\rq
+above.
 .
-.PP
-Note that there is no right margin setting.
-The combination of page offset and line length
-provide the information necessary to
-derive the right margin.
+There is no setting for the right margin;
+the combination of page offset
+.B \rsnPO
+and line length
+.B \rsnLL
+determines it.
 .
 .
 .\" ====================================================================
 .SS "Multiple columns"
 .\" ====================================================================
 .
-The
 .I ms
-macros can set text in as many columns as will reasonably
-fit on the page.
+can set text in as many columns as reasonably fit on the page.
+.
+The following macros force a page break if a multi-column layout is
+active when they are called.
 .
-The following macros are available.
+.B \rsnMINGW
+is the default minimum gutter width;
+it is a GNU extension.
 .
-All of them force a page break if a multi-column mode is already set.
+When multiple columns are in use,
+keeps
+and the
+.B \%HORPHANS
+and
+.B \%PORPHANS
+registers
+work with respect to column breaks instead of page breaks.
 .
-However, if the current mode is single-column, starting a multi-column
-mode does
-.I not
-force a page break.
 .
 .TP
 .B .1C
-Single-column mode.
+Arrange page text in a single column
+(the default).
+.
 .
 .TP
 .B .2C
-Two-column mode.
+Arrange page text in two columns.
+.
 .
 .TP
-.B .MC\c
-.RI " " column-width " " gutter-width 
-Multi-column mode.
+.BR .MC \~\c
+.IR column-width " " gutter-width 
+Arrange page text in multiple columns.
 .
-If you specify no arguments, it is equivalent to the
+If you specify no arguments,
+it is equivalent to the
 .B 2C
 macro.
 .
@@ -1355,474 +2043,864 @@
 .I column-width
 is the width of each column and
 .I gutter-width
-is the space between columns.
-.
-The
-.B MINGW
-number register is the default gutter width.
+is the minimum distance between columns.
 .
 .
 .\" ====================================================================
 .SS "Creating a table of contents"
 .\" ====================================================================
 .
-Wrap text that you want to appear in the table of contents in
+Define an entry to appear in the table of contents by bracketing its
+text between calls to the
 .B XS
 and
 .B XE
 macros.
 .
-Use the
+A typical application is to call them immediately after
+.B NH
+or
+.B SH
+and repeat the heading text within them.
+.
+The
+.B XA
+macro,
+used within
+.BR .XS / .XE
+pairs,
+supplements an entry\emfor instance,
+when it requires multiple output lines,
+whether because a heading is too long to fit or because style dictates
+that page numbers not be repeated.
+.
+You may wish to indent the text thus wrapped to correspond to its
+heading depth;
+this can be done in the entry text by prefixing it with tabs or
+horizontal motion escape sequences,
+or by providing a second argument to the
+.B XA
+macro.
+.
+.B .XS
+and
+.B .XA
+automatically associate the page number where they are called with the
+text following them,
+but they accept arguments to override this behavior.
+.
+At the end of the document,
+call
 .B TC
-macro to print the table of contents at the end of the document,
-resetting the page number to\~\c
-.B i
-(Roman numeral\~1).
+or
+.B PX
+to emit the table of contents;
+.B .TC
+resets the page number
+.RB to\~ i
+(Roman numeral one),
+and then calls
+.BR PX .
 .
+All of these macros are Berkeley extensions.
 .
-.PP
-You can manually create a table of contents
-by specifying a page number as the first argument to
-.BR XS .
 .
-Add subsequent entries using the
-.B XA
-macro.
+.TP
+.BR .XS \~\c
+.IR page-number 
+.TQ
+.BR .XA \~\c
+.IR page-number \~ indentation 
+.TQ
+.B .XE
+Begin,
+supplement,
+and end a table of contents entry.
+.
+Each entry is associated with
+.I page-number
+(otherwise the current page number);
+a
+.I page-number
+of
+.RB \lq no \rq
+prevents a leader and page number from being emitted for that entry.
+.
+Use of
+.B .XA
+within
+.BR .XS / .XE
+is optional;
+it can be repeated.
+.
+If
+.I indentation
+is present,
+a supplemental entry is indented by that amount;
+ens are assumed if no unit is indicated.
+.
+Text on input lines between
+.B .XS
+and
+.B .XE
+is stored for later recall by
+.BR .PX .
 .
-For example:
-.RS
 .
-.PP
-.ne 8
-.nf
-\&.XS 1
-Introduction
-\&.XA 2
-A Brief History of the Universe
-\&.XA 729
-Details of Galactic Formation
-\&.\|.\|.
-\&.XE
-.fi
-.RE
+.TP
+.BR .PX \~ no 
+Switch to single-column layout.
 .
-.LP
-Use the
-.B PX
-macro to print a manually-generated table of contents
-without resetting the page number.
+Unless
+.RB \lq no \rq
+is specified,
+center and interpolate
+.B \rs*TOC
+in bold and two points larger than the body text.
 .
+Emit the table of contents entries.
 .
-.PP
-If you give the argument
-.B no
-to either
+.
+.TP
+.BR .TC \~ no 
+Set the page number to\~1,
+the page number format to lowercase Roman numerals,
+and call
 .B PX
-or
-.BR TC ,
-.I groff
-suppresses printing the title
-specified by the
-.B \rs*TOC
-string.
+(with a
+.RB \lq no \rq
+argument,
+if present).
 .
 .
-.\" ====================================================================
-.SS "Fractional point sizes"
-.\" ====================================================================
+.P
+The remaining features in this subsection are GNU extensions.
 .
-Traditionally, the
-.I ms
-macros only support integer values for the document's font size
-and vertical spacing.
+.I groff ms
+obviates the need to repeat heading text after
+.B .XS
+calls.
 .
-To overcome this restriction, values larger than or equal to 1000 are
-taken as fractional values, multiplied by 1000.
+Call
+.B .XN
+and
+.B .XH
+after
+.B .NH
+and
+.BR .SH ,
+respectively.
 .
-For example, \oq.nr\~PS\~10250\cq sets the font size to 10.25
-points.
+Text to be appended to the formatted section heading,
+but not to appear in the table of contents entry,
+can follow these calls.
 .
 .
-.LP
-The following four registers accept fractional point sizes:
-.BR PS ,
-.BR VS ,
-.BR FPS ,
+.TP
+.BI .XN\~ heading-text
+Format
+.I heading-text
+and create a corresponding table of contents entry;
+the indentation is computed from the
+.I depth
+argument of the preceding
+.B NH
+call.
+.
+.
+.TP
+.BI .XH\~ "depth heading-text"
+As
+.BR .XN ,
+but use
+.I depth
+to determine the indentation.
+.
+.
+.P
+.I groff ms
+encourages customization of table of contents entry production.
+.
+(Re-)define any of the following macros as desired.
+.
+.
+.TP
+.BI \%.XN\-REPLACEMENT\~ heading-text
+.TQ
+.BI \%.XH\-REPLACEMENT\~ "depth heading-text"
+These hook macros implement
+.B .XN
 and
-.BR FVS .
+.BR .XH ,
+and call
+.B \%XN\-INIT
+and
+.BR \%XH\-INIT ,
+respectively,
+then call
+.B \%XH\-UPDATE\-TOC
+with the arguments given them.
 .
 .
-.LP
-Due to backwards compatibility, the value of
-.B VS
-must be smaller than 40000 (this is 40.0 points).
+.TP
+.B \%.XH\-INIT
+.TQ
+.B \%.XN\-INIT
+These hook macros do nothing by default.
+.
+.
+.TP
+.BI \%.XH\-UPDATE\-TOC\~ "depth heading-text"
+Bracket
+.I heading-text
+with
+.B XS
+and
+.B XE
+calls,
+indenting it by 2 ens per level of
+.I depth
+beyond the first.
+.
+.
+.P
+You can customize the style of the leader that bridges each table of
+contents entry with its page number;
+define the
+.B TC\-LEADER
+special character by using the
+.B char
+request.
+.
+A typical leader combines the dot glyph
+.RB \lq .\& \rq
+with a horizontal motion escape sequence to spread the dots.
+.
+The width of the page number field is stored in the
+.B TC\-MARGIN
+register.
 .
 .
 .\" ====================================================================
-.SH "DIFFERENCES FROM troff ms"
+.SH "Differences from AT&T \fIms\f"
 .\" ====================================================================
 .
 The
-.I "groff ms"
-macros are a complete re-implementation,
-using no original AT&T code.
+.I groff ms
+macros are an independent reimplementation,
+using no AT&T code.
 .
-Since they take advantage of the extended features in
+Since they take advantage of the extended features of
 .IR groff ,
 they cannot be used with AT&T
 .IR troff .
 .
-Other differences include:
+.I groff ms
+supports features described above as Berkeley and Tenth Edition Research
+Unix extensions,
+and adds several of its own.
 .
-.IP \(bu 3n
+.
+.IP \bu 3n
 The internals of
-.I "groff ms"
-differ from the internals of Unix
+.I groff ms
+differ from the internals of AT&T
 .IR ms .
 .
-Documents that depend upon implementation details of Unix
+Documents that depend upon implementation details of AT&T
 .I ms
 may not format properly with
 .IR "groff ms" .
 .
-.IP \(bu
+Such details include macros whose function was not documented in the
+AT&T
+.I ms
+manual
+(\lqTyping Documents on the UNIX System: Using the \-ms Macros with
+Troff and Nroff\rq,
+M.\& E.\& Lesk,
+Bell Laboratories,
+1978).
+.\" TODO: Use refer(1)?
+.\" XXX: We support RT anyway; maybe we should stop?
+.
+.
+.IP \bu
 The error-handling policy of
-.I "groff ms"
+.I groff ms
 is to detect and report errors,
-rather than silently to ignore them.
+rather than to ignore them silently.
 .
-.IP \(bu
-Some Bell Labs localisms are not implemented by default.
 .
-However, if you call the otherwise undocumented
-.B SC
-section-header macro, you will enable implementations of three other
-archaic Bell Labs macros:
-.BR UC ,
-.BR P1 ,
-and
-.BR P2 .
+.IP \bu
+Tenth Edition \" possibly 9th
+Research Unix supported
+.BR P1 / P2
+macros to bracket code examples;
+.I groff ms
+does not.
 .
-These are not enabled by default because (a)\~they were not documented,
-in the original
-.IR "ms manual" ,
-and (b)\~the
-.B P1
-and
-.B UC
-macros both collide with different macros in the Berkeley version of
-.IR ms .
 .
-.IP
-These emulations are sufficient to give back the 1976 Kernighan\~&
-Cherry paper
-.I "Typesetting Mathematics \(en User's Guide"
-its section headings, and restore some text that had gone missing as
-arguments of undefined macros.
+.IP \bu
+.I groff ms
+does not work in GNU
+.IR troff 's \" GNU
+AT&T compatibility mode.
 .
-No warranty express or implied is given as to how well the typographic
-details these produce match the original Bell Labs macros.
+If loaded when that mode is enabled,
+it aborts processing with a diagnostic message.
 .
-.IP \(bu
-Berkeley localisms, in particular the
-.B TM
+.
+.IP \bu
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
+.
+.
+.IP \bu
+.I groff ms
+uses the same header and footer defaults in both
+.I nroff
 and
-.B CT
+.I troff
+modes
+as AT&T
+.I ms
+does in
+.I troff
+mode;
+AT&T's default in
+.I nroff
+mode is to put the date,
+in U.S.\& traditional format
+(e.g.,
+\lqJanuary 1, 2021\rq),
+in the center footer
+(the
+.B CF
+string).
+.
+.
+.IP \bu
+Many
+.I groff ms
 macros,
-are not implemented.
-.
-.IP \(bu
-.I "Groff ms"
-does not work in compatibility mode (e.g., with the
-.B \-C
-option).
+including those for paragraphs,
+headings,
+and displays,
+cause a reset of paragraph rendering parameters,
+and may change the indentation;
+they do so not by incrementing or decrementing it,
+but by setting it absolutely.
 .
-.IP \(bu
-There is no support for typewriter-like devices.
+This can cause problems for documents that define additional macros of
+their own that try to manipulate indentation.
 .
-.IP \(bu
-.I "Groff ms"
-does not provide cut marks.
+Use
+.B .RS
+and
+.B .RE
+instead of the
+.B in
+request.
 .
-.IP \(bu
-Multiple line spacing is not supported
-(use a larger vertical spacing instead).
 .
-.IP \(bu
-Some Unix
+.IP \bu
+AT&T
 .I ms
-documentation says that the
-.B CW
+interpreted the values of the registers
+.B PS
 and
-.B GW
-number registers can be used to control the column width and
-gutter width, respectively.
+.B VS
+in points,
+and did not support the use of scaling units with them.
 .
-These number registers are not used in
-.IR "groff ms" .
+.I groff ms
+interprets values of the registers
+.BR PS ,
+.BR VS ,
+.BR FPS ,
+and
+.BR FVS ,
+equal to or larger than\~1,000
+(one thousand)
+as decimal fractions multiplied by\~1,000.
 .
-.IP \(bu
-Macros that cause a reset
-(paragraphs, headings, etc.\&)
-may change the indent.
+(Register values are converted to and stored as basic
+units.
 .
-Macros that change the indent do not increment or decrement the
-indent, but rather set it absolutely.
+See \lqMeasurements\rq in the
+.I groff
+Texinfo manual or in
+.MR groff @MAN7EXT@ ).
 .
-This can cause problems for documents that define additional macros of
-their own.
+This threshold makes use of a scaling unit with these parameters
+practical for high-resolution devices while preserving backward
+compatibility.
 .
-The solution is to use not the
-.B in
-request but instead the
-.B RS
-and
-.B RE
-macros.
+It also permits expression of non-integral type sizes.
 .
-.IP \(bu
-The number register
-.B GS
-is set to\~1 by the
-.I "groff ms"
-macros,
-but is not used by the Unix
-.I ms
-macros.
+For example,
+.RB \lq "groff \-rPS=10.5p" \rq
+at the shell prompt is equivalent to placing
+.RB \lq ".nr PS 10.5p" \rq
+at the beginning of the document.
 .
-Documents that need to determine whether they are being formatted with
-Unix
+.
+.IP \bu
+AT&T
+.IR ms 's
+.B AU
+macro supported arguments used with some document types;
+.I groff ms
+does not.
+.
+.
+.IP \bu
+Right-aligned displays are available.
+.
+The AT&T
 .I ms
-or
-.I "groff ms"
-should use this number register.
+manual observes that \lqit is tempting to assume that
+.RB \lq ".DS R" \rq
+will right adjust lines,
+but it doesn't work\rq.
 .
-.IP \(bu
+In
+.IR "groff ms" ,
+it does.
+.
+.
+.IP \bu
 To make
-.I "groff ms"
-use the default page offset (which also specifies the left margin),
+.I groff ms
+use the default page offset
+(which also specifies the left margin),
 the
 .B PO
-number register must stay undefined until the first
-.B ms
-macro is evaluated.
+register must stay undefined until the first
+.I ms
+macro is called.
 .
 This implies that
-.B PO
-should not be used early in the document, unless it is changed also:
-remember that accessing an undefined register automatically defines it.
-.br
-.ne 23
+.B \rsnPO
+should not be used early in the document,
+unless it is changed also:
+accessing an undefined register automatically defines it.
 .
 .
-.\" ====================================================================
-.SS Strings
-.\" ====================================================================
+.IP \bu
+.I groff ms
+supports the
+.B PN
+register,
+but it is not necessary;
+you can access the page number via the usual
+.B %
+register and invoke the
+.B af
+request to assign a different format to it if desired.
+.
+(If you redefine the
+.I ms
+.B PT
+macro \" I wouldn't mention that, but Lesk 1978 encourages doing so. :-/
+and desire special treatment of certain page numbers\emlike
+.RB \lq 1 \rq\emyou
+may need to handle a non-Arabic page number format,
+as
+.IR "groff ms" 's
+.B .PT
+does;
+see the macro package source.
+.
+.I groff ms
+aliases the
+.B PN
+register to
+.BR % .)
+.
+.
+.IP \bu
+The AT&T
+.I ms
+manual documents registers
+.B CW
+and
+.B GW
+as setting the default column width and \lqintercolumn gap\rq,
+respectively,
+and which applied when
+.B .MC
+was called with fewer than two arguments.
+.
+.I groff ms
+instead treats
+.B .MC
+without arguments as synonymous with
+.BR .2C ;
+there is thus no occasion for a default column width register.
+.
+Further,
+the
+.B MINGW
+register
+and the second argument to
+.B .MC
+specify a
+.I minimum
+space between columns,
+not the fixed gutter width of AT&T
+.IR ms .
+.
 .
-You can redefine the following strings to adapt the
+.IP \bu
+The AT&T
+.I ms
+manual did not document the
+.B QI
+register;
+Berkeley and
 .I "groff ms"
-macros to languages other than English:
-.RS
-.TS
-cb   cb
-lfCW l.
-String	Default Value
-_
-REFERENCES	References
-ABSTRACT	ABSTRACT
-TOC	Table of Contents
-MONTH1	January
-MONTH2	February
-MONTH3	March
-MONTH4	April
-MONTH5	May
-MONTH6	June
-MONTH7	July
-MONTH8	August
-MONTH9	September
-MONTH10	October
-MONTH11	November
-MONTH12	December
-_
-.TE
-.RE
+do.
 .
 .
-.PP
-The
-.B \rs*\-
-string produces an em dash\emlike this.
+.IP \bu
+The register
+.B GS
+is set to\~1 by the
+.I groff ms
+macros,
+but is not used by the AT&T
+.I ms
+package.
+.
+Documents that need to determine whether they are being formatted with
+.I groff ms
+or another implementation should test this register.
 .
 .
-.PP
-Use
-.B \rs*Q
-and
-.B \rs*U
-to get a left and right typographer's quote,
-respectively, in
-.I troff
-(and plain quotes in
-.IR nroff ).
+.\" ====================================================================
+.SS "Unix Version\~7 macros not implemented by \fIgroff ms\f"
+.\" ====================================================================
+.
+Several macros described in the Unix Version\~7
+.I ms
+documentation are unimplemented by
+.I groff ms
+because they are specific to the requirements of documents produced
+internally by Bell Laboratories,
+some of which also require a glyph for the Bell System logo that
+.I groff
+does not support.
+.
+These macros implemented several document type formats
+(\c
+.BR EG , \" engineer's notes
+.BR IM , \" internal memorandum
+.BR MF , \" memorandum for file
+.BR MR , \" memorandum for record
+.BR TM , \" technical memorandum
+.BR TR ), \" technical report
+were meaningful only in conjunction with the use of certain document
+types
+(\c
+.BR AT , \" attachments
+.BR CS , \" cover sheet info for `TM` documents
+.BR CT , \" copies to
+.BR OK , \" "other keywords" for `TM` documents
+.BR SG ), \" signatures for `TM` documents
+stored the postal addresses of Bell Labs sites
+(\c
+.BR HO , \" Holmdel
+.BR IH , \" Naperville
+.BR MH , \" Murray Hill
+.BR PY , \" Piscataway
+.BR WH ), \" Whippany
+or lacked a stable definition over time
+(\c
+.BR UX ). \" Unix; on 1st use, add footnote identifying trademark owner
 .
 .
 .\" ====================================================================
-.SS Text Settings
+.SH "Legacy features"
 .\" ====================================================================
 .
-The
-.B FAM
-string sets the default font family.
+.I "groff ms"
+retains some legacy features solely to support formatting of historical
+documents;
+contemporary ones should not use them because they can render poorly.
 .
-If this string is undefined at initialization,
-it is set to Times.
+See
+.MR groff_char @MAN7EXT@
+instead.
 .
 .
-.LP
-The point size, vertical spacing, and inter-paragraph spacing for
-footnotes are controlled by the number registers
-.BR FPS ,
-.BR FVS ,
-and
-.BR FPD ;
-at initialization these are set to
-.BR \rsn(PS\-2 ,
-.BR \rsnFPS+2 ,
-and
-.BR \rsn(PD/2 ,
-respectively.
+.\" ====================================================================
+.SS "AT&T \fIms\f accent mark strings"
+.\" ====================================================================
 .
-If any of these registers are defined before initialization,
-the initialization macro does not change them.
+AT&T
+.I ms
+defined
+accent mark strings as follows.
 .
 .
-.LP
-The hyphenation flags (as set by the
-.B hy
-request) are set from the
-.B HY
-register;
-the default is\~6.
+.P
+.TS
+Cb Lb
+Lf(CR) L.
+String	Description
+_
+\rs*\aq	Apply acute accent to subsequent glyph.
+\rs*\ga	Apply grave accent to subsequent glyph.
+\rs*:	Apply dieresis (umlaut) to subsequent glyph.
+\rs*\ha	Apply circumflex accent to subsequent glyph.
+\rs*\ti	Apply tilde accent to subsequent glyph.
+\rs*C	Apply caron to subsequent glyph.
+.\" \*v was an undocumented (in Lesk 1978-11-13) synonym for \*C.
+\rs*,	Apply cedilla to subsequent glyph.
+.TE
 .
 .
-.PP
-Improved accent marks
-(as originally defined in Berkeley's
+.\" ====================================================================
+.SS "Berkeley \fIms\f accent mark and glyph strings"
+.\" ====================================================================
+.
+Berkeley
 .I ms
-version)
-are available by specifying the
+offered an
 .B AM
-macro at the beginning of your document.
+macro;
+calling it redefined the AT&T accent mark strings
+(except for
+.BR \rs*C ),
+applied them to the
+.I preceding
+glyph,
+and defined additional strings,
+some for spacing glyphs.
 .
-You can place an accent over most characters by specifying the string
-defining the accent directly after the character.
 .
-For example,
-.B n\rs*\ti
-produces an n with a tilde over it.
+.TP
+.B .AM
+Enable alternative accent mark and glyph-producing strings.
+.
+.
+.P
+.TS
+Cb Lb
+Lf(CR) L.
+String	Description
+_
+\rs*\aq	Apply acute accent to preceding glyph.
+\rs*\ga	Apply grave accent to preceding glyph.
+\rs*:	Apply dieresis (umlaut) to preceding glyph.
+\rs*\ha	Apply circumflex accent to preceding glyph.
+\rs*\ti	Apply tilde accent to preceding glyph.
+\rs*,	Apply cedilla to preceding glyph.
+\rs*/	Apply stroke (slash) to preceding glyph.
+\rs*v	Apply caron to preceding glyph.
+\rs*_	Apply macron to preceding glyph.
+\rs*.	Apply underdot to preceding glyph.
+\rs*o	Apply ring accent to preceding glyph.
+_
+\rs*?	Interpolate inverted question mark.
+\rs*!	Interpolate inverted exclamation mark.
+\rs*8	Interpolate small letter sharp s.
+\rs*q	Interpolate small letter o with hook accent (ogonek).
+\rs*3	Interpolate small letter yogh.
+\rs*d-	Interpolate small letter eth.
+\rs*D-	Interpolate capital letter eth.
+\rs*th	Interpolate small letter thorn.
+\rs*TH	Interpolate capital letter thorn.
+\rs*ae	Interpolate small ae ligature.
+\rs*AE	Interpolate capital ae ligature.
+\rs*oe	Interpolate small oe ligature.
+\rs*OE	Interpolate capital oe ligature.
+.TE
 .
 .
 .\" ====================================================================
-.SH "NAMING CONVENTIONS"
+.SH "Naming conventions"
 .\" ====================================================================
 .
-The following conventions are used for names of macros, strings, and
-number registers.
+The following conventions are used for names of macros,
+strings,
+and registers.
 .
 External names available to documents that use the
-.I "groff ms"
+.I groff ms
 macros contain only uppercase letters and digits.
 .
 .
 .LP
-Internally the macros are divided into modules;
-naming conventions are as follows:
+Internally,
+the macros are divided into modules.
 .
-.IP \(bu 3n
+Conventions for identifier names are as follows.
+.
+.IP \bu 3n
 Names used only within one module are of the form
-.IB \%module * name\fR.
+.IB \%module * name\c
+\&.
 .
-.IP \(bu
+.IP \bu
 Names used outside the module in which they are defined are of the form
-.IB \%module @ name\fR.
+.IB \%module @ name\c
+\&.
 .
-.IP \(bu
+.IP \bu
 Names associated with a particular environment are of the form
-.IB \%environment : name\fR;
+.IB \%environment : name\c
+\&;
 these are used only within the
 .B par
 module.
 .
-.IP \(bu
+.IP \bu
 .I name
 does not have a module prefix.
 .
-.IP \(bu
+.IP \bu
 Constructed names used to implement arrays are of the form
-.IB \%array ! index\fR.
+.IB \%array ! index\c
+\&.
 .
 .
 .PP
-Thus the groff ms macros reserve the following names:
+Thus the
+.I groff ms
+macros reserve the following names:
 .
-.IP \(bu 3n
+.IP \bu 3n
 Names containing the characters
 .BR * ,
 .BR @ ,
 and\~\c
 .BR : .
 .
-.IP \(bu
+.IP \bu
 Names containing only uppercase letters and digits.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
-.I @MACRODIR@/ms.tmac
-(a wrapper file for
-.IR s.tmac )
-.br
-.I @MACRODIR@/s.tmac
+.TP
+.I @MACRODIR@/\:@TMAC_S_PREFIX@s\:.tmac
+implements the package.
+.
+.
+.TP
+.I @MACRODIR@/refer\-ms.tmac
+implements
+.MR @g@refer @MAN1EXT@
+support for
+.IR ms .
+.
+.
+.TP
+.I @MACRODIR@/\:ms\:.tmac
+is a wrapper enabling the package to be loaded with
+.RB \lq "groff \-m ms" \rq.
 .
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 The GNU version of the
 .I ms
 macro package was written by James Clark and contributors.
 .
-This document was (re-)written by
-.MT lkollar@\:despammed.com
+This document was written by Clark,
+.MT lkollar@\:despammed\:.com
 Larry Kollar
+.ME ,
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
+.br
+.ne 8v
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR @g@tbl (@MAN1EXT@),
-.BR @g@pic (@MAN1EXT@),
-.BR @g@eqn (@MAN1EXT@),
-.BR @g@refer (@MAN1EXT@)
+A manual is available in source and rendered form.
+.
+On your system,
+it may be compressed and/or available in additional formats.
+.
+.
+.TP
+.I @DOCDIR@/\:ms\:.ms
+.TQ
+.I @DOCDIR@/\:ms\:.ps
+\lqUsing
+.I groff
+with the
+.I ms
+Macro Package\rq;
+Larry Kollar and \%G.\~Branden Robinson.
+.
+.
+.br
+.ne 5v
+.TP
+.I @DOCDIR@/\:\%msboxes\:.ms
+.TQ
+.I @DOCDIR@/\:\%msboxes\:.pdf
+\lqUsing PDF boxes with
+.I groff
+and the
+.I ms
+macros\rq;
+Deri James.
+.
+.B \%BOXSTART
+and
+.B \%BOXSTOP
+macros are available via the
+.I sboxes
+extension package,
+enabling colored,
+bordered boxes when the
+.B pdf
+output device is used.
 .
 .
 .PP
 .IR "Groff: The GNU Implementation of troff" ,
-by Trent A.\& Fisher and Werner Lemberg
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \lqinfo groff\rq.
+.
+.
+.PP
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR @g@tbl @MAN1EXT@ ,
+.MR @g@pic @MAN1EXT@ ,
+.MR @g@eqn @MAN1EXT@ ,
+.MR @g@refer @MAN1EXT@
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_ms_C
+.cp \n*groff_groff_ms_7_man_C
+.do rr *groff_groff_ms_7_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_trace.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_trace.7.man Changed

@@ -1,21 +1,15 @@
-.TH GROFF_TRACE @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_trace \- groff macro package trace.tmac
-.
-.\" groff_trace.7
-.\" File position: <groff-source>/tmac/groff_trace.man
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_trace_C \n.C
-.cp 0
+.TH groff_trace @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_trace \- macros for debugging GNU
+.I roff
+documents
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2002-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2002-2022 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -29,268 +23,267 @@
 .\" called FDL in the main directory of the groff source package.
 .
 .
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_trace_7_man_C \n.cp
+.cp 0
+.
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
+.
+.
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY "groff \-m trace"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
 .YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-The
 .I trace
-macro package of
-.BR groff (@MAN1EXT@)
-can be a valuable tool for debugging documents written in the roff
-formatting language.
-.
-A call stack trace is protocolled on standard error, this is, a
-diagnostic message is emitted on entering and exiting of a macro call.
-.
-This greatly eases to track down an error in some macro.
-.
-.
-.P
-This tracing process is activated by specifying the groff or troff
-command-line option
-.BR \-m\ trace .
-.
-This works also with the
-.BR groffer (@MAN1EXT@)
-viewer program.
-.
-A finer control can be obtained by including the macro file within the
-document by the groff macro call
-.BR .mso\ trace.tmac .
-.
-Only macros that are defined after this line are traced.
+is a macro package for the
+.MR groff @MAN7EXT@
+document formatting system,
+designed as an aid for debugging documents written in its language.
 .
+It issues a message to the standard error stream upon entry to and exit
+from each macro call.
 .
-.P
-If the command-line option
-.B \-r\ trace-full=1
-is given (or if this register is set in the document), number and
-string register assignments together with some other requests are
-traced also.
+This can ease the process of isolating errors in macro definitions.
 .
 .
 .P
-If some other macro package should be traced as well it must be
-specified after
-.B \-m\ trace
+Activate the package by specifying the command-line option
+.RB \lq \-m\~trace \rq
+to the formatter program
+(often
+.MR groff @MAN1EXT@ ).
+.
+You can achieve finer control by including the macro file within the
+document;
+invoke the
+.B mso
+request,
+as in
+.RB \lq .mso\~trace.tmac \rq.
+.
+Only macros that are defined after this invocation are traced.
+.
+If the
+.B trace\-full
+register is set to a true value,
+as with the command-line option
+.RB \lq \-r\~trace\-full=1 \rq,
+register and string assignments,
+along with some other requests,
+are traced also.
+.
+If another macro package should be traced as well,
+specify it after
+.RB \lq \-m\~trace \rq
 on the command line.
 .
 .
 .P
 The macro file
-.B trace.tmac
+.I trace.tmac
 is unusual because it does not contain any macros to be called by a
 user.
 .
-Instead, the existing macro definition and appending facilities are
-modified such that they display diagnostic messages.
+Instead,
+.IR groff 's
+macro definition and alteration facilities are wrapped such that they
+display diagnostic messages.
 .
 .
 .\" ====================================================================
-.SH EXAMPLES
+.SS Limitations
 .\" ====================================================================
 .
-In the following examples, a roff fragment is fed into groff via
-standard input.
-.
-As we are only interested in the diagnostic messages (standard error)
-on the terminal, the normal formatted output (standard output) is
-redirected to the nirvana device
-.IR /dev/null .
-.
-The resulting diagnostic messages are displayed directly below the
-corresponding example.
+Because
+.I trace.tmac
+wraps the
+.B de
+request
+(and its cousins),
+macro arguments are expanded one level more.
 .
+This causes problems if an argument uses four or more backslashes to
+delay interpretation of an escape sequence.
 .
-.\" ====================================================================
-.SS "Command line option"
-Example:
+For example,
+the macro call
 .
 .RS
-.P
 .EX
-\fIsh#\fP echo \aq.
-> .de test_macro
-> ..
-> .test_macro
-> .test_macro some dummy arguments
-> \aq | groff \-m trace > /dev/null
-
-*** .de test_macro
-*** de trace enter: .test_macro
-*** trace exit: .test_macro
-*** de trace enter: .test_macro "some" "dummy" "arguments"
-*** trace exit: .test_macro "some" "dummy" "arguments"
+\&.foo \rs\rs\rs\rsnbar
 .EE
 .RE
 .
-.P
-The entry and the exit of each macro call is displayed on the terminal
-(standard output) \em together with the arguments (if any).
+normally passes \lq\rs\rsnbar\rq to macro \lqfoo\rq,
+but with
+.B de
+redefined,
+it passes \lq\rsnbar\rq instead.
 .
 .
-.\" ====================================================================
-.SS "Nested macro calls"
-Example:
+.P
+The solution to this problem is to use
+.IR groff 's
+.B \rsE
+escape sequence,
+an escape character that is not interpreted in copy mode.
 .
 .RS
-.P
 .EX
-\fIsh#\fP echo \aq.
-> .de child
-> ..
-> .de parent
-> .child
-> ..
-> .parent
-> \aq | groff \-m trace > /dev/null
-
-*** .de child
-*** .de parent
-*** de trace enter: .parent
- *** de trace enter: .child
- *** trace exit: .child
-*** trace exit: .parent
+\&.foo \rsEnbar
 .EE
 .RE
 .
-.P
-This shows that macro calls can be nested.
-.
-This powerful feature can help to tack down quite complex call stacks.
-.
 .
 .\" ====================================================================
-.SS "Activating with .mso"
-Example:
-.
-.RS
-.P
-.EX
-\fIsh#\fP echo \aq.
-> .de before
-> ..
-> .mso trace.tmac
-> .de after
-> ..
-> .before
-> .after
-> .before
-> \aq | groff > /dev/null
-
-*** de trace enter: .after
-*** trace exit: .after
-.EE
-.RE
+.SH Examples
+.\" ====================================================================
 .
-.P
-Here, the tracing is activated within the document, not by a
-command-line option.
+We will illustrate
+.I trace.tmac
+using the shell's \lqhere document\rq feature to supply
+.I groff
+with a document
+on the standard input stream.
 .
-As tracing was not active when macro
-.I before
-was defined, no call of this macro is protocolled; on the other hand,
-the macro
-.I after
-is fully protocolled.
+Since we are interested only in diagnostic messages appearing on the
+standard error stream,
+we discard the formatted output by redirecting the standard output
+stream to
+.IR /dev/null .
 .
 .
 .\" ====================================================================
-.SH PROBLEMS
+.SS "Observing nested macro calls"
 .\" ====================================================================
 .
-Because
-.B trace.tmac
-wraps the
-.B .de
-request (and its cousins), macro arguments are expanded one level more.
+Macro calls can be nested,
+even with themselves.
 .
-This causes problems if an argument contains four backslashes or more
-to prevent too early expansion of the backslash.
+Tracing recurses along with them;
+this feature can help to detangle complex call stacks.
 .
-For example, this macro call
 .
-.IP
+.RS
+.P
 .EX
-\&.foo \e\e\e\enbar
+.RB $\~ "cat <<EOF | groff \-m trace > /dev/null
+.B .de countdown
+.B .  nop \rs\rs$1
+.B .  nr count (\rs\rs$1 - 1)
+.B .  if \rs\rsncount .countdown \rs\rsncount
+.B ..
+.B .countdown 3
+.B blastoff
+.B EOF
+\~*** .de countdown
+\~*** de trace enter: .countdown "3"
+\~\~*** de trace enter: .countdown "2"
+\~\~\~*** de trace enter: .countdown "1"
+\~\~\~*** trace exit: .countdown "1"
+\~\~*** trace exit: .countdown "2"
+\~*** trace exit: .countdown "3"
 .EE
+.RE
 .
 .
-.P
-normally passes \oq\e\enbar\cq to macro \oq.foo\cq, but with
-the redefined
-.B .de
-request it passes \oq\enbar\cq instead.
+.\" ====================================================================
+.SS "Tracing with the mso request"
+.\" ====================================================================
 .
+Now let us activate tracing within the document,
+not with a command-line option.
+.
+We might do this when using a macro package like
+.I ms
+or
+.IR mom ,
+where we may not want to be distracted by traces of macros we didn't
+write.
 .
-.P
-The solution to this problem is to use groff's
-.B \eE
-escape which is an escape character not interpreted in copy mode, for
-example
 .
-.IP
+.RS
+.P
 .EX
-\&.foo \eEnbar
+.RB $\~ "cat <<EOF | groff -ms > /dev/null"
+.B .LP
+.B This is my introductory paragraph.
+.B .mso trace.tmac
+.B .de Mymac
+.B ..
+.B .Mymac
+.B .PP
+.B Let us review the existing literature.
+.B EOF
+\~*** .de Mymac
+\~*** de trace enter: .Mymac
+\~*** trace exit: .Mymac
 .EE
+.RE
 .
 .
-.\" ====================================================================
-.SH FILES
-.\" ====================================================================
-.
-The
-.I trace
-macros are kept in the file
-.B trace.tmac
-located in the
-.IR "tmac directory" ;
-see
-.BR groff_tmac (@MAN5EXT@)
-for details.
+.P
+As tracing was not yet active when the macros \lqLP\rq and
+\lqPP\rq were defined
+(by
+.IR s.tmac ),
+their calls were not traced;
+contrast with the macro \lqMymac\rq.
 .
 .
+.br
+.ne 3v
 .\" ====================================================================
-.SH ENVIRONMENT
+.SH Files
 .\" ====================================================================
 .
 .TP
-.I GROFF_TMAC_PATH
-A colon-separated list of additional tmac directories in which to
-search for macro files; see
-.BR groff_tmac (@MAN5EXT@)
-for details.
+.I @MACRODIR@/\:trace\:.tmac
+implements the package.
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
 .
-The
-.I trace
-macro packages was written by James Clark.
+.I trace.tmac
+was written by James Clark.
 .
 This document was written by
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
+.ME
+and
+.MT g.branden\:.robinson@\:gmail\:.com
+G.\& Branden Robinson
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
 .
 .IR "Groff: The GNU Implementation of troff" ,
@@ -303,31 +296,40 @@
 .
 .
 .TP
-.BR groff (@MAN1EXT@)
-An overview of the groff system.
+.MR groff @MAN1EXT@
+gives an overview of the
+.I groff
+document formatting system.
 .
-.TP
-.BR troff (@MAN1EXT@)
-For details on option
-.BR \-m .
 .
 .TP
-.BR groffer (@MAN1EXT@)
-A viewer program for all kinds of roff documents.
+.MR troff @MAN1EXT@
+supplies details of the
+.B \-m
+command-line option.
+.
 .
 .TP
-.BR groff_tmac (@MAN5EXT@)
-A general description of groff macro packages.
+.MR groff_tmac @MAN5EXT@
+offers a survey of
+.I groff
+macro packages.
+.
 .
 .TP
-.BR groff (@MAN7EXT@)
-A short reference for the groff formatting language.
+.MR groff @MAN7EXT@
+is a reference manual for the
+.I groff
+language.
+.
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_trace_C
+.cp \n*groff_groff_trace_7_man_C
+.do rr *groff_groff_trace_7_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/groff_www.7.man -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/groff_www.7.man Changed

@@ -1,21 +1,15 @@
-.TH GROFF_WWW @MAN7EXT@ "@MDATE@" "groff @VERSION@"
-.SH NAME
-groff_www \- groff macros for authoring web pages
-.
-.\" User level guide to using the -mwww macroset
-.
-.
-.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
-.do nr groff_www_C \n.C
-.cp 0
-.do mso www.tmac
+.TH groff_www @MAN7EXT@ "@MDATE@" "groff @VERSION@"
+.SH Name
+groff_www \- GNU
+.I roff
+macros for authoring web pages
 .
 .
 .\" ====================================================================
 .\" Legal Terms
 .\" ====================================================================
 .\"
-.\" Copyright (C) 2000-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2000-2020 Free Software Foundation, Inc.
 .\"
 .\" This file is part of groff, the GNU roff type-setting system.
 .\"
@@ -34,55 +28,75 @@
 .\" <http://www.gnu.org/licenses/>.
 .
 .
-.\" we need the .LK here as we use it in the middle as an example --
-.\" once the user requests .LK then the automatic generation of links
-.\" at the top of the document is suppressed.
-.LK
+.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
+.do nr *groff_groff_www_7_man_C \n.cp
+.cp 0
 .
-.HR
+.\" Define fallback for groff 1.23's MR macro if the system lacks it.
+.nr do-fallback 0
+.if !\n(.f           .nr do-fallback 1 \" mandoc
+.if  \n(.g .if !d MR .nr do-fallback 1 \" older groff
+.if !\n(.g           .nr do-fallback 1 \" non-groff *roff
+.if \ndo-fallback  \{\
+.  de MR
+.    ie \\n(.$=1 \
+.      I \%\\$1
+.    el \
+.      IR \%\\$1 (\\$2)\\$3
+.  .
+.\}
+.rr do-fallback
 .
 .
 .\" ====================================================================
-.SH SYNOPSIS
+.SH Synopsis
 .\" ====================================================================
 .
 .SY "groff \-m www"
-.RI  option
-\&.\|.\|.\&
-.RI  input-file
-\&.\|.\|.\&
+.RI  option\~ .\|.\|.\&
+.RI  file\~ .\|.\|.
+.YS
 .
 .
 .\" ====================================================================
-.SH DESCRIPTION
+.SH Description
 .\" ====================================================================
 .
-This manual page describes the GNU \-mwww macro package, which is part of
-the groff document formatting system.
-.
-The manual page is very a basic guide, and the HTML device driver
-.RB ( \%grohtml )
-has been completely rewritten but still remains as in an alpha state.
-.
-It has been included into the distribution so that a lot of people have a
-chance to test it.
+This manual page describes the GNU
+.I www
+macro package,
+which is part of the
+.MR groff @MAN7EXT@
+document formatting system.
 .
-Note that this macro file is automatically called (via the
+This macro file is automatically loaded by the default
 .I troffrc
-file) if you use
+file when the formatter
+(usually
+.MR groff @MAN1EXT@ )
+is called with either of the options
 .B \-Thtml
 or
 .BR \-Txhtml .
 .
+To see hyperlinks in action,
+format this man page using one of those options.
 .
-.PP
-To see the hyperlinks in action, please format this man page with the
-.B \%grohtml
-device.
 .
+.P
+This document is a basic guide;
+the HTML output driver
+.RI ( \%grohtml )
+remains in an alpha state.
 .
-.PP
+It has been included with the distribution to encourage testing.
+.
+.
+.P
 Here is a summary of the functions found in this macro set.
+.
+.
+.P
 .TS
 tab(@);
 l l.
@@ -122,18 +136,8 @@
 .TE
 .
 .
-.PP
-Output of the
-.BR pic ,
-.BR eqn ,
-.BR refer ,
-and
-.B tbl
-preprocessors is acceptable as input.
-.
-.
 .\" ====================================================================
-.SH REQUESTS
+.SH Macros
 .\" ====================================================================
 .
 .TP
@@ -145,7 +149,7 @@
 Its argument is the file stem name for future output files.
 .
 This option is equivalent to
-.BR \%grohtml 's
+.IR \%grohtml 's
 .B \-j
 option.
 .
@@ -154,7 +158,7 @@
 Specify the cut off depth when generating links from section headings.
 .
 For example, a parameter of\~2 would cause
-.B \%grohtml
+.I \%grohtml
 to generate a list of links for
 .B .NH\ 1
 and
@@ -163,27 +167,36 @@
 .BR .NH\ 3 .
 .
 Whereas
+.
+.
 .RS
 .IP
-.nf
-.B .HX 0
-.fi
+.EX
+\&.HX 0
+.EE
 .RE
+.
+.
 .IP
 tells
-.B \%grohtml
+.I \%grohtml
 that no heading links should be created at all.
 .
 Another method for turning automatic headings off is by issuing the
 command-line switch
 .B \-P\-l
 to
-.BR groff .
+.IR groff .
+.
 .
 .TP
-.B .BCL foreground background active not-visited visited
-This macro takes five parameters: foreground, background, active hypertext
-link, hypertext link not yet visited, and visited hypertext link colour.
+.BI .BCL\~ "foreground background active not-visited visited"
+This macro takes five parameters:
+foreground,
+background,
+active hypertext link,
+hypertext link not yet visited,
+and visited hypertext link colour.
 .
 .TP
 .B .BGIMG imagefile
@@ -191,9 +204,9 @@
 .
 .TP
 .B .URL url description after
-generates
-.TAG URL
-a URL using either one, two or three arguments.
+generates a URL using either one,
+two,
+or three arguments.
 .
 The first parameter is the actual URL, the second is the name of the
 link, and the third is optional stuff to be printed immediately
@@ -210,15 +223,15 @@
 Hyphenation is disabled while printing the actual URL;
 explicit breakpoints should be inserted with the
 .B \rs:
-escape.
+escape sequence.
 .
 Here is how to encode
-.UR http://\:foo.\:org/
+.UR http://\:foo\:.org/
 foo
 .UE :
 .RS
 .IP
-.B .URL http://\rs:foo.\rs:org/ "foo" :
+.B .URL http://\rs:foo\rs:.org/ "foo" :
 .RE
 .
 .IP
@@ -229,18 +242,21 @@
 it appears as:
 .RS
 .IP
-foo \la\fCRhttp://foo.org\f\ra:
+foo \la\fCRhttp://\:foo\:.org\f\ra:
 .RE
 .
 .IP
-The URL macro can be of any type; for example we can reference
-.UR pic.html
-Eric Raymond's pic guide
+The URL macro can be of any type;
+for example, we can reference
+.UR pic\:.html
+Eric Raymond's
+.I pic
+guide
 .UE
 by:
 .RS
 .IP
-.B .URL pic.html \dqEric Raymond's pic guide\dq
+.B .URL pic\rs:.html \dqEric Raymond\aqs pic guide\dq
 .RE
 .
 .TP
@@ -260,7 +276,7 @@
 Hyphenation is disabled while printing the actual email address.
 .
 For example,
-.MT joe@user.org
+.MT joe@\:user\:.org
 Joe User
 .ME
 can be achieved by the following macro:
@@ -270,8 +286,9 @@
 .RE
 .
 .IP
-Note that all the URLs actually are treated as consuming no textual
-space in groff.
+All URLs currently are treated as consuming no textual
+space in
+.IR groff .
 .
 This could be considered as a bug since it causes some problems.
 .
@@ -297,14 +314,14 @@
 Hyphenation is disabled while printing the actual URL.
 .
 As an example, here is the location of the
-.UR ftp://\:ftp.gnu.org/
+.UR ftp://\:ftp\:.gnu\:.org/
 GNU FTP server
 .UE .
 .
 The macro example above can be specified as:
 .RS
 .IP
-.B .FTP ftp://\rs:ftp.gnu.org/ \dqGNU FTP server\dq .
+.B .FTP ftp://\rs:ftp\rs:.gnu\rs:.org/ \dqGNU FTP server\dq .
 .RE
 .
 .TP
@@ -323,20 +340,21 @@
 .
 This link was achieved via placing a TAG in the URL description above;
 the source looks like this:
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.TP
 \&.B URL
 generates
 \&.TAG URL
 a URL using either two or three arguments.
 \&.\|.\|.
-.fi
-.ft P
+.EE
 .RE
 .
+.
 .TP
 .B .IMG \-R|\-L|\-C filename width height
 Include a picture into the document.
@@ -386,7 +404,8 @@
 .B \-Txhtml
 it is necessary to use the
 .B \-U
-option of groff.
+option of
+.IR groff .
 .
 .TP
 .B .MPIMG \-R|\-L \-G gap filename width height
@@ -420,15 +439,16 @@
 If the height is absent it defaults to the width.
 .
 Example:
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.MPIMG \-L \-G 2c foo.png 3c 1.5c
-.ft P
-.fi
+.EE
 .RE
 .
+.
 .IP
 The height and width may also be given as percentages.
 .
@@ -439,15 +459,16 @@
 register.
 .
 For example:
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.MPIMG \-L \-G 2c foo.png 15%
-.ft P
-.fi
+.EE
 .RE
 .
+.
 .TP
 .B .HnS n
 Begin heading.
@@ -459,25 +480,24 @@
 Use this macro if your headings contain URL, FTP or MTO macros.
 .
 Example:
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.HnS 1
 \&.HR
 GNU Troff
-\&.URL http://groff.ffii.org (Groff)
-\&\(em a
-\&.URL http://www.gnu.org/ GNU
+\&.URL https://\rs:www\rs:.gnu\rs:.org/\rs:software/\rs:groff/
+\&\rsema
+\&.URL http://www\rs:.gnu\rs:.org/ GNU
 \&project.
-\&Hosted by
-\&.URL http://ffii.org/ FFII .
 \&.HR
 \&.HnE
-.ft P
-.fi
+.EE
 .RE
 .
+.
 .IP
 In this case you might wish to disable automatic links to headings.
 .
@@ -494,17 +514,10 @@
 .
 .TP
 .B .LK
-.TAG LK
-Force \%grohtml to place the automatically generated links at this
-position.
+Force
+.I \%grohtml
+to place the automatically generated links at this position.
 .
-If this manual page has been processed with
-.B \-Thtml
-or
-.B \-Txhtml
-those links can be seen right here.
-.
-.LK
 .
 .TP
 .B .HR
@@ -517,8 +530,9 @@
 .
 .TP
 .B .NHR
-Suppress generation of the top and bottom rules which \%grohtml emits
-by default.
+Suppress generation of the top and bottom rules which
+.I \%grohtml
+emits by default.
 .
 .TP
 .B .HTL
@@ -545,17 +559,19 @@
 .BR \-Txhtml .
 .
 Example:
+.
+.
 .RS
 .IP
-.nf
-.B ".HEAD" "\dq<link \rs"
-.B "  rel=\dq\dqicon\dq\dq \rs"
-.B "  type=\dq\dqimage/png\dq\dq \rs"
-.B "  href=\dq\dqhttp://foo.org//bar.png\dq\dq/>\dq"
-.fi
-.ft P
+.EX
+\&.HEAD \dq<link \rs
+  rel=\dq\dqicon\dq\dq \rs
+  type=\dq\dqimage/png\dq\dq \rs
+  href=\dq\dqhttp://foo.org//bar.png\dq\dq/>\dq
+.EE
 .RE
 .
+.
 .TP
 .B .HTML
 All text after this macro is treated as raw HTML.
@@ -573,15 +589,15 @@
 For example, the
 .B BGIMG
 macro is defined as
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.de BGIMG
-\&.   HTML <body background=\rs\rs$1>
+\&.\&   HTML <body background=\rs\rs$1>
 \&..
-.ft P
-.fi
+.EE
 .RE
 .
 .
@@ -647,27 +663,28 @@
 used with the HTML device.
 .
 The macro set initializes itself with the following call
+.
+.
 .RS
 .IP
-.nf
-.ft B
+.EX
 \&.LINKSTYLE blue CR \ela \era
-.ft P
-.fi
+.EE
 .RE
 .
+.
 .IP
 but these values will be superseded by a user call to LINKSTYLE.
 .
 .
 .\" ====================================================================
-.SH SECTION HEADING LINKS
+.SH "Section heading links"
 .\" ====================================================================
 .
 By default
-.B \%grohtml
-generates links to all section headings and places these at the top of the
-HTML document.
+.I \%grohtml
+generates links to all section headings and places these at the top of
+the HTML document.
 .
 (See
 .UR #LK
@@ -677,55 +694,67 @@
 .
 .
 .\" ====================================================================
-.SH LIMITATIONS OF GROHTML
+.SH "Limitations of \fIgrohtml\f"
 .\" ====================================================================
 .
-.LP
-.B tbl
-information is currently rendered as a PNG image.
+.MR @g@tbl @MAN1EXT@
+tables are rendered as PNG images.
+.
+Paul DuBois's approach with
+.MR tblcvt 1 ,
+part of the
+.UR http://\:www\:.snake\:.net/\:software/\:troffcvt/
+.I troffcvt
+distribution
+.UE ,
+should be explored.
 .
 .
 .\" ====================================================================
-.SH FILES
+.SH Files
 .\" ====================================================================
 .
-.I @MACRODIR@/www.tmac
+.I @MACRODIR@/\:www\:.tmac
 .
 .
 .\" ====================================================================
-.SH AUTHORS
+.SH Authors
 .\" ====================================================================
+.
 The
 .I www
 macro package
 was written by
-.MT gaius@\:glam.ac.uk
+.MT gaius@\:glam\:.ac\:.uk
 Gaius Mulley
 .ME ,
 with additions by
-.MT wl@\:gnu.org
+.MT wl@\:gnu\:.org
 Werner Lemberg
 .ME
 and
-.MT groff\-bernd.warken\-72@\:web.de
+.MT groff\-bernd\:.warken\-72@\:web\:.de
 Bernd Warken
 .ME .
 .
 .
 .\" ====================================================================
-.SH "SEE ALSO"
+.SH "See also"
 .\" ====================================================================
-.BR groff (@MAN1EXT@),
-.BR @g@troff (@MAN1EXT@),
-.BR \%grohtml (@MAN1EXT@),
-.BR netpbm (1)
+.
+.MR groff @MAN1EXT@ ,
+.MR @g@troff @MAN1EXT@ ,
+.MR grohtml @MAN1EXT@ ,
+.MR netpbm 1
 .
 .
 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
-.cp \ngroff_www_C
+.cp \n*groff_groff_www_7_man_C
+.do rr *groff_groff_www_7_man_C
 .
 .
 .\" Local Variables:
+.\" fill-column: 72
 .\" mode: nroff
 .\" End:
-.\" vim: set filetype=groff:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/html-end.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/html-end.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/html.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/html.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.cs -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.cs Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.den -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.den Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.det -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.det Changed

_service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.en Added

@@ -0,0 +1,5018 @@
+% title: Hyphenation patterns for American English
+% copyright: Copyright (C) 1990, 2004, 2005 Gerard D.C. Kuiken
+% notice: This file is part of the hyph-utf8 package.
+%     See http://www.hyphenation.org/tex for more information.
+% language:
+%     name: English, American spelling
+%     tag: en-us
+% version: 2005-05-30
+% authors:
+%   -
+%     name: Gerard D.C. Kuiken
+% licence:
+%     text: >
+%         Copying and distribution of this file, with or without modification,
+%         are permitted in any medium without royalty provided the copyright
+%         notice and this notice are preserved.
+% hyphenmins:
+%     typesetting:
+%         left: 2
+%         right: 3
+% changes:
+%     March 1, 1990 Initial release
+%     May 30, 2005 Added copyright notice, no patterns change.
+% texlive:
+%     encoding: ascii
+%     babelname: usenglishmax
+%     legacy_patterns: ushyphmax.tex
+%     message: Hyphenation patterns for American English
+%     package: english
+% known_bugs:
+%     de-mo-c-rat: 'instead of dem-o-crat (see GitHub issue #15)'
+% ==========================================
+%
+% ushyphmax.tex -- patterns for more hyphenation pattern memory (12000+).
+% Also known as ushyphen.max.
+%
+% Needs extended pattern memory.
+% Hyphenation trie becomes 7283 with 377 ops.
+%
+% These patterns are based on the Hyphenation Exception Log
+% published in TUGboat, Volume 10 (1989), No. 3, pp. 337-341,
+% and a large number of incorrectly hyphenated words not yet published.
+% If added to Liang's before the closing bracket } of \patterns,
+% the patterns run errorfree as far as known at this moment.
+%
+% These patterns find all admissible hyphens of the words in
+% the Exception Log.  ushyph2.tex is a smaller set.
+%
+% Please send bugs or suggestions to tex-live (at) tug.org.
+%
+% 2005-05-30 (karl): in the past, ushyphmax.tex was a file containing
+% only the additional patterns, without the \patterns command, etc.
+% This turned out not to be very useful, since in practice the TeX
+% distributions need one self-contained file for a language.  Therefore,
+% ushyphmax.tex now contains both the additional patterns from
+% Dr. Kuiken, and the original patterns and hyphenations from Knuth's
+% hyphen.tex.
+%
+% The Plain TeX hyphenation tables.
+\patterns{ % just type <return> if you're not using INITEX
+.ach4
+.ad4der
+.af1t
+.al3t
+.am5at
+.an5c
+.ang4
+.ani5m
+.ant4
+.an3te
+.anti5s
+.ar5s
+.ar4tie
+.ar4ty
+.as3c
+.as1p
+.as1s
+.aster5
+.atom5
+.au1d
+.av4i
+.awn4
+.ba4g
+.ba5na
+.bas4e
+.ber4
+.be5ra
+.be3sm
+.be5sto
+.bri2
+.but4ti
+.cam4pe
+.can5c
+.capa5b
+.car5ol
+.ca4t
+.ce4la
+.ch4
+.chill5i
+.ci2
+.cit5r
+.co3e
+.co4r
+.cor5ner
+.de4moi
+.de3o
+.de3ra
+.de3ri
+.des4c
+.dictio5
+.do4t
+.du4c
+.dumb5
+.earth5
+.eas3i
+.eb4
+.eer4
+.eg2
+.el5d
+.el3em
+.enam3
+.en3g
+.en3s
+.eq5ui5t
+.er4ri
+.es3
+.eu3
+.eye5
+.fes3
+.for5mer
+.ga2
+.ge2
+.gen3t4
+.ge5og
+.gi5a
+.gi4b
+.go4r
+.hand5i
+.han5k
+.he2
+.hero5i
+.hes3
+.het3
+.hi3b
+.hi3er
+.hon5ey
+.hon3o
+.hov5
+.id4l
+.idol3
+.im3m
+.im5pin
+.in1
+.in3ci
+.ine2
+.in2k
+.in3s
+.ir5r
+.is4i
+.ju3r
+.la4cy
+.la4m
+.lat5er
+.lath5
+.le2
+.leg5e
+.len4
+.lep5
+.lev1
+.li4g
+.lig5a
+.li2n
+.li3o
+.li4t
+.mag5a5
+.mal5o
+.man5a
+.mar5ti
+.me2
+.mer3c
+.me5ter
+.mis1
+.mist5i
+.mon3e
+.mo3ro
+.mu5ta
+.muta5b
+.ni4c
+.od2
+.odd5
+.of5te
+.or5ato
+.or3c
+.or1d
+.or3t
+.os3
+.os4tl
+.oth3
+.out3
+.ped5al
+.pe5te
+.pe5tit
+.pi4e
+.pio5n
+.pi2t
+.pre3m
+.ra4c
+.ran4t
+.ratio5na
+.ree2
+.re5mit
+.res2
+.re5stat
+.ri4g
+.rit5u
+.ro4q
+.ros5t
+.row5d
+.ru4d
+.sci3e
+.self5
+.sell5
+.se2n
+.se5rie
+.sh2
+.si2
+.sing4
+.st4
+.sta5bl
+.sy2
+.ta4
+.te4
+.ten5an
+.th2
+.ti2
+.til4
+.tim5o5
+.ting4
+.tin5k
+.ton4a
+.to4p
+.top5i
+.tou5s
+.trib5ut
+.un1a
+.un3ce
+.under5
+.un1e
+.un5k
+.un5o
+.un3u
+.up3
+.ure3
+.us5a
+.ven4de
+.ve5ra
+.wil5i
+.ye4
+4ab.
+a5bal
+a5ban
+abe2
+ab5erd
+abi5a
+ab5it5ab
+ab5lat
+ab5o5liz
+4abr
+ab5rog
+ab3ul
+a4car
+ac5ard
+ac5aro
+a5ceou
+ac1er
+a5chet
+4a2ci
+a3cie
+ac1in
+a3cio
+ac5rob
+act5if
+ac3ul
+ac4um
+a2d
+ad4din
+ad5er.
+2adi
+a3dia
+ad3ica
+adi4er
+a3dio
+a3dit
+a5diu
+ad4le
+ad3ow
+ad5ran
+ad4su
+4adu
+a3duc
+ad5um
+ae4r
+aeri4e
+a2f
+aff4
+a4gab
+aga4n
+ag5ell
+age4o
+4ageu
+ag1i
+4ag4l
+ag1n
+a2go
+3agog
+ag3oni
+a5guer
+ag5ul
+a4gy
+a3ha
+a3he
+ah4l
+a3ho
+ai2
+a5ia
+a3ic.
+ai5ly
+a4i4n
+ain5in
+ain5o
+ait5en
+a1j
+ak1en
+al5ab
+al3ad
+a4lar
+4aldi
+2ale
+al3end
+a4lenti
+a5le5o
+al1i
+al4ia.
+ali4e
+al5lev
+4allic
+4alm
+a5log.
+a4ly.
+4alys
+5a5lyst
+5alyt
+3alyz
+4ama
+am5ab
+am3ag
+ama5ra
+am5asc
+a4matis
+a4m5ato
+am5era
+am3ic
+am5if
+am5ily
+am1in
+ami4no
+a2mo
+a5mon
+amor5i
+amp5en
+a2n
+an3age
+3analy
+a3nar
+an3arc
+anar4i
+a3nati
+4and
+ande4s
+an3dis
+an1dl
+an4dow
+a5nee
+a3nen
+an5est.
+a3neu
+2ang
+ang5ie
+an1gl
+a4n1ic
+a3nies
+an3i3f
+an4ime
+a5nimi
+a5nine
+an3io
+a3nip
+an3ish
+an3it
+a3niu
+an4kli
+5anniz
+ano4
+an5ot
+anoth5
+an2sa
+an4sco
+an4sn
+an2sp
+ans3po
+an4st
+an4sur
+antal4
+an4tie
+4anto
+an2tr
+an4tw
+an3ua
+an3ul
+a5nur
+4ao
+apar4
+ap5at
+ap5ero
+a3pher
+4aphi
+a4pilla
+ap5illar
+ap3in
+ap3ita
+a3pitu
+a2pl
+apoc5
+ap5ola
+apor5i
+apos3t
+aps5es
+a3pu
+aque5
+2a2r
+ar3act
+a5rade
+ar5adis
+ar3al
+a5ramete
+aran4g
+ara3p
+ar4at
+a5ratio
+ar5ativ
+a5rau
+ar5av4
+araw4
+arbal4
+ar4chan
+ar5dine
+ar4dr
+ar5eas
+a3ree
+ar3ent
+a5ress
+ar4fi
+ar4fl
+ar1i
+ar5ial
+ar3ian
+a3riet
+ar4im
+ar5inat
+ar3io
+ar2iz
+ar2mi
+ar5o5d
+a5roni
+a3roo
+ar2p
+ar3q
+arre4
+ar4sa
+ar2sh
+4as.
+as4ab
+as3ant
+ashi4
+a5sia.
+a3sib
+a3sic
+5a5si4t
+ask3i
+as4l
+a4soc
+as5ph
+as4sh
+as3ten
+as1tr
+asur5a
+a2ta
+at3abl
+at5ac
+at3alo
+at5ap
+ate5c
+at5ech
+at3ego
+at3en.
+at3era
+ater5n
+a5terna
+at3est
+at5ev
+4ath
+ath5em
+a5then
+at4ho
+ath5om
+4ati.
+a5tia
+at5i5b
+at1ic
+at3if
+ation5ar
+at3itu
+a4tog
+a2tom
+at5omiz
+a4top
+a4tos
+a1tr
+at5rop
+at4sk
+at4tag
+at5te
+at4th
+a2tu
+at5ua
+at5ue
+at3ul
+at3ura
+a2ty
+au4b
+augh3
+au3gu
+au4l2
+aun5d
+au3r
+au5sib
+aut5en
+au1th
+a2va
+av3ag
+a5van
+ave4no
+av3era
+av5ern
+av5ery
+av1i
+avi4er
+av3ig
+av5oc
+a1vor
+3away
+aw3i
+aw4ly
+aws4
+ax4ic
+ax4id
+ay5al
+aye4
+ays4
+azi4er
+azz5i
+5ba.
+bad5ger
+ba4ge
+bal1a
+ban5dag
+ban4e
+ban3i
+barbi5
+bari4a
+bas4si
+1bat
+ba4z
+2b1b
+b2be
+b3ber
+bbi4na
+4b1d
+4be.
+beak4
+beat3
+4be2d
+be3da
+be3de
+be3di
+be3gi
+be5gu
+1bel
+be1li
+be3lo
+4be5m
+be5nig
+be5nu
+4bes4
+be3sp
+be5str
+3bet
+bet5iz
+be5tr
+be3tw
+be3w
+be5yo
+2bf
+4b3h
+bi2b
+bi4d
+3bie
+bi5en
+bi4er
+2b3if
+1bil
+bi3liz
+bina5r4
+bin4d
+bi5net
+bi3ogr
+bi5ou
+bi2t
+3bi3tio
+bi3tr
+3bit5ua
+b5itz
+b1j
+bk4
+b2l2
+blath5
+b4le.
+blen4
+5blesp
+b3lis
+b4lo
+blun4t
+4b1m
+4b3n
+bne5g
+3bod
+bod3i
+bo4e
+bol3ic
+bom4bi
+bon4a
+bon5at
+3boo
+5bor.
+4b1ora
+bor5d
+5bore
+5bori
+5bos4
+b5ota
+both5
+bo4to
+bound3
+4bp
+4brit
+broth3
+2b5s2
+bsor4
+2bt
+bt4l
+b4to
+b3tr
+buf4fer
+bu4ga
+bu3li
+bumi4
+bu4n
+bunt4i
+bu3re
+bus5ie
+buss4e
+5bust
+4buta
+3butio
+b5uto
+b1v
+4b5w
+5by.
+bys4
+1ca
+cab3in
+ca1bl
+cach4
+ca5den
+4cag4
+2c5ah
+ca3lat
+cal4la
+call5in
+4calo
+can5d
+can4e
+can4ic
+can5is
+can3iz
+can4ty
+cany4
+ca5per
+car5om
+cast5er
+cas5tig
+4casy
+ca4th
+4cativ
+cav5al
+c3c
+ccha5
+cci4a
+ccompa5
+ccon4
+ccou3t
+2ce.
+4ced.
+4ceden
+3cei
+5cel.
+3cell
+1cen
+3cenc
+2cen4e
+4ceni
+3cent
+3cep
+ce5ram
+4cesa
+3cessi
+ces5si5b
+ces5t
+cet4
+c5e4ta
+cew4
+2ch
+4ch.
+4ch3ab
+5chanic
+ch5a5nis
+che2
+cheap3
+4ched
+che5lo
+3chemi
+ch5ene
+ch3er.
+ch3ers
+4ch1in
+5chine.
+ch5iness
+5chini
+5chio
+3chit
+chi2z
+3cho2
+ch4ti
+1ci
+3cia
+ci2a5b
+cia5r
+ci5c
+4cier
+5cific.
+4cii
+ci4la
+3cili
+2cim
+2cin
+c4ina
+3cinat
+cin3em
+c1ing
+c5ing.
+5cino
+cion4
+4cipe
+ci3ph
+4cipic
+4cista
+4cisti
+2c1it
+cit3iz
+5ciz
+ck1
+ck3i
+1c4l4
+4clar
+c5laratio
+5clare
+cle4m
+4clic
+clim4
+cly4
+c5n
+1co
+co5ag
+coe2
+2cog
+co4gr
+coi4
+co3inc
+col5i
+5colo
+col3or
+com5er
+con4a
+c4one
+con3g
+con5t
+co3pa
+cop3ic
+co4pl
+4corb
+coro3n
+cos4e
+cov1
+cove4
+cow5a
+coz5e
+co5zi
+c1q
+cras5t
+5crat.
+5cratic
+cre3at
+5cred
+4c3reta
+cre4v
+cri2
+cri5f
+c4rin
+cris4
+5criti
+cro4pl
+crop5o
+cros4e
+cru4d
+4c3s2
+2c1t
+cta4b
+ct5ang
+c5tant
+c2te
+c3ter
+c4ticu
+ctim3i
+ctu4r
+c4tw
+cud5
+c4uf
+c4ui
+cu5ity
+5culi
+cul4tis
+3cultu
+cu2ma
+c3ume
+cu4mi
+3cun
+cu3pi
+cu5py
+cur5a4b
+cu5ria
+1cus
+cuss4i
+3c4ut
+cu4tie
+4c5utiv
+4cutr
+1cy
+cze4
+1d2a
+5da.
+2d3a4b
+dach4
+4daf
+2dag
+da2m2
+dan3g
+dard5
+dark5
+4dary
+3dat
+4dativ
+4dato
+5dav4
+dav5e
+5day
+d1b
+d5c
+d1d4
+2de.
+deaf5
+deb5it
+de4bon
+decan4
+de4cil
+de5com
+2d1ed
+4dee.
+de5if
+deli4e
+del5i5q
+de5lo
+d4em
+5dem.
+3demic
+dem5ic.
+de5mil
+de4mons
+demor5
+1den
+de4nar
+de3no
+denti5f
+de3nu
+de1p
+de3pa
+depi4
+de2pu
+d3eq
+d4erh
+5derm
+dern5iz
+der5s
+des2
+d2es.
+de1sc
+de2s5o
+des3ti
+de3str
+de4su
+de1t
+de2to
+de1v
+dev3il
+4dey
+4d1f
+d4ga
+d3ge4t
+dg1i
+d2gy
+d1h2
+5di.
+1d4i3a
+dia5b
+di4cam
+d4ice
+3dict
+3did
+5di3en
+d1if
+di3ge
+di4lato
+d1in
+1dina
+3dine.
+5dini
+di5niz
+1dio
+dio5g
+di4pl
+dir2
+di1re
+dirt5i
+dis1
+5disi
+d4is3t
+d2iti
+1di1v
+d1j
+d5k2
+4d5la
+3dle.
+3dled
+3dles.
+4dless
+2d3lo
+4d5lu
+2dly
+d1m
+4d1n4
+1do
+3do.
+do5de
+5doe
+2d5of
+d4og
+do4la
+doli4
+do5lor
+dom5iz
+do3nat
+doni4
+doo3d
+dop4p
+d4or
+3dos
+4d5out
+do4v
+3dox
+d1p
+1dr
+drag5on
+4drai
+dre4
+drea5r
+5dren
+dri4b
+dril4
+dro4p
+4drow
+5drupli
+4dry
+2d1s2
+ds4p
+d4sw
+d4sy
+d2th
+1du
+d1u1a
+du2c
+d1uca
+duc5er
+4duct.
+4ducts
+du5el
+du4g
+d3ule
+dum4be
+du4n
+4dup
+du4pe
+d1v
+d1w
+d2y
+5dyn
+dy4se
+dys5p
+e1a4b
+e3act
+ead1
+ead5ie
+ea4ge
+ea5ger
+ea4l
+eal5er
+eal3ou
+eam3er
+e5and
+ear3a
+ear4c
+ear5es
+ear4ic
+ear4il
+ear5k
+ear2t
+eart3e
+ea5sp
+e3ass
+east3
+ea2t
+eat5en
+eath3i
+e5atif
+e4a3tu
+ea2v
+eav3en
+eav5i
+eav5o
+2e1b
+e4bel.
+e4bels
+e4ben
+e4bit
+e3br
+e4cad
+ecan5c
+ecca5
+e1ce
+ec5essa
+ec2i
+e4cib
+ec5ificat
+ec5ifie
+ec5ify
+ec3im
+eci4t
+e5cite
+e4clam
+e4clus
+e2col
+e4comm
+e4compe
+e4conc
+e2cor
+ec3ora
+eco5ro
+e1cr
+e4crem
+ec4tan
+ec4te
+e1cu
+e4cul
+ec3ula
+2e2da
+4ed3d
+e4d1er
+ede4s
+4edi
+e3dia
+ed3ib
+ed3ica
+ed3im
+ed1it
+edi5z
+4edo
+e4dol
+edon2
+e4dri
+e4dul
+ed5ulo
+ee2c
+eed3i
+ee2f
+eel3i
+ee4ly
+ee2m
+ee4na
+ee4p1
+ee2s4
+eest4
+ee4ty
+e5ex
+e1f
+e4f3ere
+1eff
+e4fic
+5efici
+efil4
+e3fine
+ef5i5nite
+3efit
+efor5es
+e4fuse.
+4egal
+eger4
+eg5ib
+eg4ic
+eg5ing
+e5git5
+eg5n
+e4go.
+e4gos
+eg1ul
+e5gur
+5egy
+e1h4
+eher4
+ei2
+e5ic
+ei5d
+eig2
+ei5gl
+e3imb
+e3inf
+e1ing
+e5inst
+eir4d
+eit3e
+ei3th
+e5ity
+e1j
+e4jud
+ej5udi
+eki4n
+ek4la
+e1la
+e4la.
+e4lac
+elan4d
+el5ativ
+e4law
+elaxa4
+e3lea
+el5ebra
+5elec
+e4led
+el3ega
+e5len
+e4l1er
+e1les
+el2f
+el2i
+e3libe
+e4l5ic.
+el3ica
+e3lier
+el5igib
+e5lim
+e4l3ing
+e3lio
+e2lis
+el5ish
+e3liv3
+4ella
+el4lab
+ello4
+e5loc
+el5og
+el3op.
+el2sh
+el4ta
+e5lud
+el5ug
+e4mac
+e4mag
+e5man
+em5ana
+em5b
+e1me
+e2mel
+e4met
+em3ica
+emi4e
+em5igra
+em1in2
+em5ine
+em3i3ni
+e4mis
+em5ish
+e5miss
+em3iz
+5emniz
+emo4g
+emoni5o
+em3pi
+e4mul
+em5ula
+emu3n
+e3my
+en5amo
+e4nant
+ench4er
+en3dic
+e5nea
+e5nee
+en3em
+en5ero
+en5esi
+en5est
+en3etr
+e3new
+en5ics
+e5nie
+e5nil
+e3nio
+en3ish
+en3it
+e5niu
+5eniz
+4enn
+4eno
+eno4g
+e4nos
+en3ov
+en4sw
+ent5age
+4enthes
+en3ua
+en5uf
+e3ny.
+4en3z
+e5of
+eo2g
+e4oi4
+e3ol
+eop3ar
+e1or
+eo3re
+eo5rol
+eos4
+e4ot
+eo4to
+e5out
+e5ow
+e2pa
+e3pai
+ep5anc
+e5pel
+e3pent
+ep5etitio
+ephe4
+e4pli
+e1po
+e4prec
+ep5reca
+e4pred
+ep3reh
+e3pro
+e4prob
+ep4sh
+ep5ti5b
+e4put
+ep5uta
+e1q
+equi3l
+e4q3ui3s
+er1a
+era4b
+4erand
+er3ar
+4erati.
+2erb
+er4bl
+er3ch
+er4che
+2ere.
+e3real
+ere5co
+ere3in
+er5el.
+er3emo
+er5ena
+er5ence
+4erene
+er3ent
+ere4q
+er5ess
+er3est
+eret4
+er1h
+er1i
+e1ria4
+5erick
+e3rien
+eri4er
+er3ine
+e1rio
+4erit
+er4iu
+eri4v
+e4riva
+er3m4
+er4nis
+4ernit
+5erniz
+er3no
+2ero
+er5ob
+e5roc
+ero4r
+er1ou
+er1s
+er3set
+ert3er
+4ertl
+er3tw
+4eru
+eru4t
+5erwau
+e1s4a
+e4sage.
+e4sages
+es2c
+e2sca
+es5can
+e3scr
+es5cu
+e1s2e
+e2sec
+es5ecr
+es5enc
+e4sert.
+e4serts
+e4serva
+4esh
+e3sha
+esh5en
+e1si
+e2sic
+e2sid
+es5iden
+es5igna
+e2s5im
+es4i4n
+esis4te
+esi4u
+e5skin
+es4mi
+e2sol
+es3olu
+e2son
+es5ona
+e1sp
+es3per
+es5pira
+es4pre
+2ess
+es4si4b
+estan4
+es3tig
+es5tim
+4es2to
+e3ston
+2estr
+e5stro
+estruc5
+e2sur
+es5urr
+es4w
+eta4b
+eten4d
+e3teo
+ethod3
+et1ic
+e5tide
+etin4
+eti4no
+e5tir
+e5titio
+et5itiv
+4etn
+et5ona
+e3tra
+e3tre
+et3ric
+et5rif
+et3rog
+et5ros
+et3ua
+et5ym
+et5z
+4eu
+e5un
+e3up
+eu3ro
+eus4
+eute4
+euti5l
+eu5tr
+eva2p5
+e2vas
+ev5ast
+e5vea
+ev3ell
+evel3o
+e5veng
+even4i
+ev1er
+e5verb
+e1vi
+ev3id
+evi4l
+e4vin
+evi4v
+e5voc
+e5vu
+e1wa
+e4wag
+e5wee
+e3wh
+ewil5
+ew3ing
+e3wit
+1exp
+5eyc
+5eye.
+eys4
+1fa
+fa3bl
+fab3r
+fa4ce
+4fag
+fain4
+fall5e
+4fa4ma
+fam5is
+5far
+far5th
+fa3ta
+fa3the
+4fato
+fault5
+4f5b
+4fd
+4fe.
+feas4
+feath3
+fe4b
+4feca
+5fect
+2fed
+fe3li
+fe4mo
+fen2d
+fend5e
+fer1
+5ferr
+fev4
+4f1f
+f4fes
+f4fie
+f5fin.
+f2f5is
+f4fly
+f2fy
+4fh
+1fi
+fi3a
+2f3ic.
+4f3ical
+f3ican
+4ficate
+f3icen
+fi3cer
+fic4i
+5ficia
+5ficie
+4fics
+fi3cu
+fi5del
+fight5
+fil5i
+fill5in
+4fily
+2fin
+5fina
+fin2d5
+fi2ne
+f1in3g
+fin4n
+fis4ti
+f4l2
+f5less
+flin4
+flo3re
+f2ly5
+4fm
+4fn
+1fo
+5fon
+fon4de
+fon4t
+fo2r
+fo5rat
+for5ay
+fore5t
+for4i
+fort5a
+fos5
+4f5p
+fra4t
+f5rea
+fres5c
+fri2
+fril4
+frol5
+2f3s
+2ft
+f4to
+f2ty
+3fu
+fu5el
+4fug
+fu4min
+fu5ne
+fu3ri
+fusi4
+fus4s
+4futa
+1fy
+1ga
+gaf4
+5gal.
+3gali
+ga3lo
+2gam
+ga5met
+g5amo
+gan5is
+ga3niz
+gani5za
+4gano
+gar5n4
+gass4
+gath3
+4gativ
+4gaz
+g3b
+gd4
+2ge.
+2ged
+geez4
+gel4in
+ge5lis
+ge5liz
+4gely
+1gen
+ge4nat
+ge5niz
+4geno
+4geny
+1geo
+ge3om
+g4ery
+5gesi
+geth5
+4geto
+ge4ty
+ge4v
+4g1g2
+g2ge
+g3ger
+gglu5
+ggo4
+gh3in
+gh5out
+gh4to
+5gi.
+1gi4a
+gia5r
+g1ic
+5gicia
+g4ico
+gien5
+5gies.
+gil4
+g3imen
+3g4in.
+gin5ge
+5g4ins
+5gio
+3gir
+gir4l
+g3isl
+gi4u
+5giv
+3giz
+gl2
+gla4
+glad5i
+5glas
+1gle
+gli4b
+g3lig
+3glo
+glo3r
+g1m
+g4my
+gn4a
+g4na.
+gnet4t
+g1ni
+g2nin
+g4nio
+g1no
+g4non
+1go
+3go.
+gob5
+5goe
+3g4o4g
+go3is
+gon2
+4g3o3na
+gondo5
+go3ni
+5goo
+go5riz
+gor5ou
+5gos.
+gov1
+g3p
+1gr
+4grada
+g4rai
+gran2
+5graph.
+g5rapher
+5graphic
+4graphy
+4gray
+gre4n
+4gress.
+4grit
+g4ro
+gruf4
+gs2
+g5ste
+gth3
+gu4a
+3guard
+2gue
+5gui5t
+3gun
+3gus
+4gu4t
+g3w
+1gy
+2g5y3n
+gy5ra
+h3ab4l
+hach4
+hae4m
+hae4t
+h5agu
+ha3la
+hala3m
+ha4m
+han4ci
+han4cy
+5hand.
+han4g
+hang5er
+hang5o
+h5a5niz
+han4k
+han4te
+hap3l
+hap5t
+ha3ran
+ha5ras
+har2d
+hard3e
+har4le
+harp5en
+har5ter
+has5s
+haun4
+5haz
+haz3a
+h1b
+1head
+3hear
+he4can
+h5ecat
+h4ed
+he5do5
+he3l4i
+hel4lis
+hel4ly
+h5elo
+hem4p
+he2n
+hena4
+hen5at
+heo5r
+hep5
+h4era
+hera3p
+her4ba
+here5a
+h3ern
+h5erou
+h3ery
+h1es
+he2s5p
+he4t
+het4ed
+heu4
+h1f
+h1h
+hi5an
+hi4co
+high5
+h4il2
+himer4
+h4ina
+hion4e
+hi4p
+hir4l
+hi3ro
+hir4p
+hir4r
+his3el
+his4s
+hith5er
+hi2v
+4hk
+4h1l4
+hlan4
+h2lo
+hlo3ri
+4h1m
+hmet4
+2h1n
+h5odiz
+h5ods
+ho4g
+hoge4
+hol5ar
+3hol4e
+ho4ma
+home3
+hon4a
+ho5ny
+3hood
+hoon4
+hor5at
+ho5ris
+hort3e
+ho5ru
+hos4e
+ho5sen
+hos1p
+1hous
+house3
+hov5el
+4h5p
+4hr4
+hree5
+hro5niz
+hro3po
+4h1s2
+h4sh
+h4tar
+ht1en
+ht5es
+h4ty
+hu4g
+hu4min
+hun5ke
+hun4t
+hus3t4
+hu4t
+h1w
+h4wart
+hy3pe
+hy3ph
+hy2s
+2i1a
+i2al
+iam4
+iam5ete
+i2an
+4ianc
+ian3i
+4ian4t
+ia5pe
+iass4
+i4ativ
+ia4tric
+i4atu
+ibe4
+ib3era
+ib5ert
+ib5ia
+ib3in
+ib5it.
+ib5ite
+i1bl
+ib3li
+i5bo
+i1br
+i2b5ri
+i5bun
+4icam
+5icap
+4icar
+i4car.
+i4cara
+icas5
+i4cay
+iccu4
+4iceo
+4ich
+2ici
+i5cid
+ic5ina
+i2cip
+ic3ipa
+i4cly
+i2c5oc
+4i1cr
+5icra
+i4cry
+ic4te
+ictu2
+ic4t3ua
+ic3ula
+ic4um
+ic5uo
+i3cur
+2id
+i4dai
+id5anc
+id5d
+ide3al
+ide4s
+i2di
+id5ian
+idi4ar
+i5die
+id3io
+idi5ou
+id1it
+id5iu
+i3dle
+i4dom
+id3ow
+i4dr
+i2du
+id5uo
+2ie4
+ied4e
+5ie5ga
+ield3
+ien5a4
+ien4e
+i5enn
+i3enti
+i1er.
+i3esc
+i1est
+i3et
+4if.
+if5ero
+iff5en
+if4fr
+4ific.
+i3fie
+i3fl
+4ift
+2ig
+iga5b
+ig3era
+ight3i
+4igi
+i3gib
+ig3il
+ig3in
+ig3it
+i4g4l
+i2go
+ig3or
+ig5ot
+i5gre
+igu5i
+ig1ur
+i3h
+4i5i4
+i3j
+4ik
+i1la
+il3a4b
+i4lade
+i2l5am
+ila5ra
+i3leg
+il1er
+ilev4
+il5f
+il1i
+il3ia
+il2ib
+il3io
+il4ist
+2ilit
+il2iz
+ill5ab
+4iln
+il3oq
+il4ty
+il5ur
+il3v
+i4mag
+im3age
+ima5ry
+imenta5r
+4imet
+im1i
+im5ida
+imi5le
+i5mini
+4imit
+im4ni
+i3mon
+i2mu
+im3ula
+2in.
+i4n3au
+4inav
+incel4
+in3cer
+4ind
+in5dling
+2ine
+i3nee
+iner4ar
+i5ness
+4inga
+4inge
+in5gen
+4ingi
+in5gling
+4ingo
+4ingu
+2ini
+i5ni.
+i4nia
+in3io
+in1is
+i5nite.
+5initio
+in3ity
+4ink
+4inl
+2inn
+2i1no
+i4no4c
+ino4s
+i4not
+2ins
+in3se
+insur5a
+2int.
+2in4th
+in1u
+i5nus
+4iny
+2io
+4io.
+ioge4
+io2gr
+i1ol
+io4m
+ion3at
+ion4ery
+ion3i
+io5ph
+ior3i
+i4os
+io5th
+i5oti
+io4to
+i4our
+2ip
+ipe4
+iphras4
+ip3i
+ip4ic
+ip4re4
+ip3ul
+i3qua
+iq5uef
+iq3uid
+iq3ui3t
+4ir
+i1ra
+ira4b
+i4rac
+ird5e
+ire4de
+i4ref
+i4rel4
+i4res
+ir5gi
+ir1i
+iri5de
+ir4is
+iri3tu
+5i5r2iz
+ir4min
+iro4g
+5iron.
+ir5ul
+2is.
+is5ag
+is3ar
+isas5
+2is1c
+is3ch
+4ise
+is3er
+3isf
+is5han
+is3hon
+ish5op
+is3ib
+isi4d
+i5sis
+is5itiv
+4is4k
+islan4
+4isms
+i2so
+iso5mer
+is1p
+is2pi
+is4py
+4is1s
+is4sal
+issen4
+is4ses
+is4ta.
+is1te
+is1ti
+ist4ly
+4istral
+i2su
+is5us
+4ita.
+ita4bi
+i4tag
+4ita5m
+i3tan
+i3tat
+2ite
+it3era
+i5teri
+it4es
+2ith
+i1ti
+4itia
+4i2tic
+it3ica
+5i5tick
+it3ig
+it5ill
+i2tim
+2itio
+4itis
+i4tism
+i2t5o5m
+4iton
+i4tram
+it5ry
+4itt
+it3uat
+i5tud
+it3ul
+4itz.
+i1u
+2iv
+iv3ell
+iv3en.
+i4v3er.
+i4vers.
+iv5il.
+iv5io
+iv1it
+i5vore
+iv3o3ro
+i4v3ot
+4i5w
+ix4o
+4iy
+4izar
+izi4
+5izont
+5ja
+jac4q
+ja4p
+1je
+jer5s
+4jestie
+4jesty
+jew3
+jo4p
+5judg
+3ka.
+k3ab
+k5ag
+kais4
+kal4
+k1b
+k2ed
+1kee
+ke4g
+ke5li
+k3en4d
+k1er
+kes4
+k3est.
+ke4ty
+k3f
+kh4
+k1i
+5ki.
+5k2ic
+k4ill
+kilo5
+k4im
+k4in.
+kin4de
+k5iness
+kin4g
+ki4p
+kis4
+k5ish
+kk4
+k1l
+4kley
+4kly
+k1m
+k5nes
+1k2no
+ko5r
+kosh4
+k3ou
+kro5n
+4k1s2
+k4sc
+ks4l
+k4sy
+k5t
+k1w
+lab3ic
+l4abo
+laci4
+l4ade
+la3dy
+lag4n
+lam3o
+3land
+lan4dl
+lan5et
+lan4te
+lar4g
+lar3i
+las4e
+la5tan
+4lateli
+4lativ
+4lav
+la4v4a
+2l1b
+lbin4
+4l1c2
+lce4
+l3ci
+2ld
+l2de
+ld4ere
+ld4eri
+ldi4
+ld5is
+l3dr
+l4dri
+le2a
+le4bi
+left5
+5leg.
+5legg
+le4mat
+lem5atic
+4len.
+3lenc
+5lene.
+1lent
+le3ph
+le4pr
+lera5b
+ler4e
+3lerg
+3l4eri
+l4ero
+les2
+le5sco
+5lesq
+3less
+5less.
+l3eva
+lev4er.
+lev4era
+lev4ers
+3ley
+4leye
+2lf
+l5fr
+4l1g4
+l5ga
+lgar3
+l4ges
+lgo3
+2l3h
+li4ag
+li2am
+liar5iz
+li4as
+li4ato
+li5bi
+5licio
+li4cor
+4lics
+4lict.
+l4icu
+l3icy
+l3ida
+lid5er
+3lidi
+lif3er
+l4iff
+li4fl
+5ligate
+3ligh
+li4gra
+3lik
+4l4i4l
+lim4bl
+lim3i
+li4mo
+l4im4p
+l4ina
+1l4ine
+lin3ea
+lin3i
+link5er
+li5og
+4l4iq
+lis4p
+l1it
+l2it.
+5litica
+l5i5tics
+liv3er
+l1iz
+4lj
+lka3
+l3kal
+lka4t
+l1l
+l4law
+l2le
+l5lea
+l3lec
+l3leg
+l3lel
+l3le4n
+l3le4t
+ll2i
+l2lin4
+l5lina
+ll4o
+lloqui5
+ll5out
+l5low
+2lm
+l5met
+lm3ing
+l4mod
+lmon4
+2l1n2
+3lo.
+lob5al
+lo4ci
+4lof
+3logic
+l5ogo
+3logu
+lom3er
+5long
+lon4i
+l3o3niz
+lood5
+5lope.
+lop3i
+l3opm
+lora4
+lo4rato
+lo5rie
+lor5ou
+5los.
+los5et
+5losophiz
+5losophy
+los4t
+lo4ta
+loun5d
+2lout
+4lov
+2lp
+lpa5b
+l3pha
+l5phi
+lp5ing
+l3pit
+l4pl
+l5pr
+4l1r
+2l1s2
+l4sc
+l2se
+l4sie
+4lt
+lt5ag
+ltane5
+l1te
+lten4
+ltera4
+lth3i
+l5ties.
+ltis4
+l1tr
+ltu2
+ltur3a
+lu5a
+lu3br
+luch4
+lu3ci
+lu3en
+luf4
+lu5id
+lu4ma
+5lumi
+l5umn.
+5lumnia
+lu3o
+luo3r
+4lup
+luss4
+lus3te
+1lut
+l5ven
+l5vet4
+2l1w
+1ly
+4lya
+4lyb
+ly5me
+ly3no
+2lys4
+l5yse
+1ma
+2mab
+ma2ca
+ma5chine
+ma4cl
+mag5in
+5magn
+2mah
+maid5
+4mald
+ma3lig
+ma5lin
+mal4li
+mal4ty
+5mania
+man5is
+man3iz
+4map
+ma5rine.
+ma5riz
+mar4ly
+mar3v
+ma5sce
+mas4e
+mas1t
+5mate
+math3
+ma3tis
+4matiza
+4m1b
+mba4t5
+m5bil
+m4b3ing
+mbi4v
+4m5c
+4me.
+2med
+4med.
+5media
+me3die
+m5e5dy
+me2g
+mel5on
+mel4t
+me2m
+mem1o3
+1men
+men4a
+men5ac
+men4de
+4mene
+men4i
+mens4
+mensu5
+3ment
+men4te
+me5on
+m5ersa
+2mes
+3mesti
+me4ta
+met3al
+me1te
+me5thi
+m4etr
+5metric
+me5trie
+me3try
+me4v
+4m1f
+2mh
+5mi.
+mi3a
+mid4a
+mid4g
+mig4
+3milia
+m5i5lie
+m4ill
+min4a
+3mind
+m5inee
+m4ingl
+min5gli
+m5ingly
+min4t
+m4inu
+miot4
+m2is
+mis4er.
+mis5l
+mis4ti
+m5istry
+4mith
+m2iz
+4mk
+4m1l
+m1m
+mma5ry
+4m1n
+mn4a
+m4nin
+mn4o
+1mo
+4mocr
+5mocratiz
+mo2d1
+mo4go
+mois2
+moi5se
+4mok
+mo5lest
+mo3me
+mon5et
+mon5ge
+moni3a
+mon4ism
+mon4ist
+mo3niz
+monol4
+mo3ny.
+mo2r
+4mora.
+mos2
+mo5sey
+mo3sp
+moth3
+m5ouf
+3mous
+mo2v
+4m1p
+mpara5
+mpa5rab
+mpar5i
+m3pet
+mphas4
+m2pi
+mpi4a
+mp5ies
+m4p1in
+m5pir
+mp5is
+mpo3ri
+mpos5ite
+m4pous
+mpov5
+mp4tr
+m2py
+4m3r
+4m1s2
+m4sh
+m5si
+4mt
+1mu
+mula5r4
+5mult
+multi3
+3mum
+mun2
+4mup
+mu4u
+4mw
+1na
+2n1a2b
+n4abu
+4nac.
+na4ca
+n5act
+nag5er.
+nak4
+na4li
+na5lia
+4nalt
+na5mit
+n2an
+nanci4
+nan4it
+nank4
+nar3c
+4nare
+nar3i
+nar4l
+n5arm
+n4as
+nas4c
+nas5ti
+n2at
+na3tal
+nato5miz
+n2au
+nau3se
+3naut
+nav4e
+4n1b4
+ncar5
+n4ces.
+n3cha
+n5cheo
+n5chil
+n3chis
+nc1in
+nc4it
+ncour5a
+n1cr
+n1cu
+n4dai
+n5dan
+n1de
+nd5est.
+ndi4b
+n5d2if
+n1dit
+n3diz
+n5duc
+ndu4r
+nd2we
+2ne.
+n3ear
+ne2b
+neb3u
+ne2c
+5neck
+2ned
+ne4gat
+neg5ativ
+5nege
+ne4la
+nel5iz
+ne5mi
+ne4mo
+1nen
+4nene
+3neo
+ne4po
+ne2q
+n1er
+nera5b
+n4erar
+n2ere
+n4er5i
+ner4r
+1nes
+2nes.
+4nesp
+2nest
+4nesw
+3netic
+ne4v
+n5eve
+ne4w
+n3f
+n4gab
+n3gel
+nge4n4e
+n5gere
+n3geri
+ng5ha
+n3gib
+ng1in
+n5git
+n4gla
+ngov4
+ng5sh
+n1gu
+n4gum
+n2gy
+4n1h4
+nha4
+nhab3
+nhe4
+3n4ia
+ni3an
+ni4ap
+ni3ba
+ni4bl
+ni4d
+ni5di
+ni4er
+ni2fi
+ni5ficat
+n5igr
+nik4
+n1im
+ni3miz
+n1in
+5nine.
+nin4g
+ni4o
+5nis.
+nis4ta
+n2it
+n4ith
+3nitio
+n3itor
+ni3tr
+n1j
+4nk2
+n5kero
+n3ket
+nk3in
+n1kl
+4n1l
+n5m
+nme4
+nmet4
+4n1n2
+nne4
+nni3al
+nni4v
+nob4l
+no3ble
+n5ocl
+4n3o2d
+3noe
+4nog
+noge4
+nois5i
+no5l4i
+5nologis
+3nomic
+n5o5miz
+no4mo
+no3my
+no4n
+non4ag
+non5i
+n5oniz
+4nop
+5nop5o5li
+nor5ab
+no4rary
+4nosc
+nos4e
+nos5t
+no5ta
+1nou
+3noun
+nov3el3
+nowl3
+n1p4
+npi4
+npre4c
+n1q
+n1r
+nru4
+2n1s2
+ns5ab
+nsati4
+ns4c
+n2se
+n4s3es
+nsid1
+nsig4
+n2sl
+ns3m
+n4soc
+ns4pe
+n5spi
+nsta5bl
+n1t
+nta4b
+nter3s
+nt2i
+n5tib
+nti4er
+nti2f
+n3tine
+n4t3ing
+nti4p
+ntrol5li
+nt4s
+ntu3me
+nu1a
+nu4d
+nu5en
+nuf4fe
+n3uin
+3nu3it
+n4um
+nu1me
+n5umi
+3nu4n
+n3uo
+nu3tr
+n1v2
+n1w4
+nym4
+nyp4
+4nz
+n3za
+4oa
+oad3
+o5a5les
+oard3
+oas4e
+oast5e
+oat5i
+ob3a3b
+o5bar
+obe4l
+o1bi
+o2bin
+ob5ing
+o3br
+ob3ul
+o1ce
+och4
+o3chet
+ocif3
+o4cil
+o4clam
+o4cod
+oc3rac
+oc5ratiz
+ocre3
+5ocrit
+octor5a
+oc3ula
+o5cure
+od5ded
+od3ic
+odi3o
+o2do4
+odor3
+od5uct.
+od5ucts
+o4el
+o5eng
+o3er
+oe4ta
+o3ev
+o2fi
+of5ite
+ofit4t
+o2g5a5r
+og5ativ
+o4gato
+o1ge
+o5gene
+o5geo
+o4ger
+o3gie
+1o1gis
+og3it
+o4gl
+o5g2ly
+3ogniz
+o4gro
+ogu5i
+1ogy
+2ogyn
+o1h2
+ohab5
+oi2
+oic3es
+oi3der
+oiff4
+oig4
+oi5let
+o3ing
+oint5er
+o5ism
+oi5son
+oist5en
+oi3ter
+o5j
+2ok
+o3ken
+ok5ie
+o1la
+o4lan
+olass4
+ol2d
+old1e
+ol3er
+o3lesc
+o3let
+ol4fi
+ol2i
+o3lia
+o3lice
+ol5id.
+o3li4f
+o5lil
+ol3ing
+o5lio
+o5lis.
+ol3ish
+o5lite
+o5litio
+o5liv
+olli4e
+ol5ogiz
+olo4r
+ol5pl
+ol2t
+ol3ub
+ol3ume
+ol3un
+o5lus
+ol2v
+o2ly
+om5ah
+oma5l
+om5atiz
+om2be
+om4bl
+o2me
+om3ena
+om5erse
+o4met
+om5etry
+o3mia
+om3ic.
+om3ica
+o5mid
+om1in
+o5mini
+5ommend
+omo4ge
+o4mon
+om3pi
+ompro5
+o2n
+on1a
+on4ac
+o3nan
+on1c
+3oncil
+2ond
+on5do
+o3nen
+on5est
+on4gu
+on1ic
+o3nio
+on1is
+o5niu
+on3key
+on4odi
+on3omy
+on3s
+onspi4
+onspir5a
+onsu4
+onten4
+on3t4i
+ontif5
+on5um
+onva5
+oo2
+ood5e
+ood5i
+oo4k
+oop3i
+o3ord
+oost5
+o2pa
+ope5d
+op1er
+3opera
+4operag
+2oph
+o5phan
+o5pher
+op3ing
+o3pit
+o5pon
+o4posi
+o1pr
+op1u
+opy5
+o1q
+o1ra
+o5ra.
+o4r3ag
+or5aliz
+or5ange
+ore5a
+o5real
+or3ei
+ore5sh
+or5est.
+orew4
+or4gu
+4o5ria
+or3ica
+o5ril
+or1in
+o1rio
+or3ity
+o3riu
+or2mi
+orn2e
+o5rof
+or3oug
+or5pe
+3orrh
+or4se
+ors5en
+orst4
+or3thi
+or3thy
+or4ty
+o5rum
+o1ry
+os3al
+os2c
+os4ce
+o3scop
+4oscopi
+o5scr
+os4i4e
+os5itiv
+os3ito
+os3ity
+osi4u
+os4l
+o2so
+os4pa
+os4po
+os2ta
+o5stati
+os5til
+os5tit
+o4tan
+otele4g
+ot3er.
+ot5ers
+o4tes
+4oth
+oth5esi
+oth3i4
+ot3ic.
+ot5ica
+o3tice
+o3tif
+o3tis
+oto5s
+ou2
+ou3bl
+ouch5i
+ou5et
+ou4l
+ounc5er
+oun2d
+ou5v
+ov4en
+over4ne
+over3s
+ov4ert
+o3vis
+oviti4
+o5v4ol
+ow3der
+ow3el
+ow5est
+ow1i
+own5i
+o4wo
+oy1a
+1pa
+pa4ca
+pa4ce
+pac4t
+p4ad
+5pagan
+p3agat
+p4ai
+pain4
+p4al
+pan4a
+pan3el
+pan4ty
+pa3ny
+pa1p
+pa4pu
+para5bl
+par5age
+par5di
+3pare
+par5el
+p4a4ri
+par4is
+pa2te
+pa5ter
+5pathic
+pa5thy
+pa4tric
+pav4
+3pay
+4p1b
+pd4
+4pe.
+3pe4a
+pear4l
+pe2c
+2p2ed
+3pede
+3pedi
+pedia4
+ped4ic
+p4ee
+pee4d
+pek4
+pe4la
+peli4e
+pe4nan
+p4enc
+pen4th
+pe5on
+p4era.
+pera5bl
+p4erag
+p4eri
+peri5st
+per4mal
+perme5
+p4ern
+per3o
+per3ti
+pe5ru
+per1v
+pe2t
+pe5ten
+pe5tiz
+4pf
+4pg
+4ph.
+phar5i
+phe3no
+ph4er
+ph4es.
+ph1ic
+5phie
+ph5ing
+5phisti
+3phiz
+ph2l
+3phob
+3phone
+5phoni
+pho4r
+4phs
+ph3t
+5phu
+1phy
+pi3a
+pian4
+pi4cie
+pi4cy
+p4id
+p5ida
+pi3de
+5pidi
+3piec
+pi3en
+pi4grap
+pi3lo
+pi2n
+p4in.
+pind4
+p4ino
+3pi1o
+pion4
+p3ith
+pi5tha
+pi2tu
+2p3k2
+1p2l2
+3plan
+plas5t
+pli3a
+pli5er
+4plig
+pli4n
+ploi4
+plu4m
+plum4b
+4p1m
+2p3n
+po4c
+5pod.
+po5em
+po3et5
+5po4g
+poin2
+5point
+poly5t
+po4ni
+po4p
+1p4or
+po4ry
+1pos
+pos1s
+p4ot
+po4ta
+5poun
+4p1p
+ppa5ra
+p2pe
+p4ped
+p5pel
+p3pen
+p3per
+p3pet
+ppo5site
+pr2
+pray4e
+5preci
+pre5co
+pre3em
+pref5ac
+pre4la
+pre3r
+p3rese
+3press
+pre5ten
+pre3v
+5pri4e
+prin4t3
+pri4s
+pris3o
+p3roca
+prof5it
+pro3l
+pros3e
+pro1t
+2p1s2
+p2se
+ps4h
+p4sib
+2p1t
+pt5a4b
+p2te
+p2th
+pti3m
+ptu4r
+p4tw
+pub3
+pue4
+puf4
+pul3c
+pu4m
+pu2n
+pur4r
+5pus
+pu2t
+5pute
+put3er
+pu3tr
+put4ted
+put4tin
+p3w
+qu2
+qua5v
+2que.
+3quer
+3quet
+2rab
+ra3bi
+rach4e
+r5acl
+raf5fi
+raf4t
+r2ai
+ra4lo
+ram3et
+r2ami
+rane5o
+ran4ge
+r4ani
+ra5no
+rap3er
+3raphy
+rar5c
+rare4
+rar5ef
+4raril
+r2as
+ration4
+rau4t
+ra5vai
+rav3el
+ra5zie
+r1b
+r4bab
+r4bag
+rbi2
+rbi4f
+r2bin
+r5bine
+rb5ing.
+rb4o
+r1c
+r2ce
+rcen4
+r3cha
+rch4er
+r4ci4b
+rc4it
+rcum3
+r4dal
+rd2i
+rdi4a
+rdi4er
+rdin4
+rd3ing
+2re.
+re1al
+re3an
+re5arr
+5reav
+re4aw
+r5ebrat
+rec5oll
+rec5ompe
+re4cre
+2r2ed
+re1de
+re3dis
+red5it
+re4fac
+re2fe
+re5fer.
+re3fi
+re4fy
+reg3is
+re5it
+re1li
+re5lu
+r4en4ta
+ren4te
+re1o
+re5pin
+re4posi
+re1pu
+r1er4
+r4eri
+rero4
+re5ru
+r4es.
+re4spi
+ress5ib
+res2t
+re5stal
+re3str
+re4ter
+re4ti4z
+re3tri
+reu2
+re5uti
+rev2
+re4val
+rev3el
+r5ev5er.
+re5vers
+re5vert
+re5vil
+rev5olu
+re4wh
+r1f
+rfu4
+r4fy
+rg2
+rg3er
+r3get
+r3gic
+rgi4n
+rg3ing
+r5gis
+r5git
+r1gl
+rgo4n
+r3gu
+rh4
+4rh.
+4rhal
+ri3a
+ria4b
+ri4ag
+r4ib
+rib3a
+ric5as
+r4ice
+4rici
+5ricid
+ri4cie
+r4ico
+rid5er
+ri3enc
+ri3ent
+ri1er
+ri5et
+rig5an
+5rigi
+ril3iz
+5riman
+rim5i
+3rimo
+rim4pe
+r2ina
+5rina.
+rin4d
+rin4e
+rin4g
+ri1o
+5riph
+riph5e
+ri2pl
+rip5lic
+r4iq
+r2is
+r4is.
+ris4c
+r3ish
+ris4p
+ri3ta3b
+r5ited.
+rit5er.
+rit5ers
+rit3ic
+ri2tu
+rit5ur
+riv5el
+riv3et
+riv3i
+r3j
+r3ket
+rk4le
+rk4lin
+r1l
+rle4
+r2led
+r4lig
+r4lis
+rl5ish
+r3lo4
+r1m
+rma5c
+r2me
+r3men
+rm5ers
+rm3ing
+r4ming.
+r4mio
+r3mit
+r4my
+r4nar
+r3nel
+r4ner
+r5net
+r3ney
+r5nic
+r1nis4
+r3nit
+r3niv
+rno4
+r4nou
+r3nu
+rob3l
+r2oc
+ro3cr
+ro4e
+ro1fe
+ro5fil
+rok2
+ro5ker
+5role.
+rom5ete
+rom4i
+rom4p
+ron4al
+ron4e
+ro5n4is
+ron4ta
+1room
+5root
+ro3pel
+rop3ic
+ror3i
+ro5ro
+ros5per
+ros4s
+ro4the
+ro4ty
+ro4va
+rov5el
+rox5
+r1p
+r4pea
+r5pent
+rp5er.
+r3pet
+rp4h4
+rp3ing
+r3po
+r1r4
+rre4c
+rre4f
+r4reo
+rre4st
+rri4o
+rri4v
+rron4
+rros4
+rrys4
+4rs2
+r1sa
+rsa5ti
+rs4c
+r2se
+r3sec
+rse4cr
+rs5er.
+rs3es
+rse5v2
+r1sh
+r5sha
+r1si
+r4si4b
+rson3
+r1sp
+r5sw
+rtach4
+r4tag
+r3teb
+rten4d
+rte5o
+r1ti
+rt5ib
+rti4d
+r4tier
+r3tig
+rtil3i
+rtil4l
+r4tily
+r4tist
+r4tiv
+r3tri
+rtroph4
+rt4sh
+ru3a
+ru3e4l
+ru3en
+ru4gl
+ru3in
+rum3pl
+ru2n
+runk5
+run4ty
+r5usc
+ruti5n
+rv4e
+rvel4i
+r3ven
+rv5er.
+r5vest
+r3vey
+r3vic
+rvi4v
+r3vo
+r1w
+ry4c
+5rynge
+ry3t
+sa2
+2s1ab
+5sack
+sac3ri
+s3act
+5sai
+salar4
+sal4m
+sa5lo
+sal4t
+3sanc
+san4de
+s1ap
+sa5ta
+5sa3tio
+sat3u
+sau4
+sa5vor
+5saw
+4s5b
+scan4t5
+sca4p
+scav5
+s4ced
+4scei
+s4ces
+sch2
+s4cho
+3s4cie
+5scin4d
+scle5
+s4cli
+scof4
+4scopy
+scour5a
+s1cu
+4s5d
+4se.
+se4a
+seas4
+sea5w
+se2c3o
+3sect
+4s4ed
+se4d4e
+s5edl
+se2g
+seg3r
+5sei
+se1le
+5self
+5selv
+4seme
+se4mol
+sen5at
+4senc
+sen4d
+s5ened
+sen5g
+s5enin
+4sentd
+4sentl
+sep3a3
+4s1er.
+s4erl
+ser4o
+4servo
+s1e4s
+se5sh
+ses5t
+5se5um
+5sev
+sev3en
+sew4i
+5sex
+4s3f
+2s3g
+s2h
+2sh.
+sh1er
+5shev
+sh1in
+sh3io
+3ship
+shiv5
+sho4
+sh5old
+shon3
+shor4
+short5
+4shw
+si1b
+s5icc
+3side.
+5sides
+5sidi
+si5diz
+4signa
+sil4e
+4sily
+2s1in
+s2ina
+5sine.
+s3ing
+1sio
+5sion
+sion5a
+si2r
+sir5a
+1sis
+3sitio
+5siu
+1siv
+5siz
+sk2
+4ske
+s3ket
+sk5ine
+sk5ing
+s1l2
+s3lat
+s2le
+slith5
+2s1m
+s3ma
+small3
+sman3
+smel4
+s5men
+5smith
+smol5d4
+s1n4
+1so
+so4ce
+soft3
+so4lab
+sol3d2
+so3lic
+5solv
+3som
+3s4on.
+sona4
+son4g
+s4op
+5sophic
+s5ophiz
+s5ophy
+sor5c
+sor5d
+4sov
+so5vi
+2spa
+5spai
+spa4n
+spen4d
+2s5peo
+2sper
+s2phe
+3spher
+spho5
+spil4
+sp5ing
+4spio
+s4ply
+s4pon
+spor4
+4spot
+squal4l
+s1r
+2ss
+s1sa
+ssas3
+s2s5c
+s3sel
+s5seng
+s4ses.
+s5set
+s1si
+s4sie
+ssi4er
+ss5ily
+s4sl
+ss4li
+s4sn
+sspend4
+ss2t
+ssur5a
+ss5w
+2st.
+s2tag
+s2tal
+stam4i
+5stand
+s4ta4p
+5stat.
+s4ted
+stern5i
+s5tero
+ste2w
+stew5a
+s3the
+st2i
+s4ti.
+s5tia
+s1tic
+5stick
+s4tie
+s3tif
+st3ing
+5stir
+s1tle
+5stock
+stom3a
+5stone
+s4top
+3store
+st4r
+s4trad
+5stratu
+s4tray
+s4trid
+4stry
+4st3w
+s2ty
+1su
+su1al
+su4b3
+su2g3
+su5is
+suit3
+s4ul
+su2m
+sum3i
+su2n
+su2r
+4sv
+sw2
+4swo
+s4y
+4syc
+3syl
+syn5o
+sy5rin
+1ta
+3ta.
+2tab
+ta5bles
+5taboliz
+4taci
+ta5do
+4taf4
+tai5lo
+ta2l
+ta5la
+tal5en
+tal3i
+4talk
+tal4lis
+ta5log
+ta5mo
+tan4de
+tanta3
+ta5per
+ta5pl
+tar4a
+4tarc
+4tare
+ta3riz
+tas4e
+ta5sy
+4tatic
+ta4tur
+taun4
+tav4
+2taw
+tax4is
+2t1b
+4tc
+t4ch
+tch5et
+4t1d
+4te.
+tead4i
+4teat
+tece4
+5tect
+2t1ed
+te5di
+1tee
+teg4
+te5ger
+te5gi
+3tel.
+teli4
+5tels
+te2ma2
+tem3at
+3tenan
+3tenc
+3tend
+4tenes
+1tent
+ten4tag
+1teo
+te4p
+te5pe
+ter3c
+5ter3d
+1teri
+ter5ies
+ter3is
+teri5za
+5ternit
+ter5v
+4tes.
+4tess
+t3ess.
+teth5e
+3teu
+3tex
+4tey
+2t1f
+4t1g
+2th.
+than4
+th2e
+4thea
+th3eas
+the5at
+the3is
+3thet
+th5ic.
+th5ica
+4thil
+5think
+4thl
+th5ode
+5thodic
+4thoo
+thor5it
+tho5riz
+2ths
+1tia
+ti4ab
+ti4ato
+2ti2b
+4tick
+t4ico
+t4ic1u
+5tidi
+3tien
+tif2
+ti5fy
+2tig
+5tigu
+till5in
+1tim
+4timp
+tim5ul
+2t1in
+t2ina
+3tine.
+3tini
+1tio
+ti5oc
+tion5ee
+5tiq
+ti3sa
+3tise
+tis4m
+ti5so
+tis4p
+5tistica
+ti3tl
+ti4u
+1tiv
+tiv4a
+1tiz
+ti3za
+ti3zen
+2tl
+t5la
+tlan4
+3tle.
+3tled
+3tles.
+t5let.
+t5lo
+4t1m
+tme4
+2t1n2
+1to
+to3b
+to5crat
+4todo
+2tof
+to2gr
+to5ic
+to2ma
+tom4b
+to3my
+ton4ali
+to3nat
+4tono
+4tony
+to2ra
+to3rie
+tor5iz
+tos2
+5tour
+4tout
+to3war
+4t1p
+1tra
+tra3b
+tra5ch
+traci4
+trac4it
+trac4te
+tras4
+tra5ven
+trav5es5
+tre5f
+tre4m
+trem5i
+5tria
+tri5ces
+5tricia
+4trics
+2trim
+tri4v
+tro5mi
+tron5i
+4trony
+tro5phe
+tro3sp
+tro3v
+tru5i
+trus4
+4t1s2
+t4sc
+tsh4
+t4sw
+4t3t2
+t4tes
+t5to
+ttu4
+1tu
+tu1a
+tu3ar
+tu4bi
+tud2
+4tue
+4tuf4
+5tu3i
+3tum
+tu4nis
+2t3up.
+3ture
+5turi
+tur3is
+tur5o
+tu5ry
+3tus
+4tv
+tw4
+4t1wa
+twis4
+4two
+1ty
+4tya
+2tyl
+type3
+ty5ph
+4tz
+tz4e
+4uab
+uac4
+ua5na
+uan4i
+uar5ant
+uar2d
+uar3i
+uar3t
+u1at
+uav4
+ub4e
+u4bel
+u3ber
+u4bero
+u1b4i
+u4b5ing
+u3ble.
+u3ca
+uci4b
+uc4it
+ucle3
+u3cr
+u3cu
+u4cy
+ud5d
+ud3er
+ud5est
+udev4
+u1dic
+ud3ied
+ud3ies
+ud5is
+u5dit
+u4don
+ud4si
+u4du
+u4ene
+uens4
+uen4te
+uer4il
+3ufa
+u3fl
+ugh3en
+ug5in
+2ui2
+uil5iz
+ui4n
+u1ing
+uir4m
+uita4
+uiv3
+uiv4er.
+u5j
+4uk
+u1la
+ula5b
+u5lati
+ulch4
+5ulche
+ul3der
+ul4e
+u1len
+ul4gi
+ul2i
+u5lia
+ul3ing
+ul5ish
+ul4lar
+ul4li4b
+ul4lis
+4ul3m
+u1l4o
+4uls
+uls5es
+ul1ti
+ultra3
+4ultu
+u3lu
+ul5ul
+ul5v
+um5ab
+um4bi
+um4bly
+u1mi
+u4m3ing
+umor5o
+um2p
+unat4
+u2ne
+un4er
+u1ni
+un4im
+u2nin
+un5ish
+uni3v
+un3s4
+un4sw
+unt3ab
+un4ter.
+un4tes
+unu4
+un5y
+un5z
+u4ors
+u5os
+u1ou
+u1pe
+uper5s
+u5pia
+up3ing
+u3pl
+up3p
+upport5
+upt5ib
+uptu4
+u1ra
+4ura.
+u4rag
+u4ras
+ur4be
+urc4
+ur1d
+ure5at
+ur4fer
+ur4fr
+u3rif
+uri4fic
+ur1in
+u3rio
+u1rit
+ur3iz
+ur2l
+url5ing.
+ur4no
+uros4
+ur4pe
+ur4pi
+urs5er
+ur5tes
+ur3the
+urti4
+ur4tie
+u3ru
+2us
+u5sad
+u5san
+us4ap
+usc2
+us3ci
+use5a
+u5sia
+u3sic
+us4lin
+us1p
+us5sl
+us5tere
+us1tr
+u2su
+usur4
+uta4b
+u3tat
+4ute.
+4utel
+4uten
+uten4i
+4u1t2i
+uti5liz
+u3tine
+ut3ing
+ution5a
+u4tis
+5u5tiz
+u4t1l
+ut5of
+uto5g
+uto5matic
+u5ton
+u4tou
+uts4
+u3u
+uu4m
+u1v2
+uxu3
+uz4e
+1va
+5va.
+2v1a4b
+vac5il
+vac3u
+vag4
+va4ge
+va5lie
+val5o
+val1u
+va5mo
+va5niz
+va5pi
+var5ied
+3vat
+4ve.
+4ved
+veg3
+v3el.
+vel3li
+ve4lo
+v4ely
+ven3om
+v5enue
+v4erd
+5vere.
+v4erel
+v3eren
+ver5enc
+v4eres
+ver3ie
+vermi4n
+3verse
+ver3th
+v4e2s
+4ves.
+ves4te
+ve4te
+vet3er
+ve4ty
+vi5ali
+5vian
+5vide.
+5vided
+4v3iden
+5vides
+5vidi
+v3if
+vi5gn
+vik4
+2vil
+5vilit
+v3i3liz
+v1in
+4vi4na
+v2inc
+vin5d
+4ving
+vio3l
+v3io4r
+vi1ou
+vi4p
+vi5ro
+vis3it
+vi3so
+vi3su
+4viti
+vit3r
+4vity
+3viv
+5vo.
+voi4
+3vok
+vo4la
+v5ole
+5volt
+3volv
+vom5i
+vor5ab
+vori4
+vo4ry
+vo4ta
+4votee
+4vv4
+v4y
+w5abl
+2wac
+wa5ger
+wag5o
+wait5
+w5al.
+wam4
+war4t
+was4t
+wa1te
+wa5ver
+w1b
+wea5rie
+weath3
+wed4n
+weet3
+wee5v
+wel4l
+w1er
+west3
+w3ev
+whi4
+wi2
+wil2
+will5in
+win4de
+win4g
+wir4
+3wise
+with3
+wiz5
+w4k
+wl4es
+wl3in
+w4no
+1wo2
+wom1
+wo5ven
+w5p
+wra4
+wri4
+writa4
+w3sh
+ws4l
+ws4pe
+w5s4t
+4wt
+wy4
+x1a
+xac5e
+x4ago
+xam3
+x4ap
+xas5
+x3c2
+x1e
+xe4cuto
+x2ed
+xer4i
+xe5ro
+x1h
+xhi2
+xhil5
+xhu4
+x3i
+xi5a
+xi5c
+xi5di
+x4ime
+xi5miz
+x3o
+x4ob
+x3p
+xpan4d
+xpecto5
+xpe3d
+x1t2
+x3ti
+x1u
+xu3a
+xx4
+y5ac
+3yar4
+y5at
+y1b
+y1c
+y2ce
+yc5er
+y3ch
+ych4e
+ycom4
+ycot4
+y1d
+y5ee
+y1er
+y4erf
+yes4
+ye4t
+y5gi
+4y3h
+y1i
+y3la
+ylla5bl
+y3lo
+y5lu
+ymbol5
+yme4
+ympa3
+yn3chr
+yn5d
+yn5g
+yn5ic
+5ynx
+y1o4
+yo5d
+y4o5g
+yom4
+yo5net
+y4ons
+y4os
+y4ped
+yper5
+yp3i
+y3po
+y4poc
+yp2ta
+y5pu
+yra5m
+yr5ia
+y3ro
+yr4r
+ys4c
+y3s2e
+ys3ica
+ys3io
+3ysis
+y4so
+yss4
+ys1t
+ys3ta
+ysur4
+y3thin
+yt3ic
+y1w
+za1
+z5a2b
+zar2
+4zb
+2ze
+ze4n
+ze4p
+z1er
+ze3ro
+zet4
+2z1i
+z4il
+z4is
+5zl
+4zm
+1zo
+zo4m
+zo5ol
+zte4
+4z1z2
+z4zy
+% hyphen.tex patterns end here, and additional patterns begin:
+.con5gr
+.de5riva
+.dri5v4
+.eth1y6l1
+.eu4ler
+.ev2
+.ever5si5b
+.ga4s1om1
+.ge4ome
+.ge5ot1
+.he3mo1
+.he3p6a
+.he3roe
+.in5u2t
+.kil2n3i
+.ko6r1te1
+.le6ices
+.me4ga1l
+.met4ala
+.mim5i2c1
+.mi1s4ers
+.ne6o3f
+.noe1th
+.non1e2m
+.poly1s
+.post1am
+.pre1am
+.rav5en1o
+.semi5
+.sem4ic
+.semid6
+.semip4
+.semir4
+.sem6is4
+.semiv4
+.sph6in1
+.spin1o
+.ta5pes1tr
+.te3legr
+.to6pog
+.to2q
+.un3at5t
+.un5err5
+.vi2c3ar
+.we2b1l
+.re1e4c
+a5bolic
+a2cabl
+af6fish
+am1en3ta5b
+anal6ys
+ano5a2c
+ans5gr
+ans3v
+anti1d
+an3ti1n2
+anti1re
+a4pe5able
+ar3che5t
+ar2range
+as5ymptot
+ath3er1o1s
+at6tes.
+augh4tl
+au5li5f
+av3iou
+back2er.
+ba6r1onie
+ba1thy
+bbi4t
+be2vie
+bi5d2if
+bil2lab
+bio5m
+bi1orb
+bio1rh
+b1i3tive
+blan2d1
+blin2d1
+blon2d2
+bor1no5
+bo2t1u1l
+brus4q
+bus6i2er
+bus6i2es
+buss4ing
+but2ed.
+but4ted
+cad5e1m
+cat1a1s2
+4chs.
+chs3hu
+chie5vo
+cig3a3r
+cin2q
+cle4ar
+co6ph1o3n
+cous2ti
+cri3tie
+croc1o1d
+cro5e2co
+c2tro3me6c
+1cu2r1ance
+2d3alone
+data1b
+dd5a5b
+d2d5ib
+de4als.
+de5clar1
+de2c5lina
+de3fin3iti
+de2mos
+des3ic
+de2tic
+dic1aid
+dif5fra
+3di1methy
+di2ren
+di2rer
+2d1lead
+2d1li2e
+3do5word
+dren1a5l
+drif2t1a
+d1ri3pleg5
+drom3e5d
+d3tab
+du2al.
+du1op1o1l
+ea4n3ies
+e3chas
+edg1l
+ed1uling
+eli2t1is
+e1loa
+en1dix
+eo3grap
+1e6p3i3neph1
+e2r3i4an.
+e3spac6i
+eth1y6l1ene
+5eu2clid1
+feb1rua
+fermi1o
+3fich
+fit5ted.
+fla1g6el
+flow2er.
+3fluor
+gen2cy.
+ge3o1d
+ght1we
+g1lead
+get2ic.
+4g1lish
+5glo5bin
+1g2nac
+gnet1ism
+gno5mo
+g2n1or.
+g2noresp
+2g1o4n3i1za
+graph5er.
+griev1
+g1utan
+hair1s
+ha2p3ar5r
+hatch1
+hex2a3
+hite3sid
+h3i5pel1a4
+hnau3z
+ho6r1ic.
+h2t1eou
+hypo1tha
+id4ios
+ifac1et
+ign4it
+ignit1er
+i4jk
+im3ped3a
+infra1s2
+i5nitely.
+irre6v3oc
+i1tesima
+ith5i2l
+itin5er5ar
+janu3a
+japan1e2s
+je1re1m
+1ke6ling
+1ki5netic
+1kovian
+k3sha
+la4c3i5e
+lai6n3ess
+lar5ce1n
+l3chai
+l3chil6d1
+lead6er.
+lea4s1a
+1lec3ta6b
+le3g6en2dre
+1le1noid
+lith1o5g
+ll1fl
+l2l3ish
+l5mo3nell
+lo1bot1o1
+lo2ges.
+load4ed.
+load6er.
+l3tea
+lth5i2ly
+lue1p
+1lunk3er
+1lum5bia.
+3lyg1a1mi
+ly5styr
+ma1la1p
+m2an.
+man3u1sc
+mar1gin1
+medi2c
+med3i3cin
+medio6c1
+me3gran3
+m2en.
+3mi3da5b
+3milita
+mil2l1ag
+mil5li5li
+mi6n3is.
+mi1n2ut1er
+mi1n2ut1est
+m3ma1b
+5maph1ro1
+5moc1ra1t
+mo5e2las
+mol1e5c
+mon4ey1l
+mono3ch
+mo4no1en
+moro6n5is
+mono1s6
+moth4et2
+m1ou3sin
+m5shack2
+mu2dro
+mul2ti5u
+n3ar4chs.
+n3ch2es1t
+ne3back
+2ne1ski
+n1dieck
+nd3thr
+nfi6n3ites
+4n5i4an.
+nge5nes
+ng1ho
+ng1spr
+nk3rup
+n5less
+5noc3er1os
+nom1a6l
+nom5e1no
+n1o1mist
+non1eq
+non1i4so
+5nop1oly.
+no1vemb
+ns5ceiv
+ns4moo
+ntre1p
+obli2g1
+o3chas
+odel3li
+odit1ic
+oerst2
+oke1st
+o3les3ter
+oli3gop1o1
+o1lo3n4om
+o3mecha6
+onom1ic
+o3norma
+o3no2t1o3n
+o3nou
+op1ism.
+or4tho3ni4t
+orth1ri
+or5tively
+o4s3pher
+o5test1er
+o5tes3tor
+oth3e1o1s
+ou3ba3do
+o6v3i4an.
+oxi6d1ic
+pal6mat
+parag6ra4
+par4a1le
+param4
+para3me
+pee2v1
+phi2l3ant
+phi5lat1e3l
+pi2c1a3d
+pli2c1ab
+pli5nar
+poin3ca
+1pole.
+poly1e
+po3lyph1ono
+1prema3c
+pre1neu
+pres2pli
+pro2cess
+proc3i3ty.
+pro2g1e
+3pseu2d
+pseu3d6o3d2
+pseu3d6o3f2
+pto3mat4
+p5trol3
+pu5bes5c
+quain2t1e
+qu6a3si3
+quasir6
+quasis6
+quin5tes5s
+qui3v4ar
+r1abolic
+3rab1o1loi
+ra3chu
+r3a3dig
+radi1o6g
+r2amen
+3ra4m5e1triz
+ra3mou
+ra5n2has
+ra1or
+r3bin1ge
+re2c3i1pr
+rec5t6ang
+re4t1ribu
+r3ial.
+riv1o1l
+6rk.
+rk1ho
+r1krau
+6rks.
+r5le5qu
+ro1bot1
+ro5e2las
+ro5epide1
+ro3mesh
+ro1tron
+r3pau5li
+rse1rad1i
+r1thou
+r1treu
+r1veil
+rz1sc
+sales3c
+sales5w
+5sa3par5il
+sca6p1er
+sca2t1ol
+s4chitz
+schro1ding1
+1sci2utt
+scrap4er.
+scy4th1
+sem1a1ph
+se3mes1t
+se1mi6t5ic
+sep3temb
+shoe1st
+sid2ed.
+side5st
+side5sw
+si5resid
+sky1sc
+3slova1kia
+3s2og1a1my
+so2lute
+3s2pace
+1s2pacin
+spe3cio
+spher1o
+spi2c1il
+spokes5w
+sports3c
+sports3w
+s3qui3to
+s2s1a3chu1
+ss3hat
+s2s3i4an.
+s5sign5a3b
+1s2tamp
+s2t1ant5shi
+star3tli
+sta1ti
+st5b
+1stor1ab
+strat1a1g
+strib5ut
+st5scr
+stu1pi4d1
+styl1is
+su2per1e6
+1sync
+1syth3i2
+swimm6
+5tab1o1lism
+ta3gon.
+talk1a5
+t1a1min
+t6ap6ath
+5tar2rh
+tch1c
+tch3i1er
+t1cr
+teach4er.
+tele2g
+tele1r6o
+3ter1gei
+ter2ic.
+t3ess2es
+tha4l1am
+tho3don
+th1o5gen1i
+tho1k2er
+thy4l1an
+thy3sc
+2t3i4an.
+ti2n3o1m
+t1li2er
+tolo2gy
+tot3ic
+trai3tor1
+tra1vers
+travers3a3b
+treach1e
+tr4ial.
+3tro1le1um
+trof4ic.
+tro3fit
+tro1p2is
+3trop1o5les
+3trop1o5lis
+t1ro1pol3it
+tsch3ie
+ttrib1ut1
+turn3ar
+t1wh
+ty2p5al
+ua3drati
+uad1ratu
+u5do3ny
+uea1m
+u2r1al.
+uri4al.
+us2er.
+v1ativ
+v1oir5du1
+va6guer
+vaude3v
+1verely.
+v1er1eig
+ves1tite
+vi1vip3a3r
+voice1p
+waste3w6a2
+wave1g4
+w3c
+week1n
+wide5sp
+wo4k1en
+wrap3aro
+writ6er.
+x1q
+xquis3
+y5che3d
+ym5e5try
+y1stro
+yes5ter1y
+z3ian.
+z3o1phr
+z2z3w
+% end of additional patterns.
+}
+% DEK's hyphenation exception list, from hyphen.tex; not changed.
+\hyphenation{
+as-so-ciate
+as-so-ciates
+dec-li-na-tion
+oblig-a-tory
+phil-an-thropic
+present
+presents
+project
+projects
+reci-procity
+re-cog-ni-zance
+ref-or-ma-tion
+ret-ri-bu-tion
+ta-ble
+}

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.fr -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.fr Changed

@@ -231,7 +231,7 @@
                     .dé1a2
                     .dé1io
                     .dé1o2
-                    .dé2s % originaly in JD file
+                    .dé2s % originally in JD file
                     %.d\'e2s1a2 removed 09/17/92 because wrong for the
                     % original JD 500 words test
                     .dé3s2a3cr
@@ -915,7 +915,7 @@
                     3ph2talé
                     3ph2tis
 %%%% Here is an example of a pb involving phonetic and etymologic patterns 5/94
-%%%%                .phyto3ph2 % originaly, but wrong for phy-toph-thora   9/92
+%%%%                .phyto3ph2 % originally, but wrong for phy-toph-thora  9/92
 %%%%                .phy2topha % for -pharmacie but wrong for phyto-biol.. 5/94
 1pi
 1pî
@@ -937,7 +937,7 @@
                     poly1o2
                     poly1s2
                     poly1u2
-                    .pon2tet % JD hypenated it asis 09/17/92, exception
+                    .pon2tet % JD hyphenated it asis 09/17/92, exception
                     .pos2t3h
                     .pos2t1in
                     .pos2t1o2
@@ -1317,10 +1317,6 @@
 
 \endinput
 
-% ======================================================================
-% Editor settings
-% ======================================================================
-%
 % Local Variables:
 % mode: tex
 % coding: latin-9

_service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.it Added

@@ -0,0 +1,431 @@
+% title: Hyphenation patterns for Italian
+% copyright: Copyright (C) 2008-2011 Claudio Beccari
+% notice: This file is part of the hyph-utf8 package.
+%     See http://www.hyphenation.org/tex for more information.
+% language:
+%     name: Italian
+%     tag: it
+% version: 4.9 2014/04/22
+% authors:
+%   -
+%     name: Claudio Beccari
+%     contact: claudio.beccari (at) gmail.com
+% licence:
+%     - This file is available under any of the following licences:
+%     -
+%         name: LPPL
+%         version: 1.3
+%         or_later: true
+%         url: http://www.latex-project.org/lppl.txt
+%         status: maintained
+%         maintainer: Claudio Beccari, e-mail claudio dot beccari at gmail dot com
+%     -
+%         name: MIT
+%         url: https://opensource.org/licenses/MIT
+%         text: >
+%             Permission is hereby granted, free of charge, to any person
+%             obtaining a copy of this software and associated documentation
+%             files (the "Software"), to deal in the Software without
+%             restriction, including without limitation the rights to use,
+%             copy, modify, merge, publish, distribute, sublicense, and/or sell
+%             copies of the Software, and to permit persons to whom the
+%             Software is furnished to do so, subject to the following
+%             conditions:
+%
+%             The above copyright notice and this permission notice shall be
+%             included in all copies or substantial portions of the Software.
+%
+%             THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+%             EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+%             OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+%             NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+%             HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+%             WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+%             FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+%             OTHER DEALINGS IN THE SOFTWARE.
+% hyphenmins:
+%     typesetting:
+%         left: 2
+%         right: 2
+% changes:
+%     - 2014-04-22 - Add few patterns involving `h'
+%     - 2011-08-16 - Change the licence from GNU LGPL into LPPL v1.3.
+%     - 2010-05-24 - Fix for Italian patterns for proper hyphenation of -ich and Ljubljana.
+%     - 2008-06-09 - Import of original ithyph.tex into hyph-utf8 package.
+%     - 2008-03-08 - (last change in ithyph.tex)
+% texlive:
+%     encoding: ascii
+%     babelname: italian
+%     legacy_patterns: ithyph.tex
+%     message: Italian hyphenation patterns
+%     description: |-
+%         Hyphenation patterns for Italian in ASCII encoding.
+%         Compliant with the Recommendation UNI 6461 on hyphenation
+%         issued by the Italian Standards Institution
+%         (Ente Nazionale di Unificazione UNI).
+% ==========================================
+%
+% These hyphenation patterns for the Italian language are supposed to comply
+% with the Recommendation UNI 6461 on hyphenation issued by the Italian
+% Standards Institution (Ente Nazionale di Unificazione UNI).  No guarantee
+% or declaration of fitness to any particular purpose is given and any
+% liability is disclaimed.
+%
+\patterns{
+.a3p2n               % After the Garzanti dictionary: a-pnea, a-pnoi-co,...
+.anti1
+.anti3m2n
+.bio1
+.ca4p3s
+.circu2m1
+.contro1
+.di2s3cine
+.e2x1eu
+.fran2k3
+.free3
+.li3p2sa
+.narco1
+.opto1
+.orto3p2
+.para1
+.ph2l
+.ph2r
+.poli3p2
+.pre1
+.p2s
+.re1i2scr
+.sha2re3
+.tran2s3c
+.tran2s3d
+.tran2s3l
+.tran2s3n
+.tran2s3p
+.tran2s3r
+.tran2s3t
+.su2b3lu
+.su2b3r
+.wa2g3n
+.wel2t1
+2'2
+a1ia
+a1ie
+a1io
+a1iu
+a1uo
+a1ya
+2at.
+e1iu
+e2w
+o1ia
+o1ie
+o1io
+o1iu
+1b
+2bb
+2bc
+2bd
+2bf
+2bm
+2bn
+2bp
+2bs
+2bt
+2bv
+b2l
+b2r
+2b.
+2b'
+1c
+2cb
+2cc
+2cd
+2cf
+2ck
+2cm
+2cn
+2cq
+2cs
+2ct
+2cz
+2chh
+c2h
+2ch.
+2ch'.
+2ch''.
+2chb
+ch2r
+2chn
+c2l
+c2r
+2c.
+2c'
+.c2
+1d
+2db
+2dd
+2dg
+2dl
+2dm
+2dn
+2dp
+d2r
+2ds
+2dt
+2dv
+2dw
+2d.
+2d'
+.d2
+1f
+2fb
+2fg
+2ff
+2fn
+f2l
+f2r
+2fs
+2ft
+2f.
+2f'
+1g
+2gb
+2gd
+2gf
+2gg
+g2h
+g2l
+2gm
+g2n
+2gp
+g2r
+2gs
+2gt
+2gv
+2gw
+2gz
+2gh2t
+2g.
+2g'
+.h2
+1h
+2hb
+2hd
+2hh
+hi3p2n
+h2l
+2hm
+2hn
+2hr
+2hv
+2h.
+2h'
+.j2
+1j
+2j.
+2j'
+.k2
+1k
+2kg
+2kf
+k2h
+2kk
+k2l
+2km
+k2r
+2ks
+2kt
+2k.
+2k'
+1l
+2lb
+2lc
+2ld
+2l3f2
+2lg
+l2h
+l2j
+2lk
+2ll
+2lm
+2ln
+2lp
+2lq
+2lr
+2ls
+2lt
+2lv
+2lw
+2lz
+2l.
+2l'.
+2l''
+1m
+2mb
+2mc
+2mf
+2ml
+2mm
+2mn
+2mp
+2mq
+2mr
+2ms
+2mt
+2mv
+2mw
+2m.
+2m'
+1n
+2nb
+2nc
+2nd
+2nf
+2ng
+2nk
+2nl
+2nm
+2nn
+2np
+2nq
+2nr
+2ns
+n2s3fer
+2nt
+2nv
+2nz
+n2g3n
+2nheit
+2n.
+2n'
+1p
+2pd
+p2h
+p2l
+2pn
+3p2ne
+2pp
+p2r
+2ps
+3p2sic
+2pt
+2pz
+2p.
+2p'
+1q
+2qq
+2q.
+2q'
+1r
+2rb
+2rc
+2rd
+2rf
+r2h
+2rg
+2rk
+2rl
+2rm
+2rn
+2rp
+2rq
+2rr
+2rs
+2rt
+r2t2s3
+2rv
+2rx
+2rw
+2rz
+2r.
+2r'
+1s2
+2shm
+2sh.
+2sh'
+2s3s
+s4s3m
+2s3p2n
+2stb
+2stc
+2std
+2stf
+2stg
+2stm
+2stn
+2stp
+2sts
+2stt
+2stv
+2sz
+4s.
+4s'.
+4s''
+.t2
+1t
+2tb
+2tc
+2td
+2tf
+2tg
+t2h
+2th.
+t2l
+2tm
+2tn
+2tp
+t2r
+t2s
+3t2sch
+2tt
+t2t3s
+2tv
+2tw
+t2z
+2tzk
+tz2s
+2t.
+2t'.
+2t''
+1v
+2vc
+v2l
+v2r
+2vv
+2v.
+2v'.
+2v''
+1w
+w2h
+wa2r
+2w1y
+2w.
+2w'
+1x
+2xb
+2xc
+2xf
+2xh
+2xm
+2xp
+2xt
+2xw
+2x.
+2x'
+y1ou
+y1i
+1z
+2zb
+2zd
+2zl
+2zn
+2zp
+2zt
+2zs
+2zv
+2zz
+2z.
+2z'.
+2z''
+.z2
+}                          % Pattern end
+

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphen.sv -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphen.sv Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphenex.cs -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphenex.cs Changed

_service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphenex.en Added

@@ -0,0 +1,115 @@
+% Hyphenation exceptions for US English,
+% based on hyphenation exception log articles in TUGboat.
+%
+% Copyright 2008 TeX Users Group.
+% You may freely use, modify and/or distribute this file.
+%
+% Stripped down by the GNU roff project to only include the patterns
+% that hyphenate differently when using the hyph-utf8 project's
+% hyph-en-us.tex file (version 2005-05-30).
+%
+% Please contact the TUGboat editorial staff <tugboat@tug.org>
+% for corrections and omissions.
+%
+\hyphenation{
+  anti-deriv-a-tive
+  anti-deriv-a-tives
+  bathy-scaphe
+  co-designer
+  co-designers
+  electro-mechan-i-cal
+  electro-mechano-acoustic
+  fluoro-car-bon
+  free-loaders
+  grand-uncle
+  grand-uncles
+  griev-ances
+  ignore-spaces
+  im-ped-ances
+  input-enc
+  line-spacing
+  meta-stable
+  meta-table
+  meta-tables
+  micro-eco-nomic
+  micro-eco-nomics
+  micro-econ-omy
+  micro-en-ter-prise
+  micro-en-ter-prises
+  micro-organ-ism
+  micro-organ-isms
+  mid-after-noon
+  mine-sweepers
+  mono-spacing
+  nitro-meth-ane
+  non-euclid-ean
+  ortho-nitro-toluene
+  para-di-methyl-benzene
+  para-fluoro-toluene
+  phe-nol-phthalein
+  phtha-lam-ic
+  phthal-ate
+  phthi-sis
+  pre-proces-sor
+  pre-proces-sors
+  re-imple-ment
+  re-imple-ments
+  re-imple-mented
+  re-imple-men-ta-tion
+  ring-leaders
+  round-table
+  round-tables
+  single-space
+  single-spaced
+  single-spacing
+  sky-scrapers
+  sports-writers
+  sub-tables
+  super-deri-va-tion
+  super-deri-va-tions
+  super-ego
+  super-egos
+  waste-water
+  Bembo
+  Chiang
+  Cohen
+  Duane
+  Engle
+  Engel
+  Hibbs
+  Hoek-water
+  Huber
+  Image-Magick
+  Krishna
+  Krish-na-ism
+  Krish-nan
+  Le-gendre
+  Lucas
+  MacBeth
+  Nietz-sche
+  Noord-wijker-hout
+  Open-Office
+  Pres-by-terian
+  Pres-by-terians
+  Pyong-yang
+  Ra-dha-krish-nan
+  Ravi-kumar
+  Reich-lin
+  Schwert
+  Skoup
+  Thiruv-ananda-puram
+  Vieth
+  viiith
+  viith
+  xviiith
+  xviith
+  xxiiird
+  xxiind
+  Ying-yong Shu-xue Ji-suan
+}
+% Here's an erratum from the aforementioned hyph-en-us.tex.
+\hyphenation{
+  dem-o-crat
+}
+
+% EOF

_service:tar_scm:groff-1.22.4.tar.gz/tmac/hyphenex.pl -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/hyphenex.pl Changed

@@ -31,47 +31,57 @@
 print "\n";
 print "\\hyphenation{\n";
 
-while (<>) {
-  # retain only lines starting with \1 ... \6 or \tabalign
-  next if not (m/^\\123456/ || m/^\\tabalign/);
-  # remove final newline
-  chop;
-  # remove all TeX commands except \1 ... \6
-  s/\\^123456\s{+//g;
-  # remove all paired { ... }
-  1 while s/{(.*?)}/\1/g;
-  # skip lines which now have only whitespace before '&'
-  next if m/^\s*&/;
-  # remove comments
-  s/%.*//;
-  # remove trailing whitespace
-  s/\s*$//;
-  # remove trailing '*' (used as a marker in the document)
-  s/\*$//;
-  # split at whitespace
-  @field = split(' ');
-  if ($field0 eq "\\1" || $field0 eq "\\4") {
-    print "  $field2\n";
+unshift @ARGV, '-' unless @ARGV;
+foreach my $filename (@ARGV) {
+  my $input;
+  if ($filename eq '-') {
+    $input = \*STDIN;
+  } elsif (not open $input, '<', $filename) {
+    warn $!;
+    next;
   }
-  elsif ($field0 eq "\\2" || $field0 eq "\\5") {
-    print "  $field2\n";
-    # handle multiple suffixes separated by commata
-    @suffix_list = split(/,/, "$field3");
-    foreach $suffix (@suffix_list) {
-      print "  $field2$suffix\n";
+  while (<$input>) {
+    # retain only lines starting with \1 ... \6 or \tabalign
+    next if not (m/^\\123456/ || m/^\\tabalign/);
+    # remove final newline
+    chop;
+    # remove all TeX commands except \1 ... \6
+    s/\\^123456\s{+//g;
+    # remove all paired { ... }
+    1 while s/{(.*?)}/\1/g;
+    # skip lines which now have only whitespace before '&'
+    next if m/^\s*&/;
+    # remove comments
+    s/%.*//;
+    # remove trailing whitespace
+    s/\s*$//;
+    # remove trailing '*' (used as a marker in the document)
+    s/\*$//;
+    # split at whitespace
+    @field = split(' ');
+    if ($field0 eq "\\1" || $field0 eq "\\4") {
+      print "  $field2\n";
     }
-  }
-  elsif ($field0 eq "\\3" || $field0 eq "\\6") {
-    # handle multiple suffixes separated by commata
-    @suffix_list = split(/,/, "$field3,$field4");
-    foreach $suffix (@suffix_list) {
-      print "  $field2$suffix\n";
+    elsif ($field0 eq "\\2" || $field0 eq "\\5") {
+      print "  $field2\n";
+      # handle multiple suffixes separated by commata
+      @suffix_list = split(/,/, "$field3");
+      foreach $suffix (@suffix_list) {
+        print "  $field2$suffix\n";
+      }
+    }
+    elsif ($field0 eq "\\3" || $field0 eq "\\6") {
+      # handle multiple suffixes separated by commata
+      @suffix_list = split(/,/, "$field3,$field4");
+      foreach $suffix (@suffix_list) {
+        print "  $field2$suffix\n";
+      }
+    }
+    else {
+      # for '&', split at '&' with trailing whitespace
+      @field = split(/&\s*/);
+      print "  $field1\n";
     }
-  }
-  else {
-    # for '&', split at '&' with trailing whitespace
-    @field = split(/&\s*/);
-    print "  $field1\n";
   }
 }

_service:tar_scm:groff-1.23.0.tar.gz/tmac/it.tmac Added

@@ -0,0 +1,194 @@
+.\" Italian localization for groff
+.\"
+.\" Copyright (C) 2021-2022 Free Software Foundation, Inc.
+.\"   Written by Edmond Orignac (edmond.orignac@wanadoo.fr)
+.\"
+.\" 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
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" 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 this program.  If not, see
+.\" <http://www.gnu.org/licenses/>.
+.\"
+.\" Please send comments/corrections to edmond.orignac@wanadoo.fr.
+.
+.do nr *groff_it_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
+.
+.
+.ds locale italian\"
+.
+.
+.\" Predefined text translations
+.
+.ds \*locale-abstract RIASSUNTO\"
+.ds \*locale-app ALLEGATO\"
+.ds \*locale-appendix_string Appendice\"
+.ds \*locale-april Aprile\"
+.ds \*locale-attribute_string da\"
+.ds \*locale-august Agosto\"
+.ds \*locale-chapter_string Capitolo\"
+.ds \*locale-december Dicembre\"
+.ds \*locale-draft_string Brutta Copia\"
+.ds \*locale-endnote_string ANNOTAZIONI\"
+.ds \*locale-february Febbraio\"
+.ds \*locale-finis_string FINE\"
+.ds \*locale-friday Venerd\i `\"
+.ds \*locale-january Gennaio\"
+.ds \*locale-july Luglio\"
+.ds \*locale-june Giugno\"
+.ds \*locale-le ELENCO DEI EQUAZIONI\"
+.ds \*locale-letapp LETTO E APPROVATO\"
+.ds \*locale-letat ALLA CORTESE ATTENZIONE DI:\"
+.ds \*locale-letcn CONFIDENZIALE\"
+.ds \*locale-letdate Data\"
+.ds \*locale-letfc Accolga, signore, l'espressione dei miei sentimenti pi\u ` distinti.\"
+.ds \*locale-letns!0 Copia ad\"
+.ds \*locale-letns!1 Esemplare (con destinatario) a\"
+.ds \*locale-letns!10 Esemplare (con destinatarie) a\"
+.ds \*locale-letns!11 Esemplare (sin destinatarie) a\"
+.ds \*locale-letns!12 Riassunto ad\"
+.ds \*locale-letns!13 Promemoria completa ad\"
+.ds \*locale-letns!14 Cc:\"
+.ds \*locale-letns!2 Esemplare (sin destinatario) a\"
+.ds \*locale-letns!3 Destinatario\"
+.ds \*locale-letns!4 Destinatarie\"
+.ds \*locale-letns!5 Allegato\"
+.ds \*locale-letns!6 Allegati\"
+.ds \*locale-letns!7 In plico a parte\"
+.ds \*locale-letns!8 Lettere ad\"
+.ds \*locale-letns!9 Promemoria ad\"
+.ds \*locale-letns!copy Copia \" (a space is needed)\"
+.ds \*locale-letns!to  ad\"
+.ds \*locale-letrn In relazione a:\"
+.ds \*locale-letsa A chiunque riguardate:\"
+.ds \*locale-letsj Soggetto:\"
+.ds \*locale-lf ELENCO DELLE FIGURE\"
+.ds \*locale-licon SOMMARIO\"
+.ds \*locale-liec Equatio\"
+.ds \*locale-liex Documento\"
+.ds \*locale-lifg Figura\"
+.ds \*locale-litb Tabella\"
+.ds \*locale-lt ELENCO DEI TABELLE\"
+.ds \*locale-lx ELENCO DEI DOCUMENTI\"
+.ds \*locale-man-section1 Manuale dei comandi generali\"
+.ds \*locale-man-section2 Manuale delle chiamate di sistema\"
+.ds \*locale-man-section3 Manuale delle funzioni di libreria\"
+.ds \*locale-man-section4 Manuale delle interfacce del kernel\"
+.ds \*locale-man-section5 Manuale dei formati di file\"
+.ds \*locale-man-section6 Manuale dei giochi\"
+.ds \*locale-man-section7 Manuale di informazioni varie\"
+.ds \*locale-man-section8 Manuale del gestore di sistema\"
+.ds \*locale-man-section9 Manuale dello sviluppatore del kernel\"
+.ds \*locale-march Marzo\"
+.ds \*locale-may Maggio\"
+.ds \*locale-monday Luned\i `\"
+.ds \*locale-november Novembre\"
+.ds \*locale-october Ottobre\"
+.ds \*locale-paper A4\"
+.ds \*locale-qrf Cf. capitulo \\*Qrfh, pagina \\*Qrfp.\"
+.ds \*locale-references Bibliografia\"
+.ds \*locale-revision_string Revisione\"
+.ds \*locale-rp BIBLIOGRAFIA\"
+.ds \*locale-saturday Sabato\"
+.ds \*locale-september Settembre\"
+.ds \*locale-sunday Domenica\"
+.ds \*locale-thursday Gioved\i `\"
+.ds \*locale-toc Indice\"
+.ds \*locale-toc_header_string Indice\"
+.ds \*locale-tuesday Marted\i `\"
+.ds \*locale-wednesday Mercoled\i `\"
+.
+.
+.\" Activate the translations
+.
+.mso trans.tmac
+.
+.
+.\" ms package
+.if r GS \{\
+.	\" update the date
+.	ds DY \ndy \*MO \nyear
+.	\" set hyphenation flags
+.	nr HY 2
+.\}
+.
+.
+.\" mm package
+.if d PH \{\
+.	\" update the date with the new strings
+.	ds cov*new-date \\ndy \\*MO\\nmo \\nyear
+.
+.	\" ISODATE and DT update
+.	de ISODATE
+.		nr cov*mm \\nmo
+.		nr cov*dd \\ndy
+.		af cov*mm 01
+.		af cov*dd 01
+.		ie '0'\\$1' \
+.			ds cov*new-date \\ndy \\*MO\\nmo \\nyear
+.		el \
+.			ds cov*new-date \\nyear-\\ncov*mm-\\ncov*dd
+.	.
+.
+.	als DT cov*new-date
+.\}
+.
+.
+.ss 12 0
+.
+.\" Set up hyphenation.
+.
+.\" Italian hyphenation (\lefthyphenmin=2, \righthyphenmin=2)
+.nr \*locale*hyphenation-mode-base 1
+.nr \*locale*hyphenation-mode-trap 2
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
+.
+.hla it
+.hpf hyphen.it
+.
+.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \En(dy \E*(mo \En(y4
+.	ld
+.\}
+.
+.
+.cp \n*groff_it_tmac_C
+.do rr *groff_it_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" coding: latin-1
+.\" fill-column: 72
+.\" End:
+.\" vim: set fileencoding=iso-8859-1 filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/ja.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/ja.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/latin1.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/latin1.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/latin2.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/latin2.tmac Changed

@@ -1,10 +1,137 @@
-.\" -*- nroff -*-
-.\"
 .\" latin2.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_latin2_tmac_C \n.cp
 .cp 0
-.\" 0xA1
+.
+.if '\*.T'latin1' \{\
+.\" Replace characters that ISO Latin-1 has but Latin-2 doesn't.
+.char \r! \ \" space
+.char \ct \ \" space
+.char \Po \ \" space
+.char \Ye \ \" space
+.char \bb \ \" space
+.char \co \ \" space
+.char \Of \ \" space
+.char \Fo \ \" space
+.char \no \ \" space
+.char \rg \ \" space
+.char \a- \ \" space
+.char \+- \ \" space
+.char \S2 \ \" space
+.char \S3 \ \" space
+.char \mc \ \" space
+.char \ps \ \" space
+.char \pc \ \" space
+.char \S1 \ \" space
+.char \Om \ \" space
+.char \Fc \ \" space
+.char \14 1/4
+.char \12 1/2
+.char \34 3/4
+.char \r? \ \" space
+.char \`A A
+.char \~A A
+.char \oA A
+.char \AE AE
+.char \`E E
+.char \^E E
+.char \`I I
+.char \:I I
+.char \-D \ \" space
+.char \~N N
+.char \`O O
+.char \~O O
+.char \/O O
+.char \`U U
+.char \^U U
+.char \TP \ \" space
+.char \`a a
+.char \~a a
+.char \oa A
+.char \ae ae
+.char \`e e
+.char \^e e
+.char \`i i
+.char \:i i
+.char \Sd \ \" space
+.char \~n n
+.char \`o o
+.char \~o o
+.char \/o o
+.char \`u u
+.char \^u u
+.char \tp \ \" space
+.char \:y y
+.\" Map characters that ISO Latin-2 has and Latin-1 doesn't to their
+.\" numeric code points.
+.\" 0xA0
+.char \A ho \N'161'
+.char \ab \N'162'
+.char \/L \N'163'
+.char \L ah \N'165'
+.char \S aa \N'166'
+.char \vS \N'169'
+.char \S ac \N'170'
+.char \T ah \N'171'
+.char \Z aa \N'172'
+.char \vZ \N'174'
+.char \Z a. \N'175'
+.\" 0xB0
+.char \a ho \N'177'
+.char \ho \N'178'
+.char \/l \N'179'
+.char \l ah \N'181'
+.char \s aa \N'182'
+.char \ah \N'183'
+.char \vs \N'185'
+.char \s ac \N'186'
+.char \t ah \N'187'
+.char \z aa \N'188'
+.char \a" \N'189'
+.char \vz \N'190'
+.char \z a. \N'191'
+.\" 0xC0
+.char \R aa \N'192'
+.char \A ab \N'195'
+.char \L aa \N'197'
+.char \C aa \N'198'
+.char \C ah \N'200'
+.char \E ho \N'202'
+.char \E ah \N'204'
+.char \D ah \N'207'
+.\" 0xD0
+.char \u0110 \N'208'
+.char \N aa \N'209'
+.char \N ah \N'210'
+.char \O a" \N'213'
+.char \R ah \N'216'
+.char \U ao \N'217'
+.char \U a" \N'219'
+.char \T ac \N'222'
+.\" 0xE0
+.char \r aa \N'224'
+.char \a ab \N'227'
+.char \l aa \N'229'
+.char \c aa \N'230'
+.char \c ah \N'232'
+.char \e ho \N'234'
+.char \e ah \N'236'
+.char \d ah \N'239'
+.\" OxF0
+.char \u0111 \N'240'
+.char \n aa \N'241'
+.char \n ah \N'242'
+.char \o a" \N'245'
+.char \r ah \N'248'
+.char \u ao \N'249'
+.char \u a" \N'251'
+.char \t ac \N'254'
+.char \a. \N'255'
+.\} \" using -Tlatin1
+.
+.\" Translate eight-bit input characters.
+.\" 0xA0
+.\" char160 (no-break space) is translated on input
 .trin \char161\A ho
 .trin \char162\ab
 .trin \char163\/L
@@ -17,8 +144,7 @@
 .trin \char170\S ac
 .trin \char171\T ah
 .trin \char172\Z aa
-.\" The soft-hyphen character is only an input character
-.tr \char173\%
+.\" char173 (soft hyphen) is translated on input
 .trin \char174\vZ
 .trin \char175\Z a.
 .\" 0xB0
@@ -106,4 +232,11 @@
 .trin \char253\'y
 .trin \char254\t ac
 .trin \char255\a.
-.cp \n_C
+.cp \n*groff_latin2_tmac_C
+.do rr *groff_latin2_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/latin5.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/latin5.tmac Changed

@@ -1,10 +1,29 @@
-.\" -*- nroff -*-
-.\"
 .\" latin5.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_latin5_tmac_C \n.cp
 .cp 0
-.\" 0xA1
+.
+.if '\*.T'latin1' \{\
+.\" Replace characters that ISO Latin-1 has but Latin-5 doesn't.
+.char \-D \ \" space
+.char \Sd \ \" space
+.char \TP \ \" space
+.char \Tp \ \" space
+.char \'Y Y
+.char \'y y
+.\" Map characters that ISO Latin-5 has and Latin-1 doesn't to their
+.\" numeric code points.
+.char \G ab \N'208'
+.char \g ab \N'240'
+.char \u0130 \N'221'
+.char \.i \N'253'
+.char \S ac \N'222'
+.char \s ac \N'254'
+.\} \" using -Tlatin1
+.
+.\" Translate eight-bit input characters.
+.\" 0xA0
+.\" char160 (no-break space) is translated on input
 .trin \char161\r!
 .trin \char162\ct
 .trin \char163\Po
@@ -17,8 +36,7 @@
 .trin \char170\Of
 .trin \char171\Fo
 .trin \char172\tno
-.\" The soft-hyphen character is only an input character
-.tr \char173\%
+.\" char173 (soft hyphen) is translated on input
 .trin \char174\rg
 .trin \char175\a-
 .\" 0xB0
@@ -106,4 +124,11 @@
 .trin \char253\.i
 .trin \char254\s ,
 .trin \char255\:y
-.cp \n_C
+.cp \n*groff_latin5_tmac_C
+.do rr *groff_latin5_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/latin9.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/latin9.tmac Changed

@@ -1,10 +1,33 @@
-.\" -*- nroff -*-
-.\"
 .\" latin9.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_latin9_tmac_C \n.cp
 .cp 0
-.\" 0xA1
+.
+.if '\*.T'latin1' \{\
+.\" Replace characters that ISO Latin-1 has but Latin-9 doesn't.
+.char \Cs \ \" space
+.char \bb \ \" space
+.char \ad \ \" space
+.char \aa \ \" space
+.char \ac \ \" space
+.char \12 1/2
+.char \14 1/4
+.char \34 3/4
+.\" Map characters that ISO Latin-9 has and Latin-1 doesn't to their
+.\" numeric code points.
+.char \Eu \N'164'
+.char \vS \N'166'
+.char \vs \N'168'
+.char \vZ \N'180'
+.char \vz \N'184'
+.char \OE \N'188'
+.char \oe \N'189'
+.char \:Y \N'190'
+.\} \" using -Tlatin1
+.
+.\" Translate eight-bit input characters.
+.\" 0xA0
+.\" char160 (no-break space) is translated on input
 .trin \char161\r!
 .trin \char162\ct
 .trin \char163\Po
@@ -17,8 +40,7 @@
 .trin \char170\Of
 .trin \char171\Fo
 .trin \char172\tno
-.\" The soft-hyphen character is only an input character
-.tr \char173\%
+.\" char173 (soft hyphen) is translated on input
 .trin \char174\rg
 .trin \char175\a-
 .\" 0xB0
@@ -106,4 +128,11 @@
 .trin \char253\'y
 .trin \char254\Tp
 .trin \char255\:y
-.cp \n_C
+.cp \n*groff_latin9_tmac_C
+.do rr *groff_latin9_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/lbp.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/lbp.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/lj4.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/lj4.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/man.local -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/man.local Changed

@@ -1,4 +1,31 @@
-.\" -*- nroff -*-
+.\" This file is loaded by an.tmac.
 .\"
-.\" This file is loaded after an-old.tmac.
-.\" Put any local modifications to an-old.tmac here.
+.\" Put local modifications to groff_man(7)'s behavior here.
+.\"
+.\" Change "0" to "1" to enable OSC 8 links on SGR-capable grotty(1)
+.\" output devices.
+.if !'\*.T'html' \
+.  if !r U \
+.    nr U 0
+.\"
+.\" "CW" is not a portable font name, but some man pages use it anyway.
+.\" Uncomment this to suppress warnings produced by such pages.  This
+.\" test remaps the font to roman ("R") on nroff (terminal) devices. You
+.\" might prefer to remap it to bold ("B") instead.
+.\" .if n .ftr CW R
+.\"
+.\" A de facto standard URL format for man pages is recognized
+.\" everywhere except Apple, where different macOS applications expect
+.\" different formats.
+.\"   1: man:groff(1)          -- package default
+.\"   2: x-man-page://1/groff  -- macOS/Mac OS X since 10.3 (Panther)
+.\"   3: man:groff.1           -- Bwana (Mac OS X)
+.\"   4: x-man-doc://1/groff   -- ManOpen (Mac OS X pre-2005)
+.\" Set this register to configure which the `MR` macro uses.
+.\" .nr an*MR-URL-format 1
+.\"
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/man.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/man.tmac Changed

_service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc Added

_service:tar_scm:groff-1.22.4.tar.gz/tmac/mdoc.local -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc.local Changed

_service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc/doc-common Added

@@ -0,0 +1,1729 @@
+.\" Copyright (c) 1991, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc-common	8.1 (Berkeley) 06/08/93
+.
+.
+.\" Macro Identifiers.  For each user macro a corresponding register
+.\" with the same name must exist.  Its value must not be zero.
+.
+.nr %A 1
+.nr %B 1
+.nr %C 1
+.nr %D 1
+.nr %I 1
+.nr %J 1
+.nr %N 1
+.nr %O 1
+.nr %P 1
+.nr %Q 1
+.nr %R 1
+.nr %T 1
+.nr %U 1
+.nr %V 1
+.nr Ac 3
+.nr Ad 12n
+.nr An 12n
+.nr Ao 12n
+.nr Ap 2
+.nr Aq 12n
+.nr Ar 12n
+.nr At 1
+.nr Bc 3
+.nr Bf 8n\" ?
+.nr Bk 8n\" ?
+.nr Bl 1
+.nr Bo 12n
+.nr Bq 12n
+.nr Brc 3
+.nr Bro 12n
+.nr Brq 12n
+.nr Bsx 1
+.nr Bt 8n\" ?
+.nr Bx 1
+.nr Cd 12n
+.nr Cm 10n
+.nr D1 8n\" ?
+.nr Dc 3
+.nr Dl 8n\" ?
+.nr Dt 8n\" ?
+.nr Do 12n
+.nr Dq 12n
+.nr Ds 6n\" many manpages still use this as a -width value
+.nr Dv 12n
+.nr Dx 1
+.nr Ec 3
+.nr Ef 8n\" ?
+.nr Ek 8n\" ?
+.nr El 1
+.nr Em 10n
+.nr En 12n
+.nr Eo 12n
+.nr Eq 12n
+.nr Er 17n
+.nr Es 12n
+.nr Ev 15n
+.nr Ex 1
+.nr Fa 12n
+.nr Fc 3
+.nr Fd 12n\" ?
+.nr Fl 10n
+.nr Fn 16n
+.nr Fo 16n
+.nr Fr 12n\" ?
+.nr Ft 8n\" ?
+.nr Fx 1
+.nr Ic 10n
+.nr In 12n
+.nr It 8n\" ?
+.nr Lb 11n
+.nr Li 16n
+.nr Lk 6n\" ?
+.nr Lp 8n\" ?
+.nr Me 6n
+.nr Ms 6n
+.nr Mt 6n\" ?
+.nr Nd 8n\" ?
+.nr Nm 10n
+.nr No 12n
+.nr Ns 2
+.nr Nx 1
+.nr Oc 3
+.nr Oo 10n
+.nr Op 14n
+.nr Os 6n\" ?
+.nr Ox 1
+.nr Pa 32n
+.nr Pc 3
+.nr Pf 12n
+.nr Po 12n
+.nr Pp 8n\" ?
+.nr Pq 12n
+.nr Qc 3
+.nr Ql 16n
+.nr Qo 12n
+.nr Qq 12n
+.nr Rv 1
+.nr Sc 3
+.nr Sh 8n
+.nr Sm 8n\" ?
+.nr So 12n
+.nr Sq 12n
+.nr Ss 8n
+.nr St 8n\" ?
+.nr Sx 16n
+.nr Sy 6n
+.nr Ta 2
+.nr Tn 10n
+.nr Ud 8n\" ?
+.nr Ux 1
+.nr Va 12n
+.nr Vt 8n\" ?
+.nr Xc 3
+.nr Xo 1
+.nr Xr 10n
+.
+.
+.\" macros which must be processed after the closing delimiter of 'Op'
+.\" and friends
+.ds doc-after-Ao
+.ds doc-after-Bo
+.ds doc-after-Bro
+.ds doc-after-Do
+.ds doc-after-Eo
+.ds doc-after-Fo
+.ds doc-after-Ns
+.ds doc-after-Oo
+.ds doc-after-Po
+.ds doc-after-Qo
+.ds doc-after-So
+.ds doc-after-Xo
+.
+.
+.nr doc-display-indent 6n
+.
+.
+.\" space strings
+.
+.ds doc-soft-space " \"
+.ds doc-hard-space \~
+.ds doc-tab \t
+.
+.
+.\" punctuation values (suffix=3, prefix=4)
+.
+.nr doc-punct. 3
+.nr doc-punct, 3
+.nr doc-punct: 3
+.nr doc-punct; 3
+.nr doc-punct( 4
+.nr doc-punct) 3
+.nr doc-punct 4
+.nr doc-punct 3
+.nr doc-punct? 3
+.nr doc-punct! 3
+.
+.
+.\" Define alternate requests to handle continuous rendering.
+.\"
+.\" This .ne replacement avoids page breaks; instead, the page length is
+.\" increased to the necessary amount (this is needed for tables).
+.
+.eo
+.de doc-ne
+.  ie \n.$ .nr doc-amount (v;\$*)
+.  el        .nr doc-amount 1v
+.  if (\ndoc-amount >= \n.t) \
+.    pl +(\ndoc-amountu - \n.tu + 1v)
+.  rr doc-amount
+..
+.ec
+.
+.\" This .bp replacement for continuous rendering mode adjusts the page
+.\" length to the current position so that no empty lines are inserted.
+.
+.eo
+.de doc-bp
+.  pl \nnlu
+..
+.ec
+.
+.
+.\" NS doc-set-up-continuous-rendering
+.\"   Move macros into place for continuous rendering.  An end-of-input
+.\"   macro is set up by doc-set-up-titles.
+.de doc-set-up-continuous-rendering
+.  rn ne doc-real-ne
+.  rn bp doc-real-bp
+.  rn doc-ne ne
+.  rn doc-bp bp
+..
+.
+.if \ncR \
+.  doc-set-up-continuous-rendering
+.
+.
+.\" header assembly macros
+.
+.\" NS doc-page-topic global string
+.\" NS   the title of the manual page
+.
+.ds doc-page-topic UNTITLED\"
+.
+.
+.\" NS doc-volume global string
+.\" NS   the volume to which the manual page belongs
+.
+.ds doc-volume LOCAL\"
+.
+.
+.\" NS doc-section global string
+.\" NS   the manual section (1, 2, 3, ..., 3perl, 9)
+.
+.ds doc-section \" empty
+.
+.
+.\" NS doc-set-up-titles macro
+.\" NS   install and initialize header and footer support
+.\" NS
+.\" NS local variables:
+.\" NS   doc-footer-location
+.
+.eo
+.de doc-set-up-titles
+.  br
+.
+.  if !\ncR \{\
+.    wh 0 doc-header
+.    ie r FT .nr doc-footer-location \nFT
+.    el      .nr doc-footer-location (-.5i)
+.    wh \ndoc-footer-locationu doc-footer
+.    wh (\ndoc-footer-locationu - .5i) doc-break-body-text
+.    rr doc-footer-location
+.  \}
+.
+.  e@ doc-end-macro
+..
+.ec
+.
+.
+.\" NS doc-date-string global string
+.\" NS   the manual page date as set by 'Dd'
+.
+.ds doc-date-string UNDATED\"
+.
+.
+.\" NS Dd user macro (not parsed, not callable)
+.\" NS   set document date
+.\" NS
+.\" NS modifies:
+.\" NS   doc-date-string
+.\" NS
+.\" NS width register 'Dd' set above
+.
+.eo
+.de Dd
+.  \" If batch processing (rendering multiple) man page documents, we
+.  \" must handle the end of a previous document.
+.  \"
+.  \" If also continuously rendering, cause a page transition to a new
+.  \" mdoc(7) document.
+.  if \ndoc-need-titles-reset \{\
+.    if \ncR .doc-end-macro
+.
+.    \" Clear the page header trap so it is not sprung with stale
+.    \" information.
+.    ch doc-header
+.    doc-break-page-with-new-number
+.  \}
+.  if \nC .rr P
+.
+.  if !\n.$ \
+.    tm mdoc warning: .Dd directive expects an argument (#\n.c)
+.  if \n.$ \{\
+.    ie "\$1"$Mdocdate:" .ds doc-date-string \$2\~\$3, \$4\"
+.    el                  .ds doc-date-string \$*\"
+.  \}
+..
+.ec
+.
+.
+.\" NS Dt user macro (not parsed, not callable)
+.\" NS   document title
+.\" NS
+.\" NS modifies:
+.\" NS   doc-page-topic
+.\" NS   doc-section
+.\" NS   doc-volume
+.\" NS
+.\" NS local variables:
+.\" NS   doc-volume-as-XXX
+.\" NS   doc-volume-ds-XXX
+.\" NS
+.\" NS width register 'Dt' set above
+.
+.\" an alternative, more detailed scheme for naming the manual sections
+.\"
+.ds doc-volume-ds-1 General Commands Manual
+.ds doc-volume-ds-2 System Calls Manual
+.ds doc-volume-ds-3 Library Functions Manual
+.ds doc-volume-ds-4 Kernel Interfaces Manual
+.ds doc-volume-ds-5 File Formats Manual
+.ds doc-volume-ds-6 Games Manual
+.ds doc-volume-ds-7 Miscellaneous Information Manual
+.ds doc-volume-ds-8 System Manager's Manual
+.ds doc-volume-ds-9 Kernel Developer's Manual
+.
+.ds doc-volume-ds-USD   User's Supplementary Documents
+.ds doc-volume-ds-PS1   Programmer's Supplementary Documents
+.ds doc-volume-ds-AMD   Ancestral Manual Documents
+.ds doc-volume-ds-SMM   System Manager's Manual
+.ds doc-volume-ds-URM   User's Reference Manual
+.ds doc-volume-ds-PRM   Programmer's Manual
+.ds doc-volume-ds-KM    Kernel Manual
+.ds doc-volume-ds-IND   Manual Master Index
+.ds doc-volume-ds-LOCAL Local Manual
+.ds doc-volume-ds-CON   Contributed Software Manual
+.
+.als doc-volume-ds-MMI doc-volume-ds-IND
+.als doc-volume-ds-LOC doc-volume-ds-LOCAL
+.
+.ds doc-volume-as-alpha        alpha
+.als doc-volume-as-Alpha doc-volume-as-alpha
+.ds doc-volume-as-acorn26      acorn26
+.ds doc-volume-as-acorn32      acorn32
+.ds doc-volume-as-algor        algor
+.ds doc-volume-as-amd64        amd64
+.ds doc-volume-as-amiga        amiga
+.ds doc-volume-as-amigappc     amigappc
+.ds doc-volume-as-arc          arc
+.ds doc-volume-as-arm          arm
+.ds doc-volume-as-arm26        arm26
+.ds doc-volume-as-arm32        arm32
+.ds doc-volume-as-armish       armish
+.ds doc-volume-as-atari        atari
+.ds doc-volume-as-aviion       aviion
+.ds doc-volume-as-beagle       beagle
+.ds doc-volume-as-bebox        bebox
+.ds doc-volume-as-cats         cats
+.ds doc-volume-as-cesfic       cesfic
+.ds doc-volume-as-cobalt       cobalt
+.ds doc-volume-as-dreamcast    dreamcast
+.ds doc-volume-as-emips        emips
+.ds doc-volume-as-evbarm       evbarm
+.ds doc-volume-as-evbmips      evbmips
+.ds doc-volume-as-evbppc       evbppc
+.ds doc-volume-as-evbsh3       evbsh3
+.ds doc-volume-as-ews4800mips  ews4800mips
+.ds doc-volume-as-hp300        hp300
+.ds doc-volume-as-hp700        hp700
+.ds doc-volume-as-hpcarm       hpcarm
+.ds doc-volume-as-hpcmips      hpcmips
+.ds doc-volume-as-hpcsh        hpcsh
+.ds doc-volume-as-hppa         hppa
+.ds doc-volume-as-hppa64       hppa64
+.ds doc-volume-as-i386         i386
+.ds doc-volume-as-ia64         ia64
+.ds doc-volume-as-ibmnws       ibmnws
+.ds doc-volume-as-iyonix       iyonix
+.ds doc-volume-as-landisk      landisk
+.ds doc-volume-as-loongson     loongson
+.ds doc-volume-as-luna68k      luna68k
+.ds doc-volume-as-luna88k      luna88k
+.ds doc-volume-as-m68k         m68k
+.ds doc-volume-as-mac68k       mac68k
+.ds doc-volume-as-macppc       macppc
+.ds doc-volume-as-mips         mips
+.ds doc-volume-as-mips64       mips64
+.ds doc-volume-as-mipsco       mipsco
+.ds doc-volume-as-mmeye        mmeye
+.ds doc-volume-as-mvme68k      mvme68k
+.ds doc-volume-as-mvme88k      mvme88k
+.ds doc-volume-as-mvmeppc      mvmeppc
+.ds doc-volume-as-netwinder    netwinder
+.ds doc-volume-as-news68k      news68k
+.ds doc-volume-as-newsmips     newsmips
+.ds doc-volume-as-next68k      next68k
+.ds doc-volume-as-ofppc        ofppc
+.ds doc-volume-as-palm         palm
+.ds doc-volume-as-pc532        pc532
+.ds doc-volume-as-playstation2 playstation2
+.ds doc-volume-as-pmax         pmax
+.ds doc-volume-as-pmppc        pmppc
+.ds doc-volume-as-powerpc      powerpc
+.ds doc-volume-as-prep         prep
+.ds doc-volume-as-rs6000       rs6000
+.ds doc-volume-as-sandpoint    sandpoint
+.ds doc-volume-as-sbmips       sbmips
+.ds doc-volume-as-sgi          sgi
+.ds doc-volume-as-sgimips      sgimips
+.ds doc-volume-as-sh3          sh3
+.ds doc-volume-as-shark        shark
+.ds doc-volume-as-socppc       socppc
+.ds doc-volume-as-solbourne    solbourne
+.ds doc-volume-as-sparc        sparc
+.ds doc-volume-as-sparc64      sparc64
+.ds doc-volume-as-sun2         sun2
+.ds doc-volume-as-sun3         sun3
+.ds doc-volume-as-tahoe        tahoe
+.ds doc-volume-as-vax          vax
+.ds doc-volume-as-x68k         x68k
+.ds doc-volume-as-x86_64       x86_64
+.ds doc-volume-as-xen          xen
+.ds doc-volume-as-zaurus       zaurus
+.
+.eo
+.de Dt
+.  if !\n.$ \
+.    tm mdoc warning: .Dt directive expects one or more arguments \
+(#\n.c)
+.  if !"\$1"" \
+.    ds doc-page-topic "\$1
+.
+.  if \nCT \
+.    stringup doc-page-topic
+.
+.  if !"\$2"" \{\
+.    ds doc-section \$2
+.    ie \B'\$2' \{\
+.      if ((\$2 >= 1) & (\$2 <= 9)) \{\
+.        ds doc-volume \" empty (not "LOCAL")
+.        if \A'\$3' \{\
+.          if d doc-volume-as-\$3 \
+.            as doc-volume "\*doc-volume-as-\$3
+.          \}
+.        as doc-volume " \*doc-volume-ds-\$2
+.      \}
+.    \}
+.    el \{\
+.      ie "\$2"unass" \
+.        ds doc-volume DRAFT
+.      el \{ .ie "\$2"draft" \
+.        ds doc-volume DRAFT
+.      el .if "\$2"paper" \
+.        ds doc-volume UNTITLED
+.      \}
+.   \}
+.   if \A'\$3' \{\
+.     if d doc-volume-ds-\$3 \
+.       ds doc-volume "\*doc-volume-ds-\$3
+.   \}
+. \}
+.
+.  if !"\$3"" \
+.    if "\*doc-volume"LOCAL" \
+.      ds doc-volume \$3
+..
+.ec
+.
+.
+.\" NS doc-default-operating-system global string
+.\" NS   the default OS to associate with man pages
+.\" NS
+.\" NS override this in 'mdoc.local', if necessary
+.
+.ds doc-default-operating-system GNU\"
+.
+.
+.\" NS doc-operating-system global string
+.\" NS   the OS or software project associated with the man page
+.
+.ds doc-operating-system \" empty
+.
+.
+.\" NS Os user macro (not parsed, not callable)
+.\" NS   operating system
+.\" NS
+.\" NS modifies:
+.\" NS   doc-operating-system
+.\" NS
+.\" NS local variables:
+.\" NS   doc-operating-system-XXX-XXX
+.\" NS
+.\" NS width register 'Os' set above
+.
+.ds doc-operating-system-ATT-7   7th\~Edition
+.als doc-operating-system-ATT-7th doc-operating-system-ATT-7
+.ds doc-operating-system-ATT-3   System\~III
+.als doc-operating-system-ATT-III doc-operating-system-ATT-3
+.ds doc-operating-system-ATT-V   System\~V
+.ds doc-operating-system-ATT-V.2 System\~V Release\~2
+.ds doc-operating-system-ATT-V.3 System\~V Release\~3
+.ds doc-operating-system-ATT-V.4 System\~V Release\~4
+.
+.ds doc-operating-system-BSD-3    3rd\~Berkeley Distribution
+.ds doc-operating-system-BSD-4    4th\~Berkeley Distribution
+.ds doc-operating-system-BSD-4.1  4.1\~Berkeley Distribution
+.ds doc-operating-system-BSD-4.2  4.2\~Berkeley Distribution
+.ds doc-operating-system-BSD-4.3  4.3\~Berkeley Distribution
+.ds doc-operating-system-BSD-4.3T 4.3-Tahoe Berkeley Distribution
+.ds doc-operating-system-BSD-4.3R 4.3-Reno Berkeley Distribution
+.als doc-operating-system-BSD-4.3t doc-operating-system-BSD-4.3T
+.als doc-operating-system-BSD-4.3r doc-operating-system-BSD-4.3R
+.ds doc-operating-system-BSD-4.4  4.4BSD
+.
+.ds doc-operating-system-NetBSD-0.8   0.8
+.ds doc-operating-system-NetBSD-0.8a  0.8A
+.ds doc-operating-system-NetBSD-0.9   0.9
+.ds doc-operating-system-NetBSD-0.9a  0.9A
+.ds doc-operating-system-NetBSD-1.0   1.0
+.ds doc-operating-system-NetBSD-1.0a  1.0A
+.ds doc-operating-system-NetBSD-1.1   1.1
+.ds doc-operating-system-NetBSD-1.2   1.2
+.ds doc-operating-system-NetBSD-1.2a  1.2A
+.ds doc-operating-system-NetBSD-1.2b  1.2B
+.ds doc-operating-system-NetBSD-1.2c  1.2C
+.ds doc-operating-system-NetBSD-1.2d  1.2D
+.ds doc-operating-system-NetBSD-1.2e  1.2E
+.ds doc-operating-system-NetBSD-1.3   1.3
+.ds doc-operating-system-NetBSD-1.3a  1.3A
+.ds doc-operating-system-NetBSD-1.4   1.4
+.ds doc-operating-system-NetBSD-1.4.1 1.4.1
+.ds doc-operating-system-NetBSD-1.4.2 1.4.2
+.ds doc-operating-system-NetBSD-1.4.3 1.4.3
+.ds doc-operating-system-NetBSD-1.5   1.5
+.ds doc-operating-system-NetBSD-1.5.1 1.5.1
+.ds doc-operating-system-NetBSD-1.5.2 1.5.2
+.ds doc-operating-system-NetBSD-1.5.3 1.5.3
+.ds doc-operating-system-NetBSD-1.6   1.6
+.ds doc-operating-system-NetBSD-1.6.1 1.6.1
+.ds doc-operating-system-NetBSD-1.6.2 1.6.2
+.ds doc-operating-system-NetBSD-1.6.3 1.6.3
+.ds doc-operating-system-NetBSD-2.0   2.0
+.ds doc-operating-system-NetBSD-2.0.1 2.0.1
+.ds doc-operating-system-NetBSD-2.0.2 2.0.2
+.ds doc-operating-system-NetBSD-2.0.3 2.0.3
+.ds doc-operating-system-NetBSD-2.1   2.1
+.ds doc-operating-system-NetBSD-3.0   3.0
+.ds doc-operating-system-NetBSD-3.0.1 3.0.1
+.ds doc-operating-system-NetBSD-3.0.2 3.0.2
+.ds doc-operating-system-NetBSD-3.0.3 3.0.3
+.ds doc-operating-system-NetBSD-3.1   3.1
+.ds doc-operating-system-NetBSD-3.1.1 3.1.1
+.ds doc-operating-system-NetBSD-4.0   4.0
+.ds doc-operating-system-NetBSD-4.0.1 4.0.1
+.ds doc-operating-system-NetBSD-5.0   5.0
+.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.1.4 5.1.4
+.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-5.2.2 5.2.2
+.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.0.4 6.0.4
+.ds doc-operating-system-NetBSD-6.0.5 6.0.5
+.ds doc-operating-system-NetBSD-6.0.6 6.0.6
+.ds doc-operating-system-NetBSD-6.1   6.1
+.ds doc-operating-system-NetBSD-6.1.1 6.1.1
+.ds doc-operating-system-NetBSD-6.1.2 6.1.2
+.ds doc-operating-system-NetBSD-6.1.3 6.1.3
+.ds doc-operating-system-NetBSD-6.1.4 6.1.4
+.ds doc-operating-system-NetBSD-6.1.5 6.1.5
+.ds doc-operating-system-NetBSD-7.0   7.0
+.ds doc-operating-system-NetBSD-7.0.1 7.0.1
+.ds doc-operating-system-NetBSD-7.0.2 7.0.2
+.ds doc-operating-system-NetBSD-7.1   7.1
+.ds doc-operating-system-NetBSD-7.1.1 7.1.1
+.ds doc-operating-system-NetBSD-7.1.2 7.1.2
+.ds doc-operating-system-NetBSD-7.2   7.2
+.ds doc-operating-system-NetBSD-8.0   8.0
+.ds doc-operating-system-NetBSD-8.1   8.1
+.
+.ds doc-operating-system-OpenBSD-2.0  2.0
+.ds doc-operating-system-OpenBSD-2.1  2.1
+.ds doc-operating-system-OpenBSD-2.2  2.2
+.ds doc-operating-system-OpenBSD-2.3  2.3
+.ds doc-operating-system-OpenBSD-2.4  2.4
+.ds doc-operating-system-OpenBSD-2.5  2.5
+.ds doc-operating-system-OpenBSD-2.6  2.6
+.ds doc-operating-system-OpenBSD-2.7  2.7
+.ds doc-operating-system-OpenBSD-2.8  2.8
+.ds doc-operating-system-OpenBSD-2.9  2.9
+.ds doc-operating-system-OpenBSD-3.0  3.0
+.ds doc-operating-system-OpenBSD-3.1  3.1
+.ds doc-operating-system-OpenBSD-3.2  3.2
+.ds doc-operating-system-OpenBSD-3.3  3.3
+.ds doc-operating-system-OpenBSD-3.4  3.4
+.ds doc-operating-system-OpenBSD-3.5  3.5
+.ds doc-operating-system-OpenBSD-3.6  3.6
+.ds doc-operating-system-OpenBSD-3.7  3.7
+.ds doc-operating-system-OpenBSD-3.8  3.8
+.ds doc-operating-system-OpenBSD-3.9  3.9
+.ds doc-operating-system-OpenBSD-4.0  4.0
+.ds doc-operating-system-OpenBSD-4.1  4.1
+.ds doc-operating-system-OpenBSD-4.2  4.2
+.ds doc-operating-system-OpenBSD-4.3  4.3
+.ds doc-operating-system-OpenBSD-4.4  4.4
+.ds doc-operating-system-OpenBSD-4.5  4.5
+.ds doc-operating-system-OpenBSD-4.6  4.6
+.ds doc-operating-system-OpenBSD-4.7  4.7
+.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-OpenBSD-5.5  5.5
+.ds doc-operating-system-OpenBSD-5.6  5.6
+.ds doc-operating-system-OpenBSD-5.7  5.7
+.ds doc-operating-system-OpenBSD-5.8  5.8
+.ds doc-operating-system-OpenBSD-5.9  5.9
+.ds doc-operating-system-OpenBSD-6.0  6.0
+.ds doc-operating-system-OpenBSD-6.1  6.1
+.ds doc-operating-system-OpenBSD-6.2  6.2
+.ds doc-operating-system-OpenBSD-6.3  6.3
+.ds doc-operating-system-OpenBSD-6.4  6.4
+.ds doc-operating-system-OpenBSD-6.5  6.5
+.ds doc-operating-system-OpenBSD-6.6  6.6
+.
+.ds doc-operating-system-FreeBSD-1.0     1.0
+.ds doc-operating-system-FreeBSD-1.1     1.1
+.ds doc-operating-system-FreeBSD-1.1.5   1.1.5
+.ds doc-operating-system-FreeBSD-1.1.5.1 1.1.5.1
+.ds doc-operating-system-FreeBSD-2.0     2.0
+.ds doc-operating-system-FreeBSD-2.0.5   2.0.5
+.ds doc-operating-system-FreeBSD-2.1     2.1
+.ds doc-operating-system-FreeBSD-2.1.5   2.1.5
+.ds doc-operating-system-FreeBSD-2.1.6   2.1.6
+.ds doc-operating-system-FreeBSD-2.1.7   2.1.7
+.ds doc-operating-system-FreeBSD-2.2     2.2
+.ds doc-operating-system-FreeBSD-2.2.1   2.2.1
+.ds doc-operating-system-FreeBSD-2.2.2   2.2.2
+.ds doc-operating-system-FreeBSD-2.2.5   2.2.5
+.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
+.ds doc-operating-system-FreeBSD-3.3     3.3
+.ds doc-operating-system-FreeBSD-3.4     3.4
+.ds doc-operating-system-FreeBSD-3.5     3.5
+.ds doc-operating-system-FreeBSD-4.0     4.0
+.ds doc-operating-system-FreeBSD-4.1     4.1
+.ds doc-operating-system-FreeBSD-4.1.1   4.1.1
+.ds doc-operating-system-FreeBSD-4.2     4.2
+.ds doc-operating-system-FreeBSD-4.3     4.3
+.ds doc-operating-system-FreeBSD-4.4     4.4
+.ds doc-operating-system-FreeBSD-4.5     4.5
+.ds doc-operating-system-FreeBSD-4.6     4.6
+.ds doc-operating-system-FreeBSD-4.6.2   4.6.2
+.ds doc-operating-system-FreeBSD-4.7     4.7
+.ds doc-operating-system-FreeBSD-4.8     4.8
+.ds doc-operating-system-FreeBSD-4.9     4.9
+.ds doc-operating-system-FreeBSD-4.10    4.10
+.ds doc-operating-system-FreeBSD-4.11    4.11
+.ds doc-operating-system-FreeBSD-5.0     5.0
+.ds doc-operating-system-FreeBSD-5.1     5.1
+.ds doc-operating-system-FreeBSD-5.2     5.2
+.ds doc-operating-system-FreeBSD-5.2.1   5.2.1
+.ds doc-operating-system-FreeBSD-5.3     5.3
+.ds doc-operating-system-FreeBSD-5.4     5.4
+.ds doc-operating-system-FreeBSD-5.5     5.5
+.ds doc-operating-system-FreeBSD-6.0     6.0
+.ds doc-operating-system-FreeBSD-6.1     6.1
+.ds doc-operating-system-FreeBSD-6.2     6.2
+.ds doc-operating-system-FreeBSD-6.3     6.3
+.ds doc-operating-system-FreeBSD-6.4     6.4
+.ds doc-operating-system-FreeBSD-7.0     7.0
+.ds doc-operating-system-FreeBSD-7.1     7.1
+.ds doc-operating-system-FreeBSD-7.2     7.2
+.ds doc-operating-system-FreeBSD-7.3     7.3
+.ds doc-operating-system-FreeBSD-7.4     7.4
+.ds doc-operating-system-FreeBSD-8.0     8.0
+.ds doc-operating-system-FreeBSD-8.1     8.1
+.ds doc-operating-system-FreeBSD-8.2     8.2
+.ds doc-operating-system-FreeBSD-8.3     8.3
+.ds doc-operating-system-FreeBSD-8.4     8.4
+.ds doc-operating-system-FreeBSD-9.0     9.0
+.ds doc-operating-system-FreeBSD-9.1     9.1
+.ds doc-operating-system-FreeBSD-9.2     9.2
+.ds doc-operating-system-FreeBSD-9.3     9.3
+.ds doc-operating-system-FreeBSD-10.0    10.0
+.ds doc-operating-system-FreeBSD-10.1    10.1
+.ds doc-operating-system-FreeBSD-10.2    10.2
+.ds doc-operating-system-FreeBSD-10.3    10.3
+.ds doc-operating-system-FreeBSD-10.4    10.4
+.ds doc-operating-system-FreeBSD-11.0    11.0
+.ds doc-operating-system-FreeBSD-11.1    11.1
+.ds doc-operating-system-FreeBSD-11.2    11.2
+.ds doc-operating-system-FreeBSD-11.3    11.3
+.ds doc-operating-system-FreeBSD-12.0    12.0
+.ds doc-operating-system-FreeBSD-12.1    12.1
+.
+.ds doc-operating-system-Darwin-8.0.0  8.0.0
+.ds doc-operating-system-Darwin-8.1.0  8.1.0
+.ds doc-operating-system-Darwin-8.2.0  8.2.0
+.ds doc-operating-system-Darwin-8.3.0  8.3.0
+.ds doc-operating-system-Darwin-8.4.0  8.4.0
+.ds doc-operating-system-Darwin-8.5.0  8.5.0
+.ds doc-operating-system-Darwin-8.6.0  8.6.0
+.ds doc-operating-system-Darwin-8.7.0  8.7.0
+.ds doc-operating-system-Darwin-8.8.0  8.8.0
+.ds doc-operating-system-Darwin-8.9.0  8.9.0
+.ds doc-operating-system-Darwin-8.10.0 8.10.0
+.ds doc-operating-system-Darwin-8.11.0 8.11.0
+.ds doc-operating-system-Darwin-9.0.0  9.0.0
+.ds doc-operating-system-Darwin-9.1.0  9.1.0
+.ds doc-operating-system-Darwin-9.2.0  9.2.0
+.ds doc-operating-system-Darwin-9.3.0  9.3.0
+.ds doc-operating-system-Darwin-9.4.0  9.4.0
+.ds doc-operating-system-Darwin-9.5.0  9.5.0
+.ds doc-operating-system-Darwin-9.6.0  9.6.0
+.ds doc-operating-system-Darwin-9.7.0  9.7.0
+.ds doc-operating-system-Darwin-9.8.0  9.8.0
+.ds doc-operating-system-Darwin-10.0.0 10.0.0
+.ds doc-operating-system-Darwin-10.1.0 10.1.0
+.ds doc-operating-system-Darwin-10.2.0 10.2.0
+.ds doc-operating-system-Darwin-10.3.0 10.3.0
+.ds doc-operating-system-Darwin-10.4.0 10.4.0
+.ds doc-operating-system-Darwin-10.5.0 10.5.0
+.ds doc-operating-system-Darwin-10.6.0 10.6.0
+.ds doc-operating-system-Darwin-10.7.0 10.7.0
+.ds doc-operating-system-Darwin-10.8.0 10.8.0
+.ds doc-operating-system-Darwin-11.0.0 11.0.0
+.ds doc-operating-system-Darwin-11.1.0 11.1.0
+.ds doc-operating-system-Darwin-11.2.0 11.2.0
+.ds doc-operating-system-Darwin-11.3.0 11.3.0
+.ds doc-operating-system-Darwin-11.4.0 11.4.0
+.ds doc-operating-system-Darwin-11.5.0 11.5.0
+.ds doc-operating-system-Darwin-12.0.0 12.0.0
+.ds doc-operating-system-Darwin-12.1.0 12.1.0
+.ds doc-operating-system-Darwin-12.2.0 12.2.0
+.ds doc-operating-system-Darwin-13.0.0 13.0.0
+.ds doc-operating-system-Darwin-13.1.0 13.1.0
+.ds doc-operating-system-Darwin-13.2.0 13.2.0
+.ds doc-operating-system-Darwin-13.3.0 13.3.0
+.ds doc-operating-system-Darwin-13.4.0 13.4.0
+.ds doc-operating-system-Darwin-14.0.0 14.0.0
+.ds doc-operating-system-Darwin-14.1.0 14.1.0
+.ds doc-operating-system-Darwin-14.2.0 14.2.0
+.ds doc-operating-system-Darwin-14.3.0 14.3.0
+.ds doc-operating-system-Darwin-14.4.0 14.4.0
+.ds doc-operating-system-Darwin-14.5.0 14.5.0
+.ds doc-operating-system-Darwin-15.0.0 15.0.0
+.ds doc-operating-system-Darwin-15.1.0 15.1.0
+.ds doc-operating-system-Darwin-15.2.0 15.2.0
+.ds doc-operating-system-Darwin-15.3.0 15.3.0
+.ds doc-operating-system-Darwin-15.4.0 15.4.0
+.ds doc-operating-system-Darwin-15.5.0 15.5.0
+.ds doc-operating-system-Darwin-15.6.0 15.6.0
+.ds doc-operating-system-Darwin-16.0.0 16.0.0
+.ds doc-operating-system-Darwin-16.1.0 16.1.0
+.ds doc-operating-system-Darwin-16.2.0 16.2.0
+.ds doc-operating-system-Darwin-16.3.0 16.3.0
+.ds doc-operating-system-Darwin-16.4.0 16.4.0
+.ds doc-operating-system-Darwin-16.5.0 16.5.0
+.ds doc-operating-system-Darwin-16.6.0 16.6.0
+.ds doc-operating-system-Darwin-17.0.0 17.0.0
+.ds doc-operating-system-Darwin-17.1.0 17.1.0
+.ds doc-operating-system-Darwin-17.2.0 17.2.0
+.ds doc-operating-system-Darwin-17.3.0 17.3.0
+.ds doc-operating-system-Darwin-17.4.0 17.4.0
+.ds doc-operating-system-Darwin-17.5.0 17.5.0
+.ds doc-operating-system-Darwin-17.6.0 17.6.0
+.ds doc-operating-system-Darwin-17.7.0 17.7.0
+.ds doc-operating-system-Darwin-18.0.0 18.0.0
+.ds doc-operating-system-Darwin-18.1.0 18.1.0
+.ds doc-operating-system-Darwin-18.2.0 18.2.0
+.ds doc-operating-system-Darwin-18.3.0 18.3.0
+.ds doc-operating-system-Darwin-18.4.0 18.4.0
+.ds doc-operating-system-Darwin-18.5.0 18.5.0
+.ds doc-operating-system-Darwin-18.6.0 18.6.0
+.ds doc-operating-system-Darwin-18.7.0 18.7.0
+.ds doc-operating-system-Darwin-19.0.0 19.0.0
+.ds doc-operating-system-Darwin-19.1.0 19.1.0
+.ds doc-operating-system-Darwin-19.2.0 19.2.0
+.
+.ds doc-operating-system-DragonFly-1.0    1.0
+.ds doc-operating-system-DragonFly-1.1    1.1
+.ds doc-operating-system-DragonFly-1.2    1.2
+.ds doc-operating-system-DragonFly-1.3    1.3
+.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
+.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-2.12   2.12
+.ds doc-operating-system-DragonFly-2.13   2.13
+.ds doc-operating-system-DragonFly-3.0    3.0
+.ds doc-operating-system-DragonFly-3.0.1  3.0.1
+.ds doc-operating-system-DragonFly-3.0.2  3.0.2
+.ds doc-operating-system-DragonFly-3.1    3.1
+.ds doc-operating-system-DragonFly-3.2    3.2
+.ds doc-operating-system-DragonFly-3.2.1  3.2.1
+.ds doc-operating-system-DragonFly-3.2.2  3.2.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.4.1  3.4.1
+.ds doc-operating-system-DragonFly-3.4.2  3.4.2
+.ds doc-operating-system-DragonFly-3.4.3  3.4.3
+.ds doc-operating-system-DragonFly-3.5    3.5
+.ds doc-operating-system-DragonFly-3.6    3.6
+.ds doc-operating-system-DragonFly-3.6.1  3.6.1
+.ds doc-operating-system-DragonFly-3.6.2  3.6.2
+.ds doc-operating-system-DragonFly-3.7    3.7
+.ds doc-operating-system-DragonFly-3.8    3.8
+.ds doc-operating-system-DragonFly-3.8.1  3.8.1
+.ds doc-operating-system-DragonFly-3.8.2  3.8.2
+.ds doc-operating-system-DragonFly-4.0    4.0
+.ds doc-operating-system-DragonFly-4.0.1  4.0.1
+.ds doc-operating-system-DragonFly-4.0.2  4.0.2
+.ds doc-operating-system-DragonFly-4.0.3  4.0.3
+.ds doc-operating-system-DragonFly-4.0.4  4.0.4
+.ds doc-operating-system-DragonFly-4.0.5  4.0.5
+.ds doc-operating-system-DragonFly-4.0.6  4.0.6
+.ds doc-operating-system-DragonFly-4.1    4.1
+.ds doc-operating-system-DragonFly-4.2    4.2
+.ds doc-operating-system-DragonFly-4.2.1  4.2.1
+.ds doc-operating-system-DragonFly-4.2.2  4.2.2
+.ds doc-operating-system-DragonFly-4.2.3  4.2.3
+.ds doc-operating-system-DragonFly-4.2.4  4.2.4
+.ds doc-operating-system-DragonFly-4.3    4.3
+.ds doc-operating-system-DragonFly-4.4    4.4
+.ds doc-operating-system-DragonFly-4.4.1  4.4.1
+.ds doc-operating-system-DragonFly-4.4.2  4.4.2
+.ds doc-operating-system-DragonFly-4.4.3  4.4.3
+.ds doc-operating-system-DragonFly-4.5    4.5
+.ds doc-operating-system-DragonFly-4.6    4.6
+.ds doc-operating-system-DragonFly-4.6.1  4.6.1
+.ds doc-operating-system-DragonFly-4.6.2  4.6.2
+.ds doc-operating-system-DragonFly-4.7    4.7
+.ds doc-operating-system-DragonFly-4.8    4.8
+.ds doc-operating-system-DragonFly-4.8.1  4.8.1
+.ds doc-operating-system-DragonFly-4.9    4.9
+.ds doc-operating-system-DragonFly-5.0    5.0
+.ds doc-operating-system-DragonFly-5.0.1  5.0.1
+.ds doc-operating-system-DragonFly-5.0.2  5.0.2
+.ds doc-operating-system-DragonFly-5.1    5.1
+.ds doc-operating-system-DragonFly-5.2    5.2
+.ds doc-operating-system-DragonFly-5.2.1  5.2.1
+.ds doc-operating-system-DragonFly-5.2.2  5.2.2
+.ds doc-operating-system-DragonFly-5.3    5.3
+.ds doc-operating-system-DragonFly-5.4    5.4
+.ds doc-operating-system-DragonFly-5.4.1  5.4.1
+.ds doc-operating-system-DragonFly-5.4.2  5.4.2
+.ds doc-operating-system-DragonFly-5.4.3  5.4.3
+.ds doc-operating-system-DragonFly-5.5    5.5
+.ds doc-operating-system-DragonFly-5.6    5.6
+.ds doc-operating-system-DragonFly-5.6.1  5.6.1
+.ds doc-operating-system-DragonFly-5.6.2  5.6.2
+.
+.eo
+.de Os
+.  ie "\$1"" \
+.    ds doc-operating-system "\*doc-default-operating-system
+.  el \{ .ie "\$1"ATT" \{\
+.    ds doc-operating-system AT&T
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-ATT-\$2 \
+.        as doc-operating-system " \*doc-operating-system-ATT-\$2
+.      el \
+.        as doc-operating-system " UNIX
+.  \}\}
+.  el \{ .ie "\$1"BSD" \{\
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-BSD-\$2 \
+.        ds doc-operating-system "\*doc-operating-system-BSD-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown BSD version '\$2' (#\n.c)
+.  \}\}
+.  el \{ .ie "\$1"FreeBSD" \{\
+.    ds doc-operating-system FreeBSD
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-FreeBSD-\$2 \
+.        as doc-operating-system \~\*doc-operating-system-FreeBSD-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown FreeBSD version '\$2' (#\n.c)
+.  \}\}
+.  el \{ .ie "\$1"DragonFly" \{\
+.    ds doc-operating-system DragonFly
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-DragonFly-\$2 \
+.        as doc-operating-system \~\*doc-operating-system-DragonFly-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown DragonFly version '\$2' (#\n.c)
+.  \}\}
+.  el \{ .ie "\$1"NetBSD" \{\
+.    ds doc-operating-system NetBSD
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-NetBSD-\$2 \
+.        as doc-operating-system \~\*doc-operating-system-NetBSD-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown NetBSD version '\$2' (#\n.c)
+.  \}\}
+.  el \{ .ie "\$1"OpenBSD" \{\
+.    ds doc-operating-system OpenBSD
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-OpenBSD-\$2 \
+.        as doc-operating-system \~\*doc-operating-system-OpenBSD-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown OpenBSD version '\$2' (#\n.c)
+.  \}\}
+.  el \{ .ie "\$1"Darwin" \{\
+.    ds doc-operating-system Darwin
+.    if \A'\$2' \{\
+.      ie d doc-operating-system-Darwin-\$2 \
+.        as doc-operating-system \~\*doc-operating-system-Darwin-\$2
+.      el \
+.        tm mdoc warning: .Os: Unknown Darwin version '\$2' (#\n.c)
+.  \}\}
+.  el \{\
+.    ds doc-operating-system \$1
+.    if !"\$2"" \
+.      as doc-operating-system " \$2
+.  \}\}\}\}\}\}\}\}
+.
+.  doc-set-up-titles
+.
+.  if '\*.T'pdf' \
+.    pdfbookmark 1 "\*doc-page-topic(\*doc-section)"
+.
+.  doc-header
+.  nr doc-need-titles-reset 1
+..
+.ec
+.
+.
+.\" NS doc-hyphen-flags global register
+.\" NS   the parameter for the '.hy' request
+.ie \nHY \{\
+.  ie \ncR .nr doc-hyphen-flags \n\*locale*hyphenation-mode-base
+.  el        .nr doc-hyphen-flags \n\*locale*hyphenation-mode-trap
+.\}
+.el .nr doc-hyphen-flags 0
+.
+.
+.\" NS doc-header macro
+.\" NS   print page header
+.\" NS
+.\" NS local variables:
+.\" NS   doc-xref
+.\" NS   doc-abbv
+.\" NS   doc-reg-dh
+.\" NS   doc-reg-dh1
+.\" NS   doc-hs-len
+.\" NS   doc-hs-len-prev
+.
+.eo
+.de doc-header
+.  ds doc-xref \*doc-page-topic-font\*doc-page-topic\f\"
+.  as doc-xref \*doc-page-section-font(\*doc-section)\f\"
+.  ds doc-abbv \*doc-page-topic\"
+.  ev doc-env-dh
+.  doc-setup-page-layout
+.  ie \ncR .pl +1v
+.  el        .sp .5i
+.  nr doc-reg-dh \w'\*doc-page-topic-font\*doc-xref\f'
+.  nr doc-reg-dh1 \w'\*doc-volume'
+.  if (\ndoc-reg-dh + \ndoc-reg-dh1 + \ndoc-reg-dh >= \n.lt) \{\
+.    while (\ndoc-reg-dh + \ndoc-reg-dh1 + \ndoc-reg-dh >= \n.lt) \{\
+.      ds doc-xref \*doc-page-topic-font\*doc-abbv\f\"
+.      as doc-xref \*doc-page-section-font(\*doc-section)\f\"
+.      length doc-abbv-len-prev \*doc-abbv
+.      substring doc-abbv 0 -2
+.      length doc-abbv-len \*doc-abbv
+.      nr doc-reg-dh \w'\*doc-page-topic-font\*doc-abbv\|.\|.\|.\f'
+.      \" If header string didn't actually get shorter, stop trying.
+.      if (\ndoc-abbv-len-prev <= \ndoc-abbv-len) \
+.        break
+.    \}
+.    rr doc-abbv-len
+.    rr doc-abbv-len-prev
+.    as doc-abbv \|.\|.\|.
+.  \}
+.  tl '\*doc-xref'\*doc-volume\f'\*doc-xref'
+.  ie \ncR \{\
+.    pl +1v
+.    sp 1v
+.  \}
+.  el .sp |1i
+.  ev
+.  ns
+.  rm doc-xref
+.  rm doc-abbv
+..
+.ec
+.
+.
+.\" NS doc-break-body-text
+.\" NS   Schedule a page break when the next output line is written (not
+.\" NS   called if continuously rendering).
+.de doc-break-body-text
+'  bp
+..
+.
+.
+.\" NS doc-footer macro
+.\" NS   print page footer
+.\"
+.\" NS local variables:
+.\" NS   doc-xref
+.\" NS   doc-page-id
+.
+.eo
+.de doc-footer
+.  ds doc-xref \*doc-page-topic-font\*doc-page-topic\f\"
+.  as doc-xref \*doc-page-section-font(\*doc-section)\f\"
+.  ds doc-page-id \n%
+.  if r X \{\
+.    if (\n% > \nX) \{\
+.      nr doc-page-letter (\n% - \nX)
+.      ds doc-page-id \nX\ndoc-page-letter\"
+.    \}
+.  \}
+.  ev doc-caption-enviroment
+.  doc-setup-page-layout
+.  ie \nD \{\
+.    ie e \
+.      tl '%'\*doc-date-string'\*doc-operating-system'
+.    el \
+.      tl '\*doc-operating-system'\*doc-date-string'\*doc-page-id'
+.  \}
+.  el \{\
+.    ie \ncR \
+.      tl '\*doc-operating-system'\*doc-date-string'\*doc-xref'
+.    el \
+.      tl '\*doc-operating-system'\*doc-date-string'\*doc-page-id'
+.  \}
+.  if !\ncR .bp
+.  ev
+.  rm doc-page-id
+.  rm doc-xref
+..
+.ec
+.
+.
+.\" NS doc-check-depth macro
+.\" NS   check paired macros
+.
+.eo
+.de doc-check-depth
+.  if \ndoc-list-depth \{\
+.    tm mdoc warning: A .Bl directive has no matching .El (#\n.c)
+.    nr doc-list-depth 0
+.  \}
+.  if \ndoc-display-depth \{\
+.    tm mdoc warning: A .Bd directive has no matching .Ed (#\n.c)
+.    nr doc-display-depth 0
+.  \}
+.  if \ndoc-fontmode-depth \{\
+.    tm mdoc warning: A .Bf directive has no matching .Ef (#\n.c)
+.    nr doc-fontmode-depth 0
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-end-macro macro
+.\" NS   finish output
+.\" NS
+.\" NS modifies:
+.\" NS   doc-need-titles-reset
+.
+.eo
+.de doc-end-macro
+.  doc-check-depth
+.
+.  if \ncR \{\
+.    \" We might have a pending output line that is not yet broken, and
+.    \" also be 1v from the bottom of the page.  If we break (or flush)
+.    \" the output line now, the page will get ejected afterward and
+.    \" troff will exit because we're in an end-of-input macro--our
+.    \" footer will never be output.  So, if that is the case, further
+.    \" extend the page length by 1v.
+.    if ((\n.p - \nnl) <= \n.V) .pl +1v
+.    br
+.    pl +1v
+.    sp 1v
+.    doc-footer
+.    \" If we're processing multiple documents and have started a new
+.    \" one, draw a line between this footer and the next header.
+.    if !'\n.F'' \{\
+.      pl +1v
+.      nf
+.      ti 0
+\D'l \ndoc-line-lengthu 0'
+.      fi
+.    \}
+.    \" suppress empty lines after the footer
+.    pl \nnlu
+.  \}
+.  ch doc-header
+.  doc-break-page-with-new-number
+.
+.  \" Reset strings to reduce info leaks from one man page to the next.
+.  ds doc-date-string UNDATED\"
+.  ds doc-page-topic UNTITLED\"
+.  ds doc-volume LOCAL\"
+.  ds doc-section \" empty
+.  ds doc-operating-system \" empty
+.  ds doc-topic-name \" empty
+..
+.ec
+.
+.
+.\" NS doc-break-page-with-new-number macro
+.\" NS   Break the page and update its number depending on the C
+.\" NS   (consecutive numbering) register.
+.\" NS
+.\" NS  Corner case: if formatting multiple documents and P (starting
+.\" NS  page number) is defined but C is not set, start numbering each
+.\" NS  document at \nP.  Not strictly necessary if not switching
+.\" NS  macro packages.
+.
+.eo
+.de doc-break-page-with-new-number
+.  ie \nC .bp (\n% + 1) \" argument NOT redundant before page 1
+.  el \{\
+.    ie r P .bp \nP
+.    el     .bp 1
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-paragraph macro
+.\" NS   insert a paragraph
+.
+.eo
+.de doc-paragraph
+.  sp \ndoc-paragraph-spaceu
+.  if !\ncR \
+.    ne 2
+.  ns
+..
+.ec
+.
+.
+.\" NS Pp user macro (not parsed, not callable)
+.\" NS   new paragraph
+.\" NS
+.\" NS width register 'Pp' set above
+.
+.als Pp doc-paragraph
+.
+.
+.\" NS Lp user macro (not parsed, not callable)
+.\" NS   same as .Pp
+.\" NS
+.\" NS width register 'Lp' set above
+.
+.als Lp doc-paragraph
+.
+.
+.eo
+.de LP
+.  tm Not a \-mdoc command: .LP (#\n.c)
+..
+.ec
+.
+.
+.eo
+.de PP
+.  tm Not a \-mdoc command: .PP (#\n.c)
+..
+.ec
+.
+.
+.eo
+.de pp
+.  tm Not a \-mdoc command: .pp (#\n.c)
+..
+.ec
+.
+.
+.eo
+.de SH
+.  tm Not a \-mdoc command: .SH (#\n.c)
+..
+.ec
+.
+.
+.\" NS Nd user macro (not parsed, not callable)
+.\" NS   print name description
+.\" NS
+.\" NS width register 'Nd' set above
+.
+.eo
+.de Nd
+.  nop \em \$*
+..
+.ec
+.
+.
+.\" NS doc-in-name-section global register (bool)
+.\" NS   whether we are in the 'name' section
+.
+.nr doc-in-name-section 0
+.
+.
+.\" NS doc-in-synopsis-section global register (bool)
+.\" NS   whether we are in the 'synopsis' section
+.
+.nr doc-in-synopsis-section 0
+.
+.
+.\" NS doc-in-library-section global register (bool)
+.\" NS   whether we are in the 'library' section
+.
+.nr doc-in-library-section 0
+.
+.
+.\" NS doc-in-see-also-section global register (bool)
+.\" NS   whether we are in the 'see also' section
+.
+.nr doc-in-see-also-section 0
+.
+.
+.\" NS doc-in-files-section global register (bool)
+.\" NS   whether we are in the 'files' section
+.
+.nr doc-in-files-section 0
+.
+.
+.\" NS doc-in-authors-section global register (bool)
+.\" NS   whether we are in the 'authors' section
+.
+.nr doc-in-authors-section 0
+.
+.
+.\" NS doc-need-titles-reset global register (bool)
+.\" NS   whether the strings that set header and footer text need to be
+.\" NS   reconfigured
+.\" NS
+.\" NS This happens when batch-rendering and starting a new page.
+.
+.nr doc-need-titles-reset 0
+.
+.
+.\" NS doc-first-parameter macro
+.\" NS   return first parameter
+.\" NS
+.\" NS local variables:
+.\" NS   doc-str-dfp
+.
+.eo
+.de doc-first-parameter
+.  ds doc-str-dfp "\$1
+..
+.ec
+.
+.
+.\" NS doc-prepare-section-heading macro
+.\" NS   define `doc-sec-head`, `macro` prepared for string matching
+.\"
+.\" NS
+.\" NS local variables:
+.\" NS   doc-str-tmp1
+.\" NS   doc-str-tmp2
+.\" NS   doc-tmp-strlen
+.
+.eo
+.de doc-prepare-section-heading
+.  ds doc-str-tmp1 "\$*
+.  ds doc-str-tmp2 "\$*
+.  length doc-tmp-strlen \$*
+.  \" Leave (nonstandard) section headings of length 0 or 1 unchanged.
+.  ie \ndoc-tmp-strlen>1 \{\
+.    substring doc-str-tmp1 0 0
+.    substring doc-str-tmp2 1
+.    stringdown doc-str-tmp2
+.    ds doc-sec-head \*doc-str-tmp1\*doc-str-tmp2\"
+.  \}
+.  el \
+.    ds doc-sec-head "\$*
+.  rm doc-str-tmp1
+.  rm doc-str-tmp2
+.  rr doc-tmp-strlen
+..
+.ec
+.
+.
+.\" NS Sh user macro (not callable)
+.\" NS   section headers
+.\" NS
+.\" NS modifies:
+.\" NS   doc-func-args-processed
+.\" NS   doc-func-count
+.\" NS   doc-in-authors-section
+.\" NS   doc-in-files-section
+.\" NS   doc-in-library-section
+.\" NS   doc-in-name-section
+.\" NS   doc-in-see-also-section
+.\" NS   doc-in-synopsis-section
+.\" NS   doc-indent-synopsis
+.\" NS   doc-indent-synopsis-active
+.\" NS   doc-is-func
+.\" NS   doc-num-func-args
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Sh
+.\" NS   doc-reg-Sh1
+.\" NS   doc-section-XXX
+.\" NS
+.\" NS width register 'Sh' set in doc-common
+.
+.ds doc-section-name        Name\"
+.ds doc-section-synopsis    Synopsis\"
+.ds doc-section-library     Library\"
+.ds doc-section-description Description\"
+.ds doc-section-see-also    See also\"
+.ds doc-section-files       Files\"
+.ds doc-section-authors     Authors\"
+.
+.eo
+.de Sh
+.  \" Tell doc-print-recursive whether to force capitalization.
+.  nr doc-do-capitalize \nCS
+.
+.  \" Normalize capitalization of section heading.
+.  doc-prepare-section-heading \$*
+.
+.  ie "\*doc-sec-head"\*doc-section-name" \
+.    nr doc-in-name-section 1
+.  el \
+.    nr doc-in-name-section 0
+.
+.  ie \ndoc-arg-count \{\
+.    \" we only allow 'Sh' within 'Sh'; it will change the font back to
+.    \" 'doc-Sh-font'
+.    ie "\*doc-macro-name"Sh" \{\
+.      nr doc-arg-ptr +1
+.      ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.        nr doc-curr-font \n.f
+.        nop \*doc-Sh-font\c
+.        doc-print-recursive
+.      \}
+.      el \{\
+.        tm Usage: .Sh section_name ... (#\n.c)
+.        doc-reset-args
+.    \}\}
+.    el \{\
+.      tm Usage: .Sh not callable by other macros (#\n.c)
+.      doc-reset-args
+.  \}\}
+.  el \{\
+.    if !\n.$ \{\
+.      tm Usage: .Sh section_name ... (#\n.c)
+.      return
+.    \}
+.
+.    ds doc-macro-name Sh
+.    doc-parse-args \$@
+.
+.    ad \*AD
+.
+.    ie "\*doc-sec-head"\*doc-section-name" \{\
+.      doc-set-up-titles
+.      in 0
+.    \}
+.    el \{\
+.      nr doc-in-name-section 0
+.      nr doc-in-synopsis-section 0
+.      nr doc-in-library-section 0
+.      nr doc-in-see-also-section 0
+.      nr doc-in-files-section 0
+.      nr doc-in-authors-section 0
+.
+.      ie        "\*doc-sec-head"\*doc-section-synopsis" \{\
+.        if t \
+.          na
+.        nr doc-in-synopsis-section 1
+.        nr doc-indent-synopsis 0
+.        nr doc-indent-synopsis-active 0
+.      \}
+.      el \{ .ie "\*doc-sec-head"\*doc-section-library" \{\
+.        nr doc-in-library-section 1
+.      \}
+.      el \{ .ie "\*doc-sec-head"\*doc-section-description" \{\
+.        nr doc-is-func 0
+.        nr doc-func-count 0
+.        nr doc-func-args-processed 0
+.        nr doc-num-func-args 0
+.      \}
+.      el \{ .ie "\*doc-sec-head"\*doc-section-see-also" \{\
+.        if t \
+.          na
+.        nr doc-in-see-also-section 1
+.      \}
+.      el \{ .ie "\*doc-sec-head"\*doc-section-files" \
+.        nr doc-in-files-section 1
+.      el .if    "\*doc-sec-head"\*doc-section-authors" \
+.        nr doc-in-authors-section 1
+.      \}\}\}\}
+.
+.      in 0
+.      nr doc-have-author 0
+.    \}
+.
+.    doc-setup-page-layout
+.    sp \ndoc-paragraph-spaceu
+.    ns
+.    ta T .5i
+.    if !\ncR \
+.      ne 3
+.    fi
+.
+.  if '\*.T'pdf' \
+.    pdfbookmark 2 "\*doc-sec-head"
+.
+.    if t \{\
+.      nr doc-reg-Sh \n.ss
+.      nr doc-reg-Sh1 \n.sss
+.      ss (\n.ss * 5 / 3) (\n.sss * 5 / 3)
+.    \}
+.
+.  if \ndoc-remap-I-style-in-headings \
+.    ftr \*doc-heading-familyI \*doc-heading-familyBI
+.
+.    nr doc-arg-ptr +1
+.    nr doc-curr-font \n.f
+.    nop \*doc-Sh-font\c
+.    doc-print-recursive
+.
+.    if t \
+.      ss \ndoc-reg-Sh \ndoc-reg-Sh1
+.
+.    in \nINu
+.    ns
+.
+.    doc-check-depth
+.  if \ndoc-remap-I-style-in-headings \
+.    ftr \*doc-heading-familyI \*doc-heading-familyI
+.  \}
+.
+.
+.  \" Don't let doc-print-recursive force caps on anything else.
+.  nr doc-do-capitalize 0
+..
+.ec
+.
+.
+.\" NS Ss user macro (not callable)
+.\" NS   subsection
+.\" NS
+.\" NS modifies:
+.\" NS   doc-subsection-heading
+.\" NS
+.\" NS local variable:
+.\" NS   doc-reg-Ss
+.\" NS   doc-reg-Ss1
+.\" NS
+.\" NS width register 'Ss' set above
+.
+.eo
+.de Ss
+.  ie \ndoc-arg-count \{\
+.    \" we only allow 'Ss' within 'Ss'; it will change the font back to
+.    \" 'doc-Sh-font'
+.    ie "\*doc-macro-name"Ss" \{\
+.      nr doc-arg-ptr +1
+.      ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.        nr doc-curr-font \n.f
+.        nop \*doc-Sh-font\c
+.        doc-print-recursive
+.      \}
+.      el \{\
+.        tm Usage: .Ss subsection_name ... (#\n.c)
+.        doc-reset-args
+.    \}\}
+.    el \{\
+.      tm Usage: .Ss not callable by other macros (#\n.c)
+.      doc-reset-args
+.  \}\}
+.  el \{\
+.    if !\n.$ \{\
+.      tm Usage: .Ss subsection_name ... (#\n.c)
+.      return
+.    \}
+.
+.    ds doc-macro-name Ss
+.    doc-parse-args \$@
+.
+.    ds doc-subsection-heading \$*
+.
+.    sp \ndoc-paragraph-spaceu
+.    if !\ncR \
+.      ne 3
+.    in \nSNu
+.
+.    if '\*.T'pdf' \
+.      pdfbookmark 3 "\*doc-subsection-heading"
+.
+.    nr doc-reg-Ss \n.ss
+.    nr doc-reg-Ss1 \n.sss
+.    ss (\n.ss * 5 / 4) (\n.sss * 5 / 4)
+.
+.  if \ndoc-remap-I-style-in-headings \
+.    ftr \*doc-heading-familyI \*doc-heading-familyBI
+.
+.    nr doc-arg-ptr +1
+.    nr doc-curr-font \n.f
+.    nop \*doc-Sh-font\c
+.    doc-print-recursive
+.
+.    ss \ndoc-reg-Ss \ndoc-reg-Ss1
+.
+.    ta T .5i
+.    in
+.    if !\ncR \
+.      ne 2
+.    br
+.    ns
+.
+.    doc-check-depth
+.  if \ndoc-remap-I-style-in-headings \
+.    ftr \*doc-heading-familyI \*doc-heading-familyI
+.  \}
+.
+..
+.ec
+.
+.
+.\" NS Rd macro (not parsed, not callable)
+.\" NS   print global register dump to stderr
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Rd
+.
+.eo
+.de Rd
+.  tm MDOC GLOBAL REGISTER DUMP
+.  tm doc-macro-name == '\*doc-macro-name'
+.  tm doc-arg-count == \ndoc-arg-count
+.  tm doc-num-args == \ndoc-num-args
+.  tm doc-arg-ptr == \ndoc-arg-ptr
+.
+.  nr doc-reg-Rd 1
+.  while (\ndoc-reg-Rd <= \ndoc-arg-count) \{\
+.    tm doc-arg\ndoc-reg-Rd == '\*doc-arg\ndoc-reg-Rd'
+.    tm doc-type\ndoc-reg-Rd == \ndoc-type\ndoc-reg-Rd
+.    tm doc-space\ndoc-reg-Rd == '\*doc-space\ndoc-reg-Rd'
+.    nr doc-reg-Rd +1
+.  \}
+.
+.  tm doc-curr-font == \ndoc-curr-font
+.  tm doc-indent-synopsis == \ndoc-indent-synopsis
+.  tm doc-indent-synopsis-active == \ndoc-indent-synopsis-active
+.  tm doc-have-decl == \ndoc-have-decl
+.  tm doc-have-var == \ndoc-have-var
+.  tm doc-topic-name == '\*doc-topic-name'
+.  tm doc-quote-left == '\*doc-quote-left'
+.  tm doc-quote-right == '\*doc-quote-right'
+.  tm doc-nesting-level == \ndoc-nesting-level
+.  tm doc-in-list == \ndoc-in-list
+.  tm doc-space == '\*doc-space'
+.  tm doc-saved-space == '\*doc-saved-space'
+.  tm doc-space-mode == \ndoc-space-mode
+.  tm doc-have-space == \ndoc-have-space
+.  tm doc-have-slot == \ndoc-have-slot
+.  tm doc-keep-type == \ndoc-keep-type
+.  tm doc-display-depth == \ndoc-display-depth
+.  tm doc-is-compact == \ndoc-is-compact
+.
+.  nr doc-reg-Rd 0
+.  while (\ndoc-reg-Rd <= \ndoc-display-depth) \{\
+.    tm doc-display-type-stack\ndoc-reg-Rd == '\*doc-display-type-stack\ndoc-reg-Rd'
+.    tm doc-display-indent-stack\ndoc-reg-Rd == \ndoc-display-indent-stack\ndoc-reg-Rd
+.    tm doc-display-ad-stack\ndoc-reg-Rd == \ndoc-display-ad-stack\ndoc-reg-Rd
+.    tm doc-display-fi-stack\ndoc-reg-Rd == \ndoc-display-fi-stack\ndoc-reg-Rd
+.    tm doc-display-ft-stack\ndoc-reg-Rd == \ndoc-display-ft-stack\ndoc-reg-Rd
+.    tm doc-display-ps-stack\ndoc-reg-Rd == \ndoc-display-ps-stack\ndoc-reg-Rd
+.    nr doc-reg-Rd +1
+.  \}
+.
+.  tm doc-fontmode-depth == \ndoc-fontmode-depth
+.
+.  nr doc-reg-Rd 1
+.  while (\ndoc-reg-Rd <= \ndoc-fontmode-depth) \{\
+.    tm doc-fontmode-font-stack\ndoc-reg-Rd == '\ndoc-fontmode-font-stack\ndoc-reg-Rd'
+.    tm doc-fontmode-size-stack\ndoc-reg-Rd == '\ndoc-fontmode-size-stack\ndoc-reg-Rd'
+.    nr doc-reg-Rd +1
+.  \}
+.
+.  tm doc-list-depth == \ndoc-list-depth
+.
+.  nr doc-reg-Rd 1
+.  while (\ndoc-reg-Rd <= \ndoc-list-depth) \{\
+.    tm doc-list-type-stack\ndoc-reg-Rd == '\*doc-list-type-stack\ndoc-reg-Rd'
+.    tm doc-list-have-indent-stack\ndoc-reg-Rd == \ndoc-list-have-indent-stack\ndoc-reg-Rd
+.    tm doc-list-indent-stack\ndoc-reg-Rd == \ndoc-list-indent-stack\ndoc-reg-Rd
+.    tm doc-compact-list-stack\ndoc-reg-Rd == \ndoc-compact-list-stack\ndoc-reg-Rd
+.    tm doc-tag-prefix-stack\ndoc-reg-Rd == '\*doc-tag-prefix-stack\ndoc-reg-Rd'
+.    tm doc-tag-width-stack\ndoc-reg-Rd == '\*doc-tag-width-stack\ndoc-reg-Rd'
+.    tm doc-list-offset-stack\ndoc-reg-Rd == \ndoc-list-offset-stack\ndoc-reg-Rd
+.    tm doc-enum-list-count-stack\ndoc-reg-Rd == \ndoc-enum-list-count-stack\ndoc-reg-Rd
+.    nr doc-reg-Rd +1
+.  \}
+.
+.  tm doc-saved-Pa-font == '\*doc-saved-Pa-font'
+.  tm doc-curr-type == \ndoc-curr-type
+.  tm doc-curr-arg == '\*doc-curr-arg'
+.  tm doc-diag-list-input-line-count == \ndoc-diag-list-input-line-count
+.  tm doc-num-columns == \ndoc-num-columns
+.  tm doc-column-indent-width == \ndoc-column-indent-width
+.  tm doc-is-func == \ndoc-is-func
+.  tm doc-have-old-func == \ndoc-have-old-func
+.  tm doc-func-arg-count == \ndoc-func-arg-count
+.  tm doc-func-arg == '\*doc-func-arg'
+.  tm doc-num-func-args == \ndoc-num-func-args
+.  tm doc-func-args-processed == \ndoc-func-args-processed
+.  tm doc-have-func == \ndoc-have-func
+.  tm doc-is-reference == \ndoc-is-reference
+.  tm doc-reference-count == \ndoc-reference-count
+.  tm doc-author-count == \ndoc-author-count
+.
+.  nr doc-reg-Rd 0
+.  while (\ndoc-reg-Rd <= \ndoc-author-count) \{\
+.    tm doc-author-name\ndoc-reg-Rd == '\*doc-author-name\ndoc-reg-Rd'
+.    nr doc-reg-Rd +1
+.  \}
+.
+.  tm doc-book-count == \ndoc-book-count
+.  tm doc-book-name == '\*doc-book-name'
+.  tm doc-date-count == \ndoc-date-count
+.  tm doc-date == '\*doc-date'
+.  tm doc-publisher-count == \ndoc-publisher-count
+.  tm doc-publisher-name == '\*doc-publisher-name'
+.  tm doc-journal-count == \ndoc-journal-count
+.  tm doc-journal-name == '\*doc-journal-name'
+.  tm doc-issue-count == \ndoc-issue-count
+.  tm doc-issue-name == '\*doc-issue-name'
+.  tm doc-optional-count == \ndoc-optional-count
+.  tm doc-optional-string == '\*doc-optional-string'
+.  tm doc-page-number-count == \ndoc-page-number-count
+.  tm doc-page-number-string == '\*doc-page-number-string'
+.  tm doc-corporate-count == \ndoc-corporate-count
+.  tm doc-corporate-name == '\*doc-corporate-name'
+.  tm doc-report-count == \ndoc-report-count
+.  tm doc-report-name == '\*doc-report-name'
+.  tm doc-reference-title-count == \ndoc-reference-title-count
+.  tm doc-reference-title-name == '\*doc-reference-title-name'
+.  tm doc-reference-title-name-for-book == '\*doc-reference-title-name-for-book'
+.  tm doc-url-count == \ndoc-url-count
+.  tm doc-url-name == '\*doc-url-name'
+.  tm doc-volume-count == \ndoc-volume-count
+.  tm doc-volume-name == '\*doc-volume-name'
+.  tm doc-have-author == \ndoc-have-author
+.
+.  tm doc-page-topic == '\*doc-page-topic'
+.  tm doc-volume == '\*doc-volume'
+.  tm doc-section == '\*doc-section'
+.  tm doc-operating-system == '\*doc-operating-system'
+.  tm doc-date-string == '\*doc-date-string'
+.  tm doc-display-vertical == \ndoc-display-vertical
+.  tm doc-in-name-section == \ndoc-in-name-section
+.  tm doc-in-synopsis-section == \ndoc-in-synopsis-section
+.  tm doc-in-library-section == \ndoc-in-library-section
+.  tm doc-in-see-also-section == \ndoc-in-see-also-section
+.  tm doc-in-files-section == \ndoc-in-files-section
+.  tm doc-in-authors-section == \ndoc-in-authors-section
+.
+.  tm END OF GLOBAL REGISTER DUMP
+..
+.ec
+.
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc/doc-ditroff Added

@@ -0,0 +1,287 @@
+.\" Copyright (c) 1991, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc-ditroff	8.1 (Berkeley) 06/08/93
+.
+.
+.\" Use -rS={11,12} to change the font size from 10pt to 11pt or 12pt.
+.if !r S .nr S 10
+.
+.ie        (\nS == 11) \{\
+.  ps 10.95z
+.  vs 13.6p
+.\}
+.el \{ .ie (\nS == 12) \{\
+.  ps 12z
+.  vs 14.5p
+.\}
+.el \{\
+.  ps 10z
+.  vs 12p
+.\}\}
+.
+.
+.\" the 'doc-xx-font' strings must not be empty!
+.
+.ds doc-page-topic-font \fI
+.ds doc-page-section-font \fR
+.ds doc-Ad-font \fI
+.ds doc-Ar-font \fCI
+.ds doc-Cm-font \fCR
+.ds doc-Em-font \fI
+.ds doc-Er-font \fCR
+.ds doc-Ev-font \fCR
+.ds doc-Fa-font \fCI
+.ds doc-Fd-font \fCB
+.ds doc-Fl-font \fCR
+.ds doc-Fn-font \fCB
+.ds doc-Ft-font \fCI
+.ds doc-Ic-font \fCB
+.ds doc-Li-font \fCR
+.ds doc-Lk-font \fR\"
+.ds doc-Me-font \fB
+.ds doc-Nm-font \fCB
+.ds doc-No-font \fR
+.ds doc-Pa-font \fI
+.ds doc-Sh-font \f\*HF\"
+.ds doc-Sy-font \fB
+.ds doc-Tn-font \fR
+.ds doc-Va-font \fI
+.ds doc-Xr-font \fI
+.
+.ds doc-left-parenthesis \fR(\f
+.ds doc-right-parenthesis \fR)\f
+.ds lp \fR(\f
+.ds rp \fR)\f
+.ds doc-left-bracket \fR\f
+.ds doc-right-bracket \fR\f
+.
+.tr *\**
+.
+.\" miscellaneous
+.nr doc-paragraph-space .4v
+.
+.nr doc-digit-width \w'\0'u
+.nr doc-fixed-width \w'\fCR0'
+.
+.
+.\" NS doc-display-vertical global register
+.\" NS   vertical space between list elements etc.
+.
+.nr doc-display-vertical 0
+.
+.
+.\" NS doc-setup-page-layout macro
+.\" NS   set up page layout
+.\" NS
+.\" NS modifies:
+.\" NS   doc-display-vertical
+.\" NS   doc-line-length
+.
+.eo
+.de doc-setup-page-layout
+.  ie r LL \
+.    ll \nLLu
+.  el \
+.    ll \n.lu
+.
+.  ie r LT \
+.    lt \nLTu
+.  el \
+.    lt \n.lu
+.
+.  po 1i
+.
+.  nr doc-display-vertical .5v
+.  nr doc-line-length \n.l
+..
+.ec
+.
+.
+.ds doc-left-singlequote \oq
+.ds doc-right-singlequote \cq
+.
+.\" the following strings are 'official'
+.ds <= \<=
+.ds >= \>=
+.ds Lq \lq
+.ds Rq \rq
+.ds ua \ua
+.ds aa \aa
+.ds ga \ga
+.ds q \dq
+.ds Pi \*p
+.ds Ne \!=
+.ds Le \<=
+.ds Ge \>=
+.ds Lt <
+.ds Gt >
+.ds Pm \+-
+.ds If \if
+.ds Na \fINaN\f
+.ds Ba \fR|\f
+.ds Am &
+.
+.
+.\" NS doc-get-width macro
+.\" NS   computes the width of a string as a multiple of
+.\" NS   'doc-fixed-width': '.doc-get-width string'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-width
+.
+.eo
+.de doc-get-width
+.  nr doc-width \w'\fCR\$1'
+.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
+.    ie (\ndoc-width % \ndoc-fixed-width) \
+.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
+.    el \
+.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
+.  \}
+.  el \{\
+.    ie \ndoc-width \
+.      nr doc-width 1
+.    el \
+.      nr doc-width 0
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-get-arg-width macro
+.\" NS   computes the width of an argument as a multiple of
+.\" NS   'doc-fixed-width': '.doc-get-arg-width arg-index'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-width
+.
+.eo
+.de doc-get-arg-width
+.  nr doc-width \w'\fCR\*doc-arg\$1'
+.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
+.    ie (\ndoc-width % \ndoc-fixed-width) \
+.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
+.    el \
+.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
+.  \}
+.  el \{\
+.    ie \ndoc-width \
+.      nr doc-width 1
+.    el \
+.      nr doc-width 0
+.  \}
+..
+.ec
+.
+.
+.\" NS Ql user macro
+.\" NS   quoted literal define
+.\" NS
+.\" NS modifies:
+.\" NS   doc-argXXX
+.\" NS   doc-arg-count
+.\" NS   doc-arg-ptr
+.\" NS   doc-macro-name
+.\" NS   doc-spaceXXX
+.\" NS   doc-typeXXX
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS local variables:
+.\" NS   doc-reg-Ql
+.\" NS   doc-reg-Ql1
+.\" NS   doc-reg-Ql2
+.\" NS
+.\" NS width register 'Ql' set in doc-common
+.
+.eo
+.de Ql
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Ql
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Ql argument ... (#\n.c)
+.  \}
+.
+.  nr doc-reg-Ql (\ndoc-arg-ptr + 1)
+.  doc-get-arg-width \ndoc-reg-Ql
+.
+.  \" don't use quotes if we have more than two succeeding string
+.  \" arguments
+.  nr doc-reg-Ql +1
+.  if (\ndoc-arg-count >= \ndoc-reg-Ql) \
+.    if (\ndoc-type\ndoc-reg-Ql == 2) \
+.      nr doc-width 3
+.
+.  \" make a difference in quotation style for strings longer
+.  \" than two characters
+.  ie (\ndoc-width > 2) \
+.    Li
+.  el \{\
+.    ie \ndoc-arg-ptr \{\
+.      \" we replace 'Ql' with 'Li'
+.      ds doc-arg\ndoc-arg-ptr Li
+.      nr doc-arg-ptr -1
+.    \}
+.    el \{\
+.      \" if .Ql has been called directly, we must shift all elements in
+.      \" the argument vector to the right so that we can insert 'Li'
+.      nr doc-reg-Ql \ndoc-arg-count
+.      nr doc-reg-Ql1 (\ndoc-arg-count + 1)
+.      while \ndoc-reg-Ql \{\
+.        rn doc-arg\ndoc-reg-Ql doc-arg\ndoc-reg-Ql1
+.        rnn doc-type\ndoc-reg-Ql doc-type\ndoc-reg-Ql1
+.        rn doc-space\ndoc-reg-Ql doc-space\ndoc-reg-Ql1
+.        nr doc-reg-Ql -1
+.        nr doc-reg-Ql1 -1
+.      \}
+.      ds doc-arg1 Li
+.      nr doc-type1 1
+.      ds doc-space1
+.      nr doc-arg-count +1
+.    \}
+.
+.    ds doc-quote-left "\*doc-left-singlequote
+.    ds doc-quote-right "\*doc-right-singlequote
+.    doc-enclose-string
+.  \}
+..
+.ec
+.
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc/doc-nroff Added

@@ -0,0 +1,229 @@
+.\" Copyright (c) 1991, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc-nroff	8.1 (Berkeley) 06/08/93
+.
+.
+.\" nroff devices can't change the type size; this value is notional.
+.nr S 10
+.
+.\" Map monospaced fonts to standard styles.
+.ftr CR R
+.ftr CI I
+.ftr CB B
+.ftr CBI BI
+.
+.\" the 'doc-xx-font' strings must not be empty!
+.
+.ds doc-page-topic-font \fI
+.ds doc-page-section-font \fR
+.ds doc-Ad-font \fI
+.ds doc-Ar-font \fI
+.ds doc-Cm-font \fB
+.ds doc-Em-font \fI
+.ds doc-Er-font \fR
+.ds doc-Ev-font \fR
+.ds doc-Fa-font \fI
+.ds doc-Fd-font \fB
+.ds doc-Fl-font \fB
+.ds doc-Fn-font \fB
+.ds doc-Ft-font \fI
+.ds doc-Ic-font \fB
+.ds doc-Li-font \fB
+.ds doc-Lk-font \fR\"
+.ds doc-Me-font \fB
+.ds doc-Nm-font \fB
+.ds doc-No-font \fR
+.ds doc-Pa-font \fI
+.ds doc-Sh-font \f\*HF\"
+.ds doc-Sy-font \fB
+.ds doc-Tn-font \fR
+.ds doc-Va-font \fI
+.ds doc-Xr-font \fI
+.
+.ds doc-left-parenthesis \fR(\f
+.ds doc-right-parenthesis \fR)\f
+.ds lp \fR(\f
+.ds rp \fR)\f
+.ds doc-left-bracket \fR\f
+.ds doc-right-bracket \fR\f
+.
+.\" miscellaneous
+.nr doc-paragraph-space 1v
+.
+.nr doc-digit-width \w'\0\0'u
+.nr doc-fixed-width \w'0'
+.
+.
+.\" NS doc-display-vertical global register
+.\" NS   vertical space between list elements etc.
+.
+.nr doc-display-vertical 0
+.
+.
+.\" NS doc-setup-page-layout macro
+.\" NS   set up page layout
+.\" NS
+.\" NS modifies:
+.\" NS   doc-display-vertical
+.\" NS   doc-line-length
+.
+.eo
+.de doc-setup-page-layout
+.  ie r LL \
+.    ll \nLLu
+.  el \
+.    ll 78n
+.
+.  ie r LT \
+.    lt \nLTu
+.  el \
+.    lt \n.lu
+.
+.  po 0i
+.
+.  nr doc-display-vertical 1v
+.  nr doc-line-length \n.l
+..
+.ec
+.
+.ds doc-left-singlequote \oq
+.ds doc-right-singlequote \cq
+.
+.\" the following strings are 'official'
+.ds <= \<=
+.ds >= \>=
+.ds aa \aa
+.ds ga \ga
+.ds q \dq
+.ds Lq \lq
+.ds Rq \rq
+.ds Ne \!=
+.ds Le \<=
+.ds Ge \>=
+.ds Lt <
+.ds Gt >
+.ds Pm \+-
+.ds Na \fINaN\f
+.ds Ba \fR|\f
+.ds Am &
+.
+.\" Unicode TTYs have all glyph forms; for other TTY character sets we
+.\" need character representations which are different from GNU troff's
+.\" standard forms.
+.ie '\*.T'utf8' \{\
+.  ds ua \ua
+.  ds Pi \*p
+.  ds If \if
+.\}
+.el \{\
+.  ds ua ^
+.  ds Pi pi
+.  ds If infinity
+.\}
+.
+.
+.\" NS doc-get-width macro
+.\" NS   computes the width of a string as a multiple of
+.\" NS   'doc-fixed-width': '.doc-get-width string'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-width
+.
+.eo
+.de doc-get-width
+.  nr doc-width \w'\$1'
+.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
+.    ie (\ndoc-width % \ndoc-fixed-width) \
+.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
+.    el \
+.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
+.  \}
+.  el \
+.    nr doc-width 0
+..
+.ec
+.
+.
+.\" NS doc-get-arg-width macro
+.\" NS   computes the width of an argument as a multiple of
+.\" NS   'doc-fixed-width': '.doc-get-arg-width arg-index'
+.\" NS
+.\" NS modifies:
+.\" NS   doc-width
+.
+.eo
+.de doc-get-arg-width
+.  nr doc-width \w'\*doc-arg\$1'
+.  ie (\ndoc-width >= \ndoc-fixed-width) \{\
+.    ie (\ndoc-width % \ndoc-fixed-width) \
+.      nr doc-width ((\ndoc-width / \ndoc-fixed-width) + 1)
+.    el \
+.      nr doc-width (\ndoc-width / \ndoc-fixed-width)
+.  \}
+.  el \
+.    nr doc-width 0
+..
+.ec
+.
+.
+.\" NS Ql user macro
+.\" NS   quoted literal define
+.\" NS
+.\" NS modifies:
+.\" NS   doc-macro-name
+.\" NS   doc-quote-left
+.\" NS   doc-quote-right
+.\" NS
+.\" NS width register 'Ql' set in doc-common
+.
+.eo
+.de Ql
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \
+.      ds doc-macro-name Ql
+.    el \
+.      tm Usage: .Ql argument ... (#\n.c)
+.  \}
+.
+.  ds doc-quote-left "\*doc-left-singlequote
+.  ds doc-quote-right "\*doc-right-singlequote
+.
+.  doc-enclose-string \$@
+..
+.ec
+.
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/mdoc/doc-syms Added

@@ -0,0 +1,908 @@
+.\" Copyright (c) 1991, 1993
+.\"   The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in
+.\"    the documentation and/or other materials provided with the
+.\"    distribution.
+.\" 3. Deleted.  See
+.\"     ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change
+.\" 4. Neither the name of the University nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS"
+.\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+.\" PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR
+.\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)doc-syms	8.1 (Berkeley) 06/08/93
+.
+.
+.\" NS Ux user macro
+.\" NS   format Unix
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Ux
+.\" NS
+.\" NS width register 'Ux' defined in doc-common
+.
+.eo
+.de Ux
+.  nr doc-curr-font \n.f
+.  ds doc-str-Ux \f\ndoc-curr-font
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Ux
+.      doc-parse-args \$@
+.    \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr Unix\*doc-str-Ux
+.  rm doc-str-Ux
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Bx user macro
+.\" NS   print BSD (fix smaller nroff version)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Bx
+.\" NS   doc-str-Bx1
+.\" NS   doc-str-Bx-XXX
+.\" NS
+.\" NS width register 'Bx' defined in doc-common
+.
+.ds doc-str-Bx-Reno  \-Reno
+.ds doc-str-Bx-reno  \-Reno
+.ds doc-str-Bx-Tahoe \-Tahoe
+.ds doc-str-Bx-tahoe \-Tahoe
+.ds doc-str-Bx-Lite  \-Lite
+.ds doc-str-Bx-lite  \-Lite
+.ds doc-str-Bx-Lite2 \-Lite2
+.ds doc-str-Bx-lite2 \-Lite2
+.
+.eo
+.de Bx
+.  nr doc-curr-font \n.f
+.  ds doc-str-Bx \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Bx1 BSD\*doc-str-Bx
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Bx
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie        "\*doc-arg\ndoc-arg-ptr"-alpha" \
+.        as doc-str-Bx1 " (currently in alpha test)
+.      el \{ .ie "\*doc-arg\ndoc-arg-ptr"-beta" \
+.        as doc-str-Bx1 " (currently in beta test)
+.      el \{ .ie "\*doc-arg\ndoc-arg-ptr"-devel" \
+.        as doc-str-Bx1 " (currently under development)
+.      el \{\
+.        ds doc-str-Bx1 \&\*doc-arg\ndoc-arg-ptr\^
+.        as doc-str-Bx1 BSD\*doc-str-Bx
+.
+.        if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.          nr doc-arg-ptr +1
+.          ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.            ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.              ie d doc-str-Bx-\*doc-arg\ndoc-arg-ptr \
+.                as doc-str-Bx1 "\*doc-str-Bx-\*doc-arg\ndoc-arg-ptr
+.              el \
+.                nr doc-arg-ptr -1
+.            \}
+.            el \
+.              nr doc-arg-ptr -1
+.          \}
+.          el \
+.            nr doc-arg-ptr -1
+.    \}\}\}\}\}
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Bx1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Ud user macro (not parsed, not callable)
+.\" NS   print "currently under development" (HISTORY section)
+.\" NS
+.\" NS width register 'Ud' defined in doc-common
+.
+.eo
+.de Ud
+.  nop \&currently under development.
+..
+.ec
+.
+.
+.\" NS At user macro
+.\" NS   print AT&T UNIX
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-At
+.\" NS   doc-str-At1
+.\" NS   doc-str-At-XXX
+.\" NS
+.\" NS width register 'At' defined in doc-common
+.
+.eo
+.ds doc-str-At-32v \&Version\~7
+.as doc-str-At-32v " AT&T UNIX\*doc-str-At/32V
+.ds doc-str-At-v1  \&Version\~1
+.as doc-str-At-v1  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v2  \&Version\~2
+.as doc-str-At-v2  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v3  \&Version\~3
+.as doc-str-At-v3  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v4  \&Version\~4
+.as doc-str-At-v4  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v5  \&Version\~5
+.as doc-str-At-v5  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v6  \&Version\~6
+.as doc-str-At-v6  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-v7  \&Version\~7
+.as doc-str-At-v7  " AT&T UNIX\*doc-str-At
+.ds doc-str-At-III AT&T\*doc-str-At System\~III
+.as doc-str-At-III " UNIX\*doc-str-At
+.ds doc-str-At-V   AT&T\*doc-str-At System\~V
+.as doc-str-At-V   " UNIX\*doc-str-At
+.ds doc-str-At-V.1 AT&T\*doc-str-At System\~V Release\~1
+.as doc-str-At-V.1 " UNIX\*doc-str-At
+.ds doc-str-At-V.2 AT&T\*doc-str-At System\~V Release\~2
+.as doc-str-At-V.2 " UNIX\*doc-str-At
+.ds doc-str-At-V.3 AT&T\*doc-str-At System\~V Release\~3
+.as doc-str-At-V.3 " UNIX\*doc-str-At
+.ds doc-str-At-V.4 AT&T\*doc-str-At System\~V Release\~4
+.as doc-str-At-V.4 " UNIX\*doc-str-At
+.
+.de At
+.  nr doc-curr-font \n.f
+.  ds doc-str-At \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-At1 AT&T UNIX\*doc-str-At
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name At
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie \A'\*doc-arg\ndoc-arg-ptr' \{\
+.        ie d doc-str-At-\*doc-arg\ndoc-arg-ptr \
+.          ds doc-str-At1 "\*doc-str-At-\*doc-arg\ndoc-arg-ptr
+.        el \{\
+.          tmc mdoc warning: .At: Unknown AT&T UNIX version
+.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
+.          nr doc-arg-ptr -1
+.      \}\}
+.      el \
+.        nr doc-arg-ptr -1
+.    \}
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-At1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Dx user macro
+.\" NS   print DragonFly
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Dx
+.\" NS   doc-str-Dx1
+.\" NS
+.\" NS width register 'Dx' defined in doc-common
+.
+.\" we use the doc-operating-system-DragonFly-* strings defined in
+.\" doc-common
+.
+.eo
+.de Dx
+.  nr doc-curr-font \n.f
+.  ds doc-str-Dx \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Dx1 \%DragonFly\*doc-str-Dx
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Dx
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie \A'\*doc-arg\ndoc-arg-ptr' \{\
+.        ie d doc-operating-system-DragonFly-\*doc-arg\ndoc-arg-ptr \
+.          as doc-str-Dx1 \~\*doc-operating-system-DragonFly-\*doc-arg\ndoc-arg-ptr
+.        el \{\
+.          tmc mdoc warning: .Dx: Unknown DragonFly version
+.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
+.          as doc-str-Dx1 \~\*doc-arg\ndoc-arg-ptr
+.      \}\}
+.      el \
+.        as doc-str-Dx1 \~\*doc-arg\ndoc-arg-ptr
+.    \}
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Dx1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Fx user macro
+.\" NS   print FreeBSD
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Fx
+.\" NS   doc-str-Fx1
+.\" NS
+.\" NS width register 'Fx' defined in doc-common
+.
+.\" we use the doc-operating-system-FreeBSD-* strings defined in
+.\" doc-common
+.
+.eo
+.de Fx
+.  nr doc-curr-font \n.f
+.  ds doc-str-Fx \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Fx1 \%FreeBSD\*doc-str-Fx
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Fx
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie \A'\*doc-arg\ndoc-arg-ptr' \{\
+.        ie d doc-operating-system-FreeBSD-\*doc-arg\ndoc-arg-ptr \
+.          as doc-str-Fx1 \~\*doc-operating-system-FreeBSD-\*doc-arg\ndoc-arg-ptr
+.        el \{\
+.          tmc mdoc warning: .Fx: Unknown FreeBSD version
+.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
+.          as doc-str-Fx1 \~\*doc-arg\ndoc-arg-ptr
+.      \}\}
+.      el \
+.        as doc-str-Fx1 \~\*doc-arg\ndoc-arg-ptr
+.    \}
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Fx1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Nx user macro
+.\" NS   print NetBSD
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Nx
+.\" NS   doc-str-Nx1
+.\" NS
+.\" NS width register 'Nx' defined in doc-common
+.
+.\" we use the doc-operating-system-NetBSD-* strings defined in
+.\" doc-common
+.
+.eo
+.de Nx
+.  nr doc-curr-font \n.f
+.  ds doc-str-Nx \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Nx1 \%Net
+.  as doc-str-Nx1 BSD\*doc-str-Nx
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Nx
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \{\
+.      ie \A'\*doc-arg\ndoc-arg-ptr' \{\
+.        ie d doc-operating-system-NetBSD-\*doc-arg\ndoc-arg-ptr \
+.          as doc-str-Nx1 \~\*doc-operating-system-NetBSD-\*doc-arg\ndoc-arg-ptr
+.        el \{\
+.          tmc mdoc warning: .Nx: Unknown NetBSD version
+.          tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
+.          as doc-str-Nx1 \~\*doc-arg\ndoc-arg-ptr
+.      \}\}
+.      el \
+.        as doc-str-Nx1 \~\*doc-arg\ndoc-arg-ptr
+.    \}
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Nx1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Ox user macro
+.\" NS   print OpenBSD
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Ox
+.\" NS   doc-str-Ox1
+.\" NS
+.\" NS width register 'Ox' defined in doc-common
+.
+.eo
+.de Ox
+.  nr doc-curr-font \n.f
+.  ds doc-str-Ox \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Ox1 \%OpenBSD\*doc-str-Ox
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Ox
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \
+.      as doc-str-Ox1 \~\*doc-arg\ndoc-arg-ptr
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Ox1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" NS Bsx user macro
+.\" NS   print BSD/OS
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-str-Bsx
+.\" NS   doc-str-Bsx1
+.\" NS
+.\" NS width register 'Bsx' defined in doc-common
+.
+.eo
+.de Bsx
+.  nr doc-curr-font \n.f
+.  ds doc-str-Bsx \f\ndoc-curr-font
+.
+.  \" default value if no argument
+.  ds doc-str-Bsx1 BSD/OS\*doc-str-Bsx
+.
+.  if !\ndoc-arg-count \
+.    if \n.$ \{\
+.      ds doc-macro-name Bsx
+.      doc-parse-args \$@
+.    \}
+.
+.  if (\ndoc-arg-count > \ndoc-arg-ptr) \{\
+.    nr doc-arg-ptr +1
+.    ie (\ndoc-type\ndoc-arg-ptr == 2) \
+.      as doc-str-Bsx1 \~\*doc-arg\ndoc-arg-ptr
+.    el \
+.      nr doc-arg-ptr -1
+.  \}
+.
+.  \" replace current argument with result
+.  ds doc-arg\ndoc-arg-ptr "\*doc-str-Bsx1
+.  nr doc-type\ndoc-arg-ptr 2
+.  ds doc-space\ndoc-arg-ptr "\*doc-space
+.
+.  \" recompute space vector for remaining arguments
+.  nr doc-num-args (\ndoc-arg-count - \ndoc-arg-ptr)
+.  nr doc-arg-count \ndoc-arg-ptr
+.  if \ndoc-num-args \
+.    doc-parse-space-vector
+.
+.  doc-print-recursive
+..
+.ec
+.
+.
+.\" The Bt macro should go away now
+.
+.\" NS Bt user macro (not parsed, not callable)
+.\" NS   print "is currently in beta test." (HISTORY section)
+.\" NS
+.\" NS width register 'Bt' defined in doc-common
+.
+.eo
+.de Bt
+.  nop \&is currently in beta test.
+..
+.ec
+.
+.
+.\" NS Px user macro
+.\" NS   print POSIX
+.
+.eo
+.ds Px \%POSIX
+.ec
+.
+.
+.\" NS Ai user macro
+.\" NS   print ANSI
+.
+.eo
+.ds Ai \%ANSI
+.ec
+.
+.
+.\" NS St user macro
+.\" NS   standards (posix, ansi - formal standard names)
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-reg-St
+.\" NS   doc-str-St
+.\" NS   doc-str-St1
+.\" NS   doc-str-St-XXX
+.\" NS
+.\" NS width register 'St' defined in doc-common
+.
+.\" ANSI/ISO C
+.eo
+.ds doc-str-St--ansiC-89       \*Ai \*doc-str-StX\^3.159-1989
+.as doc-str-St--ansiC-89       " (\*Lq\)\*Ai\~C89\*doc-str-St\*Rq)
+.als doc-str-St--ansiC doc-str-St--ansiC-89
+.ds doc-str-St--isoC           ISO/IEC\*doc-str-St 9899:1990
+.as doc-str-St--isoC           " (\*LqISO\~C\^90\*doc-str-St\*Rq)
+.als doc-str-St--isoC-90 doc-str-St--isoC
+.ds doc-str-St--isoC-2011      ISO/IEC\*doc-str-St 9899:2011
+.as doc-str-St--isoC-2011      " (\*LqISO\~C\^11\*doc-str-St\*Rq)
+.ds doc-str-St--isoC-99        ISO/IEC\*doc-str-St 9899:1999
+.as doc-str-St--isoC-99        " (\*LqISO\~C\^99\*doc-str-St\*Rq)
+.ds doc-str-St--isoC-amd1       ISO/IEC\*doc-str-St 9899/AMD1:1995
+.as doc-str-St--isoC-amd1       " (\*LqISO\~C\^90\*doc-str-St, Amendment 1\*Rq)
+.ds doc-str-St--isoC-tcor1      ISO/IEC\*doc-str-St 9899/TCOR1:1994
+.as doc-str-St--isoC-tcor1      " (\*LqISO\~C\^90\*doc-str-St, Technical Corrigendum 1\*Rq)
+.ds doc-str-St--isoC-tcor2      ISO/IEC\*doc-str-St 9899/TCOR2:1995
+.as doc-str-St--isoC-tcor2      " (\*LqISO\~C\^90\*doc-str-St, Technical Corrigendum 2\*Rq)
+.ec
+.
+.\" POSIX Part 1: System API
+.eo
+.ds doc-str-St--p1003.1        \%IEEE\*doc-str-St Std 1003.1
+.as doc-str-St--p1003.1        " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1b       \%IEEE\*doc-str-St Std 1003.1b
+.as doc-str-St--p1003.1b       " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-88     \%IEEE\*doc-str-St Std 1003.1-1988
+.as doc-str-St--p1003.1-88     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-90     ISO/IEC\*doc-str-St 9945-1:1990
+.as doc-str-St--p1003.1-90     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.als doc-str-St--iso9945-1-90 doc-str-St--p1003.1-90
+.ds doc-str-St--p1003.1b-93    \%IEEE\*doc-str-St Std 1003.1b-1993
+.as doc-str-St--p1003.1b-93    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1c-95    \%IEEE\*doc-str-St Std 1003.1c-1995
+.as doc-str-St--p1003.1c-95    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1i-95    \%IEEE\*doc-str-St Std 1003.1i-1995
+.as doc-str-St--p1003.1i-95    " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-96     ISO/IEC\*doc-str-St 9945-1:1996
+.as doc-str-St--p1003.1-96     " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.als doc-str-St--iso9945-1-96 doc-str-St--p1003.1-96
+.ds doc-str-St--p1003.1g-2000  \%IEEE\*doc-str-St Std 1003.1g-2000
+.as doc-str-St--p1003.1g-2000  " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-2001   \%IEEE\*doc-str-St Std 1003.1-2001
+.as doc-str-St--p1003.1-2001   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-2004   \%IEEE\*doc-str-St Std 1003.1-2004
+.as doc-str-St--p1003.1-2004   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ds doc-str-St--p1003.1-2008   \%IEEE\*doc-str-St Std 1003.1-2008
+.as doc-str-St--p1003.1-2008   " (\*Lq\)\*Px\*doc-str-St.1\*Rq)
+.ec
+.
+.\" POSIX Part 2: Shell and Utilities
+.eo
+.ds doc-str-St--p1003.2        \%IEEE\*doc-str-St Std 1003.2
+.as doc-str-St--p1003.2        " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
+.ds doc-str-St--p1003.2-92     \%IEEE\*doc-str-St Std 1003.2-1992
+.as doc-str-St--p1003.2-92     " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
+.ds doc-str-St--p1003.2a-92    \%IEEE\*doc-str-St Std 1003.2a-1992
+.as doc-str-St--p1003.2a-92    " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
+.ds doc-str-St--iso9945-2-93   ISO/IEC\*doc-str-St 9945-2:1993
+.as doc-str-St--iso9945-2-93   " (\*Lq\)\*Px\*doc-str-St.2\*Rq)
+.ec
+.
+.\" X/Open
+.eo
+.ds doc-str-St--susv1          Version\~1 of the Single UNIX\*doc-str-St Specification
+.as doc-str-St--susv1          " (\*LqSUSv1\*doc-str-St\*Rq)
+.ds doc-str-St--susv2          Version\~2 of the Single UNIX\*doc-str-St Specification
+.as doc-str-St--susv2          " (\*LqSUSv2\*doc-str-St\*Rq)
+.ds doc-str-St--susv3          Version\~3 of the Single UNIX\*doc-str-St Specification
+.as doc-str-St--susv3          " (\*LqSUSv3\*doc-str-St\*Rq)
+.ds doc-str-St--susv4          Version\~4 of the Single UNIX\*doc-str-St Specification
+.as doc-str-St--susv4          " (\*LqSUSv4\*doc-str-St\*Rq)
+.ds doc-str-St--svid4          System\~V Interface Definition, Fourth Edition
+.as doc-str-St--svid4          " (\*LqSVID\*doc-str-St\^4\*Rq)
+.ds doc-str-St--xbd5           X/Open\*doc-str-St Base Definitions Issue\~5
+.as doc-str-St--xbd5           " (\*LqXBD\*doc-str-St\^5\*Rq)
+.ds doc-str-St--xcu5           X/Open\*doc-str-St Commands and Utilities Issue\~5
+.as doc-str-St--xcu5           " (\*LqXCU\*doc-str-St\^5\*Rq)
+.ds doc-str-St--xcurses4.2     X/Open\*doc-str-St Curses Issue\~4, Version\~2
+.as doc-str-St--xcurses4.2     " (\*LqXCURSES\*doc-str-St\^4.2\*Rq)
+.ds doc-str-St--xns5           X/Open\*doc-str-St Networking Services Issue\~5
+.as doc-str-St--xns5           " (\*LqXNS\*doc-str-St\^5\*Rq)
+.ds doc-str-St--xns5.2         X/Open\*doc-str-St Networking Services Issue\~5.2
+.as doc-str-St--xns5.2         " (\*LqXNS\*doc-str-St\^5.2\*Rq)
+.ds doc-str-St--xpg3           X/Open\*doc-str-St Portability Guide Issue\~3
+.as doc-str-St--xpg3           " (\*LqXPG\*doc-str-St\^3\*Rq)
+.ds doc-str-St--xpg4           X/Open\*doc-str-St Portability Guide Issue\~4
+.as doc-str-St--xpg4           " (\*LqXPG\*doc-str-St\^4\*Rq)
+.ds doc-str-St--xpg4.2         X/Open\*doc-str-St Portability Guide Issue\~4, Version\~2
+.as doc-str-St--xpg4.2         " (\*LqXPG\*doc-str-St\^4.2\*Rq)
+.ds doc-str-St--xsh5           X/Open\*doc-str-St System Interfaces and Headers Issue\~5
+.as doc-str-St--xsh5           " (\*LqXSH\*doc-str-St\^5\*Rq)
+.ec
+.
+.\" Miscellaneous
+.eo
+.ds doc-str-St--ieee754        \%IEEE\*doc-str-St Std 754-1985
+.ds doc-str-St--ieee1275-94     \%IEEE\*doc-str-St Std 1275-1994
+.as doc-str-St--ieee1275-94     " (\*LqOpen Firmware\*doc-str-St\*Rq)
+.ds doc-str-St--iso8601        ISO\*doc-str-St 8601
+.ds doc-str-St--iso8802-3      ISO/IEC\*doc-str-St 8802-3:1989
+.ec
+.
+.eo
+.de St
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name St
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      doc-St-usage
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.    ds doc-str-St \f\ndoc-curr-font
+.
+.    ds doc-str-St1
+.    ie \A'\*doc-arg\ndoc-arg-ptr' \{\
+.      ie d doc-str-St-\*doc-arg\ndoc-arg-ptr \
+.        ds doc-str-St1 "\*doc-str-St-\*doc-arg\ndoc-arg-ptr
+.      el \{\
+.        tmc "mdoc warning: .St: Unknown standard abbreviation
+.        tm1 " '\*doc-arg\ndoc-arg-ptr' (#\n.c)
+.        tm1 "              Please refer to the groff_mdoc(7) manpage for a
+.        tm1 "              list of available standard abbreviations.
+.    \}\}
+.    el \
+.      doc-St-usage
+.
+.    \" replacing argument with result
+.    ds doc-arg\ndoc-arg-ptr "\*doc-str-St1
+.
+.    doc-print-recursive
+.  \}
+.  el \{\
+.    doc-St-usage
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" NS doc-St-usage macro
+.
+.eo
+.de doc-St-usage
+.  tm1 "Usage: .St standard (#\n.c)
+.  tm1 "       Please refer to the groff_mdoc(7) manpage for a list of
+.  tm1 "       available standard abbreviations.
+..
+.ec
+.
+.
+.\" NS Lb user macro
+.\" NS   formal library names for LIBRARY sections
+.\" NS
+.\" NS modifies:
+.\" NS   doc-arg-ptr
+.\" NS   doc-curr-font
+.\" NS   doc-macro-name
+.\" NS
+.\" NS local variable:
+.\" NS   doc-reg-Lb
+.\" NS   doc-str-Lb
+.\" NS   doc-str-Lb1
+.\" NS   doc-str-Lb-XXX
+.\" NS
+.\" NS width register 'Lb' defined in doc-common
+.
+.eo
+.ds doc-str-Lb-libarchive  Reading and Writing Streaming Archives Library (libarchive, \-larchive)
+.ds doc-str-Lb-libarm      ARM Architecture Library (libarm, \-larm)
+.ds doc-str-Lb-libarm32    ARM32 Architecture Library (libarm32, \-larm32)
+.ds doc-str-Lb-libbluetooth Bluetooth Library (libbluetooth, \-lbluetooth)
+.ds doc-str-Lb-libbsm      Basic Security Module Library (libbsm, \-lbsm)
+.ds doc-str-Lb-libc        Standard C\~Library (libc, \-lc)
+.ds doc-str-Lb-libc_r      Reentrant C\~Library (libc_r, \-lc_r)
+.ds doc-str-Lb-libcalendar Calendar Arithmetic Library (libcalendar, \-lcalendar)
+.ds doc-str-Lb-libcam      Common Access Method User Library (libcam, \-lcam)
+.ds doc-str-Lb-libcdk      Curses Development Kit Library (libcdk, \-lcdk)
+.ds doc-str-Lb-libcipher   FreeSec Crypt Library (libcipher, \-lcipher)
+.ds doc-str-Lb-libcompat   Compatibility Library (libcompat, \-lcompat)
+.ds doc-str-Lb-libcrypt    Crypt Library (libcrypt, \-lcrypt)
+.ds doc-str-Lb-libcurses   Curses Library (libcurses, \-lcurses)
+.ds doc-str-Lb-libdevinfo  Device and Resource Information Utility Library (libdevinfo, \-ldevinfo)
+.ds doc-str-Lb-libdevstat  Device Statistics Library (libdevstat, \-ldevstat)
+.ds doc-str-Lb-libdisk     Interface to Slice and Partition Labels Library (libdisk, \-ldisk)
+.ds doc-str-Lb-libdwarf    DWARF Access Library (libdwarf, \-ldwarf)
+.ds doc-str-Lb-libedit     Command Line Editor Library (libedit, \-ledit)
+.ds doc-str-Lb-libelf      ELF Access Library (libelf, \-lelf)
+.ds doc-str-Lb-libevent    Event Notification Library (libevent, \-levent)
+.ds doc-str-Lb-libfetch    File Transfer Library for URLs (libfetch, \-lfetch)
+.ds doc-str-Lb-libform     Curses Form Library (libform, \-lform)
+.ds doc-str-Lb-libgeom     Userland API Library for kernel GEOM subsystem (libgeom, \-lgeom)
+.ds doc-str-Lb-libgpib     General-Purpose Instrument Bus (GPIB) library (libgpib, \-lgpib)
+.ds doc-str-Lb-libi386     i386 Architecture Library (libi386, \-li386)
+.ds doc-str-Lb-libintl     Internationalized Message Handling Library (libintl, \-lintl)
+.ds doc-str-Lb-libipsec    IPsec Policy Control Library (libipsec, \-lipsec)
+.ds doc-str-Lb-libipx      IPX Address Conversion Support Library (libipx, \-lipx)
+.ds doc-str-Lb-libiscsi    iSCSI protocol library (libiscsi, \-liscsi)
+.ds doc-str-Lb-libjail     Jail Library (libjail, \-ljail)
+.ds doc-str-Lb-libkiconv   Kernel side iconv library (libkiconv, \-lkiconv)
+.ds doc-str-Lb-libkse      N:M Threading Library (libkse, \-lkse)
+.ds doc-str-Lb-libkvm      Kernel Data Access Library (libkvm, \-lkvm)
+.ds doc-str-Lb-libm        Math Library (libm, \-lm)
+.ds doc-str-Lb-libm68k     m68k Architecture Library (libm68k, \-lm68k)
+.ds doc-str-Lb-libmagic    Magic Number Recognition Library (libmagic, \-lmagic)
+.ds doc-str-Lb-libmd       Message Digest (MD4, MD5, etc.) Support Library (libmd, \-lmd)
+.ds doc-str-Lb-libmemstat  Kernel Memory Allocator Statistics Library (libmemstat, \-lmemstat)
+.ds doc-str-Lb-libmenu     Curses Menu Library (libmenu, \-lmenu)
+.ds doc-str-Lb-libnetgraph Netgraph User Library (libnetgraph, \-lnetgraph)
+.ds doc-str-Lb-libnetpgp   Netpgp signing, verification, encryption and decryption (libnetpgp, \-lnetpgp)
+.ds doc-str-Lb-libossaudio OSS Audio Emulation Library (libossaudio, \-lossaudio)
+.ds doc-str-Lb-libpam      Pluggable Authentication Module Library (libpam, \-lpam)
+.ds doc-str-Lb-libpcap     Packet Capture Library (libpcap, \-lpcap)
+.ds doc-str-Lb-libpci      PCI Bus Access Library (libpci, \-lpci)
+.ds doc-str-Lb-libpmc      Performance Counters Library (libpmc, \-lpmc)
+.ds doc-str-Lb-libposix    \*Px \*doc-str-LbCompatibility Library (libposix, \-lposix)
+.ds doc-str-Lb-libprop     Property Container Object Library (libprop, \-lprop)
+.ds doc-str-Lb-libpthread  \*Px \*doc-str-LbThreads Library (libpthread, \-lpthread)
+.ds doc-str-Lb-libpuffs    puffs Convenience Library (libpuffs, \-lpuffs)
+.ds doc-str-Lb-librefuse   File System in Userspace Convenience Library (librefuse, \-lrefuse)
+.ds doc-str-Lb-libresolv   DNS Resolver Library (libresolv, \-lresolv)
+.ds doc-str-Lb-librpcsec_gss RPC GSS-API Authentication Library (librpcsec_gss, \-lrpcsec_gss)
+.ds doc-str-Lb-librpcsvc   RPC Service Library (librpcsvc, \-lrpcsvc)
+.ds doc-str-Lb-librt       \*Px \*doc-str-LbReal-time Library (librt, \-lrt)
+.ds doc-str-Lb-libsdp      Bluetooth Service Discovery Protocol User Library (libsdp, \-lsdp)
+.ds doc-str-Lb-libssp      Buffer Overflow Protection Library (libssp, \-lssp)
+.ds doc-str-Lb-libSystem   System Library (libSystem, \-lSystem)
+.ds doc-str-Lb-libtermcap  Termcap Access Library (libtermcap, \-ltermcap)
+.ds doc-str-Lb-libterminfo Terminal Information Library (libterminfo, \-lterminfo)
+.ds doc-str-Lb-libthr      1:1 Threading Library (libthr, \-lthr)
+.ds doc-str-Lb-libufs      UFS File System Access Library (libufs, \-lufs)
+.ds doc-str-Lb-libugidfw   File System Firewall Interface Library (libugidfw, \-lugidfw)
+.ds doc-str-Lb-libulog     User Login Record Library (libulog, \-lulog)
+.ds doc-str-Lb-libusbhid   USB Human Interface Devices Library (libusbhid, \-lusbhid)
+.ds doc-str-Lb-libutil     System Utilities Library (libutil, \-lutil)
+.ds doc-str-Lb-libvgl      Video Graphics Library (libvgl, \-lvgl)
+.ds doc-str-Lb-libx86_64   x86_64 Architecture Library (libx86_64, \-lx86_64)
+.ds doc-str-Lb-libz        Compression Library (libz, \-lz)
+.ec
+.
+.eo
+.de Lb
+.  if !\ndoc-arg-count \{\
+.    ie \n.$ \{\
+.      ds doc-macro-name Lb
+.      doc-parse-args \$@
+.    \}
+.    el \
+.      tm Usage: .Lb library_name ... (#\n.c)
+.  \}
+.
+.  if !\ndoc-arg-count \
+.    return
+.
+.  nr doc-arg-ptr +1
+.  ie (\ndoc-arg-count >= \ndoc-arg-ptr) \{\
+.    nr doc-curr-font \n.f
+.    ds doc-str-Lb \f\ndoc-curr-font
+.
+.    ie d doc-str-Lb-\*doc-arg\ndoc-arg-ptr \
+.      ds doc-str-Lb1 "\*doc-str-Lb-\*doc-arg\ndoc-arg-ptr
+.    el \{\
+.      tmc "mdoc warning: .Lb: no description for library
+.      tm1 " '\*doc-arg\ndoc-arg-ptr' available (#\n.c)
+.      ds doc-str-Lb1 library \*Lq\*doc-arg\ndoc-arg-ptr\*Rq
+.    \}
+.
+.    \" replacing argument with result
+.    ds doc-arg\ndoc-arg-ptr "\*doc-str-Lb1
+.
+.    if \ndoc-in-library-section \
+.      br
+.    doc-print-recursive
+.    if \ndoc-in-library-section \
+.      br
+.  \}
+.  el \{\
+.    tm Usage: .Lb library_name ... (#\n.c)
+.    doc-reset-args
+.  \}
+..
+.ec
+.
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/papersize.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/papersize.tmac Changed

@@ -1,6 +1,4 @@
-.\" papersize.tmac
-.\"
-.\" Set up groff for various paper sizes.
+.\" Set up GNU troff for various paper sizes.
 .\"
 .\" Usage:
 .\"
@@ -15,12 +13,12 @@
 .\" '-l' to override the default paper length and orientation as set in
 .\" the driver specific DESC file.
 .\"
-.\" For example, use the following for PS output on A4 paper in
+.\" For example, use the following for PostScript output on A4 paper in
 .\" landscape orientation:
 .\"
 .\"   groff -Tps -dpaper=a4l -P-pa4 -P-l -ms foo.ms > foo.ps
 .
-.nr _C \n(.C
+.do nr *groff_papersize_tmac_C \n.cp
 .cp 0
 .
 .if d paper \{\
@@ -106,18 +104,10 @@
 .  ds paper-dl-length 22c
 .  ds paper-dl-width 11c
 .
-.  \" We assume that letters a-z and A-Z aren't mapped during start-up.
-.  tr AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz
-.  di lowercase
-.    nop \*paper
-.    br
-.  di
-.  asciify lowercase
-.  chop lowercase
-.  tr AABBCCDDEEFFGGHHIIJJKKLLMMNNOOPPQQRRSSTTUUVVWWXXYYZZ
-.  ds paper \*lowercase
-.  rm lowercase
-.
+.  \" Save the input parameter for a later diagnostic.
+.  ds paper-arg \*paper\"
+.  ds paper \*paper-arg\"
+.  stringdown paper
 .  ds paper-p \*paper
 .  ds paper-l \*paper
 .  length paper-n \*paper
@@ -149,18 +139,26 @@
 .  el \
 .    nr paper-w 1
 .
-.  ie \npaper-w \
-.    tm warning: Unknown paper size '\*paper'
-.  el \
+.  ie \npaper-w \{\
+.    tmc papersize.tmac: warning: ignoring unrecognized paper format
+.    tm1 " '\*paper-arg'
+.  \}
+.  el \{\
 .    if !r LL \
 .      nr LL \n.lu  \" for ms, mdoc, man
+.    if !r #R_MARGIN \
+.      nr R_MARGIN 1i \" for mom
+.    \" for mm
+.    if !r W \{\
+.      nr W \n.lu
+.      if !r O \
+.        nr O 1i
+.    \}
+.  \}
 .\}
 .
-.cp \n_C
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_papersize_tmac_C
+.do rr *groff_papersize_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/pdf.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/pdf.tmac Changed

@@ -2,7 +2,7 @@
 
 pdf.tmac
 
- Copyright (C) 2011-2018 Free Software Foundation, Inc.
+ Copyright (C) 2011-2020 Free Software Foundation, Inc.
       Written by Deri James <deri@chuzzlewit.myzen.co.uk>
 
 This file is part of groff.
@@ -27,10 +27,16 @@
 Keith Marshall (see attribution in the pdfmark.tmac file). I, however,
 am solely responsible for any bugs I may have introduced into this file.
 ..
+.
+.do nr *groff_pdf_tmac_C \n.cp
+.cp 0
+.
+.if d pdfmark .nx
+.
 .mso ps.tmac
 .
 .de pdf:SS
-.	char \\$1 \\S'16'\\$1\\S'0'
+.      fchar \\$1 \\S'16'\\$1\\S'0'
 ..
 .pdf:SS \+h
 .pdf:SS \ts
@@ -65,11 +71,14 @@
 .de pdfmark
 . nop \!x X ps:exec \\$* pdfmark
 ..
+.
+.ds pdf pdf.tmac\" for use in diagnostic messages
+.
 .de pdf:warn
-. tm \\n(.F:\\n(.c: macro warning: \\$*
+. tm \\*pdf:\\n.F:\\n.c: warning: \\$*
 ..
 .de pdf:error
-. tm \\n(.F:\\n(.c: macro error: \\$*
+. tm \\*pdf:\\n.F:\\n.c: error: \\$*
 ..
 .de pdfinfo
 .\" -------------------------------------------------------------------
@@ -712,7 +721,7 @@
 .   \" Clean up the temporary registers and strings, used to
 .   \" compute the "hot-spot" bounds, and format the reference,
 .   \"
-.   rm PDFHREF.DESC PDFHREF.TEXT
+.   rm PDFHREF.DESC
 .   \}
 .\"
 .\" But when we identify an INVALID link ...
@@ -745,7 +754,7 @@
 .   \" when suitable initialisers exist, or complaining otherwise.
 .   \"
 .   ie dpdf*href\\$1.init .pdf*href\\$1.init \\$2
-.   el .pdf*error pdfhref:init: unknown feature '\\$1'
+.   el .pdf:error pdfhref:init: unknown feature '\\$1'
 .   shift 2
 .   \}
 ..
@@ -805,8 +814,21 @@
 .de pdftransition
 .nop \!x X pdf: transition \\$1 \\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8
 ..
+.de pdfbackground
+.\" $1=Page|Fill|Box|off
+.\" $2=left
+.\" $3=top
+.\" $4=right
+.\" $5=bottom
+.\" $6=line weight (if box)
+.device pdf: background \\$*
+..
+.
+.cp \n*groff_pdf_tmac_C
+.do rr *groff_pdf_tmac_C
+.
 .\" Local Variables:
 .\" mode: nroff
+.\" fill-column: 72
 .\" End:
-.\" vim: filetype=groff:
-.\" pdf.tmac: end of file
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/pdfpic.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/pdfpic.tmac Changed

@@ -1,148 +1,287 @@
-.\" pdfpic.tmac
-.\"
 .\" Define the PDFPIC macro.
 .\"
-.\" When used other than with gropdf, the image is converted to .eps
-.\" and processing passed over to PSPIC.
+.\" When used with output devices other than `pdf`, convert image to
+.\" encapsulated PostScript and process it with PSPIC.
 .\"
 .\" Usage:
 .\"
-.\"   .PDFPIC -L|-R|-C|-I <indent> <file> <width> <height>
+.\"   .PDFPIC -L|-R|-C|-I <indentation> <file> <width> <height>
 .\"
-.\" Requires the poppler-utils package (for pdfinfo and pdftops).
-.\" Requires running groff in unsafe mode.
+.\" Requires the poppler-utils package (for pdfinfo(1) and pdftops(1)).
+.\" Requires running troff(1) in unsafe mode.
 .
 .do if d PDFPIC .nx
 .
-.nr _C \n(.C
+.do nr *groff_pdfpic_tmac_C \n.cp
 .cp 0
 .
-.de @abort
-.  ab PDFPIC: \\$* Aborting.
+.\" Locate a directory to house temporary files.  Check each argument
+.\" in turn, confirming its existence, writability, and searchability.
+.\"
+.\" `pdfpic*temporary-directory` contains its name if one is found, and
+.\" is empty otherwise.
+.de pdfpic@get-temporary-directory
+.  ds pdfpic*temporary-directory \" empty
+.  while !'\\$1'' \{\
+.    sy test -d \\$1 && test -w \\$1 && test -x \\$1
+.    if \\nsystat=0 .ds pdfpic*temporary-directory \\$1
+.    ie '\\*pdfpic*temporary-directory'' .shift
+.    el                                    .break
+.  \}
+..
+.
+.\" A user may wish to append an 'ab' to this macro using 'am'.  That
+.\" is why we don't 'return X' from here to return from two scopes.
+.de pdfpic@error
+.  tm pdfpic.tmac:\\n.F:\\n.c: error: \\$*
 ..
+.
+.de pdfpic@cleanup
+.  rm pdfpic*pspic-args
+.  rm pdfpic*file-extension
+.  rm pdfpic*file-name-base
+.  rm pdfpic*temporary-directory
+.  rm pdfpic*temporary-file
+.  rr pdfpic*do-conversion
+.  rr pdfpic*offset-mode
+.  rr pdfpic*indentation
+.  rr pdfpic*width
+.  rr pdfpic*height
+.  rr pdfpic*did-pdfinfo-work
+.  rr pdfpic*desired-width
+.  rr pdfpic*desired-height
+..
+.
 .de PDFPIC
-.  if !\\n.U \
-.    @abort Use of \\$0 requires giving groff the -U option.
+.  if !\\n.U \{\
+.    pdfpic@error use of \\$0 requires GNU troff's unsafe mode \
+(-U option)
+.    return
+.  \}
+.
+.  \" Dispose of junk from any previous early return.
+.  pdfpic@cleanup
 .
-.  nr convert-pdf 0
-.  if !'\\*.T'pdf' .nr convert-pdf 1
+.  nr pdfpic*do-conversion 0
+.  if !'\\*.T'pdf' .nr pdfpic*do-conversion 1
 .
-.  nr pdf-offset-mode 0
+.  nr pdfpic*offset-mode 0
+.
+.  \" Preserve the trailing space in definitions of pdfpic*pspic-args.
 .
 .  \" left-aligned?
 .  ie '\\$1'-L' \{\
-.    nr pdf-offset-mode 1
-.    if \\nconvert-pdf .ds pspic-args \\$1 \"
+.    nr pdfpic*offset-mode 1
+.    if \\npdfpic*do-conversion .ds pdfpic*pspic-args \\$1 \"
 .    shift
 .  \}
 .  el \{\
 .    \" right-aligned?
 .    ie '\\$1'-R' \{\
-.      nr pdf-offset-mode 2
-.      if \\nconvert-pdf .ds pspic-args \\$1 \"
+.      nr pdfpic*offset-mode 2
+.      if \\npdfpic*do-conversion .ds pdfpic*pspic-args \\$1 \"
 .      shift
 .    \}
 .    el \{\
 .      \" indented?
 .      ie '\\$1'-I' \{\
-.        nr pdf-offset-mode 3
-.        nr pdf-offset (m;\\$2)
-.        if \\nconvert-pdf .ds pspic-args \\$1 \\$2 \"
+.        nr pdfpic*offset-mode 3
+.        nr pdfpic*indentation (m;\\$2)
+.        if \\npdfpic*do-conversion .ds pdfpic*pspic-args \\$1 \\$2 \"
 .        shift 2
 .      \}
 .      el \{\
 .        \" centered is the default
 .        ie '\\$1'-C' \{\
-.          if \\nconvert-pdf .ds pspic-args \\$1 \"
+.          if \\npdfpic*do-conversion .ds pdfpic*pspic-args \\$1 \"
 .          shift
 .        \}
-.        el .nr pdf-offset-mode 0
+.        el .nr pdfpic*offset-mode 0
 .      \}
 .    \}
 .  \}
 .  br
 .
-.  ds is-pdf \\$1
-.  substring is-pdf -3
-.  if !'\\*is-pdf'pdf' \
-.    @abort \\$1 at line \\n.c is not a PDF file, or lacks a .pdf extension.
+.  ds pdfpic*file-extension \\$1\"
+.  substring pdfpic*file-extension -4
+.  stringdown pdfpic*file-extension
+.  if !'\\*pdfpic*file-extension'.pdf' \{\
+.    pdfpic@error '\\$1' lacks a '.pdf' extension; skipping
+.    return
+.  \}
+.
+.  \" Ensure the file exists and is readable.
+.  \"
+.  \" This test is subject to a time-of-check-to-time-of-use (TOCTTOU)
+.  \" attack (or a simple race with a concurrent `rm` command, for
+.  \" instance).
+.  sy test -r \\$1
+.  if \\nsystat!=0 \{\
+.    pdfpic@error '\\$1' does not exist or is not readable; skipping
+.    return
+.  \}
 .
-.\" if driver is not gropdf, convert image to .eps
-.  if \\nconvert-pdf \{\
-.    ds img-file \\$1
-.    substring img-file 0 -5
+.  \" if driver is not gropdf, convert image to .eps
+.  if \\npdfpic*do-conversion \{\
+.    ds pdfpic*file-name-base \\$1
+.    substring pdfpic*file-name-base 0 -5
 .
 .    sy pdftops -eps \\$1
 .    shift
 .
-.    as pspic-args \\*img-file.eps \\$*
+.    as pdfpic*pspic-args \\*pdfpic*file-name-base.eps \\$*
+.
+.    PSPIC \\*pdfpic*pspic-args
+.    return
+.  \}
+.
+.  pdfpic@get-temporary-directory \\VGROFF_TMPDIR \\VTMPDIR
+.
+.  if 'pdfpic*temporary-directory'' \{\
+.    \" Figure out if we're on a Windows system (with a Unix shell).
+.    nr pdfpic*is-on-windows 0
 .
-.    PSPIC \\*pspic-args
+.    sy expr $(uname -s) : "CYGWIN.*" > /dev/null
+.    if \\nsystat=0 .nr pdfpic*is-on-windows 1
+.    sy expr $(uname -s) : "MINGW.*" > /dev/null
+.    if \\nsystat=0 .nr pdfpic*is-on-windows 1
+.
+.    if \\npdfpic*is-on-windows \
+.      pdfpic@get-temporary-directory \\VTEMP \\VTMP
+.
+.    rr pdfpic*is-on-windows
+.  \}
+.
+.  if '\\*pdfpic*temporary-directory'' \
+.    pdfpic@get-temporary-directory /tmp
+.
+.  if '\\*pdfpic*temporary-directory'' \{\
+.    pdfpic@error cannot locate a usable temporary directory; \
+skipping '\\$1'
 .    return
 .  \}
+.  ds pdfpic*temporary-file \\*pdfpic*temporary-directory/pdfpic\n$$
 .
-.\" get image dimensions
+.  \" Get image dimensions.  The `tr` command to strip null bytes is
+.  \" distasteful, but its necessity is imposed on us.  See
+.  \" <https://gitlab.freedesktop.org/poppler/poppler/-/issues/776>.
 .  ec @
 .  sy pdfinfo @$1 | \
+tr -d '\000' | \
 grep "Page *size" | \
 sed -e 's/Page *size: *\$:digit:.*\$ *x *\$:digit:.*\$.*$/\
-.nr pdf-wid (p;\\1)\\n\
-.nr pdf-ht  (p;\\2)/' \
-> /tmp/pdfpic\n$$
-.  so /tmp/pdfpic\n$$
-.  sy rm /tmp/pdfpic\n$$
+.nr pdfpic*width (p;\\1)\\n\
+.nr pdfpic*height  (p;\\2)/' \
+> @*pdfpic*temporary-file
 .  ec
+.  if \\nsystat \{\
+.    pdfpic@error retrieval of '\\$1' image dimensions failed with \
+exit status \\nsystat; skipping
+.    return
+.  \}
+.  so \\*pdfpic*temporary-file
+.  sy rm \\*pdfpic*temporary-file
+.
+.  nr pdfpic*did-pdfinfo-work 1
+.  if !r pdfpic*width .nr pdfpic*did-pdfinfo-work 0
+.  if !r pdfpic*height .nr pdfpic*did-pdfinfo-work 0
+.  if !\\npdfpic*did-pdfinfo-work \{\
+.    pdfpic@error retrieval of '\\$1' image dimensions failed; skipping
+.    return
+.  \}
+.  rr pdfpic*did-pdfinfo-work
+.
+.  \" reject nonsense dimensions <= 0 (and avoid zero divide later)
+.  if !\\npdfpic*width \{\
+.    pdfpic@error '\\$1' reports image width of \\npdfpic*widthu; \
+skipping
+.    return
+.  \}
+.  if !\\npdfpic*height \{\
+.    pdfpic@error '\\$1' reports image height of \\npdfpic*heightu; \
+skipping
+.    return
+.  \}
 .
 .  \" if we have a <width> parameter, use it as the final
 .  \" image width; otherwise we use the image's natural width
 .  \" or the current line length, whatever is smaller
-.  ie (\\n.$ >= 2) \
-.    nr pdf-deswid (i;\\$2)
+.  ie (\\n.$ >= 2) \{\
+.    nr pdfpic*desired-width (i;\\$2)
+.    if !\\npdfpic*desired-width \{\
+.      pdfpic@error rejecting desired image width of \
+\\npdfpic*desired-widthu; skipping '\\$1'
+.      return
+.    \}
+.  \}
 .  el \
-.    nr pdf-deswid ((\\n.l - \\n.i) <? \\npdf-wid)
+.    nr pdfpic*desired-width ((\\n.l - \\n.i) <? \\npdfpic*width)
+.
+.  if (\\n.$ >= 3) \{\
+.    nr pdfpic*desired-height (i;\\$3)
+.    if !\\npdfpic*desired-height \{\
+.      pdfpic@error rejecting desired image height of \
+\\npdfpic*desired-heightu; skipping '\\$1'
+.      return
+.    \}
+.  \}
+.  \" We have no else clause; pdfpic*desired-height will get clobbered
+.  \" anyway.
 .
 .  \" compute the final image height (with proper rounding),
-.  \" based on the image's aspect
-.  nr pdf-desht (\\npdf-deswid * 1000 + (\\npdf-wid / 2) \
-                / \\npdf-wid * \\npdf-ht \
-                + 500 / 1000)
+.  \" based on the image's aspect ratio
+.  nr pdfpic*desired-height (\\npdfpic*desired-width * 1000 \
+                             + (\\npdfpic*width / 2) \
+                             / \\npdfpic*width * \\npdfpic*height \
+                             + 500 / 1000)
 .
 .  \" if we have a <height> parameter, use it as the final
 .  \" image height in case it is smaller than the height
 .  \" value we have just computed
-.  if ((\\n.$ >= 3) & (\\npdf-desht > (i;0\\$3))) \{\
-.    nr pdf-desht (i;\\$3)
+.  if ((\\n.$ >= 3) & (\\npdfpic*desired-height > (i;0\\$3))) \{\
+.    nr pdfpic*desired-height (i;\\$3)
 .    \" recompute the final image width since we always
 .    \" keep the correct image aspect
-.    nr pdf-deswid (\\npdf-desht * 1000 + (\\npdf-ht / 2) \
-                   / \\npdf-ht * \\npdf-wid \
-                   + 500 / 1000)
+.    nr pdfpic*desired-width (\\npdfpic*desired-height * 1000 \
+                              + (\\npdfpic*height / 2) \
+                              / \\npdfpic*height * \\npdfpic*width \
+                              + 500 / 1000)
 .  \}
 .
 .  \" reserve vertical space for image
-.  ne (\\npdf-deshtu + 1v)
+.  ne (\\npdfpic*desired-heightu + 1v)
 .
 .  \" compute image offset w.r.t. the current left margin
-.  if (\\npdf-offset-mode == 0) \
-.    nr pdf-offset (\\n.l - \\n.i - \\npdf-deswid / 2)
-.  if (\\npdf-offset-mode == 1) \
-.    nr pdf-offset 0
-.  if (\\npdf-offset-mode == 2) \
-.    nr pdf-offset (\\n.l - \\n.i - \\npdf-deswid)
-.
-\h'\\npdf-offsetu'\
-\X'pdf: pdfpic \\$1 -L \\npdf-deswidz \\npdf-deshtz'
+.  if (\\npdfpic*offset-mode == 0) \
+.    nr pdfpic*indentation \
+       (\\n.l - \\n.i - \\npdfpic*desired-width / 2)
+.  if (\\npdfpic*offset-mode == 1) \
+.    nr pdfpic*indentation 0
+.  if (\\npdfpic*offset-mode == 2) \
+.    nr pdfpic*indentation \
+       (\\n.l - \\n.i - \\npdfpic*desired-width)
+.
+\h'\\npdfpic*indentationu'\
+\X'pdf: pdfpic \\$1 -L \\npdfpic*desired-widthz \
+\\npdfpic*desired-heightz'
 .  if !r PDFPIC_NOSPACE \{\
-.    sy echo ".nr PDFPIC_NOSPACE 0$GROFF_PDFPIC_NOSPACE" > /tmp/x\n$$
-.    so /tmp/x\n$$
-.    sy rm /tmp/x\n$$
+.    nr PDFPIC_NOSPACE 0
+.    if \B'\\VGROFF_PDFPIC_NOSPACE' \
+.      nr PDFPIC_NOSPACE \\VGROFF_PDFPIC_NOSPACE
 .  \}
-.  if \\nPDFPIC_NOSPACE==0 \{\
+.  if \\nPDFPIC_NOSPACE=0 \{\
 .    br
-.    sp \\npdf-deshtu
+.    sp \\npdfpic*desired-heightu
 .  \}
+.
+.  pdfpic@cleanup
 ..
 .
-.cp \n_C
+.cp \n*groff_pdfpic_tmac_C
+.do rr *groff_pdfpic_tmac_C
 .
-.\" end of pdfpic.tmac
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set expandtab filetype=groff tabstop=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/pic.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/pic.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/ps.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/ps.tmac Changed

@@ -2,7 +2,7 @@
 .\"
 .\" ps.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_ps_tmac_C \n.cp
 .cp 0
 .
 .ftr AX ABI
@@ -48,9 +48,9 @@
 .
 .char \ru \D'l .5m 0'
 .
-.fchar \va \o'\ua\da'
-.fchar \ci \v'-.25m'\h'.05m'\D'c .5m'\h'.05m'\v'.25m'
-.fchar \sq \h'.05m'\D'l .5m 0'\D'l 0 -.5m'\D'l -.5m 0'\D'l 0 .5m'\h'.55m'
+.schar \va \o'\ua\da'
+.schar \ci \v'-.25m'\h'.05m'\D'c .5m'\h'.05m'\v'.25m'
+.schar \sq \h'.05m'\D'l .5m 0'\D'l 0 -.5m'\D'l -.5m 0'\D'l 0 .5m'\h'.55m'
 .fchar \Fi f\fi
 .fchar \Fl f\fl
 .fchar \ff ff
@@ -58,15 +58,15 @@
 .fchar \fl fl
 .fchar \ij ij
 .fchar \IJ IJ
-.fchar \tm \s-3\v'-.3m'TM\v'+.3m'\s+3
+.schar \tm \s-3\v'-.3m'TM\v'+.3m'\s+3
 .
-.fchar \<< <\h'-.2m'<
-.fchar \>> >\h'-.2m'>
-.fchar \|= \v'.075m'\Z'\mi'\v'-.15m'\ap\v'.075m'
-.fchar \nc \v'.1m'\Z'\h'.15m'\FT\fR/'\v'-.1m'\sp
-.fchar \ne \v'.07m'\Z'\h'.13m'\FT\fR/'\v'-.07m'\==
-.fchar \-h \FT\fI\v'-.53m'\Z'\h'.05m'\D'l .3m 0''\v'.53m'h
-.fchar \hbar \-h
+.schar \<< <\h'-.2m'<
+.schar \>> >\h'-.2m'>
+.schar \|= \v'.075m'\Z'\mi'\v'-.15m'\ap\v'.075m'
+.schar \nc \v'.1m'\Z'\h'.15m'\FT\fR/'\v'-.1m'\sp
+.schar \ne \v'.07m'\Z'\h'.13m'\FT\fR/'\v'-.07m'\==
+.schar \-h \FT\fI\v'-.53m'\Z'\h'.05m'\D'l .3m 0''\v'.53m'h
+.schar \hbar \-h
 .
 .de ps-achar
 .  \" Note that character definitions are always interpreted with
@@ -681,13 +681,18 @@
 .defcolor yellow3 rgb #cdcd00
 .defcolor yellow4 rgb #8b8b00
 .
-.cp \n_C
-.
-.do ie '\char97'a' \
-.  do mso latin1.tmac
+.ie '\char97'a' \
+.  mso latin1.tmac
 .el \
-.  do mso cp1047.tmac
+.  mso cp1047.tmac
+.
+.mso europs.tmac
 .
-.do mso europs.tmac
+.cp \n*groff_ps_tmac_C
+.do rr *groff_ps_tmac_C
 .
-.\" make sure that no blank lines creep in at the end of this file.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/psatk.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/psatk.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/psfig.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/psfig.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/psold.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/psold.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/pspic.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/pspic.tmac Changed

@@ -1,19 +1,24 @@
-.\" pspic.tmac
-.\"
 .\" Define the PSPIC macro.
 .\"
-.\" When used other than with -Tps, -Tdvi, -Thtml, or -Txhtml it draws a
-.\" box around where the picture would go.
+.\" When used with output devices other than ps, dvi, html, or xhtml,
+.\" draw a box where the picture would go.
 .\"
 .\" Usage:
 .\"
-.\"   .PSPIC -L|-R|-C|-I <indent> <file> <width> <height>
+.\"   .PSPIC -L|-R|-C|-I <indentation> <file> <width> <height>
 .
 .do if d PSPIC .nx
 .
-.nr _C \n(.C
+.do nr *groff_pspic_tmac_C \n.cp
 .cp 0
 .
+.\" This is called if the `psbb` request returned a bounding box of all
+.\" zeroes.  It already issues a diagnostic; one can append `ab` to this
+.\" macro if that should be a fatal error, or redefine it for some other
+.\" purpose.
+.de pspic*error-hook
+..
+.
 .de PSPIC
 .  nr ps-offset-mode 0
 .  \" left-aligned?
@@ -50,7 +55,7 @@
 .
 .  \" get bounding box
 .  psbb \\$1
-.  if (\\nllx : \\nlly : \\nurx : \\nury) \{\
+.  ie (\\nllx : \\nlly : \\nurx : \\nury) \{\
 .    nr ps-wid (\\nurx - \\nllx)
 .    nr ps-ht (\\nury - \\nlly)
 .    if (\\nps-wid < 0) \
@@ -158,17 +163,16 @@
 .    br
 .    sp \\nps-deshtu
 .  \}
+.  el \
+.    pspic*error-hook \\$@
 .  HTML-IMAGE-END
 ..
 .
-.cp \n_C
-.
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_pspic_tmac_C
+.do rr *groff_pspic_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72
 .\" End:
-.\" vim: set filetype=groff textwidth=72:
+.\" vim: set expandtab filetype=groff tabstop=2 textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/ptx.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/ptx.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/refer-me.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/refer-me.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/refer-ms.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/refer-ms.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/refer.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/refer.tmac Changed

@@ -2,7 +2,7 @@
 .\"
 .\" This is an interface to 'refer', originally part of 's.tmac'.
 .\"
-.\" Copyright (C) 2011-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2011-2020 Free Software Foundation, Inc.
 .\"   Written by Werner Lemberg (wl@gnu.org)
 .\"
 .\" This file is part of groff.
@@ -23,6 +23,9 @@
 .\"
 .\" Please send comments to groff@gnu.org.
 .
+.do nr *groff_refer_tmac_C \n.cp
+.cp 0
+.
 .
 .\" The following macros must be defined:
 .\"
@@ -107,10 +110,12 @@
 .\"
 .\"   ref*spec!dflt  ,  " "                       -- all other entries
 .
+.
+.if d ref*normal-print .nx
+.
 .\" start of reference
 .de -
-.	rm A B C D E G I J N O P Q R S T V
-.	rm ref*string
+.	ref*reset
 .	if d ref*item-start-hook \
 .		ref*item-start-hook
 ..
@@ -161,6 +166,12 @@
 ..
 .
 .
+.de ref*reset
+.	rm A B C D E G I J N O P Q R S T V
+.	rm ref*string
+..
+.
+.
 .de ref*normal-print
 .	ie d F \
 .		ref*text-label-start \
@@ -341,9 +352,8 @@
 ..
 .
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_refer_tmac_C
+.do rr *groff_refer_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/s.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/s.tmac Changed

@@ -2,7 +2,7 @@
 
 s.tmac
 
-Copyright (C) 1989-2018 Free Software Foundation, Inc.
+Copyright (C) 1989-2021 Free Software Foundation, Inc.
      Written by James Clark (jjc@jclark.com)
 
 This file is part of groff.
@@ -20,35 +20,81 @@
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 ..
-.if !\n(.g .ab These ms macros require groff.
+.if !\n(.g \
+.  ab groff ms macros require groff extensions; aborting
+.
 .if \n(.C \
-.	ab The groff ms macros do not work in compatibility mode.
-.\" Enable warnings (only if none are given on the command line).
-.\" You can delete this if you want.
-.if (\n.warn == 65543) .warn
+.  ab groff ms macros do not work in compatibility mode; aborting
+.
 .\" See if already loaded.
 .if r GS .nx
-.mso devtag.tmac
 .nr GS 1
-.nr need_eo_h 0
-.nr need_eo_tl 0
+.
+.mso devtag.tmac
+.nr s@devtag-needs-end-of-heading 0
+.nr s@devtag-needs-end-of-title 0
+.
+.\" Define a string for use in diagnostic messages.
+.ds @s s.tmac\"
+.
+.de @diag
+.	ds *file \" empty
+.	ds *line \" empty
+.	if !'\\n.F'' .ds *file \\n.F:\"
+.	if !'\\n.c'0' .ds *line \\n.c:\"
+.	tm \*@s:\\**file\\**line \\$*
+.	rm *file
+.	rm *line
+..
+.
 .de @error
-.tm \\n(.F:\\n(.c: macro error: \\$*
+.	@diag error: \\$*
 ..
+.
 .de @warning
-.tm \\n(.F:\\n(.c: macro warning: \\$*
+.	@diag warning: \\$*
 ..
-.de @fatal
-.ab \\n(.F:\\n(.c: fatal macro error: \\$*
+.
+.de @nop
 ..
+.
 .de @not-implemented
-.@error sorry, \\$0 not implemented
+.@error sorry, .\\$0 not implemented
 .als \\$0 @nop
 ..
-.als TM @not-implemented
-.als CT @not-implemented
-.de @nop
+.
+.\" documented Unix Version 7 ms macros that we don't implement
+.als EG @not-implemented \" engineer's notes
+.als IM @not-implemented \" internal memorandum
+.als MF @not-implemented \" memorandum for file
+.als MR @not-implemented \" memorandum for record
+.als TM @not-implemented \" technical memorandum
+.als TR @not-implemented \" technical report
+.als AT @not-implemented \" attachments
+.als CS @not-implemented \" cover sheet info for `TM` documents
+.als CT @not-implemented \" copies to
+.als OK @not-implemented \" "other keywords" for `TM` documents
+.als SG @not-implemented \" signatures for `TM` documents
+.als HO @not-implemented \" Holmdel
+.als IH @not-implemented \" Naperville (Indian Hill)
+.als MH @not-implemented \" Murray Hill
+.als PY @not-implemented \" Piscataway
+.als WH @not-implemented \" Whippany
+.als UX @not-implemented \" Unix w/ footnote trademark
+.
+.\" 4.2BSD ms macros documented by Tuthill 1983 that we don't implement
+.\"als TM @not-implemented \" thesis mode (already handled)
+.\"als CT @not-implemented \" chapter title for thesis (already handled)
+.
+.\" Wrap the .di request to save the name of the file being processed
+.\" when a diversion is started.  This aids diagnostics when diversions
+.\" are still open after input has been processed and \n.F is empty.
+.als @divert di
+.de di
+.	if \\n.$ .ds @last-file-seen \\n.F\"
+.	@divert \\$*
 ..
+.
 .de @init
 .if !rPO .nr PO \\n(.o
 .\" a non-empty environment
@@ -83,10 +129,6 @@
 .if \\n.$ .ds DY "\\$*
 .ds CF \\*DY
 ..
-.\" indexing
-.de IX
-.tm \\$1\t\\$2\t\\$3\t\\$4 ... \\nPN
-..
 .\" print an error message and then try to recover
 .de @error-recover
 .@error \\$@ (recovering)
@@ -97,7 +139,7 @@
 .	el .*div-end-default
 .	nr *pop-count +1
 .	\" ensure that we don't loop forever
-.	if \\n*pop-count>20 .@fatal recovery failed
+.	if \\n*pop-count>20 .ab \*@s: fatal error: recovery failed
 .\}
 .while !'\\n.ev'0' .ev
 .par@reset-env
@@ -116,16 +158,16 @@
 .\" ****************************
 .\" Cover sheet and first page.
 .de cov*err-not-after-first-page
-.@error \\$0 is not allowed after the first page has started
+.@error .\\$0 is not allowed after the first page has started
 ..
 .de cov*err-not-before-tl
-.@error \\$0 is not allowed before TL
+.@error .\\$0 is not allowed before .TL
 ..
 .de cov*err-not-again
-.@error \\$0 is not allowed more than once
+.@error .\\$0 is not allowed more than once
 ..
 .de cov*err-not-after-ab
-.@error \\$0 is not allowed after first AB, LP, PP, IP, SH or NH
+.@error .\\$0 is not allowed after first .AB, .LP, .PP, .IP, .SH or .NH
 ..
 .als AU cov*err-not-before-tl
 .als AI cov*err-not-before-tl
@@ -137,13 +179,15 @@
 .ch cov*first-page-init
 .rm cov*first-page-init
 .if !'\\n.ev'0' \{\
-.	@error must be in top-level environment, not '\\n.ev',
-.	@error when first page is started
+.	ds cov*msg must be in top-level environment, not '\\n.ev',\"
+.	as cov*msg " when first page is started\"
+.	@error \\*cov*msg
+.	rm cov*msg
 .\}
 .par@init
 .als RP cov*err-not-after-first-page
 .@init
-.ie \\ncov*rp-format \{\
+.ie \\ncov*use-rp-format \{\
 .	pg@cs-top
 .	als FS cov*FS
 .	als FE cov*FE
@@ -162,14 +206,21 @@
 .br
 \\*FS\\
 ..
-.nr cov*rp-format 0
-.nr cov*rp-no 0
-.\" released paper format
+.nr cov*use-rp-format 0
+.\" If we add more cover page formats, these behaviors and names could
+.\" be generalized.
+.nr cov*rp-no-repeat-info 0
+.nr cov*rp-no-renumber 0
+.\" report (AT&T: "released paper") document type
 .de RP
-.nr cov*rp-format 1
-.if \\n.$ .if '\\$1'no' .nr cov*rp-no 1
+.nr cov*use-rp-format 1
+.while \\n.$ \{\
+.	if '\\$1'no' .nr cov*rp-no-repeat-info 1
+.	if '\\$1'no-repeat-info' .nr cov*rp-no-repeat-info 1
+.	if '\\$1'no-renumber' .nr cov*rp-no-renumber 1
+.	shift
+.\}
 .if rPO .po \\n(POu
-.pn 0
 ..
 .de TL
 .br
@@ -207,7 +258,7 @@
 .	br
 .	di
 .\}
-.ie !\\ncov*n-au .@error AI before AU
+.ie !\\ncov*n-au .@error .AI before .AU
 .el \{\
 .	di cov*ai-div!\\ncov*n-au
 .	nf
@@ -259,6 +310,7 @@
 .als MC @MC
 .als EQ @EQ
 .als EN @EN
+.als PS @PS
 .als TS @TS
 .als AB cov*err-not-after-ab
 .als AU par@AU
@@ -280,10 +332,10 @@
 .par@ab-indent
 .par@reset
 .if !'\\$1'no' \{\
-.       if '\*(.T'html'  \{\
+.	if '\*(.T'html' \{\
 .		nf
 .		sp
-.       \}
+.	\}
 .	ft I
 .	ce 1
 \\*ABSTRACT
@@ -314,22 +366,26 @@
 .	par@reset
 .	cov*print
 .  \}
-.  el .@error AE without AB
+.  el .@error .AE without .AB
 .\}
 ..
 .de @div-end!cov*ab-div
 .AE
 ..
+.de cov*break-page
+.ie \\ncov*rp-no-renumber .bp
+.el .bp 1
+..
 .de cov*print
 .als cov*print @nop
 .ie d cov*tl-div \{\
-.	ie \\ncov*rp-format .cov*rp-print
+.	ie \\ncov*use-rp-format .cov*rp-print
 .	el .cov*draft-print
 .\}
 .el \{\
-.	if \\ncov*rp-format \{\
-.		@warning RP format but no TL
-.		bp 1
+.	if \\ncov*use-rp-format \{\
+.		@warning .RP format but no .TL
+.		.cov*break-page
 .		als FS @FS
 .		als FE @FE
 .		CHECK-FOOTER-AND-KEEP
@@ -357,7 +413,7 @@
 .	ev nf
 .	cov*fn-div
 .	ev
-.	ie \\ncov*rp-no .rm cov*fn-div
+.	ie \\ncov*rp-no-repeat-info .rm cov*fn-div
 .	el \{\
 .		rn cov*fn-div fn@overflow-div
 .		nr fn@have-overflow 1
@@ -368,10 +424,11 @@
 .CHECK-FOOTER-AND-KEEP
 .\" If anything was printed below where the footer line is normally
 .\" printed, then that's an overflow.
-.if -\\nFM/2+1v+\\ncov*page-length<\\nnl .@error cover sheet overflow
+.if -\\nFM/2+1v+\\ncov*page-length<\\nnl \
+.	@error cover sheet overflow
 .pl \\ncov*page-lengthu
-.bp 1
-.if !\\ncov*rp-no .cov*tl-au-print
+.cov*break-page
+.if !\\ncov*rp-no-repeat-info .cov*tl-au-print
 .rs
 .sp 1
 ..
@@ -391,17 +448,17 @@
 .sp 3
 .ce 9999
 .if d cov*tl-div \{\
-.    cov*tl-div
-.    DEVTAG-EO-TL
+.	cov*tl-div
+.	DEVTAG-EO-TL
 .\}
 .nr cov*i 1
 .nr cov*sp 1v
 .while \\ncov*i<=\\ncov*n-au \{\
-.       ie '\*(.T'html' .br
+.	ie '\*(.T'html' .br
 .	el .sp \\ncov*spu
 .	cov*au-div!\\ncov*i
 .	ie d cov*ai-div!\\ncov*i \{\
-.		sp .5v	
+.		sp .5v
 .		cov*ai-div!\\ncov*i
 .		nr cov*sp 1v
 .	\}
@@ -415,7 +472,7 @@
 .\" start of footnote on cover
 .de cov*FS
 .if \\ncov*in-fn \{\
-.	@error nested FS
+.	@error nested .FS
 .	FE
 .\}
 .nr cov*in-fn 1
@@ -438,7 +495,7 @@
 .	nr cov*in-fn 0
 .	nr cov*fn-height +\\ndn
 .\}
-.el .@error FE without matching FS
+.el .@error .FE without matching .FS
 ..
 .\" ***************************
 .\" ******** module pg ********
@@ -454,7 +511,7 @@
 .ds CF
 .ds RF
 .ds LH
-.ds CH -\EnPN-
+.ds CH -\En%-\"
 .ds RH
 .ds pg*OH '\E*LH'\E*CH'\E*RH'
 .ds pg*EH '\E*LH'\E*CH'\E*RH'
@@ -466,31 +523,36 @@
 .als EH OH
 .als OF OH
 .als EF OH
+.aln PN % \" Lesk 1978 documents PN.
 .de PT
-.ie \\n%=1 .if \\npg*P1 .tl \\*pg*OH
+.\" To compare the page number to 1, we need it in Arabic format.
+.ds pg*saved-page-number-format \\g%\"
+.af % 0
+.nr pg*page-number-in-decimal \\n%
+.af % \\*pg*saved-page-number-format
+.fam \\*pg@titles-font-family
+.ie \\npg*page-number-in-decimal=1 .if \\npg*P1 .tl \\*pg*OH
 .el \{\
 .	ie o .tl \\*pg*OH
 .	el .tl \\*pg*EH
 .\}
+.rm pg*saved-page-number-format
 ..
 .de BT
+.fam \\*pg@titles-font-family
 .ie o .tl \\*pg*OF
 .el .tl \\*pg*EF
 ..
 .nr pg*P1 0
 .de P1
-.ie r bell_localisms \{\
-.	DS L
-.	ft CW
-.\}
-.el .nr pg*P1 1
+.nr pg*P1 1
 ..
 .wh -\nFMu pg@bottom
 .wh -\nFMu/2u pg*footer
 .nr MINGW 2n
 .nr pg@ncols 1
 .de @MC
-.if !'\\n(.z'' .error-recover MC while diversion open
+.if !'\\n(.z'' .@error-recover .MC while diversion open
 .br
 .ie \\npg@ncols>1 .pg@super-eject
 .el \{\
@@ -501,8 +563,8 @@
 .	\}
 .\}
 .ie !\\n(.$ \{\
-.	nr pg@colw \\nLL*7/15
-.	nr pg*gutw \\nLL-(2*\\npg@colw)
+.	nr pg*gutw \\nMINGW
+.	nr pg@colw \\nLL-\\npg*gutw/2u
 .	nr pg@ncols 2
 .\}
 .el \{\
@@ -515,10 +577,10 @@
 .	el .nr pg*gutw 0
 .\}
 .DEVTAG ".mc \\npg@ncols \\npg@colw \\npg*gutw"
-.ns
 .nr pg*col-num 0
-.nr pg@fn-colw \\npg@colw*5/6
+.nr pg@fn-colw \\npg@colw*\\*FR
 .par@reset
+.ns
 .mk pg*col-top
 ..
 .de 2C
@@ -527,10 +589,17 @@
 .de 1C
 .MC \\nLLu
 ..
-.\" top of page macro
 .de pg@top
+.\" invoked by '.wh 0' trap at the top of every page
+.\"
+.\" At short page lengths, footers may get truncated or recursion may
+.\" occur; ensure that the page length suffices to avoid these problems.
+.if (u;\\nHM+\\nFM+\n.V>=\\n.p) \{\
+.	@error insufficient page length; aborting\"
+.	pl \\nnlu
+.	ab
+.\}
 .ch pg*footer -\\nFMu/2u
-.nr PN \\n%
 .nr pg*col-num 0
 .nr pg@fn-bottom-margin 0
 .po \\nPOu
@@ -592,7 +661,7 @@
 .		pn \\npg*next-number
 .		rr pg*next-number
 .		if d pg*next-format \{\
-.			af PN \\*pg*next-format
+.			af % \\*pg*next-format
 .			rm pg*next-format
 .		\}
 .	\}
@@ -619,7 +688,12 @@
 .\" flush out any keeps or footnotes
 .de pg@super-eject
 .br
-.if !'\\n(.z'' .@error-recover diversion open while ejecting page
+.if !'\\n(.z'' \{\
+.	ds @msg diversion open while ejecting page\"
+.	as @msg " (last file seen: \\*@last-file-seen)\"
+.	@error-recover \\*@msg
+.	rm @msg
+.\}
 .\" Make sure we stay in the end macro while there is still footnote
 .\" overflow left, or floating keeps.
 .while \\nkp@tail>\\nkp@head:\\npg@fn-flag \{\
@@ -647,19 +721,34 @@
 .ev
 .nr fn*text-num 0 1
 .nr fn*note-num 0 1
-.ds * \E*par@sup-start\En+fn*text-num\E*par@sup-end
 .nr fn*open 0
+.\" Handle initialition tasks deferred until par module is set up.
+.de fn@init
+.ie t .als fn@mark-start par@sup-start
+.el .ds fn@mark-start 
+.ie t .als fn@mark-end par@sup-end
+.el .ds fn@mark-end 
+.ds * \E*fn@mark-start\En+fn*text-num\E*fn@mark-end
+..
 .\" normal FS
+.\" FS-MARK is a user definable hook, which may be used to perform
+.\" any set-up actions, (e.g. planting an HREF link as the footnote
+.\" mark, in the document text); passed the same arguments as have
+.\" been passed to FS itself, unless redefined, it is a no-op.
 .de @FS
+.FS-MARK \\$@
 .ie \\n.$ .fn*do-FS "\\$1" no
 .el \{\
 .	ie \\nfn*text-num>\\nfn*note-num .fn*do-FS \\n+fn*note-num
 .	el .fn*do-FS
 .\}
 ..
+.\" Default no-op fallback for FS-MARK
+.de FS-MARK
+..
 .\" Second argument of 'no' means don't embellish the first argument.
 .de fn*do-FS
-.if \\nfn*open .@error-recover nested FS
+.if \\nfn*open .@error-recover nested .FS
 .nr fn*open 1
 .if \\n.u \{\
 .	\" Ensure that the first line of the footnote is on the same page
@@ -675,11 +764,12 @@
 .par@reset-env
 .fn*start-div
 .par@reset
+.fam \\*fn@font-family
 .ie \\n.$ .FP \\$@
 .el .@LP
 ..
 .de @FE
-.ie !\\nfn*open .@error FE without FS
+.ie !\\nfn*open .@error .FE without .FS
 .el \{\
 .	nr fn*open 0
 .	br
@@ -813,26 +903,26 @@
 .\" Keeps.
 .de KS
 .br
-.di kp*div
+.di kp@div
 ..
 .de KF
-.if !'\\n(.z'' .@error-recover KF while open diversion
-.di kp*fdiv
+.if !'\\n(.z'' .@error-recover .KF while diversion open
+.di kp@fdiv
 .ev k
 .par@reset-env
 .par@reset
 ..
 .de KE
-.ie '\\n(.z'kp*div' .kp*end
+.ie '\\n(.z'kp@div' .kp*end
 .el \{\
-.	ie '\\n(.z'kp*fdiv' .kp*fend
-.	el .@error KE without KS or KF
+.	ie '\\n(.z'kp@fdiv' .kp*fend
+.	el .@error .KE without .KS or .KF
 .\}
 ..
-.de @div-end!kp*div
+.de @div-end!kp@div
 .kp*end
 ..
-.de @div-end!kp*fdiv
+.de @div-end!kp@fdiv
 .kp*fend
 ..
 .de kp*need
@@ -845,9 +935,9 @@
 .di
 .kp*need \\ndn
 .ev nf
-.kp*div
+.kp@div
 .ev
-.rm kp*div
+.rm kp@div
 ..
 .\" Floating keeps.
 .nr kp@head 0
@@ -860,12 +950,12 @@
 .ie \\n.t-(\\n.k>0*1v)>\\ndn \{\
 .	br
 .	ev nf
-.	kp*fdiv
-.	rm kp*fdiv
+.	kp@fdiv
+.	rm kp@fdiv
 .	ev
 .\}
 .el \{\
-.	rn kp*fdiv kp*div!\\nkp@tail
+.	rn kp@fdiv kp@div!\\nkp@tail
 .	nr kp*ht!\\nkp@tail 0\\ndn
 .	nr kp@tail +1
 .\}
@@ -891,7 +981,7 @@
 .		\" back the keep, so that if the last line of the
 .		\" last keep springs the bottom of page trap, a new
 .		\" page will not be started unnecessarily.
-.		rn kp*div!\\nkp@head kp*temp
+.		rn kp@div!\\nkp@head kp*temp
 .		nr kp@head +1
 .		ev nf
 .		kp*temp
@@ -908,6 +998,7 @@
 .de DE
 .ds*end!\\n\\n.ev:ds-type
 .nr \\n.ev:ds-type 0
+.ns
 ..
 .de ds@auto-end
 .if \\n\\n.ev:ds-type \{\
@@ -920,7 +1011,7 @@
 .el .ds*end!2
 ..
 .de ds*end!0
-.@error DE without DS, ID, CD, LD or BD
+.@error .DE without .DS, .ID, .CD, .LD, .RD, or .BD
 ..
 .de LD
 .br
@@ -962,10 +1053,11 @@
 .	rm ds*div
 .	ds*common-end
 .\}
-.el .@error-recover mismatched DE
+.el .@error-recover mismatched .DE
 ..
 .de DS
-.br
+.if '\\n(.z'ds*div' .@error-recover cannot begin display within display
+.nr ds*badarg 0
 .di ds*div
 .ie '\\$1'B' \{\
 .	LD
@@ -979,12 +1071,23 @@
 .			ie '\\$1'R' .RD
 .			el \{\
 .				ie '\\$1'I' .ID \\$2
-.				el .ID \\$1
+.				el \{\
+.					ie '\\$1'' .ID
+.					el .nr ds*badarg 1
+.				\}
 .			\}
 .		\}
 .	\}
-.	nr \\n.ev:ds-type 3
+.	ie \\nds*badarg \{\
+.		ds ds*msg unrecognized argument '\\$1' to .\\$0;\"
+.		as ds*msg " did you mean '.\\$0 I \\$1'?\"
+.		@error \\*ds*msg
+.		rm ds*msg
+.		di
+.	\}
+.	el .nr \\n.ev:ds-type 3
 .\}
+.rr ds*badarg
 ..
 .de ds@need
 .if '\\n(.z'' \{\
@@ -1005,7 +1108,7 @@
 .	rm ds*div
 .	ds*common-end
 .\}
-.el .@error-recover mismatched DE
+.el .@error-recover mismatched .DE
 ..
 .de ds*end!4
 .ie '\\n(.z'ds*div' \{\
@@ -1018,7 +1121,7 @@
 .	rm ds*div
 .	ds*common-end
 .\}
-.el .@error-recover mismatched DE
+.el .@error-recover mismatched .DE
 ..
 .\" ****************************
 .\" ******** module par ********
@@ -1028,7 +1131,7 @@
 .de par@load-init
 .\" PS and VS might have been set on the command line
 .if !rPS .nr PS 10
-.if !rLL .nr LL 6i
+.if !rLL .nr LL 6.5i
 .ll \\nLLu
 .\" don't set LT so that it can be defaulted from LL
 .ie rLT .lt \\nLTu
@@ -1080,7 +1183,7 @@
 .\" happens when the first page begins
 .de par@init
 .if !rLT .nr LT \\nLL
-.if !rFL .nr FL \\nLL*5/6
+.if !rFL .nr FL \\nLL*\\*FR
 .if !rVS \{\
 .	ie (\\nPS >= 1000) \
 .		nr VS (\\nPS + 2000)
@@ -1118,6 +1221,8 @@
 .if !rFPD .nr FPD \\nPD/2
 .ev
 .if !dFAM .ds FAM \\n.fam
+.ds pg@titles-font-family \\*FAM
+.ds fn@font-family \\*FAM
 .nr par*adj \\n.j
 .par*env-init
 .ev h
@@ -1154,25 +1259,17 @@
 .\" par@reset
 .de par@reset
 .br
-.if \\nneed_eo_tl>0 .DEVTAG-EO-TL
-.nr need_eo_tl 0
-.if \\nneed_eo_h>0 .DEVTAG-EO-H
-.nr need_eo_h 0
+.if \\ns@devtag-needs-end-of-title .DEVTAG-EO-TL
+.nr s@devtag-needs-end-of-title 0
+.if \\ns@devtag-needs-end-of-heading .DEVTAG-EO-H
+.nr s@devtag-needs-end-of-heading 0
 .ce 0
 .rj 0
 .ul 0
 .fi
-.ie \\npg@ncols>1 \{\
-.	ll (u;\\n\\n.ev:MCLL-\\n\\n.ev:ri-\\n\\n.ev:pri)
-.	lt \\n\\n.ev:MCLTu
-.\}
-.el \{\
-.	ll (u;\\n\\n.ev:LL-\\n\\n.ev:ri-\\n\\n.ev:pri)
-.	lt \\n\\n.ev:LTu
-.\}
-.in (u;\\n\\n.ev:li+\\n\\n.ev:pli)
 .ft 1
-.fam \\*FAM
+.ie '\\n.ev'fn' .fam \\*fn@font-family
+.el .fam \\*FAM
 .ie (\\n\\n.ev:PS >= 1000) \
 .	ps (\\n\\n.ev:PSz / 1000u)
 .el \
@@ -1182,14 +1279,20 @@
 .el \
 .	par*vs \\n\\n.ev:VS
 .ls 1
+.if !'\\$1'' .nr \\n.ev:pli (n;\\$1)
+.if !'\\$2'' .nr \\n.ev:pri (n;\\$2)
+.ie \\npg@ncols>1 \{\
+.	ll (u;\\n\\n.ev:MCLL-\\n\\n.ev:ri-\\n\\n.ev:pri)
+.	lt \\n\\n.ev:MCLTu
+.\}
+.el \{\
+.	ll (u;\\n\\n.ev:LL-\\n\\n.ev:ri-\\n\\n.ev:pri)
+.	lt \\n\\n.ev:LTu
+.\}
+.in (u;\\n\\n.ev:li+\\n\\n.ev:pli)
 .TA
 .hy \\nHY
 ..
-.de @RT
-.nr \\n.ev:pli 0
-.nr \\n.ev:pri 0
-.par@reset
-..
 .\" This can be redefined by the user.
 .de TA
 .ta T 5n
@@ -1201,17 +1304,17 @@
 .
 .de par*start
 .ds@auto-end
-.nr \\n.ev:pli \\$1
-.nr \\n.ev:pri \\$2
-.par@reset
+.par@reset \\$1 \\$2
 .sp \\n\\n.ev:PDu
 .ne \\nPORPHANSv+\\n(.Vu
 ..
 .de par@finish
+.nr \\n.ev:ai \\n\\n.ev:PI
 .nr \\n.ev:pli 0
 .nr \\n.ev:pri 0
-.par@reset
+.par@reset 0 0
 ..
+.als @RT par@finish
 .\" normal LP
 .de @LP
 .par*start 0 0
@@ -1224,15 +1327,18 @@
 ..
 .de @QP
 .nr \\n.ev:ai \\n\\n.ev:PI
-.par*start \\nQI \\nQI
+.par*start \\nQIu \\nQIu
 ..
 .de @XP
-.par*start \\n\\n.ev:PI 0
+.par*start \\n\\n.ev:PIu 0
 .ti -\\n\\n.ev:PIu
 ..
 .de @IP
-.if \\n.$>1 .nr \\n.ev:ai (n;\\$2)
-.par*start \\n\\n.ev:ai 0
+.ie \\n.$>1 \{\
+.par*start \\$2 0
+.nr \\n.ev:ai \\n\\n.ev:pli
+.\}
+.el .par*start \\n\\n.ev:aiu 0
 .if !'\\$1'' \{\
 .	\" Divert the label so as to freeze any spaces.
 .	di par*label
@@ -1264,13 +1370,14 @@
 .nr par*saved-font \\n.f
 .nr par*saved-size \\n.sz
 .nr par*saved-ss \\n.ss
+.nr par*saved-sss \\n.sss
 .ds par*saved-fam \\n.fam
 .ev par
 .nf
 .TA
 .ft \\npar*saved-font
 .ps \\npar*saved-sizeu
-.ss \\npar*saved-ss
+.ss \\npar*saved-ss \\npar*saved-sss
 .fam \\*par*saved-fam
 ..
 .de par*pop-tag-env
@@ -1298,7 +1405,7 @@
 .	nr \\n.ev:pli \\n\\n.ev:pli!\\n\\n.ev:il
 .	nr \\n.ev:pri \\n\\n.ev:pri!\\n\\n.ev:il
 .\}
-.el .@error unbalanced \\$0
+.el .@error unbalanced .\\$0
 .ie '\\$0'QE' .par*start 0 0
 .el .par@reset
 ..
@@ -1355,7 +1462,7 @@
 .	lt +\\npar*box-nu
 .	par*box-draw \\n.iu \\n.lu-(\\n.Hu==1n*1n)
 .\}
-.el .@error B2 without B1
+.el .@error .B2 without .B1
 .HTML-IMAGE-END
 ..
 .de par*box-mark-top
@@ -1425,7 +1532,7 @@
 .  if 0\\$1>0 .nr sh*psincr (\\nGROWPS-0\\$1)*\\nPSINCR
 .  SH-NO-TAG
 .  DEVTAG-SH 1
-.  if '\*(.T'html' .nr need_eo_h 1
+.  if '\*(.T'html' .nr s@devtag-needs-end-of-heading 1
 ..
 .\" TL, AU, and AI are aliased to these in cov*ab-init.
 .de par@TL
@@ -1436,7 +1543,7 @@
 .vs +3p
 .ce 9999
 .DEVTAG-TL
-.nr need_eo_tl 1
+.nr s@devtag-needs-end-of-title 1
 ..
 .de par@AU
 .par@finish
@@ -1451,56 +1558,75 @@
 ..
 .\" In paragraph macros.
 .de NL
+.if \En.$ .@warning arguments to .NL ignored
 .ie (\\n\\n.ev:PS >= 1000) \
 .	ps (\\n\\n.ev:PSz / 1000u)
 .el \
 .	ps \\n\\n.ev:PS
 ..
 .de SM
+.if \En.$ .@warning arguments to .SM ignored
 .ps -2
 ..
 .de LG
+.if \En.$ .@warning arguments to .LG ignored
 .ps +2
 ..
-.de R
-.ft R
-..
-.\" par*define-font-macro macro font
+.\" par*define-font-macro macro font apply-italic-corrections
 .de par*define-font-macro
 .de \\$1
+.ds par*lic \" empty
+.ds par*ic \" empty
+.if \\n.$>2 \{\
+.	as par*lic \,\"
+.	as par*ic \/\"
+.\}
+.if \En.$>3 .@warning excess arguments to .\\$1 ignored
 .ie \En.$ \{\
 .	nr par*prev-font \En.f
-\&\E$3\f\\$2\E$1\f\Enpar*prev-font\E$2
+\&\E$3\E*par*lic\f\\$2\E$1\f\Enpar*prev-font\E*par*ic\E$2
 .\}
 .el .ft \\$2
 \\..
 ..
+.par*define-font-macro R R
 .par*define-font-macro B B
-.par*define-font-macro I I
-.par*define-font-macro BI BI
-.par*define-font-macro CW CR
+.par*define-font-macro I I yes
+.par*define-font-macro BI BI yes
+.ie n .par*define-font-macro CW R
+.el   .par*define-font-macro CW CR
 .\" underline a word
 .de UL
-\Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'\\$2
+.if \En.$>2 .@warning excess arguments to .UL ignored
+.	ie t .do nop \Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'\\$2
+.	el \(ul\\$1\(ul\\$2
 ..
 .\" box a word
 .de BX
-.nr par*bxw \w'\\$1'+.4m
-\Z'\v'.25m'\D'l 0 -1m'\D'l \\npar*bxwu 0'\D'l 0 1m'\D'l -\\npar*bxwu 0''\
-\Z'\h'.2m'\\$1'\
-\h'\\npar*bxwu'
-..
-.\" The first time UX is used, put a registered mark after it.
-.ds par*ux-rg \(rg
-.de UX
-\s\\n.s*8u/10uUNIX\s0\\$1\\*par*ux-rg
-.ds par*ux-rg
+.if \En.$>1 .@warning excess arguments to .BX ignored
+.nr par*bxw \w'\\$1'
+.ie t \{\
+.nr par*bxw +.4m
+\Z'\v'.25m'\
+\D'l 0 -1m'\D'l \\npar*bxwu 0'\D'l 0 1m'\D'l -\\npar*bxwu 0''\
+\Z'\h'.2m'\\$1'\h'\\npar*bxwu'
+.\}
+.el \mblack\Mwhite\Z'\\$1'\h'\\npar*bxwu'\m\M
 ..
+.\" superscript
 .ds par@sup-start \v'-.9m\s'\En.s*7u/10u'+.7m'
 .als { par@sup-start
 .ds par@sup-end \v'-.7m\s0+.9m'
 .als } par@sup-end
+.\" subscript
+.ds par@sub-start \v'+.3m\s'\En.s*7u/10u'-.1m'
+.als < par@sub-start
+.ds par@sub-end \v'+.1m\s0-.3m'
+.als > par@sub-end
 .\" footnote paragraphs
+.fn@init
+.\" FR is the ratio of footnote (horizontal) length to the line length
+.ds FR 11/12
 .\" FF is the footnote format
 .nr FF 0
 .\" This can be redefined. It gets a second argument of 'no' if the
@@ -1516,7 +1642,7 @@
 ..
 .de par*fp!0
 .@PP
-\&\\*par@sup-start\\$1\\*par@sup-end\ \c
+\&\\*fn@mark-start\\$1\\*fn@mark-end\ \c
 ..
 .de par*fp!0-no
 .@PP
@@ -1585,8 +1711,12 @@
 .			nr nh*hl 1
 .		\}
 .		el \{\
-.			if \\nnh*hl-\\nnh*ohl>1 \
-.				@warning .NH \\nnh*ohl followed by .NH \\nnh*hl
+.			if \\nnh*hl-\\nnh*ohl>1 \{\
+.				ds nh*msg .NH \\nnh*ohl followed by\"
+.				as nh*msg " .NH \\nnh*hl\"
+.				@warning \\*nh*msg
+.				rm nh*msg
+.			\}
 .		\}
 .	\}
 .	el .nr nh*hl 1
@@ -1606,7 +1736,7 @@
 .nr sh*psincr (\\nGROWPS-\\nnh*hl)*\\nPSINCR
 .SH-NO-TAG
 .DEVTAG-NH "\\$1"
-.  if '\*(.T'html' .nr need_eo_h 1
+.if '\*(.T'html' .nr s@devtag-needs-end-of-heading 1
 \\*SN-STYLE
 ..
 .\" ****************************
@@ -1626,17 +1756,16 @@
 .ie '\\n(.z'toc*div' \{\
 .	if d toc*num .toc*end-entry
 .	ie \\n.$ \{\
-.		ie '\\$1'no' .ds toc*num
+.		ie '\\$1'no' .ds toc*num \" empty
 .		el .ds toc*num "\\$1
 .	\}
-.	el .ds toc*num \\nPN
+.	el .ds toc*num \\n%\"
 .	br
 .	par@reset
 .	na
-.	ll -8n
 .	in (n;0\\$2)
 .\}
-.el .@error XA without XS
+.el .@error .XA without .XS
 ..
 .de XE
 .ie '\\n(.z'toc*div' \{\
@@ -1644,10 +1773,60 @@
 .	ev
 .	di
 .\}
-.el .@error XE without XS
+.el .@error .XE without .XS
+..
+.\" Rudimentary integration of TOC generation with SH and NH;
+.\" (called by XH and XN respectively, to capture heading text
+.\" for reuse as TOC entry); may be redefined, to achieve more
+.\" sophisticated TOC layout effects.
+.\"
+.\" No-op initializers are called by XH and XN respectively,
+.\" before XH-UPDATE-TOC is called; if XH-UPDATE-TOC has been
+.\" redefined, then it may also be necessary to redefine either,
+.\" or both of these, to perform any initialization specific
+.\" to use after SH and NH respectively.
+.de XH-INIT de
+.de XN-INIT
+..
+.de XH-UPDATE-TOC
+.\" .XH-UPDATE-TOC <outline-level> <text>
+.XS
+.in (\\$1u - 1u * 2n)
+.shift
+\&\\$*
+.XE
+..
+.\" Rudimentary integration hook, to be called (nominally)
+.\" after SH, but acceptable in any body-text context
+.de XH de
+.\" .XH <outline-level> <text>
+.rn XH-REPLACEMENT XH
+.XH \\$@
+.de XH-REPLACEMENT
+.XH-INIT
+.XH-UPDATE-TOC \\$@
+.shift
+\&\\$*
+..
+.\" Rudimentary integration hook, to be called after NH
+.de XN de
+.\" .XN <text>
+.ie \\nnh*hl .toc*xn-init \\$@
+.el \{\
+.	@error .XN is not allowed before .NH
+.	nop \&\\$*
+.\}
+.de toc*xn-init de
+.rn XN-REPLACEMENT XN
+.XN \\$@
+.rm \\$0
+.de XN-REPLACEMENT
+.XN-INIT
+.XH-UPDATE-TOC \\nnh*hl \\$@
+\&\\$*
 ..
 .de toc*end-entry
-\\a\\t\\*toc*num
+.if !'\\*toc*num'' \\a\\t\\*toc*num
 .br
 .rm toc*num
 ..
@@ -1665,9 +1844,10 @@
 .	ps
 .\}
 .nf
-.char \toc*leader-char .\h'1m'
-.lc \toc*leader-char
-.ta (u;\\n.l-\\n.i-\w'000') (u;\\n.l-\\n.i)R
+.if !r TC-MARGIN .nr TC-MARGIN \w'000'
+.if !c \TC-LEADER .char \TC-LEADER .\h'1m'
+.ta (u;\\n.l-\\n.i-\\nTC-MARGIN) (u;\\n.l-\\n.i)R
+.lc \TC-LEADER
 .sp 2
 .toc*div
 .par@reset
@@ -1687,6 +1867,8 @@
 .de EN
 ..
 .de @EQ
+.if \\ntbl@within-table \
+.	@error .EQ is not allowed within a .TS/.TE table
 .br
 .ds eqn*num "\\$2
 .ie '\\$1'L' .nr eqn*type 0
@@ -1716,7 +1898,7 @@
 ..
 .\" Note that geqn mark and lineup work correctly in centered equations.
 .de @EN
-.ie !'\\n(.z'eqn*div' .@error-recover mismatched EN
+.ie !'\\n(.z'eqn*div' .@error-recover mismatched .EN
 .el \{\
 .	br
 .	di
@@ -1724,13 +1906,14 @@
 .	if !'\\*eqn*num'' .nr eqn*have-num 1
 .	ie \\ndl:\\neqn*have-num \{\
 .		sp \\nDDu
+.		ns
 .		par@reset
 .		ds eqn*tabs \\n.tabs
 .		nf
 .		ie \\ndl \{\
-.\"                     --fixme-- this really should not be necessary
-.\"                     and indicates that there is extra space creeping
-.\"                     into an equation when ps4html is enabled..
+.\"			XXX: This really should not be necessary and
+.\"			indicates that there is extra space creeping
+.\"			into an equation when ps4html is enabled.
 .			ie r ps4html .ds@need \\ndnu-1v+\n.Vu+1i
 .			el .ds@need \\ndnu-1v+\n.Vu
 .			chop eqn*div
@@ -1752,6 +1935,7 @@
 .		\}
 .\".		if !'\*(.T'html' .sp \\nDDu
 .		sp \\nDDu
+.		ns
 .		ta \\*eqn*tabs
 .	\}
 .	el \{\
@@ -1777,16 +1961,25 @@
 .\" ******** module tbl ********
 .\" ****************************
 .\" Tbl support.
+.nr tbl@within-table 0
 .nr tbl*have-header 0
 .\" This gets called if TS occurs before the first paragraph.
 .de TS
 .LP
-.\" cov*ab-init aliases TS to @TS
+.\" cov*ab-init, called by LP, aliases TS to @TS.
 \\*TS\\
 ..
 .de @TS
+.nr tbl@within-table 1
 .sp \\nDDu
-.if '\\$1'H' .di tbl*header-div
+.if '\\$1'H' \{\
+.	ds tbl*stem .TS H table inside\"
+.	ie '\\n.z'kp@div' .@warning \\*tbl*stem .KS/.KE keep
+.	el .if '\\n.z'kp@fdiv' \
+.		@warning \\*tbl*stem .KF/.KE floating keep
+.	rm tbl*stem
+.	di tbl*header-div
+.\}
 .if '\*(.T'html' \{\
 .	nr tbl*ll \\n.l
 .	ll 1000n
@@ -1811,8 +2004,13 @@
 .	T#
 .	br
 .	di
-.	ie \\ndn+\\nFM+\\nHM+2v>=\\n.p \{\
-.		@error ridiculously long table header
+.	\" A table with repeating headings requires enough room for them
+.	\" and then at least one more vee for a row of data.
+.	ie \\ndn+1v>=(\\n.p-\\nFM-\\nHM) \{\
+.		ds tbl*err .TH repeating table heading(s) do not fit in
+.		as tbl*err " page area; formatting only once
+.		@error \\*tbl*err
+.		rm tbl*err
 .		ds@need \\ndn
 .		tbl*print-header
 .	\}
@@ -1833,13 +2031,17 @@
 .ie '\\n(.z'tbl*header-div' .@error-recover .TS H but no .TH before .TE
 .el \{\
 .	nr tbl*have-header 0
-.       if !'\*(.T'html' .sp \\nDDu
+.	if !'\*(.T'html' \{\
+.		sp \\nDDu
+.		ns
+.	\}
 .\}
 .HTML-IMAGE-END
 .if '\*(.T'html' \
 .	ll \\ntbl*llu
 .\" reset tabs
 .TA
+.nr tbl@within-table 0
 ..
 .de tbl@bottom-hook
 .if \\ntbl*have-header \{\
@@ -1853,20 +2055,34 @@
 .\" ******** module pic ********
 .\" ****************************
 .\" Pic support.
-.\" PS height width
+.\" This gets called if PS occurs before the first paragraph.
 .de PS
+.LP
+.\" cov*ab-init, called by LP, aliases PS to @PS.
+\\*PS\\
+..
+.\" @PS height width
+.de @PS
 .br
 .sp \\nDDu
-.ie \\n.$<2 .@error bad arguments to PS (not preprocessed with pic?)
+.ie !\\n.$=2 \{\
+.	ds pic*msg .PS: expected 2 arguments, got \\n.$\"
+.	as pic*msg ; not preprocessed with pic?\"
+.	@error \\*pic*msg
+.	rm pic*msg
+.\}
 .el \{\
 .	ds@need (u;\\$1)+1v
 .	in +(u;\\n.l-\\n.i-\\$2/2>?0)
 .\}
 .HTML-IMAGE
 ..
-.de PE
+.de PF
 .HTML-IMAGE-END
 .par@reset
+..
+.de PE
+.PF
 .sp \\nDDu+.5m
 ..
 .\" ****************************
@@ -1882,10 +2098,6 @@
 .ds U \(rq
 .ds - \(em
 .\" Characters
-.\" The idea of this definition is for the top of the 3 to be at the
-.\" x-height.
-.if !c\yogh .char \yogh \Z'\v'\w'x'*0-\Enrstu'\s\En.s*8u/10u\
-\v'\w'3'*0+\Enrstu'3\s0'\h'\w'\s\En.s*8u/10u3'u'
 .\" Accents
 .de acc*over-def
 .ds \\$1 \Z'\v'(u;\w'x'*0+\Enrst-\En.cht)'\
@@ -1923,6 +2135,10 @@
 .acc*slash-def / /
 .char \hooko o\E*hook
 .ds q \hooko
+.\" The idea of this definition is for the top of the 3 to be at the
+.\" x-height.
+.if !c\yogh .char \yogh \Z'\v'\w'x'*0-\Enrstu'\s\En.s*8u/10u\
+\v'\w'3'*0+\Enrstu'3\s0'\h'\w'\s\En.s*8u/10u3'u'
 .ds 3 \yogh
 .ds D- \(-D\"			Icelandic uppercase eth
 .ds d- \(Sd\"			Icelandic lowercase eth
@@ -1954,41 +2170,6 @@
 .\}
 ..
 .par@load-init
-.\" ****************************
-.\" ******** module bell ********
-.\" ****************************
-.\" Emulate Bell Labs localisms. Note, (a) they're not documented, and
-.\" (b) the .P1 and .UC macros collide with different ones in Berkeley
-.\" ms.  We hack around this by conditionalizing the behavior of P1; UC
-.\" was not defined by groff and will be a no-op if called Berkeley
-.\" style with no arguments, so there is no problem with hijacking it
-.\" here.
-.\"
-.\" What's done here is sufficient to give back the Guide to EQN (1976)
-.\" its section headings and restore some text that had gone missing as
-.\" macro arguments; no warranty express or implied is given as to how
-.\" well the typographic details these produce match the original Bell
-.\" Labs macros.
-.\"
-.\" P1 is now defined in module pg.
-.de SC
-.nr bell_localisms 1
-.NH 
-\\$*
-..
-.de UC
-.if r bell_localisms \f(CW\\$*\fP
-..
-.de P2
-.if r bell_localisms \{\
-.	ft
-.	DE
-.\}
-..
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/tmac/sv.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/sv.tmac Changed

@@ -1,6 +1,6 @@
 .\" Swedish localization for groff
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2022 Free Software Foundation, Inc.
 .\"   Written by Werner Lemberg (wl@gnu.org)
 .\"
 .\" This file is part of groff.
@@ -21,8 +21,17 @@
 .\"
 .\" Please send comments to groff@gnu.org.
 .
+.do nr *groff_sv_tmac_C \n.cp
+.cp 0
+.
+.
+.\" If changing from an existing locale, we need to preserve the state
+.\" of the "suppress hyphenation before a page location trap" bit.
+.nr locale*use-trap-hyphenation-mode 0
+.if d locale \
+.  if \n.hy=\n\*locale*hyphenation-mode-trap \
+.    nr locale*use-trap-hyphenation-mode 1
 .
-.\" Locale string
 .
 .ds locale swedish\"
 .
@@ -31,6 +40,7 @@
 .
 .ds \*locale-abstract ABSTRAKT\"
 .ds \*locale-app Bilaga\"
+.ds \*locale-appendix_string Bilaga\"
 .ds \*locale-april april\"
 .ds \*locale-attribute_string av\"
 .ds \*locale-august augusti\"
@@ -78,6 +88,15 @@
 .ds \*locale-litb Tabell\"
 .ds \*locale-lt Tabeller\"
 .ds \*locale-lx Uppst\a :llningar\"
+.ds \*locale-man-section1 Handbok för allmänna kommandon\"
+.ds \*locale-man-section2 Handbok för systemsamtal\"
+.ds \*locale-man-section3 Handbok för biblioteksfunktioner\"
+.ds \*locale-man-section4 Handbok för kärngränssnitt\"
+.ds \*locale-man-section5 Handbok för filformat\"
+.ds \*locale-man-section6 Spelhandbok\"
+.ds \*locale-man-section7 Handbok för diverse information\"
+.ds \*locale-man-section8 Systemchefens handbok\"
+.ds \*locale-man-section9 Handbok för kärnutvecklare\"
 .ds \*locale-march mars\"
 .ds \*locale-may maj\"
 .ds \*locale-monday m\a aondag\"
@@ -108,27 +127,31 @@
 .	\" update the date
 .	ds DY \ndy \*MO \nyear
 .	\" set hyphenation flags
-.	nr HY 4
+.	nr HY 34
 .\}
 .
 .
 .\" mm package -- additional Swedish localization is done in mse.tmac
 .
 .
-.\" me package
-.if d @R \{\
-.	\" date update
-.	ds td \n(dy \*(mo \n(y4
-.\}
-.
-.
 .\" Default encoding
 .mso latin1.tmac
 .
+.ss 12 0
+.
+.\" Set up hyphenation.
 .
 .\" Swedish hyphenation (\lefthyphenmin=1, \righthyphenmin=2)
-.ss 12 0
-.hy 32
+.nr \*locale*hyphenation-mode-base 32
+.nr \*locale*hyphenation-mode-trap 34
+.
+.ie \nlocale*use-trap-hyphenation-mode \
+.  hy \n\*locale*hyphenation-mode-trap
+.el \
+.  hy \n\*locale*hyphenation-mode-base
+.
+.rr locale*use-trap-hyphenation-mode
+.
 .hcode å å  Å å
 .hcode ä ä  Ä ä
 .hcode ö ö  Ö ö
@@ -138,12 +161,20 @@
 .hpf hyphen.sv
 .
 .
-.\" man, mdoc and mdoc-old are intentionally left untouched: usually
-.\" these packages are translated in the sources of the documents.
+.\" man package
+.if d an \
+.	an*reset-hyphenation-mode
+.
+.
+.\" me package
+.if d @R \{\
+.	ds _td_format \En(dy \E*(mo \En(y4
+.	ld
+.\}
+.
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_sv_tmac_C
+.do rr *groff_sv_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an-ext_MR-works.sh Added

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+input='.TH foo 1 2021-10-06 "groff test suite"
+.SH Name
+.ec @
+foo @- a command with a very short name
+.ec
+.SH Description
+The real work is done by
+.MR bar 1 .'
+
+output=$(echo "$input" | "$groff" -rmG=0 -Tascii -man -Z | nl)
+echo "$output"
+
+# Expected:
+#   88  wf2
+#   89  h24
+#   90  tbar
+#   91  f1
+#   92  t(1).
+
+echo "checking for correct man page topic font style" >&2
+echo "$output" | grep -Eq '88:space:+wf2' || wail
+echo "$output" | grep -Eq '90:space:+tbar' || wail
+echo "checking for correct man page section font style" >&2
+echo "$output" | grep -Eq '91:space:+f1' || wail
+echo "$output" | grep -Eq '92:space:+t$1$' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an-ext_MT-works.sh Added

@@ -0,0 +1,55 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail() {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+input='.TH foo 1 2022-11-22 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Description
+Mail
+.MT modok@\:example\:.com
+the boss
+.ME .
+.
+Complaints to
+.MT nobody@\:example\:.com
+.ME .'
+
+output=$(printf "%s\n" "$input" \
+    | "$groff" -rmG=0 -Tascii -P-cbou -man -rU0)
+echo "$output"
+
+echo "checking formatting of mail URI with link text" >&2
+echo "$output" | grep -Fq 'Mail the boss <modok@example.com>.' || wail
+
+echo "checking formatting of mail URI with no link text" >&2
+echo "$output" | grep -Fq 'Complaints to <nobody@example.com>.' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an-ext_UR-works.sh Added

@@ -0,0 +1,56 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail() {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+input='.TH foo 1 2022-11-22 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Description
+See
+.UR http://\:foo\:.example\:.com
+figure 1
+.UE .
+.
+Or
+.UR http://\:bar\:.example\:.com
+.UE .'
+
+output=$(printf "%s\n" "$input" \
+    | "$groff" -rmG=0 -Tascii -P-cbou -man -rU0)
+echo "$output"
+
+echo "checking formatting of web URI with link text" >&2
+echo "$output" | grep -Fq 'See figure 1 <http://foo.example.com>.' \
+    || wail
+
+echo "checking formatting of web URI with no link text" >&2
+echo "$output" | grep -Fq 'Or <http://bar.example.com>.' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh Added

@@ -0,0 +1,106 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #57416.
+#
+# The (deprecated) macros .AT and .UC, intended only for rendering of
+# legacy man pages, alter strings used in man page footers.  Verify that
+# they modify and restore these strings correctly.
+
+EXAMPLE_ATT_PAGE='.TH att 1 2020-01-16 "groff test suite"
+.AT
+.SH Name
+att \- aim Death Star at planet'
+
+EXAMPLE_FSF_PAGE='.TH fsf 1 2020-01-16 "groff test suite"
+.SH Name
+fsf \- liberate laser printer firmware'
+
+EXAMPLE_WFJ_PAGE='.TH wfj 1 2020-01-16 "groff test suite"
+.UC
+.SH Name
+wfj \- call 1-800-ITS-UNIX'
+
+EXAMPLE_GNU_PAGE='.TH gnu 1 2020-01-16 "groff test suite"
+.SH Name
+gnu \- join us now and share the software'
+
+EXAMPLE_UCB_PAGE='.TH ucb 1 2020-01-16 "groff test suite"
+.UC 7
+.SH Name
+ucb \- blow up Death Star'
+
+# We turn off continuous rendering (-rcR=0) so that the page footers are
+# numbered.  We turn on continuous page numbering (-rC1) so we can tell
+# that the footers are on the expected pages.
+INPUT=$(printf "%s\n" \
+    "$EXAMPLE_ATT_PAGE" \
+    "$EXAMPLE_FSF_PAGE" \
+    "$EXAMPLE_WFJ_PAGE" \
+    "$EXAMPLE_GNU_PAGE" \
+    "$EXAMPLE_UCB_PAGE" \
+    "$EXAMPLE_GNU_PAGE" \
+)
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0 -rC1)
+
+FAIL=
+
+if ! echo "$OUTPUT" | grep -qE '7th Edition +2020-01-16 +1'
+then
+    FAIL=yes
+    echo "AT&T (.AT) footer test failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -qE 'groff test suite +2020-01-16 +2'
+then
+    FAIL=yes
+    echo "FSF test footer failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -qE '3rd Berkeley Distribution +2020-01-16 +3'
+then
+    FAIL=yes
+    echo "WFJ (.UC) footer test failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -qE 'groff test suite +2020-01-16 +4'
+then
+    FAIL=yes
+    echo "1st GNU footer test failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -qE '4.4 Berkeley Distribution +2020-01-16 +5'
+then
+    FAIL=yes
+    echo "UCB (.UC) footer test failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -qE 'groff test suite +2020-01-16 +6'
+then
+    FAIL=yes
+    echo "2nd GNU footer test failed" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=80:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CS-register-off.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CS-register-on.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CS-register-unspecified.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CT-register-off.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CT-register-on.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_CT-register-unspecified.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_FT-bad-value-should-not-trash-titles.sh Added

@@ -0,0 +1,93 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60612.
+#
+# Bad values of FT should not trash headers and footers.
+EXAMPLE_PAGE_1='.TH foo 1 2021-05-17 "groff foo test"
+.SH Name
+foo \- frobnicate bits'
+
+EXAMPLE_PAGE_2='.TH bar 1 2021-05-17 "groff bar test"
+.SH Name
+bar \- what they say north of Macedonia'
+
+# We turn off continuous rendering (-rcR=0) so that FT influences where the page
+# footer is output.
+INPUT=$(printf "%s\n" \
+    "$EXAMPLE_PAGE_1" \
+    "$EXAMPLE_PAGE_2" \
+)
+
+# FT tells our man(7) where to write the page footer.
+#
+# -0.5i is the default and should always work.
+#
+# 0 (in any units) is not sane.  It would step on ("hide") the header trap among
+# other problems.
+#
+# 0.5i (positive) is a likely input from a confused user (I've done it).
+#
+# "Reasonable" positive values are conceivable but there may not be any user
+# demand for them.  ("Always break for the footer at 3i or 3c regardless of
+# the page length"?)
+#
+# Somewhere between -0.51v (bad) and -0.55v (okay) a problem gets caused.
+#
+# Traps that aren't in the page area (-20i, 500c for conventional paper sizes)
+# don't get sprung.
+
+for FT in -0.5i -1i 0i 0.5i -0.51v -0.55v 10i -20i
+do
+    OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0 -rFT=$FT)
+    FAIL=
+
+    if ! echo "$OUTPUT" | grep -qE 'foo$1$ +General Commands Manual +foo$1$'
+    then
+        FAIL=yes
+        echo "first page header test failed (FT=$FT)" >&2
+    fi
+
+    if ! echo "$OUTPUT" | grep -qE 'groff foo test +2021-05-17 +1'
+    then
+        FAIL=yes
+        echo "first page footer test failed (FT=$FT)" >&2
+    fi
+
+    if ! echo "$OUTPUT" | grep -qE 'bar$1$ +General Commands Manual +bar$1$'
+    then
+        FAIL=yes
+        echo "second page header test failed (FT=$FT)" >&2
+    fi
+
+    test -z "$FAIL"
+
+    if ! echo "$OUTPUT" | grep -qE 'groff bar test +2021-05-17 +1'
+    then
+        FAIL=yes
+        echo "second page footer test failed (FT=$FT)" >&2
+    fi
+done
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=80:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_HY-register-works.sh Added

@@ -0,0 +1,78 @@
+#!/bin/sh
+#
+# Copyright (C) 2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.TH foo 1 2023-01-08 "groff test suite"
+.SH Name
+foo \- frobinicate a bar
+.SH Synopsis
+.SY foo
+.YS
+.SH Description
+Now is the time for all good citizens to disestablish
+antidisestablishmentarianism.'
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou)
+echo "$output"
+
+echo "checking hyphenation when HY is default" >&2
+echo "$output" | grep -q "antidisestablish-$" || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -rHY=0 -man -Tascii -P-cbou)
+echo "$output"
+
+echo "checking hyphenation when HY is 0" >&2
+echo "$output" | grep -Eq "to +disestablish$" || wail
+
+input='.TH foo 1 2023-01-08 "groff test suite"
+.SH Name
+foo \- frobinicate a bar
+.SH Synopsis
+.SY foo
+.SY foo
+.I arbitrary-argument
+.YS
+.SH Description
+Now is the time for all good citizens to disestablish
+antidisestablishmentarianism.'
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou)
+echo "$output"
+
+echo "checking hyphenation when HY is default and .SY nested" >&2
+echo "$output" | grep -q "antidisestablish-$" || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -rHY=0 -man -Tascii -P-cbou)
+echo "$output"
+
+echo "checking hyphenation when HY is 0 and .SY nested" >&2
+echo "$output" | grep -Eq "to +disestablish$" || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_LL-init-sanely.sh Added

@@ -0,0 +1,48 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #58992.
+#
+# Our man macros should no longer attempt to read the .l register on
+# nroff devices to set the line length.  That register may or may not
+# have been set by a user .ll request; we can't tell whether a value of
+# 65n came from nroff or the user.
+#
+# Instead, the LL register must be used to set the line length.
+#
+# In this test we _expect_ the .ll request to be ignored and overridden.
+# We choose a value that is not nroff's default nor man's default.
+
+EXAMPLE='
+.ll 70n
+.TH ll\-hell 1 2020-08-22 "groff test suite"
+.SH Name
+ll\-hell \- see how long the lines are
+.SH Description
+LL=\nLLu
+.PP
+\&.l=\n.lu'
+
+printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -man \
+    | grep -q 'LL=1872u'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_ME-punct-hyphenates.sh Added

@@ -0,0 +1,55 @@
+#!/bin/sh
+#
+# Copyright (C) 2020, 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+input='.TH me\-punct 1 2020-08-15 "groff test suite"
+.SH Name
+me\-punct \- mailto: trailing material is subject to hyphenation
+.SH Description
+Do not try to
+.MT groff+morestuff@gnu.org
+hyphenate a ridiculous word* without machine assistance
+.ME (*pneumonoultramicroscopicsilicovolcanoconiosis).'
+
+# Turn off break warnings; we expect an adjustment problem.
+# I kind of wish adjustment warnings were a different category from
+# break warnings.
+echo "testing hyphenation of trailing text by an.tmac's ME macro"
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -Wbreak -P-cbou -man)
+echo "$output"
+echo "$output" | grep -qE 'pn.*-'
+
+echo "testing hyphenation of trailing text by an-ext.tmac's ME macro"
+output=$(printf "%s\n" "$input" \
+    | "$groff" -rmG=0 -Tascii -Wbreak -P-cbou -man)
+echo "$output"
+echo "$output" | grep -qE 'pn.*-'
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_MR-works.sh Added

@@ -0,0 +1,75 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+INPUT='.TH foo 1 2021-10-06 "groff test suite"
+.SH Name
+foo \\- a command with a very short name
+.SH Description
+The real work is done by
+.MR bar 1 .'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -rU1 -man -Z | nl)
+echo "$OUTPUT"
+
+# Expected:
+#   91  x X tty: link man:bar(1)
+#   92  f2
+#   93  tbar
+#   94  f1
+#   95  t(1)
+#   96  V280
+#   97  H912
+#   98  x X tty: link
+
+set -e
+echo "checking for opening 'link' device control command" >&2
+echo "$OUTPUT" | grep -Eq '91:space:+x X tty: link man:bar$1$$'
+echo "checking for correct man page title font style" >&2
+echo "$OUTPUT" | grep -Eq '92:space:+f2'
+echo "$OUTPUT" | grep -Eq '93:space:+tbar'
+echo "checking for correct man page section font style" >&2
+echo "$OUTPUT" | grep -Eq '94:space:+f1'
+echo "$OUTPUT" | grep -Eq '95:space:+t$1$'
+echo "checking for closing 'link' device control command" >&2
+echo "$OUTPUT" | grep -Eq '98:space:+x X tty: link$'
+
+set +e
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+output=$(echo "$INPUT" | "$groff" -man -Thtml)
+echo "$output"
+
+echo "checking for correctly formatted man URI in HTML output" >&2
+echo "$output" | grep -Fq '<a href="man:bar(1)"><i>bar</i>(1)</a>.'
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_MT-body-hyphenates.sh Added

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+EXAMPLE='.TH mt\-body 1 2020-08-15 "groff test suite"
+.SH Name
+mt\-body \- mailto: link text is subject to hyphenation
+.SH Description
+Do not try to
+.MT groff@gnu.org
+hyphenate the word
+pneumonoultramicroscopicsilicovolcanoconiosis
+without machine assistance
+.ME .'
+
+printf "%s\n" "$EXAMPLE" | "$groff" -rmG=0 -Tascii -P-cbou -man \
+    | grep -qE 'pn.*-'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_MT-works.sh Added

@@ -0,0 +1,86 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail() {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+input='.TH foo 1 2022-11-22 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Description
+Mail
+.MT modok@\:example\:.com
+the boss
+.ME .
+.
+Complaints to
+.MT nobody@\:example\:.com
+.ME .'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man -rU0)
+echo "$output"
+
+echo "checking formatting of mail URI with link text" \
+    "(hyperlinks disabled)" >&2
+echo "$output" | grep -Fq 'Mail the boss <modok@example.com>.' || wail
+
+echo "checking formatting of mail URI with no link text" \
+    "(hyperlinks disabled)" >&2
+echo "$output" | grep -Fq 'Complaints to <nobody@example.com>.' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man -rU1)
+echo "$output"
+
+echo "checking formatting of mail URI with link text" \
+    "(hyperlinks enabled)" >&2
+echo "$output" | grep -Fq 'Mail the boss.' || wail
+
+echo "checking formatting of mail URI with no link text" \
+    "(hyperlinks enabled)" >&2
+echo "$output" | grep -Fq 'Complaints to nobody@example.com.' || wail
+
+input='.TH foo 1 2022-12-04 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Authors
+The GNU version of
+.I foo
+was written by
+.MT q@\:example\:.com
+Quiller
+.ME .'
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Thtml)
+echo "$output"
+
+echo "checking HTML output of mail URI" >&2
+echo "$output" \
+    | grep -Fqx '<a href="mailto:q@example.com">Quiller</a>.</p>' \
+    || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_P-register-works.sh Added

@@ -0,0 +1,51 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.TH foo 1 2022-12-11 "groff test suite"
+.SH Name
+foo \- frobinicate a bar
+.bp
+.SH Description
+It took a while to get here.'
+
+output=$(printf "%s\n" "$input" | "$groff" -rcR=0 -rP13 -man -Tascii \
+    -P-cbou)
+echo "$output"
+
+echo "checking first page footer" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^64:' || wail
+
+echo "checking second page footer" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^130:' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_TH-repairs-ad-damage.sh Added

@@ -0,0 +1,41 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+EXAMPLE='.TH mal 1 2020-08-21 "groff test suite"
+.SH Name
+mal \- malevolent man page
+.SH Description
+.ad l
+Wicked page changes adjustment.
+Wicked page changes adjustment.
+Wicked page changes adjustment.
+.TH ino 1 2020-08-21 "groff test suite"
+.SH Name
+ino \- innocent man page
+.SH Description
+Innocent, unoffending man page enjoys adjustment to both margins.
+Innocent, unoffending man page enjoys adjustment to both margins.'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -man)
+echo "$OUTPUT" | grep -qE 'margins\.  In' # two spaces
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_TH-repairs-hy-damage.sh Added

@@ -0,0 +1,41 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+EXAMPLE='.TH mal 1 2020-08-21 "groff test suite"
+.SH Name
+mal \- malevolent man page
+.SH Description
+.nh
+Wicked page disables hyphenation.
+Wicked page disables hyphenation.
+Wicked page disables hyphenation.
+.TH ino 1 2020-08-21 "groff test suite"
+.SH Name
+ino \- innocent man page
+.SH Description
+Innocent, unoffending man page enjoys hyphenation.
+Innocent, unoffending man page enjoys hyphenation.'
+
+printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -man \
+    | grep -qE 'unoffend-'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_TS-adds-no-vertical-space.sh Added

@@ -0,0 +1,47 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input='.TH foo 1 2022-07-30 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Description
+Foo.
+.TS
+L.
+bar
+.TE
+'
+
+# Bash strips out an empty line, but that's what we're looking for.
+output=$(printf "%s" "$input" | "$groff" -t -man -Tascii \
+    | sed -n \
+        -e '/Foo\./{n;s/^$/FAILURE/;tA;' \
+        -e 's/.*/SUCCESS/;:A;' \
+        -e 'p;}')
+    # Here's a tidier version accepted by GNU sed but rejected
+    # contemptuously by macOS sed.  (POSIX doesn't say you _have_ to
+    # accept semicolons after label ':' and branch 't' commands, so it
+    # doesn't.)
+    # sed -n '/Foo\./{n;s/^$/FAILURE/;tA;s/.*/SUCCESS/;:A;p}'
+test "$output" = SUCCESS
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh Added

@@ -0,0 +1,51 @@
+#!/bin/sh
+#
+# Copyright (C) 2020-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #57665.
+#
+# The interior of this text is fragile with respect to line count.
+
+EXAMPLE='
+.TH ts\-hell 1 2020-10-09 "groff test suite"
+.SH Name
+ts\-hell \- turn off tbl keeps when continuous rendering
+.SH Description
+A long table should not get spurious blank lines inserted into it when
+continuously rendering.
+.
+This arises from
+.IR tbl (1)
+using \lqkeeps\rq.
+.
+We do not need those when
+.B cR
+is set.
+.
+.TS
+l.
+'$(n=1; while  $n -le 53 ; do echo $n; n=$(( n + 1 )); done)'
+.TE'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -t -man)
+test -n "$(echo "$OUTPUT" | sed -n '/52/{N;/53/p;}')"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_UE-breaks-before-long-URIs.sh Added

@@ -0,0 +1,68 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input=$(cat <<EOF
+.TH ridonk 1 2021-10-31 "groff test suite"
+.SH Name
+ridonk \- check the typesetting of absurdly long URIs
+.SH Description
+.UR https://\:www\:.adobe\:.com/\:content/\:dam/\:acom/\:en/\:devnet/\:\
+actionscript/\:articles/\:5001\:.DSC_Spec\:.pdf
+Commerce
+.UE ,
+n.:
+A kind of transaction in which A plunders from B the goods of C,
+and for compensation B picks the pocket of D of money belonging to E.
+.P
+.UR https://1\:2\:3\:4\:5\:6\:7\:8\:9\:1\:1\:2\:3\:4\:5\:6\:7\:8\:9\:\
+2\:1\:2\:3\:4\:5\:6\:7\:8\:9\:3\:1\:2\:3\:4\:5\:6\:7\:8\:9\:4\:1\:2\:\
+3\:4\:5\:6\:7\:8\:9\:5\:1\:2\:3\:4\:5\:6\:7\:8\:9\:6\:1\:2\:3\:4\:5\:\
+6\:7\:8\:9\:7\:1\:2\:3\:4\:5\:6\:7\:8\:9\:8\:1\:2\:3\:4\:5\:6\:7\:8\:\
+9\:9\:1\:2\:3\:4\:5\:6\:7\:8\:9\:0
+.UE
+EOF
+)
+
+fail=
+
+wail () {
+    echo "...$* FAILED" >&2
+    fail=yes
+}
+
+output=$(printf "%s" "$input" | "$groff" -Tascii -P-cbou -man)
+echo "$output"
+error=$(printf "%s" "$input" \
+    | "$groff" -Tascii -P-cbou -man -ww -z 2>&1)
+
+echo "testing that no diagnostic messages are produced" >&2
+test -z "$error" || wail
+echo "testing that lines break where expected" >&2
+break1=$(echo "$output" | grep -x "  *Commerce  *<https.*devnet/")
+break2=$(echo "$output" | grep -x "  *actionscript/.* transaction  *in")
+break3=$(echo "$output" | grep -x "  *<https.*612")
+test -n "$break1" || wail "first break"
+test -n "$break2" || wail "second break"
+test -n "$break3" || wail "third break"
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_UE-punct-hyphenates.sh Added

@@ -0,0 +1,53 @@
+#!/bin/sh
+#
+# Copyright (C) 2020, 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=YES
+}
+
+input='.TH ue\-punct 1 2020-08-15 "groff test suite"
+.SH Name
+ue\-punct \- URL trailing material is subject to hyphenation
+.SH Description
+Do not try to
+.UR https://www.gnu.org/software/groff/
+hyphenate a ridiculous word* without machine assistance
+.UE (*pneumonoultramicroscopicsilicovolcanoconiosis).'
+
+# Turn off break warnings; we expect an adjustment problem.
+echo "testing hyphenation of trailing text by an.tmac's UE macro"
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -Wbreak -P-cbou -man)
+echo "$output"
+echo "$output" | grep -qE 'pn.*-'
+
+echo "testing hyphenation of trailing text by an-ext.tmac's UE macro"
+output=$(printf "%s\n" "$input" \
+    | "$groff" -rmG=0 -Tascii -Wbreak -P-cbou -man)
+echo "$output"
+echo "$output" | grep -qE 'pn.*-'
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_UR-body-hyphenates.sh Added

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+EXAMPLE='.TH ur\-body 1 2020-08-15 "groff test suite"
+.SH Name
+ur\-body \- URL link text is subject to hyphenation
+.SH Description
+Do not try to
+.UR https://www.gnu.org/software/groff/
+hyphenate the word
+pneumonoultramicroscopicsilicovolcanoconiosis
+without machine assistance
+.UE .'
+
+printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -man \
+    | grep -qE 'pn.*-'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_UR-works.sh Added

@@ -0,0 +1,86 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail() {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+input='.TH foo 1 2022-11-22 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Description
+See
+.UR http://\:foo\:.example\:.com
+figure 1
+.UE .
+.
+Or
+.UR http://\:bar\:.example\:.com
+.UE .'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man -rU0)
+echo "$output"
+
+echo "checking formatting of web URI with link text" \
+    "(hyperlinks disabled)" >&2
+echo "$output" | grep -Fq 'See figure 1 <http://foo.example.com>.' \
+    || wail
+
+echo "checking formatting of web URI with no link text" \
+    "(hyperlinks disabled)" >&2
+echo "$output" | grep -Fq 'Or <http://bar.example.com>.' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man -rU1)
+echo "$output"
+
+echo "checking formatting of web URI with link text" \
+    "(hyperlinks enabled)" >&2
+echo "$output" | grep -Fq 'See figure 1.' || wail
+
+echo "checking formatting of web URI with no link text" \
+    "(hyperlinks enabled)" >&2
+echo "$output" | grep -Fq 'Or http://bar.example.com.' || wail
+
+input='.TH foo 1 2022-12-04 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH "See also"
+For our SOSP presentation,
+check our
+.UR https://\:example\:.com
+website
+.UE .'
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Thtml)
+echo "$output"
+
+echo "checking HTML output of web URI" >&2
+echo "$output" \
+    | grep -Fqx '<a href="https://example.com">website</a>.</p>' \
+    || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_X-register-works.sh Added

@@ -0,0 +1,62 @@
+#!/bin/sh
+#
+# Copyright (C) 2020-2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure the X register takes effect on the right page and looks right.
+
+INPUT='.TH foo 1 2021-05-19 "groff foo test suite"
+.TH bar 1 2021-05-19 "groff bar test suite"'
+
+FAIL=
+
+OUTPUT=$(printf "%s\n" "$INPUT" \
+    | "$groff" -Tascii -P-cbou -rcR=0 -rC1 -rX1 -man)
+
+if ! echo "$OUTPUT" | grep -Eqx 'groff foo test suite +2021-05-19 +1'
+then
+    FAIL=yes
+    echo "first page footer test failed" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -Eqx 'groff bar test suite +2021-05-19 +1a'
+then
+    FAIL=yes
+    echo "second page footer test failed" >&2
+fi
+
+INPUT='.TH baz 1 2021-05-19 "groff baz test suite"
+.SH Name
+baz \- neglect third stepchild
+.SH Description
+This program is the lowly third in line.'
+
+OUTPUT=$(printf "%s\n" "$INPUT" \
+    | "$groff" -Thtml -rcR=0 -rC1 -rX1 -man)
+
+if echo "$OUTPUT" | grep -q 'groff baz test suite'
+then
+    FAIL=yes
+    echo "HTML output unexpectedly contains footer text" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_adjust-link-text-correctly.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure that link text (when the hyperlink itself is not formatted
+# because the device supports hyperlinking) uses the correct line length
+# and is adjusted.
+
+input='.TH foo 1 2022-11-08 "groff test suite"
+.SH "See also"
+.
+.UR http://\:www\:.hp\:.com/\:ctg/\:Manual/\:bpl13210\:.pdf
+.I HP PCL/PJL Reference:
+.I PCL\~5 Printer Language Technical Reference Manual,
+.I Part I
+.UE'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man -rU1)
+echo "$output"
+echo "$output" | grep -q 'HP  PCL/PJL Reference:.*Reference Manu-'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_avoid-two-font-denial-of-service.sh Added

@@ -0,0 +1,36 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# That's six pairs of parentheses below.
+"$groff" -Tascii -P-cbou -man <<EOF | grep -q '( ) ( ) ( ) ( ) ( ) ( )'
+.TH sample 1 2020-09-16 "groff test suite"
+.SH Name
+sample \- test subject for groff
+.PP
+Don't DoS me, bro!
+.BI ( \\ )
+.BR ( \\ )
+.IB ( \\ )
+.IR ( \\ )
+.RB ( \\ )
+.RI ( \\ )
+EOF

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh Added

@@ -0,0 +1,51 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savanah #62257.
+#
+# Do not attempt to abbreviate page titles or inner footers (the 4th
+# argument to `TH` that contain non-trivial escape sequences.  See
+# Savannah #62264 for why doing so is difficult.
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=yes
+}
+
+input='.TH f\-b 1 2022-04-08 "Bletcherous Glorfinking Dungr'\
+'\u adndel Hoppabotch Greebstank 2.21"'
+
+# The u with dieresis will not be output on the 'ascii' device.
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man)
+
+echo "checking that title with escaped hyphen-minus is preserved" >&2
+echo "$output" | grep -q '^f-b(1)' || wail
+
+pattern='Bletcherous Glorfinking Dungrndel 2022-04-08 Greebstank 2.21'
+pattern="$pattern            f-b(1)" # 12 spaces
+echo "checking for insanely long 4th TH argument" >&2
+echo "$output" | grep -Fqx "$pattern" || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_font-remapping-does-not-affect-titles.sh Added

@@ -0,0 +1,60 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #61279.
+#
+# If a SH or SS (sub)section heading was about to be output at the
+# bottom of a page but wasn't because of the vertical space .ne-eded,
+# we want to ensure that font remapping for the headings doesn't affect
+# page footers and headers.
+
+# Keep preconv from being run.
+unset GROFF_ENCODING
+
+input='.TH \\fIfoo\\fP 1 2021-10-04 "groff test suite"
+.SH Name
+foo \\- a command with a very short name
+.sp 50v
+.SH "\\fIgroff\\fP integration"
+A complicated situation.'
+
+output=$(echo "$input" | "$groff" -Tascii -man -rcR=0)
+echo "$output"
+output=$(echo "$input" | "$groff" -Tascii -man -rcR=0 -Z | nl)
+echo "$output"
+
+# Expected:
+#   74  V2640
+#   75  p2
+#   76  x font 2 I
+#   77  f2
+#   78  s10
+#   79  V160
+#   80  H0
+#   81  tfoo
+#   82  x font 1 R
+#   83  f1
+#   84  t(1)
+
+echo "$output" | grep -E '77:space:+f2'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_handle-degenerate-input-quietly.sh Added

@@ -0,0 +1,29 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #61402.
+#
+# Don't spew a lot of diagnostics if we have only empty lines as input.
+
+test -z "$(echo | "$groff" -man -ww -Tascii -P-cbou 2>&1 > /dev/null)"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_inner-footer-abbreviation-works.sh Added

@@ -0,0 +1,70 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #61386.
+#
+# Excessively long "extra2" arguments to 'TH' (we recommend using this
+# for project name and version information) can overrun other parts of
+# the titles, such as a date in the center footer.
+
+FAIL=
+
+INPUT='.TH foo 1 2021-10-26 "groff 1.23.0.rc1.1449-84949"
+.SH Name
+foo \- a command with a very short name'
+
+echo 'testing long inner footer with sufficient space to set it' >&2
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man)
+PATTERN='groff 1\.23\.0\.rc1\.1449-84949 +2021-10-26 +foo$1$'
+
+if ! echo "$OUTPUT" | grep -Eq "$PATTERN"
+then
+    FAIL=yes
+    echo "...FAILED" >&2
+fi
+
+echo 'testing long inner footer with insufficient space to set it' >&2
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rLL=60n)
+PATTERN='groff 1\.23\.0\.rc1\.1449\.\.\. +2021-10-26 +foo$1$'
+
+if ! echo "$OUTPUT" | grep -Eq "$PATTERN"
+then
+    FAIL=yes
+    echo "...FAILED" >&2
+fi
+
+# Regression-test Savannah #61408.
+#
+# Don't spew diagnostics if the page doesn't supply a 3rd .TH argument.
+echo 'testing for graceful behavior when TH has no 3rd argument' >&2
+INPUT='.TH patch 1 "" GNU'
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -ww -z 2>&1)
+
+if  -n "$OUTPUT" 
+then
+    FAIL=yes
+    echo "...FAILED" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_link-macros-work-in-paragraph-tags.sh Added

@@ -0,0 +1,88 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input=$(cat <<EOF
+.TH foo 1 2021-11-05 "groff test suite"
+.TP
+.UR https://\:github.com/\:Alhadis/\:Roff\:.js/
+.I Roff.js
+.UE
+is a viewer for intermediate output written in JavaScript.
+EOF
+)
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+# Check for regressions when OSC 8 disabled
+uflag=-rU0
+
+output=$(printf "%s" "$input" \
+    | "$groff" -bww -Tascii -P-cbou $uflag -man)
+
+echo "checking for paragraph tag on line by itself ($uflag)" >&2
+echo "$output" | grep -qx '       Roff\.js' || wail # 7 spaces
+
+echo "checking for presence of typeset URI ($uflag)" >&2
+echo "$output" \
+    | grep -q '^              <https://github\.com/Alhadis/Roff\.js/>' \
+    || wail # 14 spaces
+
+output=$(printf "%s" "$input" \
+    | "$groff" -bww -Tascii -P-cbou -rU0 -rLL=130n -man)
+
+# Sloppy handling of UE, ME macro arguments can cause unwanted space.
+echo "checking for normative (no extra) spacing after URI ($uflag)" >&2
+echo "$output" | grep -q '> is a viewer for intermediate' || wail
+
+# Now check for good formatting when URIs are hyperlinked.
+uflag=-rU1
+
+output=$(printf "%s" "$input" \
+    | "$groff" -bww -Tutf8 -P-cbou $uflag -man)
+
+echo "checking for paragraph tag on line by itself ($uflag)" >&2
+echo "$output" | grep -qx '       Roff\.js' || wail # 7 spaces
+
+# Hyperlinking paragraph tags was not supported in groff 1.22.4 and
+# still isn't.
+#echo "checking for absence of typeset URI" >&2
+#! echo "$output" | grep -q https || wail
+
+output=$(printf "%s" "$input" \
+    | "$groff" -bww -Tascii -P-cbou $uflag -rLL=130n -man)
+
+echo "checking for normative (no extra) spacing after URI ($uflag)" >&2
+# This is what we expect when linking the tag works.
+#echo "$output" \
+#    | grep -q '^              is a viewer for intermediate' \
+#    || wail # 14 spaces
+# ...but in the meantime...
+echo "$output" | grep -q '^:space: is a viewer for' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_link-trailing-text-hugs-previous.sh Added

@@ -0,0 +1,52 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.TH foo 1 2022-12-04 "groff test suite"
+.SH Name
+foo \- frobnicate a bar
+.SH Authors
+.I foo
+was written by
+.MT jp@\:example\:.com
+J.\& Ponderous
+.ME (deceased).'
+
+output=$(printf "%s\n" "$input" | "$groff" -rU0 -man -Tascii -P-cbou)
+echo "$output"
+echo "checking that trailing text hugs link URI (-rU0)"
+echo "$output" | grep -q '\.com>(deceased)\.$' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -rU1 -man -Tascii -P-cbou)
+echo "$output" | od -c
+echo "checking that trailing text hugs link text (-rU1)"
+echo "$output" | grep -q 'Ponderous(deceased).$' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_no-break-after-short-paragraph-tags.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60624.
+#
+# A page break should not follow the tag in a tagged paragraph when the
+# tag can fit within the indentation.
+
+FAIL=
+
+INPUT='.TH foo 1 2021-05-18 "groff test suite"
+.SH Name
+foo \- frobnicate a thingamajig
+.rs \" force spacing on
+.sp 50
+.TP
+3
+7th edition'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0)
+
+echo "$OUTPUT" | grep -Eqx ' +3 +7th edition'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_output-footer-when-continuously-rendering.sh Added

@@ -0,0 +1,41 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure that the page footer is printed even when a pending output line
+# is 1v from the page bottom.  (A page ejection inside an end of input
+# trap exits the formatter.)
+
+input='.TH foo 1 2022-11-02 "groff test suite"
+.SH Name
+foo \\- frobnicate a bar
+.SH Description
+.rs
+.sp 60v
+line 61
+.br
+line 62'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -man)
+echo "$output"
+echo "$output" | grep -Eqx 'groff test suite +2022-11-02 +foo$1$'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_page-footers-present.sh Added

@@ -0,0 +1,68 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60609.
+
+INPUT='.TH foo 1 2021-05-16 "groff test suite" "Volume 1"
+.SH Name
+foo \- a frobnicating thing
+.TH bar 1 2021-05-16 "groff test suite" "Volume 2"
+.SH Name
+bar \- a wretched hive of scum and villainy'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man)
+
+FAIL=
+
+if ! echo "$OUTPUT" | grep -Eqx 'groff test suite +2021-05-16 +foo$1$'
+then
+    FAIL=yes
+    echo "first page footer test failed (continuous rendering on)" >&2
+fi
+
+if ! echo "$OUTPUT" | grep -Eqx 'groff test suite +2021-05-16 +bar$1$'
+then
+    FAIL=yes
+    echo "second page footer test failed (continuous rendering on)" >&2
+fi
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0)
+
+if ! echo "$OUTPUT" | grep -Eqx 'groff test suite +2021-05-16 +1'
+then
+    FAIL=yes
+    echo "first page footer test failed (continuous rendering off)" >&2
+fi
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0 -rC1)
+
+if ! echo "$OUTPUT" | sed '1,/^groff test suite/d' \
+    | grep -Eqx 'groff test suite +2021-05-16 +2'
+then
+    FAIL=yes
+    echo "second page footer test failed (continuous rendering off," \
+        " cotinuous numbering on)" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=80:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_page-header-has-current-data.sh Added

@@ -0,0 +1,70 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Misconfiguration of traps or our man(7) implementation's page-flushing macros,
+# or poor ordering of logic in its TH macro, can cause page headers to render
+# with incorrect information.
+
+INPUT='.TH foo 1 2021-05-16 "groff test suite" "Volume 1"
+.SH Name
+foo \- a frobnicating thing
+.TH bar 1 2021-05-16 "groff test suite" "Volume 2"
+.SH Name
+bar \- a wretched hive of scum and villainy'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man)
+echo "$OUTPUT"
+
+FAIL=
+
+if ! echo "$OUTPUT" | grep -Eqx 'foo$1$ +Volume 1 +foo$1$'
+then
+    FAIL=yes
+    echo "first page header test failed (continuous rendering on)" >&2
+fi
+
+if ! echo "$OUTPUT" | sed '1,/^groff test suite/d' \
+    | grep -Eqx 'bar$1$ +Volume 2 +bar$1$'
+then
+    FAIL=yes
+    echo "second page header test failed (continuous rendering on)" >&2
+fi
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man -rcR=0)
+echo "$OUTPUT"
+
+if ! echo "$OUTPUT" | grep -Eqx 'foo$1$ +Volume 1 +foo$1$'
+then
+    FAIL=yes
+    echo "first page header test failed (continuous rendering off)" >&2
+fi
+
+if ! echo "$OUTPUT" | sed '1,/^groff test suite/d' \
+    | grep -Eqx 'bar$1$ +Volume 2 +bar$1$'
+then
+    FAIL=yes
+    echo "second page header test failed (continuous rendering off)" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=80:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_reset-hyphenation-correctly.sh Added

@@ -0,0 +1,63 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Fix problem observed while implementing Savannah #61734.  Using a
+# hyphenation of "en" (English) with the hyphenation mode for Swedish
+# produces bad breaks.
+
+input='.TH foo 1 2022-02-21 "groff test suite"
+xx
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+glyph
+'
+
+fail=
+
+wail () {
+    echo "...$* FAILED" >&2
+    fail=yes
+}
+
+echo "checking continuous rendering mode" >&2
+output=$(printf "%s" "$input" \
+    | "$groff" -Tascii -P-cbou -man -msv -men)
+echo "$output" | grep -q 'g-$' && wail
+
+echo "checking discontinuous (paginated) rendering mode" >&2
+output=$(printf "%s" "$input" \
+    | "$groff" -Tascii -P-cbou -man -rcR=0 -msv -men)
+echo "$output" | grep -q 'g-$' && wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_title-abbreviation-works.sh Added

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #43532.
+#
+# Excessively long man page titles can overrun other parts of the titles
+# (headers and footers).  Verify abbreviation of ones that would.
+
+FAIL=
+
+INPUT='.TH foo 1 2021-05-31 "groff test suite"
+.SH Name
+foo \- a command with a very short name'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man)
+
+if ! echo "$OUTPUT" \
+    | grep -Eq 'foo$1$ +General Commands Manual +foo$1$'
+then
+    FAIL=yes
+    echo "short page title test failed" >&2
+fi
+
+INPUT='.TH CosNotifyChannelAdmin_StructuredProxyPushSupplier 3erl \
+2021-05-31 "groff test suite" "Erlang Module Definition"
+.SH Name
+CosNotifyChannelAdmin_StructuredProxyPushSupplier \- OMFG'
+
+OUTPUT=$(echo "$INPUT" | "$groff" -Tascii -P-cbou -man)
+
+TITLE_ABBV="CosNotif...hSupplier(3erl)"
+PATTERN="$TITLE_ABBV Erlang Module Definition $TITLE_ABBV"
+
+if ! echo "$OUTPUT" | grep -Fq "$PATTERN"
+then
+    FAIL=yes
+    echo "long page title test failed" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_use-input-traps-correctly.sh Added

@@ -0,0 +1,113 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+# Ensure that input trap-using macros employ the correct request.  B, I,
+# SH, SS, SM, and SB need `it`; TP needs `itc`.
+
+# B
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.B \\\\n.fn\c
+\\n.fn"
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou 2>&1)
+
+echo "checking that B macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx 'BR' || wail
+
+# I
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.I \\\\n.fn\c
+\\n.fn"
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou 2>&1)
+
+echo "checking that I macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx 'IR' || wail
+
+# SH
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.SH Name\c
+foo \- frobnicate a bar"
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou 2>&1)
+
+echo "checking that SH macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx 'Name' || wail
+
+# SS
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.SS Limitations\c
+Lorem ipsum gitsum voluptatem."
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou 2>&1)
+
+echo "checking that SS macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx '   Limitations' || wail # 3 spaces
+
+# SM
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.SM \\\\n.s\c
+\\n.s"
+
+output=$(printf "%s\n" "$input" | "$groff" -man -a -Tps 2>&1)
+
+echo "checking that SM macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx '910' || wail
+
+# SB
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.SB \\\\n.fn\\\\n.s\c
+\\n.fn\\n.s"
+
+output=$(printf "%s\n" "$input" | "$groff" -man -a -Tps 2>&1)
+
+echo "checking that SB macro uses correct input trap 'it'" >&2
+echo "$output" | grep -Fqx 'TB9TR10' || wail
+
+# TP
+
+input=".TH foo 1 2022-06-07 \"groff test suite\"
+.TP
+.BR \-\-bar  =\c
+.IR baz "
+
+output=$(printf "%s\n" "$input" | "$groff" -man -Tascii -P-cbou 2>&1)
+
+echo "checking that TP macro uses correct input trap 'itc'" >&2
+echo "$output" | grep -Fqx '       --bar=baz' || wail # 7 spaces
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/an_works-with-ec.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #63194.  Use of '-man -mec -Tdvi' should not
+# make the italic font unavailable in ordinary text.
+#
+# The per mille sign is available only in the EC fonts, so if we
+# failed to switch them in, we'll get an undefined special character
+# warning.
+
+input=$(
+  printf '.TH foo 1 2022-10-10 "groff test suite"\n';
+  printf '.SH N\\'"'"'EV \\fBIgroff\\f \\fBGNU\\fP\n';
+  printf 'foo \\- \\%%0\\fIgroff\n';
+)
+
+output=$(printf "%s\n" "$input" | "$groff" -man -mec -Tdvi -z 2>&1)
+echo "$output"
+test -z "$output"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/andoc_P-register-works.sh Added

@@ -0,0 +1,117 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+# Test going back and forth from man(7) to mdoc(7).
+
+input='.TH foo 1 2022-12-11 "groff test suite"
+.SH Name
+foo \- frobinicate a bar
+.bp
+.SH Description
+It took a while to get here.
+.Dd 2022-12-11
+.Dt bar 1
+.Os "groff test suite"
+.Sh Name
+.Nm bar
+.Nd erect something for people to walk into
+.bp
+.Sh Description
+It took a while to get here.
+.TH baz 7 2022-12-11 "groff test suite"
+.SH Name
+baz \- what they do not play at Mos Eisley spaceport cantina
+.bp
+.SH Description
+It took a while to get here.'
+
+# First, check without continuous numbering.  Each page starts at P.
+
+output=$(printf "%s\n" "$input" | "$groff" -rcR=0 -rP13 -mandoc \
+    -Tascii -P-cbou)
+echo "$output"
+
+echo "checking first document, first page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^64:' || wail
+
+echo "checking first document, second page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^130:' || wail
+
+echo "checking second document, first page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^196:' || wail
+
+echo "checking second document, second page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^262:' || wail
+
+echo "checking third document, first page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^328:' || wail
+
+echo "checking third document, second page footer (discontinuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^394:' || wail
+
+# Now, check _with_ continuous numbering.  Only the first page is
+# numbered P.
+
+output=$(printf "%s\n" "$input" | "$groff" -rcR=0 -rC1 -rP13 -mandoc \
+    -Tascii -P-cbou)
+echo "$output"
+
+echo "checking first document, first page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^64:' || wail
+
+echo "checking first document, second page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^130:' || wail
+
+echo "checking second document, first page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +15$" \
+    | grep '^196:' || wail
+
+echo "checking second document, second page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +16$" \
+    | grep '^262:' || wail
+
+echo "checking third document, first page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +17$" \
+    | grep '^328:' || wail
+
+echo "checking third document, second page footer (continuous)" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +18$" \
+    | grep '^394:' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/andoc_check-an-to-doc-transition.sh Added

@@ -0,0 +1,68 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.TH foo 1 2022-12-11 "groff test suite"
+.SH Name
+foo \- frobinicate a bar
+.Dd 2022-12-11
+.Dt bar 1
+.Os "groff test suite"
+.Sh Name
+.Nm bar
+.Nd erect a thing to be walked into'
+
+output=$(printf "%s\n" "$input" | "$groff" -mandoc -Tascii -P-cbou)
+echo "$output"
+
+echo "checking for one foo(1) header" >&2
+test $(echo "$output" \
+         | grep -Ec "foo$1$ +General Commands Manual +foo$1$") \
+    -eq 1 || fail
+
+echo "checking for one foo(1) footer" >&2
+test $(echo "$output" \
+         | grep -Ec "groff test suite +2022-12-11 +foo$1$") -eq 1 \
+    || fail
+
+echo "checking for one bar(1) header" >&2
+test $(echo "$output" \
+         | grep -Ec "bar$1$ +General Commands Manual +bar$1$") \
+    -eq 1 || fail
+
+echo "checking for one bar(1) barter" >&2
+test $(echo "$output" \
+         | grep -Ec "groff test suite +2022-12-11 +bar$1$") -eq 1 \
+    || fail
+
+echo "checking for uninitialized header and footer fields"
+echo "$output" | grep -E "(UNTITLED|UNDATED|LOCAL)" && fail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/andoc_clear-doc-traps.sh Added

@@ -0,0 +1,47 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59246.
+#
+# andoc should remove mdoc(7) traps before rendering a man(7) page.
+# Continuous rendering has to be _off_ to catch this.
+
+EXAMPLE=\
+'.Dd October 11, 2020
+.Dt mdoc\-test 7
+.Os
+.Sh Name
+.Nm mdoc\-test
+.Nd lay mine
+.Sh Description
+Just testing.
+.TH man\-test 7 2020-10-11
+.SH Name
+man-test \- drive sheep across minefield
+.SH Description
+\lqdoc\-footer\rq should definitely not be sprung by this document.'
+
+! printf "%s\n" "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -mandoc -rcR=0 \
+    | grep -E '^BSD +October 11, 2020 +3$'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/andoc_flush-between-packages.sh Added

@@ -0,0 +1,77 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59016.
+#
+# Ensure that a partially-collected line at the end of a file gets
+# flushed, and page footers written,  before proceeding to the next
+# document.  Check going from man(7) to mdoc(7) documents and back.
+
+EXAMPLE=\
+'.TH man\-flush\-test 7 2020-10-11 "groff test page 1"
+.SH Name
+man\-flush-test \- a sanity test for groff_man(7)
+.SH Description
+This gratuitously loquacious sentence should end up with a
+partially-collected output line.
+.Dd October 11, 2020
+.Dt mdoc\-test 7
+.Os "groff test page 2"
+.Sh Name
+.Nm mdoc\-test
+.Nd a sanity test for groff_mdoc(7)
+.Sh Description
+This additional gratuitously loquacious sentence should end up with a
+partially-collected output line.
+.TH man\-flush\-test2 7 2020-10-11 "groff test page 3"
+.SH Name
+man\-flush-test2 \- a second sanity test for groff_man(7)
+.SH Description
+This supernumerary loquacious sentence should end up with a
+partially-collected output line.'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -mandoc)
+
+FAIL=
+
+# Strip blank lines from the output first; all we care about for this
+# test is the presence, adjacency, and ordering of non-blank lines.
+
+if  -z "$(echo "$OUTPUT" \
+    | sed '/^$/d' \
+    | sed -n '/collected/{N;/test page 1/p;}')" 
+then
+    FAIL=yes
+    echo "man to mdoc transition failed" >&2
+fi
+
+if  -z "$(echo "$OUTPUT" \
+    | sed '/^$/d' \
+    | sed -n '/partially-collected/{N;/test page 2/p;}')" 
+then
+    FAIL=yes
+    echo "mdoc to man transition failed" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_CS-works.sh Added

@@ -0,0 +1,42 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOCUMENT=\
+'.Dd 2020-10-31
+.Dt sample 1
+.Os
+.Sh Name
+.Nm sample
+.Nd test subject for groff'
+
+echo "testing -rCS=0" >&2
+echo "$DOCUMENT" | "$groff" -rCS=0 -Tascii -P-cbou -mdoc \
+	| grep -q Name || exit 1
+
+echo "testing -rCS=1" >&2
+echo "$DOCUMENT" | "$groff" -rCS=1 -Tascii -P-cbou -mdoc \
+	| grep -q NAME || exit 1
+
+echo "testing default (no -rCS argument)" >&2
+echo "$DOCUMENT" | "$groff" -Tascii -P-cbou -mdoc \
+	| grep -q Name || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_CT-works.sh Added

@@ -0,0 +1,42 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOCUMENT=\
+'.Dd 2020-10-31
+.Dt sample 1
+.Os
+.Sh Name
+.Nm sample
+.Nd test subject for groff'
+
+echo "testing -rCT=0" >&2
+echo "$DOCUMENT" | "$groff" -rCT=0 -Tascii -P-cbou -mdoc \
+	| grep -q 'sample(1)' || exit 1
+
+echo "testing -rCT=1" >&2
+echo "$DOCUMENT" | "$groff" -rCT=1 -Tascii -P-cbou -mdoc \
+	| grep -q 'SAMPLE(1)' || exit 1
+
+echo "testing default (no -rCT argument)" >&2
+echo "$DOCUMENT" | "$groff" -Tascii -P-cbou -mdoc \
+	| grep -q 'sample(1)' || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_D-places-page-numbers-correctly.sh Added

@@ -0,0 +1,45 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOCUMENT=\
+'.Dd 2020-11-17
+.Dt sample 1
+.Os "groff test suite"
+.Sh Name
+.Nm sample
+.Nd test subject for groff
+.bp
+.Sh Description
+This program does many things.'
+
+# Regression-test Debian #919890.
+#
+# Put page numbers in the correct places when double-sided rendering.
+
+echo "confirming page number on right on recto (odd-numbered) pages" >&2
+echo "$DOCUMENT" | "$groff" -rcR=0 -rD1 -Tascii -P-cbou -mdoc \
+    | grep -q '^groff test suite *2020-11-17 *1$' || exit 1
+
+echo "confirming page number on left on verso (even-numbered) pages" >&2
+echo "$DOCUMENT" | "$groff" -rcR=0 -rD1 -Tascii -P-cbou -mdoc \
+    | grep -q '^2 *2020-11-17 *groff test suite$' || exit 1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59738.  The processing of arguments after
+# the link text should not break end-of-sentence detection.
+
+input='.Dd 2022-09-15
+.Dt foo 1
+.Os "groff test suite"
+.Sh Name
+.Nm foo
+.Nd frobnicate a bar
+.Sh Description
+Click
+.Lk http://example.com here .
+Follow instructions.'
+
+output=$(echo "$input" | "$groff" -Tascii -P-cbou -mdoc)
+echo "$output" | grep -Fq 'com.  Follow' # 2 spaces
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_Mt-works.sh Added

@@ -0,0 +1,48 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Regression-test Savannah #60025.
+#
+# Ensure .Mt renders correctly.
+
+input='.Dd 2021-02-10
+.Dt mandoc 1
+.Os groff test suite
+.Sh Authors
+.An -nosplit
+The
+.Nm mandoc
+utility was written by
+.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv
+and is maintained by
+.An Ingo Schwarze Aq Mt schwarze@openbsd.org .'
+
+output=$(echo "$input" | "$groff" -Tascii -P-cbou -mdoc)
+
+echo "$output" \
+    | grep -Fq 'written by Kristaps Dzonsons <kristaps@bsd.lv>'
+
+echo "$output" \
+    | grep -Fq 'is maintained by Ingo Schwarze <schwarze@openbsd.org>.'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_Nm-works.sh Added

@@ -0,0 +1,74 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=yes
+}
+
+# Unit test `Nm` macro (and regression-test Savannah #63377).
+
+input='.Dd 2022-11-17
+.Dt foo 1
+.Os "groff test suite"
+.Sh Name
+.Nm foo
+.Nd frobnicate a bar
+.Sh Description
+.Nm
+is a program.'
+
+echo "checking Nm's interpolation of text after initial call" >&2
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mdoc)
+echo "$output"
+echo "$output" | grep -q 'foo is a program\.' || wail
+
+# Handle multiple declarations in "Name" section.
+
+input='.Dd 2022-11-17
+.Dt trig.h 3
+.Os "groff test suite"
+.Sh Name
+.Nm sin ,
+.Nm cos ,
+.Nm tan
+.Nd trigonometric functions
+.Sh Description
+.Nm
+returns the sine of its argument,
+an angle
+.Ms theta .'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mdoc)
+echo "$output"
+
+echo "checking Nm behavior when called multiple times (Name)" >&2
+echo "$output" | grep -q 'sin, cos, tan -- trigonometric' || wail
+
+echo "checking Nm behavior when called multiple times (Description)" >&2
+echo "$output" | grep -q 'sin returns the sine' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_P-register-works.sh Added

@@ -0,0 +1,54 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.Dd 2022-12-11
+.Dt foo 1
+.Os "groff test suite"
+.Sh Name
+.Nm foo
+.Nd frobnicate a bar
+.bp
+.Sh Description
+It took a while to get here.'
+
+output=$(printf "%s\n" "$input" | "$groff" -rcR=0 -rP13 -mdoc -Tascii \
+    -P-cbou)
+echo "$output"
+
+echo "checking first page footer" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +13$" \
+    | grep '^64:' || wail
+
+echo "checking second page footer" >&2
+echo "$output" | grep -En "^groff test suite +2022-12-11 +14$" \
+    | grep '^130:' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_X-register-works.sh Added

@@ -0,0 +1,70 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+# Ensure the X register takes effect on the right page and looks right.
+
+input='.Dd 2022-12-14
+.Dt foo 1
+.Os "groff foo test suite"
+.Dd 2022-12-14
+.Dt bar 1
+.Os "groff bar test suite"'
+
+output=$(printf "%s\n" "$input" \
+    | "$groff" -Tascii -P-cbou -rcR=0 -rC1 -rX1 -mdoc)
+echo "$output"
+
+echo "checking first page footer" >&2
+echo "$output" | grep -Eqx 'groff foo test suite +2022-12-14 +1' || wail
+
+echo "checking second page footer" >&2
+echo "$output" | grep -Eqx 'groff bar test suite +2022-12-14 +1a' \
+    || wail
+
+# XXX: mdoc output does not yet suppress headers and footers.
+#
+#input='.Dd 2022-12-14
+#.Dt baz 1
+#.Os "groff baz test suite"
+#.Sh Name
+#.Nm baz
+#.Nd what you will not hear at the Mos Eisley spaceport cantina
+#.Sh Description
+#This program is a fifth wheel.'
+#
+#output=$(printf "%s\n" "$input" \
+#    | "$groff" -Thtml -rcR=0 -rC1 -rX1 -mdoc)
+#echo "$output"
+#
+#echo "checking for absence of footer text in HTML output" >&2
+#echo "$OUTPUT" | grep -q 'groff baz test suite' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_accept-mixed-case-section-headings.sh Added

@@ -0,0 +1,76 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure we recognize mixed-case section headings ("Name" as well as
+# "NAME").
+
+EXAMPLE='\
+.Dd September 14, 2020
+.Dt mdoc\-test 7
+.Os
+.Sh Name
+.Nm mdoc\-test
+.Nd a smoke test for groff'"'"'s mdoc implementation
+.Sh Description
+This page has mixed-case section headings.
+.Pp
+This paragraph works around Savannah #59106.
+.Dd September 14, 2020
+.Dt mdoc\-test 7
+.Os
+.Sh NAME
+.Nm mdoc\-test
+.Nd a smoke test for groff'"'"'s mdoc implementation
+.Sh DESCRIPTION
+This page has fully-capitalized section headings.\
+'
+
+OUTPUT=$(printf "%s\n" "$EXAMPLE" | "$groff" -Tascii -P-cbou -mdoc)
+FAIL=
+
+if  -z "$(echo "$OUTPUT" | sed -n '/Name/{N;/smoke/p;}')" 
+then
+    FAIL=yes
+    echo "section \"Name\" check failed" >&2
+fi
+
+if  -z "$(echo "$OUTPUT" | sed -n '/Description/{N;/mixed-case/p;}')" 
+then
+    FAIL=yes
+    echo "section \"Description\" check failed" >&2
+fi
+
+if  -z "$(echo "$OUTPUT" | sed -n '/NAME/{N;/smoke/p;}')" 
+then
+    FAIL=yes
+    echo "section \"NAME\" check failed" >&2
+fi
+
+if  -z "$(echo "$OUTPUT" | sed -n '/DESCRIPTION/{N;/fully-cap/p;}')" 
+then
+    FAIL=yes
+    echo "section \"DESCRIPTION\" check failed" >&2
+fi
+
+test -z "$FAIL"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh Added

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+DOCUMENT=\
+'.Dd 2020-11-17
+.Dt ftp 1
+.Os "groff test suite"
+.Sh Name
+.Nm ftp
+.Nd transfer files insecurely'
+
+# Regression-test Debian #411227.
+#
+# Don't loop infinitely when trying to shorten page header and we can't
+# shrink it any further.
+
+echo "$DOCUMENT" | "$groff" -z -rLT=35n -Tascii -P-cbou -mdoc
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_heading-font-remapping-works.sh Added

@@ -0,0 +1,58 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+# Ensure that italics in a section heading get remapped to bold italics
+# (if the heading font is bold).
+
+input='.Dd 2022-12-26
+.Dt foo 1
+.Os "groff test suite"
+.Sh Name
+.Nm foo
+.Nd frobnicate a bar
+.Sh Hacking Xr groff
+Have fun!'
+
+output=$(printf "%s\n" "$input" | "$groff" -mdoc -Tascii -Z)
+echo "$output"
+
+echo "$output" | sed -n '/tHacking/{n
+/x font 4 BI/{n
+/f4/{n
+/h/{n
+/tgroff/{n
+/n/{n
+/f1/p;}
+}
+}
+}
+}
+}' | grep -Fqx f1
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_indents-correctly.sh Added

@@ -0,0 +1,89 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Debian #1022179.
+#
+# Ensure that subsection headings are indent correctly even if they
+# break across output lines.
+
+input='.Dd 2022-10-28
+.Dt foo 1
+.Os
+.Sh "A long section heading that wraps to illustrate the fact that the\
+ indentation of said title is consistent even if it breaks across lines"
+Discussion should be indented as ordinary paragraph.
+.Ss "A long subsection heading that wraps to illustrate the fact that\
+ the indentation of said title is consistent even if it breaks across\
+ lines"
+Further discussion should be indented as ordinary paragraph.'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mdoc)
+fail=
+
+# Verify that default `Sh` indentation is zero.
+if ! echo "$output" | grep -Eq '^A +long +section +heading'
+then
+    fail=yes
+    echo "default 'Sh' indentation check failed on 1st line" >&2
+fi
+
+if ! echo "$output" | grep -Eq '^of said title is consistent'
+then
+    fail=yes
+    echo "default 'Sh' indentation check failed on 2nd line" >&2
+fi
+
+# Verify that paragraph indentation after section heading is correct.
+# 7 spaces in string literal.
+if ! echo "$output" | grep -Eq '^       Discussion should be indented'
+then
+    fail=yes
+    echo "'Pp' indentation after 'Sh' check failed" >&2
+fi
+
+# Verify that default `Ss` indentation is three ens.
+# 3 spaces in string literal.
+if ! echo "$output" | grep -Eq '^   A +long +subsection +heading'
+then
+    fail=yes
+    echo "default 'Ss' indentation check failed on 1st line" >&2
+fi
+
+# 3 spaces in string literal.
+if ! echo "$output" | grep -Eq '^   indentation of said title is'
+then
+    fail=yes
+    echo "default 'Ss' indentation check failed on 2nd line" >&2
+fi
+
+# Verify that paragraph indentation after subsection heading is correct.
+# 7 spaces in string literal.
+if ! echo "$output" | grep -Eq '^       Further discussion should be'
+then
+    fail=yes
+    echo "'Pp' indentation after 'Ss' check failed" >&2
+fi
+
+test -z "$fail"
+exit
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_output-footer-when-continuously-rendering.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure that the page footer is printed even when a pending output line
+# is 1v from the page bottom.  (A page ejection inside an end of input
+# trap exits the formatter.)
+
+input='.Dd 2022-11-02
+.Dt foo 1
+.Os "groff test suite"
+.Sh Name
+.Nm foo
+.Nd frobnicate a bar
+.Sh Description
+.rs
+.sp 60v
+line 61
+.br
+line 62'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mdoc)
+echo "$output" | grep -Eqx 'groff test suite +2022-11-02 +foo$1$'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/doc_smoke-test.sh Added

@@ -0,0 +1,66 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo ...FAILED >&2
+    fail=yes
+}
+
+# Regression-test Savannah #51003.
+#
+# Ensure we can render mdoc man pages from a build tree.
+
+input='.Dd August 25, 2020
+.Dt mdoc\-test 7
+.Os
+.Sh Name
+.Nm mdoc\-test
+.Nd a smoke test for groff'"'"'s mdoc implementation
+.Sh Description
+If you can read this without a hailstorm of warnings,
+things are probably working.'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mdoc)
+echo "$output"
+fail=
+
+echo "checking header for correct content" >&2
+echo "$output" | grep -qE '^mdoc-test$7$ +Miscellaneous' || wail
+
+echo "checking for section heading \"Name\"" >&2
+echo "$output" | grep -qE '^Name$' || wail
+
+echo "checking for section heading \"Description\"" >&2
+echo "$output" | grep -qE '^Description$' || wail
+
+echo "checking paragraph body for correct content" >&2
+echo "$output" | grep -qE 'you can read this' || wail
+
+echo "checking footer for correct content" >&2
+echo "$output" | grep -qE '^GNU +August 25, 2020 +mdoc-test$7$' \
+    || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_chapter-titles-work.sh Added

@@ -0,0 +1,68 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Ensure that chapter (and appendix) titles aren't broken by
+# localization rigamarole.
+
+input='.de $C
+.  tm $C: \\$@
+..
+.++ C
+.+c "The Boy Sickens"
+.+c "The Boy Dies"
+.++ A
+.+c "Pathology of Boy Aged 11 Years"'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me 2>&1)
+
+echo "checking for correct arguments given to \$C hook macro (1)" >&2
+echo "$output" | grep -Fqx '$C: "Chapter" "1" "The Boy Sickens"' || wail
+
+# Ensure that the chapter number got incremented.
+echo "checking for correct arguments given to \$C hook macro (2)" >&2
+echo "$output" | grep -Fqx '$C: "Chapter" "2" "The Boy Dies"' || wail
+
+# Ensure that an appendix chapter uses uppercase alphabetical numbers.
+echo "checking for correct arguments given to \$C hook macro (3)" >&2
+echo "$output" \
+    | grep -Fqx '$C: "Appendix" "A" "Pathology of Boy Aged 11 Years"' \
+    || wail
+
+echo "checking formatted chapter heading output (1)" >&2
+echo "$output" | grep -Fq "Chapter 1" || wail
+
+echo "checking formatted chapter heading output (2)" >&2
+echo "$output" | grep -Fq "Chapter 2" || wail
+
+echo "checking formatted appendix heading output" >&2
+echo "$output" | grep -Fq "Appendix A" || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_columns-work-on-long-pages.sh Added

@@ -0,0 +1,38 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #55081.
+#
+# Ensure that long page lengths don't break columnation.
+
+EXAMPLE=\
+'.pl 159v
+.2c
+Column 1.
+.bc
+Column 2.'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -me \
+    | grep -Eqx 'Column 1\. +Column 2\.'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_delayed-text-marks-work.sh Added

@@ -0,0 +1,55 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Ensure that delayed text marks increment and reset as they should.
+
+input='.pp
+paragraph 1
+.(d
+\*# foo
+.)d
+.(d
+\*# bar
+.)d
+.pd
+.(d
+\*# baz
+.)d
+.pp
+paragraph 2
+.(d
+\*# qux
+.)d
+.pd
+.pp
+paragraph 3'
+
+output=$(echo "$input" | "$groff" -Tascii -P-cbou -me)
+
+echo "$output" | grep -Fx '1 foo'
+echo "$output" | grep -Fx '2 bar'
+echo "$output" | grep -Fx '1 baz'
+echo "$output" | grep -Fx '2 qux'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_footnote-marks-work.sh Added

@@ -0,0 +1,74 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+set -e
+
+# Ensure that footnote marks increment as they should.
+
+input='.pp
+Jackdaws*
+.(f
+* foo
+.)f
+love my big\**
+.(f
+\** bar
+.)f
+sphinx**
+.(f
+** baz
+.)f
+of quartz.\**
+.(f
+\** qux
+.)f
+.+c
+.pp
+Pack my box with five dozen liquor jugs.\**
+.(f
+\** ogg
+.)f'
+
+output=$(echo "$input" | "$groff" -Tascii -P-cbou -me)
+
+echo "$output" \
+    | grep -F 'Jackdaws* love my big1 sphinx** of quartz.2'
+
+echo "$output" \
+    | grep -F '* foo'
+
+echo "$output" \
+    | grep -F '1 bar'
+
+echo "$output" \
+    | grep -F '** baz'
+
+echo "$output" \
+    | grep -F '2 qux'
+
+echo "$output" \
+    | grep -F 'Pack my box with five dozen liquor jugs.1'
+
+echo "$output" \
+    | grep -F '1 ogg'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_footnotes-work-with-columns.sh Added

@@ -0,0 +1,43 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #58736.
+#
+# Returning to single columnation shouldn't break if footnotes are used.
+
+EXAMPLE=\
+'foo
+.(f
+footnote
+.)f
+.2c
+bar
+.bc
+baz
+.1c
+qux'
+
+test -n "$(echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -me \
+    | sed -n '/foo/{N;/bar  *baz/{N;/qux/p;};}')"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_ld-works.sh Added

@@ -0,0 +1,131 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Test the `ld` macro.
+
+input='.nr yr 108
+.nr mo 12
+.nr dy 15
+.nr dw 2
+.ld
+.++ C
+.+c "Fleeing the Impoverished, Drunken Countryside for Dublin"
+.pp
+The day was \*(dw, \*(td.
+.++ A
+.+c "How to Write for The Toast"
+.pp
+Submit it on spec.'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me)
+output_cs=$(printf "%s\n" "$input" | "$groff" -Tutf8 -P-cbou -me -mcs)
+output_de=$(printf "%s\n" "$input" | "$groff" -Tutf8 -P-cbou -me -mde)
+output_fr=$(printf "%s\n" "$input" | "$groff" -Tutf8 -P-cbou -me -mfr)
+output_it=$(printf "%s\n" "$input" | "$groff" -Tutf8 -P-cbou -me -mit)
+output_sv=$(printf "%s\n" "$input" | "$groff" -Tutf8 -P-cbou -me -msv)
+
+echo 'checking that `td` string updated correctly for English' >&2
+echo "$output" | grep -q 'The day was Monday, December 15, 2008\.$' \
+    || wail
+
+echo 'checking for correct English "Chapter" string' >&2
+echo "$output" | grep -Eqx ' +Chapter 1' || wail
+
+echo 'checking for correct English "Appendix" string' >&2
+echo "$output" | grep -Eqx ' +Appendix A' || wail
+
+# POSIX grep (as of Issue 7) does not provide any locale-independent
+# mechanism for matching 8-bit characters--they do not even match "any"
+# character ('.').  When checking the date strings, we therefore skip
+# them.  (Fortunately, at present, none of the translations of "Chapter"
+# or "Appendix" require non-Basic Latin letters.)
+
+# Czech localization
+echo 'checking that `td` string updated correctly for Czech (1)' >&2
+echo "$output_cs" | grep -q 'The day was Pond' || wail
+
+echo 'checking that `td` string updated correctly for Czech (2)' >&2
+echo "$output_cs" | grep -q ', 15 Prosinec 2008\.$' || wail
+
+echo 'checking for correct Czech "Chapter" string' >&2
+echo "$output_cs" | grep -Eqx ' +Kapitola 1' || wail
+
+echo 'checking for correct Czech "Appendix" string' >&2
+echo "$output_cs" | grep -Eqx ' +Dodatek A' || wail
+
+# German localization
+echo 'checking that `td` string updated correctly for German' >&2
+echo "$output_de" \
+    | grep -q 'The day was Montag, 15\. Dezember\. 2008\.$' || wail
+
+echo 'checking for correct German "Chapter" string' >&2
+echo "$output_de" | grep -Eqx ' +Kapitel 1' || wail
+
+echo 'checking for correct German "Appendix" string' >&2
+echo "$output_de" | grep -Eqx ' +Anhang A' || wail
+
+# French localization
+echo 'checking that `td` string updated correctly for French (1)' >&2
+echo "$output_fr" | grep -q 'The day was Lundi, 15 D'
+
+echo 'checking that `td` string updated correctly for French (2)' >&2
+echo "$output_fr" | grep -q 'cembre 2008\.$' || wail
+
+echo 'checking for correct French "Chapter" string' >&2
+echo "$output_fr" | grep -Eqx ' +Chapitre 1' || wail
+
+echo 'checking for correct French "Appendix" string' >&2
+echo "$output_fr" | grep -Eqx ' +Annexe A' || wail
+
+# Italian localization
+echo 'checking that `td` string updated correctly for Italian' >&2
+echo "$output_it" | grep -q 'The day was Lunedì, 15 Dicembre 2008\.$'
+
+echo 'checking for correct Italian "Chapter" string' >&2
+echo "$output_it" | grep -Eqx ' +Capitolo 1' || wail
+
+echo 'checking for correct Italian "Appendix" string' >&2
+echo "$output_it" | grep -Eqx ' +Appendice A' || wail
+
+# Swedish localization
+echo 'checking that `td` string updated correctly for Swedish (1)' >&2
+echo "$output_sv" | grep -q 'The day was m'
+
+echo 'checking that `td` string updated correctly for Swedish (2)' >&2
+echo "$output_sv" | grep -q 'ndag, 15 december 2008\.$' || wail
+
+echo 'checking for correct Swedish "Chapter" string' >&2
+echo "$output_sv" | grep -Eqx ' +Kapitel 1' || wail
+
+echo 'checking for correct Swedish "Appendix" string' >&2
+echo "$output_sv" | grep -Eqx ' +Bilaga A' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_line-numbering-works.sh Added

@@ -0,0 +1,141 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Test the line numbering feature.
+
+input='.nr pp 18 \\" to make troff output consistent with nroff
+.if r mypo .po \\nmypou
+.if !d C .ds C\\" empty
+.pp
+Feck, vex loping bad jazz: quench my thirst.
+Feck, vex loping bad jazz: quench my thirst.
+.pp
+.n1 \\*C
+Jackdaws love my big sphinx of quartz.
+Jackdaws love my big sphinx of quartz.
+Jackdaws love my big sphinx of quartz.
+.pp
+How vexingly quick daft zebras jump!
+.pp
+.n2 +6
+Waltz, bad nymph, for quick jigs vex.
+Waltz, bad nymph, for quick jigs vex.
+.pp
+.n2 99
+Pack my box with five dozen liquor jugs.
+Pack my box with five dozen liquor jugs.
+Pack my box with five dozen liquor jugs.
+.pp
+.n2
+The five boxing wizards jump quickly.
+The five boxing wizards jump quickly.'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+echo '*** basic output (line number field prepended)' >&2
+output=$(echo "$input" | "$groff" -Tascii -P-cbou -me)
+
+echo "$output"
+
+# We expect the foregoing to produce a me(7) diagnostic complaining of a
+# negative page offset but we're not testing for that.
+
+echo 'checking for 0 page offset and 5n paragraph indentation (1)' >&2
+echo "$output" | grep -q '^     Feck.*vex$' || wail # 5 spaces
+
+# troff uses backspaces to emit the line number, so we can't anchor the
+# matches to the beginning of the line with '^'.
+
+# These patterns have 6 embedded spaces until further notice.
+echo 'checking for line number field plus 60n line length' >&2
+echo "$output" | grep -q '1      Jackdaws.*love$' || wail
+
+echo 'checking for non-numbering of blank lines' >&2
+echo "$output" | grep -q '4      How.*jump!$' || wail
+
+echo 'checking offset-advanced two-digit line number' >&2
+echo "$output" | grep -q '^10      Waltz,.*bad nymph$'
+
+echo 'checking three-digit line number' >&2
+echo "$output" | grep -q '^100      with.*dozen$'
+
+echo 'checking for 0 page offset and 5n paragraph indentation (2)' >&2
+echo "$output" | grep -q '^     The.*boxing$' || wail # 5 spaces
+
+echo '*** roff(1)-compatible output (shorter line length)' >&2
+output=$(echo "$input" | "$groff" -dCC -Tascii -P-cbou -me)
+
+echo "$output"
+
+echo 'checking for 0 page offset and 5n paragraph indentation (1)' >&2
+echo "$output" | grep -q '^     Feck.*vex' || wail # 5 spaces
+
+echo 'checking for line number field plus 56n line length' >&2
+echo "$output" \
+    | grep -q '  1      Jackdaws.*Jackdaws$' || wail # 2, then 6 spaces
+
+# These patterns have 6 embedded spaces until further notice.
+echo 'checking for non-numbering of blank lines' >&2
+echo "$output" | grep -q '4      How.*jump!$' || wail
+
+echo 'checking offset-advanced two-digit line number' >&2
+echo "$output" | grep -q ' 10      Waltz,.*bad$' || wail
+
+echo 'checking three-digit line number' >&2
+echo "$output" | grep -q '^100      box.*dozen$'
+
+echo 'checking for 0 page offset and 5n paragraph indentation (2)' >&2
+echo "$output" | grep -q '^     The.*boxing$' || wail # 5 spaces
+
+echo '*** output with 4n page offset' >&2
+output=$(echo "$input" | "$groff" -rmypo=4n -Tascii -P-cbou -me)
+
+echo "$output"
+
+echo 'checking for 4n page offset and 5n paragraph indentation (1)' >&2
+echo "$output" | grep -q '^         Feck.*vex' || wail # 9 spaces
+
+echo 'checking for line number field plus 60n line length' >&2
+echo "$output" \
+    | grep -q '  1      Jackdaws.*love$' || wail # 2, then 6 spaces
+
+# These patterns have 6 embedded spaces until further notice.
+echo 'checking for non-numbering of blank lines' >&2
+echo "$output" | grep -q '4      How.*jump!$' || wail
+
+echo 'checking offset-advanced two-digit line number' >&2
+echo "$output" | grep -q ' 10      Waltz,.*bad$' || wail
+
+echo 'checking three-digit line number' >&2
+echo "$output" | grep -q '^100      box.*dozen$'
+
+echo 'checking for 4n page offset and 5n paragraph indentation (2)' >&2
+echo "$output" | grep -q '^         The.*boxing$' || wail # 9 spaces
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/e_rejects-too-short-page-lengths.sh Added

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Page lengths that are too short cause loss of header/footer text and
+# infinite trap recursion in extreme cases.
+#
+# As of the time of this writing, bad behavior (a superfluous page
+# break) sets in at 14v, and we start to lose headers/footers at a
+# length of 13v.  Get down to 7v and the traps infinitely recurse.
+
+input='.pl 7v
+.he "A"B"C"
+.fo "D"E"F"
+.lp
+foobar
+'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -me 2>&1)
+status=$?
+
+echo "checking for nonzero exit status" >&2
+test $status -ne 0 || wail
+
+# grepping diagnostic messages is a tar pit.  I hope I don't come to
+# regret this.
+
+echo "checking for lack of diagnostic about infinite loop" >&2
+echo "$output" | grep -q 'troff.*fatal.*infinite' && wail
+
+echo "checking for diagnostic about page length" >&2
+echo "$output" | grep -q 'e\.tmac.*page length' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/ec_works.sh Added

@@ -0,0 +1,45 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Verify that the EC fonts get loaded by using their Euro and per mille
+# glyphs (which aren't in the CM fonts) to detect them.
+input='.ec @
+.de EM
+.  ft @@$1
+.  nop @Eu @%0
+..
+.nf
+.EM TR
+.EM TI
+.EM TB
+.EM TBI
+.EM HR
+.EM HI
+.EM HB
+.EM HBI
+.EM CW
+.EM CWI'
+
+output=$(printf "%s\n" "$input" | "$groff" -mec -Tdvi -z 2>&1)
+test -z "$output"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/latin2_works.sh Added

@@ -0,0 +1,76 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED $*"
+    fail=yes
+}
+
+input=$(\
+    printf '\\A ho\\ab\\/L\\S aa';
+    printf '\\vS\\S ac\\T ah\\Z aa\\vZ\\Z a.\n';
+    printf '\\a ho\\ho\\/l\\s aa';
+    printf '\\vs\\s ac\\t ah\\z aa\\a"\\vZ\\z a.\n';
+    printf '\\R aa\\A ab\\L aa\\C aa';
+    printf '\\C ah\\E ho\\E ah\\D ah\n';
+    printf '\\u0110\\N aa\\N ah\\O a"';
+    printf '\\R ah\\U ao\\U a"\\T ac\n';
+    printf '\\r aa\\a ab\\l aa\\c aa';
+    printf '\\c ah\\e ho\\e ah\\d ah\n';
+    printf '\\u0111\\n aa\\n ah\\o a"';
+    printf '\\r ah\\u ao\\u a"\\t ac\\a.\n';
+)
+
+output=$(printf "%s\n" "$input" | "$groff" -Tlatin1 -mlatin2 \
+    | LC_ALL=C od -t o1)
+printf "%s\n" "$output"
+printf "$output" \
+    | grep -Eq '^0000000 +241 242 243 246 251 252 253 254 256 257 +' \
+    || wail "in block 0xA0"
+printf "$output" \
+    | grep -Eq '^0000000 +.* 261 262 263 266 271$' \
+    || wail "in block 0xB0 (address 0..017)"
+printf "$output" \
+    | grep -Eq '^0000020 +272 273 274 275 256 277 +' \
+    || wail "in block 0xB0 (address 020..037)"
+printf "$output" \
+    | grep -Eq '^0000020 +.* 300 303 305 306 310 312 314 317 040$' \
+    || wail "in block 0xC0"
+printf "$output" \
+    | grep -Eq '^0000040 +320 321 322 325 330 331 333 336 +' \
+    || wail "in block 0xD0"
+printf "$output" \
+    | grep -Eq '^0000040 +.* 340 343 345 346 350 352 354$' \
+    || wail "in block 0xE0 (address 040..057)"
+printf "$output" \
+    | grep -Eq '^0000060 +357 +' \
+    || wail "in block 0xE0 (address 060..077)"
+printf "$output" \
+    | grep -Eq \
+        '^0000060 +.* 360 361 362 365 370 371 373 376 377( 012)+$' \
+    || wail "in block 0xF0"
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/latin5_works.sh Added

@@ -0,0 +1,30 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input=$(printf '\\G ab\\g ab\\u0130\\.i\\S ac\\s ac')
+output=$(printf "%s\n" "$input" | "$groff" -Tlatin1 -mlatin5 \
+    | LC_ALL=C od -t o1)
+printf "%s\n" "$output"
+printf "$output" \
+    | grep -Eq '^0000000 +320 360 335 375 336 376 +'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/latin9_works.sh Added

@@ -0,0 +1,30 @@
+#!/bin/sh
+#
+# Copyright (C) 2022-2023 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+input=$(printf '\\Eu\\vS\\vs\\vZ\\vz\\OE\\oe\\:Y\n')
+output=$(printf "%s\n" "$input" | "$groff" -Tlatin1 -mlatin9 \
+    | LC_ALL=C od -t o1)
+printf "%s\n" "$output"
+printf "$output" \
+    | grep -Eq '^0000000 +244 246 250 264 270 274 275 276 +'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/localization-works.sh Added

@@ -0,0 +1,189 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+input='.tm .hy=\n.hy'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mcs 2>&1)
+echo 'checking raw troff with -mcs' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mde 2>&1)
+echo 'checking raw troff with -mde' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -men 2>&1)
+echo 'checking raw troff with -men' >&2
+echo "$output" | grep -Fqx '.hy=4' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mfr 2>&1)
+echo 'checking raw troff with -mfr' >&2
+echo "$output" | grep -Fqx '.hy=4' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -mit 2>&1)
+echo 'checking raw troff with -mit' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -msv 2>&1)
+echo 'checking raw troff with -msv' >&2
+echo "$output" | grep -Fqx '.hy=32' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -mcs 2>&1)
+echo 'checking -me with -mcs' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -mde 2>&1)
+echo 'checking -me with -mde' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -men 2>&1)
+echo 'checking -me with -men' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -mfr 2>&1)
+echo 'checking -me with -mfr' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -mit 2>&1)
+echo 'checking -me with -mit' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -me -msv 2>&1)
+echo 'checking -me with -msv' >&2
+echo "$output" | grep -Fqx '.hy=34' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -mcs 2>&1)
+echo 'checking -ms with -mcs' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -mde 2>&1)
+echo 'checking -ms with -mde' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -men 2>&1)
+echo 'checking -ms with -men' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -mfr 2>&1)
+echo 'checking -ms with -mfr' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -mit 2>&1)
+echo 'checking -ms with -mit' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -ms -msv 2>&1)
+echo 'checking -ms with -msv' >&2
+echo "$output" | grep -Fqx '.hy=34' || wail
+
+input='.TH foo 1 2022-01-06 "groff test suite"
+.tm .hy=\n.hy'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mcs 2>&1)
+echo 'checking -man with -rcR=0 -mcs' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mde 2>&1)
+echo 'checking -man with -rcR=0 -mde' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -men 2>&1)
+echo 'checking -man with -rcR=0 -men' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mfr 2>&1)
+echo 'checking -man with -rcR=0 -mfr' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mit 2>&1)
+echo 'checking -man with -rcR=0 -mit' >&2
+echo "$output" | grep -Fqx '.hy=2' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -msv 2>&1)
+echo 'checking -man with -rcR=0 -msv' >&2
+echo "$output" | grep -Fqx '.hy=34' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -mcs 2>&1)
+echo 'checking -man with -rcR=1 -mcs' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -mde 2>&1)
+echo 'checking -man with -rcR=1 -mde' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -men 2>&1)
+echo 'checking -man with -rcR=1 -men' >&2
+echo "$output" | grep -Fqx '.hy=4' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -mfr 2>&1)
+echo 'checking -man with -rcR=1 -mfr' >&2
+echo "$output" | grep -Fqx '.hy=4' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -mit 2>&1)
+echo 'checking -man with -rcR=1 -mit' >&2
+echo "$output" | grep -Fqx '.hy=1' || wail
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=1 -man -msv 2>&1)
+echo 'checking -man with -rcR=1 -msv' >&2
+echo "$output" | grep -Fqx '.hy=32' || wail
+
+# Ensure that the 'trap bit' (hyphenation value 2, which has nothing to
+# do with any language) is preserved when switching locales back from a
+# CJK language, since those languages' modes unconditionally clear it.
+
+input='.TH foo 1 2022-04-09 "groff test suite"
+.SH 名前
+foo \- APT 用選択制御ファイル
+.mso en.tmac
+.TH bar 1 2022-04-09 "groff test suite"
+.SH Name
+bar \- three subjects walk into this
+.tm .hy=\n.hy'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mja \
+  -men 2>&1)
+echo 'checking -man with -rcR=0 -mja -men' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+input='.TH foo 1 2022-04-09 "groff test suite"
+.SH 名称
+foo \- 解析 man 手册页的头部信息
+.mso en.tmac
+.TH bar 1 2022-04-09 "groff test suite"
+.SH Name
+bar \- three subjects walk into this
+.tm .hy=\n.hy'
+
+output=$(printf "%s\n" "$input" | "$groff" -Tascii -P-cbou -rcR=0 -man -mzh \
+  -men 2>&1)
+echo 'checking -man with -rcR=0 -mzh -men' >&2
+echo "$output" | grep -Fqx '.hy=6' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh Added

@@ -0,0 +1,83 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+# Give the output a name that won't collide with another test.
+gnu_pdf="${abs_top_builddir:-.}/doc/gnu-no-choke-on-pdfinfo.pdf"
+
+# Regression-test Savannah #58206.
+
+# We need gs(1) and pdfpic.tmac needs pdfinfo(1).
+for cmd in gs pdfinfo
+do
+    if ! command -v $cmd >/dev/null
+    then
+        echo "cannot locate '$cmd' command" >&2
+        exit 77 # skip
+    fi
+done
+
+# Locate directory containing our test artifacts.
+artifact_dir=
+
+for buildroot in . .. ../..
+do
+    d=$buildroot/doc
+    if  -f $d/gnu.eps 
+    then
+        artifact_dir=$d
+        gnu_eps=$artifact_dir/gnu.eps
+        break
+    fi
+done
+
+# If we can't find it, we can't test.
+test -z "$artifact_dir" && exit 77 # skip
+
+if  -e "$gnu_pdf" 
+then
+    echo "temporary output file '$gnu_pdf' already exists" >&2
+    exit 77 # skip
+fi
+
+fail=
+
+input='.am pdfpic@error
+.  ab
+..
+Here is a picture of a wildebeest.
+.PDFPIC '"$gnu_pdf"
+
+if ! gs -q -o - -sDEVICE=pdfwrite -f "$gnu_eps" \
+    -c " /Title (\000B\000U\000S\000T\000E\000D) /DOCINFO pdfmark" \
+    > "$gnu_pdf"
+then
+    echo "gs command failed" >&2
+    rm -f "$gnu_pdf"
+    exit 77 # skip
+fi
+
+test -z "$fail" \
+    && printf '%s\n' "$input" | "$groff" -Tpdf -U -z || fail=YES
+
+rm -f "$gnu_pdf"
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/pdfpic_falls-back-to-PSPIC.sh Added

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_IP-indents-using-paragraph-type-size.sh Added

@@ -0,0 +1,50 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+export GROFF_TYPESETTER=
+
+# Regression-test Savannah #59604.
+#
+# Ensure that the indentation amount used by IP is based on the type
+# size of the _paragraph_, not a preceding heading (which might have
+# been affected by GROWPS).
+
+EXAMPLE=\
+'.nr PSINCR 3p
+.nr GROWPS 3
+.SH 1
+Text
+.IP 1. 4
+Filling
+.IP 2. 4
+Sentences'
+
+OUTPUT=$(echo "$EXAMPLE" | "$groff" -ms -Z \
+    | sed -n '/^H92000$/{
+                         N
+                         /\ntFilling$/{
+                                       p
+                                       b
+                                      }
+                        }')
+test -n "$OUTPUT"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59742.
+#
+# Ensure that a non-default inter-sentence space setting is respected
+# inside a multi-sentence tag to an indented paragraph.
+
+EXAMPLE=\
+'.ss 12 24
+.LP
+Foo.  Bar.
+.IP "Baz.  Qux."
+Foo.  Bar.
+'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -ms \
+    | grep -qx 'Baz\.   Qux\.' # 3 spaces.
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_PN-works.sh Added

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59823.
+#
+# Ensure retention of superfluous but fossilized register PN.
+
+EXAMPLE=\
+'.bp 2
+.LP
+This is page \nPN.
+'
+
+printf "%s" "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -ms \
+    | grep -Fqx 'This is page 2.'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_R-handles-its-arguments.sh Added

@@ -0,0 +1,41 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59348.
+#
+# Ensure that .R actually handles its arguments.
+
+EXAMPLE=\
+'.LP
+of the form
+.I
+.R * id\\c module
+.R
+\&.
+'
+
+# That \c's a killer.  Can't use echo.
+printf "%s" "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -ms \
+    | grep -Fqx 'of the form module*id.'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_SH-resets-IP-indentation-amount.sh Added

@@ -0,0 +1,40 @@
+#!/bin/sh
+#
+# Copyright (C) 2021 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #60222.
+#
+# SH should reset IP indentation amount as other paragraphing macros do.
+
+EXAMPLE=\
+'.IP @ 3n
+3n indentation
+.SH
+Section heading
+.IP
+default indentation
+'
+
+echo "$EXAMPLE" \
+    | "$groff" -Tascii -P-cbou -ms \
+    | grep -qx '     default indentation' # 5 spaces
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_TC-works-with-percent-in-custom-titles.sh Added

@@ -0,0 +1,52 @@
+#!/bin/sh
+#
+# Copyright (C) 2020 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #59345.
+#
+# Ensure that .TC succeeds in assigning the 'i' format to the page
+# number register when '%' is used in a custom header or footer.
+
+EXAMPLE=\
+'.OH ##%##
+.NH 1
+Foo
+.XS
+Foo
+.XE
+.LP
+Bar.
+.TC
+'
+
+OUTPUT=$(echo "$EXAMPLE" | "$groff" -Tascii -P-cbou -ms)
+# Strip blank lines from the output first; all we care about for this
+# test is the presence, adjacency, and ordering of non-blank lines.
+FILTERED_OUTPUT=$(echo "$OUTPUT" \
+    | sed '/^$/d' \
+    | sed -n '/i/{
+N;/Table of Contents/{
+N;/Foo. . *1/p;
+};
+}')
+test -n "$FILTERED_OUTPUT"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh Added

@@ -0,0 +1,59 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #61853.
+#
+# The word "no" as the first argument to the `XA` macro should suppresss
+# not just the page number, but the leader before it as well.
+
+input='.PP
+.XS
+This is my TOC entry
+.XA no
+There are many like it
+.XE
+But this one is mine.
+.TC
+'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+# Be aware of
+# <https://unix.stackexchange.com/questions/383217/\
+# shell-keep-trailing-newlines-n-in-command-substitution> when comparing
+# this to interactive output.
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -ms)
+
+echo "checking for presence of supplemental TOC entry" >&2
+echo "$output" | grep -q 'There are many like it' || wail
+
+echo "checking for suppressed leader in supplemental TOC entry" >&2
+echo "$output" | grep -qx 'There are many like it' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_honor-MINGW-when-two-columns.sh Added

@@ -0,0 +1,37 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #62687.
+
+input='.nr MINGW 5n
+.pl 16v
+.2C
+.PP
+Sed ut perspiciatis, unde omnis iste natus error sit voluptatem
+accusantium doloremque laudantium, totam rem aperiam eaque ipsa,'
+
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -ms)
+echo "$output"
+
+echo "$output" | grep -Eq 'Sed +ut +perspiciatis, +unde {5}a-z'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_mark-column-start-correctly.sh Added

@@ -0,0 +1,38 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #62686.
+
+input='.pl 15v
+.2C
+.PP
+Sed ut perspiciatis, unde omnis iste natus error sit voluptatem
+accusantium doloremque laudantium, totam rem aperiam eaque ipsa, quae ab
+illo inventore veritatis et quasi architecto beatae vitae dicta sunt,
+explicabo.'
+
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -ms)
+echo "$output"
+
+echo "$output" | grep -Eq 'Sed +ut +perspiciatis, unde  +voluptatem'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_no-excess-space-around-displays.sh Added

@@ -0,0 +1,39 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Regression-test Savannah #62688.
+
+input='.pl 19v
+.LP
+This is my first paragraph.
+.LD
+This is my block display.
+.DE
+.LP
+This is my second paragraph.'
+
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -ms \
+    | awk '{print NR, $0}')
+
+echo "$output" | grep -Fqx '11 This is my second paragraph.'
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.23.0.tar.gz/tmac/tests/s_rejects-too-short-page-lengths.sh Added

@@ -0,0 +1,61 @@
+#!/bin/sh
+#
+# Copyright (C) 2022 Free Software Foundation, Inc.
+#
+# 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 the Free
+# Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# 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 this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+groff="${abs_top_builddir:-.}/test-groff"
+
+# Page lengths that are too short cause loss of header/footer text and
+# infinite trap recursion in extreme cases.
+#
+# As of the time of this writing, bad behavior (a superfluous page
+# break) sets in at 14v, and we start to lose headers/footers at a
+# length of 13v.  Get down to 7v and the traps infinitely recurse.
+
+input='.pl 7v
+.ds CF footer
+.P1 \" ensure header on page 1
+.LP
+foobar
+'
+
+fail=
+
+wail () {
+    echo "...FAILED" >&2
+    fail=YES
+}
+
+output=$(printf '%s\n' "$input" | "$groff" -Tascii -P-cbou -ms 2>&1)
+status=$?
+
+echo "checking for nonzero exit status" >&2
+test $status -ne 0 || wail
+
+# grepping diagnostic messages is a tar pit.  I hope I don't come to
+# regret this.
+
+echo "checking for lack of diagnostic about infinite loop" >&2
+echo "$output" | grep -q 'troff.*fatal.*infinite' && wail
+
+echo "checking for diagnostic about page length" >&2
+echo "$output" | grep -q 's\.tmac.*page length' || wail
+
+test -z "$fail"
+
+# vim:set ai et sw=4 ts=4 tw=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/tmac.am -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/tmac.am Changed

@@ -1,8 +1,7 @@
-# Copyright (C) 1989-2018 Free Software Foundation, Inc.
-#      Written by James Clark (jjc@jclark.com)
+# Copyright (C) 1989-2020 Free Software Foundation, Inc.
+#      Written by James Clark <jjc@jclark.com>
 #      Automake migration by Bertrand Garrigues
-#
-# Latest update: 22 Aug 2015
+#        <bertrand.garrigues@laposte.net>
 #
 # This file is part of groff.
 #
@@ -18,12 +17,14 @@
 #
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
 tmac_srcdir = $(top_srcdir)/tmac
 tmac_builddir = $(top_builddir)/tmac
 
 man7_MANS += \
   tmac/groff_ms.7 \
   tmac/groff_man.7 \
+  tmac/groff_man_style.7 \
   tmac/groff_me.7 \
   tmac/groff_mdoc.7 \
   tmac/groff_trace.7 \
@@ -33,23 +34,24 @@
   tmac/man.tmac \
   tmac/mandoc.tmac \
   tmac/andoc.tmac \
-  tmac/an-old.tmac \
   tmac/an-ext.tmac \
   tmac/ms.tmac \
+  tmac/e.tmac \
   tmac/me.tmac \
+  tmac/doc-old.tmac \
+  tmac/doc.tmac \
   tmac/mdoc.tmac \
   tmac/pic.tmac \
-  tmac/a4.tmac \
   tmac/papersize.tmac \
   tmac/62bit.tmac \
   tmac/ec.tmac \
-  tmac/safer.tmac \
   tmac/trace.tmac \
   tmac/ps.tmac \
   tmac/psold.tmac \
   tmac/pdfpic.tmac \
   tmac/pspic.tmac \
   tmac/psatk.tmac \
+  tmac/ptx.tmac \
   tmac/pdf.tmac \
   tmac/dvi.tmac \
   tmac/tty.tmac \
@@ -59,7 +61,6 @@
   tmac/latin5.tmac \
   tmac/latin9.tmac \
   tmac/cp1047.tmac \
-  tmac/unicode.tmac \
   tmac/X.tmac \
   tmac/Xps.tmac \
   tmac/lj4.tmac \
@@ -77,10 +78,13 @@
   tmac/troffrc \
   tmac/troffrc-end \
   tmac/trans.tmac \
-  tmac/hyphen.us \
-  tmac/hyphenex.us \
+  tmac/en.tmac \
+  tmac/hyphen.en \
+  tmac/hyphenex.en \
   tmac/fr.tmac \
   tmac/hyphen.fr \
+  tmac/it.tmac \
+  tmac/hyphen.it \
   tmac/sv.tmac \
   tmac/hyphen.sv \
   tmac/de.tmac \
@@ -92,36 +96,41 @@
   tmac/hyphenex.cs \
   tmac/ja.tmac \
   tmac/zh.tmac
-NORMALFILES = `echo $(TMACNORMALFILES) | sed -e "s|tmac/||g"`
-
-# TMACSTRIPFILES are built from their unstripped version (-u)
-TMACSTRIPFILES = tmac/e.tmac tmac/doc.tmac tmac/doc-old.tmac
 
-# Files installed in tmacdir
-dist_tmac_DATA = $(TMACNORMALFILES) tmac/an.tmac tmac/s.tmac
-nodist_tmac_DATA = $(TMACSTRIPFILES) tmac/www.tmac
+# files installed in tmacdir
+#
+# "s" and "an" are not "NORMAL" because they may use compatibility
+# wrappers; see install_tmac_wrap_hook.
+dist_tmac_DATA = \
+  $(TMACNORMALFILES) \
+  tmac/an.tmac \
+  tmac/s.tmac
+nodist_tmac_DATA = tmac/www.tmac
 
 TMACMDOCFILES = \
-  tmac/doc-common \
-  tmac/doc-ditroff \
-  tmac/doc-nroff \
-  tmac/doc-syms
-MDOCFILES = `echo $(TMACMDOCFILES) | sed -e "s|tmac/||g"`
+  tmac/mdoc/doc-common \
+  tmac/mdoc/doc-ditroff \
+  tmac/mdoc/doc-nroff \
+  tmac/mdoc/doc-syms
 mdocdir=$(tmacdir)/mdoc
 # Files installed in mdocdir
-nodist_mdoc_DATA = $(TMACMDOCFILES)
+dist_mdoc_DATA = $(TMACMDOCFILES)
 
 # Installed in localtmacdir
 dist_localtmac_DATA = tmac/man.local tmac/mdoc.local
 
-MOSTLYCLEANFILES += $(TMACMDOCFILES) tmac/www.tmac $(TMACSTRIPFILES) \
+MOSTLYCLEANFILES += \
+   tmac/groff_man.7.man \
+   tmac/groff_man_style.7.man \
+   tmac/www.tmac \
+   tmac/*-stamp \
    tmac/stamp-wrap \
    tmac/*-wrap
 
 EXTRA_DIST += \
   tmac/fixmacros.sed \
   tmac/groff_ms.7.man \
-  tmac/groff_man.7.man \
+  tmac/groff_man.7.man.in \
   tmac/groff_me.7.man \
   tmac/groff_mdoc.7.man \
   tmac/groff_trace.7.man \
@@ -131,29 +140,132 @@
   tmac/man.ultrix \
   tmac/psfig.tmac \
   tmac/ptx.tmac \
-  tmac/strip.sed \
   tmac/TESTING-HINTS \
   tmac/TODO \
   tmac/www.tmac.in
 
-dist-hook: tmac-dist-hook
-tmac-dist-hook:
-	chmod u+w $(distdir)/tmac
-	for f in $(TMACMDOCFILES) $(TMACSTRIPFILES); do \
-	  cp -f $(top_srcdir)/$$f-u $(distdir)/tmac; \
-	done
+tmac_TESTS = \
+  tmac/tests/an-ext_MR-works.sh \
+  tmac/tests/an-ext_MT-works.sh \
+  tmac/tests/an-ext_UR-works.sh \
+  tmac/tests/an_AT-and-UC-footer-saved-and-restored.sh \
+  tmac/tests/an_CS-register-off.sh \
+  tmac/tests/an_CS-register-on.sh \
+  tmac/tests/an_CS-register-unspecified.sh \
+  tmac/tests/an_CT-register-off.sh \
+  tmac/tests/an_CT-register-on.sh \
+  tmac/tests/an_CT-register-unspecified.sh \
+  tmac/tests/an_FT-bad-value-should-not-trash-titles.sh \
+  tmac/tests/an_HY-register-works.sh \
+  tmac/tests/an_LL-init-sanely.sh \
+  tmac/tests/an_ME-punct-hyphenates.sh \
+  tmac/tests/an_MR-works.sh \
+  tmac/tests/an_MT-body-hyphenates.sh \
+  tmac/tests/an_MT-works.sh \
+  tmac/tests/an_P-register-works.sh \
+  tmac/tests/an_TH-repairs-ad-damage.sh \
+  tmac/tests/an_TH-repairs-hy-damage.sh \
+  tmac/tests/an_TS-adds-no-vertical-space.sh \
+  tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh \
+  tmac/tests/an_UE-breaks-before-long-URIs.sh \
+  tmac/tests/an_UE-punct-hyphenates.sh \
+  tmac/tests/an_UR-body-hyphenates.sh \
+  tmac/tests/an_UR-works.sh \
+  tmac/tests/an_X-register-works.sh \
+  tmac/tests/an_adjust-link-text-correctly.sh \
+  tmac/tests/an_avoid-two-font-denial-of-service.sh \
+  tmac/tests/an_do-not-abbreviate-escape-using-TH-arguments.sh \
+  tmac/tests/an_font-remapping-does-not-affect-titles.sh \
+  tmac/tests/an_handle-degenerate-input-quietly.sh \
+  tmac/tests/an_inner-footer-abbreviation-works.sh \
+  tmac/tests/an_link-macros-work-in-paragraph-tags.sh \
+  tmac/tests/an_link-trailing-text-hugs-previous.sh \
+  tmac/tests/an_no-break-after-short-paragraph-tags.sh \
+  tmac/tests/an_output-footer-when-continuously-rendering.sh \
+  tmac/tests/an_page-footers-present.sh \
+  tmac/tests/an_page-header-has-current-data.sh \
+  tmac/tests/an_reset-hyphenation-correctly.sh \
+  tmac/tests/an_title-abbreviation-works.sh \
+  tmac/tests/an_use-input-traps-correctly.sh \
+  tmac/tests/an_works-with-ec.sh \
+  tmac/tests/andoc_P-register-works.sh \
+  tmac/tests/andoc_check-an-to-doc-transition.sh \
+  tmac/tests/andoc_clear-doc-traps.sh \
+  tmac/tests/andoc_flush-between-packages.sh \
+  tmac/tests/doc_CS-works.sh \
+  tmac/tests/doc_CT-works.sh \
+  tmac/tests/doc_D-places-page-numbers-correctly.sh \
+  tmac/tests/doc_Lk-respect-sentence-ending-punctuation.sh \
+  tmac/tests/doc_Mt-works.sh \
+  tmac/tests/doc_Nm-works.sh \
+  tmac/tests/doc_P-register-works.sh \
+  tmac/tests/doc_X-register-works.sh \
+  tmac/tests/doc_accept-mixed-case-section-headings.sh \
+  tmac/tests/doc_do-not-loop-infinitely-when-shortening-headers.sh \
+  tmac/tests/doc_heading-font-remapping-works.sh \
+  tmac/tests/doc_indents-correctly.sh \
+  tmac/tests/doc_output-footer-when-continuously-rendering.sh \
+  tmac/tests/doc_smoke-test.sh \
+  tmac/tests/e_chapter-titles-work.sh \
+  tmac/tests/e_columns-work-on-long-pages.sh \
+  tmac/tests/e_delayed-text-marks-work.sh \
+  tmac/tests/e_footnote-marks-work.sh \
+  tmac/tests/e_footnotes-work-with-columns.sh \
+  tmac/tests/e_ld-works.sh \
+  tmac/tests/e_line-numbering-works.sh \
+  tmac/tests/e_rejects-too-short-page-lengths.sh \
+  tmac/tests/ec_works.sh \
+  tmac/tests/latin2_works.sh \
+  tmac/tests/latin5_works.sh \
+  tmac/tests/latin9_works.sh \
+  tmac/tests/localization-works.sh \
+  tmac/tests/pdfpic_does-not-choke-on-bad-pdfinfo-output.sh \
+  tmac/tests/pdfpic_falls-back-to-PSPIC.sh \
+  tmac/tests/s_IP-indents-using-paragraph-type-size.sh \
+  tmac/tests/s_IP-respects-inter-sentence-space-in-tags.sh \
+  tmac/tests/s_PN-works.sh \
+  tmac/tests/s_R-handles-its-arguments.sh \
+  tmac/tests/s_SH-resets-IP-indentation-amount.sh \
+  tmac/tests/s_TC-works-with-percent-in-custom-titles.sh \
+  tmac/tests/s_XA-literal-no-argument-suppresses-leader.sh \
+  tmac/tests/s_honor-MINGW-when-two-columns.sh \
+  tmac/tests/s_mark-column-start-correctly.sh \
+  tmac/tests/s_no-excess-space-around-displays.sh \
+  tmac/tests/s_rejects-too-short-page-lengths.sh
+TESTS += $(tmac_TESTS)
+EXTRA_DIST += $(tmac_TESTS)
 
-$(TMACMDOCFILES) $(TMACSTRIPFILES): 
-	$(MKDIR_P) $(top_builddir)/tmac
-	for f in $(TMACMDOCFILES) $(TMACSTRIPFILES); do \
-	   sed -f $(tmac_srcdir)/strip.sed $(top_srcdir)/$$f-u > $(top_builddir)/$$f; \
-	done
+tmac_XFAIL_TESTS = \
+  tmac/tests/an-ext_ME-punct-hyphenates.sh \
+  tmac/tests/an-ext_UE-punct-hyphenates.sh \
+  tmac/tests/an-ext_UE-breaks-before-long-URIs.sh \
+  tmac/tests/e_footnotes-work-with-columns.sh
+XFAIL_TESTS += $(tmac_XFAIL_TESTS)
 
 tmac/www.tmac: tmac/www.tmac.in
-	$(MKDIR_P) $(top_builddir)/tmac
-	sed -e "s;@PNMTOPS_NOSETPAGE@;$(pnmtops_nosetpage);g" \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/tmac
+	$(AM_V_GEN)sed -e \
+	  "s;@PNMTOPS_NOSETPAGE@;$(pnmtops_nosetpage);g" \
 	  $(tmac_srcdir)/www.tmac.in > $(top_builddir)/tmac/www.tmac
 
+
+# Check input file for bare m4 keywords.
+M4WORDS = define|divert|include|index|shift|undefine|undivert
+M4CHECK = tmac/groff_man-passed-check-for-m4-keywords-stamp
+
+$(M4CHECK): tmac/groff_man.7.man.in
+	$(AM_V_at)! $(EGREP) \
+	  '(^|:space:)($(M4WORDS))($$|:space:)' \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
+tmac/groff_man.7.man: tmac/groff_man.7.man.in $(M4CHECK)
+	$(AM_V_GEN)$(M4) -D_groff_man_not_style \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
+tmac/groff_man_style.7.man: tmac/groff_man.7.man.in $(M4CHECK)
+	$(AM_V_GEN)$(M4) -D_groff_man_style \
+	  $(tmac_srcdir)/groff_man.7.man.in > $@
+
 # The installation of groff compatibility wrappers for vendor-provided
 # non-GNU macro sets is controlled by 'compatibility_wrappers' (see the
 # commentary surrounding m4/groff.m4's
@@ -186,21 +298,22 @@
 
 all: tmac/stamp-wrap
 
-# Generate groff compatibility wrappers for all non-GNU OS provided
-# macro sets.
+# Generate compatibility wrappers for non-GNU OS-provided macro packages
+# for which groff provides an alternative implementation.
 tmac/stamp-wrap:
-	$(MKDIR_P) $(top_builddir)/tmac;
-	if test -n "$(tmac_wrap)"; then \
+	$(AM_V_at)$(MKDIR_P) $(top_builddir)/tmac;
+	$(AM_V_at)if test -n "$(tmac_wrap)"; then \
 	  for m in ""$(tmac_wrap); do \
 	    $(RM) $(top_builddir)/tmac/$$m-wrap; \
 	    if test "$$m" = an; then \
-	      echo .do mso andoc.tmac >>$(top_builddir)/tmac/$$m-wrap; \
+	      echo .do mso an.tmac >>$(top_builddir)/tmac/$$m-wrap; \
 	    fi; \
 	    echo .cp 1 >>$(top_builddir)/tmac/$$m-wrap; \
-	    echo .so $(sys_tmac_prefix)$$m >>$(top_builddir)/tmac/$$m-wrap; \
+	    echo .so $(sys_tmac_prefix)$$m \
+	      >>$(top_builddir)/tmac/$$m-wrap; \
 	  done; \
 	fi
-	touch $@
+	$(AM_V_at)touch $@
 
 # Install groff compatibility wrappers into
 # <prefix>/lib/groff/site-tmac.
@@ -211,7 +324,7 @@
 	  if test -n "$(tmac_wrap)"; then \
 	    for m in ""$(tmac_wrap); do \
 	      $(INSTALL_DATA) $(tmac_builddir)/$$m-wrap \
-                $(DESTDIR)$(systemtmacdir)/$$m$(wrapper_suffix).tmac; \
+	        $(DESTDIR)$(systemtmacdir)/$$m$(wrapper_suffix).tmac; \
 	    done; \
 	  fi; \
 	fi
@@ -258,13 +371,15 @@
 	  rmdir $(DESTDIR)$(localtmacdir); \
 	fi
 
+# Define convenience macros for in-tree documents to depend on.  Don't
+# use these above.
+TMAC_PACKAGE_MAN = tmac/an.tmac tmac/an-ext.tmac
+TMAC_PACKAGE_MDOC = tmac/doc.tmac tmac/mdoc/doc-common \
+  tmac/mdoc/doc-ditroff tmac/mdoc/doc-nroff tmac/mdoc/doc-syms
+
 
-########################################################################
-# Editor settings
-########################################################################
-#
 # Local Variables:
 # mode: makefile-automake
 # fill-column: 72
 # End:
-# vim: set filetype=automake textwidth=72:
+# vim: set autoindent filetype=automake textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/trace.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/trace.tmac Changed

_service:tar_scm:groff-1.22.4.tar.gz/tmac/trans.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/trans.tmac Changed

@@ -1,6 +1,6 @@
 .\" Localization for groff
 .\"
-.\" Copyright (C) 2006-2018 Free Software Foundation, Inc.
+.\" Copyright (C) 2006-2020 Free Software Foundation, Inc.
 .\"   Written by Fabrice Ménard (menard.fabrice@wanadoo.fr)
 .\"
 .\" This file is part of groff.
@@ -21,6 +21,9 @@
 .\"
 .\" Please send comments to menard.fabrice@wanadoo.fr.
 .
+.do nr *groff_trans_tmac_C \n.cp
+.cp 0
+.
 .
 .\" This file translates some predefined strings used in the packages
 .\" distributed with groff.  The translations are actually done in
@@ -30,6 +33,28 @@
 .\"
 .\" trans.tmac should stay locale-independent.
 .
+.\" man package
+.\"
+.\" Either an.tmac or andoc.tmac may already be loaded.
+.nr trans*is-man 0
+.
+.if d an         .nr trans*is-man 1
+.if d reload-man .nr trans*is-man 1
+.
+.if \ntrans*is-man \{\
+.	als an*section1 \*locale-man-section1
+.	als an*section2 \*locale-man-section2
+.	als an*section3 \*locale-man-section3
+.	als an*section4 \*locale-man-section4
+.	als an*section5 \*locale-man-section5
+.	als an*section6 \*locale-man-section6
+.	als an*section7 \*locale-man-section7
+.	als an*section8 \*locale-man-section8
+.	als an*section9 \*locale-man-section9
+.\}
+.
+.rr trans*is-man
+.
 .\" ms package
 .if r GS \{\
 .	als ABSTRACT \*locale-abstract
@@ -105,25 +130,27 @@
 .
 .\" me package
 .if d @R \{\
-.	if \ndw=1 .als dw \*locale-sunday
-.	if \ndw=2 .als dw \*locale-monday
-.	if \ndw=3 .als dw \*locale-tuesday
-.	if \ndw=4 .als dw \*locale-wednesday
-.	if \ndw=5 .als dw \*locale-thursday
-.	if \ndw=6 .als dw \*locale-friday
-.	if \ndw=7 .als dw \*locale-saturday
-.	if \nmo=1 .als mo \*locale-january
-.	if \nmo=2 .als mo \*locale-february
-.	if \nmo=3 .als mo \*locale-march
-.	if \nmo=4 .als mo \*locale-april
-.	if \nmo=5 .als mo \*locale-may
-.	if \nmo=6 .als mo \*locale-june
-.	if \nmo=7 .als mo \*locale-july
-.	if \nmo=8 .als mo \*locale-august
-.	if \nmo=9 .als mo \*locale-september
-.	if \nmo=10 .als mo \*locale-october
-.	if \nmo=11 .als mo \*locale-november
-.	if \nmo=12 .als mo \*locale-december
+.	als wa \*locale-appendix_string
+.	als wc \*locale-chapter_string
+.	als _dw1 \*locale-sunday
+.	als _dw2 \*locale-monday
+.	als _dw3 \*locale-tuesday
+.	als _dw4 \*locale-wednesday
+.	als _dw5 \*locale-thursday
+.	als _dw6 \*locale-friday
+.	als _dw7 \*locale-saturday
+.	als _mo1 \*locale-january
+.	als _mo2 \*locale-february
+.	als _mo3 \*locale-march
+.	als _mo4 \*locale-april
+.	als _mo5 \*locale-may
+.	als _mo6 \*locale-june
+.	als _mo7 \*locale-july
+.	als _mo8 \*locale-august
+.	als _mo9 \*locale-september
+.	als _mo10 \*locale-october
+.	als _mo11 \*locale-november
+.	als _mo12 \*locale-december
 .\}
 .
 .\" mom package
@@ -138,9 +165,8 @@
 .	TOC_HEADER_STRING "\*\*locale-toc_header_string"
 .\}
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_trans_tmac_C
+.do rr *groff_trans_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/troffrc -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/troffrc Changed

@@ -1,4 +1,6 @@
-.\" Startup file for troff.
+.\" startup file for GNU troff
+.\"
+.\" Use .do for any groff extensions so that this file works with -C.
 .
 .\" This is tested by pic.
 .nr 0p 0
@@ -9,10 +11,11 @@
 .\" Load generic fallback mappings.
 .do mso fallbacks.tmac
 .
-.\" Use .do here, so that it works with -C.
-.\" The groff command defines the .X string if the -X option was given.
-.ie r.X .do ds troffrc!ps Xps.tmac
-.el .do ds troffrc!ps ps.tmac
+.\" The groff command defines the .X register if -X was given.
+.do ie r .X \
+.	do ds troffrc!ps Xps.tmac
+.el \
+.	do ds troffrc!ps ps.tmac
 .do ds troffrc!pdf pdf.tmac
 .do ds troffrc!dvi dvi.tmac
 .do ds troffrc!X75 X.tmac
@@ -28,34 +31,39 @@
 .do ds troffrc!html html.tmac
 .do if d troffrc!\*.T \
 .	do mso \*troffrc!\*.T
-.do rm troffrc!ps troffrc!Xps troffrc!dvi troffrc!X75 troffrc!X75-12 \
-troffrc!X100 troffrc!X100-12 troffrc!lj4 troff!lbp troffrc!html troffrc!pdf
+.do rm \
+troffrc!ps \
+troffrc!pdf \
+troffrc!dvi \
+troffrc!X75 \
+troffrc!X75-12 \
+troffrc!X100 \
+troffrc!X100-12 \
+troffrc!ascii \
+troffrc!latin1 \
+troffrc!utf8 \
+troffrc!cp1047 \
+troffrc!lj4 \
+troffrc!lbp \
+troffrc!html
 .
-.\" Test whether we work under EBCDIC and map the no-breakable space
+.\" Test whether we work under EBCDIC and map the no-break space
 .\" character accordingly.
 .do ie '\char97'a' \
 .	do tr \char160\~
 .el \
 .	do tr \char65\~
 .
-.\" Set the hyphenation language to 'us'.
-.do hla us
-.
-.\" Load hyphenation patterns and exceptions.
-.do hpf hyphen.us
-.do hpfa hyphenex.us
+.\" Set the input localization to English.
+.do mso en.tmac
 .
-.\" Handle paper formats.
-.do mso papersize.tmac
+.\" Handle paper formats on typesetting devices.
+.if t .do mso papersize.tmac
 .
-.\" Handle PS images.
+.\" Handle Encapsulated PostScript images.
 .do mso pspic.tmac
 .do mso pdfpic.tmac
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/tmac/troffrc-end -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/troffrc-end Changed

@@ -1,28 +1,34 @@
-.\" -*- nroff -*-
+.\" final startup file for GNU troff
 .\"
-.\" final startup file for troff
-.
-.\" this file is parsed after all macro sets have been read
+.\" This file is parsed after all -m file arguments have been read.
+.\"
+.\" Use .do for any groff extensions so that this file works with -C.
 .
-.do if '\*.T'html' .do mso html-end.tmac
+.do if '\*.T'html' \
+.	do mso html-end.tmac
 .
-.\" if we are running the postscript device for html images then load www.tmac
-.do if r ps4html     .do mso www.tmac
+.\" Load www if we are running the PostScript driver for HTML images.
+.do if r ps4html \
+.	do mso www.tmac
 .
-.\" for all other devices blank out these macros
-.do if !d HTML-IMAGE-INLINE      .do ds HTML-IMAGE-INLINE
-.do if !d HTML-IMAGE             .do ds HTML-IMAGE
-.do if !d HTML-IMAGE-RIGHT       .do ds HTML-IMAGE-RIGHT
-.do if !d HTML-IMAGE-LEFT        .do ds HTML-IMAGE-LEFT
-.do if !d HTML-IMAGE-END         .do ds HTML-IMAGE-END
-.do if !d DEVTAG                 .do ds DEVTAG
-.do if !d HTML-DO-IMAGE          .do ds HTML-DO-IMAGE
-.do if !d EQN-HTML-IMAGE-END     .do ds EQN-HTML-IMAGE-END
-.do if !d EQN-HTML-IMAGE         .do ds EQN-HTML-IMAGE
-.do if !d EQN-HTML-IMAGE-RIGHT   .do ds EQN-HTML-IMAGE-RIGHT
-.do if !d EQN-HTML-IMAGE-LEFT    .do ds EQN-HTML-IMAGE-LEFT
-.do if !d EQN-HTML-IMAGE-INLINE  .do ds EQN-HTML-IMAGE-INLINE
-.do if !d EQN-HTML-DO-IMAGE      .do ds EQN-HTML-DO-IMAGE
-.do if !d EQN-HTML-IMAGE-END     .do ds EQN-HTML-IMAGE-END
+.\" For all other devices, make these macros no-ops.
+.do if !d HTML-IMAGE-INLINE      .do ds HTML-IMAGE-INLINE \" empty
+.do if !d HTML-IMAGE             .do ds HTML-IMAGE \" empty
+.do if !d HTML-IMAGE-RIGHT       .do ds HTML-IMAGE-RIGHT \" empty
+.do if !d HTML-IMAGE-LEFT        .do ds HTML-IMAGE-LEFT \" empty
+.do if !d HTML-IMAGE-END         .do ds HTML-IMAGE-END \" empty
+.do if !d DEVTAG                 .do ds DEVTAG \" empty
+.do if !d HTML-DO-IMAGE          .do ds HTML-DO-IMAGE \" empty
+.do if !d EQN-HTML-IMAGE-END     .do ds EQN-HTML-IMAGE-END \" empty
+.do if !d EQN-HTML-IMAGE         .do ds EQN-HTML-IMAGE \" empty
+.do if !d EQN-HTML-IMAGE-RIGHT   .do ds EQN-HTML-IMAGE-RIGHT \" empty
+.do if !d EQN-HTML-IMAGE-LEFT    .do ds EQN-HTML-IMAGE-LEFT \" empty
+.do if !d EQN-HTML-IMAGE-INLINE  .do ds EQN-HTML-IMAGE-INLINE \" empty
+.do if !d EQN-HTML-DO-IMAGE      .do ds EQN-HTML-DO-IMAGE \" empty
+.do if !d EQN-HTML-IMAGE-END     .do ds EQN-HTML-IMAGE-END \" empty
 .
-.\" Don't let blank lines creep in here.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/tty-char.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/tty-char.tmac Changed

@@ -1,22 +1,21 @@
-.\" -*- nroff -*-
-.\"
 .\" tty-char.tmac
 .\"
-.\" This file defines standard troff characters and some groff characters for
-.\" use with -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
+.\" This file defines standard troff characters and some groff
+.\" characters for use with -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
 .\"
 .\" These definitions are chosen so that, as far as possible, they:
 .\" - work with all of -Tascii, -Tlatin1, -Tutf8, and -Tcp1047.
 .\" - work on devices that display only the last overstruck character
 .\"   as well as on devices that support overstriking
 .\" - help understanding the character's meaning, only aiming to imitate
-.\"   a particular graphical shape when that doesn't hinder understanding
+.\"   a particular graphical shape when that doesn't hinder
+.\"   understanding
 .\"
-.\" Note that the optical appearance of the definitions contained in this
-.\" file is inferior compared to that of the replacement characters defined
-.\" in the file tty.tmac.
+.\" Note that the optical appearance of the definitions contained in
+.\" this file is inferior compared to those of the replacement
+.\" characters defined in the file tty.tmac.
 .\"
-.nr _C \n(.C
+.do nr *groff_tty-char_tmac_C \n.cp
 .cp 0
 .
 .de tty-char
@@ -128,7 +127,6 @@
 .tty-char \fa <for\~all>
 .tty-char \nm <not\~element\~of>
 .tty-char \pp <perpendicular>
-.tty-char \sd ''
 .tty-char \st <such\~that>
 .tty-char \te <there\~exists>
 .if c\md .tty-char \tf .\md.
@@ -242,9 +240,12 @@
 .\"tty-char \:y \ij
 .tty-char \arrowvertex |
 .tty-char \mc <micro>
-.cp \n_C
 .
-.ie '\*(.T'cp1047' \
-.	do mso cp1047.tmac
-.el \
-.	do mso latin1.tmac
+.cp \n*groff_tty-char_tmac_C
+.do rr *groff_tty-char_tmac_C
+.
+.\" Local Variables:
+.\" mode: nroff
+.\" fill-column: 72
+.\" End:
+.\" vim: set filetype=groff textwidth=72:

_service:tar_scm:groff-1.22.4.tar.gz/tmac/tty.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/tty.tmac Changed

@@ -1,14 +1,11 @@
 .\" tty.tmac
 .\"
-.nr _C \n(.C
+.do nr *groff_tty_tmac_C \n.cp
 .cp 0
 .
 .nroff
 .ta T 0.8i
 .
-.\" Don't warn about non-existent fonts.
-.warn \n.warn-(\n.warn/131072%2*131072)
-.
 .po 0
 .
 .if !'\*.T'utf8' \{\
@@ -67,9 +64,11 @@
 .fchar \.i i
 .fchar \.j j
 .fchar \bq ,
-.
-.if '\*.T'utf8' \
-.  mso unicode.tmac
+.fchar \fm \aq
+.fchar \sd \dq
+.fchar \bs \~
+.fchar \radicalex \rn
+.fchar \sqrtex \rn
 .
 .\" color definitions
 .defcolor black rgb #000000
@@ -81,21 +80,18 @@
 .defcolor cyan rgb #00ffff
 .defcolor white rgb #ffffff
 .
-.cp \n_C
-.
 .ie '\*(.T'cp1047' \
-.  do mso cp1047.tmac
+.  mso cp1047.tmac
 .el \
 .  if !'\*(.T'ascii' \
-.    do mso latin1.tmac
+.    mso latin1.tmac
 .
 .\" If you want the character definitions in tty-char.tmac to be loaded
 .\" automatically, remove the '\"' from the next line.
-.\"do mso tty-char.tmac
+.\"mso tty-char.tmac
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
+.cp \n*groff_tty_tmac_C
+.do rr *groff_tty_tmac_C
 .
 .\" Local Variables:
 .\" mode: nroff

_service:tar_scm:groff-1.22.4.tar.gz/tmac/www.tmac.in -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/www.tmac.in Changed

@@ -1,16 +1,13 @@
 .ig
 www.tmac - macro package for adding HTML elements to roff documents.
 
-File position: <groff_source_top>/tmac/www.tmac
-Installed position: groff's main macro directory.
-
 ------------------------------------------------------------------------
     Legalese
 ------------------------------------------------------------------------
 
 This file is part of groff, the GNU roff type-setting system.
 
-Copyright (C) 2001-2018 Free Software Foundation, Inc.
+Copyright (C) 2001-2020 Free Software Foundation, Inc.
 written by Gaius Mulley <gaius@glam.ac.uk>, with additions by
 Werner Lemberg <wl@gnu.org> and
 Bernd Warken <groff-bernd.warken-72@web.de>.
@@ -45,11 +42,11 @@
 .
 .do if d www:lenstr .nx
 .
-.do mso devtag.tmac
-.
-.nr _C \n(.C
+.do nr *groff_www_tmac_in_C \n.cp
 .cp 0
 .
+.mso devtag.tmac
+.
 .
 .\" Taken from tmac/an-ext.tmac
 .\" Map mono-width fonts to standard fonts for groff's TTY device.
@@ -150,16 +147,25 @@
 .als www:error www-error
 .
 .\" --------------------------------------------------------------------
+.\" www:fatal (<test>...)
+.\"
+.\" Print fatal error message and abort.
+.\"
+.de www-fatal
+.  ab \\n.F:\\n.c: fatal macro error: \\$*
+..
+.
+.als www:fatal www-fatal
+.
+.\" --------------------------------------------------------------------
 .\" www:lenstr (<register_name> <string_name>)
 .\"
 .\" Store length of string named <string_name> into register named
 .\" <register_name>.
 .\"
 .de www:lenstr
-.  if !(\\n.$ == 2) \{\
-.    tm .\\$0 expects 2 arguments.
-.    ab
-.  \}
+.  if !(\\n.$ == 2) \
+.    www:fatal .\\$0 expects 2 arguments, got \\n.$
 .  length \\$0:n x\\*\\$2
 .  nr \\$1 (\\n\\$0:n - 1)
 .  rr \\$0:n
@@ -174,7 +180,7 @@
 .\"
 .de www:splitstr
 .  if !(\\n.$ == 1) \
-.    www:error .\\$0 expects 1 argument.
+.    www:error .\\$0 expects 1 argument, got \\n.$
 .  if '\\*\\$1'' \
 .    return
 .  ds \\$0:r "\\*\\$1\"
@@ -211,7 +217,7 @@
 .\"
 .de www:url_breaks
 .  if !(\\n.$ == 1) \
-.    www:error .\\$0 expects 1 argument.
+.    www:error .\\$0 expects 1 argument, got \\n.$
 .  if !\nwww:substring_ok \
 .    return
 .  ds \\$0:s "\\*\\$1\"
@@ -231,7 +237,7 @@
 .de www:url_breaks_split
 .  nr \\$0:min 5        \" minimal number of characters for next line
 .  if (\\n.$ < 2) \
-.    www:error .\\$0 expects at least 2 arguments.
+.    www:error .\\$0 expects at least 2 arguments, got \\n.$
 .  ds \\$0:res \\$1\"
 .  shift
 .  ds \\$0:s
@@ -1587,7 +1593,7 @@
 .\"
 .de LINKSTYLE
 .  if (\\n.$ < 1) \
-.    www:error .\\$0 expects at least 1 argument.
+.    www:error .\\$0 expects at least 1 argument, got \\n.$
 .  ds www:color \\$1\"
 .  shift
 .  if (\\n.$ < 1) \
@@ -1595,7 +1601,7 @@
 .  ds www:fontstyle \\$1\"
 .  shift
 .  if (\\n.$ < 1) \
-.    www:error .\\$0 expects that both the open and close glyph is specified
+.    www:error .\\$0 expects both open and close glyphs to be specified
 .  ds www:open \\$1\"
 .  ds www:close \\$2\"
 ..
@@ -1620,14 +1626,11 @@
 .\}
 .
 .if r ps4html .nop \O0
-.cp \n(_C
+.cp \n*groff_www_tmac_in_C
+.do rr *groff_www_tmac_in_C
 .
 .\" now set
 .
-.\" ====================================================================
-.\" Editor settings
-.\" ====================================================================
-.
 .\" Local Variables:
 .\" mode: nroff
 .\" fill-column: 72

_service:tar_scm:groff-1.22.4.tar.gz/tmac/zh.tmac -> _service:tar_scm:groff-1.23.0.tar.gz/tmac/zh.tmac Changed